core-lightning/doc/lightning-waitblockheight.7
ZmnSCPxj 54cc735201 lightningd/peer_control.c: Implement waitblockheight.
This is needed to fully implement handling of blockheight disagreements
between us and payee.
If payee believes the blockheight is higher than ours, then `pay`
should wait for our node to achieve that blockheight.

Changelog-Add: Implement `waitblockheight` to wait for a specific blockheight.
2020-01-21 22:23:21 +01:00

37 lines
1.0 KiB
Groff
Generated

.TH "LIGHTNING-WAITBLOCKHEIGHT" "7" "" "" "lightning-waitblockheight"
.SH NAME
lightning-waitblockheight -- Command for waiting for blocks on the blockchain
lightning-waitblockheight -- Command for waiting for blocks on the blockchain
.SH SYNOPSIS
\fBwaitblockheight\fR \fIblockheight\fR [\fItimeout\fR]
.SH DESCRIPTION
The \fBwaitblockheight\fR RPC command waits until the blockchain
has reached the specified \fIblockheight\fR.
It will only wait up to \fItimeout\fR seconds (default 60).
If the \fIblockheight\fR is a present or past block height, then this
command returns immediately.
.SH RETURN VALUE
Once the specified block height has been achieved by the blockchain,
an object with the single field \fIblockheight\fR is returned, which is
the block height at the time the command returns.
If \fItimeout\fR seconds is reached without the specified blockheight
being reached, this command will fail.
.SH AUTHOR
ZmnSCPxj <\fIZmnSCPxj@protonmail.com\fR> is mainly responsible.
.SH RESOURCES
Main web site: \fIhttps://github.com/ElementsProject/lightning\fR