Довідник RPC

TALER надає комплексний JSON-RPC інтерфейс для програмної взаємодії з блокчейном, гаманцем і мережею. Цей довідник документує всі доступні RPC методи.

Початок роботи з TALER RPC

Увімкнення доступу RPC

1. Налаштуйте RPC в taler.conf

Створіть або відредагуйте ваш файл конфігурації:

Linux/macOS: ~/.taler/taler.conf Windows: %APPDATA%\TALER\taler.conf

# Увімкнути RPC сервер
server=1

# Облікові дані RPC (обов'язково)
rpcuser=yourusername
rpcpassword=yourpassword

# Опціонально: прив'язати до конкретного IP
rpcbind=127.0.0.1

# Опціонально: дозволити з'єднання з конкретного IP
rpcallowip=127.0.0.1

# Опціонально: користувацький RPC порт (за замовчуванням: 23333)
rpcport=23333

2. Запустіть talerd з увімкненим RPC

talerd -daemon

Виконання RPC викликів

Використання taler-cli (рекомендується)

taler-cli [опції] <команда> [параметри]

Приклад:

taler-cli getblockcount
taler-cli getbalance
taler-cli sendtoaddress "TFNxSh9X75WguDWRj4FbRELK8GUP37xu4E" 10.5

Використання curl (HTTP POST)

curl --user yourusername:yourpassword \
  --data-binary '{"jsonrpc":"1.0","id":"curltest","method":"getblockcount","params":[]}' \
  -H 'content-type: text/plain;' \
  http://127.0.0.1:23333/

Формат відповіді:

{
  "result": 123456,
  "error": null,
  "id": "curltest"
}

RPC методи за категоріями

Інформація про блокчейн

Запит стану блокчейну, блоків, транзакцій і статистики ланцюга.

Mempool (пул транзакцій)

Перевірка і управління транзакціями, що очікують підтвердження.

Набір UTXO

Запит невитрачених виходів транзакцій і перевірка доказів.

Просунуте управління блокчейном

Просунуті операції для тестування і управління блокчейном.

Майнінг і генерація

Управління генерацією блоків для proof-of-work (PoW) і proof-of-stake (PoS).

Примітка: Для продакшн стейкінгу використовуйте setgeneratepos true з зашифрованим і розблокованим гаманцем. Див. Посібник з майнінгу і стейкінгу для деталей.

Сирі транзакції

Створення, декодування, підпис і трансляція сирих транзакцій.

Створення транзакцій

Декодування транзакцій

Підпис транзакцій

Трансляція транзакцій

Операції з PSBT

Об’єднання транзакцій

Управління гаманцем

Управління файлами гаманця, шифруванням, резервними копіями і пулами ключів.

Операції з гаманцем

Шифрування і безпека гаманця

Важливо: Завжди шифруйте ваш гаманець перед стейкінгом. Див. Кращі практики безпеки для деталей.

Управління пулом ключів

Адреси і мітки

Генерація і управління адресами гаманця.

Генерація адрес

Типи адрес: "legacy", "p2sh-segwit", "bech32" (за замовчуванням залежить від конфігурації гаманця)

Мітки і організація

Мультипідписні адреси

Баланси і історія транзакцій

Запит балансів гаманця і інформації про транзакції.

Інформація про баланс

Історія транзакцій

Відправка транзакцій

Відправка монет TALER з гаманця.

Проста відправка

Приклад:

taler-cli sendtoaddress "TFNxSh9X75WguDWRj4FbRELK8GUP37xu4E" 10.5
taler-cli sendmany "" '{"TAddr1":10,"TAddr2":5.5}'

Управління транзакціями

Управління UTXO

Управління невитраченими виходами, доступними для витрат.

Приклад - Блокування UTXO:

taler-cli lockunspent false '[{"txid":"abc123...","vout":0}]'

Приклад - Розблокування всіх UTXO:

taler-cli lockunspent true

Імпорт і експорт

Імпорт і експорт ключів, адрес і даних гаманця.

Імпорт

Експорт

Попередження безпеки: Ніколи не діліться експортованими приватними ключами або дампами гаманця. Будь-хто, хто має доступ до приватних ключів, може витрачати ваші монети.

Підпис і перевірка повідомлень

Підпис повідомлень адресами гаманця і перевірка підписів.

Приклад:

# Підписати повідомлення
taler-cli signmessage "TFNxSh9X75WguDWRj4FbRELK8GUP37xu4E" "Hello TALER"

# Перевірити підпис
taler-cli verifymessage "TFNxSh9X75WguDWRj4FbRELK8GUP37xu4E" "H1234..." "Hello TALER"

Стейкінг (Proof-of-Stake)

Моніторинг і управління proof-of-stake майнтінгом/стейкінгом.

Для детальних інструкцій з налаштування стейкінгу, див. Посібник з майнінгу і стейкінгу.

Інформація про мережу

Запит з’єднань пірів і мережевої статистики.

Управління пірами

Мережева статистика

Управління банами

Приклад - Забанити IP:

taler-cli setban "192.168.1.100" "add" 86400

Управління мережею

Управління сервером і інформація

Управління демоном TALER і запит системної інформації.

Приклад:

# Отримати довідку по команді
taler-cli help getblockcount

# Перевірити час роботи сервера
taler-cli uptime

# Зупинити демон
taler-cli stop

Застарілі методи

Наступні методи застарілі і підтримуються тільки для зворотної сумісності. Вони можуть бути видалені в майбутніх версіях.

Обробка помилок

RPC виклики повертають помилки в наступному форматі:

{
  "result": null,
  "error": {
    "code": -5,
    "message": "Invalid address"
  },
  "id": "curltest"
}

Поширені коди помилок

Аутентифікація RPC

TALER RPC використовує HTTP Basic Authentication. Налаштуйте облікові дані в taler.conf:

rpcuser=yourusername
rpcpassword=yourpassword

Кращі практики безпеки:

• Використовуйте сильний, випадково згенерований пароль
• Ніколи не виставляйте RPC у публічний інтернет
• Використовуйте rpcallowip для обмеження доступу з конкретних IP
• Розгляньте використання SSH тунелювання для віддаленого доступу
• Використовуйте HTTPS/TLS при віддаленому доступі до RPC (потрібен зворотний проксі)

Додаткові ресурси

• Посібник з налаштування ноди: Запуск ноди TALER
• Довідник командного рядка: talerd & taler-cli
• Кращі практики безпеки: Безпека гаманця
• Посібник зі стейкінгу: Майнінг і стейкінг
• Розгортання Docker: Налаштування Docker

Для питань або підтримки відвідайте Спільноту TALER в Telegram.