Claw Cash — Private Payments for AI Agents

// How it works

Private Payments in Three Steps

1. Deposit

Lock funds into the privacy pool. Only a commitment hash goes on-chain.

→

2. Transfer

Share a voucher file off-chain. Encrypted, via messaging, however you want.

→

3. Withdraw

Recipient reveals the secret. Funds are released. No link to the deposit.

// The crypto — simple but effective
commitment     = SHA256(secret)              // published on-chain
recipientHash  = SHA256(pubkey || salt)      // binds to recipient
withdrawal     = reveal(secret, salt)       // proves knowledge → funds released
        

// Quick start

Get Running in 60 Seconds

$ git clone https://github.com/kwaude/claw-cash.git
$ cd claw-cash && npm install

# Run locally (instant, no network needed)
$ npx tsx src/demo.ts

# Run on Solana devnet (real transactions)
$ npx tsx src/cli.ts demo --network devnet

# CLI commands
$ npx tsx src/cli.ts deposit --amount 10
$ npx tsx src/cli.ts balance
$ npx tsx src/cli.ts list
        

// Or use the SDK programmatically
import { ClawCash } from 'claw-cash';

const client = new ClawCash({
  authToken: 'your-token',
  connection,
  wallet,
});

// Deposit 10 USDC privately
const { voucher } = await client.deposit({
  amount: 10,
  recipient: 'RecipientPubkey...',
});

// Recipient withdraws
const { txSignature } = await client.withdraw({ voucher });
        

// Why Claw Cash

Built for Agents, Not Humans

🔒 Unlinkable Transfers

On-chain footprint reveals nothing about sender-recipient relationship. Commitment scheme breaks the link.

🤖 Headless SDK

No browser, no UI, no wallet popups. Pure TypeScript — import and go. Built for agents running in the background.

⚡ Solana Speed

Sub-second finality. Deposits and withdrawals confirm in ~400ms. No waiting for block confirmations.

🔌 Swappable Engine

PrivacyEngine interface lets you swap backends. PoC uses our on-chain program. Production-ready for ZERA protocol integration.

📦 Voucher System

Bearer instruments as JSON files. Transfer value by sharing a file — works over any messaging channel. Like digital cash.

🧪 Tested On-Chain

Anchor program deployed to devnet. Full test suite: deposit, withdraw, double-spend protection, wrong-secret rejection.

// Architecture

The Stack

┌──────────────────────────────────────────────────┐ │ AI Agent (Clawdbot, etc.) │ │ "Send $10 privately to AgentB" │ ├──────────────────────────────────────────────────┤ │ ClawCash SDK │ │ deposit() · withdraw() · balance() │ ├──────────┬──────────┬────────────────────────────┤ │ crypto │ api │ voucher │ │ secrets │ REST API │ file I/O │ │ hashes │ HTTP │ serialization │ ├──────────┴──────────┴────────────────────────────┤ │ PrivacyEngine Interface │ │ ┌─────────────┐ ┌──────────────────┐ │ │ │ OurEngine │ │ ZeraEngine │ │ │ │ (devnet) │ │ (production) │ │ │ │ Anchor + │ │ Legal-compliant │ │ │ │ CF Worker │ │ ZK privacy │ │ │ └─────────────┘ └──────────────────┘ │ ├──────────────────────────────────────────────────┤ │ Solana │ │ USDC · SPL · Programs │ └──────────────────────────────────────────────────┘

🔒 Claw Cash