Open-source wallet SDK for AI agents

TypeScript SDK for AI agents and backends that connect to Squid Pay.

Agents can read permitted account context and propose payments or trades.

They cannot approve holds, sign transactions, broadcast, or move money. The owner’s connected wallet remains the final signer.

Agent (this SDK) → Squid validates / HOLDs → Human reviews → Owner wallet signs → Squid verifies
cd /Users/horatiubudai/ceo/Squid/sdk_developer
npm install
npm run build

From another project (local path):

npm install /Users/horatiubudai/ceo/Squid/sdk_developer

Create a Platform API key in Squid → Settings → CLI (sq_master_…

),

or use an agent key from Agents (sq_live_…

).

import { SquidAgentWallet } from "@squid/agent-wallet-sdk";

const squid = new SquidAgentWallet({
  endpoint: process.env.SQUID_ENDPOINT || "http://localhost:4173",
  apiKey: process.env.SQUID_API_KEY
});

const status = await squid.getStatus();
const wallets = await squid.listWallets();

const proposal = await squid.proposePayment({
  asset: "USDC",
  amount: 25,
  recipient: "0xRecipient...",
  chain: "Base",
  note: "Vendor invoice #1042",
  idempotencyKey: "invoice-1042"
});

console.log(proposal.status);     // "held" | "ready_for_wallet"
console.log(proposal.proposalId); // Needs Review hold id
console.log(proposal.message);    // Human-readable next step

Force a transport:

new SquidAgentWallet({ apiKey, transport: "mcp" });
new SquidAgentWallet({ apiKey, transport: "cli" });
console.log(JSON.stringify(squid.toMcpServerConfig(), null, 2));
{
  "mcpServers": {
    "squid": {
      "url": "http://localhost:4173/mcp",
      "headers": {
        "Authorization": "Bearer sq_live_…"
      }
    }
  }
}

Squid MCP tools exposed by this SDK:

squid.getStatus()
squid.listWallets() / getBalances()
squid.listHolds() / getHold(id)
squid.listAgents()
squid.listRules()
squid.listPaymentLinks() / getPaymentLink(id)
squid.getPlatformState()
squid.getFinancialHarness()
squid.doctor()

squid.proposeAction({ type, domain?, asset?, amount?, recipient?, chain?, note?, idempotencyKey? })
squid.proposePayment({ asset, amount, recipient, chain?, note?, idempotencyKey? })
squid.proposeTrade({ asset, amount, … })

squid.executeCli(["status"])
squid.callMcpTool("list_holds")
squid.listMcpTools()
squid.toMcpServerConfig()

Deliberately not available (throws SquidForbiddenError

):

approveHold

signTransaction

exportPrivateKey

Matches Squid Pay:

• No private keys / seed phrases in Squid or this SDK.
• Proposals go through Squid Brain / policy; risky ones become Needs Review holds. - Money moves only after the owner wallet signs and Squid verifies the chain receipt.
• Structured errors from Squid ( code

,type

,message

) are preserved asSquidSdkError

.

export SQUID_ENDPOINT=http://localhost:4173
export SQUID_API_KEY=sq_master_…
node examples/quickstart.mjs
node examples/propose-payment.mjs
node examples/mcp-config.mjs

This package lives next to the console at bank_squid/Squid Pay /

.

Run Squid with npm run dev

there (default http://localhost:4173), then point the SDK at that origin.

npm install
npm run build
npm test

Requires Node.js ≥ 18 (native fetch

).