./lnd-emulator --listen=0.0.0.0:10009 \
--rest-listen=0.0.0.0:8080 \
--num-channels=5 \
--channel-capacity=1000000 \
--fee-rate=1000 \
--failure-rate=0.05
This command starts an emulated node with 5 channels (each 1M sat capacity), a routing fee rate of 1000 ppm, and a 5% random failure rate.
| Limitation | Explanation | |------------|-------------| | No real HTLCs | Does not simulate actual hash time-locked contract execution. | | No gossip sync | No channel graph propagation. | | No watchtower | Cannot test breach remedy flows. | | Simplified fees | Fee estimation may not match real routing. | | No on-chain txs | Cannot test sweeps, force-closes, or coop closes. |
For full protocol testing, use
regtest+lnd+btcdor tools like Polar or Regtest Toolkit.
| Area | Capability | |------|-------------| | Performance | Handle 500+ simulated payments/sec | | Resource use | < 200 MB RAM for 10 nodes | | Portability | Linux, macOS, Windows (Go binary) | | Extensibility | gRPC server plugins for custom business logic |
| Feature | LND Emulator Utility | Regtest (Bitcoind + LND) | Testnet | |---------|----------------------|---------------------------|---------| | Startup time | < 100ms | 10–30 seconds | Minutes | | Resource usage (RAM) | 50–200 MB | 1–4 GB | >4 GB | | Deterministic failures | Yes (injectable) | No | No | | Requires blockchain sync | No | Yes | Yes | | Real crypto operations | Simulated | Yes | Yes | | Cost | Free | Free (compute heavy) | Free but scarce coins | | Multi-hop simulation | Full emulation | Full real | Full real | | Chaos testing | Excellent | Poor | Poor |
| Service | Methods Emulated |
|---------|------------------|
| Lightning | GetInfo, ListChannels, SendPaymentSync, AddInvoice, LookupInvoice, PayInvoice, NewAddress |
| WalletKit | ListUnspent, SendOutputs, PendingSweeps |
| Router | SendPaymentV2, TrackPayment, EstimateRouteFee |
Note: Advanced features like
SubscribeEvents,HODL invoices, orAMPmay be partially supported depending on the emulator implementation.
We use cookies to ensure that we give you the best experience on our website—to enhance site navigation, to analyze usage, and to assist in our marketing efforts. By continuing to use our site, you consent to the storing of cookies on your device and agree to delivery of content, including web fonts and JavaScript, from third party web services.
Cookie Settings
Last updated: 16 November 2022
StataCorp LLC (StataCorp) strives to provide our users with exceptional products and services. To do so, we must collect personal information from you. This information is necessary to conduct business with our existing and potential customers. We collect and use this information only where we may legally do so. This policy explains what personal information we collect, how we use it, and what rights you have to that information. lnd emulator utility
These cookies are essential for our website to function and do not store any personally identifiable information. These cookies cannot be disabled. This command starts an emulated node with 5
This website uses cookies to provide you with a better user experience. A cookie is a small piece of data our website stores on a site visitor's hard drive and accesses each time you visit so we can improve your access to our site, better understand how you use our site, and serve you content that may be of interest to you. For instance, we store a cookie when you log in to our shopping cart so that we can maintain your shopping cart should you not complete checkout. These cookies do not directly store your personal information, but they do support the ability to uniquely identify your internet browser and device.
Please note: Clearing your browser cookies at any time will undo preferences saved here. The option selected here will apply only to the device you are currently using. For full protocol testing, use regtest + lnd