Resolve #123, #88, #64, #72: score history, compaction, migration doc…

[JONAH-6]

Summary

• [Feature] Add project score history tracking #123 — Score history tracking per project (ring buffer, 50-entry limit, chronological read)
• [Gas] Implement storage compaction for accumulated data #88 — Storage compaction: lazy remove() on empty entries + explicit compact_storage admin function
  on both contracts
• [Architecture] Design and document contract upgrade migration strategy #64 — Contract upgrade migration strategy documented in MIGRATION.md with step-by-step procedure and
  version history
• [Architecture] Implement circuit breaker pattern across both contracts #72 — Circuit breaker: pause/unpause/is_paused on both contracts; registry pause blocks vault
  fund_project

Changes

project_registry

• types.rs: ScoreHistoryEntry struct; DataKey::ScoreHistorySlot, ScoreHistoryTotal, Paused;
  RegistryError::Paused = 34
• events.rs: registry_paused / registry_unpaused events
• lib.rs:
  • require_not_paused guard on all state-mutating user functions
  • append_score_history private helper (ring buffer, slot = total % 50)
  • get_score_history(project_id) — returns entries in chronological order
  • pause / unpause / is_paused public functions
  • compact_storage(project_ids, tokens) admin function
  • release_collateral / liquidate_collateral_internal now remove() instead of set(&key, &0i128)
  • No-op early return in update_credit_quality_score when value unchanged
• test.rs: 13 new tests covering score history, circuit breaker, compaction, and migration

investment_vault

• types.rs: VaultError::RegistryPaused = 35
• lib.rs:
  • pause / unpause / is_paused public functions
  • compact_storage() admin function (iterates ProjectInvestment entries, removes zeros)
  • get_project_investment(project_id) public getter
  • fund_project_internal checks registry.is_paused() and panics with RegistryPaused
• test.rs: 7 new tests covering circuit breaker, compaction, and migration; corrected
  test_vault_arithmetic_fuzz assertion to match insurance-in-NAV design

Pre-existing build fixes (unblocked CI)

• investment_vault/src/storage.rs: removed dead code referencing non-existent DataKey/VaultConfig types
  (prevented stellar contract build)
• {registry,vault}/src/wasm_test.rs: added extern crate std and qualified std::format!
• project_registry/src/test.rs: removed incorrect expected= string from #[should_panic] on
  panic_with_error! panics
• MIGRATION.md: added hard prerequisite warning — upgrading vault before registry is a point of no return

New file

• MIGRATION.md: upgrade procedure (build → upload → pause → upgrade → migrate_state → verify → unpause),
  rollback guidance, version history table, storage pattern reference

Closes

Closes #123
Closes #88
Closes #64
Closes #72

[drips-wave]

@JONAH-6 Great news! 🎉 Based on an automated assessment of this PR, the linked Wave issue(s) no longer count against your application limits.

You can now already apply to more issues while waiting for a review of this PR. Keep up the great work! 🚀

Learn more about application limits