Skip to content

DEMO_GUIDE.md

Latest commit

 

History

History
85 lines (61 loc) · 2.22 KB

DEMO_GUIDE.md

File metadata and controls

85 lines (61 loc) · 2.22 KB
Raw

Droptron Demo Guide

This guide helps operators run a local or Sepolia walkthrough of Droptron.

Before You Start

Prepare:

  • a wallet with Sepolia ETH
  • frontend .env values
  • Supabase project values
  • TokenOps/Zama-compatible network configuration
  • demo token configuration if using dCUSD
  • at least one recipient wallet for claim portal testing

Run The Frontend

cd frontend
npm install
cp .env.example .env
npm run dev

Open:

http://localhost:3000

Optional: Deploy Demo Token

cd hardhat
npm install
cp .env.example .env
npm run compile
npm run deploy:sepolia

Add the deployed address to the frontend configuration if you want the UI demo-token path to use that deployment.

Suggested Walkthrough

  1. Open /app.
  2. Connect the operator wallet.
  3. Create a workspace if the wallet has not onboarded yet.
  4. Open New distribution.
  5. Choose a mode:
    • Disperse for direct private payouts
    • Airdrop for claim-window rewards
    • Vesting for scheduled unlocks
  6. Select an ERC-7984 token or use the demo token if configured.
  7. Add recipients and amounts.
  8. Review the campaign.
  9. Open the campaign detail page.
  10. Complete the TokenOps operation steps.
  11. Open /claim in an eligible recipient wallet.
  12. Reveal and claim the wallet-specific allocation.

What To Emphasize

  • Droptron is wallet-scoped.
  • The operator gets receipts and recovery controls.
  • The recipient portal does not show a public table of all recipients.
  • Reveal is authorized by the connected wallet.
  • Public chain activity remains visible, while allocation values remain confidential.

Common Issues

Insufficient Confidential Balance

The operating wallet needs enough of the selected confidential token for the distribution. If the balance is private, the wallet may need to authorize a balance reveal before Droptron can confirm readiness.

Wrong Network

Switch to the network where the campaign token and TokenOps contracts are configured.

Claim Window Not Open

Airdrop recipients can reveal or claim only when the claim window allows it.

Ineligible Wallet

The claim portal only lists records assigned to the connected wallet. If the wallet is not included, it should not see that campaign detail.