IntersectMBO / IntersectMBO/govtool

💡 Implement Real-Time Treasury Withdrawal Monitoring (NCL Tracker)

Open
#4,110 0 comments 0 reactions 1 assignee Claimed by @m-i-k-e View on GitHub
❓Unknown area 🎨 Design Needed 💡 Feature idea
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

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.