@ethlimo/ens-hooks-release-testing 0.1.11

package/CHANGELOG.md

@@ -0,0 +1,82 @@
+# Changelog
+
+## [0.1.11](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.10...v0.1.11) (2026-02-18)
+
+
+### Bug Fixes
+
+* publish ([#23](https://github.com/ethlimo/ens-hooks-release-testing/issues/23)) ([30c62ee](https://github.com/ethlimo/ens-hooks-release-testing/commit/30c62ee3116b99a58bbe69ab665b32a288aaefde))
+
+## [0.1.10](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.9...v0.1.10) (2026-02-18)
+
+
+### Bug Fixes
+
+* test publish ([#21](https://github.com/ethlimo/ens-hooks-release-testing/issues/21)) ([31fd33c](https://github.com/ethlimo/ens-hooks-release-testing/commit/31fd33ced774bfaa943d1c3e558b0ce531e8b6ad))
+
+## [0.1.9](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.8...v0.1.9) (2026-02-18)
+
+
+### Bug Fixes
+
+* separate actions ([#19](https://github.com/ethlimo/ens-hooks-release-testing/issues/19)) ([42ae684](https://github.com/ethlimo/ens-hooks-release-testing/commit/42ae684e8982b6b3e745805729429536f3d073bb))
+
+## [0.1.8](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.7...v0.1.8) (2026-02-17)
+
+
+### Bug Fixes
+
+* trigger release ([#17](https://github.com/ethlimo/ens-hooks-release-testing/issues/17)) ([802d07c](https://github.com/ethlimo/ens-hooks-release-testing/commit/802d07c14ecf75eb0e814ecb6c4a8b675a71d32f))
+
+## [0.1.7](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.6...v0.1.7) (2026-02-17)
+
+
+### Bug Fixes
+
+* trigger release ([#14](https://github.com/ethlimo/ens-hooks-release-testing/issues/14)) ([c25b5f2](https://github.com/ethlimo/ens-hooks-release-testing/commit/c25b5f278fb6c661f1a7568b285ac26e925899d5))
+
+## [0.1.6](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.5...v0.1.6) (2026-02-17)
+
+
+### Bug Fixes
+
+* test trusted publishing ([#11](https://github.com/ethlimo/ens-hooks-release-testing/issues/11)) ([17ab7e5](https://github.com/ethlimo/ens-hooks-release-testing/commit/17ab7e5785555f9d228fabf1dc872ce77c3708a8))
+
+## [0.1.5](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.4...v0.1.5) (2026-02-17)
+
+
+### Bug Fixes
+
+* disable provenance for testing ([#9](https://github.com/ethlimo/ens-hooks-release-testing/issues/9)) ([ccd2557](https://github.com/ethlimo/ens-hooks-release-testing/commit/ccd2557667a79fa457d9b97932e88db40c5dab85))
+
+## [0.1.4](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.3...v0.1.4) (2026-02-17)
+
+
+### Bug Fixes
+
+* test another release (yet again) ([#7](https://github.com/ethlimo/ens-hooks-release-testing/issues/7)) ([ee58ec5](https://github.com/ethlimo/ens-hooks-release-testing/commit/ee58ec5cd4a15027a89291420223e0c2548b9459))
+
+## [0.1.3](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.2...v0.1.3) (2026-02-17)
+
+
+### Bug Fixes
+
+* adjust package name ([6fa3eed](https://github.com/ethlimo/ens-hooks-release-testing/commit/6fa3eed077da53be6af8fd9b1a03a2d8832ff2aa))
+* adjust package name ([0189730](https://github.com/ethlimo/ens-hooks-release-testing/commit/018973049aa0c93c00247e3c97aa79adec6c7d93))
+* testing release ([8df0ba5](https://github.com/ethlimo/ens-hooks-release-testing/commit/8df0ba528fbe8ed56e3d14649eaf3ff8d1ae9b69))
+
+## [0.1.2](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.1...v0.1.2) (2026-02-17)
+
+
+### Bug Fixes
+
+* adjust description to trigger release ([962d47f](https://github.com/ethlimo/ens-hooks-release-testing/commit/962d47f26532d4873bb554081670ea2201c2c261))
+* adjust description to trigger release ([dd5fa06](https://github.com/ethlimo/ens-hooks-release-testing/commit/dd5fa0600abe82d99bf960263f5c5ee8bf786c9f))
+* modify to trigger release ([6b6f15f](https://github.com/ethlimo/ens-hooks-release-testing/commit/6b6f15f6b62f9d2792ce295d5db60f1acc66f0dc))
+
+## [0.1.1](https://github.com/ethlimo/ens-hooks-release-testing/compare/v0.1.0...v0.1.1) (2026-02-17)
+
+
+### Features
+
+* initial release ([d43c7b1](https://github.com/ethlimo/ens-hooks-release-testing/commit/d43c7b1c10a436a526b73614ba1de434e7ee9641))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Last Mile Labs, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,214 @@
+# ENS Hooks - EIP-8121 Implementation
+
+TypeScript library for encoding, decoding, and executing [EIP-8121](./notes/EIP-8121.md) hooks with ERC-7930 interoperable addresses. Enables cross-chain function calls for ENS contenthash resolution with optional trust verification.
+
+## Overview
+
+This library implements [EIP-8121](./notes/EIP-8121.md) hooks, a specification for cross-chain function calls. A hook fully specifies what function to call, with what parameters, on which contract, on which chain using [ERC-7930](https://eips.ethereum.org/EIPS/eip-7930) interoperable addresses.
+
+**Key Features:**
+- EIP-8121 hook encoding (selector `0x6113bfa3`)
+- ERC-7930 interoperable addresses
+- Multi-chain execution (EIP-155)
+- 0-2 fixed-size primitive parameters
+- Optional trust verification
+- Contenthash encoding/decoding
+
+## Scope
+
+This is a **focused implementation** for contenthash resolution. See [LIMITATIONS.md](./notes/LIMITATIONS.md) for scope restrictions:
+- 0-2 parameters of fixed-size primitives and strings (bool, address, uintN, intN, bytesN, string)
+- String parameters limited to 512 characters
+- EIP-155 chains only (EVM)
+- Bytes return type only
+- No recursive resolution
+- No struct or dynamic type support (dynamic bytes, arrays)
+- Requires ERC-3668 (CCIP-Read) enabled provider
+
+## Installation
+
+```bash
+npm install @ethlimo/ens-hooks
+```
+
+## Usage
+
+### Encoding a Hook
+
+```typescript
+import { encodeHook, EIP8121Target } from '@ethlimo/ens-hooks';
+
+const target: EIP8121Target = {
+    chainId: 1,  // Ethereum mainnet
+    address: "0x1234567890123456789012345678901234567890"
+};
+
+const hookData = await encodeHook(
+    "data(bytes32)",                    // function signature
+    "data(0x1234...)",                  // function call with values
+    "(bytes)",                          // return type
+    target
+);
+```
+
+### Decoding and Executing a Hook
+
+```typescript
+import { decodeHook, executeHook, ProviderMap } from '@ethlimo/ens-hooks';
+import { ethers, namehash } from 'ethers';
+
+// Decode the hook
+const hook = await decodeHook(hookData);
+
+// Set up provider map for cross-chain calls
+const providerMap: ProviderMap = new Map([
+    [1, new ethers.JsonRpcProvider("https://eth-mainnet.g.alchemy.com/v2/...")]
+]);
+
+// Execute the hook
+const result = await executeHook(hook!, {
+    params: [namehash("example.eth")],
+    providerMap
+});
+
+if (result._tag === "HookExecutionResult") {
+    console.log("Result:", result.data);
+} else {
+    console.error("Error:", result.message);
+}
+```
+
+### Parameter Support
+
+Hooks support functions with 0-2 parameters of fixed-size Solidity primitives:
+- **0 parameters**: `getData()` - Global data
+- **1 parameter**: `data(bytes32)` - Node-specific data
+- **2 parameters**: `data(bytes32,bytes32)` - Node with additional context
+
+**Recommended Parameter Patterns:**
+- `()` - Zero parameters for global data
+- `(nodehash: bytes32)` - Single nodehash parameter for node-specific data
+- `(nodehash: bytes32, hashOfContent: bytes32)` - Two parameters for cache-busting
+  - `hashOfContent` should be either:
+    - A hash of the expected content (for integrity verification)
+    - An autoincrement value (for cache invalidation in web gateways)
+
+**Supported Types:** `bool`, `address`, `uint8-256`, `int8-256`, `bytes1-32`, `string` (max 512 chars)
+
+```typescript
+import { executeHook } from '@ethlimo/ens-hooks';
+import { namehash } from 'ethers';
+
+// 0-parameter hook
+const globalHook = await encodeHook(
+    "getData()",
+    "getData()",
+    "(bytes)",
+    { chainId: 1, address: "0x..." }
+);
+
+const globalResult = await executeHook(await decodeHook(globalHook)!, {
+    providerMap  // No params
+});
+
+// 1-parameter hook (node-specific data)
+const node = namehash("example.eth");
+const nodeHook = await encodeHook(
+    "data(bytes32)",
+    `data(${node})`,
+    "(bytes)",
+    { chainId: 1, address: "0x..." }
+);
+
+const nodeResult = await executeHook(await decodeHook(nodeHook)!, {
+    params: [node],  // Single parameter array
+    providerMap
+});
+
+// 2-parameter hook (with cache-busting)
+const hashOfContent = "0xabcd..."; // Hash or autoincrement
+const twoParamHook = await encodeHook(
+    "data(bytes32,bytes32)",
+    `data(${node},${hashOfContent})`,
+    "(bytes)",
+    { chainId: 1, address: "0x..." }
+);
+
+const twoParamResult = await executeHook(await decodeHook(twoParamHook)!, {
+    params: [node, hashOfContent],  // Two parameter array
+    providerMap
+});
+```
+
+### Trust Verification
+
+Optionally verify hook targets against a trusted list:
+
+```typescript
+import { executeHook, createTrustedTargets } from '@ethlimo/ens-hooks';
+
+// Create trusted targets set
+const trustedTargets = createTrustedTargets([
+    { 
+        chainId: 1, 
+        address: "0x1234567890123456789012345678901234567890",
+        description: "ENS Public Resolver"
+    }
+]);
+
+// Execute with trust verification
+const result = await executeHook(hook!, {
+    params: [namehash("example.eth")],
+    providerMap,
+    trustedTargets
+});
+```
+
+Three verification modes supported:
+1. **Array**: `TrustedTarget[]` - Verified via array iteration
+2. **Set**: `Set<string>` - Fast lookup with "chainId:address" keys
+3. **Function**: `(target: EIP8121Target) => boolean` - Custom logic
+
+## API Reference
+
+### Hook Encoding/Decoding
+- `encodeHook()` - Encode EIP-8121 hook (bytes format, 5 parameters)
+- `decodeHook()` - Decode EIP-8121 hook (bytes format)
+- `computeSelector()` - Compute 4-byte function selector from signature
+- `parseParameterTypes()` - Parse and validate parameter types (0-2 fixed-size primitives)
+- `validateFunctionCallMatchesSignature()` - Strict validation of call vs signature
+
+### Hook Execution
+- `executeHook(hook, options)` - Execute hook on target chain with type-safe options:
+  - For 0-parameter hooks: `{ providerMap, trustedTargets?, throwOnUntrusted? }`
+  - For 1-parameter hooks: `{ params: [string], providerMap, trustedTargets?, throwOnUntrusted? }`
+  - For 2-parameter hooks: `{ params: [string, string], providerMap, trustedTargets?, throwOnUntrusted? }`
+- `validateHook()` - Validate parameter count (0-2) and types (fixed-size primitives)
+- `detectAndDecodeHook()` - Detect and decode hooks from bytes format
+
+### Contenthash Support
+- `encodeEIP8121HookForContenthash()` - Wrap hook for contenthash storage
+- `tryDecodeEIP8121HookFromContenthash()` - Extract hook from contenthash
+- `encodeDataUri()` - Encode plain URI for contenthash
+- `tryDecodeDataUri()` - Decode plain URI from contenthash
+
+### Trust Verification
+- `verifyTrustedTarget()` - Check if target is trusted
+- `createTrustedTargets()` - Create fast-lookup Set from array
+- `createTargetKey()` - Generate "chainId:address" key
+
+## Testing
+
+```bash
+npm test
+```
+
+69 tests covering encoding, decoding, execution, and trust verification.
+
+## Specification
+
+See [notes/EIP-8121.md](./notes/EIP-8121.md) for the full EIP-8121 specification and [notes/LIMITATIONS.md](./notes/LIMITATIONS.md) for implementation scope.
+
+## License
+
+MIT

package/contracts/AllParameterPermutationsHookTarget.sol

@@ -0,0 +1,155 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.28;
+
+import '@openzeppelin/contracts/access/Ownable.sol';
+
+/**
+ * Test contract with all permutations of 0-2 fixed-size primitive parameters.
+ * For local node testing only - not deployed to testnets.
+ */
+contract AllParameterPermutationsHookTarget is Ownable {
+    // Storage for each permutation
+    bytes private data0;
+    mapping(bytes32 => bytes) private data1Bytes32;
+    mapping(address => bytes) private data1Address;
+    mapping(uint256 => bytes) private data1Uint256;
+    mapping(bool => bytes) private data1Bool;
+    mapping(bytes32 => mapping(bytes32 => bytes)) private data2Bytes32Bytes32;
+    mapping(bytes32 => mapping(uint256 => bytes)) private data2Bytes32Uint256;
+    mapping(bytes32 => mapping(address => bytes)) private data2Bytes32Address;
+    mapping(address => mapping(uint256 => bytes)) private data2AddressUint256;
+    mapping(uint256 => mapping(uint256 => bytes)) private data2Uint256Uint256;
+    mapping(bool => mapping(bytes32 => bytes)) private data2BoolBytes32;
+
+    // ========================================================================
+    // 0 Parameters
+    // ========================================================================
+    
+    function get0() external view returns (bytes memory) {
+        return data0;
+    }
+    
+    function set0(bytes calldata value) external onlyOwner {
+        data0 = value;
+    }
+
+    // ========================================================================
+    // 1 Parameter - bytes32
+    // ========================================================================
+    
+    function get1Bytes32(bytes32 key) external view returns (bytes memory) {
+        return data1Bytes32[key];
+    }
+    
+    function set1Bytes32(bytes32 key, bytes calldata value) external onlyOwner {
+        data1Bytes32[key] = value;
+    }
+
+    // ========================================================================
+    // 1 Parameter - address
+    // ========================================================================
+    
+    function get1Address(address key) external view returns (bytes memory) {
+        return data1Address[key];
+    }
+    
+    function set1Address(address key, bytes calldata value) external onlyOwner {
+        data1Address[key] = value;
+    }
+
+    // ========================================================================
+    // 1 Parameter - uint256
+    // ========================================================================
+    
+    function get1Uint256(uint256 key) external view returns (bytes memory) {
+        return data1Uint256[key];
+    }
+    
+    function set1Uint256(uint256 key, bytes calldata value) external onlyOwner {
+        data1Uint256[key] = value;
+    }
+
+    // ========================================================================
+    // 1 Parameter - bool
+    // ========================================================================
+    
+    function get1Bool(bool key) external view returns (bytes memory) {
+        return data1Bool[key];
+    }
+    
+    function set1Bool(bool key, bytes calldata value) external onlyOwner {
+        data1Bool[key] = value;
+    }
+
+    // ========================================================================
+    // 2 Parameters - bytes32, bytes32
+    // ========================================================================
+    
+    function get2Bytes32Bytes32(bytes32 key1, bytes32 key2) external view returns (bytes memory) {
+        return data2Bytes32Bytes32[key1][key2];
+    }
+    
+    function set2Bytes32Bytes32(bytes32 key1, bytes32 key2, bytes calldata value) external onlyOwner {
+        data2Bytes32Bytes32[key1][key2] = value;
+    }
+
+    // ========================================================================
+    // 2 Parameters - bytes32, uint256
+    // ========================================================================
+    
+    function get2Bytes32Uint256(bytes32 key1, uint256 key2) external view returns (bytes memory) {
+        return data2Bytes32Uint256[key1][key2];
+    }
+    
+    function set2Bytes32Uint256(bytes32 key1, uint256 key2, bytes calldata value) external onlyOwner {
+        data2Bytes32Uint256[key1][key2] = value;
+    }
+
+    // ========================================================================
+    // 2 Parameters - bytes32, address
+    // ========================================================================
+    
+    function get2Bytes32Address(bytes32 key1, address key2) external view returns (bytes memory) {
+        return data2Bytes32Address[key1][key2];
+    }
+    
+    function set2Bytes32Address(bytes32 key1, address key2, bytes calldata value) external onlyOwner {
+        data2Bytes32Address[key1][key2] = value;
+    }
+
+    // ========================================================================
+    // 2 Parameters - address, uint256
+    // ========================================================================
+    
+    function get2AddressUint256(address key1, uint256 key2) external view returns (bytes memory) {
+        return data2AddressUint256[key1][key2];
+    }
+    
+    function set2AddressUint256(address key1, uint256 key2, bytes calldata value) external onlyOwner {
+        data2AddressUint256[key1][key2] = value;
+    }
+
+    // ========================================================================
+    // 2 Parameters - uint256, uint256
+    // ========================================================================
+    
+    function get2Uint256Uint256(uint256 key1, uint256 key2) external view returns (bytes memory) {
+        return data2Uint256Uint256[key1][key2];
+    }
+    
+    function set2Uint256Uint256(uint256 key1, uint256 key2, bytes calldata value) external onlyOwner {
+        data2Uint256Uint256[key1][key2] = value;
+    }
+
+    // ========================================================================
+    // 2 Parameters - bool, bytes32
+    // ========================================================================
+    
+    function get2BoolBytes32(bool key1, bytes32 key2) external view returns (bytes memory) {
+        return data2BoolBytes32[key1][key2];
+    }
+    
+    function set2BoolBytes32(bool key1, bytes32 key2, bytes calldata value) external onlyOwner {
+        data2BoolBytes32[key1][key2] = value;
+    }
+}

package/contracts/DataResolver.sol

@@ -0,0 +1,17 @@
+pragma solidity ^0.8.28;
+import '@openzeppelin/contracts/access/Ownable.sol';
+import '@ensdomains/ens-contracts/contracts/resolvers/profiles/ExtendedResolver.sol';
+import './IDataResolver.sol';
+
+contract DataResolver is Ownable, ExtendedResolver, IDataResolver {    
+    mapping(bytes32 node => bytes data) private dataStore;
+    
+    function data(bytes32 node) external view returns (bytes memory) {
+        return dataStore[node];
+    }
+
+    function setData(bytes32 node, bytes calldata value) external onlyOwner {
+        dataStore[node] = value;
+        emit DataChanged(node, keccak256(value));
+    }
+}