Skip to main content

Connecting a Wallet

To register land, buy claims, or collect tax balances on merca.earth, you need a wallet. Your wallet is your identity on the Sui blockchain — it holds your SUI tokens, signs transactions, and proves control of your claims. No personal information is required; your wallet address is all the protocol needs.

You do not need a wallet to explore the map.

Three ways to connect:

  1. Social sign-in (Google, Facebook, Twitch) — easiest, no extension required.
  2. Sui browser-extension wallets — Slush, OKX Wallet, Suiet, Martian, Surf, Nightly, and others.
  3. MetaMask (via Sui Snap) — use your existing MetaMask on desktop.

Connection Methods​

Social Sign-In with zkLogin​

Easiest option for newcomers

If you are new to crypto, start here. Social sign-in requires no extension, no seed phrase, and no prior blockchain experience.

No crypto wallet yet? Social sign-in is the fastest way to start. It uses Sui's zkLogin protocol to create a blockchain wallet linked to your social account. No browser extension needed; works on desktop and mobile.

Which providers are available depends on how the app is deployed. The default hosted deployment uses Enoki (Mysten Labs' managed service) and supports Google, Facebook, and Twitch. Self-hosted deployments that run their own zkLogin infrastructure support Google only.

How to connect​

  1. Click the wallet button in the top-right corner.
  2. In the wallet chooser, find the Social Sign-In or zkLogin section.
  3. Choose your provider — for example, Sign in with Google.
  4. A standard OAuth window opens. Sign in and approve access.
  5. A zero-knowledge proof is generated on your device.
  6. You are returned to merca.earth with your wallet connected.

How it works​

zkLogin uses zero-knowledge proofs to derive a Sui address from your social identity without revealing your credentials to the chain. For details, see Sui's zkLogin documentation.

Mobile​

On mobile, social sign-in is the primary connection method. The app detects your device and shows available providers. If only one provider is configured (e.g., Google), tapping the button connects you immediately.

Managing Your Wallet​

Click your wallet area in the top-right corner to open the wallet panel.

Auto-reconnect

The app remembers your last connection method and attempts to reconnect automatically on return visits. You do not need to sign in again each time you open the page.

The wallet panel gives you access to:

  • View your balance — current SUI balance at the top.
  • Copy your address — click the copy icon next to your shortened address.
  • See your claims — all your claimed parcels are listed with their current buyout price and level. Click any claim to fly to it on the map.
  • Review wallet activity — view claims value, sales proceeds, total paid in, withdrawn tax, and realized profit in one place.
  • Consolidate coins — if you have many small SUI coin objects from transactions, a consolidation button merges them for more efficient future transactions.
  • Disconnect — click the logout icon. Your on-chain assets are unaffected; reconnect any time.

Wallet Metrics​

Claims​

This number is the sum of the current buyout prices for every claim you currently control.

  • It changes as claim prices move.
  • It is not a guaranteed payout.
  • It does not include claims you already sold.

The wallet uses the current on-chain buyout price for each held claim, then sums them. For the underlying price formula, see Pricing → Reading the Price.

Sales​

This number is your total seller proceeds from completed full-claim buyouts.

  • It counts sales where someone bought your claim from you.
  • It uses the seller proceeds amount, not the full buyout price.
  • It does not include tax withdrawals.

For the split behind each resale, see Cash Flows → Resale Proceeds.

Total Paid In​

This number is the total SUI you have paid into merca.earth's payment-bearing claim actions.

It includes:

  • registrations
  • full-claim buyouts
  • expansions into unclaimed area
  • slice acquisitions

It does not include network gas.

For register, buyout, and expansion, the wallet reads the paid amount from protocol events. For acquire_slice, the current event does not expose a payment field, so the wallet reconstructs the amount from the transaction's SUI balance changes.

For the protocol-level split behind those payments, see Fees → Payment-Bearing Operations.

Profit​

This is a conservative wallet-level profit number:

Profit=max⁡((Sales+Tax Withdrawn)−Total Paid In, 0)\text{Profit} = \max((\text{Sales} + \text{Tax Withdrawn}) - \text{Total Paid In},\ 0)

Important:

  • it only shows realized upside
  • it never shows a negative number
  • it does not include current claim value

If you have spent more than you have withdrawn or received from sales, this stays at zero.

Tax Withdrawn​

This number is tax revenue that has already been transferred to your wallet.

  • It counts completed collect_tax flows.
  • It does not show uncollected or still-pending tax.

For the collection workflow, see Collect Tax → Claiming Tax Revenue.

Recent Sales​

This list shows your latest completed claim sales.

Each row shows:

  • the sale price
  • the sold claim ID
  • your seller proceeds from that sale

This is a recent activity view, not a full trade history.

Claim List​

This list shows the claims you currently hold.

Each row shows:

  • a short claim label
  • the current buyout price
  • part count
  • hierarchy level

Clicking a row moves the map to that claim and selects it.

Getting SUI Tokens​

To claim and trade on merca.earth, you need SUI tokens.

Ways to get SUI:

  • Centralized exchanges — purchase SUI on Binance, Coinbase, Kraken, or other CEXs that list Sui.
  • Decentralized swaps — use a DEX like Cetus or Aftermath to swap other tokens for SUI.
  • Bridges — if you hold tokens on another chain (Ethereum, Polygon, etc.), use Sui's official bridge to port them across and swap for SUI.

Start with a small amount to test the flow, then add more as you get comfortable.

See also: Getting Started · Register Land → Step 1 · Buy Land → Executing a Purchase · Collect Tax → Claiming Tax Revenue · FAQ

Last updated on