POST
/
788f110831fe13808302bd79796d55e8
curl --request POST \
  --url https://nd-202-842-353.p2pify.com/788f110831fe13808302bd79796d55e8 \
  --header 'Content-Type: application/json' \
  --data '{
  "jsonrpc": "1.0",
  "method": "preciousblock",
  "params": "000000000000000000011cefb2db6b82b6ae69b4ec06eedc81fc85d16f97865d",
  "id": 1
}'
{
  "result": "<string>",
  "error": {},
  "id": 123
}

The preciousblock method allows a node to mark a specific block as “precious,” meaning the block is treated as if it were received earlier than other blocks with the same amount of work. This can influence the node’s choice of the active chain, potentially causing a reorganization to prefer the chain that includes the precious block.

Get you own node endpoint today

Start for free and get your app to production levels immediately. No credit card required.

You can sign up with your GitHub, X, Google, or Microsoft account.

Parameters

  • block hash (required): The hash of the block to be marked as precious.

Response

  • result — always null, indicating that the block has been successfully marked as precious.
  • error — an object containing an error message if an error occurred, otherwise null.
  • id — an integer representing the ID of the request.

Use case

The preciousblock method is useful in scenarios where a blockchain network participant wants to influence the chain selection process in favor of a particular branch that includes the specified block. This can be relevant in testing, or in situations where network conditions lead to competing chains.

Body

application/json
jsonrpc
string
default:1.0
method
string
default:preciousblock
params
string[]

The hash of the block to be treated as precious

Example:

"000000000000000000011cefb2db6b82b6ae69b4ec06eedc81fc85d16f97865d"

id
integer
default:1

Response

200 - application/json
Acknowledgement that the block has been marked as precious
result
string | null

The result is always null, indicating the request was processed. Actual type is 'null'.

error
object
id
integer