@pepu-chain/sdk 0.0.0-stage → 0.2.0

package/dist/index.cjs

@@ -0,0 +1,802 @@
+'use strict';
+
+var chunkET3P6TX6_cjs = require('./chunk-ET3P6TX6.cjs');
+var chunkSLW7FRTL_cjs = require('./chunk-SLW7FRTL.cjs');
+require('./chunk-WANILJZQ.cjs');
+var chunkTIEAZYHF_cjs = require('./chunk-TIEAZYHF.cjs');
+var chunkC7IC36XS_cjs = require('./chunk-C7IC36XS.cjs');
+var chunk4GINFJO6_cjs = require('./chunk-4GINFJO6.cjs');
+var chunkVF3D6KLQ_cjs = require('./chunk-VF3D6KLQ.cjs');
+var chunkDPCZJLB3_cjs = require('./chunk-DPCZJLB3.cjs');
+var chunkYQL7NISX_cjs = require('./chunk-YQL7NISX.cjs');
+var viem = require('viem');
+
+// src/dex.ts
+var V3_FACTORY_NOTES = "Uniswap V3 core factory. owner() returns a live address; getPool() resolves real WPEPU/USDT pools at multiple fee tiers, and those pools' own token0()/token1() match. Four other PepuSwap contracts (swapRouter02, positionManager, quoterV2, v3Migrator) each read their own factory() immutable and all agree on this exact address.";
+var pepuSwapContracts = {
+  [chunkDPCZJLB3_cjs.pepuMainnet.id]: {
+    v3Factory: {
+      status: "deployed",
+      name: "PepuSwap V3 Factory",
+      address: "0x5984B8BF2d4dB9C0aCB1d7924762e4474D80C807",
+      notes: V3_FACTORY_NOTES
+    },
+    swapRouter02: {
+      status: "deployed",
+      name: "PepuSwap SwapRouter02",
+      address: "0x150c3F0f16C3D9EB34351d7af9c961FeDc97A0fb",
+      notes: "factory() and WETH9() both resolve to the independently-verified v3Factory/WPEPU addresses."
+    },
+    universalRouter: {
+      status: "deployed",
+      name: "PepuSwap UniversalRouter",
+      address: "0x0dE72b751b77d3c74fB96C5fAd0320Cd8d133d36",
+      notes: `No public getters for its configured Permit2/factory addresses (dispatcher contracts don't expose those). Verified instead by simulating execute("0x", [], farFutureDeadline) via eth_call, which returned successfully under the exact UniversalRouter selector.`
+    },
+    positionManager: {
+      status: "deployed",
+      name: "PepuSwap NonfungiblePositionManager",
+      address: "0xe2060CbdE18b5e765c86e5Cd6EE68AF209a9faa7",
+      notes: 'factory() and WETH9() both resolve to the independently-verified v3Factory/WPEPU addresses. LP positions are ERC-721 tokens minted by this contract (pepuscan lists them as "Launchpad V3 Positions NFT" / UNI-V3-POS).'
+    },
+    quoterV2: {
+      status: "deployed",
+      name: "PepuSwap QuoterV2",
+      address: "0xd647b2D80b48e93613Aa6982b85f8909578b4829",
+      notes: "factory() and WETH9() both resolve to the independently-verified v3Factory/WPEPU addresses. Off-chain-quote contract \u2014 call via eth_call/simulateContract only, never send it a real transaction."
+    },
+    tickLens: {
+      status: "deployed",
+      name: "PepuSwap TickLens",
+      address: "0x4EB8aA84c066f9bf210eAfE33B30AE49BfafD9a6",
+      notes: "Stateless (no zero-arg getter to probe). Verified instead by calling getPopulatedTicksInWord() against a real WPEPU/USDT pool at that pool's own current tick-bitmap word; call succeeded."
+    },
+    v3Migrator: {
+      status: "deployed",
+      name: "PepuSwap V3Migrator",
+      address: "0xFE406d6c3fc0BB3a6D195b089eFADfc8658206D5",
+      notes: "factory() and WETH9() both resolve to the independently-verified v3Factory/WPEPU addresses. No dedicated ABI is shipped for this contract in ./abi/ \u2014 only these two getters were checked, which is enough to confirm the address but not enough to type its migration-specific functions. Pair with Uniswap's public V3Migrator ABI if you need those."
+    },
+    v3Staker: {
+      status: "deployed",
+      name: "PepuSwap V3Staker",
+      address: "0x0a875d1C72cb4e1CD61401c3C49f85Df45071f83",
+      notes: `factory() resolves to the independently-verified v3Factory address (this contract has no WETH9() getter \u2014 it's a Uniswap LP incentive-staking contract, unrelated to the general "stake PEPU" product). No dedicated ABI is shipped for it in ./abi/ \u2014 pair with Uniswap's public V3Staker ABI if you need one.`
+    },
+    multicallNonCanonical: {
+      status: "deployed",
+      name: "PepuSwap Multicall (UniswapInterfaceMulticall, non-canonical)",
+      address: "0x927af2a6B76d2d8206d93004463F8C122701383B",
+      notes: "PepuSwap's own multicall contract, NOT Multicall3 and NOT interchangeable with pepuContracts.multicall3. Verified on pepuscan as Uniswap's UniswapInterfaceMulticall (a Multicall2 fork with a different function set/return shape \u2014 see pepuSwapMulticallAbi in ./abi/pepuSwapMulticall.js for the verified ABI and exactly which functions were confirmed live)."
+    },
+    permit2NonCanonical: {
+      status: "deployed",
+      name: "PepuSwap Permit2 (non-canonical)",
+      address: "0xB461c05f76d7f919FF7A3Df2B0D2593F56538b4B",
+      notes: "PepuSwap's own Permit2 deployment, NOT at the canonical Permit2 address and NOT interchangeable with pepuContracts.permit2 (which tracks the canonical Permit2, now deployed on mainnet at 0x000000000022D473030F116dDEE9F6B43aC78BA3 \u2014 see ../contracts.js). Both DOMAIN_SEPARATOR() calls respond live but return different values (different EIP-712 domains, since they're different contracts). See pepuSwapPermit2Abi in ./abi/pepuSwapPermit2.js."
+    }
+  }
+};
+function getPepuSwapContract(chainId, name) {
+  return pepuSwapContracts[chainId]?.[name];
+}
+function listPepuSwapContracts(chainId) {
+  const registry = pepuSwapContracts[chainId];
+  return registry ? Object.values(registry) : [];
+}
+
+// src/tokens.ts
+var pepuTokenList = {
+  name: "Pepe Unchained",
+  timestamp: "2026-10-03T00:00:00.000Z",
+  version: { major: 1, minor: 2, patch: 0 },
+  tokens: [
+    {
+      chainId: chunkDPCZJLB3_cjs.pepuMainnet.id,
+      address: "0xF9Cf4A16d26979b929Be7176bAc4e7084975FCB8",
+      name: "Wrapped Pepe Unchained",
+      symbol: "WPEPU",
+      decimals: 18
+      // Cross-verified across the project's own docs, Blockscout's token
+      // list, and PepuSwap's deployment config, plus an on-chain
+      // `eth_getCode` call and Blockscout's "verified as WETH9" source
+      // match. See `wpepuAbi` in `./abi/wpepu.ts` for the ABI-level
+      // verification (deposit/withdraw/decimals/symbol/name all confirmed
+      // live).
+    },
+    {
+      chainId: chunkDPCZJLB3_cjs.pepuMainnet.id,
+      address: "0x06f69A40C33C5A4Cd038BBE1DA689D4D636Ec448",
+      name: "Tether USD",
+      symbol: "USDT",
+      decimals: 6
+      // Verified live on 2026-09-24: discovered as the non-WPEPU leg of
+      // PepuSwap's WPEPU/USDT 0.3% pool (`0x4bE3Af53800AADE09201654CD76D55063c7bdE70`,
+      // itself returned by the independently-verified `pepuSwapV3FactoryAbi`
+      // `getPool(WPEPU, USDT, 3000)` — see `../dex.ts`), then confirmed
+      // directly against this address via `eth_call`: `name()` ->
+      // "Tether USD", `symbol()` -> "USDT", `decimals()` -> `6`. Note the
+      // 6 decimals (standard for USDT, unlike the 18-decimal PEPU/WPEPU) —
+      // don't reuse `formatPepu`/`formatUnits(x, 18)` for this token.
+    },
+    {
+      chainId: chunkDPCZJLB3_cjs.pepuMainnet.id,
+      address: "0x20fB684Bfc1aBAaD3AceC5712f2Aa30bd494dF74",
+      name: "USD Coin",
+      symbol: "USDC",
+      decimals: 6
+      // Verified live on 2026-10-03 (read-only): `eth_getCode` returns 835
+      // bytes of code, and `eth_call` gives `name()` -> "USD Coin",
+      // `symbol()` -> "USDC", `decimals()` -> `6`. One of the tokens PepuSwap
+      // trades. 6 decimals, like USDT.
+    },
+    {
+      chainId: chunkDPCZJLB3_cjs.pepuMainnet.id,
+      address: "0x7CCC51754216C04D4Bb1210630cCA16e5430Aa70",
+      name: "Wrapped Ether",
+      symbol: "WETH",
+      decimals: 18
+      // Verified live on 2026-10-03 (read-only): `eth_getCode` returns 835
+      // bytes of code, and `eth_call` gives `name()` -> "Wrapped Ether",
+      // `symbol()` -> "WETH", `decimals()` -> `18`. One of the tokens
+      // PepuSwap trades.
+    }
+  ]
+};
+
+// src/pepuscan.ts
+function requireApiUrl(chain) {
+  const apiUrl = chain.blockExplorers?.default.apiUrl;
+  if (!apiUrl) {
+    throw new Error(
+      `createPepuscanClient: no Blockscout API URL configured for chain "${chain.name}" (id ${chain.id}).`
+    );
+  }
+  return apiUrl;
+}
+async function getJsonOrNull(url) {
+  const response = await fetch(url);
+  if (response.status === 404) {
+    return null;
+  }
+  if (!response.ok) {
+    throw new Error(`pepuscan: GET ${url} failed with status ${response.status}`);
+  }
+  return await response.json();
+}
+function createPepuscanClient(chain) {
+  const apiUrl = requireApiUrl(chain);
+  return {
+    async getVerifiedAbi(address) {
+      const body = await getJsonOrNull(
+        `${apiUrl}/v2/smart-contracts/${address}`
+      );
+      return body?.abi ?? null;
+    },
+    async getTokenMetadata(address) {
+      const body = await getJsonOrNull(
+        `${apiUrl}/v2/tokens/${address}`
+      );
+      if (!body) {
+        return null;
+      }
+      return {
+        address,
+        name: body.name ?? null,
+        symbol: body.symbol ?? null,
+        decimals: body.decimals != null ? Number(body.decimals) : null,
+        totalSupply: body.total_supply ?? null,
+        type: body.type ?? null
+      };
+    }
+  };
+}
+function toAddEthereumChainParameter(chain) {
+  const explorerUrl2 = chain.blockExplorers?.default.url;
+  return {
+    chainId: viem.numberToHex(chain.id),
+    chainName: chain.name,
+    nativeCurrency: chain.nativeCurrency,
+    rpcUrls: chain.rpcUrls.default.http,
+    ...explorerUrl2 ? { blockExplorerUrls: [explorerUrl2] } : {}
+  };
+}
+var CHAIN_NOT_RECOGNIZED_ERROR_CODE = 4902;
+function isChainNotRecognizedError(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === CHAIN_NOT_RECOGNIZED_ERROR_CODE;
+}
+async function switchOrAddPepuChain(provider, chain) {
+  try {
+    await provider.request({
+      method: "wallet_switchEthereumChain",
+      params: [{ chainId: viem.numberToHex(chain.id) }]
+    });
+  } catch (error) {
+    if (!isChainNotRecognizedError(error)) {
+      throw error;
+    }
+    await provider.request({
+      method: "wallet_addEthereumChain",
+      params: [toAddEthereumChainParameter(chain)]
+    });
+  }
+}
+var arbGasInfoAbi = viem.parseAbi([
+  "function getPricesInWei() view returns (uint256 perL2Tx, uint256 perL1CalldataUnit, uint256 perStorageAllocation, uint256 perArbGasBase, uint256 perArbGasCongestion, uint256 perArbGasTotal)",
+  "function getL1BaseFeeEstimate() view returns (uint256)",
+  "function getMinimumGasPrice() view returns (uint256)"
+]);
+var ARB_GAS_INFO_ADDRESS = "0x000000000000000000000000000000000000006C";
+
+// src/gas.ts
+async function getNitroFeeBreakdown(client) {
+  const [prices, l1BaseFeeEstimateWei] = await Promise.all([
+    client.readContract({
+      address: ARB_GAS_INFO_ADDRESS,
+      abi: arbGasInfoAbi,
+      functionName: "getPricesInWei"
+    }),
+    client.readContract({
+      address: ARB_GAS_INFO_ADDRESS,
+      abi: arbGasInfoAbi,
+      functionName: "getL1BaseFeeEstimate"
+    })
+  ]);
+  return {
+    l2PricePerGasWei: prices[5],
+    // perArbGasTotal
+    l1PricePerCalldataUnitWei: prices[1],
+    // perL1CalldataUnit
+    l1BaseFeeEstimateWei
+  };
+}
+function explainDualFeeModel() {
+  return {
+    summary: "Arbitrum Nitro chains (PEPU included \u2014 it's an Orbit chain built on Nitro) charge gas as the sum of two independent components, unlike a plain L1 chain where 'gas price' is a single number: an L2 execution fee (compute + storage, priced in the chain's own gas units) and an L1 data-posting fee (the cost of publishing the transaction's calldata back to the settlement layer, priced per byte of calldata, independent of how much EVM computation the transaction does).",
+    l2ExecutionFee: "Works like a normal EVM gas price: gasUsed * pricePerGas, where pricePerGas is ArbGasInfo's perArbGasTotal (perArbGasBase, the network floor, plus perArbGasCongestion, a demand surcharge that's 0 when the chain isn't congested). On PEPU mainnet this floor is 12,500 gwei (12,500,000,000,000 wei) \u2014 see the note on l1DataPostingFee below for why that number looks alarming but isn't.",
+    l1DataPostingFee: "Normally: calldataBytes-derived 'L1 gas units' * perL1CalldataUnit, recovering the cost of posting the tx's data to the settlement layer (L1 for a vanilla Orbit chain, or the Data Availability Committee for an AnyTrust chain like PEPU). Verified live on PEPU mainnet 2026-09-24: both perL1CalldataUnit and getL1BaseFeeEstimate() read 0. That means PEPU is not currently charging a separate L1/DA data fee component at all \u2014 the full cost of a PEPU transaction today is just the L2 execution fee above. This is a live chain parameter, not a protocol guarantee; re-check with getNitroFeeBreakdown() rather than assuming it stays 0 forever.",
+    pepuStatus: "Net effect: a PEPU 'gas price' of 12,500 gwei looks like an Ethereum-mainnet congestion spike if you only know Ethereum's 1-50 gwei range, but PEPU is a low-value token, so the same gas price multiplied out is a tiny PEPU (and USD) amount. Naive gwei formatting misleads on both ends \u2014 the gwei number reads as scary, and formatting a total cost with the same few-decimal-places habit people use for ETH rounds small-but-real PEPU amounts to '0'. Use formatPepu() for totals and formatPepuGasPrice() when you want to show the price-per-gas number with that context attached."
+  };
+}
+async function estimateTransactionCost(client, request) {
+  const [gas, { l2PricePerGasWei }] = await Promise.all([
+    client.estimateGas(request),
+    getNitroFeeBreakdown(client)
+  ]);
+  const costWei = gas * l2PricePerGasWei;
+  return {
+    gas,
+    gasPriceWei: l2PricePerGasWei,
+    costWei,
+    costFormatted: formatPepu(costWei)
+  };
+}
+function formatPepu(wei, options) {
+  const maxDecimals = options?.maxDecimals ?? 8;
+  const suffix = options?.suffix ?? true;
+  const negative = wei < 0n;
+  const full = viem.formatUnits(negative ? -wei : wei, 18);
+  const [whole = "0", fraction = ""] = full.split(".");
+  const truncatedFraction = fraction.slice(0, maxDecimals).replace(/0+$/, "");
+  const body = truncatedFraction.length > 0 ? `${whole}.${truncatedFraction}` : whole;
+  const withSign = negative ? `-${body}` : body;
+  return suffix ? `${withSign} PEPU` : withSign;
+}
+function formatUnitsCompact(value, decimals, maxFractionDigits = 4) {
+  const negative = value < 0n;
+  const [whole = "0", fraction = ""] = viem.formatUnits(negative ? -value : value, decimals).split(".");
+  const frac = fraction.slice(0, maxFractionDigits).replace(/0+$/, "");
+  const body = frac.length > 0 ? `${whole}.${frac}` : whole;
+  return negative && body !== "0" ? `-${body}` : body;
+}
+function formatPepuGasPrice(weiPerGas) {
+  const gwei = viem.formatUnits(weiPerGas, 9);
+  return `${gwei} gwei/gas (PEPU's normal baseline is ~12,500 gwei \u2014 this is not a congestion spike; see explainDualFeeModel())`;
+}
+var DEFAULT_MAX_SEND_MARGIN_BPS = 2e3;
+function assertValidMarginBps(marginBps) {
+  if (!Number.isInteger(marginBps) || marginBps < 0 || marginBps > 1e4) {
+    throw new Error(
+      `maxSendableAmount: marginBps must be an integer between 0 and 10000 (got ${marginBps})`
+    );
+  }
+}
+async function maxSendableAmount(options) {
+  const {
+    client,
+    from,
+    to,
+    balanceWei,
+    marginBps = DEFAULT_MAX_SEND_MARGIN_BPS
+  } = options;
+  assertValidMarginBps(marginBps);
+  if (balanceWei <= 0n) {
+    return {
+      status: "zero-balance",
+      reason: "This wallet has no PEPU to send."
+    };
+  }
+  const estimate = await estimateTransactionCost(client, {
+    account: from,
+    to: to ?? from,
+    value: 1n
+  });
+  const marginWei = estimate.costWei * BigInt(marginBps) / 10000n;
+  const totalReservedWei = estimate.costWei + marginWei;
+  if (balanceWei <= totalReservedWei) {
+    return {
+      status: "insufficient-for-gas",
+      reason: `Balance (${formatPepu(balanceWei)}) doesn't cover the estimated cost of sending plus a safety margin (${formatPepu(totalReservedWei)} would need to be reserved for gas). Add more PEPU before sending.`,
+      estimate,
+      totalReservedWei
+    };
+  }
+  return {
+    status: "ok",
+    amountWei: balanceWei - totalReservedWei,
+    estimate,
+    marginWei,
+    totalReservedWei
+  };
+}
+var kernelEcdsaValidatorAbi = viem.parseAbi([
+  "function ecdsaValidatorStorage(address kernel) view returns (address owner)",
+  "function isModuleType(uint256 moduleTypeId) view returns (bool)",
+  "function isInitialized(address kernel) view returns (bool)",
+  "function onInstall(bytes calldata data) payable",
+  "function onUninstall(bytes calldata data) payable"
+]);
+var ERC7579_MODULE_TYPE = {
+  validator: 1n,
+  executor: 2n,
+  fallback: 3n,
+  hook: 4n
+};
+var pepuSwapMulticallAbi = viem.parseAbi([
+  "function getCurrentBlockTimestamp() view returns (uint256 timestamp)",
+  "function getEthBalance(address addr) view returns (uint256 balance)",
+  "function multicall((address target, uint256 gasLimit, bytes callData)[] calls) returns (uint256 blockNumber, (bool success, uint256 gasUsed, bytes returnData)[] returnData)"
+]);
+var pepuSwapPermit2Abi = viem.parseAbi([
+  "function DOMAIN_SEPARATOR() view returns (bytes32)",
+  "function allowance(address owner, address token, address spender) view returns (uint160 amount, uint48 expiration, uint48 nonce)",
+  "function approve(address token, address spender, uint160 amount, uint48 expiration)"
+]);
+var pepuSwapPositionManagerAbi = [
+  ...viem.erc721Abi,
+  ...viem.parseAbi([
+    "function factory() view returns (address)",
+    "function WETH9() view returns (address)",
+    "function positions(uint256 tokenId) view returns (uint96 nonce, address operator, address token0, address token1, uint24 fee, int24 tickLower, int24 tickUpper, uint128 liquidity, uint256 feeGrowthInside0LastX128, uint256 feeGrowthInside1LastX128, uint128 tokensOwed0, uint128 tokensOwed1)"
+  ])
+];
+var pepuSwapQuoterAbi = viem.parseAbi([
+  "function factory() view returns (address)",
+  "function WETH9() view returns (address)",
+  "function quoteExactInputSingle((address tokenIn, address tokenOut, uint256 amountIn, uint24 fee, uint160 sqrtPriceLimitX96) params) returns (uint256 amountOut, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)",
+  "function quoteExactOutputSingle((address tokenIn, address tokenOut, uint256 amount, uint24 fee, uint160 sqrtPriceLimitX96) params) returns (uint256 amountIn, uint160 sqrtPriceX96After, uint32 initializedTicksCrossed, uint256 gasEstimate)"
+]);
+var pepuSwapRouterAbi = viem.parseAbi([
+  "function factory() view returns (address)",
+  "function WETH9() view returns (address)",
+  "function exactInputSingle((address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96) params) payable returns (uint256 amountOut)",
+  "function exactOutputSingle((address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountOut, uint256 amountInMaximum, uint160 sqrtPriceLimitX96) params) payable returns (uint256 amountIn)",
+  "function multicall(uint256 deadline, bytes[] calldata data) payable returns (bytes[] memory results)"
+]);
+var pepuSwapTickLensAbi = viem.parseAbi([
+  "function getPopulatedTicksInWord(address pool, int16 tickBitmapIndex) view returns ((int24 tick, int128 liquidityNet, uint128 liquidityGross)[] populatedTicks)"
+]);
+var pepuSwapUniversalRouterAbi = viem.parseAbi([
+  "function execute(bytes commands, bytes[] inputs, uint256 deadline) payable"
+]);
+var pepuSwapV3FactoryAbi = viem.parseAbi([
+  "function owner() view returns (address)",
+  "function getPool(address tokenA, address tokenB, uint24 fee) view returns (address pool)",
+  "function feeAmountTickSpacing(uint24 fee) view returns (int24)",
+  "function createPool(address tokenA, address tokenB, uint24 fee) returns (address pool)",
+  "event PoolCreated(address indexed token0, address indexed token1, uint24 indexed fee, int24 tickSpacing, address pool)"
+]);
+var pepuSwapV3PoolAbi = viem.parseAbi([
+  "function token0() view returns (address)",
+  "function token1() view returns (address)",
+  "function fee() view returns (uint24)",
+  "function tickSpacing() view returns (int24)",
+  "function liquidity() view returns (uint128)",
+  "function slot0() view returns (uint160 sqrtPriceX96, int24 tick, uint16 observationIndex, uint16 observationCardinality, uint16 observationCardinalityNext, uint8 feeProtocol, bool unlocked)"
+]);
+var wpepuAbi = [
+  ...viem.erc20Abi,
+  ...viem.parseAbi([
+    "function deposit() payable",
+    "function withdraw(uint256 amount)",
+    "event Deposit(address indexed dst, uint256 amount)",
+    "event Withdrawal(address indexed src, uint256 amount)"
+  ])
+];
+var multicall3Abi = viem.parseAbi([
+  "struct Call3 { address target; bool allowFailure; bytes callData; }",
+  "struct Result { bool success; bytes returnData; }",
+  "function aggregate3(Call3[] calls) payable returns (Result[] returnData)",
+  "function getEthBalance(address addr) view returns (uint256 balance)",
+  "function getBlockNumber() view returns (uint256 blockNumber)",
+  "function getChainId() view returns (uint256)"
+]);
+var permit2Abi = viem.parseAbi([
+  "function DOMAIN_SEPARATOR() view returns (bytes32)",
+  "function allowance(address owner, address token, address spender) view returns (uint160 amount, uint48 expiration, uint48 nonce)",
+  "function approve(address token, address spender, uint160 amount, uint48 expiration)",
+  "function nonceBitmap(address owner, uint256 wordPos) view returns (uint256)",
+  "function invalidateNonces(address token, address spender, uint48 newNonce)"
+]);
+var CANONICAL_MULTICALL3_ADDRESS = "0xcA11bde05977b3631167028862bE2a173976CA11";
+function assertNotCanonicalMulticall3(address) {
+  if (viem.isAddressEqual(address, CANONICAL_MULTICALL3_ADDRESS)) {
+    throw new chunkYQL7NISX_cjs.PepuChainError("MULTICALL3_CANONICAL_ADDRESS");
+  }
+}
+function getMulticall3(chainId = chunkDPCZJLB3_cjs.pepuMainnet.id) {
+  const entry = chunkTIEAZYHF_cjs.getContract(chainId, "multicall3");
+  if (!chunkTIEAZYHF_cjs.isDeployed(entry)) {
+    throw new chunkYQL7NISX_cjs.PepuChainError("UNKNOWN", "Multicall3 is not deployed on the requested chain.");
+  }
+  assertNotCanonicalMulticall3(entry.address);
+  return entry;
+}
+function pepuMulticall(client, calls, o = {}) {
+  const chainId = client.chain?.id ?? chunkDPCZJLB3_cjs.pepuMainnet.id;
+  const multicallAddress = getMulticall3(chainId).address;
+  return client.multicall({
+    contracts: calls,
+    multicallAddress,
+    allowFailure: o.allowFailure ?? true,
+    ...o.blockNumber !== void 0 ? { blockNumber: o.blockNumber } : {}
+  });
+}
+function encodeAggregate3(calls) {
+  return viem.encodeFunctionData({
+    abi: multicall3Abi,
+    functionName: "aggregate3",
+    args: [
+      calls.map((c) => ({
+        target: c.target,
+        allowFailure: c.allowFailure ?? false,
+        callData: c.callData
+      }))
+    ]
+  });
+}
+function decodeAggregate3Result(data) {
+  const out = viem.decodeFunctionResult({
+    abi: multicall3Abi,
+    functionName: "aggregate3",
+    data
+  });
+  return out.map((r) => ({ success: r.success, returnData: r.returnData }));
+}
+
+// src/permit2.ts
+function getPermit2(chainId = chunkDPCZJLB3_cjs.pepuMainnet.id) {
+  const entry = chunkTIEAZYHF_cjs.getContract(chainId, "permit2");
+  if (!chunkTIEAZYHF_cjs.isDeployed(entry)) {
+    throw new chunkYQL7NISX_cjs.PepuChainError("UNKNOWN", "Permit2 is not deployed on the requested chain.");
+  }
+  return entry;
+}
+function permit2Domain(chainId = chunkDPCZJLB3_cjs.pepuMainnet.id) {
+  return {
+    name: "Permit2",
+    chainId,
+    verifyingContract: getPermit2(chainId).address
+  };
+}
+function buildPermitSingleTypedData(p) {
+  return {
+    domain: permit2Domain(p.chainId),
+    types: {
+      PermitSingle: [
+        { name: "details", type: "PermitDetails" },
+        { name: "spender", type: "address" },
+        { name: "sigDeadline", type: "uint256" }
+      ],
+      PermitDetails: [
+        { name: "token", type: "address" },
+        { name: "amount", type: "uint160" },
+        { name: "expiration", type: "uint48" },
+        { name: "nonce", type: "uint48" }
+      ]
+    },
+    primaryType: "PermitSingle",
+    message: {
+      details: {
+        token: p.token,
+        amount: p.amount,
+        expiration: p.expiration,
+        nonce: p.nonce
+      },
+      spender: p.spender,
+      sigDeadline: p.sigDeadline
+    }
+  };
+}
+function buildPermitTransferFromTypedData(p) {
+  return {
+    domain: permit2Domain(p.chainId),
+    types: {
+      PermitTransferFrom: [
+        { name: "permitted", type: "TokenPermissions" },
+        { name: "spender", type: "address" },
+        { name: "nonce", type: "uint256" },
+        { name: "deadline", type: "uint256" }
+      ],
+      TokenPermissions: [
+        { name: "token", type: "address" },
+        { name: "amount", type: "uint256" }
+      ]
+    },
+    primaryType: "PermitTransferFrom",
+    message: {
+      permitted: { token: p.token, amount: p.amount },
+      spender: p.spender,
+      nonce: p.nonce,
+      deadline: p.deadline
+    }
+  };
+}
+async function readPermit2Allowance(client, o) {
+  const [amount, expiration, nonce] = await client.readContract({
+    address: getPermit2(client.chain?.id ?? chunkDPCZJLB3_cjs.pepuMainnet.id).address,
+    abi: permit2Abi,
+    functionName: "allowance",
+    args: [o.owner, o.token, o.spender]
+  });
+  return { amount, expiration, nonce };
+}
+
+Object.defineProperty(exports, "buildPaymasterContext", {
+  enumerable: true,
+  get: function () { return chunkET3P6TX6_cjs.buildPaymasterContext; }
+});
+Object.defineProperty(exports, "buildPaymasterDataRequest", {
+  enumerable: true,
+  get: function () { return chunkET3P6TX6_cjs.buildPaymasterDataRequest; }
+});
+Object.defineProperty(exports, "buildPaymasterStubDataRequest", {
+  enumerable: true,
+  get: function () { return chunkET3P6TX6_cjs.buildPaymasterStubDataRequest; }
+});
+Object.defineProperty(exports, "KERNEL_V3_1_IMPLEMENTATION_ADDRESS", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.KERNEL_V3_1_IMPLEMENTATION_ADDRESS; }
+});
+Object.defineProperty(exports, "checkSponsorship", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.checkSponsorship; }
+});
+Object.defineProperty(exports, "entryPointV07Abi", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.entryPointV07Abi; }
+});
+Object.defineProperty(exports, "getKernelAccountAddress", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.getKernelAccountAddress; }
+});
+Object.defineProperty(exports, "getPepuKernelStack", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.getPepuKernelStack; }
+});
+Object.defineProperty(exports, "getSponsorshipStatus", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.getSponsorshipStatus; }
+});
+Object.defineProperty(exports, "kernelFactoryAbi", {
+  enumerable: true,
+  get: function () { return chunkSLW7FRTL_cjs.kernelFactoryAbi; }
+});
+Object.defineProperty(exports, "getContract", {
+  enumerable: true,
+  get: function () { return chunkTIEAZYHF_cjs.getContract; }
+});
+Object.defineProperty(exports, "getPepuAddresses", {
+  enumerable: true,
+  get: function () { return chunkTIEAZYHF_cjs.getPepuAddresses; }
+});
+Object.defineProperty(exports, "isDeployed", {
+  enumerable: true,
+  get: function () { return chunkTIEAZYHF_cjs.isDeployed; }
+});
+Object.defineProperty(exports, "listContracts", {
+  enumerable: true,
+  get: function () { return chunkTIEAZYHF_cjs.listContracts; }
+});
+Object.defineProperty(exports, "pepuContracts", {
+  enumerable: true,
+  get: function () { return chunkTIEAZYHF_cjs.pepuContracts; }
+});
+Object.defineProperty(exports, "getPublicClient", {
+  enumerable: true,
+  get: function () { return chunkC7IC36XS_cjs.getPublicClient; }
+});
+Object.defineProperty(exports, "addressUrl", {
+  enumerable: true,
+  get: function () { return chunk4GINFJO6_cjs.addressUrl; }
+});
+Object.defineProperty(exports, "blockUrl", {
+  enumerable: true,
+  get: function () { return chunk4GINFJO6_cjs.blockUrl; }
+});
+Object.defineProperty(exports, "explorerLinks", {
+  enumerable: true,
+  get: function () { return chunk4GINFJO6_cjs.explorerLinks; }
+});
+Object.defineProperty(exports, "explorerUrl", {
+  enumerable: true,
+  get: function () { return chunk4GINFJO6_cjs.explorerUrl; }
+});
+Object.defineProperty(exports, "tokenUrl", {
+  enumerable: true,
+  get: function () { return chunk4GINFJO6_cjs.tokenUrl; }
+});
+Object.defineProperty(exports, "txUrl", {
+  enumerable: true,
+  get: function () { return chunk4GINFJO6_cjs.txUrl; }
+});
+Object.defineProperty(exports, "PEPU_ENV", {
+  enumerable: true,
+  get: function () { return chunkVF3D6KLQ_cjs.PEPU_ENV; }
+});
+Object.defineProperty(exports, "PEPU_HOSTED", {
+  enumerable: true,
+  get: function () { return chunkVF3D6KLQ_cjs.PEPU_HOSTED; }
+});
+Object.defineProperty(exports, "PEPU_PUBLIC_ENV", {
+  enumerable: true,
+  get: function () { return chunkVF3D6KLQ_cjs.PEPU_PUBLIC_ENV; }
+});
+Object.defineProperty(exports, "hostedFreeTierUrl", {
+  enumerable: true,
+  get: function () { return chunkVF3D6KLQ_cjs.hostedFreeTierUrl; }
+});
+Object.defineProperty(exports, "isHostedSponsorshipLive", {
+  enumerable: true,
+  get: function () { return chunkVF3D6KLQ_cjs.isHostedSponsorshipLive; }
+});
+Object.defineProperty(exports, "paymasterBaseOf", {
+  enumerable: true,
+  get: function () { return chunkVF3D6KLQ_cjs.paymasterBaseOf; }
+});
+Object.defineProperty(exports, "resolvePepuEndpoints", {
+  enumerable: true,
+  get: function () { return chunkVF3D6KLQ_cjs.resolvePepuEndpoints; }
+});
+Object.defineProperty(exports, "isPepuChain", {
+  enumerable: true,
+  get: function () { return chunkDPCZJLB3_cjs.isPepuChain; }
+});
+Object.defineProperty(exports, "pepuChains", {
+  enumerable: true,
+  get: function () { return chunkDPCZJLB3_cjs.pepuChains; }
+});
+Object.defineProperty(exports, "pepuMainnet", {
+  enumerable: true,
+  get: function () { return chunkDPCZJLB3_cjs.pepuMainnet; }
+});
+Object.defineProperty(exports, "pepuTestnet", {
+  enumerable: true,
+  get: function () { return chunkDPCZJLB3_cjs.pepuTestnet; }
+});
+Object.defineProperty(exports, "PEPU_ERRORS_DOCS_URL", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.PEPU_ERRORS_DOCS_URL; }
+});
+Object.defineProperty(exports, "PEPU_ERROR_CATALOG", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.PEPU_ERROR_CATALOG; }
+});
+Object.defineProperty(exports, "PepuAuthError", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.PepuAuthError; }
+});
+Object.defineProperty(exports, "PepuBundlerError", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.PepuBundlerError; }
+});
+Object.defineProperty(exports, "PepuChainError", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.PepuChainError; }
+});
+Object.defineProperty(exports, "PepuConfigError", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.PepuConfigError; }
+});
+Object.defineProperty(exports, "PepuError", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.PepuError; }
+});
+Object.defineProperty(exports, "PepuPaymasterError", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.PepuPaymasterError; }
+});
+Object.defineProperty(exports, "PepuPolicyError", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.PepuPolicyError; }
+});
+Object.defineProperty(exports, "PepuSessionError", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.PepuSessionError; }
+});
+Object.defineProperty(exports, "errorDocsUrl", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.errorDocsUrl; }
+});
+Object.defineProperty(exports, "explainError", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.explainError; }
+});
+Object.defineProperty(exports, "getErrorEntry", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.getErrorEntry; }
+});
+Object.defineProperty(exports, "toErrorBody", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.toErrorBody; }
+});
+Object.defineProperty(exports, "toErrorResponse", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.toErrorResponse; }
+});
+Object.defineProperty(exports, "toPepuError", {
+  enumerable: true,
+  get: function () { return chunkYQL7NISX_cjs.toPepuError; }
+});
+Object.defineProperty(exports, "erc20Abi", {
+  enumerable: true,
+  get: function () { return viem.erc20Abi; }
+});
+Object.defineProperty(exports, "erc721Abi", {
+  enumerable: true,
+  get: function () { return viem.erc721Abi; }
+});
+exports.ARB_GAS_INFO_ADDRESS = ARB_GAS_INFO_ADDRESS;
+exports.CANONICAL_MULTICALL3_ADDRESS = CANONICAL_MULTICALL3_ADDRESS;
+exports.DEFAULT_MAX_SEND_MARGIN_BPS = DEFAULT_MAX_SEND_MARGIN_BPS;
+exports.ERC7579_MODULE_TYPE = ERC7579_MODULE_TYPE;
+exports.arbGasInfoAbi = arbGasInfoAbi;
+exports.assertNotCanonicalMulticall3 = assertNotCanonicalMulticall3;
+exports.buildPermitSingleTypedData = buildPermitSingleTypedData;
+exports.buildPermitTransferFromTypedData = buildPermitTransferFromTypedData;
+exports.createPepuscanClient = createPepuscanClient;
+exports.decodeAggregate3Result = decodeAggregate3Result;
+exports.encodeAggregate3 = encodeAggregate3;
+exports.estimateTransactionCost = estimateTransactionCost;
+exports.explainDualFeeModel = explainDualFeeModel;
+exports.formatPepu = formatPepu;
+exports.formatPepuGasPrice = formatPepuGasPrice;
+exports.formatUnitsCompact = formatUnitsCompact;
+exports.getMulticall3 = getMulticall3;
+exports.getNitroFeeBreakdown = getNitroFeeBreakdown;
+exports.getPepuSwapContract = getPepuSwapContract;
+exports.getPermit2 = getPermit2;
+exports.kernelEcdsaValidatorAbi = kernelEcdsaValidatorAbi;
+exports.listPepuSwapContracts = listPepuSwapContracts;
+exports.maxSendableAmount = maxSendableAmount;
+exports.multicall3Abi = multicall3Abi;
+exports.pepuMulticall = pepuMulticall;
+exports.pepuSwapContracts = pepuSwapContracts;
+exports.pepuSwapMulticallAbi = pepuSwapMulticallAbi;
+exports.pepuSwapPermit2Abi = pepuSwapPermit2Abi;
+exports.pepuSwapPositionManagerAbi = pepuSwapPositionManagerAbi;
+exports.pepuSwapQuoterAbi = pepuSwapQuoterAbi;
+exports.pepuSwapRouterAbi = pepuSwapRouterAbi;
+exports.pepuSwapTickLensAbi = pepuSwapTickLensAbi;
+exports.pepuSwapUniversalRouterAbi = pepuSwapUniversalRouterAbi;
+exports.pepuSwapV3FactoryAbi = pepuSwapV3FactoryAbi;
+exports.pepuSwapV3PoolAbi = pepuSwapV3PoolAbi;
+exports.pepuTokenList = pepuTokenList;
+exports.permit2Abi = permit2Abi;
+exports.permit2Domain = permit2Domain;
+exports.readPermit2Allowance = readPermit2Allowance;
+exports.switchOrAddPepuChain = switchOrAddPepuChain;
+exports.toAddEthereumChainParameter = toAddEthereumChainParameter;
+exports.wpepuAbi = wpepuAbi;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map