Quickstart

Prerequisites

• Settld account with API key.
• Node.js 20+ runtime.
• A workflow where events represent meaningful execution outcomes.

1. Install the SDK

npm install @settld/agent-sdk

2. Initialize Settld

import Settld from "@settld/agent-sdk";

const settld = new Settld({
  apiKey: process.env.SETTLD_API_KEY!,
});

3. Register, run, and finalize proof

const agent = await settld.register({
  name: "support-agent",
  capabilities: ["customer-support", "triage"],
});

const run = await agent.startRun({
  terms: {
    accuracy: { min: 0.95 },
    latencyP95: { max: 5.0 },
  },
});

await run.logEvent({
  type: "ticket-resolved",
  id: "t-1024",
  confidence: 0.97,
});

const proof = await run.finalize();
console.log(proof.status, proof.link);

4. Use output in your system

The finalized response contains status and verification link. Use status to drive approval decisions and link to share transparent artifact evidence with counterparties.

Next

Move to Webhooks + Settlement to trigger internal billing, payout, or exception workflows automatically.