chore: resolve integration testing, API documentation, event reconcil…

[DokaIzk]

feat: resolve integration testing, API documentation, event reconciliation, and toolchain versioning issues

• Contracts: Add test_withdraw_auto_divest_liquidity_path in contracts/vault/src/test.rs to verify atomic divestment and liquidity returns during large withdrawals.
• Backend: Add swagger-jsdoc and swagger-ui-express packages and configure Swagger UI to serve API documentation at /docs in non-production environments.
• Event Indexer: Expose pollEvents and update it to propagate errors. Implement logic to decode deposit/withdraw Soroban events, maintain VaultState and SharePriceSnapshot in database transactions, schedule the recurring positionReconciliation background job, and expose lastIndexedLedger in /health.
• Toolchain: Create docs/DEPLOYMENT.md defining pinned versions (stellar-cli@v23.0.1, rust 1.79.0, wasm32 target), link it in README.md, and add pre-flight CLI/compiler checks in scripts/deploy_contracts.sh.

Closes #808
Closes #810
Closes #817
Closes #824

[drips-wave]

@DokaIzk 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