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

[bosko-m]

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) 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.