Proposing a Point of Interest
You see a block-level parcel on the map and want to mark a café, a monument, or any place worth noting. You propose a POI — name it, pin it, and back it with payment. The parcel owner decides: accept and earn, or reject and send your offer back.
Overview
Who Can Propose
Anyone with a Sui wallet can propose a POI on any block-level parcel — including parcels they don't own. You don't need permission to submit. The owner decides what gets recorded.
Proposals only work on block-level parcels. The board is pinned to the block index; submitting against a district or region parcel fails.
Step 1 — Choose a Parcel
Navigate to block level on the map and click a parcel. Open its detail panel. You'll see a Propose POI button if the parcel is in the block index and the proposal board is active.
Step 2 — Fill in the Proposal
| Field | Required | Limit | Notes |
|---|---|---|---|
| Name | Yes | 48 bytes | The POI's display name |
| Coordinates | Yes | — | X and Y on the on-chain grid |
| Icon | No | 16 bytes | Short emoji or symbol code |
| Details CID | No | — | IPFS CID pointing to extended metadata |
| Payment | Yes | ≥ min fee | Total SUI you're sending |
The payment splits on submission. The minimum fee goes to the protocol treasury right away and never comes back. Everything above that minimum sits in escrow until the owner decides.
If the owner has set a minimum offer for their parcel, your offer after the min fee must meet or exceed it. The app shows this threshold before you submit.
Step 3 — Submit
Click Submit Proposal. Your wallet shows the transaction details. Approve it.
What happens on-chain:
- The min fee transfers to the protocol treasury immediately.
- The remainder (your offer) locks into the proposal board's escrow.
- The proposal stays pending with a timestamp.
The owner can now see your proposal in their parcel's proposal list.
The min fee is non-refundable. The treasury keeps it whether the owner accepts, rejects, or ignores your proposal.
What Happens Next
Accepted
The owner accepts your proposal. The offer splits:
| Recipient | Share |
|---|---|
| Parcel owner | 85% |
| Protocol treasury | 7% |
| Hierarchy pool | 8% |
Your POI is recorded on-chain. The name, coordinates, icon, and CID stay fixed after acceptance.
Rejected
The owner rejects your proposal. Your escrowed offer refunds to your wallet. The minimum fee stays with the treasury.
Expired
Each proposal board sets its own review window. Many deployments use 30 epochs, but that is a configuration choice, not a universal rule. If the owner does not act before that window ends, the proposal expires. Anyone can prune it. Your escrowed offer refunds when that happens, and the min fee stays with the treasury.
Withdrawing a Proposal
Changed your mind? You can withdraw any pending proposal before the owner acts on it.
Open the proposal in your activity panel and click Withdraw. Your escrowed offer refunds to your wallet. The min fee is not returned.
You can't withdraw a proposal the owner has already accepted or rejected.
For Owners: Managing Proposals
Reviewing Incoming Proposals
Your parcel's detail panel shows all pending proposals. Each one displays the proposer's address, the POI name and coordinates, the offer amount, and the submission epoch.
To accept: click Accept. The offer splits 85/7/8 and the POI is recorded.
To reject: click Reject. The escrowed offer refunds to the proposer. The treasury keeps the min fee.
You can act on proposals in any order. You do not have to respond before the review window ends, but expired proposals can be pruned and refunded.
Setting a Minimum Offer
You can set a floor on what proposers must offer for your parcel. Any proposal whose offer falls below this floor fails at submission.
Set the floor to 0 to remove it.
Set a minimum offer to filter low-effort proposals. A higher threshold attracts serious contributors who have thought about what the POI is worth.
Accepted Proposals and the Hierarchy Pool
When you accept a proposal, 8% of the offer flows into the hierarchy pool — the same as a buyout. This accrues as tax revenue for owners of parent-level parcels covering your area. Your 85% transfers directly to your wallet in the same transaction.
Related Pages
- Fees — the 85/7/8 split and where each portion goes
- Tax — how the 8% hierarchy pool distributes to parent owners
- Register Land — own a parcel before managing its proposals