Перенесення з Quasar Cloud у Community Edition

Організація переноситься з хмари Quasar Cloud на вашу власну ноду Community Edition у вигляді одного зашифрованого архіву. Усі додатки зберігають свої API-ключі, а ендпоінти вебхуків — секрети підпису HMAC, тому вам знадобиться лише змінити базовий URL у додатках, а приймачі вебхуків працюватимуть взагалі без змін.

Переноситься на вашу ноду	Залишається в Quasar Cloud
Організація (з лімітами вашої ноди; адміністратор ноди стає її єдиним власником)	Облікові записи учасників та способи входу (нода має одного адміністратора)
Додатки: API-ключі, IP/доменні білі списки, RPC-налаштування, ключі Alchemy/QuickNode/Pimlico	Історія білінгу, витрати квот та баланси
Ендпоінти вебхуків разом із їхніми секретами підпису	Системні вебхуки Quasar Cloud
Усі історичні транзакції разом із результатами перевірок AML
Журнали доставок вебхуків за останні 30 днів
Записи додатку Payments: налаштування прийому платежів та інвойси

📦 Експорт організації

Виконувати експорт може лише власник (Owner) організації. У панелі керування Quasar перейдіть на сторінку організації, оберіть Export Organization і підтвердіть дію введенням пароля (та коду 2FA, якщо він активний).

Далі система згенерує та покаже ключ імпорту (QEX1-…). Він не зберігається на серверах: обов'язково скопіюйте його перед завантаженням файлу. Посилання на завантаження дійсне одноразово протягом 10 хвилин. Усі співвласники організації отримують сповіщення на електронну пошту.

Файл .qex надійно зашифровано ключем імпорту за алгоритмом AES-256-GCM, оскільки він містить усі секрети організації. Зберігайте завантажений архів і ключ окремо в надійних сховищах.

📥 Імпорт у вашу власну ноду

Потрібна версія Community Edition 0.2 або новіша. Увійдіть у панель /admin вашої ноди та оберіть Import data from Quasar Cloud:

Виберіть файл архіву .qex та введіть ключ імпорту (регістр літер та пробіли не мають значення).
Аналіз файлу: нода розшифрує та проаналізує дані й покаже детальний список того, що буде створено, оновлено або пропущено, до того, як почнеться запис у базу даних.
Підтвердіть дію паролем адміністратора і розпочніть імпорт. Панель відображатиме прогрес у реальному часі.

Нода перешифровує всі секретні ключі власним майстер-ключем ENCRYPTION_KEY. Транзакції, що перебували в процесі підтвердження, автоматично підхоплюються трекерами вашої ноди.

Що нода може пропустити та про що повідомить у звіті:

RPC-адреси, відхилені політикою мережі: наприклад, приватні або заборонені IP-адреси.
Небезпечні ендпоінти вебхуків: незахищений протокол HTTP у продакшн-режимі або дубльовані ендпоінти на localhost.

🔁 Безшовне перемикання трафіку

Виконайте перший імпорт організації у вашу ноду.
Спрямуйте клієнтські та бекенд-додатки на нову ноду: оновіть baseUrl у @tuwaio/quasar-sdk, адресу в preFlightTxCheck та прапорець --api-url у релеї вебхуків. Секретні ключі додатків залишаються тими самими.
Повторний дельта-експорт: виконайте ще один експорт та імпорт. Він перенесе транзакції, що були створені між першим імпортом і перемиканням. Імпорт є цілком ідемпотентним і не затирає налаштування, змінені на вашій ноді.
Деактивуйте або видаліть додатки в Quasar Cloud після повної стабілізації.

🧯 Діагностика помилок імпорту

Повідомлення про помилку	Спосіб вирішення
Ключ імпорту не відповідає експорту	Перевірте ключ. Кожен експортний файл розшифровується лише своїм унікальним ключем.
Архів пошкоджено або він неповний	Завантажте експорт повторно: файл міг бути перерваний під час завантаження через мережу.
Цей експорт використовує новішу версію формату	Оновіть версію Quasar Community Edition на вашому сервері до актуальної та повторіть імпорт.
Конфлікт даних із наявними записами на ноді	Ключ або вебхук належить іншому додатку вашої ноди. Жодних змін у базу внесено не було.
Розмір файлу перевищує ліміт проксі	Збільште ліміт client_max_body_size у вашому Nginx/Traefik або Cloudflare (до 100 MB).