Skip to main content

Fees

Every operation on merca.earth either costs gas only or splits a payment on-chain. This page shows who gets paid and when. For price formulas, see Pricing → Registration Price. For hierarchy payouts, see Tax → What a Tax Bucket Is.

Fee Matrix

OperationCost typeTreasurySeller / DonorHierarchy pool
registerPayment92%8%
buy_fullPayment7%85% (seller)8%
expand_unclaimedPayment92%8%
acquire_slicePayment7%85% (donor)8%
rebalance_sliceGas only
merge_ownedGas only
collect_taxGas only
sweep_expiredGas only
removeGas only
propose_poiPaymentMIN fee (100%)
accept_proposalPayment7%85% (owner)8%
reject_proposalGas only
withdraw_proposalGas only
set_min_offerGas only

Payment-Bearing Operations

These operations move SUI in the same transaction.

Register

When you register an unclaimed parcel, no seller exists. The payment splits as 92% to the protocol treasury and 8% to the hierarchy pool.

See Pricing → Registration Price for how the payment amount is calculated from area and rate.

Buy Full (Buyout)

When you buy a parcel from an existing owner, the payment splits three ways:

RecipientSharePurpose
Seller85%Compensation for losing the parcel
Protocol treasury7%Protocol development and operations
Hierarchy pool8%Tax revenue for parent-level parcel owners

The seller receives 85% in the same transaction. See Buyout & Premium → The Buyout Price Formula for the price formula.

Expand Unclaimed

Adding unclaimed area to an existing parcel uses the same split as registration: 92% treasury, 8% hierarchy pool. No seller share exists.

Acquire Slice

Acquiring a slice from a donor parcel uses the same split as a buyout: 85% to the donor, 7% to treasury, 8% to the hierarchy pool. The hierarchy pool accrues against the donor parcel, because the donor is the one selling area.

Propose POI

When someone proposes a point of interest on a block-level parcel, they pay at least the board's minimum fee. This MIN fee transfers immediately to the protocol treasury as a non-refundable anti-spam fee. Any amount above the minimum enters escrow.

If the owner accepts the proposal, the escrowed offer splits three ways — identical to a buyout:

RecipientSharePurpose
Owner85%Compensation for hosting the POI
Protocol treasury7%Protocol development and operations
Hierarchy pool8%Tax revenue for parent-level parcel owners

If the owner rejects, the proposal expires, or the proposer withdraws, the full escrowed amount refunds to the proposer. The MIN fee stays in treasury.

Gas-Only Operations

These operations cost only the Sui network gas fee.

  • rebalance_slice — adjust the boundary between two parcels you own
  • merge_owned — combine adjacent parcels you own into one
  • collect_tax — collect accumulated tax revenue from child parcels and transfer to the parcel owner
  • sweep_expired — clean up expired tax buckets
  • remove — delete a parcel you own
  • reject_proposal — reject a pending POI proposal (full escrow refunds to proposer)
  • withdraw_proposal — withdraw your own pending proposal (full escrow refunds)
  • set_min_offer — set or clear a per-parcel minimum offer threshold

Where the 8% Hierarchy Pool Goes

The hierarchy pool does not go to one fixed address. Its destination depends on the parcel's place in the quadtree.

If tax is initialized and the parcel has a parent: the 8% enters the tax_fund and opens a time-bucketed record on the child parcel. Anyone can collect it later via collect_tax, but the payout always goes to the parent parcel owner.

When the direct parent collects, it keeps 50% and forwards 50% upward as a cascade bucket on itself. Each later ancestor keeps an equal share of what remains, then forwards the rest. The last ancestor keeps everything. If the forwarded remainder falls below MIN_BUCKET_AMOUNT (1000 MIST), the current collector keeps that dust instead of opening another cascade bucket.

Otherwise: the 8% routes directly to treasury. This happens for top-level registrations, top-level expansions, and any parcel where tax is not initialized yet.

See Tax → How Cascade Collection Works for the full cascade formula and examples.

The Dust Threshold

Small hierarchy payouts can be too small to justify a new on-chain bucket. The protocol uses a minimum:

info

MIN_BUCKET_AMOUNT = 1000 MIST

If the initial 8% hierarchy pool amount falls below 1000 MIST, the whole amount routes directly to treasury instead of opening a bucket.

This threshold applies only when the protocol decides whether to open a hierarchy bucket. Treasury and seller shares still transfer at any size. During cascade collection, sub-threshold dust stays with the current collector.

Payment Flow for a Buyout

Here's the complete flow when you buy a parcel from an existing owner:

The split happens atomically. If the transaction fails, no funds move.


Related pages: