lightning-waitblockheight – Command for waiting for blocks on the blockchain

SYNOPSIS

waitblockheight blockheight [timeout]

DESCRIPTION

The waitblockheight RPC command waits until the blockchain has reached the specified blockheight. It will only wait up to timeout seconds (default 60).

If the blockheight is a present or past block height, then this command returns immediately.

RETURN VALUE

On success, an object is returned, containing:

  • blockheight (u32): The current block height (>= blockheight parameter)

If timeout seconds is reached without the specified blockheight being reached, this command will fail with a code of 2000.

AUTHOR

ZmnSCPxj <ZmnSCPxj@protonmail.com> is mainly responsible.