viem 2.0.0-beta.1 → 2.0.0-beta.10

package/utils/unit/parseGwei.ts

@@ -5,6 +5,17 @@ import { type ParseUnitsErrorType, parseUnits } from './parseUnits.js'
 
 export type ParseGweiErrorType = ParseUnitsErrorType | ErrorType
 
+/**
+ * Converts a string representation of gwei to numerical wei.
+ *
+ * - Docs: https://viem.sh/docs/utilities/parseGwei.html
+ *
+ * @example
+ * import { parseGwei } from 'viem'
+ *
+ * parseGwei('420')
+ * // 420000000000n
+ */
 export function parseGwei(ether: string, unit: 'wei' = 'wei') {
   return parseUnits(ether, gweiUnits[unit])
 }

package/utils/unit/parseUnits.ts

@@ -2,6 +2,17 @@ import type { ErrorType } from '../../errors/utils.js'
 
 export type ParseUnitsErrorType = ErrorType
 
+/**
+ * Multiplies a string representation of a number by a given exponent of base 10 (10exponent).
+ *
+ * - Docs: https://viem.sh/docs/utilities/parseUnits.html
+ *
+ * @example
+ * import { parseUnits } from 'viem'
+ *
+ * parseUnits('420', 9)
+ * // 420000000000n
+ */
 export function parseUnits(value: string, decimals: number) {
   let [integer, fraction = '0'] = value.split('.')
 

package/_cjs/chains/optimism/formatters.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../../chains/optimism/formatters.ts"],"names":[],"mappings":";;;AAGA,gEAA6D;AAC7D,8DAA6D;AAC7D,0EAG8C;AAC9C,wFAAuF;AAU1E,QAAA,kBAAkB,GAAG;IAChC,KAAK,EAAgB,IAAA,sBAAW,EAAC;QAC/B,MAAM,CACJ,IAEC;YAID,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;gBAC1D,IAAI,OAAO,WAAW,KAAK,QAAQ;oBAAE,OAAO,WAAW,CAAA;gBACvD,MAAM,SAAS,GAAG,IAAA,kCAAiB,EACjC,WAA6B,CACP,CAAA;gBACxB,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM,EAAE;oBAChC,SAAS,CAAC,UAAU,GAAG,WAAW,CAAC,UAAU,CAAA;oBAC7C,SAAS,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI;wBAC/B,CAAC,CAAC,IAAA,wBAAW,EAAC,WAAW,CAAC,IAAI,CAAC;wBAC/B,CAAC,CAAC,SAAS,CAAA;oBACb,SAAS,CAAC,UAAU,GAAG,WAAW,CAAC,UAAU,CAAA;oBAC7C,SAAS,CAAC,IAAI,GAAG,SAAS,CAAA;iBAC3B;gBACD,OAAO,SAAS,CAAA;YAClB,CAAC,CAAmC,CAAA;YACpC,OAAO;gBACL,YAAY;gBACZ,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAA;QACH,CAAC;KACF,CAAC;IACF,WAAW,EAAgB,IAAA,kCAAiB,EAAC;QAC3C,MAAM,CAAC,IAA4B;YACjC,MAAM,WAAW,GAAG,EAAyB,CAAA;YAC7C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE;gBACxB,WAAW,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;gBACxC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAA,wBAAW,EAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;gBACjE,WAAW,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;gBACxC,WAAW,CAAC,IAAI,GAAG,SAAS,CAAA;aAC7B;YACD,OAAO,WAAW,CAAA;QACpB,CAAC;KACF,CAAC;IACF,kBAAkB,EAAgB,IAAA,gDAAwB,EAAC;QACzD,MAAM,CACJ,IAA4C;YAE5C,OAAO;gBACL,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAA,wBAAW,EAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;gBACjE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAA,wBAAW,EAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC9D,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,wBAAW,EAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;gBAClD,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI;aAChE,CAAA;QACH,CAAC;KACF,CAAC;CACgC,CAAA"}

package/_cjs/chains/optimism/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../chains/optimism/types.ts"],"names":[],"mappings":""}

package/_esm/chains/optimism/formatters.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatters.js","sourceRoot":"","sources":["../../../chains/optimism/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,sBAAsB,CAAA;AAE3D,OAAO,EAAuB,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAC7D,OAAO,EACL,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAA;AAUvF,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,KAAK,EAAE,aAAa,CAAC,WAAW,CAAC;QAC/B,MAAM,CACJ,IAEC;YAID,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;gBAC1D,IAAI,OAAO,WAAW,KAAK,QAAQ;oBAAE,OAAO,WAAW,CAAA;gBACvD,MAAM,SAAS,GAAG,iBAAiB,CACjC,WAA6B,CACP,CAAA;gBACxB,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM,EAAE;oBAChC,SAAS,CAAC,UAAU,GAAG,WAAW,CAAC,UAAU,CAAA;oBAC7C,SAAS,CAAC,IAAI,GAAG,WAAW,CAAC,IAAI;wBAC/B,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC;wBAC/B,CAAC,CAAC,SAAS,CAAA;oBACb,SAAS,CAAC,UAAU,GAAG,WAAW,CAAC,UAAU,CAAA;oBAC7C,SAAS,CAAC,IAAI,GAAG,SAAS,CAAA;iBAC3B;gBACD,OAAO,SAAS,CAAA;YAClB,CAAC,CAAmC,CAAA;YACpC,OAAO;gBACL,YAAY;gBACZ,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAA;QACH,CAAC;KACF,CAAC;IACF,WAAW,EAAE,aAAa,CAAC,iBAAiB,CAAC;QAC3C,MAAM,CAAC,IAA4B;YACjC,MAAM,WAAW,GAAG,EAAyB,CAAA;YAC7C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE;gBACxB,WAAW,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;gBACxC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;gBACjE,WAAW,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;gBACxC,WAAW,CAAC,IAAI,GAAG,SAAS,CAAA;aAC7B;YACD,OAAO,WAAW,CAAA;QACpB,CAAC;KACF,CAAC;IACF,kBAAkB,EAAE,aAAa,CAAC,wBAAwB,CAAC;QACzD,MAAM,CACJ,IAA4C;YAE5C,OAAO;gBACL,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI;gBACjE,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC9D,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;gBAClD,WAAW,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI;aAChE,CAAA;QACH,CAAC;KACF,CAAC;CACgC,CAAA"}

package/_esm/chains/optimism/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/_esm/chains/optimism/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../chains/optimism/types.ts"],"names":[],"mappings":""}

package/_types/chains/optimism/types.d.ts

@@ -1,53 +0,0 @@
-import type { Block, BlockTag } from '../../types/block.js';
-import type { FeeValuesEIP1559 } from '../../types/fee.js';
-import type { Hash, Hex } from '../../types/misc.js';
-import type { Index, Quantity, RpcBlock, RpcTransaction as RpcTransaction_, RpcTransactionReceipt } from '../../types/rpc.js';
-import type { Transaction as Transaction_, TransactionBase, TransactionReceipt } from '../../types/transaction.js';
-export type OptimismBlockOverrides = {
-    stateRoot: Hash;
-};
-export type OptimismBlock<TIncludeTransactions extends boolean = boolean, TBlockTag extends BlockTag = BlockTag> = Block<bigint, TIncludeTransactions, TBlockTag, OptimismTransaction<TBlockTag extends 'pending' ? true : false>> & OptimismBlockOverrides;
-export type OptimismRpcBlockOverrides = {
-    stateRoot: Hash;
-};
-export type OptimismRpcBlock<TBlockTag extends BlockTag = BlockTag, TIncludeTransactions extends boolean = boolean> = RpcBlock<TBlockTag, TIncludeTransactions, OptimismRpcTransaction<TBlockTag extends 'pending' ? true : false>> & OptimismRpcBlockOverrides;
-type RpcTransaction<TPending extends boolean = boolean> = RpcTransaction_<TPending> & {
-    isSystemTx?: undefined;
-    mint?: undefined;
-    sourceHash?: undefined;
-};
-export type OptimismRpcDepositTransaction<TPending extends boolean = boolean> = Omit<TransactionBase<Quantity, Index, TPending>, 'typeHex'> & FeeValuesEIP1559<Quantity> & {
-    isSystemTx?: boolean;
-    mint?: Hex;
-    sourceHash: Hex;
-    type: '0x7e';
-};
-export type OptimismRpcTransaction<TPending extends boolean = boolean> = RpcTransaction<TPending> | OptimismRpcDepositTransaction<TPending>;
-export type OptimismRpcTransactionReceiptOverrides = {
-    l1GasPrice: Hex | null;
-    l1GasUsed: Hex | null;
-    l1Fee: Hex | null;
-    l1FeeScalar: `${number}` | null;
-};
-export type OptimismRpcTransactionReceipt = RpcTransactionReceipt & OptimismRpcTransactionReceiptOverrides;
-type Transaction<TPending extends boolean = boolean> = Transaction_<bigint, number, TPending> & {
-    isSystemTx?: undefined;
-    mint?: undefined;
-    sourceHash?: undefined;
-};
-export type OptimismDepositTransaction<TPending extends boolean = boolean> = TransactionBase<bigint, number, TPending> & FeeValuesEIP1559 & {
-    isSystemTx?: boolean;
-    mint?: bigint;
-    sourceHash: Hex;
-    type: 'deposit';
-};
-export type OptimismTransaction<TPending extends boolean = boolean> = Transaction<TPending> | OptimismDepositTransaction<TPending>;
-export type OptimismTransactionReceiptOverrides = {
-    l1GasPrice: bigint | null;
-    l1GasUsed: bigint | null;
-    l1Fee: bigint | null;
-    l1FeeScalar: number | null;
-};
-export type OptimismTransactionReceipt = TransactionReceipt & OptimismTransactionReceiptOverrides;
-export {};
-//# sourceMappingURL=types.d.ts.map

package/_types/chains/optimism/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../chains/optimism/types.ts"],"names":[],"mappings":"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"}

package/chains/optimism/types.ts

@@ -1,102 +0,0 @@
-import type { Block, BlockTag } from '../../types/block.js'
-import type { FeeValuesEIP1559 } from '../../types/fee.js'
-import type { Hash, Hex } from '../../types/misc.js'
-import type {
-  Index,
-  Quantity,
-  RpcBlock,
-  RpcTransaction as RpcTransaction_,
-  RpcTransactionReceipt,
-} from '../../types/rpc.js'
-import type {
-  Transaction as Transaction_,
-  TransactionBase,
-  TransactionReceipt,
-} from '../../types/transaction.js'
-
-export type OptimismBlockOverrides = {
-  stateRoot: Hash
-}
-export type OptimismBlock<
-  TIncludeTransactions extends boolean = boolean,
-  TBlockTag extends BlockTag = BlockTag,
-> = Block<
-  bigint,
-  TIncludeTransactions,
-  TBlockTag,
-  OptimismTransaction<TBlockTag extends 'pending' ? true : false>
-> &
-  OptimismBlockOverrides
-
-export type OptimismRpcBlockOverrides = {
-  stateRoot: Hash
-}
-export type OptimismRpcBlock<
-  TBlockTag extends BlockTag = BlockTag,
-  TIncludeTransactions extends boolean = boolean,
-> = RpcBlock<
-  TBlockTag,
-  TIncludeTransactions,
-  OptimismRpcTransaction<TBlockTag extends 'pending' ? true : false>
-> &
-  OptimismRpcBlockOverrides
-
-type RpcTransaction<TPending extends boolean = boolean> =
-  RpcTransaction_<TPending> & {
-    isSystemTx?: undefined
-    mint?: undefined
-    sourceHash?: undefined
-  }
-
-export type OptimismRpcDepositTransaction<TPending extends boolean = boolean> =
-  Omit<TransactionBase<Quantity, Index, TPending>, 'typeHex'> &
-    FeeValuesEIP1559<Quantity> & {
-      isSystemTx?: boolean
-      mint?: Hex
-      sourceHash: Hex
-      type: '0x7e'
-    }
-export type OptimismRpcTransaction<TPending extends boolean = boolean> =
-  | RpcTransaction<TPending>
-  | OptimismRpcDepositTransaction<TPending>
-
-export type OptimismRpcTransactionReceiptOverrides = {
-  l1GasPrice: Hex | null
-  l1GasUsed: Hex | null
-  l1Fee: Hex | null
-  l1FeeScalar: `${number}` | null
-}
-export type OptimismRpcTransactionReceipt = RpcTransactionReceipt &
-  OptimismRpcTransactionReceiptOverrides
-
-type Transaction<TPending extends boolean = boolean> = Transaction_<
-  bigint,
-  number,
-  TPending
-> & {
-  isSystemTx?: undefined
-  mint?: undefined
-  sourceHash?: undefined
-}
-
-export type OptimismDepositTransaction<TPending extends boolean = boolean> =
-  TransactionBase<bigint, number, TPending> &
-    FeeValuesEIP1559 & {
-      isSystemTx?: boolean
-      mint?: bigint
-      sourceHash: Hex
-      type: 'deposit'
-    }
-
-export type OptimismTransaction<TPending extends boolean = boolean> =
-  | Transaction<TPending>
-  | OptimismDepositTransaction<TPending>
-
-export type OptimismTransactionReceiptOverrides = {
-  l1GasPrice: bigint | null
-  l1GasUsed: bigint | null
-  l1Fee: bigint | null
-  l1FeeScalar: number | null
-}
-export type OptimismTransactionReceipt = TransactionReceipt &
-  OptimismTransactionReceiptOverrides