[huangji6693-max]

Closes #890

Summary

Completes the follow-up items to #776 for the agent vault screen and backend routes:

1. Stroops End-to-End (frontend/lib/money/format.ts & backend/src/controllers/agentMvpController.ts):
   • Parses user input to exact stroops (parseAmount) and displays collateral, float, max float, and remaining headroom formatted from stroops (formatStroops).
   • Accepts exact stroop strings (amountStroops) or decimal amounts in POST /api/agents/vault/:action and invalidates the cached agent dashboard snapshot on POST /api/agents/submit.
2. Vault Headroom & Balances (backend/src/controllers/agentDashboardController.ts & frontend/src/app/components/agent/AgentVaultActions.tsx):
   • Returns collateralStroops, floatStroops, maxFloatStroops, and headroomStroops (max_float - float_balance) from GET /api/agents/dashboard.
   • Renders collateral, float, max float, and remaining headroom cards on the agent vault screen.
3. Operator Cash-In (mint-float) Flow (AgentVaultActions & admin/settlement/page.tsx):
   • Adds mode="operator" on AgentVaultActions and mounts it on the admin settlement page so the operator can record a cash-in (mint_float) for a chosen agent signed with the admin wallet.
4. Contract Error Mapping (backend/src/services/sorobanService.ts & AgentVaultActions.tsx):
   • Maps SolvencyViolated (Error(Contract, #8)) and InsufficientFloat (Error(Contract, #7)) (as well as InsufficientCollateral #6 and MinCollateralViolated #11) from Soroban simulation/submission to clear HTTP 400 error responses and user-facing alerts without relying on a frontend-only pre-check.
5. Post-Action & SSE Event Refresh (frontend/src/app/[locale]/agent/dashboard/page.tsx):
   • Refreshes the agent dashboard after each submitted vault action and when CollateralDeposited, CollateralWithdrawn, FloatMinted, FloatBurned, FloatTransferred, VaultSettled, or HaircutUpdated events arrive on /api/events/stream.

Verification

• Backend unit tests: cd backend && npm test -- src/__tests__/agentMvp.test.ts (17/17 passing)
• Backend typecheck: cd backend && npm run typecheck (0 errors)
• Frontend unit tests: cd frontend && npm test -- AgentVaultActions.test.tsx (5/5 passing)
• Frontend i18n check & typecheck: cd frontend && npm run i18n:validate && npm run typecheck (0 errors)

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

• Source mode: Auto
• Repository: Unavailable
• Branch: Unavailable
• File: No configuration file from this repository applied
• Commit: Unavailable
• Layers: defaults
• Review profile: CHILL
• Plan: Advanced
• Run ID: c8185ba4-da34-4dab-8b4f-626bc30c2cb9

• Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[ExcelDsigN-tech]

Hi @huangji6693-max, please merge the latest main into this branch.

main now requires the Security Gates checks to pass before merge: Trivy filesystem scan, cargo audit, and npm audit for backend, frontend, scripts and sdk (#901, #904, #905, #906). Your branch is 5 commits behind, so these checks have not run against the current rules yet.

git fetch upstream
git merge upstream/main
git push

Please merge rather than rebase or force-push, so review history stays intact. Thanks!

[ExcelDsigN-tech]

Thanks for the work here, @huangji6693-max, and apologies for the earlier note asking you to merge main: I should have checked eligibility first.

DukaPay Wave issues are worked only after applying on the issue through the Wave and being assigned. #890 was never assigned to you, and other contributors applied first, so I'm closing this PR.

If you'd like to contribute, please apply on an open Wave issue and wait for assignment before starting. Thanks for understanding.