Hartii developer docs

Guides

Claim campaigns

Claim at hartiibiome.com/claim is "fund once, share one link". You put a pot of QUAI or a token into a campaign, list who gets what, and each person claims their own share and pays their own gas. It is beta: tested by the project's own tests, not audited. Start with a small campaign.

  1. Open the link and press Connect wallet (Pelagus or Blip, on Quai Mainnet, chain 9).
  2. The page checks the campaign against the chain. If your connected wallet is on the list, Claim allocation becomes available. If it doesn't, check that you connected the right account.
  3. Press Claim allocation, review, Confirm & open wallet, and sign.
  4. Each claim costs 0.05 QUAI plus network gas, paid by you. Any extra QUAI you send is refunded.
  5. If you hold more than one allocation in a campaign, claim them one at a time.

If you want to create a campaign

What you'll need: a wallet on Quai Mainnet, the funds to distribute, 5 QUAI for the creation fee, and gas. The recipient list is public once published, so don't include anything private.

  1. Open the Create tab and connect your wallet.
  2. Under Asset contract, leave it blank for QUAI, or paste a standard token address and press Read asset. Only use a token with no transfer tax and no admin who can add one; otherwise claims can get stuck.
  3. Add Recipients as address,amount rows, or import a CSV. Address-only rows can share one amount via Same amount for all (address-only rows); Split available balance divides your balance for you (it keeps about 10% for gas). You can also use Read indexed snapshot for holders of a HartiiLabs token. A snapshot may be stale or incomplete.
  4. Pick Expiry in days: 1, 7, 30 or 90. 90 days is the maximum.
  5. Review the recipient table, then press Build Merkle root.
  6. Press Download leaves.json and keep it as your backup.
  7. Press Publish / verify leaves. This stores the list on Hartii's storage (up to 10,000 recipients) or you can give a Self-hosted leaves URL. This makes allocations public.
  8. Token only: press Approve exact amount.
  9. Press Fund campaign, review, and confirm in your wallet.
  10. Share the campaign link: an Invite your community window shows it with Copy link, Share and Open in Blip.

After the expiry

Unclaimed funds don't return on their own. When the expiry passes, only the creator can reclaim the remainder. Use the My campaigns tab to find your campaign.

Fees and limits

  • Creation fee: 5 QUAI, paid by the creator.
  • Claim fee: 0.05 QUAI per claim, paid by the claimer, plus gas.
  • Expiry: up to 90 days.
  • Hosted leaves: up to 10,000 recipients. Larger lists need your own hosting.
  • The page shows exact fees and gas before you sign.

Common mistakes

  • Wrong network. Switch to Quai Mainnet (chain 9).
  • Not enough QUAI. Native campaigns need the pot plus the creation fee plus gas.
  • Not on the list. Only listed wallets can claim. Check you connected the right account.
  • Qi addresses in the list. Use Quai addresses that start with 0x00; the row will be flagged.
  • Lost backup. If the hosted list is temporarily down, use Recover from a leaves.json file with your backup.
  • Pending. Don't resend. Check your transaction on Quaiscan, or paste its hash under Transaction hash from wallet and press Check receipt.

Next

Prefer to send directly and pay the gas yourself? See Airdrop. Full details are in the Claim reference.

Quai Network mainnet · chain 9 · Cyprus-1. Figures marked "read on" a date were read from the chain that day; re-read before relying on them.