SDK

Planned

Typed clients for TypeScript, Python, and Go, generated from the same contract the API serves.

What it is: A thin client over the REST API with types that match the response shape exactly.
Why it matters: A field that moves should break at compile time in your editor, not at runtime in production. Hand-written types drift; generated ones cannot.
What it will enable: TypeScript
Python
Go
Typed responses
Streaming
Retries
Pagination

Usage

The intended shape, in three languages.

TypeScriptillustrative

import { Molthood } from "@molthood/sdk";

const client = new Molthood({ apiKey: process.env.MOLTHOOD_API_KEY });

const execution = await client.executions.create({
  target: "token",
  subject: "0x...",
});

for (const finding of execution.evidence) {
  // `state` is confirmed, refuted, or unknown — never a bare boolean,
  // because "could not check" is not the same as "no".
  console.log(finding.label, finding.state, finding.sourceUrl);
}

Pythonillustrative

from molthood import Molthood

client = Molthood(api_key=os.environ["MOLTHOOD_API_KEY"])
execution = client.executions.create(target="token", subject="0x...")

unresolved = [f for f in execution.evidence if f.state == "unknown"]

Goillustrative

client := molthood.New(os.Getenv("MOLTHOOD_API_KEY"))

execution, err := client.Executions.Create(ctx, &molthood.ExecutionParams{
    Target:  "token",
    Subject: "0x...",
})

Installation

Nothing is published to these registries yet.

installillustrative

npm  install @molthood/sdk
pnpm add     @molthood/sdk
bun  add     @molthood/sdk
pip  install molthood
go get github.com/molthood/molthood-go

Not available yet

Nothing is published to npm, PyPI, or the Go module proxy. The install commands describe intended package names.

There is nothing to configure here yet.