{ "openapi": "3.1.0", "info": { "title": "NEAR Protocol RPC: Get genesis config", "description": "Fetch the chain's immutable genesis config — initial records, protocol settings, and epoch length at block 0.", "version": "1.0.0" }, "servers": [ { "url": "https://rpc.mainnet.fastnear.com", "description": "Mainnet" }, { "url": "https://rpc.testnet.fastnear.com", "description": "Testnet" }, { "url": "https://archival-rpc.mainnet.fastnear.com", "description": "Mainnet Archival" }, { "url": "https://archival-rpc.testnet.fastnear.com", "description": "Testnet Archival" } ], "paths": { "/": { "post": { "operationId": "genesis_config", "summary": "Get genesis config", "description": "Fetch the chain's immutable genesis config — initial records, protocol settings, and epoch length at block 0.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "jsonrpc", "id", "method", "params" ], "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "id": { "type": "string", "example": "fastnear" }, "method": { "type": "string", "enum": [ "genesis_config" ] }, "params": { "type": "array", "maxItems": 0, "description": "Empty array as this method takes no parameters", "example": [] } } }, "examples": { "mainnet": { "summary": "Get genesis config (Mainnet)", "value": { "jsonrpc": "2.0", "id": "fastnear", "method": "genesis_config", "params": [] } }, "testnet": { "summary": "Get genesis config (Testnet)", "value": { "jsonrpc": "2.0", "id": "fastnear", "method": "genesis_config", "params": [] } } } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JsonRpcResponse" } } } }, "403": { "description": "The supplied API key was not recognized.", "content": { "text/plain": { "schema": { "type": "string" }, "example": "Invalid API key" } } } } } } }, "security": [ {}, { "BearerAuth": [] }, { "ApiKeyAuth": [] } ], "components": { "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "FastNEAR API key as an `Authorization: Bearer` header. Preferred for backends, workers, and proxies because it keeps the key out of URLs and logs." }, "ApiKeyAuth": { "type": "apiKey", "in": "query", "name": "apiKey", "description": "FastNEAR API key as the `apiKey` query parameter. Handy for curl or clients that cannot set headers, but the key can end up in URLs, logs, and shell history." } }, "schemas": { "JsonRpcResponse": { "type": "object", "required": [ "jsonrpc", "id" ], "properties": { "jsonrpc": { "type": "string", "enum": [ "2.0" ] }, "id": { "oneOf": [ { "type": "string" }, { "type": "number" } ] }, "result": { "type": "object", "properties": { "block_producer_kickout_threshold": { "type": "integer", "description": "Threshold for kicking out block producers, between 0 and 100.", "format": "uint8", "minimum": 0 }, "chain_id": { "type": "string", "description": "ID of the blockchain. This must be unique for every blockchain.\nIf your testnet blockchains do not have unique chain IDs, you will have a bad time." }, "chunk_producer_assignment_changes_limit": { "type": "integer", "description": "Limits the number of shard changes in chunk producer assignments,\nif algorithm is able to choose assignment with better balance of\nnumber of chunk producers for shards.", "format": "uint64", "default": 5, "minimum": 0 }, "chunk_producer_kickout_threshold": { "type": "integer", "description": "Threshold for kicking out chunk producers, between 0 and 100.", "format": "uint8", "minimum": 0 }, "chunk_validator_only_kickout_threshold": { "type": "integer", "description": "Threshold for kicking out nodes which are only chunk validators, between 0 and 100.", "format": "uint8", "default": 80, "minimum": 0 }, "dynamic_resharding": { "type": "boolean", "description": "Enable dynamic re-sharding." }, "epoch_length": { "type": "integer", "description": "Epoch length counted in block heights.", "format": "uint64", "minimum": 0 }, "fishermen_threshold": { "type": "string", "description": "Amount in yoctoNEAR" }, "gas_limit": { "type": "string", "description": "Gas amount" }, "gas_price_adjustment_rate": { "type": "array", "items": { "type": "integer", "format": "int32" }, "description": "Gas price adjustment rate" }, "genesis_height": { "type": "integer", "description": "Height of genesis block.", "format": "uint64", "minimum": 0 }, "genesis_time": { "type": "string", "description": "Official time of blockchain start.", "format": "date-time" }, "max_gas_price": { "type": "string", "description": "Amount in yoctoNEAR" }, "max_inflation_rate": { "type": "array", "items": { "type": "integer", "format": "int32" }, "description": "Maximum inflation on the total supply every epoch." }, "max_kickout_stake_perc": { "type": "integer", "description": "Max stake percentage of the validators we will kick out.", "format": "uint8", "default": 100, "minimum": 0 }, "min_gas_price": { "type": "string", "description": "Amount in yoctoNEAR" }, "minimum_stake_divisor": { "type": "integer", "description": "The minimum stake required for staking is last seat price divided by this number.", "format": "uint64", "default": 10, "minimum": 0 }, "minimum_stake_ratio": { "type": "array", "items": { "type": "integer", "format": "int32" }, "description": "The lowest ratio s/s_total any block producer can have.\nSee for details" }, "minimum_validators_per_shard": { "type": "integer", "description": "The minimum number of validators each shard must have", "format": "uint64", "default": 1, "minimum": 0 }, "num_block_producer_seats": { "type": "integer", "description": "Number of block producer seats at genesis.", "format": "uint64", "minimum": 0 }, "num_blocks_per_year": { "type": "integer", "description": "Expected number of blocks per year", "format": "uint64", "minimum": 0 }, "num_chunk_producer_seats": { "type": "integer", "description": "Number of chunk producers.\nDon't mess it up with chunk-only producers feature which is deprecated.", "format": "uint64", "default": 100, "minimum": 0 }, "num_chunk_validator_seats": { "type": "integer", "format": "uint64", "default": 300, "minimum": 0 }, "online_max_threshold": { "type": "array", "items": { "type": "integer", "format": "int32" }, "description": "Online maximum threshold above which validator gets full reward." }, "online_min_threshold": { "type": "array", "items": { "type": "integer", "format": "int32" }, "description": "Online minimum threshold below which validator doesn't receive reward." }, "protocol_reward_rate": { "type": "array", "items": { "type": "integer", "format": "int32" }, "description": "Protocol treasury rate" }, "protocol_treasury_account": { "type": "string", "description": "NEAR account ID" }, "protocol_upgrade_stake_threshold": { "type": "array", "items": { "type": "integer", "format": "int32" }, "description": "Threshold of stake that needs to indicate that they ready for upgrade." }, "protocol_version": { "type": "integer", "description": "Protocol version that this genesis works with.", "format": "uint32", "minimum": 0 }, "shard_layout": { "type": "object", "description": "One of multiple possible types", "default": { "V2": { "boundary_accounts": [], "id_to_index_map": { "0": 0 }, "index_to_id_map": { "0": 0 }, "shard_ids": [ 0 ], "version": 0 } } }, "shuffle_shard_assignment_for_chunk_producers": { "type": "boolean", "description": "If true, shuffle the chunk producers across shards. In other words, if\nthe shard assignments were `[S_0, S_1, S_2, S_3]` where `S_i` represents\nthe set of chunk producers for shard `i`, if this flag were true, the\nshard assignments might become, for example, `[S_2, S_0, S_3, S_1]`.", "default": false }, "target_validator_mandates_per_shard": { "type": "integer", "description": "Number of target chunk validator mandates for each shard.", "format": "uint64", "default": 68, "minimum": 0 }, "total_supply": { "type": "string", "description": "Amount in yoctoNEAR" }, "transaction_validity_period": { "type": "integer", "description": "Number of blocks for which a given transaction is valid", "format": "uint64", "minimum": 0 }, "use_production_config": { "type": "boolean", "description": "This is only for test purposes. We hard code some configs for mainnet and testnet\nin AllEpochConfig, and we want to have a way to test that code path. This flag is for that.\nIf set to true, the node will use the same config override path as mainnet and testnet.", "default": false }, "validators": { "type": "array", "items": { "type": "object", "description": "Account info for validators" }, "description": "List of initial validators." }, "avg_hidden_validator_seats_per_shard": { "type": "array", "items": { "type": "integer", "format": "uint64", "minimum": 0 }, "description": "Expected number of hidden validators per shard." }, "num_block_producer_seats_per_shard": { "type": "array", "items": { "type": "integer", "format": "uint64", "minimum": 0 }, "description": "Defines number of shards and number of block producer seats per each shard at genesis.\nNote: not used with protocol_feature_chunk_only_producers -- replaced by minimum_validators_per_shard\nNote: not used before as all block producers produce chunks for all shards" }, "num_chunk_only_producer_seats": { "type": "integer", "description": "Deprecated.", "format": "uint64", "default": 300, "minimum": 0 } }, "required": [ "protocol_version", "genesis_time", "chain_id", "genesis_height", "num_block_producer_seats", "dynamic_resharding", "epoch_length", "gas_limit", "min_gas_price", "max_gas_price", "block_producer_kickout_threshold", "chunk_producer_kickout_threshold", "gas_price_adjustment_rate", "validators", "transaction_validity_period", "protocol_reward_rate", "max_inflation_rate", "total_supply", "num_blocks_per_year", "protocol_treasury_account", "fishermen_threshold" ] }, "error": { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" }, "data": { "type": "object" } } } } } } } }