@catena/sdk 0.1.0 → 0.4.0

package/dist/viem.d.mts

@@ -1,4 +1,4 @@
-import { F as OnchainNetworkInput, U as X402Authorization, W as X402PaymentRequirements, a as IntentSubmitError, n as CatenaClient, t as ApiError } from "./client-Cm2wNUuB.mjs";
+import { B as OnchainNetworkInput, X as X402PaymentRequirements, Y as X402Authorization, a as IntentSubmitError, n as CatenaClient, t as ApiError } from "./client-B_Gi0aqH.mjs";
 import { X402ApprovalPendingError, X402PaymentError, X402SubmitInterruptedError } from "./x402.mjs";
 import { LocalAccount } from "viem";
 //#region src/viem.d.ts
@@ -8,7 +8,7 @@ import { LocalAccount } from "viem";
  * `TransferWithAuthorization` typed data; `signMessage`, `signTransaction`,
  * and raw-hash signing are structurally unavailable.
  */
-declare class UnsupportedAccountCapabilityError extends Error {
+export declare class UnsupportedAccountCapabilityError extends Error {
   readonly capability: "signMessage" | "signTransaction";
   constructor(capability: "signMessage" | "signTransaction");
 }
@@ -16,12 +16,12 @@ declare class UnsupportedAccountCapabilityError extends Error {
  * Machine-readable reason a typed-data payload was refused before any
  * request was made. Branch on `reason`, not message prose.
  */
-type UnsupportedTypedDataReason = "primary_type" | "types" | "network" | "asset" | "domain" | "message" | "nonce" | "from_mismatch" | "recipient" | "expired" | "window";
+export type UnsupportedTypedDataReason = "primary_type" | "types" | "network" | "asset" | "domain" | "message" | "nonce" | "from_mismatch" | "recipient" | "expired" | "window";
 /**
  * The typed data is not something a Catena wallet can sign. Thrown
  * client-side, before any intent exists; nothing was submitted or paid.
  */
-declare class UnsupportedTypedDataError extends Error {
+export declare class UnsupportedTypedDataError extends Error {
   readonly reason: UnsupportedTypedDataReason;
   constructor(reason: UnsupportedTypedDataReason, message: string);
 }
@@ -30,7 +30,7 @@ declare class UnsupportedTypedDataError extends Error {
  * wallet's own address. x402 authorizations can only be signed for a wallet
  * account; pick an account whose deposit address source is `wallet`.
  */
-declare class NotAWalletAccountError extends Error {
+export declare class NotAWalletAccountError extends Error {
   readonly accountId: string;
   readonly source: string;
   constructor(accountId: string, source: string);
@@ -39,7 +39,7 @@ declare class NotAWalletAccountError extends Error {
  * Catena declined the payment (policy block or terminal failure). `reasons`
  * carries the server's detail; the same struct will not succeed on retry.
  */
-declare class X402PaymentDeclinedError extends X402PaymentError {
+export declare class X402PaymentDeclinedError extends X402PaymentError {
   readonly intentId: string;
   constructor(intentId: string, reasons: readonly string[]);
 }
@@ -50,7 +50,7 @@ declare class X402PaymentDeclinedError extends X402PaymentError {
  * approved x402 payment resting in this state — it waits for the paid
  * request to be re-run.
  */
-declare class X402PaymentInFlightError extends X402PaymentError {
+export declare class X402PaymentInFlightError extends X402PaymentError {
   readonly intentId: string;
   constructor(intentId: string, status: string);
 }
@@ -61,7 +61,7 @@ declare class X402PaymentInFlightError extends X402PaymentError {
  * return the same unusable value, so recovery here means reconciling the
  * payment with the operator, not fetching the signature again.
  */
-declare class X402PaymentSignatureUnusableError extends X402PaymentError {
+export declare class X402PaymentSignatureUnusableError extends X402PaymentError {
   readonly intentId: string;
   constructor(intentId: string, message: string);
 }
@@ -74,13 +74,13 @@ declare class X402PaymentSignatureUnusableError extends X402PaymentError {
  * money has moved, so it belongs to the family a caller branches on before
  * deciding whether to pay again. Reconcile with `getIntent(intentId)`.
  */
-declare class SignatureVerificationFailedError extends X402PaymentError {
+export declare class SignatureVerificationFailedError extends X402PaymentError {
   readonly intentId: string;
   readonly expectedAddress: string;
   readonly recoveredAddress: string | undefined;
   constructor(intentId: string, expectedAddress: string, recoveredAddress: string | undefined);
 }
-interface CatenaAccountOptions {
+export interface CatenaAccountOptions {
   /**
    * The wallet account payments draw from. Its deposit address must resolve
    * with source `wallet`.
@@ -102,16 +102,16 @@ interface CatenaAccountOptions {
  * whose only working capability is `signTypedData` for x402 EIP-3009
  * payment authorizations.
  */
-type CatenaAccount = LocalAccount;
+export type CatenaAccount = LocalAccount;
 /**
  * Present a Catena wallet as a viem `Account` for x402 client tooling.
  *
  * The returned account's `signTypedData` accepts exactly one shape — EIP-3009
- * `TransferWithAuthorization` for USDC on Base or Base Sepolia, the payload
- * x402 exact-scheme clients construct — and routes it through a Catena x402
- * intent: policy evaluates the payment, the custodial key signs the caller's
- * exact struct, and the signature is verified to recover to the wallet
- * address before it is returned. `signMessage` and `signTransaction` throw
+ * `TransferWithAuthorization` for an EVM token, the payload x402 exact-scheme
+ * clients construct — and routes it through a Catena x402 intent. The server
+ * decides whether the network and token contract are supported before signing;
+ * the returned signature is verified against the caller's exact struct before
+ * it is returned. `signMessage` and `signTransaction` throw
  * `UnsupportedAccountCapabilityError`; there is no raw-hash `sign`.
  *
  * Failure modes: `UnsupportedTypedDataError` (refused client-side, nothing
@@ -130,6 +130,6 @@ type CatenaAccount = LocalAccount;
  * Requires the optional `viem` peer dependency; importing this module
  * without viem installed fails with a module-not-found error naming it.
  */
-declare function createCatenaAccount(client: CatenaClient, options: CatenaAccountOptions): Promise<CatenaAccount>;
+export declare function createCatenaAccount(client: CatenaClient, options: CatenaAccountOptions): Promise<CatenaAccount>;
 //#endregion
-export { ApiError, CatenaAccount, CatenaAccountOptions, IntentSubmitError, NotAWalletAccountError, type OnchainNetworkInput, SignatureVerificationFailedError, UnsupportedAccountCapabilityError, UnsupportedTypedDataError, UnsupportedTypedDataReason, X402ApprovalPendingError, type X402Authorization, X402PaymentDeclinedError, X402PaymentError, X402PaymentInFlightError, type X402PaymentRequirements, X402PaymentSignatureUnusableError, X402SubmitInterruptedError, createCatenaAccount };
+export { ApiError, IntentSubmitError, type OnchainNetworkInput, X402ApprovalPendingError, type X402Authorization, X402PaymentError, type X402PaymentRequirements, X402SubmitInterruptedError };

package/dist/viem.mjs

@@ -1,19 +1,9 @@
-import { b as x402CredentialFromIntentData, n as IntentSubmitError, t as ApiError } from "./client-CHZMO00P.mjs";
+import { n as IntentSubmitError, t as ApiError, w as x402CredentialFromIntentData } from "./client-BSYVYJGm.mjs";
 import { X402ApprovalPendingError, X402PaymentError, X402SubmitInterruptedError } from "./x402.mjs";
 import * as v from "valibot";
 import { getAddress, isAddress, isHex, recoverTypedDataAddress } from "viem";
 import { toAccount } from "viem/accounts";
 //#region src/viem.ts
-const NETWORKS = {
-	"8453": {
-		network: "eip155:8453",
-		usdc: getAddress("0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913")
-	},
-	"84532": {
-		network: "eip155:84532",
-		usdc: getAddress("0x036CbD53842c5426634e7929541eC2318f3dCF7e")
-	}
-};
 const EIP712_DOMAIN_TYPE = [
 	{
 		name: "name",
@@ -185,6 +175,11 @@ const CANONICAL_DOMAIN_TYPE = encodeCanonicalTable(EIP712_DOMAIN_TYPE);
 function isEvmAddress(value) {
 	return isAddress(value);
 }
+function evmNetwork(chainId) {
+	if (typeof chainId === "number" && !Number.isSafeInteger(chainId)) return;
+	const numeric = typeof chainId === "bigint" ? chainId : BigInt(chainId);
+	return numeric >= 1n && numeric <= BigInt(Number.MAX_SAFE_INTEGER) ? `eip155:${numeric}` : void 0;
+}
 async function createCatenaAccount(client, options) {
 	const deposit = await client.getAccountDepositAddress(options.accountId, {
 		network: options.network ?? "base",
@@ -211,9 +206,9 @@ async function signX402TypedData(client, args) {
 	const transferType = types["TransferWithAuthorization"];
 	if (encodeTypeTable(transferType) !== CANONICAL_TRANSFER_TYPE) throw new UnsupportedTypedDataError("types", "The TransferWithAuthorization type definition does not match EIP-3009");
 	if (domain.chainId === void 0) throw new UnsupportedTypedDataError("network", "The typed data names no chainId");
-	const chain = Object.hasOwn(NETWORKS, String(domain.chainId)) ? NETWORKS[String(domain.chainId)] : void 0;
-	if (!chain) throw new UnsupportedTypedDataError("network", `Chain ${String(domain.chainId)} is not supported; use Base (8453) or Base Sepolia (84532)`);
-	if (domain.verifyingContract === void 0 || !isEvmAddress(domain.verifyingContract) || getAddress(domain.verifyingContract) !== chain.usdc) throw new UnsupportedTypedDataError("asset", `The verifying contract must be USDC ${chain.usdc} on chain ${String(domain.chainId)}`);
+	const network = evmNetwork(domain.chainId);
+	if (network === void 0) throw new UnsupportedTypedDataError("network", "The typed data chainId must be a positive safe integer");
+	if (domain.verifyingContract === void 0 || !isEvmAddress(domain.verifyingContract)) throw new UnsupportedTypedDataError("asset", "The verifying contract must be a 20-byte hex address, either all-lowercase or with a valid EIP-55 checksum");
 	if (!domain.name || !domain.version) throw new UnsupportedTypedDataError("domain", "The typed-data domain must carry the token's name and version");
 	const unsupportedDomainFields = Object.entries(domain).filter(([key, value]) => !CANONICAL_DOMAIN_FIELDS.has(key) && value !== void 0).map(([key]) => key);
 	if (unsupportedDomainFields.length > 0) throw new UnsupportedTypedDataError("domain", `The typed-data domain carries fields this account cannot sign over: ${unsupportedDomainFields.join(", ")}`);
@@ -240,7 +235,7 @@ async function signX402TypedData(client, args) {
 	};
 	const paymentRequirements = {
 		scheme: "exact",
-		network: chain.network,
+		network,
 		asset: getAddress(domain.verifyingContract),
 		amount: authorization.value,
 		payTo: message.to,

package/dist/x402.d.mts

@@ -1,4 +1,4 @@
-import { G as X402Resource, W as X402PaymentRequirements, i as FetchLike, n as CatenaClient } from "./client-Cm2wNUuB.mjs";
+import { J as WalletCounterpartyRail, X as X402PaymentRequirements, Z as X402Resource, i as FetchLike, n as CatenaClient } from "./client-B_Gi0aqH.mjs";
 import * as v from "valibot";
 //#region src/x402.d.ts
 declare const paymentRequiredSchema: v.LooseObjectSchema<{
@@ -26,12 +26,12 @@ declare const paymentRequiredSchema: v.LooseObjectSchema<{
    */
   readonly extensions: v.OptionalSchema<v.UnknownSchema, undefined>;
 }, undefined>;
-type X402PaymentRequired = v.InferOutput<typeof paymentRequiredSchema>;
+export type X402PaymentRequired = v.InferOutput<typeof paymentRequiredSchema>;
 /**
  * Decode a 402 response's `PAYMENT-REQUIRED` challenge. Returns undefined for
  * a 402 that carries no decodable v2 challenge (not an x402 endpoint).
  */
-declare function decodePaymentRequired(response: Response): X402PaymentRequired | undefined;
+export declare function decodePaymentRequired(response: Response): X402PaymentRequired | undefined;
 /**
  * Payment failure raised by this module; `reasons` carries the policy or
  * decline detail when the server provided any, and subclasses mark the cases
@@ -41,7 +41,7 @@ declare function decodePaymentRequired(response: Response): X402PaymentRequired
  * `TimeoutError` also propagates unchanged; no payment was authorized, so
  * re-running cannot double-pay.
  */
-declare class X402PaymentError extends Error {
+export declare class X402PaymentError extends Error {
   readonly reasons: readonly string[];
   constructor(message: string, reasons?: readonly string[],
   /**
@@ -60,7 +60,7 @@ declare class X402PaymentError extends Error {
  * account on one of `requiredNetworks`, not to change policy. Consumers can
  * name those networks (and, for a CLI, tell the user how to switch accounts).
  */
-declare class X402NetworkMismatchError extends X402PaymentError {
+export declare class X402NetworkMismatchError extends X402PaymentError {
   readonly accountId: string;
   readonly requiredNetworks: readonly string[];
   constructor(accountId: string, requiredNetworks: readonly string[], reasons?: readonly string[]);
@@ -73,15 +73,21 @@ declare class X402NetworkMismatchError extends X402PaymentError {
  * `network`, then a re-run. Consumers can name the recipient (and, for a CLI,
  * print the exact counterparty-create command).
  */
-declare class X402CounterpartyNotFoundError extends X402PaymentError {
+export declare class X402CounterpartyNotFoundError extends X402PaymentError {
   readonly payTo: string;
   readonly network: string;
+  /**
+   * Server-resolved Catena rail that can be passed to a
+   * `create_counterparty` intent. Absent when the server sends no valid rail,
+   * or when the rail names a different recipient than the challenge.
+   */
+  readonly requiredRail: WalletCounterpartyRail | undefined;
   /**
    * The challenge's advertised service name, when present — a suggested
    * counterparty name.
    */
   readonly serviceName: string | undefined;
-  constructor(payTo: string, network: string, serviceName?: string, reasons?: readonly string[]);
+  constructor(payTo: string, network: string, serviceName?: string, reasons?: readonly string[], requiredRail?: WalletCounterpartyRail);
 }
 /**
  * The payment exceeded a policy limit and is parked for a human approval.
@@ -89,7 +95,7 @@ declare class X402CounterpartyNotFoundError extends X402PaymentError {
  * same request (same endpoint, same price) consumes the approval and pays.
  * `expiresAt` is when the pending approval self-expires.
  */
-declare class X402ApprovalPendingError extends X402PaymentError {
+export declare class X402ApprovalPendingError extends X402PaymentError {
   readonly intentId: string;
   readonly expiresAt: string | null;
   constructor(intentId: string, reasons: readonly string[], expiresAt: string | null);
@@ -103,7 +109,7 @@ declare class X402ApprovalPendingError extends X402PaymentError {
  * authorization is valid) — re-running the whole loop would mint a second
  * payment.
  */
-declare class X402RetryFailedError extends X402PaymentError {
+export declare class X402RetryFailedError extends X402PaymentError {
   readonly receipt: X402PaymentReceipt;
   constructor(receipt: X402PaymentReceipt, cause: unknown);
 }
@@ -117,12 +123,12 @@ declare class X402RetryFailedError extends X402PaymentError {
  * processing, it is mid-settlement — keep polling. Pay again only once it is
  * terminally blocked or failed.
  */
-declare class X402SubmitInterruptedError extends X402PaymentError {
+export declare class X402SubmitInterruptedError extends X402PaymentError {
   readonly intentId: string;
   readonly requirements: X402PaymentRequirements;
   constructor(intentId: string, requirements: X402PaymentRequirements, cause: unknown);
 }
-interface X402PaymentReceipt {
+export interface X402PaymentReceipt {
   /**
    * The Catena intent that settled the payment; pass to `getIntent`.
    */
@@ -151,7 +157,7 @@ interface X402PaymentReceipt {
  * propagates unchanged; no payment was authorized, so re-running cannot
  * double-pay.
  */
-declare function payX402Challenge(client: CatenaClient, args: {
+export declare function payX402Challenge(client: CatenaClient, args: {
   accountId: string;
   paymentRequired: X402PaymentRequired;
   /**
@@ -170,7 +176,7 @@ declare function payX402Challenge(client: CatenaClient, args: {
    */
   maxAtomicAmount?: bigint;
 }): Promise<X402PaymentReceipt>;
-interface X402FetchOptions {
+export interface X402FetchOptions {
   /**
    * Source wallet account the payments draw from.
    */
@@ -201,6 +207,6 @@ interface X402FetchOptions {
  * propagates unchanged; no payment was authorized, so re-running cannot
  * double-pay.
  */
-declare function wrapFetchWithX402Payment(client: CatenaClient, options: X402FetchOptions): FetchLike;
+export declare function wrapFetchWithX402Payment(client: CatenaClient, options: X402FetchOptions): FetchLike;
 //#endregion
-export { X402ApprovalPendingError, X402CounterpartyNotFoundError, X402FetchOptions, X402NetworkMismatchError, X402PaymentError, X402PaymentReceipt, X402PaymentRequired, type X402PaymentRequirements, type X402Resource, X402RetryFailedError, X402SubmitInterruptedError, decodePaymentRequired, payX402Challenge, wrapFetchWithX402Payment };
+export type { WalletCounterpartyRail, X402PaymentRequirements, X402Resource };

package/dist/x402.mjs

@@ -1,5 +1,5 @@
-import { C as extractRelayableOffer, S as x402ResourceSchema, b as x402CredentialFromIntentData, n as IntentSubmitError, t as ApiError, w as extractRelayableReceipt, x as x402PaymentRequirementsSchema } from "./client-CHZMO00P.mjs";
-import { a as assertNever, i as isReplayableFetchRequest, n as reportSettlementHint$1, r as fetchRetryHeaders, t as EVM_TRANSACTION_HASH_PATTERN } from "./settlement-report-CT3EbtLL.mjs";
+import { D as extractRelayableOffer, E as x402ResourceSchema, O as extractRelayableReceipt, T as x402PaymentRequirementsSchema, n as IntentSubmitError, t as ApiError, w as x402CredentialFromIntentData } from "./client-BSYVYJGm.mjs";
+import { a as isReplayableFetchRequest, i as fetchRetryHeaders, n as reportSettlementHint$1, o as requiredWalletRailFromDetails, r as paymentNetworkLabel, s as assertNever, t as EVM_TRANSACTION_HASH_PATTERN } from "./settlement-report-DTxaAxE3.mjs";
 import * as v from "valibot";
 //#region src/x402.ts
 const PAYMENT_REQUIRED_HEADERS = ["PAYMENT-REQUIRED", "X-Payment-Required"];
@@ -25,14 +25,6 @@ const TRY_NEXT_REQUIREMENT_CODES = new Set([
 	X402_NETWORK_MISMATCH_CODE,
 	X402_COUNTERPARTY_RAIL_NOT_FOUND_CODE
 ]);
-const NETWORK_LABELS = {
-	"eip155:8453": "Base",
-	"eip155:84532": "Base Sepolia"
-};
-function networkLabel(network) {
-	const label = Object.hasOwn(NETWORK_LABELS, network) ? NETWORK_LABELS[network] : void 0;
-	return label ? `${label} (${network})` : network;
-}
 function decodeBase64Json(value) {
 	const normalized = value.replaceAll("-", "+").replaceAll("_", "/");
 	const bytes = Uint8Array.from(atob(normalized), (char) => char.charCodeAt(0));
@@ -70,7 +62,7 @@ var X402NetworkMismatchError = class extends X402PaymentError {
 	accountId;
 	requiredNetworks;
 	constructor(accountId, requiredNetworks, reasons = []) {
-		super(`Account ${accountId} cannot fund this 402 challenge: it must be paid from a wallet account on ${requiredNetworks.map(networkLabel).join(" or ")}`, reasons, { appendReasonsToMessage: false });
+		super(`Account ${accountId} cannot fund this 402 challenge: it must be paid from a wallet account on ${requiredNetworks.map(paymentNetworkLabel).join(" or ")}`, reasons, { appendReasonsToMessage: false });
 		this.name = "X402NetworkMismatchError";
 		this.accountId = accountId;
 		this.requiredNetworks = requiredNetworks;
@@ -79,13 +71,15 @@ var X402NetworkMismatchError = class extends X402PaymentError {
 var X402CounterpartyNotFoundError = class extends X402PaymentError {
 	payTo;
 	network;
+	requiredRail;
 	serviceName;
-	constructor(payTo, network, serviceName, reasons = []) {
-		super(`This 402 pays ${payTo} on ${networkLabel(network)}, which is not a saved counterparty wallet rail; add it as a counterparty before paying`, reasons, { appendReasonsToMessage: false });
+	constructor(payTo, network, serviceName, reasons = [], requiredRail) {
+		super(`This 402 pays ${payTo} on ${paymentNetworkLabel(network)}, which is not a saved counterparty wallet rail; add it as a counterparty before paying`, reasons, { appendReasonsToMessage: false });
 		this.name = "X402CounterpartyNotFoundError";
 		this.payTo = payTo;
 		this.network = network;
 		this.serviceName = serviceName;
+		this.requiredRail = requiredRail;
 	}
 };
 var X402ApprovalPendingError = class extends X402PaymentError {
@@ -158,7 +152,7 @@ async function payX402Challenge(client, args) {
 		...otherSkips
 	].map((skip) => skip.error.message))];
 	const unsaved = counterpartySkips.find((skip) => skip.error.status === 404 && EVM_ADDRESS.test(skip.requirement.payTo));
-	if (unsaved) throw new X402CounterpartyNotFoundError(unsaved.requirement.payTo, unsaved.requirement.network, resource?.serviceName, reasons);
+	if (unsaved) throw new X402CounterpartyNotFoundError(unsaved.requirement.payTo, unsaved.requirement.network, resource?.serviceName, reasons, requiredWalletRailFromDetails(unsaved.error.details, unsaved.requirement.payTo));
 	if (mismatchSkips.length > 0 && counterpartySkips.length === 0) throw new X402NetworkMismatchError(args.accountId, [...new Set(mismatchSkips.map((skip) => skip.requirement.network))], reasons);
 	throw new X402PaymentError("No requirement in the 402 challenge is payable from this account", reasons);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catena/sdk",
-  "version": "0.1.0",
+  "version": "0.4.0",
   "description": "Typed client SDK for the Catena agent API",
   "homepage": "https://catena.com/",
   "license": "Apache-2.0",
@@ -34,18 +34,18 @@
     "access": "public"
   },
   "dependencies": {
-    "@turnkey/api-key-stamper": "0.6.12",
+    "@turnkey/api-key-stamper": "0.6.14",
     "valibot": "1.4.2"
   },
   "devDependencies": {
-    "mppx": "0.9.0",
-    "publint": "0.3.23",
-    "tsdown": "0.22.14",
-    "viem": "2.55.17"
+    "mppx": "0.9.2",
+    "publint": "0.3.24",
+    "tsdown": "0.23.0",
+    "viem": "2.56.3"
   },
   "peerDependencies": {
-    "mppx": "0.9.0",
-    "viem": "^2.21.0"
+    "mppx": "^0.9.0",
+    "viem": "^2.24.0"
   },
   "peerDependenciesMeta": {
     "mppx": {
@@ -58,7 +58,7 @@
   "engines": {
     "node": ">=20"
   },
-  "gitHead": "1399d4f6d848c75a28aa8819cf05e47c36ee31b6",
+  "gitHead": "d063f4fe2ff6940a73a547b7f11eb4d67f9b4748",
   "scripts": {
     "build": "tsdown",
     "clean": "git clean -xdf dist node_modules/.cache",