Description

Returns the block from the network based on the provided block number or hash. In addition to the transaction hashes included in the block, it also returns the full transaction objects.

Parameters

Response

BlockWithTransactions response object parameters

Example Request and Response

Prerequisite: You will need to install the Alchemy SDK before making requests with it.

The commands for installing it using npm or yarn are given below:

$
npm install alchemy-sdk

Request

Here is an example of how to make a getBlockWithTransactions request using the Alchemy SDK:

1
// Imports the Alchemy SDK
2
const { Alchemy, Network } = require("alchemy-sdk");
3
4
// Configures the Alchemy SDK
5
const config = {
6
    apiKey: "alchemy-replit", // Replace with your API key
7
    network: Network.ETH_MAINNET, // Replace with your network
8
};
9
10
// Creates an Alchemy object instance with the config to use for making requests
11
const alchemy = new Alchemy(config);
12
13
const main = async () => {
14
    //Assign the hash to a variable
15
    let txHash = "0x92fc42b9642023f2ee2e88094df80ce87e15d91afa812fef383e6e5cd96e2ed3"
16
17
    //Call the method to return the block with transactions
18
    let response = await alchemy.core.getBlockWithTransactions(txHash)
19
20
    //Logging the response to the console
21
    console.log(response)
22
};
23
24
main();

Response

$
{
>
      hash: '0x58bbdd890cc828a70cf6d65f103d7723e945197b53da2c263ea6270a82fb2ccb',
>
      type: 2,
>
      accessList: [],
>
      blockHash: '0x92fc42b9642023f2ee2e88094df80ce87e15d91afa812fef383e6e5cd96e2ed3',
>
      blockNumber: 15221026,
>
      transactionIndex: 57,
>
      confirmations: 1477819,
>
      from: '0x7abE0cE388281d2aCF297Cb089caef3819b13448',
>
      gasPrice: [BigNumber],
>
      maxPriorityFeePerGas: [BigNumber],
>
      maxFeePerGas: [BigNumber],
>
      gasLimit: [BigNumber],
>
      to: '0x7BA11217CCd0eD428924295BF7f13D50E75B68A4',
>
      value: [BigNumber],
>
      nonce: 310301,
>
      data: '0x',
>
      r: '0x79a3a0a0a9707c3c679e702b115562ce1bc5c8c761891baf05dfae2ddcc38599',
>
      s: '0x488153c1dcdb9b03af4199070b67476fa8f24af865e0f448fb7f538b004b0991',
>
      v: 1,
>
      creates: null,
>
      chainId: 1,
>
      wait: [Function (anonymous)]
>
    }, ............

Use Cases

Here are some possible use cases for this method:

• Blockchain Explorer: When building a blockchain explorer, it is important to be able to retrieve detailed information about blocks and their transactions. getBlockWithTransactions can be used to fetch this information and display it to users.

• Smart Contract Verification: When verifying the correctness of a smart contract execution, it may be necessary to retrieve the block and its transactions that triggered the execution. getBlockWithTransactions can be used to fetch this information and verify that the smart contract executed correctly.

• Payment Processing: When processing payments on a blockchain, it may be necessary to retrieve the block and its transactions that confirm the payment. getBlockWithTransactions can be used to fetch this information and confirm that the payment was successfully processed.

Related Methods

Here are the methods related to getBlockWithTransactions:

• getBlock: Returns the block from the network based on the provided block number or hash.
• getBlockNumber: Returns the result of executing the transaction, using call.