@integraledger/lcp-binding-canton-x402 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @integraledger/lcp-binding-canton-x402
 
+## 0.16.0
+
+### Minor Changes
+
+- e4dde9b: The participant endpoint paths are configuration, not constants this package invents.
+  
+  `makeCantonX402Reader` POSTed to `/v1/updates/transfer` and `/v1/updates/transfers`. Neither names an
+  endpoint of any published Daml JSON API version — v1 defines `/v1/create`, `/v1/exercise`, `/v1/query` and
+  `/v1/fetch` and no `updates` family, and the update endpoints that do exist live under `/v2/`. Nothing here
+  could have caught it: the only assertion over those paths was a stubbed `fetch` compared against the URL
+  the code itself builds, so the test and the code restated one guess to each other.
+  
+  The fix is not a better guess. A Canton Coin `TransferFactory_Transfer` is a token-standard object, and
+  how a deployment exposes one over HTTP — stock JSON Ledger API version, scan proxy, or a facilitator's own
+  service in front of the participant — is a property of that deployment. `CantonX402ReaderConfig` therefore
+  requires `transferPath` and `transfersPath`, refuses an empty one at construction rather than POSTing to
+  the base URL, and the live harness reads them from `CANTON_X402_TRANSFER_PATH` /
+  `CANTON_X402_TRANSFERS_PATH` (mapped in `live-proofs.yml`, so `check:live-rails --check-env` names them
+  when a run cannot proceed).
+  
+  **This changes published behaviour**: `makeCantonX402Reader` now needs two more fields and throws without
+  them.
+
+### Patch Changes
+
+- @integraledger/lcp-binding-core@0.16.0
+  - @integraledger/lcp-kernel@0.16.0
+
+## 0.15.1
+
+### Patch Changes
+
+- Updated dependencies [83ae16e]
+- Updated dependencies [431b8ec]
+- Updated dependencies [9c42f73]
+  - @integraledger/lcp-kernel@0.15.1
+  - @integraledger/lcp-binding-core@0.15.1
+
 ## 0.15.0
 
 ### Patch Changes
@@ -85,7 +123,7 @@ and a large number of documentation claims were corrected against the host speci
 First release. Welds an ATR hash into a Canton Coin settlement over x402's `exact` scheme for Canton:
 the seller advertises `PaymentRequirements.extra.memo`, the payer echoes it into the transfer metadata
 under `x402.memo`, and the facilitator rejects `invalid_exact_canton_memo_mismatch` on a mismatch
-(scheme safety check 12). A §8.3.1 Native Field binding, conforms to LCP v1.38.
+(scheme safety check 12). A §8.3.1 Native Field binding, conforms to the published LCP specification.
 
 Split out of `@integraledger/lcp-binding-canton` rather than replacing it: x402's exact-Canton scheme
 settles Canton Coin only, so the `LcpAnchor` overlay remains the carrier for every other Canton

package/README.md

@@ -49,6 +49,11 @@ const extra = adapter.propose(atrHash); // { memo: "0x…" }
 const reader = makeCantonX402Reader({
   jsonLedgerUrl: "https://participant.example",
   bearerJwt: process.env["CANTON_READER_JWT"] ?? "",
+  // Your deployment's own paths. This package does not guess them: how a Canton Coin
+  // `TransferFactory_Transfer` is exposed over HTTP is a property of the participant, the scan proxy or
+  // the facilitator in front of it, not of Canton. An empty string is refused at construction.
+  transferPath: process.env["CANTON_X402_TRANSFER_PATH"] ?? "",
+  transfersPath: process.env["CANTON_X402_TRANSFERS_PATH"] ?? "",
 });
 const settled = await adapter.observe({ updateId }, reader);
 // { ok: true, value: { state: "settled", atrHash, receiver, amount, instrumentId } }

package/dist/adapter.d.ts

@@ -89,20 +89,48 @@ export interface CantonX402Adapter {
     /** Scan one party's visible transfers for `atrHash` — a participant view, never a global index. */
     enumerate(atrHash: string, party: string, reader: CantonX402Reader, limit?: number): Promise<CantonX402SettlementRef[]>;
 }
-/** Config for a live Daml JSON Ledger API participant reader. */
+/** Config for a live participant reader over a deployment's HTTP ledger surface. */
 export interface CantonX402ReaderConfig {
-    /** JSON Ledger API base URL — e.g. `https://164.92.95.184.nip.io`. */
+    /** Ledger API base URL — e.g. `https://participant.example`. */
     jsonLedgerUrl: string;
     /** Bearer JWT authenticating the reading party on the participant. */
     bearerJwt: string;
+    /**
+     * The path, relative to `jsonLedgerUrl`, that answers ONE update id with its transfer view. POSTed a
+     * `{ updateId }` body; answers a Daml `{ result, errors }` envelope.
+     *
+     * ⛔ **REQUIRED, and deliberately not defaulted.** This package shipped `/v1/updates/transfer` as a
+     * constant, and that is not an endpoint of any published Daml JSON API version: v1 defines
+     * `/v1/create`, `/v1/exercise`, `/v1/query` and `/v1/fetch` and no `updates` family at all, and the
+     * update endpoints that do exist live under `/v2/`. Nothing in this repository could have caught it —
+     * the only assertion over it is a stubbed `fetch` compared against the URL the code itself builds, so
+     * the test and the code restate one guess.
+     *
+     * The honest shape is configuration rather than a better guess. A Canton Coin
+     * `TransferFactory_Transfer` is a token-standard object, and how a given deployment exposes one over
+     * HTTP — stock JSON Ledger API version, scan proxy, or a facilitator's own service — is a property of
+     * that deployment. This package will not invent it: supply the path your participant answers on.
+     */
+    transferPath: string;
+    /**
+     * The path, relative to `jsonLedgerUrl`, that answers one party's visible transfer update ids. POSTed a
+     * `{ party, limit? }` body. REQUIRED for the same reason as {@link CantonX402ReaderConfig.transferPath};
+     * it shipped as `/v1/updates/transfers`.
+     */
+    transfersPath: string;
 }
 /**
- * A live `CantonX402Reader` over the Daml JSON Ledger API, PURE `fetch` — no Daml SDK.
+ * A live `CantonX402Reader` over a participant's HTTP ledger surface, PURE `fetch` — no Daml SDK.
  *
  * Fails LOUD on a non-2xx response or a Daml `errors[]` envelope; an absent update surfaces as `null`,
  * because a reference the participant cannot see is a value the caller must classify, not a transport
  * failure. No package id is required — the memo rides the CIP-56 token-standard transfer, so unlike the
  * overlay this replaced there is no deployment-specific DAR to deploy or configure.
+ *
+ * ⛔ **The two endpoint paths are yours to supply, and are refused when empty.** See
+ * {@link CantonX402ReaderConfig.transferPath}: the constants this once shipped named no endpoint of any
+ * published Daml JSON API version, and the only thing asserting them was a stubbed `fetch` compared with
+ * the URL this function builds — a test and a code path restating one guess to each other.
  */
 export declare function makeCantonX402Reader(cfg: CantonX402ReaderConfig): CantonX402Reader;
 /** Construct the Canton x402 adapter. **The manifest is injected, not baked in** — pass this package's own

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAIhF;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,kGAAkG;IAClG,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,mFAAmF;AACnF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iGAAiG;IACjG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IACvE,uGAAuG;IACvG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAChE;AAED;;;6GAG6G;AAC7G,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,sGAAsG;IACtG,OAAO,CACL,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;IACnC,+EAA+E;IAC/E,OAAO,CACL,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC1C,mGAAmG;IACnG,SAAS,CACP,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,gBAAgB,EACxB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CACvC;AAED,iEAAiE;AACjE,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,sBAAsB,GAC1B,gBAAgB,CA4ClB;AAED;;;8GAG8G;AAC9G,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,GACxB,iBAAiB,CA4FnB"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAIhF;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,kGAAkG;IAClG,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvC,yFAAyF;IACzF,QAAQ,EAAE,MAAM,CAAC;IACjB,+FAA+F;IAC/F,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,mFAAmF;AACnF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,KAAK,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iGAAiG;IACjG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAAC;IACvE,uGAAuG;IACvG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAChE;AAED;;;6GAG6G;AAC7G,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,sGAAsG;IACtG,OAAO,CACL,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC;IACnC,+EAA+E;IAC/E,OAAO,CACL,GAAG,EAAE,uBAAuB,EAC5B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC1C,mGAAmG;IACnG,SAAS,CACP,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,gBAAgB,EACxB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;CACvC;AAED,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;OAeG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,sBAAsB,GAC1B,gBAAgB,CAsDlB;AAED;;;8GAG8G;AAC9G,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,GACxB,iBAAiB,CA4FnB"}

package/dist/adapter.js

@@ -1,18 +1,29 @@
 import { atrHashEquals, isAtrHash } from "@integraledger/lcp-kernel";
 import { readTransferMemoAtrHash, x402MemoRequirement } from "./memo.js";
 /**
- * A live `CantonX402Reader` over the Daml JSON Ledger API, PURE `fetch` — no Daml SDK.
+ * A live `CantonX402Reader` over a participant's HTTP ledger surface, PURE `fetch` — no Daml SDK.
  *
  * Fails LOUD on a non-2xx response or a Daml `errors[]` envelope; an absent update surfaces as `null`,
  * because a reference the participant cannot see is a value the caller must classify, not a transport
  * failure. No package id is required — the memo rides the CIP-56 token-standard transfer, so unlike the
  * overlay this replaced there is no deployment-specific DAR to deploy or configure.
+ *
+ * ⛔ **The two endpoint paths are yours to supply, and are refused when empty.** See
+ * {@link CantonX402ReaderConfig.transferPath}: the constants this once shipped named no endpoint of any
+ * published Daml JSON API version, and the only thing asserting them was a stubbed `fetch` compared with
+ * the URL this function builds — a test and a code path restating one guess to each other.
  */
 export function makeCantonX402Reader(cfg) {
     if (cfg.jsonLedgerUrl.length === 0)
         throw new Error("makeCantonX402Reader: jsonLedgerUrl is empty");
     if (cfg.bearerJwt.length === 0)
         throw new Error("makeCantonX402Reader: bearerJwt is empty");
+    // Fail at CONSTRUCTION, not at the first read: an empty path would POST to the base URL, and a
+    // participant answering something at `/` would be read as a transfer view.
+    if (cfg.transferPath.length === 0)
+        throw new Error("makeCantonX402Reader: transferPath is empty — this package does not guess your participant's update endpoint");
+    if (cfg.transfersPath.length === 0)
+        throw new Error("makeCantonX402Reader: transfersPath is empty — this package does not guess your participant's update endpoint");
     async function ledgerCall(path, body) {
         const res = await fetch(`${cfg.jsonLedgerUrl}${path}`, {
             method: "POST",
@@ -35,11 +46,11 @@ export function makeCantonX402Reader(cfg) {
     }
     return {
         async transferView(updateId) {
-            const result = await ledgerCall("/v1/updates/transfer", { updateId });
+            const result = await ledgerCall(cfg.transferPath, { updateId });
             return result ?? null;
         },
         async transfersFor(party, limit) {
-            return ledgerCall("/v1/updates/transfers", {
+            return ledgerCall(cfg.transfersPath, {
                 party,
                 ...(limit !== undefined ? { limit } : {}),
             });

package/dist/adapter.js.map

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

package/dist/constants.d.ts

@@ -34,4 +34,17 @@ export interface CantonX402NetworkConfig {
  *  payments settled through x402's Canton-Coin scheme, and `@integraledger/lcp-binding-canton`'s overlay
  *  covers everything else. */
 export declare function getCantonX402Config(network: CantonX402Network): CantonX402NetworkConfig;
+/**
+ * ⛔⛔ THE COLLECTION PATH THIS RAIL'S `weldGrades` IS KEYED BY — exported so a consumer looks the grade up
+ * with the SAME token this manifest declares it under.
+ *
+ * `binding-evm-x402` shipped `0.15.1` with `weldGrades` keyed `ERC3009` — the escrow sibling's COLLECTOR
+ * name — while the value a consumer computes from an x402 offer is `eip3009`. The map and the lookup key
+ * disagreed inside one published package, so `weldGrades[assetTransferMethod]` answered `undefined`: the
+ * grade absent rather than wrong, which reads as a rail declaring no weld grade at all. Nothing caught it —
+ * the profile schema constrains weldGrades VALUES (`signature` | `tx`) and says nothing about keys.
+ *
+ * ⇒ The key is a constant, not a literal, on every rail. `check:weld-grade-keys` holds it.
+ */
+export declare const CANTON_X402_COLLECTION_PATH = "x402-memo";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjE;uEACuE;AACvE,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,oGAAoG;IACpG,YAAY,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,KAAK,EAAE,MAAM,CAAC;CACf;AAoBD;;8BAE8B;AAC9B,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,GACzB,uBAAuB,CAIzB"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB,cAAc,CAAC;AAEhD,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,sEAAsE;AACtE,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEjE;uEACuE;AACvE,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,iBAAiB,CAAC;IAC3B,oGAAoG;IACpG,YAAY,EAAE,MAAM,CAAC;IACrB,kGAAkG;IAClG,KAAK,EAAE,MAAM,CAAC;CACf;AAoBD;;8BAE8B;AAC9B,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,iBAAiB,GACzB,uBAAuB,CAIzB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,cAAc,CAAC"}

package/dist/constants.js

@@ -44,4 +44,17 @@ export function getCantonX402Config(network) {
         return DEVNET;
     return MAINNET;
 }
+/**
+ * ⛔⛔ THE COLLECTION PATH THIS RAIL'S `weldGrades` IS KEYED BY — exported so a consumer looks the grade up
+ * with the SAME token this manifest declares it under.
+ *
+ * `binding-evm-x402` shipped `0.15.1` with `weldGrades` keyed `ERC3009` — the escrow sibling's COLLECTOR
+ * name — while the value a consumer computes from an x402 offer is `eip3009`. The map and the lookup key
+ * disagreed inside one published package, so `weldGrades[assetTransferMethod]` answered `undefined`: the
+ * grade absent rather than wrong, which reads as a rail declaring no weld grade at all. Nothing caught it —
+ * the profile schema constrains weldGrades VALUES (`signature` | `tx`) and says nothing about keys.
+ *
+ * ⇒ The key is a constant, not a literal, on every rail. `check:weld-grade-keys` holds it.
+ */
+export const CANTON_X402_COLLECTION_PATH = "x402-memo";
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAEhD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAe9C,MAAM,OAAO,GAA4B;IACvC,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,uBAAuB;IACrC,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAEF,MAAM,MAAM,GAA4B;IACtC,OAAO,EAAE,QAAQ;IACjB,YAAY,EAAE,qCAAqC;IACnD,KAAK,EAAE,eAAe;CACvB,CAAC;AAEF,MAAM,OAAO,GAA4B;IACvC,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,0BAA0B;IACxC,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAEF;;8BAE8B;AAC9B,MAAM,UAAU,mBAAmB,CACjC,OAA0B;IAE1B,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAEhD,2FAA2F;AAC3F,MAAM,CAAC,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAe9C,MAAM,OAAO,GAA4B;IACvC,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,uBAAuB;IACrC,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAEF,MAAM,MAAM,GAA4B;IACtC,OAAO,EAAE,QAAQ;IACjB,YAAY,EAAE,qCAAqC;IACnD,KAAK,EAAE,eAAe;CACvB,CAAC;AAEF,MAAM,OAAO,GAA4B;IACvC,OAAO,EAAE,SAAS;IAClB,YAAY,EAAE,0BAA0B;IACxC,KAAK,EAAE,gBAAgB;CACxB,CAAC;AAEF;;8BAE8B;AAC9B,MAAM,UAAU,mBAAmB,CACjC,OAA0B;IAE1B,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC1C,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IACxC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,WAAW,CAAC"}

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAmBlC,CAAC"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAMvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,eAAO,MAAM,oBAAoB,EAAE,eAmBlC,CAAC"}

package/dist/manifest.js

@@ -1,4 +1,4 @@
-import { CANTON_X402_MEMO_KEY } from "./constants.js";
+import { CANTON_X402_COLLECTION_PATH, CANTON_X402_MEMO_KEY, } from "./constants.js";
 /**
  * The Canton transfer-memo binding manifest.
  *
@@ -75,7 +75,7 @@ export const CANTON_X402_MANIFEST = {
         reversible: false,
         note: "a Canton transfer consumes the input holdings it names and Canton has no reversal, so an executed transfer's memo is permanent; recourse is the record's elected forum (PAY-3/RCS-5), never dispute resolution",
     },
-    weldGrades: { "x402-memo": "tx" },
+    weldGrades: { [CANTON_X402_COLLECTION_PATH]: "tx" },
     lifecycleStates: ["proposed", "settled"],
 };
 //# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAoB;IACnD,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,oBAAoB;IACjC,QAAQ,EAAE;QACR,OAAO,EAAE,IAAI;QACb,oBAAoB,EAAE,KAAK;QAC3B,gBAAgB,EAAE,KAAK;KACxB;IACD,YAAY,EAAE,SAAS;IACvB,WAAW,EAAE,YAAY;IACzB,QAAQ,EAAE,qCAAqC,oBAAoB,EAAE;IACrE,QAAQ,EAAE;QACR,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,gNAAgN;KACvN;IACD,UAAU,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE;IACjC,eAAe,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;CACzC,CAAC"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAoB;IACnD,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,MAAM;IAChB,WAAW,EAAE,oBAAoB;IACjC,QAAQ,EAAE;QACR,OAAO,EAAE,IAAI;QACb,oBAAoB,EAAE,KAAK;QAC3B,gBAAgB,EAAE,KAAK;KACxB;IACD,YAAY,EAAE,SAAS;IACvB,WAAW,EAAE,YAAY;IACzB,QAAQ,EAAE,qCAAqC,oBAAoB,EAAE;IACrE,QAAQ,EAAE;QACR,UAAU,EAAE,KAAK;QACjB,IAAI,EAAE,gNAAgN;KACvN;IACD,UAAU,EAAE,EAAE,CAAC,2BAA2B,CAAC,EAAE,IAAI,EAAE;IACnD,eAAe,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;CACzC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@integraledger/lcp-binding-canton-x402",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Welds an ATR hash into a Canton Coin settlement over x402's exact scheme.",
   "keywords": [
     "lcp",
@@ -43,8 +43,8 @@
   },
   "homepage": "https://github.com/IntegraLedger/integra-protocol/tree/main/packages/binding-canton-x402#readme",
   "dependencies": {
-    "@integraledger/lcp-binding-core": "0.15.0",
-    "@integraledger/lcp-kernel": "0.15.0"
+    "@integraledger/lcp-binding-core": "0.16.0",
+    "@integraledger/lcp-kernel": "0.16.0"
   },
   "devDependencies": {
     "@types/node": "24.13.3",

package/src/adapter.ts

@@ -100,21 +100,49 @@ export interface CantonX402Adapter {
   ): Promise<CantonX402SettlementRef[]>;
 }
 
-/** Config for a live Daml JSON Ledger API participant reader. */
+/** Config for a live participant reader over a deployment's HTTP ledger surface. */
 export interface CantonX402ReaderConfig {
-  /** JSON Ledger API base URL — e.g. `https://164.92.95.184.nip.io`. */
+  /** Ledger API base URL — e.g. `https://participant.example`. */
   jsonLedgerUrl: string;
   /** Bearer JWT authenticating the reading party on the participant. */
   bearerJwt: string;
+  /**
+   * The path, relative to `jsonLedgerUrl`, that answers ONE update id with its transfer view. POSTed a
+   * `{ updateId }` body; answers a Daml `{ result, errors }` envelope.
+   *
+   * ⛔ **REQUIRED, and deliberately not defaulted.** This package shipped `/v1/updates/transfer` as a
+   * constant, and that is not an endpoint of any published Daml JSON API version: v1 defines
+   * `/v1/create`, `/v1/exercise`, `/v1/query` and `/v1/fetch` and no `updates` family at all, and the
+   * update endpoints that do exist live under `/v2/`. Nothing in this repository could have caught it —
+   * the only assertion over it is a stubbed `fetch` compared against the URL the code itself builds, so
+   * the test and the code restate one guess.
+   *
+   * The honest shape is configuration rather than a better guess. A Canton Coin
+   * `TransferFactory_Transfer` is a token-standard object, and how a given deployment exposes one over
+   * HTTP — stock JSON Ledger API version, scan proxy, or a facilitator's own service — is a property of
+   * that deployment. This package will not invent it: supply the path your participant answers on.
+   */
+  transferPath: string;
+  /**
+   * The path, relative to `jsonLedgerUrl`, that answers one party's visible transfer update ids. POSTed a
+   * `{ party, limit? }` body. REQUIRED for the same reason as {@link CantonX402ReaderConfig.transferPath};
+   * it shipped as `/v1/updates/transfers`.
+   */
+  transfersPath: string;
 }
 
 /**
- * A live `CantonX402Reader` over the Daml JSON Ledger API, PURE `fetch` — no Daml SDK.
+ * A live `CantonX402Reader` over a participant's HTTP ledger surface, PURE `fetch` — no Daml SDK.
  *
  * Fails LOUD on a non-2xx response or a Daml `errors[]` envelope; an absent update surfaces as `null`,
  * because a reference the participant cannot see is a value the caller must classify, not a transport
  * failure. No package id is required — the memo rides the CIP-56 token-standard transfer, so unlike the
  * overlay this replaced there is no deployment-specific DAR to deploy or configure.
+ *
+ * ⛔ **The two endpoint paths are yours to supply, and are refused when empty.** See
+ * {@link CantonX402ReaderConfig.transferPath}: the constants this once shipped named no endpoint of any
+ * published Daml JSON API version, and the only thing asserting them was a stubbed `fetch` compared with
+ * the URL this function builds — a test and a code path restating one guess to each other.
  */
 export function makeCantonX402Reader(
   cfg: CantonX402ReaderConfig,
@@ -123,6 +151,16 @@ export function makeCantonX402Reader(
     throw new Error("makeCantonX402Reader: jsonLedgerUrl is empty");
   if (cfg.bearerJwt.length === 0)
     throw new Error("makeCantonX402Reader: bearerJwt is empty");
+  // Fail at CONSTRUCTION, not at the first read: an empty path would POST to the base URL, and a
+  // participant answering something at `/` would be read as a transfer view.
+  if (cfg.transferPath.length === 0)
+    throw new Error(
+      "makeCantonX402Reader: transferPath is empty — this package does not guess your participant's update endpoint",
+    );
+  if (cfg.transfersPath.length === 0)
+    throw new Error(
+      "makeCantonX402Reader: transfersPath is empty — this package does not guess your participant's update endpoint",
+    );
 
   async function ledgerCall<T>(path: string, body: unknown): Promise<T> {
     const res = await fetch(`${cfg.jsonLedgerUrl}${path}`, {
@@ -150,13 +188,13 @@ export function makeCantonX402Reader(
       updateId: string,
     ): Promise<CantonX402TransferView | null> {
       const result = await ledgerCall<CantonX402TransferView | null>(
-        "/v1/updates/transfer",
+        cfg.transferPath,
         { updateId },
       );
       return result ?? null;
     },
     async transfersFor(party: string, limit?: number): Promise<string[]> {
-      return ledgerCall<string[]>("/v1/updates/transfers", {
+      return ledgerCall<string[]>(cfg.transfersPath, {
         party,
         ...(limit !== undefined ? { limit } : {}),
       });

package/src/constants.ts

@@ -63,3 +63,17 @@ export function getCantonX402Config(
   if (network === "devnet") return DEVNET;
   return MAINNET;
 }
+
+/**
+ * ⛔⛔ THE COLLECTION PATH THIS RAIL'S `weldGrades` IS KEYED BY — exported so a consumer looks the grade up
+ * with the SAME token this manifest declares it under.
+ *
+ * `binding-evm-x402` shipped `0.15.1` with `weldGrades` keyed `ERC3009` — the escrow sibling's COLLECTOR
+ * name — while the value a consumer computes from an x402 offer is `eip3009`. The map and the lookup key
+ * disagreed inside one published package, so `weldGrades[assetTransferMethod]` answered `undefined`: the
+ * grade absent rather than wrong, which reads as a rail declaring no weld grade at all. Nothing caught it —
+ * the profile schema constrains weldGrades VALUES (`signature` | `tx`) and says nothing about keys.
+ *
+ * ⇒ The key is a constant, not a literal, on every rail. `check:weld-grade-keys` holds it.
+ */
+export const CANTON_X402_COLLECTION_PATH = "x402-memo";

package/src/manifest.ts

@@ -1,5 +1,8 @@
 import type { BindingManifest } from "@integraledger/lcp-binding-core";
-import { CANTON_X402_MEMO_KEY } from "./constants.js";
+import {
+  CANTON_X402_COLLECTION_PATH,
+  CANTON_X402_MEMO_KEY,
+} from "./constants.js";
 
 /**
  * The Canton transfer-memo binding manifest.
@@ -77,6 +80,6 @@ export const CANTON_X402_MANIFEST: BindingManifest = {
     reversible: false,
     note: "a Canton transfer consumes the input holdings it names and Canton has no reversal, so an executed transfer's memo is permanent; recourse is the record's elected forum (PAY-3/RCS-5), never dispute resolution",
   },
-  weldGrades: { "x402-memo": "tx" },
+  weldGrades: { [CANTON_X402_COLLECTION_PATH]: "tx" },
   lifecycleStates: ["proposed", "settled"],
 };