Skip to content

Latest commit

 

History

History
261 lines (193 loc) · 7.81 KB

faq.md

File metadata and controls

261 lines (193 loc) · 7.81 KB

Frequently Asked Questions

Common questions about ERC-8004 and the Agent Creator.

General

What is ERC-8004?

ERC-8004 is an Ethereum standard (EIP) for trustless agent identity. It defines three on-chain registries — Identity, Reputation, and Validation — that enable AI agents to discover, interact with, and trust each other across organizational boundaries without intermediaries.

Each registered agent gets an ERC-721 NFT identity that's portable, transferable, and censorship-resistant.

→ Read more: What is ERC-8004?

Do I need to know how to code?

No. The Agent Creator is a visual wizard — just fill in a form and click Deploy. You do need a Web3 wallet (MetaMask) and some BNB for gas fees.

If you want to register agents programmatically, see the Integration Guide.

Is it free?

The tool itself is free and open-source. Registration costs a small gas fee:

  • BSC Testnet: Free (use faucet for tBNB)
  • BSC Mainnet: 0.001-0.005 BNB ($0.30-$1.50)
  • Ethereum Mainnet: ~0.001-0.01 ETH (varies with gas prices)
Which wallets are supported?

Any Web3 wallet that supports the Ethereum provider API:

  • MetaMask
  • Rabby
  • Coinbase Wallet
  • Trust Wallet (browser)
  • WalletConnect (coming soon)
  • Any injected window.ethereum provider
Which blockchains are supported?

Currently deployed and available in the UI:

  • BNB Smart Chain Testnet (Chain ID: 97)
  • BNB Smart Chain Mainnet (Chain ID: 56)

Also deployed (can be added):

  • Ethereum Mainnet (Chain ID: 1)
  • Ethereum Sepolia (Chain ID: 11155111)

The contracts use deterministic CREATE2 addresses and can be deployed to any EVM-compatible chain.

→ See all addresses: Contract Addresses

Security

Is it safe to use?

Yes. The tool:

  • Never touches your private keys — all transactions are signed in your wallet
  • Has no backend — it's a static HTML file
  • Is open-source — verify the code yourself
  • Uses audited contracts — built on OpenZeppelin's ERC-721 implementation

The only blockchain interaction is calling register() on the ERC-8004 IdentityRegistry contract.

Does it store my data?

No. The tool has no server, no database, no analytics, and no tracking. Everything happens between your browser and the blockchain.

Your agent registration data is stored either:

  • On-chain (in the smart contract)
  • On IPFS (if you choose IPFS storage)
  • On your web server (if you choose HTTPS storage)
Can someone steal my agent NFT?

Only if they have access to your wallet. The agent NFT is a standard ERC-721 token — it follows the same security model as any other NFT. Only the token owner can:

  • Transfer the NFT
  • Update the agent URI
  • Set metadata

Technical

What is the MetadataEntry struct? 
struct MetadataEntry {
    string metadataKey;    // The key (e.g., "category")
    bytes metadataValue;   // The value as bytes (e.g., encoded "DeFi")
}

In JavaScript, you encode values as:

const entry = {
  metadataKey: "category",
  metadataValue: ethers.toUtf8Bytes("DeFi")
};
What's the difference between tokenURI and agentURI?

They're the same thing. tokenURI() is the standard ERC-721 function. In ERC-8004, this returns the agent's registration JSON (or a URI pointing to it). setAgentURI() is the ERC-8004-specific setter function.

How does on-chain storage work?

When you select "On-Chain (Base64)", the registration JSON is encoded as:

data:application/json;base64,eyJ0eXBlIjoiaHR0cHM6Ly9laXBz...

This data URI is stored in the contract's token URI storage. It's slightly more expensive gas-wise (~50-100k gas extra) but requires no external hosting.

Can I update my agent after registration?

Yes! As the NFT owner, you can:

// Update the agent URI
await registry.setAgentURI(agentId, newUri);

// Update metadata
await registry.setMetadata(agentId, "category", ethers.toUtf8Bytes("new-category"));

Both emit events (URIUpdated, MetadataSet) so indexers can track changes.

What are the gas costs?

Approximate costs on BSC (gas price ~3 gwei):

Operation Gas Cost (BSC)
register() (no URI) ~150,000 ~$0.15
register(string) (short URI) ~200,000 ~$0.20
register(string) (on-chain JSON) ~300,000 ~$0.30
register(string, metadata[]) ~350,000+ ~$0.35+
setAgentURI() ~50,000 ~$0.05
setMetadata() ~50,000 ~$0.05

Troubleshooting

MetaMask won't connect
  1. Make sure MetaMask is unlocked
  2. Refresh the page
  3. Check if another dApp is blocking the connection
  4. Try disconnecting all sites in MetaMask → Settings → Connected Sites
Transaction fails or reverts

Common causes:

  • Insufficient gas — increase gas limit in MetaMask
  • Wrong network — make sure you're on BSC Testnet (chain ID 97)
  • No tBNB — get free tBNB from the faucet
  • Contract paused — check BscScan for contract status
My agents don't show in the dashboard

The dashboard scans recent blocks (last ~5000) for Transfer events. If your agent was registered long ago, it may not appear. You can:

  1. Click "Refresh" to re-scan
  2. Check BscScan directly for your NFTs
  3. Your balanceOf count will still be accurate
The page is blank / ethers.js won't load
  1. Check your internet connection
  2. Make sure you're not blocking CDN scripts (ad blockers, corporate firewalls)
  3. Try opening directly from a local file: open index.html
  4. Check the browser console for errors

Contributing

How can I contribute?
  1. Fork the repository
  2. Make your changes
  3. Submit a pull request

We welcome contributions for:

  • New network support
  • UI improvements
  • Documentation
  • Bug fixes
  • Translations
How do I add a new network?

Add an entry to the NETWORKS object in index.html:

NETWORKS.arbitrum = {
  name: 'Arbitrum One',
  chainId: 42161,
  chainIdHex: '0xa4b1',
  rpcUrl: 'https://arb1.arbitrum.io/rpc',
  explorer: 'https://arbiscan.io',
  currency: { name: 'ETH', symbol: 'ETH', decimals: 18 },
  contracts: {
    identity: '0x8004A818BFB912233c491871b3d84c89A494BD9e',
    reputation: '0x8004B663056A597Dffe9eCcC1965A193B7388713',
    validation: '0x8004Cb1BF31DAf7788923b405b754f57acEB4272'
  },
  agentRegistry: 'eip155:42161:0x8004A818BFB912233c491871b3d84c89A494BD9e'
};

Then add a button in the network bar HTML.

See Also