@ensforge/core 0.0.0

package/dist/actions/resolution/create-resolver/index.js

@@ -0,0 +1,77 @@
+import { defineAction, defineExtendedAction } from "../../../action/action.js";
+import { ContractError } from "../../../errors/contract-error.js";
+import { WritePlanError } from "../../../errors/write-plan-error.js";
+import { executeSequential } from "../../../internal/write/execute-sequential.js";
+import { simulateCalls } from "../../batch/simulate-calls.js";
+import { EthereumAddress } from "../../../schemas/identity.js";
+import { createResolverIntent, prepareCreateResolver } from "./prepare.js";
+import { Effect, Schema } from "effect";
+import { decodeFunctionResult } from "viem";
+import { verifiableFactoryV2DeployProxyAbi } from "@ensforge/contracts/v2";
+
+//#region src/actions/resolution/create-resolver/index.ts
+const predictResolverAddressEffect = Effect.fn("ensforge.predictResolverAddress")(function* (config, parameters) {
+	const simulation = yield* simulateCalls.effect(config, {
+		calls: [createResolverIntent(parameters)],
+		...parameters.walletClient === void 0 ? {} : { walletClient: parameters.walletClient },
+		...parameters.account === void 0 ? {} : { account: parameters.account }
+	});
+	const raw = simulation[0]?.result;
+	if (raw === void 0) return yield* new ContractError({
+		code: "DECODE_FAILED",
+		message: "Resolver deployment simulation returned no address",
+		cause: simulation
+	});
+	return yield* Effect.try({
+		try: () => Schema.decodeUnknownSync(EthereumAddress)(decodeFunctionResult({
+			abi: verifiableFactoryV2DeployProxyAbi,
+			functionName: "deployProxy",
+			data: raw
+		})),
+		catch: (cause) => new ContractError({
+			code: "DECODE_FAILED",
+			message: "Unable to decode the predicted Permissioned Resolver address",
+			cause
+		})
+	});
+});
+const predictResolverAddress = defineAction(predictResolverAddressEffect);
+const implementation = Effect.fn("ensforge.createResolver")(function* (config, parameters) {
+	const resolver = yield* predictResolverAddressEffect(config, parameters);
+	const result = yield* executeSequential(config, {
+		calls: [createResolverIntent(parameters)],
+		...parameters.walletClient === void 0 ? {} : { walletClient: parameters.walletClient },
+		...parameters.account === void 0 ? {} : { account: parameters.account },
+		...parameters.confirmation === void 0 ? {} : { confirmation: parameters.confirmation }
+	});
+	const call = result.calls[0];
+	if (call === void 0) return yield* new WritePlanError({
+		code: "INVALID_CALL_PLAN",
+		message: "createResolver did not produce an execution result",
+		cause: result
+	});
+	const deployment = config.deployments;
+	if (deployment.protocol !== "v2") return yield* new WritePlanError({
+		code: "INVALID_CALL_PLAN",
+		message: "Permissioned Resolver creation requires an ENSv2 deployment",
+		cause: deployment
+	});
+	return {
+		status: "deployed",
+		resolver,
+		implementation: deployment.v2.implementations.permissionedResolver,
+		factory: deployment.v2.contracts.verifiableFactory,
+		call
+	};
+});
+const action = defineExtendedAction(implementation);
+const createResolver = Object.freeze(Object.defineProperty(action, "call", {
+	value: createResolverIntent,
+	enumerable: true,
+	configurable: false,
+	writable: false
+}));
+
+//#endregion
+export { createResolver, predictResolverAddress, predictResolverAddressEffect };
+//# sourceMappingURL=index.js.map

package/dist/actions/resolution/create-resolver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/actions/resolution/create-resolver/index.ts"],"sourcesContent":["import { Effect, Schema } from \"effect\";\n\nimport { verifiableFactoryV2DeployProxyAbi } from \"@ensforge/contracts/v2\";\nimport { decodeFunctionResult } from \"viem\";\n\nimport { defineAction, defineExtendedAction } from \"../../../action/action.js\";\nimport type { EnsforgeConfig } from \"../../../config/config.js\";\nimport { ContractError } from \"../../../errors/contract-error.js\";\nimport { WritePlanError } from \"../../../errors/write-plan-error.js\";\nimport { executeSequential } from \"../../../internal/write/execute-sequential.js\";\nimport { EthereumAddress } from \"../../../schemas/identity.js\";\nimport { simulateCalls } from \"../../batch/simulate-calls.js\";\nimport { createResolverIntent } from \"./prepare.js\";\nimport type {\n  CreateResolverError,\n  CreateResolverParameters,\n  CreateResolverResult,\n} from \"./types.js\";\n\nexport const predictResolverAddressEffect = Effect.fn(\"ensforge.predictResolverAddress\")(function* (\n  config: EnsforgeConfig,\n  parameters: CreateResolverParameters,\n) {\n  const simulation = yield* simulateCalls.effect(config, {\n    calls: [createResolverIntent(parameters)],\n    ...(parameters.walletClient === undefined ? {} : { walletClient: parameters.walletClient }),\n    ...(parameters.account === undefined ? {} : { account: parameters.account }),\n  });\n  const raw = simulation[0]?.result;\n  if (raw === undefined) {\n    return yield* new ContractError({\n      code: \"DECODE_FAILED\",\n      message: \"Resolver deployment simulation returned no address\",\n      cause: simulation,\n    });\n  }\n  return yield* Effect.try({\n    try: () =>\n      Schema.decodeUnknownSync(EthereumAddress)(\n        decodeFunctionResult({\n          abi: verifiableFactoryV2DeployProxyAbi,\n          functionName: \"deployProxy\",\n          data: raw,\n        }),\n      ),\n    catch: (cause) =>\n      new ContractError({\n        code: \"DECODE_FAILED\",\n        message: \"Unable to decode the predicted Permissioned Resolver address\",\n        cause,\n      }),\n  });\n});\n\nexport const predictResolverAddress = defineAction<\n  CreateResolverParameters,\n  typeof EthereumAddress.Type,\n  CreateResolverError\n>(predictResolverAddressEffect);\n\nconst implementation = Effect.fn(\"ensforge.createResolver\")(function* (\n  config: EnsforgeConfig,\n  parameters: CreateResolverParameters,\n) {\n  const resolver = yield* predictResolverAddressEffect(config, parameters);\n  const result = yield* executeSequential(config, {\n    calls: [createResolverIntent(parameters)],\n    ...(parameters.walletClient === undefined ? {} : { walletClient: parameters.walletClient }),\n    ...(parameters.account === undefined ? {} : { account: parameters.account }),\n    ...(parameters.confirmation === undefined ? {} : { confirmation: parameters.confirmation }),\n  });\n  const call = result.calls[0];\n  if (call === undefined) {\n    return yield* new WritePlanError({\n      code: \"INVALID_CALL_PLAN\",\n      message: \"createResolver did not produce an execution result\",\n      cause: result,\n    });\n  }\n  const deployment = config.deployments;\n  if (deployment.protocol !== \"v2\") {\n    return yield* new WritePlanError({\n      code: \"INVALID_CALL_PLAN\",\n      message: \"Permissioned Resolver creation requires an ENSv2 deployment\",\n      cause: deployment,\n    });\n  }\n  return {\n    status: \"deployed\",\n    resolver,\n    implementation: deployment.v2.implementations.permissionedResolver,\n    factory: deployment.v2.contracts.verifiableFactory,\n    call,\n  } satisfies CreateResolverResult;\n});\n\nconst action = defineExtendedAction<\n  CreateResolverParameters,\n  CreateResolverResult,\n  CreateResolverError\n>(implementation);\n\nexport const createResolver = Object.freeze(\n  Object.defineProperty(action, \"call\", {\n    value: createResolverIntent,\n    enumerable: true,\n    configurable: false,\n    writable: false,\n  }),\n) as typeof action & { readonly call: typeof createResolverIntent };\n\nexport { prepareCreateResolver } from \"./prepare.js\";\nexport type {\n  CreateResolverError,\n  CreateResolverIntent,\n  CreateResolverParameters,\n  CreateResolverResult,\n} from \"./types.js\";\n"],"mappings":";;;;;;;;;;;;AAmBA,MAAa,+BAA+B,OAAO,GAAG,iCAAiC,CAAC,CAAC,WACvF,QACA,YACA;CACA,MAAM,aAAa,OAAO,cAAc,OAAO,QAAQ;EACrD,OAAO,CAAC,qBAAqB,UAAU,CAAC;EACxC,GAAI,WAAW,iBAAiB,SAAY,CAAC,IAAI,EAAE,cAAc,WAAW,aAAa;EACzF,GAAI,WAAW,YAAY,SAAY,CAAC,IAAI,EAAE,SAAS,WAAW,QAAQ;CAC5E,CAAC;CACD,MAAM,MAAM,WAAW,EAAE,EAAE;CAC3B,IAAI,QAAQ,QACV,OAAO,OAAO,IAAI,cAAc;EAC9B,MAAM;EACN,SAAS;EACT,OAAO;CACT,CAAC;CAEH,OAAO,OAAO,OAAO,IAAI;EACvB,WACE,OAAO,kBAAkB,eAAe,CAAC,CACvC,qBAAqB;GACnB,KAAK;GACL,cAAc;GACd,MAAM;EACR,CAAC,CACH;EACF,QAAQ,UACN,IAAI,cAAc;GAChB,MAAM;GACN,SAAS;GACT;EACF,CAAC;CACL,CAAC;AACH,CAAC;AAED,MAAa,yBAAyB,aAIpC,4BAA4B;AAE9B,MAAM,iBAAiB,OAAO,GAAG,yBAAyB,CAAC,CAAC,WAC1D,QACA,YACA;CACA,MAAM,WAAW,OAAO,6BAA6B,QAAQ,UAAU;CACvE,MAAM,SAAS,OAAO,kBAAkB,QAAQ;EAC9C,OAAO,CAAC,qBAAqB,UAAU,CAAC;EACxC,GAAI,WAAW,iBAAiB,SAAY,CAAC,IAAI,EAAE,cAAc,WAAW,aAAa;EACzF,GAAI,WAAW,YAAY,SAAY,CAAC,IAAI,EAAE,SAAS,WAAW,QAAQ;EAC1E,GAAI,WAAW,iBAAiB,SAAY,CAAC,IAAI,EAAE,cAAc,WAAW,aAAa;CAC3F,CAAC;CACD,MAAM,OAAO,OAAO,MAAM;CAC1B,IAAI,SAAS,QACX,OAAO,OAAO,IAAI,eAAe;EAC/B,MAAM;EACN,SAAS;EACT,OAAO;CACT,CAAC;CAEH,MAAM,aAAa,OAAO;CAC1B,IAAI,WAAW,aAAa,MAC1B,OAAO,OAAO,IAAI,eAAe;EAC/B,MAAM;EACN,SAAS;EACT,OAAO;CACT,CAAC;CAEH,OAAO;EACL,QAAQ;EACR;EACA,gBAAgB,WAAW,GAAG,gBAAgB;EAC9C,SAAS,WAAW,GAAG,UAAU;EACjC;CACF;AACF,CAAC;AAED,MAAM,SAAS,qBAIb,cAAc;AAEhB,MAAa,iBAAiB,OAAO,OACnC,OAAO,eAAe,QAAQ,QAAQ;CACpC,OAAO;CACP,YAAY;CACZ,cAAc;CACd,UAAU;AACZ,CAAC,CACH"}

package/dist/actions/resolution/create-resolver/prepare.d.ts

@@ -0,0 +1,9 @@
+import { CallExecutionResult, WriteError } from "../../../write/types.js";
+import { EnsWriteIntent } from "../../../action/write-intent.js";
+import { CreateResolverParameters } from "./types.js";
+import "../../../index.js";
+//#region src/actions/resolution/create-resolver/prepare.d.ts
+declare const createResolverIntent: (parameters: CreateResolverParameters) => EnsWriteIntent<CallExecutionResult, WriteError>;
+//#endregion
+export { createResolverIntent };
+//# sourceMappingURL=prepare.d.ts.map

package/dist/actions/resolution/create-resolver/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","names":[],"sources":["../../../../src/actions/resolution/create-resolver/prepare.ts"],"mappings":";;;;;cAgFa,uBAAwB,YAAY,6BAAwB,eAAA,qBAAA"}

package/dist/actions/resolution/create-resolver/prepare.js

@@ -0,0 +1,69 @@
+import { makeWriteIntent } from "../../../action/write-intent.js";
+import { Hex as Hex$1 } from "../../../schemas/hex.js";
+import { ContractError } from "../../../errors/contract-error.js";
+import { WritePlanError } from "../../../errors/write-plan-error.js";
+import { CodecError } from "../../../errors/codec-error.js";
+import { EthereumAddress } from "../../../schemas/identity.js";
+import { Effect, Schema } from "effect";
+import { encodeFunctionData } from "viem";
+import { enhancedAccessControlRoles, permissionedResolverInitializableV2InterfaceInitializeAbi, verifiableFactoryV2DeployProxyAbi } from "@ensforge/contracts/v2";
+
+//#region src/actions/resolution/create-resolver/prepare.ts
+const prepareCreateResolver = Effect.fn("ensforge.createResolver.prepare")(function* (config, parameters, context) {
+	const profile = config.deployments;
+	if (profile.protocol !== "v2") return yield* new WritePlanError({
+		code: "INVALID_CALL_PLAN",
+		message: "Permissioned Resolver creation requires an ENSv2 deployment",
+		cause: profile
+	});
+	const account = typeof context.account === "string" ? context.account : context.account.address;
+	const admin = yield* Effect.try({
+		try: () => Schema.decodeUnknownSync(EthereumAddress)(parameters.admin ?? account),
+		catch: () => new CodecError({
+			code: "INVALID_ADDRESS",
+			message: "Invalid Permissioned Resolver administrator address"
+		})
+	});
+	const setters = parameters.setters ?? [];
+	if (setters.some((setter) => !Schema.is(Hex$1)(setter))) return yield* new CodecError({
+		code: "INVALID_HEX",
+		message: "Invalid Permissioned Resolver initialization setter"
+	});
+	const data = yield* Effect.try({
+		try: () => {
+			const initialization = encodeFunctionData({
+				abi: permissionedResolverInitializableV2InterfaceInitializeAbi,
+				functionName: "initialize",
+				args: [[{
+					account: admin,
+					roleBitmap: parameters.roles ?? enhancedAccessControlRoles.allRoles
+				}], setters]
+			});
+			return encodeFunctionData({
+				abi: verifiableFactoryV2DeployProxyAbi,
+				functionName: "deployProxy",
+				args: [
+					profile.v2.implementations.permissionedResolver,
+					parameters.salt,
+					initialization
+				]
+			});
+		},
+		catch: (cause) => new ContractError({
+			code: "ENCODE_FAILED",
+			message: "Unable to encode the Permissioned Resolver deployment",
+			cause
+		})
+	});
+	return {
+		to: profile.v2.contracts.verifiableFactory,
+		data,
+		value: 0n,
+		protocol: "v2"
+	};
+});
+const createResolverIntent = (parameters) => makeWriteIntent("createResolver", parameters, prepareCreateResolver);
+
+//#endregion
+export { createResolverIntent, prepareCreateResolver };
+//# sourceMappingURL=prepare.js.map

package/dist/actions/resolution/create-resolver/prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.js","names":["Hex"],"sources":["../../../../src/actions/resolution/create-resolver/prepare.ts"],"sourcesContent":["import { Effect, Schema } from \"effect\";\n\nimport {\n  enhancedAccessControlRoles,\n  permissionedResolverInitializableV2InterfaceInitializeAbi,\n  verifiableFactoryV2DeployProxyAbi,\n} from \"@ensforge/contracts/v2\";\nimport { encodeFunctionData } from \"viem\";\n\nimport { makeWriteIntent, type EnsWriteIntentPreparer } from \"../../../action/write-intent.js\";\nimport { CodecError } from \"../../../errors/codec-error.js\";\nimport { ContractError } from \"../../../errors/contract-error.js\";\nimport { WritePlanError } from \"../../../errors/write-plan-error.js\";\nimport { Hex } from \"../../../schemas/hex.js\";\nimport { EthereumAddress } from \"../../../schemas/identity.js\";\nimport type { CallExecutionResult, WriteError } from \"../../../write/types.js\";\nimport type { CreateResolverParameters } from \"./types.js\";\n\nexport const prepareCreateResolver: EnsWriteIntentPreparer<CreateResolverParameters, WriteError> =\n  Effect.fn(\"ensforge.createResolver.prepare\")(function* (config, parameters, context) {\n    const profile = config.deployments;\n    if (profile.protocol !== \"v2\") {\n      return yield* new WritePlanError({\n        code: \"INVALID_CALL_PLAN\",\n        message: \"Permissioned Resolver creation requires an ENSv2 deployment\",\n        cause: profile,\n      });\n    }\n    const account = typeof context.account === \"string\" ? context.account : context.account.address;\n    const admin = yield* Effect.try({\n      try: () => Schema.decodeUnknownSync(EthereumAddress)(parameters.admin ?? account),\n      catch: () =>\n        new CodecError({\n          code: \"INVALID_ADDRESS\",\n          message: \"Invalid Permissioned Resolver administrator address\",\n        }),\n    });\n    const setters = parameters.setters ?? [];\n    if (setters.some((setter) => !Schema.is(Hex)(setter))) {\n      return yield* new CodecError({\n        code: \"INVALID_HEX\",\n        message: \"Invalid Permissioned Resolver initialization setter\",\n      });\n    }\n    const data = yield* Effect.try({\n      try: () => {\n        const initialization = encodeFunctionData({\n          abi: permissionedResolverInitializableV2InterfaceInitializeAbi,\n          functionName: \"initialize\",\n          args: [\n            [\n              {\n                account: admin,\n                roleBitmap: parameters.roles ?? enhancedAccessControlRoles.allRoles,\n              },\n            ],\n            setters,\n          ],\n        });\n        return encodeFunctionData({\n          abi: verifiableFactoryV2DeployProxyAbi,\n          functionName: \"deployProxy\",\n          args: [profile.v2.implementations.permissionedResolver, parameters.salt, initialization],\n        });\n      },\n      catch: (cause) =>\n        new ContractError({\n          code: \"ENCODE_FAILED\",\n          message: \"Unable to encode the Permissioned Resolver deployment\",\n          cause,\n        }),\n    });\n    return {\n      to: profile.v2.contracts.verifiableFactory,\n      data,\n      value: 0n,\n      protocol: \"v2\",\n    };\n  });\n\nexport const createResolverIntent = (parameters: CreateResolverParameters) =>\n  makeWriteIntent<CreateResolverParameters, CallExecutionResult, WriteError>(\n    \"createResolver\",\n    parameters,\n    prepareCreateResolver,\n  );\n"],"mappings":";;;;;;;;;;;AAkBA,MAAa,wBACX,OAAO,GAAG,iCAAiC,CAAC,CAAC,WAAW,QAAQ,YAAY,SAAS;CACnF,MAAM,UAAU,OAAO;CACvB,IAAI,QAAQ,aAAa,MACvB,OAAO,OAAO,IAAI,eAAe;EAC/B,MAAM;EACN,SAAS;EACT,OAAO;CACT,CAAC;CAEH,MAAM,UAAU,OAAO,QAAQ,YAAY,WAAW,QAAQ,UAAU,QAAQ,QAAQ;CACxF,MAAM,QAAQ,OAAO,OAAO,IAAI;EAC9B,WAAW,OAAO,kBAAkB,eAAe,CAAC,CAAC,WAAW,SAAS,OAAO;EAChF,aACE,IAAI,WAAW;GACb,MAAM;GACN,SAAS;EACX,CAAC;CACL,CAAC;CACD,MAAM,UAAU,WAAW,WAAW,CAAC;CACvC,IAAI,QAAQ,MAAM,WAAW,CAAC,OAAO,GAAGA,KAAG,CAAC,CAAC,MAAM,CAAC,GAClD,OAAO,OAAO,IAAI,WAAW;EAC3B,MAAM;EACN,SAAS;CACX,CAAC;CAEH,MAAM,OAAO,OAAO,OAAO,IAAI;EAC7B,WAAW;GACT,MAAM,iBAAiB,mBAAmB;IACxC,KAAK;IACL,cAAc;IACd,MAAM,CACJ,CACE;KACE,SAAS;KACT,YAAY,WAAW,SAAS,2BAA2B;IAC7D,CACF,GACA,OACF;GACF,CAAC;GACD,OAAO,mBAAmB;IACxB,KAAK;IACL,cAAc;IACd,MAAM;KAAC,QAAQ,GAAG,gBAAgB;KAAsB,WAAW;KAAM;IAAc;GACzF,CAAC;EACH;EACA,QAAQ,UACN,IAAI,cAAc;GAChB,MAAM;GACN,SAAS;GACT;EACF,CAAC;CACL,CAAC;CACD,OAAO;EACL,IAAI,QAAQ,GAAG,UAAU;EACzB;EACA,OAAO;EACP,UAAU;CACZ;AACF,CAAC;AAEH,MAAa,wBAAwB,eACnC,gBACE,kBACA,YACA,qBACF"}

package/dist/actions/resolution/create-resolver/types.d.ts

@@ -0,0 +1,28 @@
+import { ConfirmationPolicy } from "../../../config/write-options.js";
+import { CallExecutionResult, WriteError } from "../../../write/types.js";
+import { EnsWriteIntent } from "../../../action/write-intent.js";
+import { EthereumAddress } from "../../../schemas/identity.js";
+import { Hex as Hex$1 } from "../../../schemas/hex.js";
+import { Account, Address, WalletClient } from "viem";
+//#region src/actions/resolution/create-resolver/types.d.ts
+interface CreateResolverParameters {
+  readonly salt: bigint;
+  readonly admin?: string;
+  readonly roles?: bigint;
+  readonly setters?: ReadonlyArray<Hex$1>;
+  readonly walletClient?: WalletClient;
+  readonly account?: Account | Address;
+  readonly confirmation?: ConfirmationPolicy;
+}
+interface CreateResolverResult {
+  readonly status: "deployed";
+  readonly resolver: EthereumAddress;
+  readonly implementation: EthereumAddress;
+  readonly factory: EthereumAddress;
+  readonly call: CallExecutionResult;
+}
+type CreateResolverError = WriteError;
+type CreateResolverIntent = EnsWriteIntent<CallExecutionResult, CreateResolverError>;
+//#endregion
+export { CreateResolverError, CreateResolverIntent, CreateResolverParameters, CreateResolverResult };
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/resolution/create-resolver/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/actions/resolution/create-resolver/types.ts"],"mappings":";;;;;;;UAOiB;WACN;WACA;WACA;WACA,UAAU,cAAc;WACxB,eAAe;WACf,UAAU,UAAU;WACpB,eAAe;;UAGT;WACN;WACA,UAAU;WACV,gBAAgB;WAChB,SAAS;WACT,MAAM;;KAGL,sBAAsB;KAEtB,uBAAuB,eAAe,qBAAqB"}

package/dist/actions/resolution/get-alias/index.d.ts

@@ -0,0 +1,19 @@
+import { EnsReadAction } from "../../../action/read-request.js";
+import { AliasResult, GetAliasError, GetAliasParameters } from "./types.js";
+import "../../../index.js";
+//#region src/actions/resolution/get-alias/index.d.ts
+declare const getAlias: EnsReadAction<GetAliasParameters, {
+  readonly supported: false;
+  readonly name: string & import("effect/Brand").Brand<"NormalizedName">;
+  readonly resolver: `0x${string}` | null;
+  readonly reason: "RESOLVER_NOT_FOUND" | "ALIASING_UNSUPPORTED";
+} | {
+  readonly supported: true;
+  readonly name: string & import("effect/Brand").Brand<"NormalizedName">;
+  readonly resolver: `0x${string}`;
+  readonly target: (string & import("effect/Brand").Brand<"NormalizedName">) | null;
+  readonly raw: `0x${string}`;
+}, GetAliasError>;
+//#endregion
+export { AliasResult, type GetAliasError, type GetAliasParameters, getAlias };
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/resolution/get-alias/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/actions/resolution/get-alias/index.ts"],"mappings":";;;;cA6Ea,UAEZ,cAFoB;;;;;;;;;;;GAEpB"}

package/dist/actions/resolution/get-alias/index.js

@@ -0,0 +1,56 @@
+import { defineReadAction } from "../../../action/read-request.js";
+import { executeRead } from "../../../internal/read/execute-read.js";
+import { normalizeName } from "../../../names/normalize.js";
+import { EthereumClient } from "../../../internal/client/ethereum-client.js";
+import { CodecError } from "../../../errors/codec-error.js";
+import { dnsDecodeName, dnsEncodeName } from "../../../names/dns.js";
+import { supportsInterface } from "../../../internal/capabilities/interface-support.js";
+import { findResolver } from "../get-resolver/find.js";
+import { AliasResult } from "./types.js";
+import { Effect } from "effect";
+import { permissionedResolverV2InterfaceGetAliasAbi, resolverInterfaceIds } from "@ensforge/contracts/v2";
+
+//#region src/actions/resolution/get-alias/index.ts
+const getAliasEffect = Effect.fn("ensforge.getAlias")(function* (config, parameters) {
+	const name = yield* normalizeName.effect(parameters.name);
+	return yield* executeRead(config, parameters, Effect.gen(function* () {
+		const discovery = yield* findResolver(name);
+		if (discovery === null) return {
+			supported: false,
+			name,
+			resolver: null,
+			reason: "RESOLVER_NOT_FOUND"
+		};
+		if (!(yield* supportsInterface(discovery.address, resolverInterfaceIds.permissionedResolver))) return {
+			supported: false,
+			name,
+			resolver: discovery.address,
+			reason: "ALIASING_UNSUPPORTED"
+		};
+		const raw = yield* (yield* EthereumClient).readContract({
+			address: discovery.address,
+			abi: permissionedResolverV2InterfaceGetAliasAbi,
+			functionName: "getAlias",
+			args: [yield* dnsEncodeName.effect(name)]
+		});
+		const target = raw === "0x" ? null : yield* Effect.try({
+			try: () => dnsDecodeName(raw),
+			catch: (cause) => cause instanceof CodecError ? cause : new CodecError({
+				code: "INVALID_DNS_NAME",
+				message: `Unable to decode the resolver alias for ${name}`
+			})
+		});
+		return {
+			supported: true,
+			name,
+			resolver: discovery.address,
+			target,
+			raw
+		};
+	}));
+});
+const getAlias = defineReadAction(getAliasEffect);
+
+//#endregion
+export { AliasResult, getAlias };
+//# sourceMappingURL=index.js.map

package/dist/actions/resolution/get-alias/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/actions/resolution/get-alias/index.ts"],"sourcesContent":["import { Effect } from \"effect\";\n\nimport {\n  permissionedResolverV2InterfaceGetAliasAbi,\n  resolverInterfaceIds,\n} from \"@ensforge/contracts/v2\";\n\nimport { defineReadAction } from \"../../../action/read-request.js\";\nimport type { EnsforgeConfig } from \"../../../config/config.js\";\nimport { CodecError } from \"../../../errors/codec-error.js\";\nimport { supportsInterface } from \"../../../internal/capabilities/interface-support.js\";\nimport { EthereumClient } from \"../../../internal/client/ethereum-client.js\";\nimport { executeRead } from \"../../../internal/read/execute-read.js\";\nimport { dnsDecodeName, dnsEncodeName } from \"../../../names/dns.js\";\nimport { normalizeName } from \"../../../names/normalize.js\";\nimport { findResolver } from \"../get-resolver/find.js\";\nimport type { AliasResult, GetAliasError, GetAliasParameters } from \"./types.js\";\n\nconst getAliasEffect = Effect.fn(\"ensforge.getAlias\")(function* (\n  config: EnsforgeConfig,\n  parameters: GetAliasParameters,\n) {\n  const name = yield* normalizeName.effect(parameters.name);\n  return yield* executeRead(\n    config,\n    parameters,\n    Effect.gen(function* () {\n      const discovery = yield* findResolver(name);\n      if (discovery === null) {\n        return {\n          supported: false,\n          name,\n          resolver: null,\n          reason: \"RESOLVER_NOT_FOUND\",\n        } as const satisfies AliasResult;\n      }\n      if (\n        !(yield* supportsInterface(discovery.address, resolverInterfaceIds.permissionedResolver))\n      ) {\n        return {\n          supported: false,\n          name,\n          resolver: discovery.address,\n          reason: \"ALIASING_UNSUPPORTED\",\n        } as const satisfies AliasResult;\n      }\n      const ethereum = yield* EthereumClient;\n      const raw = yield* ethereum.readContract({\n        address: discovery.address,\n        abi: permissionedResolverV2InterfaceGetAliasAbi,\n        functionName: \"getAlias\",\n        args: [yield* dnsEncodeName.effect(name)],\n      });\n      const target =\n        raw === \"0x\"\n          ? null\n          : yield* Effect.try({\n              try: () => dnsDecodeName(raw),\n              catch: (cause) =>\n                cause instanceof CodecError\n                  ? cause\n                  : new CodecError({\n                      code: \"INVALID_DNS_NAME\",\n                      message: `Unable to decode the resolver alias for ${name}`,\n                    }),\n            });\n      return {\n        supported: true,\n        name,\n        resolver: discovery.address,\n        target,\n        raw,\n      } as const satisfies AliasResult;\n    }),\n  );\n});\n\nexport const getAlias = defineReadAction<GetAliasParameters, AliasResult, GetAliasError>(\n  getAliasEffect,\n);\n\nexport { AliasResult, type GetAliasError, type GetAliasParameters } from \"./types.js\";\n"],"mappings":";;;;;;;;;;;;;AAkBA,MAAM,iBAAiB,OAAO,GAAG,mBAAmB,CAAC,CAAC,WACpD,QACA,YACA;CACA,MAAM,OAAO,OAAO,cAAc,OAAO,WAAW,IAAI;CACxD,OAAO,OAAO,YACZ,QACA,YACA,OAAO,IAAI,aAAa;EACtB,MAAM,YAAY,OAAO,aAAa,IAAI;EAC1C,IAAI,cAAc,MAChB,OAAO;GACL,WAAW;GACX;GACA,UAAU;GACV,QAAQ;EACV;EAEF,IACE,EAAE,OAAO,kBAAkB,UAAU,SAAS,qBAAqB,oBAAoB,IAEvF,OAAO;GACL,WAAW;GACX;GACA,UAAU,UAAU;GACpB,QAAQ;EACV;EAGF,MAAM,MAAM,QAAO,OADK,eACG,CAAC,aAAa;GACvC,SAAS,UAAU;GACnB,KAAK;GACL,cAAc;GACd,MAAM,CAAC,OAAO,cAAc,OAAO,IAAI,CAAC;EAC1C,CAAC;EACD,MAAM,SACJ,QAAQ,OACJ,OACA,OAAO,OAAO,IAAI;GAChB,WAAW,cAAc,GAAG;GAC5B,QAAQ,UACN,iBAAiB,aACb,QACA,IAAI,WAAW;IACb,MAAM;IACN,SAAS,2CAA2C;GACtD,CAAC;EACT,CAAC;EACP,OAAO;GACL,WAAW;GACX;GACA,UAAU,UAAU;GACpB;GACA;EACF;CACF,CAAC,CACH;AACF,CAAC;AAED,MAAa,WAAW,iBACtB,cACF"}

package/dist/actions/resolution/get-alias/types.d.ts

@@ -0,0 +1,25 @@
+import { BlockParameters } from "../../../action/block.js";
+import { CodecError } from "../../../errors/codec-error.js";
+import { GetResolverError } from "../get-resolver/types.js";
+import { Schema } from "effect";
+//#region src/actions/resolution/get-alias/types.d.ts
+type GetAliasParameters = {
+  readonly name: string;
+} & BlockParameters;
+declare const AliasResult: Schema.Union<readonly [Schema.Struct<{
+  readonly supported: Schema.Literal<false>;
+  readonly name: Schema.brand<Schema.String, "NormalizedName">;
+  readonly resolver: Schema.NullOr<Schema.declare<`0x${string}`, `0x${string}`>>;
+  readonly reason: Schema.Literals<readonly ["RESOLVER_NOT_FOUND", "ALIASING_UNSUPPORTED"]>;
+}>, Schema.Struct<{
+  readonly supported: Schema.Literal<true>;
+  readonly name: Schema.brand<Schema.String, "NormalizedName">;
+  readonly resolver: Schema.declare<`0x${string}`, `0x${string}`>;
+  readonly target: Schema.NullOr<Schema.brand<Schema.String, "NormalizedName">>;
+  readonly raw: Schema.TemplateLiteral<readonly ["0x", Schema.String]>;
+}>]>;
+type AliasResult = typeof AliasResult.Type;
+type GetAliasError = GetResolverError | CodecError;
+//#endregion
+export { AliasResult, GetAliasError, GetAliasParameters };
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/resolution/get-alias/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/actions/resolution/get-alias/types.ts"],"mappings":";;;;;KASY;WAAgC;IAAiB;cAEhD,aAAW,OAAA,gBAAA,OAAA;;;;;;;;;;;;KAeZ,qBAAqB,YAAY;KAEjC,gBAAgB,mBAAmB"}

package/dist/actions/resolution/get-alias/types.js

@@ -0,0 +1,22 @@
+import { Hex } from "../../../schemas/hex.js";
+import { NormalizedName } from "../../../schemas/name.js";
+import { EthereumAddress } from "../../../schemas/identity.js";
+import { Schema } from "effect";
+
+//#region src/actions/resolution/get-alias/types.ts
+const AliasResult = Schema.Union([Schema.Struct({
+	supported: Schema.Literal(false),
+	name: NormalizedName,
+	resolver: Schema.NullOr(EthereumAddress),
+	reason: Schema.Literals(["RESOLVER_NOT_FOUND", "ALIASING_UNSUPPORTED"])
+}), Schema.Struct({
+	supported: Schema.Literal(true),
+	name: NormalizedName,
+	resolver: EthereumAddress,
+	target: Schema.NullOr(NormalizedName),
+	raw: Hex
+})]);
+
+//#endregion
+export { AliasResult };
+//# sourceMappingURL=types.js.map

package/dist/actions/resolution/get-alias/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../../../src/actions/resolution/get-alias/types.ts"],"sourcesContent":["import { Schema } from \"effect\";\n\nimport type { BlockParameters } from \"../../../action/block.js\";\nimport type { CodecError } from \"../../../errors/codec-error.js\";\nimport { Hex } from \"../../../schemas/hex.js\";\nimport { EthereumAddress } from \"../../../schemas/identity.js\";\nimport { NormalizedName } from \"../../../schemas/name.js\";\nimport type { GetResolverError } from \"../get-resolver/types.js\";\n\nexport type GetAliasParameters = { readonly name: string } & BlockParameters;\n\nexport const AliasResult = Schema.Union([\n  Schema.Struct({\n    supported: Schema.Literal(false),\n    name: NormalizedName,\n    resolver: Schema.NullOr(EthereumAddress),\n    reason: Schema.Literals([\"RESOLVER_NOT_FOUND\", \"ALIASING_UNSUPPORTED\"]),\n  }),\n  Schema.Struct({\n    supported: Schema.Literal(true),\n    name: NormalizedName,\n    resolver: EthereumAddress,\n    target: Schema.NullOr(NormalizedName),\n    raw: Hex,\n  }),\n]);\nexport type AliasResult = typeof AliasResult.Type;\n\nexport type GetAliasError = GetResolverError | CodecError;\n"],"mappings":";;;;;;AAWA,MAAa,cAAc,OAAO,MAAM,CACtC,OAAO,OAAO;CACZ,WAAW,OAAO,QAAQ,KAAK;CAC/B,MAAM;CACN,UAAU,OAAO,OAAO,eAAe;CACvC,QAAQ,OAAO,SAAS,CAAC,sBAAsB,sBAAsB,CAAC;AACxE,CAAC,GACD,OAAO,OAAO;CACZ,WAAW,OAAO,QAAQ,IAAI;CAC9B,MAAM;CACN,UAAU;CACV,QAAQ,OAAO,OAAO,cAAc;CACpC,KAAK;AACP,CAAC,CACH,CAAC"}

package/dist/actions/resolution/get-or-create-resolver/index.d.ts

@@ -0,0 +1,9 @@
+import { EnsAction } from "../../../action/action.js";
+import { WriteError } from "../../../write/types.js";
+import { GetOrCreateResolverError, GetOrCreateResolverParameters, GetOrCreateResolverResult } from "./types.js";
+import "../../../index.js";
+//#region src/actions/resolution/get-or-create-resolver/index.d.ts
+declare const getOrCreateResolver: EnsAction<GetOrCreateResolverParameters, GetOrCreateResolverResult, WriteError>;
+//#endregion
+export { type GetOrCreateResolverError, type GetOrCreateResolverParameters, type GetOrCreateResolverResult, getOrCreateResolver };
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/resolution/get-or-create-resolver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/actions/resolution/get-or-create-resolver/index.ts"],"mappings":";;;;;cAwEa,qBAAmB,UAAA,+BAAA,2BAAA"}

package/dist/actions/resolution/get-or-create-resolver/index.js

@@ -0,0 +1,51 @@
+import { defineAction } from "../../../action/action.js";
+import { WritePlanError } from "../../../errors/write-plan-error.js";
+import { normalizeName } from "../../../names/normalize.js";
+import { namehash } from "../../../names/hashes.js";
+import { getResolverCapabilities } from "../../capabilities/get-resolver-capabilities/index.js";
+import { getProtocol } from "../../name/get-protocol/index.js";
+import { createResolver } from "../create-resolver/index.js";
+import { Effect } from "effect";
+
+//#region src/actions/resolution/get-or-create-resolver/index.ts
+const implementation = Effect.fn("ensforge.getOrCreateResolver")(function* (config, parameters) {
+	const name = yield* normalizeName.effect(parameters.name);
+	const [protocol, capabilities] = yield* Effect.all([getProtocol.effect(config, { name }), getResolverCapabilities.effect(config, { name })], { concurrency: "unbounded" });
+	if (capabilities.address !== null && !capabilities.inherited && capabilities.authorization !== "none" && capabilities.authorization !== "unknown" && capabilities.address !== null) return {
+		status: "existing",
+		protocol,
+		resolver: capabilities.address,
+		inherited: false
+	};
+	if (protocol === "v1") {
+		const deployment = config.deployments.v1;
+		if (deployment === void 0) return yield* new WritePlanError({
+			code: "INVALID_CALL_PLAN",
+			message: "The active deployment does not include an ENSv1 Public Resolver",
+			cause: config.deployments
+		});
+		return {
+			status: "selected",
+			protocol: "v1",
+			resolver: deployment.contracts.publicResolver,
+			inherited: false
+		};
+	}
+	return {
+		...yield* createResolver.effect(config, {
+			salt: parameters.salt ?? BigInt(namehash(name)),
+			...parameters.admin === void 0 ? {} : { admin: parameters.admin },
+			...parameters.roles === void 0 ? {} : { roles: parameters.roles },
+			...parameters.walletClient === void 0 ? {} : { walletClient: parameters.walletClient },
+			...parameters.account === void 0 ? {} : { account: parameters.account },
+			...parameters.confirmation === void 0 ? {} : { confirmation: parameters.confirmation }
+		}),
+		protocol: "v2",
+		inherited: false
+	};
+});
+const getOrCreateResolver = defineAction(implementation);
+
+//#endregion
+export { getOrCreateResolver };
+//# sourceMappingURL=index.js.map

package/dist/actions/resolution/get-or-create-resolver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/actions/resolution/get-or-create-resolver/index.ts"],"sourcesContent":["import { Effect } from \"effect\";\n\nimport { defineAction } from \"../../../action/action.js\";\nimport type { EnsforgeConfig } from \"../../../config/config.js\";\nimport { WritePlanError } from \"../../../errors/write-plan-error.js\";\nimport { namehash } from \"../../../names/hashes.js\";\nimport { normalizeName } from \"../../../names/normalize.js\";\nimport { getResolverCapabilities } from \"../../capabilities/get-resolver-capabilities/index.js\";\nimport { getProtocol } from \"../../name/get-protocol/index.js\";\nimport { createResolver } from \"../create-resolver/index.js\";\nimport type {\n  GetOrCreateResolverError,\n  GetOrCreateResolverParameters,\n  GetOrCreateResolverResult,\n} from \"./types.js\";\n\nconst implementation = Effect.fn(\"ensforge.getOrCreateResolver\")(function* (\n  config: EnsforgeConfig,\n  parameters: GetOrCreateResolverParameters,\n) {\n  const name = yield* normalizeName.effect(parameters.name);\n  const [protocol, capabilities] = yield* Effect.all(\n    [\n      getProtocol.effect(config, { name }),\n      getResolverCapabilities.effect(config, { name }),\n    ] as const,\n    { concurrency: \"unbounded\" },\n  );\n  const compatible =\n    capabilities.address !== null &&\n    !capabilities.inherited &&\n    capabilities.authorization !== \"none\" &&\n    capabilities.authorization !== \"unknown\";\n  if (compatible && capabilities.address !== null) {\n    return {\n      status: \"existing\",\n      protocol,\n      resolver: capabilities.address,\n      inherited: false,\n    } as const satisfies GetOrCreateResolverResult;\n  }\n  if (protocol === \"v1\") {\n    const deployment = config.deployments.v1;\n    if (deployment === undefined) {\n      return yield* new WritePlanError({\n        code: \"INVALID_CALL_PLAN\",\n        message: \"The active deployment does not include an ENSv1 Public Resolver\",\n        cause: config.deployments,\n      });\n    }\n    return {\n      status: \"selected\",\n      protocol: \"v1\",\n      resolver: deployment.contracts.publicResolver,\n      inherited: false,\n    } as const satisfies GetOrCreateResolverResult;\n  }\n  const created = yield* createResolver.effect(config, {\n    salt: parameters.salt ?? BigInt(namehash(name)),\n    ...(parameters.admin === undefined ? {} : { admin: parameters.admin }),\n    ...(parameters.roles === undefined ? {} : { roles: parameters.roles }),\n    ...(parameters.walletClient === undefined ? {} : { walletClient: parameters.walletClient }),\n    ...(parameters.account === undefined ? {} : { account: parameters.account }),\n    ...(parameters.confirmation === undefined ? {} : { confirmation: parameters.confirmation }),\n  });\n  return {\n    ...created,\n    protocol: \"v2\",\n    inherited: false,\n  } as const satisfies GetOrCreateResolverResult;\n});\n\nexport const getOrCreateResolver = defineAction<\n  GetOrCreateResolverParameters,\n  GetOrCreateResolverResult,\n  GetOrCreateResolverError\n>(implementation);\n\nexport type {\n  GetOrCreateResolverError,\n  GetOrCreateResolverParameters,\n  GetOrCreateResolverResult,\n} from \"./types.js\";\n"],"mappings":";;;;;;;;;;AAgBA,MAAM,iBAAiB,OAAO,GAAG,8BAA8B,CAAC,CAAC,WAC/D,QACA,YACA;CACA,MAAM,OAAO,OAAO,cAAc,OAAO,WAAW,IAAI;CACxD,MAAM,CAAC,UAAU,gBAAgB,OAAO,OAAO,IAC7C,CACE,YAAY,OAAO,QAAQ,EAAE,KAAK,CAAC,GACnC,wBAAwB,OAAO,QAAQ,EAAE,KAAK,CAAC,CACjD,GACA,EAAE,aAAa,YAAY,CAC7B;CAMA,IAJE,aAAa,YAAY,QACzB,CAAC,aAAa,aACd,aAAa,kBAAkB,UAC/B,aAAa,kBAAkB,aACf,aAAa,YAAY,MACzC,OAAO;EACL,QAAQ;EACR;EACA,UAAU,aAAa;EACvB,WAAW;CACb;CAEF,IAAI,aAAa,MAAM;EACrB,MAAM,aAAa,OAAO,YAAY;EACtC,IAAI,eAAe,QACjB,OAAO,OAAO,IAAI,eAAe;GAC/B,MAAM;GACN,SAAS;GACT,OAAO,OAAO;EAChB,CAAC;EAEH,OAAO;GACL,QAAQ;GACR,UAAU;GACV,UAAU,WAAW,UAAU;GAC/B,WAAW;EACb;CACF;CASA,OAAO;EACL,GAAG,OATkB,eAAe,OAAO,QAAQ;GACnD,MAAM,WAAW,QAAQ,OAAO,SAAS,IAAI,CAAC;GAC9C,GAAI,WAAW,UAAU,SAAY,CAAC,IAAI,EAAE,OAAO,WAAW,MAAM;GACpE,GAAI,WAAW,UAAU,SAAY,CAAC,IAAI,EAAE,OAAO,WAAW,MAAM;GACpE,GAAI,WAAW,iBAAiB,SAAY,CAAC,IAAI,EAAE,cAAc,WAAW,aAAa;GACzF,GAAI,WAAW,YAAY,SAAY,CAAC,IAAI,EAAE,SAAS,WAAW,QAAQ;GAC1E,GAAI,WAAW,iBAAiB,SAAY,CAAC,IAAI,EAAE,cAAc,WAAW,aAAa;EAC3F,CAAC;EAGC,UAAU;EACV,WAAW;CACb;AACF,CAAC;AAED,MAAa,sBAAsB,aAIjC,cAAc"}

package/dist/actions/resolution/get-or-create-resolver/types.d.ts

@@ -0,0 +1,33 @@
+import { ConfirmationPolicy } from "../../../config/write-options.js";
+import { WriteError } from "../../../write/types.js";
+import { EthereumAddress } from "../../../schemas/identity.js";
+import { CreateResolverResult } from "../create-resolver/types.js";
+import { Account, Address, WalletClient } from "viem";
+//#region src/actions/resolution/get-or-create-resolver/types.d.ts
+interface GetOrCreateResolverParameters {
+  readonly name: string;
+  readonly salt?: bigint;
+  readonly admin?: string;
+  readonly roles?: bigint;
+  readonly walletClient?: WalletClient;
+  readonly account?: Account | Address;
+  readonly confirmation?: ConfirmationPolicy;
+}
+type GetOrCreateResolverResult = {
+  readonly status: "existing";
+  readonly protocol: "v1" | "v2";
+  readonly resolver: EthereumAddress;
+  readonly inherited: false;
+} | {
+  readonly status: "selected";
+  readonly protocol: "v1";
+  readonly resolver: EthereumAddress;
+  readonly inherited: false;
+} | (CreateResolverResult & {
+  readonly protocol: "v2";
+  readonly inherited: false;
+});
+type GetOrCreateResolverError = WriteError;
+//#endregion
+export { GetOrCreateResolverError, GetOrCreateResolverParameters, GetOrCreateResolverResult };
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/resolution/get-or-create-resolver/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/actions/resolution/get-or-create-resolver/types.ts"],"mappings":";;;;;;UAMiB;WACN;WACA;WACA;WACA;WACA,eAAe;WACf,UAAU,UAAU;WACpB,eAAe;;KAGd;WAEG;WACA;WACA,UAAU;WACV;;WAGA;WACA;WACA,UAAU;WACV;KAEV;WAAkC;WAAyB;;KAEpD,2BAA2B"}

package/dist/actions/resolution/get-resolver/find.js

@@ -0,0 +1,34 @@
+import { EthereumClient } from "../../../internal/client/ethereum-client.js";
+import { namehash } from "../../../names/hashes.js";
+import { dnsEncodeName } from "../../../names/dns.js";
+import { DeploymentService } from "../../../internal/services/deployment.js";
+import { Effect } from "effect";
+import { isAddressEqual, zeroAddress } from "viem";
+import { universalResolverFindResolverAbi } from "@ensforge/contracts/shared";
+
+//#region src/actions/resolution/get-resolver/find.ts
+const findResolver = Effect.fn("findResolver")(function* (name) {
+	const deployment = yield* DeploymentService;
+	const ethereum = yield* EthereumClient;
+	const dnsName = yield* dnsEncodeName.effect(name);
+	const universalResolver = deployment.profile.protocol === "v1" ? deployment.profile.v1.contracts.universalResolver : deployment.profile.v2.contracts.universalResolver;
+	yield* Effect.annotateCurrentSpan({
+		"ens.name": name,
+		"ens.deployment.protocol": deployment.profile.protocol
+	});
+	const [address, , offset] = yield* ethereum.readContract({
+		address: universalResolver,
+		abi: universalResolverFindResolverAbi,
+		functionName: "findResolver",
+		args: [dnsName]
+	});
+	return isAddressEqual(address, zeroAddress) ? null : {
+		address,
+		node: namehash(name),
+		offset
+	};
+});
+
+//#endregion
+export { findResolver };
+//# sourceMappingURL=find.js.map

package/dist/actions/resolution/get-resolver/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","names":[],"sources":["../../../../src/actions/resolution/get-resolver/find.ts"],"sourcesContent":["import { Effect } from \"effect\";\n\nimport { universalResolverFindResolverAbi } from \"@ensforge/contracts/shared\";\nimport { isAddressEqual, zeroAddress } from \"viem\";\n\nimport type { CodecError } from \"../../../errors/codec-error.js\";\nimport { EthereumClient } from \"../../../internal/client/ethereum-client.js\";\nimport type { ViemError } from \"../../../internal/errors/viem-error.js\";\nimport type { ReadContext } from \"../../../internal/read/execution-context.js\";\nimport { DeploymentService } from \"../../../internal/services/deployment.js\";\nimport { dnsEncodeName } from \"../../../names/dns.js\";\nimport { namehash } from \"../../../names/hashes.js\";\nimport type { Namehash } from \"../../../schemas/hash.js\";\nimport type { EthereumAddress } from \"../../../schemas/identity.js\";\nimport type { NormalizedName } from \"../../../schemas/name.js\";\n\nexport interface ResolverDiscovery {\n  readonly address: EthereumAddress;\n  readonly node: Namehash;\n  readonly offset: bigint;\n}\n\nexport const findResolver = Effect.fn(\"findResolver\")(function* (\n  name: NormalizedName,\n): Effect.fn.Return<\n  ResolverDiscovery | null,\n  CodecError | ViemError,\n  DeploymentService | EthereumClient | ReadContext\n> {\n  const deployment = yield* DeploymentService;\n  const ethereum = yield* EthereumClient;\n  const dnsName = yield* dnsEncodeName.effect(name);\n  const universalResolver =\n    deployment.profile.protocol === \"v1\"\n      ? deployment.profile.v1.contracts.universalResolver\n      : deployment.profile.v2.contracts.universalResolver;\n\n  yield* Effect.annotateCurrentSpan({\n    \"ens.name\": name,\n    \"ens.deployment.protocol\": deployment.profile.protocol,\n  });\n\n  const [address, , offset] = yield* ethereum.readContract({\n    address: universalResolver,\n    abi: universalResolverFindResolverAbi,\n    functionName: \"findResolver\",\n    args: [dnsName],\n  });\n\n  return isAddressEqual(address, zeroAddress)\n    ? null\n    : {\n        address,\n        node: namehash(name),\n        offset,\n      };\n});\n"],"mappings":";;;;;;;;;AAsBA,MAAa,eAAe,OAAO,GAAG,cAAc,CAAC,CAAC,WACpD,MAKA;CACA,MAAM,aAAa,OAAO;CAC1B,MAAM,WAAW,OAAO;CACxB,MAAM,UAAU,OAAO,cAAc,OAAO,IAAI;CAChD,MAAM,oBACJ,WAAW,QAAQ,aAAa,OAC5B,WAAW,QAAQ,GAAG,UAAU,oBAChC,WAAW,QAAQ,GAAG,UAAU;CAEtC,OAAO,OAAO,oBAAoB;EAChC,YAAY;EACZ,2BAA2B,WAAW,QAAQ;CAChD,CAAC;CAED,MAAM,CAAC,WAAW,UAAU,OAAO,SAAS,aAAa;EACvD,SAAS;EACT,KAAK;EACL,cAAc;EACd,MAAM,CAAC,OAAO;CAChB,CAAC;CAED,OAAO,eAAe,SAAS,WAAW,IACtC,OACA;EACE;EACA,MAAM,SAAS,IAAI;EACnB;CACF;AACN,CAAC"}

package/dist/actions/resolution/get-resolver/index.d.ts

@@ -0,0 +1,8 @@
+import { EnsReadAction } from "../../../action/read-request.js";
+import { GetResolverError, GetResolverParameters, GetResolverResult } from "./types.js";
+import "../../../index.js";
+//#region src/actions/resolution/get-resolver/index.d.ts
+declare const getResolver: EnsReadAction<GetResolverParameters, GetResolverResult, GetResolverError>;
+//#endregion
+export { type GetResolverError, type GetResolverParameters, type GetResolverResult, getResolver };
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/resolution/get-resolver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/actions/resolution/get-resolver/index.ts"],"mappings":";;;;cAkBa,aAAW,cAAA,uBAAA,mBAAA"}

package/dist/actions/resolution/get-resolver/index.js

@@ -0,0 +1,16 @@
+import { defineReadAction } from "../../../action/read-request.js";
+import { executeRead } from "../../../internal/read/execute-read.js";
+import { normalizeName } from "../../../names/normalize.js";
+import { findResolver } from "./find.js";
+import { Effect } from "effect";
+
+//#region src/actions/resolution/get-resolver/index.ts
+const getResolverEffect = Effect.fn("ensforge.getResolver")(function* (config, parameters) {
+	const name = yield* normalizeName.effect(parameters.name);
+	return (yield* executeRead(config, parameters, findResolver(name)))?.address ?? null;
+});
+const getResolver = defineReadAction(getResolverEffect);
+
+//#endregion
+export { getResolver };
+//# sourceMappingURL=index.js.map

package/dist/actions/resolution/get-resolver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../../src/actions/resolution/get-resolver/index.ts"],"sourcesContent":["import { Effect } from \"effect\";\n\nimport { defineReadAction } from \"../../../action/read-request.js\";\nimport type { EnsforgeConfig } from \"../../../config/config.js\";\nimport { executeRead } from \"../../../internal/read/execute-read.js\";\nimport { normalizeName } from \"../../../names/normalize.js\";\nimport { findResolver } from \"./find.js\";\nimport type { GetResolverError, GetResolverParameters, GetResolverResult } from \"./types.js\";\n\nconst getResolverEffect = Effect.fn(\"ensforge.getResolver\")(function* (\n  config: EnsforgeConfig,\n  parameters: GetResolverParameters,\n) {\n  const name = yield* normalizeName.effect(parameters.name);\n  const discovery = yield* executeRead(config, parameters, findResolver(name));\n  return discovery?.address ?? null;\n});\n\nexport const getResolver = defineReadAction<\n  GetResolverParameters,\n  GetResolverResult,\n  GetResolverError\n>(getResolverEffect);\n\nexport type { GetResolverError, GetResolverParameters, GetResolverResult } from \"./types.js\";\n"],"mappings":";;;;;;;AASA,MAAM,oBAAoB,OAAO,GAAG,sBAAsB,CAAC,CAAC,WAC1D,QACA,YACA;CACA,MAAM,OAAO,OAAO,cAAc,OAAO,WAAW,IAAI;CAExD,QAAO,OADkB,YAAY,QAAQ,YAAY,aAAa,IAAI,CAAC,EAC3D,EAAE,WAAW;AAC/B,CAAC;AAED,MAAa,cAAc,iBAIzB,iBAAiB"}

package/dist/actions/resolution/get-resolver/types.d.ts

@@ -0,0 +1,15 @@
+import { BlockParameters } from "../../../action/block.js";
+import { CodecError } from "../../../errors/codec-error.js";
+import { ContractError } from "../../../errors/contract-error.js";
+import { NameError } from "../../../errors/name-error.js";
+import { RpcError } from "../../../errors/rpc-error.js";
+import { EthereumAddress } from "../../../schemas/identity.js";
+//#region src/actions/resolution/get-resolver/types.d.ts
+type GetResolverParameters = {
+  readonly name: string;
+} & BlockParameters;
+type GetResolverResult = EthereumAddress | null;
+type GetResolverError = CodecError | ContractError | NameError | RpcError;
+//#endregion
+export { GetResolverError, GetResolverParameters, GetResolverResult };
+//# sourceMappingURL=types.d.ts.map

package/dist/actions/resolution/get-resolver/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../../src/actions/resolution/get-resolver/types.ts"],"mappings":";;;;;;;KAOY;WACD;IACP;KAEQ,oBAAoB;KAEpB,mBAAmB,aAAa,gBAAgB,YAAY"}

package/dist/actions/resolution/get-resolver-version/index.d.ts

@@ -0,0 +1,20 @@
+import { EnsReadAction } from "../../../action/read-request.js";
+import { GetResolverError } from "../get-resolver/types.js";
+import { GetResolverVersionError, GetResolverVersionParameters, ResolverVersionResult } from "./types.js";
+import "../index.js";
+import "../../../index.js";
+//#region src/actions/resolution/get-resolver-version/index.d.ts
+declare const getResolverVersion: EnsReadAction<GetResolverVersionParameters, {
+  readonly supported: false;
+  readonly name: string & import("effect/Brand").Brand<"NormalizedName">;
+  readonly resolver: `0x${string}` | null;
+  readonly reason: "RESOLVER_NOT_FOUND" | "VERSIONING_UNSUPPORTED";
+} | {
+  readonly supported: true;
+  readonly name: string & import("effect/Brand").Brand<"NormalizedName">;
+  readonly resolver: `0x${string}`;
+  readonly version: bigint;
+}, GetResolverError>;
+//#endregion
+export { type GetResolverVersionError, type GetResolverVersionParameters, ResolverVersionResult, getResolverVersion };
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/resolution/get-resolver-version/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../../src/actions/resolution/get-resolver-version/index.ts"],"mappings":";;;;;;cA6Da,oBAIc,cAJI;;;;;;;;;;GAAA"}