Skip to content

configs

configs

Validator service configuration models.

See Also

Validator: The service class that consumes these configurations. BaseServiceConfig: Base class providing interval, max_consecutive_failures, and metrics fields.

Classes

ProcessingConfig

Bases: BaseModel

Candidate processing settings.

Attributes:

  • chunk_size (int) –

    Candidates to fetch and validate per iteration. Larger chunks reduce DB round-trips but increase memory usage.

  • max_candidates (int | None) –

    Optional cap on total candidates per cycle (None = all).

See Also

ValidatorConfig: Parent config that embeds this model.

CleanupConfig

Bases: BaseModel

Exhausted candidate cleanup settings.

Removes candidates that have exceeded the maximum failure threshold, preventing permanently broken relays from consuming resources.

Attributes:

  • enabled (bool) –

    Whether to enable exhausted candidate cleanup.

  • max_failures (int) –

    Failure threshold after which candidates are removed.

See Also

delete_exhausted_candidates: The SQL query driven by max_failures. ValidatorConfig: Parent config that embeds this model.

ValidatorConfig

Bases: BaseServiceConfig

Validator service configuration.

See Also

Validator: The service class that consumes this configuration. BaseServiceConfig: Base class providing interval, max_consecutive_failures, and metrics fields. NetworksConfig: Per-network timeout and proxy settings.