code/voting
Watch
4
0
Fork
You've already forked voting
 0
Code Issues 12 Pull requests Projects Releases Packages Wiki Activity

feat(voting): indexer registration + CL8Y CW20 balance ledger for registered wallets (no archive LCD) #1

New issue
Closed
opened 2026-08-09 08:25:54 +00:00 by PlasticDigits · 27 comments
PlasticDigits commented 2026-08-09 08:25:54 +00:00 (Migrated from gitlab.com)

Moved 2026-08-25 to PlasticDigits/voting. Implement in ~/repos/voting, not in cl8y-dex-terraclassic.

Paths below (indexer/, frontend-dapp/, …) are design references from the DEX tree. Ledger, operator-voting, and the dApp belong in this repo.

New required constraints: Legal clickwrap (#5) · wallet reuse DEX Terra + Bridge EVM (#6). BSC is core (#4).

Bundle here: #1 ledger · #2 operator-voting · #3 dApp · #4 BSC/EVM · #5 Legal · #6 wallets.

Former DEX IIDs: #509 → #1, #510 → #2, #511 → #3, #588 → #4.

Summary

Add an offchain CL8Y (hpax3) voter registration + balance ledger in the indexer/Postgres stack so snapshot vote power can be computed without an archive LCD.

CL8Y token (same as fee-discount cl8y_token):
terra16wtml2q66g82fdkx66tap0qjkahqwp4lwq3ngtygacg5q0kzycgqvhpax3 (18 decimals). LocalTerra uses TCL8Y via VITE_CL8Y_TOKEN_ADDRESS.

Product flow (this issue owns the data plane):

  1. Wallet registers by signing a message (signature persistence owned by operator-voting — linked issue).
  2. At registration, indexer (or registration worker) records LCD live CL8Y Balance + current block height (no historical/archive query).
  3. Indexer then indexes only CW20 CL8Y transfer / send / mint-burn (if any) events to/from registered wallets, maintaining a running balance and height-addressable history for those wallets.
  4. Later proposals freeze vote power from this ledger at a chosen height (proposal/vote product — linked issues).

Depends on / pairs with:

  • operator-voting package (signatures + restricted balance reads)
  • Frontend registration / proposal / vote UI

Current codebase

Area Status
CL8Y address wiring frontend-dapp/src/utils/constants.ts (VITE_CL8Y_TOKEN_ADDRESS / hpax3 fallback), scripts/lib/mainnet-soft-launch-defaults.sh (MAINNET_CL8Y_TOKEN_ADDRESS), fee-discount cl8y_token
Live CW20 balance query Frontend getTokenBalance in frontend-dapp/src/services/terraclassic/queries.ts; fee-discount contract also queries Cw20QueryMsg::Balance on register / GetDiscount
Indexer LCD smart query indexer/src/lcd/mod.rs query_contract; uses token_info / fee-discount registration — no CW20 Balance helper, no x-cosmos-block-height archive queries
Block height get_latest_block_height / get_block_at_height for indexing/reorg only
Wasm event parsing indexer/src/indexer/parser.rs — DEX swaps, limits, hooks, fee-discount registry; does not index CW20 Transfer/Send for arbitrary tokens
Postgres Migrations under indexer/migrations/ — assets, traders, trader_positions, pair_reserves, etc. No holder/balance/transfer tables. trader_positions are explicitly not on-chain balances (docs/indexer-invariants.md)
Fee-discount registry Tracks wallet → tier, not balances; incomplete electorate for voting
Wallet arbitrary sign Absent (tx sign only) — registration signature lands in operator-voting

Why this is needed

Community / operator snapshot voting needs height-frozen CL8Y vote power without operating an archive node. Enumerating all CL8Y holders on mainnet LCD is slow/unreliable. Opt-in registration + transfer tracking for the registered set gives a closed electorate with balances reconstructible at proposal heights from Postgres alone after registration.

Same CL8Y that gates fee-discount tiers should gate voting weight for consistency.

Constraints / guardrails

  1. No new smart contracts. Frontend + Postgres + indexer (+ operator-voting) only.
  2. No archive LCD requirement. Registration balance = live LCD at registration processing time + that block height. Historical power afterward comes from the transfer ledger, not x-cosmos-block-height.
  3. Track transfers only for registered wallets (from/to ∈ registered set) for the configured CL8Y CW20 address — not the full token holder universe.
  4. Token address must be configurable (CL8Y_TOKEN_ADDRESS / reuse fee-discount config / VITE_CL8Y_TOKEN_ADDRESS parity on LocalTerra TCL8Y).
  5. Use 18-decimal semantics; store raw integer amounts as strings or NUMERIC without float drift.
  6. Scope wasm events by runtime _contract_address (indexer invariant cl8y-dex-terraclassic#285) — only trust CL8Y contract emissions.
  7. Handle CW20 transfer, send, and any mint/burn actions the deployed code ID emits; ignore unrelated wasm.
  8. Reorg safety: follow existing indexer reorg / indexer_state.last_indexed_height patterns; balances must be correct after reorg unwind/replay for registered wallets.
  9. Registration is a prerequisite before a wallet can appear in proposal snapshots; unregistered wallets have no vote power even if they hold CL8Y.
  10. Do not use fee-discount traders.tier_id or trader_positions as vote weight.
  11. Indexer DB role used by the indexer may write ledger tables; operator-voting must only read balances (restricted role/views) — see linked package issue.
  12. Flash-loan / last-second transfer risk: document that vote power follows the ledger at snapshot height (same class of risk as fee-discount point-in-time balance; registration does not add time-weighting unless product later asks).

Relevant files

Indexer / DB

  • indexer/migrations/ (new migration(s))
  • indexer/src/indexer/parser.rs, block_indexer.rs, poller.rs, mod.rs
  • indexer/src/lcd/mod.rs, lcd/types.rs
  • indexer/src/db/queries/, db/mod.rs
  • indexer/src/config.rs, startup.rs, main.rs
  • indexer/src/indexer/trader_tracker.rs (pattern for fee-discount events — do not overload)
  • docs/indexer-invariants.md

CL8Y / balance references

  • frontend-dapp/src/utils/constants.ts, tokenRegistry.ts
  • frontend-dapp/src/services/terraclassic/queries.ts
  • scripts/lib/mainnet-soft-launch-defaults.sh
  • docs/reference/fee-discount-tiers.md
  • smartcontracts/contracts/fee-discount/ (balance query semantics reference only — no contract changes)

Deploy

  • docker/indexer/Dockerfile, Coolify indexer env examples under deployments/

Recommended direction

Schema (illustrative)

  • voting_registrations — wallet_address, registered_at_height, registered_at_time, initial_balance, status, optional link to signature id owned by operator-voting
  • cl8y_cw20_transfers — height, tx hash, from, to, amount, action, only rows involving ≥1 registered wallet + CL8Y contract
  • cl8y_balances or height-addressable checkpoints — running balance per registered wallet after each affecting transfer; enough to answer balance(wallet, height) for height >= registered_at_height (0 or null before registration)

Registration ingest

  1. operator-voting verifies ADR-36 (or chosen) signature and inserts/requests registration.
  2. Indexer worker (or synchronous path with clear ownership) at current LCD height:
    • {"balance":{"address":...}} on CL8Y CW20
    • persist initial_balance + height
  3. From registered_at_height forward, transfer parser updates that wallet’s ledger.

Transfer indexing

  • In parser.rs (or dedicated module): when _contract_address == CL8Y_TOKEN and action ∈ {transfer, send, …}, if from or to is registered, append transfer + update balances.
  • Maintain in-memory or DB set of registered addresses for cheap filtering.

Balance-at-height API surface for operator-voting

  • Prefer Postgres views / read-only functions such as voting_cl8y_balance_at(wallet, height) granted only to the operator_voting DB role — no broad table write grants.

LocalTerra

  • Use TCL8Y from deploy; transfer tests via mint + CW20 transfer between test wallets.

Acceptance criteria

  • New migration(s) create registration + CL8Y transfer/balance ledger tables (or equivalent) with indexes for (wallet, height).
  • Configured CL8Y token address is required/validated at indexer startup when voting ledger feature is enabled.
  • Registering a wallet (after valid signature handoff) stores live LCD balance + current block height; no archive header used.
  • Subsequent CL8Y transfers to/from that wallet update the ledger; unrelated wallets’ CL8Y transfers are not stored (except as counterparty on a registered leg).
  • balance(wallet, H) for H >= registered_at_height matches LCD live balance after replaying transfers up to H (property/integration tested on LocalTerra).
  • Wallets not registered have no ledger rows / zero vote-eligible balance.
  • Reorg / failed-block paths do not leave durable incorrect balances for registered wallets.
  • Docs/invariants updated for the new ledger; Coolify/env knobs documented.
  • No CosmWasm contract changes.

Test plan (all paths)

  1. Unit — parser: CL8Y transfer/send fixtures with _contract_address; registered vs unregistered from/to; forged contract_address without underscore ignored (cl8y-dex-terraclassic#285).
  2. Unit — balance math: sequential transfers produce correct running balances; self-transfer no-op or correct; amount parsing 18-dec strings.
  3. Integration — registration: mock/live LCD balance at height N; row inserted with matching amount/height.
  4. Integration — transfer follow: register A; transfer A→B (B unregistered): A decreases, B not tracked as voter; register B later with new LCD snapshot (does not backfill pre-registration history unless explicitly designed — document choice: no backfill).
  5. Integration — balance at height: after transfers at H1,H2,H3, query at H2 returns post-H2 balance.
  6. LocalTerra: mint TCL8Y, register via API path, transfer, assert ledger vs LCD.
  7. Reorg: simulate rewind of last N blocks; balances restored.
  8. Config: wrong/missing token address fails closed when feature enabled.
  9. Regression: existing swap/limit/hook parsing tests still pass.

Test plan — attack, hack & abuse vectors

  1. Unregistered flood: spam CL8Y transfers among unregistered wallets — indexer must not grow unbounded transfer rows for them.
  2. Registration griefing: rapid re-register / duplicate register — idempotent per wallet; no double initial credit.
  3. Counterparty dust: registered wallet receives many tiny transfers — performance/rate of ledger writes acceptable; no precision loss.
  4. Event spoofing: wasm attrs with fake contract_address (no underscore) claiming CL8Y transfer — must not credit.
  5. Wrong token: transfers on non-CL8Y CW20 must not affect ledger even if registered wallet participates.
  6. Reorg double-apply: ensure transfers not double-counted after replay.
  7. LCD lag at registration: if height/balance race, document fail-closed retry; never invent balances.
  8. Snapshot tip-over: transfer in same block as proposal snapshot height — define inclusive block ordering consistent with indexer tx order; test boundary.
  9. Flash move before proposal: large CL8Y into registered wallet just before snapshot — by design counted; document (not a bug unless product adds lockup later).

Verification criteria

  • cargo test for indexer units covering parser + balance helpers.
  • Indexer integration test (Postgres) for register → transfer → balance_at (LocalTerra or fixtures).
  • Manual/scripted LocalTerra check: LCD balance equals ledger tip for a registered wallet after several transfers.
  • Confirm no use of x-cosmos-block-height in the registration/ledger path.
  • Coolify/staging: migration applies on indexer boot; feature flag/env documented.
  • Cross-check linked operator-voting issue can read balances via restricted DB role only.

Labels

indexer backend enhancement architecture security

Priority

P1

> **Moved 2026-08-25** to [PlasticDigits/voting](https://gitlab.com/PlasticDigits/voting). Implement in `~/repos/voting`, **not** in `cl8y-dex-terraclassic`. > > Paths below (`indexer/`, `frontend-dapp/`, …) are **design references** from the DEX tree. Ledger, `operator-voting`, and the dApp belong in this repo. > > **New required constraints:** Legal clickwrap (**#5**) · wallet reuse DEX Terra + Bridge EVM (**#6**). BSC is core (**#4**). > > Bundle here: **#1** ledger · **#2** operator-voting · **#3** dApp · **#4** BSC/EVM · **#5** Legal · **#6** wallets. > > Former DEX IIDs: #509 → #1, #510 → #2, #511 → #3, #588 → #4. --- ## Summary Add an **offchain CL8Y (hpax3) voter registration + balance ledger** in the indexer/Postgres stack so snapshot vote power can be computed **without an archive LCD**. **CL8Y token (same as fee-discount `cl8y_token`):** `terra16wtml2q66g82fdkx66tap0qjkahqwp4lwq3ngtygacg5q0kzycgqvhpax3` (18 decimals). LocalTerra uses TCL8Y via `VITE_CL8Y_TOKEN_ADDRESS`. **Product flow (this issue owns the data plane):** 1. Wallet **registers** by signing a message (signature persistence owned by `operator-voting` — linked issue). 2. At registration, indexer (or registration worker) records **LCD live** CL8Y `Balance` + **current block height** (no historical/archive query). 3. Indexer then indexes **only** CW20 CL8Y `transfer` / `send` / mint-burn (if any) events **to/from registered wallets**, maintaining a running balance and height-addressable history for those wallets. 4. Later proposals freeze vote power from this ledger at a chosen height (proposal/vote product — linked issues). Depends on / pairs with: - `operator-voting` package (signatures + restricted balance reads) - Frontend registration / proposal / vote UI --- ## Current codebase | Area | Status | |------|--------| | CL8Y address wiring | `frontend-dapp/src/utils/constants.ts` (`VITE_CL8Y_TOKEN_ADDRESS` / hpax3 fallback), `scripts/lib/mainnet-soft-launch-defaults.sh` (`MAINNET_CL8Y_TOKEN_ADDRESS`), fee-discount `cl8y_token` | | Live CW20 balance query | Frontend `getTokenBalance` in `frontend-dapp/src/services/terraclassic/queries.ts`; fee-discount contract also queries `Cw20QueryMsg::Balance` on register / `GetDiscount` | | Indexer LCD smart query | `indexer/src/lcd/mod.rs` `query_contract`; uses `token_info` / fee-discount registration — **no** CW20 `Balance` helper, **no** `x-cosmos-block-height` archive queries | | Block height | `get_latest_block_height` / `get_block_at_height` for indexing/reorg only | | Wasm event parsing | `indexer/src/indexer/parser.rs` — DEX swaps, limits, hooks, fee-discount registry; **does not** index CW20 Transfer/Send for arbitrary tokens | | Postgres | Migrations under `indexer/migrations/` — `assets`, `traders`, `trader_positions`, `pair_reserves`, etc. **No** holder/balance/transfer tables. `trader_positions` are explicitly **not** on-chain balances (`docs/indexer-invariants.md`) | | Fee-discount registry | Tracks wallet → tier, not balances; incomplete electorate for voting | | Wallet arbitrary sign | **Absent** (tx sign only) — registration signature lands in `operator-voting` | --- ## Why this is needed Community / operator snapshot voting needs **height-frozen CL8Y vote power** without operating an archive node. Enumerating all CL8Y holders on mainnet LCD is slow/unreliable. Opt-in registration + transfer tracking for the registered set gives a closed electorate with balances reconstructible at proposal heights from Postgres alone after registration. Same CL8Y that gates fee-discount tiers should gate voting weight for consistency. --- ## Constraints / guardrails 1. **No new smart contracts.** Frontend + Postgres + indexer (+ `operator-voting`) only. 2. **No archive LCD requirement.** Registration balance = live LCD at registration processing time + that block height. Historical power afterward comes from the transfer ledger, not `x-cosmos-block-height`. 3. **Track transfers only for registered wallets** (from/to ∈ registered set) for the configured CL8Y CW20 address — not the full token holder universe. 4. Token address must be **configurable** (`CL8Y_TOKEN_ADDRESS` / reuse fee-discount config / `VITE_CL8Y_TOKEN_ADDRESS` parity on LocalTerra TCL8Y). 5. Use **18-decimal** semantics; store raw integer amounts as strings or `NUMERIC` without float drift. 6. Scope wasm events by runtime `_contract_address` (indexer invariant cl8y-dex-terraclassic#285) — only trust CL8Y contract emissions. 7. Handle CW20 `transfer`, `send`, and any mint/burn actions the deployed code ID emits; ignore unrelated wasm. 8. Reorg safety: follow existing indexer reorg / `indexer_state.last_indexed_height` patterns; balances must be correct after reorg unwind/replay for registered wallets. 9. Registration is a **prerequisite** before a wallet can appear in proposal snapshots; unregistered wallets have no vote power even if they hold CL8Y. 10. Do **not** use fee-discount `traders.tier_id` or `trader_positions` as vote weight. 11. Indexer DB role used by the indexer may write ledger tables; `operator-voting` must only **read** balances (restricted role/views) — see linked package issue. 12. Flash-loan / last-second transfer risk: document that vote power follows the ledger at snapshot height (same class of risk as fee-discount point-in-time balance; registration does not add time-weighting unless product later asks). --- ## Relevant files **Indexer / DB** - `indexer/migrations/` (new migration(s)) - `indexer/src/indexer/parser.rs`, `block_indexer.rs`, `poller.rs`, `mod.rs` - `indexer/src/lcd/mod.rs`, `lcd/types.rs` - `indexer/src/db/queries/`, `db/mod.rs` - `indexer/src/config.rs`, `startup.rs`, `main.rs` - `indexer/src/indexer/trader_tracker.rs` (pattern for fee-discount events — do not overload) - `docs/indexer-invariants.md` **CL8Y / balance references** - `frontend-dapp/src/utils/constants.ts`, `tokenRegistry.ts` - `frontend-dapp/src/services/terraclassic/queries.ts` - `scripts/lib/mainnet-soft-launch-defaults.sh` - `docs/reference/fee-discount-tiers.md` - `smartcontracts/contracts/fee-discount/` (balance query semantics reference only — no contract changes) **Deploy** - `docker/indexer/Dockerfile`, Coolify indexer env examples under `deployments/` --- ## Recommended direction ### Schema (illustrative) - `voting_registrations` — `wallet_address`, `registered_at_height`, `registered_at_time`, `initial_balance`, `status`, optional link to signature id owned by `operator-voting` - `cl8y_cw20_transfers` — height, tx hash, from, to, amount, action, only rows involving ≥1 registered wallet + CL8Y contract - `cl8y_balances` or height-addressable checkpoints — running balance per registered wallet after each affecting transfer; enough to answer `balance(wallet, height)` for `height >= registered_at_height` (0 or null before registration) ### Registration ingest 1. `operator-voting` verifies ADR-36 (or chosen) signature and inserts/requests registration. 2. Indexer worker (or synchronous path with clear ownership) at **current** LCD height: - `{"balance":{"address":...}}` on CL8Y CW20 - persist `initial_balance` + height 3. From `registered_at_height` forward, transfer parser updates that wallet’s ledger. ### Transfer indexing - In `parser.rs` (or dedicated module): when `_contract_address == CL8Y_TOKEN` and action ∈ {transfer, send, …}, if `from` or `to` is registered, append transfer + update balances. - Maintain in-memory or DB set of registered addresses for cheap filtering. ### Balance-at-height API surface for `operator-voting` - Prefer **Postgres views / read-only functions** such as `voting_cl8y_balance_at(wallet, height)` granted only to the `operator_voting` DB role — no broad table write grants. ### LocalTerra - Use TCL8Y from deploy; transfer tests via mint + CW20 transfer between test wallets. --- ## Acceptance criteria - [ ] New migration(s) create registration + CL8Y transfer/balance ledger tables (or equivalent) with indexes for `(wallet, height)`. - [ ] Configured CL8Y token address is required/validated at indexer startup when voting ledger feature is enabled. - [ ] Registering a wallet (after valid signature handoff) stores live LCD balance + current block height; no archive header used. - [ ] Subsequent CL8Y transfers to/from that wallet update the ledger; unrelated wallets’ CL8Y transfers are not stored (except as counterparty on a registered leg). - [ ] `balance(wallet, H)` for `H >= registered_at_height` matches LCD live balance after replaying transfers up to H (property/integration tested on LocalTerra). - [ ] Wallets not registered have no ledger rows / zero vote-eligible balance. - [ ] Reorg / failed-block paths do not leave durable incorrect balances for registered wallets. - [ ] Docs/invariants updated for the new ledger; Coolify/env knobs documented. - [ ] No CosmWasm contract changes. --- ## Test plan (all paths) 1. **Unit — parser:** CL8Y transfer/send fixtures with `_contract_address`; registered vs unregistered from/to; forged `contract_address` without underscore ignored (cl8y-dex-terraclassic#285). 2. **Unit — balance math:** sequential transfers produce correct running balances; self-transfer no-op or correct; amount parsing 18-dec strings. 3. **Integration — registration:** mock/live LCD balance at height N; row inserted with matching amount/height. 4. **Integration — transfer follow:** register A; transfer A→B (B unregistered): A decreases, B not tracked as voter; register B later with new LCD snapshot (does not backfill pre-registration history unless explicitly designed — document choice: **no backfill**). 5. **Integration — balance at height:** after transfers at H1,H2,H3, query at H2 returns post-H2 balance. 6. **LocalTerra:** mint TCL8Y, register via API path, transfer, assert ledger vs LCD. 7. **Reorg:** simulate rewind of last N blocks; balances restored. 8. **Config:** wrong/missing token address fails closed when feature enabled. 9. **Regression:** existing swap/limit/hook parsing tests still pass. --- ## Test plan — attack, hack & abuse vectors 1. **Unregistered flood:** spam CL8Y transfers among unregistered wallets — indexer must not grow unbounded transfer rows for them. 2. **Registration griefing:** rapid re-register / duplicate register — idempotent per wallet; no double initial credit. 3. **Counterparty dust:** registered wallet receives many tiny transfers — performance/rate of ledger writes acceptable; no precision loss. 4. **Event spoofing:** wasm attrs with fake `contract_address` (no underscore) claiming CL8Y transfer — must not credit. 5. **Wrong token:** transfers on non-CL8Y CW20 must not affect ledger even if registered wallet participates. 6. **Reorg double-apply:** ensure transfers not double-counted after replay. 7. **LCD lag at registration:** if height/balance race, document fail-closed retry; never invent balances. 8. **Snapshot tip-over:** transfer in same block as proposal snapshot height — define inclusive block ordering consistent with indexer tx order; test boundary. 9. **Flash move before proposal:** large CL8Y into registered wallet just before snapshot — by design counted; document (not a bug unless product adds lockup later). --- ## Verification criteria - [ ] `cargo test` for indexer units covering parser + balance helpers. - [ ] Indexer integration test (Postgres) for register → transfer → `balance_at` (LocalTerra or fixtures). - [ ] Manual/scripted LocalTerra check: LCD balance equals ledger tip for a registered wallet after several transfers. - [ ] Confirm no use of `x-cosmos-block-height` in the registration/ledger path. - [ ] Coolify/staging: migration applies on indexer boot; feature flag/env documented. - [ ] Cross-check linked `operator-voting` issue can read balances via restricted DB role only. ## Labels `indexer` `backend` `enhancement` `architecture` `security` ## Priority P1
PlasticDigits commented 2026-08-09 08:26:05 +00:00 (Migrated from gitlab.com)

Bundle links

Offchain CL8Y snapshot voting (no contracts, no archive LCD):

Issue Role
cl8y-dex-terraclassic#509 (this) Indexer/Postgres registration + CL8Y transfer ledger for registered wallets
cl8y-dex-terraclassic#510 operator-voting package — restricted DB, signatures, proposals, votes, blacklist env
cl8y-dex-terraclassic#511 Frontend register / WYSIWYG propose / vote UX

Suggested order: cl8y-dex-terraclassic#509 → cl8y-dex-terraclassic#510 → cl8y-dex-terraclassic#511 (UI can stub cl8y-dex-terraclassic#510 with MSW in parallel).

## Bundle links Offchain CL8Y snapshot voting (no contracts, no archive LCD): | Issue | Role | |-------|------| | **cl8y-dex-terraclassic#509** (this) | Indexer/Postgres registration + CL8Y transfer ledger for registered wallets | | **cl8y-dex-terraclassic#510** | `operator-voting` package — restricted DB, signatures, proposals, votes, blacklist env | | **cl8y-dex-terraclassic#511** | Frontend register / WYSIWYG propose / vote UX | **Suggested order:** cl8y-dex-terraclassic#509 → cl8y-dex-terraclassic#510 → cl8y-dex-terraclassic#511 (UI can stub cl8y-dex-terraclassic#510 with MSW in parallel).
PlasticDigits commented 2026-08-09 08:26:07 +00:00 (Migrated from gitlab.com)

mentioned in issue cl8y-dex-terraclassic#510

mentioned in issue cl8y-dex-terraclassic#510
PlasticDigits commented 2026-08-09 08:26:08 +00:00 (Migrated from gitlab.com)

mentioned in issue cl8y-dex-terraclassic#511

mentioned in issue cl8y-dex-terraclassic#511
PlasticDigits commented 2026-08-09 08:26:15 +00:00 (Migrated from gitlab.com)

marked as related to cl8y-dex-terraclassic#510

marked as related to cl8y-dex-terraclassic#510
PlasticDigits commented 2026-08-09 08:26:16 +00:00 (Migrated from gitlab.com)

marked as related to cl8y-dex-terraclassic#511

marked as related to cl8y-dex-terraclassic#511
PlasticDigits commented 2026-08-21 11:32:37 +00:00 (Migrated from gitlab.com)

mentioned in issue cl8y-dex-terraclassic#588

mentioned in issue cl8y-dex-terraclassic#588
PlasticDigits commented 2026-08-21 11:32:37 +00:00 (Migrated from gitlab.com)

marked as related to cl8y-dex-terraclassic#588

marked as related to cl8y-dex-terraclassic#588
PlasticDigits commented 2026-08-21 11:32:48 +00:00 (Migrated from gitlab.com)

Scope add: BSC BEP-20 CL8Y ledger (core)

A majority of CL8Y holders are on BSC, not Terra Classic. The registration + balance ledger in this issue must also track BEP-20 CL8Y for registered EVM wallets — same “live balance at registration + transfers forward, no archive node” model as CW20.

Canonical BEP-20: 0x8F452a1fdd388A45e1080992eFF051b4dd9048d2

Do not treat Terra CW20-only as a complete data plane. Reuse BSC_RPC_URLS transport; do not overload the Venus vFDUSD poller (cl8y-dex-terraclassic#571).

Tracking issue (BSC integration): https://gitlab.com/PlasticDigits/cl8y-dex-terraclassic/-/issues/588

Related Role
cl8y-dex-terraclassic#509 (this) Terra CW20 and BSC BEP-20 ledgers
cl8y-dex-terraclassic#510 EVM EIP-191 + dual snapshot (Terra height + BSC block)
cl8y-dex-terraclassic#511 EVM wallet register / vote UX
cl8y-dex-terraclassic#588 BSC integration contract / guardrails
## Scope add: BSC BEP-20 CL8Y ledger (core) A **majority of CL8Y holders are on BSC**, not Terra Classic. The registration + balance ledger in this issue must also track **BEP-20 CL8Y** for registered **EVM** wallets — same “live balance at registration + transfers forward, no archive node” model as CW20. **Canonical BEP-20:** [`0x8F452a1fdd388A45e1080992eFF051b4dd9048d2`](https://bscscan.com/token/0x8F452a1fdd388A45e1080992eFF051b4dd9048d2) Do not treat Terra CW20-only as a complete data plane. Reuse `BSC_RPC_URLS` transport; do **not** overload the Venus vFDUSD poller (cl8y-dex-terraclassic#571). **Tracking issue (BSC integration):** https://gitlab.com/PlasticDigits/cl8y-dex-terraclassic/-/issues/588 | Related | Role | |---------|------| | **cl8y-dex-terraclassic#509** (this) | Terra CW20 **and** BSC BEP-20 ledgers | | **cl8y-dex-terraclassic#510** | EVM EIP-191 + dual snapshot (Terra height + BSC block) | | **cl8y-dex-terraclassic#511** | EVM wallet register / vote UX | | **cl8y-dex-terraclassic#588** | BSC integration contract / guardrails |
PlasticDigits commented 2026-08-25 06:07:19 +00:00 (Migrated from gitlab.com)

moved from cl8y-dex-terraclassic#509

moved from cl8y-dex-terraclassic#509
PlasticDigits commented 2026-08-25 06:07:55 +00:00 (Migrated from gitlab.com)

mentioned in issue #6

mentioned in issue #6
PlasticDigits commented 2026-08-25 06:07:56 +00:00 (Migrated from gitlab.com)

mentioned in issue #5

mentioned in issue #5
PlasticDigits commented 2026-08-25 06:08:29 +00:00 (Migrated from gitlab.com)

Repo split + updated links (2026-08-25)

This issue moved from cl8y-dex-terraclassic#509 to https://gitlab.com/PlasticDigits/voting/-/issues/1

Implement the ledger in this repo. DEX indexer/ paths in the description are references only.

Issue Role
#1 (this) Terra CW20 and BSC BEP-20 ledgers
#2 ADR-36 and EIP-191; dual snapshot
#3 Terra and EVM /vote UX
#4 BSC integration contract / guardrails
#5 Legal clickwrap (dApp)
#6 Reuse DEX Terra + Bridge EVM wallets
## Repo split + updated links (2026-08-25) This issue **moved** from `cl8y-dex-terraclassic#509` to https://gitlab.com/PlasticDigits/voting/-/issues/1 Implement the ledger **in this repo**. DEX `indexer/` paths in the description are references only. | Issue | Role | |-------|------| | **#1** (this) | Terra CW20 **and** BSC BEP-20 ledgers | | **#2** | ADR-36 **and** EIP-191; dual snapshot | | **#3** | Terra **and** EVM `/vote` UX | | **#4** | BSC integration contract / guardrails | | **#5** | Legal clickwrap (dApp) | | **#6** | Reuse DEX Terra + Bridge EVM wallets |
PlasticDigits commented 2026-08-25 06:08:31 +00:00 (Migrated from gitlab.com)

changed the description

changed the description
PlasticDigits commented 2026-08-25 06:08:41 +00:00 (Migrated from gitlab.com)

mentioned in issue #2

mentioned in issue #2
PlasticDigits commented 2026-08-25 06:08:42 +00:00 (Migrated from gitlab.com)

mentioned in issue #3

mentioned in issue #3
PlasticDigits commented 2026-08-25 06:08:44 +00:00 (Migrated from gitlab.com)

mentioned in issue #4

mentioned in issue #4
PlasticDigits commented 2026-08-25 06:08:50 +00:00 (Migrated from gitlab.com)

mentioned in issue cl8y-dex-terraclassic#509

mentioned in issue cl8y-dex-terraclassic#509
PlasticDigits commented 2026-08-25 06:08:58 +00:00 (Migrated from gitlab.com)

mentioned in issue cl8y-dex-terraclassic#637

mentioned in issue cl8y-dex-terraclassic#637
PlasticDigits commented 2026-08-25 06:09:13 +00:00 (Migrated from gitlab.com)

mentioned in commit 8d11152cfe

mentioned in commit 8d11152cfe841216c2aaa11931d8019030a502ee
PlasticDigits commented 2026-08-25 06:41:44 +00:00 (Migrated from gitlab.com)

mentioned in commit b32b56660d

mentioned in commit b32b56660d0df7b94c606187dda3a6130462c572
PlasticDigits commented 2026-08-25 06:41:53 +00:00 (Migrated from gitlab.com)

mentioned in merge request !18

mentioned in merge request !18
PlasticDigits commented 2026-08-25 06:41:58 +00:00 (Migrated from gitlab.com)

Implemented on feat/voting-bundle. MR: https://gitlab.com/PlasticDigits/voting/-/merge_requests/1
In-tree: ledger/ (CW20 + BEP-20), operator-voting/, frontend/ (/vote + Legal + ported wallets).
Docs: docs/LEDGER_INVARIANTS.md, docs/OPERATOR_VOTING.md, docs/FRONTEND.md.

Implemented on feat/voting-bundle. MR: https://gitlab.com/PlasticDigits/voting/-/merge_requests/1 In-tree: ledger/ (CW20 + BEP-20), operator-voting/, frontend/ (/vote + Legal + ported wallets). Docs: docs/LEDGER_INVARIANTS.md, docs/OPERATOR_VOTING.md, docs/FRONTEND.md.
PlasticDigits commented 2026-08-25 06:47:01 +00:00 (Migrated from gitlab.com)

mentioned in commit 8fe45a1974

mentioned in commit 8fe45a197400462abfc1724385113ea8276a028a
PlasticDigits (Migrated from gitlab.com) closed this issue 2026-08-25 06:47:01 +00:00
PlasticDigits commented 2026-08-25 06:47:48 +00:00 (Migrated from gitlab.com)

mentioned in issue #7

mentioned in issue #7
PlasticDigits commented 2026-08-25 06:48:13 +00:00 (Migrated from gitlab.com)

Merge verify (!18 → main, no conflicts, fast-forward). In-tree ledger criteria are met on 8fe45a1.

Still open after merge (tracked in #7):

  • Live LocalTerra: mint TCL8Y and assert ledger tip equals LCD for a registered wallet.
  • Coolify: apply ledger migrations on the writer role.
**Merge verify (!18 → main, no conflicts, fast-forward).** In-tree ledger criteria are met on `8fe45a1`. Still open after merge (tracked in #7): - Live LocalTerra: mint TCL8Y and assert ledger tip equals LCD for a registered wallet. - Coolify: apply ledger migrations on the writer role.
PlasticDigits commented 2026-08-29 14:16:36 +00:00 (Migrated from gitlab.com)

mentioned in issue #9

mentioned in issue #9
PlasticDigits commented 2026-08-30 02:47:14 +00:00 (Migrated from gitlab.com)

mentioned in issue #14

mentioned in issue #14
Sign in to join this conversation.
No Branch/Tag specified
Branches Tags
main
fix/voting-36-43
No results found.
Labels
Clear labels   
architecture
Architecture

  
backend
API and services

  
deploy
Deploy

  
enhancement
Enhancement

  
frontend
Frontend

  
indexer
Indexer / ledger

  
product
Product

  
security
Security

  
UX
UX

No labels
architecture
backend
deploy
enhancement
frontend
indexer
product
security
UX
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
code/voting#1
No description provided.