@aastar/sdk 0.24.1 → 0.25.0

package/dist/UserClient-5PQP6APK.js

@@ -0,0 +1,6 @@
+export { UserClient } from './chunk-IG4BG25C.js';
+import './chunk-6DZCDV4Q.js';
+import './chunk-MBWBHKUE.js';
+import './chunk-PZ5AY32C.js';
+//# sourceMappingURL=UserClient-5PQP6APK.js.map
+//# sourceMappingURL=UserClient-5PQP6APK.js.map

package/dist/{UserClient-KYDCMAIU.js.map → UserClient-5PQP6APK.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"UserClient-KYDCMAIU.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"UserClient-5PQP6APK.js"}

package/dist/UserClient-CD7R3335.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkJ3UAXGNP_cjs = require('./chunk-J3UAXGNP.cjs');
+require('./chunk-KOWTQJIX.cjs');
+require('./chunk-G33MXEHU.cjs');
+require('./chunk-Q7SFCCGT.cjs');
+
+
+
+Object.defineProperty(exports, "UserClient", {
+  enumerable: true,
+  get: function () { return chunkJ3UAXGNP_cjs.UserClient; }
+});
+//# sourceMappingURL=UserClient-CD7R3335.cjs.map
+//# sourceMappingURL=UserClient-CD7R3335.cjs.map

package/dist/{UserClient-S6LS3CB6.cjs.map → UserClient-CD7R3335.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"UserClient-S6LS3CB6.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"UserClient-CD7R3335.cjs"}

package/dist/account.cjs

@@ -1,31 +1,31 @@
 'use strict';
 
-var chunkHNJBQR5U_cjs = require('./chunk-HNJBQR5U.cjs');
-require('./chunk-MOJJ7QF6.cjs');
-require('./chunk-MXJEULSE.cjs');
+var chunkOBPTMV5W_cjs = require('./chunk-OBPTMV5W.cjs');
+require('./chunk-KOWTQJIX.cjs');
+require('./chunk-G33MXEHU.cjs');
 require('./chunk-Q7SFCCGT.cjs');
 
 
 
 Object.defineProperty(exports, "UserOpClient", {
   enumerable: true,
-  get: function () { return chunkHNJBQR5U_cjs.UserOpClient; }
+  get: function () { return chunkOBPTMV5W_cjs.UserOpClient; }
 });
 Object.defineProperty(exports, "createEOAWalletClient", {
   enumerable: true,
-  get: function () { return chunkHNJBQR5U_cjs.createEOAWalletClient; }
+  get: function () { return chunkOBPTMV5W_cjs.createEOAWalletClient; }
 });
 Object.defineProperty(exports, "getUserOpHash", {
   enumerable: true,
-  get: function () { return chunkHNJBQR5U_cjs.getUserOpHash; }
+  get: function () { return chunkOBPTMV5W_cjs.getUserOpHash; }
 });
 Object.defineProperty(exports, "packUserOpLimits", {
   enumerable: true,
-  get: function () { return chunkHNJBQR5U_cjs.packUserOpLimits; }
+  get: function () { return chunkOBPTMV5W_cjs.packUserOpLimits; }
 });
 Object.defineProperty(exports, "toSimpleSmartAccount", {
   enumerable: true,
-  get: function () { return chunkHNJBQR5U_cjs.toSimpleSmartAccount; }
+  get: function () { return chunkOBPTMV5W_cjs.toSimpleSmartAccount; }
 });
 //# sourceMappingURL=account.cjs.map
 //# sourceMappingURL=account.cjs.map

package/dist/account.js

@@ -1,6 +1,6 @@
-export { UserOpClient, createEOAWalletClient, getUserOpHash, packUserOpLimits, toSimpleSmartAccount } from './chunk-DAMWXGKD.js';
-import './chunk-BYVG7MO7.js';
-import './chunk-UCLK6LTB.js';
+export { UserOpClient, createEOAWalletClient, getUserOpHash, packUserOpLimits, toSimpleSmartAccount } from './chunk-UTSFTWFC.js';
+import './chunk-6DZCDV4Q.js';
+import './chunk-MBWBHKUE.js';
 import './chunk-PZ5AY32C.js';
 //# sourceMappingURL=account.js.map
 //# sourceMappingURL=account.js.map

package/dist/addresses-D12T3kLs.d.cts

@@ -0,0 +1,210 @@
+import { Address } from 'viem';
+
+/**
+ * Canonical Contract Addresses for Supported Networks
+ * These are hardcoded as defaults for NPM distribution.
+ *
+ * SINGLE SOURCE OF TRUTH for SDK contract addresses (Beta3.1 P2.8).
+ * The root `config.{network}.json` files are dev/deploy-time overrides and MUST
+ * agree with this table for any network that has a chainId entry here. The
+ * `scripts/check-address-consistency.ts` drift check (CI: `pnpm run check:addresses`)
+ * enforces that. NOTE: `@aastar/shared-config` is a separate external repo (vendored
+ * as git submodules under ext/ and lib/), NOT a workspace package and NOT the SDK's
+ * source of truth — do not treat it as canonical here.
+ */
+
+declare const CANONICAL_ADDRESSES: {
+    readonly 10: {
+        readonly registry: "0x997686219F31405503D32728B1f094F115EF24e7";
+        readonly gToken: "0x8d6Fe002dDacCcFBD377F684EC1825f2E1ab7ef6";
+        readonly staking: "0x7A1216C2d814D2389698C64eD23AA1aA9Eb6343E";
+        readonly sbt: "0x28eBFc5fc03B1d7648254AbF1C7B39DbFdef1a94";
+        readonly reputationSystem: "0xA9560898dC0eE4F9Ed3F1db17dbf74dE65e925c2";
+        readonly superPaymaster: "0xA2c9A6e95f19f5D2a364CBCbB5f0b32B1B4d140E";
+        readonly paymasterFactory: "0x58A7F6E44a57028A255794119F8b37124c9a7eB8";
+        readonly paymasterV4: "0x67a70a578E142b950987081e7016906ae4F56Df4";
+        readonly paymasterV4Impl: "0xc4dd13F7825409EEC13FBCBdD9D8f6d618207cca";
+        readonly xPNTsFactory: "0x864971a26384d9DCC7115f0bBC428e2623F28b6e";
+        readonly blsAggregator: "0x1C305372ecc5a36CBef1FA371392234bCD55eB19";
+        readonly blsValidator: "0xA88ADec5A8dc422B57488272d5aD5913d728942A";
+        readonly dvtValidator: "0x31Ede6454a56293f7cf2323CA5d5F9a6230558Fb";
+        readonly entryPoint: "0x0000000071727De22E5E9d8BAf0edAc6f37da032";
+        readonly aPNTs: "0x0B41C78081B5A141eb4C3C7E7FD8E58A7Bde553B";
+        readonly priceFeed: "0x13e3Ee699D1909E989722E753853AE30b17e08c5";
+        readonly simpleAccountFactory: "0x91E60e0613810449d098b0b5Ec8b51A0FE8c8985";
+        readonly microPaymentChannel: "0x0000000000000000000000000000000000000000";
+        readonly agentIdentityRegistry: "0x0000000000000000000000000000000000000000";
+        readonly agentReputationRegistry: "0x0000000000000000000000000000000000000000";
+        readonly agentValidationRegistry: "0x0000000000000000000000000000000000000000";
+        readonly aaStarBLSAlgorithm: "0x0000000000000000000000000000000000000000";
+        readonly aaStarValidator: "0x0000000000000000000000000000000000000000";
+        readonly aaStarBLSAggregator: "0x0000000000000000000000000000000000000000";
+        readonly sessionKeyValidator: "0x0000000000000000000000000000000000000000";
+        readonly forceExitModule: "0x0000000000000000000000000000000000000000";
+        readonly airAccountDelegate: "0x0000000000000000000000000000000000000000";
+        readonly calldataParserRegistry: "0x0000000000000000000000000000000000000000";
+        readonly airAccountFactoryV7: "0x0000000000000000000000000000000000000000";
+        readonly airAccountV7Impl: "0x0000000000000000000000000000000000000000";
+        readonly airAccountExtension: "0x0000000000000000000000000000000000000000";
+        readonly agentRegistry: "0x0000000000000000000000000000000000000000";
+        readonly policyRegistry: "0x0000000000000000000000000000000000000000";
+        readonly x402Facilitator: "0x0000000000000000000000000000000000000000";
+        readonly timelockController: "0x0000000000000000000000000000000000000000";
+        readonly pnts: "0x0000000000000000000000000000000000000000";
+    };
+    readonly 11155111: {
+        readonly registry: "0x3F920B25f8b65988359C372F66F036E48adFc556";
+        readonly gToken: "0x20a051502a7AE6e40cfFd6EBe59057538E698984";
+        readonly staking: "0x3B363598746Ea57314d4869B160940948c569D48";
+        readonly sbt: "0x072A0D12f4212B6baD7c6d0A633eaffbDE9105bF";
+        readonly reputationSystem: "0x7fEd690E1663755e24a1C9d6164336809d68a578";
+        readonly superPaymaster: "0x030025f40d509b1a99547bAEb3795bD27F7182b7";
+        readonly paymasterFactory: "0x0Aa06EA5295eeD4D48c93c594Db1CBf3626971A5";
+        readonly paymasterV4: "0x1f0D4eF151a79948070D387BaC43b1321F0c41e3";
+        readonly paymasterV4Impl: "0x59DCA5861aaDA602fE1BFbfcc36DFAc36C58623d";
+        readonly xPNTsFactory: "0xCec3655525a112882E74Fb7C26AcB267a07724cb";
+        readonly blsAggregator: "0x15387e161c1b3dAe7c66Fbd5c1F32837B58B2e79";
+        readonly blsValidator: "0x0A71C5a32b8CBC517523D2C88b539Ab22AeF0654";
+        readonly dvtValidator: "0x19BA9829C784E4A41b68960b9c0bA55f83718997";
+        readonly entryPoint: "0x0000000071727De22E5E9d8BAf0edAc6f37da032";
+        readonly aPNTs: "0x9e66B457E0ABb1F139FD8A596d00f784eBA2873b";
+        readonly priceFeed: "0x694AA1769357215DE4FAC081bf1f309aDC325306";
+        readonly simpleAccountFactory: "0x91E60e0613810449d098b0b5Ec8b51A0FE8c8985";
+        readonly microPaymentChannel: "0x405851A141Cde827E33247d4D4089Af2814c2FF5";
+        readonly agentIdentityRegistry: "0x8004A818BFB912233c491871b3d84c89A494BD9e";
+        readonly agentReputationRegistry: "0x8004B663056A597Dffe9eCcC1965A193B7388713";
+        readonly agentValidationRegistry: "0x8004Cb1BF31DAf7788923b405b754f57acEB4272";
+        readonly aaStarBLSAlgorithm: "0xAF525A161CB17e0A1b6254ef0B8d8473bdA05174";
+        readonly aaStarValidator: "0xfcDfd17a373E037c3F9C8ffE2c781915E7Ae6e11";
+        readonly aaStarBLSAggregator: "0x35775df9a4f4dB42Ea0C46118a12dDd0cEc70609";
+        readonly sessionKeyValidator: "0x6810CfB7c72D16e044a17694fAa8076e517264D0";
+        readonly forceExitModule: "0x3fDe77868b74a7979A40a2293a1CD265fbe66EEc";
+        readonly airAccountDelegate: "0xd2735E54C5f5f2BF523b8a9ddd0E183624c3f2c0";
+        readonly calldataParserRegistry: "0x7dEea4544446826601014bD94d0F6432A67496F5";
+        readonly airAccountFactoryV7: "0x99C9300d52EDD9f4B7135DEd1811fBa6FFa1DDC6";
+        readonly airAccountV7Impl: "0xd51db7eB20FF99c8588281CBe1785681Bb17D473";
+        readonly airAccountExtension: "0x5529f50811814E0a4966cFC21200DCeF9C3FCb5B";
+        readonly agentRegistry: "0xbcE1163817EEBA2E07d39424427B10937bF1D121";
+        readonly policyRegistry: "0x8c2488d46d5447418558c38AA6441720df656094";
+        readonly x402Facilitator: "0x326Fc3413c8A0185b0179B971C69813B6dFD971B";
+        readonly timelockController: "0xB734df3c0A1809bc06708512363D368Ac51dF1A2";
+        readonly pnts: "0xC687f8a115D308ECD39658a8EE33bC3c8F75EE31";
+    };
+    readonly 11155420: {
+        readonly registry: "0xcf6860Ab57de8669756997e414D9c52B6e301972";
+        readonly gToken: "0xC341c88453372021d0221834307613c2e99fE718";
+        readonly staking: "0x5f57B931C849e8E255F22755506eB2255aB22a7C";
+        readonly sbt: "0x2c3Ca1553dC1B8870381E8E56C7b3e3A3ae162f0";
+        readonly reputationSystem: "0x891EC0f84D9275839B8dAf74e87B23F2DBd7f9c9";
+        readonly superPaymaster: "0x9eC1FE8134A1C05aD34ba2E4e8758dAe0a009B94";
+        readonly paymasterFactory: "0x1e3b9d12eAc27867a523d0537902441B0E7D98d8";
+        readonly paymasterV4: "0xf250416C940605a1D423ccd059668219cf7D80ea";
+        readonly paymasterV4Impl: "0x906123080207F250B1C9F299991512Cb31f35b2f";
+        readonly xPNTsFactory: "0x7792a49C9E91e0E9B631B27D885d15e971B7482A";
+        readonly blsAggregator: "0x6e06b17b1a4D2D973F7E3e026e24b4393315736c";
+        readonly blsValidator: "0x260fa905CcE1f5b29Afe9d627c01fAAE4A66A7F5";
+        readonly dvtValidator: "0x0087cA806109E150438116cAA414580BB5fa9195";
+        readonly entryPoint: "0x0000000071727De22E5E9d8BAf0edAc6f37da032";
+        readonly aPNTs: "0x3BBcA92Ad828b3dD619c980Ba09f929b9d2BC440";
+        readonly priceFeed: "0x61Ec26aA57019C486B10502285c5A3D4A4750AD7";
+        readonly simpleAccountFactory: "0x91E6060613810449d098b0b5EC8b51A0fe8C8985";
+        readonly microPaymentChannel: "0x0000000000000000000000000000000000000000";
+        readonly agentIdentityRegistry: "0x0000000000000000000000000000000000000000";
+        readonly agentReputationRegistry: "0x0000000000000000000000000000000000000000";
+        readonly agentValidationRegistry: "0x0000000000000000000000000000000000000000";
+        readonly aaStarBLSAlgorithm: "0x0000000000000000000000000000000000000000";
+        readonly aaStarValidator: "0x0000000000000000000000000000000000000000";
+        readonly aaStarBLSAggregator: "0x0000000000000000000000000000000000000000";
+        readonly sessionKeyValidator: "0x0000000000000000000000000000000000000000";
+        readonly forceExitModule: "0x0000000000000000000000000000000000000000";
+        readonly airAccountDelegate: "0x0000000000000000000000000000000000000000";
+        readonly calldataParserRegistry: "0x0000000000000000000000000000000000000000";
+        readonly airAccountFactoryV7: "0x0000000000000000000000000000000000000000";
+        readonly airAccountV7Impl: "0x0000000000000000000000000000000000000000";
+        readonly airAccountExtension: "0x0000000000000000000000000000000000000000";
+        readonly agentRegistry: "0x0000000000000000000000000000000000000000";
+        readonly policyRegistry: "0x0000000000000000000000000000000000000000";
+        readonly x402Facilitator: "0x0000000000000000000000000000000000000000";
+        readonly timelockController: "0x0000000000000000000000000000000000000000";
+        readonly pnts: "0x0000000000000000000000000000000000000000";
+    };
+};
+type CanonicalAddresses = (typeof CANONICAL_ADDRESSES)[keyof typeof CANONICAL_ADDRESSES];
+type SupportedChainId = keyof typeof CANONICAL_ADDRESSES;
+/**
+ * MushroomDAO launch token-sale stack (aPoints + governance-token sale), keyed by chainId.
+ *
+ * Kept as a SEPARATE table from {@link CANONICAL_ADDRESSES} on purpose: these are the launch
+ * app's own contracts (`MushroomDAO/launch`), not the core SuperPaymaster protocol set, so they
+ * stay out of the constants/contract-addresses/drift-check pipeline.
+ *
+ * De-dup rule: this table stores ONLY the launch-specific contracts (the two sale contracts +
+ * BuyHelper) plus the accepted payment stablecoins. It deliberately does NOT store the GToken /
+ * aPNTs *payout* token addresses — `TokenSaleClient` reads those on-chain from the sale contract's
+ * `gToken()` / `aPNTs()` immutable getters, so there is never a second copy of a token address to
+ * drift. (Background: three different GToken deployments currently exist — core canonical
+ * `0x20a051…`, the launch live `0x4e6A11…`, and the launch DEPLOYED.md "SuperPaymaster" `0xa592ec…`.
+ * The live sale is constructor-bound to `0x4e6A11…`; binding it to the core-canonical GToken is the
+ * pre-mainnet reconciliation step.)
+ */
+interface LaunchSaleAddresses {
+    /** SaleContractV2 — sells the constructor-bound GToken (governance token). */
+    saleGToken: Address;
+    /** APNTsSaleContract — sells the constructor-bound aPNTs (aPoints). */
+    saleAPNTs: Address;
+    /** BuyHelper — gasless entrypoint (EIP-3009 transferWithAuthorization + EIP-712 BuyIntent). */
+    buyHelper: Address;
+    /** Accepted payment stablecoin: USDC (6-decimal). Also the EIP-3009 token for gasless. */
+    usdc: Address;
+    /** Accepted payment stablecoin: USDT (6-decimal). Self-pay only. */
+    usdt: Address;
+    /** Off-chain relayer that submits gasless buys (Cloudflare Worker). */
+    relayerUrl: string;
+}
+declare const LAUNCH_SALE_ADDRESSES: Record<number, LaunchSaleAddresses>;
+/** Resolve the launch token-sale address group for a chain, or `undefined` if none. */
+declare function getLaunchSaleAddresses(chainId: number): LaunchSaleAddresses | undefined;
+/**
+ * Chain IDs that have a canonical address book in {@link CANONICAL_ADDRESSES}.
+ *
+ * @example
+ * ```ts
+ * listSupportedChainIds(); // [10, 11155111, 11155420]
+ * ```
+ */
+declare function listSupportedChainIds(): number[];
+/** True if {@link CANONICAL_ADDRESSES} has an entry for `chainId`. */
+declare function isSupportedChainId(chainId: number): chainId is SupportedChainId;
+/**
+ * Resolve the canonical contract address book for a chain, keyed by `chainId`,
+ * normalized to the key names the role-based client factories expect.
+ *
+ * The canonical table uses `staking` / `sbt`; the historical client factories
+ * (and many consumers) reference `gTokenStaking` / `mySBT`. This helper returns
+ * the canonical set plus those aliases so a single object satisfies both, which
+ * is what makes `createEndUserClient({ chain })` resolve addresses automatically
+ * — no manual `addresses` needed for any supported chain.
+ *
+ * @param chainId - EVM chain id (e.g. 10 = Optimism, 11155111 = Sepolia).
+ * @returns The normalized address record, or `undefined` if the chain has no
+ *          canonical entry (caller must then pass `addresses` explicitly).
+ *
+ * @example
+ * ```ts
+ * import { optimism } from 'viem/chains';
+ * const addrs = getCanonicalAddresses(optimism.id); // chainId 10
+ * addrs?.registry; addrs?.mySBT; // alias of `sbt`
+ * ```
+ */
+declare function getCanonicalAddresses(chainId: number): (CanonicalAddresses & {
+    gTokenStaking: Address;
+    mySBT: Address;
+}) | undefined;
+/**
+ * A friendly, human-readable list of the supported chains for error messages —
+ * e.g. `"OP Mainnet (10), Sepolia (11155111), OP Sepolia (11155420)"`. Names come
+ * from viem/chains so callers recognize them by the same label viem uses.
+ */
+declare function describeSupportedChains(): string;
+
+export { CANONICAL_ADDRESSES as C, type LaunchSaleAddresses as L, type SupportedChainId as S, type CanonicalAddresses as a, LAUNCH_SALE_ADDRESSES as b, getCanonicalAddresses as c, describeSupportedChains as d, getLaunchSaleAddresses as g, isSupportedChainId as i, listSupportedChainIds as l };

package/dist/addresses-D12T3kLs.d.ts

@@ -0,0 +1,210 @@
+import { Address } from 'viem';
+
+/**
+ * Canonical Contract Addresses for Supported Networks
+ * These are hardcoded as defaults for NPM distribution.
+ *
+ * SINGLE SOURCE OF TRUTH for SDK contract addresses (Beta3.1 P2.8).
+ * The root `config.{network}.json` files are dev/deploy-time overrides and MUST
+ * agree with this table for any network that has a chainId entry here. The
+ * `scripts/check-address-consistency.ts` drift check (CI: `pnpm run check:addresses`)
+ * enforces that. NOTE: `@aastar/shared-config` is a separate external repo (vendored
+ * as git submodules under ext/ and lib/), NOT a workspace package and NOT the SDK's
+ * source of truth — do not treat it as canonical here.
+ */
+
+declare const CANONICAL_ADDRESSES: {
+    readonly 10: {
+        readonly registry: "0x997686219F31405503D32728B1f094F115EF24e7";
+        readonly gToken: "0x8d6Fe002dDacCcFBD377F684EC1825f2E1ab7ef6";
+        readonly staking: "0x7A1216C2d814D2389698C64eD23AA1aA9Eb6343E";
+        readonly sbt: "0x28eBFc5fc03B1d7648254AbF1C7B39DbFdef1a94";
+        readonly reputationSystem: "0xA9560898dC0eE4F9Ed3F1db17dbf74dE65e925c2";
+        readonly superPaymaster: "0xA2c9A6e95f19f5D2a364CBCbB5f0b32B1B4d140E";
+        readonly paymasterFactory: "0x58A7F6E44a57028A255794119F8b37124c9a7eB8";
+        readonly paymasterV4: "0x67a70a578E142b950987081e7016906ae4F56Df4";
+        readonly paymasterV4Impl: "0xc4dd13F7825409EEC13FBCBdD9D8f6d618207cca";
+        readonly xPNTsFactory: "0x864971a26384d9DCC7115f0bBC428e2623F28b6e";
+        readonly blsAggregator: "0x1C305372ecc5a36CBef1FA371392234bCD55eB19";
+        readonly blsValidator: "0xA88ADec5A8dc422B57488272d5aD5913d728942A";
+        readonly dvtValidator: "0x31Ede6454a56293f7cf2323CA5d5F9a6230558Fb";
+        readonly entryPoint: "0x0000000071727De22E5E9d8BAf0edAc6f37da032";
+        readonly aPNTs: "0x0B41C78081B5A141eb4C3C7E7FD8E58A7Bde553B";
+        readonly priceFeed: "0x13e3Ee699D1909E989722E753853AE30b17e08c5";
+        readonly simpleAccountFactory: "0x91E60e0613810449d098b0b5Ec8b51A0FE8c8985";
+        readonly microPaymentChannel: "0x0000000000000000000000000000000000000000";
+        readonly agentIdentityRegistry: "0x0000000000000000000000000000000000000000";
+        readonly agentReputationRegistry: "0x0000000000000000000000000000000000000000";
+        readonly agentValidationRegistry: "0x0000000000000000000000000000000000000000";
+        readonly aaStarBLSAlgorithm: "0x0000000000000000000000000000000000000000";
+        readonly aaStarValidator: "0x0000000000000000000000000000000000000000";
+        readonly aaStarBLSAggregator: "0x0000000000000000000000000000000000000000";
+        readonly sessionKeyValidator: "0x0000000000000000000000000000000000000000";
+        readonly forceExitModule: "0x0000000000000000000000000000000000000000";
+        readonly airAccountDelegate: "0x0000000000000000000000000000000000000000";
+        readonly calldataParserRegistry: "0x0000000000000000000000000000000000000000";
+        readonly airAccountFactoryV7: "0x0000000000000000000000000000000000000000";
+        readonly airAccountV7Impl: "0x0000000000000000000000000000000000000000";
+        readonly airAccountExtension: "0x0000000000000000000000000000000000000000";
+        readonly agentRegistry: "0x0000000000000000000000000000000000000000";
+        readonly policyRegistry: "0x0000000000000000000000000000000000000000";
+        readonly x402Facilitator: "0x0000000000000000000000000000000000000000";
+        readonly timelockController: "0x0000000000000000000000000000000000000000";
+        readonly pnts: "0x0000000000000000000000000000000000000000";
+    };
+    readonly 11155111: {
+        readonly registry: "0x3F920B25f8b65988359C372F66F036E48adFc556";
+        readonly gToken: "0x20a051502a7AE6e40cfFd6EBe59057538E698984";
+        readonly staking: "0x3B363598746Ea57314d4869B160940948c569D48";
+        readonly sbt: "0x072A0D12f4212B6baD7c6d0A633eaffbDE9105bF";
+        readonly reputationSystem: "0x7fEd690E1663755e24a1C9d6164336809d68a578";
+        readonly superPaymaster: "0x030025f40d509b1a99547bAEb3795bD27F7182b7";
+        readonly paymasterFactory: "0x0Aa06EA5295eeD4D48c93c594Db1CBf3626971A5";
+        readonly paymasterV4: "0x1f0D4eF151a79948070D387BaC43b1321F0c41e3";
+        readonly paymasterV4Impl: "0x59DCA5861aaDA602fE1BFbfcc36DFAc36C58623d";
+        readonly xPNTsFactory: "0xCec3655525a112882E74Fb7C26AcB267a07724cb";
+        readonly blsAggregator: "0x15387e161c1b3dAe7c66Fbd5c1F32837B58B2e79";
+        readonly blsValidator: "0x0A71C5a32b8CBC517523D2C88b539Ab22AeF0654";
+        readonly dvtValidator: "0x19BA9829C784E4A41b68960b9c0bA55f83718997";
+        readonly entryPoint: "0x0000000071727De22E5E9d8BAf0edAc6f37da032";
+        readonly aPNTs: "0x9e66B457E0ABb1F139FD8A596d00f784eBA2873b";
+        readonly priceFeed: "0x694AA1769357215DE4FAC081bf1f309aDC325306";
+        readonly simpleAccountFactory: "0x91E60e0613810449d098b0b5Ec8b51A0FE8c8985";
+        readonly microPaymentChannel: "0x405851A141Cde827E33247d4D4089Af2814c2FF5";
+        readonly agentIdentityRegistry: "0x8004A818BFB912233c491871b3d84c89A494BD9e";
+        readonly agentReputationRegistry: "0x8004B663056A597Dffe9eCcC1965A193B7388713";
+        readonly agentValidationRegistry: "0x8004Cb1BF31DAf7788923b405b754f57acEB4272";
+        readonly aaStarBLSAlgorithm: "0xAF525A161CB17e0A1b6254ef0B8d8473bdA05174";
+        readonly aaStarValidator: "0xfcDfd17a373E037c3F9C8ffE2c781915E7Ae6e11";
+        readonly aaStarBLSAggregator: "0x35775df9a4f4dB42Ea0C46118a12dDd0cEc70609";
+        readonly sessionKeyValidator: "0x6810CfB7c72D16e044a17694fAa8076e517264D0";
+        readonly forceExitModule: "0x3fDe77868b74a7979A40a2293a1CD265fbe66EEc";
+        readonly airAccountDelegate: "0xd2735E54C5f5f2BF523b8a9ddd0E183624c3f2c0";
+        readonly calldataParserRegistry: "0x7dEea4544446826601014bD94d0F6432A67496F5";
+        readonly airAccountFactoryV7: "0x99C9300d52EDD9f4B7135DEd1811fBa6FFa1DDC6";
+        readonly airAccountV7Impl: "0xd51db7eB20FF99c8588281CBe1785681Bb17D473";
+        readonly airAccountExtension: "0x5529f50811814E0a4966cFC21200DCeF9C3FCb5B";
+        readonly agentRegistry: "0xbcE1163817EEBA2E07d39424427B10937bF1D121";
+        readonly policyRegistry: "0x8c2488d46d5447418558c38AA6441720df656094";
+        readonly x402Facilitator: "0x326Fc3413c8A0185b0179B971C69813B6dFD971B";
+        readonly timelockController: "0xB734df3c0A1809bc06708512363D368Ac51dF1A2";
+        readonly pnts: "0xC687f8a115D308ECD39658a8EE33bC3c8F75EE31";
+    };
+    readonly 11155420: {
+        readonly registry: "0xcf6860Ab57de8669756997e414D9c52B6e301972";
+        readonly gToken: "0xC341c88453372021d0221834307613c2e99fE718";
+        readonly staking: "0x5f57B931C849e8E255F22755506eB2255aB22a7C";
+        readonly sbt: "0x2c3Ca1553dC1B8870381E8E56C7b3e3A3ae162f0";
+        readonly reputationSystem: "0x891EC0f84D9275839B8dAf74e87B23F2DBd7f9c9";
+        readonly superPaymaster: "0x9eC1FE8134A1C05aD34ba2E4e8758dAe0a009B94";
+        readonly paymasterFactory: "0x1e3b9d12eAc27867a523d0537902441B0E7D98d8";
+        readonly paymasterV4: "0xf250416C940605a1D423ccd059668219cf7D80ea";
+        readonly paymasterV4Impl: "0x906123080207F250B1C9F299991512Cb31f35b2f";
+        readonly xPNTsFactory: "0x7792a49C9E91e0E9B631B27D885d15e971B7482A";
+        readonly blsAggregator: "0x6e06b17b1a4D2D973F7E3e026e24b4393315736c";
+        readonly blsValidator: "0x260fa905CcE1f5b29Afe9d627c01fAAE4A66A7F5";
+        readonly dvtValidator: "0x0087cA806109E150438116cAA414580BB5fa9195";
+        readonly entryPoint: "0x0000000071727De22E5E9d8BAf0edAc6f37da032";
+        readonly aPNTs: "0x3BBcA92Ad828b3dD619c980Ba09f929b9d2BC440";
+        readonly priceFeed: "0x61Ec26aA57019C486B10502285c5A3D4A4750AD7";
+        readonly simpleAccountFactory: "0x91E6060613810449d098b0b5EC8b51A0fe8C8985";
+        readonly microPaymentChannel: "0x0000000000000000000000000000000000000000";
+        readonly agentIdentityRegistry: "0x0000000000000000000000000000000000000000";
+        readonly agentReputationRegistry: "0x0000000000000000000000000000000000000000";
+        readonly agentValidationRegistry: "0x0000000000000000000000000000000000000000";
+        readonly aaStarBLSAlgorithm: "0x0000000000000000000000000000000000000000";
+        readonly aaStarValidator: "0x0000000000000000000000000000000000000000";
+        readonly aaStarBLSAggregator: "0x0000000000000000000000000000000000000000";
+        readonly sessionKeyValidator: "0x0000000000000000000000000000000000000000";
+        readonly forceExitModule: "0x0000000000000000000000000000000000000000";
+        readonly airAccountDelegate: "0x0000000000000000000000000000000000000000";
+        readonly calldataParserRegistry: "0x0000000000000000000000000000000000000000";
+        readonly airAccountFactoryV7: "0x0000000000000000000000000000000000000000";
+        readonly airAccountV7Impl: "0x0000000000000000000000000000000000000000";
+        readonly airAccountExtension: "0x0000000000000000000000000000000000000000";
+        readonly agentRegistry: "0x0000000000000000000000000000000000000000";
+        readonly policyRegistry: "0x0000000000000000000000000000000000000000";
+        readonly x402Facilitator: "0x0000000000000000000000000000000000000000";
+        readonly timelockController: "0x0000000000000000000000000000000000000000";
+        readonly pnts: "0x0000000000000000000000000000000000000000";
+    };
+};
+type CanonicalAddresses = (typeof CANONICAL_ADDRESSES)[keyof typeof CANONICAL_ADDRESSES];
+type SupportedChainId = keyof typeof CANONICAL_ADDRESSES;
+/**
+ * MushroomDAO launch token-sale stack (aPoints + governance-token sale), keyed by chainId.
+ *
+ * Kept as a SEPARATE table from {@link CANONICAL_ADDRESSES} on purpose: these are the launch
+ * app's own contracts (`MushroomDAO/launch`), not the core SuperPaymaster protocol set, so they
+ * stay out of the constants/contract-addresses/drift-check pipeline.
+ *
+ * De-dup rule: this table stores ONLY the launch-specific contracts (the two sale contracts +
+ * BuyHelper) plus the accepted payment stablecoins. It deliberately does NOT store the GToken /
+ * aPNTs *payout* token addresses — `TokenSaleClient` reads those on-chain from the sale contract's
+ * `gToken()` / `aPNTs()` immutable getters, so there is never a second copy of a token address to
+ * drift. (Background: three different GToken deployments currently exist — core canonical
+ * `0x20a051…`, the launch live `0x4e6A11…`, and the launch DEPLOYED.md "SuperPaymaster" `0xa592ec…`.
+ * The live sale is constructor-bound to `0x4e6A11…`; binding it to the core-canonical GToken is the
+ * pre-mainnet reconciliation step.)
+ */
+interface LaunchSaleAddresses {
+    /** SaleContractV2 — sells the constructor-bound GToken (governance token). */
+    saleGToken: Address;
+    /** APNTsSaleContract — sells the constructor-bound aPNTs (aPoints). */
+    saleAPNTs: Address;
+    /** BuyHelper — gasless entrypoint (EIP-3009 transferWithAuthorization + EIP-712 BuyIntent). */
+    buyHelper: Address;
+    /** Accepted payment stablecoin: USDC (6-decimal). Also the EIP-3009 token for gasless. */
+    usdc: Address;
+    /** Accepted payment stablecoin: USDT (6-decimal). Self-pay only. */
+    usdt: Address;
+    /** Off-chain relayer that submits gasless buys (Cloudflare Worker). */
+    relayerUrl: string;
+}
+declare const LAUNCH_SALE_ADDRESSES: Record<number, LaunchSaleAddresses>;
+/** Resolve the launch token-sale address group for a chain, or `undefined` if none. */
+declare function getLaunchSaleAddresses(chainId: number): LaunchSaleAddresses | undefined;
+/**
+ * Chain IDs that have a canonical address book in {@link CANONICAL_ADDRESSES}.
+ *
+ * @example
+ * ```ts
+ * listSupportedChainIds(); // [10, 11155111, 11155420]
+ * ```
+ */
+declare function listSupportedChainIds(): number[];
+/** True if {@link CANONICAL_ADDRESSES} has an entry for `chainId`. */
+declare function isSupportedChainId(chainId: number): chainId is SupportedChainId;
+/**
+ * Resolve the canonical contract address book for a chain, keyed by `chainId`,
+ * normalized to the key names the role-based client factories expect.
+ *
+ * The canonical table uses `staking` / `sbt`; the historical client factories
+ * (and many consumers) reference `gTokenStaking` / `mySBT`. This helper returns
+ * the canonical set plus those aliases so a single object satisfies both, which
+ * is what makes `createEndUserClient({ chain })` resolve addresses automatically
+ * — no manual `addresses` needed for any supported chain.
+ *
+ * @param chainId - EVM chain id (e.g. 10 = Optimism, 11155111 = Sepolia).
+ * @returns The normalized address record, or `undefined` if the chain has no
+ *          canonical entry (caller must then pass `addresses` explicitly).
+ *
+ * @example
+ * ```ts
+ * import { optimism } from 'viem/chains';
+ * const addrs = getCanonicalAddresses(optimism.id); // chainId 10
+ * addrs?.registry; addrs?.mySBT; // alias of `sbt`
+ * ```
+ */
+declare function getCanonicalAddresses(chainId: number): (CanonicalAddresses & {
+    gTokenStaking: Address;
+    mySBT: Address;
+}) | undefined;
+/**
+ * A friendly, human-readable list of the supported chains for error messages —
+ * e.g. `"OP Mainnet (10), Sepolia (11155111), OP Sepolia (11155420)"`. Names come
+ * from viem/chains so callers recognize them by the same label viem uses.
+ */
+declare function describeSupportedChains(): string;
+
+export { CANONICAL_ADDRESSES as C, type LaunchSaleAddresses as L, type SupportedChainId as S, type CanonicalAddresses as a, LAUNCH_SALE_ADDRESSES as b, getCanonicalAddresses as c, describeSupportedChains as d, getLaunchSaleAddresses as g, isSupportedChainId as i, listSupportedChainIds as l };

package/dist/admin.cjs

@@ -1,15 +1,15 @@
 'use strict';
 
-var chunkD667CUUS_cjs = require('./chunk-D667CUUS.cjs');
-require('./chunk-MOJJ7QF6.cjs');
-require('./chunk-MXJEULSE.cjs');
+var chunkGASCTLKR_cjs = require('./chunk-GASCTLKR.cjs');
+require('./chunk-KOWTQJIX.cjs');
+require('./chunk-G33MXEHU.cjs');
 require('./chunk-Q7SFCCGT.cjs');
 
 
 
 Object.defineProperty(exports, "ProtocolGovernance", {
   enumerable: true,
-  get: function () { return chunkD667CUUS_cjs.ProtocolGovernance; }
+  get: function () { return chunkGASCTLKR_cjs.ProtocolGovernance; }
 });
 //# sourceMappingURL=admin.cjs.map
 //# sourceMappingURL=admin.cjs.map

package/dist/admin.js

@@ -1,6 +1,6 @@
-export { ProtocolGovernance } from './chunk-654GQ7G7.js';
-import './chunk-BYVG7MO7.js';
-import './chunk-UCLK6LTB.js';
+export { ProtocolGovernance } from './chunk-A4FO6FKN.js';
+import './chunk-6DZCDV4Q.js';
+import './chunk-MBWBHKUE.js';
 import './chunk-PZ5AY32C.js';
 //# sourceMappingURL=admin.js.map
 //# sourceMappingURL=admin.js.map