feat: treasury initialization for mainnet genesis

[m2ux]

Overview

Implement treasury initialization for the Midnight mainnet genesis block. The treasury is initialized from observed cNight deposits in the ICS (Illiquid Circulation Supply) contract on Cardano, configured through a new cnight-treasury-config.json file.

JIRA: PM-20981
Epic: PM-20554 - Mainnet Genesis Block

Changes

New Files

File	Description
util/toolkit/src/treasury_config.rs	Config struct, validation logic, unit tests
res/dev/cnight-treasury-config.json	Dev placeholder config
res/preview/cnight-treasury-config.json	Preview placeholder config

Modified Files

File	Changes
util/toolkit/src/lib.rs	Export treasury_config module
util/toolkit/src/genesis_generator.rs	Add fund_treasury() method, integration test
util/toolkit/src/commands/generate_genesis.rs	Add --cnight-treasury-config CLI argument

Implementation Details

1. Configuration file (cnight-treasury-config.json):

   • ics_contract_address: ICS contract address on Cardano
   • utxos[]: List of UTxOs with tx_hash, output_index, expected_amount
   • total_night_amount: Must equal sum of UTxO amounts

2. Two-step transfer via block reward pool:

   • DistributeReserve(amount) - Move from reserve pool to block_reward_pool
   • PayBlockRewardsToTreasury { amount } - Move from block_reward_pool to treasury

3. Validation:

   • Config-time validation ensures total matches sum of UTxOs
   • Overflow handling for large amounts

🗹 TODO before merging

• Ready

📌 Submission Checklist

• Changes are backward-compatible (or flagged if breaking)
• Pull request description explains why the change is needed
• Self-reviewed the diff
• I have included a change file, or skipped for this reason:
• If the changes introduce a new feature, I have bumped the node minor version
• Update documentation (if relevant)
• Updated AGENTS.md if build commands, architecture, or workflows changed
• No new todos introduced

🧪 Testing Evidence

cargo test -p midnight-toolkit treasury
   running 8 tests
   test treasury_config::tests::test_parse_valid_config ... ok
   test treasury_config::tests::test_validate_total_matches_sum ... ok
   test treasury_config::tests::test_validate_total_mismatch_fails ... ok
   test treasury_config::tests::test_validate_zero_total_empty_utxos ... ok
   test treasury_config::tests::test_validate_overflow_handling ... ok
   test treasury_config::tests::test_error_message_total_mismatch ... ok
   test treasury_config::tests::test_treasury_amount ... ok
   test genesis_generator::test::test_genesis_with_treasury_config ... ok

   test result: ok. 8 passed; 0 failed; 0 ignored

🔱 Fork Strategy

• Node Runtime Update
• Node Client Update
• Other:
• N/A

Links

• JIRA: PM-20981
• Epic: PM-20554

[github-actions]

KICS version: v2.1.16

Category Results CRITICAL 0 HIGH 0 MEDIUM 94 LOW 12 INFO 83 TRACE 0 TOTAL 189	Metric Values Files scanned 28 Files parsed 28 Files failed to scan 0 Total executed queries 73 Queries failed to execute 0 Execution time 7