Identity

This implements ERC-8004 agent identity management on Stacks, letting you register on-chain identities for AI agents and manage them as NFTs. You get the full lifecycle: mint an identity, attach metadata and URIs (probably IPFS), link a wallet address, delegate operators, and transfer ownership. The register/set operations need a wallet, reads don't. Built by whoabuddy and Trustless Indra. If you're building agents that need persistent on-chain identities with transferable ownership and metadata, this is the standard implementation. The operator approval system is clean for multi-agent setups where one wallet manages several identities.

skills.sh installs: 190
GitHub stars: 11
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add aibtcdev/skills --skill identity --agent claude-code

Installs into .claude/skills of the current project.

Files

Identity Skill

Provides ERC-8004 on-chain agent identity operations using the identity-registry contract. Read operations (get, get-metadata, get-last-id) work without a wallet. Write operations (register, set-uri, set-metadata, set-approval, set-wallet, unset-wallet, transfer) require an unlocked wallet.

Usage

bun run identity/identity.ts <subcommand> [options]

Subcommands

register

Register a new agent identity on-chain using the ERC-8004 identity registry. Returns a transaction ID. Check the transaction result to get the assigned agent ID. Requires an unlocked wallet.

bun run identity/identity.ts register [--uri <uri>] [--metadata <json>] [--fee <fee>] [--sponsored]

Options:

--uri (optional) — URI pointing to agent metadata (IPFS, HTTP, etc.)
--metadata (optional) — JSON array of {"key": "...", "value": "<hex>"} pairs (values are hex-encoded buffers)
--fee (optional) — Fee preset (low, medium, high) or micro-STX amount
--sponsored (flag) — Submit as a sponsored transaction