@rubicon-caliga/agent-sdk 0.1.0 → 0.1.1

package/dist/circle-cli-gateway-payment.js

@@ -0,0 +1,185 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { registerBatchScheme } from "@circle-fin/x402-batching/client";
+import { x402Client } from "@x402/core/client";
+import { ExactEvmScheme } from "@x402/evm/exact/client";
+import { serializeTypedData, toEip712Payload } from "./circle-agent-wallet.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Circle CLI / Agent Wallet payment engine. It creates the one-word x402
+ * payment payload for Rubicon's session-first flow and delegates EIP-712
+ * signing to `circle wallet sign typed-data`, so agents never need raw private
+ * keys or hand-built x402 payloads.
+ */
+export class CircleCliGatewayPaymentEngine {
+    x402 = new x402Client();
+    signer;
+    constructor(options = {}) {
+        this.signer = new CircleCliGatewaySigner({
+            walletAddress: options.walletAddress,
+            chain: options.chain ?? "ARC-TESTNET",
+            command: options.command ?? "circle",
+            runner: options.runner ?? runCircleCli,
+        });
+        registerBatchScheme(this.x402, {
+            signer: this.signer,
+            fallbackScheme: new ExactEvmScheme(this.signer),
+        });
+    }
+    async createWordPayment(session) {
+        if (!session.paymentRequired) {
+            throw new Error("Session did not include an x402 one-word payment requirement");
+        }
+        await this.signer.ensureAddress();
+        return {
+            paymentPayload: await this.x402.createPaymentPayload(session.paymentRequired),
+        };
+    }
+}
+class CircleCliGatewaySigner {
+    options;
+    address = "0x0000000000000000000000000000000000000000";
+    resolved = false;
+    resolving;
+    constructor(options) {
+        this.options = options;
+        if (options.walletAddress) {
+            this.address = options.walletAddress;
+            this.resolved = true;
+        }
+    }
+    async ensureAddress() {
+        if (this.resolved)
+            return;
+        if (!this.resolving) {
+            this.resolving = this.resolveAddress();
+        }
+        return this.resolving;
+    }
+    async signTypedData(typed) {
+        await this.ensureAddress();
+        const signature = await this.options.runner(this.options.command, [
+            "wallet",
+            "sign",
+            "typed-data",
+            serializeTypedData(toEip712Payload(typed)),
+            "--address",
+            this.address,
+            "--chain",
+            this.options.chain,
+            "--quiet",
+        ]);
+        return parseCircleCliSignature(signature);
+    }
+    async resolveAddress() {
+        const output = await this.options.runner(this.options.command, [
+            "wallet",
+            "list",
+            "--chain",
+            this.options.chain,
+            "--type",
+            "agent",
+            "--output",
+            "json",
+        ]);
+        const address = parseCircleCliWalletAddress(output);
+        this.address = address;
+        this.resolved = true;
+    }
+}
+async function runCircleCli(command, args) {
+    try {
+        const { stdout } = await execFileAsync(command, args, {
+            maxBuffer: 1024 * 1024,
+        });
+        return stdout;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Circle CLI command failed. Ensure Circle CLI is installed, logged in, and has an Agent Wallet on the selected chain. ${message}`);
+    }
+}
+export function parseCircleCliSignature(output) {
+    const trimmed = output.trim();
+    if (isHexSignature(trimmed)) {
+        return trimmed;
+    }
+    let parsed;
+    try {
+        parsed = parseJson(trimmed);
+    }
+    catch {
+        throw new Error("Circle CLI did not return a hex EIP-712 signature");
+    }
+    const signature = findString(parsed, ["signature", "signedData", "data.signature"]);
+    if (signature && isHexSignature(signature)) {
+        return signature;
+    }
+    throw new Error("Circle CLI did not return a hex EIP-712 signature");
+}
+export function parseCircleCliWalletAddress(output) {
+    const parsed = parseJson(output);
+    const wallets = collectWalletCandidates(parsed);
+    const addresses = wallets
+        .map((wallet) => findString(wallet, ["address", "walletAddress", "blockchainAddress"]))
+        .filter((address) => Boolean(address && isAddress(address)));
+    const unique = [...new Set(addresses.map((address) => address.toLowerCase()))];
+    if (unique.length === 1) {
+        return addresses.find((address) => address.toLowerCase() === unique[0]);
+    }
+    if (unique.length === 0) {
+        throw new Error("Circle CLI did not return an Agent Wallet address");
+    }
+    throw new Error("Multiple Circle Agent Wallets found; pass walletAddress explicitly");
+}
+function collectWalletCandidates(value) {
+    if (Array.isArray(value)) {
+        return value.filter(isRecord);
+    }
+    if (!isRecord(value)) {
+        return [];
+    }
+    for (const key of ["wallets", "items", "data"]) {
+        const nested = value[key];
+        if (Array.isArray(nested)) {
+            return nested.filter(isRecord);
+        }
+        if (isRecord(nested)) {
+            const deeper = collectWalletCandidates(nested);
+            if (deeper.length > 0)
+                return deeper;
+        }
+    }
+    return [value];
+}
+function findString(value, keys) {
+    for (const key of keys) {
+        const found = key.split(".").reduce((current, part) => {
+            if (!isRecord(current))
+                return undefined;
+            return current[part];
+        }, value);
+        if (typeof found === "string") {
+            return found;
+        }
+    }
+    return undefined;
+}
+function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        throw new Error("Circle CLI returned non-JSON output");
+    }
+}
+function isHexSignature(value) {
+    return /^0x[0-9a-fA-F]+$/.test(value);
+}
+function isAddress(value) {
+    return /^0x[0-9a-fA-F]{40}$/.test(value);
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=circle-cli-gateway-payment.js.map

package/dist/circle-cli-gateway-payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circle-cli-gateway-payment.js","sourceRoot":"","sources":["../src/circle-cli-gateway-payment.ts"],"names":[],"mappings":"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"}

package/dist/circle-cli-gateway-payment.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=circle-cli-gateway-payment.test.d.ts.map

package/dist/circle-cli-gateway-payment.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circle-cli-gateway-payment.test.d.ts","sourceRoot":"","sources":["../src/circle-cli-gateway-payment.test.ts"],"names":[],"mappings":""}

package/dist/circle-cli-gateway-payment.test.js

@@ -0,0 +1,32 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { parseCircleCliSignature, parseCircleCliWalletAddress, } from "./circle-cli-gateway-payment.js";
+test("parses quiet Circle CLI signatures", () => {
+    assert.equal(parseCircleCliSignature("0xabc123\n"), "0xabc123");
+});
+test("parses JSON Circle CLI signatures", () => {
+    assert.equal(parseCircleCliSignature(JSON.stringify({ data: { signature: "0xdef456" } })), "0xdef456");
+});
+test("rejects non-signature Circle CLI output", () => {
+    assert.throws(() => parseCircleCliSignature("signed"), /did not return a hex EIP-712 signature/);
+});
+test("parses a sole wallet address from Circle CLI list output", () => {
+    assert.equal(parseCircleCliWalletAddress(JSON.stringify({
+        data: {
+            wallets: [
+                {
+                    address: "0x1111111111111111111111111111111111111111",
+                },
+            ],
+        },
+    })), "0x1111111111111111111111111111111111111111");
+});
+test("requires explicit wallet address when multiple Agent Wallets are present", () => {
+    assert.throws(() => parseCircleCliWalletAddress(JSON.stringify({
+        data: [
+            { address: "0x1111111111111111111111111111111111111111" },
+            { address: "0x2222222222222222222222222222222222222222" },
+        ],
+    })), /Multiple Circle Agent Wallets found/);
+});
+//# sourceMappingURL=circle-cli-gateway-payment.test.js.map

package/dist/circle-cli-gateway-payment.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"circle-cli-gateway-payment.test.js","sourceRoot":"","sources":["../src/circle-cli-gateway-payment.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,iCAAiC,CAAC;AAEzC,IAAI,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAC9C,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,YAAY,CAAC,EAAE,UAAU,CAAC,CAAC;AAClE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,mCAAmC,EAAE,GAAG,EAAE;IAC7C,MAAM,CAAC,KAAK,CACV,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC,EAC5E,UAAU,CACX,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACnD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,uBAAuB,CAAC,QAAQ,CAAC,EAAE,wCAAwC,CAAC,CAAC;AACnG,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0DAA0D,EAAE,GAAG,EAAE;IACpE,MAAM,CAAC,KAAK,CACV,2BAA2B,CACzB,IAAI,CAAC,SAAS,CAAC;QACb,IAAI,EAAE;YACJ,OAAO,EAAE;gBACP;oBACE,OAAO,EAAE,4CAA4C;iBACtD;aACF;SACF;KACF,CAAC,CACH,EACD,4CAA4C,CAC7C,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,0EAA0E,EAAE,GAAG,EAAE;IACpF,MAAM,CAAC,MAAM,CACX,GAAG,EAAE,CACH,2BAA2B,CACzB,IAAI,CAAC,SAAS,CAAC;QACb,IAAI,EAAE;YACJ,EAAE,OAAO,EAAE,4CAA4C,EAAE;YACzD,EAAE,OAAO,EAAE,4CAA4C,EAAE;SAC1D;KACF,CAAC,CACH,EACH,qCAAqC,CACtC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./agent-client.js";
 export * from "./payment-engine.js";
+export * from "./circle-agent-wallet.js";
+export * from "./circle-cli-gateway-payment.js";
 export { RubiconClient as Rubicon, RubiconClient as default } from "./agent-client.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,4 +1,6 @@
 export * from "./agent-client.js";
 export * from "./payment-engine.js";
+export * from "./circle-agent-wallet.js";
+export * from "./circle-cli-gateway-payment.js";
 export { RubiconClient as Rubicon, RubiconClient as default } from "./agent-client.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iCAAiC,CAAC;AAChD,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,aAAa,IAAI,OAAO,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/payment-engine.d.ts

@@ -1,5 +1,4 @@
 import type { StartSessionResponse, StreamPaymentRequest } from "@rubicon-caliga/core";
-import { type GatewayClientConfig } from "@circle-fin/x402-batching/client";
 /**
  * Produces the payment payload for exactly one word. Called once per word by the
  * SDK's read loop — application developers never assemble payments themselves.
@@ -16,17 +15,4 @@ export declare class StaticPaymentEngine implements AgentPaymentEngine {
     constructor(network?: string);
     createWordPayment(session: StartSessionResponse): Promise<StreamPaymentRequest>;
 }
-export type CircleGatewayPaymentEngineOptions = GatewayClientConfig;
-/**
- * Circle/x402 engine. Signs the gateway's one-word `paymentRequired` terms.
- * Circle may batch settlement internally, but each signed payload corresponds to
- * exactly one word.
- */
-export declare class CircleGatewayPaymentEngine implements AgentPaymentEngine {
-    private readonly options;
-    private readonly client;
-    private readonly account;
-    constructor(options: CircleGatewayPaymentEngineOptions);
-    createWordPayment(session: StartSessionResponse): Promise<StreamPaymentRequest>;
-}
 //# sourceMappingURL=payment-engine.d.ts.map

package/dist/payment-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment-engine.d.ts","sourceRoot":"","sources":["../src/payment-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEvF,OAAO,EAAuB,KAAK,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAIjG;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACjF;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,kBAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,SAAmB;IAEjD,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAWtF;AAED,MAAM,MAAM,iCAAiC,GAAG,mBAAmB,CAAC;AAEpE;;;;GAIG;AACH,qBAAa,0BAA2B,YAAW,kBAAkB;IAIvD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;gBAEpC,OAAO,EAAE,iCAAiC;IAajE,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAQtF"}
+{"version":3,"file":"payment-engine.d.ts","sourceRoot":"","sources":["../src/payment-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAEvF;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACjF;AAED;;;GAGG;AACH,qBAAa,mBAAoB,YAAW,kBAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,SAAmB;IAEjD,iBAAiB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAWtF"}

package/dist/payment-engine.js

@@ -1,7 +1,3 @@
-import { x402Client } from "@x402/core/client";
-import { registerBatchScheme } from "@circle-fin/x402-batching/client";
-import { ExactEvmScheme } from "@x402/evm/exact/client";
-import { privateKeyToAccount } from "viem/accounts";
 /**
  * Development engine. Declares the one-word amount without settling real funds,
  * for use against a dev-mode gateway. NOT for production.
@@ -23,35 +19,4 @@ export class StaticPaymentEngine {
         };
     }
 }
-/**
- * Circle/x402 engine. Signs the gateway's one-word `paymentRequired` terms.
- * Circle may batch settlement internally, but each signed payload corresponds to
- * exactly one word.
- */
-export class CircleGatewayPaymentEngine {
-    options;
-    client = new x402Client();
-    account;
-    constructor(options) {
-        this.options = options;
-        this.account = privateKeyToAccount(this.options.privateKey);
-        // Recommended buyer integration (Circle x402 buyer how-to): register the
-        // gasless batched scheme with an `exact` fallback. `registerBatchScheme`
-        // wires a CompositeEvmScheme that uses Gateway batching when the seller
-        // supports it and falls back to a standard EIP-3009 `exact` payment
-        // otherwise — no per-request routing logic needed.
-        registerBatchScheme(this.client, {
-            signer: this.account,
-            fallbackScheme: new ExactEvmScheme(this.account),
-        });
-    }
-    async createWordPayment(session) {
-        if (!session.paymentRequired) {
-            throw new Error("Session did not include an x402 one-word payment requirement");
-        }
-        return {
-            paymentPayload: await this.client.createPaymentPayload(session.paymentRequired),
-        };
-    }
-}
 //# sourceMappingURL=payment-engine.js.map

package/dist/payment-engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"payment-engine.js","sourceRoot":"","sources":["../src/payment-engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAA4B,MAAM,kCAAkC,CAAC;AACjG,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAUpD;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,UAAU,gBAAgB;QAA1B,YAAO,GAAP,OAAO,CAAmB;IAAG,CAAC;IAE3D,KAAK,CAAC,iBAAiB,CAAC,OAA6B;QACnD,OAAO;YACL,cAAc,EAAE;gBACd,MAAM,EAAE,oBAAoB;gBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,YAAY,EAAE,OAAO,CAAC,iBAAiB;gBACvC,YAAY,EAAE,MAAM;aACrB;SACF,CAAC;IACJ,CAAC;CACF;AAID;;;;GAIG;AACH,MAAM,OAAO,0BAA0B;IAIR;IAHZ,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;IAC1B,OAAO,CAAyC;IAEjE,YAA6B,OAA0C;QAA1C,YAAO,GAAP,OAAO,CAAmC;QACrE,IAAI,CAAC,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC5D,yEAAyE;QACzE,yEAAyE;QACzE,wEAAwE;QACxE,oEAAoE;QACpE,mDAAmD;QACnD,mBAAmB,CAAC,IAAI,CAAC,MAAM,EAAE;YAC/B,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,cAAc,EAAE,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;SACjD,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,OAA6B;QACnD,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QAClF,CAAC;QACD,OAAO;YACL,cAAc,EAAE,MAAM,IAAI,CAAC,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,eAAwB,CAAC;SACzF,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"payment-engine.js","sourceRoot":"","sources":["../src/payment-engine.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,UAAU,gBAAgB;QAA1B,YAAO,GAAP,OAAO,CAAmB;IAAG,CAAC;IAE3D,KAAK,CAAC,iBAAiB,CAAC,OAA6B;QACnD,OAAO;YACL,cAAc,EAAE;gBACd,MAAM,EAAE,oBAAoB;gBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,YAAY,EAAE,OAAO,CAAC,iBAAiB;gBACvC,YAAY,EAAE,MAAM;aACrB;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/payment-engine.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-engine.test.d.ts","sourceRoot":"","sources":["../src/payment-engine.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubicon-caliga/agent-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Client SDK for autonomous agents consuming per-word article streams via Rubicon x402.",
   "license": "MIT",
   "type": "module",
@@ -24,19 +24,19 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "lint": "tsc -p tsconfig.json --noEmit",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "node --test dist/**/*.test.js",
-    "prepublishOnly": "pnpm run build"
-  },
   "dependencies": {
-    "@rubicon-caliga/core": "^0.1.0",
+    "@circle-fin/developer-controlled-wallets": "^10.6.0",
     "@circle-fin/x402-batching": "^3.1.2",
     "@x402/core": "^2.15.0",
     "@x402/evm": "^2.15.0",
     "eventsource": "^4.0.0",
-    "viem": "^2.52.2"
+    "viem": "^2.52.2",
+    "@rubicon-caliga/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "lint": "tsc -p tsconfig.json --noEmit",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test dist/**/*.test.js"
   }
-}
+}

package/src/agent-client.ts

@@ -39,6 +39,10 @@ export interface ReadReceipt {
   amountPaidAtomic: `${bigint}`;
   payments: WordPaymentReceipt[];
   transactionHashes: string[];
+  settlementIds: string[];
+  buyerWalletAddress?: `0x${string}`;
+  sellerPayTo?: `0x${string}`;
+  network?: string;
   text: string;
   completed: boolean;
   stopReason: "article_completed" | "stop_condition" | "budget_reached" | "max_words" | "aborted";
@@ -268,6 +272,7 @@ export class RubiconClient {
     let wordsRead = 0;
     let amountPaid = 0n;
     const transactionHashes: string[] = [];
+    const settlementIds: string[] = [];
     const payments: WordPaymentReceipt[] = [];
     let stopReason: ReadReceipt["stopReason"] = "article_completed";
     let completed = false;
@@ -280,6 +285,10 @@ export class RubiconClient {
       amountPaidAtomic: `${amountPaid}`,
       payments: [...payments],
       transactionHashes: [...transactionHashes],
+      settlementIds: [...settlementIds],
+      buyerWalletAddress: [...payments].reverse().find((payment) => payment.buyerWalletAddress)?.buyerWalletAddress,
+      sellerPayTo: [...payments].reverse().find((payment) => payment.payTo)?.payTo,
+      network: [...payments].reverse().find((payment) => payment.network)?.network,
       text,
       completed,
       stopReason,
@@ -326,6 +335,7 @@ export class RubiconClient {
         payments.push(result.payment);
       }
       transactionHashes.push(...(result.transactionHashes ?? (result.transactionHash ? [result.transactionHash] : [])));
+      settlementIds.push(...(result.settlementIds ?? (result.settlementId ? [result.settlementId] : [])));
       text = text ? `${text} ${result.word}` : result.word;
 
       yield {

package/src/circle-agent-wallet.test.ts

@@ -0,0 +1,118 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { serializeTypedData, toEip712Payload } from "./circle-agent-wallet.js";
+
+// The x402 schemes hand the signer viem-style typed data with no EIP712Domain
+// entry; Circle's API needs the complete document. These pin the bridging.
+
+const TRANSFER_TYPES = {
+  TransferWithAuthorization: [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+  ],
+};
+
+const EIP3009_TRANSFER_TYPES = {
+  TransferWithAuthorization: [
+    { name: "from", type: "address" },
+    { name: "to", type: "address" },
+    { name: "value", type: "uint256" },
+    { name: "validAfter", type: "uint256" },
+    { name: "validBefore", type: "uint256" },
+    { name: "nonce", type: "bytes32" },
+  ],
+};
+
+test("injects EIP712Domain derived from the domain fields present", () => {
+  const payload = toEip712Payload({
+    domain: {
+      name: "USD Coin",
+      version: "2",
+      chainId: 5042002,
+      verifyingContract: "0xabc",
+    },
+    types: TRANSFER_TYPES,
+    primaryType: "TransferWithAuthorization",
+    message: { from: "0x1", to: "0x2", value: "5" },
+  });
+
+  assert.deepEqual(payload.types.EIP712Domain, [
+    { name: "name", type: "string" },
+    { name: "version", type: "string" },
+    { name: "chainId", type: "uint256" },
+    { name: "verifyingContract", type: "address" },
+  ]);
+  // Original typed-data entries are preserved alongside the injected domain.
+  assert.deepEqual(payload.types.TransferWithAuthorization, TRANSFER_TYPES.TransferWithAuthorization);
+  assert.equal(payload.primaryType, "TransferWithAuthorization");
+});
+
+test("only includes domain fields that are actually present", () => {
+  const payload = toEip712Payload({
+    domain: { name: "Test", chainId: 1337 },
+    types: TRANSFER_TYPES,
+    primaryType: "TransferWithAuthorization",
+    message: {},
+  });
+
+  assert.deepEqual(payload.types.EIP712Domain, [
+    { name: "name", type: "string" },
+    { name: "chainId", type: "uint256" },
+  ]);
+});
+
+test("does not overwrite an EIP712Domain the caller already supplied", () => {
+  const provided = [{ name: "name", type: "string" }];
+  const payload = toEip712Payload({
+    domain: { name: "Test", chainId: 1337 },
+    types: { ...TRANSFER_TYPES, EIP712Domain: provided },
+    primaryType: "TransferWithAuthorization",
+    message: {},
+  });
+
+  assert.deepEqual(payload.types.EIP712Domain, provided);
+});
+
+test("serializes bigint authorization fields (exact fallback) as decimal strings", () => {
+  // The `exact` scheme hands the signer bigint value/validAfter/validBefore;
+  // plain JSON.stringify would throw, so they must be coerced to strings.
+  const payload = toEip712Payload({
+    domain: { name: "USD Coin", chainId: 5042002 },
+    types: EIP3009_TRANSFER_TYPES,
+    primaryType: "TransferWithAuthorization",
+    message: {
+      from: "0x1",
+      to: "0x2",
+      value: 5n,
+      validAfter: 0n,
+      validBefore: 1893456000n,
+      nonce: "0xabc",
+    },
+  });
+
+  const json = serializeTypedData(payload);
+  const parsed = JSON.parse(json);
+  assert.equal(parsed.message.value, "5");
+  assert.equal(parsed.message.validAfter, "0");
+  assert.equal(parsed.message.validBefore, "1893456000");
+});
+
+test("removes message fields that are not declared by the primary type", () => {
+  const payload = toEip712Payload({
+    domain: { name: "USD Coin", chainId: 5042002 },
+    types: TRANSFER_TYPES,
+    primaryType: "TransferWithAuthorization",
+    message: {
+      from: "0x1",
+      to: "0x2",
+      value: "5",
+      validAfter: "0",
+      validBefore: "1893456000",
+      nonce: "0xabc",
+      authorization: { unexpected: true },
+    },
+  });
+
+  assert.deepEqual(payload.message, { from: "0x1", to: "0x2", value: "5" });
+});