Add mobile vault capability gate

[Brainoncrack]

Description

Difficulty: Expert

Type: Feature

Summary

Gate vault UI actions based on available SDK or contract capabilities.

Current Behaviour

Users may see vault actions that are not supported by the current SDK or contract state.

Expected Behaviour

The app should disable or hide unsupported actions with clear explanations.

Suggested Implementation

Add a capability check layer for deposit, withdrawal, lock creation, and matured-lock withdrawal.

Files or Areas Likely Affected

app/
src/features/vault/
src/utils/
docs/

Acceptance Criteria

• Capability gate is added.
• Unsupported actions are disabled or hidden.
• User-facing explanation is shown.
• SDK capability assumptions are documented.
• Fallback UI is provided.

Additional Notes

This prevents feature-readiness confusion.

[Myart352]

Hi! I'd like to work on #331 – Add mobile vault capability gate.

I'll implement a capability-check layer that determines which vault actions are supported by the current SDK and contract state before they are presented to users. Deposit, withdrawal, lock creation, and matured-lock withdrawal actions will be gated appropriately, ensuring unsupported functionality is either disabled or hidden with clear, user-friendly explanations instead of allowing users to encounter unsupported flows.

I'll integrate the capability checks into the existing vault UI, provide graceful fallback states, and document the SDK capability assumptions to make future maintenance straightforward. I'll also add focused tests covering supported and unsupported capability combinations, UI behavior, and fallback scenarios to ensure the feature is reliable and easy to review.

I'd be happy to take on this issue.

[grantfox-oss]

🦊 GrantFox — @Myart352 has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #331)
2. Your PR will be reviewed by the Axionvera maintainers

Good luck! Track your progress on GrantFox.