@t402/wdk 2.4.0 → 2.6.0

package/dist/cjs/integrations/index.d.ts

@@ -0,0 +1,9 @@
+export { A as A2APaymentPayload, a as A2APaymentRequired, F as FacilitatorWdkSigner, h as FacilitatorWdkSignerOptions, S as SIWxSigner, r as WdkA2AOptions, s as WdkA2APaymentClient, v as createFacilitatorSigners, w as createSIWxSigners, y as createWdkA2APaymentClient, Z as toFacilitatorWdkSigner, _ as toSIWxSigner } from '../index-DnEI5M6d.js';
+import 'viem';
+import '../types-BwK8Xgvg.js';
+import '../adapters/ton-adapter.js';
+import '../adapters/svm-adapter.js';
+import '../adapters/tron-adapter.js';
+import '../adapters/index.js';
+import '@t402/evm';
+import '@t402/core/types';

package/dist/cjs/integrations/index.js

@@ -0,0 +1,249 @@
+"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/integrations/index.ts
+var integrations_exports = {};
+__export(integrations_exports, {
+  createFacilitatorSigners: () => createFacilitatorSigners,
+  createSIWxSigners: () => createSIWxSigners,
+  createWdkA2APaymentClient: () => createWdkA2APaymentClient,
+  toFacilitatorWdkSigner: () => toFacilitatorWdkSigner,
+  toSIWxSigner: () => toSIWxSigner
+});
+module.exports = __toCommonJS(integrations_exports);
+
+// src/integrations/a2a-adapter.ts
+function findBestOption(accepts, signers, preferredScheme) {
+  const signerNetworks = new Set(signers.map((s) => s.network));
+  const exactMatch = accepts.find(
+    (a) => a.scheme === preferredScheme && signerNetworks.has(a.network)
+  );
+  if (exactMatch) return exactMatch;
+  const networkMatch = accepts.find((a) => signerNetworks.has(a.network));
+  if (networkMatch) return networkMatch;
+  const schemeMatch = accepts.find((a) => a.scheme === preferredScheme);
+  if (schemeMatch) return schemeMatch;
+  return accepts[0];
+}
+async function createWdkA2APaymentClient(wdk, options) {
+  const preferredScheme = options?.preferredScheme ?? "exact";
+  const signers = await wdk.getAllSigners({ schemes: [preferredScheme] });
+  const paymentHandler = async (req) => {
+    if (!req.accepts || req.accepts.length === 0) {
+      throw new Error("No payment options in requirements");
+    }
+    const selected = findBestOption(req.accepts, signers, preferredScheme);
+    if (!selected) {
+      throw new Error("No compatible payment option found for available signers");
+    }
+    if (options?.spendingLimit !== void 0) {
+      const amount = BigInt(selected.amount);
+      if (amount > options.spendingLimit) {
+        throw new Error(`Payment amount ${amount} exceeds spending limit ${options.spendingLimit}`);
+      }
+    }
+    if (options?.onApprovalRequired) {
+      const approved = await options.onApprovalRequired({
+        amount: BigInt(selected.amount),
+        network: selected.network
+      });
+      if (!approved) {
+        throw new Error("Payment rejected by approval callback");
+      }
+    }
+    const signerEntry = signers.find((s) => s.network === selected.network && s.scheme === selected.scheme) ?? signers.find((s) => s.network === selected.network);
+    if (!signerEntry) {
+      throw new Error(`No signer available for network ${selected.network}`);
+    }
+    if (options?.autoBalance) {
+      const chainName = getChainNameFromNetwork(wdk, selected.network);
+      if (chainName) {
+        const balance = await wdk.getUsdt0Balance(chainName);
+        const requiredAmount = BigInt(selected.amount);
+        if (balance < requiredAmount && options.autoBridge) {
+          const best = await wdk.findBestChainForPayment(requiredAmount);
+          if (best && best.chain !== chainName) {
+            await wdk.bridgeUsdt0({
+              fromChain: best.chain,
+              toChain: chainName,
+              amount: requiredAmount
+            });
+          }
+        }
+      }
+    }
+    const signer = signerEntry.signer;
+    const now = Math.floor(Date.now() / 1e3);
+    const deadline = now + selected.maxTimeoutSeconds;
+    const nonce = "0x" + Array.from(globalThis.crypto.getRandomValues(new Uint8Array(32))).map((b) => b.toString(16).padStart(2, "0")).join("");
+    const chainId = parseInt(selected.network.split(":")[1] || "0");
+    const signature = await signer.signTypedData({
+      domain: {
+        name: "USD\u20AE0",
+        version: "1",
+        chainId,
+        verifyingContract: selected.asset
+      },
+      types: {
+        TransferWithAuthorization: [
+          { name: "from", type: "address" },
+          { name: "to", type: "address" },
+          { name: "value", type: "uint256" },
+          { name: "validAfter", type: "uint256" },
+          { name: "validBefore", type: "uint256" },
+          { name: "nonce", type: "bytes32" }
+        ]
+      },
+      primaryType: "TransferWithAuthorization",
+      message: {
+        from: signer.address,
+        to: selected.payTo,
+        value: BigInt(selected.amount),
+        validAfter: 0n,
+        validBefore: BigInt(deadline),
+        nonce
+      }
+    });
+    return {
+      t402Version: req.t402Version,
+      resource: req.resource,
+      accepted: selected,
+      payload: {
+        signature,
+        from: signer.address,
+        validAfter: "0",
+        validBefore: deadline.toString(),
+        nonce
+      }
+    };
+  };
+  return { signers, paymentHandler };
+}
+function getChainNameFromNetwork(wdk, network) {
+  for (const chain of wdk.getConfiguredChains()) {
+    const config = wdk.getChainConfig(chain);
+    if (config && config.network === network) {
+      return chain;
+    }
+  }
+  return void 0;
+}
+
+// src/integrations/facilitator-adapter.ts
+async function toFacilitatorWdkSigner(wdk, chain, options) {
+  const wdkSigner = await wdk.getSigner(chain);
+  const address = wdkSigner.address;
+  return {
+    address,
+    async signTransaction(tx) {
+      if (tx && typeof tx === "object" && "domain" in tx) {
+        const typedData = tx;
+        return wdkSigner.signTypedData(typedData);
+      }
+      if (typeof tx === "string") {
+        return wdkSigner.signMessage(tx);
+      }
+      throw new Error("Unsupported transaction format for WDK facilitator signer");
+    },
+    async signTypedData(data) {
+      return wdkSigner.signTypedData(data);
+    },
+    async sendTransaction(params) {
+      const result = await wdkSigner.sendTransaction({
+        to: params.to,
+        value: params.value,
+        data: params.data
+      });
+      if (options?.bridgeToMainChain && options.bridgeToMainChain !== chain) {
+        const balance = await wdk.getUsdt0Balance(chain);
+        if (balance > 0n) {
+          try {
+            await wdk.bridgeUsdt0({
+              fromChain: chain,
+              toChain: options.bridgeToMainChain,
+              amount: balance
+            });
+          } catch {
+          }
+        }
+      }
+      return result.hash;
+    }
+  };
+}
+async function createFacilitatorSigners(wdk, options) {
+  const chains = wdk.getConfiguredChains();
+  const signers = /* @__PURE__ */ new Map();
+  const results = await Promise.allSettled(
+    chains.map(async (chain) => {
+      const signer = await toFacilitatorWdkSigner(wdk, chain, options);
+      return { chain, signer };
+    })
+  );
+  for (const result of results) {
+    if (result.status === "fulfilled") {
+      signers.set(result.value.chain, result.value.signer);
+    }
+  }
+  return signers;
+}
+
+// src/integrations/siwx-adapter.ts
+async function toSIWxSigner(wdk, chain) {
+  const wdkSigner = await wdk.getSigner(chain);
+  return {
+    address: wdkSigner.address,
+    async signMessage(message) {
+      return wdkSigner.signMessage(message);
+    },
+    async signTypedData(data) {
+      return wdkSigner.signTypedData({
+        domain: data.domain,
+        types: data.types,
+        primaryType: data.primaryType,
+        message: data.message
+      });
+    }
+  };
+}
+async function createSIWxSigners(wdk) {
+  const chains = wdk.getConfiguredChains();
+  const signers = /* @__PURE__ */ new Map();
+  const results = await Promise.allSettled(
+    chains.map(async (chain) => {
+      const signer = await toSIWxSigner(wdk, chain);
+      return { chain, signer };
+    })
+  );
+  for (const result of results) {
+    if (result.status === "fulfilled") {
+      signers.set(result.value.chain, result.value.signer);
+    }
+  }
+  return signers;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createFacilitatorSigners,
+  createSIWxSigners,
+  createWdkA2APaymentClient,
+  toFacilitatorWdkSigner,
+  toSIWxSigner
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/integrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/integrations/index.ts","../../../src/integrations/a2a-adapter.ts","../../../src/integrations/facilitator-adapter.ts","../../../src/integrations/siwx-adapter.ts"],"sourcesContent":["/**\n * WDK Integration Adapters\n *\n * Adapters for integrating T402WDK with other T402 protocol components:\n * - A2A (Agent-to-Agent) transport\n * - Facilitator settlement\n * - SIWx (Sign-In-With-X) authentication\n */\n\nexport {\n  createWdkA2APaymentClient,\n  type WdkA2AOptions,\n  type WdkA2APaymentClient,\n  type A2APaymentRequired,\n  type A2APaymentPayload,\n} from './a2a-adapter.js'\n\nexport {\n  toFacilitatorWdkSigner,\n  createFacilitatorSigners,\n  type FacilitatorWdkSignerOptions,\n  type FacilitatorWdkSigner,\n} from './facilitator-adapter.js'\n\nexport { toSIWxSigner, createSIWxSigners, type SIWxSigner } from './siwx-adapter.js'\n","/**\n * A2A + WDK Adapter\n *\n * Bridges T402WDK wallets with the A2A (Agent-to-Agent) payment transport,\n * enabling AI agents to make payments using WDK-managed wallets.\n */\n\nimport type { T402WDK } from '../t402wdk.js'\nimport type { SignerEntry } from '../types.js'\n\n/**\n * Payment requirements received from an A2A server (402 response).\n * Matches the core PaymentRequired type shape.\n */\nexport interface A2APaymentRequired {\n  t402Version: number\n  resource: { url: string; description?: string; mimeType?: string }\n  accepts: Array<{\n    scheme: string\n    network: string\n    asset: string\n    amount: string\n    payTo: string\n    maxTimeoutSeconds: number\n    extra: Record<string, unknown>\n  }>\n  extensions?: Record<string, unknown>\n}\n\n/**\n * Payment payload to submit to an A2A server.\n * Matches the core PaymentPayload type shape.\n */\nexport interface A2APaymentPayload {\n  t402Version: number\n  resource?: { url: string; description?: string; mimeType?: string }\n  accepted: A2APaymentRequired['accepts'][0]\n  payload: Record<string, unknown>\n  extensions?: Record<string, unknown>\n}\n\n/**\n * Options for the WDK A2A payment client adapter.\n */\nexport interface WdkA2AOptions {\n  /** Maximum spending limit per payment (in atomic units) */\n  spendingLimit?: bigint\n  /** Callback when manual approval is required */\n  onApprovalRequired?: (payment: { amount: bigint; network: string }) => Promise<boolean>\n  /** Auto-check balance before payment */\n  autoBalance?: boolean\n  /** Auto-bridge if insufficient balance on target chain */\n  autoBridge?: boolean\n  /** Preferred payment scheme (default: \"exact\") */\n  preferredScheme?: string\n}\n\n/**\n * Result of createWdkA2APaymentClient.\n */\nexport interface WdkA2APaymentClient {\n  /** Signer entries from WDK for all configured chains */\n  signers: SignerEntry[]\n  /** Handle a 402 payment required response */\n  paymentHandler: (req: A2APaymentRequired) => Promise<A2APaymentPayload>\n}\n\n/**\n * Find the best matching payment option for the available signers.\n */\nfunction findBestOption(\n  accepts: A2APaymentRequired['accepts'],\n  signers: SignerEntry[],\n  preferredScheme: string,\n): A2APaymentRequired['accepts'][0] | undefined {\n  const signerNetworks = new Set(signers.map((s) => s.network))\n\n  // Prefer matching both scheme and network\n  const exactMatch = accepts.find(\n    (a) => a.scheme === preferredScheme && signerNetworks.has(a.network),\n  )\n  if (exactMatch) return exactMatch\n\n  // Match by network only\n  const networkMatch = accepts.find((a) => signerNetworks.has(a.network))\n  if (networkMatch) return networkMatch\n\n  // Match by scheme only\n  const schemeMatch = accepts.find((a) => a.scheme === preferredScheme)\n  if (schemeMatch) return schemeMatch\n\n  return accepts[0]\n}\n\n/**\n * Create a WDK-backed A2A payment client.\n *\n * Extracts all configured chain signers from WDK and wraps them for A2A use.\n * The returned `paymentHandler` selects the best signer for the payment\n * requirements, optionally checks balance, and creates a signed payment payload.\n *\n * @param wdk - An initialized T402WDK instance\n * @param options - Configuration options\n * @returns Object with signers and a paymentHandler function\n *\n * @example\n * ```typescript\n * const { signers, paymentHandler } = await createWdkA2APaymentClient(wdk, {\n *   spendingLimit: 10_000_000n, // 10 USDT0\n *   autoBalance: true,\n * });\n *\n * // When the A2A agent receives a 402 response:\n * const payload = await paymentHandler(paymentRequired);\n * // Submit payload back to the A2A server\n * ```\n */\nexport async function createWdkA2APaymentClient(\n  wdk: T402WDK,\n  options?: WdkA2AOptions,\n): Promise<WdkA2APaymentClient> {\n  const preferredScheme = options?.preferredScheme ?? 'exact'\n\n  // Get all signers from WDK\n  const signers = await wdk.getAllSigners({ schemes: [preferredScheme] })\n\n  const paymentHandler = async (req: A2APaymentRequired): Promise<A2APaymentPayload> => {\n    if (!req.accepts || req.accepts.length === 0) {\n      throw new Error('No payment options in requirements')\n    }\n\n    // Find the best option\n    const selected = findBestOption(req.accepts, signers, preferredScheme)\n    if (!selected) {\n      throw new Error('No compatible payment option found for available signers')\n    }\n\n    // Check spending limit\n    if (options?.spendingLimit !== undefined) {\n      const amount = BigInt(selected.amount)\n      if (amount > options.spendingLimit) {\n        throw new Error(`Payment amount ${amount} exceeds spending limit ${options.spendingLimit}`)\n      }\n    }\n\n    // Request approval if callback provided\n    if (options?.onApprovalRequired) {\n      const approved = await options.onApprovalRequired({\n        amount: BigInt(selected.amount),\n        network: selected.network,\n      })\n      if (!approved) {\n        throw new Error('Payment rejected by approval callback')\n      }\n    }\n\n    // Find the matching signer\n    const signerEntry =\n      signers.find((s) => s.network === selected.network && s.scheme === selected.scheme) ??\n      signers.find((s) => s.network === selected.network)\n\n    if (!signerEntry) {\n      throw new Error(`No signer available for network ${selected.network}`)\n    }\n\n    // Auto-balance check\n    if (options?.autoBalance) {\n      const chainName = getChainNameFromNetwork(wdk, selected.network)\n      if (chainName) {\n        const balance = await wdk.getUsdt0Balance(chainName)\n        const requiredAmount = BigInt(selected.amount)\n        if (balance < requiredAmount && options.autoBridge) {\n          // Try to find a chain with enough balance and bridge\n          const best = await wdk.findBestChainForPayment(requiredAmount)\n          if (best && best.chain !== chainName) {\n            await wdk.bridgeUsdt0({\n              fromChain: best.chain,\n              toChain: chainName,\n              amount: requiredAmount,\n            })\n          }\n        }\n      }\n    }\n\n    // Sign the payment using the WDK signer\n    const signer = signerEntry.signer as {\n      signTypedData: (params: Record<string, unknown>) => Promise<string>\n      address: string\n    }\n\n    // Create EIP-3009 transferWithAuthorization typed data\n    const now = Math.floor(Date.now() / 1000)\n    const deadline = now + selected.maxTimeoutSeconds\n    const nonce =\n      '0x' +\n      Array.from(globalThis.crypto.getRandomValues(new Uint8Array(32)))\n        .map((b) => b.toString(16).padStart(2, '0'))\n        .join('')\n\n    const chainId = parseInt(selected.network.split(':')[1] || '0')\n\n    const signature = await signer.signTypedData({\n      domain: {\n        name: 'USD₮0',\n        version: '1',\n        chainId,\n        verifyingContract: selected.asset,\n      },\n      types: {\n        TransferWithAuthorization: [\n          { name: 'from', type: 'address' },\n          { name: 'to', type: 'address' },\n          { name: 'value', type: 'uint256' },\n          { name: 'validAfter', type: 'uint256' },\n          { name: 'validBefore', type: 'uint256' },\n          { name: 'nonce', type: 'bytes32' },\n        ],\n      },\n      primaryType: 'TransferWithAuthorization',\n      message: {\n        from: signer.address,\n        to: selected.payTo,\n        value: BigInt(selected.amount),\n        validAfter: 0n,\n        validBefore: BigInt(deadline),\n        nonce,\n      },\n    })\n\n    return {\n      t402Version: req.t402Version,\n      resource: req.resource,\n      accepted: selected,\n      payload: {\n        signature,\n        from: signer.address,\n        validAfter: '0',\n        validBefore: deadline.toString(),\n        nonce,\n      },\n    }\n  }\n\n  return { signers, paymentHandler }\n}\n\n/**\n * Get chain name from CAIP-2 network identifier.\n */\nfunction getChainNameFromNetwork(wdk: T402WDK, network: string): string | undefined {\n  for (const chain of wdk.getConfiguredChains()) {\n    const config = wdk.getChainConfig(chain)\n    if (config && config.network === network) {\n      return chain\n    }\n  }\n  return undefined\n}\n","/**\n * Facilitator + WDK Adapter\n *\n * Wraps a T402WDK wallet as a facilitator-compatible signer, enabling WDK\n * wallets to be used for on-chain settlement (verify + settle operations).\n */\n\nimport type { T402WDK } from '../t402wdk.js'\nimport type { WDKSigner } from '../signer.js'\n\n/**\n * Options for the facilitator WDK signer adapter.\n */\nexport interface FacilitatorWdkSignerOptions {\n  /** Automatically settle payments after verification */\n  autoSettle?: boolean\n  /** Auto-bridge received payments to this chain (CAIP-2 network or chain name) */\n  bridgeToMainChain?: string\n}\n\n/**\n * Facilitator-compatible signer backed by WDK.\n */\nexport interface FacilitatorWdkSigner {\n  /** Wallet address on the target chain */\n  address: string\n  /** Sign a transaction for on-chain settlement */\n  signTransaction: (tx: unknown) => Promise<string>\n  /** Sign typed data (EIP-712) */\n  signTypedData: (data: {\n    domain: Record<string, unknown>\n    types: Record<string, unknown>\n    primaryType: string\n    message: Record<string, unknown>\n  }) => Promise<string>\n  /** Send a signed transaction */\n  sendTransaction: (params: { to: string; value?: bigint; data?: string }) => Promise<string>\n}\n\n/**\n * Convert a T402WDK instance into a facilitator-compatible signer for a given chain.\n *\n * The returned signer can be used with `toFacilitatorEvmSigner()` or directly\n * with a `t402Facilitator` instance for on-chain payment verification and settlement.\n *\n * @param wdk - An initialized T402WDK instance\n * @param chain - Chain name (e.g., \"arbitrum\", \"base\")\n * @param options - Optional configuration\n * @returns A facilitator-compatible signer object\n *\n * @example\n * ```typescript\n * const signer = await toFacilitatorWdkSigner(wdk, 'arbitrum', {\n *   autoSettle: true,\n *   bridgeToMainChain: 'arbitrum',\n * });\n *\n * // Use the signer with the facilitator\n * console.log('Facilitator address:', signer.address);\n * ```\n */\nexport async function toFacilitatorWdkSigner(\n  wdk: T402WDK,\n  chain: string,\n  options?: FacilitatorWdkSignerOptions,\n): Promise<FacilitatorWdkSigner> {\n  // Get the WDK signer for the specified chain\n  const wdkSigner: WDKSigner = await wdk.getSigner(chain)\n  const address = wdkSigner.address\n\n  return {\n    address,\n\n    async signTransaction(tx: unknown): Promise<string> {\n      // For EVM chains, sign typed data if the tx is structured as EIP-712\n      if (tx && typeof tx === 'object' && 'domain' in tx) {\n        const typedData = tx as {\n          domain: Record<string, unknown>\n          types: Record<string, unknown>\n          primaryType: string\n          message: Record<string, unknown>\n        }\n        return wdkSigner.signTypedData(typedData)\n      }\n\n      // For raw message signing, convert to string\n      if (typeof tx === 'string') {\n        return wdkSigner.signMessage(tx)\n      }\n\n      throw new Error('Unsupported transaction format for WDK facilitator signer')\n    },\n\n    async signTypedData(data: {\n      domain: Record<string, unknown>\n      types: Record<string, unknown>\n      primaryType: string\n      message: Record<string, unknown>\n    }): Promise<string> {\n      return wdkSigner.signTypedData(data)\n    },\n\n    async sendTransaction(params: { to: string; value?: bigint; data?: string }): Promise<string> {\n      const result = await wdkSigner.sendTransaction({\n        to: params.to as `0x${string}`,\n        value: params.value,\n        data: params.data,\n      })\n\n      // Auto-bridge if configured\n      if (options?.bridgeToMainChain && options.bridgeToMainChain !== chain) {\n        // Check balance on source chain\n        const balance = await wdk.getUsdt0Balance(chain)\n        if (balance > 0n) {\n          try {\n            await wdk.bridgeUsdt0({\n              fromChain: chain,\n              toChain: options.bridgeToMainChain,\n              amount: balance,\n            })\n          } catch {\n            // Bridge failure is non-fatal for the facilitator\n          }\n        }\n      }\n\n      return result.hash\n    },\n  }\n}\n\n/**\n * Create facilitator signers for all configured WDK chains.\n *\n * @param wdk - An initialized T402WDK instance\n * @param options - Optional configuration applied to all signers\n * @returns Map of chain name to facilitator signer\n *\n * @example\n * ```typescript\n * const signers = await createFacilitatorSigners(wdk, {\n *   bridgeToMainChain: 'arbitrum',\n * });\n *\n * for (const [chain, signer] of signers) {\n *   console.log(`${chain}: ${signer.address}`);\n * }\n * ```\n */\nexport async function createFacilitatorSigners(\n  wdk: T402WDK,\n  options?: FacilitatorWdkSignerOptions,\n): Promise<Map<string, FacilitatorWdkSigner>> {\n  const chains = wdk.getConfiguredChains()\n  const signers = new Map<string, FacilitatorWdkSigner>()\n\n  const results = await Promise.allSettled(\n    chains.map(async (chain) => {\n      const signer = await toFacilitatorWdkSigner(wdk, chain, options)\n      return { chain, signer }\n    }),\n  )\n\n  for (const result of results) {\n    if (result.status === 'fulfilled') {\n      signers.set(result.value.chain, result.value.signer)\n    }\n  }\n\n  return signers\n}\n","/**\n * SIWx + WDK Adapter\n *\n * Wraps a T402WDK wallet as a SIWx (Sign-In-With-X) signer, enabling\n * WDK wallets to sign CAIP-122 authentication messages.\n */\n\nimport type { T402WDK } from '../t402wdk.js'\n\n/**\n * SIWx signer interface, compatible with the SIWxSigner from @t402/extensions.\n */\nexport interface SIWxSigner {\n  /** Wallet address */\n  address: string\n  /** Sign a personal message (EIP-191) */\n  signMessage(message: string): Promise<string>\n  /** Sign EIP-712 typed data */\n  signTypedData(data: {\n    domain: unknown\n    types: unknown\n    primaryType: string\n    message: unknown\n  }): Promise<string>\n}\n\n/**\n * Convert a T402WDK instance into a SIWx-compatible signer for a given chain.\n *\n * The returned signer implements the `SIWxSigner` interface used by\n * `@t402/extensions` for CAIP-122 Sign-In-With-X authentication flows.\n *\n * @param wdk - An initialized T402WDK instance\n * @param chain - Chain name (e.g., \"arbitrum\", \"base\")\n * @returns A SIWx-compatible signer\n *\n * @example\n * ```typescript\n * import { toSIWxSigner } from '@t402/wdk';\n * import { createSIWxPayload, encodeSIWxHeader } from '@t402/extensions';\n *\n * const siwxSigner = await toSIWxSigner(wdk, 'arbitrum');\n *\n * // Create and sign SIWx payload\n * const payload = await createSIWxPayload(serverExtension, siwxSigner);\n * const header = encodeSIWxHeader(payload);\n *\n * // Include in request\n * fetch(url, { headers: { 'X-T402-SIWx': header } });\n * ```\n */\nexport async function toSIWxSigner(wdk: T402WDK, chain: string): Promise<SIWxSigner> {\n  const wdkSigner = await wdk.getSigner(chain)\n\n  return {\n    address: wdkSigner.address,\n\n    async signMessage(message: string): Promise<string> {\n      return wdkSigner.signMessage(message)\n    },\n\n    async signTypedData(data: {\n      domain: unknown\n      types: unknown\n      primaryType: string\n      message: unknown\n    }): Promise<string> {\n      return wdkSigner.signTypedData({\n        domain: data.domain as Record<string, unknown>,\n        types: data.types as Record<string, unknown>,\n        primaryType: data.primaryType,\n        message: data.message as Record<string, unknown>,\n      })\n    },\n  }\n}\n\n/**\n * Create SIWx signers for all configured WDK chains.\n *\n * @param wdk - An initialized T402WDK instance\n * @returns Map of chain name to SIWx signer\n *\n * @example\n * ```typescript\n * const signers = await createSIWxSigners(wdk);\n * const arbSigner = signers.get('arbitrum');\n * ```\n */\nexport async function createSIWxSigners(wdk: T402WDK): Promise<Map<string, SIWxSigner>> {\n  const chains = wdk.getConfiguredChains()\n  const signers = new Map<string, SIWxSigner>()\n\n  const results = await Promise.allSettled(\n    chains.map(async (chain) => {\n      const signer = await toSIWxSigner(wdk, chain)\n      return { chain, signer }\n    }),\n  )\n\n  for (const result of results) {\n    if (result.status === 'fulfilled') {\n      signers.set(result.value.chain, result.value.signer)\n    }\n  }\n\n  return signers\n}\n"],"mappings":"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","names":[]}

package/dist/cjs/testing/index.d.ts

@@ -0,0 +1,62 @@
+import { c as WDKAccount, a as WDKTonAccount, W as WDKSolanaAccount, b as WDKTronAccount, d as WDKInstance } from '../types-BwK8Xgvg.js';
+import 'viem';
+
+/**
+ * Shared test harness for @t402/wdk
+ *
+ * Provides mock factories for WDK accounts, instances, and T402WDK
+ * to simplify testing across the T402 ecosystem.
+ */
+
+/**
+ * Create a mock WDK EVM account with sensible defaults.
+ */
+declare function createMockWDKAccount(overrides?: Partial<WDKAccount>): WDKAccount;
+/**
+ * Create a mock WDK instance that returns the given accounts.
+ */
+declare function createMockWDKInstance(accounts?: Record<string, WDKAccount>): WDKInstance;
+/**
+ * Create a mock TON account.
+ */
+declare function createMockTonAccount(overrides?: Partial<WDKTonAccount>): WDKTonAccount;
+/**
+ * Create a mock Solana account.
+ */
+declare function createMockSolanaAccount(overrides?: Partial<WDKSolanaAccount>): WDKSolanaAccount;
+/**
+ * Create a mock TRON account.
+ */
+declare function createMockTronAccount(overrides?: Partial<WDKTronAccount>): WDKTronAccount;
+/**
+ * Configuration for createMockT402WDK.
+ */
+interface MockT402WDKConfig {
+    /** Chains to configure (default: ['arbitrum']) */
+    chains?: string[];
+    /** Custom EVM account overrides */
+    evmAccount?: Partial<WDKAccount>;
+    /** Custom TON account overrides */
+    tonAccount?: Partial<WDKTonAccount>;
+    /** Custom Solana account overrides */
+    solanaAccount?: Partial<WDKSolanaAccount>;
+    /** Custom TRON account overrides */
+    tronAccount?: Partial<WDKTronAccount>;
+}
+/**
+ * Create a mock T402WDK-like object for testing, returning
+ * the underlying WDK instance and chain configuration.
+ *
+ * This is useful when you need to test code that depends on
+ * T402WDK without importing the full class.
+ */
+declare function createMockT402WDK(config?: MockT402WDKConfig): {
+    wdkInstance: WDKInstance;
+    chainConfig: Record<string, string>;
+    evmAccount: WDKAccount;
+    tonAccount: WDKTonAccount;
+    solanaAccount: WDKSolanaAccount;
+    tronAccount: WDKTronAccount;
+};
+
+export { type MockT402WDKConfig, createMockSolanaAccount, createMockT402WDK, createMockTonAccount, createMockTronAccount, createMockWDKAccount, createMockWDKInstance };

package/dist/cjs/testing/index.js

@@ -0,0 +1,129 @@
+"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/testing/index.ts
+var testing_exports = {};
+__export(testing_exports, {
+  createMockSolanaAccount: () => createMockSolanaAccount,
+  createMockT402WDK: () => createMockT402WDK,
+  createMockTonAccount: () => createMockTonAccount,
+  createMockTronAccount: () => createMockTronAccount,
+  createMockWDKAccount: () => createMockWDKAccount,
+  createMockWDKInstance: () => createMockWDKInstance
+});
+module.exports = __toCommonJS(testing_exports);
+function createMockWDKAccount(overrides) {
+  return {
+    getAddress: async () => "0x1234567890123456789012345678901234567890",
+    getBalance: async () => 1000000000000000000n,
+    getTokenBalance: async () => 1000000n,
+    signMessage: async () => "0xmocksignature",
+    signTypedData: async () => "0xmocktypedsignature",
+    sendTransaction: async () => "0xmocktxhash",
+    estimateGas: async () => 21000n,
+    ...overrides
+  };
+}
+function createMockWDKInstance(accounts) {
+  const defaultAccount = createMockWDKAccount();
+  return {
+    registerWallet: function() {
+      return this;
+    },
+    registerProtocol: function() {
+      return this;
+    },
+    getAccount: async (chain, _index) => {
+      return accounts?.[chain] ?? defaultAccount;
+    },
+    executeProtocol: async () => ({ txHash: "0xmockprotocoltxhash" })
+  };
+}
+function createMockTonAccount(overrides) {
+  return {
+    getAddress: async () => "UQBMock_TON_Address_For_Testing_Purposes_Only_12345",
+    getBalance: async () => 5000000000n,
+    getJettonBalance: async () => 1000000n,
+    signMessage: async () => new Uint8Array(64),
+    sendTransaction: async () => "mock_ton_tx_hash",
+    getSeqno: async () => 1,
+    transferJetton: async () => "mock_jetton_tx_hash",
+    ...overrides
+  };
+}
+function createMockSolanaAccount(overrides) {
+  return {
+    getAddress: async () => "11111111111111111111111111111112",
+    getBalance: async () => 2000000000n,
+    getTokenBalance: async () => 1000000n,
+    sign: async () => new Uint8Array(64),
+    signTransaction: async () => new Uint8Array(128),
+    sendTransaction: async () => "mock_sol_tx_hash",
+    transfer: async () => "mock_spl_tx_hash",
+    ...overrides
+  };
+}
+function createMockTronAccount(overrides) {
+  return {
+    getAddress: async () => "TJMockTronAddress1234567890ABCDEF",
+    getBalance: async () => 10000000n,
+    getTrc20Balance: async () => 1000000n,
+    signTransaction: async (tx) => tx,
+    sendTransaction: async () => "mock_tron_tx_hash",
+    transferTrc20: async () => "mock_trc20_tx_hash",
+    ...overrides
+  };
+}
+function createMockT402WDK(config) {
+  const chains = config?.chains ?? ["arbitrum"];
+  const evmAccount = createMockWDKAccount(config?.evmAccount);
+  const tonAccount = createMockTonAccount(config?.tonAccount);
+  const solanaAccount = createMockSolanaAccount(config?.solanaAccount);
+  const tronAccount = createMockTronAccount(config?.tronAccount);
+  const accountMap = {};
+  for (const chain of chains) {
+    accountMap[chain] = evmAccount;
+  }
+  accountMap["ton"] = tonAccount;
+  accountMap["solana"] = solanaAccount;
+  accountMap["tron"] = tronAccount;
+  const wdkInstance = createMockWDKInstance(accountMap);
+  const chainConfig = {};
+  for (const chain of chains) {
+    chainConfig[chain] = `https://mock-rpc.${chain}.test`;
+  }
+  return {
+    wdkInstance,
+    chainConfig,
+    evmAccount,
+    tonAccount,
+    solanaAccount,
+    tronAccount
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createMockSolanaAccount,
+  createMockT402WDK,
+  createMockTonAccount,
+  createMockTronAccount,
+  createMockWDKAccount,
+  createMockWDKInstance
+});
+//# sourceMappingURL=index.js.map

package/dist/cjs/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/testing/index.ts"],"sourcesContent":["/**\n * Shared test harness for @t402/wdk\n *\n * Provides mock factories for WDK accounts, instances, and T402WDK\n * to simplify testing across the T402 ecosystem.\n */\n\nimport type {\n  WDKAccount,\n  WDKInstance,\n  WDKTonAccount,\n  WDKSolanaAccount,\n  WDKTronAccount,\n} from '../types.js'\n\n/**\n * Create a mock WDK EVM account with sensible defaults.\n */\nexport function createMockWDKAccount(overrides?: Partial<WDKAccount>): WDKAccount {\n  return {\n    getAddress: async () => '0x1234567890123456789012345678901234567890',\n    getBalance: async () => 1000000000000000000n,\n    getTokenBalance: async () => 1000000n,\n    signMessage: async () => '0xmocksignature',\n    signTypedData: async () => '0xmocktypedsignature',\n    sendTransaction: async () => '0xmocktxhash',\n    estimateGas: async () => 21000n,\n    ...overrides,\n  }\n}\n\n/**\n * Create a mock WDK instance that returns the given accounts.\n */\nexport function createMockWDKInstance(accounts?: Record<string, WDKAccount>): WDKInstance {\n  const defaultAccount = createMockWDKAccount()\n  return {\n    registerWallet: function () {\n      return this as WDKInstance\n    },\n    registerProtocol: function () {\n      return this as WDKInstance\n    },\n    getAccount: async (chain: string, _index: number) => {\n      return accounts?.[chain] ?? defaultAccount\n    },\n    executeProtocol: async () => ({ txHash: '0xmockprotocoltxhash' }),\n  }\n}\n\n/**\n * Create a mock TON account.\n */\nexport function createMockTonAccount(overrides?: Partial<WDKTonAccount>): WDKTonAccount {\n  return {\n    getAddress: async () => 'UQBMock_TON_Address_For_Testing_Purposes_Only_12345',\n    getBalance: async () => 5000000000n,\n    getJettonBalance: async () => 1000000n,\n    signMessage: async () => new Uint8Array(64),\n    sendTransaction: async () => 'mock_ton_tx_hash',\n    getSeqno: async () => 1,\n    transferJetton: async () => 'mock_jetton_tx_hash',\n    ...overrides,\n  }\n}\n\n/**\n * Create a mock Solana account.\n */\nexport function createMockSolanaAccount(overrides?: Partial<WDKSolanaAccount>): WDKSolanaAccount {\n  return {\n    getAddress: async () => '11111111111111111111111111111112',\n    getBalance: async () => 2000000000n,\n    getTokenBalance: async () => 1000000n,\n    sign: async () => new Uint8Array(64),\n    signTransaction: async () => new Uint8Array(128),\n    sendTransaction: async () => 'mock_sol_tx_hash',\n    transfer: async () => 'mock_spl_tx_hash',\n    ...overrides,\n  }\n}\n\n/**\n * Create a mock TRON account.\n */\nexport function createMockTronAccount(overrides?: Partial<WDKTronAccount>): WDKTronAccount {\n  return {\n    getAddress: async () => 'TJMockTronAddress1234567890ABCDEF',\n    getBalance: async () => 10000000n,\n    getTrc20Balance: async () => 1000000n,\n    signTransaction: async (tx: unknown) => tx,\n    sendTransaction: async () => 'mock_tron_tx_hash',\n    transferTrc20: async () => 'mock_trc20_tx_hash',\n    ...overrides,\n  }\n}\n\n/**\n * Configuration for createMockT402WDK.\n */\nexport interface MockT402WDKConfig {\n  /** Chains to configure (default: ['arbitrum']) */\n  chains?: string[]\n  /** Custom EVM account overrides */\n  evmAccount?: Partial<WDKAccount>\n  /** Custom TON account overrides */\n  tonAccount?: Partial<WDKTonAccount>\n  /** Custom Solana account overrides */\n  solanaAccount?: Partial<WDKSolanaAccount>\n  /** Custom TRON account overrides */\n  tronAccount?: Partial<WDKTronAccount>\n}\n\n/**\n * Create a mock T402WDK-like object for testing, returning\n * the underlying WDK instance and chain configuration.\n *\n * This is useful when you need to test code that depends on\n * T402WDK without importing the full class.\n */\nexport function createMockT402WDK(config?: MockT402WDKConfig) {\n  const chains = config?.chains ?? ['arbitrum']\n  const evmAccount = createMockWDKAccount(config?.evmAccount)\n  const tonAccount = createMockTonAccount(config?.tonAccount)\n  const solanaAccount = createMockSolanaAccount(config?.solanaAccount)\n  const tronAccount = createMockTronAccount(config?.tronAccount)\n\n  const accountMap: Record<string, WDKAccount> = {}\n  for (const chain of chains) {\n    accountMap[chain] = evmAccount\n  }\n  // Non-EVM accounts returned as WDKAccount (runtime cast in T402WDK)\n  accountMap['ton'] = tonAccount as unknown as WDKAccount\n  accountMap['solana'] = solanaAccount as unknown as WDKAccount\n  accountMap['tron'] = tronAccount as unknown as WDKAccount\n\n  const wdkInstance = createMockWDKInstance(accountMap)\n\n  const chainConfig: Record<string, string> = {}\n  for (const chain of chains) {\n    chainConfig[chain] = `https://mock-rpc.${chain}.test`\n  }\n\n  return {\n    wdkInstance,\n    chainConfig,\n    evmAccount,\n    tonAccount,\n    solanaAccount,\n    tronAccount,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBO,SAAS,qBAAqB,WAA6C;AAChF,SAAO;AAAA,IACL,YAAY,YAAY;AAAA,IACxB,YAAY,YAAY;AAAA,IACxB,iBAAiB,YAAY;AAAA,IAC7B,aAAa,YAAY;AAAA,IACzB,eAAe,YAAY;AAAA,IAC3B,iBAAiB,YAAY;AAAA,IAC7B,aAAa,YAAY;AAAA,IACzB,GAAG;AAAA,EACL;AACF;AAKO,SAAS,sBAAsB,UAAoD;AACxF,QAAM,iBAAiB,qBAAqB;AAC5C,SAAO;AAAA,IACL,gBAAgB,WAAY;AAC1B,aAAO;AAAA,IACT;AAAA,IACA,kBAAkB,WAAY;AAC5B,aAAO;AAAA,IACT;AAAA,IACA,YAAY,OAAO,OAAe,WAAmB;AACnD,aAAO,WAAW,KAAK,KAAK;AAAA,IAC9B;AAAA,IACA,iBAAiB,aAAa,EAAE,QAAQ,uBAAuB;AAAA,EACjE;AACF;AAKO,SAAS,qBAAqB,WAAmD;AACtF,SAAO;AAAA,IACL,YAAY,YAAY;AAAA,IACxB,YAAY,YAAY;AAAA,IACxB,kBAAkB,YAAY;AAAA,IAC9B,aAAa,YAAY,IAAI,WAAW,EAAE;AAAA,IAC1C,iBAAiB,YAAY;AAAA,IAC7B,UAAU,YAAY;AAAA,IACtB,gBAAgB,YAAY;AAAA,IAC5B,GAAG;AAAA,EACL;AACF;AAKO,SAAS,wBAAwB,WAAyD;AAC/F,SAAO;AAAA,IACL,YAAY,YAAY;AAAA,IACxB,YAAY,YAAY;AAAA,IACxB,iBAAiB,YAAY;AAAA,IAC7B,MAAM,YAAY,IAAI,WAAW,EAAE;AAAA,IACnC,iBAAiB,YAAY,IAAI,WAAW,GAAG;AAAA,IAC/C,iBAAiB,YAAY;AAAA,IAC7B,UAAU,YAAY;AAAA,IACtB,GAAG;AAAA,EACL;AACF;AAKO,SAAS,sBAAsB,WAAqD;AACzF,SAAO;AAAA,IACL,YAAY,YAAY;AAAA,IACxB,YAAY,YAAY;AAAA,IACxB,iBAAiB,YAAY;AAAA,IAC7B,iBAAiB,OAAO,OAAgB;AAAA,IACxC,iBAAiB,YAAY;AAAA,IAC7B,eAAe,YAAY;AAAA,IAC3B,GAAG;AAAA,EACL;AACF;AAyBO,SAAS,kBAAkB,QAA4B;AAC5D,QAAM,SAAS,QAAQ,UAAU,CAAC,UAAU;AAC5C,QAAM,aAAa,qBAAqB,QAAQ,UAAU;AAC1D,QAAM,aAAa,qBAAqB,QAAQ,UAAU;AAC1D,QAAM,gBAAgB,wBAAwB,QAAQ,aAAa;AACnE,QAAM,cAAc,sBAAsB,QAAQ,WAAW;AAE7D,QAAM,aAAyC,CAAC;AAChD,aAAW,SAAS,QAAQ;AAC1B,eAAW,KAAK,IAAI;AAAA,EACtB;AAEA,aAAW,KAAK,IAAI;AACpB,aAAW,QAAQ,IAAI;AACvB,aAAW,MAAM,IAAI;AAErB,QAAM,cAAc,sBAAsB,UAAU;AAEpD,QAAM,cAAsC,CAAC;AAC7C,aAAW,SAAS,QAAQ;AAC1B,gBAAY,KAAK,IAAI,oBAAoB,KAAK;AAAA,EAChD;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}