Skip to main content
Это руководство демонстрирует, как интегрировать сессионные ключи в ваши программы Solana Anchor, используя в качестве примера простую программу счётчика.

Установка

Сначала добавьте пакет сессионные ключи в ваш проект Cargo.toml:
Или используйте команду cargo

Использование

  1. Ипортировать сессионные ключи:
Эта строка импортирует необходимые компоненты из пакета сессионные ключи.
  1. Подключение трейта Session:
Трейт Session подключается к структуре Increment, что позволяет использовать функциональность сессий.
  1. Определение аккаунта сессионного токена:
Это определяет необязательный аккаунт SessionToken, указывая подписанта и полномочия для сессии.
  • session_token.authority: аккаунт, который создал сессионный токен
  • counter.authority.key(): аккаунт, который создал счётчик
Условие authority проверяет, что сессионный токен создан тем же пользователем, что и счётчик.
  1. Использование макроса session_auth_or:
Этот макрос применяется к функции increment. Он проверяет наличие действительного сессионного токена или, если токен отсутствует, удостоверяется, что подписант является владельцем счётчика.

Полный пример

Вот полный пример программы счётчика с использованием сессионных ключей. Каждый пользователь получает свой собственный аккаунт счётчика, чтобы показать, как выполняется аутентификация с помощью сессионных ключей.

Тесты

Пример того, как протестировать программу счётчика с использованием сессионных ключей:
Этот набор тестов демонстрирует инициализацию счётчика, его увеличение без сессии, создание сессионного токена и последующее увеличение с использованием сессионного токена. Последний тест особенно важен, так как он гарантирует, что увеличивать счётчик может только его владелец.

Тестирование локально

Для локального тестирования с помощью solana-test-validator необходимо запустить его с программой и аккаунтом сессионных ключей.
  1. Убедитесь, что ваш Solana CLI подключен к DEVNET:
  1. Сохраните программу Session Keys в локальный файл:
  1. Запустите solana-test-validator с программой и аккаунтом сессионных ключей:
-r - reset the ledger to genesis -ud - URL for Solana’s JSON RPC or moniker (-ud = DEVNET) --clone - Copy an account from the cluster --bpf-program - add a SBF program to the genesis configuration