@aastar/sdk 0.24.2 → 0.25.0

package/dist/src-DNURNUIA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"src-DNURNUIA.cjs"}

package/dist/{src-RM6DDR7K.cjs → src-DZDH3BSU.cjs}

@@ -1,63 +1,63 @@
 'use strict';
 
-var chunkMCDFQ5JH_cjs = require('./chunk-MCDFQ5JH.cjs');
-require('./chunk-IB3KOSHW.cjs');
-require('./chunk-MXJEULSE.cjs');
+var chunk7HTUDNH3_cjs = require('./chunk-7HTUDNH3.cjs');
+require('./chunk-KOWTQJIX.cjs');
+require('./chunk-G33MXEHU.cjs');
 require('./chunk-Q7SFCCGT.cjs');
 
 
 
 Object.defineProperty(exports, "PaymasterClient", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.PaymasterClient; }
+  get: function () { return chunk7HTUDNH3_cjs.PaymasterClient; }
 });
 Object.defineProperty(exports, "PaymasterManager", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.PaymasterManager; }
+  get: function () { return chunk7HTUDNH3_cjs.PaymasterManager; }
 });
 Object.defineProperty(exports, "PaymasterOperator", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.PaymasterOperator; }
+  get: function () { return chunk7HTUDNH3_cjs.PaymasterOperator; }
 });
 Object.defineProperty(exports, "SuperPaymasterAdminClient", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.SuperPaymasterAdminClient; }
+  get: function () { return chunk7HTUDNH3_cjs.SuperPaymasterAdminClient; }
 });
 Object.defineProperty(exports, "SuperPaymasterClient", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.SuperPaymasterClient; }
+  get: function () { return chunk7HTUDNH3_cjs.SuperPaymasterClient; }
 });
 Object.defineProperty(exports, "buildPaymasterData", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.buildPaymasterData; }
+  get: function () { return chunk7HTUDNH3_cjs.buildPaymasterData; }
 });
 Object.defineProperty(exports, "buildSuperPaymasterData", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.buildSuperPaymasterData; }
+  get: function () { return chunk7HTUDNH3_cjs.buildSuperPaymasterData; }
 });
 Object.defineProperty(exports, "checkEligibility", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.checkEligibility; }
+  get: function () { return chunk7HTUDNH3_cjs.checkEligibility; }
 });
 Object.defineProperty(exports, "formatUserOpV07", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.formatUserOpV07; }
+  get: function () { return chunk7HTUDNH3_cjs.formatUserOpV07; }
 });
 Object.defineProperty(exports, "getPaymasterV4Middleware", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.getPaymasterV4Middleware; }
+  get: function () { return chunk7HTUDNH3_cjs.getPaymasterV4Middleware; }
 });
 Object.defineProperty(exports, "getSuperPaymasterMiddleware", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.getSuperPaymasterMiddleware; }
+  get: function () { return chunk7HTUDNH3_cjs.getSuperPaymasterMiddleware; }
 });
 Object.defineProperty(exports, "getUserOpHashV07", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.getUserOpHashV07; }
+  get: function () { return chunk7HTUDNH3_cjs.getUserOpHashV07; }
 });
 Object.defineProperty(exports, "tuneGasLimit", {
   enumerable: true,
-  get: function () { return chunkMCDFQ5JH_cjs.tuneGasLimit; }
+  get: function () { return chunk7HTUDNH3_cjs.tuneGasLimit; }
 });
-//# sourceMappingURL=src-RM6DDR7K.cjs.map
-//# sourceMappingURL=src-RM6DDR7K.cjs.map
+//# sourceMappingURL=src-DZDH3BSU.cjs.map
+//# sourceMappingURL=src-DZDH3BSU.cjs.map

package/dist/src-DZDH3BSU.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"src-DZDH3BSU.cjs"}

package/dist/{src-HKOFZ4V3.js → src-EVM7OESP.js}

@@ -1,6 +1,6 @@
-export { PaymasterClient, PaymasterManager, PaymasterOperator, SuperPaymasterAdminClient, SuperPaymasterClient, buildPaymasterData, buildSuperPaymasterData, checkEligibility, formatUserOpV07, getPaymasterV4Middleware, getSuperPaymasterMiddleware, getUserOpHashV07, tuneGasLimit } from './chunk-XBZGVJ5K.js';
-import './chunk-EEWLL7GE.js';
-import './chunk-UCLK6LTB.js';
+export { PaymasterClient, PaymasterManager, PaymasterOperator, SuperPaymasterAdminClient, SuperPaymasterClient, buildPaymasterData, buildSuperPaymasterData, checkEligibility, formatUserOpV07, getPaymasterV4Middleware, getSuperPaymasterMiddleware, getUserOpHashV07, tuneGasLimit } from './chunk-YR7CTWY6.js';
+import './chunk-6DZCDV4Q.js';
+import './chunk-MBWBHKUE.js';
 import './chunk-PZ5AY32C.js';
-//# sourceMappingURL=src-HKOFZ4V3.js.map
-//# sourceMappingURL=src-HKOFZ4V3.js.map
+//# sourceMappingURL=src-EVM7OESP.js.map
+//# sourceMappingURL=src-EVM7OESP.js.map

package/dist/src-EVM7OESP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"src-EVM7OESP.js"}

package/dist/src-FY3KAPPC.js

@@ -0,0 +1,5 @@
+export { AASTAR_COMMUNITY, AAStarAirAccountFactoryV7ABI, AAStarAirAccountFactoryV7Artifact, AAStarAirAccountV7ABI, AAStarAirAccountV7Artifact, AAStarBLSAggregatorABI, AAStarBLSAggregatorArtifact, AAStarBLSAlgorithmABI, AAStarBLSAlgorithmArtifact, AAStarValidatorABI, AAStarValidatorArtifact, ALG_BLS, ALL_ROLES, APNTsSaleContractABI, AgentRegistryABI, AgentRegistryArtifact, AirAccountDelegateABI, AirAccountDelegateArtifact, AirAccountExtensionABI, AirAccountExtensionArtifact, AuthorizationState, BLSAggregatorABI, BLSAggregatorArtifact, BLSHelpers, BLSSigner, BLSValidatorABI, BLSValidatorArtifact, BLS_POP_DST, BRANDING, BREAD_COMMUNITY, BaseClient, BundlerClient, BuyHelperABI, COMMUNITIES, CONTRACTS, CONTRACT_METADATA, CalldataParserRegistryABI, CalldataParserRegistryArtifact, ContractConfigManager, DEFAULT_ADMIN_ROLE, DEFAULT_DVT_NODES, DVTValidatorABI, DVTValidatorArtifact, DVT_TIER_T2, DVT_TIER_T3, ERC20ABI, EntryPointABI, EntryPointArtifact, EntryPointVersion, ForceExitModuleABI, ForceExitModuleArtifact, GTokenABI, GTokenArtifact, GTokenAuthorizationABI, GTokenAuthorizationArtifact, GTokenStakingABI, GTokenStakingArtifact, GUARDIAN_ADDITION_NONCE_SLOT, GUARDIAN_REMOVAL_NONCE_SLOT, GUARDIAN_SIG_VERSION, INITIAL_ROLE_STAKES, INLINE_ALG_IDS, LINKS, MAX_GUARDIAN_SLOT, MicroPaymentChannelABI, MicroPaymentChannelArtifact, MySBTABI, MySBTArtifact, NETWORKS, NodeType, P256_GUARDIAN_DOMAIN, P256_GUARDIAN_SENTINEL, PaymasterABI, PaymasterArtifact, PaymasterFactoryABI, PaymasterFactoryArtifact, PolicyDecision, PolicyRegistryABI, PolicyRegistryArtifact, RECOVERY_NONCE_SLOT, ROLE_ANODE, ROLE_COMMUNITY, ROLE_DVT, ROLE_ENDUSER, ROLE_KMS, ROLE_NAMES, ROLE_PAYMASTER_AOA, ROLE_PAYMASTER_SUPER, ROLE_PERMISSION_LEVELS, RegistryABI, RegistryArtifact, ReputationSystemABI, ReputationSystemArtifact, RequirementChecker, RolePermissionLevel, SECP256R1_N, SECP256R1_N_OVER_2, SEPOLIA_CONTRACTS, SEPOLIA_V2_VERSIONS, SaleContractV2ABI, SepoliaFaucetAPI, SessionKeyValidatorABI, SessionKeyValidatorArtifact, SimpleAccountABI, SimpleAccountArtifact, SimpleAccountFactoryABI, SimpleAccountFactoryArtifact, StateValidator, SuperPaymasterABI, SuperPaymasterArtifact, TIER_LIMIT_NONCE_SLOT, V2_SUMMARY, WEBAUTHN_GET_CHALLENGE_PREFIX, X402FacilitatorABI, X402FacilitatorArtifact, accountActions, accountFactoryActions, agentActions, agentRegistryActions, aggregatorActions, airAccountActions, airAccountExtensionActions, airAccountFactoryActions, base64UrlEncode, blsAlgorithmActions, buildAddGuardianChallenge, buildAddP256GuardianChallenge, buildApproveRecoveryChallenge, buildCancelRecoveryChallenge, buildInitConfig, buildModifyTierLimitsChallenge, buildP256GuardianChallenge, buildProposeRecoveryChallenge, buildRemoveGuardianChallenge, channelActions, coseToP256XY, createAAStarPublicClient, createHeliosTransport, decodeWebAuthnAssertion, dvtActions, encodeBLSAccountSignature, encodeDVTAccountSignature, encodeDVTVerifierProof, encodeG2Point, encodeWebAuthnAssertion, entryPointActions, forceExitActions, gTokenActions, gTokenAuthorizationActions, getAddressUrl, getAllCommunityConfigs, getAllV2Contracts, getBlockExplorer, getChainId, getCommunities, getCommunity, getCommunityConfig, getContract, getContractNetworks, getContracts, getCoreContracts, getDefaultDvtNodes, getDeploymentDate, getEntryPoint, getNetwork, getPaymasterV4_1, getRoleName, getRpcUrl, getSimpleAccountFactory, getSuperPaymasterV2, getTestAccounts, getTestTokenContracts, getTokenContracts, getTxUrl, getV2ContractByAddress, getV2ContractByName, getV2ContractsByDate, hashToFieldU0U1, isContractNetworkSupported, isRegisteredCommunity, isV2Contract, lookupAddress, needsValidatorRouter, opDataAddGuardian, opDataAddP256Guardian, opDataModifyTierLimits, opDataRecovery, opDataRemoveGuardian, p256GuardianPublicKey, paymasterActions, paymasterFactoryActions, policyRegistryActions, registryActions, reputationActions, resolveEns, resolveEnsVerified, sbtActions, sessionKeyValidatorActions, signP256GuardianAssertion, stakingActions, superPaymasterActions, tokenActions, x402Actions, x402IsNonceUsed, x402NonceKey, xPNTsFactoryABI, xPNTsFactoryActions, xPNTsFactoryArtifact, xPNTsTokenABI, xPNTsTokenActions, xPNTsTokenArtifact } from './chunk-6DZCDV4Q.js';
+export { AGENT_IDENTITY_REGISTRY_ADDRESS, AGENT_REPUTATION_REGISTRY_ADDRESS, ALL_ADDRESSES, APNTS_ADDRESS, BLS_AGGREGATOR_ADDRESS, BLS_VALIDATOR_ADDRESS, BPS_DENOMINATOR, CANONICAL_ADDRESSES, CHAIN_MAINNET, CHAIN_SEPOLIA, COMMUNITY_OWNERS, CONTRACT_SRC_HASH, CORE_ADDRESSES, DEFAULT_APNTS_PRICE_USD, DEFAULT_CALL_GAS_LIMIT, DEFAULT_GAS_TOKEN_MINT_AMOUNT, DEFAULT_PRE_VERIFICATION_GAS, DEFAULT_TIMEOUT_MS, DEFAULT_TOKEN_NAME, DEFAULT_TOKEN_SYMBOL, DEFAULT_USDT_MINT_AMOUNT, DEFAULT_VERIFICATION_GAS_LIMIT, DVT_VALIDATOR_ADDRESS, ENTRY_POINT_ADDRESS, FAUCET_API_URL, GTOKEN_ADDRESS, GTOKEN_STAKING_ADDRESS, LAUNCH_SALE_ADDRESSES, MAX_SERVICE_FEE, MICRO_PAYMENT_CHANNEL_ADDRESS, MONITORING_ADDRESSES, NODE_STAKE_AMOUNTS, OFFICIAL_ADDRESSES, PAYMASTER_ADDRESSES, PAYMASTER_FACTORY_ADDRESS, PAYMASTER_V4_ADDRESS, PAYMASTER_V4_IMPL_ADDRESS, REGISTRY_ADDRESS, REPUTATION_SYSTEM_ADDRESS, SBT_ADDRESS, SERVICE_FEE_RATE, SUPER_PAYMASTER_ADDRESS, TEST_ACCOUNT_ADDRESSES, TEST_ACCOUNT_POOL_SIZE, TEST_COMMUNITIES, TEST_TOKEN_ADDRESSES, TOKEN_ADDRESSES, XPNTS_FACTORY_ADDRESS, applyConfig, describeSupportedChains, getCanonicalAddresses, getLaunchSaleAddresses, isSupportedChainId, listSupportedChainIds } from './chunk-MBWBHKUE.js';
+import './chunk-PZ5AY32C.js';
+//# sourceMappingURL=src-FY3KAPPC.js.map
+//# sourceMappingURL=src-FY3KAPPC.js.map

package/dist/src-FY3KAPPC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"src-FY3KAPPC.js"}

package/dist/tokens.cjs

@@ -1,15 +1,23 @@
 'use strict';
 
-var chunkV23XPVHO_cjs = require('./chunk-V23XPVHO.cjs');
-require('./chunk-IB3KOSHW.cjs');
-require('./chunk-MXJEULSE.cjs');
+var chunkWTURYJEA_cjs = require('./chunk-WTURYJEA.cjs');
+require('./chunk-KOWTQJIX.cjs');
+require('./chunk-G33MXEHU.cjs');
 require('./chunk-Q7SFCCGT.cjs');
 
 
 
 Object.defineProperty(exports, "FinanceClient", {
   enumerable: true,
-  get: function () { return chunkV23XPVHO_cjs.FinanceClient; }
+  get: function () { return chunkWTURYJEA_cjs.FinanceClient; }
+});
+Object.defineProperty(exports, "TokenSaleClient", {
+  enumerable: true,
+  get: function () { return chunkWTURYJEA_cjs.TokenSaleClient; }
+});
+Object.defineProperty(exports, "usd", {
+  enumerable: true,
+  get: function () { return chunkWTURYJEA_cjs.usd; }
 });
 //# sourceMappingURL=tokens.cjs.map
 //# sourceMappingURL=tokens.cjs.map

package/dist/tokens.d.cts

@@ -1,5 +1,137 @@
 import { Address, Hash } from 'viem';
 import { P as PublicClient, W as WalletClient } from './doc-types-471vSmPO.cjs';
+import { L as LaunchSaleAddresses } from './addresses-D12T3kLs.cjs';
+
+/** Which token to buy from the launch sale stack. */
+type SaleTokenKind = 'GTOKEN' | 'APNTS';
+/** Stablecoin used to pay (both 6-decimal). Gasless supports USDC only. */
+type PayToken = 'USDC' | 'USDT';
+/** Live USD prices (6-decimal) for one unit of each sale token. */
+interface SalePrices {
+    /** USD price per GToken, 6-decimal (e.g. 150000n = $0.15). */
+    gToken: bigint;
+    /** USD price per aPNTs, 6-decimal. */
+    aPNTs: bigint;
+}
+/** Wallet balances relevant to the sale (raw base units). */
+interface SaleBalances {
+    /** Native ETH (wei). */
+    eth: bigint;
+    /** USDC (6-decimal). */
+    usdc: bigint;
+    /** USDT (6-decimal). */
+    usdt: bigint;
+    /** GToken (18-decimal). */
+    gToken: bigint;
+    /** aPNTs (18-decimal). */
+    aPNTs: bigint;
+}
+/** Result of a completed buy (self-pay or gasless). */
+interface BuyResult {
+    /** Transaction hash (gasless: the relayer-submitted tx). */
+    txHash: Hash;
+    /** Relayer rule that matched (gasless only). */
+    matchedRule?: string;
+}
+interface TokenSaleClientOptions {
+    /**
+     * Chain id. Defaults to `publicClient.chain?.id` / `walletClient.chain?.id`.
+     * Used to look up {@link getLaunchSaleAddresses}.
+     */
+    chainId?: number;
+    /** Explicit address group override (skips the per-chain lookup). */
+    addresses?: LaunchSaleAddresses;
+}
+interface SelfPayParams {
+    token: SaleTokenKind;
+    /** USD to spend, in 6-decimal base units (use {@link usd}). */
+    usdAmount: bigint;
+    /** Payment stablecoin. Default `'USDC'`. */
+    payToken?: PayToken;
+    /** Minimum tokens out (slippage guard, 18-decimal). Default `0n`. */
+    minOut?: bigint;
+}
+interface GaslessParams {
+    token: SaleTokenKind;
+    /** USD to spend, in 6-decimal base units (use {@link usd}). Paid in USDC. */
+    usdAmount: bigint;
+    /** Recipient of the purchased tokens. Default: the buyer. */
+    recipient?: Address;
+    /** Minimum tokens out (18-decimal). Default `0n`. */
+    minOut?: bigint;
+    /** Authorization validity window in seconds. Default `1800` (30 min). */
+    deadlineSeconds?: number;
+    /** Override the relayer base URL (default: the address group's `relayerUrl`). */
+    relayerUrl?: string;
+}
+/** Convert a human USD amount to 6-decimal base units. `usd(1.5)` → `1500000n`. */
+declare function usd(amount: number): bigint;
+/**
+ * TokenSaleClient — buy aPoints (aPNTs) and the governance token (GToken) from the
+ * MushroomDAO launch sale stack. Abstraction of the `launch.mushroom.cv/join` page.
+ *
+ * Two flows:
+ *  - {@link buySelfPay}: user pays gas; `approve` (if needed) then `buyTokens` / `buyAPNTs`.
+ *  - {@link buyGasless}: zero-gas; signs EIP-3009 (USDC) + an EIP-712 `BuyIntent` and posts
+ *    them to the relayer, which executes the buy via BuyHelper.
+ *
+ * The token actually paid out is read ON-CHAIN from the sale contract (`gToken()` / `aPNTs()`),
+ * never from a stored address — so it stays correct across sale redeploys.
+ *
+ * @example
+ * ```ts
+ * const sale = new TokenSaleClient(publicClient, walletClient);
+ * await sale.buyGasless({ token: 'GTOKEN', usdAmount: usd(5) }); // $5, zero gas
+ * ```
+ */
+declare class TokenSaleClient {
+    private readonly publicClient;
+    private readonly walletClient?;
+    private readonly addrs;
+    private readonly chainId;
+    /** Cache of on-chain-resolved payout token addresses. */
+    private payoutToken;
+    constructor(publicClient: PublicClient, walletClient?: WalletClient | undefined, options?: TokenSaleClientOptions);
+    /** The resolved address group in use. */
+    get addresses(): LaunchSaleAddresses;
+    /** Sale contract address for a token kind. */
+    private saleFor;
+    /**
+     * Resolve (and cache) the ERC-20 the sale actually pays out, by reading the sale
+     * contract's `gToken()` / `aPNTs()` immutable getter. This is the single source of
+     * truth for the payout token — no address is duplicated in the config.
+     */
+    getPayoutToken(token: SaleTokenKind): Promise<Address>;
+    /** Read live USD prices (6-decimal) for both sale tokens. */
+    getPrices(): Promise<SalePrices>;
+    /**
+     * Quote how many tokens (18-decimal) a USD amount buys, via the sale's on-chain
+     * pricing (`getTokensForUSD` / `getAPNTsForUSD`).
+     */
+    quote(token: SaleTokenKind, usdAmount: bigint): Promise<bigint>;
+    /** Read ETH / USDC / USDT / GToken / aPNTs balances for an account. */
+    getBalances(account: Address): Promise<SaleBalances>;
+    /**
+     * Buy with the user paying gas: ensures allowance (approves if short) then calls
+     * `buyTokens` / `buyAPNTs`. Tokens are sent to the buyer. Waits for both receipts.
+     */
+    buySelfPay(params: SelfPayParams): Promise<BuyResult>;
+    /**
+     * Buy with zero gas: signs an EIP-3009 USDC `TransferWithAuthorization` (to BuyHelper)
+     * and an EIP-712 `BuyIntent`, then posts both to the relayer's `/v3/relay`. Returns the
+     * relayer-submitted tx hash after on-chain confirmation. Payment is always USDC.
+     */
+    buyGasless(params: GaslessParams): Promise<BuyResult>;
+    private requireWallet;
+    /**
+     * Resolve the signing account. Returns the viem account OBJECT (a LocalAccount, or a
+     * JsonRpcAccount for injected wallets) for the `account` field of write/sign calls, plus
+     * its address for message fields. Passing the object — not a bare address string — is what
+     * lets a local private-key account sign locally instead of routing to `eth_signTypedData_v4`
+     * on the (key-less) RPC transport.
+     */
+    private signer;
+}
 
 declare class FinanceClient {
     private publicClient;
@@ -61,4 +193,4 @@ declare class FinanceClient {
     }>;
 }
 
-export { FinanceClient };
+export { type BuyResult, FinanceClient, type PayToken, type SaleBalances, type SalePrices, type SaleTokenKind, TokenSaleClient, type TokenSaleClientOptions, usd };

package/dist/tokens.d.ts

@@ -1,5 +1,137 @@
 import { Address, Hash } from 'viem';
 import { P as PublicClient, W as WalletClient } from './doc-types-471vSmPO.js';
+import { L as LaunchSaleAddresses } from './addresses-D12T3kLs.js';
+
+/** Which token to buy from the launch sale stack. */
+type SaleTokenKind = 'GTOKEN' | 'APNTS';
+/** Stablecoin used to pay (both 6-decimal). Gasless supports USDC only. */
+type PayToken = 'USDC' | 'USDT';
+/** Live USD prices (6-decimal) for one unit of each sale token. */
+interface SalePrices {
+    /** USD price per GToken, 6-decimal (e.g. 150000n = $0.15). */
+    gToken: bigint;
+    /** USD price per aPNTs, 6-decimal. */
+    aPNTs: bigint;
+}
+/** Wallet balances relevant to the sale (raw base units). */
+interface SaleBalances {
+    /** Native ETH (wei). */
+    eth: bigint;
+    /** USDC (6-decimal). */
+    usdc: bigint;
+    /** USDT (6-decimal). */
+    usdt: bigint;
+    /** GToken (18-decimal). */
+    gToken: bigint;
+    /** aPNTs (18-decimal). */
+    aPNTs: bigint;
+}
+/** Result of a completed buy (self-pay or gasless). */
+interface BuyResult {
+    /** Transaction hash (gasless: the relayer-submitted tx). */
+    txHash: Hash;
+    /** Relayer rule that matched (gasless only). */
+    matchedRule?: string;
+}
+interface TokenSaleClientOptions {
+    /**
+     * Chain id. Defaults to `publicClient.chain?.id` / `walletClient.chain?.id`.
+     * Used to look up {@link getLaunchSaleAddresses}.
+     */
+    chainId?: number;
+    /** Explicit address group override (skips the per-chain lookup). */
+    addresses?: LaunchSaleAddresses;
+}
+interface SelfPayParams {
+    token: SaleTokenKind;
+    /** USD to spend, in 6-decimal base units (use {@link usd}). */
+    usdAmount: bigint;
+    /** Payment stablecoin. Default `'USDC'`. */
+    payToken?: PayToken;
+    /** Minimum tokens out (slippage guard, 18-decimal). Default `0n`. */
+    minOut?: bigint;
+}
+interface GaslessParams {
+    token: SaleTokenKind;
+    /** USD to spend, in 6-decimal base units (use {@link usd}). Paid in USDC. */
+    usdAmount: bigint;
+    /** Recipient of the purchased tokens. Default: the buyer. */
+    recipient?: Address;
+    /** Minimum tokens out (18-decimal). Default `0n`. */
+    minOut?: bigint;
+    /** Authorization validity window in seconds. Default `1800` (30 min). */
+    deadlineSeconds?: number;
+    /** Override the relayer base URL (default: the address group's `relayerUrl`). */
+    relayerUrl?: string;
+}
+/** Convert a human USD amount to 6-decimal base units. `usd(1.5)` → `1500000n`. */
+declare function usd(amount: number): bigint;
+/**
+ * TokenSaleClient — buy aPoints (aPNTs) and the governance token (GToken) from the
+ * MushroomDAO launch sale stack. Abstraction of the `launch.mushroom.cv/join` page.
+ *
+ * Two flows:
+ *  - {@link buySelfPay}: user pays gas; `approve` (if needed) then `buyTokens` / `buyAPNTs`.
+ *  - {@link buyGasless}: zero-gas; signs EIP-3009 (USDC) + an EIP-712 `BuyIntent` and posts
+ *    them to the relayer, which executes the buy via BuyHelper.
+ *
+ * The token actually paid out is read ON-CHAIN from the sale contract (`gToken()` / `aPNTs()`),
+ * never from a stored address — so it stays correct across sale redeploys.
+ *
+ * @example
+ * ```ts
+ * const sale = new TokenSaleClient(publicClient, walletClient);
+ * await sale.buyGasless({ token: 'GTOKEN', usdAmount: usd(5) }); // $5, zero gas
+ * ```
+ */
+declare class TokenSaleClient {
+    private readonly publicClient;
+    private readonly walletClient?;
+    private readonly addrs;
+    private readonly chainId;
+    /** Cache of on-chain-resolved payout token addresses. */
+    private payoutToken;
+    constructor(publicClient: PublicClient, walletClient?: WalletClient | undefined, options?: TokenSaleClientOptions);
+    /** The resolved address group in use. */
+    get addresses(): LaunchSaleAddresses;
+    /** Sale contract address for a token kind. */
+    private saleFor;
+    /**
+     * Resolve (and cache) the ERC-20 the sale actually pays out, by reading the sale
+     * contract's `gToken()` / `aPNTs()` immutable getter. This is the single source of
+     * truth for the payout token — no address is duplicated in the config.
+     */
+    getPayoutToken(token: SaleTokenKind): Promise<Address>;
+    /** Read live USD prices (6-decimal) for both sale tokens. */
+    getPrices(): Promise<SalePrices>;
+    /**
+     * Quote how many tokens (18-decimal) a USD amount buys, via the sale's on-chain
+     * pricing (`getTokensForUSD` / `getAPNTsForUSD`).
+     */
+    quote(token: SaleTokenKind, usdAmount: bigint): Promise<bigint>;
+    /** Read ETH / USDC / USDT / GToken / aPNTs balances for an account. */
+    getBalances(account: Address): Promise<SaleBalances>;
+    /**
+     * Buy with the user paying gas: ensures allowance (approves if short) then calls
+     * `buyTokens` / `buyAPNTs`. Tokens are sent to the buyer. Waits for both receipts.
+     */
+    buySelfPay(params: SelfPayParams): Promise<BuyResult>;
+    /**
+     * Buy with zero gas: signs an EIP-3009 USDC `TransferWithAuthorization` (to BuyHelper)
+     * and an EIP-712 `BuyIntent`, then posts both to the relayer's `/v3/relay`. Returns the
+     * relayer-submitted tx hash after on-chain confirmation. Payment is always USDC.
+     */
+    buyGasless(params: GaslessParams): Promise<BuyResult>;
+    private requireWallet;
+    /**
+     * Resolve the signing account. Returns the viem account OBJECT (a LocalAccount, or a
+     * JsonRpcAccount for injected wallets) for the `account` field of write/sign calls, plus
+     * its address for message fields. Passing the object — not a bare address string — is what
+     * lets a local private-key account sign locally instead of routing to `eth_signTypedData_v4`
+     * on the (key-less) RPC transport.
+     */
+    private signer;
+}
 
 declare class FinanceClient {
     private publicClient;
@@ -61,4 +193,4 @@ declare class FinanceClient {
     }>;
 }
 
-export { FinanceClient };
+export { type BuyResult, FinanceClient, type PayToken, type SaleBalances, type SalePrices, type SaleTokenKind, TokenSaleClient, type TokenSaleClientOptions, usd };

package/dist/tokens.js

@@ -1,6 +1,6 @@
-export { FinanceClient } from './chunk-O2CN77MV.js';
-import './chunk-EEWLL7GE.js';
-import './chunk-UCLK6LTB.js';
+export { FinanceClient, TokenSaleClient, usd } from './chunk-L6D2AGTF.js';
+import './chunk-6DZCDV4Q.js';
+import './chunk-MBWBHKUE.js';
 import './chunk-PZ5AY32C.js';
 //# sourceMappingURL=tokens.js.map
 //# sourceMappingURL=tokens.js.map

package/dist/x402.cjs

@@ -1,103 +1,103 @@
 'use strict';
 
-var chunkTQIRRSGL_cjs = require('./chunk-TQIRRSGL.cjs');
-require('./chunk-IB3KOSHW.cjs');
-require('./chunk-MXJEULSE.cjs');
+var chunkFIMXPANS_cjs = require('./chunk-FIMXPANS.cjs');
+require('./chunk-KOWTQJIX.cjs');
+require('./chunk-G33MXEHU.cjs');
 require('./chunk-Q7SFCCGT.cjs');
 
 
 
 Object.defineProperty(exports, "EIP3009_TYPES", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.EIP3009_TYPES; }
+  get: function () { return chunkFIMXPANS_cjs.EIP3009_TYPES; }
 });
 Object.defineProperty(exports, "FacilitatorClient", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.FacilitatorClient; }
+  get: function () { return chunkFIMXPANS_cjs.FacilitatorClient; }
 });
 Object.defineProperty(exports, "GTOKEN_EIP712_DOMAIN", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.GTOKEN_EIP712_DOMAIN; }
+  get: function () { return chunkFIMXPANS_cjs.GTOKEN_EIP712_DOMAIN; }
 });
 Object.defineProperty(exports, "HEADER_PAYMENT_REQUIRED", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.HEADER_PAYMENT_REQUIRED; }
+  get: function () { return chunkFIMXPANS_cjs.HEADER_PAYMENT_REQUIRED; }
 });
 Object.defineProperty(exports, "HEADER_PAYMENT_RESPONSE", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.HEADER_PAYMENT_RESPONSE; }
+  get: function () { return chunkFIMXPANS_cjs.HEADER_PAYMENT_RESPONSE; }
 });
 Object.defineProperty(exports, "HEADER_PAYMENT_SIGNATURE", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.HEADER_PAYMENT_SIGNATURE; }
+  get: function () { return chunkFIMXPANS_cjs.HEADER_PAYMENT_SIGNATURE; }
 });
 Object.defineProperty(exports, "HEADER_V1_PAYMENT", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.HEADER_V1_PAYMENT; }
+  get: function () { return chunkFIMXPANS_cjs.HEADER_V1_PAYMENT; }
 });
 Object.defineProperty(exports, "HEADER_V1_PAYMENT_RESPONSE", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.HEADER_V1_PAYMENT_RESPONSE; }
+  get: function () { return chunkFIMXPANS_cjs.HEADER_V1_PAYMENT_RESPONSE; }
 });
 Object.defineProperty(exports, "X402Client", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.X402Client; }
+  get: function () { return chunkFIMXPANS_cjs.X402Client; }
 });
 Object.defineProperty(exports, "decodePaymentPayload", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.decodePaymentPayload; }
+  get: function () { return chunkFIMXPANS_cjs.decodePaymentPayload; }
 });
 Object.defineProperty(exports, "decodePaymentRequired", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.decodePaymentRequired; }
+  get: function () { return chunkFIMXPANS_cjs.decodePaymentRequired; }
 });
 Object.defineProperty(exports, "decodeSettleResponse", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.decodeSettleResponse; }
+  get: function () { return chunkFIMXPANS_cjs.decodeSettleResponse; }
 });
 Object.defineProperty(exports, "encodePaymentPayload", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.encodePaymentPayload; }
+  get: function () { return chunkFIMXPANS_cjs.encodePaymentPayload; }
 });
 Object.defineProperty(exports, "encodePaymentRequired", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.encodePaymentRequired; }
+  get: function () { return chunkFIMXPANS_cjs.encodePaymentRequired; }
 });
 Object.defineProperty(exports, "encodeSettleResponse", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.encodeSettleResponse; }
+  get: function () { return chunkFIMXPANS_cjs.encodeSettleResponse; }
 });
 Object.defineProperty(exports, "extractPaymentRequired", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.extractPaymentRequired; }
+  get: function () { return chunkFIMXPANS_cjs.extractPaymentRequired; }
 });
 Object.defineProperty(exports, "extractSettleResponse", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.extractSettleResponse; }
+  get: function () { return chunkFIMXPANS_cjs.extractSettleResponse; }
 });
 Object.defineProperty(exports, "generateNonce", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.generateNonce; }
+  get: function () { return chunkFIMXPANS_cjs.generateNonce; }
 });
 Object.defineProperty(exports, "getEIP3009Domain", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.getEIP3009Domain; }
+  get: function () { return chunkFIMXPANS_cjs.getEIP3009Domain; }
 });
 Object.defineProperty(exports, "signCancelAuthorization", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.signCancelAuthorization; }
+  get: function () { return chunkFIMXPANS_cjs.signCancelAuthorization; }
 });
 Object.defineProperty(exports, "signGTokenTransferWithAuthorization", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.signGTokenTransferWithAuthorization; }
+  get: function () { return chunkFIMXPANS_cjs.signGTokenTransferWithAuthorization; }
 });
 Object.defineProperty(exports, "signReceiveWithAuthorization", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.signReceiveWithAuthorization; }
+  get: function () { return chunkFIMXPANS_cjs.signReceiveWithAuthorization; }
 });
 Object.defineProperty(exports, "signTransferWithAuthorization", {
   enumerable: true,
-  get: function () { return chunkTQIRRSGL_cjs.signTransferWithAuthorization; }
+  get: function () { return chunkFIMXPANS_cjs.signTransferWithAuthorization; }
 });
 //# sourceMappingURL=x402.cjs.map
 //# sourceMappingURL=x402.cjs.map

package/dist/x402.js

@@ -1,6 +1,6 @@
-export { EIP3009_TYPES, FacilitatorClient, GTOKEN_EIP712_DOMAIN, HEADER_PAYMENT_REQUIRED, HEADER_PAYMENT_RESPONSE, HEADER_PAYMENT_SIGNATURE, HEADER_V1_PAYMENT, HEADER_V1_PAYMENT_RESPONSE, X402Client, decodePaymentPayload, decodePaymentRequired, decodeSettleResponse, encodePaymentPayload, encodePaymentRequired, encodeSettleResponse, extractPaymentRequired, extractSettleResponse, generateNonce, getEIP3009Domain, signCancelAuthorization, signGTokenTransferWithAuthorization, signReceiveWithAuthorization, signTransferWithAuthorization } from './chunk-PTVXBXZX.js';
-import './chunk-EEWLL7GE.js';
-import './chunk-UCLK6LTB.js';
+export { EIP3009_TYPES, FacilitatorClient, GTOKEN_EIP712_DOMAIN, HEADER_PAYMENT_REQUIRED, HEADER_PAYMENT_RESPONSE, HEADER_PAYMENT_SIGNATURE, HEADER_V1_PAYMENT, HEADER_V1_PAYMENT_RESPONSE, X402Client, decodePaymentPayload, decodePaymentRequired, decodeSettleResponse, encodePaymentPayload, encodePaymentRequired, encodeSettleResponse, extractPaymentRequired, extractSettleResponse, generateNonce, getEIP3009Domain, signCancelAuthorization, signGTokenTransferWithAuthorization, signReceiveWithAuthorization, signTransferWithAuthorization } from './chunk-UANSP3OK.js';
+import './chunk-6DZCDV4Q.js';
+import './chunk-MBWBHKUE.js';
 import './chunk-PZ5AY32C.js';
 //# sourceMappingURL=x402.js.map
 //# sourceMappingURL=x402.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aastar/sdk",
-  "version": "0.24.2",
+  "version": "0.25.0",
   "description": "All-in-one TypeScript SDK for the AAStar Protocol / Mycelium Network — ERC-4337 account abstraction, gasless transactions, SuperPaymaster gas sponsorship, KMS WebAuthn passkeys, BLS aggregate signatures, multi-chain (Optimism + Ethereum) community economies & reputation. Single bundled package with subpath exports.",
   "keywords": [
     "erc-4337",

package/dist/UserClient-4MRK2D7W.cjs

@@ -1,15 +0,0 @@
-'use strict';
-
-var chunkTGEVD7OR_cjs = require('./chunk-TGEVD7OR.cjs');
-require('./chunk-IB3KOSHW.cjs');
-require('./chunk-MXJEULSE.cjs');
-require('./chunk-Q7SFCCGT.cjs');
-
-
-
-Object.defineProperty(exports, "UserClient", {
-  enumerable: true,
-  get: function () { return chunkTGEVD7OR_cjs.UserClient; }
-});
-//# sourceMappingURL=UserClient-4MRK2D7W.cjs.map
-//# sourceMappingURL=UserClient-4MRK2D7W.cjs.map

package/dist/UserClient-DPJ6E2XL.js

@@ -1,6 +0,0 @@
-export { UserClient } from './chunk-W73Y6JWZ.js';
-import './chunk-EEWLL7GE.js';
-import './chunk-UCLK6LTB.js';
-import './chunk-PZ5AY32C.js';
-//# sourceMappingURL=UserClient-DPJ6E2XL.js.map
-//# sourceMappingURL=UserClient-DPJ6E2XL.js.map