From 574b947dfcfcb5fa05b46d8961ece29e06b14129 Mon Sep 17 00:00:00 2001
From: Alex Kroeger <alex.kroeger@circle.com>
Date: Mon, 28 Oct 2024 13:54:28 -0700
Subject: [PATCH] add a GitHub workflow for automated bytecode verification,
 update bridged USDC standard documentation, update the entity name in
 copyright headers

---
 .env.example                                  |   2 +-
 .eslintrc.js                                  |   2 +-
 .github/composite-actions/setup-ci/action.yml |   8 +-
 .github/resources/coverage-report-template.md |   2 +-
 .github/workflows/bytecode-verification.yml   |  37 +
 .github/workflows/check-pr.yml                |  50 ++
 .github/workflows/ci.yml                      |  33 +-
 .github/workflows/coverage.yml                |   2 +-
 .licenseignore                                |   7 +
 .nvmrc                                        |   2 +-
 .solcover.js                                  |   2 +-
 .vscode/settings.json                         |   2 +-
 @types/AnyFiatTokenV2Instance.d.ts            |   2 +-
 @types/TransactionRawLog.d.ts                 |   2 +-
 @types/ipfs-only-hash.d.ts                    |  19 +
 README.md                                     |   4 +-
 ...FiatTokenProxyContractCreationBytecode.bin |   1 +
 ...opMainnetFiatTokenProxyRuntimeBytecode.bin |   1 +
 contracts/interface/IERC1271.sol              |   2 +-
 contracts/interface/celo/ICeloGasToken.sol    |   2 +-
 contracts/interface/celo/IDecimals.sol        |   2 +-
 .../interface/celo/IFiatTokenFeeAdapter.sol   |   2 +-
 contracts/minting/Controller.sol              |   2 +-
 contracts/minting/MasterMinter.sol            |   2 +-
 contracts/minting/MintController.sol          |   2 +-
 .../minting/MinterManagementInterface.sol     |   2 +-
 .../test/ContractThatCallsPublicFunctions.sol |   2 +-
 contracts/test/ContractThatReverts.sol        |   2 +-
 .../test/ContractWithExternalFunctions.sol    |   2 +-
 .../test/ContractWithPublicFunctions.sol      |   2 +-
 contracts/test/DummyERC20.sol                 |   2 +-
 contracts/test/ECRecoverTest.sol              |   2 +-
 contracts/test/EIP712Test.sol                 |   2 +-
 contracts/test/MessageHashUtilsTest.sol       |   2 +-
 contracts/test/MockERC1271Wallet.sol          |   2 +-
 ...nWithEditableBalanceAndBlacklistStates.sol |   2 +-
 .../test/MockFiatTokenWithEditableChainId.sol |   2 +-
 ...UpgradedFiatTokenNewFieldsNewLogicTest.sol |   2 +-
 .../test/UpgradedFiatTokenNewFieldsTest.sol   |   2 +-
 .../UpgradedFiatTokenV2_2NewFieldsTest.sol    |   2 +-
 .../MockFiatTokenCeloWithExposedFunctions.sol |   2 +-
 ...iatTokenFeeAdapterWithExposedFunctions.sol |   2 +-
 .../AdminUpgradeabilityProxy.sol              |   2 +-
 contracts/upgradeability/Proxy.sol            |   2 +-
 .../upgradeability/UpgradeabilityProxy.sol    |   2 +-
 contracts/util/ECRecover.sol                  |   2 +-
 contracts/util/EIP712.sol                     |   2 +-
 contracts/util/MessageHashUtils.sol           |   2 +-
 contracts/util/SignatureChecker.sol           |   2 +-
 contracts/v1.1/FiatTokenV1_1.sol              |   2 +-
 contracts/v1.1/Rescuable.sol                  |   2 +-
 contracts/v1/AbstractFiatTokenV1.sol          |   2 +-
 contracts/v1/Blacklistable.sol                |   2 +-
 contracts/v1/FiatTokenProxy.sol               |   2 +-
 contracts/v1/FiatTokenV1.sol                  |   2 +-
 contracts/v2/AbstractFiatTokenV2.sol          |   2 +-
 contracts/v2/EIP2612.sol                      |   2 +-
 contracts/v2/EIP3009.sol                      |   2 +-
 contracts/v2/EIP712Domain.sol                 |   2 +-
 contracts/v2/FiatTokenUtil.sol                |   2 +-
 contracts/v2/FiatTokenV2.sol                  |   2 +-
 contracts/v2/FiatTokenV2_1.sol                |   2 +-
 contracts/v2/FiatTokenV2_2.sol                |   2 +-
 contracts/v2/celo/FiatTokenCeloV2_2.sol       |   2 +-
 .../v2/celo/FiatTokenFeeAdapterProxy.sol      |   2 +-
 contracts/v2/celo/FiatTokenFeeAdapterV1.sol   |   2 +-
 contracts/v2/upgrader/AbstractV2Upgrader.sol  |   2 +-
 contracts/v2/upgrader/V2Upgrader.sol          |   2 +-
 contracts/v2/upgrader/V2_1Upgrader.sol        |   2 +-
 contracts/v2/upgrader/V2_2Upgrader.sol        |   2 +-
 .../helpers/AbstractUpgraderHelper.sol        |   2 +-
 .../v2/upgrader/helpers/V2UpgraderHelper.sol  |   2 +-
 .../upgrader/helpers/V2_2UpgraderHelper.sol   |   2 +-
 doc/bridged_USDC_standard.md                  |  49 +-
 doc/bridged_asset_automated_verification.md   | 106 +++
 doc/deployment.md                             |   8 +-
 doc/metadata_extraction.md                    |  35 +
 flatten-generated-types.sh                    |   2 +-
 foundry.toml                                  |   2 +-
 hardhat.config.ts                             |   4 +-
 package.json                                  |  83 +-
 scripts/deploy/DeployImpl.sol                 |   2 +-
 scripts/deploy/ScriptUtils.sol                |   2 +-
 scripts/deploy/celo/deploy-fee-adapter.s.sol  |   2 +-
 .../deploy/celo/deploy-fiat-token-celo.s.sol  |   2 +-
 scripts/deploy/deploy-fiat-token.s.sol        |   2 +-
 scripts/deploy/deploy-impl-and-upgrader.s.sol |   2 +-
 scripts/deploy/deploy-master-minter.s.sol     |   2 +-
 scripts/git/diff-check.sh                     |   2 +-
 scripts/git/rebase.sh                         |   2 +-
 scripts/hardhat/alternativeArtifacts.ts       |  59 ++
 .../hardhat/downloadBlacklistedAccounts.ts    |   2 +-
 scripts/hardhat/getContractCreationBlock.ts   |   2 +-
 scripts/hardhat/hardhatArgumentTypes.ts       |   2 +-
 scripts/hardhat/helpers.ts                    |  24 +-
 scripts/hardhat/readValuesFromContract.ts     |   2 +-
 .../hardhat/validateAccountsToBlacklist.ts    |   2 +-
 scripts/hardhat/verifyBytecodeOnChain.ts      | 180 ----
 scripts/hardhat/verifyOnChainBytecode.ts      | 541 ++++++++++++
 scripts/verifyBridgedTokenBytecode.ts         | 244 ++++++
 setup.sh                                      |   2 +-
 test/helpers/constants.ts                     |   2 +-
 test/helpers/index.ts                         |   2 +-
 test/helpers/storageSlots.behavior.ts         |   2 +-
 test/minting/AccountUtils.js                  |   2 +-
 test/minting/ControllerTestUtils.js           |  10 +-
 test/minting/MintControllerTests.js           |  15 +-
 test/minting/MintControllerUtils.js           |   9 +-
 test/minting/MintP0_ArgumentTests.js          |  15 +-
 test/minting/MintP0_BasicTests.js             |  19 +-
 test/minting/MintP0_EndToEndTests.js          |  19 +-
 test/minting/MintP0_EventsTests.js            |   2 +-
 test/misc/gas.ts                              |   2 +-
 test/misc/publicToExternal.test.ts            |   2 +-
 test/scripts/deploy/TestUtils.sol             |   2 +-
 .../deploy/celo/deploy-fee-adapter.t.sol      |   2 +-
 .../deploy/celo/deploy-fiat-token-celo.t.sol  |   2 +-
 test/scripts/deploy/deploy-fiat-token.t.sol   |   2 +-
 .../deploy/deploy-impl-and-upgrader.t.sol     |   2 +-
 .../scripts/deploy/deploy-master-minter.t.sol |   2 +-
 .../hardhat/testData/FiatTokenProxy.bin       |   1 +
 .../testData/FiatTokenProxy.metadata.json     | 231 ++++++
 .../testData/V2_2UpgraderDeploymentTrace.json |  22 +
 .../V2_2UpgraderHelperCreationBytecode.bin    |   1 +
 .../hardhat/verifyOnChainBytecode.test.ts     | 314 +++++++
 test/util/ECRecover.test.ts                   |   2 +-
 test/util/EIP712Test.ts                       |   2 +-
 test/util/MessageHashUtils.test.ts            |   2 +-
 test/util/SignatureChecker.test.ts            |   2 +-
 test/v1.1/FiatTokenV1_1.test.ts               |   2 +-
 test/v1.1/Rescuable.behavior.ts               |   2 +-
 test/v1.1/Rescuable.test.ts                   |   2 +-
 test/v1/FiatTokenV1.test.ts                   |   2 +-
 test/v1/Pausable.test.js                      |   2 +-
 test/v1/TokenTestUtils.js                     | 714 ----------------
 test/v1/abiHacking.test.js                    |   2 +-
 test/v1/events.test.js                        |   2 +-
 test/v1/extendedPositive.test.js              |   2 +-
 test/v1/helpers/abi.js                        |   2 +-
 test/v1/helpers/tokenTest.js                  |  72 +-
 test/v1/helpers/wrapTests.js                  |   2 +-
 test/v1/legacy.test.js                        |   2 +-
 test/v1/misc.test.js                          |   2 +-
 test/v1/negative.test.js                      |   2 +-
 test/v1/positive.test.js                      |   2 +-
 test/v1/proxyNegative.test.js                 |   2 +-
 test/v1/proxyPositive.test.js                 |   2 +-
 test/v2/FiatTokenV2.test.ts                   |   2 +-
 test/v2/FiatTokenV2_1.test.ts                 |   2 +-
 test/v2/FiatTokenV2_2.test.ts                 |   2 +-
 .../GasAbstraction/GasAbstraction.behavior.ts |   2 +-
 test/v2/GasAbstraction/helpers.ts             |   2 +-
 .../GasAbstraction/testCancelAuthorization.ts |   2 +-
 test/v2/GasAbstraction/testPermit.ts          |   2 +-
 .../testReceiveWithAuthorization.ts           |   2 +-
 .../testTransferWithAuthorization.ts          |   2 +-
 .../testTransferWithMultipleAuthorizations.ts |   2 +-
 ...hEditableBalanceAndBlacklistStates.test.ts |   2 +-
 .../MockFiatTokenWithEditableChainId.test.ts  |   2 +-
 test/v2/V2Upgrader.test.ts                    |   2 +-
 test/v2/V2_1Upgrader.test.ts                  |   2 +-
 test/v2/V2_2Upgrader.test.ts                  |   2 +-
 test/v2/celo/FiatTokenCeloV2_2.test.ts        |   2 +-
 test/v2/celo/FiatTokenFeeAdapterV1.test.ts    |   2 +-
 ...kFiatTokenCeloWithExposedFunctions.test.ts |   2 +-
 ...okenFeeAdapterWithExposedFunctions.test.ts |   2 +-
 test/v2/safeAllowance.behavior.ts             |   2 +-
 test/v2/v2.behavior.ts                        |   2 +-
 test/v2/v2_2.behavior.ts                      |   2 +-
 utils.js                                      |   2 +-
 verification_artifacts/input.template.json    |  15 +
 yarn.lock                                     | 771 ++++++++++++++++--
 172 files changed, 2747 insertions(+), 1248 deletions(-)
 create mode 100644 .github/workflows/bytecode-verification.yml
 create mode 100644 .github/workflows/check-pr.yml
 create mode 100644 @types/ipfs-only-hash.d.ts
 create mode 100644 cached_artifacts/opMainnetFiatTokenProxyContractCreationBytecode.bin
 create mode 100644 cached_artifacts/opMainnetFiatTokenProxyRuntimeBytecode.bin
 create mode 100644 doc/bridged_asset_automated_verification.md
 create mode 100644 doc/metadata_extraction.md
 create mode 100644 scripts/hardhat/alternativeArtifacts.ts
 delete mode 100644 scripts/hardhat/verifyBytecodeOnChain.ts
 create mode 100644 scripts/hardhat/verifyOnChainBytecode.ts
 create mode 100644 scripts/verifyBridgedTokenBytecode.ts
 create mode 100644 test/scripts/hardhat/testData/FiatTokenProxy.bin
 create mode 100644 test/scripts/hardhat/testData/FiatTokenProxy.metadata.json
 create mode 100644 test/scripts/hardhat/testData/V2_2UpgraderDeploymentTrace.json
 create mode 100644 test/scripts/hardhat/testData/V2_2UpgraderHelperCreationBytecode.bin
 create mode 100644 test/scripts/hardhat/verifyOnChainBytecode.test.ts
 delete mode 100644 test/v1/TokenTestUtils.js
 create mode 100644 verification_artifacts/input.template.json

diff --git a/.env.example b/.env.example
index 267469422..de753c1b6 100644
--- a/.env.example
+++ b/.env.example
@@ -1,4 +1,4 @@
-# Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+# Copyright 2024 Circle Internet Group, Inc. All rights reserved.
 #
 # SPDX-License-Identifier: Apache-2.0
 #
diff --git a/.eslintrc.js b/.eslintrc.js
index c0f2eb1ed..6580bb89e 100644
--- a/.eslintrc.js
+++ b/.eslintrc.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/.github/composite-actions/setup-ci/action.yml b/.github/composite-actions/setup-ci/action.yml
index f07d4cda0..1a55f4a67 100644
--- a/.github/composite-actions/setup-ci/action.yml
+++ b/.github/composite-actions/setup-ci/action.yml
@@ -1,4 +1,4 @@
-# Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+# Copyright 2024 Circle Internet Group, Inc. All rights reserved.
 #
 # SPDX-License-Identifier: Apache-2.0
 #
@@ -19,9 +19,9 @@ runs:
   using: composite
   steps:
     - name: Install Node
-      uses: actions/setup-node@v3
+      uses: actions/setup-node@v4
       with:
-        node-version: "16.14.0"
+        node-version: "20.9.0"
 
     - name: Install Foundry
       uses: foundry-rs/foundry-toolchain@v1
@@ -40,7 +40,7 @@ runs:
       shell: bash
 
     - name: Retrieve cache
-      uses: actions/cache@v3
+      uses: actions/cache@v4
       with:
         path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
         key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
diff --git a/.github/resources/coverage-report-template.md b/.github/resources/coverage-report-template.md
index 9a0c5ddc0..e01f08e4e 100644
--- a/.github/resources/coverage-report-template.md
+++ b/.github/resources/coverage-report-template.md
@@ -1,5 +1,5 @@
 <!--
- Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ Copyright 2024 Circle Internet Group, Inc. All rights reserved.
 
  SPDX-License-Identifier: Apache-2.0
 
diff --git a/.github/workflows/bytecode-verification.yml b/.github/workflows/bytecode-verification.yml
new file mode 100644
index 000000000..57ae74687
--- /dev/null
+++ b/.github/workflows/bytecode-verification.yml
@@ -0,0 +1,37 @@
+# Copyright 2024 Circle Internet Group, Inc. All rights reserved.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Bridged USDC deployment - Bytecode Verification
+on:
+  pull_request:
+    paths:
+      - "**/verification_artifacts/input.json"
+
+jobs:
+  bytecode-verification:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository code
+        uses: actions/checkout@v4
+
+      - name: Setup CI Environment
+        uses: ./.github/composite-actions/setup-ci
+
+      - name: Compile contracts
+        run: yarn compile
+
+      - name: Run Verification
+        run: yarn hardhat run scripts/verifyBridgedTokenBytecode.ts --network mainnet
diff --git a/.github/workflows/check-pr.yml b/.github/workflows/check-pr.yml
new file mode 100644
index 000000000..b9e3dc294
--- /dev/null
+++ b/.github/workflows/check-pr.yml
@@ -0,0 +1,50 @@
+# Copyright 2024 Circle Internet Group, Inc. All rights reserved.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+name: Check PR
+on:
+  workflow_run:
+    workflows: [CI]
+    types: [completed]
+
+permissions:
+  checks: write
+  contents: write
+  actions: read
+
+jobs:
+  post_run_hardhat_tests:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Download test results
+        uses: actions/download-artifact@v4
+        with:
+          pattern: junit-report-*
+          run-id: ${{ github.event.workflow_run.id }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish combined test report
+        uses: mikepenz/action-junit-report@v4
+        with:
+          check_name: upload_test_results
+          job_summary: true
+          detailed_summary: true
+          commit: ${{ github.event.workflow_run.head_sha }}
+          report_paths: "./junit-report-*/junit.xml"
+
+  release-sbom:
+    if: github.event.workflow_run.event == 'push'
+    uses: circlefin/circle-public-github-workflows/.github/workflows/attach-release-assets.yaml@v1
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 811e5e659..a38929d29 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -1,4 +1,4 @@
-# Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+# Copyright 2024 Circle Internet Group, Inc. All rights reserved.
 #
 # SPDX-License-Identifier: Apache-2.0
 #
@@ -20,6 +20,8 @@ on:
     branches: [master]
   pull_request:
 
+permissions: read-all
+
 # Celo USDC contracts violate Spurious Dragon with existing configs, so
 # we need to lower the number of runs to decrease the contract size.
 env:
@@ -72,6 +74,9 @@ jobs:
       - name: Setup CI Environment
         uses: ./.github/composite-actions/setup-ci
 
+      - name: Compile contracts
+        run: yarn compile
+
       - name: Run hardhat tests
         run: HARDHAT_TEST_GREP='${{ matrix.test-groups.grep }}' HARDHAT_TEST_INVERT='${{ matrix.test-groups.invert }}' yarn test
 
@@ -82,30 +87,12 @@ jobs:
           name: junit-report-${{ hashFiles('report/junit.xml') }}
           path: report/junit.xml
 
-  post_run_hardhat_tests:
-    runs-on: ubuntu-latest
-    needs: [run_hardhat_tests]
-    if: always()
-    steps:
-      - name: Download test results
-        uses: actions/download-artifact@v4
-        with:
-          pattern: junit-report-*
-
-      - name: Publish combined test report
-        uses: mikepenz/action-junit-report@v4
-        with:
-          check_name: upload_test_results
-          job_summary: true
-          detailed_summary: true
-          report_paths: "./junit-report-*/junit.xml"
-
   scan:
     if: github.event_name == 'pull_request'
-    uses: circlefin/circle-public-github-workflows/.github/workflows/pr-scan.yaml@v1.2.0
+    uses: circlefin/circle-public-github-workflows/.github/workflows/pr-scan.yaml@v1
+    permissions:
+      pull-requests: write
+      contents: read
     with:
       allow-reciprocal-licenses: false
 
-  release-sbom:
-    if: github.event_name == 'push'
-    uses: circlefin/circle-public-github-workflows/.github/workflows/attach-release-assets.yaml@v1
diff --git a/.github/workflows/coverage.yml b/.github/workflows/coverage.yml
index 7f2f9c761..0601549db 100644
--- a/.github/workflows/coverage.yml
+++ b/.github/workflows/coverage.yml
@@ -1,4 +1,4 @@
-# Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+# Copyright 2024 Circle Internet Group, Inc. All rights reserved.
 #
 # SPDX-License-Identifier: Apache-2.0
 #
diff --git a/.licenseignore b/.licenseignore
index 342eb3d7e..a042cc07b 100644
--- a/.licenseignore
+++ b/.licenseignore
@@ -1,7 +1,11 @@
 pkg:npm/pako
 pkg:npm/highlightjs-solidity
 pkg:npm/ethereum-ens
+pkg:npm/interface-ipld-format
+pkg:npm/multiformats
 pkg:npm/%40ethereumjs/rlp@4.0.1
+pkg:npm/%40ethereumjs/tx@3.3.2
+pkg:npm/%40ethereumjs/util@7.1.5
 pkg:npm/%40ethereumjs/util@8.1.0
 pkg:npm/%40nomicfoundation/ethereumjs-block@5.0.2
 pkg:npm/%40nomicfoundation/ethereumjs-blockchain@7.0.2
@@ -13,6 +17,9 @@ pkg:npm/%40nomicfoundation/ethereumjs-trie@6.0.2
 pkg:npm/%40nomicfoundation/ethereumjs-tx@5.0.2
 pkg:npm/%40nomicfoundation/ethereumjs-util@9.0.2
 pkg:npm/%40nomicfoundation/ethereumjs-vm@7.0.2
+pkg:npm/ghost-testrpc@0.0.2
+pkg:npm/sha.js@2.4.11
+pkg:npm/sprintf-js@1.0.3
 pkg:npm/web3@1.10.1
 pkg:npm/web3-bzz@1.10.1
 pkg:npm/web3-core@1.10.1
diff --git a/.nvmrc b/.nvmrc
index bf79505bb..805b5a4e0 100644
--- a/.nvmrc
+++ b/.nvmrc
@@ -1 +1 @@
-v16.14.0
+v20.9.0
diff --git a/.solcover.js b/.solcover.js
index ab6fb6eda..278739156 100644
--- a/.solcover.js
+++ b/.solcover.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/.vscode/settings.json b/.vscode/settings.json
index 72c0bf191..d6834c1d9 100644
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -25,7 +25,7 @@
   },
   "typescript.tsdk": "node_modules/typescript/lib",
   "licenser.license": "Custom",
-  "licenser.customHeader": "Copyright @YEAR@ Circle Internet Financial, LTD. All rights reserved.\n\nSPDX-License-Identifier: Apache-2.0\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.",
+  "licenser.customHeader": "Copyright @YEAR@ Circle Internet Group, Inc. All rights reserved.\n\nSPDX-License-Identifier: Apache-2.0\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.",
   "licenser.useSingleLineStyle": false,
   "files.autoSave": "onFocusChange",
   "solidity.compileUsingRemoteVersion": "v0.6.12+commit.27d51765"
diff --git a/@types/AnyFiatTokenV2Instance.d.ts b/@types/AnyFiatTokenV2Instance.d.ts
index a1457e2b7..e22dfc000 100644
--- a/@types/AnyFiatTokenV2Instance.d.ts
+++ b/@types/AnyFiatTokenV2Instance.d.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/@types/TransactionRawLog.d.ts b/@types/TransactionRawLog.d.ts
index 891613bca..8e8a2e389 100644
--- a/@types/TransactionRawLog.d.ts
+++ b/@types/TransactionRawLog.d.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/@types/ipfs-only-hash.d.ts b/@types/ipfs-only-hash.d.ts
new file mode 100644
index 000000000..46ccdcab1
--- /dev/null
+++ b/@types/ipfs-only-hash.d.ts
@@ -0,0 +1,19 @@
+/**
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+declare module "ipfs-only-hash";
diff --git a/README.md b/README.md
index edc015547..385dfebec 100644
--- a/README.md
+++ b/README.md
@@ -37,13 +37,11 @@ by the [Hardhat](https://hardhat.org/) framework.
 
 Requirements:
 
-- Node 16.14.0
+- Node 20.9.0
 - Yarn 1.22.19
 - [Foundry@f625d0f](https://github.com/foundry-rs/foundry/releases/tag/nightly-f625d0fa7c51e65b4bf1e8f7931cd1c6e2e285e9)
 
 ```sh
-$ git clone git@github.com:circlefin/stablecoin-evm.git
-$ cd stablecoin-evm
 $ nvm use
 $ npm i -g yarn@1.22.19 # Install yarn if you don't already have it
 $ yarn install          # Install npm packages and other dependencies listed in setup.sh
diff --git a/cached_artifacts/opMainnetFiatTokenProxyContractCreationBytecode.bin b/cached_artifacts/opMainnetFiatTokenProxyContractCreationBytecode.bin
new file mode 100644
index 000000000..65beae8be
--- /dev/null
+++ b/cached_artifacts/opMainnetFiatTokenProxyContractCreationBytecode.bin
@@ -0,0 +1 @@
+608060405234801561001057600080fd5b506040516108a93803806108a98339818101604052602081101561003357600080fd5b5051808061004081610051565b5061004a336100c3565b5050610123565b610064816100e760201b61042a1760201c565b61009f5760405162461bcd60e51b815260040180806020018281038252603b81526020018061086e603b913960400191505060405180910390fd5b7f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c355565b7f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b55565b6000813f7fc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a47081811480159061011b57508115155b949350505050565b61073c806101326000396000f3fe60806040526004361061005a5760003560e01c80635c60da1b116100435780635c60da1b146101315780638f2839701461016f578063f851a440146101af5761005a565b80633659cfe6146100645780634f1ef286146100a4575b6100626101c4565b005b34801561007057600080fd5b506100626004803603602081101561008757600080fd5b503573ffffffffffffffffffffffffffffffffffffffff166101de565b610062600480360360408110156100ba57600080fd5b73ffffffffffffffffffffffffffffffffffffffff82351691908101906040810160208201356401000000008111156100f257600080fd5b82018360208201111561010457600080fd5b8035906020019184600183028401116401000000008311171561012657600080fd5b509092509050610232565b34801561013d57600080fd5b50610146610309565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b34801561017b57600080fd5b506100626004803603602081101561019257600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610318565b3480156101bb57600080fd5b50610146610420565b6101cc610466565b6101dc6101d76104fa565b61051f565b565b6101e6610543565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102275761022281610568565b61022f565b61022f6101c4565b50565b61023a610543565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102fc5761027683610568565b60003073ffffffffffffffffffffffffffffffffffffffff16348484604051808383808284376040519201945060009350909150508083038185875af1925050503d80600081146102e3576040519150601f19603f3d011682016040523d82523d6000602084013e6102e8565b606091505b50509050806102f657600080fd5b50610304565b6103046101c4565b505050565b60006103136104fa565b905090565b610320610543565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102275773ffffffffffffffffffffffffffffffffffffffff81166103bf576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260368152602001806106966036913960400191505060405180910390fd5b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f6103e8610543565b6040805173ffffffffffffffffffffffffffffffffffffffff928316815291841660208301528051918290030190a1610222816105bd565b6000610313610543565b6000813f7fc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a47081811480159061045e57508115155b949350505050565b61046e610543565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156104f2576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260328152602001806106646032913960400191505060405180910390fd5b6101dc6101dc565b7f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c35490565b3660008037600080366000845af43d6000803e80801561053e573d6000f35b3d6000fd5b7f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b5490565b610571816105e1565b6040805173ffffffffffffffffffffffffffffffffffffffff8316815290517fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b9181900360200190a150565b7f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b55565b6105ea8161042a565b61063f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252603b8152602001806106cc603b913960400191505060405180910390fd5b7f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c35556fe43616e6e6f742063616c6c2066616c6c6261636b2066756e6374696f6e2066726f6d207468652070726f78792061646d696e43616e6e6f74206368616e6765207468652061646d696e206f6620612070726f787920746f20746865207a65726f206164647265737343616e6e6f742073657420612070726f787920696d706c656d656e746174696f6e20746f2061206e6f6e2d636f6e74726163742061646472657373a2646970667358221220046bec85a39556fa01d3014f9bbd881bf3dfd8a920836836698508b80c55e88964736f6c634300060c003343616e6e6f742073657420612070726f787920696d706c656d656e746174696f6e20746f2061206e6f6e2d636f6e74726163742061646472657373000000000000000000000000bd17deee53a58b48548117a11a2e7bbf2d0d6fa7
\ No newline at end of file
diff --git a/cached_artifacts/opMainnetFiatTokenProxyRuntimeBytecode.bin b/cached_artifacts/opMainnetFiatTokenProxyRuntimeBytecode.bin
new file mode 100644
index 000000000..10780a6e7
--- /dev/null
+++ b/cached_artifacts/opMainnetFiatTokenProxyRuntimeBytecode.bin
@@ -0,0 +1 @@
+60806040526004361061005a5760003560e01c80635c60da1b116100435780635c60da1b146101315780638f2839701461016f578063f851a440146101af5761005a565b80633659cfe6146100645780634f1ef286146100a4575b6100626101c4565b005b34801561007057600080fd5b506100626004803603602081101561008757600080fd5b503573ffffffffffffffffffffffffffffffffffffffff166101de565b610062600480360360408110156100ba57600080fd5b73ffffffffffffffffffffffffffffffffffffffff82351691908101906040810160208201356401000000008111156100f257600080fd5b82018360208201111561010457600080fd5b8035906020019184600183028401116401000000008311171561012657600080fd5b509092509050610232565b34801561013d57600080fd5b50610146610309565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b34801561017b57600080fd5b506100626004803603602081101561019257600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610318565b3480156101bb57600080fd5b50610146610420565b6101cc610466565b6101dc6101d76104fa565b61051f565b565b6101e6610543565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102275761022281610568565b61022f565b61022f6101c4565b50565b61023a610543565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102fc5761027683610568565b60003073ffffffffffffffffffffffffffffffffffffffff16348484604051808383808284376040519201945060009350909150508083038185875af1925050503d80600081146102e3576040519150601f19603f3d011682016040523d82523d6000602084013e6102e8565b606091505b50509050806102f657600080fd5b50610304565b6103046101c4565b505050565b60006103136104fa565b905090565b610320610543565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102275773ffffffffffffffffffffffffffffffffffffffff81166103bf576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260368152602001806106966036913960400191505060405180910390fd5b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f6103e8610543565b6040805173ffffffffffffffffffffffffffffffffffffffff928316815291841660208301528051918290030190a1610222816105bd565b6000610313610543565b6000813f7fc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a47081811480159061045e57508115155b949350505050565b61046e610543565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156104f2576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260328152602001806106646032913960400191505060405180910390fd5b6101dc6101dc565b7f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c35490565b3660008037600080366000845af43d6000803e80801561053e573d6000f35b3d6000fd5b7f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b5490565b610571816105e1565b6040805173ffffffffffffffffffffffffffffffffffffffff8316815290517fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b9181900360200190a150565b7f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b55565b6105ea8161042a565b61063f576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252603b8152602001806106cc603b913960400191505060405180910390fd5b7f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c35556fe43616e6e6f742063616c6c2066616c6c6261636b2066756e6374696f6e2066726f6d207468652070726f78792061646d696e43616e6e6f74206368616e6765207468652061646d696e206f6620612070726f787920746f20746865207a65726f206164647265737343616e6e6f742073657420612070726f787920696d706c656d656e746174696f6e20746f2061206e6f6e2d636f6e74726163742061646472657373a2646970667358221220046bec85a39556fa01d3014f9bbd881bf3dfd8a920836836698508b80c55e88964736f6c634300060c0033
\ No newline at end of file
diff --git a/contracts/interface/IERC1271.sol b/contracts/interface/IERC1271.sol
index 80c410de5..b8ca9841c 100644
--- a/contracts/interface/IERC1271.sol
+++ b/contracts/interface/IERC1271.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/interface/celo/ICeloGasToken.sol b/contracts/interface/celo/ICeloGasToken.sol
index a9906caa8..072e30358 100644
--- a/contracts/interface/celo/ICeloGasToken.sol
+++ b/contracts/interface/celo/ICeloGasToken.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/interface/celo/IDecimals.sol b/contracts/interface/celo/IDecimals.sol
index 68954b616..a1f031894 100644
--- a/contracts/interface/celo/IDecimals.sol
+++ b/contracts/interface/celo/IDecimals.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/interface/celo/IFiatTokenFeeAdapter.sol b/contracts/interface/celo/IFiatTokenFeeAdapter.sol
index 7a1f5f996..77676c1bb 100644
--- a/contracts/interface/celo/IFiatTokenFeeAdapter.sol
+++ b/contracts/interface/celo/IFiatTokenFeeAdapter.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/minting/Controller.sol b/contracts/minting/Controller.sol
index fa063428d..12c36f3c1 100644
--- a/contracts/minting/Controller.sol
+++ b/contracts/minting/Controller.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/minting/MasterMinter.sol b/contracts/minting/MasterMinter.sol
index 2e8d896f0..f75064107 100644
--- a/contracts/minting/MasterMinter.sol
+++ b/contracts/minting/MasterMinter.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/minting/MintController.sol b/contracts/minting/MintController.sol
index 69151b63f..2f2c6b5c6 100644
--- a/contracts/minting/MintController.sol
+++ b/contracts/minting/MintController.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/minting/MinterManagementInterface.sol b/contracts/minting/MinterManagementInterface.sol
index 397ec8c14..1b8eddfbd 100644
--- a/contracts/minting/MinterManagementInterface.sol
+++ b/contracts/minting/MinterManagementInterface.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/ContractThatCallsPublicFunctions.sol b/contracts/test/ContractThatCallsPublicFunctions.sol
index 9fb681a95..7ded0cd9a 100644
--- a/contracts/test/ContractThatCallsPublicFunctions.sol
+++ b/contracts/test/ContractThatCallsPublicFunctions.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/ContractThatReverts.sol b/contracts/test/ContractThatReverts.sol
index 46d92d54a..bed257b09 100644
--- a/contracts/test/ContractThatReverts.sol
+++ b/contracts/test/ContractThatReverts.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/ContractWithExternalFunctions.sol b/contracts/test/ContractWithExternalFunctions.sol
index 12e0a799d..8c5f64ade 100644
--- a/contracts/test/ContractWithExternalFunctions.sol
+++ b/contracts/test/ContractWithExternalFunctions.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/ContractWithPublicFunctions.sol b/contracts/test/ContractWithPublicFunctions.sol
index 2293638f3..f4e29e2e4 100644
--- a/contracts/test/ContractWithPublicFunctions.sol
+++ b/contracts/test/ContractWithPublicFunctions.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/DummyERC20.sol b/contracts/test/DummyERC20.sol
index 9c86fb527..306ecc30e 100644
--- a/contracts/test/DummyERC20.sol
+++ b/contracts/test/DummyERC20.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/ECRecoverTest.sol b/contracts/test/ECRecoverTest.sol
index 086d0e221..d3f81c15b 100644
--- a/contracts/test/ECRecoverTest.sol
+++ b/contracts/test/ECRecoverTest.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/EIP712Test.sol b/contracts/test/EIP712Test.sol
index 95a6e9c31..cd80cb828 100644
--- a/contracts/test/EIP712Test.sol
+++ b/contracts/test/EIP712Test.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/MessageHashUtilsTest.sol b/contracts/test/MessageHashUtilsTest.sol
index 076540ec4..890a9f294 100644
--- a/contracts/test/MessageHashUtilsTest.sol
+++ b/contracts/test/MessageHashUtilsTest.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/MockERC1271Wallet.sol b/contracts/test/MockERC1271Wallet.sol
index 06e6a834b..b22497548 100644
--- a/contracts/test/MockERC1271Wallet.sol
+++ b/contracts/test/MockERC1271Wallet.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/MockFiatTokenWithEditableBalanceAndBlacklistStates.sol b/contracts/test/MockFiatTokenWithEditableBalanceAndBlacklistStates.sol
index 62ccb5a71..9d7f9d30b 100644
--- a/contracts/test/MockFiatTokenWithEditableBalanceAndBlacklistStates.sol
+++ b/contracts/test/MockFiatTokenWithEditableBalanceAndBlacklistStates.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/MockFiatTokenWithEditableChainId.sol b/contracts/test/MockFiatTokenWithEditableChainId.sol
index 1df5ace41..05e9b2e1b 100644
--- a/contracts/test/MockFiatTokenWithEditableChainId.sol
+++ b/contracts/test/MockFiatTokenWithEditableChainId.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/UpgradedFiatTokenNewFieldsNewLogicTest.sol b/contracts/test/UpgradedFiatTokenNewFieldsNewLogicTest.sol
index 6137fc2a1..f773d3e5c 100644
--- a/contracts/test/UpgradedFiatTokenNewFieldsNewLogicTest.sol
+++ b/contracts/test/UpgradedFiatTokenNewFieldsNewLogicTest.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/UpgradedFiatTokenNewFieldsTest.sol b/contracts/test/UpgradedFiatTokenNewFieldsTest.sol
index 9989df593..8613373b2 100644
--- a/contracts/test/UpgradedFiatTokenNewFieldsTest.sol
+++ b/contracts/test/UpgradedFiatTokenNewFieldsTest.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/UpgradedFiatTokenV2_2NewFieldsTest.sol b/contracts/test/UpgradedFiatTokenV2_2NewFieldsTest.sol
index 24c855698..ddb46c71f 100644
--- a/contracts/test/UpgradedFiatTokenV2_2NewFieldsTest.sol
+++ b/contracts/test/UpgradedFiatTokenV2_2NewFieldsTest.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/celo/MockFiatTokenCeloWithExposedFunctions.sol b/contracts/test/celo/MockFiatTokenCeloWithExposedFunctions.sol
index 081a6fe8d..ba0e7dcce 100644
--- a/contracts/test/celo/MockFiatTokenCeloWithExposedFunctions.sol
+++ b/contracts/test/celo/MockFiatTokenCeloWithExposedFunctions.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/test/celo/MockFiatTokenFeeAdapterWithExposedFunctions.sol b/contracts/test/celo/MockFiatTokenFeeAdapterWithExposedFunctions.sol
index b48aa85d6..c3c09b99a 100644
--- a/contracts/test/celo/MockFiatTokenFeeAdapterWithExposedFunctions.sol
+++ b/contracts/test/celo/MockFiatTokenFeeAdapterWithExposedFunctions.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/upgradeability/AdminUpgradeabilityProxy.sol b/contracts/upgradeability/AdminUpgradeabilityProxy.sol
index 497870d13..2c9ec3cfb 100644
--- a/contracts/upgradeability/AdminUpgradeabilityProxy.sol
+++ b/contracts/upgradeability/AdminUpgradeabilityProxy.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/upgradeability/Proxy.sol b/contracts/upgradeability/Proxy.sol
index fda5249c6..8cdd88ae8 100644
--- a/contracts/upgradeability/Proxy.sol
+++ b/contracts/upgradeability/Proxy.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/upgradeability/UpgradeabilityProxy.sol b/contracts/upgradeability/UpgradeabilityProxy.sol
index b2273d72e..1708509f9 100644
--- a/contracts/upgradeability/UpgradeabilityProxy.sol
+++ b/contracts/upgradeability/UpgradeabilityProxy.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/util/ECRecover.sol b/contracts/util/ECRecover.sol
index 2ec8ddfdc..ace41c1c1 100644
--- a/contracts/util/ECRecover.sol
+++ b/contracts/util/ECRecover.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/util/EIP712.sol b/contracts/util/EIP712.sol
index 950b41b70..538a715ef 100644
--- a/contracts/util/EIP712.sol
+++ b/contracts/util/EIP712.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/util/MessageHashUtils.sol b/contracts/util/MessageHashUtils.sol
index 3e1043231..afbfc18db 100644
--- a/contracts/util/MessageHashUtils.sol
+++ b/contracts/util/MessageHashUtils.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/util/SignatureChecker.sol b/contracts/util/SignatureChecker.sol
index 9fcf56ff9..7ed1a2188 100644
--- a/contracts/util/SignatureChecker.sol
+++ b/contracts/util/SignatureChecker.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v1.1/FiatTokenV1_1.sol b/contracts/v1.1/FiatTokenV1_1.sol
index dbf763c28..b111c50a5 100644
--- a/contracts/v1.1/FiatTokenV1_1.sol
+++ b/contracts/v1.1/FiatTokenV1_1.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v1.1/Rescuable.sol b/contracts/v1.1/Rescuable.sol
index 60c434f89..11cfb9f2f 100644
--- a/contracts/v1.1/Rescuable.sol
+++ b/contracts/v1.1/Rescuable.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v1/AbstractFiatTokenV1.sol b/contracts/v1/AbstractFiatTokenV1.sol
index 4b318c7e8..5c8acb883 100644
--- a/contracts/v1/AbstractFiatTokenV1.sol
+++ b/contracts/v1/AbstractFiatTokenV1.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v1/Blacklistable.sol b/contracts/v1/Blacklistable.sol
index f24f5b572..f289aa64f 100644
--- a/contracts/v1/Blacklistable.sol
+++ b/contracts/v1/Blacklistable.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v1/FiatTokenProxy.sol b/contracts/v1/FiatTokenProxy.sol
index 7b1ebe141..9f4962c74 100644
--- a/contracts/v1/FiatTokenProxy.sol
+++ b/contracts/v1/FiatTokenProxy.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v1/FiatTokenV1.sol b/contracts/v1/FiatTokenV1.sol
index fc51aef3e..014c139ef 100644
--- a/contracts/v1/FiatTokenV1.sol
+++ b/contracts/v1/FiatTokenV1.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/AbstractFiatTokenV2.sol b/contracts/v2/AbstractFiatTokenV2.sol
index 4f0e448ca..1d00a6a3a 100644
--- a/contracts/v2/AbstractFiatTokenV2.sol
+++ b/contracts/v2/AbstractFiatTokenV2.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/EIP2612.sol b/contracts/v2/EIP2612.sol
index 0523d8efd..ecc278e8f 100644
--- a/contracts/v2/EIP2612.sol
+++ b/contracts/v2/EIP2612.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/EIP3009.sol b/contracts/v2/EIP3009.sol
index a76b0975f..7fe670f36 100644
--- a/contracts/v2/EIP3009.sol
+++ b/contracts/v2/EIP3009.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/EIP712Domain.sol b/contracts/v2/EIP712Domain.sol
index a3a0e85ad..6ebf81b22 100644
--- a/contracts/v2/EIP712Domain.sol
+++ b/contracts/v2/EIP712Domain.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/FiatTokenUtil.sol b/contracts/v2/FiatTokenUtil.sol
index c0df40bff..92d689383 100644
--- a/contracts/v2/FiatTokenUtil.sol
+++ b/contracts/v2/FiatTokenUtil.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/FiatTokenV2.sol b/contracts/v2/FiatTokenV2.sol
index 0919ff8a0..d45836c10 100644
--- a/contracts/v2/FiatTokenV2.sol
+++ b/contracts/v2/FiatTokenV2.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/FiatTokenV2_1.sol b/contracts/v2/FiatTokenV2_1.sol
index c52f85fa3..d9b5908f8 100644
--- a/contracts/v2/FiatTokenV2_1.sol
+++ b/contracts/v2/FiatTokenV2_1.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/FiatTokenV2_2.sol b/contracts/v2/FiatTokenV2_2.sol
index 3ba66608a..d29a7a278 100644
--- a/contracts/v2/FiatTokenV2_2.sol
+++ b/contracts/v2/FiatTokenV2_2.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/celo/FiatTokenCeloV2_2.sol b/contracts/v2/celo/FiatTokenCeloV2_2.sol
index e7550803a..f75e75311 100644
--- a/contracts/v2/celo/FiatTokenCeloV2_2.sol
+++ b/contracts/v2/celo/FiatTokenCeloV2_2.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/celo/FiatTokenFeeAdapterProxy.sol b/contracts/v2/celo/FiatTokenFeeAdapterProxy.sol
index 97e4d41f8..d005bec47 100644
--- a/contracts/v2/celo/FiatTokenFeeAdapterProxy.sol
+++ b/contracts/v2/celo/FiatTokenFeeAdapterProxy.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/celo/FiatTokenFeeAdapterV1.sol b/contracts/v2/celo/FiatTokenFeeAdapterV1.sol
index 41194effc..f2b0b0499 100644
--- a/contracts/v2/celo/FiatTokenFeeAdapterV1.sol
+++ b/contracts/v2/celo/FiatTokenFeeAdapterV1.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/upgrader/AbstractV2Upgrader.sol b/contracts/v2/upgrader/AbstractV2Upgrader.sol
index 45b0446ae..e9604ca90 100644
--- a/contracts/v2/upgrader/AbstractV2Upgrader.sol
+++ b/contracts/v2/upgrader/AbstractV2Upgrader.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/upgrader/V2Upgrader.sol b/contracts/v2/upgrader/V2Upgrader.sol
index ca9ef9405..a2c17d085 100644
--- a/contracts/v2/upgrader/V2Upgrader.sol
+++ b/contracts/v2/upgrader/V2Upgrader.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/upgrader/V2_1Upgrader.sol b/contracts/v2/upgrader/V2_1Upgrader.sol
index f1e2730f3..bde70daf9 100644
--- a/contracts/v2/upgrader/V2_1Upgrader.sol
+++ b/contracts/v2/upgrader/V2_1Upgrader.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/upgrader/V2_2Upgrader.sol b/contracts/v2/upgrader/V2_2Upgrader.sol
index beb3c52af..baef20bba 100644
--- a/contracts/v2/upgrader/V2_2Upgrader.sol
+++ b/contracts/v2/upgrader/V2_2Upgrader.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/upgrader/helpers/AbstractUpgraderHelper.sol b/contracts/v2/upgrader/helpers/AbstractUpgraderHelper.sol
index 4017493ba..0fc0b1cd9 100644
--- a/contracts/v2/upgrader/helpers/AbstractUpgraderHelper.sol
+++ b/contracts/v2/upgrader/helpers/AbstractUpgraderHelper.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/upgrader/helpers/V2UpgraderHelper.sol b/contracts/v2/upgrader/helpers/V2UpgraderHelper.sol
index dd56e2743..88b00687f 100644
--- a/contracts/v2/upgrader/helpers/V2UpgraderHelper.sol
+++ b/contracts/v2/upgrader/helpers/V2UpgraderHelper.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/contracts/v2/upgrader/helpers/V2_2UpgraderHelper.sol b/contracts/v2/upgrader/helpers/V2_2UpgraderHelper.sol
index d4a58632e..6dd1dac4b 100644
--- a/contracts/v2/upgrader/helpers/V2_2UpgraderHelper.sol
+++ b/contracts/v2/upgrader/helpers/V2_2UpgraderHelper.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/doc/bridged_USDC_standard.md b/doc/bridged_USDC_standard.md
index b51fc3623..710fde6cd 100644
--- a/doc/bridged_USDC_standard.md
+++ b/doc/bridged_USDC_standard.md
@@ -26,15 +26,14 @@ they follow the same implementation.
    securely transfer ownership of the bridged USDC token contract to Circle and
    perform an upgrade to native USDC, the following will take place:
    - Third-party team will pause bridging activity and reconcile in-flight
-     bridging activity to harmonize the total supply of native USDC locked on
-     the origin chain with the total supply of bridged USDC on the destination
-     chain.
+     bridging activity to finalize the total supply of bridged USDC on the
+     destination chain.
    - Third-party team will securely re-assign the contract roles of the bridged
      USDC token contract to Circle.
-   - Circle and the third-party team will jointly coordinate to burn the supply
-     of native USDC locked in the bridge contract on the origin chain and
-     upgrade the bridged USDC token contract on the destination chain to native
-     USDC.
+   - Circle and the third-party team will jointly coordinate to burn an amount
+     of native USDC locked in the bridge contract on the origin chain that
+     equals the supply of bridged USDC on the destination chain and upgrade the
+     bridged USDC token contract on the destination chain to native USDC.
 4. The native USDC token contract seamlessly retains the existing supply,
    holders, and app integrations of the original bridged USDC token contract.
 
@@ -54,11 +53,11 @@ proceed with an upgrade.
 
 ### 1) Ability to pause USDC bridging
 
-The bridges must be able to support a USDC supply lock, whereby the USDC locked
-on the source blockchain will (at some point soon after) precisely match the
-circulating bridged USDC supply on the destination blockchain. How this is
-implemented is up to the third-party team, but this functionality must be
-present before an upgrade can take place.
+The bridge contracts must be able to pause bridging, enabling a finalization of
+the supply of the bridged token with that supply being fully backed by an amount
+of native USDC on the source chain. How this is implemented is up to the
+third-party team, but this functionality must be present before an upgrade can
+take place.
 
 ### 2) Ability to burn locked USDC
 
@@ -78,9 +77,10 @@ The specific implementation details are left up to the third-party team, but at
 a minimum, the function must:
 
 1. Be only callable by an address that Circle specifies closer to the time of
-   the upgrade.
-2. Burn the amount of USDC held by the bridge that corresponds precisely to the
-   circulating total supply of bridged USDC established by the supply lock.
+   the upgrade. Note that this address will not necessarily be the same address
+   that is specified to call `transferUSDCRoles`.
+2. Burn an amount of USDC held by the bridge that equals the total supply of
+   bridged USDC finalized by the supply lock.
 
 ## Token Deployment
 
@@ -95,10 +95,18 @@ Using identical code facilitates trustless contract verification by Circle and
 supports a seamless integration with existing USDC services. To facilitate this,
 the third-party team should:
 
-1. Build the [FiatToken contracts](../README.md#contracts) from source. Various
-   suggested compiler settings that Circle uses can be found
-   [here](../foundry.toml), which will allow the third-party team to reach the
-   same bytecode if followed consistently.
+1. Build the [FiatToken contracts](../README.md#contracts) from source. To
+   ensure bytecode parity, the Solidity compiler configuration used should match
+   the following settings:
+
+   - Solidity version: 0.6.12
+   - Optimizer runs: 10000000 (Partners should attempt to use the same number of
+     optimizer runs, but may choose to reduce it if there are technical
+     limitations)
+
+   For suggested compiler settings that Circle uses, please refer to
+   [foundry.toml](../foundry.toml).
+
 2. Deploy the locally compiled FiatToken contracts. An overview of the
    deployment process can be found [here](./deployment.md).
 3. Extract the compiler metadata used to generate the deployed contract's
@@ -218,7 +226,8 @@ function transferUSDCRoles(address owner) external;
 The function implementation details are left up to the partner, but it must:
 
 1. Be only callable by an address that Circle specifies closer to the time of
-   the upgrade.
+   the upgrade. Note that this address will not necessarily be the same address
+   that is specified to call `burnLockedUSDC`.
 2. Transfer the Implementation Owner role to the address specified in the
    `owner` parameter.
 3. Transfer the ProxyAdmin role to the function caller (if it is assigned to the
diff --git a/doc/bridged_asset_automated_verification.md b/doc/bridged_asset_automated_verification.md
new file mode 100644
index 000000000..93cbb0261
--- /dev/null
+++ b/doc/bridged_asset_automated_verification.md
@@ -0,0 +1,106 @@
+# Bridged Asset Automated Verification
+
+This documentation is a step-by-step guide on using the automated workflow for
+bytecode verification for bridged token deployments. It also includes some
+common mistakes that have caused unsuccessful verification, and how to fix them.
+
+## Setup
+
+1. Clone the latest version of Circle's repo and set it up as instructed
+   [here](../README.md).
+
+2. Copy the [template](../verification_artifacts/input.template.json) by running
+   the following command
+
+   ```sh
+   $ cp verification_artifacts/input.template.json verification_artifacts/input.json
+   ```
+
+## Providing Input
+
+Please follow the instructions below on filling the file. It is required to
+provide the input for the latest FiatToken implementation contract
+(FiatTokenV2_2 as of writing), FiatTokenProxy, and the SignatureChecker library
+contract, all at once.
+
+1. Fill in the `input.json` file that you created. For each contract, the
+   required fields are:
+
+   - `contractAddress`
+   - `contractCreationTxHash`
+
+   You must also provide a standard EVM-compatible node URL in the field:
+
+   - `rpcUrl`
+
+   There are additional optional parameters for each contract that should only
+   be used if a contract cannot be verified using the required parameters alone.
+   The purpose of each optional parameter is described below::
+
+   - `verificationType`: by default, the verification type will be "partial".
+     This means that the metadata hash at the end of the runtime bytecode will
+     be verified separately via the metadata files generated below.
+     Alternatively, this field can be set to "full", but in that case, your
+     contract's metadata must match the metadata in this repo exactly. If this
+     parameter is set to "full", you may skip the metadata extraction described
+     in step 2.
+   - `useTracesForCreationBytecode`: a boolean value for whether or not to use
+     traces for pulling contract creation code. Setting this parameter to `true`
+     is only necessary if the contract was deployed _within_ a transaction, i.e.
+     it was deployed from another contract. Note that if this parameter is set
+     to `true`, the provided `rpcUrl` must support the `debug_traceTransaction`
+     JSON RPC method.
+   - `artifactType`: a string to indicate what artifact to use for verification
+     if the contract deployment does not match the current artifacts in the
+     repo. The options for this value can be found in
+     [alternativeArtficacts.ts](../scripts/hardhat/alternativeArtifacts.ts).
+   - `optimizerRuns`: an integer indicating the number of optimizer runs
+     specified when compiling the contract. This is only necessary to include if
+     your value does not match the one in [foundry.toml](../foundry.toml).
+
+2. Follow the steps [here](./metadata_extraction.md) to extract metadata for
+   each of the following contracts:
+
+   1. extract FiatTokenV2_2 metadata to
+      `verification_artifacts/FiatTokenV2_2.json`
+   2. extract FiatTokenProxy metadata to
+      `verification_artifacts/FiatTokenProxy.json`
+   3. extract SignatureChecker metadata to
+      `verification_artifacts/SignatureChecker.json`
+
+   After this step, your local directory should look like
+
+   ```
+   stablecoin-evm
+   ├── verification_artifacts
+   │   ├── FiatTokenV2_2.json
+   │   ├── FiatTokenProxy.json
+   │   ├── SignatureChecker.json
+   │   └── input.json
+   ├── ...
+   ```
+
+   Note that the namings are strictly enforced by the verification script.
+
+## Steps for Verification
+
+1. Create a PR to Circle's public repo with the title prefixed with "**[B2N]**."
+2. Inform your point of contact at Circle that you have made a PR and wait for
+   an approval from Circle to run the GitHub action.
+3. Automated bytecode verification will run once the PR is checked and the
+   workflow is approved. From there, you can verify your results by seeing the
+   Checks section on the PR page. If verification fails, you may request for
+   another verification by submitting another commit to the same PR.
+4. Inform your point of contact at Circle once verification has succeeded.
+
+## Common Issues
+
+### Compiler Settings
+
+Please check your compiler settings and make sure everything, including
+optimizer runs, matches ours.
+
+### Metadata mismatch
+
+Do not format the metadata files--leave them as extracted. Formatting the file
+will result in a mismatching hash.
diff --git a/doc/deployment.md b/doc/deployment.md
index 4671f23fa..bedb7da1d 100644
--- a/doc/deployment.md
+++ b/doc/deployment.md
@@ -33,7 +33,7 @@ available, but can only be called once per proxy.
    ```
 
 3. Verify that all fields in the FiatToken have been initialized correctly and
-   have the expected values. See [README.validate.md](../validate/validate.js).
+   have the expected values.
 
 ## Deploying a Proxy:
 
@@ -51,9 +51,9 @@ available, but can only be called once per proxy.
    For details on what these roles can do, see the
    [Token Design Doc](tokendesign.md)
 
-2. Deploy [FiatTokenProxy](../contracts/FiatTokenProxy.sol), passing the address
-   of the deployed implementation contract to the constructor, which will
-   initialize the `_implementation` field.
+2. Deploy [FiatTokenProxy](../contracts/v1/FiatTokenProxy.sol), passing the
+   address of the deployed implementation contract to the constructor, which
+   will initialize the `_implementation` field.
 
 3. The `admin` of the proxy contract defaults to `msg.sender`. You must either
    change the `admin` now, or send the remaining transactions from a different
diff --git a/doc/metadata_extraction.md b/doc/metadata_extraction.md
new file mode 100644
index 000000000..81447d21d
--- /dev/null
+++ b/doc/metadata_extraction.md
@@ -0,0 +1,35 @@
+# Extracting Metadata
+
+Important note: please separately extract the metadata into their own JSON files
+for the FiatTokenProxy, FiatToken2_2 (at the time of writing), and
+SignatureChecker contracts.
+
+Depending on the development framework you are using, there are different ways
+to find the artifact metadata. The steps and general information are documented
+below.
+
+## Foundry
+
+Foundry automatically stores build information for each `.sol` file in a
+directory, typically the `out` directory unless specified otherwise in the
+`foundry.toml` file. For the contract `example.sol`, the metadata is stored in
+`out/example.sol/example.json` under the `rawMetadata` field, depending on the
+version of Foundry you're using. To retrieve the metadata, you can run the
+following command:
+
+```sh
+cat path/to/example.sol/example.json | jq -jr '.rawMetadata' > example.metadata.json
+```
+
+## Hardhat
+
+Hardhat stores the compiled output in the `artifacts` directory (or in the
+artifacts path specified in `hardhat.config.ts`), which includes two
+subdirectories, both of which are needed to extract metadata: `build-info` and
+`contracts`. The `build-info` directory contains files with hex IDs. You can
+output the metadata of `example.sol` to `example.metadata.json` by running the
+following command from root directory:
+
+```sh
+cat "$(jq -r '.buildInfo' path/to/artifacts/contracts/path/to/example.sol/example.dbg.json | sed 's|^\.\./\.\./\.\./|path/to/artifacts/|')" | jq -jr '.output.contracts["contracts/path/to/example.sol"].example.metadata' > example.json
+```
diff --git a/flatten-generated-types.sh b/flatten-generated-types.sh
index c1097da26..34a15ac5c 100755
--- a/flatten-generated-types.sh
+++ b/flatten-generated-types.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 #
-# Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+# Copyright 2024 Circle Internet Group, Inc. All rights reserved.
 #
 # SPDX-License-Identifier: Apache-2.0
 #
diff --git a/foundry.toml b/foundry.toml
index 1a939362c..196128c45 100644
--- a/foundry.toml
+++ b/foundry.toml
@@ -1,4 +1,4 @@
-# Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+# Copyright 2024 Circle Internet Group, Inc. All rights reserved.
 #
 # SPDX-License-Identifier: Apache-2.0
 #
diff --git a/hardhat.config.ts b/hardhat.config.ts
index 3bf1fbbc6..6ef8d4ced 100644
--- a/hardhat.config.ts
+++ b/hardhat.config.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -36,7 +36,7 @@ import "./scripts/hardhat/getContractCreationBlock";
 import "./scripts/hardhat/readValuesFromContract";
 import "./scripts/hardhat/validateAccountsToBlacklist";
 
-import "./scripts/hardhat/verifyBytecodeOnChain";
+import "./scripts/hardhat/verifyOnChainBytecode";
 
 dotenv.config();
 
diff --git a/package.json b/package.json
index 6968449e3..c272a583d 100644
--- a/package.json
+++ b/package.json
@@ -10,7 +10,8 @@
     "contract-size": "hardhat size-contracts",
     "coverage": "hardhat coverage",
     "forge:simulate": "forge script -vv --gas-estimate-multiplier $(dotenv -p GAS_MULTIPLIER)",
-    "forge:broadcast": "yarn forge:simulate --broadcast",
+    "forge:broadcast": "yarn forge:simulate --broadcast --slow",
+    "forge:resume": "yarn forge:broadcast --resume",
     "forge:broadcastAndVerify": "yarn forge:broadcast --verify --etherscan-api-key $(dotenv -p ETHERSCAN_KEY)",
     "forge:verify": "yarn forge:simulate --verify --resume --etherscan-api-key $(dotenv -p ETHERSCAN_KEY) --private-key $(dotenv -p DEPLOYER_PRIVATE_KEY)",
     "fmt:base": "prettier './**/*.sol' './**/*.js' './**/*.ts' './**/*.json' './**/*.md'",
@@ -43,52 +44,60 @@
     "@nomicfoundation/hardhat-network-helpers": "1.0.8",
     "@nomiclabs/hardhat-truffle5": "2.0.7",
     "@nomiclabs/hardhat-web3": "2.0.0",
-    "@openzeppelin/contracts": "^3.1.0",
-    "@typechain/ethers-v6": "^0.4.0",
-    "@typechain/hardhat": "^9.0.0",
-    "@typechain/truffle-v5": "^8.0.6",
+    "@openzeppelin/contracts": "3.4.2",
+    "@typechain/ethers-v6": "0.4.3",
+    "@typechain/hardhat": "9.0.0",
+    "@typechain/truffle-v5": "8.0.6",
     "@types/chai": "4.3.5",
-    "@types/ethereumjs-abi": "^0.6.3",
-    "@types/lodash": "^4.14.158",
+    "@types/ethereumjs-abi": "0.6.3",
+    "@types/lodash": "4.14.195",
     "@types/mocha": "10.0.1",
     "@types/node": "20.5.1",
-    "@typescript-eslint/eslint-plugin": "^3.7.0",
-    "@typescript-eslint/parser": "^3.7.0",
+    "@types/sinon": "17.0.3",
+    "@typescript-eslint/eslint-plugin": "3.10.1",
+    "@typescript-eslint/parser": "3.10.1",
     "assert-diff": "1.2.6",
-    "chai": "^4.2.0",
-    "dotenv": "^16.4.1",
-    "dotenv-cli": "^7.3.0",
-    "eslint": "^7.5.0",
-    "eslint-config-prettier": "^6.11.0",
-    "eslint-config-standard": "^14.1.1",
-    "eslint-plugin-import": "^2.22.0",
-    "eslint-plugin-node": "^11.1.0",
-    "eslint-plugin-prettier": "^3.1.4",
-    "eslint-plugin-promise": "^4.2.1",
-    "eslint-plugin-standard": "^4.0.1",
-    "ethereumjs-abi": "^0.6.8",
-    "ethereumjs-util": "^7.0.3",
-    "ethers": "^6.11.0",
+    "bs58": "5.0.0",
+    "cbor": "9.0.2",
+    "chai": "4.3.7",
+    "dotenv": "16.4.1",
+    "dotenv-cli": "7.3.0",
+    "eslint": "7.32.0",
+    "eslint-config-prettier": "6.15.0",
+    "eslint-config-standard": "14.1.1",
+    "eslint-plugin-import": "2.27.5",
+    "eslint-plugin-node": "11.1.0",
+    "eslint-plugin-prettier": "3.4.1",
+    "eslint-plugin-promise": "4.3.1",
+    "eslint-plugin-standard": "4.1.0",
+    "ethereumjs-abi": "0.6.8",
+    "ethereumjs-util": "7.1.5",
+    "ethers": "6.11.1",
     "hardhat": "2.19.4",
-    "hardhat-contract-sizer": "^2.10.0",
-    "hardhat-gas-reporter": "^1.0.10",
-    "husky": "^8.0.3",
-    "lodash": "^4.17.19",
-    "mocha-junit-reporter": "^2.2.1",
-    "mocha-multi-reporters": "^1.5.1",
+    "hardhat-contract-sizer": "2.10.0",
+    "hardhat-gas-reporter": "1.0.10",
+    "husky": "8.0.3",
+    "ipfs-only-hash": "4.0.0",
+    "lodash": "4.17.21",
+    "mocha-junit-reporter": "2.2.1",
+    "mocha-multi-reporters": "1.5.1",
     "prettier": "2.0.5",
     "prettier-plugin-solidity": "1.0.0-alpha.54",
-    "q": "^1.5.1",
+    "q": "1.5.1",
+    "sinon": "19.0.2",
     "solc": "0.6.12",
-    "solhint": "^3.1.0",
-    "solidity-coverage": "^0.8.9",
-    "ts-node": ">=8.0.0",
-    "typechain": "^8.1.0",
-    "typescript": ">=4.5.0",
-    "web3": "^1.2.11"
+    "solhint": "3.4.1",
+    "solidity-coverage": "0.8.9",
+    "ts-node": "10.9.1",
+    "typechain": "8.3.1",
+    "typescript": "5.1.6",
+    "web3": "1.10.1"
+  },
+  "resolutions": {
+    "hardhat-gas-reporter/**/flat": "5.0.2"
   },
   "engines": {
-    "node": "16.14.0",
+    "node": "20.9.0",
     "yarn": "1.22.19"
   }
 }
diff --git a/scripts/deploy/DeployImpl.sol b/scripts/deploy/DeployImpl.sol
index 9bff83e6e..3adced057 100644
--- a/scripts/deploy/DeployImpl.sol
+++ b/scripts/deploy/DeployImpl.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/deploy/ScriptUtils.sol b/scripts/deploy/ScriptUtils.sol
index e3db1c094..2927e4980 100644
--- a/scripts/deploy/ScriptUtils.sol
+++ b/scripts/deploy/ScriptUtils.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/deploy/celo/deploy-fee-adapter.s.sol b/scripts/deploy/celo/deploy-fee-adapter.s.sol
index ce242c589..471e070df 100644
--- a/scripts/deploy/celo/deploy-fee-adapter.s.sol
+++ b/scripts/deploy/celo/deploy-fee-adapter.s.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/deploy/celo/deploy-fiat-token-celo.s.sol b/scripts/deploy/celo/deploy-fiat-token-celo.s.sol
index 8ac1e1739..81da66aa9 100644
--- a/scripts/deploy/celo/deploy-fiat-token-celo.s.sol
+++ b/scripts/deploy/celo/deploy-fiat-token-celo.s.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/deploy/deploy-fiat-token.s.sol b/scripts/deploy/deploy-fiat-token.s.sol
index bd97c9f81..499e508e3 100644
--- a/scripts/deploy/deploy-fiat-token.s.sol
+++ b/scripts/deploy/deploy-fiat-token.s.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/deploy/deploy-impl-and-upgrader.s.sol b/scripts/deploy/deploy-impl-and-upgrader.s.sol
index ad58ee4dd..57ae0273f 100644
--- a/scripts/deploy/deploy-impl-and-upgrader.s.sol
+++ b/scripts/deploy/deploy-impl-and-upgrader.s.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/deploy/deploy-master-minter.s.sol b/scripts/deploy/deploy-master-minter.s.sol
index 0db846855..9fffade76 100644
--- a/scripts/deploy/deploy-master-minter.s.sol
+++ b/scripts/deploy/deploy-master-minter.s.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/git/diff-check.sh b/scripts/git/diff-check.sh
index 91deac274..0272f53b1 100755
--- a/scripts/git/diff-check.sh
+++ b/scripts/git/diff-check.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 #
-# Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+# Copyright 2023 Circle Internet Group, Inc. All rights reserved.
 #
 # SPDX-License-Identifier: Apache-2.0
 #
diff --git a/scripts/git/rebase.sh b/scripts/git/rebase.sh
index 260ada0d0..c24494146 100755
--- a/scripts/git/rebase.sh
+++ b/scripts/git/rebase.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 #
-# Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+# Copyright 2023 Circle Internet Group, Inc. All rights reserved.
 #
 # SPDX-License-Identifier: Apache-2.0
 #
diff --git a/scripts/hardhat/alternativeArtifacts.ts b/scripts/hardhat/alternativeArtifacts.ts
new file mode 100644
index 000000000..34c0125ca
--- /dev/null
+++ b/scripts/hardhat/alternativeArtifacts.ts
@@ -0,0 +1,59 @@
+/**
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { ContractArtifact } from "./verifyOnChainBytecode";
+import * as fs from "fs";
+
+type AlternativeArtifact = Map<string, ContractArtifact>;
+
+export enum ArtifactType {
+  OPMainnet = "OPMainnet",
+}
+
+const CACHED_ARTIFACTS_PATH = "./cached_artifacts/";
+
+// Read from https://optimistic.etherscan.io/token/0x0b2c639c533813f4aa9d7837caf62653d097ff85#code
+export const opMainnetFiatTokenProxyContractCreationBytecode = readCachedArtifact(
+  "opMainnetFiatTokenProxyContractCreationBytecode.bin"
+);
+const opMainnetFiatTokenProxyRuntimeBytecode = readCachedArtifact(
+  "opMainnetFiatTokenProxyRuntimeBytecode.bin"
+);
+
+const opMainnetArtifacts: AlternativeArtifact = new Map([
+  [
+    "FiatTokenProxy",
+    {
+      creationBytecode: opMainnetFiatTokenProxyContractCreationBytecode,
+      runtimeBytecode: opMainnetFiatTokenProxyRuntimeBytecode,
+      creationLinkReferences: {},
+      runtimeLinkReferences: {},
+    },
+  ],
+]);
+
+export const alternativeArtifacts: Map<
+  ArtifactType,
+  AlternativeArtifact
+> = new Map([[ArtifactType.OPMainnet, opMainnetArtifacts]]);
+
+function readCachedArtifact(filename: string): string {
+  return (
+    "0x" + fs.readFileSync(CACHED_ARTIFACTS_PATH + filename, "utf-8").trim()
+  );
+}
diff --git a/scripts/hardhat/downloadBlacklistedAccounts.ts b/scripts/hardhat/downloadBlacklistedAccounts.ts
index f39689fde..426d24667 100644
--- a/scripts/hardhat/downloadBlacklistedAccounts.ts
+++ b/scripts/hardhat/downloadBlacklistedAccounts.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/hardhat/getContractCreationBlock.ts b/scripts/hardhat/getContractCreationBlock.ts
index 81d559986..497d5f795 100644
--- a/scripts/hardhat/getContractCreationBlock.ts
+++ b/scripts/hardhat/getContractCreationBlock.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/hardhat/hardhatArgumentTypes.ts b/scripts/hardhat/hardhatArgumentTypes.ts
index 8dc739559..b6cd190cf 100644
--- a/scripts/hardhat/hardhatArgumentTypes.ts
+++ b/scripts/hardhat/hardhatArgumentTypes.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/hardhat/helpers.ts b/scripts/hardhat/helpers.ts
index 5eb64fef1..cbe6c1722 100644
--- a/scripts/hardhat/helpers.ts
+++ b/scripts/hardhat/helpers.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -16,6 +16,8 @@
  * limitations under the License.
  */
 
+import { execSync } from "child_process";
+
 /**
  * Utility function to trigger a sleep.
  * @param ms the period to sleep for
@@ -23,3 +25,23 @@
 export async function sleep(ms: number): Promise<void> {
   await new Promise((resolve) => setTimeout(resolve, ms));
 }
+
+/**
+ * Utility function to validate a supplied optimizerRuns
+ * @param optimizerRuns the supplied value for optimizerRuns
+ */
+export function validateOptimizerRuns(optimizerRuns: number): void {
+  if (!Number.isInteger(optimizerRuns) || optimizerRuns < 0) {
+    throw new Error("invalid optimizerRuns");
+  }
+}
+
+/**
+ * Wrapper for execSync so that execSync can be mocked in tests.
+ * Mocking execSync directly with Sinon results in the error
+ *"TypeError: Descriptor for property execSync is non-configurable and non-writable"
+ * @param command the command to execute
+ */
+export function execSyncWrapper(command: string): void {
+  execSync(command);
+}
diff --git a/scripts/hardhat/readValuesFromContract.ts b/scripts/hardhat/readValuesFromContract.ts
index 4682c051e..c48a71504 100644
--- a/scripts/hardhat/readValuesFromContract.ts
+++ b/scripts/hardhat/readValuesFromContract.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/hardhat/validateAccountsToBlacklist.ts b/scripts/hardhat/validateAccountsToBlacklist.ts
index 04ab40b76..d5b753645 100644
--- a/scripts/hardhat/validateAccountsToBlacklist.ts
+++ b/scripts/hardhat/validateAccountsToBlacklist.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/scripts/hardhat/verifyBytecodeOnChain.ts b/scripts/hardhat/verifyBytecodeOnChain.ts
deleted file mode 100644
index 214f53a87..000000000
--- a/scripts/hardhat/verifyBytecodeOnChain.ts
+++ /dev/null
@@ -1,180 +0,0 @@
-/**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
- *
- * SPDX-License-Identifier: Apache-2.0
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import { readFileSync } from "fs";
-import { task } from "hardhat/config";
-import { HardhatRuntimeEnvironment, LinkReferences } from "hardhat/types";
-import _ from "lodash";
-import path from "path";
-import { hardhatArgumentTypes } from "./hardhatArgumentTypes";
-
-type TaskArguments = {
-  contractName: string;
-  contractAddress: string;
-  libraryName?: string;
-  libraryAddress?: string;
-  verificationType: "full" | "partial";
-};
-
-task(
-  "verifyBytecodeOnChain",
-  "Verify that the locally compiled bytecode matches the deployed bytecode on chain."
-)
-  .addParam(
-    "contractName",
-    "The name of the contract to validate",
-    undefined,
-    hardhatArgumentTypes.string
-  )
-  .addParam(
-    "contractAddress",
-    "The address of the contract to validate",
-    undefined,
-    hardhatArgumentTypes.address
-  )
-  .addOptionalParam(
-    "libraryName",
-    "The name of the library contract the main contract uses",
-    undefined,
-    hardhatArgumentTypes.string
-  )
-  .addOptionalParam(
-    "libraryAddress",
-    "The address of the library contract",
-    undefined,
-    hardhatArgumentTypes.address
-  )
-  .addOptionalParam(
-    "verificationType",
-    "Checks metadata if set to 'full', skips metadata checking if set to 'partial'.",
-    "full",
-    hardhatArgumentTypes.oneOf(["full", "partial"])
-  )
-  .setAction(taskAction);
-
-async function taskAction(
-  {
-    contractName,
-    contractAddress,
-    libraryName,
-    libraryAddress,
-    verificationType,
-  }: TaskArguments,
-  hre: HardhatRuntimeEnvironment
-) {
-  // Getting contract bytecode from blockchain
-  const rawOnchainBytecode = await hre.ethers.provider.getCode(contractAddress);
-
-  // Getting locally compiled bytecode, swap out library contract addresses
-  const foundryContractArtifact = JSON.parse(
-    readFileSync(
-      path.join(
-        __dirname,
-        "..",
-        "..",
-        "artifacts",
-        "foundry",
-        `${contractName}.sol`,
-        `${contractName}.json`
-      ),
-      "utf-8"
-    )
-  );
-
-  let rawLocalBytecode: string =
-    foundryContractArtifact.deployedBytecode.object;
-  const deployedLinkReferences: LinkReferences =
-    foundryContractArtifact.deployedBytecode.linkReferences;
-
-  if (libraryName && libraryAddress) {
-    const libraryReferencePositions: {
-      length: number;
-      start: number;
-    }[] = _.chain(deployedLinkReferences)
-      .values()
-      .map(Object.entries)
-      .flatten()
-      .fromPairs()
-      .get(libraryName)
-      .value();
-
-    for (const position of libraryReferencePositions) {
-      const replacement = libraryAddress
-        .slice(2, 2 + position["length"] * 2)
-        .toLowerCase();
-      rawLocalBytecode =
-        rawLocalBytecode.slice(0, 2 + position.start * 2) +
-        replacement +
-        rawLocalBytecode.slice(2 + position.start * 2 + position["length"] * 2);
-    }
-  }
-
-  // Compare onchain bytecode against local bytecode
-  if (verificationType === "full") {
-    logBytecodeComparisonResult(
-      rawLocalBytecode,
-      rawOnchainBytecode,
-      verificationType
-    );
-  } else {
-    const onchainBytecodeNoMetadata = removeMetadataHash(rawOnchainBytecode);
-    const localBytecodeNoMetadata = removeMetadataHash(rawLocalBytecode);
-    logBytecodeComparisonResult(
-      localBytecodeNoMetadata,
-      onchainBytecodeNoMetadata,
-      verificationType
-    );
-  }
-}
-
-function logBytecodeComparisonResult(
-  bytecodeA: string,
-  bytecodeB: string,
-  verificationType: TaskArguments["verificationType"]
-) {
-  if (bytecodeA !== bytecodeB) {
-    console.log(
-      "\x1b[31m",
-      `\nWARNING: ${verificationType} verification failed - bytecode on chain differs from local compilation.`
-    );
-    process.exit(1);
-  } else {
-    console.log(
-      "\x1b[32m",
-      `\n${verificationType} verification complete - onchain contract contains the same bytecode.`
-    );
-    process.exit(0);
-  }
-}
-
-function removeMetadataHash(contractBytecode: string) {
-  const metadataLength = getContractMetadataLength(contractBytecode);
-  return contractBytecode.slice(0, contractBytecode.length - metadataLength);
-}
-
-function getContractMetadataLength(contractBytecode: string) {
-  // Read the last two bytes to determine the length of the CBOR encoding
-  // https://docs.soliditylang.org/en/develop/metadata.html#encoding-of-the-metadata-hash-in-the-bytecode
-  const metadataLengthHex = contractBytecode.slice(
-    contractBytecode.length - 4,
-    contractBytecode.length
-  );
-
-  const metadataNumBytes = parseInt(metadataLengthHex, 16);
-  return metadataNumBytes * 2 + metadataLengthHex.length;
-}
diff --git a/scripts/hardhat/verifyOnChainBytecode.ts b/scripts/hardhat/verifyOnChainBytecode.ts
new file mode 100644
index 000000000..16988d61f
--- /dev/null
+++ b/scripts/hardhat/verifyOnChainBytecode.ts
@@ -0,0 +1,541 @@
+/**
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import bs58 from "bs58";
+import { decode } from "cbor";
+import { readFileSync } from "fs";
+import { task } from "hardhat/config";
+import { HardhatRuntimeEnvironment, LinkReferences } from "hardhat/types";
+import Hash from "ipfs-only-hash";
+import _ from "lodash";
+import path from "path";
+import { hardhatArgumentTypes } from "./hardhatArgumentTypes";
+import { alternativeArtifacts, ArtifactType } from "./alternativeArtifacts";
+import { execSyncWrapper, validateOptimizerRuns } from "./helpers";
+
+export type TaskArguments = {
+  contractName: string;
+  contractAddress: string;
+  libraryName?: string;
+  libraryAddress?: string;
+  verificationType: BytecodeVerificationType;
+  onchainBytecodeFilePath?: string;
+  isLibrary?: boolean;
+  metadataFilePath?: string;
+  contractCreationTxHash?: string;
+  useTracesForCreationBytecode?: boolean;
+  artifactType?: ArtifactType;
+  optimizerRuns?: number;
+};
+
+export enum BytecodeVerificationType {
+  Partial = "partial", // verifies the runtime bytecode without checking the metadata hash
+  Full = "full", // verifies the entire runtime bytecode including the metadata hash
+}
+
+export enum BytecodeInputType {
+  ConstructorCode = "constructor code", // Constructor bytecode (the portion that preceeds the runtime bytecode within the full creation bytecode)
+  RuntimeBytecodeFull = "full runtime bytecode", // Runtime bytecode including metadata hash
+  RuntimeBytecodePartial = "partial runtime bytecode", // Runtime bytecode excluding metadata hash
+  MetadataHash = "metadata hash",
+}
+
+export interface ContractArtifact {
+  creationBytecode: string;
+  runtimeBytecode: string;
+  creationLinkReferences: LinkReferences;
+  runtimeLinkReferences: LinkReferences;
+}
+
+interface GethTransactionTrace {
+  from: string;
+  to: string;
+  gas: string;
+  gasUsed: string;
+  input: string;
+  output?: string;
+  type: string;
+  value?: string;
+  calls?: GethTransactionTrace[];
+}
+
+type BytecodeComparisonResult = {
+  type: BytecodeInputType;
+  equal: boolean; // if the inputs are identical
+};
+
+task(
+  "verifyOnChainBytecode",
+  "Verify that the locally compiled bytecode matches the deployed bytecode on chain."
+)
+  .addParam(
+    "contractName",
+    "The name of the contract to validate",
+    undefined,
+    hardhatArgumentTypes.string
+  )
+  .addParam(
+    "contractAddress",
+    "The address of the contract to validate",
+    undefined,
+    hardhatArgumentTypes.address
+  )
+  .addOptionalParam(
+    "libraryName",
+    "The name of the library contract the main contract uses",
+    undefined,
+    hardhatArgumentTypes.string
+  )
+  .addOptionalParam(
+    "libraryAddress",
+    "The address of the library contract",
+    undefined,
+    hardhatArgumentTypes.address
+  )
+  .addOptionalParam(
+    "verificationType",
+    "Checks metadata if set to 'full', skips metadata checking if set to 'partial'.",
+    "partial",
+    hardhatArgumentTypes.oneOf(["full", "partial"])
+  )
+  .addOptionalParam(
+    "onchainBytecodeFilePath",
+    "Local file path that contains the deployed bytecode on chain. You can retrieve this using the eth_getCode RPC or from the 'Deployed Bytecode' section on Etherscan.",
+    undefined,
+    hardhatArgumentTypes.string
+  )
+  .addOptionalParam(
+    "isLibrary",
+    "If the contract being verified is a library contract",
+    false,
+    hardhatArgumentTypes.boolean
+  )
+  .addOptionalParam(
+    "metadataFilePath",
+    "Local file path that contains the uploaded metadata",
+    undefined,
+    hardhatArgumentTypes.string
+  )
+  .addOptionalParam(
+    "contractCreationTxHash",
+    "Transaction hash of the contract creation transaction",
+    undefined,
+    hardhatArgumentTypes.string
+  )
+  .addOptionalParam(
+    "useTracesForCreationBytecode",
+    "Use transaction traces to pull the contract creation bytecode",
+    false,
+    hardhatArgumentTypes.boolean
+  )
+  .addOptionalParam(
+    "artifactType",
+    "The type of artifact to use for verification",
+    undefined,
+    hardhatArgumentTypes.string
+  )
+  .addOptionalParam(
+    "optimizerRuns",
+    "The optimizer runs to use to compile the contract",
+    undefined,
+    hardhatArgumentTypes.int
+  )
+  .setAction(taskAction);
+
+/**
+ * Wrapper function to pretty print the results of `verifyOnChainBytecode`.
+ */
+async function taskAction(
+  taskArguments: TaskArguments,
+  hre: HardhatRuntimeEnvironment
+): Promise<void> {
+  const results = await verifyOnChainBytecode(taskArguments, hre);
+  logBytecodeComparisonResults(results);
+}
+
+/**
+ * A utility script to verify contract bytecode against locally compiled bytecode.
+ *
+ * Anatomy of contract bytecode:
+ * contract_creation_code = <constructor_code><runtime_bytecode><constructor_arguments>
+ * runtime_bytecode = <runtime_logic_bytecode><metadata_hash><metadata_len(2 byte at end)>
+ *
+ * Edge cases:
+ * 1) With solc v6 and v7, there's an anomoly where constants(strings) used by the constructor is added between `runtime_bytecode` and `constructor_arguments`
+ * 2) Runtime bytecode of contracts using external libraries has the address of the external library embedded
+ * 3) Runtime bytecode of library contracts has its own address embedded after the first PUSH instruction
+ */
+export async function verifyOnChainBytecode(
+  {
+    contractName,
+    contractAddress,
+    libraryName,
+    libraryAddress,
+    verificationType,
+    onchainBytecodeFilePath,
+    isLibrary,
+    metadataFilePath,
+    contractCreationTxHash,
+    useTracesForCreationBytecode,
+    artifactType,
+    optimizerRuns,
+  }: TaskArguments,
+  hre: HardhatRuntimeEnvironment
+): Promise<BytecodeComparisonResult[]> {
+  if (optimizerRuns) {
+    validateOptimizerRuns(optimizerRuns);
+    execSyncWrapper(`forge build --optimizer-runs ${optimizerRuns}`);
+  }
+  const bytecodeComparisonResults = [];
+
+  // Getting contract bytecode from blockchain or local file input
+  let actualRuntimeBytecode;
+  if (onchainBytecodeFilePath) {
+    actualRuntimeBytecode = readFileSync(
+      path.join(__dirname, "..", "..", onchainBytecodeFilePath),
+      "utf-8"
+    );
+  } else {
+    actualRuntimeBytecode = await hre.ethers.provider.getCode(contractAddress);
+  }
+
+  const contractArtifact = getContractArtifact(contractName, artifactType);
+  const expectedCreationBytecode = contractArtifact.creationBytecode;
+  let expectedRuntimeBytecode = contractArtifact.runtimeBytecode;
+  const creationLinkReferences = contractArtifact.creationLinkReferences;
+  const runtimeLinkReferences = contractArtifact.runtimeLinkReferences;
+
+  // ==== Compare constructor code between contract on chain and locally compiled version
+  if (contractCreationTxHash) {
+    const actualCreationBytecode = await getContractCreationBytecode(
+      hre,
+      contractAddress,
+      contractCreationTxHash,
+      useTracesForCreationBytecode
+    );
+    const constructorCodeEndIndex = getConstructorCodeEndIndex(
+      expectedCreationBytecode,
+      expectedRuntimeBytecode,
+      libraryName,
+      creationLinkReferences,
+      runtimeLinkReferences
+    );
+
+    bytecodeComparisonResults.push({
+      type: BytecodeInputType.ConstructorCode,
+      equal:
+        // actual bytecode on chain
+        actualCreationBytecode.slice(0, constructorCodeEndIndex) ===
+        // expected bytecode from local compilation
+        expectedCreationBytecode.slice(0, constructorCodeEndIndex),
+    });
+  }
+
+  // ==== Replace embedded address in library contracts
+  // Library contract bytecode changes at deploy time. The contract address is embedded after the first push instruction
+  // https://docs.soliditylang.org/en/develop/contracts.html#call-protection-for-libraries
+  if (isLibrary) {
+    // Replace bytecode (4, 44) with contract address
+    const firstInstructionLength = 4;
+    expectedRuntimeBytecode =
+      expectedRuntimeBytecode.slice(0, firstInstructionLength) +
+      contractAddress.toLowerCase().slice(2) +
+      expectedRuntimeBytecode.slice(
+        firstInstructionLength + contractAddress.slice(2).length
+      );
+  }
+
+  // ==== For contracts that use external libraries, replace embedded library address with locally compiled bytecode with actual library addresses from user input.
+  if (libraryName && libraryAddress) {
+    const libraryReferencePositions: {
+      length: number;
+      start: number;
+    }[] = _.chain(runtimeLinkReferences)
+      .values()
+      .map(Object.entries)
+      .flatten()
+      .fromPairs()
+      .get(libraryName)
+      .value();
+
+    for (const position of libraryReferencePositions) {
+      const replacement = libraryAddress
+        .slice(2, 2 + position["length"] * 2)
+        .toLowerCase();
+      expectedRuntimeBytecode =
+        expectedRuntimeBytecode.slice(0, 2 + position.start * 2) +
+        replacement +
+        expectedRuntimeBytecode.slice(
+          2 + position.start * 2 + position["length"] * 2
+        );
+    }
+  }
+
+  // ==== Compare runtime bytecode
+  if (verificationType === BytecodeVerificationType.Full) {
+    bytecodeComparisonResults.push({
+      type: BytecodeInputType.RuntimeBytecodeFull,
+      equal: expectedRuntimeBytecode === actualRuntimeBytecode,
+    });
+  } else {
+    bytecodeComparisonResults.push({
+      type: BytecodeInputType.RuntimeBytecodePartial,
+      equal:
+        removeMetadataHashAndMetadataLen(actualRuntimeBytecode) ===
+        removeMetadataHashAndMetadataLen(expectedRuntimeBytecode),
+    });
+  }
+
+  // ==== Compare user-supplied metadata file against metadata hash in deployed bytecode
+  if (metadataFilePath) {
+    const rawMetadata = readFileSync(
+      path.join(__dirname, "..", "..", metadataFilePath),
+      "utf-8"
+    );
+    const metadataHash = await Hash.of(rawMetadata); // the library output is bs58 encoded by default
+    const expectedMetadataHash = Buffer.from(
+      bs58.decode(metadataHash)
+    ).toString("hex");
+
+    const actualMetadataHash = getCborDecodedIpfsHash(actualRuntimeBytecode);
+
+    bytecodeComparisonResults.push({
+      type: BytecodeInputType.MetadataHash,
+      equal: expectedMetadataHash === actualMetadataHash,
+    });
+  }
+
+  return bytecodeComparisonResults;
+}
+
+export function logBytecodeComparisonResults(
+  results: BytecodeComparisonResult[]
+): void {
+  for (const { type, equal } of results) {
+    if (!equal) {
+      console.warn(
+        "\x1b[31m",
+        `\nWARNING: verification failed - ${type} mismatch.`
+      );
+    } else {
+      console.log(
+        "\x1b[32m",
+        `\nverification complete - supplied ${type} is consistent with local version.`
+      );
+    }
+  }
+}
+
+/**
+ * Returns contract creation bytecode
+ */
+async function getContractCreationBytecode(
+  hre: HardhatRuntimeEnvironment,
+  contractAddress: string,
+  contractCreationTxHash: string,
+  useTracesForCreationBytecode: boolean | undefined
+): Promise<string> {
+  if (useTracesForCreationBytecode) {
+    const transactionTraces: GethTransactionTrace = await hre.ethers.provider.send(
+      "debug_traceTransaction",
+      [contractCreationTxHash, { tracer: "callTracer" }]
+    );
+    return extractBytecodeFromGethTraces(transactionTraces, contractAddress);
+  }
+  const transaction = await hre.ethers.provider.getTransaction(
+    contractCreationTxHash
+  );
+  if (transaction == null) {
+    throw new Error("Transaction not found");
+  }
+  return transaction.data;
+}
+
+/**
+ * Returns contract creation bytecode given traces
+ */
+export function extractBytecodeFromGethTraces(
+  traces: GethTransactionTrace,
+  targetContract: string
+): string {
+  if (
+    traces.to.toLowerCase() === targetContract.toLowerCase() &&
+    (traces.type === "CREATE" || traces.type === "CREATE2")
+  ) {
+    return traces.input;
+  }
+  if (traces.calls) {
+    for (const call of traces.calls) {
+      return extractBytecodeFromGethTraces(call, targetContract);
+    }
+  }
+  throw new Error("Contract creation trace not found");
+}
+
+/**
+ * Returns contract artifact
+ */
+function getContractArtifact(
+  contractName: string,
+  artifactType: ArtifactType | undefined
+): ContractArtifact {
+  if (artifactType !== undefined) {
+    return getAlternativeArtifact(contractName, artifactType);
+  }
+  // Getting locally compiled bytecode
+  const foundryContractArtifact = JSON.parse(
+    readFileSync(
+      path.join(
+        __dirname,
+        "..",
+        "..",
+        "artifacts",
+        "foundry",
+        `${contractName}.sol`,
+        `${contractName}.json`
+      ),
+      "utf-8"
+    )
+  );
+
+  return {
+    creationBytecode: foundryContractArtifact.bytecode.object,
+    runtimeBytecode: foundryContractArtifact.deployedBytecode.object,
+    creationLinkReferences: foundryContractArtifact.bytecode.linkReferences,
+    runtimeLinkReferences:
+      foundryContractArtifact.deployedBytecode.linkReferences,
+  };
+}
+
+/**
+ * Returns contract artifact from the static alternative artifacts
+ */
+function getAlternativeArtifact(
+  contractName: string,
+  artifactType: ArtifactType
+): ContractArtifact {
+  if (!Object.values(ArtifactType).includes(artifactType)) {
+    throw new Error(`artifact type ${artifactType} not supported`);
+  }
+  const alternativeArtifactContracts = alternativeArtifacts.get(
+    artifactType as ArtifactType
+  );
+  if (alternativeArtifactContracts === undefined) {
+    throw new Error(`artifacts not found for artifact type ${artifactType}`);
+  }
+  const contractArtifact = alternativeArtifactContracts.get(contractName);
+  if (contractArtifact === undefined) {
+    throw new Error(
+      `artifact not found for contract ${contractName} for artifact type ${artifactType}`
+    );
+  }
+
+  return contractArtifact;
+}
+
+/**
+ * Strips the metadata hash bytes from a contract's runtime bytecode. The hash is cbor-encoded and must
+ * be decoded to reveal the ipfs hash stored in the object.
+ *
+ * NOTE: This function only works for bytecode that are generated with "settings.metadata.bytecodeHash"
+ * set to default of "ipfs".
+ * @see {@link https://docs.soliditylang.org/en/latest/metadata.html#encoding-of-the-metadata-hash-in-the-bytecode}
+ * for information about the metadata hash.
+ */
+function getCborDecodedIpfsHash(runtimeBytecode: string): string {
+  const metadataLength = getContractMetadataLength(runtimeBytecode);
+  const cborBytes = runtimeBytecode.slice(
+    runtimeBytecode.length - metadataLength,
+    runtimeBytecode.length - 4
+  );
+  const decodedCborBytes = decode(Buffer.from(cborBytes, "hex"));
+  if (!decodedCborBytes.ipfs) {
+    throw new Error(
+      "IPFS hash not detected. Metadata uploaded via alternative methods."
+    );
+  }
+  return decodedCborBytes.ipfs.toString("hex");
+}
+
+/**
+ * Returns contract runtime bytecode after the metadata hash has been stripped.
+ */
+function removeMetadataHashAndMetadataLen(runtimeBytecode: string): string {
+  const metadataLength = getContractMetadataLength(runtimeBytecode);
+  return runtimeBytecode.slice(0, runtimeBytecode.length - metadataLength);
+}
+
+/**
+ * Read last 4 digits of the contract runtime bytecode to determine the full length of the metadata hash
+ */
+function getContractMetadataLength(runtimeBytecode: string): number {
+  // Read the last two bytes to determine the length of the CBOR encoding
+  // https://docs.soliditylang.org/en/develop/metadata.html#encoding-of-the-metadata-hash-in-the-bytecode
+  const metadataLengthHex = runtimeBytecode.slice(
+    runtimeBytecode.length - 4,
+    runtimeBytecode.length
+  );
+
+  const metadataNumBytes = parseInt(metadataLengthHex, 16);
+  return metadataNumBytes * 2 + metadataLengthHex.length;
+}
+
+/**
+ * Retrieves the index in the creation bytecode that partitions the constructor_code
+ * from the rest of the creation bytecode
+ *
+ * @returns {number} The last index in the creation bytecode that describes the constructor_code
+ */
+function getConstructorCodeEndIndex(
+  creationBytecode: string,
+  runtimeBytecode: string,
+  libraryName: string | undefined,
+  creationLinkReferences: LinkReferences,
+  runtimeLinkReferences: LinkReferences
+): number {
+  let constructorCodeEndIndex = -1;
+
+  if (!libraryName) {
+    // If the contract does not use external library contracts, the runtime bytecode should be a part of
+    // the contract creation code
+    constructorCodeEndIndex = creationBytecode.indexOf(
+      removeMetadataHashAndMetadataLen(runtimeBytecode).slice(2) // Remove "0x" at the beginning and metadata hash at end
+    );
+  } else {
+    // If the contract does reference a library contract, we can use the 1st library position as an anchor
+    // in the creation and runtime bytecode to align them. By shifting the cursor on the creation bytecode
+    // forward by length of the 1st library position, we should get the last index of the constructor code.
+    const getFirstLibStart = (linkReferences: LinkReferences): number => {
+      if (!linkReferences) {
+        throw new Error("Library link reference object is empty.");
+      }
+      const values = Object.values(linkReferences)[0];
+      const libRefs = values[libraryName];
+      if (!libRefs || !libRefs.length) {
+        throw new Error(`References to ${libraryName} library not found.`);
+      }
+      const startIndices: number[] = libRefs.map((a) => a.start);
+      return Math.min(...startIndices);
+    };
+    constructorCodeEndIndex =
+      (getFirstLibStart(creationLinkReferences) -
+        getFirstLibStart(runtimeLinkReferences)) *
+      2;
+  }
+  return constructorCodeEndIndex;
+}
diff --git a/scripts/verifyBridgedTokenBytecode.ts b/scripts/verifyBridgedTokenBytecode.ts
new file mode 100644
index 000000000..a42e57d2c
--- /dev/null
+++ b/scripts/verifyBridgedTokenBytecode.ts
@@ -0,0 +1,244 @@
+/**
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import fs from "fs";
+import path from "path";
+import {
+  logBytecodeComparisonResults,
+  TaskArguments as VerifyOnChainBytecodeTaskArguments,
+  verifyOnChainBytecode,
+  BytecodeVerificationType,
+} from "./hardhat/verifyOnChainBytecode";
+import hre from "hardhat";
+import { HttpNetworkConfig } from "hardhat/types";
+import { ethers } from "ethers";
+import { ArtifactType } from "./hardhat/alternativeArtifacts";
+import { validateOptimizerRuns } from "./hardhat/helpers";
+
+type ContractInput = {
+  contractAddress: string;
+  contractCreationTxHash: string;
+  metadataFilePath: string;
+  verificationType?: BytecodeVerificationType;
+  artifactType?: ArtifactType;
+  useTracesForCreationBytecode?: boolean;
+  optimizerRuns?: number;
+};
+
+type InputObject = {
+  SignatureChecker: ContractInput;
+  FiatTokenV2_2: ContractInput;
+  FiatTokenProxy: ContractInput;
+  rpcUrl: string;
+};
+
+const VERIFICATION_ARTIFACTS_DIR = path.join(
+  __dirname,
+  "..",
+  "verification_artifacts"
+);
+
+async function main() {
+  const inputFilePath = path.join(VERIFICATION_ARTIFACTS_DIR, "input.json");
+
+  if (!fs.existsSync(inputFilePath)) {
+    throw new Error(
+      "No input files found. Please check your directory name and file name to make sure it is verification_artifacts/input.json"
+    );
+  }
+
+  if (hre.network.name !== "mainnet") {
+    throw new Error("Hardhat network must be set to 'mainnet'!");
+  }
+
+  let failedVerification = 0;
+  const input = validateInput(inputFilePath);
+  (hre.network.config as HttpNetworkConfig).url = input.rpcUrl;
+
+  const taskArgs = transformInputToVerifyOnChainBytecodeTaskArguments(input);
+  for (const taskArg of taskArgs) {
+    console.log(`\n Verifying on chain bytecode for: ${taskArg.contractName}`);
+    const results = await verifyOnChainBytecode(taskArg, hre);
+    logBytecodeComparisonResults(results);
+
+    for (const { equal } of results) {
+      if (!equal) {
+        failedVerification++;
+      }
+    }
+  }
+
+  if (failedVerification > 0) {
+    throw new Error("One or more verifications failed");
+  }
+}
+
+function validateInput(filename: string): InputObject {
+  const input = JSON.parse(fs.readFileSync(filename, "utf-8"));
+  if (
+    !input.SignatureChecker ||
+    !input.FiatTokenV2_2 ||
+    !input.FiatTokenProxy ||
+    !input.rpcUrl
+  ) {
+    throw new Error("Missing fields in input file!");
+  }
+  try {
+    // Formats a URL string. Throws a TypeError if the URL string is malformed.
+    input.rpcUrl = new URL(input.rpcUrl).toString();
+  } catch (e) {
+    throw new Error("Invalid URL!");
+  }
+  for (const key of ["SignatureChecker", "FiatTokenV2_2", "FiatTokenProxy"]) {
+    const value = input[key];
+    // Ensure all required fields exist
+    if (!value.contractAddress || !value.contractCreationTxHash) {
+      throw new Error(`Contract config for ${key} contains empty fields`);
+    }
+    // Validate contractAddress (must be a 20-byte address)
+    if (!ethers.isAddress(value.contractAddress)) {
+      throw new Error(
+        `Invalid contractAddress for ${key}: ${value.contractAddress}`
+      );
+    }
+    // Validate contractCreationTxHash (must be a 32-byte hash)
+    if (!ethers.isHexString(value.contractCreationTxHash, 32)) {
+      throw new Error(
+        `Invalid contractCreationTxHash for ${key}: ${value.contractCreationTxHash}`
+      );
+    }
+    // Validate verificationType if present
+    if (
+      value.verificationType !== undefined &&
+      !Object.values(BytecodeVerificationType).includes(value.verificationType)
+    ) {
+      throw new Error(
+        `Invalid verificationType for ${key}: ${value.verificationType}`
+      );
+    }
+    // Validate artifactType if present
+    if (
+      value.artifactType !== undefined &&
+      !Object.values(ArtifactType).includes(value.artifactType)
+    ) {
+      throw new Error(`Invalid artifactType for ${key}: ${value.artifactType}`);
+    }
+    // Validate useTracesForCreationBytecode if present
+    if (
+      value.useTracesForCreationBytecode !== undefined &&
+      typeof value.useTracesForCreationBytecode !== "boolean"
+    ) {
+      throw new Error(
+        `Invalid useTracesForCreationBytecode for ${key}: ${value.useTracesForCreationBytecode}`
+      );
+    }
+    // Validate optimizerRuns if present
+    if (value.optimizerRuns !== undefined) {
+      try {
+        validateOptimizerRuns(value.optimizerRuns);
+      } catch (e) {
+        throw new Error(
+          `Invalid optimizerRuns for ${key}: ${value.optimizerRuns}`
+        );
+      }
+    }
+
+    // If verification type isn't "full," validate metadataFilePath (file must exist)
+    if (value.verificationType !== BytecodeVerificationType.Full) {
+      const metadataFilePath = path.join(
+        VERIFICATION_ARTIFACTS_DIR,
+        `${key}.json`
+      );
+      if (!fs.existsSync(metadataFilePath)) {
+        throw new Error(
+          `Invalid metadataFilePath for ${key}: File does not exist`
+        );
+      }
+    }
+  }
+
+  return input as InputObject;
+}
+
+function transformInputToVerifyOnChainBytecodeTaskArguments(
+  input: InputObject
+): VerifyOnChainBytecodeTaskArguments[] {
+  // Impl Contract
+  const taskArgsImpl: VerifyOnChainBytecodeTaskArguments = {
+    contractName: "FiatTokenV2_2",
+    contractAddress: input.FiatTokenV2_2.contractAddress,
+    libraryName: "SignatureChecker",
+    libraryAddress: input.SignatureChecker.contractAddress,
+    isLibrary: false,
+    verificationType:
+      input.FiatTokenV2_2.verificationType || BytecodeVerificationType.Partial,
+    metadataFilePath:
+      input.FiatTokenV2_2.verificationType === BytecodeVerificationType.Full
+        ? undefined
+        : "verification_artifacts/FiatTokenV2_2.json",
+    contractCreationTxHash: input.FiatTokenV2_2.contractCreationTxHash,
+    useTracesForCreationBytecode:
+      input.FiatTokenV2_2.useTracesForCreationBytecode,
+    artifactType: input.FiatTokenV2_2.artifactType,
+    optimizerRuns: input.FiatTokenV2_2.optimizerRuns,
+  };
+
+  // Proxy
+  const taskArgsProxy: VerifyOnChainBytecodeTaskArguments = {
+    contractName: "FiatTokenProxy",
+    contractAddress: input.FiatTokenProxy.contractAddress,
+    isLibrary: false,
+    verificationType:
+      input.FiatTokenProxy.verificationType || BytecodeVerificationType.Partial,
+    metadataFilePath:
+      input.FiatTokenProxy.verificationType === BytecodeVerificationType.Full
+        ? undefined
+        : "verification_artifacts/FiatTokenProxy.json",
+    contractCreationTxHash: input.FiatTokenProxy.contractCreationTxHash,
+    useTracesForCreationBytecode:
+      input.FiatTokenProxy.useTracesForCreationBytecode,
+    artifactType: input.FiatTokenProxy.artifactType,
+    optimizerRuns: input.FiatTokenProxy.optimizerRuns,
+  };
+
+  // Signature Checker
+  const taskArgsLib: VerifyOnChainBytecodeTaskArguments = {
+    contractName: "SignatureChecker",
+    contractAddress: input.SignatureChecker.contractAddress,
+    isLibrary: true,
+    verificationType:
+      input.SignatureChecker.verificationType ||
+      BytecodeVerificationType.Partial,
+    metadataFilePath:
+      input.SignatureChecker.verificationType === BytecodeVerificationType.Full
+        ? undefined
+        : "verification_artifacts/SignatureChecker.json",
+    contractCreationTxHash: input.SignatureChecker.contractCreationTxHash,
+    useTracesForCreationBytecode:
+      input.SignatureChecker.useTracesForCreationBytecode,
+    artifactType: input.SignatureChecker.artifactType,
+    optimizerRuns: input.SignatureChecker.optimizerRuns,
+  };
+
+  return [taskArgsImpl, taskArgsProxy, taskArgsLib];
+}
+
+main().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});
diff --git a/setup.sh b/setup.sh
index ab98bd0bd..0cd48f04e 100755
--- a/setup.sh
+++ b/setup.sh
@@ -1,6 +1,6 @@
 #!/bin/bash
 #
-# Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+# Copyright 2024 Circle Internet Group, Inc. All rights reserved.
 #
 # SPDX-License-Identifier: Apache-2.0
 #
diff --git a/test/helpers/constants.ts b/test/helpers/constants.ts
index ecb34da81..1328aac48 100644
--- a/test/helpers/constants.ts
+++ b/test/helpers/constants.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/helpers/index.ts b/test/helpers/index.ts
index abf1c1e59..f9c3e3b66 100644
--- a/test/helpers/index.ts
+++ b/test/helpers/index.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/helpers/storageSlots.behavior.ts b/test/helpers/storageSlots.behavior.ts
index 88b882b50..f0f0921cf 100644
--- a/test/helpers/storageSlots.behavior.ts
+++ b/test/helpers/storageSlots.behavior.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/minting/AccountUtils.js b/test/minting/AccountUtils.js
index c3d93a668..b41b7e328 100644
--- a/test/minting/AccountUtils.js
+++ b/test/minting/AccountUtils.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/minting/ControllerTestUtils.js b/test/minting/ControllerTestUtils.js
index 6a3dcb093..f2ccf3cce 100644
--- a/test/minting/ControllerTestUtils.js
+++ b/test/minting/ControllerTestUtils.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -21,9 +21,11 @@ const Q = require("q");
 const { ZERO_ADDRESS } = require("../helpers/constants");
 const AccountUtils = require("./AccountUtils.js");
 const Accounts = AccountUtils.Accounts;
-const setAccountDefault = AccountUtils.setAccountDefault;
-const checkState = AccountUtils.checkState;
-const getAccountState = AccountUtils.getAccountState;
+const {
+  setAccountDefault,
+  checkState,
+  getAccountState,
+} = require("./AccountUtils.js");
 
 function ControllerState(owner, controllers) {
   this.owner = owner;
diff --git a/test/minting/MintControllerTests.js b/test/minting/MintControllerTests.js
index 888c95c7d..9ff2e2283 100644
--- a/test/minting/MintControllerTests.js
+++ b/test/minting/MintControllerTests.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -18,12 +18,13 @@
 
 const MintController = artifacts.require("minting/MintController");
 
-const tokenUtils = require("../v1/TokenTestUtils.js");
-const newBigNumber = tokenUtils.newBigNumber;
-const checkMINTp0 = tokenUtils.checkMINTp0;
-const expectRevert = tokenUtils.expectRevert;
-const expectError = tokenUtils.expectError;
-const bigZero = tokenUtils.bigZero;
+const {
+  newBigNumber,
+  checkMINTp0,
+  expectRevert,
+  expectError,
+  bigZero,
+} = require("../v1/helpers/tokenTest.js");
 
 const { cloneDeep } = require("lodash");
 
diff --git a/test/minting/MintControllerUtils.js b/test/minting/MintControllerUtils.js
index 9c5c52b0b..3d35ce02e 100644
--- a/test/minting/MintControllerUtils.js
+++ b/test/minting/MintControllerUtils.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -16,9 +16,10 @@
  * limitations under the License.
  */
 
-const tokenUtils = require("../v1/TokenTestUtils.js");
-const bigZero = tokenUtils.bigZero;
-const initializeTokenWithProxy = tokenUtils.initializeTokenWithProxy;
+const {
+  bigZero,
+  initializeTokenWithProxy,
+} = require("../v1/helpers/tokenTest.js");
 
 const AccountUtils = require("./AccountUtils.js");
 const Accounts = AccountUtils.Accounts;
diff --git a/test/minting/MintP0_ArgumentTests.js b/test/minting/MintP0_ArgumentTests.js
index fb5816a52..81c004cb6 100644
--- a/test/minting/MintP0_ArgumentTests.js
+++ b/test/minting/MintP0_ArgumentTests.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -21,12 +21,13 @@ const MasterMinter = artifacts.require("minting/MasterMinter");
 const FiatToken = artifacts.require("FiatTokenV1");
 
 const { MAX_UINT256_HEX, ZERO_ADDRESS } = require("../helpers/constants");
-const tokenUtils = require("../v1/TokenTestUtils");
-const newBigNumber = tokenUtils.newBigNumber;
-const checkMINTp0 = tokenUtils.checkMINTp0;
-const expectRevert = tokenUtils.expectRevert;
-const expectError = tokenUtils.expectError;
-const bigZero = tokenUtils.bigZero;
+const {
+  newBigNumber,
+  checkMINTp0,
+  expectRevert,
+  expectError,
+  bigZero,
+} = require("../v1/helpers/tokenTest.js");
 
 const { cloneDeep } = require("lodash");
 
diff --git a/test/minting/MintP0_BasicTests.js b/test/minting/MintP0_BasicTests.js
index cf2fc78c3..59dfe08e7 100644
--- a/test/minting/MintP0_BasicTests.js
+++ b/test/minting/MintP0_BasicTests.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -21,23 +21,24 @@ const MintController = artifacts.require("minting/MintController");
 const MasterMinter = artifacts.require("minting/MasterMinter");
 const FiatToken = artifacts.require("FiatTokenV1");
 
-const tokenUtils = require("../v1/TokenTestUtils.js");
-const newBigNumber = tokenUtils.newBigNumber;
-const checkMINTp0 = tokenUtils.checkMINTp0;
-const expectRevert = tokenUtils.expectRevert;
-const expectError = tokenUtils.expectError;
-const bigZero = tokenUtils.bigZero;
+const {
+  newBigNumber,
+  checkMINTp0,
+  expectRevert,
+  expectError,
+  bigZero,
+} = require("../v1/helpers/tokenTest.js");
 
 const { cloneDeep } = require("lodash");
 
 const mintUtils = require("./MintControllerUtils.js");
 const AccountUtils = require("./AccountUtils.js");
 const Accounts = AccountUtils.Accounts;
-const getAccountState = AccountUtils.getAccountState;
-const addressEquals = AccountUtils.addressEquals;
 const initializeTokenWithProxyAndMintController =
   mintUtils.initializeTokenWithProxyAndMintController;
 
+const { getAccountState, addressEquals } = require("./AccountUtils.js");
+
 async function run_tests_MintController(newToken, accounts) {
   run_MINT_tests(newToken, MintController, accounts);
 }
diff --git a/test/minting/MintP0_EndToEndTests.js b/test/minting/MintP0_EndToEndTests.js
index 1e31d9204..43072f4cb 100644
--- a/test/minting/MintP0_EndToEndTests.js
+++ b/test/minting/MintP0_EndToEndTests.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -19,17 +19,18 @@
 const MintController = artifacts.require("minting/MintController");
 const MasterMinter = artifacts.require("minting/MasterMinter");
 
-const tokenUtils = require("../v1/TokenTestUtils.js");
-const newBigNumber = tokenUtils.newBigNumber;
-const checkMINTp0 = tokenUtils.checkMINTp0;
-const expectRevert = tokenUtils.expectRevert;
-const expectError = tokenUtils.expectError;
-const initializeTokenWithProxy = tokenUtils.initializeTokenWithProxy;
+const {
+  newBigNumber,
+  checkMINTp0,
+  expectRevert,
+  expectError,
+  initializeTokenWithProxy,
+} = require("../v1/helpers/tokenTest.js");
 
 const { cloneDeep } = require("lodash");
 
-const mintUtils = require("../minting/MintControllerUtils.js");
-const AccountUtils = require("../minting/AccountUtils.js");
+const mintUtils = require("./MintControllerUtils.js");
+const AccountUtils = require("./AccountUtils.js");
 const Accounts = AccountUtils.Accounts;
 const initializeTokenWithProxyAndMintController =
   mintUtils.initializeTokenWithProxyAndMintController;
diff --git a/test/minting/MintP0_EventsTests.js b/test/minting/MintP0_EventsTests.js
index 7bdb389c3..f97016630 100644
--- a/test/minting/MintP0_EventsTests.js
+++ b/test/minting/MintP0_EventsTests.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/misc/gas.ts b/test/misc/gas.ts
index 2650f45d9..d9de62269 100644
--- a/test/misc/gas.ts
+++ b/test/misc/gas.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/misc/publicToExternal.test.ts b/test/misc/publicToExternal.test.ts
index 4a50e289f..9f604050b 100644
--- a/test/misc/publicToExternal.test.ts
+++ b/test/misc/publicToExternal.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/scripts/deploy/TestUtils.sol b/test/scripts/deploy/TestUtils.sol
index 6dc6ed936..36b78617a 100644
--- a/test/scripts/deploy/TestUtils.sol
+++ b/test/scripts/deploy/TestUtils.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/scripts/deploy/celo/deploy-fee-adapter.t.sol b/test/scripts/deploy/celo/deploy-fee-adapter.t.sol
index 13057f810..38b1de2b4 100644
--- a/test/scripts/deploy/celo/deploy-fee-adapter.t.sol
+++ b/test/scripts/deploy/celo/deploy-fee-adapter.t.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/scripts/deploy/celo/deploy-fiat-token-celo.t.sol b/test/scripts/deploy/celo/deploy-fiat-token-celo.t.sol
index c222b14a6..a235c5dc0 100644
--- a/test/scripts/deploy/celo/deploy-fiat-token-celo.t.sol
+++ b/test/scripts/deploy/celo/deploy-fiat-token-celo.t.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/scripts/deploy/deploy-fiat-token.t.sol b/test/scripts/deploy/deploy-fiat-token.t.sol
index 2c81c96fb..58d260b2f 100644
--- a/test/scripts/deploy/deploy-fiat-token.t.sol
+++ b/test/scripts/deploy/deploy-fiat-token.t.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/scripts/deploy/deploy-impl-and-upgrader.t.sol b/test/scripts/deploy/deploy-impl-and-upgrader.t.sol
index 35f460680..a1ebe9936 100644
--- a/test/scripts/deploy/deploy-impl-and-upgrader.t.sol
+++ b/test/scripts/deploy/deploy-impl-and-upgrader.t.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/scripts/deploy/deploy-master-minter.t.sol b/test/scripts/deploy/deploy-master-minter.t.sol
index 9278f3c28..b1594966a 100644
--- a/test/scripts/deploy/deploy-master-minter.t.sol
+++ b/test/scripts/deploy/deploy-master-minter.t.sol
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/scripts/hardhat/testData/FiatTokenProxy.bin b/test/scripts/hardhat/testData/FiatTokenProxy.bin
new file mode 100644
index 000000000..51385135d
--- /dev/null
+++ b/test/scripts/hardhat/testData/FiatTokenProxy.bin
@@ -0,0 +1 @@
+0x60806040526004361061005a5760003560e01c80635c60da1b116100435780635c60da1b146101315780638f2839701461016f578063f851a440146101af5761005a565b80633659cfe6146100645780634f1ef286146100a4575b6100626101c4565b005b34801561007057600080fd5b506100626004803603602081101561008757600080fd5b503573ffffffffffffffffffffffffffffffffffffffff166101de565b610062600480360360408110156100ba57600080fd5b73ffffffffffffffffffffffffffffffffffffffff82351691908101906040810160208201356401000000008111156100f257600080fd5b82018360208201111561010457600080fd5b8035906020019184600183028401116401000000008311171561012657600080fd5b509092509050610232565b34801561013d57600080fd5b50610146610309565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b34801561017b57600080fd5b506100626004803603602081101561019257600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610318565b3480156101bb57600080fd5b50610146610420565b6101cc610430565b6101dc6101d76104c4565b6104e9565b565b6101e661050d565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102275761022281610532565b61022f565b61022f6101c4565b50565b61023a61050d565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102fc5761027683610532565b60003073ffffffffffffffffffffffffffffffffffffffff16348484604051808383808284376040519201945060009350909150508083038185875af1925050503d80600081146102e3576040519150601f19603f3d011682016040523d82523d6000602084013e6102e8565b606091505b50509050806102f657600080fd5b50610304565b6103046101c4565b505050565b60006103136104c4565b905090565b61032061050d565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156102275773ffffffffffffffffffffffffffffffffffffffff81166103bf576040517f08c379a00000000000000000000000000000000000000000000000000000000081526004018080602001828103825260368152602001806106606036913960400191505060405180910390fd5b7f7e644d79422f17c01e4894b5f4f588d331ebfa28653d42ae832dc59e38c9798f6103e861050d565b6040805173ffffffffffffffffffffffffffffffffffffffff928316815291841660208301528051918290030190a161022281610587565b600061031361050d565b3b151590565b61043861050d565b73ffffffffffffffffffffffffffffffffffffffff163373ffffffffffffffffffffffffffffffffffffffff1614156104bc576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252603281526020018061062e6032913960400191505060405180910390fd5b6101dc6101dc565b7f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c35490565b3660008037600080366000845af43d6000803e808015610508573d6000f35b3d6000fd5b7f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b5490565b61053b816105ab565b6040805173ffffffffffffffffffffffffffffffffffffffff8316815290517fbc7cd75a20ee27fd9adebab32041f755214dbc6bffa90cc0225b39da2e5c2d3b9181900360200190a150565b7f10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b55565b6105b48161042a565b610609576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252603b815260200180610696603b913960400191505060405180910390fd5b7f7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c35556fe43616e6e6f742063616c6c2066616c6c6261636b2066756e6374696f6e2066726f6d207468652070726f78792061646d696e43616e6e6f74206368616e6765207468652061646d696e206f6620612070726f787920746f20746865207a65726f206164647265737343616e6e6f742073657420612070726f787920696d706c656d656e746174696f6e20746f2061206e6f6e2d636f6e74726163742061646472657373a26469706673582212206f00cbbebd342a531f03db15fd5aaf4b2dc16ecb732f35d416c34bfb2649860764736f6c634300060c0033
\ No newline at end of file
diff --git a/test/scripts/hardhat/testData/FiatTokenProxy.metadata.json b/test/scripts/hardhat/testData/FiatTokenProxy.metadata.json
new file mode 100644
index 000000000..f0d74ee12
--- /dev/null
+++ b/test/scripts/hardhat/testData/FiatTokenProxy.metadata.json
@@ -0,0 +1,231 @@
+{
+  "compiler": {
+    "version": "0.6.12+commit.27d51765"
+  },
+  "language": "Solidity",
+  "output": {
+    "abi": [
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "implementationContract",
+            "type": "address"
+          }
+        ],
+        "stateMutability": "nonpayable",
+        "type": "constructor"
+      },
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "previousAdmin",
+            "type": "address",
+            "indexed": false
+          },
+          {
+            "internalType": "address",
+            "name": "newAdmin",
+            "type": "address",
+            "indexed": false
+          }
+        ],
+        "type": "event",
+        "name": "AdminChanged",
+        "anonymous": false
+      },
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "implementation",
+            "type": "address",
+            "indexed": false
+          }
+        ],
+        "type": "event",
+        "name": "Upgraded",
+        "anonymous": false
+      },
+      {
+        "inputs": [],
+        "stateMutability": "payable",
+        "type": "fallback"
+      },
+      {
+        "inputs": [],
+        "stateMutability": "view",
+        "type": "function",
+        "name": "admin",
+        "outputs": [
+          {
+            "internalType": "address",
+            "name": "",
+            "type": "address"
+          }
+        ]
+      },
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "newAdmin",
+            "type": "address"
+          }
+        ],
+        "stateMutability": "nonpayable",
+        "type": "function",
+        "name": "changeAdmin"
+      },
+      {
+        "inputs": [],
+        "stateMutability": "view",
+        "type": "function",
+        "name": "implementation",
+        "outputs": [
+          {
+            "internalType": "address",
+            "name": "",
+            "type": "address"
+          }
+        ]
+      },
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "newImplementation",
+            "type": "address"
+          }
+        ],
+        "stateMutability": "nonpayable",
+        "type": "function",
+        "name": "upgradeTo"
+      },
+      {
+        "inputs": [
+          {
+            "internalType": "address",
+            "name": "newImplementation",
+            "type": "address"
+          },
+          {
+            "internalType": "bytes",
+            "name": "data",
+            "type": "bytes"
+          }
+        ],
+        "stateMutability": "payable",
+        "type": "function",
+        "name": "upgradeToAndCall"
+      }
+    ],
+    "devdoc": {
+      "kind": "dev",
+      "methods": {
+        "admin()": {
+          "returns": {
+            "_0": "The address of the proxy admin."
+          }
+        },
+        "changeAdmin(address)": {
+          "details": "Changes the admin of the proxy. Only the current admin can call this function.",
+          "params": {
+            "newAdmin": "Address to transfer proxy administration to."
+          }
+        },
+        "implementation()": {
+          "returns": {
+            "_0": "The address of the implementation."
+          }
+        },
+        "upgradeTo(address)": {
+          "details": "Upgrade the backing implementation of the proxy. Only the admin can call this function.",
+          "params": {
+            "newImplementation": "Address of the new implementation."
+          }
+        },
+        "upgradeToAndCall(address,bytes)": {
+          "details": "Upgrade the backing implementation of the proxy and call a function on the new implementation. This is useful to initialize the proxied contract.",
+          "params": {
+            "data": "Data to send as msg.data in the low level call. It should include the signature and the parameters of the function to be called, as described in https://solidity.readthedocs.io/en/develop/abi-spec.html#function-selector-and-argument-encoding.",
+            "newImplementation": "Address of the new implementation."
+          }
+        }
+      },
+      "version": 1
+    },
+    "userdoc": {
+      "kind": "user",
+      "methods": {},
+      "version": 1
+    }
+  },
+  "settings": {
+    "remappings": [
+      "@ensdomains/=node_modules/@ensdomains/",
+      "@openzeppelin/=node_modules/@openzeppelin/",
+      "@solidity-parser/=node_modules/prettier-plugin-solidity/node_modules/@solidity-parser/",
+      "ds-test/=lib/forge-std/lib/ds-test/src/",
+      "eth-gas-reporter/=node_modules/eth-gas-reporter/",
+      "forge-std/=lib/forge-std/src/",
+      "hardhat/=node_modules/hardhat/"
+    ],
+    "optimizer": {
+      "enabled": true,
+      "runs": 10000000
+    },
+    "metadata": {
+      "bytecodeHash": "ipfs"
+    },
+    "compilationTarget": {
+      "contracts/v1/FiatTokenProxy.sol": "FiatTokenProxy"
+    },
+    "evmVersion": "istanbul",
+    "libraries": {}
+  },
+  "sources": {
+    "contracts/upgradeability/AdminUpgradeabilityProxy.sol": {
+      "keccak256": "0x709d23a3d4b34a43861d099ec8c3f964c933f45bf30ee08c98a569433114c599",
+      "urls": [
+        "bzz-raw://97ec753a4c2cf21c11daccde7727b3343bedfe985b7299ddb86b91b641c6bb8e",
+        "dweb:/ipfs/QmRerVbjv74Yx4Pa26am82cAMDyMXzka1oE9YnrQtGwkd7"
+      ],
+      "license": "Apache-2.0"
+    },
+    "contracts/upgradeability/Proxy.sol": {
+      "keccak256": "0x27eb2c0719a143aafc9f7f1fa39ef225baa0ad667bcd5f90cd1e4abcc89f4c20",
+      "urls": [
+        "bzz-raw://90cc41dbda5503142c6742a0b88fac18b9738dab7fb47365f9dd004921c31357",
+        "dweb:/ipfs/QmUfVsoFGj4nKvEy5fx7yszqNbC9VXWWkfWfMBHcwouLqr"
+      ],
+      "license": "Apache-2.0"
+    },
+    "contracts/upgradeability/UpgradeabilityProxy.sol": {
+      "keccak256": "0xa7a9d804acfb476666548a05cd94ce8a5ffa6bd76b038cbc3f1683d6ac708c49",
+      "urls": [
+        "bzz-raw://805cbc090ff93c9d6eb6348683c6d2cf5da46c2bca254fda8d87516d395f9299",
+        "dweb:/ipfs/Qmez8Q656MWiJwHw2t88X6bJwgbK2aUnnoqcj2FzyaWxdy"
+      ],
+      "license": "Apache-2.0"
+    },
+    "contracts/v1/FiatTokenProxy.sol": {
+      "keccak256": "0x30fc5a64a101f783b2c745624d4c77b03a8f6373315857dc637581a189963f74",
+      "urls": [
+        "bzz-raw://f5de3f5569c8ac27ca793653613ca320c0ce77617510c31e7451d9b32f83ddb0",
+        "dweb:/ipfs/QmYQq9xh4jNwCH9KUDbWqttj5MWMfY2iAZRzrQf4cHh2nA"
+      ],
+      "license": "Apache-2.0"
+    },
+    "node_modules/@openzeppelin/contracts/utils/Address.sol": {
+      "keccak256": "0x28911e614500ae7c607a432a709d35da25f3bc5ddc8bd12b278b66358070c0ea",
+      "urls": [
+        "bzz-raw://256c8c8af5eb072bc473226ab2b2187149b8fc04f5f4a4820db22527f5ce8e3c",
+        "dweb:/ipfs/QmRvi5BhnL7Rxf85KrJhwM6RRhukm4tzoctRdgQEheNyiN"
+      ],
+      "license": "MIT"
+    }
+  },
+  "version": 1
+}
diff --git a/test/scripts/hardhat/testData/V2_2UpgraderDeploymentTrace.json b/test/scripts/hardhat/testData/V2_2UpgraderDeploymentTrace.json
new file mode 100644
index 000000000..d167ac5df
--- /dev/null
+++ b/test/scripts/hardhat/testData/V2_2UpgraderDeploymentTrace.json
@@ -0,0 +1,22 @@
+{
+  "from": "0x2ba937d2c71d0fbbeda8ce3bf02a8b88727961ec",
+  "gas": "0xe4e1c0",
+  "gasUsed": "0x7e83ee",
+  "to": "0x9999fa87f5a1d1c64e7c709838b92006ab0cc1ad",
+  "input": "0x60806040523480156200001157600080fd5b50604051620040d0380380620040d0833981810160405260a08110156200003757600080fd5b8151602083015160408085015160608601805192519496939591949391820192846401000000008211156200006b57600080fd5b9083019060208201858111156200008157600080fd5b82518660208202830111640100000000821117156200009f57600080fd5b82525081516020918201928201910280838360005b83811015620000ce578181015183820152602001620000b4565b5050505090500160405260200180516040519392919084640100000000821115620000f857600080fd5b9083019060208201858111156200010e57600080fd5b82516401000000008111828201881017156200012957600080fd5b82525081516020918201929091019080838360005b83811015620001585781810151838201526020016200013e565b50505050905090810190601f168015620001865780820380516001836020036101000a031916815260200191505b50604052505050848484620001a1336200027460201b60201c565b600180546001600160a01b039485166001600160a01b0319918216179091556002805493851693821693909317909255600380549190931691161790556040518590620001ee9062000296565b6001600160a01b03909116815260405190819003602001906000f0801580156200021c573d6000803e3d6000fd5b50600480546001600160a01b0319166001600160a01b0392909216919091179055815162000252906005906020850190620002a4565b508051620002689060069060208401906200030e565b505050505050620003c7565b600080546001600160a01b0319166001600160a01b0392909216919091179055565b610ebf806200321183390190565b828054828255906000526020600020908101928215620002fc579160200282015b82811115620002fc57825182546001600160a01b0319166001600160a01b03909116178255602090920191600190910190620002c5565b506200030a9291506200038f565b5090565b828054600181600116156101000203166002900490600052602060002090601f016020900481019282601f106200035157805160ff191683800117855562000381565b8280016001018555821562000381579182015b828111156200038157825182559160200191906001019062000364565b506200030a929150620003b0565b5b808211156200030a5780546001600160a01b031916815560010162000390565b5b808211156200030a5760008155600101620003b1565b612e3a80620003d76000396000f3fe608060405234801561001057600080fd5b50600436106100be5760003560e01c80638da5cb5b11610076578063d8f6a8f61161005b578063d8f6a8f614610176578063ec5568891461017e578063f2fde38b14610186576100be565b80638da5cb5b14610166578063d55ec6971461016e576100be565b80633f247fe7116100a75780633f247fe71461014c5780635c60da1b1461015657806363b0e66a1461015e576100be565b80632d4efffe146100c35780633200867b146100f4575b600080fd5b6100cb6101b9565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b6100fc6101d5565b60408051602080825283518183015283519192839290830191858101910280838360005b83811015610138578181015183820152602001610120565b505050509050019250505060405180910390f35b610154610244565b005b6100cb610484565b6100cb6104a0565b6100cb6104bc565b6101546104d8565b610154612682565b6100cb6127a1565b6101546004803603602081101561019c57600080fd5b503573ffffffffffffffffffffffffffffffffffffffff166127bd565b60035473ffffffffffffffffffffffffffffffffffffffff1690565b6060600580548060200260200160405190810160405280929190818152602001828054801561023a57602002820191906000526020600020905b815473ffffffffffffffffffffffffffffffffffffffff16815260019091019060200180831161020f575b5050505050905090565b60005473ffffffffffffffffffffffffffffffffffffffff1633146102ca57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b600154604080517f70a08231000000000000000000000000000000000000000000000000000000008152306004820152905173ffffffffffffffffffffffffffffffffffffffff9092169160009183916370a0823191602480820192602092909190829003018186803b15801561034057600080fd5b505afa158015610354573d6000803e3d6000fd5b505050506040513d602081101561036a57600080fd5b50519050801561048057604080517fa9059cbb00000000000000000000000000000000000000000000000000000000815233600482015260248101839052905173ffffffffffffffffffffffffffffffffffffffff84169163a9059cbb9160448083019260209291908290030181600087803b1580156103e957600080fd5b505af11580156103fd573d6000803e3d6000fd5b505050506040513d602081101561041357600080fd5b505161048057604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601c60248201527f4661696c656420746f2077697468647261772046696174546f6b656e00000000604482015290519081900360640190fd5b5050565b60025473ffffffffffffffffffffffffffffffffffffffff1690565b60045473ffffffffffffffffffffffffffffffffffffffff1690565b60005473ffffffffffffffffffffffffffffffffffffffff1690565b60005473ffffffffffffffffffffffffffffffffffffffff16331461055e57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b60048054604080517f70a0823100000000000000000000000000000000000000000000000000000000815230938101939093525173ffffffffffffffffffffffffffffffffffffffff9091169160009183916370a08231916024808301926020929190829003018186803b1580156105d557600080fd5b505afa1580156105e9573d6000803e3d6000fd5b505050506040513d60208110156105ff57600080fd5b5051905062030d4081101561065f576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526022815260200180612d936022913960400191505060405180910390fd5b60008273ffffffffffffffffffffffffffffffffffffffff166370a08231336040518263ffffffff1660e01b8152600401808273ffffffffffffffffffffffffffffffffffffffff16815260200191505060206040518083038186803b1580156106c857600080fd5b505afa1580156106dc573d6000803e3d6000fd5b505050506040513d60208110156106f257600080fd5b505190506106fe612cc4565b6040518061018001604052808573ffffffffffffffffffffffffffffffffffffffff166306fdde036040518163ffffffff1660e01b815260040160006040518083038186803b15801561075057600080fd5b505afa158015610764573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016820160405260208110156107ab57600080fd5b81019080805160405193929190846401000000008211156107cb57600080fd5b9083019060208201858111156107e057600080fd5b82516401000000008111828201881017156107fa57600080fd5b82525081516020918201929091019080838360005b8381101561082757818101518382015260200161080f565b50505050905090810190601f1680156108545780820380516001836020036101000a031916815260200191505b5060405250505081526020018573ffffffffffffffffffffffffffffffffffffffff1663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b1580156108a657600080fd5b505afa1580156108ba573d6000803e3d6000fd5b505050506040513d60208110156108d057600080fd5b505160ff168152604080517fe5a6b10f000000000000000000000000000000000000000000000000000000008152905160209092019173ffffffffffffffffffffffffffffffffffffffff88169163e5a6b10f916004808301926000929190829003018186803b15801561094357600080fd5b505afa158015610957573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0168201604052602081101561099e57600080fd5b81019080805160405193929190846401000000008211156109be57600080fd5b9083019060208201858111156109d357600080fd5b82516401000000008111828201881017156109ed57600080fd5b82525081516020918201929091019080838360005b83811015610a1a578181015183820152602001610a02565b50505050905090810190601f168015610a475780820380516001836020036101000a031916815260200191505b5060405250505081526020018573ffffffffffffffffffffffffffffffffffffffff166354fd4d506040518163ffffffff1660e01b815260040160006040518083038186803b158015610a9957600080fd5b505afa158015610aad573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe01682016040526020811015610af457600080fd5b8101908080516040519392919084640100000000821115610b1457600080fd5b908301906020820185811115610b2957600080fd5b8251640100000000811182820188101715610b4357600080fd5b82525081516020918201929091019080838360005b83811015610b70578181015183820152602001610b58565b50505050905090810190601f168015610b9d5780820380516001836020036101000a031916815260200191505b5060405250505081526020018573ffffffffffffffffffffffffffffffffffffffff16633644e5156040518163ffffffff1660e01b815260040160206040518083038186803b158015610bef57600080fd5b505afa158015610c03573d6000803e3d6000fd5b505050506040513d6020811015610c1957600080fd5b50518152604080517f35d99f35000000000000000000000000000000000000000000000000000000008152905160209283019273ffffffffffffffffffffffffffffffffffffffff8916926335d99f359260048083019392829003018186803b158015610c8557600080fd5b505afa158015610c99573d6000803e3d6000fd5b505050506040513d6020811015610caf57600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f6d3c5bbe000000000000000000000000000000000000000000000000000000008152905160209384019392891692636d3c5bbe9260048082019391829003018186803b158015610d1f57600080fd5b505afa158015610d33573d6000803e3d6000fd5b505050506040513d6020811015610d4957600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f9fd0506d000000000000000000000000000000000000000000000000000000008152905160209384019392891692639fd0506d9260048082019391829003018186803b158015610db957600080fd5b505afa158015610dcd573d6000803e3d6000fd5b505050506040513d6020811015610de357600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517fbd10243000000000000000000000000000000000000000000000000000000000815290516020938401939289169263bd1024309260048082019391829003018186803b158015610e5357600080fd5b505afa158015610e67573d6000803e3d6000fd5b505050506040513d6020811015610e7d57600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f38a631830000000000000000000000000000000000000000000000000000000081529051602093840193928916926338a631839260048082019391829003018186803b158015610eed57600080fd5b505afa158015610f01573d6000803e3d6000fd5b505050506040513d6020811015610f1757600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f5c975abb000000000000000000000000000000000000000000000000000000008152905160209384019392891692635c975abb9260048082019391829003018186803b158015610f8757600080fd5b505afa158015610f9b573d6000803e3d6000fd5b505050506040513d6020811015610fb157600080fd5b505115158152604080517f18160ddd000000000000000000000000000000000000000000000000000000008152905160209283019273ffffffffffffffffffffffffffffffffffffffff8916926318160ddd9260048083019392829003018186803b15801561101f57600080fd5b505afa158015611033573d6000803e3d6000fd5b505050506040513d602081101561104957600080fd5b50519052600154600254604080517f3659cfe600000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff92831660048201529051939450911691633659cfe69160248082019260009290919082900301818387803b1580156110c657600080fd5b505af11580156110da573d6000803e3d6000fd5b5050600154600354604080517f8f28397000000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff92831660048201529051919092169350638f2839709250602480830192600092919082900301818387803b15801561115557600080fd5b505af1158015611169573d6000803e3d6000fd5b5050600154604080517f430239b400000000000000000000000000000000000000000000000000000000815260048101918252600580546044830181905273ffffffffffffffffffffffffffffffffffffffff909416955085945063430239b49390926006929091829160248101916064909101908690801561122257602002820191906000526020600020905b815473ffffffffffffffffffffffffffffffffffffffff1681526001909101906020018083116111f7575b50508381038252845460027fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff6101006001841615020190911604808252602090910190859080156112b45780601f10611289576101008083540402835291602001916112b4565b820191906000526020600020905b81548152906001019060200180831161129757829003601f168201915b5050945050505050600060405180830381600087803b1580156112d657600080fd5b505af11580156112ea573d6000803e3d6000fd5b505050506112f6612cc4565b6040518061018001604052808373ffffffffffffffffffffffffffffffffffffffff166306fdde036040518163ffffffff1660e01b815260040160006040518083038186803b15801561134857600080fd5b505afa15801561135c573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016820160405260208110156113a357600080fd5b81019080805160405193929190846401000000008211156113c357600080fd5b9083019060208201858111156113d857600080fd5b82516401000000008111828201881017156113f257600080fd5b82525081516020918201929091019080838360005b8381101561141f578181015183820152602001611407565b50505050905090810190601f16801561144c5780820380516001836020036101000a031916815260200191505b5060405250505081526020018373ffffffffffffffffffffffffffffffffffffffff1663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b15801561149e57600080fd5b505afa1580156114b2573d6000803e3d6000fd5b505050506040513d60208110156114c857600080fd5b505160ff168152604080517fe5a6b10f000000000000000000000000000000000000000000000000000000008152905160209092019173ffffffffffffffffffffffffffffffffffffffff86169163e5a6b10f916004808301926000929190829003018186803b15801561153b57600080fd5b505afa15801561154f573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0168201604052602081101561159657600080fd5b81019080805160405193929190846401000000008211156115b657600080fd5b9083019060208201858111156115cb57600080fd5b82516401000000008111828201881017156115e557600080fd5b82525081516020918201929091019080838360005b838110156116125781810151838201526020016115fa565b50505050905090810190601f16801561163f5780820380516001836020036101000a031916815260200191505b5060405250505081526020018373ffffffffffffffffffffffffffffffffffffffff166354fd4d506040518163ffffffff1660e01b815260040160006040518083038186803b15801561169157600080fd5b505afa1580156116a5573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016820160405260208110156116ec57600080fd5b810190808051604051939291908464010000000082111561170c57600080fd5b90830190602082018581111561172157600080fd5b825164010000000081118282018810171561173b57600080fd5b82525081516020918201929091019080838360005b83811015611768578181015183820152602001611750565b50505050905090810190601f1680156117955780820380516001836020036101000a031916815260200191505b5060405250505081526020018373ffffffffffffffffffffffffffffffffffffffff16633644e5156040518163ffffffff1660e01b815260040160206040518083038186803b1580156117e757600080fd5b505afa1580156117fb573d6000803e3d6000fd5b505050506040513d602081101561181157600080fd5b50518152604080517f35d99f35000000000000000000000000000000000000000000000000000000008152905160209283019273ffffffffffffffffffffffffffffffffffffffff8716926335d99f359260048083019392829003018186803b15801561187d57600080fd5b505afa158015611891573d6000803e3d6000fd5b505050506040513d60208110156118a757600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f8da5cb5b000000000000000000000000000000000000000000000000000000008152905160209384019392871692638da5cb5b9260048082019391829003018186803b15801561191757600080fd5b505afa15801561192b573d6000803e3d6000fd5b505050506040513d602081101561194157600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f9fd0506d000000000000000000000000000000000000000000000000000000008152905160209384019392871692639fd0506d9260048082019391829003018186803b1580156119b157600080fd5b505afa1580156119c5573d6000803e3d6000fd5b505050506040513d60208110156119db57600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517fbd10243000000000000000000000000000000000000000000000000000000000815290516020938401939287169263bd1024309260048082019391829003018186803b158015611a4b57600080fd5b505afa158015611a5f573d6000803e3d6000fd5b505050506040513d6020811015611a7557600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f38a631830000000000000000000000000000000000000000000000000000000081529051602093840193928716926338a631839260048082019391829003018186803b158015611ae557600080fd5b505afa158015611af9573d6000803e3d6000fd5b505050506040513d6020811015611b0f57600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f5c975abb000000000000000000000000000000000000000000000000000000008152905160209384019392871692635c975abb9260048082019391829003018186803b158015611b7f57600080fd5b505afa158015611b93573d6000803e3d6000fd5b505050506040513d6020811015611ba957600080fd5b505115158152604080517f18160ddd000000000000000000000000000000000000000000000000000000008152905160209283019273ffffffffffffffffffffffffffffffffffffffff8716926318160ddd9260048083019392829003018186803b158015611c1757600080fd5b505afa158015611c2b573d6000803e3d6000fd5b505050506040513d6020811015611c4157600080fd5b505190529050611c518382612910565b611ca6576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526022815260200180612db56022913960400191505060405180910390fd5b60066040518082805460018160011615610100020316600290048015611d035780601f10611ce1576101008083540402835291820191611d03565b820191906000526020600020905b815481529060010190602001808311611cef575b505091505060405180910390208273ffffffffffffffffffffffffffffffffffffffff166395d89b416040518163ffffffff1660e01b815260040160006040518083038186803b158015611d5657600080fd5b505afa158015611d6a573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe01682016040526020811015611db157600080fd5b8101908080516040519392919084640100000000821115611dd157600080fd5b908301906020820185811115611de657600080fd5b8251640100000000811182820188101715611e0057600080fd5b82525081516020918201929091019080838360005b83811015611e2d578181015183820152602001611e15565b50505050905090810190601f168015611e5a5780820380516001836020036101000a031916815260200191505b506040525050508051906020012014611ed457604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f56325f3255706772616465723a2073796d626f6c206e6f742075706461746564604482015290519081900360640190fd5b848273ffffffffffffffffffffffffffffffffffffffff166370a08231306040518263ffffffff1660e01b8152600401808273ffffffffffffffffffffffffffffffffffffffff16815260200191505060206040518083038186803b158015611f3c57600080fd5b505afa158015611f50573d6000803e3d6000fd5b505050506040513d6020811015611f6657600080fd5b505114611fbe576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526023815260200180612d4a6023913960400191505060405180910390fd5b604080517fa9059cbb000000000000000000000000000000000000000000000000000000008152336004820152620186a06024820152905173ffffffffffffffffffffffffffffffffffffffff84169163a9059cbb9160448083019260209291908290030181600087803b15801561203557600080fd5b505af1158015612049573d6000803e3d6000fd5b505050506040513d602081101561205f57600080fd5b5051801561210f575061207584620186a0612b0d565b604080517f70a08231000000000000000000000000000000000000000000000000000000008152336004820152905173ffffffffffffffffffffffffffffffffffffffff8516916370a08231916024808301926020929190829003018186803b1580156120e157600080fd5b505afa1580156120f5573d6000803e3d6000fd5b505050506040513d602081101561210b57600080fd5b5051145b80156121bd575061212385620186a0612b81565b604080517f70a08231000000000000000000000000000000000000000000000000000000008152306004820152905173ffffffffffffffffffffffffffffffffffffffff8516916370a08231916024808301926020929190829003018186803b15801561218f57600080fd5b505afa1580156121a3573d6000803e3d6000fd5b505050506040513d60208110156121b957600080fd5b5051145b612212576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526022815260200180612d286022913960400191505060405180910390fd5b8173ffffffffffffffffffffffffffffffffffffffff1663095ea7b387620186a06040518363ffffffff1660e01b8152600401808373ffffffffffffffffffffffffffffffffffffffff16815260200182815260200192505050602060405180830381600087803b15801561228657600080fd5b505af115801561229a573d6000803e3d6000fd5b505050506040513d60208110156122b057600080fd5b505180156123615750604080517fdd62ed3e00000000000000000000000000000000000000000000000000000000815230600482015273ffffffffffffffffffffffffffffffffffffffff888116602483015291519184169163dd62ed3e91604480820192602092909190829003018186803b15801561232f57600080fd5b505afa158015612343573d6000803e3d6000fd5b505050506040513d602081101561235957600080fd5b5051620186a0145b80156124125750604080517f23b872dd000000000000000000000000000000000000000000000000000000008152306004820152336024820152620186a06044820152905173ffffffffffffffffffffffffffffffffffffffff8816916323b872dd9160648083019260209291908290030181600087803b1580156123e557600080fd5b505af11580156123f9573d6000803e3d6000fd5b505050506040513d602081101561240f57600080fd5b50515b80156124b95750604080517fdd62ed3e000000000000000000000000000000000000000000000000000000008152306004820152336024820152905173ffffffffffffffffffffffffffffffffffffffff84169163dd62ed3e916044808301926020929190829003018186803b15801561248b57600080fd5b505afa15801561249f573d6000803e3d6000fd5b505050506040513d60208110156124b557600080fd5b5051155b801561256757506124cd8462030d40612b0d565b604080517f70a08231000000000000000000000000000000000000000000000000000000008152336004820152905173ffffffffffffffffffffffffffffffffffffffff8516916370a08231916024808301926020929190829003018186803b15801561253957600080fd5b505afa15801561254d573d6000803e3d6000fd5b505050506040513d602081101561256357600080fd5b5051145b8015612615575061257b8562030d40612b81565b604080517f70a08231000000000000000000000000000000000000000000000000000000008152306004820152905173ffffffffffffffffffffffffffffffffffffffff8516916370a08231916024808301926020929190829003018186803b1580156125e757600080fd5b505afa1580156125fb573d6000803e3d6000fd5b505050506040513d602081101561261157600080fd5b5051145b61266a576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602e815260200180612dd7602e913960400191505060405180910390fd5b612672610244565b61267a612bf8565b505050505050565b60005473ffffffffffffffffffffffffffffffffffffffff16331461270857604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b600154600354604080517f8f28397000000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff928316600482015290519190921691638f28397091602480830192600092919082900301818387803b15801561277f57600080fd5b505af1158015612793573d6000803e3d6000fd5b5050505061279f612bf8565b565b60015473ffffffffffffffffffffffffffffffffffffffff1690565b60005473ffffffffffffffffffffffffffffffffffffffff16331461284357604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff81166128af576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526026815260200180612d6d6026913960400191505060405180910390fd5b6000546040805173ffffffffffffffffffffffffffffffffffffffff9283168152918316602083015280517f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09281900390910190a161290d81612c7d565b50565b60008160000151805190602001208360000151805190602001201480156129445750816020015160ff16836020015160ff16145b80156129655750816040015180519060200120836040015180519060200120145b80156129865750816060015180519060200120836060015180519060200120145b8015612999575081608001518360800151145b80156129d857508160a0015173ffffffffffffffffffffffffffffffffffffffff168360a0015173ffffffffffffffffffffffffffffffffffffffff16145b8015612a1757508160c0015173ffffffffffffffffffffffffffffffffffffffff168360c0015173ffffffffffffffffffffffffffffffffffffffff16145b8015612a5657508160e0015173ffffffffffffffffffffffffffffffffffffffff168360e0015173ffffffffffffffffffffffffffffffffffffffff16145b8015612a97575081610100015173ffffffffffffffffffffffffffffffffffffffff1683610100015173ffffffffffffffffffffffffffffffffffffffff16145b8015612ad8575081610120015173ffffffffffffffffffffffffffffffffffffffff1683610120015173ffffffffffffffffffffffffffffffffffffffff16145b8015612af1575081610140015115158361014001511515145b8015612b065750816101600151836101600151145b9392505050565b600082820183811015612b0657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601b60248201527f536166654d6174683a206164646974696f6e206f766572666c6f770000000000604482015290519081900360640190fd5b600082821115612bf257604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601e60248201527f536166654d6174683a207375627472616374696f6e206f766572666c6f770000604482015290519081900360640190fd5b50900390565b60048054604080517fec1e6a4f000000000000000000000000000000000000000000000000000000008152905173ffffffffffffffffffffffffffffffffffffffff9092169263ec1e6a4f92828201926000929082900301818387803b158015612c6157600080fd5b505af1158015612c75573d6000803e3d6000fd5b503392505050ff5b600080547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff92909216919091179055565b60408051610180810182526060808252600060208301819052928201819052808201526080810182905260a0810182905260c0810182905260e081018290526101008101829052610120810182905261014081018290526101608101919091529056fe56325f3255706772616465723a207472616e736665722074657374206661696c656456325f3255706772616465723a2062616c616e63654f662074657374206661696c65644f776e61626c653a206e6577206f776e657220697320746865207a65726f206164647265737356325f3255706772616465723a20302e322046696174546f6b656e206e656564656456325f3255706772616465723a206d657461646174612074657374206661696c656456325f3255706772616465723a20617070726f76652f7472616e7366657246726f6d2074657374206661696c6564a26469706673582212204819915d274abf3d15a3786f32e333cd2999420e94d010d1542e76b4cfa573f564736f6c634300060c0033608060405234801561001057600080fd5b50604051610ebf380380610ebf8339818101604052602081101561003357600080fd5b5051808061004033610068565b600180546001600160a01b0319166001600160a01b03929092169190911790555061008a9050565b600080546001600160a01b0319166001600160a01b0392909216919091179055565b610e26806100996000396000f3fe608060405234801561001057600080fd5b50600436106101515760003560e01c80636d3c5bbe116100cd578063bd10243011610081578063ec1e6a4f11610066578063ec1e6a4f14610316578063ec55688914610320578063f2fde38b1461032857610151565b8063bd10243014610306578063e5a6b10f1461030e57610151565b80638da5cb5b116100b25780638da5cb5b146102ee57806395d89b41146102f65780639fd0506d146102fe57610151565b80636d3c5bbe146102b357806370a08231146102bb57610151565b806335d99f351161012457806338a631831161010957806338a631831461029b57806354fd4d50146102a35780635c975abb146102ab57610151565b806335d99f35146102625780633644e5151461029357610151565b806306fdde031461015657806318160ddd146101d357806323b872dd146101ed578063313ce56714610244575b600080fd5b61015e61035b565b6040805160208082528351818301528351919283929083019185019080838360005b83811015610198578181015183820152602001610180565b50505050905090810190601f1680156101c55780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b6101db6104d6565b60408051918252519081900360200190f35b6102306004803603606081101561020357600080fd5b5073ffffffffffffffffffffffffffffffffffffffff813581169160208101359091169060400135610572565b604080519115158252519081900360200190f35b61024c61062d565b6040805160ff9092168252519081900360200190f35b61026a610698565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b6101db610703565b61026a61076e565b61015e6107d9565b610230610844565b61026a6108af565b6101db600480360360208110156102d157600080fd5b503573ffffffffffffffffffffffffffffffffffffffff1661091a565b61026a6109c3565b61015e6109df565b61026a610a4a565b61026a610ab5565b61015e610b20565b61031e610b8b565b005b61026a610c14565b61031e6004803603602081101561033e57600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610c30565b600154604080517f06fdde03000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916306fdde03916004808301926000929190829003018186803b1580156103c657600080fd5b505afa1580156103da573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0168201604052602081101561042157600080fd5b810190808051604051939291908464010000000082111561044157600080fd5b90830190602082018581111561045657600080fd5b825164010000000081118282018810171561047057600080fd5b82525081516020918201929091019080838360005b8381101561049d578181015183820152602001610485565b50505050905090810190601f1680156104ca5780820380516001836020036101000a031916815260200191505b50604052505050905090565b600154604080517f18160ddd000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916318160ddd916004808301926020929190829003018186803b15801561054157600080fd5b505afa158015610555573d6000803e3d6000fd5b505050506040513d602081101561056b57600080fd5b5051905090565b600154604080517f23b872dd00000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8681166004830152858116602483015260448201859052915160009392909216916323b872dd9160648082019260209290919082900301818787803b1580156105f957600080fd5b505af115801561060d573d6000803e3d6000fd5b505050506040513d602081101561062357600080fd5b5051949350505050565b600154604080517f313ce567000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff169163313ce567916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f35d99f35000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916335d99f35916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f3644e515000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691633644e515916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f38a63183000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916338a63183916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f54fd4d50000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916354fd4d50916004808301926000929190829003018186803b1580156103c657600080fd5b600154604080517f5c975abb000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691635c975abb916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f8da5cb5b000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691638da5cb5b916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f70a0823100000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8481166004830152915160009392909216916370a0823191602480820192602092909190829003018186803b15801561099157600080fd5b505afa1580156109a5573d6000803e3d6000fd5b505050506040513d60208110156109bb57600080fd5b505192915050565b60005473ffffffffffffffffffffffffffffffffffffffff1690565b600154604080517f95d89b41000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916395d89b41916004808301926000929190829003018186803b1580156103c657600080fd5b600154604080517f9fd0506d000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691639fd0506d916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517fbd102430000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff169163bd102430916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517fe5a6b10f000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff169163e5a6b10f916004808301926000929190829003018186803b1580156103c657600080fd5b60005473ffffffffffffffffffffffffffffffffffffffff163314610c1157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b33ff5b60015473ffffffffffffffffffffffffffffffffffffffff1690565b60005473ffffffffffffffffffffffffffffffffffffffff163314610cb657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff8116610d22576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526026815260200180610dcb6026913960400191505060405180910390fd5b6000546040805173ffffffffffffffffffffffffffffffffffffffff9283168152918316602083015280517f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09281900390910190a1610d8081610d83565b50565b600080547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff9290921691909117905556fe4f776e61626c653a206e6577206f776e657220697320746865207a65726f2061646472657373a2646970667358221220383c813e998c1388f31580a958b4ef51a545c3007a0be737f82b32515a060b0d64736f6c634300060c0033000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb4800000000000000000000000043506849d7c04f9138d1a2050bbf3a0c054402dd000000000000000000000000807a96288a1a408dbc13de2b1d087d10356395d200000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000001a8000000000000000000000000000000000000000000000000000000000000000ce000000000000000000000000aa05f7c7eb9af63d6cc03c36c4f4ef6c37431ee00000000000000000000000007f367cc41522ce07553e823bf3be79a889debe1b0000000000000000000000001da5821544e25c636c1417ba96ade4cf6d2f9b5a0000000000000000000000007db418b5d567a4e0e8c59ad71be1fce48f3e610700000000000000000000000072a5843cc08275c8171e582972aa4fda8c397b2a0000000000000000000000007f19720a857f834887fc9a7bc0a0fbe7fc7f8102000000000000000000000000d882cfc20f52f2599d84b8e8d58c7fb62cfe344b0000000000000000000000009f4cda013e354b8fc285bf4b9a60460cee7f7ea9000000000000000000000000308ed4b7b49797e1a98d3818bff6fe5385410370000000000000000000000000e7aa314c77f4233c18c6cc84384a9247c0cf367b00000000000000000000000019aa5fe80d33a56d56c78e82ea5e50e5d80b4dff0000000000000000000000002f389ce8bd8ff92de3402ffce4691d17fc4f6535000000000000000000000000a7e5d5a720f06526557c513402f2e6b5fa20b0080000000000000000000000003cbded43efdaf0fc77b9c55f6fc9988fcc9b757d00000000000000000000000067d40ee1a85bf4a4bb7ffae16de985e8427b6b450000000000000000000000006f1ca141a28907f78ebaa64fb83a9088b02a83520000000000000000000000006acdfba02d390b97ac2b2d42a63e85293bcc160e00000000000000000000000048549a34ae37b12f6a30566245176994e17c6b4a0000000000000000000000005512d943ed1f7c8a43f3435c85f7ab68b30121b0000000000000000000000000c455f7fd3e0e12afd51fba5c106909934d8a0e4a000000000000000000000000fae5a6d3bd9bd24a3ed2f2a8a6031c83976c19a20000000000000000000000005eb95f30bd4409cfaadeba75cd8d9c2ce4ed992a000000000000000000000000461270bd08dfa98edec980345fd56d578a2d8f49000000000000000000000000fec8a60023265364d066a1212fde3930f6ae8da70000000000000000000000008576acc5c05d6ce88f4e49bf65bdf0c62f91353c000000000000000000000000901bb9583b24d97e995513c6778dc6888ab6870e0000000000000000000000007ff9cfad3877f21d41da833e2f775db0569ee3d9000000000000000000000000098b716b8aaf21512996dc57eb0615e2383e2f96000000000000000000000000a0e1c89ef1a489c9c7de96311ed5ce5d32c20e4b0000000000000000000000003cffd56b47b7b41c56258d9c7731abadc360e07300000000000000000000000053b6936513e738f44fb50d2b9476730c0ab3bfc1000000000000000000000000cce63fd31e9053c110c74cebc37c8e358a6aa5bd00000000000000000000000035fb6f6db4fb05e6a4ce86f2c93691425626d4b1000000000000000000000000f7b31119c2682c88d88d455dbb9d5932c65cf1be0000000000000000000000003e37627deaa754090fbfbb8bd226c1ce66d255e900000000000000000000000008723392ed15743cc38513c4925f5e6be5c1724300000000000000000000000006caa9a5fd7e3dc3b3157973455cbe9b9c2b14d20000000000000000000000002d66370666d7b9315e6e7fdb47f41ad7222798330000000000000000000000009ff43bd969e8dbc383d1aca50584c14266f3d876000000000000000000000000bfd88175e4ae6f7f2ee4b01bf96cf48d2bcb41960000000000000000000000008589427373d6d84e98730d7795d8f6f8731fda16000000000000000000000000722122df12d4e14e13ac3b6895a86e84145b6967000000000000000000000000dd4c48c0b24039969fc16d1cdf626eab821d3384000000000000000000000000d90e2f925da726b50c4ed8d0fb90ad053324f31b000000000000000000000000d96f2b1c14db8458374d9aca76e26c3d183643070000000000000000000000004736dcf1b7a3d580672cce6e7c65cd5cc9cfba9d000000000000000000000000d4b88df4d29f5cedd6857912842cff3b20c8cfa3000000000000000000000000910cbd523d972eb0a6f4cae4618ad62622b39dbf000000000000000000000000a160cdab225685da1d56aa342ad8841c3b53f291000000000000000000000000fd8610d20aa15b7b2e3be39b396a1bc3516c7144000000000000000000000000f60dd140cff0706bae9cd734ac3ae76ad9ebc32a00000000000000000000000022aaa7720ddd5388a3c0a3333430953c68f1849b000000000000000000000000ba214c1c1928a32bffe790263e38b4af9bfcd659000000000000000000000000b1c8094b234dce6e03f10a5b673c1d8c69739a00000000000000000000000000527653ea119f3e6a1f5bd18fbf4714081d7b31ce00000000000000000000000058e8dcc13be9780fc42e8723d8ead4cf46943df2000000000000000000000000d691f27f38b395864ea86cfc7253969b409c362d000000000000000000000000aeaac358560e11f52454d997aaff2c5731b6f8a60000000000000000000000001356c899d8c9467c7f71c195612f8a395abf2f0a000000000000000000000000a60c772958a3ed56c1f15dd055ba37ac8e523a0d000000000000000000000000169ad27a470d064dede56a2d3ff727986b15d52b0000000000000000000000000836222f2b2b24a3f36f98668ed8f0b38d1a872f000000000000000000000000f67721a2d8f736e75a49fdd7fad2e31d8676542a0000000000000000000000009ad122c22b14202b4490edaf288fdb3c7cb3ff5e00000000000000000000000007687e702b410fa43f4cb4af7fa097918ffd273000000000000000000000000094a1b5cdb22c43faab4abeb5c74999895464ddaf000000000000000000000000b541fc07bc7619fd4062a54d96268525cbc6ffef00000000000000000000000012d66f87a04a9e220743712ce6d9bb1b5616b8fc00000000000000000000000047ce0c6ed5b0ce3d3a51fdb1c52dc66a7c3c293600000000000000000000000023773e65ed146a459791799d01336db287f25334000000000000000000000000d21be7248e0197ee08e0c20d4a96debdac3d20af000000000000000000000000610b717796ad172b316836ac95a2ffad065ceab4000000000000000000000000178169b423a011fff22b9e3f3abea13414ddd0f1000000000000000000000000bb93e510bbcd0b7beb5a853875f9ec60275cf4980000000000000000000000002717c5e28cf931547b621a5dddb772ab6a35b70100000000000000000000000003893a7c7463ae47d46bc7f091665f1893656003000000000000000000000000ca0840578f57fe71599d29375e16783424023357000000000000000000000000d93a9c5c4d399dc5f67b67cdb30d16a7bb5749150000000000000000000000003ad9db589d201a710ed237c829c7860ba86510fc000000000000000000000000c2a3829f459b3edd87791c74cd45402ba0a20be3000000000000000000000000e7800b61479695ec74e4b219f409f67bd1055a27000000000000000000000000815f335f976301f496167bfef237f0622f92ac3800000000000000000000000081c4d8816b29147c542dde87485608204690acf2000000000000000000000000489a8756c18c0b8b24ec2a2b9ff3d4d447f79bec000000000000000000000000330bdfade01ee9bf63c209ee33102dd334618e0a000000000000000000000000d47438c816c9e7f2e2888e060936a499af9582b300000000000000000000000084443cfd09a48af6ef360c6976c5392ac5023a1f000000000000000000000000d82ed8786d7c69dc7e052f7a542ab047971e73d2000000000000000000000000756c4628e57f7e7f8a459ec2752968360cf4d1aa0000000000000000000000005cab7692d4e94096462119ab7bf57319726eed2a00000000000000000000000009193888b3f38c82dedfda55259a82c0e7de875e00000000000000000000000088fd245fedec4a936e700f9173454d1931b4c307000000000000000000000000653477c392c16b0765603074f157314cc4f40c320000000000000000000000002573bac39ebe2901b4389cd468f2872cf7767faf000000000000000000000000b20c66c4de72433f3ce747b58b86830c459ca91100000000000000000000000026903a5a198d571422b2b4ea08b56a37cbd68c890000000000000000000000002fc93484614a34f26f7970cbb94615ba109bb4bf00000000000000000000000001e2919679362dfbc9ee1644ba9c6da6d6245bb1000000000000000000000000f4b067dd14e95bab89be928c07cb22e3c94e0daa0000000000000000000000005f6c97c6ad7bdd0ae7e0dd4ca33a4ed3fdabd4d7000000000000000000000000746aebc06d2ae31b71ac51429a19d54e797878e90000000000000000000000003efa30704d2b8bbac821307230376556cf8cc39e00000000000000000000000077777feddddffc19ff86db637967013e6c6a116c000000000000000000000000b04e030140b30c27bcdfaafffa98c57d80eda7b4000000000000000000000000ffbac21a641dcfe4552920138d90f3638b3c9fba000000000000000000000000cee71753c9820f063b38fdbe4cfdaf1d3d928a800000000000000000000000002f50508a8a3d323b91336fa3ea6ae50e55f321850000000000000000000000005efda50f22d34f262c29268506c5fa42cb56a1ce00000000000000000000000094c92f096437ab9958fc0a37f09348f30389ae79000000000000000000000000743494b60097a2230018079c02fe21a7b687eaa5000000000000000000000000179f48c78f57a3a78f0608cc9197b8972921d1d2000000000000000000000000df3a408c53e5078af6e8fb2a85088d46ee09a61b000000000000000000000000d692fd2d0b2fbd2e52cfa5b5b9424bc981c30696000000000000000000000000edc5d01286f99a066559f60a585406f3878a033e000000000000000000000000776198ccf446dfa168347089d7338879273172cf000000000000000000000000242654336ca2205714071898f67e254eb49acdce00000000000000000000000094be88213a387e992dd87de56950a9aef34b9448000000000000000000000000538ab61e8a9fc1b2f93b3dd9011d662d89be6fe600000000000000000000000023173fe8b96a4ad8d2e17fb83ea5dcccdca1ae5200000000000000000000000005e0b5b40b7b66098c2161a5ee11c5740a3a7c4500000000000000000000000057b2b8c82f065de8ef5573f9730fc1449b403c9f0000000000000000000000008281aa6795ade17c8973e1aedca380258bc124f9000000000000000000000000d8d7de3349ccaa0fde6298fe6d7b7d0d34586193000000000000000000000000833481186f16cece3f1eeea1a694c42034c3a0db000000000000000000000000407cceeaa7c95d2fe2250bf9f2c105aa7aafb512000000000000000000000000d5d6f8d9e784d0e26222ad3834500801a68d027d000000000000000000000000cc84179ffd19a1627e79f8648d09e095252bc41800000000000000000000000076d85b4c0fc497eecc38902397ac608000a066070000000000000000000000000e3a09dda6b20afbb34ac7cd4a6881493f3e7bf7000000000000000000000000723b78e67497e85279cb204544566f4dc5d2aca00000000000000000000000003aac1cc67c2ec5db4ea850957b967ba153ad62790000000000000000000000006bf694a291df3fec1f7e69701e3ab6c592435ae7000000000000000000000000af8d1839c3c67cf571aa74b5c12398d4901147b3000000000000000000000000a5c2254e4253490c54cef0a4347fddb8f75a4998000000000000000000000000af4c0b70b2ea9fb7487c7cbb37ada259579fe040000000000000000000000000df231d99ff8b6c6cbf4e9b9a945cbacef93391780000000000000000000000001e34a77868e19a6647b1f2f47b51ed72dede95dd000000000000000000000000502371699497d08d5339c870851898d6d72521dd0000000000000000000000005a14e72060c11313e38738009254a90968f58f51000000000000000000000000efe301d259f525ca1ba74a7977b80d5b060b3cca000000000000000000000000d0975b32cea532eadddfc9c60481976e39db34720000000000000000000000001967d8af5bd86a497fb3dd7899a020e47560daaf00000000000000000000000004dba1194ee10112fe6c3207c0687def0e78bacf00000000000000000000000008b2efdcdb8822efe5ad0eae55517cf5dc54425100000000000000000000000083e5bc4ffa856bb84bb88581f5dd62a433a25e0d0000000000000000000000000ee5067b06776a89ccc7dc8ee369984ad7db5e0600000000000000000000000044b3d59fe4da798a43de3689be0a2ab508bc0067000000000000000000000000bf4f36efa3ac655a1d86f6c32b648a90271443f400000000000000000000000039d908dac893cbcb53cc86e0ecc369aa4def1a290000000000000000000000007f2863dc306fe5be920d311f5eeef842bae16ce8000000000000000000000000f8a9ab377ce63592583767b34602e130e38ebdca0000000000000000000000006572760df65696a671eb17575b995daca056237d00000000000000000000000042b756987dee8a21508c4e470bfefb5e36a5e4e40000000000000000000000009253f800c8a03b9184ceb9280361e5055893192c0000000000000000000000004f47bc496083c727c5fbe3ce9cdf2b0f6496270c0000000000000000000000008a8a2436fc920e6c73c3a9e9a00b8d937812ee0d000000000000000000000000088aaa322d955816d8a00b3ad58139543556cb61000000000000000000000000c34586a57d59fbd08865298203cf28cd10ad970800000000000000000000000038735f03b30fbc022ddd06abed01f0ca823c6a940000000000000000000000008bebb5bc4f8ee9d2978e70c5dc178543fb9dc0d9000000000000000000000000eb53f63ff2c8f576de0752d0fb603ddc79318b26000000000000000000000000fc672c73ca5c7234edc82552e4a0c8fc247d32ac00000000000000000000000008c3fd4ae6a596083a528614d71e17c2ff2f4b8e0000000000000000000000000c51498f3ae1a0cfe696820a1b4e9af85b918bc600000000000000000000000097b1043abd9e6fc31681635166d430a458d14f9c000000000000000000000000b6f5ec1a0a9cd1526536d3f0426c429529471f4000000000000000000000000048bead89e696ee93b04913cb0006f35adb844537000000000000000000000000efeef8e968a0db92781ac7b3b7c821909ef10c88000000000000000000000000027f1571aca57354223276722dc7b572a5b05cd8000000000000000000000000d71c94052989e209ba713deb66e0a8f72b913b70000000000000000000000000dcbeffbecce100cce9e4b153c4e15cb8856431930000000000000000000000005f48c2a71b2cc96e3f0ccae4e39318ff0dc375b20000000000000000000000005a7a51bfb49f190e5a6060a5bc6052ac14a3b59f000000000000000000000000ed6e0a7e4ac94d976eebfb82ccf777a3c6bad921000000000000000000000000797d7ae72ebddcdea2a346c1834e04d1f8df102b000000000000000000000000931546d9e66836abf687d2bc64b30407bac8c56800000000000000000000000043fa21d92141ba9db43052492e0deee5aa5f0a930000000000000000000000006be0ae71e6c41f2f9d0d1a3b8d0f75e6f6a0b46e0000000000000000000000003d7cfda9254a05d3eeae06ab2a7c46b8e950d7440000000000000000000000009c220048401fa6819e59a15e67d96ceffb9043ac00000000000000000000000026e0d078aac76c9ba2b348825b413744a82a2cfd0000000000000000000000009c2bc757b66f24d60f016b6237f8cdd414a879fa000000000000000000000000530a64c0ce595026a4a556b703644228179e2d570000000000000000000000002e13ea767da12f504ceaaaebe5950488498dc2d20000000000000000000000007de5ab1914e241177344936dc33b4a8157c98248000000000000000000000000fac583c0cf07ea434052c49115a4682172ab6b4f000000000000000000000000be5e683633ddd17d8a89b4e10860a0e426c5ed24000000000000000000000000961c5be54a2ffc17cf4cb021d863c42dacd47fc1000000000000000000000000a6cc8ab881debc3c9e8adb32549d0cbe614168c5000000000000000000000000983a81ca6fb1e441266d2fbcb7d8e530ac2e05a20000000000000000000000005b93aadbd3e507bf2e3a68e8cd760c82fba541f10000000000000000000000003ac79da68cc906240f4c62d7b2bfe64fb992e22c0000000000000000000000005095cbfc0ff59e63745ea01f5a722f9d7564b4f60000000000000000000000003ceab17d3fb1ee10e8424ca2b649c54a0643ed880000000000000000000000001ea6c03601ba054441709a4a345addc05937fd9c000000000000000000000000d492e57806c0abd3f0932205c5bb3086aae4977800000000000000000000000068b66ce34da6bf45110e0064f232acbd8e7a55310000000000000000000000007d7c4dddf9188d0c170d438d08eb94370c5886300000000000000000000000009078b13962fbc7d93f624ab9395d60ff332a9af9000000000000000000000000d6d47fcea370d6fbd78de05e458bcc5d2d38c39000000000000000000000000025b903719548e94cb58907a0db4461ffd61deeb60000000000000000000000005ea884caf25a9d2b9fb1033cdd5300bd40c5d223000000000000000000000000ce5d11cc48eb1671a6e36829575578d2d4cca48f000000000000000000000000e997bfc0f7a6fd834176b0c92eb845b6696b8d09000000000000000000000000f44edc33a3c96e7e74ce9284a04db0d8af7eca4c00000000000000000000000034aa48e296273872649ef8d3782813fe9a77dc7200000000000000000000000000000000000000000000000000000000000000045553444300000000000000000000000000000000000000000000000000000000",
+  "output": "0x608060405234801561001057600080fd5b50600436106100be5760003560e01c80638da5cb5b11610076578063d8f6a8f61161005b578063d8f6a8f614610176578063ec5568891461017e578063f2fde38b14610186576100be565b80638da5cb5b14610166578063d55ec6971461016e576100be565b80633f247fe7116100a75780633f247fe71461014c5780635c60da1b1461015657806363b0e66a1461015e576100be565b80632d4efffe146100c35780633200867b146100f4575b600080fd5b6100cb6101b9565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b6100fc6101d5565b60408051602080825283518183015283519192839290830191858101910280838360005b83811015610138578181015183820152602001610120565b505050509050019250505060405180910390f35b610154610244565b005b6100cb610484565b6100cb6104a0565b6100cb6104bc565b6101546104d8565b610154612682565b6100cb6127a1565b6101546004803603602081101561019c57600080fd5b503573ffffffffffffffffffffffffffffffffffffffff166127bd565b60035473ffffffffffffffffffffffffffffffffffffffff1690565b6060600580548060200260200160405190810160405280929190818152602001828054801561023a57602002820191906000526020600020905b815473ffffffffffffffffffffffffffffffffffffffff16815260019091019060200180831161020f575b5050505050905090565b60005473ffffffffffffffffffffffffffffffffffffffff1633146102ca57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b600154604080517f70a08231000000000000000000000000000000000000000000000000000000008152306004820152905173ffffffffffffffffffffffffffffffffffffffff9092169160009183916370a0823191602480820192602092909190829003018186803b15801561034057600080fd5b505afa158015610354573d6000803e3d6000fd5b505050506040513d602081101561036a57600080fd5b50519050801561048057604080517fa9059cbb00000000000000000000000000000000000000000000000000000000815233600482015260248101839052905173ffffffffffffffffffffffffffffffffffffffff84169163a9059cbb9160448083019260209291908290030181600087803b1580156103e957600080fd5b505af11580156103fd573d6000803e3d6000fd5b505050506040513d602081101561041357600080fd5b505161048057604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601c60248201527f4661696c656420746f2077697468647261772046696174546f6b656e00000000604482015290519081900360640190fd5b5050565b60025473ffffffffffffffffffffffffffffffffffffffff1690565b60045473ffffffffffffffffffffffffffffffffffffffff1690565b60005473ffffffffffffffffffffffffffffffffffffffff1690565b60005473ffffffffffffffffffffffffffffffffffffffff16331461055e57604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b60048054604080517f70a0823100000000000000000000000000000000000000000000000000000000815230938101939093525173ffffffffffffffffffffffffffffffffffffffff9091169160009183916370a08231916024808301926020929190829003018186803b1580156105d557600080fd5b505afa1580156105e9573d6000803e3d6000fd5b505050506040513d60208110156105ff57600080fd5b5051905062030d4081101561065f576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526022815260200180612d936022913960400191505060405180910390fd5b60008273ffffffffffffffffffffffffffffffffffffffff166370a08231336040518263ffffffff1660e01b8152600401808273ffffffffffffffffffffffffffffffffffffffff16815260200191505060206040518083038186803b1580156106c857600080fd5b505afa1580156106dc573d6000803e3d6000fd5b505050506040513d60208110156106f257600080fd5b505190506106fe612cc4565b6040518061018001604052808573ffffffffffffffffffffffffffffffffffffffff166306fdde036040518163ffffffff1660e01b815260040160006040518083038186803b15801561075057600080fd5b505afa158015610764573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016820160405260208110156107ab57600080fd5b81019080805160405193929190846401000000008211156107cb57600080fd5b9083019060208201858111156107e057600080fd5b82516401000000008111828201881017156107fa57600080fd5b82525081516020918201929091019080838360005b8381101561082757818101518382015260200161080f565b50505050905090810190601f1680156108545780820380516001836020036101000a031916815260200191505b5060405250505081526020018573ffffffffffffffffffffffffffffffffffffffff1663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b1580156108a657600080fd5b505afa1580156108ba573d6000803e3d6000fd5b505050506040513d60208110156108d057600080fd5b505160ff168152604080517fe5a6b10f000000000000000000000000000000000000000000000000000000008152905160209092019173ffffffffffffffffffffffffffffffffffffffff88169163e5a6b10f916004808301926000929190829003018186803b15801561094357600080fd5b505afa158015610957573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0168201604052602081101561099e57600080fd5b81019080805160405193929190846401000000008211156109be57600080fd5b9083019060208201858111156109d357600080fd5b82516401000000008111828201881017156109ed57600080fd5b82525081516020918201929091019080838360005b83811015610a1a578181015183820152602001610a02565b50505050905090810190601f168015610a475780820380516001836020036101000a031916815260200191505b5060405250505081526020018573ffffffffffffffffffffffffffffffffffffffff166354fd4d506040518163ffffffff1660e01b815260040160006040518083038186803b158015610a9957600080fd5b505afa158015610aad573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe01682016040526020811015610af457600080fd5b8101908080516040519392919084640100000000821115610b1457600080fd5b908301906020820185811115610b2957600080fd5b8251640100000000811182820188101715610b4357600080fd5b82525081516020918201929091019080838360005b83811015610b70578181015183820152602001610b58565b50505050905090810190601f168015610b9d5780820380516001836020036101000a031916815260200191505b5060405250505081526020018573ffffffffffffffffffffffffffffffffffffffff16633644e5156040518163ffffffff1660e01b815260040160206040518083038186803b158015610bef57600080fd5b505afa158015610c03573d6000803e3d6000fd5b505050506040513d6020811015610c1957600080fd5b50518152604080517f35d99f35000000000000000000000000000000000000000000000000000000008152905160209283019273ffffffffffffffffffffffffffffffffffffffff8916926335d99f359260048083019392829003018186803b158015610c8557600080fd5b505afa158015610c99573d6000803e3d6000fd5b505050506040513d6020811015610caf57600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f6d3c5bbe000000000000000000000000000000000000000000000000000000008152905160209384019392891692636d3c5bbe9260048082019391829003018186803b158015610d1f57600080fd5b505afa158015610d33573d6000803e3d6000fd5b505050506040513d6020811015610d4957600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f9fd0506d000000000000000000000000000000000000000000000000000000008152905160209384019392891692639fd0506d9260048082019391829003018186803b158015610db957600080fd5b505afa158015610dcd573d6000803e3d6000fd5b505050506040513d6020811015610de357600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517fbd10243000000000000000000000000000000000000000000000000000000000815290516020938401939289169263bd1024309260048082019391829003018186803b158015610e5357600080fd5b505afa158015610e67573d6000803e3d6000fd5b505050506040513d6020811015610e7d57600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f38a631830000000000000000000000000000000000000000000000000000000081529051602093840193928916926338a631839260048082019391829003018186803b158015610eed57600080fd5b505afa158015610f01573d6000803e3d6000fd5b505050506040513d6020811015610f1757600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f5c975abb000000000000000000000000000000000000000000000000000000008152905160209384019392891692635c975abb9260048082019391829003018186803b158015610f8757600080fd5b505afa158015610f9b573d6000803e3d6000fd5b505050506040513d6020811015610fb157600080fd5b505115158152604080517f18160ddd000000000000000000000000000000000000000000000000000000008152905160209283019273ffffffffffffffffffffffffffffffffffffffff8916926318160ddd9260048083019392829003018186803b15801561101f57600080fd5b505afa158015611033573d6000803e3d6000fd5b505050506040513d602081101561104957600080fd5b50519052600154600254604080517f3659cfe600000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff92831660048201529051939450911691633659cfe69160248082019260009290919082900301818387803b1580156110c657600080fd5b505af11580156110da573d6000803e3d6000fd5b5050600154600354604080517f8f28397000000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff92831660048201529051919092169350638f2839709250602480830192600092919082900301818387803b15801561115557600080fd5b505af1158015611169573d6000803e3d6000fd5b5050600154604080517f430239b400000000000000000000000000000000000000000000000000000000815260048101918252600580546044830181905273ffffffffffffffffffffffffffffffffffffffff909416955085945063430239b49390926006929091829160248101916064909101908690801561122257602002820191906000526020600020905b815473ffffffffffffffffffffffffffffffffffffffff1681526001909101906020018083116111f7575b50508381038252845460027fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff6101006001841615020190911604808252602090910190859080156112b45780601f10611289576101008083540402835291602001916112b4565b820191906000526020600020905b81548152906001019060200180831161129757829003601f168201915b5050945050505050600060405180830381600087803b1580156112d657600080fd5b505af11580156112ea573d6000803e3d6000fd5b505050506112f6612cc4565b6040518061018001604052808373ffffffffffffffffffffffffffffffffffffffff166306fdde036040518163ffffffff1660e01b815260040160006040518083038186803b15801561134857600080fd5b505afa15801561135c573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016820160405260208110156113a357600080fd5b81019080805160405193929190846401000000008211156113c357600080fd5b9083019060208201858111156113d857600080fd5b82516401000000008111828201881017156113f257600080fd5b82525081516020918201929091019080838360005b8381101561141f578181015183820152602001611407565b50505050905090810190601f16801561144c5780820380516001836020036101000a031916815260200191505b5060405250505081526020018373ffffffffffffffffffffffffffffffffffffffff1663313ce5676040518163ffffffff1660e01b815260040160206040518083038186803b15801561149e57600080fd5b505afa1580156114b2573d6000803e3d6000fd5b505050506040513d60208110156114c857600080fd5b505160ff168152604080517fe5a6b10f000000000000000000000000000000000000000000000000000000008152905160209092019173ffffffffffffffffffffffffffffffffffffffff86169163e5a6b10f916004808301926000929190829003018186803b15801561153b57600080fd5b505afa15801561154f573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0168201604052602081101561159657600080fd5b81019080805160405193929190846401000000008211156115b657600080fd5b9083019060208201858111156115cb57600080fd5b82516401000000008111828201881017156115e557600080fd5b82525081516020918201929091019080838360005b838110156116125781810151838201526020016115fa565b50505050905090810190601f16801561163f5780820380516001836020036101000a031916815260200191505b5060405250505081526020018373ffffffffffffffffffffffffffffffffffffffff166354fd4d506040518163ffffffff1660e01b815260040160006040518083038186803b15801561169157600080fd5b505afa1580156116a5573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe016820160405260208110156116ec57600080fd5b810190808051604051939291908464010000000082111561170c57600080fd5b90830190602082018581111561172157600080fd5b825164010000000081118282018810171561173b57600080fd5b82525081516020918201929091019080838360005b83811015611768578181015183820152602001611750565b50505050905090810190601f1680156117955780820380516001836020036101000a031916815260200191505b5060405250505081526020018373ffffffffffffffffffffffffffffffffffffffff16633644e5156040518163ffffffff1660e01b815260040160206040518083038186803b1580156117e757600080fd5b505afa1580156117fb573d6000803e3d6000fd5b505050506040513d602081101561181157600080fd5b50518152604080517f35d99f35000000000000000000000000000000000000000000000000000000008152905160209283019273ffffffffffffffffffffffffffffffffffffffff8716926335d99f359260048083019392829003018186803b15801561187d57600080fd5b505afa158015611891573d6000803e3d6000fd5b505050506040513d60208110156118a757600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f8da5cb5b000000000000000000000000000000000000000000000000000000008152905160209384019392871692638da5cb5b9260048082019391829003018186803b15801561191757600080fd5b505afa15801561192b573d6000803e3d6000fd5b505050506040513d602081101561194157600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f9fd0506d000000000000000000000000000000000000000000000000000000008152905160209384019392871692639fd0506d9260048082019391829003018186803b1580156119b157600080fd5b505afa1580156119c5573d6000803e3d6000fd5b505050506040513d60208110156119db57600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517fbd10243000000000000000000000000000000000000000000000000000000000815290516020938401939287169263bd1024309260048082019391829003018186803b158015611a4b57600080fd5b505afa158015611a5f573d6000803e3d6000fd5b505050506040513d6020811015611a7557600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f38a631830000000000000000000000000000000000000000000000000000000081529051602093840193928716926338a631839260048082019391829003018186803b158015611ae557600080fd5b505afa158015611af9573d6000803e3d6000fd5b505050506040513d6020811015611b0f57600080fd5b505173ffffffffffffffffffffffffffffffffffffffff9081168252604080517f5c975abb000000000000000000000000000000000000000000000000000000008152905160209384019392871692635c975abb9260048082019391829003018186803b158015611b7f57600080fd5b505afa158015611b93573d6000803e3d6000fd5b505050506040513d6020811015611ba957600080fd5b505115158152604080517f18160ddd000000000000000000000000000000000000000000000000000000008152905160209283019273ffffffffffffffffffffffffffffffffffffffff8716926318160ddd9260048083019392829003018186803b158015611c1757600080fd5b505afa158015611c2b573d6000803e3d6000fd5b505050506040513d6020811015611c4157600080fd5b505190529050611c518382612910565b611ca6576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526022815260200180612db56022913960400191505060405180910390fd5b60066040518082805460018160011615610100020316600290048015611d035780601f10611ce1576101008083540402835291820191611d03565b820191906000526020600020905b815481529060010190602001808311611cef575b505091505060405180910390208273ffffffffffffffffffffffffffffffffffffffff166395d89b416040518163ffffffff1660e01b815260040160006040518083038186803b158015611d5657600080fd5b505afa158015611d6a573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe01682016040526020811015611db157600080fd5b8101908080516040519392919084640100000000821115611dd157600080fd5b908301906020820185811115611de657600080fd5b8251640100000000811182820188101715611e0057600080fd5b82525081516020918201929091019080838360005b83811015611e2d578181015183820152602001611e15565b50505050905090810190601f168015611e5a5780820380516001836020036101000a031916815260200191505b506040525050508051906020012014611ed457604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f56325f3255706772616465723a2073796d626f6c206e6f742075706461746564604482015290519081900360640190fd5b848273ffffffffffffffffffffffffffffffffffffffff166370a08231306040518263ffffffff1660e01b8152600401808273ffffffffffffffffffffffffffffffffffffffff16815260200191505060206040518083038186803b158015611f3c57600080fd5b505afa158015611f50573d6000803e3d6000fd5b505050506040513d6020811015611f6657600080fd5b505114611fbe576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526023815260200180612d4a6023913960400191505060405180910390fd5b604080517fa9059cbb000000000000000000000000000000000000000000000000000000008152336004820152620186a06024820152905173ffffffffffffffffffffffffffffffffffffffff84169163a9059cbb9160448083019260209291908290030181600087803b15801561203557600080fd5b505af1158015612049573d6000803e3d6000fd5b505050506040513d602081101561205f57600080fd5b5051801561210f575061207584620186a0612b0d565b604080517f70a08231000000000000000000000000000000000000000000000000000000008152336004820152905173ffffffffffffffffffffffffffffffffffffffff8516916370a08231916024808301926020929190829003018186803b1580156120e157600080fd5b505afa1580156120f5573d6000803e3d6000fd5b505050506040513d602081101561210b57600080fd5b5051145b80156121bd575061212385620186a0612b81565b604080517f70a08231000000000000000000000000000000000000000000000000000000008152306004820152905173ffffffffffffffffffffffffffffffffffffffff8516916370a08231916024808301926020929190829003018186803b15801561218f57600080fd5b505afa1580156121a3573d6000803e3d6000fd5b505050506040513d60208110156121b957600080fd5b5051145b612212576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526022815260200180612d286022913960400191505060405180910390fd5b8173ffffffffffffffffffffffffffffffffffffffff1663095ea7b387620186a06040518363ffffffff1660e01b8152600401808373ffffffffffffffffffffffffffffffffffffffff16815260200182815260200192505050602060405180830381600087803b15801561228657600080fd5b505af115801561229a573d6000803e3d6000fd5b505050506040513d60208110156122b057600080fd5b505180156123615750604080517fdd62ed3e00000000000000000000000000000000000000000000000000000000815230600482015273ffffffffffffffffffffffffffffffffffffffff888116602483015291519184169163dd62ed3e91604480820192602092909190829003018186803b15801561232f57600080fd5b505afa158015612343573d6000803e3d6000fd5b505050506040513d602081101561235957600080fd5b5051620186a0145b80156124125750604080517f23b872dd000000000000000000000000000000000000000000000000000000008152306004820152336024820152620186a06044820152905173ffffffffffffffffffffffffffffffffffffffff8816916323b872dd9160648083019260209291908290030181600087803b1580156123e557600080fd5b505af11580156123f9573d6000803e3d6000fd5b505050506040513d602081101561240f57600080fd5b50515b80156124b95750604080517fdd62ed3e000000000000000000000000000000000000000000000000000000008152306004820152336024820152905173ffffffffffffffffffffffffffffffffffffffff84169163dd62ed3e916044808301926020929190829003018186803b15801561248b57600080fd5b505afa15801561249f573d6000803e3d6000fd5b505050506040513d60208110156124b557600080fd5b5051155b801561256757506124cd8462030d40612b0d565b604080517f70a08231000000000000000000000000000000000000000000000000000000008152336004820152905173ffffffffffffffffffffffffffffffffffffffff8516916370a08231916024808301926020929190829003018186803b15801561253957600080fd5b505afa15801561254d573d6000803e3d6000fd5b505050506040513d602081101561256357600080fd5b5051145b8015612615575061257b8562030d40612b81565b604080517f70a08231000000000000000000000000000000000000000000000000000000008152306004820152905173ffffffffffffffffffffffffffffffffffffffff8516916370a08231916024808301926020929190829003018186803b1580156125e757600080fd5b505afa1580156125fb573d6000803e3d6000fd5b505050506040513d602081101561261157600080fd5b5051145b61266a576040517f08c379a000000000000000000000000000000000000000000000000000000000815260040180806020018281038252602e815260200180612dd7602e913960400191505060405180910390fd5b612672610244565b61267a612bf8565b505050505050565b60005473ffffffffffffffffffffffffffffffffffffffff16331461270857604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b600154600354604080517f8f28397000000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff928316600482015290519190921691638f28397091602480830192600092919082900301818387803b15801561277f57600080fd5b505af1158015612793573d6000803e3d6000fd5b5050505061279f612bf8565b565b60015473ffffffffffffffffffffffffffffffffffffffff1690565b60005473ffffffffffffffffffffffffffffffffffffffff16331461284357604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff81166128af576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526026815260200180612d6d6026913960400191505060405180910390fd5b6000546040805173ffffffffffffffffffffffffffffffffffffffff9283168152918316602083015280517f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09281900390910190a161290d81612c7d565b50565b60008160000151805190602001208360000151805190602001201480156129445750816020015160ff16836020015160ff16145b80156129655750816040015180519060200120836040015180519060200120145b80156129865750816060015180519060200120836060015180519060200120145b8015612999575081608001518360800151145b80156129d857508160a0015173ffffffffffffffffffffffffffffffffffffffff168360a0015173ffffffffffffffffffffffffffffffffffffffff16145b8015612a1757508160c0015173ffffffffffffffffffffffffffffffffffffffff168360c0015173ffffffffffffffffffffffffffffffffffffffff16145b8015612a5657508160e0015173ffffffffffffffffffffffffffffffffffffffff168360e0015173ffffffffffffffffffffffffffffffffffffffff16145b8015612a97575081610100015173ffffffffffffffffffffffffffffffffffffffff1683610100015173ffffffffffffffffffffffffffffffffffffffff16145b8015612ad8575081610120015173ffffffffffffffffffffffffffffffffffffffff1683610120015173ffffffffffffffffffffffffffffffffffffffff16145b8015612af1575081610140015115158361014001511515145b8015612b065750816101600151836101600151145b9392505050565b600082820183811015612b0657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601b60248201527f536166654d6174683a206164646974696f6e206f766572666c6f770000000000604482015290519081900360640190fd5b600082821115612bf257604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820152601e60248201527f536166654d6174683a207375627472616374696f6e206f766572666c6f770000604482015290519081900360640190fd5b50900390565b60048054604080517fec1e6a4f000000000000000000000000000000000000000000000000000000008152905173ffffffffffffffffffffffffffffffffffffffff9092169263ec1e6a4f92828201926000929082900301818387803b158015612c6157600080fd5b505af1158015612c75573d6000803e3d6000fd5b503392505050ff5b600080547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff92909216919091179055565b60408051610180810182526060808252600060208301819052928201819052808201526080810182905260a0810182905260c0810182905260e081018290526101008101829052610120810182905261014081018290526101608101919091529056fe56325f3255706772616465723a207472616e736665722074657374206661696c656456325f3255706772616465723a2062616c616e63654f662074657374206661696c65644f776e61626c653a206e6577206f776e657220697320746865207a65726f206164647265737356325f3255706772616465723a20302e322046696174546f6b656e206e656564656456325f3255706772616465723a206d657461646174612074657374206661696c656456325f3255706772616465723a20617070726f76652f7472616e7366657246726f6d2074657374206661696c6564a26469706673582212204819915d274abf3d15a3786f32e333cd2999420e94d010d1542e76b4cfa573f564736f6c634300060c0033",
+  "calls": [
+    {
+      "from": "0x9999fa87f5a1d1c64e7c709838b92006ab0cc1ad",
+      "gas": "0xd9acda",
+      "gasUsed": "0xbbe58",
+      "to": "0x4b2194b42ef7f4a41ba4ca3df6d1e140dc9972b2",
+      "input": "0x608060405234801561001057600080fd5b50604051610ebf380380610ebf8339818101604052602081101561003357600080fd5b5051808061004033610068565b600180546001600160a01b0319166001600160a01b03929092169190911790555061008a9050565b600080546001600160a01b0319166001600160a01b0392909216919091179055565b610e26806100996000396000f3fe608060405234801561001057600080fd5b50600436106101515760003560e01c80636d3c5bbe116100cd578063bd10243011610081578063ec1e6a4f11610066578063ec1e6a4f14610316578063ec55688914610320578063f2fde38b1461032857610151565b8063bd10243014610306578063e5a6b10f1461030e57610151565b80638da5cb5b116100b25780638da5cb5b146102ee57806395d89b41146102f65780639fd0506d146102fe57610151565b80636d3c5bbe146102b357806370a08231146102bb57610151565b806335d99f351161012457806338a631831161010957806338a631831461029b57806354fd4d50146102a35780635c975abb146102ab57610151565b806335d99f35146102625780633644e5151461029357610151565b806306fdde031461015657806318160ddd146101d357806323b872dd146101ed578063313ce56714610244575b600080fd5b61015e61035b565b6040805160208082528351818301528351919283929083019185019080838360005b83811015610198578181015183820152602001610180565b50505050905090810190601f1680156101c55780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b6101db6104d6565b60408051918252519081900360200190f35b6102306004803603606081101561020357600080fd5b5073ffffffffffffffffffffffffffffffffffffffff813581169160208101359091169060400135610572565b604080519115158252519081900360200190f35b61024c61062d565b6040805160ff9092168252519081900360200190f35b61026a610698565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b6101db610703565b61026a61076e565b61015e6107d9565b610230610844565b61026a6108af565b6101db600480360360208110156102d157600080fd5b503573ffffffffffffffffffffffffffffffffffffffff1661091a565b61026a6109c3565b61015e6109df565b61026a610a4a565b61026a610ab5565b61015e610b20565b61031e610b8b565b005b61026a610c14565b61031e6004803603602081101561033e57600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610c30565b600154604080517f06fdde03000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916306fdde03916004808301926000929190829003018186803b1580156103c657600080fd5b505afa1580156103da573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0168201604052602081101561042157600080fd5b810190808051604051939291908464010000000082111561044157600080fd5b90830190602082018581111561045657600080fd5b825164010000000081118282018810171561047057600080fd5b82525081516020918201929091019080838360005b8381101561049d578181015183820152602001610485565b50505050905090810190601f1680156104ca5780820380516001836020036101000a031916815260200191505b50604052505050905090565b600154604080517f18160ddd000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916318160ddd916004808301926020929190829003018186803b15801561054157600080fd5b505afa158015610555573d6000803e3d6000fd5b505050506040513d602081101561056b57600080fd5b5051905090565b600154604080517f23b872dd00000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8681166004830152858116602483015260448201859052915160009392909216916323b872dd9160648082019260209290919082900301818787803b1580156105f957600080fd5b505af115801561060d573d6000803e3d6000fd5b505050506040513d602081101561062357600080fd5b5051949350505050565b600154604080517f313ce567000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff169163313ce567916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f35d99f35000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916335d99f35916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f3644e515000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691633644e515916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f38a63183000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916338a63183916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f54fd4d50000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916354fd4d50916004808301926000929190829003018186803b1580156103c657600080fd5b600154604080517f5c975abb000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691635c975abb916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f8da5cb5b000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691638da5cb5b916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f70a0823100000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8481166004830152915160009392909216916370a0823191602480820192602092909190829003018186803b15801561099157600080fd5b505afa1580156109a5573d6000803e3d6000fd5b505050506040513d60208110156109bb57600080fd5b505192915050565b60005473ffffffffffffffffffffffffffffffffffffffff1690565b600154604080517f95d89b41000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916395d89b41916004808301926000929190829003018186803b1580156103c657600080fd5b600154604080517f9fd0506d000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691639fd0506d916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517fbd102430000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff169163bd102430916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517fe5a6b10f000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff169163e5a6b10f916004808301926000929190829003018186803b1580156103c657600080fd5b60005473ffffffffffffffffffffffffffffffffffffffff163314610c1157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b33ff5b60015473ffffffffffffffffffffffffffffffffffffffff1690565b60005473ffffffffffffffffffffffffffffffffffffffff163314610cb657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff8116610d22576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526026815260200180610dcb6026913960400191505060405180910390fd5b6000546040805173ffffffffffffffffffffffffffffffffffffffff9283168152918316602083015280517f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09281900390910190a1610d8081610d83565b50565b600080547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff9290921691909117905556fe4f776e61626c653a206e6577206f776e657220697320746865207a65726f2061646472657373a2646970667358221220383c813e998c1388f31580a958b4ef51a545c3007a0be737f82b32515a060b0d64736f6c634300060c0033000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
+      "output": "0x608060405234801561001057600080fd5b50600436106101515760003560e01c80636d3c5bbe116100cd578063bd10243011610081578063ec1e6a4f11610066578063ec1e6a4f14610316578063ec55688914610320578063f2fde38b1461032857610151565b8063bd10243014610306578063e5a6b10f1461030e57610151565b80638da5cb5b116100b25780638da5cb5b146102ee57806395d89b41146102f65780639fd0506d146102fe57610151565b80636d3c5bbe146102b357806370a08231146102bb57610151565b806335d99f351161012457806338a631831161010957806338a631831461029b57806354fd4d50146102a35780635c975abb146102ab57610151565b806335d99f35146102625780633644e5151461029357610151565b806306fdde031461015657806318160ddd146101d357806323b872dd146101ed578063313ce56714610244575b600080fd5b61015e61035b565b6040805160208082528351818301528351919283929083019185019080838360005b83811015610198578181015183820152602001610180565b50505050905090810190601f1680156101c55780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b6101db6104d6565b60408051918252519081900360200190f35b6102306004803603606081101561020357600080fd5b5073ffffffffffffffffffffffffffffffffffffffff813581169160208101359091169060400135610572565b604080519115158252519081900360200190f35b61024c61062d565b6040805160ff9092168252519081900360200190f35b61026a610698565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b6101db610703565b61026a61076e565b61015e6107d9565b610230610844565b61026a6108af565b6101db600480360360208110156102d157600080fd5b503573ffffffffffffffffffffffffffffffffffffffff1661091a565b61026a6109c3565b61015e6109df565b61026a610a4a565b61026a610ab5565b61015e610b20565b61031e610b8b565b005b61026a610c14565b61031e6004803603602081101561033e57600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610c30565b600154604080517f06fdde03000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916306fdde03916004808301926000929190829003018186803b1580156103c657600080fd5b505afa1580156103da573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0168201604052602081101561042157600080fd5b810190808051604051939291908464010000000082111561044157600080fd5b90830190602082018581111561045657600080fd5b825164010000000081118282018810171561047057600080fd5b82525081516020918201929091019080838360005b8381101561049d578181015183820152602001610485565b50505050905090810190601f1680156104ca5780820380516001836020036101000a031916815260200191505b50604052505050905090565b600154604080517f18160ddd000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916318160ddd916004808301926020929190829003018186803b15801561054157600080fd5b505afa158015610555573d6000803e3d6000fd5b505050506040513d602081101561056b57600080fd5b5051905090565b600154604080517f23b872dd00000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8681166004830152858116602483015260448201859052915160009392909216916323b872dd9160648082019260209290919082900301818787803b1580156105f957600080fd5b505af115801561060d573d6000803e3d6000fd5b505050506040513d602081101561062357600080fd5b5051949350505050565b600154604080517f313ce567000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff169163313ce567916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f35d99f35000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916335d99f35916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f3644e515000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691633644e515916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f38a63183000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916338a63183916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f54fd4d50000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916354fd4d50916004808301926000929190829003018186803b1580156103c657600080fd5b600154604080517f5c975abb000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691635c975abb916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f8da5cb5b000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691638da5cb5b916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f70a0823100000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8481166004830152915160009392909216916370a0823191602480820192602092909190829003018186803b15801561099157600080fd5b505afa1580156109a5573d6000803e3d6000fd5b505050506040513d60208110156109bb57600080fd5b505192915050565b60005473ffffffffffffffffffffffffffffffffffffffff1690565b600154604080517f95d89b41000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916395d89b41916004808301926000929190829003018186803b1580156103c657600080fd5b600154604080517f9fd0506d000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691639fd0506d916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517fbd102430000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff169163bd102430916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517fe5a6b10f000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff169163e5a6b10f916004808301926000929190829003018186803b1580156103c657600080fd5b60005473ffffffffffffffffffffffffffffffffffffffff163314610c1157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b33ff5b60015473ffffffffffffffffffffffffffffffffffffffff1690565b60005473ffffffffffffffffffffffffffffffffffffffff163314610cb657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff8116610d22576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526026815260200180610dcb6026913960400191505060405180910390fd5b6000546040805173ffffffffffffffffffffffffffffffffffffffff9283168152918316602083015280517f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09281900390910190a1610d8081610d83565b50565b600080547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff9290921691909117905556fe4f776e61626c653a206e6577206f776e657220697320746865207a65726f2061646472657373a2646970667358221220383c813e998c1388f31580a958b4ef51a545c3007a0be737f82b32515a060b0d64736f6c634300060c0033",
+      "value": "0x0",
+      "type": "CREATE"
+    }
+  ],
+  "value": "0x0",
+  "type": "CREATE"
+}
diff --git a/test/scripts/hardhat/testData/V2_2UpgraderHelperCreationBytecode.bin b/test/scripts/hardhat/testData/V2_2UpgraderHelperCreationBytecode.bin
new file mode 100644
index 000000000..9fb244bc1
--- /dev/null
+++ b/test/scripts/hardhat/testData/V2_2UpgraderHelperCreationBytecode.bin
@@ -0,0 +1 @@
+608060405234801561001057600080fd5b50604051610ebf380380610ebf8339818101604052602081101561003357600080fd5b5051808061004033610068565b600180546001600160a01b0319166001600160a01b03929092169190911790555061008a9050565b600080546001600160a01b0319166001600160a01b0392909216919091179055565b610e26806100996000396000f3fe608060405234801561001057600080fd5b50600436106101515760003560e01c80636d3c5bbe116100cd578063bd10243011610081578063ec1e6a4f11610066578063ec1e6a4f14610316578063ec55688914610320578063f2fde38b1461032857610151565b8063bd10243014610306578063e5a6b10f1461030e57610151565b80638da5cb5b116100b25780638da5cb5b146102ee57806395d89b41146102f65780639fd0506d146102fe57610151565b80636d3c5bbe146102b357806370a08231146102bb57610151565b806335d99f351161012457806338a631831161010957806338a631831461029b57806354fd4d50146102a35780635c975abb146102ab57610151565b806335d99f35146102625780633644e5151461029357610151565b806306fdde031461015657806318160ddd146101d357806323b872dd146101ed578063313ce56714610244575b600080fd5b61015e61035b565b6040805160208082528351818301528351919283929083019185019080838360005b83811015610198578181015183820152602001610180565b50505050905090810190601f1680156101c55780820380516001836020036101000a031916815260200191505b509250505060405180910390f35b6101db6104d6565b60408051918252519081900360200190f35b6102306004803603606081101561020357600080fd5b5073ffffffffffffffffffffffffffffffffffffffff813581169160208101359091169060400135610572565b604080519115158252519081900360200190f35b61024c61062d565b6040805160ff9092168252519081900360200190f35b61026a610698565b6040805173ffffffffffffffffffffffffffffffffffffffff9092168252519081900360200190f35b6101db610703565b61026a61076e565b61015e6107d9565b610230610844565b61026a6108af565b6101db600480360360208110156102d157600080fd5b503573ffffffffffffffffffffffffffffffffffffffff1661091a565b61026a6109c3565b61015e6109df565b61026a610a4a565b61026a610ab5565b61015e610b20565b61031e610b8b565b005b61026a610c14565b61031e6004803603602081101561033e57600080fd5b503573ffffffffffffffffffffffffffffffffffffffff16610c30565b600154604080517f06fdde03000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916306fdde03916004808301926000929190829003018186803b1580156103c657600080fd5b505afa1580156103da573d6000803e3d6000fd5b505050506040513d6000823e601f3d9081017fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffe0168201604052602081101561042157600080fd5b810190808051604051939291908464010000000082111561044157600080fd5b90830190602082018581111561045657600080fd5b825164010000000081118282018810171561047057600080fd5b82525081516020918201929091019080838360005b8381101561049d578181015183820152602001610485565b50505050905090810190601f1680156104ca5780820380516001836020036101000a031916815260200191505b50604052505050905090565b600154604080517f18160ddd000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916318160ddd916004808301926020929190829003018186803b15801561054157600080fd5b505afa158015610555573d6000803e3d6000fd5b505050506040513d602081101561056b57600080fd5b5051905090565b600154604080517f23b872dd00000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8681166004830152858116602483015260448201859052915160009392909216916323b872dd9160648082019260209290919082900301818787803b1580156105f957600080fd5b505af115801561060d573d6000803e3d6000fd5b505050506040513d602081101561062357600080fd5b5051949350505050565b600154604080517f313ce567000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff169163313ce567916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f35d99f35000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916335d99f35916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f3644e515000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691633644e515916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f38a63183000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff16916338a63183916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f54fd4d50000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916354fd4d50916004808301926000929190829003018186803b1580156103c657600080fd5b600154604080517f5c975abb000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691635c975abb916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f8da5cb5b000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691638da5cb5b916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517f70a0823100000000000000000000000000000000000000000000000000000000815273ffffffffffffffffffffffffffffffffffffffff8481166004830152915160009392909216916370a0823191602480820192602092909190829003018186803b15801561099157600080fd5b505afa1580156109a5573d6000803e3d6000fd5b505050506040513d60208110156109bb57600080fd5b505192915050565b60005473ffffffffffffffffffffffffffffffffffffffff1690565b600154604080517f95d89b41000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff16916395d89b41916004808301926000929190829003018186803b1580156103c657600080fd5b600154604080517f9fd0506d000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff1691639fd0506d916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517fbd102430000000000000000000000000000000000000000000000000000000008152905160009273ffffffffffffffffffffffffffffffffffffffff169163bd102430916004808301926020929190829003018186803b15801561054157600080fd5b600154604080517fe5a6b10f000000000000000000000000000000000000000000000000000000008152905160609273ffffffffffffffffffffffffffffffffffffffff169163e5a6b10f916004808301926000929190829003018186803b1580156103c657600080fd5b60005473ffffffffffffffffffffffffffffffffffffffff163314610c1157604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b33ff5b60015473ffffffffffffffffffffffffffffffffffffffff1690565b60005473ffffffffffffffffffffffffffffffffffffffff163314610cb657604080517f08c379a000000000000000000000000000000000000000000000000000000000815260206004820181905260248201527f4f776e61626c653a2063616c6c6572206973206e6f7420746865206f776e6572604482015290519081900360640190fd5b73ffffffffffffffffffffffffffffffffffffffff8116610d22576040517f08c379a0000000000000000000000000000000000000000000000000000000008152600401808060200182810382526026815260200180610dcb6026913960400191505060405180910390fd5b6000546040805173ffffffffffffffffffffffffffffffffffffffff9283168152918316602083015280517f8be0079c531659141344cd1fd0a4f28419497f9722a3daafe3b4186f6b6457e09281900390910190a1610d8081610d83565b50565b600080547fffffffffffffffffffffffff00000000000000000000000000000000000000001673ffffffffffffffffffffffffffffffffffffffff9290921691909117905556fe4f776e61626c653a206e6577206f776e657220697320746865207a65726f2061646472657373a2646970667358221220383c813e998c1388f31580a958b4ef51a545c3007a0be737f82b32515a060b0d64736f6c634300060c0033000000000000000000000000a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
\ No newline at end of file
diff --git a/test/scripts/hardhat/verifyOnChainBytecode.test.ts b/test/scripts/hardhat/verifyOnChainBytecode.test.ts
new file mode 100644
index 000000000..f701fd92c
--- /dev/null
+++ b/test/scripts/hardhat/verifyOnChainBytecode.test.ts
@@ -0,0 +1,314 @@
+/**
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
+ *
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import hre from "hardhat";
+import * as fs from "fs";
+import * as sinon from "sinon";
+import {
+  verifyOnChainBytecode,
+  BytecodeInputType,
+  BytecodeVerificationType,
+  extractBytecodeFromGethTraces,
+} from "../../../scripts/hardhat/verifyOnChainBytecode";
+import { BaseContract, Contract, ContractTransactionResponse } from "ethers";
+import { mkdirSync, writeFileSync } from "fs";
+import { HARDHAT_ACCOUNTS } from "../../helpers/constants";
+import {
+  ArtifactType,
+  opMainnetFiatTokenProxyContractCreationBytecode,
+} from "../../../scripts/hardhat/alternativeArtifacts";
+import V2_2UpgraderDeploymentTrace from "./testData/V2_2UpgraderDeploymentTrace.json";
+import * as Helpers from "../../../scripts/hardhat/helpers";
+
+describe("Verify on chain bytecode", () => {
+  let proxy: Contract;
+  let v22: Contract;
+  let signatureChecker: Contract;
+  let opMainnetArtifactFiatTokenProxy: BaseContract & {
+    deploymentTransaction(): ContractTransactionResponse;
+  };
+  let execSyncWrapperStub: sinon.SinonStub<[string], void>;
+
+  before("setup", async () => {
+    signatureChecker = await hre.ethers.deployContract("SignatureChecker");
+    const FiatTokenV2_2 = await hre.ethers.getContractFactory("FiatTokenV2_2", {
+      signer: await hre.ethers.getSigner(HARDHAT_ACCOUNTS[0]),
+      libraries: { SignatureChecker: signatureChecker.target },
+    });
+    v22 = await FiatTokenV2_2.deploy();
+    proxy = await hre.ethers.deployContract("FiatTokenProxy", [v22.target]);
+
+    // deploy a contract using the OP Mainnet artifact
+    const opMainnetFiatTokenProxyFactory = new hre.ethers.ContractFactory(
+      [],
+      opMainnetFiatTokenProxyContractCreationBytecode.slice(0, -40) +
+        (await v22.getAddress()).slice(2),
+      await hre.ethers.getSigner(HARDHAT_ACCOUNTS[0])
+    );
+    opMainnetArtifactFiatTokenProxy = await opMainnetFiatTokenProxyFactory.deploy();
+    await opMainnetArtifactFiatTokenProxy.waitForDeployment();
+  });
+
+  beforeEach(() => {
+    execSyncWrapperStub = sinon.stub(Helpers, "execSyncWrapper");
+  });
+
+  afterEach(() => {
+    sinon.restore();
+  });
+
+  it("rejects for an improper optimizerRuns", async () => {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const improperOptimizerRuns: any[] = ["&& do something", 1.1, -1, "1000"];
+
+    for (const improperOptimizerRun in improperOptimizerRuns) {
+      await expect(
+        verifyOnChainBytecode(
+          {
+            contractName: "FiatTokenProxy",
+            contractAddress: proxy.target as string,
+            verificationType: BytecodeVerificationType.Partial,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            optimizerRuns: improperOptimizerRun as any,
+          },
+          hre
+        )
+      ).to.be.rejectedWith("invalid optimizerRuns");
+    }
+  });
+
+  it("will execute the expected forge command when optimizerRuns is present", async () => {
+    const results = await verifyOnChainBytecode(
+      {
+        contractName: "FiatTokenProxy",
+        contractAddress: proxy.target as string,
+        verificationType: BytecodeVerificationType.Partial,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        optimizerRuns: 1000,
+      },
+      hre
+    );
+
+    expect(results).to.deep.equal([
+      { type: BytecodeInputType.RuntimeBytecodePartial, equal: true },
+    ]);
+
+    expect(
+      execSyncWrapperStub.calledOnceWithExactly(
+        "forge build --optimizer-runs 1000"
+      )
+    ).to.be.true;
+  });
+
+  it("Can detect mismatched metadata input", async () => {
+    const results = await verifyOnChainBytecode(
+      {
+        contractName: "FiatTokenProxy",
+        contractAddress: proxy.target as string,
+        verificationType: BytecodeVerificationType.Partial,
+        metadataFilePath:
+          // Contains mismatched metadata (auto generated by foundry instead of hardhat)
+          "test/scripts/hardhat/testData/FiatTokenProxy.metadata.json",
+      },
+      hre
+    );
+
+    expect(results).to.deep.equal([
+      { type: BytecodeInputType.RuntimeBytecodePartial, equal: true },
+      { type: BytecodeInputType.MetadataHash, equal: false },
+    ]);
+  });
+
+  it("Can detect mismatched constructor code", async () => {
+    expect(
+      await verifyOnChainBytecode(
+        {
+          contractName: "FiatTokenProxy",
+          contractAddress: proxy.target as string,
+          verificationType: BytecodeVerificationType.Partial,
+          contractCreationTxHash: v22.deploymentTransaction()?.hash, // Wrong transaction hash supplied
+        },
+        hre
+      )
+    ).to.deep.equal([
+      { type: BytecodeInputType.ConstructorCode, equal: false },
+      { type: BytecodeInputType.RuntimeBytecodePartial, equal: true },
+    ]);
+  });
+
+  it("Can detect mismatched runtime code", async () => {
+    expect(
+      await verifyOnChainBytecode(
+        {
+          contractName: "FiatTokenProxy",
+          contractAddress: v22.target as string, // Wrong contract address supplied
+          verificationType: BytecodeVerificationType.Partial,
+        },
+        hre
+      )
+    ).to.deep.equal([
+      { type: BytecodeInputType.RuntimeBytecodePartial, equal: false },
+    ]);
+  });
+
+  it("Can run partial verification on valid FiatTokenProxy contract", async () => {
+    const contractName = "FiatTokenProxy";
+    const contractDir = "contracts/v1/FiatTokenProxy.sol";
+    const metadataPath = await prepareMetadata(contractName, contractDir);
+
+    const results = await verifyOnChainBytecode(
+      {
+        contractName,
+        contractAddress: proxy.target as string,
+        verificationType: BytecodeVerificationType.Partial,
+        metadataFilePath: metadataPath,
+        contractCreationTxHash: proxy.deploymentTransaction()?.hash,
+      },
+      hre
+    );
+
+    expect(results).to.deep.equal([
+      { type: BytecodeInputType.ConstructorCode, equal: true },
+      { type: BytecodeInputType.RuntimeBytecodePartial, equal: true },
+      { type: BytecodeInputType.MetadataHash, equal: true },
+    ]);
+  });
+
+  it("Can run partial verification on valid FiatTokenV2_2 contract", async () => {
+    const contractName = "FiatTokenV2_2";
+    const contractDir = "contracts/v2/FiatTokenV2_2.sol";
+    const metadataPath = await prepareMetadata(contractName, contractDir);
+
+    const results = await verifyOnChainBytecode(
+      {
+        contractName,
+        contractAddress: v22.target as string,
+        libraryName: "SignatureChecker",
+        libraryAddress: signatureChecker.target as string,
+        verificationType: BytecodeVerificationType.Partial,
+        metadataFilePath: metadataPath,
+        contractCreationTxHash: v22.deploymentTransaction()?.hash,
+      },
+      hre
+    );
+
+    expect(results).to.deep.equal([
+      { type: BytecodeInputType.ConstructorCode, equal: true },
+      { type: BytecodeInputType.RuntimeBytecodePartial, equal: true },
+      { type: BytecodeInputType.MetadataHash, equal: true },
+    ]);
+  });
+
+  it("Can run partial verification on valid SignatureChecker contract", async () => {
+    const contractName = "SignatureChecker";
+    const contractDir = "contracts/util/SignatureChecker.sol";
+    const metadataPath = await prepareMetadata(contractName, contractDir);
+
+    const results = await verifyOnChainBytecode(
+      {
+        contractName,
+        contractAddress: signatureChecker.target as string,
+        verificationType: BytecodeVerificationType.Partial,
+        isLibrary: true,
+        metadataFilePath: metadataPath,
+        contractCreationTxHash: signatureChecker.deploymentTransaction()?.hash,
+      },
+      hre
+    );
+
+    expect(results).to.deep.equal([
+      { type: BytecodeInputType.ConstructorCode, equal: true },
+      { type: BytecodeInputType.RuntimeBytecodePartial, equal: true },
+      { type: BytecodeInputType.MetadataHash, equal: true },
+    ]);
+  });
+
+  it("Can run partial verification with bytecode input from a file", async () => {
+    expect(
+      await verifyOnChainBytecode(
+        {
+          contractName: "FiatTokenProxy",
+          contractAddress: proxy.target as string,
+          onchainBytecodeFilePath:
+            // Contains deployed bytecode from `artifacts/foundry/FiatTokenProxy.sol/FiatTokenProxy.json`, `
+            "test/scripts/hardhat/testData/FiatTokenProxy.bin",
+          verificationType: BytecodeVerificationType.Partial,
+        },
+        hre
+      )
+    ).to.deep.equal([
+      { type: BytecodeInputType.RuntimeBytecodePartial, equal: true },
+    ]);
+  });
+
+  it("Can use an alternative artifact for verification", async () => {
+    expect(
+      await verifyOnChainBytecode(
+        {
+          contractName: "FiatTokenProxy",
+          contractAddress: await opMainnetArtifactFiatTokenProxy.getAddress(),
+          verificationType: BytecodeVerificationType.Full,
+          artifactType: ArtifactType.OPMainnet,
+          contractCreationTxHash: opMainnetArtifactFiatTokenProxy.deploymentTransaction()
+            ?.hash,
+        },
+        hre
+      )
+    ).to.deep.equal([
+      { type: BytecodeInputType.ConstructorCode, equal: true },
+      { type: BytecodeInputType.RuntimeBytecodeFull, equal: true },
+    ]);
+  });
+
+  it("Can pull contract creation code from traces", async () => {
+    // example contract creation from internal transaction taken from: https://etherscan.io/tx/0x7f6268ff5bd05d1b61c19889a46eb9a38563accce441dcfcf0c7515b1733503e
+    // it's the deployment of the UpgraderHelper contract for V2_2Upgrader.sol
+    const expectedCreationBytecode =
+      "0x" +
+      fs.readFileSync(
+        "test/scripts/hardhat/testData/V2_2UpgraderHelperCreationBytecode.bin",
+        "utf-8"
+      );
+    const contractAddress = "0x4b2194B42EF7F4A41BA4cA3Df6D1E140dc9972b2";
+    expect(
+      extractBytecodeFromGethTraces(
+        V2_2UpgraderDeploymentTrace,
+        contractAddress
+      )
+    ).to.deep.equal(expectedCreationBytecode);
+  });
+});
+
+async function prepareMetadata(
+  contractName: string,
+  contractDir: string
+): Promise<string> {
+  const buildInfo = await hre.artifacts.getBuildInfo(
+    `${contractDir}:${contractName}`
+  );
+  const complierContractOutput = buildInfo?.output.contracts[contractDir][
+    contractName
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  ] as any;
+
+  const dirPath = `artifacts/test/${contractDir}`;
+  const metadataPath = `${dirPath}/${contractName}.metadata.json`;
+  mkdirSync(dirPath, { recursive: true });
+  writeFileSync(metadataPath, complierContractOutput.metadata, null);
+  return metadataPath;
+}
diff --git a/test/util/ECRecover.test.ts b/test/util/ECRecover.test.ts
index 98d588b2a..75709c235 100644
--- a/test/util/ECRecover.test.ts
+++ b/test/util/ECRecover.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/util/EIP712Test.ts b/test/util/EIP712Test.ts
index 6dff6374e..9f88f80c5 100644
--- a/test/util/EIP712Test.ts
+++ b/test/util/EIP712Test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/util/MessageHashUtils.test.ts b/test/util/MessageHashUtils.test.ts
index 21ea103df..cea13f2d8 100644
--- a/test/util/MessageHashUtils.test.ts
+++ b/test/util/MessageHashUtils.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/util/SignatureChecker.test.ts b/test/util/SignatureChecker.test.ts
index ff78374ef..8e96249b7 100644
--- a/test/util/SignatureChecker.test.ts
+++ b/test/util/SignatureChecker.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1.1/FiatTokenV1_1.test.ts b/test/v1.1/FiatTokenV1_1.test.ts
index e33314a85..00c94c01d 100644
--- a/test/v1.1/FiatTokenV1_1.test.ts
+++ b/test/v1.1/FiatTokenV1_1.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1.1/Rescuable.behavior.ts b/test/v1.1/Rescuable.behavior.ts
index de484bb19..6e24a0095 100644
--- a/test/v1.1/Rescuable.behavior.ts
+++ b/test/v1.1/Rescuable.behavior.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1.1/Rescuable.test.ts b/test/v1.1/Rescuable.test.ts
index 229af5147..ac6869bf3 100644
--- a/test/v1.1/Rescuable.test.ts
+++ b/test/v1.1/Rescuable.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/FiatTokenV1.test.ts b/test/v1/FiatTokenV1.test.ts
index 45860863b..e9413a169 100644
--- a/test/v1/FiatTokenV1.test.ts
+++ b/test/v1/FiatTokenV1.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/Pausable.test.js b/test/v1/Pausable.test.js
index 295f5616a..a6c0d0ab9 100644
--- a/test/v1/Pausable.test.js
+++ b/test/v1/Pausable.test.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/TokenTestUtils.js b/test/v1/TokenTestUtils.js
deleted file mode 100644
index e33eedbaf..000000000
--- a/test/v1/TokenTestUtils.js
+++ /dev/null
@@ -1,714 +0,0 @@
-/**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
- *
- * SPDX-License-Identifier: Apache-2.0
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-const util = require("util");
-const _ = require("lodash");
-const BN = require("bn.js");
-const Q = require("q");
-const BigNumber = require("bignumber.js");
-const {
-  arbitraryAccount,
-  tokenOwnerAccount,
-  masterMinterAccount,
-  minterAccount,
-  pauserAccount,
-  blacklisterAccount,
-  proxyOwnerAccount,
-  upgraderAccount,
-} = require("./helpers/tokenTest");
-const { ZERO_BYTES32 } = require("../helpers/constants");
-
-const FiatTokenV1 = artifacts.require("FiatTokenV1");
-const FiatTokenProxy = artifacts.require("FiatTokenProxy");
-
-const name = "Sample Fiat Token";
-const symbol = "C-USD";
-const currency = "USD";
-const decimals = 2;
-const trueInStorageFormat = "0x01";
-const bigZero = new BN(0);
-
-const adminSlot =
-  "0x10d6a54a4754c8869d6886b5f5d7fbfa5b4522237ea5c60d11bc4e7a1ff9390b";
-const implSlot =
-  "0x7050c9e0f4ca769c69bd3a8ef740bc37934f8e2c036e5a723fd8ee048ed3f8c3";
-
-// set to true to enable verbose logging in the tests
-const debugLogging = false;
-
-// Returns a new BN object
-function newBigNumber(value) {
-  const hex = new BigNumber(value).toString(16);
-  return new BN(hex, 16);
-}
-
-async function expectError(contractPromise, errorMsg) {
-  try {
-    await contractPromise;
-    assert.fail("Expected error " + errorMsg + ", but no error received");
-  } catch (error) {
-    const correctErrorMsgReceived = error.message.includes(errorMsg);
-    assert(
-      correctErrorMsgReceived,
-      `Expected ${errorMsg}, got ${error.message} instead`
-    );
-  }
-}
-
-// Creates a state object, with default values replaced by
-// customVars where appropriate.
-function buildExpectedState(token, customVars) {
-  // set each variable's default value
-  const expectedState = {
-    name,
-    symbol,
-    currency,
-    decimals: new BN(decimals),
-    masterMinter: masterMinterAccount,
-    pauser: pauserAccount,
-    blacklister: blacklisterAccount,
-    tokenOwner: tokenOwnerAccount,
-    proxiedTokenAddress: token.proxiedTokenAddress,
-    initializedV1: trueInStorageFormat,
-    upgrader: proxyOwnerAccount,
-    balanceAndBlacklistStates: {
-      arbitraryAccount: bigZero,
-      masterMinterAccount: bigZero,
-      minterAccount: bigZero,
-      pauserAccount: bigZero,
-      blacklisterAccount: bigZero,
-      tokenOwnerAccount: bigZero,
-      upgraderAccount: bigZero,
-    },
-    allowance: {
-      arbitraryAccount: {
-        masterMinterAccount: bigZero,
-        minterAccount: bigZero,
-        pauserAccount: bigZero,
-        blacklisterAccount: bigZero,
-        tokenOwnerAccount: bigZero,
-        arbitraryAccount: bigZero,
-        upgraderAccount: bigZero,
-      },
-      masterMinterAccount: {
-        arbitraryAccount: bigZero,
-        minterAccount: bigZero,
-        pauserAccount: bigZero,
-        blacklisterAccount: bigZero,
-        tokenOwnerAccount: bigZero,
-        masterMinterAccount: bigZero,
-        upgraderAccount: bigZero,
-      },
-      minterAccount: {
-        arbitraryAccount: bigZero,
-        masterMinterAccount: bigZero,
-        pauserAccount: bigZero,
-        blacklisterAccount: bigZero,
-        tokenOwnerAccount: bigZero,
-        minterAccount: bigZero,
-        upgraderAccount: bigZero,
-      },
-      pauserAccount: {
-        arbitraryAccount: bigZero,
-        masterMinterAccount: bigZero,
-        minterAccount: bigZero,
-        blacklisterAccount: bigZero,
-        tokenOwnerAccount: bigZero,
-        pauserAccount: bigZero,
-        upgraderAccount: bigZero,
-      },
-      blacklisterAccount: {
-        arbitraryAccount: bigZero,
-        masterMinterAccount: bigZero,
-        minterAccount: bigZero,
-        pauserAccount: bigZero,
-        tokenOwnerAccount: bigZero,
-        blacklisterAccount: bigZero,
-        upgraderAccount: bigZero,
-      },
-      tokenOwnerAccount: {
-        arbitraryAccount: bigZero,
-        masterMinterAccount: bigZero,
-        minterAccount: bigZero,
-        pauserAccount: bigZero,
-        blacklisterAccount: bigZero,
-        tokenOwnerAccount: bigZero,
-        upgraderAccount: bigZero,
-      },
-      upgraderAccount: {
-        arbitraryAccount: bigZero,
-        masterMinterAccount: bigZero,
-        minterAccount: bigZero,
-        pauserAccount: bigZero,
-        blacklisterAccount: bigZero,
-        tokenOwnerAccount: bigZero,
-        upgraderAccount: bigZero,
-      },
-    },
-    totalSupply: bigZero,
-    isAccountBlacklisted: {
-      arbitraryAccount: false,
-      masterMinterAccount: false,
-      minterAccount: false,
-      pauserAccount: false,
-      blacklisterAccount: false,
-      tokenOwnerAccount: false,
-      upgraderAccount: false,
-    },
-    isAccountMinter: {
-      arbitraryAccount: false,
-      masterMinterAccount: false,
-      minterAccount: false,
-      pauserAccount: false,
-      blacklisterAccount: false,
-      tokenOwnerAccount: false,
-      upgraderAccount: false,
-    },
-    minterAllowance: {
-      arbitraryAccount: bigZero,
-      masterMinterAccount: bigZero,
-      minterAccount: bigZero,
-      pauserAccount: bigZero,
-      blacklisterAccount: bigZero,
-      tokenOwnerAccount: bigZero,
-      upgraderAccount: bigZero,
-    },
-    paused: false,
-  };
-
-  // for each item in customVars, set the item in expectedState
-  let i;
-  for (i = 0; i < customVars.length; ++i) {
-    if (_.has(expectedState, customVars[i].variable)) {
-      if (
-        expectedState[customVars[i].variable] === customVars[i].expectedValue
-      ) {
-        throw new Error(
-          "variable " +
-            customVars[i].variable +
-            " to test has same default state as expected state"
-        );
-      } else {
-        _.set(
-          expectedState,
-          customVars[i].variable,
-          customVars[i].expectedValue
-        );
-      }
-    } else {
-      throw new Error(
-        "variable " + customVars[i].variable + " not found in expectedState"
-      );
-    }
-  }
-  return expectedState;
-}
-
-// BN-aware deep comparison
-function checkState(actual, expected, prefix) {
-  for (const k in actual) {
-    if (Object.prototype.hasOwnProperty.call(actual, k)) {
-      const path = prefix ? prefix + "." + k : k;
-      const actualV = actual[k];
-      const expectedV = expected[k];
-      if (typeof actualV === "object" && !BN.isBN(actualV)) {
-        checkState(actualV, expectedV, path);
-      } else {
-        const msg = `expected ${path} to equal ${expectedV}, got ${actualV}`;
-        if (BN.isBN(actualV)) {
-          assert.isTrue(actualV.eq(expectedV), msg);
-        } else {
-          assert.strictEqual(actualV, expectedV, msg);
-        }
-      }
-    }
-  }
-}
-
-// For testing variance of specific variables from their default values.
-// customVars is an array of objects of the form,
-// {'variable': <name of variable>, 'expectedValue': <expected value after modification>}
-// to reference nested variables, name variable using dot syntax, e.g. 'allowance.arbitraryAccount.minterAccount'
-async function checkVariables(_tokens, _customVars) {
-  // Iterate over array of tokens.
-  const numTokens = _tokens.length;
-  assert.strictEqual(numTokens, _customVars.length);
-  let n;
-  for (n = 0; n < numTokens; n++) {
-    const token = _tokens[n];
-    const customVars = _customVars[n];
-    const expectedState = buildExpectedState(token, customVars);
-    if (debugLogging) {
-      console.log(
-        util.inspect(expectedState, { showHidden: false, depth: null })
-      );
-    }
-
-    const actualState = await getActualState(token);
-    checkState(actualState, expectedState);
-
-    // Check that sum of individual balances equals totalSupply
-    const accounts = [
-      arbitraryAccount,
-      masterMinterAccount,
-      minterAccount,
-      pauserAccount,
-      blacklisterAccount,
-      tokenOwnerAccount,
-      upgraderAccount,
-    ];
-    let balanceSum = bigZero;
-    for (let i = 0; i < accounts.length; i++) {
-      balanceSum = balanceSum.add(await token.balanceOf(accounts[i]));
-    }
-    const totalSupply = await token.totalSupply();
-    assert.isTrue(balanceSum.eq(totalSupply));
-  }
-}
-
-function hexToAddress(hex) {
-  return web3.utils.toChecksumAddress(
-    "0x" + hex.replace(/^0x/, "").padStart(40, "0")
-  );
-}
-
-// build up actualState object to compare to expectedState object
-async function getActualState(token) {
-  return Q.all([
-    await token.name.call(),
-    await token.symbol.call(),
-    await token.currency.call(),
-    await token.decimals.call(),
-    await token.masterMinter.call(),
-    await token.pauser.call(),
-    await token.blacklister.call(),
-    await token.owner.call(),
-    await getImplementation(token),
-    await getAdmin(token),
-    await getInitializedV1(token),
-    await token.balanceOf(arbitraryAccount),
-    await token.balanceOf(masterMinterAccount),
-    await token.balanceOf(minterAccount),
-    await token.balanceOf(pauserAccount),
-    await token.balanceOf(blacklisterAccount),
-    await token.balanceOf(tokenOwnerAccount),
-    await token.balanceOf(upgraderAccount),
-    await token.allowance(arbitraryAccount, masterMinterAccount),
-    await token.allowance(arbitraryAccount, minterAccount),
-    await token.allowance(arbitraryAccount, pauserAccount),
-    await token.allowance(arbitraryAccount, blacklisterAccount),
-    await token.allowance(arbitraryAccount, tokenOwnerAccount),
-    await token.allowance(arbitraryAccount, arbitraryAccount),
-    await token.allowance(arbitraryAccount, upgraderAccount),
-    await token.allowance(masterMinterAccount, arbitraryAccount),
-    await token.allowance(masterMinterAccount, minterAccount),
-    await token.allowance(masterMinterAccount, pauserAccount),
-    await token.allowance(masterMinterAccount, blacklisterAccount),
-    await token.allowance(masterMinterAccount, tokenOwnerAccount),
-    await token.allowance(masterMinterAccount, masterMinterAccount),
-    await token.allowance(masterMinterAccount, upgraderAccount),
-    await token.allowance(minterAccount, arbitraryAccount),
-    await token.allowance(minterAccount, masterMinterAccount),
-    await token.allowance(minterAccount, pauserAccount),
-    await token.allowance(minterAccount, blacklisterAccount),
-    await token.allowance(minterAccount, tokenOwnerAccount),
-    await token.allowance(minterAccount, minterAccount),
-    await token.allowance(minterAccount, upgraderAccount),
-    await token.allowance(pauserAccount, arbitraryAccount),
-    await token.allowance(pauserAccount, masterMinterAccount),
-    await token.allowance(pauserAccount, minterAccount),
-    await token.allowance(pauserAccount, blacklisterAccount),
-    await token.allowance(pauserAccount, tokenOwnerAccount),
-    await token.allowance(pauserAccount, pauserAccount),
-    await token.allowance(pauserAccount, upgraderAccount),
-    await token.allowance(blacklisterAccount, arbitraryAccount),
-    await token.allowance(blacklisterAccount, masterMinterAccount),
-    await token.allowance(blacklisterAccount, minterAccount),
-    await token.allowance(blacklisterAccount, pauserAccount),
-    await token.allowance(blacklisterAccount, tokenOwnerAccount),
-    await token.allowance(blacklisterAccount, blacklisterAccount),
-    await token.allowance(blacklisterAccount, upgraderAccount),
-    await token.allowance(tokenOwnerAccount, arbitraryAccount),
-    await token.allowance(tokenOwnerAccount, masterMinterAccount),
-    await token.allowance(tokenOwnerAccount, minterAccount),
-    await token.allowance(tokenOwnerAccount, pauserAccount),
-    await token.allowance(tokenOwnerAccount, blacklisterAccount),
-    await token.allowance(tokenOwnerAccount, tokenOwnerAccount),
-    await token.allowance(tokenOwnerAccount, upgraderAccount),
-    await token.allowance(upgraderAccount, arbitraryAccount),
-    await token.allowance(upgraderAccount, masterMinterAccount),
-    await token.allowance(upgraderAccount, minterAccount),
-    await token.allowance(upgraderAccount, pauserAccount),
-    await token.allowance(upgraderAccount, blacklisterAccount),
-    await token.allowance(upgraderAccount, tokenOwnerAccount),
-    await token.allowance(upgraderAccount, upgraderAccount),
-    await token.totalSupply(),
-    await token.isBlacklisted(arbitraryAccount),
-    await token.isBlacklisted(masterMinterAccount),
-    await token.isBlacklisted(minterAccount),
-    await token.isBlacklisted(pauserAccount),
-    await token.isBlacklisted(blacklisterAccount),
-    await token.isBlacklisted(tokenOwnerAccount),
-    await token.isBlacklisted(upgraderAccount),
-    await token.isMinter(arbitraryAccount),
-    await token.isMinter(masterMinterAccount),
-    await token.isMinter(minterAccount),
-    await token.isMinter(pauserAccount),
-    await token.isMinter(blacklisterAccount),
-    await token.isMinter(tokenOwnerAccount),
-    await token.isMinter(upgraderAccount),
-    await token.minterAllowance(arbitraryAccount),
-    await token.minterAllowance(masterMinterAccount),
-    await token.minterAllowance(minterAccount),
-    await token.minterAllowance(pauserAccount),
-    await token.minterAllowance(blacklisterAccount),
-    await token.minterAllowance(tokenOwnerAccount),
-    await token.minterAllowance(upgraderAccount),
-    await token.paused(),
-  ]).spread(
-    (
-      name,
-      symbol,
-      currency,
-      decimals,
-      masterMinter,
-      pauser,
-      blacklister,
-      tokenOwner,
-      proxiedTokenAddress,
-      upgrader,
-      initializedV1,
-      balancesA,
-      balancesMM,
-      balancesM,
-      balancesP,
-      balancesB,
-      balancesRAC,
-      balancesU,
-      allowanceAtoMM,
-      allowanceAtoM,
-      allowanceAtoP,
-      allowanceAtoB,
-      allowanceAtoRAC,
-      allowanceAtoA,
-      allowanceAtoU,
-      allowanceMMtoA,
-      allowanceMMtoM,
-      allowanceMMtoP,
-      allowanceMMtoB,
-      allowanceMMtoRAC,
-      allowanceMMtoMM,
-      allowanceMMtoU,
-      allowanceMtoA,
-      allowanceMtoMM,
-      allowanceMtoP,
-      allowanceMtoB,
-      allowanceMtoRAC,
-      allowanceMtoM,
-      allowanceMtoU,
-      allowancePtoA,
-      allowancePtoMM,
-      allowancePtoM,
-      allowancePtoB,
-      allowancePtoRAC,
-      allowancePtoP,
-      allowancePtoU,
-      allowanceBtoA,
-      allowanceBtoMM,
-      allowanceBtoM,
-      allowanceBtoP,
-      allowanceBtoRAC,
-      allowanceBtoB,
-      allowanceBtoU,
-      allowanceRACtoA,
-      allowanceRACtoMM,
-      allowanceRACtoM,
-      allowanceRACtoP,
-      allowanceRACtoB,
-      allowanceRACtoRAC,
-      allowanceRACtoU,
-      allowanceUtoA,
-      allowanceUtoMM,
-      allowanceUtoM,
-      allowanceUtoP,
-      allowanceUtoB,
-      allowanceUtoRAC,
-      allowanceUtoU,
-      totalSupply,
-      isAccountBlacklistedA,
-      isAccountBlacklistedMM,
-      isAccountBlacklistedM,
-      isAccountBlacklistedP,
-      isAccountBlacklistedB,
-      isAccountBlacklistedRAC,
-      isAccountBlacklistedU,
-      isAccountMinterA,
-      isAccountMinterMM,
-      isAccountMinterM,
-      isAccountMinterP,
-      isAccountMinterB,
-      isAccountMinterRAC,
-      isAccountMinterU,
-      minterAllowanceA,
-      minterAllowanceMM,
-      minterAllowanceM,
-      minterAllowanceP,
-      minterAllowanceB,
-      minterAllowanceRAC,
-      minterAllowanceU,
-      paused
-    ) => {
-      const actualState = {
-        name,
-        symbol,
-        currency,
-        decimals,
-        masterMinter: hexToAddress(masterMinter),
-        pauser: hexToAddress(pauser),
-        blacklister: hexToAddress(blacklister),
-        tokenOwner: hexToAddress(tokenOwner),
-        proxiedTokenAddress: hexToAddress(proxiedTokenAddress),
-        upgrader: hexToAddress(upgrader),
-        initializedV1,
-        balanceAndBlacklistStates: {
-          arbitraryAccount: balancesA,
-          masterMinterAccount: balancesMM,
-          minterAccount: balancesM,
-          pauserAccount: balancesP,
-          blacklisterAccount: balancesB,
-          tokenOwnerAccount: balancesRAC,
-          upgraderAccount: balancesU,
-        },
-        allowance: {
-          arbitraryAccount: {
-            masterMinterAccount: allowanceAtoMM,
-            minterAccount: allowanceAtoM,
-            pauserAccount: allowanceAtoP,
-            blacklisterAccount: allowanceAtoB,
-            tokenOwnerAccount: allowanceAtoRAC,
-            arbitraryAccount: allowanceAtoA,
-            upgraderAccount: allowanceAtoU,
-          },
-          masterMinterAccount: {
-            arbitraryAccount: allowanceMMtoA,
-            minterAccount: allowanceMMtoM,
-            pauserAccount: allowanceMMtoP,
-            blacklisterAccount: allowanceMMtoB,
-            tokenOwnerAccount: allowanceMMtoRAC,
-            masterMinterAccount: allowanceMMtoMM,
-            upgraderAccount: allowanceMMtoU,
-          },
-          minterAccount: {
-            arbitraryAccount: allowanceMtoA,
-            masterMinterAccount: allowanceMtoMM,
-            pauserAccount: allowanceMtoP,
-            blacklisterAccount: allowanceMtoB,
-            tokenOwnerAccount: allowanceMtoRAC,
-            minterAccount: allowanceMtoM,
-            upgraderAccount: allowanceMtoU,
-          },
-          pauserAccount: {
-            arbitraryAccount: allowancePtoA,
-            masterMinterAccount: allowancePtoMM,
-            minterAccount: allowancePtoM,
-            blacklisterAccount: allowancePtoB,
-            tokenOwnerAccount: allowancePtoRAC,
-            pauserAccount: allowancePtoP,
-            upgraderAccount: allowancePtoU,
-          },
-          blacklisterAccount: {
-            arbitraryAccount: allowanceBtoA,
-            masterMinterAccount: allowanceBtoMM,
-            minterAccount: allowanceBtoM,
-            pauserAccount: allowanceBtoP,
-            tokenOwnerAccount: allowanceBtoRAC,
-            blacklisterAccount: allowanceBtoB,
-            upgraderAccount: allowanceBtoU,
-          },
-          tokenOwnerAccount: {
-            arbitraryAccount: allowanceRACtoA,
-            masterMinterAccount: allowanceRACtoMM,
-            minterAccount: allowanceRACtoM,
-            pauserAccount: allowanceRACtoP,
-            blacklisterAccount: allowanceRACtoB,
-            tokenOwnerAccount: allowanceRACtoRAC,
-            upgraderAccount: allowanceRACtoU,
-          },
-          upgraderAccount: {
-            arbitraryAccount: allowanceUtoA,
-            masterMinterAccount: allowanceUtoMM,
-            minterAccount: allowanceUtoM,
-            pauserAccount: allowanceUtoP,
-            blacklisterAccount: allowanceUtoB,
-            tokenOwnerAccount: allowanceUtoRAC,
-            upgraderAccount: allowanceUtoU,
-          },
-        },
-        totalSupply,
-        isAccountBlacklisted: {
-          arbitraryAccount: isAccountBlacklistedA,
-          masterMinterAccount: isAccountBlacklistedMM,
-          minterAccount: isAccountBlacklistedM,
-          pauserAccount: isAccountBlacklistedP,
-          blacklisterAccount: isAccountBlacklistedB,
-          tokenOwnerAccount: isAccountBlacklistedRAC,
-          upgraderAccount: isAccountBlacklistedU,
-        },
-        isAccountMinter: {
-          arbitraryAccount: isAccountMinterA,
-          masterMinterAccount: isAccountMinterMM,
-          minterAccount: isAccountMinterM,
-          pauserAccount: isAccountMinterP,
-          blacklisterAccount: isAccountMinterB,
-          tokenOwnerAccount: isAccountMinterRAC,
-          upgraderAccount: isAccountMinterU,
-        },
-        minterAllowance: {
-          arbitraryAccount: minterAllowanceA,
-          masterMinterAccount: minterAllowanceMM,
-          minterAccount: minterAllowanceM,
-          pauserAccount: minterAllowanceP,
-          blacklisterAccount: minterAllowanceB,
-          tokenOwnerAccount: minterAllowanceRAC,
-          upgraderAccount: minterAllowanceU,
-        },
-        paused,
-      };
-      return actualState;
-    }
-  );
-}
-
-async function initializeTokenWithProxy(rawToken) {
-  return customInitializeTokenWithProxy(
-    rawToken,
-    masterMinterAccount,
-    pauserAccount,
-    blacklisterAccount,
-    tokenOwnerAccount
-  );
-}
-
-async function customInitializeTokenWithProxy(
-  rawToken,
-  _masterMinter,
-  _pauser,
-  _blacklister,
-  _owner
-) {
-  const proxy = await FiatTokenProxy.new(rawToken.address, {
-    from: proxyOwnerAccount,
-  });
-  const proxiedToken = await FiatTokenV1.at(proxy.address);
-  await proxiedToken.initialize(
-    name,
-    symbol,
-    currency,
-    decimals,
-    _masterMinter,
-    _pauser,
-    _blacklister,
-    _owner
-  );
-  proxiedToken.proxiedTokenAddress = rawToken.address;
-  assert.strictEqual(proxiedToken.address, proxy.address);
-  assert.notEqual(proxiedToken.address, rawToken.address);
-  const tokenConfig = {
-    proxy,
-    token: proxiedToken,
-  };
-  return tokenConfig;
-}
-
-async function expectRevert(contractPromise) {
-  try {
-    await contractPromise;
-  } catch (error) {
-    assert.isTrue(
-      error.message.includes("revert"),
-      "Expected error of type revert, got '" + error + "' instead"
-    );
-    return;
-  }
-  assert.fail("Expected error of type revert, but no error was received");
-}
-
-async function getAdmin(proxy) {
-  const adm = await web3.eth.getStorageAt(proxy.address, adminSlot);
-  return web3.utils.toChecksumAddress("0x" + adm.slice(26));
-}
-
-async function getImplementation(proxy) {
-  const impl = await web3.eth.getStorageAt(proxy.address, implSlot);
-  return web3.utils.toChecksumAddress("0x" + impl.slice(26));
-}
-
-async function getInitializedV1(token) {
-  const slot8Data = await web3.eth.getStorageAt(token.address, 8);
-  let initialized;
-
-  if (slot8Data === ZERO_BYTES32) {
-    // validate proxy not yet initialized
-    for (let i = 0; i <= 20; i++) {
-      assert.strictEqual(
-        ZERO_BYTES32,
-        await web3.eth.getStorageAt(token.address, i)
-      );
-    }
-    initialized = ZERO_BYTES32;
-  } else {
-    if (slot8Data.length !== 66) {
-      assert.fail("slot8Data unexpected size");
-    }
-    // String layout
-    // 2 chars - 0x
-    // 22 zeroes chars
-    // 2 chars - initialized (bool)
-    // 40 chars - masterMinter (address)
-    initialized = "0x" + slot8Data.slice(24, 26);
-    const masterMinterAddress = web3.utils.toChecksumAddress(
-      "0x" + slot8Data.slice(26)
-    );
-    const expectedMasterMinterAddress = await token.masterMinter.call();
-    assert.strictEqual(masterMinterAddress, expectedMasterMinterAddress);
-  }
-  return initialized;
-}
-
-// _contracts is an array of exactly two values: a FiatTokenV1 and a MintController
-// _customVars is an array of exactly two values: the expected state of the FiatTokenV1
-// and the expected state of the MintController
-async function checkMINTp0(_contracts, _customVars) {
-  assert.equal(_contracts.length, 2);
-  assert.equal(_customVars.length, 2);
-
-  // the first is a FiatTokenV1
-  await checkVariables([_contracts[0]], [_customVars[0]]);
-
-  // the second is a MintController
-  await _customVars[1].checkState(_contracts[1]);
-}
-
-module.exports = {
-  bigZero,
-  checkMINTp0,
-  expectRevert,
-  expectError,
-  initializeTokenWithProxy,
-  newBigNumber,
-};
diff --git a/test/v1/abiHacking.test.js b/test/v1/abiHacking.test.js
index 4446eea43..99550f9ef 100644
--- a/test/v1/abiHacking.test.js
+++ b/test/v1/abiHacking.test.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/events.test.js b/test/v1/events.test.js
index 8e987c86e..9b7f22380 100644
--- a/test/v1/events.test.js
+++ b/test/v1/events.test.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/extendedPositive.test.js b/test/v1/extendedPositive.test.js
index 3b0ddeb44..9a33d2b59 100644
--- a/test/v1/extendedPositive.test.js
+++ b/test/v1/extendedPositive.test.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/helpers/abi.js b/test/v1/helpers/abi.js
index 1607c50e7..fb6761983 100644
--- a/test/v1/helpers/abi.js
+++ b/test/v1/helpers/abi.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/helpers/tokenTest.js b/test/v1/helpers/tokenTest.js
index 96ad52c0b..3bad40967 100644
--- a/test/v1/helpers/tokenTest.js
+++ b/test/v1/helpers/tokenTest.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -20,6 +20,7 @@ const util = require("util");
 const abi = require("ethereumjs-abi");
 const _ = require("lodash");
 const BN = require("bn.js");
+const BigNumber = require("bignumber.js");
 const Q = require("q");
 
 const {
@@ -230,8 +231,10 @@ function checkBurnEvents(burning, amount, burner) {
   assert.isTrue(burning.logs[1].args.value.eq(new BN(amount)));
 }
 
-// Creates a state object, with default values replaced by
-// customVars where appropriate.
+/**
+ * Creates a state object, with default values replaced
+ * by customVars where appropriate.
+ */
 function buildExpectedState(token, customVars) {
   // set each variable's default value
   const expectedState = {
@@ -379,7 +382,9 @@ function buildExpectedState(token, customVars) {
   return expectedState;
 }
 
-// BN-aware deep comparison
+/**
+ *  BN-aware deep comparison
+ */
 function checkState(actual, expected, prefix) {
   for (const k in actual) {
     if (Object.prototype.hasOwnProperty.call(actual, k)) {
@@ -400,10 +405,15 @@ function checkState(actual, expected, prefix) {
   }
 }
 
-// For testing variance of specific variables from their default values.
-// customVars is an array of objects of the form,
-// {'variable': <name of variable>, 'expectedValue': <expected value after modification>}
-// to reference nested variables, name variable using dot syntax, e.g. 'allowance.arbitraryAccount.minterAccount'
+/**
+ * For testing variance of specific variables from their default values
+ *
+ * @param _tokens is an array of tokens
+ * @param _customVars is an array of objects of the form,
+ * {'variable': <name of variable>, 'expectedValue': <expected value after modification>}
+ *
+ * To reference nested variables, name variable using dot syntax, e.g. 'allowance.arbitraryAccount.minterAccount'
+ */
 async function checkVariables(_tokens, _customVars) {
   // Iterate over array of tokens.
   const numTokens = _tokens.length;
@@ -447,7 +457,9 @@ function hexToAddress(hex) {
   );
 }
 
-// build up actualState object to compare to expectedState object
+/**
+ * Build up actualState object to compare to expectedState object
+ */
 async function getActualState(token) {
   return Q.all([
     await token.name.call(),
@@ -1003,6 +1015,45 @@ async function deployUpgradedFiatTokenNewFields(version) {
   }
 }
 
+/**
+ * Returns a new BN object
+ */
+function newBigNumber(value) {
+  const hex = new BigNumber(value).toString(16);
+  return new BN(hex, 16);
+}
+
+async function expectError(contractPromise, errorMsg) {
+  try {
+    await contractPromise;
+    assert.fail("Expected error " + errorMsg + ", but no error received");
+  } catch (error) {
+    const correctErrorMsgReceived = error.message.includes(errorMsg);
+    assert(
+      correctErrorMsgReceived,
+      `Expected ${errorMsg}, got ${error.message} instead`
+    );
+  }
+}
+
+/**
+ * Check to ensure correct format of the two inputs
+ *
+ * @param _contracts is an array of exactly two values: a FiatTokenV1 and a MintController
+ * @param _customVars is an array of exactly two values: the expected state of the FiatTokenV1
+ * and the expected state of the MintController
+ */
+async function checkMINTp0(_contracts, _customVars) {
+  assert.equal(_contracts.length, 2);
+  assert.equal(_customVars.length, 2);
+
+  // the first is a FiatTokenV1
+  await checkVariables([_contracts[0]], [_customVars[0]]);
+
+  // the second is a MintController
+  await _customVars[1].checkState(_contracts[1]);
+}
+
 module.exports = {
   FiatTokenV1,
   FiatTokenProxy,
@@ -1015,6 +1066,8 @@ module.exports = {
   bigZero,
   bigHundred,
   debugLogging,
+  newBigNumber,
+  checkMINTp0,
   calculateFeeAmount,
   checkTransferEvents,
   checkMinterConfiguredEvent,
@@ -1052,6 +1105,7 @@ module.exports = {
   customInitializeTokenWithProxy,
   upgradeTo,
   expectRevert,
+  expectError,
   encodeCall,
   getInitializedV1,
   nullAccount: ZERO_ADDRESS,
diff --git a/test/v1/helpers/wrapTests.js b/test/v1/helpers/wrapTests.js
index eb22f2998..b40977b90 100644
--- a/test/v1/helpers/wrapTests.js
+++ b/test/v1/helpers/wrapTests.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/legacy.test.js b/test/v1/legacy.test.js
index 51d095502..6a4fbe538 100644
--- a/test/v1/legacy.test.js
+++ b/test/v1/legacy.test.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/misc.test.js b/test/v1/misc.test.js
index 676435d76..31baff3a7 100644
--- a/test/v1/misc.test.js
+++ b/test/v1/misc.test.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/negative.test.js b/test/v1/negative.test.js
index c6e143de3..28ebc6ed5 100644
--- a/test/v1/negative.test.js
+++ b/test/v1/negative.test.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/positive.test.js b/test/v1/positive.test.js
index 87f278dfe..61a326c2b 100644
--- a/test/v1/positive.test.js
+++ b/test/v1/positive.test.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/proxyNegative.test.js b/test/v1/proxyNegative.test.js
index 307fd600f..f6ade4e38 100644
--- a/test/v1/proxyNegative.test.js
+++ b/test/v1/proxyNegative.test.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v1/proxyPositive.test.js b/test/v1/proxyPositive.test.js
index deed07557..0a2f1d241 100644
--- a/test/v1/proxyPositive.test.js
+++ b/test/v1/proxyPositive.test.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/FiatTokenV2.test.ts b/test/v2/FiatTokenV2.test.ts
index d6cf500c4..0226d8a92 100644
--- a/test/v2/FiatTokenV2.test.ts
+++ b/test/v2/FiatTokenV2.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/FiatTokenV2_1.test.ts b/test/v2/FiatTokenV2_1.test.ts
index 1bb78f4f1..3fd7cc30b 100644
--- a/test/v2/FiatTokenV2_1.test.ts
+++ b/test/v2/FiatTokenV2_1.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/FiatTokenV2_2.test.ts b/test/v2/FiatTokenV2_2.test.ts
index 45e95de7f..397b73014 100644
--- a/test/v2/FiatTokenV2_2.test.ts
+++ b/test/v2/FiatTokenV2_2.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/GasAbstraction/GasAbstraction.behavior.ts b/test/v2/GasAbstraction/GasAbstraction.behavior.ts
index 1be177f87..e7508ce20 100644
--- a/test/v2/GasAbstraction/GasAbstraction.behavior.ts
+++ b/test/v2/GasAbstraction/GasAbstraction.behavior.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/GasAbstraction/helpers.ts b/test/v2/GasAbstraction/helpers.ts
index 2e3a0dd64..c91bc752e 100644
--- a/test/v2/GasAbstraction/helpers.ts
+++ b/test/v2/GasAbstraction/helpers.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/GasAbstraction/testCancelAuthorization.ts b/test/v2/GasAbstraction/testCancelAuthorization.ts
index e5ba0b9b7..e3feec894 100644
--- a/test/v2/GasAbstraction/testCancelAuthorization.ts
+++ b/test/v2/GasAbstraction/testCancelAuthorization.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/GasAbstraction/testPermit.ts b/test/v2/GasAbstraction/testPermit.ts
index 5a98c4a3e..1b4d03315 100644
--- a/test/v2/GasAbstraction/testPermit.ts
+++ b/test/v2/GasAbstraction/testPermit.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/GasAbstraction/testReceiveWithAuthorization.ts b/test/v2/GasAbstraction/testReceiveWithAuthorization.ts
index 6edf0fdbd..e2c584d25 100644
--- a/test/v2/GasAbstraction/testReceiveWithAuthorization.ts
+++ b/test/v2/GasAbstraction/testReceiveWithAuthorization.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/GasAbstraction/testTransferWithAuthorization.ts b/test/v2/GasAbstraction/testTransferWithAuthorization.ts
index f22e38ef6..88fed60d6 100644
--- a/test/v2/GasAbstraction/testTransferWithAuthorization.ts
+++ b/test/v2/GasAbstraction/testTransferWithAuthorization.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/GasAbstraction/testTransferWithMultipleAuthorizations.ts b/test/v2/GasAbstraction/testTransferWithMultipleAuthorizations.ts
index a299dc0e5..7ece62bc9 100644
--- a/test/v2/GasAbstraction/testTransferWithMultipleAuthorizations.ts
+++ b/test/v2/GasAbstraction/testTransferWithMultipleAuthorizations.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/MockFiatTokenWithEditableBalanceAndBlacklistStates.test.ts b/test/v2/MockFiatTokenWithEditableBalanceAndBlacklistStates.test.ts
index 2af7a6534..8264c92db 100644
--- a/test/v2/MockFiatTokenWithEditableBalanceAndBlacklistStates.test.ts
+++ b/test/v2/MockFiatTokenWithEditableBalanceAndBlacklistStates.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/MockFiatTokenWithEditableChainId.test.ts b/test/v2/MockFiatTokenWithEditableChainId.test.ts
index 8593c3f24..f1d745d50 100644
--- a/test/v2/MockFiatTokenWithEditableChainId.test.ts
+++ b/test/v2/MockFiatTokenWithEditableChainId.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/V2Upgrader.test.ts b/test/v2/V2Upgrader.test.ts
index 91938cd82..694bc7335 100644
--- a/test/v2/V2Upgrader.test.ts
+++ b/test/v2/V2Upgrader.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/V2_1Upgrader.test.ts b/test/v2/V2_1Upgrader.test.ts
index 21ae256c2..a8766259c 100644
--- a/test/v2/V2_1Upgrader.test.ts
+++ b/test/v2/V2_1Upgrader.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/V2_2Upgrader.test.ts b/test/v2/V2_2Upgrader.test.ts
index 7d6da986f..f2d2d64e1 100644
--- a/test/v2/V2_2Upgrader.test.ts
+++ b/test/v2/V2_2Upgrader.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/celo/FiatTokenCeloV2_2.test.ts b/test/v2/celo/FiatTokenCeloV2_2.test.ts
index 209bae9cf..d23df5e71 100644
--- a/test/v2/celo/FiatTokenCeloV2_2.test.ts
+++ b/test/v2/celo/FiatTokenCeloV2_2.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/celo/FiatTokenFeeAdapterV1.test.ts b/test/v2/celo/FiatTokenFeeAdapterV1.test.ts
index a7ff6d9e8..0e12baee9 100644
--- a/test/v2/celo/FiatTokenFeeAdapterV1.test.ts
+++ b/test/v2/celo/FiatTokenFeeAdapterV1.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/celo/MockFiatTokenCeloWithExposedFunctions.test.ts b/test/v2/celo/MockFiatTokenCeloWithExposedFunctions.test.ts
index 17c0acaee..35c650c7d 100644
--- a/test/v2/celo/MockFiatTokenCeloWithExposedFunctions.test.ts
+++ b/test/v2/celo/MockFiatTokenCeloWithExposedFunctions.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/celo/MockFiatTokenFeeAdapterWithExposedFunctions.test.ts b/test/v2/celo/MockFiatTokenFeeAdapterWithExposedFunctions.test.ts
index 7a9dcf71f..74e4aab01 100644
--- a/test/v2/celo/MockFiatTokenFeeAdapterWithExposedFunctions.test.ts
+++ b/test/v2/celo/MockFiatTokenFeeAdapterWithExposedFunctions.test.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/safeAllowance.behavior.ts b/test/v2/safeAllowance.behavior.ts
index 1423420d7..40f49a584 100644
--- a/test/v2/safeAllowance.behavior.ts
+++ b/test/v2/safeAllowance.behavior.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/v2.behavior.ts b/test/v2/v2.behavior.ts
index 3f2f2ce7b..d3262cafc 100644
--- a/test/v2/v2.behavior.ts
+++ b/test/v2/v2.behavior.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/test/v2/v2_2.behavior.ts b/test/v2/v2_2.behavior.ts
index 8e4f4e80c..080410a65 100644
--- a/test/v2/v2_2.behavior.ts
+++ b/test/v2/v2_2.behavior.ts
@@ -1,5 +1,5 @@
 /**
- * Copyright 2024 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2024 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/utils.js b/utils.js
index 0e759b427..b4ee3a5c5 100644
--- a/utils.js
+++ b/utils.js
@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Circle Internet Financial, LTD. All rights reserved.
+ * Copyright 2023 Circle Internet Group, Inc. All rights reserved.
  *
  * SPDX-License-Identifier: Apache-2.0
  *
diff --git a/verification_artifacts/input.template.json b/verification_artifacts/input.template.json
new file mode 100644
index 000000000..bc61264bd
--- /dev/null
+++ b/verification_artifacts/input.template.json
@@ -0,0 +1,15 @@
+{
+  "SignatureChecker": {
+    "contractAddress": "",
+    "contractCreationTxHash": ""
+  },
+  "FiatTokenV2_2": {
+    "contractAddress": "",
+    "contractCreationTxHash": ""
+  },
+  "FiatTokenProxy": {
+    "contractAddress": "",
+    "contractCreationTxHash": ""
+  },
+  "rpcUrl": ""
+}
diff --git a/yarn.lock b/yarn.lock
index ba48bcf13..374c6a739 100644
--- a/yarn.lock
+++ b/yarn.lock
@@ -12,6 +12,11 @@
   resolved "https://registry.yarnpkg.com/@adraffy/ens-normalize/-/ens-normalize-1.10.1.tgz#63430d04bd8c5e74f8d7d049338f1cd9d4f02069"
   integrity sha512-96Z2IP3mYmF1Xg2cDm8f1gWGf/HUVedQ3FMifV4kG/PQ4yEP51xDtRAEfhVNt5f/uzpNkZHwWQuUcu6D6K+Ekw==
 
+"@assemblyscript/loader@^0.9.4":
+  version "0.9.4"
+  resolved "https://registry.yarnpkg.com/@assemblyscript/loader/-/loader-0.9.4.tgz#a483c54c1253656bb33babd464e3154a173e1577"
+  integrity sha512-HazVq9zwTVwGmqdwYzu7WyQ6FQVZ7SwET0KKQuKm55jD0IfUpZgN0OPIiZG3zV1iSrVYcN0bdwLRXI/VNCYsUA==
+
 "@babel/code-frame@7.12.11":
   version "7.12.11"
   resolved "https://registry.yarnpkg.com/@babel/code-frame/-/code-frame-7.12.11.tgz#f4ad435aa263db935b8f10f2c552d23fb716a63f"
@@ -581,6 +586,11 @@
     tweetnacl "^1.0.3"
     tweetnacl-util "^0.15.1"
 
+"@multiformats/base-x@^4.0.1":
+  version "4.0.1"
+  resolved "https://registry.yarnpkg.com/@multiformats/base-x/-/base-x-4.0.1.tgz#95ff0fa58711789d53aefb2590a8b7a4e715d121"
+  integrity sha512-eMk0b9ReBbV23xXU693TAIrLyeO5iTgBZGSJfpqriG8UkYvr/hC9u9pyMlAakDNHWmbhMZCDs6KQO0jzKD8OTw==
+
 "@noble/curves@1.1.0", "@noble/curves@~1.1.0":
   version "1.1.0"
   resolved "https://registry.yarnpkg.com/@noble/curves/-/curves-1.1.0.tgz#f13fc667c89184bc04cccb9b11e8e7bae27d8c3d"
@@ -902,11 +912,64 @@
     ethers "^4.0.0-beta.1"
     source-map-support "^0.5.19"
 
-"@openzeppelin/contracts@^3.1.0":
+"@openzeppelin/contracts@3.4.2":
   version "3.4.2"
   resolved "https://registry.yarnpkg.com/@openzeppelin/contracts/-/contracts-3.4.2.tgz#d81f786fda2871d1eb8a8c5a73e455753ba53527"
   integrity sha512-z0zMCjyhhp4y7XKAcDAi3Vgms4T2PstwBdahiO0+9NaGICQKjynK3wduSRplTgk4LXmoO1yfDGO5RbjKYxtuxA==
 
+"@protobufjs/aspromise@^1.1.1", "@protobufjs/aspromise@^1.1.2":
+  version "1.1.2"
+  resolved "https://registry.yarnpkg.com/@protobufjs/aspromise/-/aspromise-1.1.2.tgz#9b8b0cc663d669a7d8f6f5d0893a14d348f30fbf"
+  integrity sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ==
+
+"@protobufjs/base64@^1.1.2":
+  version "1.1.2"
+  resolved "https://registry.yarnpkg.com/@protobufjs/base64/-/base64-1.1.2.tgz#4c85730e59b9a1f1f349047dbf24296034bb2735"
+  integrity sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg==
+
+"@protobufjs/codegen@^2.0.4":
+  version "2.0.4"
+  resolved "https://registry.yarnpkg.com/@protobufjs/codegen/-/codegen-2.0.4.tgz#7ef37f0d010fb028ad1ad59722e506d9262815cb"
+  integrity sha512-YyFaikqM5sH0ziFZCN3xDC7zeGaB/d0IUb9CATugHWbd1FRFwWwt4ld4OYMPWu5a3Xe01mGAULCdqhMlPl29Jg==
+
+"@protobufjs/eventemitter@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@protobufjs/eventemitter/-/eventemitter-1.1.0.tgz#355cbc98bafad5978f9ed095f397621f1d066b70"
+  integrity sha512-j9ednRT81vYJ9OfVuXG6ERSTdEL1xVsNgqpkxMsbIabzSo3goCjDIveeGv5d03om39ML71RdmrGNjG5SReBP/Q==
+
+"@protobufjs/fetch@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@protobufjs/fetch/-/fetch-1.1.0.tgz#ba99fb598614af65700c1619ff06d454b0d84c45"
+  integrity sha512-lljVXpqXebpsijW71PZaCYeIcE5on1w5DlQy5WH6GLbFryLUrBD4932W/E2BSpfRJWseIL4v/KPgBFxDOIdKpQ==
+  dependencies:
+    "@protobufjs/aspromise" "^1.1.1"
+    "@protobufjs/inquire" "^1.1.0"
+
+"@protobufjs/float@^1.0.2":
+  version "1.0.2"
+  resolved "https://registry.yarnpkg.com/@protobufjs/float/-/float-1.0.2.tgz#5e9e1abdcb73fc0a7cb8b291df78c8cbd97b87d1"
+  integrity sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ==
+
+"@protobufjs/inquire@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@protobufjs/inquire/-/inquire-1.1.0.tgz#ff200e3e7cf2429e2dcafc1140828e8cc638f089"
+  integrity sha512-kdSefcPdruJiFMVSbn801t4vFK7KB/5gd2fYvrxhuJYg8ILrmn9SKSX2tZdV6V+ksulWqS7aXjBcRXl3wHoD9Q==
+
+"@protobufjs/path@^1.1.2":
+  version "1.1.2"
+  resolved "https://registry.yarnpkg.com/@protobufjs/path/-/path-1.1.2.tgz#6cc2b20c5c9ad6ad0dccfd21ca7673d8d7fbf68d"
+  integrity sha512-6JOcJ5Tm08dOHAbdR3GrvP+yUUfkjG5ePsHYczMFLq3ZmMkAD98cDgcT2iA1lJ9NVwFd4tH/iSSoe44YWkltEA==
+
+"@protobufjs/pool@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@protobufjs/pool/-/pool-1.1.0.tgz#09fd15f2d6d3abfa9b65bc366506d6ad7846ff54"
+  integrity sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw==
+
+"@protobufjs/utf8@^1.1.0":
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/@protobufjs/utf8/-/utf8-1.1.0.tgz#a777360b5b39a1a2e5106f8e858f2fd2d060c570"
+  integrity sha512-Vvn3zZrhQZkkBE8LSuW3em98c0FwgO4nxzv6OdSxPKJIEKY2bGbHn+mhGIPerzI4twdxaP8/0+06HBpwf345Lw==
+
 "@scure/base@~1.1.0":
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/@scure/base/-/base-1.1.1.tgz#ebb651ee52ff84f420097055f4bf46cfba403938"
@@ -1019,6 +1082,34 @@
   resolved "https://registry.yarnpkg.com/@sindresorhus/is/-/is-4.6.0.tgz#3c7c9c46e678feefe7a2e5bb609d3dbd665ffb3f"
   integrity sha512-t09vSN3MdfsyCHoFcTRCH/iUtG7OJ0CsjzB8cjAmKc/va/kIgeDI/TxsigdncE/4be734m0cvIYwNaV4i2XqAw==
 
+"@sinonjs/commons@^3.0.1":
+  version "3.0.1"
+  resolved "https://registry.yarnpkg.com/@sinonjs/commons/-/commons-3.0.1.tgz#1029357e44ca901a615585f6d27738dbc89084cd"
+  integrity sha512-K3mCHKQ9sVh8o1C9cxkwxaOmXoAMlDxC1mYyHrjqOWEcBjYr76t96zL2zlj5dUGZ3HSw240X1qgH3Mjf1yJWpQ==
+  dependencies:
+    type-detect "4.0.8"
+
+"@sinonjs/fake-timers@^13.0.1", "@sinonjs/fake-timers@^13.0.2":
+  version "13.0.2"
+  resolved "https://registry.yarnpkg.com/@sinonjs/fake-timers/-/fake-timers-13.0.2.tgz#3ffe88abb062067a580fdfba706ad00435a0f2a6"
+  integrity sha512-4Bb+oqXZTSTZ1q27Izly9lv8B9dlV61CROxPiVtywwzv5SnytJqhvYe6FclHYuXml4cd1VHPo1zd5PmTeJozvA==
+  dependencies:
+    "@sinonjs/commons" "^3.0.1"
+
+"@sinonjs/samsam@^8.0.1":
+  version "8.0.2"
+  resolved "https://registry.yarnpkg.com/@sinonjs/samsam/-/samsam-8.0.2.tgz#e4386bf668ff36c95949e55a38dc5f5892fc2689"
+  integrity sha512-v46t/fwnhejRSFTGqbpn9u+LQ9xJDse10gNnPgAcxgdoCDMXj/G2asWAC/8Qs+BAZDicX+MNZouXT1A7c83kVw==
+  dependencies:
+    "@sinonjs/commons" "^3.0.1"
+    lodash.get "^4.4.2"
+    type-detect "^4.1.0"
+
+"@sinonjs/text-encoding@^0.7.3":
+  version "0.7.3"
+  resolved "https://registry.yarnpkg.com/@sinonjs/text-encoding/-/text-encoding-0.7.3.tgz#282046f03e886e352b2d5f5da5eb755e01457f3f"
+  integrity sha512-DE427ROAphMQzU4ENbliGYrBSYPXF+TtLg9S8vzeA+OF4ZKzoDdzfL8sxuMUGS/lgRhM6j1URSk9ghf7Xo1tyA==
+
 "@solidity-parser/parser@^0.14.0":
   version "0.14.5"
   resolved "https://registry.yarnpkg.com/@solidity-parser/parser/-/parser-0.14.5.tgz#87bc3cc7b068e08195c219c91cd8ddff5ef1a804"
@@ -1168,7 +1259,7 @@
   resolved "https://registry.yarnpkg.com/@tsconfig/node16/-/node16-1.0.4.tgz#0b92dcc0cc1c81f6f306a381f28e31b1a56536e9"
   integrity sha512-vxhUy4J8lyeyinH7Azl1pdd43GJhZH/tP2weN8TntQblOY+A0XbT8DJk1/oCPuOOyg/Ja757rG0CgHcWC8OfMA==
 
-"@typechain/ethers-v6@^0.4.0":
+"@typechain/ethers-v6@0.4.3":
   version "0.4.3"
   resolved "https://registry.yarnpkg.com/@typechain/ethers-v6/-/ethers-v6-0.4.3.tgz#badd99f88d5a1f1a2f42590f298e20cc62618e59"
   integrity sha512-TrxBsyb4ryhaY9keP6RzhFCviWYApcLCIRMPyWaKp2cZZrfaM3QBoxXTnw/eO4+DAY3l+8O0brNW0WgeQeOiDA==
@@ -1176,14 +1267,14 @@
     lodash "^4.17.15"
     ts-essentials "^7.0.1"
 
-"@typechain/hardhat@^9.0.0":
+"@typechain/hardhat@9.0.0":
   version "9.0.0"
   resolved "https://registry.yarnpkg.com/@typechain/hardhat/-/hardhat-9.0.0.tgz#c92d562566db9b933ac6899c0a0a2ae1871ad5c1"
   integrity sha512-oCGRvcsryRHEDZ4KO2lenB7wdf8WMDS+f9KGcRFiQWcRLpWWD0ruBGRxNjzkTqyPLtgQ9MvZsXquAFPEw7gAEA==
   dependencies:
     fs-extra "^9.1.0"
 
-"@typechain/truffle-v5@^8.0.6":
+"@typechain/truffle-v5@8.0.6":
   version "8.0.6"
   resolved "https://registry.yarnpkg.com/@typechain/truffle-v5/-/truffle-v5-8.0.6.tgz#59019bbf990efca699c0fe6fb81ec9ab68e32757"
   integrity sha512-0G8rAQVpJcW2rCJUMBfq/D4FxWk3sBwxzywUYQc0vngV514Yv1JtU8L3W0lNjXoDRjABdNzksrZ0He6IcxFDpw==
@@ -1245,7 +1336,7 @@
   resolved "https://registry.yarnpkg.com/@types/eslint-visitor-keys/-/eslint-visitor-keys-1.0.0.tgz#1ee30d79544ca84d68d4b3cdb0af4f205663dd2d"
   integrity sha512-OCutwjDZ4aFS6PB1UZ988C4YgwlBHJd6wCeQqaLdmadZ/7e+w79+hbMUFC1QXDNCmdyoRfAFdm0RypzwR+Qpag==
 
-"@types/ethereumjs-abi@^0.6.3":
+"@types/ethereumjs-abi@0.6.3":
   version "0.6.3"
   resolved "https://registry.yarnpkg.com/@types/ethereumjs-abi/-/ethereumjs-abi-0.6.3.tgz#eb5ed09fd86b9e2b1c0eb75d1e9bc29c50715c86"
   integrity sha512-DnHvqPkrJS5w4yZexTa5bdPNb8IyKPYciou0+zZCIg5fpzvGtyptTvshy0uZKzti2/k/markwjlxWRBWt7Mjuw==
@@ -1289,11 +1380,16 @@
   dependencies:
     "@types/node" "*"
 
-"@types/lodash@^4.14.158":
+"@types/lodash@4.14.195":
   version "4.14.195"
   resolved "https://registry.yarnpkg.com/@types/lodash/-/lodash-4.14.195.tgz#bafc975b252eb6cea78882ce8a7b6bf22a6de632"
   integrity sha512-Hwx9EUgdwf2GLarOjQp5ZH8ZmblzcbTBC2wtQWNKARBSxM9ezRIAUpeDTgoQRAFB0+8CNWXVA9+MaSOzOF3nPg==
 
+"@types/long@^4.0.1":
+  version "4.0.2"
+  resolved "https://registry.yarnpkg.com/@types/long/-/long-4.0.2.tgz#b74129719fc8d11c01868010082d483b7545591a"
+  integrity sha512-MqTGEo5bj5t157U6fA/BiDynNkn0YknVdh48CMPkTSpFTVmvao5UQmm7uEF6xBEo7qIMAlY/JSleYaE6VOdpaA==
+
 "@types/lru-cache@^5.1.0":
   version "5.1.1"
   resolved "https://registry.yarnpkg.com/@types/lru-cache/-/lru-cache-5.1.1.tgz#c48c2e27b65d2a153b19bfc1a317e30872e01eef"
@@ -1304,6 +1400,11 @@
   resolved "https://registry.yarnpkg.com/@types/minimatch/-/minimatch-5.1.2.tgz#07508b45797cb81ec3f273011b054cd0755eddca"
   integrity sha512-K0VQKziLUWkVKiRVrx4a40iPaxTUefQmjtkQofBkYRcoaaL/8rhwDWww9qWbrgicNOgnpIsMxyNIUM4+n6dUIA==
 
+"@types/minimist@^1.2.0":
+  version "1.2.5"
+  resolved "https://registry.yarnpkg.com/@types/minimist/-/minimist-1.2.5.tgz#ec10755e871497bcd83efe927e43ec46e8c0747e"
+  integrity sha512-hov8bUuiLiyFPGyFPE1lwWhmzYbirOXQNNo40+y3zow8aFVTeyn3VWL0VFFfdNddA8S4Vf0Tc062rzyNr7Paag==
+
 "@types/mocha@10.0.1":
   version "10.0.1"
   resolved "https://registry.yarnpkg.com/@types/mocha/-/mocha-10.0.1.tgz#2f4f65bb08bc368ac39c96da7b2f09140b26851b"
@@ -1324,6 +1425,13 @@
   resolved "https://registry.yarnpkg.com/@types/node/-/node-20.5.1.tgz#178d58ee7e4834152b0e8b4d30cbfab578b9bb30"
   integrity sha512-4tT2UrL5LBqDwoed9wZ6N3umC4Yhz3W3FloMmiiG4JwmUJWpie0c7lcnUNd4gtMKuDEO4wRVS8B6Xa0uMRsMKg==
 
+"@types/node@>=13.7.0":
+  version "22.1.0"
+  resolved "https://registry.yarnpkg.com/@types/node/-/node-22.1.0.tgz#6d6adc648b5e03f0e83c78dc788c2b037d0ad94b"
+  integrity sha512-AOmuRF0R2/5j1knA3c6G3HOk523Ga+l+ZXltX8SF1+5oqcXijjfTd8fY3XRZqSihEu9XhtQnKYLmkFaoxgsJHw==
+  dependencies:
+    undici-types "~6.13.0"
+
 "@types/node@^10.0.3":
   version "10.17.60"
   resolved "https://registry.yarnpkg.com/@types/node/-/node-10.17.60.tgz#35f3d6213daed95da7f0f73e75bcc6980e90597b"
@@ -1339,6 +1447,11 @@
   resolved "https://registry.yarnpkg.com/@types/node/-/node-8.10.66.tgz#dd035d409df322acc83dff62a602f12a5783bbb3"
   integrity sha512-tktOkFUA4kXx2hhhrB8bIFb5TbwzS4uOhKEmwiD+NoiL0qtP2OQ9mFldbgD4dV1djrlBYP6eBuQZiWjuHUpqFw==
 
+"@types/normalize-package-data@^2.4.0":
+  version "2.4.4"
+  resolved "https://registry.yarnpkg.com/@types/normalize-package-data/-/normalize-package-data-2.4.4.tgz#56e2cc26c397c038fab0e3a917a12d5c5909e901"
+  integrity sha512-37i+OaWTh9qeK4LSHPsyRC7NahnGotNuZvjLSgcPzblpHB3rrCJxAOgI5gCdKm7coonsaX1Of0ILiTcnZjbfxA==
+
 "@types/pbkdf2@^3.0.0":
   version "3.1.0"
   resolved "https://registry.yarnpkg.com/@types/pbkdf2/-/pbkdf2-3.1.0.tgz#039a0e9b67da0cdc4ee5dab865caa6b267bb66b1"
@@ -1378,7 +1491,19 @@
   dependencies:
     "@types/node" "*"
 
-"@typescript-eslint/eslint-plugin@^3.7.0":
+"@types/sinon@17.0.3":
+  version "17.0.3"
+  resolved "https://registry.yarnpkg.com/@types/sinon/-/sinon-17.0.3.tgz#9aa7e62f0a323b9ead177ed23a36ea757141a5fa"
+  integrity sha512-j3uovdn8ewky9kRBG19bOwaZbexJu/XjtkHyjvUgt4xfPFz18dcORIMqnYh66Fx3Powhcr85NT5+er3+oViapw==
+  dependencies:
+    "@types/sinonjs__fake-timers" "*"
+
+"@types/sinonjs__fake-timers@*":
+  version "8.1.5"
+  resolved "https://registry.yarnpkg.com/@types/sinonjs__fake-timers/-/sinonjs__fake-timers-8.1.5.tgz#5fd3592ff10c1e9695d377020c033116cc2889f2"
+  integrity sha512-mQkU2jY8jJEF7YHjHvsQO8+3ughTL1mcnn96igfhONmR+fUPSKIkefQYpSe8bsly2Ep7oQbn/6VG5/9/0qcArQ==
+
+"@typescript-eslint/eslint-plugin@3.10.1":
   version "3.10.1"
   resolved "https://registry.yarnpkg.com/@typescript-eslint/eslint-plugin/-/eslint-plugin-3.10.1.tgz#7e061338a1383f59edc204c605899f93dc2e2c8f"
   integrity sha512-PQg0emRtzZFWq6PxBcdxRH3QIQiyFO3WCVpRL3fgj5oQS3CDs3AeAKfv4DxNhzn8ITdNJGJ4D3Qw8eAJf3lXeQ==
@@ -1401,7 +1526,7 @@
     eslint-scope "^5.0.0"
     eslint-utils "^2.0.0"
 
-"@typescript-eslint/parser@^3.7.0":
+"@typescript-eslint/parser@3.10.1":
   version "3.10.1"
   resolved "https://registry.yarnpkg.com/@typescript-eslint/parser/-/parser-3.10.1.tgz#1883858e83e8b442627e1ac6f408925211155467"
   integrity sha512-Ug1RcWcrJP02hmtaXVS3axPPTTPnZjupqhgj+NnZ6BCkwSImWk/283347+x9wN+lqOdK9Eo3vsyiyDHgsmiEJw==
@@ -1727,6 +1852,11 @@ arraybuffer.prototype.slice@^1.0.1:
     is-array-buffer "^3.0.2"
     is-shared-array-buffer "^1.0.2"
 
+arrify@^1.0.1:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/arrify/-/arrify-1.0.1.tgz#898508da2226f380df904728456849c1501a4b0d"
+  integrity sha512-3CYzex9M9FGQjCGMGyi6/31c8GJbgb0qGyrx5HWxPd0aCwh4cB2YjMb2Xf9UuoogrMrlO9cTqnB5rI5GHZTcUA==
+
 asap@~2.0.6:
   version "2.0.6"
   resolved "https://registry.yarnpkg.com/asap/-/asap-2.0.6.tgz#e50347611d7e690943208bbdafebcbc2fb866d46"
@@ -1814,6 +1944,11 @@ base-x@^3.0.2, base-x@^3.0.8:
   dependencies:
     safe-buffer "^5.0.1"
 
+base-x@^4.0.0:
+  version "4.0.0"
+  resolved "https://registry.yarnpkg.com/base-x/-/base-x-4.0.0.tgz#d0e3b7753450c73f8ad2389b5c018a4af7b2224a"
+  integrity sha512-FuwxlW4H5kh37X/oW59pwTzzTKRzfrrQwhmyspRM7swOEZcHtDZSCt45U6oKgtuFE+WYPblePMVIPR4RZrh/hw==
+
 base64-js@^1.3.1:
   version "1.5.1"
   resolved "https://registry.yarnpkg.com/base64-js/-/base64-js-1.5.1.tgz#1b1b440160a5bf7ad40b650f095963481903930a"
@@ -1861,6 +1996,15 @@ binary-extensions@^2.0.0:
   resolved "https://registry.yarnpkg.com/binary-extensions/-/binary-extensions-2.2.0.tgz#75f502eeaf9ffde42fc98829645be4ea76bd9e2d"
   integrity sha512-jDctJ/IVQbZoJykoeHbhXpOlNBqGNcwXJKJog42E5HDPUwQTSdjCHdihjj0DlnheQ7blbT6dHOafNAiS8ooQKA==
 
+bl@^5.0.0:
+  version "5.1.0"
+  resolved "https://registry.yarnpkg.com/bl/-/bl-5.1.0.tgz#183715f678c7188ecef9fe475d90209400624273"
+  integrity sha512-tv1ZJHLfTDnXE6tMHv73YgSJaWR2AFuPwMntBe7XL/GBFHnT0CLnsHMogfk5+GzCDC5ZWarSCYaIGATZt9dNsQ==
+  dependencies:
+    buffer "^6.0.3"
+    inherits "^2.0.4"
+    readable-stream "^3.4.0"
+
 blakejs@^1.1.0:
   version "1.2.1"
   resolved "https://registry.yarnpkg.com/blakejs/-/blakejs-1.2.1.tgz#5057e4206eadb4a97f7c0b6e197a505042fc3814"
@@ -1981,6 +2125,13 @@ browserify-aes@^1.2.0:
     inherits "^2.0.1"
     safe-buffer "^5.0.1"
 
+bs58@5.0.0:
+  version "5.0.0"
+  resolved "https://registry.yarnpkg.com/bs58/-/bs58-5.0.0.tgz#865575b4d13c09ea2a84622df6c8cbeb54ffc279"
+  integrity sha512-r+ihvQJvahgYT50JD05dyJNKlmmSlMoOGwn1lCcEzanPglg7TxYjioQUYehQ9mAR/+hOSd2jRc/Z2y5UxBymvQ==
+  dependencies:
+    base-x "^4.0.0"
+
 bs58@^4.0.0, bs58@^4.0.1:
   version "4.0.1"
   resolved "https://registry.yarnpkg.com/bs58/-/bs58-4.0.1.tgz#be161e76c354f6f788ae4071f63f34e8c4f0a42a"
@@ -2084,6 +2235,15 @@ camel-case@^3.0.0:
     no-case "^2.2.0"
     upper-case "^1.1.1"
 
+camelcase-keys@^6.2.2:
+  version "6.2.2"
+  resolved "https://registry.yarnpkg.com/camelcase-keys/-/camelcase-keys-6.2.2.tgz#5e755d6ba51aa223ec7d3d52f25778210f9dc3c0"
+  integrity sha512-YrwaA0vEKazPBkn0ipTiMpSajYDSe+KjQfrjhcBMxJt/znbvlHd8Pw/Vamaz5EB4Wfhs3SUR3Z9mwRu/P3s3Yg==
+  dependencies:
+    camelcase "^5.3.1"
+    map-obj "^4.0.0"
+    quick-lru "^4.0.1"
+
 camelcase@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-3.0.0.tgz#32fc4b9fcdaf845fcdf7e73bb97cac2261f0ab0a"
@@ -2094,7 +2254,7 @@ camelcase@^4.1.0:
   resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-4.1.0.tgz#d545635be1e33c542649c69173e5de6acfae34dd"
   integrity sha512-FxAv7HpHrXbh3aPo4o2qxHay2lkLY3x5Mw3KeE4KQE8ysVfziWeRZDwcjauvwBSGEC/nXUPzZy8zeh4HokqOnw==
 
-camelcase@^5.0.0:
+camelcase@^5.0.0, camelcase@^5.3.1:
   version "5.3.1"
   resolved "https://registry.yarnpkg.com/camelcase/-/camelcase-5.3.1.tgz#e3c9b31569e106811df242f715725a1f4c494320"
   integrity sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==
@@ -2119,6 +2279,13 @@ catering@^2.1.0, catering@^2.1.1:
   resolved "https://registry.yarnpkg.com/catering/-/catering-2.1.1.tgz#66acba06ed5ee28d5286133982a927de9a04b510"
   integrity sha512-K7Qy8O9p76sL3/3m7/zLKbRkyOlSZAgzEaLhyj2mXS8PsCud2Eo4hAb8aLtZqHh0QGqLcb9dlJSu6lHRVENm1w==
 
+cbor@9.0.2:
+  version "9.0.2"
+  resolved "https://registry.yarnpkg.com/cbor/-/cbor-9.0.2.tgz#536b4f2d544411e70ec2b19a2453f10f83cd9fdb"
+  integrity sha512-JPypkxsB10s9QOWwa6zwPzqE1Md3vqpPc+cai4sAecuCsRyAtAl/pMyhPlMbT/xtPnm2dznJZYRLui57qiRhaQ==
+  dependencies:
+    nofilter "^3.1.0"
+
 cbor@^5.2.0:
   version "5.2.0"
   resolved "https://registry.yarnpkg.com/cbor/-/cbor-5.2.0.tgz#4cca67783ccd6de7b50ab4ed62636712f287a67c"
@@ -2134,7 +2301,7 @@ chai-as-promised@^7.1.1:
   dependencies:
     check-error "^1.0.2"
 
-chai@^4.2.0:
+chai@4.3.7, chai@^4.2.0:
   version "4.3.7"
   resolved "https://registry.yarnpkg.com/chai/-/chai-4.3.7.tgz#ec63f6df01829088e8bf55fca839bcd464a8ec51"
   integrity sha512-HLnAzZ2iupm25PlN0xFreAlBA5zaBSv3og0DdeGA4Ar6h6rJ3A0rolRUKJhSF2V10GZKDgWF/VmAEsNWjCRB+A==
@@ -2274,6 +2441,16 @@ cids@^0.7.1:
     multicodec "^1.0.0"
     multihashes "~0.4.15"
 
+cids@^1.0.0, cids@^1.1.5, cids@^1.1.6:
+  version "1.1.9"
+  resolved "https://registry.yarnpkg.com/cids/-/cids-1.1.9.tgz#402c26db5c07059377bcd6fb82f2a24e7f2f4a4f"
+  integrity sha512-l11hWRfugIcbGuTZwAM5PwpjPPjyb6UZOGwlHSnOBV5o07XhQ4gNpBN67FbODvpjyHtd+0Xs6KNvUcGBiDRsdg==
+  dependencies:
+    multibase "^4.0.1"
+    multicodec "^3.0.1"
+    multihashes "^4.0.1"
+    uint8arrays "^3.0.0"
+
 cipher-base@^1.0.0, cipher-base@^1.0.1, cipher-base@^1.0.3:
   version "1.0.4"
   resolved "https://registry.yarnpkg.com/cipher-base/-/cipher-base-1.0.4.tgz#8760e4ecc272f4c363532f926d874aae2c1397de"
@@ -2657,7 +2834,15 @@ debug@^3.2.7:
   dependencies:
     ms "^2.1.1"
 
-decamelize@^1.1.1, decamelize@^1.2.0:
+decamelize-keys@^1.1.0:
+  version "1.1.1"
+  resolved "https://registry.yarnpkg.com/decamelize-keys/-/decamelize-keys-1.1.1.tgz#04a2d523b2f18d80d0158a43b895d56dff8d19d8"
+  integrity sha512-WiPxgEirIV0/eIOMcnFBA3/IJZAZqKnwAwWyvvdi4lsr1WCN22nhdf/3db3DoZcUjTV2SqfzIwNyp6y2xs3nmg==
+  dependencies:
+    decamelize "^1.1.0"
+    map-obj "^1.0.0"
+
+decamelize@^1.1.0, decamelize@^1.1.1, decamelize@^1.2.0:
   version "1.2.0"
   resolved "https://registry.yarnpkg.com/decamelize/-/decamelize-1.2.0.tgz#f6534d15148269b20352e7bee26f501f9a191290"
   integrity sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA==
@@ -2751,6 +2936,11 @@ diff@^4.0.1:
   resolved "https://registry.yarnpkg.com/diff/-/diff-4.0.2.tgz#60f3aecb89d5fae520c11aa19efc2bb982aade7d"
   integrity sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==
 
+diff@^7.0.0:
+  version "7.0.0"
+  resolved "https://registry.yarnpkg.com/diff/-/diff-7.0.0.tgz#3fb34d387cd76d803f6eebea67b921dab0182a9a"
+  integrity sha512-PJWHUb1RFevKCwaFA9RlG5tCd+FO5iRh9A8HEtkmBH2Li03iJriB6m6JIN4rGz3K3JLawI7/veA1xzRKP6ISBw==
+
 difflib@^0.2.4, difflib@~0.2.1:
   version "0.2.4"
   resolved "https://registry.yarnpkg.com/difflib/-/difflib-0.2.4.tgz#b5e30361a6db023176d562892db85940a718f47e"
@@ -2826,7 +3016,7 @@ dot-case@^2.1.0:
   dependencies:
     no-case "^2.2.0"
 
-dotenv-cli@^7.3.0:
+dotenv-cli@7.3.0:
   version "7.3.0"
   resolved "https://registry.yarnpkg.com/dotenv-cli/-/dotenv-cli-7.3.0.tgz#21e33e7944713001677658d68856063968edfbd2"
   integrity sha512-314CA4TyK34YEJ6ntBf80eUY+t1XaFLyem1k9P0sX1gn30qThZ5qZr/ZwE318gEnzyYP9yj9HJk6SqwE0upkfw==
@@ -2841,7 +3031,7 @@ dotenv-expand@^10.0.0:
   resolved "https://registry.yarnpkg.com/dotenv-expand/-/dotenv-expand-10.0.0.tgz#12605d00fb0af6d0a592e6558585784032e4ef37"
   integrity sha512-GopVGCpVS1UKH75VKHGuQFqS1Gusej0z4FyQkPdwjil2gNIv+LNsqBlboOzpJFZKVT95GkCyWJbBSdFEFUWI2A==
 
-dotenv@^16.3.0, dotenv@^16.4.1:
+dotenv@16.4.1, dotenv@^16.3.0:
   version "16.4.1"
   resolved "https://registry.yarnpkg.com/dotenv/-/dotenv-16.4.1.tgz#1d9931f1d3e5d2959350d1250efab299561f7f11"
   integrity sha512-CjA3y+Dr3FyFDOAMnxZEGtnW9KBR2M0JvvUtXNW+dYJL5ROWxP9DUHCwgFqpMk0OXCc0ljhaNTr2w/kutYIcHQ==
@@ -2931,6 +3121,11 @@ env-paths@^2.2.0:
   resolved "https://registry.yarnpkg.com/env-paths/-/env-paths-2.2.1.tgz#420399d416ce1fbe9bc0a07c62fa68d67fd0f8f2"
   integrity sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==
 
+err-code@^3.0.0, err-code@^3.0.1:
+  version "3.0.1"
+  resolved "https://registry.yarnpkg.com/err-code/-/err-code-3.0.1.tgz#a444c7b992705f2b120ee320b09972eef331c920"
+  integrity sha512-GiaH0KJUewYok+eeY05IIgjtAe4Yltygk9Wqp1V5yVWLdhf0hYZchRjNIT9bb0mSwRcIusT3cx7PJUf3zEIfUA==
+
 error-ex@^1.2.0, error-ex@^1.3.1:
   version "1.3.2"
   resolved "https://registry.yarnpkg.com/error-ex/-/error-ex-1.3.2.tgz#b4ac40648107fdcdcfae242f428bea8a14d4f1bf"
@@ -3081,14 +3276,14 @@ escodegen@1.8.x:
   optionalDependencies:
     source-map "~0.2.0"
 
-eslint-config-prettier@^6.11.0:
+eslint-config-prettier@6.15.0:
   version "6.15.0"
   resolved "https://registry.yarnpkg.com/eslint-config-prettier/-/eslint-config-prettier-6.15.0.tgz#7f93f6cb7d45a92f1537a70ecc06366e1ac6fed9"
   integrity sha512-a1+kOYLR8wMGustcgAjdydMsQ2A/2ipRPwRKUmfYaSxc9ZPcrku080Ctl6zrZzZNs/U82MjSv+qKREkoq3bJaw==
   dependencies:
     get-stdin "^6.0.0"
 
-eslint-config-standard@^14.1.1:
+eslint-config-standard@14.1.1:
   version "14.1.1"
   resolved "https://registry.yarnpkg.com/eslint-config-standard/-/eslint-config-standard-14.1.1.tgz#830a8e44e7aef7de67464979ad06b406026c56ea"
   integrity sha512-Z9B+VR+JIXRxz21udPTL9HpFMyoMUEeX1G251EQ6e05WD9aPVtVBn09XUmZ259wCMlCDmYDSZG62Hhm+ZTJcUg==
@@ -3117,7 +3312,7 @@ eslint-plugin-es@^3.0.0:
     eslint-utils "^2.0.0"
     regexpp "^3.0.0"
 
-eslint-plugin-import@^2.22.0:
+eslint-plugin-import@2.27.5:
   version "2.27.5"
   resolved "https://registry.yarnpkg.com/eslint-plugin-import/-/eslint-plugin-import-2.27.5.tgz#876a6d03f52608a3e5bb439c2550588e51dd6c65"
   integrity sha512-LmEt3GVofgiGuiE+ORpnvP+kAm3h6MLZJ4Q5HCyHADofsb4VzXFsRiWj3c0OFiV+3DWFh0qg3v9gcPlfc3zRow==
@@ -3138,7 +3333,7 @@ eslint-plugin-import@^2.22.0:
     semver "^6.3.0"
     tsconfig-paths "^3.14.1"
 
-eslint-plugin-node@^11.1.0:
+eslint-plugin-node@11.1.0:
   version "11.1.0"
   resolved "https://registry.yarnpkg.com/eslint-plugin-node/-/eslint-plugin-node-11.1.0.tgz#c95544416ee4ada26740a30474eefc5402dc671d"
   integrity sha512-oUwtPJ1W0SKD0Tr+wqu92c5xuCeQqB3hSCHasn/ZgjFdA9iDGNkNf2Zi9ztY7X+hNuMib23LNGRm6+uN+KLE3g==
@@ -3150,19 +3345,19 @@ eslint-plugin-node@^11.1.0:
     resolve "^1.10.1"
     semver "^6.1.0"
 
-eslint-plugin-prettier@^3.1.4:
+eslint-plugin-prettier@3.4.1:
   version "3.4.1"
   resolved "https://registry.yarnpkg.com/eslint-plugin-prettier/-/eslint-plugin-prettier-3.4.1.tgz#e9ddb200efb6f3d05ffe83b1665a716af4a387e5"
   integrity sha512-htg25EUYUeIhKHXjOinK4BgCcDwtLHjqaxCDsMy5nbnUMkKFvIhMVCp+5GFUXQ4Nr8lBsPqtGAqBenbpFqAA2g==
   dependencies:
     prettier-linter-helpers "^1.0.0"
 
-eslint-plugin-promise@^4.2.1:
+eslint-plugin-promise@4.3.1:
   version "4.3.1"
   resolved "https://registry.yarnpkg.com/eslint-plugin-promise/-/eslint-plugin-promise-4.3.1.tgz#61485df2a359e03149fdafc0a68b0e030ad2ac45"
   integrity sha512-bY2sGqyptzFBDLh/GMbAxfdJC+b0f23ME63FOE4+Jao0oZ3E1LEwFtWJX/1pGMJLiTtrSSern2CRM/g+dfc0eQ==
 
-eslint-plugin-standard@^4.0.1:
+eslint-plugin-standard@4.1.0:
   version "4.1.0"
   resolved "https://registry.yarnpkg.com/eslint-plugin-standard/-/eslint-plugin-standard-4.1.0.tgz#0c3bf3a67e853f8bbbc580fb4945fbf16f41b7c5"
   integrity sha512-ZL7+QRixjTR6/528YNGyDotyffm5OQst/sGxKDwGb9Uqs4In5Egi4+jbobhqJoyoCM6/7v/1A5fhQ7ScMtDjaQ==
@@ -3192,7 +3387,7 @@ eslint-visitor-keys@^2.0.0:
   resolved "https://registry.yarnpkg.com/eslint-visitor-keys/-/eslint-visitor-keys-2.1.0.tgz#f65328259305927392c938ed44eb0a5c9b2bd303"
   integrity sha512-0rSmRBzXgDzIsD6mGdJgevzgezI534Cer5L/vyMX0kHzT/jiB43jRhd9YUlMGYLQy2zprNmoT8qasCGtY+QaKw==
 
-eslint@^7.5.0:
+eslint@7.32.0:
   version "7.32.0"
   resolved "https://registry.yarnpkg.com/eslint/-/eslint-7.32.0.tgz#c6d328a14be3fb08c8d1d21e12c02fdb7a2a812d"
   integrity sha512-VHZ8gX+EDfz+97jGcgyGCyRia/dPOd6Xh9yPv8Bl1+SoaIwD+a/vlrOmGRUyOYu7MwUhc7CxqeaDZU13S4+EpA==
@@ -3413,7 +3608,7 @@ ethereum-ens@^0.8.0:
     underscore "^1.8.3"
     web3 "^1.0.0-beta.34"
 
-ethereumjs-abi@^0.6.8:
+ethereumjs-abi@0.6.8, ethereumjs-abi@^0.6.8:
   version "0.6.8"
   resolved "https://registry.yarnpkg.com/ethereumjs-abi/-/ethereumjs-abi-0.6.8.tgz#71bc152db099f70e62f108b7cdfca1b362c6fcae"
   integrity sha512-Tx0r/iXI6r+lRsdvkFDlut0N08jWMnKRZ6Gkq+Nmw75lZe4e6o3EkSnkaBP5NF6+m5PTGAr9JP43N3LyeoglsA==
@@ -3421,6 +3616,17 @@ ethereumjs-abi@^0.6.8:
     bn.js "^4.11.8"
     ethereumjs-util "^6.0.0"
 
+ethereumjs-util@7.1.5, ethereumjs-util@^7.1.0, ethereumjs-util@^7.1.1, ethereumjs-util@^7.1.2, ethereumjs-util@^7.1.4, ethereumjs-util@^7.1.5:
+  version "7.1.5"
+  resolved "https://registry.yarnpkg.com/ethereumjs-util/-/ethereumjs-util-7.1.5.tgz#9ecf04861e4fbbeed7465ece5f23317ad1129181"
+  integrity sha512-SDl5kKrQAudFBUe5OJM9Ac6WmMyYmXX/6sTmLZ3ffG2eY6ZIGBes3pEDxNN6V72WyOw4CPD5RomKdsa8DAAwLg==
+  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"
+
 ethereumjs-util@^6.0.0, ethereumjs-util@^6.2.1:
   version "6.2.1"
   resolved "https://registry.yarnpkg.com/ethereumjs-util/-/ethereumjs-util-6.2.1.tgz#fcb4e4dd5ceacb9d2305426ab1a5cd93e3163b69"
@@ -3434,16 +3640,18 @@ ethereumjs-util@^6.0.0, ethereumjs-util@^6.2.1:
     ethjs-util "0.1.6"
     rlp "^2.2.3"
 
-ethereumjs-util@^7.0.3, ethereumjs-util@^7.1.0, ethereumjs-util@^7.1.1, ethereumjs-util@^7.1.2, ethereumjs-util@^7.1.4, ethereumjs-util@^7.1.5:
-  version "7.1.5"
-  resolved "https://registry.yarnpkg.com/ethereumjs-util/-/ethereumjs-util-7.1.5.tgz#9ecf04861e4fbbeed7465ece5f23317ad1129181"
-  integrity sha512-SDl5kKrQAudFBUe5OJM9Ac6WmMyYmXX/6sTmLZ3ffG2eY6ZIGBes3pEDxNN6V72WyOw4CPD5RomKdsa8DAAwLg==
+ethers@6.11.1:
+  version "6.11.1"
+  resolved "https://registry.yarnpkg.com/ethers/-/ethers-6.11.1.tgz#96aae00b627c2e35f9b0a4d65c7ab658259ee6af"
+  integrity sha512-mxTAE6wqJQAbp5QAe/+o+rXOID7Nw91OZXvgpjDa1r4fAbq2Nu314oEZSbjoRLacuCzs7kUC3clEvkCQowffGg==
   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"
+    "@adraffy/ens-normalize" "1.10.1"
+    "@noble/curves" "1.2.0"
+    "@noble/hashes" "1.3.2"
+    "@types/node" "18.15.13"
+    aes-js "4.0.0-beta.5"
+    tslib "2.4.0"
+    ws "8.5.0"
 
 ethers@^4.0.0-beta.1, ethers@^4.0.32, ethers@^4.0.40:
   version "4.0.49"
@@ -3496,19 +3704,6 @@ ethers@^5.0.13, ethers@^5.7.1:
     "@ethersproject/web" "5.7.1"
     "@ethersproject/wordlists" "5.7.0"
 
-ethers@^6.11.0:
-  version "6.11.1"
-  resolved "https://registry.yarnpkg.com/ethers/-/ethers-6.11.1.tgz#96aae00b627c2e35f9b0a4d65c7ab658259ee6af"
-  integrity sha512-mxTAE6wqJQAbp5QAe/+o+rXOID7Nw91OZXvgpjDa1r4fAbq2Nu314oEZSbjoRLacuCzs7kUC3clEvkCQowffGg==
-  dependencies:
-    "@adraffy/ens-normalize" "1.10.1"
-    "@noble/curves" "1.2.0"
-    "@noble/hashes" "1.3.2"
-    "@types/node" "18.15.13"
-    aes-js "4.0.0-beta.5"
-    tslib "2.4.0"
-    ws "8.5.0"
-
 ethjs-unit@0.1.6:
   version "0.1.6"
   resolved "https://registry.yarnpkg.com/ethjs-unit/-/ethjs-unit-0.1.6.tgz#c665921e476e87bce2a9d588a6fe0405b2c41699"
@@ -3714,6 +3909,14 @@ find-up@^2.1.0:
   dependencies:
     locate-path "^2.0.0"
 
+find-up@^4.1.0:
+  version "4.1.0"
+  resolved "https://registry.yarnpkg.com/find-up/-/find-up-4.1.0.tgz#97afe7d6cdc0bc5928584b7c8d7b16e8a9aa5d19"
+  integrity sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==
+  dependencies:
+    locate-path "^5.0.0"
+    path-exists "^4.0.0"
+
 flat-cache@^3.0.4:
   version "3.0.4"
   resolved "https://registry.yarnpkg.com/flat-cache/-/flat-cache-3.0.4.tgz#61b0338302b2fe9f957dcc32fc2a87f1c3048b11"
@@ -3722,14 +3925,7 @@ flat-cache@^3.0.4:
     flatted "^3.1.0"
     rimraf "^3.0.2"
 
-flat@^4.1.0:
-  version "4.1.1"
-  resolved "https://registry.yarnpkg.com/flat/-/flat-4.1.1.tgz#a392059cc382881ff98642f5da4dde0a959f309b"
-  integrity sha512-FmTtBsHskrU6FJ2VxCnsDb84wu9zhmO3cUX2kGFb5tuwhfXxGciiT0oRY+cck35QmG+NmGh5eLz6lLCpWTqwpA==
-  dependencies:
-    is-buffer "~2.0.3"
-
-flat@^5.0.2:
+flat@5.0.2, flat@^4.1.0, flat@^5.0.2:
   version "5.0.2"
   resolved "https://registry.yarnpkg.com/flat/-/flat-5.0.2.tgz#8ca6fe332069ffa9d324c327198c598259ceb241"
   integrity sha512-b6suED+5/3rTpUBdG1gupIl8MPFCAMA0QXwmljLhvCUKcUvdE4gWky9zpuGCcXHOsz4J9wPGNWq6OKpmIzz3hQ==
@@ -3879,6 +4075,11 @@ function-bind@^1.1.1:
   resolved "https://registry.yarnpkg.com/function-bind/-/function-bind-1.1.1.tgz#a56899d3ea3c9bab874bb9773b7c5ede92f4895d"
   integrity sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A==
 
+function-bind@^1.1.2:
+  version "1.1.2"
+  resolved "https://registry.yarnpkg.com/function-bind/-/function-bind-1.1.2.tgz#2c02d864d97f3ea6c8830c464cbd11ab6eab7a1c"
+  integrity sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==
+
 function.prototype.name@^1.1.5:
   version "1.1.5"
   resolved "https://registry.yarnpkg.com/function.prototype.name/-/function.prototype.name-1.1.5.tgz#cce0505fe1ffb80503e6f9e46cc64e46a12a9621"
@@ -4151,6 +4352,14 @@ growl@1.10.5:
   resolved "https://registry.yarnpkg.com/growl/-/growl-1.10.5.tgz#f2735dc2283674fa67478b10181059355c369e5e"
   integrity sha512-qBr4OuELkhPenW6goKVXiv47US3clb3/IbuWF9KNKEijAy9oeHxU9IgzjvJhHkUzhaj7rOUD7+YGWqUjLp5oSA==
 
+hamt-sharding@^2.0.0:
+  version "2.0.1"
+  resolved "https://registry.yarnpkg.com/hamt-sharding/-/hamt-sharding-2.0.1.tgz#f45686d0339e74b03b233bee1bde9587727129b6"
+  integrity sha512-vnjrmdXG9dDs1m/H4iJ6z0JFI2NtgsW5keRkTcM85NGak69Mkf5PHUqBz+Xs0T4sg0ppvj9O5EGAJo40FTxmmA==
+  dependencies:
+    sparse-array "^1.3.1"
+    uint8arrays "^3.0.0"
+
 handlebars@^4.0.1:
   version "4.7.7"
   resolved "https://registry.yarnpkg.com/handlebars/-/handlebars-4.7.7.tgz#9ce33416aad02dbd6c8fafa8240d5d98004945a1"
@@ -4176,7 +4385,12 @@ har-validator@~5.1.3:
     ajv "^6.12.3"
     har-schema "^2.0.0"
 
-hardhat-contract-sizer@^2.10.0:
+hard-rejection@^2.1.0:
+  version "2.1.0"
+  resolved "https://registry.yarnpkg.com/hard-rejection/-/hard-rejection-2.1.0.tgz#1c6eda5c1685c63942766d79bb40ae773cecd883"
+  integrity sha512-VIZB+ibDhx7ObhAe7OVtoEbuP4h/MuOTHJ+J8h/eBXotJYl0fBgR72xDFCKgIh22OJZIOVNxBMWuhAr10r8HdA==
+
+hardhat-contract-sizer@2.10.0:
   version "2.10.0"
   resolved "https://registry.yarnpkg.com/hardhat-contract-sizer/-/hardhat-contract-sizer-2.10.0.tgz#72646f43bfe50e9a5702c9720c9bc3e77d93a2c9"
   integrity sha512-QiinUgBD5MqJZJh1hl1jc9dNnpJg7eE/w4/4GEnrcmZJJTDbVFNe3+/3Ep24XqISSkYxRz36czcPHKHd/a0dwA==
@@ -4185,7 +4399,7 @@ hardhat-contract-sizer@^2.10.0:
     cli-table3 "^0.6.0"
     strip-ansi "^6.0.0"
 
-hardhat-gas-reporter@^1.0.10:
+hardhat-gas-reporter@1.0.10:
   version "1.0.10"
   resolved "https://registry.yarnpkg.com/hardhat-gas-reporter/-/hardhat-gas-reporter-1.0.10.tgz#ebe5bda5334b5def312747580cd923c2b09aef1b"
   integrity sha512-02N4+So/fZrzJ88ci54GqwVA3Zrf0C9duuTyGt0CFRIh/CdNwbnTgkXkRfojOMLBQ+6t+lBIkgbsOtqMvNwikA==
@@ -4324,6 +4538,13 @@ hash.js@1.1.7, hash.js@^1.0.0, hash.js@^1.0.3, hash.js@^1.1.7:
     inherits "^2.0.3"
     minimalistic-assert "^1.0.1"
 
+hasown@^2.0.2:
+  version "2.0.2"
+  resolved "https://registry.yarnpkg.com/hasown/-/hasown-2.0.2.tgz#003eaf91be7adc372e84ec59dc37252cedb80003"
+  integrity sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==
+  dependencies:
+    function-bind "^1.1.2"
+
 he@1.2.0:
   version "1.2.0"
   resolved "https://registry.yarnpkg.com/he/-/he-1.2.0.tgz#84ae65fa7eafb165fddb61566ae14baf05664f0f"
@@ -4366,6 +4587,13 @@ hosted-git-info@^2.1.4:
   resolved "https://registry.yarnpkg.com/hosted-git-info/-/hosted-git-info-2.8.9.tgz#dffc0bf9a21c02209090f2aa69429e1414daf3f9"
   integrity sha512-mxIDAb9Lsm6DoOJ7xH+5+X4y1LU/4Hi50L9C5sIswK3JzULS4bwk1FvjdBgvYR4bzT4tuUQiC15FE2f5HbLvYw==
 
+hosted-git-info@^4.0.1:
+  version "4.1.0"
+  resolved "https://registry.yarnpkg.com/hosted-git-info/-/hosted-git-info-4.1.0.tgz#827b82867e9ff1c8d0c4d9d53880397d2c86d224"
+  integrity sha512-kyCuEOWjJqZuDbRHzL8V93NzQhwIB71oFWSyzVo+KPZI+pnQPPxucdkrOZvkLRnrf5URsQM+IJ09Dw29cRALIA==
+  dependencies:
+    lru-cache "^6.0.0"
+
 htmlparser2@^8.0.1:
   version "8.0.2"
   resolved "https://registry.yarnpkg.com/htmlparser2/-/htmlparser2-8.0.2.tgz#f002151705b383e62433b5cf466f5b716edaec21"
@@ -4447,7 +4675,7 @@ https-proxy-agent@^5.0.0:
     agent-base "6"
     debug "4"
 
-husky@^8.0.3:
+husky@8.0.3:
   version "8.0.3"
   resolved "https://registry.yarnpkg.com/husky/-/husky-8.0.3.tgz#4936d7212e46d1dea28fef29bb3a108872cd9184"
   integrity sha512-+dQSyqPh4x1hlO1swXBiNb2HzTDN1I2IGLQx1GrBuiqFJfoMrnZWwVmatvSiO+Iz8fBUnf+lekwNo4c2LlXItg==
@@ -4522,6 +4750,15 @@ ini@^1.3.5:
   resolved "https://registry.yarnpkg.com/ini/-/ini-1.3.8.tgz#a29da425b48806f34767a4efce397269af28432c"
   integrity sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==
 
+interface-ipld-format@^1.0.0:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/interface-ipld-format/-/interface-ipld-format-1.0.1.tgz#bee39c70c584a033e186ff057a2be89f215963e3"
+  integrity sha512-WV/ar+KQJVoQpqRDYdo7YPGYIUHJxCuOEhdvsRpzLqoOIVCqPKdMMYmsLL1nCRsF3yYNio+PAJbCKiv6drrEAg==
+  dependencies:
+    cids "^1.1.6"
+    multicodec "^3.0.1"
+    multihashes "^4.0.2"
+
 internal-slot@^1.0.5:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/internal-slot/-/internal-slot-1.0.5.tgz#f2a2ee21f668f8627a4667f309dc0f4fb6674986"
@@ -4553,6 +4790,55 @@ ipaddr.js@1.9.1:
   resolved "https://registry.yarnpkg.com/ipaddr.js/-/ipaddr.js-1.9.1.tgz#bff38543eeb8984825079ff3a2a8e6cbd46781b3"
   integrity sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==
 
+ipfs-only-hash@4.0.0:
+  version "4.0.0"
+  resolved "https://registry.yarnpkg.com/ipfs-only-hash/-/ipfs-only-hash-4.0.0.tgz#b3bd60a244d9eb7394961aa9d812a2e5ac7c04d6"
+  integrity sha512-TE1DZCvfw8i3gcsTq3P4TFx3cKFJ3sluu/J3XINkJhIN9OwJgNMqKA+WnKx6ByCb1IoPXsTp1KM7tupElb6SyA==
+  dependencies:
+    ipfs-unixfs-importer "^7.0.1"
+    meow "^9.0.0"
+
+ipfs-unixfs-importer@^7.0.1:
+  version "7.0.3"
+  resolved "https://registry.yarnpkg.com/ipfs-unixfs-importer/-/ipfs-unixfs-importer-7.0.3.tgz#b850e831ca9647d589ef50bc33421f65bab7bba6"
+  integrity sha512-qeFOlD3AQtGzr90sr5Tq1Bi8pT5Nr2tSI8z310m7R4JDYgZc6J1PEZO3XZQ8l1kuGoqlAppBZuOYmPEqaHcVQQ==
+  dependencies:
+    bl "^5.0.0"
+    cids "^1.1.5"
+    err-code "^3.0.1"
+    hamt-sharding "^2.0.0"
+    ipfs-unixfs "^4.0.3"
+    ipld-dag-pb "^0.22.2"
+    it-all "^1.0.5"
+    it-batch "^1.0.8"
+    it-first "^1.0.6"
+    it-parallel-batch "^1.0.9"
+    merge-options "^3.0.4"
+    multihashing-async "^2.1.0"
+    rabin-wasm "^0.1.4"
+    uint8arrays "^2.1.2"
+
+ipfs-unixfs@^4.0.3:
+  version "4.0.3"
+  resolved "https://registry.yarnpkg.com/ipfs-unixfs/-/ipfs-unixfs-4.0.3.tgz#7c43e5726052ade4317245358ac541ef3d63d94e"
+  integrity sha512-hzJ3X4vlKT8FQ3Xc4M1szaFVjsc1ZydN+E4VQ91aXxfpjFn9G2wsMo1EFdAXNq/BUnN5dgqIOMP5zRYr3DTsAw==
+  dependencies:
+    err-code "^3.0.1"
+    protobufjs "^6.10.2"
+
+ipld-dag-pb@^0.22.2:
+  version "0.22.3"
+  resolved "https://registry.yarnpkg.com/ipld-dag-pb/-/ipld-dag-pb-0.22.3.tgz#6d5af28b5752236a5cb0e0a1888c87dd733b55cd"
+  integrity sha512-dfG5C5OVAR4FEP7Al2CrHWvAyIM7UhAQrjnOYOIxXGQz5NlEj6wGX0XQf6Ru6or1na6upvV3NQfstapQG8X2rg==
+  dependencies:
+    cids "^1.0.0"
+    interface-ipld-format "^1.0.0"
+    multicodec "^3.0.1"
+    multihashing-async "^2.0.0"
+    protobufjs "^6.10.2"
+    stable "^0.1.8"
+    uint8arrays "^2.0.5"
+
 is-arguments@^1.0.4:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/is-arguments/-/is-arguments-1.1.1.tgz#15b3f88fda01f2a97fec84ca761a560f123efa9b"
@@ -4597,7 +4883,7 @@ is-boolean-object@^1.1.0:
     call-bind "^1.0.2"
     has-tostringtag "^1.0.0"
 
-is-buffer@^2.0.5, is-buffer@~2.0.3:
+is-buffer@^2.0.5:
   version "2.0.5"
   resolved "https://registry.yarnpkg.com/is-buffer/-/is-buffer-2.0.5.tgz#ebc252e400d22ff8d77fa09888821a24a658c191"
   integrity sha512-i2R6zNFDwgEHJyQUtJEk0XFi1i0dPFn/oqjK3/vPCcDeJvW5NQ83V8QbicfF1SupOaB0h8ntgBC2YiE7dfyctQ==
@@ -4626,6 +4912,13 @@ is-core-module@^2.13.0:
   dependencies:
     has "^1.0.3"
 
+is-core-module@^2.5.0:
+  version "2.15.0"
+  resolved "https://registry.yarnpkg.com/is-core-module/-/is-core-module-2.15.0.tgz#71c72ec5442ace7e76b306e9d48db361f22699ea"
+  integrity sha512-Dd+Lb2/zvk9SKy1TGCt1wFJFo/MWBPMX5x7KcvLajWTGuomczdQX61PvY5yK6SVACwpoexWo81IfFyoKY2QnTA==
+  dependencies:
+    hasown "^2.0.2"
+
 is-date-object@^1.0.1:
   version "1.0.5"
   resolved "https://registry.yarnpkg.com/is-date-object/-/is-date-object-1.0.5.tgz#0841d5536e724c25597bf6ea62e1bd38298df31f"
@@ -4703,6 +4996,11 @@ is-number@^7.0.0:
   resolved "https://registry.yarnpkg.com/is-number/-/is-number-7.0.0.tgz#7535345b896734d5f80c4d06c50955527a14f12b"
   integrity sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==
 
+is-plain-obj@^1.1.0:
+  version "1.1.0"
+  resolved "https://registry.yarnpkg.com/is-plain-obj/-/is-plain-obj-1.1.0.tgz#71a50c8429dfca773c92a390a4a03b39fcd51d3e"
+  integrity sha512-yvkRyxmFKEOQ4pNXCmJG5AEQNlXJS5LaONXo5/cLdTZdWvsZ1ioJEonLGAosKlMWE8lwUy/bJzMjcw8az73+Fg==
+
 is-plain-obj@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/is-plain-obj/-/is-plain-obj-2.1.0.tgz#45e42e37fccf1f40da8e5f76ee21515840c09287"
@@ -4797,6 +5095,28 @@ isstream@~0.1.2:
   resolved "https://registry.yarnpkg.com/isstream/-/isstream-0.1.2.tgz#47e63f7af55afa6f92e1500e690eb8b8529c099a"
   integrity sha512-Yljz7ffyPbrLpLngrMtZ7NduUgVvi6wG9RJ9IUcyCd59YQ911PBJphODUcbOVbqYfxe1wuYf/LJ8PauMRwsM/g==
 
+it-all@^1.0.5:
+  version "1.0.6"
+  resolved "https://registry.yarnpkg.com/it-all/-/it-all-1.0.6.tgz#852557355367606295c4c3b7eff0136f07749335"
+  integrity sha512-3cmCc6Heqe3uWi3CVM/k51fa/XbMFpQVzFoDsV0IZNHSQDyAXl3c4MjHkFX5kF3922OGj7Myv1nSEUgRtcuM1A==
+
+it-batch@^1.0.8, it-batch@^1.0.9:
+  version "1.0.9"
+  resolved "https://registry.yarnpkg.com/it-batch/-/it-batch-1.0.9.tgz#7e95aaacb3f9b1b8ca6c8b8367892171d6a5b37f"
+  integrity sha512-7Q7HXewMhNFltTsAMdSz6luNhyhkhEtGGbYek/8Xb/GiqYMtwUmopE1ocPSiJKKp3rM4Dt045sNFoUu+KZGNyA==
+
+it-first@^1.0.6:
+  version "1.0.7"
+  resolved "https://registry.yarnpkg.com/it-first/-/it-first-1.0.7.tgz#a4bef40da8be21667f7d23e44dae652f5ccd7ab1"
+  integrity sha512-nvJKZoBpZD/6Rtde6FXqwDqDZGF1sCADmr2Zoc0hZsIvnE449gRFnGctxDf09Bzc/FWnHXAdaHVIetY6lrE0/g==
+
+it-parallel-batch@^1.0.9:
+  version "1.0.11"
+  resolved "https://registry.yarnpkg.com/it-parallel-batch/-/it-parallel-batch-1.0.11.tgz#f889b4e1c7a62ef24111dbafbaaa010b33d00f69"
+  integrity sha512-UWsWHv/kqBpMRmyZJzlmZeoAMA0F3SZr08FBdbhtbe+MtoEBgr/ZUAKrnenhXCBrsopy76QjRH2K/V8kNdupbQ==
+  dependencies:
+    it-batch "^1.0.9"
+
 js-sdsl@^4.1.4:
   version "4.4.2"
   resolved "https://registry.yarnpkg.com/js-sdsl/-/js-sdsl-4.4.2.tgz#2e3c031b1f47d3aca8b775532e3ebb0818e7f847"
@@ -4934,6 +5254,11 @@ jsprim@^1.2.2:
     json-schema "0.4.0"
     verror "1.10.0"
 
+just-extend@^6.2.0:
+  version "6.2.0"
+  resolved "https://registry.yarnpkg.com/just-extend/-/just-extend-6.2.0.tgz#b816abfb3d67ee860482e7401564672558163947"
+  integrity sha512-cYofQu2Xpom82S6qD778jBDpwvvy39s1l/hrYij2u9AMdQcGRpaBu6kY4mVhuno5kJVi1DAz4aiphA2WI1/OAw==
+
 keccak@^3.0.0, keccak@^3.0.2:
   version "3.0.3"
   resolved "https://registry.yarnpkg.com/keccak/-/keccak-3.0.3.tgz#4bc35ad917be1ef54ff246f904c2bbbf9ac61276"
@@ -4950,7 +5275,7 @@ keyv@^4.0.0:
   dependencies:
     json-buffer "3.0.1"
 
-kind-of@^6.0.2:
+kind-of@^6.0.2, kind-of@^6.0.3:
   version "6.0.3"
   resolved "https://registry.yarnpkg.com/kind-of/-/kind-of-6.0.3.tgz#07c05034a6c349fa06e24fa35aa76db4580ce4dd"
   integrity sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==
@@ -5038,6 +5363,13 @@ locate-path@^3.0.0:
     p-locate "^3.0.0"
     path-exists "^3.0.0"
 
+locate-path@^5.0.0:
+  version "5.0.0"
+  resolved "https://registry.yarnpkg.com/locate-path/-/locate-path-5.0.0.tgz#1afba396afd676a6d42504d0a67a3a7eb9f62aa0"
+  integrity sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==
+  dependencies:
+    p-locate "^4.1.0"
+
 locate-path@^6.0.0:
   version "6.0.0"
   resolved "https://registry.yarnpkg.com/locate-path/-/locate-path-6.0.0.tgz#55321eb309febbc59c4801d931a72452a681d286"
@@ -5055,6 +5387,11 @@ lodash.camelcase@^4.3.0:
   resolved "https://registry.yarnpkg.com/lodash.camelcase/-/lodash.camelcase-4.3.0.tgz#b28aa6288a2b9fc651035c7711f65ab6190331a6"
   integrity sha512-TwuEnCnxbc3rAvhf/LbG7tJUDzhqXyFnv3dtzLOPgCG/hODL7WFnsbwktkD7yUV0RrreP/l1PALq/YSg6VvjlA==
 
+lodash.get@^4.4.2:
+  version "4.4.2"
+  resolved "https://registry.yarnpkg.com/lodash.get/-/lodash.get-4.4.2.tgz#2d177f652fa31e939b4438d5341499dfa3825e99"
+  integrity sha512-z+Uw/vLuy6gQe8cfaFWD7p0wVv8fJl3mbzXh33RS+0oW2wvUqiRXiQ69gLWSLpgB5/6sU+r6BlQR0MBILadqTQ==
+
 lodash.isequal@^4.5.0:
   version "4.5.0"
   resolved "https://registry.yarnpkg.com/lodash.isequal/-/lodash.isequal-4.5.0.tgz#415c4478f2bcc30120c22ce10ed3226f7d3e18e0"
@@ -5070,7 +5407,7 @@ lodash.truncate@^4.4.2:
   resolved "https://registry.yarnpkg.com/lodash.truncate/-/lodash.truncate-4.4.2.tgz#5a350da0b1113b837ecfffd5812cbe58d6eae193"
   integrity sha512-jttmRe7bRse52OsWIMDLaXxWqRAmtIUccAQ3garviCqJjafXOfNMO0yMfNpdD6zbGaTU0P5Nz7e7gAT6cKmJRw==
 
-lodash@^4.17.11, lodash@^4.17.14, lodash@^4.17.15, lodash@^4.17.19, lodash@^4.17.21:
+lodash@4.17.21, lodash@^4.17.11, lodash@^4.17.14, lodash@^4.17.15, lodash@^4.17.19, lodash@^4.17.21:
   version "4.17.21"
   resolved "https://registry.yarnpkg.com/lodash/-/lodash-4.17.21.tgz#679591c564c3bffaae8454cf0b3df370c3d6911c"
   integrity sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==
@@ -5090,6 +5427,11 @@ log-symbols@4.1.0:
     chalk "^4.1.0"
     is-unicode-supported "^0.1.0"
 
+long@^4.0.0:
+  version "4.0.0"
+  resolved "https://registry.yarnpkg.com/long/-/long-4.0.0.tgz#9a7b71cfb7d361a194ea555241c92f7468d5bf28"
+  integrity sha512-XsP+KhQif4bjX1kbuSiySJFNAehNxgLb6hPRGJ9QsUr8ajHkuXGdrHmFUTUUXhDwVX2R5bY4JNZEwbUiMhV+MA==
+
 loupe@^2.3.1:
   version "2.3.6"
   resolved "https://registry.yarnpkg.com/loupe/-/loupe-2.3.6.tgz#76e4af498103c532d1ecc9be102036a21f787b53"
@@ -5143,6 +5485,16 @@ make-error@^1.1.1:
   resolved "https://registry.yarnpkg.com/make-error/-/make-error-1.3.6.tgz#2eb2e37ea9b67c4891f684a1394799af484cf7a2"
   integrity sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==
 
+map-obj@^1.0.0:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/map-obj/-/map-obj-1.0.1.tgz#d933ceb9205d82bdcf4886f6742bdc2b4dea146d"
+  integrity sha512-7N/q3lyZ+LVCp7PzuxrJr4KMbBE2hW7BT7YNia330OFxIf4d3r5zVpicP2650l7CPN6RM9zOJRl3NGpqSiw3Eg==
+
+map-obj@^4.0.0:
+  version "4.3.0"
+  resolved "https://registry.yarnpkg.com/map-obj/-/map-obj-4.3.0.tgz#9304f906e93faae70880da102a9f1df0ea8bb05a"
+  integrity sha512-hdN1wVrZbb29eBGiGjJbeP8JbKjq1urkHJ/LIP/NY48MZ1QVXUsQBV1G1zvYFHn1XE06cwjBsOI2K3Ulnj1YXQ==
+
 markdown-table@^1.1.3:
   version "1.1.3"
   resolved "https://registry.yarnpkg.com/markdown-table/-/markdown-table-1.1.3.tgz#9fcb69bcfdb8717bfd0398c6ec2d93036ef8de60"
@@ -5190,11 +5542,36 @@ memorystream@^0.3.1:
   resolved "https://registry.yarnpkg.com/memorystream/-/memorystream-0.3.1.tgz#86d7090b30ce455d63fbae12dda51a47ddcaf9b2"
   integrity sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw==
 
+meow@^9.0.0:
+  version "9.0.0"
+  resolved "https://registry.yarnpkg.com/meow/-/meow-9.0.0.tgz#cd9510bc5cac9dee7d03c73ee1f9ad959f4ea364"
+  integrity sha512-+obSblOQmRhcyBt62furQqRAQpNyWXo8BuQ5bN7dG8wmwQ+vwHKp/rCFD4CrTP8CsDQD1sjoZ94K417XEUk8IQ==
+  dependencies:
+    "@types/minimist" "^1.2.0"
+    camelcase-keys "^6.2.2"
+    decamelize "^1.2.0"
+    decamelize-keys "^1.1.0"
+    hard-rejection "^2.1.0"
+    minimist-options "4.1.0"
+    normalize-package-data "^3.0.0"
+    read-pkg-up "^7.0.1"
+    redent "^3.0.0"
+    trim-newlines "^3.0.0"
+    type-fest "^0.18.0"
+    yargs-parser "^20.2.3"
+
 merge-descriptors@1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/merge-descriptors/-/merge-descriptors-1.0.1.tgz#b00aaa556dd8b44568150ec9d1b953f3f90cbb61"
   integrity sha512-cCi6g3/Zr1iqQi6ySbseM1Xvooa98N0w31jzUYrXPX2xqObmFGHJ0tQ5u74H3mVh7wLouTseZyYIq39g8cNp1w==
 
+merge-options@^3.0.4:
+  version "3.0.4"
+  resolved "https://registry.yarnpkg.com/merge-options/-/merge-options-3.0.4.tgz#84709c2aa2a4b24c1981f66c179fe5565cc6dbb7"
+  integrity sha512-2Sug1+knBjkaMsMgf1ctR1Ujx+Ayku4EdJN4Z+C2+JzoeF7A3OZ9KM2GY0CpQS51NR61LTurMJrRKPhSs3ZRTQ==
+  dependencies:
+    is-plain-obj "^2.1.0"
+
 merge2@^1.2.3, merge2@^1.3.0:
   version "1.4.1"
   resolved "https://registry.yarnpkg.com/merge2/-/merge2-1.4.1.tgz#4368892f885e907455a6fd7dc55c0c9d404990ae"
@@ -5252,6 +5629,11 @@ min-document@^2.19.0:
   dependencies:
     dom-walk "^0.1.0"
 
+min-indent@^1.0.0:
+  version "1.0.1"
+  resolved "https://registry.yarnpkg.com/min-indent/-/min-indent-1.0.1.tgz#a63f681673b30571fbe8bc25686ae746eefa9869"
+  integrity sha512-I9jwMn07Sy/IwOj3zVkVik2JTvgpaykDZEigL6Rx6N9LbMywwUSMtxET+7lVoDLLd3O3IXwJwvuuns8UB/HeAg==
+
 minimalistic-assert@^1.0.0, minimalistic-assert@^1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz#2e194de044626d4a10e7f7fbc00ce73e83e4d5c7"
@@ -5290,6 +5672,15 @@ minimatch@^5.0.1:
   dependencies:
     brace-expansion "^2.0.1"
 
+minimist-options@4.1.0:
+  version "4.1.0"
+  resolved "https://registry.yarnpkg.com/minimist-options/-/minimist-options-4.1.0.tgz#c0655713c53a8a2ebd77ffa247d342c40f010619"
+  integrity sha512-Q4r8ghd80yhO/0j1O3B2BjweX3fiHg9cdOwjJd2J76Q135c+NDxGCqdYKQ1SKBuFfgWbAUzBfvYjPUEeNgqN1A==
+  dependencies:
+    arrify "^1.0.1"
+    is-plain-obj "^1.1.0"
+    kind-of "^6.0.3"
+
 minimist@^1.2.0, minimist@^1.2.5, minimist@^1.2.6:
   version "1.2.8"
   resolved "https://registry.yarnpkg.com/minimist/-/minimist-1.2.8.tgz#c1a464e7693302e082a075cee0c057741ac4772c"
@@ -5348,7 +5739,7 @@ mnemonist@^0.38.0:
   dependencies:
     obliterator "^2.0.0"
 
-mocha-junit-reporter@^2.2.1:
+mocha-junit-reporter@2.2.1:
   version "2.2.1"
   resolved "https://registry.yarnpkg.com/mocha-junit-reporter/-/mocha-junit-reporter-2.2.1.tgz#739f5595d0f051d07af9d74e32c416e13a41cde5"
   integrity sha512-iDn2tlKHn8Vh8o4nCzcUVW4q7iXp7cC4EB78N0cDHIobLymyHNwe0XG8HEHHjc3hJlXm0Vy6zcrxaIhnI2fWmw==
@@ -5359,7 +5750,7 @@ mocha-junit-reporter@^2.2.1:
     strip-ansi "^6.0.1"
     xml "^1.0.1"
 
-mocha-multi-reporters@^1.5.1:
+mocha-multi-reporters@1.5.1:
   version "1.5.1"
   resolved "https://registry.yarnpkg.com/mocha-multi-reporters/-/mocha-multi-reporters-1.5.1.tgz#c73486bed5519e1d59c9ce39ac7a9792600e5676"
   integrity sha512-Yb4QJOaGLIcmB0VY7Wif5AjvLMUFAdV57D2TWEva1Y0kU/3LjKpeRVmlMIfuO1SVbauve459kgtIizADqxMWPg==
@@ -5488,6 +5879,13 @@ multibase@^0.7.0:
     base-x "^3.0.8"
     buffer "^5.5.0"
 
+multibase@^4.0.1:
+  version "4.0.6"
+  resolved "https://registry.yarnpkg.com/multibase/-/multibase-4.0.6.tgz#6e624341483d6123ca1ede956208cb821b440559"
+  integrity sha512-x23pDe5+svdLz/k5JPGCVdfn7Q5mZVMBETiC+ORfO+sor9Sgs0smJzAjfTbM5tckeCqnaUuMYoz+k3RXMmJClQ==
+  dependencies:
+    "@multiformats/base-x" "^4.0.1"
+
 multibase@~0.6.0:
   version "0.6.1"
   resolved "https://registry.yarnpkg.com/multibase/-/multibase-0.6.1.tgz#b76df6298536cc17b9f6a6db53ec88f85f8cc12b"
@@ -5511,6 +5909,19 @@ multicodec@^1.0.0:
     buffer "^5.6.0"
     varint "^5.0.0"
 
+multicodec@^3.0.1:
+  version "3.2.1"
+  resolved "https://registry.yarnpkg.com/multicodec/-/multicodec-3.2.1.tgz#82de3254a0fb163a107c1aab324f2a91ef51efb2"
+  integrity sha512-+expTPftro8VAW8kfvcuNNNBgb9gPeNYV9dn+z1kJRWF2vih+/S79f2RVeIwmrJBUJ6NT9IUPWnZDQvegEh5pw==
+  dependencies:
+    uint8arrays "^3.0.0"
+    varint "^6.0.0"
+
+multiformats@^9.4.2:
+  version "9.9.0"
+  resolved "https://registry.yarnpkg.com/multiformats/-/multiformats-9.9.0.tgz#c68354e7d21037a8f1f8833c8ccd68618e8f1d37"
+  integrity sha512-HoMUjhH9T8DDBNT+6xzkrd9ga/XiBI4xLr58LJACwK6G3HTOPeMz4nB4KJs33L2BelrIJa7P0VuNaVF3hMYfjg==
+
 multihashes@^0.4.15, multihashes@~0.4.15:
   version "0.4.21"
   resolved "https://registry.yarnpkg.com/multihashes/-/multihashes-0.4.21.tgz#dc02d525579f334a7909ade8a122dabb58ccfcb5"
@@ -5520,6 +5931,32 @@ multihashes@^0.4.15, multihashes@~0.4.15:
     multibase "^0.7.0"
     varint "^5.0.0"
 
+multihashes@^4.0.1, multihashes@^4.0.2:
+  version "4.0.3"
+  resolved "https://registry.yarnpkg.com/multihashes/-/multihashes-4.0.3.tgz#426610539cd2551edbf533adeac4c06b3b90fb05"
+  integrity sha512-0AhMH7Iu95XjDLxIeuCOOE4t9+vQZsACyKZ9Fxw2pcsRmlX4iCn1mby0hS0bb+nQOVpdQYWPpnyusw4da5RPhA==
+  dependencies:
+    multibase "^4.0.1"
+    uint8arrays "^3.0.0"
+    varint "^5.0.2"
+
+multihashing-async@^2.0.0, multihashing-async@^2.1.0:
+  version "2.1.4"
+  resolved "https://registry.yarnpkg.com/multihashing-async/-/multihashing-async-2.1.4.tgz#26dce2ec7a40f0e7f9e732fc23ca5f564d693843"
+  integrity sha512-sB1MiQXPSBTNRVSJc2zM157PXgDtud2nMFUEIvBrsq5Wv96sUclMRK/ecjoP1T/W61UJBqt4tCTwMkUpt2Gbzg==
+  dependencies:
+    blakejs "^1.1.0"
+    err-code "^3.0.0"
+    js-sha3 "^0.8.0"
+    multihashes "^4.0.1"
+    murmurhash3js-revisited "^3.0.0"
+    uint8arrays "^3.0.0"
+
+murmurhash3js-revisited@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.yarnpkg.com/murmurhash3js-revisited/-/murmurhash3js-revisited-3.0.0.tgz#6bd36e25de8f73394222adc6e41fa3fac08a5869"
+  integrity sha512-/sF3ee6zvScXMb1XFJ8gDsSnY+X8PbOyjIuBhtgis10W2Jx4ZjIhikUCIF9c4gpJxVnQIsPAFrSwTCuAjicP6g==
+
 nano-base32@^1.0.1:
   version "1.0.1"
   resolved "https://registry.yarnpkg.com/nano-base32/-/nano-base32-1.0.1.tgz#ba548c879efcfb90da1c4d9e097db4a46c9255ef"
@@ -5560,6 +5997,17 @@ next-tick@^1.1.0:
   resolved "https://registry.yarnpkg.com/next-tick/-/next-tick-1.1.0.tgz#1836ee30ad56d67ef281b22bd199f709449b35eb"
   integrity sha512-CXdUiJembsNjuToQvxayPZF9Vqht7hewsvy2sOWafLvi2awflj9mOC6bHIg50orX8IJvWKY9wYQ/zB2kogPslQ==
 
+nise@^6.1.1:
+  version "6.1.1"
+  resolved "https://registry.yarnpkg.com/nise/-/nise-6.1.1.tgz#78ea93cc49be122e44cb7c8fdf597b0e8778b64a"
+  integrity sha512-aMSAzLVY7LyeM60gvBS423nBmIPP+Wy7St7hsb+8/fc1HmeoHJfLO8CKse4u3BtOZvQLJghYPI2i/1WZrEj5/g==
+  dependencies:
+    "@sinonjs/commons" "^3.0.1"
+    "@sinonjs/fake-timers" "^13.0.1"
+    "@sinonjs/text-encoding" "^0.7.3"
+    just-extend "^6.2.0"
+    path-to-regexp "^8.1.0"
+
 no-case@^2.2.0, no-case@^2.3.2:
   version "2.3.2"
   resolved "https://registry.yarnpkg.com/no-case/-/no-case-2.3.2.tgz#60b813396be39b3f1288a4c1ed5d1e7d28b464ac"
@@ -5587,6 +6035,13 @@ node-environment-flags@1.0.6:
     object.getownpropertydescriptors "^2.0.3"
     semver "^5.7.0"
 
+node-fetch@^2.6.1:
+  version "2.7.0"
+  resolved "https://registry.yarnpkg.com/node-fetch/-/node-fetch-2.7.0.tgz#d0f0fa6e3e2dc1d27efcd8ad99d550bda94d187d"
+  integrity sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==
+  dependencies:
+    whatwg-url "^5.0.0"
+
 node-fetch@^2.6.12:
   version "2.6.12"
   resolved "https://registry.yarnpkg.com/node-fetch/-/node-fetch-2.6.12.tgz#02eb8e22074018e3d5a83016649d04df0e348fba"
@@ -5604,6 +6059,11 @@ nofilter@^1.0.4:
   resolved "https://registry.yarnpkg.com/nofilter/-/nofilter-1.0.4.tgz#78d6f4b6a613e7ced8b015cec534625f7667006e"
   integrity sha512-N8lidFp+fCz+TD51+haYdbDGrcBWwuHX40F5+z0qkUjMJ5Tp+rdSuAkMJ9N9eoolDlEVTf6u5icM+cNKkKW2mA==
 
+nofilter@^3.1.0:
+  version "3.1.0"
+  resolved "https://registry.yarnpkg.com/nofilter/-/nofilter-3.1.0.tgz#c757ba68801d41ff930ba2ec55bab52ca184aa66"
+  integrity sha512-l2NNj07e9afPnhAhvgVrCD/oy2Ai1yfLpuo3EpiO1jFTsB4sFz6oIfAfSZyQzVpkZQ9xS8ZS5g1jCBgq4Hwo0g==
+
 nopt@3.x:
   version "3.0.6"
   resolved "https://registry.yarnpkg.com/nopt/-/nopt-3.0.6.tgz#c6465dbf08abcd4db359317f79ac68a646b28ff9"
@@ -5611,7 +6071,7 @@ nopt@3.x:
   dependencies:
     abbrev "1"
 
-normalize-package-data@^2.3.2:
+normalize-package-data@^2.3.2, normalize-package-data@^2.5.0:
   version "2.5.0"
   resolved "https://registry.yarnpkg.com/normalize-package-data/-/normalize-package-data-2.5.0.tgz#e66db1838b200c1dfc233225d12cb36520e234a8"
   integrity sha512-/5CMN3T0R4XTj4DcGaexo+roZSdSFW/0AOOTROrjxzCG1wrWXEsGbRKevjlIL+ZDE4sZlJr5ED4YW0yqmkK+eA==
@@ -5621,6 +6081,16 @@ normalize-package-data@^2.3.2:
     semver "2 || 3 || 4 || 5"
     validate-npm-package-license "^3.0.1"
 
+normalize-package-data@^3.0.0:
+  version "3.0.3"
+  resolved "https://registry.yarnpkg.com/normalize-package-data/-/normalize-package-data-3.0.3.tgz#dbcc3e2da59509a0983422884cd172eefdfa525e"
+  integrity sha512-p2W1sgqij3zMMyRC067Dg16bfzVH+w7hyegmpIvZ4JNjqtGOVAIvLmjBx3yP7YTe9vKJgkoNOPjwQGogDoMXFA==
+  dependencies:
+    hosted-git-info "^4.0.1"
+    is-core-module "^2.5.0"
+    semver "^7.3.4"
+    validate-npm-package-license "^3.0.1"
+
 normalize-path@^3.0.0, normalize-path@~3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/normalize-path/-/normalize-path-3.0.0.tgz#0dcd69ff23a1c9b11fd0978316644a0388216a65"
@@ -5795,7 +6265,7 @@ p-limit@^1.1.0:
   dependencies:
     p-try "^1.0.0"
 
-p-limit@^2.0.0:
+p-limit@^2.0.0, p-limit@^2.2.0:
   version "2.3.0"
   resolved "https://registry.yarnpkg.com/p-limit/-/p-limit-2.3.0.tgz#3dd33c647a214fdfffd835933eb086da0dc21db1"
   integrity sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==
@@ -5823,6 +6293,13 @@ p-locate@^3.0.0:
   dependencies:
     p-limit "^2.0.0"
 
+p-locate@^4.1.0:
+  version "4.1.0"
+  resolved "https://registry.yarnpkg.com/p-locate/-/p-locate-4.1.0.tgz#a3428bb7088b3a60292f66919278b7c297ad4f07"
+  integrity sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==
+  dependencies:
+    p-limit "^2.2.0"
+
 p-locate@^5.0.0:
   version "5.0.0"
   resolved "https://registry.yarnpkg.com/p-locate/-/p-locate-5.0.0.tgz#83c8315c6785005e3bd021839411c9e110e6d834"
@@ -5970,6 +6447,11 @@ path-to-regexp@0.1.7:
   resolved "https://registry.yarnpkg.com/path-to-regexp/-/path-to-regexp-0.1.7.tgz#df604178005f522f15eb4490e7247a1bfaa67f8c"
   integrity sha512-5DFkuoqlv1uYQKxy8omFBeJPQcdoE07Kv2sferDCrAq1ohOU+MSDswDIbnx3YAM60qIOnYa53wBhXW0EbMonrQ==
 
+path-to-regexp@^8.1.0:
+  version "8.2.0"
+  resolved "https://registry.yarnpkg.com/path-to-regexp/-/path-to-regexp-8.2.0.tgz#73990cc29e57a3ff2a0d914095156df5db79e8b4"
+  integrity sha512-TdrF7fW9Rphjq4RjrW0Kp2AW0Ahwu9sRGTkS6bvDi0SCwZlEZYmcfDbEsTz8RVk0EHIS/Vd1bv3JhG+1xZuAyQ==
+
 path-type@^1.0.0:
   version "1.1.0"
   resolved "https://registry.yarnpkg.com/path-type/-/path-type-1.1.0.tgz#59c44f7ee491da704da415da5a4070ba4f8fe441"
@@ -6100,6 +6582,25 @@ promise@^8.0.0:
   dependencies:
     asap "~2.0.6"
 
+protobufjs@^6.10.2:
+  version "6.11.4"
+  resolved "https://registry.yarnpkg.com/protobufjs/-/protobufjs-6.11.4.tgz#29a412c38bf70d89e537b6d02d904a6f448173aa"
+  integrity sha512-5kQWPaJHi1WoCpjTGszzQ32PG2F4+wRY6BmAT4Vfw56Q2FZ4YZzK20xUYQH4YkfehY1e6QSICrJquM6xXZNcrw==
+  dependencies:
+    "@protobufjs/aspromise" "^1.1.2"
+    "@protobufjs/base64" "^1.1.2"
+    "@protobufjs/codegen" "^2.0.4"
+    "@protobufjs/eventemitter" "^1.1.0"
+    "@protobufjs/fetch" "^1.1.0"
+    "@protobufjs/float" "^1.0.2"
+    "@protobufjs/inquire" "^1.1.0"
+    "@protobufjs/path" "^1.1.2"
+    "@protobufjs/pool" "^1.1.0"
+    "@protobufjs/utf8" "^1.1.0"
+    "@types/long" "^4.0.1"
+    "@types/node" ">=13.7.0"
+    long "^4.0.0"
+
 proxy-addr@~2.0.7:
   version "2.0.7"
   resolved "https://registry.yarnpkg.com/proxy-addr/-/proxy-addr-2.0.7.tgz#f19fe69ceab311eeb94b42e70e8c2070f9ba1025"
@@ -6141,7 +6642,7 @@ pure-rand@^5.0.1:
   resolved "https://registry.yarnpkg.com/pure-rand/-/pure-rand-5.0.5.tgz#bda2a7f6a1fc0f284d78d78ca5902f26f2ad35cf"
   integrity sha512-BwQpbqxSCBJVpamI6ydzcKqyFmnd5msMWUGvzXLm1aXvusbbgkbOto/EUPM00hjveJEaJtdbhUjKSzWRhQVkaw==
 
-q@^1.5.1:
+q@1.5.1:
   version "1.5.1"
   resolved "https://registry.yarnpkg.com/q/-/q-1.5.1.tgz#7e32f75b41381291d04611f1bf14109ac00651d7"
   integrity sha512-kV/CThkXo6xyFEZUugw/+pIOywXcDbFYgSct5cT3gqlbkBE1SJdwy6UQoZvodiWF/ckQLZyDE/Bu1M6gVu5lVw==
@@ -6179,11 +6680,28 @@ queue-microtask@^1.2.2, queue-microtask@^1.2.3:
   resolved "https://registry.yarnpkg.com/queue-microtask/-/queue-microtask-1.2.3.tgz#4929228bbc724dfac43e0efb058caf7b6cfb6243"
   integrity sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==
 
+quick-lru@^4.0.1:
+  version "4.0.1"
+  resolved "https://registry.yarnpkg.com/quick-lru/-/quick-lru-4.0.1.tgz#5b8878f113a58217848c6482026c73e1ba57727f"
+  integrity sha512-ARhCpm70fzdcvNQfPoy49IaanKkTlRWF2JMzqhcJbhSFRZv7nPTvZJdcY7301IPmvW+/p0RgIWnQDLJxifsQ7g==
+
 quick-lru@^5.1.1:
   version "5.1.1"
   resolved "https://registry.yarnpkg.com/quick-lru/-/quick-lru-5.1.1.tgz#366493e6b3e42a3a6885e2e99d18f80fb7a8c932"
   integrity sha512-WuyALRjWPDGtt/wzJiadO5AXY+8hZ80hVpe6MyivgraREW751X3SbhRvG3eLKOYN+8VEvqLcf3wdnt44Z4S4SA==
 
+rabin-wasm@^0.1.4:
+  version "0.1.5"
+  resolved "https://registry.yarnpkg.com/rabin-wasm/-/rabin-wasm-0.1.5.tgz#5b625ca007d6a2cbc1456c78ae71d550addbc9c9"
+  integrity sha512-uWgQTo7pim1Rnj5TuWcCewRDTf0PEFTSlaUjWP4eY9EbLV9em08v89oCz/WO+wRxpYuO36XEHp4wgYQnAgOHzA==
+  dependencies:
+    "@assemblyscript/loader" "^0.9.4"
+    bl "^5.0.0"
+    debug "^4.3.1"
+    minimist "^1.2.5"
+    node-fetch "^2.6.1"
+    readable-stream "^3.6.0"
+
 randombytes@^2.1.0:
   version "2.1.0"
   resolved "https://registry.yarnpkg.com/randombytes/-/randombytes-2.1.0.tgz#df6f84372f0270dc65cdf6291349ab7a473d4f2a"
@@ -6224,6 +6742,15 @@ read-pkg-up@^1.0.1:
     find-up "^1.0.0"
     read-pkg "^1.0.0"
 
+read-pkg-up@^7.0.1:
+  version "7.0.1"
+  resolved "https://registry.yarnpkg.com/read-pkg-up/-/read-pkg-up-7.0.1.tgz#f3a6135758459733ae2b95638056e1854e7ef507"
+  integrity sha512-zK0TB7Xd6JpCLmlLmufqykGE+/TlOePD6qKClNW7hHDKFh/J7/7gCWGR7joEQEW1bKq3a3yUZSObOoWLFQ4ohg==
+  dependencies:
+    find-up "^4.1.0"
+    read-pkg "^5.2.0"
+    type-fest "^0.8.1"
+
 read-pkg@^1.0.0:
   version "1.1.0"
   resolved "https://registry.yarnpkg.com/read-pkg/-/read-pkg-1.1.0.tgz#f5ffaa5ecd29cb31c0474bca7d756b6bb29e3f28"
@@ -6233,6 +6760,16 @@ read-pkg@^1.0.0:
     normalize-package-data "^2.3.2"
     path-type "^1.0.0"
 
+read-pkg@^5.2.0:
+  version "5.2.0"
+  resolved "https://registry.yarnpkg.com/read-pkg/-/read-pkg-5.2.0.tgz#7bf295438ca5a33e56cd30e053b34ee7250c93cc"
+  integrity sha512-Ug69mNOpfvKDAc2Q8DRpMjjzdtrnv9HcSMX+4VsZxD1aZ6ZzrIE7rlzXBtWTyhULSMKg076AW6WR5iZpD0JiOg==
+  dependencies:
+    "@types/normalize-package-data" "^2.4.0"
+    normalize-package-data "^2.5.0"
+    parse-json "^5.0.0"
+    type-fest "^0.6.0"
+
 readable-stream@^2.2.2:
   version "2.3.8"
   resolved "https://registry.yarnpkg.com/readable-stream/-/readable-stream-2.3.8.tgz#91125e8042bba1b9887f49345f6277027ce8be9b"
@@ -6246,7 +6783,7 @@ readable-stream@^2.2.2:
     string_decoder "~1.1.1"
     util-deprecate "~1.0.1"
 
-readable-stream@^3.6.0:
+readable-stream@^3.4.0, readable-stream@^3.6.0:
   version "3.6.2"
   resolved "https://registry.yarnpkg.com/readable-stream/-/readable-stream-3.6.2.tgz#56a9b36ea965c00c5a93ef31eb111a0f11056967"
   integrity sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==
@@ -6283,6 +6820,14 @@ recursive-readdir@^2.2.2:
   dependencies:
     minimatch "^3.0.5"
 
+redent@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.yarnpkg.com/redent/-/redent-3.0.0.tgz#e557b7998316bb53c9f1f56fa626352c6963059f"
+  integrity sha512-6tDA8g98We0zd0GvVeMT9arEOnTw9qM03L9cJXaCjrip1OO764RDBLBfrB4cwzNGDj5OA5ioymC9GkizgWJDUg==
+  dependencies:
+    indent-string "^4.0.0"
+    strip-indent "^3.0.0"
+
 reduce-flatten@^2.0.0:
   version "2.0.0"
   resolved "https://registry.yarnpkg.com/reduce-flatten/-/reduce-flatten-2.0.0.tgz#734fd84e65f375d7ca4465c69798c25c9d10ae27"
@@ -6737,6 +7282,18 @@ simple-get@^2.7.0:
     once "^1.3.1"
     simple-concat "^1.0.0"
 
+sinon@19.0.2:
+  version "19.0.2"
+  resolved "https://registry.yarnpkg.com/sinon/-/sinon-19.0.2.tgz#944cf771d22236aa84fc1ab70ce5bffc3a215dad"
+  integrity sha512-euuToqM+PjO4UgXeLETsfQiuoyPXlqFezr6YZDFwHR3t4qaX0fZUe1MfPMznTL5f8BWrVS89KduLdMUsxFCO6g==
+  dependencies:
+    "@sinonjs/commons" "^3.0.1"
+    "@sinonjs/fake-timers" "^13.0.2"
+    "@sinonjs/samsam" "^8.0.1"
+    diff "^7.0.0"
+    nise "^6.1.1"
+    supports-color "^7.2.0"
+
 slash@^3.0.0:
   version "3.0.0"
   resolved "https://registry.yarnpkg.com/slash/-/slash-3.0.0.tgz#6539be870c165adbd5240220dbe361f1bc4d4634"
@@ -6798,7 +7355,7 @@ solc@^0.4.20:
     semver "^5.3.0"
     yargs "^4.7.1"
 
-solhint@^3.1.0:
+solhint@3.4.1:
   version "3.4.1"
   resolved "https://registry.yarnpkg.com/solhint/-/solhint-3.4.1.tgz#8ea15b21c13d1be0b53fd46d605a24d0b36a0c46"
   integrity sha512-pzZn2RlZhws1XwvLPVSsxfHrwsteFf5eySOhpAytzXwKQYbTCJV6z8EevYDiSVKMpWrvbKpEtJ055CuEmzp4Xg==
@@ -6823,7 +7380,7 @@ solhint@^3.1.0:
   optionalDependencies:
     prettier "^2.8.3"
 
-solidity-coverage@^0.8.9:
+solidity-coverage@0.8.9:
   version "0.8.9"
   resolved "https://registry.yarnpkg.com/solidity-coverage/-/solidity-coverage-0.8.9.tgz#d885207df927faf6b4f729904fab8ce0943cfd14"
   integrity sha512-ZhPsxlsLkYyzgwoVGh8RBN2ju7JVahvMkk+8RBVc0vP/3UNq88GzvL8kvbuY48lVIRL8eQjJ+0X8al2Bu9/2iQ==
@@ -6868,6 +7425,11 @@ source-map@~0.2.0:
   dependencies:
     amdefine ">=0.0.4"
 
+sparse-array@^1.3.1:
+  version "1.3.2"
+  resolved "https://registry.yarnpkg.com/sparse-array/-/sparse-array-1.3.2.tgz#0e1a8b71706d356bc916fe754ff496d450ec20b0"
+  integrity sha512-ZT711fePGn3+kQyLuv1fpd3rNSkNF8vd5Kv2D+qnOANeyKs3fx6bUMGWRPvgTTcYV64QMqZKZwcuaQSP3AZ0tg==
+
 spdx-correct@^3.0.0:
   version "3.2.0"
   resolved "https://registry.yarnpkg.com/spdx-correct/-/spdx-correct-3.2.0.tgz#4f5ab0668f0059e34f9c00dce331784a12de4e9c"
@@ -6914,6 +7476,11 @@ sshpk@^1.7.0:
     safer-buffer "^2.0.2"
     tweetnacl "~0.14.0"
 
+stable@^0.1.8:
+  version "0.1.8"
+  resolved "https://registry.yarnpkg.com/stable/-/stable-0.1.8.tgz#836eb3c8382fe2936feaf544631017ce7d47a3cf"
+  integrity sha512-ji9qxRnOVfcuLDySj9qzhGSEFVobyt1kIOSkj1qZzYLzq7Tos/oUUWvotUPQLlrsidqsK6tBH89Bc9kL5zHA6w==
+
 stacktrace-parser@^0.1.10:
   version "0.1.10"
   resolved "https://registry.yarnpkg.com/stacktrace-parser/-/stacktrace-parser-0.1.10.tgz#29fb0cae4e0d0b85155879402857a1639eb6051a"
@@ -7069,6 +7636,13 @@ strip-indent@^2.0.0:
   resolved "https://registry.yarnpkg.com/strip-indent/-/strip-indent-2.0.0.tgz#5ef8db295d01e6ed6cbf7aab96998d7822527b68"
   integrity sha512-RsSNPLpq6YUL7QYy44RnPVTn/lcVZtb48Uof3X5JLbF4zD/Gs7ZFDv2HWol+leoQN2mT86LAzSshGfkTlSOpsA==
 
+strip-indent@^3.0.0:
+  version "3.0.0"
+  resolved "https://registry.yarnpkg.com/strip-indent/-/strip-indent-3.0.0.tgz#c32e1cee940b6b3432c771bc2c54bcce73cd3001"
+  integrity sha512-laJTa3Jb+VQpaC6DseHhF7dXVqHTfJPCRDaEbid/drOhgitgYku/letMUqOXFoWV0zIIUbjpdH2t+tYj4bQMRQ==
+  dependencies:
+    min-indent "^1.0.0"
+
 strip-json-comments@2.0.1:
   version "2.0.1"
   resolved "https://registry.yarnpkg.com/strip-json-comments/-/strip-json-comments-2.0.1.tgz#3c531942e908c2697c0ec344858c286c7ca0a60a"
@@ -7107,7 +7681,7 @@ supports-color@^5.3.0:
   dependencies:
     has-flag "^3.0.0"
 
-supports-color@^7.1.0:
+supports-color@^7.1.0, supports-color@^7.2.0:
   version "7.2.0"
   resolved "https://registry.yarnpkg.com/supports-color/-/supports-color-7.2.0.tgz#1b7dcdcb32b8138801b3e478ba6a51caa89648da"
   integrity sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==
@@ -7266,6 +7840,11 @@ tr46@~0.0.3:
   resolved "https://registry.yarnpkg.com/tr46/-/tr46-0.0.3.tgz#8184fd347dac9cdc185992f3a6622e14b9d9ab6a"
   integrity sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==
 
+trim-newlines@^3.0.0:
+  version "3.0.1"
+  resolved "https://registry.yarnpkg.com/trim-newlines/-/trim-newlines-3.0.1.tgz#260a5d962d8b752425b32f3a7db0dcacd176c144"
+  integrity sha512-c1PTsA3tYrIsLGkJkzHF+w9F2EyxfXGo4UyJc4pFL++FMjnq0HJS69T3M7d//gKrFKwy429bouPescbjecU+Zw==
+
 ts-command-line-args@^2.2.0:
   version "2.5.1"
   resolved "https://registry.yarnpkg.com/ts-command-line-args/-/ts-command-line-args-2.5.1.tgz#e64456b580d1d4f6d948824c274cf6fa5f45f7f0"
@@ -7281,7 +7860,7 @@ ts-essentials@^7.0.1:
   resolved "https://registry.yarnpkg.com/ts-essentials/-/ts-essentials-7.0.3.tgz#686fd155a02133eedcc5362dc8b5056cde3e5a38"
   integrity sha512-8+gr5+lqO3G84KdiTSMRLtuyJ+nTBVRKuCrK4lidMPdVeEp0uqC875uE5NMcaA7YYMN7XsNiFQuMvasF8HT/xQ==
 
-ts-node@>=8.0.0:
+ts-node@10.9.1:
   version "10.9.1"
   resolved "https://registry.yarnpkg.com/ts-node/-/ts-node-10.9.1.tgz#e73de9102958af9e1f0b168a6ff320e25adcff4b"
   integrity sha512-NtVysVPkxxrwFGUUxGYhfux8k78pQB3JqYBXlLRZgdGUqTO5wU/UyHop5p70iEbGhB7q5KmiZiU0Y3KlJrScEw==
@@ -7368,11 +7947,21 @@ type-check@~0.3.2:
   dependencies:
     prelude-ls "~1.1.2"
 
-type-detect@^4.0.0, type-detect@^4.0.5:
+type-detect@4.0.8, type-detect@^4.0.0, type-detect@^4.0.5:
   version "4.0.8"
   resolved "https://registry.yarnpkg.com/type-detect/-/type-detect-4.0.8.tgz#7646fb5f18871cfbb7749e69bd39a6388eb7450c"
   integrity sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==
 
+type-detect@^4.1.0:
+  version "4.1.0"
+  resolved "https://registry.yarnpkg.com/type-detect/-/type-detect-4.1.0.tgz#deb2453e8f08dcae7ae98c626b13dddb0155906c"
+  integrity sha512-Acylog8/luQ8L7il+geoSxhEkazvkslg7PSNKOX59mbB9cOveP5aq9h74Y7YU8yDpJwetzQQrfIwtf4Wp4LKcw==
+
+type-fest@^0.18.0:
+  version "0.18.1"
+  resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.18.1.tgz#db4bc151a4a2cf4eebf9add5db75508db6cc841f"
+  integrity sha512-OIAYXk8+ISY+qTOwkHtKqzAuxchoMiD9Udx+FSGQDuiRR+PJKJHc2NJAXlbhkGwTt/4/nKZxELY1w3ReWOL8mw==
+
 type-fest@^0.20.2:
   version "0.20.2"
   resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.20.2.tgz#1bf207f4b28f91583666cb5fbd327887301cd5f4"
@@ -7383,11 +7972,21 @@ type-fest@^0.21.3:
   resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.21.3.tgz#d260a24b0198436e133fa26a524a6d65fa3b2e37"
   integrity sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==
 
+type-fest@^0.6.0:
+  version "0.6.0"
+  resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.6.0.tgz#8d2a2370d3df886eb5c90ada1c5bf6188acf838b"
+  integrity sha512-q+MB8nYR1KDLrgr4G5yemftpMC7/QLqVndBmEEdqzmNj5dcFOO4Oo8qlwZE3ULT3+Zim1F8Kq4cBnikNhlCMlg==
+
 type-fest@^0.7.1:
   version "0.7.1"
   resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.7.1.tgz#8dda65feaf03ed78f0a3f9678f1869147f7c5c48"
   integrity sha512-Ne2YiiGN8bmrmJJEuTWTLJR32nh/JdL1+PSicowtNb0WFpn59GK8/lfD61bVtzguz7b3PBt74nxpv/Pw5po5Rg==
 
+type-fest@^0.8.1:
+  version "0.8.1"
+  resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.8.1.tgz#09e249ebde851d3b1e48d27c105444667f17b83d"
+  integrity sha512-4dbzIzqvjtgiM5rw1k5rEHtBANKmdudhGyBEajN01fEyhaAIhsoKNy6y7+IN93IfpFtwY9iqi7kD+xwKhQsNJA==
+
 type-is@~1.6.18:
   version "1.6.18"
   resolved "https://registry.yarnpkg.com/type-is/-/type-is-1.6.18.tgz#4e552cd05df09467dcbc4ef739de89f2cf37c131"
@@ -7406,7 +8005,7 @@ type@^2.7.2:
   resolved "https://registry.yarnpkg.com/type/-/type-2.7.2.tgz#2376a15a3a28b1efa0f5350dcf72d24df6ef98d0"
   integrity sha512-dzlvlNlt6AXU7EBSfpAscydQ7gXB+pPGsPnfJnZpiNJBDj7IaJzQlBZYGdEi4R9HmPdBv2XmWJ6YUtoTa7lmCw==
 
-typechain@^8.1.0:
+typechain@8.3.1:
   version "8.3.1"
   resolved "https://registry.yarnpkg.com/typechain/-/typechain-8.3.1.tgz#dccbc839b94877997536c356380eff7325395cfb"
   integrity sha512-fA7clol2IP/56yq6vkMTR+4URF1nGjV82Wx6Rf09EsqD4tkzMAvEaqYxVFCavJm/1xaRga/oD55K+4FtuXwQOQ==
@@ -7473,7 +8072,7 @@ typedarray@^0.0.6:
   resolved "https://registry.yarnpkg.com/typedarray/-/typedarray-0.0.6.tgz#867ac74e3864187b1d3d47d996a78ec5c8830777"
   integrity sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==
 
-typescript@>=4.5.0:
+typescript@5.1.6:
   version "5.1.6"
   resolved "https://registry.yarnpkg.com/typescript/-/typescript-5.1.6.tgz#02f8ac202b6dad2c0dd5e0913745b47a37998274"
   integrity sha512-zaWCozRZ6DLEWAWFrVDz1H6FVXzUSfTy5FUMWsQlU8Ym5JP9eO4xkTIROFCQvhQf61z6O/G6ugw3SgAnvvm+HA==
@@ -7493,6 +8092,20 @@ uglify-js@^3.1.4:
   resolved "https://registry.yarnpkg.com/uglify-js/-/uglify-js-3.17.4.tgz#61678cf5fa3f5b7eb789bb345df29afb8257c22c"
   integrity sha512-T9q82TJI9e/C1TAxYvfb16xO120tMVFZrGA3f9/P4424DNu6ypK103y0GPFVa17yotwSyZW5iYXgjYHkGrJW/g==
 
+uint8arrays@^2.0.5, uint8arrays@^2.1.2:
+  version "2.1.10"
+  resolved "https://registry.yarnpkg.com/uint8arrays/-/uint8arrays-2.1.10.tgz#34d023c843a327c676e48576295ca373c56e286a"
+  integrity sha512-Q9/hhJa2836nQfEJSZTmr+pg9+cDJS9XEAp7N2Vg5MzL3bK/mkMVfjscRGYruP9jNda6MAdf4QD/y78gSzkp6A==
+  dependencies:
+    multiformats "^9.4.2"
+
+uint8arrays@^3.0.0:
+  version "3.1.1"
+  resolved "https://registry.yarnpkg.com/uint8arrays/-/uint8arrays-3.1.1.tgz#2d8762acce159ccd9936057572dade9459f65ae0"
+  integrity sha512-+QJa8QRnbdXVpHYjLoTpJIdCTiw9Ir62nocClWuXIq2JIh4Uta0cQsTSpFL678p2CN8B+XSApwcU+pQEqVpKWg==
+  dependencies:
+    multiformats "^9.4.2"
+
 ultron@~1.1.0:
   version "1.1.1"
   resolved "https://registry.yarnpkg.com/ultron/-/ultron-1.1.1.tgz#9fe1536a10a664a65266a1e3ccf85fd36302bc9c"
@@ -7513,6 +8126,11 @@ underscore@^1.8.3:
   resolved "https://registry.yarnpkg.com/underscore/-/underscore-1.13.6.tgz#04786a1f589dc6c09f761fc5f45b89e935136441"
   integrity sha512-+A5Sja4HP1M08MaXya7p5LvjuM7K6q/2EaC0+iovj/wOcMsTzMvDFbasi/oSapiwOlt252IqsKqPjCl7huKS0A==
 
+undici-types@~6.13.0:
+  version "6.13.0"
+  resolved "https://registry.yarnpkg.com/undici-types/-/undici-types-6.13.0.tgz#e3e79220ab8c81ed1496b5812471afd7cf075ea5"
+  integrity sha512-xtFJHudx8S2DSoujjMd1WeWvn7KKWFRESZTMeL1RptAYERu29D6jphMjjY+vn96jvN3kVPDNxU/E13VTaXj6jg==
+
 undici@^5.14.0:
   version "5.28.3"
   resolved "https://registry.yarnpkg.com/undici/-/undici-5.28.3.tgz#a731e0eff2c3fcfd41c1169a869062be222d1e5b"
@@ -7630,11 +8248,16 @@ validate-npm-package-license@^3.0.1:
     spdx-correct "^3.0.0"
     spdx-expression-parse "^3.0.0"
 
-varint@^5.0.0:
+varint@^5.0.0, varint@^5.0.2:
   version "5.0.2"
   resolved "https://registry.yarnpkg.com/varint/-/varint-5.0.2.tgz#5b47f8a947eb668b848e034dcfa87d0ff8a7f7a4"
   integrity sha512-lKxKYG6H03yCZUpAGOPOsMcGxd1RHCu1iKvEHYDPmTyq2HueGhD73ssNBqqQWfvYs04G9iUFRvmAVLW20Jw6ow==
 
+varint@^6.0.0:
+  version "6.0.0"
+  resolved "https://registry.yarnpkg.com/varint/-/varint-6.0.0.tgz#9881eb0ce8feaea6512439d19ddf84bf551661d0"
+  integrity sha512-cXEIW6cfr15lFv563k4GuVuW/fiwjknytD37jIOLSdSWuOI6WnO/oKwmP2FQTU2l01LP8/M5TSAJpzUaGe3uWg==
+
 vary@^1, vary@~1.1.2:
   version "1.1.2"
   resolved "https://registry.yarnpkg.com/vary/-/vary-1.1.2.tgz#2299f02c6ded30d4a5961b0b9f74524a18f634fc"
@@ -8095,7 +8718,7 @@ web3@1.10.0:
     web3-shh "1.10.0"
     web3-utils "1.10.0"
 
-web3@^1.0.0-beta.34, web3@^1.2.11:
+web3@1.10.1, web3@^1.0.0-beta.34:
   version "1.10.1"
   resolved "https://registry.yarnpkg.com/web3/-/web3-1.10.1.tgz#6435783cb2c0a8347f62b7b1a6ade431f19dce2a"
   integrity sha512-Ry+teufg6GYwIlLijyVTzZmnP+pu55vBU6P7rwK/rZidsMhc3m1lA5UXxiUVzBYZ8dvzV6+dVvOh68RrwrsI1w==
@@ -8366,7 +8989,7 @@ yargs-parser@^2.4.1:
     camelcase "^3.0.0"
     lodash.assign "^4.0.6"
 
-yargs-parser@^20.2.2:
+yargs-parser@^20.2.2, yargs-parser@^20.2.3:
   version "20.2.9"
   resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-20.2.9.tgz#2eb7dc3b0289718fc295f362753845c41a0c94ee"
   integrity sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==