The `parity` Module - Wiki Parity Tech Documentation

JSON-RPC methods

Account Vaults

Accounts (read-only) and Signatures

Block Authoring (aka “mining”)

Development

Network Information

Node Settings

JSON-RPC API Reference

parity_cidV0

Compute a v0 IPFS Content ID from protobuf encoded bytes.

Parameters

  1. Data - to encode.
params: ["0x666f6f626172"]

Returns

Example

Request

curl --data '{"method":"parity_cidV0","params":["0x666f6f626172"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_composeTransaction

Given partial transaction request produces transaction with all fields filled in. Such transaction can be then signed externally.

Parameters

  1. Object - see eth_sendTransaction.
    • from: Address - 20 Bytes - The address the transaction is send from.
    • to: Address - (optional) 20 Bytes - The address the transaction is directed to.
    • gas: Quantity - (optional) Integer of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.
    • gasPrice: Quantity - (optional) Integer of the gas price used for each paid gas.
    • value: Quantity - (optional) Integer of the value sent with this transaction.
    • data: Data - (optional) 4 byte hash of the method signature followed by encoded parameters. For details see Ethereum Contract ABI.
    • nonce: Quantity - (optional) Integer of a nonce. This allows to overwrite your own pending transactions that use the same nonce.
    • condition: Object - (optional) Conditional submission of the transaction. Can be either an integer block number { block: 1 } or UTC timestamp (in seconds) { time: 1491290692 } or null.
params: [{
  "from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
  "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
  "value": "0x9184e72a" // 2441406250
}]

Returns

Example

Request

curl --data '{"method":"parity_composeTransaction","params":[{"from":"0xb60e8dd61c5d32be8058bb8eb970870f07233155","to":"0xd46e8dd67c5d32be8058bb8eb970870f07244567","value":"0x9184e72a"}],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "condition": null,
    "data": "0x",
    "from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
    "gas": "0xe57e0",
    "gasPrice": "0x4a817c800",
    "nonce": "0x0",
    "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
    "value": "0x9184e72a"
  }
}

parity_consensusCapability

Returns information on current consensus capability.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_consensusCapability","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_decryptMessage

Decrypt a message encrypted with a ECIES public key.

Parameters

  1. Address - Account which can decrypt the message.
  2. Data - Encrypted message.
params: [
  "0x00a329c0648769a73afac7f9381e08fb43dbea72",
  "0x0405afee7fa2ab3e48c27b00d543389270cb7267fc191ca1311f297255a83cbe8d77a4ba135b51560700a582924fa86d2b19029fcb50d2b68d60a7df1ba81df317a19c8def117f2b9cf8c2618be0e3f146a5272fb9e5528719d2d7a1bd91fa620901cffa756305c79c093e7af30fa3c1587029421351c34a7c1e5a2b"
]

Returns

Example

Request

curl --data '{"method":"parity_decryptMessage","params":["0x00a329c0648769a73afac7f9381e08fb43dbea72","0x0405afee7fa2ab3e48c27b00d543389270cb7267fc191ca1311f297255a83cbe8d77a4ba135b51560700a582924fa86d2b19029fcb50d2b68d60a7df1ba81df317a19c8def117f2b9cf8c2618be0e3f146a5272fb9e5528719d2d7a1bd91fa620901cffa756305c79c093e7af30fa3c1587029421351c34a7c1e5a2b"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x68656c6c6f20776f726c64" // hello world
}

parity_encryptMessage

Encrypt some data with a public key under ECIES.

Parameters

  1. Hash - Public EC key generated with secp256k1 curve, truncated to the last 64 bytes.
  2. Data - The message to encrypt.
params: [
  "0xD219959D466D666060284733A80DDF025529FEAA8337169540B3267B8763652A13D878C40830DD0952639A65986DBEC611CF2171A03CFDC37F5A40537068AA4F",
  "0x68656c6c6f20776f726c64" // "hello world"
]

Returns

Example

Request

curl --data '{"method":"parity_encryptMessage","params":["0xD219959D466D666060284733A80DDF025529FEAA8337169540B3267B8763652A13D878C40830DD0952639A65986DBEC611CF2171A03CFDC37F5A40537068AA4F","0x68656c6c6f20776f726c64"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x0491debeec5e874a453f84114c084c810708ebcb553b02f1b8c05511fa4d1a25fa38eb49a32c815e2b39b7bcd56d66648bf401067f15413dae683084ca7b01e21df89be9ec4bc6c762a657dbd3ba1540f557e366681b53629bb2c02e1443b5c0adc6b68f3442c879456d6a21ec9ed07847fa3c3ecb73ec7ee9f8e32d"
}

parity_futureTransactions

This method is deprecated in favor of parity_allTransactions

Returns all future transactions from transaction queue.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_futureTransactions","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "hash": "0x80de421cd2e7e46824a91c343ca42b2ff339409eef09e2d9d73882462f8fce31",
      "nonce": "0x1",
      "blockHash": null,
      "blockNumber": null,
      "transactionIndex": null,
      "from": "0xe53e478c072265e2d9a99a4301346700c5fbb406",
      "to": "0xf5d405530dabfbd0c1cab7a5812f008aa5559adf",
      "value": "0x2efc004ac03a4996",
      "gasPrice": "0x4a817c800",
      "gas": "0x5208",
      "input": "0x",
      "creates": null,
      "raw": "0xf86c018504a817c80082520894f5d405530dabfbd0c1cab7a5812f008aa5559adf882efc004ac03a49968025a0b40c6967a7e8bbdfd99a25fd306b9ef23b80e719514aeb7ddd19e2303d6fc139a06bf770ab08119e67dc29817e1412a0e3086f43da308c314db1b3bca9fb6d32bd",
      "publicKey": "0xeba33fd74f06236e17475bc5b6d1bac718eac048350d77d3fc8fbcbd85782a57c821255623c4fd1ebc9d555d07df453b2579ee557b7203fc256ca3b3401e4027",
      "networkId": 1,
      "standardV": "0x0",
      "v": "0x25",
      "r": "0xb40c6967a7e8bbdfd99a25fd306b9ef23b80e719514aeb7ddd19e2303d6fc139",
      "s": "0x6bf770ab08119e67dc29817e1412a0e3086f43da308c314db1b3bca9fb6d32bd",
      "condition": {
        "block": 1
      }
    },
    { ... }, { ... }, ...
  ]
}

parity_allTransactions

Returns all the transactions from the transaction queue.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_allTransactions","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
    "jsonrpc": "2.0",
    "result": [{
        "blockHash": null,
        "blockNumber": null,
        "chainId": null,
        "condition": null,
        "creates": null,
        "from": "0x5f3dffcf347944d3739b0805c934d86c8621997f",
        "gas": "0x493e0",
        "gasPrice": "0x12a05f200",
        "hash": "0x045301a128ffcb4662dd199d1176bdf4cc9f0628e10d6bf120edfb52e3e39a78",
        "input": "0x13f56f730...f3b4dc000",
        "nonce": "0x577",
        "publicKey": "0x3bb...9ce1b1",
        "r": "0x6fd2c7a5dbb8795038ca258196083b3eabe15a20e3020c3f45e88f2e447be410",
        "raw": "0xf88b8247d202...83eef3f8916bb818ce7",
        "s": "0x5993992c547d20234aabfc8c32a58d25784255fef500383eef3f8916bb818ce7",
        "standardV": "0x0",
        "to": "0xe8b2d01ffa0a15736b2370b6e5064f9702c891b6",
        "transactionIndex": null,
        "v": "0x1b",
        "value": "0x0"
    }, { .. }, { .. }]
}

parity_getBlockHeaderByNumber

Get block header. Same as eth_getBlockByNumber but without uncles and transactions.

Parameters

  1. Quantity Tag - integer of a block number, or the string 'earliest', 'latest' or 'pending', as in the default block parameter.
params: [
  "0x1b4" // 436
]

Returns

Example

Request

curl --data '{"method":"parity_getBlockHeaderByNumber","params":["0x1b4"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "author": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
    "difficulty": "0x4ea3f27bc",
    "extraData": "0x476574682f4c5649562f76312e302e302f6c696e75782f676f312e342e32",
    "gasLimit": "0x1388",
    "gasUsed": "0x0",
    "hash": "0xdc0818cf78f21a8e70579cb46a43643f78291264dda342ae31049421c82d21ae",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "miner": "0xbb7b8287f3f0a933474a79eae42cbca977791171",
    "mixHash": "0x4fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
    "nonce": "0x689056015818adbe",
    "number": "0x1b4",
    "parentHash": "0xe99e022112df268087ea7eafaf4790497fd21dbeeb6bd7a1721df161a6657a54",
    "receiptsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421",
    "sealFields": [
      "0xa04fffe9ae21f1c9e15207b1f472d5bbdd68c9595d461666602f2be20daf5e7843",
      "0x88689056015818adbe"
    ],
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x21b",
    "stateRoot": "0xddc8b0234c2e0cad087c8b389aa7ef01f7d79b2570bccb77ce48648aa61c904d",
    "timestamp": "0x55ba467c",
    "transactionsRoot": "0x56e81f171bcc55a6ff8345e692c0f86e5b48e01b996cadc001622fb5e363b421"
  }
}

parity_listOpenedVaults

Returns a list of all opened vaults

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_listOpenedVaults","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_listStorageKeys

Returns all storage keys of the given address (first parameter) if Fat DB is enabled (--fat-db), null otherwise.

Parameters

  1. Address - 20 Bytes - Account for which to retrieve the storage keys.
  2. Quantity - Integer number of addresses to display in a batch.
  3. Hash - 32 Bytes - Offset storage key from which the batch should start in order, or null.
  4. Quantity Tag - (optional) integer block number, or the string 'latest', 'earliest' or 'pending'.
params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  5,
  null
]

Returns

Example

Request

curl --data '{"method":"parity_listStorageKeys","params":["0x407d73d8a49eeb85d32cf465507dd71d507100c1",5,null],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    "0xaab1a2940583e213f1d57a3ed358d5f5406177c8ff3c94516bfef3ea62d00c22",
    "0xba8469eca5641b186e86cbc5343dfa5352df04feb4564cd3cf784f213aaa0319",
    "0x769d107ba778d90205d7a159e820c41c20bf0783927b426c602561e74b7060e5",
    "0x0289865bcaa58f7f5bf875495ac7af81e3630eb88a3a0358407c7051a850624a",
    "0x32e0536502b9163b0a1ce6e3aabd95fa4a2bf602bbde1b9118015648a7a51178"
  ]
}

parity_listVaults

Returns a list of all available vaults

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_listVaults","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "['Personal','Work']"
}

parity_localTransactions

Returns an object of current and past local transactions.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_localTransactions","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "0x09e64eb1ae32bb9ac415ce4ddb3dbad860af72d9377bb5f073c9628ab413c532": {
      "status": "mined",
      "transaction": {
        "from": "0x00a329c0648769a73afac7f9381e08fb43dbea72",
        "to": "0x00a289b43e1e4825dbedf2a78ba60a640634dc40",
        "value": "0xfffff",
        "blockHash": null,
        "blockNumber": null,
        "creates": null,
        "gas": "0xe57e0",
        "gasPrice": "0x2d20cff33",
        "hash": "0x09e64eb1ae32bb9ac415ce4ddb3dbad860af72d9377bb5f073c9628ab413c532",
        "input": "0x",
        "condition": {
          "block": 1
        },
        "networkId": null,
        "nonce": "0x0",
        "publicKey": "0x3fa8c08c65a83f6b4ea3e04e1cc70cbe3cd391499e3e05ab7dedf28aff9afc538200ff93e3f2b2cb5029f03c7ebee820d63a4c5a9541c83acebe293f54cacf0e",
        "raw": "0xf868808502d20cff33830e57e09400a289b43e1e4825dbedf2a78ba60a640634dc40830fffff801ca034c333b0b91cd832a3414d628e3fea29a00055cebf5ba59f7038c188404c0cf3a0524fd9b35be170439b5ffe89694ae0cfc553cb49d1d8b643239e353351531532",
        "standardV": "0x1",
        "v": "0x1c",
        "r": "0x34c333b0b91cd832a3414d628e3fea29a00055cebf5ba59f7038c188404c0cf3",
        "s": "0x524fd9b35be170439b5ffe89694ae0cfc553cb49d1d8b643239e353351531532",
        "transactionIndex": null
      }
    },
    "0x...": { ... }
  }
}

parity_releasesInfo

returns a ReleasesInfo object describing the current status of releases

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_releasesInfo","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_signMessage

Sign the hashed message bytes with the given account.

Parameters

  1. Address - Account which signs the message.
  2. String - Passphrase to unlock the account.
  3. Data - Hashed message.
params: [
  "0xc171033d5cbff7175f29dfd3a63dda3d6f8f385e",
  "password1",
  "0xbc36789e7a1e281436464229828f817d6612f7b477d66591ff96a9e064bcc98a"
]

Returns

Example

Request

curl --data '{"method":"parity_signMessage","params":["0xc171033d5cbff7175f29dfd3a63dda3d6f8f385e","password1","0xbc36789e7a1e281436464229828f817d6612f7b477d66591ff96a9e064bcc98a"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x1d9e33a8cf8bfc089a172bca01da462f9e359c6cb1b0f29398bc884e4d18df4f78588aee4fb5cc067ca62d2abab995e0bba29527be6ac98105b0320020a2efaf00"
}

parity_versionInfo

Provides information about running version of Parity.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_versionInfo","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "hash": "0x2ae8b4ca278dd7b896090366615fef81cbbbc0e0",
    "track": "null",
    "version": {
      "major": 1,
      "minor": 6,
      "patch": 0
    }
  }
}

parity_changeVault

Changes the current vault for the account

Parameters

  1. Address - Account address
  2. String - Vault name
params: [
  "0x63Cf90D3f0410092FC0fca41846f596223979195",
  "StrongVault"
]

Returns

Example

Request

curl --data '{"method":"parity_changeVault","params":["0x63Cf90D3f0410092FC0fca41846f596223979195","StrongVault"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_changeVaultPassword

Changes the password for any given vault

Parameters

  1. String - Vault name
  2. String - New Password
params: [
  "StrongVault",
  "[email protected]"
]

Returns

Example

Request

curl --data '{"method":"parity_changeVaultPassword","params":["StrongVault","[email protected]"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_closeVault

Closes a vault with the given name

Parameters

  1. String - Vault name
params: ["StrongVault"]

Returns

Example

Request

curl --data '{"method":"parity_closeVault","params":["StrongVault"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_getVaultMeta

Returns the metadata for a specific vault

Parameters

  1. String - Vault name
params: ["StrongVault"]

Returns

Example

Request

curl --data '{"method":"parity_getVaultMeta","params":["StrongVault"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "{\"passwordHint\":\"something\"}"
}

parity_newVault

Creates a new vault with the given name & password

Parameters

  1. String - Vault name
  2. String - Password
params: [
  "StrongVault",
  "[email protected]"
]

Returns

Example

Request

curl --data '{"method":"parity_newVault","params":["StrongVault","[email protected]"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_openVault

Opens a vault with the given name & password

Parameters

  1. String - Vault name
  2. String - Password
params: [
  "StrongVault",
  "[email protected]"
]

Returns

Example

Request

curl --data '{"method":"parity_openVault","params":["StrongVault","[email protected]"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_setVaultMeta

Sets the metadata for a specific vault

Parameters

  1. String - Vault name
  2. String - The metadata as a JSON string
params: [
  "StrongVault",
  "{\"passwordHint\":\"something\"}"
]

Returns

Example

Request

curl --data '{"method":"parity_setVaultMeta","params":["StrongVault","{\"passwordHint\":\"something\"}"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_accountsInfo

Provides metadata for accounts.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_accountsInfo","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "0x0024d0c7ab4c52f723f3aaf0872b9ea4406846a4": {
      "name": "Foo"
    },
    "0x004385d8be6140e6f889833f68b51e17b6eacb29": {
      "name": "Bar"
    },
    "0x009047ed78fa2be48b62aaf095b64094c934dab0": {
      "name": "Baz"
    }
  }
}

parity_checkRequest

Get the the transaction hash of the request previously posted to parity_postTransaction or parity_postSign. Will return a JSON-RPC error if the request was rejected.

Parameters

  1. Quantity - The id of the request sent to the signer.
params: ["0x1"]

Returns

Example

Request

curl --data '{"method":"parity_checkRequest","params":["0x1"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0xde8dfd9642f7eeef12402f2a560dbf40921b4f0bda01fb84709b9d71f6c181be"
}

parity_defaultAccount

Returns the defaultAccount that is to be used with transactions

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_defaultAccount","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x63Cf90D3f0410092FC0fca41846f596223979195"
}

parity_generateSecretPhrase

Creates a secret phrase that can be associated with an account.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_generateSecretPhrase","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "boasting breeches reshape reputably exit handrail stony jargon moneywise unhinge handed ruby"
}

parity_hardwareAccountsInfo

Provides metadata for attached hardware wallets

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_hardwareAccountsInfo","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "0x0024d0c7ab4c52f723f3aaf0872b9ea4406846a4": {
      "manufacturer": "Ledger",
      "name": "Nano S"
    }
  }
}

parity_listAccounts

Returns all addresses if Fat DB is enabled (--fat-db), null otherwise.

Parameters

  1. Quantity - Integer number of addresses to display in a batch.
  2. Address - 20 Bytes - Offset address from which the batch should start in order, or null.
  3. Quantity Tag - (optional) integer block number, or the string 'latest', 'earliest' or 'pending'.
params: [
  5,
  null
]

Returns

Example

Request

curl --data '{"method":"parity_listAccounts","params":[5,null],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    "0x7205b1bb42edce6e0ced37d1fd0a9d684f5a860f",
    "0x98a2559a814c300b274325c92df1682ae0d344e3",
    "0x2d7a7d0adf9c5f9073fefbdc18188bd23c68b633",
    "0xd4bb3284201db8b03c06d8a3057dd32538e3dfda",
    "0xa6396904b08aa31300ca54278b8e066ecc38e4a0"
  ]
}

parity_phraseToAddress

Converts a secret phrase into the corresponding address.

Parameters

  1. String - The phrase
params: ["stylus outing overhand dime radial seducing harmless uselessly evasive tastiness eradicate imperfect"]

Returns

Example

Request

curl --data '{"method":"parity_phraseToAddress","params":["stylus outing overhand dime radial seducing harmless uselessly evasive tastiness eradicate imperfect"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x004385d8be6140e6f889833f68b51e17b6eacb29"
}

parity_postSign

Request a standard Ethereum message to be signed by an account.

Parameters

  1. Address - Account address.
  2. Data - The message.
params: [
  "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
  "0x414243"
]

Returns

Example

Request

curl --data '{"method":"parity_postSign","params":["0xb60e8dd61c5d32be8058bb8eb970870f07233155","0x8cda01991ae267a539135736132f1f987e76868ce0269b7537d3aab37b7b185e"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x1"
}

parity_postTransaction

Posts a transaction to the signer without waiting for the signer response.

Parameters

  1. Object - see eth_sendTransaction.
    • from: Address - 20 Bytes - The address the transaction is send from.
    • to: Address - (optional) 20 Bytes - The address the transaction is directed to.
    • gas: Quantity - (optional) Integer of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.
    • gasPrice: Quantity - (optional) Integer of the gas price used for each paid gas.
    • value: Quantity - (optional) Integer of the value sent with this transaction.
    • data: Data - (optional) 4 byte hash of the method signature followed by encoded parameters. For details see Ethereum Contract ABI.
    • nonce: Quantity - (optional) Integer of a nonce. This allows to overwrite your own pending transactions that use the same nonce.
    • condition: Object - (optional) Conditional submission of the transaction. Can be either an integer block number { block: 1 } or UTC timestamp (in seconds) { time: 1491290692 } or null.
params: [{
  "from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155",
  "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567",
  "gas": "0x76c0", // 30400
  "gasPrice": "0x9184e72a000", // 10000000000000
  "value": "0x9184e72a", // 2441406250
  "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675",
  "condition": {
    "block": 354221,
    "time": "2017-07-31T08:53:46.544Z"
  }
}]

Returns

Example

Request

curl --data '{"method":"parity_postTransaction","params":[{"from":"0xb60e8dd61c5d32be8058bb8eb970870f07233155","to":"0xd46e8dd67c5d32be8058bb8eb970870f07244567","gas":"0x76c0","gasPrice":"0x9184e72a000","value":"0x9184e72a","data":"0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675","condition":{"block":354221,"time":"2017-07-31T08:53:46.544Z"}}],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x1"
}

parity_defaultExtraData

Returns the default extra data

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_defaultExtraData","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0xd5830106008650617269747986312e31342e30826c69"
}

parity_extraData

Returns currently set extra data.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_extraData","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0xd5830106008650617269747986312e31342e30826c69"
}

parity_gasCeilTarget

Returns current target for gas ceiling.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_gasCeilTarget","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x5fdfb0" // 6283184
}

parity_gasFloorTarget

Returns current target for gas floor.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_gasFloorTarget","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x47b760" // 4700000
}

parity_minGasPrice

Returns currently set minimal gas price

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_minGasPrice","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x29f507000" // 11262783488
}

parity_transactionsLimit

Changes limit for transactions in queue.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_transactionsLimit","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_devLogs

Returns latest stdout logs of your node.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_devLogs","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    "2017-01-20 18:14:19  Updated conversion rate to Ξ1 = US$10.63 (11199212000 wei/gas)",
    "2017-01-20 18:14:19  Configured for DevelopmentChain using InstantSeal engine",
    "2017-01-20 18:14:19  Operating mode: active",
    "2017-01-20 18:14:19  State DB configuration: fast",
    "2017-01-20 18:14:19  Starting Parity/v1.7.0-unstable-2ae8b4c-20170120/x86_64-linux-gnu/rustc1.14.0"
  ]
}

parity_devLogsLevels

Returns current logging level settings. Logging level can be set with --logging and be one of: "" (default), "info", "debug", "warn", "error", "trace".

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_devLogsLevels","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_chain

Returns the name of the connected chain.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_chain","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_chainId

Returns the EIP155 chain ID used for transaction signing at the current best block. Null is returned if not available.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_chainId","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x1"
}

parity_chainStatus

Returns the information on warp sync blocks

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_chainStatus","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "blockGap": undefined
  }
}

parity_gasPriceHistogram

Returns a snapshot of the historic gas prices.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_gasPriceHistogram","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "bucketBounds": [
      "0x4a817c800",
      "0x525433d01",
      "0x5a26eb202",
      "0x61f9a2703",
      "0x69cc59c04",
      "0x719f11105",
      "0x7971c8606",
      "0x81447fb07",
      "0x891737008",
      "0x90e9ee509",
      "0x98bca5a0a"
    ],
    "counts": [
      487,
      9,
      7,
      1,
      8,
      0,
      0,
      0,
      0,
      14
    ]
  }
}

parity_netChain

Returns the name of the connected chain. DEPRECATED use parity_chain instead.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_netChain","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_netPeers

Returns connected peers. Peers with non-empty protocols have completed handshake.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_netPeers","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "active": 0,
    "connected": 25,
    "max": 25,
    "peers": [{ ... }, { ... }, { ... }, ...]
  }
}

parity_netPort

Returns network port the node is listening on.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_netPort","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_nextNonce

Returns next available nonce for transaction from given account. Includes pending block and transaction queue.

Parameters

  1. Address - Account
params: ["0x00A289B43e1e4825DbEDF2a78ba60a640634DC40"]

Returns

Example

Request

curl --data '{"method":"parity_nextNonce","params":["0x00A289B43e1e4825DbEDF2a78ba60a640634DC40"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0xc" // 12
}

parity_pendingTransactions

Returns a list of transactions currently in the queue.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_pendingTransactions","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "blockHash": null,
      "blockNumber": null,
      "creates": null,
      "from": "0xee3ea02840129123d5397f91be0391283a25bc7d",
      "gas": "0x23b58",
      "gasPrice": "0xba43b7400",
      "hash": "0x160b3c30ab1cf5871083f97ee1cee3901cfba3b0a2258eb337dd20a7e816b36e",
      "input": "0x095ea7b3000000000000000000000000bf4ed7b27f1d666546e30d74d50d173d20bca75400000000000000000000000000002643c948210b4bd99244ccd64d5555555555",
      "condition": {
        "block": 1
      },
      "networkId": 1,
      "nonce": "0x5",
      "publicKey": "0x96157302dade55a1178581333e57d60ffe6fdf5a99607890456a578b4e6b60e335037d61ed58aa4180f9fd747dc50d44a7924aa026acbfb988b5062b629d6c36",
      "r": "0x92e8beb19af2bad0511d516a86e77fa73004c0811b2173657a55797bdf8558e1",
      "raw": "0xf8aa05850ba43b740083023b5894bb9bc244d798123fde783fcc1c72d3bb8c18941380b844095ea7b3000000000000000000000000bf4ed7b27f1d666546e30d74d50d173d20bca75400000000000000000000000000002643c948210b4bd99244ccd64d555555555526a092e8beb19af2bad0511d516a86e77fa73004c0811b2173657a55797bdf8558e1a062b4d4d125bbcb9c162453bc36ca156537543bb4414d59d1805d37fb63b351b8",
      "s": "0x62b4d4d125bbcb9c162453bc36ca156537543bb4414d59d1805d37fb63b351b8",
      "standardV": "0x1",
      "to": "0xbb9bc244d798123fde783fcc1c72d3bb8c189413",
      "transactionIndex": null,
      "v": "0x26",
      "value": "0x0"
    },
    { ... },
    { ... }
  ]
}

parity_pendingTransactionsStats

Returns propagation stats for transactions in the queue.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_pendingTransactionsStats","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "0xdff37270050bcfba242116c745885ce2656094b2d3a0f855649b4a0ee9b5d15a": {
      "firstSeen": 3032066,
      "propagatedTo": {
        "0x605e04a43b1156966b3a3b66b980c87b7f18522f7f712035f84576016be909a2798a438b2b17b1a8c58db314d88539a77419ca4be36148c086900fba487c9d39": 1,
        "0xbab827781c852ecf52e7c8bf89b806756329f8cbf8d3d011e744a0bc5e3a0b0e1095257af854f3a8415ebe71af11b0c537f8ba797b25972f519e75339d6d1864": 1
      }
    }
  }
}

parity_registryAddress

The address for the global registry.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_registryAddress","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "0x3bb2bb5c6c9c9b7f4ef430b47dc7e026310042ea"
}

parity_removeTransaction

Removes transaction from local transaction pool. Scheduled transactions and not-propagated transactions are safe to remove, removal of other transactions may have no effect though.

Parameters

  1. Hash - Hash of transaction to remove.
params: ["0x2547ea3382099c7c76d33dd468063b32d41016aacb02cbd51ebc14ff5d2b6a43"]

Returns

Example

Request

curl --data '{"method":"parity_removeTransaction","params":["0x2547ea3382099c7c76d33dd468063b32d41016aacb02cbd51ebc14ff5d2b6a43"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [
    {
      "blockHash": null,
      "blockNumber": null,
      "creates": null,
      "from": "0xee3ea02840129123d5397f91be0391283a25bc7d",
      "gas": "0x23b58",
      "gasPrice": "0xba43b7400",
      "hash": "0x160b3c30ab1cf5871083f97ee1cee3901cfba3b0a2258eb337dd20a7e816b36e",
      "input": "0x095ea7b3000000000000000000000000bf4ed7b27f1d666546e30d74d50d173d20bca75400000000000000000000000000002643c948210b4bd99244ccd64d5555555555",
      "condition": {
        "block": 1
      },
      "networkId": 1,
      "nonce": "0x5",
      "publicKey": "0x96157302dade55a1178581333e57d60ffe6fdf5a99607890456a578b4e6b60e335037d61ed58aa4180f9fd747dc50d44a7924aa026acbfb988b5062b629d6c36",
      "r": "0x92e8beb19af2bad0511d516a86e77fa73004c0811b2173657a55797bdf8558e1",
      "raw": "0xf8aa05850ba43b740083023b5894bb9bc244d798123fde783fcc1c72d3bb8c18941380b844095ea7b3000000000000000000000000bf4ed7b27f1d666546e30d74d50d173d20bca75400000000000000000000000000002643c948210b4bd99244ccd64d555555555526a092e8beb19af2bad0511d516a86e77fa73004c0811b2173657a55797bdf8558e1a062b4d4d125bbcb9c162453bc36ca156537543bb4414d59d1805d37fb63b351b8",
      "s": "0x62b4d4d125bbcb9c162453bc36ca156537543bb4414d59d1805d37fb63b351b8",
      "standardV": "0x1",
      "to": "0xbb9bc244d798123fde783fcc1c72d3bb8c189413",
      "transactionIndex": null,
      "v": "0x26",
      "value": "0x0"
    },
    { ... },
    { ... }
  ]
}

parity_rpcSettings

Provides current JSON-RPC API settings.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_rpcSettings","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "enabled": true,
    "interface": "local",
    "port": 8545
  }
}

parity_unsignedTransactionsCount

Returns number of unsigned transactions when running with Trusted Signer. Error otherwise

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_unsignedTransactionsCount","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_dappsUrl

Returns the hostname and the port of dapps/rpc server, error if not enabled.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_dappsUrl","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "localhost:8545"
}

parity_enode

Returns the node enode URI.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_enode","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "enode://050929adcfe47dbe0b002cb7ef2bf91ca74f77c4e0f68730e39e717f1ce389085[email protected]172.17.0.1:30303"
}

parity_mode

Get the mode. Results one of: "active", "passive", "dark", "offline".

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_mode","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_nodeKind

Returns the node type availability and capability

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_nodeKind","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": {
    "availability": "personal",
    "capability": "light"
  }
}

parity_nodeName

Returns node name, set when starting parity with --identity NAME.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_nodeName","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_wsUrl

Returns the hostname and the port of WebSockets/Signer server, error if not enabled.

Parameters

None

Returns

Example

Request

curl --data '{"method":"parity_wsUrl","params":[],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": "localhost:8546"
}