spongewallet 0.1.0 → 0.1.5

package/README.md

@@ -1,10 +1,122 @@
 # spongewallet
 
-Thin CLI launcher for the SpongeWallet SDK.
+CLI for creating, claiming, and using Sponge agent wallets from the terminal.
+
+`spongewallet` is the terminal entrypoint for Sponge Wallet. It wraps the SDK CLI and exposes the common flows for onboarding, wallet operations, swaps, bridges, and paid API requests.
+
+## Install
+
+Run it directly:
+
+```bash
+npx spongewallet --help
+```
+
+Or install it:
+
+```bash
+npm install -g spongewallet
+```
+
+## Quickstart
+
+Create an agent wallet:
 
 ```bash
 npx spongewallet init
+```
+
+Restrict the later claim to one email:
+
+```bash
 npx spongewallet init --email alice@example.com
-npx spongewallet wallet balance
+```
+
+Claim a pending agent or log in with device flow:
+
+```bash
+npx spongewallet login
+```
+
+Inspect the current session:
+
+```bash
+npx spongewallet whoami
+```
+
+Print MCP config for Claude Code or Cursor:
+
+```bash
+npx spongewallet mcp print
+```
+
+## Core flow
+
+1. `init` creates an agent immediately, prints addresses and MCP config, and stores pending claim metadata locally.
+2. `login` claims that pending agent if claim metadata exists. Otherwise it falls back to normal device-flow authentication.
+3. Use top-level commands like `balance`, `send`, `history`, `tokens`, and `onramp` for day-to-day operations.
+
+## Common commands
+
+```bash
+# Session
+npx spongewallet init
+npx spongewallet login
+npx spongewallet whoami
+npx spongewallet logout
 npx spongewallet mcp print
+
+# Wallets and transfers
+npx spongewallet balance
+npx spongewallet send base 0xabc... USDC 10
+npx spongewallet history 20 --chain base
+
+# Transactions, swaps, and bridges
+npx spongewallet tx status base 0x123...
+npx spongewallet swap quote SOL USDC 1
+npx spongewallet swap tempo pathUSD USDC.e 1
+npx spongewallet bridge base solana USDC 25
+
+# Paid requests
+npx spongewallet pay x402 --url https://api.example.com/premium
+npx spongewallet pay mpp --url https://tempo.example.com/premium --chain tempo
 ```
+
+## Command groups
+
+- `init`, `login`, `logout`, `whoami`, `mcp`: session setup and authentication
+- `balance`, `send`, `history`, `tokens`, `search-tokens`, `onramp`, `tx`, `swap`, `bridge`, `pay`: balances, transfers, swaps, bridging, and payments
+- `keys`, `card`, `plan`, `trade`, `auth`: stored secrets and approval flows
+- `market`, `advanced`: venue-specific and low-level commands
+
+## Authentication
+
+By default, the CLI uses Sponge device-flow authentication. After login, credentials are stored at:
+
+```text
+~/.spongewallet/credentials.json
+```
+
+For non-interactive usage, set an API key:
+
+```bash
+export SPONGE_API_KEY=<agent-api-key>
+```
+
+## What It Wraps
+
+This package is a thin launcher around `@paysponge/sdk`. If you want the SDK and the CLI in one dependency, install:
+
+```bash
+npm install @paysponge/sdk
+```
+
+## Docs
+
+- CLI docs: https://docs.paysponge.com/cli
+- Authentication: https://docs.paysponge.com/authentication
+- Overview: https://docs.paysponge.com
+
+## Notes
+
+This is early access software. Command surface and flows may still change.

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "spongewallet",
-  "version": "0.1.0",
+  "version": "0.1.5",
   "type": "module",
   "description": "CLI launcher for SpongeWallet onboarding and MCP setup",
   "bin": {
-    "spongewallet": "./bin/spongewallet.js"
+    "spongewallet": "bin/spongewallet.js"
   },
   "files": [
     "bin",
     "README.md"
   ],
   "dependencies": {
-    "@paysponge/sdk": "^0.1.16"
+    "@paysponge/sdk": "^0.1.25"
   },
   "keywords": [
     "wallet",
@@ -20,5 +20,14 @@
     "mcp",
     "crypto"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "homepage": "https://docs.paysponge.com/cli",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/paysponge/sponge.git",
+    "directory": "mobwallet/packages/spongewallet-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/paysponge/sponge/issues"
+  }
 }