sandbox

Manage a Dockerized sandbox for NEAR Treasury end-to-end testing.

8|12|Updated Dec 9, 2025
One-click install
npx skills add https://github.com/NEAR-DevHub/treasury26 --skill sandbox-near-devhub
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sandbox
Source: https://github.com/NEAR-DevHub/treasury26/tree/main/.agents/skills/sandbox
Command: npx skills add https://github.com/NEAR-DevHub/treasury26 --skill sandbox-near-devhub

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the setup and management of the local development environment required for running end-to-end tests, ensuring a consistent and reliable testing process.

Core Features & Use Cases

  • Sandbox Management: Start, stop, restart, and check the status of the Dockerized sandbox environment.
  • Dependency Setup: Provides a self-contained NEAR blockchain, Treasury backend API, Sputnik indexer, and PostgreSQL database.
  • Use Case: Before running Playwright end-to-end tests for the treasury management platform, use this Skill to ensure the sandbox is running and healthy.

Quick Start

Start the E2E test sandbox environment.

Frequently Asked Questions about sandbox

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a local NEAR blockchain environment for E2E testing?

You can set up a local NEAR blockchain test environment by starting a Dockerized sandbox that includes the blockchain, Treasury backend API, Sputnik indexer, and PostgreSQL database. The sandbox manages starting, stopping, and health checks for your E2E tests.

What components are included in the NEAR Treasury sandbox environment?

The NEAR Treasury sandbox environment includes a local NEAR blockchain, Treasury backend API, Sputnik indexer, and a PostgreSQL database. These components run together in Docker to provide a self-contained testing setup.

Do I need Docker to run the NEAR Treasury testing environment?

Yes, Docker is required to run the NEAR Treasury testing environment. The sandbox uses Docker to containerize the local NEAR blockchain, Treasury backend API, Sputnik indexer, and PostgreSQL database into one manageable unit.

How do I check if my NEAR sandbox environment is healthy before running tests?

You can check the health status of your NEAR sandbox environment using the sandbox management commands provided. This verifies that the local NEAR blockchain, Treasury backend API, Sputnik indexer, and PostgreSQL database are all running properly before E2E tests.

Can I restart the NEAR blockchain sandbox without losing my testing setup?

Yes, the sandbox supports restarting the environment while maintaining the same Dockerized setup. This allows you to reset the local NEAR blockchain, Treasury backend API, Sputnik indexer, and PostgreSQL database state between test runs.

Why does my NEAR Treasury end-to-end testing fail on startup?

E2E testing failures often occur when the sandbox environment is not running or healthy. Ensure you start the Dockerized sandbox containing the local NEAR blockchain, Treasury backend API, Sputnik indexer, and PostgreSQL database before executing Playwright tests.