Skip to content
openKMS openKMS

Testing And Automation

Docs path: Operate / Testing And Automation

Run the default test suite without hardware:

Terminal window
cargo test --all-targets

Run the integration tests explicitly:

Terminal window
cargo test --test integration

Hardware tests are opt-in and intentionally strict once enabled:

Terminal window
OPENKMS_HARDWARE_TESTS=1 cargo test --test integration -- --ignored

Automation Lanes

Section titled “Automation Lanes”
  • ci.yml runs formatting, clippy, tests, docs drift checks, rustdoc, OpenAPI drift checks, and website build checks.
  • remote-e2e.yml is a manual staging smoke test against a deployed signer.
  • broadcast-e2e.yml is a manual live testnet broadcast gate.

The E2E wrapper scripts share Solana and Cosmos default resolution through scripts/e2e_defaults.sh.

Contributor / CI runbooks

Section titled “Contributor / CI runbooks”

The two long-form runbooks below are for openKMS contributors and CI maintainers — they cover GitHub Actions wiring, Tailscale OAuth, gh act quirks on Docker Desktop / WSL2, throwaway Docker keygen, and devnet funding. Operator consumers running openKMS for their agent can skip them.