feat(contracts): add VRF contracts and support multiple scarb versions

- Update build.rs to use asdf for scarb version management, allowing
  different scarb versions per directory via .tool-versions files
- Add VRF contracts compilation and artifact copying to build script
- Add doc comments with full hex strings for HASH and CASM_HASH constants
  in the contract! macro
- Add vrf module with CartridgeVrfProvider, CartridgeVrfConsumer, and
  CartridgeVrfAccount contracts

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

Author: kariy

.gitmodules

@@ -12,9 +12,9 @@
 	path = crates/explorer/ui
 	url = https://github.com/cartridge-gg/explorer
 	branch = main
-[submodule "contracts/vrf"]
-	path = contracts/vrf
-	url = https://github.com/cartridge-gg/vrf
 [submodule "crates/cartridge/controller"]
 	path = crates/cartridge/controller
 	url = https://github.com/cartridge-gg/controller-rs.git
+[submodule "crates/contracts/contracts/vrf"]
+	path = crates/contracts/contracts/vrf
+	url = https://github.com/cartridge-gg/vrf.git

crates/contracts/build.rs

@@ -17,15 +17,15 @@ fn main() {
     let target_dir = contracts_dir.join("target/dev");
     let build_dir = Path::new("build");
 
-    // Check if scarb is available
-    let scarb_available = Command::new("scarb")
-        .arg("--version")
+    // Check if asdf is available (used to manage scarb versions)
+    let asdf_available = Command::new("asdf")
+        .args(["exec", "scarb", "--version"])
         .output()
         .map(|output| output.status.success())
         .unwrap_or(false);
 
-    if !scarb_available {
-        println!("cargo:warning=scarb not found in PATH, skipping contract compilation");
+    if !asdf_available {
+        println!("cargo:warning=asdf or scarb not found, skipping contract compilation");
         return;
     }
 
@@ -34,11 +34,11 @@ fn main() {
         return;
     }
 
-    println!("cargo:warning=Building contracts with scarb...");
+    println!("cargo:warning=Building main contracts with scarb...");
 
-    // Run scarb build in the contracts directory
-    let output = Command::new("scarb")
-        .arg("build")
+    // Run scarb build in the contracts directory (uses asdf to pick correct scarb version)
+    let output = Command::new("asdf")
+        .args(["exec", "scarb", "build"])
         .current_dir(contracts_dir)
         .output()
         .expect("Failed to execute scarb build");
@@ -56,24 +56,39 @@ fn main() {
             .join("\n");
 
         panic!(
-            "Contract compilation build script failed. Below are the last 50 lines of `scarb \
-             build` output:\n\n{last_n_lines}"
+            "Main contracts compilation failed. Below are the last 50 lines of `scarb build` \
+             output:\n\n{last_n_lines}"
         );
     }
 
+    // Build VRF contracts (uses different scarb version via asdf)
+    let vrf_dir = contracts_dir.join("vrf");
+    build_vrf_contracts(&vrf_dir);
+
     // Create build directory if it doesn't exist
     if let Err(e) = fs::create_dir_all(build_dir) {
         panic!("Failed to create build directory: {e}");
     }
 
-    // Copy artifacts from target/dev to build directory
+    // Copy main contract artifacts from target/dev to build directory
     if target_dir.exists() {
         if let Err(e) = copy_dir_contents(&target_dir, build_dir) {
-            panic!("Failed to copy contract artifacts: {e}");
+            panic!("Failed to copy main contract artifacts: {e}");
         }
-        println!("cargo:warning=Contract artifacts copied to build directory");
+        println!("cargo:warning=Main contract artifacts copied to build directory");
     } else {
-        println!("cargo:warning=No contract artifacts found in target/dev");
+        println!("cargo:warning=No main contract artifacts found in target/dev");
+    }
+
+    // Copy VRF contract artifacts from vrf/target/dev to build directory
+    let vrf_target_dir = vrf_dir.join("target/dev");
+    if vrf_target_dir.exists() {
+        if let Err(e) = copy_dir_contents(&vrf_target_dir, build_dir) {
+            panic!("Failed to copy VRF contract artifacts: {e}");
+        }
+        println!("cargo:warning=VRF contract artifacts copied to build directory");
+    } else {
+        println!("cargo:warning=No VRF contract artifacts found in vrf/target/dev");
     }
 }
 
@@ -89,3 +104,31 @@ fn copy_dir_contents(src: &Path, dst: &Path) -> std::io::Result<()> {
     }
     Ok(())
 }
+
+fn build_vrf_contracts(vrf_dir: &Path) {
+    println!("cargo:warning=Building VRF contracts with scarb...");
+
+    let output = Command::new("asdf")
+        .args(["exec", "scarb", "build"])
+        .current_dir(vrf_dir)
+        .output()
+        .expect("Failed to execute scarb build for VRF contracts");
+
+    if !output.status.success() {
+        let logs = String::from_utf8_lossy(&output.stdout);
+        let last_n_lines = logs
+            .split('\n')
+            .rev()
+            .take(50)
+            .collect::<Vec<&str>>()
+            .into_iter()
+            .rev()
+            .collect::<Vec<&str>>()
+            .join("\n");
+
+        panic!(
+            "VRF contracts compilation failed. Below are the last 50 lines of `scarb build` \
+             output:\n\n{last_n_lines}"
+        );
+    }
+}