@ftptech/x402-canton-client 0.1.0

package/dist/scheme.d.ts

@@ -0,0 +1,61 @@
+/**
+ * ExactCantonScheme — payer-side x402 scheme client.
+ *
+ * Composes a `CantonSigner` (which knows how to create a
+ * TransferCommand on the agent's participant) with the x402 v2 wire
+ * format to produce the PaymentPayload the facilitator expects.
+ *
+ * Usage pattern (next-tick wrapFetchWithCantonPayment will inline
+ * this):
+ *
+ *   const scheme = new ExactCantonScheme(signer);
+ *   const payload = await scheme.createPaymentPayload(
+ *     requirements,
+ *     { url: "https://api.example.com/data" }
+ *   );
+ *   // POST the request again with
+ *   //   PAYMENT-SIGNATURE: <base64-encoded JSON payload>
+ */
+import type { PaymentRequirements, X402ResourceInfo, CantonNetwork, CantonPaymentPayload } from "@ftptech/x402-canton-core";
+import type { CantonSigner } from "./signer.js";
+export interface CantonPaymentEnvelope {
+    x402Version: 2;
+    scheme: "exact-canton";
+    network: CantonNetwork;
+    resource: X402ResourceInfo;
+    accepted: PaymentRequirements;
+    payload: CantonPaymentPayload;
+}
+/**
+ * Thrown when the resource advertises a transferMethod this signer cannot
+ * service — e.g. a CIP-56-only wallet (the relay-backed agent wallet) facing a
+ * resource that only accepts `external-party-amulet-rules` (the v1 Splice
+ * TransferCommand path), or vice versa. Named + carrying both methods so the
+ * caller can branch (e.g. surface "fund a different wallet" vs a cryptic
+ * "signer does not implement ..."), instead of leaking a bare Error.
+ */
+export declare class SchemeMethodMismatchError extends Error {
+    /** What the resource's 402 demanded. */
+    readonly required: string;
+    /** What this signer actually supports. */
+    readonly supported: string;
+    constructor(
+    /** What the resource's 402 demanded. */
+    required: string, 
+    /** What this signer actually supports. */
+    supported: string);
+}
+export declare class ExactCantonScheme {
+    private readonly signer;
+    constructor(signer: CantonSigner);
+    /**
+     * Build the full PaymentPayload to send back in PAYMENT-SIGNATURE.
+     *
+     * Generates a fresh paymentId, stamps x402 metadata onto the
+     * on-ledger Transfer.meta, delegates to signer.signCip56Transfer to
+     * land the TransferFactory_Transfer, and wraps the result in the v2
+     * envelope. Throws if the signer can't service the cip56 path.
+     */
+    createPaymentPayload(requirements: PaymentRequirements, resource: X402ResourceInfo): Promise<CantonPaymentEnvelope>;
+}
+//# sourceMappingURL=scheme.d.ts.map

package/dist/scheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheme.d.ts","sourceRoot":"","sources":["../src/scheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACrB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,CAAC,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,oBAAoB,CAAC;CAC/B;AAED;;;;;;;GAOG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAEhD,wCAAwC;aACxB,QAAQ,EAAE,MAAM;IAChC,0CAA0C;aAC1B,SAAS,EAAE,MAAM;;IAHjC,wCAAwC;IACxB,QAAQ,EAAE,MAAM;IAChC,0CAA0C;IAC1B,SAAS,EAAE,MAAM;CAiBpC;AAED,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAEjD;;;;;;;OAOG;IACG,oBAAoB,CACxB,YAAY,EAAE,mBAAmB,EACjC,QAAQ,EAAE,gBAAgB,GACzB,OAAO,CAAC,qBAAqB,CAAC;CAkHlC"}

package/dist/scheme.js

@@ -0,0 +1,164 @@
+/**
+ * ExactCantonScheme — payer-side x402 scheme client.
+ *
+ * Composes a `CantonSigner` (which knows how to create a
+ * TransferCommand on the agent's participant) with the x402 v2 wire
+ * format to produce the PaymentPayload the facilitator expects.
+ *
+ * Usage pattern (next-tick wrapFetchWithCantonPayment will inline
+ * this):
+ *
+ *   const scheme = new ExactCantonScheme(signer);
+ *   const payload = await scheme.createPaymentPayload(
+ *     requirements,
+ *     { url: "https://api.example.com/data" }
+ *   );
+ *   // POST the request again with
+ *   //   PAYMENT-SIGNATURE: <base64-encoded JSON payload>
+ */
+import { randomUUID } from "node:crypto";
+/**
+ * Thrown when the resource advertises a transferMethod this signer cannot
+ * service — e.g. a CIP-56-only wallet (the relay-backed agent wallet) facing a
+ * resource that only accepts `external-party-amulet-rules` (the v1 Splice
+ * TransferCommand path), or vice versa. Named + carrying both methods so the
+ * caller can branch (e.g. surface "fund a different wallet" vs a cryptic
+ * "signer does not implement ..."), instead of leaking a bare Error.
+ */
+export class SchemeMethodMismatchError extends Error {
+    required;
+    supported;
+    constructor(
+    /** What the resource's 402 demanded. */
+    required, 
+    /** What this signer actually supports. */
+    supported) {
+        const hint = supported === "cip56-transfer-factory"
+            ? " The agent-wallet relay signer is CIP-56-only " +
+                "(cip56-transfer-factory) and cannot create a v1 " +
+                "external-party-amulet-rules TransferCommand."
+            : supported === "(none)"
+                ? " This signer implements neither signCip56Transfer nor " +
+                    "signTransferCommand."
+                : "";
+        super(`this wallet supports ${supported} only; the resource requires ` +
+            `${required}.${hint}`);
+        this.required = required;
+        this.supported = supported;
+        this.name = "SchemeMethodMismatchError";
+    }
+}
+export class ExactCantonScheme {
+    signer;
+    constructor(signer) {
+        this.signer = signer;
+    }
+    /**
+     * Build the full PaymentPayload to send back in PAYMENT-SIGNATURE.
+     *
+     * Generates a fresh paymentId, stamps x402 metadata onto the
+     * on-ledger Transfer.meta, delegates to signer.signCip56Transfer to
+     * land the TransferFactory_Transfer, and wraps the result in the v2
+     * envelope. Throws if the signer can't service the cip56 path.
+     */
+    async createPaymentPayload(requirements, resource) {
+        const extra = requirements.extra;
+        const paymentId = randomUUID();
+        if (extra.transferMethod === "external-party-amulet-rules") {
+            if (!this.signer.signTransferCommand) {
+                // The signer advertised no v1 capability — most commonly the
+                // CIP-56-only agent-wallet relay signer. Surface a named, branchable
+                // error instead of a cryptic "does not implement ..." (plan §4.3).
+                throw new SchemeMethodMismatchError("external-party-amulet-rules", this.signer.signCip56Transfer
+                    ? "cip56-transfer-factory"
+                    : "(none)");
+            }
+            const description = JSON.stringify({
+                paymentId,
+                resourceUrl: resource.url,
+                ...(extra.merchantContractCid !== undefined
+                    ? { merchantContractCid: extra.merchantContractCid }
+                    : {}),
+                x402Version: 2,
+            });
+            const signed = await this.signer.signTransferCommand({
+                receiver: requirements.payTo,
+                delegate: extra.facilitatorParty,
+                amount: requirements.amount,
+                synchronizerId: extra.synchronizerId,
+                description,
+                expiresAtMs: Date.now() + requirements.maxTimeoutSeconds * 1000,
+            });
+            return {
+                x402Version: 2,
+                scheme: "exact-canton",
+                network: requirements.network,
+                resource,
+                accepted: requirements,
+                payload: {
+                    transferMethod: "external-party-amulet-rules",
+                    transferCommandCid: signed.transferCommandCid,
+                    payerParty: signed.payerParty,
+                    nonce: signed.nonce,
+                    ...(signed.createUpdateId !== undefined
+                        ? { createUpdateId: signed.createUpdateId }
+                        : {}),
+                },
+            };
+        }
+        if (extra.transferMethod === "cip56-transfer-factory") {
+            if (!this.signer.signCip56Transfer) {
+                throw new SchemeMethodMismatchError("cip56-transfer-factory", this.signer.signTransferCommand
+                    ? "external-party-amulet-rules"
+                    : "(none)");
+            }
+            // Stash x402 metadata on the on-ledger Transfer.meta so the
+            // facilitator's /verify can correlate even though there's no
+            // dedicated `description` field on TransferFactory_Transfer.
+            // `Map Text Text` encodes as a JSON object in Canton 3.4's
+            // JSON Ledger API v2.
+            // x402.facilitatorParty MUST be included in Transfer.meta so
+            // that CIP-56 factory/registry implementations can add the
+            // facilitator as an observer on the resulting TransferInstruction.
+            // Without this, the facilitator cannot call getTransactionById
+            // for the completed proof path (Canton only returns events the
+            // requesting party is a stakeholder in). See scheme spec
+            // §Facilitator Visibility for the full requirement.
+            const transferMeta = {
+                "x402.paymentId": paymentId,
+                "x402.resourceUrl": resource.url,
+                "x402.version": "2",
+                "x402.facilitatorParty": extra.facilitatorParty,
+            };
+            const signed = await this.signer.signCip56Transfer({
+                receiver: requirements.payTo,
+                transferFactoryCid: extra.transferFactoryCid,
+                transferFactoryTemplateId: extra.transferFactoryTemplateId,
+                factoryAdmin: extra.instrumentId.admin,
+                instrumentId: extra.instrumentId,
+                amount: requirements.amount,
+                synchronizerId: extra.synchronizerId,
+                facilitatorParty: extra.facilitatorParty,
+                transferMeta,
+            });
+            return {
+                x402Version: 2,
+                scheme: "exact-canton",
+                network: requirements.network,
+                resource,
+                accepted: requirements,
+                payload: {
+                    transferMethod: "cip56-transfer-factory",
+                    payerParty: signed.payerParty,
+                    ...(signed.transferInstructionCid !== null
+                        ? { transferInstructionCid: signed.transferInstructionCid }
+                        : { updateId: signed.updateId }),
+                },
+            };
+        }
+        // Exhaustiveness — cip56-transfer-factory is the only variant.
+        const exhaustive = extra;
+        throw new Error(`unsupported transferMethod: ${exhaustive.transferMethod}`);
+    }
+}
+//# sourceMappingURL=scheme.js.map

package/dist/scheme.js.map

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

package/dist/signer.d.ts

@@ -0,0 +1,126 @@
+/**
+ * CantonSigner abstraction for the payer (agent) side.
+ *
+ * The signer lands the on-ledger artifact the facilitator later
+ * verifies, via `signCip56Transfer` — any CIP-56 token (incl. Canton
+ * Coin) through Splice's `TransferFactory_Transfer`. Settlement happens
+ * directly between sender and receiver; the facilitator's role is just
+ * verification (for a merchant with a TransferPreapproval the transfer
+ * completes atomically).
+ *
+ * Implementation: `Cip56KeyfileSigner` — production, Ed25519 PEM key,
+ * interactive-submission/prepare+execute. Test stubs use vi.fn().
+ */
+export interface SignTransferCommandInput {
+    /** Merchant party id. Same as PaymentRequirements.payTo. */
+    receiver: string;
+    /** Facilitator party id. Same as extra.facilitatorParty. */
+    delegate: string;
+    /** Atomic units of the asset (e.g. canton-coin). JSON string. */
+    amount: string;
+    /** Global Synchronizer id. Same as extra.synchronizerId. */
+    synchronizerId: string;
+    /** JSON-encoded {paymentId, resourceUrl, merchantContractCid?, x402Version}. */
+    description: string;
+    /** Optional override for the TransferCommand expiry. Defaults to
+     *  now + 60s per the maxTimeoutSeconds convention. */
+    expiresAtMs?: number;
+}
+export interface SignedTransferCommand {
+    /** ContractId of the TransferCommand just created on-ledger. */
+    transferCommandCid: string;
+    /** The agent's own party id (the TransferCommand.sender). */
+    payerParty: string;
+    /** Monotonic nonce assigned to this TransferCommand. */
+    nonce: number;
+    /** updateId of the TransferCommand_Create transaction. Set when the agent
+     *  uses the relay path (submit/execute returns it); absent for direct
+     *  KeyfileSigner flows where the create updateId is not surfaced. */
+    createUpdateId?: string;
+}
+export interface SignCip56TransferInput {
+    /** Merchant party id. Same as PaymentRequirements.payTo. */
+    receiver: string;
+    /** CIP-56 TransferFactory cid the merchant advertised in
+     *  `extra.transferFactoryCid`. */
+    transferFactoryCid: string;
+    /** Hash-prefixed template id of the factory contract. The
+     *  signer can read this off Scan or pass through what the
+     *  merchant published. */
+    transferFactoryTemplateId: string;
+    /** The factory's admin party — clients should source from a
+     *  trusted location (Scan or the merchant's own published
+     *  metadata). Implementations check `expectedAdmin` matches the
+     *  factory's own admin field as a bait-defense. */
+    factoryAdmin: string;
+    /** `{admin, id}` of the instrument the merchant advertised in
+     *  `extra.instrumentId`. */
+    instrumentId: {
+        admin: string;
+        id: string;
+    };
+    /** Atomic units of the instrument. JSON string for precision. */
+    amount: string;
+    /** Global Synchronizer id. */
+    synchronizerId: string;
+    /** Optional override for the Transfer.executeBefore. Defaults
+     *  to now + 60s. */
+    executeBeforeMs?: number;
+    /** Token-specific extra context to pass into the factory choice's
+     *  `extraArgs`. For most CIP-56 tokens this is `{values: {}}` for
+     *  both `context` and `meta`; some implementations want
+     *  merchant-supplied factoryContext metadata. Canton 3.4 encodes
+     *  `Map Text Text` as a JSON object (not an array of pairs). */
+    extraArgs?: {
+        context: {
+            values: Record<string, string>;
+        };
+        meta: {
+            values: Record<string, string>;
+        };
+    };
+    /** Facilitator party id from PaymentRequirements.extra.facilitatorParty.
+     *  MUST be included in Transfer.meta.values["x402.facilitatorParty"]
+     *  so that CIP-56 factories can add the facilitator as an observer
+     *  on the resulting TransferInstruction. Without observer status the
+     *  facilitator cannot verify or settle the payment. */
+    facilitatorParty: string;
+    /** Free-form metadata appended to the on-ledger Transfer.meta.
+     *  Will include x402 paymentId, resourceUrl, version, and
+     *  facilitatorParty (auto-added by ExactCantonScheme.sign). */
+    transferMeta?: Record<string, string>;
+}
+export interface SignedCip56Transfer {
+    payerParty: string;
+    /** Canton ledger updateId of the TransferFactory_Transfer
+     *  submission. Always set; the client uses this as the
+     *  Completed-case proof in the PaymentPayload. */
+    updateId: string;
+    /** ContractId of the TransferInstruction the registry created,
+     *  IF the result was TransferInstructionResult_Pending. Null for
+     *  Completed results. */
+    transferInstructionCid: string | null;
+}
+export interface CantonSigner {
+    /** Party this signer signs as. Same value the facilitator sees
+     *  in `payload.payerParty`. */
+    readonly party: string;
+    /**
+     * Land a Splice TransferCommand on the agent's participant for the
+     * Canton-Coin v1 path. Implementations call
+     * /v2/interactive-submission/prepare -> sign the prepared-tx hash with
+     * the agent's key -> /execute. Optional: signers that only support
+     * CIP-56 may omit this method.
+     */
+    signTransferCommand?(input: SignTransferCommandInput): Promise<SignedTransferCommand>;
+    /**
+     * Exercise TransferFactory_Transfer on the agent's participant
+     * for the CIP-56 path. Implementations submit the exercise,
+     * extract the TransferInstructionResult from the resulting
+     * transaction events, and return the updateId plus (if
+     * applicable) the TransferInstruction cid. Optional: signers
+     * that only support TransferCommand may omit this method.
+     */
+    signCip56Transfer?(input: SignCip56TransferInput): Promise<SignedCip56Transfer>;
+}
+//# sourceMappingURL=signer.d.ts.map

package/dist/signer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.d.ts","sourceRoot":"","sources":["../src/signer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,wBAAwB;IACvC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB;0DACsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd;;yEAEqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB;sCACkC;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;8BAE0B;IAC1B,yBAAyB,EAAE,MAAM,CAAC;IAClC;;;uDAGmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB;gCAC4B;IAC5B,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,iEAAiE;IACjE,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB;wBACoB;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;oEAIgE;IAChE,SAAS,CAAC,EAAE;QACV,OAAO,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAC;QAC5C,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;SAAE,CAAC;KAC1C,CAAC;IACF;;;;2DAIuD;IACvD,gBAAgB,EAAE,MAAM,CAAC;IACzB;;mEAE+D;IAC/D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB;;sDAEkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB;;6BAEyB;IACzB,sBAAsB,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B;mCAC+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;;;;OAMG;IACH,mBAAmB,CAAC,CAClB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAElC;;;;;;;OAOG;IACH,iBAAiB,CAAC,CAChB,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjC"}

package/dist/signer.js

@@ -0,0 +1,15 @@
+/**
+ * CantonSigner abstraction for the payer (agent) side.
+ *
+ * The signer lands the on-ledger artifact the facilitator later
+ * verifies, via `signCip56Transfer` — any CIP-56 token (incl. Canton
+ * Coin) through Splice's `TransferFactory_Transfer`. Settlement happens
+ * directly between sender and receiver; the facilitator's role is just
+ * verification (for a merchant with a TransferPreapproval the transfer
+ * completes atomically).
+ *
+ * Implementation: `Cip56KeyfileSigner` — production, Ed25519 PEM key,
+ * interactive-submission/prepare+execute. Test stubs use vi.fn().
+ */
+export {};
+//# sourceMappingURL=signer.js.map

package/dist/signer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"signer.js","sourceRoot":"","sources":["../src/signer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@ftptech/x402-canton-client",
+  "version": "0.1.0",
+  "description": "Canton x402 client SDK — payer side. ExactCantonScheme + signer abstractions for autonomous agents.",
+  "license": "Apache-2.0",
+  "author": "FTP team",
+  "homepage": "https://github.com/sunstrike228/canton-x402/tree/main/packages/client#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sunstrike228/canton-x402.git",
+    "directory": "packages/client"
+  },
+  "bugs": {
+    "url": "https://github.com/sunstrike228/canton-x402/issues"
+  },
+  "keywords": [
+    "x402",
+    "canton",
+    "canton-network",
+    "client",
+    "payment",
+    "fetch",
+    "agent"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@ftptech/x402-canton-core": "^0.1.0",
+    "@ftptech/x402-canton-ledger": "^0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src --max-warnings 0"
+  }
+}