@pepu-chain/sdk 0.2.0 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pepu-chain/sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Chain definitions, contract registry, token list, and viem helpers for Pepe Unchained V2.",
   "license": "MIT",
   "author": "Pepe Unchained <contact@pepeunchained.com> (https://pepeunchained.com)",
@@ -26,6 +26,9 @@
     },
     "./react": {
       "types": "./dist/react.d.ts",
+      "node": {
+        "import": "./dist/react.guard.js"
+      },
       "import": "./dist/react.js",
       "require": "./dist/react.cjs"
     },
@@ -36,15 +39,24 @@
     },
     "./privy/react": {
       "types": "./dist/privy/react.d.ts",
+      "node": {
+        "import": "./dist/privy/react.guard.js"
+      },
       "import": "./dist/privy/react.js",
       "require": "./dist/privy/react.cjs"
     },
     "./privy/wagmi": {
       "types": "./dist/privy/wagmi.d.ts",
+      "node": {
+        "import": "./dist/privy/wagmi.guard.js"
+      },
       "import": "./dist/privy/wagmi.js"
     },
     "./privy/server": {
       "types": "./dist/privy/server.d.ts",
+      "node": {
+        "import": "./dist/privy/server.guard.js"
+      },
       "import": "./dist/privy/server.js",
       "require": "./dist/privy/server.cjs"
     },
@@ -55,16 +67,25 @@
     },
     "./session/server": {
       "types": "./dist/session/server.d.ts",
+      "node": {
+        "import": "./dist/session/server.guard.js"
+      },
       "import": "./dist/session/server.js",
       "require": "./dist/session/server.cjs"
     },
     "./session/react": {
       "types": "./dist/session/react.d.ts",
+      "node": {
+        "import": "./dist/session/react.guard.js"
+      },
       "import": "./dist/session/react.js",
       "require": "./dist/session/react.cjs"
     },
     "./session/kernel": {
       "types": "./dist/session/kernel.d.ts",
+      "node": {
+        "import": "./dist/session/kernel.guard.js"
+      },
       "import": "./dist/session/kernel.js",
       "require": "./dist/session/kernel.cjs"
     },
@@ -75,16 +96,25 @@
     },
     "./aa/kernel": {
       "types": "./dist/aa/kernel.d.ts",
+      "node": {
+        "import": "./dist/aa/kernel.guard.js"
+      },
       "import": "./dist/aa/kernel.js",
       "require": "./dist/aa/kernel.cjs"
     },
     "./aa/react": {
       "types": "./dist/aa/react.d.ts",
+      "node": {
+        "import": "./dist/aa/react.guard.js"
+      },
       "import": "./dist/aa/react.js",
       "require": "./dist/aa/react.cjs"
     },
     "./aa/react-direct": {
       "types": "./dist/aa/react-direct.d.ts",
+      "node": {
+        "import": "./dist/aa/react-direct.guard.js"
+      },
       "import": "./dist/aa/react-direct.js",
       "require": "./dist/aa/react-direct.cjs"
     },
@@ -100,11 +130,17 @@
     },
     "./combo": {
       "types": "./dist/combo.d.ts",
+      "node": {
+        "import": "./dist/combo.guard.js"
+      },
       "import": "./dist/combo.js",
       "require": "./dist/combo.cjs"
     },
     "./combo/react": {
       "types": "./dist/combo/react.d.ts",
+      "node": {
+        "import": "./dist/combo/react.guard.js"
+      },
       "import": "./dist/combo/react.js",
       "require": "./dist/combo/react.cjs"
     },
@@ -203,7 +239,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup && node scripts/prune-esm-only.mjs",
+    "build": "tsup && node scripts/prune-esm-only.mjs && node scripts/guard-peers.mjs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "live-check": "node scripts/live-check.mjs",

package/dist/chunk-FCXSP2YF.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/contracts.ts"],"names":[],"mappings":"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","file":"chunk-FCXSP2YF.js","sourcesContent":["import type { Address } from \"viem\";\n\nimport { pepuMainnet, pepuTestnet } from \"./chains.js\";\n\n/**\n * Canonical keys for contracts tracked by this registry. Adding a new key\n * here (and a corresponding entry per chain below) is not a breaking\n * change for consumers that read the registry through {@link getContract}\n * or {@link listContracts}.\n */\nexport type PepuContractName =\n  | \"create2Factory\"\n  | \"multicall3\"\n  | \"permit2\"\n  | \"entryPoint06\"\n  | \"entryPoint07\"\n  | \"kernelFactory\"\n  | \"kernelMetaFactory\"\n  | \"ecdsaValidator\"\n  | \"paymaster\"\n  | \"kernelImplementation\"\n  | \"kernelEcdsaSignerModule\"\n  | \"kernelCallPolicyV004\"\n  | \"kernelTimestampPolicy\"\n  | \"tapScore\"\n  | \"paymasterV1\"\n  | \"paymasterV2\";\n\n/** A contract that is confirmed live on-chain at `address`. */\nexport interface DeployedContract {\n  readonly status: \"deployed\";\n  /** Human-readable name, for logging/UI. */\n  readonly name: string;\n  /** Verified contract address. */\n  readonly address: Address;\n  /** Optional short note, e.g. how the address was verified. */\n  readonly notes?: string;\n  /**\n   * ISO date (YYYY-MM-DD) on which the address was last confirmed to have\n   * bytecode via `eth_getCode` against the PEPU mainnet RPC. Re-run\n   * `node packages/sdk/scripts/live-check.mjs` to refresh.\n   */\n  readonly verifiedAt?: string;\n  /**\n   * True when the contract still has bytecode but must not be used (for example\n   * the v1 paymaster, whose EntryPoint deposit was withdrawn). Never route new\n   * work to a retired contract.\n   */\n  readonly retired?: true;\n}\n\n/**\n * A contract that is not yet deployed on this chain. Deliberately has no\n * `address` field — callers must not be able to accidentally read a\n * placeholder value and treat it as real. Use {@link getContract} /\n * {@link isDeployed} to narrow before reading an address.\n */\nexport interface PendingContract {\n  readonly status: \"pending\";\n  /** Human-readable name, for logging/UI. */\n  readonly name: string;\n  /** Why this contract has no verified address yet. */\n  readonly reason: string;\n}\n\nexport type ContractEntry = DeployedContract | PendingContract;\n\n/** Per-chain contract catalog, keyed by {@link PepuContractName}. */\nexport type PepuContractRegistry = Readonly<\n  Record<PepuContractName, ContractEntry>\n>;\n\nconst MULTICALL3_PENDING_REASON =\n  \"Canonical Multicall3 (0xcA11bde05977b3631167028862bE2a173976CA11) was \" +\n  \"deployed elsewhere via a pre-signed CREATE transaction with a \" +\n  \"1,000,000 gas limit. This Arbitrum Nitro chain needs ~14.3M gas to \" +\n  \"deploy the same bytecode, so that transaction cannot execute here and \" +\n  \"the canonical address is unreachable. A PEPU-specific deployment is \" +\n  \"pending; do not substitute the canonical address.\";\n\nconst MULTICALL3_MAINNET_NOTES =\n  \"PEPU-specific deployment. NOT at the canonical Multicall3 address, \" +\n  \"which is unreachable on this Nitro chain (the canonical pre-signed \" +\n  \"CREATE tx carries a 1,000,000 gas limit; this bytecode needs ~14.3M). \" +\n  \"Deployed from canonical mds1/multicall3 source (solc 0.8.12, optimizer \" +\n  \"10,000,000 runs) via the CREATE2 deterministic deployer with a zero \" +\n  \"salt, so the same source reproduces this address on any chain that has \" +\n  \"that deployer. Verified on pepuscan. viem/wagmi multicall confirmed \" +\n  \"working against it.\";\n\nconst ZERODEV_NOTES =\n  \"Deployed by ZeroDev's one-click Conduit Marketplace integration \" +\n  \"(mainnet only — not present on testnet).\";\n\nconst PERMIT2_PENDING_REASON =\n  \"Not yet deployed on this chain. The CREATE2 deterministic deployer \" +\n  \"needed to reproduce Permit2's canonical address is live, so this is \" +\n  \"unblocked, but no deployment has happened (and been verified) yet.\";\n\nconst PERMIT2_MAINNET_NOTES =\n  \"Deployed at the canonical Permit2 address via the CREATE2 deterministic \" +\n  \"deployer, same as on every other chain that has it. Verified live \" +\n  \"2026-09-24 via eth_getCode (9,152 bytes, matching Permit2's known \" +\n  \"bytecode size) plus a successful DOMAIN_SEPARATOR() eth_call. This is \" +\n  \"the canonical Permit2 — do not confuse it with PepuSwap's own separate \" +\n  \"Permit2 deployment at pepuSwapContracts.permit2NonCanonical in ./dex.js, \" +\n  \"which predates this one and is not interchangeable with it.\";\n\nconst PAYMASTER_MAINNET_NOTES =\n  \"Alias of `paymasterV2`: the tiered PepuSponsoredPaymasterV7 canary (0xdb28...C30D), deployed \" +\n  \"around block 10537341 and funded in small tranches. Internally reviewed 3x, external audit \" +\n  \"pending. Owner 0x5966dFaB11c8AEe767e0739083417D02f4a634A1, manager \" +\n  \"0x063Ab6C16c38D19A4bC76E7c39A4A0A73afCaBb0. The free pool was seeded with 300 PEPU; free-tier \" +\n  \"destinations are TapScore only for now. It sponsors only through the hosted policy service \" +\n  \"(paymaster.pepeunchained.com) with the hosted bundler (bundler.pepeunchained.com). The v1 \" +\n  \"paymaster is retired (see `paymasterV1`).\";\n\n/** Date the mainnet addresses below were last checked with eth_getCode. */\nconst VERIFIED_AT = \"2026-10-02\";\n\n/** Date the v2 paymaster canary was verified live (deployment record: deploy-receipt-v2.json). */\nconst PAYMASTER_V2_VERIFIED_AT = \"2026-10-14\";\n\nconst KERNEL_IMPL_NOTES =\n  ZERODEV_NOTES +\n  \" Kernel v3.1 implementation that kernelFactory.implementation() resolves to; \" +\n  \"same address ZeroDev uses on every chain with this version.\";\n\nconst TAPSCORE_NOTES =\n  \"TapScore demo contract used by the game-app template. Verified via eth_getCode.\";\n\nconst PAYMASTER_V1_NOTES =\n  \"RETIRED. The project's first verifying paymaster (PepuVerifyingPaymasterV7). Its EntryPoint \" +\n  \"deposit was withdrawn (deposit is 0), so it cannot sponsor anything. The contract still has \" +\n  \"bytecode; do not deposit to it or route new work to it. Superseded by `paymasterV2`. A real \" +\n  \"sponsored operation ran through the hosted URLs on v1 before retirement (tx \" +\n  \"0x57cf2f5a332248476d775c096b4b8339d81867c14211ed3bc4fcb1895dff0f9f).\";\n\nconst PAYMASTER_V2_NOTES =\n  \"PepuSponsoredPaymasterV7 (v2), deployed on PEPU mainnet as a canary around block 10537341: \" +\n  \"internally reviewed 3x, external audit pending, funded in small tranches. Owner \" +\n  \"0x5966dFaB11c8AEe767e0739083417D02f4a634A1, manager 0x063Ab6C16c38D19A4bC76E7c39A4A0A73afCaBb0. \" +\n  \"Free pool seeded with 300 PEPU; free-tier destinations are TapScore only for now. Free tier per \" +\n  \"user is 100 PEPU/day and 50 PEPU/hour, enforced by the policy service; beyond that a dApp \" +\n  \"deposits into its own project. Record: services/paymaster/contracts/deployed-address-v2.txt.\";\n\nconst PAYMASTER_TESTNET_PENDING_REASON =\n  \"No paymaster (or any other ERC-4337 infrastructure) has been deployed to testnet — see \" +\n  \"TESTNET_AA_PENDING_REASON. The mainnet paymaster is a project-specific deployment, not \" +\n  \"something that would appear on testnet by default even once the rest of the AA stack does.\";\n\nconst TESTNET_AA_PENDING_REASON =\n  \"Account-abstraction contracts were deployed on mainnet (97741) only, \" +\n  \"via ZeroDev's Conduit Marketplace integration. Nothing has been \" +\n  \"deployed to testnet, and testnet is currently out of scope (no faucet \" +\n  \"exists, so it cannot be funded without bridging).\";\n\n/**\n * Contract registry, keyed by chain id. Tracked as independent per-chain\n * entries because deployments happen per-chain and have already diverged:\n * mainnet has the CREATE2 deployer, a PEPU-specific Multicall3, the\n * canonical Permit2, the full ZeroDev Kernel v3 AA stack (EntryPoint\n * v0.6/v0.7, Kernel factory/meta-factory, ECDSA validator), and a\n * project-deployed, funded verifying paymaster. Testnet has only the\n * CREATE2 deployer — everything else is `status: \"pending\"` because\n * testnet is out of scope for this package (no faucet exists to fund\n * verification there).\n *\n * Note on the paymaster specifically: `status: \"deployed\"` here means the\n * contract has live bytecode and a real EntryPoint deposit — it does NOT\n * mean gas sponsorship is usable by an application. See\n * `getSponsorshipStatus` in `./aa/status.js`, which is the single source of\n * truth for that separate question.\n */\nexport const pepuContracts: Readonly<\n  Record<number, PepuContractRegistry>\n> = {\n  [pepuMainnet.id]: {\n    create2Factory: {\n      status: \"deployed\",\n      name: \"CREATE2 Deterministic Deployer\",\n      address: \"0x4e59b44847b379578588920cA78FbF26c0B4956C\",\n      verifiedAt: VERIFIED_AT,\n      notes: \"Standard Nick's-method deterministic deployer.\",\n    },\n    multicall3: {\n      status: \"deployed\",\n      name: \"Multicall3\",\n      address: \"0x9CE19273Ae9c24437DFF512E8DFCAed4E4B001bd\",\n      verifiedAt: VERIFIED_AT,\n      notes: MULTICALL3_MAINNET_NOTES,\n    },\n    permit2: {\n      status: \"deployed\",\n      name: \"Permit2\",\n      address: \"0x000000000022D473030F116dDEE9F6B43aC78BA3\",\n      verifiedAt: VERIFIED_AT,\n      notes: PERMIT2_MAINNET_NOTES,\n    },\n    entryPoint06: {\n      status: \"deployed\",\n      name: \"ERC-4337 EntryPoint v0.6\",\n      address: \"0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES + \" At the canonical v0.6 address.\",\n    },\n    entryPoint07: {\n      status: \"deployed\",\n      name: \"ERC-4337 EntryPoint v0.7\",\n      address: \"0x0000000071727De22E5E9d8BAf0edAc6f37da032\",\n      verifiedAt: VERIFIED_AT,\n      notes:\n        ZERODEV_NOTES +\n        \" At the canonical v0.7 address; getNonce/balanceOf confirmed live.\",\n    },\n    kernelFactory: {\n      status: \"deployed\",\n      name: \"Kernel v3 Account Factory\",\n      address: \"0xaac5D4240AF87249B3f71BC8E4A2cae074A3E419\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES,\n    },\n    kernelMetaFactory: {\n      status: \"deployed\",\n      name: \"Kernel MetaFactory\",\n      address: \"0xd703aaE79538628d27099B8c4f621bE4CCd142d5\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES,\n    },\n    ecdsaValidator: {\n      status: \"deployed\",\n      name: \"Kernel ECDSA Validator\",\n      address: \"0x845ADb2C711129d4f3966735eD98a9F09fC4cE57\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES,\n    },\n    paymaster: {\n      status: \"deployed\",\n      name: \"Sponsored Paymaster v2 (PepuSponsoredPaymasterV7, alias of paymasterV2)\",\n      address: \"0xdb28528C9399C33c9A0297E8A62F39145acbC30D\",\n      verifiedAt: PAYMASTER_V2_VERIFIED_AT,\n      notes: PAYMASTER_MAINNET_NOTES,\n    },\n    kernelImplementation: {\n      status: \"deployed\",\n      name: \"Kernel v3.1 Implementation\",\n      address: \"0xbAC849bB641841b44E965fb01A4Bf5F074F84B4d\",\n      verifiedAt: VERIFIED_AT,\n      notes: KERNEL_IMPL_NOTES,\n    },\n    kernelEcdsaSignerModule: {\n      status: \"deployed\",\n      name: \"Kernel ECDSA Signer (permission signer module)\",\n      address: \"0x6A6F069E2a08c2468e7724Ab3250CdBFBA14D4FF\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES + \" Used as the signer in permission-validator session keys.\",\n    },\n    kernelCallPolicyV004: {\n      status: \"deployed\",\n      name: \"ZeroDev Call Policy v0.0.4\",\n      address: \"0x9a52283276A0ec8740DF50bF01B28A80D880eaf2\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES + \" Scopes a session key to specific targets and selectors.\",\n    },\n    kernelTimestampPolicy: {\n      status: \"deployed\",\n      name: \"ZeroDev Timestamp Policy\",\n      address: \"0xB9f8f524bE6EcD8C945b1b87f9ae5C192FdCE20F\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES + \" Bounds a session key to a validity window.\",\n    },\n    tapScore: {\n      status: \"deployed\",\n      name: \"TapScore\",\n      address: \"0x261eA5971B93237a56990206A46Bc80318e4d078\",\n      verifiedAt: VERIFIED_AT,\n      notes: TAPSCORE_NOTES,\n    },\n    paymasterV1: {\n      status: \"deployed\",\n      name: \"Verifying Paymaster v1 (PepuVerifyingPaymasterV7) - RETIRED\",\n      address: \"0x2B6FED323bFA24f0475f4e1Dd3C7F6Cc1f3ae8B0\",\n      verifiedAt: VERIFIED_AT,\n      retired: true,\n      notes: PAYMASTER_V1_NOTES,\n    },\n    paymasterV2: {\n      status: \"deployed\",\n      name: \"Sponsored Paymaster v2 (PepuSponsoredPaymasterV7), canary\",\n      address: \"0xdb28528C9399C33c9A0297E8A62F39145acbC30D\",\n      verifiedAt: PAYMASTER_V2_VERIFIED_AT,\n      notes: PAYMASTER_V2_NOTES,\n    },\n  },\n  [pepuTestnet.id]: {\n    create2Factory: {\n      status: \"deployed\",\n      name: \"CREATE2 Deterministic Deployer\",\n      address: \"0x4e59b44847b379578588920cA78FbF26c0B4956C\",\n      notes: \"Standard Nick's-method deterministic deployer.\",\n    },\n    multicall3: {\n      status: \"pending\",\n      name: \"Multicall3\",\n      reason: MULTICALL3_PENDING_REASON,\n    },\n    permit2: {\n      status: \"pending\",\n      name: \"Permit2\",\n      reason: PERMIT2_PENDING_REASON,\n    },\n    entryPoint06: {\n      status: \"pending\",\n      name: \"ERC-4337 EntryPoint v0.6\",\n      reason: TESTNET_AA_PENDING_REASON,\n    },\n    entryPoint07: {\n      status: \"pending\",\n      name: \"ERC-4337 EntryPoint v0.7\",\n      reason: TESTNET_AA_PENDING_REASON,\n    },\n    kernelFactory: {\n      status: \"pending\",\n      name: \"Kernel v3 Account Factory\",\n      reason: TESTNET_AA_PENDING_REASON,\n    },\n    kernelMetaFactory: {\n      status: \"pending\",\n      name: \"Kernel MetaFactory\",\n      reason: TESTNET_AA_PENDING_REASON,\n    },\n    ecdsaValidator: {\n      status: \"pending\",\n      name: \"Kernel ECDSA Validator\",\n      reason: TESTNET_AA_PENDING_REASON,\n    },\n    paymaster: {\n      status: \"pending\",\n      name: \"Verifying Paymaster (PepuVerifyingPaymasterV7)\",\n      reason: PAYMASTER_TESTNET_PENDING_REASON,\n    },\n    kernelImplementation: { status: \"pending\", name: \"Kernel v3.1 Implementation\", reason: TESTNET_AA_PENDING_REASON },\n    kernelEcdsaSignerModule: { status: \"pending\", name: \"Kernel ECDSA Signer (permission signer module)\", reason: TESTNET_AA_PENDING_REASON },\n    kernelCallPolicyV004: { status: \"pending\", name: \"ZeroDev Call Policy v0.0.4\", reason: TESTNET_AA_PENDING_REASON },\n    kernelTimestampPolicy: { status: \"pending\", name: \"ZeroDev Timestamp Policy\", reason: TESTNET_AA_PENDING_REASON },\n    tapScore: { status: \"pending\", name: \"TapScore\", reason: \"Deployed on mainnet only.\" },\n    paymasterV1: { status: \"pending\", name: \"Verifying Paymaster v1 (PepuVerifyingPaymasterV7)\", reason: PAYMASTER_TESTNET_PENDING_REASON },\n    paymasterV2: { status: \"pending\", name: \"Verifying Paymaster v2\", reason: PAYMASTER_TESTNET_PENDING_REASON },\n  },\n};\n\n/** Look up one contract entry for a chain id. Returns `undefined` if the chain isn't in the registry. */\nexport function getContract(\n  chainId: number,\n  name: PepuContractName,\n): ContractEntry | undefined {\n  return pepuContracts[chainId]?.[name];\n}\n\n/** List all tracked contract entries for a chain id, in registry order. */\nexport function listContracts(\n  chainId: number,\n): readonly ContractEntry[] {\n  const registry = pepuContracts[chainId];\n  return registry ? Object.values(registry) : [];\n}\n\n/** Narrow a {@link ContractEntry} to {@link DeployedContract}. */\nexport function isDeployed(\n  entry: ContractEntry | undefined,\n): entry is DeployedContract {\n  return entry?.status === \"deployed\";\n}\n\n/** One row of the address table returned by {@link getPepuAddresses}. */\nexport interface PepuAddressRow {\n  readonly key: PepuContractName;\n  readonly name: string;\n  readonly status: \"deployed\" | \"pending\";\n  /** Present only when `status` is `\"deployed\"`. */\n  readonly address?: Address;\n  /** ISO date of the last `eth_getCode` check, when known. */\n  readonly verifiedAt?: string;\n  /** True for a deployed contract that is retired and must not be used (the v1 paymaster). */\n  readonly retired?: true;\n  /** Notes (deployed) or reason (pending). */\n  readonly note: string;\n}\n\n/**\n * The full supporting-contract table for a chain, flattened for docs and\n * MCP rendering. Pending entries carry no `address`.\n *\n * @example\n * ```ts\n * const rows = getPepuAddresses(); // mainnet by default\n * const live = rows.filter((r) => r.status === \"deployed\");\n * ```\n */\nexport function getPepuAddresses(chainId: number = pepuMainnet.id): readonly PepuAddressRow[] {\n  const registry = pepuContracts[chainId];\n  if (!registry) return [];\n  return (Object.keys(registry) as PepuContractName[]).map((key): PepuAddressRow => {\n    const e = registry[key];\n    return e.status === \"deployed\"\n      ? {\n          key,\n          name: e.name,\n          status: \"deployed\",\n          address: e.address,\n          ...(e.verifiedAt ? { verifiedAt: e.verifiedAt } : {}),\n          ...(e.retired ? { retired: true as const } : {}),\n          note: e.notes ?? \"\",\n        }\n      : { key, name: e.name, status: \"pending\", note: e.reason };\n  });\n}\n"]}

package/dist/chunk-KIIFL4VM.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/abi/kernelFactory.ts","../src/abi/entryPointV07.ts","../src/aa/probes.ts","../src/aa/status.ts"],"names":["parseAbi"],"mappings":"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","file":"chunk-KIIFL4VM.js","sourcesContent":["import { parseAbi } from \"viem\";\n\n/**\n * ZeroDev Kernel v3 account factory ABI, at\n * `0xaac5D4240AF87249B3f71BC8E4A2cae074A3E419` (deployed on PEPU mainnet\n * only; see `pepuContracts.kernelFactory` in `../contracts.js`).\n *\n * Verified live against mainnet 2026-09-24 via `eth_call`:\n * - `implementation()` returns `0xbAC849bB641841b44E965fb01A4Bf5F074F84B4d` —\n *   ZeroDev's Kernel v3.1 singleton implementation address, deployed at the\n *   same address on every chain that has it via CREATE2.\n * - `getAddress(bytes,bytes32)`, called with empty `data` and a zero salt,\n *   returns a computed address without reverting.\n * - `createAccount(bytes,bytes32)`, simulated (not sent) with the same\n *   empty `data` and zero salt via `eth_call`, returns the **same** address\n *   `getAddress` computed for those inputs — exactly the counterfactual-\n *   address behavior a CREATE2 account factory is supposed to have.\n *\n * What this package does NOT ship: a helper that encodes the `data`\n * argument (Kernel v3.1's `initialize(...)` calldata — root validator,\n * hook, validator data, hook data, init config). No account has ever been\n * created through this factory on PEPU yet (its transaction history is\n * empty as of the verification date above), so there was nothing on-chain\n * to check a hand-rolled encoding against, and guessing one here would be\n * exactly the kind of invented byte layout this package's rules forbid.\n * Use ZeroDev's own `@zerodev/sdk` (or the public Kernel contracts source)\n * to build that payload, then pass the resulting bytes into\n * `getAddress`/`createAccount` from this ABI.\n */\nexport const kernelFactoryAbi = parseAbi([\n  \"function implementation() view returns (address)\",\n  \"function getAddress(bytes calldata data, bytes32 salt) view returns (address)\",\n  \"function createAccount(bytes calldata data, bytes32 salt) payable returns (address)\",\n]);\n\n/**\n * The verified Kernel v3.1 singleton implementation address that\n * `kernelFactoryAbi`'s `implementation()` resolves to on PEPU mainnet. Same\n * address ZeroDev uses across every chain that has this Kernel version.\n */\nexport const KERNEL_V3_1_IMPLEMENTATION_ADDRESS =\n  \"0xbAC849bB641841b44E965fb01A4Bf5F074F84B4d\" as const;\n","import { parseAbi } from \"viem\";\n\n/**\n * ERC-4337 EntryPoint v0.7 ABI — the subset a dapp actually needs to manage\n * a smart account's gas deposit and read its nonce, at the canonical address\n * `0x0000000071727De22E5E9d8BAf0edAc6f37da032` (deployed on PEPU mainnet\n * only; see `pepuContracts.entryPoint07` in `../contracts.js`).\n *\n * This is NOT the full `IEntryPoint` interface (no `handleOps`,\n * `simulateValidation`, etc.) — those are normally called by a bundler, and\n * PEPU has no publicly hosted bundler yet (see `getSponsorshipStatus` in\n * `../aa/status.js`). This ABI only covers deposit/nonce management, which works\n * today with a plain viem wallet client and no bundler at all.\n *\n * Verified live against mainnet 2026-09-24 via `eth_call`:\n * - `getNonce(address,uint192)` for the zero address/key returns `0`.\n * - `balanceOf(address)` for the zero address returns `0`.\n * - `getDepositInfo(address)` for the zero address returns a 5-word\n *   (all-zero) tuple, matching the v0.7 `DepositInfo` struct shape\n *   `(uint256 deposit, bool staked, uint96 stake, uint32 unstakeDelaySec,\n *   uint48 withdrawTime)` field-for-field.\n * `depositTo`/`withdrawTo` share the same `IStakeManager` interface as the\n * verified `getDepositInfo`/`balanceOf` pair and are standard across every\n * EntryPoint version; they were not separately simulated (both mutate\n * state, and simulating a withdrawal from an empty deposit would only prove\n * it reverts, not that it works).\n */\nexport const entryPointV07Abi = parseAbi([\n  \"function getNonce(address sender, uint192 key) view returns (uint256 nonce)\",\n  \"function balanceOf(address account) view returns (uint256)\",\n  \"function depositTo(address account) payable\",\n  \"function withdrawTo(address payable withdrawAddress, uint256 withdrawAmount)\",\n  \"function getDepositInfo(address account) view returns ((uint256 deposit, bool staked, uint96 stake, uint32 unstakeDelaySec, uint48 withdrawTime) info)\",\n  \"event Deposited(address indexed account, uint256 totalDeposit)\",\n  \"event Withdrawn(address indexed account, address withdrawAddress, uint256 amount)\",\n]);\n","import type { Address, PublicClient } from \"viem\";\n\nimport { entryPointV07Abi } from \"../abi/entryPointV07.js\";\nimport { pepuMainnet } from \"../chains.js\";\nimport { getContract } from \"../contracts.js\";\nimport { PepuBundlerError, PepuConfigError } from \"../errors.js\";\nimport { redactSecrets } from \"./describe.js\";\n\n/** Minimal fetch signature, so tests and non-browser hosts can inject one. */\nexport type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;\n\nexport interface ProbeOptions {\n  fetch?: FetchLike;\n  /** Per-request timeout. Default 8000. */\n  timeoutMs?: number;\n}\n\nexport interface BundlerProbeResult {\n  ok: boolean;\n  chainId?: number;\n  entryPoints?: Address[];\n  /** `true` when the method exists (any answer but \"method not found\"). */\n  supportedMethods?: Record<string, boolean>;\n  latencyMs: number;\n  error?: PepuBundlerError;\n}\n\nexport interface PaymasterProbeResult {\n  ok: boolean;\n  /** `GET <origin>/health` answered `{ status: \"ok\" }`. */\n  health?: boolean;\n  /** Body of `GET <origin>/v2/free-tier` when the service exposes it. */\n  freeTier?: unknown;\n  /**\n   * The URL answered a `pm_getPaymasterStubData` call with a stub result. A\n   * JSON-RPC denial (no credential, unknown sender) is NOT a stub result:\n   * the endpoint is alive and speaks ERC-7677, but the probe has no\n   * credential, so this stays `false`.\n   */\n  erc7677StubOk?: boolean;\n  latencyMs: number;\n  error?: PepuBundlerError;\n}\n\nconst BUNDLER_METHODS = [\n  \"eth_sendUserOperation\",\n  \"eth_estimateUserOperationGas\",\n  \"eth_getUserOperationReceipt\",\n  \"eth_getUserOperationByHash\",\n  \"pimlico_getUserOperationGasPrice\",\n  \"zd_getUserOperationGasPrice\",\n] as const;\n\nconst METHOD_NOT_FOUND = -32601;\n\nfunction hostOf(url: string): string {\n  try {\n    return new URL(url).host;\n  } catch {\n    return \"the configured host\";\n  }\n}\n\nfunction checkUrl(url: string, label: string): void {\n  let u: URL;\n  try {\n    u = new URL(url);\n  } catch {\n    throw new PepuConfigError(\"CONFIG_BAD_URL\", `${label} is not a valid URL.`);\n  }\n  if (u.protocol !== \"http:\" && u.protocol !== \"https:\") {\n    throw new PepuConfigError(\"CONFIG_BAD_URL\", `${label} must be an http(s) URL.`);\n  }\n}\n\nasync function timedFetch(f: FetchLike, url: string, init: RequestInit, timeoutMs: number): Promise<Response> {\n  const ctl = new AbortController();\n  const t = setTimeout(() => ctl.abort(), timeoutMs);\n  try {\n    return await f(url, { ...init, signal: ctl.signal });\n  } finally {\n    clearTimeout(t);\n  }\n}\n\ninterface RpcReply {\n  result?: unknown;\n  error?: { code?: number; message?: string; data?: unknown };\n}\n\nasync function rpc(f: FetchLike, url: string, method: string, params: unknown[], timeoutMs: number): Promise<RpcReply> {\n  const res = await timedFetch(\n    f,\n    url,\n    {\n      method: \"POST\",\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify({ jsonrpc: \"2.0\", id: 1, method, params }),\n    },\n    timeoutMs,\n  );\n  let body: unknown;\n  try {\n    body = await res.json();\n  } catch {\n    throw new Error(`HTTP ${res.status} with a non-JSON body`);\n  }\n  if (!body || typeof body !== \"object\") throw new Error(`HTTP ${res.status} with an unexpected body`);\n  return body as RpcReply;\n}\n\nfunction unreachable(url: string, e: unknown): PepuBundlerError {\n  const reason = e instanceof Error && e.name === \"AbortError\" ? \"timed out\" : redactSecrets(e instanceof Error ? e.message : String(e)).replace(/https?:\\/\\/\\S+/g, \"[url]\");\n  return new PepuBundlerError(\"BUNDLER_UNREACHABLE\", `Could not reach ${hostOf(url)}: ${reason}`, { cause: e });\n}\n\n/**\n * Probe a bundler URL: `eth_chainId`, `eth_supportedEntryPoints` and a\n * capability check of the methods PEPU apps use (a method answered with\n * anything but \"method not found\" counts as supported; nothing is sent\n * on-chain). Never throws for network trouble; returns `ok: false` with a\n * `BUNDLER_UNREACHABLE` error. Throws `CONFIG_BAD_URL` for a malformed URL.\n *\n * @example\n * const r = await probeBundler(\"https://bundler.example.com\");\n * if (!r.ok) console.log(r.error?.hint);\n */\nexport async function probeBundler(url: string, o: ProbeOptions = {}): Promise<BundlerProbeResult> {\n  checkUrl(url, \"Bundler URL\");\n  const f: FetchLike = o.fetch ?? ((i, init) => fetch(i, init));\n  const timeoutMs = o.timeoutMs ?? 8000;\n  const started = Date.now();\n  try {\n    const chain = await rpc(f, url, \"eth_chainId\", [], timeoutMs);\n    const eps = await rpc(f, url, \"eth_supportedEntryPoints\", [], timeoutMs);\n    const chainId = typeof chain.result === \"string\" ? Number(BigInt(chain.result)) : undefined;\n    const entryPoints = Array.isArray(eps.result) ? (eps.result as Address[]) : undefined;\n    const supportedMethods: Record<string, boolean> = {};\n    for (const m of BUNDLER_METHODS) {\n      try {\n        const r = await rpc(f, url, m, [], timeoutMs);\n        supportedMethods[m] = r.error?.code !== METHOD_NOT_FOUND;\n      } catch {\n        supportedMethods[m] = false;\n      }\n    }\n    const ep07 = getContract(pepuMainnet.id, \"entryPoint07\");\n    const want = ep07?.status === \"deployed\" ? ep07.address.toLowerCase() : undefined;\n    const ok =\n      chainId === pepuMainnet.id &&\n      (want === undefined || (entryPoints?.some((a) => a.toLowerCase() === want) ?? false));\n    const out: BundlerProbeResult = { ok, latencyMs: Date.now() - started, supportedMethods };\n    if (chainId !== undefined) out.chainId = chainId;\n    if (entryPoints) out.entryPoints = entryPoints;\n    if (!ok) {\n      out.error = new PepuBundlerError(\n        \"BUNDLER_UNREACHABLE\",\n        chainId !== undefined && chainId !== pepuMainnet.id\n          ? `The bundler serves chain ${chainId}, not ${pepuMainnet.id}.`\n          : \"The bundler does not list EntryPoint v0.7.\",\n        { hint: \"Point PEPU_BUNDLER_URL at a bundler for chain 97741 that supports EntryPoint v0.7.\" },\n      );\n    }\n    return out;\n  } catch (e) {\n    return { ok: false, latencyMs: Date.now() - started, error: unreachable(url, e) };\n  }\n}\n\nconst STUB_PROBE_OP = {\n  sender: \"0x0000000000000000000000000000000000000001\",\n  nonce: \"0x0\",\n  callData: \"0x\",\n  callGasLimit: \"0x0\",\n  verificationGasLimit: \"0x0\",\n  preVerificationGas: \"0x0\",\n  maxFeePerGas: \"0x0\",\n  maxPriorityFeePerGas: \"0x0\",\n  signature: \"0x\",\n} as const;\n\n/**\n * Probe a paymaster URL: the service base (`https://paymaster.pepeunchained.com`) or the ERC-7677 endpoint\n * (`https://host/v2/paymaster/<token>`).\n * Checks `GET <origin>/health`, `GET <origin>/v2/free-tier`, and whether the URL\n * answers JSON-RPC `pm_getPaymasterStubData`. `ok` means the service is alive:\n * health is ok, or the URL spoke valid JSON-RPC. The URL (which can embed a\n * token) never appears in the returned error.\n *\n * @example\n * const r = await probePaymaster(process.env.PEPU_PAYMASTER_URL!);\n * console.log(r.ok, r.freeTier);\n */\nexport async function probePaymaster(url: string, o: ProbeOptions = {}): Promise<PaymasterProbeResult> {\n  checkUrl(url, \"Paymaster URL\");\n  const f: FetchLike = o.fetch ?? ((i, init) => fetch(i, init));\n  const timeoutMs = o.timeoutMs ?? 8000;\n  const started = Date.now();\n  const origin = new URL(url).origin;\n  const out: PaymasterProbeResult = { ok: false, latencyMs: 0 };\n  let reached = false;\n  let lastError: unknown;\n\n  try {\n    const res = await timedFetch(f, `${origin}/health`, { method: \"GET\" }, timeoutMs);\n    reached = true;\n    const body = (await res.json().catch(() => null)) as { status?: unknown } | null;\n    out.health = res.ok && body?.status === \"ok\";\n  } catch (e) {\n    lastError = e;\n    out.health = false;\n  }\n\n  try {\n    const res = await timedFetch(f, `${origin}/v2/free-tier`, { method: \"GET\" }, timeoutMs);\n    reached = true;\n    if (res.ok) out.freeTier = await res.json().catch(() => undefined);\n  } catch (e) {\n    lastError = e;\n  }\n\n  let speaksRpc = false;\n  try {\n    const ep07 = getContract(pepuMainnet.id, \"entryPoint07\");\n    const ep = ep07?.status === \"deployed\" ? ep07.address : \"0x0000000071727De22E5E9d8BAf0edAc6f37da032\";\n    const reply = await rpc(\n      f,\n      url,\n      \"pm_getPaymasterStubData\",\n      [STUB_PROBE_OP, ep, `0x${pepuMainnet.id.toString(16)}`, {}],\n      timeoutMs,\n    );\n    reached = true;\n    speaksRpc = reply.result !== undefined || reply.error !== undefined;\n    out.erc7677StubOk = reply.result !== undefined;\n  } catch (e) {\n    lastError = e;\n    out.erc7677StubOk = false;\n  }\n\n  out.latencyMs = Date.now() - started;\n  out.ok = out.health === true || speaksRpc;\n  if (!reached) out.error = unreachable(url, lastError);\n  else if (!out.ok) {\n    out.error = new PepuBundlerError(\"BUNDLER_UNREACHABLE\", `${hostOf(url)} answered but is not a PEPU paymaster service.`, {\n      hint: \"Check PEPU_PAYMASTER_URL points at the policy service (https://paymaster.pepeunchained.com), or its /v2/paymaster/<client token> endpoint.\",\n    });\n  }\n  return out;\n}\n\n/**\n * The paymaster's EntryPoint v0.7 deposit in wei. A drop across a UserOperation\n * is the proof that it was sponsored. Defaults to PEPU's deployed paymaster.\n *\n * @example\n * const before = await getPaymasterDeposit(publicClient);\n */\nexport async function getPaymasterDeposit(client: PublicClient, paymaster?: Address): Promise<bigint> {\n  const pm = getContract(pepuMainnet.id, \"paymaster\");\n  const ep = getContract(pepuMainnet.id, \"entryPoint07\");\n  const account = paymaster ?? (pm?.status === \"deployed\" ? pm.address : undefined);\n  if (!account || ep?.status !== \"deployed\") {\n    throw new PepuConfigError(\"CONFIG_MISSING_ENV\", \"No paymaster address is known; pass one explicitly.\", {\n      hint: \"Pass the paymaster address as the second argument.\",\n    });\n  }\n  return client.readContract({\n    address: ep.address,\n    abi: entryPointV07Abi,\n    functionName: \"balanceOf\",\n    args: [account],\n  });\n}\n","import type { Address, Hex, PublicClient, Transport } from \"viem\";\n\nimport { kernelFactoryAbi } from \"../abi/kernelFactory.js\";\nimport type { PepuChain } from \"../chains.js\";\nimport type { DeployedContract } from \"../contracts.js\";\nimport { getContract } from \"../contracts.js\";\nimport { PEPU_ENV, resolvePepuEndpoints } from \"../endpoints.js\";\nimport { getPaymasterDeposit, probeBundler, probePaymaster } from \"./probes.js\";\nimport type { BundlerProbeResult, FetchLike, PaymasterProbeResult } from \"./probes.js\";\n\n/**\n * The account-abstraction contracts a Kernel v3 smart account needs,\n * narrowed to their {@link DeployedContract} form for a given chain.\n * Returns `undefined` if any one of them isn't deployed on that chain\n * (today: everything except mainnet, `97741`) — this package never fabricates\n * a partial/best-effort bundle.\n */\nexport interface PepuKernelStack {\n  readonly entryPoint06: DeployedContract;\n  readonly entryPoint07: DeployedContract;\n  readonly kernelFactory: DeployedContract;\n  readonly kernelMetaFactory: DeployedContract;\n  readonly ecdsaValidator: DeployedContract;\n}\n\n/**\n * Look up every AA contract this package knows about for `chainId`, already\n * narrowed to {@link DeployedContract}. Returns `undefined` unless *all* five\n * are deployed on that chain (today, only PEPU mainnet qualifies) — a caller\n * building a Kernel account needs every one of them, so a partial result\n * would just move the \"is this actually usable\" check into every caller.\n *\n * This is a convenience grouping over `getContract` from `./contracts.js`;\n * it doesn't add any address or fact that registry doesn't already have.\n */\nexport function getPepuKernelStack(chainId: number): PepuKernelStack | undefined {\n  const entryPoint06 = getContract(chainId, \"entryPoint06\");\n  const entryPoint07 = getContract(chainId, \"entryPoint07\");\n  const kernelFactory = getContract(chainId, \"kernelFactory\");\n  const kernelMetaFactory = getContract(chainId, \"kernelMetaFactory\");\n  const ecdsaValidator = getContract(chainId, \"ecdsaValidator\");\n\n  if (\n    entryPoint06?.status !== \"deployed\" ||\n    entryPoint07?.status !== \"deployed\" ||\n    kernelFactory?.status !== \"deployed\" ||\n    kernelMetaFactory?.status !== \"deployed\" ||\n    ecdsaValidator?.status !== \"deployed\"\n  ) {\n    return undefined;\n  }\n\n  return { entryPoint06, entryPoint07, kernelFactory, kernelMetaFactory, ecdsaValidator };\n}\n\n/**\n * Legacy static gas-sponsorship status for PEPU. **Always reports\n * unavailable** (it never probes). Sponsorship is PROVEN end to end on PEPU\n * mainnet through the hosted bundler and paymaster service (a zero-balance\n * Kernel smart account transacted, paid for by the paymaster); use\n * `checkSponsorship()` for the live answer. This function\n * exists so nothing downstream (this package, `@pepu-chain/mcp`, an app)\n * has to independently invent an \"is sponsorship on?\" check, and so that\n * check can't silently start lying once this file changes.\n *\n * Do not treat the presence of `kernelFactory`/`ecdsaValidator`/`paymaster`\n * addresses in {@link getPepuKernelStack} / the contract registry as\n * sponsorship support — those let you build and deploy a Kernel account and\n * send its UserOperations through a normal `eth_sendTransaction`-style flow\n * (self-paying its own gas via the EntryPoint deposit), which is a real,\n * working feature; sponsoring that gas needs a funded project or free-tier token.\n */\nexport interface SponsorshipStatus {\n  readonly available: false;\n  readonly reason: string;\n  /**\n   * Extension point for a future bundler/paymaster integration. Passing a\n   * URL here does **not** make sponsorship available — `available` stays\n   * `false` regardless — this field only exists so a caller can start\n   * wiring a URL through their own config today and have this function\n   * start using it later without an API change.\n   */\n  readonly bundlerUrl?: string;\n}\n\n/** Options for {@link getSponsorshipStatus}. */\nexport interface GetSponsorshipStatusOptions {\n  /** See {@link SponsorshipStatus.bundlerUrl}. Not yet used for anything. */\n  readonly bundlerUrl?: string;\n}\n\n/**\n * @deprecated Always reports `available: false`. Use `checkSponsorship()` (live\n * bundler and paymaster probe) from `@pepu-chain/sdk`. Kept for 0.1 callers.\n */\nexport function getSponsorshipStatus(\n  options?: GetSponsorshipStatusOptions,\n): SponsorshipStatus {\n  const reason =\n    \"This deprecated function never probes anything and always reports \" +\n    \"unavailable. The hosted bundler (bundler.pepeunchained.com) and \" +\n    \"paymaster service (paymaster.pepeunchained.com) are live, and \" +\n    \"sponsorship is proven end to end on mainnet through them. Call \" +\n    \"checkSponsorship() for the live status. A Kernel v3 smart account \" +\n    \"without a funded project or free-tier token must still fund its own \" +\n    \"EntryPoint deposit and pay its own gas, like a normal EOA-sent transaction.\";\n  return options?.bundlerUrl === undefined\n    ? { available: false, reason }\n    : { available: false, reason, bundlerUrl: options.bundlerUrl };\n}\n\n/**\n * Compute (or confirm) the counterfactual address of a Kernel v3 smart\n * account via the verified factory's `getAddress(data, salt)` — a thin,\n * typed pass-through, not a re-implementation.\n *\n * Deliberately does **not** build `data` (Kernel v3.1's `initialize(...)`\n * calldata: root validator, hook, validator data, hook data, init config)\n * for you. A hand-rolled encoding here would be a second, unverified copy of\n * the byte layout that ZeroDev's SDK already produces (and that has been\n * exercised against PEPU's factory through the sponsored-transaction run),\n * which is exactly the kind of invented encoding this package's rules\n * forbid for addresses. Build `data` with ZeroDev's\n * `@zerodev/sdk` (or by hand from the public Kernel v3 contracts source),\n * then pass the result here.\n */\nexport async function getKernelAccountAddress(\n  client: PublicClient<Transport, PepuChain>,\n  factory: Pick<DeployedContract, \"address\">,\n  args: { readonly data: Hex; readonly salt: Hex },\n): Promise<Address> {\n  return client.readContract({\n    address: factory.address,\n    abi: kernelFactoryAbi,\n    functionName: \"getAddress\",\n    args: [args.data, args.salt],\n  });\n}\n\n/** Live sponsorship report from {@link checkSponsorship}. */\nexport interface SponsorshipReport {\n  /** True only when a bundler and a paymaster are configured and both answer. */\n  available: boolean;\n  /** `direct` when you bring your own bundler and paymaster URLs; `none` when nothing is configured. */\n  transport: \"direct\" | \"none\";\n  bundler: { configured: boolean; probe?: BundlerProbeResult };\n  paymaster: { configured: boolean; probe?: PaymasterProbeResult; depositWei?: bigint };\n  /** One sentence for a human or an agent. */\n  reason: string;\n  /** Concrete next steps, empty when `available`. */\n  fixes: string[];\n}\n\n/** Options for {@link checkSponsorship}. */\nexport interface CheckSponsorshipOptions {\n  bundlerUrl?: string;\n  paymasterUrl?: string;\n  env?: Record<string, string | undefined>;\n  fetch?: FetchLike;\n  /** When given, also read the paymaster's EntryPoint deposit. */\n  publicClient?: PublicClient;\n  /** Paymaster contract to read the deposit of. Defaults to PEPU's deployed paymaster. */\n  paymasterAddress?: Address;\n  timeoutMs?: number;\n}\n\n/**\n * Live gas-sponsorship status. Resolves the bundler and paymaster URLs from\n * options, env, then the hosted defaults (bundler.pepeunchained.com and the paymaster\n * service base; with no token URL the service is probed at its base), probes both,\n * and optionally reads the paymaster deposit. Never throws for an\n * unreachable service; it reports `available: false` with `fixes`.\n * Replaces the hard-coded {@link getSponsorshipStatus}.\n *\n * @example\n * const s = await checkSponsorship({ publicClient });\n * if (!s.available) console.log(s.reason, s.fixes);\n */\nexport async function checkSponsorship(options: CheckSponsorshipOptions = {}): Promise<SponsorshipReport> {\n  const { bundlerUrl, paymasterUrl: erc7677Url, paymasterBaseUrl } = resolvePepuEndpoints({\n    ...(options.bundlerUrl !== undefined ? { bundlerUrl: options.bundlerUrl } : {}),\n    ...(options.paymasterUrl !== undefined ? { paymasterUrl: options.paymasterUrl } : {}),\n    ...(options.env ? { env: options.env } : {}),\n  });\n  // No token means no complete ERC-7677 URL: probe the service base (health + free-tier state) instead.\n  const paymasterUrl = erc7677Url ?? paymasterBaseUrl;\n  const probeOpts = {\n    ...(options.fetch ? { fetch: options.fetch } : {}),\n    ...(options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {}),\n  };\n  const fixes: string[] = [];\n  if (bundlerUrl === null) fixes.push(`Set ${PEPU_ENV.bundlerUrl} to a bundler for chain 97741 (EntryPoint v0.7).`);\n  if (paymasterUrl === null) fixes.push(`Set ${PEPU_ENV.paymasterUrl} to your ERC-7677 paymaster endpoint (https://paymaster.pepeunchained.com/v2/paymaster/<client token>).`);\n\n  const [bProbe, pProbe] = await Promise.all([\n    bundlerUrl === null ? undefined : probeBundler(bundlerUrl, probeOpts),\n    paymasterUrl === null ? undefined : probePaymaster(paymasterUrl, probeOpts),\n  ]);\n  if (bProbe && !bProbe.ok) fixes.push(bProbe.error?.hint ?? \"The bundler did not answer correctly.\");\n  if (pProbe && !pProbe.ok) fixes.push(pProbe.error?.hint ?? \"The paymaster did not answer correctly.\");\n\n  let depositWei: bigint | undefined;\n  if (options.publicClient) {\n    try {\n      depositWei = await getPaymasterDeposit(options.publicClient, options.paymasterAddress);\n      if (depositWei === 0n) fixes.push(\"The paymaster's EntryPoint deposit is empty. Deposit PEPU to it.\");\n    } catch {\n      // A failed read must not flip availability; the probes are the source of truth.\n    }\n  }\n\n  const available = !!bProbe?.ok && !!pProbe?.ok && depositWei !== 0n;\n  const configured = bundlerUrl !== null || paymasterUrl !== null;\n  const reason = available\n    ? \"Bundler and paymaster are reachable; sponsored UserOperations can be sent.\"\n    : !configured\n      ? \"No bundler or paymaster URL is configured. Set PEPU_BUNDLER_URL and PEPU_PAYMASTER_URL, or use the hosted defaults.\"\n      : \"A bundler or paymaster is configured but not fully working. See fixes.\";\n  return {\n    available,\n    transport: configured ? \"direct\" : \"none\",\n    bundler: { configured: bundlerUrl !== null, ...(bProbe ? { probe: bProbe } : {}) },\n    paymaster: {\n      configured: paymasterUrl !== null,\n      ...(pProbe ? { probe: pProbe } : {}),\n      ...(depositWei !== undefined ? { depositWei } : {}),\n    },\n    reason,\n    fixes,\n  };\n}\n"]}

package/dist/chunk-SLW7FRTL.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/abi/kernelFactory.ts","../src/abi/entryPointV07.ts","../src/aa/probes.ts","../src/aa/status.ts"],"names":["parseAbi","PepuConfigError","redactSecrets","PepuBundlerError","getContract","pepuMainnet","resolvePepuEndpoints","PEPU_ENV"],"mappings":"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","file":"chunk-SLW7FRTL.cjs","sourcesContent":["import { parseAbi } from \"viem\";\n\n/**\n * ZeroDev Kernel v3 account factory ABI, at\n * `0xaac5D4240AF87249B3f71BC8E4A2cae074A3E419` (deployed on PEPU mainnet\n * only; see `pepuContracts.kernelFactory` in `../contracts.js`).\n *\n * Verified live against mainnet 2026-09-24 via `eth_call`:\n * - `implementation()` returns `0xbAC849bB641841b44E965fb01A4Bf5F074F84B4d` —\n *   ZeroDev's Kernel v3.1 singleton implementation address, deployed at the\n *   same address on every chain that has it via CREATE2.\n * - `getAddress(bytes,bytes32)`, called with empty `data` and a zero salt,\n *   returns a computed address without reverting.\n * - `createAccount(bytes,bytes32)`, simulated (not sent) with the same\n *   empty `data` and zero salt via `eth_call`, returns the **same** address\n *   `getAddress` computed for those inputs — exactly the counterfactual-\n *   address behavior a CREATE2 account factory is supposed to have.\n *\n * What this package does NOT ship: a helper that encodes the `data`\n * argument (Kernel v3.1's `initialize(...)` calldata — root validator,\n * hook, validator data, hook data, init config). No account has ever been\n * created through this factory on PEPU yet (its transaction history is\n * empty as of the verification date above), so there was nothing on-chain\n * to check a hand-rolled encoding against, and guessing one here would be\n * exactly the kind of invented byte layout this package's rules forbid.\n * Use ZeroDev's own `@zerodev/sdk` (or the public Kernel contracts source)\n * to build that payload, then pass the resulting bytes into\n * `getAddress`/`createAccount` from this ABI.\n */\nexport const kernelFactoryAbi = parseAbi([\n  \"function implementation() view returns (address)\",\n  \"function getAddress(bytes calldata data, bytes32 salt) view returns (address)\",\n  \"function createAccount(bytes calldata data, bytes32 salt) payable returns (address)\",\n]);\n\n/**\n * The verified Kernel v3.1 singleton implementation address that\n * `kernelFactoryAbi`'s `implementation()` resolves to on PEPU mainnet. Same\n * address ZeroDev uses across every chain that has this Kernel version.\n */\nexport const KERNEL_V3_1_IMPLEMENTATION_ADDRESS =\n  \"0xbAC849bB641841b44E965fb01A4Bf5F074F84B4d\" as const;\n","import { parseAbi } from \"viem\";\n\n/**\n * ERC-4337 EntryPoint v0.7 ABI — the subset a dapp actually needs to manage\n * a smart account's gas deposit and read its nonce, at the canonical address\n * `0x0000000071727De22E5E9d8BAf0edAc6f37da032` (deployed on PEPU mainnet\n * only; see `pepuContracts.entryPoint07` in `../contracts.js`).\n *\n * This is NOT the full `IEntryPoint` interface (no `handleOps`,\n * `simulateValidation`, etc.) — those are normally called by a bundler, and\n * PEPU has no publicly hosted bundler yet (see `getSponsorshipStatus` in\n * `../aa/status.js`). This ABI only covers deposit/nonce management, which works\n * today with a plain viem wallet client and no bundler at all.\n *\n * Verified live against mainnet 2026-09-24 via `eth_call`:\n * - `getNonce(address,uint192)` for the zero address/key returns `0`.\n * - `balanceOf(address)` for the zero address returns `0`.\n * - `getDepositInfo(address)` for the zero address returns a 5-word\n *   (all-zero) tuple, matching the v0.7 `DepositInfo` struct shape\n *   `(uint256 deposit, bool staked, uint96 stake, uint32 unstakeDelaySec,\n *   uint48 withdrawTime)` field-for-field.\n * `depositTo`/`withdrawTo` share the same `IStakeManager` interface as the\n * verified `getDepositInfo`/`balanceOf` pair and are standard across every\n * EntryPoint version; they were not separately simulated (both mutate\n * state, and simulating a withdrawal from an empty deposit would only prove\n * it reverts, not that it works).\n */\nexport const entryPointV07Abi = parseAbi([\n  \"function getNonce(address sender, uint192 key) view returns (uint256 nonce)\",\n  \"function balanceOf(address account) view returns (uint256)\",\n  \"function depositTo(address account) payable\",\n  \"function withdrawTo(address payable withdrawAddress, uint256 withdrawAmount)\",\n  \"function getDepositInfo(address account) view returns ((uint256 deposit, bool staked, uint96 stake, uint32 unstakeDelaySec, uint48 withdrawTime) info)\",\n  \"event Deposited(address indexed account, uint256 totalDeposit)\",\n  \"event Withdrawn(address indexed account, address withdrawAddress, uint256 amount)\",\n]);\n","import type { Address, PublicClient } from \"viem\";\n\nimport { entryPointV07Abi } from \"../abi/entryPointV07.js\";\nimport { pepuMainnet } from \"../chains.js\";\nimport { getContract } from \"../contracts.js\";\nimport { PepuBundlerError, PepuConfigError } from \"../errors.js\";\nimport { redactSecrets } from \"./describe.js\";\n\n/** Minimal fetch signature, so tests and non-browser hosts can inject one. */\nexport type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;\n\nexport interface ProbeOptions {\n  fetch?: FetchLike;\n  /** Per-request timeout. Default 8000. */\n  timeoutMs?: number;\n}\n\nexport interface BundlerProbeResult {\n  ok: boolean;\n  chainId?: number;\n  entryPoints?: Address[];\n  /** `true` when the method exists (any answer but \"method not found\"). */\n  supportedMethods?: Record<string, boolean>;\n  latencyMs: number;\n  error?: PepuBundlerError;\n}\n\nexport interface PaymasterProbeResult {\n  ok: boolean;\n  /** `GET <origin>/health` answered `{ status: \"ok\" }`. */\n  health?: boolean;\n  /** Body of `GET <origin>/v2/free-tier` when the service exposes it. */\n  freeTier?: unknown;\n  /**\n   * The URL answered a `pm_getPaymasterStubData` call with a stub result. A\n   * JSON-RPC denial (no credential, unknown sender) is NOT a stub result:\n   * the endpoint is alive and speaks ERC-7677, but the probe has no\n   * credential, so this stays `false`.\n   */\n  erc7677StubOk?: boolean;\n  latencyMs: number;\n  error?: PepuBundlerError;\n}\n\nconst BUNDLER_METHODS = [\n  \"eth_sendUserOperation\",\n  \"eth_estimateUserOperationGas\",\n  \"eth_getUserOperationReceipt\",\n  \"eth_getUserOperationByHash\",\n  \"pimlico_getUserOperationGasPrice\",\n  \"zd_getUserOperationGasPrice\",\n] as const;\n\nconst METHOD_NOT_FOUND = -32601;\n\nfunction hostOf(url: string): string {\n  try {\n    return new URL(url).host;\n  } catch {\n    return \"the configured host\";\n  }\n}\n\nfunction checkUrl(url: string, label: string): void {\n  let u: URL;\n  try {\n    u = new URL(url);\n  } catch {\n    throw new PepuConfigError(\"CONFIG_BAD_URL\", `${label} is not a valid URL.`);\n  }\n  if (u.protocol !== \"http:\" && u.protocol !== \"https:\") {\n    throw new PepuConfigError(\"CONFIG_BAD_URL\", `${label} must be an http(s) URL.`);\n  }\n}\n\nasync function timedFetch(f: FetchLike, url: string, init: RequestInit, timeoutMs: number): Promise<Response> {\n  const ctl = new AbortController();\n  const t = setTimeout(() => ctl.abort(), timeoutMs);\n  try {\n    return await f(url, { ...init, signal: ctl.signal });\n  } finally {\n    clearTimeout(t);\n  }\n}\n\ninterface RpcReply {\n  result?: unknown;\n  error?: { code?: number; message?: string; data?: unknown };\n}\n\nasync function rpc(f: FetchLike, url: string, method: string, params: unknown[], timeoutMs: number): Promise<RpcReply> {\n  const res = await timedFetch(\n    f,\n    url,\n    {\n      method: \"POST\",\n      headers: { \"content-type\": \"application/json\" },\n      body: JSON.stringify({ jsonrpc: \"2.0\", id: 1, method, params }),\n    },\n    timeoutMs,\n  );\n  let body: unknown;\n  try {\n    body = await res.json();\n  } catch {\n    throw new Error(`HTTP ${res.status} with a non-JSON body`);\n  }\n  if (!body || typeof body !== \"object\") throw new Error(`HTTP ${res.status} with an unexpected body`);\n  return body as RpcReply;\n}\n\nfunction unreachable(url: string, e: unknown): PepuBundlerError {\n  const reason = e instanceof Error && e.name === \"AbortError\" ? \"timed out\" : redactSecrets(e instanceof Error ? e.message : String(e)).replace(/https?:\\/\\/\\S+/g, \"[url]\");\n  return new PepuBundlerError(\"BUNDLER_UNREACHABLE\", `Could not reach ${hostOf(url)}: ${reason}`, { cause: e });\n}\n\n/**\n * Probe a bundler URL: `eth_chainId`, `eth_supportedEntryPoints` and a\n * capability check of the methods PEPU apps use (a method answered with\n * anything but \"method not found\" counts as supported; nothing is sent\n * on-chain). Never throws for network trouble; returns `ok: false` with a\n * `BUNDLER_UNREACHABLE` error. Throws `CONFIG_BAD_URL` for a malformed URL.\n *\n * @example\n * const r = await probeBundler(\"https://bundler.example.com\");\n * if (!r.ok) console.log(r.error?.hint);\n */\nexport async function probeBundler(url: string, o: ProbeOptions = {}): Promise<BundlerProbeResult> {\n  checkUrl(url, \"Bundler URL\");\n  const f: FetchLike = o.fetch ?? ((i, init) => fetch(i, init));\n  const timeoutMs = o.timeoutMs ?? 8000;\n  const started = Date.now();\n  try {\n    const chain = await rpc(f, url, \"eth_chainId\", [], timeoutMs);\n    const eps = await rpc(f, url, \"eth_supportedEntryPoints\", [], timeoutMs);\n    const chainId = typeof chain.result === \"string\" ? Number(BigInt(chain.result)) : undefined;\n    const entryPoints = Array.isArray(eps.result) ? (eps.result as Address[]) : undefined;\n    const supportedMethods: Record<string, boolean> = {};\n    for (const m of BUNDLER_METHODS) {\n      try {\n        const r = await rpc(f, url, m, [], timeoutMs);\n        supportedMethods[m] = r.error?.code !== METHOD_NOT_FOUND;\n      } catch {\n        supportedMethods[m] = false;\n      }\n    }\n    const ep07 = getContract(pepuMainnet.id, \"entryPoint07\");\n    const want = ep07?.status === \"deployed\" ? ep07.address.toLowerCase() : undefined;\n    const ok =\n      chainId === pepuMainnet.id &&\n      (want === undefined || (entryPoints?.some((a) => a.toLowerCase() === want) ?? false));\n    const out: BundlerProbeResult = { ok, latencyMs: Date.now() - started, supportedMethods };\n    if (chainId !== undefined) out.chainId = chainId;\n    if (entryPoints) out.entryPoints = entryPoints;\n    if (!ok) {\n      out.error = new PepuBundlerError(\n        \"BUNDLER_UNREACHABLE\",\n        chainId !== undefined && chainId !== pepuMainnet.id\n          ? `The bundler serves chain ${chainId}, not ${pepuMainnet.id}.`\n          : \"The bundler does not list EntryPoint v0.7.\",\n        { hint: \"Point PEPU_BUNDLER_URL at a bundler for chain 97741 that supports EntryPoint v0.7.\" },\n      );\n    }\n    return out;\n  } catch (e) {\n    return { ok: false, latencyMs: Date.now() - started, error: unreachable(url, e) };\n  }\n}\n\nconst STUB_PROBE_OP = {\n  sender: \"0x0000000000000000000000000000000000000001\",\n  nonce: \"0x0\",\n  callData: \"0x\",\n  callGasLimit: \"0x0\",\n  verificationGasLimit: \"0x0\",\n  preVerificationGas: \"0x0\",\n  maxFeePerGas: \"0x0\",\n  maxPriorityFeePerGas: \"0x0\",\n  signature: \"0x\",\n} as const;\n\n/**\n * Probe a paymaster URL: the service base (`https://paymaster.pepeunchained.com`) or the ERC-7677 endpoint\n * (`https://host/v2/paymaster/<token>`).\n * Checks `GET <origin>/health`, `GET <origin>/v2/free-tier`, and whether the URL\n * answers JSON-RPC `pm_getPaymasterStubData`. `ok` means the service is alive:\n * health is ok, or the URL spoke valid JSON-RPC. The URL (which can embed a\n * token) never appears in the returned error.\n *\n * @example\n * const r = await probePaymaster(process.env.PEPU_PAYMASTER_URL!);\n * console.log(r.ok, r.freeTier);\n */\nexport async function probePaymaster(url: string, o: ProbeOptions = {}): Promise<PaymasterProbeResult> {\n  checkUrl(url, \"Paymaster URL\");\n  const f: FetchLike = o.fetch ?? ((i, init) => fetch(i, init));\n  const timeoutMs = o.timeoutMs ?? 8000;\n  const started = Date.now();\n  const origin = new URL(url).origin;\n  const out: PaymasterProbeResult = { ok: false, latencyMs: 0 };\n  let reached = false;\n  let lastError: unknown;\n\n  try {\n    const res = await timedFetch(f, `${origin}/health`, { method: \"GET\" }, timeoutMs);\n    reached = true;\n    const body = (await res.json().catch(() => null)) as { status?: unknown } | null;\n    out.health = res.ok && body?.status === \"ok\";\n  } catch (e) {\n    lastError = e;\n    out.health = false;\n  }\n\n  try {\n    const res = await timedFetch(f, `${origin}/v2/free-tier`, { method: \"GET\" }, timeoutMs);\n    reached = true;\n    if (res.ok) out.freeTier = await res.json().catch(() => undefined);\n  } catch (e) {\n    lastError = e;\n  }\n\n  let speaksRpc = false;\n  try {\n    const ep07 = getContract(pepuMainnet.id, \"entryPoint07\");\n    const ep = ep07?.status === \"deployed\" ? ep07.address : \"0x0000000071727De22E5E9d8BAf0edAc6f37da032\";\n    const reply = await rpc(\n      f,\n      url,\n      \"pm_getPaymasterStubData\",\n      [STUB_PROBE_OP, ep, `0x${pepuMainnet.id.toString(16)}`, {}],\n      timeoutMs,\n    );\n    reached = true;\n    speaksRpc = reply.result !== undefined || reply.error !== undefined;\n    out.erc7677StubOk = reply.result !== undefined;\n  } catch (e) {\n    lastError = e;\n    out.erc7677StubOk = false;\n  }\n\n  out.latencyMs = Date.now() - started;\n  out.ok = out.health === true || speaksRpc;\n  if (!reached) out.error = unreachable(url, lastError);\n  else if (!out.ok) {\n    out.error = new PepuBundlerError(\"BUNDLER_UNREACHABLE\", `${hostOf(url)} answered but is not a PEPU paymaster service.`, {\n      hint: \"Check PEPU_PAYMASTER_URL points at the policy service (https://paymaster.pepeunchained.com), or its /v2/paymaster/<client token> endpoint.\",\n    });\n  }\n  return out;\n}\n\n/**\n * The paymaster's EntryPoint v0.7 deposit in wei. A drop across a UserOperation\n * is the proof that it was sponsored. Defaults to PEPU's deployed paymaster.\n *\n * @example\n * const before = await getPaymasterDeposit(publicClient);\n */\nexport async function getPaymasterDeposit(client: PublicClient, paymaster?: Address): Promise<bigint> {\n  const pm = getContract(pepuMainnet.id, \"paymaster\");\n  const ep = getContract(pepuMainnet.id, \"entryPoint07\");\n  const account = paymaster ?? (pm?.status === \"deployed\" ? pm.address : undefined);\n  if (!account || ep?.status !== \"deployed\") {\n    throw new PepuConfigError(\"CONFIG_MISSING_ENV\", \"No paymaster address is known; pass one explicitly.\", {\n      hint: \"Pass the paymaster address as the second argument.\",\n    });\n  }\n  return client.readContract({\n    address: ep.address,\n    abi: entryPointV07Abi,\n    functionName: \"balanceOf\",\n    args: [account],\n  });\n}\n","import type { Address, Hex, PublicClient, Transport } from \"viem\";\n\nimport { kernelFactoryAbi } from \"../abi/kernelFactory.js\";\nimport type { PepuChain } from \"../chains.js\";\nimport type { DeployedContract } from \"../contracts.js\";\nimport { getContract } from \"../contracts.js\";\nimport { PEPU_ENV, resolvePepuEndpoints } from \"../endpoints.js\";\nimport { getPaymasterDeposit, probeBundler, probePaymaster } from \"./probes.js\";\nimport type { BundlerProbeResult, FetchLike, PaymasterProbeResult } from \"./probes.js\";\n\n/**\n * The account-abstraction contracts a Kernel v3 smart account needs,\n * narrowed to their {@link DeployedContract} form for a given chain.\n * Returns `undefined` if any one of them isn't deployed on that chain\n * (today: everything except mainnet, `97741`) — this package never fabricates\n * a partial/best-effort bundle.\n */\nexport interface PepuKernelStack {\n  readonly entryPoint06: DeployedContract;\n  readonly entryPoint07: DeployedContract;\n  readonly kernelFactory: DeployedContract;\n  readonly kernelMetaFactory: DeployedContract;\n  readonly ecdsaValidator: DeployedContract;\n}\n\n/**\n * Look up every AA contract this package knows about for `chainId`, already\n * narrowed to {@link DeployedContract}. Returns `undefined` unless *all* five\n * are deployed on that chain (today, only PEPU mainnet qualifies) — a caller\n * building a Kernel account needs every one of them, so a partial result\n * would just move the \"is this actually usable\" check into every caller.\n *\n * This is a convenience grouping over `getContract` from `./contracts.js`;\n * it doesn't add any address or fact that registry doesn't already have.\n */\nexport function getPepuKernelStack(chainId: number): PepuKernelStack | undefined {\n  const entryPoint06 = getContract(chainId, \"entryPoint06\");\n  const entryPoint07 = getContract(chainId, \"entryPoint07\");\n  const kernelFactory = getContract(chainId, \"kernelFactory\");\n  const kernelMetaFactory = getContract(chainId, \"kernelMetaFactory\");\n  const ecdsaValidator = getContract(chainId, \"ecdsaValidator\");\n\n  if (\n    entryPoint06?.status !== \"deployed\" ||\n    entryPoint07?.status !== \"deployed\" ||\n    kernelFactory?.status !== \"deployed\" ||\n    kernelMetaFactory?.status !== \"deployed\" ||\n    ecdsaValidator?.status !== \"deployed\"\n  ) {\n    return undefined;\n  }\n\n  return { entryPoint06, entryPoint07, kernelFactory, kernelMetaFactory, ecdsaValidator };\n}\n\n/**\n * Legacy static gas-sponsorship status for PEPU. **Always reports\n * unavailable** (it never probes). Sponsorship is PROVEN end to end on PEPU\n * mainnet through the hosted bundler and paymaster service (a zero-balance\n * Kernel smart account transacted, paid for by the paymaster); use\n * `checkSponsorship()` for the live answer. This function\n * exists so nothing downstream (this package, `@pepu-chain/mcp`, an app)\n * has to independently invent an \"is sponsorship on?\" check, and so that\n * check can't silently start lying once this file changes.\n *\n * Do not treat the presence of `kernelFactory`/`ecdsaValidator`/`paymaster`\n * addresses in {@link getPepuKernelStack} / the contract registry as\n * sponsorship support — those let you build and deploy a Kernel account and\n * send its UserOperations through a normal `eth_sendTransaction`-style flow\n * (self-paying its own gas via the EntryPoint deposit), which is a real,\n * working feature; sponsoring that gas needs a funded project or free-tier token.\n */\nexport interface SponsorshipStatus {\n  readonly available: false;\n  readonly reason: string;\n  /**\n   * Extension point for a future bundler/paymaster integration. Passing a\n   * URL here does **not** make sponsorship available — `available` stays\n   * `false` regardless — this field only exists so a caller can start\n   * wiring a URL through their own config today and have this function\n   * start using it later without an API change.\n   */\n  readonly bundlerUrl?: string;\n}\n\n/** Options for {@link getSponsorshipStatus}. */\nexport interface GetSponsorshipStatusOptions {\n  /** See {@link SponsorshipStatus.bundlerUrl}. Not yet used for anything. */\n  readonly bundlerUrl?: string;\n}\n\n/**\n * @deprecated Always reports `available: false`. Use `checkSponsorship()` (live\n * bundler and paymaster probe) from `@pepu-chain/sdk`. Kept for 0.1 callers.\n */\nexport function getSponsorshipStatus(\n  options?: GetSponsorshipStatusOptions,\n): SponsorshipStatus {\n  const reason =\n    \"This deprecated function never probes anything and always reports \" +\n    \"unavailable. The hosted bundler (bundler.pepeunchained.com) and \" +\n    \"paymaster service (paymaster.pepeunchained.com) are live, and \" +\n    \"sponsorship is proven end to end on mainnet through them. Call \" +\n    \"checkSponsorship() for the live status. A Kernel v3 smart account \" +\n    \"without a funded project or free-tier token must still fund its own \" +\n    \"EntryPoint deposit and pay its own gas, like a normal EOA-sent transaction.\";\n  return options?.bundlerUrl === undefined\n    ? { available: false, reason }\n    : { available: false, reason, bundlerUrl: options.bundlerUrl };\n}\n\n/**\n * Compute (or confirm) the counterfactual address of a Kernel v3 smart\n * account via the verified factory's `getAddress(data, salt)` — a thin,\n * typed pass-through, not a re-implementation.\n *\n * Deliberately does **not** build `data` (Kernel v3.1's `initialize(...)`\n * calldata: root validator, hook, validator data, hook data, init config)\n * for you. A hand-rolled encoding here would be a second, unverified copy of\n * the byte layout that ZeroDev's SDK already produces (and that has been\n * exercised against PEPU's factory through the sponsored-transaction run),\n * which is exactly the kind of invented encoding this package's rules\n * forbid for addresses. Build `data` with ZeroDev's\n * `@zerodev/sdk` (or by hand from the public Kernel v3 contracts source),\n * then pass the result here.\n */\nexport async function getKernelAccountAddress(\n  client: PublicClient<Transport, PepuChain>,\n  factory: Pick<DeployedContract, \"address\">,\n  args: { readonly data: Hex; readonly salt: Hex },\n): Promise<Address> {\n  return client.readContract({\n    address: factory.address,\n    abi: kernelFactoryAbi,\n    functionName: \"getAddress\",\n    args: [args.data, args.salt],\n  });\n}\n\n/** Live sponsorship report from {@link checkSponsorship}. */\nexport interface SponsorshipReport {\n  /** True only when a bundler and a paymaster are configured and both answer. */\n  available: boolean;\n  /** `direct` when you bring your own bundler and paymaster URLs; `none` when nothing is configured. */\n  transport: \"direct\" | \"none\";\n  bundler: { configured: boolean; probe?: BundlerProbeResult };\n  paymaster: { configured: boolean; probe?: PaymasterProbeResult; depositWei?: bigint };\n  /** One sentence for a human or an agent. */\n  reason: string;\n  /** Concrete next steps, empty when `available`. */\n  fixes: string[];\n}\n\n/** Options for {@link checkSponsorship}. */\nexport interface CheckSponsorshipOptions {\n  bundlerUrl?: string;\n  paymasterUrl?: string;\n  env?: Record<string, string | undefined>;\n  fetch?: FetchLike;\n  /** When given, also read the paymaster's EntryPoint deposit. */\n  publicClient?: PublicClient;\n  /** Paymaster contract to read the deposit of. Defaults to PEPU's deployed paymaster. */\n  paymasterAddress?: Address;\n  timeoutMs?: number;\n}\n\n/**\n * Live gas-sponsorship status. Resolves the bundler and paymaster URLs from\n * options, env, then the hosted defaults (bundler.pepeunchained.com and the paymaster\n * service base; with no token URL the service is probed at its base), probes both,\n * and optionally reads the paymaster deposit. Never throws for an\n * unreachable service; it reports `available: false` with `fixes`.\n * Replaces the hard-coded {@link getSponsorshipStatus}.\n *\n * @example\n * const s = await checkSponsorship({ publicClient });\n * if (!s.available) console.log(s.reason, s.fixes);\n */\nexport async function checkSponsorship(options: CheckSponsorshipOptions = {}): Promise<SponsorshipReport> {\n  const { bundlerUrl, paymasterUrl: erc7677Url, paymasterBaseUrl } = resolvePepuEndpoints({\n    ...(options.bundlerUrl !== undefined ? { bundlerUrl: options.bundlerUrl } : {}),\n    ...(options.paymasterUrl !== undefined ? { paymasterUrl: options.paymasterUrl } : {}),\n    ...(options.env ? { env: options.env } : {}),\n  });\n  // No token means no complete ERC-7677 URL: probe the service base (health + free-tier state) instead.\n  const paymasterUrl = erc7677Url ?? paymasterBaseUrl;\n  const probeOpts = {\n    ...(options.fetch ? { fetch: options.fetch } : {}),\n    ...(options.timeoutMs !== undefined ? { timeoutMs: options.timeoutMs } : {}),\n  };\n  const fixes: string[] = [];\n  if (bundlerUrl === null) fixes.push(`Set ${PEPU_ENV.bundlerUrl} to a bundler for chain 97741 (EntryPoint v0.7).`);\n  if (paymasterUrl === null) fixes.push(`Set ${PEPU_ENV.paymasterUrl} to your ERC-7677 paymaster endpoint (https://paymaster.pepeunchained.com/v2/paymaster/<client token>).`);\n\n  const [bProbe, pProbe] = await Promise.all([\n    bundlerUrl === null ? undefined : probeBundler(bundlerUrl, probeOpts),\n    paymasterUrl === null ? undefined : probePaymaster(paymasterUrl, probeOpts),\n  ]);\n  if (bProbe && !bProbe.ok) fixes.push(bProbe.error?.hint ?? \"The bundler did not answer correctly.\");\n  if (pProbe && !pProbe.ok) fixes.push(pProbe.error?.hint ?? \"The paymaster did not answer correctly.\");\n\n  let depositWei: bigint | undefined;\n  if (options.publicClient) {\n    try {\n      depositWei = await getPaymasterDeposit(options.publicClient, options.paymasterAddress);\n      if (depositWei === 0n) fixes.push(\"The paymaster's EntryPoint deposit is empty. Deposit PEPU to it.\");\n    } catch {\n      // A failed read must not flip availability; the probes are the source of truth.\n    }\n  }\n\n  const available = !!bProbe?.ok && !!pProbe?.ok && depositWei !== 0n;\n  const configured = bundlerUrl !== null || paymasterUrl !== null;\n  const reason = available\n    ? \"Bundler and paymaster are reachable; sponsored UserOperations can be sent.\"\n    : !configured\n      ? \"No bundler or paymaster URL is configured. Set PEPU_BUNDLER_URL and PEPU_PAYMASTER_URL, or use the hosted defaults.\"\n      : \"A bundler or paymaster is configured but not fully working. See fixes.\";\n  return {\n    available,\n    transport: configured ? \"direct\" : \"none\",\n    bundler: { configured: bundlerUrl !== null, ...(bProbe ? { probe: bProbe } : {}) },\n    paymaster: {\n      configured: paymasterUrl !== null,\n      ...(pProbe ? { probe: pProbe } : {}),\n      ...(depositWei !== undefined ? { depositWei } : {}),\n    },\n    reason,\n    fixes,\n  };\n}\n"]}

package/dist/chunk-TIEAZYHF.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/contracts.ts"],"names":["pepuMainnet","pepuTestnet"],"mappings":"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","file":"chunk-TIEAZYHF.cjs","sourcesContent":["import type { Address } from \"viem\";\n\nimport { pepuMainnet, pepuTestnet } from \"./chains.js\";\n\n/**\n * Canonical keys for contracts tracked by this registry. Adding a new key\n * here (and a corresponding entry per chain below) is not a breaking\n * change for consumers that read the registry through {@link getContract}\n * or {@link listContracts}.\n */\nexport type PepuContractName =\n  | \"create2Factory\"\n  | \"multicall3\"\n  | \"permit2\"\n  | \"entryPoint06\"\n  | \"entryPoint07\"\n  | \"kernelFactory\"\n  | \"kernelMetaFactory\"\n  | \"ecdsaValidator\"\n  | \"paymaster\"\n  | \"kernelImplementation\"\n  | \"kernelEcdsaSignerModule\"\n  | \"kernelCallPolicyV004\"\n  | \"kernelTimestampPolicy\"\n  | \"tapScore\"\n  | \"paymasterV1\"\n  | \"paymasterV2\";\n\n/** A contract that is confirmed live on-chain at `address`. */\nexport interface DeployedContract {\n  readonly status: \"deployed\";\n  /** Human-readable name, for logging/UI. */\n  readonly name: string;\n  /** Verified contract address. */\n  readonly address: Address;\n  /** Optional short note, e.g. how the address was verified. */\n  readonly notes?: string;\n  /**\n   * ISO date (YYYY-MM-DD) on which the address was last confirmed to have\n   * bytecode via `eth_getCode` against the PEPU mainnet RPC. Re-run\n   * `node packages/sdk/scripts/live-check.mjs` to refresh.\n   */\n  readonly verifiedAt?: string;\n  /**\n   * True when the contract still has bytecode but must not be used (for example\n   * the v1 paymaster, whose EntryPoint deposit was withdrawn). Never route new\n   * work to a retired contract.\n   */\n  readonly retired?: true;\n}\n\n/**\n * A contract that is not yet deployed on this chain. Deliberately has no\n * `address` field — callers must not be able to accidentally read a\n * placeholder value and treat it as real. Use {@link getContract} /\n * {@link isDeployed} to narrow before reading an address.\n */\nexport interface PendingContract {\n  readonly status: \"pending\";\n  /** Human-readable name, for logging/UI. */\n  readonly name: string;\n  /** Why this contract has no verified address yet. */\n  readonly reason: string;\n}\n\nexport type ContractEntry = DeployedContract | PendingContract;\n\n/** Per-chain contract catalog, keyed by {@link PepuContractName}. */\nexport type PepuContractRegistry = Readonly<\n  Record<PepuContractName, ContractEntry>\n>;\n\nconst MULTICALL3_PENDING_REASON =\n  \"Canonical Multicall3 (0xcA11bde05977b3631167028862bE2a173976CA11) was \" +\n  \"deployed elsewhere via a pre-signed CREATE transaction with a \" +\n  \"1,000,000 gas limit. This Arbitrum Nitro chain needs ~14.3M gas to \" +\n  \"deploy the same bytecode, so that transaction cannot execute here and \" +\n  \"the canonical address is unreachable. A PEPU-specific deployment is \" +\n  \"pending; do not substitute the canonical address.\";\n\nconst MULTICALL3_MAINNET_NOTES =\n  \"PEPU-specific deployment. NOT at the canonical Multicall3 address, \" +\n  \"which is unreachable on this Nitro chain (the canonical pre-signed \" +\n  \"CREATE tx carries a 1,000,000 gas limit; this bytecode needs ~14.3M). \" +\n  \"Deployed from canonical mds1/multicall3 source (solc 0.8.12, optimizer \" +\n  \"10,000,000 runs) via the CREATE2 deterministic deployer with a zero \" +\n  \"salt, so the same source reproduces this address on any chain that has \" +\n  \"that deployer. Verified on pepuscan. viem/wagmi multicall confirmed \" +\n  \"working against it.\";\n\nconst ZERODEV_NOTES =\n  \"Deployed by ZeroDev's one-click Conduit Marketplace integration \" +\n  \"(mainnet only — not present on testnet).\";\n\nconst PERMIT2_PENDING_REASON =\n  \"Not yet deployed on this chain. The CREATE2 deterministic deployer \" +\n  \"needed to reproduce Permit2's canonical address is live, so this is \" +\n  \"unblocked, but no deployment has happened (and been verified) yet.\";\n\nconst PERMIT2_MAINNET_NOTES =\n  \"Deployed at the canonical Permit2 address via the CREATE2 deterministic \" +\n  \"deployer, same as on every other chain that has it. Verified live \" +\n  \"2026-09-24 via eth_getCode (9,152 bytes, matching Permit2's known \" +\n  \"bytecode size) plus a successful DOMAIN_SEPARATOR() eth_call. This is \" +\n  \"the canonical Permit2 — do not confuse it with PepuSwap's own separate \" +\n  \"Permit2 deployment at pepuSwapContracts.permit2NonCanonical in ./dex.js, \" +\n  \"which predates this one and is not interchangeable with it.\";\n\nconst PAYMASTER_MAINNET_NOTES =\n  \"Alias of `paymasterV2`: the tiered PepuSponsoredPaymasterV7 canary (0xdb28...C30D), deployed \" +\n  \"around block 10537341 and funded in small tranches. Internally reviewed 3x, external audit \" +\n  \"pending. Owner 0x5966dFaB11c8AEe767e0739083417D02f4a634A1, manager \" +\n  \"0x063Ab6C16c38D19A4bC76E7c39A4A0A73afCaBb0. The free pool was seeded with 300 PEPU; free-tier \" +\n  \"destinations are TapScore only for now. It sponsors only through the hosted policy service \" +\n  \"(paymaster.pepeunchained.com) with the hosted bundler (bundler.pepeunchained.com). The v1 \" +\n  \"paymaster is retired (see `paymasterV1`).\";\n\n/** Date the mainnet addresses below were last checked with eth_getCode. */\nconst VERIFIED_AT = \"2026-10-02\";\n\n/** Date the v2 paymaster canary was verified live (deployment record: deploy-receipt-v2.json). */\nconst PAYMASTER_V2_VERIFIED_AT = \"2026-10-14\";\n\nconst KERNEL_IMPL_NOTES =\n  ZERODEV_NOTES +\n  \" Kernel v3.1 implementation that kernelFactory.implementation() resolves to; \" +\n  \"same address ZeroDev uses on every chain with this version.\";\n\nconst TAPSCORE_NOTES =\n  \"TapScore demo contract used by the game-app template. Verified via eth_getCode.\";\n\nconst PAYMASTER_V1_NOTES =\n  \"RETIRED. The project's first verifying paymaster (PepuVerifyingPaymasterV7). Its EntryPoint \" +\n  \"deposit was withdrawn (deposit is 0), so it cannot sponsor anything. The contract still has \" +\n  \"bytecode; do not deposit to it or route new work to it. Superseded by `paymasterV2`. A real \" +\n  \"sponsored operation ran through the hosted URLs on v1 before retirement (tx \" +\n  \"0x57cf2f5a332248476d775c096b4b8339d81867c14211ed3bc4fcb1895dff0f9f).\";\n\nconst PAYMASTER_V2_NOTES =\n  \"PepuSponsoredPaymasterV7 (v2), deployed on PEPU mainnet as a canary around block 10537341: \" +\n  \"internally reviewed 3x, external audit pending, funded in small tranches. Owner \" +\n  \"0x5966dFaB11c8AEe767e0739083417D02f4a634A1, manager 0x063Ab6C16c38D19A4bC76E7c39A4A0A73afCaBb0. \" +\n  \"Free pool seeded with 300 PEPU; free-tier destinations are TapScore only for now. Free tier per \" +\n  \"user is 100 PEPU/day and 50 PEPU/hour, enforced by the policy service; beyond that a dApp \" +\n  \"deposits into its own project. Record: services/paymaster/contracts/deployed-address-v2.txt.\";\n\nconst PAYMASTER_TESTNET_PENDING_REASON =\n  \"No paymaster (or any other ERC-4337 infrastructure) has been deployed to testnet — see \" +\n  \"TESTNET_AA_PENDING_REASON. The mainnet paymaster is a project-specific deployment, not \" +\n  \"something that would appear on testnet by default even once the rest of the AA stack does.\";\n\nconst TESTNET_AA_PENDING_REASON =\n  \"Account-abstraction contracts were deployed on mainnet (97741) only, \" +\n  \"via ZeroDev's Conduit Marketplace integration. Nothing has been \" +\n  \"deployed to testnet, and testnet is currently out of scope (no faucet \" +\n  \"exists, so it cannot be funded without bridging).\";\n\n/**\n * Contract registry, keyed by chain id. Tracked as independent per-chain\n * entries because deployments happen per-chain and have already diverged:\n * mainnet has the CREATE2 deployer, a PEPU-specific Multicall3, the\n * canonical Permit2, the full ZeroDev Kernel v3 AA stack (EntryPoint\n * v0.6/v0.7, Kernel factory/meta-factory, ECDSA validator), and a\n * project-deployed, funded verifying paymaster. Testnet has only the\n * CREATE2 deployer — everything else is `status: \"pending\"` because\n * testnet is out of scope for this package (no faucet exists to fund\n * verification there).\n *\n * Note on the paymaster specifically: `status: \"deployed\"` here means the\n * contract has live bytecode and a real EntryPoint deposit — it does NOT\n * mean gas sponsorship is usable by an application. See\n * `getSponsorshipStatus` in `./aa/status.js`, which is the single source of\n * truth for that separate question.\n */\nexport const pepuContracts: Readonly<\n  Record<number, PepuContractRegistry>\n> = {\n  [pepuMainnet.id]: {\n    create2Factory: {\n      status: \"deployed\",\n      name: \"CREATE2 Deterministic Deployer\",\n      address: \"0x4e59b44847b379578588920cA78FbF26c0B4956C\",\n      verifiedAt: VERIFIED_AT,\n      notes: \"Standard Nick's-method deterministic deployer.\",\n    },\n    multicall3: {\n      status: \"deployed\",\n      name: \"Multicall3\",\n      address: \"0x9CE19273Ae9c24437DFF512E8DFCAed4E4B001bd\",\n      verifiedAt: VERIFIED_AT,\n      notes: MULTICALL3_MAINNET_NOTES,\n    },\n    permit2: {\n      status: \"deployed\",\n      name: \"Permit2\",\n      address: \"0x000000000022D473030F116dDEE9F6B43aC78BA3\",\n      verifiedAt: VERIFIED_AT,\n      notes: PERMIT2_MAINNET_NOTES,\n    },\n    entryPoint06: {\n      status: \"deployed\",\n      name: \"ERC-4337 EntryPoint v0.6\",\n      address: \"0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES + \" At the canonical v0.6 address.\",\n    },\n    entryPoint07: {\n      status: \"deployed\",\n      name: \"ERC-4337 EntryPoint v0.7\",\n      address: \"0x0000000071727De22E5E9d8BAf0edAc6f37da032\",\n      verifiedAt: VERIFIED_AT,\n      notes:\n        ZERODEV_NOTES +\n        \" At the canonical v0.7 address; getNonce/balanceOf confirmed live.\",\n    },\n    kernelFactory: {\n      status: \"deployed\",\n      name: \"Kernel v3 Account Factory\",\n      address: \"0xaac5D4240AF87249B3f71BC8E4A2cae074A3E419\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES,\n    },\n    kernelMetaFactory: {\n      status: \"deployed\",\n      name: \"Kernel MetaFactory\",\n      address: \"0xd703aaE79538628d27099B8c4f621bE4CCd142d5\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES,\n    },\n    ecdsaValidator: {\n      status: \"deployed\",\n      name: \"Kernel ECDSA Validator\",\n      address: \"0x845ADb2C711129d4f3966735eD98a9F09fC4cE57\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES,\n    },\n    paymaster: {\n      status: \"deployed\",\n      name: \"Sponsored Paymaster v2 (PepuSponsoredPaymasterV7, alias of paymasterV2)\",\n      address: \"0xdb28528C9399C33c9A0297E8A62F39145acbC30D\",\n      verifiedAt: PAYMASTER_V2_VERIFIED_AT,\n      notes: PAYMASTER_MAINNET_NOTES,\n    },\n    kernelImplementation: {\n      status: \"deployed\",\n      name: \"Kernel v3.1 Implementation\",\n      address: \"0xbAC849bB641841b44E965fb01A4Bf5F074F84B4d\",\n      verifiedAt: VERIFIED_AT,\n      notes: KERNEL_IMPL_NOTES,\n    },\n    kernelEcdsaSignerModule: {\n      status: \"deployed\",\n      name: \"Kernel ECDSA Signer (permission signer module)\",\n      address: \"0x6A6F069E2a08c2468e7724Ab3250CdBFBA14D4FF\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES + \" Used as the signer in permission-validator session keys.\",\n    },\n    kernelCallPolicyV004: {\n      status: \"deployed\",\n      name: \"ZeroDev Call Policy v0.0.4\",\n      address: \"0x9a52283276A0ec8740DF50bF01B28A80D880eaf2\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES + \" Scopes a session key to specific targets and selectors.\",\n    },\n    kernelTimestampPolicy: {\n      status: \"deployed\",\n      name: \"ZeroDev Timestamp Policy\",\n      address: \"0xB9f8f524bE6EcD8C945b1b87f9ae5C192FdCE20F\",\n      verifiedAt: VERIFIED_AT,\n      notes: ZERODEV_NOTES + \" Bounds a session key to a validity window.\",\n    },\n    tapScore: {\n      status: \"deployed\",\n      name: \"TapScore\",\n      address: \"0x261eA5971B93237a56990206A46Bc80318e4d078\",\n      verifiedAt: VERIFIED_AT,\n      notes: TAPSCORE_NOTES,\n    },\n    paymasterV1: {\n      status: \"deployed\",\n      name: \"Verifying Paymaster v1 (PepuVerifyingPaymasterV7) - RETIRED\",\n      address: \"0x2B6FED323bFA24f0475f4e1Dd3C7F6Cc1f3ae8B0\",\n      verifiedAt: VERIFIED_AT,\n      retired: true,\n      notes: PAYMASTER_V1_NOTES,\n    },\n    paymasterV2: {\n      status: \"deployed\",\n      name: \"Sponsored Paymaster v2 (PepuSponsoredPaymasterV7), canary\",\n      address: \"0xdb28528C9399C33c9A0297E8A62F39145acbC30D\",\n      verifiedAt: PAYMASTER_V2_VERIFIED_AT,\n      notes: PAYMASTER_V2_NOTES,\n    },\n  },\n  [pepuTestnet.id]: {\n    create2Factory: {\n      status: \"deployed\",\n      name: \"CREATE2 Deterministic Deployer\",\n      address: \"0x4e59b44847b379578588920cA78FbF26c0B4956C\",\n      notes: \"Standard Nick's-method deterministic deployer.\",\n    },\n    multicall3: {\n      status: \"pending\",\n      name: \"Multicall3\",\n      reason: MULTICALL3_PENDING_REASON,\n    },\n    permit2: {\n      status: \"pending\",\n      name: \"Permit2\",\n      reason: PERMIT2_PENDING_REASON,\n    },\n    entryPoint06: {\n      status: \"pending\",\n      name: \"ERC-4337 EntryPoint v0.6\",\n      reason: TESTNET_AA_PENDING_REASON,\n    },\n    entryPoint07: {\n      status: \"pending\",\n      name: \"ERC-4337 EntryPoint v0.7\",\n      reason: TESTNET_AA_PENDING_REASON,\n    },\n    kernelFactory: {\n      status: \"pending\",\n      name: \"Kernel v3 Account Factory\",\n      reason: TESTNET_AA_PENDING_REASON,\n    },\n    kernelMetaFactory: {\n      status: \"pending\",\n      name: \"Kernel MetaFactory\",\n      reason: TESTNET_AA_PENDING_REASON,\n    },\n    ecdsaValidator: {\n      status: \"pending\",\n      name: \"Kernel ECDSA Validator\",\n      reason: TESTNET_AA_PENDING_REASON,\n    },\n    paymaster: {\n      status: \"pending\",\n      name: \"Verifying Paymaster (PepuVerifyingPaymasterV7)\",\n      reason: PAYMASTER_TESTNET_PENDING_REASON,\n    },\n    kernelImplementation: { status: \"pending\", name: \"Kernel v3.1 Implementation\", reason: TESTNET_AA_PENDING_REASON },\n    kernelEcdsaSignerModule: { status: \"pending\", name: \"Kernel ECDSA Signer (permission signer module)\", reason: TESTNET_AA_PENDING_REASON },\n    kernelCallPolicyV004: { status: \"pending\", name: \"ZeroDev Call Policy v0.0.4\", reason: TESTNET_AA_PENDING_REASON },\n    kernelTimestampPolicy: { status: \"pending\", name: \"ZeroDev Timestamp Policy\", reason: TESTNET_AA_PENDING_REASON },\n    tapScore: { status: \"pending\", name: \"TapScore\", reason: \"Deployed on mainnet only.\" },\n    paymasterV1: { status: \"pending\", name: \"Verifying Paymaster v1 (PepuVerifyingPaymasterV7)\", reason: PAYMASTER_TESTNET_PENDING_REASON },\n    paymasterV2: { status: \"pending\", name: \"Verifying Paymaster v2\", reason: PAYMASTER_TESTNET_PENDING_REASON },\n  },\n};\n\n/** Look up one contract entry for a chain id. Returns `undefined` if the chain isn't in the registry. */\nexport function getContract(\n  chainId: number,\n  name: PepuContractName,\n): ContractEntry | undefined {\n  return pepuContracts[chainId]?.[name];\n}\n\n/** List all tracked contract entries for a chain id, in registry order. */\nexport function listContracts(\n  chainId: number,\n): readonly ContractEntry[] {\n  const registry = pepuContracts[chainId];\n  return registry ? Object.values(registry) : [];\n}\n\n/** Narrow a {@link ContractEntry} to {@link DeployedContract}. */\nexport function isDeployed(\n  entry: ContractEntry | undefined,\n): entry is DeployedContract {\n  return entry?.status === \"deployed\";\n}\n\n/** One row of the address table returned by {@link getPepuAddresses}. */\nexport interface PepuAddressRow {\n  readonly key: PepuContractName;\n  readonly name: string;\n  readonly status: \"deployed\" | \"pending\";\n  /** Present only when `status` is `\"deployed\"`. */\n  readonly address?: Address;\n  /** ISO date of the last `eth_getCode` check, when known. */\n  readonly verifiedAt?: string;\n  /** True for a deployed contract that is retired and must not be used (the v1 paymaster). */\n  readonly retired?: true;\n  /** Notes (deployed) or reason (pending). */\n  readonly note: string;\n}\n\n/**\n * The full supporting-contract table for a chain, flattened for docs and\n * MCP rendering. Pending entries carry no `address`.\n *\n * @example\n * ```ts\n * const rows = getPepuAddresses(); // mainnet by default\n * const live = rows.filter((r) => r.status === \"deployed\");\n * ```\n */\nexport function getPepuAddresses(chainId: number = pepuMainnet.id): readonly PepuAddressRow[] {\n  const registry = pepuContracts[chainId];\n  if (!registry) return [];\n  return (Object.keys(registry) as PepuContractName[]).map((key): PepuAddressRow => {\n    const e = registry[key];\n    return e.status === \"deployed\"\n      ? {\n          key,\n          name: e.name,\n          status: \"deployed\",\n          address: e.address,\n          ...(e.verifiedAt ? { verifiedAt: e.verifiedAt } : {}),\n          ...(e.retired ? { retired: true as const } : {}),\n          note: e.notes ?? \"\",\n        }\n      : { key, name: e.name, status: \"pending\", note: e.reason };\n  });\n}\n"]}