@paysponge/sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sponge
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,138 @@
+# SpongeWallet SDK
+
+SDK for creating and managing wallets for AI agents with Claude Agent SDK integration.
+
+## Installation
+
+```bash
+npm install @paysponge/sdk
+# or
+bun add @paysponge/sdk
+```
+
+## Quick Start
+
+```typescript
+import { SpongeWallet } from "@paysponge/sdk";
+
+// Connect (handles auth automatically via browser)
+const wallet = await SpongeWallet.connect();
+
+// Get addresses
+const addresses = await wallet.getAddresses();
+console.log(addresses.base);    // 0x...
+console.log(addresses.solana);  // 5x...
+
+// Check balances
+const balances = await wallet.getBalances();
+
+// Transfer tokens
+await wallet.transfer({
+  chain: "base",
+  to: "0x...",
+  amount: "10",
+  currency: "USDC",
+});
+```
+
+## Authentication
+
+### Device Flow (Browser)
+
+On first run, `connect()` opens your browser for login. After approval, credentials are cached at `~/.spongewallet/credentials.json`.
+
+### API Key
+
+```typescript
+const wallet = await SpongeWallet.connect({
+  apiKey: "sponge_test_...",
+});
+```
+
+Or via environment variable:
+
+```bash
+SPONGE_API_KEY=sponge_test_xxx node my-bot.js
+```
+
+### Master Keys (Programmatic Agent Creation)
+
+```typescript
+import { SpongeAdmin } from "@paysponge/sdk";
+
+const admin = new SpongeAdmin({ apiKey: "sponge_master_..." });
+
+// Create agents programmatically
+const { agent, apiKey } = await admin.createAgent({ name: "bot-1" });
+
+// Connect to the agent's wallet
+const wallet = await SpongeWallet.connect({ apiKey });
+```
+
+## Claude Agent SDK Integration
+
+```typescript
+import { query } from "@anthropic-ai/claude-agent-sdk";
+import { SpongeWallet } from "@paysponge/sdk";
+
+const wallet = await SpongeWallet.connect();
+
+for await (const msg of query({
+  prompt: "Check my wallet balance and transfer 5 USDC to 0x...",
+  options: {
+    mcpServers: {
+      wallet: wallet.mcp(),
+    },
+  },
+})) {
+  console.log(msg);
+}
+```
+
+## Supported Chains
+
+- **EVM**: Ethereum, Base, Sepolia, Base Sepolia, Tempo
+- **Solana**: Mainnet, Devnet
+
+## Features
+
+- Multi-chain wallet management (EVM + Solana)
+- Token transfers and swaps (Jupiter on Solana)
+- MCP server for Claude Agent SDK
+- Anthropic SDK tool definitions
+- Spending limits and allowlists
+- x402 payment protocol support
+
+## Documentation
+
+- [Getting Started](./docs/getting-started.md)
+- [Authentication](./docs/authentication.md)
+- [Wallets & Transfers](./docs/wallets-and-transfers.md)
+- [Claude Integration](./docs/claude-integration.md)
+- [Master Keys](./docs/master-keys.md)
+- [API Reference](./docs/api-reference.md)
+
+## CLI
+
+```bash
+# Login via browser
+npx spongewallet login
+
+# Check current session
+npx spongewallet whoami
+
+# Logout
+npx spongewallet logout
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `SPONGE_API_KEY` | Agent API key (skips device flow) |
+| `SPONGE_MASTER_KEY` | Master key for programmatic agent creation |
+| `SPONGE_API_URL` | Custom API URL |
+
+## License
+
+MIT

package/dist/admin.d.ts

@@ -0,0 +1,81 @@
+import { type Agent, type CreateAgentOptions } from "./types/schemas.js";
+import { SpongeWallet } from "./client.js";
+/**
+ * SpongeAdmin - Management client for programmatic agent creation
+ *
+ * Use a master API key to create and manage agents without browser-based auth.
+ * Generate one via `SpongeAdmin.connect()` (device flow) or the dashboard.
+ *
+ * @example
+ * ```typescript
+ * import { SpongeAdmin } from '@spongewallet/sdk';
+ *
+ * // First time: authenticate via browser to get a master key
+ * const admin = await SpongeAdmin.connect();
+ *
+ * // Or use an existing master key
+ * const admin = new SpongeAdmin({ apiKey: 'sponge_master_...' });
+ *
+ * // Create a new agent with wallets
+ * const { agent, apiKey } = await admin.createAgent({ name: 'trading-bot-1' });
+ *
+ * // Connect to the agent's wallet
+ * const wallet = await SpongeWallet.connect({ apiKey });
+ * ```
+ */
+export declare class SpongeAdmin {
+    private readonly http;
+    private readonly agents;
+    private readonly baseUrl;
+    /**
+     * Authenticate via device flow and get a master API key
+     *
+     * Opens a browser for login, then returns a SpongeAdmin instance
+     * with a master key that can create agents programmatically.
+     *
+     * @example
+     * ```typescript
+     * const admin = await SpongeAdmin.connect();
+     * const { agent, apiKey } = await admin.createAgent({ name: 'my-bot' });
+     * ```
+     */
+    static connect(options?: {
+        baseUrl?: string;
+        noBrowser?: boolean;
+    }): Promise<SpongeAdmin>;
+    constructor(options: {
+        apiKey: string;
+        baseUrl?: string;
+    });
+    /**
+     * Create a new agent with wallets
+     *
+     * Returns the agent and its API key. The API key can be used
+     * with `SpongeWallet.connect()` to interact with the agent's wallets.
+     */
+    createAgent(options: CreateAgentOptions): Promise<{
+        agent: Agent;
+        apiKey: string;
+    }>;
+    /**
+     * List all agents for this user
+     */
+    listAgents(): Promise<Agent[]>;
+    /**
+     * Delete an agent
+     */
+    deleteAgent(agentId: string): Promise<void>;
+    /**
+     * Create a new agent and return a connected SpongeWallet instance
+     *
+     * Convenience method that combines `createAgent` + `SpongeWallet.connect`.
+     *
+     * @example
+     * ```typescript
+     * const wallet = await admin.createWallet({ name: 'my-agent' });
+     * const balances = await wallet.getBalances();
+     * ```
+     */
+    createWallet(options: CreateAgentOptions): Promise<SpongeWallet>;
+}
+//# sourceMappingURL=admin.d.ts.map

package/dist/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,KAAK,EACV,KAAK,kBAAkB,EAExB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC;;;;;;;;;;;OAWG;WACU,OAAO,CAAC,OAAO,GAAE;QAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;KAChB,GAAG,OAAO,CAAC,WAAW,CAAC;gBAejB,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IASzD;;;;;OAKG;IACG,WAAW,CACf,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAK5C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAIpC;;OAEG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;;;;;;;;;OAUG;IACG,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;CAQvE"}

package/dist/admin.js

@@ -0,0 +1,108 @@
+import { CreateAgentOptionsSchema, } from "./types/schemas.js";
+import { HttpClient } from "./api/http.js";
+import { AgentsApi } from "./api/agents.js";
+import { SpongeWallet } from "./client.js";
+import { deviceFlowAuth } from "./auth/device-flow.js";
+const DEFAULT_BASE_URL = "https://api.wallet.paysponge.com";
+/**
+ * SpongeAdmin - Management client for programmatic agent creation
+ *
+ * Use a master API key to create and manage agents without browser-based auth.
+ * Generate one via `SpongeAdmin.connect()` (device flow) or the dashboard.
+ *
+ * @example
+ * ```typescript
+ * import { SpongeAdmin } from '@spongewallet/sdk';
+ *
+ * // First time: authenticate via browser to get a master key
+ * const admin = await SpongeAdmin.connect();
+ *
+ * // Or use an existing master key
+ * const admin = new SpongeAdmin({ apiKey: 'sponge_master_...' });
+ *
+ * // Create a new agent with wallets
+ * const { agent, apiKey } = await admin.createAgent({ name: 'trading-bot-1' });
+ *
+ * // Connect to the agent's wallet
+ * const wallet = await SpongeWallet.connect({ apiKey });
+ * ```
+ */
+export class SpongeAdmin {
+    http;
+    agents;
+    baseUrl;
+    /**
+     * Authenticate via device flow and get a master API key
+     *
+     * Opens a browser for login, then returns a SpongeAdmin instance
+     * with a master key that can create agents programmatically.
+     *
+     * @example
+     * ```typescript
+     * const admin = await SpongeAdmin.connect();
+     * const { agent, apiKey } = await admin.createAgent({ name: 'my-bot' });
+     * ```
+     */
+    static async connect(options = {}) {
+        const baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        const tokenResponse = await deviceFlowAuth({
+            baseUrl,
+            noBrowser: options.noBrowser,
+            keyType: "master",
+        });
+        return new SpongeAdmin({
+            apiKey: tokenResponse.apiKey,
+            baseUrl,
+        });
+    }
+    constructor(options) {
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.http = new HttpClient({
+            baseUrl: this.baseUrl,
+            apiKey: options.apiKey,
+        });
+        this.agents = new AgentsApi(this.http);
+    }
+    /**
+     * Create a new agent with wallets
+     *
+     * Returns the agent and its API key. The API key can be used
+     * with `SpongeWallet.connect()` to interact with the agent's wallets.
+     */
+    async createAgent(options) {
+        const validated = CreateAgentOptionsSchema.parse(options);
+        return this.agents.create(validated);
+    }
+    /**
+     * List all agents for this user
+     */
+    async listAgents() {
+        return this.agents.list();
+    }
+    /**
+     * Delete an agent
+     */
+    async deleteAgent(agentId) {
+        return this.agents.delete(agentId);
+    }
+    /**
+     * Create a new agent and return a connected SpongeWallet instance
+     *
+     * Convenience method that combines `createAgent` + `SpongeWallet.connect`.
+     *
+     * @example
+     * ```typescript
+     * const wallet = await admin.createWallet({ name: 'my-agent' });
+     * const balances = await wallet.getBalances();
+     * ```
+     */
+    async createWallet(options) {
+        const { apiKey, agent } = await this.createAgent(options);
+        return SpongeWallet.connect({
+            apiKey,
+            agentId: agent.id,
+            baseUrl: this.baseUrl !== DEFAULT_BASE_URL ? this.baseUrl : undefined,
+        });
+    }
+}
+//# sourceMappingURL=admin.js.map

package/dist/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,MAAM,gBAAgB,GAAG,kCAAkC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,OAAO,WAAW;IACL,IAAI,CAAa;IACjB,MAAM,CAAY;IAClB,OAAO,CAAS;IAEjC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,UAGjB,EAAE;QACJ,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;QAEpD,MAAM,aAAa,GAAG,MAAM,cAAc,CAAC;YACzC,OAAO;YACP,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QAEH,OAAO,IAAI,WAAW,CAAC;YACrB,MAAM,EAAE,aAAa,CAAC,MAAM;YAC5B,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,YAAY,OAA6C;QACvD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,gBAAgB,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,WAAW,CACf,OAA2B;QAE3B,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,OAAe;QAC/B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,YAAY,CAAC,OAA2B;QAC5C,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC1D,OAAO,YAAY,CAAC,OAAO,CAAC;YAC1B,MAAM;YACN,OAAO,EAAE,KAAK,CAAC,EAAE;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO,KAAK,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;SACtE,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/api/agents.d.ts

@@ -0,0 +1,37 @@
+import { type Agent, type CreateAgentOptions } from "../types/schemas.js";
+import type { HttpClient } from "./http.js";
+export declare class AgentsApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Create a new agent
+     */
+    create(options: CreateAgentOptions): Promise<{
+        agent: Agent;
+        apiKey: string;
+    }>;
+    /**
+     * List all agents for the current user
+     * Note: This endpoint requires Privy auth, not API key auth
+     */
+    list(): Promise<Agent[]>;
+    /**
+     * Get a specific agent by ID
+     * Note: This endpoint requires Privy auth, not API key auth
+     */
+    get(agentId: string): Promise<Agent>;
+    /**
+     * Get the current agent (authenticated via API key)
+     * This endpoint returns the agent associated with the current API key
+     */
+    getCurrent(): Promise<Agent>;
+    /**
+     * Update an agent
+     */
+    update(agentId: string, updates: Partial<CreateAgentOptions>): Promise<Agent>;
+    /**
+     * Delete an agent
+     */
+    delete(agentId: string): Promise<void>;
+}
+//# sourceMappingURL=agents.d.ts.map

package/dist/api/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/api/agents.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,KAAK,EACV,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAQ5C,qBAAa,SAAS;IACR,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAY5C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAK9B;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAK1C;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;IAKlC;;OAEG;IACG,MAAM,CACV,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,GACnC,OAAO,CAAC,KAAK,CAAC;IAQjB;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7C"}

package/dist/api/agents.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+import { AgentSchema, CreateAgentOptionsSchema, } from "../types/schemas.js";
+// Response from creating an agent (includes API key)
+const CreateAgentResponseSchema = z.object({
+    agent: AgentSchema,
+    mcpApiKey: z.string(),
+});
+export class AgentsApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Create a new agent
+     */
+    async create(options) {
+        const validated = CreateAgentOptionsSchema.parse(options);
+        const response = await this.http.post("/api/agents", validated);
+        const parsed = CreateAgentResponseSchema.parse(response);
+        return {
+            agent: parsed.agent,
+            apiKey: parsed.mcpApiKey,
+        };
+    }
+    /**
+     * List all agents for the current user
+     * Note: This endpoint requires Privy auth, not API key auth
+     */
+    async list() {
+        const response = await this.http.get("/api/agents");
+        return z.array(AgentSchema).parse(response);
+    }
+    /**
+     * Get a specific agent by ID
+     * Note: This endpoint requires Privy auth, not API key auth
+     */
+    async get(agentId) {
+        const response = await this.http.get(`/api/agents/${agentId}`);
+        return AgentSchema.parse(response);
+    }
+    /**
+     * Get the current agent (authenticated via API key)
+     * This endpoint returns the agent associated with the current API key
+     */
+    async getCurrent() {
+        const response = await this.http.get("/api/agents/me");
+        return AgentSchema.parse(response);
+    }
+    /**
+     * Update an agent
+     */
+    async update(agentId, updates) {
+        const response = await this.http.put(`/api/agents/${agentId}`, updates);
+        return AgentSchema.parse(response);
+    }
+    /**
+     * Delete an agent
+     */
+    async delete(agentId) {
+        await this.http.delete(`/api/agents/${agentId}`);
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/api/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../../src/api/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,WAAW,EACX,wBAAwB,GAGzB,MAAM,qBAAqB,CAAC;AAG7B,qDAAqD;AACrD,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,KAAK,EAAE,WAAW;IAClB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAA2B;QAE3B,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAE1D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAU,aAAa,EAAE,SAAS,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEzD,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAY,aAAa,CAAC,CAAC;QAC/D,OAAO,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAU,eAAe,OAAO,EAAE,CAAC,CAAC;QACxE,OAAO,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAU,gBAAgB,CAAC,CAAC;QAChE,OAAO,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACV,OAAe,EACf,OAAoC;QAEpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAClC,eAAe,OAAO,EAAE,EACxB,OAAO,CACR,CAAC;QACF,OAAO,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe;QAC1B,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;CACF"}

package/dist/api/http.d.ts

@@ -0,0 +1,29 @@
+export interface HttpClientOptions {
+    baseUrl?: string;
+    apiKey: string;
+}
+export declare class SpongeApiError extends Error {
+    readonly statusCode: number;
+    readonly errorCode: string;
+    constructor(statusCode: number, errorCode: string, message: string);
+}
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(options: HttpClientOptions);
+    private get headers();
+    get<T>(path: string, params?: Record<string, string>): Promise<T>;
+    post<T>(path: string, body?: unknown): Promise<T>;
+    put<T>(path: string, body?: unknown): Promise<T>;
+    delete<T>(path: string): Promise<T>;
+    private handleResponse;
+    /**
+     * Get the base URL (for MCP config)
+     */
+    getBaseUrl(): string;
+    /**
+     * Get the API key (for MCP config)
+     */
+    getApiKey(): string;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/api/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/api/http.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,cAAe,SAAQ,KAAK;aAErB,UAAU,EAAE,MAAM;aAClB,SAAS,EAAE,MAAM;gBADjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjC,OAAO,EAAE,MAAM;CAKlB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,EAAE,iBAAiB;IAKtC,OAAO,KAAK,OAAO,GAKlB;IAEK,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBjE,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAYjD,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAYhD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAW3B,cAAc;IA6B5B;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,SAAS,IAAI,MAAM;CAGpB"}

package/dist/api/http.js

@@ -0,0 +1,101 @@
+import { ApiErrorSchema } from "../types/schemas.js";
+const DEFAULT_BASE_URL = "https://api.wallet.paysponge.com";
+export class SpongeApiError extends Error {
+    statusCode;
+    errorCode;
+    constructor(statusCode, errorCode, message) {
+        super(message);
+        this.statusCode = statusCode;
+        this.errorCode = errorCode;
+        this.name = "SpongeApiError";
+    }
+}
+export class HttpClient {
+    baseUrl;
+    apiKey;
+    constructor(options) {
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.apiKey = options.apiKey;
+    }
+    get headers() {
+        return {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json",
+        };
+    }
+    async get(path, params) {
+        const url = new URL(path, this.baseUrl);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        const response = await fetch(url.toString(), {
+            method: "GET",
+            headers: this.headers,
+        });
+        return this.handleResponse(response);
+    }
+    async post(path, body) {
+        const url = new URL(path, this.baseUrl);
+        const response = await fetch(url.toString(), {
+            method: "POST",
+            headers: this.headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        return this.handleResponse(response);
+    }
+    async put(path, body) {
+        const url = new URL(path, this.baseUrl);
+        const response = await fetch(url.toString(), {
+            method: "PUT",
+            headers: this.headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        return this.handleResponse(response);
+    }
+    async delete(path) {
+        const url = new URL(path, this.baseUrl);
+        const response = await fetch(url.toString(), {
+            method: "DELETE",
+            headers: this.headers,
+        });
+        return this.handleResponse(response);
+    }
+    async handleResponse(response) {
+        if (!response.ok) {
+            let errorData = null;
+            try {
+                const json = await response.json();
+                const parsed = ApiErrorSchema.safeParse(json);
+                if (parsed.success) {
+                    errorData = parsed.data;
+                }
+            }
+            catch {
+                // Ignore JSON parse errors
+            }
+            throw new SpongeApiError(response.status, errorData?.error ?? "unknown_error", errorData?.message ?? `HTTP ${response.status}: ${response.statusText}`);
+        }
+        // Handle 204 No Content
+        if (response.status === 204) {
+            return undefined;
+        }
+        return response.json();
+    }
+    /**
+     * Get the base URL (for MCP config)
+     */
+    getBaseUrl() {
+        return this.baseUrl;
+    }
+    /**
+     * Get the API key (for MCP config)
+     */
+    getApiKey() {
+        return this.apiKey;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/api/http.js.map

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

package/dist/api/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./http.js";
+export * from "./agents.js";
+export * from "./wallets.js";
+export * from "./transactions.js";
+export * from "./public-tools.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}

package/dist/api/index.js

@@ -0,0 +1,6 @@
+export * from "./http.js";
+export * from "./agents.js";
+export * from "./wallets.js";
+export * from "./transactions.js";
+export * from "./public-tools.js";
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC"}