Getting Started

This guide will help you connect to Matchbox and start earning rewards or boosting your veBTC position.

Prerequisites

Before using Matchbox, you’ll need:

A compatible wallet — MetaMask or any WalletConnect-compatible wallet
veBTC and/or veMEZO positions — Lock BTC or MEZO on Mezo Earn to receive these NFTs
Small amount of BTC — For transaction fees on Mezo Network

Don’t have veBTC or veMEZO yet?

Visit Mezo Earn to:

Lock BTC (1-28 days) to receive veBTC
Lock MEZO (1-4 years) to receive veMEZO

Step 1: Connect Your Wallet

Visit the Matchbox app
Click Connect Wallet in the top navigation bar
Select your wallet provider (MetaMask, WalletConnect, etc.)
Approve the connection in your wallet
Make sure you’re connected to the Mezo Network

Once connected, you’ll see your wallet address in the header.

Step 2: Explore the Dashboard

After connecting, navigate to the Dashboard to see:

Your veBTC positions — All your locked BTC positions and their associated gauges
Your veMEZO positions — All your locked MEZO positions and their voting power
Claimable rewards — Any bribes you’ve earned from voting
APY metrics — Current and projected annual percentage yields

Step 3: Choose Your Path

If You Hold veMEZO (Want to Earn Bribes)

Go to the veMEZO page
Select your veMEZO position from the carousel
Browse available gauges and their incentives
Allocate your voting power to gauges offering attractive rewards
Confirm your vote transaction
Return to Dashboard to claim earned bribes

Full guide: Voting Guide

If You Hold veBTC (Want to Attract Votes)

Go to the veBTC page
Select your veBTC position from the carousel
Set up your gauge profile (name, description, social links)
Add incentives to attract veMEZO voters
Monitor your gauge performance on the Gauges page

Full guide: Gauge Management Guide

If You Hold Both

You can participate on both sides of the marketplace:

Add incentives to your veBTC gauge to attract votes
Use your veMEZO to vote on other gauges and earn their incentives

This dual strategy lets you maximize rewards across the entire ecosystem.

Understanding the Interface

Page	Purpose
Dashboard	Your portfolio, positions, and claimable rewards
Gauges	Browse all available gauges and their metrics
veMEZO	Vote on gauges with your veMEZO
veBTC	Manage your veBTC gauge profile and incentives

Live Stats Ticker

The header displays real-time protocol statistics:

Total number of gauges
Total veMEZO voting power in the system
Total veBTC voting power
Current BTC and MEZO prices

Position Carousel

When selecting a position to work with, you’ll see a carousel showing:

Lock amount and current voting power
Lock status (Active, Permanent, or Expired)
Unlock date (if applicable)
Current APY (for relevant positions)

Tips for New Users

Start small — If you’re new to voting, try allocating a portion of your voting power first
Monitor APY — Use the projected APY feature to estimate your potential earnings before voting
Check weekly — Votes don’t carry over between epochs, so revisit each week to maintain your strategy
Compare gauges — Browse all gauges before voting to find the best opportunities

Troubleshooting

Wallet Won’t Connect

Ensure you’re using a supported browser (Chrome, Firefox, Brave)
Check that your wallet extension is up to date
Try refreshing the page and reconnecting

Can’t See My Positions

Make sure you’re connected to the correct Mezo Network
Verify you’ve locked BTC/MEZO on Mezo Earn
Try disconnecting and reconnecting your wallet

Transaction Failing

Ensure you have enough BTC for gas fees
Check that you’re not in a restricted voting window (first/last hour of epoch)
Try increasing gas if the network is congested

For more help, see the FAQ.

Next Steps

Learn the fundamentals — Read Core Concepts to understand how veBTC, veMEZO, and gauges work together
Start earning — Follow the Voting Guide if you hold veMEZO
Attract votes — Follow the Gauge Management Guide if you hold veBTC