Gonka Governance
pre-vote layer

Documentation

How Gonka Governance works

This portal is a thin UI on top of three CosmWasm contracts deployed on the Gonka chain. Every action — drafting, pledging, rating, commenting, locking GNK — is a signed transaction against one of these contracts. No database, no trusted backend, no middleman stands between you and the chain.

Pre-propose module

dao-pre-propose-gonka

Holds drafts, pledges, ratings, and pre-vote outcomes. Every action you take on this site ultimately calls this contract.

gonka1sa4xv8fuyq5pe44jj56r5suegtcz2m9k5plkwpxnc9k44lmx02gsgszwgpView on explorer →

Voting module

dao-voting-gonka

The source of voting power. Locking GNK here mints power proportional to the lock duration; that power is what the pre-propose contract reads when you rate or pre-vote.

gonka1v837zexseh4m8g5ajvu8ag74c2v9xfyv3mx0pu202ltjesqe2s9qctp8h2View on explorer →

Comments module

dao-comments-gonka

Stores threaded discussion on-chain. Every comment and every edit is a signed transaction with a permanent block height. Full version history is queryable by anyone.

gonka1unuddvfy7t2fgle7834rhr55mspxk89vwupwvvkqjy2uvy77j29qa6hc8jView on explorer →

Voting power = locked GNK × duration

You don't burn or pay anything to participate — you lock GNK in dao-voting-gonka for a fixed term. Longer locks earn more weight, and the original principal returns on unlock.

TierDurationMultiplier100 GNK locked = …
Three months90 days1×100 voting power
Six months180 days2×200 voting power
Twelve months360 days4×400 voting power
Lock GNK →

A draft's lifecycle

Every proposal moves through these on-chain states. Anyone (not just an admin) can push a draft forward once the gates are met.

  1. 1

    Author submits a draft

    Discussion

    Anyone with non-zero voting power can publish a draft. The full title, summary and optional external link are stored on-chain (no IPFS).

    Gate: Author must hold non-zero voting power.

  2. 2

    Community pledges, rates, and comments

    Discussion

    While the draft is open, anyone can pledge GNK to the deposit pool, withdraw their pledge, rate the draft up/down weighted by their voting power, and post on-chain comments. Every comment is a signed transaction stored in dao-comments-gonka with full edit history.

    Gate: Open until either the discussion deadline expires or the gates below are met.

  3. 3

    Anyone can start the pre-vote

    Pre-voting

    Once the deposit pool reaches the configured minimum and the cumulative rating power crosses the floor, anyone can call start_pre_vote. The draft is now locked into a binding pre-vote.

    Gate: total_pledged ≥ min_pledge_for_pre_vote AND yes_power + no_power ≥ min_rating_voting_power.

  4. 4

    Outcome recorded

    Passed / Failed

    When the pre-vote closes the operator (admin) records the outcome. Pledges from passing drafts are refundable; failed drafts are also refundable in this MVP. A future milestone wires this to dao-proposal-single so finalization is fully on-chain.

  5. 5

    Author may cancel any time before pre-vote

    Canceled

    If the author no longer wants to pursue the draft they can cancel it from Discussion. Pledges are refundable.

Useful read-only queries

Everything this UI shows is read directly from the contracts — no special API needed. Reproduce any of it from the CLI:

  • List drafts

    Same data the feed renders.

  • Inspect a single draft

    Title, summary, totals, status.

  • Pledgers for a draft

    Address + amount pairs.

  • Rating tally

    yes / no power and # of distinct raters.

  • My voting power

    From dao-voting-gonka. Replace the address.

  • My active locks

    Open positions in dao-voting-gonka.

Open contracts — build your own UI

All three contracts are permissionlessly readable from any CosmWasm-compatible tool. This portal is one possible UI. Anyone can build a different frontend, explorer plugin, Telegram bot, or analytics dashboard using the exact same data. There is no privileged API key, no walled garden, no vendor lock-in — whoever controls the UI controls nothing; the chain state is the source of truth.

  • ✓Read drafts, pledges, ratings — no authentication required.
  • ✓Read comments, version history, author addresses.
  • ✓Read voting power, lock positions for any address.
  • ✓All write actions (draft, pledge, comment, lock) require only a wallet — no account on this site.

What the indexer adds (optional)

This portal runs an open-source indexer alongside the contracts. It is a pure convenience layer — it never holds state that affects governance outcomes. You lose nothing by ignoring it.

  • –Fast paginated feeds (avoids scanning the whole contract history on every page load).
  • –Transaction-hash enrichment on comments (looks up the exact tx that created or edited each comment).
  • –Translation cache (avoids re-calling the AI API for the same content twice).
  • –If the indexer is down, the portal falls back to direct contract reads automatically.