fix: add proper dependency chain for frontend builds

CRITICAL FIX: Frontends need Candid-generated TypeScript declarations

Changes:
- Added Job 2: Generate TypeScript declarations from .did files
- Frontend builds now depend on declarations being available
- Proper build order: Canisters → Declarations → Frontends → Docker Image
- Updated documentation to reflect build pipeline

Build order:
1. Build IC canisters (Rust → WASM + .did files)
2. Generate TypeScript declarations using didc
3. Build frontends with IC declarations available
4. Create Docker runtime image

This fixes the missing dependency that would cause frontend builds
to fail when importing from @/declarations/*

Author: domwoe

.github/workflows/build-artifacts.yml

@@ -77,10 +77,84 @@ jobs:
           retention-days: 7
 
   # ============================================================================
-  # Job 2: Build Frontend Artifacts in Parallel
+  # Job 2: Generate TypeScript Bindings from Candid
+  # ============================================================================
+  generate-declarations:
+    runs-on: ubuntu-latest
+    needs: [build-canisters]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Download canister artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: ic-canisters
+          path: artifacts/canisters
+
+      - name: Install dfx
+        run: |
+          DFX_VERSION=0.29.1 sh -ci "$(curl -fsSL https://internetcomputer.org/install.sh)"
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Install didc (Candid compiler)
+        run: |
+          cargo install didc
+
+      - name: Generate TypeScript declarations
+        run: |
+          echo "📝 Generating TypeScript bindings from Candid files..."
+
+          # Create declarations output directory
+          mkdir -p src/declarations
+
+          # Generate declarations for each canister
+          for canister in btc_vault_backend mock_unlock ethereum_vault_unlock bitcoin_price_threshold; do
+            if [ -f "artifacts/canisters/${canister}.did" ]; then
+              echo "Generating declarations for $canister..."
+              mkdir -p "src/declarations/$canister"
+
+              # Generate TypeScript declarations using didc
+              didc bind "artifacts/canisters/${canister}.did" -t ts > "src/declarations/$canister/index.d.ts"
+              didc bind "artifacts/canisters/${canister}.did" -t js > "src/declarations/$canister/index.js"
+
+              # Copy the .did file
+              cp "artifacts/canisters/${canister}.did" "src/declarations/$canister/"
+            fi
+          done
+
+          # Download external canister declarations (evm_rpc, xrc, ic_siwb_provider)
+          mkdir -p src/declarations/evm_rpc
+          mkdir -p src/declarations/xrc
+          mkdir -p src/declarations/ic_siwb_provider
+
+          curl -fsSL https://github.com/internet-computer-protocol/evm-rpc-canister/releases/latest/download/evm_rpc.did -o src/declarations/evm_rpc/evm_rpc.did
+          curl -fsSL https://raw.githubusercontent.com/dfinity/exchange-rate-canister/refs/heads/main/src/xrc/xrc.did -o src/declarations/xrc/xrc.did
+
+          # Generate TypeScript for external canisters
+          didc bind src/declarations/evm_rpc/evm_rpc.did -t ts > src/declarations/evm_rpc/index.d.ts
+          didc bind src/declarations/evm_rpc/evm_rpc.did -t js > src/declarations/evm_rpc/index.js
+          didc bind src/declarations/xrc/xrc.did -t ts > src/declarations/xrc/index.d.ts
+          didc bind src/declarations/xrc/xrc.did -t js > src/declarations/xrc/index.js
+
+      - name: Upload declarations
+        uses: actions/upload-artifact@v4
+        with:
+          name: ic-declarations
+          path: src/declarations/
+          retention-days: 7
+
+  # ============================================================================
+  # Job 3: Build Frontend Artifacts (depends on declarations)
   # ============================================================================
   build-frontends:
     runs-on: ubuntu-latest
+    needs: [generate-declarations]
     strategy:
       matrix:
         frontend:
@@ -101,6 +175,20 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
+      - name: Download IC declarations (if needed)
+        if: matrix.frontend.needs_ic == true
+        uses: actions/download-artifact@v4
+        with:
+          name: ic-declarations
+          path: src/declarations
+
+      - name: Copy declarations to frontend (if needed)
+        if: matrix.frontend.needs_ic == true
+        run: |
+          echo "📋 Copying IC declarations to ${{ matrix.frontend.dir }}/src/declarations"
+          mkdir -p ${{ matrix.frontend.dir }}/src/declarations
+          cp -r src/declarations/* ${{ matrix.frontend.dir }}/src/declarations/
+
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
@@ -141,11 +229,11 @@ jobs:
           retention-days: 7
 
   # ============================================================================
-  # Job 3: Build and Push Docker Image
+  # Job 4: Build and Push Docker Image
   # ============================================================================
   build-image:
     runs-on: ubuntu-latest
-    needs: [build-canisters, build-frontends]
+    needs: [build-canisters, generate-declarations, build-frontends]
     permissions:
       contents: read
       packages: write

docs/CI_BUILT_IMAGES_MIGRATION.md

@@ -327,13 +327,18 @@ Breakdown:
 Total Deployment Time: 4 minutes
 
 Breakdown:
-├── CI build (parallel - already done): 0 min*
+├── CI build (already done in background): 0 min*
 ├── Pull pre-built image: 1 min
 ├── Deploy Ethereum contracts: 1 min
 ├── Deploy canisters: 1 min
 └── Start services: 1 min
 
-*CI build runs in background (6 minutes total, but parallel)
+*CI build pipeline (runs automatically on push):
+  Job 1: Build canisters (3 min)
+  Job 2: Generate declarations (1 min) - depends on Job 1
+  Job 3: Build frontends (2 min, parallel) - depends on Job 2
+  Job 4: Create Docker image (1 min) - depends on Jobs 1-3
+  Total CI time: ~7 minutes (but doesn't block deployment)
 ```
 
 **Improvement**: 78% faster deployment time!