viem 2.12.5 → 2.13.2

package/_types/experimental/eip3074/utils/verifyAuthMessage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"verifyAuthMessage.d.ts","sourceRoot":"","sources":["../../../../experimental/eip3074/utils/verifyAuthMessage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,sCAAsC,CAAA;AAC7C,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,0CAA0C,CAAA;AACjD,OAAO,EACL,KAAK,kCAAkC,EACvC,KAAK,mCAAmC,EAEzC,MAAM,gCAAgC,CAAA;AAEvC,MAAM,MAAM,2BAA2B,GACrC,mCAAmC,GAAG;IACpC,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAEH,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAA;AAEjD,MAAM,MAAM,0BAA0B,GAClC,uBAAuB,GACvB,mBAAmB,GACnB,kCAAkC,GAClC,SAAS,CAAA;AAEb;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,EACtC,OAAO,EACP,GAAG,UAAU,EACd,EAAE,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAKpE"}

package/chains/definitions/scrollTestnet.ts

@@ -1,21 +0,0 @@
-import { defineChain } from '../../utils/chain/defineChain.js'
-
-export const scrollTestnet = /*#__PURE__*/ defineChain({
-  id: 534_353,
-  name: 'Scroll Testnet',
-  nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
-  rpcUrls: {
-    default: {
-      http: ['https://alpha-rpc.scroll.io/l2'],
-      webSocket: ['wss://alpha-rpc.scroll.io/l2/ws'],
-    },
-  },
-  blockExplorers: {
-    default: {
-      name: 'Blockscout',
-      url: 'https://blockscout.scroll.io',
-      apiUrl: 'https://blockscout.scroll.io/api',
-    },
-  },
-  testnet: true,
-})

package/experimental/eip3074/actions/signAuthMessage.ts

@@ -1,151 +0,0 @@
-import type { Address } from 'abitype'
-import { getTransactionCount } from '../../../actions/public/getTransactionCount.js'
-import type { Client } from '../../../clients/createClient.js'
-import type { Transport } from '../../../clients/transports/createTransport.js'
-import { AccountNotFoundError } from '../../../errors/account.js'
-import type { ErrorType } from '../../../errors/utils.js'
-import type {
-  Account,
-  DeriveAccount,
-  LocalAccount,
-} from '../../../types/account.js'
-import type { Chain, GetChainParameter } from '../../../types/chain.js'
-import type { Hash, Hex } from '../../../types/misc.js'
-import type { IsUndefined } from '../../../types/utils.js'
-import { getAction } from '../../../utils/getAction.js'
-
-// TODO: Use `GetAccountParameter` from `types/utils.ts` when JSON-RPC method for sign auth message exists.
-type GetAccountParameter<
-  account extends Account | undefined = Account | undefined,
-  accountOverride extends Account | Address | undefined = Account | Address,
-> = IsUndefined<account> extends true
-  ? { account: accountOverride | LocalAccount }
-  : account extends LocalAccount
-    ? {
-        account?: accountOverride | LocalAccount | undefined
-      }
-    : { account: accountOverride | LocalAccount }
-
-type GetNonceParameter<account extends Account | Address | undefined> =
-  account extends Address | Account
-    ? {
-        nonce?: number | undefined
-      }
-    : {
-        nonce: number
-      }
-
-export type SignAuthMessageParameters<
-  chain extends Chain | undefined = Chain | undefined,
-  account extends Account | undefined = Account | undefined,
-  chainOverride extends Chain | undefined = Chain | undefined,
-  accountOverride extends Account | Address | undefined = Account | Address,
-> = {
-  commit: Hash
-  invokerAddress: Address
-} & GetAccountParameter<account, accountOverride> &
-  GetChainParameter<chain, chainOverride> &
-  GetNonceParameter<DeriveAccount<account, accountOverride>>
-
-export type SignAuthMessageReturnType = Hex
-
-export type SignAuthMessageErrorType = ErrorType
-
-/**
- * Calculates an [EIP-3074](https://eips.ethereum.org/EIPS/eip-3074) auth signature.
- *
- * With the calculated signature, you can:
- *  - pass it to an EIP-3074 compatible invoker contract,
- *  - use [`verifyAuthMessage`](/experimental/eip3074/verifyAuthMessage) to verify the signature,
- *  - use [`recoverAuthMessageAddress`](/experimental/eip3074/recoverAuthMessageAddress) to recover the signing address from a signature.
- *
- * @param client - Client to use
- * @param parameters - {@link SignAuthMessageParameters}
- * @returns The signed auth message. {@link SignAuthMessageReturnType}
- *
- * @example
- * import { createWalletClient, http } from 'viem'
- * import { privateKeyToAccount } from 'viem/accounts'
- * import { mainnet } from 'viem/chains'
- * import { signAuthMessage } from 'viem/experimental'
- *
- * const account = privateKeyToAccount('0x...')
- *
- * const client = createWalletClient({
- *   chain: mainnet,
- *   transport: http(),
- * })
- *
- * const signature = await signAuthMessage(client, {
- *   account,
- *   chainId: 1,
- *   commit: keccak256('0x1234'),
- *   invokerAddress: '0x0000000000000000000000000000000000000000',
- *   nonce: 69,
- * })
- *
- * @example
- * // Account Hoisting
- * import { createWalletClient, http } from 'viem'
- * import { privateKeyToAccount } from 'viem/accounts'
- * import { mainnet } from 'viem/chains'
- * import { signAuthMessage } from 'viem/experimental'
- *
- * const client = createWalletClient({
- *   account: privateKeyToAccount('0x…'),
- *   chain: mainnet,
- *   transport: http(),
- * })
- *
- * const signature = await signAuthMessage(client, {
- *   chainId: 1,
- *   commit: keccak256('0x1234'),
- *   invokerAddress: '0x0000000000000000000000000000000000000000',
- *   nonce: 69,
- * })
- */
-export async function signAuthMessage<
-  chain extends Chain | undefined,
-  account extends Account | undefined,
-  chainOverride extends Chain | undefined = undefined,
-  accountOverride extends Account | undefined = undefined,
->(
-  client: Client<Transport, chain, account>,
-  parameters: SignAuthMessageParameters<
-    chain,
-    account,
-    chainOverride,
-    accountOverride
-  >,
-): Promise<SignAuthMessageReturnType> {
-  const {
-    account = client.account,
-    chain = client.chain,
-    commit,
-    invokerAddress,
-  } = parameters
-
-  if (!account)
-    throw new AccountNotFoundError({
-      docsPath: '/experimental/eip5792/signAuthMessage',
-    })
-
-  const nonce = await (() => {
-    if (typeof parameters.nonce === 'number') return parameters.nonce
-    return getAction(
-      client,
-      getTransactionCount,
-      'getTransactionCount',
-    )({
-      address: account.address,
-      blockTag: 'pending',
-    })
-  })()
-
-  return account.experimental_signAuthMessage!({
-    chainId: chain!.id,
-    commit,
-    invokerAddress,
-    nonce,
-  })
-}

package/experimental/eip3074/constants/abis.ts

@@ -1,119 +0,0 @@
-export const invokerAbi = [
-  {
-    type: 'function',
-    name: 'execute',
-    inputs: [
-      {
-        name: 'execData',
-        type: 'bytes',
-        internalType: 'bytes',
-      },
-      {
-        name: 'signature',
-        type: 'tuple',
-        internalType: 'struct Auth.Signature',
-        components: [
-          {
-            name: 'signer',
-            type: 'address',
-            internalType: 'address',
-          },
-          {
-            name: 'yParity',
-            type: 'uint8',
-            internalType: 'uint8',
-          },
-          {
-            name: 'r',
-            type: 'bytes32',
-            internalType: 'bytes32',
-          },
-          {
-            name: 's',
-            type: 'bytes32',
-            internalType: 'bytes32',
-          },
-        ],
-      },
-    ],
-    outputs: [],
-    stateMutability: 'nonpayable',
-  },
-  {
-    type: 'function',
-    name: 'getDigest',
-    inputs: [
-      {
-        name: 'execData',
-        type: 'bytes',
-        internalType: 'bytes',
-      },
-      {
-        name: 'nonce',
-        type: 'uint256',
-        internalType: 'uint256',
-      },
-    ],
-    outputs: [
-      {
-        name: 'digest',
-        type: 'bytes32',
-        internalType: 'bytes32',
-      },
-    ],
-    stateMutability: 'view',
-  },
-  {
-    type: 'function',
-    name: 'multiSend',
-    inputs: [
-      {
-        name: 'transactions',
-        type: 'bytes',
-        internalType: 'bytes',
-      },
-    ],
-    outputs: [],
-    stateMutability: 'payable',
-  },
-  {
-    type: 'function',
-    name: 'nextNonce',
-    inputs: [
-      {
-        name: '',
-        type: 'address',
-        internalType: 'address',
-      },
-    ],
-    outputs: [
-      {
-        name: '',
-        type: 'uint256',
-        internalType: 'uint256',
-      },
-    ],
-    stateMutability: 'view',
-  },
-  {
-    type: 'error',
-    name: 'BadAuth',
-    inputs: [],
-  },
-  {
-    type: 'error',
-    name: 'InvalidNonce',
-    inputs: [
-      {
-        name: 'authority',
-        type: 'address',
-        internalType: 'address',
-      },
-      {
-        name: 'attempted',
-        type: 'uint256',
-        internalType: 'uint256',
-      },
-    ],
-  },
-] as const

package/experimental/eip3074/decorators/eip3074.ts

@@ -1,58 +0,0 @@
-import type { Client } from '../../../clients/createClient.js'
-import type { Transport } from '../../../clients/transports/createTransport.js'
-import type { Account } from '../../../types/account.js'
-import type { Chain } from '../../../types/chain.js'
-import {
-  type SignAuthMessageParameters,
-  type SignAuthMessageReturnType,
-  signAuthMessage,
-} from '../actions/signAuthMessage.js'
-
-export type WalletActionsEip3074<
-  chain extends Chain | undefined = Chain | undefined,
-  account extends Account | undefined = Account | undefined,
-> = {
-  signAuthMessage: <
-    chainOverride extends Chain | undefined = undefined,
-    accountOverride extends Account | undefined = undefined,
-  >(
-    parameters: SignAuthMessageParameters<
-      chain,
-      account,
-      chainOverride,
-      accountOverride
-    >,
-  ) => Promise<SignAuthMessageReturnType>
-}
-
-/**
- * A suite of EIP-3074 Wallet Actions.
- *
- * - Docs: https://viem.sh/experimental
- *
- * @example
- * import { createPublicClient, createWalletClient, http } from 'viem'
- * import { mainnet } from 'viem/chains'
- * import { walletActionsEip3074 } from 'viem/experimental'
- *
- * const walletClient = createWalletClient({
- *   chain: mainnet,
- *   transport: http(),
- * }).extend(walletActionsEip3074())
- *
- * const signature = await walletClient.signAuthMessage({...})
- */
-export function walletActionsEip3074() {
-  return <
-    transport extends Transport,
-    chain extends Chain | undefined = Chain | undefined,
-    account extends Account | undefined = Account | undefined,
-  >(
-    client: Client<transport, chain, account>,
-  ): WalletActionsEip3074<chain, account> => {
-    return {
-      signAuthMessage: (parameters) =>
-        signAuthMessage(client as any, parameters),
-    }
-  }
-}

package/experimental/eip3074/invokers/coders/batchInvokerCoder.ts

@@ -1,46 +0,0 @@
-import type { Address } from 'abitype'
-import { readContract } from '../../../../actions/public/readContract.js'
-import type { Hex } from '../../../../types/misc.js'
-import { encodeAbiParameters } from '../../../../utils/abi/encodeAbiParameters.js'
-import { encodePacked } from '../../../../utils/abi/encodePacked.js'
-import { concat } from '../../../../utils/data/concat.js'
-import { size } from '../../../../utils/data/size.js'
-import { invokerAbi } from '../../constants/abis.js'
-import { defineInvokerCoder } from './defineInvokerCoder.js'
-
-type Calls = readonly {
-  to: Address
-  data?: Hex | undefined
-  value?: bigint | undefined
-}[]
-
-export type BatchInvokerArgs = Calls
-
-export function batchInvokerCoder() {
-  return defineInvokerCoder({
-    async toExecData(
-      args: BatchInvokerArgs,
-      { authority, client, invokerAddress },
-    ) {
-      const nonce = await readContract(client, {
-        abi: invokerAbi,
-        address: invokerAddress,
-        functionName: 'nextNonce',
-        args: [authority],
-      })
-
-      const calls = concat(
-        args.map(({ data = '0x', to, value = 0n }) =>
-          encodePacked(
-            ['uint8', 'address', 'uint256', 'uint256', 'bytes'],
-            [2, to, value, BigInt(size(data)), data],
-          ),
-        ),
-      )
-      return encodeAbiParameters(
-        [{ type: 'uint256' }, { type: 'bytes' }],
-        [nonce, calls],
-      )
-    },
-  })
-}

package/experimental/eip3074/invokers/coders/defineInvokerCoder.ts

@@ -1,20 +0,0 @@
-import type { Address } from 'abitype'
-import type { Client } from '../../../../clients/createClient.js'
-import type { Hex } from '../../../../types/misc.js'
-
-export type InvokerCoder<args = unknown> = {
-  toExecData: (
-    args: args,
-    options: { authority: Address; client: Client; invokerAddress: Hex },
-  ) => Promise<Hex>
-}
-
-export type DefineInvokerCoderParameters<args = unknown> = InvokerCoder<args>
-
-export type DefineInvokerCoderReturnType<args = unknown> = InvokerCoder<args>
-
-export function defineInvokerCoder<args>(
-  parameters: DefineInvokerCoderParameters<args>,
-): DefineInvokerCoderReturnType<args> {
-  return parameters
-}

package/experimental/eip3074/invokers/getInvoker.ts

@@ -1,192 +0,0 @@
-import type { Address } from 'abitype'
-import {
-  type GetTransactionCountErrorType,
-  getTransactionCount,
-} from '../../../actions/public/getTransactionCount.js'
-import {
-  type WriteContractErrorType,
-  writeContract,
-} from '../../../actions/wallet/writeContract.js'
-import type { Client } from '../../../clients/createClient.js'
-import type { Transport } from '../../../clients/transports/createTransport.js'
-import type { ErrorType } from '../../../errors/utils.js'
-import type { Account, LocalAccount } from '../../../types/account.js'
-import type { Chain, GetChainParameter } from '../../../types/chain.js'
-import type { Hex } from '../../../types/misc.js'
-import type { IsUndefined } from '../../../types/utils.js'
-import { parseAccount } from '../../../utils/accounts.js'
-import {
-  type IsAddressEqualErrorType,
-  isAddressEqual,
-} from '../../../utils/address/isAddressEqual.js'
-import { getAction } from '../../../utils/getAction.js'
-import {
-  type Keccak256ErrorType,
-  keccak256,
-} from '../../../utils/hash/keccak256.js'
-import {
-  type ParseSignatureErrorType,
-  parseSignature,
-} from '../../../utils/signature/parseSignature.js'
-import {
-  type SignAuthMessageErrorType,
-  signAuthMessage,
-} from '../actions/signAuthMessage.js'
-import { invokerAbi } from '../constants/abis.js'
-import type { InvokerCoder } from './coders/defineInvokerCoder.js'
-
-type GetExecutorParameter<
-  TAccount extends Account | undefined = Account | undefined,
-  TAccountOverride extends Account | Address | undefined = Account | Address,
-  TRequired extends boolean = true,
-> = IsUndefined<TAccount> extends true
-  ? TRequired extends true
-    ? { executor: TAccountOverride | Account | Address }
-    : { executor?: TAccountOverride | Account | Address | undefined }
-  : { executor?: TAccountOverride | Account | Address | undefined }
-
-export type InvokerExecuteParameters<
-  account extends Account | undefined = Account | undefined,
-  chain extends Chain | undefined = Chain | undefined,
-  chainOverride extends Chain | undefined = Chain | undefined,
-  args = unknown,
-> = {
-  args: args
-  authority: Account | Address
-  signature: Hex
-} & GetExecutorParameter<account> &
-  GetChainParameter<chain, chainOverride>
-
-export type InvokerExecuteErrorType =
-  | WriteContractErrorType
-  | ParseSignatureErrorType
-  | ErrorType
-
-export type InvokerSignParameters<
-  account extends Account | undefined = Account | undefined,
-  chain extends Chain | undefined = Chain | undefined,
-  chainOverride extends Chain | undefined = Chain | undefined,
-  args = unknown,
-> = {
-  args: args
-  authority: LocalAccount
-} & GetExecutorParameter<account, Account | Address, false> &
-  GetChainParameter<chain, chainOverride>
-
-export type InvokerSignErrorType =
-  | GetTransactionCountErrorType
-  | SignAuthMessageErrorType
-  | Keccak256ErrorType
-  | IsAddressEqualErrorType
-  | ErrorType
-
-export type Invoker<
-  account extends Account | undefined = Account | undefined,
-  chain extends Chain | undefined = Chain | undefined,
-  args = unknown,
-> = {
-  address: Address
-  execute<chainOverride extends Chain | undefined = undefined>(
-    parameters: InvokerExecuteParameters<account, chain, chainOverride, args>,
-  ): Promise<Hex>
-  sign<chainOverride extends Chain | undefined = undefined>(
-    parameters: InvokerSignParameters<account, chain, chainOverride, args>,
-  ): Promise<Hex>
-}
-
-export type GetInvokerParameters<
-  account extends Account | undefined = Account | undefined,
-  chain extends Chain | undefined = Chain | undefined,
-  args = unknown,
-> = {
-  address: Address
-  client: Client<Transport, chain, account>
-  coder: InvokerCoder<args>
-}
-
-export type GetInvokerErrorType = ErrorType
-
-export type InvokerArgs<invoker extends Invoker<any, any, any> = Invoker> =
-  invoker extends Invoker<any, any, infer args> ? args : unknown
-
-export function getInvoker<
-  account extends Account | undefined,
-  chain extends Chain | undefined,
-  args,
->(
-  parameters: GetInvokerParameters<account, chain, args>,
-): Invoker<account, chain, args> {
-  const { address, client, coder } = parameters
-  return {
-    address,
-    async execute(parameters) {
-      const {
-        executor: executor_ = client.account,
-        authority: authority_,
-        args,
-        chain = client.chain,
-        signature,
-      } = parameters
-      const authority = parseAccount(authority_!)
-      const executor = parseAccount(executor_!)
-
-      const execData = await coder.toExecData(args, {
-        authority: authority.address,
-        client,
-        invokerAddress: address,
-      })
-
-      const { r, s, yParity } = parseSignature(signature)
-      return getAction(
-        client,
-        writeContract,
-        'writeContract',
-      )({
-        abi: invokerAbi,
-        address,
-        account: executor,
-        chain,
-        functionName: 'execute',
-        args: [execData, { signer: authority.address, r, s, yParity }],
-      })
-    },
-    async sign(parameters) {
-      const {
-        args,
-        authority,
-        executor: executor_ = client.account,
-        chain = client.chain,
-      } = parameters
-      const executor = parseAccount(executor_!)
-      const [execData, nonce] = await Promise.all([
-        await coder.toExecData(args, {
-          authority: authority.address,
-          client,
-          invokerAddress: address,
-        }),
-        getAction(
-          client,
-          getTransactionCount,
-          'getTransactionCount',
-        )({
-          address: authority.address,
-          blockTag: 'pending',
-        }),
-      ])
-      const signature = await getAction(
-        client,
-        signAuthMessage,
-        'signAuthMessage',
-      )({
-        account: authority,
-        chain,
-        commit: keccak256(execData),
-        invokerAddress: address,
-        nonce: isAddressEqual(authority.address, executor.address)
-          ? nonce + 1
-          : nonce,
-      })
-      return signature
-    },
-  }
-}

package/experimental/eip3074/utils/recoverAuthMessageAddress.ts

@@ -1,29 +0,0 @@
-import type { Address } from 'abitype'
-
-import type { ByteArray, Hex, Signature } from '../../../types/misc.js'
-
-import type { ErrorType } from '../../../errors/utils.js'
-import { keccak256 } from '../../../utils/hash/keccak256.js'
-import {
-  type RecoverAddressErrorType,
-  recoverAddress,
-} from '../../../utils/signature/recoverAddress.js'
-import { type ToAuthMessageParameters, toAuthMessage } from './toAuthMessage.js'
-
-export type RecoverAuthMessageAddressParameters = ToAuthMessageParameters & {
-  signature: Hex | ByteArray | Signature
-}
-
-export type RecoverAuthMessageAddressReturnType = Address
-
-export type RecoverAuthMessageAddressErrorType =
-  | RecoverAddressErrorType
-  | ErrorType
-
-export async function recoverAuthMessageAddress({
-  signature,
-  ...parameters
-}: RecoverAuthMessageAddressParameters): Promise<RecoverAuthMessageAddressReturnType> {
-  const hash = keccak256(toAuthMessage(parameters))
-  return recoverAddress({ hash, signature })
-}

package/experimental/eip3074/utils/signAuthMessage.ts

@@ -1,40 +0,0 @@
-import { type SignErrorType, sign } from '../../../accounts/utils/sign.js'
-import type { ErrorType } from '../../../errors/utils.js'
-import type { Hex } from '../../../types/misc.js'
-import { keccak256 } from '../../../utils/hash/keccak256.js'
-import {
-  type SerializeSignatureErrorType,
-  serializeSignature,
-} from '../../../utils/signature/serializeSignature.js'
-import {
-  type ToAuthMessageErrorType,
-  type ToAuthMessageParameters,
-  toAuthMessage,
-} from './toAuthMessage.js'
-
-export type SignAuthMessageParameters = ToAuthMessageParameters & {
-  /** The private key to sign with. */
-  privateKey: Hex
-}
-
-export type SignAuthMessageReturnType = Hex
-
-export type SignAuthMessageErrorType =
-  | SignErrorType
-  | ToAuthMessageErrorType
-  | SerializeSignatureErrorType
-  | ErrorType
-
-/**
- * Computes a EIP-3074 authorization signature in format: `keccak256(MAGIC || chainId || nonce || invokerAddress || commit))`.
- */
-export async function signAuthMessage(
-  parameters: SignAuthMessageParameters,
-): Promise<SignAuthMessageReturnType> {
-  const { privateKey } = parameters
-  const signature = await sign({
-    hash: keccak256(toAuthMessage(parameters)),
-    privateKey,
-  })
-  return serializeSignature(signature)
-}