docs: add moderato zonefactory to readme (#353)

Author: mattsse

README.md

@@ -39,6 +39,14 @@ just deploy-zone my-zone alphausd
 - Generate `generated/<name>/genesis.json` and `generated/<name>/zone.json`
 - Register the sequencer encryption key and start the zone node
 
+### Key Addresses
+
+| Contract | Address | Explorer |
+|----------|---------|----------|
+| ZoneFactory (moderato) | `0x7Cc496Dc634b718289c192b59CF90262C5228545` | [View on Moderato explorer](https://explore.moderato.tempo.xyz/address/0x7Cc496Dc634b718289c192b59CF90262C5228545) |
+
+`just create-zone`, `just deploy-zone`, and `just zone-info` default to this Moderato `ZoneFactory`. `just deploy-router` also falls back to it when `zone.json` does not already include `zoneFactory`.
+
 `zone.json` stores the deployed portal address, zone ID, anchor block, and sequencer metadata used by later commands such as `just zone-up` and `just deploy-router`.
 
 To restart the same zone later:

docs/ZONES.md

@@ -449,6 +449,8 @@ graph TB
 | pathUSD (TIP-20) | `0x20C0000000000000000000000000000000000000` |
 | ZoneFactory (moderato) | `0x7Cc496Dc634b718289c192b59CF90262C5228545` |
 
+The xtasks use this Moderato `ZoneFactory` as their built-in default: `create-zone` and `zone-info` point at it automatically, and `deploy-router` falls back to it when `zone.json` does not already record `zoneFactory`.
+
 ### Zone Node CLI Options
 
 | Flag | Default | Description |

xtask/src/create_zone.rs

@@ -61,7 +61,7 @@ pub(crate) struct CreateZone {
     l1_rpc_url: String,
 
     /// ZoneFactory contract address on Tempo L1.
-    /// Default is the ZoneFactory deployed on moderato.
+    /// Defaults to `MODERATO_ZONE_FACTORY`, the shared Moderato deployment.
     #[arg(long, default_value_t = MODERATO_ZONE_FACTORY)]
     zone_factory: Address,
 

xtask/src/deploy_router.rs

@@ -33,7 +33,8 @@ pub(crate) struct DeployRouter {
     #[arg(long, env = "PRIVATE_KEY")]
     private_key: String,
 
-    /// ZoneFactory contract address. Falls back to zone.json, then the moderato default.
+    /// ZoneFactory contract address.
+    /// Falls back to `zone.json`, then `MODERATO_ZONE_FACTORY` on Moderato.
     #[arg(long)]
     zone_factory: Option<Address>,
 

xtask/src/zone_info.rs

@@ -15,6 +15,7 @@ pub(crate) struct ZoneInfoCmd {
     l1_rpc_url: String,
 
     /// ZoneFactory contract address on Tempo L1.
+    /// Defaults to `MODERATO_ZONE_FACTORY`, the shared Moderato deployment.
     #[arg(long, default_value_t = MODERATO_ZONE_FACTORY)]
     zone_factory: Address,
 }

xtask/src/zone_utils.rs

@@ -16,6 +16,11 @@ use tempo_contracts::precompiles::ITIP20 as TIP20Token;
 use zone::abi::{ZoneInbox, ZonePortal};
 
 pub(crate) const L1_EXPLORER: &str = "https://explore.moderato.tempo.xyz/tx";
+/// Shared ZoneFactory deployed on Moderato Tempo L1.
+/// `create-zone`, `deploy-router`, and `zone-info` use this as their default
+/// factory unless the caller overrides `--zone-factory` or `zone.json` already
+/// provides a zone-specific value.
+/// Explorer: https://explore.moderato.tempo.xyz/address/0x7Cc496Dc634b718289c192b59CF90262C5228545
 pub(crate) const MODERATO_ZONE_FACTORY: Address =
     address!("0x7Cc496Dc634b718289c192b59CF90262C5228545");
 pub(crate) const STABLECOIN_DEX_ADDRESS: Address =