agentwallet-sdk 3.0.0 → 3.1.0

package/dist/fiat/providers/moonpay.js

@@ -0,0 +1,107 @@
+/**
+ * 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
+ */
+const MOONPAY_BASE_URL = 'https://api.moonpay.com';
+const MOONPAY_SANDBOX_URL = 'https://api.moonpay.com'; // Same endpoint, uses sandbox key
+/** MoonPay currency code mappings: our token → MoonPay currency code */
+const TOKEN_MAP = {
+    USDC: 'usdc',
+    ETH: 'eth',
+    SOL: 'sol',
+    BTC: 'btc',
+    MATIC: 'matic_polygon',
+    USDT: 'usdt',
+};
+/** Chain-specific token suffixes for MoonPay (e.g., usdc on base = usdc_base) */
+const CHAIN_TOKEN_MAP = {
+    base: { USDC: 'usdc_base', ETH: 'eth_base' },
+    ethereum: { USDC: 'usdc', ETH: 'eth', USDT: 'usdt' },
+    solana: { USDC: 'usdc_sol', SOL: 'sol' },
+    polygon: { USDC: 'usdc_polygon', MATIC: 'matic_polygon', USDT: 'usdt_polygon' },
+    arbitrum: { USDC: 'usdc_arbitrum', ETH: 'eth_arbitrum' },
+    optimism: { USDC: 'usdc_optimism', ETH: 'eth_optimism' },
+};
+/** Supported assets by chain */
+const SUPPORTED_ASSETS = {
+    ethereum: ['ETH', 'USDC', 'USDT'],
+    base: ['ETH', 'USDC'],
+    solana: ['SOL', 'USDC'],
+    polygon: ['MATIC', 'USDC', 'USDT'],
+    arbitrum: ['ETH', 'USDC'],
+    optimism: ['ETH', 'USDC'],
+};
+function getMoonPayCurrencyCode(chain, token) {
+    return CHAIN_TOKEN_MAP[chain]?.[token] ?? TOKEN_MAP[token] ?? token.toLowerCase();
+}
+export class MoonPayProvider {
+    constructor(apiKey, testMode = false) {
+        this.name = 'moonpay';
+        this.supportedAssets = SUPPORTED_ASSETS;
+        this.apiKey = apiKey;
+        this.baseUrl = testMode ? MOONPAY_SANDBOX_URL : MOONPAY_BASE_URL;
+    }
+    get isConfigured() {
+        return Boolean(this.apiKey);
+    }
+    async getQuote(params) {
+        const currencyCode = getMoonPayCurrencyCode(params.chain, params.token);
+        const fiatCurrency = (params.currency ?? 'USD').toLowerCase();
+        const url = new URL(`${this.baseUrl}/v3/currencies/${currencyCode}/buy_quote`);
+        url.searchParams.set('apiKey', this.apiKey);
+        url.searchParams.set('baseCurrencyAmount', String(params.amount));
+        url.searchParams.set('baseCurrencyCode', fiatCurrency);
+        url.searchParams.set('areFeesIncluded', 'false');
+        const response = await fetch(url.toString(), {
+            headers: { Accept: 'application/json' },
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => response.statusText);
+            throw new Error(`MoonPay API error ${response.status}: ${errorText}`);
+        }
+        const data = await response.json();
+        const grossCrypto = data.quoteCurrencyAmount ?? 0;
+        const feeAmount = (data.feeAmount ?? 0) + (data.extraFeeAmount ?? 0) + (data.networkFeeAmount ?? 0);
+        const feePercent = params.amount > 0 ? (feeAmount / params.amount) * 100 : 0;
+        // Build the purchase URL (MoonPay hosted widget)
+        const purchaseUrl = this.buildPurchaseUrl(params, currencyCode, fiatCurrency);
+        return {
+            provider: this.name,
+            fiatAmount: params.amount,
+            fiatCurrency: (params.currency ?? 'USD').toUpperCase(),
+            cryptoAmount: String(grossCrypto),
+            cryptoToken: params.token.toUpperCase(),
+            chain: params.chain,
+            feeAmount,
+            feePercent: Math.round(feePercent * 100) / 100,
+            netCryptoAmount: String(grossCrypto),
+            paymentMethods: ['card', 'bank_transfer', 'apple_pay', 'google_pay'],
+            estimatedTimeMinutes: 10,
+            kycRequired: true,
+            purchaseUrl,
+        };
+    }
+    async createSession(params) {
+        // MoonPay uses a URL-based flow — the "session" IS the purchase URL
+        return this.getQuote(params);
+    }
+    buildPurchaseUrl(params, currencyCode, fiatCurrency) {
+        const base = 'https://buy.moonpay.com';
+        const url = new URL(base);
+        url.searchParams.set('apiKey', this.apiKey);
+        url.searchParams.set('currencyCode', currencyCode);
+        url.searchParams.set('baseCurrencyCode', fiatCurrency);
+        url.searchParams.set('baseCurrencyAmount', String(params.amount));
+        url.searchParams.set('walletAddress', params.walletAddress);
+        if (params.redirectUrl) {
+            url.searchParams.set('redirectURL', params.redirectUrl);
+        }
+        return url.toString();
+    }
+}
+//# sourceMappingURL=moonpay.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Stripe Crypto Onramp Provider
+ *
+ * Creates onramp sessions via Stripe's REST API.
+ * Returns a hosted URL where users complete KYC + payment on Stripe's page.
+ * We never handle KYC data — it stays entirely within Stripe's infrastructure.
+ *
+ * API reference: https://docs.stripe.com/crypto/onramp
+ * Dashboard: https://dashboard.stripe.com
+ *
+ * Note: Stripe Crypto Onramp requires a server-side secret key to create sessions.
+ * The publishable key alone cannot create sessions. For agent use cases, the
+ * stripeApiKey in config should be the secret key (sk_live_... or sk_test_...).
+ */
+import type { FiatProvider, FiatQuote, OnrampParams } from '../types.js';
+export declare class StripeProvider implements FiatProvider {
+    readonly name = "stripe";
+    readonly supportedAssets: Record<string, string[]>;
+    private apiKey;
+    constructor(apiKey: string, _testMode?: boolean);
+    get isConfigured(): boolean;
+    getQuote(params: OnrampParams): Promise<FiatQuote>;
+    createSession(params: OnrampParams): Promise<FiatQuote>;
+    private estimateCrypto;
+}
+//# sourceMappingURL=stripe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.d.ts","sourceRoot":"","sources":["../../../src/fiat/providers/stripe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAiCzE,qBAAa,cAAe,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,eAAe,2BAAoB;IAE5C,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM,EAAE,SAAS,UAAQ;IAI7C,IAAI,YAAY,IAAI,OAAO,CAE1B;IAEK,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IA2BlD,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAoE7D,OAAO,CAAC,cAAc;CAQvB"}

package/dist/fiat/providers/stripe.js

@@ -0,0 +1,135 @@
+/**
+ * Stripe Crypto Onramp Provider
+ *
+ * Creates onramp sessions via Stripe's REST API.
+ * Returns a hosted URL where users complete KYC + payment on Stripe's page.
+ * We never handle KYC data — it stays entirely within Stripe's infrastructure.
+ *
+ * API reference: https://docs.stripe.com/crypto/onramp
+ * Dashboard: https://dashboard.stripe.com
+ *
+ * Note: Stripe Crypto Onramp requires a server-side secret key to create sessions.
+ * The publishable key alone cannot create sessions. For agent use cases, the
+ * stripeApiKey in config should be the secret key (sk_live_... or sk_test_...).
+ */
+const STRIPE_API_URL = 'https://api.stripe.com/v1/crypto/onramp_sessions';
+/** Stripe's crypto destination network identifiers */
+const CHAIN_MAP = {
+    ethereum: 'ethereum',
+    base: 'base',
+    solana: 'solana',
+    polygon: 'polygon',
+    arbitrum: 'arbitrum',
+    optimism: 'optimism',
+};
+/** Stripe's crypto currency identifiers */
+const TOKEN_MAP = {
+    USDC: 'usdc',
+    ETH: 'eth',
+    SOL: 'sol',
+    MATIC: 'matic',
+    BTC: 'btc',
+};
+/** Supported assets by chain for Stripe */
+const SUPPORTED_ASSETS = {
+    ethereum: ['ETH', 'USDC'],
+    base: ['ETH', 'USDC'],
+    solana: ['SOL', 'USDC'],
+    polygon: ['MATIC', 'USDC'],
+    arbitrum: ['ETH', 'USDC'],
+    optimism: ['ETH', 'USDC'],
+};
+export class StripeProvider {
+    constructor(apiKey, _testMode = false) {
+        this.name = 'stripe';
+        this.supportedAssets = SUPPORTED_ASSETS;
+        this.apiKey = apiKey;
+    }
+    get isConfigured() {
+        return Boolean(this.apiKey);
+    }
+    async getQuote(params) {
+        // Stripe doesn't have a separate quote endpoint — createSession is the entry point.
+        // We estimate fees at ~1.5% (Stripe's standard crypto onramp rate).
+        const feePercent = 1.5;
+        const feeAmount = params.amount * (feePercent / 100);
+        const netFiat = params.amount - feeAmount;
+        // Placeholder rate estimates (real rates come from the session response)
+        const estimatedCryptoAmount = this.estimateCrypto(netFiat, params.token, params.currency ?? 'USD');
+        return {
+            provider: this.name,
+            fiatAmount: params.amount,
+            fiatCurrency: (params.currency ?? 'USD').toUpperCase(),
+            cryptoAmount: estimatedCryptoAmount,
+            cryptoToken: params.token.toUpperCase(),
+            chain: params.chain,
+            feeAmount,
+            feePercent,
+            netCryptoAmount: estimatedCryptoAmount,
+            paymentMethods: ['card', 'bank_transfer'],
+            estimatedTimeMinutes: 5,
+            kycRequired: true,
+            purchaseUrl: undefined, // Populated by createSession
+        };
+    }
+    async createSession(params) {
+        const stripeChain = CHAIN_MAP[params.chain] ?? params.chain;
+        const stripeToken = TOKEN_MAP[params.token] ?? params.token.toLowerCase();
+        const currency = (params.currency ?? 'USD').toLowerCase();
+        // Build form-encoded body (Stripe uses application/x-www-form-urlencoded)
+        const body = new URLSearchParams();
+        body.set('transaction_details[wallet_address]', params.walletAddress);
+        body.set('transaction_details[supported_destination_networks][]', stripeChain);
+        body.set('transaction_details[supported_destination_currencies][]', stripeToken);
+        body.set('transaction_details[destination_network]', stripeChain);
+        body.set('transaction_details[destination_currency]', stripeToken);
+        body.set('transaction_details[source_currency]', currency);
+        body.set('transaction_details[source_amount]', String(params.amount));
+        if (params.redirectUrl) {
+            body.set('customer_ip_address', ''); // Required field — agent provides blank
+        }
+        const response = await fetch(STRIPE_API_URL, {
+            method: 'POST',
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+            body: body.toString(),
+        });
+        if (!response.ok) {
+            const errorData = await response.json().catch(() => ({ error: { message: response.statusText } }));
+            throw new Error(`Stripe API error ${response.status}: ${errorData.error?.message ?? response.statusText}`);
+        }
+        const session = await response.json();
+        const txDetails = session.transaction_details ?? {};
+        const fiatAmount = parseFloat(txDetails.source_amount ?? String(params.amount));
+        const cryptoAmount = txDetails.destination_amount ?? '0';
+        const feeAmount = parseFloat(txDetails.fees?.amount ?? String(params.amount * 0.015));
+        const feePercent = fiatAmount > 0 ? (feeAmount / fiatAmount) * 100 : 1.5;
+        return {
+            provider: this.name,
+            fiatAmount,
+            fiatCurrency: (params.currency ?? 'USD').toUpperCase(),
+            cryptoAmount,
+            cryptoToken: params.token.toUpperCase(),
+            chain: params.chain,
+            feeAmount,
+            feePercent: Math.round(feePercent * 100) / 100,
+            netCryptoAmount: cryptoAmount,
+            paymentMethods: ['card', 'bank_transfer'],
+            estimatedTimeMinutes: 5,
+            kycRequired: true,
+            purchaseUrl: session.redirect_url,
+            sessionId: session.id,
+        };
+    }
+    estimateCrypto(netFiat, token, _currency) {
+        // Very rough estimates for quote previews — real amounts come from createSession
+        const rates = {
+            ETH: 3000, SOL: 150, BTC: 65000, USDC: 1, USDT: 1, MATIC: 0.8,
+        };
+        const rate = rates[token.toUpperCase()] ?? 1;
+        return (netFiat / rate).toFixed(6);
+    }
+}
+//# sourceMappingURL=stripe.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * Transak Provider
+ *
+ * Creates onramp sessions via Transak's REST API.
+ * Returns a hosted URL where users complete KYC + payment on Transak's page.
+ * We never handle KYC data — it stays entirely within Transak's infrastructure.
+ *
+ * API reference: https://docs.transak.com/reference/get-price
+ * Dashboard: https://dashboard.transak.com
+ */
+import type { FiatProvider, FiatQuote, OnrampParams } from '../types.js';
+export declare class TransakProvider implements FiatProvider {
+    readonly name = "transak";
+    readonly supportedAssets: Record<string, string[]>;
+    private apiKey;
+    private testMode;
+    private baseUrl;
+    private widgetUrl;
+    constructor(apiKey: string, testMode?: boolean);
+    get isConfigured(): boolean;
+    getQuote(params: OnrampParams): Promise<FiatQuote>;
+    createSession(params: OnrampParams): Promise<FiatQuote>;
+    private buildWidgetUrl;
+    private extractPaymentMethods;
+}
+//# sourceMappingURL=transak.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transak.d.ts","sourceRoot":"","sources":["../../../src/fiat/providers/transak.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgDzE,qBAAa,eAAgB,YAAW,YAAY;IAClD,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,eAAe,2BAAoB;IAE5C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAQ;IAO5C,IAAI,YAAY,IAAI,OAAO,CAE1B;IAEK,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAmDlD,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC;IAK7D,OAAO,CAAC,cAAc;IAkBtB,OAAO,CAAC,qBAAqB;CAM9B"}

package/dist/fiat/providers/transak.js

@@ -0,0 +1,119 @@
+/**
+ * Transak Provider
+ *
+ * Creates onramp sessions via Transak's REST API.
+ * Returns a hosted URL where users complete KYC + payment on Transak's page.
+ * We never handle KYC data — it stays entirely within Transak's infrastructure.
+ *
+ * API reference: https://docs.transak.com/reference/get-price
+ * Dashboard: https://dashboard.transak.com
+ */
+const TRANSAK_BASE_URL = 'https://api.transak.com/api/v2';
+const TRANSAK_SANDBOX_URL = 'https://staging-api.transak.com/api/v2';
+const TRANSAK_WIDGET_URL = 'https://global.transak.com';
+const TRANSAK_SANDBOX_WIDGET_URL = 'https://global-stg.transak.com';
+/** Transak network identifiers */
+const CHAIN_MAP = {
+    ethereum: 'ethereum',
+    base: 'base',
+    solana: 'solana',
+    polygon: 'polygon',
+    arbitrum: 'arbitrum',
+    optimism: 'optimism',
+    avalanche: 'avaxcchain',
+    bsc: 'bsc',
+};
+/** Supported assets by chain */
+const SUPPORTED_ASSETS = {
+    ethereum: ['ETH', 'USDC', 'USDT', 'DAI'],
+    base: ['ETH', 'USDC'],
+    solana: ['SOL', 'USDC'],
+    polygon: ['MATIC', 'USDC', 'USDT', 'DAI'],
+    arbitrum: ['ETH', 'USDC', 'USDT'],
+    optimism: ['ETH', 'USDC', 'USDT'],
+    avalanche: ['AVAX', 'USDC'],
+    bsc: ['BNB', 'USDT', 'BUSD'],
+};
+export class TransakProvider {
+    constructor(apiKey, testMode = false) {
+        this.name = 'transak';
+        this.supportedAssets = SUPPORTED_ASSETS;
+        this.apiKey = apiKey;
+        this.testMode = testMode;
+        this.baseUrl = testMode ? TRANSAK_SANDBOX_URL : TRANSAK_BASE_URL;
+        this.widgetUrl = testMode ? TRANSAK_SANDBOX_WIDGET_URL : TRANSAK_WIDGET_URL;
+    }
+    get isConfigured() {
+        return Boolean(this.apiKey);
+    }
+    async getQuote(params) {
+        const network = CHAIN_MAP[params.chain] ?? params.chain;
+        const currency = (params.currency ?? 'USD').toUpperCase();
+        const url = new URL(`${this.baseUrl}/currencies/price`);
+        url.searchParams.set('partnerApiKey', this.apiKey);
+        url.searchParams.set('fiatCurrency', currency);
+        url.searchParams.set('cryptoCurrency', params.token.toUpperCase());
+        url.searchParams.set('isBuyOrSell', 'BUY');
+        url.searchParams.set('fiatAmount', String(params.amount));
+        url.searchParams.set('network', network);
+        const response = await fetch(url.toString(), {
+            headers: { Accept: 'application/json' },
+        });
+        if (!response.ok) {
+            const errorText = await response.text().catch(() => response.statusText);
+            throw new Error(`Transak API error ${response.status}: ${errorText}`);
+        }
+        const data = await response.json();
+        if (data.error) {
+            throw new Error(`Transak error: ${data.error.message}`);
+        }
+        const r = data.response ?? {};
+        const cryptoAmount = r.cryptoAmount ?? 0;
+        const feePercent = ((r.feeDecimal ?? 0) + (r.partnerFeeDecimal ?? 0)) * 100;
+        const feeAmount = params.amount * (feePercent / 100);
+        const purchaseUrl = this.buildWidgetUrl(params, network, currency);
+        return {
+            provider: this.name,
+            fiatAmount: params.amount,
+            fiatCurrency: currency,
+            cryptoAmount: String(cryptoAmount),
+            cryptoToken: params.token.toUpperCase(),
+            chain: params.chain,
+            feeAmount,
+            feePercent: Math.round(feePercent * 100) / 100,
+            netCryptoAmount: String(cryptoAmount),
+            paymentMethods: this.extractPaymentMethods(r.payment_methods),
+            estimatedTimeMinutes: 15,
+            kycRequired: true,
+            purchaseUrl,
+        };
+    }
+    async createSession(params) {
+        // Transak uses a URL-based widget flow — session = widget URL with params
+        return this.getQuote(params);
+    }
+    buildWidgetUrl(params, network, currency) {
+        const url = new URL(this.widgetUrl);
+        url.searchParams.set('apiKey', this.apiKey);
+        url.searchParams.set('fiatCurrency', currency);
+        url.searchParams.set('cryptoCurrencyCode', params.token.toUpperCase());
+        url.searchParams.set('fiatAmount', String(params.amount));
+        url.searchParams.set('network', network);
+        url.searchParams.set('walletAddress', params.walletAddress);
+        url.searchParams.set('isBuyOrSell', 'BUY');
+        if (this.testMode) {
+            url.searchParams.set('environment', 'STAGING');
+        }
+        if (params.redirectUrl) {
+            url.searchParams.set('redirectURL', params.redirectUrl);
+        }
+        return url.toString();
+    }
+    extractPaymentMethods(methods) {
+        if (!methods || methods.length === 0) {
+            return ['card', 'bank_transfer', 'apple_pay', 'google_pay'];
+        }
+        return methods.map((m) => m.id ?? 'card').filter(Boolean);
+    }
+}
+//# sourceMappingURL=transak.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transak.js","sourceRoot":"","sources":["../../../src/fiat/providers/transak.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,gBAAgB,GAAG,gCAAgC,CAAC;AAC1D,MAAM,mBAAmB,GAAG,wCAAwC,CAAC;AACrE,MAAM,kBAAkB,GAAG,4BAA4B,CAAC;AACxD,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;AAEpE,kCAAkC;AAClC,MAAM,SAAS,GAA2B;IACxC,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,YAAY;IACvB,GAAG,EAAE,KAAK;CACX,CAAC;AAEF,gCAAgC;AAChC,MAAM,gBAAgB,GAA6B;IACjD,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC;IACxC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC;IACzC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;IACjC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;CAC7B,CAAC;AAmBF,MAAM,OAAO,eAAe;IAS1B,YAAY,MAAc,EAAE,QAAQ,GAAG,KAAK;QARnC,SAAI,GAAG,SAAS,CAAC;QACjB,oBAAe,GAAG,gBAAgB,CAAC;QAQ1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,gBAAgB,CAAC;QACjE,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAC9E,CAAC;IAED,IAAI,YAAY;QACd,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAoB;QACjC,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC;QACxD,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QAE1D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,mBAAmB,CAAC,CAAC;QACxD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACnD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAC/C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACnE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC3C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEzC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE;YAC3C,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA0B,CAAC;QAE3D,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kBAAkB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC;QACzC,MAAM,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAC5E,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC;QAErD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEnE,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,UAAU,EAAE,MAAM,CAAC,MAAM;YACzB,YAAY,EAAE,QAAQ;YACtB,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC;YAClC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE;YACvC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS;YACT,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG;YAC9C,eAAe,EAAE,MAAM,CAAC,YAAY,CAAC;YACrC,cAAc,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,eAAe,CAAC;YAC7D,oBAAoB,EAAE,EAAE;YACxB,WAAW,EAAE,IAAI;YACjB,WAAW;SACZ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAoB;QACtC,0EAA0E;QAC1E,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;IAEO,cAAc,CAAC,MAAoB,EAAE,OAAe,EAAE,QAAgB;QAC5E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACpC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;QAC/C,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACvE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACzC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;QAC5D,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAC3C,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YACvB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAEO,qBAAqB,CAAC,OAA2B;QACvD,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/fiat/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * FiatOnramp Types
+ *
+ * IMPORTANT: The fiat onramp 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 the fiat onramp
+ * feature. The SDK never collects or stores KYC data — all KYC is handled
+ * entirely by the third-party provider on their hosted page.
+ */
+/**
+ * Configuration for the FiatOnramp module.
+ * API keys are per-provider — only configure the providers you want to use.
+ * Omitting all keys is valid; it just returns an empty provider list.
+ */
+export interface FiatOnrampConfig {
+    /** MoonPay publishable API key — https://dashboard.moonpay.com */
+    moonpayApiKey?: string;
+    /** Stripe publishable API key — https://dashboard.stripe.com */
+    stripeApiKey?: string;
+    /** Transak API key — https://dashboard.transak.com */
+    transakApiKey?: string;
+    /** Default fiat currency (ISO 4217). Defaults to 'USD'. */
+    defaultCurrency?: string;
+    /** Use sandbox/test mode for all providers. Defaults to false. */
+    testMode?: boolean;
+}
+/**
+ * A quote from a single fiat onramp provider.
+ *
+ * NOTE: kycRequired is always true for fiat onramp. KYC happens entirely
+ * on the provider's hosted page — the SDK never sees any KYC data.
+ */
+export interface FiatQuote {
+    /** Provider identifier: 'moonpay' | 'stripe' | 'transak' */
+    provider: string;
+    /** Fiat amount the user will pay */
+    fiatAmount: number;
+    /** Fiat currency code (e.g. 'USD', 'EUR', 'GBP') */
+    fiatCurrency: string;
+    /** Estimated gross crypto output before fees */
+    cryptoAmount: string;
+    /** Crypto token symbol (e.g. 'USDC', 'ETH', 'SOL') */
+    cryptoToken: string;
+    /** Destination blockchain (e.g. 'ethereum', 'base', 'solana') */
+    chain: string;
+    /** Provider fee in fiat currency */
+    feeAmount: number;
+    /** Provider fee as a percentage of fiatAmount */
+    feePercent: number;
+    /** Net crypto amount the wallet receives after fees */
+    netCryptoAmount: string;
+    /** Supported payment methods for this quote */
+    paymentMethods: string[];
+    /** Estimated minutes until crypto arrives in wallet */
+    estimatedTimeMinutes: number;
+    /**
+     * KYC is ALWAYS required for fiat onramp — this is always true.
+     * KYC is handled entirely by the provider on their hosted page.
+     * The SDK never sees, stores, or transmits any KYC data.
+     */
+    kycRequired: true;
+    /**
+     * URL to complete the purchase.
+     * Opening this URL takes the user to the provider's hosted KYC + payment page.
+     * After completion, crypto is sent directly to the walletAddress.
+     */
+    purchaseUrl?: string;
+    /** Provider session ID for tracking purchase status */
+    sessionId?: string;
+}
+/**
+ * Parameters for requesting a fiat onramp quote or session.
+ */
+export interface OnrampParams {
+    /** Fiat amount to spend (in the specified currency) */
+    amount: number;
+    /** Fiat currency code. Defaults to FiatOnrampConfig.defaultCurrency or 'USD' */
+    currency?: string;
+    /** Target crypto token (e.g. 'USDC', 'ETH', 'SOL') */
+    token: string;
+    /** Target blockchain (e.g. 'ethereum', 'base', 'solana') */
+    chain: string;
+    /** Wallet address where crypto will be delivered */
+    walletAddress: string;
+    /** Optional redirect URL after the provider's hosted purchase flow completes */
+    redirectUrl?: string;
+}
+/**
+ * Internal provider interface — implemented by each provider module.
+ * @internal
+ */
+export interface FiatProvider {
+    /** Provider identifier */
+    readonly name: string;
+    /** Whether this provider is configured (has an API key) */
+    readonly isConfigured: boolean;
+    /** Supported chain → token mapping */
+    readonly supportedAssets: Record<string, string[]>;
+    /** Get a quote from this provider */
+    getQuote(params: OnrampParams): Promise<FiatQuote>;
+    /** Create a purchase session (may call additional APIs beyond getQuote) */
+    createSession(params: OnrampParams): Promise<FiatQuote>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fiat/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,uDAAuD;IACvD,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,WAAW,EAAE,IAAI,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACnD,2EAA2E;IAC3E,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CACzD"}

package/dist/fiat/types.js

@@ -0,0 +1,13 @@
+/**
+ * FiatOnramp Types
+ *
+ * IMPORTANT: The fiat onramp 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 the fiat onramp
+ * feature. The SDK never collects or stores KYC data — all KYC is handled
+ * entirely by the third-party provider on their hosted page.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/fiat/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/fiat/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/gas/index.d.ts

@@ -0,0 +1,4 @@
+export { GasSponsor } from './sponsor.js';
+export type { GasSponsorConfig, GasSupportedChain, UserOperation, SponsoredTx, SponsorTxParams, SponsorBridgeParams, } from './types.js';
+export { ALCHEMY_NETWORK_SLUGS } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/gas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,eAAe,EACf,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/gas/index.js

@@ -0,0 +1,3 @@
+export { GasSponsor } from './sponsor.js';
+export { ALCHEMY_NETWORK_SLUGS } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/gas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/gas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAS1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}