Разработчикам

API v1

Публичный

Публичный JSON API этого обозревателя, его используют кошелёк NEB Community Wallet и сайт OTC. Базовый URL https://nebiuschain.app/api/v1.

Соглашения

  • Суммы — десятичные строки в базовых единицах (1 NEB = 100 000 000). Разбирайте их через BigInt, никогда как числа с плавающей точкой.
  • Хеши, идентификаторы и локи — hex в нижнем регистре без 0x. Идентификаторы выводятся в порядке байтов (без разворота). Время — секунды unix.
  • Каждый :addr принимает адрес neb1… или 64-символьный hex-лок. Для мультиподписных и неизвестных локов address равен null; обозреватель показывает их как lock:<hex>.
  • Ошибки: HTTP 4xx/5xx с телом { "error": string, "code": string }. Коды: bad_request, bad_address, bad_txid, bad_cursor, not_found, invalid_tx, rejected, rate_limited (429, с Retry-After), upstream (502, узел), unavailable (503, индекс), internal.
  • CORS * на всех эндпоинтах, включая POST /tx/broadcast. Подтверждённые данные кешируются на несколько секунд (Cache-Control); UTXO и отправка не кешируются.
  • Лимиты на посетителя в минуту: 240 для простых чтений, 120 для списков и поиска, 60 для UTXO, списка богачей и пиров, 20 для отправки транзакций.

Эндпоинты

13 эндпоинтов в /api/v1

Быстрый старт

curl https://nebiuschain.app/api/v1/info
curl https://nebiuschain.app/api/v1/address/neb1…/utxos
curl -X POST -H 'content-type: application/json' -d '{"hex":"01…"}' https://nebiuschain.app/api/v1/tx/broadcast

Справочник

Пути указаны относительно базового URL. Примеры сокращены с помощью …

GET/info

Состояние узла и индекса, политика комиссий.

{ "network": "mainnet", "chainId": "da2f5a…39ae", "height": 2900, "tipHash": "…", "tipTime": 1795184460,
  "indexedHeight": 2900, "synced": true, "nodeVersion": "1.0.2", "peers": 4,
  "feePolicy": { "minFeePerByte": "1", "minFee": "10000", "dust": "1000" }, "coinbaseMaturity": 100 }

synced равно true, когда индекс содержит вершину цепочки узла. Значения политики комиссий — базовые единицы (строки, как и все суммы).

GET/blocks?limit=20&before=<height>

Сводки блоков, новые сверху (limit не больше 100); before не включается.

{ "blocks": [ { "height": 2900, "id": "…", "time": 1795184460, "txCount": 1, "size": 624, "bits": 3154056948,
  "difficulty": 33676240.59, "miner": { "address": "neb1…", "lock": "…", "amount": "1900000000" },
  "reward": "2000000000", "fees": "0" } ] }

reward — субсидия высоты; miner — первый выход coinbase (address равен null для мультиподписного лока). difficulty = цель предела PoW / цель.

GET/block/:heightOrId

Один блок: сводка плюс parent, bodyRoot, nonce, shareCount, confirmations и его txid (coinbase первым).

{ …BlockSummary, "parent": "…", "bodyRoot": "…", "nonce": 123456, "shareCount": 31, "confirmations": 12, "txids": ["…"] }
GET/tx/:txid

Подтверждённая транзакция или неподтверждённая, отправленная через этот обозреватель.

{ "txid": "…", "status": "confirmed", "height": 2890, "blockId": "…", "time": 1795183860, "confirmations": 11,
  "coinbase": false, "size": 270, "fee": "10000",
  "inputs": [ { "prevTxid": "…", "prevIndex": 0, "address": "neb1…", "lock": "…", "lockType": 1, "amount": "500000000", "publicKey": "…" } ],
  "outputs": [ { "index": 0, "amount": "100000000", "lockType": 1, "lock": "…", "address": "neb1…", "spentBy": null } ] }

status "mempool" (height, blockId и time равны null, confirmations 0) только пока getrawmempool узла (читается в реальном времени) содержит транзакцию. Переданная транзакция, покинувшая мемпул без подтверждения (отброшена или заменена), возвращает 404 not_found, а не устаревший "mempool"; транзакция в блоке, который индексатор ещё не сохранил, отображается как "confirmed" по данным узла. У coinbase один вход с нулевым prevTxid, prevIndex 4294967295 и полями null, fee "0". Для неизвестного txid — 404 not_found, в том числе для транзакций мемпула, отправленных не здесь.

GET/address/:addr

Баланс и итоги лока по индексу (neb1… или 64-символьный hex-лок).

{ "address": "neb1…", "lock": "…", "lockType": 1, "balance": "4000000000", "spendable": "2000000000", "immature": "2000000000",
  "received": "…", "sent": "…", "txCount": 12, "utxoCount": 3, "firstSeenHeight": 10, "lastSeenHeight": 2899, "rank": 42 }

spendable не включает выходы coinbase, не созревшие к следующей высоте. Для ни разу не встречавшегося адреса возвращаются нули, высоты null и rank null.

GET/address/:addr/txs?limit=25&cursor=

История, новые сверху (limit не больше 100); для следующей страницы передайте nextCursor как cursor.

{ "txs": [ { "txid": "…", "height": 2899, "time": 1795184400, "delta": "-100010000", "fee": "10000", "coinbase": false } ], "nextCursor": "2875.1" }

delta со знаком: получено − отправлено этим локом в этой транзакции.

GET/address/:addr/utxos

Непотраченные выходы напрямую из getutxos узла (авторитетно, только подтверждённые). Никогда не кешируются.

{ "tipHeight": 2900, "utxos": [ { "txid": "…", "index": 0, "amount": "1900000000", "height": 2850, "coinbase": true, "lockType": 1, "mature": false } ] }

mature вычисляется для tipHeight + 1. Узел отказывает для лока с более чем 20 000 непотраченных выходов (502 upstream).

POST/tx/broadcast

Отправка подписанной транзакции. Тело: { "hex": "<transaction hex>" }.

{ "txid": "…" }

Сначала декодируется и проверяется структура (400 invalid_tx), затем отправляется узлу; отказ узла — 400 { "error": "<node message>", "code": "rejected" }. Узел отклоняет траты неподтверждённых выходов и выходов, уже потраченных транзакцией в мемпуле. Не больше 20 запросов в минуту на посетителя.

GET/mempool

txid мемпула узла; размер и комиссия только для транзакций, отправленных через этот обозреватель (иначе null).

{ "count": 1, "txs": [ { "txid": "…", "size": 270, "fee": "10000", "seenAt": 1795184470 } ] }
GET/richlist?limit=100&offset=0

Локи по балансу (limit не больше 1000). total — число локов с положительным балансом.

{ "total": 543, "holders": [ { "rank": 1, "address": "neb1…", "lock": "…", "lockType": 1, "balance": "…", "share": 0.0431 } ] }

share — доля от обращающегося предложения (от 0 до 1). Лок доли проекта и неизрасходуемый лок генезиса включены.

GET/stats

Показатели эмиссии и сети.

{ "height": 2900, "issued": "8823189999952", "circulating": "8823189999952", "holders": 543, "txCount24h": 600,
  "avgBlockTime1h": 59.8, "difficulty": 33676240.59, "attemptsPerSecond": 590000000000, "projectShareTotal": "290100000000" }

issued = награды по расписанию для высот 0..height + перенос из генезиса; circulating = сумма всех непотраченных выходов. txCount24h без coinbase. attemptsPerSecond = ожидаемое число попыток блоков за последний час / их промежуток времени.

GET/peers

Пиры узла.

[ { "addr": "203.0.113.5:3440", "inbound": false, "subver": "neb-node/1.0.2", "height": 2900, "connected": 1025 } ]
API · NEB Explorer