Газ-станция и автозаправка

В блокчейнах с моделью газа, чтобы отправить токен, мало иметь на балансе сам переводимый актив — нужно ещё чем-то заплатить сетевую комиссию (gas). В таких сетях комиссия платится отдельным базовым активом: ETH в Ethereum, BNB в BNB Chain и т. д., а токены (например, USDT) живут «поверх» него. Если вы держите на адресе только токен, но базового актива на нём нет, сеть не примет перевод — платить за газ нечем.

Газ-станция решает эту проблему автоматически. Это назначенный vault, который выступает источником базового актива для остальных vault'ов того же workspace: когда на адресе заканчивается газ, газ-станция переводит туда базовый актив, и транзакция пользователя проходит без ручного вмешательства. По смыслу это аналог Gas Station у Fireblocks.

Где применима

Газ как отдельная сущность есть не во всех блокчейнах, поэтому газ-станция применима только к сетям с моделью газа.

• Сети с газом (EVM-совместимые: Ethereum и другие EVM-сети) — комиссия за перевод токена платится отдельным базовым активом, поэтому газ может закончиться независимо от баланса токена. Здесь газ-станция и нужна.
• Остальные сети — газа как отдельной сущности нет: комиссия удерживается из самого перевода (UTXO-сети вроде Bitcoin) либо оплачивается по иной модели (например, ресурсы energy/bandwidth в TRON). Доливать нечего, и газ-станция к таким сетям не применяется.

Mainnet и testnet

Газ-станция работает и в mainnet-, и в testnet-воркспейсах. Набор валют в настройках всегда соответствует сети воркспейса: mainnet-воркспейс видит и настраивает только mainnet-активы, testnet-воркспейс — только их testnet-аналоги (например, ETH в Sepolia). Для testnet-активов действуют свои значения по умолчанию.

Валюта чужой сети недоступна в обе стороны:

• запрос её конфигурации (GET /gas_station/{cid}) отвечает 404 (GAS_STATION_NOT_FOUND);
• попытка задать ей конфигурацию (PUT) отклоняется с 400 и кодом GAS_STATION_NETWORK_MISMATCH.

Модель

Параметры заправки

Поведение заправки настраивается отдельно для каждого базового актива (каждой сети). Три параметра задают, когда и насколько пополнять газ. В таблице — названия как в консоли и соответствующие им поля API:

Значения передаются и хранятся как целые числа в минимальных единицах актива (wei и т. п.) в виде строк — чтобы не терять точность на больших числах. Должно выполняться cap ≥ threshold > 0.

Семантика max_gas_price

Если из-за высокой комиссии заправка не проходит, это не ошибка конфигурации: средства на станции есть, но сеть сейчас слишком дорогая. Достаточно повторить операцию позже, когда комиссии упадут.

Значения по умолчанию

Для поддерживаемых базовых активов на платформе заданы дефолтные параметры заправки. Они применяются автоматически в момент назначения газ-станции или включения автозаправки — для каждого актива, по которому в vault'е газ-станции есть кошелёк, и затем могут быть переопределены вручную. Если для актива дефолтов нет, заправка по нему просто пропускается, пока вы не зададите cap и threshold явно.

Конкретные текущие значения по сетям — на отдельной странице Значения по умолчанию.

Жизненный цикл настройки

1. Назначить газ-станцию. Один vault workspace'а помечается как источник газа. При этом для каждого его базового актива создаются per-asset конфигурации со значениями по умолчанию.
2. Включить автозаправку на тех vault'ах, газ которых нужно пополнять автоматически. Включение тоже досоздаёт недостающие per-asset конфигурации по дефолтам.
3. При необходимости — переопределить параметры («Порог», «Лимит баланса», «Комиссия за газ») для конкретного актива.

После этого никаких ручных действий не требуется: пополнение газа происходит само в момент создания транзакций — см. Как работает автозаправка.

Управление через API

Все операции выполняются в контексте текущего workspace (заголовок X-Workspace-Id). Точные схемы запросов и ответов — в справочнике API.

Действия с газ-станцией фиксируются в журнале аудита: назначение станции, включение и выключение автозаправки, изменение per-asset конфигураций.