Начало работы
Обзор
Из чего состоит развёртывание BitPolaris и как устроена документация.
Блоки
Четыре продукта используют общее ядро: аккаунты и идентификация, кастодиальное хранение, учётная книга и операционная платформа. Вы лицензируете один или несколько. У каждого блока есть публичный раздел здесь (концепции, интеграция, API) и закрытый раздел в клиентском портале (регламенты, архитектура, ключи).
Где искать
| Exchange | Рынки, типы ордеров, маркет-мейкинг, торговый API, потоки WebSocket |
| Token Launch | Раунды, онбординг инвесторов, контракты вестинга, процесс клейма |
| Payments | Счета, хостинговая страница оплаты, вебхуки, выплаты, плагины |
| Wallet | Распространение приложений, политика хранения, Address Shield |
| Custody | Хранилища, движок политик, одобрения, монитор резервов |
| Эксплуатация | Роли, журнал аудита, релизы, резервные копии, поддержка |
Среды
У каждого развёртывания есть как минимум staging и production. Облачные клиенты получают обе среды от нас; клиенты self-hosted запускают их на собственной инфраструктуре с помощью нашего установщика. Релизы всегда сначала попадают на staging и переводятся в production после вашего одобрения в портале.
Обновлено Oct 2026 · для релиза 4.12
Начало работы
От подписания до запуска
Пятинедельный план развёртывания Exchange. Более простые продукты проходят те же этапы, но с меньшим числом шагов.
Недели
| 1 | Старт проекта. Объём работ зафиксирован, среды подготовлены, брендинг применён к вебу и приложениям. Рынки, комиссии и лимиты на staging; KYC-провайдеры подключены. |
| 2 | Фиатные каналы и PSP (если есть). Маркет-мейкинг настроен по каждой паре. Церемония ключей с вашими ответственными лицами; политика хранения утверждена. |
| 3 | Отправка приложений в сторы. Проверка безопасности. Обучение операционной команды. |
| 4 | Генеральная репетиция в production на реальных средствах с небольшими лимитами. Передача регламентов. |
| 5 | Публичный запуск. Дежурство 24/7 переходит из режима запуска в штатный режим. |
Что нам нужно от вас
Лицензия или понятный план лицензирования, материалы бренда, аккаунты разработчика в сторах, ваши договоры с KYC-провайдером и банком/PSP (или решение использовать наши) и два-три человека, которые будут вести эксплуатацию.
Обновлено Oct 2026 · для релиза —
Начало работы
Модели развёртывания
Облако, self-hosted и исходный код. Что где работает и что у кого хранится.
Сравнение
| White-label-облако | Выделенный экземпляр в ЕС на Hetzner. Эксплуатацию, резервное копирование и обновления берём на себя. Ключи зашифрованы в экземпляре через HashiCorp Vault; блок Custody в этой модели недоступен. |
| Self-hosted | Установщик работает на вашем железе или в вашем облачном аккаунте (AWS, Hetzner и другие). Постоянного доступа у нас нет; для сессий поддержки используются выданные вами учётные данные с ограниченным сроком действия. |
| Исходный код | Полные репозитории, сборочный конвейер и код инфраструктуры. 90 дней онбординга инженеров. Обновления по желанию. |
Требования к ресурсам
# self-hosted, minimum footprint (production)
3× app nodes 8 vCPU · 32 GB
2× database 8 vCPU · 64 GB · NVMe, replicated
1× queue/cache 4 vCPU · 16 GB
1× custody signer isolated network, HSM optional
1× monitoring 4 vCPU · 16 GB
# staging: half of the above, single database
Обновлено Sep 2026 · для релиза 4.12
Exchange
Торговый API
REST для ордеров и данных аккаунта, WebSocket для рыночных данных и приватных обновлений. Ключи выдаются на пользователя, с ограничением прав и возможностью привязки к IP.
Размещение ордера
POST /v1/orders
Authorization: HMAC-SHA256 <key>:<ts>:<sig>
{
"market": "BTC-USDT",
"side": "buy",
"type": "limit",
"price": "81720.00",
"amount": "0.25",
"time_in_force": "GTC",
"post_only": false
}
201 Created
{ "id": "ord_7f3a…", "status": "open", "filled": "0" }
Рыночные данные
wss://api.yourbrand.exchange/v1/ws
{ "op": "subscribe", "channels": ["book.BTC-USDT.10", "trades.BTC-USDT"] }
{ "ch": "book.BTC-USDT.10", "bids": [["81726.1","0.88"], …], "asks": [["81729.0","2.31"], …], "seq": 9182311 }
Типы ордеров
| market | Сразу исполняется по книге ордеров; лимит проскальзывания опционально. |
| limit | Стоит в книге по заданной цене; GTC, IOC, FOK. |
| stop-limit | Становится лимитным ордером, когда проходит сделка по цене срабатывания. |
| oco | Два ордера, исполнение одного отменяет другой. |
| post-only | Отклоняется, вместо того чтобы забирать ликвидность. |
Лимиты запросов
По умолчанию 20 запросов в секунду на ключ для ордеров и 60 в секунду для чтения. Ключи маркет-мейкеров получают повышенные лимиты по запросу. Лимиты и остаток квоты передаются в заголовках ответа.
Обновлено Oct 2026 · для релиза 4.12
Exchange
Маркет-мейкинг
Как книги ордеров остаются глубокими без замораживания вашего капитала и какие параметры контролирует оператор.
Как это работает
Движок котирует обе стороны каждого рынка по реальным исполнимым ценам, полученным с внешних референсных площадок, со спредом, который вы задаёте для каждой пары. Исполнения клиентов хеджируются автоматически; лимиты запасов и экспозиции соблюдаются круглосуточно.
Настройки рынка
| spread | Базисные пункты вокруг референсной средней цены. Обычно: 2–10 б. п. для основных пар, 20–50 б. п. для длинного хвоста. |
| depth | Котируемый объём на уровень и число уровней. |
| max_inventory | Лимит позиции в базовом активе, после которого котирование сужается до одной стороны. |
| sources | Референсные площадки для этого рынка и их веса. |
| pause | Операторы могут приостановить котирование по рынку одним щелчком; для возобновления после инцидента нужен второй подтверждающий. |
Ваши собственные маркет-мейкеры
Внешние маркет-мейкеры подключаются через обычные API-ключи с повышенными лимитами запросов. Уровни комиссий с ребейтами настраиваются в админ-панели.
Обновлено Sep 2026 · для релиза 4.12
Payments
Счета и вебхуки
Создайте счёт, отправьте клиента на хостинговую страницу оплаты, получите подписанное событие после оплаты.
Создание счёта
POST https://api.pay.yourbrand.com/v1/invoices
Authorization: Bearer sk_live_…
{ "amount": "49.00", "currency": "USD", "pay_currency": "USDT", "network": "tron",
"order_id": "A-10422", "success_url": "https://shop.example/thanks", "webhook_url": "https://shop.example/hooks/pay" }
201 { "id": "inv_4821", "checkout_url": "https://pay.yourbrand.com/i/inv_4821", "expires_at": "…" }
Получение события
POST /hooks/pay
X-Signature: t=1729170000,v1=9f2a…
{ "type": "payment.confirmed", "invoice": "inv_4821", "amount_paid": "49.000000", "tx": "7f3a…c41e", "confirmations": 19 }
# verify: HMAC-SHA256(secret, t + "." + body) == v1
События
| payment.detected | Транзакция замечена в блокчейне, 0 подтверждений. |
| payment.confirmed | Достигнута нужная глубина подтверждений; баланс мерчанта пополнен. |
| payment.partial | Недоплата. Содержит оставшуюся сумму. |
| payment.expired | Срок счёта истёк без оплаты. |
| payout.sent | Выплата на одобренный адрес отправлена в сеть. |
Обновлено Oct 2026 · для релиза 2.6
Payments
Плагины для магазинов
Плагины для WooCommerce и Shopify с ребрендингом, опубликованные под вашими аккаунтами разработчика.
WooCommerce
Установите плагин, вставьте API-ключ, выберите принимаемые активы. При payment.confirmed статус заказа меняется на Processing. При частичной оплате к заказу добавляются примечание и ссылка на доплату.
Shopify
Приложение платёжного шлюза с хостинговой страницей оплаты. Проходит ревью Shopify Partner под вашим аккаунтом; карточку приложения готовим мы. Средства зачисляются на баланс мерчанта; для Shopify это стандартный шлюз.
Magento, OpenCart
Доступны по запросу; та же модель событий.
Обновлено Aug 2026 · для релиза 2.6
Token Launch
Раунды, вестинг, клейм
Как настраивается продажа и что видят инвесторы.
Параметры раунда
| price | За токен, в USD; платежи принимаются в USDT/USDC по номиналу. |
| hard_cap / soft_cap | Раунд закрывается при достижении hard cap; ниже soft cap возвраты включаются автоматически. |
| min / max на кошелёк | Контролируется по верифицированной личности, а не только по адресу. |
| whitelist | Опционально; CSV или API. |
| vesting | Доля разблокировки на TGE в %, клифф, срок линейной разблокировки. Для каждого раунда. |
| jurisdictions | Заблокированные страны отсекаются при регистрации и не могут пройти KYC. |
Контракты
Стандартные контракты токена ERC-20/BEP-20 и вестинга включены и проверены. Кастомная механика (контроль эмиссии, уровни держателей) — отдельный модуль; сторонний аудит до выпуска организуем мы.
Клейм
На TGE контракты вестинга пополняются. Инвесторы подключают кошелёк, с которым проходили верификацию, и забирают разблокированные суммы через портал. Графики публичны.
Обновлено Sep 2026 · для релиза 1.9
Custody
Движок политик и одобрения
Правила, кворумы и монитор резервов. Только self-hosted.
Политика
# policy.yaml (excerpt)
assets:
BTC:
hot_target: 5%
cold_sweep_above: 8%
approvals:
- below: 10000 USD quorum: 1-of-3 delay: 0
- below: 1000000 USD quorum: 2-of-3 delay: 0
- above: 1000000 USD quorum: 3-of-5 delay: 4h
new_address_delay: 24h
daily_cap: 2500000 USD
Одобрения
Каждое одобрение — событие с 2FA от именного ответственного лица. Кворумы задаются по активу и диапазону сумм. Аварийные процедуры (break-glass) задокументированы и оставляют запись.
Монитор резервов
Независимый сервис считывает балансы в блокчейне по каждому адресу на хранении и непрерывно сверяет их с учётной книгой. Расхождение вызывает оповещение; проверка, которую не удалось завершить, отображается как «неизвестно». Экспорт доказательства резервов (proof of reserves) доступен по запросу.
Обновлено Oct 2026 · для релиза 3.1
Эксплуатация
Роли, релизы, поддержка
Как устроена операционная платформа и как изменения попадают в production.
Роли по умолчанию
| admin | Всё. Утверждает окна обслуживания и изменения политик. |
| compliance | Очередь KYC, правила по странам, лимиты уровней, экспорт для аудита. |
| treasury | Одобрение выводов, пороги горячего кошелька, резервы. |
| support | Хронология клиента, тикеты, действия с устройствами и сессиями. Для чувствительных действий нужен второй подтверждающий. |
| viewer | Только чтение. Для аудиторов и демонстраций. |
Релизы
Собираются из системы контроля версий, тестируются (1 000+ автотестов), развёртываются на staging, публикуются в портале с changelog и переводятся в production после вашего одобрения. Откат — одна команда.
SLA поддержки
| P1 · сбой или риск для средств | Реакция 15 мин, 24/7, вызов по телефону. |
| P2 · деградация | Реакция 1 ч, 24/7. |
| P3 · запрос | 1 рабочий день. |
| P4 · вопрос | 3 рабочих дня. |
Обновлено Oct 2026 · для релиза 4.12