菜单
Start or restart the E2E test sandbox (NEAR blockchain + Treasury backend + PostgreSQL). Required before running Playwright E2E tests.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | sandbox |
| description | Start or restart the E2E test sandbox (NEAR blockchain + Treasury backend + PostgreSQL). Required before running Playwright E2E tests. |
| argument-hint | [start|stop|restart|status] |
Manages the Docker sandbox container needed for Playwright E2E tests. The sandbox provides a local NEAR blockchain, the Treasury backend API, a Sputnik DAO indexer, and PostgreSQL — all in a single container.
/sandbox or /sandbox start — Start the sandbox (pull latest image, stop conflicts, run)/sandbox stop — Stop and remove the sandbox container/sandbox restart — Stop then start/sandbox status — Check if sandbox is running and healthyThe sandbox needs ports 3030, 8080, and 5001. Stop any conflicting processes first:
# Check what's on port 8080
lsof -i :8080 -P -n
# If the nt-be dev backend or postgres dev container is running, stop it:
docker stop nt-be-postgres-1 2>/dev/null || true
# Kill any node/cargo process on 8080 if needed
kill $(lsof -t -i :8080) 2>/dev/null || true
# Pull latest sandbox image (public, no auth needed)
docker pull ghcr.io/near-devhub/trezu/near-treasury-sandbox:main
# Remove any previous sandbox container
docker rm -f sandbox 2>/dev/null || true
# Start the sandbox
docker run -d --name sandbox \
-p 3030:3030 -p 8080:8080 -p 5001:5001 \
--health-cmd "curl -f http://localhost:8080/api/health || exit 1" \
--health-interval 10s \
--health-timeout 5s \
--health-retries 30 \
--health-start-period 120s \
ghcr.io/near-devhub/trezu/near-treasury-sandbox:main
The sandbox takes 60-120 seconds to fully initialize (NEAR blockchain genesis, contract deployment, database migrations).
echo "Waiting for sandbox to be healthy..."
for i in $(seq 1 60); do
if curl -sf http://localhost:8080/api/health > /dev/null 2>&1; then
echo "Sandbox is ready!"
break
fi
echo "Attempt $i: Not ready yet..."
sleep 5
done
Verify with:
curl -s http://localhost:8080/api/health
docker inspect sandbox --format='{{.State.Health.Status}}'
cd nt-fe
BACKEND_URL=http://localhost:8080 npx playwright test
docker stop sandbox && docker rm sandbox
| Port | Service | Description |
|---|---|---|
| 3030 | NEAR RPC | Local NEAR blockchain JSON-RPC |
| 8080 | Treasury API | Backend REST API |
| 5001 | Sputnik Indexer | DAO proposal caching |
The sandbox image is built automatically by CI and pushed to:
ghcr.io/near-devhub/trezu/near-treasury-sandbox:main
PR-specific images are tagged as pr-<number> when available.
docker logs sandbox for errorsnt-be-postgres-1) or any process on port 8080Build a custom proposal template for trezu / a SputnikDAO on NEAR — a JSON "manifest" that becomes a reusable form members fill to file a FunctionCall proposal. Use when someone wants a repeatable proposal form (recurring payment, token mint, contract call, set a value) and needs the manifest JSON to paste into trezu. Self-contained; no repo access needed.
Manage Goldsky secrets for pipeline sink credentials. Use when creating secrets for PostgreSQL, ClickHouse, Kafka, or other sinks, or when managing existing secrets.
Manage Turbo pipeline lifecycle - list, delete, pause, resume, restart pipelines. Use when listing pipelines, deleting pipelines, pausing/resuming, restarting, or managing pipeline state.
Monitor and debug Turbo pipelines. Use when viewing logs, inspecting live data, troubleshooting pipeline issues, or checking pipeline health.
Create, configure, and update Turbo pipelines. Use for deploying new pipelines, modifying existing ones, understanding YAML syntax, or troubleshooting configuration.
Write and understand SQL transforms for Turbo pipelines. Use when decoding EVM logs, filtering events, casting types, chaining transforms, combining data with UNION ALL, or building complex data processing logic.