API

Interfaces JSON-RPC et REST

Orin Core fournit des APIs JSON-RPC et REST pour les opérations blockchain, wallet et mempool.

JSON-RPC

  • orind active JSON-RPC par défaut; orin-qt nécessite -server.
  • Endpoints : / et /wallet/<walletname>/.
  • Ports identiques à REST : mainnet 9998, testnet 19998 (via rpcport).
curl --user alice --data-binary '{"jsonrpc":"1.0","id":"0","method":"getblockcount","params":[]}' \
  -H 'content-type: text/plain;' http://127.0.0.1:9998/

Paramètres positionnels, nommés et args pris en charge.

Utilisez orin-cli help ou orin-cli help <command> pour la liste RPC.

REST API

Activez REST avec -rest. Les sorties sont disponibles en bin, hex et json.

Méthode Endpoint Description
GET /rest/tx/<TX-HASH>.<bin|hex|json> Transaction du mempool (txindex=1 pour confirmé).
GET /rest/block/<BLOCK-HASH>.<bin|hex|json> Bloc complet.
GET /rest/block/notxdetails/<BLOCK-HASH>.<bin|hex|json> Bloc sans détails de transactions.
GET /rest/headers/<BLOCK-HASH>.<bin|hex|json>?count=<N> En-têtes de bloc depuis un hash.
GET /rest/blockfilterheaders/<FILTERTYPE>/<BLOCK-HASH>.<bin|hex|json>?count=<N> En-têtes des filtres de blocs.
GET /rest/blockfilter/<FILTERTYPE>/<BLOCK-HASH>.<bin|hex|json> Filtre de bloc du type donné.
GET /rest/blockhashbyheight/<HEIGHT>.<bin|hex|json> Hash du bloc par hauteur.
GET /rest/chaininfo.json État de la chaîne (getblockchaininfo).
GET /rest/getutxos/<TXID>-<N>/.../<TXID>-<N>.<bin|hex|json> Requête UTXO par outpoint.
GET /rest/getutxos/checkmempool/...<bin|hex|json> UTXO avec vérification mempool.
GET /rest/mempool/info.json Statistiques du mempool.
GET /rest/mempool/contents.json Contenu complet du mempool.

Notes de sécurité

  • Ne pas exposer RPC/REST à Internet sans tunnel sécurisé.
  • Augmenter les limites de descripteurs pour un trafic élevé.
  • REST peut exposer des données si vous visitez des pages non fiables sur le même hôte.