@pepu-chain/sdk 0.0.0-stage → 0.2.1

package/dist/chunk-K7JSQPZO.cjs

@@ -0,0 +1,231 @@
+'use strict';
+
+var chunkDPCZJLB3_cjs = require('./chunk-DPCZJLB3.cjs');
+
+// src/contracts.ts
+var MULTICALL3_PENDING_REASON = "Canonical Multicall3 (0xcA11bde05977b3631167028862bE2a173976CA11) was deployed elsewhere via a pre-signed CREATE transaction with a 1,000,000 gas limit. This Arbitrum Nitro chain needs ~14.3M gas to deploy the same bytecode, so that transaction cannot execute here and the canonical address is unreachable. A PEPU-specific deployment is pending; do not substitute the canonical address.";
+var MULTICALL3_MAINNET_NOTES = "PEPU-specific deployment. NOT at the canonical Multicall3 address, which is unreachable on this Nitro chain (the canonical pre-signed CREATE tx carries a 1,000,000 gas limit; this bytecode needs ~14.3M). Deployed from canonical mds1/multicall3 source (solc 0.8.12, optimizer 10,000,000 runs) via the CREATE2 deterministic deployer with a zero salt, so the same source reproduces this address on any chain that has that deployer. Verified on pepuscan. viem/wagmi multicall confirmed working against it.";
+var ZERODEV_NOTES = "Deployed by ZeroDev's one-click Conduit Marketplace integration (mainnet only \u2014 not present on testnet).";
+var PERMIT2_PENDING_REASON = "Not yet deployed on this chain. The CREATE2 deterministic deployer needed to reproduce Permit2's canonical address is live, so this is unblocked, but no deployment has happened (and been verified) yet.";
+var PERMIT2_MAINNET_NOTES = "Deployed at the canonical Permit2 address via the CREATE2 deterministic deployer, same as on every other chain that has it. Verified live 2026-09-24 via eth_getCode (9,152 bytes, matching Permit2's known bytecode size) plus a successful DOMAIN_SEPARATOR() eth_call. This is the canonical Permit2 \u2014 do not confuse it with PepuSwap's own separate Permit2 deployment at pepuSwapContracts.permit2NonCanonical in ./dex.js, which predates this one and is not interchangeable with it.";
+var PAYMASTER_MAINNET_NOTES = "Alias of `paymasterV2`: the tiered PepuSponsoredPaymasterV7 canary (0xdb28...C30D), deployed around block 10537341 and funded in small tranches. Internally reviewed 3x, external audit pending. Owner 0x5966dFaB11c8AEe767e0739083417D02f4a634A1, manager 0x063Ab6C16c38D19A4bC76E7c39A4A0A73afCaBb0. The free pool was seeded with 300 PEPU; free-tier destinations are TapScore only for now. It sponsors only through the hosted policy service (paymaster.pepeunchained.com) with the hosted bundler (bundler.pepeunchained.com). The v1 paymaster is retired (see `paymasterV1`).";
+var VERIFIED_AT = "2026-10-02";
+var PAYMASTER_V2_VERIFIED_AT = "2026-10-14";
+var KERNEL_IMPL_NOTES = ZERODEV_NOTES + " Kernel v3.1 implementation that kernelFactory.implementation() resolves to; same address ZeroDev uses on every chain with this version.";
+var TAPSCORE_NOTES = "TapScore demo contract used by the game-app template. Verified via eth_getCode.";
+var PAYMASTER_V1_NOTES = "RETIRED. The project's first verifying paymaster (PepuVerifyingPaymasterV7). Its EntryPoint deposit was withdrawn (deposit is 0), so it cannot sponsor anything. The contract still has bytecode; do not deposit to it or route new work to it. Superseded by `paymasterV2`. A real sponsored operation ran through the hosted URLs on v1 before retirement (tx 0x57cf2f5a332248476d775c096b4b8339d81867c14211ed3bc4fcb1895dff0f9f).";
+var PAYMASTER_V2_NOTES = "PepuSponsoredPaymasterV7 (v2), deployed on PEPU mainnet as a canary around block 10537341: internally reviewed 3x, external audit pending, funded in small tranches. Owner 0x5966dFaB11c8AEe767e0739083417D02f4a634A1, manager 0x063Ab6C16c38D19A4bC76E7c39A4A0A73afCaBb0. Free pool seeded with 300 PEPU; free-tier destinations are TapScore only for now. Free tier per user is 100 PEPU/day and 50 PEPU/hour, enforced by the policy service; beyond that a dApp deposits into its own project. Record: services/paymaster/contracts/deployed-address-v2.txt.";
+var PAYMASTER_TESTNET_PENDING_REASON = "No paymaster (or any other ERC-4337 infrastructure) has been deployed to testnet \u2014 see TESTNET_AA_PENDING_REASON. The mainnet paymaster is a project-specific deployment, not something that would appear on testnet by default even once the rest of the AA stack does.";
+var TESTNET_AA_PENDING_REASON = "Account-abstraction contracts were deployed on mainnet (97741) only, via ZeroDev's Conduit Marketplace integration. Nothing has been deployed to testnet, and testnet is currently out of scope (no faucet exists, so it cannot be funded without bridging).";
+var pepuContracts = {
+  [chunkDPCZJLB3_cjs.pepuMainnet.id]: {
+    create2Factory: {
+      status: "deployed",
+      name: "CREATE2 Deterministic Deployer",
+      address: "0x4e59b44847b379578588920cA78FbF26c0B4956C",
+      verifiedAt: VERIFIED_AT,
+      notes: "Standard Nick's-method deterministic deployer."
+    },
+    multicall3: {
+      status: "deployed",
+      name: "Multicall3",
+      address: "0x9CE19273Ae9c24437DFF512E8DFCAed4E4B001bd",
+      verifiedAt: VERIFIED_AT,
+      notes: MULTICALL3_MAINNET_NOTES
+    },
+    permit2: {
+      status: "deployed",
+      name: "Permit2",
+      address: "0x000000000022D473030F116dDEE9F6B43aC78BA3",
+      verifiedAt: VERIFIED_AT,
+      notes: PERMIT2_MAINNET_NOTES
+    },
+    entryPoint06: {
+      status: "deployed",
+      name: "ERC-4337 EntryPoint v0.6",
+      address: "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES + " At the canonical v0.6 address."
+    },
+    entryPoint07: {
+      status: "deployed",
+      name: "ERC-4337 EntryPoint v0.7",
+      address: "0x0000000071727De22E5E9d8BAf0edAc6f37da032",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES + " At the canonical v0.7 address; getNonce/balanceOf confirmed live."
+    },
+    kernelFactory: {
+      status: "deployed",
+      name: "Kernel v3 Account Factory",
+      address: "0xaac5D4240AF87249B3f71BC8E4A2cae074A3E419",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES
+    },
+    kernelMetaFactory: {
+      status: "deployed",
+      name: "Kernel MetaFactory",
+      address: "0xd703aaE79538628d27099B8c4f621bE4CCd142d5",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES
+    },
+    ecdsaValidator: {
+      status: "deployed",
+      name: "Kernel ECDSA Validator",
+      address: "0x845ADb2C711129d4f3966735eD98a9F09fC4cE57",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES
+    },
+    paymaster: {
+      status: "deployed",
+      name: "Sponsored Paymaster v2 (PepuSponsoredPaymasterV7, alias of paymasterV2)",
+      address: "0xdb28528C9399C33c9A0297E8A62F39145acbC30D",
+      verifiedAt: PAYMASTER_V2_VERIFIED_AT,
+      notes: PAYMASTER_MAINNET_NOTES
+    },
+    kernelImplementation: {
+      status: "deployed",
+      name: "Kernel v3.1 Implementation",
+      address: "0xbAC849bB641841b44E965fb01A4Bf5F074F84B4d",
+      verifiedAt: VERIFIED_AT,
+      notes: KERNEL_IMPL_NOTES
+    },
+    kernelEcdsaSignerModule: {
+      status: "deployed",
+      name: "Kernel ECDSA Signer (permission signer module)",
+      address: "0x6A6F069E2a08c2468e7724Ab3250CdBFBA14D4FF",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES + " Used as the signer in permission-validator session keys."
+    },
+    kernelCallPolicyV004: {
+      status: "deployed",
+      name: "ZeroDev Call Policy v0.0.4",
+      address: "0x9a52283276A0ec8740DF50bF01B28A80D880eaf2",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES + " Scopes a session key to specific targets and selectors."
+    },
+    kernelTimestampPolicy: {
+      status: "deployed",
+      name: "ZeroDev Timestamp Policy",
+      address: "0xB9f8f524bE6EcD8C945b1b87f9ae5C192FdCE20F",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES + " Bounds a session key to a validity window."
+    },
+    tapScore: {
+      status: "deployed",
+      name: "TapScore",
+      address: "0x261eA5971B93237a56990206A46Bc80318e4d078",
+      verifiedAt: VERIFIED_AT,
+      notes: TAPSCORE_NOTES
+    },
+    paymasterV1: {
+      status: "deployed",
+      name: "Verifying Paymaster v1 (PepuVerifyingPaymasterV7) - RETIRED",
+      address: "0x2B6FED323bFA24f0475f4e1Dd3C7F6Cc1f3ae8B0",
+      verifiedAt: VERIFIED_AT,
+      retired: true,
+      notes: PAYMASTER_V1_NOTES
+    },
+    paymasterV2: {
+      status: "deployed",
+      name: "Sponsored Paymaster v2 (PepuSponsoredPaymasterV7), canary",
+      address: "0xdb28528C9399C33c9A0297E8A62F39145acbC30D",
+      verifiedAt: PAYMASTER_V2_VERIFIED_AT,
+      notes: PAYMASTER_V2_NOTES
+    }
+  },
+  [chunkDPCZJLB3_cjs.pepuTestnet.id]: {
+    create2Factory: {
+      status: "deployed",
+      name: "CREATE2 Deterministic Deployer",
+      address: "0x4e59b44847b379578588920cA78FbF26c0B4956C",
+      notes: "Standard Nick's-method deterministic deployer."
+    },
+    multicall3: {
+      status: "pending",
+      name: "Multicall3",
+      reason: MULTICALL3_PENDING_REASON
+    },
+    permit2: {
+      status: "pending",
+      name: "Permit2",
+      reason: PERMIT2_PENDING_REASON
+    },
+    entryPoint06: {
+      status: "pending",
+      name: "ERC-4337 EntryPoint v0.6",
+      reason: TESTNET_AA_PENDING_REASON
+    },
+    entryPoint07: {
+      status: "pending",
+      name: "ERC-4337 EntryPoint v0.7",
+      reason: TESTNET_AA_PENDING_REASON
+    },
+    kernelFactory: {
+      status: "pending",
+      name: "Kernel v3 Account Factory",
+      reason: TESTNET_AA_PENDING_REASON
+    },
+    kernelMetaFactory: {
+      status: "pending",
+      name: "Kernel MetaFactory",
+      reason: TESTNET_AA_PENDING_REASON
+    },
+    ecdsaValidator: {
+      status: "pending",
+      name: "Kernel ECDSA Validator",
+      reason: TESTNET_AA_PENDING_REASON
+    },
+    paymaster: {
+      status: "pending",
+      name: "Verifying Paymaster (PepuVerifyingPaymasterV7)",
+      reason: PAYMASTER_TESTNET_PENDING_REASON
+    },
+    kernelImplementation: { status: "pending", name: "Kernel v3.1 Implementation", reason: TESTNET_AA_PENDING_REASON },
+    kernelEcdsaSignerModule: { status: "pending", name: "Kernel ECDSA Signer (permission signer module)", reason: TESTNET_AA_PENDING_REASON },
+    kernelCallPolicyV004: { status: "pending", name: "ZeroDev Call Policy v0.0.4", reason: TESTNET_AA_PENDING_REASON },
+    kernelTimestampPolicy: { status: "pending", name: "ZeroDev Timestamp Policy", reason: TESTNET_AA_PENDING_REASON },
+    tapScore: { status: "pending", name: "TapScore", reason: "Deployed on mainnet only." },
+    paymasterV1: { status: "pending", name: "Verifying Paymaster v1 (PepuVerifyingPaymasterV7)", reason: PAYMASTER_TESTNET_PENDING_REASON },
+    paymasterV2: { status: "pending", name: "Verifying Paymaster v2", reason: PAYMASTER_TESTNET_PENDING_REASON }
+  }
+};
+function getContract(chainId, name) {
+  return pepuContracts[chainId]?.[name];
+}
+function listContracts(chainId) {
+  const registry = pepuContracts[chainId];
+  return registry ? Object.values(registry) : [];
+}
+function isDeployed(entry) {
+  return entry?.status === "deployed";
+}
+function getPepuAddresses(chainId = chunkDPCZJLB3_cjs.pepuMainnet.id) {
+  const registry = pepuContracts[chainId];
+  if (!registry) return [];
+  return Object.keys(registry).map((key) => {
+    const e = registry[key];
+    return e.status === "deployed" ? {
+      key,
+      name: e.name,
+      status: "deployed",
+      address: e.address,
+      ...e.verifiedAt ? { verifiedAt: e.verifiedAt } : {},
+      ...e.retired ? { retired: true } : {},
+      note: e.notes ?? ""
+    } : { key, name: e.name, status: "pending", note: e.reason };
+  });
+}
+function getPepuAddressMap(chainId = chunkDPCZJLB3_cjs.pepuMainnet.id) {
+  const out = {};
+  for (const row of getPepuAddresses(chainId)) out[row.key] = row;
+  return out;
+}
+
+exports.getContract = getContract;
+exports.getPepuAddressMap = getPepuAddressMap;
+exports.getPepuAddresses = getPepuAddresses;
+exports.isDeployed = isDeployed;
+exports.listContracts = listContracts;
+exports.pepuContracts = pepuContracts;
+//# sourceMappingURL=chunk-K7JSQPZO.cjs.map
+//# sourceMappingURL=chunk-K7JSQPZO.cjs.map

package/dist/chunk-K7JSQPZO.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contracts.ts"],"names":["pepuMainnet","pepuTestnet"],"mappings":"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","file":"chunk-K7JSQPZO.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. **Returns an ARRAY of rows** (one {@link PepuAddressRow} per\n * contract, each carrying its own `key`), not an object keyed by contract name:\n * `getPepuAddresses().paymaster` is `undefined`. To look one contract up by name use\n * {@link getContract}, or {@link getPepuAddressMap} for the same rows keyed by name.\n * Pending entries carry no `address`.\n *\n * @example\n * ```ts\n * const rows = getPepuAddresses(); // PepuAddressRow[], mainnet by default\n * const live = rows.filter((r) => r.status === \"deployed\");\n * const paymaster = rows.find((r) => r.key === \"paymaster\");\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\n/**\n * The same rows as {@link getPepuAddresses}, keyed by contract name instead of\n * returned as an array. An unknown chain yields an empty object.\n *\n * @example\n * ```ts\n * const map = getPepuAddressMap();\n * map.paymaster?.address; // Address | undefined\n * ```\n */\nexport function getPepuAddressMap(chainId: number = pepuMainnet.id): Partial<Record<PepuContractName, PepuAddressRow>> {\n  const out: Partial<Record<PepuContractName, PepuAddressRow>> = {};\n  for (const row of getPepuAddresses(chainId)) out[row.key] = row;\n  return out;\n}\n"]}

package/dist/chunk-KJYNF5KH.js

@@ -0,0 +1,224 @@
+import { pepuTestnet, pepuMainnet } from './chunk-VTQIHMF3.js';
+
+// src/contracts.ts
+var MULTICALL3_PENDING_REASON = "Canonical Multicall3 (0xcA11bde05977b3631167028862bE2a173976CA11) was deployed elsewhere via a pre-signed CREATE transaction with a 1,000,000 gas limit. This Arbitrum Nitro chain needs ~14.3M gas to deploy the same bytecode, so that transaction cannot execute here and the canonical address is unreachable. A PEPU-specific deployment is pending; do not substitute the canonical address.";
+var MULTICALL3_MAINNET_NOTES = "PEPU-specific deployment. NOT at the canonical Multicall3 address, which is unreachable on this Nitro chain (the canonical pre-signed CREATE tx carries a 1,000,000 gas limit; this bytecode needs ~14.3M). Deployed from canonical mds1/multicall3 source (solc 0.8.12, optimizer 10,000,000 runs) via the CREATE2 deterministic deployer with a zero salt, so the same source reproduces this address on any chain that has that deployer. Verified on pepuscan. viem/wagmi multicall confirmed working against it.";
+var ZERODEV_NOTES = "Deployed by ZeroDev's one-click Conduit Marketplace integration (mainnet only \u2014 not present on testnet).";
+var PERMIT2_PENDING_REASON = "Not yet deployed on this chain. The CREATE2 deterministic deployer needed to reproduce Permit2's canonical address is live, so this is unblocked, but no deployment has happened (and been verified) yet.";
+var PERMIT2_MAINNET_NOTES = "Deployed at the canonical Permit2 address via the CREATE2 deterministic deployer, same as on every other chain that has it. Verified live 2026-09-24 via eth_getCode (9,152 bytes, matching Permit2's known bytecode size) plus a successful DOMAIN_SEPARATOR() eth_call. This is the canonical Permit2 \u2014 do not confuse it with PepuSwap's own separate Permit2 deployment at pepuSwapContracts.permit2NonCanonical in ./dex.js, which predates this one and is not interchangeable with it.";
+var PAYMASTER_MAINNET_NOTES = "Alias of `paymasterV2`: the tiered PepuSponsoredPaymasterV7 canary (0xdb28...C30D), deployed around block 10537341 and funded in small tranches. Internally reviewed 3x, external audit pending. Owner 0x5966dFaB11c8AEe767e0739083417D02f4a634A1, manager 0x063Ab6C16c38D19A4bC76E7c39A4A0A73afCaBb0. The free pool was seeded with 300 PEPU; free-tier destinations are TapScore only for now. It sponsors only through the hosted policy service (paymaster.pepeunchained.com) with the hosted bundler (bundler.pepeunchained.com). The v1 paymaster is retired (see `paymasterV1`).";
+var VERIFIED_AT = "2026-10-02";
+var PAYMASTER_V2_VERIFIED_AT = "2026-10-14";
+var KERNEL_IMPL_NOTES = ZERODEV_NOTES + " Kernel v3.1 implementation that kernelFactory.implementation() resolves to; same address ZeroDev uses on every chain with this version.";
+var TAPSCORE_NOTES = "TapScore demo contract used by the game-app template. Verified via eth_getCode.";
+var PAYMASTER_V1_NOTES = "RETIRED. The project's first verifying paymaster (PepuVerifyingPaymasterV7). Its EntryPoint deposit was withdrawn (deposit is 0), so it cannot sponsor anything. The contract still has bytecode; do not deposit to it or route new work to it. Superseded by `paymasterV2`. A real sponsored operation ran through the hosted URLs on v1 before retirement (tx 0x57cf2f5a332248476d775c096b4b8339d81867c14211ed3bc4fcb1895dff0f9f).";
+var PAYMASTER_V2_NOTES = "PepuSponsoredPaymasterV7 (v2), deployed on PEPU mainnet as a canary around block 10537341: internally reviewed 3x, external audit pending, funded in small tranches. Owner 0x5966dFaB11c8AEe767e0739083417D02f4a634A1, manager 0x063Ab6C16c38D19A4bC76E7c39A4A0A73afCaBb0. Free pool seeded with 300 PEPU; free-tier destinations are TapScore only for now. Free tier per user is 100 PEPU/day and 50 PEPU/hour, enforced by the policy service; beyond that a dApp deposits into its own project. Record: services/paymaster/contracts/deployed-address-v2.txt.";
+var PAYMASTER_TESTNET_PENDING_REASON = "No paymaster (or any other ERC-4337 infrastructure) has been deployed to testnet \u2014 see TESTNET_AA_PENDING_REASON. The mainnet paymaster is a project-specific deployment, not something that would appear on testnet by default even once the rest of the AA stack does.";
+var TESTNET_AA_PENDING_REASON = "Account-abstraction contracts were deployed on mainnet (97741) only, via ZeroDev's Conduit Marketplace integration. Nothing has been deployed to testnet, and testnet is currently out of scope (no faucet exists, so it cannot be funded without bridging).";
+var pepuContracts = {
+  [pepuMainnet.id]: {
+    create2Factory: {
+      status: "deployed",
+      name: "CREATE2 Deterministic Deployer",
+      address: "0x4e59b44847b379578588920cA78FbF26c0B4956C",
+      verifiedAt: VERIFIED_AT,
+      notes: "Standard Nick's-method deterministic deployer."
+    },
+    multicall3: {
+      status: "deployed",
+      name: "Multicall3",
+      address: "0x9CE19273Ae9c24437DFF512E8DFCAed4E4B001bd",
+      verifiedAt: VERIFIED_AT,
+      notes: MULTICALL3_MAINNET_NOTES
+    },
+    permit2: {
+      status: "deployed",
+      name: "Permit2",
+      address: "0x000000000022D473030F116dDEE9F6B43aC78BA3",
+      verifiedAt: VERIFIED_AT,
+      notes: PERMIT2_MAINNET_NOTES
+    },
+    entryPoint06: {
+      status: "deployed",
+      name: "ERC-4337 EntryPoint v0.6",
+      address: "0x5FF137D4b0FDCD49DcA30c7CF57E578a026d2789",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES + " At the canonical v0.6 address."
+    },
+    entryPoint07: {
+      status: "deployed",
+      name: "ERC-4337 EntryPoint v0.7",
+      address: "0x0000000071727De22E5E9d8BAf0edAc6f37da032",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES + " At the canonical v0.7 address; getNonce/balanceOf confirmed live."
+    },
+    kernelFactory: {
+      status: "deployed",
+      name: "Kernel v3 Account Factory",
+      address: "0xaac5D4240AF87249B3f71BC8E4A2cae074A3E419",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES
+    },
+    kernelMetaFactory: {
+      status: "deployed",
+      name: "Kernel MetaFactory",
+      address: "0xd703aaE79538628d27099B8c4f621bE4CCd142d5",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES
+    },
+    ecdsaValidator: {
+      status: "deployed",
+      name: "Kernel ECDSA Validator",
+      address: "0x845ADb2C711129d4f3966735eD98a9F09fC4cE57",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES
+    },
+    paymaster: {
+      status: "deployed",
+      name: "Sponsored Paymaster v2 (PepuSponsoredPaymasterV7, alias of paymasterV2)",
+      address: "0xdb28528C9399C33c9A0297E8A62F39145acbC30D",
+      verifiedAt: PAYMASTER_V2_VERIFIED_AT,
+      notes: PAYMASTER_MAINNET_NOTES
+    },
+    kernelImplementation: {
+      status: "deployed",
+      name: "Kernel v3.1 Implementation",
+      address: "0xbAC849bB641841b44E965fb01A4Bf5F074F84B4d",
+      verifiedAt: VERIFIED_AT,
+      notes: KERNEL_IMPL_NOTES
+    },
+    kernelEcdsaSignerModule: {
+      status: "deployed",
+      name: "Kernel ECDSA Signer (permission signer module)",
+      address: "0x6A6F069E2a08c2468e7724Ab3250CdBFBA14D4FF",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES + " Used as the signer in permission-validator session keys."
+    },
+    kernelCallPolicyV004: {
+      status: "deployed",
+      name: "ZeroDev Call Policy v0.0.4",
+      address: "0x9a52283276A0ec8740DF50bF01B28A80D880eaf2",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES + " Scopes a session key to specific targets and selectors."
+    },
+    kernelTimestampPolicy: {
+      status: "deployed",
+      name: "ZeroDev Timestamp Policy",
+      address: "0xB9f8f524bE6EcD8C945b1b87f9ae5C192FdCE20F",
+      verifiedAt: VERIFIED_AT,
+      notes: ZERODEV_NOTES + " Bounds a session key to a validity window."
+    },
+    tapScore: {
+      status: "deployed",
+      name: "TapScore",
+      address: "0x261eA5971B93237a56990206A46Bc80318e4d078",
+      verifiedAt: VERIFIED_AT,
+      notes: TAPSCORE_NOTES
+    },
+    paymasterV1: {
+      status: "deployed",
+      name: "Verifying Paymaster v1 (PepuVerifyingPaymasterV7) - RETIRED",
+      address: "0x2B6FED323bFA24f0475f4e1Dd3C7F6Cc1f3ae8B0",
+      verifiedAt: VERIFIED_AT,
+      retired: true,
+      notes: PAYMASTER_V1_NOTES
+    },
+    paymasterV2: {
+      status: "deployed",
+      name: "Sponsored Paymaster v2 (PepuSponsoredPaymasterV7), canary",
+      address: "0xdb28528C9399C33c9A0297E8A62F39145acbC30D",
+      verifiedAt: PAYMASTER_V2_VERIFIED_AT,
+      notes: PAYMASTER_V2_NOTES
+    }
+  },
+  [pepuTestnet.id]: {
+    create2Factory: {
+      status: "deployed",
+      name: "CREATE2 Deterministic Deployer",
+      address: "0x4e59b44847b379578588920cA78FbF26c0B4956C",
+      notes: "Standard Nick's-method deterministic deployer."
+    },
+    multicall3: {
+      status: "pending",
+      name: "Multicall3",
+      reason: MULTICALL3_PENDING_REASON
+    },
+    permit2: {
+      status: "pending",
+      name: "Permit2",
+      reason: PERMIT2_PENDING_REASON
+    },
+    entryPoint06: {
+      status: "pending",
+      name: "ERC-4337 EntryPoint v0.6",
+      reason: TESTNET_AA_PENDING_REASON
+    },
+    entryPoint07: {
+      status: "pending",
+      name: "ERC-4337 EntryPoint v0.7",
+      reason: TESTNET_AA_PENDING_REASON
+    },
+    kernelFactory: {
+      status: "pending",
+      name: "Kernel v3 Account Factory",
+      reason: TESTNET_AA_PENDING_REASON
+    },
+    kernelMetaFactory: {
+      status: "pending",
+      name: "Kernel MetaFactory",
+      reason: TESTNET_AA_PENDING_REASON
+    },
+    ecdsaValidator: {
+      status: "pending",
+      name: "Kernel ECDSA Validator",
+      reason: TESTNET_AA_PENDING_REASON
+    },
+    paymaster: {
+      status: "pending",
+      name: "Verifying Paymaster (PepuVerifyingPaymasterV7)",
+      reason: PAYMASTER_TESTNET_PENDING_REASON
+    },
+    kernelImplementation: { status: "pending", name: "Kernel v3.1 Implementation", reason: TESTNET_AA_PENDING_REASON },
+    kernelEcdsaSignerModule: { status: "pending", name: "Kernel ECDSA Signer (permission signer module)", reason: TESTNET_AA_PENDING_REASON },
+    kernelCallPolicyV004: { status: "pending", name: "ZeroDev Call Policy v0.0.4", reason: TESTNET_AA_PENDING_REASON },
+    kernelTimestampPolicy: { status: "pending", name: "ZeroDev Timestamp Policy", reason: TESTNET_AA_PENDING_REASON },
+    tapScore: { status: "pending", name: "TapScore", reason: "Deployed on mainnet only." },
+    paymasterV1: { status: "pending", name: "Verifying Paymaster v1 (PepuVerifyingPaymasterV7)", reason: PAYMASTER_TESTNET_PENDING_REASON },
+    paymasterV2: { status: "pending", name: "Verifying Paymaster v2", reason: PAYMASTER_TESTNET_PENDING_REASON }
+  }
+};
+function getContract(chainId, name) {
+  return pepuContracts[chainId]?.[name];
+}
+function listContracts(chainId) {
+  const registry = pepuContracts[chainId];
+  return registry ? Object.values(registry) : [];
+}
+function isDeployed(entry) {
+  return entry?.status === "deployed";
+}
+function getPepuAddresses(chainId = pepuMainnet.id) {
+  const registry = pepuContracts[chainId];
+  if (!registry) return [];
+  return Object.keys(registry).map((key) => {
+    const e = registry[key];
+    return e.status === "deployed" ? {
+      key,
+      name: e.name,
+      status: "deployed",
+      address: e.address,
+      ...e.verifiedAt ? { verifiedAt: e.verifiedAt } : {},
+      ...e.retired ? { retired: true } : {},
+      note: e.notes ?? ""
+    } : { key, name: e.name, status: "pending", note: e.reason };
+  });
+}
+function getPepuAddressMap(chainId = pepuMainnet.id) {
+  const out = {};
+  for (const row of getPepuAddresses(chainId)) out[row.key] = row;
+  return out;
+}
+
+export { getContract, getPepuAddressMap, getPepuAddresses, isDeployed, listContracts, pepuContracts };
+//# sourceMappingURL=chunk-KJYNF5KH.js.map
+//# sourceMappingURL=chunk-KJYNF5KH.js.map

package/dist/chunk-KJYNF5KH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/contracts.ts"],"names":[],"mappings":"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","file":"chunk-KJYNF5KH.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. **Returns an ARRAY of rows** (one {@link PepuAddressRow} per\n * contract, each carrying its own `key`), not an object keyed by contract name:\n * `getPepuAddresses().paymaster` is `undefined`. To look one contract up by name use\n * {@link getContract}, or {@link getPepuAddressMap} for the same rows keyed by name.\n * Pending entries carry no `address`.\n *\n * @example\n * ```ts\n * const rows = getPepuAddresses(); // PepuAddressRow[], mainnet by default\n * const live = rows.filter((r) => r.status === \"deployed\");\n * const paymaster = rows.find((r) => r.key === \"paymaster\");\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\n/**\n * The same rows as {@link getPepuAddresses}, keyed by contract name instead of\n * returned as an array. An unknown chain yields an empty object.\n *\n * @example\n * ```ts\n * const map = getPepuAddressMap();\n * map.paymaster?.address; // Address | undefined\n * ```\n */\nexport function getPepuAddressMap(chainId: number = pepuMainnet.id): Partial<Record<PepuContractName, PepuAddressRow>> {\n  const out: Partial<Record<PepuContractName, PepuAddressRow>> = {};\n  for (const row of getPepuAddresses(chainId)) out[row.key] = row;\n  return out;\n}\n"]}