Add public readiness endpoint for facilitator and provider configuration

[emrekayat]

Why this matters

SCF demos need to distinguish an unavailable facilitator/provider from a broken product. A public readiness endpoint can expose non-sensitive status for API, x402 facilitator config, and provider availability.

Scope

Add a public readiness endpoint such as /api/readiness returning:

• API uptime/build metadata;
• demo mode status;
• Stellar network label;
• facilitator configured: boolean;
• facilitator supported check status if safe and cached;
• provider counts by mode;
• storage backend status.

Do not return API keys, secret keys, facilitator auth headers, private URLs, or wallet secrets.

Suggested files

• apps/api/src/routes/public.ts
• apps/api/src/lib/config.ts
• apps/api/src/lib/build-metadata.ts
• apps/api/src/lib/storage/index.ts

Acceptance criteria

• Endpoint returns useful non-sensitive readiness JSON.
• Tests verify secret-like config values are not emitted.
• Endpoint works in demo mode without live facilitator credentials.
• Existing /health behavior remains compatible.

[martoniel]

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

Good day Big Dev! Pls I would love to work on this issue carefully and make PR today

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

[Mirabel64]

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

Hello, I'm a fullStack developer with years of experience, I have worked on several projects and I can submit a PR immediately, can I please work on this.

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

[TheWeirdDee]

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

Hi, I'd like to work on this issue because observability and readiness reporting are essential for reliable demos and production systems. A dedicated readiness endpoint will make it easier to diagnose configuration issues, distinguish infrastructure problems from application issues, and improve the developer experience.

I have experience building Node.js/TypeScript APIs, designing health and readiness endpoints, working with configuration management, and implementing secure API responses. I can add a non-sensitive readiness endpoint, ensure secret values are never exposed, maintain compatibility with existing health checks, and add tests to verify the endpoint behaves correctly in both demo and configured environments.

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

[dhareymu]

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

Hi maintainer, deadline is almost here.

I can help you fix the issues on the project swiftly and create a PR for it in no time.

Please kindly assign it to me. I look forward to working with you. Thank you.

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

[dubemoyibe-star]

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

Can I work on this issue

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

[Fury03]

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

Kindly assign

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

[drips-wave]

Congratulations, @dubemoyibe-star! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @dubemoyibe-star: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊