configs

configs

Finder service configuration models.

See Also

Finder: The service class that consumes these configurations. BaseServiceConfig: Base class providing interval and log_level fields.

Classes

ConcurrencyConfig

Bases: BaseModel

Concurrency limits for parallel operations.

See Also

FinderConfig: Parent config that embeds this model.

EventsConfig

Bases: BaseModel

Event scanning configuration for discovering relay URLs from stored events.

Scans all events per relay (cursor-paginated by seen_at) and extracts relay URLs from tagvalues. Any tagvalue that parses as a valid relay URL becomes a validation candidate.

See Also

fetch_event_tagvalues: The SQL query driven by batch_size. FinderConfig: Parent config that embeds this model.

ApiSourceConfig

Bases: BaseModel

Single API source configuration.

The jmespath field declares how relay URL strings are extracted from the JSON response. It accepts any valid JMESPath <https://jmespath.org/>_ expression. The default [*] assumes the response is a flat JSON array of URL strings.

Examples of common expressions::

[*]                   -- flat list of strings (default)
data.relays           -- nested path to a list
data.relays[*].url    -- list of objects, extract "url" field
keys(@)               -- dict keys are the URLs

See Also

extract_urls_from_response: The extraction function driven by this field.

ApiConfig

Bases: BaseModel

API fetching configuration -- discovers relay URLs from public APIs.

See Also

ApiSourceConfig: Per-source URL, timeout, and enablement settings. FinderConfig: Parent config that embeds this model.

FinderConfig

Bases: BaseServiceConfig

Finder service configuration.

See Also

Finder: The service class that consumes this configuration. BaseServiceConfig: Base class providing interval and log_level fields.