Skip to main content
£0.00 0

Basket

No products in the basket.

ASIC mining articles and advice

Bitcoin Core waitfornewblock RPC: New Tip Notification Guide

Bitcoin Core waitfornewblock RPC made simple. See what the feature does, where its limits sit and which checks node or wallet operators should make.

Bitcoin Core waitfornewblock RPC guide cover

This guide explains Bitcoin Core waitfornewblock RPC in plain English. It shows what the command does, what its result means and what it cannot prove.

TL;DR

  • What it is: Bitcoin Core 30.0 exposes waitfornewblock as a public RPC and adds an optional current_tip argument. The call waits for the active tip to differ from that supplied state, or for a timeout or node shutdown.
  • Why it matters: waitfornewblock is a low-overhead tip-change primitive, not a complete event system. Durability comes from checkpointing, explicit comparison, ancestry reconciliation and idempotent downstream processing.
  • Current position: Require a second reviewer and explicit rollback or expiry, and pause payments, signing or network-dependent services until post-change evidence is complete.

Bitcoin Core waitfornewblock RPC in simple English

Bitcoin Core waitfornewblock RPC: A new tip, timeout and node exit all return a hash and height. A response is not proof of change.

Simple example

A miner is checking Bitcoin Core waitfornewblock RPC. Persist the last fully processed tip, wait from that state, compare, fetch the path difference, apply idempotently and commit the new checkpoint only after downstream work succeeds.

Key terms in plain English

Bitcoin Core:
Widely used software that validates Bitcoin and can provide wallet, network and operator tools.
RPC:
A command that software sends to a node to request information or a local action.
Node:
A computer running Bitcoin software that checks data and communicates with other peers.

Baseline tip

Supply the last processed hash and height as current_tip where supported. This closes the race between reading the tip and beginning the blocking call.

Return paths

A new tip, timeout and node exit all return a hash and height. A response is not proof of change; compare it with the supplied baseline.

Extension or reorg

A higher height usually represents extension but is not enough proof. Query headers or chain ancestry to identify replacements, same-height changes and deeper reorganisations.

Bitcoin Core waitfornewblock RPC technical diagram
Extension or reorg: the fields, validation boundary and operational evidence that implementations need to agree.

Timeout design

The millisecond timeout defaults to zero. Choose bounded waits for health checks and cancellation, while ensuring client and reverse-proxy limits exceed the chosen server wait.

Processing loop

Persist the last fully processed tip, wait from that state, compare, fetch the path difference, apply idempotently and commit the new checkpoint only after downstream work succeeds.

Failure recovery

On transport failure or restart, query the active tip and reconcile from the durable checkpoint. Never assume a missed connection means no blocks arrived.

Scaling

One coordinated watcher can distribute internal events more safely than many unbounded RPC waiters. Add back-pressure, deduplication and observability for lag and reorg depth. Build a revision-pinned evidence pack on an isolated node, wallet or protocol harness.

Frequently asked questions

What is the main point of Bitcoin Core waitfornewblock RPC?

Bitcoin Core waitfornewblock RPC: A new tip, timeout and node exit all return a hash and height.

For Bitcoin Core waitfornewblock RPC, what should a beginner know about baseline tip?

Supply the last processed hash and height as current_tip where supported. This closes the race between reading the tip and beginning the blocking call.

For Bitcoin Core waitfornewblock RPC, what should a beginner know about return paths?

A new tip, timeout and node exit all return a hash and height.

For Bitcoin Core waitfornewblock RPC, what should a beginner know about extension or reorg?

A higher height usually represents extension but is not enough proof. Query headers or chain ancestry to identify replacements, same-height changes and deeper reorganisations.

Conclusion

waitfornewblock is a low-overhead tip-change primitive, not a complete event system. Durability comes from checkpointing, explicit comparison, ancestry reconciliation and idempotent downstream processing.

Primary sources

Check the current specification status and the documentation for the exact implementation you operate before moving production funds or changing a mining node.

ASIC MINER PICKS

Recommended ASIC Mining Hardware

Compare three of our highest ranked ASIC miners currently available, with live product details and pricing.
Overall ranking
Overall rank#1of 163AvailableAll: #6 / 836
Bitmain Antminer S21+ Hydro 395Th SHA-256 Bitcoin Miner
Bitmain
Pre-OrderFree Shipping
Hashrate
395TH
Efficiency
15W/TH
Power
5925W
Earns/kWh
£0.057
Price · delivered
£2,970.00
ex VAT
Est. per month
£245.92
Payback 1 Year
Overall ranking
Overall rank#3of 163AvailableAll: #8 / 836
Canaan Avalon A1566HA Hydro 2U 460Th SHA-256 Bitcoin Miner
Canaan
In stockFree Shipping
Hashrate
460TH
Efficiency
16.8W/TH
Power
7728W
Earns/kWh
£0.051
Price · delivered
Original price was: £5,176.00.Current price is: £3,430.00.
ex VAT
Est. per month
£286.39
Payback 12 Months
Overall ranking
Overall rank#5of 163AvailableAll: #11 / 836
MicroBT Whatsminer M65S+ Hydro 414Th SHA-256 Bitcoin Miner
MicroBT
In stockFree Shipping
Hashrate
414TH
Efficiency
17W/TH
Power
7038W
Earns/kWh
£0.050
Price · delivered
£2,970.00
ex VAT
Est. per month
£257.75
Payback 11.5 Months
Browse all ASIC miners
MORE MINING ADVICE

More ASIC Mining Articles

Read practical advice about choosing hardware, calculating electricity costs, setting up miners, hosting and maintenance.
MINER COMMUNITY

Join the ASIC Mining Discussion

Ask a question or share what has worked for you. Your experience may help another miner make a better decision.

Members can read and join the discussion

Log in to read comments from other miners. Create a free account if you would like to ask a question or share your experience.

Log in to read comments Register to join the discussion

Membership helps us protect the discussion from spam and keep answers useful.

ASIC MINING SUPPORT

Need Help Choosing an ASIC Miner?

Tell us what you want to mine, your electricity cost and where the machine will run. We can help you compare hardware, power requirements, hosting and repairs.
Contact our mining team
Browse ASIC miners