add deployment script

Author: tserg

scripts/deployment/Scarb.toml

@@ -26,6 +26,7 @@ build-external-contracts = [
     "opus::core::flash_mint::flash_mint",
     "opus::core::gate::gate",
     "opus::core::purger::purger",
+    "opus::core::receptor::receptor",
     "opus::core::seer::seer",
     "opus::core::sentinel::sentinel",
     "opus::core::shrine::shrine",

scripts/deployment/src/core_deployment.cairo

@@ -1,3 +1,4 @@
+use scripts::addresses;
 use scripts::constants::MAX_FEE;
 use sncast_std::{
     declare, DeclareResult, deploy, DeployResult, DisplayClassHash, DisplayContractAddress, invoke, InvokeResult,
@@ -14,6 +15,10 @@ const BETA_P: u8 = 8;
 const ALPHA_I: u8 = 1;
 const BETA_I: u8 = 2;
 
+// Constants for Receptor
+const RECEPTOR_UPDATE_FREQUENCY: u64 = 1000;
+const RECEPTOR_TWAP_DURATION: u64 = 10800; // 3 hours
+
 // Constants for Seer
 const SEER_UPDATE_FREQUENCY: u64 = 1000;
 
@@ -189,6 +194,29 @@ pub fn deploy_controller(admin: ContractAddress, shrine: ContractAddress) -> Con
     deploy_controller.contract_address
 }
 
+pub fn deploy_receptor(admin: ContractAddress, shrine: ContractAddress) -> ContractAddress {
+    let declare_receptor = declare("receptor", Option::Some(MAX_FEE), Option::None).expect('failed receptor declare');
+
+    let num_quote_tokens: felt252 = 3;
+    let receptor_calldata: Array<felt252> = array![
+        admin.into(),
+        shrine.into(),
+        addresses::mainnet::ekubo_oracle_extension().into(),
+        RECEPTOR_UPDATE_FREQUENCY.into(),
+        RECEPTOR_TWAP_DURATION.into(),
+        num_quote_tokens,
+        addresses::mainnet::dai().into(),
+        addresses::mainnet::usdc().into(),
+        addresses::mainnet::usdt().into(),
+    ];
+    let deploy_receptor = deploy(
+        declare_receptor.class_hash, receptor_calldata, Option::None, true, Option::Some(MAX_FEE), Option::None
+    )
+        .expect('failed receptor deploy');
+
+    deploy_receptor.contract_address
+}
+
 pub fn declare_gate() -> ClassHash {
     declare("gate", Option::Some(MAX_FEE), Option::None).expect('failed gate declare').class_hash
 }

scripts/deployment/src/deploy_mainnet.cairo

@@ -17,7 +17,7 @@ fn main() {
 
     println!("Deploying contracts");
 
-    // Deploy core contracts
+    // Deploy core contracts for launch
     let shrine: ContractAddress = core_deployment::deploy_shrine(admin);
     let flash_mint: ContractAddress = core_deployment::deploy_flash_mint(shrine);
     let sentinel: ContractAddress = core_deployment::deploy_sentinel(admin, shrine);
@@ -30,6 +30,9 @@ fn main() {
     let caretaker: ContractAddress = core_deployment::deploy_caretaker(admin, shrine, abbot, sentinel, equalizer);
     let controller: ContractAddress = core_deployment::deploy_controller(admin, shrine);
 
+    // Deploy core contracts after launch
+    let receptor: ContractAddress = core_deployment::deploy_receptor(addresses::mainnet::multisig(), shrine);
+
     // Deploy transmuter
     let usdc_transmuter_restricted: ContractAddress = core_deployment::deploy_transmuter_restricted(
         admin, shrine, addresses::mainnet::usdc(), admin, constants::USDC_TRANSMUTER_RESTRICTED_DEBT_CEILING

scripts/src/addresses.cairo

@@ -211,22 +211,39 @@ pub mod mainnet {
     }
 
     // Tokens
-
+    //
+    // Unless otherwise stated, token's address is available at:
     // https://github.com/starknet-io/starknet-addresses/blob/master/bridged_tokens/mainnet.json
+
+    pub fn dai() -> ContractAddress {
+        0x05574eb6b8789a91466f902c380d978e472db68170ff82a5b650b95a58ddf4ad.try_into().expect('invalid DAI address')
+    }
+
     pub fn usdc() -> ContractAddress {
         0x053c91253bc9682c04929ca02ed00b3e423f6710d2ee7e0d5ebb06f3ecf368a8.try_into().expect('invalid USDC address')
     }
 
-    // https://github.com/starknet-io/starknet-addresses/blob/master/bridged_tokens/mainnet.json
+    pub fn usdt() -> ContractAddress {
+        0x068f5c6a61780768455de69077e07e89787839bf8166decfbf92b645209c0fb8.try_into().expect('invalid USDC address')
+    }
+
     pub fn wbtc() -> ContractAddress {
         0x03fe2b97c1fd336e750087d68b9b867997fd64a2661ff3ca5a7c771641e8e7ac.try_into().expect('invalid WBTC address')
     }
 
-    // https://research.lido.fi/t/wsteth-deployment-on-starknet/6335
     pub fn wsteth() -> ContractAddress {
         0x042b8f0484674ca266ac5d08e4ac6a3fe65bd3129795def2dca5c34ecc5f96d2.try_into().expect('invalid WSTETH address')
     }
 
+    // External
+
+    // https://docs.ekubo.org/integration-guides/reference/contract-addresses
+    pub fn ekubo_oracle_extension() -> ContractAddress {
+        0x005e470ff654d834983a46b8f29dfa99963d5044b993cb7b9c92243a69dab38f
+            .try_into()
+            .expect('invalid ekubo oracle addr');
+    }
+
     // https://github.com/Astraly-Labs/pragma-oracle?tab=readme-ov-file#deployment-addresses
     pub fn pragma_spot_oracle() -> ContractAddress {
         0x2a85bd616f912537c50a49a4076db02c00b29b2cdc8a197ce92ed1837fa875b