Redesign sandbox environment to containerized per-user ephemeral instances

[Smartdevs17]

Context

The sandbox is a shared Stellar testnet environment where users interfere with each other's test data and contract state.

Current Limitation/Problem

Shared sandbox means users can see and affect each other's subscriptions. One user's reset wipes all data for everyone.

Expected Outcome

Per-user ephemeral sandbox instances spun up on demand via Docker API, with pre-seeded test data, 1-hour TTL, and automatic cleanup.

Acceptance Criteria

• User requests sandbox via dashboard -> orchestrator provisions Docker container with full stack
• Pre-seeded test data: 5 sample plans, 10 mock subscribers, 20 sample invoices
• Sandbox TTL: 1 hour default, extendable to 4 hours (one 2h extension allowed)
• Auto-cleanup: TTL expiry triggers container teardown and named volume removal
• Resource limits: 512MB RAM, 1 CPU, 2GB disk per sandbox
• Stellar testnet funding: automated friendbot funding on provision
• Edge case: user hits max concurrent sandboxes (3) -> error with wait time estimate
• Edge case: idle timeout (30 min no requests) -> warn user, extend dialog

Technical Scope

• sandbox/orchestrator/ - Docker API orchestration service (Node.js/TypeScript)
• sandbox/docker-compose.sandbox.yml - sandbox stack template
• sandbox/seed/ - seed data SQL and contract deployment scripts
• backend/sandbox/controller/ - sandbox lifecycle REST API
• sandbox/cleanup-worker/ - TTL checker and cleanup cron
• developer-portal/ - Sandbox management page with provision button

[deslawson]

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

i can handle this issue

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

[Junman140]

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

I would want to work on this project because ive being contributing to pi network and stellar for 6 years now and i use mainly typescript, rust and javascript

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

[alamuoyeemmanuel7-create]

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

Hello please I'd like to work on this issue

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

[drips-wave]

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

🧑‍💻 @deslawson: 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 🌊