Merge branch 'mraszyk/ic00-canister-info' into 'master'

feat: Add canister_info management canister call

This MR adds a new management canister call called `canister_info` to retrieve public information about a canister. Its Candid type is
```
canister_info : (record {
      canister_id : canister_id;
      num_requested_changes : opt nat64;
  }) -> (record {
      total_num_changes : nat64;
      changes : vec canister_change;
      module_hash : opt blob;
      controllers : vec principal;
  });
``` 

See merge request dfinity-lab/public/ic!12603

Author: mraszyk

rs/execution_environment/src/canister_manager.rs

@@ -311,6 +311,7 @@ impl CanisterManager {
             // are not allowed to send.
             Err(_)
             | Ok(Ic00Method::CreateCanister)
+            | Ok(Ic00Method::CanisterInfo)
             | Ok(Ic00Method::ECDSAPublicKey)
             | Ok(Ic00Method::SetupInitialDKG)
             | Ok(Ic00Method::SignWithECDSA)

rs/execution_environment/src/execution_environment.rs

@@ -24,12 +24,12 @@ use ic_crypto_tecdsa::derive_tecdsa_public_key;
 use ic_cycles_account_manager::{CyclesAccountManager, IngressInductionCost};
 use ic_error_types::{ErrorCode, RejectCode, UserError};
 use ic_ic00_types::{
-    CanisterChangeOrigin, CanisterHttpRequestArgs, CanisterIdRecord, CanisterSettingsArgs,
-    ComputeInitialEcdsaDealingsArgs, CreateCanisterArgs, ECDSAPublicKeyArgs,
-    ECDSAPublicKeyResponse, EcdsaKeyId, EmptyBlob, InstallCodeArgs, Method as Ic00Method,
-    Payload as Ic00Payload, ProvisionalCreateCanisterWithCyclesArgs, ProvisionalTopUpCanisterArgs,
-    SetControllerArgs, SetupInitialDKGArgs, SignWithECDSAArgs, UninstallCodeArgs,
-    UpdateSettingsArgs, IC_00,
+    CanisterChangeOrigin, CanisterHttpRequestArgs, CanisterIdRecord, CanisterInfoRequest,
+    CanisterInfoResponse, CanisterSettingsArgs, ComputeInitialEcdsaDealingsArgs,
+    CreateCanisterArgs, ECDSAPublicKeyArgs, ECDSAPublicKeyResponse, EcdsaKeyId, EmptyBlob,
+    InstallCodeArgs, Method as Ic00Method, Payload as Ic00Payload,
+    ProvisionalCreateCanisterWithCyclesArgs, ProvisionalTopUpCanisterArgs, SetControllerArgs,
+    SetupInitialDKGArgs, SignWithECDSAArgs, UninstallCodeArgs, UpdateSettingsArgs, IC_00,
 };
 use ic_interfaces::{
     execution_environment::{
@@ -657,6 +657,23 @@ impl ExecutionEnvironment {
                 Some((res, msg.take_cycles()))
             }
 
+            Ok(Ic00Method::CanisterInfo) => match &msg {
+                CanisterCall::Request(_) => {
+                    let res = match CanisterInfoRequest::decode(payload) {
+                        Err(err) => Err(err),
+                        Ok(record) => self.get_canister_info(
+                            record.canister_id(),
+                            record.num_requested_changes(),
+                            &state,
+                        ),
+                    };
+                    Some((res, msg.take_cycles()))
+                }
+                CanisterCall::Ingress(_) => {
+                    self.reject_unexpected_ingress(Ic00Method::CanisterInfo)
+                }
+            },
+
             Ok(Ic00Method::StartCanister) => {
                 let res = match CanisterIdRecord::decode(payload) {
                     Err(err) => Err(err),
@@ -1354,6 +1371,32 @@ impl ExecutionEnvironment {
             .map_err(|err| err.into())
     }
 
+    fn get_canister_info(
+        &self,
+        canister_id: CanisterId,
+        num_requested_changes: Option<u64>,
+        state: &ReplicatedState,
+    ) -> Result<Vec<u8>, UserError> {
+        let canister = get_canister(canister_id, state)?;
+        let canister_history = canister.system_state.get_canister_history();
+        let total_num_changes = canister_history.get_total_num_changes();
+        let changes = canister_history
+            .get_changes(num_requested_changes.unwrap_or(0) as usize)
+            .map(|e| (*e.clone()).clone())
+            .collect();
+        let module_hash = canister
+            .execution_state
+            .as_ref()
+            .map(|es| es.wasm_binary.binary.module_hash().to_vec());
+        let controllers = canister
+            .controllers()
+            .iter()
+            .copied()
+            .collect::<Vec<PrincipalId>>();
+        let res = CanisterInfoResponse::new(total_num_changes, changes, module_hash, controllers);
+        Ok(res.encode())
+    }
+
     fn stop_canister(
         &self,
         canister_id: CanisterId,
@@ -2335,6 +2378,19 @@ pub(crate) fn subnet_memory_capacity(config: &ExecutionConfig) -> SubnetAvailabl
     )
 }
 
+fn get_canister(
+    canister_id: CanisterId,
+    state: &ReplicatedState,
+) -> Result<&CanisterState, UserError> {
+    match state.canister_state(&canister_id) {
+        Some(canister) => Ok(canister),
+        None => Err(UserError::new(
+            ErrorCode::CanisterNotFound,
+            format!("Canister {} not found.", &canister_id),
+        )),
+    }
+}
+
 fn get_canister_mut(
     canister_id: CanisterId,
     state: &mut ReplicatedState,

rs/execution_environment/src/scheduler.rs

@@ -2124,6 +2124,7 @@ fn get_instructions_limits_for_subnet_message(
     match Ic00Method::from_str(method_name) {
         Ok(method) => match method {
             CanisterStatus
+            | CanisterInfo
             | CreateCanister
             | DeleteCanister
             | DepositCycles