Автовывод
Автовывод выводит деньги из кошелька Invoise без подтверждения каждого вывода. Для каждой сети вы задаёте порог; как только на кошельке в этой сети набирается столько, весь баланс сети уходит на один ваш внешний адрес. Транзакции подписывает ваш собственный сервер подписи, Invoise добавляет вторую подпись.
Как это работает
Заголовок раздела «Как это работает»Автовывод настраивается в кабинете: Кошелёк → Безопасность → Автоматизация вывода → Настроить. Каждое правило в блоке Правила по сетям задаёт:
- Из сети — сеть, баланс которой выводится. Одно правило на сеть.
- В сеть — куда уходят деньги. Можно указать ту же сеть, тогда мост не нужен.
- Токен — один из токенов, которые Invoise поддерживает в сети назначения.
- Порог в долларах — не меньше минимального вывода, не больше двух знаков после запятой.
Платежи в Tron и Solana приходят на кошелёк в Arbitrum (см. Solana и Tron), поэтому учитываются в правиле Arbitrum. Отдельного правила для Tron или Solana нет.
Когда на кошельке в исходной сети набирается хотя бы порог, Invoise выводит весь баланс этой сети, в каких бы стейблкоинах он ни был, за вычетом комиссии на Адрес получателя. Собственный баланс сети назначения остаётся на месте. Стейблкоин, который ни один мост не доставит в токен выплаты (например, USDT0 в Arbitrum при выплате в USDC в Base), сначала обменивается на USDC этой сети через Uniswap, затем USDC переводит CCTP Circle. Стейблкоин того же семейства, что и токен выплаты, идёт через Across, а правило, у которого сеть назначения совпадает с исходной, обменивает токены в этой сети, как обычный вывод. Комиссия такая же, как у вывода вручную.
Invoise проверяет правила каждую минуту и отправляет один автовывод за раз — по первому правилу, сеть которого набрала порог.
Ограничения
Заголовок раздела «Ограничения»| Настройка | Что значит |
|---|---|
| Не чаще | Без ограничения или раз в час, в 3, 6 или 12 часов, раз в сутки, раз в неделю. |
| Выключить после ошибок подряд | От 1 до 10, по умолчанию 3. После ошибки следующая попытка ждёт 5 минут, потом 30 минут, потом 2 часа. Уведомление приходит о первой ошибке подряд и о выключении автовывода. |
| Комиссия не больше | 0,5%, 1%, 2%, 3%, 5% или 10% от суммы, которая доходит до получателя; по умолчанию 1%. |
Предел комиссии считается по газу всех шагов. Если газ дороже, вывод из этой сети ждёт: кабинет показывает Ждёт комиссии с комиссией и суммой, и вывод уйдёт, когда баланс вырастет или газ подешевеет. Ожидание — не ошибка. Комиссии моста и обмена растут вместе с суммой и ограничены маршрутом: обмен, который потерял бы больше 3%, не выполняется.
Дневной лимит и пауза кошелька действуют и для автовывода. Выключение и ужесточение правил применяются сразу. Если охлаждение включено, включение, другой сервер подписи или получатель, новое или перенаправленное правило, меньший порог или интервал, больше допустимых ошибок подряд и больший предел комиссии вступают в силу только после охлаждения; кабинет показывает когда, и до этого изменение можно отменить. Каждое изменение присылает уведомление о безопасности, а если в аккаунте включена 2FA, требует второй фактор.
Зачем свой сервер подписи
Заголовок раздела «Зачем свой сервер подписи»Кошелёк — это Safe с порогом 2 из 3, поэтому каждому выводу нужны две подписи. Одну даёт со-подписант Invoise. При выводе вручную вторую даёт ваш ключ мерчанта, который не покидает браузер, поэтому в ваше отсутствие подписать он не может.
Invoise никогда не держит два ключа вашего кошелька. Для автовывода вторую подпись даёт ваш собственный сервер подписи, у которого хранится один из ваших ключей кошелька: ключ делегата или ваш ключ мерчанта. Invoise принимает любой из них и не спрашивает, какой именно; от выбора зависит, что сможет сделать утёкший ключ сервера:
- Ключ делегата. Со-подписант Invoise принимает подпись делегата без ключа мерчанта, только пока автовывод включён, и только для выплат на указанный вами адрес получателя; всё остальное по-прежнему требует ключа мерчанта. Поэтому утёкший ключ сервера не позволит отправить деньги через Invoise на другой адрес.
- Ключ мерчанта. Больше ничего настраивать не нужно, но со-подписант принимает ключ мерчанта для всего, что можете сделать вы сами. С утёкшим ключом сервера через Invoise можно вывести деньги на любой адрес, изменить защиту и заменить ключи; остаются только дневной лимит, пауза и охлаждение. Ключ при этом хранится и на сервере, и в браузере.
Сервер с ключом делегата получает и все полномочия делегата: один он может поставить вывод в очередь через модуль задержки, и вывод исполнится через три дня, если вы его не отмените (см. Если Invoise недоступен). Храните ключ сервера так же надёжно, как ключ кошелька.
Настройка
Заголовок раздела «Настройка»- Запустите сервер подписи по протоколу на публичном HTTPS-адресе. Локальные и приватные адреса не принимаются.
- Откройте Кошелёк → Безопасность → Автоматизация вывода → Настроить и в блоке Сервер подписи нажмите Выпустить секрет. Секрет показывается один раз: сохраните его на сервере. Выпустить новый заменяет секрет, и запросы со старым сразу перестают проходить проверку.
- Укажите Адрес сервера подписи, Адрес получателя, правила и ограничения, включите Автовывод включён и нажмите Сохранить. Invoise попросит сервер представиться и покажет его ключ как Ключ сервера.
- Если ключ сервера — ваш ключ мерчанта, статус сразу станет Работает, и настройка закончена. Иначе в разделе появится Сервер подписи — не делегат. Нажмите Сделать делегатом. Пока кошелёк не развёрнут ни в одной сети, сервер становится делегатом сразу; иначе подтвердите транзакцию ключом мерчанта в каждой развёрнутой сети. Текущий делегат будет заменён. Смена делегата — изменение безопасности, поэтому при включённом охлаждении вывод встанет на паузу.
- Когда сервер стал делегатом, Invoise разрешает со-подписанту принимать подпись сервера для вашего адреса получателя, и статус меняется на Работает.
| Статус | Что значит |
|---|---|
| Выключен | Автовывод выключен. |
| Ждёт делегата | Ключ сервера — ни ваш ключ мерчанта, ни делегат кошелька: нажмите Сделать делегатом. |
| Повтор после ошибки | Последняя попытка не удалась; кабинет показывает ошибку и число ошибок подряд. |
| Работает | Выводы идут по правилам. |
Новый сервер подписи, сохранённый при включённом охлаждении, ждёт его, как любое ослабление. Если сделать его делегатом раньше, действующие настройки будут указывать на сервер, который уже не делегат, и ничего не выводится, пока изменение не вступит в силу.
Протокол сервера подписи
Заголовок раздела «Протокол сервера подписи»Запросы
Заголовок раздела «Запросы»Invoise отправляет каждый запрос методом POST на адрес сервера подписи с JSON-телом, Content-Type: application/json, User-Agent: Invoise-Automation/1 и заголовком Invoise-Signature: t=<unix-время>,v1=<hex>. Подпись — HMAC-SHA256 от t + "." + raw_body. Ключ HMAC — вся строка секрета в том виде, в каком её показал кабинет, вместе с префиксом ias_ (ias_ и 64 hex-символа).
Это схема вебхуков, и функция verify оттуда без изменений работает с этим секретом. Сервер ОБЯЗАН отклонить запрос, подпись которого не сходится или t которого отличается от его часов больше чем на 5 минут. Подпись покрывает только время и тело, поэтому на повторный operation_id сервер ОБЯЗАН отвечать уже выданными подписями или отказом и никогда не подписывать другие данные под тем же operation_id.
Сервер отвечает 200 с JSON-телом; любой другой статус — отказ. Весь ответ должен прийти за 30 секунд и занимать не больше 1 МиБ. Редиректы не выполняются.
identify
Заголовок раздела «identify»Отправляется, когда вы сохраняете новый адрес сервера подписи. Адрес, восстановленный из ответа, становится ключом сервера. Он принимается, если это ваш ключ мерчанта или делегат кошелька; любой другой ключ вы затем делаете делегатом.
{ "type": "identify", "wallet": "0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375", "message": "Invoise automatic withdrawals\nWallet: 0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375\nServer: https://signer.example.com/invoise\nNonce: 5f0c4a7e9b2d81f3a6c0e47d1b9a2f68\nIssued At: 2026-10-04T12:00:00Z"}Ответьте подписью EIP-191 personal_sign от message ровно в полученном виде, сделанной ключом сервера (делегата или вашим ключом мерчанта), и адресом этого ключа:
{ "address": "0x5b38da6a701c568545dcfcb03fcb875f56beddc4", "signature": "0x…" }Адрес должен совпадать с тем, что восстанавливается из подписи, и не может быть со-подписантом Invoise.
Отправляется один раз на каждый автовывод. Этот выводит USDT0 и USDC из Arbitrum в USDC в Base:
{ "type": "sign", "operation_id": "9b0f5c2e-4a1d-4f6b-8c3e-2d7a9e1f0b64", "wallet": "0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375", "source_chain_id": 42161, "chain_id": 8453, "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "symbol": "USDC", "decimals": 6, "amount": "249310000", "payee": "0x2f1e7c3b9a4d5e6f708192a3b4c5d6e7f8091a2b", "total_fee_usd": "0.11", "legs": [ { "position": 0, "chain_id": 42161, "safe": "0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375", "fee_recipient": "0x…", "intent": "swap", "safe_tx": { "to": "0x9641d764fc13c8b624c04430c7356c1c7c8102e2", "value": "0", "data": "0x8d80ff0a…", "operation": 1, "nonce": "4" }, "hash": "0x…", "token": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "symbol": "USDC", "decimals": 6, "amount": "0", "fee": { "token": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "37000" }, "swap": { "router": "0x…", "spender": "0x…", "token_in": "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9", "amount_in": "120000000", "token_out": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "min_out": "119380000" }, "bridge": null, "deploys": false }, { "position": 1, "chain_id": 42161, "safe": "0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375", "fee_recipient": "0x…", "intent": "burn", "safe_tx": { "to": "0x9641d764fc13c8b624c04430c7356c1c7c8102e2", "value": "0", "data": "0x8d80ff0a…", "operation": 1, "nonce": "5" }, "hash": "0x…", "token": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "symbol": "USDC", "decimals": 6, "amount": "249400000", "fee": { "token": "0xaf88d065e77c8cc2239327c5edb3a432268e5831", "amount": "30000" }, "swap": null, "bridge": null, "deploys": false }, { "position": 3, "chain_id": 8453, "safe": "0x41d97e9d7b8d051f1ac4adaf92ca1e7b8c788375", "fee_recipient": "0x…", "intent": "withdraw", "safe_tx": { "to": "0x9641d764fc13c8b624c04430c7356c1c7c8102e2", "value": "0", "data": "0x8d80ff0a…", "operation": 1, "nonce": "0" }, "hash": "0x…", "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "symbol": "USDC", "decimals": 6, "amount": "249310000", "fee": { "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913", "amount": "20000" }, "swap": null, "bridge": null, "deploys": true } ]}| Поле | Что значит |
|---|---|
operation_id |
Один автовывод. |
source_chain_id, chain_id, token, amount, payee |
Исходная сеть правила и то, что доходит до получателя в сети назначения. |
total_fee_usd |
Сетевая комиссия всех шагов в USD. |
legs |
Транзакции Safe, которые нужно подписать. Получение по CCTP и исполнение Across подписи не требуют, поэтому номера позиций могут идти с пропусками. |
safe |
Адрес Safe кошелька в сети этого шага. |
intent |
withdraw, swap, burn или bridge. |
safe_tx |
Транзакция Safe: to, value, data, operation, nonce. |
fee, fee_recipient |
Сетевая комиссия шага и куда она платится. |
swap, bridge |
Обмен или депозит Across, который делает шаг, иначе null. |
deploys |
У Safe ещё нет кода в этой сети: он разворачивается в той же транзакции, nonce равен 0. |
Суммы, nonce и value — десятичные строки в единицах токена; decimals и operation — числа.
Ответьте одной подписью на каждый шаг:
{ "signatures": [ { "position": 0, "signature": "0x…" }, { "position": 1, "signature": "0x…" }, { "position": 3, "signature": "0x…" } ] }Каждая подпись — 65-байтная подпись ECDSA ключом сервера (r‖s‖v, v как 27/28 или 0/1) от хеша SafeTx шага. Подпись, которая не восстанавливается ни в делегата кошелька, ни в ваш ключ мерчанта, проваливает вывод с automation_signature_invalid.
Что сервер обязан проверить
Заголовок раздела «Что сервер обязан проверить»Ключ сервера — одна из двух подписей, нужных Safe, поэтому ваш сервер — та проверка, которая не даёт Invoise действовать в одиночку. Перед подписью шага сервер ОБЯЗАН:
-
Посчитать хеш сам. Посчитайте хеш EIP-712 Safe 1.4.1 и подписывайте только его, никогда не поле
hashкак есть. Домен:EIP712Domain(uint256 chainId,address verifyingContract)сchain_idиsafeшага. Сообщение:SafeTx(address to,uint256 value,bytes data,uint8 operation,uint256 safeTxGas,uint256 baseGas,uint256 gasPrice,address gasToken,address refundReceiver,uint256 nonce)сto,value,data,operationиnonceизsafe_tx,safeTxGas,baseGasиgasPrice, равными 0, иgasTokenиrefundReceiver, равными нулевому адресу.safeдолжен быть кошельком, который сервер обслуживает в этой сети. -
Проверить пакет.
operation1 (DELEGATECALL) допустим только наMultiSendCallOnly0x9641d764fc13c8b624c04430c7356c1c7c8102e2с вызовомmultiSend(bytes), и каждый элемент пакета должен быть обычным вызовом (operation 0) с value 0. Одиночный вызов приходит сoperation0. Отклоняйте любой другой DELEGATECALL и любое администрирование Safe:swapOwner,addOwnerWithThreshold,removeOwner,changeThreshold,enableModule,disableModule,setGuard,setFallbackHandler,execTransactionFromModuleи любой вызов самого Safe. -
Проверить каждый вызов. Ровно один
transfer(fee_recipient, fee.amount)токенаfee.token.approve— только на точную сумму, которую тратит следующий вызов: дляswap.spenderнаswap.token_inиswap.amount_in, для CCTP TokenMessengerV20x28b5a0e9c621a5badaa536219b3a228c8168cf5dна сжигаемую сумму или дляbridge.spoke_poolнаbridge.token_inиbridge.amount_in. Дальше поintent:withdraw—transferтокена выплаты на адрес получателя, записанный на самом сервере;swap— вызовswap.router, результат которого остаётся в Safe;burn—depositForBurnв TokenMessengerV2 сmintRecipient, равным Safe, дополненным до 32 байт;bridge—depositV3вbridge.spoke_poolс Safe и как отправителем, и как получателем.
Всё остальное отклоняйте.
-
Применить свои лимиты. Сравните
amountиtotal_fee_usdсо своими лимитами — например, на вывод, на сутки и на долю комиссии, — а получателя со своей настройкой, никогда не сpayeeиз запроса.
Со-подписант Invoise применяет те же правила перед своей подписью, поэтому корректный запрос всегда их проходит. Сервер повторяет их, потому что не должен доверять Invoise.
Чтение настроек
Заголовок раздела «Чтение настроек»Сервер может прочитать у Invoise то, с чем он сверяет запросы, подписывая обращения тем же секретом. Отправьте GET на https://platform.invoise.me/api/v1/automation/<ресурс>?wallet=<адрес Safe> с заголовком Invoise-Signature: t=<unix-время>,v1=<hex>, где v1 — HMAC-SHA256 от t + "." + путь и query, например 1791200000./api/v1/automation/settings?wallet=0x41d9…. Это функция подписи вебхуков, где вместо тела — путь запроса. t может отличаться от часов Invoise не больше чем на 5 минут. Неверная подпись, устаревшее t, неизвестный кошелёк и кошелёк без секрета одинаково получают 401.
| Путь | Ответ |
|---|---|
/automation/settings |
Получатель, правила, ограничения, статус и ожидающее изменение; owners (merchant, delegate, cosigner), server_key_role (merchant, delegate или пусто) и защиты кошелька protections (дневной лимит, охлаждение, пауза). |
/automation/networks |
По каждой сети: safe, deployed, tokens, fee_recipient, multisend, а там, где сеть их поддерживает, cctp (token_messenger, domain, usdc), swap (router, spender) и across (spoke_pool), иначе null. |
/automation/operations |
Автовыводы, новые первыми, с шагами, статусами и хешами транзакций; limit от 1 до 100, по умолчанию 50. |
/automation/operations/{id} |
Один автовывод, например operation_id из запроса sign. |
Используйте ответы, чтобы заполнить и сверить собственную конфигурацию сервера, но не вместо проверки. Они приходят от того же Invoise, от которого сервер защищает, поэтому получатель, лимиты и разрешённые контракты, по которым сервер подписывает, должны быть его собственными.
Эти коды появляются в кабинете, в уведомлении о неудаче и при сохранении настроек.
| Код | Что значит |
|---|---|
automation_server_unreachable |
Сервер не ответил за 30 секунд, или его адрес больше не публичный HTTPS. |
automation_server_refused |
Сервер ответил статусом, отличным от 200; чаще всего у него остался старый секрет. |
automation_server_invalid |
Ответ не JSON ожидаемого вида, подпись identify не восстанавливается в указанный адрес, или ключ — со-подписант. |
automation_signature_invalid |
Подпись не восстанавливается ни в делегата кошелька, ни в ваш ключ мерчанта: ключ сервера сменился. Сохраните адрес сервера заново, чтобы он представился, и сделайте его делегатом, если это не ваш ключ мерчанта. |
route_unavailable, swap_quote_failed |
Сейчас ни мост, ни обмен не могут перевести этот баланс. Поднимите порог или используйте правило внутри одной сети. |