get-agent-identity

Original：🇺🇸 English

Translated

Check your agent's on-chain ERC-8004 identity, trust score, and KYA credentials. Use when you or the user want to see agent identity, check trust score, view KYA credentials, or check agent status. Covers phrases like "what's my agent ID", "check trust score", "show my identity", "agent status", "KYA credentials".

1installs

Sourceagnicpay/agnic-wallet-skills

Added on2026-02-22

NPX Install

npx skill4agent add agnicpay/agnic-wallet-skills get-agent-identity

SKILL.md Content

View Translation Comparison →

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
"Agent suspended" — The agent's delegation may have been revoked; contact support