fix(ci): add OZ v5 ERC777 compatibility shims for Superfluid

OZ v5 moved ERC777 interfaces from token/ERC777/ to interfaces/.
Superfluid protocol-monorepo still imports from the old v4 path.
Add oz-compat.sh script that copies the interface files to the
expected location, run in CI workflows and postinstall hook.

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

Author: Oba-One

.github/workflows/contract-tests.yml

@@ -32,7 +32,10 @@ jobs:
         version: nightly
 
     # Skip all bun/Node.js dependencies - contracts tests don't need them
-    
+
+    - name: Create OZ v5 compatibility shims
+      run: ./scripts/oz-compat.sh
+
     - name: Build contracts
       run: |
         echo "🔧 Building contracts..."

.github/workflows/integration-tests.yml

@@ -71,6 +71,9 @@ jobs:
           fi
         done
 
+    - name: Create OZ v5 compatibility shims
+      run: ./scripts/oz-compat.sh
+
     - name: Deploy contracts (using dev-start.sh deployment logic)
       run: |
         echo "🚀 Deploying contracts for integration testing..."

package.json

@@ -7,7 +7,7 @@
 	"license": "MIT",
 	"scripts": {
 		"preinstall": "./scripts/install-deps.sh",
-		"postinstall": "rm -f package-lock.json && (command -v forge > /dev/null && git submodule update --init --recursive && cd contracts && forge install || echo 'Forge not found, skipping forge operations')",
+		"postinstall": "rm -f package-lock.json && (command -v forge > /dev/null && git submodule update --init --recursive && ./scripts/oz-compat.sh && cd contracts && forge install || echo 'Forge not found, skipping forge operations')",
 		"dev": "bun run dev:stop && ./scripts/dev-start.sh",
 		"dev:client": "cd client && bun dev",
 		"dev:stop": "pkill -f anvil || true && pkill -f 'forge script.*watch' || true && pkill -f 'next dev' || true && pkill -f 'npm run dev' || true",

scripts/oz-compat.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# OZ v5 compatibility: ERC777 interfaces moved from token/ERC777/ to interfaces/
+# Superfluid protocol-monorepo still imports from the old v4 path.
+# This script creates the missing files so builds work on fresh clones.
+
+set -euo pipefail
+
+OZ_DIR="lib/openzeppelin-contracts/contracts"
+
+# Only run if OZ submodule exists but ERC777 dir is missing
+if [ -d "$OZ_DIR/interfaces" ] && [ ! -f "$OZ_DIR/token/ERC777/IERC777.sol" ]; then
+  mkdir -p "$OZ_DIR/token/ERC777"
+  for f in IERC777.sol IERC777Recipient.sol IERC777Sender.sol; do
+    if [ -f "$OZ_DIR/interfaces/$f" ]; then
+      cp "$OZ_DIR/interfaces/$f" "$OZ_DIR/token/ERC777/$f"
+    fi
+  done
+  echo "Created OZ v5 ERC777 compatibility shims"
+fi