preciousblock | Bitcoin

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.

Try the preciousblock RPC method yourself

Language
Click Try It! to start a request and see the response here!