TCP hole punching for Bitcoin nodes behind home NATs?

Posted by willcl-ark

May 11, 2026/11:05 UTC

The recent development in network tools has seen the creation of a Python-based holepunch program which facilitates testing of network connections through NAT (Network Address Translation) configurations. The program, available on GitHub at willcl-ark/natcat, includes an innovative stun command. This command interacts with a stuntman server to retrieve the user's external IP address and port, details typically shared among peers in environments like Bitcoin Core.

The utility of this program extends to enabling simultaneous connections between two machines using the peer command. By exchanging IP information and initiating the peer command concurrently, users can establish direct communication channels, sending data such as text and files directly via stdin. This function has been tested under various conditions including changes in IP addresses while maintaining consistent ports, and even across different network setups like containers, Starlink, and VPNs. Despite some challenges, such as delays caused by router firewall memory and specific NAT configurations in hotels blocking the connection, the program has demonstrated considerable success in bypassing these hurdles.

These features underscore the flexibility and potential applications of the tool in real-world scenarios, making it a valuable asset for anyone involved in network management or testing. The GitHub repository also provides additional insights and instructions for users looking to leverage this tool for their networking needs.

Link to Raw Post
Bitcoin Logo

TLDR

Join Our Newsletter

We’ll email you summaries of the latest discussions from high signal bitcoin sources, like bitcoin-dev, lightning-dev, and Delving Bitcoin.

Explore all Products

ChatBTC imageBitcoin searchBitcoin TranscriptsSaving SatoshiDecoding BitcoinWarnet
Built with 🧡 by the Bitcoin Dev Project
View our public visitor count

We'd love to hear your feedback on this project.

Give Feedback