Изменения

Изменения, важные для вашей интеграции, новые сверху. Со временем могут появляться новые поля и типы событий: принимайте и те, которых не знаете.

Октябрь 2026

• Новое имя: компания — Portuna, продукт — Portuna Sweep. Вебхуки приходят с заголовками Portuna-Signature, Portuna-Event и Portuna-Delivery и User-Agent: portuna-webhooks/1. Новые API-ключи начинаются с ptn_test_ и ptn_live_, выпущенные раньше продолжают работать. Пакет на TypeScript — @portuna/sdk, пакет на Go — portuna.
• Коды причин: reason задания на sweep и снятия делегации и error горячего кошелька — стабильные коды, например insufficient_gas_balance или chain_unavailable, а не сообщения самой ноды; error баланса в сети — chain_unavailable. Все коды — в Статусах, подтверждениях и реоргах.
• Время в UTC: всё время в API и вебхуках — RFC 3339 в UTC, с Z.
• SDK: списки, статистика по дням, журнал доставки и тестовые события — с обходом всех страниц, и событие webhook.test.
• Списки и отчёты: GET /v1/sweeps, GET /v1/revocations, GET /v1/ledger, GET /v1/usage и GET /v1/webhook/deliveries, а также событие webhook.test по запросу POST /v1/webhook/test.
• API-ключи: у организации может быть несколько ключей; отозванный ключ сразу получает 401, отключённый аккаунт — 403 partner_disabled.
• Тестнеты: API доступен в Sepolia и BSC testnet, вместе с SDK на Go и TypeScript.