Running a builder on Signet

Authentication

Mon, 01 Jan 0001 00:00:00 +0000

Authentication

Overview

Authentication will be required for the following behaviors:

Getting a sequencer co-signature on a built block.
Retrieving bundles from the bundle relay.

Authentication will be performed using a standard OAuth2 client credential grant and then the access token you receive can be used to authorize all requests to the sequencer and bundle relay.

OAuth Identity Provider Reference

Havarti


Issuer	`https://auth.havarti.signet.sh/realms/master`
OAuth `.well-known` URL	`https://auth.havarti.signet.sh/realms/master/.well-known/openid-configuration`
Authorize Endpoint	`https://auth.havarti.signet.sh/realms/master/protocol/openid-connect/auth`
Token Endpoint	`https://auth.havarti.signet.sh/realms/master/protocol/openid-connect/token`

Authenticating Using `curl`

First off a basic example of getting an OAuth2 access token and using it to authenticate any of our secured API’s

Environment variables

Mon, 01 Jan 0001 00:00:00 +0000

Environment Variables

The Builder is configured via environment variables. The following values are supported for configuration.

Key	Required	Description
`HOST_CHAIN_ID`	Required	Host-chain ID (e.g. 3151908)
`RU_CHAIN_ID`	Required	Rollup-chain ID (e.g. 88888)
`HOST_RPC_URL`	Required	RPC endpoint for the host chain
`ROLLUP_RPC_URL`	Required	RPC endpoint for the rollup chain
`TX_POOL_URL`	Required	Transaction pool URL (must end with /)
`FLASHBOTS_ENDPOINT`	Optional	When configured, the Builder will send Signet blocks to this URL as transaction bundles
`TX_BROADCAST_URLS`	Optional	Additional endpoints for blob txs (comma-separated, slash required)
`ZENITH_ADDRESS`	Required	Zenith contract address
`BUILDER_HELPER_ADDRESS`	Required	Builder helper contract address
`QUINCEY_URL`	Required	Remote sequencer signing endpoint
`BUILDER_PORT`	Required	HTTP port for the Builder (default: 8080)
`SEQUENCER_KEY`	Required	AWS KMS key ID or local private key for sequencer signing
`BUILDER_KEY`	Required	AWS KMS key ID or local private key for builder signing
`BUILDER_REWARDS_ADDRESS`	Required	Address receiving builder rewards
`ROLLUP_BLOCK_GAS_LIMIT`	Optional	Override for block gas limit
`CONCURRENCY_LIMIT`	Optional	Max concurrent tasks the simulator uses
`OAUTH_CLIENT_ID`	Required	Oauth client ID for the builder
`OAUTH_CLIENT_SECRET`	Required	Oauth client secret for the builder
`OAUTH_AUTHENTICATE_URL`	Required	Oauth authenticate URL for the builder for performing OAuth logins
`OAUTH_TOKEN_URL`	Required	Oauth token URL for the builder to get an Oauth2 access token
`AUTH_TOKEN_REFRESH_INTERVAL`	Required	The OAuth token refresh interval in seconds.
`CHAIN_NAME`	Required	The name of the chain (e.g. `parmigiana`)

Clone and build

Mon, 01 Jan 0001 00:00:00 +0000

Clone and Build the Signet Builder

The Builder simulates bundles and transactions to create valid rollup blocks and submits them to Ethereum.

Prerequisites

Rust ≥ 1.85
Git
AWS CLI

Recommended System Specs

CPU: 0.5 vCPU (minimum 0.1 vCPU)
Memory: 512MB (minimum 256MB)
Clock speed: 2.8GHz+ (builder prefers clock speed over core count)

Clone the Repository

 bash
 
 
git clone https://github.com/init4tech/builder
cd builder

Build Options

Local Build

bash

cargo build --release

The compiled binary will be available at target/release/builder.

Running a builder on Signet

Authentication

Authentication

Overview

OAuth Identity Provider Reference

Havarti

Authenticating Using curl

Environment variables

Environment Variables

Clone and build

Clone and Build the Signet Builder

Prerequisites

Recommended System Specs

Clone the Repository

Build Options

Local Build

Authenticating Using `curl`