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

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

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", "agentId": "1" }
  ],
  "supportedTrust": ["reputation", "crypto-economic", "tee-attestation"]
}

Template at templates/registration.json.

Reputation Scores

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

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 \x3Cid>

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.