@paysponge/sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,383 @@
+import { type ConnectOptions, type Chain, type Balance, type TransferOptions, type SwapOptions, type TransactionResult, type TransactionStatus, type Agent, type CreateAgentOptions, type McpConfig } from "./types/schemas.js";
+/**
+ * SpongeWallet - The main SDK client for managing agent wallets
+ *
+ * @example
+ * ```typescript
+ * import { SpongeWallet } from '@spongewallet/sdk';
+ *
+ * // Connect (handles auth automatically)
+ * const wallet = await SpongeWallet.connect();
+ *
+ * // Get wallet addresses
+ * console.log(wallet.address('base'));    // 0x...
+ * console.log(wallet.address('solana'));  // 5x...
+ *
+ * // Check balances
+ * const balances = await wallet.getBalances();
+ *
+ * // Transfer tokens
+ * await wallet.transfer({
+ *   chain: 'base',
+ *   to: '0x...',
+ *   amount: '10',
+ *   currency: 'USDC',
+ * });
+ * ```
+ */
+export declare class SpongeWallet {
+    private readonly http;
+    private readonly agents;
+    private readonly wallets;
+    private readonly transactions;
+    private readonly publicTools;
+    private readonly agentId;
+    private readonly baseUrl;
+    private addressCache;
+    private constructor();
+    /**
+     * Connect to SpongeWallet
+     *
+     * This method handles everything:
+     * 1. Checks for cached credentials or environment variable
+     * 2. If none, starts OAuth Device Flow
+     * 3. Creates a default agent if needed
+     * 4. Returns a connected SpongeWallet instance
+     *
+     * @example
+     * ```typescript
+     * // Simple connect (uses default agent or creates one)
+     * const wallet = await SpongeWallet.connect();
+     *
+     * // Connect with options
+     * const wallet = await SpongeWallet.connect({
+     *   name: 'My Trading Bot',
+     *   testnet: true,
+     * });
+     *
+     * // Connect with existing API key
+     * const wallet = await SpongeWallet.connect({
+     *   apiKey: 'sponge_live_...',
+     * });
+     * ```
+     */
+    static connect(options?: ConnectOptions): Promise<SpongeWallet>;
+    /**
+     * Get wallet address for a specific chain
+     */
+    address(chain: Chain): string;
+    /**
+     * Get wallet address for a specific chain (async)
+     */
+    getAddress(chain: Chain): Promise<string | null>;
+    /**
+     * Get all wallet addresses
+     */
+    getAddresses(): Promise<Record<Chain, string>>;
+    /**
+     * Get balance for a specific chain
+     */
+    getBalance(chain: Chain): Promise<Balance>;
+    /**
+     * Get balances for all chains
+     */
+    getBalances(): Promise<Record<Chain, Balance>>;
+    /**
+     * Get detailed balances with per-token breakdown
+     */
+    getDetailedBalances(options?: {
+        chain?: Chain | "all";
+        allowedChains?: Chain[];
+        onlyUsdc?: boolean;
+    }): Promise<Record<string, {
+        address: string;
+        balances: {
+            amount: string;
+            token: string;
+            usdValue?: string | undefined;
+        }[];
+    }>>;
+    /**
+     * Transfer tokens
+     *
+     * @example
+     * ```typescript
+     * // Transfer USDC on Base
+     * const tx = await wallet.transfer({
+     *   chain: 'base',
+     *   to: '0x742d35Cc...',
+     *   amount: '10',
+     *   currency: 'USDC',
+     * });
+     * console.log(tx.txHash);
+     * ```
+     */
+    transfer(options: TransferOptions): Promise<TransactionResult>;
+    /**
+     * Transfer on EVM chains (allowlist + spending limits enforced)
+     */
+    evmTransfer(options: {
+        chain: "ethereum" | "base" | "sepolia" | "base-sepolia";
+        to: string;
+        amount: string;
+        currency: "ETH" | "USDC";
+    }): Promise<{
+        status: string;
+        transactionHash: string;
+        message?: string | undefined;
+        explorerUrl?: string | undefined;
+    }>;
+    /**
+     * Transfer on Solana (allowlist + spending limits enforced)
+     */
+    solanaTransfer(options: {
+        chain: "solana" | "solana-devnet";
+        to: string;
+        amount: string;
+        currency: "SOL" | "USDC";
+    }): Promise<{
+        status: string;
+        transactionHash: string;
+        message?: string | undefined;
+        explorerUrl?: string | undefined;
+    }>;
+    /**
+     * Swap tokens (Solana via Jupiter)
+     *
+     * @example
+     * ```typescript
+     * const tx = await wallet.swap({
+     *   chain: 'solana',
+     *   from: 'SOL',
+     *   to: 'USDC',
+     *   amount: '1',
+     * });
+     * ```
+     */
+    swap(options: SwapOptions): Promise<TransactionResult>;
+    /**
+     * Get transaction status
+     *
+     * @example
+     * ```typescript
+     * const status = await wallet.getTransactionStatus(txHash, 'base');
+     * console.log(status.status); // 'pending', 'confirmed', or 'failed'
+     * ```
+     */
+    getTransactionStatus(txHash: string, chain: Chain): Promise<TransactionStatus>;
+    /**
+     * Get transaction history
+     */
+    getTransactionHistory(options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        status: "unknown" | "pending" | "confirmed" | "failed";
+        txHash: string;
+        blockNumber: number | null;
+        confirmations: number | null;
+        errorMessage: string | null;
+    }[]>;
+    /**
+     * Get detailed transaction history with chain metadata
+     */
+    getTransactionHistoryDetailed(options?: {
+        limit?: number;
+        chain?: Chain;
+    }): Promise<{
+        transactions: {
+            value: string;
+            status: string;
+            chain: string;
+            to: string;
+            txHash: string | null;
+            from: string;
+            token: string;
+            direction: string;
+            timestamp: string;
+        }[];
+        total: number;
+        hasMore: boolean;
+    }>;
+    /**
+     * List all SPL tokens held by the Solana wallet
+     */
+    getSolanaTokens(chain: "solana" | "solana-devnet"): Promise<{
+        address: string;
+        tokens: {
+            symbol: string;
+            name: string;
+            balance: string;
+            decimals: number;
+            mint: string;
+            logoURI: string | null;
+            verified: boolean;
+        }[];
+    }>;
+    /**
+     * Search Jupiter token list on Solana
+     */
+    searchSolanaTokens(query: string, limit?: number): Promise<{
+        tokens: {
+            symbol: string;
+            name: string;
+            decimals: number;
+            mint: string;
+            logoURI: string | null;
+            verified: boolean;
+        }[];
+    }>;
+    /**
+     * Request funding from the owner (creates an approval request)
+     */
+    requestFunding(options: {
+        amount: string;
+        reason?: string;
+        chain?: Chain;
+        currency?: string;
+    }): Promise<{
+        message: string;
+        status: string;
+        success: boolean;
+        requestId: string;
+    }>;
+    /**
+     * Withdraw funds back to the owner's main wallet
+     */
+    withdrawToMainWallet(options: {
+        chain: Chain;
+        amount: string;
+        currency?: "native" | "USDC";
+    }): Promise<{
+        chainId: number;
+        amount: string;
+        txHash: string;
+        success: boolean;
+        toAddress: string;
+        explorerUrl?: string | undefined;
+    }>;
+    /**
+     * Call Sponge paid APIs via x402
+     */
+    sponge(request: Record<string, unknown>): Promise<{
+        status: "success" | "payment_required" | "error";
+        task: string;
+        provider: string;
+        summary?: string | undefined;
+        error?: string | undefined;
+        data?: unknown;
+        image_data?: string | undefined;
+        image_mime_type?: string | undefined;
+        payment?: {
+            decimals: number;
+            chain: string;
+            to: string;
+            amount: string;
+            token: string;
+            raw_amount: string;
+        } | undefined;
+        payment_made?: {
+            chain: string;
+            to: string;
+            amount: string;
+            token: string;
+            expiresAt: string;
+        } | undefined;
+        wallet_balance?: Record<string, {
+            address: string;
+            balances: {
+                amount: string;
+                token: string;
+                usdValue?: string | undefined;
+            }[];
+        }> | undefined;
+        next_step?: string | undefined;
+        api_error_details?: unknown;
+        receipt?: unknown;
+    }>;
+    /**
+     * Create an x402 payment payload
+     */
+    createX402Payment(options: {
+        chain: Chain;
+        to: string;
+        token?: string;
+        amount: string;
+        decimals?: number;
+        valid_for_seconds?: number;
+        resource_url?: string;
+        resource_description?: string;
+        fee_payer?: string;
+        http_method?: "GET" | "POST";
+    }): Promise<{
+        expiresAt: string;
+        paymentPayloadBase64: string;
+        paymentRequirements: {
+            scheme: "exact";
+            network: string;
+            maxAmountRequired: string;
+            asset: string;
+            payTo: string;
+        };
+        paymentPayload?: unknown;
+        headerName?: string | undefined;
+    }>;
+    /**
+     * Create a new agent
+     */
+    createAgent(options: CreateAgentOptions): Promise<Agent>;
+    /**
+     * Get all agents for this user
+     */
+    getAgents(): Promise<Agent[]>;
+    /**
+     * Get the current agent
+     */
+    getAgent(): Promise<Agent>;
+    /**
+     * Get MCP configuration for Claude Agent SDK
+     *
+     * @example
+     * ```typescript
+     * import { query } from '@anthropic-ai/claude-agent-sdk';
+     *
+     * const wallet = await SpongeWallet.connect();
+     *
+     * for await (const msg of query({
+     *   prompt: 'Check my balance',
+     *   options: {
+     *     mcpServers: {
+     *       wallet: wallet.mcp(),
+     *     },
+     *   },
+     * })) {
+     *   console.log(msg);
+     * }
+     * ```
+     */
+    mcp(): McpConfig;
+    /**
+     * Get direct tools for use with raw Anthropic SDK
+     *
+     * @example
+     * ```typescript
+     * const tools = wallet.tools();
+     *
+     * const response = await anthropic.messages.create({
+     *   model: 'claude-sonnet-4-20250514',
+     *   tools: tools.definitions,
+     *   messages: [{ role: 'user', content: 'Check balance' }],
+     * });
+     *
+     * if (response.stop_reason === 'tool_use') {
+     *   const result = await tools.execute(toolCall.name, toolCall.input);
+     * }
+     * ```
+     */
+    tools(): any;
+    /**
+     * Get the agent ID
+     */
+    getAgentId(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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