[FINAL] feat: Canister backup and restore

spec/_attachments/ic.did

@@ -1,5 +1,6 @@
 type canister_id = principal;
 type wasm_module = blob;
+type snapshot_id = blob;
 
 type log_visibility = variant {
  controllers;
@@ -45,6 +46,11 @@ type change_details = variant {
  mode : variant { install; reinstall; upgrade };
  module_hash : blob;
  };
+ load_snapshot : record {
+ canister_version : nat64;
+ snapshot_id : snapshot_id;
+ taken_at_timestamp : nat64;
+ };
  controllers_change : record {
  controllers : vec principal;
  };
@@ -358,6 +364,36 @@ type stored_chunks_result = vec chunk_hash;
 
 type upload_chunk_result = chunk_hash;
 
+type snapshot = record {
+ id : snapshot_id;
+ taken_at_timestamp : nat64;
+ total_size : nat64;
+};
+
+type take_canister_snapshot_args = record {
+ canister_id : canister_id;
+ replace_snapshot : opt snapshot_id;
+};
+
+type take_canister_snapshot_result = snapshot;
+
+type load_canister_snapshot_args = record {
+ canister_id : canister_id;
+ snapshot_id : snapshot_id;
+ sender_canister_version : opt nat64;
+};
+
+type list_canister_snapshots_args = record {
+ canister_id : canister_id;
+};
+
+type list_canister_snapshots_result = vec snapshot;
+
+type delete_canister_snapshot_args = record {
+ canister_id : canister_id;
+ snapshot_id : snapshot_id;
+};
+
 type fetch_canister_logs_args = record {
  canister_id : canister_id;
 };
@@ -412,6 +448,12 @@ service ic : {
  provisional_create_canister_with_cycles : (provisional_create_canister_with_cycles_args) -> (provisional_create_canister_with_cycles_result);
  provisional_top_up_canister : (provisional_top_up_canister_args) -> ();
 
+ // Canister snapshots
+ take_canister_snapshot : (take_canister_snapshot_args) -> (take_canister_snapshot_result);
+ load_canister_snapshot : (load_canister_snapshot_args) -> ();
+ list_canister_snapshots : (list_canister_snapshots_args) -> (list_canister_snapshots_result);
+ delete_canister_snapshot : (delete_canister_snapshot_args) -> ();
+
  // canister logging
  fetch_canister_logs : (fetch_canister_logs_args) -> (fetch_canister_logs_result) query;
 };

spec/_attachments/interface-spec-changelog.md

@@ -1,6 +1,7 @@
 ## Changelog {#changelog}
 
 ### ∞ (unreleased)
+* Add new management canister methods for canister snapshot support.
 
 ### 0.27.0 (2024-09-20) {#0_27_0}
 * EXPERIMENTAL: Management canister API to fetch Bitcoin block headers.