{"version":3,"sources":["../../src/exact/facilitator/eip3009-utils.ts"],"sourcesContent":["import { PaymentRequirements, VerifyResponse } from \"@bankofai/x402-core/types\";\nimport {\n  encodeFunctionData,\n  getAddress,\n  Hex,\n  isAddressEqual,\n  parseErc6492Signature,\n  parseEventLogs,\n  parseSignature,\n  type Log,\n} from \"viem\";\nimport { eip3009ABI } from \"../../constants\";\nimport { multicall, ContractCall, RawContractCall } from \"../../multicall\";\nimport { FacilitatorEvmSigner } from \"../../signer\";\nimport { ExactEIP3009Payload } from \"../../types\";\nimport * as Errors from \"./errors\";\n\nconst erc20TransferEventAbi = [\n  {\n    type: \"event\",\n    name: \"Transfer\",\n    anonymous: false,\n    inputs: [\n      { name: \"from\", type: \"address\", indexed: true },\n      { name: \"to\", type: \"address\", indexed: true },\n      { name: \"value\", type: \"uint256\", indexed: false },\n    ],\n  },\n] as const;\n\nexport interface Eip6492Deployment {\n  factoryAddress: `0x${string}`;\n  factoryCalldata: `0x${string}`;\n}\n\n/**\n * Outcome of a transfer simulation. `error` is populated only when the underlying `eth_call`\n * threw (revert or transport), letting callers distinguish a contract revert from an RPC failure.\n */\nexport interface SimulateEip3009Result {\n  ok: boolean;\n  error?: unknown;\n}\n\n/**\n * Simulates transferWithAuthorization via eth_call.\n * Returns true if simulation succeeded, false if it failed.\n *\n * @param signer - EVM signer for contract reads\n * @param erc20Address - ERC-20 token contract address\n * @param payload - EIP-3009 transfer authorization payload\n * @param eip6492Deployment - Optional EIP-6492 factory info for undeployed smart wallets\n *\n * @returns true if simulation succeeded, false if it failed\n */\nexport async function simulateEip3009Transfer(\n  signer: FacilitatorEvmSigner,\n  erc20Address: `0x${string}`,\n  payload: ExactEIP3009Payload,\n  eip6492Deployment?: Eip6492Deployment,\n): Promise<boolean> {\n  return (await simulateEip3009TransferResult(signer, erc20Address, payload, eip6492Deployment)).ok;\n}\n\n/**\n * Like {@link simulateEip3009Transfer} but returns the thrown error (if any) alongside the\n * boolean outcome, so callers can tell a contract revert apart from a transport/RPC failure.\n *\n * @param signer - EVM signer for contract reads\n * @param erc20Address - ERC-20 token contract address\n * @param payload - EIP-3009 transfer authorization payload\n * @param eip6492Deployment - Optional EIP-6492 factory info for undeployed smart wallets\n * @returns The simulation outcome and, on failure via a thrown error, that error.\n */\nexport async function simulateEip3009TransferResult(\n  signer: FacilitatorEvmSigner,\n  erc20Address: `0x${string}`,\n  payload: ExactEIP3009Payload,\n  eip6492Deployment?: Eip6492Deployment,\n): Promise<SimulateEip3009Result> {\n  const auth = payload.authorization;\n  const transferArgs = [\n    getAddress(auth.from),\n    getAddress(auth.to),\n    BigInt(auth.value),\n    BigInt(auth.validAfter),\n    BigInt(auth.validBefore),\n    auth.nonce,\n  ] as const;\n\n  if (eip6492Deployment) {\n    const { signature: innerSignature } = parseErc6492Signature(payload.signature!);\n    const transferCalldata = encodeFunctionData({\n      abi: eip3009ABI,\n      functionName: \"transferWithAuthorization\",\n      args: [...transferArgs, innerSignature],\n    });\n\n    try {\n      const results = await multicall(signer.readContract.bind(signer), [\n        {\n          address: getAddress(eip6492Deployment.factoryAddress),\n          callData: eip6492Deployment.factoryCalldata,\n        } satisfies RawContractCall,\n        {\n          address: erc20Address,\n          callData: transferCalldata,\n        } satisfies RawContractCall,\n      ]);\n\n      return { ok: results[1]?.status === \"success\" };\n    } catch (error) {\n      return { ok: false, error };\n    }\n  }\n\n  const sig = payload.signature!;\n  const sigLength = sig.startsWith(\"0x\") ? sig.length - 2 : sig.length;\n  const isECDSA = sigLength === 130;\n\n  try {\n    if (isECDSA) {\n      const parsedSig = parseSignature(sig);\n      await signer.readContract({\n        address: erc20Address,\n        abi: eip3009ABI,\n        functionName: \"transferWithAuthorization\",\n        args: [\n          ...transferArgs,\n          (parsedSig.v as number | undefined) ?? parsedSig.yParity,\n          parsedSig.r,\n          parsedSig.s,\n        ],\n      });\n    } else {\n      await signer.readContract({\n        address: erc20Address,\n        abi: eip3009ABI,\n        functionName: \"transferWithAuthorization\",\n        args: [...transferArgs, sig],\n      });\n    }\n    return { ok: true };\n  } catch (error) {\n    return { ok: false, error };\n  }\n}\n\n/**\n * After simulation fails, runs a single diagnostic multicall to determine the most specific error reason.\n * Checks balanceOf, name, version and authorizationState in one RPC round-trip.\n *\n * @param signer - EVM signer used for the payment\n * @param erc20Address - Address of the ERC-20 token contract\n * @param payload - The EIP-3009 transfer authorization payload\n * @param requirements - Payment requirements to validate against\n * @param amountRequired - Required amount for the payment (balance check)\n *\n * @returns Promise resolving to the verification result with validity and optional invalid reason\n */\nexport async function diagnoseEip3009SimulationFailure(\n  signer: FacilitatorEvmSigner,\n  erc20Address: `0x${string}`,\n  payload: ExactEIP3009Payload,\n  requirements: PaymentRequirements,\n  amountRequired: string,\n): Promise<VerifyResponse> {\n  const payer = payload.authorization.from;\n\n  const diagnosticCalls: ContractCall[] = [\n    {\n      address: erc20Address,\n      abi: eip3009ABI,\n      functionName: \"balanceOf\",\n      args: [payload.authorization.from],\n    },\n    {\n      address: erc20Address,\n      abi: eip3009ABI,\n      functionName: \"name\",\n    },\n    {\n      address: erc20Address,\n      abi: eip3009ABI,\n      functionName: \"version\",\n    },\n    {\n      address: erc20Address,\n      abi: eip3009ABI,\n      functionName: \"authorizationState\",\n      args: [payload.authorization.from, payload.authorization.nonce],\n    },\n  ];\n\n  try {\n    const results = await multicall(signer.readContract.bind(signer), diagnosticCalls);\n\n    const [balanceResult, nameResult, versionResult, authStateResult] = results;\n\n    if (authStateResult.status === \"failure\") {\n      return { isValid: false, invalidReason: Errors.ErrEip3009NotSupported, payer };\n    }\n\n    if (authStateResult.status === \"success\" && authStateResult.result === true) {\n      return { isValid: false, invalidReason: Errors.ErrEip3009NonceAlreadyUsed, payer };\n    }\n\n    if (\n      nameResult.status === \"success\" &&\n      requirements.extra?.name &&\n      nameResult.result !== requirements.extra.name\n    ) {\n      return { isValid: false, invalidReason: Errors.ErrEip3009TokenNameMismatch, payer };\n    }\n\n    if (\n      versionResult.status === \"success\" &&\n      requirements.extra?.version &&\n      versionResult.result !== requirements.extra.version\n    ) {\n      return { isValid: false, invalidReason: Errors.ErrEip3009TokenVersionMismatch, payer };\n    }\n\n    if (balanceResult.status === \"success\") {\n      const balance = balanceResult.result as bigint;\n      if (balance < BigInt(amountRequired)) {\n        return {\n          isValid: false,\n          invalidReason: Errors.ErrEip3009InsufficientBalance,\n          payer,\n        };\n      }\n    }\n  } catch {\n    // Diagnostic multicall failed — fall through to generic error\n  }\n\n  return { isValid: false, invalidReason: Errors.ErrEip3009SimulationFailed, payer };\n}\n\n/**\n * Verifies that the post-settle receipt contains an ERC-20 Transfer event\n * emitted by the expected token contract whose (from, to, value) matches the\n * authorization.\n *\n * @param logs - Receipt logs to search for a matching Transfer\n * @param erc20Address - The ERC-20 token contract that should have emitted the Transfer\n * @param expected - The expected Transfer arguments from the authorization\n * @param expected.from - Expected `from` of the Transfer event\n * @param expected.to - Expected `to` of the Transfer event\n * @param expected.value - Expected `value` of the Transfer event\n * @returns true when a matching Transfer log is present, false otherwise\n */\nexport function verifyEip3009TransferEvent(\n  logs: readonly Log[],\n  erc20Address: `0x${string}`,\n  expected: { from: `0x${string}`; to: `0x${string}`; value: bigint },\n): boolean {\n  const transferLogs = parseEventLogs({\n    abi: erc20TransferEventAbi,\n    eventName: \"Transfer\",\n    logs: logs.filter(log => isAddressEqual(log.address, erc20Address)),\n  });\n  return transferLogs.some(\n    log =>\n      isAddressEqual(log.args.from, expected.from) &&\n      isAddressEqual(log.args.to, expected.to) &&\n      log.args.value === expected.value,\n  );\n}\n\n/**\n * Maps an EIP-3009 contract revert error to a specific error code.\n * Falls back to ErrTransactionFailed when the revert reason is unknown.\n *\n * @param error - The error thrown during transfer execution\n * @returns A specific error reason string\n */\nexport function parseEip3009TransferError(error: unknown): string {\n  const msg = error instanceof Error ? error.message : String(error);\n  if (/authorization.*(expired|valid before)/i.test(msg) || /AuthorizationExpired/i.test(msg)) {\n    return Errors.ErrValidBeforeExpired;\n  }\n  if (/authorization.*not.*valid|AuthorizationNotYetValid/i.test(msg)) {\n    return Errors.ErrValidAfterInFuture;\n  }\n  if (/authorization.*used|AuthorizationAlreadyUsed|AuthorizationUsedOrCanceled/i.test(msg)) {\n    return Errors.ErrEip3009NonceAlreadyUsed;\n  }\n  if (/transfer.*exceeds.*balance|insufficient.*balance|ERC20InsufficientBalance/i.test(msg)) {\n    return Errors.ErrEip3009InsufficientBalance;\n  }\n  if (/invalid.*signature|SignerMismatch|InvalidSignatureV|InvalidSignatureS/i.test(msg)) {\n    return Errors.ErrInvalidSignature;\n  }\n  return Errors.ErrTransactionFailed;\n}\n\n/**\n * Executes transferWithAuthorization onchain.\n *\n * @param signer - EVM signer for contract writes\n * @param erc20Address - ERC-20 token contract address\n * @param payload - EIP-3009 transfer authorization payload\n * @param dataSuffix - Optional hex bytes to append after the ABI-encoded calldata\n *\n * @returns Transaction hash\n */\nexport async function executeTransferWithAuthorization(\n  signer: FacilitatorEvmSigner,\n  erc20Address: `0x${string}`,\n  payload: ExactEIP3009Payload,\n  dataSuffix?: Hex,\n): Promise<Hex> {\n  const { signature } = parseErc6492Signature(payload.signature!);\n  const signatureLength = signature.startsWith(\"0x\") ? signature.length - 2 : signature.length;\n  const isECDSA = signatureLength === 130;\n\n  const auth = payload.authorization;\n  const baseArgs = [\n    getAddress(auth.from),\n    getAddress(auth.to),\n    BigInt(auth.value),\n    BigInt(auth.validAfter),\n    BigInt(auth.validBefore),\n    auth.nonce,\n  ] as const;\n\n  let signatureArgs: readonly unknown[];\n  if (isECDSA) {\n    const parsedSig = parseSignature(signature);\n    signatureArgs = [\n      (parsedSig.v as number | undefined) || parsedSig.yParity,\n      parsedSig.r,\n      parsedSig.s,\n    ];\n  } else {\n    signatureArgs = [signature];\n  }\n\n  return signer.writeContract({\n    address: erc20Address,\n    abi: eip3009ABI,\n    functionName: \"transferWithAuthorization\",\n    args: [...baseArgs, ...signatureArgs],\n    dataSuffix,\n  });\n}\n"],"mappings":"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","names":[]}