@caypo/mpp-canton 0.1.0

package/dist/chunk-757U7PM3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["/**\n * Canton MPP client — used by agents to pay for services.\n *\n * Flow:\n * 1. Receive 402 challenge with amount, recipient, network\n * 2. Validate network matches agent config\n * 3. Query agent's USDCx holdings via Ledger API\n * 4. Select holdings covering the required amount\n * 5. Exercise TransferFactory_Transfer (1-step, requires recipient TransferPreapproval)\n * 6. Return serialized credential with updateId + completionOffset\n */\n\nimport { Credential, Method, type Challenge } from \"mppx\";\nimport { cantonMethod } from \"./method.js\";\nimport type { CantonRequest } from \"./schemas.js\";\n\nconst USDCX_HOLDING_TEMPLATE_ID = \"Splice.Api.Token.HoldingV1:Holding\";\nconst TRANSFER_FACTORY_TEMPLATE_ID = \"Splice.Api.Token.TransferFactoryV1:TransferFactory\";\nconst USDCX_INSTRUMENT_ID = \"USDCx\";\n\nexport type CantonNetwork = \"mainnet\" | \"testnet\" | \"devnet\";\n\nexport interface CantonMppClientConfig {\n  ledgerUrl: string;\n  token: string;\n  userId: string;\n  partyId: string;\n  network: CantonNetwork;\n}\n\ninterface HoldingContract {\n  contractId: string;\n  amount: string;\n}\n\nasync function fetchJson(url: string, token: string, init?: RequestInit): Promise<unknown> {\n  const response = await fetch(url, {\n    ...init,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      Authorization: `Bearer ${token}`,\n      ...(init?.headers as Record<string, string>),\n    },\n  });\n\n  if (!response.ok) {\n    const text = await response.text().catch(() => \"\");\n    throw new Error(`Canton API error: HTTP ${response.status} — ${text}`);\n  }\n\n  return response.json();\n}\n\nasync function getLedgerEnd(config: CantonMppClientConfig): Promise<number> {\n  const data = (await fetchJson(`${config.ledgerUrl}/v2/state/ledger-end`, config.token)) as {\n    offset: number;\n  };\n  return data.offset;\n}\n\nasync function queryHoldings(config: CantonMppClientConfig): Promise<HoldingContract[]> {\n  const offset = await getLedgerEnd(config);\n\n  const data = (await fetchJson(`${config.ledgerUrl}/v2/state/active-contracts`, config.token, {\n    method: \"POST\",\n    body: JSON.stringify({\n      eventFormat: {\n        filtersByParty: {\n          [config.partyId]: {\n            cumulative: [\n              {\n                identifierFilter: {\n                  TemplateFilter: {\n                    value: { templateId: USDCX_HOLDING_TEMPLATE_ID },\n                  },\n                },\n              },\n            ],\n          },\n        },\n        verbose: true,\n      },\n      activeAtOffset: offset,\n    }),\n  })) as {\n    contractEntry?: Array<{\n      createdEvent?: { contractId: string; createArgument: { amount: string } };\n    }>;\n  };\n\n  return (data.contractEntry ?? [])\n    .filter((e) => e.createdEvent != null)\n    .map((e) => ({\n      contractId: e.createdEvent!.contractId,\n      amount: e.createdEvent!.createArgument.amount,\n    }));\n}\n\nfunction selectHoldings(\n  holdings: HoldingContract[],\n  requiredAmount: string,\n): string[] {\n  if (holdings.length === 0) {\n    throw new Error(`Insufficient balance: no holdings available`);\n  }\n\n  // Sort descending\n  const sorted = [...holdings].sort(\n    (a, b) => parseFloat(b.amount) - parseFloat(a.amount),\n  );\n\n  // Try single holding\n  for (let i = sorted.length - 1; i >= 0; i--) {\n    if (parseFloat(sorted[i].amount) >= parseFloat(requiredAmount)) {\n      return [sorted[i].contractId];\n    }\n  }\n\n  // Accumulate multiple\n  let total = 0;\n  const selected: string[] = [];\n  for (const h of sorted) {\n    selected.push(h.contractId);\n    total += parseFloat(h.amount);\n    if (total >= parseFloat(requiredAmount)) {\n      return selected;\n    }\n  }\n\n  throw new Error(\n    `Insufficient balance: have ${total}, need ${requiredAmount}`,\n  );\n}\n\nexport function cantonClient(config: CantonMppClientConfig) {\n  return Method.toClient(cantonMethod, {\n    async createCredential({ challenge }: { challenge: Challenge<CantonRequest> }) {\n      // 1. Validate network\n      if (challenge.request.network !== config.network) {\n        throw new Error(\n          `Network mismatch: challenge requires ${challenge.request.network}, agent configured for ${config.network}`,\n        );\n      }\n\n      // 2. Query holdings\n      const holdings = await queryHoldings(config);\n\n      // 3. Select holdings covering amount\n      const selectedCids = selectHoldings(holdings, challenge.request.amount);\n\n      // 4. Generate commandId\n      const commandId = crypto.randomUUID();\n\n      // 5. Exercise TransferFactory_Transfer\n      const result = (await fetchJson(\n        `${config.ledgerUrl}/v2/commands/submit-and-wait`,\n        config.token,\n        {\n          method: \"POST\",\n          body: JSON.stringify({\n            commands: [\n              {\n                ExerciseCommand: {\n                  templateId: TRANSFER_FACTORY_TEMPLATE_ID,\n                  contractId: selectedCids[0],\n                  choice: \"TransferFactory_Transfer\",\n                  choiceArgument: {\n                    sender: config.partyId,\n                    receiver: challenge.request.recipient,\n                    amount: challenge.request.amount,\n                    instrumentId: USDCX_INSTRUMENT_ID,\n                    inputHoldingCids: selectedCids,\n                    meta: {},\n                  },\n                },\n              },\n            ],\n            userId: config.userId,\n            commandId,\n            actAs: [config.partyId],\n            readAs: [config.partyId],\n          }),\n        },\n      )) as { updateId: string; completionOffset: number };\n\n      // 6. Return serialized credential\n      return Credential.serialize({\n        challenge,\n        payload: {\n          updateId: result.updateId,\n          completionOffset: result.completionOffset,\n          sender: config.partyId,\n          commandId,\n        },\n      });\n    },\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/chunk-NTWNP6H5.js

@@ -0,0 +1,43 @@
+// src/schemas.ts
+import { z } from "zod";
+var requestSchema = z.object({
+  amount: z.string().regex(/^\d+\.?\d{0,10}$/, "Invalid amount format"),
+  currency: z.enum(["USDCx", "CC"]),
+  recipient: z.string().min(1, "Recipient party ID required"),
+  network: z.enum(["mainnet", "testnet", "devnet"]),
+  description: z.string().optional(),
+  expiry: z.number().int().min(1).max(3600).default(300)
+});
+var credentialPayloadSchema = z.object({
+  updateId: z.string().min(1, "updateId required"),
+  completionOffset: z.number().int(),
+  sender: z.string().min(1, "Sender party ID required"),
+  commandId: z.string().min(1, "commandId required")
+});
+var receiptSchema = z.object({
+  method: z.literal("canton"),
+  reference: z.string().min(1),
+  status: z.enum(["success", "failed"]),
+  timestamp: z.string()
+});
+
+// src/method.ts
+import { Method } from "mppx";
+var cantonMethod = Method.from({
+  intent: "charge",
+  name: "canton",
+  schema: {
+    credential: {
+      payload: credentialPayloadSchema
+    },
+    request: requestSchema
+  }
+});
+
+export {
+  requestSchema,
+  credentialPayloadSchema,
+  receiptSchema,
+  cantonMethod
+};
+//# sourceMappingURL=chunk-NTWNP6H5.js.map

package/dist/chunk-NTWNP6H5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas.ts","../src/method.ts"],"sourcesContent":["/**\n * Zod schemas for Canton MPP payment method.\n * Exported separately for reuse in validation, gateway middleware, etc.\n */\n\nimport { z } from \"zod\";\n\nexport const requestSchema = z.object({\n  amount: z.string().regex(/^\\d+\\.?\\d{0,10}$/, \"Invalid amount format\"),\n  currency: z.enum([\"USDCx\", \"CC\"]),\n  recipient: z.string().min(1, \"Recipient party ID required\"),\n  network: z.enum([\"mainnet\", \"testnet\", \"devnet\"]),\n  description: z.string().optional(),\n  expiry: z.number().int().min(1).max(3600).default(300),\n});\n\nexport const credentialPayloadSchema = z.object({\n  updateId: z.string().min(1, \"updateId required\"),\n  completionOffset: z.number().int(),\n  sender: z.string().min(1, \"Sender party ID required\"),\n  commandId: z.string().min(1, \"commandId required\"),\n});\n\nexport const receiptSchema = z.object({\n  method: z.literal(\"canton\"),\n  reference: z.string().min(1),\n  status: z.enum([\"success\", \"failed\"]),\n  timestamp: z.string(),\n});\n\nexport type CantonRequest = z.infer<typeof requestSchema>;\nexport type CantonCredentialPayload = z.infer<typeof credentialPayloadSchema>;\nexport type CantonReceipt = z.infer<typeof receiptSchema>;\n","/**\n * Canton MPP method definition.\n *\n * Defines the \"canton\" payment method using the mppx Method.from() pattern.\n * The method specifies the request and credential schemas that both\n * client (agent) and server (gateway) use.\n */\n\nimport { Method } from \"mppx\";\nimport { credentialPayloadSchema, requestSchema } from \"./schemas.js\";\n\nexport const cantonMethod = Method.from({\n  intent: \"charge\",\n  name: \"canton\",\n  schema: {\n    credential: {\n      payload: credentialPayloadSchema,\n    },\n    request: requestSchema,\n  },\n});\n"],"mappings":";AAKA,SAAS,SAAS;AAEX,IAAM,gBAAgB,EAAE,OAAO;AAAA,EACpC,QAAQ,EAAE,OAAO,EAAE,MAAM,oBAAoB,uBAAuB;AAAA,EACpE,UAAU,EAAE,KAAK,CAAC,SAAS,IAAI,CAAC;AAAA,EAChC,WAAW,EAAE,OAAO,EAAE,IAAI,GAAG,6BAA6B;AAAA,EAC1D,SAAS,EAAE,KAAK,CAAC,WAAW,WAAW,QAAQ,CAAC;AAAA,EAChD,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,QAAQ,GAAG;AACvD,CAAC;AAEM,IAAM,0BAA0B,EAAE,OAAO;AAAA,EAC9C,UAAU,EAAE,OAAO,EAAE,IAAI,GAAG,mBAAmB;AAAA,EAC/C,kBAAkB,EAAE,OAAO,EAAE,IAAI;AAAA,EACjC,QAAQ,EAAE,OAAO,EAAE,IAAI,GAAG,0BAA0B;AAAA,EACpD,WAAW,EAAE,OAAO,EAAE,IAAI,GAAG,oBAAoB;AACnD,CAAC;AAEM,IAAM,gBAAgB,EAAE,OAAO;AAAA,EACpC,QAAQ,EAAE,QAAQ,QAAQ;AAAA,EAC1B,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC3B,QAAQ,EAAE,KAAK,CAAC,WAAW,QAAQ,CAAC;AAAA,EACpC,WAAW,EAAE,OAAO;AACtB,CAAC;;;ACpBD,SAAS,cAAc;AAGhB,IAAM,eAAe,OAAO,KAAK;AAAA,EACtC,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ;AAAA,IACN,YAAY;AAAA,MACV,SAAS;AAAA,IACX;AAAA,IACA,SAAS;AAAA,EACX;AACF,CAAC;","names":[]}

package/dist/client.cjs

@@ -0,0 +1,200 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/client.ts
+var client_exports = {};
+__export(client_exports, {
+  cantonClient: () => cantonClient
+});
+module.exports = __toCommonJS(client_exports);
+var import_mppx2 = require("mppx");
+
+// src/method.ts
+var import_mppx = require("mppx");
+
+// src/schemas.ts
+var import_zod = require("zod");
+var requestSchema = import_zod.z.object({
+  amount: import_zod.z.string().regex(/^\d+\.?\d{0,10}$/, "Invalid amount format"),
+  currency: import_zod.z.enum(["USDCx", "CC"]),
+  recipient: import_zod.z.string().min(1, "Recipient party ID required"),
+  network: import_zod.z.enum(["mainnet", "testnet", "devnet"]),
+  description: import_zod.z.string().optional(),
+  expiry: import_zod.z.number().int().min(1).max(3600).default(300)
+});
+var credentialPayloadSchema = import_zod.z.object({
+  updateId: import_zod.z.string().min(1, "updateId required"),
+  completionOffset: import_zod.z.number().int(),
+  sender: import_zod.z.string().min(1, "Sender party ID required"),
+  commandId: import_zod.z.string().min(1, "commandId required")
+});
+var receiptSchema = import_zod.z.object({
+  method: import_zod.z.literal("canton"),
+  reference: import_zod.z.string().min(1),
+  status: import_zod.z.enum(["success", "failed"]),
+  timestamp: import_zod.z.string()
+});
+
+// src/method.ts
+var cantonMethod = import_mppx.Method.from({
+  intent: "charge",
+  name: "canton",
+  schema: {
+    credential: {
+      payload: credentialPayloadSchema
+    },
+    request: requestSchema
+  }
+});
+
+// src/client.ts
+var USDCX_HOLDING_TEMPLATE_ID = "Splice.Api.Token.HoldingV1:Holding";
+var TRANSFER_FACTORY_TEMPLATE_ID = "Splice.Api.Token.TransferFactoryV1:TransferFactory";
+var USDCX_INSTRUMENT_ID = "USDCx";
+async function fetchJson(url, token, init) {
+  const response = await fetch(url, {
+    ...init,
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`,
+      ...init?.headers
+    }
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(`Canton API error: HTTP ${response.status} \u2014 ${text}`);
+  }
+  return response.json();
+}
+async function getLedgerEnd(config) {
+  const data = await fetchJson(`${config.ledgerUrl}/v2/state/ledger-end`, config.token);
+  return data.offset;
+}
+async function queryHoldings(config) {
+  const offset = await getLedgerEnd(config);
+  const data = await fetchJson(`${config.ledgerUrl}/v2/state/active-contracts`, config.token, {
+    method: "POST",
+    body: JSON.stringify({
+      eventFormat: {
+        filtersByParty: {
+          [config.partyId]: {
+            cumulative: [
+              {
+                identifierFilter: {
+                  TemplateFilter: {
+                    value: { templateId: USDCX_HOLDING_TEMPLATE_ID }
+                  }
+                }
+              }
+            ]
+          }
+        },
+        verbose: true
+      },
+      activeAtOffset: offset
+    })
+  });
+  return (data.contractEntry ?? []).filter((e) => e.createdEvent != null).map((e) => ({
+    contractId: e.createdEvent.contractId,
+    amount: e.createdEvent.createArgument.amount
+  }));
+}
+function selectHoldings(holdings, requiredAmount) {
+  if (holdings.length === 0) {
+    throw new Error(`Insufficient balance: no holdings available`);
+  }
+  const sorted = [...holdings].sort(
+    (a, b) => parseFloat(b.amount) - parseFloat(a.amount)
+  );
+  for (let i = sorted.length - 1; i >= 0; i--) {
+    if (parseFloat(sorted[i].amount) >= parseFloat(requiredAmount)) {
+      return [sorted[i].contractId];
+    }
+  }
+  let total = 0;
+  const selected = [];
+  for (const h of sorted) {
+    selected.push(h.contractId);
+    total += parseFloat(h.amount);
+    if (total >= parseFloat(requiredAmount)) {
+      return selected;
+    }
+  }
+  throw new Error(
+    `Insufficient balance: have ${total}, need ${requiredAmount}`
+  );
+}
+function cantonClient(config) {
+  return import_mppx2.Method.toClient(cantonMethod, {
+    async createCredential({ challenge }) {
+      if (challenge.request.network !== config.network) {
+        throw new Error(
+          `Network mismatch: challenge requires ${challenge.request.network}, agent configured for ${config.network}`
+        );
+      }
+      const holdings = await queryHoldings(config);
+      const selectedCids = selectHoldings(holdings, challenge.request.amount);
+      const commandId = crypto.randomUUID();
+      const result = await fetchJson(
+        `${config.ledgerUrl}/v2/commands/submit-and-wait`,
+        config.token,
+        {
+          method: "POST",
+          body: JSON.stringify({
+            commands: [
+              {
+                ExerciseCommand: {
+                  templateId: TRANSFER_FACTORY_TEMPLATE_ID,
+                  contractId: selectedCids[0],
+                  choice: "TransferFactory_Transfer",
+                  choiceArgument: {
+                    sender: config.partyId,
+                    receiver: challenge.request.recipient,
+                    amount: challenge.request.amount,
+                    instrumentId: USDCX_INSTRUMENT_ID,
+                    inputHoldingCids: selectedCids,
+                    meta: {}
+                  }
+                }
+              }
+            ],
+            userId: config.userId,
+            commandId,
+            actAs: [config.partyId],
+            readAs: [config.partyId]
+          })
+        }
+      );
+      return import_mppx2.Credential.serialize({
+        challenge,
+        payload: {
+          updateId: result.updateId,
+          completionOffset: result.completionOffset,
+          sender: config.partyId,
+          commandId
+        }
+      });
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cantonClient
+});
+//# sourceMappingURL=client.cjs.map

package/dist/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/method.ts","../src/schemas.ts"],"sourcesContent":["/**\n * Canton MPP client — used by agents to pay for services.\n *\n * Flow:\n * 1. Receive 402 challenge with amount, recipient, network\n * 2. Validate network matches agent config\n * 3. Query agent's USDCx holdings via Ledger API\n * 4. Select holdings covering the required amount\n * 5. Exercise TransferFactory_Transfer (1-step, requires recipient TransferPreapproval)\n * 6. Return serialized credential with updateId + completionOffset\n */\n\nimport { Credential, Method, type Challenge } from \"mppx\";\nimport { cantonMethod } from \"./method.js\";\nimport type { CantonRequest } from \"./schemas.js\";\n\nconst USDCX_HOLDING_TEMPLATE_ID = \"Splice.Api.Token.HoldingV1:Holding\";\nconst TRANSFER_FACTORY_TEMPLATE_ID = \"Splice.Api.Token.TransferFactoryV1:TransferFactory\";\nconst USDCX_INSTRUMENT_ID = \"USDCx\";\n\nexport type CantonNetwork = \"mainnet\" | \"testnet\" | \"devnet\";\n\nexport interface CantonMppClientConfig {\n  ledgerUrl: string;\n  token: string;\n  userId: string;\n  partyId: string;\n  network: CantonNetwork;\n}\n\ninterface HoldingContract {\n  contractId: string;\n  amount: string;\n}\n\nasync function fetchJson(url: string, token: string, init?: RequestInit): Promise<unknown> {\n  const response = await fetch(url, {\n    ...init,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      Authorization: `Bearer ${token}`,\n      ...(init?.headers as Record<string, string>),\n    },\n  });\n\n  if (!response.ok) {\n    const text = await response.text().catch(() => \"\");\n    throw new Error(`Canton API error: HTTP ${response.status} — ${text}`);\n  }\n\n  return response.json();\n}\n\nasync function getLedgerEnd(config: CantonMppClientConfig): Promise<number> {\n  const data = (await fetchJson(`${config.ledgerUrl}/v2/state/ledger-end`, config.token)) as {\n    offset: number;\n  };\n  return data.offset;\n}\n\nasync function queryHoldings(config: CantonMppClientConfig): Promise<HoldingContract[]> {\n  const offset = await getLedgerEnd(config);\n\n  const data = (await fetchJson(`${config.ledgerUrl}/v2/state/active-contracts`, config.token, {\n    method: \"POST\",\n    body: JSON.stringify({\n      eventFormat: {\n        filtersByParty: {\n          [config.partyId]: {\n            cumulative: [\n              {\n                identifierFilter: {\n                  TemplateFilter: {\n                    value: { templateId: USDCX_HOLDING_TEMPLATE_ID },\n                  },\n                },\n              },\n            ],\n          },\n        },\n        verbose: true,\n      },\n      activeAtOffset: offset,\n    }),\n  })) as {\n    contractEntry?: Array<{\n      createdEvent?: { contractId: string; createArgument: { amount: string } };\n    }>;\n  };\n\n  return (data.contractEntry ?? [])\n    .filter((e) => e.createdEvent != null)\n    .map((e) => ({\n      contractId: e.createdEvent!.contractId,\n      amount: e.createdEvent!.createArgument.amount,\n    }));\n}\n\nfunction selectHoldings(\n  holdings: HoldingContract[],\n  requiredAmount: string,\n): string[] {\n  if (holdings.length === 0) {\n    throw new Error(`Insufficient balance: no holdings available`);\n  }\n\n  // Sort descending\n  const sorted = [...holdings].sort(\n    (a, b) => parseFloat(b.amount) - parseFloat(a.amount),\n  );\n\n  // Try single holding\n  for (let i = sorted.length - 1; i >= 0; i--) {\n    if (parseFloat(sorted[i].amount) >= parseFloat(requiredAmount)) {\n      return [sorted[i].contractId];\n    }\n  }\n\n  // Accumulate multiple\n  let total = 0;\n  const selected: string[] = [];\n  for (const h of sorted) {\n    selected.push(h.contractId);\n    total += parseFloat(h.amount);\n    if (total >= parseFloat(requiredAmount)) {\n      return selected;\n    }\n  }\n\n  throw new Error(\n    `Insufficient balance: have ${total}, need ${requiredAmount}`,\n  );\n}\n\nexport function cantonClient(config: CantonMppClientConfig) {\n  return Method.toClient(cantonMethod, {\n    async createCredential({ challenge }: { challenge: Challenge<CantonRequest> }) {\n      // 1. Validate network\n      if (challenge.request.network !== config.network) {\n        throw new Error(\n          `Network mismatch: challenge requires ${challenge.request.network}, agent configured for ${config.network}`,\n        );\n      }\n\n      // 2. Query holdings\n      const holdings = await queryHoldings(config);\n\n      // 3. Select holdings covering amount\n      const selectedCids = selectHoldings(holdings, challenge.request.amount);\n\n      // 4. Generate commandId\n      const commandId = crypto.randomUUID();\n\n      // 5. Exercise TransferFactory_Transfer\n      const result = (await fetchJson(\n        `${config.ledgerUrl}/v2/commands/submit-and-wait`,\n        config.token,\n        {\n          method: \"POST\",\n          body: JSON.stringify({\n            commands: [\n              {\n                ExerciseCommand: {\n                  templateId: TRANSFER_FACTORY_TEMPLATE_ID,\n                  contractId: selectedCids[0],\n                  choice: \"TransferFactory_Transfer\",\n                  choiceArgument: {\n                    sender: config.partyId,\n                    receiver: challenge.request.recipient,\n                    amount: challenge.request.amount,\n                    instrumentId: USDCX_INSTRUMENT_ID,\n                    inputHoldingCids: selectedCids,\n                    meta: {},\n                  },\n                },\n              },\n            ],\n            userId: config.userId,\n            commandId,\n            actAs: [config.partyId],\n            readAs: [config.partyId],\n          }),\n        },\n      )) as { updateId: string; completionOffset: number };\n\n      // 6. Return serialized credential\n      return Credential.serialize({\n        challenge,\n        payload: {\n          updateId: result.updateId,\n          completionOffset: result.completionOffset,\n          sender: config.partyId,\n          commandId,\n        },\n      });\n    },\n  });\n}\n","/**\n * Canton MPP method definition.\n *\n * Defines the \"canton\" payment method using the mppx Method.from() pattern.\n * The method specifies the request and credential schemas that both\n * client (agent) and server (gateway) use.\n */\n\nimport { Method } from \"mppx\";\nimport { credentialPayloadSchema, requestSchema } from \"./schemas.js\";\n\nexport const cantonMethod = Method.from({\n  intent: \"charge\",\n  name: \"canton\",\n  schema: {\n    credential: {\n      payload: credentialPayloadSchema,\n    },\n    request: requestSchema,\n  },\n});\n","/**\n * Zod schemas for Canton MPP payment method.\n * Exported separately for reuse in validation, gateway middleware, etc.\n */\n\nimport { z } from \"zod\";\n\nexport const requestSchema = z.object({\n  amount: z.string().regex(/^\\d+\\.?\\d{0,10}$/, \"Invalid amount format\"),\n  currency: z.enum([\"USDCx\", \"CC\"]),\n  recipient: z.string().min(1, \"Recipient party ID required\"),\n  network: z.enum([\"mainnet\", \"testnet\", \"devnet\"]),\n  description: z.string().optional(),\n  expiry: z.number().int().min(1).max(3600).default(300),\n});\n\nexport const credentialPayloadSchema = z.object({\n  updateId: z.string().min(1, \"updateId required\"),\n  completionOffset: z.number().int(),\n  sender: z.string().min(1, \"Sender party ID required\"),\n  commandId: z.string().min(1, \"commandId required\"),\n});\n\nexport const receiptSchema = z.object({\n  method: z.literal(\"canton\"),\n  reference: z.string().min(1),\n  status: z.enum([\"success\", \"failed\"]),\n  timestamp: z.string(),\n});\n\nexport type CantonRequest = z.infer<typeof requestSchema>;\nexport type CantonCredentialPayload = z.infer<typeof credentialPayloadSchema>;\nexport type CantonReceipt = z.infer<typeof receiptSchema>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,IAAAA,eAAmD;;;ACJnD,kBAAuB;;;ACHvB,iBAAkB;AAEX,IAAM,gBAAgB,aAAE,OAAO;AAAA,EACpC,QAAQ,aAAE,OAAO,EAAE,MAAM,oBAAoB,uBAAuB;AAAA,EACpE,UAAU,aAAE,KAAK,CAAC,SAAS,IAAI,CAAC;AAAA,EAChC,WAAW,aAAE,OAAO,EAAE,IAAI,GAAG,6BAA6B;AAAA,EAC1D,SAAS,aAAE,KAAK,CAAC,WAAW,WAAW,QAAQ,CAAC;AAAA,EAChD,aAAa,aAAE,OAAO,EAAE,SAAS;AAAA,EACjC,QAAQ,aAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,QAAQ,GAAG;AACvD,CAAC;AAEM,IAAM,0BAA0B,aAAE,OAAO;AAAA,EAC9C,UAAU,aAAE,OAAO,EAAE,IAAI,GAAG,mBAAmB;AAAA,EAC/C,kBAAkB,aAAE,OAAO,EAAE,IAAI;AAAA,EACjC,QAAQ,aAAE,OAAO,EAAE,IAAI,GAAG,0BAA0B;AAAA,EACpD,WAAW,aAAE,OAAO,EAAE,IAAI,GAAG,oBAAoB;AACnD,CAAC;AAEM,IAAM,gBAAgB,aAAE,OAAO;AAAA,EACpC,QAAQ,aAAE,QAAQ,QAAQ;AAAA,EAC1B,WAAW,aAAE,OAAO,EAAE,IAAI,CAAC;AAAA,EAC3B,QAAQ,aAAE,KAAK,CAAC,WAAW,QAAQ,CAAC;AAAA,EACpC,WAAW,aAAE,OAAO;AACtB,CAAC;;;ADjBM,IAAM,eAAe,mBAAO,KAAK;AAAA,EACtC,QAAQ;AAAA,EACR,MAAM;AAAA,EACN,QAAQ;AAAA,IACN,YAAY;AAAA,MACV,SAAS;AAAA,IACX;AAAA,IACA,SAAS;AAAA,EACX;AACF,CAAC;;;ADJD,IAAM,4BAA4B;AAClC,IAAM,+BAA+B;AACrC,IAAM,sBAAsB;AAiB5B,eAAe,UAAU,KAAa,OAAe,MAAsC;AACzF,QAAM,WAAW,MAAM,MAAM,KAAK;AAAA,IAChC,GAAG;AAAA,IACH,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,eAAe,UAAU,KAAK;AAAA,MAC9B,GAAI,MAAM;AAAA,IACZ;AAAA,EACF,CAAC;AAED,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,OAAO,MAAM,SAAS,KAAK,EAAE,MAAM,MAAM,EAAE;AACjD,UAAM,IAAI,MAAM,0BAA0B,SAAS,MAAM,WAAM,IAAI,EAAE;AAAA,EACvE;AAEA,SAAO,SAAS,KAAK;AACvB;AAEA,eAAe,aAAa,QAAgD;AAC1E,QAAM,OAAQ,MAAM,UAAU,GAAG,OAAO,SAAS,wBAAwB,OAAO,KAAK;AAGrF,SAAO,KAAK;AACd;AAEA,eAAe,cAAc,QAA2D;AACtF,QAAM,SAAS,MAAM,aAAa,MAAM;AAExC,QAAM,OAAQ,MAAM,UAAU,GAAG,OAAO,SAAS,8BAA8B,OAAO,OAAO;AAAA,IAC3F,QAAQ;AAAA,IACR,MAAM,KAAK,UAAU;AAAA,MACnB,aAAa;AAAA,QACX,gBAAgB;AAAA,UACd,CAAC,OAAO,OAAO,GAAG;AAAA,YAChB,YAAY;AAAA,cACV;AAAA,gBACE,kBAAkB;AAAA,kBAChB,gBAAgB;AAAA,oBACd,OAAO,EAAE,YAAY,0BAA0B;AAAA,kBACjD;AAAA,gBACF;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,QACF;AAAA,QACA,SAAS;AAAA,MACX;AAAA,MACA,gBAAgB;AAAA,IAClB,CAAC;AAAA,EACH,CAAC;AAMD,UAAQ,KAAK,iBAAiB,CAAC,GAC5B,OAAO,CAAC,MAAM,EAAE,gBAAgB,IAAI,EACpC,IAAI,CAAC,OAAO;AAAA,IACX,YAAY,EAAE,aAAc;AAAA,IAC5B,QAAQ,EAAE,aAAc,eAAe;AAAA,EACzC,EAAE;AACN;AAEA,SAAS,eACP,UACA,gBACU;AACV,MAAI,SAAS,WAAW,GAAG;AACzB,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AAGA,QAAM,SAAS,CAAC,GAAG,QAAQ,EAAE;AAAA,IAC3B,CAAC,GAAG,MAAM,WAAW,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM;AAAA,EACtD;AAGA,WAAS,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,KAAK;AAC3C,QAAI,WAAW,OAAO,CAAC,EAAE,MAAM,KAAK,WAAW,cAAc,GAAG;AAC9D,aAAO,CAAC,OAAO,CAAC,EAAE,UAAU;AAAA,IAC9B;AAAA,EACF;AAGA,MAAI,QAAQ;AACZ,QAAM,WAAqB,CAAC;AAC5B,aAAW,KAAK,QAAQ;AACtB,aAAS,KAAK,EAAE,UAAU;AAC1B,aAAS,WAAW,EAAE,MAAM;AAC5B,QAAI,SAAS,WAAW,cAAc,GAAG;AACvC,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,IAAI;AAAA,IACR,8BAA8B,KAAK,UAAU,cAAc;AAAA,EAC7D;AACF;AAEO,SAAS,aAAa,QAA+B;AAC1D,SAAO,oBAAO,SAAS,cAAc;AAAA,IACnC,MAAM,iBAAiB,EAAE,UAAU,GAA4C;AAE7E,UAAI,UAAU,QAAQ,YAAY,OAAO,SAAS;AAChD,cAAM,IAAI;AAAA,UACR,wCAAwC,UAAU,QAAQ,OAAO,0BAA0B,OAAO,OAAO;AAAA,QAC3G;AAAA,MACF;AAGA,YAAM,WAAW,MAAM,cAAc,MAAM;AAG3C,YAAM,eAAe,eAAe,UAAU,UAAU,QAAQ,MAAM;AAGtE,YAAM,YAAY,OAAO,WAAW;AAGpC,YAAM,SAAU,MAAM;AAAA,QACpB,GAAG,OAAO,SAAS;AAAA,QACnB,OAAO;AAAA,QACP;AAAA,UACE,QAAQ;AAAA,UACR,MAAM,KAAK,UAAU;AAAA,YACnB,UAAU;AAAA,cACR;AAAA,gBACE,iBAAiB;AAAA,kBACf,YAAY;AAAA,kBACZ,YAAY,aAAa,CAAC;AAAA,kBAC1B,QAAQ;AAAA,kBACR,gBAAgB;AAAA,oBACd,QAAQ,OAAO;AAAA,oBACf,UAAU,UAAU,QAAQ;AAAA,oBAC5B,QAAQ,UAAU,QAAQ;AAAA,oBAC1B,cAAc;AAAA,oBACd,kBAAkB;AAAA,oBAClB,MAAM,CAAC;AAAA,kBACT;AAAA,gBACF;AAAA,cACF;AAAA,YACF;AAAA,YACA,QAAQ,OAAO;AAAA,YACf;AAAA,YACA,OAAO,CAAC,OAAO,OAAO;AAAA,YACtB,QAAQ,CAAC,OAAO,OAAO;AAAA,UACzB,CAAC;AAAA,QACH;AAAA,MACF;AAGA,aAAO,wBAAW,UAAU;AAAA,QAC1B;AAAA,QACA,SAAS;AAAA,UACP,UAAU,OAAO;AAAA,UACjB,kBAAkB,OAAO;AAAA,UACzB,QAAQ,OAAO;AAAA,UACf;AAAA,QACF;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF,CAAC;AACH;","names":["import_mppx"]}

package/dist/client.d.cts

@@ -0,0 +1,24 @@
+import * as mppx from 'mppx';
+
+/**
+ * Canton MPP client — used by agents to pay for services.
+ *
+ * Flow:
+ * 1. Receive 402 challenge with amount, recipient, network
+ * 2. Validate network matches agent config
+ * 3. Query agent's USDCx holdings via Ledger API
+ * 4. Select holdings covering the required amount
+ * 5. Exercise TransferFactory_Transfer (1-step, requires recipient TransferPreapproval)
+ * 6. Return serialized credential with updateId + completionOffset
+ */
+type CantonNetwork = "mainnet" | "testnet" | "devnet";
+interface CantonMppClientConfig {
+    ledgerUrl: string;
+    token: string;
+    userId: string;
+    partyId: string;
+    network: CantonNetwork;
+}
+declare function cantonClient(config: CantonMppClientConfig): mppx.ClientHandler<unknown>;
+
+export { type CantonMppClientConfig, type CantonNetwork, cantonClient };

package/dist/client.d.ts

@@ -0,0 +1,24 @@
+import * as mppx from 'mppx';
+
+/**
+ * Canton MPP client — used by agents to pay for services.
+ *
+ * Flow:
+ * 1. Receive 402 challenge with amount, recipient, network
+ * 2. Validate network matches agent config
+ * 3. Query agent's USDCx holdings via Ledger API
+ * 4. Select holdings covering the required amount
+ * 5. Exercise TransferFactory_Transfer (1-step, requires recipient TransferPreapproval)
+ * 6. Return serialized credential with updateId + completionOffset
+ */
+type CantonNetwork = "mainnet" | "testnet" | "devnet";
+interface CantonMppClientConfig {
+    ledgerUrl: string;
+    token: string;
+    userId: string;
+    partyId: string;
+    network: CantonNetwork;
+}
+declare function cantonClient(config: CantonMppClientConfig): mppx.ClientHandler<unknown>;
+
+export { type CantonMppClientConfig, type CantonNetwork, cantonClient };

package/dist/client.js

@@ -0,0 +1,8 @@
+import {
+  cantonClient
+} from "./chunk-757U7PM3.js";
+import "./chunk-NTWNP6H5.js";
+export {
+  cantonClient
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.cjs

@@ -0,0 +1,319 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  MPP_CANTON_VERSION: () => MPP_CANTON_VERSION,
+  MppVerificationError: () => MppVerificationError,
+  cantonClient: () => cantonClient,
+  cantonMethod: () => cantonMethod,
+  cantonServer: () => cantonServer,
+  credentialPayloadSchema: () => credentialPayloadSchema,
+  receiptSchema: () => receiptSchema,
+  requestSchema: () => requestSchema
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/method.ts
+var import_mppx = require("mppx");
+
+// src/schemas.ts
+var import_zod = require("zod");
+var requestSchema = import_zod.z.object({
+  amount: import_zod.z.string().regex(/^\d+\.?\d{0,10}$/, "Invalid amount format"),
+  currency: import_zod.z.enum(["USDCx", "CC"]),
+  recipient: import_zod.z.string().min(1, "Recipient party ID required"),
+  network: import_zod.z.enum(["mainnet", "testnet", "devnet"]),
+  description: import_zod.z.string().optional(),
+  expiry: import_zod.z.number().int().min(1).max(3600).default(300)
+});
+var credentialPayloadSchema = import_zod.z.object({
+  updateId: import_zod.z.string().min(1, "updateId required"),
+  completionOffset: import_zod.z.number().int(),
+  sender: import_zod.z.string().min(1, "Sender party ID required"),
+  commandId: import_zod.z.string().min(1, "commandId required")
+});
+var receiptSchema = import_zod.z.object({
+  method: import_zod.z.literal("canton"),
+  reference: import_zod.z.string().min(1),
+  status: import_zod.z.enum(["success", "failed"]),
+  timestamp: import_zod.z.string()
+});
+
+// src/method.ts
+var cantonMethod = import_mppx.Method.from({
+  intent: "charge",
+  name: "canton",
+  schema: {
+    credential: {
+      payload: credentialPayloadSchema
+    },
+    request: requestSchema
+  }
+});
+
+// src/client.ts
+var import_mppx2 = require("mppx");
+var USDCX_HOLDING_TEMPLATE_ID = "Splice.Api.Token.HoldingV1:Holding";
+var TRANSFER_FACTORY_TEMPLATE_ID = "Splice.Api.Token.TransferFactoryV1:TransferFactory";
+var USDCX_INSTRUMENT_ID = "USDCx";
+async function fetchJson(url, token, init) {
+  const response = await fetch(url, {
+    ...init,
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${token}`,
+      ...init?.headers
+    }
+  });
+  if (!response.ok) {
+    const text = await response.text().catch(() => "");
+    throw new Error(`Canton API error: HTTP ${response.status} \u2014 ${text}`);
+  }
+  return response.json();
+}
+async function getLedgerEnd(config) {
+  const data = await fetchJson(`${config.ledgerUrl}/v2/state/ledger-end`, config.token);
+  return data.offset;
+}
+async function queryHoldings(config) {
+  const offset = await getLedgerEnd(config);
+  const data = await fetchJson(`${config.ledgerUrl}/v2/state/active-contracts`, config.token, {
+    method: "POST",
+    body: JSON.stringify({
+      eventFormat: {
+        filtersByParty: {
+          [config.partyId]: {
+            cumulative: [
+              {
+                identifierFilter: {
+                  TemplateFilter: {
+                    value: { templateId: USDCX_HOLDING_TEMPLATE_ID }
+                  }
+                }
+              }
+            ]
+          }
+        },
+        verbose: true
+      },
+      activeAtOffset: offset
+    })
+  });
+  return (data.contractEntry ?? []).filter((e) => e.createdEvent != null).map((e) => ({
+    contractId: e.createdEvent.contractId,
+    amount: e.createdEvent.createArgument.amount
+  }));
+}
+function selectHoldings(holdings, requiredAmount) {
+  if (holdings.length === 0) {
+    throw new Error(`Insufficient balance: no holdings available`);
+  }
+  const sorted = [...holdings].sort(
+    (a, b) => parseFloat(b.amount) - parseFloat(a.amount)
+  );
+  for (let i = sorted.length - 1; i >= 0; i--) {
+    if (parseFloat(sorted[i].amount) >= parseFloat(requiredAmount)) {
+      return [sorted[i].contractId];
+    }
+  }
+  let total = 0;
+  const selected = [];
+  for (const h of sorted) {
+    selected.push(h.contractId);
+    total += parseFloat(h.amount);
+    if (total >= parseFloat(requiredAmount)) {
+      return selected;
+    }
+  }
+  throw new Error(
+    `Insufficient balance: have ${total}, need ${requiredAmount}`
+  );
+}
+function cantonClient(config) {
+  return import_mppx2.Method.toClient(cantonMethod, {
+    async createCredential({ challenge }) {
+      if (challenge.request.network !== config.network) {
+        throw new Error(
+          `Network mismatch: challenge requires ${challenge.request.network}, agent configured for ${config.network}`
+        );
+      }
+      const holdings = await queryHoldings(config);
+      const selectedCids = selectHoldings(holdings, challenge.request.amount);
+      const commandId = crypto.randomUUID();
+      const result = await fetchJson(
+        `${config.ledgerUrl}/v2/commands/submit-and-wait`,
+        config.token,
+        {
+          method: "POST",
+          body: JSON.stringify({
+            commands: [
+              {
+                ExerciseCommand: {
+                  templateId: TRANSFER_FACTORY_TEMPLATE_ID,
+                  contractId: selectedCids[0],
+                  choice: "TransferFactory_Transfer",
+                  choiceArgument: {
+                    sender: config.partyId,
+                    receiver: challenge.request.recipient,
+                    amount: challenge.request.amount,
+                    instrumentId: USDCX_INSTRUMENT_ID,
+                    inputHoldingCids: selectedCids,
+                    meta: {}
+                  }
+                }
+              }
+            ],
+            userId: config.userId,
+            commandId,
+            actAs: [config.partyId],
+            readAs: [config.partyId]
+          })
+        }
+      );
+      return import_mppx2.Credential.serialize({
+        challenge,
+        payload: {
+          updateId: result.updateId,
+          completionOffset: result.completionOffset,
+          sender: config.partyId,
+          commandId
+        }
+      });
+    }
+  });
+}
+
+// src/server.ts
+var import_mppx3 = require("mppx");
+var MppVerificationError = class extends Error {
+  problemCode;
+  constructor(message, problemCode) {
+    super(message);
+    this.name = "MppVerificationError";
+    this.problemCode = problemCode;
+  }
+};
+function findCreatedHolding(tx, recipientParty) {
+  const events = tx.eventsById ?? {};
+  for (const evt of Object.values(events)) {
+    if (evt.createdEvent) {
+      const signatories = evt.createdEvent.signatories ?? [];
+      const witnesses = evt.createdEvent.witnessParties ?? [];
+      const allParties = [...signatories, ...witnesses];
+      if (allParties.includes(recipientParty)) {
+        const amount = evt.createdEvent.createArgument?.amount;
+        if (typeof amount === "string") {
+          return { amount };
+        }
+      }
+    }
+  }
+  return null;
+}
+function findExercisedEvent(tx, senderParty) {
+  const events = tx.eventsById ?? {};
+  for (const evt of Object.values(events)) {
+    if (evt.exercisedEvent) {
+      const acting = evt.exercisedEvent.actingParties ?? [];
+      if (acting.includes(senderParty)) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function cantonServer(config) {
+  return import_mppx3.Method.toServer(cantonMethod, {
+    async verify({
+      credential
+    }) {
+      const { updateId, sender } = credential.payload;
+      const { amount, recipient, network } = credential.challenge.request;
+      if (network !== config.network) {
+        throw new MppVerificationError(
+          `Network mismatch: credential is for ${network}, server is on ${config.network}`,
+          "verification-failed"
+        );
+      }
+      if (recipient !== config.recipientPartyId) {
+        throw new MppVerificationError(
+          `Recipient mismatch: credential targets ${recipient}, server is ${config.recipientPartyId}`,
+          "verification-failed"
+        );
+      }
+      const txResponse = await fetch(
+        `${config.ledgerUrl}/v2/updates/transaction-by-id/${encodeURIComponent(updateId)}`,
+        {
+          headers: {
+            Authorization: `Bearer ${config.token}`
+          }
+        }
+      );
+      if (!txResponse.ok) {
+        throw new MppVerificationError(
+          "Transaction not found on Canton ledger",
+          "verification-failed"
+        );
+      }
+      const tx = await txResponse.json();
+      const recipientHolding = findCreatedHolding(tx, config.recipientPartyId);
+      if (!recipientHolding) {
+        throw new MppVerificationError(
+          "No holding created for recipient in transaction",
+          "verification-failed"
+        );
+      }
+      if (parseFloat(recipientHolding.amount) < parseFloat(amount)) {
+        throw new MppVerificationError(
+          `Payment insufficient: received ${recipientHolding.amount}, required ${amount}`,
+          "payment-insufficient"
+        );
+      }
+      if (!findExercisedEvent(tx, sender)) {
+        throw new MppVerificationError(
+          `Sender mismatch: ${sender} did not execute the transfer`,
+          "verification-failed"
+        );
+      }
+      return import_mppx3.Receipt.from({
+        method: "canton",
+        reference: updateId,
+        status: "success",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    }
+  });
+}
+
+// src/index.ts
+var MPP_CANTON_VERSION = "0.1.0";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MPP_CANTON_VERSION,
+  MppVerificationError,
+  cantonClient,
+  cantonMethod,
+  cantonServer,
+  credentialPayloadSchema,
+  receiptSchema,
+  requestSchema
+});
+//# sourceMappingURL=index.cjs.map