Port latest ENSv2 deployment to .dos

.github/codecov.yml

@@ -12,8 +12,10 @@ flag_management:
       - type: project
         target: auto
         threshold: 1%
+        informational: true
       - type: patch
         target: 90%
+        informational: true
 
 comment:
   layout: "header, diff, flags, components, files"

.github/workflows/main.yml

@@ -1,10 +1,11 @@
 name: CI
 
-on:
+"on":
   push:
     branches: [main]
     tags: ["v*"]
   pull_request:
+  workflow_dispatch:
 
 jobs:
   check-types:
@@ -53,11 +54,17 @@ jobs:
           bun run coverage:reports
 
       - name: Upload coverage
-        run: cd contracts && bun run coverage:upload
+        run: |
+          if [ -z "$CC_TOKEN" ]; then
+            echo "CODECOV_TOKEN is not configured; skipping coverage upload."
+            exit 0
+          fi
+          cd contracts && bun run coverage:upload
         env:
           CC_TOKEN: ${{ secrets.CODECOV_TOKEN }}
           CC_GIT_SERVICE: github
-          CC_SHA: ${{ github.sha }}
+          CC_SHA: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+          CC_PR: ${{ github.event_name == 'pull_request' && github.event.pull_request.number || '' }}
 
   hardhat-tests:
     name: Hardhat Tests
@@ -80,14 +87,20 @@ jobs:
           bun run coverage:reports
 
       - name: Upload coverage
-        run: cd contracts && bun run coverage:upload
+        run: |
+          if [ -z "$CC_TOKEN" ]; then
+            echo "CODECOV_TOKEN is not configured; skipping coverage upload."
+            exit 0
+          fi
+          cd contracts && bun run coverage:upload
         env:
           CC_TOKEN: ${{ secrets.CODECOV_TOKEN }}
           CC_GIT_SERVICE: github
-          CC_SHA: ${{ github.sha }}
+          CC_SHA: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+          CC_PR: ${{ github.event_name == 'pull_request' && github.event.pull_request.number || '' }}
 
   lint:
-    name: Lint
+    name: Lint and Format
     runs-on: ubuntu-latest
     steps:
       # setup
@@ -97,10 +110,13 @@ jobs:
       - name: Lint
         run: bun --filter contracts lint
 
+      - name: Format
+        run: bun --filter contracts format:check
+
   publish-docker:
     name: Publish Docker Image
-    if: github.ref == 'refs/heads/main'
-    needs: [check-types, forge-tests, hardhat-tests, lint]
+    if: github.ref == 'refs/heads/main' || (github.event_name == 'workflow_dispatch' && github.ref_type == 'branch')
+    needs: [check-types, e2e-tests, forge-tests, hardhat-tests, lint]
     runs-on: ubuntu-latest
     permissions:
       contents: read
@@ -126,24 +142,43 @@ jobs:
 
       - name: Get branch name and short SHA for tagging
         id: branch
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          HEAD_REF: ${{ github.head_ref }}
+          REF_NAME: ${{ github.ref_name }}
+          GITHUB_SHA_VALUE: ${{ github.sha }}
+          PR_HEAD_SHA: ${{ github.event.pull_request.head.sha }}
         run: |
-          if [ "${{ github.event_name }}" = "pull_request" ]; then
-            echo "name=${{ github.head_ref }}" >> $GITHUB_OUTPUT
-            SHORT_SHA=$(echo "${{ github.event.pull_request.head.sha }}" | cut -c1-7)
+          if [ "$EVENT_NAME" = "pull_request" ]; then
+            BRANCH_NAME="$HEAD_REF"
+            SOURCE_SHA="$PR_HEAD_SHA"
           else
-            echo "name=${{ github.ref_name }}" >> $GITHUB_OUTPUT
-            SHORT_SHA=$(echo "${{ github.sha }}" | cut -c1-7)
+            BRANCH_NAME="$REF_NAME"
+            SOURCE_SHA="$GITHUB_SHA_VALUE"
           fi
-          echo "short_sha=$SHORT_SHA" >> $GITHUB_OUTPUT
+
+          SHORT_SHA=$(printf '%s' "$SOURCE_SHA" | cut -c1-7)
+          DOCKER_TAG=$(printf '%s' "$BRANCH_NAME" | sed -E 's/[^A-Za-z0-9_.-]+/-/g; s/^[.-]+//; s/[.-]+$//')
+
+          if [ -z "$DOCKER_TAG" ]; then
+            DOCKER_TAG="branch"
+          fi
+
+          DOCKER_TAG=$(printf '%s' "$DOCKER_TAG" | cut -c1-128)
+          DOCKER_TAG_PREFIX=$(printf '%s' "$DOCKER_TAG" | cut -c1-120)
+
+          echo "tag=$DOCKER_TAG" >> "$GITHUB_OUTPUT"
+          echo "sha_tag=$DOCKER_TAG_PREFIX-$SHORT_SHA" >> "$GITHUB_OUTPUT"
 
       - name: Extract metadata for Docker
         id: meta
         uses: docker/metadata-action@v5
         with:
           images: ghcr.io/${{ github.repository }}
           tags: |
-            type=raw,value=${{ steps.branch.outputs.name }}-${{ steps.branch.outputs.short_sha }}
-            type=raw,value=latest,enable=${{ github.ref_name == github.event.repository.default_branch }}
+            type=raw,value=${{ steps.branch.outputs.sha_tag }}
+            type=raw,value=${{ steps.branch.outputs.tag }},enable=${{ github.event_name == 'workflow_dispatch' && github.ref_type == 'branch' && github.ref != 'refs/heads/main' }}
+            type=raw,value=latest,enable=${{ github.ref == 'refs/heads/main' }}
             type=ref,event=tag
 
       - name: Build and push Docker image

.gitignore

@@ -2,14 +2,10 @@
 .env
 
 node_modules/
+.solgrid_cache/
 
 .DS_Store
 
 .claude/settings.local.json
 
 .devdocs/
-
-# for now
-deployments/
-!deployments/testnet-*.json
-!deployments/mainnet-*.json

.gitmodules

@@ -25,3 +25,6 @@
 [submodule "contracts/lib/unruggable-gateways"]
 	path = contracts/lib/unruggable-gateways
 	url = https://github.com/unruggable-labs/unruggable-gateways
+[submodule "contracts/lib/solady"]
+	path = contracts/lib/solady
+	url = https://github.com/vectorized/solady

.vscode/settings.json

@@ -2,14 +2,34 @@
   "solidity.packageDefaultDependenciesContractsDirectory": "./contracts/src",
   "solidity.packageDefaultDependenciesDirectory": "./contracts/lib",
   "solidity.compileUsingRemoteVersion": "v0.8.25+commit.b61c2a91",
-  "solidity.solhintPackageDirectory": "./node_modules/solhint",
-  "solidity.formatter": "prettier",
+  "[javascript]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[javascriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[json]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[jsonc]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
   "[solidity]": {
-    "editor.defaultFormatter": "JuanBlanco.solidity",
+    "editor.formatOnSave": false
+  },
+  "[typescript]": {
+    "editor.defaultFormatter": "biomejs.biome",
+    "editor.formatOnSave": true
+  },
+  "[typescriptreact]": {
+    "editor.defaultFormatter": "biomejs.biome",
     "editor.formatOnSave": true
   },
   "editor.formatOnSave": true,
-  "prettier.configPath": "./.prettierrc.json",
   "search.exclude": {
     "**/node_modules": true,
     "**/cache": true,

CLAUDE.md → AGENTS.md

@@ -2,7 +2,7 @@
 
 - When running tests they should be run from the contracts/ subfolder.
 - See package.json for the test commands.
-- When testing for event emission never use vm.expectEmit, always use vm.recordLogs and actually check the logs properly.
+- When testing for event emission, always check logs properly. Use either `vm.recordLogs` with explicit log assertions, or `vm.expectEmit` paired with an `emit Event(...)` expectation before the call under test.
 - Do not use --via-ir when compiling contracts and tests. If there are Solidity stack too deep errors then fix them through code refactoring.
 - When doing vm.prank and vm.expectRevert together for a call, always place the vm.expectRevert call before the vm.prank call.
 
@@ -37,4 +37,8 @@ Do what has been asked; nothing more, nothing less.
 NEVER create files unless they're absolutely necessary for achieving your goal.
 ALWAYS prefer editing an existing file to creating a new one.
 NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.
-- when writing tests that involve constants already defined in the source (e.g contracts/src/registry/libraries/RegistryRolesLib.sol) use those defined constants directly instead of hardcoding their values in the tests.
+- when writing tests that involve constants already defined in the source (e.g contracts/src/registry/libraries/RegistryRolesLib.sol) use those defined constants directly instead of hardcoding their values in the tests.
+
+# Documentation
+
+The `contracts/docs/` folder contains operational documentation for scripts and tools. When making changes to code that is covered by documentation in `contracts/docs/`, the corresponding documentation MUST be kept up-to-date alongside the code changes.

Dockerfile

@@ -28,8 +28,6 @@ COPY package.json bun.lock ./
 # Copy the package.json for each workspace.
 COPY contracts/package.json ./contracts/
 
-COPY solhint-plugins/package.json ./solhint-plugins/
-
 # Copy patches for post script execution
 #COPY /patches ./patches
 

biome.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://biomejs.dev/schemas/2.4.11/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": true
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineEnding": "lf",
+    "lineWidth": 80
+  },
+  "linter": {
+    "enabled": false
+  },
+  "assist": {
+    "enabled": false
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "trailingCommas": "all"
+    }
+  }
+}