Тестирование API сервера bxid/txid
Двойной архивный сервис txid/bxid упрощает интеграцию Qubic, проверяя успешность транзакции через запросы curl или веб-браузера.
Qsilver · 9 января 2024 г.
Я создал двойной архивный сервис txid и bxid, доступный с помощью curl или даже веб-браузера. Данные txid с эпохи 83 и данные bxid с эпохи 90 находятся в архиве. И данные txid, и данные bxid обновляются каждую минуту.
Это позволит значительно упростить интеграцию Qubic в существующие криптосервисы, так как будет намного проще определить, прошла ли транзакция успешно. ВНИМАНИЕ: Это всего лишь тестовый сервер и не предназначен для использования в производстве, но он должен быть достаточным для отладки логики депозита/вывода.
Использование утилиты bxid
Если у вас есть важные данные транзакции, вы можете непосредственно вычислить bxid с помощью команды calcbxid утилиты bxid:
./bxid calcbxid epoch tick source dest amount
Дополнительную информацию можно найти здесь: qubic-cli/bxid.cpp at main · Qsilver97/qubic-cli (github.com)
Получение данных транзакции
В качестве альтернативы, если у вас есть txid, вы можете получить его данные после того, как он будет включен в указанный тик с помощью:
curl 93.190.139.223:9200/txid/_doc/(txid)
или просто используйте веб-браузер.
Если транзакция была включена в тик, она появится и будет иметь поле "bxid". Найдите этот bxid с помощью:
curl 93.190.139.223:9200/bxid/_doc/(bxid)
Если вы получите действительный ответ, это означает, что транзакция завершена успешно. Если не найдено, предполагая, что архив актуален, это означает, что транзакция была включена в тик, но не прошла (например, вы отправили больше QU, чем было на балансе).
Чтобы убедиться, что ваша транзакция "подтверждена", проверьте наличие bxid. В Qubic нет фактической концепции подтверждений, так как она становится мгновенно окончательной. Как только bxid доступен, можно считать, что средства были переведены по txid.
Расширенный поиск
Хотя это не нужно для проверки транзакций, вы можете искать любое поле в любом из наборов данных txid или bxid с помощью _search endpoint:
curl 93.190.139.223:9200/txid/_search?q=AFZPUAIYVPNUYGJRQVLUKOPPVLHAZQTGLYAAUUNBXFTVTAMSBKQBLEIEPCVJ
curl 93.190.139.223:9200/bxid/_search?q=AFZPUAIYVPNUYGJRQVLUKOPPVLHAZQTGLYAAUUNBXFTVTAMSBKQBLEIEPCVJ
curl 93.190.139.223:9200/txid/_search?q=11919361
curl 93.190.139.223:9200/bxid/_search?q=11919361
Могут быть возвращены разные результаты, так как могут быть txid, которые не переносят никакой ценности, в дополнение к сбоям транзакций. Многие транзакции используют нулевую стоимость с дополнительными данными, и это можно увидеть в выводе txid.
Для получения дополнительной информации обратитесь к Search — OpenSearch Documentation.
Чтобы быть в курсе последних обновлений, присоединяйтесь к Discord-серверу Valis, подпишитесь на нас в X и добавьте наш блог в закладки.
← Предыдущий
Следующий →
На этой странице
- Тестирование API сервера bxid/txid
- Использование утилиты bxid
- Получение данных транзакции
- Расширенный поиск
Похожие публикации