offchainlabs/Run Arbitrum Testnode

Boot a snapshot-backed Arbitrum testnode in GitHub CI and export its config files

Trust Signals

Scorecard Score: not yet scored
Maintenance Recency: Activelast commit Jul 1, 2026
License: None

Pinned Snippet

workflow.ymlSHA-pinned

uses: offchainlabs/arbitrum-testnode@ac10d17d3b170927617db770727929da29078f31 # v0.2.7

tags can be moved; commit SHAs can't. why a SHA?

Inputs

name	description	required	default
version	Pinned release version used to resolve the testnode image tag	yes	—
github-token	Token used for private GHCR authentication	no	—
image-repository	Container repository prefix used to resolve the testnode image	no	ghcr.io/offchainlabs/arbitrum-testnode-ci
l3-enabled	Whether to boot the L3-enabled testnode	no	false
timeboost-enabled	Whether to enable Timeboost sequencer args and auctioneer/timeboost HTTP APIs	no	false
fee-token-decimals	Custom L3 fee-token decimals (6, 16, 18, or 20) when l3-enabled=true	no	""
nitro-contracts-version	Nitro contracts version (e.g. v2.1, v3.2)	no	v3.2
output-dir	Directory where the exported config files should be written	no	""
container-name	Optional Docker container name override	no	""
startup-timeout-seconds	Maximum time to wait for the testnode RPCs to become ready	no	120
network-config-path	Path(s) to overwrite with the exported localNetwork.json (comma-separated)	no	""

Outputs

name	description
config-dir	Directory containing the exported config files
local-network-path	Path to localNetwork.json
l1l2-network-path	Path to l1l2_network.json
l2l3-network-path	Path to l2l3_network.json
l1-bridge-ui-config-path	Path to the L1/L2 bridge UI config
l2-bridge-ui-config-path	Path to the L2/L3 bridge UI config
l1-rpc-url	Host RPC URL for the L1
l2-rpc-url	Host RPC URL for the L2
l3-rpc-url	Host RPC URL for the L3
variant	Resolved variant name
nitro-contracts-version	Resolved nitro contracts version