Node API Reference

Usage

The JSON-RPC API can be consumed through different transports: TCP, HTTP and Websockets. The node operator can enable or disable the JSON-RPC service, as well as specify a different network address for each transport in the node's configuration file. By default, the tcp port is set to be 21338, http to 21339 and the ws to 21340.

Sensitive methods

Sensitive methods are those that either use the node's master key or provide information that may compromise the node's public key or address, or even the node's private key itself.

Sensitive methods allow node operators to easily manage their own nodes from a command line interface within the same host or private network. By default, sensitive methods are enabled.

When exposing any of the JSON-RPC ports (tcp/21388, http/21339, ws/21340) to a public IP, ensure to disable sensitive methods first by setting enable_sensitive_methods = false in your node's witnet.toml configuration file.

• addPeers

• authorizeStake

• clearPeers

• createVRF

• getPkh

• getPublicKey

• initializePeers

• masterKeyExport

• rewind

• sendRequest

• sendValue

• sign

• stake

• tryRequest

Public methods

Public methods provide information that do not compromise node's private information, like its private or public key, or address:

• dataRequestReport

• getBalance

• getBlock

• getBlockChain

• getConsensusConstants

• getMempool

• getReputation

• getReputationAll

• getSuperblock

• getSupplyInfo

• getTransaction

• getUtxoInfo

• knownPeers

• inventory

• nodeStats

• peers

• priority

• protocol

• queryStakes

• signalingInfo

• syncStatus

---

addPeers

Add one or more peer addresses to the list of available ones.

Parameters

• Vec<SocketAddr>

Returns

• true

Example

Request

{
    "jsonrpc":"2.0",
    "id":1,
    "method":"addPeers",
    "params": [
        "5.9.5.85:22339", 
        "45.130.104.29:21336"
    ] 
}

Response

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

---

authorizeStake

Create a stake authorization for the given address.

Parameters

• AuthorizeStake

Returns

• StakeAuthorization

Example

Request

{
  "jsonrpc":"2.0",
  "method":"authorizeStake",
  "params":{
    "withdrawer":"twit13u2luhdlfzu700augc9mm9sa0xhng6jc34r5vy"
  },
  "id":"1"
}

Response

{
  "jsonrpc": "2.0",
  "result": {
    "signature": {
      "public_key": {
        "bytes": [
          101,231,80,230,185,157,78,151,167,243,100,103,76,127,196,106,176,129,160,101,228,59,157,29,107,253,125,255,14,243,227,27
        ],
        "compressed": 3
      },
      "signature": {
        "Secp256k1": {
          "der": [
            48,69,2,33,0,146,100,190,204,55,107,160,55,65,201,156,170,87,180,179,145,223,183,147,239,245,246,46,100,128,13,232,22,73,37,247,66,2,32,9,185,249,36,41,3,124,32,106,55,203,248,38,112,46,194,30,232,5,2,127,242,1,254,162,46,71,40,216,183,146,147
          ]
        }
      }
    },
    "withdrawer": "twit13u2luhdlfzu700augc9mm9sa0xhng6jc34r5vy"
  },
  "id": "1"
}

---

clearPeers

Clear all peers from the list of available ones.

Parameters

• None.

Returns

• true

Example

Request

{"jsonrpc":"2.0","id":1,"method":"clearPeers"}

Response

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

---

createVRF

Create a VRF proof for the provided message with the stored key.

Parameters

• Vec<u8>

Returns

• Vec<u8>

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method": "createVRF",
  "params": [1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1]
}

Response

{
  "jsonrpc":"2.0",
  "id":1,
  "result":[2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2]
}

---

dataRequestReport

Show information about a data request.

Parameters

• drTxHash: Data request transaction hash.

Returns

• DataRequestInfo

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method":"dataRequestReport",
  "params":["de93bfab2acf2cd4d9f63b80030370e399de975efcb695e298b64b3345ef5a9e"]
}

Response

{
  "jsonrpc":"2.0",
  "id":1
  "result":{
    "block_hash_dr_tx":"b57bd08bbace0a2e5f50727125280ce79558c0dea0c0a2b0e6afb73dfcd66cb5",
    "block_hash_tally_tx":"ffda00517779d41c69bcdffcc9a8712f4409a3a450fd480dcaea3f87d5474723",
    "current_commit_round":2,
    "current_reveal_round":1,
    "current_stage":null,
    "commits":{
      "wit1307xzln4v3947umyhqst4axgljpck6htmxs65j":{
        "body":{
          "bn256_public_key":null,
          "collateral":[
            {
              "output_pointer":"e3186bf4ffef6d4abfc4bc4417934721300082e8e62292b3224876d04c362d98:0"
            }
          ],
          "commitment":"757b7369d4098d7af11b6ed0f926e64538e316f2d7508fd19e59e0cfbbae91ba",
          "dr_pointer":"de93bfab2acf2cd4d9f63b80030370e399de975efcb695e298b64b3345ef5a9e",
          "outputs":[
            {
              "pkh":"wit1307xzln4v3947umyhqst4axgljpck6htmxs65j",
              "time_lock":0,
              "value":134547600522
            }
          ],
          "proof":{
            "proof":{
              "proof":[2, 129, 181, 148, 6, 251, 28, 203, 245, 157, 206, 237, 204, 25, 50, 130, 155, 77, 192, 24, 61, 22, 5, 131, 201, 160, 19, 221, 121, 177, 124, 173, 35, 137, 187, 180, 184, 198, 218, 59, 115, 219, 220, 209, 159, 239, 124, 184, 65, 212, 112, 146, 214, 114, 224, 159, 227, 197, 180, 81, 118, 131, 250, 112, 188, 154, 221, 137, 104, 126, 106, 225, 197, 175, 108, 84, 146, 20, 202, 226, 153],
              "public_key":{
                "bytes":[253, 242, 46, 51, 111, 53, 231, 64, 148, 82, 37, 188, 226, 235, 187, 202, 175, 195, 1, 111, 165, 123, 152, 164, 50, 32, 134, 224, 68, 87, 228, 138],
                "compressed":2
              }
            }
          }
        },
        "signatures":[
          {
            "public_key":{
              "bytes":[253, 242, 46, 51, 111, 53, 231, 64, 148, 82, 37, 188, 226, 235, 187, 202, 175, 195, 1, 111, 165, 123, 152, 164, 50, 32, 134, 224, 68, 87, 228, 138],
              "compressed":2
            },
            "signature":{
              "Secp256k1":{
                "der":[48, 68, 2, 32, 121, 254, 11, 235, 9, 231, 56, 144, 178, 231, 147, 103, 0, 45, 229, 225, 150, 24, 205, 195, 3, 88, 134, 228, 48, 222, 251, 56, 253, 228, 189, 220, 2, 32, 116, 105, 4, 61, 149, 27, 200, 132, 103, 152, 186, 15, 205, 207, 96, 17, 235, 103, 83, 226, 125, 116, 244, 230, 182, 34, 6, 231, 105, 105, 54, 248]
              }
            }
          }
        ]
      },
      ...
    },
    "reveals":{
      "wit1307xzln4v3947umyhqst4axgljpck6htmxs65j":{
        "body":{
          "dr_pointer":"de93bfab2acf2cd4d9f63b80030370e399de975efcb695e298b64b3345ef5a9e",
          "pkh":"wit1307xzln4v3947umyhqst4axgljpck6htmxs65j",
          "reveal":[ 26, 0, 70, 167, 118 ]
        },
        "signatures":[
          {
            "public_key":{
              "bytes":[ 253, 242, 46, 51, 111, 53, 231, 64, 148, 82, 37, 188, 226, 235, 187, 202, 175, 195, 1, 111, 165, 123, 152, 164, 50, 32, 134, 224, 68, 87, 228, 138 ],
              "compressed":2
            },
            "signature":{
              "Secp256k1":{
                "der":[48, 68, 2, 32, 122, 190, 218, 127, 118, 217, 6, 220, 204, 212, 70, 200, 176, 83, 49, 131, 141, 80, 9, 112, 53, 146, 5, 14, 45, 223, 233, 7, 118, 44, 174, 157, 2, 32, 51, 216, 43, 196, 245, 64, 255, 117, 79, 167, 183, 121, 168, 129, 149, 31, 0, 6, 162, 110, 157, 15, 206, 198, 135, 123, 29, 131, 115, 191, 124, 29]
              }
            }
          }
        ]
      },
      ...
    },
    "tally":{
      "dr_pointer":"de93bfab2acf2cd4d9f63b80030370e399de975efcb695e298b64b3345ef5a9e",
      "error_committers":[],
      "out_of_consensus":[],
      "outputs":[
        {
          "pkh":"wit1fn3jvuch23n6h388f4phz2ldm2jqnznw7zk8tg",
          "time_lock":0,
          "value":15150000000
        },
        ...
      ],
      "tally":[26, 0, 70, 167, 118]
    }
  }
}

---

getBalance

Get the balance of a the pkh.

Parameters

• pkh: The public key hash to get the balance from.

• simple?: Distinguish between fetching a simple balance or fetching confirmed and unconfirmed balance. Defaults to `false`.

Returns

• NodeB​alance

Example

Request

{
    "jsonrpc":"2.0",
    "id":1,
    "method":"getBalance",
    "params":["wit1vcpsy5cmfaz2jgt5h3getdkqh38cs5edkxmnla"]
}

Response

{
    "jsonrpc":"2.0",
    "id":1,
    "result":{
        "confirmed":2426279100000000,
        "total":2426279100000000
    }
}

---

getBlock

Get detailed information about a block being queried by its hash.

Parameters

• blockHash: The hash of the block must be provided as a hexadecimal string.

• metadata: (Optional) If set to true, transactions metadata will be provided.

Returns

• Block

Example

Request

{
    "jsonrpc":"2.0",
    "id":1,
    "method":"getBlock",
    "params":[
        "0fc5be1043da24fb0a6e6420d9df286fdc22fada5b371dbb547dad4e08e83212", 
        true
    ]
}

Response

{
  "jsonrpc":"2.0",
  "id":1,
  "result":{ 
     // Block data
     ...
  }
}

---

getBlockChain

Get the list of all the known block hashes.

Parameters

• epoch: (Optional) First epoch for which to return block hashes. If the provided value is negative, it returns block hashes from the last n epochs. Default to 0.

• limit: (Optional) Number of block hashes to return. If the provided value is negative, return the last n block hashes from this epoch range. If the value is zero, it's unlimited. Default to 0.

Returns

• Vec<u32, Hash>: An array of epochs and block hashes.

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getBlockChain",
  "params": { "limit": 1, "epoch": 1 }
}

Response

  {
    "jsonrpc":"2.0",
    "id":1,
    "result":[
      [ 1, "4571a766e87dbf2dba5f16756a9bbf812911c7e287738f256b4a6b9238783cd6" ]
    ],
  }

---

getConsensusConstants

Get consensus constants used by the node.

Parameters

• None

Returns

• ConsensusConstants

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getConsensusConstants",
  "params":null
}

Response

{
  "jsonrpc":"2.0",
  "result":{
    "activity_period":2000,
    "bootstrap_hash":"666564676f6573627272727c2f3030312f3738392f3432382f6130312e676966",
    "bootstrapping_committee":[
      "wit1g0rkajsgwqux9rnmkfca5tz6djg0f87x7ms5qx",
      "wit1cyrlc64hyu0rux7hclmg9rxwxpa0v9pevyaj2c",
      "wit1asdpcspwysf0hg5kgwvgsp2h6g65y5kg9gj5dz",
      "wit13l337znc5yuualnxfg9s2hu9txylntq5pyazty",
      "wit17nnjuxmfuu92l6rxhque2qc3u2kvmx2fske4l9",
      "wit1etherz02v4fvqty6jhdawefd0pl33qtevy7s4z",
      "wit1drcpu0xc2akfcqn8r69vw70pj8fzjhjypdcfsq",
      "wit1gxf0ca67vxtg27kkmgezg7dd84hwmzkxn7c62x",
      "wit1hujx8v0y8rzqchmmagh8yw95r943cdddnegtgc",
      "wit1yd97y52ezvhq4kzl6rph6d3v6e9yya3n0kwjyr",
      "wit1fn5yxmgkphnnuu6347s2dlqpyrm4am280s6s9t",
      "wit12khyjjk0s2hyuzyyhv5v2d5y5snws7l58z207g"
    ],
    "checkpoint_zero_timestamp":1602666000,
    "checkpoints_period":45,
    "collateral_age":1000,
    "collateral_minimum":1000000000,
    "epochs_with_minimum_difficulty":2000,
    "extra_rounds":3,
    "genesis_hash":"6ca267d9accde3336739331d42d63509b799c6431e8d02b2d2cc9d3943d7ab02",
    "halving_period":3500000,
    "initial_block_reward":250000000000,
    "max_dr_weight":80000,
    "max_vt_weight":20000,
    "minimum_difficulty":2000,
    "mining_backup_factor":8,
    "mining_replication_factor":3,
    "reputation_expire_alpha_diff":20000,
    "reputation_issuance":1,
    "reputation_issuance_stop":1048576,
    "reputation_penalization_factor":0.5,
    "superblock_committee_decreasing_period":5,
    "superblock_committee_decreasing_step":5,
    "superblock_period":10,
    "superblock_signing_committee_size":100
  },
  "id":1
}

---

getMempool

Get all the pending transactions.

Parameters

• None

Returns

• GetMempoolResult

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getMempool",
  "params":null
}

Response

{
  "jsonrpc":"2.0",
  "result":{
    "data_request":[
      "c628764c5f20c95a204ccbb5d58ec5df24ca692f766b3006f7b9421cf972975e"
    ],
    "value_transfer":[
      ...      
    ]
  },
  "id":1
}

---

getPublicKey

Get the public key of the node.

Parameters

• None

Returns

• [u8; 33]

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getPublicKey",
  "params":[]
}

Response

  {
    "jsonrpc":"2.0",
    "result": [1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30,31,32,33]",
    "id":1
  }

---

getPkh

Get public address of the node.

Parameters

• None

Returns

• String

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getPkh",
  "params":[]
}

Response

{
  "jsonrpc":"2.0",
  "result":"wit1234567890abcdefghijklmnopqrstuvwxyz123",
  "id":1
}

---

getReputation

Displays the reputation score associated with a given public address and its eligibility to mine a block.

Parameters

• pkh: The Witnet public address.

Returns

• GetReputationResult

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getReputation",
  "params": ["wit1nwhl5clpeste6gsexmd706c5jv64kc8fd5q94s"] 
}

Response

{
  "jsonrpc":"2.0",
  "result":{
    "stats":{
      "wit1nwhl5clpeste6gsexmd706c5jv64kc8fd5q94s":{
        "eligibility":666,
        "is_active":true,
        "reputation":324
      }
    },
    "total_reputation":1054296
  },
  "id":1
}

---

getReputationAll

Get all the nodes active and their elegibility. It also lists the nodes with reputation grater than 0 but not active, if any.

Note that it is perfectly normal for a node to show 0 reputation for the first days of it being up. Please be patient, new identities in the system are subject to a slow start for critical security reasons.

Parameters

• None.

Returns

• GetReputationResult

Example

Request

{"jsonrpc":"2.0","id":1,"method":"getReputationAll" }

Response

{
  "jsonrpc":"2.0",
  "result":{
    "stats":{
      "wit10006hgq4m3faf425h3ydm4y20qyz2n0k39gqe9":{
        "eligibility":1,
        "is_active":true,
        "reputation":0
      },
      "wit1002p478qpt79zru0evkaadhhukj57exa77fs2v":{
        "eligibility":1,
        "is_active":true,
        "reputation":0
      },
      ...
      ...
    }
    "total_reputation":1054370
  },
  "id":1
}

---

getSuperblock

Get the blocks that pertain to the superblock specified.

Parameters

Map including one only of these:

• block_epoch: Superblock epoch.

• superblock_index: Superblock index.

Returns

• SuperBlockNotify

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getSuperblock",
  "params": { 
    "block_epoch": 1800000 
  } 
}

Response

{
  "jsonrpc":"2.0",
  "result":{
    "consolidated_block_hashes":[
      "9b34cb85824d173b603f1f55bde4d6bce06066e577ae6d3b364aea9e15916ecd",
      "3cf4d7dbfa5edfd83ca65864effe9f857d17c6cebaac417c7c1a30ed448222e4",
      "2193d6d6aa7e2a6ea8328a4ed1f5efa78dc2552ad9088d534f929f92c6b344db",
      "37546ac2a0f20ee9af617d368438bf6945fcdbaf9d38582dabfb421343765674",
      "cd8049ee7642e57d88df69ee520aa50dc4a968ea4169254f2f6b8bfa0aa87986",
      "c50c21d54d124459fb0dc9fa022098e71e26b957db5ce92199e868ab7df472d3",
      "d5045f999a7542787aa285e537de0ba290867e025600db2c8a07c3116a4e805e",
      "96b27cb0017806f701aad3382cf447c54ca7339dd2b1d9dbbe92c12752f97a89",
      "7470ff40b7b630b825ade9e0b3f93f8dac3e4bae2f86b7ab3e0eabac66cc63ab",
      "b64ae8ac5fbec6a46ea9d61ed0e20703f59cea680871489808944ddeece10a24"
    ],
    "superblock":{
      "ars_root":"fe5282ad72b912103af8badfb33cd401e327f18c33fa6e177f06933602728917",
      "data_request_root":"d6854103b15ff5f9399e0d4267689aa43d5817de452545dd513cf9c1434f04d1",
      "index":180001,
      "last_block":"b64ae8ac5fbec6a46ea9d61ed0e20703f59cea680871489808944ddeece10a24",
      "last_block_in_previous_superblock":"d8570b129fcfcd88fc1eee52aef2281b8f4bb5266ea9ba2e1ae89fae0e93655e",
      "signing_committee_length":100,
      "tally_root":"4c5e06e77405fd8178145e3208bda87af29c0d90dd95a1f9efa664851577c40e"
    }
  },
  "id":1
}

---

getSupplyInfo

Get supply information.

Parameters

• None

Returns

• SupplyInfo

Example

Request

{"jsonrpc":"2.0","id":1,"method":"getSupplyInfo","params": [] }

Response

{
  "jsonrpc":"2.0",
  "result":{
    "blocks_minted":1956314,
    "blocks_minted_reward":489078500000000000,
    "blocks_missing":59817,
    "blocks_missing_reward":14954250000000000,
    "current_locked_supply":50050000000,
    "current_time":1693391940,
    "current_unlocked_supply":1238509862457667720,
    "epoch":2016132,
    "in_flight_requests":2,
    "locked_wits_by_requests":15500000000,
    "maximum_supply":2499431427962167720
  },
  "id":1
}

---

getTransaction

Get detailed information about a transaction being queried by its hash.

Parameters

• txHash: It should be provided as a hexadecimal string.

Returns

• Transaction

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getTransaction",
  "params": ["0afd47114900d4ab866a80203f54900b9fee6bdcd0a44f0be8cad3587c7a445a"] 
}

Response

{
  "jsonrpc":"2.0",
  "id":1
  "result": {
    "blockEpoch":2016368,
    "blockHash":"400e7c93f9f715953229f901d0632d1a5826ce7cc2aabe9c4ef17524abe0716f",
    "confirmed":true,
    "transaction":{
      "ValueTransfer":{
        "body":{
          "inputs":[
            {
              "output_pointer":"f8214a721f1eb2c3136bce6a21e9c8b2f024c3135273c88d7a0bbafa3309d46c:1"
            },
            {
              "output_pointer":"564dfaa8beffdbd6490973f2d63c0614d15d3c68ef8b95bf5509607ebf5e7659:0"
            },
            {
              "output_pointer":"65eb3ce6657f8c3ca5f43e419e39bce26b9466d8ffd1b9b1c75529f0f262caf0:0"
            }
          ],
          "outputs":[
            {
              "pkh":"wit1y8y2lwxzmplq8m9c32znsv9h732srj09uq6wwf",
              "time_lock":0,
              "value":58186900000000
            },
            {
              "pkh":"wit1avahnh0f5yzatwvqw8ggg74puylfv5rzz7lxce",
              "time_lock":0,
              "value":40267717748000
            }
          ]
        },
        "signatures":[
          {
            "public_key":{
              "bytes": [168,76,60,25,76,29,57,64,9,192,246,50,77,132,196,204,39,175,103,194,45,93,161,113,20,128,240,3,4,132,140,242 ],
              "compressed":2
            },
            "signature":{
              "Secp256k1":{
                "der": [48,68,2,32,13,178,108,144,169,163,132,37,220,50,26,59,55,189,198,238,179,224,50,223,160,56,251,235,6,9,103,194,241,187,231,185,2,32,10,0,125,149,100,22,36,169,196,199,8,126,149,51,253,251,168,40,70,92,254,187,105,23,118,125,244,102,21,236,184,134]
              }
            }
          },
          {
            "public_key":{
              "bytes": [108,146,137,55,19,101,172,42,40,39,159,174,167,122,65,100,188,160,209,159,235,75,80,93,129,255,225,173,200,54,153,61],
              "compressed":3
            },
            "signature":{
              "Secp256k1":{
                "der": [48,69,2,33,0,138,236,155,104,126,68,141,116,170,227,136,1,20,250,26,171,209,68,238,131,9,41,234,13,193,78,195,32,89,165,156,66,2,32,55,61,102,144,112,99,100,147,81,236,91,30,136,231,146,41,34,93,19,13,43,188,77,250,141,130,140,197,174,182,193,143]
              }
            }
          },
          {
            "public_key":{
              "bytes": [108,146,137,55,19,101,172,42,40,39,159,174,167,122,65,100,188,160,209,159,235,75,80,93,129,255,225,173,200,54,153,61],
              "compressed":3
            },
            "signature":{
              "Secp256k1":{
                "der": [48,69,2,33,0,138,236,155,104,126,68,141,116,170,227,136,1,20,250,26,171,209,68,238,131,9,41,234,13,193,78,195,32,89,165,156,66,2,32,55,61,102,144,112,99,100,147,81,236,91,30,136,231,146,41,34,93,19,13,43,188,77,250,141,130,140,197,174,182,193,143]
              }
            }
          }
        ]
      }
    },
    "weight":1119
  }
}

---

getUtxoInfo

Get unspent transaction outputs belonging to given public address.

Parameters

• pkh: Public address.

Returns

• UtxoInfo

Example

Request

{
  "jsonrpc":"2.0",
  "id":1,
  "method":"getUtxoInfo",
  "params": ["wit1234567890abcdefghijklmnopqrstuvwxyz123"] 
}

Response

{
  "jsonrpc":"2.0",
  "result":{
    "collateral_min":1000000000,
    "utxos":[
      {
        "output_pointer":"1234567890abcdefghijklmnopqrstuvwxyz1234567890123456789012345678:0",
        "timelock":0,
        "utxo_mature":false,
        "value":84420000000
      }
    ]
  },
  "id":1
}

---

knownPeers

Get the list of peer addresses known to the node.

Parameters

• None

Returns

A list with the address of the peer and the type which can be new or tried.

• Vec<AddrType>

Example

Request

{"jsonrpc":"2.0","id":1,"method":"knownPeers","params": [] }

Response

{
  "jsonrpc":"2.0",
  "result":[
    {
      "address":"5.9.110.149:22345",
      "type":"new"
    },
    {
      "address":"5.9.116.217:22372",
      "type":"tried"
    },
    ...
  ],
  "id":1
}

---

initializePeers

Initialize all known peers present in witnet.toml#connections.

Parameters

• None

Returns

• true

Example

Request

 {"jsonrpc":"2.0","id":1,"method":"initializePeers"}

Response

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

---

inventory

Make the node process, validate and potentially broadcast a new inventory entry.

Parameters

• Accepts the JSON serialization of a well-formed Block or Transaction.

Returns

• true if no errors.

Example

Request

 {
   "jsonrpc":"2.0",
   "id":1,
   "method": "inventory", 
   "params": {
     "transaction": {
       "ValueTransfer": {
         "body": {
           "inputs": [
             {
               "output_pointer": "0000000000000000000000000000000000000000000000000000000000000000:0"
             }
           ], 
           "outputs": [
             {
               "pkh": "wit100000000000000000000000000000000123456", 
               time_lock: 0, 
               value: 1
             }
           ]
         }, 
         "signatures": [
           {