Справочник 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.