LLM Notice: This documentation site supports content negotiation for AI agents. Request any page with Accept: text/markdown or Accept: text/plain header to receive Markdown instead of HTML. Alternatively, append ?format=md to any URL. All markdown files are available at /md/ prefix paths. For all content in one file, visit /llms-full.txt
Skip to main content

atBlockId

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

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

Block ID is SHA3-256 hash of the entire block payload. This hash is stored as an ID field on any block response object (ie. response from 'GetLatestBlock').

Import​

You can import the entire package and access the function:


_10
import * as sdk from "@onflow/sdk"
_10
_10
sdk.atBlockId(id)

Or import directly the specific function:


_10
import { atBlockId } from "@onflow/sdk"
_10
_10
atBlockId(id)

Usage​


_20
import * as fcl from "@onflow/fcl";
_20
_20
// Get block by ID
_20
await fcl.send([fcl.getBlock(), fcl.atBlockId("23232323232")]).then(fcl.decode);
_20
_20
// Get account at specific block ID
_20
await fcl.send([
_20
fcl.getAccount("0x1d007d755706c469"),
_20
fcl.atBlockId("9dda5f281897389b99f103a1c6b180eec9dac870de846449a302103ce38453f3")
_20
]).then(fcl.decode);
_20
_20
// Execute script at specific block
_20
await fcl.send([
_20
fcl.script`
_20
access(all) fun main(): UFix64 {
_20
return getCurrentBlock().timestamp
_20
}
_20
`,
_20
fcl.atBlockId("a1b2c3d4e5f6")
_20
]).then(fcl.decode);

Parameters​

id​

  • Type: string
  • Description: The ID of the block to execute the interaction at

Returns​


_10
export type InteractionBuilderFn = (
_10
ix: Interaction
_10
) => Interaction | Promise<Interaction>

A partial interaction to be paired with another interaction such as 'fcl.getBlock()' or 'fcl.getAccount()'


Rate this page