Protocol Config (Experimental)

EXPERIMENTAL_protocol_config request type

This endpoint allows you to get the protocol configuration of the NEAR blockchain.

Network

FastNear API keyNo saved key

Get API key

Endpointhttps://rpc.mainnet.fastnear.com

Finality

The latest block with full finality. Highest confidence, with the most confirmation lag.

Authnone detected

Live Response

Responses from the selected endpoint appear here after you run a request.

Live response output will appear here after you run a request.

Request reference

application/json

This operation accepts a JSON-RPC body over POST to /.

Required request inputs: yes

{
  "jsonrpc": "2.0",
  "id": "fastnear",
  "method": "EXPERIMENTAL_protocol_config",
  "params": {
    "finality": "final"
  }
}

Request schema

object

requires jsonrpc, id, method, params

jsonrpc *string

2.0

id *string

Example: fastnear

method *string

EXPERIMENTAL_protocol_config

params *object

requires finality

finality *string

Block finality

finalnear-finaloptimistic

Response reference

200 application/json

Successful response

Response schema

objectJsonRpcResponse

requires jsonrpc, id

jsonrpc *string

2.0

id *one of

stringnumber

resultobject

avg_hidden_validator_seats_per_shardarray

Expected number of hidden validators per shard.

itemsinteger

block_producer_kickout_thresholdinteger

Threshold for kicking out block producers, between 0 and 100.

chain_idstring

ID of the blockchain. This must be unique for every blockchain. If your testnet blockchains do not have unique chain IDs, you will have a bad time.

chunk_producer_kickout_thresholdinteger

Threshold for kicking out chunk producers, between 0 and 100.

chunk_validator_only_kickout_thresholdinteger

Threshold for kicking out nodes which are only chunk validators, between 0 and 100.

dynamic_reshardingboolean

Enable dynamic re-sharding.

epoch_lengthinteger

Epoch length counted in block heights.

fishermen_thresholdstring

Amount in yoctoNEAR

gas_limitstring

Gas amount

gas_price_adjustment_ratearray

Gas price adjustment rate

itemsinteger

genesis_heightinteger

Height of genesis block.

genesis_timestring

Official time of blockchain start.

max_gas_pricestring

Amount in yoctoNEAR

max_inflation_ratearray

Maximum inflation on the total supply every epoch.

itemsinteger

max_kickout_stake_percinteger

Max stake percentage of the validators we will kick out.

min_gas_pricestring

Amount in yoctoNEAR

minimum_stake_divisorinteger

The minimum stake required for staking is last seat price divided by this number.

minimum_stake_ratioarray

The lowest ratio s/s_total any block producer can have. See <https://github.com/near/NEPs/pull/167> for details

itemsinteger

minimum_validators_per_shardinteger

The minimum number of validators each shard must have

num_block_producer_seatsinteger

Number of block producer seats at genesis.

num_block_producer_seats_per_shardarray

Defines number of shards and number of block producer seats per each shard at genesis.

itemsinteger

num_blocks_per_yearinteger

Expected number of blocks per year

online_max_thresholdarray

Online maximum threshold above which validator gets full reward.

itemsinteger

online_min_thresholdarray

Online minimum threshold below which validator doesn't receive reward.

itemsinteger

protocol_reward_ratearray

Protocol treasury rate

itemsinteger

protocol_treasury_accountstring

NEAR account ID

protocol_upgrade_stake_thresholdarray

Threshold of stake that needs to indicate that they ready for upgrade.

itemsinteger

protocol_versioninteger

Current Protocol Version

runtime_configobject

View that preserves JSON format of the runtime config.

account_creation_configobject

The structure describes configuration for creation of new accounts.

congestion_control_configobject

The configuration for congestion control. More info about congestion [here](https://near.github.io/nearcore/architecture/how/receipt-congestion.html?highlight=congestion#receipt-congestion)

storage_amount_per_bytestring

Amount in yoctoNEAR

transaction_costsobject

Describes different fees for the runtime

wasm_configobject

Config of wasm operations.

witness_configobject

Configuration specific to ChunkStateWitness.

shard_layoutobject

One of multiple possible types

shuffle_shard_assignment_for_chunk_producersboolean

If true, shuffle the chunk producers across shards. In other words, if the shard assignments were [S_0, S_1, S_2, S_3] where S_i represents the set of chunk producers for shard i, if this flag were true, the shard assignments might become, for example, [S_2, S_0, S_3, S_1].

target_validator_mandates_per_shardinteger

Number of target chunk validator mandates for each shard.

transaction_validity_periodinteger

Number of blocks for which a given transaction is valid

errorobject

codeinteger

messagestring

dataobject