get-agent-identity

# Getting Agent Identity

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

## Confirm wallet is initialized and authed

```bash
npx agnic@latest status
```

If the wallet is not authenticated, refer to the `authenticate-wallet` skill.

## Check Agent Identity

```bash
npx agnic@latest agent-identity --json
```

This 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:

| Feature | Description |
| ------- | ----------- |
| **On-chain identity** | An ERC-721 NFT representing the agent on the Identity Registry |
| **Reputation score** | Trust score (0-100) based on on-chain transaction history |
| **KYA credentials** | SD-JWT verifiable credentials for identity verification |
| **Delegation** | Spending limits and category permissions via KYA delegation credentials |

## Contract Addresses

| Contract | Network | Address |
| -------- | ------- | ------- |
| Identity Registry | Base Mainnet | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` |
| Identity Registry | Base Sepolia | `0x8004A818BFB912233c491871b3d84c89A494BD9e` |
| Reputation | Base Mainnet | `0x8004BAa17C55a88189AE136b182e5fdA19dE9b63` |
| Reputation | Base Sepolia | `0x8004B663056A597Dffe9eCcC1965A193B7388713` |

## Expected Output

```json
{
  "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 AgnicPay sign-up

## Error Handling

Common errors:

- "Not authenticated" — Run `npx agnic@latest auth login` first
- "No agent identity found" — The user may not have an agent registered yet; create one via the AgnicPay dashboard at [pay.agnic.ai](https://pay.agnic.ai)
- "Agent suspended" — The agent's delegation may have been revoked; contact support