Parameters

finality

string

The assurance that the transaction cannot be altered, reversed, or canceled after completion. For finality=final, it means that it has been validated on at least 66% of the nodes in the network, and for finality=optimistic, it uses the latest block recorded on the node that responded to the query passed

block_id

int/string

The block id which could be either a block number or a block hash

Returns

avg_hidden_validator_seats_per_shard

array

(Optional) The average number of hidden validator seats that are allocated to each shard in the network

block_producer_kickout_threshold

integer

The number of blocks that a block producer node can miss before being removed from the active validator set

chain_id

string

The id of the chain

chunk_producer_kickout_threshold

integer

The number of chunks that a chunk producer node can miss before being removed from the active validator set

dynamic_resharding

boolean

It is a boolean value that indicates whether dynamic resharding is enabled in the NEAR Protocol, allowing on-demand reshuffling of shards for optimal network performance

epoch_length

integer

The length of an epoch in the NEAR Protocol

fishermen_threshold

string

The minimum number of validation failures required for a validator node to be reported as a fisherman in the NEAR Protocol

gas_limit

integer

The maximum amount of gas that can be used for a single transaction

gas_price_adjustment_rate

array

The rate at which the gas price can adjust over time

genesis_height

integer

The block height at which the genesis state was created

genesis_time

string

The timestamp of the genesis block in the NEAR Protocol

max_gas_price

string

The maximum gas price allowed for a single transaction

max_inflation_rate

array

The maximum annual inflation rate for the NEAR Protocol token supply

min_gas_price

string

The minimum gas price allowed for a single transaction

minimum_stake_divisor

integer

The minimum divisor for staking

num_block_producer_seats

integer

The total number of block producer seats available in the NEAR Protocol

num_block_producer_seats_per_shard

array

(Optional) The number of block producer seats available per shard in the NEAR Protocol

num_blocks_per_year

integer

The expected number of blocks to be created in a single year

online_max_threshold

array

The maximum percentage of validators that can be online at any given time in the NEAR Protocol

online_min_threshold

array

The minimum percentage of validators that can be online at any given time in the NEAR Protocol

protocol_reward_rate

array

The rate at which new tokens are minted and distributed as rewards to validators and other network participants

protocol_treasury_account

string

The address of the account that holds the protocol treasury

protocol_upgrade_stake_threshold

array

The minimum amount of stake required to initiate a protocol upgrade

protocol_version

integer

The current version of the protocol

runtime_config

object

The set of runtime configuration options

account_creation_config

object

It is used to specify the configuration options

min_allowed_top_level_account_length

integer

The minimum length of top-level account names

registrar_account_id

string

It is used to specify the account that will be responsible for registering new account names

storage_amount_per_byte

string

It is used to specify the amount of NEAR tokens that will be required to store one byte of data on NEAR chain

transaction_costs

object

The gas costs associated with various operations on NEAR chain

action_creation_config

object

The configuration options for creating new actions on the NEAR chain

add_key_cost

object

The cost of adding a new public key to an existing account

full_access_cost

object

The cost of granting full access to an account on NEAR chain

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

function_call_cost

object

The base cost of calling a function on the NEAR chain

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

function_call_cost_per_byte

object

The additional cost of calling a function based on the size of the function's input data

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

create_account_cost

object

The cost of creating a new account on the NEAR chain

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

delegate_cost

object

The cost of delegating stake to a validator

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

delete_account_cost

object

The cost of deleting an account on the NEAR chain

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

delete_key_cost

object

The cost of deleting a public key from an account on the NEAR chain

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

deploy_contract_cost

object

The base cost of deploying a new smart contract on the NEAR chain

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

deploy_contract_cost_per_byte

object

The additional cost of deploying a smart contract based on the size of its code

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

function_call_cost

object

The base cost of calling a function

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

function_call_cost_per_byte

object

The additional cost of calling a function based on the size of the function's input data

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

stake_cost

object

The cost of staking NEAR tokens to participate in the network's consensus process

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

transfer_cost

object

The cost of transferring NEAR tokens between accounts on the network

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

action_receipt_creation_config

object

The configuration for the creation of action receipts

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

burnt_gas_reward

integer

(Optional) The amount of NEAR tokens that are rewarded to validators for burning gas during transaction execution

data_receipt_creation_config

object

The configuration for the creation of data receipts

base_cost

object

The base cost is the minimum amount of gas required to execute a transaction, regardless of the complexity of the transaction

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

cost_per_byte

object

The cost per byte of data that is included in a transaction

execution

integer

The execution context for a given operation

send_not_sir

integer

The gas cost associated with sending a transaction to an account that does not require a specific function to be called

send_sir

integer

The gas cost associated with sending a transaction to an account that requires a specific function to be called

pessimistic_gas_price_inflation_ratio

integer

(Optional) The maximum ratio by which the gas price can be inflated during transaction execution

storage_usage_config

object

The amount of space used to store data on the blockchain

num_bytes_account

integer

(Optional) The maximum number of bytes that can be used to store an account on the blockchain

num_extra_bytes_record

integer

(Optional) The maximum number of extra bytes that can be used to store additional information in a record on the blockchain

wasm_config

object

The configuration for running WebAssembly (Wasm) smart contracts on the NEAR chain

ext_costs

object

The extra costs associated with executing a transaction

alt_bn128_g1_multiexp_base

integer

The base point for a multi-exponentiation operation on the alt_bn128 elliptic curve

alt_bn128_g1_multiexp_element

integer

The list of scalar values to be used in a multi-exponentiation operation on the alt_bn128 elliptic curve

alt_bn128_g1_sum_base

integer

The base point for a sum operation on the alt_bn128 elliptic curve

alt_bn128_g1_sum_element

integer

The list of points to be used in a sum operation on the alt_bn128 elliptic curve

alt_bn128_pairing_check_base

integer

The base points for a pairing check operation on the alt_bn128 elliptic curve

alt_bn128_pairing_check_element

integer

The list of points to be used in a pairing check operation on the alt_bn128 elliptic curve

base

integer

The base fee for a transaction

contract_compile_base

integer

The base cost for compiling a smart contract on the NEAR chain

contract_compile_bytes

integer

(Optional) The cost per byte of code that is compiled for a smart contract on the NEAR chain

contract_loading_base

integer

The base cost for loading a smart contract into memory on the NEAR chain

contract_loading_bytes

integer

(Optional) The cost per byte of code that is loaded into memory for a smart contract on the NEAR chain

ecrecover_base

integer

The base cost for performing an ECDSA signature recovery operation

ed25519_verify_base

integer

The base cost for verifying an Ed25519 signature on the NEAR chain

ed25519_verify_byte

integer

The cost per byte of message that is verified for an Ed25519 signature on the NEAR chain

keccak256_base

integer

The base cost for computing the Keccak-256 hash of a message on the NEAR chain

keccak256_byte

integer

The cost per byte of message that is hashed using Keccak-256 on the NEAR chain

keccak512_base

integer

The base cost for computing the Keccak-512 hash of a message on the NEAR chain

keccak512_byte

integer

The cost per byte of message that is hashed using Keccak-512 on the NEAR chain

log_base

integer

The base cost for writing a log entry on the NEAR chain

log_byte

integer

The cost per byte of data that is written to a log entry on the NEAR the cost per byte of data that is written to a log entry on the NEAR chain

promise_and_base

integer

The base cost for creating a promise on the NEAR chain

promise_and_per_promise

integer

The additional cost per promise created in a smart contract on the NEAR chain

promise_return

integer

The cost for returning a promise result to the caller of a smart contract on the NEAR chain

read_cached_trie_node

integer

The cost for reading a node from the trie data structure that is used to store account and contract state on the NEAR chain

read_memory_base

integer

The base cost for reading data from memory in a smart contract

read_memory_byte

integer

The cost per byte of data that is read from memory in a smart contract

read_register_base

integer

The base cost for reading a value from a register in a smart contract

read_register_byte

integer

The cost per byte of data that is read from a register in a smart contract

ripemd160_base

integer

The base cost for performing the RIPEMD-160 cryptographic hash function in a smart contract

ripemd160_block

integer

The additional cost per block of data that is processed by the RIPEMD-160 hash function in a smart contract

sha256_base

integer

The base cost for performing the SHA-256 cryptographic hash function in a smart contract

sha256_byte

integer

The additional cost per byte of data that is processed by the SHA-256 hash function in a smart contract

storage_has_key_base

integer

The base cost for checking if a key exists in the persistent storage of a smart contract

storage_has_key_byte

integer

The additional cost per byte of data that is checked when verifying if a key exists in the persistent storage of a smart contract

storage_iter_create_from_byte

integer

The base cost for creating a new storage iterator that starts from a given byte key in the persistent storage of a smart contract

storage_iter_create_prefix_base

integer

The base cost for creating a new storage iterator that iterates over all keys in the persistent storage of a smart contract

storage_iter_create_prefix_byte

integer

The additional cost per byte of the prefix used to create a new storage iterator that iterates over all keys in the persistent storage of a smart contract

storage_iter_create_range_base

integer

The base cost for creating a new storage iterator that iterates over a range of keys in the persistent storage of a smart contract

storage_iter_create_to_byte

integer

The base cost for creating a new storage iterator that stops at a given byte key in the persistent storage of a smart contract

storage_iter_next_base

integer

The base cost for advancing the iterator to the next key in the persistent storage of a smart contract

storage_iter_next_key_byte

integer

The additional cost per byte of the key returned by the iterator when advancing to the next key in the persistent storage of a smart contract

storage_iter_next_value_byte

integer

The additional cost per byte of the value returned by the iterator when advancing to the next key in the persistent storage of a smart contract

storage_read_base

integer

The base cost for reading a value from the persistent storage of a smart contract

storage_read_key_byte

integer

The additional cost per byte of the key used to read a value from the persistent storage of a smart contract

storage_read_value_byte

integer

The additional cost per byte of the value read from the persistent storage of a smart contract

storage_remove_base

integer

The base cost for removing a key-value pair from the persistent storage of a smart contract

storage_remove_key_byte

integer

The additional cost per byte of the key used to remove a key-value pair from the persistent storage of a smart contract

storage_remove_ret_value_byte

integer

The additional cost per byte of the value returned when removing a key-value pair from the persistent storage of a smart contract

storage_write_base

integer

The base cost for writing to storage

storage_write_evicted_byte

integer

The cost per byte for evicted storage write operations

storage_write_key_byte

integer

The cost per byte for writing a key to storage

storage_write_value_byte

integer

The cost per byte for writing a value to storage

touching_trie_node

integer

The cost for touching a trie node during a state access

utf16_decoding_base

integer

The base cost for UTF-16 decoding

utf16_decoding_byte

integer

The cost per byte for UTF-16 decoding

utf8_decoding_base

integer

The base cost for UTF-8 decoding

utf8_decoding_byte

integer

The cost per byte for UTF-8 decoding

validator_stake_base

integer

The base cost for a validator's stake

validator_total_stake_base

integer

The base cost for the total stake in the network

write_memory_base

integer

The base cost for writing to memory

write_memory_byte

integer

The cost per byte for writing to memory

write_register_base

integer

The base cost for writing to a register

write_register_byte

integer

The cost per byte for writing to a register

grow_mem_cost

integer

The cost for growing memory

limit_config

object

The configuration for various resource limits, such as the maximum number of contract calls per transaction and the maximum number of contract state changes per block

account_id_validity_rules_version

integer

(Optional) The version of the account ID validity rules

initial_memory_pages

integer

The initial number of memory pages allocated to a contract

max_actions_per_receipt

integer

The maximum number of actions that can be included in a single receipt

max_arguments_length

integer

(Optional) The maximum length of arguments that can be passed to a function call

max_contract_size

integer

The maximum size of a contract that can be deployed on the network

max_functions_number_per_contract

integer

The maximum number of functions that can be defined in a single contract

max_gas_burnt

integer

(Optional) The maximum amount of gas that can be consumed by a single transaction or contract call

max_length_method_name

integer

(Optional) The maximum length of a method name

max_length_returned_data

integer

(Optional) The maximum length of the data that can be returned by a function call

max_length_storage_key

integer

(Optional) The maximum length of a storage key

max_length_storage_value

integer

(Optional) The maximum length of a storage value

max_locals_per_contract

integer

The maximum number of local variables that can be defined in a single contract function

max_memory_pages

integer

The maximum number of memory pages that can be allocated to a contract

max_number_bytes_method_names

integer

(Optional) The maximum number of bytes that can be used to represent method names across all functions in a single contract

max_number_input_data_dependencies

integer

The maximum number of input data dependencies that can be included in a single contract function call

max_number_logs

integer

The maximum number of logs that can be emitted by a single contract function call

max_number_registers

integer

The maximum number of registers that can be used in a single contract function

max_promises_per_function_call_action

integer

The maximum number of promises that can be created in a single contract function call

max_register_size

integer

The maximum size of a single register

max_stack_height

integer

(Optional) The maximum allowed height of the runtime execution stack

max_total_log_length

integer

(Optional) The maximum total length of all logs that can be emitted during a single transaction

max_total_prepaid_gas

integer

(Optional) The maximum amount of gas that can be prepaid for a single transaction

max_transaction_size

integer

The maximum allowed size of a single transaction in bytes

registers_memory_limit

integer

The maximum amount of memory that can be used for register storage

stack_limiter_version

integer

(Optional) The version of the stack limiter algorithm used in the protocol

wasmer2_stack_limit

integer

(Optional) The maximum stack size allowed by the Wasmer 2 runtime

regular_op_cost

integer

The base cost for executing a regular operation

transaction_validity_period

integer

The validity period of a transaction, after which it cannot be included in a block

Request

1
curl https://docs-demo.near-mainnet.quiknode.pro/ \
2
--request POST \
3
--header "Content-Type: application/json" \
4
--data '{"method": "EXPERIMENTAL_protocol_config","params": {"finality": "final"},"id":1,"jsonrpc":"2.0"}'

1
curl https://docs-demo.near-mainnet.quiknode.pro/ \
2
--request POST \
3
--header "Content-Type: application/json" \
4
--data '{"method": "EXPERIMENTAL_protocol_config","params": {"finality": "final"},"id":1,"jsonrpc":"2.0"}'

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "EXPERIMENTAL_protocol_config",
6
  "params": {
7
    "finality": "final"
8
  },
9
  "id": 1,
10
  "jsonrpc": "2.0"
11
});
12

13
var requestOptions = {
14
  method: 'POST',
15
  headers: myHeaders,
16
  body: raw,
17
  redirect: 'follow'
18
};
19

20
fetch("https://docs-demo.near-mainnet.quiknode.pro/", requestOptions)
21
  .then(response => response.text())
22
  .then(result => console.log(result))
23
  .catch(error => console.log('error', error));

1
var myHeaders = new Headers();
2
myHeaders.append("Content-Type", "application/json");
3

4
var raw = JSON.stringify({
5
  "method": "EXPERIMENTAL_protocol_config",
6
  "params": {
7
    "finality": "final"
8
  },
9
  "id": 1,
10
  "jsonrpc": "2.0"
11
});
12

13
var requestOptions = {
14
  method: 'POST',
15
  headers: myHeaders,
16
  body: raw,
17
  redirect: 'follow'
18
};
19

20
fetch("https://docs-demo.near-mainnet.quiknode.pro/", requestOptions)
21
  .then(response => response.text())
22
  .then(result => console.log(result))
23
  .catch(error => console.log('error', error));

1
import requests
2
import json
3

4
url = "https://docs-demo.near-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "method": "EXPERIMENTAL_protocol_config",
8
  "params": {
9
    "finality": "final"
10
  },
11
  "id": 1,
12
  "jsonrpc": "2.0"
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
print(response.text)
21

1
import requests
2
import json
3

4
url = "https://docs-demo.near-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "method": "EXPERIMENTAL_protocol_config",
8
  "params": {
9
    "finality": "final"
10
  },
11
  "id": 1,
12
  "jsonrpc": "2.0"
13
})
14
headers = {
15
  'Content-Type': 'application/json'
16
}
17

18
response = requests.request("POST", url, headers=headers, data=payload)
19

20
print(response.text)
21

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.near-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "EXPERIMENTAL_protocol_config",
14
  "params": {
15
    "finality": "final"
16
  },
17
  "id": 1,
18
  "jsonrpc": "2.0"
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

1
require "uri"
2
require "json"
3
require "net/http"
4

5
url = URI("https://docs-demo.near-mainnet.quiknode.pro/")
6

7
https = Net::HTTP.new(url.host, url.port)
8
https.use_ssl = true
9

10
request = Net::HTTP::Post.new(url)
11
request["Content-Type"] = "application/json"
12
request.body = JSON.dump({
13
  "method": "EXPERIMENTAL_protocol_config",
14
  "params": {
15
    "finality": "final"
16
  },
17
  "id": 1,
18
  "jsonrpc": "2.0"
19
})
20

21
response = https.request(request)
22
puts response.read_body
23

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free