// 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.
| name | mochi-local-sandbox |
| description | 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. |
Use Mochi as the local Iroha devnet launcher and MCP bridge.
scripts/mochi_local_sandbox.sh upMOCHI_WORKSPACE_ROOT=/path/to/app when the current shell is not already in the app workspace.MOCHI_PROFILE=four-peer-bft when the user wants the four-validator rehearsal instead of the default single-peer.scripts/mochi_local_sandbox.sh statusstatus: 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.scripts/mochi_local_sandbox.sh mcp-add-command.env.local.mochi/generated/typescript/connect.ts.mochi/generated/rust/connect.rs.mochi/generated/kotlin/MochiConnect.ktiroha.* MCP tools. Do not prefer raw torii.* tools when the local MCP surface is healthy..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.scripts/mochi_local_sandbox.sh env when you need copy/paste shell exports for a local app.scripts/mochi_local_sandbox.sh reset when the local chain must be wiped and regenerated.[torii.mcp] with the curated writer profile and [torii.transport.norito_rpc] with enabled = true, require_mtls = false, and stage = "ga".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-sessionserve.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.mochi sandbox serve flow instead of stretching the helper script beyond single-peer and four-peer-bft..env.local and .mochi/generated/*, not on ad-hoc handwritten env snippets.Build connect_norito_bridge native .so files from Rust source. Use when user says "build native", "build .so", "rebuild native libs", "update native bridge", or "cargo ndk build".
Use native Torii MCP on deployed Iroha networks such as Taira and future Nexus endpoints for live account, asset, contract, governance, and transaction workflows.
Work against the SORA Minamoto mainnet through its deployed Torii MCP endpoint for live account, asset, alias, contract, governance, Musubi package-registry, and transaction workflows. Use when Codex needs to inspect Minamoto mainnet, verify or add `https://minamoto.sora.org/v1/mcp`, prefer the curated `iroha.*` tool surface, classify Minamoto ingress and chain-health failures correctly, or handle runtime-only signing inputs such as `authority` and `private_key`.
Work against the SORA Taira testnet through its deployed Torii MCP endpoint for live account, asset, alias, contract, governance, Musubi package-registry, and transaction workflows. Use when Codex needs to inspect or mutate the Taira testnet, verify or add `https://taira.sora.org/v1/mcp`, prefer the curated `iroha.*` tool surface, classify Taira ingress and chain-health failures correctly, or handle runtime-only signing inputs such as `authority` and `private_key`.