🌐 Imajin Registry
The phone book for the sovereign network.
API Endpoints
| Method | Endpoint | Purpose |
|---|---|---|
POST | /api/node/register | Register a new node |
POST | /api/node/heartbeat | Send liveness ping |
GET | /api/node/list | List all nodes |
GET | /api/node/lookup/:id | Find node by DID or hostname |
POST | /api/builds/verify | Check if build hash is approved |
How It Works
- Run a signed Imajin build (auth, pay, profile, etc.)
- Your node generates a keypair and creates a DID
- Node sends attestation to
/api/node/register - Registry verifies build hash against approved releases
- If valid, provisions
your-hostname.imajin.ai - Node sends daily heartbeats to stay active
- Registration renews every 30 days
Federation Note
This registry is federated, not decentralized. It's a bootstrapping convenience. The path to full decentralization includes on-chain node registry (Solana) and mesh trust discovery (optical verification between devices).
The exit door is always open: this registry is open source, and nodes work locally even without a subdomain.