viem 2.38.1 → 2.38.3

package/actions/wallet/sendTransactionSync.ts

@@ -15,6 +15,10 @@ import {
   type AccountTypeNotSupportedErrorType,
 } from '../../errors/account.js'
 import { BaseError } from '../../errors/base.js'
+import {
+  TransactionReceiptRevertedError,
+  type TransactionReceiptRevertedErrorType,
+} from '../../errors/transaction.js'
 import type { ErrorType } from '../../errors/utils.js'
 import type { GetAccountParameter } from '../../types/account.js'
 import type {
@@ -91,6 +95,8 @@ export type SendTransactionSyncParameters<
   GetTransactionRequestKzgParameter<request> & {
     /** Polling interval (ms) to poll for the transaction receipt. @default client.pollingInterval */
     pollingInterval?: number | undefined
+    /** Whether to throw an error if the transaction was detected as reverted. @default true */
+    throwOnReceiptRevert?: boolean | undefined
     /** Timeout (ms) to wait for a response. @default Math.max(chain.blockTime * 3, 5_000) */
     timeout?: number | undefined
   }
@@ -111,6 +117,7 @@ export type SendTransactionSyncErrorType =
       | SendRawTransactionSyncErrorType
       | RecoverAuthorizationAddressErrorType
       | SignTransactionErrorType
+      | TransactionReceiptRevertedErrorType
       | RequestErrorType
     >
   | WaitForTransactionReceiptErrorType
@@ -184,6 +191,7 @@ export async function sendTransactionSync<
     maxPriorityFeePerGas,
     nonce,
     pollingInterval,
+    throwOnReceiptRevert,
     type,
     value,
     ...rest
@@ -314,7 +322,7 @@ export async function sendTransactionSync<
         }
       })()
 
-      return getAction(
+      const receipt = await getAction(
         client,
         waitForTransactionReceipt,
         'waitForTransactionReceipt',
@@ -324,6 +332,9 @@ export async function sendTransactionSync<
         pollingInterval,
         timeout,
       })
+      if (throwOnReceiptRevert && receipt.status === 'reverted')
+        throw new TransactionReceiptRevertedError({ receipt })
+      return receipt
     }
 
     if (account?.type === 'local') {
@@ -363,6 +374,7 @@ export async function sendTransactionSync<
         'sendRawTransactionSync',
       )({
         serializedTransaction,
+        throwOnReceiptRevert,
       })) as never
     }
 

package/actions/wallet/writeContractSync.ts

@@ -39,7 +39,10 @@ export type WriteContractSyncParameters<
   account,
   chainOverride
 > &
-  Pick<SendTransactionSyncParameters<chain>, 'pollingInterval' | 'timeout'>
+  Pick<
+    SendTransactionSyncParameters<chain>,
+    'pollingInterval' | 'throwOnReceiptRevert' | 'timeout'
+  >
 
 export type WriteContractSyncReturnType<
   chain extends Chain | undefined = Chain | undefined,

package/chains/definitions/kiiTestnet.ts

@@ -0,0 +1,24 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const kiiTestnetOro = /*#__PURE__*/ defineChain({
+  id: 1336,
+  name: 'Kii Testnet Oro',
+  network: 'kii-testnet-oro',
+  nativeCurrency: {
+    name: 'Kii',
+    symbol: 'KII',
+    decimals: 18,
+  },
+  rpcUrls: {
+    default: {
+      http: ['https://json-rpc.uno.sentry.testnet.v3.kiivalidator.com'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'KiiExplorer',
+      url: 'https://explorer.kiichain.io/testnet',
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/linea.ts

@@ -5,6 +5,7 @@ export const linea = /*#__PURE__*/ defineChain({
   ...chainConfig,
   id: 59_144,
   name: 'Linea Mainnet',
+  blockTime: 2000,
   nativeCurrency: { name: 'Linea Ether', symbol: 'ETH', decimals: 18 },
   rpcUrls: {
     default: {

package/chains/definitions/plasma.ts

@@ -3,6 +3,7 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 export const plasma = /*#__PURE__*/ defineChain({
   id: 9745,
   name: 'Plasma',
+  blockTime: 1000,
   nativeCurrency: {
     name: 'Plasma',
     symbol: 'XPL',

package/chains/definitions/polygon.ts

@@ -3,6 +3,7 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 export const polygon = /*#__PURE__*/ defineChain({
   id: 137,
   name: 'Polygon',
+  blockTime: 2000,
   nativeCurrency: { name: 'POL', symbol: 'POL', decimals: 18 },
   rpcUrls: {
     default: {

package/chains/definitions/scroll.ts

@@ -3,6 +3,7 @@ import { defineChain } from '../../utils/chain/defineChain.js'
 export const scroll = /*#__PURE__*/ defineChain({
   id: 534_352,
   name: 'Scroll',
+  blockTime: 3000,
   nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
   rpcUrls: {
     default: {

package/chains/definitions/surgeTestnet.ts

@@ -0,0 +1,20 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const surgeTestnet = /*#__PURE__*/ defineChain({
+  id: 763_375,
+  name: 'Surge Testnet',
+  nativeCurrency: { name: 'Ether', symbol: 'ETH', decimals: 18 },
+  rpcUrls: {
+    default: {
+      http: ['https://l2-rpc.hoodi.surge.wtf'],
+      webSocket: ['wss://l2-ws.hoodi.surge.wtf'],
+    },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Surge Testnet Blockscout',
+      url: 'https://explorer.hoodi.surge.wtf',
+    },
+  },
+  testnet: true,
+})

package/chains/definitions/swanProximaTestnet.ts

@@ -5,7 +5,7 @@ export const swanProximaTestnet = /*#__PURE__*/ defineChain({
   name: 'Swan Proxima Testnet',
   nativeCurrency: { name: 'Swan Ether', symbol: 'sETH', decimals: 18 },
   rpcUrls: {
-    default: { http: ['https://rpc-proxima.swanchain.io	'] },
+    default: { http: ['https://rpc-proxima.swanchain.io'] },
   },
   blockExplorers: {
     default: {

package/chains/definitions/vana.ts

@@ -0,0 +1,28 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const vana = /*#__PURE__*/ defineChain({
+  id: 1480,
+  name: 'Vana',
+  blockTime: 6_000,
+  nativeCurrency: {
+    decimals: 18,
+    name: 'Vana',
+    symbol: 'VANA',
+  },
+  rpcUrls: {
+    default: { http: ['https://rpc.vana.org/'] },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Vana Block Explorer',
+      url: 'https://vanascan.io',
+      apiUrl: 'https://vanascan.io/api',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xD8d2dFca27E8797fd779F8547166A2d3B29d360E',
+      blockCreated: 716763,
+    },
+  },
+})

package/chains/definitions/vanaMoksha.ts

@@ -0,0 +1,29 @@
+import { defineChain } from '../../utils/chain/defineChain.js'
+
+export const vanaMoksha = /*#__PURE__*/ defineChain({
+  id: 14800,
+  name: 'Vana Moksha Testnet',
+  blockTime: 6_000,
+  nativeCurrency: {
+    decimals: 18,
+    name: 'Vana',
+    symbol: 'VANA',
+  },
+  rpcUrls: {
+    default: { http: ['https://rpc.moksha.vana.org'] },
+  },
+  blockExplorers: {
+    default: {
+      name: 'Vana Moksha Testnet',
+      url: 'https://moksha.vanascan.io',
+      apiUrl: 'https://moksha.vanascan.io/api',
+    },
+  },
+  contracts: {
+    multicall3: {
+      address: '0xD8d2dFca27E8797fd779F8547166A2d3B29d360E',
+      blockCreated: 732283,
+    },
+  },
+  testnet: true,
+})

package/chains/index.ts

@@ -311,6 +311,7 @@ export { katana } from './definitions/katana.js'
 export { kava } from './definitions/kava.js'
 export { kavaTestnet } from './definitions/kavaTestnet.js'
 export { kcc } from './definitions/kcc.js'
+export { kiiTestnetOro } from './definitions/kiiTestnet.js'
 export { kinto } from './definitions/kinto.js'
 /** @deprecated Use `kaia` instead. */
 export { klaytn } from './definitions/klaytn.js'
@@ -560,6 +561,7 @@ export { superlumio } from './definitions/superlumio.js'
 export { superposition } from './definitions/superposition.js'
 export { superseed } from './definitions/superseed.js'
 export { superseedSepolia } from './definitions/superseedSepolia.js'
+export { surgeTestnet } from './definitions/surgeTestnet.js'
 export { swan } from './definitions/swan.js'
 export { swanProximaTestnet } from './definitions/swanProximaTestnet.js'
 export { swanSaturnTestnet } from './definitions/swanSaturnTestnet.js'
@@ -607,6 +609,8 @@ export { unique } from './definitions/unique.js'
 export { uniqueOpal } from './definitions/uniqueOpal.js'
 export { uniqueQuartz } from './definitions/uniqueQuartz.js'
 export { unreal } from './definitions/unreal.js'
+export { vana } from './definitions/vana.js'
+export { vanaMoksha } from './definitions/vanaMoksha.js'
 export { vanar } from './definitions/vanar.js'
 export { vechain } from './definitions/vechain.js'
 export { velas } from './definitions/velas.js'

package/errors/transaction.ts

@@ -3,7 +3,10 @@ import type { SendTransactionParameters } from '../actions/wallet/sendTransactio
 import type { BlockTag } from '../types/block.js'
 import type { Chain } from '../types/chain.js'
 import type { Hash, Hex } from '../types/misc.js'
-import type { TransactionType } from '../types/transaction.js'
+import type {
+  TransactionReceipt,
+  TransactionType,
+} from '../types/transaction.js'
 import { formatEther } from '../utils/unit/formatEther.js'
 import { formatGwei } from '../utils/unit/formatGwei.js'
 
@@ -245,6 +248,29 @@ export class TransactionReceiptNotFoundError extends BaseError {
   }
 }
 
+export type TransactionReceiptRevertedErrorType =
+  TransactionReceiptRevertedError & {
+    name: 'TransactionReceiptRevertedError'
+  }
+export class TransactionReceiptRevertedError extends BaseError {
+  receipt: TransactionReceipt
+
+  constructor({ receipt }: { receipt: TransactionReceipt }) {
+    super(`Transaction with hash "${receipt.transactionHash}" reverted.`, {
+      metaMessages: [
+        'The receipt marked the transaction as "reverted". This could mean that the function on the contract you are trying to call threw an error.',
+        ' ',
+        'You can attempt to extract the revert reason by:',
+        '- calling the `simulateContract` or `simulateCalls` Action with the `abi` and `functionName` of the contract',
+        '- using the `call` Action with raw `data`',
+      ],
+      name: 'TransactionReceiptRevertedError',
+    })
+
+    this.receipt = receipt
+  }
+}
+
 export type WaitForTransactionReceiptTimeoutErrorType =
   WaitForTransactionReceiptTimeoutError & {
     name: 'WaitForTransactionReceiptTimeoutError'

package/errors/version.ts

@@ -1 +1 @@
-export const version = '2.38.1'
+export const version = '2.38.3'

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "2.38.1",
+  "version": "2.38.3",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
   "types": "./_types/index.d.ts",

package/types/calls.ts

@@ -21,9 +21,10 @@ export type Call<
         GetMulticallContractParameters<call, AbiStateMutability>,
         'address'
       > & {
+        data?: Hex | undefined
+        dataSuffix?: Hex | undefined
         to: Address
         value?: bigint | undefined
-        dataSuffix?: Hex | undefined
       },
       extraProperties
     >