storgae clean up

[Nabeelahh]

closes #511

Summmary

This PR implements a long-overdue storage optimization mechanism for the escrow contract. Currently, escrow data (documents, conditions, signatures, audit logs) persists indefinitely after completion, causing unnecessary on-chain storage bloat. This change introduces a cleanup mechanism that removes detailed escrow data while preserving essential information for compliance and historical reference.

Key Changes

New Features

• cleanup_escrow(escrow_id) - New public message allowing any participant or admin to clean up a completed escrow
• get_escrow_summary(escrow_id) - New query to retrieve summary information for cleaned-up escrows

Validation Rules

• Can only clean up escrows with status Completed, Released, or Refunded
• Cannot clean up active escrows (Pending, InProgress, Disputed)

Performance Impact

• Storage Savings: ~85-90% reduction per completed escrow (average ~4KB → ~500 bytes)
• Expected Gas Reduction: ~60% reduction in storage costs for completed escrows
• Projected Savings: Estimated 100+ NEAR/month for typical usage patterns

Testing

• Unit tests for cleanup validation scenarios
• Integration tests verifying data removal and preservation
• Storage measurement tests confirming savings targets
• Edge cases: duplicate cleanup attempts, unauthorized actors, invalid escrow IDs

[nanaf6203-bit]

Tight, focused cleanup on the escrow error surface and a small staking test follow-up. Easy to review. Merging. ✅

[nanaf6203-bit]

🟡 Holding for author coordination. This PR and #677 both modify the same files (contracts/escrow/src/errors.rs, lib.rs, types.rs, plus Cargo.lock), which is why the clean merge fails. The diff itself looks good — small, focused. Please rebase onto current main (which already includes #677 once it lands) or coordinate with the #677 author so the two changes can coalesce cleanly. Happy to merge immediately after.

[nanaf6203-bit]

@Nabeelahh

[nanaf6203-bit]

🚧 The escrow analytics field + EscrowAnalytics::Default impl looks clean, but the branch has merge conflicts with main right now, so I cant land it cleanly. Could you rebase onto main (or pull in the latest changes) and ping me when its green? I will approve and merge once conflicts are resolved. Closes #511 once it lands.