Skip to content

Releases: boundless-xyz/boundless

v1.2.0

17 Dec 21:49
@austinabell austinabell
v1.2.0
104aac8
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v1.2.0 Latest
Latest

Release 1.2.0: Stability + Reliability

This release is not mandatory but is recommended for provers to update to see increased stability and performance of their proving node

This release includes new features, stability improvements and bug fixes aimed at increasing the reliability of operating a Boundless node.

Suggested Migration Path

As this release comes with a fix to prove agents, it is recommended that all components in your bento cluster and broker are updated. There is no need to clear volumes/state, as there are no breaking changes, but recommended to submit any povw work before upgrading to ensure no loss in work.

See https://docs.boundless.network/provers/broker#safe-upgrade-steps for details around upgrading

Prover Node

Gas priority mode

We observed reliability issues during periods of high gas-fee volatility, where provers would occasionally miss proving jobs due to delayed transaction inclusion. To address this, provers can now customize the priority fee they use, helping ensure their transactions land on-chain in a timely manner.

Base/priority fees can be set based on three preset modes (low, medium, high) or custom values (#1339).

The default is medium which increases the priority fee used compared to previous releases to ensure transactions can be confirmed during times of high gas volatility.

# broker.toml

[market]
gas_priority_mode = "high"

Fallback RPC Provider

Provers can now use environment variable PROVER_RPC_URLS to configure multiple RPC urls in your broker. This can help with stability in cases a single RPC providers is unreliable or unavailable.

Warning: This features will double RPC costs. It uses Alloy's FallbackRPCProvider, which sends each requests to all the RPC urls in parallel, and uses the fastest valid response.

min_mcycle_limit

To allow provers to set a minimum mcycle count for skipping orders. This is similar to max_mcycle_limit and enables cases where provers only want to prove larger orders.

# broker.toml

[market]
min_mcycle_limit = 500

Bug fix: "empty keccak input"

Fixes a issue where provers could see Keccak failed: [BENTO-KECCAK-002] Received empty keccak input with claim_digest when proving orders.

Requestor SDK

Configurable funding mode

This enables requestors to decide on a request funding mode with requests sent to match their preference. The default has changed to always deposit the order's max price, to ensure all requests can land.

See: #1414 for more details on what modes are available.

Usage example https://github.com/boundless-xyz/boundless/blob/6505c3cffadeae325dd5f512d59b6d2ca102f8a6/crates/order-generator/src/main.rs#L184

What's Changed

Prover/requestor changes

Internal infrastructure changes

Read more

Contributors

zeroecco, ncocchiaro, and 6 other contributors
Assets 2
Loading

Broker Release broker-v1.2.0

17 Dec 19:25
@github-actions github-actions
broker-v1.2.0
6505c3c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Broker Release broker-v1.2.0

Broker Release

This release includes the following components:

  • Broker: Core broker service for order management
  • Broker Stress Test: Stress testing tool for broker

Supported Platforms

  • Linux (AMD64, ARM64)
  • macOS (Intel, Apple Silicon)

Installation

Download the appropriate binary for your platform and make it executable:

chmod +x broker
chmod +x broker-stress

Usage

# Run broker
./broker --help

# Run stress test
./broker-stress --help

Verification

Verify the integrity of downloaded files using the provided SHA256 checksums.

Loading

Bento Release bento-v1.2.0

17 Dec 19:30
@github-actions github-actions
bento-v1.2.0
6505c3c
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Bento Release bento-v1.2.0

Bento Components Release

This release includes a complete bundle of Bento components:

  • Bento Agent: Workflow execution agent (with CUDA support)
  • Bento REST API: REST API server
  • Bento Client: Client library

Supported Platforms

  • Linux AMD64

Installation

Download the appropriate bundle for your platform and extract:

# Download and extract
tar -xzf bento-bundle-linux-amd64.tar.gz
cd bento-bundle

# Make executables
chmod +x bento-agent
chmod +x bento-rest-api
chmod +x bento-client

Usage

# Run agent
./bento-agent --help

# Run REST API
./bento-rest-api --help

# Run client
./bento-client --help

Verification

Verify the integrity of downloaded bundles using the provided SHA256 checksums.

Loading

v1.1.2

25 Nov 17:58
@austinabell austinabell
v1.1.2
a4576e6
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v1.1.2

Urgent CLI update — Upgrade Required to Claim POVW Rewards After 12/3

v1.1.2 is now live and includes a critical fix to the CLI, which is required for the upcoming Fusaka upgrade on 12/3.

To upgrade, re-install the boundless CLI with:

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

To update to the latest version.

Without upgrading, provers will be unable to claim POVW rewards once Ethereum upgrades. We apologize for the short notice and are available to help with any issues.

Bento/Broker update steps

The primary changes will require updating the broker and bento. The simplest path to updating is to just stop the prover altogether, pull latest changes, and start again:

just prover down
git checkout release-1.1
git pull

# Whichever command you use to start the prover
just prover

However the main changes are just to broker and the aux agent of the bento cluster (as well as a logging change to the bento REST API), if you would like to specifically update only those components.

What's changed

Contributors

zeroecco, Wollac, and 2 other contributors
Loading

Broker Release broker-v1.1.2

25 Nov 15:52
@github-actions github-actions
broker-v1.1.2
b26f57e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Broker Release broker-v1.1.2

Broker Release

This release includes the following components:

  • Broker: Core broker service for order management
  • Broker Stress Test: Stress testing tool for broker

Supported Platforms

  • Linux (AMD64, ARM64)
  • macOS (Intel, Apple Silicon)

Installation

Download the appropriate binary for your platform and make it executable:

chmod +x broker
chmod +x broker-stress

Usage

# Run broker
./broker --help

# Run stress test
./broker-stress --help

Verification

Verify the integrity of downloaded files using the provided SHA256 checksums.

Loading

Bento Release bento-v1.1.2

25 Nov 16:26
@github-actions github-actions
bento-v1.1.2
b26f57e
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Bento Release bento-v1.1.2

Bento Components Release

This release includes a complete bundle of Bento components:

  • Bento Agent: Workflow execution agent (with CUDA support)
  • Bento REST API: REST API server
  • Bento Client: Client library

Supported Platforms

  • Linux AMD64

Installation

Download the appropriate bundle for your platform and extract:

# Download and extract
tar -xzf bento-bundle-linux-amd64.tar.gz
cd bento-bundle

# Make executables
chmod +x bento-agent
chmod +x bento-rest-api
chmod +x bento-client

Usage

# Run agent
./bento-agent --help

# Run REST API
./bento-rest-api --help

# Run client
./bento-client --help

Verification

Verify the integrity of downloaded bundles using the provided SHA256 checksums.

Loading

v1.1.1

06 Nov 19:50
@austinabell austinabell
v1.1.1
b12f88a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v1.1.1

What's Changed

Fixes to bento cleanup scripts and boundless CLI for povw prepare. For full notes about 1.1.0 see https://github.com/boundless-xyz/boundless/releases/tag/v1.1.0

Full Changelog: v1.1.0...v1.1.1

Contributors

austinabell
Loading

Broker Release broker-v1.1.1

06 Nov 18:38
@github-actions github-actions
broker-v1.1.1
98549db
This commit was signed with the committer’s verified signature.
austinabell Austin Abell
GPG key ID: 4AF8F39192F7C469
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Broker Release broker-v1.1.1

Broker Release

This release includes the following components:

  • Broker: Core broker service for order management
  • Broker Stress Test: Stress testing tool for broker

Supported Platforms

  • Linux (AMD64, ARM64)
  • macOS (Intel, Apple Silicon)

Installation

Download the appropriate binary for your platform and make it executable:

chmod +x broker
chmod +x broker-stress

Usage

# Run broker
./broker --help

# Run stress test
./broker-stress --help

Verification

Verify the integrity of downloaded files using the provided SHA256 checksums.

Loading

Bento Release bento-v1.1.1

06 Nov 18:35
@github-actions github-actions
bento-v1.1.1
98549db
This commit was signed with the committer’s verified signature.
austinabell Austin Abell
GPG key ID: 4AF8F39192F7C469
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
Bento Release bento-v1.1.1

Bento Components Release

This release includes a complete bundle of Bento components:

  • Bento Agent: Workflow execution agent (with CUDA support)
  • Bento REST API: REST API server
  • Bento Client: Client library

Supported Platforms

  • Linux AMD64

Installation

Download the appropriate bundle for your platform and extract:

# Download and extract
tar -xzf bento-bundle-linux-amd64.tar.gz
cd bento-bundle

# Make executables
chmod +x bento-agent
chmod +x bento-rest-api
chmod +x bento-client

Usage

# Run agent
./bento-agent --help

# Run REST API
./bento-rest-api --help

# Run client
./bento-client --help

Verification

Verify the integrity of downloaded bundles using the provided SHA256 checksums.

Loading

v1.1.0

04 Nov 16:56
@austinabell austinabell
v1.1.0
9afa33b
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Choose a tag to compare

View all tags
v1.1.0

Boundless Prover v1.1.0 & CLI v1.0.0 - Increasing Prover Revenue

Overview

v1.1.0 transforms prover profitability on the Boundless Network, making it easier than ever to join as a prover. The prover now defaults to a more opinionated setup designed to maximize revenue streams by balancing market proving and ZK mining. We've also introduced a configuration wizard that simplifies the process of configuring your prover to maximize hardware utilization.

This is the first in a sequence of releases dedicated to improving prover economics and experience, with more revenue-enhancing features and optimizations already in development. The intended result of these releases will be increased profits for provers who participate in the market.

Provers running v1.1.0 will see immediate improvements to their bottom line through:

  • Dual Revenue Streams: Every proof you complete on the market earns you both ETH from requesters and ZKC rewards through Proof of Verifiable Work (PoVW). When you have excess GPU capacity, your hardware automatically switches to mining ZKC with no downtime, ensuring you're maximizing revenue from your hardware setup.
  • Profit-First Prioritization: New CyclePrice algorithm ensures you're always working on the most profitable market requests.
  • Hardware-Optimized Configuration: Automated setup wizard tailors your prover configuration for maximum utilization and efficiency.
  • Better Visibility: New CLI commands give you real-time insights into your earnings and pending rewards.

Important: This release contains breaking changes that significantly improve prover profitability. Migration is straightforward using our new configuration wizard, and the performance gains make it essential for all provers to upgrade.

New Features

Market + Mining by Default

Your prover now generates more revenue. With zero configuration required, dual earning is enabled by default:

  • Prioritize market orders that earn both ETH fees from market orders and ZKC rewards from mining
  • Seamlessly transitions to pure ZKC mining when market demand is low to ensure your machines are always generating revenue
  • Every market proof contributes to your proportional share of epoch ZKC distributions. Earning your prover more fees and reducing the revenue of pure mining provers

Profit-first order prioritization

The new default prioritization framework, CyclePrice, focuses exclusively on profitability:

  • Evaluates tasks based on ETH fees and ZKC collateral rewards per compute cycle
  • Automatically prioritizes work that maximizes both revenue streams
  • Reduces wasted cycles on unprofitable tasks

Hardware-Optimized Configuration Wizard (Highly recommended)

Launch the new interactive configuration wizard to generate optimized broker.toml and compose.yml files tailored to your hardware specifications and profitability goals.

The wizard automatically:

  • Detects your hardware capabilities such as, proving MHZ and CPU threads
  • Configures optimal worker counts for your CPU/GPU setup to maximize utilization
  • Analyzes recent market orders and sets pricing thresholds to ensure you can earn ETH from the market

CLI v1.0.0

The Boundless CLI has been completely redesigned to improve user experience, simplify the operational side of running a prover on Boundless, and give you real-time insights into earnings and pending rewards.

  • Simplified configuration management via setup wizards and config files
  • Automatic back ups for Reward state files
  • Historical tracking of all reward claims
  • Support for dry-run mining reward submissions and viewing projected rewards

Priority Requestor Lists

The prover now provides pre-configured requestor priority lists, ensuring you prioritize requests from designated requestors known for profitable work.

  • Requestor lists with known and reputable requestors, curated by Boundless Networks, can be enabled with the configuration wizard.
  • The configuration wizard automatically recommends appropriate lists based on your hardware's proving performance.

Migration Instructions

Quick Start Migration

  1. Stop your current prover
just broker down
  1. Upgrade your code to the release branch
git checkout release-1.1
  1. Install the new CLI
cargo install --locked --git https://github.com/boundless-xyz/boundless boundless-cli --branch release-1.1 --bin boundless
  1. Configure your prover module in the CLI
boundless prover setup
  1. Run the configuration wizard to generate broker.toml and compose.yml files
boundless prover generate-config
  1. Run your prover
just prover up

Breaking Changes

Naming

Note: previous naming is supported for backward compatibility in this release, but may be removed in future versions

  • just broker up is now just prover up. Running a prover runs both a broker and a miner.
  • Environment variables updated to reduce misconfiguration risks:
    • RPC_URL => PROVER_RPC_URL
    • PRIVATE_KEY => PROVER_PRIVATE_KEY

Default Behavior Changes

  • just prover up now defaults to maximum profitability mode (market + mining enabled)
  • CyclePrice prioritization is now the default prioritization mode when locking order (previously random). This can be changed by setting order_commitment_priority in your broker.toml. See https://docs.boundless.network/provers/broker#settings-in-brokertoml

CLI v1.0.0 Breaking Changes

The CLI has been completely redesigned with a new module based structure:

  • Three modules: requestor, prover, rewards
  • Configure each module with boundless setup

“PoVW” has been renamed to “mining”, and moved to the rewards module:

  • E.g. boundless povw prepare => boundless rewards prepare-mining

Support

The Boundless team is available to assist with migration:
Technical Support:Provers Telegram Channel
Documentation:docs.boundless.network
Status Updates: @boundless_xyz

What's Next

This release initiates our roadmap of profitability improvements, with multiple upcoming releases planned to further optimize revenue generation. Stay tuned for further updates.

What's Changed

Read more

Contributors

zeroecco, austinabell, and 3 other contributors
Loading