localnet

Starts and debugs the Boundless docker compose localnet for testing proof requests.

Updated Apr 11, 2026
One-click install
npx skills add https://github.com/Current-cmd/TrustMeBRO --skill localnet-current-cmd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: localnet
Source: https://github.com/Current-cmd/TrustMeBRO/tree/main/.claude/skills/localnet
Command: npx skills add https://github.com/Current-cmd/TrustMeBRO --skill localnet-current-cmd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up a local development network for the Boundless proving protocol involves coordinating anvil, postgres, minio, order-stream, and broker services, and misconfigured request pricing or environment variables cause orders to stall without obvious errors. ## Core Features & Use Cases - Guided Localnet Startup: Walks through starting the docker compose localnet in dev mode (fake proofs, broker included) or full proving mode (real proofs with a separate Bento prover cluster). - Test Request Submission: Submits proof requests with correctly tuned min-price, max-price, and bidding-start parameters so the broker accepts them immediately. - Order Status Debugging: Queries the order-stream API, broker logs, and on-chain state to trace when a request was submitted, locked, and fulfilled, plus the fulfilled price. - Use Case: A developer testing a new Boundless integration starts the localnet in dev mode, submits an echo request, and confirms the full order lifecycle completes before deploying to a real network. ## Quick Start Start the Boundless localnet in dev mode and submit a test proof request, then show me its status.

Frequently Asked Questions about localnet

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

FAQPage Schema
How do I start the Boundless localnet for local testing?▼

Run RISC0_DEV_MODE=1 just localnet in the foreground for dev mode, which starts anvil, postgres, minio, order-stream, and the broker together. Wait for contract deployment to finish before submitting requests.

How do I submit a test proof request to the localnet?▼

Source .env.localnet and run cargo run --example submit_echo with --bidding-start set to now, --min-price 0.0001 ETH, and --max-price 0.0004 ETH. The min-price must exceed the broker's gas cost threshold for immediate acceptance.

What is the difference between dev mode and full proving mode?▼

Dev mode uses RISC0_DEV_MODE=1 with fake proofs and includes the broker in the compose cluster. Full proving mode uses real proofs, excludes the broker, and requires starting a separate Bento prover cluster with just prover.

Why is my Boundless request stuck at Unknown status?▼

Check order-stream logs to confirm it received the order. If logs show the order broadcast to 0 clients, the broker is not connected to the WebSocket, so verify the broker container is running with the dev-broker profile.

Why does the broker delay locking my request?▼

The broker waits until the auction price exceeds its minimum profitable price of gas costs plus min_mcycle_price. Set --min-price above roughly 0.0001 ETH on anvil so the broker accepts immediately before the price ramp begins.