feat: artifact support

Cargo.toml

@@ -24,6 +24,9 @@ upon = { version = "0.9.0", default-features = false, features = [
 ] }
 colored = "3.0.0"
 
+[build-dependencies]
+cargo_toml = "0.22.3"
+
 [dev-dependencies]
 tempdir = "0.3.7"
 

build.rs

@@ -1,6 +1,34 @@
 use std::process::Command;
 
+use cargo_toml::Manifest;
+
 fn main() {
+    let toml_contents = std::fs::read("Cargo.toml").expect("Failed to find Cargo.toml");
+    let manifest =
+        Manifest::from_slice(&toml_contents).expect("Failed to parse Cargo.toml as Manifest");
+    let curl_version = {
+        let curl = manifest
+            .dependencies
+            .get("curl")
+            .expect("Couldn't find curl in parsed manifest");
+        match curl {
+            cargo_toml::Dependency::Simple(ver) => ver,
+            cargo_toml::Dependency::Detailed(detail) => &detail.version.as_ref().unwrap().clone(),
+            // This case should not happen since we are reading the root Cargo.toml
+            cargo_toml::Dependency::Inherited(_) => {
+                panic!("Couldn't determine curl version since it appears as inherited.")
+            },
+        }
+    };
+    // Pass the $CURL_VERSION to the crate at compile time.
+    println!("cargo:rustc-env=CURL_VERSION={}", curl_version);
+
+    // Pass the $TARGET to the crate at compile time.
+    println!(
+        "cargo:rustc-env=TARGET={}",
+        std::env::var("TARGET").expect("Failed to obtain $TARGET triple constant.")
+    );
+
     // Generated by cargo at runtime when the build script is run:
     // https://doc.rust-lang.org/cargo/reference/environment-variables.html#environment-variables-cargo-sets-for-build-scripts
     let build_script = std::env::var("OUT_DIR").unwrap();

manifest/channel-manifest.json

@@ -269,6 +269,15 @@
           "aliases": {
               "start-node": ["executable", "bundled", "start",  "--data-directory", "var_path", "data", "--rpc.url", "http://0.0.0.0:57291"]
           }
+        },
+        {
+          "name": "debug",
+          "package": "miden-debug",
+          "version": "0.4.4",
+          "installed_executable": "miden-debug",
+          "artifacts": [
+             "https://github.com/0xMiden/miden-debug/releases/download/v0.4.4/miden-debug-aarch64-apple-darwin"
+          ]
         }
       ]
     }

src/artifact.rs

@@ -0,0 +1,66 @@
+use serde::{Deserialize, Serialize};
+
+/// All the artifacts that the [[Component]] contains.
+#[derive(Serialize, Deserialize, Debug, Clone)]
+pub struct Artifacts {
+    artifacts: Vec<Artifact>,
+}
+
+impl Artifacts {
+    /// Get a URI to download an artifact that's valid for [target].
+    pub fn get_uri_for(&self, target: &TargetTriple) -> Option<String> {
+        self.artifacts.iter().find_map(|artifact| artifact.get_uri_for(target))
+    }
+}
+
+/// Holds a URI used to fetch an artifact. These URIs have the following format:
+/// (https://|file://)<path>/<component name>(-<triplet>|.masp)
+#[derive(Serialize, Deserialize, Debug, Clone)]
+struct Artifact(String);
+
+#[derive(Debug, PartialEq)]
+pub enum TargetTriple {
+    /// Custom triplet used by cargo. Since we use the same triplets as cargo, we
+    /// simply copy them as-is, without any type of parsing.
+    Custom(String),
+    /// Used for .masp Libraries that are used in the MidenVM. Components that
+    /// have these libraries as artifacts only have one entry in
+    /// [[Artifacts::artifacts]].
+    MidenVM,
+}
+
+impl TargetTriple {
+    fn get_uri_extension(&self) -> String {
+        match &self {
+            Self::MidenVM => String::from(".masp"),
+            Self::Custom(triplet) => triplet.to_string(),
+        }
+    }
+}
+
+impl Artifact {
+    /// Returns the URI for the specified component + triplet if it has it.
+    ///
+    /// NOTE: The component name is required to separate the triplet from the
+    /// filename in the URI.
+    fn get_uri_for(&self, target: &TargetTriple) -> Option<String> {
+        let path = if let Some(file_path) = self.0.strip_prefix("file://") {
+            file_path
+        } else if let Some(url_path) = self.0.strip_prefix("https://") {
+            url_path
+        } else {
+            return None;
+        };
+
+        // <component name>(-<triplet>|.masp)
+        let uri_extension = path.split("/").last()?;
+
+        let wanted_uri_extension = target.get_uri_extension();
+
+        if uri_extension.contains(&wanted_uri_extension) {
+            Some(self.0.clone())
+        } else {
+            None
+        }
+    }
+}

src/channel.rs

@@ -3,7 +3,7 @@ use std::{
     collections::HashMap,
     fmt::{self, Display},
     hash::{Hash, Hasher},
-    path::PathBuf,
+    path::{Path, PathBuf},
 };
 
 use anyhow::{Context, bail};
@@ -12,6 +12,7 @@ use serde::{Deserialize, Serialize};
 
 use crate::{
     Config,
+    artifact::{Artifacts, TargetTriple},
     toolchain::{Toolchain, ToolchainJustification},
     utils,
     version::{Authority, GitTarget},
@@ -349,6 +350,14 @@ impl InstalledFile {
             InstalledFile::Library { library_struct, .. } => Some(library_struct),
         }
     }
+    pub fn get_path_from(&self, toolchain_dir: &Path) -> PathBuf {
+        match &self {
+            exe @ InstalledFile::Executable { .. } => {
+                toolchain_dir.join("bin").join(exe.to_string())
+            },
+            lib @ InstalledFile::Library { .. } => toolchain_dir.join("lib").join(lib.to_string()),
+        }
+    }
 }
 
 impl Display for InstalledFile {
@@ -521,6 +530,12 @@ pub struct Component {
     #[serde(default)]
     #[serde(skip_serializing_if = "Option::is_none")]
     symlink_name: Option<String>,
+    #[serde(default)]
+    #[serde(skip_serializing_if = "Vec::is_empty")]
+    pub initialization: Vec<String>,
+    /// Pre-built artifact.
+    #[serde(flatten)]
+    artifacts: Option<Artifacts>,
 }
 
 impl Component {
@@ -535,6 +550,8 @@ impl Component {
             installed_file: None,
             aliases: HashMap::new(),
             symlink_name: None,
+            initialization: Vec::new(),
+            artifacts: None,
         }
     }
 
@@ -698,6 +715,11 @@ impl Component {
             self.call_format.clone()
         }
     }
+
+    /// Returns the URI for a given [target] (if available).
+    pub fn get_artifact_uri(&self, target: &TargetTriple) -> Option<String> {
+        self.artifacts.as_ref().and_then(|artifacts| artifacts.get_uri_for(target))
+    }
 }
 
 /// User-facing channel reference. The main difference with this and [Channel]