Fractal
  • Overview
  • Basics
    • Architecture
  • Key Concepts
    • Fractal Confluence: The EVM Layer
    • The Confluence Bridge
    • Fractal Spring: The UTXO Layer
      • Concepts
      • Technical Specifications
    • Staking
      • Overview
      • EVM Staking
        • UTXO Staking and EVM Staking
      • Consensus
      • Rewards
      • Penalties
  • Developers
    • Acquire Testnet FRA
    • EVM Tools & Tutorials
      • Contract Deployment
        • Ganache
        • Hardhat
        • Remix
        • Truffle
        • Waffle
      • The Graph
    • Developer SDKs
      • UTXO Native Chain SDK
        • Fractal Spring (UTXO Layer) SDK Installation
        • Developer Tools
          • Fractal CLI Tool
        • UTXO API Reference
          • Account
          • Keypair
          • Network
          • Asset
          • Staking
          • Transaction
          • Helpers
      • The Confluence Bridge SDK
    • EVM References
      • Metamask
      • Local Development Network Setup
      • EVM API Reference
      • Precompiled Contracts
  • Network Settings
    • Contract Addresses
    • Network Settings
  • User Guides
    • Fractal Wallet Guides
      • MetaMask
        • Download
        • Configure (Auto)
        • Configure (Manual)
      • Fractal Wallet
        • Download
        • New Wallet
        • Transfer Tokens in the Fractal Wallet
        • The Confluence Bridge
        • Adding Custom Assets to the Fractal Wallet
        • Manage Assets
      • Ledger Hardware Wallet
    • Acquire FRA
    • Explore Testnet
    • Acquire FRA (Testnet)
    • Stake FRA
    • How to Use Block Explorers
    • Bridging Tokens to Fractal
  • Validator Materials
    • Validator Setup Guides
      • System Requirements
      • Acquire a Server
      • Validator Toolbox Setup
        • New Build
        • Existing Build
        • Additional Info
      • Manual Setup
      • Automated Setup (Deprecated)
    • Upgrade Guides
      • Node Upgrade (Toolbox)
      • Node Upgrade (Manual)
      • fn CLI Upgrade (Wallet)
    • Operational Guides
      • Emergency Recovery
      • Data Backup
      • CLI Staking
Powered by GitBook
On this page
  • Funding​
  • Node Operations​
  1. Validator Materials
  2. Operational Guides

CLI Staking

PreviousData Backup

Last updated 1 year ago

Validators must stake a minimum of 10,000 FRA to register as a validator. Before you can stake FRA to your validator, you must first transfer FRA to the Findora Address (i.e. wallet address) of your validator.

Funding

Testnet Funding

You can request Testnet FRA tokens using our Discord Bot. Please to claim your free FRA Native Chain tokens.

While requesting the tokens, you need to specify the Findora Address associated with your validator node. To locate this wallet address, run fn show, and get your fra address as displayed in the screenshot below.

Besides node setup, the fn tool is also used for general validator staking operations such as staking FRA into the validator, setting the commission rate the validator charges, transferring FRA balance on the validator to another wallet address and claiming FRA rewards.

To see the list of all sub-commands under fn use the --help flag as shown below:

fn --help

To get detailed info about a specific sub-command, use the --help flag along with the command.

Example: fn stake --help

fn-stake
  Stake tokens (i.e. bond tokens) from a Findora account to a Validator

USAGE:
  fn stake [FLAGS] [OPTIONS] --amount <Amount>

FLAGS:
    -a, --append     stake more FRAs to your node
        --force      ignore warning and stake FRAs to your target node
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
    -n, --amount <Amount>                      how much `FRA unit`s you want to stake
    -R, --commission-rate <Rate>               the commission rate of your node, a float number from 0.0 to 1.0
    -S, --staker-priv-key <SecretKey>          the file which contains private key (in base64 format) of proposer
    -M, --validator-memo <Memo>                the description of your node, optional
    -A, --validator-td-addr <TendermintAddr>   stake FRAs to a custom validator

Other Examples: > fn unstake --help > fn claim --help > fn transfer --help

After receiving FRA to your validator's Findora Address, you must stake a minimum of 10,000 FRA to become a validator. Only the top 100 validators (with the most FRA staked) will earn FRA rewards.

Tip: Before staking, wait for 100% data synchronization of your validator node, otherwise you may be charged a 'validator node offline' penatly fee.

# - Your Staker Memo file should like this:
cat staker_memo

{
  "name": "ExampleNode",
  "desc": "I am just a example description, please change me.",
  "website": "https://www.example.com",
  "logo": "https://www.example.com/logo"
}
# ex)
# - To stake 999,999 FRAs with a commision rate of 2% (and validator name of Validator_Pool_A)
# - Note: that is 999999 * 1000000 FRA units
fn stake -n $((999999 * 1000000)) -R 0.02 -M "$(cat staker_memo)"
# Stake an additional 2,000 FRA to your validator
fn stake -a -n $((2000 * 1000000))

To find information about your validator node, use the fn show command. Sample output is below:

Top 100 validators will earn block rewards. If your validator is a top 100 validator, it will earn rewards which will show up in the rewards section on fn show.

If your reward balance is greater than 0, you can claim your earned rewards via the fn claim sub-command

# fn claim -n <the amount of FRA units you want>
# ex)
#   If you have a reward balance of 20 FRA (i.e. "rewards: 20000000")
#   and wish to claim 10 FRA (out of 20 FRA), issue the command below:
fn claim -n $((10 * 1000000))
# fn unstake -n <the amount of FRA units you want>
# ex)
#   To unstake 900 FRA (ie. 900 * 1000000)
fn unstake -n $((900 * 1000000))

NOTE: This operation will unstake all of your FRA and remove your node from the Findora Network.

fn unstake

Mainnet Funding

Transfer FRA from an existing Findora wallet to your Findora Address. If you don’t have FRA tokens, you can buy them from any exchange listed on .

Node Operations

fn CLI tool

Stake Initial FRA and Set Commission Rate

Stake Additional FRA

View Node Information

Claim FRA Rewards

Unstake FRA

Unstake Some of Your FRA

Close Validator and Unstake All of Your FRA

​
this page
​
​
​
​
​
​
​
​
​
​
​
follow this guide