@fhevm/sdk 1.0.0-alpha.1 → 1.0.0-alpha.3

package/ethers/internal/ethers-p.ts

@@ -1,12 +1,10 @@
 import type { ethers as EthersT } from 'ethers';
 import type { TrustedClient } from '../../core/modules/ethereum/types.js';
-import type { FhevmRuntime, FhevmRuntimeConfig } from '../../core/types/coreFhevmRuntime.js';
+import type { FhevmRuntime } from '../../core/types/coreFhevmRuntime.js';
 import type { CreateFhevmRuntimeParameters } from '../../core/runtime/CoreFhevmRuntime-p.js';
 import { createFhevmRuntime as createFhevmRuntime_ } from '../../core/runtime/CoreFhevmRuntime-p.js';
 import { verifyTrustedValue } from '../../core/base/trustedValue.js';
 import { createTrustedClient } from '../../core/modules/ethereum/createTrustedClient.js';
-import { ethereumModule } from './ethereum.js';
-import { relayerModule } from '../../core/modules/relayer/module/index.js';
 
 ////////////////////////////////////////////////////////////////////////////////
 
@@ -15,59 +13,6 @@ export const PRIVATE_ETHERS_TOKEN = Symbol('ethers.token');
 
 ////////////////////////////////////////////////////////////////////////////////
 
-let ethersFhevmRuntime: FhevmRuntime | undefined;
-let ethersFhevmRuntimeConfig: FhevmRuntimeConfig | undefined;
-
-////////////////////////////////////////////////////////////////////////////////
-
-/**
- * Sets the global {@link FhevmRuntimeConfig} used by the ethers adapter.
- *
- * Must be called before any runtime or client is created.
- * May be called multiple times with identical parameters (idempotent).
- * Throws if called again with different parameters.
- *
- * @param config - The runtime configuration.
- * @throws If a different config has already been set.
- */
-export function setFhevmRuntimeConfig(config: FhevmRuntimeConfig): void {
-  if (ethersFhevmRuntimeConfig === undefined) {
-    ethersFhevmRuntimeConfig = { ...config };
-    return;
-  }
-  if (
-    ethersFhevmRuntimeConfig.logger !== config.logger ||
-    ethersFhevmRuntimeConfig.locateFile !== config.locateFile ||
-    ethersFhevmRuntimeConfig.singleThread !== config.singleThread ||
-    ethersFhevmRuntimeConfig.numberOfThreads !== config.numberOfThreads
-  ) {
-    throw new Error(
-      'FhevmRuntime config has already been set and cannot be changed. ' +
-        'Ensure setFhevmRuntimeConfig is called only once, or with identical parameters.',
-    );
-  }
-}
-
-////////////////////////////////////////////////////////////////////////////////
-
-export function getEthersRuntime(): FhevmRuntime {
-  if (ethersFhevmRuntimeConfig === undefined) {
-    throw new Error('Call setFhevmRuntimeConfig first.');
-  }
-
-  const em = ethereumModule();
-  const rm = relayerModule();
-
-  ethersFhevmRuntime ??= createFhevmRuntime({
-    ethereum: em.ethereum,
-    relayer: rm.relayer,
-    config: ethersFhevmRuntimeConfig,
-  });
-  return ethersFhevmRuntime;
-}
-
-////////////////////////////////////////////////////////////////////////////////
-
 /**
  * Seals an ethers `ContractRunner` into an opaque {@link TrustedClient}.
  *

package/ethers/internal/runtime-ct.ts

@@ -0,0 +1,28 @@
+import type { FhevmRuntime } from '../../core/types/coreFhevmRuntime.js';
+import { getFhevmRuntimeConfig, hasFhevmRuntimeConfig } from './config.js';
+import { cleartextEthereumModule } from './ethereum-ct.js';
+import { relayerModule as cleartextRelayerModule } from '../../core/modules/relayer/cleartext/mock.js';
+import { createFhevmRuntime } from './ethers-p.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+let ethersFhevmRuntime: FhevmRuntime | undefined;
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function getCleartextEthersRuntime(): FhevmRuntime {
+  if (!hasFhevmRuntimeConfig()) {
+    throw new Error('Call setFhevmRuntimeConfig first.');
+  }
+
+  const em = cleartextEthereumModule();
+  const rm = cleartextRelayerModule();
+
+  ethersFhevmRuntime ??= createFhevmRuntime({
+    ethereum: em.ethereum,
+    relayer: rm.relayer,
+    config: getFhevmRuntimeConfig(),
+  });
+
+  return ethersFhevmRuntime;
+}

package/ethers/internal/runtime.ts

@@ -0,0 +1,28 @@
+import type { FhevmRuntime } from '../../core/types/coreFhevmRuntime.js';
+import { getFhevmRuntimeConfig, hasFhevmRuntimeConfig } from './config.js';
+import { ethereumModule } from './ethereum.js';
+import { relayerModule } from '../../core/modules/relayer/module/index.js';
+import { createFhevmRuntime } from './ethers-p.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+let viemFhevmRuntime: FhevmRuntime | undefined;
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function getEthersRuntime(): FhevmRuntime {
+  if (!hasFhevmRuntimeConfig()) {
+    throw new Error('Call setFhevmRuntimeConfig first.');
+  }
+
+  const em = ethereumModule();
+  const rm = relayerModule();
+
+  viemFhevmRuntime ??= createFhevmRuntime({
+    ethereum: em.ethereum,
+    relayer: rm.relayer,
+    config: getFhevmRuntimeConfig(),
+  });
+
+  return viemFhevmRuntime;
+}

package/ethers/runtime/initFhevmDecryptRuntime.ts

@@ -1,5 +1,6 @@
-import { getEthersRuntime, PRIVATE_ETHERS_TOKEN } from '../internal/ethers-p.js';
 import { initFhevmDecryptRuntime as initFhevmDecyptRuntime_ } from '../../core/runtime/initFhevmDecryptRuntime-p.js';
+import { PRIVATE_ETHERS_TOKEN } from '../internal/ethers-p.js';
+import { getEthersRuntime } from '../internal/runtime.js';
 
 ////////////////////////////////////////////////////////////////////////////////
 

package/ethers/runtime/initFhevmEncryptRuntime.ts

@@ -1,5 +1,6 @@
-import { getEthersRuntime, PRIVATE_ETHERS_TOKEN } from '../internal/ethers-p.js';
 import { initFhevmEncryptRuntime as initFhevmEncryptRuntime_ } from '../../core/runtime/initFhevmEncryptRuntime-p.js';
+import { PRIVATE_ETHERS_TOKEN } from '../internal/ethers-p.js';
+import { getEthersRuntime } from '../internal/runtime.js';
 
 ////////////////////////////////////////////////////////////////////////////////
 

package/ethers/runtime/initFhevmRuntime.ts

@@ -1,5 +1,6 @@
-import { getEthersRuntime, PRIVATE_ETHERS_TOKEN } from '../internal/ethers-p.js';
 import { initFhevmRuntime as initFhevmRuntime_ } from '../../core/runtime/initFhevmRuntime-p.js';
+import { PRIVATE_ETHERS_TOKEN } from '../internal/ethers-p.js';
+import { getEthersRuntime } from '../internal/runtime.js';
 
 ////////////////////////////////////////////////////////////////////////////////
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@fhevm/sdk",
   "description": "TypeScript Interface for FHEVM",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.3",
   "type": "module",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
@@ -11,6 +11,7 @@
   "files": [
     "*",
     "!**/*.test.ts",
+    "!**/*.template",
     "!**/*.tsbuildinfo",
     "!tsconfig.build.json"
   ],
@@ -35,6 +36,11 @@
       "import": "./_esm/ethers/index.js",
       "default": "./_cjs/ethers/index.js"
     },
+    "./ethers/cleartext": {
+      "types": "./_types/ethers/cleartext/index.d.ts",
+      "import": "./_esm/ethers/cleartext/index.js",
+      "default": "./_cjs/ethers/cleartext/index.js"
+    },
     "./types": {
       "types": "./_types/core/types/index.d.ts",
       "import": "./_esm/core/types/index.js",
@@ -45,6 +51,11 @@
       "import": "./_esm/viem/index.js",
       "default": "./_cjs/viem/index.js"
     },
+    "./viem/cleartext": {
+      "types": "./_types/viem/cleartext/index.d.ts",
+      "import": "./_esm/viem/cleartext/index.js",
+      "default": "./_cjs/viem/cleartext/index.js"
+    },
     "./actions/base": {
       "types": "./_types/core/actions/base/index.d.ts",
       "import": "./_esm/core/actions/base/index.js",
@@ -73,7 +84,7 @@
     "./package.json": "./package.json"
   },
   "peerDependencies": {
-    "ethers": ">=6",
+    "ethers": ">=6.8.0",
     "typescript": ">=5.0.4",
     "viem": ">=2"
   },
@@ -90,6 +101,7 @@
   },
   "dependencies": {
     "@noble/hashes": "2.0.1",
+    "@noble/curves": "2.0.1",
     "wasm-feature-detect": "^1.8.0"
   },
   "repository": {

package/viem/cleartext/createFhevmCleartextBaseClient.ts

@@ -0,0 +1,28 @@
+import type { PublicClient } from 'viem';
+import type { FhevmChain } from '../../core/types/fhevmChain.js';
+import type { FhevmRuntime } from '../../core/types/coreFhevmRuntime.js';
+import type { FhevmOptions } from '../../core/types/coreFhevmClient.js';
+import type { FhevmBaseClient } from '../../core/types/fhevmClient.js';
+import { createCoreFhevm } from '../../core/runtime/CoreFhevm-p.js';
+import { baseActions } from '../../core/clients/decorators/base.js';
+import { PRIVATE_VIEM_TOKEN } from '../internal/viem-p.js';
+import { getCleartextViemRuntime } from '../internal/runtime-ct.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function createFhevmCleartextBaseClient<
+  chain extends FhevmChain,
+  publicClient extends PublicClient,
+>(parameters: {
+  readonly publicClient: publicClient;
+  readonly chain: chain;
+  readonly options?: FhevmOptions | undefined;
+}): FhevmBaseClient<chain, FhevmRuntime, publicClient> {
+  const c = createCoreFhevm(PRIVATE_VIEM_TOKEN, {
+    chain: parameters.chain,
+    runtime: getCleartextViemRuntime(),
+    client: parameters.publicClient,
+    options: parameters.options,
+  });
+  return c.extend(baseActions);
+}

package/viem/cleartext/createFhevmCleartextClient.ts

@@ -0,0 +1,20 @@
+import type { PublicClient } from 'viem';
+import type { FhevmChain } from '../../core/types/fhevmChain.js';
+import type { WithAll } from '../../core/types/coreFhevmRuntime.js';
+import type { FhevmOptions } from '../../core/types/coreFhevmClient.js';
+import type { FhevmClient } from '../../core/types/fhevmClient.js';
+import { createFhevmCleartextBaseClient } from './createFhevmCleartextBaseClient.js';
+import { encryptActions } from './decorators/encrypt.js';
+import { decryptActions } from './decorators/decrypt.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function createFhevmCleartextClient<chain extends FhevmChain, publicClient extends PublicClient>(parameters: {
+  readonly publicClient: publicClient;
+  readonly chain: chain;
+  readonly options?: FhevmOptions | undefined;
+}): FhevmClient<chain, WithAll, publicClient> {
+  const c = createFhevmCleartextBaseClient(parameters);
+
+  return c.extend(decryptActions).extend(encryptActions);
+}

package/viem/cleartext/createFhevmCleartextDecryptClient.ts

@@ -0,0 +1,21 @@
+import type { PublicClient } from 'viem';
+import type { FhevmChain } from '../../core/types/fhevmChain.js';
+import type { WithDecrypt } from '../../core/types/coreFhevmRuntime.js';
+import type { FhevmOptions } from '../../core/types/coreFhevmClient.js';
+import type { FhevmDecryptClient } from '../../core/types/fhevmClient.js';
+import { createFhevmCleartextBaseClient } from './createFhevmCleartextBaseClient.js';
+import { decryptActions } from './decorators/decrypt.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function createFhevmCleartextDecryptClient<
+  chain extends FhevmChain,
+  publicClient extends PublicClient,
+>(parameters: {
+  readonly publicClient: publicClient;
+  readonly chain: chain;
+  readonly options?: FhevmOptions | undefined;
+}): FhevmDecryptClient<chain, WithDecrypt, publicClient> {
+  const c = createFhevmCleartextBaseClient(parameters);
+  return c.extend(decryptActions);
+}

package/viem/cleartext/createFhevmCleartextEncryptClient.ts

@@ -0,0 +1,22 @@
+import type { PublicClient } from 'viem';
+import type { FhevmChain } from '../../core/types/fhevmChain.js';
+import type { WithEncrypt } from '../../core/types/coreFhevmRuntime.js';
+import type { FhevmOptions } from '../../core/types/coreFhevmClient.js';
+import type { FhevmEncryptClient } from '../../core/types/fhevmClient.js';
+import { createFhevmCleartextBaseClient } from './createFhevmCleartextBaseClient.js';
+import { encryptActions } from './decorators/encrypt.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function createFhevmCleartextEncryptClient<
+  chain extends FhevmChain,
+  publicClient extends PublicClient,
+>(parameters: {
+  readonly publicClient: publicClient;
+  readonly chain: chain;
+  readonly options?: FhevmOptions | undefined;
+}): FhevmEncryptClient<chain, WithEncrypt, publicClient> {
+  const c = createFhevmCleartextBaseClient(parameters);
+
+  return c.extend(encryptActions);
+}

package/viem/cleartext/decorators/decrypt.ts

@@ -0,0 +1,12 @@
+import type { FhevmChain } from '../../../core/types/fhevmChain.js';
+import type { WithDecrypt } from '../../../core/types/coreFhevmRuntime.js';
+import type { FhevmBase, FhevmExtension } from '../../../core/types/coreFhevmClient.js';
+import type { DecryptActions } from '../../../core/clients/decorators/decrypt.js';
+import { decryptModule } from '../../../core/modules/decrypt/mock.js';
+import { decryptActionsWithModule } from '../../../core/clients/decorators/decrypt.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function decryptActions(fhevm: FhevmBase<FhevmChain>): FhevmExtension<DecryptActions, WithDecrypt> {
+  return decryptActionsWithModule(fhevm, decryptModule);
+}

package/viem/cleartext/decorators/encrypt.ts

@@ -0,0 +1,12 @@
+import type { FhevmChain } from '../../../core/types/fhevmChain.js';
+import type { WithEncrypt } from '../../../core/types/coreFhevmRuntime.js';
+import type { FhevmBase, FhevmExtension } from '../../../core/types/coreFhevmClient.js';
+import type { EncryptActions } from '../../../core/clients/decorators/encrypt.js';
+import { encryptModule } from '../../../core/modules/encrypt/mock.js';
+import { encryptActionsWithModule } from '../../../core/clients/decorators/encrypt.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function encryptActions(fhevm: FhevmBase<FhevmChain>): FhevmExtension<EncryptActions, WithEncrypt> {
+  return encryptActionsWithModule(fhevm, encryptModule);
+}

package/viem/cleartext/index.ts

@@ -0,0 +1,4 @@
+export { createFhevmCleartextBaseClient } from './createFhevmCleartextBaseClient.js';
+export { createFhevmCleartextDecryptClient } from './createFhevmCleartextDecryptClient.js';
+export { createFhevmCleartextEncryptClient } from './createFhevmCleartextEncryptClient.js';
+export { createFhevmCleartextClient } from './createFhevmCleartextClient.js';

package/viem/cleartext/package.json

@@ -0,0 +1,6 @@
+{
+  "type": "module",
+  "types": "../../_types/viem/cleartext/index.d.ts",
+  "module": "../../_esm/viem/cleartext/index.js",
+  "main": "../../_cjs/viem/cleartext/index.js"
+}

package/viem/clients/createFhevmBaseClient.ts

@@ -3,7 +3,8 @@ import type { FhevmChain } from '../../core/types/fhevmChain.js';
 import type { FhevmRuntime } from '../../core/types/coreFhevmRuntime.js';
 import type { FhevmOptions } from '../../core/types/coreFhevmClient.js';
 import type { FhevmBaseClient } from '../../core/types/fhevmClient.js';
-import { getViemRuntime, PRIVATE_VIEM_TOKEN } from '../internal/viem-p.js';
+import { PRIVATE_VIEM_TOKEN } from '../internal/viem-p.js';
+import { getViemRuntime } from '../internal/runtime.js';
 import { createCoreFhevm } from '../../core/runtime/CoreFhevm-p.js';
 import { baseActions } from '../../core/clients/decorators/base.js';
 

package/viem/clients/createFhevmClient.ts

@@ -4,8 +4,8 @@ import type { WithAll } from '../../core/types/coreFhevmRuntime.js';
 import type { FhevmOptions } from '../../core/types/coreFhevmClient.js';
 import type { FhevmClient } from '../../core/types/fhevmClient.js';
 import { createFhevmBaseClient } from './createFhevmBaseClient.js';
-import { encryptActions } from '../decorators/encrypt.js';
-import { decryptActions } from '../decorators/decrypt.js';
+import { encryptActions } from './decorators/encrypt.js';
+import { decryptActions } from './decorators/decrypt.js';
 
 ////////////////////////////////////////////////////////////////////////////////
 

package/viem/clients/createFhevmDecryptClient.ts

@@ -4,7 +4,7 @@ import type { WithDecrypt } from '../../core/types/coreFhevmRuntime.js';
 import type { FhevmOptions } from '../../core/types/coreFhevmClient.js';
 import type { FhevmDecryptClient } from '../../core/types/fhevmClient.js';
 import { createFhevmBaseClient } from './createFhevmBaseClient.js';
-import { decryptActions } from '../decorators/decrypt.js';
+import { decryptActions } from './decorators/decrypt.js';
 
 ////////////////////////////////////////////////////////////////////////////////
 

package/viem/clients/createFhevmEncryptClient.ts

@@ -4,7 +4,7 @@ import type { WithEncrypt } from '../../core/types/coreFhevmRuntime.js';
 import type { FhevmOptions } from '../../core/types/coreFhevmClient.js';
 import type { FhevmEncryptClient } from '../../core/types/fhevmClient.js';
 import { createFhevmBaseClient } from './createFhevmBaseClient.js';
-import { encryptActions } from '../decorators/encrypt.js';
+import { encryptActions } from './decorators/encrypt.js';
 
 ////////////////////////////////////////////////////////////////////////////////
 
@@ -17,5 +17,3 @@ export function createFhevmEncryptClient<chain extends FhevmChain, publicClient
 
   return c.extend(encryptActions);
 }
-
-////////////////////////////////////////////////////////////////////////////////

package/viem/clients/decorators/decrypt.ts

@@ -0,0 +1,12 @@
+import type { FhevmChain } from '../../../core/types/fhevmChain.js';
+import type { WithDecrypt } from '../../../core/types/coreFhevmRuntime.js';
+import type { FhevmBase, FhevmExtension } from '../../../core/types/coreFhevmClient.js';
+import type { DecryptActions } from '../../../core/clients/decorators/decrypt.js';
+import { decryptModule } from '../../../core/modules/decrypt/module/index.js';
+import { decryptActionsWithModule } from '../../../core/clients/decorators/decrypt.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function decryptActions(fhevm: FhevmBase<FhevmChain>): FhevmExtension<DecryptActions, WithDecrypt> {
+  return decryptActionsWithModule(fhevm, decryptModule);
+}

package/viem/clients/decorators/encrypt.ts

@@ -0,0 +1,12 @@
+import type { FhevmChain } from '../../../core/types/fhevmChain.js';
+import type { WithEncrypt } from '../../../core/types/coreFhevmRuntime.js';
+import type { FhevmBase, FhevmExtension } from '../../../core/types/coreFhevmClient.js';
+import type { EncryptActions } from '../../../core/clients/decorators/encrypt.js';
+import { encryptModule } from '../../../core/modules/encrypt/module/index.js';
+import { encryptActionsWithModule } from '../../../core/clients/decorators/encrypt.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function encryptActions(fhevm: FhevmBase<FhevmChain>): FhevmExtension<EncryptActions, WithEncrypt> {
+  return encryptActionsWithModule(fhevm, encryptModule);
+}

package/viem/index.ts

@@ -1,9 +1,9 @@
-export { setFhevmRuntimeConfig } from './internal/viem-p.js';
+export { setFhevmRuntimeConfig, hasFhevmRuntimeConfig } from './internal/config.js';
 
 export { createFhevmBaseClient } from './clients/createFhevmBaseClient.js';
-export { createFhevmClient } from './clients/createFhevmClient.js';
 export { createFhevmDecryptClient } from './clients/createFhevmDecryptClient.js';
 export { createFhevmEncryptClient } from './clients/createFhevmEncryptClient.js';
+export { createFhevmClient } from './clients/createFhevmClient.js';
 
 export { initFhevmRuntime } from './runtime/initFhevmRuntime.js';
 export { initFhevmEncryptRuntime } from './runtime/initFhevmEncryptRuntime.js';

package/viem/internal/config.ts

@@ -0,0 +1,50 @@
+import type { FhevmRuntimeConfig } from '../../core/types/coreFhevmRuntime.js';
+
+let viemFhevmRuntimeConfig: FhevmRuntimeConfig | undefined;
+
+////////////////////////////////////////////////////////////////////////////////
+
+/**
+ * Sets the global {@link FhevmRuntimeConfig} used by the viem adapter.
+ *
+ * Must be called before any runtime or client is created.
+ * May be called multiple times with identical parameters (idempotent).
+ * Throws if called again with different parameters.
+ *
+ * @param config - The runtime configuration.
+ * @throws If a different config has already been set.
+ */
+export function setFhevmRuntimeConfig(config: FhevmRuntimeConfig): void {
+  if (viemFhevmRuntimeConfig === undefined) {
+    viemFhevmRuntimeConfig = Object.freeze({
+      ...config,
+      logger: config.logger ? Object.freeze({ ...config.logger }) : undefined,
+    });
+    return;
+  }
+
+  if (
+    viemFhevmRuntimeConfig.logger !== config.logger ||
+    viemFhevmRuntimeConfig.locateFile !== config.locateFile ||
+    viemFhevmRuntimeConfig.singleThread !== config.singleThread ||
+    viemFhevmRuntimeConfig.numberOfThreads !== config.numberOfThreads
+  ) {
+    throw new Error(
+      'FhevmRuntime config has already been set and cannot be changed. ' +
+        'Ensure setFhevmRuntimeConfig is called only once, or with identical parameters.',
+    );
+  }
+}
+
+export function hasFhevmRuntimeConfig(): boolean {
+  return viemFhevmRuntimeConfig !== undefined;
+}
+
+export function getFhevmRuntimeConfig(): FhevmRuntimeConfig {
+  if (viemFhevmRuntimeConfig === undefined) {
+    throw new Error(
+      'FhevmRuntime config has not been set. ' + 'Call setFhevmRuntimeConfig before creating any runtime or client.',
+    );
+  }
+  return viemFhevmRuntimeConfig;
+}

package/viem/internal/ethereum-ct.ts

@@ -0,0 +1,61 @@
+import type {
+  CleartextEthereumModuleFactory,
+  GeneratePrivateKeyReturnType,
+  GetPublicKeyParameters,
+  GetPublicKeyReturnType,
+  MnemonicToAccountParameters,
+  MnemonicToAccountReturnType,
+  RecoverAddressParameters,
+  RecoverAddressReturnType,
+  SignParameters,
+  SignReturnType,
+} from '../../core/modules/ethereum/types-ct.js';
+import type { Bytes65Hex, BytesHex, ChecksummedAddress } from '../../core/types/primitives.js';
+import { generatePrivateKey, mnemonicToAccount, privateKeyToAccount, sign } from 'viem/accounts';
+import {
+  decode,
+  encode,
+  encodePacked,
+  getChainId,
+  readContract,
+  recoverTypedDataAddress,
+  signTypedData,
+} from './ethereum.js';
+import { bytesToHex } from '../../core/base/bytes.js';
+import { recoverAddress } from 'viem';
+
+////////////////////////////////////////////////////////////////////////////////
+
+export const cleartextEthereumModule: CleartextEthereumModuleFactory = () => {
+  return Object.freeze({
+    ethereum: Object.freeze({
+      decode,
+      encode,
+      encodePacked,
+      recoverTypedDataAddress,
+      signTypedData,
+      getChainId,
+      readContract,
+      mnemonicToAccount: (parameters: MnemonicToAccountParameters): MnemonicToAccountReturnType => {
+        const signer = mnemonicToAccount(parameters.mnemonic, { path: parameters.path });
+        const pk = signer.getHdKey().privateKey;
+        if (pk === null) {
+          throw new Error(`Failed to derive private key from mnemonic at address ${signer.address}.`);
+        }
+        return { privateKey: bytesToHex(pk), address: signer.address as ChecksummedAddress };
+      },
+      sign: (parameters: SignParameters): Promise<SignReturnType> => {
+        return sign({ hash: parameters.hash, privateKey: parameters.privateKey, to: 'hex' }) as Promise<Bytes65Hex>;
+      },
+      generatePrivateKey: (): GeneratePrivateKeyReturnType => {
+        return generatePrivateKey() as BytesHex;
+      },
+      getPublicKey: (parameters: GetPublicKeyParameters): GetPublicKeyReturnType => {
+        return privateKeyToAccount(parameters.privateKey).publicKey as BytesHex;
+      },
+      recoverAddress: (parameters: RecoverAddressParameters): Promise<RecoverAddressReturnType> => {
+        return recoverAddress(parameters) as Promise<ChecksummedAddress>;
+      },
+    }),
+  });
+};

package/viem/internal/runtime-ct.ts

@@ -0,0 +1,28 @@
+import type { FhevmRuntime } from '../../core/types/coreFhevmRuntime.js';
+import { getFhevmRuntimeConfig, hasFhevmRuntimeConfig } from './config.js';
+import { cleartextEthereumModule } from './ethereum-ct.js';
+import { relayerModule as cleartextRelayerModule } from '../../core/modules/relayer/cleartext/mock.js';
+import { createFhevmRuntime } from './viem-p.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+let viemFhevmRuntime: FhevmRuntime | undefined;
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function getCleartextViemRuntime(): FhevmRuntime {
+  if (!hasFhevmRuntimeConfig()) {
+    throw new Error('Call setFhevmRuntimeConfig first.');
+  }
+
+  const em = cleartextEthereumModule();
+  const rm = cleartextRelayerModule();
+
+  viemFhevmRuntime ??= createFhevmRuntime({
+    ethereum: em.ethereum,
+    relayer: rm.relayer,
+    config: getFhevmRuntimeConfig(),
+  });
+
+  return viemFhevmRuntime;
+}

package/viem/internal/runtime.ts

@@ -0,0 +1,28 @@
+import type { FhevmRuntime } from '../../core/types/coreFhevmRuntime.js';
+import { getFhevmRuntimeConfig, hasFhevmRuntimeConfig } from './config.js';
+import { ethereumModule } from './ethereum.js';
+import { relayerModule } from '../../core/modules/relayer/module/index.js';
+import { createFhevmRuntime } from './viem-p.js';
+
+////////////////////////////////////////////////////////////////////////////////
+
+let viemFhevmRuntime: FhevmRuntime | undefined;
+
+////////////////////////////////////////////////////////////////////////////////
+
+export function getViemRuntime(): FhevmRuntime {
+  if (!hasFhevmRuntimeConfig()) {
+    throw new Error('Call setFhevmRuntimeConfig first.');
+  }
+
+  const em = ethereumModule();
+  const rm = relayerModule();
+
+  viemFhevmRuntime ??= createFhevmRuntime({
+    ethereum: em.ethereum,
+    relayer: rm.relayer,
+    config: getFhevmRuntimeConfig(),
+  });
+
+  return viemFhevmRuntime;
+}