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
CODEBLOCK0
Private Key Setup
CODEBLOCK1
Networks
TRON Networks
| Network | Status | Identity Registry | Reputation Registry | Validation Registry |
|---|
| Mainnet | Live | INLINECODE0 | INLINECODE1 | INLINECODE2 |
| 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 | INLINECODE14 | INLINECODE15 | INLINECODE16 |
| BSC Testnet |
Live |
0x8004A818BFB912233c491871b3d84c89A494BD9e |
0x8004B663056A597Dffe9eCcC1965A193B7388713 |
0x8004Cb1BF31DAf7788923b405b754f57acEB4272 |
Note: BSC deployments use full ERC-8004 specification with all standard methods.
Multi-Chain Usage:
CODEBLOCK2
Contract addresses and ABIs in lib/contracts.json.
Registration File Format
CODEBLOCK3
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 - INLINECODE26 - 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: INLINECODE34
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
TRON Resources
Ecosystem
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
CODEBLOCK4
Multi-Chain Examples
CODEBLOCK5
Troubleshooting
"TRONPRIVATEKEY not set"
CODEBLOCK6
"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 INLINECODE36
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 INLINECODE37
Compatible with ERC-8004 specification. TRON implementation is TRC-8004.
ERC-8004:波场与BSC上的去信任化代理
波场上自主代理的链上身份、声誉与验证。现已上线波场主网 + BSC主网!
概述
ERC-8004在波场和BSC区块链上提供三个注册表:
- - 身份注册表 - 包含注册元数据的TRC-721代理身份
- 声誉注册表 - 代理/客户端之间的签名反馈评分
- 验证注册表 - 独立验证(zkML、TEE、质押者)
多链: 同一协议适用于波场和BSC(BNB智能链)——均已完全部署!
快速参考
注册代理
bash
波场主网
node scripts/register.js --uri ipfs://... --chain tron --network mainnet
波场测试网
node scripts/register.js --uri ipfs://... --chain tron --network nile
BSC主网
node scripts/register.js --uri ipfs://... --chain bsc --network mainnet
BSC测试网
node scripts/register.js --uri ipfs://... --chain bsc --network testnet
无URI注册(稍后设置)
node scripts/register.js --chain tron --network nile
私钥设置
bash
设置一次,波场和BSC均适用
export TRON
PRIVATEKEY=你的64位十六进制私钥
网络
波场网络
| 网络 | 状态 | 身份注册表 | 声誉注册表 | 验证注册表 |
|---|
| 主网 | 已上线 | TFLvivMdKsk6v2GrwyD2apEr9dU1w7p7Fy | TFbvfLDa4eFqNR5vy24nTrhgZ74HmQ6yat | TLCWcW8Qmo7QMNoAKfBhGYfGpHkw1krUEm |
| Nile |
已上线 | TDDk4vc69nzBCbsY4kfu7gw2jmvbinirj5 | TBVaGd6mBuGuN5ebcvPvRaJo4rtEWqsW6Y | TGGkHDHhBzhFcLNcEogAWJkvfFYy4jyrSw |
|
Shasta | 已上线 | TH775ZzfJ5V25EZkFuX6SkbAP53ykXTcma | TTkds2ZZKBTChZHho4wcWAa7eWQTxh5TUT | TQBFHtKRiaQjc1xp4LtmmXKYdA7JLN89w3 |
注意: 波场部署实现了TRC-8004(ERC-8004的波场版本)。查询脚本使用兼容模式:
- - ✅ 始终可用:ownerOf、tokenURI(ERC-721标准)
- ⚠️ 可能不同:agentURI、getAgentWallet、agentExists(ERC-8004扩展)
BSC网络
| 网络 | 状态 | 身份注册表 | 声誉注册表 | 验证注册表 |
|---|
| BSC主网 | 已上线 | 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 | 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63 | 0x8004Cc8439f36fd5F9F049D9fF86523Df6dAAB58 |
| BSC测试网 |
已上线 | 0x8004A818BFB912233c491871b3d84c89A494BD9e | 0x8004B663056A597Dffe9eCcC1965A193B7388713 | 0x8004Cb1BF31DAf7788923b405b754f57acEB4272 |
注意: BSC部署使用完整的ERC-8004规范,包含所有标准方法。
多链使用:
bash
波场
node scripts/register.js --uri ipfs://... --chain tron --network mainnet
BSC
node scripts/register.js --uri ipfs://... --chain bsc --network mainnet
合约地址和ABI位于lib/contracts.json。
注册文件格式
json
{
type: https://eips.ethereum.org/EIPS/eip-8004#registration-v1,
name: 你的代理名称,
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]
}
模板位于templates/registration.json。
声誉评分
声誉系统使用带符号的定点数(value + valueDecimals):
| 标签 | 含义 | 示例 | 值 | 小数位 |
|---|
| quality | 质量(0-100) | 87/100 | 87 | 0 |
| uptime |
正常运行时间百分比 | 99.77% | 9977 | 2 |
| yield | 收益率百分比 | -3.2% | -32 | 1 |
| latency | 延迟毫秒 | 560ms | 560 | 0 |
信任模型
ERC-8004支持三种可插拔信任模型:
- - 基于声誉 - 带有评分、标签和元数据的客户端反馈
- 加密经济 - 具有经济激励的质押安全验证
- 加密验证 - TEE证明和zkML证明
依赖项
- - node 和 npm - JavaScript运行时和包管理器
- tronweb - 波场JavaScript SDK(npm install tronweb)
- 私钥配置(选择其一):
- 环境变量:TRON
PRIVATEKEY 或 PRIVATE_KEY
- 文件:~/.clawdbot/wallets/.deployer_pk
- - IPFS:设置 PINATA_JWT 用于上传,或手动上传
波场特有功能
地址格式
- - 波场使用以T开头的Base58地址(例如 TFLvivMdKsk6v2GrwyD2apEr9dU1w7p7Fy)
- 脚本自动处理地址转换
网络标识符
- - 主网:tron:728126428(波场链ID)
- 在注册文件中使用:tron:728126428:TFLvivMdKsk6v2GrwyD2apEr9dU1w7p7Fy
能量与带宽
- - 波场使用能量和带宽代替Gas
- 脚本设置 feeLimit: 1000000000(最大1000 TRX)
- 实际成本通常低得多
资源
官方
波场资源
生态系统