jito-foundation/jito-tip-router v1.1.0-operator

Operator Client V1.1.0

on GitHub

Change notes

• FIX: Updates Validator Claimant to be Vote Account instead of Identity Account. Fix is activated epoch 757.
• New top-level environment variable/CLI arg
  • SAVE_PATH: renaming of META_MERKLE_TREE_DIR. Path where all generated operator files are stored. META_MERKLE_TREE_DIR is now aliased to SAVE_PATH.
• Separates each stage of the process into more coherent functions.
  • run CLI command loops through each stage, saving the outputs to save-path CLI argument. The output from each stage is held in memory to reduce the processing.
    • New Environment Variables/CLI Args for run
      • STARTING_STAGE: Ability to start the operator from a specific stage before it continues
        • one of: load-bank-from-snapshot, create-stake-meta, create-merkle-tree-collection, create-meta-merkle-tree, cast-vote, wait-for-next-epoch (default)
      • SAVE_STAGES: true/false - whether to save the state of intermediate stages in files. Needed for CLAIM_TIPS and SET_MERKLE_ROOT
      • SAVE_SNAPSHOTS: true/false - whether to save the bank loaded in the target as a full snapshot (~100GB).
• Create CLI commands for each stage
  • snapshot-slot - Create and store a full snapshot for a given slot
  • create-stake-meta - For a given epoch and slot, load the bank and create the StakeMetaCollection file which contains validator vote accounts and their staking delegations.
  • create-merkle-tree-collection - For a given epoch, load the StakeMetaCollection from disk at save-path, generate and save the GeneratedMerkleTreeCollection.
  • create-meta-merkle-tree - For a given epoch, load the GeneratedMerkleTreeCollection from disk at save-path, generate and save theMetaMerkleTree.
  • submit-epoch - For a given epoch, load the MetaMerkleTree file and cast a vote to the NCN's ballot box. Optionally set the merkle root on the Tip Distribution account if the NCN has consensus for the epoch.
  • claim-tips - For a given epoch, generate and execute Tip Distribution Claim instructions for any unclaimed tips.
• TipRouter saved files
  • generated files are now saved under save-path
  • Files <= current_epoch - num_monitored_epochsare purged for anything
  • NOTE: file names have change to a {epoch}_file_name.json format. All previous files will not be removed. Operators should manually delete old files.
• FIX: Patches stored ClaimStatus addresses to be correct claimant.