Registry Instructions

register_agent

Register a new agent identity. Creates a PDA derived from the owner wallet. Starts at Observer tier with a reputation score of 250 (or inherits from a prior deactivation record if one exists).

  • name — String, max 32 characters
  • service_category — ServiceCategory enum
  • agent_card_url — String, must use https, ipfs, ar, or did scheme
  • agent_card_hash — [u8; 32], SHA-256 hash of the Agent Card document
update_agent

Update an existing agent's metadata. All parameters are optional; only provided fields are changed.

  • new_capabilities — u64 bitmask
  • new_name — String
  • new_service_category — ServiceCategory
  • new_version — String, max 16 characters
  • new_agent_card_url + new_agent_card_hash — must be updated together
deactivate_agent

Permanently deactivate an agent. Irreversible. Creates a deactivation record that preserves the agent's final reputation score.

suspend_agent

Suspend an active agent. Owners can self-suspend their own agent; admins can also suspend any agent. Once suspended, the agent cannot participate in transactions until reactivated.

  • owner — Signer, the agent owner or protocol admin

Note: Owners can suspend their own agent. Once suspended, the agent cannot participate in transactions until reactivated.

reactivate_agent

Reactivate a suspended agent, restoring it to Active status. Owners can reactivate their self-suspended agent; admin-suspended agents can only be reactivated by the admin.

  • owner — Signer, the agent owner or protocol admin

Note: Only works if the agent was self-suspended by the owner. Admin-initiated suspensions require admin reactivation.

close_agent

Close a deactivated agent account and reclaim rent. Requires zero stake balance.

close_deactivation_record

Close a deactivation record after the 30-day grace period and reclaim rent.

  • owner — the wallet that owns the deactivation record
verify_agent CPI

CPI instruction for other Solana programs. Verifies that an agent is currently active. Use this to gate your program logic on Vouch identity.

check_agent_eligibility CPI

CPI instruction that returns an AgentProfile (is_active, tier, reputation, capabilities, is_paused, tier_effective_at) without reverting. Allows your program to read agent data and branch accordingly.