From b6f21a9907cd04b9044c5d904768f8f445e19b1a Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Tue, 17 Jun 2025 11:39:01 -0400
Subject: [PATCH 01/54] prototype

---
 packages/core/solidity/src/contract.ts        |  2 +-
 packages/core/solidity/src/custom.ts          | 41 ++++++++++++++++++-
 packages/core/solidity/src/generate/custom.ts |  1 +
 .../ui/src/solidity/CustomControls.svelte     |  5 +++
 4 files changed, 46 insertions(+), 3 deletions(-)

diff --git a/packages/core/solidity/src/contract.ts b/packages/core/solidity/src/contract.ts
index 6ed276124..bf0f1b0a9 100644
--- a/packages/core/solidity/src/contract.ts
+++ b/packages/core/solidity/src/contract.ts
@@ -52,7 +52,7 @@ export interface ContractFunction extends BaseFunction {
   comments: string[];
 }
 
-export type FunctionKind = 'internal' | 'public';
+export type FunctionKind = 'internal' | 'public' | 'external';
 export type FunctionMutability = (typeof mutabilityRank)[number];
 
 // Order is important
diff --git a/packages/core/solidity/src/custom.ts b/packages/core/solidity/src/custom.ts
index 5baaf31b5..4ff7fec12 100644
--- a/packages/core/solidity/src/custom.ts
+++ b/packages/core/solidity/src/custom.ts
@@ -1,20 +1,23 @@
-import type { Contract } from './contract';
+import type { BaseFunction, Contract } from './contract';
 import { ContractBuilder } from './contract';
 import type { CommonOptions } from './common-options';
 import { withCommonDefaults, defaults as commonDefaults } from './common-options';
 import { setUpgradeable } from './set-upgradeable';
 import { setInfo } from './set-info';
-import { setAccessControl } from './set-access-control';
+import { Access, requireAccessControl, setAccessControl } from './set-access-control';
 import { addPausable } from './add-pausable';
 import { printContract } from './print';
+import { defineFunctions } from './utils/define-functions';
 
 export interface CustomOptions extends CommonOptions {
   name: string;
+  superchainInteropFunction?: string;
   pausable?: boolean;
 }
 
 export const defaults: Required<CustomOptions> = {
   name: 'MyContract',
+  superchainInteropFunction: '',
   pausable: false,
   access: commonDefaults.access,
   upgradeable: commonDefaults.upgradeable,
@@ -25,6 +28,7 @@ function withDefaults(opts: CustomOptions): Required<CustomOptions> {
   return {
     ...opts,
     ...withCommonDefaults(opts),
+    superchainInteropFunction: opts.superchainInteropFunction ?? defaults.superchainInteropFunction,
     pausable: opts.pausable ?? defaults.pausable,
   };
 }
@@ -44,6 +48,10 @@ export function buildCustom(opts: CustomOptions): Contract {
 
   const { access, upgradeable, info } = allOpts;
 
+  if (allOpts.superchainInteropFunction) {
+    addSuperchainInterop(c, allOpts.superchainInteropFunction, allOpts.access, allOpts.pausable);
+  }
+
   if (allOpts.pausable) {
     addPausable(c, access, []);
   }
@@ -54,3 +62,32 @@ export function buildCustom(opts: CustomOptions): Contract {
 
   return c;
 }
+
+function addSuperchainInterop(c: ContractBuilder, superchainInteropFunction: string, access: Access, pausable: boolean) {
+  // Add source function
+  const sourceFn: BaseFunction = {
+    name: `call${superchainInteropFunction.replace(/^(.)/i, c => c.toUpperCase())}`,
+    kind: 'public' as const,
+    args: [],
+  };
+
+  requireAccessControl(c, sourceFn, access, 'CROSS_CHAIN_CALLER', 'crossChainCaller');
+  c.addFunctionCode(
+    `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${superchainInteropFunction}, (/* TODO: Add arguments */)));`,
+    sourceFn,
+  );
+
+  // Add destination function
+  const destFn: BaseFunction = {
+    name: superchainInteropFunction,
+    kind: 'external' as const,
+    args: [],
+  };
+
+  if (pausable) {
+    c.addModifier('whenNotPaused', destFn);
+  }
+
+  c.addFunctionCode('// TODO: Implement logic for the function that will be called from another chain', destFn);
+}
+
diff --git a/packages/core/solidity/src/generate/custom.ts b/packages/core/solidity/src/generate/custom.ts
index 40207666a..cfc8fc239 100644
--- a/packages/core/solidity/src/generate/custom.ts
+++ b/packages/core/solidity/src/generate/custom.ts
@@ -8,6 +8,7 @@ const booleans = [true, false];
 
 const blueprint = {
   name: ['MyContract'],
+  superchainInteropFunction: ['', 'myFunction'],
   pausable: booleans,
   access: accessOptions,
   upgradeable: upgradeableOptions,
diff --git a/packages/ui/src/solidity/CustomControls.svelte b/packages/ui/src/solidity/CustomControls.svelte
index bb54fd2f5..109cc956d 100644
--- a/packages/ui/src/solidity/CustomControls.svelte
+++ b/packages/ui/src/solidity/CustomControls.svelte
@@ -29,6 +29,11 @@
 <section class="controls-section">
   <h1>Features</h1>
 
+  <label class="labeled-input">
+    <span>Superchain Interop Function</span>
+    <input bind:value={opts.superchainInteropFunction} />
+  </label>
+
   <div class="checkbox-group">
     <label class:checked={opts.pausable}>
       <input type="checkbox" bind:checked={opts.pausable} />

From 9f8d50bfa0a9fe297d16bc046cdaf5371234ee95 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Thu, 3 Jul 2025 17:39:04 -0400
Subject: [PATCH 02/54] Adjust look

---
 packages/ui/src/solidity/CustomControls.svelte | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/packages/ui/src/solidity/CustomControls.svelte b/packages/ui/src/solidity/CustomControls.svelte
index 109cc956d..c38ba4aa3 100644
--- a/packages/ui/src/solidity/CustomControls.svelte
+++ b/packages/ui/src/solidity/CustomControls.svelte
@@ -8,6 +8,8 @@
   import UpgradeabilitySection from './UpgradeabilitySection.svelte';
   import InfoSection from './InfoSection.svelte';
 
+  import OPIcon from '../common/icons/OPIcon.svelte';
+
   export let opts: Required<KindedOptions['Custom']> = {
     kind: 'Custom',
     ...custom.defaults,
@@ -27,12 +29,16 @@
 </section>
 
 <section class="controls-section">
-  <h1>Features</h1>
+  <div class="flex items-center"><h1>Cross-Chain Messaging</h1>&nbsp;<OPIcon /></div>
 
   <label class="labeled-input">
-    <span>Superchain Interop Function</span>
+    <span>Function Name</span>
     <input bind:value={opts.superchainInteropFunction} />
   </label>
+</section>
+
+<section class="controls-section">
+  <h1>Features</h1>
 
   <div class="checkbox-group">
     <label class:checked={opts.pausable}>

From 8bddafb64c2986cb5654984af68aceff245cb3cb Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Thu, 3 Jul 2025 18:10:39 -0400
Subject: [PATCH 03/54] Add placeholder checkbox

---
 packages/ui/src/solidity/CustomControls.svelte | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/packages/ui/src/solidity/CustomControls.svelte b/packages/ui/src/solidity/CustomControls.svelte
index c38ba4aa3..0b27047fd 100644
--- a/packages/ui/src/solidity/CustomControls.svelte
+++ b/packages/ui/src/solidity/CustomControls.svelte
@@ -29,7 +29,13 @@
 </section>
 
 <section class="controls-section">
-  <div class="flex items-center"><h1>Cross-Chain Messaging</h1>&nbsp;<OPIcon /></div>
+
+  <div class="flex items-center">
+    <span class="mr-2">
+      <input type="checkbox" />
+    </span>
+    <span class="flex items-center"><h1>Cross-Chain Messaging</h1>&nbsp;<OPIcon /></span>
+  </div>
 
   <label class="labeled-input">
     <span>Function Name</span>

From 9248727ed7d957ba0a196d06c0f01953ed3e02a0 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 14:41:18 -0400
Subject: [PATCH 04/54] Add separate options

---
 packages/core/solidity/src/custom.ts          | 24 ++++++++++++-------
 packages/core/solidity/src/generate/custom.ts |  5 ++--
 .../ui/src/solidity/CustomControls.svelte     |  7 ++++--
 3 files changed, 23 insertions(+), 13 deletions(-)

diff --git a/packages/core/solidity/src/custom.ts b/packages/core/solidity/src/custom.ts
index 4ff7fec12..a63762ae5 100644
--- a/packages/core/solidity/src/custom.ts
+++ b/packages/core/solidity/src/custom.ts
@@ -9,15 +9,20 @@ import { addPausable } from './add-pausable';
 import { printContract } from './print';
 import { defineFunctions } from './utils/define-functions';
 
+export const CrossChainMessagingOptions = [false, 'superchain'] as const;
+export type CrossChainMessaging = (typeof CrossChainMessagingOptions)[number];
+
 export interface CustomOptions extends CommonOptions {
   name: string;
-  superchainInteropFunction?: string;
+  crossChainMessaging?: CrossChainMessaging;
+  crossChainFunctionName?: string;
   pausable?: boolean;
 }
 
 export const defaults: Required<CustomOptions> = {
   name: 'MyContract',
-  superchainInteropFunction: '',
+  crossChainMessaging: false,
+  crossChainFunctionName: 'myFunction',
   pausable: false,
   access: commonDefaults.access,
   upgradeable: commonDefaults.upgradeable,
@@ -28,7 +33,8 @@ function withDefaults(opts: CustomOptions): Required<CustomOptions> {
   return {
     ...opts,
     ...withCommonDefaults(opts),
-    superchainInteropFunction: opts.superchainInteropFunction ?? defaults.superchainInteropFunction,
+    crossChainMessaging: opts.crossChainMessaging ?? defaults.crossChainMessaging,
+    crossChainFunctionName: opts.crossChainFunctionName?.length ? opts.crossChainFunctionName : defaults.crossChainFunctionName,
     pausable: opts.pausable ?? defaults.pausable,
   };
 }
@@ -48,8 +54,8 @@ export function buildCustom(opts: CustomOptions): Contract {
 
   const { access, upgradeable, info } = allOpts;
 
-  if (allOpts.superchainInteropFunction) {
-    addSuperchainInterop(c, allOpts.superchainInteropFunction, allOpts.access, allOpts.pausable);
+  if (allOpts.crossChainMessaging === 'superchain') {
+    addSuperchainInterop(c, allOpts.crossChainFunctionName, allOpts.access, allOpts.pausable);
   }
 
   if (allOpts.pausable) {
@@ -63,23 +69,23 @@ export function buildCustom(opts: CustomOptions): Contract {
   return c;
 }
 
-function addSuperchainInterop(c: ContractBuilder, superchainInteropFunction: string, access: Access, pausable: boolean) {
+function addSuperchainInterop(c: ContractBuilder, functionName: string, access: Access, pausable: boolean) {
   // Add source function
   const sourceFn: BaseFunction = {
-    name: `call${superchainInteropFunction.replace(/^(.)/i, c => c.toUpperCase())}`,
+    name: `call${functionName.replace(/^(.)/i, c => c.toUpperCase())}`,
     kind: 'public' as const,
     args: [],
   };
 
   requireAccessControl(c, sourceFn, access, 'CROSS_CHAIN_CALLER', 'crossChainCaller');
   c.addFunctionCode(
-    `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${superchainInteropFunction}, (/* TODO: Add arguments */)));`,
+    `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${functionName}, (/* TODO: Add arguments */)));`,
     sourceFn,
   );
 
   // Add destination function
   const destFn: BaseFunction = {
-    name: superchainInteropFunction,
+    name: functionName,
     kind: 'external' as const,
     args: [],
   };
diff --git a/packages/core/solidity/src/generate/custom.ts b/packages/core/solidity/src/generate/custom.ts
index cfc8fc239..54230a9ca 100644
--- a/packages/core/solidity/src/generate/custom.ts
+++ b/packages/core/solidity/src/generate/custom.ts
@@ -1,4 +1,4 @@
-import type { CustomOptions } from '../custom';
+import { CrossChainMessagingOptions, type CustomOptions } from '../custom';
 import { accessOptions } from '../set-access-control';
 import { infoOptions } from '../set-info';
 import { upgradeableOptions } from '../set-upgradeable';
@@ -8,7 +8,8 @@ const booleans = [true, false];
 
 const blueprint = {
   name: ['MyContract'],
-  superchainInteropFunction: ['', 'myFunction'],
+  crossChainMessaging: CrossChainMessagingOptions,
+  crossChainFunctionName: ['myFunction'],
   pausable: booleans,
   access: accessOptions,
   upgradeable: upgradeableOptions,
diff --git a/packages/ui/src/solidity/CustomControls.svelte b/packages/ui/src/solidity/CustomControls.svelte
index 0b27047fd..c18b57e32 100644
--- a/packages/ui/src/solidity/CustomControls.svelte
+++ b/packages/ui/src/solidity/CustomControls.svelte
@@ -16,6 +16,9 @@
     info: { ...infoDefaults }, // create new object since Info is nested
   };
 
+  let crossChainMessagingEnabled = false;
+  $: opts.crossChainMessaging = crossChainMessagingEnabled ? 'superchain' : false;
+
   $: requireAccessControl = custom.isAccessControlRequired(opts);
 </script>
 
@@ -32,14 +35,14 @@
 
   <div class="flex items-center">
     <span class="mr-2">
-      <input type="checkbox" />
+      <input type="checkbox" bind:checked={crossChainMessagingEnabled} />
     </span>
     <span class="flex items-center"><h1>Cross-Chain Messaging</h1>&nbsp;<OPIcon /></span>
   </div>
 
   <label class="labeled-input">
     <span>Function Name</span>
-    <input bind:value={opts.superchainInteropFunction} />
+    <input bind:value={opts.crossChainFunctionName} />
   </label>
 </section>
 

From 7a02121918a50796dc9cc3ba55830ef4504b7426 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 15:09:13 -0400
Subject: [PATCH 05/54] Use svelte component for crosschain messaging

---
 .../ui/src/common/ExpandableCheckbox.svelte   |  3 ++
 .../src/common/ParentExpandableSection.svelte |  6 +++-
 .../CrossChainMessagingSection.svelte         | 33 +++++++++++++++++++
 .../ui/src/solidity/CustomControls.svelte     | 21 ++----------
 4 files changed, 44 insertions(+), 19 deletions(-)
 create mode 100644 packages/ui/src/solidity/CrossChainMessagingSection.svelte

diff --git a/packages/ui/src/common/ExpandableCheckbox.svelte b/packages/ui/src/common/ExpandableCheckbox.svelte
index 6a164677d..ec7759413 100644
--- a/packages/ui/src/common/ExpandableCheckbox.svelte
+++ b/packages/ui/src/common/ExpandableCheckbox.svelte
@@ -1,8 +1,10 @@
 <script lang="ts">
   import ParentExpandableSection from './ParentExpandableSection.svelte';
+  import type { ComponentType } from 'svelte';
 
   export let label: string;
   export let checked: boolean;
+  export let icon: ComponentType | undefined = undefined;
 
   export let helpContent: string;
   export let helpLink: string | undefined = undefined;
@@ -19,6 +21,7 @@
   type="checkbox"
   {label}
   bind:checkboxChecked={checked}
+  {icon}
   {helpContent}
   {helpLink}
   {disabled}
diff --git a/packages/ui/src/common/ParentExpandableSection.svelte b/packages/ui/src/common/ParentExpandableSection.svelte
index bd1ce9d94..9cfb14598 100644
--- a/packages/ui/src/common/ParentExpandableSection.svelte
+++ b/packages/ui/src/common/ParentExpandableSection.svelte
@@ -12,11 +12,15 @@
   import ChevronRight from './icons/ChevronRight.svelte';
   import ChevronDown from './icons/ChevronDown.svelte';
 
+  import type { ComponentType } from 'svelte';
+
   export let label: string;
   export let type: 'checkbox' | 'toggleradio';
 
   export let checkboxChecked: boolean | undefined = undefined;
 
+  export let icon: ComponentType | undefined = undefined;
+
   export let toggleRadioValue: false | T | undefined = undefined;
   export let toggleRadioDefaultValue: T | undefined = undefined;
 
@@ -71,7 +75,7 @@
             />
           {/if}
         </span>
-        <span>{label}</span>
+        <span class="flex items-center">{label}{#if icon}&nbsp;&nbsp;<svelte:component this={icon}/>{/if}</span>
       </div>
       <div class="flex items-center">
         <button
diff --git a/packages/ui/src/solidity/CrossChainMessagingSection.svelte b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
new file mode 100644
index 000000000..f3fb54a20
--- /dev/null
+++ b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
@@ -0,0 +1,33 @@
+<script lang="ts">
+    import type { KindedOptions } from '@openzeppelin/wizard';
+    import HelpTooltip from '../common/HelpTooltip.svelte';
+    import ExpandableCheckbox from '../common/ExpandableCheckbox.svelte';
+    import OPIcon from '../common/icons/OPIcon.svelte';
+  
+    export let opts: KindedOptions['Custom'];
+
+    let crossChainMessagingEnabled = false;
+    $: opts.crossChainMessaging = crossChainMessagingEnabled ? 'superchain' : false;
+  </script>
+  
+  <ExpandableCheckbox
+    label="Cross-Chain Messaging"
+    icon={OPIcon}
+    bind:checked={crossChainMessagingEnabled}
+    helpContent="TODO"
+    helpLink="TODO"
+  >
+    <label class="labeled-input">
+      <span class="flex justify-between pr-2">
+        Function Name
+        <HelpTooltip>
+          The name of the function that will be callable from another chain.
+        </HelpTooltip>
+      </span>
+      <input
+        bind:value={opts.crossChainFunctionName}
+        disabled={!crossChainMessagingEnabled}
+      />
+    </label>
+  </ExpandableCheckbox>
+  
\ No newline at end of file
diff --git a/packages/ui/src/solidity/CustomControls.svelte b/packages/ui/src/solidity/CustomControls.svelte
index c18b57e32..8898313ed 100644
--- a/packages/ui/src/solidity/CustomControls.svelte
+++ b/packages/ui/src/solidity/CustomControls.svelte
@@ -7,8 +7,7 @@
   import AccessControlSection from './AccessControlSection.svelte';
   import UpgradeabilitySection from './UpgradeabilitySection.svelte';
   import InfoSection from './InfoSection.svelte';
-
-  import OPIcon from '../common/icons/OPIcon.svelte';
+  import CrossChainMessagingSection from './CrossChainMessagingSection.svelte';
 
   export let opts: Required<KindedOptions['Custom']> = {
     kind: 'Custom',
@@ -16,8 +15,7 @@
     info: { ...infoDefaults }, // create new object since Info is nested
   };
 
-  let crossChainMessagingEnabled = false;
-  $: opts.crossChainMessaging = crossChainMessagingEnabled ? 'superchain' : false;
+
 
   $: requireAccessControl = custom.isAccessControlRequired(opts);
 </script>
@@ -31,20 +29,7 @@
   </label>
 </section>
 
-<section class="controls-section">
-
-  <div class="flex items-center">
-    <span class="mr-2">
-      <input type="checkbox" bind:checked={crossChainMessagingEnabled} />
-    </span>
-    <span class="flex items-center"><h1>Cross-Chain Messaging</h1>&nbsp;<OPIcon /></span>
-  </div>
-
-  <label class="labeled-input">
-    <span>Function Name</span>
-    <input bind:value={opts.crossChainFunctionName} />
-  </label>
-</section>
+<CrossChainMessagingSection bind:opts={opts} />
 
 <section class="controls-section">
   <h1>Features</h1>

From ce336b972a2adafc6c570a5f617a919e42cb0270 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 15:16:09 -0400
Subject: [PATCH 06/54] Simplify options passing

---
 .../src/solidity/CrossChainMessagingSection.svelte  | 13 +++++--------
 packages/ui/src/solidity/CustomControls.svelte      |  7 ++++---
 2 files changed, 9 insertions(+), 11 deletions(-)

diff --git a/packages/ui/src/solidity/CrossChainMessagingSection.svelte b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
index f3fb54a20..b240df33d 100644
--- a/packages/ui/src/solidity/CrossChainMessagingSection.svelte
+++ b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
@@ -1,19 +1,16 @@
 <script lang="ts">
-    import type { KindedOptions } from '@openzeppelin/wizard';
     import HelpTooltip from '../common/HelpTooltip.svelte';
     import ExpandableCheckbox from '../common/ExpandableCheckbox.svelte';
     import OPIcon from '../common/icons/OPIcon.svelte';
-  
-    export let opts: KindedOptions['Custom'];
 
-    let crossChainMessagingEnabled = false;
-    $: opts.crossChainMessaging = crossChainMessagingEnabled ? 'superchain' : false;
+    export let enabled: boolean;
+    export let functionName: string;
   </script>
   
   <ExpandableCheckbox
     label="Cross-Chain Messaging"
     icon={OPIcon}
-    bind:checked={crossChainMessagingEnabled}
+    bind:checked={enabled}
     helpContent="TODO"
     helpLink="TODO"
   >
@@ -25,8 +22,8 @@
         </HelpTooltip>
       </span>
       <input
-        bind:value={opts.crossChainFunctionName}
-        disabled={!crossChainMessagingEnabled}
+        bind:value={functionName}
+        disabled={!enabled}
       />
     </label>
   </ExpandableCheckbox>
diff --git a/packages/ui/src/solidity/CustomControls.svelte b/packages/ui/src/solidity/CustomControls.svelte
index 8898313ed..978070e7c 100644
--- a/packages/ui/src/solidity/CustomControls.svelte
+++ b/packages/ui/src/solidity/CustomControls.svelte
@@ -15,7 +15,8 @@
     info: { ...infoDefaults }, // create new object since Info is nested
   };
 
-
+  let crossChainMessagingEnabled = false;
+  $: opts.crossChainMessaging = crossChainMessagingEnabled ? 'superchain' : false;
 
   $: requireAccessControl = custom.isAccessControlRequired(opts);
 </script>
@@ -29,8 +30,6 @@
   </label>
 </section>
 
-<CrossChainMessagingSection bind:opts={opts} />
-
 <section class="controls-section">
   <h1>Features</h1>
 
@@ -46,6 +45,8 @@
   </div>
 </section>
 
+<CrossChainMessagingSection bind:enabled={crossChainMessagingEnabled} bind:functionName={opts.crossChainFunctionName} />
+
 <AccessControlSection bind:access={opts.access} required={requireAccessControl} />
 
 <UpgradeabilitySection bind:upgradeable={opts.upgradeable} />

From 4302bc9ebeb3551f378214afd5b2ff2551d85ce9 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 15:26:00 -0400
Subject: [PATCH 07/54] Sanitize

---
 packages/core/solidity/src/custom.ts                     | 9 ++++++---
 .../ui/src/solidity/CrossChainMessagingSection.svelte    | 1 +
 2 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/packages/core/solidity/src/custom.ts b/packages/core/solidity/src/custom.ts
index a63762ae5..b8b5b69f9 100644
--- a/packages/core/solidity/src/custom.ts
+++ b/packages/core/solidity/src/custom.ts
@@ -8,6 +8,7 @@ import { Access, requireAccessControl, setAccessControl } from './set-access-con
 import { addPausable } from './add-pausable';
 import { printContract } from './print';
 import { defineFunctions } from './utils/define-functions';
+import { toIdentifier } from './utils/to-identifier';
 
 export const CrossChainMessagingOptions = [false, 'superchain'] as const;
 export type CrossChainMessaging = (typeof CrossChainMessagingOptions)[number];
@@ -70,22 +71,24 @@ export function buildCustom(opts: CustomOptions): Contract {
 }
 
 function addSuperchainInterop(c: ContractBuilder, functionName: string, access: Access, pausable: boolean) {
+  const sanitizedFunctionName = toIdentifier(functionName, false);
+
   // Add source function
   const sourceFn: BaseFunction = {
-    name: `call${functionName.replace(/^(.)/i, c => c.toUpperCase())}`,
+    name: `call${sanitizedFunctionName.replace(/^(.)/, c => c.toUpperCase())}`,
     kind: 'public' as const,
     args: [],
   };
 
   requireAccessControl(c, sourceFn, access, 'CROSS_CHAIN_CALLER', 'crossChainCaller');
   c.addFunctionCode(
-    `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${functionName}, (/* TODO: Add arguments */)));`,
+    `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
     sourceFn,
   );
 
   // Add destination function
   const destFn: BaseFunction = {
-    name: functionName,
+    name: sanitizedFunctionName,
     kind: 'external' as const,
     args: [],
   };
diff --git a/packages/ui/src/solidity/CrossChainMessagingSection.svelte b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
index b240df33d..fdfc98b2a 100644
--- a/packages/ui/src/solidity/CrossChainMessagingSection.svelte
+++ b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
@@ -24,6 +24,7 @@
       <input
         bind:value={functionName}
         disabled={!enabled}
+        placeholder="myFunction"
       />
     </label>
   </ExpandableCheckbox>

From bb68267f7f25fbed594a724ca70533a5669d6643 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 15:31:50 -0400
Subject: [PATCH 08/54] Adjust min width

---
 packages/ui/src/solidity/App.svelte | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/ui/src/solidity/App.svelte b/packages/ui/src/solidity/App.svelte
index db47ce539..19ddb5249 100644
--- a/packages/ui/src/solidity/App.svelte
+++ b/packages/ui/src/solidity/App.svelte
@@ -347,7 +347,7 @@
 
   <div class="flex flex-row grow">
     <div
-      class="controls rounded-l-3xl min-w-72 w-72 max-w-[calc(100vw-420px)] flex flex-col shrink-0 justify-between h-[calc(100vh-84px)] overflow-auto resize-x"
+      class="controls rounded-l-3xl min-w-80 w-80 max-w-[calc(100vw-420px)] flex flex-col shrink-0 justify-between h-[calc(100vh-84px)] overflow-auto resize-x"
     >
       <div class:hidden={tab !== 'ERC20'}>
         <ERC20Controls bind:opts={allOpts.ERC20} errors={errors.ERC20} />

From b4a85d9567200d1c785d93cbbd21e42f2c1cd3e2 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 15:50:22 -0400
Subject: [PATCH 09/54] Track errors

---
 packages/core/solidity/src/custom.ts                     | 9 +++++++--
 packages/ui/src/solidity/App.svelte                      | 2 +-
 .../ui/src/solidity/CrossChainMessagingSection.svelte    | 6 +++++-
 packages/ui/src/solidity/CustomControls.svelte           | 6 ++++--
 4 files changed, 17 insertions(+), 6 deletions(-)

diff --git a/packages/core/solidity/src/custom.ts b/packages/core/solidity/src/custom.ts
index b8b5b69f9..d995e9949 100644
--- a/packages/core/solidity/src/custom.ts
+++ b/packages/core/solidity/src/custom.ts
@@ -7,8 +7,8 @@ import { setInfo } from './set-info';
 import { Access, requireAccessControl, setAccessControl } from './set-access-control';
 import { addPausable } from './add-pausable';
 import { printContract } from './print';
-import { defineFunctions } from './utils/define-functions';
 import { toIdentifier } from './utils/to-identifier';
+import { OptionsError } from './error';
 
 export const CrossChainMessagingOptions = [false, 'superchain'] as const;
 export type CrossChainMessaging = (typeof CrossChainMessagingOptions)[number];
@@ -35,7 +35,7 @@ function withDefaults(opts: CustomOptions): Required<CustomOptions> {
     ...opts,
     ...withCommonDefaults(opts),
     crossChainMessaging: opts.crossChainMessaging ?? defaults.crossChainMessaging,
-    crossChainFunctionName: opts.crossChainFunctionName?.length ? opts.crossChainFunctionName : defaults.crossChainFunctionName,
+    crossChainFunctionName: opts.crossChainFunctionName ?? defaults.crossChainFunctionName,
     pausable: opts.pausable ?? defaults.pausable,
   };
 }
@@ -72,6 +72,11 @@ export function buildCustom(opts: CustomOptions): Contract {
 
 function addSuperchainInterop(c: ContractBuilder, functionName: string, access: Access, pausable: boolean) {
   const sanitizedFunctionName = toIdentifier(functionName, false);
+  if (sanitizedFunctionName.length === 0) {
+    throw new OptionsError({
+      crossChainFunctionName: 'Not a valid function name',
+    });
+  }
 
   // Add source function
   const sourceFn: BaseFunction = {
diff --git a/packages/ui/src/solidity/App.svelte b/packages/ui/src/solidity/App.svelte
index 19ddb5249..674f716c7 100644
--- a/packages/ui/src/solidity/App.svelte
+++ b/packages/ui/src/solidity/App.svelte
@@ -371,7 +371,7 @@
         <GovernorControls bind:opts={allOpts.Governor} errors={errors.Governor} />
       </div>
       <div class:hidden={tab !== 'Custom'}>
-        <CustomControls bind:opts={allOpts.Custom} />
+        <CustomControls bind:opts={allOpts.Custom} errors={errors.Custom} />
       </div>
     </div>
 
diff --git a/packages/ui/src/solidity/CrossChainMessagingSection.svelte b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
index fdfc98b2a..781d29c81 100644
--- a/packages/ui/src/solidity/CrossChainMessagingSection.svelte
+++ b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
@@ -2,9 +2,12 @@
     import HelpTooltip from '../common/HelpTooltip.svelte';
     import ExpandableCheckbox from '../common/ExpandableCheckbox.svelte';
     import OPIcon from '../common/icons/OPIcon.svelte';
+    import { error } from '../common/error-tooltip';
+    import type { OptionsErrorMessages } from '@openzeppelin/wizard';
 
     export let enabled: boolean;
     export let functionName: string;
+    export let errors: undefined | OptionsErrorMessages;
   </script>
   
   <ExpandableCheckbox
@@ -13,6 +16,7 @@
     bind:checked={enabled}
     helpContent="TODO"
     helpLink="TODO"
+    error={errors?.crossChainFunctionName}
   >
     <label class="labeled-input">
       <span class="flex justify-between pr-2">
@@ -23,8 +27,8 @@
       </span>
       <input
         bind:value={functionName}
+        use:error={errors?.crossChainFunctionName}
         disabled={!enabled}
-        placeholder="myFunction"
       />
     </label>
   </ExpandableCheckbox>
diff --git a/packages/ui/src/solidity/CustomControls.svelte b/packages/ui/src/solidity/CustomControls.svelte
index 978070e7c..a317fbef0 100644
--- a/packages/ui/src/solidity/CustomControls.svelte
+++ b/packages/ui/src/solidity/CustomControls.svelte
@@ -1,7 +1,7 @@
 <script lang="ts">
   import HelpTooltip from '../common/HelpTooltip.svelte';
 
-  import type { KindedOptions } from '@openzeppelin/wizard';
+  import type { KindedOptions, OptionsErrorMessages } from '@openzeppelin/wizard';
   import { custom, infoDefaults } from '@openzeppelin/wizard';
 
   import AccessControlSection from './AccessControlSection.svelte';
@@ -9,6 +9,8 @@
   import InfoSection from './InfoSection.svelte';
   import CrossChainMessagingSection from './CrossChainMessagingSection.svelte';
 
+  export let errors: undefined | OptionsErrorMessages;
+
   export let opts: Required<KindedOptions['Custom']> = {
     kind: 'Custom',
     ...custom.defaults,
@@ -45,7 +47,7 @@
   </div>
 </section>
 
-<CrossChainMessagingSection bind:enabled={crossChainMessagingEnabled} bind:functionName={opts.crossChainFunctionName} />
+<CrossChainMessagingSection bind:enabled={crossChainMessagingEnabled} bind:functionName={opts.crossChainFunctionName} {errors} />
 
 <AccessControlSection bind:access={opts.access} required={requireAccessControl} />
 

From 2d3638477c3b0bd180e0622341777dd7bac6691a Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 15:56:01 -0400
Subject: [PATCH 10/54] Update help info

---
 packages/ui/src/solidity/CrossChainMessagingSection.svelte | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/ui/src/solidity/CrossChainMessagingSection.svelte b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
index 781d29c81..24ea5a714 100644
--- a/packages/ui/src/solidity/CrossChainMessagingSection.svelte
+++ b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
@@ -14,15 +14,15 @@
     label="Cross-Chain Messaging"
     icon={OPIcon}
     bind:checked={enabled}
-    helpContent="TODO"
-    helpLink="TODO"
+    helpContent="Adds an example for Superchain interop message passing."
+    helpLink="https://docs.optimism.io/interop/message-passing"
     error={errors?.crossChainFunctionName}
   >
     <label class="labeled-input">
       <span class="flex justify-between pr-2">
         Function Name
         <HelpTooltip>
-          The name of the function that will be callable from another chain.
+          The name of a custom function that will be callable from another chain.
         </HelpTooltip>
       </span>
       <input

From 1f1d88116a09ae0b23ea96f8c63ffd0aaa85f8f6 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 16:05:58 -0400
Subject: [PATCH 11/54] Update access control

---
 packages/core/solidity/src/custom.ts | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/packages/core/solidity/src/custom.ts b/packages/core/solidity/src/custom.ts
index d995e9949..c24e24d60 100644
--- a/packages/core/solidity/src/custom.ts
+++ b/packages/core/solidity/src/custom.ts
@@ -56,7 +56,7 @@ export function buildCustom(opts: CustomOptions): Contract {
   const { access, upgradeable, info } = allOpts;
 
   if (allOpts.crossChainMessaging === 'superchain') {
-    addSuperchainInterop(c, allOpts.crossChainFunctionName, allOpts.access, allOpts.pausable);
+    addSuperchainInteropMessagePassing(c, allOpts.crossChainFunctionName, allOpts.access, allOpts.pausable);
   }
 
   if (allOpts.pausable) {
@@ -70,7 +70,7 @@ export function buildCustom(opts: CustomOptions): Contract {
   return c;
 }
 
-function addSuperchainInterop(c: ContractBuilder, functionName: string, access: Access, pausable: boolean) {
+function addSuperchainInteropMessagePassing(c: ContractBuilder, functionName: string, access: Access, pausable: boolean) {
   const sanitizedFunctionName = toIdentifier(functionName, false);
   if (sanitizedFunctionName.length === 0) {
     throw new OptionsError({
@@ -85,7 +85,12 @@ function addSuperchainInterop(c: ContractBuilder, functionName: string, access:
     args: [],
   };
 
-  requireAccessControl(c, sourceFn, access, 'CROSS_CHAIN_CALLER', 'crossChainCaller');
+  if (access) {
+    requireAccessControl(c, sourceFn, access, 'CROSSCHAIN_CALLER', 'crossChainCaller');
+  } else {
+    c.setFunctionComments(['// NOTE: Anyone can call this function'], sourceFn);
+  }
+
   c.addFunctionCode(
     `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
     sourceFn,

From 2916ce835350bfa3ad5bba431325231ca0d19467 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 16:32:30 -0400
Subject: [PATCH 12/54] Add custom errors, doc comments

---
 packages/core/solidity/src/contract.ts | 17 ++++++++++
 packages/core/solidity/src/custom.ts   | 45 ++++++++++++++++++++++++--
 packages/core/solidity/src/erc20.ts    |  2 +-
 packages/core/solidity/src/print.ts    | 24 ++++++++++----
 4 files changed, 79 insertions(+), 9 deletions(-)

diff --git a/packages/core/solidity/src/contract.ts b/packages/core/solidity/src/contract.ts
index bf0f1b0a9..5515ec3b1 100644
--- a/packages/core/solidity/src/contract.ts
+++ b/packages/core/solidity/src/contract.ts
@@ -11,6 +11,11 @@ export interface Contract {
   constructorArgs: FunctionArgument[];
   variables: string[];
   upgradeable: boolean;
+  customErrors: CustomError[];
+}
+
+export interface CustomError {
+  name: string;
 }
 
 export type Value = string | number | { lit: string } | { note: string; value: Value };
@@ -38,6 +43,7 @@ export interface Using {
 export interface BaseFunction {
   name: string;
   args: FunctionArgument[];
+  argInlineComment?: string;
   returns?: string[];
   kind: FunctionKind;
   mutability?: FunctionMutability;
@@ -83,6 +89,7 @@ export class ContractBuilder implements Contract {
   readonly constructorArgs: FunctionArgument[] = [];
   readonly constructorCode: string[] = [];
   readonly variableSet: Set<string> = new Set();
+  readonly customErrorSet: Set<string> = new Set();
 
   private parentMap: Map<string, Parent> = new Map<string, Parent>();
   private functionMap: Map<string, ContractFunction> = new Map();
@@ -117,6 +124,10 @@ export class ContractBuilder implements Contract {
     return [...this.variableSet];
   }
 
+  get customErrors(): CustomError[] {
+    return [...this.customErrorSet].map(name => ({ name }));
+  }
+
   addParent(contract: ImportContract, params: Value[] = []): boolean {
     const present = this.parentMap.has(contract.name);
     this.parentMap.set(contract.name, { contract, params });
@@ -219,4 +230,10 @@ export class ContractBuilder implements Contract {
     this.variableSet.add(code);
     return !present;
   }
+
+  addCustomError(name: string): boolean {
+    const present = this.customErrorSet.has(name);
+    this.customErrorSet.add(name);
+    return !present;
+  }
 }
diff --git a/packages/core/solidity/src/custom.ts b/packages/core/solidity/src/custom.ts
index c24e24d60..5ea6bcd30 100644
--- a/packages/core/solidity/src/custom.ts
+++ b/packages/core/solidity/src/custom.ts
@@ -78,6 +78,32 @@ function addSuperchainInteropMessagePassing(c: ContractBuilder, functionName: st
     });
   }
 
+  // Add custom errors
+  c.addCustomError('CallerNotL2ToL2CrossDomainMessenger');
+  c.addCustomError('InvalidCrossDomainSender');
+  c.addCustomError('InvalidDestination');
+
+  // Add cross domain messenger
+  c.addImportOnly({
+    name: 'IL2ToL2CrossDomainMessenger',
+    path: '@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol',
+  });
+  c.addImportOnly({
+    name: 'Predeploys',
+    path: '@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol',
+  });
+  c.addVariable('IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);');
+
+  // TODO: define modifiers
+  // c.setFunctionBody(
+  //   [
+  //     'if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();',
+  //     'if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();',
+  //     '_;',
+  //   ],
+  //   sourceFn,
+  // );
+
   // Add source function
   const sourceFn: BaseFunction = {
     name: `call${sanitizedFunctionName.replace(/^(.)/, c => c.toUpperCase())}`,
@@ -91,8 +117,11 @@ function addSuperchainInteropMessagePassing(c: ContractBuilder, functionName: st
     c.setFunctionComments(['// NOTE: Anyone can call this function'], sourceFn);
   }
 
-  c.addFunctionCode(
-    `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
+  c.setFunctionBody(
+    [
+      'if (_toChainId == block.chainid) revert InvalidDestination();',
+      `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
+    ],
     sourceFn,
   );
 
@@ -101,8 +130,20 @@ function addSuperchainInteropMessagePassing(c: ContractBuilder, functionName: st
     name: sanitizedFunctionName,
     kind: 'external' as const,
     args: [],
+    argInlineComment: 'TODO: Add arguments',
   };
 
+  c.setFunctionComments([
+    '/**',
+    ' * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,',
+    ' * such as this contract, to be deployed through it, or use CREATE2 from a deployer contract',
+    ' * that is itself deployed by an EOA you control.',
+    ' * This precaution is critical because if an unauthorized contract is deployed at the same',
+    ' * address on any Superchain network, it could allow malicious actors to invoke your function',
+    ' * from another chain.',
+    ' */',
+  ], destFn);
+
   if (pausable) {
     c.addModifier('whenNotPaused', destFn);
   }
diff --git a/packages/core/solidity/src/erc20.ts b/packages/core/solidity/src/erc20.ts
index e9abf7525..509ebaac7 100644
--- a/packages/core/solidity/src/erc20.ts
+++ b/packages/core/solidity/src/erc20.ts
@@ -338,7 +338,7 @@ function addCrossChainBridging(
       throw new Error('Unknown value for `crossChainBridging`');
     }
   }
-  c.addVariable('error Unauthorized();');
+  c.addCustomError('Unauthorized');
 }
 
 function addCustomBridging(c: ContractBuilder, access: Access) {
diff --git a/packages/core/solidity/src/print.ts b/packages/core/solidity/src/print.ts
index c9e85615a..1b597e1c5 100644
--- a/packages/core/solidity/src/print.ts
+++ b/packages/core/solidity/src/print.ts
@@ -6,6 +6,7 @@ import type {
   Value,
   NatspecTag,
   ImportContract,
+  CustomError,
 } from './contract';
 import type { Options, Helpers } from './options';
 import { withHelpers } from './options';
@@ -41,6 +42,7 @@ export function printContract(contract: Contract, opts?: Options): string {
 
         spaceBetween(
           contract.variables,
+          printCustomErrors(contract.customErrors),
           printConstructor(contract, helpers),
           ...fns.code,
           ...fns.modifiers,
@@ -54,6 +56,10 @@ export function printContract(contract: Contract, opts?: Options): string {
   );
 }
 
+function printCustomErrors(errors: CustomError[]): Lines[] {
+  return errors.map(e => `error ${e.name}();`);
+}
+
 function printInheritance(contract: Contract, { transformName }: Helpers): [] | [string] {
   if (contract.parents.length > 0) {
     return ['is ' + contract.parents.map(p => transformName(p.contract)).join(', ')];
@@ -72,12 +78,12 @@ function printConstructor(contract: Contract, helpers: Helpers): Lines[] {
     const args = contract.constructorArgs.map(a => printArgument(a, helpers));
     const body = helpers.upgradeable
       ? spaceBetween(
-          parents.map(p => p + ';'),
-          contract.constructorCode,
-        )
+        parents.map(p => p + ';'),
+        contract.constructorCode,
+      )
       : contract.constructorCode;
     const head = helpers.upgradeable ? 'function initialize' : 'constructor';
-    const constructor = printFunction2([], head, args, modifiers, body);
+    const constructor = printFunction2([], head, args, undefined, modifiers, body);
     if (!helpers.upgradeable) {
       return constructor;
     } else {
@@ -189,6 +195,7 @@ function printFunction(fn: ContractFunction, helpers: Helpers): Lines[] {
       fn.comments,
       'function ' + fn.name,
       fn.args.map(a => printArgument(a, helpers)),
+      fn.argInlineComment,
       modifiers,
       code,
     );
@@ -203,6 +210,7 @@ function printFunction2(
   comments: string[],
   kindedName: string,
   args: string[],
+  argInlineComment: string | undefined,
   modifiers: string[],
   code: Lines[],
 ): Lines[] {
@@ -213,9 +221,9 @@ function printFunction2(
   const braces = code.length > 0 ? '{' : '{}';
 
   if (headingLength <= 72) {
-    fn.push([`${kindedName}(${args.join(', ')})`, ...modifiers, braces].join(' '));
+    fn.push([`${kindedName}(${args.join(', ')}${formatInlineComment(argInlineComment)})`, ...modifiers, braces].join(' '));
   } else {
-    fn.push(`${kindedName}(${args.join(', ')})`, modifiers, braces);
+    fn.push(`${kindedName}(${args.join(', ')}${formatInlineComment(argInlineComment)})`, modifiers, braces);
   }
 
   if (code.length > 0) {
@@ -225,6 +233,10 @@ function printFunction2(
   return fn;
 }
 
+function formatInlineComment(comment: string | undefined): string {
+  return comment ? `/* ${comment} */` : '';
+}
+
 function printArgument(arg: FunctionArgument, { transformName }: Helpers): string {
   let type: string;
   if (typeof arg.type === 'string') {

From ae753fd5e298388234f1da2464140ccc6b93d104 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 16:46:45 -0400
Subject: [PATCH 13/54] Add modifier def

---
 packages/core/solidity/src/contract.ts | 17 +++++++++++++++++
 packages/core/solidity/src/custom.ts   | 20 ++++++++++----------
 packages/core/solidity/src/print.ts    | 10 ++++++++++
 3 files changed, 37 insertions(+), 10 deletions(-)

diff --git a/packages/core/solidity/src/contract.ts b/packages/core/solidity/src/contract.ts
index 5515ec3b1..9fa6c666b 100644
--- a/packages/core/solidity/src/contract.ts
+++ b/packages/core/solidity/src/contract.ts
@@ -12,6 +12,7 @@ export interface Contract {
   variables: string[];
   upgradeable: boolean;
   customErrors: CustomError[];
+  modifierDefinitions: ModifierDefinition[];
 }
 
 export interface CustomError {
@@ -40,6 +41,11 @@ export interface Using {
   usingFor: string;
 }
 
+export interface ModifierDefinition {
+  name: string;
+  code: string[];
+}
+
 export interface BaseFunction {
   name: string;
   args: FunctionArgument[];
@@ -93,6 +99,7 @@ export class ContractBuilder implements Contract {
 
   private parentMap: Map<string, Parent> = new Map<string, Parent>();
   private functionMap: Map<string, ContractFunction> = new Map();
+  private modifierDefinitionsMap: Map<string, ModifierDefinition> = new Map<string, ModifierDefinition>();
 
   constructor(name: string) {
     this.name = toIdentifier(name, true);
@@ -128,6 +135,10 @@ export class ContractBuilder implements Contract {
     return [...this.customErrorSet].map(name => ({ name }));
   }
 
+  get modifierDefinitions(): ModifierDefinition[] {
+    return [...this.modifierDefinitionsMap.values()];
+  }
+
   addParent(contract: ImportContract, params: Value[] = []): boolean {
     const present = this.parentMap.has(contract.name);
     this.parentMap.set(contract.name, { contract, params });
@@ -236,4 +247,10 @@ export class ContractBuilder implements Contract {
     this.customErrorSet.add(name);
     return !present;
   }
+
+  addModifierDefinition(modifier: ModifierDefinition): boolean {
+    const present = this.modifierDefinitionsMap.has(modifier.name);
+    this.modifierDefinitionsMap.set(modifier.name, modifier);
+    return !present;
+  }
 }
diff --git a/packages/core/solidity/src/custom.ts b/packages/core/solidity/src/custom.ts
index 5ea6bcd30..e772a60c3 100644
--- a/packages/core/solidity/src/custom.ts
+++ b/packages/core/solidity/src/custom.ts
@@ -94,15 +94,15 @@ function addSuperchainInteropMessagePassing(c: ContractBuilder, functionName: st
   });
   c.addVariable('IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);');
 
-  // TODO: define modifiers
-  // c.setFunctionBody(
-  //   [
-  //     'if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();',
-  //     'if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();',
-  //     '_;',
-  //   ],
-  //   sourceFn,
-  // );
+  // Add modifier definition
+  c.addModifierDefinition({
+    name: 'onlyCrossDomainCallback',
+    code: [
+      'if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();',
+      'if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();',
+      '_;',
+    ],
+  });
 
   // Add source function
   const sourceFn: BaseFunction = {
@@ -132,7 +132,6 @@ function addSuperchainInteropMessagePassing(c: ContractBuilder, functionName: st
     args: [],
     argInlineComment: 'TODO: Add arguments',
   };
-
   c.setFunctionComments([
     '/**',
     ' * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,',
@@ -144,6 +143,7 @@ function addSuperchainInteropMessagePassing(c: ContractBuilder, functionName: st
     ' */',
   ], destFn);
 
+  c.addModifier('onlyCrossDomainCallback', destFn);
   if (pausable) {
     c.addModifier('whenNotPaused', destFn);
   }
diff --git a/packages/core/solidity/src/print.ts b/packages/core/solidity/src/print.ts
index 1b597e1c5..25740c325 100644
--- a/packages/core/solidity/src/print.ts
+++ b/packages/core/solidity/src/print.ts
@@ -7,6 +7,7 @@ import type {
   NatspecTag,
   ImportContract,
   CustomError,
+  ModifierDefinition,
 } from './contract';
 import type { Options, Helpers } from './options';
 import { withHelpers } from './options';
@@ -44,6 +45,7 @@ export function printContract(contract: Contract, opts?: Options): string {
           contract.variables,
           printCustomErrors(contract.customErrors),
           printConstructor(contract, helpers),
+          printModifierDefinitions(contract.modifierDefinitions),
           ...fns.code,
           ...fns.modifiers,
           hasOverrides ? [`// The following functions are overrides required by Solidity.`] : [],
@@ -60,6 +62,14 @@ function printCustomErrors(errors: CustomError[]): Lines[] {
   return errors.map(e => `error ${e.name}();`);
 }
 
+function printModifierDefinitions(modifierDefinitions: ModifierDefinition[]): Lines[] {
+  return modifierDefinitions.flatMap(def => [
+    `modifier ${def.name}() {`,
+    def.code,
+    '}',
+  ]);
+}
+
 function printInheritance(contract: Contract, { transformName }: Helpers): [] | [string] {
   if (contract.parents.length > 0) {
     return ['is ' + contract.parents.map(p => transformName(p.contract)).join(', ')];

From 5206bfd9b86302ed910291ee3042dea0c38dab9f Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 16:53:12 -0400
Subject: [PATCH 14/54] avoid infer transpile

---
 packages/core/solidity/src/custom.ts | 2 ++
 packages/core/solidity/src/print.ts  | 2 +-
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/packages/core/solidity/src/custom.ts b/packages/core/solidity/src/custom.ts
index e772a60c3..d8f9bf852 100644
--- a/packages/core/solidity/src/custom.ts
+++ b/packages/core/solidity/src/custom.ts
@@ -87,10 +87,12 @@ function addSuperchainInteropMessagePassing(c: ContractBuilder, functionName: st
   c.addImportOnly({
     name: 'IL2ToL2CrossDomainMessenger',
     path: '@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol',
+    transpiled: false,
   });
   c.addImportOnly({
     name: 'Predeploys',
     path: '@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol',
+    transpiled: false,
   });
   c.addVariable('IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);');
 
diff --git a/packages/core/solidity/src/print.ts b/packages/core/solidity/src/print.ts
index 25740c325..655412fe1 100644
--- a/packages/core/solidity/src/print.ts
+++ b/packages/core/solidity/src/print.ts
@@ -44,8 +44,8 @@ export function printContract(contract: Contract, opts?: Options): string {
         spaceBetween(
           contract.variables,
           printCustomErrors(contract.customErrors),
-          printConstructor(contract, helpers),
           printModifierDefinitions(contract.modifierDefinitions),
+          printConstructor(contract, helpers),
           ...fns.code,
           ...fns.modifiers,
           hasOverrides ? [`// The following functions are overrides required by Solidity.`] : [],

From 7d781777dfab10115dfeaa184cd3d0856379b4b5 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 17:03:44 -0400
Subject: [PATCH 15/54] Refactor

---
 .../solidity/src/add-superchain-messaging.ts  | 110 ++++++++++++++++++
 packages/core/solidity/src/custom.ts          |  92 +--------------
 2 files changed, 114 insertions(+), 88 deletions(-)
 create mode 100644 packages/core/solidity/src/add-superchain-messaging.ts

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
new file mode 100644
index 000000000..777a7e78a
--- /dev/null
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -0,0 +1,110 @@
+import { ContractBuilder, type BaseFunction } from './contract';
+import { OptionsError } from './error';
+import { Access, requireAccessControl } from './set-access-control';
+import { toIdentifier } from './utils/to-identifier';
+
+export function addSuperchainMessaging(c: ContractBuilder, functionName: string, access: Access, pausable: boolean) {
+    const sanitizedFunctionName = safeSanitizeFunctionName(functionName);
+
+    addCustomErrors(c);
+    addCrossDomainMessengerImmutable(c);
+    addOnlyCrossDomainCallbackModifier(c);
+    addSourceFunction(sanitizedFunctionName, access, c, pausable);
+    addDestinationFunction(sanitizedFunctionName, c, pausable);
+}
+
+function safeSanitizeFunctionName(functionName: string) {
+    const sanitizedFunctionName = toIdentifier(functionName, false);
+    if (sanitizedFunctionName.length === 0) {
+        throw new OptionsError({
+            crossChainFunctionName: 'Not a valid function name',
+        });
+    }
+    return sanitizedFunctionName;
+}
+
+function addCustomErrors(c: ContractBuilder) {
+    c.addCustomError('CallerNotL2ToL2CrossDomainMessenger');
+    c.addCustomError('InvalidCrossDomainSender');
+    c.addCustomError('InvalidDestination');
+}
+
+function addCrossDomainMessengerImmutable(c: ContractBuilder) {
+    c.addImportOnly({
+        name: 'IL2ToL2CrossDomainMessenger',
+        path: '@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol',
+        transpiled: false,
+    });
+    c.addImportOnly({
+        name: 'Predeploys',
+        path: '@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol',
+        transpiled: false,
+    });
+    c.addVariable('IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);');
+}
+
+function addOnlyCrossDomainCallbackModifier(c: ContractBuilder) {
+    c.addModifierDefinition({
+        name: 'onlyCrossDomainCallback',
+        code: [
+            'if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();',
+            'if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();',
+            '_;',
+        ],
+    });
+}
+
+function addSourceFunction(sanitizedFunctionName: string, access: Access, c: ContractBuilder, pausable: boolean) {
+    const sourceFn: BaseFunction = {
+        name: `call${sanitizedFunctionName.replace(/^(.)/, c => c.toUpperCase())}`,
+        kind: 'public' as const,
+        args: [],
+    };
+
+    if (access) {
+        requireAccessControl(c, sourceFn, access, 'CROSSCHAIN_CALLER', 'crossChainCaller');
+    } else {
+        c.setFunctionComments(['// NOTE: Anyone can call this function'], sourceFn);
+    }
+
+    if (pausable) {
+        c.addModifier('whenNotPaused', sourceFn);
+    }
+
+    c.setFunctionBody(
+        [
+            'if (_toChainId == block.chainid) revert InvalidDestination();',
+            `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
+        ],
+        sourceFn
+    );
+}
+
+function addDestinationFunction(sanitizedFunctionName: string, c: ContractBuilder, pausable: boolean) {
+    const destFn: BaseFunction = {
+        name: sanitizedFunctionName,
+        kind: 'external' as const,
+        args: [],
+        argInlineComment: 'TODO: Add arguments',
+    };
+    c.setFunctionComments([
+        '/**',
+        ' * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,',
+        ' * such as this contract, to be deployed through it, or use CREATE2 from a deployer contract',
+        ' * that is itself deployed by an EOA you control.',
+        ' * This precaution is critical because if an unauthorized contract is deployed at the same',
+        ' * address on any Superchain network, it could allow malicious actors to invoke your function',
+        ' * from another chain.',
+        ' */',
+    ], destFn);
+
+    c.addModifier('onlyCrossDomainCallback', destFn);
+    if (pausable) {
+        c.addModifier('whenNotPaused', destFn);
+    }
+
+    c.addFunctionCode('// TODO: Implement logic for the function that will be called from another chain', destFn);
+}
+
+
+
diff --git a/packages/core/solidity/src/custom.ts b/packages/core/solidity/src/custom.ts
index d8f9bf852..c0b73e7ce 100644
--- a/packages/core/solidity/src/custom.ts
+++ b/packages/core/solidity/src/custom.ts
@@ -1,14 +1,13 @@
-import type { BaseFunction, Contract } from './contract';
+import type { Contract } from './contract';
 import { ContractBuilder } from './contract';
 import type { CommonOptions } from './common-options';
 import { withCommonDefaults, defaults as commonDefaults } from './common-options';
 import { setUpgradeable } from './set-upgradeable';
 import { setInfo } from './set-info';
-import { Access, requireAccessControl, setAccessControl } from './set-access-control';
+import { setAccessControl } from './set-access-control';
 import { addPausable } from './add-pausable';
 import { printContract } from './print';
-import { toIdentifier } from './utils/to-identifier';
-import { OptionsError } from './error';
+import { addSuperchainMessaging } from './add-superchain-messaging';
 
 export const CrossChainMessagingOptions = [false, 'superchain'] as const;
 export type CrossChainMessaging = (typeof CrossChainMessagingOptions)[number];
@@ -56,7 +55,7 @@ export function buildCustom(opts: CustomOptions): Contract {
   const { access, upgradeable, info } = allOpts;
 
   if (allOpts.crossChainMessaging === 'superchain') {
-    addSuperchainInteropMessagePassing(c, allOpts.crossChainFunctionName, allOpts.access, allOpts.pausable);
+    addSuperchainMessaging(c, allOpts.crossChainFunctionName, allOpts.access, allOpts.pausable);
   }
 
   if (allOpts.pausable) {
@@ -70,86 +69,3 @@ export function buildCustom(opts: CustomOptions): Contract {
   return c;
 }
 
-function addSuperchainInteropMessagePassing(c: ContractBuilder, functionName: string, access: Access, pausable: boolean) {
-  const sanitizedFunctionName = toIdentifier(functionName, false);
-  if (sanitizedFunctionName.length === 0) {
-    throw new OptionsError({
-      crossChainFunctionName: 'Not a valid function name',
-    });
-  }
-
-  // Add custom errors
-  c.addCustomError('CallerNotL2ToL2CrossDomainMessenger');
-  c.addCustomError('InvalidCrossDomainSender');
-  c.addCustomError('InvalidDestination');
-
-  // Add cross domain messenger
-  c.addImportOnly({
-    name: 'IL2ToL2CrossDomainMessenger',
-    path: '@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol',
-    transpiled: false,
-  });
-  c.addImportOnly({
-    name: 'Predeploys',
-    path: '@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol',
-    transpiled: false,
-  });
-  c.addVariable('IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);');
-
-  // Add modifier definition
-  c.addModifierDefinition({
-    name: 'onlyCrossDomainCallback',
-    code: [
-      'if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();',
-      'if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();',
-      '_;',
-    ],
-  });
-
-  // Add source function
-  const sourceFn: BaseFunction = {
-    name: `call${sanitizedFunctionName.replace(/^(.)/, c => c.toUpperCase())}`,
-    kind: 'public' as const,
-    args: [],
-  };
-
-  if (access) {
-    requireAccessControl(c, sourceFn, access, 'CROSSCHAIN_CALLER', 'crossChainCaller');
-  } else {
-    c.setFunctionComments(['// NOTE: Anyone can call this function'], sourceFn);
-  }
-
-  c.setFunctionBody(
-    [
-      'if (_toChainId == block.chainid) revert InvalidDestination();',
-      `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
-    ],
-    sourceFn,
-  );
-
-  // Add destination function
-  const destFn: BaseFunction = {
-    name: sanitizedFunctionName,
-    kind: 'external' as const,
-    args: [],
-    argInlineComment: 'TODO: Add arguments',
-  };
-  c.setFunctionComments([
-    '/**',
-    ' * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,',
-    ' * such as this contract, to be deployed through it, or use CREATE2 from a deployer contract',
-    ' * that is itself deployed by an EOA you control.',
-    ' * This precaution is critical because if an unauthorized contract is deployed at the same',
-    ' * address on any Superchain network, it could allow malicious actors to invoke your function',
-    ' * from another chain.',
-    ' */',
-  ], destFn);
-
-  c.addModifier('onlyCrossDomainCallback', destFn);
-  if (pausable) {
-    c.addModifier('whenNotPaused', destFn);
-  }
-
-  c.addFunctionCode('// TODO: Implement logic for the function that will be called from another chain', destFn);
-}
-

From 22b67cf8ef20b3b5cd63198a36734a67fd316d3e Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 17:04:08 -0400
Subject: [PATCH 16/54] Lint

---
 .../solidity/src/add-superchain-messaging.ts  | 176 +++++++++---------
 packages/core/solidity/src/custom.ts          |   1 -
 packages/core/solidity/src/print.ts           |  16 +-
 3 files changed, 97 insertions(+), 96 deletions(-)

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index 777a7e78a..89225a3c0 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -1,110 +1,114 @@
-import { ContractBuilder, type BaseFunction } from './contract';
+import type { ContractBuilder } from './contract';
+import { type BaseFunction } from './contract';
 import { OptionsError } from './error';
-import { Access, requireAccessControl } from './set-access-control';
+import type { Access } from './set-access-control';
+import { requireAccessControl } from './set-access-control';
 import { toIdentifier } from './utils/to-identifier';
 
 export function addSuperchainMessaging(c: ContractBuilder, functionName: string, access: Access, pausable: boolean) {
-    const sanitizedFunctionName = safeSanitizeFunctionName(functionName);
+  const sanitizedFunctionName = safeSanitizeFunctionName(functionName);
 
-    addCustomErrors(c);
-    addCrossDomainMessengerImmutable(c);
-    addOnlyCrossDomainCallbackModifier(c);
-    addSourceFunction(sanitizedFunctionName, access, c, pausable);
-    addDestinationFunction(sanitizedFunctionName, c, pausable);
+  addCustomErrors(c);
+  addCrossDomainMessengerImmutable(c);
+  addOnlyCrossDomainCallbackModifier(c);
+  addSourceFunction(sanitizedFunctionName, access, c, pausable);
+  addDestinationFunction(sanitizedFunctionName, c, pausable);
 }
 
 function safeSanitizeFunctionName(functionName: string) {
-    const sanitizedFunctionName = toIdentifier(functionName, false);
-    if (sanitizedFunctionName.length === 0) {
-        throw new OptionsError({
-            crossChainFunctionName: 'Not a valid function name',
-        });
-    }
-    return sanitizedFunctionName;
+  const sanitizedFunctionName = toIdentifier(functionName, false);
+  if (sanitizedFunctionName.length === 0) {
+    throw new OptionsError({
+      crossChainFunctionName: 'Not a valid function name',
+    });
+  }
+  return sanitizedFunctionName;
 }
 
 function addCustomErrors(c: ContractBuilder) {
-    c.addCustomError('CallerNotL2ToL2CrossDomainMessenger');
-    c.addCustomError('InvalidCrossDomainSender');
-    c.addCustomError('InvalidDestination');
+  c.addCustomError('CallerNotL2ToL2CrossDomainMessenger');
+  c.addCustomError('InvalidCrossDomainSender');
+  c.addCustomError('InvalidDestination');
 }
 
 function addCrossDomainMessengerImmutable(c: ContractBuilder) {
-    c.addImportOnly({
-        name: 'IL2ToL2CrossDomainMessenger',
-        path: '@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol',
-        transpiled: false,
-    });
-    c.addImportOnly({
-        name: 'Predeploys',
-        path: '@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol',
-        transpiled: false,
-    });
-    c.addVariable('IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);');
+  c.addImportOnly({
+    name: 'IL2ToL2CrossDomainMessenger',
+    path: '@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol',
+    transpiled: false,
+  });
+  c.addImportOnly({
+    name: 'Predeploys',
+    path: '@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol',
+    transpiled: false,
+  });
+  c.addVariable(
+    'IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);',
+  );
 }
 
 function addOnlyCrossDomainCallbackModifier(c: ContractBuilder) {
-    c.addModifierDefinition({
-        name: 'onlyCrossDomainCallback',
-        code: [
-            'if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();',
-            'if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();',
-            '_;',
-        ],
-    });
+  c.addModifierDefinition({
+    name: 'onlyCrossDomainCallback',
+    code: [
+      'if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();',
+      'if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();',
+      '_;',
+    ],
+  });
 }
 
 function addSourceFunction(sanitizedFunctionName: string, access: Access, c: ContractBuilder, pausable: boolean) {
-    const sourceFn: BaseFunction = {
-        name: `call${sanitizedFunctionName.replace(/^(.)/, c => c.toUpperCase())}`,
-        kind: 'public' as const,
-        args: [],
-    };
-
-    if (access) {
-        requireAccessControl(c, sourceFn, access, 'CROSSCHAIN_CALLER', 'crossChainCaller');
-    } else {
-        c.setFunctionComments(['// NOTE: Anyone can call this function'], sourceFn);
-    }
-
-    if (pausable) {
-        c.addModifier('whenNotPaused', sourceFn);
-    }
-
-    c.setFunctionBody(
-        [
-            'if (_toChainId == block.chainid) revert InvalidDestination();',
-            `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
-        ],
-        sourceFn
-    );
+  const sourceFn: BaseFunction = {
+    name: `call${sanitizedFunctionName.replace(/^(.)/, c => c.toUpperCase())}`,
+    kind: 'public' as const,
+    args: [],
+  };
+
+  if (access) {
+    requireAccessControl(c, sourceFn, access, 'CROSSCHAIN_CALLER', 'crossChainCaller');
+  } else {
+    c.setFunctionComments(['// NOTE: Anyone can call this function'], sourceFn);
+  }
+
+  if (pausable) {
+    c.addModifier('whenNotPaused', sourceFn);
+  }
+
+  c.setFunctionBody(
+    [
+      'if (_toChainId == block.chainid) revert InvalidDestination();',
+      `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
+    ],
+    sourceFn,
+  );
 }
 
 function addDestinationFunction(sanitizedFunctionName: string, c: ContractBuilder, pausable: boolean) {
-    const destFn: BaseFunction = {
-        name: sanitizedFunctionName,
-        kind: 'external' as const,
-        args: [],
-        argInlineComment: 'TODO: Add arguments',
-    };
-    c.setFunctionComments([
-        '/**',
-        ' * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,',
-        ' * such as this contract, to be deployed through it, or use CREATE2 from a deployer contract',
-        ' * that is itself deployed by an EOA you control.',
-        ' * This precaution is critical because if an unauthorized contract is deployed at the same',
-        ' * address on any Superchain network, it could allow malicious actors to invoke your function',
-        ' * from another chain.',
-        ' */',
-    ], destFn);
-
-    c.addModifier('onlyCrossDomainCallback', destFn);
-    if (pausable) {
-        c.addModifier('whenNotPaused', destFn);
-    }
-
-    c.addFunctionCode('// TODO: Implement logic for the function that will be called from another chain', destFn);
+  const destFn: BaseFunction = {
+    name: sanitizedFunctionName,
+    kind: 'external' as const,
+    args: [],
+    argInlineComment: 'TODO: Add arguments',
+  };
+  c.setFunctionComments(
+    [
+      '/**',
+      ' * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,',
+      ' * such as this contract, to be deployed through it, or use CREATE2 from a deployer contract',
+      ' * that is itself deployed by an EOA you control.',
+      ' * This precaution is critical because if an unauthorized contract is deployed at the same',
+      ' * address on any Superchain network, it could allow malicious actors to invoke your function',
+      ' * from another chain.',
+      ' */',
+    ],
+    destFn,
+  );
+
+  c.addModifier('onlyCrossDomainCallback', destFn);
+  if (pausable) {
+    c.addModifier('whenNotPaused', destFn);
+  }
+
+  c.addFunctionCode('// TODO: Implement logic for the function that will be called from another chain', destFn);
 }
-
-
-
diff --git a/packages/core/solidity/src/custom.ts b/packages/core/solidity/src/custom.ts
index c0b73e7ce..43a317e05 100644
--- a/packages/core/solidity/src/custom.ts
+++ b/packages/core/solidity/src/custom.ts
@@ -68,4 +68,3 @@ export function buildCustom(opts: CustomOptions): Contract {
 
   return c;
 }
-
diff --git a/packages/core/solidity/src/print.ts b/packages/core/solidity/src/print.ts
index 655412fe1..033ca97f7 100644
--- a/packages/core/solidity/src/print.ts
+++ b/packages/core/solidity/src/print.ts
@@ -63,11 +63,7 @@ function printCustomErrors(errors: CustomError[]): Lines[] {
 }
 
 function printModifierDefinitions(modifierDefinitions: ModifierDefinition[]): Lines[] {
-  return modifierDefinitions.flatMap(def => [
-    `modifier ${def.name}() {`,
-    def.code,
-    '}',
-  ]);
+  return modifierDefinitions.flatMap(def => [`modifier ${def.name}() {`, def.code, '}']);
 }
 
 function printInheritance(contract: Contract, { transformName }: Helpers): [] | [string] {
@@ -88,9 +84,9 @@ function printConstructor(contract: Contract, helpers: Helpers): Lines[] {
     const args = contract.constructorArgs.map(a => printArgument(a, helpers));
     const body = helpers.upgradeable
       ? spaceBetween(
-        parents.map(p => p + ';'),
-        contract.constructorCode,
-      )
+          parents.map(p => p + ';'),
+          contract.constructorCode,
+        )
       : contract.constructorCode;
     const head = helpers.upgradeable ? 'function initialize' : 'constructor';
     const constructor = printFunction2([], head, args, undefined, modifiers, body);
@@ -231,7 +227,9 @@ function printFunction2(
   const braces = code.length > 0 ? '{' : '{}';
 
   if (headingLength <= 72) {
-    fn.push([`${kindedName}(${args.join(', ')}${formatInlineComment(argInlineComment)})`, ...modifiers, braces].join(' '));
+    fn.push(
+      [`${kindedName}(${args.join(', ')}${formatInlineComment(argInlineComment)})`, ...modifiers, braces].join(' '),
+    );
   } else {
     fn.push(`${kindedName}(${args.join(', ')}${formatInlineComment(argInlineComment)})`, modifiers, braces);
   }

From 21d2c523b1df64c03d80d9b1ec121ce947eb7a53 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 17:09:22 -0400
Subject: [PATCH 17/54] Update snapshots

---
 packages/core/solidity/src/erc20.test.ts.md   |  13 ++++++++++++-
 packages/core/solidity/src/erc20.test.ts.snap | Bin 3305 -> 3312 bytes
 .../core/solidity/src/stablecoin.test.ts.md   |   3 ++-
 .../core/solidity/src/stablecoin.test.ts.snap | Bin 2102 -> 2106 bytes
 4 files changed, 14 insertions(+), 2 deletions(-)

diff --git a/packages/core/solidity/src/erc20.test.ts.md b/packages/core/solidity/src/erc20.test.ts.md
index d144f5651..58f2ee030 100644
--- a/packages/core/solidity/src/erc20.test.ts.md
+++ b/packages/core/solidity/src/erc20.test.ts.md
@@ -549,6 +549,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, ERC20Permit {␊
         address public immutable TOKEN_BRIDGE;␊
+    ␊
         error Unauthorized();␊
     ␊
         constructor(address tokenBridge)␊
@@ -580,6 +581,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, ERC20Permit, Ownable {␊
         address public immutable TOKEN_BRIDGE;␊
+    ␊
         error Unauthorized();␊
     ␊
         constructor(address tokenBridge, address initialOwner)␊
@@ -613,6 +615,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, ERC20Burnable, Ownable, ERC20Permit {␊
         address public immutable TOKEN_BRIDGE;␊
+    ␊
         error Unauthorized();␊
     ␊
         constructor(address tokenBridge, address initialOwner)␊
@@ -649,6 +652,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, AccessControl, ERC20Permit {␊
         bytes32 public constant TOKEN_BRIDGE_ROLE = keccak256("TOKEN_BRIDGE_ROLE");␊
+    ␊
         error Unauthorized();␊
     ␊
         constructor(address defaultAdmin, address tokenBridge)␊
@@ -720,6 +724,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, ERC20Permit {␊
         address internal constant SUPERCHAIN_TOKEN_BRIDGE = 0x4200000000000000000000000000000000000028;␊
+    ␊
         error Unauthorized();␊
     ␊
         constructor() ERC20("MyToken", "MTK") ERC20Permit("MyToken") {}␊
@@ -750,6 +755,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, ERC20Permit, Ownable {␊
         address internal constant SUPERCHAIN_TOKEN_BRIDGE = 0x4200000000000000000000000000000000000028;␊
+    ␊
         error Unauthorized();␊
     ␊
         constructor(address initialOwner)␊
@@ -784,6 +790,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, ERC20Permit, AccessControl {␊
         address internal constant SUPERCHAIN_TOKEN_BRIDGE = 0x4200000000000000000000000000000000000028;␊
+    ␊
         error Unauthorized();␊
     ␊
         constructor(address defaultAdmin)␊
@@ -830,6 +837,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, ERC20Permit, AccessManaged {␊
         address internal constant SUPERCHAIN_TOKEN_BRIDGE = 0x4200000000000000000000000000000000000028;␊
+    ␊
         error Unauthorized();␊
     ␊
         constructor(address initialAuthority)␊
@@ -884,6 +892,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, ERC20Permit {␊
         address public immutable TOKEN_BRIDGE;␊
+    ␊
         error Unauthorized();␊
     ␊
         constructor(address tokenBridge, address recipient)␊
@@ -917,6 +926,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, ERC20Permit {␊
         address internal constant SUPERCHAIN_TOKEN_BRIDGE = 0x4200000000000000000000000000000000000028;␊
+    ␊
         error Unauthorized();␊
     ␊
         constructor(address recipient)␊
@@ -960,9 +970,10 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyToken is ERC20, ERC20Bridgeable, AccessControl, ERC20Burnable, ERC20Pausable, ERC1363, ERC20Permit, ERC20Votes, ERC20FlashMint {␊
         bytes32 public constant TOKEN_BRIDGE_ROLE = keccak256("TOKEN_BRIDGE_ROLE");␊
-        error Unauthorized();␊
         bytes32 public constant PAUSER_ROLE = keccak256("PAUSER_ROLE");␊
         bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");␊
+    ␊
+        error Unauthorized();␊
     ␊
         constructor(address defaultAdmin, address tokenBridge, address recipient, address pauser, address minter)␊
             ERC20("MyToken", "MTK")␊
diff --git a/packages/core/solidity/src/erc20.test.ts.snap b/packages/core/solidity/src/erc20.test.ts.snap
index 33e9034f943ef2d963c70511c5c19449254e0d60..121c3e47d97a47347a34cb006071104c2d1aef63 100644
GIT binary patch
literal 3312
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

literal 3305
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

diff --git a/packages/core/solidity/src/stablecoin.test.ts.md b/packages/core/solidity/src/stablecoin.test.ts.md
index d0b292ea5..af2d36deb 100644
--- a/packages/core/solidity/src/stablecoin.test.ts.md
+++ b/packages/core/solidity/src/stablecoin.test.ts.md
@@ -606,11 +606,12 @@ Generated by [AVA](https://avajs.dev).
     ␊
     contract MyStablecoin is ERC20, ERC20Bridgeable, AccessControl, ERC20Burnable, ERC20Pausable, ERC1363, ERC20Permit, ERC20Votes, ERC20FlashMint, ERC20Custodian, ERC20Allowlist {␊
         bytes32 public constant TOKEN_BRIDGE_ROLE = keccak256("TOKEN_BRIDGE_ROLE");␊
-        error Unauthorized();␊
         bytes32 public constant PAUSER_ROLE = keccak256("PAUSER_ROLE");␊
         bytes32 public constant MINTER_ROLE = keccak256("MINTER_ROLE");␊
         bytes32 public constant CUSTODIAN_ROLE = keccak256("CUSTODIAN_ROLE");␊
         bytes32 public constant LIMITER_ROLE = keccak256("LIMITER_ROLE");␊
+    ␊
+        error Unauthorized();␊
     ␊
         constructor(address defaultAdmin, address tokenBridge, address recipient, address pauser, address minter, address custodian, address limiter)␊
             ERC20("MyStablecoin", "MST")␊
diff --git a/packages/core/solidity/src/stablecoin.test.ts.snap b/packages/core/solidity/src/stablecoin.test.ts.snap
index 02308f8dbce5f5387a0b6b1109367bdfddb9ee65..d9161c1ef6369709cf0e37d30c95cc8c77173e0d 100644
GIT binary patch
delta 2058
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

delta 2054
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


From 048bffb3cf3cdb71cf5290412ea8258366e5c2c7 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 17:16:06 -0400
Subject: [PATCH 18/54] Add contracts-bedrock

---
 packages/core/solidity/package.json | 1 +
 yarn.lock                           | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/packages/core/solidity/package.json b/packages/core/solidity/package.json
index f451397b2..c7176659e 100644
--- a/packages/core/solidity/package.json
+++ b/packages/core/solidity/package.json
@@ -25,6 +25,7 @@
     "@openzeppelin/community-contracts": "https://github.com/OpenZeppelin/openzeppelin-community-contracts",
     "@openzeppelin/contracts": "^5.3.0",
     "@openzeppelin/contracts-upgradeable": "^5.3.0",
+    "@eth-optimism/contracts-bedrock": "^0.17.3",
     "@types/node": "^20.0.0",
     "@types/semver": "^7.5.7",
     "ava": "^6.0.0",
diff --git a/yarn.lock b/yarn.lock
index fea3f75d2..efcd48946 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -316,6 +316,11 @@
     "@eslint/core" "^0.12.0"
     levn "^0.4.1"
 
+"@eth-optimism/contracts-bedrock@^0.17.3":
+  version "0.17.3"
+  resolved "https://registry.yarnpkg.com/@eth-optimism/contracts-bedrock/-/contracts-bedrock-0.17.3.tgz#ab3085e90d50e66ddbf07512ca1d666b5bab625b"
+  integrity sha512-cHPO7ntWeOBDLO7ZFFSZGI1D7CDqf4loRbRVJrFIsqLEz+hysWIqA0e3dv2GnrjVeuYePBfI2NTBEG4uwz9bQQ==
+
 "@ethersproject/abi@^5.1.2":
   version "5.7.0"
   resolved "https://registry.yarnpkg.com/@ethersproject/abi/-/abi-5.7.0.tgz#b3f3e045bbbeed1af3947335c247ad625a44e449"

From 3c52b728f91f2c00e4828994288891a799d496ef Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 17:36:27 -0400
Subject: [PATCH 19/54] add tests

---
 packages/core/solidity/src/custom.test.ts     |  30 +++++-
 packages/core/solidity/src/custom.test.ts.md  |  99 ++++++++++++++++++
 .../core/solidity/src/custom.test.ts.snap     | Bin 859 -> 1593 bytes
 3 files changed, 128 insertions(+), 1 deletion(-)

diff --git a/packages/core/solidity/src/custom.test.ts b/packages/core/solidity/src/custom.test.ts
index 6262bf26a..7ceff4534 100644
--- a/packages/core/solidity/src/custom.test.ts
+++ b/packages/core/solidity/src/custom.test.ts
@@ -1,5 +1,5 @@
 import test from 'ava';
-import { custom } from '.';
+import { custom, OptionsError } from '.';
 
 import type { CustomOptions } from './custom';
 import { buildCustom } from './custom';
@@ -66,6 +66,30 @@ testCustom('access control managed', {
   access: 'managed',
 });
 
+testCustom('superchain messaging', {
+  crossChainMessaging: 'superchain',
+});
+
+testCustom('superchain messaging ownable pausable', {
+  crossChainMessaging: 'superchain',
+  access: 'ownable',
+  pausable: true,
+});
+
+test('superchain messaging, invalid function name', async t => {
+  const error = t.throws(() =>
+    buildCustom({
+      name: 'MyContract',
+      crossChainMessaging: 'superchain',
+      crossChainFunctionName: '  ',
+    }),
+  );
+  t.is(
+    (error as OptionsError).messages.crossChainFunctionName,
+    'Not a valid function name',
+  );
+});
+
 testCustom('upgradeable uups with access control disabled', {
   // API should override access to true since it is required for UUPS
   access: false,
@@ -81,6 +105,8 @@ testAPIEquivalence('custom API full upgradeable', {
   access: 'roles',
   pausable: true,
   upgradeable: 'uups',
+  crossChainMessaging: 'superchain',
+  crossChainFunctionName: 'myCustomFunction',
 });
 
 testAPIEquivalence('custom API full upgradeable with managed', {
@@ -88,6 +114,8 @@ testAPIEquivalence('custom API full upgradeable with managed', {
   access: 'managed',
   pausable: true,
   upgradeable: 'uups',
+  crossChainMessaging: 'superchain',
+  crossChainFunctionName: 'myCustomFunction',
 });
 
 test('custom API assert defaults', async t => {
diff --git a/packages/core/solidity/src/custom.test.ts.md b/packages/core/solidity/src/custom.test.ts.md
index e23c2db14..05abe88bc 100644
--- a/packages/core/solidity/src/custom.test.ts.md
+++ b/packages/core/solidity/src/custom.test.ts.md
@@ -160,6 +160,105 @@ Generated by [AVA](https://avajs.dev).
     }␊
     `
 
+## superchain messaging
+
+> Snapshot 1
+
+    `// SPDX-License-Identifier: MIT␊
+    // Compatible with OpenZeppelin Contracts ^5.0.0␊
+    pragma solidity ^0.8.27;␊
+    ␊
+    import {IL2ToL2CrossDomainMessenger} from "@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol";␊
+    import {Predeploys} from "@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol";␊
+    ␊
+    contract MyContract {␊
+        IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);␊
+    ␊
+        error CallerNotL2ToL2CrossDomainMessenger();␊
+        error InvalidCrossDomainSender();␊
+        error InvalidDestination();␊
+    ␊
+        modifier onlyCrossDomainCallback() {␊
+            if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
+            if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();␊
+            _;␊
+        }␊
+    ␊
+        // NOTE: Anyone can call this function␊
+        function callMyFunction() public {␊
+            if (_toChainId == block.chainid) revert InvalidDestination();␊
+            messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+        }␊
+    ␊
+        /**␊
+         * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,␊
+         * such as this contract, to be deployed through it, or use CREATE2 from a deployer contract␊
+         * that is itself deployed by an EOA you control.␊
+         * This precaution is critical because if an unauthorized contract is deployed at the same␊
+         * address on any Superchain network, it could allow malicious actors to invoke your function␊
+         * from another chain.␊
+         */␊
+        function myFunction(/* TODO: Add arguments */) external onlyCrossDomainCallback {␊
+            // TODO: Implement logic for the function that will be called from another chain␊
+        }␊
+    }␊
+    `
+
+## superchain messaging ownable pausable
+
+> Snapshot 1
+
+    `// SPDX-License-Identifier: MIT␊
+    // Compatible with OpenZeppelin Contracts ^5.0.0␊
+    pragma solidity ^0.8.27;␊
+    ␊
+    import {IL2ToL2CrossDomainMessenger} from "@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol";␊
+    import {Ownable} from "@openzeppelin/contracts/access/Ownable.sol";␊
+    import {Pausable} from "@openzeppelin/contracts/utils/Pausable.sol";␊
+    import {Predeploys} from "@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol";␊
+    ␊
+    contract MyContract is Ownable, Pausable {␊
+        IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);␊
+    ␊
+        error CallerNotL2ToL2CrossDomainMessenger();␊
+        error InvalidCrossDomainSender();␊
+        error InvalidDestination();␊
+    ␊
+        modifier onlyCrossDomainCallback() {␊
+            if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
+            if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();␊
+            _;␊
+        }␊
+    ␊
+        constructor(address initialOwner) Ownable(initialOwner) {}␊
+    ␊
+        function callMyFunction() public onlyOwner whenNotPaused {␊
+            if (_toChainId == block.chainid) revert InvalidDestination();␊
+            messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+        }␊
+    ␊
+        /**␊
+         * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,␊
+         * such as this contract, to be deployed through it, or use CREATE2 from a deployer contract␊
+         * that is itself deployed by an EOA you control.␊
+         * This precaution is critical because if an unauthorized contract is deployed at the same␊
+         * address on any Superchain network, it could allow malicious actors to invoke your function␊
+         * from another chain.␊
+         */␊
+        function myFunction(/* TODO: Add arguments */) external onlyCrossDomainCallback whenNotPaused {␊
+            // TODO: Implement logic for the function that will be called from another chain␊
+        }␊
+    ␊
+        function pause() public onlyOwner {␊
+            _pause();␊
+        }␊
+    ␊
+        function unpause() public onlyOwner {␊
+            _unpause();␊
+        }␊
+    }␊
+    `
+
 ## upgradeable uups with access control disabled
 
 > Snapshot 1
diff --git a/packages/core/solidity/src/custom.test.ts.snap b/packages/core/solidity/src/custom.test.ts.snap
index 62f68ccd2e52ddd8468c70155300257173075375..41b638e40148a9d25cd55510eb048ff8b6f46849 100644
GIT binary patch
literal 1593
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

literal 859
zcmV-h1El;xRzV<BZeeh9Xm4~Nb~6eC0H`RZLbOwbtFLA)CRnkCmk8EQ<D(RL;F7RA
zjtd)zR3D2700000000B+R!wUYK^RUfBJ54CUS4}jpve|Nl;+aVR#<3EX&Yz-8z#Gx
zWN>z7n3-*wgdU1FPvSqQf6jm4S@yF#o7AKt4VCV3_IW>^_j&i(x$gHUcR#DIKd>g6
z;=UUw&3&R65^Bh`y1Mo}q|wRuwbHXv_>`ZPo<I3gvTZmz*gdK36BjduYmSGRCVhhC
z7POpW%eG;M`vPgwqZmd+51}nE`-p|WlrY%gOiScy1!r&SoApggNHp*fC{Bq-^cc=I
z>+kBX-!?4EO`y;kr%^DqF0G{Hi<fcFz>trDC<qvFxrafaKAt7=%^-5M5+d_x3<U}l
z>e1PjPs_iIo`06_v1j57E;UTsBNjGy34O_ZSl{LXvq_TAPKhZSxh_`9PSAD5>3So}
zagZ=vlqArEDmz6dN#?ErQINtmASnt{3jo07OlcXon#&6EJc*S8!iXk_wnq%hYKpIz
zr_)O-ith)^)r2z$b-|S?h@eM_3!Kq$1WoFMPdC9dqLX5RfGv|EL#0Ww%@_q@Ad!b7
za#|v$1d^fPvx}mQMZv3B6epf0nJl4nEyv6jl3$Dy?TsW07QnzJ6SZv{wqsk^;*+$D
zss$`Gg&LxikMbKbvoY1YG#-gIEGvYinj@3Q%M=7c&FZs84ShbX{ZIN7oT76RdY3Au
zf#i}Ds&qOBM}Ju&Po$9ME~}OqPA+}}3JLFjA5HHe8RixfOf2aJXP8nqq1X-In?~8l
zp$ep9^er8AQJ{xhl1VzZtTBd1jxQ+oG1Dl-R<ja>X)GC{*#SStQW6i}9HgEaolNug
z8Lt#XnsN%s^t^|3$2l)>;IS-o{s6BG4lf?sRpGWT@1OnKvytk;NF}Fuj%AlmjDb3<
z7-%!<bSG|f$*~$S3x;c8|1e??_fbG~)AI>43~3+{(}$em%I@C#W@rDn+uUtAAG(L_
z{k;t{Z05IFTx}mQG??>so|YX$iLKQs(TZDKQi+(5w2j!M6iKj)m%bTWsvcL($ja>d
l{3mcxD_&XRDJ^T5kN26!`^@8g=HBizzX43iV)v{O0090Al8*oY


From c927b52cd67efa43e538d043edb62b84843039da Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 17:43:34 -0400
Subject: [PATCH 20/54] Update AI fn defs

---
 .../common/src/ai/descriptions/solidity.ts    |  6 ++++++
 packages/core/solidity/src/custom.test.ts     |  8 +++----
 packages/mcp/src/solidity/schemas.ts          |  7 +++++++
 .../mcp/src/solidity/tools/custom.test.ts     |  2 ++
 packages/mcp/src/solidity/tools/custom.ts     |  4 +++-
 .../function-definitions/solidity.ts          | 21 ++++++++++++-------
 6 files changed, 35 insertions(+), 13 deletions(-)

diff --git a/packages/common/src/ai/descriptions/solidity.ts b/packages/common/src/ai/descriptions/solidity.ts
index f6438fdd3..56155775d 100644
--- a/packages/common/src/ai/descriptions/solidity.ts
+++ b/packages/common/src/ai/descriptions/solidity.ts
@@ -95,3 +95,9 @@ export const solidityGovernorDescriptions = {
   storage: 'Enable storage of proposal details and enumerability of proposals',
   settings: 'Allow governance to update voting settings (delay, period, proposal threshold)',
 };
+
+export const solidityCustomDescriptions = {
+  crossChainMessaging: 'Whether to add an example for Superchain interop message passing',
+  crossChainFunctionName:
+    'The name of a custom function that will be callable from another chain, default is "myFunction"',
+};
diff --git a/packages/core/solidity/src/custom.test.ts b/packages/core/solidity/src/custom.test.ts
index 7ceff4534..b760a17b1 100644
--- a/packages/core/solidity/src/custom.test.ts
+++ b/packages/core/solidity/src/custom.test.ts
@@ -1,5 +1,6 @@
 import test from 'ava';
-import { custom, OptionsError } from '.';
+import type { OptionsError } from '.';
+import { custom } from '.';
 
 import type { CustomOptions } from './custom';
 import { buildCustom } from './custom';
@@ -84,10 +85,7 @@ test('superchain messaging, invalid function name', async t => {
       crossChainFunctionName: '  ',
     }),
   );
-  t.is(
-    (error as OptionsError).messages.crossChainFunctionName,
-    'Not a valid function name',
-  );
+  t.is((error as OptionsError).messages.crossChainFunctionName, 'Not a valid function name');
 });
 
 testCustom('upgradeable uups with access control disabled', {
diff --git a/packages/mcp/src/solidity/schemas.ts b/packages/mcp/src/solidity/schemas.ts
index 617f2fb25..e9b9935d2 100644
--- a/packages/mcp/src/solidity/schemas.ts
+++ b/packages/mcp/src/solidity/schemas.ts
@@ -9,6 +9,7 @@ import {
   solidityGovernorDescriptions,
   solidityAccountDescriptions,
   solidityStablecoinDescriptions,
+  solidityCustomDescriptions,
 } from '@openzeppelin/wizard-common';
 import type { KindedOptions } from '@openzeppelin/wizard';
 
@@ -176,5 +177,11 @@ export const governorSchema = {
 export const customSchema = {
   name: z.string().describe(commonDescriptions.name),
   pausable: z.boolean().optional().describe(commonDescriptions.pausable),
+  crossChainMessaging: z
+    .literal('superchain')
+    .or(z.literal(false))
+    .optional()
+    .describe(solidityCustomDescriptions.crossChainMessaging),
+  crossChainFunctionName: z.string().optional().describe(solidityCustomDescriptions.crossChainFunctionName),
   ...commonSchema,
 } as const satisfies z.ZodRawShape;
diff --git a/packages/mcp/src/solidity/tools/custom.test.ts b/packages/mcp/src/solidity/tools/custom.test.ts
index d2e2baf6e..2483d90bc 100644
--- a/packages/mcp/src/solidity/tools/custom.test.ts
+++ b/packages/mcp/src/solidity/tools/custom.test.ts
@@ -43,6 +43,8 @@ test('all', async t => {
     pausable: true,
     access: 'roles',
     upgradeable: 'uups',
+    crossChainMessaging: 'superchain',
+    crossChainFunctionName: 'myCustomFunction',
     info: {
       license: 'MIT',
       securityContact: 'security@example.com',
diff --git a/packages/mcp/src/solidity/tools/custom.ts b/packages/mcp/src/solidity/tools/custom.ts
index cd9bba4f2..ddda8bdd0 100644
--- a/packages/mcp/src/solidity/tools/custom.ts
+++ b/packages/mcp/src/solidity/tools/custom.ts
@@ -10,10 +10,12 @@ export function registerSolidityCustom(server: McpServer): RegisteredTool {
     'solidity-custom',
     makeDetailedPrompt(solidityPrompts.Custom),
     customSchema,
-    async ({ name, pausable, access, upgradeable, info }) => {
+    async ({ name, pausable, crossChainMessaging, crossChainFunctionName, access, upgradeable, info }) => {
       const opts: CustomOptions = {
         name,
         pausable,
+        crossChainMessaging,
+        crossChainFunctionName,
         access,
         upgradeable,
         info,
diff --git a/packages/ui/api/ai-assistant/function-definitions/solidity.ts b/packages/ui/api/ai-assistant/function-definitions/solidity.ts
index 00df94474..84ce47e60 100644
--- a/packages/ui/api/ai-assistant/function-definitions/solidity.ts
+++ b/packages/ui/api/ai-assistant/function-definitions/solidity.ts
@@ -315,13 +315,20 @@ export const solidityCustomAIFunctionDefinition = {
   description: solidityPrompts.Custom,
   parameters: {
     type: 'object',
-    properties: addFunctionPropertiesFrom(commonFunctionDescription, [
-      'name',
-      'pausable',
-      'access',
-      'upgradeable',
-      'info',
-    ]),
+    properties: {
+      ...addFunctionPropertiesFrom(commonFunctionDescription, ['name', 'pausable', 'access', 'upgradeable', 'info']),
+      crossChainMessaging: {
+        anyOf: [
+          { type: 'string', enum: ['superchain'] },
+          { type: 'boolean', enum: [false] },
+        ],
+        description: solidityCustomDescriptions.crossChainMessaging,
+      },
+      crossChainFunctionName: {
+        type: 'string',
+        description: solidityCustomDescriptions.crossChainFunctionName,
+      },
+    },
     required: ['name'],
     additionalProperties: false,
   },

From 84ca34dd8b7d9e444533e183c825f8c114622e14 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 17:46:53 -0400
Subject: [PATCH 21/54] Add changeset

---
 .changeset/some-fans-tell.md | 7 +++++++
 1 file changed, 7 insertions(+)
 create mode 100644 .changeset/some-fans-tell.md

diff --git a/.changeset/some-fans-tell.md b/.changeset/some-fans-tell.md
new file mode 100644
index 000000000..283fac3cb
--- /dev/null
+++ b/.changeset/some-fans-tell.md
@@ -0,0 +1,7 @@
+---
+'@openzeppelin/wizard': patch
+'@openzeppelin/wizard-common': patch
+'@openzeppelin/wizard-mcp': patch
+---
+
+Add option for Superchain interop message passing in Custom contracts

From d45742c40d5a865f78b3f0761732b8bfe92cd8a0 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 17:48:19 -0400
Subject: [PATCH 22/54] Fix import

---
 packages/ui/api/ai-assistant/function-definitions/solidity.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/packages/ui/api/ai-assistant/function-definitions/solidity.ts b/packages/ui/api/ai-assistant/function-definitions/solidity.ts
index 84ce47e60..207177285 100644
--- a/packages/ui/api/ai-assistant/function-definitions/solidity.ts
+++ b/packages/ui/api/ai-assistant/function-definitions/solidity.ts
@@ -9,6 +9,7 @@ import {
   solidityERC1155Descriptions,
   solidityStablecoinDescriptions,
   solidityGovernorDescriptions,
+  solidityCustomDescriptions,
 } from '../../../../common/src/ai/descriptions/solidity.ts';
 
 export const solidityERC20AIFunctionDefinition = {

From 4c6e35fa665d6bfdbda870b09e37f0c7973a9b43 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 4 Jul 2025 17:50:53 -0400
Subject: [PATCH 23/54] lint svelte

---
 .../src/common/ParentExpandableSection.svelte |  4 +-
 .../CrossChainMessagingSection.svelte         | 59 ++++++++-----------
 .../ui/src/solidity/CustomControls.svelte     |  6 +-
 3 files changed, 34 insertions(+), 35 deletions(-)

diff --git a/packages/ui/src/common/ParentExpandableSection.svelte b/packages/ui/src/common/ParentExpandableSection.svelte
index 9cfb14598..23bda917f 100644
--- a/packages/ui/src/common/ParentExpandableSection.svelte
+++ b/packages/ui/src/common/ParentExpandableSection.svelte
@@ -75,7 +75,9 @@
             />
           {/if}
         </span>
-        <span class="flex items-center">{label}{#if icon}&nbsp;&nbsp;<svelte:component this={icon}/>{/if}</span>
+        <span class="flex items-center"
+          >{label}{#if icon}&nbsp;&nbsp;<svelte:component this={icon} />{/if}</span
+        >
       </div>
       <div class="flex items-center">
         <button
diff --git a/packages/ui/src/solidity/CrossChainMessagingSection.svelte b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
index 24ea5a714..6f545a7a0 100644
--- a/packages/ui/src/solidity/CrossChainMessagingSection.svelte
+++ b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
@@ -1,35 +1,28 @@
 <script lang="ts">
-    import HelpTooltip from '../common/HelpTooltip.svelte';
-    import ExpandableCheckbox from '../common/ExpandableCheckbox.svelte';
-    import OPIcon from '../common/icons/OPIcon.svelte';
-    import { error } from '../common/error-tooltip';
-    import type { OptionsErrorMessages } from '@openzeppelin/wizard';
+  import HelpTooltip from '../common/HelpTooltip.svelte';
+  import ExpandableCheckbox from '../common/ExpandableCheckbox.svelte';
+  import OPIcon from '../common/icons/OPIcon.svelte';
+  import { error } from '../common/error-tooltip';
+  import type { OptionsErrorMessages } from '@openzeppelin/wizard';
 
-    export let enabled: boolean;
-    export let functionName: string;
-    export let errors: undefined | OptionsErrorMessages;
-  </script>
-  
-  <ExpandableCheckbox
-    label="Cross-Chain Messaging"
-    icon={OPIcon}
-    bind:checked={enabled}
-    helpContent="Adds an example for Superchain interop message passing."
-    helpLink="https://docs.optimism.io/interop/message-passing"
-    error={errors?.crossChainFunctionName}
-  >
-    <label class="labeled-input">
-      <span class="flex justify-between pr-2">
-        Function Name
-        <HelpTooltip>
-          The name of a custom function that will be callable from another chain.
-        </HelpTooltip>
-      </span>
-      <input
-        bind:value={functionName}
-        use:error={errors?.crossChainFunctionName}
-        disabled={!enabled}
-      />
-    </label>
-  </ExpandableCheckbox>
-  
\ No newline at end of file
+  export let enabled: boolean;
+  export let functionName: string;
+  export let errors: undefined | OptionsErrorMessages;
+</script>
+
+<ExpandableCheckbox
+  label="Cross-Chain Messaging"
+  icon={OPIcon}
+  bind:checked={enabled}
+  helpContent="Adds an example for Superchain interop message passing."
+  helpLink="https://docs.optimism.io/interop/message-passing"
+  error={errors?.crossChainFunctionName}
+>
+  <label class="labeled-input">
+    <span class="flex justify-between pr-2">
+      Function Name
+      <HelpTooltip>The name of a custom function that will be callable from another chain.</HelpTooltip>
+    </span>
+    <input bind:value={functionName} use:error={errors?.crossChainFunctionName} disabled={!enabled} />
+  </label>
+</ExpandableCheckbox>
diff --git a/packages/ui/src/solidity/CustomControls.svelte b/packages/ui/src/solidity/CustomControls.svelte
index a317fbef0..7b1ae85a0 100644
--- a/packages/ui/src/solidity/CustomControls.svelte
+++ b/packages/ui/src/solidity/CustomControls.svelte
@@ -47,7 +47,11 @@
   </div>
 </section>
 
-<CrossChainMessagingSection bind:enabled={crossChainMessagingEnabled} bind:functionName={opts.crossChainFunctionName} {errors} />
+<CrossChainMessagingSection
+  bind:enabled={crossChainMessagingEnabled}
+  bind:functionName={opts.crossChainFunctionName}
+  {errors}
+/>
 
 <AccessControlSection bind:access={opts.access} required={requireAccessControl} />
 

From 019c9ba03adf7e12aa8b609378656a9c5087e185 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Mon, 28 Jul 2025 16:51:55 -0400
Subject: [PATCH 24/54] Add tooltip when enabled

---
 .../CrossChainMessagingSection.svelte         | 21 ++++++++++++++++++-
 packages/ui/src/solidity/ERC20Controls.svelte |  4 ++--
 .../solidity/RealWorldAssetControls.svelte    |  4 ++--
 .../ui/src/solidity/StablecoinControls.svelte |  4 ++--
 .../ui/src/solidity/superchain-tooltip.ts     | 17 ++++++++++++---
 5 files changed, 40 insertions(+), 10 deletions(-)

diff --git a/packages/ui/src/solidity/CrossChainMessagingSection.svelte b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
index 6f545a7a0..91a9af8bd 100644
--- a/packages/ui/src/solidity/CrossChainMessagingSection.svelte
+++ b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
@@ -8,6 +8,25 @@
   export let enabled: boolean;
   export let functionName: string;
   export let errors: undefined | OptionsErrorMessages;
+
+  // Show notice when enabled
+  import { superchainGenericTooltipProps } from './superchain-tooltip';
+  import tippy, { type Instance as TippyInstance } from 'tippy.js';
+  import { onMount } from 'svelte';
+
+  let crosschainLabel: HTMLElement;
+  let crosschainTooltip: TippyInstance;
+  onMount(() => {
+    crosschainTooltip = tippy(crosschainLabel, superchainGenericTooltipProps);
+  });
+
+  let wasCrosschain = false;
+  $: {
+    if (!wasCrosschain && enabled) {
+      crosschainTooltip.show();
+    }
+    wasCrosschain = enabled;
+  }
 </script>
 
 <ExpandableCheckbox
@@ -18,7 +37,7 @@
   helpLink="https://docs.optimism.io/interop/message-passing"
   error={errors?.crossChainFunctionName}
 >
-  <label class="labeled-input">
+  <label bind:this={crosschainLabel} class="labeled-input">
     <span class="flex justify-between pr-2">
       Function Name
       <HelpTooltip>The name of a custom function that will be callable from another chain.</HelpTooltip>
diff --git a/packages/ui/src/solidity/ERC20Controls.svelte b/packages/ui/src/solidity/ERC20Controls.svelte
index d0c484261..eabfba103 100644
--- a/packages/ui/src/solidity/ERC20Controls.svelte
+++ b/packages/ui/src/solidity/ERC20Controls.svelte
@@ -11,7 +11,7 @@
   import OPIcon from '../common/icons/OPIcon.svelte';
   import { error } from '../common/error-tooltip';
   import { resizeToFit } from '../common/resize-to-fit';
-  import { superchainTooltipProps } from './superchain-tooltip';
+  import { superchainERC20TooltipProps } from './superchain-tooltip';
 
   export let opts: Required<KindedOptions['ERC20']> = {
     kind: 'ERC20',
@@ -31,7 +31,7 @@
   let superchainLabel: HTMLElement;
   let superchainTooltip: TippyInstance;
   onMount(() => {
-    superchainTooltip = tippy(superchainLabel, superchainTooltipProps);
+    superchainTooltip = tippy(superchainLabel, superchainERC20TooltipProps);
   });
 
   let wasSuperchain = false;
diff --git a/packages/ui/src/solidity/RealWorldAssetControls.svelte b/packages/ui/src/solidity/RealWorldAssetControls.svelte
index 557c0e75a..68e9665aa 100644
--- a/packages/ui/src/solidity/RealWorldAssetControls.svelte
+++ b/packages/ui/src/solidity/RealWorldAssetControls.svelte
@@ -11,7 +11,7 @@
   import OPIcon from '../common/icons/OPIcon.svelte';
   import { error } from '../common/error-tooltip';
   import { resizeToFit } from '../common/resize-to-fit';
-  import { superchainTooltipProps } from './superchain-tooltip';
+  import { superchainERC20TooltipProps } from './superchain-tooltip';
 
   export let opts: Required<KindedOptions['RealWorldAsset']> = {
     kind: 'RealWorldAsset',
@@ -33,7 +33,7 @@
   let superchainLabel: HTMLElement;
   let superchainTooltip: TippyInstance;
   onMount(() => {
-    superchainTooltip = tippy(superchainLabel, superchainTooltipProps);
+    superchainTooltip = tippy(superchainLabel, superchainERC20TooltipProps);
   });
 
   let wasSuperchain = false;
diff --git a/packages/ui/src/solidity/StablecoinControls.svelte b/packages/ui/src/solidity/StablecoinControls.svelte
index 5d1d2f992..280c5a465 100644
--- a/packages/ui/src/solidity/StablecoinControls.svelte
+++ b/packages/ui/src/solidity/StablecoinControls.svelte
@@ -10,7 +10,7 @@
   import OPIcon from '../common/icons/OPIcon.svelte';
   import { error } from '../common/error-tooltip';
   import { resizeToFit } from '../common/resize-to-fit';
-  import { superchainTooltipProps } from './superchain-tooltip';
+  import { superchainERC20TooltipProps } from './superchain-tooltip';
 
   export let opts: Required<KindedOptions['Stablecoin']> = {
     kind: 'Stablecoin',
@@ -30,7 +30,7 @@
   let superchainLabel: HTMLElement;
   let superchainTooltip: TippyInstance;
   onMount(() => {
-    superchainTooltip = tippy(superchainLabel, superchainTooltipProps);
+    superchainTooltip = tippy(superchainLabel, superchainERC20TooltipProps);
   });
 
   let wasSuperchain = false;
diff --git a/packages/ui/src/solidity/superchain-tooltip.ts b/packages/ui/src/solidity/superchain-tooltip.ts
index ff466d3a0..14083f0ef 100644
--- a/packages/ui/src/solidity/superchain-tooltip.ts
+++ b/packages/ui/src/solidity/superchain-tooltip.ts
@@ -1,12 +1,23 @@
 /**
- * Tippy.js properties for the Superchain tooltip.
+ * Tippy.js properties for generic Superchain tooltips.
  */
-export const superchainTooltipProps: { [prop: string]: string | boolean } = {
+export const superchainGenericTooltipProps: { [prop: string]: string | boolean } = {
   content:
-    '<strong>Important:</strong> Only available on chains in the Superchain. Requires deploying your contract to the same address on every chain in the Superchain. <a class="light-link" href="https://docs.optimism.io/stack/interop/superchain-erc20#requirements" target="_blank" rel="noopener noreferrer">Read more.</a>',
+    '<strong>Important:</strong> Only available on chains in the Superchain. Requires deploying your contract to the same address on every chain in the Superchain.',
   trigger: 'manual',
   placement: 'bottom',
   maxWidth: '22em',
   allowHTML: true,
   interactive: true,
 };
+
+const ERC20_READ_MORE =
+  ' <a class="light-link" href="https://docs.optimism.io/stack/interop/superchain-erc20#requirements" target="_blank" rel="noopener noreferrer">Read more.</a>';
+
+/**
+ * Tippy.js properties for the SuperchainERC20 tooltip.
+ */
+export const superchainERC20TooltipProps: { [prop: string]: string | boolean } = {
+  ...superchainGenericTooltipProps,
+  content: superchainGenericTooltipProps.content + ERC20_READ_MORE,
+};

From 2e3dd4df51661962f9cbff1fa9f97a293be7c306 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Mon, 28 Jul 2025 18:21:01 -0400
Subject: [PATCH 25/54] Fix compile

---
 packages/core/solidity/remappings.txt         |   1 +
 .../solidity/src/add-superchain-messaging.ts  |   4 +++-
 packages/core/solidity/src/custom.test.ts.md  |   4 ++--
 .../core/solidity/src/custom.test.ts.snap     | Bin 1593 -> 1605 bytes
 4 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/packages/core/solidity/remappings.txt b/packages/core/solidity/remappings.txt
index 7f8667df0..fac0d0873 100644
--- a/packages/core/solidity/remappings.txt
+++ b/packages/core/solidity/remappings.txt
@@ -1,2 +1,3 @@
 @openzeppelin/community-contracts/=node_modules/@openzeppelin/community-contracts/contracts/
 @openzeppelin/contracts-upgradeable/=node_modules/@openzeppelin/contracts-upgradeable/
+@eth-optimism/contracts-bedrock/=node_modules/@eth-optimism/contracts-bedrock/
diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index 89225a3c0..7aeddd231 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -62,7 +62,9 @@ function addSourceFunction(sanitizedFunctionName: string, access: Access, c: Con
   const sourceFn: BaseFunction = {
     name: `call${sanitizedFunctionName.replace(/^(.)/, c => c.toUpperCase())}`,
     kind: 'public' as const,
-    args: [],
+    args: [
+      { name: '_toChainId', type: 'uint256' },
+    ],
   };
 
   if (access) {
diff --git a/packages/core/solidity/src/custom.test.ts.md b/packages/core/solidity/src/custom.test.ts.md
index 05abe88bc..ad17ba6aa 100644
--- a/packages/core/solidity/src/custom.test.ts.md
+++ b/packages/core/solidity/src/custom.test.ts.md
@@ -185,7 +185,7 @@ Generated by [AVA](https://avajs.dev).
         }␊
     ␊
         // NOTE: Anyone can call this function␊
-        function callMyFunction() public {␊
+        function callMyFunction(uint256 _toChainId) public {␊
             if (_toChainId == block.chainid) revert InvalidDestination();␊
             messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
         }␊
@@ -232,7 +232,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
         constructor(address initialOwner) Ownable(initialOwner) {}␊
     ␊
-        function callMyFunction() public onlyOwner whenNotPaused {␊
+        function callMyFunction(uint256 _toChainId) public onlyOwner whenNotPaused {␊
             if (_toChainId == block.chainid) revert InvalidDestination();␊
             messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
         }␊
diff --git a/packages/core/solidity/src/custom.test.ts.snap b/packages/core/solidity/src/custom.test.ts.snap
index 41b638e40148a9d25cd55510eb048ff8b6f46849..fae15ce565c5cab564fd45acf9f09acb508e8ccf 100644
GIT binary patch
literal 1605
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
D%RuVW

literal 1593
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


From c12b3885d833b829b358f2c8216ab6154a79695c Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Mon, 28 Jul 2025 18:34:11 -0400
Subject: [PATCH 26/54] WIP test get imports

---
 packages/core/solidity/src/get-imports.test.ts | 12 ++++++++++++
 packages/core/solidity/src/scripts/prepare.ts  |  6 ++++--
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/packages/core/solidity/src/get-imports.test.ts b/packages/core/solidity/src/get-imports.test.ts
index d6f1509bb..4c8eff7d1 100644
--- a/packages/core/solidity/src/get-imports.test.ts
+++ b/packages/core/solidity/src/get-imports.test.ts
@@ -3,6 +3,7 @@ import test from 'ava';
 import { getImports } from './get-imports';
 import { buildERC20 } from './erc20';
 import { buildERC721 } from './erc721';
+import { buildCustom } from './custom';
 import { generateSources } from './generate/sources';
 import { buildGeneric } from './build-generic';
 
@@ -88,6 +89,17 @@ test('erc721 auto increment uups', t => {
   ]);
 });
 
+test('custom cross chain messaging superchain', t => {
+  const c = buildCustom({ name: 'MyToken', crossChainMessaging: 'superchain' });
+  const sources = getImports(c);
+  const files = Object.keys(sources).sort();
+
+  t.deepEqual(files, [
+    '@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol',
+    '@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol',
+  ]);
+});
+
 test('can get imports for all combinations', t => {
   for (const { options } of generateSources('all')) {
     const c = buildGeneric(options);
diff --git a/packages/core/solidity/src/scripts/prepare.ts b/packages/core/solidity/src/scripts/prepare.ts
index e65e08d9b..459673f3b 100644
--- a/packages/core/solidity/src/scripts/prepare.ts
+++ b/packages/core/solidity/src/scripts/prepare.ts
@@ -26,7 +26,8 @@ async function main() {
     for (const [sourceFile, { ast }] of Object.entries(buildInfo.output.sources)) {
       if (
         sourceFile.startsWith('@openzeppelin/contracts') ||
-        sourceFile.startsWith('@openzeppelin/community-contracts')
+        sourceFile.startsWith('@openzeppelin/community-contracts') ||
+        sourceFile.startsWith('@eth-optimism/contracts-bedrock')
       ) {
         const sourceDependencies = (dependencies[sourceFile] ??= new Set());
         for (const imp of findAll('ImportDirective', ast)) {
@@ -38,7 +39,8 @@ async function main() {
     for (const [sourceFile, { content }] of Object.entries(buildInfo.input.sources)) {
       if (
         sourceFile.startsWith('@openzeppelin/contracts') ||
-        sourceFile.startsWith('@openzeppelin/community-contracts')
+        sourceFile.startsWith('@openzeppelin/community-contracts') ||
+        sourceFile.startsWith('@eth-optimism/contracts-bedrock')
       ) {
         sources[sourceFile] = content;
       }

From 65cce15aec695118e9ee4e65e58beae84883ee8e Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Tue, 29 Jul 2025 11:43:08 -0400
Subject: [PATCH 27/54] Fix minimum cover to get all imports

---
 packages/core/solidity/src/generate/sources.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/core/solidity/src/generate/sources.ts b/packages/core/solidity/src/generate/sources.ts
index c80ad5789..9dee4de6d 100644
--- a/packages/core/solidity/src/generate/sources.ts
+++ b/packages/core/solidity/src/generate/sources.ts
@@ -101,15 +101,15 @@ function generateContractSubset(subset: Subset, kind?: Kind): GeneratedContract[
   if (subset === 'all') {
     return contracts;
   } else {
-    const getParents = (c: GeneratedContract) => c.contract.parents.map(p => p.contract.path);
+    const getImports = (c: GeneratedContract) => c.contract.imports.map(importContract => importContract.path);
     return [
       ...findCover(
         contracts.filter(c => c.options.upgradeable),
-        getParents,
+        getImports,
       ),
       ...findCover(
         contracts.filter(c => !c.options.upgradeable),
-        getParents,
+        getImports,
       ),
     ];
   }

From 716aed2376384821fd4cbc93684e963f34967e50 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Tue, 29 Jul 2025 17:07:33 -0400
Subject: [PATCH 28/54] Lint

---
 packages/core/solidity/src/add-superchain-messaging.ts | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index 7aeddd231..843c63e3b 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -62,9 +62,7 @@ function addSourceFunction(sanitizedFunctionName: string, access: Access, c: Con
   const sourceFn: BaseFunction = {
     name: `call${sanitizedFunctionName.replace(/^(.)/, c => c.toUpperCase())}`,
     kind: 'public' as const,
-    args: [
-      { name: '_toChainId', type: 'uint256' },
-    ],
+    args: [{ name: '_toChainId', type: 'uint256' }],
   };
 
   if (access) {

From 5bb6fe537dc6523eeb24a6e0e750c6aa9b9cc4a0 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Tue, 29 Jul 2025 17:55:21 -0400
Subject: [PATCH 29/54] Update tooltip and natspec messages

---
 .../solidity/src/add-superchain-messaging.ts  |  11 ++++-----
 packages/core/solidity/src/custom.test.ts.md  |  22 ++++++++----------
 .../core/solidity/src/custom.test.ts.snap     | Bin 1605 -> 1605 bytes
 .../ui/src/solidity/superchain-tooltip.ts     |   8 +++----
 4 files changed, 19 insertions(+), 22 deletions(-)

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index 843c63e3b..3acd78e04 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -94,12 +94,11 @@ function addDestinationFunction(sanitizedFunctionName: string, c: ContractBuilde
   c.setFunctionComments(
     [
       '/**',
-      ' * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,',
-      ' * such as this contract, to be deployed through it, or use CREATE2 from a deployer contract',
-      ' * that is itself deployed by an EOA you control.',
-      ' * This precaution is critical because if an unauthorized contract is deployed at the same',
-      ' * address on any Superchain network, it could allow malicious actors to invoke your function',
-      ' * from another chain.',
+      ' * @dev IMPORTANT: This function trusts contracts at the same address on other chains.',
+      ' * If an unauthorized contract is deployed at the same address on any chain in the Superchain, it could allow',
+      ' * malicious actors to invoke your function from that chain.',
+      ' * To prevent this, you must either design the deployer to allow only this contract\'s bytecode to be deployed',
+      ' * through it, or use CREATE2 from a deployer contract that is itself deployed by an EOA you control.',
       ' */',
     ],
     destFn,
diff --git a/packages/core/solidity/src/custom.test.ts.md b/packages/core/solidity/src/custom.test.ts.md
index ad17ba6aa..a8bb3cf8e 100644
--- a/packages/core/solidity/src/custom.test.ts.md
+++ b/packages/core/solidity/src/custom.test.ts.md
@@ -191,12 +191,11 @@ Generated by [AVA](https://avajs.dev).
         }␊
     ␊
         /**␊
-         * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,␊
-         * such as this contract, to be deployed through it, or use CREATE2 from a deployer contract␊
-         * that is itself deployed by an EOA you control.␊
-         * This precaution is critical because if an unauthorized contract is deployed at the same␊
-         * address on any Superchain network, it could allow malicious actors to invoke your function␊
-         * from another chain.␊
+         * @dev IMPORTANT: This function trusts contracts at the same address on other chains.␊
+         * If an unauthorized contract is deployed at the same address on any chain in the Superchain, it could allow␊
+         * malicious actors to invoke your function from that chain.␊
+         * To prevent this, you must either design the deployer to allow only this contract's bytecode to be deployed␊
+         * through it, or use CREATE2 from a deployer contract that is itself deployed by an EOA you control.␊
          */␊
         function myFunction(/* TODO: Add arguments */) external onlyCrossDomainCallback {␊
             // TODO: Implement logic for the function that will be called from another chain␊
@@ -238,12 +237,11 @@ Generated by [AVA](https://avajs.dev).
         }␊
     ␊
         /**␊
-         * @dev IMPORTANT: You must either design the deployer to allow only a specific trusted contract,␊
-         * such as this contract, to be deployed through it, or use CREATE2 from a deployer contract␊
-         * that is itself deployed by an EOA you control.␊
-         * This precaution is critical because if an unauthorized contract is deployed at the same␊
-         * address on any Superchain network, it could allow malicious actors to invoke your function␊
-         * from another chain.␊
+         * @dev IMPORTANT: This function trusts contracts at the same address on other chains.␊
+         * If an unauthorized contract is deployed at the same address on any chain in the Superchain, it could allow␊
+         * malicious actors to invoke your function from that chain.␊
+         * To prevent this, you must either design the deployer to allow only this contract's bytecode to be deployed␊
+         * through it, or use CREATE2 from a deployer contract that is itself deployed by an EOA you control.␊
          */␊
         function myFunction(/* TODO: Add arguments */) external onlyCrossDomainCallback whenNotPaused {␊
             // TODO: Implement logic for the function that will be called from another chain␊
diff --git a/packages/core/solidity/src/custom.test.ts.snap b/packages/core/solidity/src/custom.test.ts.snap
index fae15ce565c5cab564fd45acf9f09acb508e8ccf..d22c479f7319ab9fdf2109ab2445b19733b0c0f8 100644
GIT binary patch
literal 1605
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
D_wWEU

literal 1605
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
D%RuVW

diff --git a/packages/ui/src/solidity/superchain-tooltip.ts b/packages/ui/src/solidity/superchain-tooltip.ts
index 14083f0ef..44d25c218 100644
--- a/packages/ui/src/solidity/superchain-tooltip.ts
+++ b/packages/ui/src/solidity/superchain-tooltip.ts
@@ -3,7 +3,7 @@
  */
 export const superchainGenericTooltipProps: { [prop: string]: string | boolean } = {
   content:
-    '<strong>Important:</strong> Only available on chains in the Superchain. Requires deploying your contract to the same address on every chain in the Superchain.',
+    '<strong>Important:</strong> Only available on chains in the Superchain.',
   trigger: 'manual',
   placement: 'bottom',
   maxWidth: '22em',
@@ -11,13 +11,13 @@ export const superchainGenericTooltipProps: { [prop: string]: string | boolean }
   interactive: true,
 };
 
-const ERC20_READ_MORE =
-  ' <a class="light-link" href="https://docs.optimism.io/stack/interop/superchain-erc20#requirements" target="_blank" rel="noopener noreferrer">Read more.</a>';
+const ERC20_REQUIREMENTS =
+  ' Requires deploying your contract to the same address on every chain in the Superchain. <a class="light-link" href="https://docs.optimism.io/stack/interop/superchain-erc20#requirements" target="_blank" rel="noopener noreferrer">Read more.</a>';
 
 /**
  * Tippy.js properties for the SuperchainERC20 tooltip.
  */
 export const superchainERC20TooltipProps: { [prop: string]: string | boolean } = {
   ...superchainGenericTooltipProps,
-  content: superchainGenericTooltipProps.content + ERC20_READ_MORE,
+  content: superchainGenericTooltipProps.content + ERC20_REQUIREMENTS,
 };

From beeb31a29119be4688ed1004b79cabae6608a7aa Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Tue, 29 Jul 2025 19:06:26 -0400
Subject: [PATCH 30/54] Fix reactivity for ai assistant

---
 packages/core/solidity/src/index.ts           |  2 +-
 .../ui/src/common/ExpandableCheckbox.svelte   |  1 +
 .../src/common/ParentExpandableSection.svelte |  2 +-
 .../CrossChainMessagingSection.svelte         | 20 +++++++++++++------
 .../ui/src/solidity/CustomControls.svelte     |  5 +----
 5 files changed, 18 insertions(+), 12 deletions(-)

diff --git a/packages/core/solidity/src/index.ts b/packages/core/solidity/src/index.ts
index 209c432c3..db7d88cd3 100644
--- a/packages/core/solidity/src/index.ts
+++ b/packages/core/solidity/src/index.ts
@@ -29,4 +29,4 @@ export type { ERC1155Options } from './erc1155';
 export type { StablecoinOptions } from './stablecoin';
 export type { AccountOptions } from './account';
 export type { GovernorOptions } from './governor';
-export type { CustomOptions } from './custom';
+export type { CustomOptions, CrossChainMessaging } from './custom';
diff --git a/packages/ui/src/common/ExpandableCheckbox.svelte b/packages/ui/src/common/ExpandableCheckbox.svelte
index ec7759413..daefdea5b 100644
--- a/packages/ui/src/common/ExpandableCheckbox.svelte
+++ b/packages/ui/src/common/ExpandableCheckbox.svelte
@@ -28,6 +28,7 @@
   {disabledReason}
   {required}
   {error}
+  on:change
 >
   <slot />
 </ParentExpandableSection>
diff --git a/packages/ui/src/common/ParentExpandableSection.svelte b/packages/ui/src/common/ParentExpandableSection.svelte
index 23bda917f..5c809eb01 100644
--- a/packages/ui/src/common/ParentExpandableSection.svelte
+++ b/packages/ui/src/common/ParentExpandableSection.svelte
@@ -66,7 +66,7 @@
       <div class="flex items-center">
         <span class="mr-2">
           {#if type === 'checkbox'}
-            <input type="checkbox" bind:checked={checkboxChecked} disabled={disabled || required} />
+            <input type="checkbox" bind:checked={checkboxChecked} disabled={disabled || required} on:change />
           {:else if type === 'toggleradio'}
             <ToggleRadio
               bind:value={toggleRadioValue}
diff --git a/packages/ui/src/solidity/CrossChainMessagingSection.svelte b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
index 91a9af8bd..69faf2bf4 100644
--- a/packages/ui/src/solidity/CrossChainMessagingSection.svelte
+++ b/packages/ui/src/solidity/CrossChainMessagingSection.svelte
@@ -3,9 +3,9 @@
   import ExpandableCheckbox from '../common/ExpandableCheckbox.svelte';
   import OPIcon from '../common/icons/OPIcon.svelte';
   import { error } from '../common/error-tooltip';
-  import type { OptionsErrorMessages } from '@openzeppelin/wizard';
+  import type { OptionsErrorMessages, CrossChainMessaging } from '@openzeppelin/wizard';
 
-  export let enabled: boolean;
+  export let mode: CrossChainMessaging;
   export let functionName: string;
   export let errors: undefined | OptionsErrorMessages;
 
@@ -20,19 +20,27 @@
     crosschainTooltip = tippy(crosschainLabel, superchainGenericTooltipProps);
   });
 
-  let wasCrosschain = false;
+  $: enabled = mode === 'superchain';
+
+  function handleChange(event: Event) {
+    const target = event.target as HTMLInputElement;
+    mode = target.checked ? 'superchain' : false;
+  }
+
+  let wasEnabled = false;
   $: {
-    if (!wasCrosschain && enabled) {
+    if (!wasEnabled && enabled) {
       crosschainTooltip.show();
     }
-    wasCrosschain = enabled;
+    wasEnabled = enabled;
   }
 </script>
 
 <ExpandableCheckbox
   label="Cross-Chain Messaging"
   icon={OPIcon}
-  bind:checked={enabled}
+  checked={enabled}
+  on:change={handleChange}
   helpContent="Adds an example for Superchain interop message passing."
   helpLink="https://docs.optimism.io/interop/message-passing"
   error={errors?.crossChainFunctionName}
diff --git a/packages/ui/src/solidity/CustomControls.svelte b/packages/ui/src/solidity/CustomControls.svelte
index 7b1ae85a0..906fa049b 100644
--- a/packages/ui/src/solidity/CustomControls.svelte
+++ b/packages/ui/src/solidity/CustomControls.svelte
@@ -17,9 +17,6 @@
     info: { ...infoDefaults }, // create new object since Info is nested
   };
 
-  let crossChainMessagingEnabled = false;
-  $: opts.crossChainMessaging = crossChainMessagingEnabled ? 'superchain' : false;
-
   $: requireAccessControl = custom.isAccessControlRequired(opts);
 </script>
 
@@ -48,7 +45,7 @@
 </section>
 
 <CrossChainMessagingSection
-  bind:enabled={crossChainMessagingEnabled}
+  bind:mode={opts.crossChainMessaging}
   bind:functionName={opts.crossChainFunctionName}
   {errors}
 />

From d415620a9b92aa310a29046e7e162b60665e95da Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Tue, 29 Jul 2025 19:07:06 -0400
Subject: [PATCH 31/54] Lint

---
 packages/core/solidity/src/add-superchain-messaging.ts | 2 +-
 packages/ui/src/solidity/superchain-tooltip.ts         | 3 +--
 2 files changed, 2 insertions(+), 3 deletions(-)

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index 3acd78e04..53afa5187 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -97,7 +97,7 @@ function addDestinationFunction(sanitizedFunctionName: string, c: ContractBuilde
       ' * @dev IMPORTANT: This function trusts contracts at the same address on other chains.',
       ' * If an unauthorized contract is deployed at the same address on any chain in the Superchain, it could allow',
       ' * malicious actors to invoke your function from that chain.',
-      ' * To prevent this, you must either design the deployer to allow only this contract\'s bytecode to be deployed',
+      " * To prevent this, you must either design the deployer to allow only this contract's bytecode to be deployed",
       ' * through it, or use CREATE2 from a deployer contract that is itself deployed by an EOA you control.',
       ' */',
     ],
diff --git a/packages/ui/src/solidity/superchain-tooltip.ts b/packages/ui/src/solidity/superchain-tooltip.ts
index 44d25c218..e28a3382f 100644
--- a/packages/ui/src/solidity/superchain-tooltip.ts
+++ b/packages/ui/src/solidity/superchain-tooltip.ts
@@ -2,8 +2,7 @@
  * Tippy.js properties for generic Superchain tooltips.
  */
 export const superchainGenericTooltipProps: { [prop: string]: string | boolean } = {
-  content:
-    '<strong>Important:</strong> Only available on chains in the Superchain.',
+  content: '<strong>Important:</strong> Only available on chains in the Superchain.',
   trigger: 'manual',
   placement: 'bottom',
   maxWidth: '22em',

From 68f8293cc87604b0076610bda384c52f005b6c93 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 11:47:43 -0400
Subject: [PATCH 32/54] Update prompts and schemas for clarity

---
 packages/common/src/ai/descriptions/solidity.ts | 5 +++--
 packages/mcp/src/solidity/schemas.ts            | 6 +-----
 2 files changed, 4 insertions(+), 7 deletions(-)

diff --git a/packages/common/src/ai/descriptions/solidity.ts b/packages/common/src/ai/descriptions/solidity.ts
index 56155775d..f012751ed 100644
--- a/packages/common/src/ai/descriptions/solidity.ts
+++ b/packages/common/src/ai/descriptions/solidity.ts
@@ -97,7 +97,8 @@ export const solidityGovernorDescriptions = {
 };
 
 export const solidityCustomDescriptions = {
-  crossChainMessaging: 'Whether to add an example for Superchain interop message passing',
+  crossChainMessaging:
+    'Whether to add an example for Superchain interop message passing. Options are "superchain" or false',
   crossChainFunctionName:
-    'The name of a custom function that will be callable from another chain, default is "myFunction"',
+    'The name of a custom function that will be callable from another chain, default is "myFunction". Only used if crossChainMessaging is set to "superchain"',
 };
diff --git a/packages/mcp/src/solidity/schemas.ts b/packages/mcp/src/solidity/schemas.ts
index e9b9935d2..eb657ff70 100644
--- a/packages/mcp/src/solidity/schemas.ts
+++ b/packages/mcp/src/solidity/schemas.ts
@@ -177,11 +177,7 @@ export const governorSchema = {
 export const customSchema = {
   name: z.string().describe(commonDescriptions.name),
   pausable: z.boolean().optional().describe(commonDescriptions.pausable),
-  crossChainMessaging: z
-    .literal('superchain')
-    .or(z.literal(false))
-    .optional()
-    .describe(solidityCustomDescriptions.crossChainMessaging),
+  crossChainMessaging: z.literal('superchain').optional().describe(solidityCustomDescriptions.crossChainMessaging),
   crossChainFunctionName: z.string().optional().describe(solidityCustomDescriptions.crossChainFunctionName),
   ...commonSchema,
 } as const satisfies z.ZodRawShape;

From 9d40c468bbc6a5bef5309b07cec9f533f3300895 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 13:32:50 -0400
Subject: [PATCH 33/54] Add zip hardhat environments and test cases

---
 .../optimism-upgradeable/package-lock.json    | 9442 +++++++++++++++++
 .../hardhat/optimism-upgradeable/package.json |   19 +
 .../hardhat/optimism/package-lock.json        | 7665 +++++++++++++
 .../hardhat/optimism/package.json             |   17 +
 .../core/solidity/src/zip-hardhat.test.ts     |   17 +
 .../core/solidity/src/zip-hardhat.test.ts.md  |  101 +
 .../solidity/src/zip-hardhat.test.ts.snap     |  Bin 2366 -> 3066 bytes
 packages/core/solidity/src/zip-hardhat.ts     |   28 +-
 8 files changed, 17282 insertions(+), 7 deletions(-)
 create mode 100644 packages/core/solidity/src/environments/hardhat/optimism-upgradeable/package-lock.json
 create mode 100644 packages/core/solidity/src/environments/hardhat/optimism-upgradeable/package.json
 create mode 100644 packages/core/solidity/src/environments/hardhat/optimism/package-lock.json
 create mode 100644 packages/core/solidity/src/environments/hardhat/optimism/package.json

diff --git a/packages/core/solidity/src/environments/hardhat/optimism-upgradeable/package-lock.json b/packages/core/solidity/src/environments/hardhat/optimism-upgradeable/package-lock.json
new file mode 100644
index 000000000..0fa32e0ca
--- /dev/null
+++ b/packages/core/solidity/src/environments/hardhat/optimism-upgradeable/package-lock.json
@@ -0,0 +1,9442 @@
+{
+  "name": "hardhat-sample",
+  "version": "0.0.1",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "hardhat-sample",
+      "version": "0.0.1",
+      "license": "ISC",
+      "devDependencies": {
+        "@eth-optimism/contracts-bedrock": "^0.17.3",
+        "@nomicfoundation/hardhat-toolbox": "^6.0.0",
+        "@openzeppelin/contracts": "^5.0.0",
+        "@openzeppelin/contracts-upgradeable": "^5.0.0",
+        "@openzeppelin/hardhat-upgrades": "^3.0.0",
+        "hardhat": "^2.16.1"
+      }
+    },
+    "node_modules/@adraffy/ens-normalize": {
+      "version": "1.10.1",
+      "resolved": "https://registry.npmjs.org/@adraffy/ens-normalize/-/ens-normalize-1.10.1.tgz",
+      "integrity": "sha512-96Z2IP3mYmF1Xg2cDm8f1gWGf/HUVedQ3FMifV4kG/PQ4yEP51xDtRAEfhVNt5f/uzpNkZHwWQuUcu6D6K+Ekw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@aws-crypto/crc32": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/@aws-crypto/crc32/-/crc32-5.2.0.tgz",
+      "integrity": "sha512-nLbCWqQNgUiwwtFsen1AdzAtvuLRsQS8rYgMuxCrdKf9kOssamGLuPwyTY9wyYblNr9+1XM8v6zoDTPPSIeANg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-crypto/util": "^5.2.0",
+        "@aws-sdk/types": "^3.222.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=16.0.0"
+      }
+    },
+    "node_modules/@aws-crypto/sha256-browser": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/@aws-crypto/sha256-browser/-/sha256-browser-5.2.0.tgz",
+      "integrity": "sha512-AXfN/lGotSQwu6HNcEsIASo7kWXZ5HYWvfOmSNKDsEqC4OashTp8alTmaz+F7TC2L083SFv5RdB+qU3Vs1kZqw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-crypto/sha256-js": "^5.2.0",
+        "@aws-crypto/supports-web-crypto": "^5.2.0",
+        "@aws-crypto/util": "^5.2.0",
+        "@aws-sdk/types": "^3.222.0",
+        "@aws-sdk/util-locate-window": "^3.0.0",
+        "@smithy/util-utf8": "^2.0.0",
+        "tslib": "^2.6.2"
+      }
+    },
+    "node_modules/@aws-crypto/sha256-browser/node_modules/@smithy/is-array-buffer": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/@smithy/is-array-buffer/-/is-array-buffer-2.2.0.tgz",
+      "integrity": "sha512-GGP3O9QFD24uGeAXYUjwSTXARoqpZykHadOmA8G5vfJPK0/DC67qa//0qvqrJzL1xc8WQWX7/yc7fwudjPHPhA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/@aws-crypto/sha256-browser/node_modules/@smithy/util-buffer-from": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-buffer-from/-/util-buffer-from-2.2.0.tgz",
+      "integrity": "sha512-IJdWBbTcMQ6DA0gdNhh/BwrLkDR+ADW5Kr1aZmd4k3DIF6ezMV4R2NIAmT08wQJ3yUK82thHWmC/TnK/wpMMIA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/is-array-buffer": "^2.2.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/@aws-crypto/sha256-browser/node_modules/@smithy/util-utf8": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-utf8/-/util-utf8-2.3.0.tgz",
+      "integrity": "sha512-R8Rdn8Hy72KKcebgLiv8jQcQkXoLMOGGv5uI1/k0l+snqkOzQ1R0ChUBCxWMlBsFMekWjq0wRudIweFs7sKT5A==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/util-buffer-from": "^2.2.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/@aws-crypto/sha256-js": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/@aws-crypto/sha256-js/-/sha256-js-5.2.0.tgz",
+      "integrity": "sha512-FFQQyu7edu4ufvIZ+OadFpHHOt+eSTBaYaki44c+akjg7qZg9oOQeLlk77F6tSYqjDAFClrHJk9tMf0HdVyOvA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-crypto/util": "^5.2.0",
+        "@aws-sdk/types": "^3.222.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=16.0.0"
+      }
+    },
+    "node_modules/@aws-crypto/supports-web-crypto": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/@aws-crypto/supports-web-crypto/-/supports-web-crypto-5.2.0.tgz",
+      "integrity": "sha512-iAvUotm021kM33eCdNfwIN//F77/IADDSs58i+MDaOqFrVjZo9bAal0NK7HurRuWLLpF1iLX7gbWrjHjeo+YFg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      }
+    },
+    "node_modules/@aws-crypto/util": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/@aws-crypto/util/-/util-5.2.0.tgz",
+      "integrity": "sha512-4RkU9EsI6ZpBve5fseQlGNUWKMa1RLPQ1dnjnQoe07ldfIzcsGb5hC5W0Dm7u423KWzawlrpbjXBrXCEv9zazQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/types": "^3.222.0",
+        "@smithy/util-utf8": "^2.0.0",
+        "tslib": "^2.6.2"
+      }
+    },
+    "node_modules/@aws-crypto/util/node_modules/@smithy/is-array-buffer": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/@smithy/is-array-buffer/-/is-array-buffer-2.2.0.tgz",
+      "integrity": "sha512-GGP3O9QFD24uGeAXYUjwSTXARoqpZykHadOmA8G5vfJPK0/DC67qa//0qvqrJzL1xc8WQWX7/yc7fwudjPHPhA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/@aws-crypto/util/node_modules/@smithy/util-buffer-from": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-buffer-from/-/util-buffer-from-2.2.0.tgz",
+      "integrity": "sha512-IJdWBbTcMQ6DA0gdNhh/BwrLkDR+ADW5Kr1aZmd4k3DIF6ezMV4R2NIAmT08wQJ3yUK82thHWmC/TnK/wpMMIA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/is-array-buffer": "^2.2.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/@aws-crypto/util/node_modules/@smithy/util-utf8": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-utf8/-/util-utf8-2.3.0.tgz",
+      "integrity": "sha512-R8Rdn8Hy72KKcebgLiv8jQcQkXoLMOGGv5uI1/k0l+snqkOzQ1R0ChUBCxWMlBsFMekWjq0wRudIweFs7sKT5A==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/util-buffer-from": "^2.2.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/client-lambda": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/client-lambda/-/client-lambda-3.750.0.tgz",
+      "integrity": "sha512-lSfKdMBXaSQOh48hleRJEKuVO1wQBOgPIonRkCPU5bpagZckWyeD8p8XSgdF6p22lZZUPuasS6+PEJ6knSYNDQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-crypto/sha256-browser": "5.2.0",
+        "@aws-crypto/sha256-js": "5.2.0",
+        "@aws-sdk/core": "3.750.0",
+        "@aws-sdk/credential-provider-node": "3.750.0",
+        "@aws-sdk/middleware-host-header": "3.734.0",
+        "@aws-sdk/middleware-logger": "3.734.0",
+        "@aws-sdk/middleware-recursion-detection": "3.734.0",
+        "@aws-sdk/middleware-user-agent": "3.750.0",
+        "@aws-sdk/region-config-resolver": "3.734.0",
+        "@aws-sdk/types": "3.734.0",
+        "@aws-sdk/util-endpoints": "3.743.0",
+        "@aws-sdk/util-user-agent-browser": "3.734.0",
+        "@aws-sdk/util-user-agent-node": "3.750.0",
+        "@smithy/config-resolver": "^4.0.1",
+        "@smithy/core": "^3.1.4",
+        "@smithy/eventstream-serde-browser": "^4.0.1",
+        "@smithy/eventstream-serde-config-resolver": "^4.0.1",
+        "@smithy/eventstream-serde-node": "^4.0.1",
+        "@smithy/fetch-http-handler": "^5.0.1",
+        "@smithy/hash-node": "^4.0.1",
+        "@smithy/invalid-dependency": "^4.0.1",
+        "@smithy/middleware-content-length": "^4.0.1",
+        "@smithy/middleware-endpoint": "^4.0.5",
+        "@smithy/middleware-retry": "^4.0.6",
+        "@smithy/middleware-serde": "^4.0.2",
+        "@smithy/middleware-stack": "^4.0.1",
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/node-http-handler": "^4.0.2",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/smithy-client": "^4.1.5",
+        "@smithy/types": "^4.1.0",
+        "@smithy/url-parser": "^4.0.1",
+        "@smithy/util-base64": "^4.0.0",
+        "@smithy/util-body-length-browser": "^4.0.0",
+        "@smithy/util-body-length-node": "^4.0.0",
+        "@smithy/util-defaults-mode-browser": "^4.0.6",
+        "@smithy/util-defaults-mode-node": "^4.0.6",
+        "@smithy/util-endpoints": "^3.0.1",
+        "@smithy/util-middleware": "^4.0.1",
+        "@smithy/util-retry": "^4.0.1",
+        "@smithy/util-stream": "^4.1.1",
+        "@smithy/util-utf8": "^4.0.0",
+        "@smithy/util-waiter": "^4.0.2",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/client-sso": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/client-sso/-/client-sso-3.750.0.tgz",
+      "integrity": "sha512-y0Rx6pTQXw0E61CaptpZF65qNggjqOgymq/RYZU5vWba5DGQ+iqGt8Yq8s+jfBoBBNXshxq8l8Dl5Uq/JTY1wg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-crypto/sha256-browser": "5.2.0",
+        "@aws-crypto/sha256-js": "5.2.0",
+        "@aws-sdk/core": "3.750.0",
+        "@aws-sdk/middleware-host-header": "3.734.0",
+        "@aws-sdk/middleware-logger": "3.734.0",
+        "@aws-sdk/middleware-recursion-detection": "3.734.0",
+        "@aws-sdk/middleware-user-agent": "3.750.0",
+        "@aws-sdk/region-config-resolver": "3.734.0",
+        "@aws-sdk/types": "3.734.0",
+        "@aws-sdk/util-endpoints": "3.743.0",
+        "@aws-sdk/util-user-agent-browser": "3.734.0",
+        "@aws-sdk/util-user-agent-node": "3.750.0",
+        "@smithy/config-resolver": "^4.0.1",
+        "@smithy/core": "^3.1.4",
+        "@smithy/fetch-http-handler": "^5.0.1",
+        "@smithy/hash-node": "^4.0.1",
+        "@smithy/invalid-dependency": "^4.0.1",
+        "@smithy/middleware-content-length": "^4.0.1",
+        "@smithy/middleware-endpoint": "^4.0.5",
+        "@smithy/middleware-retry": "^4.0.6",
+        "@smithy/middleware-serde": "^4.0.2",
+        "@smithy/middleware-stack": "^4.0.1",
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/node-http-handler": "^4.0.2",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/smithy-client": "^4.1.5",
+        "@smithy/types": "^4.1.0",
+        "@smithy/url-parser": "^4.0.1",
+        "@smithy/util-base64": "^4.0.0",
+        "@smithy/util-body-length-browser": "^4.0.0",
+        "@smithy/util-body-length-node": "^4.0.0",
+        "@smithy/util-defaults-mode-browser": "^4.0.6",
+        "@smithy/util-defaults-mode-node": "^4.0.6",
+        "@smithy/util-endpoints": "^3.0.1",
+        "@smithy/util-middleware": "^4.0.1",
+        "@smithy/util-retry": "^4.0.1",
+        "@smithy/util-utf8": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/core": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/core/-/core-3.750.0.tgz",
+      "integrity": "sha512-bZ5K7N5L4+Pa2epbVpUQqd1XLG2uU8BGs/Sd+2nbgTf+lNQJyIxAg/Qsrjz9MzmY8zzQIeRQEkNmR6yVAfCmmQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/core": "^3.1.4",
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/signature-v4": "^5.0.1",
+        "@smithy/smithy-client": "^4.1.5",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-middleware": "^4.0.1",
+        "fast-xml-parser": "4.4.1",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/credential-provider-env": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/credential-provider-env/-/credential-provider-env-3.750.0.tgz",
+      "integrity": "sha512-In6bsG0p/P31HcH4DBRKBbcDS/3SHvEPjfXV8ODPWZO/l3/p7IRoYBdQ07C9R+VMZU2D0+/Sc/DWK/TUNDk1+Q==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/core": "3.750.0",
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/credential-provider-http": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/credential-provider-http/-/credential-provider-http-3.750.0.tgz",
+      "integrity": "sha512-wFB9qqfa20AB0dElsQz5ZlZT5o+a+XzpEpmg0erylmGYqEOvh8NQWfDUVpRmQuGq9VbvW/8cIbxPoNqEbPtuWQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/core": "3.750.0",
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/fetch-http-handler": "^5.0.1",
+        "@smithy/node-http-handler": "^4.0.2",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/smithy-client": "^4.1.5",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-stream": "^4.1.1",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/credential-provider-ini": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/credential-provider-ini/-/credential-provider-ini-3.750.0.tgz",
+      "integrity": "sha512-2YIZmyEr5RUd3uxXpxOLD9G67Bibm4I/65M6vKFP17jVMUT+R1nL7mKqmhEVO2p+BoeV+bwMyJ/jpTYG368PCg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/core": "3.750.0",
+        "@aws-sdk/credential-provider-env": "3.750.0",
+        "@aws-sdk/credential-provider-http": "3.750.0",
+        "@aws-sdk/credential-provider-process": "3.750.0",
+        "@aws-sdk/credential-provider-sso": "3.750.0",
+        "@aws-sdk/credential-provider-web-identity": "3.750.0",
+        "@aws-sdk/nested-clients": "3.750.0",
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/credential-provider-imds": "^4.0.1",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/shared-ini-file-loader": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/credential-provider-node": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/credential-provider-node/-/credential-provider-node-3.750.0.tgz",
+      "integrity": "sha512-THWHHAceLwsOiowPEmKyhWVDlEUxH07GHSw5AQFDvNQtGKOQl0HSIFO1mKObT2Q2Vqzji9Bq8H58SO5BFtNPRw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/credential-provider-env": "3.750.0",
+        "@aws-sdk/credential-provider-http": "3.750.0",
+        "@aws-sdk/credential-provider-ini": "3.750.0",
+        "@aws-sdk/credential-provider-process": "3.750.0",
+        "@aws-sdk/credential-provider-sso": "3.750.0",
+        "@aws-sdk/credential-provider-web-identity": "3.750.0",
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/credential-provider-imds": "^4.0.1",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/shared-ini-file-loader": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/credential-provider-process": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/credential-provider-process/-/credential-provider-process-3.750.0.tgz",
+      "integrity": "sha512-Q78SCH1n0m7tpu36sJwfrUSxI8l611OyysjQeMiIOliVfZICEoHcLHLcLkiR+tnIpZ3rk7d2EQ6R1jwlXnalMQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/core": "3.750.0",
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/shared-ini-file-loader": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/credential-provider-sso": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/credential-provider-sso/-/credential-provider-sso-3.750.0.tgz",
+      "integrity": "sha512-FGYrDjXN/FOQVi/t8fHSv8zCk+NEvtFnuc4cZUj5OIbM4vrfFc5VaPyn41Uza3iv6Qq9rZg0QOwWnqK8lNrqUw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/client-sso": "3.750.0",
+        "@aws-sdk/core": "3.750.0",
+        "@aws-sdk/token-providers": "3.750.0",
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/shared-ini-file-loader": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/credential-provider-web-identity": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/credential-provider-web-identity/-/credential-provider-web-identity-3.750.0.tgz",
+      "integrity": "sha512-Nz8zs3YJ+GOTSrq+LyzbbC1Ffpt7pK38gcOyNZv76pP5MswKTUKNYBJehqwa+i7FcFQHsCk3TdhR8MT1ZR23uA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/core": "3.750.0",
+        "@aws-sdk/nested-clients": "3.750.0",
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/middleware-host-header": {
+      "version": "3.734.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/middleware-host-header/-/middleware-host-header-3.734.0.tgz",
+      "integrity": "sha512-LW7RRgSOHHBzWZnigNsDIzu3AiwtjeI2X66v+Wn1P1u+eXssy1+up4ZY/h+t2sU4LU36UvEf+jrZti9c6vRnFw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/middleware-logger": {
+      "version": "3.734.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/middleware-logger/-/middleware-logger-3.734.0.tgz",
+      "integrity": "sha512-mUMFITpJUW3LcKvFok176eI5zXAUomVtahb9IQBwLzkqFYOrMJvWAvoV4yuxrJ8TlQBG8gyEnkb9SnhZvjg67w==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/middleware-recursion-detection": {
+      "version": "3.734.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/middleware-recursion-detection/-/middleware-recursion-detection-3.734.0.tgz",
+      "integrity": "sha512-CUat2d9ITsFc2XsmeiRQO96iWpxSKYFjxvj27Hc7vo87YUHRnfMfnc8jw1EpxEwMcvBD7LsRa6vDNky6AjcrFA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/middleware-user-agent": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/middleware-user-agent/-/middleware-user-agent-3.750.0.tgz",
+      "integrity": "sha512-YYcslDsP5+2NZoN3UwuhZGkhAHPSli7HlJHBafBrvjGV/I9f8FuOO1d1ebxGdEP4HyRXUGyh+7Ur4q+Psk0ryw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/core": "3.750.0",
+        "@aws-sdk/types": "3.734.0",
+        "@aws-sdk/util-endpoints": "3.743.0",
+        "@smithy/core": "^3.1.4",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/nested-clients": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/nested-clients/-/nested-clients-3.750.0.tgz",
+      "integrity": "sha512-OH68BRF0rt9nDloq4zsfeHI0G21lj11a66qosaljtEP66PWm7tQ06feKbFkXHT5E1K3QhJW3nVyK8v2fEBY5fg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-crypto/sha256-browser": "5.2.0",
+        "@aws-crypto/sha256-js": "5.2.0",
+        "@aws-sdk/core": "3.750.0",
+        "@aws-sdk/middleware-host-header": "3.734.0",
+        "@aws-sdk/middleware-logger": "3.734.0",
+        "@aws-sdk/middleware-recursion-detection": "3.734.0",
+        "@aws-sdk/middleware-user-agent": "3.750.0",
+        "@aws-sdk/region-config-resolver": "3.734.0",
+        "@aws-sdk/types": "3.734.0",
+        "@aws-sdk/util-endpoints": "3.743.0",
+        "@aws-sdk/util-user-agent-browser": "3.734.0",
+        "@aws-sdk/util-user-agent-node": "3.750.0",
+        "@smithy/config-resolver": "^4.0.1",
+        "@smithy/core": "^3.1.4",
+        "@smithy/fetch-http-handler": "^5.0.1",
+        "@smithy/hash-node": "^4.0.1",
+        "@smithy/invalid-dependency": "^4.0.1",
+        "@smithy/middleware-content-length": "^4.0.1",
+        "@smithy/middleware-endpoint": "^4.0.5",
+        "@smithy/middleware-retry": "^4.0.6",
+        "@smithy/middleware-serde": "^4.0.2",
+        "@smithy/middleware-stack": "^4.0.1",
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/node-http-handler": "^4.0.2",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/smithy-client": "^4.1.5",
+        "@smithy/types": "^4.1.0",
+        "@smithy/url-parser": "^4.0.1",
+        "@smithy/util-base64": "^4.0.0",
+        "@smithy/util-body-length-browser": "^4.0.0",
+        "@smithy/util-body-length-node": "^4.0.0",
+        "@smithy/util-defaults-mode-browser": "^4.0.6",
+        "@smithy/util-defaults-mode-node": "^4.0.6",
+        "@smithy/util-endpoints": "^3.0.1",
+        "@smithy/util-middleware": "^4.0.1",
+        "@smithy/util-retry": "^4.0.1",
+        "@smithy/util-utf8": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/region-config-resolver": {
+      "version": "3.734.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/region-config-resolver/-/region-config-resolver-3.734.0.tgz",
+      "integrity": "sha512-Lvj1kPRC5IuJBr9DyJ9T9/plkh+EfKLy+12s/mykOy1JaKHDpvj+XGy2YO6YgYVOb8JFtaqloid+5COtje4JTQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-config-provider": "^4.0.0",
+        "@smithy/util-middleware": "^4.0.1",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/token-providers": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/token-providers/-/token-providers-3.750.0.tgz",
+      "integrity": "sha512-X/KzqZw41iWolwNdc8e3RMcNSMR364viHv78u6AefXOO5eRM40c4/LuST1jDzq35/LpnqRhL7/MuixOetw+sFw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/nested-clients": "3.750.0",
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/shared-ini-file-loader": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/types": {
+      "version": "3.734.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/types/-/types-3.734.0.tgz",
+      "integrity": "sha512-o11tSPTT70nAkGV1fN9wm/hAIiLPyWX6SuGf+9JyTp7S/rC2cFWhR26MvA69nplcjNaXVzB0f+QFrLXXjOqCrg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/util-endpoints": {
+      "version": "3.743.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/util-endpoints/-/util-endpoints-3.743.0.tgz",
+      "integrity": "sha512-sN1l559zrixeh5x+pttrnd0A3+r34r0tmPkJ/eaaMaAzXqsmKU/xYre9K3FNnsSS1J1k4PEfk/nHDTVUgFYjnw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-endpoints": "^3.0.1",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/util-locate-window": {
+      "version": "3.723.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/util-locate-window/-/util-locate-window-3.723.0.tgz",
+      "integrity": "sha512-Yf2CS10BqK688DRsrKI/EO6B8ff5J86NXe4C+VCysK7UOgN0l1zOTeTukZ3H8Q9tYYX3oaF1961o8vRkFm7Nmw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@aws-sdk/util-user-agent-browser": {
+      "version": "3.734.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/util-user-agent-browser/-/util-user-agent-browser-3.734.0.tgz",
+      "integrity": "sha512-xQTCus6Q9LwUuALW+S76OL0jcWtMOVu14q+GoLnWPUM7QeUw963oQcLhF7oq0CtaLLKyl4GOUfcwc773Zmwwng==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/types": "^4.1.0",
+        "bowser": "^2.11.0",
+        "tslib": "^2.6.2"
+      }
+    },
+    "node_modules/@aws-sdk/util-user-agent-node": {
+      "version": "3.750.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/util-user-agent-node/-/util-user-agent-node-3.750.0.tgz",
+      "integrity": "sha512-84HJj9G9zbrHX2opLk9eHfDceB+UIHVrmflMzWHpsmo9fDuro/flIBqaVDlE021Osj6qIM0SJJcnL6s23j7JEw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/middleware-user-agent": "3.750.0",
+        "@aws-sdk/types": "3.734.0",
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      },
+      "peerDependencies": {
+        "aws-crt": ">=1.0.0"
+      },
+      "peerDependenciesMeta": {
+        "aws-crt": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@aws-sdk/util-utf8-browser": {
+      "version": "3.259.0",
+      "resolved": "https://registry.npmjs.org/@aws-sdk/util-utf8-browser/-/util-utf8-browser-3.259.0.tgz",
+      "integrity": "sha512-UvFa/vR+e19XookZF8RzFZBrw2EUkQWxiBW0yYQAhvk3C+QVGl0H3ouca8LDBlBfQKXwmW3huo/59H8rwb1wJw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.3.1"
+      }
+    },
+    "node_modules/@bytecodealliance/preview2-shim": {
+      "version": "0.17.0",
+      "resolved": "https://registry.npmjs.org/@bytecodealliance/preview2-shim/-/preview2-shim-0.17.0.tgz",
+      "integrity": "sha512-JorcEwe4ud0x5BS/Ar2aQWOQoFzjq/7jcnxYXCvSMh0oRm0dQXzOA+hqLDBnOMks1LLBA7dmiLLsEBl09Yd6iQ==",
+      "dev": true,
+      "license": "(Apache-2.0 WITH LLVM-exception)"
+    },
+    "node_modules/@colors/colors": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz",
+      "integrity": "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "peer": true,
+      "engines": {
+        "node": ">=0.1.90"
+      }
+    },
+    "node_modules/@cspotcode/source-map-support": {
+      "version": "0.8.1",
+      "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz",
+      "integrity": "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@jridgewell/trace-mapping": "0.3.9"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@eth-optimism/contracts-bedrock": {
+      "version": "0.17.3",
+      "resolved": "https://registry.npmjs.org/@eth-optimism/contracts-bedrock/-/contracts-bedrock-0.17.3.tgz",
+      "integrity": "sha512-cHPO7ntWeOBDLO7ZFFSZGI1D7CDqf4loRbRVJrFIsqLEz+hysWIqA0e3dv2GnrjVeuYePBfI2NTBEG4uwz9bQQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@ethereumjs/rlp": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@ethereumjs/rlp/-/rlp-4.0.1.tgz",
+      "integrity": "sha512-tqsQiBQDQdmPWE1xkkBq4rlSW5QZpLOUJ5RJh2/9fug+q9tnUhuZoVLk7s0scUIKTOzEtR72DFBXI4WiZcMpvw==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "peer": true,
+      "bin": {
+        "rlp": "bin/rlp"
+      },
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@ethereumjs/util": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/@ethereumjs/util/-/util-8.1.0.tgz",
+      "integrity": "sha512-zQ0IqbdX8FZ9aw11vP+dZkKDkS+kgIvQPHnSAXzP9pLu+Rfu3D3XEeLbicvoXJTYnhZiPmsZUxgdzXwNKxRPbA==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "peer": true,
+      "dependencies": {
+        "@ethereumjs/rlp": "^4.0.1",
+        "ethereum-cryptography": "^2.0.0",
+        "micro-ftch": "^0.3.1"
+      },
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@ethereumjs/util/node_modules/@noble/curves": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.4.2.tgz",
+      "integrity": "sha512-TavHr8qycMChk8UwMld0ZDRvatedkzWfH8IiaeGCfymOP5i0hSCozz9vHOL0nkwk7HRMlFnAiKpS2jrUmSybcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.4.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@ethereumjs/util/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@ethereumjs/util/node_modules/ethereum-cryptography": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-2.2.1.tgz",
+      "integrity": "sha512-r/W8lkHSiTLxUxW8Rf3u4HGB0xQweG2RyETjywylKZSzLWoWAijRz8WCuOtJ6wah+avllXBqZuk29HCCvhEIRg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "1.4.2",
+        "@noble/hashes": "1.4.0",
+        "@scure/bip32": "1.4.0",
+        "@scure/bip39": "1.3.0"
+      }
+    },
+    "node_modules/@ethersproject/abi": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/abi/-/abi-5.7.0.tgz",
+      "integrity": "sha512-351ktp42TiRcYB3H1OP8yajPeAQstMW/yCFokj/AthP9bLHzQFPlOrxOcwYEDkUAICmOHljvN4K39OMTMUa9RA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/address": "^5.7.0",
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/constants": "^5.7.0",
+        "@ethersproject/hash": "^5.7.0",
+        "@ethersproject/keccak256": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "@ethersproject/strings": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/abstract-provider": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/abstract-provider/-/abstract-provider-5.7.0.tgz",
+      "integrity": "sha512-R41c9UkchKCpAqStMYUpdunjo3pkEvZC3FAwZn5S5MGbXoMQOHIdHItezTETxAO5bevtMApSyEhn9+CHcDsWBw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/networks": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "@ethersproject/transactions": "^5.7.0",
+        "@ethersproject/web": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/abstract-signer": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/abstract-signer/-/abstract-signer-5.7.0.tgz",
+      "integrity": "sha512-a16V8bq1/Cz+TGCkE2OPMTOUDLS3grCpdjoJCYNnVBbdYEMSgKrU0+B90s8b6H+ByYTBZN7a3g76jdIJi7UfKQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/abstract-provider": "^5.7.0",
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/address": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/address/-/address-5.7.0.tgz",
+      "integrity": "sha512-9wYhYt7aghVGo758POM5nqcOMaE168Q6aRLJZwUmiqSrAungkG74gSSeKEIR7ukixesdRZGPgVqme6vmxs1fkA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/keccak256": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/rlp": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/base64": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/base64/-/base64-5.7.0.tgz",
+      "integrity": "sha512-Dr8tcHt2mEbsZr/mwTPIQAf3Ai0Bks/7gTw9dSqk1mQvhW3XvRlmDJr/4n+wg1JmCl16NZue17CDh8xb/vZ0sQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/bignumber": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/bignumber/-/bignumber-5.8.0.tgz",
+      "integrity": "sha512-ZyaT24bHaSeJon2tGPKIiHszWjD/54Sz8t57Toch475lCLljC6MgPmxk7Gtzz+ddNN5LuHea9qhAe0x3D+uYPA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.8.0",
+        "@ethersproject/logger": "^5.8.0",
+        "bn.js": "^5.2.1"
+      }
+    },
+    "node_modules/@ethersproject/bytes": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/bytes/-/bytes-5.8.0.tgz",
+      "integrity": "sha512-vTkeohgJVCPVHu5c25XWaWQOZ4v+DkGoC42/TS2ond+PARCxTJvgTFUNDZovyQ/uAQ4EcpqqowKydcdmRKjg7A==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/logger": "^5.8.0"
+      }
+    },
+    "node_modules/@ethersproject/constants": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/constants/-/constants-5.8.0.tgz",
+      "integrity": "sha512-wigX4lrf5Vu+axVTIvNsuL6YrV4O5AXl5ubcURKMEME5TnWBouUh0CDTWxZ2GpnRn1kcCgE7l8O5+VbV9QTTcg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bignumber": "^5.8.0"
+      }
+    },
+    "node_modules/@ethersproject/hash": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/hash/-/hash-5.7.0.tgz",
+      "integrity": "sha512-qX5WrQfnah1EFnO5zJv1v46a8HW0+E5xuBBDTwMFZLuVTx0tbU2kkx15NqdjxecrLGatQN9FGQKpb1FKdHCt+g==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/abstract-signer": "^5.7.0",
+        "@ethersproject/address": "^5.7.0",
+        "@ethersproject/base64": "^5.7.0",
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/keccak256": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "@ethersproject/strings": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/keccak256": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/keccak256/-/keccak256-5.7.0.tgz",
+      "integrity": "sha512-2UcPboeL/iW+pSg6vZ6ydF8tCnv3Iu/8tUmLLzWWGzxWKFFqOBQFLo6uLUv6BDrLgCDfN28RJ/wtByx+jZ4KBg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0",
+        "js-sha3": "0.8.0"
+      }
+    },
+    "node_modules/@ethersproject/logger": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/logger/-/logger-5.8.0.tgz",
+      "integrity": "sha512-Qe6knGmY+zPPWTC+wQrpitodgBfH7XoceCGL5bJVejmH+yCS3R8jJm8iiWuvWbG76RUmyEG53oqv6GMVWqunjA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/@ethersproject/networks": {
+      "version": "5.7.1",
+      "resolved": "https://registry.npmjs.org/@ethersproject/networks/-/networks-5.7.1.tgz",
+      "integrity": "sha512-n/MufjFYv3yFcUyfhnXotyDlNdFb7onmkSy8aQERi2PjNcnWQ66xXxa3XlS8nCcA8aJKJjIIMNJTC7tu80GwpQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/logger": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/properties": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/properties/-/properties-5.7.0.tgz",
+      "integrity": "sha512-J87jy8suntrAkIZtecpxEPxY//szqr1mlBaYlQ0r4RCaiD2hjheqF9s1LVE8vVuJCXisjIP+JgtK/Do54ej4Sw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/logger": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/rlp": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/rlp/-/rlp-5.7.0.tgz",
+      "integrity": "sha512-rBxzX2vK8mVF7b0Tol44t5Tb8gomOHkj5guL+HhzQ1yBh/ydjGnpw6at+X6Iw0Kp3OzzzkcKp8N9r0W4kYSs9w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/signing-key": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/signing-key/-/signing-key-5.7.0.tgz",
+      "integrity": "sha512-MZdy2nL3wO0u7gkB4nA/pEf8lu1TlFswPNmy8AiYkfKTdO6eXBJyUdmHO/ehm/htHw9K/qF8ujnTyUAD+Ry54Q==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "bn.js": "^5.2.1",
+        "elliptic": "6.5.4",
+        "hash.js": "1.1.7"
+      }
+    },
+    "node_modules/@ethersproject/strings": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/strings/-/strings-5.7.0.tgz",
+      "integrity": "sha512-/9nu+lj0YswRNSH0NXYqrh8775XNyEdUQAuf3f+SmOrnVewcJ5SBNAjF7lpgehKi4abvNNXyf+HX86czCdJ8Mg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/constants": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/transactions": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/transactions/-/transactions-5.7.0.tgz",
+      "integrity": "sha512-kmcNicCp1lp8qanMTC3RIikGgoJ80ztTyvtsFvCYpSCfkjhD0jZ2LOrnbcuxuToLIUYYf+4XwD1rP+B/erDIhQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/address": "^5.7.0",
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/constants": "^5.7.0",
+        "@ethersproject/keccak256": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "@ethersproject/rlp": "^5.7.0",
+        "@ethersproject/signing-key": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/units": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/units/-/units-5.8.0.tgz",
+      "integrity": "sha512-lxq0CAnc5kMGIiWW4Mr041VT8IhNM+Pn5T3haO74XZWFulk7wH1Gv64HqE96hT4a7iiNMdOCFEBgaxWuk8ETKQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/bignumber": "^5.8.0",
+        "@ethersproject/constants": "^5.8.0",
+        "@ethersproject/logger": "^5.8.0"
+      }
+    },
+    "node_modules/@ethersproject/web": {
+      "version": "5.7.1",
+      "resolved": "https://registry.npmjs.org/@ethersproject/web/-/web-5.7.1.tgz",
+      "integrity": "sha512-Gueu8lSvyjBWL4cYsWsjh6MtMwM0+H4HvqFPZfB6dV8ctbP9zFAO73VG1cMWae0FLPCtz0peKPpZY8/ugJJX2w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/base64": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "@ethersproject/strings": "^5.7.0"
+      }
+    },
+    "node_modules/@fastify/busboy": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/@fastify/busboy/-/busboy-2.1.1.tgz",
+      "integrity": "sha512-vBZP4NlzfOlerQTnba4aqZoMhE/a9HY7HRqoOPaETQcSQuWEIyZMHGfVu6w9wGtGK5fED5qRs2DteVCjOH60sA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@isaacs/cliui": {
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
+      "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "string-width": "^5.1.2",
+        "string-width-cjs": "npm:string-width@^4.2.0",
+        "strip-ansi": "^7.0.1",
+        "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
+        "wrap-ansi": "^8.1.0",
+        "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/ansi-regex": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.1.0.tgz",
+      "integrity": "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/ansi-styles": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz",
+      "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/emoji-regex": {
+      "version": "9.2.2",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
+      "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@isaacs/cliui/node_modules/string-width": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
+      "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "eastasianwidth": "^0.2.0",
+        "emoji-regex": "^9.2.2",
+        "strip-ansi": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/strip-ansi": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz",
+      "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-regex": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/wrap-ansi": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz",
+      "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^6.1.0",
+        "string-width": "^5.0.1",
+        "strip-ansi": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/@jridgewell/resolve-uri": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz",
+      "integrity": "sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.9",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz",
+      "integrity": "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.0.3",
+        "@jridgewell/sourcemap-codec": "^1.4.10"
+      }
+    },
+    "node_modules/@noble/ciphers": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@noble/ciphers/-/ciphers-1.3.0.tgz",
+      "integrity": "sha512-2I0gnIVPtfnMw9ee9h1dJG7tp81+8Ob3OJb3Mv37rx5L40/b0i7djjCVvGOVqc9AEIQyvyu1i6ypKdFw8R8gQw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@noble/curves": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.2.0.tgz",
+      "integrity": "sha512-oYclrNgRaM9SsBUBVbb8M6DTV7ZHRTKugureoYEncY5c65HOmRzvSiTE3y5CYaPYJA/GVkrhXEoF0M3Ya9PMnw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.3.2"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@noble/hashes": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.3.2.tgz",
+      "integrity": "sha512-MVC8EAQp7MvEcm30KWENFjgR+Mkmf+D189XJTkFIlwohU5hcBbn1ZkKq7KVTi2Hme3PMGF390DaL52beVrIihQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@noble/secp256k1": {
+      "version": "1.7.1",
+      "resolved": "https://registry.npmjs.org/@noble/secp256k1/-/secp256k1-1.7.1.tgz",
+      "integrity": "sha512-hOUk6AyBFmqVrv7k5WAw/LpszxVbj9gGN4JRkIX52fdFAj1UA61KXmZDvqVEm+pOyec3+fIeZB02LYa/pWOArw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://paulmillr.com/funding/"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/@nodelib/fs.scandir": {
+      "version": "2.1.5",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
+      "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@nodelib/fs.stat": "2.0.5",
+        "run-parallel": "^1.1.9"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nodelib/fs.stat": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",
+      "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nodelib/fs.walk": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",
+      "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@nodelib/fs.scandir": "2.1.5",
+        "fastq": "^1.6.0"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nomicfoundation/edr": {
+      "version": "0.11.3",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr/-/edr-0.11.3.tgz",
+      "integrity": "sha512-kqILRkAd455Sd6v8mfP3C1/0tCOynJWY+Ir+k/9Boocu2kObCrsFgG+ZWB7fSBVdd9cPVSNrnhWS+V+PEo637g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@nomicfoundation/edr-darwin-arm64": "0.11.3",
+        "@nomicfoundation/edr-darwin-x64": "0.11.3",
+        "@nomicfoundation/edr-linux-arm64-gnu": "0.11.3",
+        "@nomicfoundation/edr-linux-arm64-musl": "0.11.3",
+        "@nomicfoundation/edr-linux-x64-gnu": "0.11.3",
+        "@nomicfoundation/edr-linux-x64-musl": "0.11.3",
+        "@nomicfoundation/edr-win32-x64-msvc": "0.11.3"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-darwin-arm64": {
+      "version": "0.11.3",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-darwin-arm64/-/edr-darwin-arm64-0.11.3.tgz",
+      "integrity": "sha512-w0tksbdtSxz9nuzHKsfx4c2mwaD0+l5qKL2R290QdnN9gi9AV62p9DHkOgfBdyg6/a6ZlnQqnISi7C9avk/6VA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-darwin-x64": {
+      "version": "0.11.3",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-darwin-x64/-/edr-darwin-x64-0.11.3.tgz",
+      "integrity": "sha512-QR4jAFrPbOcrO7O2z2ESg+eUeIZPe2bPIlQYgiJ04ltbSGW27FblOzdd5+S3RoOD/dsZGKAvvy6dadBEl0NgoA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-linux-arm64-gnu": {
+      "version": "0.11.3",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-linux-arm64-gnu/-/edr-linux-arm64-gnu-0.11.3.tgz",
+      "integrity": "sha512-Ktjv89RZZiUmOFPspuSBVJ61mBZQ2+HuLmV67InNlh9TSUec/iDjGIwAn59dx0bF/LOSrM7qg5od3KKac4LJDQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-linux-arm64-musl": {
+      "version": "0.11.3",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-linux-arm64-musl/-/edr-linux-arm64-musl-0.11.3.tgz",
+      "integrity": "sha512-B3sLJx1rL2E9pfdD4mApiwOZSrX0a/KQSBWdlq1uAhFKqkl00yZaY4LejgZndsJAa4iKGQJlGnw4HCGeVt0+jA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-linux-x64-gnu": {
+      "version": "0.11.3",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-linux-x64-gnu/-/edr-linux-x64-gnu-0.11.3.tgz",
+      "integrity": "sha512-D/4cFKDXH6UYyKPu6J3Y8TzW11UzeQI0+wS9QcJzjlrrfKj0ENW7g9VihD1O2FvXkdkTjcCZYb6ai8MMTCsaVw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-linux-x64-musl": {
+      "version": "0.11.3",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-linux-x64-musl/-/edr-linux-x64-musl-0.11.3.tgz",
+      "integrity": "sha512-ergXuIb4nIvmf+TqyiDX5tsE49311DrBky6+jNLgsGDTBaN1GS3OFwFS8I6Ri/GGn6xOaT8sKu3q7/m+WdlFzg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-win32-x64-msvc": {
+      "version": "0.11.3",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-win32-x64-msvc/-/edr-win32-x64-msvc-0.11.3.tgz",
+      "integrity": "sha512-snvEf+WB3OV0wj2A7kQ+ZQqBquMcrozSLXcdnMdEl7Tmn+KDCbmFKBt3Tk0X3qOU4RKQpLPnTxdM07TJNVtung==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-chai-matchers": {
+      "version": "2.0.8",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-chai-matchers/-/hardhat-chai-matchers-2.0.8.tgz",
+      "integrity": "sha512-Z5PiCXH4xhNLASROlSUOADfhfpfhYO6D7Hn9xp8PddmHey0jq704cr6kfU8TRrQ4PUZbpfsZadPj+pCfZdjPIg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/chai-as-promised": "^7.1.3",
+        "chai-as-promised": "^7.1.1",
+        "deep-eql": "^4.0.1",
+        "ordinal": "^1.0.3"
+      },
+      "peerDependencies": {
+        "@nomicfoundation/hardhat-ethers": "^3.0.0",
+        "chai": "^4.2.0",
+        "ethers": "^6.1.0",
+        "hardhat": "^2.9.4"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-ethers": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-ethers/-/hardhat-ethers-3.0.8.tgz",
+      "integrity": "sha512-zhOZ4hdRORls31DTOqg+GmEZM0ujly8GGIuRY7t7szEk2zW/arY1qDug/py8AEktT00v5K+b6RvbVog+va51IA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "debug": "^4.1.1",
+        "lodash.isequal": "^4.5.0"
+      },
+      "peerDependencies": {
+        "ethers": "^6.1.0",
+        "hardhat": "^2.0.0"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-ignition": {
+      "version": "0.15.10",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-ignition/-/hardhat-ignition-0.15.10.tgz",
+      "integrity": "sha512-UScXyLLG5rEm+ANchQYCDOsskdXl6ux3oCPgC24PKE/QMJEib5crGZIo8spAyzdK6vOnRW6i4FG+1qvoO0AGWA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@nomicfoundation/ignition-core": "^0.15.10",
+        "@nomicfoundation/ignition-ui": "^0.15.10",
+        "chalk": "^4.0.0",
+        "debug": "^4.3.2",
+        "fs-extra": "^10.0.0",
+        "json5": "^2.2.3",
+        "prompts": "^2.4.2"
+      },
+      "peerDependencies": {
+        "@nomicfoundation/hardhat-verify": "^2.0.1",
+        "hardhat": "^2.18.0"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-ignition-ethers": {
+      "version": "0.15.10",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-ignition-ethers/-/hardhat-ignition-ethers-0.15.10.tgz",
+      "integrity": "sha512-P90glRiBbR4mnMKP/LePovfUJjYT2YWJjx7118i7yxssUwcaW9wFohb4bFh+236N1tqM4q7aGx9cBvHNgve3zA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "peerDependencies": {
+        "@nomicfoundation/hardhat-ethers": "^3.0.4",
+        "@nomicfoundation/hardhat-ignition": "^0.15.10",
+        "@nomicfoundation/ignition-core": "^0.15.10",
+        "ethers": "^6.7.0",
+        "hardhat": "^2.18.0"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-network-helpers": {
+      "version": "1.0.12",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-network-helpers/-/hardhat-network-helpers-1.0.12.tgz",
+      "integrity": "sha512-xTNQNI/9xkHvjmCJnJOTyqDSl8uq1rKb2WOVmixQxFtRd7Oa3ecO8zM0cyC2YmOK+jHB9WPZ+F/ijkHg1CoORA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ethereumjs-util": "^7.1.4"
+      },
+      "peerDependencies": {
+        "hardhat": "^2.9.5"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-toolbox": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-toolbox/-/hardhat-toolbox-6.0.0.tgz",
+      "integrity": "sha512-3qm3VuDp5xD8UyfhYPPfZHnCc0M/V5yfRSTSDdOuI8DTrmYJkMNW7QrTNGalMCigWn3suBghSw9YcMOyGDJ7Lg==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "@nomicfoundation/hardhat-chai-matchers": "^2.0.0",
+        "@nomicfoundation/hardhat-ethers": "^3.0.0",
+        "@nomicfoundation/hardhat-ignition-ethers": "^0.15.0",
+        "@nomicfoundation/hardhat-network-helpers": "^1.0.0",
+        "@nomicfoundation/hardhat-verify": "^2.0.0",
+        "@typechain/ethers-v6": "^0.5.0",
+        "@typechain/hardhat": "^9.0.0",
+        "@types/chai": "^4.2.0",
+        "@types/mocha": ">=9.1.0",
+        "@types/node": ">=18.0.0",
+        "chai": "^4.2.0",
+        "ethers": "^6.14.0",
+        "hardhat": "^2.11.0",
+        "hardhat-gas-reporter": "^2.3.0",
+        "solidity-coverage": "^0.8.1",
+        "ts-node": ">=8.0.0",
+        "typechain": "^8.3.0",
+        "typescript": ">=4.5.0"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-verify": {
+      "version": "2.0.14",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-verify/-/hardhat-verify-2.0.14.tgz",
+      "integrity": "sha512-z3iVF1WYZHzcdMMUuureFpSAfcnlfJbJx3faOnGrOYg6PRTki1Ut9JAuRccnFzMHf1AmTEoSUpWcyvBCoxL5Rg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/abi": "^5.1.2",
+        "@ethersproject/address": "^5.0.2",
+        "cbor": "^8.1.0",
+        "debug": "^4.1.1",
+        "lodash.clonedeep": "^4.5.0",
+        "picocolors": "^1.1.0",
+        "semver": "^6.3.0",
+        "table": "^6.8.0",
+        "undici": "^5.14.0"
+      },
+      "peerDependencies": {
+        "hardhat": "^2.24.1"
+      }
+    },
+    "node_modules/@nomicfoundation/ignition-core": {
+      "version": "0.15.10",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/ignition-core/-/ignition-core-0.15.10.tgz",
+      "integrity": "sha512-AWvCviNlBkPT8EKcg34N+yUdQTYFiC/HdpfFZdw8oMFuAs9SMZE0zQA9gJQSCay41GbuyXt2Kietp5/1/nlBIA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/address": "5.6.1",
+        "@nomicfoundation/solidity-analyzer": "^0.1.1",
+        "cbor": "^9.0.0",
+        "debug": "^4.3.2",
+        "ethers": "^6.7.0",
+        "fs-extra": "^10.0.0",
+        "immer": "10.0.2",
+        "lodash": "4.17.21",
+        "ndjson": "2.0.0"
+      }
+    },
+    "node_modules/@nomicfoundation/ignition-core/node_modules/@ethersproject/address": {
+      "version": "5.6.1",
+      "resolved": "https://registry.npmjs.org/@ethersproject/address/-/address-5.6.1.tgz",
+      "integrity": "sha512-uOgF0kS5MJv9ZvCz7x6T2EXJSzotiybApn4XlOgoTX0xdtyVIJ7pF+6cGPxiEq/dpBiTfMiw7Yc81JcwhSYA0Q==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/bignumber": "^5.6.2",
+        "@ethersproject/bytes": "^5.6.1",
+        "@ethersproject/keccak256": "^5.6.1",
+        "@ethersproject/logger": "^5.6.0",
+        "@ethersproject/rlp": "^5.6.1"
+      }
+    },
+    "node_modules/@nomicfoundation/ignition-core/node_modules/cbor": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/cbor/-/cbor-9.0.2.tgz",
+      "integrity": "sha512-JPypkxsB10s9QOWwa6zwPzqE1Md3vqpPc+cai4sAecuCsRyAtAl/pMyhPlMbT/xtPnm2dznJZYRLui57qiRhaQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "nofilter": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/@nomicfoundation/ignition-ui": {
+      "version": "0.15.10",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/ignition-ui/-/ignition-ui-0.15.10.tgz",
+      "integrity": "sha512-82XQPF+1fvxTimDUPgDVwpTjHjfjFgFs84rERbBiMLQbz6sPtgTlV8HHrlbMx8tT/JKCI/SCU4gxV8xA4CPfcg==",
+      "dev": true,
+      "peer": true
+    },
+    "node_modules/@nomicfoundation/slang": {
+      "version": "0.18.3",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/slang/-/slang-0.18.3.tgz",
+      "integrity": "sha512-YqAWgckqbHM0/CZxi9Nlf4hjk9wUNLC9ngWCWBiqMxPIZmzsVKYuChdlrfeBPQyvQQBoOhbx+7C1005kLVQDZQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@bytecodealliance/preview2-shim": "0.17.0"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer/-/solidity-analyzer-0.1.2.tgz",
+      "integrity": "sha512-q4n32/FNKIhQ3zQGGw5CvPF6GTvDCpYwIf7bEY/dZTZbgfDsHyjJwURxUJf3VQuuJj+fDIFl4+KkBVbw4Ef6jA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      },
+      "optionalDependencies": {
+        "@nomicfoundation/solidity-analyzer-darwin-arm64": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-darwin-x64": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-linux-arm64-gnu": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-linux-arm64-musl": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-linux-x64-gnu": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-linux-x64-musl": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-win32-x64-msvc": "0.1.2"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-darwin-arm64": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-darwin-arm64/-/solidity-analyzer-darwin-arm64-0.1.2.tgz",
+      "integrity": "sha512-JaqcWPDZENCvm++lFFGjrDd8mxtf+CtLd2MiXvMNTBD33dContTZ9TWETwNFwg7JTJT5Q9HEecH7FA+HTSsIUw==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-darwin-x64": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-darwin-x64/-/solidity-analyzer-darwin-x64-0.1.2.tgz",
+      "integrity": "sha512-fZNmVztrSXC03e9RONBT+CiksSeYcxI1wlzqyr0L7hsQlK1fzV+f04g2JtQ1c/Fe74ZwdV6aQBdd6Uwl1052sw==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-linux-arm64-gnu": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-linux-arm64-gnu/-/solidity-analyzer-linux-arm64-gnu-0.1.2.tgz",
+      "integrity": "sha512-3d54oc+9ZVBuB6nbp8wHylk4xh0N0Gc+bk+/uJae+rUgbOBwQSfuGIbAZt1wBXs5REkSmynEGcqx6DutoK0tPA==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-linux-arm64-musl": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-linux-arm64-musl/-/solidity-analyzer-linux-arm64-musl-0.1.2.tgz",
+      "integrity": "sha512-iDJfR2qf55vgsg7BtJa7iPiFAsYf2d0Tv/0B+vhtnI16+wfQeTbP7teookbGvAo0eJo7aLLm0xfS/GTkvHIucA==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-linux-x64-gnu": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-linux-x64-gnu/-/solidity-analyzer-linux-x64-gnu-0.1.2.tgz",
+      "integrity": "sha512-9dlHMAt5/2cpWyuJ9fQNOUXFB/vgSFORg1jpjX1Mh9hJ/MfZXlDdHQ+DpFCs32Zk5pxRBb07yGvSHk9/fezL+g==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-linux-x64-musl": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-linux-x64-musl/-/solidity-analyzer-linux-x64-musl-0.1.2.tgz",
+      "integrity": "sha512-GzzVeeJob3lfrSlDKQw2bRJ8rBf6mEYaWY+gW0JnTDHINA0s2gPR4km5RLIj1xeZZOYz4zRw+AEeYgLRqB2NXg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-win32-x64-msvc": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-win32-x64-msvc/-/solidity-analyzer-win32-x64-msvc-0.1.2.tgz",
+      "integrity": "sha512-Fdjli4DCcFHb4Zgsz0uEJXZ2K7VEO+w5KVv7HmT7WO10iODdU9csC2az4jrhEsRtiR9Gfd74FlG0NYlw1BMdyA==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@openzeppelin/contracts": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/@openzeppelin/contracts/-/contracts-5.3.0.tgz",
+      "integrity": "sha512-zj/KGoW7zxWUE8qOI++rUM18v+VeLTTzKs/DJFkSzHpQFPD/jKKF0TrMxBfGLl3kpdELCNccvB3zmofSzm4nlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@openzeppelin/contracts-upgradeable": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/@openzeppelin/contracts-upgradeable/-/contracts-upgradeable-5.3.0.tgz",
+      "integrity": "sha512-yVzSSyTMWO6rapGI5tuqkcLpcGGXA0UA1vScyV5EhE5yw8By3Ewex9rDUw8lfVw0iTkvR/egjfcW5vpk03lqZg==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "@openzeppelin/contracts": "5.3.0"
+      }
+    },
+    "node_modules/@openzeppelin/defender-sdk-base-client": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/@openzeppelin/defender-sdk-base-client/-/defender-sdk-base-client-2.3.0.tgz",
+      "integrity": "sha512-j/JyhYFONQiJmW7fvDqxjwhCjBsXvKxI5rUV9LF/47Ex0EnxQuypauptGi1ffegORh/U/Ya/5pqAZayMYeyu6w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@aws-sdk/client-lambda": "^3.563.0",
+        "amazon-cognito-identity-js": "^6.3.6",
+        "async-retry": "^1.3.3"
+      }
+    },
+    "node_modules/@openzeppelin/defender-sdk-deploy-client": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/@openzeppelin/defender-sdk-deploy-client/-/defender-sdk-deploy-client-2.3.0.tgz",
+      "integrity": "sha512-A73HnkhNDamWaX7p4VrQZ1loBrchcRvoj1tU7CA8wSPCUn8JRJQKXIpELooEi1cUPga5A6tSBYz9UlCSsqSxKQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@openzeppelin/defender-sdk-base-client": "^2.3.0",
+        "axios": "^1.7.4",
+        "lodash": "^4.17.21"
+      }
+    },
+    "node_modules/@openzeppelin/defender-sdk-network-client": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/@openzeppelin/defender-sdk-network-client/-/defender-sdk-network-client-2.3.0.tgz",
+      "integrity": "sha512-VGBAd+XSYZ4HqYkQnWFDiolHWWmtE94bfP0ViQRRsKlTLgJQ/9VGVKDSafWIdFqSkIUMcJZNeUsvuNqHrzhctA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@openzeppelin/defender-sdk-base-client": "^2.3.0",
+        "axios": "^1.7.4",
+        "lodash": "^4.17.21"
+      }
+    },
+    "node_modules/@openzeppelin/hardhat-upgrades": {
+      "version": "3.9.1",
+      "resolved": "https://registry.npmjs.org/@openzeppelin/hardhat-upgrades/-/hardhat-upgrades-3.9.1.tgz",
+      "integrity": "sha512-pSDjlOnIpP+PqaJVe144dK6VVKZw2v6YQusyt0OOLiCsl+WUzfo4D0kylax7zjrOxqy41EK2ipQeIF4T+cCn2A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@openzeppelin/defender-sdk-base-client": "^2.1.0",
+        "@openzeppelin/defender-sdk-deploy-client": "^2.1.0",
+        "@openzeppelin/defender-sdk-network-client": "^2.1.0",
+        "@openzeppelin/upgrades-core": "^1.41.0",
+        "chalk": "^4.1.0",
+        "debug": "^4.1.1",
+        "ethereumjs-util": "^7.1.5",
+        "proper-lockfile": "^4.1.1",
+        "undici": "^6.11.1"
+      },
+      "bin": {
+        "migrate-oz-cli-project": "dist/scripts/migrate-oz-cli-project.js"
+      },
+      "peerDependencies": {
+        "@nomicfoundation/hardhat-ethers": "^3.0.6",
+        "@nomicfoundation/hardhat-verify": "^2.0.14",
+        "ethers": "^6.6.0",
+        "hardhat": "^2.24.1"
+      },
+      "peerDependenciesMeta": {
+        "@nomicfoundation/hardhat-verify": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@openzeppelin/hardhat-upgrades/node_modules/undici": {
+      "version": "6.21.3",
+      "resolved": "https://registry.npmjs.org/undici/-/undici-6.21.3.tgz",
+      "integrity": "sha512-gBLkYIlEnSp8pFbT64yFgGE6UIB9tAkhukC23PmMDCe5Nd+cRqKxSjw5y54MK2AZMgZfJWMaNE4nYUHgi1XEOw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18.17"
+      }
+    },
+    "node_modules/@openzeppelin/upgrades-core": {
+      "version": "1.42.1",
+      "resolved": "https://registry.npmjs.org/@openzeppelin/upgrades-core/-/upgrades-core-1.42.1.tgz",
+      "integrity": "sha512-8qnz2XfQrco8R8u9NjV+KiSLrVn7DnWFd+3BuhTUjhVy0bzCSu2SMKCVpZLtXbxf4f2dpz8jYPQYRa6s23PhLA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@nomicfoundation/slang": "^0.18.3",
+        "cbor": "^10.0.0",
+        "chalk": "^4.1.0",
+        "compare-versions": "^6.0.0",
+        "debug": "^4.1.1",
+        "ethereumjs-util": "^7.0.3",
+        "minimatch": "^9.0.5",
+        "minimist": "^1.2.7",
+        "proper-lockfile": "^4.1.1",
+        "solidity-ast": "^0.4.51"
+      },
+      "bin": {
+        "openzeppelin-upgrades-core": "dist/cli/cli.js"
+      }
+    },
+    "node_modules/@openzeppelin/upgrades-core/node_modules/cbor": {
+      "version": "10.0.3",
+      "resolved": "https://registry.npmjs.org/cbor/-/cbor-10.0.3.tgz",
+      "integrity": "sha512-72Jnj81xMsqepqdcSdf2+fflz/UDsThOHy5hj2MW5F5xzHL8Oa0KQ6I6V9CwVUPxg5pf+W9xp6W2KilaRXWWtw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "nofilter": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@pkgjs/parseargs": {
+      "version": "0.11.0",
+      "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz",
+      "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "peer": true,
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@scure/base": {
+      "version": "1.1.9",
+      "resolved": "https://registry.npmjs.org/@scure/base/-/base-1.1.9.tgz",
+      "integrity": "sha512-8YKhl8GHiNI/pU2VMaofa2Tor7PJRAjwQLBBuilkJ9L5+13yVbC7JO/wS7piioAvPSwR3JKM1IJ/u4xQzbcXKg==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip32": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip32/-/bip32-1.4.0.tgz",
+      "integrity": "sha512-sVUpc0Vq3tXCkDGYVWGIZTRfnvu8LoTDaev7vbwh0omSvVORONr960MQWdKqJDCReIEmTj3PAr73O3aoxz7OPg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "~1.4.0",
+        "@noble/hashes": "~1.4.0",
+        "@scure/base": "~1.1.6"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip32/node_modules/@noble/curves": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.4.2.tgz",
+      "integrity": "sha512-TavHr8qycMChk8UwMld0ZDRvatedkzWfH8IiaeGCfymOP5i0hSCozz9vHOL0nkwk7HRMlFnAiKpS2jrUmSybcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.4.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip32/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip39": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip39/-/bip39-1.3.0.tgz",
+      "integrity": "sha512-disdg7gHuTDZtY+ZdkmLpPCk7fxZSu3gBiEGuoC1XYxv9cGx3Z6cpTggCgW6odSOOIXCiDjuGejW+aJKCY/pIQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "~1.4.0",
+        "@scure/base": "~1.1.6"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip39/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@sentry/core": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/core/-/core-5.30.0.tgz",
+      "integrity": "sha512-TmfrII8w1PQZSZgPpUESqjB+jC6MvZJZdLtE/0hZ+SrnKhW3x5WlYLvTXZpcWePYBku7rl2wn1RZu6uT0qCTeg==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@sentry/hub": "5.30.0",
+        "@sentry/minimal": "5.30.0",
+        "@sentry/types": "5.30.0",
+        "@sentry/utils": "5.30.0",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/core/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@sentry/hub": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/hub/-/hub-5.30.0.tgz",
+      "integrity": "sha512-2tYrGnzb1gKz2EkMDQcfLrDTvmGcQPuWxLnJKXJvYTQDGLlEvi2tWz1VIHjunmOvJrB5aIQLhm+dcMRwFZDCqQ==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@sentry/types": "5.30.0",
+        "@sentry/utils": "5.30.0",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/hub/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@sentry/minimal": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/minimal/-/minimal-5.30.0.tgz",
+      "integrity": "sha512-BwWb/owZKtkDX+Sc4zCSTNcvZUq7YcH3uAVlmh/gtR9rmUvbzAA3ewLuB3myi4wWRAMEtny6+J/FN/x+2wn9Xw==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@sentry/hub": "5.30.0",
+        "@sentry/types": "5.30.0",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/minimal/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@sentry/node": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/node/-/node-5.30.0.tgz",
+      "integrity": "sha512-Br5oyVBF0fZo6ZS9bxbJZG4ApAjRqAnqFFurMVJJdunNb80brh7a5Qva2kjhm+U6r9NJAB5OmDyPkA1Qnt+QVg==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@sentry/core": "5.30.0",
+        "@sentry/hub": "5.30.0",
+        "@sentry/tracing": "5.30.0",
+        "@sentry/types": "5.30.0",
+        "@sentry/utils": "5.30.0",
+        "cookie": "^0.4.1",
+        "https-proxy-agent": "^5.0.0",
+        "lru_map": "^0.3.3",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/node/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@sentry/tracing": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/tracing/-/tracing-5.30.0.tgz",
+      "integrity": "sha512-dUFowCr0AIMwiLD7Fs314Mdzcug+gBVo/+NCMyDw8tFxJkwWAKl7Qa2OZxLQ0ZHjakcj1hNKfCQJ9rhyfOl4Aw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@sentry/hub": "5.30.0",
+        "@sentry/minimal": "5.30.0",
+        "@sentry/types": "5.30.0",
+        "@sentry/utils": "5.30.0",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/tracing/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@sentry/types": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/types/-/types-5.30.0.tgz",
+      "integrity": "sha512-R8xOqlSTZ+htqrfteCWU5Nk0CDN5ApUTvrlvBuiH1DyP6czDZ4ktbZB0hAgBlVcK0U+qpD3ag3Tqqpa5Q67rPw==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/utils": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/utils/-/utils-5.30.0.tgz",
+      "integrity": "sha512-zaYmoH0NWWtvnJjC9/CBseXMtKHm/tm40sz3YfJRxeQjyzRqNQPgivpd9R/oDJCYj999mzdW382p/qi2ypjLww==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@sentry/types": "5.30.0",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/utils/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@smithy/abort-controller": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/abort-controller/-/abort-controller-4.0.1.tgz",
+      "integrity": "sha512-fiUIYgIgRjMWznk6iLJz35K2YxSLHzLBA/RC6lBrKfQ8fHbPfvk7Pk9UvpKoHgJjI18MnbPuEju53zcVy6KF1g==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/config-resolver": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/config-resolver/-/config-resolver-4.0.1.tgz",
+      "integrity": "sha512-Igfg8lKu3dRVkTSEm98QpZUvKEOa71jDX4vKRcvJVyRc3UgN3j7vFMf0s7xLQhYmKa8kyJGQgUJDOV5V3neVlQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-config-provider": "^4.0.0",
+        "@smithy/util-middleware": "^4.0.1",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/core": {
+      "version": "3.1.5",
+      "resolved": "https://registry.npmjs.org/@smithy/core/-/core-3.1.5.tgz",
+      "integrity": "sha512-HLclGWPkCsekQgsyzxLhCQLa8THWXtB5PxyYN+2O6nkyLt550KQKTlbV2D1/j5dNIQapAZM1+qFnpBFxZQkgCA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/middleware-serde": "^4.0.2",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-body-length-browser": "^4.0.0",
+        "@smithy/util-middleware": "^4.0.1",
+        "@smithy/util-stream": "^4.1.2",
+        "@smithy/util-utf8": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/credential-provider-imds": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/credential-provider-imds/-/credential-provider-imds-4.0.1.tgz",
+      "integrity": "sha512-l/qdInaDq1Zpznpmev/+52QomsJNZ3JkTl5yrTl02V6NBgJOQ4LY0SFw/8zsMwj3tLe8vqiIuwF6nxaEwgf6mg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "@smithy/url-parser": "^4.0.1",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/eventstream-codec": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/eventstream-codec/-/eventstream-codec-4.0.1.tgz",
+      "integrity": "sha512-Q2bCAAR6zXNVtJgifsU16ZjKGqdw/DyecKNgIgi7dlqw04fqDu0mnq+JmGphqheypVc64CYq3azSuCpAdFk2+A==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-crypto/crc32": "5.2.0",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-hex-encoding": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/eventstream-serde-browser": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/eventstream-serde-browser/-/eventstream-serde-browser-4.0.1.tgz",
+      "integrity": "sha512-HbIybmz5rhNg+zxKiyVAnvdM3vkzjE6ccrJ620iPL8IXcJEntd3hnBl+ktMwIy12Te/kyrSbUb8UCdnUT4QEdA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/eventstream-serde-universal": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/eventstream-serde-config-resolver": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/eventstream-serde-config-resolver/-/eventstream-serde-config-resolver-4.0.1.tgz",
+      "integrity": "sha512-lSipaiq3rmHguHa3QFF4YcCM3VJOrY9oq2sow3qlhFY+nBSTF/nrO82MUQRPrxHQXA58J5G1UnU2WuJfi465BA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/eventstream-serde-node": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/eventstream-serde-node/-/eventstream-serde-node-4.0.1.tgz",
+      "integrity": "sha512-o4CoOI6oYGYJ4zXo34U8X9szDe3oGjmHgsMGiZM0j4vtNoT+h80TLnkUcrLZR3+E6HIxqW+G+9WHAVfl0GXK0Q==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/eventstream-serde-universal": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/eventstream-serde-universal": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/eventstream-serde-universal/-/eventstream-serde-universal-4.0.1.tgz",
+      "integrity": "sha512-Z94uZp0tGJuxds3iEAZBqGU2QiaBHP4YytLUjwZWx+oUeohCsLyUm33yp4MMBmhkuPqSbQCXq5hDet6JGUgHWA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/eventstream-codec": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/fetch-http-handler": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/fetch-http-handler/-/fetch-http-handler-5.0.1.tgz",
+      "integrity": "sha512-3aS+fP28urrMW2KTjb6z9iFow6jO8n3MFfineGbndvzGZit3taZhKWtTorf+Gp5RpFDDafeHlhfsGlDCXvUnJA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/querystring-builder": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-base64": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/hash-node": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/hash-node/-/hash-node-4.0.1.tgz",
+      "integrity": "sha512-TJ6oZS+3r2Xu4emVse1YPB3Dq3d8RkZDKcPr71Nj/lJsdAP1c7oFzYqEn1IBc915TsgLl2xIJNuxCz+gLbLE0w==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-buffer-from": "^4.0.0",
+        "@smithy/util-utf8": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/invalid-dependency": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/invalid-dependency/-/invalid-dependency-4.0.1.tgz",
+      "integrity": "sha512-gdudFPf4QRQ5pzj7HEnu6FhKRi61BfH/Gk5Yf6O0KiSbr1LlVhgjThcvjdu658VE6Nve8vaIWB8/fodmS1rBPQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/is-array-buffer": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@smithy/is-array-buffer/-/is-array-buffer-4.0.0.tgz",
+      "integrity": "sha512-saYhF8ZZNoJDTvJBEWgeBccCg+yvp1CX+ed12yORU3NilJScfc6gfch2oVb4QgxZrGUx3/ZJlb+c/dJbyupxlw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/middleware-content-length": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/middleware-content-length/-/middleware-content-length-4.0.1.tgz",
+      "integrity": "sha512-OGXo7w5EkB5pPiac7KNzVtfCW2vKBTZNuCctn++TTSOMpe6RZO/n6WEC1AxJINn3+vWLKW49uad3lo/u0WJ9oQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/middleware-endpoint": {
+      "version": "4.0.6",
+      "resolved": "https://registry.npmjs.org/@smithy/middleware-endpoint/-/middleware-endpoint-4.0.6.tgz",
+      "integrity": "sha512-ftpmkTHIFqgaFugcjzLZv3kzPEFsBFSnq1JsIkr2mwFzCraZVhQk2gqN51OOeRxqhbPTkRFj39Qd2V91E/mQxg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/core": "^3.1.5",
+        "@smithy/middleware-serde": "^4.0.2",
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/shared-ini-file-loader": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "@smithy/url-parser": "^4.0.1",
+        "@smithy/util-middleware": "^4.0.1",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/middleware-retry": {
+      "version": "4.0.7",
+      "resolved": "https://registry.npmjs.org/@smithy/middleware-retry/-/middleware-retry-4.0.7.tgz",
+      "integrity": "sha512-58j9XbUPLkqAcV1kHzVX/kAR16GT+j7DUZJqwzsxh1jtz7G82caZiGyyFgUvogVfNTg3TeAOIJepGc8TXF4AVQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/service-error-classification": "^4.0.1",
+        "@smithy/smithy-client": "^4.1.6",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-middleware": "^4.0.1",
+        "@smithy/util-retry": "^4.0.1",
+        "tslib": "^2.6.2",
+        "uuid": "^9.0.1"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/middleware-serde": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/@smithy/middleware-serde/-/middleware-serde-4.0.2.tgz",
+      "integrity": "sha512-Sdr5lOagCn5tt+zKsaW+U2/iwr6bI9p08wOkCp6/eL6iMbgdtc2R5Ety66rf87PeohR0ExI84Txz9GYv5ou3iQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/middleware-stack": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/middleware-stack/-/middleware-stack-4.0.1.tgz",
+      "integrity": "sha512-dHwDmrtR/ln8UTHpaIavRSzeIk5+YZTBtLnKwDW3G2t6nAupCiQUvNzNoHBpik63fwUaJPtlnMzXbQrNFWssIA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/node-config-provider": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/node-config-provider/-/node-config-provider-4.0.1.tgz",
+      "integrity": "sha512-8mRTjvCtVET8+rxvmzRNRR0hH2JjV0DFOmwXPrISmTIJEfnCBugpYYGAsCj8t41qd+RB5gbheSQ/6aKZCQvFLQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/shared-ini-file-loader": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/node-http-handler": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/@smithy/node-http-handler/-/node-http-handler-4.0.3.tgz",
+      "integrity": "sha512-dYCLeINNbYdvmMLtW0VdhW1biXt+PPCGazzT5ZjKw46mOtdgToQEwjqZSS9/EN8+tNs/RO0cEWG044+YZs97aA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/abort-controller": "^4.0.1",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/querystring-builder": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/property-provider": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/property-provider/-/property-provider-4.0.1.tgz",
+      "integrity": "sha512-o+VRiwC2cgmk/WFV0jaETGOtX16VNPp2bSQEzu0whbReqE1BMqsP2ami2Vi3cbGVdKu1kq9gQkDAGKbt0WOHAQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/protocol-http": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/protocol-http/-/protocol-http-5.0.1.tgz",
+      "integrity": "sha512-TE4cpj49jJNB/oHyh/cRVEgNZaoPaxd4vteJNB0yGidOCVR0jCw/hjPVsT8Q8FRmj8Bd3bFZt8Dh7xGCT+xMBQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/querystring-builder": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/querystring-builder/-/querystring-builder-4.0.1.tgz",
+      "integrity": "sha512-wU87iWZoCbcqrwszsOewEIuq+SU2mSoBE2CcsLwE0I19m0B2gOJr1MVjxWcDQYOzHbR1xCk7AcOBbGFUYOKvdg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-uri-escape": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/querystring-parser": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/querystring-parser/-/querystring-parser-4.0.1.tgz",
+      "integrity": "sha512-Ma2XC7VS9aV77+clSFylVUnPZRindhB7BbmYiNOdr+CHt/kZNJoPP0cd3QxCnCFyPXC4eybmyE98phEHkqZ5Jw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/service-error-classification": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/service-error-classification/-/service-error-classification-4.0.1.tgz",
+      "integrity": "sha512-3JNjBfOWpj/mYfjXJHB4Txc/7E4LVq32bwzE7m28GN79+M1f76XHflUaSUkhOriprPDzev9cX/M+dEB80DNDKA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/shared-ini-file-loader": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/shared-ini-file-loader/-/shared-ini-file-loader-4.0.1.tgz",
+      "integrity": "sha512-hC8F6qTBbuHRI/uqDgqqi6J0R4GtEZcgrZPhFQnMhfJs3MnUTGSnR1NSJCJs5VWlMydu0kJz15M640fJlRsIOw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/signature-v4": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/signature-v4/-/signature-v4-5.0.1.tgz",
+      "integrity": "sha512-nCe6fQ+ppm1bQuw5iKoeJ0MJfz2os7Ic3GBjOkLOPtavbD1ONoyE3ygjBfz2ythFWm4YnRm6OxW+8p/m9uCoIA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/is-array-buffer": "^4.0.0",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-hex-encoding": "^4.0.0",
+        "@smithy/util-middleware": "^4.0.1",
+        "@smithy/util-uri-escape": "^4.0.0",
+        "@smithy/util-utf8": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/smithy-client": {
+      "version": "4.1.6",
+      "resolved": "https://registry.npmjs.org/@smithy/smithy-client/-/smithy-client-4.1.6.tgz",
+      "integrity": "sha512-UYDolNg6h2O0L+cJjtgSyKKvEKCOa/8FHYJnBobyeoeWDmNpXjwOAtw16ezyeu1ETuuLEOZbrynK0ZY1Lx9Jbw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/core": "^3.1.5",
+        "@smithy/middleware-endpoint": "^4.0.6",
+        "@smithy/middleware-stack": "^4.0.1",
+        "@smithy/protocol-http": "^5.0.1",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-stream": "^4.1.2",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/types": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@smithy/types/-/types-4.1.0.tgz",
+      "integrity": "sha512-enhjdwp4D7CXmwLtD6zbcDMbo6/T6WtuuKCY49Xxc6OMOmUWlBEBDREsxxgV2LIdeQPW756+f97GzcgAwp3iLw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/url-parser": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/url-parser/-/url-parser-4.0.1.tgz",
+      "integrity": "sha512-gPXcIEUtw7VlK8f/QcruNXm7q+T5hhvGu9tl63LsJPZ27exB6dtNwvh2HIi0v7JcXJ5emBxB+CJxwaLEdJfA+g==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/querystring-parser": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-base64": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-base64/-/util-base64-4.0.0.tgz",
+      "integrity": "sha512-CvHfCmO2mchox9kjrtzoHkWHxjHZzaFojLc8quxXY7WAAMAg43nuxwv95tATVgQFNDwd4M9S1qFzj40Ul41Kmg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/util-buffer-from": "^4.0.0",
+        "@smithy/util-utf8": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-body-length-browser": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-body-length-browser/-/util-body-length-browser-4.0.0.tgz",
+      "integrity": "sha512-sNi3DL0/k64/LO3A256M+m3CDdG6V7WKWHdAiBBMUN8S3hK3aMPhwnPik2A/a2ONN+9doY9UxaLfgqsIRg69QA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-body-length-node": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-body-length-node/-/util-body-length-node-4.0.0.tgz",
+      "integrity": "sha512-q0iDP3VsZzqJyje8xJWEJCNIu3lktUGVoSy1KB0UWym2CL1siV3artm+u1DFYTLejpsrdGyCSWBdGNjJzfDPjg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-buffer-from": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-buffer-from/-/util-buffer-from-4.0.0.tgz",
+      "integrity": "sha512-9TOQ7781sZvddgO8nxueKi3+yGvkY35kotA0Y6BWRajAv8jjmigQ1sBwz0UX47pQMYXJPahSKEKYFgt+rXdcug==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/is-array-buffer": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-config-provider": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-config-provider/-/util-config-provider-4.0.0.tgz",
+      "integrity": "sha512-L1RBVzLyfE8OXH+1hsJ8p+acNUSirQnWQ6/EgpchV88G6zGBTDPdXiiExei6Z1wR2RxYvxY/XLw6AMNCCt8H3w==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-defaults-mode-browser": {
+      "version": "4.0.7",
+      "resolved": "https://registry.npmjs.org/@smithy/util-defaults-mode-browser/-/util-defaults-mode-browser-4.0.7.tgz",
+      "integrity": "sha512-CZgDDrYHLv0RUElOsmZtAnp1pIjwDVCSuZWOPhIOBvG36RDfX1Q9+6lS61xBf+qqvHoqRjHxgINeQz47cYFC2Q==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/smithy-client": "^4.1.6",
+        "@smithy/types": "^4.1.0",
+        "bowser": "^2.11.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-defaults-mode-node": {
+      "version": "4.0.7",
+      "resolved": "https://registry.npmjs.org/@smithy/util-defaults-mode-node/-/util-defaults-mode-node-4.0.7.tgz",
+      "integrity": "sha512-79fQW3hnfCdrfIi1soPbK3zmooRFnLpSx3Vxi6nUlqaaQeC5dm8plt4OTNDNqEEEDkvKghZSaoti684dQFVrGQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/config-resolver": "^4.0.1",
+        "@smithy/credential-provider-imds": "^4.0.1",
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/property-provider": "^4.0.1",
+        "@smithy/smithy-client": "^4.1.6",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-endpoints": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/util-endpoints/-/util-endpoints-3.0.1.tgz",
+      "integrity": "sha512-zVdUENQpdtn9jbpD9SCFK4+aSiavRb9BxEtw9ZGUR1TYo6bBHbIoi7VkrFQ0/RwZlzx0wRBaRmPclj8iAoJCLA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/node-config-provider": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-hex-encoding": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-hex-encoding/-/util-hex-encoding-4.0.0.tgz",
+      "integrity": "sha512-Yk5mLhHtfIgW2W2WQZWSg5kuMZCVbvhFmC7rV4IO2QqnZdbEFPmQnCcGMAX2z/8Qj3B9hYYNjZOhWym+RwhePw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-middleware": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/util-middleware/-/util-middleware-4.0.1.tgz",
+      "integrity": "sha512-HiLAvlcqhbzhuiOa0Lyct5IIlyIz0PQO5dnMlmQ/ubYM46dPInB+3yQGkfxsk6Q24Y0n3/JmcA1v5iEhmOF5mA==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-retry": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@smithy/util-retry/-/util-retry-4.0.1.tgz",
+      "integrity": "sha512-WmRHqNVwn3kI3rKk1LsKcVgPBG6iLTBGC1iYOV3GQegwJ3E8yjzHytPt26VNzOWr1qu0xE03nK0Ug8S7T7oufw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/service-error-classification": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-stream": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/@smithy/util-stream/-/util-stream-4.1.2.tgz",
+      "integrity": "sha512-44PKEqQ303d3rlQuiDpcCcu//hV8sn+u2JBo84dWCE0rvgeiVl0IlLMagbU++o0jCWhYCsHaAt9wZuZqNe05Hw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/fetch-http-handler": "^5.0.1",
+        "@smithy/node-http-handler": "^4.0.3",
+        "@smithy/types": "^4.1.0",
+        "@smithy/util-base64": "^4.0.0",
+        "@smithy/util-buffer-from": "^4.0.0",
+        "@smithy/util-hex-encoding": "^4.0.0",
+        "@smithy/util-utf8": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-uri-escape": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-uri-escape/-/util-uri-escape-4.0.0.tgz",
+      "integrity": "sha512-77yfbCbQMtgtTylO9itEAdpPXSog3ZxMe09AEhm0dU0NLTalV70ghDZFR+Nfi1C60jnJoh/Re4090/DuZh2Omg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-utf8": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/@smithy/util-utf8/-/util-utf8-4.0.0.tgz",
+      "integrity": "sha512-b+zebfKCfRdgNJDknHCob3O7FpeYQN6ZG6YLExMcasDHsCXlsXCEuiPZeLnJLpwa5dvPetGlnGCiMHuLwGvFow==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/util-buffer-from": "^4.0.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@smithy/util-waiter": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/@smithy/util-waiter/-/util-waiter-4.0.2.tgz",
+      "integrity": "sha512-piUTHyp2Axx3p/kc2CIJkYSv0BAaheBQmbACZgQSSfWUumWNW+R1lL+H9PDBxKJkvOeEX+hKYEFiwO8xagL8AQ==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@smithy/abort-controller": "^4.0.1",
+        "@smithy/types": "^4.1.0",
+        "tslib": "^2.6.2"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/@solidity-parser/parser": {
+      "version": "0.20.1",
+      "resolved": "https://registry.npmjs.org/@solidity-parser/parser/-/parser-0.20.1.tgz",
+      "integrity": "sha512-58I2sRpzaQUN+jJmWbHfbWf9AKfzqCI8JAdFB0vbyY+u8tBRcuTt9LxzasvR0LGQpcRv97eyV7l61FQ3Ib7zVw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@tsconfig/node10": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz",
+      "integrity": "sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@tsconfig/node12": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node12/-/node12-1.0.11.tgz",
+      "integrity": "sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@tsconfig/node14": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node14/-/node14-1.0.3.tgz",
+      "integrity": "sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@tsconfig/node16": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node16/-/node16-1.0.4.tgz",
+      "integrity": "sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@typechain/ethers-v6": {
+      "version": "0.5.1",
+      "resolved": "https://registry.npmjs.org/@typechain/ethers-v6/-/ethers-v6-0.5.1.tgz",
+      "integrity": "sha512-F+GklO8jBWlsaVV+9oHaPh5NJdd6rAKN4tklGfInX1Q7h0xPgVLP39Jl3eCulPB5qexI71ZFHwbljx4ZXNfouA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "lodash": "^4.17.15",
+        "ts-essentials": "^7.0.1"
+      },
+      "peerDependencies": {
+        "ethers": "6.x",
+        "typechain": "^8.3.2",
+        "typescript": ">=4.7.0"
+      }
+    },
+    "node_modules/@typechain/hardhat": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/@typechain/hardhat/-/hardhat-9.1.0.tgz",
+      "integrity": "sha512-mtaUlzLlkqTlfPwB3FORdejqBskSnh+Jl8AIJGjXNAQfRQ4ofHADPl1+oU7Z3pAJzmZbUXII8MhOLQltcHgKnA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "fs-extra": "^9.1.0"
+      },
+      "peerDependencies": {
+        "@typechain/ethers-v6": "^0.5.1",
+        "ethers": "^6.1.0",
+        "hardhat": "^2.9.9",
+        "typechain": "^8.3.2"
+      }
+    },
+    "node_modules/@typechain/hardhat/node_modules/fs-extra": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-9.1.0.tgz",
+      "integrity": "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "at-least-node": "^1.0.0",
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/@types/bn.js": {
+      "version": "5.1.6",
+      "resolved": "https://registry.npmjs.org/@types/bn.js/-/bn.js-5.1.6.tgz",
+      "integrity": "sha512-Xh8vSwUeMKeYYrj3cX4lGQgFSF/N03r+tv4AiLl1SucqV+uTQpxRcnM8AkXKHwYP9ZPXOYXRr2KPXpVlIvqh9w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/chai": {
+      "version": "4.3.20",
+      "resolved": "https://registry.npmjs.org/@types/chai/-/chai-4.3.20.tgz",
+      "integrity": "sha512-/pC9HAB5I/xMlc5FP77qjCnI16ChlJfW0tGa0IUcFn38VJrTV6DeZ60NU5KZBtaOZqjdpwTWohz5HU1RrhiYxQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@types/chai-as-promised": {
+      "version": "7.1.8",
+      "resolved": "https://registry.npmjs.org/@types/chai-as-promised/-/chai-as-promised-7.1.8.tgz",
+      "integrity": "sha512-ThlRVIJhr69FLlh6IctTXFkmhtP3NpMZ2QGq69StYLyKZFp/HOp1VdKZj7RvfNWYYcJ1xlbLGLLWj1UvP5u/Gw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/chai": "*"
+      }
+    },
+    "node_modules/@types/glob": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/@types/glob/-/glob-7.2.0.tgz",
+      "integrity": "sha512-ZUxbzKl0IfJILTS6t7ip5fQQM/J3TJYubDm3nMbgubNNYS62eXeUpoLUC8/7fJNiFYHTrGPQn7hspDUzIHX3UA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/minimatch": "*",
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/lru-cache": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/@types/lru-cache/-/lru-cache-5.1.1.tgz",
+      "integrity": "sha512-ssE3Vlrys7sdIzs5LOxCzTVMsU7i9oa/IaW92wF32JFb3CVczqOkru2xspuKczHEbG3nvmPY7IFqVmGGHdNbYw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/minimatch": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/@types/minimatch/-/minimatch-5.1.2.tgz",
+      "integrity": "sha512-K0VQKziLUWkVKiRVrx4a40iPaxTUefQmjtkQofBkYRcoaaL/8rhwDWww9qWbrgicNOgnpIsMxyNIUM4+n6dUIA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@types/mocha": {
+      "version": "10.0.10",
+      "resolved": "https://registry.npmjs.org/@types/mocha/-/mocha-10.0.10.tgz",
+      "integrity": "sha512-xPyYSz1cMPnJQhl0CLMH68j3gprKZaTjG3s5Vi+fDgx+uhG9NOXwbVt52eFS8ECyXhyKcjDLCBEqBExKuiZb7Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@types/node": {
+      "version": "22.13.5",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.13.5.tgz",
+      "integrity": "sha512-+lTU0PxZXn0Dr1NBtC7Y8cR21AJr87dLLU953CWA6pMxxv/UDc7jYAY90upcrie1nRcD6XNG5HOYEDtgW5TxAg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.20.0"
+      }
+    },
+    "node_modules/@types/pbkdf2": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@types/pbkdf2/-/pbkdf2-3.1.2.tgz",
+      "integrity": "sha512-uRwJqmiXmh9++aSu1VNEn3iIxWOhd8AHXNSdlaLfdAAdSTY9jYVeGWnzejM3dvrkbqE3/hyQkQQ29IFATEGlew==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/prettier": {
+      "version": "2.7.3",
+      "resolved": "https://registry.npmjs.org/@types/prettier/-/prettier-2.7.3.tgz",
+      "integrity": "sha512-+68kP9yzs4LMp7VNh8gdzMSPZFL44MLGqiHWvttYJe+6qnuVr4Ek9wSBQoveqY/r+LwjCcU29kNVkidwim+kYA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@types/secp256k1": {
+      "version": "4.0.6",
+      "resolved": "https://registry.npmjs.org/@types/secp256k1/-/secp256k1-4.0.6.tgz",
+      "integrity": "sha512-hHxJU6PAEUn0TP4S/ZOzuTUvJWuZ6eIKeNKb5RBpODvSl6hp1Wrw4s7ATY50rklRCScUDpHzVA/DQdSjJ3UoYQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/abbrev": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.0.9.tgz",
+      "integrity": "sha512-LEyx4aLEC3x6T0UguF6YILf+ntvmOaWsVfENmIW0E9H09vKlLDGelMjjSm0jkDHALj8A8quZ/HapKNigzwge+Q==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/abitype": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/abitype/-/abitype-1.0.8.tgz",
+      "integrity": "sha512-ZeiI6h3GnW06uYDLx0etQtX/p8E24UaHHBj57RSjK7YBFe7iuVn07EDpOeP451D06sF27VOz9JJPlIKJmXgkEg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://github.com/sponsors/wevm"
+      },
+      "peerDependencies": {
+        "typescript": ">=5.0.4",
+        "zod": "^3 >=3.22.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        },
+        "zod": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/acorn": {
+      "version": "8.14.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.14.0.tgz",
+      "integrity": "sha512-cl669nCJTZBsL97OF4kUQm5g5hC2uihk0NxY3WENAC0TYdILVkAyHymAntgxGkl7K+t0cXIrH5siy5S4XkFycA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "bin": {
+        "acorn": "bin/acorn"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/acorn-walk": {
+      "version": "8.3.4",
+      "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz",
+      "integrity": "sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "acorn": "^8.11.0"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/adm-zip": {
+      "version": "0.4.16",
+      "resolved": "https://registry.npmjs.org/adm-zip/-/adm-zip-0.4.16.tgz",
+      "integrity": "sha512-TFi4HBKSGfIKsK5YCkKaaFG2m4PEDyViZmEwof3MTIgzimHLto6muaHVpbrljdIvIrFZzEq/p4nafOeLcYegrg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.3.0"
+      }
+    },
+    "node_modules/aes-js": {
+      "version": "4.0.0-beta.5",
+      "resolved": "https://registry.npmjs.org/aes-js/-/aes-js-4.0.0-beta.5.tgz",
+      "integrity": "sha512-G965FqalsNyrPqgEGON7nIx1e/OVENSgiEIzyC63haUMuvNnwIgIjMs52hlTCKhkBny7A2ORNlfY9Zu+jmGk1Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/agent-base": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz",
+      "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 6.0.0"
+      }
+    },
+    "node_modules/aggregate-error": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/aggregate-error/-/aggregate-error-3.1.0.tgz",
+      "integrity": "sha512-4I7Td01quW/RpocfNayFdFVk1qSuoh0E7JrbRJ16nH01HhKFQ88INq9Sd+nd72zqRySlr9BmDA8xlEJ6vJMrYA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "clean-stack": "^2.0.0",
+        "indent-string": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "8.17.1",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz",
+      "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/amazon-cognito-identity-js": {
+      "version": "6.3.12",
+      "resolved": "https://registry.npmjs.org/amazon-cognito-identity-js/-/amazon-cognito-identity-js-6.3.12.tgz",
+      "integrity": "sha512-s7NKDZgx336cp+oDeUtB2ZzT8jWJp/v2LWuYl+LQtMEODe22RF1IJ4nRiDATp+rp1pTffCZcm44Quw4jx2bqNg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-crypto/sha256-js": "1.2.2",
+        "buffer": "4.9.2",
+        "fast-base64-decode": "^1.0.0",
+        "isomorphic-unfetch": "^3.0.0",
+        "js-cookie": "^2.2.1"
+      }
+    },
+    "node_modules/amazon-cognito-identity-js/node_modules/@aws-crypto/sha256-js": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/@aws-crypto/sha256-js/-/sha256-js-1.2.2.tgz",
+      "integrity": "sha512-Nr1QJIbW/afYYGzYvrF70LtaHrIRtd4TNAglX8BvlfxJLZ45SAmueIKYl5tWoNBPzp65ymXGFK0Bb1vZUpuc9g==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-crypto/util": "^1.2.2",
+        "@aws-sdk/types": "^3.1.0",
+        "tslib": "^1.11.1"
+      }
+    },
+    "node_modules/amazon-cognito-identity-js/node_modules/@aws-crypto/util": {
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/@aws-crypto/util/-/util-1.2.2.tgz",
+      "integrity": "sha512-H8PjG5WJ4wz0UXAFXeJjWCW1vkvIJ3qUUD+rGRwJ2/hj+xT58Qle2MTql/2MGzkU+1JLAFuR6aJpLAjHwhmwwg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "dependencies": {
+        "@aws-sdk/types": "^3.1.0",
+        "@aws-sdk/util-utf8-browser": "^3.0.0",
+        "tslib": "^1.11.1"
+      }
+    },
+    "node_modules/amazon-cognito-identity-js/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/amdefine": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/amdefine/-/amdefine-1.0.1.tgz",
+      "integrity": "sha512-S2Hw0TtNkMJhIabBwIojKL9YHO5T0n5eNqWJ7Lrlel/zDbftQpxpapi8tZs3X1HWa+u+QeydGmzzNU0m09+Rcg==",
+      "dev": true,
+      "license": "BSD-3-Clause OR MIT",
+      "optional": true,
+      "peer": true,
+      "engines": {
+        "node": ">=0.4.2"
+      }
+    },
+    "node_modules/ansi-align": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-align/-/ansi-align-3.0.1.tgz",
+      "integrity": "sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^4.1.0"
+      }
+    },
+    "node_modules/ansi-colors": {
+      "version": "4.1.3",
+      "resolved": "https://registry.npmjs.org/ansi-colors/-/ansi-colors-4.1.3.tgz",
+      "integrity": "sha512-/6w/C21Pm1A7aZitlI5Ni/2J6FFQN8i1Cvz3kHABAAbw93v/NlvKdVOqz7CCWz/3iv/JplRSEEZ83XION15ovw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/ansi-escapes": {
+      "version": "4.3.2",
+      "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz",
+      "integrity": "sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "type-fest": "^0.21.3"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/anymatch": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz",
+      "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "normalize-path": "^3.0.0",
+        "picomatch": "^2.0.4"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/arg": {
+      "version": "4.1.3",
+      "resolved": "https://registry.npmjs.org/arg/-/arg-4.1.3.tgz",
+      "integrity": "sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/argparse": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
+      "dev": true,
+      "license": "Python-2.0"
+    },
+    "node_modules/array-back": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/array-back/-/array-back-3.1.0.tgz",
+      "integrity": "sha512-TkuxA4UCOvxuDK6NZYXCalszEzj+TLszyASooky+i742l9TqsOdYCMJJupxRic61hwquNtppB3hgcuq9SVSH1Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/array-union": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz",
+      "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/assertion-error": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-1.1.0.tgz",
+      "integrity": "sha512-jgsaNduz+ndvGyFt3uSuWqvy4lCnIJiovtouQN5JZHOKCS2QuhEdbcQHFhVksz2N2U9hXJo8odG7ETyWlEeuDw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/astral-regex": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/astral-regex/-/astral-regex-2.0.0.tgz",
+      "integrity": "sha512-Z7tMw1ytTXt5jqMcOP+OQteU1VuNK9Y02uuJtKQ1Sv69jXQKKg5cibLwGJow8yzZP+eAc18EmLGPal0bp36rvQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/async": {
+      "version": "1.5.2",
+      "resolved": "https://registry.npmjs.org/async/-/async-1.5.2.tgz",
+      "integrity": "sha512-nSVgobk4rv61R9PUSDtYt7mPVB2olxNR5RWJcAsH676/ef11bUZwvu7+RGYrYauVdDPcO519v68wRhXQtxsV9w==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/async-retry": {
+      "version": "1.3.3",
+      "resolved": "https://registry.npmjs.org/async-retry/-/async-retry-1.3.3.tgz",
+      "integrity": "sha512-wfr/jstw9xNi/0teMHrRW7dsz3Lt5ARhYNZ2ewpadnhaIp5mbALhOAP+EAdsC7t4Z6wqsDVv9+W6gm1Dk9mEyw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "retry": "0.13.1"
+      }
+    },
+    "node_modules/asynckit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+      "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/at-least-node": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/at-least-node/-/at-least-node-1.0.0.tgz",
+      "integrity": "sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/axios": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/axios/-/axios-1.8.1.tgz",
+      "integrity": "sha512-NN+fvwH/kV01dYUQ3PTOZns4LWtWhOFCAhQ/pHb88WQ1hNe5V/dvFwc4VJcDL11LT9xSX0QtsR8sWUuyOuOq7g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "follow-redirects": "^1.15.6",
+        "form-data": "^4.0.0",
+        "proxy-from-env": "^1.1.0"
+      }
+    },
+    "node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/base-x": {
+      "version": "3.0.10",
+      "resolved": "https://registry.npmjs.org/base-x/-/base-x-3.0.10.tgz",
+      "integrity": "sha512-7d0s06rR9rYaIWHkpfLIFICM/tkSVdoPC9qYAQRpxn9DdKNWNsKC0uk++akckyLq16Tx2WIinnZ6WRriAt6njQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "node_modules/base64-js": {
+      "version": "1.5.1",
+      "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz",
+      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/binary-extensions": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz",
+      "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/blakejs": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/blakejs/-/blakejs-1.2.1.tgz",
+      "integrity": "sha512-QXUSXI3QVc/gJME0dBpXrag1kbzOqCjCX8/b54ntNyW6sjtoqxqRk3LTmXzaJoh71zMsDCjM+47jS7XiwN/+fQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/bn.js": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-5.2.1.tgz",
+      "integrity": "sha512-eXRvHzWyYPBuB4NBy0cmYQjGitUrtqwbvlzP3G6VFnNRbsZQIxQ10PbKKHt8gZ/HW/D/747aDl+QkDqg3KQLMQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/bowser": {
+      "version": "2.11.0",
+      "resolved": "https://registry.npmjs.org/bowser/-/bowser-2.11.0.tgz",
+      "integrity": "sha512-AlcaJBi/pqqJBIQ8U9Mcpc9i8Aqxn88Skv5d+xBX006BY5u8N3mGLHa5Lgppa7L/HfwgwLgZ6NYs+Ag6uUmJRA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/boxen": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/boxen/-/boxen-5.1.2.tgz",
+      "integrity": "sha512-9gYgQKXx+1nP8mP7CzFyaUARhg7D3n1dF/FnErWmu9l6JvGpNUN278h0aSb+QjoiKSWG+iZ3uHrcqk0qrY9RQQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-align": "^3.0.0",
+        "camelcase": "^6.2.0",
+        "chalk": "^4.1.0",
+        "cli-boxes": "^2.2.1",
+        "string-width": "^4.2.2",
+        "type-fest": "^0.20.2",
+        "widest-line": "^3.1.0",
+        "wrap-ansi": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/boxen/node_modules/type-fest": {
+      "version": "0.20.2",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.20.2.tgz",
+      "integrity": "sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/brace-expansion": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz",
+      "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/braces": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
+      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fill-range": "^7.1.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/brorand": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/brorand/-/brorand-1.1.0.tgz",
+      "integrity": "sha512-cKV8tMCEpQs4hK/ik71d6LrPOnpkpGBR0wzxqr68g2m/LB2GxVYQroAjMJZRVM1Y4BCjCKc3vAamxSzOY2RP+w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/brotli-wasm": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/brotli-wasm/-/brotli-wasm-2.0.1.tgz",
+      "integrity": "sha512-+3USgYsC7bzb5yU0/p2HnnynZl0ak0E6uoIm4UW4Aby/8s8HFCq6NCfrrf1E9c3O8OCSzq3oYO1tUVqIi61Nww==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "peer": true
+    },
+    "node_modules/browser-stdout": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/browser-stdout/-/browser-stdout-1.3.1.tgz",
+      "integrity": "sha512-qhAVI1+Av2X7qelOfAIYwXONood6XlZE/fXaBSmW/T5SzLAmCgzi+eiWE7fUvbHaeNBQH13UftjpXxsfLkMpgw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/browserify-aes": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/browserify-aes/-/browserify-aes-1.2.0.tgz",
+      "integrity": "sha512-+7CHXqGuspUn/Sl5aO7Ea0xWGAtETPXNSAjHo48JfLdPWcMng33Xe4znFvQweqc/uzk5zSOI3H52CYnjCfb5hA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "buffer-xor": "^1.0.3",
+        "cipher-base": "^1.0.0",
+        "create-hash": "^1.1.0",
+        "evp_bytestokey": "^1.0.3",
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "node_modules/bs58": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/bs58/-/bs58-4.0.1.tgz",
+      "integrity": "sha512-Ok3Wdf5vOIlBrgCvTq96gBkJw+JUEzdBgyaza5HLtPm7yTHkjRy8+JzNyHF7BHa0bNWOQIp3m5YF0nnFcOIKLw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "base-x": "^3.0.2"
+      }
+    },
+    "node_modules/bs58check": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/bs58check/-/bs58check-2.1.2.tgz",
+      "integrity": "sha512-0TS1jicxdU09dwJMNZtVAfzPi6Q6QeN0pM1Fkzrjn+XYHvzMKPU3pHVpva+769iNVSfIYWf7LJ6WR+BuuMf8cA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bs58": "^4.0.0",
+        "create-hash": "^1.1.0",
+        "safe-buffer": "^5.1.2"
+      }
+    },
+    "node_modules/buffer": {
+      "version": "4.9.2",
+      "resolved": "https://registry.npmjs.org/buffer/-/buffer-4.9.2.tgz",
+      "integrity": "sha512-xq+q3SRMOxGivLhBNaUdC64hDTQwejJ+H0T/NB1XMtTVEwNTrfFF3gAxiyW0Bu/xWEGhjVKgUcMhCrUy2+uCWg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "base64-js": "^1.0.2",
+        "ieee754": "^1.1.4",
+        "isarray": "^1.0.0"
+      }
+    },
+    "node_modules/buffer-from": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/buffer-xor": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/buffer-xor/-/buffer-xor-1.0.3.tgz",
+      "integrity": "sha512-571s0T7nZWK6vB67HI5dyUF7wXiNcfaPPPTl6zYCNApANjIvYJTg7hlud/+cJpdAhS7dVzqMLmfhfHR3rAcOjQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/camelcase": {
+      "version": "6.3.0",
+      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz",
+      "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/cbor": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/cbor/-/cbor-8.1.0.tgz",
+      "integrity": "sha512-DwGjNW9omn6EwP70aXsn7FQJx5kO12tX0bZkaTjzdVFM6/7nhA4t0EENocKGx6D2Bch9PE2KzCUf5SceBdeijg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "nofilter": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=12.19"
+      }
+    },
+    "node_modules/chai": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/chai/-/chai-4.5.0.tgz",
+      "integrity": "sha512-RITGBfijLkBddZvnn8jdqoTypxvqbOLYQkGGxXzeFjVHvudaPw0HNFD9x928/eUwYWd2dPCugVqspGALTZZQKw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "assertion-error": "^1.1.0",
+        "check-error": "^1.0.3",
+        "deep-eql": "^4.1.3",
+        "get-func-name": "^2.0.2",
+        "loupe": "^2.3.6",
+        "pathval": "^1.1.1",
+        "type-detect": "^4.1.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/chai-as-promised": {
+      "version": "7.1.2",
+      "resolved": "https://registry.npmjs.org/chai-as-promised/-/chai-as-promised-7.1.2.tgz",
+      "integrity": "sha512-aBDHZxRzYnUYuIAIPBH2s511DjlKPzXNlXSGFC8CwmroWQLfrW0LtE1nK3MAwwNhJPa9raEjNCmRoFpG0Hurdw==",
+      "dev": true,
+      "license": "WTFPL",
+      "peer": true,
+      "dependencies": {
+        "check-error": "^1.0.2"
+      },
+      "peerDependencies": {
+        "chai": ">= 2.1.2 < 6"
+      }
+    },
+    "node_modules/chalk": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.1.0",
+        "supports-color": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/charenc": {
+      "version": "0.0.2",
+      "resolved": "https://registry.npmjs.org/charenc/-/charenc-0.0.2.tgz",
+      "integrity": "sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/check-error": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/check-error/-/check-error-1.0.3.tgz",
+      "integrity": "sha512-iKEoDYaRmd1mxM90a2OEfWhjsjPpYPuQ+lMYsoxB126+t8fw7ySEO48nmDg5COTjxDI65/Y2OWpeEHk3ZOe8zg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "get-func-name": "^2.0.2"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/chokidar": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.3.tgz",
+      "integrity": "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "readdirp": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 14.16.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ci-info": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-2.0.0.tgz",
+      "integrity": "sha512-5tK7EtrZ0N+OLFMthtqOj4fI2Jeb88C4CAZPu25LDVUgXJ0A3Js4PMGqrn0JU1W0Mh1/Z8wZzYPxqUrXeBboCQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/cipher-base": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/cipher-base/-/cipher-base-1.0.6.tgz",
+      "integrity": "sha512-3Ek9H3X6pj5TgenXYtNWdaBon1tgYCaebd+XPg0keyjEbEfkD4KkmAxkQ/i1vYvxdcT5nscLBfq9VJRmCBcFSw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.4",
+        "safe-buffer": "^5.2.1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/clean-stack": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/clean-stack/-/clean-stack-2.2.0.tgz",
+      "integrity": "sha512-4diC9HaTE+KRAMWhDhrGOECgWZxoevMc5TlkObMqNSsVU62PYzXZ/SMTjzyGAFF1YusgxGcSWTEXBhp0CPwQ1A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/cli-boxes": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/cli-boxes/-/cli-boxes-2.2.1.tgz",
+      "integrity": "sha512-y4coMcylgSCdVinjiDBuR8PCC2bLjyGTwEmPb9NHR/QaNU6EUOXcTY/s6VjGMD6ENSEaeQYHCY0GNGS5jfMwPw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/cli-table3": {
+      "version": "0.6.5",
+      "resolved": "https://registry.npmjs.org/cli-table3/-/cli-table3-0.6.5.tgz",
+      "integrity": "sha512-+W/5efTR7y5HRD7gACw9yQjqMVvEMLBHmboM/kPWam+H+Hmyrgjh6YncVKK122YZkXrLudzTuAukUw9FnMf7IQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "string-width": "^4.2.0"
+      },
+      "engines": {
+        "node": "10.* || >= 12.*"
+      },
+      "optionalDependencies": {
+        "@colors/colors": "1.5.0"
+      }
+    },
+    "node_modules/cliui": {
+      "version": "7.0.4",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz",
+      "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^4.2.0",
+        "strip-ansi": "^6.0.0",
+        "wrap-ansi": "^7.0.0"
+      }
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/combined-stream": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+      "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "delayed-stream": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/command-exists": {
+      "version": "1.2.9",
+      "resolved": "https://registry.npmjs.org/command-exists/-/command-exists-1.2.9.tgz",
+      "integrity": "sha512-LTQ/SGc+s0Xc0Fu5WaKnR0YiygZkm9eKFvyS+fRsU7/ZWFF8ykFM6Pc9aCVf1+xasOOZpO3BAVgVrKvsqKHV7w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/command-line-args": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/command-line-args/-/command-line-args-5.2.1.tgz",
+      "integrity": "sha512-H4UfQhZyakIjC74I9d34fGYDwk3XpSr17QhEd0Q3I9Xq1CETHo4Hcuo87WyWHpAF1aSLjLRf5lD9ZGX2qStUvg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "array-back": "^3.1.0",
+        "find-replace": "^3.0.0",
+        "lodash.camelcase": "^4.3.0",
+        "typical": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/command-line-usage": {
+      "version": "6.1.3",
+      "resolved": "https://registry.npmjs.org/command-line-usage/-/command-line-usage-6.1.3.tgz",
+      "integrity": "sha512-sH5ZSPr+7UStsloltmDh7Ce5fb8XPlHyoPzTpyyMuYCtervL65+ubVZ6Q61cFtFl62UyJlc8/JwERRbAFPUqgw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "array-back": "^4.0.2",
+        "chalk": "^2.4.2",
+        "table-layout": "^1.0.2",
+        "typical": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/ansi-styles": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+      "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-convert": "^1.9.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/array-back": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/array-back/-/array-back-4.0.2.tgz",
+      "integrity": "sha512-NbdMezxqf94cnNfWLL7V/im0Ub+Anbb0IoZhvzie8+4HJ4nMQuzHuy49FkGYCJK2yAloZ3meiB6AVMClbrI1vg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/chalk": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
+      "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^3.2.1",
+        "escape-string-regexp": "^1.0.5",
+        "supports-color": "^5.3.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/color-convert": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
+      "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-name": "1.1.3"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/color-name": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
+      "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/command-line-usage/node_modules/escape-string-regexp": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
+      "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/has-flag": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+      "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/supports-color": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
+      "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "has-flag": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/typical": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/typical/-/typical-5.2.0.tgz",
+      "integrity": "sha512-dvdQgNDNJo+8B2uBQoqdb11eUCE1JQXhvjC/CZtgvZseVd5TYMXnq0+vuUemXbd/Se29cTaUuPX3YIc2xgbvIg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/commander": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz",
+      "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/compare-versions": {
+      "version": "6.1.1",
+      "resolved": "https://registry.npmjs.org/compare-versions/-/compare-versions-6.1.1.tgz",
+      "integrity": "sha512-4hm4VPpIecmlg59CHXnRDnqGplJFrbLG4aFEl5vl6cK1u76ws3LLvX7ikFnTDl5vo39sjWD6AaDPYodJp/NNHg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/concat-map": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/cookie": {
+      "version": "0.4.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.4.2.tgz",
+      "integrity": "sha512-aSWTXFzaKWkvHO1Ny/s+ePFpvKsPnjc551iI41v3ny/ow6tBG5Vd+FuqGNhh1LxOmVzOlGUriIlOaokOvhaStA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/create-hash": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/create-hash/-/create-hash-1.2.0.tgz",
+      "integrity": "sha512-z00bCGNHDG8mHAkP7CtT1qVu+bFQUPjYq/4Iv3C3kWjTFV10zIjfSoeqXo9Asws8gwSHDGj/hl2u4OGIjapeCg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cipher-base": "^1.0.1",
+        "inherits": "^2.0.1",
+        "md5.js": "^1.3.4",
+        "ripemd160": "^2.0.1",
+        "sha.js": "^2.4.0"
+      }
+    },
+    "node_modules/create-hmac": {
+      "version": "1.1.7",
+      "resolved": "https://registry.npmjs.org/create-hmac/-/create-hmac-1.1.7.tgz",
+      "integrity": "sha512-MJG9liiZ+ogc4TzUwuvbER1JRdgvUFSB5+VR/g5h82fGaIRWMWddtKBHi7/sVhfjQZ6SehlyhvQYrcYkaUIpLg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cipher-base": "^1.0.3",
+        "create-hash": "^1.1.0",
+        "inherits": "^2.0.1",
+        "ripemd160": "^2.0.0",
+        "safe-buffer": "^5.0.1",
+        "sha.js": "^2.4.8"
+      }
+    },
+    "node_modules/create-require": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz",
+      "integrity": "sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/cross-spawn/node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/crypt": {
+      "version": "0.0.2",
+      "resolved": "https://registry.npmjs.org/crypt/-/crypt-0.0.2.tgz",
+      "integrity": "sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/death": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/death/-/death-1.1.0.tgz",
+      "integrity": "sha512-vsV6S4KVHvTGxbEcij7hkWRv0It+sGGWVOM67dQde/o5Xjnr+KmLjxWJii2uEObIrt1CcM9w0Yaovx+iOlIL+w==",
+      "dev": true,
+      "peer": true
+    },
+    "node_modules/debug": {
+      "version": "4.4.0",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz",
+      "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/decamelize": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-4.0.0.tgz",
+      "integrity": "sha512-9iE1PgSik9HeIIw2JO94IidnE3eBoQrFJ3w7sFuzSX4DpmZ3v5sZpUiV5Swcf6mQEF+Y0ru8Neo+p+nyh2J+hQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/deep-eql": {
+      "version": "4.1.4",
+      "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-4.1.4.tgz",
+      "integrity": "sha512-SUwdGfqdKOwxCPeVYjwSyRpJ7Z+fhpwIAtmCUdZIWZ/YP5R9WAsyuSgpLVDi9bjWoN2LXHNss/dk3urXtdQxGg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "type-detect": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/deep-extend": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz",
+      "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/deep-is": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz",
+      "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/delayed-stream": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+      "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/diff": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/diff/-/diff-5.2.0.tgz",
+      "integrity": "sha512-uIFDxqpRZGZ6ThOk84hEfqWoHx2devRFvpTZcTHur85vImfaxUbTW9Ryh4CpCuDnToOP1CEtXKIgytHBPVff5A==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.3.1"
+      }
+    },
+    "node_modules/difflib": {
+      "version": "0.2.4",
+      "resolved": "https://registry.npmjs.org/difflib/-/difflib-0.2.4.tgz",
+      "integrity": "sha512-9YVwmMb0wQHQNr5J9m6BSj6fk4pfGITGQOOs+D9Fl+INODWFOfvhIU1hNv6GgR1RBoC/9NJcwu77zShxV0kT7w==",
+      "dev": true,
+      "peer": true,
+      "dependencies": {
+        "heap": ">= 0.2.0"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/dir-glob": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz",
+      "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "path-type": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/eastasianwidth": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
+      "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/elliptic": {
+      "version": "6.5.4",
+      "resolved": "https://registry.npmjs.org/elliptic/-/elliptic-6.5.4.tgz",
+      "integrity": "sha512-iLhC6ULemrljPZb+QutR5TQGB+pdW6KGD5RSegS+8sorOZT+rdQFbsQFJgvN3eRqNALqJer4oQ16YvJHlU8hzQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bn.js": "^4.11.9",
+        "brorand": "^1.1.0",
+        "hash.js": "^1.0.0",
+        "hmac-drbg": "^1.0.1",
+        "inherits": "^2.0.4",
+        "minimalistic-assert": "^1.0.1",
+        "minimalistic-crypto-utils": "^1.0.1"
+      }
+    },
+    "node_modules/elliptic/node_modules/bn.js": {
+      "version": "4.12.1",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+      "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/enquirer": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/enquirer/-/enquirer-2.4.1.tgz",
+      "integrity": "sha512-rRqJg/6gd538VHvR3PSrdRBb/1Vy2YfzHqzvbhGIQpDRKIa4FgV/54b5Q1xYSxOOwKvjXweS26E0Q+nAMwp2pQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-colors": "^4.1.1",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8.6"
+      }
+    },
+    "node_modules/env-paths": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz",
+      "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/escape-string-regexp": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
+      "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/escodegen": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/escodegen/-/escodegen-1.8.1.tgz",
+      "integrity": "sha512-yhi5S+mNTOuRvyW4gWlg5W1byMaQGWWSYHXsuFZ7GBo7tpyOwi2EdzMP/QWxh9hwkD2m+wDVHJsxhRIj+v/b/A==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "peer": true,
+      "dependencies": {
+        "esprima": "^2.7.1",
+        "estraverse": "^1.9.1",
+        "esutils": "^2.0.2",
+        "optionator": "^0.8.1"
+      },
+      "bin": {
+        "escodegen": "bin/escodegen.js",
+        "esgenerate": "bin/esgenerate.js"
+      },
+      "engines": {
+        "node": ">=0.12.0"
+      },
+      "optionalDependencies": {
+        "source-map": "~0.2.0"
+      }
+    },
+    "node_modules/esprima": {
+      "version": "2.7.3",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-2.7.3.tgz",
+      "integrity": "sha512-OarPfz0lFCiW4/AV2Oy1Rp9qu0iusTKqykwTspGCZtPxmF81JR4MmIebvF1F9+UOKth2ZubLQ4XGGaU+hSn99A==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "peer": true,
+      "bin": {
+        "esparse": "bin/esparse.js",
+        "esvalidate": "bin/esvalidate.js"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/estraverse": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-1.9.3.tgz",
+      "integrity": "sha512-25w1fMXQrGdoquWnScXZGckOv+Wes+JDnuN/+7ex3SauFRS72r2lFDec0EKPt2YD1wUJ/IrfEex+9yp4hfSOJA==",
+      "dev": true,
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/esutils": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz",
+      "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/ethereum-bloom-filters": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/ethereum-bloom-filters/-/ethereum-bloom-filters-1.2.0.tgz",
+      "integrity": "sha512-28hyiE7HVsWubqhpVLVmZXFd4ITeHi+BUu05o9isf0GUpMtzBUi+8/gFrGaGYzvGAJQmJ3JKj77Mk9G98T84rA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "^1.4.0"
+      }
+    },
+    "node_modules/ethereum-bloom-filters/node_modules/@noble/hashes": {
+      "version": "1.7.1",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.7.1.tgz",
+      "integrity": "sha512-B8XBPsn4vT/KJAGqDzbwztd+6Yte3P4V7iafm24bxgDe/mlRuK6xmWPuCNrKt2vDafZ8MfJLlchDG/vYafQEjQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ethereum-cryptography": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-0.1.3.tgz",
+      "integrity": "sha512-w8/4x1SGGzc+tO97TASLja6SLd3fRIK2tLVcV2Gx4IB21hE19atll5Cq9o3d0ZmAYC/8aw0ipieTSiekAea4SQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/pbkdf2": "^3.0.0",
+        "@types/secp256k1": "^4.0.1",
+        "blakejs": "^1.1.0",
+        "browserify-aes": "^1.2.0",
+        "bs58check": "^2.1.2",
+        "create-hash": "^1.2.0",
+        "create-hmac": "^1.1.7",
+        "hash.js": "^1.1.7",
+        "keccak": "^3.0.0",
+        "pbkdf2": "^3.0.17",
+        "randombytes": "^2.1.0",
+        "safe-buffer": "^5.1.2",
+        "scrypt-js": "^3.0.0",
+        "secp256k1": "^4.0.1",
+        "setimmediate": "^1.0.5"
+      }
+    },
+    "node_modules/ethereumjs-util": {
+      "version": "7.1.5",
+      "resolved": "https://registry.npmjs.org/ethereumjs-util/-/ethereumjs-util-7.1.5.tgz",
+      "integrity": "sha512-SDl5kKrQAudFBUe5OJM9Ac6WmMyYmXX/6sTmLZ3ffG2eY6ZIGBes3pEDxNN6V72WyOw4CPD5RomKdsa8DAAwLg==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "dependencies": {
+        "@types/bn.js": "^5.1.0",
+        "bn.js": "^5.1.2",
+        "create-hash": "^1.1.2",
+        "ethereum-cryptography": "^0.1.3",
+        "rlp": "^2.2.4"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/ethers": {
+      "version": "6.14.4",
+      "resolved": "https://registry.npmjs.org/ethers/-/ethers-6.14.4.tgz",
+      "integrity": "sha512-Jm/dzRs2Z9iBrT6e9TvGxyb5YVKAPLlpna7hjxH7KH/++DSh2T/JVmQUv7iHI5E55hDbp/gEVvstWYXVxXFzsA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/ethers-io/"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@adraffy/ens-normalize": "1.10.1",
+        "@noble/curves": "1.2.0",
+        "@noble/hashes": "1.3.2",
+        "@types/node": "22.7.5",
+        "aes-js": "4.0.0-beta.5",
+        "tslib": "2.7.0",
+        "ws": "8.17.1"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/ethers/node_modules/@types/node": {
+      "version": "22.7.5",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.7.5.tgz",
+      "integrity": "sha512-jML7s2NAzMWc//QSJ1a3prpk78cOPchGvXJsC3C6R6PSMoooztvRVQEz89gmBTBY1SPMaqo5teB4uNHPdetShQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "undici-types": "~6.19.2"
+      }
+    },
+    "node_modules/ethers/node_modules/tslib": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.7.0.tgz",
+      "integrity": "sha512-gLXCKdN1/j47AiHiOkJN69hJmcbGTHI0ImLmbYLHykhgeN0jVGola9yVjFgzCUklsZQMW55o+dW7IXv3RCXDzA==",
+      "dev": true,
+      "license": "0BSD",
+      "peer": true
+    },
+    "node_modules/ethers/node_modules/undici-types": {
+      "version": "6.19.8",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz",
+      "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/ethjs-unit": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/ethjs-unit/-/ethjs-unit-0.1.6.tgz",
+      "integrity": "sha512-/Sn9Y0oKl0uqQuvgFk/zQgR7aw1g36qX/jzSQ5lSwlO0GigPymk4eGQfeNTD03w1dPOqfz8V77Cy43jH56pagw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "bn.js": "4.11.6",
+        "number-to-bn": "1.7.0"
+      },
+      "engines": {
+        "node": ">=6.5.0",
+        "npm": ">=3"
+      }
+    },
+    "node_modules/ethjs-unit/node_modules/bn.js": {
+      "version": "4.11.6",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.11.6.tgz",
+      "integrity": "sha512-XWwnNNFCuuSQ0m3r3C4LE3EiORltHd9M05pq6FOlVeiophzRbMo50Sbz1ehl8K3Z+jw9+vmgnXefY1hz8X+2wA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/eventemitter3": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.1.tgz",
+      "integrity": "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/evp_bytestokey": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/evp_bytestokey/-/evp_bytestokey-1.0.3.tgz",
+      "integrity": "sha512-/f2Go4TognH/KvCISP7OUsHn85hT9nUkxxA9BEWxFn+Oj9o8ZNLm/40hdlgSLyuOimsrTKLUMEorQexp/aPQeA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "md5.js": "^1.3.4",
+        "safe-buffer": "^5.1.1"
+      }
+    },
+    "node_modules/fast-base64-decode": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fast-base64-decode/-/fast-base64-decode-1.0.0.tgz",
+      "integrity": "sha512-qwaScUgUGBYeDNRnbc/KyllVU88Jk1pRHPStuF/lO7B0/RTRLj7U0lkdTAutlBblY08rwZDff6tNU9cjv6j//Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/fast-glob": {
+      "version": "3.3.3",
+      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
+      "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@nodelib/fs.stat": "^2.0.2",
+        "@nodelib/fs.walk": "^1.2.3",
+        "glob-parent": "^5.1.2",
+        "merge2": "^1.3.0",
+        "micromatch": "^4.0.8"
+      },
+      "engines": {
+        "node": ">=8.6.0"
+      }
+    },
+    "node_modules/fast-levenshtein": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz",
+      "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/fast-uri": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.0.6.tgz",
+      "integrity": "sha512-Atfo14OibSv5wAp4VWNsFYE1AchQRTv9cBGWET4pZWHzYshFSS9NQI6I57rdKn9croWVMbYFbLhJ+yJvmZIIHw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause",
+      "peer": true
+    },
+    "node_modules/fast-xml-parser": {
+      "version": "4.4.1",
+      "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-4.4.1.tgz",
+      "integrity": "sha512-xkjOecfnKGkSsOwtZ5Pz7Us/T6mrbPQrq0nh+aCO5V9nk5NLWmasAHumTKjiPJPWANe+kAZ84Jc8ooJkzZ88Sw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/NaturalIntelligence"
+        },
+        {
+          "type": "paypal",
+          "url": "https://paypal.me/naturalintelligence"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "strnum": "^1.0.5"
+      },
+      "bin": {
+        "fxparser": "src/cli/cli.js"
+      }
+    },
+    "node_modules/fastq": {
+      "version": "1.19.1",
+      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz",
+      "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "reusify": "^1.0.4"
+      }
+    },
+    "node_modules/fill-range": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
+      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "to-regex-range": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/find-replace": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/find-replace/-/find-replace-3.0.0.tgz",
+      "integrity": "sha512-6Tb2myMioCAgv5kfvP5/PkZZ/ntTpVK39fHY7WkWBgvbeE+VHd/tZuZ4mrC+bxh4cfOZeYKVPaJIZtZXV7GNCQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "array-back": "^3.0.1"
+      },
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/find-up": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
+      "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "locate-path": "^6.0.0",
+        "path-exists": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/flat": {
+      "version": "5.0.2",
+      "resolved": "https://registry.npmjs.org/flat/-/flat-5.0.2.tgz",
+      "integrity": "sha512-b6suED+5/3rTpUBdG1gupIl8MPFCAMA0QXwmljLhvCUKcUvdE4gWky9zpuGCcXHOsz4J9wPGNWq6OKpmIzz3hQ==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "bin": {
+        "flat": "cli.js"
+      }
+    },
+    "node_modules/follow-redirects": {
+      "version": "1.15.9",
+      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.9.tgz",
+      "integrity": "sha512-gew4GsXizNgdoRyqmyfMHyAmXsZDk6mHkSxZFCzW9gwlbtOW44CDtYavM+y+72qD/Vq2l550kMF52DT8fOLJqQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/RubenVerborgh"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0"
+      },
+      "peerDependenciesMeta": {
+        "debug": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/foreground-child": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz",
+      "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "cross-spawn": "^7.0.6",
+        "signal-exit": "^4.0.1"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/foreground-child/node_modules/signal-exit": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/form-data": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.2.tgz",
+      "integrity": "sha512-hGfm/slu0ZabnNt4oaRZ6uREyfCj6P4fT/n6A1rGV+Z0VdGXjfOhVUpkn6qVQONHGIFwmveGXyDs75+nr6FM8w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "asynckit": "^0.4.0",
+        "combined-stream": "^1.0.8",
+        "es-set-tostringtag": "^2.1.0",
+        "mime-types": "^2.1.12"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/fp-ts": {
+      "version": "1.19.3",
+      "resolved": "https://registry.npmjs.org/fp-ts/-/fp-ts-1.19.3.tgz",
+      "integrity": "sha512-H5KQDspykdHuztLTg+ajGN0Z2qUjcEf3Ybxc6hLt0k7/zPkn29XnKnxlBPyW2XIddWrGaJBzBl4VLYOtk39yZg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fs-extra": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
+      "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/fs.realpath": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
+      "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-caller-file": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+      "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": "6.* || 8.* || >= 10.*"
+      }
+    },
+    "node_modules/get-func-name": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/get-func-name/-/get-func-name-2.0.2.tgz",
+      "integrity": "sha512-8vXOvuE167CtIc3OyItco7N/dpRtBbYOsPsXCz7X/PMnlGjYjSGuZJgM1Y7mmew7BKf9BqvLX2tnOVy1BBUsxQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ghost-testrpc": {
+      "version": "0.0.2",
+      "resolved": "https://registry.npmjs.org/ghost-testrpc/-/ghost-testrpc-0.0.2.tgz",
+      "integrity": "sha512-i08dAEgJ2g8z5buJIrCTduwPIhih3DP+hOCTyyryikfV8T0bNvHnGXO67i0DD1H4GBDETTclPy9njZbfluQYrQ==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "chalk": "^2.4.2",
+        "node-emoji": "^1.10.0"
+      },
+      "bin": {
+        "testrpc-sc": "index.js"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/ansi-styles": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+      "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-convert": "^1.9.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/chalk": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
+      "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^3.2.1",
+        "escape-string-regexp": "^1.0.5",
+        "supports-color": "^5.3.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/color-convert": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
+      "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-name": "1.1.3"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/color-name": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
+      "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/ghost-testrpc/node_modules/escape-string-regexp": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
+      "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/has-flag": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+      "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/supports-color": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
+      "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "has-flag": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/glob": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-8.1.0.tgz",
+      "integrity": "sha512-r8hpEjiQEYlF2QU0df3dS+nxxSIreXQS1qRhMJM0Q5NDdR386C7jb7Hwwod8Fgiuex+k0GFjgft18yvxm5XoCQ==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^5.0.1",
+        "once": "^1.3.0"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/glob-parent": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
+      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "is-glob": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/glob/node_modules/minimatch": {
+      "version": "5.1.6",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.6.tgz",
+      "integrity": "sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/global-modules": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/global-modules/-/global-modules-2.0.0.tgz",
+      "integrity": "sha512-NGbfmJBp9x8IxyJSd1P+otYK8vonoJactOogrVfFRIAEY1ukil8RSKDz2Yo7wh1oihl51l/r6W4epkeKJHqL8A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "global-prefix": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/global-prefix": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/global-prefix/-/global-prefix-3.0.0.tgz",
+      "integrity": "sha512-awConJSVCHVGND6x3tmMaKcQvwXLhjdkmomy2W+Goaui8YPgYgXJZewhg3fWC+DlfqqQuWg8AwqjGTD2nAPVWg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ini": "^1.3.5",
+        "kind-of": "^6.0.2",
+        "which": "^1.3.1"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/globby": {
+      "version": "10.0.2",
+      "resolved": "https://registry.npmjs.org/globby/-/globby-10.0.2.tgz",
+      "integrity": "sha512-7dUi7RvCoT/xast/o/dLN53oqND4yk0nsHkhRgn9w65C4PofCLOoJ39iSOg+qVDdWQPIEj+eszMHQ+aLVwwQSg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/glob": "^7.1.1",
+        "array-union": "^2.1.0",
+        "dir-glob": "^3.0.1",
+        "fast-glob": "^3.0.3",
+        "glob": "^7.1.3",
+        "ignore": "^5.1.1",
+        "merge2": "^1.2.3",
+        "slash": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/globby/node_modules/brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/globby/node_modules/glob": {
+      "version": "7.2.3",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
+      "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^3.1.1",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/globby/node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/graceful-fs": {
+      "version": "4.2.11",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/handlebars": {
+      "version": "4.7.8",
+      "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz",
+      "integrity": "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "minimist": "^1.2.5",
+        "neo-async": "^2.6.2",
+        "source-map": "^0.6.1",
+        "wordwrap": "^1.0.0"
+      },
+      "bin": {
+        "handlebars": "bin/handlebars"
+      },
+      "engines": {
+        "node": ">=0.4.7"
+      },
+      "optionalDependencies": {
+        "uglify-js": "^3.1.4"
+      }
+    },
+    "node_modules/handlebars/node_modules/source-map": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/hardhat": {
+      "version": "2.25.0",
+      "resolved": "https://registry.npmjs.org/hardhat/-/hardhat-2.25.0.tgz",
+      "integrity": "sha512-yBiA74Yj3VnTRj7lhnn8GalvBdvsMOqTKRrRATSy/2v0VIR2hR0Jcnmfn4aQBLtGAnr3Q2c8CxL0g3LYegUp+g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@ethereumjs/util": "^9.1.0",
+        "@ethersproject/abi": "^5.1.2",
+        "@nomicfoundation/edr": "^0.11.1",
+        "@nomicfoundation/solidity-analyzer": "^0.1.0",
+        "@sentry/node": "^5.18.1",
+        "@types/bn.js": "^5.1.0",
+        "@types/lru-cache": "^5.1.0",
+        "adm-zip": "^0.4.16",
+        "aggregate-error": "^3.0.0",
+        "ansi-escapes": "^4.3.0",
+        "boxen": "^5.1.2",
+        "chokidar": "^4.0.0",
+        "ci-info": "^2.0.0",
+        "debug": "^4.1.1",
+        "enquirer": "^2.3.0",
+        "env-paths": "^2.2.0",
+        "ethereum-cryptography": "^1.0.3",
+        "find-up": "^5.0.0",
+        "fp-ts": "1.19.3",
+        "fs-extra": "^7.0.1",
+        "immutable": "^4.0.0-rc.12",
+        "io-ts": "1.10.4",
+        "json-stream-stringify": "^3.1.4",
+        "keccak": "^3.0.2",
+        "lodash": "^4.17.11",
+        "micro-eth-signer": "^0.14.0",
+        "mnemonist": "^0.38.0",
+        "mocha": "^10.0.0",
+        "p-map": "^4.0.0",
+        "picocolors": "^1.1.0",
+        "raw-body": "^2.4.1",
+        "resolve": "1.17.0",
+        "semver": "^6.3.0",
+        "solc": "0.8.26",
+        "source-map-support": "^0.5.13",
+        "stacktrace-parser": "^0.1.10",
+        "tinyglobby": "^0.2.6",
+        "tsort": "0.0.1",
+        "undici": "^5.14.0",
+        "uuid": "^8.3.2",
+        "ws": "^7.4.6"
+      },
+      "bin": {
+        "hardhat": "internal/cli/bootstrap.js"
+      },
+      "peerDependencies": {
+        "ts-node": "*",
+        "typescript": "*"
+      },
+      "peerDependenciesMeta": {
+        "ts-node": {
+          "optional": true
+        },
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/hardhat-gas-reporter": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/hardhat-gas-reporter/-/hardhat-gas-reporter-2.3.0.tgz",
+      "integrity": "sha512-ySdA+044xMQv1BlJu5CYXToHzMexKFfIWxlQTBNNoerx1x96+d15IMdN01iQZ/TJ7NH2V5sU73bz77LoS/PEVw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/abi": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/units": "^5.7.0",
+        "@solidity-parser/parser": "^0.20.1",
+        "axios": "^1.6.7",
+        "brotli-wasm": "^2.0.1",
+        "chalk": "4.1.2",
+        "cli-table3": "^0.6.3",
+        "ethereum-cryptography": "^2.1.3",
+        "glob": "^10.3.10",
+        "jsonschema": "^1.4.1",
+        "lodash": "^4.17.21",
+        "markdown-table": "2.0.0",
+        "sha1": "^1.1.1",
+        "viem": "^2.27.0"
+      },
+      "peerDependencies": {
+        "hardhat": "^2.16.0"
+      }
+    },
+    "node_modules/hardhat-gas-reporter/node_modules/@noble/curves": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.4.2.tgz",
+      "integrity": "sha512-TavHr8qycMChk8UwMld0ZDRvatedkzWfH8IiaeGCfymOP5i0hSCozz9vHOL0nkwk7HRMlFnAiKpS2jrUmSybcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.4.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/hardhat-gas-reporter/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/hardhat-gas-reporter/node_modules/ethereum-cryptography": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-2.2.1.tgz",
+      "integrity": "sha512-r/W8lkHSiTLxUxW8Rf3u4HGB0xQweG2RyETjywylKZSzLWoWAijRz8WCuOtJ6wah+avllXBqZuk29HCCvhEIRg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "1.4.2",
+        "@noble/hashes": "1.4.0",
+        "@scure/bip32": "1.4.0",
+        "@scure/bip39": "1.3.0"
+      }
+    },
+    "node_modules/hardhat-gas-reporter/node_modules/glob": {
+      "version": "10.4.5",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-10.4.5.tgz",
+      "integrity": "sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "foreground-child": "^3.1.0",
+        "jackspeak": "^3.1.2",
+        "minimatch": "^9.0.4",
+        "minipass": "^7.1.2",
+        "package-json-from-dist": "^1.0.0",
+        "path-scurry": "^1.11.1"
+      },
+      "bin": {
+        "glob": "dist/esm/bin.mjs"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/hardhat/node_modules/@ethereumjs/rlp": {
+      "version": "5.0.2",
+      "resolved": "https://registry.npmjs.org/@ethereumjs/rlp/-/rlp-5.0.2.tgz",
+      "integrity": "sha512-DziebCdg4JpGlEqEdGgXmjqcFoJi+JGulUXwEjsZGAscAQ7MyD/7LE/GVCP29vEQxKc7AAwjT3A2ywHp2xfoCA==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "bin": {
+        "rlp": "bin/rlp.cjs"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/hardhat/node_modules/@ethereumjs/util": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/@ethereumjs/util/-/util-9.1.0.tgz",
+      "integrity": "sha512-XBEKsYqLGXLah9PNJbgdkigthkG7TAGvlD/sH12beMXEyHDyigfcbdvHhmLyDWgDyOJn4QwiQUaF7yeuhnjdog==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "dependencies": {
+        "@ethereumjs/rlp": "^5.0.2",
+        "ethereum-cryptography": "^2.2.1"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/hardhat/node_modules/@ethereumjs/util/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/hardhat/node_modules/@ethereumjs/util/node_modules/@scure/bip32": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip32/-/bip32-1.4.0.tgz",
+      "integrity": "sha512-sVUpc0Vq3tXCkDGYVWGIZTRfnvu8LoTDaev7vbwh0omSvVORONr960MQWdKqJDCReIEmTj3PAr73O3aoxz7OPg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@noble/curves": "~1.4.0",
+        "@noble/hashes": "~1.4.0",
+        "@scure/base": "~1.1.6"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/hardhat/node_modules/@ethereumjs/util/node_modules/@scure/bip39": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip39/-/bip39-1.3.0.tgz",
+      "integrity": "sha512-disdg7gHuTDZtY+ZdkmLpPCk7fxZSu3gBiEGuoC1XYxv9cGx3Z6cpTggCgW6odSOOIXCiDjuGejW+aJKCY/pIQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "~1.4.0",
+        "@scure/base": "~1.1.6"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/hardhat/node_modules/@ethereumjs/util/node_modules/ethereum-cryptography": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-2.2.1.tgz",
+      "integrity": "sha512-r/W8lkHSiTLxUxW8Rf3u4HGB0xQweG2RyETjywylKZSzLWoWAijRz8WCuOtJ6wah+avllXBqZuk29HCCvhEIRg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@noble/curves": "1.4.2",
+        "@noble/hashes": "1.4.0",
+        "@scure/bip32": "1.4.0",
+        "@scure/bip39": "1.3.0"
+      }
+    },
+    "node_modules/hardhat/node_modules/@noble/curves": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.4.2.tgz",
+      "integrity": "sha512-TavHr8qycMChk8UwMld0ZDRvatedkzWfH8IiaeGCfymOP5i0hSCozz9vHOL0nkwk7HRMlFnAiKpS2jrUmSybcw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "1.4.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/hardhat/node_modules/@noble/curves/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/hardhat/node_modules/@noble/hashes": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.2.0.tgz",
+      "integrity": "sha512-FZfhjEDbT5GRswV3C6uvLPHMiVD6lQBmpoX5+eSiPaMTXte/IKqI5dykDxzZB/WBeK/CDuQRBWarPdi3FNY2zQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://paulmillr.com/funding/"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/hardhat/node_modules/@scure/bip32": {
+      "version": "1.1.5",
+      "resolved": "https://registry.npmjs.org/@scure/bip32/-/bip32-1.1.5.tgz",
+      "integrity": "sha512-XyNh1rB0SkEqd3tXcXMi+Xe1fvg+kUIcoRIEujP1Jgv7DqW2r9lg3Ah0NkFaCs9sTkQAQA8kw7xiRXzENi9Rtw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://paulmillr.com/funding/"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "~1.2.0",
+        "@noble/secp256k1": "~1.7.0",
+        "@scure/base": "~1.1.0"
+      }
+    },
+    "node_modules/hardhat/node_modules/@scure/bip39": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/@scure/bip39/-/bip39-1.1.1.tgz",
+      "integrity": "sha512-t+wDck2rVkh65Hmv280fYdVdY25J9YeEUIgn2LG1WM6gxFkGzcksoDiUkWVpVp3Oex9xGC68JU2dSbUfwZ2jPg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://paulmillr.com/funding/"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "~1.2.0",
+        "@scure/base": "~1.1.0"
+      }
+    },
+    "node_modules/hardhat/node_modules/ethereum-cryptography": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-1.2.0.tgz",
+      "integrity": "sha512-6yFQC9b5ug6/17CQpCyE3k9eKBMdhyVjzUy1WkiuY/E4vj/SXDBbCw8QEIaXqf0Mf2SnY6RmpDcwlUmBSS0EJw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "1.2.0",
+        "@noble/secp256k1": "1.7.1",
+        "@scure/bip32": "1.1.5",
+        "@scure/bip39": "1.1.1"
+      }
+    },
+    "node_modules/hardhat/node_modules/fs-extra": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-7.0.1.tgz",
+      "integrity": "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.1.2",
+        "jsonfile": "^4.0.0",
+        "universalify": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=6 <7 || >=8"
+      }
+    },
+    "node_modules/hardhat/node_modules/jsonfile": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
+      "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
+      "dev": true,
+      "license": "MIT",
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/hardhat/node_modules/universalify": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
+      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/hardhat/node_modules/uuid": {
+      "version": "8.3.2",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz",
+      "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist/bin/uuid"
+      }
+    },
+    "node_modules/hardhat/node_modules/ws": {
+      "version": "7.5.10",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.10.tgz",
+      "integrity": "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.3.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": "^5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/has-flag": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-symbols": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hash-base": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/hash-base/-/hash-base-3.1.0.tgz",
+      "integrity": "sha512-1nmYp/rhMDiE7AYkDw+lLwlAzz0AntGIe51F3RfFfEqyQ3feY2eI/NcwC6umIQVOASPMsWJLJScWKSSvzL9IVA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.4",
+        "readable-stream": "^3.6.0",
+        "safe-buffer": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/hash.js": {
+      "version": "1.1.7",
+      "resolved": "https://registry.npmjs.org/hash.js/-/hash.js-1.1.7.tgz",
+      "integrity": "sha512-taOaskGt4z4SOANNseOviYDvjEJinIkRgmp7LbKP2YTTmVxWBl87s/uzK9r+44BclBSp2X7K1hqeNfz9JbBeXA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "minimalistic-assert": "^1.0.1"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/he": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz",
+      "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "he": "bin/he"
+      }
+    },
+    "node_modules/heap": {
+      "version": "0.2.7",
+      "resolved": "https://registry.npmjs.org/heap/-/heap-0.2.7.tgz",
+      "integrity": "sha512-2bsegYkkHO+h/9MGbn6KWcE45cHZgPANo5LXF7EvWdT0yT2EguSVO1nDgU5c8+ZOPwp2vMNa7YFsJhVcDR9Sdg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/hmac-drbg": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/hmac-drbg/-/hmac-drbg-1.0.1.tgz",
+      "integrity": "sha512-Tti3gMqLdZfhOQY1Mzf/AanLiqh1WTiJgEj26ZuYQ9fbkLomzGchCws4FyrSd4VkpBfiNhaE1On+lOz894jvXg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "hash.js": "^1.0.3",
+        "minimalistic-assert": "^1.0.0",
+        "minimalistic-crypto-utils": "^1.0.1"
+      }
+    },
+    "node_modules/http-errors": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz",
+      "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "depd": "2.0.0",
+        "inherits": "2.0.4",
+        "setprototypeof": "1.2.0",
+        "statuses": "2.0.1",
+        "toidentifier": "1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/https-proxy-agent": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz",
+      "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "6",
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.4.24",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
+      "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/ieee754": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz",
+      "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "BSD-3-Clause"
+    },
+    "node_modules/ignore": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
+      "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/immer": {
+      "version": "10.0.2",
+      "resolved": "https://registry.npmjs.org/immer/-/immer-10.0.2.tgz",
+      "integrity": "sha512-Rx3CqeqQ19sxUtYV9CU911Vhy8/721wRFnJv3REVGWUmoAcIwzifTsdmJte/MV+0/XpM35LZdQMBGkRIoLPwQA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/immer"
+      }
+    },
+    "node_modules/immutable": {
+      "version": "4.3.7",
+      "resolved": "https://registry.npmjs.org/immutable/-/immutable-4.3.7.tgz",
+      "integrity": "sha512-1hqclzwYwjRDFLjcFxOM5AYkkG0rpFPpr1RLPMEuGczoS7YA8gLhy8SWXYRAA/XwfEHpfo3cw5JGioS32fnMRw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/indent-string": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-4.0.0.tgz",
+      "integrity": "sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/inflight": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
+      "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==",
+      "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "once": "^1.3.0",
+        "wrappy": "1"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/ini": {
+      "version": "1.3.8",
+      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
+      "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/interpret": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/interpret/-/interpret-1.4.0.tgz",
+      "integrity": "sha512-agE4QfB2Lkp9uICn7BAqoscw4SZP9kTE2hxiFI3jBPmXJfdqiahTbUuKGsMoN2GtqL9AxhYioAcVvgsb1HvRbA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/io-ts": {
+      "version": "1.10.4",
+      "resolved": "https://registry.npmjs.org/io-ts/-/io-ts-1.10.4.tgz",
+      "integrity": "sha512-b23PteSnYXSONJ6JQXRAlvJhuw8KOtkqa87W4wDtvMrud/DTJd5X+NpOOI+O/zZwVq6v0VLAaJ+1EDViKEuN9g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fp-ts": "^1.0.0"
+      }
+    },
+    "node_modules/is-binary-path": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz",
+      "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "binary-extensions": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-extglob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-glob": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
+      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-extglob": "^2.1.1"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-hex-prefixed": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-hex-prefixed/-/is-hex-prefixed-1.0.0.tgz",
+      "integrity": "sha512-WvtOiug1VFrE9v1Cydwm+FnXd3+w9GaeVUss5W4v/SLy3UW00vP+6iNF2SdnfiBoLy4bTqVdkftNGTUeOFVsbA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6.5.0",
+        "npm": ">=3"
+      }
+    },
+    "node_modules/is-number": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
+      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.12.0"
+      }
+    },
+    "node_modules/is-plain-obj": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-2.1.0.tgz",
+      "integrity": "sha512-YWnfyRwxL/+SsrWYfOpUtz5b3YD+nyfkHvjbcanzk8zgyO4ASD67uVMRt8k5bM4lLMDnXfriRhOpemw+NfT1eA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-unicode-supported": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-0.1.0.tgz",
+      "integrity": "sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/isarray": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/isarray/-/isarray-1.0.0.tgz",
+      "integrity": "sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/isomorphic-unfetch": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/isomorphic-unfetch/-/isomorphic-unfetch-3.1.0.tgz",
+      "integrity": "sha512-geDJjpoZ8N0kWexiwkX8F9NkTsXhetLPVbZFQ+JTW239QNOwvB0gniuR1Wc6f0AMTn7/mFGyXvHTifrCp/GH8Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "node-fetch": "^2.6.1",
+        "unfetch": "^4.2.0"
+      }
+    },
+    "node_modules/isows": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/isows/-/isows-1.0.7.tgz",
+      "integrity": "sha512-I1fSfDCZL5P0v33sVqeTDSpcstAg/N+wF5HS033mogOVIp4B+oHC7oOCsA3axAbBSGTJ8QubbNmnIRN/h8U7hg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/wevm"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "peerDependencies": {
+        "ws": "*"
+      }
+    },
+    "node_modules/jackspeak": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz",
+      "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "peer": true,
+      "dependencies": {
+        "@isaacs/cliui": "^8.0.2"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      },
+      "optionalDependencies": {
+        "@pkgjs/parseargs": "^0.11.0"
+      }
+    },
+    "node_modules/js-cookie": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/js-cookie/-/js-cookie-2.2.1.tgz",
+      "integrity": "sha512-HvdH2LzI/EAZcUwA8+0nKNtWHqS+ZmijLA30RwZA0bo7ToCckjK5MkGhjED9KoRcXO6BaGI3I9UIzSA1FKFPOQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/js-sha3": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/js-sha3/-/js-sha3-0.8.0.tgz",
+      "integrity": "sha512-gF1cRrHhIzNfToc802P800N8PpXS+evLLXfsVpowqmAFR9uwbi89WvXg2QspOmXL8QL86J4T1EpFu+yUkwJY3Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/js-yaml": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
+      "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^2.0.1"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/json-stream-stringify": {
+      "version": "3.1.6",
+      "resolved": "https://registry.npmjs.org/json-stream-stringify/-/json-stream-stringify-3.1.6.tgz",
+      "integrity": "sha512-x7fpwxOkbhFCaJDJ8vb1fBY3DdSa4AlITaz+HHILQJzdPMnHEFjxPwVUi1ALIbcIxDE0PNe/0i7frnY8QnBQog==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=7.10.1"
+      }
+    },
+    "node_modules/json-stringify-safe": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz",
+      "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/json5": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
+      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "bin": {
+        "json5": "lib/cli.js"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/jsonfile": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.1.0.tgz",
+      "integrity": "sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "universalify": "^2.0.0"
+      },
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/jsonschema": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/jsonschema/-/jsonschema-1.5.0.tgz",
+      "integrity": "sha512-K+A9hhqbn0f3pJX17Q/7H6yQfD/5OXgdrR5UE12gMXCiN9D5Xq2o5mddV2QEcX/bjla99ASsAAQUyMCCRWAEhw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/keccak": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/keccak/-/keccak-3.0.4.tgz",
+      "integrity": "sha512-3vKuW0jV8J3XNTzvfyicFR5qvxrSAGl7KIhvgOu5cmWwM7tZRj3fMbj/pfIf4be7aznbc+prBWGjywox/g2Y6Q==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "dependencies": {
+        "node-addon-api": "^2.0.0",
+        "node-gyp-build": "^4.2.0",
+        "readable-stream": "^3.6.0"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/kind-of": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
+      "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/kleur": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz",
+      "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/levn": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/levn/-/levn-0.3.0.tgz",
+      "integrity": "sha512-0OO4y2iOHix2W6ujICbKIaEQXvFQHue65vUG3pb5EUomzPI90z9hsA1VsO/dbIIpC53J8gxM9Q4Oho0jrCM/yA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "prelude-ls": "~1.1.2",
+        "type-check": "~0.3.2"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/locate-path": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz",
+      "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "p-locate": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/lodash": {
+      "version": "4.17.21",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
+      "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lodash.camelcase": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/lodash.camelcase/-/lodash.camelcase-4.3.0.tgz",
+      "integrity": "sha512-TwuEnCnxbc3rAvhf/LbG7tJUDzhqXyFnv3dtzLOPgCG/hODL7WFnsbwktkD7yUV0RrreP/l1PALq/YSg6VvjlA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/lodash.clonedeep": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/lodash.clonedeep/-/lodash.clonedeep-4.5.0.tgz",
+      "integrity": "sha512-H5ZhCF25riFd9uB5UCkVKo61m3S/xZk1x4wA6yp/L3RFP6Z/eHH1ymQcGLo7J3GMPfm0V/7m1tryHuGVxpqEBQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/lodash.isequal": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/lodash.isequal/-/lodash.isequal-4.5.0.tgz",
+      "integrity": "sha512-pDo3lu8Jhfjqls6GkMgpahsF9kCyayhgykjyLMNFTKWrpVdAQtYyB4muAMWozBB4ig/dtWAmsMxLEI8wuz+DYQ==",
+      "deprecated": "This package is deprecated. Use require('node:util').isDeepStrictEqual instead.",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/lodash.truncate": {
+      "version": "4.4.2",
+      "resolved": "https://registry.npmjs.org/lodash.truncate/-/lodash.truncate-4.4.2.tgz",
+      "integrity": "sha512-jttmRe7bRse52OsWIMDLaXxWqRAmtIUccAQ3garviCqJjafXOfNMO0yMfNpdD6zbGaTU0P5Nz7e7gAT6cKmJRw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/log-symbols": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-4.1.0.tgz",
+      "integrity": "sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "chalk": "^4.1.0",
+        "is-unicode-supported": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/loupe": {
+      "version": "2.3.7",
+      "resolved": "https://registry.npmjs.org/loupe/-/loupe-2.3.7.tgz",
+      "integrity": "sha512-zSMINGVYkdpYSOBmLi0D1Uo7JU9nVdQKrHxC8eYlV+9YKK9WePqAlL7lSlorG/U2Fw1w0hTBmaa/jrQ3UbPHtA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "get-func-name": "^2.0.1"
+      }
+    },
+    "node_modules/lru_map": {
+      "version": "0.3.3",
+      "resolved": "https://registry.npmjs.org/lru_map/-/lru_map-0.3.3.tgz",
+      "integrity": "sha512-Pn9cox5CsMYngeDbmChANltQl+5pi6XmTrraMSzhPmMBbmgcxmqWry0U3PGapCU1yB4/LqCcom7qhHZiF/jGfQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lru-cache": {
+      "version": "10.4.3",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
+      "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/make-error": {
+      "version": "1.3.6",
+      "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz",
+      "integrity": "sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/markdown-table": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/markdown-table/-/markdown-table-2.0.0.tgz",
+      "integrity": "sha512-Ezda85ToJUBhM6WGaG6veasyym+Tbs3cMAw/ZhOPqXiYsr0jgocBV3j3nx+4lk47plLlIqjwuTm/ywVI+zjJ/A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "repeat-string": "^1.0.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/wooorm"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/md5.js": {
+      "version": "1.3.5",
+      "resolved": "https://registry.npmjs.org/md5.js/-/md5.js-1.3.5.tgz",
+      "integrity": "sha512-xitP+WxNPcTTOgnTJcrhM0xvdPepipPSf3I8EIpGKeFLjt3PlJLIDG3u8EX53ZIubkb+5U2+3rELYpEhHhzdkg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "hash-base": "^3.0.0",
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.1.2"
+      }
+    },
+    "node_modules/memorystream": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/memorystream/-/memorystream-0.3.1.tgz",
+      "integrity": "sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.10.0"
+      }
+    },
+    "node_modules/merge2": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
+      "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/micro-eth-signer": {
+      "version": "0.14.0",
+      "resolved": "https://registry.npmjs.org/micro-eth-signer/-/micro-eth-signer-0.14.0.tgz",
+      "integrity": "sha512-5PLLzHiVYPWClEvZIXXFu5yutzpadb73rnQCpUqIHu3No3coFuWQNfE5tkBQJ7djuLYl6aRLaS0MgWJYGoqiBw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@noble/curves": "~1.8.1",
+        "@noble/hashes": "~1.7.1",
+        "micro-packed": "~0.7.2"
+      }
+    },
+    "node_modules/micro-eth-signer/node_modules/@noble/curves": {
+      "version": "1.8.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.8.2.tgz",
+      "integrity": "sha512-vnI7V6lFNe0tLAuJMu+2sX+FcL14TaCWy1qiczg1VwRmPrpQCdq5ESXQMqUc2tluRNf6irBXrWbl1mGN8uaU/g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "1.7.2"
+      },
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/micro-eth-signer/node_modules/@noble/hashes": {
+      "version": "1.7.2",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.7.2.tgz",
+      "integrity": "sha512-biZ0NUSxyjLLqo6KxEJ1b+C2NAx0wtDoFvCaXHGgUkeHzf3Xc1xKumFKREuT7f7DARNZ/slvYUwFG6B0f2b6hQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/micro-ftch": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/micro-ftch/-/micro-ftch-0.3.1.tgz",
+      "integrity": "sha512-/0LLxhzP0tfiR5hcQebtudP56gUurs2CLkGarnCiB/OqEyUFQ6U3paQi/tgLv0hBJYt2rnr9MNpxz4fiiugstg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/micro-packed": {
+      "version": "0.7.3",
+      "resolved": "https://registry.npmjs.org/micro-packed/-/micro-packed-0.7.3.tgz",
+      "integrity": "sha512-2Milxs+WNC00TRlem41oRswvw31146GiSaoCT7s3Xi2gMUglW5QBeqlQaZeHr5tJx9nm3i57LNXPqxOOaWtTYg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/micro-packed/node_modules/@scure/base": {
+      "version": "1.2.6",
+      "resolved": "https://registry.npmjs.org/@scure/base/-/base-1.2.6.tgz",
+      "integrity": "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/micromatch": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
+      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "braces": "^3.0.3",
+        "picomatch": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=8.6"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/minimalistic-assert": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz",
+      "integrity": "sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/minimalistic-crypto-utils": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/minimalistic-crypto-utils/-/minimalistic-crypto-utils-1.0.1.tgz",
+      "integrity": "sha512-JIYlbt6g8i5jKfJ3xz7rF0LXmv2TkDxBLUkiBeZ7bAx4GnnNMr8xFpGnOxn6GhTEHx3SjRrZEoU+j04prX1ktg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/minimatch": {
+      "version": "9.0.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
+      "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/minimist": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/minipass": {
+      "version": "7.1.2",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.2.tgz",
+      "integrity": "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      }
+    },
+    "node_modules/mkdirp": {
+      "version": "0.5.6",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz",
+      "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "minimist": "^1.2.6"
+      },
+      "bin": {
+        "mkdirp": "bin/cmd.js"
+      }
+    },
+    "node_modules/mnemonist": {
+      "version": "0.38.5",
+      "resolved": "https://registry.npmjs.org/mnemonist/-/mnemonist-0.38.5.tgz",
+      "integrity": "sha512-bZTFT5rrPKtPJxj8KSV0WkPyNxl72vQepqqVUAW2ARUpUSF2qXMB6jZj7hW5/k7C1rtpzqbD/IIbJwLXUjCHeg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "obliterator": "^2.0.0"
+      }
+    },
+    "node_modules/mocha": {
+      "version": "10.8.2",
+      "resolved": "https://registry.npmjs.org/mocha/-/mocha-10.8.2.tgz",
+      "integrity": "sha512-VZlYo/WE8t1tstuRmqgeyBgCbJc/lEdopaa+axcKzTBJ+UIdlAB9XnmvTCAH4pwR4ElNInaedhEBmZD8iCSVEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-colors": "^4.1.3",
+        "browser-stdout": "^1.3.1",
+        "chokidar": "^3.5.3",
+        "debug": "^4.3.5",
+        "diff": "^5.2.0",
+        "escape-string-regexp": "^4.0.0",
+        "find-up": "^5.0.0",
+        "glob": "^8.1.0",
+        "he": "^1.2.0",
+        "js-yaml": "^4.1.0",
+        "log-symbols": "^4.1.0",
+        "minimatch": "^5.1.6",
+        "ms": "^2.1.3",
+        "serialize-javascript": "^6.0.2",
+        "strip-json-comments": "^3.1.1",
+        "supports-color": "^8.1.1",
+        "workerpool": "^6.5.1",
+        "yargs": "^16.2.0",
+        "yargs-parser": "^20.2.9",
+        "yargs-unparser": "^2.0.0"
+      },
+      "bin": {
+        "_mocha": "bin/_mocha",
+        "mocha": "bin/mocha.js"
+      },
+      "engines": {
+        "node": ">= 14.0.0"
+      }
+    },
+    "node_modules/mocha/node_modules/chokidar": {
+      "version": "3.6.0",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz",
+      "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "anymatch": "~3.1.2",
+        "braces": "~3.0.2",
+        "glob-parent": "~5.1.2",
+        "is-binary-path": "~2.1.0",
+        "is-glob": "~4.0.1",
+        "normalize-path": "~3.0.0",
+        "readdirp": "~3.6.0"
+      },
+      "engines": {
+        "node": ">= 8.10.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/mocha/node_modules/minimatch": {
+      "version": "5.1.6",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.6.tgz",
+      "integrity": "sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/mocha/node_modules/readdirp": {
+      "version": "3.6.0",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz",
+      "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "picomatch": "^2.2.1"
+      },
+      "engines": {
+        "node": ">=8.10.0"
+      }
+    },
+    "node_modules/mocha/node_modules/supports-color": {
+      "version": "8.1.1",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz",
+      "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/supports-color?sponsor=1"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/ndjson": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ndjson/-/ndjson-2.0.0.tgz",
+      "integrity": "sha512-nGl7LRGrzugTtaFcJMhLbpzJM6XdivmbkdlaGcrk/LXg2KL/YBC6z1g70xh0/al+oFuVFP8N8kiWRucmeEH/qQ==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "dependencies": {
+        "json-stringify-safe": "^5.0.1",
+        "minimist": "^1.2.5",
+        "readable-stream": "^3.6.0",
+        "split2": "^3.0.0",
+        "through2": "^4.0.0"
+      },
+      "bin": {
+        "ndjson": "cli.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/neo-async": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz",
+      "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/node-addon-api": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-2.0.2.tgz",
+      "integrity": "sha512-Ntyt4AIXyaLIuMHF6IOoTakB3K+RWxwtsHNRxllEoA6vPwP9o4866g6YWDLUdnucilZhmkxiHwHr11gAENw+QA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/node-emoji": {
+      "version": "1.11.0",
+      "resolved": "https://registry.npmjs.org/node-emoji/-/node-emoji-1.11.0.tgz",
+      "integrity": "sha512-wo2DpQkQp7Sjm2A0cq+sN7EHKO6Sl0ctXeBdFZrL9T9+UywORbufTcTZxom8YqpLQt/FqNMUkOpkZrJVYSKD3A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "lodash": "^4.17.21"
+      }
+    },
+    "node_modules/node-fetch": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz",
+      "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "whatwg-url": "^5.0.0"
+      },
+      "engines": {
+        "node": "4.x || >=6.0.0"
+      },
+      "peerDependencies": {
+        "encoding": "^0.1.0"
+      },
+      "peerDependenciesMeta": {
+        "encoding": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/node-gyp-build": {
+      "version": "4.8.4",
+      "resolved": "https://registry.npmjs.org/node-gyp-build/-/node-gyp-build-4.8.4.tgz",
+      "integrity": "sha512-LA4ZjwlnUblHVgq0oBF3Jl/6h/Nvs5fzBLwdEF4nuxnFdsfajde4WfxtJr3CaiH+F6ewcIB/q4jQ4UzPyid+CQ==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "node-gyp-build": "bin.js",
+        "node-gyp-build-optional": "optional.js",
+        "node-gyp-build-test": "build-test.js"
+      }
+    },
+    "node_modules/nofilter": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/nofilter/-/nofilter-3.1.0.tgz",
+      "integrity": "sha512-l2NNj07e9afPnhAhvgVrCD/oy2Ai1yfLpuo3EpiO1jFTsB4sFz6oIfAfSZyQzVpkZQ9xS8ZS5g1jCBgq4Hwo0g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12.19"
+      }
+    },
+    "node_modules/nopt": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/nopt/-/nopt-3.0.6.tgz",
+      "integrity": "sha512-4GUt3kSEYmk4ITxzB/b9vaIDfUVWN/Ml1Fwl11IlnIG2iaJ9O6WXZ9SrYM9NLI8OCBieN2Y8SWC2oJV0RQ7qYg==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "abbrev": "1"
+      },
+      "bin": {
+        "nopt": "bin/nopt.js"
+      }
+    },
+    "node_modules/normalize-path": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
+      "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/number-to-bn": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/number-to-bn/-/number-to-bn-1.7.0.tgz",
+      "integrity": "sha512-wsJ9gfSz1/s4ZsJN01lyonwuxA1tml6X1yBDnfpMglypcBRFZZkus26EdPSlqS5GJfYddVZa22p3VNb3z5m5Ig==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "bn.js": "4.11.6",
+        "strip-hex-prefix": "1.0.0"
+      },
+      "engines": {
+        "node": ">=6.5.0",
+        "npm": ">=3"
+      }
+    },
+    "node_modules/number-to-bn/node_modules/bn.js": {
+      "version": "4.11.6",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.11.6.tgz",
+      "integrity": "sha512-XWwnNNFCuuSQ0m3r3C4LE3EiORltHd9M05pq6FOlVeiophzRbMo50Sbz1ehl8K3Z+jw9+vmgnXefY1hz8X+2wA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/obliterator": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/obliterator/-/obliterator-2.0.5.tgz",
+      "integrity": "sha512-42CPE9AhahZRsMNslczq0ctAEtqk8Eka26QofnqC346BZdHDySk3LWka23LI7ULIw11NmltpiLagIq8gBozxTw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "wrappy": "1"
+      }
+    },
+    "node_modules/optionator": {
+      "version": "0.8.3",
+      "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.8.3.tgz",
+      "integrity": "sha512-+IW9pACdk3XWmmTXG8m3upGUJst5XRGzxMRjXzAuJ1XnIFNvfhjjIuYkDvysnPQ7qzqVzLt78BCruntqRhWQbA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "deep-is": "~0.1.3",
+        "fast-levenshtein": "~2.0.6",
+        "levn": "~0.3.0",
+        "prelude-ls": "~1.1.2",
+        "type-check": "~0.3.2",
+        "word-wrap": "~1.2.3"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/ordinal": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/ordinal/-/ordinal-1.0.3.tgz",
+      "integrity": "sha512-cMddMgb2QElm8G7vdaa02jhUNbTSrhsgAGUz1OokD83uJTwSUn+nKoNoKVVaRa08yF6sgfO7Maou1+bgLd9rdQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/os-tmpdir": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz",
+      "integrity": "sha512-D2FR03Vir7FIu45XBY20mTb+/ZSWB00sjU9jdQXt83gDrI4Ztz5Fs7/yy74g2N5SVQY4xY1qDr4rNddwYRVX0g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/ox": {
+      "version": "0.8.1",
+      "resolved": "https://registry.npmjs.org/ox/-/ox-0.8.1.tgz",
+      "integrity": "sha512-e+z5epnzV+Zuz91YYujecW8cF01mzmrUtWotJ0oEPym/G82uccs7q0WDHTYL3eiONbTUEvcZrptAKLgTBD3u2A==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/wevm"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@adraffy/ens-normalize": "^1.11.0",
+        "@noble/ciphers": "^1.3.0",
+        "@noble/curves": "^1.9.1",
+        "@noble/hashes": "^1.8.0",
+        "@scure/bip32": "^1.7.0",
+        "@scure/bip39": "^1.6.0",
+        "abitype": "^1.0.8",
+        "eventemitter3": "5.0.1"
+      },
+      "peerDependencies": {
+        "typescript": ">=5.4.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ox/node_modules/@adraffy/ens-normalize": {
+      "version": "1.11.0",
+      "resolved": "https://registry.npmjs.org/@adraffy/ens-normalize/-/ens-normalize-1.11.0.tgz",
+      "integrity": "sha512-/3DDPKHqqIqxUULp8yP4zODUY1i+2xvVWsv8A79xGWdCAG+8sb0hRh0Rk2QyOJUnnbyPUAZYcpBuRe3nS2OIUg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/ox/node_modules/@noble/curves": {
+      "version": "1.9.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.9.2.tgz",
+      "integrity": "sha512-HxngEd2XUcg9xi20JkwlLCtYwfoFw4JGkuZpT+WlsPD4gB/cxkvTD8fSsoAnphGZhFdZYKeQIPCuFlWPm1uE0g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.8.0"
+      },
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ox/node_modules/@noble/hashes": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz",
+      "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ox/node_modules/@scure/base": {
+      "version": "1.2.6",
+      "resolved": "https://registry.npmjs.org/@scure/base/-/base-1.2.6.tgz",
+      "integrity": "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ox/node_modules/@scure/bip32": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip32/-/bip32-1.7.0.tgz",
+      "integrity": "sha512-E4FFX/N3f4B80AKWp5dP6ow+flD1LQZo/w8UnLGYZO674jS6YnYeepycOOksv+vLPSpgN35wgKgy+ybfTb2SMw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "~1.9.0",
+        "@noble/hashes": "~1.8.0",
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ox/node_modules/@scure/bip39": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip39/-/bip39-1.6.0.tgz",
+      "integrity": "sha512-+lF0BbLiJNwVlev4eKelw1WWLaiKXw7sSl8T6FvBlWkdX+94aGJ4o8XjUdlyhTCjd8c+B3KT3JfS8P0bLRNU6A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "~1.8.0",
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/p-limit": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
+      "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "yocto-queue": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-locate": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz",
+      "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "p-limit": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-map": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/p-map/-/p-map-4.0.0.tgz",
+      "integrity": "sha512-/bjOqmgETBYB5BoEeGVea8dmvHb2m9GLy1E9W43yeyfP6QQCZGFNa+XRceJEuDB6zqr+gKpIAmlLebMpykw/MQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "aggregate-error": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/package-json-from-dist": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
+      "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "peer": true
+    },
+    "node_modules/path-exists": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
+      "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-is-absolute": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
+      "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-parse": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
+      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/path-scurry": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz",
+      "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "peer": true,
+      "dependencies": {
+        "lru-cache": "^10.2.0",
+        "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/path-type": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz",
+      "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/pathval": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/pathval/-/pathval-1.1.1.tgz",
+      "integrity": "sha512-Dp6zGqpTdETdR63lehJYPeIOqpiNBNtc7BpWSLrOje7UaIsE5aY92r/AunQA7rsXvet3lrJ3JnZX29UPTKXyKQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/pbkdf2": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/pbkdf2/-/pbkdf2-3.1.2.tgz",
+      "integrity": "sha512-iuh7L6jA7JEGu2WxDwtQP1ddOpaJNC4KlDEFfdQajSGgGPNi4OyDc2R7QnbY2bR9QjBVGwgvTdNJZoE7RaxUMA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "create-hash": "^1.1.2",
+        "create-hmac": "^1.1.4",
+        "ripemd160": "^2.0.1",
+        "safe-buffer": "^5.0.1",
+        "sha.js": "^2.4.8"
+      },
+      "engines": {
+        "node": ">=0.12"
+      }
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/picomatch": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
+      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/pify": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/pify/-/pify-4.0.1.tgz",
+      "integrity": "sha512-uB80kBFb/tfd68bVleG9T5GGsGPjJrLAUpR5PZIrhBnIaRTQRjqdJSsIKkOP6OAIFbj7GOrcudc5pNjZ+geV2g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/prelude-ls": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.1.2.tgz",
+      "integrity": "sha512-ESF23V4SKG6lVSGZgYNpbsiaAkdab6ZgOxe52p7+Kid3W3u3bxR4Vfd/o21dmN7jSt0IwgZ4v5MUd26FEtXE9w==",
+      "dev": true,
+      "peer": true,
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/prettier": {
+      "version": "2.8.8",
+      "resolved": "https://registry.npmjs.org/prettier/-/prettier-2.8.8.tgz",
+      "integrity": "sha512-tdN8qQGvNjw4CHbY+XXk0JgCXn9QiF21a55rBe5LJAU+kDyC4WQn4+awm2Xfk2lQMk5fKup9XgzTZtGkjBdP9Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "bin": {
+        "prettier": "bin-prettier.js"
+      },
+      "engines": {
+        "node": ">=10.13.0"
+      },
+      "funding": {
+        "url": "https://github.com/prettier/prettier?sponsor=1"
+      }
+    },
+    "node_modules/prompts": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz",
+      "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "kleur": "^3.0.3",
+        "sisteransi": "^1.0.5"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/proper-lockfile": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/proper-lockfile/-/proper-lockfile-4.1.2.tgz",
+      "integrity": "sha512-TjNPblN4BwAWMXU8s9AEz4JmQxnD1NNL7bNOY/AKUzyamc379FWASUhc/K1pL2noVb+XmZKLL68cjzLsiOAMaA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.2.4",
+        "retry": "^0.12.0",
+        "signal-exit": "^3.0.2"
+      }
+    },
+    "node_modules/proper-lockfile/node_modules/retry": {
+      "version": "0.12.0",
+      "resolved": "https://registry.npmjs.org/retry/-/retry-0.12.0.tgz",
+      "integrity": "sha512-9LkiTwjUh6rT555DtE9rTX+BKByPfrMzEAtnlEtdEwr3Nkffwiihqe2bWADg+OQRjt9gl6ICdmB/ZFDCGAtSow==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/proxy-from-env": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-1.1.0.tgz",
+      "integrity": "sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/queue-microtask": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
+      "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/randombytes": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz",
+      "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "^5.1.0"
+      }
+    },
+    "node_modules/raw-body": {
+      "version": "2.5.2",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz",
+      "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "3.1.2",
+        "http-errors": "2.0.0",
+        "iconv-lite": "0.4.24",
+        "unpipe": "1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/readable-stream": {
+      "version": "3.6.2",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "string_decoder": "^1.1.1",
+        "util-deprecate": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/readdirp": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.1.2.tgz",
+      "integrity": "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14.18.0"
+      },
+      "funding": {
+        "type": "individual",
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/rechoir": {
+      "version": "0.6.2",
+      "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.6.2.tgz",
+      "integrity": "sha512-HFM8rkZ+i3zrV+4LQjwQ0W+ez98pApMGM3HUrN04j3CqzPOzl9nmP15Y8YXNm8QHGv/eacOVEjqhmWpkRV0NAw==",
+      "dev": true,
+      "peer": true,
+      "dependencies": {
+        "resolve": "^1.1.6"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/recursive-readdir": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/recursive-readdir/-/recursive-readdir-2.2.3.tgz",
+      "integrity": "sha512-8HrF5ZsXk5FAH9dgsx3BlUer73nIhuj+9OrQwEbLTPOBzGkL1lsFCR01am+v+0m2Cmbs1nP12hLDl5FA7EszKA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "minimatch": "^3.0.5"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/recursive-readdir/node_modules/brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/recursive-readdir/node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/reduce-flatten": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/reduce-flatten/-/reduce-flatten-2.0.0.tgz",
+      "integrity": "sha512-EJ4UNY/U1t2P/2k6oqotuX2Cc3T6nxJwsM0N0asT7dhrtH1ltUxDn4NalSYmPE2rCkVpcf/X6R0wDwcFpzhd4w==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/repeat-string": {
+      "version": "1.6.1",
+      "resolved": "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz",
+      "integrity": "sha512-PV0dzCYDNfRi1jCDbJzpW7jNNDRuCOG/jI5ctQcGKt/clZD+YcPS3yIlWuTJMmESC8aevCFmWJy5wjAFgNqN6w==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
+    "node_modules/require-directory": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
+      "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/resolve": {
+      "version": "1.17.0",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.17.0.tgz",
+      "integrity": "sha512-ic+7JYiV8Vi2yzQGFWOkiZD5Z9z7O2Zhm9XMaTxdJExKasieFCr+yXZ/WmXsckHiKl12ar0y6XiXDx3m4RHn1w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-parse": "^1.0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/retry": {
+      "version": "0.13.1",
+      "resolved": "https://registry.npmjs.org/retry/-/retry-0.13.1.tgz",
+      "integrity": "sha512-XQBQ3I8W1Cge0Seh+6gjj03LbmRFWuoszgK9ooCpwYIrhhoO80pfq4cUkU5DkknwfOfFteRwlZ56PYOGYyFWdg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/reusify": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
+      "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "iojs": ">=1.0.0",
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/ripemd160": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/ripemd160/-/ripemd160-2.0.2.tgz",
+      "integrity": "sha512-ii4iagi25WusVoiC4B4lq7pbXfAp3D9v5CwfkY33vffw2+pkDjY1D8GaN7spsxvCSx8dkPqOZCEZyfxcmJG2IA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "hash-base": "^3.0.0",
+        "inherits": "^2.0.1"
+      }
+    },
+    "node_modules/rlp": {
+      "version": "2.2.7",
+      "resolved": "https://registry.npmjs.org/rlp/-/rlp-2.2.7.tgz",
+      "integrity": "sha512-d5gdPmgQ0Z+AklL2NVXr/IoSjNZFfTVvQWzL/AM2AOcSzYP2xjlb0AC8YyCLc41MSNf6P6QVtjgPdmVtzb+4lQ==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "dependencies": {
+        "bn.js": "^5.2.0"
+      },
+      "bin": {
+        "rlp": "bin/rlp"
+      }
+    },
+    "node_modules/run-parallel": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
+      "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "queue-microtask": "^1.2.2"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/sc-istanbul": {
+      "version": "0.4.6",
+      "resolved": "https://registry.npmjs.org/sc-istanbul/-/sc-istanbul-0.4.6.tgz",
+      "integrity": "sha512-qJFF/8tW/zJsbyfh/iT/ZM5QNHE3CXxtLJbZsL+CzdJLBsPD7SedJZoUA4d8iAcN2IoMp/Dx80shOOd2x96X/g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "dependencies": {
+        "abbrev": "1.0.x",
+        "async": "1.x",
+        "escodegen": "1.8.x",
+        "esprima": "2.7.x",
+        "glob": "^5.0.15",
+        "handlebars": "^4.0.1",
+        "js-yaml": "3.x",
+        "mkdirp": "0.5.x",
+        "nopt": "3.x",
+        "once": "1.x",
+        "resolve": "1.1.x",
+        "supports-color": "^3.1.0",
+        "which": "^1.1.1",
+        "wordwrap": "^1.0.0"
+      },
+      "bin": {
+        "istanbul": "lib/cli.js"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/argparse": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "sprintf-js": "~1.0.2"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/glob": {
+      "version": "5.0.15",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-5.0.15.tgz",
+      "integrity": "sha512-c9IPMazfRITpmAAKi22dK1VKxGDX9ehhqfABDriL/lzO92xcUKEJPQHrVA/2YHSNFB4iFlykVmWvwo48nr3OxA==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "2 || 3",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/has-flag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-1.0.0.tgz",
+      "integrity": "sha512-DyYHfIYwAJmjAjSSPKANxI8bFY9YtFrgkAfinBojQ8YJTOuOuav64tMUJv584SES4xl74PmuaevIyaLESHdTAA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/js-yaml": {
+      "version": "3.14.1",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz",
+      "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "argparse": "^1.0.7",
+        "esprima": "^4.0.0"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/js-yaml/node_modules/esprima": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
+      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "peer": true,
+      "bin": {
+        "esparse": "bin/esparse.js",
+        "esvalidate": "bin/esvalidate.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/resolve": {
+      "version": "1.1.7",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.1.7.tgz",
+      "integrity": "sha512-9znBF0vBcaSN3W2j7wKvdERPwqTxSpCq+if5C0WoTCyV9n24rua28jeuQ2pL/HOf+yUe/Mef+H/5p60K0Id3bg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/sc-istanbul/node_modules/supports-color": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+      "integrity": "sha512-Jds2VIYDrlp5ui7t8abHN2bjAu4LV/q4N2KivFPpGH0lrka0BMq/33AmECUXlKPcHigkNaqfXRENFju+rlcy+A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "has-flag": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/scrypt-js": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/scrypt-js/-/scrypt-js-3.0.1.tgz",
+      "integrity": "sha512-cdwTTnqPu0Hyvf5in5asVdZocVDTNRmR7XEcJuIzMjJeSHybHl7vpB66AzwTaIg6CLSbtjcxc8fqcySfnTkccA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/secp256k1": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/secp256k1/-/secp256k1-4.0.4.tgz",
+      "integrity": "sha512-6JfvwvjUOn8F/jUoBY2Q1v5WY5XS+rj8qSe0v8Y4ezH4InLgTEeOOPQsRll9OV429Pvo6BCHGavIyJfr3TAhsw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "dependencies": {
+        "elliptic": "^6.5.7",
+        "node-addon-api": "^5.0.0",
+        "node-gyp-build": "^4.2.0"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/secp256k1/node_modules/bn.js": {
+      "version": "4.12.1",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+      "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/secp256k1/node_modules/elliptic": {
+      "version": "6.6.1",
+      "resolved": "https://registry.npmjs.org/elliptic/-/elliptic-6.6.1.tgz",
+      "integrity": "sha512-RaddvvMatK2LJHqFJ+YA4WysVN5Ita9E35botqIYspQ4TkRAlCicdzKOjlyv/1Za5RyTNn7di//eEV0uTAfe3g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bn.js": "^4.11.9",
+        "brorand": "^1.1.0",
+        "hash.js": "^1.0.0",
+        "hmac-drbg": "^1.0.1",
+        "inherits": "^2.0.4",
+        "minimalistic-assert": "^1.0.1",
+        "minimalistic-crypto-utils": "^1.0.1"
+      }
+    },
+    "node_modules/secp256k1/node_modules/node-addon-api": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-5.1.0.tgz",
+      "integrity": "sha512-eh0GgfEkpnoWDq+VY8OyvYhFEzBk6jIYbRKdIlyTiAXIVJ8PyBaKb0rp7oDtoddbdoHWhq8wwr+XZ81F1rpNdA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/serialize-javascript": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-6.0.2.tgz",
+      "integrity": "sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "randombytes": "^2.1.0"
+      }
+    },
+    "node_modules/setimmediate": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
+      "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/sha.js": {
+      "version": "2.4.11",
+      "resolved": "https://registry.npmjs.org/sha.js/-/sha.js-2.4.11.tgz",
+      "integrity": "sha512-QMEp5B7cftE7APOjk5Y6xgrbWu+WkLVQwk8JNjZ8nKRciZaByEW6MubieAiToS7+dwvrjGhH8jRXz3MVd0AYqQ==",
+      "dev": true,
+      "license": "(MIT AND BSD-3-Clause)",
+      "dependencies": {
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.0.1"
+      },
+      "bin": {
+        "sha.js": "bin.js"
+      }
+    },
+    "node_modules/sha1": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/sha1/-/sha1-1.1.1.tgz",
+      "integrity": "sha512-dZBS6OrMjtgVkopB1Gmo4RQCDKiZsqcpAQpkV/aaj+FCrCg8r4I4qMkDPQjBgLIxlmu9k4nUbWq6ohXahOneYA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "dependencies": {
+        "charenc": ">= 0.0.1",
+        "crypt": ">= 0.0.1"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shelljs": {
+      "version": "0.8.5",
+      "resolved": "https://registry.npmjs.org/shelljs/-/shelljs-0.8.5.tgz",
+      "integrity": "sha512-TiwcRcrkhHvbrZbnRcFYMLl30Dfov3HKqzp5tO5b4pt6G/SezKcYhmDg15zXVBswHmctSAQKznqNW2LO5tTDow==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "dependencies": {
+        "glob": "^7.0.0",
+        "interpret": "^1.0.0",
+        "rechoir": "^0.6.2"
+      },
+      "bin": {
+        "shjs": "bin/shjs"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/shelljs/node_modules/brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/shelljs/node_modules/glob": {
+      "version": "7.2.3",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
+      "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^3.1.1",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/shelljs/node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/signal-exit": {
+      "version": "3.0.7",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz",
+      "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/sisteransi": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz",
+      "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/slash": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz",
+      "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/slice-ansi": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-4.0.0.tgz",
+      "integrity": "sha512-qMCMfhY040cVHT43K9BFygqYbUPFZKHOg7K73mtTWJRb8pyP3fzf4Ixd5SzdEJQ6MRUg/WBnOLxghZtKKurENQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "astral-regex": "^2.0.0",
+        "is-fullwidth-code-point": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/slice-ansi?sponsor=1"
+      }
+    },
+    "node_modules/solc": {
+      "version": "0.8.26",
+      "resolved": "https://registry.npmjs.org/solc/-/solc-0.8.26.tgz",
+      "integrity": "sha512-yiPQNVf5rBFHwN6SIf3TUUvVAFKcQqmSUFeq+fb6pNRCo0ZCgpYOZDi3BVoezCPIAcKrVYd/qXlBLUP9wVrZ9g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "command-exists": "^1.2.8",
+        "commander": "^8.1.0",
+        "follow-redirects": "^1.12.1",
+        "js-sha3": "0.8.0",
+        "memorystream": "^0.3.1",
+        "semver": "^5.5.0",
+        "tmp": "0.0.33"
+      },
+      "bin": {
+        "solcjs": "solc.js"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/solc/node_modules/semver": {
+      "version": "5.7.2",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz",
+      "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver"
+      }
+    },
+    "node_modules/solidity-ast": {
+      "version": "0.4.59",
+      "resolved": "https://registry.npmjs.org/solidity-ast/-/solidity-ast-0.4.59.tgz",
+      "integrity": "sha512-I+CX0wrYUN9jDfYtcgWSe+OAowaXy8/1YQy7NS4ni5IBDmIYBq7ZzaP/7QqouLjzZapmQtvGLqCaYgoUWqBo5g==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/solidity-coverage": {
+      "version": "0.8.14",
+      "resolved": "https://registry.npmjs.org/solidity-coverage/-/solidity-coverage-0.8.14.tgz",
+      "integrity": "sha512-ItAAObe5GaEOp20kXC2BZRnph+9P7Rtoqg2mQc2SXGEHgSDF2wWd1Wxz3ntzQWXkbCtIIGdJT918HG00cObwbA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/abi": "^5.0.9",
+        "@solidity-parser/parser": "^0.19.0",
+        "chalk": "^2.4.2",
+        "death": "^1.1.0",
+        "difflib": "^0.2.4",
+        "fs-extra": "^8.1.0",
+        "ghost-testrpc": "^0.0.2",
+        "global-modules": "^2.0.0",
+        "globby": "^10.0.1",
+        "jsonschema": "^1.2.4",
+        "lodash": "^4.17.21",
+        "mocha": "^10.2.0",
+        "node-emoji": "^1.10.0",
+        "pify": "^4.0.1",
+        "recursive-readdir": "^2.2.2",
+        "sc-istanbul": "^0.4.5",
+        "semver": "^7.3.4",
+        "shelljs": "^0.8.3",
+        "web3-utils": "^1.3.6"
+      },
+      "bin": {
+        "solidity-coverage": "plugins/bin.js"
+      },
+      "peerDependencies": {
+        "hardhat": "^2.11.0"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/@solidity-parser/parser": {
+      "version": "0.19.0",
+      "resolved": "https://registry.npmjs.org/@solidity-parser/parser/-/parser-0.19.0.tgz",
+      "integrity": "sha512-RV16k/qIxW/wWc+mLzV3ARyKUaMUTBy9tOLMzFhtNSKYeTAanQ3a5MudJKf/8arIFnA2L27SNjarQKmFg0w/jA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/solidity-coverage/node_modules/ansi-styles": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+      "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-convert": "^1.9.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/chalk": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
+      "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^3.2.1",
+        "escape-string-regexp": "^1.0.5",
+        "supports-color": "^5.3.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/color-convert": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
+      "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-name": "1.1.3"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/color-name": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
+      "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/solidity-coverage/node_modules/escape-string-regexp": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
+      "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/fs-extra": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-8.1.0.tgz",
+      "integrity": "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^4.0.0",
+        "universalify": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=6 <7 || >=8"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/has-flag": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+      "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/jsonfile": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
+      "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/semver": {
+      "version": "7.7.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz",
+      "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/supports-color": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
+      "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "has-flag": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/universalify": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
+      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/source-map": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.2.0.tgz",
+      "integrity": "sha512-CBdZ2oa/BHhS4xj5DlhjWNHcan57/5YuvfdLf17iVmIpd9KRm+DFLmC6nBNj+6Ua7Kt3TmOjDpQT1aTYOQtoUA==",
+      "dev": true,
+      "optional": true,
+      "peer": true,
+      "dependencies": {
+        "amdefine": ">=0.0.4"
+      },
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/source-map-support": {
+      "version": "0.5.21",
+      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz",
+      "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "source-map": "^0.6.0"
+      }
+    },
+    "node_modules/source-map-support/node_modules/source-map": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/split2": {
+      "version": "3.2.2",
+      "resolved": "https://registry.npmjs.org/split2/-/split2-3.2.2.tgz",
+      "integrity": "sha512-9NThjpgZnifTkJpzTZ7Eue85S49QwpNhZTq6GRJwObb6jnLFNGB7Qm73V5HewTROPyxD0C29xqmaI68bQtV+hg==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "readable-stream": "^3.0.0"
+      }
+    },
+    "node_modules/sprintf-js": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
+      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true
+    },
+    "node_modules/stacktrace-parser": {
+      "version": "0.1.11",
+      "resolved": "https://registry.npmjs.org/stacktrace-parser/-/stacktrace-parser-0.1.11.tgz",
+      "integrity": "sha512-WjlahMgHmCJpqzU8bIBy4qtsZdU9lRlcZE3Lvyej6t4tuOuv1vk57OW3MBrj6hXBFx/nNoC9MPMTcr5YA7NQbg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "type-fest": "^0.7.1"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/stacktrace-parser/node_modules/type-fest": {
+      "version": "0.7.1",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.7.1.tgz",
+      "integrity": "sha512-Ne2YiiGN8bmrmJJEuTWTLJR32nh/JdL1+PSicowtNb0WFpn59GK8/lfD61bVtzguz7b3PBt74nxpv/Pw5po5Rg==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/statuses": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz",
+      "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
+    "node_modules/string-format": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/string-format/-/string-format-2.0.0.tgz",
+      "integrity": "sha512-bbEs3scLeYNXLecRRuk6uJxdXUSj6le/8rNPHChIJTn2V79aXVTR1EH2OH5zLKKoz0V02fOUKZZcw01pLUShZA==",
+      "dev": true,
+      "license": "WTFPL OR MIT",
+      "peer": true
+    },
+    "node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/string-width-cjs": {
+      "name": "string-width",
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi-cjs": {
+      "name": "strip-ansi",
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-hex-prefix": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/strip-hex-prefix/-/strip-hex-prefix-1.0.0.tgz",
+      "integrity": "sha512-q8d4ue7JGEiVcypji1bALTos+0pWtyGlivAWyPuTkHzuTCJqrK9sWxYQZUq6Nq3cuyv3bm734IhHvHtGGURU6A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "is-hex-prefixed": "1.0.0"
+      },
+      "engines": {
+        "node": ">=6.5.0",
+        "npm": ">=3"
+      }
+    },
+    "node_modules/strip-json-comments": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz",
+      "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/strnum": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/strnum/-/strnum-1.1.1.tgz",
+      "integrity": "sha512-O7aCHfYCamLCctjAiaucmE+fHf2DYHkus2OKCn4Wv03sykfFtgeECn505X6K4mPl8CRNd/qurC9guq+ynoN4pw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/NaturalIntelligence"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/supports-color": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/table": {
+      "version": "6.9.0",
+      "resolved": "https://registry.npmjs.org/table/-/table-6.9.0.tgz",
+      "integrity": "sha512-9kY+CygyYM6j02t5YFHbNz2FN5QmYGv9zAjVp4lCDjlCw7amdckXlEt/bjMhUIfj4ThGRE4gCUH5+yGnNuPo5A==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "dependencies": {
+        "ajv": "^8.0.1",
+        "lodash.truncate": "^4.4.2",
+        "slice-ansi": "^4.0.0",
+        "string-width": "^4.2.3",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/table-layout": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/table-layout/-/table-layout-1.0.2.tgz",
+      "integrity": "sha512-qd/R7n5rQTRFi+Zf2sk5XVVd9UQl6ZkduPFC3S7WEGJAmetDTjY3qPN50eSKzwuzEyQKy5TN2TiZdkIjos2L6A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "array-back": "^4.0.1",
+        "deep-extend": "~0.6.0",
+        "typical": "^5.2.0",
+        "wordwrapjs": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/table-layout/node_modules/array-back": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/array-back/-/array-back-4.0.2.tgz",
+      "integrity": "sha512-NbdMezxqf94cnNfWLL7V/im0Ub+Anbb0IoZhvzie8+4HJ4nMQuzHuy49FkGYCJK2yAloZ3meiB6AVMClbrI1vg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/table-layout/node_modules/typical": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/typical/-/typical-5.2.0.tgz",
+      "integrity": "sha512-dvdQgNDNJo+8B2uBQoqdb11eUCE1JQXhvjC/CZtgvZseVd5TYMXnq0+vuUemXbd/Se29cTaUuPX3YIc2xgbvIg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/through2": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/through2/-/through2-4.0.2.tgz",
+      "integrity": "sha512-iOqSav00cVxEEICeD7TjLB1sueEL+81Wpzp2bY17uZjZN0pWZPuo4suZ/61VujxmqSGFfgOcNuTZ85QJwNZQpw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "readable-stream": "3"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.12",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.12.tgz",
+      "integrity": "sha512-qkf4trmKSIiMTs/E63cxH+ojC2unam7rJ0WrauAzpT3ECNTxGRMlaXxVbfxMUC/w0LaYk6jQ4y/nGR9uBO3tww==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.4.3",
+        "picomatch": "^4.0.2"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/tinyglobby/node_modules/fdir": {
+      "version": "6.4.3",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.4.3.tgz",
+      "integrity": "sha512-PMXmW2y1hDDfTSRc9gaXIuCCRpuoz3Kaz8cUelp3smouvfT632ozg2vrT6lJsHKKOF59YLbOGfAWGUcKEfRMQw==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/tinyglobby/node_modules/picomatch": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.2.tgz",
+      "integrity": "sha512-M7BAV6Rlcy5u+m6oPhAPFgJTzAioX/6B0DxyvDlo9l8+T3nLKbrczg2WLUyzd45L8RqfUMyGPzekbMvX2Ldkwg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/tmp": {
+      "version": "0.0.33",
+      "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.0.33.tgz",
+      "integrity": "sha512-jRCJlojKnZ3addtTOjdIqoRuPEKBvNXcGYqzO6zWZX8KfKEpnGY5jfggJQ3EjKuu8D4bJRr0y+cYJFmYbImXGw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "os-tmpdir": "~1.0.2"
+      },
+      "engines": {
+        "node": ">=0.6.0"
+      }
+    },
+    "node_modules/to-regex-range": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
+      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-number": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=8.0"
+      }
+    },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
+    "node_modules/tr46": {
+      "version": "0.0.3",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz",
+      "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/ts-command-line-args": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/ts-command-line-args/-/ts-command-line-args-2.5.1.tgz",
+      "integrity": "sha512-H69ZwTw3rFHb5WYpQya40YAX2/w7Ut75uUECbgBIsLmM+BNuYnxsltfyyLMxy6sEeKxgijLTnQtLd0nKd6+IYw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "chalk": "^4.1.0",
+        "command-line-args": "^5.1.1",
+        "command-line-usage": "^6.1.0",
+        "string-format": "^2.0.0"
+      },
+      "bin": {
+        "write-markdown": "dist/write-markdown.js"
+      }
+    },
+    "node_modules/ts-essentials": {
+      "version": "7.0.3",
+      "resolved": "https://registry.npmjs.org/ts-essentials/-/ts-essentials-7.0.3.tgz",
+      "integrity": "sha512-8+gr5+lqO3G84KdiTSMRLtuyJ+nTBVRKuCrK4lidMPdVeEp0uqC875uE5NMcaA7YYMN7XsNiFQuMvasF8HT/xQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "peerDependencies": {
+        "typescript": ">=3.7.0"
+      }
+    },
+    "node_modules/ts-node": {
+      "version": "10.9.2",
+      "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-10.9.2.tgz",
+      "integrity": "sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@cspotcode/source-map-support": "^0.8.0",
+        "@tsconfig/node10": "^1.0.7",
+        "@tsconfig/node12": "^1.0.7",
+        "@tsconfig/node14": "^1.0.0",
+        "@tsconfig/node16": "^1.0.2",
+        "acorn": "^8.4.1",
+        "acorn-walk": "^8.1.1",
+        "arg": "^4.1.0",
+        "create-require": "^1.1.0",
+        "diff": "^4.0.1",
+        "make-error": "^1.1.1",
+        "v8-compile-cache-lib": "^3.0.1",
+        "yn": "3.1.1"
+      },
+      "bin": {
+        "ts-node": "dist/bin.js",
+        "ts-node-cwd": "dist/bin-cwd.js",
+        "ts-node-esm": "dist/bin-esm.js",
+        "ts-node-script": "dist/bin-script.js",
+        "ts-node-transpile-only": "dist/bin-transpile.js",
+        "ts-script": "dist/bin-script-deprecated.js"
+      },
+      "peerDependencies": {
+        "@swc/core": ">=1.2.50",
+        "@swc/wasm": ">=1.2.50",
+        "@types/node": "*",
+        "typescript": ">=2.7"
+      },
+      "peerDependenciesMeta": {
+        "@swc/core": {
+          "optional": true
+        },
+        "@swc/wasm": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ts-node/node_modules/diff": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz",
+      "integrity": "sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "engines": {
+        "node": ">=0.3.1"
+      }
+    },
+    "node_modules/tslib": {
+      "version": "2.8.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
+      "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/tsort": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/tsort/-/tsort-0.0.1.tgz",
+      "integrity": "sha512-Tyrf5mxF8Ofs1tNoxA13lFeZ2Zrbd6cKbuH3V+MQ5sb6DtBj5FjrXVsRWT8YvNAQTqNoz66dz1WsbigI22aEnw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/type-check": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.3.2.tgz",
+      "integrity": "sha512-ZCmOJdvOWDBYJlzAoFkC+Q0+bUyEOS1ltgp1MGU03fqHG+dbi9tBFU2Rd9QKiDZFAYrhPh2JUf7rZRIuHRKtOg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "prelude-ls": "~1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/type-detect": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.1.0.tgz",
+      "integrity": "sha512-Acylog8/luQ8L7il+geoSxhEkazvkslg7PSNKOX59mbB9cOveP5aq9h74Y7YU8yDpJwetzQQrfIwtf4Wp4LKcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/type-fest": {
+      "version": "0.21.3",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.21.3.tgz",
+      "integrity": "sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/typechain": {
+      "version": "8.3.2",
+      "resolved": "https://registry.npmjs.org/typechain/-/typechain-8.3.2.tgz",
+      "integrity": "sha512-x/sQYr5w9K7yv3es7jo4KTX05CLxOf7TRWwoHlrjRh8H82G64g+k7VuWPJlgMo6qrjfCulOdfBjiaDtmhFYD/Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/prettier": "^2.1.1",
+        "debug": "^4.3.1",
+        "fs-extra": "^7.0.0",
+        "glob": "7.1.7",
+        "js-sha3": "^0.8.0",
+        "lodash": "^4.17.15",
+        "mkdirp": "^1.0.4",
+        "prettier": "^2.3.1",
+        "ts-command-line-args": "^2.2.0",
+        "ts-essentials": "^7.0.1"
+      },
+      "bin": {
+        "typechain": "dist/cli/cli.js"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.3.0"
+      }
+    },
+    "node_modules/typechain/node_modules/brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/typechain/node_modules/fs-extra": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-7.0.1.tgz",
+      "integrity": "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "graceful-fs": "^4.1.2",
+        "jsonfile": "^4.0.0",
+        "universalify": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=6 <7 || >=8"
+      }
+    },
+    "node_modules/typechain/node_modules/glob": {
+      "version": "7.1.7",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.7.tgz",
+      "integrity": "sha512-OvD9ENzPLbegENnYP5UUfJIirTg4+XwMWGaQfQTY0JenxNvvIKP3U3/tAQSPIu/lHxXYSZmpXlUHeqAIdKzBLQ==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^3.0.4",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/typechain/node_modules/jsonfile": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
+      "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/typechain/node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/typechain/node_modules/mkdirp": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-1.0.4.tgz",
+      "integrity": "sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "bin": {
+        "mkdirp": "bin/cmd.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/typechain/node_modules/universalify": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
+      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.7.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.7.3.tgz",
+      "integrity": "sha512-84MVSjMEHP+FQRPy3pX9sTVV/INIex71s9TL2Gm5FG/WG1SqXeKyZ0k7/blY/4FdOzI12CBy1vGc4og/eus0fw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "peer": true,
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/typical": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/typical/-/typical-4.0.0.tgz",
+      "integrity": "sha512-VAH4IvQ7BDFYglMd7BPRDfLgxZZX4O4TFcRDA6EN5X7erNJJq+McIEp8np9aVtxrCJ6qx4GTYVfOWNjcqwZgRw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/uglify-js": {
+      "version": "3.19.3",
+      "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz",
+      "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "optional": true,
+      "peer": true,
+      "bin": {
+        "uglifyjs": "bin/uglifyjs"
+      },
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/undici": {
+      "version": "5.28.5",
+      "resolved": "https://registry.npmjs.org/undici/-/undici-5.28.5.tgz",
+      "integrity": "sha512-zICwjrDrcrUE0pyyJc1I2QzBkLM8FINsgOrt6WjA+BgajVq9Nxu2PbFFXUrAggLfDXlZGZBVZYw7WNV5KiBiBA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@fastify/busboy": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=14.0"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.20.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.20.0.tgz",
+      "integrity": "sha512-Ny6QZ2Nju20vw1SRHe3d9jVu6gJ+4e3+MMpqu7pqE5HT6WsTSlce++GQmK5UXS8mzV8DSYHrQH+Xrf2jVcuKNg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/unfetch": {
+      "version": "4.2.0",
+      "resolved": "https://registry.npmjs.org/unfetch/-/unfetch-4.2.0.tgz",
+      "integrity": "sha512-F9p7yYCn6cIW9El1zi0HI6vqpeIvBsr3dSuRO6Xuppb1u5rXpCPmMvLSyECLhybr9isec8Ohl0hPekMVrEinDA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/universalify": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
+      "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 10.0.0"
+      }
+    },
+    "node_modules/unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/utf8": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/utf8/-/utf8-3.0.0.tgz",
+      "integrity": "sha512-E8VjFIQ/TyQgp+TZfS6l8yp/xWppSAHzidGiRrqe4bK4XP9pTRyKFgGJpO3SN7zdX4DeomTrwaseCHovfpFcqQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/uuid": {
+      "version": "9.0.1",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-9.0.1.tgz",
+      "integrity": "sha512-b+1eJOlsR9K8HJpow9Ok3fiWOWSIcIzXodvv0rQjVoOVNpWMpxf1wZNpt4y9h10odCNrqnYp1OBzRktckBe3sA==",
+      "dev": true,
+      "funding": [
+        "https://github.com/sponsors/broofa",
+        "https://github.com/sponsors/ctavan"
+      ],
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist/bin/uuid"
+      }
+    },
+    "node_modules/v8-compile-cache-lib": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz",
+      "integrity": "sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/viem": {
+      "version": "2.31.4",
+      "resolved": "https://registry.npmjs.org/viem/-/viem-2.31.4.tgz",
+      "integrity": "sha512-0UZ/asvzl6p44CIBRDbwEcn3HXIQQurBZcMo5qmLhQ8s27Ockk+RYohgTLlpLvkYs8/t4UUEREAbHLuek1kXcw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/wevm"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "1.9.2",
+        "@noble/hashes": "1.8.0",
+        "@scure/bip32": "1.7.0",
+        "@scure/bip39": "1.6.0",
+        "abitype": "1.0.8",
+        "isows": "1.0.7",
+        "ox": "0.8.1",
+        "ws": "8.18.2"
+      },
+      "peerDependencies": {
+        "typescript": ">=5.0.4"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/viem/node_modules/@noble/curves": {
+      "version": "1.9.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.9.2.tgz",
+      "integrity": "sha512-HxngEd2XUcg9xi20JkwlLCtYwfoFw4JGkuZpT+WlsPD4gB/cxkvTD8fSsoAnphGZhFdZYKeQIPCuFlWPm1uE0g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.8.0"
+      },
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/viem/node_modules/@noble/hashes": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz",
+      "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/viem/node_modules/@scure/base": {
+      "version": "1.2.6",
+      "resolved": "https://registry.npmjs.org/@scure/base/-/base-1.2.6.tgz",
+      "integrity": "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/viem/node_modules/@scure/bip32": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip32/-/bip32-1.7.0.tgz",
+      "integrity": "sha512-E4FFX/N3f4B80AKWp5dP6ow+flD1LQZo/w8UnLGYZO674jS6YnYeepycOOksv+vLPSpgN35wgKgy+ybfTb2SMw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "~1.9.0",
+        "@noble/hashes": "~1.8.0",
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/viem/node_modules/@scure/bip39": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip39/-/bip39-1.6.0.tgz",
+      "integrity": "sha512-+lF0BbLiJNwVlev4eKelw1WWLaiKXw7sSl8T6FvBlWkdX+94aGJ4o8XjUdlyhTCjd8c+B3KT3JfS8P0bLRNU6A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "~1.8.0",
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/viem/node_modules/ws": {
+      "version": "8.18.2",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.2.tgz",
+      "integrity": "sha512-DMricUmwGZUVr++AEAe2uiVM7UoO9MAVZMDu05UQOaUII0lp+zOzLLU4Xqh/JvTqklB1T4uELaaPBKyjE1r4fQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/web3-utils": {
+      "version": "1.10.4",
+      "resolved": "https://registry.npmjs.org/web3-utils/-/web3-utils-1.10.4.tgz",
+      "integrity": "sha512-tsu8FiKJLk2PzhDl9fXbGUWTkkVXYhtTA+SmEFkKft+9BgwLxfCRpU96sWv7ICC8zixBNd3JURVoiR3dUXgP8A==",
+      "dev": true,
+      "license": "LGPL-3.0",
+      "peer": true,
+      "dependencies": {
+        "@ethereumjs/util": "^8.1.0",
+        "bn.js": "^5.2.1",
+        "ethereum-bloom-filters": "^1.0.6",
+        "ethereum-cryptography": "^2.1.2",
+        "ethjs-unit": "0.1.6",
+        "number-to-bn": "1.7.0",
+        "randombytes": "^2.1.0",
+        "utf8": "3.0.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/web3-utils/node_modules/@noble/curves": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.4.2.tgz",
+      "integrity": "sha512-TavHr8qycMChk8UwMld0ZDRvatedkzWfH8IiaeGCfymOP5i0hSCozz9vHOL0nkwk7HRMlFnAiKpS2jrUmSybcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.4.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/web3-utils/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/web3-utils/node_modules/ethereum-cryptography": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-2.2.1.tgz",
+      "integrity": "sha512-r/W8lkHSiTLxUxW8Rf3u4HGB0xQweG2RyETjywylKZSzLWoWAijRz8WCuOtJ6wah+avllXBqZuk29HCCvhEIRg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "1.4.2",
+        "@noble/hashes": "1.4.0",
+        "@scure/bip32": "1.4.0",
+        "@scure/bip39": "1.3.0"
+      }
+    },
+    "node_modules/webidl-conversions": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
+      "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==",
+      "dev": true,
+      "license": "BSD-2-Clause"
+    },
+    "node_modules/whatwg-url": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz",
+      "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tr46": "~0.0.3",
+        "webidl-conversions": "^3.0.0"
+      }
+    },
+    "node_modules/which": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/which/-/which-1.3.1.tgz",
+      "integrity": "sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "which": "bin/which"
+      }
+    },
+    "node_modules/widest-line": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/widest-line/-/widest-line-3.1.0.tgz",
+      "integrity": "sha512-NsmoXalsWVDMGupxZ5R08ka9flZjjiLvHVAWYOKtiKM8ujtZWr9cRffak+uSE48+Ob8ObalXpwyeUiyDD6QFgg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "string-width": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/word-wrap": {
+      "version": "1.2.5",
+      "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz",
+      "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/wordwrap": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz",
+      "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/wordwrapjs": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/wordwrapjs/-/wordwrapjs-4.0.1.tgz",
+      "integrity": "sha512-kKlNACbvHrkpIw6oPeYDSmdCTu2hdMHoyXLTcUKala++lx5Y+wjJ/e474Jqv5abnVmwxw08DiTuHmw69lJGksA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "reduce-flatten": "^2.0.0",
+        "typical": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/wordwrapjs/node_modules/typical": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/typical/-/typical-5.2.0.tgz",
+      "integrity": "sha512-dvdQgNDNJo+8B2uBQoqdb11eUCE1JQXhvjC/CZtgvZseVd5TYMXnq0+vuUemXbd/Se29cTaUuPX3YIc2xgbvIg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/workerpool": {
+      "version": "6.5.1",
+      "resolved": "https://registry.npmjs.org/workerpool/-/workerpool-6.5.1.tgz",
+      "integrity": "sha512-Fs4dNYcsdpYSAfVxhnl1L5zTksjvOJxtC5hzMNl+1t9B8hTJTdKDyZ5ju7ztgPy+ft9tBFXoOlDNiOT9WUXZlA==",
+      "dev": true,
+      "license": "Apache-2.0"
+    },
+    "node_modules/wrap-ansi": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs": {
+      "name": "wrap-ansi",
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/ws": {
+      "version": "8.17.1",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.17.1.tgz",
+      "integrity": "sha512-6XQFvXTkbfUOZOKKILFG1PDK2NDQs4azKQl26T0YS5CxqWLgXajbPZ+h4gZekJyRqFU8pvnbAbbs/3TgRPy+GQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/y18n": {
+      "version": "5.0.8",
+      "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
+      "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yargs": {
+      "version": "16.2.0",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-16.2.0.tgz",
+      "integrity": "sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cliui": "^7.0.2",
+        "escalade": "^3.1.1",
+        "get-caller-file": "^2.0.5",
+        "require-directory": "^2.1.1",
+        "string-width": "^4.2.0",
+        "y18n": "^5.0.5",
+        "yargs-parser": "^20.2.2"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yargs-parser": {
+      "version": "20.2.9",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-20.2.9.tgz",
+      "integrity": "sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yargs-unparser": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/yargs-unparser/-/yargs-unparser-2.0.0.tgz",
+      "integrity": "sha512-7pRTIA9Qc1caZ0bZ6RYRGbHJthJWuakf+WmHK0rVeLkNrrGhfoabBNdue6kdINI6r4if7ocq9aD/n7xwKOdzOA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "camelcase": "^6.0.0",
+        "decamelize": "^4.0.0",
+        "flat": "^5.0.2",
+        "is-plain-obj": "^2.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yn": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz",
+      "integrity": "sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/yocto-queue": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
+      "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    }
+  }
+}
diff --git a/packages/core/solidity/src/environments/hardhat/optimism-upgradeable/package.json b/packages/core/solidity/src/environments/hardhat/optimism-upgradeable/package.json
new file mode 100644
index 000000000..992bfac6c
--- /dev/null
+++ b/packages/core/solidity/src/environments/hardhat/optimism-upgradeable/package.json
@@ -0,0 +1,19 @@
+{
+  "name": "hardhat-sample",
+  "version": "0.0.1",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "hardhat test"
+  },
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@openzeppelin/contracts": "^5.0.0",
+    "@openzeppelin/contracts-upgradeable": "^5.0.0",
+    "@openzeppelin/hardhat-upgrades": "^3.0.0",
+    "@eth-optimism/contracts-bedrock": "^0.17.3",
+    "@nomicfoundation/hardhat-toolbox": "^6.0.0",
+    "hardhat": "^2.16.1"
+  }
+}
\ No newline at end of file
diff --git a/packages/core/solidity/src/environments/hardhat/optimism/package-lock.json b/packages/core/solidity/src/environments/hardhat/optimism/package-lock.json
new file mode 100644
index 000000000..acf09443a
--- /dev/null
+++ b/packages/core/solidity/src/environments/hardhat/optimism/package-lock.json
@@ -0,0 +1,7665 @@
+{
+  "name": "hardhat-sample",
+  "version": "0.0.1",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "hardhat-sample",
+      "version": "0.0.1",
+      "license": "ISC",
+      "devDependencies": {
+        "@eth-optimism/contracts-bedrock": "^0.17.3",
+        "@nomicfoundation/hardhat-toolbox": "^6.0.0",
+        "@openzeppelin/contracts": "^5.0.0",
+        "hardhat": "^2.16.1"
+      }
+    },
+    "node_modules/@adraffy/ens-normalize": {
+      "version": "1.10.1",
+      "resolved": "https://registry.npmjs.org/@adraffy/ens-normalize/-/ens-normalize-1.10.1.tgz",
+      "integrity": "sha512-96Z2IP3mYmF1Xg2cDm8f1gWGf/HUVedQ3FMifV4kG/PQ4yEP51xDtRAEfhVNt5f/uzpNkZHwWQuUcu6D6K+Ekw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@colors/colors": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/@colors/colors/-/colors-1.5.0.tgz",
+      "integrity": "sha512-ooWCrlZP11i8GImSjTHYHLkvFDP48nS4+204nGb1RiX/WXYHmJA2III9/e2DWVabCESdW7hBAEzHRqUn9OUVvQ==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "peer": true,
+      "engines": {
+        "node": ">=0.1.90"
+      }
+    },
+    "node_modules/@cspotcode/source-map-support": {
+      "version": "0.8.1",
+      "resolved": "https://registry.npmjs.org/@cspotcode/source-map-support/-/source-map-support-0.8.1.tgz",
+      "integrity": "sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@jridgewell/trace-mapping": "0.3.9"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@eth-optimism/contracts-bedrock": {
+      "version": "0.17.3",
+      "resolved": "https://registry.npmjs.org/@eth-optimism/contracts-bedrock/-/contracts-bedrock-0.17.3.tgz",
+      "integrity": "sha512-cHPO7ntWeOBDLO7ZFFSZGI1D7CDqf4loRbRVJrFIsqLEz+hysWIqA0e3dv2GnrjVeuYePBfI2NTBEG4uwz9bQQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@ethereumjs/rlp": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@ethereumjs/rlp/-/rlp-4.0.1.tgz",
+      "integrity": "sha512-tqsQiBQDQdmPWE1xkkBq4rlSW5QZpLOUJ5RJh2/9fug+q9tnUhuZoVLk7s0scUIKTOzEtR72DFBXI4WiZcMpvw==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "peer": true,
+      "bin": {
+        "rlp": "bin/rlp"
+      },
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@ethereumjs/util": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/@ethereumjs/util/-/util-8.1.0.tgz",
+      "integrity": "sha512-zQ0IqbdX8FZ9aw11vP+dZkKDkS+kgIvQPHnSAXzP9pLu+Rfu3D3XEeLbicvoXJTYnhZiPmsZUxgdzXwNKxRPbA==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "peer": true,
+      "dependencies": {
+        "@ethereumjs/rlp": "^4.0.1",
+        "ethereum-cryptography": "^2.0.0",
+        "micro-ftch": "^0.3.1"
+      },
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@ethereumjs/util/node_modules/@noble/curves": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.4.2.tgz",
+      "integrity": "sha512-TavHr8qycMChk8UwMld0ZDRvatedkzWfH8IiaeGCfymOP5i0hSCozz9vHOL0nkwk7HRMlFnAiKpS2jrUmSybcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.4.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@ethereumjs/util/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@ethereumjs/util/node_modules/ethereum-cryptography": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-2.2.1.tgz",
+      "integrity": "sha512-r/W8lkHSiTLxUxW8Rf3u4HGB0xQweG2RyETjywylKZSzLWoWAijRz8WCuOtJ6wah+avllXBqZuk29HCCvhEIRg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "1.4.2",
+        "@noble/hashes": "1.4.0",
+        "@scure/bip32": "1.4.0",
+        "@scure/bip39": "1.3.0"
+      }
+    },
+    "node_modules/@ethersproject/abi": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/abi/-/abi-5.7.0.tgz",
+      "integrity": "sha512-351ktp42TiRcYB3H1OP8yajPeAQstMW/yCFokj/AthP9bLHzQFPlOrxOcwYEDkUAICmOHljvN4K39OMTMUa9RA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/address": "^5.7.0",
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/constants": "^5.7.0",
+        "@ethersproject/hash": "^5.7.0",
+        "@ethersproject/keccak256": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "@ethersproject/strings": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/abstract-provider": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/abstract-provider/-/abstract-provider-5.7.0.tgz",
+      "integrity": "sha512-R41c9UkchKCpAqStMYUpdunjo3pkEvZC3FAwZn5S5MGbXoMQOHIdHItezTETxAO5bevtMApSyEhn9+CHcDsWBw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/networks": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "@ethersproject/transactions": "^5.7.0",
+        "@ethersproject/web": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/abstract-signer": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/abstract-signer/-/abstract-signer-5.7.0.tgz",
+      "integrity": "sha512-a16V8bq1/Cz+TGCkE2OPMTOUDLS3grCpdjoJCYNnVBbdYEMSgKrU0+B90s8b6H+ByYTBZN7a3g76jdIJi7UfKQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/abstract-provider": "^5.7.0",
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/address": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/address/-/address-5.7.0.tgz",
+      "integrity": "sha512-9wYhYt7aghVGo758POM5nqcOMaE168Q6aRLJZwUmiqSrAungkG74gSSeKEIR7ukixesdRZGPgVqme6vmxs1fkA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/keccak256": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/rlp": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/base64": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/base64/-/base64-5.7.0.tgz",
+      "integrity": "sha512-Dr8tcHt2mEbsZr/mwTPIQAf3Ai0Bks/7gTw9dSqk1mQvhW3XvRlmDJr/4n+wg1JmCl16NZue17CDh8xb/vZ0sQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/bignumber": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/bignumber/-/bignumber-5.8.0.tgz",
+      "integrity": "sha512-ZyaT24bHaSeJon2tGPKIiHszWjD/54Sz8t57Toch475lCLljC6MgPmxk7Gtzz+ddNN5LuHea9qhAe0x3D+uYPA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.8.0",
+        "@ethersproject/logger": "^5.8.0",
+        "bn.js": "^5.2.1"
+      }
+    },
+    "node_modules/@ethersproject/bytes": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/bytes/-/bytes-5.8.0.tgz",
+      "integrity": "sha512-vTkeohgJVCPVHu5c25XWaWQOZ4v+DkGoC42/TS2ond+PARCxTJvgTFUNDZovyQ/uAQ4EcpqqowKydcdmRKjg7A==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/logger": "^5.8.0"
+      }
+    },
+    "node_modules/@ethersproject/constants": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/constants/-/constants-5.8.0.tgz",
+      "integrity": "sha512-wigX4lrf5Vu+axVTIvNsuL6YrV4O5AXl5ubcURKMEME5TnWBouUh0CDTWxZ2GpnRn1kcCgE7l8O5+VbV9QTTcg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bignumber": "^5.8.0"
+      }
+    },
+    "node_modules/@ethersproject/hash": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/hash/-/hash-5.7.0.tgz",
+      "integrity": "sha512-qX5WrQfnah1EFnO5zJv1v46a8HW0+E5xuBBDTwMFZLuVTx0tbU2kkx15NqdjxecrLGatQN9FGQKpb1FKdHCt+g==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/abstract-signer": "^5.7.0",
+        "@ethersproject/address": "^5.7.0",
+        "@ethersproject/base64": "^5.7.0",
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/keccak256": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "@ethersproject/strings": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/keccak256": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/keccak256/-/keccak256-5.7.0.tgz",
+      "integrity": "sha512-2UcPboeL/iW+pSg6vZ6ydF8tCnv3Iu/8tUmLLzWWGzxWKFFqOBQFLo6uLUv6BDrLgCDfN28RJ/wtByx+jZ4KBg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0",
+        "js-sha3": "0.8.0"
+      }
+    },
+    "node_modules/@ethersproject/logger": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/logger/-/logger-5.8.0.tgz",
+      "integrity": "sha512-Qe6knGmY+zPPWTC+wQrpitodgBfH7XoceCGL5bJVejmH+yCS3R8jJm8iiWuvWbG76RUmyEG53oqv6GMVWqunjA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/@ethersproject/networks": {
+      "version": "5.7.1",
+      "resolved": "https://registry.npmjs.org/@ethersproject/networks/-/networks-5.7.1.tgz",
+      "integrity": "sha512-n/MufjFYv3yFcUyfhnXotyDlNdFb7onmkSy8aQERi2PjNcnWQ66xXxa3XlS8nCcA8aJKJjIIMNJTC7tu80GwpQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/logger": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/properties": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/properties/-/properties-5.7.0.tgz",
+      "integrity": "sha512-J87jy8suntrAkIZtecpxEPxY//szqr1mlBaYlQ0r4RCaiD2hjheqF9s1LVE8vVuJCXisjIP+JgtK/Do54ej4Sw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/logger": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/rlp": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/rlp/-/rlp-5.7.0.tgz",
+      "integrity": "sha512-rBxzX2vK8mVF7b0Tol44t5Tb8gomOHkj5guL+HhzQ1yBh/ydjGnpw6at+X6Iw0Kp3OzzzkcKp8N9r0W4kYSs9w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/signing-key": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/signing-key/-/signing-key-5.7.0.tgz",
+      "integrity": "sha512-MZdy2nL3wO0u7gkB4nA/pEf8lu1TlFswPNmy8AiYkfKTdO6eXBJyUdmHO/ehm/htHw9K/qF8ujnTyUAD+Ry54Q==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "bn.js": "^5.2.1",
+        "elliptic": "6.5.4",
+        "hash.js": "1.1.7"
+      }
+    },
+    "node_modules/@ethersproject/strings": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/strings/-/strings-5.7.0.tgz",
+      "integrity": "sha512-/9nu+lj0YswRNSH0NXYqrh8775XNyEdUQAuf3f+SmOrnVewcJ5SBNAjF7lpgehKi4abvNNXyf+HX86czCdJ8Mg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/constants": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/transactions": {
+      "version": "5.7.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/transactions/-/transactions-5.7.0.tgz",
+      "integrity": "sha512-kmcNicCp1lp8qanMTC3RIikGgoJ80ztTyvtsFvCYpSCfkjhD0jZ2LOrnbcuxuToLIUYYf+4XwD1rP+B/erDIhQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/address": "^5.7.0",
+        "@ethersproject/bignumber": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/constants": "^5.7.0",
+        "@ethersproject/keccak256": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "@ethersproject/rlp": "^5.7.0",
+        "@ethersproject/signing-key": "^5.7.0"
+      }
+    },
+    "node_modules/@ethersproject/units": {
+      "version": "5.8.0",
+      "resolved": "https://registry.npmjs.org/@ethersproject/units/-/units-5.8.0.tgz",
+      "integrity": "sha512-lxq0CAnc5kMGIiWW4Mr041VT8IhNM+Pn5T3haO74XZWFulk7wH1Gv64HqE96hT4a7iiNMdOCFEBgaxWuk8ETKQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/bignumber": "^5.8.0",
+        "@ethersproject/constants": "^5.8.0",
+        "@ethersproject/logger": "^5.8.0"
+      }
+    },
+    "node_modules/@ethersproject/web": {
+      "version": "5.7.1",
+      "resolved": "https://registry.npmjs.org/@ethersproject/web/-/web-5.7.1.tgz",
+      "integrity": "sha512-Gueu8lSvyjBWL4cYsWsjh6MtMwM0+H4HvqFPZfB6dV8ctbP9zFAO73VG1cMWae0FLPCtz0peKPpZY8/ugJJX2w==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/base64": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/logger": "^5.7.0",
+        "@ethersproject/properties": "^5.7.0",
+        "@ethersproject/strings": "^5.7.0"
+      }
+    },
+    "node_modules/@fastify/busboy": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/@fastify/busboy/-/busboy-2.1.1.tgz",
+      "integrity": "sha512-vBZP4NlzfOlerQTnba4aqZoMhE/a9HY7HRqoOPaETQcSQuWEIyZMHGfVu6w9wGtGK5fED5qRs2DteVCjOH60sA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@isaacs/cliui": {
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/@isaacs/cliui/-/cliui-8.0.2.tgz",
+      "integrity": "sha512-O8jcjabXaleOG9DQ0+ARXWZBTfnP4WNAqzuiJK7ll44AmxGKv/J2M4TPjxjY3znBCfvBXFzucm1twdyFybFqEA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "string-width": "^5.1.2",
+        "string-width-cjs": "npm:string-width@^4.2.0",
+        "strip-ansi": "^7.0.1",
+        "strip-ansi-cjs": "npm:strip-ansi@^6.0.1",
+        "wrap-ansi": "^8.1.0",
+        "wrap-ansi-cjs": "npm:wrap-ansi@^7.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/ansi-regex": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.1.0.tgz",
+      "integrity": "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-regex?sponsor=1"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/ansi-styles": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz",
+      "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/emoji-regex": {
+      "version": "9.2.2",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-9.2.2.tgz",
+      "integrity": "sha512-L18DaJsXSUk2+42pv8mLs5jJT2hqFkFE4j21wOmgbUqsZ2hL72NsUU785g9RXgo3s0ZNgVl42TiHp3ZtOv/Vyg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@isaacs/cliui/node_modules/string-width": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-5.1.2.tgz",
+      "integrity": "sha512-HnLOCR3vjcY8beoNLtcjZ5/nxn2afmME6lhrDrebokqMap+XbeW8n9TXpPDOqdGK5qcI3oT0GKTW6wC7EMiVqA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "eastasianwidth": "^0.2.0",
+        "emoji-regex": "^9.2.2",
+        "strip-ansi": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/strip-ansi": {
+      "version": "7.1.0",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz",
+      "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-regex": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/strip-ansi?sponsor=1"
+      }
+    },
+    "node_modules/@isaacs/cliui/node_modules/wrap-ansi": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-8.1.0.tgz",
+      "integrity": "sha512-si7QWI6zUMq56bESFvagtmzMdGOtoxfR+Sez11Mobfc7tm+VkUckk9bW2UeffTGVUbOksxmSw0AA2gs8g71NCQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^6.1.0",
+        "string-width": "^5.0.1",
+        "strip-ansi": "^7.0.1"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/@jridgewell/resolve-uri": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@jridgewell/resolve-uri/-/resolve-uri-3.1.2.tgz",
+      "integrity": "sha512-bRISgCIjP20/tbWSPWMEi54QVPRZExkuD9lJL+UIxUKtwVJA8wW1Trb1jMs1RFXo1CBTNZ/5hpC9QvmKWdopKw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/@jridgewell/sourcemap-codec": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.0.tgz",
+      "integrity": "sha512-gv3ZRaISU3fjPAgNsriBRqGWQL6quFx04YMPW/zD8XMLsU32mhCCbfbO6KZFLjvYpCZ8zyDEgqsgf+PwPaM7GQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@jridgewell/trace-mapping": {
+      "version": "0.3.9",
+      "resolved": "https://registry.npmjs.org/@jridgewell/trace-mapping/-/trace-mapping-0.3.9.tgz",
+      "integrity": "sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@jridgewell/resolve-uri": "^3.0.3",
+        "@jridgewell/sourcemap-codec": "^1.4.10"
+      }
+    },
+    "node_modules/@metamask/eth-sig-util": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/@metamask/eth-sig-util/-/eth-sig-util-4.0.1.tgz",
+      "integrity": "sha512-tghyZKLHZjcdlDqCA3gNZmLeR0XvOE9U1qoQO9ohyAZT6Pya+H9vkBPcsyXytmYLNgVoin7CKCmweo/R43V+tQ==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "ethereumjs-abi": "^0.6.8",
+        "ethereumjs-util": "^6.2.1",
+        "ethjs-util": "^0.1.6",
+        "tweetnacl": "^1.0.3",
+        "tweetnacl-util": "^0.15.1"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      }
+    },
+    "node_modules/@metamask/eth-sig-util/node_modules/@types/bn.js": {
+      "version": "4.11.6",
+      "resolved": "https://registry.npmjs.org/@types/bn.js/-/bn.js-4.11.6.tgz",
+      "integrity": "sha512-pqr857jrp2kPuO9uRjZ3PwnJTjoQy+fcdxvBTvHm6dkmEL9q+hDD/2j/0ELOBPtPnS8LjCX0gI9nbl8lVkadpg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@metamask/eth-sig-util/node_modules/bn.js": {
+      "version": "4.12.1",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+      "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@metamask/eth-sig-util/node_modules/ethereumjs-util": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/ethereumjs-util/-/ethereumjs-util-6.2.1.tgz",
+      "integrity": "sha512-W2Ktez4L01Vexijrm5EB6w7dg4n/TgpoYU4avuT5T3Vmnw/eCRtiBrJfQYS/DCSvDIOLn2k57GcHdeBcgVxAqw==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "dependencies": {
+        "@types/bn.js": "^4.11.3",
+        "bn.js": "^4.11.0",
+        "create-hash": "^1.1.2",
+        "elliptic": "^6.5.2",
+        "ethereum-cryptography": "^0.1.3",
+        "ethjs-util": "0.1.6",
+        "rlp": "^2.2.3"
+      }
+    },
+    "node_modules/@noble/ciphers": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@noble/ciphers/-/ciphers-1.3.0.tgz",
+      "integrity": "sha512-2I0gnIVPtfnMw9ee9h1dJG7tp81+8Ob3OJb3Mv37rx5L40/b0i7djjCVvGOVqc9AEIQyvyu1i6ypKdFw8R8gQw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@noble/curves": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.2.0.tgz",
+      "integrity": "sha512-oYclrNgRaM9SsBUBVbb8M6DTV7ZHRTKugureoYEncY5c65HOmRzvSiTE3y5CYaPYJA/GVkrhXEoF0M3Ya9PMnw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.3.2"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@noble/hashes": {
+      "version": "1.3.2",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.3.2.tgz",
+      "integrity": "sha512-MVC8EAQp7MvEcm30KWENFjgR+Mkmf+D189XJTkFIlwohU5hcBbn1ZkKq7KVTi2Hme3PMGF390DaL52beVrIihQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@noble/secp256k1": {
+      "version": "1.7.1",
+      "resolved": "https://registry.npmjs.org/@noble/secp256k1/-/secp256k1-1.7.1.tgz",
+      "integrity": "sha512-hOUk6AyBFmqVrv7k5WAw/LpszxVbj9gGN4JRkIX52fdFAj1UA61KXmZDvqVEm+pOyec3+fIeZB02LYa/pWOArw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://paulmillr.com/funding/"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/@nodelib/fs.scandir": {
+      "version": "2.1.5",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",
+      "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@nodelib/fs.stat": "2.0.5",
+        "run-parallel": "^1.1.9"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nodelib/fs.stat": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",
+      "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nodelib/fs.walk": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",
+      "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@nodelib/fs.scandir": "2.1.5",
+        "fastq": "^1.6.0"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/@nomicfoundation/edr": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr/-/edr-0.8.0.tgz",
+      "integrity": "sha512-dwWRrghSVBQDpt0wP+6RXD8BMz2i/9TI34TcmZqeEAZuCLei3U9KZRgGTKVAM1rMRvrpf5ROfPqrWNetKVUTag==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@nomicfoundation/edr-darwin-arm64": "0.8.0",
+        "@nomicfoundation/edr-darwin-x64": "0.8.0",
+        "@nomicfoundation/edr-linux-arm64-gnu": "0.8.0",
+        "@nomicfoundation/edr-linux-arm64-musl": "0.8.0",
+        "@nomicfoundation/edr-linux-x64-gnu": "0.8.0",
+        "@nomicfoundation/edr-linux-x64-musl": "0.8.0",
+        "@nomicfoundation/edr-win32-x64-msvc": "0.8.0"
+      },
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-darwin-arm64": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-darwin-arm64/-/edr-darwin-arm64-0.8.0.tgz",
+      "integrity": "sha512-sKTmOu/P5YYhxT0ThN2Pe3hmCE/5Ag6K/eYoiavjLWbR7HEb5ZwPu2rC3DpuUk1H+UKJqt7o4/xIgJxqw9wu6A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-darwin-x64": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-darwin-x64/-/edr-darwin-x64-0.8.0.tgz",
+      "integrity": "sha512-8ymEtWw1xf1Id1cc42XIeE+9wyo3Dpn9OD/X8GiaMz9R70Ebmj2g+FrbETu8o6UM+aL28sBZQCiCzjlft2yWAg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-linux-arm64-gnu": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-linux-arm64-gnu/-/edr-linux-arm64-gnu-0.8.0.tgz",
+      "integrity": "sha512-h/wWzS2EyQuycz+x/SjMRbyA+QMCCVmotRsgM1WycPARvVZWIVfwRRsKoXKdCftsb3S8NTprqBdJlOmsFyETFA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-linux-arm64-musl": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-linux-arm64-musl/-/edr-linux-arm64-musl-0.8.0.tgz",
+      "integrity": "sha512-gnWxDgdkka0O9GpPX/gZT3REeKYV28Guyg13+Vj/bbLpmK1HmGh6Kx+fMhWv+Ht/wEmGDBGMCW1wdyT/CftJaQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-linux-x64-gnu": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-linux-x64-gnu/-/edr-linux-x64-gnu-0.8.0.tgz",
+      "integrity": "sha512-DTMiAkgAx+nyxcxKyxFZk1HPakXXUCgrmei7r5G7kngiggiGp/AUuBBWFHi8xvl2y04GYhro5Wp+KprnLVoAPA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-linux-x64-musl": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-linux-x64-musl/-/edr-linux-x64-musl-0.8.0.tgz",
+      "integrity": "sha512-iTITWe0Zj8cNqS0xTblmxPbHVWwEtMiDC+Yxwr64d7QBn/1W0ilFQ16J8gB6RVVFU3GpfNyoeg3tUoMpSnrm6Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/edr-win32-x64-msvc": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/edr-win32-x64-msvc/-/edr-win32-x64-msvc-0.8.0.tgz",
+      "integrity": "sha512-mNRDyd/C3j7RMcwapifzv2K57sfA5xOw8g2U84ZDvgSrXVXLC99ZPxn9kmolb+dz8VMm9FONTZz9ESS6v8DTnA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 18"
+      }
+    },
+    "node_modules/@nomicfoundation/ethereumjs-common": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/ethereumjs-common/-/ethereumjs-common-4.0.4.tgz",
+      "integrity": "sha512-9Rgb658lcWsjiicr5GzNCjI1llow/7r0k50dLL95OJ+6iZJcVbi15r3Y0xh2cIO+zgX0WIHcbzIu6FeQf9KPrg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@nomicfoundation/ethereumjs-util": "9.0.4"
+      }
+    },
+    "node_modules/@nomicfoundation/ethereumjs-rlp": {
+      "version": "5.0.4",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/ethereumjs-rlp/-/ethereumjs-rlp-5.0.4.tgz",
+      "integrity": "sha512-8H1S3s8F6QueOc/X92SdrA4RDenpiAEqMg5vJH99kcQaCy/a3Q6fgseo75mgWlbanGJXSlAPtnCeG9jvfTYXlw==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "bin": {
+        "rlp": "bin/rlp.cjs"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@nomicfoundation/ethereumjs-tx": {
+      "version": "5.0.4",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/ethereumjs-tx/-/ethereumjs-tx-5.0.4.tgz",
+      "integrity": "sha512-Xjv8wAKJGMrP1f0n2PeyfFCCojHd7iS3s/Ab7qzF1S64kxZ8Z22LCMynArYsVqiFx6rzYy548HNVEyI+AYN/kw==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "dependencies": {
+        "@nomicfoundation/ethereumjs-common": "4.0.4",
+        "@nomicfoundation/ethereumjs-rlp": "5.0.4",
+        "@nomicfoundation/ethereumjs-util": "9.0.4",
+        "ethereum-cryptography": "0.1.3"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "c-kzg": "^2.1.2"
+      },
+      "peerDependenciesMeta": {
+        "c-kzg": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@nomicfoundation/ethereumjs-util": {
+      "version": "9.0.4",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/ethereumjs-util/-/ethereumjs-util-9.0.4.tgz",
+      "integrity": "sha512-sLOzjnSrlx9Bb9EFNtHzK/FJFsfg2re6bsGqinFinH1gCqVfz9YYlXiMWwDM4C/L4ywuHFCYwfKTVr/QHQcU0Q==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "dependencies": {
+        "@nomicfoundation/ethereumjs-rlp": "5.0.4",
+        "ethereum-cryptography": "0.1.3"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "c-kzg": "^2.1.2"
+      },
+      "peerDependenciesMeta": {
+        "c-kzg": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-chai-matchers": {
+      "version": "2.0.8",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-chai-matchers/-/hardhat-chai-matchers-2.0.8.tgz",
+      "integrity": "sha512-Z5PiCXH4xhNLASROlSUOADfhfpfhYO6D7Hn9xp8PddmHey0jq704cr6kfU8TRrQ4PUZbpfsZadPj+pCfZdjPIg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/chai-as-promised": "^7.1.3",
+        "chai-as-promised": "^7.1.1",
+        "deep-eql": "^4.0.1",
+        "ordinal": "^1.0.3"
+      },
+      "peerDependencies": {
+        "@nomicfoundation/hardhat-ethers": "^3.0.0",
+        "chai": "^4.2.0",
+        "ethers": "^6.1.0",
+        "hardhat": "^2.9.4"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-ethers": {
+      "version": "3.0.8",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-ethers/-/hardhat-ethers-3.0.8.tgz",
+      "integrity": "sha512-zhOZ4hdRORls31DTOqg+GmEZM0ujly8GGIuRY7t7szEk2zW/arY1qDug/py8AEktT00v5K+b6RvbVog+va51IA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "debug": "^4.1.1",
+        "lodash.isequal": "^4.5.0"
+      },
+      "peerDependencies": {
+        "ethers": "^6.1.0",
+        "hardhat": "^2.0.0"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-ignition": {
+      "version": "0.15.10",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-ignition/-/hardhat-ignition-0.15.10.tgz",
+      "integrity": "sha512-UScXyLLG5rEm+ANchQYCDOsskdXl6ux3oCPgC24PKE/QMJEib5crGZIo8spAyzdK6vOnRW6i4FG+1qvoO0AGWA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@nomicfoundation/ignition-core": "^0.15.10",
+        "@nomicfoundation/ignition-ui": "^0.15.10",
+        "chalk": "^4.0.0",
+        "debug": "^4.3.2",
+        "fs-extra": "^10.0.0",
+        "json5": "^2.2.3",
+        "prompts": "^2.4.2"
+      },
+      "peerDependencies": {
+        "@nomicfoundation/hardhat-verify": "^2.0.1",
+        "hardhat": "^2.18.0"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-ignition-ethers": {
+      "version": "0.15.10",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-ignition-ethers/-/hardhat-ignition-ethers-0.15.10.tgz",
+      "integrity": "sha512-P90glRiBbR4mnMKP/LePovfUJjYT2YWJjx7118i7yxssUwcaW9wFohb4bFh+236N1tqM4q7aGx9cBvHNgve3zA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "peerDependencies": {
+        "@nomicfoundation/hardhat-ethers": "^3.0.4",
+        "@nomicfoundation/hardhat-ignition": "^0.15.10",
+        "@nomicfoundation/ignition-core": "^0.15.10",
+        "ethers": "^6.7.0",
+        "hardhat": "^2.18.0"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-network-helpers": {
+      "version": "1.0.12",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-network-helpers/-/hardhat-network-helpers-1.0.12.tgz",
+      "integrity": "sha512-xTNQNI/9xkHvjmCJnJOTyqDSl8uq1rKb2WOVmixQxFtRd7Oa3ecO8zM0cyC2YmOK+jHB9WPZ+F/ijkHg1CoORA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ethereumjs-util": "^7.1.4"
+      },
+      "peerDependencies": {
+        "hardhat": "^2.9.5"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-toolbox": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-toolbox/-/hardhat-toolbox-6.0.0.tgz",
+      "integrity": "sha512-3qm3VuDp5xD8UyfhYPPfZHnCc0M/V5yfRSTSDdOuI8DTrmYJkMNW7QrTNGalMCigWn3suBghSw9YcMOyGDJ7Lg==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "@nomicfoundation/hardhat-chai-matchers": "^2.0.0",
+        "@nomicfoundation/hardhat-ethers": "^3.0.0",
+        "@nomicfoundation/hardhat-ignition-ethers": "^0.15.0",
+        "@nomicfoundation/hardhat-network-helpers": "^1.0.0",
+        "@nomicfoundation/hardhat-verify": "^2.0.0",
+        "@typechain/ethers-v6": "^0.5.0",
+        "@typechain/hardhat": "^9.0.0",
+        "@types/chai": "^4.2.0",
+        "@types/mocha": ">=9.1.0",
+        "@types/node": ">=18.0.0",
+        "chai": "^4.2.0",
+        "ethers": "^6.14.0",
+        "hardhat": "^2.11.0",
+        "hardhat-gas-reporter": "^2.3.0",
+        "solidity-coverage": "^0.8.1",
+        "ts-node": ">=8.0.0",
+        "typechain": "^8.3.0",
+        "typescript": ">=4.5.0"
+      }
+    },
+    "node_modules/@nomicfoundation/hardhat-verify": {
+      "version": "2.0.13",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/hardhat-verify/-/hardhat-verify-2.0.13.tgz",
+      "integrity": "sha512-i57GX1sC0kYGyRVnbQrjjyBTpWTKgrvKC+jH8CMKV6gHp959Upb8lKaZ58WRHIU0espkulTxLnacYeUDirwJ2g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/abi": "^5.1.2",
+        "@ethersproject/address": "^5.0.2",
+        "cbor": "^8.1.0",
+        "debug": "^4.1.1",
+        "lodash.clonedeep": "^4.5.0",
+        "picocolors": "^1.1.0",
+        "semver": "^6.3.0",
+        "table": "^6.8.0",
+        "undici": "^5.14.0"
+      },
+      "peerDependencies": {
+        "hardhat": "^2.0.4"
+      }
+    },
+    "node_modules/@nomicfoundation/ignition-core": {
+      "version": "0.15.10",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/ignition-core/-/ignition-core-0.15.10.tgz",
+      "integrity": "sha512-AWvCviNlBkPT8EKcg34N+yUdQTYFiC/HdpfFZdw8oMFuAs9SMZE0zQA9gJQSCay41GbuyXt2Kietp5/1/nlBIA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/address": "5.6.1",
+        "@nomicfoundation/solidity-analyzer": "^0.1.1",
+        "cbor": "^9.0.0",
+        "debug": "^4.3.2",
+        "ethers": "^6.7.0",
+        "fs-extra": "^10.0.0",
+        "immer": "10.0.2",
+        "lodash": "4.17.21",
+        "ndjson": "2.0.0"
+      }
+    },
+    "node_modules/@nomicfoundation/ignition-core/node_modules/@ethersproject/address": {
+      "version": "5.6.1",
+      "resolved": "https://registry.npmjs.org/@ethersproject/address/-/address-5.6.1.tgz",
+      "integrity": "sha512-uOgF0kS5MJv9ZvCz7x6T2EXJSzotiybApn4XlOgoTX0xdtyVIJ7pF+6cGPxiEq/dpBiTfMiw7Yc81JcwhSYA0Q==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://gitcoin.co/grants/13/ethersjs-complete-simple-and-tiny-2"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/bignumber": "^5.6.2",
+        "@ethersproject/bytes": "^5.6.1",
+        "@ethersproject/keccak256": "^5.6.1",
+        "@ethersproject/logger": "^5.6.0",
+        "@ethersproject/rlp": "^5.6.1"
+      }
+    },
+    "node_modules/@nomicfoundation/ignition-core/node_modules/cbor": {
+      "version": "9.0.2",
+      "resolved": "https://registry.npmjs.org/cbor/-/cbor-9.0.2.tgz",
+      "integrity": "sha512-JPypkxsB10s9QOWwa6zwPzqE1Md3vqpPc+cai4sAecuCsRyAtAl/pMyhPlMbT/xtPnm2dznJZYRLui57qiRhaQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "nofilter": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/@nomicfoundation/ignition-ui": {
+      "version": "0.15.10",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/ignition-ui/-/ignition-ui-0.15.10.tgz",
+      "integrity": "sha512-82XQPF+1fvxTimDUPgDVwpTjHjfjFgFs84rERbBiMLQbz6sPtgTlV8HHrlbMx8tT/JKCI/SCU4gxV8xA4CPfcg==",
+      "dev": true,
+      "peer": true
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer/-/solidity-analyzer-0.1.2.tgz",
+      "integrity": "sha512-q4n32/FNKIhQ3zQGGw5CvPF6GTvDCpYwIf7bEY/dZTZbgfDsHyjJwURxUJf3VQuuJj+fDIFl4+KkBVbw4Ef6jA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      },
+      "optionalDependencies": {
+        "@nomicfoundation/solidity-analyzer-darwin-arm64": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-darwin-x64": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-linux-arm64-gnu": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-linux-arm64-musl": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-linux-x64-gnu": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-linux-x64-musl": "0.1.2",
+        "@nomicfoundation/solidity-analyzer-win32-x64-msvc": "0.1.2"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-darwin-arm64": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-darwin-arm64/-/solidity-analyzer-darwin-arm64-0.1.2.tgz",
+      "integrity": "sha512-JaqcWPDZENCvm++lFFGjrDd8mxtf+CtLd2MiXvMNTBD33dContTZ9TWETwNFwg7JTJT5Q9HEecH7FA+HTSsIUw==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-darwin-x64": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-darwin-x64/-/solidity-analyzer-darwin-x64-0.1.2.tgz",
+      "integrity": "sha512-fZNmVztrSXC03e9RONBT+CiksSeYcxI1wlzqyr0L7hsQlK1fzV+f04g2JtQ1c/Fe74ZwdV6aQBdd6Uwl1052sw==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-linux-arm64-gnu": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-linux-arm64-gnu/-/solidity-analyzer-linux-arm64-gnu-0.1.2.tgz",
+      "integrity": "sha512-3d54oc+9ZVBuB6nbp8wHylk4xh0N0Gc+bk+/uJae+rUgbOBwQSfuGIbAZt1wBXs5REkSmynEGcqx6DutoK0tPA==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-linux-arm64-musl": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-linux-arm64-musl/-/solidity-analyzer-linux-arm64-musl-0.1.2.tgz",
+      "integrity": "sha512-iDJfR2qf55vgsg7BtJa7iPiFAsYf2d0Tv/0B+vhtnI16+wfQeTbP7teookbGvAo0eJo7aLLm0xfS/GTkvHIucA==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-linux-x64-gnu": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-linux-x64-gnu/-/solidity-analyzer-linux-x64-gnu-0.1.2.tgz",
+      "integrity": "sha512-9dlHMAt5/2cpWyuJ9fQNOUXFB/vgSFORg1jpjX1Mh9hJ/MfZXlDdHQ+DpFCs32Zk5pxRBb07yGvSHk9/fezL+g==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-linux-x64-musl": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-linux-x64-musl/-/solidity-analyzer-linux-x64-musl-0.1.2.tgz",
+      "integrity": "sha512-GzzVeeJob3lfrSlDKQw2bRJ8rBf6mEYaWY+gW0JnTDHINA0s2gPR4km5RLIj1xeZZOYz4zRw+AEeYgLRqB2NXg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@nomicfoundation/solidity-analyzer-win32-x64-msvc": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/@nomicfoundation/solidity-analyzer-win32-x64-msvc/-/solidity-analyzer-win32-x64-msvc-0.1.2.tgz",
+      "integrity": "sha512-Fdjli4DCcFHb4Zgsz0uEJXZ2K7VEO+w5KVv7HmT7WO10iODdU9csC2az4jrhEsRtiR9Gfd74FlG0NYlw1BMdyA==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/@openzeppelin/contracts": {
+      "version": "5.3.0",
+      "resolved": "https://registry.npmjs.org/@openzeppelin/contracts/-/contracts-5.3.0.tgz",
+      "integrity": "sha512-zj/KGoW7zxWUE8qOI++rUM18v+VeLTTzKs/DJFkSzHpQFPD/jKKF0TrMxBfGLl3kpdELCNccvB3zmofSzm4nlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@pkgjs/parseargs": {
+      "version": "0.11.0",
+      "resolved": "https://registry.npmjs.org/@pkgjs/parseargs/-/parseargs-0.11.0.tgz",
+      "integrity": "sha512-+1VkjdD0QBLPodGrJUeqarH8VAIvQODIbwh9XpP5Syisf7YoQgsJKPNFoqqLQlu+VQ/tVSshMR6loPMn8U+dPg==",
+      "dev": true,
+      "license": "MIT",
+      "optional": true,
+      "peer": true,
+      "engines": {
+        "node": ">=14"
+      }
+    },
+    "node_modules/@scure/base": {
+      "version": "1.1.9",
+      "resolved": "https://registry.npmjs.org/@scure/base/-/base-1.1.9.tgz",
+      "integrity": "sha512-8YKhl8GHiNI/pU2VMaofa2Tor7PJRAjwQLBBuilkJ9L5+13yVbC7JO/wS7piioAvPSwR3JKM1IJ/u4xQzbcXKg==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip32": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip32/-/bip32-1.4.0.tgz",
+      "integrity": "sha512-sVUpc0Vq3tXCkDGYVWGIZTRfnvu8LoTDaev7vbwh0omSvVORONr960MQWdKqJDCReIEmTj3PAr73O3aoxz7OPg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "~1.4.0",
+        "@noble/hashes": "~1.4.0",
+        "@scure/base": "~1.1.6"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip32/node_modules/@noble/curves": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.4.2.tgz",
+      "integrity": "sha512-TavHr8qycMChk8UwMld0ZDRvatedkzWfH8IiaeGCfymOP5i0hSCozz9vHOL0nkwk7HRMlFnAiKpS2jrUmSybcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.4.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip32/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip39": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip39/-/bip39-1.3.0.tgz",
+      "integrity": "sha512-disdg7gHuTDZtY+ZdkmLpPCk7fxZSu3gBiEGuoC1XYxv9cGx3Z6cpTggCgW6odSOOIXCiDjuGejW+aJKCY/pIQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "~1.4.0",
+        "@scure/base": "~1.1.6"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@scure/bip39/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/@sentry/core": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/core/-/core-5.30.0.tgz",
+      "integrity": "sha512-TmfrII8w1PQZSZgPpUESqjB+jC6MvZJZdLtE/0hZ+SrnKhW3x5WlYLvTXZpcWePYBku7rl2wn1RZu6uT0qCTeg==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@sentry/hub": "5.30.0",
+        "@sentry/minimal": "5.30.0",
+        "@sentry/types": "5.30.0",
+        "@sentry/utils": "5.30.0",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/core/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@sentry/hub": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/hub/-/hub-5.30.0.tgz",
+      "integrity": "sha512-2tYrGnzb1gKz2EkMDQcfLrDTvmGcQPuWxLnJKXJvYTQDGLlEvi2tWz1VIHjunmOvJrB5aIQLhm+dcMRwFZDCqQ==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@sentry/types": "5.30.0",
+        "@sentry/utils": "5.30.0",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/hub/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@sentry/minimal": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/minimal/-/minimal-5.30.0.tgz",
+      "integrity": "sha512-BwWb/owZKtkDX+Sc4zCSTNcvZUq7YcH3uAVlmh/gtR9rmUvbzAA3ewLuB3myi4wWRAMEtny6+J/FN/x+2wn9Xw==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@sentry/hub": "5.30.0",
+        "@sentry/types": "5.30.0",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/minimal/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@sentry/node": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/node/-/node-5.30.0.tgz",
+      "integrity": "sha512-Br5oyVBF0fZo6ZS9bxbJZG4ApAjRqAnqFFurMVJJdunNb80brh7a5Qva2kjhm+U6r9NJAB5OmDyPkA1Qnt+QVg==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@sentry/core": "5.30.0",
+        "@sentry/hub": "5.30.0",
+        "@sentry/tracing": "5.30.0",
+        "@sentry/types": "5.30.0",
+        "@sentry/utils": "5.30.0",
+        "cookie": "^0.4.1",
+        "https-proxy-agent": "^5.0.0",
+        "lru_map": "^0.3.3",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/node/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@sentry/tracing": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/tracing/-/tracing-5.30.0.tgz",
+      "integrity": "sha512-dUFowCr0AIMwiLD7Fs314Mdzcug+gBVo/+NCMyDw8tFxJkwWAKl7Qa2OZxLQ0ZHjakcj1hNKfCQJ9rhyfOl4Aw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@sentry/hub": "5.30.0",
+        "@sentry/minimal": "5.30.0",
+        "@sentry/types": "5.30.0",
+        "@sentry/utils": "5.30.0",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/tracing/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@sentry/types": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/types/-/types-5.30.0.tgz",
+      "integrity": "sha512-R8xOqlSTZ+htqrfteCWU5Nk0CDN5ApUTvrlvBuiH1DyP6czDZ4ktbZB0hAgBlVcK0U+qpD3ag3Tqqpa5Q67rPw==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/utils": {
+      "version": "5.30.0",
+      "resolved": "https://registry.npmjs.org/@sentry/utils/-/utils-5.30.0.tgz",
+      "integrity": "sha512-zaYmoH0NWWtvnJjC9/CBseXMtKHm/tm40sz3YfJRxeQjyzRqNQPgivpd9R/oDJCYj999mzdW382p/qi2ypjLww==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "@sentry/types": "5.30.0",
+        "tslib": "^1.9.3"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/@sentry/utils/node_modules/tslib": {
+      "version": "1.14.1",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",
+      "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",
+      "dev": true,
+      "license": "0BSD"
+    },
+    "node_modules/@solidity-parser/parser": {
+      "version": "0.20.1",
+      "resolved": "https://registry.npmjs.org/@solidity-parser/parser/-/parser-0.20.1.tgz",
+      "integrity": "sha512-58I2sRpzaQUN+jJmWbHfbWf9AKfzqCI8JAdFB0vbyY+u8tBRcuTt9LxzasvR0LGQpcRv97eyV7l61FQ3Ib7zVw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@tsconfig/node10": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node10/-/node10-1.0.11.tgz",
+      "integrity": "sha512-DcRjDCujK/kCk/cUe8Xz8ZSpm8mS3mNNpta+jGCA6USEDfktlNvm1+IuZ9eTcDbNk41BHwpHHeW+N1lKCz4zOw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@tsconfig/node12": {
+      "version": "1.0.11",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node12/-/node12-1.0.11.tgz",
+      "integrity": "sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@tsconfig/node14": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node14/-/node14-1.0.3.tgz",
+      "integrity": "sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@tsconfig/node16": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/@tsconfig/node16/-/node16-1.0.4.tgz",
+      "integrity": "sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@typechain/ethers-v6": {
+      "version": "0.5.1",
+      "resolved": "https://registry.npmjs.org/@typechain/ethers-v6/-/ethers-v6-0.5.1.tgz",
+      "integrity": "sha512-F+GklO8jBWlsaVV+9oHaPh5NJdd6rAKN4tklGfInX1Q7h0xPgVLP39Jl3eCulPB5qexI71ZFHwbljx4ZXNfouA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "lodash": "^4.17.15",
+        "ts-essentials": "^7.0.1"
+      },
+      "peerDependencies": {
+        "ethers": "6.x",
+        "typechain": "^8.3.2",
+        "typescript": ">=4.7.0"
+      }
+    },
+    "node_modules/@typechain/hardhat": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/@typechain/hardhat/-/hardhat-9.1.0.tgz",
+      "integrity": "sha512-mtaUlzLlkqTlfPwB3FORdejqBskSnh+Jl8AIJGjXNAQfRQ4ofHADPl1+oU7Z3pAJzmZbUXII8MhOLQltcHgKnA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "fs-extra": "^9.1.0"
+      },
+      "peerDependencies": {
+        "@typechain/ethers-v6": "^0.5.1",
+        "ethers": "^6.1.0",
+        "hardhat": "^2.9.9",
+        "typechain": "^8.3.2"
+      }
+    },
+    "node_modules/@typechain/hardhat/node_modules/fs-extra": {
+      "version": "9.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-9.1.0.tgz",
+      "integrity": "sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "at-least-node": "^1.0.0",
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/@types/bn.js": {
+      "version": "5.1.6",
+      "resolved": "https://registry.npmjs.org/@types/bn.js/-/bn.js-5.1.6.tgz",
+      "integrity": "sha512-Xh8vSwUeMKeYYrj3cX4lGQgFSF/N03r+tv4AiLl1SucqV+uTQpxRcnM8AkXKHwYP9ZPXOYXRr2KPXpVlIvqh9w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/chai": {
+      "version": "4.3.20",
+      "resolved": "https://registry.npmjs.org/@types/chai/-/chai-4.3.20.tgz",
+      "integrity": "sha512-/pC9HAB5I/xMlc5FP77qjCnI16ChlJfW0tGa0IUcFn38VJrTV6DeZ60NU5KZBtaOZqjdpwTWohz5HU1RrhiYxQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@types/chai-as-promised": {
+      "version": "7.1.8",
+      "resolved": "https://registry.npmjs.org/@types/chai-as-promised/-/chai-as-promised-7.1.8.tgz",
+      "integrity": "sha512-ThlRVIJhr69FLlh6IctTXFkmhtP3NpMZ2QGq69StYLyKZFp/HOp1VdKZj7RvfNWYYcJ1xlbLGLLWj1UvP5u/Gw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/chai": "*"
+      }
+    },
+    "node_modules/@types/glob": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/@types/glob/-/glob-7.2.0.tgz",
+      "integrity": "sha512-ZUxbzKl0IfJILTS6t7ip5fQQM/J3TJYubDm3nMbgubNNYS62eXeUpoLUC8/7fJNiFYHTrGPQn7hspDUzIHX3UA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/minimatch": "*",
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/lru-cache": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/@types/lru-cache/-/lru-cache-5.1.1.tgz",
+      "integrity": "sha512-ssE3Vlrys7sdIzs5LOxCzTVMsU7i9oa/IaW92wF32JFb3CVczqOkru2xspuKczHEbG3nvmPY7IFqVmGGHdNbYw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/@types/minimatch": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/@types/minimatch/-/minimatch-5.1.2.tgz",
+      "integrity": "sha512-K0VQKziLUWkVKiRVrx4a40iPaxTUefQmjtkQofBkYRcoaaL/8rhwDWww9qWbrgicNOgnpIsMxyNIUM4+n6dUIA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@types/mocha": {
+      "version": "10.0.10",
+      "resolved": "https://registry.npmjs.org/@types/mocha/-/mocha-10.0.10.tgz",
+      "integrity": "sha512-xPyYSz1cMPnJQhl0CLMH68j3gprKZaTjG3s5Vi+fDgx+uhG9NOXwbVt52eFS8ECyXhyKcjDLCBEqBExKuiZb7Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@types/node": {
+      "version": "22.13.5",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.13.5.tgz",
+      "integrity": "sha512-+lTU0PxZXn0Dr1NBtC7Y8cR21AJr87dLLU953CWA6pMxxv/UDc7jYAY90upcrie1nRcD6XNG5HOYEDtgW5TxAg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "undici-types": "~6.20.0"
+      }
+    },
+    "node_modules/@types/pbkdf2": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/@types/pbkdf2/-/pbkdf2-3.1.2.tgz",
+      "integrity": "sha512-uRwJqmiXmh9++aSu1VNEn3iIxWOhd8AHXNSdlaLfdAAdSTY9jYVeGWnzejM3dvrkbqE3/hyQkQQ29IFATEGlew==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/@types/prettier": {
+      "version": "2.7.3",
+      "resolved": "https://registry.npmjs.org/@types/prettier/-/prettier-2.7.3.tgz",
+      "integrity": "sha512-+68kP9yzs4LMp7VNh8gdzMSPZFL44MLGqiHWvttYJe+6qnuVr4Ek9wSBQoveqY/r+LwjCcU29kNVkidwim+kYA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/@types/secp256k1": {
+      "version": "4.0.6",
+      "resolved": "https://registry.npmjs.org/@types/secp256k1/-/secp256k1-4.0.6.tgz",
+      "integrity": "sha512-hHxJU6PAEUn0TP4S/ZOzuTUvJWuZ6eIKeNKb5RBpODvSl6hp1Wrw4s7ATY50rklRCScUDpHzVA/DQdSjJ3UoYQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/abbrev": {
+      "version": "1.0.9",
+      "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.0.9.tgz",
+      "integrity": "sha512-LEyx4aLEC3x6T0UguF6YILf+ntvmOaWsVfENmIW0E9H09vKlLDGelMjjSm0jkDHALj8A8quZ/HapKNigzwge+Q==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/abitype": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/abitype/-/abitype-1.0.8.tgz",
+      "integrity": "sha512-ZeiI6h3GnW06uYDLx0etQtX/p8E24UaHHBj57RSjK7YBFe7iuVn07EDpOeP451D06sF27VOz9JJPlIKJmXgkEg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://github.com/sponsors/wevm"
+      },
+      "peerDependencies": {
+        "typescript": ">=5.0.4",
+        "zod": "^3 >=3.22.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        },
+        "zod": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/acorn": {
+      "version": "8.14.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.14.0.tgz",
+      "integrity": "sha512-cl669nCJTZBsL97OF4kUQm5g5hC2uihk0NxY3WENAC0TYdILVkAyHymAntgxGkl7K+t0cXIrH5siy5S4XkFycA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "bin": {
+        "acorn": "bin/acorn"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/acorn-walk": {
+      "version": "8.3.4",
+      "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.3.4.tgz",
+      "integrity": "sha512-ueEepnujpqee2o5aIYnvHU6C0A42MNdsIDeqy5BydrkuC5R1ZuUFnm27EeFJGoEHJQgn3uleRvmTXaJgfXbt4g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "acorn": "^8.11.0"
+      },
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/adm-zip": {
+      "version": "0.4.16",
+      "resolved": "https://registry.npmjs.org/adm-zip/-/adm-zip-0.4.16.tgz",
+      "integrity": "sha512-TFi4HBKSGfIKsK5YCkKaaFG2m4PEDyViZmEwof3MTIgzimHLto6muaHVpbrljdIvIrFZzEq/p4nafOeLcYegrg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.3.0"
+      }
+    },
+    "node_modules/aes-js": {
+      "version": "4.0.0-beta.5",
+      "resolved": "https://registry.npmjs.org/aes-js/-/aes-js-4.0.0-beta.5.tgz",
+      "integrity": "sha512-G965FqalsNyrPqgEGON7nIx1e/OVENSgiEIzyC63haUMuvNnwIgIjMs52hlTCKhkBny7A2ORNlfY9Zu+jmGk1Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/agent-base": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-6.0.2.tgz",
+      "integrity": "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 6.0.0"
+      }
+    },
+    "node_modules/aggregate-error": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/aggregate-error/-/aggregate-error-3.1.0.tgz",
+      "integrity": "sha512-4I7Td01quW/RpocfNayFdFVk1qSuoh0E7JrbRJ16nH01HhKFQ88INq9Sd+nd72zqRySlr9BmDA8xlEJ6vJMrYA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "clean-stack": "^2.0.0",
+        "indent-string": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/ajv": {
+      "version": "8.17.1",
+      "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.17.1.tgz",
+      "integrity": "sha512-B/gBuNg5SiMTrPkC+A2+cW0RszwxYmn6VYxB/inlBStS5nx6xHIt/ehKRhIMhqusl7a8LjQoZnjCs5vhwxOQ1g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "fast-deep-equal": "^3.1.3",
+        "fast-uri": "^3.0.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/epoberezkin"
+      }
+    },
+    "node_modules/amdefine": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/amdefine/-/amdefine-1.0.1.tgz",
+      "integrity": "sha512-S2Hw0TtNkMJhIabBwIojKL9YHO5T0n5eNqWJ7Lrlel/zDbftQpxpapi8tZs3X1HWa+u+QeydGmzzNU0m09+Rcg==",
+      "dev": true,
+      "license": "BSD-3-Clause OR MIT",
+      "optional": true,
+      "peer": true,
+      "engines": {
+        "node": ">=0.4.2"
+      }
+    },
+    "node_modules/ansi-align": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-align/-/ansi-align-3.0.1.tgz",
+      "integrity": "sha512-IOfwwBF5iczOjp/WeY4YxyjqAFMQoZufdQWDd19SEExbVLNXqvpzSJ/M7Za4/sCPmQ0+GRquoA7bGcINcxew6w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^4.1.0"
+      }
+    },
+    "node_modules/ansi-colors": {
+      "version": "4.1.3",
+      "resolved": "https://registry.npmjs.org/ansi-colors/-/ansi-colors-4.1.3.tgz",
+      "integrity": "sha512-/6w/C21Pm1A7aZitlI5Ni/2J6FFQN8i1Cvz3kHABAAbw93v/NlvKdVOqz7CCWz/3iv/JplRSEEZ83XION15ovw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/ansi-escapes": {
+      "version": "4.3.2",
+      "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-4.3.2.tgz",
+      "integrity": "sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "type-fest": "^0.21.3"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/ansi-regex": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz",
+      "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/ansi-styles": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+      "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-convert": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/ansi-styles?sponsor=1"
+      }
+    },
+    "node_modules/anymatch": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz",
+      "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "normalize-path": "^3.0.0",
+        "picomatch": "^2.0.4"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/arg": {
+      "version": "4.1.3",
+      "resolved": "https://registry.npmjs.org/arg/-/arg-4.1.3.tgz",
+      "integrity": "sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/argparse": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz",
+      "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==",
+      "dev": true,
+      "license": "Python-2.0"
+    },
+    "node_modules/array-back": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/array-back/-/array-back-3.1.0.tgz",
+      "integrity": "sha512-TkuxA4UCOvxuDK6NZYXCalszEzj+TLszyASooky+i742l9TqsOdYCMJJupxRic61hwquNtppB3hgcuq9SVSH1Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/array-union": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz",
+      "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/assertion-error": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-1.1.0.tgz",
+      "integrity": "sha512-jgsaNduz+ndvGyFt3uSuWqvy4lCnIJiovtouQN5JZHOKCS2QuhEdbcQHFhVksz2N2U9hXJo8odG7ETyWlEeuDw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/astral-regex": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/astral-regex/-/astral-regex-2.0.0.tgz",
+      "integrity": "sha512-Z7tMw1ytTXt5jqMcOP+OQteU1VuNK9Y02uuJtKQ1Sv69jXQKKg5cibLwGJow8yzZP+eAc18EmLGPal0bp36rvQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/async": {
+      "version": "1.5.2",
+      "resolved": "https://registry.npmjs.org/async/-/async-1.5.2.tgz",
+      "integrity": "sha512-nSVgobk4rv61R9PUSDtYt7mPVB2olxNR5RWJcAsH676/ef11bUZwvu7+RGYrYauVdDPcO519v68wRhXQtxsV9w==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/asynckit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+      "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/at-least-node": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/at-least-node/-/at-least-node-1.0.0.tgz",
+      "integrity": "sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/axios": {
+      "version": "1.10.0",
+      "resolved": "https://registry.npmjs.org/axios/-/axios-1.10.0.tgz",
+      "integrity": "sha512-/1xYAC4MP/HEG+3duIhFr4ZQXR4sQXOIe+o6sdqzeykGLx6Upp/1p8MHqhINOvGeP7xyNHe7tsiJByc4SSVUxw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "follow-redirects": "^1.15.6",
+        "form-data": "^4.0.0",
+        "proxy-from-env": "^1.1.0"
+      }
+    },
+    "node_modules/balanced-match": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz",
+      "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/base-x": {
+      "version": "3.0.10",
+      "resolved": "https://registry.npmjs.org/base-x/-/base-x-3.0.10.tgz",
+      "integrity": "sha512-7d0s06rR9rYaIWHkpfLIFICM/tkSVdoPC9qYAQRpxn9DdKNWNsKC0uk++akckyLq16Tx2WIinnZ6WRriAt6njQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "node_modules/binary-extensions": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz",
+      "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/blakejs": {
+      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/blakejs/-/blakejs-1.2.1.tgz",
+      "integrity": "sha512-QXUSXI3QVc/gJME0dBpXrag1kbzOqCjCX8/b54ntNyW6sjtoqxqRk3LTmXzaJoh71zMsDCjM+47jS7XiwN/+fQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/bn.js": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-5.2.1.tgz",
+      "integrity": "sha512-eXRvHzWyYPBuB4NBy0cmYQjGitUrtqwbvlzP3G6VFnNRbsZQIxQ10PbKKHt8gZ/HW/D/747aDl+QkDqg3KQLMQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/boxen": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/boxen/-/boxen-5.1.2.tgz",
+      "integrity": "sha512-9gYgQKXx+1nP8mP7CzFyaUARhg7D3n1dF/FnErWmu9l6JvGpNUN278h0aSb+QjoiKSWG+iZ3uHrcqk0qrY9RQQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-align": "^3.0.0",
+        "camelcase": "^6.2.0",
+        "chalk": "^4.1.0",
+        "cli-boxes": "^2.2.1",
+        "string-width": "^4.2.2",
+        "type-fest": "^0.20.2",
+        "widest-line": "^3.1.0",
+        "wrap-ansi": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/boxen/node_modules/type-fest": {
+      "version": "0.20.2",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.20.2.tgz",
+      "integrity": "sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/brace-expansion": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz",
+      "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "balanced-match": "^1.0.0"
+      }
+    },
+    "node_modules/braces": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",
+      "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fill-range": "^7.1.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/brorand": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/brorand/-/brorand-1.1.0.tgz",
+      "integrity": "sha512-cKV8tMCEpQs4hK/ik71d6LrPOnpkpGBR0wzxqr68g2m/LB2GxVYQroAjMJZRVM1Y4BCjCKc3vAamxSzOY2RP+w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/brotli-wasm": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/brotli-wasm/-/brotli-wasm-2.0.1.tgz",
+      "integrity": "sha512-+3USgYsC7bzb5yU0/p2HnnynZl0ak0E6uoIm4UW4Aby/8s8HFCq6NCfrrf1E9c3O8OCSzq3oYO1tUVqIi61Nww==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "peer": true
+    },
+    "node_modules/browser-stdout": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/browser-stdout/-/browser-stdout-1.3.1.tgz",
+      "integrity": "sha512-qhAVI1+Av2X7qelOfAIYwXONood6XlZE/fXaBSmW/T5SzLAmCgzi+eiWE7fUvbHaeNBQH13UftjpXxsfLkMpgw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/browserify-aes": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/browserify-aes/-/browserify-aes-1.2.0.tgz",
+      "integrity": "sha512-+7CHXqGuspUn/Sl5aO7Ea0xWGAtETPXNSAjHo48JfLdPWcMng33Xe4znFvQweqc/uzk5zSOI3H52CYnjCfb5hA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "buffer-xor": "^1.0.3",
+        "cipher-base": "^1.0.0",
+        "create-hash": "^1.1.0",
+        "evp_bytestokey": "^1.0.3",
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.0.1"
+      }
+    },
+    "node_modules/bs58": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/bs58/-/bs58-4.0.1.tgz",
+      "integrity": "sha512-Ok3Wdf5vOIlBrgCvTq96gBkJw+JUEzdBgyaza5HLtPm7yTHkjRy8+JzNyHF7BHa0bNWOQIp3m5YF0nnFcOIKLw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "base-x": "^3.0.2"
+      }
+    },
+    "node_modules/bs58check": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/bs58check/-/bs58check-2.1.2.tgz",
+      "integrity": "sha512-0TS1jicxdU09dwJMNZtVAfzPi6Q6QeN0pM1Fkzrjn+XYHvzMKPU3pHVpva+769iNVSfIYWf7LJ6WR+BuuMf8cA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bs58": "^4.0.0",
+        "create-hash": "^1.1.0",
+        "safe-buffer": "^5.1.2"
+      }
+    },
+    "node_modules/buffer-from": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz",
+      "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/buffer-xor": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/buffer-xor/-/buffer-xor-1.0.3.tgz",
+      "integrity": "sha512-571s0T7nZWK6vB67HI5dyUF7wXiNcfaPPPTl6zYCNApANjIvYJTg7hlud/+cJpdAhS7dVzqMLmfhfHR3rAcOjQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/bytes": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
+      "integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/camelcase": {
+      "version": "6.3.0",
+      "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-6.3.0.tgz",
+      "integrity": "sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/cbor": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/cbor/-/cbor-8.1.0.tgz",
+      "integrity": "sha512-DwGjNW9omn6EwP70aXsn7FQJx5kO12tX0bZkaTjzdVFM6/7nhA4t0EENocKGx6D2Bch9PE2KzCUf5SceBdeijg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "nofilter": "^3.1.0"
+      },
+      "engines": {
+        "node": ">=12.19"
+      }
+    },
+    "node_modules/chai": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/chai/-/chai-4.5.0.tgz",
+      "integrity": "sha512-RITGBfijLkBddZvnn8jdqoTypxvqbOLYQkGGxXzeFjVHvudaPw0HNFD9x928/eUwYWd2dPCugVqspGALTZZQKw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "assertion-error": "^1.1.0",
+        "check-error": "^1.0.3",
+        "deep-eql": "^4.1.3",
+        "get-func-name": "^2.0.2",
+        "loupe": "^2.3.6",
+        "pathval": "^1.1.1",
+        "type-detect": "^4.1.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/chai-as-promised": {
+      "version": "7.1.2",
+      "resolved": "https://registry.npmjs.org/chai-as-promised/-/chai-as-promised-7.1.2.tgz",
+      "integrity": "sha512-aBDHZxRzYnUYuIAIPBH2s511DjlKPzXNlXSGFC8CwmroWQLfrW0LtE1nK3MAwwNhJPa9raEjNCmRoFpG0Hurdw==",
+      "dev": true,
+      "license": "WTFPL",
+      "peer": true,
+      "dependencies": {
+        "check-error": "^1.0.2"
+      },
+      "peerDependencies": {
+        "chai": ">= 2.1.2 < 6"
+      }
+    },
+    "node_modules/chalk": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz",
+      "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.1.0",
+        "supports-color": "^7.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/chalk?sponsor=1"
+      }
+    },
+    "node_modules/charenc": {
+      "version": "0.0.2",
+      "resolved": "https://registry.npmjs.org/charenc/-/charenc-0.0.2.tgz",
+      "integrity": "sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/check-error": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/check-error/-/check-error-1.0.3.tgz",
+      "integrity": "sha512-iKEoDYaRmd1mxM90a2OEfWhjsjPpYPuQ+lMYsoxB126+t8fw7ySEO48nmDg5COTjxDI65/Y2OWpeEHk3ZOe8zg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "get-func-name": "^2.0.2"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/chokidar": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-4.0.3.tgz",
+      "integrity": "sha512-Qgzu8kfBvo+cA4962jnP1KkS6Dop5NS6g7R5LFYJr4b8Ub94PPQXUksCw9PvXoeXPRRddRNC5C1JQUR2SMGtnA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "readdirp": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 14.16.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ci-info": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ci-info/-/ci-info-2.0.0.tgz",
+      "integrity": "sha512-5tK7EtrZ0N+OLFMthtqOj4fI2Jeb88C4CAZPu25LDVUgXJ0A3Js4PMGqrn0JU1W0Mh1/Z8wZzYPxqUrXeBboCQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/cipher-base": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/cipher-base/-/cipher-base-1.0.6.tgz",
+      "integrity": "sha512-3Ek9H3X6pj5TgenXYtNWdaBon1tgYCaebd+XPg0keyjEbEfkD4KkmAxkQ/i1vYvxdcT5nscLBfq9VJRmCBcFSw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.4",
+        "safe-buffer": "^5.2.1"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/clean-stack": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/clean-stack/-/clean-stack-2.2.0.tgz",
+      "integrity": "sha512-4diC9HaTE+KRAMWhDhrGOECgWZxoevMc5TlkObMqNSsVU62PYzXZ/SMTjzyGAFF1YusgxGcSWTEXBhp0CPwQ1A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/cli-boxes": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/cli-boxes/-/cli-boxes-2.2.1.tgz",
+      "integrity": "sha512-y4coMcylgSCdVinjiDBuR8PCC2bLjyGTwEmPb9NHR/QaNU6EUOXcTY/s6VjGMD6ENSEaeQYHCY0GNGS5jfMwPw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/cli-table3": {
+      "version": "0.6.5",
+      "resolved": "https://registry.npmjs.org/cli-table3/-/cli-table3-0.6.5.tgz",
+      "integrity": "sha512-+W/5efTR7y5HRD7gACw9yQjqMVvEMLBHmboM/kPWam+H+Hmyrgjh6YncVKK122YZkXrLudzTuAukUw9FnMf7IQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "string-width": "^4.2.0"
+      },
+      "engines": {
+        "node": "10.* || >= 12.*"
+      },
+      "optionalDependencies": {
+        "@colors/colors": "1.5.0"
+      }
+    },
+    "node_modules/cliui": {
+      "version": "7.0.4",
+      "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz",
+      "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "string-width": "^4.2.0",
+        "strip-ansi": "^6.0.0",
+        "wrap-ansi": "^7.0.0"
+      }
+    },
+    "node_modules/color-convert": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+      "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "color-name": "~1.1.4"
+      },
+      "engines": {
+        "node": ">=7.0.0"
+      }
+    },
+    "node_modules/color-name": {
+      "version": "1.1.4",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+      "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/combined-stream": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+      "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "delayed-stream": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/command-exists": {
+      "version": "1.2.9",
+      "resolved": "https://registry.npmjs.org/command-exists/-/command-exists-1.2.9.tgz",
+      "integrity": "sha512-LTQ/SGc+s0Xc0Fu5WaKnR0YiygZkm9eKFvyS+fRsU7/ZWFF8ykFM6Pc9aCVf1+xasOOZpO3BAVgVrKvsqKHV7w==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/command-line-args": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/command-line-args/-/command-line-args-5.2.1.tgz",
+      "integrity": "sha512-H4UfQhZyakIjC74I9d34fGYDwk3XpSr17QhEd0Q3I9Xq1CETHo4Hcuo87WyWHpAF1aSLjLRf5lD9ZGX2qStUvg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "array-back": "^3.1.0",
+        "find-replace": "^3.0.0",
+        "lodash.camelcase": "^4.3.0",
+        "typical": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/command-line-usage": {
+      "version": "6.1.3",
+      "resolved": "https://registry.npmjs.org/command-line-usage/-/command-line-usage-6.1.3.tgz",
+      "integrity": "sha512-sH5ZSPr+7UStsloltmDh7Ce5fb8XPlHyoPzTpyyMuYCtervL65+ubVZ6Q61cFtFl62UyJlc8/JwERRbAFPUqgw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "array-back": "^4.0.2",
+        "chalk": "^2.4.2",
+        "table-layout": "^1.0.2",
+        "typical": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/ansi-styles": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+      "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-convert": "^1.9.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/array-back": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/array-back/-/array-back-4.0.2.tgz",
+      "integrity": "sha512-NbdMezxqf94cnNfWLL7V/im0Ub+Anbb0IoZhvzie8+4HJ4nMQuzHuy49FkGYCJK2yAloZ3meiB6AVMClbrI1vg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/chalk": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
+      "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^3.2.1",
+        "escape-string-regexp": "^1.0.5",
+        "supports-color": "^5.3.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/color-convert": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
+      "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-name": "1.1.3"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/color-name": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
+      "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/command-line-usage/node_modules/escape-string-regexp": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
+      "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/has-flag": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+      "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/supports-color": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
+      "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "has-flag": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/command-line-usage/node_modules/typical": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/typical/-/typical-5.2.0.tgz",
+      "integrity": "sha512-dvdQgNDNJo+8B2uBQoqdb11eUCE1JQXhvjC/CZtgvZseVd5TYMXnq0+vuUemXbd/Se29cTaUuPX3YIc2xgbvIg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/commander": {
+      "version": "8.3.0",
+      "resolved": "https://registry.npmjs.org/commander/-/commander-8.3.0.tgz",
+      "integrity": "sha512-OkTL9umf+He2DZkUq8f8J9of7yL6RJKI24dVITBmNfZBmri9zYZQrKkuXiKhyfPSu8tUhnVBB1iKXevvnlR4Ww==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 12"
+      }
+    },
+    "node_modules/concat-map": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz",
+      "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/cookie": {
+      "version": "0.4.2",
+      "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.4.2.tgz",
+      "integrity": "sha512-aSWTXFzaKWkvHO1Ny/s+ePFpvKsPnjc551iI41v3ny/ow6tBG5Vd+FuqGNhh1LxOmVzOlGUriIlOaokOvhaStA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/create-hash": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/create-hash/-/create-hash-1.2.0.tgz",
+      "integrity": "sha512-z00bCGNHDG8mHAkP7CtT1qVu+bFQUPjYq/4Iv3C3kWjTFV10zIjfSoeqXo9Asws8gwSHDGj/hl2u4OGIjapeCg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cipher-base": "^1.0.1",
+        "inherits": "^2.0.1",
+        "md5.js": "^1.3.4",
+        "ripemd160": "^2.0.1",
+        "sha.js": "^2.4.0"
+      }
+    },
+    "node_modules/create-hmac": {
+      "version": "1.1.7",
+      "resolved": "https://registry.npmjs.org/create-hmac/-/create-hmac-1.1.7.tgz",
+      "integrity": "sha512-MJG9liiZ+ogc4TzUwuvbER1JRdgvUFSB5+VR/g5h82fGaIRWMWddtKBHi7/sVhfjQZ6SehlyhvQYrcYkaUIpLg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cipher-base": "^1.0.3",
+        "create-hash": "^1.1.0",
+        "inherits": "^2.0.1",
+        "ripemd160": "^2.0.0",
+        "safe-buffer": "^5.0.1",
+        "sha.js": "^2.4.8"
+      }
+    },
+    "node_modules/create-require": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/create-require/-/create-require-1.1.1.tgz",
+      "integrity": "sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/cross-spawn": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz",
+      "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "path-key": "^3.1.0",
+        "shebang-command": "^2.0.0",
+        "which": "^2.0.1"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/cross-spawn/node_modules/which": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz",
+      "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "node-which": "bin/node-which"
+      },
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/crypt": {
+      "version": "0.0.2",
+      "resolved": "https://registry.npmjs.org/crypt/-/crypt-0.0.2.tgz",
+      "integrity": "sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/death": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/death/-/death-1.1.0.tgz",
+      "integrity": "sha512-vsV6S4KVHvTGxbEcij7hkWRv0It+sGGWVOM67dQde/o5Xjnr+KmLjxWJii2uEObIrt1CcM9w0Yaovx+iOlIL+w==",
+      "dev": true,
+      "peer": true
+    },
+    "node_modules/debug": {
+      "version": "4.4.0",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.0.tgz",
+      "integrity": "sha512-6WTZ/IxCY/T6BALoZHaE4ctp9xm+Z5kY/pzYaCHRFeyVhojxlrm+46y68HA6hr0TcwEssoxNiDEUJQjfPZ/RYA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/decamelize": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-4.0.0.tgz",
+      "integrity": "sha512-9iE1PgSik9HeIIw2JO94IidnE3eBoQrFJ3w7sFuzSX4DpmZ3v5sZpUiV5Swcf6mQEF+Y0ru8Neo+p+nyh2J+hQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/deep-eql": {
+      "version": "4.1.4",
+      "resolved": "https://registry.npmjs.org/deep-eql/-/deep-eql-4.1.4.tgz",
+      "integrity": "sha512-SUwdGfqdKOwxCPeVYjwSyRpJ7Z+fhpwIAtmCUdZIWZ/YP5R9WAsyuSgpLVDi9bjWoN2LXHNss/dk3urXtdQxGg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "type-detect": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/deep-extend": {
+      "version": "0.6.0",
+      "resolved": "https://registry.npmjs.org/deep-extend/-/deep-extend-0.6.0.tgz",
+      "integrity": "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/deep-is": {
+      "version": "0.1.4",
+      "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz",
+      "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/delayed-stream": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+      "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/depd": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
+      "integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/diff": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/diff/-/diff-5.2.0.tgz",
+      "integrity": "sha512-uIFDxqpRZGZ6ThOk84hEfqWoHx2devRFvpTZcTHur85vImfaxUbTW9Ryh4CpCuDnToOP1CEtXKIgytHBPVff5A==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.3.1"
+      }
+    },
+    "node_modules/difflib": {
+      "version": "0.2.4",
+      "resolved": "https://registry.npmjs.org/difflib/-/difflib-0.2.4.tgz",
+      "integrity": "sha512-9YVwmMb0wQHQNr5J9m6BSj6fk4pfGITGQOOs+D9Fl+INODWFOfvhIU1hNv6GgR1RBoC/9NJcwu77zShxV0kT7w==",
+      "dev": true,
+      "peer": true,
+      "dependencies": {
+        "heap": ">= 0.2.0"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/dir-glob": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz",
+      "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "path-type": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/eastasianwidth": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/eastasianwidth/-/eastasianwidth-0.2.0.tgz",
+      "integrity": "sha512-I88TYZWc9XiYHRQ4/3c5rjjfgkjhLyW2luGIheGERbNQ6OY7yTybanSpDXZa8y7VUP9YmDcYa+eyq4ca7iLqWA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/elliptic": {
+      "version": "6.5.4",
+      "resolved": "https://registry.npmjs.org/elliptic/-/elliptic-6.5.4.tgz",
+      "integrity": "sha512-iLhC6ULemrljPZb+QutR5TQGB+pdW6KGD5RSegS+8sorOZT+rdQFbsQFJgvN3eRqNALqJer4oQ16YvJHlU8hzQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bn.js": "^4.11.9",
+        "brorand": "^1.1.0",
+        "hash.js": "^1.0.0",
+        "hmac-drbg": "^1.0.1",
+        "inherits": "^2.0.4",
+        "minimalistic-assert": "^1.0.1",
+        "minimalistic-crypto-utils": "^1.0.1"
+      }
+    },
+    "node_modules/elliptic/node_modules/bn.js": {
+      "version": "4.12.1",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+      "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/emoji-regex": {
+      "version": "8.0.0",
+      "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+      "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/enquirer": {
+      "version": "2.4.1",
+      "resolved": "https://registry.npmjs.org/enquirer/-/enquirer-2.4.1.tgz",
+      "integrity": "sha512-rRqJg/6gd538VHvR3PSrdRBb/1Vy2YfzHqzvbhGIQpDRKIa4FgV/54b5Q1xYSxOOwKvjXweS26E0Q+nAMwp2pQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-colors": "^4.1.1",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8.6"
+      }
+    },
+    "node_modules/env-paths": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/env-paths/-/env-paths-2.2.1.tgz",
+      "integrity": "sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/escalade": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz",
+      "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/escape-string-regexp": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz",
+      "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/escodegen": {
+      "version": "1.8.1",
+      "resolved": "https://registry.npmjs.org/escodegen/-/escodegen-1.8.1.tgz",
+      "integrity": "sha512-yhi5S+mNTOuRvyW4gWlg5W1byMaQGWWSYHXsuFZ7GBo7tpyOwi2EdzMP/QWxh9hwkD2m+wDVHJsxhRIj+v/b/A==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "peer": true,
+      "dependencies": {
+        "esprima": "^2.7.1",
+        "estraverse": "^1.9.1",
+        "esutils": "^2.0.2",
+        "optionator": "^0.8.1"
+      },
+      "bin": {
+        "escodegen": "bin/escodegen.js",
+        "esgenerate": "bin/esgenerate.js"
+      },
+      "engines": {
+        "node": ">=0.12.0"
+      },
+      "optionalDependencies": {
+        "source-map": "~0.2.0"
+      }
+    },
+    "node_modules/esprima": {
+      "version": "2.7.3",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-2.7.3.tgz",
+      "integrity": "sha512-OarPfz0lFCiW4/AV2Oy1Rp9qu0iusTKqykwTspGCZtPxmF81JR4MmIebvF1F9+UOKth2ZubLQ4XGGaU+hSn99A==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "peer": true,
+      "bin": {
+        "esparse": "bin/esparse.js",
+        "esvalidate": "bin/esvalidate.js"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/estraverse": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-1.9.3.tgz",
+      "integrity": "sha512-25w1fMXQrGdoquWnScXZGckOv+Wes+JDnuN/+7ex3SauFRS72r2lFDec0EKPt2YD1wUJ/IrfEex+9yp4hfSOJA==",
+      "dev": true,
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/esutils": {
+      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz",
+      "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/ethereum-bloom-filters": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/ethereum-bloom-filters/-/ethereum-bloom-filters-1.2.0.tgz",
+      "integrity": "sha512-28hyiE7HVsWubqhpVLVmZXFd4ITeHi+BUu05o9isf0GUpMtzBUi+8/gFrGaGYzvGAJQmJ3JKj77Mk9G98T84rA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "^1.4.0"
+      }
+    },
+    "node_modules/ethereum-bloom-filters/node_modules/@noble/hashes": {
+      "version": "1.7.1",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.7.1.tgz",
+      "integrity": "sha512-B8XBPsn4vT/KJAGqDzbwztd+6Yte3P4V7iafm24bxgDe/mlRuK6xmWPuCNrKt2vDafZ8MfJLlchDG/vYafQEjQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ethereum-cryptography": {
+      "version": "0.1.3",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-0.1.3.tgz",
+      "integrity": "sha512-w8/4x1SGGzc+tO97TASLja6SLd3fRIK2tLVcV2Gx4IB21hE19atll5Cq9o3d0ZmAYC/8aw0ipieTSiekAea4SQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/pbkdf2": "^3.0.0",
+        "@types/secp256k1": "^4.0.1",
+        "blakejs": "^1.1.0",
+        "browserify-aes": "^1.2.0",
+        "bs58check": "^2.1.2",
+        "create-hash": "^1.2.0",
+        "create-hmac": "^1.1.7",
+        "hash.js": "^1.1.7",
+        "keccak": "^3.0.0",
+        "pbkdf2": "^3.0.17",
+        "randombytes": "^2.1.0",
+        "safe-buffer": "^5.1.2",
+        "scrypt-js": "^3.0.0",
+        "secp256k1": "^4.0.1",
+        "setimmediate": "^1.0.5"
+      }
+    },
+    "node_modules/ethereumjs-abi": {
+      "version": "0.6.8",
+      "resolved": "https://registry.npmjs.org/ethereumjs-abi/-/ethereumjs-abi-0.6.8.tgz",
+      "integrity": "sha512-Tx0r/iXI6r+lRsdvkFDlut0N08jWMnKRZ6Gkq+Nmw75lZe4e6o3EkSnkaBP5NF6+m5PTGAr9JP43N3LyeoglsA==",
+      "deprecated": "This library has been deprecated and usage is discouraged.",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bn.js": "^4.11.8",
+        "ethereumjs-util": "^6.0.0"
+      }
+    },
+    "node_modules/ethereumjs-abi/node_modules/@types/bn.js": {
+      "version": "4.11.6",
+      "resolved": "https://registry.npmjs.org/@types/bn.js/-/bn.js-4.11.6.tgz",
+      "integrity": "sha512-pqr857jrp2kPuO9uRjZ3PwnJTjoQy+fcdxvBTvHm6dkmEL9q+hDD/2j/0ELOBPtPnS8LjCX0gI9nbl8lVkadpg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@types/node": "*"
+      }
+    },
+    "node_modules/ethereumjs-abi/node_modules/bn.js": {
+      "version": "4.12.1",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+      "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/ethereumjs-abi/node_modules/ethereumjs-util": {
+      "version": "6.2.1",
+      "resolved": "https://registry.npmjs.org/ethereumjs-util/-/ethereumjs-util-6.2.1.tgz",
+      "integrity": "sha512-W2Ktez4L01Vexijrm5EB6w7dg4n/TgpoYU4avuT5T3Vmnw/eCRtiBrJfQYS/DCSvDIOLn2k57GcHdeBcgVxAqw==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "dependencies": {
+        "@types/bn.js": "^4.11.3",
+        "bn.js": "^4.11.0",
+        "create-hash": "^1.1.2",
+        "elliptic": "^6.5.2",
+        "ethereum-cryptography": "^0.1.3",
+        "ethjs-util": "0.1.6",
+        "rlp": "^2.2.3"
+      }
+    },
+    "node_modules/ethereumjs-util": {
+      "version": "7.1.5",
+      "resolved": "https://registry.npmjs.org/ethereumjs-util/-/ethereumjs-util-7.1.5.tgz",
+      "integrity": "sha512-SDl5kKrQAudFBUe5OJM9Ac6WmMyYmXX/6sTmLZ3ffG2eY6ZIGBes3pEDxNN6V72WyOw4CPD5RomKdsa8DAAwLg==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "peer": true,
+      "dependencies": {
+        "@types/bn.js": "^5.1.0",
+        "bn.js": "^5.1.2",
+        "create-hash": "^1.1.2",
+        "ethereum-cryptography": "^0.1.3",
+        "rlp": "^2.2.4"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/ethers": {
+      "version": "6.14.4",
+      "resolved": "https://registry.npmjs.org/ethers/-/ethers-6.14.4.tgz",
+      "integrity": "sha512-Jm/dzRs2Z9iBrT6e9TvGxyb5YVKAPLlpna7hjxH7KH/++DSh2T/JVmQUv7iHI5E55hDbp/gEVvstWYXVxXFzsA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/ethers-io/"
+        },
+        {
+          "type": "individual",
+          "url": "https://www.buymeacoffee.com/ricmoo"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@adraffy/ens-normalize": "1.10.1",
+        "@noble/curves": "1.2.0",
+        "@noble/hashes": "1.3.2",
+        "@types/node": "22.7.5",
+        "aes-js": "4.0.0-beta.5",
+        "tslib": "2.7.0",
+        "ws": "8.17.1"
+      },
+      "engines": {
+        "node": ">=14.0.0"
+      }
+    },
+    "node_modules/ethers/node_modules/@types/node": {
+      "version": "22.7.5",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-22.7.5.tgz",
+      "integrity": "sha512-jML7s2NAzMWc//QSJ1a3prpk78cOPchGvXJsC3C6R6PSMoooztvRVQEz89gmBTBY1SPMaqo5teB4uNHPdetShQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "undici-types": "~6.19.2"
+      }
+    },
+    "node_modules/ethers/node_modules/undici-types": {
+      "version": "6.19.8",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz",
+      "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/ethjs-unit": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/ethjs-unit/-/ethjs-unit-0.1.6.tgz",
+      "integrity": "sha512-/Sn9Y0oKl0uqQuvgFk/zQgR7aw1g36qX/jzSQ5lSwlO0GigPymk4eGQfeNTD03w1dPOqfz8V77Cy43jH56pagw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "bn.js": "4.11.6",
+        "number-to-bn": "1.7.0"
+      },
+      "engines": {
+        "node": ">=6.5.0",
+        "npm": ">=3"
+      }
+    },
+    "node_modules/ethjs-unit/node_modules/bn.js": {
+      "version": "4.11.6",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.11.6.tgz",
+      "integrity": "sha512-XWwnNNFCuuSQ0m3r3C4LE3EiORltHd9M05pq6FOlVeiophzRbMo50Sbz1ehl8K3Z+jw9+vmgnXefY1hz8X+2wA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/ethjs-util": {
+      "version": "0.1.6",
+      "resolved": "https://registry.npmjs.org/ethjs-util/-/ethjs-util-0.1.6.tgz",
+      "integrity": "sha512-CUnVOQq7gSpDHZVVrQW8ExxUETWrnrvXYvYz55wOU8Uj4VCgw56XC2B/fVqQN+f7gmrnRHSLVnFAwsCuNwji8w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-hex-prefixed": "1.0.0",
+        "strip-hex-prefix": "1.0.0"
+      },
+      "engines": {
+        "node": ">=6.5.0",
+        "npm": ">=3"
+      }
+    },
+    "node_modules/eventemitter3": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.1.tgz",
+      "integrity": "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/evp_bytestokey": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/evp_bytestokey/-/evp_bytestokey-1.0.3.tgz",
+      "integrity": "sha512-/f2Go4TognH/KvCISP7OUsHn85hT9nUkxxA9BEWxFn+Oj9o8ZNLm/40hdlgSLyuOimsrTKLUMEorQexp/aPQeA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "md5.js": "^1.3.4",
+        "safe-buffer": "^5.1.1"
+      }
+    },
+    "node_modules/fast-deep-equal": {
+      "version": "3.1.3",
+      "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
+      "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/fast-glob": {
+      "version": "3.3.3",
+      "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",
+      "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@nodelib/fs.stat": "^2.0.2",
+        "@nodelib/fs.walk": "^1.2.3",
+        "glob-parent": "^5.1.2",
+        "merge2": "^1.3.0",
+        "micromatch": "^4.0.8"
+      },
+      "engines": {
+        "node": ">=8.6.0"
+      }
+    },
+    "node_modules/fast-levenshtein": {
+      "version": "2.0.6",
+      "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz",
+      "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/fast-uri": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.0.6.tgz",
+      "integrity": "sha512-Atfo14OibSv5wAp4VWNsFYE1AchQRTv9cBGWET4pZWHzYshFSS9NQI6I57rdKn9croWVMbYFbLhJ+yJvmZIIHw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/fastify"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/fastify"
+        }
+      ],
+      "license": "BSD-3-Clause",
+      "peer": true
+    },
+    "node_modules/fastq": {
+      "version": "1.19.1",
+      "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz",
+      "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "reusify": "^1.0.4"
+      }
+    },
+    "node_modules/fill-range": {
+      "version": "7.1.1",
+      "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",
+      "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "to-regex-range": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/find-replace": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/find-replace/-/find-replace-3.0.0.tgz",
+      "integrity": "sha512-6Tb2myMioCAgv5kfvP5/PkZZ/ntTpVK39fHY7WkWBgvbeE+VHd/tZuZ4mrC+bxh4cfOZeYKVPaJIZtZXV7GNCQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "array-back": "^3.0.1"
+      },
+      "engines": {
+        "node": ">=4.0.0"
+      }
+    },
+    "node_modules/find-up": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz",
+      "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "locate-path": "^6.0.0",
+        "path-exists": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/flat": {
+      "version": "5.0.2",
+      "resolved": "https://registry.npmjs.org/flat/-/flat-5.0.2.tgz",
+      "integrity": "sha512-b6suED+5/3rTpUBdG1gupIl8MPFCAMA0QXwmljLhvCUKcUvdE4gWky9zpuGCcXHOsz4J9wPGNWq6OKpmIzz3hQ==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "bin": {
+        "flat": "cli.js"
+      }
+    },
+    "node_modules/follow-redirects": {
+      "version": "1.15.9",
+      "resolved": "https://registry.npmjs.org/follow-redirects/-/follow-redirects-1.15.9.tgz",
+      "integrity": "sha512-gew4GsXizNgdoRyqmyfMHyAmXsZDk6mHkSxZFCzW9gwlbtOW44CDtYavM+y+72qD/Vq2l550kMF52DT8fOLJqQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://github.com/sponsors/RubenVerborgh"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=4.0"
+      },
+      "peerDependenciesMeta": {
+        "debug": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/foreground-child": {
+      "version": "3.3.1",
+      "resolved": "https://registry.npmjs.org/foreground-child/-/foreground-child-3.3.1.tgz",
+      "integrity": "sha512-gIXjKqtFuWEgzFRJA9WCQeSJLZDjgJUOMCMzxtvFq/37KojM1BFGufqsCy0r4qSQmYLsZYMeyRqzIWOMup03sw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "cross-spawn": "^7.0.6",
+        "signal-exit": "^4.0.1"
+      },
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/form-data": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.3.tgz",
+      "integrity": "sha512-qsITQPfmvMOSAdeyZ+12I1c+CKSstAFAwu+97zrnWAbIr5u8wfsExUzCesVLC8NgHuRUqNN4Zy6UPWUTRGslcA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "asynckit": "^0.4.0",
+        "combined-stream": "^1.0.8",
+        "es-set-tostringtag": "^2.1.0",
+        "hasown": "^2.0.2",
+        "mime-types": "^2.1.12"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/fp-ts": {
+      "version": "1.19.3",
+      "resolved": "https://registry.npmjs.org/fp-ts/-/fp-ts-1.19.3.tgz",
+      "integrity": "sha512-H5KQDspykdHuztLTg+ajGN0Z2qUjcEf3Ybxc6hLt0k7/zPkn29XnKnxlBPyW2XIddWrGaJBzBl4VLYOtk39yZg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/fs-extra": {
+      "version": "10.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-10.1.0.tgz",
+      "integrity": "sha512-oRXApq54ETRj4eMiFzGnHWGy+zo5raudjuxN0b8H7s/RU2oW0Wvsx9O0ACRN/kRq9E8Vu/ReskGB5o3ji+FzHQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^6.0.1",
+        "universalify": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/fs.realpath": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz",
+      "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/fsevents": {
+      "version": "2.3.3",
+      "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
+      "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": "^8.16.0 || ^10.6.0 || >=11.0.0"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-caller-file": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+      "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": "6.* || 8.* || >= 10.*"
+      }
+    },
+    "node_modules/get-func-name": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/get-func-name/-/get-func-name-2.0.2.tgz",
+      "integrity": "sha512-8vXOvuE167CtIc3OyItco7N/dpRtBbYOsPsXCz7X/PMnlGjYjSGuZJgM1Y7mmew7BKf9BqvLX2tnOVy1BBUsxQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/ghost-testrpc": {
+      "version": "0.0.2",
+      "resolved": "https://registry.npmjs.org/ghost-testrpc/-/ghost-testrpc-0.0.2.tgz",
+      "integrity": "sha512-i08dAEgJ2g8z5buJIrCTduwPIhih3DP+hOCTyyryikfV8T0bNvHnGXO67i0DD1H4GBDETTclPy9njZbfluQYrQ==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "chalk": "^2.4.2",
+        "node-emoji": "^1.10.0"
+      },
+      "bin": {
+        "testrpc-sc": "index.js"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/ansi-styles": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+      "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-convert": "^1.9.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/chalk": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
+      "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^3.2.1",
+        "escape-string-regexp": "^1.0.5",
+        "supports-color": "^5.3.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/color-convert": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
+      "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-name": "1.1.3"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/color-name": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
+      "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/ghost-testrpc/node_modules/escape-string-regexp": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
+      "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/has-flag": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+      "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/ghost-testrpc/node_modules/supports-color": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
+      "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "has-flag": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/glob": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-8.1.0.tgz",
+      "integrity": "sha512-r8hpEjiQEYlF2QU0df3dS+nxxSIreXQS1qRhMJM0Q5NDdR386C7jb7Hwwod8Fgiuex+k0GFjgft18yvxm5XoCQ==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^5.0.1",
+        "once": "^1.3.0"
+      },
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/glob-parent": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
+      "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "is-glob": "^4.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/global-modules": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/global-modules/-/global-modules-2.0.0.tgz",
+      "integrity": "sha512-NGbfmJBp9x8IxyJSd1P+otYK8vonoJactOogrVfFRIAEY1ukil8RSKDz2Yo7wh1oihl51l/r6W4epkeKJHqL8A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "global-prefix": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/global-prefix": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/global-prefix/-/global-prefix-3.0.0.tgz",
+      "integrity": "sha512-awConJSVCHVGND6x3tmMaKcQvwXLhjdkmomy2W+Goaui8YPgYgXJZewhg3fWC+DlfqqQuWg8AwqjGTD2nAPVWg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ini": "^1.3.5",
+        "kind-of": "^6.0.2",
+        "which": "^1.3.1"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/globby": {
+      "version": "10.0.2",
+      "resolved": "https://registry.npmjs.org/globby/-/globby-10.0.2.tgz",
+      "integrity": "sha512-7dUi7RvCoT/xast/o/dLN53oqND4yk0nsHkhRgn9w65C4PofCLOoJ39iSOg+qVDdWQPIEj+eszMHQ+aLVwwQSg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/glob": "^7.1.1",
+        "array-union": "^2.1.0",
+        "dir-glob": "^3.0.1",
+        "fast-glob": "^3.0.3",
+        "glob": "^7.1.3",
+        "ignore": "^5.1.1",
+        "merge2": "^1.2.3",
+        "slash": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/globby/node_modules/brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/globby/node_modules/glob": {
+      "version": "7.2.3",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
+      "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^3.1.1",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/globby/node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/graceful-fs": {
+      "version": "4.2.11",
+      "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz",
+      "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/handlebars": {
+      "version": "4.7.8",
+      "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz",
+      "integrity": "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "minimist": "^1.2.5",
+        "neo-async": "^2.6.2",
+        "source-map": "^0.6.1",
+        "wordwrap": "^1.0.0"
+      },
+      "bin": {
+        "handlebars": "bin/handlebars"
+      },
+      "engines": {
+        "node": ">=0.4.7"
+      },
+      "optionalDependencies": {
+        "uglify-js": "^3.1.4"
+      }
+    },
+    "node_modules/handlebars/node_modules/source-map": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/hardhat": {
+      "version": "2.22.19",
+      "resolved": "https://registry.npmjs.org/hardhat/-/hardhat-2.22.19.tgz",
+      "integrity": "sha512-jptJR5o6MCgNbhd7eKa3mrteR+Ggq1exmE5RUL5ydQEVKcZm0sss5laa86yZ0ixIavIvF4zzS7TdGDuyopj0sQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@ethersproject/abi": "^5.1.2",
+        "@metamask/eth-sig-util": "^4.0.0",
+        "@nomicfoundation/edr": "^0.8.0",
+        "@nomicfoundation/ethereumjs-common": "4.0.4",
+        "@nomicfoundation/ethereumjs-tx": "5.0.4",
+        "@nomicfoundation/ethereumjs-util": "9.0.4",
+        "@nomicfoundation/solidity-analyzer": "^0.1.0",
+        "@sentry/node": "^5.18.1",
+        "@types/bn.js": "^5.1.0",
+        "@types/lru-cache": "^5.1.0",
+        "adm-zip": "^0.4.16",
+        "aggregate-error": "^3.0.0",
+        "ansi-escapes": "^4.3.0",
+        "boxen": "^5.1.2",
+        "chokidar": "^4.0.0",
+        "ci-info": "^2.0.0",
+        "debug": "^4.1.1",
+        "enquirer": "^2.3.0",
+        "env-paths": "^2.2.0",
+        "ethereum-cryptography": "^1.0.3",
+        "ethereumjs-abi": "^0.6.8",
+        "find-up": "^5.0.0",
+        "fp-ts": "1.19.3",
+        "fs-extra": "^7.0.1",
+        "immutable": "^4.0.0-rc.12",
+        "io-ts": "1.10.4",
+        "json-stream-stringify": "^3.1.4",
+        "keccak": "^3.0.2",
+        "lodash": "^4.17.11",
+        "mnemonist": "^0.38.0",
+        "mocha": "^10.0.0",
+        "p-map": "^4.0.0",
+        "picocolors": "^1.1.0",
+        "raw-body": "^2.4.1",
+        "resolve": "1.17.0",
+        "semver": "^6.3.0",
+        "solc": "0.8.26",
+        "source-map-support": "^0.5.13",
+        "stacktrace-parser": "^0.1.10",
+        "tinyglobby": "^0.2.6",
+        "tsort": "0.0.1",
+        "undici": "^5.14.0",
+        "uuid": "^8.3.2",
+        "ws": "^7.4.6"
+      },
+      "bin": {
+        "hardhat": "internal/cli/bootstrap.js"
+      },
+      "peerDependencies": {
+        "ts-node": "*",
+        "typescript": "*"
+      },
+      "peerDependenciesMeta": {
+        "ts-node": {
+          "optional": true
+        },
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/hardhat-gas-reporter": {
+      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/hardhat-gas-reporter/-/hardhat-gas-reporter-2.3.0.tgz",
+      "integrity": "sha512-ySdA+044xMQv1BlJu5CYXToHzMexKFfIWxlQTBNNoerx1x96+d15IMdN01iQZ/TJ7NH2V5sU73bz77LoS/PEVw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/abi": "^5.7.0",
+        "@ethersproject/bytes": "^5.7.0",
+        "@ethersproject/units": "^5.7.0",
+        "@solidity-parser/parser": "^0.20.1",
+        "axios": "^1.6.7",
+        "brotli-wasm": "^2.0.1",
+        "chalk": "4.1.2",
+        "cli-table3": "^0.6.3",
+        "ethereum-cryptography": "^2.1.3",
+        "glob": "^10.3.10",
+        "jsonschema": "^1.4.1",
+        "lodash": "^4.17.21",
+        "markdown-table": "2.0.0",
+        "sha1": "^1.1.1",
+        "viem": "^2.27.0"
+      },
+      "peerDependencies": {
+        "hardhat": "^2.16.0"
+      }
+    },
+    "node_modules/hardhat-gas-reporter/node_modules/@noble/curves": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.4.2.tgz",
+      "integrity": "sha512-TavHr8qycMChk8UwMld0ZDRvatedkzWfH8IiaeGCfymOP5i0hSCozz9vHOL0nkwk7HRMlFnAiKpS2jrUmSybcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.4.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/hardhat-gas-reporter/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/hardhat-gas-reporter/node_modules/ethereum-cryptography": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-2.2.1.tgz",
+      "integrity": "sha512-r/W8lkHSiTLxUxW8Rf3u4HGB0xQweG2RyETjywylKZSzLWoWAijRz8WCuOtJ6wah+avllXBqZuk29HCCvhEIRg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "1.4.2",
+        "@noble/hashes": "1.4.0",
+        "@scure/bip32": "1.4.0",
+        "@scure/bip39": "1.3.0"
+      }
+    },
+    "node_modules/hardhat-gas-reporter/node_modules/glob": {
+      "version": "10.4.5",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-10.4.5.tgz",
+      "integrity": "sha512-7Bv8RF0k6xjo7d4A/PxYLbUCfb6c+Vpd2/mB2yRDlew7Jb5hEXiCD9ibfO7wpk8i4sevK6DFny9h7EYbM3/sHg==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "foreground-child": "^3.1.0",
+        "jackspeak": "^3.1.2",
+        "minimatch": "^9.0.4",
+        "minipass": "^7.1.2",
+        "package-json-from-dist": "^1.0.0",
+        "path-scurry": "^1.11.1"
+      },
+      "bin": {
+        "glob": "dist/esm/bin.mjs"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/hardhat-gas-reporter/node_modules/minimatch": {
+      "version": "9.0.5",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-9.0.5.tgz",
+      "integrity": "sha512-G6T0ZX48xgozx7587koeX9Ys2NYy6Gmv//P89sEte9V9whIapMNF4idKxnW2QtCcLiTWlb/wfCabAtAFWhhBow==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/hardhat/node_modules/@noble/hashes": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.2.0.tgz",
+      "integrity": "sha512-FZfhjEDbT5GRswV3C6uvLPHMiVD6lQBmpoX5+eSiPaMTXte/IKqI5dykDxzZB/WBeK/CDuQRBWarPdi3FNY2zQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://paulmillr.com/funding/"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/hardhat/node_modules/@scure/bip32": {
+      "version": "1.1.5",
+      "resolved": "https://registry.npmjs.org/@scure/bip32/-/bip32-1.1.5.tgz",
+      "integrity": "sha512-XyNh1rB0SkEqd3tXcXMi+Xe1fvg+kUIcoRIEujP1Jgv7DqW2r9lg3Ah0NkFaCs9sTkQAQA8kw7xiRXzENi9Rtw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://paulmillr.com/funding/"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "~1.2.0",
+        "@noble/secp256k1": "~1.7.0",
+        "@scure/base": "~1.1.0"
+      }
+    },
+    "node_modules/hardhat/node_modules/@scure/bip39": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/@scure/bip39/-/bip39-1.1.1.tgz",
+      "integrity": "sha512-t+wDck2rVkh65Hmv280fYdVdY25J9YeEUIgn2LG1WM6gxFkGzcksoDiUkWVpVp3Oex9xGC68JU2dSbUfwZ2jPg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "individual",
+          "url": "https://paulmillr.com/funding/"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "~1.2.0",
+        "@scure/base": "~1.1.0"
+      }
+    },
+    "node_modules/hardhat/node_modules/ethereum-cryptography": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-1.2.0.tgz",
+      "integrity": "sha512-6yFQC9b5ug6/17CQpCyE3k9eKBMdhyVjzUy1WkiuY/E4vj/SXDBbCw8QEIaXqf0Mf2SnY6RmpDcwlUmBSS0EJw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@noble/hashes": "1.2.0",
+        "@noble/secp256k1": "1.7.1",
+        "@scure/bip32": "1.1.5",
+        "@scure/bip39": "1.1.1"
+      }
+    },
+    "node_modules/hardhat/node_modules/fs-extra": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-7.0.1.tgz",
+      "integrity": "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "graceful-fs": "^4.1.2",
+        "jsonfile": "^4.0.0",
+        "universalify": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=6 <7 || >=8"
+      }
+    },
+    "node_modules/hardhat/node_modules/jsonfile": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
+      "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
+      "dev": true,
+      "license": "MIT",
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/hardhat/node_modules/universalify": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
+      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/hardhat/node_modules/ws": {
+      "version": "7.5.10",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.10.tgz",
+      "integrity": "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.3.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": "^5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/has-flag": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+      "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "has-symbols": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hash-base": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/hash-base/-/hash-base-3.1.0.tgz",
+      "integrity": "sha512-1nmYp/rhMDiE7AYkDw+lLwlAzz0AntGIe51F3RfFfEqyQ3feY2eI/NcwC6umIQVOASPMsWJLJScWKSSvzL9IVA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.4",
+        "readable-stream": "^3.6.0",
+        "safe-buffer": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/hash.js": {
+      "version": "1.1.7",
+      "resolved": "https://registry.npmjs.org/hash.js/-/hash.js-1.1.7.tgz",
+      "integrity": "sha512-taOaskGt4z4SOANNseOviYDvjEJinIkRgmp7LbKP2YTTmVxWBl87s/uzK9r+44BclBSp2X7K1hqeNfz9JbBeXA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "minimalistic-assert": "^1.0.1"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/he": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/he/-/he-1.2.0.tgz",
+      "integrity": "sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "he": "bin/he"
+      }
+    },
+    "node_modules/heap": {
+      "version": "0.2.7",
+      "resolved": "https://registry.npmjs.org/heap/-/heap-0.2.7.tgz",
+      "integrity": "sha512-2bsegYkkHO+h/9MGbn6KWcE45cHZgPANo5LXF7EvWdT0yT2EguSVO1nDgU5c8+ZOPwp2vMNa7YFsJhVcDR9Sdg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/hmac-drbg": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/hmac-drbg/-/hmac-drbg-1.0.1.tgz",
+      "integrity": "sha512-Tti3gMqLdZfhOQY1Mzf/AanLiqh1WTiJgEj26ZuYQ9fbkLomzGchCws4FyrSd4VkpBfiNhaE1On+lOz894jvXg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "hash.js": "^1.0.3",
+        "minimalistic-assert": "^1.0.0",
+        "minimalistic-crypto-utils": "^1.0.1"
+      }
+    },
+    "node_modules/http-errors": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.0.tgz",
+      "integrity": "sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "depd": "2.0.0",
+        "inherits": "2.0.4",
+        "setprototypeof": "1.2.0",
+        "statuses": "2.0.1",
+        "toidentifier": "1.0.1"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/https-proxy-agent": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-5.0.1.tgz",
+      "integrity": "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "6",
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.4.24",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
+      "integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/ignore": {
+      "version": "5.3.2",
+      "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",
+      "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 4"
+      }
+    },
+    "node_modules/immer": {
+      "version": "10.0.2",
+      "resolved": "https://registry.npmjs.org/immer/-/immer-10.0.2.tgz",
+      "integrity": "sha512-Rx3CqeqQ19sxUtYV9CU911Vhy8/721wRFnJv3REVGWUmoAcIwzifTsdmJte/MV+0/XpM35LZdQMBGkRIoLPwQA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "type": "opencollective",
+        "url": "https://opencollective.com/immer"
+      }
+    },
+    "node_modules/immutable": {
+      "version": "4.3.7",
+      "resolved": "https://registry.npmjs.org/immutable/-/immutable-4.3.7.tgz",
+      "integrity": "sha512-1hqclzwYwjRDFLjcFxOM5AYkkG0rpFPpr1RLPMEuGczoS7YA8gLhy8SWXYRAA/XwfEHpfo3cw5JGioS32fnMRw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/indent-string": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/indent-string/-/indent-string-4.0.0.tgz",
+      "integrity": "sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/inflight": {
+      "version": "1.0.6",
+      "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz",
+      "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==",
+      "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "once": "^1.3.0",
+        "wrappy": "1"
+      }
+    },
+    "node_modules/inherits": {
+      "version": "2.0.4",
+      "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
+      "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/ini": {
+      "version": "1.3.8",
+      "resolved": "https://registry.npmjs.org/ini/-/ini-1.3.8.tgz",
+      "integrity": "sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/interpret": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/interpret/-/interpret-1.4.0.tgz",
+      "integrity": "sha512-agE4QfB2Lkp9uICn7BAqoscw4SZP9kTE2hxiFI3jBPmXJfdqiahTbUuKGsMoN2GtqL9AxhYioAcVvgsb1HvRbA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/io-ts": {
+      "version": "1.10.4",
+      "resolved": "https://registry.npmjs.org/io-ts/-/io-ts-1.10.4.tgz",
+      "integrity": "sha512-b23PteSnYXSONJ6JQXRAlvJhuw8KOtkqa87W4wDtvMrud/DTJd5X+NpOOI+O/zZwVq6v0VLAaJ+1EDViKEuN9g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fp-ts": "^1.0.0"
+      }
+    },
+    "node_modules/is-binary-path": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz",
+      "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "binary-extensions": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-extglob": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz",
+      "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-fullwidth-code-point": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+      "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-glob": {
+      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",
+      "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-extglob": "^2.1.1"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-hex-prefixed": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/is-hex-prefixed/-/is-hex-prefixed-1.0.0.tgz",
+      "integrity": "sha512-WvtOiug1VFrE9v1Cydwm+FnXd3+w9GaeVUss5W4v/SLy3UW00vP+6iNF2SdnfiBoLy4bTqVdkftNGTUeOFVsbA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6.5.0",
+        "npm": ">=3"
+      }
+    },
+    "node_modules/is-number": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",
+      "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.12.0"
+      }
+    },
+    "node_modules/is-plain-obj": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-2.1.0.tgz",
+      "integrity": "sha512-YWnfyRwxL/+SsrWYfOpUtz5b3YD+nyfkHvjbcanzk8zgyO4ASD67uVMRt8k5bM4lLMDnXfriRhOpemw+NfT1eA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/is-unicode-supported": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/is-unicode-supported/-/is-unicode-supported-0.1.0.tgz",
+      "integrity": "sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/isexe": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz",
+      "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/isows": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/isows/-/isows-1.0.7.tgz",
+      "integrity": "sha512-I1fSfDCZL5P0v33sVqeTDSpcstAg/N+wF5HS033mogOVIp4B+oHC7oOCsA3axAbBSGTJ8QubbNmnIRN/h8U7hg==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/wevm"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "peerDependencies": {
+        "ws": "*"
+      }
+    },
+    "node_modules/jackspeak": {
+      "version": "3.4.3",
+      "resolved": "https://registry.npmjs.org/jackspeak/-/jackspeak-3.4.3.tgz",
+      "integrity": "sha512-OGlZQpz2yfahA/Rd1Y8Cd9SIEsqvXkLVoSw/cgwhnhFMDbsQFeZYoJJ7bIZBS9BcamUW96asq/npPWugM+RQBw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "peer": true,
+      "dependencies": {
+        "@isaacs/cliui": "^8.0.2"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      },
+      "optionalDependencies": {
+        "@pkgjs/parseargs": "^0.11.0"
+      }
+    },
+    "node_modules/js-sha3": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/js-sha3/-/js-sha3-0.8.0.tgz",
+      "integrity": "sha512-gF1cRrHhIzNfToc802P800N8PpXS+evLLXfsVpowqmAFR9uwbi89WvXg2QspOmXL8QL86J4T1EpFu+yUkwJY3Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/js-yaml": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz",
+      "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "argparse": "^2.0.1"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/json-stream-stringify": {
+      "version": "3.1.6",
+      "resolved": "https://registry.npmjs.org/json-stream-stringify/-/json-stream-stringify-3.1.6.tgz",
+      "integrity": "sha512-x7fpwxOkbhFCaJDJ8vb1fBY3DdSa4AlITaz+HHILQJzdPMnHEFjxPwVUi1ALIbcIxDE0PNe/0i7frnY8QnBQog==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=7.10.1"
+      }
+    },
+    "node_modules/json-stringify-safe": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/json-stringify-safe/-/json-stringify-safe-5.0.1.tgz",
+      "integrity": "sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/json5": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/json5/-/json5-2.2.3.tgz",
+      "integrity": "sha512-XmOWe7eyHYH14cLdVPoyg+GOH3rYX++KpzrylJwSW98t3Nk+U8XOl8FWKOgwtzdb8lXGf6zYwDUzeHMWfxasyg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "bin": {
+        "json5": "lib/cli.js"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/jsonfile": {
+      "version": "6.1.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-6.1.0.tgz",
+      "integrity": "sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "universalify": "^2.0.0"
+      },
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/jsonschema": {
+      "version": "1.5.0",
+      "resolved": "https://registry.npmjs.org/jsonschema/-/jsonschema-1.5.0.tgz",
+      "integrity": "sha512-K+A9hhqbn0f3pJX17Q/7H6yQfD/5OXgdrR5UE12gMXCiN9D5Xq2o5mddV2QEcX/bjla99ASsAAQUyMCCRWAEhw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/keccak": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/keccak/-/keccak-3.0.4.tgz",
+      "integrity": "sha512-3vKuW0jV8J3XNTzvfyicFR5qvxrSAGl7KIhvgOu5cmWwM7tZRj3fMbj/pfIf4be7aznbc+prBWGjywox/g2Y6Q==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "dependencies": {
+        "node-addon-api": "^2.0.0",
+        "node-gyp-build": "^4.2.0",
+        "readable-stream": "^3.6.0"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/kind-of": {
+      "version": "6.0.3",
+      "resolved": "https://registry.npmjs.org/kind-of/-/kind-of-6.0.3.tgz",
+      "integrity": "sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/kleur": {
+      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/kleur/-/kleur-3.0.3.tgz",
+      "integrity": "sha512-eTIzlVOSUR+JxdDFepEYcBMtZ9Qqdef+rnzWdRZuMbOywu5tO2w2N7rqjoANZ5k9vywhL6Br1VRjUIgTQx4E8w==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/levn": {
+      "version": "0.3.0",
+      "resolved": "https://registry.npmjs.org/levn/-/levn-0.3.0.tgz",
+      "integrity": "sha512-0OO4y2iOHix2W6ujICbKIaEQXvFQHue65vUG3pb5EUomzPI90z9hsA1VsO/dbIIpC53J8gxM9Q4Oho0jrCM/yA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "prelude-ls": "~1.1.2",
+        "type-check": "~0.3.2"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/locate-path": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz",
+      "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "p-locate": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/lodash": {
+      "version": "4.17.21",
+      "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz",
+      "integrity": "sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lodash.camelcase": {
+      "version": "4.3.0",
+      "resolved": "https://registry.npmjs.org/lodash.camelcase/-/lodash.camelcase-4.3.0.tgz",
+      "integrity": "sha512-TwuEnCnxbc3rAvhf/LbG7tJUDzhqXyFnv3dtzLOPgCG/hODL7WFnsbwktkD7yUV0RrreP/l1PALq/YSg6VvjlA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/lodash.clonedeep": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/lodash.clonedeep/-/lodash.clonedeep-4.5.0.tgz",
+      "integrity": "sha512-H5ZhCF25riFd9uB5UCkVKo61m3S/xZk1x4wA6yp/L3RFP6Z/eHH1ymQcGLo7J3GMPfm0V/7m1tryHuGVxpqEBQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/lodash.isequal": {
+      "version": "4.5.0",
+      "resolved": "https://registry.npmjs.org/lodash.isequal/-/lodash.isequal-4.5.0.tgz",
+      "integrity": "sha512-pDo3lu8Jhfjqls6GkMgpahsF9kCyayhgykjyLMNFTKWrpVdAQtYyB4muAMWozBB4ig/dtWAmsMxLEI8wuz+DYQ==",
+      "deprecated": "This package is deprecated. Use require('node:util').isDeepStrictEqual instead.",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/lodash.truncate": {
+      "version": "4.4.2",
+      "resolved": "https://registry.npmjs.org/lodash.truncate/-/lodash.truncate-4.4.2.tgz",
+      "integrity": "sha512-jttmRe7bRse52OsWIMDLaXxWqRAmtIUccAQ3garviCqJjafXOfNMO0yMfNpdD6zbGaTU0P5Nz7e7gAT6cKmJRw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/log-symbols": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/log-symbols/-/log-symbols-4.1.0.tgz",
+      "integrity": "sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "chalk": "^4.1.0",
+        "is-unicode-supported": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/loupe": {
+      "version": "2.3.7",
+      "resolved": "https://registry.npmjs.org/loupe/-/loupe-2.3.7.tgz",
+      "integrity": "sha512-zSMINGVYkdpYSOBmLi0D1Uo7JU9nVdQKrHxC8eYlV+9YKK9WePqAlL7lSlorG/U2Fw1w0hTBmaa/jrQ3UbPHtA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "get-func-name": "^2.0.1"
+      }
+    },
+    "node_modules/lru_map": {
+      "version": "0.3.3",
+      "resolved": "https://registry.npmjs.org/lru_map/-/lru_map-0.3.3.tgz",
+      "integrity": "sha512-Pn9cox5CsMYngeDbmChANltQl+5pi6XmTrraMSzhPmMBbmgcxmqWry0U3PGapCU1yB4/LqCcom7qhHZiF/jGfQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/lru-cache": {
+      "version": "10.4.3",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
+      "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/make-error": {
+      "version": "1.3.6",
+      "resolved": "https://registry.npmjs.org/make-error/-/make-error-1.3.6.tgz",
+      "integrity": "sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true
+    },
+    "node_modules/markdown-table": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/markdown-table/-/markdown-table-2.0.0.tgz",
+      "integrity": "sha512-Ezda85ToJUBhM6WGaG6veasyym+Tbs3cMAw/ZhOPqXiYsr0jgocBV3j3nx+4lk47plLlIqjwuTm/ywVI+zjJ/A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "repeat-string": "^1.0.0"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/wooorm"
+      }
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/md5.js": {
+      "version": "1.3.5",
+      "resolved": "https://registry.npmjs.org/md5.js/-/md5.js-1.3.5.tgz",
+      "integrity": "sha512-xitP+WxNPcTTOgnTJcrhM0xvdPepipPSf3I8EIpGKeFLjt3PlJLIDG3u8EX53ZIubkb+5U2+3rELYpEhHhzdkg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "hash-base": "^3.0.0",
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.1.2"
+      }
+    },
+    "node_modules/memorystream": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/memorystream/-/memorystream-0.3.1.tgz",
+      "integrity": "sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw==",
+      "dev": true,
+      "engines": {
+        "node": ">= 0.10.0"
+      }
+    },
+    "node_modules/merge2": {
+      "version": "1.4.1",
+      "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",
+      "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 8"
+      }
+    },
+    "node_modules/micro-ftch": {
+      "version": "0.3.1",
+      "resolved": "https://registry.npmjs.org/micro-ftch/-/micro-ftch-0.3.1.tgz",
+      "integrity": "sha512-/0LLxhzP0tfiR5hcQebtudP56gUurs2CLkGarnCiB/OqEyUFQ6U3paQi/tgLv0hBJYt2rnr9MNpxz4fiiugstg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/micromatch": {
+      "version": "4.0.8",
+      "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",
+      "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "braces": "^3.0.3",
+        "picomatch": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=8.6"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/minimalistic-assert": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz",
+      "integrity": "sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/minimalistic-crypto-utils": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/minimalistic-crypto-utils/-/minimalistic-crypto-utils-1.0.1.tgz",
+      "integrity": "sha512-JIYlbt6g8i5jKfJ3xz7rF0LXmv2TkDxBLUkiBeZ7bAx4GnnNMr8xFpGnOxn6GhTEHx3SjRrZEoU+j04prX1ktg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/minimatch": {
+      "version": "5.1.6",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.6.tgz",
+      "integrity": "sha512-lKwV/1brpG6mBUFHtb7NUmtABCb2WZZmm2wNiOA5hAb8VdCS4B3dtMWyvcoViccwAW/COERjXLt0zP1zXUN26g==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "brace-expansion": "^2.0.1"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/minimist": {
+      "version": "1.2.8",
+      "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz",
+      "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/minipass": {
+      "version": "7.1.2",
+      "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.2.tgz",
+      "integrity": "sha512-qOOzS1cBTWYF4BH8fVePDBOO9iptMnGUEZwNc/cMWnTV2nVLZ7VoNWEPHkYczZA0pdoA7dl6e7FL659nX9S2aw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "engines": {
+        "node": ">=16 || 14 >=14.17"
+      }
+    },
+    "node_modules/mkdirp": {
+      "version": "0.5.6",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz",
+      "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "minimist": "^1.2.6"
+      },
+      "bin": {
+        "mkdirp": "bin/cmd.js"
+      }
+    },
+    "node_modules/mnemonist": {
+      "version": "0.38.5",
+      "resolved": "https://registry.npmjs.org/mnemonist/-/mnemonist-0.38.5.tgz",
+      "integrity": "sha512-bZTFT5rrPKtPJxj8KSV0WkPyNxl72vQepqqVUAW2ARUpUSF2qXMB6jZj7hW5/k7C1rtpzqbD/IIbJwLXUjCHeg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "obliterator": "^2.0.0"
+      }
+    },
+    "node_modules/mocha": {
+      "version": "10.8.2",
+      "resolved": "https://registry.npmjs.org/mocha/-/mocha-10.8.2.tgz",
+      "integrity": "sha512-VZlYo/WE8t1tstuRmqgeyBgCbJc/lEdopaa+axcKzTBJ+UIdlAB9XnmvTCAH4pwR4ElNInaedhEBmZD8iCSVEg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-colors": "^4.1.3",
+        "browser-stdout": "^1.3.1",
+        "chokidar": "^3.5.3",
+        "debug": "^4.3.5",
+        "diff": "^5.2.0",
+        "escape-string-regexp": "^4.0.0",
+        "find-up": "^5.0.0",
+        "glob": "^8.1.0",
+        "he": "^1.2.0",
+        "js-yaml": "^4.1.0",
+        "log-symbols": "^4.1.0",
+        "minimatch": "^5.1.6",
+        "ms": "^2.1.3",
+        "serialize-javascript": "^6.0.2",
+        "strip-json-comments": "^3.1.1",
+        "supports-color": "^8.1.1",
+        "workerpool": "^6.5.1",
+        "yargs": "^16.2.0",
+        "yargs-parser": "^20.2.9",
+        "yargs-unparser": "^2.0.0"
+      },
+      "bin": {
+        "_mocha": "bin/_mocha",
+        "mocha": "bin/mocha.js"
+      },
+      "engines": {
+        "node": ">= 14.0.0"
+      }
+    },
+    "node_modules/mocha/node_modules/chokidar": {
+      "version": "3.6.0",
+      "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz",
+      "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "anymatch": "~3.1.2",
+        "braces": "~3.0.2",
+        "glob-parent": "~5.1.2",
+        "is-binary-path": "~2.1.0",
+        "is-glob": "~4.0.1",
+        "normalize-path": "~3.0.0",
+        "readdirp": "~3.6.0"
+      },
+      "engines": {
+        "node": ">= 8.10.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      },
+      "optionalDependencies": {
+        "fsevents": "~2.3.2"
+      }
+    },
+    "node_modules/mocha/node_modules/readdirp": {
+      "version": "3.6.0",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz",
+      "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "picomatch": "^2.2.1"
+      },
+      "engines": {
+        "node": ">=8.10.0"
+      }
+    },
+    "node_modules/mocha/node_modules/supports-color": {
+      "version": "8.1.1",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-8.1.1.tgz",
+      "integrity": "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/supports-color?sponsor=1"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/ndjson": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/ndjson/-/ndjson-2.0.0.tgz",
+      "integrity": "sha512-nGl7LRGrzugTtaFcJMhLbpzJM6XdivmbkdlaGcrk/LXg2KL/YBC6z1g70xh0/al+oFuVFP8N8kiWRucmeEH/qQ==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "dependencies": {
+        "json-stringify-safe": "^5.0.1",
+        "minimist": "^1.2.5",
+        "readable-stream": "^3.6.0",
+        "split2": "^3.0.0",
+        "through2": "^4.0.0"
+      },
+      "bin": {
+        "ndjson": "cli.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/neo-async": {
+      "version": "2.6.2",
+      "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz",
+      "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/node-addon-api": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-2.0.2.tgz",
+      "integrity": "sha512-Ntyt4AIXyaLIuMHF6IOoTakB3K+RWxwtsHNRxllEoA6vPwP9o4866g6YWDLUdnucilZhmkxiHwHr11gAENw+QA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/node-emoji": {
+      "version": "1.11.0",
+      "resolved": "https://registry.npmjs.org/node-emoji/-/node-emoji-1.11.0.tgz",
+      "integrity": "sha512-wo2DpQkQp7Sjm2A0cq+sN7EHKO6Sl0ctXeBdFZrL9T9+UywORbufTcTZxom8YqpLQt/FqNMUkOpkZrJVYSKD3A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "lodash": "^4.17.21"
+      }
+    },
+    "node_modules/node-gyp-build": {
+      "version": "4.8.4",
+      "resolved": "https://registry.npmjs.org/node-gyp-build/-/node-gyp-build-4.8.4.tgz",
+      "integrity": "sha512-LA4ZjwlnUblHVgq0oBF3Jl/6h/Nvs5fzBLwdEF4nuxnFdsfajde4WfxtJr3CaiH+F6ewcIB/q4jQ4UzPyid+CQ==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "node-gyp-build": "bin.js",
+        "node-gyp-build-optional": "optional.js",
+        "node-gyp-build-test": "build-test.js"
+      }
+    },
+    "node_modules/nofilter": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/nofilter/-/nofilter-3.1.0.tgz",
+      "integrity": "sha512-l2NNj07e9afPnhAhvgVrCD/oy2Ai1yfLpuo3EpiO1jFTsB4sFz6oIfAfSZyQzVpkZQ9xS8ZS5g1jCBgq4Hwo0g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=12.19"
+      }
+    },
+    "node_modules/nopt": {
+      "version": "3.0.6",
+      "resolved": "https://registry.npmjs.org/nopt/-/nopt-3.0.6.tgz",
+      "integrity": "sha512-4GUt3kSEYmk4ITxzB/b9vaIDfUVWN/Ml1Fwl11IlnIG2iaJ9O6WXZ9SrYM9NLI8OCBieN2Y8SWC2oJV0RQ7qYg==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "abbrev": "1"
+      },
+      "bin": {
+        "nopt": "bin/nopt.js"
+      }
+    },
+    "node_modules/normalize-path": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz",
+      "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/number-to-bn": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/number-to-bn/-/number-to-bn-1.7.0.tgz",
+      "integrity": "sha512-wsJ9gfSz1/s4ZsJN01lyonwuxA1tml6X1yBDnfpMglypcBRFZZkus26EdPSlqS5GJfYddVZa22p3VNb3z5m5Ig==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "bn.js": "4.11.6",
+        "strip-hex-prefix": "1.0.0"
+      },
+      "engines": {
+        "node": ">=6.5.0",
+        "npm": ">=3"
+      }
+    },
+    "node_modules/number-to-bn/node_modules/bn.js": {
+      "version": "4.11.6",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.11.6.tgz",
+      "integrity": "sha512-XWwnNNFCuuSQ0m3r3C4LE3EiORltHd9M05pq6FOlVeiophzRbMo50Sbz1ehl8K3Z+jw9+vmgnXefY1hz8X+2wA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/obliterator": {
+      "version": "2.0.5",
+      "resolved": "https://registry.npmjs.org/obliterator/-/obliterator-2.0.5.tgz",
+      "integrity": "sha512-42CPE9AhahZRsMNslczq0ctAEtqk8Eka26QofnqC346BZdHDySk3LWka23LI7ULIw11NmltpiLagIq8gBozxTw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/once": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz",
+      "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "wrappy": "1"
+      }
+    },
+    "node_modules/optionator": {
+      "version": "0.8.3",
+      "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.8.3.tgz",
+      "integrity": "sha512-+IW9pACdk3XWmmTXG8m3upGUJst5XRGzxMRjXzAuJ1XnIFNvfhjjIuYkDvysnPQ7qzqVzLt78BCruntqRhWQbA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "deep-is": "~0.1.3",
+        "fast-levenshtein": "~2.0.6",
+        "levn": "~0.3.0",
+        "prelude-ls": "~1.1.2",
+        "type-check": "~0.3.2",
+        "word-wrap": "~1.2.3"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/ordinal": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/ordinal/-/ordinal-1.0.3.tgz",
+      "integrity": "sha512-cMddMgb2QElm8G7vdaa02jhUNbTSrhsgAGUz1OokD83uJTwSUn+nKoNoKVVaRa08yF6sgfO7Maou1+bgLd9rdQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/os-tmpdir": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz",
+      "integrity": "sha512-D2FR03Vir7FIu45XBY20mTb+/ZSWB00sjU9jdQXt83gDrI4Ztz5Fs7/yy74g2N5SVQY4xY1qDr4rNddwYRVX0g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/ox": {
+      "version": "0.8.1",
+      "resolved": "https://registry.npmjs.org/ox/-/ox-0.8.1.tgz",
+      "integrity": "sha512-e+z5epnzV+Zuz91YYujecW8cF01mzmrUtWotJ0oEPym/G82uccs7q0WDHTYL3eiONbTUEvcZrptAKLgTBD3u2A==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/wevm"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@adraffy/ens-normalize": "^1.11.0",
+        "@noble/ciphers": "^1.3.0",
+        "@noble/curves": "^1.9.1",
+        "@noble/hashes": "^1.8.0",
+        "@scure/bip32": "^1.7.0",
+        "@scure/bip39": "^1.6.0",
+        "abitype": "^1.0.8",
+        "eventemitter3": "5.0.1"
+      },
+      "peerDependencies": {
+        "typescript": ">=5.4.0"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ox/node_modules/@adraffy/ens-normalize": {
+      "version": "1.11.0",
+      "resolved": "https://registry.npmjs.org/@adraffy/ens-normalize/-/ens-normalize-1.11.0.tgz",
+      "integrity": "sha512-/3DDPKHqqIqxUULp8yP4zODUY1i+2xvVWsv8A79xGWdCAG+8sb0hRh0Rk2QyOJUnnbyPUAZYcpBuRe3nS2OIUg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/ox/node_modules/@noble/curves": {
+      "version": "1.9.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.9.2.tgz",
+      "integrity": "sha512-HxngEd2XUcg9xi20JkwlLCtYwfoFw4JGkuZpT+WlsPD4gB/cxkvTD8fSsoAnphGZhFdZYKeQIPCuFlWPm1uE0g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.8.0"
+      },
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ox/node_modules/@noble/hashes": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz",
+      "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ox/node_modules/@scure/base": {
+      "version": "1.2.6",
+      "resolved": "https://registry.npmjs.org/@scure/base/-/base-1.2.6.tgz",
+      "integrity": "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ox/node_modules/@scure/bip32": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip32/-/bip32-1.7.0.tgz",
+      "integrity": "sha512-E4FFX/N3f4B80AKWp5dP6ow+flD1LQZo/w8UnLGYZO674jS6YnYeepycOOksv+vLPSpgN35wgKgy+ybfTb2SMw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "~1.9.0",
+        "@noble/hashes": "~1.8.0",
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/ox/node_modules/@scure/bip39": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip39/-/bip39-1.6.0.tgz",
+      "integrity": "sha512-+lF0BbLiJNwVlev4eKelw1WWLaiKXw7sSl8T6FvBlWkdX+94aGJ4o8XjUdlyhTCjd8c+B3KT3JfS8P0bLRNU6A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "~1.8.0",
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/p-limit": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz",
+      "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "yocto-queue": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-locate": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz",
+      "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "p-limit": "^3.0.2"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/p-map": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/p-map/-/p-map-4.0.0.tgz",
+      "integrity": "sha512-/bjOqmgETBYB5BoEeGVea8dmvHb2m9GLy1E9W43yeyfP6QQCZGFNa+XRceJEuDB6zqr+gKpIAmlLebMpykw/MQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "aggregate-error": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/package-json-from-dist": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/package-json-from-dist/-/package-json-from-dist-1.0.1.tgz",
+      "integrity": "sha512-UEZIS3/by4OC8vL3P2dTXRETpebLI2NiI5vIrjaD/5UtrkFX/tNbwjTSRAGC/+7CAo2pIcBaRgWmcBBHcsaCIw==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "peer": true
+    },
+    "node_modules/path-exists": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
+      "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-is-absolute": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
+      "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/path-key": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz",
+      "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/path-parse": {
+      "version": "1.0.7",
+      "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz",
+      "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/path-scurry": {
+      "version": "1.11.1",
+      "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-1.11.1.tgz",
+      "integrity": "sha512-Xa4Nw17FS9ApQFJ9umLiJS4orGjm7ZzwUrwamcGQuHSzDyth9boKDaycYdDcZDuqYATXw4HFXgaqWTctW/v1HA==",
+      "dev": true,
+      "license": "BlueOak-1.0.0",
+      "peer": true,
+      "dependencies": {
+        "lru-cache": "^10.2.0",
+        "minipass": "^5.0.0 || ^6.0.2 || ^7.0.0"
+      },
+      "engines": {
+        "node": ">=16 || 14 >=14.18"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/path-type": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz",
+      "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/pathval": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/pathval/-/pathval-1.1.1.tgz",
+      "integrity": "sha512-Dp6zGqpTdETdR63lehJYPeIOqpiNBNtc7BpWSLrOje7UaIsE5aY92r/AunQA7rsXvet3lrJ3JnZX29UPTKXyKQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/pbkdf2": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/pbkdf2/-/pbkdf2-3.1.2.tgz",
+      "integrity": "sha512-iuh7L6jA7JEGu2WxDwtQP1ddOpaJNC4KlDEFfdQajSGgGPNi4OyDc2R7QnbY2bR9QjBVGwgvTdNJZoE7RaxUMA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "create-hash": "^1.1.2",
+        "create-hmac": "^1.1.4",
+        "ripemd160": "^2.0.1",
+        "safe-buffer": "^5.0.1",
+        "sha.js": "^2.4.8"
+      },
+      "engines": {
+        "node": ">=0.12"
+      }
+    },
+    "node_modules/picocolors": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/picomatch": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz",
+      "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/pify": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/pify/-/pify-4.0.1.tgz",
+      "integrity": "sha512-uB80kBFb/tfd68bVleG9T5GGsGPjJrLAUpR5PZIrhBnIaRTQRjqdJSsIKkOP6OAIFbj7GOrcudc5pNjZ+geV2g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/prelude-ls": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.1.2.tgz",
+      "integrity": "sha512-ESF23V4SKG6lVSGZgYNpbsiaAkdab6ZgOxe52p7+Kid3W3u3bxR4Vfd/o21dmN7jSt0IwgZ4v5MUd26FEtXE9w==",
+      "dev": true,
+      "peer": true,
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/prettier": {
+      "version": "2.8.8",
+      "resolved": "https://registry.npmjs.org/prettier/-/prettier-2.8.8.tgz",
+      "integrity": "sha512-tdN8qQGvNjw4CHbY+XXk0JgCXn9QiF21a55rBe5LJAU+kDyC4WQn4+awm2Xfk2lQMk5fKup9XgzTZtGkjBdP9Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "bin": {
+        "prettier": "bin-prettier.js"
+      },
+      "engines": {
+        "node": ">=10.13.0"
+      },
+      "funding": {
+        "url": "https://github.com/prettier/prettier?sponsor=1"
+      }
+    },
+    "node_modules/prompts": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/prompts/-/prompts-2.4.2.tgz",
+      "integrity": "sha512-NxNv/kLguCA7p3jE8oL2aEBsrJWgAakBpgmgK6lpPWV+WuOmY6r2/zbAVnP+T8bQlA0nzHXSJSJW0Hq7ylaD2Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "kleur": "^3.0.3",
+        "sisteransi": "^1.0.5"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/proxy-from-env": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/proxy-from-env/-/proxy-from-env-1.1.0.tgz",
+      "integrity": "sha512-D+zkORCbA9f1tdWRK0RaCR3GPv50cMxcrz4X8k5LTSUD1Dkw47mKJEZQNunItRTkWwgtaUSo1RVFRIG9ZXiFYg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/queue-microtask": {
+      "version": "1.2.3",
+      "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",
+      "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/randombytes": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz",
+      "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "^5.1.0"
+      }
+    },
+    "node_modules/raw-body": {
+      "version": "2.5.2",
+      "resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.2.tgz",
+      "integrity": "sha512-8zGqypfENjCIqGhgXToC8aB2r7YrBX+AQAfIPs/Mlk+BtPTztOvTS01NRW/3Eh60J+a48lt8qsCzirQ6loCVfA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bytes": "3.1.2",
+        "http-errors": "2.0.0",
+        "iconv-lite": "0.4.24",
+        "unpipe": "1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/readable-stream": {
+      "version": "3.6.2",
+      "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz",
+      "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "inherits": "^2.0.3",
+        "string_decoder": "^1.1.1",
+        "util-deprecate": "^1.0.1"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/readdirp": {
+      "version": "4.1.2",
+      "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-4.1.2.tgz",
+      "integrity": "sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14.18.0"
+      },
+      "funding": {
+        "type": "individual",
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/rechoir": {
+      "version": "0.6.2",
+      "resolved": "https://registry.npmjs.org/rechoir/-/rechoir-0.6.2.tgz",
+      "integrity": "sha512-HFM8rkZ+i3zrV+4LQjwQ0W+ez98pApMGM3HUrN04j3CqzPOzl9nmP15Y8YXNm8QHGv/eacOVEjqhmWpkRV0NAw==",
+      "dev": true,
+      "peer": true,
+      "dependencies": {
+        "resolve": "^1.1.6"
+      },
+      "engines": {
+        "node": ">= 0.10"
+      }
+    },
+    "node_modules/recursive-readdir": {
+      "version": "2.2.3",
+      "resolved": "https://registry.npmjs.org/recursive-readdir/-/recursive-readdir-2.2.3.tgz",
+      "integrity": "sha512-8HrF5ZsXk5FAH9dgsx3BlUer73nIhuj+9OrQwEbLTPOBzGkL1lsFCR01am+v+0m2Cmbs1nP12hLDl5FA7EszKA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "minimatch": "^3.0.5"
+      },
+      "engines": {
+        "node": ">=6.0.0"
+      }
+    },
+    "node_modules/recursive-readdir/node_modules/brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/recursive-readdir/node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/reduce-flatten": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/reduce-flatten/-/reduce-flatten-2.0.0.tgz",
+      "integrity": "sha512-EJ4UNY/U1t2P/2k6oqotuX2Cc3T6nxJwsM0N0asT7dhrtH1ltUxDn4NalSYmPE2rCkVpcf/X6R0wDwcFpzhd4w==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/repeat-string": {
+      "version": "1.6.1",
+      "resolved": "https://registry.npmjs.org/repeat-string/-/repeat-string-1.6.1.tgz",
+      "integrity": "sha512-PV0dzCYDNfRi1jCDbJzpW7jNNDRuCOG/jI5ctQcGKt/clZD+YcPS3yIlWuTJMmESC8aevCFmWJy5wjAFgNqN6w==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10"
+      }
+    },
+    "node_modules/require-directory": {
+      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
+      "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/require-from-string": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/resolve": {
+      "version": "1.17.0",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.17.0.tgz",
+      "integrity": "sha512-ic+7JYiV8Vi2yzQGFWOkiZD5Z9z7O2Zhm9XMaTxdJExKasieFCr+yXZ/WmXsckHiKl12ar0y6XiXDx3m4RHn1w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "path-parse": "^1.0.6"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/reusify": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",
+      "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "iojs": ">=1.0.0",
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/ripemd160": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/ripemd160/-/ripemd160-2.0.2.tgz",
+      "integrity": "sha512-ii4iagi25WusVoiC4B4lq7pbXfAp3D9v5CwfkY33vffw2+pkDjY1D8GaN7spsxvCSx8dkPqOZCEZyfxcmJG2IA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "hash-base": "^3.0.0",
+        "inherits": "^2.0.1"
+      }
+    },
+    "node_modules/rlp": {
+      "version": "2.2.7",
+      "resolved": "https://registry.npmjs.org/rlp/-/rlp-2.2.7.tgz",
+      "integrity": "sha512-d5gdPmgQ0Z+AklL2NVXr/IoSjNZFfTVvQWzL/AM2AOcSzYP2xjlb0AC8YyCLc41MSNf6P6QVtjgPdmVtzb+4lQ==",
+      "dev": true,
+      "license": "MPL-2.0",
+      "dependencies": {
+        "bn.js": "^5.2.0"
+      },
+      "bin": {
+        "rlp": "bin/rlp"
+      }
+    },
+    "node_modules/run-parallel": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",
+      "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "queue-microtask": "^1.2.2"
+      }
+    },
+    "node_modules/safe-buffer": {
+      "version": "5.2.1",
+      "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
+      "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/feross"
+        },
+        {
+          "type": "patreon",
+          "url": "https://www.patreon.com/feross"
+        },
+        {
+          "type": "consulting",
+          "url": "https://feross.org/support"
+        }
+      ],
+      "license": "MIT"
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/sc-istanbul": {
+      "version": "0.4.6",
+      "resolved": "https://registry.npmjs.org/sc-istanbul/-/sc-istanbul-0.4.6.tgz",
+      "integrity": "sha512-qJFF/8tW/zJsbyfh/iT/ZM5QNHE3CXxtLJbZsL+CzdJLBsPD7SedJZoUA4d8iAcN2IoMp/Dx80shOOd2x96X/g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "dependencies": {
+        "abbrev": "1.0.x",
+        "async": "1.x",
+        "escodegen": "1.8.x",
+        "esprima": "2.7.x",
+        "glob": "^5.0.15",
+        "handlebars": "^4.0.1",
+        "js-yaml": "3.x",
+        "mkdirp": "0.5.x",
+        "nopt": "3.x",
+        "once": "1.x",
+        "resolve": "1.1.x",
+        "supports-color": "^3.1.0",
+        "which": "^1.1.1",
+        "wordwrap": "^1.0.0"
+      },
+      "bin": {
+        "istanbul": "lib/cli.js"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/argparse": {
+      "version": "1.0.10",
+      "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "sprintf-js": "~1.0.2"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/glob": {
+      "version": "5.0.15",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-5.0.15.tgz",
+      "integrity": "sha512-c9IPMazfRITpmAAKi22dK1VKxGDX9ehhqfABDriL/lzO92xcUKEJPQHrVA/2YHSNFB4iFlykVmWvwo48nr3OxA==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "2 || 3",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/has-flag": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-1.0.0.tgz",
+      "integrity": "sha512-DyYHfIYwAJmjAjSSPKANxI8bFY9YtFrgkAfinBojQ8YJTOuOuav64tMUJv584SES4xl74PmuaevIyaLESHdTAA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/js-yaml": {
+      "version": "3.14.1",
+      "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.1.tgz",
+      "integrity": "sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "argparse": "^1.0.7",
+        "esprima": "^4.0.0"
+      },
+      "bin": {
+        "js-yaml": "bin/js-yaml.js"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/js-yaml/node_modules/esprima": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
+      "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "peer": true,
+      "bin": {
+        "esparse": "bin/esparse.js",
+        "esvalidate": "bin/esvalidate.js"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/sc-istanbul/node_modules/resolve": {
+      "version": "1.1.7",
+      "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.1.7.tgz",
+      "integrity": "sha512-9znBF0vBcaSN3W2j7wKvdERPwqTxSpCq+if5C0WoTCyV9n24rua28jeuQ2pL/HOf+yUe/Mef+H/5p60K0Id3bg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/sc-istanbul/node_modules/supports-color": {
+      "version": "3.2.3",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-3.2.3.tgz",
+      "integrity": "sha512-Jds2VIYDrlp5ui7t8abHN2bjAu4LV/q4N2KivFPpGH0lrka0BMq/33AmECUXlKPcHigkNaqfXRENFju+rlcy+A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "has-flag": "^1.0.0"
+      },
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/scrypt-js": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/scrypt-js/-/scrypt-js-3.0.1.tgz",
+      "integrity": "sha512-cdwTTnqPu0Hyvf5in5asVdZocVDTNRmR7XEcJuIzMjJeSHybHl7vpB66AzwTaIg6CLSbtjcxc8fqcySfnTkccA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/secp256k1": {
+      "version": "4.0.4",
+      "resolved": "https://registry.npmjs.org/secp256k1/-/secp256k1-4.0.4.tgz",
+      "integrity": "sha512-6JfvwvjUOn8F/jUoBY2Q1v5WY5XS+rj8qSe0v8Y4ezH4InLgTEeOOPQsRll9OV429Pvo6BCHGavIyJfr3TAhsw==",
+      "dev": true,
+      "hasInstallScript": true,
+      "license": "MIT",
+      "dependencies": {
+        "elliptic": "^6.5.7",
+        "node-addon-api": "^5.0.0",
+        "node-gyp-build": "^4.2.0"
+      },
+      "engines": {
+        "node": ">=18.0.0"
+      }
+    },
+    "node_modules/secp256k1/node_modules/bn.js": {
+      "version": "4.12.1",
+      "resolved": "https://registry.npmjs.org/bn.js/-/bn.js-4.12.1.tgz",
+      "integrity": "sha512-k8TVBiPkPJT9uHLdOKfFpqcfprwBFOAAXXozRubr7R7PfIuKvQlzcI4M0pALeqXN09vdaMbUdUj+pass+uULAg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/secp256k1/node_modules/elliptic": {
+      "version": "6.6.1",
+      "resolved": "https://registry.npmjs.org/elliptic/-/elliptic-6.6.1.tgz",
+      "integrity": "sha512-RaddvvMatK2LJHqFJ+YA4WysVN5Ita9E35botqIYspQ4TkRAlCicdzKOjlyv/1Za5RyTNn7di//eEV0uTAfe3g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "bn.js": "^4.11.9",
+        "brorand": "^1.1.0",
+        "hash.js": "^1.0.0",
+        "hmac-drbg": "^1.0.1",
+        "inherits": "^2.0.4",
+        "minimalistic-assert": "^1.0.1",
+        "minimalistic-crypto-utils": "^1.0.1"
+      }
+    },
+    "node_modules/secp256k1/node_modules/node-addon-api": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/node-addon-api/-/node-addon-api-5.1.0.tgz",
+      "integrity": "sha512-eh0GgfEkpnoWDq+VY8OyvYhFEzBk6jIYbRKdIlyTiAXIVJ8PyBaKb0rp7oDtoddbdoHWhq8wwr+XZ81F1rpNdA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/semver": {
+      "version": "6.3.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
+      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver.js"
+      }
+    },
+    "node_modules/serialize-javascript": {
+      "version": "6.0.2",
+      "resolved": "https://registry.npmjs.org/serialize-javascript/-/serialize-javascript-6.0.2.tgz",
+      "integrity": "sha512-Saa1xPByTTq2gdeFZYLLo+RFE35NHZkAbqZeWNd3BpzppeVisAqpDjcp8dyf6uIvEqJRd46jemmyA4iFIeVk8g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "randombytes": "^2.1.0"
+      }
+    },
+    "node_modules/setimmediate": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
+      "integrity": "sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/setprototypeof": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
+      "integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/sha.js": {
+      "version": "2.4.11",
+      "resolved": "https://registry.npmjs.org/sha.js/-/sha.js-2.4.11.tgz",
+      "integrity": "sha512-QMEp5B7cftE7APOjk5Y6xgrbWu+WkLVQwk8JNjZ8nKRciZaByEW6MubieAiToS7+dwvrjGhH8jRXz3MVd0AYqQ==",
+      "dev": true,
+      "license": "(MIT AND BSD-3-Clause)",
+      "dependencies": {
+        "inherits": "^2.0.1",
+        "safe-buffer": "^5.0.1"
+      },
+      "bin": {
+        "sha.js": "bin.js"
+      }
+    },
+    "node_modules/sha1": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/sha1/-/sha1-1.1.1.tgz",
+      "integrity": "sha512-dZBS6OrMjtgVkopB1Gmo4RQCDKiZsqcpAQpkV/aaj+FCrCg8r4I4qMkDPQjBgLIxlmu9k4nUbWq6ohXahOneYA==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "dependencies": {
+        "charenc": ">= 0.0.1",
+        "crypt": ">= 0.0.1"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/shebang-command": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz",
+      "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "shebang-regex": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shebang-regex": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz",
+      "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/shelljs": {
+      "version": "0.8.5",
+      "resolved": "https://registry.npmjs.org/shelljs/-/shelljs-0.8.5.tgz",
+      "integrity": "sha512-TiwcRcrkhHvbrZbnRcFYMLl30Dfov3HKqzp5tO5b4pt6G/SezKcYhmDg15zXVBswHmctSAQKznqNW2LO5tTDow==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "dependencies": {
+        "glob": "^7.0.0",
+        "interpret": "^1.0.0",
+        "rechoir": "^0.6.2"
+      },
+      "bin": {
+        "shjs": "bin/shjs"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/shelljs/node_modules/brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/shelljs/node_modules/glob": {
+      "version": "7.2.3",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz",
+      "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^3.1.1",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/shelljs/node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/signal-exit": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz",
+      "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "engines": {
+        "node": ">=14"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/sisteransi": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz",
+      "integrity": "sha512-bLGGlR1QxBcynn2d5YmDX4MGjlZvy2MRBDRNHLJ8VI6l6+9FUiyTFNJ0IveOSP0bcXgVDPRcfGqA0pjaqUpfVg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/slash": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz",
+      "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/slice-ansi": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-4.0.0.tgz",
+      "integrity": "sha512-qMCMfhY040cVHT43K9BFygqYbUPFZKHOg7K73mtTWJRb8pyP3fzf4Ixd5SzdEJQ6MRUg/WBnOLxghZtKKurENQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "astral-regex": "^2.0.0",
+        "is-fullwidth-code-point": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/slice-ansi?sponsor=1"
+      }
+    },
+    "node_modules/solc": {
+      "version": "0.8.26",
+      "resolved": "https://registry.npmjs.org/solc/-/solc-0.8.26.tgz",
+      "integrity": "sha512-yiPQNVf5rBFHwN6SIf3TUUvVAFKcQqmSUFeq+fb6pNRCo0ZCgpYOZDi3BVoezCPIAcKrVYd/qXlBLUP9wVrZ9g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "command-exists": "^1.2.8",
+        "commander": "^8.1.0",
+        "follow-redirects": "^1.12.1",
+        "js-sha3": "0.8.0",
+        "memorystream": "^0.3.1",
+        "semver": "^5.5.0",
+        "tmp": "0.0.33"
+      },
+      "bin": {
+        "solcjs": "solc.js"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/solc/node_modules/semver": {
+      "version": "5.7.2",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz",
+      "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==",
+      "dev": true,
+      "license": "ISC",
+      "bin": {
+        "semver": "bin/semver"
+      }
+    },
+    "node_modules/solidity-coverage": {
+      "version": "0.8.14",
+      "resolved": "https://registry.npmjs.org/solidity-coverage/-/solidity-coverage-0.8.14.tgz",
+      "integrity": "sha512-ItAAObe5GaEOp20kXC2BZRnph+9P7Rtoqg2mQc2SXGEHgSDF2wWd1Wxz3ntzQWXkbCtIIGdJT918HG00cObwbA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "@ethersproject/abi": "^5.0.9",
+        "@solidity-parser/parser": "^0.19.0",
+        "chalk": "^2.4.2",
+        "death": "^1.1.0",
+        "difflib": "^0.2.4",
+        "fs-extra": "^8.1.0",
+        "ghost-testrpc": "^0.0.2",
+        "global-modules": "^2.0.0",
+        "globby": "^10.0.1",
+        "jsonschema": "^1.2.4",
+        "lodash": "^4.17.21",
+        "mocha": "^10.2.0",
+        "node-emoji": "^1.10.0",
+        "pify": "^4.0.1",
+        "recursive-readdir": "^2.2.2",
+        "sc-istanbul": "^0.4.5",
+        "semver": "^7.3.4",
+        "shelljs": "^0.8.3",
+        "web3-utils": "^1.3.6"
+      },
+      "bin": {
+        "solidity-coverage": "plugins/bin.js"
+      },
+      "peerDependencies": {
+        "hardhat": "^2.11.0"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/@solidity-parser/parser": {
+      "version": "0.19.0",
+      "resolved": "https://registry.npmjs.org/@solidity-parser/parser/-/parser-0.19.0.tgz",
+      "integrity": "sha512-RV16k/qIxW/wWc+mLzV3ARyKUaMUTBy9tOLMzFhtNSKYeTAanQ3a5MudJKf/8arIFnA2L27SNjarQKmFg0w/jA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/solidity-coverage/node_modules/ansi-styles": {
+      "version": "3.2.1",
+      "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz",
+      "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-convert": "^1.9.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/chalk": {
+      "version": "2.4.2",
+      "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz",
+      "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^3.2.1",
+        "escape-string-regexp": "^1.0.5",
+        "supports-color": "^5.3.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/color-convert": {
+      "version": "1.9.3",
+      "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz",
+      "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "color-name": "1.1.3"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/color-name": {
+      "version": "1.1.3",
+      "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz",
+      "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/solidity-coverage/node_modules/escape-string-regexp": {
+      "version": "1.0.5",
+      "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz",
+      "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/fs-extra": {
+      "version": "8.1.0",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-8.1.0.tgz",
+      "integrity": "sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "graceful-fs": "^4.2.0",
+        "jsonfile": "^4.0.0",
+        "universalify": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=6 <7 || >=8"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/has-flag": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz",
+      "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/jsonfile": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
+      "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/semver": {
+      "version": "7.7.1",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz",
+      "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "bin": {
+        "semver": "bin/semver.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/supports-color": {
+      "version": "5.5.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz",
+      "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "has-flag": "^3.0.0"
+      },
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/solidity-coverage/node_modules/universalify": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
+      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/source-map": {
+      "version": "0.2.0",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.2.0.tgz",
+      "integrity": "sha512-CBdZ2oa/BHhS4xj5DlhjWNHcan57/5YuvfdLf17iVmIpd9KRm+DFLmC6nBNj+6Ua7Kt3TmOjDpQT1aTYOQtoUA==",
+      "dev": true,
+      "optional": true,
+      "peer": true,
+      "dependencies": {
+        "amdefine": ">=0.0.4"
+      },
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/source-map-support": {
+      "version": "0.5.21",
+      "resolved": "https://registry.npmjs.org/source-map-support/-/source-map-support-0.5.21.tgz",
+      "integrity": "sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "buffer-from": "^1.0.0",
+        "source-map": "^0.6.0"
+      }
+    },
+    "node_modules/source-map-support/node_modules/source-map": {
+      "version": "0.6.1",
+      "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz",
+      "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/split2": {
+      "version": "3.2.2",
+      "resolved": "https://registry.npmjs.org/split2/-/split2-3.2.2.tgz",
+      "integrity": "sha512-9NThjpgZnifTkJpzTZ7Eue85S49QwpNhZTq6GRJwObb6jnLFNGB7Qm73V5HewTROPyxD0C29xqmaI68bQtV+hg==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "readable-stream": "^3.0.0"
+      }
+    },
+    "node_modules/sprintf-js": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
+      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true
+    },
+    "node_modules/stacktrace-parser": {
+      "version": "0.1.11",
+      "resolved": "https://registry.npmjs.org/stacktrace-parser/-/stacktrace-parser-0.1.11.tgz",
+      "integrity": "sha512-WjlahMgHmCJpqzU8bIBy4qtsZdU9lRlcZE3Lvyej6t4tuOuv1vk57OW3MBrj6hXBFx/nNoC9MPMTcr5YA7NQbg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "type-fest": "^0.7.1"
+      },
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/stacktrace-parser/node_modules/type-fest": {
+      "version": "0.7.1",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.7.1.tgz",
+      "integrity": "sha512-Ne2YiiGN8bmrmJJEuTWTLJR32nh/JdL1+PSicowtNb0WFpn59GK8/lfD61bVtzguz7b3PBt74nxpv/Pw5po5Rg==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/statuses": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.1.tgz",
+      "integrity": "sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/string_decoder": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz",
+      "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safe-buffer": "~5.2.0"
+      }
+    },
+    "node_modules/string-format": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/string-format/-/string-format-2.0.0.tgz",
+      "integrity": "sha512-bbEs3scLeYNXLecRRuk6uJxdXUSj6le/8rNPHChIJTn2V79aXVTR1EH2OH5zLKKoz0V02fOUKZZcw01pLUShZA==",
+      "dev": true,
+      "license": "WTFPL OR MIT",
+      "peer": true
+    },
+    "node_modules/string-width": {
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/string-width-cjs": {
+      "name": "string-width",
+      "version": "4.2.3",
+      "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz",
+      "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "emoji-regex": "^8.0.0",
+        "is-fullwidth-code-point": "^3.0.0",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-ansi-cjs": {
+      "name": "strip-ansi",
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz",
+      "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-regex": "^5.0.1"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/strip-hex-prefix": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/strip-hex-prefix/-/strip-hex-prefix-1.0.0.tgz",
+      "integrity": "sha512-q8d4ue7JGEiVcypji1bALTos+0pWtyGlivAWyPuTkHzuTCJqrK9sWxYQZUq6Nq3cuyv3bm734IhHvHtGGURU6A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-hex-prefixed": "1.0.0"
+      },
+      "engines": {
+        "node": ">=6.5.0",
+        "npm": ">=3"
+      }
+    },
+    "node_modules/strip-json-comments": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz",
+      "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=8"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/supports-color": {
+      "version": "7.2.0",
+      "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+      "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-flag": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/table": {
+      "version": "6.9.0",
+      "resolved": "https://registry.npmjs.org/table/-/table-6.9.0.tgz",
+      "integrity": "sha512-9kY+CygyYM6j02t5YFHbNz2FN5QmYGv9zAjVp4lCDjlCw7amdckXlEt/bjMhUIfj4ThGRE4gCUH5+yGnNuPo5A==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "dependencies": {
+        "ajv": "^8.0.1",
+        "lodash.truncate": "^4.4.2",
+        "slice-ansi": "^4.0.0",
+        "string-width": "^4.2.3",
+        "strip-ansi": "^6.0.1"
+      },
+      "engines": {
+        "node": ">=10.0.0"
+      }
+    },
+    "node_modules/table-layout": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/table-layout/-/table-layout-1.0.2.tgz",
+      "integrity": "sha512-qd/R7n5rQTRFi+Zf2sk5XVVd9UQl6ZkduPFC3S7WEGJAmetDTjY3qPN50eSKzwuzEyQKy5TN2TiZdkIjos2L6A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "array-back": "^4.0.1",
+        "deep-extend": "~0.6.0",
+        "typical": "^5.2.0",
+        "wordwrapjs": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/table-layout/node_modules/array-back": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/array-back/-/array-back-4.0.2.tgz",
+      "integrity": "sha512-NbdMezxqf94cnNfWLL7V/im0Ub+Anbb0IoZhvzie8+4HJ4nMQuzHuy49FkGYCJK2yAloZ3meiB6AVMClbrI1vg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/table-layout/node_modules/typical": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/typical/-/typical-5.2.0.tgz",
+      "integrity": "sha512-dvdQgNDNJo+8B2uBQoqdb11eUCE1JQXhvjC/CZtgvZseVd5TYMXnq0+vuUemXbd/Se29cTaUuPX3YIc2xgbvIg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/through2": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/through2/-/through2-4.0.2.tgz",
+      "integrity": "sha512-iOqSav00cVxEEICeD7TjLB1sueEL+81Wpzp2bY17uZjZN0pWZPuo4suZ/61VujxmqSGFfgOcNuTZ85QJwNZQpw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "readable-stream": "3"
+      }
+    },
+    "node_modules/tinyglobby": {
+      "version": "0.2.12",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.12.tgz",
+      "integrity": "sha512-qkf4trmKSIiMTs/E63cxH+ojC2unam7rJ0WrauAzpT3ECNTxGRMlaXxVbfxMUC/w0LaYk6jQ4y/nGR9uBO3tww==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "fdir": "^6.4.3",
+        "picomatch": "^4.0.2"
+      },
+      "engines": {
+        "node": ">=12.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/SuperchupuDev"
+      }
+    },
+    "node_modules/tinyglobby/node_modules/fdir": {
+      "version": "6.4.3",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.4.3.tgz",
+      "integrity": "sha512-PMXmW2y1hDDfTSRc9gaXIuCCRpuoz3Kaz8cUelp3smouvfT632ozg2vrT6lJsHKKOF59YLbOGfAWGUcKEfRMQw==",
+      "dev": true,
+      "license": "MIT",
+      "peerDependencies": {
+        "picomatch": "^3 || ^4"
+      },
+      "peerDependenciesMeta": {
+        "picomatch": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/tinyglobby/node_modules/picomatch": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.2.tgz",
+      "integrity": "sha512-M7BAV6Rlcy5u+m6oPhAPFgJTzAioX/6B0DxyvDlo9l8+T3nLKbrczg2WLUyzd45L8RqfUMyGPzekbMvX2Ldkwg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=12"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/jonschlinkert"
+      }
+    },
+    "node_modules/tmp": {
+      "version": "0.0.33",
+      "resolved": "https://registry.npmjs.org/tmp/-/tmp-0.0.33.tgz",
+      "integrity": "sha512-jRCJlojKnZ3addtTOjdIqoRuPEKBvNXcGYqzO6zWZX8KfKEpnGY5jfggJQ3EjKuu8D4bJRr0y+cYJFmYbImXGw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "os-tmpdir": "~1.0.2"
+      },
+      "engines": {
+        "node": ">=0.6.0"
+      }
+    },
+    "node_modules/to-regex-range": {
+      "version": "5.0.1",
+      "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",
+      "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "is-number": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=8.0"
+      }
+    },
+    "node_modules/toidentifier": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
+      "integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.6"
+      }
+    },
+    "node_modules/ts-command-line-args": {
+      "version": "2.5.1",
+      "resolved": "https://registry.npmjs.org/ts-command-line-args/-/ts-command-line-args-2.5.1.tgz",
+      "integrity": "sha512-H69ZwTw3rFHb5WYpQya40YAX2/w7Ut75uUECbgBIsLmM+BNuYnxsltfyyLMxy6sEeKxgijLTnQtLd0nKd6+IYw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "chalk": "^4.1.0",
+        "command-line-args": "^5.1.1",
+        "command-line-usage": "^6.1.0",
+        "string-format": "^2.0.0"
+      },
+      "bin": {
+        "write-markdown": "dist/write-markdown.js"
+      }
+    },
+    "node_modules/ts-essentials": {
+      "version": "7.0.3",
+      "resolved": "https://registry.npmjs.org/ts-essentials/-/ts-essentials-7.0.3.tgz",
+      "integrity": "sha512-8+gr5+lqO3G84KdiTSMRLtuyJ+nTBVRKuCrK4lidMPdVeEp0uqC875uE5NMcaA7YYMN7XsNiFQuMvasF8HT/xQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "peerDependencies": {
+        "typescript": ">=3.7.0"
+      }
+    },
+    "node_modules/ts-node": {
+      "version": "10.9.2",
+      "resolved": "https://registry.npmjs.org/ts-node/-/ts-node-10.9.2.tgz",
+      "integrity": "sha512-f0FFpIdcHgn8zcPSbf1dRevwt047YMnaiJM3u2w2RewrB+fob/zePZcrOyQoLMMO7aBIddLcQIEK5dYjkLnGrQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@cspotcode/source-map-support": "^0.8.0",
+        "@tsconfig/node10": "^1.0.7",
+        "@tsconfig/node12": "^1.0.7",
+        "@tsconfig/node14": "^1.0.0",
+        "@tsconfig/node16": "^1.0.2",
+        "acorn": "^8.4.1",
+        "acorn-walk": "^8.1.1",
+        "arg": "^4.1.0",
+        "create-require": "^1.1.0",
+        "diff": "^4.0.1",
+        "make-error": "^1.1.1",
+        "v8-compile-cache-lib": "^3.0.1",
+        "yn": "3.1.1"
+      },
+      "bin": {
+        "ts-node": "dist/bin.js",
+        "ts-node-cwd": "dist/bin-cwd.js",
+        "ts-node-esm": "dist/bin-esm.js",
+        "ts-node-script": "dist/bin-script.js",
+        "ts-node-transpile-only": "dist/bin-transpile.js",
+        "ts-script": "dist/bin-script-deprecated.js"
+      },
+      "peerDependencies": {
+        "@swc/core": ">=1.2.50",
+        "@swc/wasm": ">=1.2.50",
+        "@types/node": "*",
+        "typescript": ">=2.7"
+      },
+      "peerDependenciesMeta": {
+        "@swc/core": {
+          "optional": true
+        },
+        "@swc/wasm": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/ts-node/node_modules/diff": {
+      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/diff/-/diff-4.0.2.tgz",
+      "integrity": "sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "peer": true,
+      "engines": {
+        "node": ">=0.3.1"
+      }
+    },
+    "node_modules/tslib": {
+      "version": "2.7.0",
+      "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.7.0.tgz",
+      "integrity": "sha512-gLXCKdN1/j47AiHiOkJN69hJmcbGTHI0ImLmbYLHykhgeN0jVGola9yVjFgzCUklsZQMW55o+dW7IXv3RCXDzA==",
+      "dev": true,
+      "license": "0BSD",
+      "peer": true
+    },
+    "node_modules/tsort": {
+      "version": "0.0.1",
+      "resolved": "https://registry.npmjs.org/tsort/-/tsort-0.0.1.tgz",
+      "integrity": "sha512-Tyrf5mxF8Ofs1tNoxA13lFeZ2Zrbd6cKbuH3V+MQ5sb6DtBj5FjrXVsRWT8YvNAQTqNoz66dz1WsbigI22aEnw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/tweetnacl": {
+      "version": "1.0.3",
+      "resolved": "https://registry.npmjs.org/tweetnacl/-/tweetnacl-1.0.3.tgz",
+      "integrity": "sha512-6rt+RN7aOi1nGMyC4Xa5DdYiukl2UWCbcJft7YhxReBGQD7OAM8Pbxw6YMo4r2diNEA8FEmu32YOn9rhaiE5yw==",
+      "dev": true,
+      "license": "Unlicense"
+    },
+    "node_modules/tweetnacl-util": {
+      "version": "0.15.1",
+      "resolved": "https://registry.npmjs.org/tweetnacl-util/-/tweetnacl-util-0.15.1.tgz",
+      "integrity": "sha512-RKJBIj8lySrShN4w6i/BonWp2Z/uxwC3h4y7xsRrpP59ZboCd0GpEVsOnMDYLMmKBpYhb5TgHzZXy7wTfYFBRw==",
+      "dev": true,
+      "license": "Unlicense"
+    },
+    "node_modules/type-check": {
+      "version": "0.3.2",
+      "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.3.2.tgz",
+      "integrity": "sha512-ZCmOJdvOWDBYJlzAoFkC+Q0+bUyEOS1ltgp1MGU03fqHG+dbi9tBFU2Rd9QKiDZFAYrhPh2JUf7rZRIuHRKtOg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "prelude-ls": "~1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.8.0"
+      }
+    },
+    "node_modules/type-detect": {
+      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/type-detect/-/type-detect-4.1.0.tgz",
+      "integrity": "sha512-Acylog8/luQ8L7il+geoSxhEkazvkslg7PSNKOX59mbB9cOveP5aq9h74Y7YU8yDpJwetzQQrfIwtf4Wp4LKcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=4"
+      }
+    },
+    "node_modules/type-fest": {
+      "version": "0.21.3",
+      "resolved": "https://registry.npmjs.org/type-fest/-/type-fest-0.21.3.tgz",
+      "integrity": "sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==",
+      "dev": true,
+      "license": "(MIT OR CC0-1.0)",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    },
+    "node_modules/typechain": {
+      "version": "8.3.2",
+      "resolved": "https://registry.npmjs.org/typechain/-/typechain-8.3.2.tgz",
+      "integrity": "sha512-x/sQYr5w9K7yv3es7jo4KTX05CLxOf7TRWwoHlrjRh8H82G64g+k7VuWPJlgMo6qrjfCulOdfBjiaDtmhFYD/Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@types/prettier": "^2.1.1",
+        "debug": "^4.3.1",
+        "fs-extra": "^7.0.0",
+        "glob": "7.1.7",
+        "js-sha3": "^0.8.0",
+        "lodash": "^4.17.15",
+        "mkdirp": "^1.0.4",
+        "prettier": "^2.3.1",
+        "ts-command-line-args": "^2.2.0",
+        "ts-essentials": "^7.0.1"
+      },
+      "bin": {
+        "typechain": "dist/cli/cli.js"
+      },
+      "peerDependencies": {
+        "typescript": ">=4.3.0"
+      }
+    },
+    "node_modules/typechain/node_modules/brace-expansion": {
+      "version": "1.1.11",
+      "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
+      "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "balanced-match": "^1.0.0",
+        "concat-map": "0.0.1"
+      }
+    },
+    "node_modules/typechain/node_modules/fs-extra": {
+      "version": "7.0.1",
+      "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-7.0.1.tgz",
+      "integrity": "sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "graceful-fs": "^4.1.2",
+        "jsonfile": "^4.0.0",
+        "universalify": "^0.1.0"
+      },
+      "engines": {
+        "node": ">=6 <7 || >=8"
+      }
+    },
+    "node_modules/typechain/node_modules/glob": {
+      "version": "7.1.7",
+      "resolved": "https://registry.npmjs.org/glob/-/glob-7.1.7.tgz",
+      "integrity": "sha512-OvD9ENzPLbegENnYP5UUfJIirTg4+XwMWGaQfQTY0JenxNvvIKP3U3/tAQSPIu/lHxXYSZmpXlUHeqAIdKzBLQ==",
+      "deprecated": "Glob versions prior to v9 are no longer supported",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "fs.realpath": "^1.0.0",
+        "inflight": "^1.0.4",
+        "inherits": "2",
+        "minimatch": "^3.0.4",
+        "once": "^1.3.0",
+        "path-is-absolute": "^1.0.0"
+      },
+      "engines": {
+        "node": "*"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/isaacs"
+      }
+    },
+    "node_modules/typechain/node_modules/jsonfile": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/jsonfile/-/jsonfile-4.0.0.tgz",
+      "integrity": "sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "optionalDependencies": {
+        "graceful-fs": "^4.1.6"
+      }
+    },
+    "node_modules/typechain/node_modules/minimatch": {
+      "version": "3.1.2",
+      "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz",
+      "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "brace-expansion": "^1.1.7"
+      },
+      "engines": {
+        "node": "*"
+      }
+    },
+    "node_modules/typechain/node_modules/mkdirp": {
+      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-1.0.4.tgz",
+      "integrity": "sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "bin": {
+        "mkdirp": "bin/cmd.js"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/typechain/node_modules/universalify": {
+      "version": "0.1.2",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-0.1.2.tgz",
+      "integrity": "sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 4.0.0"
+      }
+    },
+    "node_modules/typescript": {
+      "version": "5.7.3",
+      "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.7.3.tgz",
+      "integrity": "sha512-84MVSjMEHP+FQRPy3pX9sTVV/INIex71s9TL2Gm5FG/WG1SqXeKyZ0k7/blY/4FdOzI12CBy1vGc4og/eus0fw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "peer": true,
+      "bin": {
+        "tsc": "bin/tsc",
+        "tsserver": "bin/tsserver"
+      },
+      "engines": {
+        "node": ">=14.17"
+      }
+    },
+    "node_modules/typical": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/typical/-/typical-4.0.0.tgz",
+      "integrity": "sha512-VAH4IvQ7BDFYglMd7BPRDfLgxZZX4O4TFcRDA6EN5X7erNJJq+McIEp8np9aVtxrCJ6qx4GTYVfOWNjcqwZgRw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/uglify-js": {
+      "version": "3.19.3",
+      "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz",
+      "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "optional": true,
+      "peer": true,
+      "bin": {
+        "uglifyjs": "bin/uglifyjs"
+      },
+      "engines": {
+        "node": ">=0.8.0"
+      }
+    },
+    "node_modules/undici": {
+      "version": "5.28.5",
+      "resolved": "https://registry.npmjs.org/undici/-/undici-5.28.5.tgz",
+      "integrity": "sha512-zICwjrDrcrUE0pyyJc1I2QzBkLM8FINsgOrt6WjA+BgajVq9Nxu2PbFFXUrAggLfDXlZGZBVZYw7WNV5KiBiBA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@fastify/busboy": "^2.0.0"
+      },
+      "engines": {
+        "node": ">=14.0"
+      }
+    },
+    "node_modules/undici-types": {
+      "version": "6.20.0",
+      "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.20.0.tgz",
+      "integrity": "sha512-Ny6QZ2Nju20vw1SRHe3d9jVu6gJ+4e3+MMpqu7pqE5HT6WsTSlce++GQmK5UXS8mzV8DSYHrQH+Xrf2jVcuKNg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/universalify": {
+      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/universalify/-/universalify-2.0.1.tgz",
+      "integrity": "sha512-gptHNQghINnc/vTGIk0SOFGFNXw7JVrlRUtConJRlvaw6DuX0wO5Jeko9sWrMBhh+PsYAZ7oXAiOnf/UKogyiw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 10.0.0"
+      }
+    },
+    "node_modules/unpipe": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
+      "integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/utf8": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/utf8/-/utf8-3.0.0.tgz",
+      "integrity": "sha512-E8VjFIQ/TyQgp+TZfS6l8yp/xWppSAHzidGiRrqe4bK4XP9pTRyKFgGJpO3SN7zdX4DeomTrwaseCHovfpFcqQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/util-deprecate": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz",
+      "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/uuid": {
+      "version": "8.3.2",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-8.3.2.tgz",
+      "integrity": "sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==",
+      "dev": true,
+      "license": "MIT",
+      "bin": {
+        "uuid": "dist/bin/uuid"
+      }
+    },
+    "node_modules/v8-compile-cache-lib": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/v8-compile-cache-lib/-/v8-compile-cache-lib-3.0.1.tgz",
+      "integrity": "sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/viem": {
+      "version": "2.31.4",
+      "resolved": "https://registry.npmjs.org/viem/-/viem-2.31.4.tgz",
+      "integrity": "sha512-0UZ/asvzl6p44CIBRDbwEcn3HXIQQurBZcMo5qmLhQ8s27Ockk+RYohgTLlpLvkYs8/t4UUEREAbHLuek1kXcw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/wevm"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "1.9.2",
+        "@noble/hashes": "1.8.0",
+        "@scure/bip32": "1.7.0",
+        "@scure/bip39": "1.6.0",
+        "abitype": "1.0.8",
+        "isows": "1.0.7",
+        "ox": "0.8.1",
+        "ws": "8.18.2"
+      },
+      "peerDependencies": {
+        "typescript": ">=5.0.4"
+      },
+      "peerDependenciesMeta": {
+        "typescript": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/viem/node_modules/@noble/curves": {
+      "version": "1.9.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.9.2.tgz",
+      "integrity": "sha512-HxngEd2XUcg9xi20JkwlLCtYwfoFw4JGkuZpT+WlsPD4gB/cxkvTD8fSsoAnphGZhFdZYKeQIPCuFlWPm1uE0g==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.8.0"
+      },
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/viem/node_modules/@noble/hashes": {
+      "version": "1.8.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz",
+      "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": "^14.21.3 || >=16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/viem/node_modules/@scure/base": {
+      "version": "1.2.6",
+      "resolved": "https://registry.npmjs.org/@scure/base/-/base-1.2.6.tgz",
+      "integrity": "sha512-g/nm5FgUa//MCj1gV09zTJTaM6KBAHqLN907YVQqf7zC49+DcO4B1so4ZX07Ef10Twr6nuqYEH9GEggFXA4Fmg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/viem/node_modules/@scure/bip32": {
+      "version": "1.7.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip32/-/bip32-1.7.0.tgz",
+      "integrity": "sha512-E4FFX/N3f4B80AKWp5dP6ow+flD1LQZo/w8UnLGYZO674jS6YnYeepycOOksv+vLPSpgN35wgKgy+ybfTb2SMw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "~1.9.0",
+        "@noble/hashes": "~1.8.0",
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/viem/node_modules/@scure/bip39": {
+      "version": "1.6.0",
+      "resolved": "https://registry.npmjs.org/@scure/bip39/-/bip39-1.6.0.tgz",
+      "integrity": "sha512-+lF0BbLiJNwVlev4eKelw1WWLaiKXw7sSl8T6FvBlWkdX+94aGJ4o8XjUdlyhTCjd8c+B3KT3JfS8P0bLRNU6A==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "~1.8.0",
+        "@scure/base": "~1.2.5"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/viem/node_modules/ws": {
+      "version": "8.18.2",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.18.2.tgz",
+      "integrity": "sha512-DMricUmwGZUVr++AEAe2uiVM7UoO9MAVZMDu05UQOaUII0lp+zOzLLU4Xqh/JvTqklB1T4uELaaPBKyjE1r4fQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/web3-utils": {
+      "version": "1.10.4",
+      "resolved": "https://registry.npmjs.org/web3-utils/-/web3-utils-1.10.4.tgz",
+      "integrity": "sha512-tsu8FiKJLk2PzhDl9fXbGUWTkkVXYhtTA+SmEFkKft+9BgwLxfCRpU96sWv7ICC8zixBNd3JURVoiR3dUXgP8A==",
+      "dev": true,
+      "license": "LGPL-3.0",
+      "peer": true,
+      "dependencies": {
+        "@ethereumjs/util": "^8.1.0",
+        "bn.js": "^5.2.1",
+        "ethereum-bloom-filters": "^1.0.6",
+        "ethereum-cryptography": "^2.1.2",
+        "ethjs-unit": "0.1.6",
+        "number-to-bn": "1.7.0",
+        "randombytes": "^2.1.0",
+        "utf8": "3.0.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/web3-utils/node_modules/@noble/curves": {
+      "version": "1.4.2",
+      "resolved": "https://registry.npmjs.org/@noble/curves/-/curves-1.4.2.tgz",
+      "integrity": "sha512-TavHr8qycMChk8UwMld0ZDRvatedkzWfH8IiaeGCfymOP5i0hSCozz9vHOL0nkwk7HRMlFnAiKpS2jrUmSybcw==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/hashes": "1.4.0"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/web3-utils/node_modules/@noble/hashes": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.4.0.tgz",
+      "integrity": "sha512-V1JJ1WTRUqHHrOSh597hURcMqVKVGL/ea3kv0gSnEdsEZ0/+VyPghM1lMNGc00z7CIQorSvbKpuJkxvuHbvdbg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">= 16"
+      },
+      "funding": {
+        "url": "https://paulmillr.com/funding/"
+      }
+    },
+    "node_modules/web3-utils/node_modules/ethereum-cryptography": {
+      "version": "2.2.1",
+      "resolved": "https://registry.npmjs.org/ethereum-cryptography/-/ethereum-cryptography-2.2.1.tgz",
+      "integrity": "sha512-r/W8lkHSiTLxUxW8Rf3u4HGB0xQweG2RyETjywylKZSzLWoWAijRz8WCuOtJ6wah+avllXBqZuk29HCCvhEIRg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "@noble/curves": "1.4.2",
+        "@noble/hashes": "1.4.0",
+        "@scure/bip32": "1.4.0",
+        "@scure/bip39": "1.3.0"
+      }
+    },
+    "node_modules/which": {
+      "version": "1.3.1",
+      "resolved": "https://registry.npmjs.org/which/-/which-1.3.1.tgz",
+      "integrity": "sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==",
+      "dev": true,
+      "license": "ISC",
+      "peer": true,
+      "dependencies": {
+        "isexe": "^2.0.0"
+      },
+      "bin": {
+        "which": "bin/which"
+      }
+    },
+    "node_modules/widest-line": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/widest-line/-/widest-line-3.1.0.tgz",
+      "integrity": "sha512-NsmoXalsWVDMGupxZ5R08ka9flZjjiLvHVAWYOKtiKM8ujtZWr9cRffak+uSE48+Ob8ObalXpwyeUiyDD6QFgg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "string-width": "^4.0.0"
+      },
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/word-wrap": {
+      "version": "1.2.5",
+      "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz",
+      "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/wordwrap": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz",
+      "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true
+    },
+    "node_modules/wordwrapjs": {
+      "version": "4.0.1",
+      "resolved": "https://registry.npmjs.org/wordwrapjs/-/wordwrapjs-4.0.1.tgz",
+      "integrity": "sha512-kKlNACbvHrkpIw6oPeYDSmdCTu2hdMHoyXLTcUKala++lx5Y+wjJ/e474Jqv5abnVmwxw08DiTuHmw69lJGksA==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "reduce-flatten": "^2.0.0",
+        "typical": "^5.2.0"
+      },
+      "engines": {
+        "node": ">=8.0.0"
+      }
+    },
+    "node_modules/wordwrapjs/node_modules/typical": {
+      "version": "5.2.0",
+      "resolved": "https://registry.npmjs.org/typical/-/typical-5.2.0.tgz",
+      "integrity": "sha512-dvdQgNDNJo+8B2uBQoqdb11eUCE1JQXhvjC/CZtgvZseVd5TYMXnq0+vuUemXbd/Se29cTaUuPX3YIc2xgbvIg==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=8"
+      }
+    },
+    "node_modules/workerpool": {
+      "version": "6.5.1",
+      "resolved": "https://registry.npmjs.org/workerpool/-/workerpool-6.5.1.tgz",
+      "integrity": "sha512-Fs4dNYcsdpYSAfVxhnl1L5zTksjvOJxtC5hzMNl+1t9B8hTJTdKDyZ5ju7ztgPy+ft9tBFXoOlDNiOT9WUXZlA==",
+      "dev": true,
+      "license": "Apache-2.0"
+    },
+    "node_modules/wrap-ansi": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrap-ansi-cjs": {
+      "name": "wrap-ansi",
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz",
+      "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "dependencies": {
+        "ansi-styles": "^4.0.0",
+        "string-width": "^4.1.0",
+        "strip-ansi": "^6.0.0"
+      },
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/chalk/wrap-ansi?sponsor=1"
+      }
+    },
+    "node_modules/wrappy": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz",
+      "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/ws": {
+      "version": "8.17.1",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.17.1.tgz",
+      "integrity": "sha512-6XQFvXTkbfUOZOKKILFG1PDK2NDQs4azKQl26T0YS5CxqWLgXajbPZ+h4gZekJyRqFU8pvnbAbbs/3TgRPy+GQ==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/y18n": {
+      "version": "5.0.8",
+      "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz",
+      "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yargs": {
+      "version": "16.2.0",
+      "resolved": "https://registry.npmjs.org/yargs/-/yargs-16.2.0.tgz",
+      "integrity": "sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cliui": "^7.0.2",
+        "escalade": "^3.1.1",
+        "get-caller-file": "^2.0.5",
+        "require-directory": "^2.1.1",
+        "string-width": "^4.2.0",
+        "y18n": "^5.0.5",
+        "yargs-parser": "^20.2.2"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yargs-parser": {
+      "version": "20.2.9",
+      "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-20.2.9.tgz",
+      "integrity": "sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==",
+      "dev": true,
+      "license": "ISC",
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yargs-unparser": {
+      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/yargs-unparser/-/yargs-unparser-2.0.0.tgz",
+      "integrity": "sha512-7pRTIA9Qc1caZ0bZ6RYRGbHJthJWuakf+WmHK0rVeLkNrrGhfoabBNdue6kdINI6r4if7ocq9aD/n7xwKOdzOA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "camelcase": "^6.0.0",
+        "decamelize": "^4.0.0",
+        "flat": "^5.0.2",
+        "is-plain-obj": "^2.1.0"
+      },
+      "engines": {
+        "node": ">=10"
+      }
+    },
+    "node_modules/yn": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/yn/-/yn-3.1.1.tgz",
+      "integrity": "sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==",
+      "dev": true,
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/yocto-queue": {
+      "version": "0.1.0",
+      "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz",
+      "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/sindresorhus"
+      }
+    }
+  }
+}
diff --git a/packages/core/solidity/src/environments/hardhat/optimism/package.json b/packages/core/solidity/src/environments/hardhat/optimism/package.json
new file mode 100644
index 000000000..c118cfdd7
--- /dev/null
+++ b/packages/core/solidity/src/environments/hardhat/optimism/package.json
@@ -0,0 +1,17 @@
+{
+  "name": "hardhat-sample",
+  "version": "0.0.1",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "hardhat test"
+  },
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@openzeppelin/contracts": "^5.0.0",
+    "@eth-optimism/contracts-bedrock": "^0.17.3",
+    "@nomicfoundation/hardhat-toolbox": "^6.0.0",
+    "hardhat": "^2.16.1"
+  }
+}
\ No newline at end of file
diff --git a/packages/core/solidity/src/zip-hardhat.test.ts b/packages/core/solidity/src/zip-hardhat.test.ts
index b8383e896..58a0d7a1d 100644
--- a/packages/core/solidity/src/zip-hardhat.test.ts
+++ b/packages/core/solidity/src/zip-hardhat.test.ts
@@ -77,6 +77,12 @@ test.serial('custom basic', async t => {
   await runIgnitionTest(c, t, opts);
 });
 
+test.serial('custom cross chain messaging superchain', async t => {
+  const opts: GenericOptions = { kind: 'Custom', name: 'My Contract', crossChainMessaging: 'superchain' };
+  const c = buildCustom(opts);
+  await runIgnitionTest(c, t, opts);
+});
+
 test.serial('custom upgradeable', async t => {
   const opts: GenericOptions = {
     kind: 'Custom',
@@ -87,6 +93,17 @@ test.serial('custom upgradeable', async t => {
   await runDeployScriptTest(c, t, opts);
 });
 
+test.serial('custom upgradeable cross chain messaging superchain', async t => {
+  const opts: GenericOptions = {
+    kind: 'Custom',
+    name: 'My Contract',
+    upgradeable: 'transparent',
+    crossChainMessaging: 'superchain',
+  };
+  const c = buildCustom(opts);
+  await runDeployScriptTest(c, t, opts);
+});
+
 async function runDeployScriptTest(c: Contract, t: ExecutionContext<Context>, opts: GenericOptions) {
   const zip = await zipHardhat(c, opts);
 
diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.md b/packages/core/solidity/src/zip-hardhat.test.ts.md
index 71c7a583b..bf61f44c1 100644
--- a/packages/core/solidity/src/zip-hardhat.test.ts.md
+++ b/packages/core/solidity/src/zip-hardhat.test.ts.md
@@ -389,6 +389,107 @@ Generated by [AVA](https://avajs.dev).
       `,
     ]
 
+## custom cross chain messaging superchain
+
+> Snapshot 1
+
+    [
+      `// SPDX-License-Identifier: MIT␊
+      // Compatible with OpenZeppelin Contracts ^5.0.0␊
+      pragma solidity ^0.8.27;␊
+      ␊
+      import {IL2ToL2CrossDomainMessenger} from "@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol";␊
+      import {Predeploys} from "@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol";␊
+      ␊
+      contract MyContract {␊
+          IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);␊
+      ␊
+          error CallerNotL2ToL2CrossDomainMessenger();␊
+          error InvalidCrossDomainSender();␊
+          error InvalidDestination();␊
+      ␊
+          modifier onlyCrossDomainCallback() {␊
+              if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
+              if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();␊
+              _;␊
+          }␊
+      ␊
+          // NOTE: Anyone can call this function␊
+          function callMyFunction(uint256 _toChainId) public {␊
+              if (_toChainId == block.chainid) revert InvalidDestination();␊
+              messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+          }␊
+      ␊
+          /**␊
+           * @dev IMPORTANT: This function trusts contracts at the same address on other chains.␊
+           * If an unauthorized contract is deployed at the same address on any chain in the Superchain, it could allow␊
+           * malicious actors to invoke your function from that chain.␊
+           * To prevent this, you must either design the deployer to allow only this contract's bytecode to be deployed␊
+           * through it, or use CREATE2 from a deployer contract that is itself deployed by an EOA you control.␊
+           */␊
+          function myFunction(/* TODO: Add arguments */) external onlyCrossDomainCallback {␊
+              // TODO: Implement logic for the function that will be called from another chain␊
+          }␊
+      }␊
+      `,
+      `import { HardhatUserConfig } from "hardhat/config";␊
+      import "@nomicfoundation/hardhat-toolbox";␊
+      ␊
+      ␊
+      const config: HardhatUserConfig = {␊
+        solidity: {␊
+          version: "0.8.27",␊
+          settings: {␊
+            optimizer: {␊
+              enabled: true,␊
+            },␊
+          },␊
+        },␊
+      };␊
+      ␊
+      export default config;␊
+      `,
+      `{␊
+        "name": "hardhat-sample",␊
+        "version": "0.0.1",␊
+        "description": "",␊
+        "main": "index.js",␊
+        "scripts": {␊
+          "test": "hardhat test"␊
+        },␊
+        "author": "",␊
+        "license": "MIT",␊
+        "devDependencies": {␊
+          "@openzeppelin/contracts": "^5.0.0",␊
+          "@eth-optimism/contracts-bedrock": "^0.17.3",␊
+          "@nomicfoundation/hardhat-toolbox": "^6.0.0",␊
+          "hardhat": "^2.16.1"␊
+        }␊
+      }`,
+      `import { buildModule } from "@nomicfoundation/hardhat-ignition/modules";␊
+      ␊
+      export default buildModule("MyContractModule", (m) => {␊
+      ␊
+        ␊
+        const myContract = m.contract("MyContract", []);␊
+      ␊
+        return { myContract };␊
+      });␊
+      `,
+      `import { expect } from "chai";␊
+      import { ethers } from "hardhat";␊
+      ␊
+      describe("MyContract", function () {␊
+        it("Test contract", async function () {␊
+          const ContractFactory = await ethers.getContractFactory("MyContract");␊
+      ␊
+          const instance = await ContractFactory.deploy();␊
+          await instance.waitForDeployment();␊
+        });␊
+      });␊
+      `,
+    ]
+
 ## custom upgradeable
 
 > Snapshot 1
diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.snap b/packages/core/solidity/src/zip-hardhat.test.ts.snap
index 1863649b69c254aa8a5b26bc602497cd6d4b0cc9..2591c65cbb6ee0f72b9e616edef46a38135b80f2 100644
GIT binary patch
literal 3066
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
IV4FPv0ET7eFaQ7m

literal 2366
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

diff --git a/packages/core/solidity/src/zip-hardhat.ts b/packages/core/solidity/src/zip-hardhat.ts
index 490a693b9..4397ccbbe 100644
--- a/packages/core/solidity/src/zip-hardhat.ts
+++ b/packages/core/solidity/src/zip-hardhat.ts
@@ -202,14 +202,28 @@ function getHardhatPlugins(c: Contract) {
 export async function zipHardhat(c: Contract, opts?: GenericOptions) {
   const zip = new JSZip();
 
-  const { default: packageJson } = c.upgradeable
-    ? await import('./environments/hardhat/upgradeable/package.json')
-    : await import('./environments/hardhat/package.json');
-  packageJson.license = c.license;
+  const importsOptimism = c.imports.some((i) => i.path.startsWith('@eth-optimism/contracts-bedrock/'));
+
+  let packageJson, packageLock;
+  if (importsOptimism) {
+    if (c.upgradeable) {
+      packageJson = (await import('./environments/hardhat/optimism-upgradeable/package.json')).default;
+      packageLock = (await import('./environments/hardhat/optimism-upgradeable/package-lock.json')).default;
+    } else {
+      packageJson = (await import('./environments/hardhat/optimism/package.json')).default;
+      packageLock = (await import('./environments/hardhat/optimism/package-lock.json')).default;
+    }
+  } else {
+    if (c.upgradeable) {
+      packageJson = (await import('./environments/hardhat/upgradeable/package.json')).default;
+      packageLock = (await import('./environments/hardhat/upgradeable/package-lock.json')).default;
+    } else {
+      packageJson = (await import('./environments/hardhat/package.json')).default;
+      packageLock = (await import('./environments/hardhat/package-lock.json')).default;
+    }
+  }
 
-  const { default: packageLock } = c.upgradeable
-    ? await import('./environments/hardhat/upgradeable/package-lock.json')
-    : await import('./environments/hardhat/package-lock.json');
+  packageJson.license = c.license;
   packageLock.packages[''].license = c.license;
 
   zip.file(`contracts/${c.name}.sol`, printContract(c));

From af6c21055854ff902ee8c70997add56cf4bb0479 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 13:50:50 -0400
Subject: [PATCH 34/54] Add natspec tag to allow immutable

---
 .../solidity/src/add-superchain-messaging.ts  |   8 ++
 packages/core/solidity/src/contract.ts        |  19 ++-
 packages/core/solidity/src/custom.test.ts.md  |   2 +
 .../core/solidity/src/custom.test.ts.snap     | Bin 1605 -> 1625 bytes
 packages/core/solidity/src/print.ts           |  20 ++-
 .../core/solidity/src/zip-hardhat.test.ts.md  | 120 ++++++++++++++++++
 .../solidity/src/zip-hardhat.test.ts.snap     | Bin 3066 -> 3191 bytes
 7 files changed, 158 insertions(+), 11 deletions(-)

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index 53afa5187..bf13ff50c 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -42,8 +42,16 @@ function addCrossDomainMessengerImmutable(c: ContractBuilder) {
     path: '@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol',
     transpiled: false,
   });
+
+  const allowImmutableNatspec = {
+    key: '@custom:oz-upgrades-unsafe-allow',
+    value: 'state-variable-immutable',
+  };
   c.addVariable(
     'IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);',
+    [
+      allowImmutableNatspec
+    ],
   );
 }
 
diff --git a/packages/core/solidity/src/contract.ts b/packages/core/solidity/src/contract.ts
index 9fa6c666b..c969dfa06 100644
--- a/packages/core/solidity/src/contract.ts
+++ b/packages/core/solidity/src/contract.ts
@@ -9,7 +9,7 @@ export interface Contract {
   functions: ContractFunction[];
   constructorCode: string[];
   constructorArgs: FunctionArgument[];
-  variables: string[];
+  variables: Variable[];
   upgradeable: boolean;
   customErrors: CustomError[];
   modifierDefinitions: ModifierDefinition[];
@@ -19,6 +19,11 @@ export interface CustomError {
   name: string;
 }
 
+export interface Variable {
+  code: string;
+  natspecTags?: NatspecTag[];
+}
+
 export type Value = string | number | { lit: string } | { note: string; value: Value };
 
 export interface Parent {
@@ -94,12 +99,12 @@ export class ContractBuilder implements Contract {
 
   readonly constructorArgs: FunctionArgument[] = [];
   readonly constructorCode: string[] = [];
-  readonly variableSet: Set<string> = new Set();
   readonly customErrorSet: Set<string> = new Set();
 
   private parentMap: Map<string, Parent> = new Map<string, Parent>();
   private functionMap: Map<string, ContractFunction> = new Map();
   private modifierDefinitionsMap: Map<string, ModifierDefinition> = new Map<string, ModifierDefinition>();
+  private variableMap: Map<string, Variable> = new Map<string, Variable>();
 
   constructor(name: string) {
     this.name = toIdentifier(name, true);
@@ -127,8 +132,8 @@ export class ContractBuilder implements Contract {
     return [...this.functionMap.values()];
   }
 
-  get variables(): string[] {
-    return [...this.variableSet];
+  get variables(): Variable[] {
+    return [...this.variableMap.values()];
   }
 
   get customErrors(): CustomError[] {
@@ -236,9 +241,9 @@ export class ContractBuilder implements Contract {
   /**
    * Note: The type in the variable is not currently transpiled, even if it refers to a contract
    */
-  addVariable(code: string): boolean {
-    const present = this.variableSet.has(code);
-    this.variableSet.add(code);
+  addVariable(code: string, natspecTags?: NatspecTag[]): boolean {
+    const present = this.variableMap.has(code);
+    this.variableMap.set(code, { code, natspecTags });
     return !present;
   }
 
diff --git a/packages/core/solidity/src/custom.test.ts.md b/packages/core/solidity/src/custom.test.ts.md
index a8bb3cf8e..80692f2dc 100644
--- a/packages/core/solidity/src/custom.test.ts.md
+++ b/packages/core/solidity/src/custom.test.ts.md
@@ -172,6 +172,7 @@ Generated by [AVA](https://avajs.dev).
     import {Predeploys} from "@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol";␊
     ␊
     contract MyContract {␊
+        /// @custom:oz-upgrades-unsafe-allow state-variable-immutable␊
         IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);␊
     ␊
         error CallerNotL2ToL2CrossDomainMessenger();␊
@@ -217,6 +218,7 @@ Generated by [AVA](https://avajs.dev).
     import {Predeploys} from "@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol";␊
     ␊
     contract MyContract is Ownable, Pausable {␊
+        /// @custom:oz-upgrades-unsafe-allow state-variable-immutable␊
         IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);␊
     ␊
         error CallerNotL2ToL2CrossDomainMessenger();␊
diff --git a/packages/core/solidity/src/custom.test.ts.snap b/packages/core/solidity/src/custom.test.ts.snap
index d22c479f7319ab9fdf2109ab2445b19733b0c0f8..78a994e4c0febefa1c195def0ae67506c3d4332c 100644
GIT binary patch
literal 1625
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
XF`JJun~yPf_A%y9ZzOx2X(9jsUM>*r

literal 1605
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
D_wWEU

diff --git a/packages/core/solidity/src/print.ts b/packages/core/solidity/src/print.ts
index 033ca97f7..523c6c946 100644
--- a/packages/core/solidity/src/print.ts
+++ b/packages/core/solidity/src/print.ts
@@ -8,6 +8,7 @@ import type {
   ImportContract,
   CustomError,
   ModifierDefinition,
+  Variable,
 } from './contract';
 import type { Options, Helpers } from './options';
 import { withHelpers } from './options';
@@ -42,7 +43,7 @@ export function printContract(contract: Contract, opts?: Options): string {
         [`contract ${contract.name}`, ...printInheritance(contract, helpers), '{'].join(' '),
 
         spaceBetween(
-          contract.variables,
+          printVariables(contract.variables),
           printCustomErrors(contract.customErrors),
           printModifierDefinitions(contract.modifierDefinitions),
           printConstructor(contract, helpers),
@@ -58,6 +59,17 @@ export function printContract(contract: Contract, opts?: Options): string {
   );
 }
 
+function printVariables(variables: Variable[]): Lines[] {
+  return variables.flatMap(v => {
+    const lines: Lines[] = [];
+    if (v.natspecTags) {
+      lines.push(...printNatspecTags(v.natspecTags));
+    }
+    lines.push(v.code);
+    return lines;
+  });
+}
+
 function printCustomErrors(errors: CustomError[]): Lines[] {
   return errors.map(e => `error ${e.name}();`);
 }
@@ -84,9 +96,9 @@ function printConstructor(contract: Contract, helpers: Helpers): Lines[] {
     const args = contract.constructorArgs.map(a => printArgument(a, helpers));
     const body = helpers.upgradeable
       ? spaceBetween(
-          parents.map(p => p + ';'),
-          contract.constructorCode,
-        )
+        parents.map(p => p + ';'),
+        contract.constructorCode,
+      )
       : contract.constructorCode;
     const head = helpers.upgradeable ? 'function initialize' : 'constructor';
     const constructor = printFunction2([], head, args, undefined, modifiers, body);
diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.md b/packages/core/solidity/src/zip-hardhat.test.ts.md
index bf61f44c1..d61155a5f 100644
--- a/packages/core/solidity/src/zip-hardhat.test.ts.md
+++ b/packages/core/solidity/src/zip-hardhat.test.ts.md
@@ -402,6 +402,7 @@ Generated by [AVA](https://avajs.dev).
       import {Predeploys} from "@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol";␊
       ␊
       contract MyContract {␊
+          /// @custom:oz-upgrades-unsafe-allow state-variable-immutable␊
           IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);␊
       ␊
           error CallerNotL2ToL2CrossDomainMessenger();␊
@@ -575,3 +576,122 @@ Generated by [AVA](https://avajs.dev).
       });␊
       `,
     ]
+
+## custom upgradeable cross chain messaging superchain
+
+> Snapshot 1
+
+    [
+      `// SPDX-License-Identifier: MIT␊
+      // Compatible with OpenZeppelin Contracts ^5.0.0␊
+      pragma solidity ^0.8.27;␊
+      ␊
+      import {IL2ToL2CrossDomainMessenger} from "@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol";␊
+      import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";␊
+      import {Predeploys} from "@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol";␊
+      ␊
+      contract MyContract is Initializable {␊
+          /// @custom:oz-upgrades-unsafe-allow state-variable-immutable␊
+          IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);␊
+      ␊
+          error CallerNotL2ToL2CrossDomainMessenger();␊
+          error InvalidCrossDomainSender();␊
+          error InvalidDestination();␊
+      ␊
+          modifier onlyCrossDomainCallback() {␊
+              if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
+              if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();␊
+              _;␊
+          }␊
+      ␊
+          /// @custom:oz-upgrades-unsafe-allow constructor␊
+          constructor() {␊
+              _disableInitializers();␊
+          }␊
+      ␊
+          // NOTE: Anyone can call this function␊
+          function callMyFunction(uint256 _toChainId) public {␊
+              if (_toChainId == block.chainid) revert InvalidDestination();␊
+              messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+          }␊
+      ␊
+          /**␊
+           * @dev IMPORTANT: This function trusts contracts at the same address on other chains.␊
+           * If an unauthorized contract is deployed at the same address on any chain in the Superchain, it could allow␊
+           * malicious actors to invoke your function from that chain.␊
+           * To prevent this, you must either design the deployer to allow only this contract's bytecode to be deployed␊
+           * through it, or use CREATE2 from a deployer contract that is itself deployed by an EOA you control.␊
+           */␊
+          function myFunction(/* TODO: Add arguments */) external onlyCrossDomainCallback {␊
+              // TODO: Implement logic for the function that will be called from another chain␊
+          }␊
+      }␊
+      `,
+      `import { HardhatUserConfig } from "hardhat/config";␊
+      import "@nomicfoundation/hardhat-toolbox";␊
+      import "@openzeppelin/hardhat-upgrades";␊
+      ␊
+      const config: HardhatUserConfig = {␊
+        solidity: {␊
+          version: "0.8.27",␊
+          settings: {␊
+            optimizer: {␊
+              enabled: true,␊
+            },␊
+          },␊
+        },␊
+      };␊
+      ␊
+      export default config;␊
+      `,
+      `{␊
+        "name": "hardhat-sample",␊
+        "version": "0.0.1",␊
+        "description": "",␊
+        "main": "index.js",␊
+        "scripts": {␊
+          "test": "hardhat test"␊
+        },␊
+        "author": "",␊
+        "license": "MIT",␊
+        "devDependencies": {␊
+          "@openzeppelin/contracts": "^5.0.0",␊
+          "@openzeppelin/contracts-upgradeable": "^5.0.0",␊
+          "@openzeppelin/hardhat-upgrades": "^3.0.0",␊
+          "@eth-optimism/contracts-bedrock": "^0.17.3",␊
+          "@nomicfoundation/hardhat-toolbox": "^6.0.0",␊
+          "hardhat": "^2.16.1"␊
+        }␊
+      }`,
+      `import { ethers, upgrades } from "hardhat";␊
+      ␊
+      async function main() {␊
+        const ContractFactory = await ethers.getContractFactory("MyContract");␊
+      ␊
+        ␊
+        const instance = await upgrades.deployProxy(ContractFactory, []);␊
+        await instance.waitForDeployment();␊
+      ␊
+        console.log(\`Proxy deployed to ${await instance.getAddress()}\`);␊
+      }␊
+      ␊
+      // We recommend this pattern to be able to use async/await everywhere␊
+      // and properly handle errors.␊
+      main().catch((error) => {␊
+        console.error(error);␊
+        process.exitCode = 1;␊
+      });␊
+      `,
+      `import { expect } from "chai";␊
+      import { ethers, upgrades } from "hardhat";␊
+      ␊
+      describe("MyContract", function () {␊
+        it("Test contract", async function () {␊
+          const ContractFactory = await ethers.getContractFactory("MyContract");␊
+      ␊
+          const instance = await upgrades.deployProxy(ContractFactory, []);␊
+          await instance.waitForDeployment();␊
+        });␊
+      });␊
+      `,
+    ]
diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.snap b/packages/core/solidity/src/zip-hardhat.test.ts.snap
index 2591c65cbb6ee0f72b9e616edef46a38135b80f2..b8175c86d6313339b6a8ffb52d5834da93db99bb 100644
GIT binary patch
literal 3191
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

literal 3066
zcmV<W3kCE+RzV<BZeeh9Xm4~Nb~6eC00fOVmgRSO501&d$Q}KgnEtpZz}_BcVImIr
z>%Q&h0UwJ900000000B+T1#&u#}OXx!@H&p8;1P@DntSg1!_ofvAcm}1uIM1M2KFH
zsJs?7-JEHXZOwGk-93`Hf(}7~`~shHih}??<QL=`Ag3I1^fiG0K@K?vK|kif;YeDp
z?A<ji0lU)lRM)GktG?>#FZ#WZ`G?{Uf5wu?5Pyof-)=!a4nra+8i^s3;<sM}0g~v~
zZ+(5!x#Osx%H7IqA2^Qlq2oBezw0=Eecf@KHyr1KHy!8Q%4_dbZm)2T#+6F)*V}Ku
z?Nq8x<+f9K(|NaY!+EcA)2ZBk=SJ&pvkCjVYrmS`BtE7B&u;{nO428oFT&PFr`l}7
zDvL%)l3s}6n8+dQj4=HT9*uBFD6BFnIr61|kMDaeuT>p!G>8xg7LtI-F?`(ee(bd$
zE>)`}8Zj>6bjA0v5PBjD&!Ep)1hq$Ogy~buwdp5Zn@AHkC+2v9g|(%W-}>HayLA~K
z$qq4XYEtum8IuoVPEjw!voOOa5>r7K70n4AW&9t9NDQ|Kl~)mvGAWa=i(+wA3lbis
z{4tNnmDD#J%6R{RNi43yS~Dnc-e%OloNFveD4K@WGN>kRVQbt`LV*a-Vj3{9(DpI$
zS_39xHF>M8whvlQ`**sUa9RZb=#3>7_u4Rudm-_`XH-Z;CG4&o?62>2_jWedVHpmw
z@1w)^{ReI>_o7x`x{$}##&)NaNA88<p_%AeJoY8yE(!vUg#eCyG9sAD1|&lP?xQ%A
zD?vnPHabGFz&v}72$h)EHDmRoO?PWsW6-XxHK4ZD`FX8CV4RjCGw)ARs;=Ve=Co?J
zS}mA^g%-@sL4bV{p-{MW>lZy`z!8;uEX3~G`s0;@%}#e^ZEIs&8{e2Pr+ik<-wkVL
zIbqJJjl=<l@XUC)A5&ivMhzFYo~#$6;kYQOp10c4motm$tnAVm<qWltlZBM50WqPn
zeg6TVh{aS+%gGsDpIR)%z)qYH*K9&(h@sEIkR1~`NaYJa90NPToRa{n82l_I90$-F
z!@eytUP0w<JPMG+sn%-qXTg}a;RuB>&caTw5=CJ;kjQoOJ3rg%*>*05rie$Fdx;`O
z0VUW7EcZ0k`6tzy9n<`tF>X#Dj|e_KN6jSJn0%IT;8@0-3UICUMV-xitGZRjD3R!U
zR<#JCQb{1hdzB>B!p{&7hDaU=%vTxhlK~`ocWB<IjN2!JEIrpAQ5F%u&te)N<%6cB
zoR^G+J$9lJaaE@xFmo46q%3P262!4+Ejq$n)rLi=83a;m=wX4SBy=DaQ^VOvl88K2
zh$r&}*10`c1j%FEu)}BO5B=+`Q9WC#R`H28#O4jF<WlOU8;P4ftSH_!iXvQFOdT>W
zP&5j$R;^|gu4#>1-hvqou<$t<N&ChOMu_MqLIZr_eJaeTAr!U5j+(?m=A?msu37_X
zD3(LUGp3<|fNEfCqmxKKTEinu15AB_bF9y)q-wGOg4W%audtf&AV0$r=of8o;eofH
zb*`QzPQ95pwVuUZFD7BI#ez7*Y1Ex7nhYq>1CgE}YSRmu<EILcu0Q6n)&MuE!}3qy
zRPA4txOUcd7GWRDB*kC>ea1l!F{CI0@j)D6Dh2d#$kf&~VI5g?u?&%y5T_Dr4S13(
zZ<EC~DYB-vd}Io@-NUCT-?OFaSv?ELTZ!*JzmfV5pNz0CQ@8m;L~;lUupDA8ihEi4
z%*197=k-mqnQM~2D&QS#_OCXs)&L~N)SseEJd(5&kC6f&V^{`sjEJ;)cmpg86q)!5
z@RGq5SO&MqW1kEt<_a7<X?^6`g<Hza&O7@O1`DMO%=%n1wOu;ZEa@dv@8zcE<`Rwe
ze4P5N;4Lq}qmYf=XN)VG`wgpvx2K*SGrp!-sjzkv*PCE+3-l`Qx%IjynTJ1%QJ4pH
zN`MMc_0KlK9CQC+djaCnfTIAbR6N}fzwyVihWOx?<NW2e<9vL_alU+g)`qxp>m@YA
z>wBvY+Y1Mot(UYb^EtO<4bj8)LUW2!p&Qyzc@Kr;>8w&loSlqqn>4|sAYkWM*Ujg&
z#WwrXObSvC4tDpSQ$*g70-K8(zX_W)?wj;;1E!U3KtX`ba?NHF9{I75ELvnw6Ya!&
zOa<!Wd880<zWthN$0ks9Kr|Lj71YV09AA=@CdHU`Xh);G1j%P~JTIwhtnRAUCB0j&
z3F=yB7}5zDd8&eY4D~s>cMV!0PZJNPCQy95p+J<%Lb}X91DwwWXgJo287N$ea6kCA
z5pGI45x)st5+61+zw=1=%kM1`zC1l$Hfbs*6#cyy1-BpEC}6@yQlLxGVFBf-m9nYp
z8^U>4h2B$0DY3>vq+L}j+=3Dfc#=<OAL)GcjOa*-Wg+%LHgG@D+`&k~0Z0ZvJT34U
zV7X$<a_eWGD2P;5_~VyYL0c9@m<Aw+M4h)umFX0d9tK@&B!gIB1GSshu}7GXkB69J
z#Rbs-Mx2c>563V>Gzc+Z&KVb8)vT50Bk2!aSC86`Co@8i+IPwaBhFOy_V5Xjt1M7n
zT{x%r_;+Qt-s9ppd&Rque6-Bah+Kr|pF2)pG>(rj_ZJrK--jL&#Gi)ncm7cZ;UC{{
zoam<G{QZ{We0_UX2>+kT%YpF9&S(C5p@@^;<q-NAKa5%GOFmjCF)2jNhk4<Ee*&uI
z591XBw>Fe=Bo>>^XdH9WJSD+d?#SM9cc*!r7Qvjr@?dYn6_Try-Uvr(gHe1Ob24$9
zZ1zkJg4&6e^!ilt`c(22Je7Rw`*12*tSz$~J^pLP@_$|QFF3|4>8`I><6}<T)<lgj
z%ljqOJ~W3K=N0?gpO+Q;uN=quU&V3uZ#vHMtyzox@0=G{>~qC6nFXiU)#tkUyh_#Q
zE9XU3pJWe|7NA@uN%u;zn5<@L`N?z*NvEAxM%KRJGLlp0B~_ACgJLmxwo))d`k%_(
zC-2+j?Q<psC=XJIun=gVFuJ}Ipa-Y(`kTYDygt6;IDfk9IPX^-=bblZ&Feq9^Aei4
zjm>t4ZMIjH2iBO%CtC_O(E;Y^_Q7&EZ<3>ka%Xrw9B}3zHU;;ao9*TWoC@9EF2`o|
z#4I90(&LB|ESlN;k`^#mrBq;CpjCSGA4Rd$O=6V3TE1wan^R!3-R<mjH{0FSy`BC2
z?%K}Q%EoqgYkhxzefy{DdnxKrM@F!U!VvRqCNJP^1KLd3phqYqL5^@=<=}FvH7q2d
zI>V)CCt`t)AKhB!*eFeU$UmI;u0s0YMq=OzEdzeAoS<kobxgeuTpg*&S!_vpr}5xV
zQlkM*?8-}3$9$Q<%Y31m<>LLS?VZm0BCOCcqZoWd!AD_e&JU9;Hrb}D_gmw~_A$9N
z1YOBiRVLU7(q?_qZy5nBFN40~?3vsV6fG#MQ^F<lj`F{COO9`2(k~4_J>p^NvjD5L
z(4$_Is@?#%IcFQ9l_1D<J#)=^y>Jn2ZqBGN2af`L1RGnsJA0j#?am@}@~%=KNJx=Z
z1OW<63^524;q<N<qrg<gHwjgE3G0nMAaz$S{i+pYJsA<%sqi^G5gpqUO{gZ=PxEsF
zh$>TY7=Zqgm`IFJNPNO#0lH|YYj8m55j(^%W--s~(pg9<Xr%e2Dt8!+)Z$U8W2T{|
zK@<xKm}nCNEXcs9WA*1si20tW_MC~e#LoAHzNo6!%${2(RwokWkh6F&1a+5<aebV<
zy0^a4S#KL9Q6?vKo>rU)AX4D4pE<HORt{g^S<!0y_9D5J)GXY1%wqohumN@ZSbbbP
zFP-EzMcR$0A1Wba1LCLscotMj{bLe_${%X~;lSETb8&Qi?sdh^Lw;{NkBh;Dp3w3Z
z9(wn#dzI^6<rVE!xNTJ~yd8FTxvVSsTg7qi+D}XWd~MdQ1iy?=OW)d^t<p}Rc-QI0
z-&wl8fpdKW=lTXtdBOZ|<>lYNDJ1?Y-=?{~LGv6pXu99p4Vv!`vY08pW`!F62Nk;a
IV4FPv0ET7eFaQ7m


From e0efb37b6684d3080415e24c571d87eeaef489b3 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 13:51:27 -0400
Subject: [PATCH 35/54] Lint

---
 packages/core/solidity/src/add-superchain-messaging.ts | 4 +---
 packages/core/solidity/src/print.ts                    | 6 +++---
 packages/core/solidity/src/zip-hardhat.ts              | 2 +-
 3 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index bf13ff50c..f181fe5ab 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -49,9 +49,7 @@ function addCrossDomainMessengerImmutable(c: ContractBuilder) {
   };
   c.addVariable(
     'IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);',
-    [
-      allowImmutableNatspec
-    ],
+    [allowImmutableNatspec],
   );
 }
 
diff --git a/packages/core/solidity/src/print.ts b/packages/core/solidity/src/print.ts
index 523c6c946..d8a1c2ebe 100644
--- a/packages/core/solidity/src/print.ts
+++ b/packages/core/solidity/src/print.ts
@@ -96,9 +96,9 @@ function printConstructor(contract: Contract, helpers: Helpers): Lines[] {
     const args = contract.constructorArgs.map(a => printArgument(a, helpers));
     const body = helpers.upgradeable
       ? spaceBetween(
-        parents.map(p => p + ';'),
-        contract.constructorCode,
-      )
+          parents.map(p => p + ';'),
+          contract.constructorCode,
+        )
       : contract.constructorCode;
     const head = helpers.upgradeable ? 'function initialize' : 'constructor';
     const constructor = printFunction2([], head, args, undefined, modifiers, body);
diff --git a/packages/core/solidity/src/zip-hardhat.ts b/packages/core/solidity/src/zip-hardhat.ts
index 4397ccbbe..c3dff7ae6 100644
--- a/packages/core/solidity/src/zip-hardhat.ts
+++ b/packages/core/solidity/src/zip-hardhat.ts
@@ -202,7 +202,7 @@ function getHardhatPlugins(c: Contract) {
 export async function zipHardhat(c: Contract, opts?: GenericOptions) {
   const zip = new JSZip();
 
-  const importsOptimism = c.imports.some((i) => i.path.startsWith('@eth-optimism/contracts-bedrock/'));
+  const importsOptimism = c.imports.some(i => i.path.startsWith('@eth-optimism/contracts-bedrock/'));
 
   let packageJson, packageLock;
   if (importsOptimism) {

From 4f809de6133314a8ab5433baaf0aea954605f1f0 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 14:45:46 -0400
Subject: [PATCH 36/54] WIP Add zip foundry test

---
 .../core/solidity/src/zip-foundry.test.ts     | 23 +++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/packages/core/solidity/src/zip-foundry.test.ts b/packages/core/solidity/src/zip-foundry.test.ts
index c1214fa24..e1a492aaf 100644
--- a/packages/core/solidity/src/zip-foundry.test.ts
+++ b/packages/core/solidity/src/zip-foundry.test.ts
@@ -102,6 +102,17 @@ test.serial('custom basic', async t => {
   await runTest(c, t, opts);
 });
 
+test.serial('custom cross chain messaging superchain', async t => {
+  const opts: GenericOptions = {
+    kind: 'Custom',
+    name: 'My Contract',
+    crossChainMessaging: 'superchain',
+    crossChainFunctionName: 'myCustomFunction',
+  };
+  const c = buildCustom(opts);
+  await runTest(c, t, opts);
+});
+
 test.serial('custom transparent, managed', async t => {
   const opts: GenericOptions = {
     kind: 'Custom',
@@ -113,6 +124,18 @@ test.serial('custom transparent, managed', async t => {
   await runTest(c, t, opts);
 });
 
+test.serial('custom transparent, managed, cross chain messaging superchain', async t => {
+  const opts: GenericOptions = {
+    kind: 'Custom',
+    name: 'My Contract',
+    upgradeable: 'transparent',
+    access: 'managed',
+    crossChainMessaging: 'superchain',
+  };
+  const c = buildCustom(opts);
+  await runTest(c, t, opts);
+});
+
 async function runTest(c: Contract, t: ExecutionContext<Context>, opts: GenericOptions) {
   const zip = await zipFoundry(c, opts);
 

From 8b015560c5d282db8ec41e3584ff9acc5c66be4b Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 15:48:27 -0400
Subject: [PATCH 37/54] Add Optimism dependencies to Foundry package

---
 .../core/solidity/src/zip-foundry.test.ts.md  | 399 ++++++++++++++++++
 .../solidity/src/zip-foundry.test.ts.snap     | Bin 3488 -> 4515 bytes
 packages/core/solidity/src/zip-foundry.ts     |  27 +-
 3 files changed, 420 insertions(+), 6 deletions(-)

diff --git a/packages/core/solidity/src/zip-foundry.test.ts.md b/packages/core/solidity/src/zip-foundry.test.ts.md
index 50eb62664..3ffc2476e 100644
--- a/packages/core/solidity/src/zip-foundry.test.ts.md
+++ b/packages/core/solidity/src/zip-foundry.test.ts.md
@@ -54,6 +54,7 @@ Generated by [AVA](https://avajs.dev).
           echo "" >> remappings.txt␊
         fi␊
         echo "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/" >> remappings.txt␊
+      ␊
       ␊
         # Perform initial git commit␊
         git add .␊
@@ -260,6 +261,7 @@ Generated by [AVA](https://avajs.dev).
         echo "ast = true" >> foundry.toml␊
         echo "build_info = true" >> foundry.toml␊
         echo "extra_output = [\\"storageLayout\\"]" >> foundry.toml␊
+      ␊
       ␊
         # Perform initial git commit␊
         git add .␊
@@ -451,6 +453,7 @@ Generated by [AVA](https://avajs.dev).
         echo "ast = true" >> foundry.toml␊
         echo "build_info = true" >> foundry.toml␊
         echo "extra_output = [\\"storageLayout\\"]" >> foundry.toml␊
+      ␊
       ␊
         # Perform initial git commit␊
         git add .␊
@@ -622,6 +625,7 @@ Generated by [AVA](https://avajs.dev).
           echo "" >> remappings.txt␊
         fi␊
         echo "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/" >> remappings.txt␊
+      ␊
       ␊
         # Perform initial git commit␊
         git add .␊
@@ -782,6 +786,7 @@ Generated by [AVA](https://avajs.dev).
         echo "ast = true" >> foundry.toml␊
         echo "build_info = true" >> foundry.toml␊
         echo "extra_output = [\\"storageLayout\\"]" >> foundry.toml␊
+      ␊
       ␊
         # Perform initial git commit␊
         git add .␊
@@ -951,6 +956,152 @@ Generated by [AVA](https://avajs.dev).
           echo "" >> remappings.txt␊
         fi␊
         echo "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/" >> remappings.txt␊
+      ␊
+      ␊
+        # Perform initial git commit␊
+        git add .␊
+        git commit -m "openzeppelin: add wizard output" --quiet␊
+      ␊
+        echo "Done."␊
+      else␊
+        echo "Foundry project already initialized."␊
+      fi␊
+      `,
+      `# Sample Foundry Project␊
+      ␊
+      This project demonstrates a basic Foundry use case. It comes with a contract generated by [OpenZeppelin Wizard](https://wizard.openzeppelin.com/), a test for that contract, and a script that deploys that contract.␊
+      ␊
+      ## Installing Foundry␊
+      ␊
+      See [Foundry installation guide](https://book.getfoundry.sh/getting-started/installation).␊
+      ␊
+      ## Initializing the project␊
+      ␊
+      \`\`\`␊
+      bash setup.sh␊
+      \`\`\`␊
+      ␊
+      ## Testing the contract␊
+      ␊
+      \`\`\`␊
+      forge test␊
+      \`\`\`␊
+      ␊
+      ## Deploying the contract␊
+      ␊
+      You can simulate a deployment by running the script:␊
+      ␊
+      \`\`\`␊
+      forge script script/MyContract.s.sol␊
+      \`\`\`␊
+      ␊
+      See [Solidity scripting guide](https://book.getfoundry.sh/guides/scripting-with-solidity) for more information.␊
+      `,
+      `// SPDX-License-Identifier: MIT␊
+      pragma solidity ^0.8.27;␊
+      ␊
+      import {Script} from "forge-std/Script.sol";␊
+      import {console} from "forge-std/console.sol";␊
+      import {MyContract} from "src/MyContract.sol";␊
+      ␊
+      contract MyContractScript is Script {␊
+        function setUp() public {}␊
+      ␊
+        function run() public {␊
+          vm.startBroadcast();␊
+          MyContract instance = new MyContract();␊
+          console.log("Contract deployed to %s", address(instance));␊
+          vm.stopBroadcast();␊
+        }␊
+      }␊
+      `,
+      `// SPDX-License-Identifier: MIT␊
+      // Compatible with OpenZeppelin Contracts ^5.0.0␊
+      pragma solidity ^0.8.27;␊
+      ␊
+      contract MyContract {␊
+      }␊
+      `,
+      `// SPDX-License-Identifier: MIT␊
+      pragma solidity ^0.8.27;␊
+      ␊
+      import {Test} from "forge-std/Test.sol";␊
+      import {MyContract} from "src/MyContract.sol";␊
+      ␊
+      contract MyContractTest is Test {␊
+        MyContract public instance;␊
+      ␊
+        function setUp() public {␊
+          instance = new MyContract();␊
+        }␊
+      ␊
+        function testSomething() public {␊
+          // Add your test here␊
+        }␊
+      }␊
+      `,
+    ]
+
+## custom cross chain messaging superchain
+
+> Snapshot 1
+
+    [
+      `#!/usr/bin/env bash␊
+      ␊
+      # Check if git is installed␊
+      if ! which git &> /dev/null␊
+      then␊
+        echo "git command not found. Install git and try again."␊
+        exit 1␊
+      fi␊
+      ␊
+      # Check if Foundry is installed␊
+      if ! which forge &> /dev/null␊
+      then␊
+        echo "forge command not found. Install Foundry and try again. See https://book.getfoundry.sh/getting-started/installation"␊
+        exit 1␊
+      fi␊
+      ␊
+      # Setup Foundry project␊
+      if ! [ -f "foundry.toml" ]␊
+      then␊
+        echo "Initializing Foundry project..."␊
+      ␊
+        # Backup Wizard template readme to avoid it being overwritten␊
+        mv README.md README-oz.md␊
+      ␊
+        # Initialize sample Foundry project␊
+        forge init --force --quiet␊
+      ␊
+        # Install OpenZeppelin Contracts␊
+        forge install OpenZeppelin/openzeppelin-contracts@vX.Y.Z --quiet␊
+      ␊
+        # Remove unneeded Foundry template files␊
+        rm src/Counter.sol␊
+        rm script/Counter.s.sol␊
+        rm test/Counter.t.sol␊
+        rm README.md␊
+      ␊
+        # Restore Wizard template readme␊
+        mv README-oz.md README.md␊
+      ␊
+        # Add remappings␊
+        if [ -f "remappings.txt" ]␊
+        then␊
+          echo "" >> remappings.txt␊
+        fi␊
+        echo "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/" >> remappings.txt␊
+      ␊
+        # Setup Optimism dependencies␊
+        echo "" >> foundry.toml␊
+        echo "[dependencies]" >> foundry.toml␊
+        echo "\\"@eth-optimism-contracts-bedrock\\" = { version = \\"^0.17.3\\" }" >> foundry.toml␊
+        forge soldeer install␊
+        OPTIMISM_PATH=$(grep '@eth-optimism-contracts-bedrock' remappings.txt | cut -d'=' -f2)␊
+        if [ -n "$OPTIMISM_PATH" ]; then␊
+          echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.txt␊
+        fi␊
       ␊
         # Perform initial git commit␊
         git add .␊
@@ -1013,7 +1164,39 @@ Generated by [AVA](https://avajs.dev).
       // Compatible with OpenZeppelin Contracts ^5.0.0␊
       pragma solidity ^0.8.27;␊
       ␊
+      import {IL2ToL2CrossDomainMessenger} from "@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol";␊
+      import {Predeploys} from "@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol";␊
+      ␊
       contract MyContract {␊
+          /// @custom:oz-upgrades-unsafe-allow state-variable-immutable␊
+          IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);␊
+      ␊
+          error CallerNotL2ToL2CrossDomainMessenger();␊
+          error InvalidCrossDomainSender();␊
+          error InvalidDestination();␊
+      ␊
+          modifier onlyCrossDomainCallback() {␊
+              if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
+              if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();␊
+              _;␊
+          }␊
+      ␊
+          // NOTE: Anyone can call this function␊
+          function callMyCustomFunction(uint256 _toChainId) public {␊
+              if (_toChainId == block.chainid) revert InvalidDestination();␊
+              messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myCustomFunction, (/* TODO: Add arguments */)));␊
+          }␊
+      ␊
+          /**␊
+           * @dev IMPORTANT: This function trusts contracts at the same address on other chains.␊
+           * If an unauthorized contract is deployed at the same address on any chain in the Superchain, it could allow␊
+           * malicious actors to invoke your function from that chain.␊
+           * To prevent this, you must either design the deployer to allow only this contract's bytecode to be deployed␊
+           * through it, or use CREATE2 from a deployer contract that is itself deployed by an EOA you control.␊
+           */␊
+          function myCustomFunction(/* TODO: Add arguments */) external onlyCrossDomainCallback {␊
+              // TODO: Implement logic for the function that will be called from another chain␊
+          }␊
       }␊
       `,
       `// SPDX-License-Identifier: MIT␊
@@ -1095,6 +1278,191 @@ Generated by [AVA](https://avajs.dev).
         echo "ast = true" >> foundry.toml␊
         echo "build_info = true" >> foundry.toml␊
         echo "extra_output = [\\"storageLayout\\"]" >> foundry.toml␊
+      ␊
+      ␊
+        # Perform initial git commit␊
+        git add .␊
+        git commit -m "openzeppelin: add wizard output" --quiet␊
+      ␊
+        echo "Done."␊
+      else␊
+        echo "Foundry project already initialized."␊
+      fi␊
+      `,
+      `# Sample Foundry Project␊
+      ␊
+      This project demonstrates a basic Foundry use case. It comes with a contract generated by [OpenZeppelin Wizard](https://wizard.openzeppelin.com/), a test for that contract, and a script that deploys that contract.␊
+      ␊
+      ## Installing Foundry␊
+      ␊
+      See [Foundry installation guide](https://book.getfoundry.sh/getting-started/installation).␊
+      ␊
+      ## Initializing the project␊
+      ␊
+      \`\`\`␊
+      bash setup.sh␊
+      \`\`\`␊
+      ␊
+      ## Testing the contract␊
+      ␊
+      \`\`\`␊
+      forge test --force␊
+      \`\`\`␊
+      ␊
+      ## Deploying the contract␊
+      ␊
+      You can simulate a deployment by running the script:␊
+      ␊
+      \`\`\`␊
+      forge script script/MyContract.s.sol --force␊
+      \`\`\`␊
+      ␊
+      See [Solidity scripting guide](https://book.getfoundry.sh/guides/scripting-with-solidity) for more information.␊
+      `,
+      `// SPDX-License-Identifier: MIT␊
+      pragma solidity ^0.8.27;␊
+      ␊
+      import {Script} from "forge-std/Script.sol";␊
+      import {console} from "forge-std/console.sol";␊
+      import {Upgrades} from "openzeppelin-foundry-upgrades/Upgrades.sol";␊
+      import {MyContract} from "src/MyContract.sol";␊
+      ␊
+      contract MyContractScript is Script {␊
+        function setUp() public {}␊
+      ␊
+        function run() public {␊
+          // TODO: Set addresses for the variables below, then uncomment the following section:␊
+          /*␊
+          vm.startBroadcast();␊
+          address initialOwner = <Set initialOwner address here>;␊
+          address initialAuthority = <Set initialAuthority address here>;␊
+          address proxy = Upgrades.deployTransparentProxy(␊
+            "MyContract.sol",␊
+            initialOwner,␊
+            abi.encodeCall(MyContract.initialize, (initialAuthority))␊
+          );␊
+          MyContract instance = MyContract(proxy);␊
+          console.log("Proxy deployed to %s", address(instance));␊
+          vm.stopBroadcast();␊
+          */␊
+        }␊
+      }␊
+      `,
+      `// SPDX-License-Identifier: MIT␊
+      // Compatible with OpenZeppelin Contracts ^5.0.0␊
+      pragma solidity ^0.8.27;␊
+      ␊
+      import {AccessManagedUpgradeable} from "@openzeppelin/contracts-upgradeable/access/manager/AccessManagedUpgradeable.sol";␊
+      import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";␊
+      ␊
+      contract MyContract is Initializable, AccessManagedUpgradeable {␊
+          /// @custom:oz-upgrades-unsafe-allow constructor␊
+          constructor() {␊
+              _disableInitializers();␊
+          }␊
+      ␊
+          function initialize(address initialAuthority) public initializer {␊
+              __AccessManaged_init(initialAuthority);␊
+          }␊
+      }␊
+      `,
+      `// SPDX-License-Identifier: MIT␊
+      pragma solidity ^0.8.27;␊
+      ␊
+      import {Test} from "forge-std/Test.sol";␊
+      import {Upgrades} from "openzeppelin-foundry-upgrades/Upgrades.sol";␊
+      import {MyContract} from "src/MyContract.sol";␊
+      ␊
+      contract MyContractTest is Test {␊
+        MyContract public instance;␊
+      ␊
+        function setUp() public {␊
+          address initialOwner = vm.addr(1);␊
+          address initialAuthority = vm.addr(2);␊
+          address proxy = Upgrades.deployTransparentProxy(␊
+            "MyContract.sol",␊
+            initialOwner,␊
+            abi.encodeCall(MyContract.initialize, (initialAuthority))␊
+          );␊
+          instance = MyContract(proxy);␊
+        }␊
+      ␊
+        function testSomething() public {␊
+          // Add your test here␊
+        }␊
+      }␊
+      `,
+    ]
+
+## custom transparent, managed, cross chain messaging superchain
+
+> Snapshot 1
+
+    [
+      `#!/usr/bin/env bash␊
+      ␊
+      # Check if git is installed␊
+      if ! which git &> /dev/null␊
+      then␊
+        echo "git command not found. Install git and try again."␊
+        exit 1␊
+      fi␊
+      ␊
+      # Check if Foundry is installed␊
+      if ! which forge &> /dev/null␊
+      then␊
+        echo "forge command not found. Install Foundry and try again. See https://book.getfoundry.sh/getting-started/installation"␊
+        exit 1␊
+      fi␊
+      ␊
+      # Setup Foundry project␊
+      if ! [ -f "foundry.toml" ]␊
+      then␊
+        echo "Initializing Foundry project..."␊
+      ␊
+        # Backup Wizard template readme to avoid it being overwritten␊
+        mv README.md README-oz.md␊
+      ␊
+        # Initialize sample Foundry project␊
+        forge init --force --quiet␊
+      ␊
+        # Install OpenZeppelin Contracts and Upgrades␊
+        forge install OpenZeppelin/openzeppelin-contracts-upgradeable@vX.Y.Z --quiet␊
+        forge install OpenZeppelin/openzeppelin-foundry-upgrades --quiet␊
+      ␊
+        # Remove unneeded Foundry template files␊
+        rm src/Counter.sol␊
+        rm script/Counter.s.sol␊
+        rm test/Counter.t.sol␊
+        rm README.md␊
+      ␊
+        # Restore Wizard template readme␊
+        mv README-oz.md README.md␊
+      ␊
+        # Add remappings␊
+        if [ -f "remappings.txt" ]␊
+        then␊
+          echo "" >> remappings.txt␊
+        fi␊
+        echo "@openzeppelin/contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/" >> remappings.txt␊
+        echo "@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/" >> remappings.txt␊
+      ␊
+        # Add settings in foundry.toml␊
+        echo "" >> foundry.toml␊
+        echo "ffi = true" >> foundry.toml␊
+        echo "ast = true" >> foundry.toml␊
+        echo "build_info = true" >> foundry.toml␊
+        echo "extra_output = [\\"storageLayout\\"]" >> foundry.toml␊
+      ␊
+        # Setup Optimism dependencies␊
+        echo "" >> foundry.toml␊
+        echo "[dependencies]" >> foundry.toml␊
+        echo "\\"@eth-optimism-contracts-bedrock\\" = { version = \\"^0.17.3\\" }" >> foundry.toml␊
+        forge soldeer install␊
+        OPTIMISM_PATH=$(grep '@eth-optimism-contracts-bedrock' remappings.txt | cut -d'=' -f2)␊
+        if [ -n "$OPTIMISM_PATH" ]; then␊
+          echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.txt␊
+        fi␊
       ␊
         # Perform initial git commit␊
         git add .␊
@@ -1169,9 +1537,24 @@ Generated by [AVA](https://avajs.dev).
       pragma solidity ^0.8.27;␊
       ␊
       import {AccessManagedUpgradeable} from "@openzeppelin/contracts-upgradeable/access/manager/AccessManagedUpgradeable.sol";␊
+      import {IL2ToL2CrossDomainMessenger} from "@eth-optimism/contracts-bedrock/src/L2/IL2ToL2CrossDomainMessenger.sol";␊
       import {Initializable} from "@openzeppelin/contracts-upgradeable/proxy/utils/Initializable.sol";␊
+      import {Predeploys} from "@eth-optimism/contracts-bedrock/src/libraries/Predeploys.sol";␊
       ␊
       contract MyContract is Initializable, AccessManagedUpgradeable {␊
+          /// @custom:oz-upgrades-unsafe-allow state-variable-immutable␊
+          IL2ToL2CrossDomainMessenger public immutable messenger = IL2ToL2CrossDomainMessenger(Predeploys.L2_TO_L2_CROSS_DOMAIN_MESSENGER);␊
+      ␊
+          error CallerNotL2ToL2CrossDomainMessenger();␊
+          error InvalidCrossDomainSender();␊
+          error InvalidDestination();␊
+      ␊
+          modifier onlyCrossDomainCallback() {␊
+              if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
+              if (messenger.crossDomainMessageSender() != address(this)) revert InvalidCrossDomainSender();␊
+              _;␊
+          }␊
+      ␊
           /// @custom:oz-upgrades-unsafe-allow constructor␊
           constructor() {␊
               _disableInitializers();␊
@@ -1180,6 +1563,22 @@ Generated by [AVA](https://avajs.dev).
           function initialize(address initialAuthority) public initializer {␊
               __AccessManaged_init(initialAuthority);␊
           }␊
+      ␊
+          function callMyFunction(uint256 _toChainId) public restricted {␊
+              if (_toChainId == block.chainid) revert InvalidDestination();␊
+              messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+          }␊
+      ␊
+          /**␊
+           * @dev IMPORTANT: This function trusts contracts at the same address on other chains.␊
+           * If an unauthorized contract is deployed at the same address on any chain in the Superchain, it could allow␊
+           * malicious actors to invoke your function from that chain.␊
+           * To prevent this, you must either design the deployer to allow only this contract's bytecode to be deployed␊
+           * through it, or use CREATE2 from a deployer contract that is itself deployed by an EOA you control.␊
+           */␊
+          function myFunction(/* TODO: Add arguments */) external onlyCrossDomainCallback {␊
+              // TODO: Implement logic for the function that will be called from another chain␊
+          }␊
       }␊
       `,
       `// SPDX-License-Identifier: MIT␊
diff --git a/packages/core/solidity/src/zip-foundry.test.ts.snap b/packages/core/solidity/src/zip-foundry.test.ts.snap
index 59fdb685e042abe3bdcc4081e5727b55d9004bdb..0282d80a7134dffac462e58f5898ab9d14982313 100644
GIT binary patch
literal 4515
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
BzQ+In

literal 3488
zcmV;R4PWv>RzV<BZeeh9Xm4~Nb~6eC08jR!<3pMv=e1ccUAM|bXP(f{KTDNni5!#`
ztdP=j{U3`600000000B+Tw8A(w-uhX<HXs-xzsICpasgT(RSC^ospC{4&=y)EGdCn
z%NBHLlQ@aOo#E~>njyy|NAgP0Ls1k3`U~2kK#@GQPXXE=P@w1^=r8C~fj+j61&V?*
z<m}As>_zvLJ$jIK$-{FF4-XG{K9c&f)pV)7&42k75?HwC3&iZ1DbNaB7jpuA-l2m3
z>`TXi0)F(Z-(5CdFyv3^YU%lR4a2x+7{&)z4CAG%hVk}GhS9xl7}rbBzh1gB&lv2M
zO8V2QufA%O%0}smQF__9Ub<v_vvk=gU3vY|f1bPXh81vTH8HUe*#S++JLU2Xu+TyF
zHoz^=#sXjtFyR8aE^^Aa1>OL=9c*{Px*yyHmV<UI61Z+zbPy>6fb0$h6<KRj&x6DP
zgbL820dY*Q9B~R8%PPUT0Jb3}W<@rAf(4i^w{S{{_hnPo9jHi)vNjr`N>o2Y87&~K
z5LibDbcFEvtYtMR-8S1uv?5ZIcdRxN0+V)w3&;d=ETtP1n3BHEtRoTlu^^w(FOV&w
zPCNpQmQ*rgEU4#Jz^CaREE6m+bnzZ0?JN`1G%MvY05`xrXm1BT_$l6l%mD&<z6%8c
z3_-_3Ku`d8D0ToApot_Sx`Ws*!$O3TydAK%G{3mAWO|PJ)S!E&=S0k76%gRi^Ig=}
z8K4FN6D&ZZ(W1;opwW07U?en;$lecqL_S8ok6cW^0wsb$Tkr&felm;ti0r8^4O_Q)
zZ|6hvBlF|5m^I|l9RvbG5OR<cD;is*g<T}YF%NKNTMING0x^?QR~6a}`=VFgs}YFz
z%0;g{ww%_03(C-dp-37#GI6&3yyF0dJm~wFw56uFrQD=fYKkX9Itl>FRkX8Iz}>qb
zO(#u@V{dvdX-g}%r8Vc`<^Ve<sPfo{O0Oc;qRb1&AH!&h%Snf&_;9{E4lvc{r~))R
zP)SOh4T*Lmv(Z5Kfv6-0H|oG5CCIFlk;_qBmhnaaU1{vD)&}n($E?W7sDfarq@&>1
zmu`Udv`eolmo9H~FppU}$fJY{1_j~(%3z7@xJkefupvh#SPpxKIM~Ia10c|*18qc*
zZ0vw$7d%Q$g2+)mt?F<SS-?!1#<Zzt)#?C-PAI1e5FIFD_VqA)LFK$ror8Rrc6pl6
zESGP@b1@N6%4Hew9>vi%5zat6zz*uEcgSd1(;^d5Omt8jIm(}Z{&`uhJ%GzFY4T23
zBHL^rE;PCBKtvzK3Tca&crom5Klw*A05&9mV=oBjAyk&}5D{`PSU`ww7TIq$DMXo6
zg@u*w2Hi$Pg@sUdXt;IiVh4+^qLci_Fq@>{R@|f^ou<JRt6DhBo(v_J$jKF&(~N!i
zlJ?<mU$!i;zPk8f<36?#;i$3fAR=%JBQ^_GmN&{igKZB2%^7?)Wxiw1+`dyTW6!5d
zfc^DQhXc@J)KiOQgA2!s%4KIOcVc3j5>8#zPpv94<jQ86Tt?m4j3Hq;o+YY0k}B7H
z^=V%Qv4Gg2KXN2C{b~*PLDR)H*gq&IYgs@Nbzx|<EU@u#@!_moh-Hjnh;zi%EJ9!h
zG7Ot8;-HCKx?2xpDhP-SQ_@EyO^doN-Ic@2Q7C6N;(Rmwv*Vee>)&G(IyU5@TDucg
zC}Dsh8~a!?n*;AkEqVo-q=Oi`n{MTx77Sc5?|7K#hN-e4ZG9MU#B?k5Z3w-G<+7&f
z)wdjaH9}E@AT|PXfS_GnT#frxPib0L8q^hMWghJ>E^SvUdM}`+CvxPj<@>x+*J@O?
z%$jN*nw|Q6R=;VL0XQfh#8c(6o+?vUM@<#W0t?jhp}<WSMNvF|#{xdPWlot>W6Z62
z+eVy+4XLYV!Ju^*hQwB?O=dnVtu4$<jp8HZa9AN}^gEBqy?_zv`G;YKo(M!Zri5E5
z9(nxVcOmbrU?PqqAZC&$VHF1axINH3a`_|X;bW;EameHS6Dklt4(pIXhVuhT?9p5U
zfn9Dzw1a}M48Nh6I!Fz)`l_u~2Pt3GwPCN-mrzgjIUY?Fo10yM_?t62V9SUgAQ517
zesg_kZENk}{UtC5wvlba?U`F|S1XB%ikk0(c&scx*vRFPsE|D3SR`0r3(Bf}VY{9i
zlk1siThBz(TF6-bgk7&zR=OZGZKVz>D;qzqWC$XoCCH-s{g`S?@=eCrnW?EMa1%^V
zftxphgKX?UmsfRs44bqWBw~%asJgiH{`}_sjjj2`mE{Lv=hHztzg5ECI*R8LCXAX1
z^9PZI<0U%e(p#h{al2VjwPddqeLk~*9F|?&BA;PsV?B_9)<J-Yn7Q>ffS%0#`sE}#
zUh5ky$v`zsiIaPh)V@N?=KwMkrsquV4go`t1I(hlLGLonjLKVq??8cKt>xtJIb*U9
zJJ1bK&+WodBG8QswA^ZP=J%$0Z#rjPlLtOxrdA|UKnjio=3APC@h8@r?vmu3iOd{-
z-N9&gfSNkkMDeW0fguqv!a-H_KC5$7uT)pcL`rCVds~R-^cLc^OUK`B%fzOC_bf|~
zy>*sMWaJM2%C72YuDn+7q3)E2ZK(%tUUxiG7FVZhL$|7$Y^F9~SE>o#tPR+PYJ#^E
z!3pd)(|LkS9v?t25jdoW>8^8*m{@uoZ#hj8lFGOp2j@F#m#Glk#}R@X1U|0=MqR{n
zfZRXk0l7bX!7%>&qG5Q~4C8x;26F%Yd;#PZK<=afxuN+t{WgORIufee2%^Sv!O0@L
z<Fiu(p_%alBtB)3I5}+Ak+I|v3Z#ULtIQbawX`OW0)dQ9AUTc8DXZnyv|1R<0l@+^
zm<Dn&lBOA8*V&R_-$+vQL@>A&f#hHgJo=;}{Ry_web}Xe_@we_f7=TU)c>Ub>Mu4>
zuNRZ^1nko~oI7y8HQ~U$UdA>3&=uCw)CKyVMgNb3<16#V$b9^L81~QTlP;Kxw_#>9
ze>OK)*H>j#Rb{}H<UrI_A#7q35t}+_0lIEglk_5V9aPh)mR6}2<=3@=2L(E53-!x8
z0tmG`P5l4&SI!&%-|X#7Mu4=bO-$agK!Q~synIASeFq04#6;lB2?)yv&Ie167plVw
z4c$*c;3+2A@VB|Te#CwyMP%3vgWFTuD6}onG=;6F$_M#H9b}}BK;1W2KUkYz%*D)8
zRWWLASr&ND4!EG+EZvJ2gGN9&Y@r5}aWe_6_d)F`#MHqd&e+RR86Skw_To`>I5Zze
zrwp)|;J~sl`&MY@ElH6B+TY0%Mgx*1Ptm0YD56Z&XND=JI5`|YHGYYpop0VP7>EvK
zcn>M9Vk;B0yDYcia&e6Ijib@zUV+BUQ`#t8HWzN~o+aFRP8*(6z-$NLv02zQvAY-u
z*-pY{V(2E~lyO~wn0<R@S^>LsH#`LGhjy=jH4NIdt{KL{>jku1K)VIBTR^)7v|B*C
z1+-g0y9KoSv_iXY6wvN70qv^j_E6p$(hzN`>^x!Gq#_ppoGm?f4&dz4+QRLb>Epte
zw`ZoUK2B$iS3ZnV)8iq`{Y)kh6;0c@4*HcI1bj{sUYVMnIjCe7k-R-KJq{$Pj1iHh
zWQ+qio-r60DmDcEyI;V6M}hw`%hDkD?;Ka4^F;JK#O&$mTeqSNq94k8<<_w0_P;0_
z#;;y3p4%5t-o=ITis$x|3%3=|?F*=9VxgYmx&5W~32aG==k^na%8Yo}o|8zO`Rnz6
zm(B+uk$dH_-ziIC{Wl+=81o6dq8{-)S&E4P0Of#rPkB@0mwa|B8B{AeY<S&(VQU{d
z2Z_hIihH%6$9^_dmXl>|xyl8T&g&tMvaa-_fZ^1`(Z~%G3BGEmNQb;X{PjpDc-r0{
zj!0(5ov{5$<tD>p=9B@$)hU@%=J`n`yL|Fpon8tC3HKojpC=B!IP%W0iz7d}W*C2d
zt++T+WSbW^+bk}QJe!$padD)$I8t03DbR%C;>h^u!n?)AkpiMP+QpHLUb->*^e!pu
zDZW$k;mGN9dXUL+FO?*bl&AJu$(T1jGB(J&^6?bh@Q}S!S3Cv*4ddSOID25qFRp5w
z{Z)-~j`@eY#c?`-n;XscLAN<x`q!Y_9Isq8jDNmp7zgFzHb;T4U0i&vxXm%S7}(Q%
zo8wOf{&KPLmovv*bjX^h3mtzuffLo!z0je}mforMjM=wY)m0}9n+!xXdJ_AOV|7jS
zG_OtMCjUP-&M^7Uu|C+(%acAn+XMU~`%X@-6L;+J>COnZ=+70_sfR=dlXebvCs+9{
z4OkS=B|?@tg8z<62~sEU9we}hoc;{q8~+$|0{_1k4dV~j4CAfh1ir`+E^vlWoWMVu
z*++2#U!1_7W(N4zA_KhG8Q{5{z^6082|I-U&9iX`KPhSD#XgN!bo0?0Y0=HJ@0FkE
ziGFI74t2m2x6C`^iM7q1?dRq9i6rj)PWX369y^}ezw}*+63XM9j7M21vj(v|tK<G$
z0Hgmbevq1zd-~pU=}{-}slKI7)_XjL9Dx7!0v>=*2s(7g!|<Gtd&qxZIx&%TR5(2$
OVC?@vD|YK|fB*mmP@<9m

diff --git a/packages/core/solidity/src/zip-foundry.ts b/packages/core/solidity/src/zip-foundry.ts
index 586711c22..c102acc2b 100644
--- a/packages/core/solidity/src/zip-foundry.ts
+++ b/packages/core/solidity/src/zip-foundry.ts
@@ -176,6 +176,8 @@ const script = (c: Contract, opts?: GenericOptions) => {
   }
 };
 
+const importsOptimism = (c: Contract) => c.imports.some(i => i.path.startsWith('@eth-optimism/contracts-bedrock/'));
+
 const setupSh = (c: Contract) => `\
 #!/usr/bin/env bash
 
@@ -204,8 +206,7 @@ then
   # Initialize sample Foundry project
   forge init --force --quiet
 
-${
-  c.upgradeable
+${c.upgradeable
     ? `\
   # Install OpenZeppelin Contracts and Upgrades
   forge install OpenZeppelin/openzeppelin-contracts-upgradeable@v${contracts.version} --quiet
@@ -215,7 +216,7 @@ ${
   # Install OpenZeppelin Contracts
   forge install OpenZeppelin/openzeppelin-contracts@v${contracts.version} --quiet\
 `
-}
+  }
 
   # Remove unneeded Foundry template files
   rm src/Counter.sol
@@ -231,8 +232,7 @@ ${
   then
     echo "" >> remappings.txt
   fi
-${
-  c.upgradeable
+${c.upgradeable
     ? `\
   echo "@openzeppelin/contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/" >> remappings.txt
   echo "@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/" >> remappings.txt
@@ -247,7 +247,22 @@ ${
     : `\
   echo "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/" >> remappings.txt\
 `
-}
+  }
+${importsOptimism(c) ?
+    `\
+
+  # Setup Optimism dependencies
+  echo "" >> foundry.toml
+  echo "[dependencies]" >> foundry.toml
+  echo "\\"@eth-optimism-contracts-bedrock\\" = { version = \\"^0.17.3\\" }" >> foundry.toml
+  forge soldeer install
+  OPTIMISM_PATH=$(grep '@eth-optimism-contracts-bedrock' remappings.txt | cut -d'=' -f2)
+  if [ -n "$OPTIMISM_PATH" ]; then
+    echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.txt
+  fi\
+`
+    : ''
+  }
 
   # Perform initial git commit
   git add .

From 6310e3ef5b8faf57dcabc5b726d7341eeda6677c Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 16:03:42 -0400
Subject: [PATCH 38/54] Use Optimism npm package version

---
 packages/core/solidity/src/zip-foundry.ts | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/packages/core/solidity/src/zip-foundry.ts b/packages/core/solidity/src/zip-foundry.ts
index c102acc2b..c09d7aadc 100644
--- a/packages/core/solidity/src/zip-foundry.ts
+++ b/packages/core/solidity/src/zip-foundry.ts
@@ -6,6 +6,7 @@ import SOLIDITY_VERSION from './solidity-version.json';
 import contracts from '../openzeppelin-contracts';
 import type { Lines } from './utils/format-lines';
 import { formatLinesWithSpaces, spaceBetween } from './utils/format-lines';
+import packageJson from '../package.json';
 
 function getHeader(c: Contract) {
   return [`// SPDX-License-Identifier: ${c.license}`, `pragma solidity ^${SOLIDITY_VERSION};`];
@@ -176,7 +177,10 @@ const script = (c: Contract, opts?: GenericOptions) => {
   }
 };
 
-const importsOptimism = (c: Contract) => c.imports.some(i => i.path.startsWith('@eth-optimism/contracts-bedrock/'));
+const OPTIMISM_NPM_PACKAGE = '@eth-optimism/contracts-bedrock';
+const OPTIMISM_SOLDEER_PACKAGE = '@eth-optimism-contracts-bedrock';
+const importsOptimism = (c: Contract) => c.imports.some(i => i.path.startsWith(OPTIMISM_NPM_PACKAGE));
+const optimismNpmVersion = packageJson.devDependencies[OPTIMISM_NPM_PACKAGE];
 
 const setupSh = (c: Contract) => `\
 #!/usr/bin/env bash
@@ -254,11 +258,11 @@ ${importsOptimism(c) ?
   # Setup Optimism dependencies
   echo "" >> foundry.toml
   echo "[dependencies]" >> foundry.toml
-  echo "\\"@eth-optimism-contracts-bedrock\\" = { version = \\"^0.17.3\\" }" >> foundry.toml
+  echo "\\"${OPTIMISM_SOLDEER_PACKAGE}\\" = { version = \\"${optimismNpmVersion}\\" }" >> foundry.toml
   forge soldeer install
   OPTIMISM_PATH=$(grep '@eth-optimism-contracts-bedrock' remappings.txt | cut -d'=' -f2)
   if [ -n "$OPTIMISM_PATH" ]; then
-    echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.txt
+    echo "${OPTIMISM_SOLDEER_PACKAGE}/=$OPTIMISM_PATH" >> remappings.txt
   fi\
 `
     : ''

From 9d59528b30c7686e9faf00e0999b6af67fdcf553 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 16:25:53 -0400
Subject: [PATCH 39/54] Fix remapping

---
 packages/core/solidity/src/zip-foundry.ts | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/packages/core/solidity/src/zip-foundry.ts b/packages/core/solidity/src/zip-foundry.ts
index c09d7aadc..a02c52f35 100644
--- a/packages/core/solidity/src/zip-foundry.ts
+++ b/packages/core/solidity/src/zip-foundry.ts
@@ -180,7 +180,7 @@ const script = (c: Contract, opts?: GenericOptions) => {
 const OPTIMISM_NPM_PACKAGE = '@eth-optimism/contracts-bedrock';
 const OPTIMISM_SOLDEER_PACKAGE = '@eth-optimism-contracts-bedrock';
 const importsOptimism = (c: Contract) => c.imports.some(i => i.path.startsWith(OPTIMISM_NPM_PACKAGE));
-const optimismNpmVersion = packageJson.devDependencies[OPTIMISM_NPM_PACKAGE];
+const optimismSemver = packageJson.devDependencies[OPTIMISM_NPM_PACKAGE];
 
 const setupSh = (c: Contract) => `\
 #!/usr/bin/env bash
@@ -258,11 +258,11 @@ ${importsOptimism(c) ?
   # Setup Optimism dependencies
   echo "" >> foundry.toml
   echo "[dependencies]" >> foundry.toml
-  echo "\\"${OPTIMISM_SOLDEER_PACKAGE}\\" = { version = \\"${optimismNpmVersion}\\" }" >> foundry.toml
+  echo "\\"${OPTIMISM_SOLDEER_PACKAGE}\\" = { version = \\"${optimismSemver}\\" }" >> foundry.toml
   forge soldeer install
   OPTIMISM_PATH=$(grep '@eth-optimism-contracts-bedrock' remappings.txt | cut -d'=' -f2)
   if [ -n "$OPTIMISM_PATH" ]; then
-    echo "${OPTIMISM_SOLDEER_PACKAGE}/=$OPTIMISM_PATH" >> remappings.txt
+    echo "${OPTIMISM_NPM_PACKAGE}/=$OPTIMISM_PATH" >> remappings.txt
   fi\
 `
     : ''

From 17ad272dcf4e343589c189fe95d57200e6325c88 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 16:42:13 -0400
Subject: [PATCH 40/54] Add fallback when modifying remappings

---
 .../core/solidity/src/zip-foundry.test.ts.md  |  12 ++++++++++--
 .../solidity/src/zip-foundry.test.ts.snap     | Bin 4515 -> 4566 bytes
 packages/core/solidity/src/zip-foundry.ts     |   8 ++++++--
 3 files changed, 16 insertions(+), 4 deletions(-)

diff --git a/packages/core/solidity/src/zip-foundry.test.ts.md b/packages/core/solidity/src/zip-foundry.test.ts.md
index 3ffc2476e..575b62201 100644
--- a/packages/core/solidity/src/zip-foundry.test.ts.md
+++ b/packages/core/solidity/src/zip-foundry.test.ts.md
@@ -1099,8 +1099,12 @@ Generated by [AVA](https://avajs.dev).
         echo "\\"@eth-optimism-contracts-bedrock\\" = { version = \\"^0.17.3\\" }" >> foundry.toml␊
         forge soldeer install␊
         OPTIMISM_PATH=$(grep '@eth-optimism-contracts-bedrock' remappings.txt | cut -d'=' -f2)␊
-        if [ -n "$OPTIMISM_PATH" ]; then␊
+        if [ -n "$OPTIMISM_PATH" ]␊
+        then␊
           echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.txt␊
+        else␊
+          echo "Failed to update remappings.txt. Manually update remappings.txt to add @eth-optimism/contracts-bedrock/ with the same path as @eth-optimism-contracts-bedrock/"␊
+          exit 1␊
         fi␊
       ␊
         # Perform initial git commit␊
@@ -1460,8 +1464,12 @@ Generated by [AVA](https://avajs.dev).
         echo "\\"@eth-optimism-contracts-bedrock\\" = { version = \\"^0.17.3\\" }" >> foundry.toml␊
         forge soldeer install␊
         OPTIMISM_PATH=$(grep '@eth-optimism-contracts-bedrock' remappings.txt | cut -d'=' -f2)␊
-        if [ -n "$OPTIMISM_PATH" ]; then␊
+        if [ -n "$OPTIMISM_PATH" ]␊
+        then␊
           echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.txt␊
+        else␊
+          echo "Failed to update remappings.txt. Manually update remappings.txt to add @eth-optimism/contracts-bedrock/ with the same path as @eth-optimism-contracts-bedrock/"␊
+          exit 1␊
         fi␊
       ␊
         # Perform initial git commit␊
diff --git a/packages/core/solidity/src/zip-foundry.test.ts.snap b/packages/core/solidity/src/zip-foundry.test.ts.snap
index 0282d80a7134dffac462e58f5898ab9d14982313..45d931ea5afd1686945fcb707a8c66c87f1e2249 100644
GIT binary patch
literal 4566
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
AkpKVy

literal 4515
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
BzQ+In

diff --git a/packages/core/solidity/src/zip-foundry.ts b/packages/core/solidity/src/zip-foundry.ts
index a02c52f35..21575b805 100644
--- a/packages/core/solidity/src/zip-foundry.ts
+++ b/packages/core/solidity/src/zip-foundry.ts
@@ -260,9 +260,13 @@ ${importsOptimism(c) ?
   echo "[dependencies]" >> foundry.toml
   echo "\\"${OPTIMISM_SOLDEER_PACKAGE}\\" = { version = \\"${optimismSemver}\\" }" >> foundry.toml
   forge soldeer install
-  OPTIMISM_PATH=$(grep '@eth-optimism-contracts-bedrock' remappings.txt | cut -d'=' -f2)
-  if [ -n "$OPTIMISM_PATH" ]; then
+  OPTIMISM_PATH=$(grep '${OPTIMISM_SOLDEER_PACKAGE}' remappings.txt | cut -d'=' -f2)
+  if [ -n "$OPTIMISM_PATH" ]
+  then
     echo "${OPTIMISM_NPM_PACKAGE}/=$OPTIMISM_PATH" >> remappings.txt
+  else
+    echo "Failed to update remappings.txt. Manually update remappings.txt to add ${OPTIMISM_NPM_PACKAGE}/ with the same path as ${OPTIMISM_SOLDEER_PACKAGE}/"
+    exit 1
   fi\
 `
     : ''

From ed36ec97a377b4184d66b25b63d3397b0a1ee23f Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 17:02:30 -0400
Subject: [PATCH 41/54] Rename instead of add remapping

---
 .../core/solidity/src/zip-foundry.test.ts.md  |  12 ++++++++----
 .../solidity/src/zip-foundry.test.ts.snap     | Bin 4566 -> 4586 bytes
 packages/core/solidity/src/zip-foundry.ts     |   6 ++++--
 3 files changed, 12 insertions(+), 6 deletions(-)

diff --git a/packages/core/solidity/src/zip-foundry.test.ts.md b/packages/core/solidity/src/zip-foundry.test.ts.md
index 575b62201..1166f373f 100644
--- a/packages/core/solidity/src/zip-foundry.test.ts.md
+++ b/packages/core/solidity/src/zip-foundry.test.ts.md
@@ -1101,9 +1101,11 @@ Generated by [AVA](https://avajs.dev).
         OPTIMISM_PATH=$(grep '@eth-optimism-contracts-bedrock' remappings.txt | cut -d'=' -f2)␊
         if [ -n "$OPTIMISM_PATH" ]␊
         then␊
-          echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.txt␊
+          grep -v '@eth-optimism-contracts-bedrock' remappings.txt > remappings.tmp␊
+          echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.tmp␊
+          mv remappings.tmp remappings.txt␊
         else␊
-          echo "Failed to update remappings.txt. Manually update remappings.txt to add @eth-optimism/contracts-bedrock/ with the same path as @eth-optimism-contracts-bedrock/"␊
+          echo "Failed to update remappings.txt. Manually update remappings.txt to rename @eth-optimism-contracts-bedrock-^0.17.3/ to @eth-optimism/contracts-bedrock/"␊
           exit 1␊
         fi␊
       ␊
@@ -1466,9 +1468,11 @@ Generated by [AVA](https://avajs.dev).
         OPTIMISM_PATH=$(grep '@eth-optimism-contracts-bedrock' remappings.txt | cut -d'=' -f2)␊
         if [ -n "$OPTIMISM_PATH" ]␊
         then␊
-          echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.txt␊
+          grep -v '@eth-optimism-contracts-bedrock' remappings.txt > remappings.tmp␊
+          echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.tmp␊
+          mv remappings.tmp remappings.txt␊
         else␊
-          echo "Failed to update remappings.txt. Manually update remappings.txt to add @eth-optimism/contracts-bedrock/ with the same path as @eth-optimism-contracts-bedrock/"␊
+          echo "Failed to update remappings.txt. Manually update remappings.txt to rename @eth-optimism-contracts-bedrock-^0.17.3/ to @eth-optimism/contracts-bedrock/"␊
           exit 1␊
         fi␊
       ␊
diff --git a/packages/core/solidity/src/zip-foundry.test.ts.snap b/packages/core/solidity/src/zip-foundry.test.ts.snap
index 45d931ea5afd1686945fcb707a8c66c87f1e2249..4d84a700e4a374ba6079a62e30c3efad0d58c407 100644
GIT binary patch
literal 4586
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
USsi4a*MrRe2cd>C-z~EM0O48jZ~y=R

literal 4566
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
AkpKVy

diff --git a/packages/core/solidity/src/zip-foundry.ts b/packages/core/solidity/src/zip-foundry.ts
index 21575b805..654182389 100644
--- a/packages/core/solidity/src/zip-foundry.ts
+++ b/packages/core/solidity/src/zip-foundry.ts
@@ -263,9 +263,11 @@ ${importsOptimism(c) ?
   OPTIMISM_PATH=$(grep '${OPTIMISM_SOLDEER_PACKAGE}' remappings.txt | cut -d'=' -f2)
   if [ -n "$OPTIMISM_PATH" ]
   then
-    echo "${OPTIMISM_NPM_PACKAGE}/=$OPTIMISM_PATH" >> remappings.txt
+    grep -v '${OPTIMISM_SOLDEER_PACKAGE}' remappings.txt > remappings.tmp
+    echo "${OPTIMISM_NPM_PACKAGE}/=$OPTIMISM_PATH" >> remappings.tmp
+    mv remappings.tmp remappings.txt
   else
-    echo "Failed to update remappings.txt. Manually update remappings.txt to add ${OPTIMISM_NPM_PACKAGE}/ with the same path as ${OPTIMISM_SOLDEER_PACKAGE}/"
+    echo "Failed to update remappings.txt. Manually update remappings.txt to rename ${OPTIMISM_SOLDEER_PACKAGE}-${optimismSemver}/ to ${OPTIMISM_NPM_PACKAGE}/"
     exit 1
   fi\
 `

From 4ed82183668455da0dc66204f0b842d904415fb6 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 30 Jul 2025 17:03:28 -0400
Subject: [PATCH 42/54] Lint

---
 packages/core/solidity/src/zip-foundry.ts | 17 ++++++++++-------
 1 file changed, 10 insertions(+), 7 deletions(-)

diff --git a/packages/core/solidity/src/zip-foundry.ts b/packages/core/solidity/src/zip-foundry.ts
index 654182389..686f77090 100644
--- a/packages/core/solidity/src/zip-foundry.ts
+++ b/packages/core/solidity/src/zip-foundry.ts
@@ -210,7 +210,8 @@ then
   # Initialize sample Foundry project
   forge init --force --quiet
 
-${c.upgradeable
+${
+  c.upgradeable
     ? `\
   # Install OpenZeppelin Contracts and Upgrades
   forge install OpenZeppelin/openzeppelin-contracts-upgradeable@v${contracts.version} --quiet
@@ -220,7 +221,7 @@ ${c.upgradeable
   # Install OpenZeppelin Contracts
   forge install OpenZeppelin/openzeppelin-contracts@v${contracts.version} --quiet\
 `
-  }
+}
 
   # Remove unneeded Foundry template files
   rm src/Counter.sol
@@ -236,7 +237,8 @@ ${c.upgradeable
   then
     echo "" >> remappings.txt
   fi
-${c.upgradeable
+${
+  c.upgradeable
     ? `\
   echo "@openzeppelin/contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/" >> remappings.txt
   echo "@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/" >> remappings.txt
@@ -251,9 +253,10 @@ ${c.upgradeable
     : `\
   echo "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/" >> remappings.txt\
 `
-  }
-${importsOptimism(c) ?
-    `\
+}
+${
+  importsOptimism(c)
+    ? `\
 
   # Setup Optimism dependencies
   echo "" >> foundry.toml
@@ -272,7 +275,7 @@ ${importsOptimism(c) ?
   fi\
 `
     : ''
-  }
+}
 
   # Perform initial git commit
   git add .

From 7de36dce7dc248a1e098e148388b1d386dffed6c Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Thu, 31 Jul 2025 12:55:10 -0400
Subject: [PATCH 43/54] Update changeset

---
 .changeset/some-fans-tell.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.changeset/some-fans-tell.md b/.changeset/some-fans-tell.md
index 283fac3cb..d02afdcf7 100644
--- a/.changeset/some-fans-tell.md
+++ b/.changeset/some-fans-tell.md
@@ -1,7 +1,7 @@
 ---
 '@openzeppelin/wizard': patch
 '@openzeppelin/wizard-common': patch
-'@openzeppelin/wizard-mcp': patch
+'@openzeppelin/contracts-mcp': patch
 ---
 
-Add option for Superchain interop message passing in Custom contracts
+Solidity: Add option for Superchain interop message passing in Custom contracts

From fa8f0c3980482202e5035c0d44527d63cab4967d Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Thu, 31 Jul 2025 14:21:25 -0400
Subject: [PATCH 44/54] Update note for clarity, use natspec

---
 .../solidity/src/add-superchain-messaging.ts  |   2 +-
 packages/core/solidity/src/custom.test.ts.md  |   2 +-
 .../core/solidity/src/custom.test.ts.snap     | Bin 1625 -> 1639 bytes
 .../core/solidity/src/zip-foundry.test.ts.md  |   2 +-
 .../solidity/src/zip-foundry.test.ts.snap     | Bin 4586 -> 4599 bytes
 .../core/solidity/src/zip-hardhat.test.ts.md  |   4 ++--
 .../solidity/src/zip-hardhat.test.ts.snap     | Bin 3191 -> 3204 bytes
 7 files changed, 5 insertions(+), 5 deletions(-)

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index f181fe5ab..148f411c4 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -74,7 +74,7 @@ function addSourceFunction(sanitizedFunctionName: string, access: Access, c: Con
   if (access) {
     requireAccessControl(c, sourceFn, access, 'CROSSCHAIN_CALLER', 'crossChainCaller');
   } else {
-    c.setFunctionComments(['// NOTE: Anyone can call this function'], sourceFn);
+    c.setFunctionComments(['/// @dev NOTE: This function is unprotected. Anyone can call this function.'], sourceFn);
   }
 
   if (pausable) {
diff --git a/packages/core/solidity/src/custom.test.ts.md b/packages/core/solidity/src/custom.test.ts.md
index 80692f2dc..c5a85294e 100644
--- a/packages/core/solidity/src/custom.test.ts.md
+++ b/packages/core/solidity/src/custom.test.ts.md
@@ -185,7 +185,7 @@ Generated by [AVA](https://avajs.dev).
             _;␊
         }␊
     ␊
-        // NOTE: Anyone can call this function␊
+        /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
         function callMyFunction(uint256 _toChainId) public {␊
             if (_toChainId == block.chainid) revert InvalidDestination();␊
             messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
diff --git a/packages/core/solidity/src/custom.test.ts.snap b/packages/core/solidity/src/custom.test.ts.snap
index 78a994e4c0febefa1c195def0ae67506c3d4332c..b2ae7baf2d7ce50c4c54ae586b6c95625d6810a4 100644
GIT binary patch
literal 1639
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

literal 1625
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
XF`JJun~yPf_A%y9ZzOx2X(9jsUM>*r

diff --git a/packages/core/solidity/src/zip-foundry.test.ts.md b/packages/core/solidity/src/zip-foundry.test.ts.md
index 1166f373f..c91e05869 100644
--- a/packages/core/solidity/src/zip-foundry.test.ts.md
+++ b/packages/core/solidity/src/zip-foundry.test.ts.md
@@ -1187,7 +1187,7 @@ Generated by [AVA](https://avajs.dev).
               _;␊
           }␊
       ␊
-          // NOTE: Anyone can call this function␊
+          /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
           function callMyCustomFunction(uint256 _toChainId) public {␊
               if (_toChainId == block.chainid) revert InvalidDestination();␊
               messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myCustomFunction, (/* TODO: Add arguments */)));␊
diff --git a/packages/core/solidity/src/zip-foundry.test.ts.snap b/packages/core/solidity/src/zip-foundry.test.ts.snap
index 4d84a700e4a374ba6079a62e30c3efad0d58c407..f69e5dfe3ee46c77182e080556209607f40e47b7 100644
GIT binary patch
literal 4599
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

literal 4586
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
USsi4a*MrRe2cd>C-z~EM0O48jZ~y=R

diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.md b/packages/core/solidity/src/zip-hardhat.test.ts.md
index d61155a5f..92d3ceae4 100644
--- a/packages/core/solidity/src/zip-hardhat.test.ts.md
+++ b/packages/core/solidity/src/zip-hardhat.test.ts.md
@@ -415,7 +415,7 @@ Generated by [AVA](https://avajs.dev).
               _;␊
           }␊
       ␊
-          // NOTE: Anyone can call this function␊
+          /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
           function callMyFunction(uint256 _toChainId) public {␊
               if (_toChainId == block.chainid) revert InvalidDestination();␊
               messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
@@ -609,7 +609,7 @@ Generated by [AVA](https://avajs.dev).
               _disableInitializers();␊
           }␊
       ␊
-          // NOTE: Anyone can call this function␊
+          /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
           function callMyFunction(uint256 _toChainId) public {␊
               if (_toChainId == block.chainid) revert InvalidDestination();␊
               messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.snap b/packages/core/solidity/src/zip-hardhat.test.ts.snap
index b8175c86d6313339b6a8ffb52d5834da93db99bb..672446ac38f4cac79d4d22436fcbdf138b588a79 100644
GIT binary patch
literal 3204
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

literal 3191
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


From 2f81bcd17c2ab80143196fc6623d3b7931ea7673 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 1 Aug 2025 11:20:50 -0400
Subject: [PATCH 45/54] Add soldeer lock

---
 .../foundry/optimism/soldeer.lock             |  6 ++++++
 .../foundry/optimism/soldeer.lock.d.ts        |  2 ++
 packages/core/solidity/src/zip-foundry.ts     | 21 ++++++++++---------
 packages/ui/rollup.config.mjs                 | 20 ++++++++++++++++++
 4 files changed, 39 insertions(+), 10 deletions(-)
 create mode 100644 packages/core/solidity/src/environments/foundry/optimism/soldeer.lock
 create mode 100644 packages/core/solidity/src/environments/foundry/optimism/soldeer.lock.d.ts

diff --git a/packages/core/solidity/src/environments/foundry/optimism/soldeer.lock b/packages/core/solidity/src/environments/foundry/optimism/soldeer.lock
new file mode 100644
index 000000000..e6d3e9aef
--- /dev/null
+++ b/packages/core/solidity/src/environments/foundry/optimism/soldeer.lock
@@ -0,0 +1,6 @@
+[[dependencies]]
+name = "@eth-optimism-contracts-bedrock"
+version = "0.17.3"
+url = "https://soldeer-revisions.s3.amazonaws.com/@eth-optimism-contracts-bedrock/0_17_3_06-06-2024_05:37:28_contracts-bedrock.zip"
+checksum = "cd0264f2f2c9f0278f7f8259f4a2b230897262afe14eb8baef996274e53c23db"
+integrity = "7646fa5b18fa27ac5e3de58996a778e2e3675a8d24d3fbf59a889f7397570a73"
diff --git a/packages/core/solidity/src/environments/foundry/optimism/soldeer.lock.d.ts b/packages/core/solidity/src/environments/foundry/optimism/soldeer.lock.d.ts
new file mode 100644
index 000000000..7cac97fd0
--- /dev/null
+++ b/packages/core/solidity/src/environments/foundry/optimism/soldeer.lock.d.ts
@@ -0,0 +1,2 @@
+declare const content: string;
+export default content;
diff --git a/packages/core/solidity/src/zip-foundry.ts b/packages/core/solidity/src/zip-foundry.ts
index 686f77090..0577e3563 100644
--- a/packages/core/solidity/src/zip-foundry.ts
+++ b/packages/core/solidity/src/zip-foundry.ts
@@ -210,8 +210,7 @@ then
   # Initialize sample Foundry project
   forge init --force --quiet
 
-${
-  c.upgradeable
+${c.upgradeable
     ? `\
   # Install OpenZeppelin Contracts and Upgrades
   forge install OpenZeppelin/openzeppelin-contracts-upgradeable@v${contracts.version} --quiet
@@ -221,7 +220,7 @@ ${
   # Install OpenZeppelin Contracts
   forge install OpenZeppelin/openzeppelin-contracts@v${contracts.version} --quiet\
 `
-}
+  }
 
   # Remove unneeded Foundry template files
   rm src/Counter.sol
@@ -237,8 +236,7 @@ ${
   then
     echo "" >> remappings.txt
   fi
-${
-  c.upgradeable
+${c.upgradeable
     ? `\
   echo "@openzeppelin/contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/" >> remappings.txt
   echo "@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/" >> remappings.txt
@@ -253,9 +251,8 @@ ${
     : `\
   echo "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/" >> remappings.txt\
 `
-}
-${
-  importsOptimism(c)
+  }
+${importsOptimism(c)
     ? `\
 
   # Setup Optimism dependencies
@@ -270,12 +267,12 @@ ${
     echo "${OPTIMISM_NPM_PACKAGE}/=$OPTIMISM_PATH" >> remappings.tmp
     mv remappings.tmp remappings.txt
   else
-    echo "Failed to update remappings.txt. Manually update remappings.txt to rename ${OPTIMISM_SOLDEER_PACKAGE}-${optimismSemver}/ to ${OPTIMISM_NPM_PACKAGE}/"
+    echo "Failed to setup Optimism dependencies. Run 'forge soldeer install', then update remappings.txt to rename ${OPTIMISM_SOLDEER_PACKAGE}-${optimismSemver}/ to ${OPTIMISM_NPM_PACKAGE}/"
     exit 1
   fi\
 `
     : ''
-}
+  }
 
   # Perform initial git commit
   git add .
@@ -326,6 +323,10 @@ export async function zipFoundry(c: Contract, opts?: GenericOptions) {
   zip.file(`test/${c.name}.t.sol`, test(c, opts));
   zip.file(`script/${c.name}.s.sol`, script(c, opts));
   zip.file('setup.sh', setupSh(c));
+  if (importsOptimism(c)) {
+    const soldeerLock = (await import('./environments/foundry/optimism/soldeer.lock')).default;
+    zip.file('soldeer.lock', soldeerLock);
+  }
   zip.file('README.md', readme(c));
 
   return zip;
diff --git a/packages/ui/rollup.config.mjs b/packages/ui/rollup.config.mjs
index 2f6eb05b4..a48dadf1f 100644
--- a/packages/ui/rollup.config.mjs
+++ b/packages/ui/rollup.config.mjs
@@ -43,6 +43,23 @@ function onStartRun(cmd, ...args) {
   };
 }
 
+function importTextAsString(extensions) {
+  return {
+    name: 'text-import',
+    async load(id) {
+      if (extensions.some(ext => id.endsWith(ext))) {
+        const { readFile } = await import('fs/promises');
+        try {
+          const content = await readFile(id, 'utf8');
+          return `export default ${JSON.stringify(content)};`;
+        } catch (error) {
+          this.error(`Could not read text file: ${id}`);
+        }
+      }
+    },
+  };
+}
+
 /** @type import('rollup').RollupOptions */
 export default [
   {
@@ -102,6 +119,9 @@ export default [
       // Generate openzeppelin-contracts.js data file
       onStartRun(...'yarn --cwd ../core/solidity prepare'.split(' ')),
 
+      // Import .lock files as strings, used for soldeer.lock for Download Foundry package
+      importTextAsString(['.lock']),
+
       svelte(await import('./svelte.config.js')),
 
       styles({

From 67d075ba50c2c105e07eba6f1c787ad04b0d363e Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 1 Aug 2025 23:07:18 -0400
Subject: [PATCH 46/54] Load soldeer lock differently for UI and tests

---
 .../core/solidity/src/zip-foundry.test.ts     |  16 ++++++++-------
 .../core/solidity/src/zip-foundry.test.ts.md  |  18 +++++++++++++++--
 .../solidity/src/zip-foundry.test.ts.snap     | Bin 4599 -> 4872 bytes
 packages/core/solidity/src/zip-foundry.ts     |  19 ++++++++++++++++--
 4 files changed, 42 insertions(+), 11 deletions(-)

diff --git a/packages/core/solidity/src/zip-foundry.test.ts b/packages/core/solidity/src/zip-foundry.test.ts
index e1a492aaf..f573da614 100644
--- a/packages/core/solidity/src/zip-foundry.test.ts
+++ b/packages/core/solidity/src/zip-foundry.test.ts
@@ -110,7 +110,7 @@ test.serial('custom cross chain messaging superchain', async t => {
     crossChainFunctionName: 'myCustomFunction',
   };
   const c = buildCustom(opts);
-  await runTest(c, t, opts);
+  await runTest(c, t, opts, true);
 });
 
 test.serial('custom transparent, managed', async t => {
@@ -133,18 +133,18 @@ test.serial('custom transparent, managed, cross chain messaging superchain', asy
     crossChainMessaging: 'superchain',
   };
   const c = buildCustom(opts);
-  await runTest(c, t, opts);
+  await runTest(c, t, opts, true);
 });
 
-async function runTest(c: Contract, t: ExecutionContext<Context>, opts: GenericOptions) {
+async function runTest(c: Contract, t: ExecutionContext<Context>, opts: GenericOptions, expectSoldeerLock?: boolean) {
   const zip = await zipFoundry(c, opts);
 
-  assertLayout(zip, c, t);
+  assertLayout(zip, c, t, expectSoldeerLock);
   await extractAndRunPackage(zip, c, t);
-  await assertContents(zip, c, t);
+  await assertContents(zip, c, t, expectSoldeerLock);
 }
 
-function assertLayout(zip: JSZip, c: Contract, t: ExecutionContext<Context>) {
+function assertLayout(zip: JSZip, c: Contract, t: ExecutionContext<Context>, expectSoldeerLock?: boolean) {
   const sorted = Object.values(zip.files)
     .map(f => f.name)
     .sort();
@@ -153,6 +153,7 @@ function assertLayout(zip: JSZip, c: Contract, t: ExecutionContext<Context>) {
     'script/',
     `script/${c.name}.s.sol`,
     'setup.sh',
+    ...(expectSoldeerLock ? ['soldeer.lock'] : []),
     'src/',
     `src/${c.name}.sol`,
     'test/',
@@ -198,12 +199,13 @@ async function extractAndRunPackage(zip: JSZip, c: Contract, t: ExecutionContext
   t.regex(rerunResult.stdout, /Foundry project already initialized\./);
 }
 
-async function assertContents(zip: JSZip, c: Contract, t: ExecutionContext<Context>) {
+async function assertContents(zip: JSZip, c: Contract, t: ExecutionContext<Context>, expectSoldeerLock?: boolean) {
   const normalizeVersion = (text: string) => text.replace(/\bv\d+\.\d+\.\d+\b/g, 'vX.Y.Z');
 
   const contentComparison = [
     normalizeVersion(await getItemString(zip, `setup.sh`)),
     await getItemString(zip, `README.md`),
+    ...(expectSoldeerLock ? [await getItemString(zip, `soldeer.lock`)] : []),
     await getItemString(zip, `script/${c.name}.s.sol`),
     await getItemString(zip, `src/${c.name}.sol`),
     await getItemString(zip, `test/${c.name}.t.sol`),
diff --git a/packages/core/solidity/src/zip-foundry.test.ts.md b/packages/core/solidity/src/zip-foundry.test.ts.md
index c91e05869..e0b23be1a 100644
--- a/packages/core/solidity/src/zip-foundry.test.ts.md
+++ b/packages/core/solidity/src/zip-foundry.test.ts.md
@@ -1105,7 +1105,7 @@ Generated by [AVA](https://avajs.dev).
           echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.tmp␊
           mv remappings.tmp remappings.txt␊
         else␊
-          echo "Failed to update remappings.txt. Manually update remappings.txt to rename @eth-optimism-contracts-bedrock-^0.17.3/ to @eth-optimism/contracts-bedrock/"␊
+          echo "Failed to setup Optimism dependencies. Run 'forge soldeer install', then update remappings.txt to rename @eth-optimism-contracts-bedrock-^0.17.3/ to @eth-optimism/contracts-bedrock/"␊
           exit 1␊
         fi␊
       ␊
@@ -1148,6 +1148,13 @@ Generated by [AVA](https://avajs.dev).
       ␊
       See [Solidity scripting guide](https://book.getfoundry.sh/guides/scripting-with-solidity) for more information.␊
       `,
+      `[[dependencies]]␊
+      name = "@eth-optimism-contracts-bedrock"␊
+      version = "0.17.3"␊
+      url = "https://soldeer-revisions.s3.amazonaws.com/@eth-optimism-contracts-bedrock/0_17_3_06-06-2024_05:37:28_contracts-bedrock.zip"␊
+      checksum = "cd0264f2f2c9f0278f7f8259f4a2b230897262afe14eb8baef996274e53c23db"␊
+      integrity = "7646fa5b18fa27ac5e3de58996a778e2e3675a8d24d3fbf59a889f7397570a73"␊
+      `,
       `// SPDX-License-Identifier: MIT␊
       pragma solidity ^0.8.27;␊
       ␊
@@ -1472,7 +1479,7 @@ Generated by [AVA](https://avajs.dev).
           echo "@eth-optimism/contracts-bedrock/=$OPTIMISM_PATH" >> remappings.tmp␊
           mv remappings.tmp remappings.txt␊
         else␊
-          echo "Failed to update remappings.txt. Manually update remappings.txt to rename @eth-optimism-contracts-bedrock-^0.17.3/ to @eth-optimism/contracts-bedrock/"␊
+          echo "Failed to setup Optimism dependencies. Run 'forge soldeer install', then update remappings.txt to rename @eth-optimism-contracts-bedrock-^0.17.3/ to @eth-optimism/contracts-bedrock/"␊
           exit 1␊
         fi␊
       ␊
@@ -1515,6 +1522,13 @@ Generated by [AVA](https://avajs.dev).
       ␊
       See [Solidity scripting guide](https://book.getfoundry.sh/guides/scripting-with-solidity) for more information.␊
       `,
+      `[[dependencies]]␊
+      name = "@eth-optimism-contracts-bedrock"␊
+      version = "0.17.3"␊
+      url = "https://soldeer-revisions.s3.amazonaws.com/@eth-optimism-contracts-bedrock/0_17_3_06-06-2024_05:37:28_contracts-bedrock.zip"␊
+      checksum = "cd0264f2f2c9f0278f7f8259f4a2b230897262afe14eb8baef996274e53c23db"␊
+      integrity = "7646fa5b18fa27ac5e3de58996a778e2e3675a8d24d3fbf59a889f7397570a73"␊
+      `,
       `// SPDX-License-Identifier: MIT␊
       pragma solidity ^0.8.27;␊
       ␊
diff --git a/packages/core/solidity/src/zip-foundry.test.ts.snap b/packages/core/solidity/src/zip-foundry.test.ts.snap
index f69e5dfe3ee46c77182e080556209607f40e47b7..fe3a8e8163a0dc0ab3f8792ae763fa11a4c4be98 100644
GIT binary patch
literal 4872
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

literal 4599
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

diff --git a/packages/core/solidity/src/zip-foundry.ts b/packages/core/solidity/src/zip-foundry.ts
index 0577e3563..d8fea9c93 100644
--- a/packages/core/solidity/src/zip-foundry.ts
+++ b/packages/core/solidity/src/zip-foundry.ts
@@ -316,6 +316,22 @@ forge script script/${c.name}.s.sol${c.upgradeable ? ' --force' : ''}
 See [Solidity scripting guide](https://book.getfoundry.sh/guides/scripting-with-solidity) for more information.
 `;
 
+/**
+ * Load soldeer.lock in environment specific way: browser (for UI) or Node.js (e.g. for tests)
+ */
+async function loadSoldeerLock() {
+  if (typeof process === 'undefined') {
+    // Browser environment - use Rollup plugin
+    return (await import('./environments/foundry/optimism/soldeer.lock')).default;
+  } else {
+    // Node.js environment - read file directly
+    const { readFile } = await import('fs/promises');
+    const { resolve } = await import('path');
+    const lockFilePath = resolve(__dirname, 'environments/foundry/optimism/soldeer.lock');
+    return await readFile(lockFilePath, 'utf8');
+  }
+}
+
 export async function zipFoundry(c: Contract, opts?: GenericOptions) {
   const zip = new JSZip();
 
@@ -324,8 +340,7 @@ export async function zipFoundry(c: Contract, opts?: GenericOptions) {
   zip.file(`script/${c.name}.s.sol`, script(c, opts));
   zip.file('setup.sh', setupSh(c));
   if (importsOptimism(c)) {
-    const soldeerLock = (await import('./environments/foundry/optimism/soldeer.lock')).default;
-    zip.file('soldeer.lock', soldeerLock);
+    zip.file('soldeer.lock', await loadSoldeerLock());
   }
   zip.file('README.md', readme(c));
 

From ca4ebd2ec65fafccff0d1a189c3d769e1c8d68b5 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 1 Aug 2025 23:07:37 -0400
Subject: [PATCH 47/54] Lint

---
 packages/core/solidity/src/zip-foundry.ts | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/packages/core/solidity/src/zip-foundry.ts b/packages/core/solidity/src/zip-foundry.ts
index d8fea9c93..1b9169991 100644
--- a/packages/core/solidity/src/zip-foundry.ts
+++ b/packages/core/solidity/src/zip-foundry.ts
@@ -210,7 +210,8 @@ then
   # Initialize sample Foundry project
   forge init --force --quiet
 
-${c.upgradeable
+${
+  c.upgradeable
     ? `\
   # Install OpenZeppelin Contracts and Upgrades
   forge install OpenZeppelin/openzeppelin-contracts-upgradeable@v${contracts.version} --quiet
@@ -220,7 +221,7 @@ ${c.upgradeable
   # Install OpenZeppelin Contracts
   forge install OpenZeppelin/openzeppelin-contracts@v${contracts.version} --quiet\
 `
-  }
+}
 
   # Remove unneeded Foundry template files
   rm src/Counter.sol
@@ -236,7 +237,8 @@ ${c.upgradeable
   then
     echo "" >> remappings.txt
   fi
-${c.upgradeable
+${
+  c.upgradeable
     ? `\
   echo "@openzeppelin/contracts/=lib/openzeppelin-contracts-upgradeable/lib/openzeppelin-contracts/contracts/" >> remappings.txt
   echo "@openzeppelin/contracts-upgradeable/=lib/openzeppelin-contracts-upgradeable/contracts/" >> remappings.txt
@@ -251,8 +253,9 @@ ${c.upgradeable
     : `\
   echo "@openzeppelin/contracts/=lib/openzeppelin-contracts/contracts/" >> remappings.txt\
 `
-  }
-${importsOptimism(c)
+}
+${
+  importsOptimism(c)
     ? `\
 
   # Setup Optimism dependencies
@@ -272,7 +275,7 @@ ${importsOptimism(c)
   fi\
 `
     : ''
-  }
+}
 
   # Perform initial git commit
   git add .

From b922cb5d8535f1e3a6df2af5d001b7a7349d6f92 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 1 Aug 2025 23:31:14 -0400
Subject: [PATCH 48/54] Simplify rollup plugin

---
 packages/ui/rollup.config.mjs | 12 ++++--------
 1 file changed, 4 insertions(+), 8 deletions(-)

diff --git a/packages/ui/rollup.config.mjs b/packages/ui/rollup.config.mjs
index a48dadf1f..c9eb6b027 100644
--- a/packages/ui/rollup.config.mjs
+++ b/packages/ui/rollup.config.mjs
@@ -43,18 +43,14 @@ function onStartRun(cmd, ...args) {
   };
 }
 
-function importTextAsString(extensions) {
+function importTextAsString(fileExtensions) {
   return {
     name: 'text-import',
     async load(id) {
-      if (extensions.some(ext => id.endsWith(ext))) {
+      if (fileExtensions.some(ext => id.endsWith(ext))) {
         const { readFile } = await import('fs/promises');
-        try {
-          const content = await readFile(id, 'utf8');
-          return `export default ${JSON.stringify(content)};`;
-        } catch (error) {
-          this.error(`Could not read text file: ${id}`);
-        }
+        const content = await readFile(id, 'utf8');
+        return `export default ${JSON.stringify(content)};`;
       }
     },
   };

From 36fce55b566b2b312e7966b12cb7f7ecd2c94de1 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 1 Aug 2025 23:39:10 -0400
Subject: [PATCH 49/54] Rename arg toChainId

---
 .../solidity/src/add-superchain-messaging.ts  |   6 +++---
 packages/core/solidity/src/custom.test.ts.md  |  12 ++++++------
 .../core/solidity/src/custom.test.ts.snap     | Bin 1639 -> 1640 bytes
 .../core/solidity/src/zip-foundry.test.ts.md  |  12 ++++++------
 .../solidity/src/zip-foundry.test.ts.snap     | Bin 4872 -> 4871 bytes
 .../core/solidity/src/zip-hardhat.test.ts.md  |  12 ++++++------
 .../solidity/src/zip-hardhat.test.ts.snap     | Bin 3204 -> 3207 bytes
 7 files changed, 21 insertions(+), 21 deletions(-)

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index 148f411c4..e2861e800 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -68,7 +68,7 @@ function addSourceFunction(sanitizedFunctionName: string, access: Access, c: Con
   const sourceFn: BaseFunction = {
     name: `call${sanitizedFunctionName.replace(/^(.)/, c => c.toUpperCase())}`,
     kind: 'public' as const,
-    args: [{ name: '_toChainId', type: 'uint256' }],
+    args: [{ name: 'toChainId', type: 'uint256' }],
   };
 
   if (access) {
@@ -83,8 +83,8 @@ function addSourceFunction(sanitizedFunctionName: string, access: Access, c: Con
 
   c.setFunctionBody(
     [
-      'if (_toChainId == block.chainid) revert InvalidDestination();',
-      `messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
+      'if (toChainId == block.chainid) revert InvalidDestination();',
+      `messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
     ],
     sourceFn,
   );
diff --git a/packages/core/solidity/src/custom.test.ts.md b/packages/core/solidity/src/custom.test.ts.md
index c5a85294e..3861abdeb 100644
--- a/packages/core/solidity/src/custom.test.ts.md
+++ b/packages/core/solidity/src/custom.test.ts.md
@@ -186,9 +186,9 @@ Generated by [AVA](https://avajs.dev).
         }␊
     ␊
         /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
-        function callMyFunction(uint256 _toChainId) public {␊
-            if (_toChainId == block.chainid) revert InvalidDestination();␊
-            messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+        function callMyFunction(uint256 toChainId) public {␊
+            if (toChainId == block.chainid) revert InvalidDestination();␊
+            messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
         }␊
     ␊
         /**␊
@@ -233,9 +233,9 @@ Generated by [AVA](https://avajs.dev).
     ␊
         constructor(address initialOwner) Ownable(initialOwner) {}␊
     ␊
-        function callMyFunction(uint256 _toChainId) public onlyOwner whenNotPaused {␊
-            if (_toChainId == block.chainid) revert InvalidDestination();␊
-            messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+        function callMyFunction(uint256 toChainId) public onlyOwner whenNotPaused {␊
+            if (toChainId == block.chainid) revert InvalidDestination();␊
+            messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
         }␊
     ␊
         /**␊
diff --git a/packages/core/solidity/src/custom.test.ts.snap b/packages/core/solidity/src/custom.test.ts.snap
index b2ae7baf2d7ce50c4c54ae586b6c95625d6810a4..498cd7f95fc443135435873c9f366e712e9a3cd0 100644
GIT binary patch
delta 986
zcmV<0110?D4Co9pK~_N^Q*L2!b7*gLAa*kf0|2XWK(<IHnx9a!zSq6#EvC?Fg+G8n
zdQl+SD2+Luwg{0jKT%Fd91th2<*)D$_!ImC&S>__J9eB8C<z7ol<dCW?>o;tGy8Tt
zV!}O9Km3B4YKCJsR9g5{aT2Jh(CW=w&m)?=`02sc!!7gM{&4H#55C)x!6*SYk?J89
zRjqxwS17oND0Jtk7F-lw7m|?AK8>>>0UH4U_LDsVfEe!+$2ncfLBwsjWCwU;<?zY-
zMithrymyn;0+N64AKnLR>C^_IQ)@_}R8#nb@-8Zce1bA-1L|o-1e*F(`MIrsgq{@c
ziKC?JbZX8OmX?nz5<Lu<n5)~kV00vjq^O*Q{#D(+1wl}nXsnzPNe#ADsPBi`{1sWa
zBCl+dPZgqW$FKIUQY_|D=+uUT-mp^}HjaAz{;=8W*4uvv!)~kJZykKyIx6kO`#ef1
zBs2(PC=Z0b!gc}$u|k`l5=On8U>~`+MyiQQQyx)-V(QlyUNnIb5y+V_k&K9YVlgN>
zhN7<~RTcSwNBfX0sA5)_QVArUqSUv^C9|DPlxs_q38s1Fz3M4d3y0U$B7$6tTt(C4
z;VB&S2CaWx7)+_kQ9yGe5=f!Z)#z2B&gX(7xP*gC7z3S`uG(bH2z2MqlYfgL<+}Ft
z3(%rrK%?zt{L!v$_8#{4A-Z6yMkqtQ<s_F{nHpIX(6lJ2+`??xu3Q<&h*puCTOZS{
z=xNo@;x0qc*?~c?+1rJ>=K+zE(2z_8J5H%&^HhIlXD5zgC$4C_d)PY~)DH&BWz{lN
zI@z`&EF&89)Z9Axn1%;}gV0ly5T&oGsp<9@h`AWZxUiQQGX09z9D3_)5<ZVD0_BlF
zKLheIPz|mKnFkSQq#k|3s7pntfS4UbffhjdsW?HHi%>4|ijYoEiH<#FArAxurgvON
z6H|XSYT$=T1JWo(4;7un;Uw`(<0OVIvnu0BOY{6(!Dy~Ax~bCwMwynEdel=X!pRh<
zE`yK|Dul*St3GJe;vmVwPgcAraH@c6g>1Yi<Y;aR-s;t(uoJG4=H}Q#zZje=#s=^#
zK9Z~hoZOOdoWx3Yya6UA)P=E-QN0#JWx{`-QN~O?%;G~Y$(85kXqiHteRkPKo*oil
z{l(%(zgau`uOIzScJ_O}%)DEQu{b}Kv+L3g@7VB;zs)<|*&X|hdB)=Ed^SaXAhen1
z?1;4C9~=I$;U5YAShqm_AvW?a`)GDnS^gXo)0LZE25-LAY`)cOzSZ2>x0*izGB5^d
IC5R#b0A3#F6#xJL

delta 985
zcmV;~119|F4Cf3oK~_N^Q*L2!b7*gLAa*kf0|4UrRRM7)aY<C}I6I~fPCy5F!#bG!
zh4%s@zBF}tBesz;KTxhcAg-LskKrHi8~6vD(d?IZ>^L7#5(@Sy*?qs?cb<7>_T6~I
zgnOdi{(_onhGREWTKH6P5~!)r>diaPBbvPU>A}{+E%V#{c<a-Te%O)1C;@ko>me3X
zt$n>$D7c9zbmyrSTohgxl910nkFz2H8vz0SlRg4~7#|YHIbF&@#BI4`2Y6)V@Y#n(
z71pi1_mkEFl7F`k?}N2;Y6H=!HKb6gDSSeC7nMRjL7BAy^|T@aO?|5T+}1xrPYU<M
zQPOofHRlRT%f}Uo9tKRz)oolbI+8?ERL(;Gs&3zcASg{VR!)he2HPss_d{*|iY#1_
zSGLKg3Q@P?SNm5f7IP_dYQsTq*r^R0N4<W3*z9%d?SF$|x7F{r4!&(2mG<I&9;Fl#
z8iX;F2SQ(AJAr~&q0LVTqh3z1kK9`$)kLK!k0?Sh_3H~Sn!tz%<jj~zM#Md_7!(~t
z(N~kIihRJMeMlBmF)K`|1QJhC>f7X!+0G`)wWY}f)4cLt^^~fG!|Q4hL9RuvqUrJQ
z6b^cW)_*Pxrc~u9pt%tVq|oSU^r}$jbHNc@!oeksfzC@;ZL($ry7TABzr~PpU3>Z!
z47F$&)M$GdfwYUe5P<!Ch_0Bb5zbI=InAYJrdAduG)+osm$O^8i&q9RqE+PP;>R>B
zdRq0f(92MCc3{wJ_I9D}c|hbOG(1zmj#DbxRDadk*@?s0iHq9q9`=p~^@G83Wwi{I
zPIj&c&WHv*H5X4lrs09$AoLU^MER>~YPvlJV(tbqI_zbJOv~bBhu%7ygwJD(KzSt4
z&#=4<RD&x*=0SuTsYjnM>QWIZAZ8O$paoEVDozmQB9x1~BCyj_qGJzP$O8d^X&%?n
z(0`PT8u+2ofHX?cLq#WXI7$4{IEm5AEX;V=(mcOZFq&(OF6*>_QKsdk9`#g;a54p|
z%OE6#3ZZe-st;PVI7qValNB!toGPGNAsa6WIhvb-w|ey`?1XNlxjFXSF9zp|u>m}b
zPbKRxC$}gZC$W;9aDa&kbzv-IRIkNQnSbzSlrd8ev;NRaa^<->T4qsaUtG4Ar{@G%
zf4BI_Z`S7i>nHz{&Hdi*Gw+sVERIm+?8bCMJvP+iZ&Q!=cFlfss<F5}pG}b;2yF&B
zJ0@)?$cBP!C`d*@)-92Lh>-ltKAoLamOskGjOC_R!kaHPn=dw-FE)4f#pX}^eFi3K
Hjv@d6s2bhS

diff --git a/packages/core/solidity/src/zip-foundry.test.ts.md b/packages/core/solidity/src/zip-foundry.test.ts.md
index e0b23be1a..0f3357823 100644
--- a/packages/core/solidity/src/zip-foundry.test.ts.md
+++ b/packages/core/solidity/src/zip-foundry.test.ts.md
@@ -1195,9 +1195,9 @@ Generated by [AVA](https://avajs.dev).
           }␊
       ␊
           /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
-          function callMyCustomFunction(uint256 _toChainId) public {␊
-              if (_toChainId == block.chainid) revert InvalidDestination();␊
-              messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myCustomFunction, (/* TODO: Add arguments */)));␊
+          function callMyCustomFunction(uint256 toChainId) public {␊
+              if (toChainId == block.chainid) revert InvalidDestination();␊
+              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myCustomFunction, (/* TODO: Add arguments */)));␊
           }␊
       ␊
           /**␊
@@ -1590,9 +1590,9 @@ Generated by [AVA](https://avajs.dev).
               __AccessManaged_init(initialAuthority);␊
           }␊
       ␊
-          function callMyFunction(uint256 _toChainId) public restricted {␊
-              if (_toChainId == block.chainid) revert InvalidDestination();␊
-              messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+          function callMyFunction(uint256 toChainId) public restricted {␊
+              if (toChainId == block.chainid) revert InvalidDestination();␊
+              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
           }␊
       ␊
           /**␊
diff --git a/packages/core/solidity/src/zip-foundry.test.ts.snap b/packages/core/solidity/src/zip-foundry.test.ts.snap
index fe3a8e8163a0dc0ab3f8792ae763fa11a4c4be98..0386928d79c6318e87de6bd35ff13079c01bc246 100644
GIT binary patch
delta 4472
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
K2f@sgwg3R%d%_L?

delta 4458
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

diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.md b/packages/core/solidity/src/zip-hardhat.test.ts.md
index 92d3ceae4..a10e56981 100644
--- a/packages/core/solidity/src/zip-hardhat.test.ts.md
+++ b/packages/core/solidity/src/zip-hardhat.test.ts.md
@@ -416,9 +416,9 @@ Generated by [AVA](https://avajs.dev).
           }␊
       ␊
           /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
-          function callMyFunction(uint256 _toChainId) public {␊
-              if (_toChainId == block.chainid) revert InvalidDestination();␊
-              messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+          function callMyFunction(uint256 toChainId) public {␊
+              if (toChainId == block.chainid) revert InvalidDestination();␊
+              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
           }␊
       ␊
           /**␊
@@ -610,9 +610,9 @@ Generated by [AVA](https://avajs.dev).
           }␊
       ␊
           /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
-          function callMyFunction(uint256 _toChainId) public {␊
-              if (_toChainId == block.chainid) revert InvalidDestination();␊
-              messenger.sendMessage(_toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+          function callMyFunction(uint256 toChainId) public {␊
+              if (toChainId == block.chainid) revert InvalidDestination();␊
+              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
           }␊
       ␊
           /**␊
diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.snap b/packages/core/solidity/src/zip-hardhat.test.ts.snap
index 672446ac38f4cac79d4d22436fcbdf138b588a79..0584cf7d1575c507638bd118324eedce92395f6f 100644
GIT binary patch
literal 3207
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

literal 3204
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


From c4b49d7006062b018f685233c1ba163ce5fe55d5 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Wed, 6 Aug 2025 13:17:11 -0400
Subject: [PATCH 50/54] Change string concat from code review

---
 packages/ui/src/solidity/superchain-tooltip.ts | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/packages/ui/src/solidity/superchain-tooltip.ts b/packages/ui/src/solidity/superchain-tooltip.ts
index e28a3382f..ed50d451b 100644
--- a/packages/ui/src/solidity/superchain-tooltip.ts
+++ b/packages/ui/src/solidity/superchain-tooltip.ts
@@ -11,12 +11,12 @@ export const superchainGenericTooltipProps: { [prop: string]: string | boolean }
 };
 
 const ERC20_REQUIREMENTS =
-  ' Requires deploying your contract to the same address on every chain in the Superchain. <a class="light-link" href="https://docs.optimism.io/stack/interop/superchain-erc20#requirements" target="_blank" rel="noopener noreferrer">Read more.</a>';
+  'Requires deploying your contract to the same address on every chain in the Superchain. <a class="light-link" href="https://docs.optimism.io/stack/interop/superchain-erc20#requirements" target="_blank" rel="noopener noreferrer">Read more.</a>';
 
 /**
  * Tippy.js properties for the SuperchainERC20 tooltip.
  */
 export const superchainERC20TooltipProps: { [prop: string]: string | boolean } = {
   ...superchainGenericTooltipProps,
-  content: superchainGenericTooltipProps.content + ERC20_REQUIREMENTS,
+  content: superchainGenericTooltipProps.content + ' ' + ERC20_REQUIREMENTS,
 };

From 15561eabbf64f94717cbcfcbdaeafcdc70198c18 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Thu, 7 Aug 2025 11:10:18 -0400
Subject: [PATCH 51/54] Update TODO to be more actionable

---
 packages/core/solidity/src/add-superchain-messaging.ts | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index e2861e800..29a8d7f3c 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -84,7 +84,7 @@ function addSourceFunction(sanitizedFunctionName: string, access: Access, c: Con
   c.setFunctionBody(
     [
       'if (toChainId == block.chainid) revert InvalidDestination();',
-      `messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments */)));`,
+      `messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments to match ${sanitizedFunctionName} */)));`,
     ],
     sourceFn,
   );

From 0db2964cef754069aba39c523d1720476ef513fe Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Thu, 7 Aug 2025 11:48:08 -0400
Subject: [PATCH 52/54] Update snapshots

---
 packages/core/solidity/src/custom.test.ts.md  |   4 ++--
 .../core/solidity/src/custom.test.ts.snap     | Bin 1640 -> 1650 bytes
 .../core/solidity/src/zip-foundry.test.ts.md  |   4 ++--
 .../solidity/src/zip-foundry.test.ts.snap     | Bin 4871 -> 4887 bytes
 .../core/solidity/src/zip-hardhat.test.ts.md  |   4 ++--
 .../solidity/src/zip-hardhat.test.ts.snap     | Bin 3207 -> 3218 bytes
 6 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/packages/core/solidity/src/custom.test.ts.md b/packages/core/solidity/src/custom.test.ts.md
index 3861abdeb..26d99db9e 100644
--- a/packages/core/solidity/src/custom.test.ts.md
+++ b/packages/core/solidity/src/custom.test.ts.md
@@ -188,7 +188,7 @@ Generated by [AVA](https://avajs.dev).
         /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
         function callMyFunction(uint256 toChainId) public {␊
             if (toChainId == block.chainid) revert InvalidDestination();␊
-            messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+            messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments to match myFunction */)));␊
         }␊
     ␊
         /**␊
@@ -235,7 +235,7 @@ Generated by [AVA](https://avajs.dev).
     ␊
         function callMyFunction(uint256 toChainId) public onlyOwner whenNotPaused {␊
             if (toChainId == block.chainid) revert InvalidDestination();␊
-            messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+            messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments to match myFunction */)));␊
         }␊
     ␊
         /**␊
diff --git a/packages/core/solidity/src/custom.test.ts.snap b/packages/core/solidity/src/custom.test.ts.snap
index 498cd7f95fc443135435873c9f366e712e9a3cd0..cb5cdb4884934ec825bbb614a83259f6dcfc72e6 100644
GIT binary patch
literal 1650
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

literal 1640
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

diff --git a/packages/core/solidity/src/zip-foundry.test.ts.md b/packages/core/solidity/src/zip-foundry.test.ts.md
index 0f3357823..a6fe01b52 100644
--- a/packages/core/solidity/src/zip-foundry.test.ts.md
+++ b/packages/core/solidity/src/zip-foundry.test.ts.md
@@ -1197,7 +1197,7 @@ Generated by [AVA](https://avajs.dev).
           /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
           function callMyCustomFunction(uint256 toChainId) public {␊
               if (toChainId == block.chainid) revert InvalidDestination();␊
-              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myCustomFunction, (/* TODO: Add arguments */)));␊
+              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myCustomFunction, (/* TODO: Add arguments to match myCustomFunction */)));␊
           }␊
       ␊
           /**␊
@@ -1592,7 +1592,7 @@ Generated by [AVA](https://avajs.dev).
       ␊
           function callMyFunction(uint256 toChainId) public restricted {␊
               if (toChainId == block.chainid) revert InvalidDestination();␊
-              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments to match myFunction */)));␊
           }␊
       ␊
           /**␊
diff --git a/packages/core/solidity/src/zip-foundry.test.ts.snap b/packages/core/solidity/src/zip-foundry.test.ts.snap
index 0386928d79c6318e87de6bd35ff13079c01bc246..75b1a868cc63a6e889e07b2a9fa6d4ca81024140 100644
GIT binary patch
delta 4604
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

delta 4581
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
Pr1}2=Ob5Ztl(ql>bawU6

diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.md b/packages/core/solidity/src/zip-hardhat.test.ts.md
index a10e56981..a056da419 100644
--- a/packages/core/solidity/src/zip-hardhat.test.ts.md
+++ b/packages/core/solidity/src/zip-hardhat.test.ts.md
@@ -418,7 +418,7 @@ Generated by [AVA](https://avajs.dev).
           /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
           function callMyFunction(uint256 toChainId) public {␊
               if (toChainId == block.chainid) revert InvalidDestination();␊
-              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments to match myFunction */)));␊
           }␊
       ␊
           /**␊
@@ -612,7 +612,7 @@ Generated by [AVA](https://avajs.dev).
           /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
           function callMyFunction(uint256 toChainId) public {␊
               if (toChainId == block.chainid) revert InvalidDestination();␊
-              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments */)));␊
+              messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments to match myFunction */)));␊
           }␊
       ␊
           /**␊
diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.snap b/packages/core/solidity/src/zip-hardhat.test.ts.snap
index 0584cf7d1575c507638bd118324eedce92395f6f..e533380e8fe147b06021d98c70eb09d1da7a29cc 100644
GIT binary patch
delta 3090
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

delta 3079
zcmV+i4EXbs8HX8vK~_N^Q*L2!b7*gLAa*kf0|1v#Vn1V>$}`UO<j04=(}-N4(F+~G
zB#vw=WrE|AEu0^V2mk;800003?ORK49LEu!)x(lkh6Ka@0hL7n&l1ZSas^2NX$GQ6
zDj~ub$YoxFP4~|9?zTD8z3%QIxgvN75+De2^(i+80er}RFUToCfSeK_M<a&-0rC%W
z$RURy=<a##?C`OoMau9BkjUw&u2*+geO1%?yweVtw=aJATP%qT@F$pi%^B!KK|lmW
zebHl5{OohzM-u(y{=aTocP#a%a<}rv`<7*WU|H5L?poIG-?S|2o@KrNmSw$DdE@QM
z?M2Sfpi)VHetYoXfmNwmmD^V3E$f}i4eQ;?O{;SI?He<9T^Dw?mVZ3GMm$Ufo?i7a
zm83&3pM&+)R@HT3iG_V6Njt!BNMsK-`<VU|_xm^?6qXp39C=c}M~|EtXQtZcs2d^>
zEFeCS1Ndmh`Hs_kGGDEdu+O-J<3-QILg<MsIDrm-XCc&{vOcCSVy>>2aCMO;c8BIT
zf(5ntl;6tsQgh}!K9cQY>S|K+ZyA#hB2G~|z~eB(M-o#(7!~dik23zx0wj9tgv!eZ
zNSTyL*g}!GtOW^=QvR5S<WlMz4rRQ5$Rrk*VXYYyIBziOozFFrBoMBljTuyvx3E5F
zDWO1r1ZXi07+UD~G4WahhW2XmR$CoEXg%ZK)76CIDgZ!xAhCGZgnrZxhzA~{LLw?*
zYjJmHWqWUXb8Q6{U>|!P+HXF3Y}axxYW4Xud91H)v`Ts8UML=#iJrwHPcm*J-{)8e
z;MgO5f~jmkGUVe9iUPUlhlFOMeH01Iv*(b1P>Fe6Ggg1J>2_^>0NS;+2GrJDKd2Q5
zjMH*t=KXO>wWs*nIjx#AGczy+vokO?1wQsjhyr2PW54JrU5=>SW&yUBSDr2IuC?|S
zm)BP}wDFB0bINDs{N0G{EGNu4wUIc$5S|zhcOvRZ!l>b5*OT>PG#C^`)$>-z^ySQd
zB04U+bVfNt?c-!2C2K%LsBAuZ3@Bs~m7{WUhSx_HOEHKi4vBMJX!S63SP-y7Lc6Ja
z0f=K@2bgo>W3>lAjR?m+v<I*gCmE-p@?O;Uk;JLi>hNcqF>k{G3L>0sJH1L21?fN{
z*Uq2(?5JnQxwth&)W_UO6fp`Y!A4+zxu>a)KdIL2kmk>fadY~3K=9!yY9_(P#IuY8
z$1>tnfE`<3)Y-g`RgaZ1N+kN8RAU5DsU#5M-AWQ_;rodDJtTJp=1YurNEed0+cR%e
z#O;u77M^QQDGQ0$VG;F_@_`#uPD{puHak**xT-@Dn7MN$QWmrg3F4TGEjqw|T;+y2
zs2K!OYv^Htr6jZ~=2F91Uy_i#P>3h<1=g|Mp99Gw+=z!y%rE-KNuzo)U#;RJZAct9
zVkPHOH{D3w^g%`Ou2B@?+Fa_8X@SCifVFD1SmB!1c*dDEqdpcMCw&>eF@qr@`iW2<
zA32{0GinG$EwQ5}v5+}wpr5OMu>my{$sXew)4)JLHL$+gN~9kw<36T7rXImL)~94r
zHQ4~c*xl!^u$u8WKO-j4FPhHmV`o<DTs=vgdNXlqJ==Tjhy?yR^P>Q#yY5ucq)Uk&
z2=xR}8(qj8Kb3%V{xOfW2H0U87QPF|>inv}wYj`G2Rm3MAqETRFb=YRhap7~h<Bq9
zQz@X01E!9y+16o<E*2nk65>>1tpU$->1{aKCP~)hmJdzhj?eIM%J*cxdQ#6e<gLVa
zpWR4(hmZQ$ld0Rh9wIpe1z7el7sa!zd}j7$8|U>+qnT}jze?aOY|gJXuGRn~2Gkp&
zOgxg56wi<X9|Kqbbcl$5jP-E3SQaQU@k8JxgDbEAc9F*p=~B!UICwtup%X9Md~SB$
z+2=5rEoETV=bWj{(y3-i&zbr#H#IkxXtd|y)NciEIX><OY+zq-U&XQCuu6D4>ggHd
z%bJzi)^_50vzhDyy^4Ewz3xcn;7=nI<UyShpth*`8yCVHbMHxia~7h0mm?pmP&`@?
z-}_BjLA-m*vVM2lvOc<FSzo+4Zb4kRbqxja%J$Ne=Im}}>pA7hbj~eVLG+|K>yB_L
zR70yO?xBFZ7*|T4v!g*=CJiwu2-rN-dGjT0iHrSFCIu<GyIVUiDI#x3fz4Tk-;m83
z_YM2G0i#McpdcWBj&iQ+!c#92l7(~ZMWUUUj;KH#JdG3r&X->!<=7Ca_KC)#se(E<
zl;ca1(xezO9@^9>FG2Dd9nVYJGgj}Z*Cn-Et_a$Tonc6aWaOy|?lIJ-=)Pyr3VD%u
zI5mOd!&L>MR20%_{sM458=%2JD`uc@DZ+jKRU_P#bZGy7CUnXEh_~j~9tnT(jYY!e
zho|!<jqC|U|M05d_Tw7`OxQ>gbSXM4pggrwap?MraNcF1_Xtu-tcfAgmdX`&L5T)D
z&j+**b-cPDI#Oa;fSrJK?T<BgFp{tjlEJr+3w*j*E*i7!`pL%%B2^Xs_z_mnmW3gv
zKFA(X{Wht8BAsH=#-MYJWDp5#ptc)3_5kz2VGnbxxFG67pR+#Z!2o)Q`T+*aIpe~q
znzeE~B)y((>(RL4$&ApW@jK;%K4&U>JNSsmCFU!y&Yn_x{IfD%?Q!-#d(Eqm{B9Ye
z5IGCczw|!6Y8)S8?#<3VdIW7Gh&Kx1@BFz8!auuzVOil#%lgwT%lg;taUuM_E7t?z
zm7N#<dZCDupXCtxf*;0W>T^C?C^0ES&2RHUgMSFB<(u(}fnDoK*%x!J8xA5)++*UO
z<XZMIcYBn_aS_Z3EO)n8Z6Uep^oBT82aMvwh?AjqvN<z32pUg}Nhe*&NmueU>`LDM
zCUhl#i@9Z-*5lvCO#hRle?}Xxq`JOjj*mF8XNGcoS==wl_JL_?oR;iwe^!?4zqBmt
ze-+ExxoKGox5iEOKew(h+2@jLG7F9;*=Le{UZ?EyrFB)=CpiP92`HCI(z8-bCQDgZ
zem<H*(rKrqk>#&AjpWq1rc9D*P)sHlO9f+pg#VG)ee_-&ygkl@0OdgnAr=C46-L*0
z0`%Z$Tz~7YWpVu<cP#7Ho0j$Ks%1s@#*OR0x^oRh-0E7h#nzfj$^*+x#glafn`jsF
z^!Q-en>N8wgt;DG8~dDj`>x=gyVi8i;8dvgwm3GcC&m#GkTyr0VBu!-OG?08mV%34
zes~ZPNj!akI8niVnuK8_)o+@^8Fr-~50VLb_n21;XHB$oCag90TAO=o&Ap}V&7GaS
z<<0fQ)s4ONm7SfHjqj~&r?^EmonQ$C0p=S_p20gl5@y0GJwO5RbA&sS%?TO~{h=>2
zqyu&+x{lB?;9HaR2_X#U3tes(ZfLpi)W-*tA_^=4S(8r+NPn7g>-EBAx2Y+k#gy^r
z>iX8^c588?RdlQ5k&q(IIsz16>0uBk#OZxDMuDlUVuH4C64t97K<YkV`sK{e>OLZ}
z&hsfe5go*7fKW}aljeX15S0p}zy}>P5{V%Sh(}l?Kqn@3)eZ<fVEY&bEaI76I?_o6
zzcjy8<rag!T7Nq#^^R$%X%I$20w&r-9}Cho>cskUCB%d-bt=tHOYD44=*zHb&Enp8
zVs#=>_Be~WJy7@M7}qWHrR|l))=JYTi848<^R(hb0FeR*oy?K#fpYlD=Au^Hi!ZCk
zlH9_r%51}*zHLC=a8@5MPYXD?Bav48>BmqASeJNd&3~V5Dy9A*2?FI0b@;F!+e&l$
zXwqA|WOXCIvDMAl07g%kab}-54=44|q#k-r>meSOLucMVySq?U`TU_`S$E^lSATh9
z+{y=E$LFh8b}y{78Y$kVy83%jlUqKMTRxLpKIIAXKb7mh<x>d!m%gzxxux?Gw{-Si
z*)5%~4|K8^Yk$3L>-FI%)_93F?1QKbjQsJgW!<k@)_?C=*3J9lf|32}`2XS8(T08H
z7vry{&wCkUHEH}#8o#GEey{NVD@+>AlScET(L8B1PfGHywj}@iq$GcpCHZUB^_~>*
VlOldn#9u`b|9`OC#a6^k003+#^fUkf


From a815fae67a266edffbd56a30c411774752f70742 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Thu, 7 Aug 2025 15:03:43 -0400
Subject: [PATCH 53/54] Remove redundant check when toChainId is the current
 chain

---
 .../solidity/src/add-superchain-messaging.ts  |   2 --
 packages/core/solidity/src/custom.test.ts.md  |   4 ----
 .../core/solidity/src/custom.test.ts.snap     | Bin 1650 -> 1613 bytes
 .../core/solidity/src/zip-foundry.test.ts.md  |   4 ----
 .../solidity/src/zip-foundry.test.ts.snap     | Bin 4887 -> 4857 bytes
 .../core/solidity/src/zip-hardhat.test.ts.md  |   4 ----
 .../solidity/src/zip-hardhat.test.ts.snap     | Bin 3218 -> 3189 bytes
 7 files changed, 14 deletions(-)

diff --git a/packages/core/solidity/src/add-superchain-messaging.ts b/packages/core/solidity/src/add-superchain-messaging.ts
index 29a8d7f3c..267e38730 100644
--- a/packages/core/solidity/src/add-superchain-messaging.ts
+++ b/packages/core/solidity/src/add-superchain-messaging.ts
@@ -28,7 +28,6 @@ function safeSanitizeFunctionName(functionName: string) {
 function addCustomErrors(c: ContractBuilder) {
   c.addCustomError('CallerNotL2ToL2CrossDomainMessenger');
   c.addCustomError('InvalidCrossDomainSender');
-  c.addCustomError('InvalidDestination');
 }
 
 function addCrossDomainMessengerImmutable(c: ContractBuilder) {
@@ -83,7 +82,6 @@ function addSourceFunction(sanitizedFunctionName: string, access: Access, c: Con
 
   c.setFunctionBody(
     [
-      'if (toChainId == block.chainid) revert InvalidDestination();',
       `messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.${sanitizedFunctionName}, (/* TODO: Add arguments to match ${sanitizedFunctionName} */)));`,
     ],
     sourceFn,
diff --git a/packages/core/solidity/src/custom.test.ts.md b/packages/core/solidity/src/custom.test.ts.md
index 26d99db9e..d83d76191 100644
--- a/packages/core/solidity/src/custom.test.ts.md
+++ b/packages/core/solidity/src/custom.test.ts.md
@@ -177,7 +177,6 @@ Generated by [AVA](https://avajs.dev).
     ␊
         error CallerNotL2ToL2CrossDomainMessenger();␊
         error InvalidCrossDomainSender();␊
-        error InvalidDestination();␊
     ␊
         modifier onlyCrossDomainCallback() {␊
             if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
@@ -187,7 +186,6 @@ Generated by [AVA](https://avajs.dev).
     ␊
         /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
         function callMyFunction(uint256 toChainId) public {␊
-            if (toChainId == block.chainid) revert InvalidDestination();␊
             messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments to match myFunction */)));␊
         }␊
     ␊
@@ -223,7 +221,6 @@ Generated by [AVA](https://avajs.dev).
     ␊
         error CallerNotL2ToL2CrossDomainMessenger();␊
         error InvalidCrossDomainSender();␊
-        error InvalidDestination();␊
     ␊
         modifier onlyCrossDomainCallback() {␊
             if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
@@ -234,7 +231,6 @@ Generated by [AVA](https://avajs.dev).
         constructor(address initialOwner) Ownable(initialOwner) {}␊
     ␊
         function callMyFunction(uint256 toChainId) public onlyOwner whenNotPaused {␊
-            if (toChainId == block.chainid) revert InvalidDestination();␊
             messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments to match myFunction */)));␊
         }␊
     ␊
diff --git a/packages/core/solidity/src/custom.test.ts.snap b/packages/core/solidity/src/custom.test.ts.snap
index cb5cdb4884934ec825bbb614a83259f6dcfc72e6..b6f2a4811c4366f2feb74b3f017231ca421bd046 100644
GIT binary patch
literal 1613
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
LioI6f<{<z8)DjFN

literal 1650
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

diff --git a/packages/core/solidity/src/zip-foundry.test.ts.md b/packages/core/solidity/src/zip-foundry.test.ts.md
index a6fe01b52..b580a2ce4 100644
--- a/packages/core/solidity/src/zip-foundry.test.ts.md
+++ b/packages/core/solidity/src/zip-foundry.test.ts.md
@@ -1186,7 +1186,6 @@ Generated by [AVA](https://avajs.dev).
       ␊
           error CallerNotL2ToL2CrossDomainMessenger();␊
           error InvalidCrossDomainSender();␊
-          error InvalidDestination();␊
       ␊
           modifier onlyCrossDomainCallback() {␊
               if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
@@ -1196,7 +1195,6 @@ Generated by [AVA](https://avajs.dev).
       ␊
           /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
           function callMyCustomFunction(uint256 toChainId) public {␊
-              if (toChainId == block.chainid) revert InvalidDestination();␊
               messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myCustomFunction, (/* TODO: Add arguments to match myCustomFunction */)));␊
           }␊
       ␊
@@ -1573,7 +1571,6 @@ Generated by [AVA](https://avajs.dev).
       ␊
           error CallerNotL2ToL2CrossDomainMessenger();␊
           error InvalidCrossDomainSender();␊
-          error InvalidDestination();␊
       ␊
           modifier onlyCrossDomainCallback() {␊
               if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
@@ -1591,7 +1588,6 @@ Generated by [AVA](https://avajs.dev).
           }␊
       ␊
           function callMyFunction(uint256 toChainId) public restricted {␊
-              if (toChainId == block.chainid) revert InvalidDestination();␊
               messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments to match myFunction */)));␊
           }␊
       ␊
diff --git a/packages/core/solidity/src/zip-foundry.test.ts.snap b/packages/core/solidity/src/zip-foundry.test.ts.snap
index 75b1a868cc63a6e889e07b2a9fa6d4ca81024140..71d1992c913e39b96638cb88dd6e061184a47a19 100644
GIT binary patch
literal 4857
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

literal 4887
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
JL65?=003fKp}hbA

diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.md b/packages/core/solidity/src/zip-hardhat.test.ts.md
index a056da419..d504027cf 100644
--- a/packages/core/solidity/src/zip-hardhat.test.ts.md
+++ b/packages/core/solidity/src/zip-hardhat.test.ts.md
@@ -407,7 +407,6 @@ Generated by [AVA](https://avajs.dev).
       ␊
           error CallerNotL2ToL2CrossDomainMessenger();␊
           error InvalidCrossDomainSender();␊
-          error InvalidDestination();␊
       ␊
           modifier onlyCrossDomainCallback() {␊
               if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
@@ -417,7 +416,6 @@ Generated by [AVA](https://avajs.dev).
       ␊
           /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
           function callMyFunction(uint256 toChainId) public {␊
-              if (toChainId == block.chainid) revert InvalidDestination();␊
               messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments to match myFunction */)));␊
           }␊
       ␊
@@ -596,7 +594,6 @@ Generated by [AVA](https://avajs.dev).
       ␊
           error CallerNotL2ToL2CrossDomainMessenger();␊
           error InvalidCrossDomainSender();␊
-          error InvalidDestination();␊
       ␊
           modifier onlyCrossDomainCallback() {␊
               if (msg.sender != address(messenger)) revert CallerNotL2ToL2CrossDomainMessenger();␊
@@ -611,7 +608,6 @@ Generated by [AVA](https://avajs.dev).
       ␊
           /// @dev NOTE: This function is unprotected. Anyone can call this function.␊
           function callMyFunction(uint256 toChainId) public {␊
-              if (toChainId == block.chainid) revert InvalidDestination();␊
               messenger.sendMessage(toChainId, address(this), abi.encodeCall(this.myFunction, (/* TODO: Add arguments to match myFunction */)));␊
           }␊
       ␊
diff --git a/packages/core/solidity/src/zip-hardhat.test.ts.snap b/packages/core/solidity/src/zip-hardhat.test.ts.snap
index e533380e8fe147b06021d98c70eb09d1da7a29cc..d38977570524a536f308329b0b3e3513634efeff 100644
GIT binary patch
literal 3189
zcmV-*42ttXRzV<BZeeh9Xm4~Nb~6eC0PR|lnl_?+r(H!kNg+UxInhF_fH_Ic%TpAF
zicY`s^dE}|00000000B+TfJ`_#}%K`hb5n!2!>sydN~;I9&y|yPmpAgW+0lR5+eK%
z$YZ_)o1WX9yBl+N<~%b?@<gx*5+F@VSLqxCFoJYRl_E`mR4Gy#=>qsaNRcuKX7=;;
zmLDftq#T_9iQL^c?`z+@_j_+gpLg0mclYG4eoGWpKKX<Qw>bly(D$iixG#HL$)A7j
zd063}e*3HI=oZp{Dz_`Iy^j$303r0t+X(&Pb%f9zgx-Gxp|>ipy;-@rC<Go<D#>qm
z@7_g~DyrN>l{e5^m22qj%5_w^`R28m+l~X<PnLf&y+&QaB$;0I2vf8}iI{`+)mGJU
zV2KBPtZ3UOa6nZLHv5GAjP(1&rwo=jQv$n6!bkV*8GEMM7q}Z>kld#pRRj2F#(vLk
zKAf*sY0&3F!O^1Y5-H6>?jJ)(@BnI$c%QImF;~Y;xH{MnJ40)1$^F`V%5P<BsX22N
zAI0|wa|~(pZyA#hLcws`C*v?9hl(&sIg`#1k23y`eJp$Hl&OmdNSTyLc!EQDQ410t
zrTmEq=!MjeIF#}J5m!WBgtcK%;Jm?^dp6flQC~U{ZOovWJcac^OA7@m!H8+V(2I^Q
z6R$O3C{~lF#_IUO=o$Z>zD+o)0syoJipYCS=!b2ey5Mpq6=n*aEbeTtZ0&AsuC2fV
z>=D<+d(Ha~tXl3ttv-J$kM-4!Rw<9%1I@!QF{?!ADlRPSd4fm@g1EF#2~!P7Zh54G
zLtia=0cF|UJ`N=j*>ymfBBE{>>p#YHtF}G><JwvSYU`~Z)(QlX({g0d^P`k%SM#-U
zS~X{8W?%|tXJBdyJmS&-`_ih%elbhB0yDM6ePS)IJYL*cYwa#Budi+x;~PWfl&{M9
zyAj)2PMC9QBXK}PcpQ1S6Eas(&LS>WJ$YZ8`GcaUdfw`ozMNUe#$}hTC}(JVoV-ZI
z8xT^an)e?74tU7asGOYP^^upQ8N>^R#5oSMdIUP$_xS;3-Bi8=EC}#@A_Vn_j=@hu
zDu@T|0c^)b#xAJ58}>b{NUF8o{8=#OZP>?tNV2dqZ;4?)y^+YZ@;g7<>e+TKhNcYr
zMA(TUkpfz9B(U7m%;cX`Ykt7;dnR&odbv-@!3k<6$tKEY83#dBD3}B*w!Wxy^gLEQ
zRwhy+(f7C-BZx{Rfe>$3l2i*nz{2ZcwIhjG;;civkmTK7^h9Ue4((>?x%P<hfVv$X
zG7oDXI5Fk4;@ofZL!F4LCKW-ncCJLqg0Ue%9CNWn`$Xv4FbA~=fz%r2wj@eX)|GRq
z;k>VCK%Z&Ellg*}-0sbR5+P~Cw~wP=%#Y(n^?1HoC5Oh4IB&#C&Zlm=mbmGIisoHo
zI3TsT)FIOn2YsIy)oQWAHKXy2JsaKih;#+*tN2NDGr-hbQRb0D`x6=6jR<8ev7@Gl
zR5@v2uB)*DH5{rQ7a3DOf`IzQ`f4kYzQ0WRgn5Lyl;l{SP)YUT2nfdRKKl*p6%X<&
zVgmD^Y0o~eXN}I)<HV`g6Q|a**lUN>_tv==`Xr6I6GhW5qvl3n7RcJ@i_G!U1<2H&
z=(5%TE2zW5_uxqHU!Ax%mpA8No2Vqk5D6VFK=lZuC<2Ra7!al;w29C4){VkCh|$FY
z1a?B4N~|^DX|B8t7u%%BMz!U`sBp)7_$cLjJYPMoX90O5@!e<FQs0roK5<p*Hn)dq
z4nYA?JtAarFKeGgvDqeheba1aMaf?m@D_>ouQ9IH04xX09idD-lC%_$u?8OlSO9#0
zsfzWmyF?WzGVw#;C4(!l09KL5HtjMZG&p!V^PwHTxcS`bytB_>Fk8wXdOv3@ZI&*L
zUg;T2@8y=})>4D^T$1{&;4RxDeV-4kbH-Ji`y*BfZ(CnI=3?2f(qU~Su8)GrD$wh^
zXVvSr;x_p-#C{&sX#qM!_20M=7DTuYo3jx1y8?Ser{d9u_|9+28seQB2>tFRLLc2i
z=!@6KZHOy3uAm`a*;;zooZZQ6J)>Qj&bcLPh#od)oe@rjZfI5KJ?ztG<4WlZemIER
zq#-5+0h<S=Za$|iakD?lq#$Ky=gIbSipU#MU~^jIH)ONHeZzikz^Kv<C<utNoZ~p~
z$PK09!5n{<XeXybCUJ*MV~v3G?bk><HiW7@YOrXkph*tp_>!hHDaMR%Z5ou9Ao+|=
z<R$G!R`2S^CB0j&3EGXF5s?nb$Ws;E6H%X_`)-6*=(EJbsR@i6tZERYvydtC=YaFs
z4dxGwVi6QBMY!+3XoQ=R4#jUmm&8XLn%{UN{KYGagwIY-XDu3u2~B_Rvf%cEYXwZ$
zND6c*IxL_({ifp7^)=zVi$d=aq?A|_L!>9VR#*ik8t^oq&^|Qz>YV6Ei{(DCecrV`
zHryeSL_AO&-Z?7p=@PXVnPt_FKh_Ybs`1B<iH5d32nh2)^{Ae=DV^ywlQscUYZQl2
zk_c)$v19j%7##G7Aeswi9`pt86X6e_hneRSAVP2<?P~O{Y!@rHXIbWM-0@^an7i>a
z?SsDHx_aB>kg6r_X|K+n(0lx=GG6a-dYrxFT}VD!#%M%NL-fxbr<aZ610vkn+57jQ
zjU{zQA^fesl|lH&*ANP>BlOoB2z_;PTnPW~%GE%4ZRfeaUTEUvXE}sE=ZCSF`izej
zT1*O2^I={X@DD+?{4icKuxdS}`f|>3f<Y*#b40!4+{ixWZjJIdDuOvl)XvtbC6&;V
z-hc#pgE4Xt3OY1Sj`mCrg2oGD(#ceEGL?J@r;^`(6{eEK+A_}Q@gHNB|4Gq5WsFzS
zU0<-qhk{x&Lp8oE@0V12KN@PBRP1klR#xo4L<s%2g3$JLgcfd$TkL;<F0t6>ifgh8
zjwaP-Qhi>g>hmSKtm>2Ofzkq$t0d`ODHfBZEG<7Bts&{Mlgh~Q*IY(&>ReGJNi`@I
zlk=5=G1C7??mm1sPTsEIQiAp%gMdhhyBedLGXdu2XkLHgs4TDl`W8Zex{c6W6`^<T
zjGNcryLAOk-0E7h#n+lk+5^j6=aY2}n^>2Kbo&t1n~svB401EPHt_^^_Z%r)XRYa+
z!l}^hJrN{&dvY8RK5YvuD3MOKzN7`rRVg^{hX<*!BGda=P@U|jX%K`;|7JLxVpsa{
zAX#9dCwjDS+CnR5!di2;wYj_2++Et*+}_?@-dtZ?-Pm1U+1_5+`2NaPid*#136`+$
z6S2Y7DZJw?5iM9{``D*mj&NINagpMofO{swO!Ju|(~{cQ-5dJyLOWmuvTIAj1HQYE
z;A|^3yj};Phi+;dT~pp^#JI!MxJwef^HTL7FcWy1t!X=5IDzHBBaiIE#%60}4qAGy
zn0-2u`e2#hinxk+HY~CMX9Qf#z{S2FO(7F%d$`-z1nYyx@nv%O2ozt^`DE2gTmH<q
zneE!UvC&q#qA_fA18|$#gt^=!+R^5&9i$=~U^!E9KeXt1xu!>P2=t5-GGdr=>h;3e
zw5h2`v#H2ItLslTw_1xEt)iEd2&Ix~k&vMAMUQ~Q0ZEUaaRyu$fhfmHJ7K-r0j!Vj
zr60PytWBdb8x)_w6SF~_wJ9?M+iA*f0M(T%^gS?pJdqe+pSqNX5=<R2?x1X+?-3aA
zP-J$Q#H2J@GW=4NTO9g2-k350(9p{u2&Do-jfozSv>T}t>o2sBDAVXo76ndX=eyFJ
zUDfX~9%Uz1ClXap@UYtheY}keGvQv^T3KwZG$SQ(CMR{CQJhMkN)o@5IkG*_4qw?^
zG-|u?+45MDQ#b^f#qSBBH09JmA4t~U8&Ap~xd=}i^z_>$_`FNqv_;Q?N~?cBeP8=S
z?<L~Jwz6CtO-5lCY(~^8+l-u!H_U<=d-kDyZ_>U@+LxEKeGzf@a_WJx+Y4ol%AYF;
z-HyLD{r$CZ8x?XDUz=XoF|N|)p?Li1@{ci14&_V^<xCFclo!nZRIdI|P9gDM_<+si
zP|b53s@Z*Ehibk#$YQMcdfrLty-}?398=S~@05WNb{nC;ypGWC?;!NYZ;cB^zH=4-
zo%<@LrZ4;)`{j&fFM_NlbJ|yVPJ4;}ePA*dp3H?ObK(ELx$vZe{#rZee@;5+7ui9-
bR72`X&pqk6Cq4IN^xXdgE^N_~B254Qe5gS@

literal 3218
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
E0IiEkJpcdz


From 1369d1575998a1c46986a3594b972f13807a6d16 Mon Sep 17 00:00:00 2001
From: Eric Lau <ericglau@outlook.com>
Date: Fri, 8 Aug 2025 14:09:04 -0400
Subject: [PATCH 54/54] Inject Optimism links for imports

---
 packages/ui/src/solidity/inject-hyperlinks.ts | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/packages/ui/src/solidity/inject-hyperlinks.ts b/packages/ui/src/solidity/inject-hyperlinks.ts
index 906b4a6ea..b2664f580 100644
--- a/packages/ui/src/solidity/inject-hyperlinks.ts
+++ b/packages/ui/src/solidity/inject-hyperlinks.ts
@@ -1,10 +1,12 @@
 import { version as contractsVersion } from '@openzeppelin/contracts/package.json';
+import { version as optimismContractsVersion } from '@eth-optimism/contracts-bedrock/package.json';
 
 export function injectHyperlinks(code: string) {
   // We are modifying HTML, so use HTML escaped chars. The pattern excludes paths that include /../ in the URL.
   const contractsRegex =
     /&quot;(@openzeppelin\/)(contracts-upgradeable\/|contracts\/)((?:(?!\.\.)[^/]+\/)*?[^/]*?)&quot;/g;
   const communityContractsRegex = /&quot;(@openzeppelin\/)(community-contracts\/)((?:(?!\.\.)[^/]+\/)*?[^/]*?)&quot;/g;
+  const optimismContractsRegex = /&quot;(@eth-optimism\/)(contracts-bedrock\/)((?:(?!\.\.)[^/]+\/)*?[^/]*?)&quot;/g;
 
   return code
     .replace(
@@ -14,5 +16,9 @@ export function injectHyperlinks(code: string) {
     .replace(
       communityContractsRegex,
       `&quot;<a class="import-link" href="https://github.com/OpenZeppelin/openzeppelin-community-contracts/blob/master/contracts/$3" target="_blank" rel="noopener noreferrer">$1$2$3</a>&quot;`,
+    )
+    .replace(
+      optimismContractsRegex,
+      `&quot;<a class="import-link" href="https://github.com/ethereum-optimism/optimism/blob/%40eth-optimism/contracts-bedrock%40${optimismContractsVersion}/packages/contracts-bedrock/$3" target="_blank" rel="noopener noreferrer">$1$2$3</a>&quot;`,
     );
 }