Feature: Add Wallet Status Balance and History API

[3m1n3nc3]

Description

Expose safe wallet status, public address, exact supported balances, and paginated history.

File Location

Wallet controller/routes/schemas/service, Stellar service, DTOs, and tests

Design Reference

API Roadmap Phase 1: Add Wallet Status Balance and History API.

Dependencies

• Status: Blocked
• Blocked by: Feature: Add Custodial Wallet Persistence and KMS References #135 (Add Custodial Wallet Persistence and KMS References); Feature: Implement Sponsored Stellar Account Funding #91 (Implement Sponsored Stellar Account Funding) — done; Feature: Standardize API Contracts Pagination and Versioning #61 (Standardize API Contracts Pagination and Versioning) — done
• Blocks: Feature: Add Identity Profile Wallet Integration Test Suite #137 (Add Identity Profile Wallet Integration Test Suite)

Tasks

• Add current-user wallet status/address endpoint
• Add supported balance response with asset/issuer/exact amount/source time
• Add stable paginated history with direction, status, amount, hash, ledger, and memo policy
• Normalize Horizon timeout/unavailable/stale behavior
• Prevent arbitrary address lookup
• Test auth, precision, pagination, provider failure, and redaction

Acceptance Criteria

• Only owner wallet is exposed
• Amounts retain exact precision/asset identity
• Pending/failed does not appear as zero balance
• Pagination is stable
• Tests/OpenAPI pass

Verification Evidence

• Attach redacted endpoint examples and Horizon auth/precision/failure tests

Difficulty

Advanced