agentwallet-sdk 3.0.0 → 3.1.1

package/README.md

@@ -12,16 +12,19 @@ Agent spent $490 today → 🛑 Next tx queued ($500/day limit hit)
 
 ## How We Compare
 
-| | **agentwallet-sdk** | **Coinbase Agentic Wallet** | **MoonPay Agents** |
-|---|---|---|---|
-| **Custody** | Non-custodial (keys on device) | Semi-custodial (TEE) | Non-custodial (claimed) |
-| **Spend Limits** | On-chain (smart contract) | API-enforced | Not documented |
-| **Chains** | 5 (Base, ETH, Arb, Polygon, Sepolia) | Base only | Unclear |
-| **Agent Identity** | ERC-8004 + ERC-6551 | None | None |
-| **Open Source** | MIT | Partial | Closed |
-| **x402 Payments** | Native | Supported | "Compatible" |
-
-> On-chain spend limits can't be bypassed even if the API layer is compromised. That's the difference between policy and math.
+| | **agentwallet-sdk** | **Coinbase Agentic** | **OKX OnchainOS** | **Binance Agent** | **MoonPay Agents** |
+|---|---|---|---|---|---|
+| **Custody** | Non-custodial (agent holds keys) | Semi-custodial (TEE) | Custodial (exchange) | Custodial (exchange) | Non-custodial (claimed) |
+| **Spend Limits** | On-chain (smart contract) | API-enforced | Not documented | Not documented | Not documented |
+| **Chains** | **17** (16 EVM + Solana) | Base only | 60+ (custodial) | Binance chain | Unclear |
+| **Agent Identity** | ERC-8004 + ERC-6551 | None | None | None | None |
+| **Open Source** | MIT | Partial | Closed | Closed | Closed |
+| **x402 Payments** | Native | Supported | Supported | No | "Compatible" |
+| **Jupiter Swaps** | Yes (Solana) | No | No | No | No |
+| **CCTP Bridging** | 17-chain V2 | No | Partial | No | No |
+| **If exchange goes down** | Agent keeps working | Degraded | Agent stops | Agent stops | Unknown |
+
+> On-chain spend limits can't be bypassed even if the API layer is compromised. Exchanges can freeze your agent's account. A non-custodial smart contract can't. That's the difference between policy and math.
 
 ## Why Agent Wallet?
 
@@ -611,6 +614,219 @@ const devnet = getSolanaConfig('solana-devnet');
 
 ---
 
+## Gas Sponsorship (v3.1.0)
+
+Agents don't need to hold native gas tokens. Alchemy's ERC-4337 Gas Manager sponsors gas on their behalf.
+
+**Requires:**
+- An Alchemy API key with Gas Manager enabled
+- A Gas Manager policy ID (create at [dashboard.alchemy.com/gas-manager](https://dashboard.alchemy.com/gas-manager))
+- An ERC-4337 smart account for the agent (plain EOAs cannot use paymasters)
+
+**Supported chains (6 of 17 CCTP chains):** `ethereum`, `base`, `arbitrum`, `optimism`, `polygon`, `worldchain`
+
+```typescript
+import { GasSponsor } from 'agentwallet-sdk';
+
+const sponsor = new GasSponsor({
+  alchemyApiKey: process.env.ALCHEMY_API_KEY!,
+  policyId: process.env.ALCHEMY_GAS_POLICY_ID!, // from Alchemy dashboard
+});
+
+// Check support before attempting
+if (sponsor.isSupported('base')) {
+  const sponsored = await sponsor.sponsorTransaction({
+    chain: 'base',
+    from: agentSmartAccountAddress, // must be ERC-4337 smart account
+    to: usdcContract,
+    data: transferCalldata,
+  });
+  // Submit sponsored.userOperation to an ERC-4337 bundler
+  // e.g. via eth_sendUserOperation
+}
+
+// Sponsor a bridge transaction
+const sponsoredBridge = await sponsor.sponsorBridge({
+  chain: 'optimism',
+  from: agentSmartAccountAddress,
+  bridgeTx: {
+    to: TOKEN_MESSENGER_V2['optimism'],
+    data: depositForBurnCalldata,
+    value: 0n,
+  },
+});
+
+// List all supported chains
+const chains = sponsor.getSupportedChains();
+// ['ethereum', 'base', 'arbitrum', 'optimism', 'polygon', 'worldchain']
+```
+
+---
+
+## Settlement Verification (v3.1.0)
+
+Verify that bridge transfers and x402 payments actually settled on-chain. Useful for agents that need to confirm receipt before proceeding.
+
+```typescript
+import { SettlementVerifier } from 'agentwallet-sdk';
+
+const verifier = new SettlementVerifier({
+  alchemyApiKey: process.env.ALCHEMY_API_KEY, // optional — falls back to public RPCs
+});
+
+// Verify any EVM transaction
+const evmResult = await verifier.verifyEvmTransaction({
+  chain: 'base',
+  txHash: '0xabc123...',
+  confirmations: 1, // default: 1
+});
+// { status: 'confirmed', blockNumber: 12345n, confirmations: 5, gasUsed: 21000n, success: true }
+
+// Verify a Solana transaction
+const solResult = await verifier.verifySolanaTransaction({
+  signature: 'base58sig...',
+  commitment: 'finalized', // 'confirmed' | 'finalized', default: 'confirmed'
+});
+
+// Verify a CCTP bridge transfer end-to-end
+const bridgeResult = await verifier.verifyBridgeSettlement({
+  sourceTxHash: '0xburntx...',
+  sourceChain: 'base',         // or 'solana'
+  destinationChain: 'arbitrum',
+  expectedAmount: 1_000_000n,  // 1 USDC (6 decimals)
+});
+// { status: 'attestation_complete_awaiting_mint', sourceTx: {...}, attestationStatus: 'complete' }
+
+// Verify an x402 payment via ERC20 Transfer event logs
+const paymentResult = await verifier.verifyX402Payment({
+  chain: 'base',
+  txHash: '0xpaymenttx...',
+  expectedPayee: '0xMerchantAddress',
+  expectedAmount: 1_000_000n, // 1 USDC
+});
+// { status: 'confirmed', payeeVerified: true, amountVerified: true, actualAmount: 1000000n }
+```
+
+### Settlement Status Types
+
+| Status | Meaning |
+|--------|---------|
+| `confirmed` | Transaction mined with required confirmations |
+| `pending` | Transaction in mempool or not enough confirmations |
+| `failed` | Transaction reverted (status=0) |
+| `not_found` | Transaction not found or RPC error |
+
+Bridge-specific statuses:
+
+| Status | Meaning |
+|--------|---------|
+| `source_confirmed_awaiting_attestation` | Burn tx confirmed, Circle attestation pending |
+| `attestation_complete_awaiting_mint` | Attestation ready, destination mint not yet verified |
+| `complete` | Full bridge cycle confirmed |
+| `source_failed` | Source burn transaction reverted |
+
+---
+
+## Fiat Onramp (Optional — v3.2.0)
+
+> **This module is entirely opt-in. The core SDK is fully anonymous and non-custodial.**
+> Users who fund their agent wallet via direct crypto transfer, bridge, or any other method
+> **never encounter KYC** and remain completely anonymous.
+> KYC only occurs when you explicitly choose to use the fiat onramp feature.
+
+The `FiatOnramp` class aggregates multiple fiat-to-crypto providers (MoonPay, Stripe, Transak)
+into a single interface. It returns a `purchaseUrl` — opening this URL takes the user to the
+provider's hosted KYC + payment page. **The SDK never sees, stores, or transmits any KYC data.**
+
+### Install
+
+No additional packages needed — `FiatOnramp` is included in `agentwallet-sdk`.
+
+Get API keys from the provider dashboards:
+
+- **MoonPay:** https://dashboard.moonpay.com (publishable key)
+- **Stripe:** https://dashboard.stripe.com (secret key — server-side only)
+- **Transak:** https://dashboard.transak.com (API key)
+
+### Usage
+
+```typescript
+import { FiatOnramp } from 'agentwallet-sdk';
+
+// Only configure the providers you have keys for.
+// Omitting all keys is valid — returns empty provider list with zero friction.
+const onramp = new FiatOnramp({
+  moonpayApiKey: process.env.MOONPAY_API_KEY,
+  transakApiKey: process.env.TRANSAK_API_KEY,
+});
+
+// Get quotes from all configured providers that support base/USDC
+const quotes = await onramp.getQuotes({
+  amount: 100,
+  currency: 'USD',
+  token: 'USDC',
+  chain: 'base',
+  walletAddress: '0xYourAgentWalletAddress',
+});
+
+// quotes[0].kycRequired is always true — KYC happens on the provider's hosted page
+console.log(quotes[0].purchaseUrl); // Open this URL in a browser to complete purchase
+
+// Or target a specific provider
+const session = await onramp.createSession({
+  amount: 100,
+  currency: 'USD',
+  token: 'USDC',
+  chain: 'base',
+  walletAddress: '0xYourAgentWalletAddress',
+  provider: 'moonpay',
+  redirectUrl: 'https://yourapp.com/done', // optional
+});
+
+console.log(session.purchaseUrl); // MoonPay hosted KYC + payment page
+console.log(session.feeAmount);   // e.g., 2.50
+console.log(session.feePercent);  // e.g., 2.5
+```
+
+### Supported Chains & Tokens
+
+| Provider | Chains | Tokens |
+|----------|--------|--------|
+| MoonPay  | ethereum, base, solana, polygon, arbitrum, optimism | ETH, USDC, USDT, SOL, MATIC |
+| Stripe   | ethereum, base, solana, polygon, arbitrum, optimism | ETH, USDC, SOL, MATIC |
+| Transak  | ethereum, base, solana, polygon, arbitrum, optimism, avalanche, bsc | ETH, USDC, USDT, SOL, MATIC, AVAX, BNB |
+
+### API
+
+```typescript
+// Get quotes from all configured providers
+getQuotes(params: OnrampParams): Promise<FiatQuote[]>
+
+// Create a session with a specific provider
+createSession(params: OnrampParams & { provider: string }): Promise<FiatQuote>
+
+// Check if a provider supports a chain/token combo
+isSupported(provider: string, chain: string, token: string): boolean
+
+// Get configured provider names
+getProviders(): string[]
+
+// Get supported chains for a provider
+getSupportedChains(provider: string): string[]
+
+// Get supported tokens on a chain for a provider
+getSupportedTokens(provider: string, chain: string): string[]
+```
+
+### Privacy Guarantee
+
+- The SDK **never** collects, stores, or transmits KYC data
+- The SDK **never** stores payment info (no card numbers, no bank accounts)
+- KYC + payment happen entirely on the provider's hosted page
+- Direct crypto funding (transfer, bridge, swap) = fully anonymous, no KYC, ever
+
+---
+
 ## License
 
 MIT

package/dist/fiat/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Fiat Onramp module — optional fiat-to-crypto for agentwallet-sdk.
+ *
+ * This module is OPT-IN ONLY. Import and use FiatOnramp only if you want
+ * fiat onramp capability. The core SDK is fully anonymous and non-custodial.
+ */
+export { FiatOnramp } from './onramp.js';
+export type { FiatOnrampConfig, FiatQuote, OnrampParams, FiatProvider } from './types.js';
+export { MoonPayProvider, StripeProvider, TransakProvider } from './providers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/fiat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fiat/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1F,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/fiat/index.js

@@ -0,0 +1,9 @@
+/**
+ * Fiat Onramp module — optional fiat-to-crypto for agentwallet-sdk.
+ *
+ * This module is OPT-IN ONLY. Import and use FiatOnramp only if you want
+ * fiat onramp capability. The core SDK is fully anonymous and non-custodial.
+ */
+export { FiatOnramp } from './onramp.js';
+export { MoonPayProvider, StripeProvider, TransakProvider } from './providers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/fiat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fiat/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/fiat/onramp.d.ts

@@ -0,0 +1,101 @@
+/**
+ * FiatOnramp — optional fiat-to-crypto onramp module for agentwallet-sdk.
+ *
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║  KYC NOTICE — IMPORTANT                                             ║
+ * ║                                                                      ║
+ * ║  This module is entirely OPT-IN. Users who fund their agent wallet  ║
+ * ║  via direct crypto transfer, bridge, or any other method NEVER      ║
+ * ║  encounter KYC and remain fully anonymous.                           ║
+ * ║                                                                      ║
+ * ║  KYC only occurs when a user explicitly chooses to use this fiat    ║
+ * ║  onramp feature. KYC is handled entirely by the third-party         ║
+ * ║  provider (MoonPay, Stripe, Transak) on their hosted page.          ║
+ * ║  The SDK never collects, stores, or transmits any KYC data.         ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import type { FiatOnrampConfig, FiatQuote, OnrampParams } from './types.js';
+/**
+ * FiatOnramp — aggregates multiple fiat onramp providers into a single interface.
+ *
+ * @example
+ * ```typescript
+ * import { FiatOnramp } from 'agentwallet-sdk';
+ *
+ * // Only configure providers you have API keys for
+ * const onramp = new FiatOnramp({
+ *   moonpayApiKey: process.env.MOONPAY_API_KEY,
+ *   transakApiKey: process.env.TRANSAK_API_KEY,
+ * });
+ *
+ * // Get quotes from all configured providers
+ * const quotes = await onramp.getQuotes({
+ *   amount: 100,
+ *   currency: 'USD',
+ *   token: 'USDC',
+ *   chain: 'base',
+ *   walletAddress: '0xYourWalletAddress',
+ * });
+ *
+ * // Open the purchaseUrl in a browser to complete KYC + payment on the provider's page
+ * console.log(quotes[0].purchaseUrl);
+ * ```
+ */
+export declare class FiatOnramp {
+    private providers;
+    private config;
+    /**
+     * Create a FiatOnramp instance.
+     *
+     * @param config - Provider API keys and defaults. All fields are optional.
+     *                 Passing no config (or an empty object) is valid — it returns
+     *                 an empty provider list, causing zero friction for users who
+     *                 don't want fiat onramp.
+     */
+    constructor(config?: FiatOnrampConfig);
+    /**
+     * Get quotes from all configured providers that support the given chain/token.
+     * Failed providers are silently skipped (logged to console.warn).
+     *
+     * @returns Array of FiatQuote — may be empty if no providers are configured
+     *          or if none support the requested chain/token combination.
+     */
+    getQuotes(params: OnrampParams): Promise<FiatQuote[]>;
+    /**
+     * Create a purchase session with a specific provider.
+     * Returns a FiatQuote containing a purchaseUrl — open this in a browser
+     * to complete KYC + payment on the provider's hosted page.
+     *
+     * @throws Error if the provider is not configured or doesn't support the chain/token.
+     */
+    createSession(params: OnrampParams & {
+        provider: string;
+    }): Promise<FiatQuote>;
+    /**
+     * Check if a provider supports a given chain/token combination.
+     *
+     * @param provider - Provider name: 'moonpay', 'stripe', 'transak'
+     * @param chain - Blockchain name: 'ethereum', 'base', 'solana', etc.
+     * @param token - Token symbol: 'USDC', 'ETH', 'SOL', etc.
+     */
+    isSupported(provider: string, chain: string, token: string): boolean;
+    /**
+     * Get the names of all configured providers.
+     * Returns an empty array if no API keys were provided.
+     */
+    getProviders(): string[];
+    /**
+     * Get the chains supported by a given provider.
+     *
+     * @param provider - Provider name: 'moonpay', 'stripe', 'transak'
+     */
+    getSupportedChains(provider: string): string[];
+    /**
+     * Get the tokens supported by a given provider on a given chain.
+     *
+     * @param provider - Provider name: 'moonpay', 'stripe', 'transak'
+     * @param chain - Blockchain name: 'ethereum', 'base', 'solana', etc.
+     */
+    getSupportedTokens(provider: string, chain: string): string[];
+}
+//# sourceMappingURL=onramp.d.ts.map

package/dist/fiat/onramp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onramp.d.ts","sourceRoot":"","sources":["../../src/fiat/onramp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAgB,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1F;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAiB;IAClC,OAAO,CAAC,MAAM,CAAmB;IAEjC;;;;;;;OAOG;gBACS,MAAM,GAAE,gBAAqB;IAKzC;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA2B3D;;;;;;OAMG;IACG,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IA8BpF;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAOpE;;;OAGG;IACH,YAAY,IAAI,MAAM,EAAE;IAIxB;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAM9C;;;;;OAKG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;CAK9D"}

package/dist/fiat/onramp.js

@@ -0,0 +1,155 @@
+/**
+ * FiatOnramp — optional fiat-to-crypto onramp module for agentwallet-sdk.
+ *
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║  KYC NOTICE — IMPORTANT                                             ║
+ * ║                                                                      ║
+ * ║  This module is entirely OPT-IN. Users who fund their agent wallet  ║
+ * ║  via direct crypto transfer, bridge, or any other method NEVER      ║
+ * ║  encounter KYC and remain fully anonymous.                           ║
+ * ║                                                                      ║
+ * ║  KYC only occurs when a user explicitly chooses to use this fiat    ║
+ * ║  onramp feature. KYC is handled entirely by the third-party         ║
+ * ║  provider (MoonPay, Stripe, Transak) on their hosted page.          ║
+ * ║  The SDK never collects, stores, or transmits any KYC data.         ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import { buildProviders } from './providers/index.js';
+/**
+ * FiatOnramp — aggregates multiple fiat onramp providers into a single interface.
+ *
+ * @example
+ * ```typescript
+ * import { FiatOnramp } from 'agentwallet-sdk';
+ *
+ * // Only configure providers you have API keys for
+ * const onramp = new FiatOnramp({
+ *   moonpayApiKey: process.env.MOONPAY_API_KEY,
+ *   transakApiKey: process.env.TRANSAK_API_KEY,
+ * });
+ *
+ * // Get quotes from all configured providers
+ * const quotes = await onramp.getQuotes({
+ *   amount: 100,
+ *   currency: 'USD',
+ *   token: 'USDC',
+ *   chain: 'base',
+ *   walletAddress: '0xYourWalletAddress',
+ * });
+ *
+ * // Open the purchaseUrl in a browser to complete KYC + payment on the provider's page
+ * console.log(quotes[0].purchaseUrl);
+ * ```
+ */
+export class FiatOnramp {
+    /**
+     * Create a FiatOnramp instance.
+     *
+     * @param config - Provider API keys and defaults. All fields are optional.
+     *                 Passing no config (or an empty object) is valid — it returns
+     *                 an empty provider list, causing zero friction for users who
+     *                 don't want fiat onramp.
+     */
+    constructor(config = {}) {
+        this.config = config;
+        this.providers = buildProviders(config);
+    }
+    /**
+     * Get quotes from all configured providers that support the given chain/token.
+     * Failed providers are silently skipped (logged to console.warn).
+     *
+     * @returns Array of FiatQuote — may be empty if no providers are configured
+     *          or if none support the requested chain/token combination.
+     */
+    async getQuotes(params) {
+        const resolvedParams = {
+            ...params,
+            currency: params.currency ?? this.config.defaultCurrency ?? 'USD',
+        };
+        const supportedProviders = this.providers.filter((p) => this.isSupported(p.name, resolvedParams.chain, resolvedParams.token));
+        const results = await Promise.allSettled(supportedProviders.map((p) => p.getQuote(resolvedParams)));
+        const quotes = [];
+        for (let i = 0; i < results.length; i++) {
+            const result = results[i];
+            if (result.status === 'fulfilled') {
+                quotes.push(result.value);
+            }
+            else {
+                console.warn(`[FiatOnramp] ${supportedProviders[i].name} quote failed:`, result.reason);
+            }
+        }
+        return quotes;
+    }
+    /**
+     * Create a purchase session with a specific provider.
+     * Returns a FiatQuote containing a purchaseUrl — open this in a browser
+     * to complete KYC + payment on the provider's hosted page.
+     *
+     * @throws Error if the provider is not configured or doesn't support the chain/token.
+     */
+    async createSession(params) {
+        const { provider: providerName, ...onrampParams } = params;
+        const resolvedParams = {
+            ...onrampParams,
+            currency: onrampParams.currency ?? this.config.defaultCurrency ?? 'USD',
+        };
+        const provider = this.providers.find((p) => p.name === providerName);
+        if (!provider) {
+            const configuredNames = this.providers.map((p) => p.name);
+            if (configuredNames.length === 0) {
+                throw new Error(`No fiat providers configured. Add an API key for '${providerName}' in FiatOnrampConfig.`);
+            }
+            throw new Error(`Provider '${providerName}' is not configured. Configured providers: ${configuredNames.join(', ')}`);
+        }
+        if (!this.isSupported(providerName, resolvedParams.chain, resolvedParams.token)) {
+            throw new Error(`Provider '${providerName}' does not support ${resolvedParams.token} on ${resolvedParams.chain}. ` +
+                `Supported tokens: ${(provider.supportedAssets[resolvedParams.chain] ?? []).join(', ')}`);
+        }
+        return provider.createSession(resolvedParams);
+    }
+    /**
+     * Check if a provider supports a given chain/token combination.
+     *
+     * @param provider - Provider name: 'moonpay', 'stripe', 'transak'
+     * @param chain - Blockchain name: 'ethereum', 'base', 'solana', etc.
+     * @param token - Token symbol: 'USDC', 'ETH', 'SOL', etc.
+     */
+    isSupported(provider, chain, token) {
+        const p = this.providers.find((pr) => pr.name === provider);
+        if (!p)
+            return false;
+        const tokens = p.supportedAssets[chain.toLowerCase()];
+        return Array.isArray(tokens) && tokens.includes(token.toUpperCase());
+    }
+    /**
+     * Get the names of all configured providers.
+     * Returns an empty array if no API keys were provided.
+     */
+    getProviders() {
+        return this.providers.map((p) => p.name);
+    }
+    /**
+     * Get the chains supported by a given provider.
+     *
+     * @param provider - Provider name: 'moonpay', 'stripe', 'transak'
+     */
+    getSupportedChains(provider) {
+        const p = this.providers.find((pr) => pr.name === provider);
+        if (!p)
+            return [];
+        return Object.keys(p.supportedAssets);
+    }
+    /**
+     * Get the tokens supported by a given provider on a given chain.
+     *
+     * @param provider - Provider name: 'moonpay', 'stripe', 'transak'
+     * @param chain - Blockchain name: 'ethereum', 'base', 'solana', etc.
+     */
+    getSupportedTokens(provider, chain) {
+        const p = this.providers.find((pr) => pr.name === provider);
+        if (!p)
+            return [];
+        return p.supportedAssets[chain.toLowerCase()] ?? [];
+    }
+}
+//# sourceMappingURL=onramp.js.map

package/dist/fiat/onramp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onramp.js","sourceRoot":"","sources":["../../src/fiat/onramp.ts"],"names":[],"mappings":"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"}

package/dist/fiat/providers/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Provider registry — assembles configured providers from FiatOnrampConfig.
+ */
+import type { FiatOnrampConfig, FiatProvider } from '../types.js';
+export { MoonPayProvider } from './moonpay.js';
+export { StripeProvider } from './stripe.js';
+export { TransakProvider } from './transak.js';
+/**
+ * Build the list of configured providers from the given config.
+ * Providers without an API key are excluded gracefully.
+ */
+export declare function buildProviders(config: FiatOnrampConfig): FiatProvider[];
+/** All known provider names */
+export declare const ALL_PROVIDER_NAMES: readonly ["moonpay", "stripe", "transak"];
+export type ProviderName = (typeof ALL_PROVIDER_NAMES)[number];
+//# sourceMappingURL=index.d.ts.map

package/dist/fiat/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fiat/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKlE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAevE;AAED,+BAA+B;AAC/B,eAAO,MAAM,kBAAkB,2CAA4C,CAAC;AAC5E,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/fiat/providers/index.js

@@ -0,0 +1,30 @@
+/**
+ * Provider registry — assembles configured providers from FiatOnrampConfig.
+ */
+import { MoonPayProvider } from './moonpay.js';
+import { StripeProvider } from './stripe.js';
+import { TransakProvider } from './transak.js';
+export { MoonPayProvider } from './moonpay.js';
+export { StripeProvider } from './stripe.js';
+export { TransakProvider } from './transak.js';
+/**
+ * Build the list of configured providers from the given config.
+ * Providers without an API key are excluded gracefully.
+ */
+export function buildProviders(config) {
+    const providers = [];
+    const testMode = config.testMode ?? false;
+    if (config.moonpayApiKey) {
+        providers.push(new MoonPayProvider(config.moonpayApiKey, testMode));
+    }
+    if (config.stripeApiKey) {
+        providers.push(new StripeProvider(config.stripeApiKey, testMode));
+    }
+    if (config.transakApiKey) {
+        providers.push(new TransakProvider(config.transakApiKey, testMode));
+    }
+    return providers;
+}
+/** All known provider names */
+export const ALL_PROVIDER_NAMES = ['moonpay', 'stripe', 'transak'];
+//# sourceMappingURL=index.js.map

package/dist/fiat/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/fiat/providers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,MAAM,SAAS,GAAmB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC;IAE1C,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,SAAS,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,SAAS,CAAC,IAAI,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,SAAS,CAAC,IAAI,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+BAA+B;AAC/B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC"}

package/dist/fiat/providers/moonpay.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MoonPay Provider
+ *
+ * Creates buy quotes and purchase URLs via MoonPay's REST API.
+ * KYC + payment happen on MoonPay's hosted page — we never see KYC data.
+ *
+ * API reference: https://dev.moonpay.com/reference/buy-quote
+ * Dashboard: https://dashboard.moonpay.com
+ */
+import type { FiatProvider, FiatQuote, OnrampParams } from '../types.js';
+export declare class MoonPayProvider implements FiatProvider {
+    readonly name = "moonpay";
+    readonly supportedAssets: Record<string, string[]>;
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, testMode?: boolean);
+    get isConfigured(): boolean;
+    getQuote(params: OnrampParams): Promise<FiatQuote>;
+    createSession(params: OnrampParams): Promise<FiatQuote>;
+    private buildPurchaseUrl;
+}
+//# sourceMappingURL=moonpay.d.ts.map

package/dist/fiat/providers/moonpay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moonpay.d.ts","sourceRoot":"","sources":["../../../src/fiat/providers/moonpay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAuCzE,qBAAa,eAAgB,YAAW,YAAY;IAClD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,eAAe,2BAAoB;IAE5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAQ;IAK5C,IAAI,YAAY,IAAI,OAAO,CAE1B;IAEK,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAoDlD,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAK7D,OAAO,CAAC,gBAAgB;CAazB"}