# ИИ-агенты: ресурсы TRON по x402

> Энергия, отправка транзакций и доступ к ноде для агентов с оплатой USDC в Base за вызов. Без регистрации и ключей.

Агент, которому нужно перевести USDT или вызвать контракт в TRON, получает ресурс у AwesomeFee за один HTTP-обмен и
платит USDC в сети Base по протоколу [x402](https://x402.org) (версия 2). Без регистрации, ключа API и баланса у нас.
Плательщик подписывает разрешение на перевод USDC (EIP-3009) и не платит газ; отправителю в TRON не нужен TRX.

API: `https://api.awesomefee.com` · [OpenAPI](https://api.awesomefee.com/openapi.yaml) · [llms.txt для агентов](/agents/llms.txt) ·
[Навык (SKILL.md)](/agents/SKILL.md) · [Всё одним файлом](/agents/llms-full.txt) (тексты для агентов — на английском)

## Как это работает

1. **Найти:** `GET https://api.awesomefee.com/v1/search?q=<что нужно>` — бесплатно; в ответе записи каталога (`id`, `method`, `url`, `parameters`, `price`, `payment`: free | x402 | pass, пример `curl`); без `q` — весь каталог.
2. **Вызвать** адрес клиентом x402 v2 (`@x402/fetch`, `@x402/axios`, Python `x402`).
3. **На 402** клиент оплачивает условия в USDC со своего кошелька агента и повторяет запрос.
4. **Получить результат.**

## Что продаём

| Эндпоинт | Что получает агент | Оплата |
|---|---|---|
| `GET /v1/search?q=` | адрес продукта под задачу, метод, входные данные и цена — начинать отсюда | бесплатно |
| `GET /x402/v1/quote` | цена энергии или отправки (с `burn_equivalent`), тарифы пропусков | бесплатно |
| `POST /x402/v1/tron/estimate` | энергия и полоса транзакции, что уже есть у отправителя, чего не хватает, цена | бесплатно |
| `GET /x402/v1/address/{address}` | расход и сожжённый TRX адреса за 7 дней | бесплатно |
| `POST /x402/v1/tron/send` | **отправка с энергией**: агент присылает подписанную транзакцию, мы делегируем отправителю недостающую энергию, отправляем транзакцию без изменений и отвечаем `txid` и блоком | x402 |
| `POST /x402/v1/tron/energy` | энергия на любой адрес на 1000 блоков (~50 мин) | x402 |
| `POST /x402/v1/proxy/pass` | пропуск авансом: отправка через наш Proxy (`/proxy/wallet/broadcasttransaction`), энергия перед каждой транзакцией привязанных отправителей по цене для агентов | x402 |
| `POST /x402/v1/rpc/pass` | пропуск авансом на чтение полной ноды TRON по `/rpc` (TronWeb `fullHost` + `TRON-PRO-API-KEY`), вся история | x402 |
| `POST /x402/v1/events/sub` | пропуск авансом на события адресов TRON: переводы, делегации, расход ресурсов; вебхук или WebSocket по `/v1/events` | x402 |
| `GET /x402/v1/pass` | остаток пропуска (`Authorization: Bearer <токен>`) | бесплатно |
| `GET /x402/v1/payments/{id}` | состояние оплаченного заказа и возврата | бесплатно |

`tier` — имя тарифа или его цена в USDC. Ответ: `pass_id`, `token` (`tlp_…`, сохраните), `tier`, `unit`,
`added_credits`, `expires_at`, `limits`, `rpc_url` или `events_url`, `balance_url`. Повторная покупка с токеном в
`Authorization: Bearer` пополняет пропуск. Всё, что продаём: `GET /x402/v1`.

## Цены

- **Цена для агентов** — распродажная: в USDC по живому курсу TRX/USD, известна до оплаты (`GET /x402/v1/quote`).
- В каждой котировке есть **`burn_equivalent_sun`** и **`burn_equivalent_usd`** — сколько отправитель сжёг бы без нас
  (100 SUN за единицу энергии; перевод USDT — около 64 285 энергии, на адрес без USDT — около 130 285).
- Котировка, оценка транзакции, анализ адреса, остаток пропуска и состояние заказа — бесплатно.
- Чтение ноды: кредиты за вызов (1 за обычный, 2–10 за тяжёлый); события: 1 кредит за доставленное событие.

## Тарифы пропусков

| Пропуск | Тариф (имя или USDC) | Что входит | Дней |
|---|---|---|---|
| Чтение ноды | rpc-trial · rpc-s · rpc-m · rpc-l · rpc-xl (0,5 · 9 · 35 · 120 · 300) | 50 000 · 1M · 5M · 20M · 60M кредитов; 5 · 10 · 25 · 50 · 100 rps | 7 для 0,5, иначе 30 |
| События адресов | ev-s · ev-m · ev-l (3 · 15 · 60) | 10 · 100 · 1 000 адресов; 200 000 · 2M · 10M событий | 30 |
| Proxy | proxy-5 · proxy-20 · proxy-100 (5 · 20 · 100) | кредиты в USDC; энергия на каждую транзакцию до 5 привязанных отправителей по цене для агентов | 30 |

## Цикл оплаты

```text
агент → POST https://api.awesomefee.com/x402/v1/tron/send   {"signed_tx": {…}}
      ← 402  PAYMENT-REQUIRED: base64 {"x402Version":2,"accepts":[{"scheme":"exact","network":"eip155:8453",
                                       "amount":"<USDC, 6 знаков>","asset":"<USDC>","payTo":"0x…", …}]}
агент подписывает одну запись "accepts" своим кошельком (EIP-3009, без газа)
агент → POST https://api.awesomefee.com/x402/v1/tron/send   {"signed_tx": {…}}  + PAYMENT-SIGNATURE: base64 PaymentPayload
      ← 200  {"status":"confirmed","txid":"…","block":…,"result":"SUCCESS","energy_used":64285,"energy_burned_sun":0}
             (202 {"status":"pending","status_url":"…/x402/v1/payments/xp_…"} — оплачено, ещё выполняется)
             PAYMENT-RESPONSE: base64 {"success":true,"transaction":"0x…","network":"eip155:8453","payer":"0x…"}
```

Это делает любой клиент x402 v2: `@x402/fetch`, `@x402/axios`, Python `x402`. Примеры:
[curl](/agents/examples/curl.sh) (с [подписчиком](/agents/examples/sign-x402.mjs)),
[@x402/fetch](/agents/examples/x402-fetch.mjs), [@x402/axios](/agents/examples/x402-axios.mjs),
[Python](/agents/examples/x402_requests.py).

## Отказы и возвраты

- Проверяется **до** 402, ничего не списывается: просроченная транзакция, вызов, который откатится, тип вне списка
  (TRX, TRC-20 и вызовы контрактов, TRC-10), неактивированный отправитель, больше 300 000 энергии, нехватка собственной
  полосы отправителя (полосу пока не продаём), нет ёмкости, лимит частоты.
- Оплачено, но не выполнено по нашей вине — USDC автоматически возвращается плательщику.
- Выполнено, но транзакция агента откатилась в сети — возврата нет: ресурс израсходован.
- Повтор с той же оплатой возвращает тот же ответ.

## Как агенты нас находят

- MCP-сервер: `https://api.awesomefee.com/mcp` — один инструмент `search` и эти описания как ресурсы, см. [MCP-сервер](/docs/ru/agents/mcp/).
- `https://api.awesomefee.com/.well-known/x402` — манифест x402; `https://api.awesomefee.com/.well-known/ai-catalog.json` и `https://api.awesomefee.com/mcp/server-card` —
  обнаружение MCP.
