Автовивід
Автовивід переміщує гроші з вашого гаманця Invoise без підтвердження кожного виведення. Для кожної мережі ви задаєте поріг; щойно гаманець має там стільки, увесь баланс цієї мережі йде на одну вашу зовнішню адресу. Ваш власний сервер підпису підписує транзакції, а Invoise додає другий підпис.
Як це працює
Section titled “Як це працює”Автовивід налаштовують у кабінеті: Гаманець → Безпека → Автоматизація виводу → Налаштувати. Кожне правило в блоці Правила за мережами задає:
- З мережі: мережа, баланс якої виводиться. Одне правило на мережу.
- У мережу: куди йдуть гроші. Це може бути та сама мережа, тоді міст не використовується.
- Токен: один із токенів, які Invoise підтримує в мережі призначення.
- Поріг у доларах: від мінімального виведення, не більше двох знаків після коми.
Платежі в Tron і Solana надходять на гаманець в Arbitrum (див. Solana і Tron), тож вони рахуються в правилі Arbitrum. Окремого правила для Tron чи Solana немає.
Коли гаманець має щонайменше поріг у мережі-джерелі, Invoise виводить увесь баланс цієї мережі, у будь-яких стейблкоїнах, за вирахуванням комісії, на адресу з поля Адреса отримувача. Власний баланс мережі призначення лишається на місці. Стейблкоїн, який жоден міст не може перенести в токен виплати, як-от USDT0 в Arbitrum для USDC у Base, спершу обмінюється на USDC цієї мережі в Uniswap, а потім CCTP від Circle переносить USDC. Стейблкоїн із родини токена виплати йде через Across, а правило, у якого мережа призначення збігається з джерелом, обмінює в цій мережі, як ручне виведення. Комісія така сама, як для ручного виведення.
Invoise перевіряє правила щохвилини й надсилає одне автоматичне виведення за раз: за першим правилом, мережа якого досягла порогу.
Ліміти
Section titled “Ліміти”| Налаштування | Значення |
|---|---|
| Не частіше | Без обмежень або раз на годину, кожні 3, 6 чи 12 годин, раз на день чи раз на тиждень. |
| Вимкнути після помилок поспіль | Від 1 до 10, за замовчуванням 3. Після помилки наступна спроба чекає 5 хвилин, потім 30 хвилин, потім 2 години. Ви отримуєте сповіщення про першу помилку в серії і коли автовивід вимикається. |
| Комісія не більше | 0,5%, 1%, 2%, 3%, 5% або 10% суми, яка доходить до отримувача, за замовчуванням 1%. |
Ліміт комісії охоплює газ мережі всіх кроків. Коли газ дорожчий, виведення з цієї мережі чекає: кабінет показує Чекає нижчої комісії з комісією та сумою, і виведення піде, щойно баланс зросте або газ подешевшає. Очікування — не помилка. Комісії мосту й обміну зростають із сумою й обмежені маршрутом: обмін, який втратив би понад 3%, відхиляється.
Денний ліміт і пауза гаманця діють і для автовиводу. Вимкнення й посилення правил діють одразу. Коли охолодження ввімкнене, увімкнення, інший сервер підпису чи отримувач, нове чи перенаправлене правило, нижчий поріг чи коротший інтервал, більше допустимих помилок і вищий ліміт комісії діють лише після охолодження; кабінет показує, коли саме, і до того зміну можна скасувати. Кожна зміна надсилає сповіщення безпеки й, якщо в обліковому записі є 2FA, просить другий фактор.
Навіщо власний сервер підпису
Section titled “Навіщо власний сервер підпису”Гаманець — це Safe з порогом 2 із 3, тож кожне виведення потребує двох підписів. Один дає ко-підписант Invoise. Для ручного виведення другий дає ваш ключ мерчанта, який ніколи не залишає браузер, тож він не може підписувати, поки вас немає.
Invoise ніколи не тримає двох ключів вашого гаманця. Для автовиводу другий підпис дає ваш власний сервер підпису, який тримає один із ваших ключів гаманця: ключ делегата або ваш ключ мерчанта. Invoise приймає будь-який із них і не питає, який саме; від вибору залежить, що зможе зробити ключ сервера, що витік:
- Ключ делегата. Ко-підписант Invoise приймає підпис делегата без вашого ключа лише поки автовивід увімкнено і лише для виплат на задану вами адресу отримувача; усе інше, як і раніше, потребує ключа мерчанта. Тому ключ сервера, що витік, не може надіслати гроші деінде через Invoise.
- Ключ мерчанта. Більше нічого налаштовувати не треба, але ко-підписант приймає ключ мерчанта для всього, що можете зробити ви самі. З ключем сервера, що витік, через Invoise можна вивести гроші на будь-яку адресу, змінити захист і замінити ключі; лишаються тільки денний ліміт, пауза та охолодження. Ключ тоді зберігається і на сервері, і в браузері.
Сервер із ключем делегата має й усі повноваження делегата: сам він може поставити виведення в чергу через модуль затримки, і воно виконається через три дні, якщо ви його не скасуєте (див. Якщо Invoise недоступний). Бережіть ключ сервера так само, як ключ гаманця.
Налаштування
Section titled “Налаштування”- Запустіть за публічною HTTPS-адресою сервер підпису, що дотримується протоколу. Локальні та приватні адреси відхиляються.
- Відкрийте Гаманець → Безпека → Автоматизація виводу → Налаштувати і натисніть Випустити секрет у блоці Сервер підпису. Секрет показується один раз: збережіть його на своєму сервері. Випустити новий замінює його, і запити, підписані старим, одразу перестають проходити перевірку.
- Заповніть Адреса сервера підпису, Адреса отримувача, правила й ліміти, увімкніть перемикач Автовивід увімкнено і натисніть Зберегти. Invoise просить сервер представитися і показує його ключ як Ключ сервера.
- Якщо ключ сервера — ваш ключ мерчанта, статус одразу стає Працює, і налаштування завершено. Інакше розділ показує Сервер підпису — не делегат. Натисніть Зробити делегатом. Поки гаманець не розгорнуто в жодній мережі, сервер стає делегатом одразу; інакше підтвердьте транзакцію ключем мерчанта в кожній розгорнутій мережі. Поточного делегата буде замінено. Зміна делегата — це зміна безпеки, тож за ввімкненого охолодження вона призупиняє виведення.
- Щойно сервер став делегатом, Invoise дозволяє своєму ко-підписанту приймати підпис сервера для вашої адреси отримувача, і статус стає Працює.
| Статус | Значення |
|---|---|
| Вимкнено | Автовивід вимкнено. |
| Чекає делегата | Ключ сервера — ні ваш ключ мерчанта, ні делегат гаманця: натисніть Зробити делегатом. |
| Повтор після помилки | Остання спроба не вдалася; кабінет показує помилку й кількість помилок поспіль. |
| Працює | Виведення йдуть за правилами. |
Новий сервер підпису, збережений за ввімкненого охолодження, чекає кінця охолодження, як будь-яке послаблення. Якщо зробити його делегатом до того, як зміна набуде чинності, поточні налаштування вказують на сервер, який уже не делегат, і нічого не виводиться, доки зміна не застосується.
Протокол сервера підпису
Section titled “Протокол сервера підпису”Запити
Section titled “Запити”Invoise надсилає кожен запит як POST на адресу вашого сервера підпису з JSON-тілом, Content-Type: application/json, User-Agent: Invoise-Automation/1 і заголовком Invoise-Signature: t=<unix time>,v1=<hex>. Підпис — це HMAC-SHA256 від t + "." + raw_body. Ключ HMAC — увесь рядок секрету, як його показує кабінет, разом із префіксом ias_ (ias_ і 64 шістнадцяткові символи).
Це схема вебхуків, і функція verify звідти працює з цим секретом без змін. Сервер МУСИТЬ відхилити запит, підпис якого не проходить перевірку або чий t відрізняється від його власного годинника більш ніж на 5 хвилин. Підпис охоплює лише час і тіло, тож на повторний operation_id сервер МУСИТЬ відповідати вже виданими підписами або відмовою і ніколи не підписувати інші дані під тим самим operation_id.
Сервер відповідає 200 з JSON-тілом; будь-який інший статус — відмова. Уся відповідь має надійти протягом 30 секунд і бути не більшою за 1 MiB. Переспрямування не виконуються.
identify
Section titled “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 чи fill 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.
Що має перевіряти сервер
Section titled “Що має перевіряти сервер”Ключ сервера — один із двох підписів, потрібних 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) зі значенням 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, для TokenMessengerV2 від CCTP0x28b5a0e9c621a5badaa536219b3a228c8168cf5dна спалену суму або для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.
Читання налаштувань
Section titled “Читання налаштувань”Сервер може прочитати в Invoise те, з чим він звіряє запити, підписуючи звернення тим самим секретом. Надішліть GET на https://platform.invoise.me/api/v1/automation/<ресурс>?wallet=<адреса Safe> із заголовком Invoise-Signature: t=<unix time>,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, від якого сервер захищає, тож отримувач, ліміти й дозволені контракти, за якими сервер підписує, мають бути його власними.
Помилки
Section titled “Помилки”Ці коди з’являються в кабінеті, у сповіщенні про помилку й під час збереження налаштувань.
| Код | Значення |
|---|---|
automation_server_unreachable |
Сервер не відповів за 30 секунд, або його адреса більше не публічна HTTPS-адреса. |
automation_server_refused |
Сервер відповів статусом, відмінним від 200; найчастіше в нього ще старий секрет. |
automation_server_invalid |
Відповідь не була коректним JSON очікуваної форми, підпис identify не відновлюється до вказаної адреси, або ключ — це ко-підписант. |
automation_signature_invalid |
Підпис не відновлюється ні до делегата гаманця, ні до вашого ключа мерчанта: ключ сервера змінився. Збережіть адресу ще раз, щоб сервер представився, а потім зробіть його делегатом, якщо це не ваш ключ мерчанта. |
route_unavailable, swap_quote_failed |
Жоден маршрут мосту чи обміну не може зараз перемістити цей баланс. Підвищте поріг або використайте правило в межах однієї мережі. |