Skip to content

Networks

erpc.networks

Network configuration dataclasses for eRPC.

Maps the eRPC network configuration surface — chain identity, integrity checks, eth_getLogs controls, eth_sendRawTransaction idempotency, failsafe policies, rate-limit budgets, and name aliasing — to typed Python dataclasses.

See https://docs.erpc.cloud/config/projects/networks for the upstream schema.

GetLogsConfig dataclass

Controls for eth_getLogs request validation and splitting.

Network-level limits that reject oversized requests early and control how the eRPC proxy splits large log queries into parallel sub-requests.

Attributes:

Name Type Description
max_allowed_range int | None

Maximum block range allowed per request. Requests exceeding this are rejected.
max_allowed_addresses int | None

Maximum number of addresses per filter.
max_allowed_topics int | None

Maximum number of topics per filter.
split_concurrency int | None

Maximum parallel sub-requests when splitting.

Examples:

>>> cfg = GetLogsConfig(max_allowed_range=10_000, split_concurrency=4)
>>> cfg.to_dict()
{'getLogsMaxAllowedRange': 10000, 'getLogsSplitConcurrency': 4}
Source code in erpc/networks.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
@dataclass
class GetLogsConfig:
    """Controls for ``eth_getLogs`` request validation and splitting.

    Network-level limits that reject oversized requests early and control
    how the eRPC proxy splits large log queries into parallel sub-requests.

    Attributes:
        max_allowed_range: Maximum block range allowed per request.
            Requests exceeding this are rejected.
        max_allowed_addresses: Maximum number of addresses per filter.
        max_allowed_topics: Maximum number of topics per filter.
        split_concurrency: Maximum parallel sub-requests when splitting.

    Examples:
        >>> cfg = GetLogsConfig(max_allowed_range=10_000, split_concurrency=4)
        >>> cfg.to_dict()
        {'getLogsMaxAllowedRange': 10000, 'getLogsSplitConcurrency': 4}

    """

    max_allowed_range: int | None = None
    max_allowed_addresses: int | None = None
    max_allowed_topics: int | None = None
    split_concurrency: int | None = None

    def to_dict(self) -> dict[str, Any]:
        """Serialize to eRPC YAML-compatible dictionary.

        Returns:
            Dictionary with only non-None fields, using eRPC camelCase keys.

        """
        d: dict[str, Any] = {}
        if self.max_allowed_range is not None:
            d["getLogsMaxAllowedRange"] = self.max_allowed_range
        if self.max_allowed_addresses is not None:
            d["getLogsMaxAllowedAddresses"] = self.max_allowed_addresses
        if self.max_allowed_topics is not None:
            d["getLogsMaxAllowedTopics"] = self.max_allowed_topics
        if self.split_concurrency is not None:
            d["getLogsSplitConcurrency"] = self.split_concurrency
        return d

to_dict 

to_dict() -> dict[str, Any]

Serialize to eRPC YAML-compatible dictionary.

Returns:

Type Description
dict[str, Any]

Dictionary with only non-None fields, using eRPC camelCase keys.
Source code in erpc/networks.py 
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
def to_dict(self) -> dict[str, Any]:
    """Serialize to eRPC YAML-compatible dictionary.

    Returns:
        Dictionary with only non-None fields, using eRPC camelCase keys.

    """
    d: dict[str, Any] = {}
    if self.max_allowed_range is not None:
        d["getLogsMaxAllowedRange"] = self.max_allowed_range
    if self.max_allowed_addresses is not None:
        d["getLogsMaxAllowedAddresses"] = self.max_allowed_addresses
    if self.max_allowed_topics is not None:
        d["getLogsMaxAllowedTopics"] = self.max_allowed_topics
    if self.split_concurrency is not None:
        d["getLogsSplitConcurrency"] = self.split_concurrency
    return d

SendRawTransactionConfig dataclass

Idempotent broadcasting configuration for eth_sendRawTransaction.

When enabled (the default), eRPC converts duplicate-transaction errors ("already known", "nonce too low" with on-chain verification) into success responses, making retry and hedge policies safe.

Attributes:

Name Type Description
enabled bool

Whether idempotent broadcasting is active. Defaults to True (eRPC's default behavior).

Examples:

>>> SendRawTransactionConfig(enabled=False).to_dict()
{'sendRawTransactionIdempotent': False}
Source code in erpc/networks.py 
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
@dataclass
class SendRawTransactionConfig:
    """Idempotent broadcasting configuration for ``eth_sendRawTransaction``.

    When enabled (the default), eRPC converts duplicate-transaction errors
    (``"already known"``, ``"nonce too low"`` with on-chain verification)
    into success responses, making retry and hedge policies safe.

    Attributes:
        enabled: Whether idempotent broadcasting is active. Defaults to ``True``
            (eRPC's default behavior).

    Examples:
        >>> SendRawTransactionConfig(enabled=False).to_dict()
        {'sendRawTransactionIdempotent': False}

    """

    enabled: bool = True

    def to_dict(self) -> dict[str, Any]:
        """Serialize to eRPC YAML-compatible dictionary.

        Returns:
            Empty dict when enabled (default), otherwise explicit disable flag.

        """
        if not self.enabled:
            return {"sendRawTransactionIdempotent": False}
        return {}

to_dict 

to_dict() -> dict[str, Any]

Serialize to eRPC YAML-compatible dictionary.

Returns:

Type Description
dict[str, Any]

Empty dict when enabled (default), otherwise explicit disable flag.
Source code in erpc/networks.py 
81
82
83
84
85
86
87
88
89
90
def to_dict(self) -> dict[str, Any]:
    """Serialize to eRPC YAML-compatible dictionary.

    Returns:
        Empty dict when enabled (default), otherwise explicit disable flag.

    """
    if not self.enabled:
        return {"sendRawTransactionIdempotent": False}
    return {}

IntegrityConfig dataclass

Data integrity configuration for a network.

Controls block-range enforcement for eth_getLogs and consensus strategies across multiple upstreams.

Attributes:

Name Type Description
enforce_get_logs_block_range bool | None

When True, validates that the upstream has data for the requested fromBlock..toBlock range.
consensus dict[str, Any] | None

Consensus policy configuration dict (strategy, threshold, preferHighestValueFor, etc.). Passed through as-is to eRPC.

Examples:

>>> cfg = IntegrityConfig(enforce_get_logs_block_range=True)
>>> cfg.to_dict()
{'enforceGetLogsBlockRange': True}
Source code in erpc/networks.py 
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
@dataclass
class IntegrityConfig:
    """Data integrity configuration for a network.

    Controls block-range enforcement for ``eth_getLogs`` and consensus
    strategies across multiple upstreams.

    Attributes:
        enforce_get_logs_block_range: When ``True``, validates that the upstream
            has data for the requested ``fromBlock..toBlock`` range.
        consensus: Consensus policy configuration dict (strategy, threshold,
            preferHighestValueFor, etc.). Passed through as-is to eRPC.

    Examples:
        >>> cfg = IntegrityConfig(enforce_get_logs_block_range=True)
        >>> cfg.to_dict()
        {'enforceGetLogsBlockRange': True}

    """

    enforce_get_logs_block_range: bool | None = None
    consensus: dict[str, Any] | None = None

    def to_dict(self) -> dict[str, Any]:
        """Serialize to eRPC YAML-compatible dictionary.

        Returns:
            Dictionary with only non-None fields.

        """
        d: dict[str, Any] = {}
        if self.enforce_get_logs_block_range is not None:
            d["enforceGetLogsBlockRange"] = self.enforce_get_logs_block_range
        if self.consensus is not None:
            d["consensus"] = self.consensus
        return d

to_dict 

to_dict() -> dict[str, Any]

Serialize to eRPC YAML-compatible dictionary.

Returns:

Type Description
dict[str, Any]

Dictionary with only non-None fields.
Source code in erpc/networks.py 
116
117
118
119
120
121
122
123
124
125
126
127
128
def to_dict(self) -> dict[str, Any]:
    """Serialize to eRPC YAML-compatible dictionary.

    Returns:
        Dictionary with only non-None fields.

    """
    d: dict[str, Any] = {}
    if self.enforce_get_logs_block_range is not None:
        d["enforceGetLogsBlockRange"] = self.enforce_get_logs_block_range
    if self.consensus is not None:
        d["consensus"] = self.consensus
    return d

NetworkConfig dataclass

Full network configuration for an eRPC project.

Represents a single chain (e.g. Ethereum mainnet, Polygon) with its architecture, integrity settings, RPC method controls, failsafe policies, rate-limit budget, and optional human-friendly aliases.

Attributes:

Name Type Description
chain_id int

EVM chain identifier (e.g. 1 for Ethereum mainnet).
architecture str

Network architecture type. Defaults to "evm".
aliases list[str] | None

Optional friendly names (e.g. ["ethereum", "eth-mainnet"]) that can be used in place of /evm/<chainId> in request paths.
failsafe_policies dict[str, Any] | None

Failsafe policy configuration (retry, hedge, timeout, circuit-breaker). Passed through as-is to eRPC.
rate_limit_budget str | None

Reference to a named rate-limit budget defined at the project or global level.
integrity IntegrityConfig

Data integrity configuration.
get_logs GetLogsConfig

eth_getLogs request controls.
send_raw_transaction SendRawTransactionConfig

eth_sendRawTransaction idempotency config.

Examples:

>>> net = NetworkConfig(chain_id=1, aliases=["ethereum"])
>>> net.to_dict()["aliases"]
['ethereum']
Source code in erpc/networks.py 
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
@dataclass
class NetworkConfig:
    """Full network configuration for an eRPC project.

    Represents a single chain (e.g. Ethereum mainnet, Polygon) with its
    architecture, integrity settings, RPC method controls, failsafe policies,
    rate-limit budget, and optional human-friendly aliases.

    Attributes:
        chain_id: EVM chain identifier (e.g. ``1`` for Ethereum mainnet).
        architecture: Network architecture type. Defaults to ``"evm"``.
        aliases: Optional friendly names (e.g. ``["ethereum", "eth-mainnet"]``)
            that can be used in place of ``/evm/<chainId>`` in request paths.
        failsafe_policies: Failsafe policy configuration (retry, hedge, timeout,
            circuit-breaker). Passed through as-is to eRPC.
        rate_limit_budget: Reference to a named rate-limit budget defined at
            the project or global level.
        integrity: Data integrity configuration.
        get_logs: ``eth_getLogs`` request controls.
        send_raw_transaction: ``eth_sendRawTransaction`` idempotency config.

    Examples:
        >>> net = NetworkConfig(chain_id=1, aliases=["ethereum"])
        >>> net.to_dict()["aliases"]
        ['ethereum']

    """

    chain_id: int = 0
    architecture: str = "evm"
    aliases: list[str] | None = None
    failsafe_policies: dict[str, Any] | None = None
    rate_limit_budget: str | None = None
    integrity: IntegrityConfig = field(default_factory=IntegrityConfig)
    get_logs: GetLogsConfig = field(default_factory=GetLogsConfig)
    send_raw_transaction: SendRawTransactionConfig = field(
        default_factory=SendRawTransactionConfig
    )

    def to_dict(self) -> dict[str, Any]:
        """Serialize to eRPC YAML-compatible dictionary.

        Produces the structure expected under ``projects[].networks[]``
        in an eRPC configuration file. Only non-default fields are included.

        Returns:
            Dictionary ready for YAML serialization.

        """
        evm: dict[str, Any] = {"chainId": self.chain_id}

        # Integrity
        integrity_d = self.integrity.to_dict()
        if integrity_d:
            evm["integrity"] = integrity_d

        # getLogs controls (flat in evm block)
        get_logs_d = self.get_logs.to_dict()
        evm.update(get_logs_d)

        # sendRawTransaction
        send_tx_d = self.send_raw_transaction.to_dict()
        evm.update(send_tx_d)

        d: dict[str, Any] = {
            "architecture": self.architecture,
            "evm": evm,
        }

        if self.aliases is not None:
            d["aliases"] = self.aliases

        if self.failsafe_policies is not None:
            d["failsafe"] = self.failsafe_policies

        if self.rate_limit_budget is not None:
            d["rateLimitBudget"] = self.rate_limit_budget

        return d

    def to_defaults_dict(self) -> dict[str, Any]:
        """Serialize for use as ``networkDefaults`` (omits chain-specific fields).

        Returns:
            Dictionary suitable for the ``networkDefaults`` project key.

        """
        d: dict[str, Any] = {}

        if self.failsafe_policies is not None:
            d["failsafe"] = self.failsafe_policies

        if self.rate_limit_budget is not None:
            d["rateLimitBudget"] = self.rate_limit_budget

        integrity_d = self.integrity.to_dict()
        if integrity_d:
            evm: dict[str, Any] = {"integrity": integrity_d}
            d["evm"] = evm

        return d

to_dict 

to_dict() -> dict[str, Any]

Serialize to eRPC YAML-compatible dictionary.

Produces the structure expected under projects[].networks[] in an eRPC configuration file. Only non-default fields are included.

Returns:

Type Description
dict[str, Any]

Dictionary ready for YAML serialization.
Source code in erpc/networks.py 
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
def to_dict(self) -> dict[str, Any]:
    """Serialize to eRPC YAML-compatible dictionary.

    Produces the structure expected under ``projects[].networks[]``
    in an eRPC configuration file. Only non-default fields are included.

    Returns:
        Dictionary ready for YAML serialization.

    """
    evm: dict[str, Any] = {"chainId": self.chain_id}

    # Integrity
    integrity_d = self.integrity.to_dict()
    if integrity_d:
        evm["integrity"] = integrity_d

    # getLogs controls (flat in evm block)
    get_logs_d = self.get_logs.to_dict()
    evm.update(get_logs_d)

    # sendRawTransaction
    send_tx_d = self.send_raw_transaction.to_dict()
    evm.update(send_tx_d)

    d: dict[str, Any] = {
        "architecture": self.architecture,
        "evm": evm,
    }

    if self.aliases is not None:
        d["aliases"] = self.aliases

    if self.failsafe_policies is not None:
        d["failsafe"] = self.failsafe_policies

    if self.rate_limit_budget is not None:
        d["rateLimitBudget"] = self.rate_limit_budget

    return d

to_defaults_dict 

to_defaults_dict() -> dict[str, Any]

Serialize for use as networkDefaults (omits chain-specific fields).

Returns:

Type Description
dict[str, Any]

Dictionary suitable for the networkDefaults project key.
Source code in erpc/networks.py 
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
def to_defaults_dict(self) -> dict[str, Any]:
    """Serialize for use as ``networkDefaults`` (omits chain-specific fields).

    Returns:
        Dictionary suitable for the ``networkDefaults`` project key.

    """
    d: dict[str, Any] = {}

    if self.failsafe_policies is not None:
        d["failsafe"] = self.failsafe_policies

    if self.rate_limit_budget is not None:
        d["rateLimitBudget"] = self.rate_limit_budget

    integrity_d = self.integrity.to_dict()
    if integrity_d:
        evm: dict[str, Any] = {"integrity": integrity_d}
        d["evm"] = evm

    return d