P0-3 · Saldo real de wallet del usuario (consulta Horizon directo desde frontend)

[ericmt-98]

Que esta roto

GET /account/balance devuelve el saldo de la wallet de plataforma (PLATFORM_SECRET_KEY), no la del usuario. Todos los usuarios ven el mismo numero. El keypair real del usuario (lib/keystore.ts) nunca se consulta para mostrar saldo.

Decision de implementacion

MicoPay es no-custodial. El saldo de una cuenta Stellar es informacion publica — no debe proxearse por el backend. El frontend consulta Horizon directamente con la llave publica del dispositivo:

GET https://horizon-testnet.stellar.org/accounts/<stellar_address>
→ .balances[] → filtrar por asset_code === 'MXNe' && asset_issuer === VITE_MXNE_ISSUER_ADDRESS

La llave publica ya esta disponible en el dispositivo via getPublicKey() (lib/keystore.ts).
VITE_MXNE_ISSUER_ADDRESS ya esta en .env y .env.testnet.

El backend no cambia. GET /account/balance queda deprecado.

Que construir

Un hook useWalletBalance en micopay/frontend/src/hooks/ que:

1. Llama a getPublicKey() para obtener la direccion Stellar del dispositivo.
2. Hace fetch a Horizon con esa direccion.
3. Filtra el balance de MXNe usando VITE_MXNE_ISSUER_ADDRESS.
4. Maneja el caso de cuenta no fondeada (Horizon 404) mostrando "0.00 MXNe" sin crash.
5. Maneja el caso de Horizon inaccesible con un fallback de carga.

Reemplazar la llamada a getAccountBalance() en Home.tsx con este hook.

Archivos a tocar

Archivo	Que cambia
micopay/frontend/src/hooks/useWalletBalance.ts	Nuevo hook (Horizon directo)
micopay/frontend/src/pages/Home.tsx	Usar useWalletBalance en lugar de getAccountBalance()

Criterio de aceptacion

• La pantalla principal muestra el saldo MXNe real de la direccion Stellar del usuario actual.
• Si la cuenta no esta fondeada (Horizon 404), muestra "0.00 MXNe" sin crash.
• Si Horizon no responde, muestra un estado de carga o "--" — no un error que rompe la pantalla.
• No se modifica ningun archivo del backend.
• tsc --noEmit pasa sin errores.

Notas

• No usar getAccountBalance() de services/api.ts — ese endpoint devuelve el saldo de la plataforma.
• El asset a mostrar es MXNe. Verificar asset_code === 'MXNe' y asset_issuer === import.meta.env.VITE_MXNE_ISSUER_ADDRESS al filtrar .balances[].
• Horizon testnet: https://horizon-testnet.stellar.org/accounts/<address>

Delivery: abre un PR que modifique los archivos listados. El maintainer revisara y mergeara.

[TheShnider]

@TheShnider has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

I would like to work on this

ℹ️ Repo Maintainers: To accept this application, review their application or assign @TheShnider to this issue.

[Menjay7]

@Menjay7 has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi! I came across this issue and would love to work on it. I have experience with similar tasks and I'm confident I can investigate, implement a clean solution, and thoroughly test it before submitting a PR. If the issue is still open, I would appreciate it if you could assign it to me. Thank you!

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Menjay7 to this issue.

[OpensrcLord]

@Zeemnew has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello @maintainer, I’ve gone through the requirements and I’m confident I can implement a proper solution that matches the acceptance criteria. Kindly assign this issue to me. And I will deliver at the shortest possible time.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Zeemnew to this issue.

[Oluwasuyi-Oluwatimilehin-Daniel]

@Oluwasuyi-Timilehin has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello maintainer, please assign me to this task. I would get started immediately

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Oluwasuyi-Timilehin to this issue.

[jaynomyaro]

@jaynomyaro has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi! I’m a full-stack developer with a strong blockchain background. I’d love to handle this issue and can deliver a clean, reliable solution. Kindly assign it to me.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @jaynomyaro to this issue.

[Peaostrel]

@Peaostrel has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

i can handle this quickly

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Peaostrel to this issue.

[Olamidepy]

@Olamidepy has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hola, mantenedor:

Me gustaría ser asignado a este issue.

Soy desarrollador Full-Stack y también exploro activamente el desarrollo blockchain y los contratos inteligentes, lo que ha fortalecido mis habilidades para resolver problemas y mantener un alto estándar de calidad en el código.

Después de revisar el issue, considero que puedo contribuir de manera efectiva y entregar una solución bien probada que cumpla con los estándares esperados del proyecto.

Tiempo estimado (ETA): 6 horas.

Muchas gracias por considerar mi solicitud.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Olamidepy to this issue.

[chinecherem58]

@chinecherem58 has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello, I have years of experience working on tasks like this and handling similar challenges across backend, frontend, and smart-contract development. I have carefully read and fully understood the task requirements, and I am confident I can deliver a clean, efficient, and well-tested solution promptly. I always ensure high-quality implementation, maintainability, and adherence to best practices.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @chinecherem58 to this issue.

[midexol]

@midexol has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi maintainer, I'd like to work on this task. Please assign

ℹ️ Repo Maintainers: To accept this application, review their application or assign @midexol to this issue.