Обзор портала

Этот портал — внутренняя база знаний и набор инструментов для администраторов проекта, работающих со swap-провайдерами. Он решает три задачи:

1. Документация — объясняет простым языком, как работает каждый подключённый провайдер: авторизация, комиссии, пошаговые сценарии, ответы на частые вопросы.
2. Песочница API (/sandbox) — конструктор запросов. Можно выбрать готовый шаблон, поправить параметры и выполнить запрос к API провайдера через безопасный серверный прокси, не открывая терминал и не трогая ключи.
3. Проверка котировки (/quote) — быстрый способ узнать, сколько получит пользователь при обмене: выбираете два актива, сумму — и видите расчёт без запуска реального свопа.

Какие провайдеры подключены#

Провайдер	Статус	Что это
1Click API (NEAR Intents)	активен	REST API кросс-чейн свопов: маркет-мейкеры конкурируют за цену, 1Click строит и отслеживает своп

Список и конфигурация провайдеров хранятся в каталоге providers/ репозитория.

Как устроен репозиторий#

• app/ — страницы портала и серверный прокси к API провайдеров;
• content/docs/ — эта документация (обычные markdown-файлы, их легко править);
• providers/<id>/ — манифест провайдера и шаблоны запросов для песочницы;
• .env.example — образец файла с переменными окружения (без значений).

С чего начать#

1. Прочитайте раздел «Безопасность и секреты» — это обязательные правила.
2. Изучите «О 1Click API» и «Быстрый старт».
3. Откройте песочницу, загрузите шаблон «GET /v0/tokens» и нажмите «Выполнить» — это безопасный публичный запрос, который сразу покажет, что всё работает.