0.1.142 • Published 2d agoCLI

@paysponge/sdk

Licence

MIT

Version

0.1.142

Deps

Size

3.6 MB

Vulns

Weekly

2.6K

Summary Dependency Versions

Sponge SDK

Wallet and platform SDK for agent builders using Sponge.

Installation

npm install @paysponge/sdk
# or
bun add @paysponge/sdk

How Sponge Works

Sponge has two SDK clients:

SpongeWallet: the agent-scoped runtime client
SpongePlatform: the platform control-plane client for creating and managing many agents

Use SpongeWallet when one agent is acting with its own wallet. Use SpongePlatform when your backend needs to provision agents, rotate keys, or manage a fleet.

Agent Keys

Agent API keys are scoped to one agent. Use them with SpongeWallet.

You can get an agent-scoped API key in a few ways:

from the dashboard for an existing agent
npx spongewallet init to create an agent immediately and claim it later
SpongeWallet.connect() browser auth flow if you want browser auth and cached local credentials
SpongePlatform.createAgent() if your platform is provisioning agents server-side
POST /api/agents/register for self-registration flows

Example:

import { SpongeWallet } from "@paysponge/sdk";

const wallet = await SpongeWallet.connect({
  apiKey: process.env.SPONGE_API_KEY,
});

const addresses = await wallet.getAddresses();
console.log(addresses.base);
console.log(await wallet.getBalances());

Platform Keys

Platform API keys are account-level keys with the sponge_master_... prefix. Create them in Dashboard -> Settings -> Master API Keys, then use them with SpongePlatform.

Platform keys are for control-plane actions:

create agents
list and update agents
rotate agent API keys
manage many agents from one backend

Each agent still gets its own runtime API key. Your platform backend should use the platform key to provision agents, then store the returned agent key per agent and use that key at runtime.

Example:

import { SpongePlatform } from "@paysponge/sdk";

const platform = await SpongePlatform.connect({
  apiKey: process.env.SPONGE_MASTER_KEY,
});

const { agent, apiKey } = await platform.createAgent({
  name: "support-bot-1",
});

const wallet = await platform.connectAgent({ apiKey });
console.log(agent.id, await wallet.getAddresses());

Platforms

If you are building a product that manages hundreds of agents, the intended pattern is:

Your backend authenticates with SpongePlatform using a platform key.
It creates one Sponge agent per user, bot, or worker.
It stores the returned agent API key with your own internal record.
Each running agent connects with SpongeWallet using its own agent key.

That keeps provisioning and runtime separate:

platform key: create and administer agents
agent key: spend, swap, transfer, MCP, and tools for one agent

Authentication

Browser Auth Flow

On first run, connect() opens your browser for login. After approval, credentials are cached at ~/.spongewallet/credentials.json.

Agent API Key

const wallet = await SpongeWallet.connect({
  apiKey: "sponge_test_...",
});

Or via environment variable:

SPONGE_API_KEY=sponge_test_xxx node my-bot.js

Platform API Key

const platform = await SpongePlatform.connect({
  apiKey: process.env.SPONGE_MASTER_KEY,
});

Claude Agent SDK Integration

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);
}

Features

Multi-chain wallet management (EVM + Solana)
Token transfers and swaps (Jupiter on Solana)
Sponge Card, vaulted-card, and per-transaction virtual-card workflows
Bank onboarding, virtual accounts, external accounts, and USD transfers
MCP server for Claude Agent SDK
Anthropic SDK tool definitions
Spending limits and allowlists
x402 and MPP payment protocol support

CLI

# Create agent immediately, claim later
npx spongewallet init

# Agent-first with email for claim matching
npx spongewallet init --email alice@example.com

# Claim pending agent or do normal login if no pending claim exists
npx spongewallet login

# Replace the cached agent with a different login
npx spongewallet login --switch

# Curated wallet workflows
npx spongewallet balance
npx spongewallet send base 0xabc... USDC 10
npx spongewallet swap tempo pathUSD USDC.e 1
npx spongewallet tx status base 0x123...
npx spongewallet card status
npx spongewallet bank status
npx spongewallet bank send <wallet-id> <external-account-id> 100.00
npx spongewallet pay discover "web search"
npx spongewallet pay service <service-id>
npx spongewallet market polymarket search "Sixers Celtics"
npx spongewallet market polymarket order nba-phi-bos-2026-05-02 yes buy 3 --price 0.40

# Raw tool commands remain available under "advanced"
npx spongewallet advanced get-balance --chain base

# Check current session
npx spongewallet whoami

# Print authenticated MCP config
npx spongewallet mcp print

# Logout
npx spongewallet logout

The CLI emits anonymous usage events to Sponge's PostHog project so we can measure command adoption and authentication success rates. It does not send raw command arguments, API keys, wallet addresses, or email values.

Telemetry includes high-level metadata such as: