viem 2.0.0-rc.1 → 2.0.0-rc.3

package/chains/definitions/wemix.ts

@@ -0,0 +1,16 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const wemix = /*#__PURE__*/ defineChain({
+  id: 1111,
+  name: 'WEMIX',
+  network: 'wemix-mainnet',
+  nativeCurrency: { name: 'WEMIX', symbol: 'WEMIX', decimals: 18 },
+  rpcUrls: {
+    default: { http: ['https://api.wemix.com'] },
+    public: { http: ['https://api.wemix.com'] },
+  },
+  blockExplorers: {
+    etherscan: { name: 'wemixExplorer', url: 'https://explorer.wemix.com' },
+    default: { name: 'wemixExplorer', url: 'https://explorer.wemix.com' },
+  },
+})

package/chains/definitions/wemixTestnet.ts

@@ -0,0 +1,17 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const wemixTestnet = /*#__PURE__*/ defineChain({
+  id: 1112,
+  name: 'WEMIX Testnet',
+  network: 'wemix-testnet',
+  nativeCurrency: { name: 'WEMIX', symbol: 'tWEMIX', decimals: 18 },
+  rpcUrls: {
+    default: { http: ['https://api.test.wemix.com'] },
+    public: { http: ['https://api.test.wemix.com'] },
+  },
+  blockExplorers: {
+    etherscan: { name: 'wemixExplorer', url: 'https://testnet.wemixscan.com' },
+    default: { name: 'wemixExplorer', url: 'https://testnet.wemixscan.com' },
+  },
+  testnet: true,
+})

package/chains/index.ts

@@ -15,6 +15,8 @@ export { baseGoerli } from './definitions/baseGoerli.js'
 export { baseSepolia } from './definitions/baseSepolia.js'
 export { bearNetworkChainMainnet } from './definitions/bearNetworkChainMainnet.js'
 export { bearNetworkChainTestnet } from './definitions/bearNetworkChainTestnet.js'
+export { bitTorrent } from './definitions/bitTorrent.js'
+export { bitTorrentTestnet } from './definitions/bitTorrentTestnet.js'
 export { boba } from './definitions/boba.js'
 export { bronos } from './definitions/bronos.js'
 export { bronosTestnet } from './definitions/bronosTestnet.js'
@@ -58,6 +60,7 @@ export { fuse } from './definitions/fuse.js'
 export { fuseSparknet } from './definitions/fuseSparknet.js'
 export { iotex } from './definitions/iotex.js'
 export { iotexTestnet } from './definitions/iotexTestnet.js'
+export { jbc } from './definitions/jbc.js'
 export { gobi } from './definitions/gobi.js'
 export { goerli } from './definitions/goerli.js'
 export { gnosis } from './definitions/gnosis.js'
@@ -161,6 +164,8 @@ export { thunderTestnet } from './definitions/thunderTestnet.js'
 export { vechain } from './definitions/vechain.js'
 export { wanchain } from './definitions/wanchain.js'
 export { wanchainTestnet } from './definitions/wanchainTestnet.js'
+export { wemix } from './definitions/wemix.js'
+export { wemixTestnet } from './definitions/wemixTestnet.js'
 export { xdc } from './definitions/xdc.js'
 export { xdcTestnet } from './definitions/xdcTestnet.js'
 export { zhejiang } from './definitions/zhejiang.js'
@@ -174,9 +179,16 @@ export { zora } from './definitions/zora.js'
 export { zoraSepolia } from './definitions/zoraSepolia.js'
 export { zoraTestnet } from './definitions/zoraTestnet.js'
 
+//////////////////////////////////////////////////////////////////////////////////////
 // required for type inference since in explicit return type
 //////////////////////////////////////////////////////////////////////////////////////
-export type { Assign, Omit, PartialBy, Prettify } from '../types/utils.js'
+export type {
+  Assign,
+  Omit,
+  PartialBy,
+  Prettify,
+  UnionLooseOmit,
+} from '../types/utils.js'
 export type {
   OpStackBlock,
   OpStackBlockOverrides,

package/chains/opStack/abis.ts

@@ -1,3 +1,7 @@
+/**
+ * ABI for the OP Stack [`GasPriceOracle` contract](https://github.com/ethereum-optimism/optimism/blob/develop/packages/contracts-bedrock/src/L2/GasPriceOracle.sol).
+ * @see https://optimistic.etherscan.io/address/0x420000000000000000000000000000000000000f
+ */
 export const gasPriceOracleAbi = [
   { inputs: [], stateMutability: 'nonpayable', type: 'constructor' },
   {

package/chains/opStack/contracts.ts

@@ -1,5 +1,9 @@
 import type { Chain } from '../../types/chain.js'
 
+/**
+ * Predeploy contracts for OP Stack.
+ * @see https://github.com/ethereum-optimism/optimism/blob/develop/specs/predeploys.md
+ */
 export const contracts = {
   gasPriceOracle: { address: '0x420000000000000000000000000000000000000F' },
   l1Block: { address: '0x4200000000000000000000000000000000000015' },

package/chains/opStack/decorators/publicL1.ts

@@ -485,6 +485,21 @@ export type PublicActionsL1<
   ) => Promise<WaitToProveReturnType>
 }
 
+/**
+ * A suite of Public Actions for suited for development with Layer 2 (OP Stack) chains.
+ *
+ * - Docs: https://viem.sh/op-stack/client.html
+ *
+ * @example
+ * import { publicActionsL1 } from 'viem/op-stack'
+ * import { mainnet } from 'viem/chains'
+ * import { buildDepositTransaction } from 'viem/wallet'
+ *
+ * export const opStackPublicClientL1 = createWalletClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * }).extend(publicActionsL1())
+ */
 export function publicActionsL1() {
   return <
     TTransport extends Transport,

package/chains/opStack/decorators/publicL2.ts

@@ -444,6 +444,21 @@ export type PublicActionsL2<
   ) => Promise<EstimateTotalGasReturnType>
 }
 
+/**
+ * A suite of Public Actions for suited for development with Layer 2 (OP Stack) chains.
+ *
+ * - Docs: https://viem.sh/op-stack/client.html
+ *
+ * @example
+ * import { publicActionsL2 } from 'viem/op-stack'
+ * import { optimism } from 'viem/chains'
+ * import { buildDepositTransaction } from 'viem/wallet'
+ *
+ * export const opStackPublicClientL1 = createWalletClient({
+ *   chain: optimism,
+ *   transport: http(),
+ * }).extend(publicActionsL1())
+ */
 export function publicActionsL2() {
   return <
     TTransport extends Transport,

package/chains/opStack/decorators/walletL1.ts

@@ -138,6 +138,23 @@ export type WalletActionsL1<
   ) => Promise<ProveWithdrawalReturnType>
 }
 
+/**
+ * A suite of Wallet Actions for suited for development with Layer 2 (OP Stack) chains.
+ *
+ * - Docs: https://viem.sh/op-stack/client.html
+ *
+ * @example
+ * import { createPublicClient, createWalletClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { walletActionsL1 } from 'viem/op-stack'
+ *
+ * const walletClient = createWalletClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * }).extend(walletActionsL1())
+ *
+ * const hash = await walletClient.depositTransaction({...})
+ */
 export function walletActionsL1() {
   return <
     TTransport extends Transport,

package/chains/opStack/decorators/walletL2.ts

@@ -69,6 +69,23 @@ export type WalletActionsL2<
   ) => Promise<InitiateWithdrawalReturnType>
 }
 
+/**
+ * A suite of Wallet Actions for suited for development with Layer 2 (OP Stack) chains.
+ *
+ * - Docs: https://viem.sh/op-stack/client.html
+ *
+ * @example
+ * import { createPublicClient, createWalletClient, http } from 'viem'
+ * import { mainnet } from 'viem/chains'
+ * import { walletActionsL1 } from 'viem/op-stack'
+ *
+ * const walletClient = createWalletClient({
+ *   chain: mainnet,
+ *   transport: http(),
+ * }).extend(walletActionsL1())
+ *
+ * const hash = await walletClient.depositTransaction({...})
+ */
 export function walletActionsL2() {
   return <
     TTransport extends Transport,

package/chains/opStack/types/contract.ts

@@ -1,6 +1,7 @@
 import type { Address } from 'abitype'
 
 import type { Chain } from '../../../types/chain.js'
+import type { Prettify } from '../../../types/utils.js'
 import type { TargetChain } from './chain.js'
 
 export type GetContractAddressParameter<
@@ -8,10 +9,18 @@ export type GetContractAddressParameter<
   contractName extends string,
 > =
   | (chain extends Chain
-      ? {
-          [_key in `${contractName}Address`]?: undefined
-        } & { targetChain: TargetChain<chain, contractName> }
+      ? Prettify<
+          {
+            targetChain: Prettify<TargetChain<chain, contractName>>
+          } & {
+            [_ in `${contractName}Address`]?: undefined
+          }
+        >
       : never)
-  | ({
-      [_key in `${contractName}Address`]: Address
-    } & { targetChain?: undefined })
+  | Prettify<
+      {
+        targetChain?: undefined
+      } & {
+        [_ in `${contractName}Address`]: Address
+      }
+    >

package/clients/decorators/wallet.ts

@@ -370,7 +370,7 @@ export type WalletActions<
    *   value: 1000000000000000000n,
    * })
    */
-  sendTransaction: <TChainOverride extends Chain | undefined>(
+  sendTransaction: <TChainOverride extends Chain | undefined = undefined>(
     args: SendTransactionParameters<TChain, TAccount, TChainOverride>,
   ) => Promise<SendTransactionReturnType>
   /**
@@ -664,7 +664,7 @@ export type WalletActions<
     const abi extends Abi | readonly unknown[],
     functionName extends ContractFunctionName<abi, 'payable' | 'nonpayable'>,
     args extends ContractFunctionArgs<abi, 'pure' | 'view', functionName>,
-    TChainOverride extends Chain | undefined,
+    TChainOverride extends Chain | undefined = undefined,
   >(
     args: WriteContractParameters<
       abi,

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.0.0-rc.1'
+export const version = '2.0.0-rc.3'

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.0.0-rc.1",
-  "type": "module",
+  "version": "2.0.0-rc.3",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",
@@ -77,13 +76,27 @@
   },
   "typesVersions": {
     "*": {
-      "accounts": ["./_types/accounts/index.d.ts"],
-      "actions": ["./_types/actions/index.d.ts"],
-      "chains": ["./_types/chains/index.d.ts"],
-      "chains/utils": ["./_types/chains/utils.d.ts"],
-      "ens": ["./_types/ens/index.d.ts"],
-      "utils": ["./_types/utils/index.d.ts"],
-      "window": ["./_types/window/index.d.ts"]
+      "accounts": [
+        "./_types/accounts/index.d.ts"
+      ],
+      "actions": [
+        "./_types/actions/index.d.ts"
+      ],
+      "chains": [
+        "./_types/chains/index.d.ts"
+      ],
+      "chains/utils": [
+        "./_types/chains/utils.d.ts"
+      ],
+      "ens": [
+        "./_types/ens/index.d.ts"
+      ],
+      "utils": [
+        "./_types/utils/index.d.ts"
+      ],
+      "window": [
+        "./_types/window/index.d.ts"
+      ]
     }
   },
   "peerDependencies": {
@@ -107,12 +120,21 @@
   "license": "MIT",
   "homepage": "https://viem.sh",
   "repository": "wevm/viem",
-  "authors": ["awkweb.eth", "jxom.eth"],
+  "authors": [
+    "awkweb.eth",
+    "jxom.eth"
+  ],
   "funding": [
     {
       "type": "github",
       "url": "https://github.com/sponsors/wevm"
     }
   ],
-  "keywords": ["eth", "ethereum", "dapps", "wallet", "web3"]
-}
+  "keywords": [
+    "eth",
+    "ethereum",
+    "dapps",
+    "wallet",
+    "web3"
+  ]
+}