@0xsequence/wallet-primitives 3.0.0-beta.9 → 3.0.1

package/src/network.ts

@@ -1,3 +1,8 @@
+import { Address } from 'ox'
+
+const DEFAULT_MULTICALL3_ADDRESS: Address.Address = '0xcA11bde05977b3631167028862bE2a173976CA11'
+const SEQUENCE_MULTICALL3_ADDRESS: Address.Address = '0xae96419a81516f063744206d4b5E36f3168280f8'
+
 export enum NetworkType {
   MAINNET = 'mainnet',
   TESTNET = 'testnet',
@@ -21,8 +26,11 @@ export interface Network {
     name: string
     decimals: number
   }
-  ensAddress?: string
   deprecated?: true
+  contracts?: {
+    multicall3?: Address.Address
+    ensUniversalResolver?: Address.Address
+  }
 }
 
 export const ChainId = {
@@ -105,6 +113,7 @@ export const ChainId = {
   // ETHERLINK
   ETHERLINK: 42793,
   ETHERLINK_TESTNET: 128123,
+  ETHERLINK_SHADOWNET_TESTNET: 127823,
 
   // MOONBEAM
   MOONBEAM: 1284,
@@ -119,6 +128,7 @@ export const ChainId = {
   SOMNIA: 5031,
 
   // INCENTIV
+  INCENTIV: 24101,
   INCENTIV_TESTNET_V2: 28802,
 
   // KATANA
@@ -129,6 +139,15 @@ export const ChainId = {
 
   // ARC
   ARC_TESTNET: 5042002,
+
+  // HYPEREVM
+  HYPEREVM: 999,
+
+  // SONIC
+  SONIC: 146,
+
+  // BERACHAIN
+  BERACHAIN: 80094,
 } as const
 
 export type ChainId = (typeof ChainId)[keyof typeof ChainId]
@@ -150,7 +169,10 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
-    ensAddress: '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e',
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+      ensUniversalResolver: '0x00000000000C2E074eC69A0dFb2997BA6C7d2e1e',
+    },
   },
   {
     chainId: ChainId.SEPOLIA,
@@ -168,6 +190,9 @@ export const ALL: Network[] = [
       name: 'Sepolia Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.POLYGON,
@@ -185,6 +210,9 @@ export const ALL: Network[] = [
       name: 'POL',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.POLYGON_AMOY,
@@ -202,6 +230,9 @@ export const ALL: Network[] = [
       name: 'Amoy POL',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.POLYGON_ZKEVM,
@@ -219,6 +250,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.BSC,
@@ -236,6 +270,9 @@ export const ALL: Network[] = [
       name: 'BNB',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.BSC_TESTNET,
@@ -253,6 +290,9 @@ export const ALL: Network[] = [
       name: 'Testnet BNB',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.OPTIMISM,
@@ -270,6 +310,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.OPTIMISM_SEPOLIA,
@@ -287,6 +330,9 @@ export const ALL: Network[] = [
       name: 'Sepolia Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.ARBITRUM,
@@ -304,6 +350,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.ARBITRUM_SEPOLIA,
@@ -321,6 +370,9 @@ export const ALL: Network[] = [
       name: 'Sepolia Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.ARBITRUM_NOVA,
@@ -338,6 +390,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.AVALANCHE,
@@ -355,6 +410,9 @@ export const ALL: Network[] = [
       name: 'AVAX',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.AVALANCHE_TESTNET,
@@ -372,6 +430,9 @@ export const ALL: Network[] = [
       name: 'Testnet AVAX',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.GNOSIS,
@@ -389,12 +450,15 @@ export const ALL: Network[] = [
       name: 'XDAI',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.BASE,
     type: NetworkType.MAINNET,
     name: 'base',
-    title: 'Base (Coinbase)',
+    title: 'Base',
     rpcUrl: getRpcUrl('base'),
     logoUrl: getLogoUrl(ChainId.BASE),
     blockExplorer: {
@@ -406,6 +470,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.BASE_SEPOLIA,
@@ -423,6 +490,9 @@ export const ALL: Network[] = [
       name: 'Sepolia Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.HOMEVERSE,
@@ -440,6 +510,9 @@ export const ALL: Network[] = [
       name: 'OAS',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.HOMEVERSE_TESTNET,
@@ -457,6 +530,9 @@ export const ALL: Network[] = [
       name: 'Testnet OAS',
       decimals: 18,
     },
+    contracts: {
+      multicall3: SEQUENCE_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.XAI,
@@ -474,6 +550,9 @@ export const ALL: Network[] = [
       name: 'XAI',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.XAI_SEPOLIA,
@@ -491,6 +570,9 @@ export const ALL: Network[] = [
       name: 'Sepolia XAI',
       decimals: 18,
     },
+    contracts: {
+      multicall3: SEQUENCE_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.B3,
@@ -508,6 +590,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.B3_SEPOLIA,
@@ -525,6 +610,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.APECHAIN,
@@ -542,6 +630,9 @@ export const ALL: Network[] = [
       name: 'ApeCoin',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.APECHAIN_TESTNET,
@@ -559,6 +650,9 @@ export const ALL: Network[] = [
       name: 'ApeCoin',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.BLAST,
@@ -576,6 +670,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.BLAST_SEPOLIA,
@@ -593,6 +690,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.TELOS,
@@ -610,6 +710,9 @@ export const ALL: Network[] = [
       name: 'TLOS',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.TELOS_TESTNET,
@@ -627,6 +730,9 @@ export const ALL: Network[] = [
       name: 'TLOS',
       decimals: 18,
     },
+    contracts: {
+      multicall3: SEQUENCE_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.SKALE_NEBULA,
@@ -644,6 +750,9 @@ export const ALL: Network[] = [
       name: 'SKALE Fuel',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.SKALE_NEBULA_TESTNET,
@@ -661,6 +770,9 @@ export const ALL: Network[] = [
       name: 'SKALE Fuel',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.SONEIUM,
@@ -678,6 +790,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.SONEIUM_MINATO,
@@ -695,6 +810,9 @@ export const ALL: Network[] = [
       name: 'Ether',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.TOY_TESTNET,
@@ -712,6 +830,9 @@ export const ALL: Network[] = [
       name: 'TOY',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.IMMUTABLE_ZKEVM,
@@ -729,6 +850,9 @@ export const ALL: Network[] = [
       name: 'IMX',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.IMMUTABLE_ZKEVM_TESTNET,
@@ -746,6 +870,9 @@ export const ALL: Network[] = [
       name: 'IMX',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.MOONBEAM,
@@ -763,6 +890,9 @@ export const ALL: Network[] = [
       name: 'GLMR',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.MOONBASE_ALPHA,
@@ -780,6 +910,9 @@ export const ALL: Network[] = [
       name: 'GLMR',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.ETHERLINK,
@@ -797,23 +930,29 @@ export const ALL: Network[] = [
       name: 'Tez',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
-    chainId: ChainId.ETHERLINK_TESTNET,
+    chainId: ChainId.ETHERLINK_SHADOWNET_TESTNET,
     type: NetworkType.TESTNET,
-    name: 'etherlink-testnet',
-    title: 'Etherlink Testnet',
-    rpcUrl: getRpcUrl('etherlink-testnet'),
-    logoUrl: getLogoUrl(ChainId.ETHERLINK_TESTNET),
+    name: 'etherlink-shadownet-testnet',
+    title: 'Etherlink Shadownet Testnet',
+    rpcUrl: getRpcUrl('etherlink-shadownet-testnet'),
+    logoUrl: getLogoUrl(ChainId.ETHERLINK_SHADOWNET_TESTNET),
     blockExplorer: {
-      name: 'Etherlink Testnet Explorer',
-      url: 'https://testnet.explorer.etherlink.com/',
+      name: 'Etherlink Shadownet Testnet Explorer',
+      url: 'https://shadownet.explorer.etherlink.com/',
     },
     nativeCurrency: {
       symbol: 'XTZ',
       name: 'Tez',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.MONAD,
@@ -831,6 +970,9 @@ export const ALL: Network[] = [
       name: 'MON',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
   {
     chainId: ChainId.MONAD_TESTNET,
@@ -848,6 +990,9 @@ export const ALL: Network[] = [
       name: 'MON',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
 
   {
@@ -866,6 +1011,9 @@ export const ALL: Network[] = [
       name: 'SOMI',
       decimals: 18,
     },
+    contracts: {
+      multicall3: SEQUENCE_MULTICALL3_ADDRESS,
+    },
   },
 
   {
@@ -884,6 +1032,30 @@ export const ALL: Network[] = [
       name: 'STT',
       decimals: 18,
     },
+    contracts: {
+      multicall3: SEQUENCE_MULTICALL3_ADDRESS,
+    },
+  },
+
+  {
+    chainId: ChainId.INCENTIV,
+    type: NetworkType.MAINNET,
+    name: 'incentiv',
+    title: 'Incentiv',
+    rpcUrl: getRpcUrl('incentiv'),
+    logoUrl: getLogoUrl(ChainId.INCENTIV),
+    blockExplorer: {
+      name: 'Incentiv Explorer',
+      url: 'https://explorer.incentiv.io/',
+    },
+    nativeCurrency: {
+      symbol: 'CENT',
+      name: 'CENT',
+      decimals: 18,
+    },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
 
   {
@@ -902,6 +1074,9 @@ export const ALL: Network[] = [
       name: 'TCENT',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
 
   {
@@ -920,6 +1095,9 @@ export const ALL: Network[] = [
       name: 'ETH',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
 
   {
@@ -938,6 +1116,9 @@ export const ALL: Network[] = [
       name: 'SAND',
       decimals: 18,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
   },
 
   {
@@ -956,6 +1137,63 @@ export const ALL: Network[] = [
       name: 'USDC',
       decimals: 6,
     },
+    contracts: {
+      multicall3: DEFAULT_MULTICALL3_ADDRESS,
+    },
+  },
+
+  {
+    chainId: ChainId.HYPEREVM,
+    type: NetworkType.MAINNET,
+    name: 'hyperevm',
+    title: 'HyperEVM',
+    rpcUrl: getRpcUrl('hyperevm'),
+    logoUrl: getLogoUrl(ChainId.HYPEREVM),
+    blockExplorer: {
+      name: 'HyperEVM Explorer',
+      url: 'https://www.hyperscan.com/',
+    },
+    nativeCurrency: {
+      symbol: 'HYPE',
+      name: 'HYPE',
+      decimals: 18,
+    },
+  },
+
+  {
+    chainId: ChainId.BERACHAIN,
+    type: NetworkType.MAINNET,
+    name: 'berachain',
+    title: 'Berachain',
+    rpcUrl: getRpcUrl('berachain'),
+    logoUrl: getLogoUrl(ChainId.BERACHAIN),
+    blockExplorer: {
+      name: 'Berachain Explorer',
+      url: 'https://berascan.com/',
+    },
+    nativeCurrency: {
+      symbol: 'BEAR',
+      name: 'BEAR',
+      decimals: 18,
+    },
+  },
+
+  {
+    chainId: ChainId.SONIC,
+    type: NetworkType.MAINNET,
+    name: 'sonic',
+    title: 'Sonic',
+    rpcUrl: getRpcUrl('sonic'),
+    logoUrl: getLogoUrl(ChainId.SONIC),
+    blockExplorer: {
+      name: 'Sonic Explorer',
+      url: 'https://sonicscan.com/',
+    },
+    nativeCurrency: {
+      symbol: 'S',
+      name: 'Sonic',
+      decimals: 18,
+    },
   },
 ]
 

package/src/payload.ts

@@ -1,7 +1,7 @@
 import { AbiFunction, AbiParameters, Address, Bytes, Hash, Hex } from 'ox'
 import { getSignPayload } from 'ox/TypedData'
 import { EXECUTE_USER_OP, RECOVER_SAPIENT_SIGNATURE } from './constants.js'
-import { Attestation, Network } from './index.js'
+import { Attestation } from './index.js'
 import { minBytesFor } from './utils.js'
 import { UserOperation } from 'ox/erc4337'
 

package/src/signature.ts

@@ -1,4 +1,4 @@
-import { AbiFunction, AbiParameters, Address, Bytes, Hash, Hex, Provider, Secp256k1, Signature } from 'ox'
+import { AbiFunction, AbiParameters, Address, Bytes, Hash, Hex, Provider, Secp256k1 } from 'ox'
 import {
   Config,
   Leaf,
@@ -22,7 +22,7 @@ import { RECOVER_SAPIENT_SIGNATURE, RECOVER_SAPIENT_SIGNATURE_COMPACT, IS_VALID_
 import { wrap, decode } from './erc-6492.js'
 import { fromConfigUpdate, hash, Parented } from './payload.js'
 import { minBytesFor, packRSY, unpackRSY } from './utils.js'
-import { Constants, Network } from './index.js'
+import { Constants } from './index.js'
 
 export const FLAG_SIGNATURE_HASH = 0
 export const FLAG_ADDRESS = 1
@@ -618,7 +618,7 @@ export function fillLeaves(
 export function encodeChainedSignature(signatures: RawSignature[]): Uint8Array {
   let flag = 0x01
 
-  let sigForCheckpointer = signatures[signatures.length - 1]
+  const sigForCheckpointer = signatures[signatures.length - 1]
 
   if (sigForCheckpointer?.configuration.checkpointer) {
     flag |= 0x40
@@ -723,7 +723,7 @@ export function encodeTopology(
     const isBranching = isNode(topology[1]!) || isRawNode(topology[1]!)
 
     if (isBranching) {
-      let encoded1Size = minBytesFor(BigInt(encoded1.length))
+      const encoded1Size = minBytesFor(BigInt(encoded1.length))
       if (encoded1Size > 15) {
         throw new Error('Branch too large')
       }
@@ -799,7 +799,7 @@ export function encodeTopology(
     } else if (topology.signature.type === 'erc1271') {
       let flag = FLAG_SIGNATURE_ERC1271 << 4
 
-      let bytesForSignatureSize = minBytesFor(BigInt(topology.signature.data.length))
+      const bytesForSignatureSize = minBytesFor(BigInt(topology.signature.data.length))
       if (bytesForSignatureSize > 3) {
         throw new Error('Signature too large')
       }
@@ -826,7 +826,7 @@ export function encodeTopology(
       let flag = (topology.signature.type === 'sapient' ? FLAG_SIGNATURE_SAPIENT : FLAG_SIGNATURE_SAPIENT_COMPACT) << 4
 
       const signatureBytes = Bytes.fromHex(topology.signature.data)
-      let bytesForSignatureSize = minBytesFor(BigInt(signatureBytes.length))
+      const bytesForSignatureSize = minBytesFor(BigInt(signatureBytes.length))
       if (bytesForSignatureSize > 3) {
         throw new Error('Signature too large')
       }
@@ -1218,7 +1218,7 @@ async function recoverTopology(
               weight: topology.weight,
             }
 
-          default:
+          default: {
             const provider = 'provider' in options!.provider ? options!.provider.provider : options!.provider
             const block = 'block' in options!.provider ? options!.provider.block : undefined
 
@@ -1254,6 +1254,7 @@ async function recoverTopology(
                 }
               }
             }
+          }
         }
 
       case 'sapient':
@@ -1264,7 +1265,7 @@ async function recoverTopology(
           case 'assume-valid':
             throw new Error(`unable to validate sapient signer ${topology.signature.address} signature`)
 
-          default:
+          default: {
             const provider = 'provider' in options!.provider ? options!.provider.provider : options!.provider
             const block = 'block' in options!.provider ? options!.provider.block : undefined
 
@@ -1298,6 +1299,7 @@ async function recoverTopology(
               },
               weight: topology.weight,
             }
+          }
         }
     }
   } else if (isRawNestedLeaf(topology)) {

package/src/utils.ts

@@ -1,4 +1,4 @@
-import { AbiParameters, Bytes, Hash, Hex } from 'ox'
+import { Bytes } from 'ox'
 
 export function minBytesFor(val: bigint): number {
   return Math.ceil(val.toString(16).length / 2)
@@ -7,7 +7,7 @@ export function minBytesFor(val: bigint): number {
 // ERC-2098
 export function packRSY({ r, s, yParity }: { r: bigint; s: bigint; yParity: number }): Bytes.Bytes {
   const rBytes = Bytes.padLeft(Bytes.fromNumber(r), 32)
-  let sBytes = Bytes.padLeft(Bytes.fromNumber(s), 32)
+  const sBytes = Bytes.padLeft(Bytes.fromNumber(s), 32)
   if (yParity % 2 === 1) {
     sBytes[0]! |= 0x80
   }