Blockchain State Access

getBlock(blockHashOrBlockNumber?: BlockNumberOrTag, hydrated?: boolean, returnFormat?: DataFormat): Promise<Block>;

// Get latest block with transaction hashes only
const latestBlock = await eth.getBlock("latest");

// Get specific block with full transaction details  
const blockWithTxs = await eth.getBlock(15000000, true);

// Get block by hash
const block = await eth.getBlock("0x1234567890abcdef...");

getBlockNumber(returnFormat?: DataFormat): Promise<Numbers>;

const blockNumber = await eth.getBlockNumber();
console.log(`Current block: ${blockNumber}`);

getBlockTransactionCount(blockHashOrBlockNumber?: BlockNumberOrTag, returnFormat?: DataFormat): Promise<Numbers>;

const txCount = await eth.getBlockTransactionCount("latest");
const txCountByHash = await eth.getBlockTransactionCount("0x1234567890abcdef...");

getBlockUncleCount(blockHashOrBlockNumber?: BlockNumberOrTag, returnFormat?: DataFormat): Promise<Numbers>;

getUncle(blockHashOrBlockNumber?: BlockNumberOrTag, uncleIndex?: Numbers, returnFormat?: DataFormat): Promise<Block>;

getTransaction(transactionHash?: HexString32Bytes, returnFormat?: DataFormat): Promise<Transaction>;

const tx = await eth.getTransaction("0xabcdef1234567890...");
console.log(`From: ${tx.from}, To: ${tx.to}, Value: ${tx.value}`);

getTransactionFromBlock(blockHashOrBlockNumber?: BlockNumberOrTag, indexNumber?: Numbers, returnFormat?: DataFormat): Promise<Transaction>;

// Get first transaction from latest block
const firstTx = await eth.getTransactionFromBlock("latest", 0);

getTransactionReceipt(transactionHash?: HexString32Bytes, returnFormat?: DataFormat): Promise<TransactionReceipt>;

const receipt = await eth.getTransactionReceipt("0xabcdef1234567890...");
if (receipt.status === '0x1') {
  console.log("Transaction successful");
} else {
  console.log("Transaction failed");
}

getPendingTransactions(returnFormat?: DataFormat): Promise<Transaction[]>;

getProtocolVersion(): Promise<string>;

getChainId(): Promise<Numbers>;

const chainId = await eth.getChainId();
// 1 for mainnet, 5 for goerli, etc.

isSyncing(): Promise<SyncingStatusAPI | boolean>;

const syncStatus = await eth.isSyncing();
if (syncStatus !== false) {
  console.log(`Syncing: ${syncStatus.currentBlock}/${syncStatus.highestBlock}`);
}

getCoinbase(): Promise<Address>;

isMining(): Promise<boolean>;

getNodeInfo(): Promise<string>;

interface Block {
  hash?: HexString32Bytes;
  parentHash: HexString32Bytes;
  sha3Uncles: HexString32Bytes;
  miner: Address;
  stateRoot: HexString32Bytes;
  transactionsRoot: HexString32Bytes;
  receiptsRoot: HexString32Bytes;
  logsBloom: HexString;
  difficulty: Numbers;
  number: Numbers;
  gasLimit: Numbers;
  gasUsed: Numbers;
  timestamp: Numbers;
  extraData: Bytes;
  mixHash: HexString32Bytes;
  nonce: HexString8Bytes;
  totalDifficulty: Numbers;
  size: Numbers;
  transactions: HexString32Bytes[] | Transaction[];
  uncles: HexString32Bytes[];
}

interface Transaction {
  hash?: HexString32Bytes;
  nonce: Numbers;
  blockHash?: HexString32Bytes;
  blockNumber?: Numbers;
  transactionIndex?: Numbers;
  from: Address;
  to?: Address;
  value: Numbers;
  gasPrice?: Numbers;
  maxPriorityFeePerGas?: Numbers;
  maxFeePerGas?: Numbers;
  gas: Numbers;
  input: Bytes;
  type?: Numbers;
  accessList?: AccessList;
  chainId?: Numbers;
  v?: Numbers;
  r?: HexString32Bytes;
  s?: HexString32Bytes;
}

interface TransactionReceipt {
  transactionHash: HexString32Bytes;
  transactionIndex: Numbers;
  blockHash: HexString32Bytes;
  blockNumber: Numbers;
  from: Address;
  to?: Address;
  cumulativeGasUsed: Numbers;
  gasUsed: Numbers;
  contractAddress?: Address;
  logs: Log[];
  logsBloom: HexString;
  status: HexString;
  effectiveGasPrice: Numbers;
  type: Numbers;
}

interface SyncingStatusAPI {
  startingBlock: Numbers;
  currentBlock: Numbers;
  highestBlock: Numbers;
  knownStates?: Numbers;
  pulledStates?: Numbers;
}

type BlockNumberOrTag = Numbers | "latest" | "earliest" | "pending" | "safe" | "finalized";
type DataFormat = { number: NumberFormat; bytes: BytesFormat };