@paysponge/sdk 0.1.5 → 0.1.6

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/version.d.ts

@@ -1,2 +1,2 @@
-export declare const SDK_VERSION = "0.1.5";
+export declare const SDK_VERSION = "0.1.6";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const SDK_VERSION = "0.1.5";
+export const SDK_VERSION = "0.1.6";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paysponge/sdk",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "type": "module",
   "description": "SDK for spinning up wallets for AI agents with Claude Agent SDK integration",
   "main": "./dist/index.js",
@@ -15,7 +15,8 @@
     "spongewallet": "./dist/bin/cli.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "generate:types": "bunx openapi-typescript openapi.json -o src/types/generated.d.ts",
@@ -63,6 +64,6 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/spongewallet/sdk"
+    "url": "https://github.com/paysponge/spongewallet-sdk"
   }
 }