# x402-payments

Скилл для агентов, который помогает закрыть HTTP-ресурсы оплатой в HBAR по схеме x402: 402-ответ, подпись перевода, проверка и расчёт через свой фасилитатор.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 462 установки · ★ 28
- Автор: hedera-dev
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hedera-dev/hedera-skills/tree/HEAD/plugins/native-services-js/skills/x402-payments/SKILL.md
- Обновлён: 2026-09-03
- HTML: https://affpapa.org/nevibecode/skills/x402-payments

## Что делает

Скилл описывает шаблон pay-per-use: сами данные лежат вне сети, условия доступа хранятся отдельно, а HTTP-ресурс отдаётся только после оплаты. Покупатель получает 402 с заголовком `PAYMENT-REQUIRED`, подписывает перевод HBAR и повторяет запрос с `PAYMENT-SIGNATURE`. Сервер проверяет платёж и рассчитывает его через фасилитатор, после чего возвращает ресурс и `PAYMENT-RESPONSE`.

Внутри — инструкции по сборке серверной части на `@x402/core` со схемой `ExactHederaScheme`, клиентского цикла с повторным запросом и самохостингового фасилитатора с эндпоинтами `GET /supported`, `POST /verify`, `POST /settle`, `GET /health`. Отдельные файлы в `references/` дают примеры кода для сервера и клиента, переменные окружения и семантику расчёта. Для кошелька подойдёт ECDSA-аккаунт Hedera, например HashPack через WalletConnect.

Заранее нужен профинансированный ECDSA-аккаунт фасилитатора: `FACILITATOR_ACCOUNT_ID` и `FACILITATOR_PRIVATE_KEY` лежат в процессе фасилитатора, а не в сервере ресурсов. Суммы задаются в tinybars, ассет — `0.0.0`, и клиент с сервером должны смотреть на одну сеть вроде `hedera:testnet`. Если положить ключ фасилитатора в сервер ресурсов, вся схема с разделением ролей ломается — это первое, что стоит проверить перед запуском.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hedera-dev/hedera-skills --skill x402-payments -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/x402-payments/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/x402-payments/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hedera-dev/hedera-skills --skill x402-payments -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/x402-payments/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hedera-dev/hedera-skills --skill x402-payments -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/x402-payments/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install hedera-dev/hedera-skills x402-payments
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/x402-payments/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add hedera-dev/hedera-skills --skill x402-payments -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/hedera-dev/hedera-skills --path plugins/native-services-js/skills/x402-payments
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/x402-payments/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add hedera-dev/hedera-skills --skill x402-payments -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/hedera-dev/hedera-skills/tree/HEAD/plugins/native-services-js/skills/x402-payments/SKILL.md

## Когда брать
- отдавать защищённый файл только после оплаты в HBAR
- поднять свой фасилитатор с проверкой и расчётом платежей
- собрать серверный цикл с 402-ответом и повторным запросом
- подключить кошелёк через WalletConnect для подписи перевода
- перевести цены в tinybars без ошибок округления

## Примеры запросов агенту
- Помоги закрыть эндпоинт оплатой в HBAR через x402
- Настрой фасилитатор Hedera с verify и settle
- Сделай клиентский retry с PAYMENT-SIGNATURE после 402

## Похожие
- [okx-agent-payments-protocol](https://affpapa.org/nevibecode/skills/okx-agent-payments-protocol.md) — скилл · 13700 установок
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7506
- [pay-with-app](https://affpapa.org/nevibecode/skills/pay-with-app.md) — скилл · 524 установки
- [stripe-payments](https://affpapa.org/nevibecode/skills/jezweb-stripe-payments.md) — скилл · 1100 установок
- [x402](https://affpapa.org/nevibecode/skills/x402.md) — скилл · 1300 установок
- [pluggy-payments](https://affpapa.org/nevibecode/skills/pluggy-payments.md) — скилл · 386 установок

Из того же набора: [hedera-dev/hedera-skills](https://affpapa.org/nevibecode/by/hedera-dev/hedera-skills.md) — 13 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md