Gets the stored height of the blockchain.

Gets the stored height of the blockchain.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "block_height"
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": 318492
}

Get a block by height or hash.

Gets a block with it's transaction hashes given a block height or block hash.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "block_get",
  "params": {
    "height": 318492
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "hash": "vX_PzD2DvIQZPlpM_LiDCCewpWuZkwcdAhjnJXeg5Gk",
    "height": 318492,
    "prev_hash": "OLv5ah-94zg3ySJK5x50-W6Kw4gd510ikhpbByq37ZU",
    "time": 1588558709,
    "transactions": [
      {
        "hash": "UOVRPuEO2IE8y9fxiuO9JBcBLrqP0Hbh7cUqt-n_8QE",
        "type": "poc_request_v1"
      },
      {
        "hash": "67NdSWYjdE8LaR0DE_NNWqMr4XVK8hwrFJ616c9BPmE",
        "type": "poc_request_v1"
      },
      {
        "hash": "KfHpj8ytLV6bqNaMS8wbWXeqXkHxjS-G_U_AAUrFvSQ",
        "type": "poc_request_v1"
      },
      {
        "hash": "r4mgtbBnrY0v6_m01-akrUtZ7KSsLIF4XTJBIUWiaZs",
        "type": "poc_request_v1"
      },
      {
        "hash": "KMFPXYw9QYdW3mtciOuitcWm1qVknm5IDluckN7IcaY",
        "type": "poc_request_v1"
      },
      {
        "hash": "1cpS1AnemprqCmm8SHq9_S-eiCE6zjzf2QsOIaV4GgI",
        "type": "poc_request_v1"
      },
      {
        "hash": "1Rh4iR3eBQIIywqSQ0TCO04tdl2Dl7dW4qWng5q65Es",
        "type": "poc_request_v1"
      }
    ]
  }
}

Get account details.

Get account details for a given account address.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "account_get",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "address": "13Ya3s4k8dsbd1dey6dmiYbwk4Dk1MRFCi3RBQ7nwKnSZqnYoW5",
    "balance": 1000,
    "mobile_balance": 1000,
    "iot_balance": 1000,
    "nonce": 3,
    "speculative_nonce": 12,
    "dc_balance": 0,
    "dc_nonce": 0,
    "sec_balance": 0,
    "sec_nonce": 0,
    "sec_speculative_nonce": 0,
    "staked_balance": 0,
    "cooldown_balance": 0
  }
}

Get transaction details.

Get details for a given transaction hash.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "transaction_get",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "implicit_burn": {
      "fee": 1401125,
      "payer": "1b93cMbumsxd2qgahdn7dZ19rzNJ7KxEHsLfT4zQXiS9YnbR39F"
    }
  }
}

Gets the current oracle price.

Gets the oracle price at the current height of the blockchain.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "oracle_price_current"
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "price": 131069500,
    "height": 633936
  }
}

Gets an oracle price at a height.

Gets the oracle price at the given height of the blockchain (if known).

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "oracle_price_get",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "price": 131069500,
    "height": 633936
  }
}

Get a pending transaction.

Get the previously submitted transaction with status.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "pending_transaction_get",
  "params": {
    "hash": "xG-KdomBEdp4gTiJO1Riif92DoMd5hPxadcSci05pIs"
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "txn": {
      "implicit_burn": {
        "fee": 1401125,
        "payer": "1b93cMbumsxd2qgahdn7dZ19rzNJ7KxEHsLfT4zQXiS9YnbR39F"
      }
    }
  }
}

Get pending transaction status.

Get the status a previously submitted transaction.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "pending_transaction_status",
  "params": {
    "hash": "xG-KdomBEdp4gTiJO1Riif92DoMd5hPxadcSci05pIs"
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": "cleared"
}

Submit a transaction to the pending queue.

Submits a pending transaction to the pending queue. The transactions needs to be in a blockchain_txn envelope and base64 encoded

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "pending_transaction_submit",
  "params": {
    "txn": "QoWBCIe..."
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "implicit_burn": {
      "fee": 1401125,
      "payer": "1b93cMbumsxd2qgahdn7dZ19rzNJ7KxEHsLfT4zQXiS9YnbR39F"
    }
  }
}

Verify a transaction prior to submitting to the pending queue.

Verifies a transaction prior to submitting to the pending queue. The transactions needs to be in a blockchain_txn envelope and base64 encoded. Result returns "valid" if the transaction is valid; otherwise, the error message is present.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "pending_transaction_verify",
  "params": {
    "txn": "QoWBCIe..."
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890"
}

Gets an implicit burn for a transaction hash.

Gets an implicit burn for a transaction hash. Returns amount of HNT burned for a DC fee.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "implicit_burn_get",
  "params": {
    "hash": "13BnsQ6rZVHXHxT8tgYX6njGxppkVEEcAxDdHV51Vwikrh8XBP9"
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "fee": 1401125,
    "payer": "1b93cMbumsxd2qgahdn7dZ19rzNJ7KxEHsLfT4zQXiS9YnbR39F"
  }
}

Gets HTLC details for an HTLC address.

Gets HTLC details for an HTLC address. If an HTLC was redeemed, it will also show the redemption height.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "htlc_get",
  "params": {
    "address": "13BnsQ6rZVHXHxT8tgYX6njGxppkVEEcAxDdHV51Vwikrh8XBP9"
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "address": "13BnsQ6rZVHXHxT8tgYX6njGxppkVEEcAxDdHV51Vwikrh8XBP9",
    "balance": 10,
    "hashlock": "AQEFmiouhIzFHBeCyW4J3sBKvBD3m2yuktTxUf14cIo",
    "payee": "14zemQxLLimdTkHnpBU8f6o3DMmU9QfrreqsR1rYUF4tLveyc62",
    "payer": "13udMhCkD4RmVCKKtprt96UAEBMppT55fs1z9viS6Uha8EWSWGe",
    "redeemed_at": 930213,
    "timelock": 100
  }
}

Create a new wallet.

Creates a new wallet, encrypted with the given password. The wallet is locked after creation.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_create",
  "params": {
    "password": "a password"
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": "13Ya3s4k8dsbd1dey6dmiYbwk4Dk1MRFCi3RBQ7nwKnSZqnYoW5"
}

Delets a wallet.

Permanently removes the wallet from the database.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_delete",
  "params": {
    "address": "13Ya3s4k8dsbd1dey6dmiYbwk4Dk1MRFCi3RBQ7nwKnSZqnYoW5"
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": true
}

List all wallets.

Lists the public keys of all wallets.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_list"
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": [
    "13Ya3s4k8dsbd1dey6dmiYbwk4Dk1MRFCi3RBQ7nwKnSZqnYoW5"
  ]
}

Unlock a wallet for signing.

Unlock a wallet for signing. The wallet will be unlocked for 60 seonds.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_unlock",
  "params": {
    "address": "13Ya3s4k8dsbd1dey6dmiYbwk4Dk1MRFCi3RBQ7nwKnSZqnYoW5",
    "password": "a password"
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": true
}

Lock a wallet.

Locks a previously unlocked wallet.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_lock",
  "params": {
    "address": "13Ya3s4k8dsbd1dey6dmiYbwk4Dk1MRFCi3RBQ7nwKnSZqnYoW5"
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": true
}

Checks if a wallet is locked.

Checks if a wallet is unlocked.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_is_locked",
  "params": {
    "address": "13Ya3s4k8dsbd1dey6dmiYbwk4Dk1MRFCi3RBQ7nwKnSZqnYoW5"
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": true
}

Send a payment to another account.

Sends a single payment in bones to a given account address. Note that 1 HNT it 100_000_000 bones

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_pay",
  "params": {
    "address": "13Ya3s4k8dsbd1dey6dmiYbwk4Dk1MRFCi3RBQ7nwKnSZqnYoW5",
    "payee": "13buBykFQf5VaQtv7mWj2PBY9Lq4i1DeXhg7C4Vbu3ppzqqNkTH",
    "bones": 1000,
    "token_type": "hnt",
    "max": "false",
    "nonce": 422
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "implicit_burn": {
      "fee": 1401125,
      "payer": "1b93cMbumsxd2qgahdn7dZ19rzNJ7KxEHsLfT4zQXiS9YnbR39F"
    }
  }
}

Send multiple paymens in a single transation.

Sends multiple payments in bones to one or more payees. Note that 1 HNT it 100_000_000 bones

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_pay_multi",
  "params": {
    "payments": [
      {
        "token_type": "hnt",
        "max": "false"
      }
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "implicit_burn": {
      "fee": 1401125,
      "payer": "1b93cMbumsxd2qgahdn7dZ19rzNJ7KxEHsLfT4zQXiS9YnbR39F"
    }
  }
}

Import an encrypted wallet.

Import an encrypted wallet into the wallet database. The password is only used to verify that the wallet can be unlocked and is not stored.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_import",
  "params": {
    "password": "a password"
  }
}

{
  "jsonrpc": "2.0",
  "id": "1234567890"
}

Export an encrypted wallet to a given path.

Exports an encrypted wallet to the given path.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_export",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": "1234567890"
}

Export the secret key bytes for a wallet to a given path.

Exports the secret keybytes of a given unlocked wallet to the given path.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_export_secret",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": "1234567890"
}

Lists information on the list of backups in the given path.

Backup list information includes the backup ID, size, and the time the backup was created.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_backup_list",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": [
    {
      "backup_id": 2,
      "number_files": 3
    }
  ]
}

Creates a backup of the wallet database.

Creates a backup of the backup database in the given path.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_backup_create",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "result": {
    "backup_id": 2,
    "number_files": 3
  }
}

Delete a backup.

Delete the backup with the given ID from the given backup path.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_backup_delete",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": "1234567890"
}

Restore the wallet database.

Restores the wallet database from the backup ID in the given backup folder.

{
  "jsonrpc": "2.0",
  "id": "1234567890",
  "method": "wallet_backup_restore",
  "params": {}
}

{
  "jsonrpc": "2.0",
  "id": "1234567890"
}