viem 1.14.0 → 1.15.0

package/chains/definitions/fuse.ts

@@ -7,9 +7,15 @@ export const fuse = /*#__PURE__*/ defineChain({
   nativeCurrency: { name: 'Fuse', symbol: 'FUSE', decimals: 18 },
   rpcUrls: {
     default: { http: ['https://rpc.fuse.io'] },
-    public: { http: ['https://fuse-mainnet.chainstacklabs.com'] },
+    public: { http: ['https://rpc.fuse.io'] },
   },
   blockExplorers: {
     default: { name: 'Fuse Explorer', url: 'https://explorer.fuse.io' },
   },
+  contracts: {
+    multicall3: {
+      address: '0xca11bde05977b3631167028862be2a173976ca11',
+      blockCreated: 16146628,
+    },
+  },
 })

package/chains/index.ts

@@ -3,6 +3,7 @@ export type { Chain } from '../types/chain.js'
 export { arbitrum } from './definitions/arbitrum.js'
 export { arbitrumGoerli } from './definitions/arbitrumGoerli.js'
 export { arbitrumNova } from './definitions/arbitrumNova.js'
+export { arbitrumSepolia } from './definitions/arbitrumSepolia.js'
 export { aurora } from './definitions/aurora.js'
 export { auroraTestnet } from './definitions/auroraTestnet.js'
 export { avalanche } from './definitions/avalanche.js'

package/errors/version.ts

@@ -1 +1 @@
-export const version = '1.13.2'
+export const version = '1.15.0'

package/index.ts

@@ -886,6 +886,7 @@ export type {
   Hex,
   LogTopic,
   Signature,
+  CompactSignature,
   SignableMessage,
 } from './types/misc.js'
 export type { GetChain } from './types/chain.js'
@@ -1077,6 +1078,14 @@ export {
   hashDomain,
   hashTypedData,
 } from './utils/signature/hashTypedData.js'
+export {
+  type CompactSignatureToSignatureErrorType,
+  compactSignatureToSignature,
+} from './utils/signature/compactSignatureToSignature.js'
+export {
+  type HexToCompactSignatureErrorType,
+  hexToCompactSignature,
+} from './utils/signature/hexToCompactSignature.js'
 export {
   type HexToSignatureErrorType,
   hexToSignature,
@@ -1105,6 +1114,14 @@ export {
   type RecoverTypedDataAddressReturnType,
   recoverTypedDataAddress,
 } from './utils/signature/recoverTypedDataAddress.js'
+export {
+  type SignatureToCompactSignatureErrorType,
+  signatureToCompactSignature,
+} from './utils/signature/signatureToCompactSignature.js'
+export {
+  type CompactSignatureToHexErrorType,
+  compactSignatureToHex,
+} from './utils/signature/compactSignatureToHex.js'
 export {
   type SignatureToHexErrorType,
   signatureToHex,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "viem",
   "description": "TypeScript Interface for Ethereum",
-  "version": "1.14.0",
+  "version": "1.15.0",
   "type": "module",
   "main": "./_cjs/index.js",
   "module": "./_esm/index.js",
@@ -86,42 +86,18 @@
   },
   "typesVersions": {
     "*": {
-      "abi": [
-        "./_types/abi/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/index.d.ts"
-      ],
-      "contract": [
-        "./_types/contract/index.d.ts"
-      ],
-      "ens": [
-        "./_types/ens/index.d.ts"
-      ],
-      "public": [
-        "./_types/public/index.d.ts"
-      ],
-      "test": [
-        "./_types/test/index.d.ts"
-      ],
-      "utils": [
-        "./_types/utils/index.d.ts"
-      ],
-      "wallet": [
-        "./_types/wallet/index.d.ts"
-      ],
-      "window": [
-        "./_types/window/index.d.ts"
-      ]
+      "abi": ["./_types/abi/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/index.d.ts"],
+      "contract": ["./_types/contract/index.d.ts"],
+      "ens": ["./_types/ens/index.d.ts"],
+      "public": ["./_types/public/index.d.ts"],
+      "test": ["./_types/test/index.d.ts"],
+      "utils": ["./_types/utils/index.d.ts"],
+      "wallet": ["./_types/wallet/index.d.ts"],
+      "window": ["./_types/window/index.d.ts"]
     }
   },
   "peerDependencies": {
@@ -145,21 +121,12 @@
   },
   "license": "MIT",
   "repository": "wagmi-dev/viem",
-  "authors": [
-    "awkweb.eth",
-    "jxom.eth"
-  ],
+  "authors": ["awkweb.eth", "jxom.eth"],
   "funding": [
     {
       "type": "github",
       "url": "https://github.com/sponsors/wagmi-dev"
     }
   ],
-  "keywords": [
-    "eth",
-    "ethereum",
-    "dapps",
-    "wallet",
-    "web3"
-  ]
+  "keywords": ["eth", "ethereum", "dapps", "wallet", "web3"]
 }

package/types/misc.ts

@@ -16,3 +16,9 @@ export type Signature = {
   // TODO(v2): `v` to `recovery`
   v: bigint
 }
+export type CompactSignature = {
+  // TODO(v2): Make `bigint`
+  r: Hex
+  // TODO(v2): Make `bigint`
+  yParityAndS: Hex
+}

package/utils/signature/compactSignatureToHex.ts

@@ -0,0 +1,29 @@
+import { secp256k1 } from '@noble/curves/secp256k1'
+import type { ErrorType } from '../../errors/utils.js'
+import type { CompactSignature, Hex } from '../../types/misc.js'
+import { type HexToBigIntErrorType, hexToBigInt } from '../encoding/fromHex.js'
+
+export type CompactSignatureToHexErrorType = HexToBigIntErrorType | ErrorType
+
+/**
+ * @description Converts an [EIP-2098 compact signature](https://eips.ethereum.org/EIPS/eip-2098) into hex format.
+ *
+ * @param signature The compact signature to convert.
+ * @returns The compact signature in hex format.
+ *
+ * @example
+ * compactSignatureToHex({
+ *   r: '0x68a020a209d3d56c46f38cc50a33f704f4a9a10a59377f8dd762ac66910e9b90',
+ *   yParityAndS: '0x7e865ad05c4035ab5792787d4a0297a43617ae897930a6fe4d822b8faea52064',
+ * })
+ * // "0x6e100a352ec6ad1b70802290e18aeed190704973570f3b8ed42cb9808e2ea6bf4a90a229a244495b41890987806fcbd2d5d23fc0dbe5f5256c2613c039d76db81c"
+ */
+export function compactSignatureToHex({
+  r,
+  yParityAndS,
+}: CompactSignature): Hex {
+  return `0x${new secp256k1.Signature(
+    hexToBigInt(r),
+    hexToBigInt(yParityAndS),
+  ).toCompactHex()}`
+}

package/utils/signature/compactSignatureToSignature.ts

@@ -0,0 +1,37 @@
+import type { ErrorType } from '../../errors/utils.js'
+import type { CompactSignature, Signature } from '../../types/misc.js'
+import { type HexToBytesErrorType, hexToBytes } from '../encoding/toBytes.js'
+import { type BytesToHexErrorType, bytesToHex } from '../encoding/toHex.js'
+
+export type CompactSignatureToSignatureErrorType =
+  | BytesToHexErrorType
+  | HexToBytesErrorType
+  | ErrorType
+
+/**
+ * @description Converts an [EIP-2098 compact signature](https://eips.ethereum.org/EIPS/eip-2098) into signature format.
+ *
+ * @param signature The compact signature to convert.
+ * @returns The compact signature in signature format.
+ *
+ * @example
+ * compactSignatureToHex({
+ *   r: '0x68a020a209d3d56c46f38cc50a33f704f4a9a10a59377f8dd762ac66910e9b90',
+ *   yParityAndS: '0x7e865ad05c4035ab5792787d4a0297a43617ae897930a6fe4d822b8faea52064',
+ * })
+ * // {
+ * //   r: '0x68a020a209d3d56c46f38cc50a33f704f4a9a10a59377f8dd762ac66910e9b90',
+ * //   s: '0x7e865ad05c4035ab5792787d4a0297a43617ae897930a6fe4d822b8faea52064',
+ * //   v: 27n
+ * // }
+ */
+export function compactSignatureToSignature({
+  r,
+  yParityAndS,
+}: CompactSignature): Signature {
+  const yParityAndS_bytes = hexToBytes(yParityAndS)
+  const v = yParityAndS_bytes[0] & 0x80 ? 28n : 27n
+  const s = yParityAndS_bytes
+  if (v === 28n) s[0] &= 0x7f
+  return { r, s: bytesToHex(s), v }
+}

package/utils/signature/hexToCompactSignature.ts

@@ -0,0 +1,28 @@
+import { secp256k1 } from '@noble/curves/secp256k1'
+
+import type { ErrorType } from '../../errors/utils.js'
+import type { CompactSignature, Hex } from '../../types/misc.js'
+import {
+  type NumberToHexErrorType,
+  numberToHex,
+} from '../../utils/encoding/toHex.js'
+
+export type HexToCompactSignatureErrorType = NumberToHexErrorType | ErrorType
+
+/**
+ * @description Parses a hex formatted compact signature into a structured compact signature.
+ *
+ * @param signatureHex Signature in hex format.
+ * @returns The structured signature.
+ *
+ * @example
+ * hexToCompactSignature('0x6e100a352ec6ad1b70802290e18aeed190704973570f3b8ed42cb9808e2ea6bf4a90a229a244495b41890987806fcbd2d5d23fc0dbe5f5256c2613c039d76db81c')
+ * // { r: '0x...', yParityAndS: '0x...' }
+ */
+export function hexToCompactSignature(signatureHex: Hex): CompactSignature {
+  const { r, s } = secp256k1.Signature.fromCompact(signatureHex.slice(2, 130))
+  return {
+    r: numberToHex(r, { size: 32 }),
+    yParityAndS: numberToHex(s, { size: 32 }),
+  }
+}

package/utils/signature/signatureToCompactSignature.ts

@@ -0,0 +1,44 @@
+import type { ErrorType } from '../../errors/utils.js'
+import type { CompactSignature, Signature } from '../../types/misc.js'
+import {
+  type BytesToHexErrorType,
+  type HexToBytesErrorType,
+  bytesToHex,
+  hexToBytes,
+} from '../index.js'
+
+export type SignatureToCompactSignatureErrorType =
+  | HexToBytesErrorType
+  | BytesToHexErrorType
+  | ErrorType
+
+/**
+ * @description Converts a signature into an [EIP-2098 compact signature](https://eips.ethereum.org/EIPS/eip-2098).
+ *
+ * @param signature The signature to convert.
+ * @returns The signature in compact format.
+ *
+ * @example
+ * signatureToCompactSignature({
+ *   r: '0x68a020a209d3d56c46f38cc50a33f704f4a9a10a59377f8dd762ac66910e9b90',
+ *   s: '0x7e865ad05c4035ab5792787d4a0297a43617ae897930a6fe4d822b8faea52064',
+ *   v: 27n
+ * })
+ * // {
+ * //   r: '0x68a020a209d3d56c46f38cc50a33f704f4a9a10a59377f8dd762ac66910e9b90',
+ * //   yParityAndS: '0x7e865ad05c4035ab5792787d4a0297a43617ae897930a6fe4d822b8faea52064'
+ * // }
+ */
+export function signatureToCompactSignature(
+  signature: Signature,
+): CompactSignature {
+  const { r, s, v } = signature
+  const yParity = v - 27n
+  let yParityAndS = s
+  if (yParity === 1n) {
+    const bytes = hexToBytes(s)
+    bytes[0] |= 0x80
+    yParityAndS = bytesToHex(bytes)
+  }
+  return { r, yParityAndS }
+}