Receive Rewards
Introduction
This guide provides step-by-step instructions for INTMAX Block Builders to claim their earned rewards. As a Block Builder participant in the INTMAX network, you can receive two types of rewards: user fees collected from transactions processed in your blocks, and ITX tokens distributed through the reward program.
This document covers the complete process from initial setup to reward claiming, including how to:
- Set up the command-line tools and environment
- Generate INTMAX keys from your Ethereum private key
- Check your accumulated balances and withdraw user fees
- Claim ITX token rewards earned through block building activities
How to Receive Rewards
Preparation
You can claim your rewards using the command-line tool provided in the repository below:
First, clone the repository using:
git clone git@github.com:InternetMaximalism/intmax2.git
cd intmax2
Next, set up your environment variables in the cli/.env file. Specifically, you'll need an RPC URL, which you can obtain by creating an account with providers such as Alchemy or Infura and generating an API key.
ENV=staging
IS_FASTER_MINING=false
INDEXER_BASE_URL=https://stage.api.indexer.intmax.io
STORE_VAULT_SERVER_BASE_URL=https://stage.api.node.intmax.io/store-vault-server
LOCAL_BACKUP_PATH="data/testnet_beta"
STORE_VAULT_TYPE="remote_with_backup"
BALANCE_PROVER_BASE_URL=https://stage.api.private.zkp.intmax.io
USE_PRIVATE_ZKP_SERVER=true
VALIDITY_PROVER_BASE_URL=https://stage.api.node.intmax.io/validity-prover
WITHDRAWAL_SERVER_BASE_URL=https://stage.api.node.intmax.io/withdrawal-server
WALLET_KEY_VAULT_BASE_URL=https://slxcnfhgxpfokwtathje.supabase.co/functions/v1/keyvault
DEPOSIT_TIMEOUT=180
TX_TIMEOUT=80
BLOCK_BUILDER_QUERY_WAIT_TIME=5
BLOCK_BUILDER_QUERY_INTERVAL=5
BLOCK_BUILDER_QUERY_LIMIT=20
LIQUIDITY_CONTRACT_ADDRESS=0x81f3843aF1FBaB046B771f0d440C04EBB2b7513F
ROLLUP_CONTRACT_ADDRESS=0xcEC03800074d0ac0854bF1f34153cc4c8bAEeB1E
WITHDRAWAL_CONTRACT_ADDRESS=0x914aBB5c7ea6352B618eb5FF61F42b96AD0325e7
REWARD_CONTRACT_ADDRESS=0x7f7a7734f74970bf8c5ca0ee0b6073f2e8dc5e30
L1_RPC_URL="https://eth-sepolia.g.alchemy.com/v2/your_api_key"
L2_RPC_URL="https://scroll-sepolia.g.alchemy.com/v2/your_api_key"
User Fees
Once you've completed these setup steps, execute the following commands step-by-step:
Step 1: Generate INTMAX keys from your Ethereum private key
cargo run -r -- key-from-eth --eth-private-key <eth-private-key>
Expected output:
Private key: 0x...
Public key: 0x...
Step 2: Check your balance using your INTMAX private key
Important: For <intmax-private-key>, copy and paste the Private key starting with 0x from the output log generated in Step 1.
cargo run -r -- balance --private-key <intmax-private-key>
Note: This command may take a significant amount of time to complete. If you have previously submitted a large number of blocks, this command may take over an hour to complete.
Step 3: Withdraw your funds
cargo run -r -- withdrawal --private-key <intmax-private-key> --to <ethereum-address> --amount <amount> --token-index 0
cargo run -r -- sync-withdrawals --private-key <intmax-private-key>
Note: Executing this command may take at least 2 minutes.
Ensure you replace placeholders such as <eth-private-key>, <intmax-private-key>, <ethereum-address>, and <amount> with your actual values.
ITX Token
Please execute the following command to claim your rewards. Replace <eth-private-key> with your actual Ethereum private key:
cargo run -r -- claim-builder-reward --eth-private-key <eth-private-key>
To execute the command, you'll need sufficient ETH to pay the gas fee (approximately 0.00001 ETH) on the Scroll address corresponding to your Ethereum address.
Expected Response
If there are rewards available for you to claim, you'll see logs similar to the following output:
[2025-06-01T00:00:00Z INFO intmax2_cli::cli::claim] Claiming block builder reward for user address: 0x...
[2025-06-01T00:00:00Z INFO intmax2_cli::cli::claim] Current reward period: 3
[2025-06-01T00:00:00Z INFO intmax2_cli::cli::claim] Claiming block builder reward for period 0: 105365126676602086438152
[2025-06-01T00:00:00Z INFO intmax2_cli::cli::claim] Claiming block builder reward for period 1: 120149253731343283582089
[2025-06-01T00:00:00Z INFO intmax2_cli::cli::claim] Claiming block builder reward for period 2: 118140794223826714801444
[2025-06-01T00:00:00Z INFO intmax2_cli::cli::claim] Claiming block builder rewards for periods: [0, 1, 2]
[2025-06-01T00:00:00Z INFO intmax2_client_sdk::external_api::contract::handlers] Sending transaction: batch_claim_reward with nonce 2368, gas limit 213439, value 0, max fee per gas 31360116, max priority fee per gas 100
[2025-06-01T00:00:00Z INFO intmax2_client_sdk::external_api::contract::handlers] Transaction sent: "batch_claim_reward" with tx hash: 0x...