agent-bootstrap

One command to bootstrap an AI agent with Nostr identity, Lightning wallet, ai.wot trust, and DVM service announcement.

The "create-react-app" for the agent economy.

What it does

agent-bootstrap init --name "My Agent" --nwc "nostr+walletconnect://..." --dvm

In one command:

1. 🔑 Generates Nostr keys (nsec/npub) with secure file permissions (600)
2. 👤 Publishes profile to 4 relays (damus, nos.lol, primal, snort)
3. ⚡ Configures Lightning wallet via NWC (Nostr Wallet Connect)
4. 🤝 Sets up ai.wot trust — ready to receive attestations
5. 🤖 Registers as a DVM (kind 31990 service announcement)

Install

npm install -g agent-bootstrap

Usage

Bootstrap a new agent

# Minimal — just identity
agent-bootstrap init --name "My Agent"

# With wallet
agent-bootstrap init --name "My Agent" --nwc "nostr+walletconnect://relay.example?secret=..."

# Full stack — identity + wallet + DVM
agent-bootstrap init --name "My Agent" \
  --about "A helpful AI agent" \
  --nwc "nostr+walletconnect://relay.example?secret=..." \
  --dvm \
  --dvm-price 21

# Custom relays
agent-bootstrap init --name "My Agent" \
  --relays "wss://relay.damus.io,wss://nos.lol"

# Generate keys without publishing
agent-bootstrap init --name "My Agent" --skip-publish

Check status

agent-bootstrap status ./agent-identity

Verify everything works

agent-bootstrap verify ./agent-identity

Checks:

• ✅ Keys exist and are valid
• ✅ Key file permissions are secure (600)
• ✅ Profile found on relays
• ✅ Wallet config present
• ✅ Trust score reachable via ai.wot API

JSON output

agent-bootstrap init --name "My Agent" --json
agent-bootstrap status ./agent-identity --json

What it creates

agent-identity/
├── nostr-keys.json          # Nostr keypair (600 permissions)
├── wallet-config.json       # NWC connection (600 permissions)
└── bootstrap-manifest.json  # Full bootstrap record

Programmatic API

const { bootstrap, status, verify, generateKeys } = require('agent-bootstrap');

// Generate keys only
const keys = generateKeys();
console.log(keys.npub, keys.pubkey);

// Full bootstrap
const result = await bootstrap({
  name: 'My Agent',
  about: 'A helpful AI',
  nwcUrl: 'nostr+walletconnect://...',
  dir: './my-agent',
  relays: ['wss://relay.damus.io', 'wss://nos.lol'],
  dvm: true,
  dvmKind: 5050,
  dvmPrice: 21,
});

// Check status
const s = await status('./my-agent');

// Verify
const v = await verify('./my-agent');
console.log(`${v.passed}/${v.total} checks passed`);

The Agent Economy Stack

agent-bootstrap is the entry point. Once bootstrapped, your agent can use:

| Package | Purpose | |---------|---------| | ai-wot | Trust — earn reputation through attestations | | agent-discovery | Discovery — publish and find agent services | | lightning-agent | Payments — send and receive Lightning | | login-with-lightning | Auth — LNURL-auth for agents | | lightning-toll | Monetize — L402 paywalls for APIs | | agent-escrow | Escrow — safe agent-to-agent transactions | | agent-test-kit | Testing — mock relays and wallets |

The flow: bootstrap → discover → trust → pay → deliver → attest → repeat.

Dependencies

• nostr-tools — Nostr key generation and event signing
• ws — WebSocket for relay connections

Zero other dependencies.

License

MIT

Author

Built by Jeletor 🌀