The `parity_set` Module - Wiki Parity Tech Documentation

JSON-RPC methods

JSON-RPC API Reference

parity_acceptNonReservedPeers

Set Parity to accept non-reserved peers (default behavior).

Parameters

None

Returns

Example

Request

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

Response

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

parity_addReservedPeer

Add a reserved peer.

Parameters

  1. String - Enode address
params: ["enode://a979fb575495b8d6db44f750317d0f4622bf4c2aa3365d6af7c284339968eef29[email protected]22.99.55.44:7770"]

Returns

Example

Request

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

Response

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

parity_dappsList

Returns a list of available local dapps.

Parameters

None

Returns

Example

Request

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

Response

{
  "id": 1,
  "jsonrpc": "2.0",
  "result": [{
    "author": "Parity Technologies Ltd",
    "description": "A skeleton dapp",
    "iconUrl": "title.png",
    "id": "skeleton",
    "name": "Skeleton",
    "version": "0.1"
  }]
}

parity_dropNonReservedPeers

Set Parity to drop all non-reserved peers. To restore default behavior call parity_acceptNonReservedPeers.

Parameters

None

Returns

Example

Request

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

Response

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

parity_executeUpgrade

Attempts to upgrade Parity to the version specified in parity_upgradeReady.

Parameters

None

Returns

Example

Request

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

Response

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

parity_hashContent

Creates a hash of a file at a given URL.

Parameters

  1. String - The url of the content.
params: ["https://raw.githubusercontent.com/paritytech/parity-ethereum/master/README.md"]

Returns

Example

Request

curl --data '{"method":"parity_hashContent","params":["https://raw.githubusercontent.com/paritytech/parity-ethereum/master/README.md"],"id":1,"jsonrpc":"2.0"}' -H "Content-Type: application/json" -X POST localhost:8545

Response

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

parity_removeReservedPeer

Remove a reserved peer.

Parameters

  1. String - Encode address
params: ["enode://a979fb575495b8d6db44f750317d0f4622bf4c2aa3365d6af7c284339968eef29[email protected]22.99.55.44:7770"]

Returns

Example

Request

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

Response

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

parity_setAuthor

Changes author (coinbase) for mined blocks.

Parameters

  1. Address - 20 Bytes - Address
params: ["0x407d73d8a49eeb85d32cf465507dd71d507100c1"]

Returns

Example

Request

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

Response

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

parity_setChain

Sets the network spec file Parity is using.

Parameters

  1. String - Chain spec name, one of: “foundation”, “ropsten”, “morden”, “kovan”, “olympic”, “classic”, “dev”, “expanse” or a filename.
params: ["foundation"]

Returns

Example

Request

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

Response

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

parity_setEngineSigner

Sets an authority account for signing consensus messages. For more information check the Proof of Authority Chains page.

Parameters

  1. Address - Identifier of a valid authority account.
  2. String - Passphrase to unlock the account.
params: [
  "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
  "hunter2"
]

Returns

Example

Request

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

Response

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

parity_setExtraData

Changes extra data for newly mined blocks

Parameters

  1. Data - Extra Data
params: ["0x"]

Returns

Example

Request

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

Response

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

parity_setGasCeilTarget

Sets new gas ceiling target for mined blocks.

Parameters

  1. Quantity - (default: 0x0) Gas ceiling target.
params: [
  "0x2540be400" // 10000000000
]

Returns

Example

Request

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

Response

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

parity_setGasFloorTarget

Sets a new gas floor target for mined blocks..

Parameters

  1. Quantity - (default: 0x0) Gas floor target.
params: [
  "0x3e8" // 1000
]

Returns

Example

Request

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

Response

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

parity_setMaxTransactionGas

Sets the maximum amount of gas a single transaction may consume.

Parameters

  1. Quantity - Gas amount
params: [
  "0x186a0" // 100000
]

Returns

Example

Request

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

Response

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

parity_setMinGasPrice

Changes minimal gas price for transaction to be accepted to the queue.

Parameters

  1. Quantity - Minimal gas price
params: [
  "0x3e8" // 1000
]

Returns

Example

Request

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

Response

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

parity_setMode

Changes the operating mode of Parity.

Parameters

  1. String - The mode to set, one of:
    • "active" - Parity continuously syncs the chain.
    • "passive" - Parity syncs initially, then sleeps and wakes regularly to resync.
    • "dark" - Parity syncs only when the RPC is active.
    • "offline" - Parity doesn’t sync.
params: ["passive"]

Returns

Example

Request

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

Response

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

parity_setTransactionsLimit

Changes limit for transactions in queue.

Parameters

  1. Quantity - New Limit
params: [
  "0x3e8" // 1000
]

Returns

Example

Request

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

Response

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

parity_upgradeReady

Returns a ReleaseInfo object describing the release which is available for upgrade or null if none is available.

Parameters

None

Returns

Example

Request

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

Response

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