register_agent
Register an AI agent by generating a cryptographic identity (DID and keypair) for secure on-network operations. Required before submitting attestations or publishing agent cards.
Instructions
Register a new AI agent on the Agent Veil Protocol network.
Creates a cryptographic identity (Ed25519 keypair), generates a W3C DID,
and registers the agent. Keys are saved locally to ~/.avp/agents/
with restricted permissions (chmod 0600).
IMPORTANT: Registration is irreversible. The DID becomes the agent's
permanent identifier. Keys cannot be regenerated for the same DID —
keep the local key file safe.
Call this once before using write operations (submit_attestation,
publish_agent_card). Use get_my_agent_info to verify setup afterward.
Side effects: creates local key file, registers agent on the network.
Args:
display_name: Human-readable name (e.g. "Code Reviewer").
If empty, uses AVP_AGENT_NAME environment variable.
Returns:
JSON with the new agent's DID, display_name, registration status,
and local key storage path.
Returns {"error": "..."} if registration fails (network error, name conflict).Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| display_name | No | Human-readable name for the agent. Example: 'Code Reviewer'. If empty, uses AVP_AGENT_NAME env var |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |