SkillFoxx
Telegram

Verified Agent Identity — скилл

Скилл дает агенту децентрализованный идентификатор DID на сети Billions и связывает его с владельцем через подпись.

  • 758 ★ репозитория
  • Последний коммит
Скилл

Широкий доступ

Почему такой уровень

  • Скилл создает и хранит закрытые ключи Ethereum на диске; без мастер-ключа они лежат открытым текстом.
  • Скрипт `buildX402Payment.js` подписывает платежи, то есть агент может тратить деньги с привязанного ключа.
  • Подписанное подтверждение личности агента уходит внешним сервисам, поэтому важно задать ограничение домена и согласие пользователя.
Все причины и проверки

billionsnetwork/verified-agent-identityАвтор:Billions Network

Установка

Работает в

В терминале, через SkillFoxx CLI

npx skillfoxx add skills/verified-agent-identity

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Скилл создает и хранит закрытые ключи Ethereum на диске; без мастер-ключа они лежат открытым текстом.
  • Скрипт `buildX402Payment.js` подписывает платежи, то есть агент может тратить деньги с привязанного ключа.
  • Подписанное подтверждение личности агента уходит внешним сервисам, поэтому важно задать ограничение домена и согласие пользователя.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Verified Agent Identity создает для ИИ-агента децентрализованный идентификатор (DID) на протоколе iden3 в сети Billions Network. Агент подписывает запросы-вызовы своим ключом, а проверяющий убеждается, что подпись принадлежит этому DID. Скилл создает личность из нового или имеющегося ключа Ethereum, хранит список личностей и умеет назначить одну из них личностью по умолчанию. Человека привязывают к агенту через подписанное подтверждение: скрипт `manualLinkHumanToAgent.js` печатает ссылку для проверки, и после открытия ее в браузере связь записывается. Отдельный справочник `reference/x402` описывает оплату ответов с кодом 402: скрипт сначала показывает варианты платежа, а подписывает выбранный только на втором шаге. Ключи лежат в `$HOME/.openclaw/billions`, при заданной переменной `BILLIONS_NETWORK_MASTER_KMS_KEY` шифруются AES-256-GCM.

Для кого. Разработчикам агентов на OpenClaw, которым нужна проверяемая личность агента и привязка к реальному владельцу.

Подходит, если

  • Агент должен доказать сервису, что он тот самый агент конкретного владельца.
  • Для внешнего API надо получить и проверить подпись под одноразовым запросом-вызовом.
  • Человека предстоит привязать к DID агента по ссылке проверки.
  • Агенту нужно оплатить ответ платного ресурса по протоколу x402.
  • Нужно просмотреть документ DID и список личностей агента.

Не подходит, если

  • Ключ Ethereum от кошелька с деньгами: для скилла нужен отдельный ключ личности.
  • Агент работает без Node.js 20 и новее: все сценарии идут через скрипты `node`.
  • Нельзя хранить ключи на диске агента или обращаться к `resolver.privado.id`, `billions.network` и `polygonid.me`.

Пример запроса к агенту

Создай для себя новую личность и покажи ссылку для привязки меня как владельца. Платежи по x402 без моего подтверждения не выполняй.

Ограничения

Нужен Node.js 20 и новее, а перед работой в папке `scripts` выполняют `npm install`. Без `BILLIONS_NETWORK_MASTER_KMS_KEY` закрытые ключи в `kms.json` лежат открытым текстом; при утрате мастер-ключа зашифрованные записи не восстановить. Права на каталог стоит закрыть командой `chmod 700 ~/.openclaw/billions`. В `--key` передают только отдельный ключ личности, ключ кошелька с активами недопустим. Сетевые вызовы идут к `resolver.privado.id`, `billions.network` и `polygonid.me`. Файл лицензии в репозитории не указан. Последний коммит сделан в сентябре 2026 года.

Как отключить. Удалите скилл из каталога агента. Каталог `$HOME/.openclaw/billions` с ключами и личностями удаляйте отдельно, предварительно сохранив мастер-ключ, если ключи еще нужны.

Частые вопросы

Как поставить Verified Agent Identity?

Через clawhub: `npx clawhub@latest install verified-agent-identity`. Через skills.sh: `npx skills add BillionsNetwork/verified-agent-identity`. Затем создайте личность командой `node scripts/createNewEthereumIdentity.js`.

Как привязать себя к агенту?

Выполните `node scripts/manualLinkHumanToAgent.js --challenge '{"name": "Agent Name", "description": "Short description of the agent"}'`. Скрипт напечатает ссылку, ее нужно открыть в браузере. Процесс запускается просьбой к агенту: «Please link your agent identity to me».

Где хранятся ключи?

В `$HOME/.openclaw/billions`, вне рабочей папки агента. Файл `kms.json` содержит ключи, `identities.json` метаданные, `challenges.json` историю запросов-вызовов. Мастер-ключ шифрования задает переменная окружения.

Как работает платеж x402?

Скрипт `buildX402Payment.js` на первом шаге запрашивает ресурс, получает ответ 402 и показывает варианты оплаты без подписи. На втором шаге по хэшу выбранного варианта он подписывает платеж и повторяет запрос. Каждый вызов дает новый одноразовый результат.

С какими сервисами скилл общается?

С `resolver.privado.id` для разрешения DID, с `billions.network` и `polygonid.me`. Другие домены в список разрешенных не входят. Подписанное подтверждение владельца передается дальше только с согласия пользователя.

Обсуждение

Вопросов и отзывов пока нет.

Скиллы

Скилл и локальная программа защиты агентов: учет, проверка новых скиллов, права от человека, подписанные записи действий.

СкиллШирокий доступ50
Официальный

Двадцать скиллов Didit для проверки личности: агент ведет KYC, сверку со списками санкций и биометрию через API

СкиллШирокий доступ28

agent-secrets выдает ИИ-агенту ключи на время: шифрование age, аренда секрета с TTL, журнал доступа и аварийный отзыв.

CLIШирокий доступ114

AgentGuard проверяет действия кодинг-агента до запуска и сканирует чужие скиллы на секреты, бэкдоры и промпт-инъекции.

ПлагинРасширенный доступ494

Официальный скилл Auth0: определяет фреймворк проекта и по шагам подключает аутентификацию через нужный SDK.

ПлагинРасширенный доступ58

Протокол подписанных полномочий для агентов: паспорт, делегирование с сужением прав и квитанции о каждом действии.

СкиллРасширенный доступ64

Коротко о README

README делит установку на сценарий для агента и для человека, перечисляет возможности и зависимости npm, описывает хранилище ключей, шифрование и политику сети. Угрозы и рекомендации для оператора вынесены в `SECURITY.md`.

Бейдж для README

Исходный SKILL.md

---
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.md`     |

> **Always read the appropriate reference SKILL.md before running any script.**
> If a task spans both (e.g. you need an identity before you can sign a 402 payment), read both.

## Quick Overview

- **Identity** — Create Ethereum-based DIDs on the Billions Network, link them to a human owner, and prove ownership via challenge/response signing.
- **x402 Payment** — When a server returns `402 Payment Required`, build a signed `PAYMENT-SIGNATURE` header so you can retry the request and gain access.

## Shared Setup

All identity data is stored in `$HOME/.openclaw/billions`. Scripts live in `scripts/`.

```bash
cd scripts && npm install && cd ..
```

## Restrictions / Guardrails (CRITICAL)

**These rules apply to ALL references. Always follow them.**

1. **STRICT: Check Identity First**

Сообщить о проблеме