Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

verified-agent-identity — Claude Code skill: DID and x402 payments

This skill gives an agent an Ethereum DID on the Billions Network and a way through 402 Payment Required responses. Use it when an agent has to prove who owns it or pay for API access.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add BillionsNetwork/verified-agent-identity --skill verified-agent-identity -a claude-code
Open on GitHub

What verified-agent-identity does

The skill covers two jobs: decentralized identity and x402 payment. It creates an Ethereum DID on the Billions Network, links that identity to a human owner through ERC-8004 and the Attestation Registries, and proves ownership by signing a challenge. The second path starts when a server returns 402 Payment Required, where the skill builds a signed PAYMENT-SIGNATURE header so the request can be retried.

Under the hood it acts as a router. The agent loads reference/identity/SKILL.md or reference/x402/SKILL.md for the task at hand, then runs scripts from scripts/ after npm install. Node is the binary it needs. Identity state sits in $HOME/.openclaw/billions, including kms.json, defaultDid.json and challenges.json.

kms.json holds private keys, encrypted only when BILLIONS_NETWORK_MASTER_KMS_KEY is set. Set that variable before the first run and chmod 700 ~/.openclaw/billions right after it. The skill closes off improvisation too: a non-zero exit code stops the run, and minting keys by hand with openssl or ssh-keygen is out of bounds.

What it helps with

  • create a DID and link it to a human owner
  • prove identity ownership with a signed challenge
  • build a PAYMENT-SIGNATURE header and retry a 402 response
  • list existing identities before running signing scripts
  • lock the key directory down with chmod 700

Example prompts for the agent

  • Create a Billions identity for me and link it to my account, start with `node scripts/getIdentities.js`.
  • The API answered 402 Payment Required, build the `PAYMENT-SIGNATURE` with `buildX402Payment.js` and retry the request.
  • Check that my DID is linked to an owner, then sign the challenge stored in `challenges.json`.

How to install verified-agent-identity

1Skills CLI (Vercel)

npx skills add BillionsNetwork/verified-agent-identity --skill verified-agent-identity -a claude-code

2Manually: put the files in place

~/.claude/skills/verified-agent-identity/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/verified-agent-identity/

Similar

secure-workflow-guide trailofbits Guides smart contracts through Trail of Bits' 5-step security audit on check-in or before deployment. It runs static analysis, generates visual charts, and prepares fuzzing tests. Claude Code CX Codex Cursor +1 7,400installs threat-model-analyst official github Runs STRIDE-A threat modeling for a repository or system. It can also update an earlier report against the current code or a chosen commit. GitHub Copilot 1,500installs agent-owasp-compliance official github Checks an AI agent codebase against the 10 OWASP ASI risks. Use it before production deployment, for security review, or when preparing an audit report. GitHub Copilot 1,500installs email-and-password-best-practices better-auth Configures email verification, password reset flows, and password policies in Better Auth. Helpful when adding credential authentication to your backend. Claude Code CX Codex Cursor +1 46,600installs labarchive-integration K-Dense-AI This skill guides work with LabArchives ELN API and Inventory API v1, including regional endpoints, request signing, and local request planning. Claude Code CX Codex Cursor +1 1,900installs pymatgen K-Dense-AI Analyzes, validates, converts, and transforms materials structures and computed data with pymatgen. Use it for phase diagrams, symmetry checks, electronic-structure files, and bounded Materials Project queries. Claude Code CX Codex Cursor +1 1,900installs git-guardrails-claude-code Matt Pocock This skill adds a Claude Code hook that stops risky Git commands before they run. Use it when an agent must not push or discard working-tree changes. Claude Code 499,069installs ponytail-review DietrichGebert ponytail-review reviews a change beyond the diff, checking connected code, bugs, risks, load, tests, speed, and unnecessary code. Use it for PRs and commits. Claude Code CX Codex Cursor +1 56,300installs

Questions about verified-agent-identity

How do I install verified-agent-identity in Claude Code?

Run npx skills add BillionsNetwork/verified-agent-identity --skill verified-agent-identity -a claude-code. The skill file ends up at ~/.claude/skills/verified-agent-identity/SKILL.md.

What does verified-agent-identity do?

It creates Ethereum DIDs on the Billions Network, links them to a human owner via ERC-8004 and the Attestation Registries, and signs challenges to prove ownership. It also builds the signed header needed to get past a 402 Payment Required response.

What does the skill need to run?

Node, plus npm install inside scripts/. BILLIONS_NETWORK_MASTER_KMS_KEY is optional, though without it the private keys in kms.json stay in plaintext.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor