feat: Gas Optimization and Performance Improvements

[walterthesmart]

Description

This pull request implements comprehensive gas optimization techniques and performance improvements across the smart contracts, specifically modifying how large state objects are loaded. It converts highly iterated vectors inside property tokens into lazy-loaded mappings, eliminating excessive gas burning related to state reads/writes. This limits excessive token wastage when modifying the property's compliance and document mappings.

Closes #46

Changes Made

• Storage Layout Optimization: Migrated legal_documents and ownership_history in contracts/property-token from Vec types into lazily-evaluated Mapping tuples mapping a token and incrementing u32 index to its respective data to sidestep massive read/write gas overhead.
• Batch Processing: Introduced batch_register_properties in contracts/property-token/src/lib.rs for consolidated bulk iterations of property registrations natively within the chain, saving cross-contract invocation gas.
• Gas Recommendation Scripts: Implemented scripts/gas_analysis.sh utilizing cargo contract compiler heuristics and output analysis to maintain size and baseline execution size baselines.
• Benchmarking: Implemented scripts/performance_benchmark.sh leveraging our test-suites and standard time markers for macro throughput.
• Documentation: Formulated best practices guide docs/gas_optimization_best_practices.md on token retention during cross-contract executions and state updates.
• CI Fixes: Passed cargo fmt and cargo clippy, rectifying a clippy::identity_op warning inside security-audit/src/main.rs.

Checklist

• Analyze and optimize gas usage for all contract functions
• Implement batch operations for multiple property transactions
• Add gas estimation and recommendation system
• Optimize storage layout and data structures
• Implement lazy loading for expensive operations
• Add gas usage monitoring and alerting
• Create gas optimization best practices guide
• Include performance benchmarking and reporting
• Run locally and satisfy CI validation targets (cargo test, fmt, clippy)