name: Rust

on:

push:

branches: [ 'devnet_*', 'testnet_*' ]

merge_group:

pull_request:

branches:

- "**"

workflow_dispatch:

# This allows a subsequently queued workflow run to interrupt previous runs on pull requests

concurrency:

group: '${{ github.workflow }} @ ${{ github.event.pull_request.head.label || github.head_ref || github.run_id }}'

cancel-in-progress: true

env:

CARGO_TERM_COLOR: always

CARGO_INCREMENTAL: 0

CARGO_NET_RETRY: 10

RUST_BACKTRACE: full

# We allow redundant explicit links because `cargo rdme` doesn't know how to resolve implicit intra-crate links.

RUSTDOCFLAGS: -A rustdoc::redundant_explicit_links -D warnings

RUSTFLAGS: -D warnings

RUSTUP_MAX_RETRIES: 10

RUST_LOG: linera=debug

RUST_LOG_FORMAT: plain

LINERA_STORAGE_SERVICE: 127.0.0.1:1235

LINERA_WALLET: /tmp/local-linera-net/wallet_0.json

LINERA_KEYSTORE: /tmp/local-linera-net/keystore_0.json

LINERA_STORAGE: rocksdb:/tmp/local-linera-net/client_0.db

LINERA_FAUCET_URL: http://localhost:8079

permissions:

contents: read

jobs:

# paths-ignore within a pull_request doesn't work well with merge_group, so we need to use a custom filter.

changed-files:

runs-on: ubuntu-latest

outputs:

should-run: ${{ steps.files-changed.outputs.paths }}

steps:

- uses: actions/[email protected]

with:

fetch-depth: 0

- name: Filter paths

uses: dorny/[email protected]

id: files-changed

with:

predicate-quantifier: 'every'

filters: |

paths:

- '!docker/**'

- '!configuration/**'

- '!docs/**'

- '!mdbook/**'

- '!CONTRIBUTING.md'

- '!INSTALL.md'

- '!README.md'

# Workflow-only PRs don't need heavy code tests; merge to main

# validates the workflow itself by running it for real.

- '!.github/workflows/**'

execution-wasmtime-test:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 10

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Run some extra execution tests with wasmtime

run: |

cargo test --locked -p linera-execution --features wasmtime

bridge-tests:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: linera-io-self-hosted-ci

timeout-minutes: 25

steps:

- uses: actions/[email protected]

with:

submodules: recursive

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install Foundry

uses: foundry-rs/foundry-toolchain@v1

with:

version: v1.7.0

- name: Ensure Solc Directory Exists

run: mkdir -p /home/runner/.solc

- name: Cache Solc

id: cache-solc

uses: actions/cache@v4

with:

path: /home/runner/.solc

key: solc-v0.8.33

restore-keys: solc-

- name: Get Solc

if: ${{ steps.cache-solc.outputs.cache-hit != 'true' }}

uses: ./.github/actions/get-solc

with:

version: v0.8.33

- name: Add Solc to PATH

run: echo "/home/runner/.solc" >> $GITHUB_PATH

- name: List the content of the Solc cache

run: ls /home/runner/.solc/v0.8.33/solc-static-linux

- name: Create a Solc symbolic link

run: ln -sf /home/runner/.solc/v0.8.33/solc-static-linux /home/runner/.solc/solc

- name: Check if Solc is in PATH

id: check-solc

run: |

if which solc; then

echo "solc-available=true" >> $GITHUB_OUTPUT

else

echo "::warning::solc not found in PATH, skipping bridge tests"

echo "solc-available=false" >> $GITHUB_OUTPUT

fi

- name: Regenerate Solidity types

if: steps.check-solc.outputs.solc-available == 'true'

run: |

cargo build --locked -p linera-bridge --features codegen

- name: Check generated Solidity files are up to date

if: steps.check-solc.outputs.solc-available == 'true'

run: |

if ! git diff --exit-code linera-bridge/src/solidity/

then

echo 'Generated Solidity files are out of date. Run `cargo build -p linera-bridge --features codegen` and commit the results.'

exit 1

fi

- name: Run bridge tests

if: steps.check-solc.outputs.solc-available == 'true'

run: |

cargo test --locked -p linera-bridge

- name: Run Solidity (forge) tests

if: steps.check-solc.outputs.solc-available == 'true'

working-directory: linera-bridge/src/solidity

run: forge test -vvv

metrics-test:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 10

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Run metrics tests

run: |

cargo test --locked -p linera-base --features metrics

wasm-application-test:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 25

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

with:

cache-workspaces: |

examples -> target

- name: Install Protoc

uses: ./.github/actions/install-protoc

- name: Run Wasm application tests

run: |

cd examples

cargo test --locked

linera-sdk-tests-fixtures:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 10

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

with:

cache-workspaces: |

linera-sdk/tests/fixtures -> target

- name: Install Protoc

uses: ./.github/actions/install-protoc

- name: Run linera-sdk fixtures

run: |

cd linera-sdk/tests/fixtures

cargo test --locked

- name: Run linera-sdk tests application lints

run: |

cd linera-sdk/tests/fixtures

cargo fmt -- --check

cargo clippy --all-targets --all-features --target wasm32-unknown-unknown --locked

default-features-and-witty-integration-test:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: linera-io-self-hosted-ci

timeout-minutes: 40

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install Protoc

uses: ./.github/actions/install-protoc

- name: Compile Wasm test modules for Witty integration tests

run: |

cargo build -p linera-witty-test-modules --target wasm32-unknown-unknown --locked

- name: Run all tests using the default features (except storage-service)

run: |

# TODO(#2764): Actually link this to the default features

cargo test --no-default-features --features fs,macros,wasmer,rocksdb --locked

- name: Run Witty integration tests

run: |

cargo test -p linera-witty --features wasmer,wasmtime --locked

check-outdated-cli-md:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 15

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install Protoc

uses: ./.github/actions/install-protoc

- name: Check for outdated CLI.md

run: |

if ! diff CLI.md <(cargo run --bin linera -- help-markdown)

then

echo '`CLI.md` differs from the output of `linera help-markdown`'

echo 'Run `linera help-markdown > CLI.md` to update it.'

exit 1

fi

ethereum-tests:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 30

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

- uses: foundry-rs/[email protected]

- name: Ensure Solc Directory Exists

run: mkdir -p /home/runner/.solc

- name: Cache Solc

id: cache-solc

uses: actions/cache@v4

with:

path: /home/runner/.solc

key: solc-v0.8.33

restore-keys: solc-

- name: Get Solc

if: ${{ steps.cache-solc.outputs.cache-hit != 'true' }}

uses: ./.github/actions/get-solc

with:

version: v0.8.33

- name: Add Solc to PATH

run: echo "/home/runner/.solc" >> $GITHUB_PATH

- name: List the content of the Solc cache

run: ls /home/runner/.solc/v0.8.33/solc-static-linux

- name: Create a Solc symbolic link

run: ln -sf /home/runner/.solc/v0.8.33/solc-static-linux /home/runner/.solc/solc

- name: Check if Solc is in PATH

run: which solc || echo "Solc not found in PATH"

- name: Install Protoc

uses: ./.github/actions/install-protoc

- name: Install serde-generate-bin

run: |

cargo install [email protected] --locked

- name: Compile the LineraTypes.yaml

run: |

serdegen --language solidity --module-name LineraTypes --target-source-dir dest linera-execution/solidity/LineraTypes.yaml

- name: Check for generated LineraTypes.sol

run: |

if ! diff dest/LineraTypes.sol linera-execution/solidity/LineraTypes.sol

then

echo '`LineraTypes.sol` differs from the output of `serdegen`'

exit 1

fi

- name: Run the storage-service instance

run: |

cargo run --release -p linera-storage-service -- memory --endpoint $LINERA_STORAGE_SERVICE &

- name: Wait for storage service to be ready

run: |

STORAGE_HOST=$(echo "$LINERA_STORAGE_SERVICE" | cut -d: -f1)

STORAGE_PORT=$(echo "$LINERA_STORAGE_SERVICE" | cut -d: -f2)

until nc -z "$STORAGE_HOST" "$STORAGE_PORT"; do sleep 1; done

- name: Run Ethereum tests

run: |

cargo test -p linera-ethereum --features ethereum

cargo test test_wasm_end_to_end_ethereum_tracker --features ethereum,storage-service

- name: Run REVM test

run: |

cargo test evm --features revm,storage-service

storage-service-tests:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: linera-io-self-hosted-ci

timeout-minutes: 40

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install Protoc

uses: ./.github/actions/install-protoc

- name: Build example applications

run: |

cd examples

cargo build --locked --release --target wasm32-unknown-unknown

- name: Run the storage-service instance

run: |

cargo run --release -p linera-storage-service -- memory --endpoint $LINERA_STORAGE_SERVICE &

- name: Wait for storage service to be ready

run: |

STORAGE_HOST=$(echo "$LINERA_STORAGE_SERVICE" | cut -d: -f1)

STORAGE_PORT=$(echo "$LINERA_STORAGE_SERVICE" | cut -d: -f2)

until nc -z "$STORAGE_HOST" "$STORAGE_PORT"; do sleep 1; done

- name: Run the storage-service tests

run: |

cargo test --features storage-service,opentelemetry -- storage_service --nocapture

check-wit-files:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Check WIT files

run: |

cargo run --bin wit-generator -- -c

lint-unexpected-chain-load-operations:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 2

steps:

- uses: actions/[email protected]

- name: Check for unexpected chain load operations

run: |

./scripts/check_chain_loads.sh

lint-check-copyright-headers:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 2

steps:

- uses: actions/[email protected]

- name: Build check_copyright_header script

run: |

cd ./scripts/check_copyright_header

cargo build --locked --release

- name: Check Copyright headers

run: >

find linera-* examples -name '*.rs' -a -not -wholename '*/target/*' -print0

| xargs -0 scripts/target/release/check_copyright_header

lint-cargo-machete:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 2

steps:

- uses: actions/[email protected]

- name: Put lint toolchain file in place

run: |

ln -sf toolchains/nightly/rust-toolchain.toml

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install cargo-machete

run: |

cargo install [email protected] --locked

- name: Check for unused dependencies

run: |

cargo machete

lint-cargo-fmt:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 2

steps:

- uses: actions/[email protected]

- name: Put lint toolchain file in place

run: |

ln -sf toolchains/nightly/rust-toolchain.toml

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Check formatting

run: |

cargo fmt -- --check

lint-taplo-fmt:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 5

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install `taplo-cli`

run: RUSTFLAGS='' cargo install [email protected] --locked

- name: Check if `Cargo.toml` files are formatted

run: taplo fmt --check --diff

lint-check-for-outdated-readme:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 5

steps:

- uses: actions/[email protected]

- name: Put lint toolchain file in place

run: |

ln -sf toolchains/nightly/rust-toolchain.toml

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install cargo-rdme

run: |

cargo install cargo-rdme --locked

- name: Check for outdated README.md

run: |

set -e

linera_packages=($(

cargo metadata --format-version 1 \

| jq -r '.workspace_members[] | match("/(linera-.*)#").captures[0].string' \

))

for package in "${linera_packages[*]}"

do

[ -d "$package" ] || continue

echo $package

cargo rdme --check --no-fail-on-warnings -w $package

done

lint-wasm-applications:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 10

steps:

- uses: actions/[email protected]

- name: Put lint toolchain file in place

run: |

ln -sf toolchains/nightly/rust-toolchain.toml

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install Protoc

uses: ./.github/actions/install-protoc

- name: Run Wasm application lints

run: |

cd examples

cargo fmt -- --check

cargo clippy --all-targets --all-features --target wasm32-unknown-unknown --locked

cargo clippy --all-targets --all-features --target x86_64-unknown-linux-gnu --locked

cd agent

cargo fmt -- --check

lint-cargo-clippy:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 20

steps:

- uses: actions/[email protected]

- name: Put lint toolchain file in place

run: |

ln -sf toolchains/nightly/rust-toolchain.toml

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install Protoc

uses: ./.github/actions/install-protoc

- name: Run clippy

run: |

cargo clippy --locked --all-targets --all-features --workspace

cargo clippy --locked --no-default-features

cargo clippy --locked --target wasm32-unknown-unknown --no-default-features --features web-default \

-p linera-client \

-p linera-rpc \

-p linera-views

lint-cargo-doc:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 40

steps:

- uses: actions/[email protected]

- name: Put lint toolchain file in place

run: |

ln -sf toolchains/nightly/rust-toolchain.toml

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install Protoc

uses: ./.github/actions/install-protoc

- name: Run cargo doc

run: |

cargo doc --locked --all-features --no-deps

lint-check-linera-service-graphql-schema:

needs: changed-files

if: needs.changed-files.outputs.should-run == 'true'

runs-on: ubuntu-latest

timeout-minutes: 15

steps:

- uses: actions/[email protected]

- uses: actions-rust-lang/setup-rust-toolchain@v1

- name: Install Protoc

uses: ./.github/actions/install-protoc

- name: Check linera-service GraphQL schema

run: |

diff <(cargo run --locked --bin linera-schema-export) linera-service-graphql-client/gql/service_schema.graphql