Перейти к содержимому

API-ключи Lighter

Lighter — это ZK-perp DEX. Регистрация и KYC не нужны: торговля идёт от имени вашего кошелька, подключённого к dApp. Для подключения терминал использует пару:

  • Account Index — числовой идентификатор вашего аккаунта на Lighter (например, 720875).
  • Lighter Private Key — приватный ключ от созданного API-ключа.

Дополнительно Lighter подписывает ордера через собственный бинарный signer — терминал предложит скачать его автоматически при первом подключении.

  1. Откройте Lighter и подключите свой кошелёк, затем перейдите по прямой ссылке app.lighter.xyz/apikeys.
  2. В блоке «YOUR ACCOUNT INDEX» запишите ваш номер (показан рядом с #, например #720875) — он понадобится в терминале.
  3. Нажмите «Generate API Key».
  4. В модальном окне укажите API Key Index.
    • Индексы 0 (Desktop) и 1, 2, 3 (Mobile) зарезервированы и недоступны.
    • Свободные индексы — 4–254 (всего до 251 ключа на аккаунт).
    • Подберите любой свободный индекс, например 7.
  5. Maker Only (необязательно). Если включить, ключ сможет ставить только лимитные мейкер-ордера; маркетные и тейкер не пройдут. Для обычной торговли через терминал оставьте выключенным.
  6. Нажмите «Generate» и подпишите создание ключа основным кошельком.
  7. Сохраните полученный приватный ключ — потерять его так же плохо, как Secret на CEX-бирже.

В таблице ключей в списке появятся:

  • API Key Index — выбранный вами индекс;
  • Public Key — публичная часть пары (приватная вам уже показана и в дальнейшем не выводится);
  • Maker Only — статус флага;
  • Refresh — перегенерировать пару по этому индексу;
  • Revoke — отозвать ключ.

При первом подключении к Lighter терминал обнаружит, что бинарник signer’а не установлен, и предложит скачать его с GitHub (~8 МБ).

  1. В верхней панели терминала нажмите иконку шестерёнки (Настройки) и откройте вкладку Подключения.
  2. Нажмите + Добавить подключение. Откроется список бирж, разбитый на секции CEX, DEX, FOREX и MOEX — в секции DEX нажмите плитку Lighter.
  3. Если над формой видно сообщение «Бинарник signer’а Lighter не установлен», нажмите «Скачать бинарник» и дождитесь завершения загрузки. Пока signer не установлен, кнопка внизу формы читается Install signer first и не нажимается.
  4. Поле Name уже заполнено названием биржи; при желании измените его (например, Lighter · основной).
  5. Включите нужные рынки — Spot и/или Futures (перпетуалы Lighter — это Futures). По умолчанию оба тумблера выключены; без хотя бы одного включённого рынка кнопка Connect останется неактивной.
  6. Введите Account Index — номер вашего аккаунта (например, 720875, без #) — и вставьте в поле Lighter Private Key приватный ключ созданного API-ключа. Ключ скрыт точками — иконка глаза справа показывает его.
  7. В списке Proxy оставьте Auto или выберите прокси; No Proxy — прямое соединение.
  8. Нажмите Connect. Терминал проверит ключи запросом к бирже: при успехе форма закроется, а подключение появится в списке Текущие подключения уже включённым. Если биржа отклонит ключи, форма останется открытой, а в углу появится уведомление с текстом ошибки.

Подписи полей формы (Name, Spot, Futures, Account Index, Lighter Private Key, Proxy) и кнопка Connect всегда на английском — даже при русском интерфейсе терминала.

  • API-ключ Lighter привязан к Account Index и торгует только от вашего аккаунта — права на вывод средств у него нет.
  • Приватный ключ — это пароль доступа к торговле от вашего имени. Храните его в менеджере паролей или зашифрованной заметке.
  • Не публикуйте приватный ключ нигде: ни в скриншотах, ни на форумах, ни в чатах поддержки.
  • При подозрении на утечку — сразу нажмите «Revoke» напротив индекса ключа в списке API Keys и сгенерируйте новый.