atBlockHeight

A builder function that returns a partial interaction to a block at a specific height.

Use with other interactions like 'fcl.getBlock()' to get a full interaction at the specified block height.

Block height expresses the height of the block on the chain. The latest block height increases by one for every valid block produced.

Import

You can import the entire package and access the function:

_10

import * as sdk from "@onflow/sdk"

_10

_10

sdk.atBlockHeight(height)

Or import directly the specific function:

_10

import { atBlockHeight } from "@onflow/sdk"

_10

_10

atBlockHeight(height)

Usage

_20

import * as fcl from "@onflow/fcl";

_20

_20

// Get block at specific height

_20

await fcl.send([fcl.getBlock(), fcl.atBlockHeight(123)]).then(fcl.decode);

_20

_20

// Get account at specific block height

_20

await fcl.send([

_20

fcl.getAccount("0x1d007d755706c469"),

_20

fcl.atBlockHeight(12345)

_20

]).then(fcl.decode);

_20

_20

// Execute script at specific block height

_20

await fcl.send([

_20

fcl.script`

_20

access(all) fun main(): UFix64 {

_20

return getCurrentBlock().height

_20

}

_20

`,

_20

fcl.atBlockHeight(100)

_20

]).then(fcl.decode);

Parameters

height

• Type: number
• Description: The height of the block to execute the interaction at

Returns

InteractionBuilderFn

_10

export type InteractionBuilderFn = (

_10

ix: Interaction

_10

) => Interaction | Promise<Interaction>

---