feat: add network block explorer settings

crates/common/src/add_order.rs

@@ -642,6 +642,7 @@ price: 2e18;
             label: None,
             network_id: None,
             currency: None,
+            block_explorer: None,
         };
         let network_arc = Arc::new(network);
         let rainlang = RainlangCfg {
@@ -767,6 +768,7 @@ _ _: 0 0;
             label: None,
             network_id: None,
             currency: None,
+            block_explorer: None,
         };
         let network_arc = Arc::new(network);
         let rainlang = RainlangCfg {
@@ -933,6 +935,7 @@ _ _: 0 0;
             label: None,
             network_id: None,
             currency: None,
+            block_explorer: None,
         };
         let network_arc = Arc::new(network);
         let rainlang = RainlangCfg {
@@ -1279,6 +1282,7 @@ _ _: 16 52;
             label: None,
             network_id: None,
             currency: None,
+            block_explorer: None,
         };
         let network_arc = Arc::new(network);
         let rainlang = RainlangCfg {

crates/common/src/raindex_order_builder/state_management.rs

@@ -1,19 +1,23 @@
 use super::*;
+use alloy::primitives::Address;
 use rain_metadata::types::dotrain::{
     order_builder_state_v1::{OrderBuilderStateV1, ShortenedTokenCfg, ValueCfg},
     source_v1::DotrainSourceV1,
 };
 use raindex_app_settings::{
+    network::NetworkCfg,
     order::{OrderIOCfg, VaultType},
     order_builder::OrderBuilderDepositCfg,
     token::TokenCfg,
 };
+use serde_json::Value;
 use sha2::{Digest, Sha256};
 use std::{
     collections::HashMap,
     sync::{Arc, RwLock},
 };
 use strict_yaml_rust::StrictYaml;
+use url::Url;
 
 #[derive(Serialize, Deserialize, Debug, Clone, PartialEq)]
 #[serde(rename_all = "camelCase")]
@@ -29,12 +33,94 @@ pub struct AllBuilderConfig {
 struct SerializedBuilderState {
     field_values: BTreeMap<String, OrderBuilderPresetCfg>,
     deposits: BTreeMap<String, OrderBuilderPresetCfg>,
-    select_tokens: BTreeMap<String, TokenCfg>,
+    select_tokens: BTreeMap<String, SerializedTokenCfg>,
     vault_ids: BTreeMap<(VaultType, String), Option<String>>,
     dotrain_hash: String,
     selected_deployment: String,
 }
 
+// Keep the legacy bincode shape stable when NetworkCfg gains optional fields.
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq)]
+struct SerializedNetworkCfg {
+    key: String,
+    rpcs: Vec<Url>,
+    chain_id: u32,
+    label: Option<String>,
+    network_id: Option<u32>,
+    currency: Option<String>,
+}
+
+impl From<&NetworkCfg> for SerializedNetworkCfg {
+    fn from(network: &NetworkCfg) -> Self {
+        Self {
+            key: network.key.clone(),
+            rpcs: network.rpcs.clone(),
+            chain_id: network.chain_id,
+            label: network.label.clone(),
+            network_id: network.network_id,
+            currency: network.currency.clone(),
+        }
+    }
+}
+
+impl From<SerializedNetworkCfg> for NetworkCfg {
+    fn from(network: SerializedNetworkCfg) -> Self {
+        Self {
+            key: network.key,
+            rpcs: network.rpcs,
+            chain_id: network.chain_id,
+            label: network.label,
+            network_id: network.network_id,
+            currency: network.currency,
+            block_explorer: None,
+            ..Default::default()
+        }
+    }
+}
+
+#[derive(Serialize, Deserialize, Debug, Clone, PartialEq)]
+struct SerializedTokenCfg {
+    key: String,
+    network: Arc<SerializedNetworkCfg>,
+    address: Address,
+    decimals: Option<u8>,
+    label: Option<String>,
+    symbol: Option<String>,
+    logo_uri: Option<Url>,
+    extensions: Option<HashMap<String, Value>>,
+}
+
+impl From<TokenCfg> for SerializedTokenCfg {
+    fn from(token: TokenCfg) -> Self {
+        Self {
+            key: token.key,
+            network: Arc::new(SerializedNetworkCfg::from(token.network.as_ref())),
+            address: token.address,
+            decimals: token.decimals,
+            label: token.label,
+            symbol: token.symbol,
+            logo_uri: token.logo_uri,
+            extensions: token.extensions,
+        }
+    }
+}
+
+impl From<SerializedTokenCfg> for TokenCfg {
+    fn from(token: SerializedTokenCfg) -> Self {
+        Self {
+            key: token.key,
+            network: Arc::new(Arc::unwrap_or_clone(token.network).into()),
+            address: token.address,
+            decimals: token.decimals,
+            label: token.label,
+            symbol: token.symbol,
+            logo_uri: token.logo_uri,
+            extensions: token.extensions,
+            ..Default::default()
+        }
+    }
+}
+
 impl RaindexOrderBuilder {
     fn create_preset(
         value: &field_values::PairValue,
@@ -216,7 +302,7 @@ impl RaindexOrderBuilder {
             deposits.insert(k.clone(), preset);
         }
 
-        let mut select_tokens: BTreeMap<String, TokenCfg> = BTreeMap::new();
+        let mut select_tokens: BTreeMap<String, SerializedTokenCfg> = BTreeMap::new();
         if let Some(st) = OrderBuilderCfg::parse_select_tokens(
             self.dotrain_order.dotrain_yaml().documents.clone(),
             &self.selected_deployment,
@@ -227,7 +313,7 @@ impl RaindexOrderBuilder {
                     .raindex_yaml()
                     .get_token(&select_token.key)
                 {
-                    select_tokens.insert(select_token.key, token);
+                    select_tokens.insert(select_token.key, token.into());
                 }
             }
         }
@@ -314,6 +400,7 @@ impl RaindexOrderBuilder {
             &state.selected_deployment,
         )?;
         for (key, token) in state.select_tokens {
+            let token: TokenCfg = token.into();
             let select_tokens = deployment_select_tokens
                 .as_ref()
                 .ok_or(RaindexOrderBuilderError::SelectTokensNotSet)?;
@@ -629,7 +716,7 @@ mod tests {
         let serialized_state = encode_state(&SerializedBuilderState {
             field_values: BTreeMap::new(),
             deposits: BTreeMap::new(),
-            select_tokens: BTreeMap::from([("token1".to_string(), token)]),
+            select_tokens: BTreeMap::from([("token1".to_string(), token.into())]),
             vault_ids: BTreeMap::new(),
             dotrain_hash: RaindexOrderBuilder::compute_state_hash(&dotrain_order).unwrap(),
             selected_deployment: "select-token-deployment".to_string(),
@@ -687,7 +774,10 @@ mod tests {
         let serialized_state = encode_state(&SerializedBuilderState {
             field_values: BTreeMap::new(),
             deposits: BTreeMap::new(),
-            select_tokens: BTreeMap::from([("token3".to_string(), replacement_token.clone())]),
+            select_tokens: BTreeMap::from([(
+                "token3".to_string(),
+                replacement_token.clone().into(),
+            )]),
             vault_ids: BTreeMap::new(),
             dotrain_hash: RaindexOrderBuilder::compute_state_hash(&dotrain_order).unwrap(),
             selected_deployment: "select-token-deployment".to_string(),

crates/settings/ARCHITECTURE.md

@@ -127,10 +127,11 @@ compares logical data only.
 
 ### Networks (`network.rs`)
 
-- `NetworkCfg { key, rpcs: Vec<Url>, chain_id, label?, network_id?, currency? }`
+- `NetworkCfg { key, rpcs: Vec<Url>, chain_id, label?, network_id?, currency?, block_explorer? }`
   - `dummy()` and `Default` for tests.
   - Validators: `validate_rpc(&str) -> Url`, `validate_chain_id(&str) -> u64`,
-    `validate_network_id(&str) -> u32`.
+    `validate_network_id(&str) -> u32`, and
+    `validate_block_explorer(&str) -> Url` (HTTP(S) only).
   - Parse all: looks for `networks` map with entries shaped like:
     ```yaml
     networks:
@@ -140,6 +141,7 @@ compares logical data only.
         label: Ethereum Mainnet
         network-id: 1
         currency: ETH
+        block-explorer: https://etherscan.io
     ```
   - `parse_rpcs(documents, network_key)` reads just the `rpcs` vector for a
     named network.
@@ -380,7 +382,8 @@ merged into the model.
     requests and parses JSON into `ChainId` structures.
   - `ChainId::try_into_network_cfg` converts a chain into a `NetworkCfg` by
     selecting the first acceptable RPC URL (non‑WS and without `API_KEY`
-    placeholders). Key is the chain’s `shortName`.
+    placeholders). Key is the chain’s `shortName`; when available, the first
+    HTTP(S) EIP-3091 explorer URL becomes the network's block explorer.
   - Conflicts in produced network keys across sources yield
     `ConflictingNetworks`.