Merge pull request #100 from Code-Paragon/feature/issue-51-wasm-compression

build: Automate Contract WASM Compression Pipeline (#51)

Author: elizabetheonoja-art

.github/workflows/wasm-compression.yml

@@ -0,0 +1,32 @@
+name: WASM Build & Compress
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build_and_compress:
+    runs-on: ubuntu-latest
+
+    defaults:
+      run:
+        working-directory: contracts/substream_contracts
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - name: Install wasm-opt
+        run: npm install -g wasm-opt
+
+      - name: Make script executable
+        run: chmod +x scripts/compress_wasm.sh
+
+      - name: Build and Compress WASM
+        run: make build-compressed

.idea/.gitignore

@@ -22,3 +22,13 @@ lto = true
 [profile.release-with-logs]
 inherits = "release"
 debug-assertions = true
+
+# ==========================================
+# Issue #51: WASM Size Optimization Profile
+# ==========================================
+[profile.release]
+opt-level = "z"        # Optimize for size
+lto = true             # Enable Link Time Optimization (removes dead code)
+codegen-units = 1      # Compile crate as a single unit for maximum optimization
+panic = "abort"        # Remove panic unwinding (saves significant space)
+strip = "debuginfo"    # Strip debug info but keep symbols for error tracing

.idea/vcs.xml

@@ -0,0 +1,47 @@
+#!/bin/bash
+# Exit immediately if a command exits with a non-zero status
+set -e
+
+echo "🔨 Building release WASM..."
+cargo build --target wasm32-unknown-unknown --release
+
+# Find the generated WASM file
+WASM_FILE=$(find target/wasm32-unknown-unknown/release -maxdepth 1 -name "*.wasm" | grep -v "_opt" | head -n 1)
+if [ -z "$WASM_FILE" ]; then
+    echo "❌ Error: Could not find compiled WASM file in target directory."
+    exit 1
+fi
+
+# Define the output optimized file name
+OPT_WASM_FILE="${WASM_FILE%.wasm}_opt.wasm"
+
+# Check for wasm-opt dependency
+if ! command -v wasm-opt &> /dev/null; then
+    echo "⚠️ wasm-opt could not be found."
+    echo "Installing via npm (requires Node.js)..."
+    npm install -g wasm-opt
+fi
+
+echo "🗜️ Optimizing WASM with wasm-opt..."
+# -Oz: aggressive size optimization
+# --signext-lowering: required for Soroban compatibility
+wasm-opt -Oz "$WASM_FILE" -o "$OPT_WASM_FILE"
+
+# Calculate and display savings
+ORIGINAL_SIZE=$(wc -c <"$WASM_FILE")
+OPT_SIZE=$(wc -c <"$OPT_WASM_FILE")
+SAVINGS=$(( ORIGINAL_SIZE - OPT_SIZE ))
+PERCENTAGE=$(( SAVINGS * 100 / ORIGINAL_SIZE ))
+
+echo "=========================================="
+echo "✅ WASM Compression Complete!"
+echo "Original Size:  $ORIGINAL_SIZE bytes"
+echo "Optimized Size: $OPT_SIZE bytes"
+echo "Space Saved:    $SAVINGS bytes ($PERCENTAGE%)"
+echo "Output File:    $OPT_WASM_FILE"
+echo "=========================================="
+
+# Check 64KB Soroban limit guardrail
+if [ "$OPT_SIZE" -gt 65536 ]; then
+    echo "⚠️ WARNING: Optimized WASM is still over the 64KB Soroban deployment limit!"
+fi