♾️
OneFinity Docs
πŸŽ“ LearnπŸ›  BuildπŸ’Ύ Testnet πŸ‘” ProtocolπŸ”„ Bridge
  • Welcome to OneFinity
  • OneFinity
    • What is OneFinity
    • OneFinity approach
    • What is a Sovereign Shard?
  • Technology
    • Basic concepts
      • Nodes and Wallets
      • Epoch and Rounds
      • Secure Proof of Stake
      • Glossary
    • Sovereign Shard
    • WASM Virtual Machine
    • Ethereum Virtual Machine (EVM)
    • ESDT vs ERC-20
    • Run a OneFinity node
      • System Requirements
      • Configuration
      • Installation
      • Updates
      • Management
      • Nodes
        • Rating
        • Redundancy Setup
        • Configuration files
        • Operation modes
        • Node Databases
        • Import Database
        • Node CLI
      • Staking
      • Unstaking
      • Jail/Unjail
      • Staking Smart Contract
      • Keys
        • Validator Keys
        • Wallet Keys
        • Multikey nodes
  • Validators
    • Overview
    • Git repo
    • Binaries
    • Go
    • General setup
    • How to generate a Validator pem
    • Node start
    • Interact with the blockchain
    • Unjail
  • OneFinity Protocol
    • Overview
    • Governance
    • Protocol Rewards
      • Validators
      • Delegators
      • Staking Agencies
    • ONE Token
    • OG Validators: NFT Staking
  • Technical documentation
    • Overview
    • Integration of the Ethereum Virtual Machine (EVM)
    • Integration of the Ethereum Remote Procedure Call (RPC)
    • Interoperability between Ethereum and MultiversX ecosystems
    • Tools and SDKs for developers
    • Environments
  • Bridges
  • Ecosystem
  • Grants
  • FAQs
  • Social Media
  • Roadmap & Tokenomics
  • Team
Powered by GitBook
On this page
  1. Technology
  2. Run a OneFinity node
  3. Nodes

Operation modes

PreviousConfiguration filesNextNode Databases

Last updated 1 year ago

Introduction

Starting with the v1.x.y release, a new CLI flag has been introduced to the node: --operation-mode. Its purpose is to override certain configuration values, enabling the node to operate differently based on the use case. Without any configuration changes, nodes will start with the default settings. However, there are several ways to configure the node to suit the desired operation mode. Instead of manually editing the toml files (or doing so programmatically via sed, for example), you can use the --operation-mode CLI flag to specify a custom operation mode. This results in configuration changes tailored to your needs.

Available Operation Modes

Full archive

Enabling full-archive mode reconfigures the node to sync from the beginning and handle historical queries. However, be prepared for a longer sync time due to limited full archive peers available.

./node --operation-mode full-archive

Db Lookup Extension

The hyperblock endpoint and others like /network/esdt/supply/:tokenID or /transaction/:txhash?withResults=true depend on the db-lookup-extension mode. This mode adjusts the node's setup to enhance databases, enabling them to store additional data such as logs and block-epoch links, which supports more complex Rest API queries.

./node --operation-mode db-lookup-extension

Historical balances

Enabling the historical-balances mode alters the node configuration to support historical balance queries by preventing trie pruning. This increases disk usage but enables querying past block balances or nonces of addresses.

./node --operation-mode historical-balances

Snapshotless-Observer Mode

This mode streamlines the node for real-time requests like live balance updates or transaction broadcasts. It deactivates trie snapshotting and ensures obsolete data is purged, enhancing efficiency by avoiding resource-intensive operations.

./node --operation-mode snapshotless-observer
​
​
​