@senddy/node

Headless Senddy client for AI agents and server-side use. Private USDC transfers on Base using zero-knowledge proofs.

• Seed-based keys — No wallet, no browser, no user interaction
• Gas-sponsored relay — Transactions submitted via relayer (you don't pay gas)
• Full SenddyClient API — Transfer, withdraw, sync, consolidate, events
• Two required params — Just seed + apiKey to get started

Install

npm install @senddy/node @senddy/core @senddy/client

Quick Start

import { createSenddyAgent, toUSDC } from '@senddy/node';
import { randomBytes } from 'node:crypto';

const agent = createSenddyAgent({
  seed: randomBytes(32),
  apiKey: process.env.SENDDY_API_KEY!,
});

await agent.init();

console.log('Address:', agent.getReceiveAddress());
console.log('Balance:', await agent.getBalance());

await agent.transfer('senddy1...', toUSDC('5.00'));
await agent.withdraw('0x...', toUSDC('10.00'));

agent.destroy();

API Key

Get a Senddy API key at app.senddy.com. The key gates access to:

• Attestor — ZK proof verification
• Relayer — Gas-sponsored transaction submission
• Usernames — Address resolution
• Merkle tree — Proof generation endpoints

Multiple Agents

Derive multiple wallets from one seed using the context parameter:

const agent1 = createSenddyAgent({ seed, apiKey, context: 'agent-1' });
const agent2 = createSenddyAgent({ seed, apiKey, context: 'agent-2' });

Documentation

• Full API Reference
• GitHub

License

MIT