@parity/jsonrpc
Version:
JSON and JS interface defintions for RPC
1,339 lines • 93.2 kB
JSON
{
"methods": [
{
"name": "db_getHex",
"desc": "Returns binary data from the local database. (Deprecated and not supported, to be removed in a future version)",
"params": [
"String - Database name",
"String - Key name"
],
"returns": "Data - The previously stored data",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "db_getString",
"desc": "Returns string from the local database. (Deprecated and not supported, to be removed in a future version)",
"params": [
"String - Database name",
"String - Key name"
],
"returns": "String - The previously stored string",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "db_putHex",
"desc": "Stores binary data in the local database. (Deprecated and not supported, to be removed in a future version)",
"params": [
"String - Database name",
"String - Key name",
"Data - The data to store"
],
"returns": "Boolean - `true` if the value was stored, otherwise `false`",
"inputFormatters": [
null,
null,
null
],
"outputFormatter": null
},
{
"name": "db_putString",
"desc": "Stores a string in the local database. (Deprecated and not supported, to be removed in a future version)",
"params": [
"String - Database name",
"String - Key name",
"String - The string to store"
],
"returns": "Boolean - `true` if the value was stored, otherwise `false`",
"inputFormatters": [
null,
null,
null
],
"outputFormatter": null
},
{
"name": "eth_accounts",
"desc": "Returns a list of addresses owned by client.",
"params": [],
"returns": "Array - 20 Bytes - addresses owned by the client.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_blockNumber",
"desc": "Returns the number of most recent block.",
"params": [],
"returns": "Quantity - integer of the current block number the client is on.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_call",
"desc": "Executes a new message call immediately without creating a transaction on the block chain.",
"params": [
"CallRequest - The transaction call object.",
"BlockNumber - (optional) Integer block number, or the string `'latest'`, `'earliest'` or `'pending'`, see the [default block parameter](#the-default-block-parameter)."
],
"returns": "Data - the return value of executed contract.",
"inputFormatters": [
"inputCallFormatter",
"inputDefaultBlockNumberFormatter"
],
"outputFormatter": null
},
{
"name": "eth_coinbase",
"desc": "Returns the client coinbase address.",
"params": [],
"returns": "Address - The current coinbase address.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_estimateGas",
"desc": "Makes a call or transaction, which won't be added to the blockchain and returns the used gas, which can be used for estimating the used gas.",
"params": [
"CallRequest - Same as [eth_call](#eth_call) parameters, except that all properties are optional.",
"BlockNumber - (optional) Integer block number, or the string `'latest'`, `'earliest'` or `'pending'`, see the [default block parameter](#the-default-block-parameter)."
],
"returns": "Quantity - The amount of gas used.",
"inputFormatters": [
"inputCallFormatter",
"inputDefaultBlockNumberFormatter"
],
"outputFormatter": "utils.toDecimal"
},
{
"name": "eth_fetchQueuedTransactions",
"desc": "?",
"params": [
"?"
],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_flush",
"desc": "?",
"params": [],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_gasPrice",
"desc": "Returns the current price per gas in wei.",
"params": [],
"returns": "Quantity - integer of the current gas price in wei.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_getBalance",
"desc": "Returns the balance of the account of given address.",
"params": [
"Address - 20 Bytes - address to check for balance.",
"BlockNumber - (optional) integer block number, or the string `'latest'`, `'earliest'` or `'pending'`, see the [default block parameter](#the-default-block-parameter)."
],
"returns": "Quantity - integer of the current balance in wei.",
"inputFormatters": [
"inputAddressFormatter",
"inputDefaultBlockNumberFormatter"
],
"outputFormatter": "outputBigNumberFormatter"
},
{
"name": "eth_getBlockByHash",
"desc": "Returns information about a block by hash.",
"params": [
"Hash - Hash of a block.",
"Boolean - If `true` it returns the full transaction objects, if `false` only the hashes of the transactions."
],
"returns": {
"desc": "Object - A block object, or `null` when no block was found.",
"details": {
"difficulty": "Quantity - integer of the difficulty for this block",
"extraData": "Data - the 'extra data' field of this block",
"gasLimit": "Quantity - the maximum gas allowed in this block",
"gasUsed": "Quantity - the total used gas by all transactions in this block",
"hash": "Hash - 32 Bytes - hash of the block. `null` when its pending block",
"logsBloom": "Data - 256 Bytes - the bloom filter for the logs of the block. `null` when its pending block",
"miner": "Address - 20 Bytes - the address of the beneficiary to whom the mining rewards were given",
"nonce": "Data - 8 Bytes - hash of the generated proof-of-work. `null` when its pending block",
"number": "Quantity - The block number. `null` when its pending block",
"parentHash": "Hash - 32 Bytes - hash of the parent block",
"receiptsRoot": "Data - 32 Bytes - the root of the receipts trie of the block",
"sha3Uncles": "Data - 32 Bytes - SHA3 of the uncles data in the block",
"size": "Quantity - integer the size of this block in bytes",
"stateRoot": "Data - 32 Bytes - the root of the final state trie of the block",
"timestamp": "Quantity - the unix timestamp for when the block was collated",
"totalDifficulty": "Quantity - integer of the total difficulty of the chain until this block",
"transactions": "Array - Array of transaction objects, or 32 Bytes transaction hashes depending on the last given parameter",
"transactionsRoot": "Data - 32 Bytes - the root of the transaction trie of the block",
"uncles": "Array - Array of uncle hashes"
}
},
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "eth_getBlockByNumber",
"desc": "Returns information about a block by block number.",
"params": [
"BlockNumber - integer of a block number, or the string `'earliest'`, `'latest'` or `'pending'`, as in the [default block parameter](#the-default-block-parameter).",
"Boolean - If `true` it returns the full transaction objects, if `false` only the hashes of the transactions."
],
"returns": "See [eth_getBlockByHash](#eth_getblockbyhash)",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "eth_getBlockTransactionCountByHash",
"desc": "Returns the number of transactions in a block from a block matching the given block hash.",
"params": [
"Hash - 32 Bytes - hash of a block."
],
"returns": "Quantity - integer of the number of transactions in this block.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_getBlockTransactionCountByNumber",
"desc": "Returns the number of transactions in a block from a block matching the given block number.",
"params": [
"BlockNumber - integer of a block number, or the string `'earliest'`, `'latest'` or `'pending'`, as in the [default block parameter](#the-default-block-parameter)."
],
"returns": "Quantity - integer of the number of transactions in this block.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_getCode",
"desc": "Returns code at a given address.",
"params": [
"Address - 20 Bytes - address.",
"BlockNumber - integer block number, or the string `'latest'`, `'earliest'` or `'pending'`, see the [default block parameter](#the-default-block-parameter)."
],
"returns": "Data - the code from the given address.",
"inputFormatters": [
"inputAddressFormatter",
"inputDefaultBlockNumberFormatter"
],
"outputFormatter": null
},
{
"name": "eth_getFilterChanges",
"desc": "Polling method for a filter, which returns an array of logs which occurred since last poll.",
"params": [
"Quantity - The filter id."
],
"returns": "Array - Array of log objects, or an empty array if nothing has changed since last poll.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_getFilterChangesEx",
"desc": "?",
"params": [
"?"
],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_getFilterLogs",
"desc": "Returns an array of all logs matching filter with given id.",
"params": [
"Quantity - The filter id."
],
"returns": "See [eth_getFilterChanges](#eth_getfilterchanges)",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_getFilterLogsEx",
"desc": "?",
"params": [
"?"
],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_getLogs",
"desc": "Returns an array of all logs matching a given filter object.",
"params": [
"Object - The filter object, see [eth_newFilter parameters](#eth_newfilter)."
],
"returns": "See [eth_getFilterChanges](#eth_getfilterchanges)",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_getLogsEx",
"desc": "?",
"params": [
"?"
],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_getStorageAt",
"desc": "Returns the value from a storage position at a given address.",
"params": [
"Address - 20 Bytes - address of the storage.",
"Quantity - integer of the position in the storage.",
"BlockNumber - (optional) integer block number, or the string `'latest'`, `'earliest'` or `'pending'`, see the [default block parameter](#the-default-block-parameter)."
],
"returns": "Data - the value at this storage position.",
"inputFormatters": [
null,
"utils.toHex",
"inputDefaultBlockNumberFormatter"
],
"outputFormatter": null
},
{
"name": "eth_getTransactionByBlockHashAndIndex",
"desc": "Returns information about a transaction by block hash and transaction index position.",
"params": [
"Hash - hash of a block.",
"Quantity - integer of the transaction index position."
],
"returns": "See [eth_getBlockByHash](#eth_gettransactionbyhash)",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "eth_getTransactionByBlockNumberAndIndex",
"desc": "Returns information about a transaction by block number and transaction index position.",
"params": [
"BlockNumber - a block number, or the string `'earliest'`, `'latest'` or `'pending'`, as in the [default block parameter](#the-default-block-parameter).",
"Quantity - The transaction index position."
],
"returns": "See [eth_getBlockByHash](#eth_gettransactionbyhash)",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "eth_getTransactionByHash",
"desc": "Returns the information about a transaction requested by transaction hash.",
"params": [
"Hash - 32 Bytes - hash of a transaction."
],
"returns": {
"desc": "Object - A transaction object, or `null` when no transaction was found:",
"details": {
"blockHash": "Hash - 32 Bytes - hash of the block where this transaction was in. `null` when its pending.",
"blockNumber": "BlockNumber - block number where this transaction was in. `null` when its pending.",
"chainId": "Quantity - the chain id of the transaction, if any.",
"condition": "Object - (optional) conditional submission, Block number in `block` or timestamp in `time` or `null`. (parity-feature)",
"creates": "Hash - creates contract hash",
"from": "Address - 20 Bytes - address of the sender.",
"gas": "Quantity - gas provided by the sender.",
"gasPrice": "Quantity - gas price provided by the sender in Wei.",
"hash": "Hash - 32 Bytes - hash of the transaction.",
"input": "Data - the data send along with the transaction.",
"nonce": "Quantity - the number of transactions made by the sender prior to this one.",
"publicKey": "Hash - public key of the signer.",
"r": "Quantity - the R field of the signature.",
"raw": "Data - raw transaction data",
"standard_v": "Quantity - the standardised V field of the signature (0 or 1).",
"to": "Address - 20 Bytes - address of the receiver. `null` when its a contract creation transaction.",
"transactionIndex": "Quantity - integer of the transactions index position in the block. `null` when its pending.",
"v": "Quantity - the standardised V field of the signature.",
"value": "Quantity - value transferred in Wei."
}
},
"inputFormatters": [
null
],
"outputFormatter": "outputTransactionFormatter"
},
{
"name": "eth_getTransactionCount",
"desc": "Returns the number of transactions *sent* from an address.",
"params": [
"Address - 20 Bytes - address.",
"BlockNumber - (optional) integer block number, or the string `'latest'`, `'earliest'` or `'pending'`, see the [default block parameter](#the-default-block-parameter)."
],
"returns": "Quantity - integer of the number of transactions send from this address.",
"inputFormatters": [
null,
"inputDefaultBlockNumberFormatter"
],
"outputFormatter": "utils.toDecimal"
},
{
"name": "eth_getTransactionReceipt",
"desc": "Returns the receipt of a transaction by transaction hash.\n\n**Note** That the receipt is available even for pending transactions.",
"params": [
"Hash - hash of a transaction."
],
"returns": {
"desc": "Object - A transaction receipt object, or `null` when no receipt was found:",
"details": {
"blockHash": "Hash - 32 Bytes - hash of the block where this transaction was in.",
"blockNumber": "BlockNumber - block number where this transaction was in.",
"contractAddress": "Address - 20 Bytes - The contract address created, if the transaction was a contract creation, otherwise `null`.",
"cumulativeGasUsed": "Quantity - The total amount of gas used when this transaction was executed in the block.",
"gasUsed": "Quantity - The amount of gas used by this specific transaction alone.",
"logs": "Array - Array of log objects, which this transaction generated.",
"transactionHash": "Hash - 32 Bytes - hash of the transaction.",
"transactionIndex": "Quantity - integer of the transactions index position in the block."
}
},
"inputFormatters": [
null
],
"outputFormatter": "outputTransactionReceiptFormatter"
},
{
"name": "eth_getUncleByBlockHashAndIndex",
"desc": "Returns information about a uncle of a block by hash and uncle index position.\n\n**Note:** An uncle doesn't contain individual transactions.",
"params": [
"Hash - Hash of a block.",
"Quantity - The uncle's index position."
],
"returns": "See [eth_getBlockByHash](#eth_getblockbyhash)",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "eth_getUncleByBlockNumberAndIndex",
"desc": "Returns information about a uncle of a block by number and uncle index position.\n\n**Note:** An uncle doesn't contain individual transactions.",
"params": [
"BlockNumber - a block number, or the string `'earliest'`, `'latest'` or `'pending'`, as in the [default block parameter](#the-default-block-parameter).",
"Quantity - The uncle's index position."
],
"returns": "See [eth_getBlockByHash](#eth_getblockbyhash)",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "eth_getUncleCountByBlockHash",
"desc": "Returns the number of uncles in a block from a block matching the given block hash.",
"params": [
"Hash - 32 Bytes - hash of a block."
],
"returns": "Quantity - integer of the number of uncles in this block.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_getUncleCountByBlockNumber",
"desc": "Returns the number of uncles in a block from a block matching the given block number.",
"params": [
"BlockNumber - integer of a block number, or the string 'latest', 'earliest' or 'pending', see the [default block parameter](#the-default-block-parameter)."
],
"returns": "Quantity - integer of the number of uncles in this block.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_getWork",
"desc": "Returns the hash of the current block, the seedHash, and the boundary condition to be met (\"target\").",
"params": [],
"returns": "Array - Array with the following properties:\n - `Data`, 32 Bytes - current block header pow-hash.\n - `Data`, 32 Bytes - the seed hash used for the DAG.\n - `Data`, 32 Bytes - the boundary condition (\"target\"), 2^256 / difficulty.\n - `Quantity`, the current block number.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_hashrate",
"desc": "Returns the number of hashes per second that the node is mining with.",
"params": [],
"returns": "Quantity - number of hashes per second.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_inspectTransaction",
"desc": "?",
"params": [
"?"
],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_mining",
"desc": "Returns `true` if client is actively mining new blocks.",
"params": [],
"returns": "Boolean - `true` of the client is mining, otherwise `false`.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_newBlockFilter",
"desc": "Creates a filter in the node, to notify when a new block arrives.\nTo check if the state has changed, call [eth_getFilterChanges](#eth_getfilterchanges).",
"params": [],
"returns": "Quantity - A filter id.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_newFilter",
"desc": "Creates a filter object, based on filter options, to notify when the state changes (logs).\nTo check if the state has changed, call [eth_getFilterChanges](#eth_getfilterchanges).\n\n##### A note on specifying topic filters:\nTopics are order-dependent. A transaction with a log with topics [A, B] will be matched by the following topic filters:\n* `[]` \"anything\"\n* `[A]` \"A in first position (and anything after)\"\n* `[null, B]` \"anything in first position AND B in second position (and anything after)\"\n* `[A, B]` \"A in first position AND B in second position (and anything after)\"\n* `[[A, B], [A, B]]` \"(A OR B) in first position AND (A OR B) in second position (and anything after)\"",
"params": [
{
"desc": "Object - The filter options:",
"details": {
"address": "Address - (optional) 20 Bytes - Contract address or a list of addresses from which logs should originate.",
"fromBlock": "BlockNumber - (optional) (default: latest) Integer block number, or `'latest'` for the last mined block or `'pending'`, `'earliest'` for not yet mined transactions.",
"limit": "Quantity - (optional) The maximum number of entries to retrieve (latest first).",
"toBlock": "BlockNumber - (optional) (default: latest) Integer block number, or `'latest'` for the last mined block or `'pending'`, `'earliest'` for not yet mined transactions.",
"topics": "Array - (optional) Array of 32 Bytes `Data` topics. Topics are order-dependent. It's possible to pass in `null` to match any topic, or a subarray of multiple topics of which one should be matching."
}
}
],
"returns": "Quantity - The filter id.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_newFilterEx",
"desc": "?",
"params": [
"?"
],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_newPendingTransactionFilter",
"desc": "Creates a filter in the node, to notify when new pending transactions arrive.\n\nTo check if the state has changed, call [eth_getFilterChanges](#eth_getfilterchanges).",
"params": [],
"returns": "Quantity - A filter id.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_notePassword",
"desc": "?",
"params": [
"?"
],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_pendingTransactions",
"desc": "?",
"params": [],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_protocolVersion",
"desc": "Returns the current ethereum protocol version.",
"params": [],
"returns": "String - The current ethereum protocol version.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "eth_register",
"desc": "?",
"params": [
"?"
],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_sendRawTransaction",
"desc": "Creates new message call transaction or a contract creation for signed transactions.\n\n**Note:** `eth_submitTransaction` is an alias of this method.",
"params": [
"Data - The signed transaction data."
],
"returns": "Hash - 32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available\n\nUse [eth_getTransactionReceipt](#eth_gettransactionreceipt) to get the contract address, after the transaction was mined, when you created a contract.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_sendTransaction",
"desc": "Creates new message call transaction or a contract creation, if the data field contains code.",
"params": [
"TransactionRequest - The transaction object."
],
"returns": "Hash - 32 Bytes - the transaction hash, or the zero hash if the transaction is not yet available.\n\nUse [eth_getTransactionReceipt](#eth_gettransactionreceipt) to get the contract address, after the transaction was mined, when you created a contract.",
"inputFormatters": [
"inputTransactionFormatter"
],
"outputFormatter": null
},
{
"name": "eth_sign",
"desc": "The sign method calculates an Ethereum specific signature with: `sign(keccak256(\"\u0019Ethereum Signed Message:\n\" + len(message) + message)))`.",
"params": [
"Address - 20 Bytes - address.",
"Data - Data which hash to sign."
],
"returns": "Data - Signed data.",
"inputFormatters": [
"inputAddressFormatter",
null
],
"outputFormatter": null
},
{
"name": "eth_signTransaction",
"desc": "Signs transactions without dispatching it to the network. It can be later submitted using [eth_sendRawTransaction](#eth_sendrawtransaction).",
"params": [
"TransactionRequest - Transaction object, see [eth_sendTransaction](#eth_sendTransaction)."
],
"returns": {
"desc": "Object - Signed transaction and it's details:",
"details": {
"raw": "Data - The signed, RLP encoded transaction.",
"tx": {
"desc": "Object - Transaction object:",
"details": {
"blockHash": "Hash - 32 Bytes - hash of the block where this transaction was in. `null` when its pending.",
"blockNumber": "BlockNumber - block number where this transaction was in. `null` when its pending.",
"chainId": "Quantity - the chain id of the transaction, if any.",
"condition": "Object - (optional) conditional submission, Block number in `block` or timestamp in `time` or `null`. (parity-feature)",
"creates": "Hash - creates contract hash",
"from": "Address - 20 Bytes - address of the sender.",
"gas": "Quantity - gas provided by the sender.",
"gasPrice": "Quantity - gas price provided by the sender in Wei.",
"hash": "Hash - 32 Bytes - hash of the transaction.",
"input": "Data - the data send along with the transaction.",
"nonce": "Quantity - the number of transactions made by the sender prior to this one.",
"publicKey": "Hash - public key of the signer.",
"r": "Quantity - the R field of the signature.",
"raw": "Data - raw transaction data",
"standard_v": "Quantity - the standardised V field of the signature (0 or 1).",
"to": "Address - 20 Bytes - address of the receiver. `null` when its a contract creation transaction.",
"transactionIndex": "Quantity - integer of the transactions index position in the block. `null` when its pending.",
"v": "Quantity - the standardised V field of the signature.",
"value": "Quantity - value transferred in Wei."
}
}
}
},
"inputFormatters": [
"inputCallFormatter"
],
"outputFormatter": null
},
{
"name": "eth_submitHashrate",
"desc": "Used for submitting mining hashrate.",
"params": [
"Data - a hexadecimal string representation (32 bytes) of the hash rate.",
"Data - A random hexadecimal(32 bytes) ID identifying the client."
],
"returns": "Boolean - `true` if submitting went through succesfully and `false` otherwise.",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "eth_submitWork",
"desc": "Used for submitting a proof-of-work solution.",
"params": [
"Data - 8 Bytes - The nonce found (64 bits).",
"Data - 32 Bytes - The header's pow-hash (256 bits)",
"Data - 32 Bytes - The mix digest (256 bits)."
],
"returns": "Boolean - `true` if the provided solution is valid, otherwise `false`.",
"inputFormatters": [
null,
null,
null
],
"outputFormatter": null
},
{
"name": "eth_subscribe",
"desc": "\n Starts a subscription (on WebSockets / IPC / TCP transports) to a particular event. For every event that\n matches the subscription a JSON-RPC notification with event details and subscription ID will be sent to a client.\n\n An example notification received by subscribing to `newHeads` event:\n ```\n {\"jsonrpc\":\"2.0\",\"method\":\"eth_subscription\",\"params\":{\"subscription\":\"0x416d77337e24399d\",\"result\":{\"difficulty\":\"0xd9263f42a87\",<...>,\n \"uncles\":[]}}}\n ```\n\n You can unsubscribe using `eth_unsubscribe` RPC method. Subscriptions are also tied to a transport\n connection, disconnecting causes all subscriptions to be canceled.\n ",
"params": [
"String - Subscription type: one of `newHeads`, `logs`",
"Object - \n Subscription type-specific parameters. It must be left empty for\n `newHeads` and must contain filter object for `logs`.\n "
],
"returns": "String - Assigned subscription ID",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "eth_syncing",
"desc": "Returns an object with data about the sync status or `false`.",
"params": [],
"returns": {
"desc": "Object - An object with sync status data or `FALSE`, when not syncing.",
"details": {
"blockGap": "Array - Array of \"first\", \"last\", such that [first, last) are all missing from the chain",
"currentBlock": "Quantity - The current block, same as eth_blockNumber",
"highestBlock": "Quantity - The estimated highest block",
"startingBlock": "Quantity - The block at which the import started (will only be reset, after the sync reached this head)",
"warpChunksAmount": "Quantity - Total amount of snapshot chunks",
"warpChunksProcessed": "Quantity - Total amount of snapshot chunks processed"
}
},
"inputFormatters": [],
"outputFormatter": "outputSyncingFormatter"
},
{
"name": "eth_uninstallFilter",
"desc": "Uninstalls a filter with given id. Should always be called when watch is no longer needed.\nAdditonally Filters timeout when they aren't requested with [eth_getFilterChanges](#eth_getfilterchanges) for a period of time.",
"params": [
"Quantity - The filter id."
],
"returns": "Boolean - `true` if the filter was successfully uninstalled, otherwise `false`.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_unregister",
"desc": "?",
"params": [
"?"
],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "eth_unsubscribe",
"desc": "Unsubscribes from a subscription.",
"params": [
"String - Subscription ID"
],
"returns": "Boolean - whether the call was successful",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "net_listening",
"desc": "Returns `true` if client is actively listening for network connections.",
"params": [],
"returns": "Boolean - `true` when listening, otherwise `false`.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "net_peerCount",
"desc": "Returns number of peers currenly connected to the client.",
"params": [],
"returns": "Quantity - Integer of the number of connected peers",
"inputFormatters": [],
"outputFormatter": "utils.toDecimal"
},
{
"name": "net_version",
"desc": "Returns the current network protocol version.",
"params": [],
"returns": "String - The current network protocol version",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_acceptNonReservedPeers",
"desc": "Set Parity to accept non-reserved peers (default behavior).",
"params": [],
"returns": "Boolean - `true` if successful.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_accountsInfo",
"desc": "Provides metadata for accounts.",
"params": [],
"returns": {
"desc": "Object - Maps account address to metadata.",
"details": {
"name": "String - Account name"
}
},
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_addReservedPeer",
"desc": "Add a reserved peer.",
"params": [
"String - Enode address"
],
"returns": "Boolean - `true` if successful.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "parity_allAccountsInfo",
"desc": "returns a map of accounts as an object.",
"params": [],
"returns": "Array - Account metadata.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_chain",
"desc": "Returns the name of the connected chain. ",
"params": [],
"returns": "String - chain name, one of: \"foundation\", \"kovan\", &c. of a filename.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_chainId",
"desc": "Returns the current chain ID used for tranaction signing.",
"params": [],
"returns": "Quantity - The current blockchain chain ID",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_chainStatus",
"desc": "Returns the information on warp sync blocks",
"params": [],
"returns": {
"desc": "Object - The status object",
"details": {
"blockGap": "Array - (optional) Describes the gap in the blockchain, if there is one: (first, last)"
}
},
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_changePassword",
"desc": "Change the password for a given account.",
"params": [
"Address - Address of the account.",
"String - Old password.",
"String - New password."
],
"returns": "Boolean - `true` if the call was successful.",
"inputFormatters": [
null,
null,
null
],
"outputFormatter": null
},
{
"name": "parity_changeVault",
"desc": "Changes the current valut for the account",
"params": [
"Address - Account address",
"String - Vault name"
],
"returns": "Boolean - True on success",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "parity_changeVaultPassword",
"desc": "Changes the password for any given vault",
"params": [
"String - Vault name",
"String - New Password"
],
"returns": "Boolean - True on success",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "parity_checkRequest",
"desc": "Get the the transaction hash of the request previously posted to [`parity_postTransaction`](#parity_posttransaction) or [`parity_postSign`](#parity_postsign). Will return a JSON-RPC error if the request was rejected.",
"params": [
"Quantity - The id of the request sent to the signer."
],
"returns": "Hash - 32 Bytes - the transaction hash or `null` if the request hasn't been signed yet.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "parity_cidV0",
"desc": "Compute a v0 IPFS Content ID from protobuf encoded bytes.",
"params": [
"Data - to encode."
],
"returns": "String - Base58 encoded CID",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "parity_closeVault",
"desc": "Closes a vault with the given name",
"params": [
"String - Vault name"
],
"returns": "Boolean - True on success",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "parity_composeTransaction",
"desc": "Given partial transaction request produces transaction with all fields filled in. Such transaction can be then signed externally.",
"params": [
"TransactionRequest - see [`eth_sendTransaction`](JSONRPC-eth-module#eth_sendtransaction)."
],
"returns": "Object - Transaction object (same as the parameter) with missing optional fields filled in by defaults.",
"inputFormatters": [
"inputCallFormatter"
],
"outputFormatter": null
},
{
"name": "parity_consensusCapability",
"desc": "Returns information on current consensus capability.",
"params": [],
"returns": "Object - or `String` - Either `\"capable\"`, `{\"capableUntil\":N}`, `{\"incapableSince\":N}` or `\"unknown\"` (`N` is a block number).",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_dappsList",
"desc": "Returns a list of available local dapps.",
"params": [],
"returns": "Array - The list of dapps",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_dappsRefresh",
"desc": "Returns a boolean value upon success and error upon failure",
"params": [],
"returns": "Boolean - True for success. error details for failure",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_dappsUrl",
"desc": "Returns the hostname and the port of dapps/rpc server, error if not enabled.",
"params": [],
"returns": "String - The hostname and port number",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_decryptMessage",
"desc": "Decrypt a message encrypted with a ECIES public key.",
"params": [
"Address - Account which can decrypt the message.",
"Data - Encrypted message."
],
"returns": "Data - Decrypted message.",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "parity_defaultAccount",
"desc": "Returns the defaultAccount that is to be used with transactions",
"params": [],
"returns": "Address - The account address",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_defaultExtraData",
"desc": "Returns the default extra data",
"params": [],
"returns": "Data - Extra data",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_deriveAddressHash",
"desc": "Derive new address from given account address using specific hash.",
"params": [
"Address - Account address to derive from.",
"String - Password to the account.",
"Object - Derivation hash and type (`soft` or `hard`). E.g. `{ hash: \"0x123..123\", type: \"hard\" }`.",
"Boolean - Flag indicating if the account should be saved."
],
"returns": "Address - 20 Bytes new derived address.",
"inputFormatters": [
null,
null,
null,
null
],
"outputFormatter": null
},
{
"name": "parity_deriveAddressIndex",
"desc": "Derive new address from given account address using hierarchical derivation (sequence of 32-bit integer indices).",
"params": [
"Address - Account address to export.",
"String - Password to the account.",
"Array - Hierarchical derivation sequence of index and type (`soft` or `hard`). E.g. `[{index:1,type:\"hard\"},{index:2,type:\"soft\"}]`.",
"Boolean - Flag indicating if the account should be saved."
],
"returns": "Address - 20 Bytes new derived address.",
"inputFormatters": [
null,
null,
null,
null
],
"outputFormatter": null
},
{
"name": "parity_devLogs",
"desc": "Returns latest stdout logs of your node.",
"params": [],
"returns": "Array - Development logs",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_devLogsLevels",
"desc": "Returns current logging level settings. Logging level can be set with `--logging` and be one of: `\"\"` (default), `\"info\"`, `\"debug\"`, `\"warn\"`, `\"error\"`, `\"trace\"`.",
"params": [],
"returns": "String - undefined",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_dropNonReservedPeers",
"desc": "Set Parity to drop all non-reserved peers. To restore default behavior call [parity_acceptNonReservedPeers](#parity_acceptnonreservedpeers).",
"params": [],
"returns": "Boolean - `true` if successful.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_encryptMessage",
"desc": "Encrypt some data with a public key under ECIES.",
"params": [
"Hash - Public EC key generated with `secp256k1` curve, truncated to the last 64 bytes.",
"Data - The message to encrypt."
],
"returns": "Data - Encrypted message.",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "parity_enode",
"desc": "Returns the node enode URI.",
"params": [],
"returns": "String - Enode URI",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_executeUpgrade",
"desc": "Attempts to upgrade Parity to the version specified in [parity_upgradeReady](#parity_upgradeready).",
"params": [],
"returns": "Boolean - returns `true` if the upgrade to the new release was successfully executed, `false` if not.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_exportAccount",
"desc": "Returns a standard wallet file for given account if password matches.",
"params": [
"Address - Account address to export.",
"String - Password to the account."
],
"returns": "Object - Standard wallet JSON.",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "parity_extraData",
"desc": "Returns currently set extra data.",
"params": [],
"returns": "Data - Extra data.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_futureTransactions",
"desc": "Returns all future transactions from transaction queue.",
"params": [],
"returns": "Array - Transaction list.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_gasCeilTarget",
"desc": "Returns current target for gas ceiling.",
"params": [],
"returns": "Quantity - Gas ceiling target.",
"inputFormatters": [],
"outputFormatter": "outputBigNumberFormatter"
},
{
"name": "parity_gasFloorTarget",
"desc": "Returns current target for gas floor.",
"params": [],
"returns": "Quantity - Gas floor target.",
"inputFormatters": [],
"outputFormatter": "outputBigNumberFormatter"
},
{
"name": "parity_gasPriceHistogram",
"desc": "Returns a snapshot of the historic gas prices.",
"params": [],
"returns": {
"desc": "Object - Historic values",
"details": {
"bucketBounds": "Array - Array of bound values.",
"count": "Array - Array of counts."
}
},
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_generateSecretPhrase",
"desc": "Creates a secret phrase that can be associated with an account.",
"params": [],
"returns": "String - The secret phrase.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_getBlockHeaderByNumber",
"desc": "Get block header. Same as [`eth_getBlockByNumber`](JSONRPC-eth-module#eth_getblockbynumber) but without uncles and transactions.",
"params": [
"BlockNumber - integer of a block number, or the string `'earliest'`, `'latest'` or `'pending'`, as in the [default block parameter](#the-default-block-parameter)."
],
"returns": "Object - Block header",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "parity_getDappAddresses",
"desc": "Returns the list of accounts available to a specific dapp.",
"params": [
"String - Dapp Id."
],
"returns": "Array - The list of available accounts.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "parity_getDappDefaultAddress",
"desc": "Returns a default account available to a specific dapp.",
"params": [
"String - Dapp Id."
],
"returns": "Address - Default Address",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "parity_getNewDappsAddresses",
"desc": "Returns the list of accounts available to a new dapps.",
"params": [],
"returns": "Array - The list of available accounts, can be `null`.",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_getNewDappsDefaultAddress",
"desc": "Returns a default account available to dapps.",
"params": [],
"returns": "Address - Default Address",
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_getVaultMeta",
"desc": "Returns the metadata for a specific vault",
"params": [
"String - Vault name"
],
"returns": "String - The associated JSON metadata for this vault",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "parity_hardwareAccountsInfo",
"desc": "Provides metadata for attached hardware wallets",
"params": [],
"returns": {
"desc": "Object - Maps account address to metadata.",
"details": {
"manufacturer": "String - Manufacturer",
"name": "String - Account name"
}
},
"inputFormatters": [],
"outputFormatter": null
},
{
"name": "parity_hardwarePinMatrixAck",
"desc": "Send a pin to a hardware wallet at a specific path to unlock it",
"params": [
"String - path to the device",
"String - the pin as recieved from the pin matrix"
],
"returns": "Boolean - Whether or not the pin entry successfully unlocked the device",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "parity_hashContent",
"desc": "Creates a hash of a file at a given URL.",
"params": [
"String - The url of the content."
],
"returns": "Hash - The SHA-3 hash of the content.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "parity_importGethAccounts",
"desc": "Imports a list of accounts from Geth.",
"params": [
"Array - List of the Geth addresses to import."
],
"returns": "Array - Array of the imported addresses.",
"inputFormatters": [
null
],
"outputFormatter": null
},
{
"name": "parity_killAccount",
"desc": "Deletes an account.",
"params": [
"Address - The account to remove.",
"String - Account password."
],
"returns": "Boolean - `true` if the call was successful.",
"inputFormatters": [
null,
null
],
"outputFormatter": null
},
{
"name": "parity_listAccounts",
"desc": "Returns all addresses if Fat DB is enabled (`--fat-db`), `null` otherwise.",
"params": [
"Quantity - Integer number of addresses to display in a batch.",
"Address - 20 Bytes - Offset address from which the batch should start in order, or `null`.",
"BlockNumber - (optional) integer block number, or the string `'latest'`, `'earliest'` or `'pending'`."
],
"returns": "Array - Requested number of `Address`es or `null` if Fat DB is not enabled.",
"inputFormatters": [
null,
null,
"inputDefaultBlockNumberFormatter"
],
"outputFormatter": n