@bosonprotocol/x402-evm 0.1.0-alpha-0

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/adapters/viem-relayer.ts","../../../src/internal/web3lib-stub.ts"],"names":["InsufficientFundsError","ExecutionRevertedError","ContractFunctionRevertedError","RawContractError","BaseError"],"mappings":"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","file":"index.js","sourcesContent":["// Viem-backed `Web3LibAdapter` for relayer / facilitator-style flows where\n// a configured `WalletClient` submits transactions on a buyer's behalf.\n//\n// `@bosonprotocol/core-sdk`'s `MetaTxMixin.executeMetaTransaction(...)`\n// (the unified entrypoint that routes between\n// `executeMetaTransaction` and `executeMetaTransactionWithTokenTransferAuthorization`\n// based on whether `transferAuthorizations` is provided) drives every\n// on-chain side-effect through the SDK's `Web3LibAdapter`. This adapter\n// wraps a viem `WalletClient` (for writes) plus a `PublicClient`\n// (for reads / receipt polling) so the SDK can run end-to-end against\n// viem-configured transports.\n//\n// The sibling `client/src/internal/web3lib-adapter.ts` wraps a sign-only\n// `Signer` for the buyer path; this is the symmetric write-only variant\n// for the relayer path. Future work may consolidate them behind a\n// single factory.\n\nimport type { Web3LibAdapter } from \"@bosonprotocol/common\";\nimport {\n  BaseError,\n  ContractFunctionRevertedError,\n  ExecutionRevertedError,\n  InsufficientFundsError,\n  RawContractError,\n  type PublicClient,\n  type WalletClient,\n} from \"viem\";\n\n/** Tagged error thrown by the adapter when `walletClient.sendTransaction` rejects. */\nexport class RelayerSubmitError extends Error {\n  readonly code: RelayerSubmitErrorCode;\n  constructor(code: RelayerSubmitErrorCode, message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"RelayerSubmitError\";\n    this.code = code;\n  }\n}\n\n/** Stable identifiers callers can map to their own error-code vocabulary. */\nexport type RelayerSubmitErrorCode =\n  | \"INSUFFICIENT_FUNDS_FOR_GAS\"\n  | \"ONCHAIN_REVERT\"\n  | \"INTERNAL_ERROR\";\n\n/** Default deadline for `wait()` when the caller does not override. */\nconst DEFAULT_RECEIPT_TIMEOUT_MS = 60_000;\n\n/**\n * Build the `Web3LibAdapter` that `@bosonprotocol/core-sdk`'s `CoreSDK`\n * accepts for relayer-driven flows.\n *\n * - Writes flow through `walletClient.sendTransaction`; viem errors are\n *   re-thrown as a tagged `RelayerSubmitError` so the caller can keep\n *   precise classification (insufficient gas funds vs. on-chain revert\n *   vs. transport failure).\n * - Reads (`call`, `getBalance`, `estimateGas`, `getTransactionReceipt`)\n *   flow through `publicClient`.\n * - `send` rejects: the relayer never signs typed data through the\n *   adapter (the buyer already signed off-chain).\n *\n * If either client carries a `chain` (viem populates it when the client\n * was built with an explicit chain) the factory cross-checks its id\n * against the supplied `chainId` and rejects mismatches up-front, so a\n * misconfigured pair fails loudly rather than silently targeting the\n * wrong network.\n */\nexport function walletClientToWeb3LibAdapter(params: {\n  walletClient: WalletClient;\n  publicClient: PublicClient;\n  chainId: number;\n  /**\n   * Per-call timeout (ms) passed to `publicClient.waitForTransactionReceipt`\n   * inside the adapter's `wait()` method, so callers that route through\n   * core-sdk's `TransactionResponse.wait()` don't hang indefinitely on a\n   * stalled RPC. Defaults to 60s. Direct callers that drive their own\n   * receipt polling can ignore it.\n   */\n  receiptTimeoutMs?: number;\n}): Web3LibAdapter {\n  const { walletClient, publicClient, chainId } = params;\n  const receiptTimeoutMs = params.receiptTimeoutMs ?? DEFAULT_RECEIPT_TIMEOUT_MS;\n  if (walletClient.chain && walletClient.chain.id !== chainId) {\n    throw new RelayerSubmitError(\n      \"INTERNAL_ERROR\",\n      `walletClient.chain.id (${walletClient.chain.id}) does not match adapter chainId (${chainId})`,\n    );\n  }\n  if (publicClient.chain && publicClient.chain.id !== chainId) {\n    throw new RelayerSubmitError(\n      \"INTERNAL_ERROR\",\n      `publicClient.chain.id (${publicClient.chain.id}) does not match adapter chainId (${chainId})`,\n    );\n  }\n  return {\n    uuid: \"x402-evm:viem-relayer-adapter\",\n    getSignerAddress: async () => {\n      const account = walletClient.account;\n      if (!account) {\n        throw new RelayerSubmitError(\n          \"INTERNAL_ERROR\",\n          \"walletClient has no account; cannot resolve signer address\",\n        );\n      }\n      return account.address;\n    },\n    isSignerContract: async () => false,\n    getChainId: async () => chainId,\n    getBalance: async (addressOrName) => {\n      const balance = await publicClient.getBalance({ address: addressOrName as `0x${string}` });\n      return balance;\n    },\n    estimateGas: async (req) => {\n      const account = walletClient.account;\n      const gas = await publicClient.estimateGas({\n        account: account ?? undefined,\n        to: req.to as `0x${string}` | undefined,\n        data: req.data as `0x${string}` | undefined,\n        value: req.value === undefined ? undefined : BigInt(req.value.toString()),\n      });\n      return gas;\n    },\n    sendTransaction: async (req) => {\n      const account = walletClient.account;\n      if (!account) {\n        throw new RelayerSubmitError(\n          \"INTERNAL_ERROR\",\n          \"walletClient has no account; cannot send transaction\",\n        );\n      }\n      let hash: `0x${string}`;\n      try {\n        hash = await walletClient.sendTransaction({\n          account,\n          chain: walletClient.chain ?? null,\n          to: req.to as `0x${string}` | undefined,\n          data: req.data as `0x${string}` | undefined,\n          value: req.value === undefined ? 0n : BigInt(req.value.toString()),\n        });\n      } catch (e) {\n        throw classifyViemSendError(e);\n      }\n      return {\n        hash,\n        wait: async (confirmations?: number) => {\n          const receipt = await publicClient.waitForTransactionReceipt({\n            hash,\n            confirmations,\n            timeout: receiptTimeoutMs,\n          });\n          return mapReceipt(receipt);\n        },\n      };\n    },\n    call: async (req) => {\n      const result = await publicClient.call({\n        to: req.to as `0x${string}` | undefined,\n        data: req.data as `0x${string}` | undefined,\n      });\n      return result.data ?? \"0x\";\n    },\n    send: async (method) => {\n      throw new RelayerSubmitError(\n        \"INTERNAL_ERROR\",\n        `x402-evm: relayer adapter does not support RPC method '${method}'; the relayer never signs typed data`,\n      );\n    },\n    getTransactionReceipt: async (txHash) => {\n      const receipt = await publicClient.getTransactionReceipt({ hash: txHash as `0x${string}` });\n      return mapReceipt(receipt);\n    },\n    getCurrentTimeMs: async () => Date.now(),\n  };\n}\n\n/**\n * Normalize a viem `TransactionReceipt` into the SDK's `TransactionReceipt`\n * shape from `@bosonprotocol/common`. viem's logs carry extra fields the\n * SDK doesn't reference; we strip them so the adapter returns exactly the\n * shape the contract is typed against (and keep both\n * `sendTransaction().wait()` and `getTransactionReceipt(...)` paths from\n * drifting).\n */\nfunction mapReceipt(receipt: Awaited<ReturnType<PublicClient[\"getTransactionReceipt\"]>>) {\n  return {\n    from: receipt.from,\n    to: receipt.to ?? \"\",\n    status: receipt.status === \"success\" ? 1 : 0,\n    logs: receipt.logs.map((log) => ({ data: log.data, topics: [...log.topics] })),\n    transactionHash: receipt.transactionHash,\n    effectiveGasPrice: receipt.effectiveGasPrice,\n    blockNumber: Number(receipt.blockNumber),\n    gasUsed: receipt.gasUsed,\n  };\n}\n\n/** Classify a viem error thrown by `walletClient.sendTransaction`. */\nexport function classifyViemSendError(e: unknown): RelayerSubmitError {\n  const reason =\n    e instanceof Error ? `sendTransaction failed: ${e.message}` : \"sendTransaction failed\";\n\n  if (hasViemCause(e, InsufficientFundsError)) {\n    return new RelayerSubmitError(\"INSUFFICIENT_FUNDS_FOR_GAS\", reason, { cause: e });\n  }\n  if (\n    hasViemCause(e, ExecutionRevertedError) ||\n    hasViemCause(e, ContractFunctionRevertedError) ||\n    hasViemCause(e, RawContractError)\n  ) {\n    return new RelayerSubmitError(\"ONCHAIN_REVERT\", reason, { cause: e });\n  }\n  return new RelayerSubmitError(\"INTERNAL_ERROR\", reason, { cause: e });\n}\n\nfunction hasViemCause<T extends abstract new (...args: never[]) => Error>(\n  e: unknown,\n  ctor: T,\n): boolean {\n  if (e instanceof ctor) return true;\n  if (!(e instanceof BaseError)) return false;\n  return e.walk((err) => err instanceof ctor) !== null;\n}\n","// Calldata-only `Web3LibAdapter` for the calldata-builder modules.\n//\n// Core-sdk's `signMetaTx` calls `web3Lib.getSignerAddress()` even in\n// `returnTypedDataToSign: true` mode to fill the message's `from` field.\n// We return a deterministic dummy address; the typed-data message is\n// discarded and only `{ functionName, functionSignature }` is consumed.\n//\n// All signing and transaction methods reject so the stub fails loudly if\n// it ever leaks into a path that needs more than typed-data construction.\n\nimport type { Web3LibAdapter } from \"@bosonprotocol/common\";\n\nconst DUMMY_SIGNER_ADDRESS = \"0x0000000000000000000000000000000000000001\";\n\nfunction unreachable(callerTag: string, method: string): Error {\n  return new Error(\n    `${callerTag}: stub Web3LibAdapter.${method}() should never be called. ` +\n      \"If you see this, core-sdk changed its typed-data-only behavior.\",\n  );\n}\n\nexport function createCalldataOnlyWeb3LibAdapter(callerTag: string): Web3LibAdapter {\n  return {\n    uuid: `${callerTag}:stub`,\n    getSignerAddress: () => Promise.resolve(DUMMY_SIGNER_ADDRESS),\n    isSignerContract: () => Promise.resolve(false),\n    getChainId: () => Promise.reject(unreachable(callerTag, \"getChainId\")),\n    getBalance: () => Promise.reject(unreachable(callerTag, \"getBalance\")),\n    estimateGas: () => Promise.reject(unreachable(callerTag, \"estimateGas\")),\n    sendTransaction: () => Promise.reject(unreachable(callerTag, \"sendTransaction\")),\n    call: () => Promise.reject(unreachable(callerTag, \"call\")),\n    send: () => Promise.reject(unreachable(callerTag, \"send\")),\n    getTransactionReceipt: () => Promise.reject(unreachable(callerTag, \"getTransactionReceipt\")),\n    getCurrentTimeMs: () => Promise.reject(unreachable(callerTag, \"getCurrentTimeMs\")),\n  };\n}\n"]}

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

@@ -0,0 +1,8 @@
+import { Hex, BosonMetaTx } from '@bosonprotocol/x402-core/schemes/escrow';
+
+/** Encode a BosonMetaTx as the wire-format Hex for `signedPayload`. */
+declare function encodeSignedPayload(metaTx: BosonMetaTx): Hex;
+/** Decode the wire-format Hex back into a BosonMetaTx. */
+declare function decodeSignedPayload(signedPayload: Hex): BosonMetaTx;
+
+export { decodeSignedPayload, encodeSignedPayload };

package/dist/cjs/codec/index.js

@@ -0,0 +1,43 @@
+'use strict';
+
+var viem = require('viem');
+
+// src/codec/signed-payload.ts
+var SIGNED_PAYLOAD_ABI = [
+  { name: "from", type: "address" },
+  { name: "functionName", type: "string" },
+  { name: "functionSignature", type: "bytes" },
+  { name: "nonce", type: "uint256" },
+  { name: "v", type: "uint8" },
+  { name: "r", type: "bytes32" },
+  { name: "s", type: "bytes32" }
+];
+function encodeSignedPayload(metaTx) {
+  return viem.encodeAbiParameters(SIGNED_PAYLOAD_ABI, [
+    metaTx.from,
+    metaTx.functionName,
+    metaTx.functionSignature,
+    BigInt(metaTx.nonce),
+    metaTx.sig.v,
+    metaTx.sig.r,
+    metaTx.sig.s
+  ]);
+}
+function decodeSignedPayload(signedPayload) {
+  const [from, functionName, functionSignature, nonce, v, r, s] = viem.decodeAbiParameters(
+    SIGNED_PAYLOAD_ABI,
+    signedPayload
+  );
+  return {
+    from,
+    functionName,
+    functionSignature,
+    nonce: nonce.toString(),
+    sig: { v: Number(v), r, s }
+  };
+}
+
+exports.decodeSignedPayload = decodeSignedPayload;
+exports.encodeSignedPayload = encodeSignedPayload;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/codec/signed-payload.ts"],"names":["encodeAbiParameters","decodeAbiParameters"],"mappings":";;;;;AAaA,IAAM,kBAAA,GAA8C;AAAA,EAClD,EAAE,IAAA,EAAM,MAAA,EAAQ,IAAA,EAAM,SAAA,EAAU;AAAA,EAChC,EAAE,IAAA,EAAM,cAAA,EAAgB,IAAA,EAAM,QAAA,EAAS;AAAA,EACvC,EAAE,IAAA,EAAM,mBAAA,EAAqB,IAAA,EAAM,OAAA,EAAQ;AAAA,EAC3C,EAAE,IAAA,EAAM,OAAA,EAAS,IAAA,EAAM,SAAA,EAAU;AAAA,EACjC,EAAE,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,OAAA,EAAQ;AAAA,EAC3B,EAAE,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,SAAA,EAAU;AAAA,EAC7B,EAAE,IAAA,EAAM,GAAA,EAAK,IAAA,EAAM,SAAA;AACrB,CAAA;AAGO,SAAS,oBAAoB,MAAA,EAA0B;AAC5D,EAAA,OAAOA,yBAAoB,kBAAA,EAAoB;AAAA,IAC7C,MAAA,CAAO,IAAA;AAAA,IACP,MAAA,CAAO,YAAA;AAAA,IACP,MAAA,CAAO,iBAAA;AAAA,IACP,MAAA,CAAO,OAAO,KAAK,CAAA;AAAA,IACnB,OAAO,GAAA,CAAI,CAAA;AAAA,IACX,OAAO,GAAA,CAAI,CAAA;AAAA,IACX,OAAO,GAAA,CAAI;AAAA,GACZ,CAAA;AACH;AAGO,SAAS,oBAAoB,aAAA,EAAiC;AACnE,EAAA,MAAM,CAAC,MAAM,YAAA,EAAc,iBAAA,EAAmB,OAAO,CAAA,EAAG,CAAA,EAAG,CAAC,CAAA,GAAIC,wBAAA;AAAA,IAC9D,kBAAA;AAAA,IACA;AAAA,GACF;AACA,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,YAAA;AAAA,IACA,iBAAA;AAAA,IACA,KAAA,EAAO,MAAM,QAAA,EAAS;AAAA,IACtB,KAAK,EAAE,CAAA,EAAG,OAAO,CAAC,CAAA,EAAG,GAAG,CAAA;AAAE,GAC5B;AACF","file":"index.js","sourcesContent":["// Wire-format codec for the post-commit `signedPayload` Hex.\n//\n// The signed-payload Hex is the ABI-encoded tuple\n//   (address from, string functionName, bytes functionSignature,\n//    uint256 nonce, uint8 v, bytes32 r, bytes32 s)\n// — i.e. a serialised `BosonMetaTx` ready to be unpacked and wrapped in\n// `MetaTransactionsHandlerFacet.executeMetaTransaction(...)`. It lives\n// here so the buyer's client (encoding) and the facilitator (decoding)\n// share one definition and cannot drift.\n\nimport type { BosonMetaTx, Hex } from \"@bosonprotocol/x402-core/schemes/escrow\";\nimport { decodeAbiParameters, encodeAbiParameters, type AbiParameter } from \"viem\";\n\nconst SIGNED_PAYLOAD_ABI: readonly AbiParameter[] = [\n  { name: \"from\", type: \"address\" },\n  { name: \"functionName\", type: \"string\" },\n  { name: \"functionSignature\", type: \"bytes\" },\n  { name: \"nonce\", type: \"uint256\" },\n  { name: \"v\", type: \"uint8\" },\n  { name: \"r\", type: \"bytes32\" },\n  { name: \"s\", type: \"bytes32\" },\n] as const;\n\n/** Encode a BosonMetaTx as the wire-format Hex for `signedPayload`. */\nexport function encodeSignedPayload(metaTx: BosonMetaTx): Hex {\n  return encodeAbiParameters(SIGNED_PAYLOAD_ABI, [\n    metaTx.from as `0x${string}`,\n    metaTx.functionName,\n    metaTx.functionSignature as `0x${string}`,\n    BigInt(metaTx.nonce),\n    metaTx.sig.v,\n    metaTx.sig.r as `0x${string}`,\n    metaTx.sig.s as `0x${string}`,\n  ]);\n}\n\n/** Decode the wire-format Hex back into a BosonMetaTx. */\nexport function decodeSignedPayload(signedPayload: Hex): BosonMetaTx {\n  const [from, functionName, functionSignature, nonce, v, r, s] = decodeAbiParameters(\n    SIGNED_PAYLOAD_ABI,\n    signedPayload as `0x${string}`,\n  ) as [`0x${string}`, string, `0x${string}`, bigint, number, `0x${string}`, `0x${string}`];\n  return {\n    from,\n    functionName,\n    functionSignature,\n    nonce: nonce.toString(),\n    sig: { v: Number(v), r, s },\n  };\n}\n"]}

package/dist/cjs/index.d.ts

@@ -0,0 +1,6 @@
+export { BuildCreateOfferAndCommitCalldataArgs, BuildCreateOfferCommitAndRedeemCalldataArgs, InnerActionCalldata, TxRequest, buildCreateOfferAndCommitCalldata, buildCreateOfferCommitAndRedeemCalldata } from './actions/index.js';
+export { decodeSignedPayload, encodeSignedPayload } from './codec/index.js';
+export { RelayerSubmitError, RelayerSubmitErrorCode, classifyViemSendError, createCalldataOnlyWeb3LibAdapter, walletClientToWeb3LibAdapter } from './adapters/index.js';
+import 'viem';
+import '@bosonprotocol/common';
+import '@bosonprotocol/x402-core/schemes/escrow';

package/dist/cjs/index.js

@@ -0,0 +1,240 @@
+'use strict';
+
+var coreSdk = require('@bosonprotocol/core-sdk');
+var viem = require('viem');
+
+// src/actions/create-offer-and-commit.ts
+
+// src/internal/metatx-calldata-constants.ts
+var DUMMY_CHAIN_ID = 1;
+var DUMMY_METATX_HANDLER_ADDRESS = "0x0000000000000000000000000000000000000000";
+var DUMMY_NONCE = "0";
+
+// src/internal/web3lib-stub.ts
+var DUMMY_SIGNER_ADDRESS = "0x0000000000000000000000000000000000000001";
+function unreachable(callerTag, method) {
+  return new Error(
+    `${callerTag}: stub Web3LibAdapter.${method}() should never be called. If you see this, core-sdk changed its typed-data-only behavior.`
+  );
+}
+function createCalldataOnlyWeb3LibAdapter(callerTag) {
+  return {
+    uuid: `${callerTag}:stub`,
+    getSignerAddress: () => Promise.resolve(DUMMY_SIGNER_ADDRESS),
+    isSignerContract: () => Promise.resolve(false),
+    getChainId: () => Promise.reject(unreachable(callerTag, "getChainId")),
+    getBalance: () => Promise.reject(unreachable(callerTag, "getBalance")),
+    estimateGas: () => Promise.reject(unreachable(callerTag, "estimateGas")),
+    sendTransaction: () => Promise.reject(unreachable(callerTag, "sendTransaction")),
+    call: () => Promise.reject(unreachable(callerTag, "call")),
+    send: () => Promise.reject(unreachable(callerTag, "send")),
+    getTransactionReceipt: () => Promise.reject(unreachable(callerTag, "getTransactionReceipt")),
+    getCurrentTimeMs: () => Promise.reject(unreachable(callerTag, "getCurrentTimeMs"))
+  };
+}
+
+// src/actions/create-offer-and-commit.ts
+var STUB_CALLER_TAG = "@bosonprotocol/x402-evm:create-offer-and-commit";
+async function buildCreateOfferAndCommitCalldata(args) {
+  const result = await coreSdk.metaTx.handler.signMetaTxCreateOfferAndCommit({
+    web3Lib: createCalldataOnlyWeb3LibAdapter(STUB_CALLER_TAG),
+    metaTxHandlerAddress: DUMMY_METATX_HANDLER_ADDRESS,
+    chainId: DUMMY_CHAIN_ID,
+    nonce: DUMMY_NONCE,
+    createOfferAndCommitArgs: args.fullOffer,
+    returnTypedDataToSign: true
+  });
+  return {
+    functionName: result.functionName,
+    functionSignature: result.functionSignature
+  };
+}
+var STUB_CALLER_TAG2 = "@bosonprotocol/x402-evm:create-offer-commit-and-redeem";
+async function buildCreateOfferCommitAndRedeemCalldata(args) {
+  const result = await coreSdk.metaTx.handler.signMetaTxCreateOfferCommitAndRedeem({
+    web3Lib: createCalldataOnlyWeb3LibAdapter(STUB_CALLER_TAG2),
+    metaTxHandlerAddress: DUMMY_METATX_HANDLER_ADDRESS,
+    chainId: DUMMY_CHAIN_ID,
+    nonce: DUMMY_NONCE,
+    createOfferAndCommitArgs: args.fullOffer,
+    returnTypedDataToSign: true
+  });
+  return {
+    functionName: result.functionName,
+    functionSignature: result.functionSignature
+  };
+}
+var SIGNED_PAYLOAD_ABI = [
+  { name: "from", type: "address" },
+  { name: "functionName", type: "string" },
+  { name: "functionSignature", type: "bytes" },
+  { name: "nonce", type: "uint256" },
+  { name: "v", type: "uint8" },
+  { name: "r", type: "bytes32" },
+  { name: "s", type: "bytes32" }
+];
+function encodeSignedPayload(metaTx3) {
+  return viem.encodeAbiParameters(SIGNED_PAYLOAD_ABI, [
+    metaTx3.from,
+    metaTx3.functionName,
+    metaTx3.functionSignature,
+    BigInt(metaTx3.nonce),
+    metaTx3.sig.v,
+    metaTx3.sig.r,
+    metaTx3.sig.s
+  ]);
+}
+function decodeSignedPayload(signedPayload) {
+  const [from, functionName, functionSignature, nonce, v, r, s] = viem.decodeAbiParameters(
+    SIGNED_PAYLOAD_ABI,
+    signedPayload
+  );
+  return {
+    from,
+    functionName,
+    functionSignature,
+    nonce: nonce.toString(),
+    sig: { v: Number(v), r, s }
+  };
+}
+var RelayerSubmitError = class extends Error {
+  constructor(code, message, options) {
+    super(message, options);
+    this.name = "RelayerSubmitError";
+    this.code = code;
+  }
+};
+var DEFAULT_RECEIPT_TIMEOUT_MS = 6e4;
+function walletClientToWeb3LibAdapter(params) {
+  const { walletClient, publicClient, chainId } = params;
+  const receiptTimeoutMs = params.receiptTimeoutMs ?? DEFAULT_RECEIPT_TIMEOUT_MS;
+  if (walletClient.chain && walletClient.chain.id !== chainId) {
+    throw new RelayerSubmitError(
+      "INTERNAL_ERROR",
+      `walletClient.chain.id (${walletClient.chain.id}) does not match adapter chainId (${chainId})`
+    );
+  }
+  if (publicClient.chain && publicClient.chain.id !== chainId) {
+    throw new RelayerSubmitError(
+      "INTERNAL_ERROR",
+      `publicClient.chain.id (${publicClient.chain.id}) does not match adapter chainId (${chainId})`
+    );
+  }
+  return {
+    uuid: "x402-evm:viem-relayer-adapter",
+    getSignerAddress: async () => {
+      const account = walletClient.account;
+      if (!account) {
+        throw new RelayerSubmitError(
+          "INTERNAL_ERROR",
+          "walletClient has no account; cannot resolve signer address"
+        );
+      }
+      return account.address;
+    },
+    isSignerContract: async () => false,
+    getChainId: async () => chainId,
+    getBalance: async (addressOrName) => {
+      const balance = await publicClient.getBalance({ address: addressOrName });
+      return balance;
+    },
+    estimateGas: async (req) => {
+      const account = walletClient.account;
+      const gas = await publicClient.estimateGas({
+        account: account ?? void 0,
+        to: req.to,
+        data: req.data,
+        value: req.value === void 0 ? void 0 : BigInt(req.value.toString())
+      });
+      return gas;
+    },
+    sendTransaction: async (req) => {
+      const account = walletClient.account;
+      if (!account) {
+        throw new RelayerSubmitError(
+          "INTERNAL_ERROR",
+          "walletClient has no account; cannot send transaction"
+        );
+      }
+      let hash;
+      try {
+        hash = await walletClient.sendTransaction({
+          account,
+          chain: walletClient.chain ?? null,
+          to: req.to,
+          data: req.data,
+          value: req.value === void 0 ? 0n : BigInt(req.value.toString())
+        });
+      } catch (e) {
+        throw classifyViemSendError(e);
+      }
+      return {
+        hash,
+        wait: async (confirmations) => {
+          const receipt = await publicClient.waitForTransactionReceipt({
+            hash,
+            confirmations,
+            timeout: receiptTimeoutMs
+          });
+          return mapReceipt(receipt);
+        }
+      };
+    },
+    call: async (req) => {
+      const result = await publicClient.call({
+        to: req.to,
+        data: req.data
+      });
+      return result.data ?? "0x";
+    },
+    send: async (method) => {
+      throw new RelayerSubmitError(
+        "INTERNAL_ERROR",
+        `x402-evm: relayer adapter does not support RPC method '${method}'; the relayer never signs typed data`
+      );
+    },
+    getTransactionReceipt: async (txHash) => {
+      const receipt = await publicClient.getTransactionReceipt({ hash: txHash });
+      return mapReceipt(receipt);
+    },
+    getCurrentTimeMs: async () => Date.now()
+  };
+}
+function mapReceipt(receipt) {
+  return {
+    from: receipt.from,
+    to: receipt.to ?? "",
+    status: receipt.status === "success" ? 1 : 0,
+    logs: receipt.logs.map((log) => ({ data: log.data, topics: [...log.topics] })),
+    transactionHash: receipt.transactionHash,
+    effectiveGasPrice: receipt.effectiveGasPrice,
+    blockNumber: Number(receipt.blockNumber),
+    gasUsed: receipt.gasUsed
+  };
+}
+function classifyViemSendError(e) {
+  const reason = e instanceof Error ? `sendTransaction failed: ${e.message}` : "sendTransaction failed";
+  if (hasViemCause(e, viem.InsufficientFundsError)) {
+    return new RelayerSubmitError("INSUFFICIENT_FUNDS_FOR_GAS", reason, { cause: e });
+  }
+  if (hasViemCause(e, viem.ExecutionRevertedError) || hasViemCause(e, viem.ContractFunctionRevertedError) || hasViemCause(e, viem.RawContractError)) {
+    return new RelayerSubmitError("ONCHAIN_REVERT", reason, { cause: e });
+  }
+  return new RelayerSubmitError("INTERNAL_ERROR", reason, { cause: e });
+}
+function hasViemCause(e, ctor) {
+  if (e instanceof ctor) return true;
+  if (!(e instanceof viem.BaseError)) return false;
+  return e.walk((err) => err instanceof ctor) !== null;
+}
+
+exports.RelayerSubmitError = RelayerSubmitError;
+exports.buildCreateOfferAndCommitCalldata = buildCreateOfferAndCommitCalldata;
+exports.buildCreateOfferCommitAndRedeemCalldata = buildCreateOfferCommitAndRedeemCalldata;
+exports.classifyViemSendError = classifyViemSendError;
+exports.createCalldataOnlyWeb3LibAdapter = createCalldataOnlyWeb3LibAdapter;
+exports.decodeSignedPayload = decodeSignedPayload;
+exports.encodeSignedPayload = encodeSignedPayload;
+exports.walletClientToWeb3LibAdapter = walletClientToWeb3LibAdapter;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/metatx-calldata-constants.ts","../../src/internal/web3lib-stub.ts","../../src/actions/create-offer-and-commit.ts","../../src/actions/create-offer-commit-and-redeem.ts","../../src/codec/signed-payload.ts","../../src/adapters/viem-relayer.ts"],"names":["metaTx","STUB_CALLER_TAG","encodeAbiParameters","decodeAbiParameters","InsufficientFundsError","ExecutionRevertedError","ContractFunctionRevertedError","RawContractError","BaseError"],"mappings":"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","file":"index.js","sourcesContent":["// Placeholder values for the meta-tx fields the SDK's `signMetaTx*` helpers\n// require but the calldata-builder modules don't care about.\n//\n// The builders delegate the `{ functionName, functionSignature }` pair to\n// `metaTx.handler.signMetaTx*({ returnTypedDataToSign: true })`. The SDK\n// requires `chainId`, `metaTxHandlerAddress`, and `nonce` to build the\n// meta-tx typed-data domain, but those affect only the typed-data portion\n// of the response; the selector literal and ABI-encoded calldata we read\n// back are independent of all three.\n\nexport const DUMMY_CHAIN_ID = 1;\nexport const DUMMY_METATX_HANDLER_ADDRESS = \"0x0000000000000000000000000000000000000000\";\nexport const DUMMY_NONCE = \"0\";\n","// Calldata-only `Web3LibAdapter` for the calldata-builder modules.\n//\n// Core-sdk's `signMetaTx` calls `web3Lib.getSignerAddress()` even in\n// `returnTypedDataToSign: true` mode to fill the message's `from` field.\n// We return a deterministic dummy address; the typed-data message is\n// discarded and only `{ functionName, functionSignature }` is consumed.\n//\n// All signing and transaction methods reject so the stub fails loudly if\n// it ever leaks into a path that needs more than typed-data construction.\n\nimport type { Web3LibAdapter } from \"@bosonprotocol/common\";\n\nconst DUMMY_SIGNER_ADDRESS = \"0x0000000000000000000000000000000000000001\";\n\nfunction unreachable(callerTag: string, method: string): Error {\n  return new Error(\n    `${callerTag}: stub Web3LibAdapter.${method}() should never be called. ` +\n      \"If you see this, core-sdk changed its typed-data-only behavior.\",\n  );\n}\n\nexport function createCalldataOnlyWeb3LibAdapter(callerTag: string): Web3LibAdapter {\n  return {\n    uuid: `${callerTag}:stub`,\n    getSignerAddress: () => Promise.resolve(DUMMY_SIGNER_ADDRESS),\n    isSignerContract: () => Promise.resolve(false),\n    getChainId: () => Promise.reject(unreachable(callerTag, \"getChainId\")),\n    getBalance: () => Promise.reject(unreachable(callerTag, \"getBalance\")),\n    estimateGas: () => Promise.reject(unreachable(callerTag, \"estimateGas\")),\n    sendTransaction: () => Promise.reject(unreachable(callerTag, \"sendTransaction\")),\n    call: () => Promise.reject(unreachable(callerTag, \"call\")),\n    send: () => Promise.reject(unreachable(callerTag, \"send\")),\n    getTransactionReceipt: () => Promise.reject(unreachable(callerTag, \"getTransactionReceipt\")),\n    getCurrentTimeMs: () => Promise.reject(unreachable(callerTag, \"getCurrentTimeMs\")),\n  };\n}\n","// Calldata builder for `ExchangeCommitFacet.createOfferAndCommit` —\n// the \"deferred-redemption\" Boson action (Flow A in\n// docs/boson-impl-02-flows.md).\n//\n// Returns the `{ functionName, functionSignature }` pair the buyer's\n// meta-tx typed-data is built over — same pair the on-chain\n// `MetaTransactionsHandlerFacet` recovers signatures against.\n//\n// Implementation note: rather than hand-pin the `functionName` selector\n// string and call `exchanges.iface.encodeCreateOfferAndCommit` here\n// directly, we delegate the whole pair to\n// `@bosonprotocol/core-sdk`'s `metaTx.handler.signMetaTxCreateOfferAndCommit`\n// in `returnTypedDataToSign: true` mode. That's the same helper the\n// client uses to sign, so signing and verification source the\n// `functionName` literal + `functionSignature` bytes from one place.\n// If a future SDK release changes either, both paths track the change\n// automatically.\n\nimport type { FullOfferArgs } from \"@bosonprotocol/common\";\nimport { metaTx } from \"@bosonprotocol/core-sdk\";\nimport type { Hex } from \"viem\";\n\nimport {\n  DUMMY_CHAIN_ID,\n  DUMMY_METATX_HANDLER_ADDRESS,\n  DUMMY_NONCE,\n} from \"../internal/metatx-calldata-constants.js\";\nimport { createCalldataOnlyWeb3LibAdapter } from \"../internal/web3lib-stub.js\";\nimport type { InnerActionCalldata } from \"../types.js\";\n\nexport interface BuildCreateOfferAndCommitCalldataArgs {\n  /**\n   * Full BPIP-10 offer payload, identical in shape to what core-sdk's\n   * `exchanges.iface.encodeCreateOfferAndCommit` accepts. The seller's\n   * `signature` field is embedded inside this struct and is verified\n   * on-chain by `verifyOffer`.\n   */\n  fullOffer: FullOfferArgs;\n}\n\nconst STUB_CALLER_TAG = \"@bosonprotocol/x402-evm:create-offer-and-commit\";\n\n/**\n * Build the `{ functionName, functionSignature }` calldata pair for the\n * `createOfferAndCommit` inner action. The result feeds\n * `@bosonprotocol/x402-core/eip712`'s `metaTransactionTypedData`\n * builder to produce the EIP-712 typed-data the buyer signs.\n */\nexport async function buildCreateOfferAndCommitCalldata(\n  args: BuildCreateOfferAndCommitCalldataArgs,\n): Promise<InnerActionCalldata> {\n  const result = await metaTx.handler.signMetaTxCreateOfferAndCommit({\n    web3Lib: createCalldataOnlyWeb3LibAdapter(STUB_CALLER_TAG),\n    metaTxHandlerAddress: DUMMY_METATX_HANDLER_ADDRESS,\n    chainId: DUMMY_CHAIN_ID,\n    nonce: DUMMY_NONCE,\n    createOfferAndCommitArgs: args.fullOffer,\n    returnTypedDataToSign: true,\n  });\n\n  return {\n    functionName: result.functionName,\n    functionSignature: result.functionSignature as Hex,\n  };\n}\n","// Calldata builder for `OrchestrationHandlerFacet2.createOfferCommitAndRedeem` —\n// the atomic \"create offer + commit + redeem\" Boson action (Flow B in\n// docs/boson-impl-02-flows.md).\n//\n// Same delegation pattern as `./create-offer-and-commit.ts`: rather than\n// hand-pin the `functionName` selector here, we route the whole\n// `{ functionName, functionSignature }` pair through\n// `@bosonprotocol/core-sdk`'s `metaTx.handler.signMetaTxCreateOfferCommitAndRedeem`\n// in `returnTypedDataToSign: true` mode. That's the same helper the\n// client uses to sign, so signing and verification share one source of\n// truth.\n//\n// Note: the function-argument arity differs from `createOfferAndCommit`\n// (this variant takes `(fullOfferStruct, address offerCreator, bytes\n// sellerSig, uint256 conditionalTokenId)` rather than the\n// deferred-redeem path's longer signature).\n\nimport type { FullOfferArgs } from \"@bosonprotocol/common\";\nimport { metaTx } from \"@bosonprotocol/core-sdk\";\nimport type { Hex } from \"viem\";\n\nimport {\n  DUMMY_CHAIN_ID,\n  DUMMY_METATX_HANDLER_ADDRESS,\n  DUMMY_NONCE,\n} from \"../internal/metatx-calldata-constants.js\";\nimport { createCalldataOnlyWeb3LibAdapter } from \"../internal/web3lib-stub.js\";\nimport type { InnerActionCalldata } from \"../types.js\";\n\nexport interface BuildCreateOfferCommitAndRedeemCalldataArgs {\n  /**\n   * Full BPIP-10 offer payload, identical in shape to what core-sdk's\n   * `orchestration.iface.encodeCreateOfferCommitAndRedeem` accepts. The\n   * seller's `signature` field is embedded inside this struct and is\n   * verified on-chain by `verifyOffer`.\n   */\n  fullOffer: FullOfferArgs;\n}\n\nconst STUB_CALLER_TAG = \"@bosonprotocol/x402-evm:create-offer-commit-and-redeem\";\n\n/**\n * Build the `{ functionName, functionSignature }` calldata pair for the\n * `createOfferCommitAndRedeem` inner action.\n */\nexport async function buildCreateOfferCommitAndRedeemCalldata(\n  args: BuildCreateOfferCommitAndRedeemCalldataArgs,\n): Promise<InnerActionCalldata> {\n  const result = await metaTx.handler.signMetaTxCreateOfferCommitAndRedeem({\n    web3Lib: createCalldataOnlyWeb3LibAdapter(STUB_CALLER_TAG),\n    metaTxHandlerAddress: DUMMY_METATX_HANDLER_ADDRESS,\n    chainId: DUMMY_CHAIN_ID,\n    nonce: DUMMY_NONCE,\n    createOfferAndCommitArgs: args.fullOffer,\n    returnTypedDataToSign: true,\n  });\n\n  return {\n    functionName: result.functionName,\n    functionSignature: result.functionSignature as Hex,\n  };\n}\n","// Wire-format codec for the post-commit `signedPayload` Hex.\n//\n// The signed-payload Hex is the ABI-encoded tuple\n//   (address from, string functionName, bytes functionSignature,\n//    uint256 nonce, uint8 v, bytes32 r, bytes32 s)\n// — i.e. a serialised `BosonMetaTx` ready to be unpacked and wrapped in\n// `MetaTransactionsHandlerFacet.executeMetaTransaction(...)`. It lives\n// here so the buyer's client (encoding) and the facilitator (decoding)\n// share one definition and cannot drift.\n\nimport type { BosonMetaTx, Hex } from \"@bosonprotocol/x402-core/schemes/escrow\";\nimport { decodeAbiParameters, encodeAbiParameters, type AbiParameter } from \"viem\";\n\nconst SIGNED_PAYLOAD_ABI: readonly AbiParameter[] = [\n  { name: \"from\", type: \"address\" },\n  { name: \"functionName\", type: \"string\" },\n  { name: \"functionSignature\", type: \"bytes\" },\n  { name: \"nonce\", type: \"uint256\" },\n  { name: \"v\", type: \"uint8\" },\n  { name: \"r\", type: \"bytes32\" },\n  { name: \"s\", type: \"bytes32\" },\n] as const;\n\n/** Encode a BosonMetaTx as the wire-format Hex for `signedPayload`. */\nexport function encodeSignedPayload(metaTx: BosonMetaTx): Hex {\n  return encodeAbiParameters(SIGNED_PAYLOAD_ABI, [\n    metaTx.from as `0x${string}`,\n    metaTx.functionName,\n    metaTx.functionSignature as `0x${string}`,\n    BigInt(metaTx.nonce),\n    metaTx.sig.v,\n    metaTx.sig.r as `0x${string}`,\n    metaTx.sig.s as `0x${string}`,\n  ]);\n}\n\n/** Decode the wire-format Hex back into a BosonMetaTx. */\nexport function decodeSignedPayload(signedPayload: Hex): BosonMetaTx {\n  const [from, functionName, functionSignature, nonce, v, r, s] = decodeAbiParameters(\n    SIGNED_PAYLOAD_ABI,\n    signedPayload as `0x${string}`,\n  ) as [`0x${string}`, string, `0x${string}`, bigint, number, `0x${string}`, `0x${string}`];\n  return {\n    from,\n    functionName,\n    functionSignature,\n    nonce: nonce.toString(),\n    sig: { v: Number(v), r, s },\n  };\n}\n","// Viem-backed `Web3LibAdapter` for relayer / facilitator-style flows where\n// a configured `WalletClient` submits transactions on a buyer's behalf.\n//\n// `@bosonprotocol/core-sdk`'s `MetaTxMixin.executeMetaTransaction(...)`\n// (the unified entrypoint that routes between\n// `executeMetaTransaction` and `executeMetaTransactionWithTokenTransferAuthorization`\n// based on whether `transferAuthorizations` is provided) drives every\n// on-chain side-effect through the SDK's `Web3LibAdapter`. This adapter\n// wraps a viem `WalletClient` (for writes) plus a `PublicClient`\n// (for reads / receipt polling) so the SDK can run end-to-end against\n// viem-configured transports.\n//\n// The sibling `client/src/internal/web3lib-adapter.ts` wraps a sign-only\n// `Signer` for the buyer path; this is the symmetric write-only variant\n// for the relayer path. Future work may consolidate them behind a\n// single factory.\n\nimport type { Web3LibAdapter } from \"@bosonprotocol/common\";\nimport {\n  BaseError,\n  ContractFunctionRevertedError,\n  ExecutionRevertedError,\n  InsufficientFundsError,\n  RawContractError,\n  type PublicClient,\n  type WalletClient,\n} from \"viem\";\n\n/** Tagged error thrown by the adapter when `walletClient.sendTransaction` rejects. */\nexport class RelayerSubmitError extends Error {\n  readonly code: RelayerSubmitErrorCode;\n  constructor(code: RelayerSubmitErrorCode, message: string, options?: { cause?: unknown }) {\n    super(message, options);\n    this.name = \"RelayerSubmitError\";\n    this.code = code;\n  }\n}\n\n/** Stable identifiers callers can map to their own error-code vocabulary. */\nexport type RelayerSubmitErrorCode =\n  | \"INSUFFICIENT_FUNDS_FOR_GAS\"\n  | \"ONCHAIN_REVERT\"\n  | \"INTERNAL_ERROR\";\n\n/** Default deadline for `wait()` when the caller does not override. */\nconst DEFAULT_RECEIPT_TIMEOUT_MS = 60_000;\n\n/**\n * Build the `Web3LibAdapter` that `@bosonprotocol/core-sdk`'s `CoreSDK`\n * accepts for relayer-driven flows.\n *\n * - Writes flow through `walletClient.sendTransaction`; viem errors are\n *   re-thrown as a tagged `RelayerSubmitError` so the caller can keep\n *   precise classification (insufficient gas funds vs. on-chain revert\n *   vs. transport failure).\n * - Reads (`call`, `getBalance`, `estimateGas`, `getTransactionReceipt`)\n *   flow through `publicClient`.\n * - `send` rejects: the relayer never signs typed data through the\n *   adapter (the buyer already signed off-chain).\n *\n * If either client carries a `chain` (viem populates it when the client\n * was built with an explicit chain) the factory cross-checks its id\n * against the supplied `chainId` and rejects mismatches up-front, so a\n * misconfigured pair fails loudly rather than silently targeting the\n * wrong network.\n */\nexport function walletClientToWeb3LibAdapter(params: {\n  walletClient: WalletClient;\n  publicClient: PublicClient;\n  chainId: number;\n  /**\n   * Per-call timeout (ms) passed to `publicClient.waitForTransactionReceipt`\n   * inside the adapter's `wait()` method, so callers that route through\n   * core-sdk's `TransactionResponse.wait()` don't hang indefinitely on a\n   * stalled RPC. Defaults to 60s. Direct callers that drive their own\n   * receipt polling can ignore it.\n   */\n  receiptTimeoutMs?: number;\n}): Web3LibAdapter {\n  const { walletClient, publicClient, chainId } = params;\n  const receiptTimeoutMs = params.receiptTimeoutMs ?? DEFAULT_RECEIPT_TIMEOUT_MS;\n  if (walletClient.chain && walletClient.chain.id !== chainId) {\n    throw new RelayerSubmitError(\n      \"INTERNAL_ERROR\",\n      `walletClient.chain.id (${walletClient.chain.id}) does not match adapter chainId (${chainId})`,\n    );\n  }\n  if (publicClient.chain && publicClient.chain.id !== chainId) {\n    throw new RelayerSubmitError(\n      \"INTERNAL_ERROR\",\n      `publicClient.chain.id (${publicClient.chain.id}) does not match adapter chainId (${chainId})`,\n    );\n  }\n  return {\n    uuid: \"x402-evm:viem-relayer-adapter\",\n    getSignerAddress: async () => {\n      const account = walletClient.account;\n      if (!account) {\n        throw new RelayerSubmitError(\n          \"INTERNAL_ERROR\",\n          \"walletClient has no account; cannot resolve signer address\",\n        );\n      }\n      return account.address;\n    },\n    isSignerContract: async () => false,\n    getChainId: async () => chainId,\n    getBalance: async (addressOrName) => {\n      const balance = await publicClient.getBalance({ address: addressOrName as `0x${string}` });\n      return balance;\n    },\n    estimateGas: async (req) => {\n      const account = walletClient.account;\n      const gas = await publicClient.estimateGas({\n        account: account ?? undefined,\n        to: req.to as `0x${string}` | undefined,\n        data: req.data as `0x${string}` | undefined,\n        value: req.value === undefined ? undefined : BigInt(req.value.toString()),\n      });\n      return gas;\n    },\n    sendTransaction: async (req) => {\n      const account = walletClient.account;\n      if (!account) {\n        throw new RelayerSubmitError(\n          \"INTERNAL_ERROR\",\n          \"walletClient has no account; cannot send transaction\",\n        );\n      }\n      let hash: `0x${string}`;\n      try {\n        hash = await walletClient.sendTransaction({\n          account,\n          chain: walletClient.chain ?? null,\n          to: req.to as `0x${string}` | undefined,\n          data: req.data as `0x${string}` | undefined,\n          value: req.value === undefined ? 0n : BigInt(req.value.toString()),\n        });\n      } catch (e) {\n        throw classifyViemSendError(e);\n      }\n      return {\n        hash,\n        wait: async (confirmations?: number) => {\n          const receipt = await publicClient.waitForTransactionReceipt({\n            hash,\n            confirmations,\n            timeout: receiptTimeoutMs,\n          });\n          return mapReceipt(receipt);\n        },\n      };\n    },\n    call: async (req) => {\n      const result = await publicClient.call({\n        to: req.to as `0x${string}` | undefined,\n        data: req.data as `0x${string}` | undefined,\n      });\n      return result.data ?? \"0x\";\n    },\n    send: async (method) => {\n      throw new RelayerSubmitError(\n        \"INTERNAL_ERROR\",\n        `x402-evm: relayer adapter does not support RPC method '${method}'; the relayer never signs typed data`,\n      );\n    },\n    getTransactionReceipt: async (txHash) => {\n      const receipt = await publicClient.getTransactionReceipt({ hash: txHash as `0x${string}` });\n      return mapReceipt(receipt);\n    },\n    getCurrentTimeMs: async () => Date.now(),\n  };\n}\n\n/**\n * Normalize a viem `TransactionReceipt` into the SDK's `TransactionReceipt`\n * shape from `@bosonprotocol/common`. viem's logs carry extra fields the\n * SDK doesn't reference; we strip them so the adapter returns exactly the\n * shape the contract is typed against (and keep both\n * `sendTransaction().wait()` and `getTransactionReceipt(...)` paths from\n * drifting).\n */\nfunction mapReceipt(receipt: Awaited<ReturnType<PublicClient[\"getTransactionReceipt\"]>>) {\n  return {\n    from: receipt.from,\n    to: receipt.to ?? \"\",\n    status: receipt.status === \"success\" ? 1 : 0,\n    logs: receipt.logs.map((log) => ({ data: log.data, topics: [...log.topics] })),\n    transactionHash: receipt.transactionHash,\n    effectiveGasPrice: receipt.effectiveGasPrice,\n    blockNumber: Number(receipt.blockNumber),\n    gasUsed: receipt.gasUsed,\n  };\n}\n\n/** Classify a viem error thrown by `walletClient.sendTransaction`. */\nexport function classifyViemSendError(e: unknown): RelayerSubmitError {\n  const reason =\n    e instanceof Error ? `sendTransaction failed: ${e.message}` : \"sendTransaction failed\";\n\n  if (hasViemCause(e, InsufficientFundsError)) {\n    return new RelayerSubmitError(\"INSUFFICIENT_FUNDS_FOR_GAS\", reason, { cause: e });\n  }\n  if (\n    hasViemCause(e, ExecutionRevertedError) ||\n    hasViemCause(e, ContractFunctionRevertedError) ||\n    hasViemCause(e, RawContractError)\n  ) {\n    return new RelayerSubmitError(\"ONCHAIN_REVERT\", reason, { cause: e });\n  }\n  return new RelayerSubmitError(\"INTERNAL_ERROR\", reason, { cause: e });\n}\n\nfunction hasViemCause<T extends abstract new (...args: never[]) => Error>(\n  e: unknown,\n  ctor: T,\n): boolean {\n  if (e instanceof ctor) return true;\n  if (!(e instanceof BaseError)) return false;\n  return e.walk((err) => err instanceof ctor) !== null;\n}\n"]}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/esm/actions/index.js

@@ -0,0 +1,4 @@
+export { buildCreateOfferAndCommitCalldata, buildCreateOfferCommitAndRedeemCalldata } from '../chunk-2PRTTZRV.js';
+import '../chunk-YVUW4DX6.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/esm/actions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/esm/adapters/index.js

@@ -0,0 +1,4 @@
+export { RelayerSubmitError, classifyViemSendError, walletClientToWeb3LibAdapter } from '../chunk-W5YOMJCB.js';
+export { createCalldataOnlyWeb3LibAdapter } from '../chunk-YVUW4DX6.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/esm/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/esm/chunk-2PRTTZRV.js

@@ -0,0 +1,43 @@
+import { createCalldataOnlyWeb3LibAdapter } from './chunk-YVUW4DX6.js';
+import { metaTx } from '@bosonprotocol/core-sdk';
+
+// src/internal/metatx-calldata-constants.ts
+var DUMMY_CHAIN_ID = 1;
+var DUMMY_METATX_HANDLER_ADDRESS = "0x0000000000000000000000000000000000000000";
+var DUMMY_NONCE = "0";
+
+// src/actions/create-offer-and-commit.ts
+var STUB_CALLER_TAG = "@bosonprotocol/x402-evm:create-offer-and-commit";
+async function buildCreateOfferAndCommitCalldata(args) {
+  const result = await metaTx.handler.signMetaTxCreateOfferAndCommit({
+    web3Lib: createCalldataOnlyWeb3LibAdapter(STUB_CALLER_TAG),
+    metaTxHandlerAddress: DUMMY_METATX_HANDLER_ADDRESS,
+    chainId: DUMMY_CHAIN_ID,
+    nonce: DUMMY_NONCE,
+    createOfferAndCommitArgs: args.fullOffer,
+    returnTypedDataToSign: true
+  });
+  return {
+    functionName: result.functionName,
+    functionSignature: result.functionSignature
+  };
+}
+var STUB_CALLER_TAG2 = "@bosonprotocol/x402-evm:create-offer-commit-and-redeem";
+async function buildCreateOfferCommitAndRedeemCalldata(args) {
+  const result = await metaTx.handler.signMetaTxCreateOfferCommitAndRedeem({
+    web3Lib: createCalldataOnlyWeb3LibAdapter(STUB_CALLER_TAG2),
+    metaTxHandlerAddress: DUMMY_METATX_HANDLER_ADDRESS,
+    chainId: DUMMY_CHAIN_ID,
+    nonce: DUMMY_NONCE,
+    createOfferAndCommitArgs: args.fullOffer,
+    returnTypedDataToSign: true
+  });
+  return {
+    functionName: result.functionName,
+    functionSignature: result.functionSignature
+  };
+}
+
+export { buildCreateOfferAndCommitCalldata, buildCreateOfferCommitAndRedeemCalldata };
+//# sourceMappingURL=chunk-2PRTTZRV.js.map
+//# sourceMappingURL=chunk-2PRTTZRV.js.map

package/dist/esm/chunk-2PRTTZRV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internal/metatx-calldata-constants.ts","../../src/actions/create-offer-and-commit.ts","../../src/actions/create-offer-commit-and-redeem.ts"],"names":["STUB_CALLER_TAG","metaTx"],"mappings":";;;;AAUO,IAAM,cAAA,GAAiB,CAAA;AACvB,IAAM,4BAAA,GAA+B,4CAAA;AACrC,IAAM,WAAA,GAAc,GAAA;;;AC4B3B,IAAM,eAAA,GAAkB,iDAAA;AAQxB,eAAsB,kCACpB,IAAA,EAC8B;AAC9B,EAAA,MAAM,MAAA,GAAS,MAAM,MAAA,CAAO,OAAA,CAAQ,8BAAA,CAA+B;AAAA,IACjE,OAAA,EAAS,iCAAiC,eAAe,CAAA;AAAA,IACzD,oBAAA,EAAsB,4BAAA;AAAA,IACtB,OAAA,EAAS,cAAA;AAAA,IACT,KAAA,EAAO,WAAA;AAAA,IACP,0BAA0B,IAAA,CAAK,SAAA;AAAA,IAC/B,qBAAA,EAAuB;AAAA,GACxB,CAAA;AAED,EAAA,OAAO;AAAA,IACL,cAAc,MAAA,CAAO,YAAA;AAAA,IACrB,mBAAmB,MAAA,CAAO;AAAA,GAC5B;AACF;ACzBA,IAAMA,gBAAAA,GAAkB,wDAAA;AAMxB,eAAsB,wCACpB,IAAA,EAC8B;AAC9B,EAAA,MAAM,MAAA,GAAS,MAAMC,MAAAA,CAAO,OAAA,CAAQ,oCAAA,CAAqC;AAAA,IACvE,OAAA,EAAS,iCAAiCD,gBAAe,CAAA;AAAA,IACzD,oBAAA,EAAsB,4BAAA;AAAA,IACtB,OAAA,EAAS,cAAA;AAAA,IACT,KAAA,EAAO,WAAA;AAAA,IACP,0BAA0B,IAAA,CAAK,SAAA;AAAA,IAC/B,qBAAA,EAAuB;AAAA,GACxB,CAAA;AAED,EAAA,OAAO;AAAA,IACL,cAAc,MAAA,CAAO,YAAA;AAAA,IACrB,mBAAmB,MAAA,CAAO;AAAA,GAC5B;AACF","file":"chunk-2PRTTZRV.js","sourcesContent":["// Placeholder values for the meta-tx fields the SDK's `signMetaTx*` helpers\n// require but the calldata-builder modules don't care about.\n//\n// The builders delegate the `{ functionName, functionSignature }` pair to\n// `metaTx.handler.signMetaTx*({ returnTypedDataToSign: true })`. The SDK\n// requires `chainId`, `metaTxHandlerAddress`, and `nonce` to build the\n// meta-tx typed-data domain, but those affect only the typed-data portion\n// of the response; the selector literal and ABI-encoded calldata we read\n// back are independent of all three.\n\nexport const DUMMY_CHAIN_ID = 1;\nexport const DUMMY_METATX_HANDLER_ADDRESS = \"0x0000000000000000000000000000000000000000\";\nexport const DUMMY_NONCE = \"0\";\n","// Calldata builder for `ExchangeCommitFacet.createOfferAndCommit` —\n// the \"deferred-redemption\" Boson action (Flow A in\n// docs/boson-impl-02-flows.md).\n//\n// Returns the `{ functionName, functionSignature }` pair the buyer's\n// meta-tx typed-data is built over — same pair the on-chain\n// `MetaTransactionsHandlerFacet` recovers signatures against.\n//\n// Implementation note: rather than hand-pin the `functionName` selector\n// string and call `exchanges.iface.encodeCreateOfferAndCommit` here\n// directly, we delegate the whole pair to\n// `@bosonprotocol/core-sdk`'s `metaTx.handler.signMetaTxCreateOfferAndCommit`\n// in `returnTypedDataToSign: true` mode. That's the same helper the\n// client uses to sign, so signing and verification source the\n// `functionName` literal + `functionSignature` bytes from one place.\n// If a future SDK release changes either, both paths track the change\n// automatically.\n\nimport type { FullOfferArgs } from \"@bosonprotocol/common\";\nimport { metaTx } from \"@bosonprotocol/core-sdk\";\nimport type { Hex } from \"viem\";\n\nimport {\n  DUMMY_CHAIN_ID,\n  DUMMY_METATX_HANDLER_ADDRESS,\n  DUMMY_NONCE,\n} from \"../internal/metatx-calldata-constants.js\";\nimport { createCalldataOnlyWeb3LibAdapter } from \"../internal/web3lib-stub.js\";\nimport type { InnerActionCalldata } from \"../types.js\";\n\nexport interface BuildCreateOfferAndCommitCalldataArgs {\n  /**\n   * Full BPIP-10 offer payload, identical in shape to what core-sdk's\n   * `exchanges.iface.encodeCreateOfferAndCommit` accepts. The seller's\n   * `signature` field is embedded inside this struct and is verified\n   * on-chain by `verifyOffer`.\n   */\n  fullOffer: FullOfferArgs;\n}\n\nconst STUB_CALLER_TAG = \"@bosonprotocol/x402-evm:create-offer-and-commit\";\n\n/**\n * Build the `{ functionName, functionSignature }` calldata pair for the\n * `createOfferAndCommit` inner action. The result feeds\n * `@bosonprotocol/x402-core/eip712`'s `metaTransactionTypedData`\n * builder to produce the EIP-712 typed-data the buyer signs.\n */\nexport async function buildCreateOfferAndCommitCalldata(\n  args: BuildCreateOfferAndCommitCalldataArgs,\n): Promise<InnerActionCalldata> {\n  const result = await metaTx.handler.signMetaTxCreateOfferAndCommit({\n    web3Lib: createCalldataOnlyWeb3LibAdapter(STUB_CALLER_TAG),\n    metaTxHandlerAddress: DUMMY_METATX_HANDLER_ADDRESS,\n    chainId: DUMMY_CHAIN_ID,\n    nonce: DUMMY_NONCE,\n    createOfferAndCommitArgs: args.fullOffer,\n    returnTypedDataToSign: true,\n  });\n\n  return {\n    functionName: result.functionName,\n    functionSignature: result.functionSignature as Hex,\n  };\n}\n","// Calldata builder for `OrchestrationHandlerFacet2.createOfferCommitAndRedeem` —\n// the atomic \"create offer + commit + redeem\" Boson action (Flow B in\n// docs/boson-impl-02-flows.md).\n//\n// Same delegation pattern as `./create-offer-and-commit.ts`: rather than\n// hand-pin the `functionName` selector here, we route the whole\n// `{ functionName, functionSignature }` pair through\n// `@bosonprotocol/core-sdk`'s `metaTx.handler.signMetaTxCreateOfferCommitAndRedeem`\n// in `returnTypedDataToSign: true` mode. That's the same helper the\n// client uses to sign, so signing and verification share one source of\n// truth.\n//\n// Note: the function-argument arity differs from `createOfferAndCommit`\n// (this variant takes `(fullOfferStruct, address offerCreator, bytes\n// sellerSig, uint256 conditionalTokenId)` rather than the\n// deferred-redeem path's longer signature).\n\nimport type { FullOfferArgs } from \"@bosonprotocol/common\";\nimport { metaTx } from \"@bosonprotocol/core-sdk\";\nimport type { Hex } from \"viem\";\n\nimport {\n  DUMMY_CHAIN_ID,\n  DUMMY_METATX_HANDLER_ADDRESS,\n  DUMMY_NONCE,\n} from \"../internal/metatx-calldata-constants.js\";\nimport { createCalldataOnlyWeb3LibAdapter } from \"../internal/web3lib-stub.js\";\nimport type { InnerActionCalldata } from \"../types.js\";\n\nexport interface BuildCreateOfferCommitAndRedeemCalldataArgs {\n  /**\n   * Full BPIP-10 offer payload, identical in shape to what core-sdk's\n   * `orchestration.iface.encodeCreateOfferCommitAndRedeem` accepts. The\n   * seller's `signature` field is embedded inside this struct and is\n   * verified on-chain by `verifyOffer`.\n   */\n  fullOffer: FullOfferArgs;\n}\n\nconst STUB_CALLER_TAG = \"@bosonprotocol/x402-evm:create-offer-commit-and-redeem\";\n\n/**\n * Build the `{ functionName, functionSignature }` calldata pair for the\n * `createOfferCommitAndRedeem` inner action.\n */\nexport async function buildCreateOfferCommitAndRedeemCalldata(\n  args: BuildCreateOfferCommitAndRedeemCalldataArgs,\n): Promise<InnerActionCalldata> {\n  const result = await metaTx.handler.signMetaTxCreateOfferCommitAndRedeem({\n    web3Lib: createCalldataOnlyWeb3LibAdapter(STUB_CALLER_TAG),\n    metaTxHandlerAddress: DUMMY_METATX_HANDLER_ADDRESS,\n    chainId: DUMMY_CHAIN_ID,\n    nonce: DUMMY_NONCE,\n    createOfferAndCommitArgs: args.fullOffer,\n    returnTypedDataToSign: true,\n  });\n\n  return {\n    functionName: result.functionName,\n    functionSignature: result.functionSignature as Hex,\n  };\n}\n"]}

package/dist/esm/chunk-W5YOMJCB.js

@@ -0,0 +1,137 @@
+import { BaseError, InsufficientFundsError, ExecutionRevertedError, ContractFunctionRevertedError, RawContractError } from 'viem';
+
+// src/adapters/viem-relayer.ts
+var RelayerSubmitError = class extends Error {
+  constructor(code, message, options) {
+    super(message, options);
+    this.name = "RelayerSubmitError";
+    this.code = code;
+  }
+};
+var DEFAULT_RECEIPT_TIMEOUT_MS = 6e4;
+function walletClientToWeb3LibAdapter(params) {
+  const { walletClient, publicClient, chainId } = params;
+  const receiptTimeoutMs = params.receiptTimeoutMs ?? DEFAULT_RECEIPT_TIMEOUT_MS;
+  if (walletClient.chain && walletClient.chain.id !== chainId) {
+    throw new RelayerSubmitError(
+      "INTERNAL_ERROR",
+      `walletClient.chain.id (${walletClient.chain.id}) does not match adapter chainId (${chainId})`
+    );
+  }
+  if (publicClient.chain && publicClient.chain.id !== chainId) {
+    throw new RelayerSubmitError(
+      "INTERNAL_ERROR",
+      `publicClient.chain.id (${publicClient.chain.id}) does not match adapter chainId (${chainId})`
+    );
+  }
+  return {
+    uuid: "x402-evm:viem-relayer-adapter",
+    getSignerAddress: async () => {
+      const account = walletClient.account;
+      if (!account) {
+        throw new RelayerSubmitError(
+          "INTERNAL_ERROR",
+          "walletClient has no account; cannot resolve signer address"
+        );
+      }
+      return account.address;
+    },
+    isSignerContract: async () => false,
+    getChainId: async () => chainId,
+    getBalance: async (addressOrName) => {
+      const balance = await publicClient.getBalance({ address: addressOrName });
+      return balance;
+    },
+    estimateGas: async (req) => {
+      const account = walletClient.account;
+      const gas = await publicClient.estimateGas({
+        account: account ?? void 0,
+        to: req.to,
+        data: req.data,
+        value: req.value === void 0 ? void 0 : BigInt(req.value.toString())
+      });
+      return gas;
+    },
+    sendTransaction: async (req) => {
+      const account = walletClient.account;
+      if (!account) {
+        throw new RelayerSubmitError(
+          "INTERNAL_ERROR",
+          "walletClient has no account; cannot send transaction"
+        );
+      }
+      let hash;
+      try {
+        hash = await walletClient.sendTransaction({
+          account,
+          chain: walletClient.chain ?? null,
+          to: req.to,
+          data: req.data,
+          value: req.value === void 0 ? 0n : BigInt(req.value.toString())
+        });
+      } catch (e) {
+        throw classifyViemSendError(e);
+      }
+      return {
+        hash,
+        wait: async (confirmations) => {
+          const receipt = await publicClient.waitForTransactionReceipt({
+            hash,
+            confirmations,
+            timeout: receiptTimeoutMs
+          });
+          return mapReceipt(receipt);
+        }
+      };
+    },
+    call: async (req) => {
+      const result = await publicClient.call({
+        to: req.to,
+        data: req.data
+      });
+      return result.data ?? "0x";
+    },
+    send: async (method) => {
+      throw new RelayerSubmitError(
+        "INTERNAL_ERROR",
+        `x402-evm: relayer adapter does not support RPC method '${method}'; the relayer never signs typed data`
+      );
+    },
+    getTransactionReceipt: async (txHash) => {
+      const receipt = await publicClient.getTransactionReceipt({ hash: txHash });
+      return mapReceipt(receipt);
+    },
+    getCurrentTimeMs: async () => Date.now()
+  };
+}
+function mapReceipt(receipt) {
+  return {
+    from: receipt.from,
+    to: receipt.to ?? "",
+    status: receipt.status === "success" ? 1 : 0,
+    logs: receipt.logs.map((log) => ({ data: log.data, topics: [...log.topics] })),
+    transactionHash: receipt.transactionHash,
+    effectiveGasPrice: receipt.effectiveGasPrice,
+    blockNumber: Number(receipt.blockNumber),
+    gasUsed: receipt.gasUsed
+  };
+}
+function classifyViemSendError(e) {
+  const reason = e instanceof Error ? `sendTransaction failed: ${e.message}` : "sendTransaction failed";
+  if (hasViemCause(e, InsufficientFundsError)) {
+    return new RelayerSubmitError("INSUFFICIENT_FUNDS_FOR_GAS", reason, { cause: e });
+  }
+  if (hasViemCause(e, ExecutionRevertedError) || hasViemCause(e, ContractFunctionRevertedError) || hasViemCause(e, RawContractError)) {
+    return new RelayerSubmitError("ONCHAIN_REVERT", reason, { cause: e });
+  }
+  return new RelayerSubmitError("INTERNAL_ERROR", reason, { cause: e });
+}
+function hasViemCause(e, ctor) {
+  if (e instanceof ctor) return true;
+  if (!(e instanceof BaseError)) return false;
+  return e.walk((err) => err instanceof ctor) !== null;
+}
+
+export { RelayerSubmitError, classifyViemSendError, walletClientToWeb3LibAdapter };
+//# sourceMappingURL=chunk-W5YOMJCB.js.map
+//# sourceMappingURL=chunk-W5YOMJCB.js.map