Перейти к основному содержимому

Конфигурация клиента

client_config — тип запроса.

Этот эндпоинт позволяет получить конфигурацию клиента узла NEAR.

Сеть
API-ключ FastNearНет сохранённого ключа
Получить API-ключ
Эндпоинтhttps://rpc.mainnet.fastnear.com
Авторизацияне обнаружена
Живой ответ

Ответы от выбранного эндпоинта появляются здесь после запуска запроса.

Здесь появится вывод живого ответа после запуска запроса.

Справка по запросу

application/json

Эта операция принимает JSON-RPC тело через POST на /.

Обязательные входные данные запроса: да

{
  "jsonrpc": "2.0",
  "id": "fastnear",
  "method": "client_config",
  "params": []
}

Схема запроса

object
требует jsonrpc, id, method, params
jsonrpc *string
2.0
id *string

Пример: fastnear

method *string
client_config
params *array

Empty array as this method takes no parameters

Пример:

Справка по ответу

200 application/json

Успешный ответ

Схема ответа

objectJsonRpcResponse
требует jsonrpc, id
jsonrpc *string
2.0
id *один из
stringnumber
resultobject

ClientConfig where some fields can be updated at runtime.

archiveboolean

Not clear old data, set true for archive nodes.

block_fetch_horizoninteger

Горизонт, после которого вместо получения блока извлекается полное состояние.

block_header_fetch_horizoninteger

Behind this horizon header fetch kicks in.

block_production_tracking_delayarray

Интервал проверки необходимости выпустить или пропустить блок.

itemsinteger
catchup_step_periodarray

Time between check to perform catchup.

itemsinteger
chain_idstring

ID цепочки для статуса.

chunk_distribution_networkobjectможет быть пустым

Конфигурация функции Chunk Distribution Network. Она позволяет узлам отправлять и получать чанки через центральный поток. Преимущества такого подхода: (1) меньше трафика запросов и ответов в одноранговой сети и (2) меньшая задержка для RPC-узлов, индексирующих цепочку.

enabledboolean
urisobject

URI для функции Chunk Distribution Network.

chunk_request_retry_periodarray

Время между проверками на повторный запрос чанков.

itemsinteger
chunk_validation_threadsinteger

Number of threads for ChunkValidationActor pool.

chunk_wait_multarray

Multiplier for the wait time for all chunks to be received.

itemsinteger
chunks_cache_height_horizoninteger

Height horizon for the chunk cache. A chunk is removed from the cache if its height + chunks_cache_height_horizon < largest_seen_height. The default value is DEFAULT_CHUNKS_CACHE_HEIGHT_HORIZON.

client_background_migration_threadsinteger

Количество потоков, выполняющих фоновые миграционные работы в клиенте.

cloud_archival_writerobjectможет быть пустым

Конфигурация облачного компонента записи архивных данных. Если эта конфигурация задана, компонент включается и записывает данные, связанные с чанками, на основе отслеживаемых шардов. Эта конфигурация также управляет дополнительным архивным поведением, например записью данных блоков и интервалом опроса.

archive_block_databoolean

Определяет, должны ли данные, связанные с блоками, записываться в облачное хранилище.

Значение по умолчанию: false

polling_intervalobject

Интервал, с которым система проверяет новые блоки или чанки для архивации.

Значение по умолчанию: [object Object]

disable_tx_routingboolean

Если значение true, узел не будет пересылать транзакции следующим производителям чанков.

doomslug_step_periodarray

Time between running doomslug timer.

itemsinteger
enable_early_prepare_transactionsboolean

Если значение true, транзакции для следующего чанка будут подготавливаться заранее, сразу после того, как будет готово post-state предыдущего чанка. Это помогает быстрее выпускать чанки в сетях с высокой пропускной способностью. Текущая реализация увеличивает задержку в сетях с низкой нагрузкой; это будет исправлено позже. По умолчанию параметр отключён.

enable_multiline_loggingboolean
enable_statistics_exportboolean

Re-export storage layer statistics as prometheus metrics.

epoch_lengthinteger

Epoch length.

epoch_syncobject

Options for epoch sync.

epoch_sync_horizon_num_epochsinteger

Количество эпох от головы сети, за пределами которого узел переключится с header-синхронизации на epoch-синхронизацию. На стороне потребителя это значение умножается на epoch_length, чтобы получить горизонт в блоках.

Значение по умолчанию: 2

timeout_for_epoch_syncobject

Timeout for epoch sync requests. The node will continue retrying indefinitely even if this timeout is exceeded.

expected_shutdownstring

Корректное завершение работы на ожидаемой высоте блока.

gcobject

Configuration for garbage collection.

gc_blocks_limitinteger

Максимальное количество блоков, собираемых сборщиком мусора за один вызов.

Значение по умолчанию: 2

gc_fork_clean_stepinteger

Maximum number of height to go through at each garbage collection step when cleaning forks during garbage collection.

Значение по умолчанию: 100

gc_num_epochs_to_keepinteger

Number of epochs for which we keep store data.

Значение по умолчанию: 5

gc_step_periodobject

How often gc should be run

Значение по умолчанию: [object Object]

header_sync_expected_height_per_secondinteger

Expected increase of header head height per second during header sync

header_sync_initial_timeoutarray

How much time to wait after initial header sync

itemsinteger
header_sync_progress_timeoutarray

How much time to wait after some progress is made in header sync

itemsinteger
header_sync_stall_ban_timeoutarray

How much time to wait before banning a peer in header sync if sync is too slow

itemsinteger
log_summary_periodarray

Period between logging summary information.

itemsinteger
log_summary_stylestring

Enable coloring of the logs

plaincolored
max_block_production_delayarray

Максимальное время ожидания подтверждений перед выпуском блока.

itemsinteger
max_block_wait_delayarray

Maximum duration before skipping given height.

itemsinteger
max_gas_burnt_viewstringможет быть пустым

Количество газа

min_block_production_delayarray

Минимальная длительность перед выпуском блока.

itemsinteger
min_num_peersinteger

Minimum number of peers to start syncing.

num_block_producer_seatsinteger

Количество мест для производителей блоков

orphan_state_witness_max_sizeinteger

Максимальный размер state witness в OrphanStateWitnessPool. В пуле сохраняются только orphan-witness, размер которых меньше этого значения. Это ограничивает максимальное потребление памяти пулом OrphanStateWitnessPool.

orphan_state_witness_pool_sizeinteger

OrphanStateWitnessPool хранит экземпляры ChunkStateWitness, которые нельзя обработать, потому что предыдущий блок недоступен. Эти witness остаются в пуле, пока не появится нужный блок. Эта переменная определяет, сколько witness можно хранить в пуле.

produce_chunk_add_transactions_time_limitstring

Ограничивает время добавления транзакций в чанк. Нода формирует чанк, добавляя транзакции из пула транзакций, пока не будет достигнут один из лимитов. Этот лимит по времени гарантирует, что добавление транзакций не займёт дольше указанной длительности и поможет быстрее выпустить чанк.

produce_empty_blocksboolean

Выпускать пустые блоки; значение false используется для тестирования.

protocol_version_checkstring

Определяет, проверяет ли узел совместимость версии сети для следующей или через одну эпохи.

NextNextNext
resharding_configstring
rpc_addrstringможет быть пустым

Порт RPC для статуса, на котором слушает узел.

save_invalid_witnessesboolean

Save observed instances of invalid ChunkStateWitness to the database in DBCol::InvalidChunkStateWitnesses. Saving invalid witnesses is useful for analysis and debugging. This option can cause extra load on the database and is not recommended for production use.

save_latest_witnessesboolean

Сохраняет наблюдаемые экземпляры ChunkStateWitness в базу данных DBCol::LatestChunkStateWitnesses. Сохранение последних экземпляров ChunkStateWitness полезно для анализа и отладки. Эта опция может создавать дополнительную нагрузку на базу данных и не рекомендуется для продового контура.

save_state_changesboolean

Нужно ли сохранять изменения состояния на диск.

save_trie_changesboolean

save_trie_changes should be set to true iff - archive if false - non-archival nodes need trie changes to perform garbage collection - archive is true, cold_store is configured and migration to split_storage is finished - node working in split storage mode needs trie changes in order to do garbage collection on hot.

save_tx_outcomesboolean

Нужно ли сохранять результаты транзакций на диск.

save_untracked_partial_chunks_partsboolean

Whether to persist partial chunk parts for untracked shards or not.

skip_sync_waitboolean

Skip waiting for sync (for testing or single node testnet).

state_request_server_threadsinteger

Number of threads for StateRequestActor pool.

state_request_throttle_periodarray

Количество секунд между запросами состояния для view-клиента. Окно троттлинга для запросов состояния (заголовки и части).

itemsinteger
state_requests_per_throttle_periodinteger

Максимальное количество запросов состояния, обслуживаемых за период троттлинга

state_syncobject

Параметры синхронизации состояния.

concurrencyobject
dumpobjectможет быть пустым

Настраивает способ выгрузки состояния во внешнее хранилище.

parts_compression_lvlinteger

Уровень сжатия Zstd для частей состояния.

Значение по умолчанию: 1

syncstringможет быть пустым

Синхронизирует состояние от пиров, не читая ничего из внешнего хранилища.

Peers
state_sync_enabledboolean

Использовать ли механизм State Sync. Если отключён, узел будет выполнять Block Sync вместо State Sync.

state_sync_external_backoffarray

Дополнительное время ожидания после неудачного запроса к внешнему хранилищу

itemsinteger
state_sync_external_timeoutarray

Как долго ждать ответа от централизованной синхронизации состояния

itemsinteger
state_sync_p2p_timeoutarray

Как долго ждать ответа от p2p-синхронизации состояния

itemsinteger
state_sync_retry_backoffarray

Как долго ждать после неудачного запроса синхронизации состояния

itemsinteger
sync_check_periodarray

How often to check that we are not out of sync.

itemsinteger
sync_height_thresholdinteger

Sync height threshold: below this difference in height don't start syncing.

sync_max_block_requestsinteger

Максимальное количество запросов блоков, отправляемых пирам для синхронизации

sync_step_periodarray

While syncing, how long to check for each step.

itemsinteger
tracked_shards_configobject

One of multiple possible types

transaction_pool_size_limitintegerможет быть пустым

Ограничение размера пула транзакций одного шарда в байтах. Если не задано, размер не ограничен.

transaction_request_handler_threadsinteger
trie_viewer_state_size_limitintegerможет быть пустым

Верхняя граница размера состояния контракта в байтах, при котором оно ещё доступно для просмотра. None — без ограничения

ttl_account_id_routerarray

Time to persist Accounts Id in the router without removing them.

itemsinteger
tx_routing_height_horizoninteger

Если узел не является производителем чанков в пределах этого числа блоков, маршрутизировать запросы к будущим производителям чанков.

versionobject
требует version, build, commit

Data structure for semver version and github tag or commit.

build *string
commit *string
rustc_versionstring

Значение по умолчанию:

version *string
view_client_threadsinteger

Количество потоков для пула ViewClientActor.

dynamic_resharding_dry_runboolean

Если значение true, рантайм выполнит пробный динамический ресхардинг на последнем блоке каждой эпохи. Это означает вычисление предварительных граничных аккаунтов для разделения отслеживаемых шардов.

errorobject
кодinteger
messagestring
dataobject