Crate taceo_nodes_common 

Common utilities for MPC-node services.

This crate provides building blocks shared across nodes in the MPC network.

• Environment – represents the deployment environment (prod / staging / test).
• StartedServices – tracks whether all async background services have started, used to drive the /health endpoint.
• spawn_shutdown_task / default_shutdown_signal – wiring for graceful shutdown via CTRL+C or SIGTERM.
• version_info! – macro that returns a version string containing the crate name, semver version, and git hash.

Optional Features

• api – exposes /health and /version Axum endpoints.
• middleware – enables the middleware module containing Axum/Tower middleware layers.
• unkey (implies middleware) – middleware::unkey::UnkeyLayer, a Tower middleware that verifies Authorization: Bearer tokens against the Unkey API.
• serde – ser/de implementation for Environment.
• postgres – postgres::PostgresConfig and postgres::pg_pool_with_schema for creating a sqlx connection pool pinned to a schema, with configurable retry behaviour.
• web3 – web3::HttpRpcProvider, web3::HttpRpcProviderBuilder, and web3::HttpRpcProviderConfig for building HTTP Ethereum RPC providers with automatic retry and failover, plus ERC-165 interface detection utilities and web3::GetReceiptExt::get_receipt_with_retry for more robust receipt fetching.
• test-utils (implies postgres) – enables the test_utils module of integration-test helpers: test_utils::postgres_testcontainer / test_utils::shared_postgres_testcontainer for ephemeral Postgres containers, test_utils::next_test_schema for isolated schema names, and test_utils::random_port.
• axum-test (implies test-utils) – adds the test_utils::axum_test re-export and test_utils::test_server for spinning up an Axum test server.
• web3-asserter (implies web3) – adds web3::HttpRpcProvider::with_mock_asserter (and a matching From<Asserter> impl) for building a provider backed by Alloy’s mocked provider infrastructure, intended for tests.

Re-exports

pub use git_version;

Modules

api

Health Check Endpoints

middleware

Axum middleware layers.

postgres

Configuration for a Postgres database.

test_utils

Utilities for testing nodes.

web3

HTTP RPC provider utilities for interacting with Ethereum nodes.

Macros

version_info

Macro to generate version information including the crate name, version, and git hash.

Structs

ParseEnvironmentError

Error type for parsing an Environment from a string.

StartedServices

A struct that keeps track of the health of all async services started by the service.

Enums

Environment

The environment the service is running in.

Functions

default_shutdown_signal

Returns a future that completes when the application should shut down.

spawn_shutdown_task

Spawns a shutdown task and creates an associated CancellationToken. This task will complete when either the provided shutdown_signal futures completes or if some other tasks cancels the shutdown token. The associated shutdown token will be cancelled either way.