DLT RPC v0 API Reference
Introduction
The Ixian DLT (Distributed Ledger Technology) node exposes a rich JSON-RPC API that allows applications to interact with the blockchain, manage wallets, query the name system, and control mining operations. This section provides a detailed reference for every available method.
All endpoints are accessible via HTTP GET or HTTP POST requests and follow the standard JSON-RPC 2.0 specification.
Blockchain & Transaction Queries
These methods are used to query the state of the blockchain, including blocks, transactions, and overall supply.
| Method | Description |
|---|---|
getBestBlockHash | Retrieves the checksum (hash) of the most recent block. |
getBlockCount | Retrieves the block number (height) of the most recent block. |
getBlock | Retrieves a block by its number or hash. |
getFullBlock | Retrieves a full block, including all transaction data, by number or hash. |
getLastBlocks | Retrieves a list of the most recently added blocks. |
getTransaction | Retrieves a single transaction by its unique ID. |
tx | Retrieves a paginated list of both confirmed and unconfirmed transactions. |
txa | Retrieves a paginated list of applied (confirmed) transactions only. |
txu | Retrieves a paginated list of unapplied (unconfirmed) transactions from the mempool. |
supply | Retrieves the total calculated circulating supply of IXI coins. |
Wallet & Name System (IXI-NS)
These methods are used to query wallet balances, the name registry, and trigger wallet maintenance.
| Method | Description |
|---|---|
getBalance | Retrieves the balance for a specific wallet address. |
getWallet | Retrieves the public state of a wallet, including balance and properties. |
getRegName | Retrieves a registered name record by its name or hashed ID. |
getRegNameDataRecords | Retrieves all data records associated with a specific registered name. |
rescanBlockchain | Initiates a background rescan of the blockchain to find wallet transactions. |
Mining Operations
These methods are specific to DLT nodes participating in Proof-of-Work mining and are used to control and monitor the mining process.
| Method | Description |
|---|---|
getMiningBlock | Retrieves a block data "job" for an external miner to work on. |
minerStats | Retrieves real-time statistics about the node's internal mining activity. |
setBlockSelectionAlgorithm | Configures the strategy used by the internal miner to select the next block. |
submitMiningSolution | Submits a Proof-of-Work solution from an external miner. |
verifyMiningSolution | Verifies if a given nonce is a valid solution for a specific block. |
Node & Network Status
These methods provide information about the node's operational state and its view of the network.
| Method | Description |
|---|---|
status | Retrieves a comprehensive overview of the node's current state. |
countNodeVersions | Retrieves a summary of all node versions currently active on the network. |