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
— alwaysnull
, indicating that the block has been successfully marked as precious.error
— an object containing an error message if an error occurred, otherwisenull
.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
preciousblock
RPC method yourself