@bankofai/x402-evm 1.0.0-beta.0

package/dist/esm/index.mjs

@@ -0,0 +1,144 @@
+import {
+  AUTH_CAPTURE_ESCROW_ADDRESS,
+  AUTH_CAPTURE_SCHEME,
+  AuthCaptureEvmScheme,
+  EIP3009_TOKEN_COLLECTOR_ADDRESS,
+  PERMIT2_TOKEN_COLLECTOR_ADDRESS
+} from "./chunk-E4Z7PNXC.mjs";
+import {
+  toClientEvmSigner,
+  toFacilitatorEvmSigner
+} from "./chunk-3WZF6722.mjs";
+import {
+  BatchSettlementEvmScheme
+} from "./chunk-GQVMVP4N.mjs";
+import "./chunk-W6ON4LG2.mjs";
+import {
+  BATCH_SETTLEMENT_ADDRESS,
+  BATCH_SETTLEMENT_DOMAIN,
+  BATCH_SETTLEMENT_SCHEME,
+  ERC3009_DEPOSIT_COLLECTOR_ADDRESS,
+  claimBatchTypes,
+  refundTypes,
+  voucherTypes
+} from "./chunk-HYABYUBD.mjs";
+import {
+  ExactEvmScheme
+} from "./chunk-ZCJRY5LQ.mjs";
+import {
+  DEFAULT_STABLECOINS,
+  getDefaultAsset
+} from "./chunk-H3KPLYGI.mjs";
+import {
+  isEIP3009Payload,
+  isPermit2Payload,
+  isUptoPermit2Payload
+} from "./chunk-JK7SLLF7.mjs";
+import {
+  isBatchSettlementClaimPayload,
+  isBatchSettlementDepositPayload,
+  isBatchSettlementEnrichedRefundPayload,
+  isBatchSettlementRefundPayload,
+  isBatchSettlementSettlePayload,
+  isBatchSettlementVoucherPayload
+} from "./chunk-U4HCGTLU.mjs";
+import "./chunk-XG2JLZVJ.mjs";
+import {
+  UptoEvmScheme
+} from "./chunk-I2DVUHM5.mjs";
+import {
+  createPermit2ApprovalTx,
+  getPermit2AllowanceReadParams
+} from "./chunk-QVATVA3J.mjs";
+import "./chunk-H2EYJIZL.mjs";
+import "./chunk-P3QOX3QZ.mjs";
+import {
+  BUILDER_CODE_KEY,
+  appendDataSuffix,
+  resolveDataSuffix
+} from "./chunk-JNT7C46S.mjs";
+import {
+  PERMIT2_ADDRESS,
+  authorizationTypes,
+  eip3009ABI,
+  erc20AllowanceAbi,
+  permit2WitnessTypes,
+  uptoPermit2WitnessTypes,
+  x402ExactPermit2ProxyABI,
+  x402ExactPermit2ProxyAddress,
+  x402UptoPermit2ProxyABI,
+  x402UptoPermit2ProxyAddress
+} from "./chunk-MACPBXCT.mjs";
+import "./chunk-VS3RYAYE.mjs";
+import "./chunk-TW7Z65AO.mjs";
+
+// src/auth-capture/types.ts
+function isAuthCaptureExtra(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return typeof v.captureAuthorizer === "string" && typeof v.captureDeadline === "number" && typeof v.refundDeadline === "number" && typeof v.feeRecipient === "string" && typeof v.minFeeBps === "number" && typeof v.maxFeeBps === "number" && typeof v.name === "string" && typeof v.version === "string";
+}
+function isEip3009Payload(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  return "authorization" in v && typeof v.authorization === "object" && v.authorization !== null && typeof v.signature === "string" && typeof v.salt === "string";
+}
+function isPermit2Payload2(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const v = value;
+  if (typeof v.signature !== "string" || typeof v.salt !== "string") return false;
+  if (typeof v.permit2Authorization !== "object" || v.permit2Authorization === null) return false;
+  const a = v.permit2Authorization;
+  return typeof a.from === "string" && typeof a.spender === "string" && typeof a.nonce === "string" && typeof a.deadline === "string" && typeof a.permitted === "object" && a.permitted !== null;
+}
+function isAuthCapturePayload(value) {
+  return isEip3009Payload(value) || isPermit2Payload2(value);
+}
+export {
+  AUTH_CAPTURE_ESCROW_ADDRESS,
+  AUTH_CAPTURE_SCHEME,
+  AuthCaptureEvmScheme,
+  BATCH_SETTLEMENT_ADDRESS,
+  BATCH_SETTLEMENT_DOMAIN,
+  BATCH_SETTLEMENT_SCHEME,
+  BUILDER_CODE_KEY,
+  BatchSettlementEvmScheme,
+  DEFAULT_STABLECOINS,
+  EIP3009_TOKEN_COLLECTOR_ADDRESS,
+  ERC3009_DEPOSIT_COLLECTOR_ADDRESS,
+  ExactEvmScheme,
+  PERMIT2_ADDRESS,
+  PERMIT2_TOKEN_COLLECTOR_ADDRESS,
+  UptoEvmScheme,
+  appendDataSuffix,
+  authorizationTypes,
+  claimBatchTypes,
+  createPermit2ApprovalTx,
+  eip3009ABI,
+  erc20AllowanceAbi,
+  getDefaultAsset,
+  getPermit2AllowanceReadParams,
+  isAuthCaptureExtra,
+  isAuthCapturePayload,
+  isBatchSettlementClaimPayload,
+  isBatchSettlementDepositPayload,
+  isBatchSettlementEnrichedRefundPayload,
+  isBatchSettlementRefundPayload,
+  isBatchSettlementSettlePayload,
+  isBatchSettlementVoucherPayload,
+  isEIP3009Payload,
+  isPermit2Payload,
+  isUptoPermit2Payload,
+  permit2WitnessTypes,
+  refundTypes,
+  resolveDataSuffix,
+  toClientEvmSigner,
+  toFacilitatorEvmSigner,
+  uptoPermit2WitnessTypes,
+  voucherTypes,
+  x402ExactPermit2ProxyABI,
+  x402ExactPermit2ProxyAddress,
+  x402UptoPermit2ProxyABI,
+  x402UptoPermit2ProxyAddress
+};
+//# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/auth-capture/types.ts"],"sourcesContent":["/**\n * auth-capture wire-format types.\n *\n * Spec-level field names (captureAuthorizer, captureDeadline, refundDeadline,\n * feeRecipient) live here at the extra/wire layer. The on-chain PaymentInfo\n * struct keeps the canonical Solidity field names (operator, authorizationExpiry,\n * refundExpiry, feeReceiver) so the EIP-712 typehash stays byte-identical with\n * the AuthCaptureEscrow contract.\n *\n * Salt is NOT in extra. It is generated client-side per signing call and rides\n * on the payload alongside the signature.\n */\n\nimport type { AssetTransferMethod } from \"../types\";\n\n// AuthCaptureExtra — fields in PaymentRequirements.extra.\n//\n// Fee-policy fields (minFeeBps, maxFeeBps, feeRecipient) are all required.\n// No implicit defaults: a merchant who wants no minimum fee writes\n// `minFeeBps: 0` explicitly. This forces fee policy to be a conscious choice\n// on the wire and avoids \"did they mean 0 or did they forget?\" ambiguity.\nexport interface AuthCaptureExtra {\n  // Required\n  // The only address allowed to call authorize/capture/void/refund/charge on\n  // AuthCaptureEscrow (each of those is gated by onlySender(paymentInfo.operator))\n  // — i.e., it must be msg.sender of the \"Authorize\" call. In x402's\n  // facilitator-submits flow that means either the facilitator's EOA, or any\n  // smart contract that ultimately calls escrow (arbiter with dispute logic,\n  // multisig, etc.). Independent of assetTransferMethod — applies to both\n  // EIP-3009 and Permit2.\n  captureAuthorizer: `0x${string}`; // formerly `operator` in commerce-payments\n  captureDeadline: number; // absolute Unix seconds; capture must occur before this\n  refundDeadline: number; // absolute Unix seconds; refunds allowed until this\n  feeRecipient: `0x${string}`; // address that receives the fee portion (renamed from feeReceiver)\n  minFeeBps: number; // floor on the captureAuthorizer's fee; 0 = no minimum\n  maxFeeBps: number; // cap on the captureAuthorizer's fee\n  name: string; // EIP-712 token-domain name (e.g., \"USDC\")\n  version: string; // EIP-712 token-domain version (e.g., \"2\")\n  // Optional\n  autoCapture?: boolean; // default: false. true → facilitator calls charge(), false → authorize()\n  assetTransferMethod?: AssetTransferMethod; // default: 'eip3009'\n}\n\n/**\n * Type guard for AuthCaptureExtra. Checks the structural shape an auth-capture\n * scheme requires inside `PaymentRequirements.extra`: every spec-mandated\n * required field present with the right primitive type.\n *\n * @param value - Candidate object from `requirements.extra`.\n * @returns True if `value` has every required AuthCaptureExtra field.\n */\nexport function isAuthCaptureExtra(value: unknown): value is AuthCaptureExtra {\n  if (typeof value !== \"object\" || value === null) return false;\n  const v = value as Record<string, unknown>;\n  return (\n    typeof v.captureAuthorizer === \"string\" &&\n    typeof v.captureDeadline === \"number\" &&\n    typeof v.refundDeadline === \"number\" &&\n    typeof v.feeRecipient === \"string\" &&\n    typeof v.minFeeBps === \"number\" &&\n    typeof v.maxFeeBps === \"number\" &&\n    typeof v.name === \"string\" &&\n    typeof v.version === \"string\"\n  );\n}\n\n// EIP-3009 payload — ReceiveWithAuthorization to the canonical EIP-3009 token collector.\nexport interface Eip3009Payload {\n  authorization: {\n    from: `0x${string}`;\n    to: `0x${string}`; // EIP3009_TOKEN_COLLECTOR_ADDRESS\n    value: string;\n    validAfter: string;\n    validBefore: string; // = preApprovalExpiry\n    nonce: `0x${string}`; // = payer-agnostic PaymentInfo hash\n  };\n  signature: `0x${string}`;\n  salt: `0x${string}`; // bytes32, fresh per request, used to reconstruct PaymentInfo\n}\n\n/**\n * Type guard for an EIP-3009-shaped auth-capture payload. Checks for an\n * `authorization` object plus the required `signature` and `salt` fields;\n * field-level validation happens later in `verify()`.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` has the EIP-3009 envelope shape.\n */\nexport function isEip3009Payload(value: unknown): value is Eip3009Payload {\n  if (typeof value !== \"object\" || value === null) return false;\n  const v = value as Record<string, unknown>;\n  return (\n    \"authorization\" in v &&\n    typeof v.authorization === \"object\" &&\n    v.authorization !== null &&\n    typeof v.signature === \"string\" &&\n    typeof v.salt === \"string\"\n  );\n}\n\n// Permit2 payload — PermitTransferFrom to the canonical Permit2 token collector.\nexport interface Permit2Payload {\n  permit2Authorization: {\n    from: `0x${string}`;\n    permitted: {\n      token: `0x${string}`;\n      amount: string;\n    };\n    spender: `0x${string}`; // PERMIT2_TOKEN_COLLECTOR_ADDRESS\n    nonce: string; // uint256 string, = uint256(payer-agnostic PaymentInfo hash)\n    deadline: string; // = preApprovalExpiry\n  };\n  signature: `0x${string}`;\n  salt: `0x${string}`; // bytes32, fresh per request, used to reconstruct PaymentInfo\n}\n\n/**\n * Type guard for a Permit2-shaped auth-capture payload. Checks for the\n * `permit2Authorization` envelope (with `from`, `spender`, `nonce`,\n * `deadline`, `permitted`) plus the required `signature` and `salt` fields.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` has the Permit2 envelope shape.\n */\nexport function isPermit2Payload(value: unknown): value is Permit2Payload {\n  if (typeof value !== \"object\" || value === null) return false;\n  const v = value as Record<string, unknown>;\n  if (typeof v.signature !== \"string\" || typeof v.salt !== \"string\") return false;\n  if (typeof v.permit2Authorization !== \"object\" || v.permit2Authorization === null) return false;\n  const a = v.permit2Authorization as Record<string, unknown>;\n  return (\n    typeof a.from === \"string\" &&\n    typeof a.spender === \"string\" &&\n    typeof a.nonce === \"string\" &&\n    typeof a.deadline === \"string\" &&\n    typeof a.permitted === \"object\" &&\n    a.permitted !== null\n  );\n}\n\n// Discriminated union of all auth-capture payload shapes.\nexport type AuthCapturePayload = Eip3009Payload | Permit2Payload;\n\n/**\n * Type guard for any auth-capture payload. Returns true if `value` matches\n * either the EIP-3009 envelope or the Permit2 envelope.\n *\n * @param value - Candidate payment payload from the wire.\n * @returns True if `value` is a valid auth-capture envelope of either shape.\n */\nexport function isAuthCapturePayload(value: unknown): value is AuthCapturePayload {\n  return isEip3009Payload(value) || isPermit2Payload(value);\n}\n\n/**\n * On-chain PaymentInfo struct (canonical Solidity names — DO NOT RENAME).\n * Reconstructed by the facilitator from extra + payload.salt + payer + receiver/asset/amount.\n */\nexport interface PaymentInfoStruct {\n  operator: `0x${string}`; // = extra.captureAuthorizer\n  payer: `0x${string}`;\n  receiver: `0x${string}`; // = requirements.payTo\n  token: `0x${string}`; // = requirements.asset\n  maxAmount: string; // = requirements.amount\n  preApprovalExpiry: number;\n  authorizationExpiry: number; // = extra.captureDeadline\n  refundExpiry: number; // = extra.refundDeadline\n  minFeeBps: number;\n  maxFeeBps: number;\n  feeReceiver: `0x${string}`; // = extra.feeRecipient\n  salt: `0x${string}`; // = payload.salt\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmDO,SAAS,mBAAmB,OAA2C;AAC5E,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,QAAM,IAAI;AACV,SACE,OAAO,EAAE,sBAAsB,YAC/B,OAAO,EAAE,oBAAoB,YAC7B,OAAO,EAAE,mBAAmB,YAC5B,OAAO,EAAE,iBAAiB,YAC1B,OAAO,EAAE,cAAc,YACvB,OAAO,EAAE,cAAc,YACvB,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,YAAY;AAEzB;AAwBO,SAAS,iBAAiB,OAAyC;AACxE,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,QAAM,IAAI;AACV,SACE,mBAAmB,KACnB,OAAO,EAAE,kBAAkB,YAC3B,EAAE,kBAAkB,QACpB,OAAO,EAAE,cAAc,YACvB,OAAO,EAAE,SAAS;AAEtB;AA0BO,SAASA,kBAAiB,OAAyC;AACxE,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,QAAM,IAAI;AACV,MAAI,OAAO,EAAE,cAAc,YAAY,OAAO,EAAE,SAAS,SAAU,QAAO;AAC1E,MAAI,OAAO,EAAE,yBAAyB,YAAY,EAAE,yBAAyB,KAAM,QAAO;AAC1F,QAAM,IAAI,EAAE;AACZ,SACE,OAAO,EAAE,SAAS,YAClB,OAAO,EAAE,YAAY,YACrB,OAAO,EAAE,UAAU,YACnB,OAAO,EAAE,aAAa,YACtB,OAAO,EAAE,cAAc,YACvB,EAAE,cAAc;AAEpB;AAYO,SAAS,qBAAqB,OAA6C;AAChF,SAAO,iBAAiB,KAAK,KAAKA,kBAAiB,KAAK;AAC1D;","names":["isPermit2Payload"]}