8004-skill

name	8004-skill
description	ERC-8004 Trustless Agents - Register and manage AI agent identities on TRON and BSC blockchains with on-chain reputation tracking

ERC-8004: Trustless Agents on TRON & BSC

On-chain identity, reputation, and validation for autonomous agents on TRON. Now live on TRON Mainnet + BSC Mainnet!

Overview

ERC-8004 provides three registries on TRON and BSC blockchains:

• Identity Registry - TRC-721 agent identities with registration metadata
• Reputation Registry - Signed feedback scores between agents/clients
• Validation Registry - Independent verification (zkML, TEE, stakers)

Multi-Chain: Same protocol works on TRON and BSC (BNB Smart Chain) - both fully deployed!

Quick Reference

Register Agent

# TRON Mainnet
node scripts/register.js --uri "ipfs://..." --chain tron --network mainnet

# TRON Testnet
node scripts/register.js --uri "ipfs://..." --chain tron --network nile

# BSC Mainnet
node scripts/register.js --uri "ipfs://..." --chain bsc --network mainnet

# BSC Testnet
node scripts/register.js --uri "ipfs://..." --chain bsc --network testnet

# Register without URI (set later)
node scripts/register.js --chain tron --network nile

Private Key Setup

# Set once, works for both TRON and BSC
export TRON_PRIVATE_KEY="your_64_character_hex_private_key"

Networks

TRON Networks

Network	Status	Identity Registry	Reputation Registry	Validation Registry
Mainnet	Live	TFLvivMdKsk6v2GrwyD2apEr9dU1w7p7Fy	TFbvfLDa4eFqNR5vy24nTrhgZ74HmQ6yat	TLCWcW8Qmo7QMNoAKfBhGYfGpHkw1krUEm
Nile	Live	TDDk4vc69nzBCbsY4kfu7gw2jmvbinirj5	TBVaGd6mBuGuN5ebcvPvRaJo4rtEWqsW6Y	TGGkHDHhBzhFcLNcEogAWJkvfFYy4jyrSw
Shasta	Live	TH775ZzfJ5V25EZkFuX6SkbAP53ykXTcma	TTkds2ZZKBTChZHho4wcWAa7eWQTxh5TUT	TQBFHtKRiaQjc1xp4LtmmXKYdA7JLN89w3

Note: TRON deployments implement TRC-8004 (TRON version of ERC-8004). Query scripts use compatibility mode:

• ✅ Always available: ownerOf, tokenURI (ERC-721 standard)
• ⚠️ May vary: agentURI, getAgentWallet, agentExists (ERC-8004 extensions)

BSC Networks

Network	Status	Identity Registry	Reputation Registry	Validation Registry
BSC Mainnet	Live	0x8004A169FB4a3325136EB29fA0ceB6D2e539a432	0x8004BAa17C55a88189AE136b182e5fdA19dE9b63	0x8004Cc8439f36fd5F9F049D9fF86523Df6dAAB58
BSC Testnet	Live	0x8004A818BFB912233c491871b3d84c89A494BD9e	0x8004B663056A597Dffe9eCcC1965A193B7388713	0x8004Cb1BF31DAf7788923b405b754f57acEB4272

Note: BSC deployments use full ERC-8004 specification with all standard methods.

Multi-Chain Usage:

# TRON
node scripts/register.js --uri "ipfs://..." --chain tron --network mainnet

# BSC
node scripts/register.js --uri "ipfs://..." --chain bsc --network mainnet

Contract addresses and ABIs in lib/contracts.json.

Registration File Format

{
  "type": "https://eips.ethereum.org/EIPS/eip-8004#registration-v1",
  "name": "your-agent-name",
  "description": "Agent description...",
  "image": "ipfs://...",
  "services": [
    { "name": "A2A", "endpoint": "https://agent.example/.well-known/agent-card.json", "version": "0.3.0" },
    { "name": "MCP", "endpoint": "https://mcp.agent.tron/", "version": "2025-06-18" }
  ],
  "registrations": [
    { "agentRegistry": "tron:728126428:TFLvivMdKsk6v2GrwyD2apEr9dU1w7p7Fy"   
  
     

Template at templates/registration.json.

Reputation Scores

The reputation system uses signed fixed-point numbers (value + valueDecimals):

Tag	Meaning	Example	value	decimals
quality	Quality (0-100)	87/100	87	0
uptime	Uptime %	99.77%	9977	2
yield	Yield %	-3.2%	-32	1
latency	Latency ms	560ms	560	0

Trust Models

ERC-8004 supports three pluggable trust models:

• Reputation-based - Client feedback with scores, tags, and metadata
• Crypto-economic - Stake-secured validation with economic incentives
• Crypto-verification - TEE attestations and zkML proofs

Dependencies

• node & npm - JavaScript runtime and package manager
• tronweb - TRON JavaScript SDK (npm install tronweb)
• Private key configuration (choose one):
  • Environment variable: TRON_PRIVATE_KEY or PRIVATE_KEY
  • File: ~/.clawdbot/wallets/.deployer_pk
• IPFS: Set PINATA_JWT for uploads, or upload manually

TRON-Specific Features

Address Format

• TRON uses Base58 addresses starting with 'T' (e.g., TFLvivMdKsk6v2GrwyD2apEr9dU1w7p7Fy)
• Scripts automatically handle address conversion

Network Identifiers

• Mainnet: tron:728126428 (TRON chain ID)
• Use in registration files: tron:728126428:TFLvivMdKsk6v2GrwyD2apEr9dU1w7p7Fy

Energy & Bandwidth

• TRON uses Energy and Bandwidth instead of gas
• Scripts set feeLimit: 1000000000 (1000 TRX max)
• Actual costs are typically much lower

Resources

Official

• EIP-8004 Spec - Full specification
• 8004.org - Official website
• Telegram Community - Builder chat
• Builder Program - Join the ecosystem

TRON Resources

• TRON Developers - Official documentation
• TronScan - Block explorer
• TronWeb - JavaScript SDK
• TronGrid - API service

Ecosystem

• Awesome ERC-8004 - Curated resource list
• A2A Protocol - Agent-to-Agent protocol TRC-8004 extends

Script Reference

All scripts support multi-chain (TRON + BSC):

• register.js - Register new agent on-chain
• query.js - Query agent info and reputation
• feedback.js - Submit feedback/reputation scores
• set-uri.js - Update agent metadata URI

Run any script without arguments to see detailed usage information.

Examples

Complete Agent Workflow

# 1. Set private key (works for both TRON and BSC)
export TRON_PRIVATE_KEY="your_private_key"

# 2. Register agent on TRON testnet
node scripts/register.js --uri "ipfs://QmYourHash" --chain tron --network nile

# 3. Query agent info (use ID from step 2)
node scripts/query.js agent 1 --chain tron --network nile

# 4. Submit feedback
node scripts/feedback.js --agent-id 1 --score 95 --tag1 "quality" --chain tron --network nile

# 5. Query reputation
node scripts/query.js reputation 1 --chain tron --network nile

# 6. Update URI if needed
node scripts/set-uri.js --agent-id 1 --uri "ipfs://QmNewHash" --chain tron --network nile

Multi-Chain Examples

# Register on BSC testnet
node scripts/register.js --uri "ipfs://..." --chain bsc --network testnet

# Query agent on BSC mainnet
node scripts/query.js agent 1 --chain bsc --network mainnet

# Submit feedback on TRON mainnet
node scripts/feedback.js --agent-id 1 --score 98 --tag1 "quality" --chain tron --network mainnet

Troubleshooting

"TRON_PRIVATE_KEY not set"

# Option 1: Environment variable (recommended)
export TRON_PRIVATE_KEY="your_64_character_hex_private_key"

# Option 2: File storage
mkdir -p ~/.clawdbot/wallets
echo "your_private_key" > ~/.clawdbot/wallets/.deployer_pk
chmod 600 ~/.clawdbot/wallets/.deployer_pk

"Insufficient balance"

• Ensure your wallet has TRX for transaction fees
• Get testnet TRX from Nile Faucet

"Not the owner"

• Only the agent owner can update URI or metadata
• Check ownership with query.js agent <id>

Security Notes

• Never commit private keys to version control
• Use environment variables for sensitive data
• Test on Nile testnet before mainnet deployment
• Verify contract addresses in lib/contracts.json

---

Compatible with ERC-8004 specification. TRON implementation is TRC-8004.