8004-skill

# 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
```bash
# 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
```bash
# 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:**
```bash
# 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

```json
{
  "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`):

| 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](https://eips.ethereum.org/EIPS/eip-8004) - Full specification
- [8004.org](https://8004.org) - Official website
- [Telegram Community](https://t.me/ERC8004) - Builder chat
- [Builder Program](http://bit.ly/8004builderprogram) - Join the ecosystem

### TRON Resources
- [TRON Developers](https://developers.tron.network/) - Official documentation
- [TronScan](https://tronscan.org/) - Block explorer
- [TronWeb](https://github.com/tronprotocol/tronweb) - JavaScript SDK
- [TronGrid](https://www.trongrid.io/) - API service

### Ecosystem
- [Awesome ERC-8004](https://github.com/sudeepb02/awesome-erc8004) - Curated resource list
- [A2A Protocol](https://a2a-protocol.org/) - 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
```bash
# 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
```bash
# 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"
```bash
# 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](https://nileex.io/join/getJoinPage)

### "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.*