New ensjs

.github/workflows/continuous-releases.yml

@@ -0,0 +1,25 @@
+name: Continuous Release
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - run: corepack enable
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: "pnpm"
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build
+        run: pnpm -r --filter @ensdomains/ensjs-abi --filter @ensdomains/ensjs build
+
+      - name: Publish to pkg.pr.new
+        run: pnpm dlx pkg-pr-new publish "./packages/ensjs-abi" "./packages/ensjs"

.github/workflows/test.yml

@@ -22,11 +22,20 @@ jobs:
 
       - run: pnpm install --frozen-lockfile
 
-      - name: Build ensjs
-        run: pnpm -F @ensdomains/ensjs build
+      - name: Build ensjs-abi and ensjs
+        run: pnpm -F @ensdomains/ensjs-abi -F @ensdomains/ensjs build
+
+      - name: Start test environment
+        run: docker compose up -d devnet
+        working-directory: packages/ensjs
 
       - name: Run tests
-        run: pnpm -F @ensdomains/ensjs tenv start --extra-time 11368000
+        run: pnpm -F @ensdomains/ensjs test --run
+
+      - name: Upload coverage reports to Codecov
+        uses: codecov/codecov-action@v5
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
   lint:
     name: Lint
     runs-on: ubuntu-latest
@@ -43,8 +52,11 @@ jobs:
 
       - run: pnpm install --frozen-lockfile
 
+      - name: Build ensjs-abi
+        run: pnpm -F @ensdomains/ensjs-abi build
+
       - name: Lint
         run: pnpm lint
 
       - name: Type check
-        run: pnpm -F @ensdomains/ensjs build
+        run: pnpm -F @ensdomains/ensjs check:types

.npmrc

@@ -1,4 +1,4 @@
 strict-peer-dependencies=false
 link-workspace-packages=deep
 provenance=true
-auto-install-peers=false
+auto-install-peers=false

CLAUDE.md

@@ -0,0 +1,121 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+ENSjs is a TypeScript library for interacting with the Ethereum Name Service (ENS). It's built on top of Viem and provides comprehensive ENS contract interaction with tree-shaking support.
+
+## Build & Development Commands
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build all packages
+pnpm -r build
+
+# Build specific package
+pnpm -F @ensdomains/ensjs build
+
+# Lint all packages
+pnpm lint
+
+# Run tests (ensjs package)
+pnpm -F @ensdomains/ensjs test
+
+# Watch mode testing
+pnpm -F @ensdomains/ensjs test:watch
+
+# Run a single test file
+pnpm -F @ensdomains/ensjs test src/actions/public/getRecords.test.ts
+
+# Start test environment (with ENS contracts)
+pnpm -F @ensdomains/ensjs denv
+
+# Start local anvil only (no ENSnode, no scripts)
+pnpm -F @ensdomains/ensjs anvil
+
+# Generate documentation
+pnpm -F @ensdomains/ensjs generateDocs
+
+# Versioning with changesets
+pnpm chgset:run    # Create changeset
+pnpm chgset:version  # Update versions
+```
+
+## Monorepo Structure
+
+```
+packages/
+├── ensjs/       # Main ENS library (@ensdomains/ensjs)
+├── react/       # React hooks (@ensdomains/ensjs-react)
+└── query-core/  # @wagmi/core integration (@ensdomains/ensjs-query-core)
+```
+
+## Architecture
+
+### Package: @ensdomains/ensjs
+
+**Actions** (`src/actions/`): Composable functions that extend viem clients
+- `public/v1/` - ENS v1 read operations (getExpiry, getOwner, getWrapperData)
+- `public/v2/` - ENS v2 read operations (getExpiry, getNameRegistries, getNameRolesForAccount)
+- `wallet/v2/` - ENS v2 write operations (deploySubregistry, grantRoles, setSubregistry)
+- `dns/` - DNS-related functions
+- `subgraph/` - Subgraph query functions
+
+**Clients** (`src/clients/`): Factory functions for L1/L2 chain support
+- `l1.ts` - Mainnet client
+- `l2.ts` - L2 chain clients
+- Supported chains: mainnet (1), sepolia (11155111)
+
+**Contracts** (`src/contracts/`): ABIs and chain-specific addresses for 20+ ENS contracts
+
+**Utils** (`src/utils/`):
+- `coders/` - ABI encoding/decoding (getAbi, getAddress, getContentHash, getText)
+- `name/` - Name normalization and validation
+- `v2/registry/` - V2 registry utilities (labelToCanonicalId)
+- `v2/roles/` - Role encoding/decoding
+
+**Exports** (`src/exports/`): Public API surface
+- `public.ts` - Public client actions
+- `wallet.ts` - Wallet client actions
+- `chain.ts` - Chain configurations
+
+### Action Pattern
+
+Actions follow this structure:
+```typescript
+export const actionName = async (
+  client: SupportedClient,
+  params: ActionParams
+): Promise<ActionReturn> => {
+  // Uses viem's getAction() and multicall for batching
+}
+```
+
+### Client Types
+
+- **Public Client**: Read-only operations
+- **Wallet Client**: Write operations (registration, renewals, records)
+
+## Testing
+
+- Framework: Vitest
+- Tests collocated with source: `*.test.ts`
+- Test setup: `packages/ensjs/src/test/setup.ts`
+- Uses `ens-test-env` for integration tests with deployed contracts
+
+## Code Quality
+
+- Formatter/Linter: Biome
+- TypeScript: Strict mode enabled
+- Node version: >=22 (main packages), >=18 (query-core)
+
+## Key Dependencies
+
+- `viem` (peer dependency ^2.30.6) - Ethereum interactions
+- `@adraffy/ens-normalize` - Name normalization
+- `@ensdomains/address-encoder` - Address encoding
+- `@ensdomains/content-hash` - Content hash encoding
+- `graphql-request` - Subgraph queries

biome.json

@@ -1,58 +1,56 @@
 {
-	"$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-	"files": {
-		"ignore": [
-			"node_modules",
-			"package.json",
-			"dist",
-			"coverage",
-			"data",
-			"cache",
-			"tsconfig.*.json",
-			"packages/ensjs/contracts"
-		]
-	},
-	"organizeImports": {
-		"enabled": true
-	},
-	"linter": {
-		"enabled": true,
-		"rules": {
-			"recommended": true,
-			"complexity": {
-				"noForEach": "off",
-				"noBannedTypes": "warn"
-			},
-			"style": {
-				"noNonNullAssertion": "off"
-			},
-			"correctness": {
-				"noUnusedImports": "error",
-				"noUnusedVariables": "error",
-				"noUnusedPrivateClassMembers": "error"
-			},
-			"performance": {
-				"noAccumulatingSpread": "off"
-			},
-			"suspicious": {
-				"noAssignInExpressions": "off",
-				"noExplicitAny": "warn"
-			}
-		}
-	},
-	"formatter": {
-		"enabled": true
-	},
-	"javascript": {
-		"formatter": {
-			"enabled": true,
-			"semicolons": "asNeeded",
-			"quoteStyle": "single",
-			"indentWidth": 2,
-			"indentStyle": "space"
-		},
-		"linter": {
-			"enabled": true
-		}
-	}
+  "$schema": "https://biomejs.dev/schemas/2.0.6/schema.json",
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "files": {
+    "ignoreUnknown": false,
+    "includes": [
+      "packages/**/*.{cts,ts,mts}",
+      "packages/*/*.js",
+      "examples/**/*.{ts}",
+      "!**/*.gen.ts",
+      "!**/node_modules/**",
+      "!**/dist/**"
+    ]
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "recommended": true,
+      "style": {
+        "noParameterAssign": "error",
+        "useAsConstAssertion": "error",
+        "useDefaultParameterLast": "error",
+        "useEnumInitializers": "error",
+        "useSelfClosingElements": "error",
+        "useSingleVarDeclarator": "error",
+        "noUnusedTemplateLiteral": "error",
+        "useNumberNamespace": "error",
+        "noInferrableTypes": "error",
+        "noUselessElse": "error"
+      }
+    }
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "single",
+      "semicolons": "asNeeded"
+    }
+  },
+  "assist": {
+    "enabled": true,
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
+    }
+  }
 }

examples/basic-tsnode-esm/package.json → examples/basic/package.json

@@ -4,12 +4,15 @@
   "type": "module",
   "version": "0.0.1",
   "scripts": {
-    "start": "ts-node-esm src/index.ts"
+    "start": "tsx src/index.ts"
   },
   "dependencies": {
     "@ensdomains/ensjs": "workspace:*",
     "ts-node": "^10.9.2",
     "typescript": "^5.6.2",
     "viem": "^2.30.6"
+  },
+  "devDependencies": {
+    "tsx": "^4.20.3"
   }
-}
+}