← Back to Skills Marketplace
ijaack

ERC-8004 Identity

by Giacomo Barbieri · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
1345
Downloads
0
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install erc8004-identity
Description
Deploy and manage an AI agent's onchain identity, reputation, and task capabilities on Avalanche using the ERC-8004 NFT standard.
README (SKILL.md)

ERC-8004 Identity Skill

Deploy your agent's onchain identity on Avalanche using the ERC-8004 standard.

What is ERC-8004?

ERC-8004 is an onchain identity standard for AI agents on Avalanche:

  • Identity Registry: NFT-based agent identity (shared across all agents)
  • Reputation Registry: On-chain feedback from task requesters
  • Validation Registry: Third-party capability verification
  • TaskAgent: Accept paid tasks and build reputation

Quick Start

# 1. Initialize config
cd ~/clawd/skills/erc8004-identity
node cli.js init

# 2. Edit config with your agent details
vim config/agent.config.js

# 3. Deploy (requires AVAX in wallet)
node cli.js deploy

# 4. Set metadata
node cli.js set-metadata

Prerequisites

  • Node.js 18+
  • Private key with ~0.1 AVAX for deployment
  • Agent name and description

CLI Commands

init

Initialize a new agent config file.

node cli.js init

deploy

Deploy ValidationRegistry and TaskAgent, register identity.

node cli.js deploy

set-metadata \x3Ckey> \x3Cvalue>

Set agent metadata (name, description, twitter, etc.).

node cli.js set-metadata name "MyAgent"
node cli.js set-metadata description "AI agent for X"
node cli.js set-metadata twitter "@myagent"

set-uri \x3Curi>

Set agent profile URI.

node cli.js set-uri "https://myagent.com/profile"

set-price \x3CtaskId> \x3CpriceAVAX>

Set task price.

node cli.js set-price 0 0.01

status

Check deployment status and agent info.

node cli.js status

Configuration

Edit config/agent.config.js:

module.exports = {
  agent: {
    name: "YourAgentName",
    description: "What your agent does",
    twitter: "@youragent",
    uri: "https://yourprofile.com"
  },
  tasks: {
    types: [
      { id: 0, name: "Research", price: "0.005" },
      { id: 1, name: "Code Review", price: "0.01" },
      // Add your task types
    ]
  },
  network: {
    rpc: "https://api.avax.network/ext/bc/C/rpc",
    chainId: 43114
  }
};

Environment Variables

Create .env file:

PRIVATE_KEY=your_private_key_here

Or use keychain:

export PRIVATE_KEY=$(security find-generic-password -s "YourWallet" -a "YourAccount" -w)

Official Registries (Avalanche Mainnet)

Contract Address
Identity Registry 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
Reputation Registry 0x8004BAa17C55a88189AE136b182e5fdA19dE9b63

These are shared - all agents register here. Your agent gets a unique Agent ID (NFT).

Costs

  • Identity registration: ~0.01 AVAX
  • ValidationRegistry deploy: ~0.02 AVAX
  • TaskAgent deploy: ~0.03 AVAX
  • Metadata updates: ~0.005 AVAX each
  • Total: ~0.1 AVAX

After Deployment

Your agent will have:

  1. Agent ID - Unique NFT identity number
  2. TaskAgent - Contract to accept paid tasks
  3. Reputation - Starts at 0, builds with completed tasks

Building Reputation

  1. Users submit tasks with AVAX payment
  2. Your agent processes the task off-chain
  3. Complete the task on-chain
  4. User provides feedback (1-5 stars)
  5. Reputation score updates

Example Agents

Resources

Usage Guidance
This package appears to implement exactly what it says: a CLI to register/deploy ERC-8004 agent identity contracts on Avalanche. However, the CLI requires a PRIVATE_KEY (stored in .env or read from your keychain) which is needed to sign transactions — the registry metadata incorrectly omitted that requirement. Before installing or running: (1) do NOT use your main wallet private key; create a fresh test wallet with minimal funds (or use a hardware wallet / transaction approval flow if possible); (2) review cli.js and the contract artifacts yourself (they are included) to confirm addresses and behavior; (3) test on Fuji testnet or with a throwaway key to confirm flow and costs; (4) verify deployed contract bytecode/addresses on a block explorer before interacting further; (5) if the 'base64-block' scan finding concerns you, search the files for any encoded or hidden payloads and reject the skill if you find unexpected obfuscated content. If you are not comfortable handling private keys, do not run the deploy commands.
Capability Analysis
Type: OpenClaw Skill Name: erc8004-identity Version: 1.0.0 The skill bundle is a legitimate tool for deploying and managing ERC-8004 on-chain identities on Avalanche. The `cli.js` script handles sensitive `PRIVATE_KEY` data from the `.env` file, but this is necessary for signing blockchain transactions and is not exfiltrated or misused. The `SKILL.md` provides clear instructions for a human user to interact with the CLI, including setting up environment variables, and does not contain any prompt injection attempts against an AI agent. All actions, including smart contract deployment and interaction, are directly aligned with the stated purpose of the skill.
Capability Assessment
Purpose & Capability
Name and SKILL.md describe deploying ERC-8004 identity contracts on Avalanche, and the included cli.js, ABIs, and artifacts implement that functionality. However, registry metadata claims no required environment variables while both SKILL.md and cli.js require a PRIVATE_KEY — this metadata omission is inconsistent and should be corrected/clarified.
Instruction Scope
SKILL.md instructs the user to run node cli.js init/deploy/status and to provide a PRIVATE_KEY via .env or macOS keychain. The runtime instructions and files reference only local config paths (config/agent.config.js, .env, deployment.json) and Avalanche RPC addresses — no unrelated system files or external endpoints appear in the instructions.
Install Mechanism
There is no automatic install spec (instruction-only), and the repository includes a normal package.json/package-lock that depends on ethers and dotenv from npm. No arbitrary URL downloads or extract operations are present in the manifest — standard npm dependencies are expected for this task.
Credentials
The CLI requires a PRIVATE_KEY to sign and submit transactions (legitimate for deploying contracts). That is a highly sensitive secret — but the skill registry metadata incorrectly lists no required env vars. The omission increases risk because users may not realize the skill needs a private key. Only one sensitive credential is needed (PRIVATE_KEY), which is proportional to the task, but users should NOT reuse a production wallet or a key with funds they cannot afford to lose.
Persistence & Privilege
always is false and the skill does not request system-wide privileges. The CLI reads/writes files within its own skill directory (config/ and deployment.json) which is normal. The skill will run with the agent's ability to invoke it autonomously (platform default) but nothing in the code tries to modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install erc8004-identity
  3. After installation, invoke the skill by name or use /erc8004-identity
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: Deploy onchain AI agent identity on Avalanche
Metadata
Slug erc8004-identity
Version 1.0.0
License
All-time Installs 4
Active Installs 3
Total Versions 1
Frequently Asked Questions

What is ERC-8004 Identity?

Deploy and manage an AI agent's onchain identity, reputation, and task capabilities on Avalanche using the ERC-8004 NFT standard. It is an AI Agent Skill for Claude Code / OpenClaw, with 1345 downloads so far.

How do I install ERC-8004 Identity?

Run "/install erc8004-identity" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ERC-8004 Identity free?

Yes, ERC-8004 Identity is completely free (open-source). You can download, install and use it at no cost.

Which platforms does ERC-8004 Identity support?

ERC-8004 Identity is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ERC-8004 Identity?

It is built and maintained by Giacomo Barbieri (@ijaack); the current version is v1.0.0.

💬 Comments