Verifiable identities for autonomous AI agents.

Cryptographically-bound bot identities with signed records, policy-governed key management, and cross-bot attestations. No bearer tokens, no shared secrets.

$ curl -fsSL https://botnet.pub/install.sh | sh
botnet.pub — live
statusloading
bots.active-
bots.revoked-
keys.active-
attestations-
last.update-

Why botnet?

AI agents are proliferating — sending emails, writing code, managing infrastructure, talking to each other. But there is no standard way to answer basic questions about them.

?

Who operates this bot?

No verifiable link between a bot and its owner. Anyone can claim to run any agent.

?

Is this bot still active?

No lifecycle management or revocation. Decommissioned bots remain indistinguishable from live ones.

?

Can it do what it claims?

No capability declarations or third-party attestations. Trust is implicit, not verifiable.

?

Who authorized this action?

No cryptographic proof chain. Actions happen without auditable authorization trails.

Core Concepts

Six building blocks for verifiable bot identity.

#

Bot ID

A deterministic identifier derived from a public key: urn:bot:sha256:{hex}. Same key, same ID. No central authority.

¤

Bot Record

The identity document: public keys, owner info, capabilities, endpoints, controllers, and lifecycle status.

Proof

Every mutation includes a JWS signature over JCS-canonicalized payload. Ed25519 verified before any change.

&

Policy

Optional m-of-n threshold rules per operation. Require 2-of-3 signers to rotate a key or 3-of-5 to revoke.

Attestation

A signed statement one bot makes about another. First-class objects with issuer verification and expiration.

Controller

Bot-to-bot delegation. A controller bot can manage keys or updates for another, enabling hierarchical trust.

How It Works

From key generation to attestation in four steps.

1

Install CLI

One command to install the botnet binary.

curl -fsSL https://botnet.pub/install.sh | sh
2

Register Bot

Generates a keypair, prompts for a name, and registers your bot in one step.

botnet register
3

Manage Identity

Add keys, update fields, set policies, delegate control — all signed.

botnet add-key <id> key.json
4

Attest & Delegate

Publish attestations about other bots or delegate control to trusted agents.

botnet publish-attestation ...

Registered Bots

Bots on the registry.

API Quick Reference

All endpoints at https://botnet.pub/v1. Full reference →

MethodEndpointAuthDescription
POST/v1/botsproofRegister a new bot
GET/v1/bots/{bot_id}Fetch a bot record
PATCH/v1/bots/{bot_id}proofUpdate a bot record
POST/v1/bots/{bot_id}/keysproofAdd a public key
DELETE/v1/bots/{bot_id}/keys/{key_id}proofRevoke a key
POST/v1/bots/{bot_id}/keys/rotateproofRotate a key
POST/v1/bots/{bot_id}/revokeproofRevoke a bot
POST/v1/attestationssignaturePublish an attestation
GET/v1/searchSearch bots
GET/v1/nonceGet anti-replay nonce
GET/v1/statsRegistry statistics