agentwallet-sdk 2.4.1 → 3.0.0

package/dist/solana/swap.js

@@ -0,0 +1,173 @@
+// [MAX-ADDED] JupiterSwapClient — DEX aggregator for Solana agents.
+// Jupiter is the dominant swap aggregator on Solana (equivalent to Uniswap on EVM).
+// API docs: https://station.jup.ag/docs/apis/swap-api
+import { VersionedTransaction } from '@solana/web3.js';
+import { SOLANA_USDC_MINT, SOL_NATIVE_MINT } from './types.js';
+/** Jupiter Aggregator V6 API base URL */
+const JUPITER_API_BASE = 'https://quote-api.jup.ag/v6';
+/** Platform fee: 0.875% (same as EVM SwapModule) in basis points */
+export const JUPITER_PLATFORM_FEE_BPS = 88; // 0.875% ≈ 88 bps (rounded)
+/** Default slippage: 50 bps = 0.5% */
+export const JUPITER_DEFAULT_SLIPPAGE_BPS = 50;
+/**
+ * JupiterSwapClient — wraps Jupiter Aggregator V6 for best-route token swaps on Solana.
+ *
+ * Features:
+ *   - Best-route quote from Jupiter
+ *   - 0.875% platform fee (matches EVM SwapModule)
+ *   - SOL ↔ USDC default routes
+ *   - Full slippage control
+ *   - No real RPC calls in mocked tests
+ */
+export class JupiterSwapClient {
+    constructor(config) {
+        this.wallet = config.wallet;
+        this.feeWallet = config.feeWallet;
+        this.apiBase = config.apiBase ?? JUPITER_API_BASE;
+        this.defaultSlippageBps = config.defaultSlippageBps ?? JUPITER_DEFAULT_SLIPPAGE_BPS;
+    }
+    /**
+     * Get the best-route quote from Jupiter.
+     *
+     * @param inputMint - Input token mint (use SOL_NATIVE_MINT for native SOL)
+     * @param outputMint - Output token mint
+     * @param amount - Input amount in token base units
+     * @param slippageBps - Slippage tolerance in bps (default: 50)
+     * @returns JupiterQuote with route and output amount
+     */
+    async getQuote(inputMint, outputMint, amount, slippageBps) {
+        const slip = slippageBps ?? this.defaultSlippageBps;
+        const params = new URLSearchParams({
+            inputMint,
+            outputMint,
+            amount: amount.toString(),
+            slippageBps: slip.toString(),
+            ...(this.feeWallet
+                ? {
+                    platformFeeBps: JUPITER_PLATFORM_FEE_BPS.toString(),
+                    feeAccount: this.feeWallet,
+                }
+                : {}),
+        });
+        const url = `${this.apiBase}/quote?${params.toString()}`;
+        const res = await fetch(url);
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`Jupiter quote failed (${res.status}): ${text}`);
+        }
+        const quote = (await res.json());
+        return quote;
+    }
+    /**
+     * Execute a swap via Jupiter.
+     *
+     * Flow:
+     *   1. Get best-route quote from Jupiter
+     *   2. Request swap transaction from Jupiter
+     *   3. Deserialize + sign + broadcast via SolanaWallet
+     *
+     * @returns JupiterSwapResult with signature and amounts
+     */
+    async swap(params) {
+        const slippageBps = params.slippageBps ?? this.defaultSlippageBps;
+        // Step 1: Get quote
+        const quote = await this.getQuote(params.inputMint, params.outputMint, params.amount, slippageBps);
+        // Step 2: Get swap transaction from Jupiter
+        const swapRes = await fetch(`${this.apiBase}/swap`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                quoteResponse: quote,
+                userPublicKey: this.wallet.getAddress(),
+                ...(this.feeWallet
+                    ? { feeAccount: this.feeWallet }
+                    : {}),
+                dynamicComputeUnitLimit: true,
+                prioritizationFeeLamports: 'auto',
+            }),
+        });
+        if (!swapRes.ok) {
+            const text = await swapRes.text();
+            throw new Error(`Jupiter swap tx failed (${swapRes.status}): ${text}`);
+        }
+        const { swapTransaction } = (await swapRes.json());
+        // Step 3: Deserialize, sign, and broadcast
+        const connection = this.wallet.getConnection();
+        const txBuf = Uint8Array.from(atob(swapTransaction), (c) => c.charCodeAt(0));
+        const versionedTx = VersionedTransaction.deserialize(txBuf);
+        // Sign with wallet keypair — need internal access
+        // We expose a method on SolanaWallet for versioned tx signing
+        const signedTx = await this._signVersionedTx(versionedTx);
+        const signature = await connection.sendRawTransaction(signedTx.serialize(), {
+            skipPreflight: false,
+            preflightCommitment: 'confirmed',
+        });
+        // Confirm
+        const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash();
+        await connection.confirmTransaction({ signature, blockhash, lastValidBlockHeight }, 'confirmed');
+        return {
+            txSignature: signature,
+            inputMint: params.inputMint,
+            outputMint: params.outputMint,
+            inputAmount: params.amount,
+            outputAmount: BigInt(quote.outAmount),
+            slippageBps,
+            platformFeeBps: JUPITER_PLATFORM_FEE_BPS,
+        };
+    }
+    /**
+     * Convenience: Swap SOL → USDC.
+     */
+    async swapSolToUsdc(lamports, slippageBps) {
+        return this.swap({
+            inputMint: SOL_NATIVE_MINT,
+            outputMint: SOLANA_USDC_MINT,
+            amount: lamports,
+            slippageBps,
+        });
+    }
+    /**
+     * Convenience: Swap USDC → SOL.
+     */
+    async swapUsdcToSol(microUsdc, slippageBps) {
+        return this.swap({
+            inputMint: SOLANA_USDC_MINT,
+            outputMint: SOL_NATIVE_MINT,
+            amount: microUsdc,
+            slippageBps,
+        });
+    }
+    /**
+     * Calculate the platform fee for a given input amount.
+     * Mirrors EVM SwapModule's calcProtocolFee() for consistency.
+     *
+     * @param amount - Input amount in token base units
+     * @returns Fee amount in token base units (floored)
+     */
+    calcPlatformFee(amount) {
+        return (amount * BigInt(JUPITER_PLATFORM_FEE_BPS)) / 10000n;
+    }
+    /**
+     * Sign a versioned transaction (Jupiter uses VersionedTransaction internally).
+     * Routes through the wallet's keypair via a controlled interface.
+     */
+    async _signVersionedTx(tx) {
+        // Access internal keypair through the wallet's exposed signing interface
+        // SolanaWallet exposes getPublicKey() but we need the keypair for versioned tx
+        // We handle this by adding a signVersionedTransaction method to SolanaWallet
+        const connection = this.wallet.getConnection();
+        const { blockhash } = await connection.getLatestBlockhash('confirmed');
+        tx.message.recentBlockhash = blockhash;
+        // Use the wallet's sign method — wallet class exposes this for versioned txs
+        return this.wallet._signVersionedTransaction(tx);
+    }
+}
+/**
+ * Factory: create a JupiterSwapClient attached to an existing SolanaWallet.
+ */
+export function attachJupiterSwap(wallet, options = {}) {
+    return new JupiterSwapClient({ wallet, ...options });
+}
+// Re-export convenience constants
+export { SOLANA_USDC_MINT, SOL_NATIVE_MINT };
+//# sourceMappingURL=swap.js.map

package/dist/solana/swap.js.map

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

package/dist/solana/types.d.ts

@@ -0,0 +1,126 @@
+/** USDC SPL token mint on Solana Mainnet (Circle official) */
+export declare const SOLANA_USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+/** USDC SPL token mint on Solana Devnet (Circle official devnet) */
+export declare const SOLANA_USDC_DEVNET_MINT = "4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU";
+/** SOL native mint placeholder (used to represent native SOL in transfer params) */
+export declare const SOL_NATIVE_MINT = "So11111111111111111111111111111111111111112";
+/** Solana commitment level — matches @solana/web3.js Commitment type */
+export type SolanaCommitment = 'processed' | 'confirmed' | 'finalized';
+/**
+ * Configuration for SolanaWallet.
+ *
+ * Supply ONE of:
+ *   - `secretKey` (Uint8Array — 64-byte keypair from Keypair.secretKey)
+ *   - `privateKeyBase58` (base58-encoded 64-byte secret key)
+ *   - neither → generates a fresh random keypair (useful for testing/ephemeral agents)
+ */
+export interface SolanaWalletConfig {
+    /** Solana RPC endpoint URL (e.g. https://api.mainnet-beta.solana.com) */
+    rpcUrl: string;
+    /** 64-byte keypair secret key as Uint8Array */
+    secretKey?: Uint8Array;
+    /** Base58-encoded 64-byte secret key */
+    privateKeyBase58?: string;
+    /** Commitment level for reads (default: 'confirmed') */
+    commitment?: SolanaCommitment;
+}
+/**
+ * Parameters for transferring SOL or SPL tokens.
+ *
+ * If `mint` is omitted or set to SOL_NATIVE_MINT, transfers native SOL.
+ * Otherwise, performs an SPL token transfer.
+ *
+ * `amount` is always in the smallest unit:
+ *   - SOL: lamports (1 SOL = 1_000_000_000 lamports)
+ *   - USDC: micro-USDC (1 USDC = 1_000_000 μUSDC, 6 decimals)
+ */
+export interface SolanaTransferParams {
+    /** Recipient public key (base58) */
+    recipient: string;
+    /** Amount in smallest units (lamports for SOL, token base units for SPL) */
+    amount: bigint;
+    /** SPL token mint address. Omit for native SOL transfer. */
+    mint?: string;
+}
+/** Jupiter quote response (subset of full API response) */
+export interface JupiterQuote {
+    inputMint: string;
+    inAmount: string;
+    outputMint: string;
+    outAmount: string;
+    otherAmountThreshold: string;
+    swapMode: string;
+    slippageBps: number;
+    priceImpactPct: string;
+    routePlan: JupiterRoutePlan[];
+    /** Platform fee breakdown (if applied) */
+    platformFee?: {
+        amount: string;
+        feeBps: number;
+    };
+}
+export interface JupiterRoutePlan {
+    swapInfo: {
+        ammKey: string;
+        label?: string;
+        inputMint: string;
+        outputMint: string;
+        inAmount: string;
+        outAmount: string;
+        feeAmount: string;
+        feeMint: string;
+    };
+    percent: number;
+}
+/** Parameters for executing a Jupiter swap */
+export interface JupiterSwapParams {
+    inputMint: string;
+    outputMint: string;
+    /** Amount in token base units */
+    amount: bigint;
+    /** Slippage in basis points (e.g. 50 = 0.5%) */
+    slippageBps?: number;
+}
+/** Result of a completed Jupiter swap */
+export interface JupiterSwapResult {
+    txSignature: string;
+    inputMint: string;
+    outputMint: string;
+    inputAmount: bigint;
+    outputAmount: bigint;
+    slippageBps: number;
+    platformFeeBps: number;
+}
+/** Solana x402 payment proof — returned after signing an SPL token transfer */
+export interface SolanaX402PaymentProof {
+    /** x402 protocol version */
+    x402Version: number;
+    /** Network identifier */
+    network: 'solana:mainnet' | 'solana:devnet';
+    /** SPL token mint that was transferred */
+    mint: string;
+    /** Recipient public key (base58) */
+    recipient: string;
+    /** Amount in token base units */
+    amount: string;
+    /** Sender public key (base58) */
+    sender: string;
+    /** Serialized signed transaction (base64) */
+    signedTransaction: string;
+    /** Transaction signature after broadcast */
+    txSignature?: string;
+}
+/** Solana x402 payment requirements (from 402 response) */
+export interface SolanaX402Requirements {
+    scheme: string;
+    network: 'solana:mainnet' | 'solana:devnet';
+    /** SPL token mint address */
+    asset: string;
+    /** Amount in token base units */
+    amount: string;
+    /** Recipient public key (base58) */
+    payTo: string;
+    maxTimeoutSeconds: number;
+    extra: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/solana/types.js

@@ -0,0 +1,10 @@
+// [MAX-ADDED] Solana-specific types for agent-wallet-sdk v3.0.0
+// Solana is NOT EVM — different key primitives, account model, and token standard (SPL).
+// ─── USDC Mint Addresses ───────────────────────────────────────────────────
+/** USDC SPL token mint on Solana Mainnet (Circle official) */
+export const SOLANA_USDC_MINT = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
+/** USDC SPL token mint on Solana Devnet (Circle official devnet) */
+export const SOLANA_USDC_DEVNET_MINT = '4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU';
+/** SOL native mint placeholder (used to represent native SOL in transfer params) */
+export const SOL_NATIVE_MINT = 'So11111111111111111111111111111111111111112';
+//# sourceMappingURL=types.js.map

package/dist/solana/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/solana/types.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,yFAAyF;AAEzF,8EAA8E;AAE9E,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,8CAA8C,CAAC;AAE/E,oEAAoE;AACpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,8CAA8C,CAAC;AAEtF,oFAAoF;AACpF,MAAM,CAAC,MAAM,eAAe,GAAG,6CAA6C,CAAC"}

package/dist/solana/wallet.d.ts

@@ -0,0 +1,83 @@
+import { Connection, PublicKey, Transaction } from '@solana/web3.js';
+import type { SolanaWalletConfig, SolanaTransferParams } from './types.js';
+/**
+ * SolanaWallet — non-custodial agent wallet for Solana.
+ *
+ * Supports:
+ *   - Ed25519 keypair (generated or supplied)
+ *   - Native SOL balance + transfer
+ *   - SPL token balance + transfer (USDC, etc.)
+ *   - Transaction signing
+ *
+ * Non-custodial guarantee: private key stays local in memory.
+ * Never serialized, never logged, never transmitted.
+ */
+export declare class SolanaWallet {
+    private keypair;
+    private connection;
+    private commitment;
+    constructor(config: SolanaWalletConfig);
+    /**
+     * Create a SolanaWallet from a base58-encoded private key string.
+     * Convenience factory for config-driven agent setups.
+     */
+    static fromBase58(privateKeyBase58: string, rpcUrl: string): SolanaWallet;
+    /**
+     * Create a SolanaWallet with a freshly generated keypair.
+     * Useful for one-off agent wallets or testing.
+     */
+    static generate(rpcUrl: string): SolanaWallet;
+    /**
+     * Returns the wallet's base58 public key (the "address" on Solana).
+     */
+    getAddress(): string;
+    /**
+     * Returns the wallet's public key object.
+     */
+    getPublicKey(): PublicKey;
+    /**
+     * Get balance.
+     *
+     * @param mint - SPL token mint (omit or pass SOL_NATIVE_MINT for native SOL)
+     * @returns Balance in smallest units (lamports for SOL, base units for SPL tokens)
+     */
+    getBalance(mint?: string): Promise<bigint>;
+    /**
+     * Transfer SOL or SPL tokens.
+     *
+     * For SOL: `amount` in lamports.
+     * For SPL: `amount` in token base units (e.g. 1_000_000 for 1 USDC).
+     *
+     * @returns Transaction signature string
+     */
+    transfer(params: SolanaTransferParams): Promise<string>;
+    /**
+     * Sign a transaction with the local keypair (without broadcasting).
+     * Useful for x402 payment proofs and offline signing flows.
+     */
+    signTransaction(tx: Transaction): Transaction;
+    /**
+     * Sign and serialize a transaction to base64.
+     * Used for x402 payment proof construction.
+     */
+    signTransactionBase64(tx: Transaction): Promise<string>;
+    /**
+     * Get mint info (decimals, supply) for an SPL token.
+     */
+    getMintInfo(mint: string): Promise<{
+        decimals: number;
+        supply: bigint;
+    }>;
+    /**
+     * Sign a VersionedTransaction (used by JupiterSwapClient and bridge).
+     * Jupiter V6 returns VersionedTransactions that require this signing path.
+     *
+     * Internal method — prefixed with underscore to signal controlled access.
+     */
+    _signVersionedTransaction(tx: import('@solana/web3.js').VersionedTransaction): import('@solana/web3.js').VersionedTransaction;
+    /**
+     * Expose the underlying connection for advanced usage.
+     */
+    getConnection(): Connection;
+}
+//# sourceMappingURL=wallet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../../src/solana/wallet.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,UAAU,EAEV,SAAS,EAET,WAAW,EAGZ,MAAM,iBAAiB,CAAC;AAQzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAoB,MAAM,YAAY,CAAC;AAG7F;;;;;;;;;;;GAWG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAmB;gBAEzB,MAAM,EAAE,kBAAkB;IAetC;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY;IAIzE;;;OAGG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAI7C;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,YAAY,IAAI,SAAS;IAIzB;;;;;OAKG;IACG,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBhD;;;;;;;OAOG;IACG,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkD7D;;;OAGG;IACH,eAAe,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW;IAK7C;;;OAGG;IACG,qBAAqB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ7D;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ9E;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,EAAE,OAAO,iBAAiB,EAAE,oBAAoB,GAAG,OAAO,iBAAiB,EAAE,oBAAoB;IAK7H;;OAEG;IACH,aAAa,IAAI,UAAU;CAG5B"}

package/dist/solana/wallet.js

@@ -0,0 +1,164 @@
+// [MAX-ADDED] SolanaWallet — non-custodial Solana wallet for AI agents.
+// Uses @solana/web3.js + @solana/spl-token. Key never leaves this class.
+import { Connection, Keypair, PublicKey, SystemProgram, Transaction, sendAndConfirmTransaction, } from '@solana/web3.js';
+import { getOrCreateAssociatedTokenAccount, createTransferInstruction, getAccount, getMint, } from '@solana/spl-token';
+import bs58 from 'bs58';
+import { SOL_NATIVE_MINT } from './types.js';
+/**
+ * SolanaWallet — non-custodial agent wallet for Solana.
+ *
+ * Supports:
+ *   - Ed25519 keypair (generated or supplied)
+ *   - Native SOL balance + transfer
+ *   - SPL token balance + transfer (USDC, etc.)
+ *   - Transaction signing
+ *
+ * Non-custodial guarantee: private key stays local in memory.
+ * Never serialized, never logged, never transmitted.
+ */
+export class SolanaWallet {
+    constructor(config) {
+        this.commitment = config.commitment ?? 'confirmed';
+        this.connection = new Connection(config.rpcUrl, this.commitment);
+        if (config.secretKey) {
+            this.keypair = Keypair.fromSecretKey(config.secretKey);
+        }
+        else if (config.privateKeyBase58) {
+            const decoded = bs58.decode(config.privateKeyBase58);
+            this.keypair = Keypair.fromSecretKey(decoded);
+        }
+        else {
+            // Generate fresh keypair — useful for ephemeral agent wallets
+            this.keypair = Keypair.generate();
+        }
+    }
+    /**
+     * Create a SolanaWallet from a base58-encoded private key string.
+     * Convenience factory for config-driven agent setups.
+     */
+    static fromBase58(privateKeyBase58, rpcUrl) {
+        return new SolanaWallet({ rpcUrl, privateKeyBase58 });
+    }
+    /**
+     * Create a SolanaWallet with a freshly generated keypair.
+     * Useful for one-off agent wallets or testing.
+     */
+    static generate(rpcUrl) {
+        return new SolanaWallet({ rpcUrl });
+    }
+    /**
+     * Returns the wallet's base58 public key (the "address" on Solana).
+     */
+    getAddress() {
+        return this.keypair.publicKey.toBase58();
+    }
+    /**
+     * Returns the wallet's public key object.
+     */
+    getPublicKey() {
+        return this.keypair.publicKey;
+    }
+    /**
+     * Get balance.
+     *
+     * @param mint - SPL token mint (omit or pass SOL_NATIVE_MINT for native SOL)
+     * @returns Balance in smallest units (lamports for SOL, base units for SPL tokens)
+     */
+    async getBalance(mint) {
+        if (!mint || mint === SOL_NATIVE_MINT) {
+            const lamports = await this.connection.getBalance(this.keypair.publicKey);
+            return BigInt(lamports);
+        }
+        // SPL token balance
+        const mintPubkey = new PublicKey(mint);
+        const { getAssociatedTokenAddress } = await import('@solana/spl-token');
+        const ata = await getAssociatedTokenAddress(mintPubkey, this.keypair.publicKey);
+        try {
+            const account = await getAccount(this.connection, ata, this.commitment);
+            return BigInt(account.amount.toString());
+        }
+        catch {
+            // Account doesn't exist yet — balance is 0
+            return 0n;
+        }
+    }
+    /**
+     * Transfer SOL or SPL tokens.
+     *
+     * For SOL: `amount` in lamports.
+     * For SPL: `amount` in token base units (e.g. 1_000_000 for 1 USDC).
+     *
+     * @returns Transaction signature string
+     */
+    async transfer(params) {
+        const tx = new Transaction();
+        const recipient = new PublicKey(params.recipient);
+        if (!params.mint || params.mint === SOL_NATIVE_MINT) {
+            // Native SOL transfer
+            tx.add(SystemProgram.transfer({
+                fromPubkey: this.keypair.publicKey,
+                toPubkey: recipient,
+                lamports: Number(params.amount),
+            }));
+        }
+        else {
+            // SPL token transfer
+            const mintPubkey = new PublicKey(params.mint);
+            // Get or create sender's ATA
+            const senderAta = await getOrCreateAssociatedTokenAccount(this.connection, this.keypair, mintPubkey, this.keypair.publicKey);
+            // Get or create recipient's ATA
+            const recipientAta = await getOrCreateAssociatedTokenAccount(this.connection, this.keypair, mintPubkey, recipient);
+            tx.add(createTransferInstruction(senderAta.address, recipientAta.address, this.keypair.publicKey, Number(params.amount)));
+        }
+        const signature = await sendAndConfirmTransaction(this.connection, tx, [this.keypair], {
+            commitment: this.commitment,
+        });
+        return signature;
+    }
+    /**
+     * Sign a transaction with the local keypair (without broadcasting).
+     * Useful for x402 payment proofs and offline signing flows.
+     */
+    signTransaction(tx) {
+        tx.sign(this.keypair);
+        return tx;
+    }
+    /**
+     * Sign and serialize a transaction to base64.
+     * Used for x402 payment proof construction.
+     */
+    async signTransactionBase64(tx) {
+        const { blockhash } = await this.connection.getLatestBlockhash(this.commitment);
+        tx.recentBlockhash = blockhash;
+        tx.feePayer = this.keypair.publicKey;
+        tx.sign(this.keypair);
+        return tx.serialize().toString('base64');
+    }
+    /**
+     * Get mint info (decimals, supply) for an SPL token.
+     */
+    async getMintInfo(mint) {
+        const mintInfo = await getMint(this.connection, new PublicKey(mint), this.commitment);
+        return {
+            decimals: mintInfo.decimals,
+            supply: BigInt(mintInfo.supply.toString()),
+        };
+    }
+    /**
+     * Sign a VersionedTransaction (used by JupiterSwapClient and bridge).
+     * Jupiter V6 returns VersionedTransactions that require this signing path.
+     *
+     * Internal method — prefixed with underscore to signal controlled access.
+     */
+    _signVersionedTransaction(tx) {
+        tx.sign([this.keypair]);
+        return tx;
+    }
+    /**
+     * Expose the underlying connection for advanced usage.
+     */
+    getConnection() {
+        return this.connection;
+    }
+}
+//# sourceMappingURL=wallet.js.map

package/dist/solana/wallet.js.map

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

package/dist/solana/x402.d.ts

@@ -0,0 +1,69 @@
+import type { SolanaX402PaymentProof, SolanaX402Requirements } from './types.js';
+import { SOLANA_USDC_MINT, SOLANA_USDC_DEVNET_MINT } from './types.js';
+import { SolanaWallet } from './wallet.js';
+/** Supported Solana x402 networks */
+export type SolanaX402Network = 'solana:mainnet' | 'solana:devnet';
+/** Default USDC mint per network */
+export declare const SOLANA_NETWORK_USDC: Record<SolanaX402Network, string>;
+/**
+ * SolanaX402Client — handles x402 payment flows on Solana.
+ *
+ * Flow:
+ *   1. Receive x402 PaymentRequired with network='solana:mainnet'
+ *   2. Build an SPL token transfer transaction (USDC → payTo)
+ *   3. Sign with agent's Ed25519 keypair
+ *   4. Return base64-serialized signed tx as payment proof
+ *   5. Optionally broadcast and return tx signature
+ *
+ * Non-custodial: private key never leaves the SolanaWallet instance.
+ */
+export declare class SolanaX402Client {
+    private wallet;
+    constructor(wallet: SolanaWallet);
+    /**
+     * Determine if this client can handle a given x402 network string.
+     */
+    canHandle(network: string): network is SolanaX402Network;
+    /**
+     * Build and sign a USDC SPL token payment for x402.
+     *
+     * Does NOT broadcast — returns signed tx as base64 for the caller to submit.
+     * This matches the x402 pattern where the client returns a payment proof
+     * that the facilitator can verify and then settle.
+     *
+     * @param requirements - Payment requirements from the x402 402 response
+     * @returns SolanaX402PaymentProof with signed transaction
+     */
+    buildPaymentProof(requirements: SolanaX402Requirements): Promise<SolanaX402PaymentProof>;
+    /**
+     * Build payment proof AND broadcast the transaction to Solana.
+     * Returns the proof enriched with the on-chain tx signature.
+     *
+     * @param requirements - Payment requirements from 402 response
+     * @returns SolanaX402PaymentProof with txSignature populated
+     */
+    pay(requirements: SolanaX402Requirements): Promise<SolanaX402PaymentProof>;
+    /**
+     * Validate that payment requirements are acceptable before paying.
+     *
+     * Checks:
+     *   - Network is Solana (mainnet or devnet)
+     *   - Asset is USDC or native SOL
+     *   - Amount > 0
+     *   - maxTimeoutSeconds is reasonable
+     */
+    validateRequirements(requirements: SolanaX402Requirements, options?: {
+        allowedMints?: string[];
+        maxAmount?: bigint;
+    }): {
+        valid: boolean;
+        reason?: string;
+    };
+}
+/**
+ * Factory: create a SolanaX402Client from a SolanaWallet.
+ */
+export declare function createSolanaX402Client(wallet: SolanaWallet): SolanaX402Client;
+export type { SolanaX402PaymentProof, SolanaX402Requirements };
+export { SOLANA_USDC_MINT, SOLANA_USDC_DEVNET_MINT };
+//# sourceMappingURL=x402.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"x402.d.ts","sourceRoot":"","sources":["../../src/solana/x402.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAmB,MAAM,YAAY,CAAC;AACxF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,qCAAqC;AACrC,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAEnE,oCAAoC;AACpC,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAGjE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAIhC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,IAAI,iBAAiB;IAIxD;;;;;;;;;OASG;IACG,iBAAiB,CACrB,YAAY,EAAE,sBAAsB,GACnC,OAAO,CAAC,sBAAsB,CAAC;IA4DlC;;;;;;OAMG;IACG,GAAG,CAAC,YAAY,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAahF;;;;;;;;OAQG;IACH,oBAAoB,CAClB,YAAY,EAAE,sBAAsB,EACpC,OAAO,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAC5D;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;CAsCvC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,CAE7E;AAGD,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,CAAC"}