apollo_l1_gas_price_config,apollo_node: add strk_to_usd_oracle_config

[ShahakShama]

apollo_l1_gas_price_config,apollo_node: add strk_to_usd_oracle_config

Goal: relocate the STRK/USD oracle currently wired ad-hoc into
SequencerConsensusContext to live inside L1GasPriceProvider alongside
the existing eth_to_strk oracle. This commit is PR 1 of a 6-PR
Graphite stack; later PRs construct the oracle client in the
provider, expose it on the client trait, switch the orchestrator to
call it, and remove the dead wiring in apollo_consensus_manager.

Change summary: adds strk_to_usd_oracle_config: ExchangeRateOracleConfig
to L1GasPriceProviderConfig next to eth_to_strk_oracle_config,
extends Default, dumps it as a nested sub-config, and registers the
four new entries in config_schema.json. Pure additive; the field is
unused.

Decision points:

• Kept the existing "eth to strk" wording in ExchangeRateOracleConfig::dump
  rather than generalizing to "exchange rate oracle". Generalizing would
  churn the eth-to-strk schema entries and force a regeneration of
  config_secrets_schema.json. Doing it here would balloon the diff;
  punting to a separate cosmetic PR.

Action required after merge: run
cargo run --bin update_apollo_node_config_schema
to regenerate config_secrets_schema.json (sandbox cannot access it).
The new private parameter strk_to_usd_oracle_config.url_header_list
needs a matching schema entry, otherwise the default_config_file_is_up_to_date
test will fail.

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com

apollo_deployments: add strk_to_usd_oracle_config entries to provider JSONs

Add the same three non-secret overrides (lag_interval_seconds=900,
max_cache_size=100, query_timeout_sec=10) for strk_to_usd_oracle_config
that already exist for eth_to_strk_oracle_config, in both the base
and replacer L1GasPriceProvider deployment JSONs. The new
strk_to_usd_oracle_config field on L1GasPriceProviderConfig (added
earlier in this PR) needs these production-default overrides to
behave consistently with the existing eth_to_strk oracle.

The url_header_list belongs in the secrets files (testing_secrets.json,
config_secrets_schema.json) — those are harness-blocked from this
sandbox; regenerate locally with cargo run --bin deployment_generator
and cargo run --bin update_apollo_node_config_schema.

Co-Authored-By: Claude Opus 4.7 (1M context) noreply@anthropic.com

[cursor]

PR Summary

Medium Risk
Touches L1 gas price provider configuration (economically sensitive), but changes are additive config/schema only with no runtime oracle wiring in this commit.

Overview
Adds strk_to_usd_oracle_config to L1GasPriceProviderConfig as a nested ExchangeRateOracleConfig (same shape as eth_to_strk_oracle_config), with defaults, validation, and config dump/schema entries. ExchangeRateOracleConfig dump text is generalized to “exchange rate oracle” (including existing eth-to-strk schema keys).

Deployment and test harness JSON gain matching public overrides (lag_interval_seconds, max_cache_size, query_timeout_sec) and a private url_header_list (testing secrets + secrets schema + test_utils). Purely additive—the new field is not consumed at runtime in this PR (stack PR 1/6).

^{Reviewed by Cursor Bugbot for commit 74a40a0. Bugbot is set up for automated code reviews on this repo. Configure here.}

[reviewable-StarkWare]

This change is 

[ShahakShama]

• apollo_consensus_orchestrator: add SNIP-35 integration TODO doc #13982
• apollo_consensus_orchestrator: tmp dirty tests for SNIP-35 (NOT FOR MERGE) #13857
• apollo_l1_gas_price,apollo_l1_gas_price_config: move exchange_rate_decimals const to config #13881
• apollo_consensus_orchestrator: add SNIP-35 proposer-validator symmetry tests #13856
• apollo_consensus_orchestrator: add SNIP-35 module edge case tests #13855
• apollo_consensus_orchestrator,apollo_consensus_manager: route STRK/USD via L1GasPriceProvider #14161
• apollo_integration_tests,apollo_deployments: prime strk_to_usd_oracle overlays #14160
• apollo_l1_gas_price_types,apollo_l1_gas_price: expose get_strk_to_usd_rate #14159
• apollo_l1_gas_price: hold strk_to_usd oracle client + strk_to_usd_rate #14158
• apollo_l1_gas_price: parameterize ExchangeRateOracleClient by metric set #14199
• apollo_l1_gas_price_config,apollo_node: add strk_to_usd_oracle_config #14157 👈 (View in Graphite)
• apollo_consensus_orchestrator: add SNIP-35 fee_proposal validation #13819 : 1 other dependent PR (#13820 )
• apollo_consensus_orchestrator: include fee_proposal_fri in proposal commitment hash #13949
• apollo_starknet_client: read fee_proposal_fri from feeder gateway #13986
• apollo_consensus_orchestrator: wire SNIP-35 fee_proposal into cende blob #13985
• apollo_consensus_orchestrator: wire SNIP-35 fee_proposal into build_proposal #13818
• apollo_consensus_orchestrator,apollo_consensus_manager: move SNIP-35 bootstrap to pre-consensus #14061
• apollo_node_config: made validation only node hold full state #14122
• main

This stack of pull requests is managed by Graphite. Learn more about stacking.

[matanl-starkware]

@matanl-starkware reviewed 7 files and all commit messages, and made 3 comments.
Reviewable status: all files reviewed, 3 unresolved discussions (waiting on ShahakShama).

---

crates/apollo_node/resources/config_schema.json line 3318 at r4 (raw file):

  },
  "l1_gas_price_provider_config.strk_to_usd_oracle_config.lag_interval_seconds": {
    "description": "The size of the interval (seconds) that the eth to strk rate is taken on. The lag refers to the fact that the interval `[T, T+k)` contains the conversion rate for queries in the interval `[T+k, T+2k)`. Should be configured in alignment with relevant query parameters in `url_header_list`, if required.",

copy-paste error

Code quote:

eth to strk

---

crates/apollo_node/resources/config_schema.json line 3328 at r4 (raw file):

  },
  "l1_gas_price_provider_config.strk_to_usd_oracle_config.query_timeout_sec": {
    "description": "The timeout (seconds) for the query to the eth to strk oracle.",

ditto

Code quote:

eth to strk

---

crates/apollo_node/resources/config_schema.json line 3333 at r4 (raw file):

  },
  "l1_gas_price_provider_config.strk_to_usd_oracle_config.url_header_list": {
    "description": "A list of Url+HTTP headers for the eth to strk oracle. The url is followed by a comma and then headers as key^value pairs, separated by commas. For example: `https://api.example.com/api,key1^value1,key2^value2`. Each URL+headers is separated by a pipe `|` character. The `timestamp` parameter is appended dynamically when making requests, in order to have a stable mapping from block timestamp to conversion rate. ",

Same

Code quote:

eth to strk

[ShahakShama]

@ShahakShama made 3 comments.
Reviewable status: 0 of 7 files reviewed, 3 unresolved discussions (waiting on matanl-starkware).

---

crates/apollo_node/resources/config_schema.json line 3318 at r4 (raw file):

Previously, matanl-starkware (Matan Lior) wrote…

copy-paste error

It needs to be identical in both of them because it's the same config struct. Reworded to be more generic

---

crates/apollo_node/resources/config_schema.json line 3328 at r4 (raw file):

Previously, matanl-starkware (Matan Lior) wrote…

ditto

Done.

---

crates/apollo_node/resources/config_schema.json line 3333 at r4 (raw file):

Previously, matanl-starkware (Matan Lior) wrote…

Same

Done.

[matanl-starkware]

@matanl-starkware reviewed 7 files and all commit messages, and resolved 3 discussions.
Reviewable status: complete! all files reviewed, all discussions resolved (waiting on ShahakShama).