IntersectMBO / IntersectMBO/govtool
💡 Implement Real-Time Treasury Withdrawal Monitoring (NCL Tracker)
- Dominant language
- HTML
- Stars
- 21
- Forks
- 29
- Avg merge
- 2d 22h
- Merged PRs (30d)
- 7
Description
### Area
Not sure
### Is there new design needed?
Yes
### What?
Develop and integrate a **Net Change Limit (NCL) Tracker** within GovTool to provide real-time visibility into treasury withdrawals, using live on-chain data.
The tracker should visually and numerically display progress toward the network’s approved Net Change Limit for the current budgetary period, along with a chronological list of enacted withdrawals.
### Why?
Transparency around treasury withdrawals is a critical part of on-chain governance accountability.
Currently, users cannot easily see:
- How much ADA has been withdrawn from the treasury within the current epoch range.
- The remaining allowance before reaching the NCL limit.
- Which governance actions (Treasury Withdrawals) have contributed to the current spend.
By adding the NCL Tracker, GovTool will:
- Increase user trust through transparency.
- Provide a central location to monitor treasury spending progress.
### How?
Implement a new UI component similar to the **reference NCL tracker** ([thomas-nada.github.io/NCL-tracker](https://thomas-nada.github.io/NCL-tracker/)) with the following elements:
#### 1. NCL Progress Section
- **Progress Bar:** Visual progress indicator showing the percentage of the NCL spent (e.g., `77.72%`).
- **Metrics Displayed:**
- **Epoch Range:**
- **Total Withdrawn:**
- **Net Change Limit:**
- **Remaining Allowance:**
#### 2. Withdrawals List
- Display each **ratified Treasury Withdrawal Governance Action**, showing:
- **Title / Purpose**
- **Amount (₳)**
- **GovAction ID**
- **Transaction ID (TxID)**
- **Ratified Epoch**
- **Sorting Options:** by `Epoch`, `Amount`, or `Name` (ascending/descending).
- Each withdrawal should link to its **GovTool Outcomes page**.
### (Optional) User Story with acceptance criteria
**As a Cardano community member**,
I want to see the progress of treasury withdrawals in real-time,
so that I can monitor how much ADA has been spent and how close we are to reaching the network’s Net Change Limit.
### Acceptance Criteria
- [ ] The NCL Tracker page displays **current epoch range**, **total withdrawn**, **limit**, and **remaining allowance**.
- [ ] Treasury withdrawals are listed with details (title, TxID, GovAction ID, epoch, and amount).
- [ ] Sorting by `Epoch`, `Amount`, and `Name` works correctly.
- [ ] Percentage and allowance values are accurate and derived from live data.
- [ ] Clicking a withdrawal navigates to its respective **GovTool Outcomes** page.
- [ ] The component automatically updates after each new Treasury Withdrawal is ratified.
Contributor guide
Assessment
This issue has not been assessed yet.