gnd: Enforce asc compiler version 0.19.23

gnd's compilation output is sensitive to asc version changes, so we now
enforce that asc version 0.19.23 is installed. The version check runs
before compilation and provides helpful error messages with installation
instructions.

For cases where bypassing the check is necessary, users can use either:
- --skip-asc-version-check flag
- GND_SKIP_ASC_VERSION_CHECK=1 environment variable

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: lutter

gnd/src/commands/build.rs

@@ -59,6 +59,10 @@ pub struct BuildOpt {
     /// Networks config file path
     #[clap(long, default_value = "networks.json")]
     pub network_file: PathBuf,
+
+    /// Skip the asc version check (use with caution)
+    #[clap(long, env = "GND_SKIP_ASC_VERSION_CHECK")]
+    pub skip_asc_version_check: bool,
 }
 
 /// Result of a build operation.
@@ -238,6 +242,7 @@ async fn build_subgraph(opt: &BuildOpt) -> Result<BuildResult> {
                 &global_file,
                 &opt.output_format,
                 &mut compiled_files,
+                opt.skip_asc_version_check,
             )?;
         }
     }
@@ -255,6 +260,7 @@ async fn build_subgraph(opt: &BuildOpt) -> Result<BuildResult> {
                 &global_file,
                 &opt.output_format,
                 &mut compiled_files,
+                opt.skip_asc_version_check,
             )?;
         }
     }
@@ -551,6 +557,7 @@ fn compile_data_source_mapping(
     global_file: &Path,
     output_format: &str,
     compiled_files: &mut HashSet<String>,
+    skip_version_check: bool,
 ) -> Result<()> {
     let cache_key = file_hash(mapping_path)?;
 
@@ -582,6 +589,7 @@ fn compile_data_source_mapping(
         global_file: global_file.to_path_buf(),
         output_file,
         output_format: output_format.to_string(),
+        skip_version_check,
     };
 
     compile_mapping(&options)?;
@@ -601,6 +609,7 @@ fn compile_template_mapping(
     global_file: &Path,
     output_format: &str,
     compiled_files: &mut HashSet<String>,
+    skip_version_check: bool,
 ) -> Result<()> {
     let cache_key = file_hash(mapping_path)?;
 
@@ -638,6 +647,7 @@ fn compile_template_mapping(
         global_file: global_file.to_path_buf(),
         output_file,
         output_format: output_format.to_string(),
+        skip_version_check,
     };
 
     compile_mapping(&options)?;

gnd/src/commands/deploy.rs

@@ -70,6 +70,10 @@ pub struct DeployOpt {
     /// Fork subgraph ID for debugging
     #[clap(long)]
     pub debug_fork: Option<String>,
+
+    /// Skip the asc version check (use with caution)
+    #[clap(long, env = "GND_SKIP_ASC_VERSION_CHECK")]
+    pub skip_asc_version_check: bool,
 }
 
 /// Run the deploy command.
@@ -135,6 +139,7 @@ async fn build_and_upload(opt: &DeployOpt) -> Result<String> {
         ipfs: Some(opt.ipfs.clone()),
         network: opt.network.clone(),
         network_file: opt.network_file.clone(),
+        skip_asc_version_check: opt.skip_asc_version_check,
     };
 
     match run_build(build_opt).await? {

gnd/src/commands/publish.rs

@@ -64,6 +64,10 @@ pub struct PublishOpt {
     /// Networks config file path
     #[clap(long, default_value = "networks.json")]
     pub network_file: PathBuf,
+
+    /// Skip the asc version check (use with caution)
+    #[clap(long, env = "GND_SKIP_ASC_VERSION_CHECK")]
+    pub skip_asc_version_check: bool,
 }
 
 /// Run the publish command.
@@ -118,6 +122,7 @@ pub async fn run_publish(opt: PublishOpt) -> Result<()> {
             ipfs: Some(opt.ipfs),
             network: opt.network,
             network_file: opt.network_file,
+            skip_asc_version_check: opt.skip_asc_version_check,
         };
 
         match run_build(build_opt).await? {

gnd/src/compiler/asc.rs

@@ -23,13 +23,44 @@ pub struct AscCompileOptions {
     pub output_file: PathBuf,
     /// Output format: "wasm" or "wast".
     pub output_format: String,
+    /// Skip the asc version check (use with caution).
+    pub skip_version_check: bool,
 }
 
+/// The required AssemblyScript compiler version.
+/// gnd functionality is very sensitive to asc version changes.
+const REQUIRED_ASC_VERSION: &str = "0.19.23";
+
 /// Compile an AssemblyScript mapping file to WebAssembly.
 ///
 /// This shells out to the `asc` command-line tool with the appropriate flags
 /// to match the graph-cli behavior.
+///
+/// Requires asc version 0.19.23 to be installed.
 pub fn compile_mapping(options: &AscCompileOptions) -> Result<()> {
+    // Check that asc is available
+    if !is_asc_available() {
+        return Err(anyhow!(
+            "AssemblyScript compiler (asc) not found. Please install it with:\n  \
+             npm install -g assemblyscript@{REQUIRED_ASC_VERSION}"
+        ));
+    }
+
+    // Check version unless explicitly skipped
+    if !options.skip_version_check {
+        let version = get_asc_version()?;
+        if version != REQUIRED_ASC_VERSION {
+            return Err(anyhow!(
+                "AssemblyScript compiler version mismatch: found {}, required {}.\n  \
+                 Please install the correct version with:\n  \
+                 npm install -g assemblyscript@{REQUIRED_ASC_VERSION}\n\n  \
+                 If you know what you're doing, use --skip-asc-version-check or set GND_SKIP_ASC_VERSION_CHECK=1 to bypass this check.",
+                version,
+                REQUIRED_ASC_VERSION
+            ));
+        }
+    }
+
     // Determine input and output paths relative to base_dir
     let input_rel = options
         .input_file
@@ -147,8 +178,7 @@ pub fn find_graph_ts(source_dir: &Path) -> Result<(Vec<PathBuf>, PathBuf)> {
 }
 
 /// Check if the asc compiler is available.
-#[allow(dead_code)]
-pub fn is_asc_available() -> bool {
+fn is_asc_available() -> bool {
     Command::new("asc")
         .arg("--version")
         .output()
@@ -157,8 +187,7 @@ pub fn is_asc_available() -> bool {
 }
 
 /// Get the asc compiler version.
-#[allow(dead_code)]
-pub fn get_asc_version() -> Result<String> {
+fn get_asc_version() -> Result<String> {
     let output = Command::new("asc")
         .arg("--version")
         .output()
@@ -168,7 +197,13 @@ pub fn get_asc_version() -> Result<String> {
         return Err(anyhow!("asc --version failed"));
     }
 
-    let version = String::from_utf8_lossy(&output.stdout).trim().to_string();
+    // Output is "Version X.Y.Z", extract just the version number
+    let version_output = String::from_utf8_lossy(&output.stdout);
+    let version = version_output
+        .trim()
+        .strip_prefix("Version ")
+        .unwrap_or(version_output.trim())
+        .to_string();
     Ok(version)
 }
 
@@ -207,9 +242,18 @@ mod tests {
     }
 
     #[test]
-    fn test_is_asc_available() {
-        // This test just verifies the function doesn't panic
-        // The actual result depends on whether asc is installed
-        let _ = is_asc_available();
+    fn test_asc_version_check() {
+        // Skip if asc is not installed
+        if !is_asc_available() {
+            return;
+        }
+
+        let version = get_asc_version().unwrap();
+        // Version should be a semver-like string (e.g., "0.19.23")
+        assert!(
+            version.split('.').count() >= 2,
+            "Version '{}' doesn't look like a semver",
+            version
+        );
     }
 }