DEV Community: Mandy

Deep Dive: Understanding CrossFi’s Governance Parameters

Mandy — Mon, 03 Mar 2025 10:41:41 +0000

Introduction

CrossFi’s governance system allows token holders to propose and vote on changes to the network, ensuring decentralization and community-driven decision-making. However, to participate effectively, it’s crucial to understand how governance proposals work and what parameters influence their outcomes.

In this guide, we will explore:
✅ How governance works in CrossFi

✅ Key governance parameters and their impact

✅ Querying governance settings using the CLI

✅ Real-world examples of governance decisions

Let’s dive in! 🚀

1. How Governance Works in CrossFi

CrossFi follows an on-chain governance model, allowing token holders to vote on:

Protocol upgrades (e.g., software updates)
Economic policies (e.g., inflation rates, staking rewards)
Community fund spending (e.g., funding ecosystem development)

Governance proposals follow these stages:
1️⃣ Proposal Submission: A user submits a proposal with a required deposit.

2️⃣ Deposit Period: If the minimum deposit is met, the proposal enters the voting period.

3️⃣ Voting Period: Token holders vote using yes, no, no_with_veto, or abstain.

4️⃣ Tallying & Execution: If the proposal meets the required votes, it is enacted.

2. Key Governance Parameters

CrossFi’s governance system has several parameters that define how proposals are handled.

Deposit Parameters

🔹 Minimum Deposit (min_deposit)

The amount of XFI required for a proposal to enter the voting period. If the deposit isn’t met, the proposal is rejected.

🔹 Max Deposit Period (max_deposit_period)

The time limit for meeting the deposit threshold. If the deposit isn’t completed within this period, the proposal fails.

📌 Query deposit parameters:

./bin/crossfid query gov params deposit --home ./testnet

Example Output:

{
  "min_deposit": "100000000mpx",
  "max_deposit_period": "172800s"
}

Voting Parameters

🔹 Voting Period (voting_period)

The duration (in seconds) during which token holders can vote on a proposal.

🔹 Threshold (threshold)

The percentage of yes votes required for a proposal to pass.

🔹 Veto Threshold (veto_threshold)

If a proposal gets this percentage of no_with_veto votes, it is rejected.

📌 Query voting parameters:

./bin/crossfid query gov params voting --home ./testnet

Example Output:

{
  "voting_period": "604800s",
  "threshold": "0.50",
  "veto_threshold": "0.334"
}

3. Real-World Examples of Governance Decisions

Understanding how governance parameters work helps users make informed decisions. Let’s look at three real-world scenarios:

Scenario 1: Proposal Fails Due to Low Deposit

📌 Proposal: A developer submits a proposal to increase the validator set but only deposits 50,000,000mpx, while the minimum deposit is 100,000,000mpx. The proposal gets rejected.

🔍 How to check proposal status:

./bin/crossfid query gov proposal <proposal-id> --home ./testnet

Scenario 2: Proposal Passes with Enough Yes Votes

📌 Proposal: A proposal to increase staking rewards receives 60% yes votes, passing successfully as it meets the 50% threshold.

🔍 How to check voting results:

./bin/crossfid query gov tally <proposal-id> --home ./testnet

Scenario 3: Proposal Rejected by Veto

📌 Proposal: A proposal suggests a drastic reduction in staking rewards. More than 33.4% vote no_with_veto, rejecting the proposal.

🔍 How to check vetoed proposals:

./bin/crossfid query gov proposals --home ./testnet | grep veto

4. How to Change Governance Parameters

Governance parameters can be adjusted through proposals. If the community wants to lower the deposit requirement, for example, they can submit a parameter change proposal.

Submitting a Parameter Change Proposal

📌 Step 1: Create a proposal JSON file (e.g., change-threshold.json)

{
  "title": "Lower Voting Threshold to 45%",
  "description": "This proposal lowers the voting threshold from 50% to 45% to encourage participation.",
  "changes": [
    {
      "subspace": "gov",
      "key": "threshold",
      "value": "0.45"
    }
  ],
  "deposit": "100000000mpx"
}

📌 Step 2: Submit the proposal

./bin/crossfid tx gov submit-proposal param-change change-threshold.json --from <your-wallet-name> --chain-id crossfi-1 --home ./testnet --gas auto

📌 Step 3: Track proposal status

./bin/crossfid query gov proposals --home ./testnet

5. Conclusion

🎉 You’ve successfully learned about CrossFi governance parameters and how they impact decision-making!

Key Takeaways:

✅ Deposit parameters ensure proposals meet a minimum threshold before voting.

✅ Voting parameters define how many votes are needed for a proposal to pass.

✅ Veto power allows the community to block harmful proposals.

✅ Governance parameters can be changed through proposals.

Understanding these parameters helps you make informed governance decisions and contribute effectively to the CrossFi ecosystem. 🚀

For more details, refer to the official CrossFi GitHub repository.

Setting Up a Full Node on CrossFi: A Beginner-Friendly Guide

Mandy — Sun, 02 Mar 2025 09:35:07 +0000

Introduction

Running a full node on the CrossFi blockchain allows you to participate in network validation, verify transactions, and contribute to decentralization. Whether you’re a developer, validator, or blockchain enthusiast, setting up a node is a great way to interact with the CrossFi ecosystem.

This guide will walk you through every step of setting up a CrossFi full node, from installation to synchronization.

By the end of this tutorial, you’ll learn how to:

✅ Install and configure a CrossFi full node

✅ Connect to the CrossFi network and sync with the blockchain

✅ Monitor your node’s status and logs

✅ Troubleshoot common setup issues

Let’s get started! 🚀

1. Prerequisites

Before installing the CrossFi node software, ensure you have:

🖥️ System Requirements:

CPU: 4+ cores
RAM: 8GB minimum (16GB recommended)
Storage: 500GB+ SSD
OS: Ubuntu 20.04+ (or any Linux distribution with systemd)
Internet: A stable high-speed connection

📝 Installed dependencies:
Run the following command to update your system and install required tools:

sudo apt update && sudo apt upgrade -y
sudo apt install build-essential git curl jq -y

2. Installing the CrossFi Node Software

The official CrossFi node software (crossfid) is available on GitHub. Let’s install it step by step.

Step 1: Download and Install CrossFi Node Software

1️⃣ Download the prebuilt binary from the official CrossFi GitHub releases:

wget https://github.com/crossfichain/crossfi-node/releases/download/v0.3.0-prebuild3/crossfi-node_0.3.0-prebuild3_linux_amd64.tar.gz

2️⃣ Extract the downloaded file:

tar -xf crossfi-node_0.3.0-prebuild3_linux_amd64.tar.gz

3️⃣ Clone the CrossFi testnet repository:

git clone https://github.com/crossfichain/testnet.git

4️⃣ Start the node using the extracted binary:

./bin/crossfid start --home ./testnet

To check if the installation was successful, run:

./bin/crossfid version

If the installation was successful, you should see output similar to:

v0.3.0-prebuild3

3. Initializing Your CrossFi Node

Now that crossfid is installed, it’s time to initialize your node.

🔹 Run the following command to initialize your node:

./bin/crossfid init my-node --chain-id crossfi-1 --home ./testnet

This command:

Creates necessary configuration files inside ./testnet
Prepares your node to connect to the CrossFi blockchain
Assigns a unique identifier (my-node) to your node (you can change this name)

4. Configuring the Node

To connect your node to the CrossFi network, you must configure its settings.

Step 1: Connect to Peers

🔹 Open the configuration file:

nano ./testnet/config/config.toml

🔹 Locate the seeds and persistent_peers sections and add official peer addresses (check the CrossFi documentation for the latest peer list).

Example:

seeds = "<seed-node-address>"
persistent_peers = "<peer-node-address>"

Save the file (CTRL + X, then Y, and ENTER).

Step 2: Configure Minimum Gas Prices

To set minimum gas prices, edit the app.toml file:

nano ./testnet/config/app.toml

Find the minimum-gas-prices setting and update it:

minimum-gas-prices = "0.0025mpx"

Save and exit.

5. Running and Syncing Your Node

Now it’s time to start your node and sync it with the blockchain.

🔹 Run the following command:

./bin/crossfid start --home ./testnet

Your node will begin downloading blockchain data. This process may take several hours, depending on your system’s performance and internet speed.

To check if your node is syncing, run:

./bin/crossfid status --home ./testnet | jq .sync_info

Example output:

{
  "latest_block_height": "563902",
  "catching_up": true
}

🔹 When catching_up becomes false, your node is fully synced!

6. Monitoring Your Node

To ensure your node is running smoothly, use the following commands:

Check Logs in Real-Time

tail -f ./testnet/logs/crossfid.log

Check Sync Status

./bin/crossfid status --home ./testnet | jq .sync_info

Check Node ID

./bin/crossfid tendermint show-node-id --home ./testnet

7. Troubleshooting Common Issues

If you encounter problems, here are some common solutions:

1. Node Won’t Start

Check the logs for errors:

tail -f ./testnet/logs/crossfid.log

2. Node is Stuck Syncing

Try resetting your node and restarting:

./bin/crossfid unsafe-reset-all --home ./testnet
./bin/crossfid start --home ./testnet

3. Validator Got Jailed?

If you are running a validator and it gets jailed, unjail it with:

./bin/crossfid tx slashing unjail --from <your-wallet-name> --chain-id crossfi-1 --home ./testnet --gas=auto

8. Conclusion

🎉 Congratulations! You’ve successfully set up a full node on the CrossFi blockchain.