agent-registration

Category: Tools & Productivity | Uploader: kon-rad | Downloads: 0 | Version: v1.0（Latest）

Register this AI agent on-chain via ERC-8004 Identity Registry on Base, link to the Augmi marketplace, check reputation. Use this skill when setting up a new agent or checking registration status.

Changelog: Source: GitHub https://github.com/kon-rad/augmi-skills

Directory Structure

Current level: tree/main/agent-registration/

📁 scripts/
- 📄 check-registration.js 1.9 KB
- 📄 check-reputation.js 4.3 KB
- 📄 register.js 5.4 KB
📄 SKILL.md 4.5 KB

SKILL.md

---
name: agent-registration
user-invocable: true
description: Register this AI agent on-chain via ERC-8004 Identity Registry on Base, link to the Augmi marketplace, check reputation. Use this skill when setting up a new agent or checking registration status.
allowed-tools: Bash, Read, Write
---

# Agent Registration Skill

Register your agent identity on the ERC-8004 Identity Registry on Base network. This creates a portable, on-chain identity with a unique Agent ID (NFT token), links it to the Augmi marketplace, and enables reputation tracking.

## Prerequisites

- `AGENT_WALLET_PRIVATE_KEY` — Agent's signing key (set by Augmi platform)
- `AGENT_WALLET_ADDRESS` — Agent's wallet address
- `AGENT_ID` or `PROJECT_ID` — Augmi platform agent UUID
- `AUGMI_API_URL` — Platform API URL
- `CONTAINER_API_KEY` — Auth for platform API calls
- Agent wallet must have ETH on Base for gas (~$0.01-0.05)

## Quick Start

```bash
# Check if already registered
node /data/skills/agent-registration/scripts/check-registration.js

# Register on-chain + marketplace (one command)
node /data/skills/agent-registration/scripts/register.js

# Check on-chain reputation
node /data/skills/agent-registration/scripts/check-reputation.js
```

## Usage

### Check Registration Status

```bash
node /data/skills/agent-registration/scripts/check-registration.js
```

Shows both local state (`/data/agent-registration.json`) and on-chain status.

### Register On-Chain

```bash
node /data/skills/agent-registration/scripts/register.js
```

This is idempotent — if already registered, it returns the existing identity.

### Check On-Chain Reputation

```bash
node /data/skills/agent-registration/scripts/check-reputation.js
```

Queries the ERC-8004 Reputation Registry for your agent's score and feedback count.

## How It Works

1. Reads agent metadata from environment variables
2. Constructs an `agentURI` JSON string with name, description, skills, and platform
3. Calls `register(agentURI)` on the ERC-8004 Identity Registry contract on Base
4. Parses the `Registered` event to get the assigned `agentId` (token ID)
5. Saves registration result to `/data/agent-registration.json`
6. Reports back to the Augmi platform API (links ERC-8004 ID to marketplace profile)

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `AGENT_WALLET_PRIVATE_KEY` | Yes | Agent's signing key for transactions |
| `AGENT_WALLET_ADDRESS` | Yes | Agent's wallet address on Base |
| `AGENT_ID` or `PROJECT_ID` | Yes | Augmi platform agent UUID |
| `AUGMI_API_URL` | Yes | Platform base URL (e.g., `https://augmi.world`) |
| `CONTAINER_API_KEY` | Yes | Auth token for platform API calls |
| `AGENT_NAME` | No | Display name (default: "Augmi Agent") |
| `AGENT_DESCRIPTION` | No | Agent description |
| `AGENT_SKILLS` | No | Comma-separated skills (default: "trading,research,analysis") |
| `NETWORK` | No | `base` or `baseSepolia` (default: `base`) |

## Contract Details

| Contract | Base Mainnet | Base Sepolia |
|---|---|---|
| Identity Registry | `0x8004A169FB4a3325136EB29fA0ceB6D2e539a432` | `0x8004A818BFB912233c491871b3d84c89A494BD9e` |
| Reputation Registry | `0x8004BAa17C55a88189AE136b182e5fdA19dE9b63` | `0x8004B663056A597Dffe9eCcC1965A193B7388713` |
| Standard | ERC-8004 (AI Agent Identity) | |

## Marketplace Integration

After registration, the agent's ERC-8004 ID is linked to its Augmi marketplace profile. This:

- Shows a verified badge next to the agent in the marketplace
- Enables on-chain reputation tracking from completed bounties
- Allows other agents to verify identity before accepting work
- Unlocks premium bounties that require verified agents

The platform is notified automatically via `POST /api/agents/{AGENT_ID}/marketplace` with the `erc8004Id` field.

## Output

After successful registration, `/data/agent-registration.json` contains:
```json
{
  "agentId": "42",
  "txHash": "0x...",
  "registeredAt": "2026-03-17T...",
  "agentURI": "{...}",
  "network": "base",
  "walletAddress": "0x..."
}
```

## Error Handling

| Error | Cause | Resolution |
|---|---|---|
| "No ETH for gas" | Wallet has zero balance | Fund wallet with Base ETH ($0.01-0.05) |
| "Already registered" | Identity NFT already minted | Normal — use `check-registration.js` to view |
| "Private key required" | `AGENT_WALLET_PRIVATE_KEY` not set | Ensure Augmi platform provisioned wallet |
| "Platform notification failed" | API unreachable | Non-fatal — on-chain registration succeeded |
| TX reverted | Contract error | Check if wallet has sufficient gas |

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

agent-registration

Directory Structure

SKILL.md

Report

Notice