@paysponge/sdk 0.1.0

package/dist/tools/definitions.js

@@ -0,0 +1,330 @@
+/**
+ * Tool definitions for use with the Anthropic SDK
+ *
+ * These definitions follow the Anthropic tool schema format
+ */
+export const TOOL_DEFINITIONS = [
+    {
+        name: "get_balance",
+        description: "Get the balance of your wallet. Returns balances for native tokens and USDC across all supported chains.",
+        input_schema: {
+            type: "object",
+            properties: {
+                chain: {
+                    type: "string",
+                    enum: [
+                        "ethereum",
+                        "base",
+                        "sepolia",
+                        "base-sepolia",
+                        "tempo",
+                        "solana",
+                        "solana-devnet",
+                    ],
+                    description: "Optional: Specific chain to check balance for. If not provided, returns balances for all chains.",
+                },
+                allowedChains: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Optional: Restrict balance results to these chains (e.g., ['base','solana'])",
+                },
+                onlyUsdc: {
+                    type: "boolean",
+                    description: "Optional: Only return USDC balances",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "evm_transfer",
+        description: "Transfer ETH or USDC on Ethereum, Base, or their testnets. Supports native ETH and USDC transfers.",
+        input_schema: {
+            type: "object",
+            properties: {
+                chain: {
+                    type: "string",
+                    enum: ["ethereum", "base", "sepolia", "base-sepolia"],
+                    description: "The chain to transfer on",
+                },
+                to: {
+                    type: "string",
+                    description: "The recipient address (0x...)",
+                },
+                amount: {
+                    type: "string",
+                    description: "The amount to transfer (e.g., '0.1' for 0.1 ETH or '100' for 100 USDC)",
+                },
+                currency: {
+                    type: "string",
+                    enum: ["ETH", "USDC"],
+                    description: "The currency to transfer",
+                },
+            },
+            required: ["chain", "to", "amount", "currency"],
+        },
+    },
+    {
+        name: "solana_transfer",
+        description: "Transfer SOL or USDC on Solana mainnet or devnet. Supports native SOL and USDC transfers.",
+        input_schema: {
+            type: "object",
+            properties: {
+                chain: {
+                    type: "string",
+                    enum: ["solana", "solana-devnet"],
+                    description: "The Solana network to use",
+                },
+                to: {
+                    type: "string",
+                    description: "The recipient address",
+                },
+                amount: {
+                    type: "string",
+                    description: "The amount to transfer",
+                },
+                currency: {
+                    type: "string",
+                    enum: ["SOL", "USDC"],
+                    description: "The currency to transfer",
+                },
+            },
+            required: ["chain", "to", "amount", "currency"],
+        },
+    },
+    {
+        name: "solana_swap",
+        description: "Swap tokens on Solana using Jupiter aggregator. Finds the best route and executes the swap.",
+        input_schema: {
+            type: "object",
+            properties: {
+                chain: {
+                    type: "string",
+                    enum: ["solana", "solana-devnet"],
+                    description: "The Solana network to use",
+                },
+                inputToken: {
+                    type: "string",
+                    description: "The token to swap from (symbol like 'SOL', 'USDC', or token address)",
+                },
+                outputToken: {
+                    type: "string",
+                    description: "The token to swap to (symbol like 'SOL', 'USDC', or token address)",
+                },
+                amount: {
+                    type: "string",
+                    description: "The amount of input token to swap",
+                },
+                slippageBps: {
+                    type: "number",
+                    description: "Slippage tolerance in basis points (default: 50 = 0.5%)",
+                },
+            },
+            required: ["chain", "inputToken", "outputToken", "amount"],
+        },
+    },
+    {
+        name: "get_solana_tokens",
+        description: "List all SPL tokens held by the agent's Solana wallet, with balances and metadata.",
+        input_schema: {
+            type: "object",
+            properties: {
+                chain: {
+                    type: "string",
+                    enum: ["solana", "solana-devnet"],
+                    description: "The Solana network to use",
+                },
+            },
+            required: ["chain"],
+        },
+    },
+    {
+        name: "search_solana_tokens",
+        description: "Search the Jupiter token list by symbol or name.",
+        input_schema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query (symbol or name)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results (default 10, max 20)",
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "get_transaction_status",
+        description: "Check the status of a transaction by its hash/signature.",
+        input_schema: {
+            type: "object",
+            properties: {
+                txHash: {
+                    type: "string",
+                    description: "The transaction hash (EVM) or signature (Solana)",
+                },
+                chain: {
+                    type: "string",
+                    enum: [
+                        "ethereum",
+                        "base",
+                        "sepolia",
+                        "base-sepolia",
+                        "tempo",
+                        "solana",
+                        "solana-devnet",
+                    ],
+                    description: "Chain for the transaction",
+                },
+            },
+            required: ["txHash", "chain"],
+        },
+    },
+    {
+        name: "get_transaction_history",
+        description: "Get recent transaction history for this agent's wallets.",
+        input_schema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "number",
+                    description: "Maximum number of transactions to return (default: 50)",
+                },
+                chain: {
+                    type: "string",
+                    description: "Optional: filter by chain",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "request_funding",
+        description: "Request funding from the owner (creates an approval request).",
+        input_schema: {
+            type: "object",
+            properties: {
+                amount: {
+                    type: "string",
+                    description: "Amount to request",
+                },
+                reason: {
+                    type: "string",
+                    description: "Reason for the request",
+                },
+                chain: {
+                    type: "string",
+                    description: "Chain to request on (default: tempo)",
+                },
+                currency: {
+                    type: "string",
+                    description: "Currency (pathUSD, USDC, ETH, SOL)",
+                },
+            },
+            required: ["amount"],
+        },
+    },
+    {
+        name: "withdraw_to_main_wallet",
+        description: "Withdraw funds back to the owner's main wallet.",
+        input_schema: {
+            type: "object",
+            properties: {
+                chain: {
+                    type: "string",
+                    enum: [
+                        "ethereum",
+                        "base",
+                        "sepolia",
+                        "base-sepolia",
+                        "tempo",
+                        "solana",
+                        "solana-devnet",
+                    ],
+                    description: "Chain to withdraw from",
+                },
+                amount: {
+                    type: "string",
+                    description: "Amount to withdraw",
+                },
+                currency: {
+                    type: "string",
+                    enum: ["native", "USDC"],
+                    description: "Token to withdraw (default: native)",
+                },
+            },
+            required: ["chain", "amount"],
+        },
+    },
+    // x402 paid API tools - temporarily disabled
+    // {
+    //   name: "sponge",
+    //   description:
+    //     "Call paid APIs via x402 (search, image, predict, crawl, parse, prospect, llm).",
+    //   input_schema: {
+    //     type: "object",
+    //     properties: {
+    //       task: {
+    //         type: "string",
+    //         description: "Task name (search, image, predict, crawl, parse, prospect, llm)",
+    //       },
+    //     },
+    //     required: ["task"],
+    //   },
+    // },
+    // {
+    //   name: "create_x402_payment",
+    //   description: "Create a signed x402 payment payload.",
+    //   input_schema: {
+    //     type: "object",
+    //     properties: {
+    //       chain: {
+    //         type: "string",
+    //         description: "Chain to pay on (e.g., base, solana, tempo)",
+    //       },
+    //       to: {
+    //         type: "string",
+    //         description: "Recipient address from 402 response",
+    //       },
+    //       token: {
+    //         type: "string",
+    //         description: "Token address or mint (optional)",
+    //       },
+    //       amount: {
+    //         type: "string",
+    //         description: "Amount to pay",
+    //       },
+    //       decimals: {
+    //         type: "number",
+    //         description: "Token decimals (optional)",
+    //       },
+    //       valid_for_seconds: {
+    //         type: "number",
+    //         description: "Payment validity window in seconds",
+    //       },
+    //       resource_url: {
+    //         type: "string",
+    //         description: "Resource URL for x402 preflight or metadata",
+    //       },
+    //       resource_description: {
+    //         type: "string",
+    //         description: "Resource description",
+    //       },
+    //       fee_payer: {
+    //         type: "string",
+    //         description: "Solana fee payer from 402 response (optional)",
+    //       },
+    //       http_method: {
+    //         type: "string",
+    //         enum: ["GET", "POST"],
+    //         description: "HTTP method used for 402 preflight (default: GET)",
+    //       },
+    //     },
+    //     required: ["chain", "to", "amount"],
+    //   },
+    // },
+];
+//# sourceMappingURL=definitions.js.map

package/dist/tools/definitions.js.map

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

package/dist/tools/executor.d.ts

@@ -0,0 +1,56 @@
+import type { HttpClient } from "../api/http.js";
+import type { ToolResult } from "../types/schemas.js";
+import { type ToolDefinition } from "./definitions.js";
+/**
+ * Tool executor for use with the Anthropic SDK
+ *
+ * Provides tool definitions and an execute method to run tools
+ */
+export declare class ToolExecutor {
+    private readonly http;
+    private readonly agentId;
+    constructor(http: HttpClient, agentId: string);
+    /**
+     * Get tool definitions for use with Anthropic SDK
+     */
+    get definitions(): ToolDefinition[];
+    /**
+     * Execute a tool by name
+     *
+     * @param name - Tool name
+     * @param input - Tool input
+     * @returns Tool result
+     *
+     * @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' }],
+     * });
+     *
+     * for (const block of response.content) {
+     *   if (block.type === 'tool_use') {
+     *     const result = await tools.execute(block.name, block.input);
+     *     console.log(result);
+     *   }
+     * }
+     * ```
+     */
+    execute(name: string, input: unknown): Promise<ToolResult>;
+    /**
+     * Call the MCP tool endpoint
+     */
+    private callTool;
+}
+/**
+ * Create a tool executor for use with the Anthropic SDK
+ *
+ * @param http - HTTP client instance
+ * @param agentId - Agent ID
+ * @returns Tool executor with definitions and execute method
+ */
+export declare function createTools(http: HttpClient, agentId: string): ToolExecutor;
+//# sourceMappingURL=executor.d.ts.map

package/dist/tools/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEzE;;;;GAIG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM;IAGlC;;OAEG;IACH,IAAI,WAAW,IAAI,cAAc,EAAE,CAElC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAehE;;OAEG;YACW,QAAQ;CA2GvB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAE3E"}

package/dist/tools/executor.js

@@ -0,0 +1,182 @@
+import { z } from "zod";
+import { TOOL_DEFINITIONS } from "./definitions.js";
+/**
+ * Tool executor for use with the Anthropic SDK
+ *
+ * Provides tool definitions and an execute method to run tools
+ */
+export class ToolExecutor {
+    http;
+    agentId;
+    constructor(http, agentId) {
+        this.http = http;
+        this.agentId = agentId;
+    }
+    /**
+     * Get tool definitions for use with Anthropic SDK
+     */
+    get definitions() {
+        return TOOL_DEFINITIONS;
+    }
+    /**
+     * Execute a tool by name
+     *
+     * @param name - Tool name
+     * @param input - Tool input
+     * @returns Tool result
+     *
+     * @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' }],
+     * });
+     *
+     * for (const block of response.content) {
+     *   if (block.type === 'tool_use') {
+     *     const result = await tools.execute(block.name, block.input);
+     *     console.log(result);
+     *   }
+     * }
+     * ```
+     */
+    async execute(name, input) {
+        try {
+            const result = await this.callTool(name, input);
+            return {
+                status: "success",
+                data: result,
+            };
+        }
+        catch (error) {
+            return {
+                status: "error",
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Call the MCP tool endpoint
+     */
+    async callTool(name, input) {
+        // Validate tool name
+        const tool = TOOL_DEFINITIONS.find((t) => t.name === name);
+        if (!tool) {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+        const args = z.record(z.unknown()).parse(input ?? {});
+        switch (name) {
+            case "get_balance": {
+                const allowedChains = Array.isArray(args.allowedChains)
+                    ? args.allowedChains.map(String).join(",")
+                    : typeof args.allowedChains === "string"
+                        ? args.allowedChains
+                        : undefined;
+                const params = {
+                    chain: args.chain ?? "all",
+                };
+                if (allowedChains)
+                    params.allowedChains = allowedChains;
+                if (args.onlyUsdc)
+                    params.onlyUsdc = "true";
+                return this.http.get("/api/balances", params);
+            }
+            case "evm_transfer":
+                return this.http.post("/api/transfers/evm", {
+                    chain: args.chain,
+                    to: args.to,
+                    amount: args.amount,
+                    currency: args.currency,
+                });
+            case "solana_transfer":
+                return this.http.post("/api/transfers/solana", {
+                    chain: args.chain,
+                    to: args.to,
+                    amount: args.amount,
+                    currency: args.currency,
+                });
+            case "solana_swap":
+                return this.http.post("/api/transactions/swap", {
+                    chain: args.chain,
+                    inputToken: args.inputToken ?? args.input_token,
+                    outputToken: args.outputToken ?? args.output_token,
+                    amount: args.amount,
+                    slippageBps: args.slippageBps ?? args.slippage_bps,
+                });
+            case "get_solana_tokens":
+                return this.http.get("/api/solana/tokens", {
+                    chain: String(args.chain ?? ""),
+                });
+            case "search_solana_tokens": {
+                const searchParams = {
+                    query: String(args.query ?? ""),
+                };
+                if (args.limit !== undefined)
+                    searchParams.limit = String(args.limit);
+                return this.http.get("/api/solana/tokens/search", searchParams);
+            }
+            case "get_transaction_status": {
+                const txHash = (args.txHash ?? args.transaction_hash);
+                if (!txHash) {
+                    throw new Error("txHash is required");
+                }
+                if (!args.chain) {
+                    throw new Error("chain is required");
+                }
+                return this.http.get(`/api/transactions/status/${encodeURIComponent(txHash)}`, { chain: String(args.chain) });
+            }
+            case "get_transaction_history": {
+                const historyParams = {};
+                if (args.limit !== undefined)
+                    historyParams.limit = String(args.limit);
+                if (args.chain)
+                    historyParams.chain = String(args.chain);
+                return this.http.get("/api/transactions/history", historyParams);
+            }
+            case "request_funding":
+                return this.http.post("/api/funding-requests", {
+                    amount: args.amount,
+                    reason: args.reason,
+                    chain: args.chain,
+                    currency: args.currency,
+                });
+            case "withdraw_to_main_wallet":
+                return this.http.post("/api/wallets/withdraw-to-main", {
+                    chain: args.chain,
+                    amount: args.amount,
+                    currency: args.currency,
+                });
+            case "sponge":
+                return this.http.post("/api/sponge", args);
+            case "create_x402_payment":
+                return this.http.post("/api/x402/payments", {
+                    chain: args.chain,
+                    to: args.to,
+                    token: args.token,
+                    amount: args.amount,
+                    decimals: args.decimals,
+                    valid_for_seconds: args.valid_for_seconds,
+                    resource_url: args.resource_url,
+                    resource_description: args.resource_description,
+                    fee_payer: args.fee_payer,
+                    http_method: args.http_method,
+                });
+            default:
+                throw new Error(`Tool not implemented: ${name}`);
+        }
+    }
+}
+/**
+ * Create a tool executor for use with the Anthropic SDK
+ *
+ * @param http - HTTP client instance
+ * @param agentId - Agent ID
+ * @returns Tool executor with definitions and execute method
+ */
+export function createTools(http, agentId) {
+    return new ToolExecutor(http, agentId);
+}
+//# sourceMappingURL=executor.js.map

package/dist/tools/executor.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./definitions.js";
+export * from "./executor.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,3 @@
+export * from "./definitions.js";
+export * from "./executor.js";
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./schemas.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export * from "./schemas.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

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