Горячие кошельки

Горячие кошельки (котлы) получают сметённые средства. Регистрация кошелька разворачивает его делегат — контракт, который авторизуют депозитные адреса.

Список горячих кошельков

GET/v1/hot-wallets

Ответы

Код	Описание
`200`	Горячие кошельки партнёра во всех сетях. Возвращает поля ниже.
`401`	`unauthorized` — нет API-ключа, он неизвестен или отозван.
`403`	`partner_disabled` — аккаунт партнёра отключён.

Тело ответа

Поле	Тип	Описание
`hot_wallets` обязательно	массив HotWallet

Пример запроса

curl "https://api-testnet.portuna.io/v1/hot-wallets" \
  -H "Authorization: Bearer $PORTUNA_API_KEY"

Пример ответа

{
  "hot_wallets": [
    {
      "chain_id": 11155111,
      "address": "0x2Cd50979a8A33e8CA37DA85F8517fb148a67b769",
      "delegate": "0xE60fdf70a794C76094f86b990a821D55e3096AA5",
      "status": "active",
      "tx_hash": "0x98c1caadf3d6613c07b43c53148e6cc543c7d933fc9d0a4ea590988ab526716d",
      "created_at": "2026-10-10T09:14:03Z"
    }
  ]
}

Зарегистрировать горячий кошелёк

POST/v1/hot-wallets

Регистрирует горячий кошелёк в сети и разворачивает его делегат — контракт, на который депозитные адреса подписывают авторизацию. Адрес делегата, поле delegate, известен сразу. Когда делегат развёрнут, кошелёк становится active и приходит событие hot_wallet.active; если развернуть не удалось — hot_wallet.failed. Повторная регистрация того же кошелька возвращает его, а после failed (например, на газ-кошельке не было газа) перезапускает развёртывание.

Тело запроса

Поле	Тип	Описание
`chain_id` обязательно	ChainID	Идентификатор сети (EIP-155): `11155111` Sepolia и `97` BSC testnet с тестовым ключом, `1` Ethereum и `56` BSC с боевым.
`address` обязательно	Address	Горячий кошелёк, куда sweep будут переводить средства.

Ответы

Код	Описание
`200`	Горячий кошелёк уже активен. Возвращает HotWallet.
`202`	Делегат разворачивается. Возвращает HotWallet.
`400`	`invalid_json` — тело не JSON, больше 64 КиБ или в нём неизвестные поля.
`401`	`unauthorized` — нет API-ключа, он неизвестен или отозван.
`403`	`partner_disabled` — аккаунт партнёра отключён.
`422`	`unknown_chain` — сеть не поддерживается в этом окружении; `invalid_address` — `address` не ненулевой `0x`-адрес.

Пример запроса

curl -X POST "https://api-testnet.portuna.io/v1/hot-wallets" \
  -H "Authorization: Bearer $PORTUNA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 11155111,
  "address": "0x2Cd50979a8A33e8CA37DA85F8517fb148a67b769"
}'

Пример ответа

{
  "chain_id": 11155111,
  "address": "0x2Cd50979a8A33e8CA37DA85F8517fb148a67b769",
  "delegate": "0xE60fdf70a794C76094f86b990a821D55e3096AA5",
  "status": "pending",
  "created_at": "2026-10-10T09:14:03Z"
}