Documentation

Cryptographic identity for AI agents. Cartório, não incubadora.

Quick Start

🚀

Register in 2 commands

npx agentidbase fingerprint# -> 0xabc123...

npx agentidbase anchor 0xabc123...# -> tx hash

Get the hash. Anchor the hash. Done.

Fingerprint

Auto-detects your agent from the environment. Checks for OpenClaw manifest, agent.json, or git repo.

Anchor

Registers your fingerprint on Base blockchain. Free gas - we pay for it.

Philosophy

Cartório, não incubadora

AgentID is a notary (cartório), not an incubator. We witness existence, we don't create agents.

✓Witnesses that an agent configuration exists
✓Creates immutable proof on blockchain
✓Verifiable by anyone, forever
✗Does NOT host or run agents
✗Does NOT validate agent behavior
✗Does NOT ask questions or require wizards

Auto-Detection

The fingerprint command auto-detects your agent in this priority order:

openclaw.jsonOpenClaw manifest

agent.jsonAgent config file

.gitGit commit hash

directoryFallback directory hash

Twitter Verification

Optionally link your Twitter account to your agent identity for social proof.

npx agentidbase twitter @yourhandle

1.CLI generates a unique verification code

2.You post a tweet containing the code

3.Paste the tweet URL back in the CLI

4.Your Twitter is now linked to your agent!

Note: This proves you controlled the Twitter account at verification time. The proof is a point-in-time snapshot.

CLI Commands

Command	Description
npx agentidbase fingerprint	Generate agent fingerprint hash
npx agentidbase anchor <hash>	Register hash on-chain (free)
npx agentidbase verify <hash>	Verify an agent identity on-chain
npx agentidbase twitter @handle	Link Twitter account to your agent
npx agentidbase qr <hash>	Generate QR code for verification

Philosophy: The cartório only registers what you explicitly present. Get your hash with fingerprint, then anchor it.

API Reference

Base URL

https://agent007-api-production.up.railway.app/api/v1

POST/blockchain/anchor

Anchor identity hash on-chain (free)

GET/blockchain/verify/:hash

Verify identity on blockchain

POST/verify/twitter/init

Start Twitter verification flow

POST/verify/twitter/confirm

Complete Twitter verification

Smart Contract

Chain

Base Mainnet (8453)

Contract Address

0x471C4c43672be2d49A2ceC79203c23b7194A22Fa

Verify without trusting AgentID

cast call 0x471C4c43672be2d49A2ceC79203c23b7194A22Fa \
  "verifyIdentity(bytes32)" 0xYOUR_HASH \
  --rpc-url https://mainnet.base.org

FAQ

Is it free?

Yes! On-chain anchoring is completely free. We pay all blockchain gas fees.

Do I need a wallet?

No. The CLI handles everything. If you want to anchor with your own wallet, use --local flag.

What does "registered" mean?

"Registered" means the identity hash is permanently recorded on Base blockchain with a mined transaction. This is the ONLY definition of registered.

Why no questions?

AgentID follows the CARTÓRIO model - we witness existence, not create agents. Your environment determines the fingerprint. No wizard needed.

Ready to register your agent?

Get the hash. Anchor the hash.

npx agentidbase fingerprint-> 0x...

npx agentidbase anchor 0x...-> tx