commetns

Signed-off-by: bennett <bennett@umaproject.org>

Author: bmzig

script/universal/DeploySP1Helios.s.sol

@@ -10,6 +10,8 @@ import { SP1MockVerifier } from "@sp1-contracts/src/SP1MockVerifier.sol";
 /// @notice Deploy script for the SP1Helios contract.
 /// @dev This script downloads the genesis binary from the SP1Helios GitHub releases,
 ///      runs it to generate the genesis.json, then deploys the SP1Helios contract.
+/// @dev Be familiar with the README in this directory before deploying, as there are time
+/// considerations and follow-up transactions to execute after deployments.
 ///
 /// How to run:
 /// 1. Set environment variables in .env:

script/universal/DeployUniversalSpokePool.s.sol

@@ -11,6 +11,8 @@ import { ITokenMessenger } from "../../contracts/external/interfaces/CCTPInterfa
 /// @title DeployUniversalSpokePool
 /// @notice Deploy script for the Universal_SpokePool contract.
 /// @dev See script/universal/README.md for detailed usage instructions.
+/// @dev Be familiar with the README in this directory before deploying, as there are time
+/// considerations and follow-up transactions to execute after deployments.
 ///
 /// Example:
 ///   forge script script/universal/DeployUniversalSpokePool.s.sol:DeployUniversalSpokePool \

script/universal/README.md

@@ -10,6 +10,11 @@ This guide covers deploying the **Universal SpokePool** infrastructure to a new
 - A funded deployer wallet (via mnemonic)
 - `generated/constants.json` with chain configuration (run `yarn generate-constants` if missing)
 
+## A Note to Deployers
+
+When you deploy a new Universal Spoke pool to be used by Across, there is a time limit you must follow from Sp1Helios deployment to config store activation.
+The SP1Helios contract has a constant `MAX_SLOT_AGE = 7 days`, which is the upper-bound on how long updates may be spaced apart from each other. If the `stateUpdater` is not actively updating helios within seven days of deployment, the Sp1Helios contract will revert to a state where no further updates can be made, and by extension the Universal spoke will become inert and must be upgraded by the `owner` (where the upgrade implementation candidate has a fresh Sp1Helios contract set in its constructor).
+
 ## Environment Variables
 
 Create a `.env` file with the following variables: