How to use the Boundless CLI — the primary interface for the Boundless ZK proof marketplace. Covers requestor, prover, and rewards commands, config, env vars, and the monorepo structure. Use when working with the boundless CLI, submitting proofs, managing provers, staking rewards, or navigating the codebase.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
The boundless CLI is the primary interface for the Boundless protocol — a decentralized marketplace for zero-knowledge proofs built on RISC Zero's zkVM. It connects requestors (who need ZK proofs) with provers (who generate proofs for rewards). The protocol runs on Base (L2) with staking/rewards on Ethereum (L1).
boundless requestor setup # Interactive setup wizard
boundless requestor config # Show configuration status
boundless requestor submit # Submit a proof request (offer + input + image)
boundless requestor submit-file # Submit a proof request from a YAML file
boundless requestor status # Check request status
boundless requestor get-proof # Download proof journal and seal
boundless requestor verify-proof # Verify a completed proof
boundless requestor deposit # Deposit funds into the market
boundless requestor withdraw # Withdraw funds from the market
boundless requestor balance # Check deposited balance
boundless prover setup # Interactive setup wizard
boundless prover config # Show configuration status
boundless prover deposit-collateral # Deposit collateral
boundless prover withdraw-collateral # Withdraw collateral
boundless prover balance-collateral # Check collateral balance
boundless prover lock # Lock a request
boundless prover fulfill # Fulfill proof requests
boundless prover execute # Execute proof via zkVM
boundless prover benchmark # Run benchmark suite
boundless prover slash # Slash a prover for failed request
boundless prover generate-config # Generate broker/compose configs
boundless rewards setup # Interactive setup wizard
boundless rewards config # Show configuration status
boundless rewards stake-zkc # Stake ZKC tokens
boundless rewards balance-zkc # Check ZKC balance
boundless rewards staked-balance-zkc # Check staked ZKC balance
boundless rewards epoch # Get current epoch info
boundless rewards power # Check reward power
boundless rewards prepare-mining # Prepare mining work log
boundless rewards submit-mining # Submit mining work updates
boundless rewards claim-mining-rewards # Claim mining rewards
boundless rewards claim-staking-rewards # Claim staking rewards
boundless rewards delegate # Delegate rewards
boundless rewards get-delegate # Get current delegate
boundless rewards list-staking-rewards # List staking rewards by epoch
boundless rewards list-mining-rewards # List mining rewards by epoch
boundless rewards inspect-mining-state # Inspect mining state file
Config is stored in ~/.boundless/:
config.toml — public config (selected networks, custom deployments)secrets.toml — private config (RPC URLs, private keys), 0600 permissionsPrecedence (highest to lowest):
REQUESTOR_RPC_URL)~/.boundless/secrets.toml, config.toml)Setup wizards configure everything interactively:
boundless requestor setup
boundless prover setup
boundless rewards setup
Tip: Set AWS_EC2_METADATA_DISABLED=true on all boundless commands to avoid 2–4s AWS IMDS timeout warnings on non-EC2 machines.
| Variable | Module | Description |
|---|---|---|
REQUESTOR_RPC_URL | Requestor | RPC endpoint for requestor commands |
REQUESTOR_PRIVATE_KEY | Requestor | Private key for requestor transactions |
PROVER_RPC_URL | Prover | RPC endpoint for prover commands |
PROVER_PRIVATE_KEY | Prover | Private key for prover transactions |
BENTO_API_URL | Prover | Bento/Bonsai API URL |
BENTO_API_KEY | Prover | Bento/Bonsai API key |
REWARD_RPC_URL | Rewards | RPC endpoint for rewards (L1) |
REWARD_PRIVATE_KEY | Rewards | Private key for reward transactions |
STAKING_PRIVATE_KEY | Rewards | Private key for staking (can differ from reward key) |
STAKING_ADDRESS | Rewards | Staking address (read-only) |
MINING_STATE_FILE | Rewards | Path to mining state file |
ZKC_ADDRESS | Rewards | ZKC token contract (has default per network) |
VEZKC_ADDRESS | Rewards | Staked ZKC NFT contract (has default per network) |
STAKING_REWARDS_ADDRESS | Rewards | Rewards distribution contract (has default per network) |
BEACON_API_URL | Rewards | Beacon API URL |
BOUNDLESS_MARKET_ADDRESS | Global | Market contract address (has default per network) |
SET_VERIFIER_ADDRESS | Global | Verifier contract address (has default per network) |
TX_TIMEOUT | Global | Transaction timeout in seconds (default: 300) |
LOG_LEVEL | Global | Log verbosity: error, warn, info, debug, trace |
| Network | ID | Description |
|---|---|---|
| Base Mainnet | base-mainnet | Production market |
| Base Sepolia | base-sepolia | Market testnet |
| Ethereum Mainnet | eth-mainnet | Rewards/staking (L1) |
| Ethereum Sepolia | eth-sepolia | Rewards testnet |
For guided workflows that build on the CLI:
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
Start and interact with the Boundless localnet (docker compose-based local development network). Covers dev mode (fake proofs, broker included) and full proving mode, submitting requests, and debugging order flow. Use when the user wants to start localnet, run the local network, test proof requests locally, or debug broker/order-stream issues.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Internal — for Boundless team members only. Deploy Boundless infrastructure to a new blockchain. Creates Pulumi stacks, config files, updates ChainId enum, and wires CI/CD pipelines for staging and prod environments. Use when adding a new chain, deploying to a new network, or setting up new chain infrastructure.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Internal — for Boundless team members only. Audit native ETH, market deposit, prover collateral, and distributor ZKC reserve balances for every operator-managed address (provers, distributor, order generators, signal). Use when the user wants to know which addresses need topping up, asks about the balance of provers/OGs/distributor/signal signers, says something is "running low" or "out of gas", or wants a periodic operational health check on operator wallets. Defaults to prod env (mainnets + prod testnets) — pass `--all` to also include staging.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Internal — for Boundless team members only. Query the Boundless Indexer REST API for on-chain market data, staking, PoVW rewards, delegations, and market efficiency on prod/staging environments. Use when the user asks about proof requests, provers, requestors, staking data, PoVW rewards, delegations, market aggregates, leaderboards, or wants to fetch data from the indexer API on live networks. Also use when the user mentions "indexer" and wants to look up addresses, requests, or market statistics on deployed environments. Do NOT use for debugging local code changes, reviewing PRs, or investigating issues in the codebase itself.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Internal — for Boundless team members only. Help developers deploy Boundless AWS infrastructure to the dev environment. Use when the user wants to deploy a service to dev, bootstrap their dev environment, troubleshoot infrastructure issues, or understand what env vars a service needs. Also handles teardown and status checks.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Internal — for Boundless team members only. Query AWS CloudWatch logs for Boundless services (provers, slasher, distributor, order stream, order generator, indexer, signal) on prod/staging environments. Use when the user asks to look at service logs, debug service behavior from log output, search logs for a request ID, or investigate errors using CloudWatch. Do NOT use for debugging local code changes, reviewing PRs, or investigating issues in the codebase itself.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.