Quickstart

npm install @compose-market/sdk

import ComposeSDK from "@compose-market/sdk";

const sdk = new ComposeSDK({
  userAddress: "0xYourWalletAddress",
  chainId: 43113,
});

const { token } = await sdk.keys.create({
  userAddress: "0xYourWalletAddress",
  chainId: 43113,
});

// The SDK stores the token automatically — no need to pass it on every call.
// In a browser, it persists in localStorage. In Node.js, it stays in memory.

const stream = sdk.agent.stream({
  agentWallet: "0xa7abfd271130c3ee5c8f8862a123f3697e75af0d",
  message: "Hey, what do you do?",
  threadId: "my-first-chat",
});

for await (const event of stream) {
  if (event.type === "text-delta") {
    process.stdout.write(event.delta);
  }
}

const result = await stream.next();
// result.done — the stream is finished

// Create a multi-step plan
const planStream = sdk.agent.stream({
  agentWallet: "0xa7abfd271130c3ee5c8f8862a123f3697e75af0d",
  message: "/plan Build a todo app with auth, CRUD, and a dashboard",
  threadId: "plan-thread",
});

// Run the plan
const runStream = sdk.agent.stream({
  agentWallet: "0xa7abfd271130c3ee5c8f8862a123f3697e75af0d",
  message: "/plan run",
  threadId: "plan-thread",
});

import { createPrivateKeyX402EvmWallet } from "@compose-market/sdk";

const { x402Signer } = createPrivateKeyX402EvmWallet({
  privateKey: "0xYourPrivateKey",
  rpcUrl: "https://avax-fuji.g.alchemy.com/v2/YourRpcKey",
  schemes: ["batch-settlement"],
});

const sdk = new ComposeSDK({
  userAddress: "0xYourWalletAddress",
  chainId: 43113,
  // Pass the x402 signer — the SDK will use it when no Compose Key is available
});

// Every call will now negotiate x402 payment automatically