一键导入
cardano-devnet-in-a-box
"One-command local rehearsal stack: cardano-node + hydra + ogmios + kupo. Docker-based, deterministic green/red testing."
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
菜单
"One-command local rehearsal stack: cardano-node + hydra + ogmios + kupo. Docker-based, deterministic green/red testing."
用 Codex 或 Claude 帮你安装 复制这段 Prompt,粘贴到 Codex、Claude 或其他助手里,让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Read-only wallet state via cardano MCP: balances, addresses, and UTxOs. Requires a configured cardano MCP server.
Retrieve ADAHandle identities ($handle) for the connected wallet via cardano MCP. Read-only.
Query staking delegation status and available rewards via cardano MCP. Read-only, no delegation changes.
Sign and submit pre-built Cardano transactions via cardano MCP. High-risk: requires structured preview and explicit user confirmation.
"Aiken workflows: validators, building, blueprints, .plutus generation. Safe guidance for smart contract development."
"Diagnose cardano-cli: version, era-prefixed vs legacy syntax, network flags. Produces compatibility report."
| name | cardano-devnet-in-a-box |
| description | One-command local rehearsal stack: cardano-node + hydra + ogmios + kupo. Docker-based, deterministic green/red testing. |
| metadata | {"openclaw":{"emoji":"📦","requires":{"bins":["docker","docker-compose","git"]},"install":[{"id":"brew","kind":"brew","formula":"colima docker docker-compose curl git","bins":["colima","docker","docker-compose","curl","git"],"label":"Install Docker runtime (Colima) + Docker CLI + Compose + curl + git (brew)","os":["darwin","linux"]}]}} |
You are setting up a local, end-to-end rehearsal environment so we can:
…all locally before anyone even thinks about mainnet.
This skill uses Hydra’s official demo devnet as the base (because it’s the most “known-good” path), then bolts on Ogmios + Kupo as extra services.
Hydra’s docs describe this demo setup: a single fast local devnet + 3 Hydra nodes (Alice/Bob/Carol) + hydra-tui.
Kupo’s Docker image docs show the minimal container flags we reuse (--node-socket, --node-config, --host, --workdir).
Hydra publishes official Docker images at ghcr.io/cardano-scaling/hydra-node.
git is available.devnet-in-a-box/Run:
cd devnet-in-a-box
chmod +x run.sh
./run.sh up
This will:
cardano-scaling/hydra into devnet-in-a-box/.vendor/hydradocker-compose.override.yml into hydra/demo/./prepare-devnet.sh (creates the devnet/ folder + fresh genesis start time)./seed-devnet.sh (publishes Hydra scripts + funds parties)cardano-nodehydra-node-1..3ogmioskupodevnet-in-a-box/Create it by copying these exact files from the skill repo:
devnet-in-a-box/run.shdevnet-in-a-box/docker-compose.override.ymldevnet-in-a-box/README.md(They’re designed to be dropped into any project.)
ws://localhost:1337http://localhost:1442http://localhost:4001http://localhost:4002http://localhost:4003./devnet-in-a-box/run.sh up
In 3 terminals:
./devnet-in-a-box/run.sh tui 1
./devnet-in-a-box/run.sh tui 2
./devnet-in-a-box/run.sh tui 3
Then inside the TUI:
[i] init[c] commitHydra’s docs walk through this flow.
From the demo directory (the script handles paths for you), you can query the chain tip:
./devnet-in-a-box/run.sh logs cardano-node
Or directly:
cd devnet-in-a-box/.vendor/hydra/demo
docker compose exec -T cardano-node cardano-cli query tip --testnet-magic 42 --socket-path /devnet/node.socket
Typical dApp stack:
This is the pair most “realistic” apps use for local integration tests.
For a no-vibes end-to-end check, run:
cd devnet-in-a-box
./run.sh rehearsal
It will:
If everything works you get GREEN. Otherwise you get RED and the failing step.
Lightweight health check:
./run.sh smoke
TraceNoLedgerView in cardano-node logsThat’s almost always a genesis start time drift.
Fix: rerun prepare + restart the node.
cd devnet-in-a-box/.vendor/hydra/demo
./prepare-devnet.sh
docker compose up -d --force-recreate cardano-node
Hydra docs explicitly warn about waiting too long after prepare-devnet.sh.
Usually permissions on devnet/node.socket.
The run.sh tries to chmod a+w the socket from inside the container.
If it still fails:
cd devnet-in-a-box/.vendor/hydra/demo
docker compose exec -u root cardano-node chmod a+w /devnet/node.socket
Make sure we’re indexing something.
We default to --match "*" for devnet so it indexes everything.
If you change it, you can accidentally index zero addresses.
This devnet harness is for rehearsals: