Данные аккаунта
account_info возвращает баланс в XRP, sequence для следующей транзакции и флаги аккаунта по состоянию последнего подтверждённого леджера (ledger_index: validated).
Нода XRP Ledger (rippled) принимает JSON-RPC запросы методом POST с телом {"method":"...","params":[{...}]}. Прокси передаёт запрос ноде и возвращает ответ без изменений. Модель аккаунтов XRPL и destination tag работают точно так же, как при прямом обращении к rippled.
# xrp здесь — имя для примера, реальное название ноды смотрите в кабинете
# account_info — баланс и sequence аккаунта
curl -X POST https://nodes-api.cryptosafe.pro/proxy/xrp \
-H "Authorization: $CSN_TOKEN" \
-H "Content-Type: application/json" \
-d '{"method":"account_info","params":[{"account":"rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH","ledger_index":"validated"}]}'
# ответ приходит от ноды без изменений
{"result":{"account_data":{"Balance":"49990000000","Sequence":1},"status":"success"}}
// submit — отправка подписанной транзакции (tx_blob)
const res = await fetch(
'https://nodes-api.cryptosafe.pro/proxy/xrp',
{
method: 'POST',
headers: {
'Authorization': process.env.CSN_TOKEN,
'Content-Type': 'application/json'
},
body: JSON.stringify({
method: 'submit',
params: [{ tx_blob: '<подписанный blob транзакции>' }]
})
}
)
// тело и ответ прокси не меняет
const data = await res.json()
XRP Ledger устроен иначе, чем UTXO- или EVM-сети: у аккаунтов есть sequence-номер, резерв и общий для многих получателей адрес с destination tag. Наш эндпоинт отдаёт эти данные напрямую с ноды.
account_info возвращает баланс в XRP, sequence для следующей транзакции и флаги аккаунта по состоянию последнего подтверждённого леджера (ledger_index: validated).
account_tx показывает историю переводов на адрес вместе с destination tag, который позволяет разделить платежи разных клиентов на одном общем адресе.
submit принимает подписанный tx_blob и передаёт его сети. tx по хэшу транзакции возвращает её текущий статус — оба метода проходят через прокси без изменений.
Ключ можно привязать к IP-адресам и подсетям CIDR ваших серверов. Запрос с незарегистрированного адреса получит ошибку 8003. Поддерживаются IPv4 и IPv6; до 50 записей на ключ.
Синхронизация ноды XRP Ledger, обновления клиента rippled и мониторинг — наша ответственность. Адрес вашего эндпоинта не меняется при любых обновлениях с нашей стороны. Как отслеживать статус переводов — в статье о мониторинге транзакций.
В личном кабинете видно количество запросов к ноде XRP Ledger, долю успешных и время ответа. Метрики собираются с первого дня без дополнительной настройки.
От первого сообщения до рабочего API XRP Ledger — обычно в тот же день.
Напишите нам в чат поддержки на сайте: скажите, что нужен доступ к ноде XRP Ledger. Мы откроем кабинет в день обращения.
В личном кабинете создайте ключ. При необходимости добавьте IP-адреса серверов, с которых будут идти запросы к ноде XRP Ledger.
Используйте https://nodes-api.cryptosafe.pro/proxy/xrp
как адрес для JSON-RPC запросов к rippled.
Добавьте ключ в заголовок Authorization.
Методы account_info, account_tx, submit и tx работают как обычно — прокси прозрачен. В кабинете сразу начнёт накапливаться статистика по вашим вызовам.
Напишите в чат поддержки — откроем доступ к ноде XRP Ledger в день обращения. Ключ выпускаете сами в кабинете, инфраструктуру держим мы.