Agent
Billions decentralized identity for agents. Link agents to human identities using Billions ERC-8004 and Attestation Registries. Verify and generate authentic...
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.0release · observed Apr 29, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17fvg7va6fvegcvemt3hkdmjn85sx33:verifiedagentidentity- Install using `clawhub skill install s17fvg7va6fvegcvemt3hkdmjn85sx33:verifiedagentidentity` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/nopalempl/verifiedagentidentity before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-nopalempl-verifiedagentidentity/snapshot"
Documentation
CLAWHUB
138,959 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: verified-agent-identity
description: Billions decentralized identity for agents. Link agents to human identities using Billions ERC-8004 and Attestation Registries. Verify and generate authentication proofs. Based on iden3 self-sovereign identity protocol.
metadata: { "category": "identity", "clawdbot": { "requires": { "bins": ["node"] }, "config": { "optionalEnv": ["BILLIONS_NETWORK_MASTER_KMS_KEY"] } } }
homepage: https://billions.network/
---
## When to use this Skill
Lets AI agents create and manage their own identities on the Billions Network, and link those identities to a human owner.
1. When you need to link your agent identity to an owner.
2. When you need to sign a challenge.
3. When you need to link a human to the agent's DID.
4. When you need to verify a signature to confirm identity ownership.
5. When you use shared JWT tokens for authentication.
6. When you need to create and manage decentralized identities.
### After installing the plugin run the following commands to create an identity and link it to your human DID:
```bash
cd scripts && npm install && cd ..
# Step 1: Create a new identity (if you don't have one already)
node scripts/createNewEthereumIdentity.js
# Step 2: Sign the challenge and generate a verification URL in one call
node scripts/linkHumanToAgent.js --challenge '{"name": <AGENT_NAME>, "description": <SHORT_DESCRIPTION>}'
```
## Scope
All identity data is stored in `$HOME/.openclaw/billions` for compatibility with the OpenClaw plugin.
# Scripts:
### createNewEthereumIdentity.js
**Command**: `node scripts/createNewEthereumIdentity.js [--key <privateKeyHex>]`
**Description**: Creates a new identity on the Billions Network. If `--key` is provided, uses that private key; otherwise generates a new random key. The created identity is automatically set as default.
**Usage Examples**:
```bash
# Generate a new random identity
node scripts/createNewEthereumIdentity.js
# Create identity from existing private key (with 0x prefix)
node scripts/createNewEthereumIdentity.js --key 0x1234567890abcdef...
# Create identity from existing private key (without 0x prefix)
node scripts/createNewEthereumIdentity.js --key 1234567890abcdef...
```
**Output**: DID string (e.g., `did:iden3:billions:main:2VmAk7fGHQP5FN2jZ8X9Y3K4W6L1M...`)
---
### getIdentities.js
**Command**: `node scripts/getIdentities.js`
**Description**: Lists all DID identities stored locally. Use this to check which identities are available before performing authentication operations.
**Usage Example**:
```bash
node scripts/getIdentities.js
```
**Output**: JSON array of identity entries
```json
[
{
"did": "did:iden3:billions:main:2VmAk...",
"publicKeyHex": "0x04abc123...",
"isDefault": true
}
]
```
---
### generateChallenge.js
**Command**: `node scripts/generateChallenge.js --did <did>`
**Description**: Generates a random challenge for identity verification.
**Usage Example**:
```bash
node scripts/generateChallenge.js --did diskills/verified-agent-identity/SKILL.md
---
name: verified-agent-identity
description: Billions decentralized identity for agents. Link agents to human identities using Billions ERC-8004 and Attestation Registries. Verify and generate authentication proofs. Based on iden3 self-sovereign identity protocol.
metadata: { "category": "identity", "clawdbot": { "requires": { "bins": ["node"] }, "config": { "optionalEnv": ["BILLIONS_NETWORK_MASTER_KMS_KEY"] } } }
homepage: https://billions.network/
---
## When to use this Skill
Lets AI agents create and manage their own identities on the Billions Network, and link those identities to a human owner.
1. When you need to link your agent identity to an owner.
2. When you need to sign a challenge.
3. When you need to link a human to the agent's DID.
4. When you need to verify a signature to confirm identity ownership.
5. When you use shared JWT tokens for authentication.
6. When you need to create and manage decentralized identities.
### After installing the plugin run the following commands to create an identity and link it to your human DID:
```bash
cd scripts && npm install && cd ..
# Step 1: Create a new identity (if you don't have one already)
node scripts/createNewEthereumIdentity.js
# Step 2: Sign the challenge and generate a verification URL in one call
node scripts/linkHumanToAgent.js --challenge '{"name": <AGENT_NAME>, "description": <SHORT_DESCRIPTION>}'
```
## Scope
All identity data is stored in `$HOME/.openclaw/billions` for compatibility with the OpenClaw plugin.
# Scripts:
### createNewEthereumIdentity.js
**Command**: `node scripts/createNewEthereumIdentity.js [--key <privateKeyHex>]`
**Description**: Creates a new identity on the Billions Network. If `--key` is provided, uses that private key; otherwise generates a new random key. The created identity is automatically set as default.
**Usage Examples**:
```bash
# Generate a new random identity
node scripts/createNewEthereumIdentity.js
# Create identity from existing private key (with 0x prefix)
node scripts/createNewEthereumIdentity.js --key 0x1234567890abcdef...
# Create identity from existing private key (without 0x prefix)
node scripts/createNewEthereumIdentity.js --key 1234567890abcdef...
```
**Output**: DID string (e.g., `did:iden3:billions:main:2VmAk7fGHQP5FN2jZ8X9Y3K4W6L1M...`)
---
### getIdentities.js
**Command**: `node scripts/getIdentities.js`
**Description**: Lists all DID identities stored locally. Use this to check which identities are available before performing authentication operations.
**Usage Example**:
```bash
node scripts/getIdentities.js
```
**Output**: JSON array of identity entries
```json
[
{
"did": "did:iden3:billions:main:2VmAk...",
"publicKeyHex": "0x04abc123...",
"isDefault": true
}
]
```
---
### generateChallenge.js
**Command**: `node scripts/generateChallenge.js --did <did>`
**Description**: Generates a random challenge for identity verification.
**Usage Example**:
```bash
node scripts/generateChallenge.js --did diREADME.md
# Verified Agent Identity
A decentralized identity management toolkit for AI agents using iden3 protocol on Billions Network.
## Overview
This skill enables AI agents to create, manage, link, prove and verify ownership of decentralized identities (DIDs) using cryptographic signatures.
## Installation
### Agent CTA:
1. Ask bot to install the skill:
```plaintext
Install the skill `npx clawhub@latest install verified-agent-identity`
```
Or
```plaintext
Install the `verified-agent-identity` skill from the OpenClaw clawhub.ai.
```
2. (Optional) If the verification process did not start automatically after installation, ask your bot to initialize the process by sending a message like:
```plaintext
Please link your agent identity to me.
```
### Human CTA:
1. Install the skill:
```bash
npx clawhub@latest install verified-agent-identity
```
2. Create a new identity:
```bash
# Generate a new key and create a new identity
node scripts/createNewEthereumIdentity.js
```
Or
```bash
# Use an existing private key to create an identity
node scripts/createNewEthereumIdentity.js --key <your-ethereum-private-key>
```
3. Generate a verification link to connect your human identity to the agent:
```bash
node scripts/manualLinkHumanToAgent.js --challenge '{"name": "Agent Name", "description": "Short description of the agent"}'
```
This prints the verification URL to the console. Open it in your browser to complete the identity linking process.
## Features
- **Identity Creation**: Generate new DIDs with random or existing Ethereum private keys
- **Identity Management**: List and manage multiple identities with default identity support
- **Human-Agent Linking**: Link a human identity to an agent's DID through signed challenges
- **Proof Generation**: Generate cryptographic proofs to authenticate as a specific identity
- **Proof Verification**: Verify proofs to confirm identity ownership
## Architecture
### Runtime Requirements
- **Node.js `>= v20`** and **npm** are required to run the scripts.
### Dependency Surface
npm dependencies are intentionally minimal and scoped to well-established, audited packages:
| Package | Purpose |
| ---------------------- | ------------------------------------------------------------ |
| `@0xpolygonid/js-sdk` | iden3/Privado ID cryptographic primitives and key management |
| `@iden3/js-iden3-core` | DID and identity core types |
| `@iden3/js-iden3-auth` | JWS/JWA authorization response construction and verification |
| `ethers` | Ethereum key utilities |
| `uuid` | UUID generation for protocol message IDs |
Core libraries governing identity management use pinned, well-tested versions to ensure stability and security.
### Key Storage and Isolation
Alskills/verified-agent-identity/README.md
# Verified Agent Identity
A decentralized identity management toolkit for AI agents using iden3 protocol on Billions Network.
## Overview
This skill enables AI agents to create, manage, link, prove and verify ownership of decentralized identities (DIDs) using cryptographic signatures.
## Installation
### Agent CTA:
1. Ask bot to install the skill:
```plaintext
Install the skill `npx clawhub@latest install verified-agent-identity`
```
Or
```plaintext
Install the `verified-agent-identity` skill from the OpenClaw clawhub.ai.
```
2. (Optional) If the verification process did not start automatically after installation, ask your bot to initialize the process by sending a message like:
```plaintext
Please link your agent identity to me.
```
### Human CTA:
1. Install the skill:
```bash
npx clawhub@latest install verified-agent-identity
```
2. Create a new identity:
```bash
# Generate a new key and create a new identity
node scripts/createNewEthereumIdentity.js
```
Or
```bash
# Use an existing private key to create an identity
node scripts/createNewEthereumIdentity.js --key <your-ethereum-private-key>
```
3. Generate a verification link to connect your human identity to the agent:
```bash
node scripts/manualLinkHumanToAgent.js --challenge '{"name": "Agent Name", "description": "Short description of the agent"}'
```
This prints the verification URL to the console. Open it in your browser to complete the identity linking process.
## Features
- **Identity Creation**: Generate new DIDs with random or existing Ethereum private keys
- **Identity Management**: List and manage multiple identities with default identity support
- **Human-Agent Linking**: Link a human identity to an agent's DID through signed challenges
- **Proof Generation**: Generate cryptographic proofs to authenticate as a specific identity
- **Proof Verification**: Verify proofs to confirm identity ownership
## Architecture
### Runtime Requirements
- **Node.js `>= v20`** and **npm** are required to run the scripts.
### Dependency Surface
npm dependencies are intentionally minimal and scoped to well-established, audited packages:
| Package | Purpose |
| ---------------------- | ------------------------------------------------------------ |
| `@0xpolygonid/js-sdk` | iden3/Privado ID cryptographic primitives and key management |
| `@iden3/js-iden3-core` | DID and identity core types |
| `@iden3/js-iden3-auth` | JWS/JWA authorization response construction and verification |
| `ethers` | Ethereum key utilities |
| `uuid` | UUID generation for protocol message IDs |
Core libraries governing identity management use pinned, well-tested versions to ensure stability and security.
### Key Storage and Isolation
Al_meta.json
{
"ownerId": "kn75zd0xs7ecy5z0pr1fjpdp6n85r9sy",
"slug": "verifiedagentidentity",
"version": "1.0.0",
"publishedAt": 1777438967104
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/nopalempl/skills/verifiedagentidentity",
"sourceUrl": "https://clawhub.ai/nopalempl/skills/verifiedagentidentity",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T13:22:20.283Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-nopalempl-verifiedagentidentity/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-nopalempl-verifiedagentidentity/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T13:22:20.283Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/nopalempl/verifiedagentidentity",
"sourceUrl": "https://clawhub.ai/nopalempl/verifiedagentidentity",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T13:22:20.283Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.0",
"href": "https://clawhub.ai/nopalempl/verifiedagentidentity",
"sourceUrl": "https://clawhub.ai/nopalempl/verifiedagentidentity",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-29T05:02:47.104Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-nopalempl-verifiedagentidentity/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-nopalempl-verifiedagentidentity/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.0",
"description": "verified-agent-identity v1.0.0 - Initial release of the Billions decentralized identity skill for agents - Enables agents to create, manage, and link Billions DIDs to human identities via ERC-8004 and attestation registries - Provides scripts for identity creation, challenge/response, linking, and verification - Stores all identity data under $HOME/.openclaw/billions for OpenClaw compatibility - Enforces strict operational and security guardrails to protect private keys and prevent manual cryptographic manipulation",
"href": "https://clawhub.ai/nopalempl/verifiedagentidentity",
"sourceUrl": "https://clawhub.ai/nopalempl/verifiedagentidentity",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-29T05:02:47.104Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
