Console

POSTgenesis_config

NEAR Mainnethttps://near-mainnet.nodit.io/

Returns the genesis configuration set when the network launched. It includes the chain ID, genesis time and block height, epoch length, gas price bounds, total supply, validator seats and kickout thresholds, and the initial validators.

This method takes no parameters; send an empty array [] as params. The response reflects values at genesis; current values changed by later protocol upgrades are not reflected in the genesis configuration.

Request Body
jsonrpcstringrequired
idstringrequired

Request ID. Any string; it is returned unchanged in the response.

methodstringrequired
paramsobject[]required

No parameters. Send an empty array [].

Responses
jsonrpcstring

JSON-RPC version

idstring

Request ID

chain_idstring

Chain ID.

genesis_timestring

Official start time of the blockchain (ISO 8601, UTC).

genesis_heightinteger

Height of the genesis block.

protocol_versioninteger

Protocol version used at genesis.

epoch_lengthinteger

Epoch length in blocks.

num_blocks_per_yearinteger

Expected number of blocks per year.

transaction_validity_periodinteger

Number of blocks after its reference block for which a transaction stays valid.

gas_limitinteger

Initial gas limit.

min_gas_pricestring

Minimum gas price, which is also the initial gas price (yoctoNEAR, decimal string).

max_gas_pricestring

Maximum gas price (yoctoNEAR, decimal string).

gas_price_adjustment_rateinteger[]

Gas price adjustment rate as [numerator, denominator].

total_supplystring

Total token supply at genesis (yoctoNEAR, decimal string).

max_inflation_rateinteger[]

Maximum inflation applied to the total supply each epoch, as [numerator, denominator].

protocol_reward_rateinteger[]

Share of rewards going to the protocol treasury, as [numerator, denominator].

protocol_treasury_accountstring

Protocol treasury account.

protocol_upgrade_stake_thresholdinteger[]

Share of stake that must signal readiness for a protocol upgrade, as [numerator, denominator].

num_block_producer_seatsinteger

Number of block producer seats at genesis.

num_chunk_producer_seatsinteger

Number of chunk producer seats.

num_chunk_validator_seatsinteger

Number of chunk validator seats.

block_producer_kickout_thresholdinteger

Kickout threshold for block producers (0–100).

chunk_producer_kickout_thresholdinteger

Kickout threshold for chunk producers (0–100).

chunk_validator_only_kickout_thresholdinteger

Kickout threshold for nodes that are only chunk validators (0–100).

max_kickout_stake_percinteger

Maximum percentage of validator stake that can be kicked out (%).

online_min_thresholdinteger[]

Online threshold below which a validator receives no reward, as [numerator, denominator].

online_max_thresholdinteger[]

Online threshold above which a validator receives the full reward, as [numerator, denominator].

minimum_stake_divisorinteger

Minimum stake = last seat price ÷ this value.

minimum_stake_ratiointeger[]

The lowest stake ratio a block producer can have, as [numerator, denominator].

minimum_validators_per_shardinteger

Minimum number of validators required per shard.

target_validator_mandates_per_shardinteger

Target number of chunk validator mandates per shard.

chunk_producer_assignment_changes_limitinteger

Upper limit on shard changes allowed in chunk producer assignments.

shuffle_shard_assignment_for_chunk_producersboolean

If true, chunk producer shard assignments are shuffled each epoch.

fishermen_thresholdstring

Fishermen stake threshold (yoctoNEAR, decimal string).

dynamic_reshardingboolean

Whether dynamic resharding is enabled.

shard_layoutobject

How accounts are split into shards (shard layout). Keyed by version (e.g. V2), it contains the shard IDs and boundary accounts.

use_production_configboolean

Flag used for testing purposes.

validatorsobject[]

Initial validators.

account_idstring

NEAR account ID. A human-readable name (e.g. wrap.near) or a 64-character hex implicit account ID.

Example: wrap.near

public_keystring

Base58-encoded public key prefixed with ed25519: or secp256k1:.

Example: ed25519:168vdqFUxij2yvsxYgAGoykJMX7tgrPKVCH484A8nHP

amountstring

Staked amount (yoctoNEAR, decimal string)

namestring (enum)

Error class. REQUEST_VALIDATION_ERROR (invalid request), HANDLER_ERROR (processing error), INTERNAL_ERROR (node internal error)

causeobject

The specific cause of the error.

namestring

Name of the error cause (e.g. UNKNOWN_BLOCK, UNKNOWN_ACCOUNT, PARSE_ERROR)

infoobject

Additional information about the error (block hash, height, account ID, etc.)

codeinteger

Legacy JSON-RPC error code (e.g. -32000 server error, -32700 parse error, -32601 method not found)

messagestring

Legacy error message

datastring

Legacy error details

X-API-KEY
RequestCU15
cURL
curl -X POST "https://near-mainnet.nodit.io/" \
  -H "X-API-KEY: {YOUR_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": "dontcare",
    "method": "genesis_config"
  }'
Response
Example · 200
{
  "jsonrpc": "2.0",
  "result": {
    "block_producer_kickout_threshold": 90,
    "chain_id": "mainnet",
    "chunk_producer_assignment_changes_limit": 5,
    "chunk_producer_kickout_threshold": 90,
    "chunk_validator_only_kickout_threshold": 80,
    "dynamic_resharding": false,
    "epoch_length": 43200,
    "fishermen_threshold": "340282366920938463463374607431768211455",
    "gas_limit": 1000000000000000,
    "gas_price_adjustment_rate": [
      1,
      100
    ],
    "genesis_height": 9820210,
    "genesis_time": "2020-07-21T16:55:51.591948Z",
    "max_gas_price": "10000000000000000000000",
    "max_inflation_rate": [
      0,
      1
    ],
    "max_kickout_stake_perc": 100,
    "min_gas_price": "1000000000",
    "minimum_stake_divisor": 10,
    "minimum_stake_ratio": [
      1,
      6250
    ],
    "minimum_validators_per_shard": 1,
    "num_block_producer_seats": 100,
    "num_blocks_per_year": 31536000,
    "num_chunk_producer_seats": 100,
    "num_chunk_validator_seats": 300,
    "online_max_threshold": [
      99,
      100
    ],
    "online_min_threshold": [
      90,
      100
    ],
    "protocol_reward_rate": [
      0,
      1
    ],
    "protocol_treasury_account": "treasury.near",
    "protocol_upgrade_stake_threshold": [
      4,
      5
    ],
    "protocol_version": 29,
    "shard_layout": {
      "V2": {
        "boundary_accounts": [],
        "id_to_index_map": {
          "0": 0
        },
        "index_to_id_map": {
          "0": 0
        },
        "shard_ids": [
          0
        ],
        "shards_parent_map": null,
        "shards_split_map": null,
        "version": 0
      }
    },
    "shuffle_shard_assignment_for_chunk_producers": false,
    "target_validator_mandates_per_shard": 68,
    "total_supply": "999999999792372916156395166000000",
    "transaction_validity_period": 86400,
    "use_production_config": false,
    "validators": [
      {
        "account_id": "nfvalidator1.near",
        "amount": "50000000000000000000000000000",
        "public_key": "ed25519:14pWWRutZtGFKX4B8q89KVFaUWY1Cqu1JcqYXhCDeFh1"
      },
      {
        "account_id": "nfvalidator2.near",
        "amount": "50000000000000000000000000000",
        "public_key": "ed25519:BwZk4bkYJxo79P2vSRw2uk1nfiqEfVkHvr5p8eVsqASC"
      },
      {
        "account_id": "nfvalidator3.near",
        "amount": "50000000000000000000000000000",
        "public_key": "ed25519:DMz11tmPvhdqpi7CzP2JULeeSE8SxYRD8pys5nKke4FS"
      },
      {
        "account_id": "nfvalidator4.near",
        "amount": "50000000000000000000000000000",
        "public_key": "ed25519:Fi3CQDHJoviKazVR27YmfFzWcFnvmoPBKEDd9ouq5Tjx"
      }
    ]
  },
  "id": "dontcare"
}

Last updated