Struct Chain

pub struct Chain;

Chain-related interactions with the NEAR Protocol

The Chain struct provides methods to interact with the NEAR blockchain

Examples

use near_api::*;

let block_number = Chain::block_number().fetch_from_testnet().await?;
println!("Current block number: {}", block_number);

Implementations

impl Chain

pub fn block_number() -> BlockQueryBuilder<PostprocessHandler<BlockHeight, RpcBlockHandler>>

Set ups a query to fetch the BlockHeight of the current block

Fetching the latest block number

use near_api::*;

let block_number = Chain::block_number().fetch_from_testnet().await?;
println!("Current block number: {}", block_number);

Fetching the final block number

use near_api::*;

let block_number = Chain::block_number().at(Reference::Final).fetch_from_testnet().await?;
println!("Final block number: {}", block_number);

pub fn block_hash() -> BlockQueryBuilder<PostprocessHandler<CryptoHash, RpcBlockHandler>>

Set ups a query to fetch the CryptoHash of the block

Fetching the latest block hash

use near_api::*;

let block_hash = Chain::block_hash().fetch_from_testnet().await?;
println!("Current block hash: {}", block_hash);

Fetching the hash at a specific block number

use near_api::*;

let block_hash = Chain::block_hash().at(Reference::AtBlock(1000000)).fetch_from_testnet().await?;
println!("Block hash at block number 1000000: {}", block_hash);

pub fn block() -> BlockQueryBuilder<RpcBlockHandler>

Set ups a query to fetch the BlockView

Fetching the latest block

use near_api::*;

let block = Chain::block().fetch_from_testnet().await?;
println!("Current block: {:?}", block);

Fetching the block at a specific block number

use near_api::*;

let block = Chain::block().at(Reference::AtBlock(1000000)).fetch_from_testnet().await?;
println!("Block at block number 1000000: {:?}", block);

Fetching the block at a specific block hash

use near_api::*;

let block = Chain::block().at(Reference::AtBlockHash(block_hash)).fetch_from_testnet().await?;
println!("Block at block hash: {:?}", block);

Trait Implementations

impl Clone for Chain

fn clone(&self) -> Chain

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Chain

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Copy for Chain