zbd.ai Registry

Register agent identities and resolve Lightning Addresses through LNURL endpoints.

The registry service powers the identity layer behind zbdw init, returning stable Lightning addresses like <username>@zbd.ai.

What It Does

1. Validates your project API key

   Calls ZBD wallet endpoint to verify key validity.

2. Creates or updates static charge linkage

   Creates LNURL-backed payment destination for your identity.

3. Returns stable Lightning Address

   Responds with { "lightningAddress": "[e-mail]" }.

API Endpoints

Method	Route	Purpose
POST	/api/register	Register or refresh agent identity
GET	/.well-known/lnurlp/:username	LNURL metadata resolution
GET	/.well-known/lnurlp/:username?amount=<msat>	Invoice generation callback

Request + Response

Register request

{ "apiKey": "<zbd-project-api-key>" }

Storage Backends

File

Local development and VPS-friendly.

• Backend: file
• Path: ~/.zbd-ai/agents.json (default)

Vercel KV

Serverless persistence path.

• Backend: vercel-kv
• Env vars: KV_REST_API_URL / KV_REST_API_TOKEN

Key Environment Variables

Variable	Default
ZBD_API_BASE_URL	https://api.zbdpay.com
ZBD_AI_STORE_BACKEND	auto-select
ZBD_AI_STORE_PATH	~/.zbd-ai/agents.json

In serverless deployments, avoid relying on local filesystem persistence. Use a durable backend such as Vercel KV.