RPC Документация

Полное руководство по работе с JSON-RPC 2.0 API блокчейна QNS. 252+ методов, 28 WebSocket подписок.

Скоро

Mainnet

Chain ID: 1
Symbol: QNS
Min Stake: 1000 QNS
Активна

Pyuniq Testnet

RPC:http://127.0.0.1:9545/
WS:ws://127.0.0.1:9546/
Chain ID: 99991
Symbol: tQNS
Разработка

Devnet

RPC:http://127.0.0.1:7546/
WS:ws://127.0.0.1:7449/
Chain ID: 99992
Min Stake: 0

Все запросы используют JSON-RPC 2.0 формат через HTTP POST:

json
{
  "jsonrpc": "2.0",
  "method": "method_name",
  "params": [param1, param2] or {key: value},
  "id": 1
}

Пример запроса с curl:

bash
curl -X POST http://127.0.0.1:9545/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"qsn_chainInfo","params":[],"id":1}'

Что такое делегирование?

Делегирование позволяет держателям токенов получать награды, делегируя свои токены валидаторам без необходимости запускать собственную ноду.

1

Получить информацию о стейкинге

Сначала проверьте текущие параметры стейкинга:

bash
curl -X POST http://127.0.0.1:9545/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"qsn_getStakingInfo","params":[],"id":1}'
Ответ содержит:
  • minStake - минимальная сумма (Testnet: 1000 tQNS)
  • apr - годовая доходность
  • validators - количество валидаторов
  • epochDuration - длина эпохи в блоках
2

Выбрать валидатора

Получите список активных валидаторов:

bash
curl -X POST http://127.0.0.1:9545/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"qsn_getActiveValidators","params":[],"id":1}'
Критерии выбора:
  • commission - комиссия валидатора (0-100%)
  • uptime - время работы (чем выше, тем лучше)
  • stake - общий стейк валидатора
3

Делегировать токены

Отправьте токены на стейкинг выбранному валидатору:

bash
curl -X POST http://127.0.0.1:9545/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "qsn_stake",
    "params": [{
      "from": "quant2YOUR_ADDRESS...",
      "validator": "quant2VALIDATOR_ADDRESS...",
      "amount": "1000000000000000000000"
    }],
    "id": 1
  }'
⚠️ Важно:
  • Минимум: 1000 tQNS (Testnet) / 0 (Devnet)
  • amount в wei (18 decimals): 1000 tQNS = 1000000000000000000000
4

Проверить свой стейк

bash
curl -X POST http://127.0.0.1:9545/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"qsn_getMyStake","params":["quant2YOUR_ADDRESS..."],"id":1}'
5

Отозвать стейк (unstake)

Для вывода токенов из стейкинга:

bash
curl -X POST http://127.0.0.1:9545/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "qsn_unstake",
    "params": [{
      "from": "quant2YOUR_ADDRESS...",
      "validator": "quant2VALIDATOR_ADDRESS...",
      "amount": "1000000000000000000000"
    }],
    "id": 1
  }'
🔒 Период разблокировки:

Mainnet/Testnet: 7 дней. Devnet: мгновенно.

Что нужно для начала?

Создайте кошелёк с постквантовыми ключами и получите тестовые токены для работы с сетью.

1

Создать кошелёк

Создайте новый кошелёк с постквантовыми ключами:

bash
curl -X POST http://127.0.0.1:9545/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"qsn_createWallet","params":[{}],"id":1}'
Ответ:
json
{
  "success": true,
  "addresses": {
    "quant": "quant27N2UqA8inQRFGAD8yXXSKffh1vr2kx7...",
    "evm": "0xd50c170a57621b05b6889ae39e824bd51eb88130",
    "ton": "EQBvW8Z5huBkMJYdnfAEM5JqTNLuuP..."
  },
  "quantAddress": "quant...",
  "evmAddress": "0x...",
  "tonAddress": "EQ..."
}
💡 Подсказка:

Сохраните оба адреса! quantAddress для QNS, evmAddress для совместимости с EVM.

2

Получить тестовые токены

Используйте кран (faucet) для получения бесплатных тестовых токенов:

bash
curl -X POST http://127.0.0.1:9545/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"qsn_faucet","params":["quant2YOUR_ADDRESS..."],"id":1}'
Лимиты:
  • 5 запросов в час на адрес
  • 10 tQNS за запрос
3

Проверить баланс

bash
curl -X POST http://127.0.0.1:9545/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"qsn_getBalance","params":["quant2YOUR_ADDRESS..."],"id":1}'
Ответ:
json
{
  "balance": "0x8ac7230489e80000",
  "balanceFormatted": "10.0000 tQNS"
}
4

Конвертация адресов (опционально)

Если у вас есть EVM адрес, конвертируйте его в QNS формат:

bash
curl -X POST http://127.0.0.1:9545/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"qsn_getQuantAddress","params":["0xYOUR_EVM_ADDRESS..."],"id":1}'

Всего доступно 252+ RPC методов и 28 WebSocket подписок

Полная документация доступна на GitHub