identity

Register and manage ERC-8004 on-chain agent identities with wallet operations.

9|43|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/aibtcdev/skills --skill identity-aibtcdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: identity
Source: https://github.com/aibtcdev/skills/tree/main/identity
Command: npx skills add https://github.com/aibtcdev/skills --skill identity-aibtcdev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ERC-8004 on-chain agent identity management enables you to register agent identities, update their URI and metadata, manage operator approvals, link or remove agent wallets, transfer identity NFTs, and query identity information on-demand.

Core Features & Use Cases

  • Register new agent identities on-chain (mint) and optionally attach a URI or initial metadata.
  • Update the URI, set metadata, manage operator approvals, set or unset the agent wallet, and transfer identity NFTs.
  • Query identity information (owner, URI, wallet) and retrieve the most recently minted agent ID.

Quick Start

Register a new on-chain agent identity and verify the assigned agent ID.

Frequently Asked Questions about identity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I register an on-chain agent identity using ERC-8004?

To register an on-chain agent identity using ERC-8004, you use the register operation to mint a new identity on the Stacks blockchain. This write operation requires an unlocked wallet and returns a structured JSON with the transaction ID and explorer URL.

What is ERC-8004 on-chain identity management used for?

ERC-8004 on-chain identity management is used to register agent identities, update URI and metadata, manage operator approvals, link or remove agent wallets, and transfer identity NFTs. It enables persistent, verifiable on-chain identity management for autonomous agents across mainnet or testnet.

Do I need an unlocked wallet to query ERC-8004 agent identity metadata?

No, you do not need an unlocked wallet to query ERC-8004 agent identity metadata. Read operations like get, get-metadata, and get-last-id require no wallet, while write operations such as set-metadata and set-wallet do require an unlocked Stacks wallet.

What are the limitations when updating ERC-8004 agent metadata on the Stacks blockchain?

When updating ERC-8004 agent metadata on the Stacks blockchain, limitations include a strict 512-byte maximum size limit. Additionally, the metadata must be hex-encoded, and the system enforces robust input validation before returning the transaction ID.

Can I link multiple agent wallets to a single ERC-8004 identity NFT?

You can manage agent wallets for an ERC-8004 identity NFT using the set-wallet and unset-wallet operations. These write operations require an unlocked wallet on the Stacks blockchain to successfully update the identity registry and return a structured JSON transaction ID.