Managing Agent Identity

ERC-8004 ("Trustless Agents") is a draft Ethereum standard for AI agent trust infrastructure. Abstract deploys IdentityRegistry and ReputationRegistry on both mainnet and testnet. Agents register as ERC-721 tokens and accumulate on-chain reputation through client feedback.

Operating Rules

• Check session readiness before any write operation. Route session issues to authenticating-with-agw.
• Preview every registration, metadata update, and feedback submission with --dry-run before execution.
• Read references/identity-registry.md for the full IIdentityRegistry interface, registration flow, and metadata management.
• Read references/reputation-registry.md for the full IReputationRegistry interface, feedback flow, and aggregation.

Deployed Contracts

Contract	Mainnet (2741)	Testnet (11124)
IdentityRegistry	0x8004A169FB4a3325136EB29fA0ceB6D2e539a432	0x8004A818BFB912233c491871b3d84c89A494BD9e
ReputationRegistry	0x8004BAa17C55a88189AE136b182e5fdA19dE9b63	0x8004B663056A597Dffe9eCcC1965A193B7388713

These are deterministic CREATE2 deployments — same addresses across all 20+ EVM chains.

Core Concepts

• Agent identity is an ERC-721 token minted by register(). The token owner controls the identity.
• agentURI resolves to a JSON registration file containing name, description, services, and x402 support.
• agentWallet is a reserved metadata key for the agent's payment address. Requires EIP-712 or ERC-1271 signature to change. Cleared on transfer.
• Reputation is submitted by clients via giveFeedback() with a signed value, optional tags, and optional off-chain evidence.
• Validation Registry is not yet deployed on Abstract.

ABI Format

The AGW CLI requires full JSON ABI objects, not human-readable strings. Every abi array element must be an object with type, name, inputs, outputs, and stateMutability fields. Human-readable signatures in this skill and its references are for documentation — expand them to full JSON when constructing CLI commands.

Task Map

Read identity for a wallet

agw contract write --json '{
  "address": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
  "abi": [{"type":"function","name":"balanceOf","stateMutability":"view","inputs":[{"name":"owner","type":"address"}],"outputs":[{"name":"","type":"uint256"}]}],
  "functionName": "balanceOf",
  "args": ["<WALLET_ADDRESS>"]
}' --dry-run

If balance > 0, the wallet owns at least one agent identity. Use tokenOfOwnerByIndex or events to find the specific agentId.

Register a new agent identity

agw contract write --json '{
  "address": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
  "abi": [{"type":"function","name":"register","stateMutability":"nonpayable","inputs":[{"name":"agentURI","type":"string"}],"outputs":[{"name":"agentId","type":"uint256"}]}],
  "functionName": "register",
  "args": ["https://example.com/agent.json"]
}' --dry-run

The returned agentId is the ERC-721 token ID. Execute only after user confirms the preview.

Read agent metadata

agw contract write --json '{
  "address": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432",
  "abi": [{"type":"function","name":"tokenURI","stateMutability":"view","inputs":[{"name":"tokenId","type":"uint256"}],"outputs":[{"name":"","type":"string"}]}],
  "functionName": "tokenURI",
  "args": ["<AGENT_ID>"]
}' --dry-run

Get reputation summary

Requires at least one client address to avoid Sybil attacks:

agw contract write --json '{
  "address": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
  "abi": [{"type":"function","name":"getSummary","stateMutability":"view","inputs":[{"name":"agentId","type":"uint256"},{"name":"clientAddresses","type":"address[]"},{"name":"tag1","type":"string"},{"name":"tag2","type":"string"}],"outputs":[{"name":"count","type":"uint64"},{"name":"summaryValue","type":"int128"},{"name":"summaryValueDecimals","type":"uint8"}]}],
  "functionName": "getSummary",
  "args": ["<AGENT_ID>", ["<CLIENT_ADDRESS_1>", "<CLIENT_ADDRESS_2>"], "", ""]
}' --dry-run

Pass empty strings for tag1/tag2 to get unfiltered results. The summaryValue is a signed fixed-point number with summaryValueDecimals precision.

Give feedback

The submitter cannot be the agent owner (prevents self-rating):

agw contract write --json '{
  "address": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63",
  "abi": [{"type":"function","name":"giveFeedback","stateMutability":"nonpayable","inputs":[{"name":"agentId","type":"uint256"},{"name":"value","type":"int128"},{"name":"valueDecimals","type":"uint8"},{"name":"tag1","type":"string"},{"name":"tag2","type":"string"},{"name":"endpoint","type":"string"},{"name":"feedbackURI","type":"string"},{"name":"feedbackHash","type":"bytes32"}],"outputs":[]}],
  "functionName": "giveFeedback",
  "args": ["<AGENT_ID>", "100", "0", "quality", "", "", "", "0x0000000000000000000000000000000000000000000000000000000000000000"]
}' --dry-run

Value 100 with 0 decimals = score of 100. Tags, endpoint, feedbackURI, and feedbackHash are all optional (pass empty strings and zero hash).

Escalation

• Route session issues to authenticating-with-agw.
• Route balance and token checks to reading-agw-wallet.
• Route transaction safety questions to executing-agw-transactions.