NEARBuilders / NEARBuilders/everything-dev

v2-platform: 12 pre-spawned sandbox pool — wildcard DNS/TLS, sleep-on-idle, workshop loop

Open
#286 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

ready-for-agent
Dominant language
TypeScript
Stars
5
Forks
6
Avg merge
1m
Merged PRs (30d)
1

Description

Parent

#274 (v2 platform services spec)

What to build

The pre-spawned sandbox pool: manually deployed machines (Fly or Hetzner — decided by cost/boot profile here) from the sandbox image, behind wildcard DNS + free wildcard TLS (DNS-only CNAME + ACME-challenge delegation to the machine host), mapped to <near-id> subdomains, with sleep-on-idle so idle sandboxes cost ~nothing. No orchestrator, no spawn dashboard — just enough pool for the workshop/demo loop: a wallet-holder deploys, and their sandbox URL updates within seconds. The alchemy program gains the machines + DNS resources (buckets already exist from the storage ticket).

Acceptance criteria

  • N sandbox machines run the sandbox image, each serving its account's subdomain over HTTPS
  • A deploy + publish from a fresh wallet is live at the account's sandbox URL within seconds
  • Idle machines sleep and wake on request without losing state
  • Machine + DNS resources are declared in the alchemy program alongside the buckets
  • The workshop loop (edit → deploy → refresh → see changes) is demonstrated end-to-end with a non-technical participant

Blocked by

  • #285 (sandbox image)

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read parent issue #274 and blocked issue #285 first, then locate the alchemy program where the existing buckets are declared. Determine the machine provider, wildcard DNS/TLS setup, and sleep/wake flow from the specification. Done means the acceptance criteria pass, including the end-to-end workshop demonstration with a non-technical participant.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
cloud, devops, infrastructure
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.