# starknet_getBlockWithTxs > For the complete documentation index, see [llms.txt](/docs/llms.txt). POST https://starknet-mainnet.g.alchemy.com/v2/{apiKey} Get block information with full transactions given the block id Reference: https://www.alchemy.com/docs/chains/starknet/starknet-api-endpoints/starknet-get-block-with-txs ## Parameters | Name | Type | Required | Description | |------|------|----------|-------------| | block_id | object or enum | Yes | The hash of the requested block, or number (height) of the requested block, or a block tag | ## Result **result** (object): The resulting block information with full transactions ## Code Examples ### cURL ```bash curl --request POST \ --url https://starknet-mainnet.g.alchemy.com/v2/docs-demo \ --header 'Content-Type: application/json' \ --data '{ "jsonrpc": "2.0", "id": 1, "method": "starknet_getBlockWithTxs", "params": [ { "block_hash": "string" } ] }' ``` ### JavaScript ```javascript const options = { method: 'POST', headers: {'Content-Type': 'application/json'}, body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'starknet_getBlockWithTxs', params: [{block_hash: 'string'}] }) }; fetch('https://starknet-mainnet.g.alchemy.com/v2/docs-demo', options) .then(res => res.json()) .then(res => console.log(res)) .catch(err => console.error(err)); ``` ### Python ```python import requests url = "https://starknet-mainnet.g.alchemy.com/v2/docs-demo" payload = { "jsonrpc": "2.0", "id": 1, "method": "starknet_getBlockWithTxs", "params": [{ "block_hash": "string" }] } headers = {"Content-Type": "application/json"} response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ### Go ```go package main import ( "fmt" "strings" "net/http" "io" ) func main() { url := "https://starknet-mainnet.g.alchemy.com/v2/docs-demo" payload := strings.NewReader("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"starknet_getBlockWithTxs\",\n \"params\": [\n {\n \"block_hash\": \"string\"\n }\n ]\n}") req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(string(body)) } ``` ### Java ```java HttpResponse response = Unirest.post("https://starknet-mainnet.g.alchemy.com/v2/docs-demo") .header("Content-Type", "application/json") .body("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"starknet_getBlockWithTxs\",\n \"params\": [\n {\n \"block_hash\": \"string\"\n }\n ]\n}") .asString(); ``` ### C# ```csharp using RestSharp; var options = new RestClientOptions("https://starknet-mainnet.g.alchemy.com/v2/docs-demo"); var client = new RestClient(options); var request = new RestRequest(""); request.AddJsonBody("{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"starknet_getBlockWithTxs\",\n \"params\": [\n {\n \"block_hash\": \"string\"\n }\n ]\n}", false); var response = await client.PostAsync(request); Console.WriteLine("{0}", response.Content); ``` ## OpenRPC Method Specification ```yaml name: starknet_getBlockWithTxs description: Get block information with full transactions given the block id params: - name: block_id description: | The hash of the requested block, or number (height) of the requested block, or a block tag required: true schema: title: Block id description: Block hash, number or tag oneOf: - title: Block hash type: object required: - block_hash properties: block_hash: title: Block hash description: The hash identifying a block type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ - title: Block number type: object required: - block_number properties: block_number: title: Block number description: The block's number (its height) type: integer minimum: 0 - title: Block tag description: A tag specifying a dynamic reference to a block type: string enum: - latest - pending result: name: result description: The resulting block information with full transactions schema: title: Starknet get block with txs result oneOf: - title: Block with transactions description: The block object type: object required: - block_hash - block_number - l1_da_mode - l1_data_gas_price - l1_gas_price - new_root - parent_hash - sequencer_address - starknet_version - status - timestamp - transactions properties: status: title: Status description: The status of the block type: string enum: - PENDING - ACCEPTED_ON_L2 - ACCEPTED_ON_L1 - REJECTED block_hash: title: Block hash description: The hash identifying a block type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ parent_hash: title: Parent hash description: The hash of this block's parent type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ block_number: title: Block number description: The block number (its height) type: integer minimum: 0 new_root: title: New root description: The new global state root type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ timestamp: title: Timestamp description: The time in which the block was created, encoded in Unix time type: integer minimum: 0 sequencer_address: title: Sequencer address description: The StarkNet identity of the sequencer submitting this block type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ l1_gas_price: title: L1 gas price description: The price of L1 gas in the block type: object required: - price_in_wei - price_in_fri properties: price_in_fri: title: Price in fri description: | The price of one unit of the given resource, denominated in fri (10^-18 strk) type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ price_in_wei: title: Price in wei description: The price of one unit of the given resource, denominated in wei type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ l1_data_gas_price: title: L1 data gas price description: The price of L1 data gas in the block type: object required: - price_in_wei - price_in_fri properties: price_in_fri: title: Price in fri description: | The price of one unit of the given resource, denominated in fri (10^-18 strk) type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ price_in_wei: title: Price in wei description: The price of one unit of the given resource, denominated in wei type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ l1_da_mode: title: L1 da mode type: string description: Specifies whether the data of this block is published via blob data or calldata enum: - BLOB - CALLDATA starknet_version: title: Starknet version description: Semver of the current Starknet protocol type: string transactions: title: Transactions description: The transactions in this block type: array items: title: Transactions in block type: object description: The transaction schema, as it appears inside a block oneOf: - title: Invoke transaction description: Initiate a transaction from an account oneOf: - title: Invoke transaction V3 description: Initiates a transaction from a given account type: object required: - type - sender_address - calldata - version - signature - nonce - resource_bounds - tip - paymaster_data - account_deployment_data - nonce_data_availability_mode - fee_data_availability_mode properties: type: title: Type type: string enum: - INVOKE sender_address: title: Sender address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ calldata: title: Calldata type: array description: | The data expected by the account's `execute` function (in most use cases, this includes the called contract address and a function selector) items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ version: title: Version description: Version of the transaction scheme type: string enum: - '0x3' - '0x100000000000000000000000000000003' signature: title: Signature description: A transaction signature type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ nonce: title: Nonce description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ resource_bounds: title: Resource bounds description: Resource bounds for the transaction execution type: object required: - l1_gas - l2_gas properties: l1_gas: title: L1 Gas description: The max amount and max price per unit of L1 gas used in this transaction type: object required: - max_amount - max_price_per_unit properties: max_amount: title: Max amount description: The max amount of the resource that can be used in the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ max_price_per_unit: title: Max price per unit description: The max price per unit of this resource for this transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,31})$ l2_gas: title: L2 Gas description: The max amount and max price per unit of L2 gas used in this transaction type: object required: - max_amount - max_price_per_unit properties: max_amount: title: Max amount description: The max amount of the resource that can be used in the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ max_price_per_unit: title: Max price per unit description: The max price per unit of this resource for this transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,31})$ tip: title: Tip description: The tip for the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ paymaster_data: title: Paymaster data type: array description: Data needed to allow the paymaster to pay for the transaction in native tokens items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ account_deployment_data: title: Account deployment data type: array description: Data needed to deploy the account contract from which this transaction will be initiated items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ nonce_data_availability_mode: title: Nonce DA mode description: | The storage domain of the account's nonce (an account has a nonce per DA mode) type: string enum: - L1 - L2 fee_data_availability_mode: title: Fee DA mode description: | The storage domain of the account's balance from which the fee will be charged type: string enum: - L1 - L2 - title: L1 Handler Transaction description: | A call to an l1_handler on an L2 contract induced by a message from L1 type: object required: - calldata - contract_address - entry_point_selector - nonce - type - version properties: version: title: Version description: Version of the transaction scheme type: string enum: - '0x0' type: title: Type type: string enum: - L1_HANDLER nonce: title: Nonce description: | The L1->L2 message nonce field of the SN Core L1 contract at the time the transaction was sent type: string pattern: ^0x[a-fA-F0-9]+$ contract_address: title: Contract address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ entry_point_selector: title: Entry point selector description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ calldata: title: Calldata type: array description: The parameters passed to the function items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ - title: Declare transaction oneOf: - title: Declare Transaction V3 description: Declare Contract Transaction V3 type: object required: - type - sender_address - compiled_class_hash - version - signature - nonce - class_hash - resource_bounds - tip - paymaster_data - account_deployment_data - nonce_data_availability_mode - fee_data_availability_mode properties: type: title: Declare type: string enum: - DECLARE sender_address: title: Sender address description: | The address of the account contract sending the declaration transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ compiled_class_hash: title: Compiled class hash description: The hash of the Cairo assembly resulting from the Sierra compilation type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ version: title: Version description: Version of the transaction scheme type: string enum: - '0x3' - '0x100000000000000000000000000000003' signature: title: Signature description: A transaction signature type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ nonce: title: Nonce description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ class_hash: title: Class hash description: The hash of the declared class type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ resource_bounds: title: Resource bounds description: Resource bounds for the transaction execution type: object required: - l1_gas - l2_gas properties: l1_gas: title: L1 Gas description: The max amount and max price per unit of L1 gas used in this transaction type: object required: - max_amount - max_price_per_unit properties: max_amount: title: Max amount description: The max amount of the resource that can be used in the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ max_price_per_unit: title: Max price per unit description: The max price per unit of this resource for this transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,31})$ l2_gas: title: L2 Gas description: The max amount and max price per unit of L2 gas used in this transaction type: object required: - max_amount - max_price_per_unit properties: max_amount: title: Max amount description: The max amount of the resource that can be used in the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ max_price_per_unit: title: Max price per unit description: The max price per unit of this resource for this transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,31})$ tip: title: Tip description: The tip for the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ paymaster_data: title: Paymaster data type: array description: Data needed to allow the paymaster to pay for the transaction in native tokens items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ account_deployment_data: title: Account deployment data type: array description: Data needed to deploy the account contract from which this transaction will be initiated items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ nonce_data_availability_mode: title: Nonce DA mode description: | The storage domain of the account's nonce (an account has a nonce per DA mode) type: string enum: - L1 - L2 fee_data_availability_mode: title: Fee DA mode description: | The storage domain of the account's balance from which the fee will be charged type: string enum: - L1 - L2 - title: Deploy Contract Transaction description: | The structure of a deploy transaction. Note that this transaction type is deprecated and will no longer be supported in future versions type: object required: - version - type - constructor_calldata - contract_address_salt - class_hash properties: version: title: Version description: Version of the transaction scheme type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ type: title: Deploy type: string enum: - DEPLOY contract_address_salt: title: Contract address salt description: The salt for the address of the deployed contract type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ constructor_calldata: title: Constructor calldata type: array description: The parameters passed to the constructor items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ class_hash: title: Class hash description: The hash of the deployed contract's class type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ - title: Deploy Account Transaction description: Deploys an account contract type: object required: - version - signature - nonce - type - contract_address_salt - constructor_calldata - class_hash - resource_bounds - tip - paymaster_data - account_deployment_data - nonce_data_availability_mode - fee_data_availability_mode properties: version: title: Version description: Version of the transaction scheme type: string enum: - '0x3' - '0x100000000000000000000000000000003' signature: title: Signature description: A transaction signature type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ nonce: title: Nonce description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ type: title: Type type: string enum: - DEPLOY_ACCOUNT contract_address_salt: title: Contract address salt description: The salt for the address of the deployed contract type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ constructor_calldata: title: Constructor calldata type: array description: The parameters passed to the constructor items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ class_hash: title: Class hash description: The hash of the deployed contract's class type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ resource_bounds: title: Resource bounds description: Resource bounds for the transaction execution type: object required: - l1_gas - l2_gas properties: l1_gas: title: L1 Gas description: The max amount and max price per unit of L1 gas used in this transaction type: object required: - max_amount - max_price_per_unit properties: max_amount: title: Max amount description: The max amount of the resource that can be used in the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ max_price_per_unit: title: Max price per unit description: The max price per unit of this resource for this transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,31})$ l2_gas: title: L2 Gas description: The max amount and max price per unit of L2 gas used in this transaction type: object required: - max_amount - max_price_per_unit properties: max_amount: title: Max amount description: The max amount of the resource that can be used in the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ max_price_per_unit: title: Max price per unit description: The max price per unit of this resource for this transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,31})$ tip: title: Tip description: The tip for the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ paymaster_data: title: Paymaster data type: array description: Data needed to allow the paymaster to pay for the transaction in native tokens items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ account_deployment_data: title: Account deployment data type: array description: Data needed to deploy the account contract from which this transaction will be initiated items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ nonce_data_availability_mode: title: Nonce DA mode description: The storage domain of the account's nonce (an account has a nonce per DA mode) type: string enum: - L1 - L2 fee_data_availability_mode: title: Fee DA mode description: The storage domain of the account's balance from which the fee will be charged type: string enum: - L1 - L2 required: - transaction_hash properties: transaction_hash: title: Transaction hash description: The transaction hash, as assigned in StarkNet type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ - title: Pending block with transactions description: The dynamic block being constructed by the sequencer. Note that this object will be deprecated upon decentralization. type: object required: - l1_da_mode - l1_data_gas_price - l1_gas_price - parent_hash - sequencer_address - starknet_version - timestamp - transactions not: anyOf: - required: - block_hash - block_number - new_root properties: transactions: title: Transactions description: The transactions in this block type: array items: title: Transactions in block type: object description: The transaction schema, as it appears inside a block oneOf: - title: Invoke transaction description: Initiate a transaction from an account oneOf: - title: Invoke transaction V3 description: Initiates a transaction from a given account type: object required: - type - sender_address - calldata - version - signature - nonce - resource_bounds - tip - paymaster_data - account_deployment_data - nonce_data_availability_mode - fee_data_availability_mode properties: type: title: Type type: string enum: - INVOKE sender_address: title: Sender address description: A contract address type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ calldata: title: Calldata type: array description: | The data expected by the account's `execute` function (in most use cases, this includes the called contract address and a function selector) items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ version: title: Version description: Version of the transaction scheme type: string enum: - '0x3' - '0x100000000000000000000000000000003' signature: title: Signature description: A transaction signature type: array items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ nonce: title: Nonce description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ resource_bounds: title: Resource bounds description: Resource bounds for the transaction execution type: object required: - l1_gas - l2_gas properties: l1_gas: title: L1 Gas description: The max amount and max price per unit of L1 gas used in this transaction type: object required: - max_amount - max_price_per_unit properties: max_amount: title: Max amount description: The max amount of the resource that can be used in the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ max_price_per_unit: title: Max price per unit description: The max price per unit of this resource for this transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,31})$ l2_gas: title: L2 Gas description: The max amount and max price per unit of L2 gas used in this transaction type: object required: - max_amount - max_price_per_unit properties: max_amount: title: Max amount description: The max amount of the resource that can be used in the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ max_price_per_unit: title: Max price per unit description: The max price per unit of this resource for this transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,31})$ tip: title: Tip description: The tip for the transaction type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,15})$ paymaster_data: title: Paymaster data type: array description: Data needed to allow the paymaster to pay for the transaction in native tokens items: title: Field element description: A field element. Represented by at most 63 hex digits type: string pattern: ^0x(0|[a-fA-F1-9]{1}[a-fA-F0-9]{0,62})$ account_deployment_data: title: Account deployment data type: array description: Data needed to deploy the account contract from which this transaction will be initiated items: # ... truncated (22885 chars) to keep this page under agent context limits. ```