Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
billionsnetwork avatar

Verified Agent Identity

  • 8.2k installs
  • 754 repo stars
  • Updated May 18, 2026
  • billionsnetwork/verified-agent-identity

verified-agent-identity is an agent skill that Know Your Agent (KYA). Billions decentralized identity for agents. Link agents to human identities using Billions ERC-8004 and Attestation Registries. Verify an.

About

Know Your Agent (KYA). 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. --- name: verified-agent-identity description: Know Your Agent (KYA). 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 This skill covers two capabilities. Read the **router table** below, then load the relevant reference before proceeding. | Situation | Reference to load | | ----------------------------------------------------------------------- | ----------------------------- | | Create, list, link, verify, or sign with a decentralized identity (DID) | `reference/identity/SKILL.md` | | Handle a **402 Payment Required** HTTP response | `reference/x402/SKILL.

  • **Identity** - Create Ethereum-based DIDs on the Billions Network, link them to a human owner, and prove ownership via
  • **x402 Payment** - When a server returns `402 Payment Required`, build a signed `PAYMENT-SIGNATURE` header so you can
  • **STRICT: Check Identity First**
  • Before running `linkHumanToAgent.js`, `signChallenge.js`, or `buildX402Payment.js`, **ALWAYS** check if an identity exis
  • If no identity is configured, create one first with `createNewEthereumIdentity.js` after that run `linkHumanToAgent.js`

Verified Agent Identity by the numbers

  • 8,157 all-time installs (skills.sh)
  • +1 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #207 of 2,153 Testing & QA skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

verified-agent-identity capabilities & compatibility

Capabilities
**identity** — create ethereum based dids on the · **x402 payment** — when a server returns `402 pa · **strict: check identity first** · before running `linkhumantoagent.js`, `signchall · if no identity is configured, create one first w
Use cases
documentation
From the docs

What verified-agent-identity says it does

--- name: verified-agent-identity description: Know Your Agent (KYA).
SKILL.md
Billions decentralized identity for agents.
SKILL.md
Link agents to human identities using Billions ERC-8004 and Attestation Registries.
SKILL.md
Verify and generate authentication proofs.
SKILL.md
npx skills add https://github.com/billionsnetwork/verified-agent-identity --skill verified-agent-identity

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs8.2k
repo stars754
Security audit0 / 3 scanners passed
Last updatedMay 18, 2026
Repositorybillionsnetwork/verified-agent-identity

What problem does verified-agent-identity solve for developers using this skill?

Know Your Agent (KYA). Billions decentralized identity for agents. Link agents to human identities using Billions ERC-8004 and Attestation Registries. Verify and generate authentication proofs. Based

Who is it for?

Developers who need verified-agent-identity patterns described in the cached skill documentation.

Skip if: Skip when docs are empty or the task is outside the skill's documented scope.

When should I use this skill?

Know Your Agent (KYA). Billions decentralized identity for agents. Link agents to human identities using Billions ERC-8004 and Attestation Registries. Verify and generate authentication proofs. Based

What you get

Actionable workflows and conventions from SKILL.md for verified-agent-identity.

  • Agent DIDs
  • Attestation links
  • Signed KYA proofs

Files

reference/identity/SKILL.mdMarkdownGitHub ↗

Identity Reference

Manage decentralized identities (DIDs) on the Billions Network — create, list, link to a human owner, and verify ownership.

When to Use

  • You need to create a new agent identity.
  • You need to link your agent identity to a human owner.
  • You need to sign a challenge to prove identity ownership.
  • You need to verify someone else's identity.
  • You need to list existing local identities.

Scripts

createNewEthereumIdentity.js

Command: node scripts/createNewEthereumIdentity.js [--key <privateKeyHex>]

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.

# Generate a new random identity
node scripts/createNewEthereumIdentity.js

# Create identity from existing private key
node scripts/createNewEthereumIdentity.js --key 0x1234567890abcdef...

Output: DID string (e.g., did:iden3:billions:main:2VmAk7fGHQP5FN2jZ8X9Y3K4W6L1M...)

---

getIdentities.js

Command: node scripts/getIdentities.js

Lists all DID identities stored locally. Always run this before any signing or linking operation.

node scripts/getIdentities.js

Output: JSON array of identity entries

[
  {
    "did": "did:iden3:billions:main:2VmAk...",
    "publicKeyHex": "0x04abc123...",
    "isDefault": true
  }
]

---

linkHumanToAgent.js

Command: node scripts/linkHumanToAgent.js --challenge <challenge> [--did <did>]

Signs the challenge and links a human user to the agent's DID by creating a verification request. Uses the Billions ERC-8004 Registry (agent registration) and the Billions Attestation Registry (ownership attestation after verifying human uniqueness).

  • --challenge — (required) Challenge to sign. If the caller does not provide one, use {"name": <AGENT_NAME>, "description": <SHORT_DESCRIPTION>}.
  • --did — (optional) Uses the default DID if omitted.
node scripts/linkHumanToAgent.js --challenge '{"name": "MyAgent", "description": "AI persona"}'

Output: {"success":true}

---

generateChallenge.js

Command: node scripts/generateChallenge.js --did <did>

Generates a random challenge for identity verification. Stores the challenge in $HOME/.openclaw/billions/challenges.json.

node scripts/generateChallenge.js --did did:iden3:billions:main:2VmAk...

Output: Challenge string (e.g., 8472951360)

---

signChallenge.js

Command: node scripts/signChallenge.js --challenge <challenge> [--did <did>]

Signs a challenge with a DID's private key to prove identity ownership and sends the JWS token.

  • --challenge — (required) Challenge to sign.
  • --did — (optional) Uses the default DID if omitted.
node scripts/signChallenge.js --challenge 8472951360

Output: {"success":true}

---

verifySignature.js

Command: node scripts/verifySignature.js --did <did> --token <token>

Verifies a signed challenge to confirm DID ownership.

node scripts/verifySignature.js --did did:iden3:billions:main:2VmAk... --token eyJhbGciOiJFUzI1NkstUi...

Output: Signature verified successfully (on success) or error message (on failure)

---

Workflows

Link Your Agent Identity to an Owner

1. Check for existing identity: node scripts/getIdentities.js

  • If none exists → node scripts/createNewEthereumIdentity.js

2. Run: node scripts/linkHumanToAgent.js --challenge <challenge_value>

  • Use caller's challenge if provided, otherwise use {"name": <AGENT_NAME>, "description": <SHORT_DESCRIPTION>}.

3. Return the result to the caller.

Example Conversation:

User: "Link your agent identity to me"
Agent: [runs getIdentities.js, confirms identity exists]
Agent: [runs linkHumanToAgent.js --challenge '{"name": "MyAgent", "description": "Coding assistant"}']
Agent: "Done — here's the verification link: ..."

Verify Someone Else's Identity

1. Ask: "Please provide your DID to start verification." 2. Generate challenge: node scripts/generateChallenge.js --did <user_did> 3. Ask user to sign: "Please sign this challenge: <challenge_value>" 4. Verify: node scripts/verifySignature.js --did <user_did> --token <user_token> 5. Report result.

Example Conversation:

Agent: "Please provide your DID to start verification."
User: "My DID is did:iden3:billions:main:2VmAk..."
Agent: [runs generateChallenge.js] → "Please sign this challenge: 789012"
User: [provides token]
Agent: [runs verifySignature.js] → "Identity verified. You are confirmed as owner of that DID."

Related skills

FAQ

What does verified-agent-identity do?

Know Your Agent (KYA). 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-sovere

When should I use verified-agent-identity?

Know Your Agent (KYA). 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-sovere

Is verified-agent-identity safe to install?

Review the Security Audits panel on this page before installing in production.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.