feat(CHAIN-3336): add Rust bindings and reorganize bindings directory

.github/workflows/test.yml

@@ -59,6 +59,59 @@ jobs:
           just semver-lock-no-build
           git diff --exit-code snapshots/semver-lock.json
 
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Check Rust bindings
+        id: rust-bindings-check
+        continue-on-error: true
+        run: |
+          forge --version
+          just --version
+          rustc --version
+          cargo --version
+          select_regex="^($(git ls-files ':(glob)src/**/*.sol' | sed 's#^.*/##; s#\.sol$##' | sort -u | paste -sd'|' -))$"
+          forge bind \
+            --bindings-path bindings/rust \
+            --crate-name base-contracts-bindings \
+            --select "$select_regex" \
+            --skip-build
+          cd bindings/rust && cargo check
+
+      - name: Debug Rust bindings mismatch
+        if: steps.rust-bindings-check.outcome == 'failure'
+        run: |
+          echo "== Recursive submodule status =="
+          git submodule status --recursive
+
+          echo "== bindings/rust status =="
+          git status --short -- bindings/rust
+
+          echo "== AdminFaucetAuthModule artifact diagnostics =="
+          python3 - <<'PY'
+          import hashlib
+          import json
+          from pathlib import Path
+
+          path = Path("forge-artifacts/AdminFaucetAuthModule.sol/AdminFaucetAuthModule.json")
+          data = json.loads(path.read_text())
+
+          bytecode = data["bytecode"]["object"]
+          deployed = data["deployedBytecode"]["object"]
+          metadata = data.get("metadata", "")
+          metadata_json = json.dumps(metadata, sort_keys=True)
+
+          print(f"artifact_path={path}")
+          print(f"bytecode_len={len(bytecode)}")
+          print(f"deployed_bytecode_len={len(deployed)}")
+          print(f"bytecode_sha256={hashlib.sha256(bytecode.encode()).hexdigest()}")
+          print(f"deployed_bytecode_sha256={hashlib.sha256(deployed.encode()).hexdigest()}")
+          print(f"metadata_sha256={hashlib.sha256(metadata_json.encode()).hexdigest()}")
+          print(f"bytecode_suffix={bytecode[-120:]}")
+          print(f"deployed_bytecode_suffix={deployed[-120:]}")
+          PY
+          exit 1
+
       - name: Run Forge tests
         run: just test
         id: test

.gitignore

@@ -1,6 +1,9 @@
 # Artifacts and Cache
 artifacts
+!bindings/rust/artifacts/
 forge-artifacts
+target
+Cargo.lock
 cache
 broadcast
 kout-proofs

Makefile

@@ -38,12 +38,3 @@ test:
 .PHONY: clean-lib
 clean-lib:
 	rm -rf lib
-
-.PHONY: bindings
-bindings:
-	go install github.com/ethereum/go-ethereum/cmd/abigen@v1.15.8
-	forge build
-	mkdir -p bindings
-	abigen --abi out/BalanceTracker.sol/BalanceTracker.abi.json --pkg bindings --type BalanceTracker --out bindings/balance_tracker.go
-	abigen --abi out/FeeDisburser.sol/FeeDisburser.abi.json --pkg bindings --type FeeDisburser --out bindings/fee_disburser.go
-	cd bindings && go mod tidy

bindings/rust/Cargo.toml

@@ -0,0 +1,8 @@
+[package]
+name = "base-contracts-bindings"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+alloy = { version = "1.0", features = ["sol-types", "contract"] }
+serde = { version = "1.0", features = ["derive"] }