mochi-local-sandbox

Bring up and use a Mochi-managed local Iroha sandbox plus its local Torii MCP endpoint. Use when Codex needs a reliable local devnet, needs to print or verify the `codex mcp add mochi-local --url ...` command, or should consume the generated `.env.local` and `.mochi/generated/*` bootstrap files for local-only development.

Jump to install

Repository: hyperledger-iroha/iroha
Last source activity: May 5, 2026 at 13:01
Detected SKILL.md language: English
Stars: 488
Forks: 286

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/hyperledger-iroha/iroha --skill mochi-local-sandbox

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

2 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

Mochi Local Sandbox

Use Mochi as the local Iroha devnet launcher and MCP bridge.

Quick Start

Start the sandbox from the target workspace:

scripts/mochi_local_sandbox.sh up
Use MOCHI_WORKSPACE_ROOT=/path/to/app when the current shell is not already in the app workspace.
Use MOCHI_PROFILE=four-peer-bft when the user wants the four-validator rehearsal instead of the default single-peer.

Confirm the sandbox is healthy:

scripts/mochi_local_sandbox.sh status
Healthy means status: ready, ready: true, and mcp_ready: true.
stale-session means session.json exists but the detached Mochi process is gone; inspect serve.log and rerun up or reset.

If Codex needs the local MCP endpoint, print the exact add command:

scripts/mochi_local_sandbox.sh mcp-add-command

Use the workspace bootstrap artifacts:

.env.local
.mochi/generated/typescript/connect.ts
.mochi/generated/rust/connect.rs
.mochi/generated/kotlin/MochiConnect.kt

Working Rules

Prefer Mochi's curated local iroha.* MCP tools. Do not prefer raw torii.* tools when the local MCP surface is healthy.

Treat .env.local, session.json, and any generated IROHA_PRIVATE_KEY value as runtime-only local-dev material. Do not commit them or copy them into permanent docs.

Use scripts/mochi_local_sandbox.sh env when you need copy/paste shell exports for a local app.

Use scripts/mochi_local_sandbox.sh reset when the local chain must be wiped and regenerated.

Expect generated local configs to enable [torii.mcp] with the curated writer profile and [torii.transport.norito_rpc] with enabled = true, require_mtls = false, and stage = "ga".

If up fails, inspect:

scripts/mochi_local_sandbox.sh status
<workspace>/.mochi/sandbox/<profile>/serve.log
<workspace>/.mochi/sandbox/<profile>/session.json when it exists
<workspace>/.mochi/sandbox/<profile>/serve.pid when status reports stale-session

If readiness smoke fails, treat serve.log as authoritative. The smoke path updates metadata on the existing wonderland.universal domain and confirms commit through block/event streams plus HTTP transaction-status fallback.

If the user wants a custom non-preset profile, prefer the GUI or direct mochi sandbox serve flow instead of stretching the helper script beyond single-peer and four-peer-bft.

Response Pattern

Bring the sandbox up if the user asked to test or use the local env and it is not already ready.

Report the exact local MCP add command when Codex or the user needs it.

Base app wiring advice on .env.local and .mochi/generated/*, not on ad-hoc handwritten env snippets.

Keep local sandbox guidance clearly separated from live-network guidance such as Taira.