@ensforge/core 0.0.0

package/dist/internal/resolver/resolve-records.js

@@ -0,0 +1,64 @@
+import { ContractError } from "../../errors/contract-error.js";
+import { isContractRevert } from "../errors/viem-error.js";
+import { dnsEncodeName } from "../../names/dns.js";
+import { DeploymentService } from "../services/deployment.js";
+import { resolveName } from "./resolve-name.js";
+import { Effect } from "effect";
+import { decodeFunctionResult, encodeFunctionData } from "viem";
+import { multicallResolverAbi } from "@ensforge/contracts/resolver-profiles";
+
+//#region src/internal/resolver/resolve-records.ts
+const resolveRecords = Effect.fn("resolveRecords")(function* (name, calls) {
+	if (calls.length === 0) return [];
+	const firstCall = calls[0];
+	if (firstCall === void 0) return [];
+	const data = calls.length === 1 ? firstCall : yield* Effect.try({
+		try: () => encodeFunctionData({
+			abi: multicallResolverAbi,
+			functionName: "multicall",
+			args: [calls]
+		}),
+		catch: (cause) => new ContractError({
+			code: "ENCODE_FAILED",
+			message: "Unable to encode the resolver record multicall",
+			cause
+		})
+	});
+	const deployment = yield* DeploymentService;
+	const protocol = deployment.profile.protocol;
+	const universalResolver = protocol === "v1" ? deployment.profile.v1.contracts.universalResolver : deployment.profile.v2.contracts.universalResolver;
+	const dnsName = yield* dnsEncodeName.effect(name);
+	const resolved = yield* resolveName({
+		universalResolver,
+		protocol,
+		name: dnsName,
+		data
+	}).pipe(Effect.catchIf((error) => isContractRevert(error.cause, "ResolverNotFound"), () => Effect.succeed(null)));
+	if (resolved === null) return null;
+	const [encodedResults] = resolved;
+	const results = yield* Effect.try({
+		try: () => calls.length === 1 ? [encodedResults] : decodeFunctionResult({
+			abi: multicallResolverAbi,
+			functionName: "multicall",
+			data: encodedResults
+		}),
+		catch: (cause) => new ContractError({
+			code: "DECODE_FAILED",
+			message: "Unable to decode ENS resolver record results",
+			cause
+		})
+	});
+	if (results.length !== calls.length) return yield* new ContractError({
+		code: "DECODE_FAILED",
+		message: "Resolver returned an unexpected number of records",
+		cause: {
+			expected: calls.length,
+			actual: results.length
+		}
+	});
+	return results;
+});
+
+//#endregion
+export { resolveRecords };
+//# sourceMappingURL=resolve-records.js.map

package/dist/internal/resolver/resolve-records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-records.js","names":[],"sources":["../../../src/internal/resolver/resolve-records.ts"],"sourcesContent":["import { Effect } from \"effect\";\n\nimport { multicallResolverAbi } from \"@ensforge/contracts/resolver-profiles\";\nimport { decodeFunctionResult, encodeFunctionData, type Hex } from \"viem\";\n\nimport { ContractError } from \"../../errors/contract-error.js\";\nimport { dnsEncodeName } from \"../../names/dns.js\";\nimport type { NormalizedName } from \"../../schemas/name.js\";\nimport { isContractRevert } from \"../errors/viem-error.js\";\nimport { DeploymentService } from \"../services/deployment.js\";\nimport { resolveName } from \"./resolve-name.js\";\n\nexport const resolveRecords = Effect.fn(\"resolveRecords\")(function* (\n  name: NormalizedName,\n  calls: ReadonlyArray<Hex>,\n) {\n  if (calls.length === 0) return [];\n\n  const firstCall = calls[0];\n  if (firstCall === undefined) return [];\n\n  const data =\n    calls.length === 1\n      ? firstCall\n      : yield* Effect.try({\n          try: () =>\n            encodeFunctionData({\n              abi: multicallResolverAbi,\n              functionName: \"multicall\",\n              args: [calls],\n            }),\n          catch: (cause) =>\n            new ContractError({\n              code: \"ENCODE_FAILED\",\n              message: \"Unable to encode the resolver record multicall\",\n              cause,\n            }),\n        });\n  const deployment = yield* DeploymentService;\n  const protocol = deployment.profile.protocol;\n  const universalResolver =\n    protocol === \"v1\"\n      ? deployment.profile.v1.contracts.universalResolver\n      : deployment.profile.v2.contracts.universalResolver;\n  const dnsName = yield* dnsEncodeName.effect(name);\n  const resolved = yield* resolveName({\n    universalResolver,\n    protocol,\n    name: dnsName,\n    data,\n  }).pipe(\n    Effect.catchIf(\n      (error) => isContractRevert(error.cause, \"ResolverNotFound\"),\n      () => Effect.succeed(null),\n    ),\n  );\n\n  if (resolved === null) return null;\n\n  const [encodedResults] = resolved;\n  const results = yield* Effect.try({\n    try: () =>\n      calls.length === 1\n        ? [encodedResults]\n        : decodeFunctionResult({\n            abi: multicallResolverAbi,\n            functionName: \"multicall\",\n            data: encodedResults,\n          }),\n    catch: (cause) =>\n      new ContractError({\n        code: \"DECODE_FAILED\",\n        message: \"Unable to decode ENS resolver record results\",\n        cause,\n      }),\n  });\n\n  if (results.length !== calls.length) {\n    return yield* new ContractError({\n      code: \"DECODE_FAILED\",\n      message: \"Resolver returned an unexpected number of records\",\n      cause: { expected: calls.length, actual: results.length },\n    });\n  }\n\n  return results;\n});\n"],"mappings":";;;;;;;;;;AAYA,MAAa,iBAAiB,OAAO,GAAG,gBAAgB,CAAC,CAAC,WACxD,MACA,OACA;CACA,IAAI,MAAM,WAAW,GAAG,OAAO,CAAC;CAEhC,MAAM,YAAY,MAAM;CACxB,IAAI,cAAc,QAAW,OAAO,CAAC;CAErC,MAAM,OACJ,MAAM,WAAW,IACb,YACA,OAAO,OAAO,IAAI;EAChB,WACE,mBAAmB;GACjB,KAAK;GACL,cAAc;GACd,MAAM,CAAC,KAAK;EACd,CAAC;EACH,QAAQ,UACN,IAAI,cAAc;GAChB,MAAM;GACN,SAAS;GACT;EACF,CAAC;CACL,CAAC;CACP,MAAM,aAAa,OAAO;CAC1B,MAAM,WAAW,WAAW,QAAQ;CACpC,MAAM,oBACJ,aAAa,OACT,WAAW,QAAQ,GAAG,UAAU,oBAChC,WAAW,QAAQ,GAAG,UAAU;CACtC,MAAM,UAAU,OAAO,cAAc,OAAO,IAAI;CAChD,MAAM,WAAW,OAAO,YAAY;EAClC;EACA;EACA,MAAM;EACN;CACF,CAAC,CAAC,CAAC,KACD,OAAO,SACJ,UAAU,iBAAiB,MAAM,OAAO,kBAAkB,SACrD,OAAO,QAAQ,IAAI,CAC3B,CACF;CAEA,IAAI,aAAa,MAAM,OAAO;CAE9B,MAAM,CAAC,kBAAkB;CACzB,MAAM,UAAU,OAAO,OAAO,IAAI;EAChC,WACE,MAAM,WAAW,IACb,CAAC,cAAc,IACf,qBAAqB;GACnB,KAAK;GACL,cAAc;GACd,MAAM;EACR,CAAC;EACP,QAAQ,UACN,IAAI,cAAc;GAChB,MAAM;GACN,SAAS;GACT;EACF,CAAC;CACL,CAAC;CAED,IAAI,QAAQ,WAAW,MAAM,QAC3B,OAAO,OAAO,IAAI,cAAc;EAC9B,MAAM;EACN,SAAS;EACT,OAAO;GAAE,UAAU,MAAM;GAAQ,QAAQ,QAAQ;EAAO;CAC1D,CAAC;CAGH,OAAO;AACT,CAAC"}

package/dist/internal/resolver/reverse-address.js

@@ -0,0 +1,33 @@
+import { ReadContext } from "../read/execution-context.js";
+import { EthereumClient } from "../client/ethereum-client.js";
+import { DeploymentService } from "../services/deployment.js";
+import { Effect } from "effect";
+import { universalResolverV1ReverseAbi } from "@ensforge/contracts/v1";
+import { universalResolverV2ReverseAbi } from "@ensforge/contracts/v2";
+
+//#region src/internal/resolver/reverse-address.ts
+const reverseAddress = Effect.fn("reverseAddress")(function* (address, coinType) {
+	const ethereum = yield* EthereumClient;
+	const context = yield* ReadContext;
+	const deployment = yield* DeploymentService;
+	const protocol = deployment.profile.protocol;
+	const universalResolver = protocol === "v1" ? deployment.profile.v1.contracts.universalResolver : deployment.profile.v2.contracts.universalResolver;
+	if (protocol === "v1") return yield* ethereum.readContractDirect({
+		address: universalResolver,
+		abi: universalResolverV1ReverseAbi,
+		functionName: "reverse",
+		args: [address, coinType],
+		...context.block
+	});
+	return yield* ethereum.readContractDirect({
+		address: universalResolver,
+		abi: universalResolverV2ReverseAbi,
+		functionName: "reverse",
+		args: [address, coinType],
+		...context.block
+	});
+});
+
+//#endregion
+export { reverseAddress };
+//# sourceMappingURL=reverse-address.js.map

package/dist/internal/resolver/reverse-address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reverse-address.js","names":[],"sources":["../../../src/internal/resolver/reverse-address.ts"],"sourcesContent":["import { Effect } from \"effect\";\n\nimport { universalResolverV1ReverseAbi } from \"@ensforge/contracts/v1\";\nimport { universalResolverV2ReverseAbi } from \"@ensforge/contracts/v2\";\nimport type { Address, Hex } from \"viem\";\n\nimport { EthereumClient } from \"../client/ethereum-client.js\";\nimport type { ViemError } from \"../errors/viem-error.js\";\nimport { ReadContext } from \"../read/execution-context.js\";\nimport { DeploymentService } from \"../services/deployment.js\";\n\nexport const reverseAddress = Effect.fn(\"reverseAddress\")(function* (\n  address: Hex,\n  coinType: bigint,\n): Effect.fn.Return<\n  readonly [string, Address, Address],\n  ViemError,\n  DeploymentService | EthereumClient | ReadContext\n> {\n  const ethereum = yield* EthereumClient;\n  const context = yield* ReadContext;\n  const deployment = yield* DeploymentService;\n  const protocol = deployment.profile.protocol;\n  const universalResolver =\n    protocol === \"v1\"\n      ? deployment.profile.v1.contracts.universalResolver\n      : deployment.profile.v2.contracts.universalResolver;\n\n  if (protocol === \"v1\") {\n    return yield* ethereum.readContractDirect({\n      address: universalResolver,\n      abi: universalResolverV1ReverseAbi,\n      functionName: \"reverse\",\n      args: [address, coinType],\n      ...context.block,\n    });\n  }\n\n  return yield* ethereum.readContractDirect({\n    address: universalResolver,\n    abi: universalResolverV2ReverseAbi,\n    functionName: \"reverse\",\n    args: [address, coinType],\n    ...context.block,\n  });\n});\n"],"mappings":";;;;;;;;AAWA,MAAa,iBAAiB,OAAO,GAAG,gBAAgB,CAAC,CAAC,WACxD,SACA,UAKA;CACA,MAAM,WAAW,OAAO;CACxB,MAAM,UAAU,OAAO;CACvB,MAAM,aAAa,OAAO;CAC1B,MAAM,WAAW,WAAW,QAAQ;CACpC,MAAM,oBACJ,aAAa,OACT,WAAW,QAAQ,GAAG,UAAU,oBAChC,WAAW,QAAQ,GAAG,UAAU;CAEtC,IAAI,aAAa,MACf,OAAO,OAAO,SAAS,mBAAmB;EACxC,SAAS;EACT,KAAK;EACL,cAAc;EACd,MAAM,CAAC,SAAS,QAAQ;EACxB,GAAG,QAAQ;CACb,CAAC;CAGH,OAAO,OAAO,SAAS,mBAAmB;EACxC,SAAS;EACT,KAAK;EACL,cAAc;EACd,MAAM,CAAC,SAAS,QAAQ;EACxB,GAAG,QAAQ;CACb,CAAC;AACH,CAAC"}

package/dist/internal/services/context.js

@@ -0,0 +1,30 @@
+import { ReadExecution, makeReadExecution } from "../read/execution-context.js";
+import { PublicClientService } from "./public-client.js";
+import { EnsNetworkService } from "./network.js";
+import { WalletClientService, makeWalletClientService } from "./wallet-client.js";
+import { WriteClient, makeWriteClient } from "../write/write-client.js";
+import { EthereumClient, makeEthereumClient } from "../client/ethereum-client.js";
+import { DeploymentService } from "./deployment.js";
+import { withGatewayPolicy } from "../gateway/ccip-request.js";
+import { Context, Semaphore } from "effect";
+
+//#region src/internal/services/context.ts
+const makeServicesContext = (values) => {
+	const readSemaphore = Semaphore.makeUnsafe(values.reads.concurrency);
+	const ccipClient = withGatewayPolicy(values.publicClient, values.gateways);
+	return Context.make(EnsNetworkService, {
+		network: values.network,
+		chainId: values.chainId
+	}).pipe(Context.add(PublicClientService, { client: values.publicClient }), Context.add(EthereumClient, makeEthereumClient({
+		publicClient: ccipClient,
+		readSemaphore
+	})), Context.add(ReadExecution, makeReadExecution({
+		publicClient: values.publicClient,
+		readSemaphore,
+		multicallBatchSize: values.reads.multicallBatchSize
+	})), Context.add(WriteClient, makeWriteClient(values.publicClient, readSemaphore)), Context.add(WalletClientService, makeWalletClientService(values.walletClient, values.walletClientResolver)), Context.add(DeploymentService, { profile: values.deployments }));
+};
+
+//#endregion
+export { makeServicesContext };
+//# sourceMappingURL=context.js.map

package/dist/internal/services/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","names":[],"sources":["../../../src/internal/services/context.ts"],"sourcesContent":["import { Context, Layer, Semaphore } from \"effect\";\n\nimport type { PublicClient, WalletClient } from \"viem\";\n\nimport type {\n  EnsDeploymentProfile,\n  EnsRuntimeChainId,\n  EnsRuntimeNetwork,\n} from \"../../config/config.js\";\nimport type { ResolvedGatewayOptions } from \"../../config/gateway-options.js\";\nimport type { ResolvedReadOptions } from \"../../config/read-options.js\";\nimport { EthereumClient, makeEthereumClient } from \"../client/ethereum-client.js\";\nimport { withGatewayPolicy } from \"../gateway/ccip-request.js\";\nimport { ReadExecution, makeReadExecution } from \"../read/execution-context.js\";\nimport { WriteClient, makeWriteClient } from \"../write/write-client.js\";\nimport { DeploymentService } from \"./deployment.js\";\nimport { EnsNetworkService } from \"./network.js\";\nimport { PublicClientService } from \"./public-client.js\";\nimport {\n  makeWalletClientService,\n  WalletClientService,\n  type WalletClientResolver,\n} from \"./wallet-client.js\";\n\nexport type EnsforgeServices =\n  | DeploymentService\n  | EthereumClient\n  | ReadExecution\n  | WriteClient\n  | EnsNetworkService\n  | PublicClientService\n  | WalletClientService;\n\nexport interface EnsforgeServiceValues {\n  readonly network: EnsRuntimeNetwork;\n  readonly chainId: EnsRuntimeChainId;\n  readonly publicClient: PublicClient;\n  readonly reads: ResolvedReadOptions;\n  readonly gateways: ResolvedGatewayOptions;\n  readonly walletClient?: WalletClient;\n  readonly walletClientResolver?: WalletClientResolver;\n  readonly deployments: EnsDeploymentProfile;\n}\n\nexport const makeServicesContext = (\n  values: EnsforgeServiceValues,\n): Context.Context<EnsforgeServices> => {\n  const readSemaphore = Semaphore.makeUnsafe(values.reads.concurrency);\n  const ccipClient = withGatewayPolicy(values.publicClient, values.gateways);\n\n  return Context.make(EnsNetworkService, {\n    network: values.network,\n    chainId: values.chainId,\n  }).pipe(\n    Context.add(PublicClientService, { client: values.publicClient }),\n    Context.add(EthereumClient, makeEthereumClient({ publicClient: ccipClient, readSemaphore })),\n    Context.add(\n      ReadExecution,\n      makeReadExecution({\n        publicClient: values.publicClient,\n        readSemaphore,\n        multicallBatchSize: values.reads.multicallBatchSize,\n      }),\n    ),\n    Context.add(WriteClient, makeWriteClient(values.publicClient, readSemaphore)),\n    Context.add(\n      WalletClientService,\n      makeWalletClientService(values.walletClient, values.walletClientResolver),\n    ),\n    Context.add(DeploymentService, { profile: values.deployments }),\n  );\n};\n\nexport const makeServicesLayer = (values: EnsforgeServiceValues): Layer.Layer<EnsforgeServices> =>\n  Layer.succeedContext(makeServicesContext(values));\n"],"mappings":";;;;;;;;;;;AA4CA,MAAa,uBACX,WACsC;CACtC,MAAM,gBAAgB,UAAU,WAAW,OAAO,MAAM,WAAW;CACnE,MAAM,aAAa,kBAAkB,OAAO,cAAc,OAAO,QAAQ;CAEzE,OAAO,QAAQ,KAAK,mBAAmB;EACrC,SAAS,OAAO;EAChB,SAAS,OAAO;CAClB,CAAC,CAAC,CAAC,KACD,QAAQ,IAAI,qBAAqB,EAAE,QAAQ,OAAO,aAAa,CAAC,GAChE,QAAQ,IAAI,gBAAgB,mBAAmB;EAAE,cAAc;EAAY;CAAc,CAAC,CAAC,GAC3F,QAAQ,IACN,eACA,kBAAkB;EAChB,cAAc,OAAO;EACrB;EACA,oBAAoB,OAAO,MAAM;CACnC,CAAC,CACH,GACA,QAAQ,IAAI,aAAa,gBAAgB,OAAO,cAAc,aAAa,CAAC,GAC5E,QAAQ,IACN,qBACA,wBAAwB,OAAO,cAAc,OAAO,oBAAoB,CAC1E,GACA,QAAQ,IAAI,mBAAmB,EAAE,SAAS,OAAO,YAAY,CAAC,CAChE;AACF"}

package/dist/internal/services/deployment.js

@@ -0,0 +1,8 @@
+import { Context } from "effect";
+
+//#region src/internal/services/deployment.ts
+var DeploymentService = class extends Context.Service()("@ensforge/core/DeploymentService") {};
+
+//#endregion
+export { DeploymentService };
+//# sourceMappingURL=deployment.js.map

package/dist/internal/services/deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.js","names":[],"sources":["../../../src/internal/services/deployment.ts"],"sourcesContent":["import { Context } from \"effect\";\n\nimport type { EnsDeploymentProfile } from \"../../config/config.js\";\n\nexport class DeploymentService extends Context.Service<\n  DeploymentService,\n  {\n    readonly profile: EnsDeploymentProfile;\n  }\n>()(\"@ensforge/core/DeploymentService\") {}\n"],"mappings":";;;AAIA,IAAa,oBAAb,cAAuC,QAAQ,QAK7C,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC"}

package/dist/internal/services/network.js

@@ -0,0 +1,8 @@
+import { Context } from "effect";
+
+//#region src/internal/services/network.ts
+var EnsNetworkService = class extends Context.Service()("@ensforge/core/EnsNetworkService") {};
+
+//#endregion
+export { EnsNetworkService };
+//# sourceMappingURL=network.js.map

package/dist/internal/services/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","names":[],"sources":["../../../src/internal/services/network.ts"],"sourcesContent":["import { Context } from \"effect\";\n\nimport type { EnsRuntimeChainId, EnsRuntimeNetwork } from \"../../config/config.js\";\n\nexport class EnsNetworkService extends Context.Service<\n  EnsNetworkService,\n  {\n    readonly network: EnsRuntimeNetwork;\n    readonly chainId: EnsRuntimeChainId;\n  }\n>()(\"@ensforge/core/EnsNetworkService\") {}\n"],"mappings":";;;AAIA,IAAa,oBAAb,cAAuC,QAAQ,QAM7C,CAAC,CAAC,kCAAkC,CAAC,CAAC,CAAC"}

package/dist/internal/services/public-client.js

@@ -0,0 +1,8 @@
+import { Context } from "effect";
+
+//#region src/internal/services/public-client.ts
+var PublicClientService = class extends Context.Service()("@ensforge/core/PublicClientService") {};
+
+//#endregion
+export { PublicClientService };
+//# sourceMappingURL=public-client.js.map

package/dist/internal/services/public-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-client.js","names":[],"sources":["../../../src/internal/services/public-client.ts"],"sourcesContent":["import { Context } from \"effect\";\n\nimport type { PublicClient } from \"viem\";\n\nexport class PublicClientService extends Context.Service<\n  PublicClientService,\n  {\n    readonly client: PublicClient;\n  }\n>()(\"@ensforge/core/PublicClientService\") {}\n"],"mappings":";;;AAIA,IAAa,sBAAb,cAAyC,QAAQ,QAK/C,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC"}

package/dist/internal/services/wallet-client.js

@@ -0,0 +1,45 @@
+import { ConfigError } from "../../errors/config-error.js";
+import { EnsNetworkService } from "./network.js";
+import { Context, Effect, Option } from "effect";
+
+//#region src/internal/services/wallet-client.ts
+var WalletClientService = class extends Context.Service()("@ensforge/core/WalletClientService") {};
+const makeWalletClientService = (walletClient, resolver) => {
+	const client = Option.fromNullishOr(walletClient);
+	return WalletClientService.of({
+		client,
+		resolve: resolver ?? (() => Option.match(client, {
+			onNone: () => new ConfigError({
+				code: "WALLET_CLIENT_UNAVAILABLE",
+				message: "A wallet client is required for this operation"
+			}),
+			onSome: Effect.succeed
+		}))
+	});
+};
+const resolveWalletContext = Effect.fn("ensforge.resolveWalletContext")(function* (parameters = {}) {
+	const walletService = yield* WalletClientService;
+	const networkService = yield* EnsNetworkService;
+	const walletClient = parameters.walletClient === void 0 ? yield* walletService.resolve() : parameters.walletClient;
+	if (walletClient.chain === void 0) return yield* new ConfigError({
+		code: "CLIENT_CHAIN_UNAVAILABLE",
+		message: "The wallet client must be configured with a chain"
+	});
+	if (walletClient.chain.id !== networkService.chainId) return yield* new ConfigError({
+		code: "NETWORK_CLIENT_MISMATCH",
+		message: `The wallet client chain ${walletClient.chain.id} does not match ${networkService.network} (${networkService.chainId})`
+	});
+	const account = parameters.account ?? walletClient.account;
+	if (account === void 0) return yield* new ConfigError({
+		code: "WALLET_ACCOUNT_UNAVAILABLE",
+		message: "An account is required for this operation"
+	});
+	return {
+		walletClient,
+		account
+	};
+});
+
+//#endregion
+export { WalletClientService, makeWalletClientService, resolveWalletContext };
+//# sourceMappingURL=wallet-client.js.map

package/dist/internal/services/wallet-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-client.js","names":[],"sources":["../../../src/internal/services/wallet-client.ts"],"sourcesContent":["import { Context, Effect, Option } from \"effect\";\n\nimport type { Account, Address, WalletClient } from \"viem\";\n\nimport { ConfigError } from \"../../errors/config-error.js\";\nimport { EnsNetworkService } from \"./network.js\";\n\nexport class WalletClientService extends Context.Service<\n  WalletClientService,\n  {\n    readonly client: Option.Option<WalletClient>;\n    readonly resolve: () => Effect.Effect<WalletClient, ConfigError>;\n  }\n>()(\"@ensforge/core/WalletClientService\") {}\n\nexport type WalletClientResolver = () => Effect.Effect<WalletClient, ConfigError>;\n\nexport const makeWalletClientService = (\n  walletClient?: WalletClient,\n  resolver?: WalletClientResolver,\n): WalletClientService[\"Service\"] => {\n  const client = Option.fromNullishOr(walletClient);\n\n  return WalletClientService.of({\n    client,\n    resolve:\n      resolver ??\n      (() =>\n        Option.match(client, {\n          onNone: () =>\n            new ConfigError({\n              code: \"WALLET_CLIENT_UNAVAILABLE\",\n              message: \"A wallet client is required for this operation\",\n            }),\n          onSome: Effect.succeed,\n        })),\n  });\n};\n\nexport interface ResolveWalletContextParameters {\n  readonly walletClient?: WalletClient;\n  readonly account?: Account | Address;\n}\n\nexport interface ResolvedWalletContext {\n  readonly walletClient: WalletClient;\n  readonly account: Account | Address;\n}\n\nexport const resolveWalletContext = Effect.fn(\"ensforge.resolveWalletContext\")(function* (\n  parameters: ResolveWalletContextParameters = {},\n): Effect.fn.Return<ResolvedWalletContext, ConfigError, WalletClientService | EnsNetworkService> {\n  const walletService = yield* WalletClientService;\n  const networkService = yield* EnsNetworkService;\n  const walletClient =\n    parameters.walletClient === undefined\n      ? yield* walletService.resolve()\n      : parameters.walletClient;\n\n  if (walletClient.chain === undefined) {\n    return yield* new ConfigError({\n      code: \"CLIENT_CHAIN_UNAVAILABLE\",\n      message: \"The wallet client must be configured with a chain\",\n    });\n  }\n\n  if (walletClient.chain.id !== networkService.chainId) {\n    return yield* new ConfigError({\n      code: \"NETWORK_CLIENT_MISMATCH\",\n      message: `The wallet client chain ${walletClient.chain.id} does not match ${networkService.network} (${networkService.chainId})`,\n    });\n  }\n\n  const account = parameters.account ?? walletClient.account;\n\n  if (account === undefined) {\n    return yield* new ConfigError({\n      code: \"WALLET_ACCOUNT_UNAVAILABLE\",\n      message: \"An account is required for this operation\",\n    });\n  }\n\n  return { walletClient, account };\n});\n"],"mappings":";;;;;AAOA,IAAa,sBAAb,cAAyC,QAAQ,QAM/C,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC;AAI3C,MAAa,2BACX,cACA,aACmC;CACnC,MAAM,SAAS,OAAO,cAAc,YAAY;CAEhD,OAAO,oBAAoB,GAAG;EAC5B;EACA,SACE,mBAEE,OAAO,MAAM,QAAQ;GACnB,cACE,IAAI,YAAY;IACd,MAAM;IACN,SAAS;GACX,CAAC;GACH,QAAQ,OAAO;EACjB,CAAC;CACP,CAAC;AACH;AAYA,MAAa,uBAAuB,OAAO,GAAG,+BAA+B,CAAC,CAAC,WAC7E,aAA6C,CAAC,GACiD;CAC/F,MAAM,gBAAgB,OAAO;CAC7B,MAAM,iBAAiB,OAAO;CAC9B,MAAM,eACJ,WAAW,iBAAiB,SACxB,OAAO,cAAc,QAAQ,IAC7B,WAAW;CAEjB,IAAI,aAAa,UAAU,QACzB,OAAO,OAAO,IAAI,YAAY;EAC5B,MAAM;EACN,SAAS;CACX,CAAC;CAGH,IAAI,aAAa,MAAM,OAAO,eAAe,SAC3C,OAAO,OAAO,IAAI,YAAY;EAC5B,MAAM;EACN,SAAS,2BAA2B,aAAa,MAAM,GAAG,kBAAkB,eAAe,QAAQ,IAAI,eAAe,QAAQ;CAChI,CAAC;CAGH,MAAM,UAAU,WAAW,WAAW,aAAa;CAEnD,IAAI,YAAY,QACd,OAAO,OAAO,IAAI,YAAY;EAC5B,MAAM;EACN,SAAS;CACX,CAAC;CAGH,OAAO;EAAE;EAAc;CAAQ;AACjC,CAAC"}

package/dist/internal/sync-function.d.ts

@@ -0,0 +1,9 @@
+import { Effect } from "effect";
+//#region src/internal/sync-function.d.ts
+interface SyncFunction<Arguments extends ReadonlyArray<unknown>, Success, Failure> {
+  (...arguments_: Arguments): Success;
+  readonly effect: (...arguments_: Arguments) => Effect.Effect<Success, Failure>;
+}
+//#endregion
+export { SyncFunction };
+//# sourceMappingURL=sync-function.d.ts.map

package/dist/internal/sync-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-function.d.ts","names":[],"sources":["../../src/internal/sync-function.ts"],"mappings":";;UAEiB,aAAa,kBAAkB,wBAAwB,SAAS;MAC3E,YAAY,YAAY;WAEnB,YAAY,YAAY,cAAc,OAAO,OAAO,SAAS"}

package/dist/internal/sync-function.js

@@ -0,0 +1,20 @@
+import { Effect, Result } from "effect";
+
+//#region src/internal/sync-function.ts
+const defineSyncFunction = (implementation) => {
+	const synchronous = (...arguments_) => {
+		const result = Effect.runSync(Effect.result(implementation(...arguments_)));
+		if (Result.isFailure(result)) throw result.failure;
+		return result.success;
+	};
+	return Object.freeze(Object.defineProperty(synchronous, "effect", {
+		value: implementation,
+		enumerable: true,
+		configurable: false,
+		writable: false
+	}));
+};
+
+//#endregion
+export { defineSyncFunction };
+//# sourceMappingURL=sync-function.js.map

package/dist/internal/sync-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-function.js","names":[],"sources":["../../src/internal/sync-function.ts"],"sourcesContent":["import { Effect, Result } from \"effect\";\n\nexport interface SyncFunction<Arguments extends ReadonlyArray<unknown>, Success, Failure> {\n  (...arguments_: Arguments): Success;\n\n  readonly effect: (...arguments_: Arguments) => Effect.Effect<Success, Failure>;\n}\n\nexport const defineSyncFunction = <Arguments extends ReadonlyArray<unknown>, Success, Failure>(\n  implementation: (...arguments_: Arguments) => Effect.Effect<Success, Failure>,\n): SyncFunction<Arguments, Success, Failure> => {\n  const synchronous = (...arguments_: Arguments): Success => {\n    const result = Effect.runSync(Effect.result(implementation(...arguments_)));\n    if (Result.isFailure(result)) throw result.failure;\n    return result.success;\n  };\n\n  return Object.freeze(\n    Object.defineProperty(synchronous, \"effect\", {\n      value: implementation,\n      enumerable: true,\n      configurable: false,\n      writable: false,\n    }),\n  ) as SyncFunction<Arguments, Success, Failure>;\n};\n"],"mappings":";;;AAQA,MAAa,sBACX,mBAC8C;CAC9C,MAAM,eAAe,GAAG,eAAmC;EACzD,MAAM,SAAS,OAAO,QAAQ,OAAO,OAAO,eAAe,GAAG,UAAU,CAAC,CAAC;EAC1E,IAAI,OAAO,UAAU,MAAM,GAAG,MAAM,OAAO;EAC3C,OAAO,OAAO;CAChB;CAEA,OAAO,OAAO,OACZ,OAAO,eAAe,aAAa,UAAU;EAC3C,OAAO;EACP,YAAY;EACZ,cAAc;EACd,UAAU;CACZ,CAAC,CACH;AACF"}

package/dist/internal/write/confirm-native-batch.js

@@ -0,0 +1,52 @@
+import { TransactionError } from "../../errors/transaction-error.js";
+import { WriteClient } from "./write-client.js";
+import { Effect } from "effect";
+
+//#region src/internal/write/confirm-native-batch.ts
+const confirmNativeBatch = Effect.fn("confirmNativeBatch")(function* (config, walletClient, id, calls, capabilities, confirmation, submittedAtomic) {
+	if (confirmation.type === "submitted") return {
+		mode: "batch",
+		atomic: submittedAtomic,
+		status: "submitted",
+		id,
+		calls: calls.map((call) => ({
+			id: call.id,
+			operation: call.operation,
+			status: "submitted",
+			hash: null,
+			receipt: null
+		})),
+		receipts: [],
+		capabilities
+	};
+	const status = yield* (yield* WriteClient).waitForCallsStatus(walletClient, id, confirmation.timeout === void 0 ? {} : { timeout: confirmation.timeout }).pipe(Effect.retry({ times: config.writes.statusRetries }));
+	if (status.status !== "success") return yield* new TransactionError({
+		code: status.status === void 0 ? "INVALID_BATCH_STATUS" : "BATCH_STATUS_FAILED",
+		message: `Wallet call batch ${id} finished with status ${status.status ?? status.statusCode}`,
+		cause: status,
+		batchId: id
+	});
+	const receipts = status.receipts ?? [];
+	return {
+		mode: "batch",
+		atomic: status.atomic,
+		status: "confirmed",
+		id,
+		calls: calls.map((call, index) => {
+			const receipt = receipts[index] ?? (status.atomic ? receipts[0] : void 0);
+			return {
+				id: call.id,
+				operation: call.operation,
+				status: "confirmed",
+				hash: receipt?.transactionHash ?? null,
+				receipt: receipt ?? null
+			};
+		}),
+		receipts,
+		capabilities
+	};
+});
+
+//#endregion
+export { confirmNativeBatch };
+//# sourceMappingURL=confirm-native-batch.js.map

package/dist/internal/write/confirm-native-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-native-batch.js","names":[],"sources":["../../../src/internal/write/confirm-native-batch.ts"],"sourcesContent":["import { Effect } from \"effect\";\n\nimport type { WalletClient } from \"viem\";\n\nimport type { EnsforgeConfig } from \"../../config/config.js\";\nimport { TransactionError } from \"../../errors/transaction-error.js\";\nimport type {\n  ConfirmationPolicy,\n  NativeBatchResult,\n  WalletCapabilitiesResult,\n} from \"../../write/types.js\";\nimport { WriteClient } from \"./write-client.js\";\n\nexport const confirmNativeBatch: (\n  config: EnsforgeConfig,\n  walletClient: WalletClient,\n  id: string,\n  calls: ReadonlyArray<{ readonly id: string; readonly operation: string }>,\n  capabilities: WalletCapabilitiesResult,\n  confirmation: ConfirmationPolicy,\n  submittedAtomic: boolean,\n) => Effect.Effect<NativeBatchResult, TransactionError, WriteClient> = Effect.fn(\n  \"confirmNativeBatch\",\n)(function* (\n  config: EnsforgeConfig,\n  walletClient: WalletClient,\n  id: string,\n  calls: ReadonlyArray<{ readonly id: string; readonly operation: string }>,\n  capabilities: WalletCapabilitiesResult,\n  confirmation: ConfirmationPolicy,\n  submittedAtomic: boolean,\n): Effect.fn.Return<NativeBatchResult, TransactionError, WriteClient> {\n  if (confirmation.type === \"submitted\") {\n    return {\n      mode: \"batch\",\n      atomic: submittedAtomic,\n      status: \"submitted\",\n      id,\n      calls: calls.map((call) => ({\n        id: call.id,\n        operation: call.operation,\n        status: \"submitted\",\n        hash: null,\n        receipt: null,\n      })),\n      receipts: [],\n      capabilities,\n    } satisfies NativeBatchResult;\n  }\n\n  const client = yield* WriteClient;\n  const status = yield* client\n    .waitForCallsStatus(\n      walletClient,\n      id,\n      confirmation.timeout === undefined ? {} : { timeout: confirmation.timeout },\n    )\n    .pipe(Effect.retry({ times: config.writes.statusRetries }));\n  if (status.status !== \"success\") {\n    return yield* new TransactionError({\n      code: status.status === undefined ? \"INVALID_BATCH_STATUS\" : \"BATCH_STATUS_FAILED\",\n      message: `Wallet call batch ${id} finished with status ${status.status ?? status.statusCode}`,\n      cause: status,\n      batchId: id,\n    });\n  }\n  const receipts = status.receipts ?? [];\n  return {\n    mode: \"batch\",\n    atomic: status.atomic,\n    status: \"confirmed\",\n    id,\n    calls: calls.map((call, index) => {\n      const receipt = receipts[index] ?? (status.atomic ? receipts[0] : undefined);\n      return {\n        id: call.id,\n        operation: call.operation,\n        status: \"confirmed\",\n        hash: receipt?.transactionHash ?? null,\n        receipt: receipt ?? null,\n      };\n    }),\n    receipts,\n    capabilities,\n  } satisfies NativeBatchResult;\n});\n"],"mappings":";;;;;AAaA,MAAa,qBAQ0D,OAAO,GAC5E,oBACF,CAAC,CAAC,WACA,QACA,cACA,IACA,OACA,cACA,cACA,iBACoE;CACpE,IAAI,aAAa,SAAS,aACxB,OAAO;EACL,MAAM;EACN,QAAQ;EACR,QAAQ;EACR;EACA,OAAO,MAAM,KAAK,UAAU;GAC1B,IAAI,KAAK;GACT,WAAW,KAAK;GAChB,QAAQ;GACR,MAAM;GACN,SAAS;EACX,EAAE;EACF,UAAU,CAAC;EACX;CACF;CAIF,MAAM,SAAS,QAAO,OADA,YACM,CACzB,mBACC,cACA,IACA,aAAa,YAAY,SAAY,CAAC,IAAI,EAAE,SAAS,aAAa,QAAQ,CAC5E,CAAC,CACA,KAAK,OAAO,MAAM,EAAE,OAAO,OAAO,OAAO,cAAc,CAAC,CAAC;CAC5D,IAAI,OAAO,WAAW,WACpB,OAAO,OAAO,IAAI,iBAAiB;EACjC,MAAM,OAAO,WAAW,SAAY,yBAAyB;EAC7D,SAAS,qBAAqB,GAAG,wBAAwB,OAAO,UAAU,OAAO;EACjF,OAAO;EACP,SAAS;CACX,CAAC;CAEH,MAAM,WAAW,OAAO,YAAY,CAAC;CACrC,OAAO;EACL,MAAM;EACN,QAAQ,OAAO;EACf,QAAQ;EACR;EACA,OAAO,MAAM,KAAK,MAAM,UAAU;GAChC,MAAM,UAAU,SAAS,WAAW,OAAO,SAAS,SAAS,KAAK;GAClE,OAAO;IACL,IAAI,KAAK;IACT,WAAW,KAAK;IAChB,QAAQ;IACR,MAAM,SAAS,mBAAmB;IAClC,SAAS,WAAW;GACtB;EACF,CAAC;EACD;EACA;CACF;AACF,CAAC"}

package/dist/internal/write/execute-native-batch.js

@@ -0,0 +1,39 @@
+import { provideConfig } from "../config/context.js";
+import { resolveWalletContext } from "../services/wallet-client.js";
+import { prepareWriteIntents } from "./prepare-write-intents.js";
+import { WalletError } from "../../errors/wallet-error.js";
+import { WriteClient } from "./write-client.js";
+import { simulatePreparedCalls } from "./simulate-prepared-calls.js";
+import { confirmNativeBatch } from "./confirm-native-batch.js";
+import { Effect } from "effect";
+
+//#region src/internal/write/execute-native-batch.ts
+const executeNativeBatch = Effect.fn("executeNativeBatch")(function* (config, parameters, capabilities) {
+	if (!capabilities.nativeCalls) return yield* new WalletError({
+		code: "BATCH_UNSUPPORTED",
+		message: `The wallet does not advertise native calls on chain ${config.chainId}`,
+		cause: capabilities.raw
+	});
+	const atomicity = parameters.atomicity ?? "preferred";
+	if (atomicity === "required" && capabilities.atomicity !== "supported" && capabilities.atomicity !== "ready") return yield* new WalletError({
+		code: "ATOMICITY_UNAVAILABLE",
+		message: `The wallet cannot guarantee atomic calls on chain ${config.chainId}`,
+		cause: capabilities.raw
+	});
+	const calls = yield* prepareWriteIntents(config, parameters);
+	if ((parameters.simulation ?? config.writes.simulation) === "required") yield* provideConfig(config, simulatePreparedCalls(calls, config.reads.concurrency));
+	const { walletClient, account } = yield* provideConfig(config, resolveWalletContext(parameters));
+	const client = yield* provideConfig(config, WriteClient);
+	const forceAtomic = atomicity === "required" || atomicity === "preferred" && capabilities.atomicity === "supported";
+	const sendOptions = parameters.capabilities === void 0 ? { forceAtomic } : {
+		forceAtomic,
+		capabilities: parameters.capabilities
+	};
+	const submission = yield* client.sendCalls(walletClient, account, calls, sendOptions);
+	const confirmation = parameters.confirmation ?? config.writes.confirmation;
+	return yield* confirmNativeBatch(config, walletClient, submission.id, calls, capabilities, confirmation, forceAtomic).pipe(Effect.provideService(WriteClient, client));
+});
+
+//#endregion
+export { executeNativeBatch };
+//# sourceMappingURL=execute-native-batch.js.map

package/dist/internal/write/execute-native-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-native-batch.js","names":[],"sources":["../../../src/internal/write/execute-native-batch.ts"],"sourcesContent":["import { Effect } from \"effect\";\n\nimport type { EnsforgeConfig } from \"../../config/config.js\";\nimport { WalletError } from \"../../errors/wallet-error.js\";\nimport type {\n  ConfirmationPolicy,\n  NativeBatchResult,\n  SendCallsParameters,\n  WalletCapabilitiesResult,\n  WriteError,\n} from \"../../write/types.js\";\nimport { provideConfig } from \"../config/context.js\";\nimport { resolveWalletContext } from \"../services/wallet-client.js\";\nimport { confirmNativeBatch } from \"./confirm-native-batch.js\";\nimport { prepareWriteIntents } from \"./prepare-write-intents.js\";\nimport { simulatePreparedCalls } from \"./simulate-prepared-calls.js\";\nimport { WriteClient } from \"./write-client.js\";\n\nexport const executeNativeBatch = Effect.fn(\"executeNativeBatch\")(function* (\n  config: EnsforgeConfig,\n  parameters: SendCallsParameters,\n  capabilities: WalletCapabilitiesResult,\n): Effect.fn.Return<NativeBatchResult, WriteError> {\n  if (!capabilities.nativeCalls) {\n    return yield* new WalletError({\n      code: \"BATCH_UNSUPPORTED\",\n      message: `The wallet does not advertise native calls on chain ${config.chainId}`,\n      cause: capabilities.raw,\n    });\n  }\n\n  const atomicity = parameters.atomicity ?? \"preferred\";\n  if (\n    atomicity === \"required\" &&\n    capabilities.atomicity !== \"supported\" &&\n    capabilities.atomicity !== \"ready\"\n  ) {\n    return yield* new WalletError({\n      code: \"ATOMICITY_UNAVAILABLE\",\n      message: `The wallet cannot guarantee atomic calls on chain ${config.chainId}`,\n      cause: capabilities.raw,\n    });\n  }\n\n  const calls = yield* prepareWriteIntents(config, parameters);\n  if ((parameters.simulation ?? config.writes.simulation) === \"required\") {\n    yield* provideConfig(config, simulatePreparedCalls(calls, config.reads.concurrency));\n  }\n  const { walletClient, account } = yield* provideConfig(config, resolveWalletContext(parameters));\n  const client = yield* provideConfig(config, WriteClient);\n  const forceAtomic =\n    atomicity === \"required\" ||\n    (atomicity === \"preferred\" && capabilities.atomicity === \"supported\");\n  const sendOptions =\n    parameters.capabilities === undefined\n      ? { forceAtomic }\n      : { forceAtomic, capabilities: parameters.capabilities };\n  const submission = yield* client.sendCalls(walletClient, account, calls, sendOptions);\n  const confirmation: ConfirmationPolicy = parameters.confirmation ?? config.writes.confirmation;\n\n  return yield* confirmNativeBatch(\n    config,\n    walletClient,\n    submission.id,\n    calls,\n    capabilities,\n    confirmation,\n    forceAtomic,\n  ).pipe(Effect.provideService(WriteClient, client));\n});\n"],"mappings":";;;;;;;;;;AAkBA,MAAa,qBAAqB,OAAO,GAAG,oBAAoB,CAAC,CAAC,WAChE,QACA,YACA,cACiD;CACjD,IAAI,CAAC,aAAa,aAChB,OAAO,OAAO,IAAI,YAAY;EAC5B,MAAM;EACN,SAAS,uDAAuD,OAAO;EACvE,OAAO,aAAa;CACtB,CAAC;CAGH,MAAM,YAAY,WAAW,aAAa;CAC1C,IACE,cAAc,cACd,aAAa,cAAc,eAC3B,aAAa,cAAc,SAE3B,OAAO,OAAO,IAAI,YAAY;EAC5B,MAAM;EACN,SAAS,qDAAqD,OAAO;EACrE,OAAO,aAAa;CACtB,CAAC;CAGH,MAAM,QAAQ,OAAO,oBAAoB,QAAQ,UAAU;CAC3D,KAAK,WAAW,cAAc,OAAO,OAAO,gBAAgB,YAC1D,OAAO,cAAc,QAAQ,sBAAsB,OAAO,OAAO,MAAM,WAAW,CAAC;CAErF,MAAM,EAAE,cAAc,YAAY,OAAO,cAAc,QAAQ,qBAAqB,UAAU,CAAC;CAC/F,MAAM,SAAS,OAAO,cAAc,QAAQ,WAAW;CACvD,MAAM,cACJ,cAAc,cACb,cAAc,eAAe,aAAa,cAAc;CAC3D,MAAM,cACJ,WAAW,iBAAiB,SACxB,EAAE,YAAY,IACd;EAAE;EAAa,cAAc,WAAW;CAAa;CAC3D,MAAM,aAAa,OAAO,OAAO,UAAU,cAAc,SAAS,OAAO,WAAW;CACpF,MAAM,eAAmC,WAAW,gBAAgB,OAAO,OAAO;CAElF,OAAO,OAAO,mBACZ,QACA,cACA,WAAW,IACX,OACA,cACA,cACA,WACF,CAAC,CAAC,KAAK,OAAO,eAAe,aAAa,MAAM,CAAC;AACnD,CAAC"}

package/dist/internal/write/execute-sequential.js

@@ -0,0 +1,88 @@
+import { provideConfig } from "../config/context.js";
+import { RpcError } from "../../errors/rpc-error.js";
+import { WritePlanError } from "../../errors/write-plan-error.js";
+import { resolveWalletContext } from "../services/wallet-client.js";
+import { redactSensitiveWriteError } from "./redact-sensitive-error.js";
+import { prepareWriteIntents } from "./prepare-write-intents.js";
+import { WriteClient } from "./write-client.js";
+import { simulatePreparedCalls } from "./simulate-prepared-calls.js";
+import { Effect, Result } from "effect";
+
+//#region src/internal/write/execute-sequential.ts
+const notStarted = (id, operation) => ({
+	id,
+	operation,
+	status: "not-started",
+	hash: null,
+	receipt: null
+});
+const executeSequential = Effect.fn("executeSequential")(function* (config, parameters, startIndex = 0) {
+	const confirmation = parameters.confirmation ?? config.writes.confirmation;
+	const simulation = parameters.simulation ?? config.writes.simulation;
+	const completed = [];
+	for (const [localIndex, intent] of parameters.calls.entries()) {
+		const index = startIndex + localIndex;
+		const execution = yield* Effect.result(Effect.gen(function* () {
+			const singleCallParameters = {
+				calls: [intent],
+				...parameters.walletClient === void 0 ? {} : { walletClient: parameters.walletClient },
+				...parameters.account === void 0 ? {} : { account: parameters.account }
+			};
+			const call = (yield* prepareWriteIntents(config, singleCallParameters, "call", index))[0];
+			if (call === void 0) return yield* new WritePlanError({
+				code: "INVALID_CALL_PLAN",
+				message: "A single write intent did not produce a prepared call",
+				cause: intent
+			});
+			if (simulation === "required") yield* provideConfig(config, simulatePreparedCalls([call], 1));
+			const { walletClient } = yield* provideConfig(config, resolveWalletContext(parameters));
+			const client = yield* provideConfig(config, WriteClient);
+			const hash = yield* client.sendTransaction(walletClient, call);
+			if (confirmation.type === "submitted") return {
+				id: call.id,
+				operation: call.operation,
+				status: "submitted",
+				hash,
+				receipt: null
+			};
+			const receipt = yield* client.waitForReceipt(hash, {
+				...confirmation.confirmations === void 0 ? {} : { confirmations: confirmation.confirmations },
+				...confirmation.timeout === void 0 ? {} : { timeout: confirmation.timeout }
+			}).pipe(Effect.retry({
+				times: config.writes.statusRetries,
+				while: (error) => error instanceof RpcError
+			}));
+			return {
+				id: call.id,
+				operation: call.operation,
+				status: "confirmed",
+				hash,
+				receipt
+			};
+		}).pipe(Effect.mapError((error) => redactSensitiveWriteError([intent], error))));
+		if (Result.isFailure(execution)) {
+			const failure = execution.failure;
+			if (completed.length === 0) return yield* failure;
+			const remaining = parameters.calls.slice(localIndex).map((remainingIntent, offset) => notStarted(`call-${index + offset}`, remainingIntent.operation));
+			return {
+				mode: "sequential",
+				atomic: false,
+				status: "partial",
+				calls: [...completed, ...remaining],
+				failure
+			};
+		}
+		completed.push(execution.success);
+	}
+	return {
+		mode: "sequential",
+		atomic: false,
+		status: "completed",
+		calls: completed,
+		failure: null
+	};
+});
+
+//#endregion
+export { executeSequential };
+//# sourceMappingURL=execute-sequential.js.map

package/dist/internal/write/execute-sequential.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-sequential.js","names":[],"sources":["../../../src/internal/write/execute-sequential.ts"],"sourcesContent":["import { Effect, Result } from \"effect\";\n\nimport type { EnsforgeConfig } from \"../../config/config.js\";\nimport { RpcError } from \"../../errors/rpc-error.js\";\nimport { WritePlanError } from \"../../errors/write-plan-error.js\";\nimport type {\n  CallExecutionResult,\n  ConfirmationPolicy,\n  SendCallsParameters,\n  SequentialCallsResult,\n  WriteError,\n} from \"../../write/types.js\";\nimport { provideConfig } from \"../config/context.js\";\nimport { resolveWalletContext } from \"../services/wallet-client.js\";\nimport { prepareWriteIntents } from \"./prepare-write-intents.js\";\nimport { redactSensitiveWriteError } from \"./redact-sensitive-error.js\";\nimport { simulatePreparedCalls } from \"./simulate-prepared-calls.js\";\nimport { WriteClient } from \"./write-client.js\";\n\nconst notStarted = (id: string, operation: string): CallExecutionResult => ({\n  id,\n  operation,\n  status: \"not-started\",\n  hash: null,\n  receipt: null,\n});\n\nexport const executeSequential = Effect.fn(\"executeSequential\")(function* (\n  config: EnsforgeConfig,\n  parameters: SendCallsParameters,\n  startIndex = 0,\n): Effect.fn.Return<SequentialCallsResult, WriteError> {\n  const confirmation: ConfirmationPolicy = parameters.confirmation ?? config.writes.confirmation;\n  const simulation = parameters.simulation ?? config.writes.simulation;\n  const completed: Array<CallExecutionResult> = [];\n\n  for (const [localIndex, intent] of parameters.calls.entries()) {\n    const index = startIndex + localIndex;\n    const execution = yield* Effect.result(\n      Effect.gen(function* () {\n        const singleCallParameters = {\n          calls: [intent],\n          ...(parameters.walletClient === undefined\n            ? {}\n            : { walletClient: parameters.walletClient }),\n          ...(parameters.account === undefined ? {} : { account: parameters.account }),\n        };\n        const prepared = yield* prepareWriteIntents(config, singleCallParameters, \"call\", index);\n        const call = prepared[0];\n        if (call === undefined) {\n          return yield* new WritePlanError({\n            code: \"INVALID_CALL_PLAN\",\n            message: \"A single write intent did not produce a prepared call\",\n            cause: intent,\n          });\n        }\n        if (simulation === \"required\") {\n          yield* provideConfig(config, simulatePreparedCalls([call], 1));\n        }\n        const { walletClient } = yield* provideConfig(config, resolveWalletContext(parameters));\n        const client = yield* provideConfig(config, WriteClient);\n        const hash = yield* client.sendTransaction(walletClient, call);\n        if (confirmation.type === \"submitted\") {\n          return {\n            id: call.id,\n            operation: call.operation,\n            status: \"submitted\",\n            hash,\n            receipt: null,\n          } satisfies CallExecutionResult;\n        }\n        const receipt = yield* client\n          .waitForReceipt(hash, {\n            ...(confirmation.confirmations === undefined\n              ? {}\n              : { confirmations: confirmation.confirmations }),\n            ...(confirmation.timeout === undefined ? {} : { timeout: confirmation.timeout }),\n          })\n          .pipe(\n            Effect.retry({\n              times: config.writes.statusRetries,\n              while: (error) => error instanceof RpcError,\n            }),\n          );\n        return {\n          id: call.id,\n          operation: call.operation,\n          status: \"confirmed\",\n          hash,\n          receipt,\n        } satisfies CallExecutionResult;\n      }).pipe(Effect.mapError((error) => redactSensitiveWriteError([intent], error))),\n    );\n\n    if (Result.isFailure(execution)) {\n      const failure = execution.failure;\n      if (completed.length === 0) return yield* failure;\n      const remaining = parameters.calls\n        .slice(localIndex)\n        .map((remainingIntent, offset) =>\n          notStarted(`call-${index + offset}`, remainingIntent.operation),\n        );\n      return {\n        mode: \"sequential\",\n        atomic: false,\n        status: \"partial\",\n        calls: [...completed, ...remaining],\n        failure,\n      };\n    }\n    completed.push(execution.success);\n  }\n\n  return {\n    mode: \"sequential\",\n    atomic: false,\n    status: \"completed\",\n    calls: completed,\n    failure: null,\n  };\n});\n"],"mappings":";;;;;;;;;;;AAmBA,MAAM,cAAc,IAAY,eAA4C;CAC1E;CACA;CACA,QAAQ;CACR,MAAM;CACN,SAAS;AACX;AAEA,MAAa,oBAAoB,OAAO,GAAG,mBAAmB,CAAC,CAAC,WAC9D,QACA,YACA,aAAa,GACwC;CACrD,MAAM,eAAmC,WAAW,gBAAgB,OAAO,OAAO;CAClF,MAAM,aAAa,WAAW,cAAc,OAAO,OAAO;CAC1D,MAAM,YAAwC,CAAC;CAE/C,KAAK,MAAM,CAAC,YAAY,WAAW,WAAW,MAAM,QAAQ,GAAG;EAC7D,MAAM,QAAQ,aAAa;EAC3B,MAAM,YAAY,OAAO,OAAO,OAC9B,OAAO,IAAI,aAAa;GACtB,MAAM,uBAAuB;IAC3B,OAAO,CAAC,MAAM;IACd,GAAI,WAAW,iBAAiB,SAC5B,CAAC,IACD,EAAE,cAAc,WAAW,aAAa;IAC5C,GAAI,WAAW,YAAY,SAAY,CAAC,IAAI,EAAE,SAAS,WAAW,QAAQ;GAC5E;GAEA,MAAM,QAAO,OADW,oBAAoB,QAAQ,sBAAsB,QAAQ,KAAK,EAClE,CAAC;GACtB,IAAI,SAAS,QACX,OAAO,OAAO,IAAI,eAAe;IAC/B,MAAM;IACN,SAAS;IACT,OAAO;GACT,CAAC;GAEH,IAAI,eAAe,YACjB,OAAO,cAAc,QAAQ,sBAAsB,CAAC,IAAI,GAAG,CAAC,CAAC;GAE/D,MAAM,EAAE,iBAAiB,OAAO,cAAc,QAAQ,qBAAqB,UAAU,CAAC;GACtF,MAAM,SAAS,OAAO,cAAc,QAAQ,WAAW;GACvD,MAAM,OAAO,OAAO,OAAO,gBAAgB,cAAc,IAAI;GAC7D,IAAI,aAAa,SAAS,aACxB,OAAO;IACL,IAAI,KAAK;IACT,WAAW,KAAK;IAChB,QAAQ;IACR;IACA,SAAS;GACX;GAEF,MAAM,UAAU,OAAO,OACpB,eAAe,MAAM;IACpB,GAAI,aAAa,kBAAkB,SAC/B,CAAC,IACD,EAAE,eAAe,aAAa,cAAc;IAChD,GAAI,aAAa,YAAY,SAAY,CAAC,IAAI,EAAE,SAAS,aAAa,QAAQ;GAChF,CAAC,CAAC,CACD,KACC,OAAO,MAAM;IACX,OAAO,OAAO,OAAO;IACrB,QAAQ,UAAU,iBAAiB;GACrC,CAAC,CACH;GACF,OAAO;IACL,IAAI,KAAK;IACT,WAAW,KAAK;IAChB,QAAQ;IACR;IACA;GACF;EACF,CAAC,CAAC,CAAC,KAAK,OAAO,UAAU,UAAU,0BAA0B,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAChF;EAEA,IAAI,OAAO,UAAU,SAAS,GAAG;GAC/B,MAAM,UAAU,UAAU;GAC1B,IAAI,UAAU,WAAW,GAAG,OAAO,OAAO;GAC1C,MAAM,YAAY,WAAW,MAC1B,MAAM,UAAU,CAAC,CACjB,KAAK,iBAAiB,WACrB,WAAW,QAAQ,QAAQ,UAAU,gBAAgB,SAAS,CAChE;GACF,OAAO;IACL,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,OAAO,CAAC,GAAG,WAAW,GAAG,SAAS;IAClC;GACF;EACF;EACA,UAAU,KAAK,UAAU,OAAO;CAClC;CAEA,OAAO;EACL,MAAM;EACN,QAAQ;EACR,QAAQ;EACR,OAAO;EACP,SAAS;CACX;AACF,CAAC"}

package/dist/internal/write/prepare-resolver-write.js

@@ -0,0 +1,50 @@
+import { WritePlanError } from "../../errors/write-plan-error.js";
+import { normalizeName } from "../../names/normalize.js";
+import { getRecordPermissions } from "../../actions/capabilities/get-record-permissions/index.js";
+import { getWriteTarget } from "../../actions/capabilities/get-write-target/index.js";
+import { AuthorizationError } from "../../errors/authorization-error.js";
+import { Effect } from "effect";
+
+//#region src/internal/write/prepare-resolver-write.ts
+const prepareResolverWrite = Effect.fn("prepareResolverWrite")(function* (config, parameters) {
+	const name = yield* normalizeName.effect(parameters.name);
+	const operation = parameters.records[0];
+	if (operation === void 0) return yield* new WritePlanError({
+		code: "INVALID_CALL_PLAN",
+		message: "A resolver write must contain at least one record mutation",
+		cause: parameters.records
+	});
+	const account = typeof parameters.account === "string" ? parameters.account : parameters.account.address;
+	const target = yield* getWriteTarget.effect(config, {
+		name,
+		operation
+	});
+	if (!target.available || target.kind !== "resolver") return yield* new AuthorizationError({
+		code: "WRITE_TARGET_UNAVAILABLE",
+		message: `No writable resolver is available for ${name}`
+	});
+	const permissions = yield* getRecordPermissions.effect(config, {
+		name,
+		account,
+		records: parameters.records
+	});
+	const unsupported = permissions.records.find((permission) => !permission.supported);
+	if (unsupported !== void 0) return yield* new AuthorizationError({
+		code: "RECORD_UNSUPPORTED",
+		message: `The resolver for ${name} does not support ${unsupported.record.type} records`
+	});
+	const unauthorized = permissions.records.find((permission) => permission.authorization.status === "unauthorized");
+	if (unauthorized !== void 0) return yield* new AuthorizationError({
+		code: "UNAUTHORIZED",
+		message: `${account} is not authorized to set ${unauthorized.record.type} records for ${name}`
+	});
+	return {
+		name,
+		account,
+		target
+	};
+});
+
+//#endregion
+export { prepareResolverWrite };
+//# sourceMappingURL=prepare-resolver-write.js.map

package/dist/internal/write/prepare-resolver-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-resolver-write.js","names":[],"sources":["../../../src/internal/write/prepare-resolver-write.ts"],"sourcesContent":["import { Effect } from \"effect\";\n\nimport type { Account, Address } from \"viem\";\n\nimport { getRecordPermissions } from \"../../actions/capabilities/get-record-permissions/index.js\";\nimport { getWriteTarget } from \"../../actions/capabilities/get-write-target/index.js\";\nimport type { RecordOperation } from \"../../actions/capabilities/types.js\";\nimport type { EnsforgeConfig } from \"../../config/config.js\";\nimport { AuthorizationError } from \"../../errors/authorization-error.js\";\nimport { WritePlanError } from \"../../errors/write-plan-error.js\";\nimport { normalizeName } from \"../../names/normalize.js\";\nimport type { EthereumAddress } from \"../../schemas/identity.js\";\n\nexport const prepareResolverWrite = Effect.fn(\"prepareResolverWrite\")(function* (\n  config: EnsforgeConfig,\n  parameters: {\n    readonly name: string;\n    readonly records: ReadonlyArray<RecordOperation>;\n    readonly account: Account | Address;\n  },\n) {\n  const name = yield* normalizeName.effect(parameters.name);\n  const operation = parameters.records[0];\n  if (operation === undefined) {\n    return yield* new WritePlanError({\n      code: \"INVALID_CALL_PLAN\",\n      message: \"A resolver write must contain at least one record mutation\",\n      cause: parameters.records,\n    });\n  }\n\n  const account = (\n    typeof parameters.account === \"string\" ? parameters.account : parameters.account.address\n  ) as EthereumAddress;\n  const target = yield* getWriteTarget.effect(config, { name, operation });\n  if (!target.available || target.kind !== \"resolver\") {\n    return yield* new AuthorizationError({\n      code: \"WRITE_TARGET_UNAVAILABLE\",\n      message: `No writable resolver is available for ${name}`,\n    });\n  }\n\n  const permissions = yield* getRecordPermissions.effect(config, {\n    name,\n    account,\n    records: parameters.records,\n  });\n  const unsupported = permissions.records.find((permission) => !permission.supported);\n  if (unsupported !== undefined) {\n    return yield* new AuthorizationError({\n      code: \"RECORD_UNSUPPORTED\",\n      message: `The resolver for ${name} does not support ${unsupported.record.type} records`,\n    });\n  }\n\n  const unauthorized = permissions.records.find(\n    (permission) => permission.authorization.status === \"unauthorized\",\n  );\n  if (unauthorized !== undefined) {\n    return yield* new AuthorizationError({\n      code: \"UNAUTHORIZED\",\n      message: `${account} is not authorized to set ${unauthorized.record.type} records for ${name}`,\n    });\n  }\n\n  return { name, account, target } as const;\n});\n"],"mappings":";;;;;;;;AAaA,MAAa,uBAAuB,OAAO,GAAG,sBAAsB,CAAC,CAAC,WACpE,QACA,YAKA;CACA,MAAM,OAAO,OAAO,cAAc,OAAO,WAAW,IAAI;CACxD,MAAM,YAAY,WAAW,QAAQ;CACrC,IAAI,cAAc,QAChB,OAAO,OAAO,IAAI,eAAe;EAC/B,MAAM;EACN,SAAS;EACT,OAAO,WAAW;CACpB,CAAC;CAGH,MAAM,UACJ,OAAO,WAAW,YAAY,WAAW,WAAW,UAAU,WAAW,QAAQ;CAEnF,MAAM,SAAS,OAAO,eAAe,OAAO,QAAQ;EAAE;EAAM;CAAU,CAAC;CACvE,IAAI,CAAC,OAAO,aAAa,OAAO,SAAS,YACvC,OAAO,OAAO,IAAI,mBAAmB;EACnC,MAAM;EACN,SAAS,yCAAyC;CACpD,CAAC;CAGH,MAAM,cAAc,OAAO,qBAAqB,OAAO,QAAQ;EAC7D;EACA;EACA,SAAS,WAAW;CACtB,CAAC;CACD,MAAM,cAAc,YAAY,QAAQ,MAAM,eAAe,CAAC,WAAW,SAAS;CAClF,IAAI,gBAAgB,QAClB,OAAO,OAAO,IAAI,mBAAmB;EACnC,MAAM;EACN,SAAS,oBAAoB,KAAK,oBAAoB,YAAY,OAAO,KAAK;CAChF,CAAC;CAGH,MAAM,eAAe,YAAY,QAAQ,MACtC,eAAe,WAAW,cAAc,WAAW,cACtD;CACA,IAAI,iBAAiB,QACnB,OAAO,OAAO,IAAI,mBAAmB;EACnC,MAAM;EACN,SAAS,GAAG,QAAQ,4BAA4B,aAAa,OAAO,KAAK,eAAe;CAC1F,CAAC;CAGH,OAAO;EAAE;EAAM;EAAS;CAAO;AACjC,CAAC"}

package/dist/internal/write/prepare-write-intents.js

@@ -0,0 +1,49 @@
+import { getWriteIntentPreparer } from "../../action/write-intent.js";
+import { executeRead } from "../read/execute-read.js";
+import { WritePlanError } from "../../errors/write-plan-error.js";
+import { resolveWalletContext } from "../services/wallet-client.js";
+import { redactSensitiveWriteError } from "./redact-sensitive-error.js";
+import { Effect } from "effect";
+
+//#region src/internal/write/prepare-write-intents.ts
+const prepareWriteIntents = Effect.fn("prepareWriteIntents")(function* (config, parameters, idPrefix = "call", startIndex = 0) {
+	if (parameters.calls.length === 0) return yield* new WritePlanError({
+		code: "INVALID_CALL_PLAN",
+		message: "A write call plan must contain at least one call",
+		cause: parameters.calls
+	});
+	return yield* executeRead(config, { consistency: "snapshot" }, Effect.gen(function* () {
+		const { walletClient, account } = yield* resolveWalletContext(parameters);
+		return yield* Effect.forEach(parameters.calls, (intent, localIndex) => {
+			const index = startIndex + localIndex;
+			const preparer = getWriteIntentPreparer(intent);
+			if (preparer === void 0) return new WritePlanError({
+				code: "INTENT_NOT_PREPARABLE",
+				message: `Write operation ${intent.operation} does not provide a call preparer`,
+				cause: intent
+			});
+			const id = `${idPrefix}-${index}`;
+			return preparer(config, intent.parameters, {
+				id,
+				index,
+				account,
+				chainId: config.chainId,
+				walletClient
+			}).pipe(Effect.mapError((error) => redactSensitiveWriteError([intent], error)), Effect.map((details) => {
+				const call = {
+					id,
+					operation: intent.operation,
+					account,
+					chainId: config.chainId,
+					to: details.to,
+					value: details.value
+				};
+				return Object.assign(call, details.data === void 0 ? {} : { data: details.data }, details.protocol === void 0 ? {} : { protocol: details.protocol });
+			}));
+		});
+	}));
+});
+
+//#endregion
+export { prepareWriteIntents };
+//# sourceMappingURL=prepare-write-intents.js.map