Enabling ZK Mining

To enable PoVW in Bento, first make sure to stop Bento safely. This ensures that any in-progress proving jobs are completed before terminating the proving process. If Bento is backing the Broker, please carry out Step 1 from Safe Upgrade Steps and then return to this page.

Bento and/or broker can be safely stopped with:

just broker down

To install the latest release, and use the helpful setup script, provers can follow the instructions on the Quick Start before continuing with the next step.

Follow the instructions here.

Provers use the Boundless CLI to stake $ZKC, prepare work log updates, and submit them onchain. To install the Boundless CLI (and build with CUDA support), run:

cargo install --locked --git https://github.com/boundless-xyz/boundless boundless-cli --branch release-1.0 --bin boundless

Some commands in this tutorial use cast from the Foundry toolkit. This is not necessary, but it will make some CLI commands more straightforward.

Follow the instructions here.

Run the following:

rzup install risc0-groth16

Before starting Bento again, provers need to enable the ZK mining feature. This requires a valid Ethereum address set to the REWARD_ADDRESS environment variable. It is recommended to set this directly in the compose.yml file:

x-base-environment: &base-environment
    DATABASE_URL: postgresql://${POSTGRES_USER:-worker}:${POSTGRES_PASSWORD:-password}@${POSTGRES_HOST:-postgres}:${POSTGRES_PORT:-5432}/${POSTGRES_DB:-taskdb}
  REDIS_URL: redis://${REDIS_HOST:-redis}:6379
  S3_URL: http://${MINIO_HOST:-minio}:9000
  S3_BUCKET: ${MINIO_BUCKET:-workflow}
  S3_ACCESS_KEY: ${MINIO_ROOT_USER:-admin}
  S3_SECRET_KEY: ${MINIO_ROOT_PASS:-password}
  RUST_LOG: ${RUST_LOG:-info}
  RISC0_HOME: /usr/local/risc0
  RUST_BACKTRACE: 1
  POVW_LOG_ID: "0x1234...5678"

Follow the instructions How to Delegate Rewards to delegate reward power from the staking wallet to the reward address. For more context, please see the Wallet Setup tutorial.

Once enabled, Bento can be run as normal with:

just bento

Or if running the broker as well:

just broker

will start both the broker and Bento.

Once Bento is running, provers can run proving jobs as normal. Bento will now create a work proof for every proving job; a work proof cryptographically proves how much work Bento has done (in cycles).

Using the Boundless CLI, provers aggregate these work proofs and submit the aggregated work proof at least once per reward epoch to be eligible for that epoch's mining rewards. This process is documented in Mining + Claiming Rewards.