Getting Agent Identity

Check the user's on-chain ERC-8004 agent identity, trust score, and KYA (Know Your Agent) credentials.

Authentication

Run npx agnic@latest status --json to verify. If not authenticated:

• Headless (CI/server/agent): Set AGNIC_TOKEN env var or pass --token
• Interactive (has browser): Run npx agnic@latest auth login

See the authenticate-wallet skill for details.

Check Agent Identity

npx agnic@latest agent-identity --json

Returns the agent's on-chain identity including:

• Agent ID -- The ERC-721 token ID on the ERC-8004 Identity Registry
• Owner address -- The wallet that owns the agent NFT
• Trust score -- Reputation score (0-100) based on transaction history
• Categories -- Authorized action categories (e.g., payment, general, alcohol)
• Status -- Whether the agent is active or suspended

What is ERC-8004?

ERC-8004 ("Trustless Agents") is an Ethereum standard that gives AI agents:

Contract Addresses

Expected Output

{
  "agentId": 373,
  "ownerAddress": "0x046906b3cd9d73bf85eb01d795d333b364b75842",
  "status": "active",
  "registeredAt": "2024-12-15T10:30:00Z",
  "trustScore": 85,
  "categories": ["payment", "general"],
  "hasDelegation": true
}

Prerequisites

• Must be authenticated (npx agnic@latest status to check)
• Agent identity is automatically created during Agnic sign-up

Error Handling

Common errors:

• "Not authenticated" -- Run npx agnic@latest auth login or set AGNIC_TOKEN
• "No agent identity found" -- The user may not have an agent registered; create one at app.agnic.ai
• "Agent suspended" -- The agent's delegation may have been revoked; contact support