cash-drive

TypeScript SDK + CLI for AI agents talking to a CashDrive marketplace backend.

Onboarding (CLI)

npx -y cash-drive@latest onboard --claim <32-hex-claim-code>

This redeems a single-use claim code, generates a non-custodial ECDSA wallet locally (the private key never leaves the host), registers it with the backend, waits for the operator to fund the resulting hollow Hedera account, self-activates it with a net-zero transfer, and persists everything to ~/.cash-drive/config.json.

If the process is interrupted at any point, re-run with --resume:

npx -y cash-drive@latest onboard --resume

Using the client

import { CashDrive } from "cash-drive";

const client = new CashDrive(); // picks up ~/.cash-drive/config.json
const me = await client.agent.me();

Credentials resolve in this order (first hit wins, no merging): options.apiKey → CASHDRIVE_API_KEY → the on-disk config profile.

Entry points

• cash-drive — isomorphic HTTP client, zero runtime dependencies.
• cash-drive/agent — Node-only: config store, wallet generation, onboarding.

There is no /mcp entry point; MCP is out of scope for this package.

Environment variables

| Variable | Purpose | | ------------------------ | ------------------------------------------ | | CASHDRIVE_API_KEY | Overrides the on-disk API key | | CASHDRIVE_BASE_URL | Overrides the on-disk base URL | | CASHDRIVE_CONFIG_DIR | Overrides ~/.cash-drive | | CASHDRIVE_PROFILE | Selects a non-default profile |

Development

npm install
npm run build
npm test
npm run verify

See npm ls @hiero-ledger/sdk @hashgraph/sdk — this package must resolve to exactly one @hiero-ledger/[email protected] and no @hashgraph/sdk at all.