agentwallet-sdk 6.0.5 → 6.2.0

package/dist/policy/UptoBillingPolicy.test.js

@@ -0,0 +1,102 @@
+import { describe, expect, it } from 'vitest';
+import { UptoBillingPolicy } from './UptoBillingPolicy.js';
+describe('UptoBillingPolicy', () => {
+    it('tracks max authorization and exposes reservation ledger delta', () => {
+        const policy = new UptoBillingPolicy();
+        const auth = policy.authorize({
+            authorizationId: 'auth-1',
+            service: 'api.example.com',
+            resource: 'GET /inference',
+            network: 'base:8453',
+            asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913',
+            payTo: '0xabc',
+            maxAmount: 1000000n,
+        });
+        expect(auth.maxAmount).toBe(1000000n);
+        expect(auth.remainingAmount).toBe(1000000n);
+        expect(policy.getReservedAmount('auth-1')).toBe(1000000n);
+        const deltas = policy.getWalletLedgerDeltas('auth-1');
+        expect(deltas).toHaveLength(1);
+        expect(deltas[0].type).toBe('authorization');
+        expect(deltas[0].reservedDelta).toBe(1000000n);
+        expect(deltas[0].netWalletDelta).toBe(0n);
+    });
+    it('records actual settlement and wallet delta', () => {
+        const policy = new UptoBillingPolicy();
+        policy.authorize({
+            authorizationId: 'auth-2',
+            service: 'api.example.com',
+            network: 'base:8453',
+            asset: 'usdc',
+            payTo: '0xabc',
+            maxAmount: 1000000n,
+        });
+        const snapshot = policy.recordSettlement('auth-2', 420000n, {
+            txHash: '0xsettle',
+        });
+        expect(snapshot.authorization.settledAmount).toBe(420000n);
+        expect(snapshot.authorization.remainingAmount).toBe(580000n);
+        expect(snapshot.authorization.status).toBe('partially_settled');
+        expect(policy.getNetWalletDelta('auth-2')).toBe(-420000n);
+        const settlementDelta = snapshot.ledgerDeltas[1];
+        expect(settlementDelta.type).toBe('settlement');
+        expect(settlementDelta.reservedDelta).toBe(-420000n);
+        expect(settlementDelta.settledDelta).toBe(420000n);
+        expect(settlementDelta.netWalletDelta).toBe(-420000n);
+    });
+    it('releases unused authorization capacity on finalize', () => {
+        const policy = new UptoBillingPolicy();
+        policy.authorize({
+            authorizationId: 'auth-3',
+            service: 'api.example.com',
+            network: 'base:8453',
+            asset: 'usdc',
+            payTo: '0xabc',
+            maxAmount: 1000000n,
+        });
+        policy.recordSettlement('auth-3', 250000n, { finalize: true });
+        const auth = policy.getAuthorization('auth-3');
+        const deltas = policy.getWalletLedgerDeltas('auth-3');
+        expect(auth?.settledAmount).toBe(250000n);
+        expect(auth?.releasedAmount).toBe(750000n);
+        expect(auth?.remainingAmount).toBe(0n);
+        expect(auth?.status).toBe('settled');
+        expect(policy.getReservedAmount('auth-3')).toBe(0n);
+        expect(deltas.map((delta) => delta.type)).toEqual([
+            'authorization',
+            'settlement',
+            'release',
+        ]);
+    });
+    it('rejects settlement above the authorized amount', () => {
+        const policy = new UptoBillingPolicy();
+        policy.authorize({
+            authorizationId: 'auth-4',
+            service: 'api.example.com',
+            network: 'base:8453',
+            asset: 'usdc',
+            payTo: '0xabc',
+            maxAmount: 100n,
+        });
+        expect(() => policy.recordSettlement('auth-4', 101n)).toThrow(/exceeds remaining authorized amount/i);
+    });
+    it('supports multiple settlements up to the authorized cap', () => {
+        const policy = new UptoBillingPolicy();
+        policy.authorize({
+            authorizationId: 'auth-5',
+            service: 'api.example.com',
+            network: 'base:8453',
+            asset: 'usdc',
+            payTo: '0xabc',
+            maxAmount: 1000n,
+        });
+        policy.recordSettlement('auth-5', 250n);
+        policy.recordSettlement('auth-5', 750n);
+        const auth = policy.getAuthorization('auth-5');
+        expect(auth?.settledAmount).toBe(1000n);
+        expect(auth?.remainingAmount).toBe(0n);
+        expect(auth?.status).toBe('settled');
+        expect(policy.getNetWalletDelta('auth-5')).toBe(-1000n);
+    });
+});
+//# sourceMappingURL=UptoBillingPolicy.test.js.map

package/dist/policy/UptoBillingPolicy.test.js.map

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

package/dist/router/PaymentRouter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * PaymentRouter — Three-rail payment architecture.
+ *
+ * Routes payments across three rails:
+ *   1. **x402** (crypto-native) — on-chain USDC payments via the x402 protocol. Optimal for
+ *      micropayments, autonomous agents, and scenarios requiring on-chain audit trails.
+ *   2. **MPP** (Managed Payment Protocol / Stripe) — fiat-based payments with dispute resolution.
+ *      Optimal for larger amounts, supervised agents, and high-frequency session batching.
+ *   3. **Google AP2** (Agent Payment Protocol) — Google's managed agent payment rail combining
+ *      identity verification and payment in a single flow. Roadmap; activates when Google
+ *      publishes the full AP2 spec. Settlement on Base.
+ *
+ * Routing criteria:
+ *   - Transaction amount (micropayments → x402, high-frequency → MPP)
+ *   - Session context (ongoing session → MPP for batching efficiency)
+ *   - Agent autonomy level (autonomous → x402, supervised → MPP)
+ *   - Chain/ecosystem preference (Google ecosystem → AP2, Solana → x402-solana)
+ *   - Rail availability (live vs. roadmap)
+ *
+ * @module router/PaymentRouter
+ */
+export type PaymentRail = 'x402' | 'mpp' | 'x402-solana' | 'google-ap2';
+export type RailStatus = 'live' | 'roadmap' | 'disabled';
+export interface RailConfig {
+    rail: PaymentRail;
+    status: RailStatus;
+    /** Maximum per-transaction amount in USDC micro-units (6 decimals) */
+    maxAmount?: number;
+    /** Minimum per-transaction amount in USDC micro-units */
+    minAmount?: number;
+}
+export interface PaymentContext {
+    /** Amount in USDC micro-units (6 decimals). e.g. 1_000_000 = $1.00 */
+    amount: number;
+    /** Recipient address or merchant domain */
+    recipient: string;
+    /** Whether this payment is part of an active session with repeated transactions */
+    isSessionContext?: boolean;
+    /** Number of transactions in the current session (if applicable) */
+    sessionTxCount?: number;
+    /** Whether the agent is operating autonomously (no human in loop) */
+    autonomous?: boolean;
+    /** Preferred chain, if any */
+    preferredChain?: 'base' | 'solana' | 'google-ap2';
+}
+export interface RoutingDecision {
+    rail: PaymentRail;
+    reason: string;
+    /** Estimated cost overhead (basis points) */
+    estimatedOverheadBps: number;
+    /** Whether this rail is currently live */
+    isLive: boolean;
+}
+export declare class PaymentRouter {
+    private rails;
+    /** Amount threshold (micro-units) below which x402 is preferred. Default: $1.00 */
+    private microPaymentThreshold;
+    /** Session tx count above which MPP is preferred for batching. Default: 5 */
+    private highFrequencyThreshold;
+    constructor(options?: {
+        rails?: RailConfig[];
+        microPaymentThreshold?: number;
+        highFrequencyThreshold?: number;
+    });
+    /**
+     * Select the optimal payment rail for a given context.
+     */
+    route(context: PaymentContext): RoutingDecision;
+    /**
+     * Get all available (live) rails.
+     */
+    getLiveRails(): RailConfig[];
+    /**
+     * Check if a specific rail is available.
+     */
+    isRailLive(rail: PaymentRail): boolean;
+    private getRail;
+}
+//# sourceMappingURL=PaymentRouter.d.ts.map

package/dist/router/PaymentRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentRouter.d.ts","sourceRoot":"","sources":["../../src/router/PaymentRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,aAAa,GAAG,YAAY,CAAC;AAExE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAC;CACnD;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;CACjB;AA+BD,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAe;IAC5B,mFAAmF;IACnF,OAAO,CAAC,qBAAqB,CAAS;IACtC,6EAA6E;IAC7E,OAAO,CAAC,sBAAsB,CAAS;gBAE3B,OAAO,CAAC,EAAE;QACpB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;QACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;QAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC;IAMD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,eAAe;IA8E/C;;OAEG;IACH,YAAY,IAAI,UAAU,EAAE;IAI5B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO;IAItC,OAAO,CAAC,OAAO;CAGhB"}

package/dist/router/PaymentRouter.js

@@ -0,0 +1,144 @@
+/**
+ * PaymentRouter — Three-rail payment architecture.
+ *
+ * Routes payments across three rails:
+ *   1. **x402** (crypto-native) — on-chain USDC payments via the x402 protocol. Optimal for
+ *      micropayments, autonomous agents, and scenarios requiring on-chain audit trails.
+ *   2. **MPP** (Managed Payment Protocol / Stripe) — fiat-based payments with dispute resolution.
+ *      Optimal for larger amounts, supervised agents, and high-frequency session batching.
+ *   3. **Google AP2** (Agent Payment Protocol) — Google's managed agent payment rail combining
+ *      identity verification and payment in a single flow. Roadmap; activates when Google
+ *      publishes the full AP2 spec. Settlement on Base.
+ *
+ * Routing criteria:
+ *   - Transaction amount (micropayments → x402, high-frequency → MPP)
+ *   - Session context (ongoing session → MPP for batching efficiency)
+ *   - Agent autonomy level (autonomous → x402, supervised → MPP)
+ *   - Chain/ecosystem preference (Google ecosystem → AP2, Solana → x402-solana)
+ *   - Rail availability (live vs. roadmap)
+ *
+ * @module router/PaymentRouter
+ */
+// ─── Default Rail Configuration ───────────────────────────────────────────────
+const DEFAULT_RAILS = [
+    {
+        rail: 'x402',
+        status: 'live',
+        minAmount: 1000, // $0.001 minimum
+        maxAmount: 100000000, // $100 max per tx (soft limit)
+    },
+    {
+        rail: 'mpp',
+        status: 'live',
+        minAmount: 100000, // $0.10 minimum (Stripe floor)
+        maxAmount: 10000000000, // $10,000 max
+    },
+    {
+        rail: 'x402-solana',
+        status: 'roadmap',
+    },
+    {
+        rail: 'google-ap2',
+        status: 'roadmap',
+        minAmount: 1000, // $0.001 minimum (aligned with x402)
+        maxAmount: 50000000, // $50 max per tx (conservative until spec finalized)
+    },
+];
+// ─── Router ───────────────────────────────────────────────────────────────────
+export class PaymentRouter {
+    constructor(options) {
+        this.rails = options?.rails ?? DEFAULT_RAILS;
+        this.microPaymentThreshold = options?.microPaymentThreshold ?? 1000000; // $1.00
+        this.highFrequencyThreshold = options?.highFrequencyThreshold ?? 5;
+    }
+    /**
+     * Select the optimal payment rail for a given context.
+     */
+    route(context) {
+        const { amount, isSessionContext, sessionTxCount, autonomous, preferredChain } = context;
+        // If Google AP2 rail is live and context indicates Google ecosystem preference
+        // Google AP2 (Agent Payment Protocol) — Google's native agent payment rail
+        // Currently roadmap; will activate when Google publishes the full AP2 spec
+        const googleRail = this.getRail('google-ap2');
+        if (googleRail?.status === 'live' && preferredChain === 'base') {
+            // Google AP2 routes through Base for on-chain settlement
+            // When live, AP2 provides Google-managed identity + payment in a single flow
+            return {
+                rail: 'google-ap2',
+                reason: 'Google AP2 rail — managed identity + payment bundle',
+                estimatedOverheadBps: 100, // Estimated Google platform fee
+                isLive: true,
+            };
+        }
+        // If Solana is explicitly preferred and x402-solana is available
+        if (preferredChain === 'solana') {
+            const solanaRail = this.getRail('x402-solana');
+            if (solanaRail?.status === 'live') {
+                return {
+                    rail: 'x402-solana',
+                    reason: 'Preferred chain: Solana x402',
+                    estimatedOverheadBps: 0,
+                    isLive: true,
+                };
+            }
+            // Solana not yet live — fall through to other rails
+        }
+        // Rule 1: High-frequency session context → MPP (batching efficiency)
+        if (isSessionContext && (sessionTxCount ?? 0) >= this.highFrequencyThreshold) {
+            const mppRail = this.getRail('mpp');
+            if (mppRail?.status === 'live') {
+                return {
+                    rail: 'mpp',
+                    reason: `High-frequency session (${sessionTxCount} txns) — MPP batching is more efficient`,
+                    estimatedOverheadBps: 290, // Stripe's ~2.9%
+                    isLive: true,
+                };
+            }
+        }
+        // Rule 2: Micropayments + autonomous → x402 (lower overhead, no session needed)
+        if (amount < this.microPaymentThreshold && autonomous !== false) {
+            const x402Rail = this.getRail('x402');
+            if (x402Rail?.status === 'live') {
+                return {
+                    rail: 'x402',
+                    reason: `Micropayment ($${(amount / 1000000).toFixed(2)}) + autonomous — x402 optimal`,
+                    estimatedOverheadBps: 0, // x402 has no protocol fee
+                    isLive: true,
+                };
+            }
+        }
+        // Rule 3: Larger amounts or supervised → MPP (better dispute resolution, fiat rails)
+        const mppRail = this.getRail('mpp');
+        if (mppRail?.status === 'live' && amount >= (mppRail.minAmount ?? 0)) {
+            return {
+                rail: 'mpp',
+                reason: `Amount $${(amount / 1000000).toFixed(2)} — MPP provides fiat rails and dispute resolution`,
+                estimatedOverheadBps: 290,
+                isLive: true,
+            };
+        }
+        // Default: x402 on Base
+        return {
+            rail: 'x402',
+            reason: 'Default rail — Base x402',
+            estimatedOverheadBps: 0,
+            isLive: this.getRail('x402')?.status === 'live',
+        };
+    }
+    /**
+     * Get all available (live) rails.
+     */
+    getLiveRails() {
+        return this.rails.filter((r) => r.status === 'live');
+    }
+    /**
+     * Check if a specific rail is available.
+     */
+    isRailLive(rail) {
+        return this.getRail(rail)?.status === 'live';
+    }
+    getRail(rail) {
+        return this.rails.find((r) => r.rail === rail);
+    }
+}
+//# sourceMappingURL=PaymentRouter.js.map

package/dist/router/PaymentRouter.js.map

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

package/dist/router/index.d.ts

@@ -0,0 +1,3 @@
+export { PaymentRouter } from './PaymentRouter';
+export type { PaymentRail, RailStatus, RailConfig, PaymentContext, RoutingDecision, } from './PaymentRouter';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,cAAc,EACd,eAAe,GAChB,MAAM,iBAAiB,CAAC"}

package/dist/router/index.js

@@ -0,0 +1,2 @@
+export { PaymentRouter } from './PaymentRouter';
+//# sourceMappingURL=index.js.map

package/dist/router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/swap/SwapModule.d.ts

@@ -39,8 +39,8 @@ export declare function attachSwap(wallet: {
     chain?: SwapChain;
 }): {
     swapModule: SwapModule;
-    swap: (tokenIn: `0x${string}`, tokenOut: `0x${string}`, amountIn: bigint, options?: SwapOptions) => Promise<SwapResult>;
-    getQuote: (tokenIn: `0x${string}`, tokenOut: `0x${string}`, amountIn: bigint, options?: Pick<SwapOptions, "slippageBps" | "feeTiers">) => Promise<SwapQuote>;
+    swap: (tokenIn: Address, tokenOut: Address, amountIn: bigint, options?: SwapOptions) => Promise<SwapResult>;
+    getQuote: (tokenIn: Address, tokenOut: Address, amountIn: bigint, options?: Pick<SwapOptions, "slippageBps" | "feeTiers">) => Promise<SwapQuote>;
     address: Address;
     publicClient: PublicClient;
     walletClient: WalletClient;

package/dist/swap/SwapModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SwapModule.d.ts","sourceRoot":"","sources":["../../src/swap/SwapModule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AAEd,OAAO,EACL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAMf,MAAM,YAAY,CAAC;AAIpB,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAGxC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,OAAO,EACvB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE;IAoBtD,QAAQ,CACZ,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,UAAU,CAAM,GAC1D,OAAO,CAAC,SAAS,CAAC;IAyCf,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;YAqBnF,WAAW;IAanB,IAAI,CACR,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IAuCtB,SAAS,IAAI,gBAAgB;IAI7B,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAGrC;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,YAAY,CAAA;CAAE,EACpF,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE;;;;aADvC,OAAO;kBAAgB,YAAY;kBAAgB,YAAY;EAUnF"}
+{"version":3,"file":"SwapModule.d.ts","sourceRoot":"","sources":["../../src/swap/SwapModule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,MAAM,CAAC;AAEd,OAAO,EACL,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,EAMf,MAAM,YAAY,CAAC;AAIpB,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;gBAGxC,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,OAAO,EACvB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG;QAAE,KAAK,CAAC,EAAE,SAAS,CAAA;KAAE;IAoBtD,QAAQ,CACZ,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,UAAU,CAAM,GAC1D,OAAO,CAAC,SAAS,CAAC;IAyCf,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;YAqBnF,WAAW;IAanB,IAAI,CACR,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC;IAuCtB,SAAS,IAAI,gBAAgB;IAI7B,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;CAGrC;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,YAAY,CAAC;IAAC,YAAY,EAAE,YAAY,CAAA;CAAE,EACpF,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE;;oBAtD/C,OAAO,YACN,OAAO,YACP,MAAM,YACP,WAAW,KACnB,OAAO,CAAC,UAAU,CAAC;wBApFX,OAAO,YACN,OAAO,YACP,MAAM,YACP,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,UAAU,CAAC,KACrD,OAAO,CAAC,SAAS,CAAC;aAiIF,OAAO;kBAAgB,YAAY;kBAAgB,YAAY;EAUnF"}

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtD,2CAA2C;AAC3C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,cAAc,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,KAAK,EAAE,SAAS,CAAC;CAClB;AAID,8CAA8C;AAC9C,eAAO,MAAM,WAAW;;;;;CAKvB,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,eAAe;;;;CAI3B,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,eAAe;;;;;CAK3B,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAiB3F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe;;;CAG3B,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,8CAAwD,CAAC;AAC5F,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,KAAK,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/swap/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,kCAAkC;AAClC,MAAM,MAAM,cAAc,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,CAAC;AAEtD,2CAA2C;AAC3C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAErE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,cAAc,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,8CAA8C;IAC9C,KAAK,EAAE,SAAS,CAAC;CAClB;AAID,8CAA8C;AAC9C,eAAO,MAAM,WAAW;;;;;CAKvB,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,eAAe;;;;CAI3B,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,eAAe;;;;;CAK3B,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,cAAc;;;;;CAK1B,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,SAAS,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAiB3F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe;;;CAG3B,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC,sDAAsD;AACtD,eAAO,MAAM,sBAAsB,EAAG,4CAAqD,CAAC;AAC5F,qCAAqC;AACrC,eAAO,MAAM,oBAAoB,KAAK,CAAC"}

package/dist/tokens/solana.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../src/tokens/solana.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,eAAO,MAAM,aAAa;;;;;;;;;;;CA8BhB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uCAAuC;AACvC,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAWnE,CAAC;AA4DF,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,YAAY,CAAC,EAAE,UAAU,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAG5C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAa;gBAEjB,MAAM,GAAE,kBAAuB;YAK7B,aAAa;YAOb,UAAU;IAwBxB,gDAAgD;IAC1C,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAKrC;;;OAGG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBhE;;;;OAIG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAqC5B;;;;OAIG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA6B3E;;;;;;;OAOG;IACG,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC;IA6D1B;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAmBjG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAE3E"}
+{"version":3,"file":"solana.d.ts","sourceRoot":"","sources":["../../src/tokens/solana.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAOH,eAAO,MAAM,aAAa;kBAEV,IAAI;;;;;;;;;;CA4BV,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,aAAa,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,uCAAuC;AACvC,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAWnE,CAAC;AA4DF,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,YAAY,CAAC,EAAE,UAAU,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAG5C,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAa;gBAEjB,MAAM,GAAE,kBAAuB;YAK7B,aAAa;YAOb,UAAU;IAwBxB,gDAAgD;IAC1C,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC;IAKrC;;;OAGG;IACG,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmBhE;;;;OAIG;IACG,kBAAkB,CACtB,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,gBAAgB,CAAC;IAqC5B;;;;OAIG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IA6B3E;;;;;;;OAOG;IACG,YAAY,CAChB,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC;IA6D1B;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAmBjG;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAE3E"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentwallet-sdk",
-  "version": "6.0.5",
-  "description": "Non-custodial AI agent wallet SDK. ERC-8004 identity & reputation registries, mutual stake escrow, x402 payments, 17-chain CCTP bridging, ERC-6551 TBA, SpendingPolicy guardrails, Uniswap V3 swap. The agent holds the keys.",
+  "version": "6.2.0",
+  "description": "Non-custodial AI agent wallet SDK. ERC-8004 identity & reputation registries, mutual stake escrow, x402 payments, x402 upto billing policy accounting, 17-chain CCTP bridging, ERC-6551 TBA, SpendingPolicy guardrails, Uniswap V3 swap. The agent holds the keys.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [

package/dist/x402/chains/stellar/index.d.ts

@@ -1,149 +0,0 @@
-/**
- * Stellar x402 Payment Adapter
- *
- * Implements x402 payment protocol on Stellar network.
- * Stellar x402 support went live March 11, 2026.
- *
- * Chain identifiers:
- *   - Stellar Mainnet: "stellar:pubnet"
- *   - Stellar Testnet: "stellar:testnet"
- *
- * Key differences from EVM chains:
- * - Uses Ed25519 keypairs (not secp256k1)
- * - Transaction format: Stellar XDR (not EVM tx)
- * - Settlement: ~5 seconds (1 ledger close)
- * - Fees: ~0.00001 XLM per operation (effectively free at scale)
- * - USDC: Circle-issued USDC on Stellar
- */
-export declare const STELLAR_NETWORK: {
-    readonly pubnet: {
-        readonly horizonUrl: "https://horizon.stellar.org";
-        readonly networkPassphrase: "Public Global Stellar Network ; September 2015";
-        readonly chainId: "stellar:pubnet";
-    };
-    readonly testnet: {
-        readonly horizonUrl: "https://horizon-testnet.stellar.org";
-        readonly networkPassphrase: "Test SDF Network ; September 2015";
-        readonly chainId: "stellar:testnet";
-    };
-};
-/**
- * Circle USDC on Stellar (Mainnet)
- * Asset code: USDC
- * Issuer: GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN
- */
-export declare const STELLAR_USDC: {
-    readonly pubnet: {
-        readonly code: "USDC";
-        readonly issuer: "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN";
-    };
-    readonly testnet: {
-        readonly code: "USDC";
-        readonly issuer: "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5";
-    };
-};
-export type StellarNetwork = 'pubnet' | 'testnet';
-export interface StellarPaymentConfig {
-    /** Which Stellar network to use */
-    network?: StellarNetwork;
-    /** x402 resource identifier (for memo) */
-    resource?: string;
-    /** Custom Horizon URL (overrides default) */
-    horizonUrl?: string;
-}
-export interface StellarPaymentRequest {
-    /** Destination Stellar account (G... address) */
-    destination: string;
-    /** Amount in USDC (decimal string, e.g. "0.50") */
-    amount: string;
-    /** Source Stellar account public key */
-    sourcePublicKey: string;
-    /** x402 resource path for memo */
-    resource?: string;
-    /** Network to use */
-    network?: StellarNetwork;
-}
-export interface StellarPaymentResult {
-    /** Stellar transaction hash */
-    hash: string;
-    /** Ledger number the transaction landed in */
-    ledger: number;
-    /** Successful */
-    successful: boolean;
-    /** Network used */
-    network: StellarNetwork;
-}
-/**
- * StellarX402Adapter
- *
- * Handles x402 payment flow for Stellar network.
- *
- * Usage (with stellar-sdk):
- * ```typescript
- * import { StellarX402Adapter } from 'agentwallet-sdk/x402/stellar';
- * import { Keypair, Networks } from '@stellar/stellar-sdk';
- *
- * const adapter = new StellarX402Adapter({ network: 'pubnet' });
- * const result = await adapter.pay({
- *   destination: 'GDESTWVX3VMLQCXPHPVLS3FMNMG2X7L5IGGQT7BQMIZXZZ4V7KBQVS',
- *   amount: '0.50',
- *   sourcePublicKey: keypair.publicKey(),
- *   resource: '/api/data-endpoint',
- * }, keypair.secret());
- * ```
- *
- * Note: stellar-sdk must be installed separately:
- * npm install @stellar/stellar-sdk
- */
-export declare class StellarX402Adapter {
-    private network;
-    private horizonUrl;
-    constructor(config?: StellarPaymentConfig);
-    /**
-     * Parse an x402 402 response and extract Stellar payment details.
-     * The 402 response should include X-Payment-Chains: stellar:pubnet
-     * and X-Payment-Amount, X-Payment-Destination headers.
-     */
-    parseX402Response(headers: Record<string, string>): {
-        supported: boolean;
-        destination?: string;
-        amount?: string;
-        resource?: string;
-    };
-    /**
-     * Build a Stellar USDC payment transaction.
-     *
-     * Requires @stellar/stellar-sdk to be installed:
-     * npm install @stellar/stellar-sdk
-     *
-     * Returns the XDR-encoded transaction envelope for signing and submission.
-     */
-    buildPaymentTransaction(request: StellarPaymentRequest): Promise<string>;
-    /**
-     * Submit a signed Stellar transaction to Horizon.
-     */
-    submitTransaction(signedXdr: string): Promise<StellarPaymentResult>;
-    private _loadAccount;
-    /** Chain ID for this adapter (e.g. "stellar:pubnet") */
-    get chainId(): string;
-}
-/**
- * Full x402 payment flow for Stellar.
- * 1. Detects 402 response from API
- * 2. Parses Stellar payment details from headers
- * 3. Builds, signs, and submits Stellar USDC payment
- * 4. Retries the original request with payment proof
- *
- * Requires stellar-sdk: npm install @stellar/stellar-sdk
- */
-export declare function stellarX402Pay(params: {
-    /** The 402 response headers */
-    responseHeaders: Record<string, string>;
-    /** Source account public key */
-    sourcePublicKey: string;
-    /** Signer function that takes XDR and returns signed XDR */
-    sign: (xdr: string) => Promise<string>;
-    /** Network to use */
-    network?: StellarNetwork;
-}): Promise<StellarPaymentResult>;
-//# sourceMappingURL=index.d.ts.map

package/dist/x402/chains/stellar/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/x402/chains/stellar/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,eAAO,MAAM,eAAe;;;;;;;;;;;CAWlB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;;;;;;;CASf,CAAC;AAIX,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,mBAAmB;IACnB,OAAO,EAAE,cAAc,CAAC;CACzB;AAID;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,GAAE,oBAAyB;IAK7C;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAClD,SAAS,EAAE,OAAO,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB;IAgBD;;;;;;;OAOG;IACG,uBAAuB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IA+C9E;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;YA6B3D,YAAY;IAe1B,wDAAwD;IACxD,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;AAID;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,gCAAgC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,qBAAqB;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqBhC"}