From 45ec3cd319d20e772104aedbb42f3f103dea05d5 Mon Sep 17 00:00:00 2001
From: Alex Beregszaszi <alex@rtfs.hu>
Date: Fri, 2 Dec 2022 23:44:42 +0100
Subject: [PATCH 001/274] Mark EIP-4750 and EIP-5450 as Review (#6079)

* Mark EIP-4750 and EIP-5450 as Review

* Make linter happy
---
 EIPS/eip-4750.md | 2 +-
 EIPS/eip-5450.md | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/EIPS/eip-4750.md b/EIPS/eip-4750.md
index 98a830d6c8c2fc..bb14ae1f2da843 100644
--- a/EIPS/eip-4750.md
+++ b/EIPS/eip-4750.md
@@ -4,7 +4,7 @@ title: EOF - Functions
 description: Individual sections for functions with `CALLF` and `RETF` instructions
 author: Andrei Maiboroda (@gumb0), Alex Beregszaszi (@axic), Paweł Bylica (@chfast)
 discussions-to: https://ethereum-magicians.org/t/eip-4750-eof-functions/8195
-status: Draft
+status: Review
 type: Standards Track
 category: Core
 created: 2022-01-10
diff --git a/EIPS/eip-5450.md b/EIPS/eip-5450.md
index 7061c18e4f7809..4c9d6e62b6f873 100644
--- a/EIPS/eip-5450.md
+++ b/EIPS/eip-5450.md
@@ -4,7 +4,7 @@ title: EOF - Stack Validation
 description: Deploy-time validation of stack usage for EOF functions.
 author: Andrei Maiboroda (@gumb0), Paweł Bylica (@chfast), Alex Beregszaszi (@axic)
 discussions-to: https://ethereum-magicians.org/t/eip-5450-eof-stack-validation/10410
-status: Draft
+status: Review
 type: Standards Track
 category: Core
 created: 2022-08-12
@@ -59,7 +59,7 @@ Moreover, the `max_stack_height` computed during validation must be stored along
 
 ### Unreachable code
 
-The current validation algorithm ignores _unreachable_ instructions. The algorithm can be extended to reject any code having any unreachable instructions but additional instructions traversal is needed (or more efficient algorithm must be developed).
+The current validation algorithm ignores *unreachable* instructions. The algorithm can be extended to reject any code having any unreachable instructions but additional instructions traversal is needed (or more efficient algorithm must be developed).
 
 ### Clean stack upon termination
 
@@ -67,7 +67,7 @@ It is currently required that the EVM stack is empty (in the current function co
 
 This can be used for implementing more efficient early exits from a function (e.g. assertion failure).
 
-For "exit" instructions which terminates the whole program execution (`STOP`, `RETURN`, etc) this is no change comparing to pre-EOF EVM. I.e. some _garbage_ can be left on the stack. Cleaning the stack does not improve EVM implementation performance but makes the EVM programs potentially cost more (compiler is required to insert additional `POP` instructions).
+For "exit" instructions which terminates the whole program execution (`STOP`, `RETURN`, etc) this is no change comparing to pre-EOF EVM. I.e. some *garbage* can be left on the stack. Cleaning the stack does not improve EVM implementation performance but makes the EVM programs potentially cost more (compiler is required to insert additional `POP` instructions).
 
 For `RETF` semantic would be more complicated. For `n` function outputs and `s` the stack height at `RETF` the EVM must erase `s-n` non-top stack items and move the `n` stack items to the place of erased ones. Cost of such operation may be relatively cheap but is not constant.
 

From 9bb1f115a7cdf5db02f1786f86efcc7cc9ef3e36 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 3 Dec 2022 16:16:09 -0800
Subject: [PATCH 002/274] (bot 1272989785) moving EIPS/eip-4762.md to stagnant
 (#5963)

PR 5963 with changes to EIPS/eip-4762.md was created on
	(2022-Nov-15th@15.22.43)
which is before the cutoff date of
	(2022-Nov-20th@00.16.7)
i.e. 2 weeks ago
---
 EIPS/eip-4762.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4762.md b/EIPS/eip-4762.md
index 9d55c333e71f50..03bcdc5c4f2633 100644
--- a/EIPS/eip-4762.md
+++ b/EIPS/eip-4762.md
@@ -4,7 +4,7 @@ title: Statelessness gas cost changes
 description: Changes the gas schedule to reflect the costs of creating a witness by requiring clients update their database layout to match.
 author: Guillaume Ballet (@gballet), Vitalik Buterin (@vbuterin), Dankrad Feist (@dankrad)
 discussions-to: https://ethereum-magicians.org/t/eip-4762-statelessness-gas-cost-changes/8714
-status: Draft
+status: Stagnant
 type: Standards Track
 category: Core
 created: 2022-02-03

From d58de7cf47c6f7ad9fdef5e863b662c2db94a184 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 3 Dec 2022 16:16:27 -0800
Subject: [PATCH 003/274] (bot 1272989785) moving EIPS/eip-1459.md to stagnant
 (#5935)

PR 5935 with changes to EIPS/eip-1459.md was created on
	(2022-Nov-15th@15.17.42)
which is before the cutoff date of
	(2022-Nov-20th@00.16.7)
i.e. 2 weeks ago
---
 EIPS/eip-1459.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-1459.md b/EIPS/eip-1459.md
index 3e953149aa64d9..00416b0dc86487 100644
--- a/EIPS/eip-1459.md
+++ b/EIPS/eip-1459.md
@@ -5,7 +5,7 @@ description: Scheme for authenticated updateable Ethereum node lists via DNS.
 author: Felix Lange (@fjl), Péter Szilágyi (@karalabe)
 type: Standards Track
 category: Networking
-status: Review
+status: Stagnant
 created: 2018-09-26
 requires: 778
 discussions-to: https://github.com/ethereum/devp2p/issues/50

From 2a2289082ffe6fdcfa317895b879c4c594fca6b5 Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Mon, 5 Dec 2022 00:15:47 +0100
Subject: [PATCH 004/274] Upgrade EIP-5773 to Review status (#6072)

As the peer reviewer has been assigned to the EIP-5773 and is actively
reviewing the proposal, the proposal is being upgraded to `Review`
status.
---
 EIPS/eip-5773.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5773.md b/EIPS/eip-5773.md
index d9a61a0808a988..bb146edc1d6f51 100644
--- a/EIPS/eip-5773.md
+++ b/EIPS/eip-5773.md
@@ -4,7 +4,7 @@ title: Context-Dependent Multi-Asset Tokens
 description: An interface for Multi-Asset tokens with context dependent asset type output controlled by owner's preference.
 author: Bruno Škvorc (@Swader), Cicada (@CicadaNCR), Steven Pineda (@steven2308), Stevan Bogosavljevic (@stevyhacker), Jan Turk (@ThunderDeliverer)
 discussions-to: https://ethereum-magicians.org/t/multiresource-tokens/11326
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-10-10

From eb07a03c80b3f79a78e2dbb98d866f7d216886d7 Mon Sep 17 00:00:00 2001
From: William Entriken <github.com@phor.net>
Date: Sun, 4 Dec 2022 18:29:25 -0500
Subject: [PATCH 005/274] Move status (#6074)

---
 EIPS/eip-6049.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6049.md b/EIPS/eip-6049.md
index 957ea6e1cc2672..d59527d5798e2f 100644
--- a/EIPS/eip-6049.md
+++ b/EIPS/eip-6049.md
@@ -4,7 +4,7 @@ title: Deprecate SELFDESTRUCT
 description: Deprecate SELFDESTRUCT by discouraging its use and warning about a potential future behavior change.
 author: William Entriken (@fulldecent)
 discussions-to: https://ethereum-magicians.org/t/deprecate-selfdestruct/11907
-status: Draft
+status: Review
 type: Meta
 created: 2022-11-27
 ---

From 2f91ed57188d56bae58b8f6696ba56de0625606d Mon Sep 17 00:00:00 2001
From: Andrei Maiboroda <andrei@ethereum.org>
Date: Mon, 5 Dec 2022 12:53:33 +0100
Subject: [PATCH 006/274] Update EIP-4750: Clarify RETF not cleaning the stack
 automatically (#6080)

---
 EIPS/eip-4750.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4750.md b/EIPS/eip-4750.md
index bb14ae1f2da843..604cd1a9c8b4f6 100644
--- a/EIPS/eip-4750.md
+++ b/EIPS/eip-4750.md
@@ -102,7 +102,7 @@ Under `PC_post_instruction` we mean the PC position after the entire immediate a
 #### `RETF`
 
 1. Does not have immediate arguments.
-2. If data stack has less than `caller_stack_height + types[code_section_index].outputs`, execution results in exceptional halt.
+2. If number of items on the data stack is not equal `caller_stack_height + type[code_section_index].outputs`, execution results in exceptional halt.
 3. Charges 3 gas.
 4. Pops nothing and pushes nothing to data stack.
 5. Pops an item from return stack and sets `current_section_index` and `PC` to values from this item.

From 7eac5f7f4aeb7c6f251b5e4a5ebb92d14d307d93 Mon Sep 17 00:00:00 2001
From: George Kadianakis <desnacked@riseup.net>
Date: Mon, 5 Dec 2022 14:02:25 +0200
Subject: [PATCH 007/274] EIP4844: Be explicit about precompile accepting
 canonical inputs (#6082)

---
 EIPS/eip-4844.md | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/EIPS/eip-4844.md b/EIPS/eip-4844.md
index b2c5a705488dbe..df8423c5b84df3 100644
--- a/EIPS/eip-4844.md
+++ b/EIPS/eip-4844.md
@@ -71,12 +71,12 @@ Compared to full data sharding, this EIP has a reduced cap on the number of thes
 
 ### Cryptographic Helpers
 
-Throughout this proposal we use cryptographic methods and classes defined in the corresponding [consensus 4844 specs](https://github.com/ethereum/consensus-specs/blob/a45627164d34ddb60acca385e2324835fc14ca5c/specs/eip4844).
+Throughout this proposal we use cryptographic methods and classes defined in the corresponding [consensus 4844 specs](https://github.com/ethereum/consensus-specs/blob/23d3aeebba3b5da0df4bd25108461b442199f406/specs/eip4844).
 
-Specifically, we use the following methods from [`polynomial-commitments.md`](https://github.com/ethereum/consensus-specs/blob/a45627164d34ddb60acca385e2324835fc14ca5c/specs/eip4844/polynomial-commitments.md):
+Specifically, we use the following methods from [`polynomial-commitments.md`](https://github.com/ethereum/consensus-specs/blob/23d3aeebba3b5da0df4bd25108461b442199f406/specs/eip4844/polynomial-commitments.md):
 
-- [`verify_kzg_proof()`](https://github.com/ethereum/consensus-specs/blob/a45627164d34ddb60acca385e2324835fc14ca5c/specs/eip4844/polynomial-commitments.md#verify_kzg_proof)
-- [`verify_aggregate_kzg_proof()`](https://github.com/ethereum/consensus-specs/blob/a45627164d34ddb60acca385e2324835fc14ca5c/specs/eip4844/polynomial-commitments.md#verify_aggregate_kzg_proof)
+- [`verify_kzg_proof()`](https://github.com/ethereum/consensus-specs/blob/23d3aeebba3b5da0df4bd25108461b442199f406/specs/eip4844/polynomial-commitments.md#verify_kzg_proof)
+- [`verify_aggregate_kzg_proof()`](https://github.com/ethereum/consensus-specs/blob/23d3aeebba3b5da0df4bd25108461b442199f406/specs/eip4844/polynomial-commitments.md#verify_aggregate_kzg_proof)
 
 ### Helpers
 
@@ -243,8 +243,9 @@ The opcode has a gas cost of `HASH_OPCODE_GAS`.
 
 ### Point evaluation precompile
 
-Add a precompile at `POINT_EVALUATION_PRECOMPILE_ADDRESS` that evaluates a proof that a particular blob resolves
-to a particular value at a point.
+Add a precompile at `POINT_EVALUATION_PRECOMPILE_ADDRESS` that verifies a KZG proof which claims that a blob
+(represented by a commitment) evaluates to a given value at a given point.
+
 The precompile costs `POINT_EVALUATION_PRECOMPILE_GAS` and executes the following logic:
 
 ```python
@@ -270,6 +271,8 @@ def point_evaluation_precompile(input: Bytes) -> Bytes:
     return Bytes(U256(FIELD_ELEMENTS_PER_BLOB).to_be_bytes32() + U256(BLS_MODULUS).to_be_bytes32())
 ```
 
+The precompile MUST reject non-canonical field elements (i.e. provided field elements MUST be strictly less than `BLS_MODULUS`).
+
 ### Gas accounting
 
 We introduce data gas as a new type of gas. It is independent of normal gas and follows its own targeting rule, similar to EIP-1559.

From fa4c0f42a4045f3882479efc974453f90ed7908a Mon Sep 17 00:00:00 2001
From: Alex Beregszaszi <alex@rtfs.hu>
Date: Mon, 5 Dec 2022 23:58:12 +0100
Subject: [PATCH 008/274] Clarifications to EIP-663 (#6086)

* Clarifications to EIP-663

* Fix linter
---
 EIPS/eip-663.md | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-663.md b/EIPS/eip-663.md
index 2b3f8bd0c4adee..efa0aa75b52d33 100644
--- a/EIPS/eip-663.md
+++ b/EIPS/eip-663.md
@@ -29,8 +29,8 @@ Introducing `SWAPN` and `DUPN` will provide an option to compilers to simplify a
 
 We introduce two new instructions:
 
- 1. `DUPN` (`0xb3`)
- 2. `SWAPN` (`0xb4`)
+ 1. `DUPN` (`0xb5`)
+ 2. `SWAPN` (`0xb6`)
 
 If the code is legacy bytecode, both of these instructions result in an *exceptional halt*. (*Note: This means no change to behaviour.*)
 
@@ -55,7 +55,16 @@ The gas cost for both instructions is set at 3.
 
 ## Rationale
 
-TBA
+### EOF-only
+
+Since this instruction depends on an immediate argument encoding, it can only be enabled within EOF. In legacy bytecode that encoding could contradict jumpdest-analysis.
+
+### Size of immediate argument
+
+A 16-bit size was considered to accommodate the full stack space of 1024 items, however:
+
+1. that would require an additional restriction/check (`n < 1024`)
+2. the 256 depth is a large improvement over the current 16 and the overhead of an extra byte would make it less useful
 
 ## Backwards Compatibility
 

From 2b8cf837fdb498ae6b8a58b665baff199183acdc Mon Sep 17 00:00:00 2001
From: Alex Beregszaszi <alex@rtfs.hu>
Date: Tue, 6 Dec 2022 15:05:04 +0100
Subject: [PATCH 009/274] EIP-663: Mark for review (#6087)

* EIP-663: Mark for review

* Clarification for backwards compatibility.
---
 EIPS/eip-663.md | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-663.md b/EIPS/eip-663.md
index efa0aa75b52d33..2d88e22e27903f 100644
--- a/EIPS/eip-663.md
+++ b/EIPS/eip-663.md
@@ -4,7 +4,7 @@ title: Unlimited SWAP and DUP instructions
 description: Introduce SWAPN and DUPN which take an immediate value for the depth
 author: Alex Beregszaszi (@axic)
 discussions-to: https://ethereum-magicians.org/t/eip-663-unlimited-swap-and-dup-instructions/3346
-status: Draft
+status: Review
 type: Standards Track
 category: Core
 created: 2017-07-03
@@ -68,11 +68,17 @@ A 16-bit size was considered to accommodate the full stack space of 1024 items,
 
 ## Backwards Compatibility
 
-This has no effect on backwards compatibility because the opcodes were not previously allocated.
+This has no effect on backwards compatibility because the opcodes were not previously allocated and the feature is only enabled in EOF.
 
 ## Test Cases
 
-TBA
+For `0 <= n <= 255`:
+
+    - `DUPN n` to fail if `stack_height < n`.
+    - `SWAPN n` to fail if `stack_height < (n + 1)`.
+    - `DUPN n` to fail if `stack_height + 1 > 1024`.
+    - `DUPN n` and `SWAPN n` to fail if gas available is less than 3.
+    - otherwise `DUPN n` should push the `stack[n]` item to the stack, and `SWAPN n` should swap `stack[n + 1]` with `stack[stack.top()]`.
 
 ## Security Considerations
 

From 6d0e7420ba8663f486e65415b6aa451842d4dea3 Mon Sep 17 00:00:00 2001
From: Alex Stokes <r.alex.stokes@gmail.com>
Date: Tue, 6 Dec 2022 09:56:04 -0700
Subject: [PATCH 010/274] clarify types and allowed values for withdrawal data
 (#6089)

---
 EIPS/eip-4895.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-4895.md b/EIPS/eip-4895.md
index 7a5de3ee3d0ad0..230bd7f4489871 100644
--- a/EIPS/eip-4895.md
+++ b/EIPS/eip-4895.md
@@ -42,9 +42,9 @@ Define a new payload-level object called a `withdrawal` that describes withdrawa
 
 `Withdrawal`s provide key information from the consensus layer:
 1. a monotonically increasing `index`, starting from 0, as a `uint64` value that increments by 1 per withdrawal to uniquely identify each withdrawal
-2. the `validator_index` of the validator on the consensus layer the withdrawal corresponds to
+2. the `validator_index` of the validator, as a `uint64` value, on the consensus layer the withdrawal corresponds to
 3. a recipient for the withdrawn ether `address` as a 20-byte value
-4. an `amount` of ether given in wei as a 256-bit value.
+4. a nonzero `amount` of ether given in wei as a `uint64` value.
 
 *NOTE*: the `index` for each withdrawal is a global counter spanning the entire sequence of withdrawals.
 

From 0fa80ec53554671d55b07f19712cbc589b4a1f33 Mon Sep 17 00:00:00 2001
From: Alex Stokes <r.alex.stokes@gmail.com>
Date: Tue, 6 Dec 2022 11:29:27 -0700
Subject: [PATCH 011/274] fix typo from #6089 to use correct type for
 withdrawal `amount` (#6090)

---
 EIPS/eip-4895.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4895.md b/EIPS/eip-4895.md
index 230bd7f4489871..bf45884c9940f8 100644
--- a/EIPS/eip-4895.md
+++ b/EIPS/eip-4895.md
@@ -44,7 +44,7 @@ Define a new payload-level object called a `withdrawal` that describes withdrawa
 1. a monotonically increasing `index`, starting from 0, as a `uint64` value that increments by 1 per withdrawal to uniquely identify each withdrawal
 2. the `validator_index` of the validator, as a `uint64` value, on the consensus layer the withdrawal corresponds to
 3. a recipient for the withdrawn ether `address` as a 20-byte value
-4. a nonzero `amount` of ether given in wei as a `uint64` value.
+4. a nonzero `amount` of ether given in wei as a `uint256` value.
 
 *NOTE*: the `index` for each withdrawal is a global counter spanning the entire sequence of withdrawals.
 

From 9f3b3837274852aac248a53de78448287f76f999 Mon Sep 17 00:00:00 2001
From: William Entriken <github.com@phor.net>
Date: Tue, 6 Dec 2022 16:00:23 -0500
Subject: [PATCH 012/274] Update EIP-6049: Move to Last Call (#6085)

* Update eip-6049.md

* Fix ordering

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-6049.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-6049.md b/EIPS/eip-6049.md
index d59527d5798e2f..dfcfa0a549c8c8 100644
--- a/EIPS/eip-6049.md
+++ b/EIPS/eip-6049.md
@@ -4,7 +4,8 @@ title: Deprecate SELFDESTRUCT
 description: Deprecate SELFDESTRUCT by discouraging its use and warning about a potential future behavior change.
 author: William Entriken (@fulldecent)
 discussions-to: https://ethereum-magicians.org/t/deprecate-selfdestruct/11907
-status: Review
+status: Last Call
+last-call-deadline: 2022-12-20
 type: Meta
 created: 2022-11-27
 ---

From 29641908b600a98f3a6684275409cfe2cc9380a9 Mon Sep 17 00:00:00 2001
From: Sean <darcys22@gmail.com>
Date: Wed, 7 Dec 2022 08:44:03 +1100
Subject: [PATCH 013/274] Allows for multiple sales taxes (#6092)

---
 EIPS/eip-5570.md | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-5570.md b/EIPS/eip-5570.md
index 992a8b8b0caaf7..1b33d2966c58e0 100644
--- a/EIPS/eip-5570.md
+++ b/EIPS/eip-5570.md
@@ -172,6 +172,11 @@ The JSON schema is composed of 2 parts. The root schema contains high level deta
       "description": "Digital signature by the vendor of receipts data",
       "type": "string"
     }
+    "extra": {
+      "title": "Extra",
+      "description": "Extra information about the business/receipt as needed",
+      "type": "string"
+    }
   }
 }
 ```
@@ -218,7 +223,28 @@ The JSON schema is composed of 2 parts. The root schema contains high level deta
     "tax": {
       "title": "Tax",
       "description": "Amount of tax charged for unit",
-      "type": "number"
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "rate", "amount"],
+        "properties": {
+          "name": {
+            "title": "Name of Tax",
+            "description": "GST/PST etc",
+            "type": "string"
+          },
+          "rate": {
+            "title": "Tax Rate",
+            "description": "Tax rate as a percentage",
+            "type": "number"
+          },
+          "amount": {
+            "title": "Tax Amount",
+            "description": "Total amount of tax charged",
+            "type": "number"
+          }
+        }
+      }
     },
     "quantity": {
       "title": "Quantity",

From 4de49ca6385fed6fb286e5c5db5efce340ccfbc2 Mon Sep 17 00:00:00 2001
From: ashhanai <ashhab.naim@gmail.com>
Date: Wed, 7 Dec 2022 10:37:17 +0000
Subject: [PATCH 014/274] EIP-5646: Require only mutable state properties to be
 included in the state fingerprint (#6095)

* Add EIP-5646: Token state fingerprint

* Update EIP-5646: add link to discussion

* Update EIP-5646: reference ERC standards as EIP-N

* Update EIP-5646: update all EIP references to links

* Update EIP-5646: fix incorrect EIP references

* Update EIP-5646: Rework the structure of the whole draft

* EIP-5646: Use mutable tokens instead of derivative tokens in spec

* EIP-5646: Require only mutable state properties to be inlcuded in state fingerprint
---
 EIPS/eip-5646.md | 24 +++++++++++++-----------
 1 file changed, 13 insertions(+), 11 deletions(-)

diff --git a/EIPS/eip-5646.md b/EIPS/eip-5646.md
index 4eab226a3b6d76..90aee881188ccd 100644
--- a/EIPS/eip-5646.md
+++ b/EIPS/eip-5646.md
@@ -13,7 +13,7 @@ requires: 165
 
 ## Abstract
 
-This specification defines the minimum interface required to unambiguously identify the state of a derivative token without knowledge of implementation details.
+This specification defines the minimum interface required to unambiguously identify the state of a mutable token without knowledge of implementation details.
 
 ## Motivation
 
@@ -40,17 +40,19 @@ interface ERC5646 is ERC165 {
 
 - `getStateFingerprint` MUST return a different value when the token state changes.
 - `getStateFingerprint` MUST NOT return a different value when the token state remains the same.
-- `getStateFingerprint` MUST factor in all parameters that might change the state of a token.
+- `getStateFingerprint` MUST include all state properties that might change during the token lifecycle (are not immutable).
 - `getStateFingerprint` MAY include computed values, such as values based on a current timestamp (e.g., expiration, maturity).
 - `getStateFingerprint` MAY include token metadata URI.
 - `supportsInterface(0xf5112315)` MUST return `true`.
 
 ## Rationale
 
-Protocols can use state fingerprints as a part of a token identifier and support derivative tokens without knowing any state implementation details.
+Protocols can use state fingerprints as a part of a token identifier and support mutable tokens without knowing any state implementation details.
 
 ![](../assets/eip-5646/support-per-eip.png)
 
+State fingerprints don't have to factor in state properties that are immutable, because they can be safely identified by a token id. 
+
 This standard is not for use cases where token state property knowledge is required, as these cases cannot escape the bottleneck problem described earlier.
 
 ## Backwards Compatibility
@@ -62,8 +64,8 @@ This EIP is not introducing any backward incompatibilities.
 ```solidity
 pragma solidity ^0.8.0;
 
-/// @title Example of a token with computed state fingerprint.
-contract LPTokenComputed is ERC721, ERC5646 {
+/// @title Example of a mutable token implementing state fingerprint.
+contract LPToken is ERC721, ERC5646 {
 
     /// @dev Stored token states (token id => state).
     mapping (uint256 => State) internal states;
@@ -73,8 +75,8 @@ contract LPTokenComputed is ERC721, ERC5646 {
         address asset2;
         uint256 amount1;
         uint256 amount2;
-        uint256 fee;
-        address operator;
+        uint256 fee; // Immutable
+        address operator; // Immutable
         uint256 expiration; // Parameter dependent on a block.timestamp
     }
 
@@ -91,9 +93,9 @@ contract LPTokenComputed is ERC721, ERC5646 {
                 state.asset2,
                 state.amount1,
                 state.amount2,
-                state.fee,
-                state.operator,
-                block.timestamp < state.expiration ? false : true
+                // state.fee don't need to be part of the fingerprint computation as it is immutable
+                // state.operator don't need to be part of the fingerprint computation as it is immutable
+                block.timestamp >= state.expiration
             )
         );
     }
@@ -110,7 +112,7 @@ contract LPTokenComputed is ERC721, ERC5646 {
 
 Token state fingerprints from two different contracts may collide. Because of that, they should be compared only in the context of one token contract.
 
-If the `getStateFingerprint` implementation does not include all parameters that could change the token state, a token owner would be able to change the token state without invalidating the token identifier. It could break the trustless assumptions of several protocols, which create, e.g., buy offers for tokens. The token owner would be potentially able to decrease the value of a derivative token before accepting an offer.
+If the `getStateFingerprint` implementation does not include all parameters that could change the token state, a token owner would be able to change the token state without changing the token fingerprint. It could break the trustless assumptions of several protocols, which create, e.g., buy offers for tokens. The token owner would be able to change the state of the token before accepting an offer.
 
 ## Copyright
 

From ab73851aaaa3f1ada52d2648383c8de57d6d7927 Mon Sep 17 00:00:00 2001
From: Andrei Maiboroda <andrei@ethereum.org>
Date: Wed, 7 Dec 2022 11:58:14 +0100
Subject: [PATCH 015/274] Update EIP-4200: Add Test Cases for RJUMPV (#6096)

---
 EIPS/eip-4200.md | 26 ++++++++++++++++++--------
 1 file changed, 18 insertions(+), 8 deletions(-)

diff --git a/EIPS/eip-4200.md b/EIPS/eip-4200.md
index 741636d186682e..fffa56060bd3bb 100644
--- a/EIPS/eip-4200.md
+++ b/EIPS/eip-4200.md
@@ -124,28 +124,38 @@ This change poses no risk to backwards compatibility, as it is introduced at the
 
 #### Valid cases
 
-- `RJUMP`/`RJUMPI` with `JUMPDEST` as target
+- `RJUMP`/`RJUMPI`/`RJUMPV` with `JUMPDEST` as target
     - `relative_offset` is positive/negative/`0`
-- `RJUMP`/`RJUMPI` with instruction other than `JUMPDEST` as target
+- `RJUMP`/`RJUMPI`/`RJUMPV` with instruction other than `JUMPDEST` as target
     - `relative_offset` is positive/negative/`0`
+- `RJUMPV` with various valid table sizes from 1 to 255
 
 #### Invalid cases
 
-- `RJUMP`/`RJUMPI` with truncated immediate
-- `RJUMP`/`RJUMPI` as a final instruction in code section
-- `RJUMP`/`RJUMPI` target outside of code section bounds
-- `RJUMP`/`RJUMPI` target push data
-- `RJUMP`/`RJUMPI` target another `RJUMP`/`RJUMPI` immediate argument
+- `RJUMP`/`RJUMPI`/`RJUMPV` with truncated immediate
+- `RJUMP`/`RJUMPI`/`RJUMPV` as a final instruction in code section
+- `RJUMP`/`RJUMPI`/`RJUMPV` target outside of code section bounds
+- `RJUMP`/`RJUMPI`/`RJUMPV` target push data
+- `RJUMP`/`RJUMPI`/`RJUMPV` target another `RJUMP`/`RJUMPI`/`RJUMPV` immediate argument
+- `RJUMPV` with table size 0
 
 ### Execution
 
-- `RJUMP`/`RJUMPI` in legacy code aborts execution
+- `RJUMP`/`RJUMPI`/`RJUMPV` in legacy code aborts execution
 - `RJUMP`
     - `relative_offset` is positive/negative/`0`
 - `RJUMPI`
     - `relative_offset` is positive/negative/`0`
         - `condition` equals `0`
         - `condition` does not equal `0` 
+- `RJUMPV 1 relative_offset`
+    - `case` equals `0`
+    - `case` does not equal `0` 
+- `RJUMPV` with table containing positive, negative, `0` offsets
+    - `case` equals `0`
+    - `case` does not equal `0` 
+    - `case` outside of table bounds (`case >= count`, fallback case)
+    - `case` > 255
 
 ## Reference Implementation
 

From c282a9bd3ed750d315abbf5483ab31db2a3e5757 Mon Sep 17 00:00:00 2001
From: Moody Salem <moodysalem@users.noreply.github.com>
Date: Wed, 7 Dec 2022 13:16:53 -0500
Subject: [PATCH 016/274] incorporate thread feedback to EIP-1153 (#6098)

* incorporate thread feedback to EIP-1153

* fix the reference to erc20
---
 EIPS/eip-1153.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/EIPS/eip-1153.md b/EIPS/eip-1153.md
index 147a70b4bf23c2..3ea30688b16741 100644
--- a/EIPS/eip-1153.md
+++ b/EIPS/eip-1153.md
@@ -70,6 +70,10 @@ Another option to solve the problem of inter-frame communication is repricing th
 
 Another approach is to keep the refund counter for transient storage separate from the refund counter for other storage uses, and remove the refund cap for transient storage. However, that approach is more complex to implement and understand. For example, the 20% refund cap must be applied to the gas used _after_ subtracting the uncapped gas refund. Otherwise, the refund amount available subject to the 20% refund cap could be increased by executing transient storage writes. Thus it is preferable to have a separate mechanism that does not interact with the refund counter. Future hard forks can remove the complex refund behavior meant to support the transient storage use case, encouraging migration to contracts that are more efficient for the Ethereum clients to execute.
 
+There is a known objection to the word-addressed storage-like interface of the `TSTORE` and `TLOAD` opcodes since transient storage is more akin to memory than storage in lifecycle. A byte-addressed memory-like interface is another option. The storage-like word-addressed interface is preferred due to the usefulness of mappings in combination with the transaction-scoped memory region. Often times, you will need to keep transient state with arbitrary keys, such as in the [EIP-20](./eip-20.md) temporary approval use case which uses a mapping of `(owner, spender)` to `allowance`. Mappings are difficult to implement using linear memory, and linear memory must also have dynamic gas costs. It is also more complicated to handle reverts with a linear memory. It is possible to have a memory-like interface while the underlying implementation uses a map to allow for storage in arbitrary offsets, but this would result in a third memory-storage hybrid interface that would require new code paths in compilers.
+
+Some think that a unique transaction identifier may obviate the need for transient storage as described in this EIP. This is a misconception: a transaction identifier used in combination with regular storage has all the same issues that motivate this EIP. The two features are orthogonal.  
+
 Relative cons of this transient storage EIP:
 
 - Does not address transient usages of storage in existing contracts
@@ -242,6 +246,8 @@ However, if you only spend 1M gas allocating memory in each context, and make ca
 
 Smart contract developers should understand the lifetime of transient storage variables before use. Because transient storage is automatically cleared at the end of the transaction, smart contract developers may be tempted to avoid clearing slots as part of a call in order to save gas. However, this could prevent further interactions with the contract in the same transaction (e.g. in the case of re-entrancy locks) or cause other bugs, so smart contract developers should be careful to _only_ leave transient storage slots with nonzero values when those slots are intended to be used by future calls within the same transaction. Otherwise, these opcodes behave exactly the same as `SSTORE` and `SLOAD`, so all the usual security considerations apply especially in regard to reentrancy risk.
 
+Smart contract developers may also be tempted to use transient storage as an alternative to in-memory mappings. They should be aware that transient storage is not discarded when a call returns or reverts, as is memory, and should prefer memory for these use cases so as not to create unexpected behavior on reentrancy in the same transaction. The necessarily high cost of transient storage over memory should already discourage this usage pattern. Most usages of in-memory mappings can be better implemented with key-sorted lists of entries, and in-memory mappings are rarely required in smart contracts (i.e. the author knows of no known use cases in production).
+
 ## Copyright
 
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 73357f8201d5bc0271fcf0a32e074c859e48c8e1 Mon Sep 17 00:00:00 2001
From: Alex Beregszaszi <alex@rtfs.hu>
Date: Wed, 7 Dec 2022 21:26:05 +0100
Subject: [PATCH 017/274] Add EIP-6046: Replace SELFDESTRUCT with DEACTIVATE
 (#6046)

* Add deactivate eip

* Use 6046 as the number

* Fix header

* Fix headings

* Please the linter

* Clarify the 2681 change

* Do not refund on selfdestruct

* Clarify the transfer aspect

* Depend on EIP-3529

* Apply wording suggestion for motivation

* Applied wording suggestions

* Depend on EIP-2929 and add note

* Fix typo

* Update security considerations
---
 EIPS/eip-6046.md | 67 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 67 insertions(+)
 create mode 100644 EIPS/eip-6046.md

diff --git a/EIPS/eip-6046.md b/EIPS/eip-6046.md
new file mode 100644
index 00000000000000..87292ad479fb48
--- /dev/null
+++ b/EIPS/eip-6046.md
@@ -0,0 +1,67 @@
+---
+eip: 6046
+title: Replace SELFDESTRUCT with DEACTIVATE
+description: Change SELFDESTRUCT to not delete storage keys and use a special value in the account nonce to signal deactivation
+author: Alex Beregszaszi (@axic)
+discussions-to: https://ethereum-magicians.org/t/almost-self-destructing-selfdestruct-deactivate/11886
+status: Draft
+type: Standards Track
+category: Core
+created: 2022-11-25
+requires: 2681, 2929, 3529
+---
+
+## Abstract
+
+Change `SELFDESTRUCT` to not delete all storage keys, and to use a special value in the account nonce to signal *decativated* accounts. Because the semantics of revival change (storage keys may exists), we also rename the instruction to `DEACTIVATE`.
+
+## Motivation
+
+The `SELFDESTRUCT` instruction currently has a fixed price, but is unbounded in terms of how many storage/account changes it performs (it needs to delete all keys). This has been an outstanding concern for some time.
+
+Furthermore, with *Verkle trees*, accounts will be organised differently: account properties, including storage, will have individual keys. It will not be possible to traverse and find all used keys. This makes `SELFDESTRUCT` very challenging to support in Verkle trees.
+
+## Specification
+
+1. Change the rules introduced by [EIP-2681](./eip-2681.md) such that regular nonce increase is bound by `2^64-2` instead of `2^64-1`. This applies from genesis.
+
+2. The behaviour of `SELFDESTRUCT` is changed such that:
+
+  - Does not delete any storage keys and also leave the account in place.
+  - Transfer the account balance to the target **and** set account balance to `0.`
+  - Set the account nonce to `2^64-1`.
+
+  Note that no refund is given since [EIP-3529](./eip-3529.md).
+
+  Note that the rules of [EIP-2929](./eip-2929.md) regarding `SELFDESTRUCT` remain unchanged.
+
+2. Modify account execution (triggered both via external transactions or CALL* instructions), such that execution succeeds and returns an empty buffer if the nonce equals `2^64-1`.
+
+  - Note that the account can still receive non-executable value transfers (such as coinbase transactions or other `SELFDESTRUCT`s).
+
+3. Modify `CREATE2` such that it allows account creation if the nonce equals `2^64-1`.
+
+  - Note that the account (especially code and storage) might not be empty prior to `CREATE2`.
+  - Note that a successful `CREATE2` will change the account code, nonce and potentially balance.
+
+4. Rename the `SELFDESTRUCT` instruction to `DEACTIVATE`, because the semantics of "account revival" are changed: the old storage items will remain, and newly deployed code must be aware of this.
+
+## Rationale
+
+There have been various proposals of removing `SELFDESTRUCT` and many would just outright remove the deletion capability. This breaks certain usage patterns, which the *deactivation* option leaves intact, albeit with minor changes. This only affects *newly* deployed code, and not existing one.
+
+All the proposals would leave data in the state, but this proposal provides the flexibility to reuse or remove storage slots one-by-one should the revived contract choose to do so.
+
+## Backwards Compatibility
+
+This EIP requires a protocol upgrade, since it modifies consensus rules. The further restriction of nonce should not have an effect on accounts, as `2^64-2` is an unfeasibly high limit.
+
+Contracts using the revival pattern will still work, but the code deployed during revival may need to be made aware that storage keys can already exist in the account.
+
+## Security Considerations
+
+The new behaviour of preserving storage has a potential effect on security. Contract authors must be aware and design contracts accordingly. There may be an effect on existing deployed code performing autonomous destruction and revival.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From a35509fd412f476dd02fb8bd193add31d693376d Mon Sep 17 00:00:00 2001
From: Andrei Maiboroda <andrei@ethereum.org>
Date: Thu, 8 Dec 2022 12:23:08 +0100
Subject: [PATCH 018/274] Update EIP-4200: Add short new instruction summary
 (#6100)

---
 EIPS/eip-4200.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/EIPS/eip-4200.md b/EIPS/eip-4200.md
index fffa56060bd3bb..23080249f36671 100644
--- a/EIPS/eip-4200.md
+++ b/EIPS/eip-4200.md
@@ -35,11 +35,11 @@ The main benefit of these instruction is reduced gas cost (both at deploy and ex
 
 ## Specification
 
-We introduce two new instructions on the same block number [EIP-3540](./eip-3540.md) is activated on:
+We introduce three new instructions on the same block number [EIP-3540](./eip-3540.md) is activated on:
 
-1. `RJUMP` (0x5c)
-2. `RJUMPI` (0x5d)
-3. `RJUMPV` (0x5e)
+1. `RJUMP` (0x5c) - relative jump
+2. `RJUMPI` (0x5d) - conditional relative jump
+3. `RJUMPV` (0x5e) - relative jump via jump table
 
 If the code is legacy bytecode, all of these instructions result in an *exceptional halt*. (*Note: This means no change to behaviour.*)
 

From daa5a3ce9b4e80b216bd469820cdffa2479e57a1 Mon Sep 17 00:00:00 2001
From: Alex Beregszaszi <alex@rtfs.hu>
Date: Thu, 8 Dec 2022 13:09:29 +0100
Subject: [PATCH 019/274] Fix some typos (#6102)

---
 EIPS/eip-6046.md | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/EIPS/eip-6046.md b/EIPS/eip-6046.md
index 87292ad479fb48..a4af4fed15d756 100644
--- a/EIPS/eip-6046.md
+++ b/EIPS/eip-6046.md
@@ -13,7 +13,7 @@ requires: 2681, 2929, 3529
 
 ## Abstract
 
-Change `SELFDESTRUCT` to not delete all storage keys, and to use a special value in the account nonce to signal *decativated* accounts. Because the semantics of revival change (storage keys may exists), we also rename the instruction to `DEACTIVATE`.
+Change `SELFDESTRUCT` to not delete all storage keys, and to use a special value in the account nonce to signal *deactivated* accounts. Because the semantics of revival change (storage keys may exists), we also rename the instruction to `DEACTIVATE`.
 
 ## Motivation
 
@@ -30,10 +30,8 @@ Furthermore, with *Verkle trees*, accounts will be organised differently: accoun
   - Does not delete any storage keys and also leave the account in place.
   - Transfer the account balance to the target **and** set account balance to `0.`
   - Set the account nonce to `2^64-1`.
-
-  Note that no refund is given since [EIP-3529](./eip-3529.md).
-
-  Note that the rules of [EIP-2929](./eip-2929.md) regarding `SELFDESTRUCT` remain unchanged.
+  - Note that no refund is given since [EIP-3529](./eip-3529.md).
+  - Note that the rules of [EIP-2929](./eip-2929.md) regarding `SELFDESTRUCT` remain unchanged.
 
 2. Modify account execution (triggered both via external transactions or CALL* instructions), such that execution succeeds and returns an empty buffer if the nonce equals `2^64-1`.
 

From 49c14e30e92de83c04d4abe624527db12b85e2b0 Mon Sep 17 00:00:00 2001
From: Andrei Maiboroda <andrei@ethereum.org>
Date: Thu, 8 Dec 2022 14:52:48 +0100
Subject: [PATCH 020/274] Update EIP-4750: Add JUMPF instruction (#6023)

* Update EIP-4750: Add TAILCALLF instruction

* Rename TAILCALLF to JUMPF

* Implement JUMPF semantics

* Implement RETF with memmove

* Perform stack cleanup on JUMPF too

* Fix typo

* Mention RJUMPV immediate validation

* Add opcode descriptions

* Fix JUMPF cleaning stack rule

* Add rationale for JUMPF cleaning the stack

* Add rationale for RETF cleaning

* Fix typo in JUMPF spec

Co-authored-by: Alex Beregszaszi <alex@rtfs.hu>
---
 EIPS/eip-4750.md | 80 ++++++++++++++++++++++++++++++++++++------------
 1 file changed, 60 insertions(+), 20 deletions(-)

diff --git a/EIPS/eip-4750.md b/EIPS/eip-4750.md
index 604cd1a9c8b4f6..3ca0e8bf541af8 100644
--- a/EIPS/eip-4750.md
+++ b/EIPS/eip-4750.md
@@ -1,7 +1,7 @@
 ---
 eip: 4750
 title: EOF - Functions
-description: Individual sections for functions with `CALLF` and `RETF` instructions
+description: Individual sections for functions with `CALLF`, `JUMPF` and `RETF` instructions
 author: Andrei Maiboroda (@gumb0), Alex Beregszaszi (@axic), Paweł Bylica (@chfast)
 discussions-to: https://ethereum-magicians.org/t/eip-4750-eof-functions/8195
 status: Review
@@ -13,7 +13,7 @@ requires: 3540, 3670
 
 ## Abstract
 
-Introduce the ability to have several code sections in EOF-formatted ([EIP-3540](./eip-3540.md)) bytecode, each one representing a separate subroutine/function. Two new opcodes,`CALLF` and `RETF`, are introduced to call and return from such a function. Dynamic jump instructions are disallowed.
+Introduce the ability to have several code sections in EOF-formatted ([EIP-3540](./eip-3540.md)) bytecode, each one representing a separate subroutine/function. Two new opcodes,`CALLF` and `RETF`, are introduced to call and return from such a function. Additionally `JUMPF` instruction is introduced to perform a jump to a function. Dynamic jump instructions are disallowed.
 
 ## Motivation
 
@@ -62,12 +62,13 @@ Additionally, EVM keeps track of the index of currently executing section - `cur
 
 ### New instructions
 
-We introduce two new instructions:
+We introduce three new instructions:
 
-1. `CALLF` (`0xb0`)
-2. `RETF` (`0xb1`)
+1. `CALLF` (`0xb0`) - call a function
+2. `RETF` (`0xb1`) - return from a function
+2. `JUMPF` (`0xb2`) - jump to a function (without updating return stack)
 
-If the code is legacy bytecode, both of these instructions result in an *exceptional halt*. (*Note: This means no change to behaviour.*)
+If the code is legacy bytecode, any of these instructions results in an *exceptional halt*. (*Note: This means no change to behaviour.*)
 
 First we define several helper values:
 
@@ -80,7 +81,7 @@ If the code is valid EOF1, the following execution rules apply:
 #### `CALLF`
 
 1. Has one immediate argument,`code_section_index`, encoded as a 16-bit unsigned big-endian value.
-2. If data stack has less than `caller_stack_height +  type[code_section_index].inputs`, execution results in exceptional halt.
+2. If data stack has less than `caller_stack_height + type[code_section_index].inputs` items, execution results in exceptional halt.
 3. If data stack size after the call would exceed `1024` items, (i.e. if `caller_stack_height - type[code_section_index].inputs + type[code_section_index].ouputs > 1024`), execution results in exceptional halt.
 4. If return stack already has `1024` items, execution results in exceptional halt.
 5. Charges 5 gas.
@@ -99,13 +100,24 @@ Under `PC_post_instruction` we mean the PC position after the entire immediate a
 
 7. Sets `current_section_index` to `code_section_index` and `PC` to `0`, and execution continues in the called section.
 
+#### `JUMPF`
+
+1. Has one immediate argument,`code_section_index`, encoded as a 16-bit unsigned big-endian value.
+2. If data stack has less than `caller_stack_height + type[code_section_index].inputs` items, execution results in exceptional halt.
+3. If data stack has more than `caller_stack_height + type[code_section_index].inputs` items, discards the items between `caller_stack_height` and top `type[code_section_index].inputs` items, so that there are exactly `caller_stack_height +  type[code_section_index].inputs` items left.
+4. Charges 4 gas.
+5. Pops nothing and pushes nothing to data stack.
+6. Pushes nothing to return stack.
+7. Sets `current_section_index` to `code_section_index` and `PC` to `0`, and execution continues in the called section.
+
 #### `RETF`
 
 1. Does not have immediate arguments.
-2. If number of items on the data stack is not equal `caller_stack_height + type[code_section_index].outputs`, execution results in exceptional halt.
-3. Charges 3 gas.
-4. Pops nothing and pushes nothing to data stack.
-5. Pops an item from return stack and sets `current_section_index` and `PC` to values from this item.
+2. If data stack has less than `caller_stack_height + type[code_section_index].outputs` items, execution results in exceptional halt.
+3. If data stack has more than `caller_stack_height + type[code_section_index].outputs` items, discards the items between `caller_stack_height` and top `type[code_section_index].outputs` items, so that there are exactly `caller_stack_height +  type[code_section_index].outputs` items left.
+4. Charges 4 gas.
+5. Pops nothing and pushes nothing to data stack.
+6. Pops an item from return stack and sets `current_section_index` and `PC` to values from this item.
    1. If return stack is empty after this, execution halts with success.
 
 ### Code Validation
@@ -113,11 +125,12 @@ Under `PC_post_instruction` we mean the PC position after the entire immediate a
 In addition to container format validation rules above, we extend code section validation rules (as defined in [EIP-3670](./eip-3670.md)).
 
 1. Code validation rules of EIP-3670 are applied to every code section.
-2. List of allowed *terminating instructions* in EIP-3670 is extended to include `RETF`. (*Note that `CALLF`, like other instructions with immediates, cannot be truncated.*)
-3. Code section is invalid in case an immediate argument of any `CALLF` is greater than or equal to the total number of code sections.
-4. `RJUMP` and `RJUMPI` immediate argument value (jump destination relative offset) validation:
+2. List of allowed *terminating instructions* in EIP-3670 is extended to include `RETF` and `JUMPF`. (*Note that `CALLF` and `JUMPF`, like other instructions with immediates, cannot be truncated.*)
+3. Code section is invalid in case an immediate argument of any `CALLF` or `JUMPF` is greater than or equal to the total number of code sections.
+4. Code section is invalid in case an immediate argument of any `JUMPF` is such that `type[callee_section_index].outputs != type[caller_section_index].outputs`, i.e. it is allowed to only jump to functions with the same output type.
+5. `RJUMP`, `RJUMPI` and `RJUMPV` immediate argument value (jump destination relative offset) validation:
     1. Code section is invalid in case offset points to a position outside of section bounds.
-    2. Code section is invalid in case offset points to one of two bytes directly following `CALLF` instruction.
+    2. Code section is invalid in case offset points to one of two bytes directly following `CALLF` or `JUMPF` instruction.
 
 ### Disallowed instructions
 
@@ -154,6 +167,22 @@ Instead of deprecating `JUMPDEST` we repurpose it as `NOP` instruction, because
 
 The purpose of `JUMPDEST` analysis was to find in code the valid `JUMPDEST` bytes that do not happen to be inside `PUSH` immediate data. Only dynamic jump instructions (`JUMP`, `JUMPI`) required destination to be `JUMPDEST` instruction. Relative static jumps (`RJUMP` and `RJUMPI`) do not have this requirement and are validated once at deploy-time EOF instruction validation. Therefore, without dynamic jump instructions, `JUMPDEST` analysis is not required.
 
+### `JUMPF` instruction cleaning the stack
+
+In case function pushes on the stack more items than inputs required by the jumped-to function, these extra items could be accessed by the jumped-to function, because the underflow check is defined in terms of `caller_stack_height`, which does not change after `JUMPF`:
+
+> 3. If any instruction would access a data stack item below `caller_stack_height`, execution results in exceptional halt.
+
+In other words the entire stack frame of the function executing `JUMPF` is accessible to the jumped-to function.
+
+We believe this introduces unwanted edge-case behaviour with underflow exception depending on how the function was called or jumped-to, and require `JUMPF` to discard extra items to prevent this.
+
+### `RETF` instruction cleaning the stack
+
+The stack for the return items for `RETF` is automatically cleaned up. This could be relaxed and the onus could be put onto the user to clean it up, because the stack height difference can be clearly calculated, both when a function is entered via `CALLF` or `JUMPF`.
+
+However, we hope to relax the clean up requirement for `JUMPF`, and that would mean it is not possible anymore for the user to cleanup for `RETF`, because the height could be different depending on the path a function is entered.
+
 ## Backwards Compatibility
 
 This change poses no risk to backwards compatibility, as it is introduced only for EOF1 contracts, for which deploying undefined instructions is not allowed, therefore there are no existing contracts using these instructions. The new instructions are not introduced for legacy bytecode (code which is not EOF formatted).
@@ -184,18 +213,19 @@ valid_opcodes = [
     *range(0x80, 0x8f + 1),
     *range(0x90, 0x9f + 1),
     *range(0xa0, 0xa4 + 1),
-    0xb0, 0xb1,
+    0xb0, 0xb1, 0xb2,
     # Note: 0xfe is considered assigned.
     0xf0, 0xf1, 0xf3, 0xf4, 0xf5, 0xfa, 0xfd, 0xfe
 ]
 
-# STOP, RETF, RETURN, REVERT, INVALID
-terminating_opcodes = [0x00, 0xb1, 0xf3, 0xfd, 0xfe]
+# STOP, RETF, JUMPF, RETURN, REVERT, INVALID
+terminating_opcodes = [0x00, 0xb1, 0xb2, 0xf3, 0xfd, 0xfe]
 
 immediate_sizes = 256 * [0]
 immediate_sizes[0x5c] = 2  # RJUMP
 immediate_sizes[0x5d] = 2  # RJUMPI
 immediate_sizes[0xb0] = 2  # CALLF
+immediate_sizes[0xb2] = 2  # JUMPF
 for opcode in range(0x60, 0x7f + 1):  # PUSH1..PUSH32
     immediate_sizes[opcode] = opcode - 0x60 + 1
 
@@ -272,7 +302,7 @@ def validate_eof(code: bytes):
         raise ValidationException("invalid type of section 0")
 
 # Raises ValidationException on invalid code
-def validate_code_section(code: bytes, num_code_sections: int):
+def validate_code_section(func_id: int, code: bytes, types: list[FunctionType] = [FunctionType(0, 0)]):
     # Note that EOF1 already asserts this with the code section requirements
     assert len(code) > 0
 
@@ -302,9 +332,19 @@ def validate_code_section(code: bytes, num_code_sections: int):
                 raise ValidationException("truncated CALLF immediate")
             section_id = int.from_bytes(code[pos:pos+2], byteorder = "big", signed = False)
 
-            if section_id >= num_code_sections:
+            if section_id >= len(types):
+                raise ValidationException("invalid section id")
+        elif opcode == 0xb2:
+            if pos + 2 > len(code):
+                raise ValidationException("truncated JUMPF immediate")
+            section_id = int.from_bytes(code[pos:pos+2], byteorder = "big", signed = False)
+
+            if section_id >= len(types):
                 raise ValidationException("invalid section id")
 
+            if types[section_id].outputs != types[func_id].outputs:
+                raise ValidationException("incompatible function type for JUMPF")
+
         # Save immediate value positions
         immediates.update(range(pos, pos + immediate_sizes[opcode]))
         # Skip immediates

From acd69bd27119ccf5aca6546f3070ff4186e72e4f Mon Sep 17 00:00:00 2001
From: Andrei Maiboroda <andrei@ethereum.org>
Date: Thu, 8 Dec 2022 14:56:35 +0100
Subject: [PATCH 021/274] Update EIP-5450: Add JUMPF simplification (#6101)

* Update EIP-5450: Add JUMPF simplification change

* Apply stylistic suggestions and typo fixes from review

Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>

Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>
---
 EIPS/eip-5450.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/EIPS/eip-5450.md b/EIPS/eip-5450.md
index 4c9d6e62b6f873..9a590b80f74211 100644
--- a/EIPS/eip-5450.md
+++ b/EIPS/eip-5450.md
@@ -50,6 +50,20 @@ Given new deploy-time guarantees, EVM implementation is not required anymore to
 
 Stack overflow check, on the other hand, is still required at run-time, because function execution can start at arbitrary (i.e. known only at run-time) stack height at `CALLF` instruction of a caller (i.e. each execution can be in arbitrary inner call frame). Verification algorithm examines only stack height changes relative to starting stack height of the function.
 
+#### JUMPF changes
+
+In case a function pushed more items to the stack than is required as inputs by the jumped-to function, the previously defined `JUMPF` instruction behaviour was to remove the extra items:
+
+> 3. If data stack has more than `caller_stack_height + type[code_section_index].inputs` items, discards the items between `caller_stack_height` and top `type[code_section_index].inputs`, so that there are exactly `caller_stack_height +  type[code_section_index].items` items left.
+
+Given the new deploy-time guarantee of no function underflowing its stack frame, `JUMPF` instruction can check only that there is enough items for input arguments of the callee on the stack, without making sure there is exactly `inputs` items and not more. 
+
+Therefore, the previously defined behavior of discarding extra items is removed, and only the check for enough inputs is done:
+
+> 2. If data stack has less than `caller_stack_height + type[code_section_index].inputs` items, execution results in exceptional halt.
+
+With this change `JUMPF` operation complexity does not depend on `ouputs` value and is constant-time, therefore the price of `JUMPF` is lowered to 3 gas.
+
 ## Rationale
 
 ### Stack overflow check only in CALLF

From 4a85c28ffa765109ae27f0f92e9f07118b1d6dd9 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Thu, 8 Dec 2022 21:07:14 -0800
Subject: [PATCH 022/274] Update ci.yml for ubuntu version fixing HTMLProofer
 (#6107)

* Update ci.yml for ruby version fixing HTMLProofer

* Update ci.yml

* Update ci.yml

* Update ci.yml

* Update ci.yml
---
 .github/workflows/ci.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 74e7087fad5565..00b9a8247d6756 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -38,7 +38,7 @@ jobs:
 
   htmlproofer:
     name: HTMLProofer
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-20.04
     
     steps:
       - name: Checkout EIP Repository
@@ -46,7 +46,7 @@ jobs:
 
       - name: Install OpenSSL
         run: sudo apt-get update && sudo apt-get install -y libcurl4-openssl-dev
-    
+
       - name: Install Ruby
         uses: ruby/setup-ruby@08245253a76fa4d1e459b7809579c62bd9eb718a
         with:

From 2802db1c80cf75fad4432bd764d375dce7069356 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Thu, 8 Dec 2022 21:22:33 -0800
Subject: [PATCH 023/274] Update EIP-5247 (#6106)

* Update EIP

* Update EIP

* Update EIP
---
 EIPS/eip-5247.md | 55 ++++++++++++++++++++++++------------------------
 1 file changed, 27 insertions(+), 28 deletions(-)

diff --git a/EIPS/eip-5247.md b/EIPS/eip-5247.md
index 59a2aa45731beb..8d2823c9737a4d 100644
--- a/EIPS/eip-5247.md
+++ b/EIPS/eip-5247.md
@@ -1,20 +1,22 @@
 ---
 eip: 5247
-title: Smart Proposal
-description: An interface of "proposals" that is submitted to, recorded on and possibly executed and enforced onchain.
+title: Smart Contract Executable Proposal Interface
+description: An interface to create and execute proposals.
 author: Zainan Victor Zhou (@xinbenlv)
 discussions-to: https://ethereum-magicians.org/t/erc-5247-executable-proposal-standard/9938
 status: Draft
 type: Standards Track
 category: ERC
 created: 2022-07-13
-requires: 7
 ---
 
 ## Abstract
-This EIP presents an interface for "smart proposals": proposals that are submitted to, recorded on, and possibly executed on-chain. When a smart proposal is on-chain executable, it contains information on smart-contract calls, including addresses, ether values, call data, and other metadata information.
+
+This EIP presents an interface for "smart contract executable proposals": proposals that are submitted to, recorded on, and possibly executed on-chain. Such proposals include a series of information about
+function calls including the target contract address, ether value to be transmitted, gas limits and calldatas.
 
 ## Motivation
+
 It is oftentimes necessary to separate the code that is to be executed from the actual execution of the code.
 
 A typical use case for this EIP is in a Decentralized Autonomous Organization (DAO). A proposer will create a smart proposal and advocate for it. Members will then choose whether or not to endorse the proposal and vote accordingly (see [EIP-1202](./eip-1202.md)). Finallym when consensus has been formed, the proposal is executed.
@@ -24,44 +26,40 @@ A second typical use-case is that one could have someone who they trust, such as
 A third use-case is that a person could make an "offer" to a second person, potentially with conditions. The smart proposal can be presented as an offer and the second person can execute it if they choose to accept this proposal.
 
 ## Specification
+
 The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
 
 ```solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
 
-interface IERC5247SmartProposal {
+interface IERC5247 {
     event ProposalCreated(
-        uint256 proposalId,
-        string proposalUri,
-        uint8[] optionIds,
-        address proposer,
-        address[][] targets,
-        uint256[][] values,
-        string[][] signatures,
-        bytes[][] calldatas,
-        uint256 startBlock,
-        uint256 endBlock
+        address indexed proposer,
+        uint256 indexed proposalId,
+        address[] targets,
+        uint256[] values,
+        uint256[] gasLimits,
+        bytes[] calldatas,
+        bytes extraParams
+    );
+
+    event ProposalExecuted(
+        address indexed executor,
+        uint256 indexed proposalId,
+        bytes extraParams
     );
-    event ProposalExecuted(uint256 proposalId);
-    // TODO: add Proposal Cancel/Edit/Withdraw Event and Functions?
 
-    // TODO: decide whether we require generating ProposalId in the method or not?
-    // TODO: if require generating ProposalId internally, can it be incremental hash-generated?
-    // TODO: what if proposal need to demonstrate sufficient support? How to input quorum?
     function createProposal(
         uint256 proposalId,
-        string calldata proposalUri,
-        uint8[] calldata optionIds,
         address[] calldata targets,
         uint256[] calldata values,
+        uint256[] calldata gasLimits,
         bytes[] calldata calldatas,
-        uint256 startblock,
-        uint256 endblock,
         bytes calldata extraParams
     ) external returns (uint256 registeredProposalId);
 
-    // TODO: what's most proper way to update the voting period?
-    // TODO: do we want to include cancel or withdraw?
-    // TODO: what's the best way to include weight scheme?
+    function executeProposal(uint256 proposalId, bytes calldata extraParams) external;
 }
 ```
 
@@ -71,9 +69,10 @@ interface IERC5247SmartProposal {
 * Arrays were used for `target`s, `value`s, `calldata`s instead of single variables, allowing a proposal to carry arbitrarily long multiple functional calls.
 * `registeredProposalId` is returned in `createProposal` so the standard can support implementation to decide their own format of proposal id.
 
-
 ## Security Considerations
+
 Needs discussion.
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 6fa810162f2d3347288d9269e8a3fdc2fc6a2512 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Thu, 8 Dec 2022 21:48:49 -0800
Subject: [PATCH 024/274] Update EIP-5247 add assets (#6109)

* Update EIP

* Add refimpl
---
 EIPS/eip-5247.md                        |  69 ++++++++++
 assets/eip-5247/ProposalRegistry.sol    |  65 ++++++++++
 assets/eip-5247/testProposalRegistry.ts | 162 ++++++++++++++++++++++++
 3 files changed, 296 insertions(+)
 create mode 100644 assets/eip-5247/ProposalRegistry.sol
 create mode 100644 assets/eip-5247/testProposalRegistry.ts

diff --git a/EIPS/eip-5247.md b/EIPS/eip-5247.md
index 8d2823c9737a4d..bb7779d680fa84 100644
--- a/EIPS/eip-5247.md
+++ b/EIPS/eip-5247.md
@@ -69,6 +69,75 @@ interface IERC5247 {
 * Arrays were used for `target`s, `value`s, `calldata`s instead of single variables, allowing a proposal to carry arbitrarily long multiple functional calls.
 * `registeredProposalId` is returned in `createProposal` so the standard can support implementation to decide their own format of proposal id.
 
+## Test Cases
+
+A simple test case can be found as
+
+```ts
+        it("Should work for a simple case", async function () {
+            const { contract, erc721, owner } = await loadFixture(deployFixture);
+            const callData1 = erc721.interface.encodeFunctionData("mint", [owner.address, 1]);
+            const callData2 = erc721.interface.encodeFunctionData("mint", [owner.address, 2]);
+            await contract.connect(owner)
+                .createProposal(
+                    0,
+                    [erc721.address, erc721.address],
+                    [0,0],
+                    [0,0],
+                    [callData1, callData2],
+                    []);
+            expect(await erc721.balanceOf(owner.address)).to.equal(0);
+            await contract.connect(owner).executeProposal(0, []);
+            expect(await erc721.balanceOf(owner.address)).to.equal(2);
+        });
+```
+
+See [testProposalRegistry.ts](../assets/eip-5247/testProposalRegistry.ts) for the whole testset.
+
+## Reference Implementation
+
+A simple reference implementation can be found.
+
+```solidity
+    function createProposal(
+        uint256 proposalId,
+        address[] calldata targets,
+        uint256[] calldata values,
+        uint256[] calldata gasLimits,
+        bytes[] calldata calldatas,
+        bytes calldata extraParams
+    ) external returns (uint256 registeredProposalId) {
+        require(targets.length == values.length, "GeneralForwarder: targets and values length mismatch");
+        require(targets.length == gasLimits.length, "GeneralForwarder: targets and gasLimits length mismatch");
+        require(targets.length == calldatas.length, "GeneralForwarder: targets and calldatas length mismatch");
+        registeredProposalId = proposalCount;
+        proposalCount++;
+
+        proposals[registeredProposalId] = Proposal({
+            by: msg.sender,
+            proposalId: proposalId,
+            targets: targets,
+            values: values,
+            calldatas: calldatas,
+            gasLimits: gasLimits
+        });
+        emit ProposalCreated(msg.sender, proposalId, targets, values, gasLimits, calldatas, extraParams);
+        return registeredProposalId;
+    }
+    function executeProposal(uint256 proposalId, bytes calldata extraParams) external {
+        Proposal storage proposal = proposals[proposalId];
+        address[] memory targets = proposal.targets;
+        string memory errorMessage = "Governor: call reverted without message";
+        for (uint256 i = 0; i < targets.length; ++i) {
+            (bool success, bytes memory returndata) = proposal.targets[i].call{value: proposal.values[i]}(proposal.calldatas[i]);
+            Address.verifyCallResult(success, returndata, errorMessage);
+        }
+        emit ProposalExecuted(msg.sender, proposalId, extraParams);
+    }
+```
+
+See [ProposalRegistry.sol](../assets/eip-5247/ProposalRegistry.sol) for more information.
+
 ## Security Considerations
 
 Needs discussion.
diff --git a/assets/eip-5247/ProposalRegistry.sol b/assets/eip-5247/ProposalRegistry.sol
new file mode 100644
index 00000000000000..76f56f2c99be98
--- /dev/null
+++ b/assets/eip-5247/ProposalRegistry.sol
@@ -0,0 +1,65 @@
+// SPDX-License-Identifier: MIT
+// A fully runnalbe version can be found in https://github.com/ercref/ercref-contracts/tree/869843f23dc4da793f0d9d018ed92e3950da8f75
+pragma solidity ^0.8.17;
+
+import "./IERC5247.sol";
+import "@openzeppelin/contracts/utils/Address.sol";
+
+struct Proposal {
+    address by;
+    uint256 proposalId;
+    address[] targets;
+    uint256[] values;
+    uint256[] gasLimits;
+    bytes[] calldatas;
+}
+
+contract ProposalRegistry is IERC5247 {
+    using Address for address;
+    mapping(uint256 => Proposal) public proposals;
+    uint256 private proposalCount;
+    function createProposal(
+        uint256 proposalId,
+        address[] calldata targets,
+        uint256[] calldata values,
+        uint256[] calldata gasLimits,
+        bytes[] calldata calldatas,
+        bytes calldata extraParams
+    ) external returns (uint256 registeredProposalId) {
+        require(targets.length == values.length, "GeneralForwarder: targets and values length mismatch");
+        require(targets.length == gasLimits.length, "GeneralForwarder: targets and gasLimits length mismatch");
+        require(targets.length == calldatas.length, "GeneralForwarder: targets and calldatas length mismatch");
+        registeredProposalId = proposalCount;
+        proposalCount++;
+
+        proposals[registeredProposalId] = Proposal({
+            by: msg.sender,
+            proposalId: proposalId,
+            targets: targets,
+            values: values,
+            calldatas: calldatas,
+            gasLimits: gasLimits
+        });
+        emit ProposalCreated(msg.sender, proposalId, targets, values, gasLimits, calldatas, extraParams);
+        return registeredProposalId;
+    }
+    function executeProposal(uint256 proposalId, bytes calldata extraParams) external {
+        Proposal storage proposal = proposals[proposalId];
+        address[] memory targets = proposal.targets;
+        string memory errorMessage = "Governor: call reverted without message";
+        for (uint256 i = 0; i < targets.length; ++i) {
+            (bool success, bytes memory returndata) = proposal.targets[i].call{value: proposal.values[i]}(proposal.calldatas[i]);
+            Address.verifyCallResult(success, returndata, errorMessage);
+        }
+        emit ProposalExecuted(msg.sender, proposalId, extraParams);
+    }
+
+    function getProposal(uint256 proposalId) external view returns (Proposal memory) {
+        return proposals[proposalId];
+    }
+
+    function getProposalCount() external view returns (uint256) {
+        return proposalCount;
+    }
+
+}
diff --git a/assets/eip-5247/testProposalRegistry.ts b/assets/eip-5247/testProposalRegistry.ts
new file mode 100644
index 00000000000000..947c40bebc327b
--- /dev/null
+++ b/assets/eip-5247/testProposalRegistry.ts
@@ -0,0 +1,162 @@
+// A fully runnalbe version can be found in https://github.com/ercref/ercref-contracts/tree/869843f23dc4da793f0d9d018ed92e3950da8f75
+import { loadFixture } from "@nomicfoundation/hardhat-network-helpers";
+import { expect } from "chai";
+import { hexlify } from "ethers/lib/utils";
+import { ethers } from "hardhat";
+
+describe("ProposalRegistry", function () {
+    async function deployFixture() {
+        // Contracts are deployed using the first signer/account by default
+        const [owner, otherAccount] = await ethers.getSigners();
+
+        const ProposalRegistry = await ethers.getContractFactory("ProposalRegistry");
+        const contract = await ProposalRegistry.deploy();
+
+        const ERC721ForTesting = await ethers.getContractFactory("ERC721ForTesting");
+        const erc721 = await ERC721ForTesting.deploy();
+
+        const SimpleForwarder = await ethers.getContractFactory("SimpleForwarder");
+        const forwarder = await SimpleForwarder.deploy();
+        return { contract, erc721, forwarder, owner, otherAccount };
+    }
+
+    describe("Deployment", function () {
+        it("Should work for a simple case", async function () {
+            const { contract, erc721, owner } = await loadFixture(deployFixture);
+            const callData1 = erc721.interface.encodeFunctionData("mint", [owner.address, 1]);
+            const callData2 = erc721.interface.encodeFunctionData("mint", [owner.address, 2]);
+            await contract.connect(owner)
+                .createProposal(
+                    0,
+                    [erc721.address, erc721.address],
+                    [0,0],
+                    [0,0],
+                    [callData1, callData2],
+                    []);
+            expect(await erc721.balanceOf(owner.address)).to.equal(0);
+            await contract.connect(owner).executeProposal(0, []);
+            expect(await erc721.balanceOf(owner.address)).to.equal(2);
+        });
+        const Ns = [0, 50, 100, 150, 200];
+        for (let n of Ns) {
+
+            it(`Should work for a proposal case of ${n}`, async function () {
+                const { contract, erc721, owner } = await loadFixture(deployFixture);
+                const numOfMint = n;
+                const calldatas = [];
+                for (let i = 0 ; i < numOfMint; i++) {
+                    const callData = erc721.interface.encodeFunctionData("mint", [owner.address, i]);
+                    calldatas.push(callData);
+                }
+                let txCreate = await contract.connect(owner)
+                    .createProposal(
+                        0,
+                        Array(numOfMint).fill(erc721.address),
+                        Array(numOfMint).fill(0),
+                        Array(numOfMint).fill(0),
+                        calldatas,
+                        []);
+                let txCreateWaited = await txCreate.wait();
+                console.log(`Creation TX gas`, txCreateWaited.cumulativeGasUsed.toString());
+                console.log(`Gas per mint`, parseInt(txCreateWaited.cumulativeGasUsed.toString()) / numOfMint);
+                expect(await erc721.balanceOf(owner.address)).to.equal(0);
+                let txExecute = await contract.connect(owner).executeProposal(0, []);
+                let txExecuteWaited = await txExecute.wait();
+                console.log(`Execution TX gas`, txExecuteWaited.cumulativeGasUsed.toString());
+                console.log(`Gas per mint`, parseInt(txExecuteWaited.cumulativeGasUsed.toString()) / numOfMint);
+                expect(await erc721.balanceOf(owner.address)).to.equal(numOfMint);
+            });
+        }
+    });
+    describe("Benchmark", function () {
+        it(`Should work for a forwarding case`, async function () {
+            const { forwarder, erc721, owner } = await loadFixture(deployFixture);
+            const numOfMint = 200;
+            const calldatas = [];
+            for (let i = 0 ; i < numOfMint; i++) {
+                const callData = erc721.interface.encodeFunctionData("mint", [owner.address, i]);
+                calldatas.push(callData);
+            }
+            expect(await erc721.balanceOf(owner.address)).to.equal(0);
+            let txForward = await forwarder.connect(owner)
+                .forward(
+                    Array(numOfMint).fill(erc721.address),
+                    Array(numOfMint).fill(0),
+                    Array(numOfMint).fill(0),
+                    calldatas);
+            let txForwardWaited = await txForward.wait();
+
+            console.log(`txForwardWaited TX gas`, txForwardWaited.cumulativeGasUsed.toString());
+
+            console.log(`Gas per mint`, parseInt(txForwardWaited.cumulativeGasUsed.toString()) / numOfMint);
+            expect(await erc721.balanceOf(owner.address)).to.equal(numOfMint);
+
+        });
+
+
+        it(`Should work for erc721 batchMint with same addresses`, async function () {
+            const { erc721, owner } = await loadFixture(deployFixture);
+            const numOfMint = 200;
+            const tokenIds = [];
+            const addresses = [];
+
+            for (let i = 0 ; i < numOfMint; i++) {
+                addresses.push(owner.address);// addresses.push(hexlify(ethers.utils.randomBytes(20)));
+                tokenIds.push(i);
+            }
+            const tx = await erc721.connect(owner).batchMint(addresses, tokenIds);
+            const txWaited = await tx.wait();
+            console.log(`batchMint TX gas`, txWaited.cumulativeGasUsed.toString());
+            console.log(`At ${numOfMint} Gas per mint`, parseInt(txWaited.cumulativeGasUsed.toString()) / numOfMint);
+        })
+
+        it(`Should work for erc721 batchMint with different addresses`, async function () {
+            const { erc721, owner } = await loadFixture(deployFixture);
+            const numOfMint = 200;
+            const tokenIds = [];
+            const addresses = [];
+
+            for (let i = 0 ; i < numOfMint; i++) {
+                addresses.push(hexlify(ethers.utils.randomBytes(20)));
+                tokenIds.push(i);
+            }
+            const tx = await erc721.connect(owner).batchMint(addresses, tokenIds);
+            const txWaited = await tx.wait();
+            console.log(`batchMint TX gas`, txWaited.cumulativeGasUsed.toString());
+            console.log(`At ${numOfMint} Gas per mint`, parseInt(txWaited.cumulativeGasUsed.toString()) / numOfMint);
+        });
+
+
+        it(`Should work for erc721 batchSafeMint with same addresses`, async function () {
+            const { erc721, owner } = await loadFixture(deployFixture);
+            const numOfMint = 400;
+            const tokenIds = [];
+            const addresses = [];
+
+            for (let i = 0 ; i < numOfMint; i++) {
+                addresses.push(owner.address);// addresses.push(hexlify(ethers.utils.randomBytes(20)));
+                tokenIds.push(i);
+            }
+            const tx = await erc721.connect(owner).batchSafeMint(addresses, tokenIds);
+            const txWaited = await tx.wait();
+            console.log(`batchSafeMint TX gas`, txWaited.cumulativeGasUsed.toString());
+            console.log(`At ${numOfMint} Gas per mint`, parseInt(txWaited.cumulativeGasUsed.toString()) / numOfMint);
+        });
+
+        it(`Should work for erc721 batchSafeMint with different addresses`, async function () {
+            const { erc721, owner } = await loadFixture(deployFixture);
+            const numOfMint = 400;
+            const tokenIds = [];
+            const addresses = [];
+
+            for (let i = 0 ; i < numOfMint; i++) {
+                addresses.push(hexlify(ethers.utils.randomBytes(20)));
+                tokenIds.push(i);
+            }
+            const tx = await erc721.connect(owner).batchSafeMint(addresses, tokenIds);
+            const txWaited = await tx.wait();
+            console.log(`batchSafeMint TX gas`, txWaited.cumulativeGasUsed.toString());
+            console.log(`At ${numOfMint} the Gas per mint`, parseInt(txWaited.cumulativeGasUsed.toString()) / numOfMint);
+        });
+    });
+});

From 2d2e28b8bacd2b069897b38183a05a0dc6223441 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 10 Dec 2022 16:17:55 -0800
Subject: [PATCH 025/274] (bot 1272989785) moving EIPS/eip-3651.md to stagnant
 (#6009)

PR 6009 with changes to EIPS/eip-3651.md was created on
	(2022-Nov-20th@00.20.18)
which is before the cutoff date of
	(2022-Nov-27th@00.17.53)
i.e. 2 weeks ago
---
 EIPS/eip-3651.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-3651.md b/EIPS/eip-3651.md
index 8d64ad9e1f6892..96688016921f23 100644
--- a/EIPS/eip-3651.md
+++ b/EIPS/eip-3651.md
@@ -4,7 +4,7 @@ title: Warm COINBASE
 description: Starts the `COINBASE` address warm
 author: William Morriss (@wjmelements)
 discussions-to: https://ethereum-magicians.org/t/eip-3651-warm-coinbase/6640
-status: Review
+status: Stagnant
 type: Standards Track
 category: Core
 created: 2021-07-12

From 7080e182175d16ba2e429cccef74368d87e3a99d Mon Sep 17 00:00:00 2001
From: frenchkebab <36957058+Frenchkebab@users.noreply.github.com>
Date: Tue, 13 Dec 2022 04:00:00 +0900
Subject: [PATCH 026/274] Update eip-1822.md (#6118)

Fixes typo: contact -> contract
---
 EIPS/eip-1822.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-1822.md b/EIPS/eip-1822.md
index 590bd3ae622df3..9289266297ba7a 100644
--- a/EIPS/eip-1822.md
+++ b/EIPS/eip-1822.md
@@ -306,7 +306,7 @@ contract LibraryLock is LibraryLockDataLayout {
     }
 }
 
-contact ERC20DataLayout is LibraryLockDataLayout {
+contract ERC20DataLayout is LibraryLockDataLayout {
   uint256 public totalSupply;
   mapping(address=>uint256) public tokens;
 }

From 767cd4189c1ca8d17ec6e72d0d24ba249d2b7784 Mon Sep 17 00:00:00 2001
From: ashhanai <ashhab.naim@gmail.com>
Date: Tue, 13 Dec 2022 01:50:16 +0000
Subject: [PATCH 027/274] Update EIP-5646: Move to Last Call (#6097)

* Add EIP-5646: Token state fingerprint

* Update EIP-5646: add link to discussion

* Update EIP-5646: reference ERC standards as EIP-N

* Update EIP-5646: update all EIP references to links

* Update EIP-5646: fix incorrect EIP references

* Update EIP-5646: Rework the structure of the whole draft

* Update EIP-5646: Move to Last Call
---
 EIPS/eip-5646.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-5646.md b/EIPS/eip-5646.md
index 90aee881188ccd..d7696e0424d204 100644
--- a/EIPS/eip-5646.md
+++ b/EIPS/eip-5646.md
@@ -4,7 +4,8 @@ title: Token State Fingerprint
 description: Unambiguous token state identifier
 author: Naim Ashhab (@ashhanai)
 discussions-to: https://ethereum-magicians.org/t/eip-5646-discussion-token-state-fingerprint/10808
-status: Review
+status: Last Call
+last-call-deadline: 2022-12-21
 type: Standards Track
 category: ERC
 created: 2022-09-11

From d05f436944b6371a20a613d3f723e74c37f001b4 Mon Sep 17 00:00:00 2001
From: Javier Arcenegui Almenara
 <81355285+Hardblock-IMSE-CNM@users.noreply.github.com>
Date: Tue, 13 Dec 2022 16:38:17 +0100
Subject: [PATCH 028/274] Update EIP-4519: Move to Final (#6076)

* Update eip-4519.md

* Update eip-4519.md

* Update eip-4519.md

* Update EIPS/eip-4519.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-4519.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-4519.md | 24 ++++++++++++------------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/EIPS/eip-4519.md b/EIPS/eip-4519.md
index f12a3a2ece8c29..5382f517ffa547 100644
--- a/EIPS/eip-4519.md
+++ b/EIPS/eip-4519.md
@@ -36,33 +36,33 @@ Finally, if both the attributes `addressAsset` and `addressUser` are defined, th
  
 In order to complete the ownership transfer of a token, the new owner must carry out a mutual authentication process with the asset, which is off-chain with the asset and on-chain with the token, by using their Ethereum addresses. Similarly, a new user must carry out a mutual authentication process with the asset to complete a use transfer. NFTs define how the authentication processes start and finish. These authentication processes allow deriving fresh session cryptographic keys for secure communication between assets and owners, and between assets and users. Therefore, the trustworthiness of the assets can be traced even if new owners and users manage them.
 
-When the NFT is created or when the ownership is transferred, the token state is `waitingForOwner`. The asset sets its operating mode to `waitingForOwner`. The owner generates a pair of keys using the elliptic curve secp256k1 and the primitive element P used on this curve: a secret key $SK_{O_{-}A}$ and a Public Key $PK_{O_{-}A}$, so that $PK_{O_{-}A} = SK_{O_{-}A} * P$. To generate the shared key between the owner and the asset, $K_O$, the public key of the asset, $PK_A$, is employed as follows:
+When the NFT is created or when the ownership is transferred, the token state is `waitingForOwner`. The asset sets its operating mode to `waitingForOwner`. The owner generates a pair of keys using the elliptic curve secp256k1 and the primitive element P used on this curve: a secret key SK<sub>O_A</sub> and a Public Key PK<sub>O_A</sub>, so that PK<sub>O_A</sub> = SK<sub>O_A</sub> * P. To generate the shared key between the owner and the asset, K<sub>O</sub>, the public key of the asset, PK<sub>A</sub>, is employed as follows:
 
-$$K_O = PK_A*SK_{O_{-}A}$$
+K<sub>O</sub> = PK<sub>A</sub> * SK<sub>O_A</sub>
 
-Using the function `startOwnerEngagement`, $PK_{O_{-}A}$ is saved as the attribute `dataEngagement` and the hash of $K_O$ as the attribute `hashK_OA`. The owner sends request engagement to the asset, and the asset calculates:
+Using the function `startOwnerEngagement`, PK<sub>O_A</sub> is saved as the attribute `dataEngagement` and the hash of K<sub>O</sub> as the attribute `hashK_OA`. The owner sends request engagement to the asset, and the asset calculates:
 
-$$K_A = SK_A*PK_{O_{-}A}$$
+K<sub>A</sub> = SK<sub>A</sub> * PK<sub>O_A</sub>
 
-If everything is correctly done, $K_O$ and $K_A$ are the same since:
+If everything is correctly done, K<sub>O</sub> and K<sub>A</sub> are the same since:
 
-$$K_O=PK_A\*SK_{O_{-}A}=(SK_A\*P)\*SK_{O_{-}A}= SK_A\*(SK_{O_{-}A}\*P)=SK_A\*PK_{O_{-}A}$$
+K<sub>O</sub> = PK<sub>A</sub> * SK<sub>O_A</sub> = (SK<sub>A</sub> * P) * SK<sub>O_A</sub> = SK<sub>A</sub> * (SK<sub>O_A</sub> * P) = SK<sub>A</sub> * PK<sub>O_A</sub>
 
-Using the function `ownerEngagement`, the asset sends the hash of $K_A$, and if it is the same as the data in `hashK_OA`, then the state of the token changes to `engagedWithOwner` and the event `OwnerEngaged` are sent. Once the asset receives the event, it changes its operation mode to `engagedWithOwner`. This process is shown in `Figure 4`. From this moment, the asset can be managed by the owner and they can communicate in a secure way using the shared key. 
+Using the function `ownerEngagement`, the asset sends the hash of K<sub>A</sub>, and if it is the same as the data in `hashK_OA`, then the state of the token changes to `engagedWithOwner` and the event `OwnerEngaged` are sent. Once the asset receives the event, it changes its operation mode to `engagedWithOwner`. This process is shown in `Figure 4`. From this moment, the asset can be managed by the owner and they can communicate in a secure way using the shared key. 
 
  ![Figure 4: Steps in a successful owner and asset mutual authentication process](../assets/eip-4519/images/Figure4.jpg)
 
-If the asset consults Ethereum and the state of its NFT is `waitingForUser`, the asset (assuming it is an electronic physical asset) sets its operating mode to `waitingForUser`. Then, a mutual authentication process is carried out with the user, as already done with the owner. The user sends the transaction associated with the function `startUserEngagement`. As in `startOwnerEngagement`, this function saves the public key generated by the user, $PK_{U_{-}A}$, as the attribute `dataEngagement` and the hash of $K_U = PK_A * SK_{U_{-}A}$ as the attribute `hashK_UA` in the NFT.
+If the asset consults Ethereum and the state of its NFT is `waitingForUser`, the asset (assuming it is an electronic physical asset) sets its operating mode to `waitingForUser`. Then, a mutual authentication process is carried out with the user, as already done with the owner. The user sends the transaction associated with the function `startUserEngagement`. As in `startOwnerEngagement`, this function saves the public key generated by the user, PK<sub>U_A</sub>, as the attribute `dataEngagement` and the hash of K<sub>U</sub> = PK<sub>A</sub> * SK<sub>U_A</sub> as the attribute `hashK_UA` in the NFT.
 
 The user sends request engagement and the asset calculates:
 
-$$K_A = SK_A*PK_{U_{-}A}$$
+K<sub>A</sub> = SK<sub>A</sub>*PK<sub>U_A</sub>
 
-If everything is correctly done, $K_U$ and $K_A$ are the same since:
+If everything is correctly done, K<sub>U</sub> and K<sub>A</sub> are the same since:
 
-$$K_U=PK_A\*SK_{U_{-}A}=(SK_A\*P)\*SK_{U_{-}A}= SK_A\*(SK_{U_{-}A}\*P)=SK_A\*PK_{U_{-}A}$$
+K<sub>U</sub> = PK<sub>A</sub> * SK<sub>U_A</sub> = (SK<sub>A</sub> * P) * SK<sub>U_A</sub> = SK<sub>A</sub> * (SK<sub>U_A</sub> * P) = SK<sub>A</sub> * PK<sub>U_A</sub>
 
-Using the function `userEngagement`, the asset sends the hash of $K_A$ obtained and if it is the same as the data in `hashK_UA`, then the state of the token changes to `engagedWithUser` and the event `UserEngaged` is sent. Once the asset receives the event, it changes its operation mode to `engagedWithUser`. This process is shown in `Figure 5`. From this moment, the asset can be managed by the user and they can communicate in a secure way using the shared key. 
+Using the function `userEngagement`, the asset sends the hash of K<sub>A</sub> obtained and if it is the same as the data in `hashK_UA`, then the state of the token changes to `engagedWithUser` and the event `UserEngaged` is sent. Once the asset receives the event, it changes its operation mode to `engagedWithUser`. This process is shown in `Figure 5`. From this moment, the asset can be managed by the user and they can communicate in a secure way using the shared key. 
 
  ![Figure 5: Steps in a successful user and asset mutual authentication process](../assets/eip-4519/images/Figure5.jpg)
 

From 92f437ec43b5578c946b24561e46e762757d27e7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <pawel@hepcolgum.band>
Date: Tue, 13 Dec 2022 17:24:14 +0100
Subject: [PATCH 029/274] EIP-4750: Fix formatting (#6125)

---
 EIPS/eip-4750.md | 30 +++++++++++++++---------------
 1 file changed, 15 insertions(+), 15 deletions(-)

diff --git a/EIPS/eip-4750.md b/EIPS/eip-4750.md
index 3ca0e8bf541af8..2da4893dbd9947 100644
--- a/EIPS/eip-4750.md
+++ b/EIPS/eip-4750.md
@@ -17,13 +17,13 @@ Introduce the ability to have several code sections in EOF-formatted ([EIP-3540]
 
 ## Motivation
 
-Currently in the EVM everything is a dynamic jump. Languages like Solidity generate most jumps in a static manner (i.e. the destination is pushed to the stack right before, `PUSHn .. JUMP`). Unfortunately however this cannot be used by most EVM interpreters, because of added requirement of validation/analysis. This also restricts them from making optimisations and potentially reducing the cost of jumps.
+Currently, in the EVM everything is a dynamic jump. Languages like Solidity generate most jumps in a static manner (i.e. the destination is pushed to the stack right before, `PUSHn .. JUMP`). Unfortunately however this cannot be used by most EVM interpreters, because of added requirement of validation/analysis. This also restricts them from making optimisations and potentially reducing the cost of jumps.
 
 [EIP-4200](./eip-4200.md) introduces static jump instructions, which remove the need for *most* dynamic jump use cases, but not everything can be solved with them.
 
 This EIP aims to remove the need and disallow dynamic jumps as it offers the most important feature those are used for: calling into and returning from functions.
 
-Furthermore it aims to improve analysis opportunities by encoding the number of inputs and outputs for each given function, and isolating the stack of each function (i.e. a function cannot read the stack of the caller/callee).
+Furthermore, it aims to improve analysis opportunities by encoding the number of inputs and outputs for each given function, and isolating the stack of each function (i.e. a function cannot read the stack of the caller/callee).
 
 ## Specification
 
@@ -36,7 +36,7 @@ Furthermore it aims to improve analysis opportunities by encoding the number of
 5. Exactly one type section MAY be present.
 6. The type section, if present, MUST directly precede all code sections.
 7. The type section, if present, contains a sequence of pairs of bytes: first byte in a pair encodes number of inputs, and second byte encodes number of outputs of the code section with the same index. *Note:* This implies that there is a limit of 256 stack for the input and in the output.
-8. Therefore type section size MUST be `n * 2` bytes, where `n` is the number of code sections.
+8. Therefore, type section size MUST be `n * 2` bytes, where `n` is the number of code sections.
 9. First code section MUST have 0 inputs and 0 outputs.
 10. Type section MAY be omitted if only a single code.
 section is present. In that case it implicitly defines 0 inputs and 0 outputs for this code section.
@@ -66,7 +66,7 @@ We introduce three new instructions:
 
 1. `CALLF` (`0xb0`) - call a function
 2. `RETF` (`0xb1`) - return from a function
-2. `JUMPF` (`0xb2`) - jump to a function (without updating return stack)
+3. `JUMPF` (`0xb2`) - jump to a function (without updating return stack)
 
 If the code is legacy bytecode, any of these instructions results in an *exceptional halt*. (*Note: This means no change to behaviour.*)
 
@@ -88,17 +88,17 @@ If the code is valid EOF1, the following execution rules apply:
 6. Pops nothing and pushes nothing to data stack.
 7. Pushes to return stack an item:
 
-```
-(code_section_index = current_section_index, 
-offset = PC_post_instruction,
-stack_height = data_stack.height - types[code_section_index].inputs)
-```
-
-Under `PC_post_instruction` we mean the PC position after the entire immediate argument of `CALLF`. Data stack height is saved as it was before function inputs were pushed.
-
-*Note:* Code validation rules of [EIP-3670](./eip-3670.md) guarantee there is always an instruction following `CALLF` (since terminating instruction is required to be final one in the section), therefore `PC_post_instruction` always points to an instruction inside section bounds.
-
-7. Sets `current_section_index` to `code_section_index` and `PC` to `0`, and execution continues in the called section.
+   ```
+   (code_section_index = current_section_index, 
+   offset = PC_post_instruction,
+   stack_height = data_stack.height - types[code_section_index].inputs)
+   ```
+   
+   Under `PC_post_instruction` we mean the PC position after the entire immediate argument of `CALLF`. Data stack height is saved as it was before function inputs were pushed.
+   
+   *Note:* Code validation rules of [EIP-3670](./eip-3670.md) guarantee there is always an instruction following `CALLF` (since terminating instruction is required to be final one in the section), therefore `PC_post_instruction` always points to an instruction inside section bounds.
+   
+8. Sets `current_section_index` to `code_section_index` and `PC` to `0`, and execution continues in the called section.
 
 #### `JUMPF`
 

From 4439d0ed095c8b3dd0942e3f71865673a37f96b4 Mon Sep 17 00:00:00 2001
From: Javier Arcenegui Almenara
 <81355285+Hardblock-IMSE-CNM@users.noreply.github.com>
Date: Tue, 13 Dec 2022 17:27:40 +0100
Subject: [PATCH 030/274] Update EIP-4519: Move to Final (#6124)

* Update eip-4519.md

* Update eip-4519.md

* Update eip-4519.md

* Update EIPS/eip-4519.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-4519.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update eip-4519.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-4519.md | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-4519.md b/EIPS/eip-4519.md
index 5382f517ffa547..b1743323f289e4 100644
--- a/EIPS/eip-4519.md
+++ b/EIPS/eip-4519.md
@@ -4,8 +4,7 @@ title: Non-Fungible Tokens Tied to Physical Assets
 description: Interface for non-fungible tokens representing physical assets that can generate or recover their own accounts and obey users.
 author: Javier Arcenegui (@Hardblock-IMSE-CNM), Rosario Arjona (@RosarioArjona), Roberto Román <roman@imse-cnm.csic.es>, Iluminada Baturone (@lumi2018)
 discussions-to: https://ethereum-magicians.org/t/new-proposal-of-smart-non-fungible-token/7677
-status: Last Call
-last-call-deadline: 2022-11-30
+status: Final
 type: Standards Track
 category: ERC
 created: 2021-12-03
@@ -56,7 +55,7 @@ If the asset consults Ethereum and the state of its NFT is `waitingForUser`, the
 
 The user sends request engagement and the asset calculates:
 
-K<sub>A</sub> = SK<sub>A</sub>*PK<sub>U_A</sub>
+K<sub>A</sub> = SK<sub>A</sub> * PK<sub>U_A</sub>
 
 If everything is correctly done, K<sub>U</sub> and K<sub>A</sub> are the same since:
 

From ce8e5d1cd4de1acee546250fafa9d18cb038e98e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <pawel@hepcolgum.band>
Date: Tue, 13 Dec 2022 17:28:50 +0100
Subject: [PATCH 031/274] EIP-4200: Do not suggest PC is deprecated (#6111)

---
 EIPS/eip-4200.md | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/EIPS/eip-4200.md b/EIPS/eip-4200.md
index 23080249f36671..c6a311a0ee071d 100644
--- a/EIPS/eip-4200.md
+++ b/EIPS/eip-4200.md
@@ -61,11 +61,9 @@ Because the destinations are validated upfront, the cost of these instructions a
 
 ### Relative addressing
 
-We chose relative addressing in order to support code which is moveable. This also means it can be injected. A technique seen used prior to this EIP to achieve this same goal was to inject code like `PUSHn PC ADD JUMPI`.
+We chose relative addressing in order to support code which is relocatable. This also means a code snippet can be injected. A technique seen used prior to this EIP to achieve the same goal was to inject code like `PUSHn PC ADD JUMPI`.
 
-We do not see any significant downside to relative addressing, but it also allows the deprecation of the `PC` instruction.
-
-*Note: EIP-3670 should reject `PC`.*
+We do not see any significant downside to relative addressing, but it also opens possibility to the deprecation of the `PC` instruction.
 
 ### Immediate size
 

From b4db14cf02d820f7bf417d2d1d0043573106d4d4 Mon Sep 17 00:00:00 2001
From: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
Date: Tue, 13 Dec 2022 12:00:08 -0500
Subject: [PATCH 032/274] Pickup latest eipw version (#6091)

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 00b9a8247d6756..1f4985a0b19856 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -99,7 +99,7 @@ jobs:
       - name: Checkout EIP Repository
         uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b
 
-      - uses: ethereum/eipw-action@d57d2afb71253fc7447d8a7a28d60f9dead2290b
+      - uses: ethereum/eipw-action@859c779fd8ee3ae73f8b1aa9b69d87ea621074fe
         id: eipw
         with:
           token: ${{ secrets.GITHUB_TOKEN }}

From 71b3a7d7ff79aa7c3eb9f3b53e27fed0c17dc986 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ernesto=20Garc=C3=ADa?= <ernestognw@gmail.com>
Date: Tue, 13 Dec 2022 13:27:36 -0500
Subject: [PATCH 033/274] Add EIP-6093: Custom errors for commonly-used tokens
 (#6093)

* EIP- : Custom errors for ERC tokens

* Update EIP number, discussion and created

* Added EIP number to file name

* Update EIPS/eip-6093.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6093.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6093.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6093.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6093.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6093.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6093.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6093.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6093.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Added `commonly-used` term

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-6093.md | 371 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 371 insertions(+)
 create mode 100644 EIPS/eip-6093.md

diff --git a/EIPS/eip-6093.md b/EIPS/eip-6093.md
new file mode 100644
index 00000000000000..2f85e9aeb7858f
--- /dev/null
+++ b/EIPS/eip-6093.md
@@ -0,0 +1,371 @@
+---
+eip: 6093
+title: Custom errors for commonly-used tokens
+description: Lists custom errors for common token implementations
+author: Ernesto García (@ernestognw), Francisco Giordano (@frangio), Hadrien Croubois (@Amxx)
+discussions-to: https://ethereum-magicians.org/t/eip-6093-custom-errors-for-erc-tokens/12043
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-12-06
+requires: 20, 721, 1155
+---
+
+## Abstract
+
+This EIP defines a standard set of custom errors for commonly-used tokens, which are defined as [EIP-20](./eip-20.md), [EIP-721](./eip-721.md), and [EIP-1155](./eip-1155.md) tokens.
+
+Ethereum applications and wallets have historically relied on revert reason strings to display the cause of transaction errors to users. More recent Solidity versions offer rich revert reasons with error-specific decoding (sometimes referred to as "custom errors"). This EIP defines a standard set of errors designed to give at least the same relevant information as revert reason strings, but in a structured and expected way that clients can implement decoding for.
+
+## Motivation
+
+Since the introduction of Solidity custom errors in v0.8.4, these have provided a way to show failures in a more expresive and gas efficient manner with dynamic arguments, while reducing deployment costs.
+
+However, [EIP-20](./eip-20.md), [EIP-721](./eip-721.md), [EIP-1155](./eip-1155.md) were already finalized when custom errors were released, so no errors are included in their specification.
+
+Standardized errors allow users to expect more consistent error messages across applications or testing environments, while exposing pertinent arguments and overall reducing the need of writing expensive revert strings in the deployment bytecode.
+
+## Specification
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+The following errors were designed according to the criteria described in [Rationale](#rationale).
+
+This EIP defines standard errors that may be used by implementations in certain scenarios, but does not specify whether implementations should revert in those scenarios, which remains up to the implementers, unless a revert is mandated by the corresponding EIPs.
+
+The names of the error arguments are defined in the [Parameter Glossary](#parameter-glossary), and MUST be used according to those definitions.
+
+### [EIP-20](./eip-20.md)
+
+#### `ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed)`
+
+Indicates an error related to the current `balance` of a `sender`.
+Used in transfers.
+
+- MUST be used when `balance` is less than `needed`.
+- MUST NOT be used if `balance` is equal or greater than `needed`.
+
+#### `ERC20InvalidSender(address sender)`
+
+Indicates a failure with the token `sender`.
+Used in transfers.
+
+- MUST be used for disallowed transfers from the zero address.
+- MUST NOT be used for approval operations.
+- MUST NOT be used for balance or allowance requirements.
+  - Use `ERC20InsufficientBalance` or `ERC20InsufficientAllowance` instead.
+
+#### `ERC20InvalidReceiver(address receiver)`
+
+Indicates a failure with the token `receiver`.
+Used in transfers.
+
+- MUST be used for disallowed transfers to the zero address.
+- MUST be used for disallowed transfers to non-compatible addresses (eg. contract addresses).
+- MUST NOT be used for approval operations.
+
+#### `ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed)`
+
+Indicates a failure with the `spender`'s `allowance`.
+Used in transfers.
+
+- MUST be used when `allowance` is less than `needed`.
+- MUST NOT be used if `allowance` is equal or greater than `needed`.
+
+#### `ERC20InvalidApprover(address approver)`
+
+Indicates a failure with the `approver` of a token to be approved.
+Used in approvals.
+
+- MUST be used for disallowed approvals from the zero address.
+- MUST NOT be used for transfer operations.
+
+#### `ERC20InvalidSpender(address spender)`
+
+Indicates a failure with the `spender` to be approved.
+Used in approvals.
+
+- MUST be used for disallowed approvals to the zero address.
+- MUST be used for disallowed approvals to the owner itself.
+- MUST NOT be used for transfer operations.
+  - Use `ERC20InsufficientAllowance` instead.
+
+### [EIP-721](./eip-721.md)
+
+#### `ERC721InvalidOwner(address sender, uint256 tokenId, address owner)`
+
+Indicates an error related to the ownership over a particular token.
+Used in transfers.
+
+- MUST be used when `sender` is not `owner`.
+- MUST NOT be used for approval operations.
+
+#### `ERC721InvalidSender(address sender)`
+
+Indicates a failure with the token sender.
+Used in transfers.
+
+- MUST be used for disallowed transfers from the zero address.
+- MUST NOT be used for approval operations.
+- MUST NOT be used for ownership or approval requirements.
+  - Use `ERC721InvalidOwner` or `ERC721InsufficientApproval` instead.
+
+#### `ERC721InvalidReceiver(address receiver)`
+
+Indicates a failure with the token receiver.
+Used in transfers.
+
+- MUST be used for disallowed transfers to the zero address.
+- MUST be used for disallowed transfers to non-`ERC721TokenReceiver` contracts or those that reject a transfer. (eg. returning an invalid response in `onERC721Received`).
+- MUST NOT be used for approval operations.
+
+#### `ERC721InsufficientApproval(address operator, uint256 tokenId)`
+
+Indicates a failure with the `operator`'s approval.
+Used in transfers.
+
+- MUST be used when operator `isApprovedForAll(owner, operator)` is false.
+- MUST be used when operator `getApproved(tokenId)` is not `operator`.
+
+#### `ERC721InvalidApprover(address approver)`
+
+Indicates a failure with the `owner` of a token to be approved.
+Used in approvals.
+
+- MUST be used for disallowed approvals from the zero address.
+- MUST NOT be used for transfer operations.
+
+#### `ERC721InvalidOperator(address operator)`
+
+Indicates a failure with the `operator` to be approved.
+Used in approvals.
+
+- MUST be used for disallowed approvals to the zero address.
+- MUST be used for disallowed approvals to the owner itself.
+- MUST NOT be used for transfer operations.
+  - Use `ERC721InsufficientApproval` instead.
+
+### [EIP-1155](./eip-1155.md)
+
+#### `ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId)`
+
+Indicates an error related to the current `balance` of a sender.
+Used in transfers.
+
+- MUST be used when `balance` is less than `needed` for a `tokenId`.
+- MUST NOT be used if `balance` is equal or greater than `needed` for an `tokenId`.
+
+#### `ERC1155InvalidSender(address sender)`
+
+Indicates a failure with the token sender.
+Used in transfers.
+
+- MUST be used for disallowed transfers from the zero address.
+- MUST NOT be used for approval operations.
+- MUST NOT be used for balance or allowance requirements.
+  - Use `ERC1155InsufficientBalance` or `ERC1155InsufficientApproval` instead.
+
+#### `ERC1155InvalidReceiver(address receiver)`
+
+Indicates a failure with the token receiver.
+Used in transfers.
+
+- MUST be used for disallowed transfers to the zero address.
+- MUST be used for disallowed transfers to non-`ERC1155TokenReceiver` contracts or those that reject a transfer. (eg. returning an invalid response in `onERC1155Received`).
+- MUST NOT be used for approval operations.
+
+#### `ERC1155InsufficientApproval(address operator, uint256 tokenId)`
+
+Indicates a failure with the `operator`'s approval in a transfer.
+Used in transfers.
+
+- MUST be used when operator `isApprovedForAll(owner, operator, tokenId)` is false.
+
+#### `ERC1155InvalidApprover(address approver)`
+
+Indicates a failure with the `approver` of a token to be approved.
+Used in approvals.
+
+- MUST be used for disallowed approvals from the zero address.
+- MUST NOT be used for transfer operations.
+
+#### `ERC1155InvalidOperator(address operator)`
+
+Indicates a failure with the `operator` to be approved.
+Used in approvals.
+
+- MUST be used for disallowed approvals to the zero address.
+- MUST be used for disallowed approvals to the owner itself.
+- MUST NOT be used for transfer operations.
+  - Use `ERC1155InsufficientApproval` instead.
+
+#### `ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength)`
+
+Indicates an array length mismatch between `ids` and `values` in a `safeBatchTransferFrom` operation.
+Used in batch transfers.
+
+- MUST be used only if `idsLength` is different to `valuesLength`
+
+### Parameter Glossary
+
+| Name        | Description                                                                 |
+| ----------- | --------------------------------------------------------------------------- |
+| `sender`    | Address whose tokens are being transferred.                                 |
+| `balance`   | Current balance for the interacting account.                                |
+| `needed`    | Minimum amount required to perform an action.                               |
+| `receiver`  | Address to which tokens are being transferred.                              |
+| `spender`   | Address that may be allowed to operate on tokens without being their owner. |
+| `allowance` | Amount of tokens a `spender` is allowed to operate with.                    |
+| `approver`  | Address initiating an approval operation.                                   |
+| `tokenId`   | Identifier number of a token.                                               |
+| `owner`     | Address of the current owner of a token.                                    |
+| `operator`  | Same as `spender`.                                                          |
+| `*Length`   | Array length for the prefixed parameter.                                    |
+
+### Error additions
+
+Any addition to this EIP or implementation-specific errors (such as extensions) SHOULD follow the guidelines presented in the [rationale](#rationale) section to keep consistency.
+
+## Rationale
+
+The chosen objectives for a standard for token errors are to provide context about the error, and to make moderate use of meaningful arguments (to maintain the code size benefits with respect to strings).
+
+Considering this, the error names are designed following a basic grammatical structure based on the standard actions that can be performed on each token and the [subjects](#actions-and-subjects) involved.
+
+### Actions and subjects
+
+The main actions that can be performed within a token are:
+
+- **Transfer**: An operation in which a _sender_ moves to a _receiver_ any number of tokens (fungible _balance_ and/or non-fungible _token ids_).
+- **Approval**: An operation in which an _approver_ grants any form of _approval_ to an _operator_.
+
+The subjects outlined above are expected to exhaustively represent _what_ can go wrong in a token transaction, deriving a specific error by adding an [error prefix](#error-prefixes).
+
+Note that the action is never seen as the subject of an error. Additionally the token itself is not seen as the subject of an error but rather the context in which it happens, as identified in the domain.
+
+If a subject is called different on a particular token standard, the error should be consistent with the standard's naming convention.
+
+### Error prefixes
+
+An error prefix is added to a subject to derive a concrete error condition.
+Developers can think about an error prefix as the _why_ an error happened.
+
+A prefix can be `Invalid` for general incorrectness, or more specific like `Insufficient` for amounts.
+
+### Domain
+
+Each error's arguments may vary depending on the token domain. If there are errors with the same name and different arguments, the Solidity compiler currently fails with a `DeclarationError`.
+
+An example of this is:
+
+```solidity
+InsufficientApproval(address spender, uint256 allowance, uint256 needed);
+InsufficientApproval(address operator, uint256 tokenId);
+```
+
+For that reason, a domain prefix is proposed to avoid declaration clashing, which is the name of the ERC and its corresponding number appended at the beginning.
+
+Example:
+
+```solidity
+ERC20InsufficientApproval(address spender, uint256 allowance, uint256 needed);
+ERC721InsufficientApproval(address operator, uint256 tokenId);
+```
+
+### Arguments
+
+The selection of arguments depends on the subject involved, and it should follow the order presented below:
+
+1. _Who_ is involved with the error (eg. `address sender`)
+2. _What_ failed (eg. `uint256 allowance`)
+3. _Why_ it failed, expressed in additional arguments (eg. `uint256 needed`)
+
+A particular argument may fall in overlapping categories (eg. _Who_ may also be _What_), so not all of these will be present but the order shouldn't be broken.
+
+Some tokens may need a `tokenId`. This is suggested to include at the end as additional information instead of as a subject.
+
+### Error grammar rules
+
+Given the above, we can summarize the construction of error names with a grammar that errors will follow:
+
+```
+<Domain><ErrorPrefix><Subject>(<Arguments>);
+```
+
+Where:
+
+- _Domain_: `ERC20`, `ERC721` or `ERC1155`. Although other token standards may be suggested if not considered in this EIP.
+- _ErrorPrefix_: `Invalid`, `Insufficient`, or another if it's more appropiated.
+- _Subject_: `Sender`, `Receiver`, `Balance`, `Approver`, `Operator`, `Approval` or another if it's more appropiated, and must make adjustments based on domain's naming convention.
+- _Arguments_: Follow the [_who_, _what_ and _why_ order](#arguments).
+
+## Backwards Compatibility
+
+Tokens already deployed rely mostly on revert strings and make use of `require` instead of custom errors. Even most of the new deployed tokens since Solidity's v0.8.4 release inherit from implementations using revert strings.
+
+This EIP can not be enforced on non-upgradeable already deployed tokens, however, these tokens generally use similar conventions with small variations such as:
+
+- including/removing the [domain](#domain).
+- using different [error prefixes](#error-prefixes).
+- including similar [subjects](#actions-and-subjects).
+- changing the grammar order.
+
+Upgradeable contracts MAY be upgraded to implement this EIP.
+
+Implementers and DApp developers that implement special support for tokens that are compliant with this EIP, SHOULD tolerate different errors emitted by non-compliant contracts, as well as classic revert strings.
+
+## Reference Implementation
+
+### Solidity
+
+```solidity
+pragma solidity ^0.8.4;
+
+/// @title Standard ERC20 Errors
+/// @dev See https://eips.ethereum.org/EIPS/eip-20
+///  https://eips.ethereum.org/EIPS/eip-6093
+interface ERC20Errors {
+    error ERC20InsufficientBalance(address sender, uint256 balance, uint256 needed);
+    error ERC20InvalidSender(address sender);
+    error ERC20InvalidReceiver(address receiver);
+    error ERC20InsufficientAllowance(address spender, uint256 allowance, uint256 needed);
+    error ERC20InvalidApprover(address approver);
+    error ERC20InvalidSpender(address spender);
+}
+
+/// @title Standard ERC721 Errors
+/// @dev See https://eips.ethereum.org/EIPS/eip-721
+///  https://eips.ethereum.org/EIPS/eip-6093
+interface ERC721Errors {
+    error ERC721InvalidOwner(address sender, uint256 tokenId, address owner);
+    error ERC721InvalidSender(address sender);
+    error ERC721InvalidReceiver(address receiver);
+    error ERC721InsufficientApproval(address operator, uint256 tokenId);
+    error ERC721InvalidApprover(address approver);
+    error ERC721InvalidOperator(address operator);
+}
+
+/// @title Standard ERC1155 Errors
+/// @dev See https://eips.ethereum.org/EIPS/eip-1155
+///  https://eips.ethereum.org/EIPS/eip-6093
+interface ERC1155Errors {
+    error ERC1155InsufficientBalance(address sender, uint256 balance, uint256 needed, uint256 tokenId);
+    error ERC1155InvalidSender(address sender);
+    error ERC1155InvalidReceiver(address receiver);
+    error ERC1155InsufficientApproval(address operator, uint256 tokenId);
+    error ERC1155InvalidApprover(address approver);
+    error ERC1155InvalidOperator(address operator);
+    error ERC1155InvalidArrayLength(uint256 idsLength, uint256 valuesLength);
+}
+```
+
+## Security Considerations
+
+There are no known signature hash collision for the specified errors.
+
+Tokens upgraded to implement this EIP may break assumptions in other systems relying on revert strings.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
+

From ce57851dcfa0309e25192c29112d1f134ca1404f Mon Sep 17 00:00:00 2001
From: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
Date: Tue, 13 Dec 2022 14:54:24 -0500
Subject: [PATCH 034/274] Revert "Pickup latest eipw version (#6091)" (#6127)

This reverts commit b4db14cf02d820f7bf417d2d1d0043573106d4d4.
---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 1f4985a0b19856..00b9a8247d6756 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -99,7 +99,7 @@ jobs:
       - name: Checkout EIP Repository
         uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b
 
-      - uses: ethereum/eipw-action@859c779fd8ee3ae73f8b1aa9b69d87ea621074fe
+      - uses: ethereum/eipw-action@d57d2afb71253fc7447d8a7a28d60f9dead2290b
         id: eipw
         with:
           token: ${{ secrets.GITHUB_TOKEN }}

From 7a9673e0bd7f1f8d7e699fb1271b320d63964dbc Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <pawel@hepcolgum.band>
Date: Tue, 13 Dec 2022 21:01:27 +0100
Subject: [PATCH 035/274] EIP-4200: Remove invalid comment about gas costs
 (#6126)

---
 EIPS/eip-4200.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4200.md b/EIPS/eip-4200.md
index c6a311a0ee071d..828973d6a6a9e8 100644
--- a/EIPS/eip-4200.md
+++ b/EIPS/eip-4200.md
@@ -55,7 +55,7 @@ The immediate encoding of `RJUMPV` is more special: the 8-bit `count` value dete
 
 We also extend the validation algorithm of [EIP-3670](./eip-3670.md) to verify that each `RJUMP`/`RJUMPI`/`RJUMPV` has a `relative_offset` pointing to an instruction. This means it cannot point to an immediate data of `PUSHn`/`RJUMP`/`RJUMPI`/`RJUMPV`. It cannot point outside of code bounds. It is allowed to point to a `JUMPDEST`, but is not required to.
 
-Because the destinations are validated upfront, the cost of these instructions are less than their dynamic counterparts: `RJUMP` should cost 2, and `RJUMPI` and `RJUMPV` should cost 4. This is a reduction of 2 gas, compared to `JUMP` and `JUMPI`.
+Because the destinations are validated upfront, the cost of these instructions are less than their dynamic counterparts: `RJUMP` should cost 2, and `RJUMPI` and `RJUMPV` should cost 4.
 
 ## Rationale
 

From e507bbdcff4acff1eff5dde3679f72d797d4a417 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <pawel@hepcolgum.band>
Date: Wed, 14 Dec 2022 12:44:29 +0100
Subject: [PATCH 036/274] Update EIP-3670: Drop "terminating" instruction
 restriction (#6053)

* Update EIP-3670: Drop "terminating" instruction restriction

* Update EIP-3540,3670: Sync execution stop condition

* Update EIP-3670: Update reference implementation
---
 EIPS/eip-3540.md |  4 ++--
 EIPS/eip-3670.md | 50 +++++++++++++++---------------------------------
 2 files changed, 17 insertions(+), 37 deletions(-)

diff --git a/EIPS/eip-3540.md b/EIPS/eip-3540.md
index 5fd10b756f6d58..6ac7732035c7a1 100644
--- a/EIPS/eip-3540.md
+++ b/EIPS/eip-3540.md
@@ -35,7 +35,7 @@ A non-exhaustive list of proposed changes which could benefit from this format:
 
 - Including a `JUMPDEST`-table (to avoid analysis at execution time) and/or removing `JUMPDEST`s entirely.
 - Introducing static jumps (with relative addresses) and jump tables, and disallowing dynamic jumps at the same time.
-- Requiring code section(s) to be terminated by `STOP`. (Assumptions like this can provide significant speed improvements in interpreters, such as a speed-up of ~7% seen in evmone (ethereum/evmone#295).
+- Requiring the execution of a code section ends with a terminating instruction. (Assumptions like this can provide significant speed improvements in interpreters, such as a speed-up of ~7% seen in evmone (ethereum/evmone#295).
 - Multibyte opcodes without any workarounds.
 - Representing functions as individual code sections instead of subroutines.
 - Introducing special sections for different use cases, notably Account Abstraction.
@@ -125,7 +125,7 @@ For clarity, the *container* refers to the complete account code, while *code* r
 
 1. `JUMPDEST`-analysis is only run on the *code*.
 2. Execution starts at the first byte of the *code*, and `PC` is set to 0.
-3. If `PC` goes outside the code section bounds, execution aborts with failure.
+3. Execution stops if `PC` goes outside the code section bounds.
 4. `PC` returns the current position within the *code*.
 5. `JUMP`/`JUMPI` uses an absolute offset within the *code*.
 6. `CODECOPY`/`CODESIZE`/`EXTCODECOPY`/`EXTCODESIZE`/`EXTCODEHASH` keeps operating on the entire *container*.
diff --git a/EIPS/eip-3670.md b/EIPS/eip-3670.md
index 92762beea46017..5ef9b52f780d6e 100644
--- a/EIPS/eip-3670.md
+++ b/EIPS/eip-3670.md
@@ -44,23 +44,17 @@ The EOF1 format provides following forward compatibility properties:
 
 This feature is introduced on the very same block EIP-3540 is enabled, therefore every EOF1-compatible bytecode MUST be validated according to these rules.
 
-Previously deprecated instructions `CALLCODE` (0xf2) and `SELFDESTRUCT` (0xff) are invalid and their opcodes do not have any instruction assigned.
+1. Previously deprecated instructions `CALLCODE` (0xf2) and `SELFDESTRUCT` (0xff) are invalid and their opcodes are undefined.
 
-At contract creation time both *initcode* and *code* are iterated instruction-by-instruction (the same process is used to perform "JUMPDEST-analysis").
-Bytecode is deemed invalid if any of these conditions is true:
-
-- it contains opcodes which are not currently assigned to an instruction (for the sake of assigned instructions, we count `INVALID` (0xfe) as assigned),
-- the last opcode (*terminating instruction*) is not `STOP` (0x00),`RETURN` (0xf3), `REVERT` (0xfd) or `INVALID` (0xfe).
-
-*Notice that due to the requirement of the terminating instruction, it is implicitly stated that truncated instructions (e.g. data portion of a `PUSHn`) are disallowed.*
-
-*Notice that since EOF1 disallows 0-length code section, a valid contract must contain at least a single byte, which must be a terminating instruction.*
+2. At contract creation time *instructions validation* is performed on both *initcode* and *code*. The code is invalid if any of the checks below fails. For each instruction:
+   1. Check if the opcode is defined. The `INVALID` (0xfe) is considered defined.
+   2. Check if all instructions' immediate bytes are present in the code (code does not end in the middle of instruction).
 
 ## Rationale
 
-### Terminating instructions
+### Immediate data
 
-An efficient interpreter loop would only need to rely on checking if a terminating instruction has been encountered, and if so stopping execution. Currently, this is not possible in the EVM, because of the lack of requirement for a proper termination as well as allowing for truncated instructions, an interpreter must track and check these various conditions.
+Allowing implicit zero immediate data for `PUSH` instructions introduces inefficiencies to EVM implementations without any practical use-case (the value of a `PUSH` instruction at the code end cannot be observed by EVM). This EIP requires all immediate bytes to be explicitly present in the code.
 
 ### Rejection of deprecated instructions
 
@@ -83,19 +77,15 @@ Each case should be tested for creation transaction, `CREATE` and `CREATE2`.
 ### Valid codes
 
 - EOF code containing `INVALID`
-- EOF codes ending with any of the terminating instructions
 - EOF code with data section containing bytes that are undefined instructions
 - Legacy code containing undefined instruction
 - Legacy code ending with incomplete PUSH instruction
-- Legacy code ending with any valid non-terminating instruction
 
 ### Invalid codes
 
 - EOF code containing undefined instruction
 - EOF code ending with incomplete `PUSH` instruction
     - This can include `PUSH` instruction unreachable by execution, e.g. after `STOP`
-- EOF code ending with any defined instruction other than terminating ones
-    - This can include codes where non-terminating instruction is not reachable, e.g. `0030` (`STOP ADDRESS`).
 
 ## Reference Implementation
 
@@ -118,38 +108,28 @@ valid_opcodes = [
     0xf0, 0xf1, 0xf3, 0xf4, 0xf5, 0xfa, 0xfd, 0xfe
 ]
 
-# STOP, RETURN, REVERT, INVALID
-terminating_opcodes = [ 0x00, 0xf3, 0xfd, 0xfe ]
-
-# Only for PUSH1..PUSH32
 immediate_sizes = 256 * [0]
-for opcode in range(0x60, 0x7f + 1):  # PUSH1..PUSH32
-    immediate_sizes[opcode] = opcode - 0x60 + 1
+immediate_sizes[0x60:0x7f + 1] = range(1, 32 + 1)  # PUSH1..PUSH32
+
 
 # Raises ValidationException on invalid code
-def validate_code(code: bytes):
+def validate_instructions(code: bytes):
     # Note that EOF1 already asserts this with the code section requirements
     assert len(code) > 0
 
-    opcode = 0
     pos = 0
     while pos < len(code):
         # Ensure the opcode is valid
         opcode = code[pos]
-        pos += 1
-        if not opcode in valid_opcodes:
-            raise ValidationException("undefined instruction")
+        if opcode not in valid_opcodes:
+            raise ValidationException("undefined opcode")
 
-        # Skip immediates
-        pos += immediate_sizes[opcode]
+        # Skip immediate data
+        pos += 1 + immediate_sizes[opcode]
 
-    # Ensure last opcode's immediate doesn't go over code end
-    if pos != len(code):        
+    # Ensure last instruction's immediate doesn't go over code end
+    if pos != len(code):
         raise ValidationException("truncated immediate")
-
-    # opcode is the *last opcode*
-    if not opcode in terminating_opcodes:
-        raise ValidationException("no terminating instruction")
 ```
 
 ## Security Considerations

From 19d8065c50796918a75f9f8cf39c7e1cf6446121 Mon Sep 17 00:00:00 2001
From: Samuele Marro <marrosamuele@gmail.com>
Date: Wed, 14 Dec 2022 17:38:09 +0100
Subject: [PATCH 037/274] Fixed typo. (#6104)

---
 EIPS/eip-5375.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5375.md b/EIPS/eip-5375.md
index c0cd6cc4d0a580..3eaa5516c7ee1f 100644
--- a/EIPS/eip-5375.md
+++ b/EIPS/eip-5375.md
@@ -190,7 +190,7 @@ and the content of `metadataFields` is `["name", "description"]`, the content of
 ```json
 {
     "name": "The Holy Hand Grenade of Antioch",
-    "description": "Throw in the general direction of your favorite rabbit, et voilà"
+    "description": "Throw in the general direction of your favorite rabbit, et voil\u00E0"
 }
 ```
 

From bb1ec143544a76c1e3230752a67668041ab08ffa Mon Sep 17 00:00:00 2001
From: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
Date: Wed, 14 Dec 2022 13:04:58 -0500
Subject: [PATCH 038/274] Grab latest eipw... again (#6130)

---
 .github/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 00b9a8247d6756..b7535193a45372 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -99,7 +99,7 @@ jobs:
       - name: Checkout EIP Repository
         uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b
 
-      - uses: ethereum/eipw-action@d57d2afb71253fc7447d8a7a28d60f9dead2290b
+      - uses: ethereum/eipw-action@451d4e314183dd83401171908ca784e047122d70
         id: eipw
         with:
           token: ${{ secrets.GITHUB_TOKEN }}

From 99c553eff4c0b926b6e37fdede916511c9201987 Mon Sep 17 00:00:00 2001
From: genkifs <genkifs@gmail.com>
Date: Wed, 14 Dec 2022 18:42:12 +0000
Subject: [PATCH 039/274] Add EIP-5850: Complex Numbers stored in Bytes32 types
 (#5850)

* Create 5807: Note discussions-to field not yet set

* Create 5807: Note discussions-to field not yet set

* Security concerns added

* Status reordered

* Type after status

* Reordering

* author

* author

* Whitespace removal

* Update and rename eip-5807.md to eip-5850.md

* Update EIPS/eip-5850.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5850.md

Language improvements

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Implemented suggestions from Pandapip

* Formatting

* Fix the code block spacing

* Added complex numbers use cases

* removed wikipedia links

* formatting

* Formatting

* ERC to EIP

* ERC deleted

* bytes32 references displayed as code

* code tag added

* Clarifying that the EIP is number format agnostic

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-5850.md | 77 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 77 insertions(+)
 create mode 100644 EIPS/eip-5850.md

diff --git a/EIPS/eip-5850.md b/EIPS/eip-5850.md
new file mode 100644
index 00000000000000..09eed5af674e2c
--- /dev/null
+++ b/EIPS/eip-5850.md
@@ -0,0 +1,77 @@
+---
+eip: 5850
+title: Complex Numbers stored in `bytes32` types
+description: Store real and imaginary parts of complex numbers in the least significant and most significant 16 bytes respectively of a `bytes32` type.
+author: Paul Edge (@genkifs)
+discussions-to: https://ethereum-magicians.org/t/eip-5850-store-real-and-imaginary-parts-of-complex-numbers-in-the-least-significant-and-most-significant-16-bytes-respectively-of-a-bytes32-type/11532
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-10-29
+---
+ 
+## Abstract
+
+This EIP proposes a natural way for complex numbers to be stored in and retrieved from the `bytes32` data-type.  It splits the storage space exactly in half and, most importantly, assigns the real number part to the least significant 16 bytes and the imaginary number part to the most significant 16 bytes.
+
+## Motivation
+
+Complex numbers are an essential tool for many mathematical and scientific calculations.  For example, Fourier Transforms, Characteristic functions, AC Circuits and Navier-Stokes equations all require the concept.
+
+Complex numbers can be represented in many different forms (polynomial, cartesian, polar, exponential).  The EIP creates a standard that can accomodate cartesian, polar and exponential formats with example code given for the Cartesian representation, where a complex number is just the pair of real numbers which gives the real and imaginary co-ordinates of the complex number. Equal storage capacity is assigned to both components and the order they appear is explicitly defined.  
+
+Packing complex numbers into a single `bytes32` data object halves storage costs and creates a more natural code object that can be passed around the solidity ecosystem.  Existing code may not need to be rewritten for complex numbers.  For example, mappings by `bytes32` are common and indexing in the 2D complex plane may improve code legibility.  
+
+Decimal numbers, either fix or floating, are not yet fully supported by Solidity so enforcing similar standards for complex versions is premature.  It can be suggested that fixed point methods such as prb-math be used with 18 decimal places, or floating point methods like abdk.  However, it should be noted that this EIP supports any decimal number representation so long as it fits inside the 16 bytes space.
+
+## Specification
+
+A complex number would be defined as `bytes32` and a cartesian representation would be initalized with the `cnNew` function and converted back with `RealIm`, both given below.
+
+To create the complex number one would use
+
+```solidity
+function cnNew(int128 _Real, int128 _Imag) public pure returns (bytes32){
+    bytes32 Imag32 = bytes16(uint128(_Imag));
+    bytes32 Real32 = bytes16(uint128(_Real));
+    return (Real32>> 128) | Imag32;
+}
+```
+
+and to convert back
+
+```solidity
+function RealIm(bytes32 _cn)  public pure returns (int128 Real, int128 Imag){
+    bytes16[2] memory tmp = [bytes16(0), 0];
+    assembly {
+        mstore(tmp, _cn)
+        mstore(add(tmp, 16), _cn)
+    }
+    Imag=int128(uint128(tmp[0]));
+    Real=int128(uint128(tmp[1]));
+}
+```
+
+## Rationale
+
+An EIP is required as this proposal defines a complex numbers storage/type standard for multiple apps to use.
+
+This EIP proposes to package both the real and imaginary within one existing data type, `bytes32`.  This allows compact storage without the need for structures and facilitates easy library implementations.  The `bytes32` would remain available for existing, non-complex number uses.
+Only the split and position of the real & imaginary parts is defined in this EIP.  Manipulation of complex numbers (addition, multiplication etc.), number of decimal places and other such topics are left for other EIP discussions.  This keeps this EIP more focused and therfore more likely to succeed.
+
+Defining real numbers in the 16 least-significant bytes allows direct conversion from `uint128` to `bytes32` for positive integers less than 2**127.  
+Direct conversion back from `bytes32` -> `uint` -> `int` are not recommended as the complex number may contain imaginary parts and/or the real part may be negative. It is better to always use `RealIm` for separating the complex part.  
+
+Libraries for complex number manipulation can be implemented with the `Using Complex for bytes32` syntax where `Complex` would be the name of the library.  
+
+## Backwards Compatibility
+
+There is no impact on other uses of the `bytes32` datatype.  
+
+## Security Considerations
+
+If complex numbers are manipulated in `bytes32` form then overflow checks must be performed manually during the manipulation.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From d05cb7db98974143657f72a25192bdf201f34371 Mon Sep 17 00:00:00 2001
From: Daniel Tedesco <dtedesco1@gmail.com>
Date: Thu, 15 Dec 2022 02:48:22 +0800
Subject: [PATCH 040/274] Update EIP-4974: Community Feedback (#5135)

* Apply suggestions from initial review

co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

update links

Apply initial suggestions from code review

Update EIP number and typos.

Co-authored-by: William Schwab <31592931+wschwab@users.noreply.github.com>
Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>

rename, add enumerable, update language

update name conventions, ERC165 identifier

update backwards compatability

* minor wording edit

* update with participate and transfer nomenclature

* update reference links

* update reference to assets folder

* removing the assets link

* small update

* begin update to rating

* Apply suggestions from code review

* Full update to Ratings

* Fix links

* Update interface and add implementation example

* Update EIPS/eip-4974.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-4974.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Remove self-references

* Fix bot errors

* Last bot errors

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-4974.md             | 178 ++++++++++++----------------
 assets/eip-4974/ERC4974.sol  | 222 ++++++++---------------------------
 assets/eip-4974/IERC4974.sol |  78 ++++++------
 3 files changed, 162 insertions(+), 316 deletions(-)

diff --git a/EIPS/eip-4974.md b/EIPS/eip-4974.md
index 834fde7917dd4c..4334f4a86c6ce4 100644
--- a/EIPS/eip-4974.md
+++ b/EIPS/eip-4974.md
@@ -1,7 +1,7 @@
 ---
 eip: 4974
-title: Experience (EXP) Token Standard
-description: A standard interface for fungible, non-tradable tokens, also known as EXP.
+title: Ratings
+description: An interface for assigning and managing numerical ratings
 author: Daniel Tedesco (@dtedesco1)
 discussions-to: https://ethereum-magicians.org/t/8805
 status: Draft
@@ -12,58 +12,56 @@ requires: 165
 ---
 
 ## Abstract
-The following describes a standard interface for fungible non-tradable tokens, or EXP. This standard provides basic functionality for participant addresses to consent to receive tokens and for an operator address to transfer tokens.
 
-EXP, shorthand for "experience points", may represent accumulated recognition within a smart contract. Like experience points in video games, citations on an academic paper, or Reddit Karma, EXP is bestowed for useful contributions, accumulates as indistinguishable units, and should only be reallocated or destroyed by a reliable authority so empowered.
-
-The standard described here allows reputation earned to be codified within a smart contract and recognized by other applications: from a five-member local bicycle club to a million-member green energy DAO.
+This standard defines a standardized interface for assigning and managing numerical ratings on the Ethereum blockchain. This allows ratings to be codified within smart contracts and recognized by other applications, enabling a wide range of new use cases for tokens.
 
 ## Motivation
-How reputation manifests across groups can vary widely. Healthy communities allocate reputation to their participants using three key principles:
-1. Consent -- No one is forced to be part of the group, but joining requires abiding by the governance structure of the group. 
-2. Meritocracy -- Reputation is earned by recognition from the group. It cannot be claimed, purchased, or sold.
-3. Ethics -- The group can decrease an individual's reputation after bad behavior.
 
-Since the creation of Bitcoin in 2008, the vast majority of blockchain applications have centered on buying and selling digital assets. While these use cases are substantial, digital assets need not be created with trading in mind. In fact, trading can be detrimental to community-based blockchain projects. This was evident in the pay-to-play dynamics of many EVM-based games and DAOs in 2021.
+Traditionally, blockchain applications have focused on buying and selling digital assets. However, the asset-centric model has often been detrimental to community-based blockchain projects, as seen in the pay-to-play dynamics of many EVM-based games and DAOs in 2021.
+
+This proposal addresses this issue by allowing ratings to be assigned to contracts and wallets, providing a new composable primitive for blockchain applications. This allows for a diverse array of new use cases, such as:
+
+- Voting weight in a DAO: Ratings assigned using this standard can be used to determine the voting weight of members in a decentralized autonomous organization (DAO). For example, a DAO may assign higher ratings to members who have demonstrated a strong track record of contributing to the community, and use these ratings to determine the relative influence of each member in decision-making processes.
+
+- Experience points in a decentralized game ecosystem: Ratings can be used to track the progress of players in a decentralized game ecosystem, and to reward them for achieving specific milestones or objectives. For example, a game may use ratings to assign experience points to players, which can be used to unlock new content or abilities within the game.
 
-A smart contract cannot directly imbue consent, meritocracy, and ethics into a community, but it can encourage those principles. In doing so, the standard set out below will hopefully unlock a diverse array of new use cases for tokens:
-- Voting weight in a DAO
-- Experience points in a decentralized game
-- Loyalty points for customers of a business
+- Loyalty points for customers of a business: Ratings can be used to track the loyalty of customers to a particular business or service, and to reward them for their continued support. For example, a business may use ratings to assign loyalty points to customers, which can be redeemed for special offers or discounts.
 
-This standard is influenced by the [ERC-20](./eip-20) and [ERC-721](./eip-721) token standards and takes cues from each in its structure, style, and semantics. Neither, however, was created for fungible operator-managed token contracts such as EXP. Nor do existing proposals for non-tradable tokens meet the requirements of EXP use cases.
+- Asset ratings for a decentralized insurance company: Ratings can be used to evaluate the risk profile of assets in a decentralized insurance company, and to determine the premiums and coverage offered to policyholders. For example, a decentralized insurance company may use ratings to assess the risk of different types of assets, and to provide lower premiums and higher coverage to assets with lower risk ratings.
+
+This standard is influenced by the [EIP-20](./eip-20.md) and [EIP-721](./eip-721.md) token standards and takes cues from each in its structure, style, and semantics.
 
 ## Specification
+
 The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
 
-Every ERC-4974 compliant contract MUST implement the ERC4974 and ERC165 interfaces:
+Every compliant contract MUST implement the following interfaces:
 
 ```
 // SPDX-License-Identifier: CC0
 
 pragma solidity ^0.8.0;
 
-/// @title ERC-4974 Experience (EXP) Token Standard
+/// @title EIP-4974 Ratings
 /// @dev See https://eips.ethereum.org/EIPS/EIP-4974
-///  Note: the ERC-165 identifier for this interface is 0x696e7752.
+///  Note: the EIP-165 identifier for this interface is #######.
 ///  Must initialize contracts with an `operator` address that is not `address(0)`.
-///  Must initialize contracts assigning participation as `true` for both `operator` and `address(0)`.
 interface IERC4974 /* is ERC165 */ {
 
     /// @dev Emits when operator changes.
     ///  MUST emit when `operator` changes by any mechanism.
     ///  MUST ONLY emit by `setOperator`.
-    event Appointment(address indexed _operator);
+    event NewOperator(address indexed _operator);
 
-    /// @dev Emits when an address activates or deactivates its participation.
-    ///  MUST emit emit when participation status changes by any mechanism.
-    ///  MUST ONLY emit by `setParticipation`.
-    event Participation(address indexed _participant, bool _participation);
+    /// @dev Emits when operator issues a rating. 
+    ///  MUST emit when rating is assigned by any mechanism.
+    ///  MUST ONLY emit by `rate`.
+    event Rating(address _rated, int8 _rating);
 
-    /// @dev Emits when operator transfers EXP. 
-    ///  MUST emit when EXP is transferred by any mechanism.
-    ///  MUST ONLY emit by `transfer`.
-    event Transfer(address indexed _from, address indexed _to, uint256 _amount);
+    /// @dev Emits when operator removes a rating. 
+    ///  MUST emit when rating is removed by any mechanism.
+    ///  MUST ONLY emit by `remove`.
+    event Removal(address _removed);
 
     /// @notice Appoint operator authority.
     /// @dev MUST throw unless `msg.sender` is `operator`.
@@ -73,117 +71,91 @@ interface IERC4974 /* is ERC165 */ {
     /// @param _operator New operator of the smart contract.
     function setOperator(address _operator) external;
 
-    /// @notice Activate or deactivate participation. CALLER IS RESPONSIBLE TO
-    ///  UNDERSTAND THE TERMS OF THEIR PARTICIPATION.
-    /// @dev MUST throw unless `msg.sender` is `participant`.
-    ///  MUST throw if `participant` is `operator` or zero address.
-    ///  MUST emit a `Participation` event for status changes.
-    /// @param _participant Address opting in or out of participation.
-    /// @param _participation Participation status of _participant.
-    function setParticipation(address _participant, bool _participation) external;
+    /// @notice Rate an address.
+    ///  MUST emit a Rating event with each successful call.
+    /// @param _rated Address to be rated.
+    /// @param _rating Total EXP tokens to reallocate.
+    function rate(address _rated, int8 _rating) external;
 
-    /// @notice Transfer EXP from one address to a participating address.
-    /// @dev MUST throw unless `msg.sender` is `operator`.
-    ///  MUST throw unless `to` address is participating.
-    ///  MUST throw if `to` and `from` are the same address.
-    ///  MUST emit a Transfer event with each successful call.
-    ///  SHOULD throw if `amount` is zero.
-    ///  MAY allow minting from zero address, burning to the zero address, 
-    ///  transferring between accounts, and transferring between contracts.
-    ///  MAY limit interaction with non-participating `from` addresses.
-    /// @param _from Address from which to transfer EXP tokens.
-    /// @param _to Address to which EXP tokens at `from` address will transfer.
-    /// @param _amount Total EXP tokens to reallocate.
-    function transfer(address _from, address _to, uint256 _amount) external;
-
-    /// @notice Return total EXP managed by this contract.
-    /// @dev MUST sum EXP tokens of all `participant` addresses, 
-    ///  regardless of participation status, excluding only the zero address.
-    function totalSupply() external view returns (uint256);
-
-    /// @notice Return total EXP allocated to a participant.
-    /// @dev MUST register each time `Transfer` emits.
+    /// @notice Remove a rating from an address.
+    ///  MUST emit a Remove event with each successful call.
+    /// @param _removed Address to be removed.
+    function removeRating(address _removed) external;
+
+    /// @notice Return a rated address' rating.
+    /// @dev MUST register each time `Rating` emits.
     ///  SHOULD throw for queries about the zero address.
-    /// @param _participant An address for whom to query EXP total.
-    /// @return uint256 The number of EXP allocated to `participant`, possibly zero.
-    function balanceOf(address _participant) external view returns (uint256);
+    /// @param _rated An address for whom to query rating.
+    /// @return int8 The rating assigned.
+    function ratingOf(address _rated) external view returns (int8);
 }
 
 interface IERC165 {
     /// @notice Query if a contract implements an interface.
-    /// @dev Interface identification is specified in ERC-165. This function
+    /// @dev Interface identification is specified in EIP-165. This function
     ///  uses less than 30,000 gas.
-    /// @param interfaceID The interface identifier, as specified in ERC-165.
+    /// @param interfaceID The interface identifier, as specified in EIP-165.
     /// @return bool `true` if the contract implements `interfaceID` and
     ///  `interfaceID` is not 0xffffffff, `false` otherwise.
     function supportsInterface(bytes4 interfaceID) external view returns (bool);
 }
 ```
 
-The *metadata extension* is OPTIONAL for ERC-4974 smart contracts. This allows an EXP smart contract to be interrogated for its name and description.
-```
-// SPDX-License-Identifier: CC0
+## Rationale
 
-pragma solidity ^0.8.0;
+### Rating Assignment
 
-import "./IERC4974.sol";
+Ratings SHALL be at the sole discretion of the contract operator. This party may be a sports team coach or a multisig DAO wallet. We decide not to specify how governance occurs, but only *that* governance occurs. This allows for a wider range of potential use cases than optimizing for particular decision-making forms.
 
-/// @title ERC-4974 EXP Token Standard, optional metadata extension
-/// @dev See https://eips.ethereum.org/EIPS/EIP-4974
-///  Note: the ERC-165 identifier for this interface is 0x74793a15.
-interface IERC4974Metadata is IERC4974 {
-    /// @notice A descriptive name for the EXP in this contract.
-    function name() external view returns (string memory);
+This proposal standardizes a control mechanism to allocate community reputation without encouraging financialization of that recognition. While it does not ensure meritocracy, it opens the door.
 
-    /// @notice A one-line description of the EXP in this contract.
-    function description() external view returns (string memory);
-}
-```
+### Choice of int8
 
-## Rationale
-### Participation
-EXP drops SHALL require pre-approval from the delivery address. This ensures the receiver is a consenting participant in the smart contract.
+It's signed: Reviewers should be able to give neutral and negative ratings for the wallets and contracts they interact with. This is especially important for decentralized applications that may be subject to malicious actors.
 
-### Transfers
-EXP transfers SHALL be at the sole discretion of the contract operator. This party may be a sports team coach or a multisig DAO wallet. We decide not to specify how governance occurs, but only *that* governance occurs. This allows for a wider range of potential use cases than optimizing for particular decision-making forms.
+It's 8bit: The objective here is to keep ratings within some fathomably comparable range. Longer term, this could encourage easy aggregation of ratings, versus using larger numbers where users might employ a great variety of scales.
 
-ERC-4974 standardizes a control mechanism to allocate community recognition without encouraging financialization of that recognition or easily allowing non-contributors to acquire EXP representing contribution. While it does not ensure meritocracy, it opens the door.
+### Rating Changes
 
-### Token Destruction
-EXP SHOULD allow burning tokens by contract operators. If Bob has contributed greatly to the community, but then is caught stealing from Alice, the community may decide this should lower Bob's standing and influence in the community. Again, while this does not ensure an ethical standard within the community, it opens the door.
+Ratings SHOULD allow rating updates by contract operators. If Bob has contributed greatly to the community, but then is caught stealing from Alice, the community may decide this should lower Bob's standing and influence in the community. Again, while this does not ensure an ethical standard within the community, it opens the door.
 
-### EXP Word Choice
-EXP, or experience points, are common parlance in the video game industry and generally known among modern internet users. Allocated EXP typically confers to strength and accumulates as one progresses in a game. This serves as a fair analogy to what we aim to achieve with ERC-4974 by encouraging members of a community to have more strength in that community the more they contribute.
+Relatedly, ratings SHOULD allow removal of ratings to rescind a rating if the rater does not have confidence in their ability to rate effectively.
 
-*Alternatives Considered:  Soulbound Tokens, Soulbounds, Fungible Soulbound Tokens, Non-tradable Fungible Tokens, Non-transferrable Fungible Tokens, Karma Points, Reputation Tokens, Kudos*
+### Interface Detection
 
-### Participants Word Choice
-Participants have agency over their *participation* in an activity, but not over the *outcomes*. Parties to ERC-4974 contracts are not owners in the same sense as owners of ERC-20 or ERC-721 tokens. The EXP sits in their wallets, but those wallets do not directly control any use of the EXP. 
+We chose Standard Interface Detection ([EIP-165](./eip-165.md)) to expose the interfaces that a compliant smart contract supports.
 
-*Alternatives Considered:  members, parties, contributors, players, entrants*
+### Metadata Choices
 
-### ERC-165 Interface
-We chose Standard Interface Detection (ERC-165) to expose the interfaces that an ERC-4974 smart contract supports.
+We have required `name` and `description` functions in the metadata extension. `name` common among major standards for blockchain-based primitives. We included a `description` function that may be helpful for games or other applications with multiple ratings systems.
 
-### Metadata Choices
-We have required `name` and `description` functions in the metadata extension. Name common among major token standards (namely, ERC-20 and ERC-721). We eschewed `symbol` as we do not wish them to be listed on any tickers that might tempt operators to engage in financial activities with these assets. We included a `description` function that may be helpful for games or other applications with multiple ERC-4974 tokens.
+We remind implementation authors that the empty string is a valid response to `name` and `description` if you protest to the usage of this mechanism. We also remind everyone that any smart contract can use the same name and description as your contract. How a client may determine which ratings smart contracts are well-known (canonical) is outside the scope of this standard.
+
+### Drawbacks
 
-We remind implementation authors that the empty string is a valid response to `name` and `description` if you protest to the usage of this mechanism. We also remind everyone that any smart contract can use the same name and symbol as your contract. How a client may determine which ERC-4974 smart contracts are well-known (canonical) is outside the scope of this standard.
+One potential drawback of using this standard is that ratings are subjective and may not always accurately reflect the true value or quality of a contract or wallet. However, the standard provides mechanisms for updating and removing ratings, allowing for flexibility and evolution over time.
 
-### Privacy
-Users identified in the motivation section have a strong need to identify how much EXP an address holds. Since EXP contracts are opt-in, we hope users will be proud of their accumulated recognition and not wish to keep it secret. Without metadata associated to individual tokens or wallets, the privacy risks of this standard are limited.
+Users identified in the motivation section have a strong need to identify how a contract or community evaluates another. While some users may be proud of ratings they receive, others may rightly or wrongly receive negative ratings from certain contracts. Negative ratings may allow for nefarious activities such as bullying and discrimination. We implore all implementers to be mindful of the consequences of any ratings systems they create with this standard.
 
 ## Backwards Compatibility
-We have adopted `Transfer`, `transfer`, `balanceOf`, `totalSupply`, and `name` semantics from the ERC-20 and ERC-721 specifications. An implementation may also include a function `decimals` that returns `uint8(0)` if its goal is to be more compatible with ERC-20 while supporting this standard.
+
+We have adopted the `name` semantics from the EIP-20 and EIP-721 specifications.
 
 ## Reference Implementation
+
 A reference implementation of this standard can be found in the assets folder.
 <!-- [../assets/EIP-4974/ERC4974.sol](../assets/EIP-4974/ERC4974.sol). -->
 
 ## Security Considerations
-The `operator` address has total control over the allocation and transfer of tokens. Therefore, ensuring this party is secure and trustworthy is critical for the contract to function. No alternative exists if the operator is corrupted or lost.
 
-We strongly encourage `operator` to be a smart contract with robust access control features to manage EXP.
+One potential security concern with this standard is the risk of malicious actors assigning false or misleading ratings to contracts or wallets. This could be used to manipulate voting weights in a DAO, or to deceive users into making poor decisions based on inaccurate ratings.
+
+To address this concern, the standard includes mechanisms for updating and removing ratings, allowing for corrections to be made in cases of false or misleading ratings. Additionally, the use of a single operator address to assign and update ratings provides a single point of control, which can be used to enforce rules and regulations around the assignment of ratings.
+
+Another potential security concern is the potential for an attacker to gain control of the operator address and use it to manipulate ratings for their own benefit. To mitigate this risk, it is recommended that the operator address be carefully managed and protected, and that multiple parties be involved in its control and oversight.
+
+Overall, the security of compliant contracts will depend on the careful management and protection of the operator address, as well as the development of clear rules and regulations around the assignment of ratings.
 
 ## Copyright
-Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/).
+
+Copyright and related rights waived via CC0.
diff --git a/assets/eip-4974/ERC4974.sol b/assets/eip-4974/ERC4974.sol
index 69a60601183157..2619a2e4ec7821 100644
--- a/assets/eip-4974/ERC4974.sol
+++ b/assets/eip-4974/ERC4974.sol
@@ -2,201 +2,83 @@
 
 pragma solidity ^0.8.0;
 import "./IERC4974.sol";
-import "./IERC4974Metadata.sol";
-import "@openzeppelin/contracts/utils/introspection/ERC165.sol";
-import "@openzeppelin/contracts/utils/Context.sol";
 
 /**
  * See {IERC4974}
  * Implements the ERC4974 Metadata extension.
  */
-contract ERC4974 is Context, IERC165, IERC4974, IERC4974Metadata {
-    mapping(address => uint256) private _balances;
-    mapping(address => bool) private _participants;
-    address private _operator;
-    uint256 private _totalSupply;
-    string private _name;
-    string private _description;
-
-    /**
-     * @notice Sets the values for {name} and {symbol}.
-     * @dev Name and description are both immutable: they can only be set once during
-     * construction. Operator cannot be the zero address.
-     */
-    constructor(string memory name_, string memory description_, address operator_) {
-    // constructor(address operator_) {
-        require(operator_ != address(0), "Operator cannot be the zero address.");
-        _name = name_;
-        _description = description_;
-        _operator = operator_;
-        _participants[_operator] = true;
-        _participants[address(0)] = true;
-    }
-
-    /**
-     *
-     * External Functions
-     *
-     */
+contract LoyaltyPoints is IERC4974 {
 
-    /**
-     * @dev See {IERC165-supportsInterface}.
-     */
-    function supportsInterface(bytes4 interfaceId) public view virtual override(IERC165) returns (bool) {
-        return
-            interfaceId == type(IERC4974).interfaceId ||
-            interfaceId == type(IERC4974Metadata).interfaceId ||
-            supportsInterface(interfaceId);
-    }
+    // The address of the operator that can assign ratings
+    address private _operator;
 
-    /**
-    * @notice Assigns a new operator address.
-    * @dev Throws if sender is not operator or `newOperator` equals current `_operator`
-    * @param newOperator Address to reassign operator role.
-    */
-    function setOperator(address newOperator) external virtual override {
-        _setOperator(newOperator);
-    }
+    // Mapping of customer addresses to their ratings
+    mapping (bytes32 => int8) private _ratings;
 
-    /**
-     * @notice Sets participation status for an address.
-     * @dev Throws if msg.sender is not the address in question.
-     */
-    function setParticipation(address participant, bool participation) external virtual override {
-        _participation(participant, participation);
+    // Initializes the contract by setting the operator to msg.sender
+    constructor () {
+        _operator = msg.sender;
     }
 
-    /**
-     * @notice Transfer `amount` EXP to an account.
-     * @dev Emits `Transfer` event if successful.
-     * Throws if:  
-     * - Sender is not operator 
-     * - `to` address is not participating.
-     * - Zero address mints to itself.
-     * @param from The address from which to transfer. Zero address for mints.
-     * @param to The address of the recipient. Zero address for burns.
-     * @param amount The amount to be transferred.
-     */
-    function transfer(address from, address to, uint256 amount) external virtual override {
-        _transfer(from, to, amount);
+    // Set the operator address
+    // Only the current operator or the contract owner can call this function
+    function setOperator(address newOperator) public override {
+        require(_operator == msg.sender || msg.sender == address(this), "Only the current operator or the contract owner can set the operator.");
+        _operator = newOperator;
+        emit NewOperator(_operator);
     }
 
-    /**
-     * @notice Returns the name of the EXP token.
-     * @return string The name of the EXP token.
-     */
-    function name() external view virtual override returns (string memory) {
-        return _name;
+    // Rate a customer
+    // Only the operator can call this function
+    function rate(address customer, int8 rating) public override {
+        require(_operator == msg.sender, "Only the operator can assign ratings.");
+        bytes32 hash = keccak256(abi.encodePacked(customer));
+        _ratings[hash] = rating;
+        emit Rating(customer, rating);
     }
 
-    /**
-     * @notice Returns the description of the EXP token,
-     * usually a one-line description.
-     * @return string The description of the EXP token.
-     */
-    function description() external view virtual override returns (string memory) {
-        return _description;
+    // Remove a rating from a customer
+    // Only the operator can call this function
+    function removeRating(address customer) external override {
+        require(_operator == msg.sender, "Only the operator can remove ratings.");
+        bytes32 hash = keccak256(abi.encodePacked(customer));
+        delete _ratings[hash];
+        emit Removal(customer);
     }
 
-    /**
-     * @notice Returns the current operator of the EXP token,
-     * @return address The current operator of the EXP token.
-     */
-    function operator() external view virtual returns (address) {
+    // Get the rating for a customer
+    function getOperator() public view returns (address) {
         return _operator;
     }
 
-    /**
-     * @notice Returns the EXP balance of the account.
-     * @param account The address to query.
-     * @return uint256 The EXP balance of the account.
-     */
-    function balanceOf(address account) external view virtual override returns (uint256) {
-        require(account != address(0), "Zero address has no balance.");
-        return _balances[account];
-    }
+    // Check if a customer has been rated
+    function hasBeenRated(address customer) public view returns (bool) {
+        // Hash the customer address
+        bytes32 hash = keccak256(abi.encodePacked(customer));
 
-    /**
-     * @notice Returns the participation status of the account.
-     * @param account The address to query.
-     * @return bool The participation status of the queried account.
-     */
-    function participationOf(address account) external view virtual returns (bool) {
-        return _participants[account];
+        // Check if the hash exists in the mapping
+        return _ratings[hash] != 0;
     }
 
-    /**
-     * @notice Returns the total supply of EXP tokens.
-     * @dev Result includes inactive accounts, but not destroyed tokens.
-     * @return uint256 The total supply of EXP tokens.
-     */
-    function totalSupply() external view virtual override returns (uint256) {
-        return _totalSupply;
+    function ratingOf(address _rated) public view override returns (int8) {
+        bytes32 hash = keccak256(abi.encodePacked(_rated));
+        // Check if the customer has been rated
+        require(hasBeenRated(_rated), "This customer has not been rated yet.");
+        // Return the customer's rating
+        return _ratings[hash];
     }
 
-    /**
-     *
-     * Internal Functions
-     *
-     */
-
-    /**
-     * @notice Assign a new operator.
-     * @dev Throws is sender is not current operator.
-     * Emits {Appointment} event.
-     * @param newOperator address to be assigned operator authority.
-     */
-    function _setOperator(address newOperator) internal virtual {
-        require(_msgSender() == _operator, "Sender is not operator.");
-        require(newOperator != address(0), "Operator cannot be the zero address.");
-        require(_operator != newOperator, "{address} is already assigned as operator");
-        _operator = newOperator;
-        emit Appointment(newOperator);
+    // Award ETH to a customer based on their rating
+    function awardEth(address payable customer) public payable {
+        // Calculate the amount of ETH to award based on the customer's rating
+        int8 rating = ratingOf(customer);
+        require(rating > 0, "Sorry, this customer has a rating less than 0 and cannot be awarded.");
+        uint256 award = uint256(int256(rating));
+        // Transfer the ETH to the customer
+        require(address(this).balance >= award, "Contract has insufficient balance to award ETH.");
+        customer.transfer(award);
     }
 
-    /**
-     * @notice Sets participation status for `participant`.
-     * @dev Throws if sender is not `participant`.
-     * Emits a {Participation} event.
-     * @param participant Address for which to set participation.
-     * @param participation Requested participation status.
-     */
-    function _participation(address participant, bool participation) internal virtual {
-        require(_msgSender() == participant, "Sender is not {participant}.");
-        require(_msgSender() != _operator, "Operator cannot change participation");
-        require(participant != address(0), "Zero address cannot be removed.");
-        require(_participants[participant] != participation, "Participant already has {participation} status");
-        _participants[participant] = participation;
-        emit Participation(participant, participation);
-    }
+    receive () external payable {}
 
-    /**
-     * @notice Moves `amount` of tokens from `from` address to `to` address.
-     * @dev Throws if sender is not operator.
-     * Throws if `to` is not participating.
-     * Emits a {Transfer} event.
-     * @param from Address from which to transfer. If zero address, then add to totalSupply.
-     * @param to Address to which to transfer. If zero address, then subtract from totalSupply.
-     * @param amount Number of EXP transfer.
-     */
-    function _transfer(
-        address from,
-        address to,
-        uint256 amount
-    ) internal virtual {
-        require(_msgSender() == _operator, "Sender is not the operator.");
-        require(_participants[to] == true, "{to} address is not an active participant.");
-        require(from != to, "{to} and {from} cannot be the same address.");
-        if (from == address(0)) {
-            _totalSupply += amount;
-        } else {
-            require(_balances[from] >= amount, "{from} address holds less EXP than {amount}.");
-            _balances[from] -= amount;
-            if (to == address(0)) {
-                _totalSupply -= amount;
-            }
-        }
-        _balances[to] += amount;
-        emit Transfer(from, to, amount);
-    }
 }
\ No newline at end of file
diff --git a/assets/eip-4974/IERC4974.sol b/assets/eip-4974/IERC4974.sol
index deda31190d9336..8043c6e0f5b6d6 100644
--- a/assets/eip-4974/IERC4974.sol
+++ b/assets/eip-4974/IERC4974.sol
@@ -2,27 +2,26 @@
 
 pragma solidity ^0.8.0;
 
-/// @title ERC-4974 Experience (EXP) Token Standard
+/// @title EIP-4974 Ratings
 /// @dev See https://eips.ethereum.org/EIPS/EIP-4974
-///  Note: the ERC-165 identifier for this interface is 0x696e7752.
+///  Note: the EIP-165 identifier for this interface is #######.
 ///  Must initialize contracts with an `operator` address that is not `address(0)`.
-///  Must initialize contracts assigning participation as `true` for both `operator` and `address(0)`.
 interface IERC4974 /* is ERC165 */ {
 
     /// @dev Emits when operator changes.
     ///  MUST emit when `operator` changes by any mechanism.
     ///  MUST ONLY emit by `setOperator`.
-    event Appointment(address indexed _operator);
+    event NewOperator(address indexed _operator);
 
-    /// @dev Emits when an address activates or deactivates its participation.
-    ///  MUST emit emit when participation status changes by any mechanism.
-    ///  MUST ONLY emit by `setParticipation`.
-    event Participation(address indexed _participant, bool _participation);
+    /// @dev Emits when operator issues a rating. 
+    ///  MUST emit when rating is assigned by any mechanism.
+    ///  MUST ONLY emit by `rate`.
+    event Rating(address _rated, int8 _rating);
 
-    /// @dev Emits when operator transfers EXP. 
-    ///  MUST emit when EXP is transferred by any mechanism.
-    ///  MUST ONLY emit by `transfer`.
-    event Transfer(address indexed _from, address indexed _to, uint256 _amount);
+    /// @dev Emits when operator removes a rating. 
+    ///  MUST emit when rating is removed by any mechanism.
+    ///  MUST ONLY emit by `remove`.
+    event Removal(address _removed);
 
     /// @notice Appoint operator authority.
     /// @dev MUST throw unless `msg.sender` is `operator`.
@@ -32,38 +31,31 @@ interface IERC4974 /* is ERC165 */ {
     /// @param _operator New operator of the smart contract.
     function setOperator(address _operator) external;
 
-    /// @notice Activate or deactivate participation. CALLER IS RESPONSIBLE TO
-    ///  UNDERSTAND THE TERMS OF THEIR PARTICIPATION.
-    /// @dev MUST throw unless `msg.sender` is `participant`.
-    ///  MUST throw if `participant` is `operator` or zero address.
-    ///  MUST emit a `Participation` event for status changes.
-    /// @param _participant Address opting in or out of participation.
-    /// @param _participation Participation status of _participant.
-    function setParticipation(address _participant, bool _participation) external;
+    /// @notice Rate an address.
+    ///  MUST emit a Rating event with each successful call.
+    /// @param _rated Address to be rated.
+    /// @param _rating Total EXP tokens to reallocate.
+    function rate(address _rated, int8 _rating) external;
 
-    /// @notice Transfer EXP from one address to a participating address.
-    /// @dev MUST throw unless `msg.sender` is `operator`.
-    ///  MUST throw unless `to` address is participating.
-    ///  MUST throw if `to` and `from` are the same address.
-    ///  MUST emit a Transfer event with each successful call.
-    ///  SHOULD throw if `amount` is zero.
-    ///  MAY allow minting from zero address, burning to the zero address, 
-    ///  transferring between accounts, and transferring between contracts.
-    ///  MAY limit interaction with non-participating `from` addresses.
-    /// @param _from Address from which to transfer EXP tokens.
-    /// @param _to Address to which EXP tokens at `from` address will transfer.
-    /// @param _amount Total EXP tokens to reallocate.
-    function transfer(address _from, address _to, uint256 _amount) external;
-
-    /// @notice Return total EXP managed by this contract.
-    /// @dev MUST sum EXP tokens of all `participant` addresses, 
-    ///  regardless of participation status, excluding only the zero address.
-    function totalSupply() external view returns (uint256);
+    /// @notice Remove a rating from an address.
+    ///  MUST emit a Remove event with each successful call.
+    /// @param _removed Address to be removed.
+    function removeRating(address _removed) external;
 
-    /// @notice Return total EXP allocated to a participant.
-    /// @dev MUST register each time `Transfer` emits.
+    /// @notice Return a rated address' rating.
+    /// @dev MUST register each time `Rating` emits.
     ///  SHOULD throw for queries about the zero address.
-    /// @param _participant An address for whom to query EXP total.
-    /// @return uint256 The number of EXP allocated to `participant`, possibly zero.
-    function balanceOf(address _participant) external view returns (uint256);
+    /// @param _rated An address for whom to query rating.
+    /// @return int8 The rating assigned.
+    function ratingOf(address _rated) external view returns (int8);
+}
+
+interface IERC165 {
+    /// @notice Query if a contract implements an interface.
+    /// @dev Interface identification is specified in EIP-165. This function
+    ///  uses less than 30,000 gas.
+    /// @param interfaceID The interface identifier, as specified in EIP-165.
+    /// @return bool `true` if the contract implements `interfaceID` and
+    ///  `interfaceID` is not 0xffffffff, `false` otherwise.
+    function supportsInterface(bytes4 interfaceID) external view returns (bool);
 }
\ No newline at end of file

From 0c93c12b94eb26fb385368804892efeae5a67905 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Thu, 15 Dec 2022 01:07:07 -0800
Subject: [PATCH 041/274] Update ERC-5453 (#6140)

* Update 5453

* Update ERC-5453

* Update ERC-5453

* Add assets

* Fix updates

* Fix updates

* Fix updates

* Fix updates
---
 EIPS/eip-5453.md                              | 344 ++++++++++++++----
 assets/eip-5453/AERC5453.sol                  | 271 ++++++++++++++
 assets/eip-5453/EndorsableERC721.sol          |  47 +++
 assets/eip-5453/IERC5453.sol                  |  65 ++++
 .../eip-5453/ThresholdMultiSigForwarder.sol   |  56 +++
 5 files changed, 712 insertions(+), 71 deletions(-)
 create mode 100644 assets/eip-5453/AERC5453.sol
 create mode 100644 assets/eip-5453/EndorsableERC721.sol
 create mode 100644 assets/eip-5453/IERC5453.sol
 create mode 100644 assets/eip-5453/ThresholdMultiSigForwarder.sol

diff --git a/EIPS/eip-5453.md b/EIPS/eip-5453.md
index f14e506fd7fc5d..96d6107f26e710 100644
--- a/EIPS/eip-5453.md
+++ b/EIPS/eip-5453.md
@@ -1,137 +1,339 @@
 ---
 eip: 5453
-title: Smart Contract Crypto Endorsement
-description: A data format for including digital signatures in a smart contract function call.
+title: Endorsement - Permit for Any Functions
+description: A general protocol for approving function calls in the same transaction rely on EIP-5750.
 author: Zainan Victor Zhou (@xinbenlv)
 discussions-to: https://ethereum-magicians.org/t/erc-5453-endorsement-standard/10355
 status: Draft
 type: Standards Track
 category: ERC
 created: 2022-08-12
-requires: 165
+requires: 165, 712, 1271, 5750
 ---
 
 ## Abstract
 
-Provides a format for endorsement of smart contract transactions in the format of extra data (the last bytes field of a method signature).
+This EIP establish a general protocol for permitting approving function calls in the same transaction rely on [EIP-5750](./eip-5750.md).
+Unlike a few prior art ([EIP-2612](./eip-2612.md) for [EIP-20](./eip-20.md), [EIP-4494](./eip-4494.md) for [EIP-721](./eip-721.md) that
+usually only permit for a single behavior (`transfer` for EIP-20 and `safeTransferFrom` for EIP-721) and a single approver in two transactions (first a `permit(...)` TX, then a `transfer`-like TX), this EIP provides a way to permit arbitrary behaviors and aggregating multiple approvals from arbitrary number of approvers in the same transaction, allowing for Multi-Sig or Threshold Signing behavior.
 
+<!-- TODO add context about other EIPs this EIP is designed to work with. -->
 ## Motivation
 
-1. Support a second approval from another user.
-2. Support pay-for-by another user
-3. Support multi-sig
-4. Support persons acting in concert by endorsements
-5. Support accumulated voting
-6. Support off-line signatures
+1. Support permit(approval) alongside a function call.
+2. Support a second approval from another user.
+3. Support pay-for-by another user
+4. Support multi-sig
+5. Support persons acting in concert by endorsements
+6. Support accumulated voting
+7. Support off-line signatures
+
+<!-- TODO add details about Motivations and example use cases -->
 
 ## Specification
 
-The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+### Interfaces
+
+The interfaces and structure referenced here are as followed
+
+<!-- TODO add detail explanation of each method parameters. -->
+
+```solidity
+pragma solidity ^0.8.9;
+
+struct ValidityBound {
+    bytes32 functionParamStructHash;
+    uint256 validSince;
+    uint256 validBy;
+    uint256 nonce;
+}
+
+struct SingleEndorsementData {
+    address endorserAddress; // 32
+    bytes sig; // dynamic = 65
+}
+
+struct GeneralExtensionDataStruct {
+    bytes32 erc5453MagicWord;
+    uint256 erc5453Type;
+    uint256 nonce;
+    uint256 validSince;
+    uint256 validBy;
+    bytes endorsementPayload;
+}
+
+interface IERC5453EndorsementCore {
+    function eip5453Nonce(address endorser) external view returns (uint256);
+    function isEligibleEndorser(address endorser) external view returns (bool);
+}
+
+interface IERC5453EndorsementDigest {
+    function computeValidityDigest(
+        bytes32 _functionParamStructHash,
+        uint256 _validSince,
+        uint256 _validBy,
+        uint256 _nonce
+    ) external view returns (bytes32);
+
+    function computeFunctionParamHash(
+        string memory _functionName,
+        bytes memory _functionParamPacked
+    ) external view returns (bytes32);
+}
+
+interface IERC5453EndorsementDataTypeA {
+    function computeExtensionDataTypeA(
+        uint256 nonce,
+        uint256 validSince,
+        uint256 validBy,
+        address endorserAddress,
+        bytes calldata sig
+    ) external view returns (bytes memory);
+}
 
-1. For any complying method of compliant contract, the last data field MUST be `bytes`.
 
-2. Such data field MUST conform to the following format
-  a) the last 8-bytes MUST be a magic 8-bytes word in the ASCII representation of "ENDORSED"(`0x454e444f52534544`). Implementing method of smart contract that honors smart endorsement MUST deemed a transaction unendorsed by anyone, if the ending 8-bytes doesn't matches with this magic word.
-  b) the last 2-bytes _before_ the `MAGIC_WORLD` MUST be a type-indicator, denoted as `Erc5453FormatType`.
+interface IERC5453EndorsementDataTypeB {
+    function computeExtensionDataTypeB(
+        uint256 nonce,
+        uint256 validSince,
+        uint256 validBy,
+        address[] calldata endorserAddress,
+        bytes[] calldata sigs
+    ) external view returns (bytes memory);
+}
+```
 
-3. For `Erc5453FormatType == FIRST_TYPE_SINGLE_ENDORSER`, in which FIRST_TYPE_SINGLE_ENDORSER = `0x01`, it supports a simple endorsement signature in the following format.
+### Behavior specification
 
-4. Any complying contract MUST at lease implement `FIRST_TYPE_SINGLE_ENDORSER`. Other type number will be used for future extension, such as a multi-endorser scenario.
+As specified in [EIP-5750 General Extensibility for Method Behaviors](./eip-5750.md), any compliant method that has an `bytes extraData` as its
+last method designated for extending behaviors can conform to [EIP-5453](./eip-5453.md) as the way to indicate a permit from certain user.
 
-5. The format of `FIRST_TYPE_SINGLE_ENDORSER` type is
+1. Any compliant method of this EIP MUST be a [EIP-5750](./eip-5750.md) compliant method.
+2. Caller MUST pass in the last parameter `bytes extraData` conforming a solidity memory encoded layout bytes of `GeneralExtensonDataStruct` specified in _Section Interfaces_. The following descriptions are based on when decoding `bytes extraData` into a `GeneralExtensonDataStruct`
+3. In the `GeneralExtensonDataStruct`-decoded `extraData`, caller MUST set the value of `GeneralExtensonDataStruct.erc5453MagicWord` to be the `keccak256("ERC5453-ENDORSEMENT")`.
+4. Caller MUST set the value of `GeneralExtensonDataStruct.erc5453Type` to be one of the supported values.
 
-```text
-endorser_addr || endorser_nonce || valid_by || r , s, v || Erc5453FormatType || MAGIC_WORLD
+```solidity
+uint256 constant ERC5453_TYPE_A = 1;
+uint256 constant ERC5453_TYPE_B = 2;
 ```
 
-Whereas
+5. When the value of `GeneralExtensonDataStruct.erc5453Type` is set to be `ERC5453_TYPE_A`, `GeneralExtensonDataStruct.endorsementPayload` MUST be abi encoded bytes of a `SingleEndorsementData`.
+6. When the value of `GeneralExtensonDataStruct.erc5453Type` is set to be `ERC5453_TYPE_B`, `GeneralExtensonDataStruct.endorsementPayload` MUST be abi encoded bytes of `SingleEndorsementData[]` (a dynamic array).
+
+7. Each `SingleEndorsementData` MUST have a `address endorserAddress;` and a 65-bytes `bytes sig` signature.
 
-- `endorser_addr` an `address` is the address of endorser, length = `32` bytes.
-- `endorser_nonce`, an `uint256` is the nonce of endorser, lenght = `32` bytes.
-- `valid_since`, an `uint256`, since which block number (inclusive) the endorsement is still considered valid. length = `32` bytes.
-- `valid_by`, an `uint256`, until which block number (exclusive) the endorsement is still considered valid. length = `32` bytes.
-- r,s,v are the signatures of ECDSA. `r, s` are the ECDSA recover signature pair. `v`'s last bit carries ECDSA recover Y-Parity. The total length = 32bytes + 32bytes + 1bytes = `65` bytes
+8. Each `bytes sig` MUST be an ECDSA (secp256k1) signature using private key of signer whose corresponding address is `endorserAddress` signing `validityDigest` which is the a hashTypeDataV4 of [EIP-712](./eip-712.md) of hashStruct of `ValidityBound` data structure as followed:
 
-The total length denoted as `LENGTH_OF_ENDORSEMENT` for `FIRST_TYPE_SINGLE_ENDORSER` = 193 bytes`
+```solidity
+bytes32 validityDigest =
+    eip712HashTypedDataV4(
+        keccak256(
+            abi.encode(
+                keccak256(
+                    "ValidityBound(bytes32 functionParamStructHash,uint256 validSince,uint256 validBy,uint256 nonce)"
+                ),
+                functionParamStructHash,
+                _validSince,
+                _validBy,
+                _nonce
+            )
+        )
+    );
+```
+<!-- TODO convert the solidity code into mathematical representation. -->
 
-6. Complying contract MUST emit the following `OnEndorsed` event when a transaction is executed because of the endorsement. Complying contract MUST NOT emit such event when a transaction is executed without taking account of the endorsement.
+9. The `functionParamStructHash` MUST be computed as followed
 
 ```solidity
-event OnEndorsed(byte4 indexed methodSelector, address[] memory endorsers);
+        bytes32 functionParamStructHash = keccak256(
+            abi.encodePacked(
+                keccak256(bytes(_functionStructure)),
+                _functionParamPacked
+            )
+        );
+        return functionParamStructHash;
 ```
 
+whereas
+
+- `_functionStructure` MUST be computed as `function methodName(type1 param1, type2 param2, ...)`.
+- `_functionParamPacked` MUST be computed as `enc(param1) || enco(param2) ...`
+
+10. Upon validating that `endorserAddress == ecrecover(validityDigest, signature)` or `EIP1271(endorserAddress).isValidSignature(validityDigest, signature) == ERC1271.MAGICVALUE`, the single endorsement MUST be deemed valid.
+11. Compliant method MAY choose to impose a threshold for a number of endorsements needs to be valid in the same `ERC5453_TYPE_B` kind of `endorsementPayload`.
+
+12. The `validSince` and `validBy` are both inclusive. Implementer MAY choose to use blocknumber or timestamp. Implementor SHOULD find away to indicate whether `validSince` and `validBy` is blocknumber or timestamp.
+
 ## Rationale
 
-1. Originally we considered adding the endorsement at the first part of `extraData`. We turn into adding the endorsement to the ending of data, which allows the following future extensions such as:
+1. We chose to have both `ERC5453_TYPE_A`(single-endorsement) and `ERC5453_TYPE_B`(multiple-endorsements, same nonce for entire contract) so we
+could balance a wider range of use cases. E.g. the same use cases of EIP-2612 and EIP-4494 can be supported by `ERC5453_TYPE_A`. And threshold approvals can be done via `ERC5453_TYPE_B`. More complicated approval types can also be extended by defining new `ERC5453_TYPE_?`
+
+2. We chose to include both `validSince` and `validBy` to allow maximum flexibility in expiration. This can be also be supported by EVM natively at  if adopted [EIP-5081](./eip-5081.md) but EIP-5081 will not be adopted anytime soon, we choose to add these two numbers in our protocol to allow
+smart contract level support.
 
-- Allow general endorsable be applied
-- Allow nested endorsements
 
 
-> TODO consider adopt [EIP-5679](./eip-5679.md)
 ## Backwards Compatibility
 
 The design assumes a `bytes calldata extraData` to maximize the flexibility of future extensions. This assumption is compatible with [EIP-721](eip-721.md), [EIP-1155](eip-1155.md) and many other ERC-track EIPs. Those that aren't, such as [EIP-20](./eip-20.md), can also be updated to support it, such as using a wrapper contract or proxy upgrade.
 
 ## Reference Implementation
 
+In addition to the specified algorithm for validating endorser signatures, we also present the following reference implementations.
+
 ```solidity
-// Macro is not supported yet in
-// Implementer can just replicate the following expansion by hand until
-// The macro is supported in solidity.
-#define REMAIN_LENGTH extraData.length - LENGTH_OF_ENDORSEMENT;
-
-abstract contract ERC5453 {
-    modifier onlyEndorsed(bytes32 _msgDigest, bytes calldata _end/**orsement**/) {
-        require(_end.length == LENGTH_OF_ENDORSEMENT);
-        require(_end[_end.length - 8:] == MAGIC_WORLD);
-
-
-        // ERC-1271 prefix. See https://eips.ethereum.org/EIPS/eip-1271
-        string memory erc1271Prefix = "\x19Ethereum Signed Message:\n32";
-        bytes32 erc1271Hash = keccak256(abi.encodePacked(erc1271Prefix, _msgDigest));
-        address endorser = ecrecover(erc1271Hash,
-            uint8(_end[128]), // v
-            bytes32(_end[64:96]), // r
-            bytes32(_eSig[96:128]) // s
+pragma solidity ^0.8.9;
+
+import "@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol";
+import "@openzeppelin/contracts/utils/cryptography/EIP712.sol";
+
+import "./IERC5453.sol";
+
+abstract contract AERC5453Endorsible is EIP712,
+    IERC5453EndorsementCore, IERC5453EndorsementDigest, IERC5453EndorsementDataTypeA, IERC5453EndorsementDataTypeB {
+    // ...
+
+    function _validate(
+        bytes32 msgDigest,
+        SingleEndorsementData memory endersement
+    ) internal virtual {
+        require(
+            endersement.sig.length == 65,
+            "AERC5453Endorsible: wrong signature length"
+        );
+        require(
+            SignatureChecker.isValidSignatureNow(
+                endersement.endorserAddress,
+                msgDigest,
+                endersement.sig
+            ),
+            "AERC5453Endorsible: invalid signature"
         );
-        // _isEligibleEndorser is application specific.
-        require (_isEligibleEndorser(endorser), "Endorser is not eligible to transfer.");
+    }
+    // ...
+
+    modifier onlyEndorsed(
+        bytes32 _functionParamStructHash,
+        bytes calldata _extensionData
+    ) {
+        require(_isEndorsed(_functionParamStructHash, _extensionData));
         _;
     }
+
+    function computeExtensionDataTypeB(
+        uint256 nonce,
+        uint256 validSince,
+        uint256 validBy,
+        address[] calldata endorserAddress,
+        bytes[] calldata sigs
+    ) external pure override returns (bytes memory) {
+        require(endorserAddress.length == sigs.length);
+        SingleEndorsementData[]
+            memory endorsements = new SingleEndorsementData[](
+                endorserAddress.length
+            );
+        for (uint256 i = 0; i < endorserAddress.length; ++i) {
+            endorsements[i] = SingleEndorsementData(
+                endorserAddress[i],
+                sigs[i]
+            );
+        }
+        return
+            abi.encode(
+                GeneralExtensionDataStruct(
+                    MAGIC_WORLD,
+                    ERC5453_TYPE_B,
+                    nonce,
+                    validSince,
+                    validBy,
+                    abi.encode(endorsements)
+                )
+            );
+    }
 }
 
-contract EndorsableERC721 is SomeERC721, ERC5453 {
-  function safeTransferFrom(
-    address from,
-    address to,
-    uint256 id,
-    bytes calldata extraData)
+```
 
-    onlyEndorsed(  // used as modifier
-        keccak256(
-            abi.encodePacked(
-                from, to, id, amount,
-                extraData[:REMAIN_LENGTH], // first part of extraData is reserved for original use for extraData unendorsed.
-                extraData[REMAIN_LENGTH: REMAIN_LENGTH + 32], // nonce of endorsement for the {contract, endorser} combination
-                extraData[REMAIN_LENGTH + 32: REMAIN_LENGTH + 64], // valid_by for the endorsement
+### Reference Implementation of `EndorsableERC721`
+
+Here is a reference implementation of `EndorsableERC721` that achieves similar behavior of [EIP-4494](./eip-4494.md).
+
+```solidity
+pragma solidity ^0.8.9;
+
+contract EndorsableERC721 is ERC721, AERC5453Endorsible {
+    //...
+
+    function mint(
+        address _to,
+        uint256 _tokenId,
+        bytes calldata _extraData
+    )
+        external
+        onlyEndorsed(
+            _computeFunctionParamHash(
+                "function mint(address _to,uint256 _tokenId)",
+                abi.encode(_to, _tokenId)
             ),
-        data[REMAIN_LENGTH:] // the endorsement component
-    ) {
-    super.safeTransferFrom(from, to, id, extraData[:REMAIN_LENGTH]); // original
-  }
+            _extraData
+        )
+    {
+        _mint(_to, _tokenId);
+    }
+}
+```
+
+### Reference Implementation of `ThresholdMultiSigForwarder`
+
+Here is a reference implementation of ThresholdMultiSigForwarder that achieves similar behavior of multi-sig threshold approval
+remote contract call like a Gnosis-Safe wallet.
+
+```solidity
+pragma solidity ^0.8.9;
+
+contract ThresholdMultiSigForwarder is AERC5453Endorsible {
+    //...
+    function forward(
+        address _dest,
+        uint256 _value,
+        uint256 _gasLimit,
+        bytes calldata _calldata,
+        bytes calldata _extraData
+    )
+        external
+        onlyEndorsed(
+            _computeFunctionParamHash(
+                "function forward(address _dest,uint256 _value,uint256 _gasLimit,bytes calldata _calldata)",
+                abi.encode(_dest, _value, _gasLimit, keccak256(_calldata))
+            ),
+            _extraData
+        )
+    {
+        string memory errorMessage = "Fail to call remote contract";
+        (bool success, bytes memory returndata) = _dest.call{value: _value}(
+            _calldata
+        );
+        Address.verifyCallResult(success, returndata, errorMessage);
+    }
+
 }
+
 ```
 
 ## Security Considerations
 
 ### Replay Attacks
 
-A replay attack is a type of attack on cryptography authentication. In a narrow sense, it usually refers to a type of attack that circumvents the cryptographically signature verification by reusing an existing signature for a message being signed again. Any implementations relying on this EIP must realize that all smart endorsements described here are cryptographic signatures that are *public* and can be obtained by anyone. They must foresee the possibility of a replay of the transactions not only at the exact deployment of the same smart contract, but also other deployments of similar smart contracts, or of a version of the same contract on another `chainId`, or any other similar attack surfaces. The `nonce`, `valid_since`, and `valid_by` fields are meant to restrict the surface of attack but might not fully eliminate the risk of all such attacks, e.g. see the [Phishing](#phishing) section.
+A replay attack is a type of attack on cryptography authentication. In a narrow sense, it usually refers to a type of attack that circumvents the cryptographically signature verification by reusing an existing signature for a message being signed again. Any implementations relying on this EIP must realize that all smart endorsements described here are cryptographic signatures that are _public_ and can be obtained by anyone. They must foresee the possibility of a replay of the transactions not only at the exact deployment of the same smart contract, but also other deployments of similar smart contracts, or of a version of the same contract on another `chainId`, or any other similar attack surfaces. The `nonce`, `validSince`, and `validBy` fields are meant to restrict the surface of attack but might not fully eliminate the risk of all such attacks, e.g. see the [Phishing](#phishing) section.
 
 ### Phishing
 
 It's worth pointing out a special form of replay attack by phishing. An adversary can design another smart contract in a way that the user be tricked into signing a smart endorsement for a seemingly legitimate purpose, but the data-to-designed matches the target application
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-5453/AERC5453.sol b/assets/eip-5453/AERC5453.sol
new file mode 100644
index 00000000000000..f3b4d762a68669
--- /dev/null
+++ b/assets/eip-5453/AERC5453.sol
@@ -0,0 +1,271 @@
+// SPDX-License-Identifier: CC0.0 OR Apache-2.0
+// Author: Zainan Victor Zhou <zzn-ercref@zzn.im>
+// See a full runnable hardhat project in https://github.com/ercref/ercref-contracts/tree/main/ERCs/eip-5453
+pragma solidity ^0.8.9;
+
+import "@openzeppelin/contracts/utils/cryptography/SignatureChecker.sol";
+import "@openzeppelin/contracts/utils/cryptography/EIP712.sol";
+
+import "./IERC5453.sol";
+
+abstract contract AERC5453Endorsible is EIP712,
+    IERC5453EndorsementCore, IERC5453EndorsementDigest, IERC5453EndorsementDataTypeA, IERC5453EndorsementDataTypeB {
+    uint256 private threshold;
+    uint256 private currentNonce = 0;
+    bytes32 constant MAGIC_WORLD = keccak256("ERC5453-ENDORSEMENT"); // ASCII of "ENDORSED"
+    uint256 constant ERC5453_TYPE_A = 1;
+    uint256 constant ERC5453_TYPE_B = 2;
+
+    constructor(
+        string memory _name,
+        string memory _erc721Version
+    ) EIP712(_name, _erc721Version) {}
+
+    function _validate(
+        bytes32 msgDigest,
+        SingleEndorsementData memory endersement
+    ) internal virtual {
+        require(
+            endersement.sig.length == 65,
+            "AERC5453Endorsible: wrong signature length"
+        );
+        require(
+            SignatureChecker.isValidSignatureNow(
+                endersement.endorserAddress,
+                msgDigest,
+                endersement.sig
+            ),
+            "AERC5453Endorsible: invalid signature"
+        );
+    }
+
+    function _extractEndorsers(
+        bytes32 digest,
+        GeneralExtensionDataStruct memory data
+    ) internal virtual returns (address[] memory endorsers) {
+        require(
+            data.erc5453MagicWord == MAGIC_WORLD,
+            "AERC5453Endorsible: MagicWord not matched"
+        );
+        require(
+            data.validSince <= block.number,
+            "AERC5453Endorsible: Not valid yet"
+        ); // TODO consider per-Endorser validSince
+        require(data.validBy >= block.number, "AERC5453Endorsible: Expired"); // TODO consider per-Endorser validBy
+        require(
+            currentNonce == data.nonce,
+            "AERC5453Endorsible: Nonce not matched"
+        ); // TODO consider per-Endorser nonce or range of nonce
+        currentNonce += 1;
+
+        if (data.erc5453Type == ERC5453_TYPE_A) {
+            SingleEndorsementData memory endersement = abi.decode(
+                data.endorsementPayload,
+                (SingleEndorsementData)
+            );
+            endorsers = new address[](1);
+            endorsers[0] = endersement.endorserAddress;
+            _validate(digest, endersement);
+        } else if (data.erc5453Type == ERC5453_TYPE_B) {
+            SingleEndorsementData[] memory endorsements = abi.decode(
+                data.endorsementPayload,
+                (SingleEndorsementData[])
+            );
+            endorsers = new address[](endorsements.length);
+            for (uint256 i = 0; i < endorsements.length; ++i) {
+                endorsers[i] = endorsements[i].endorserAddress;
+                _validate(digest, endorsements[i]);
+            }
+            return endorsers;
+        }
+    }
+
+    function _decodeExtensionData(
+        bytes memory extensionData
+    ) internal pure virtual returns (GeneralExtensionDataStruct memory) {
+        return abi.decode(extensionData, (GeneralExtensionDataStruct));
+    }
+
+    // Well, I know this is epensive. Let's improve it later.
+    function _noRepeat(address[] memory _owners) internal pure returns (bool) {
+        for (uint256 i = 0; i < _owners.length; i++) {
+            for (uint256 j = i + 1; j < _owners.length; j++) {
+                if (_owners[i] == _owners[j]) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+
+    function _isEndorsed(
+        bytes32 _functionParamStructHash,
+        bytes calldata _extraData
+    ) internal returns (bool) {
+        GeneralExtensionDataStruct memory _data = _decodeExtensionData(
+            _extraData
+        );
+        bytes32 finalDigest = _computeValidityDigest(
+            _functionParamStructHash,
+            _data.validSince,
+            _data.validBy,
+            _data.nonce
+        );
+
+        address[] memory endorsers = _extractEndorsers(finalDigest, _data);
+        require(
+            endorsers.length >= threshold,
+            "AERC5453Endorsable: not enough endorsers"
+        );
+        require(_noRepeat(endorsers));
+        for (uint256 i = 0; i < endorsers.length; i++) {
+            require(
+                _isEligibleEndorser(endorsers[i]),
+                "AERC5453Endorsable: not eligible endorsers"
+            ); // everyone must be a legit endorser
+        }
+        return true;
+    }
+
+    function _isEligibleEndorser(
+        address /*_endorser*/
+    ) internal view virtual returns (bool);
+
+    modifier onlyEndorsed(
+        bytes32 _functionParamStructHash,
+        bytes calldata _extensionData
+    ) {
+        require(_isEndorsed(_functionParamStructHash, _extensionData));
+        _;
+    }
+
+    function _computeValidityDigest(
+        bytes32 _functionParamStructHash,
+        uint256 _validSince,
+        uint256 _validBy,
+        uint256 _nonce
+    ) internal view returns (bytes32) {
+        return
+            super._hashTypedDataV4(
+                keccak256(
+                    abi.encode(
+                        keccak256(
+                            "ValidityBound(bytes32 functionParamStructHash,uint256 validSince,uint256 validBy,uint256 nonce)"
+                        ),
+                        _functionParamStructHash,
+                        _validSince,
+                        _validBy,
+                        _nonce
+                    )
+                )
+            );
+    }
+
+    function _computeFunctionParamHash(
+        string memory _functionStructure,
+        bytes memory _functionParamPacked
+    ) internal pure returns (bytes32) {
+        bytes32 functionParamStructHash = keccak256(
+            abi.encodePacked(
+                keccak256(bytes(_functionStructure)),
+                _functionParamPacked
+            )
+        );
+        return functionParamStructHash;
+    }
+
+    function _setThreshold(uint256 _threshold) internal virtual {
+        threshold = _threshold;
+    }
+
+    function computeValidityDigest(
+        bytes32 _functionParamStructHash,
+        uint256 _validSince,
+        uint256 _validBy,
+        uint256 _nonce
+    ) external view override returns (bytes32) {
+        return
+            _computeValidityDigest(
+                _functionParamStructHash,
+                _validSince,
+                _validBy,
+                _nonce
+            );
+    }
+
+    function computeFunctionParamHash(
+        string memory _functionName,
+        bytes memory _functionParamPacked
+    ) external pure override returns (bytes32) {
+        return
+            _computeFunctionParamHash(
+                _functionName,
+                _functionParamPacked
+            );
+    }
+
+    function eip5453Nonce(address addr) external view override returns (uint256) {
+        require(address(this) == addr, "AERC5453Endorsable: not self");
+        return currentNonce;
+    }
+
+    function isEligibleEndorser(address _endorser)
+        external
+        view
+        override
+        returns (bool)
+    {
+        return _isEligibleEndorser(_endorser);
+    }
+
+    function computeExtensionDataTypeA(
+        uint256 nonce,
+        uint256 validSince,
+        uint256 validBy,
+        address endorserAddress,
+        bytes calldata sig
+    ) external pure override returns (bytes memory) {
+        return
+            abi.encode(
+                GeneralExtensionDataStruct(
+                    MAGIC_WORLD,
+                    ERC5453_TYPE_A,
+                    nonce,
+                    validSince,
+                    validBy,
+                    abi.encode(SingleEndorsementData(endorserAddress, sig))
+                )
+            );
+    }
+
+    function computeExtensionDataTypeB(
+        uint256 nonce,
+        uint256 validSince,
+        uint256 validBy,
+        address[] calldata endorserAddress,
+        bytes[] calldata sigs
+    ) external pure override returns (bytes memory) {
+        require(endorserAddress.length == sigs.length);
+        SingleEndorsementData[]
+            memory endorsements = new SingleEndorsementData[](
+                endorserAddress.length
+            );
+        for (uint256 i = 0; i < endorserAddress.length; ++i) {
+            endorsements[i] = SingleEndorsementData(
+                endorserAddress[i],
+                sigs[i]
+            );
+        }
+        return
+            abi.encode(
+                GeneralExtensionDataStruct(
+                    MAGIC_WORLD,
+                    ERC5453_TYPE_B,
+                    nonce,
+                    validSince,
+                    validBy,
+                    abi.encode(endorsements)
+                )
+            );
+    }
+}
diff --git a/assets/eip-5453/EndorsableERC721.sol b/assets/eip-5453/EndorsableERC721.sol
new file mode 100644
index 00000000000000..3299ef8fac527d
--- /dev/null
+++ b/assets/eip-5453/EndorsableERC721.sol
@@ -0,0 +1,47 @@
+/// SPDX-License-Identifier: CC0.0 OR Apache-2.0
+// Author: Zainan Victor Zhou <zzn-ercref@zzn.im>
+// See a full runnable hardhat project in https://github.com/ercref/ercref-contracts/tree/main/ERCs/eip-5453
+pragma solidity ^0.8.9;
+
+import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+
+import "./AERC5453.sol";
+
+contract EndorsableERC721 is ERC721, AERC5453Endorsible {
+    mapping(address => bool) private owners;
+
+    constructor()
+        ERC721("ERC721ForTesting", "ERC721ForTesting")
+        AERC5453Endorsible("EndorsableERC721", "v1")
+    {
+        owners[msg.sender] = true;
+    }
+
+    function addOwner(address _owner) external {
+        require(owners[msg.sender], "EndorsableERC721: not owner");
+        owners[_owner] = true;
+    }
+
+    function mint(
+        address _to,
+        uint256 _tokenId,
+        bytes calldata _extraData
+    )
+        external
+        onlyEndorsed(
+            _computeFunctionParamHash(
+                "function mint(address _to,uint256 _tokenId)",
+                abi.encode(_to, _tokenId)
+            ),
+            _extraData
+        )
+    {
+        _mint(_to, _tokenId);
+    }
+
+    function _isEligibleEndorser(
+        address _endorser
+    ) internal view override returns (bool) {
+        return owners[_endorser];
+    }
+}
diff --git a/assets/eip-5453/IERC5453.sol b/assets/eip-5453/IERC5453.sol
new file mode 100644
index 00000000000000..d51df706cb0783
--- /dev/null
+++ b/assets/eip-5453/IERC5453.sol
@@ -0,0 +1,65 @@
+// SPDX-License-Identifier: CC0.0 OR Apache-2.0
+// Author: Zainan Victor Zhou <zzn-ercref@zzn.im>
+// See a full runnable hardhat project in https://github.com/ercref/ercref-contracts/tree/main/ERCs/eip-5453
+pragma solidity ^0.8.9;
+
+struct ValidityBound {
+    bytes32 functionParamStructHash;
+    uint256 validSince;
+    uint256 validBy;
+    uint256 nonce;
+}
+
+struct SingleEndorsementData {
+    address endorserAddress; // 32
+    bytes sig; // dynamic = 65
+}
+
+struct GeneralExtensionDataStruct {
+    bytes32 erc5453MagicWord;
+    uint256 erc5453Type;
+    uint256 nonce;
+    uint256 validSince;
+    uint256 validBy;
+    bytes endorsementPayload;
+}
+
+interface IERC5453EndorsementCore {
+    function eip5453Nonce(address endorser) external view returns (uint256);
+    function isEligibleEndorser(address endorser) external view returns (bool);
+}
+
+interface IERC5453EndorsementDigest {
+    function computeValidityDigest(
+        bytes32 _functionParamStructHash,
+        uint256 _validSince,
+        uint256 _validBy,
+        uint256 _nonce
+    ) external view returns (bytes32);
+
+    function computeFunctionParamHash(
+        string memory _functionName,
+        bytes memory _functionParamPacked
+    ) external view returns (bytes32);
+}
+
+interface IERC5453EndorsementDataTypeA {
+    function computeExtensionDataTypeA(
+        uint256 nonce,
+        uint256 validSince,
+        uint256 validBy,
+        address endorserAddress,
+        bytes calldata sig
+    ) external view returns (bytes memory);
+}
+
+
+interface IERC5453EndorsementDataTypeB {
+    function computeExtensionDataTypeB(
+        uint256 nonce,
+        uint256 validSince,
+        uint256 validBy,
+        address[] calldata endorserAddress,
+        bytes[] calldata sigs
+    ) external view returns (bytes memory);
+}
diff --git a/assets/eip-5453/ThresholdMultiSigForwarder.sol b/assets/eip-5453/ThresholdMultiSigForwarder.sol
new file mode 100644
index 00000000000000..c366e6dcd47d5e
--- /dev/null
+++ b/assets/eip-5453/ThresholdMultiSigForwarder.sol
@@ -0,0 +1,56 @@
+// SPDX-License-Identifier: CC0.0 OR Apache-2.0
+// Author: Zainan Victor Zhou <zzn-ercref@zzn.im>
+// See a full runnable hardhat project in https://github.com/ercref/ercref-contracts/tree/main/ERCs/eip-5453
+pragma solidity ^0.8.9;
+
+import "./AERC5453.sol";
+
+contract ThresholdMultiSigForwarder is AERC5453Endorsible {
+    mapping(address => bool) private owners;
+    uint256 private ownerCount;
+
+    constructor() AERC5453Endorsible("ThresholdMultiSigForwarder", "v1") {}
+
+    function initialize(
+        address[] calldata _owners,
+        uint256 _threshold
+    ) external {
+        require(_threshold >= 1, "Threshold must be positive");
+        require(_owners.length >= _threshold);
+        require(_noRepeat(_owners));
+        _setThreshold(_threshold);
+        for (uint256 i = 0; i < _owners.length; i++) {
+            owners[_owners[i]] = true;
+        }
+        ownerCount = _owners.length;
+    }
+
+    function forward(
+        address _dest,
+        uint256 _value,
+        uint256 _gasLimit,
+        bytes calldata _calldata,
+        bytes calldata _extraData
+    )
+        external
+        onlyEndorsed(
+            _computeFunctionParamHash(
+                "function forward(address _dest,uint256 _value,uint256 _gasLimit,bytes calldata _calldata)",
+                abi.encode(_dest, _value, _gasLimit, keccak256(_calldata))
+            ),
+            _extraData
+        )
+    {
+        string memory errorMessage = "Fail to call remote contract";
+        (bool success, bytes memory returndata) = _dest.call{value: _value}(
+            _calldata
+        );
+        Address.verifyCallResult(success, returndata, errorMessage);
+    }
+
+    function _isEligibleEndorser(
+        address _endorser
+    ) internal view override returns (bool) {
+        return owners[_endorser] == true;
+    }
+}

From bd12378062fb7a51bec8e1a68e0b9fa24ec5ca5e Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Thu, 15 Dec 2022 01:16:53 -0800
Subject: [PATCH 042/274] Fix updates (#6141)

---
 EIPS/eip-5453.md | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-5453.md b/EIPS/eip-5453.md
index 96d6107f26e710..322cc3b2ceced4 100644
--- a/EIPS/eip-5453.md
+++ b/EIPS/eip-5453.md
@@ -105,6 +105,8 @@ interface IERC5453EndorsementDataTypeB {
 }
 ```
 
+See [`IERC5453.sol`](../assets/eip-5453/IERC5453.sol).
+
 ### Behavior specification
 
 As specified in [EIP-5750 General Extensibility for Method Behaviors](./eip-5750.md), any compliant method that has an `bytes extraData` as its
@@ -175,8 +177,6 @@ could balance a wider range of use cases. E.g. the same use cases of EIP-2612 an
 2. We chose to include both `validSince` and `validBy` to allow maximum flexibility in expiration. This can be also be supported by EVM natively at  if adopted [EIP-5081](./eip-5081.md) but EIP-5081 will not be adopted anytime soon, we choose to add these two numbers in our protocol to allow
 smart contract level support.
 
-
-
 ## Backwards Compatibility
 
 The design assumes a `bytes calldata extraData` to maximize the flexibility of future extensions. This assumption is compatible with [EIP-721](eip-721.md), [EIP-1155](eip-1155.md) and many other ERC-track EIPs. Those that aren't, such as [EIP-20](./eip-20.md), can also be updated to support it, such as using a wrapper contract or proxy upgrade.
@@ -258,6 +258,8 @@ abstract contract AERC5453Endorsible is EIP712,
 
 ```
 
+See [`AERC5453.sol`](../assets/eip-5453/AERC5453.sol)
+
 ### Reference Implementation of `EndorsableERC721`
 
 Here is a reference implementation of `EndorsableERC721` that achieves similar behavior of [EIP-4494](./eip-4494.md).
@@ -287,6 +289,8 @@ contract EndorsableERC721 is ERC721, AERC5453Endorsible {
 }
 ```
 
+See [`EndorsableERC721.sol`](../assets/eip-5453/EndorsableERC721.sol)
+
 ### Reference Implementation of `ThresholdMultiSigForwarder`
 
 Here is a reference implementation of ThresholdMultiSigForwarder that achieves similar behavior of multi-sig threshold approval
@@ -324,6 +328,8 @@ contract ThresholdMultiSigForwarder is AERC5453Endorsible {
 
 ```
 
+See [`ThresholdMultiSigForwarder.sol`](../assets/eip-5453/ThresholdMultiSigForwarder.sol)
+
 ## Security Considerations
 
 ### Replay Attacks

From 55b5fc2ce4a7a8d11ad0f85d55bf04d66ade1ffe Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Thu, 15 Dec 2022 10:22:21 +0100
Subject: [PATCH 043/274] Add EIP-6059: Parent-Governed Nestable Non-Fungible
 Tokens standard (#6059)

* Propose Parent-Governed Nestable Non-Fungible Tokens standard

RMRK team has developed a next step in NFT evolution where one NFT can
own and manage other NFTs.

* Assign EIP number

EIP number 6059 was assigned as this is the number of the PR to add this
proposal.

This was doen before being assigned the EIP number by one of the editors
based on the common practice of assigning EIP numbers based on the PR
number at which the proposal was added. In case the number of the
proposal should be different, the number can easiliy be changed.

* Add discussion URI and minor text-fixes

The discussion URI was added and some minor text fixes addressed.

* Update examples references

* Update EIPS/eip-6059.md

Uses "account" instead of "EOA"

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Apply grammar suggestions from code review

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

Co-authored-by: Steven Pineda <steven2308@outlook.com>
Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-6059.md                              |  532 ++++++
 assets/eip-6059/contracts/INestable.sol       |  113 ++
 assets/eip-6059/contracts/NestableToken.sol   | 1468 +++++++++++++++++
 .../eip-6059/contracts/mocks/ERC721Mock.sol   |   16 +
 .../contracts/mocks/NestableTokenMock.sol     |   36 +
 assets/eip-6059/hardhat.config.ts             |   21 +
 assets/eip-6059/package.json                  |   41 +
 assets/eip-6059/test/nestable.ts              | 1158 +++++++++++++
 8 files changed, 3385 insertions(+)
 create mode 100644 EIPS/eip-6059.md
 create mode 100644 assets/eip-6059/contracts/INestable.sol
 create mode 100644 assets/eip-6059/contracts/NestableToken.sol
 create mode 100644 assets/eip-6059/contracts/mocks/ERC721Mock.sol
 create mode 100644 assets/eip-6059/contracts/mocks/NestableTokenMock.sol
 create mode 100644 assets/eip-6059/hardhat.config.ts
 create mode 100644 assets/eip-6059/package.json
 create mode 100644 assets/eip-6059/test/nestable.ts

diff --git a/EIPS/eip-6059.md b/EIPS/eip-6059.md
new file mode 100644
index 00000000000000..fe98f0b0fd8a51
--- /dev/null
+++ b/EIPS/eip-6059.md
@@ -0,0 +1,532 @@
+---
+eip: 6059
+title: Parent-Governed Nestable Non-Fungible Tokens
+description: An interface for Nestable Non-Fungible Tokens with emphasis on parent token's control over the relationship.
+author: Bruno Škvorc (@Swader), Cicada (@CicadaNCR), Steven Pineda (@steven2308), Stevan Bogosavljevic (@stevyhacker), Jan Turk (@ThunderDeliverer)
+discussions-to: https://ethereum-magicians.org/t/eip-6059-parent-governed-nestable-non-fungible-tokens/11914
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-11-15
+requires: 165, 721
+---
+
+## Abstract
+
+The Parent-Governed Nestable NFT standard extends [EIP-721](./eip-721.md) by allowing for a new inter-NFT relationship and interaction.
+
+At its core, the idea behind the proposal is simple: the owner of an NFT does not have to be an Externally Owned Account (EOA) or a smart contract, it can also be an NFT.
+
+The process of nesting an NFT into another is functionally identical to sending it to another user. The process of sending a token out of another one involves issuing a transaction from the account owning the parent token.
+
+An NFT can be owned by a single other NFT, but can in turn have a number of NFTs that it owns. This proposal establishes the framework for the parent-child relationships of NFTs. A parent token is the one that owns another token. A child token is a token that is owned by another token. A token can be both a parent and child at the same time. Child tokens of a given token can be fully managed by the parent token's owner, but can be proposed by anyone.
+
+```mermaid
+graph LR
+    Z(EOA owning parent NFT) --> A[Parent NFT]
+    A --> B[Child NFT]
+    A --> C[Child NFT]
+    A --> D[Child NFT]
+    C --> E[Child's child NFT]
+    C --> F[Child's child NFT]
+    C --> G[Child's child NFT]
+```
+
+The graph illustrates how a child token can also be a parent token, but both are still administered by the root parent token's owner.
+
+## Motivation
+
+With NFTs being a widespread form of tokens in the Ethereum ecosystem and being used for a variety of use cases, it is time to standardize additional utility for them. Having the ability for tokens to own other tokens allows for greater utility, usability and forward compatibility.
+
+In the four years since [EIP-721](./eip-721.md) was published, the need for additional functionality has resulted in countless extensions. This EIP improves upon EIP-721 in the following areas:
+
+- [Bundling](#bundling)
+- [Collecting](#collecting)
+- [Membership](#membership)
+- [Delegation](#delegation)
+
+### Bundling
+
+One of the most frequent uses of [EIP-721](./eip-721.md) is to disseminate the multimedia content that is tied to the tokens. In the event that someone wants to offer a bundle of NFTs from various collections, there is currently no easy way of bundling all of these together and handle their sale as a single transaction. This proposal introduces a standardized way of doing so. Nesting all of the tokens into a simple bundle and selling that bundle would transfer the control of all of the tokens to the buyer in a single transaction.
+
+### Collecting
+
+A lot of NFT consumers collect them based on countless criteria. Some aim for utility of the tokens, some for the uniqueness, some for the visual appeal, etc. There is no standardized way to group the NFTs tied to a specific account. By nesting NFTs based on their owner's preference, this proposal introduces the ability to do it. The root parent token could represent a certain group of tokens and all of the children nested into it would belong to it.
+
+The rise of soulbound, non-transferable, tokens, introduces another need for this proposal. Having a token with multiple soulbound traits (child tokens), allows for numerous use cases. One concrete example of this can be drawn from supply trains use case. A shipping container, represented by an NFT with its own traits, could have multiple child tokens denoting each leg of its journey.
+
+### Membership
+
+A common utility attached to NFTs is a membership to a Decentralised Autonomous Organization (DAO) or to some other closed-access group. Some of these organizations and groups occasionally mint NFTs to the current holders of the membership NFTs. With the ability to nest mint a token into a token, such minting could be simplified, by simply minting the bonus NFT directly into the membership one.
+
+### Delegation
+
+One of the core features of DAOs is voting and there are various approaches to it. One such mechanic is using fungible voting tokens where members can delegate their votes by sending these tokens to another member. Using this proposal, delegated voting could be handled by nesting your voting NFT into the one you are delegating your votes to and transferring it when the member no longer wishes to delegate their votes.
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
+
+```solidity
+/// @title EIP-6059 Parent-Governed Nestable Non-Fungible Tokens
+/// @dev See https://eips.ethereum.org/EIPS/eip-6059
+/// @dev Note: the ERC-165 identifier for this interface is 0x60b766e5.
+
+pragma solidity ^0.8.16;
+
+interface INestable {
+    /**
+     * @notice The core struct of ownership.
+     * @dev The `DirectOwner` struct is used to store information of the next immediate owner, be it the parent token,
+     * an `ERC721Receiver` contract or an externally owned account.
+     * @dev If the token is not owned by an NFT, the `tokenId` MUST equal `0`.
+     * @param tokenId ID of the parent token
+     * @param ownerAddress Address of the owner of the token. If the owner is another token, then the address MUST be
+     *  the one of the parent token's collection smart contract. If the owner is externally owned account, the address
+     *  MUST be the address of this account
+     * @param isNft A boolean value signifying whether the token is owned by another token (`true`) or by an externally
+     *  owned account (`false`)
+     */
+    struct DirectOwner {
+        uint256 tokenId;
+        address ownerAddress;
+        bool isNft;
+    }
+
+    /**
+     * @notice Used to notify listeners that the token is being transferred.
+     * @dev Emitted when `tokenId` token is transferred from `from` to `to`.
+     * @param from Address of the previous immediate owner, which is a smart contract if the token was nested.
+     * @param to Address of the new immediate owner, which is a smart contract if the token is being nested.
+     * @param fromTokenId ID of the previous parent token. If the token was not nested before, the value MUST be `0`
+     * @param toTokenId ID of the new parent token. If the token is not being nested, the value MUST be `0`
+     * @param tokenId ID of the token being transferred
+     */
+    event NestTransfer(
+        address indexed from,
+        address indexed to,
+        uint256 fromTokenId,
+        uint256 toTokenId,
+        uint256 indexed tokenId
+    );
+
+    /**
+     * @notice Used to notify listeners that a new token has been added to a given token's pending children array.
+     * @dev Emitted when a child NFT is added to a token's pending array.
+     * @param tokenId ID of the token that received a new pending child token
+     * @param childIndex Index of the proposed child token in the parent token's pending children array
+     * @param childAddress Address of the proposed child token's collection smart contract
+     * @param childId ID of the child token in the child token's collection smart contract
+     */
+    event ChildProposed(
+        uint256 indexed tokenId,
+        uint256 childIndex,
+        address indexed childAddress,
+        uint256 indexed childId
+    );
+
+    /**
+     * @notice Used to notify listeners that a new child token was accepted by the parent token.
+     * @dev Emitted when a parent token accepts a token from its pending array, migrating it to the active array.
+     * @param tokenId ID of the token that accepted a new child token
+     * @param childIndex Index of the newly accepted child token in the parent token's active children array
+     * @param childAddress Address of the child token's collection smart contract
+     * @param childId ID of the child token in the child token's collection smart contract
+     */
+    event ChildAccepted(
+        uint256 indexed tokenId,
+        uint256 childIndex,
+        address indexed childAddress,
+        uint256 indexed childId
+    );
+
+    /**
+     * @notice Used to notify listeners that all pending child tokens of a given token have been rejected.
+     * @dev Emitted when a token removes all a child tokens from its pending array.
+     * @param tokenId ID of the token that rejected all of the pending children
+     */
+    event AllChildrenRejected(uint256 indexed tokenId);
+
+    /**
+     * @notice Used to notify listeners a child token has been transferred from parent token.
+     * @dev Emitted when a token transfers a child from itself, transferring ownership.
+     * @param tokenId ID of the token that transferred a child token
+     * @param childIndex Index of a child in the array from which it is being transferred
+     * @param childAddress Address of the child token's collection smart contract
+     * @param childId ID of the child token in the child token's collection smart contract
+     * @param fromPending A boolean value signifying whether the token was in the pending child tokens array (`true`) or
+     *  in the active child tokens array (`false`)
+     */
+    event ChildTransferred(
+        uint256 indexed tokenId,
+        uint256 childIndex,
+        address indexed childAddress,
+        uint256 indexed childId,
+        bool fromPending
+    );
+
+    /**
+     * @notice The core child token struct, holding the information about the child tokens.
+     * @return tokenId ID of the child token in the child token's collection smart contract
+     * @return contractAddress Address of the child token's smart contract
+     */
+    struct Child {
+        uint256 tokenId;
+        address contractAddress;
+    }
+
+    /**
+     * @notice Used to retrieve the *root* owner of a given token.
+     * @dev The *root* owner of the token is the top-level owner in the hierarchy which is not an NFT.
+     * @dev If the token is owned by another NFT, it MUST recursively look up the parent's root owner.
+     * @param tokenId ID of the token for which the *root* owner has been retrieved
+     * @return owner The *root* owner of the token
+     */
+    function ownerOf(uint256 tokenId) external view returns (address owner);
+
+    /**
+     * @notice Used to retrieve the immediate owner of the given token.
+     * @dev If the immediate owner is another token, the address returned, MUST be the one of the parent token's
+     *  collection smart contract.
+     * @param tokenId ID of the token for which the direct owner is being retrieved
+     * @return address Address of the given token's owner
+     * @return uint256 The ID of the parent token. MUST be `0` if the owner is not an NFT
+     * @return bool The boolean value signifying whether the owner is an NFT or not
+     */
+    function directOwnerOf(uint256 tokenId)
+        external
+        view
+        returns (
+            address,
+            uint256,
+            bool
+        );
+
+    /**
+     * @notice Used to burn a given token.
+     * @dev When a token is burned, all of its child tokens are recursively burned as well.
+     * @dev When specifying the maximum recursive burns, the execution MUST be reverted if there are more children to be
+     *  burned.
+     * @dev Setting the `maxRecursiveBurn` value to 0 SHOULD only attempt to burn the specified token and MUST revert if
+     *  there are any child tokens present.
+     * @param tokenId ID of the token to burn
+     * @param maxRecursiveBurns Maximum number of tokens to recursively burn
+     * @return uint256 Number of recursively burned children
+     */
+    function burn(uint256 tokenId, uint256 maxRecursiveBurns)
+        external
+        returns (uint256);
+
+    /**
+     * @notice Used to add a child token to a given parent token.
+     * @dev This adds the child token into the given parent token's pending child tokens array.
+     * @dev The destination token MUST NOT be a child token of the token being transferred or one of its downstream
+     *  child tokens.
+     * @dev This method MUST NOT be called directly. It MUST only be called from an instance of `INestable` as part of a 
+        `nestMint`, `nestTransfer` or `transferChild` to an NFT.
+     * @dev Requirements:
+     *
+     *  - `directOwnerOf` on the child contract MUST resolve to the called contract.
+     *  - the pending array of the parent contract MUST not be full.
+     * @param parentId ID of the parent token to receive the new child token
+     * @param childId ID of the new proposed child token
+     */
+    function addChild(uint256 parentId, uint256 childId) external;
+
+    /**
+     * @notice Used to accept a pending child token for a given parent token.
+     * @dev This moves the child token from parent token's pending child tokens array into the active child tokens
+     *  array.
+     * @param parentId ID of the parent token for which the child token is being accepted
+     * @param childIndex Index of the child token to accept in the pending children array of a given token
+     * @param childAddress Address of the collection smart contract of the child token expected to be at the specified
+     *  index
+     * @param childId ID of the child token expected to be located at the specified index
+     */
+    function acceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) external;
+
+    /**
+     * @notice Used to reject all pending children of a given parent token.
+     * @dev Removes the children from the pending array mapping.
+     * @dev The children's ownership structures are not updated.
+     * @dev Requirements:
+     *
+     * - `parentId` MUST exist
+     * @param parentId ID of the parent token for which to reject all of the pending tokens
+     * @param maxRejections Maximum number of expected children to reject, used to prevent from
+     *  rejecting children which arrive just before this operation.
+     */
+    function rejectAllChildren(uint256 parentId, uint256 maxRejections) external;
+
+    /**
+     * @notice Used to transfer a child token from a given parent token.
+     * @dev MUST remove the child from the parent's active or pending children.
+     * @dev When transferring a child token, the owner of the token MUST be set to `to`, or not updated in the event of `to`
+     *  being the `0x0` address.
+     * @param tokenId ID of the parent token from which the child token is being transferred
+     * @param to Address to which to transfer the token to
+     * @param destinationId ID of the token to receive this child token (MUST be 0 if the destination is not a token)
+     * @param childIndex Index of a token we are transferring, in the array it belongs to (can be either active array or
+     *  pending array)
+     * @param childAddress Address of the child token's collection smart contract
+     * @param childId ID of the child token in its own collection smart contract
+     * @param isPending A boolean value indicating whether the child token being transferred is in the pending array of the
+     *  parent token (`true`) or in the active array (`false`)
+     * @param data Additional data with no specified format, sent in call to `to`
+     */
+    function transferChild(
+        uint256 tokenId,
+        address to,
+        uint256 destinationId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending,
+        bytes data
+    ) external;
+
+    /**
+     * @notice Used to retrieve the active child tokens of a given parent token.
+     * @dev Returns array of Child structs existing for parent token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which to retrieve the active child tokens
+     * @return struct[] An array of Child structs containing the parent token's active child tokens
+     */
+    function childrenOf(uint256 parentId)
+        external
+        view
+        returns (Child[] memory);
+
+    /**
+     * @notice Used to retrieve the pending child tokens of a given parent token.
+     * @dev Returns array of pending Child structs existing for given parent.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which to retrieve the pending child tokens
+     * @return struct[] An array of Child structs containing the parent token's pending child tokens
+     */
+    function pendingChildrenOf(uint256 parentId)
+        external
+        view
+        returns (Child[] memory);
+
+    /**
+     * @notice Used to retrieve a specific active child token for a given parent token.
+     * @dev Returns a single Child struct locating at `index` of parent token's active child tokens array.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which the child is being retrieved
+     * @param index Index of the child token in the parent token's active child tokens array
+     * @return struct A Child struct containing data about the specified child
+     */
+    function childOf(uint256 parentId, uint256 index)
+        external
+        view
+        returns (Child memory);
+
+    /**
+     * @notice Used to retrieve a specific pending child token from a given parent token.
+     * @dev Returns a single Child struct locating at `index` of parent token's active child tokens array.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which the pending child token is being retrieved
+     * @param index Index of the child token in the parent token's pending child tokens array
+     * @return struct A Child struct containing data about the specified child
+     */
+    function pendingChildOf(uint256 parentId, uint256 index)
+        external
+        view
+        returns (Child memory);
+
+    /**
+     * @notice Used to transfer the token into another token.
+     * @dev The destination token MUST NOT be a child token of the token being transferred or one of its downstream
+     *  child tokens.
+     * @param from Address of the direct owner of the token to be transferred
+     * @param to Address of the receiving token's collection smart contract
+     * @param tokenId ID of the token being transferred
+     * @param destinationId ID of the token to receive the token being transferred
+     */
+    function nestTransferFrom(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 destinationId
+    ) external;
+}
+```
+
+ID MUST never be a `0` value, as this proposal uses `0` values do signify that the token/destination is not an NFT.
+
+## Rationale
+
+Designing the proposal, we considered the following questions:
+
+1. **How to name the proposal?**
+
+In an effort to provide as much information about the proposal we identified the most important aspect of the proposal; the parent centered control over nesting. The child token's role is only to be able to be `Nestable` and support a token owning it. This is how we landed on the `Parent-Centered` part of the title.
+
+2. **Why is automatically accepting a child using [EIP-712](./eip-712.md) permit-style signatures not a part of this proposal?**
+
+For consistency. This proposal extends EIP-721 which already uses 1 transaction for approving operations with tokens. It would be inconsistent to have this and also support signing messages for operations with assets.
+
+3. **Why use indexes?** 
+
+To reduce the gas consumption. If the token ID was used to find which token to accept or reject, iteration over arrays would be required and the cost of the operation would depend on the size of the active or pending children arrays. With the index, the cost is fixed. Lists of active and pending children per token need to be maintained, since methods to get them are part of the proposed interface.
+
+To avoid race conditions in which the index of a token changes, the expected token ID as well as the expected token's collection smart contract is included in operations requiring token index, to verify that the token being accessed using the index is the expected one.
+
+Implementation that would internally keep track of indices using mapping was attempted. The minimum cost of accepting a child token was increased by over 20% and the cost of minting has increased by over 15%. We concluded that it is not necessary for this proposal and can be implemented as an extension for use cases willing to accept the increased transaction cost this incurs. In the sample implementation provided, there are several hooks which make this possible.
+
+4. **Why is the pending children array limited instead of supporting pagination?**
+
+The pending child tokens array is not meant to be a buffer to collect the tokens that the root owner of the parent token wants to keep, but not enough to promote them to active children. It is meant to be an easily traversable list of child token candidates and should be regularly maintained; by either accepting or rejecting proposed child tokens. There is also no need for the pending child tokens array to be unbounded, because active child tokens array is.
+
+Another benefit of having bounded child tokens array is to guard against spam and griefing. As minting malicious or spam tokens could be relatively easy and low-cost, the bounded pending array assures that all of the tokens in it are easy to identify and that legitimate tokens are not lost in a flood of spam tokens, if one occurs.
+
+A consideration tied to this issue was also how to make sure, that a legitimate token is not accidentally rejected when clearing the pending child tokens array. We added the maximum pending children to reject argument to the clear pending child tokens array call. This assures that only the intended number of pending child tokens is rejected and if a new token is added to the pending child tokens array during the course of preparing such call and executing it, the clearing of this array SHOULD result in a reverted transaction.
+
+5. **Should we allow tokens to be nested into one of its children?**
+
+The proposal enforces that a parent token can't be nested into one of its child token, or downstream child tokens for that matter. A parent token and its children are all managed by the parent token's root owner. This means that if a token would be nested into one of its children, this would create the ownership loop and none of the tokens within the loop could be managed anymore.
+
+6. **Why is there not a "safe" nest transfer method?**
+
+`nestTransfer` is always "safe" since it MUST check for `INestable` compatibility on the destination.
+
+7. **How does this proposal differ from the other proposals trying to address a similar problem?**
+
+This interface allows for tokens to both be sent to and receive other tokens. The propose-accept and parent governed patterns allow for a more secure use. The backward compatibility is only added for EIP-721, allowing for a simpler interface.
+
+### Propose-Commit pattern for child token management
+
+Adding child tokens to a parent token MUST be done in the form of propose-commit pattern to allow for limited mutability by a 3rd party. When adding a child token to a parent token, it is first placed in a *"Pending"* array, and MUST be migrated to the *"Active"* array by the parent token's root owner. The *"Pending"* child tokens array SHOULD be limited to 128 slots to prevent spam and griefing.
+
+The limitation that only the root owner can accept the child tokens also introduces a trust inherent to the proposal. This ensures that the root owner of the token has full control over the token. No one can force the user to accept a child if they don't want to.
+
+### Parent Governed pattern
+
+The parent NFT of a nested token and the parent's root owner are in all aspects the true owners of it. Once you send a token to another one you give up ownership.
+
+We continue to use EIP-721's `ownerOf` functionality which will now recursively look up through parents until it finds an address which is not an NFT, this is referred to as the *root owner*. Additionally we provide the `directOwnerOf` which returns the most immediate owner of a token using 3 values: the owner address, the tokenId which MUST be 0 if the direct owner is not an NFT, and a flag indicating whether or not the parent is an NFT.
+
+The root owner or an approved party MUST be able do the following operations on children: `acceptChild`, `rejectAllChildren` and `transferChild`.
+
+The root owner or an approved party MUST also be allowed to do these operations only when token is not owned by an NFT: `transferFrom`, `safeTransferFrom`, `nestTransferFrom`, `burn`.
+
+If the token is owned by an NFT, only the parent NFT itself MUST be allowed to execute the operations listed above. Transfers MUST be done from the parent token, using `transferChild`, this method in turn SHOULD call `nestTransferFrom` or `safeTransferFrom` in the child token's smart contract, according to whether the destination is an NFT or not. For burning, tokens must first be transferred to an EOA and then burned.
+
+We add this restriction to prevent inconsistencies on parent contracts, since only the `transferChild` method takes care of removing the child from the parent when it is being transferred out of it.
+
+### Child token management
+
+This proposal introduces a number of child token management functions. In addition to the permissioned migration from *"Pending"* to *"Active"* child tokens array, the main token management function from this proposal is the `tranferChild` function. The following state transitions of a child token are available with it:
+
+1. Reject child token
+2. Abandon child token
+3. Unnest child token
+4. Transfer the child token to an EOA or an `ERC721Receiver`
+5. Transfer the child token into a new parent token
+
+To better understand how these state transitions are achieved, we have to look at the available parameters passed to `transferChild`:
+
+```solidity
+    function transferChild(
+        uint256 tokenId,
+        address to,
+        uint256 destinationId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending,
+        bytes data
+    ) external;
+```
+
+Based on the desired state transitions, the values of these parameters have to be set accordingly (any parameters not set in the following examples depend on the child token being managed):
+
+1. **Reject child token**
+
+```mermaid
+graph LR
+    A(to = 0x0, isPending = true, destinationId = 0) -->|transferChild| B[Rejected child token]
+```
+
+2. **Abandon child token**
+
+```mermaid
+graph LR
+    A(to = 0x0, isPending = false, destinationId = 0) -->|transferChild| B[Abandoned child token]
+```
+
+3. **Unnest child token**
+
+```mermaid
+graph LR
+    A(to = rootOwner, destinationId = 0) -->|transferChild| B[Unnested child token]
+```
+
+4. **Transfer the child token to an EOA or an `ERC721Receiver`**
+
+```mermaid
+graph LR
+    A(to = newEoAToReceiveTheToken, destinationId = 0) -->|transferChild| B[Transferred child token to EOA or ERC721Receiver]
+```
+
+5. **Transfer the child token into a new parent token**
+
+```mermaid
+graph LR
+    A(to = collectionSmartContractOfNewParent, destinationId = IdOfNewParentToken) -->|transferChild| B[Transferred child token in a new parent token's pending array]
+```
+
+This state change places the token in the pending array of the new parent token. The child token still needs to be accepted by the new parent token's root owner in order to be placed into the active array of that token.
+
+## Backwards Compatibility
+
+The Nestable token standard has been made compatible with [EIP-721](./eip-721.md) in order to take advantage of the robust tooling available for implementations of EIP-721 and to ensure compatibility with existing EIP-721 infrastructure.
+
+## Test Cases
+
+Tests are included in [`nestable.ts`](../assets/eip-6059/test/nestable.ts).
+
+To run them in terminal, you can use the following commands:
+
+```
+cd ../assets/eip-6059
+npm install
+npx hardhat test
+```
+
+## Reference Implementation
+
+See [`NestableToken.sol`](../assets/eip-6059/contracts/NestableToken.sol).
+
+
+## Security Considerations
+
+The same security considerations as with [EIP-721](./eip-721.md) apply: hidden logic may be present in any of the functions, including burn, add resource, accept resource, and more.
+
+Caution is advised when dealing with non-audited contracts.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-6059/contracts/INestable.sol b/assets/eip-6059/contracts/INestable.sol
new file mode 100644
index 00000000000000..76e40ee107ab35
--- /dev/null
+++ b/assets/eip-6059/contracts/INestable.sol
@@ -0,0 +1,113 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+
+interface INestable {
+    struct DirectOwner {
+        uint256 tokenId;
+        address ownerAddress;
+        bool isNft;
+    }
+
+    event NestTransfer(
+        address indexed from,
+        address indexed to,
+        uint256 fromTokenId,
+        uint256 toTokenId,
+        uint256 indexed tokenId
+    );
+
+    event ChildProposed(
+        uint256 indexed tokenId,
+        uint256 childIndex,
+        address indexed childAddress,
+        uint256 indexed childId
+    );
+
+    event ChildAccepted(
+        uint256 indexed tokenId,
+        uint256 childIndex,
+        address indexed childAddress,
+        uint256 indexed childId
+    );
+
+    event AllChildrenRejected(uint256 indexed tokenId);
+
+    event ChildTransferred(
+        uint256 indexed tokenId,
+        uint256 childIndex,
+        address indexed childAddress,
+        uint256 indexed childId,
+        bool fromPending
+    );
+
+    struct Child {
+        uint256 tokenId;
+        address contractAddress;
+    }
+
+    function ownerOf(uint256 tokenId) external view returns (address owner);
+
+    function directOwnerOf(
+        uint256 tokenId
+    ) external view returns (address, uint256, bool);
+
+    function burn(
+        uint256 tokenId,
+        uint256 maxRecursiveBurns
+    ) external returns (uint256);
+
+    function addChild(
+        uint256 parentId,
+        uint256 childId,
+        bytes memory data
+    ) external;
+
+    function acceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) external;
+
+    function rejectAllChildren(uint256 parentId, uint256 maxRejections)
+        external;
+
+    function transferChild(
+        uint256 tokenId,
+        address to,
+        uint256 destinationId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending,
+        bytes memory data
+    ) external;
+
+    function childrenOf(
+        uint256 parentId
+    ) external view returns (Child[] memory);
+
+    function pendingChildrenOf(
+        uint256 parentId
+    ) external view returns (Child[] memory);
+
+    function childOf(
+        uint256 parentId,
+        uint256 index
+    ) external view returns (Child memory);
+
+    function pendingChildOf(
+        uint256 parentId,
+        uint256 index
+    ) external view returns (Child memory);
+
+    function nestTransferFrom(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 destinationId,
+        bytes memory data
+    ) external;
+}
diff --git a/assets/eip-6059/contracts/NestableToken.sol b/assets/eip-6059/contracts/NestableToken.sol
new file mode 100644
index 00000000000000..840d44b9c8b58c
--- /dev/null
+++ b/assets/eip-6059/contracts/NestableToken.sol
@@ -0,0 +1,1468 @@
+// SPDX-License-Identifier: CC0-1.0
+
+//Generally all interactions should propagate downstream
+
+pragma solidity ^0.8.16;
+
+import "./INestable.sol";
+import "@openzeppelin/contracts/token/ERC721/extensions/IERC721Metadata.sol";
+import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
+import "@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol";
+import "@openzeppelin/contracts/utils/Address.sol";
+import "@openzeppelin/contracts/utils/Context.sol";
+import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+
+error ChildAlreadyExists();
+error ChildIndexOutOfRange();
+error ERC721AddressZeroIsNotaValidOwner();
+error ERC721ApprovalToCurrentOwner();
+error ERC721ApproveCallerIsNotOwnerNorApprovedForAll();
+error ERC721ApproveToCaller();
+error ERC721InvalidTokenId();
+error ERC721MintToTheZeroAddress();
+error ERC721NotApprovedOrOwner();
+error ERC721TokenAlreadyMinted();
+error ERC721TransferFromIncorrectOwner();
+error ERC721TransferToNonReceiverImplementer();
+error ERC721TransferToTheZeroAddress();
+error IdZeroForbidden();
+error IsNotContract();
+error MaxPendingChildrenReached();
+error MaxRecursiveBurnsReached(address childContract, uint256 childId);
+error MintToNonNestableImplementer();
+error NestableTooDeep();
+error NestableTransferToDescendant();
+error NestableTransferToNonNestableImplementer();
+error NestableTransferToSelf();
+error NotApprovedOrDirectOwner();
+error PendingChildIndexOutOfRange();
+error UnexpectedChildId();
+error UnexpectedNumberOfChildren();
+
+/**
+ * @title NestableToken
+ * @author RMRK team
+ * @notice Smart contract of the Nestable module.
+ * @dev This contract is hierarchy agnostic and can support an arbitrary number of nested levels up and down, as long as
+ *  gas limits allow it.
+ */
+contract NestableToken is Context, IERC165, IERC721, INestable {
+    using Address for address;
+
+    uint256 private constant _MAX_LEVELS_TO_CHECK_FOR_INHERITANCE_LOOP = 100;
+
+    // Mapping owner address to token count
+    mapping(address => uint256) private _balances;
+
+    // Mapping from token ID to approver address to approved address
+    // The approver is necessary so approvals are invalidated for nested children on transfer
+    // WARNING: If a child NFT returns to a previous root owner, old permissions would be active again
+    mapping(uint256 => mapping(address => address)) private _tokenApprovals;
+
+    // Mapping from owner to operator approvals
+    mapping(address => mapping(address => bool)) private _operatorApprovals;
+
+    // ------------------- NESTABLE --------------
+
+    // Mapping from token ID to DirectOwner struct
+    mapping(uint256 => DirectOwner) private _directOwners;
+
+    // Mapping of tokenId to array of active children structs
+    mapping(uint256 => Child[]) private _activeChildren;
+
+    // Mapping of tokenId to array of pending children structs
+    mapping(uint256 => Child[]) private _pendingChildren;
+
+    // Mapping of child token address to child token ID to whether they are pending or active on any token
+    // We might have a first extra mapping from token ID, but since the same child cannot be nested into multiple tokens
+    //  we can strip it for size/gas savings.
+    mapping(address => mapping(uint256 => uint256)) private _childIsInActive;
+
+    // -------------------------- MODIFIERS ----------------------------
+
+    /**
+     * @notice Used to verify that the caller is either the owner of the token or approved to manage it by its owner.
+     * @dev If the caller is not the owner of the token or approved to manage it by its owner, the execution will be
+     *  reverted.
+     * @param tokenId ID of the token to check
+     */
+    function _onlyApprovedOrOwner(uint256 tokenId) private view {
+        if (!_isApprovedOrOwner(_msgSender(), tokenId))
+            revert ERC721NotApprovedOrOwner();
+    }
+
+    /**
+     * @notice Used to verify that the caller is either the owner of the token or approved to manage it by its owner.
+     * @param tokenId ID of the token to check
+     */
+    modifier onlyApprovedOrOwner(uint256 tokenId) {
+        _onlyApprovedOrOwner(tokenId);
+        _;
+    }
+
+    /**
+     * @notice Used to verify that the caller is approved to manage the given token or it its direct owner.
+     * @dev This does not delegate to ownerOf, which returns the root owner, but rater uses an owner from DirectOwner
+     *  struct.
+     * @dev The execution is reverted if the caller is not immediate owner or approved to manage the given token.
+     * @dev Used for parent-scoped transfers.
+     * @param tokenId ID of the token to check.
+     */
+    function _onlyApprovedOrDirectOwner(uint256 tokenId) private view {
+        if (!_isApprovedOrDirectOwner(_msgSender(), tokenId))
+            revert NotApprovedOrDirectOwner();
+    }
+
+    /**
+     * @notice Used to verify that the caller is approved to manage the given token or is its direct owner.
+     * @param tokenId ID of the token to check
+     */
+    modifier onlyApprovedOrDirectOwner(uint256 tokenId) {
+        _onlyApprovedOrDirectOwner(tokenId);
+        _;
+    }
+
+    // ------------------------------- ERC721 ---------------------------------
+    /**
+     * @inheritdoc IERC165
+     */
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual returns (bool) {
+        return
+            interfaceId == type(IERC165).interfaceId ||
+            interfaceId == type(IERC721).interfaceId ||
+            interfaceId == type(IERC721Metadata).interfaceId ||
+            interfaceId == type(INestable).interfaceId;
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function balanceOf(address owner) public view virtual returns (uint256) {
+        if (owner == address(0)) revert ERC721AddressZeroIsNotaValidOwner();
+        return _balances[owner];
+    }
+
+    ////////////////////////////////////////
+    //              TRANSFERS
+    ////////////////////////////////////////
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function transferFrom(
+        address from,
+        address to,
+        uint256 tokenId
+    ) public virtual onlyApprovedOrDirectOwner(tokenId) {
+        _transfer(from, to, tokenId);
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function safeTransferFrom(
+        address from,
+        address to,
+        uint256 tokenId
+    ) public virtual {
+        safeTransferFrom(from, to, tokenId, "");
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function safeTransferFrom(
+        address from,
+        address to,
+        uint256 tokenId,
+        bytes memory data
+    ) public virtual onlyApprovedOrDirectOwner(tokenId) {
+        _safeTransfer(from, to, tokenId, data);
+    }
+
+    /**
+     * @notice Used to transfer the token into another token.
+     * @dev The destination token MUST NOT be a child token of the token being transferred or one of its downstream
+     *  child tokens.
+     * @param from Address of the direct owner of the token to be transferred
+     * @param to Address of the receiving token's collection smart contract
+     * @param tokenId ID of the token being transferred
+     * @param destinationId ID of the token to receive the token being transferred
+     */
+    function nestTransferFrom(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 destinationId,
+        bytes memory data
+    ) public virtual onlyApprovedOrDirectOwner(tokenId) {
+        _nestTransfer(from, to, tokenId, destinationId, data);
+    }
+
+    /**
+     * @notice Used to safely transfer the token form `from` to `to`.
+     * @dev The function checks that contract recipients are aware of the ERC721 protocol to prevent tokens from being
+     *  forever locked.
+     * @dev This internal function is equivalent to {safeTransferFrom}, and can be used to e.g. implement alternative
+     *  mechanisms to perform token transfer, such as signature-based.
+     * @dev Requirements:
+     *
+     *  - `from` cannot be the zero address.
+     *  - `to` cannot be the zero address.
+     *  - `tokenId` token must exist and be owned by `from`.
+     *  - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
+     * @dev Emits a {Transfer} event.
+     * @param from Address of the account currently owning the given token
+     * @param to Address to transfer the token to
+     * @param tokenId ID of the token to transfer
+     * @param data Additional data with no specified format, sent in call to `to`
+     */
+    function _safeTransfer(
+        address from,
+        address to,
+        uint256 tokenId,
+        bytes memory data
+    ) internal virtual {
+        _transfer(from, to, tokenId);
+        if (!_checkOnERC721Received(from, to, tokenId, data))
+            revert ERC721TransferToNonReceiverImplementer();
+    }
+
+    /**
+     * @notice Used to transfer the token from `from` to `to`.
+     * @dev As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
+     * @dev Requirements:
+     *
+     *  - `to` cannot be the zero address.
+     *  - `tokenId` token must be owned by `from`.
+     * @dev Emits a {Transfer} event.
+     * @param from Address of the account currently owning the given token
+     * @param to Address to transfer the token to
+     * @param tokenId ID of the token to transfer
+     */
+    function _transfer(
+        address from,
+        address to,
+        uint256 tokenId
+    ) internal virtual {
+        (address immediateOwner, uint256 parentId, ) = directOwnerOf(tokenId);
+        if (immediateOwner != from) revert ERC721TransferFromIncorrectOwner();
+        if (to == address(0)) revert ERC721TransferToTheZeroAddress();
+
+        _beforeTokenTransfer(from, to, tokenId);
+        _beforeNestedTokenTransfer(immediateOwner, to, parentId, 0, tokenId);
+
+        _balances[from] -= 1;
+        _updateOwnerAndClearApprovals(tokenId, 0, to, false);
+        _balances[to] += 1;
+
+        emit Transfer(from, to, tokenId);
+        emit NestTransfer(immediateOwner, to, parentId, 0, tokenId);
+
+        _afterTokenTransfer(from, to, tokenId);
+        _afterNestedTokenTransfer(immediateOwner, to, parentId, 0, tokenId);
+    }
+
+    /**
+     * @notice Used to transfer a token into another token.
+     * @dev Attempting to nest a token into `0x0` address will result in reverted transaction.
+     * @dev Attempting to nest a token into itself will result in reverted transaction.
+     * @param from Address of the account currently owning the given token
+     * @param to Address of the receiving token's collection smart contract
+     * @param tokenId ID of the token to transfer
+     * @param destinationId ID of the token receiving the given token
+     * @param data Additional data with no specified format, sent in the addChild call
+     */
+    function _nestTransfer(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 destinationId,
+        bytes memory data
+    ) internal virtual {
+        (address immediateOwner, uint256 parentId, ) = directOwnerOf(tokenId);
+        if (immediateOwner != from) revert ERC721TransferFromIncorrectOwner();
+        if (to == address(0)) revert ERC721TransferToTheZeroAddress();
+        if (to == address(this) && tokenId == destinationId)
+            revert NestableTransferToSelf();
+
+        // Destination contract checks:
+        // It seems redundant, but otherwise it would revert with no error
+        if (!to.isContract()) revert IsNotContract();
+        if (!IERC165(to).supportsInterface(type(INestable).interfaceId))
+            revert NestableTransferToNonNestableImplementer();
+        _checkForInheritanceLoop(tokenId, to, destinationId);
+
+        _beforeTokenTransfer(from, to, tokenId);
+        _beforeNestedTokenTransfer(
+            immediateOwner,
+            to,
+            parentId,
+            destinationId,
+            tokenId
+        );
+        _balances[from] -= 1;
+        _updateOwnerAndClearApprovals(tokenId, destinationId, to, true);
+        _balances[to] += 1;
+
+        // Sending to NFT:
+        _sendToNFT(immediateOwner, to, parentId, destinationId, tokenId, data);
+    }
+
+    /**
+     * @notice Used to send a token to another token.
+     * @dev If the token being sent is currently owned by an externally owned account, the `parentId` should equal `0`.
+     * @dev Emits {Transfer} event.
+     * @dev Emits {NestTransfer} event.
+     * @param from Address from which the token is being sent
+     * @param to Address of the collection smart contract of the token to receive the given token
+     * @param parentId ID of the current parent token of the token being sent
+     * @param destinationId ID of the tokento receive the token being sent
+     * @param tokenId ID of the token being sent
+     * @param data Additional data with no specified format, sent in the addChild call
+     */
+    function _sendToNFT(
+        address from,
+        address to,
+        uint256 parentId,
+        uint256 destinationId,
+        uint256 tokenId,
+        bytes memory data
+    ) private {
+        INestable destContract = INestable(to);
+        destContract.addChild(destinationId, tokenId, data);
+        _afterTokenTransfer(from, to, tokenId);
+        _afterNestedTokenTransfer(from, to, parentId, destinationId, tokenId);
+
+        emit Transfer(from, to, tokenId);
+        emit NestTransfer(from, to, parentId, destinationId, tokenId);
+    }
+
+    /**
+     * @notice Used to check if nesting a given token into a specified token would create an inheritance loop.
+     * @dev If a loop would occur, the tokens would be unmanageable, so the execution is reverted if one is detected.
+     * @dev The check for inheritance loop is bounded to guard against too much gas being consumed.
+     * @param currentId ID of the token that would be nested
+     * @param targetContract Address of the collection smart contract of the token into which the given token would be
+     *  nested
+     * @param targetId ID of the token into which the given token would be nested
+     */
+    function _checkForInheritanceLoop(
+        uint256 currentId,
+        address targetContract,
+        uint256 targetId
+    ) private view {
+        for (uint256 i; i < _MAX_LEVELS_TO_CHECK_FOR_INHERITANCE_LOOP; ) {
+            (
+                address nextOwner,
+                uint256 nextOwnerTokenId,
+                bool isNft
+            ) = INestable(targetContract).directOwnerOf(targetId);
+            // If there's a final address, we're good. There's no loop.
+            if (!isNft) {
+                return;
+            }
+            // Ff the current nft is an ancestor at some point, there is an inheritance loop
+            if (nextOwner == address(this) && nextOwnerTokenId == currentId) {
+                revert NestableTransferToDescendant();
+            }
+            // We reuse the parameters to save some contract size
+            targetContract = nextOwner;
+            targetId = nextOwnerTokenId;
+            unchecked {
+                ++i;
+            }
+        }
+        revert NestableTooDeep();
+    }
+
+    ////////////////////////////////////////
+    //              MINTING
+    ////////////////////////////////////////
+
+    /**
+     * @notice Used to safely mint a token to a specified address.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must not exist.
+     *  - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
+     * @dev Emits a {Transfer} event.
+     * @param to Address to which to safely mint the gven token
+     * @param tokenId ID of the token to mint to the specified address
+     */
+    function _safeMint(address to, uint256 tokenId) internal virtual {
+        _safeMint(to, tokenId, "");
+    }
+
+    /**
+     * @notice Used to safely mint the token to the specified address while passing the additional data to contract
+     *  recipients.
+     * @param to Address to which to mint the token
+     * @param tokenId ID of the token to mint
+     * @param data Additional data to send with the tokens
+     */
+    function _safeMint(
+        address to,
+        uint256 tokenId,
+        bytes memory data
+    ) internal virtual {
+        _mint(to, tokenId);
+        if (!_checkOnERC721Received(address(0), to, tokenId, data))
+            revert ERC721TransferToNonReceiverImplementer();
+    }
+
+    /**
+     * @notice Used to mint a specified token to a given address.
+     * @dev WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must not exist.
+     *  - `to` cannot be the zero address.
+     * @dev Emits a {Transfer} event.
+     * @param to Address to mint the token to
+     * @param tokenId ID of the token to mint
+     */
+    function _mint(address to, uint256 tokenId) internal virtual {
+        _innerMint(to, tokenId, 0);
+
+        emit Transfer(address(0), to, tokenId);
+        emit NestTransfer(address(0), to, 0, 0, tokenId);
+
+        _afterTokenTransfer(address(0), to, tokenId);
+        _afterNestedTokenTransfer(address(0), to, 0, 0, tokenId);
+    }
+
+    /**
+     * @notice Used to mint a child token to a given parent token.
+     * @param to Address of the collection smart contract of the token into which to mint the child token
+     * @param tokenId ID of the token to mint
+     * @param destinationId ID of the token into which to mint the new child token
+     * @param data Additional data with no specified format, sent in the addChild call
+     */
+    function _nestMint(
+        address to,
+        uint256 tokenId,
+        uint256 destinationId,
+        bytes memory data
+    ) internal virtual {
+        // It seems redundant, but otherwise it would revert with no error
+        if (!to.isContract()) revert IsNotContract();
+        if (!IERC165(to).supportsInterface(type(INestable).interfaceId))
+            revert MintToNonNestableImplementer();
+
+        _innerMint(to, tokenId, destinationId);
+        _sendToNFT(address(0), to, 0, destinationId, tokenId, data);
+    }
+
+    /**
+     * @notice Used to mint a child token into a given parent token.
+     * @dev Requirements:
+     *
+     *  - `to` cannot be the zero address.
+     *  - `tokenId` must not exist.
+     *  - `tokenId` must not be `0`.
+     * @param to Address of the collection smart contract of the token into which to mint the child token
+     * @param tokenId ID of the token to mint
+     * @param destinationId ID of the token into which to mint the new token
+     */
+    function _innerMint(
+        address to,
+        uint256 tokenId,
+        uint256 destinationId
+    ) private {
+        if (to == address(0)) revert ERC721MintToTheZeroAddress();
+        if (_exists(tokenId)) revert ERC721TokenAlreadyMinted();
+        if (tokenId == 0) revert IdZeroForbidden();
+
+        _beforeTokenTransfer(address(0), to, tokenId);
+        _beforeNestedTokenTransfer(address(0), to, 0, destinationId, tokenId);
+
+        _balances[to] += 1;
+        _directOwners[tokenId] = DirectOwner({
+            ownerAddress: to,
+            tokenId: destinationId,
+            isNft: destinationId != 0
+        });
+    }
+
+    ////////////////////////////////////////
+    //              Ownership
+    ////////////////////////////////////////
+
+    /**
+     * @notice Used to retrieve the root owner of the given token.
+     * @dev Root owner is always the externally owned account.
+     * @dev If the given token is owned by another token, it will recursively query the parent tokens until reaching the
+     *  root owner.
+     * @param tokenId ID of the token for which the root owner is being retrieved
+     * @return address Address of the root owner of the given token
+     */
+    function ownerOf(
+        uint256 tokenId
+    ) public view virtual override(INestable, IERC721) returns (address) {
+        (address owner, uint256 ownerTokenId, bool isNft) = directOwnerOf(
+            tokenId
+        );
+        if (isNft) {
+            owner = INestable(owner).ownerOf(ownerTokenId);
+        }
+        return owner;
+    }
+
+    /**
+     * @notice Used to retrieve the immediate owner of the given token.
+     * @dev In the event the NFT is owned by an externally owned account, `tokenId` will be `0` and `isNft` will be
+     *  `false`.
+     * @param tokenId ID of the token for which the immediate owner is being retrieved
+     * @return address Address of the immediate owner. If the token is owned by an externally owned account, its address
+     *  will be returned. If the token is owned by another token, the parent token's collection smart contract address
+     *  is returned
+     * @return uint256 Token ID of the immediate owner. If the immediate owner is an externally owned account, the value
+     *  should be `0`
+     * @return bool A boolean value signifying whether the immediate owner is a token (`true`) or not (`false`)
+     */
+    function directOwnerOf(
+        uint256 tokenId
+    ) public view virtual returns (address, uint256, bool) {
+        DirectOwner memory owner = _directOwners[tokenId];
+        if (owner.ownerAddress == address(0)) revert ERC721InvalidTokenId();
+
+        return (owner.ownerAddress, owner.tokenId, owner.isNft);
+    }
+
+    ////////////////////////////////////////
+    //              BURNING
+    ////////////////////////////////////////
+
+    /**
+     * @notice Used to burn a given token.
+     * @param tokenId ID of the token to burn
+     */
+    function burn(uint256 tokenId) public virtual {
+        burn(tokenId, 0);
+    }
+
+    /**
+     * @notice Used to burn a token.
+     * @dev When a token is burned, its children are recursively burned as well.
+     * @dev The approvals are cleared when the token is burned.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist.
+     * @dev Emits a {Transfer} event.
+     * @param tokenId ID of the token to burn
+     * @param maxChildrenBurns Maximum children to recursively burn
+     * @return uint256 The number of recursive burns it took to burn all of the children
+     */
+    function burn(
+        uint256 tokenId,
+        uint256 maxChildrenBurns
+    ) public virtual onlyApprovedOrDirectOwner(tokenId) returns (uint256) {
+        return _burn(tokenId, maxChildrenBurns);
+    }
+
+    /**
+     * @notice Used to burn a token.
+     * @dev When a token is burned, its children are recursively burned as well.
+     * @dev The approvals are cleared when the token is burned.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist.
+     * @dev Emits a {Transfer} event.
+     * @dev Emits a {NestTransfer} event.
+     * @param tokenId ID of the token to burn
+     * @param maxChildrenBurns Maximum children to recursively burn
+     * @return uint256 The number of recursive burns it took to burn all of the children
+     */
+    function _burn(
+        uint256 tokenId,
+        uint256 maxChildrenBurns
+    ) internal virtual returns (uint256) {
+        (address immediateOwner, uint256 parentId, ) = directOwnerOf(tokenId);
+        address owner = ownerOf(tokenId);
+        _balances[immediateOwner] -= 1;
+
+        _beforeTokenTransfer(owner, address(0), tokenId);
+        _beforeNestedTokenTransfer(
+            immediateOwner,
+            address(0),
+            parentId,
+            0,
+            tokenId
+        );
+
+        _approve(address(0), tokenId);
+        _cleanApprovals(tokenId);
+
+        Child[] memory children = childrenOf(tokenId);
+
+        delete _activeChildren[tokenId];
+        delete _pendingChildren[tokenId];
+        delete _tokenApprovals[tokenId][owner];
+
+        uint256 pendingRecursiveBurns;
+        uint256 totalChildBurns;
+
+        uint256 length = children.length; //gas savings
+        for (uint256 i; i < length; ) {
+            if (totalChildBurns >= maxChildrenBurns)
+                revert MaxRecursiveBurnsReached(
+                    children[i].contractAddress,
+                    children[i].tokenId
+                );
+            delete _childIsInActive[children[i].contractAddress][
+                children[i].tokenId
+            ];
+            unchecked {
+                // At this point we know pendingRecursiveBurns must be at least 1
+                pendingRecursiveBurns = maxChildrenBurns - totalChildBurns;
+            }
+            // We substract one to the next level to count for the token being burned, then add it again on returns
+            // This is to allow the behavior of 0 recursive burns meaning only the current token is deleted.
+            totalChildBurns +=
+                INestable(children[i].contractAddress).burn(
+                    children[i].tokenId,
+                    pendingRecursiveBurns - 1
+                ) +
+                1;
+            unchecked {
+                ++i;
+            }
+        }
+        // Can't remove before burning child since child will call back to get root owner
+        delete _directOwners[tokenId];
+
+        _afterTokenTransfer(owner, address(0), tokenId);
+        _afterNestedTokenTransfer(
+            immediateOwner,
+            address(0),
+            parentId,
+            0,
+            tokenId
+        );
+        emit Transfer(owner, address(0), tokenId);
+        emit NestTransfer(immediateOwner, address(0), parentId, 0, tokenId);
+
+        return totalChildBurns;
+    }
+
+    ////////////////////////////////////////
+    //              APPROVALS
+    ////////////////////////////////////////
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function approve(address to, uint256 tokenId) public virtual {
+        address owner = ownerOf(tokenId);
+        if (to == owner) revert ERC721ApprovalToCurrentOwner();
+
+        if (_msgSender() != owner && !isApprovedForAll(owner, _msgSender()))
+            revert ERC721ApproveCallerIsNotOwnerNorApprovedForAll();
+
+        _approve(to, tokenId);
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function getApproved(
+        uint256 tokenId
+    ) public view virtual returns (address) {
+        _requireMinted(tokenId);
+
+        return _tokenApprovals[tokenId][ownerOf(tokenId)];
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function setApprovalForAll(address operator, bool approved) public virtual {
+        if (_msgSender() == operator) revert ERC721ApproveToCaller();
+        _operatorApprovals[_msgSender()][operator] = approved;
+        emit ApprovalForAll(_msgSender(), operator, approved);
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function isApprovedForAll(
+        address owner,
+        address operator
+    ) public view virtual returns (bool) {
+        return _operatorApprovals[owner][operator];
+    }
+
+    /**
+     * @notice Used to grant an approval to manage a given token.
+     * @dev Emits an {Approval} event.
+     * @param to Address to which the approval is being granted
+     * @param tokenId ID of the token for which the approval is being granted
+     */
+    function _approve(address to, uint256 tokenId) internal virtual {
+        address owner = ownerOf(tokenId);
+        _tokenApprovals[tokenId][owner] = to;
+        emit Approval(owner, to, tokenId);
+    }
+
+    /**
+     * @notice Used to update the owner of the token and clear the approvals associated with the previous owner.
+     * @dev The `destinationId` should equal `0` if the new owner is an externally owned account.
+     * @param tokenId ID of the token being updated
+     * @param destinationId ID of the token to receive the given token
+     * @param to Address of account to receive the token
+     * @param isNft A boolean value signifying whether the new owner is a token (`true`) or externally owned account
+     *  (`false`)
+     */
+    function _updateOwnerAndClearApprovals(
+        uint256 tokenId,
+        uint256 destinationId,
+        address to,
+        bool isNft
+    ) internal {
+        _directOwners[tokenId] = DirectOwner({
+            ownerAddress: to,
+            tokenId: destinationId,
+            isNft: isNft
+        });
+
+        // Clear approvals from the previous owner
+        _approve(address(0), tokenId);
+        _cleanApprovals(tokenId);
+    }
+
+    /**
+     * @notice Used to remove approvals for the current owner of the given token.
+     * @param tokenId ID of the token to clear the approvals for
+     */
+    function _cleanApprovals(uint256 tokenId) internal virtual {}
+
+    ////////////////////////////////////////
+    //              UTILS
+    ////////////////////////////////////////
+
+    /**
+     * @notice Used to check whether the given account is allowed to manage the given token.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist.
+     * @param spender Address that is being checked for approval
+     * @param tokenId ID of the token being checked
+     * @return bool The boolean value indicating whether the `spender` is approved to manage the given token
+     */
+    function _isApprovedOrOwner(
+        address spender,
+        uint256 tokenId
+    ) internal view virtual returns (bool) {
+        address owner = ownerOf(tokenId);
+        return (spender == owner ||
+            isApprovedForAll(owner, spender) ||
+            getApproved(tokenId) == spender);
+    }
+
+    /**
+     * @notice Used to check whether the account is approved to manage the token or its direct owner.
+     * @param spender Address that is being checked for approval or direct ownership
+     * @param tokenId ID of the token being checked
+     * @return bool The boolean value indicating whether the `spender` is approved to manage the given token or its
+     *  direct owner
+     */
+    function _isApprovedOrDirectOwner(
+        address spender,
+        uint256 tokenId
+    ) internal view virtual returns (bool) {
+        (address owner, uint256 parentId, ) = directOwnerOf(tokenId);
+        // When the parent is an NFT, only it can do operations
+        if (parentId != 0) {
+            return (spender == owner);
+        }
+        // Otherwise, the owner or approved address can
+        return (spender == owner ||
+            isApprovedForAll(owner, spender) ||
+            getApproved(tokenId) == spender);
+    }
+
+    /**
+     * @notice Used to enforce that the given token has been minted.
+     * @dev Reverts if the `tokenId` has not been minted yet.
+     * @dev The validation checks whether the owner of a given token is a `0x0` address and considers it not minted if
+     *  it is. This means that both tokens that haven't been minted yet as well as the ones that have already been
+     *  burned will cause the transaction to be reverted.
+     * @param tokenId ID of the token to check
+     */
+    function _requireMinted(uint256 tokenId) internal view virtual {
+        if (!_exists(tokenId)) revert ERC721InvalidTokenId();
+    }
+
+    /**
+     * @notice Used to check whether the given token exists.
+     * @dev Tokens start existing when they are minted (`_mint`) and stop existing when they are burned (`_burn`).
+     * @param tokenId ID of the token being checked
+     * @return bool The boolean value signifying whether the token exists
+     */
+    function _exists(uint256 tokenId) internal view virtual returns (bool) {
+        return _directOwners[tokenId].ownerAddress != address(0);
+    }
+
+    /**
+     * @notice Used to invoke {IERC721Receiver-onERC721Received} on a target address.
+     * @dev The call is not executed if the target address is not a contract.
+     * @param from Address representing the previous owner of the given token
+     * @param to Yarget address that will receive the tokens
+     * @param tokenId ID of the token to be transferred
+     * @param data Optional data to send along with the call
+     * @return bool Boolean value signifying whether the call correctly returned the expected magic value
+     */
+    function _checkOnERC721Received(
+        address from,
+        address to,
+        uint256 tokenId,
+        bytes memory data
+    ) private returns (bool) {
+        if (to.isContract()) {
+            try
+                IERC721Receiver(to).onERC721Received(
+                    _msgSender(),
+                    from,
+                    tokenId,
+                    data
+                )
+            returns (bytes4 retval) {
+                return retval == IERC721Receiver.onERC721Received.selector;
+            } catch (bytes memory reason) {
+                if (reason.length == 0) {
+                    revert ERC721TransferToNonReceiverImplementer();
+                } else {
+                    /// @solidity memory-safe-assembly
+                    assembly {
+                        revert(add(32, reason), mload(reason))
+                    }
+                }
+            }
+        } else {
+            return true;
+        }
+    }
+
+    ////////////////////////////////////////
+    //      CHILD MANAGEMENT PUBLIC
+    ////////////////////////////////////////
+
+    /**
+     * @notice Used to add a child token to a given parent token.
+     * @dev This adds the iichild token into the given parent token's pending child tokens array.
+     * @dev You MUST NOT call this method directly. To add a a child to an NFT you must use either
+     *  `nestTransfer`, `nestMint` or `transferChild` to the NFT.
+     * @dev Requirements:
+     *
+     *  - `ownerOf` on the child contract must resolve to the called contract.
+     *  - The pending array of the parent contract must not be full.
+     * @param parentId ID of the parent token to receive the new child token
+     * @param childId ID of the new proposed child token
+     * @param data Additional data with no specified format
+     */
+    function addChild(
+        uint256 parentId,
+        uint256 childId,
+        bytes memory data
+    ) public virtual {
+        _requireMinted(parentId);
+
+        address childAddress = _msgSender();
+        if (!childAddress.isContract()) revert IsNotContract();
+
+        Child memory child = Child({
+            contractAddress: childAddress,
+            tokenId: childId
+        });
+
+        _beforeAddChild(parentId, childAddress, childId);
+
+        uint256 length = pendingChildrenOf(parentId).length;
+
+        if (length < 128) {
+            _pendingChildren[parentId].push(child);
+        } else {
+            revert MaxPendingChildrenReached();
+        }
+
+        // Previous length matches the index for the new child
+        emit ChildProposed(parentId, length, childAddress, childId);
+
+        _afterAddChild(parentId, childAddress, childId);
+    }
+
+    /**
+     * @notice @notice Used to accept a pending child token for a given parent token.
+     * @dev This moves the child token from parent token's pending child tokens array into the active child tokens
+     *  array.
+     * @param parentId ID of the parent token for which the child token is being accepted
+     * @param childIndex Index of a child tokem in the given parent's pending children array
+     * @param childAddress Address of the collection smart contract of the child token expected to be located at the
+     *  specified index of the given parent token's pending children array
+     * @param childId ID of the child token expected to be located at the specified index of the given parent token's
+     *  pending children array
+     */
+    function acceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) public virtual onlyApprovedOrOwner(parentId) {
+        _acceptChild(parentId, childIndex, childAddress, childId);
+    }
+
+    /**
+     * @notice Used to accept a pending child token for a given parent token.
+     * @dev This moves the child token from parent token's pending child tokens array into the active child tokens
+     *  array.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist
+     *  - `index` must be in range of the pending children array
+     * @param parentId ID of the parent token for which the child token is being accepted
+     * @param childIndex Index of a child tokem in the given parent's pending children array
+     * @param childAddress Address of the collection smart contract of the child token expected to be located at the
+     *  specified index of the given parent token's pending children array
+     * @param childId ID of the child token expected to be located at the specified index of the given parent token's
+     *  pending children array
+     */
+    function _acceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) internal virtual {
+        if (pendingChildrenOf(parentId).length <= childIndex)
+            revert PendingChildIndexOutOfRange();
+
+        Child memory child = pendingChildOf(parentId, childIndex);
+        _checkExpectedChild(child, childAddress, childId);
+        if (_childIsInActive[childAddress][childId] != 0)
+            revert ChildAlreadyExists();
+
+        _beforeAcceptChild(parentId, childIndex, childAddress, childId);
+
+        // Remove from pending:
+        _removeChildByIndex(_pendingChildren[parentId], childIndex);
+
+        // Add to active:
+        _activeChildren[parentId].push(child);
+        _childIsInActive[childAddress][childId] = 1; // We use 1 as true
+
+        emit ChildAccepted(parentId, childIndex, childAddress, childId);
+
+        _afterAcceptChild(parentId, childIndex, childAddress, childId);
+    }
+
+    /**
+     * @notice Used to reject all pending children of a given parent token.
+     * @dev Removes the children from the pending array mapping.
+     * @dev This does not update the ownership storage data on children. If necessary, ownership can be reclaimed by the
+     *  rootOwner of the previous parent.
+     * @param tokenId ID of the parent token for which to reject all of the pending tokens
+     */
+    function rejectAllChildren(uint256 tokenId, uint256 maxRejections) public virtual onlyApprovedOrOwner(tokenId) {
+        _rejectAllChildren(tokenId, maxRejections);
+    }
+
+    /**
+     * @notice Used to reject all pending children of a given parent token.
+     * @dev Removes the children from the pending array mapping.
+     * @dev This does not update the ownership storage data on children. If necessary, ownership can be reclaimed by the
+     *  rootOwner of the previous parent.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist
+     * @param tokenId ID of the parent token for which to reject all of the pending tokens.
+     * @param maxRejections Maximum number of expected children to reject, used to prevent from
+     *  rejecting children which arrive just before this operation.
+     */
+    function _rejectAllChildren(uint256 tokenId, uint256 maxRejections)
+        internal
+        virtual
+    {
+        if (_pendingChildren[tokenId].length > maxRejections)
+            revert UnexpectedNumberOfChildren();
+
+        _beforeRejectAllChildren(tokenId);
+        delete _pendingChildren[tokenId];
+        emit AllChildrenRejected(tokenId);
+        _afterRejectAllChildren(tokenId);
+    }
+
+    /**
+     * @notice Used to transfer a child token from a given parent token.
+     * @param tokenId ID of the parent token from which the child token is being transferred
+     * @param to Address to which to transfer the token to
+     * @param destinationId ID of the token to receive this child token (MUST be 0 if the destination is not a token)
+     * @param childIndex Index of a token we are transferring, in the array it belongs to (can be either active array or
+     *  pending array)
+     * @param childAddress Address of the child token's collection smart contract.
+     * @param childId ID of the child token in its own collection smart contract.
+     * @param isPending A boolean value indicating whether the child token being transferred is in the pending array of the
+     *  parent token (`true`) or in the active array (`false`)
+     * @param data Additional data with no specified format, sent in call to `_to`
+     */
+    function transferChild(
+        uint256 tokenId,
+        address to,
+        uint256 destinationId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending,
+        bytes memory data
+    ) public virtual onlyApprovedOrOwner(tokenId) {
+        _transferChild(
+            tokenId,
+            to,
+            destinationId,
+            childIndex,
+            childAddress,
+            childId,
+            isPending,
+            data
+        );
+    }
+
+    /**
+     * @notice Used to transfer a child token from a given parent token.
+     * @dev When transferring a child token, the owner of the token is set to `to`, or is not updated in the event of `to`
+     *  being the `0x0` address.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist.
+     * @dev Emits {ChildTransferred} event.
+     * @param tokenId ID of the parent token from which the child token is being transferred
+     * @param to Address to which to transfer the token to
+     * @param destinationId ID of the token to receive this child token (MUST be 0 if the destination is not a token)
+     * @param childIndex Index of a token we are transferring, in the array it belongs to (can be either active array or
+     *  pending array)
+     * @param childAddress Address of the child token's collection smart contract.
+     * @param childId ID of the child token in its own collection smart contract.
+     * @param isPending A boolean value indicating whether the child token being transferred is in the pending array of the
+     *  parent token (`true`) or in the active array (`false`)
+     * @param data Additional data with no specified format, sent in call to `_to`
+     */
+    function _transferChild(
+        uint256 tokenId,
+        address to,
+        uint256 destinationId, // newParentId
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending,
+        bytes memory data
+    ) internal virtual {
+        Child memory child;
+        if (isPending) {
+            child = pendingChildOf(tokenId, childIndex);
+        } else {
+            child = childOf(tokenId, childIndex);
+        }
+        _checkExpectedChild(child, childAddress, childId);
+
+        _beforeTransferChild(
+            tokenId,
+            childIndex,
+            childAddress,
+            childId,
+            isPending
+        );
+
+        if (isPending) {
+            _removeChildByIndex(_pendingChildren[tokenId], childIndex);
+        } else {
+            delete _childIsInActive[childAddress][childId];
+            _removeChildByIndex(_activeChildren[tokenId], childIndex);
+        }
+
+        if (to != address(0)) {
+            if (destinationId == 0) {
+                IERC721(childAddress).safeTransferFrom(
+                    address(this),
+                    to,
+                    childId,
+                    data
+                );
+            } else {
+                // Destination is an NFT
+                INestable(child.contractAddress).nestTransferFrom(
+                    address(this),
+                    to,
+                    child.tokenId,
+                    destinationId,
+                    data
+                );
+            }
+        }
+
+        emit ChildTransferred(
+            tokenId,
+            childIndex,
+            childAddress,
+            childId,
+            isPending
+        );
+        _afterTransferChild(
+            tokenId,
+            childIndex,
+            childAddress,
+            childId,
+            isPending
+        );
+    }
+
+    function _checkExpectedChild(
+        Child memory child,
+        address expectedAddress,
+        uint256 expectedId
+    ) private pure {
+        if (
+            expectedAddress != child.contractAddress ||
+            expectedId != child.tokenId
+        ) revert UnexpectedChildId();
+    }
+
+    ////////////////////////////////////////
+    //      CHILD MANAGEMENT GETTERS
+    ////////////////////////////////////////
+
+    /**
+     * @notice Used to retrieve the active child tokens of a given parent token.
+     * @dev Returns array of Child structs existing for parent token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which to retrieve the active child tokens
+     * @return struct[] An array of Child structs containing the parent token's active child tokens
+     */
+
+    function childrenOf(
+        uint256 parentId
+    ) public view virtual returns (Child[] memory) {
+        Child[] memory children = _activeChildren[parentId];
+        return children;
+    }
+
+    /**
+     * @notice Used to retrieve the pending child tokens of a given parent token.
+     * @dev Returns array of pending Child structs existing for given parent.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which to retrieve the pending child tokens
+     * @return struct[] An array of Child structs containing the parent token's pending child tokens
+     */
+
+    function pendingChildrenOf(
+        uint256 parentId
+    ) public view virtual returns (Child[] memory) {
+        Child[] memory pendingChildren = _pendingChildren[parentId];
+        return pendingChildren;
+    }
+
+    /**
+     * @notice Used to retrieve a specific active child token for a given parent token.
+     * @dev Returns a single Child struct locating at `index` of parent token's active child tokens array.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which the child is being retrieved
+     * @param index Index of the child token in the parent token's active child tokens array
+     * @return struct A Child struct containing data about the specified child
+     */
+    function childOf(
+        uint256 parentId,
+        uint256 index
+    ) public view virtual returns (Child memory) {
+        if (childrenOf(parentId).length <= index) revert ChildIndexOutOfRange();
+        Child memory child = _activeChildren[parentId][index];
+        return child;
+    }
+
+    /**
+     * @notice Used to retrieve a specific pending child token from a given parent token.
+     * @dev Returns a single Child struct locating at `index` of parent token's active child tokens array.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which the pending child token is being retrieved
+     * @param index Index of the child token in the parent token's pending child tokens array
+     * @return struct A Child struct containting data about the specified child
+     */
+    function pendingChildOf(
+        uint256 parentId,
+        uint256 index
+    ) public view virtual returns (Child memory) {
+        if (pendingChildrenOf(parentId).length <= index)
+            revert PendingChildIndexOutOfRange();
+        Child memory child = _pendingChildren[parentId][index];
+        return child;
+    }
+
+    /**
+     * @notice Used to verify that the given child tokwn is included in an active array of a token.
+     * @param childAddress Address of the given token's collection smart contract
+     * @param childId ID of the child token being checked
+     * @return bool A boolean value signifying whether the given child token is included in an active child tokens array
+     *  of a token (`true`) or not (`false`)
+     */
+    function childIsInActive(
+        address childAddress,
+        uint256 childId
+    ) public view virtual returns (bool) {
+        return _childIsInActive[childAddress][childId] != 0;
+    }
+
+    // HOOKS
+
+    /**
+     * @notice Hook that is called before any token transfer. This includes minting and burning.
+     * @dev Calling conditions:
+     *
+     *  - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be transferred to `to`.
+     *  - When `from` is zero, `tokenId` will be minted to `to`.
+     *  - When `to` is zero, ``from``'s `tokenId` will be burned.
+     *  - `from` and `to` are never zero at the same time.
+     *
+     *  To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param from Address from which the token is being transferred
+     * @param to Address to which the token is being transferred
+     * @param tokenId ID of the token being transferred
+     */
+    function _beforeTokenTransfer(
+        address from,
+        address to,
+        uint256 tokenId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after any transfer of tokens. This includes minting and burning.
+     * @dev Calling conditions:
+     *
+     *  - When `from` and `to` are both non-zero.
+     *  - `from` and `to` are never zero at the same time.
+     *
+     *  To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param from Address from which the token has been transferred
+     * @param to Address to which the token has been transferred
+     * @param tokenId ID of the token that has been transferred
+     */
+    function _afterTokenTransfer(
+        address from,
+        address to,
+        uint256 tokenId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before nested token transfer.
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param from Address from which the token is being transferred
+     * @param to Address to which the token is being transferred
+     * @param fromTokenId ID of the token from which the given token is being transferred
+     * @param toTokenId ID of the token to which the given token is being transferred
+     * @param tokenId ID of the token being transferred
+     */
+    function _beforeNestedTokenTransfer(
+        address from,
+        address to,
+        uint256 fromTokenId,
+        uint256 toTokenId,
+        uint256 tokenId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after nested token transfer.
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param from Address from which the token was transferred
+     * @param to Address to which the token was transferred
+     * @param fromTokenId ID of the token from which the given token was transferred
+     * @param toTokenId ID of the token to which the given token was transferred
+     * @param tokenId ID of the token that was transferred
+     */
+    function _afterNestedTokenTransfer(
+        address from,
+        address to,
+        uint256 fromTokenId,
+        uint256 toTokenId,
+        uint256 tokenId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before a child is added to the pending tokens array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that will receive a new pending child token
+     * @param childAddress Address of the collection smart contract of the child token expected to be located at the
+     *  specified index of the given parent token's pending children array
+     * @param childId ID of the child token expected to be located at the specified index of the given parent token's
+     *  pending children array
+     */
+    function _beforeAddChild(
+        uint256 tokenId,
+        address childAddress,
+        uint256 childId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after a child is added to the pending tokens array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that has received a new pending child token
+     * @param childAddress Address of the collection smart contract of the child token expected to be located at the
+     *  specified index of the given parent token's pending children array
+     * @param childId ID of the child token expected to be located at the specified index of the given parent token's
+     *  pending children array
+     */
+    function _afterAddChild(
+        uint256 tokenId,
+        address childAddress,
+        uint256 childId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before a child is accepted to the active tokens array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param parentId ID of the token that will accept a pending child token
+     * @param childIndex Index of the child token to accept in the given parent token's pending children array
+     * @param childAddress Address of the collection smart contract of the child token expected to be located at the
+     *  specified index of the given parent token's pending children array
+     * @param childId ID of the child token expected to be located at the specified index of the given parent token's
+     *  pending children array
+     */
+    function _beforeAcceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after a child is accepted to the active tokens array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param parentId ID of the token that has accepted a pending child token
+     * @param childIndex Index of the child token that was accpeted in the given parent token's pending children array
+     * @param childAddress Address of the collection smart contract of the child token that was expected to be located
+     *  at the specified index of the given parent token's pending children array
+     * @param childId ID of the child token that was expected to be located at the specified index of the given parent
+     *  token's pending children array
+     */
+    function _afterAcceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before a child is transferred from a given child token array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that will transfer a child token
+     * @param childIndex Index of the child token that will be transferred from the given parent token's children array
+     * @param childAddress Address of the collection smart contract of the child token that is expected to be located
+     *  at the specified index of the given parent token's children array
+     * @param childId ID of the child token that is expected to be located at the specified index of the given parent
+     *  token's children array
+     * @param isPending A boolean value signifying whether the child token is being transferred from the pending child
+     *  tokens array (`true`) or from the active child tokens array (`false`)
+     */
+    function _beforeTransferChild(
+        uint256 tokenId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after a child is transferred from a given child token array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that has transferred a child token
+     * @param childIndex Index of the child token that was transferred from the given parent token's children array
+     * @param childAddress Address of the collection smart contract of the child token that was expected to be located
+     *  at the specified index of the given parent token's children array
+     * @param childId ID of the child token that was expected to be located at the specified index of the given parent
+     *  token's children array
+     * @param isPending A boolean value signifying whether the child token was transferred from the pending child tokens
+     *  array (`true`) or from the active child tokens array (`false`)
+     */
+    function _afterTransferChild(
+        uint256 tokenId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before a pending child tokens array of a given token is cleared.
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that will reject all of the pending child tokens
+     */
+    function _beforeRejectAllChildren(uint256 tokenId) internal virtual {}
+
+    /**
+     * @notice Hook that is called after a pending child tokens array of a given token is cleared.
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that has rejected all of the pending child tokens
+     */
+    function _afterRejectAllChildren(uint256 tokenId) internal virtual {}
+
+    // HELPERS
+
+    /**
+     * @notice Used to remove a specified child token form an array using its index within said array.
+     * @dev The caller must ensure that the length of the array is valid compared to the index passed.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param array An array od Child struct containing info about the child tokens in a given child tokens array
+     * @param index An index of the child token to remove in the accompanying array
+     */
+    function _removeChildByIndex(Child[] storage array, uint256 index) private {
+        array[index] = array[array.length - 1];
+        array.pop();
+    }
+}
diff --git a/assets/eip-6059/contracts/mocks/ERC721Mock.sol b/assets/eip-6059/contracts/mocks/ERC721Mock.sol
new file mode 100644
index 00000000000000..b31caeb545ac9e
--- /dev/null
+++ b/assets/eip-6059/contracts/mocks/ERC721Mock.sol
@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+
+/**
+ * @title ERC721Mock
+ * Used for tests with non RMRK implementer
+ */
+contract ERC721Mock is ERC721 {
+    constructor(
+        string memory name,
+        string memory symbol
+    ) ERC721(name, symbol) {}
+}
diff --git a/assets/eip-6059/contracts/mocks/NestableTokenMock.sol b/assets/eip-6059/contracts/mocks/NestableTokenMock.sol
new file mode 100644
index 00000000000000..28861737fc1aac
--- /dev/null
+++ b/assets/eip-6059/contracts/mocks/NestableTokenMock.sol
@@ -0,0 +1,36 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "../NestableToken.sol";
+
+//Minimal public implementation of IRMRKNestable for testing.
+contract NestableTokenMock is NestableToken {
+    constructor() NestableToken() {}
+
+    function mint(address to, uint256 tokenId) external {
+        _mint(to, tokenId);
+    }
+
+    function nestMint(
+        address to,
+        uint256 tokenId,
+        uint256 destinationId
+    ) external {
+        _nestMint(to, tokenId, destinationId, "");
+    }
+
+    // Utility transfers:
+
+    function transfer(address to, uint256 tokenId) public virtual {
+        transferFrom(_msgSender(), to, tokenId);
+    }
+
+    function nestTransfer(
+        address to,
+        uint256 tokenId,
+        uint256 destinationId
+    ) public virtual {
+        nestTransferFrom(_msgSender(), to, tokenId, destinationId, "");
+    }
+}
diff --git a/assets/eip-6059/hardhat.config.ts b/assets/eip-6059/hardhat.config.ts
new file mode 100644
index 00000000000000..4289f15e8be78d
--- /dev/null
+++ b/assets/eip-6059/hardhat.config.ts
@@ -0,0 +1,21 @@
+import { HardhatUserConfig } from 'hardhat/config';
+import '@nomicfoundation/hardhat-chai-matchers';
+import '@nomiclabs/hardhat-etherscan';
+import '@typechain/hardhat';
+import 'hardhat-contract-sizer';
+import 'hardhat-gas-reporter';
+import 'solidity-coverage';
+
+const config: HardhatUserConfig = {
+  solidity: {
+    version: '0.8.16',
+    settings: {
+      optimizer: {
+        enabled: true,
+        runs: 200,
+      },
+    },
+  },
+};
+
+export default config;
diff --git a/assets/eip-6059/package.json b/assets/eip-6059/package.json
new file mode 100644
index 00000000000000..90551fb11ea39a
--- /dev/null
+++ b/assets/eip-6059/package.json
@@ -0,0 +1,41 @@
+{
+  "name": "nestable-tokens",
+  "dependencies": {
+    "@openzeppelin/contracts": "^4.6.0"
+  },
+  "devDependencies": {
+    "@nomicfoundation/hardhat-chai-matchers": "^1.0.1",
+    "@nomicfoundation/hardhat-network-helpers": "^1.0.3",
+    "@nomiclabs/hardhat-ethers": "^2.2.1",
+    "@nomiclabs/hardhat-etherscan": "^3.1.0",
+    "@openzeppelin/test-helpers": "^0.5.15",
+    "@primitivefi/hardhat-dodoc": "^0.2.3",
+    "@typechain/ethers-v5": "^10.1.0",
+    "@typechain/hardhat": "^6.1.2",
+    "@types/chai": "^4.3.1",
+    "@types/mocha": "^9.1.0",
+    "@types/node": "^18.0.3",
+    "@typescript-eslint/eslint-plugin": "^5.30.6",
+    "@typescript-eslint/parser": "^5.30.6",
+    "chai": "^4.3.6",
+    "eslint": "^8.27.0",
+    "eslint-config-prettier": "^8.5.0",
+    "eslint-plugin-import": "^2.26.0",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-prettier": "^4.2.1",
+    "eslint-plugin-promise": "^6.0.0",
+    "ethers": "^5.6.9",
+    "hardhat": "^2.12.2",
+    "hardhat-contract-sizer": "^2.6.1",
+    "hardhat-gas-reporter": "^1.0.8",
+    "prettier": "2.7.1",
+    "prettier-plugin-solidity": "^1.0.0-beta.20",
+    "solc": "^0.8.9",
+    "solhint": "^3.3.7",
+    "solidity-coverage": "^0.8.2",
+    "ts-node": "^10.8.2",
+    "typechain": "^8.1.0",
+    "typescript": "^4.7.4",
+    "walk-sync": "^3.0.0"
+  }
+}
diff --git a/assets/eip-6059/test/nestable.ts b/assets/eip-6059/test/nestable.ts
new file mode 100644
index 00000000000000..be72822b2f3874
--- /dev/null
+++ b/assets/eip-6059/test/nestable.ts
@@ -0,0 +1,1158 @@
+import { expect } from 'chai';
+import { ethers } from 'hardhat';
+import { BigNumber, constants } from 'ethers';
+import { NestableTokenMock } from '../typechain-types';
+import { SignerWithAddress } from '@nomiclabs/hardhat-ethers/signers';
+import { loadFixture } from '@nomicfoundation/hardhat-network-helpers';
+
+function bn(x: number): BigNumber {
+  return BigNumber.from(x);
+}
+
+const ADDRESS_ZERO = constants.AddressZero;
+
+async function parentChildFixture(): Promise<{
+  parent: NestableTokenMock;
+  child: NestableTokenMock;
+}> {
+  const factory = await ethers.getContractFactory('NestableTokenMock');
+
+  const parent = await factory.deploy();
+  await parent.deployed();
+  const child = await factory.deploy();
+  await child.deployed();
+  return { parent, child };
+}
+
+describe('NestableToken', function () {
+  let parent: NestableTokenMock;
+  let child: NestableTokenMock;
+  let owner: SignerWithAddress;
+  let tokenOwner: SignerWithAddress;
+  let addrs: SignerWithAddress[];
+
+  beforeEach(async function () {
+    [owner, tokenOwner, ...addrs] = await ethers.getSigners();
+    ({ parent, child } = await loadFixture(parentChildFixture));
+  });
+
+  describe('Minting', async function () {
+    it('cannot mint id 0', async function () {
+      const tokenId1 = 0;
+      await expect(child.mint(owner.address, tokenId1)).to.be.revertedWithCustomError(
+        child,
+        'IdZeroForbidden',
+      );
+    });
+
+    it('cannot nest mint id 0', async function () {
+      const parentId = 1;
+      await child.mint(owner.address, parentId);
+      const childId1 = 0;
+      await expect(
+        child.nestMint(parent.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'IdZeroForbidden');
+    });
+
+    it('cannot mint already minted token', async function () {
+      const tokenId1 = 1;
+      await child.mint(owner.address, tokenId1);
+      await expect(child.mint(owner.address, tokenId1)).to.be.revertedWithCustomError(
+        child,
+        'ERC721TokenAlreadyMinted',
+      );
+    });
+
+    it('cannot nest mint already minted token', async function () {
+      const parentId = 1;
+      const childId1 = 99;
+      await parent.mint(owner.address, parentId);
+      await child.nestMint(parent.address, childId1, parentId);
+
+      await expect(
+        child.nestMint(parent.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'ERC721TokenAlreadyMinted');
+    });
+
+    it('cannot nest mint already minted token', async function () {
+      const parentId = 1;
+      const childId1 = 99;
+      await parent.mint(owner.address, parentId);
+      await child.nestMint(parent.address, childId1, parentId);
+
+      await expect(
+        child.nestMint(parent.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'ERC721TokenAlreadyMinted');
+    });
+
+    it('can mint with no destination', async function () {
+      const tokenId1 = 1;
+      await child.mint(tokenOwner.address, tokenId1);
+      expect(await child.ownerOf(tokenId1)).to.equal(tokenOwner.address);
+      expect(await child.directOwnerOf(tokenId1)).to.eql([tokenOwner.address, bn(0), false]);
+    });
+
+    it('has right owners', async function () {
+      const otherOwner = addrs[2];
+      const tokenId1 = 1;
+      await parent.mint(tokenOwner.address, tokenId1);
+      const tokenId2 = 2;
+      await parent.mint(otherOwner.address, tokenId2);
+      const tokenId3 = 3;
+      await parent.mint(otherOwner.address, tokenId3);
+
+      expect(await parent.ownerOf(tokenId1)).to.equal(tokenOwner.address);
+      expect(await parent.ownerOf(tokenId2)).to.equal(otherOwner.address);
+      expect(await parent.ownerOf(tokenId3)).to.equal(otherOwner.address);
+
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+      expect(await parent.balanceOf(otherOwner.address)).to.equal(2);
+
+      await expect(parent.ownerOf(9999)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+    });
+
+    it('cannot mint to zero address', async function () {
+      await expect(child.mint(ADDRESS_ZERO, 1)).to.be.revertedWithCustomError(
+        child,
+        'ERC721MintToTheZeroAddress',
+      );
+    });
+
+    it('cannot nest mint to a non-contract destination', async function () {
+      await expect(child.nestMint(tokenOwner.address, 1, 1)).to.be.revertedWithCustomError(
+        child,
+        'IsNotContract',
+      );
+    });
+
+    it('cannot nest mint to non nestable receiver', async function () {
+      const ERC721 = await ethers.getContractFactory('ERC721Mock');
+      const nonReceiver = await ERC721.deploy('Non receiver', 'NR');
+      await nonReceiver.deployed();
+
+      await expect(child.nestMint(nonReceiver.address, 1, 1)).to.be.revertedWithCustomError(
+        child,
+        'MintToNonNestableImplementer',
+      );
+    });
+
+    it('cannot nest mint to a non-existent token', async function () {
+      await expect(child.nestMint(parent.address, 1, 1)).to.be.revertedWithCustomError(
+        child,
+        'ERC721InvalidTokenId',
+      );
+    });
+
+    it('cannot nest mint to zero address', async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      await expect(child.nestMint(ADDRESS_ZERO, parentId, 1)).to.be.revertedWithCustomError(
+        child,
+        'IsNotContract',
+      );
+    });
+
+    it('can mint to contract and owners are ok', async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      // owner is the same adress
+      expect(await parent.ownerOf(parentId)).to.equal(tokenOwner.address);
+      expect(await child.ownerOf(childId1)).to.equal(tokenOwner.address);
+
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+    });
+
+    it('can mint to contract and direct owners are ok', async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      // Direct owner is an address for the parent
+      expect(await parent.directOwnerOf(parentId)).to.eql([tokenOwner.address, bn(0), false]);
+      // Direct owner is a contract for the child
+      expect(await child.directOwnerOf(childId1)).to.eql([parent.address, bn(parentId), true]);
+    });
+
+    it("can mint to contract and parent's children are ok", async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      const children = await parent.childrenOf(parentId);
+      expect(children).to.eql([]);
+
+      const pendingChildren = await parent.pendingChildrenOf(parentId);
+      expect(pendingChildren).to.eql([[bn(childId1), child.address]]);
+      expect(await parent.pendingChildOf(parentId, 0)).to.eql([bn(childId1), child.address]);
+    });
+
+    it('cannot get child out of index', async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      await expect(parent.childOf(parentId, 0)).to.be.revertedWithCustomError(
+        parent,
+        'ChildIndexOutOfRange',
+      );
+    });
+
+    it('cannot get pending child out of index', async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      await expect(parent.pendingChildOf(parentId, 0)).to.be.revertedWithCustomError(
+        parent,
+        'PendingChildIndexOutOfRange',
+      );
+    });
+
+    it('can mint multiple children', async function () {
+      const parentId = 1;
+      const childId1 = 99;
+      const childId2 = 100;
+      await parent.mint(tokenOwner.address, parentId);
+      await child.nestMint(parent.address, childId1, parentId);
+      await child.nestMint(parent.address, childId2, parentId);
+
+      expect(await child.ownerOf(childId1)).to.equal(tokenOwner.address);
+      expect(await child.ownerOf(childId2)).to.equal(tokenOwner.address);
+
+      expect(await child.balanceOf(parent.address)).to.equal(2);
+
+      const pendingChildren = await parent.pendingChildrenOf(parentId);
+      expect(pendingChildren).to.eql([
+        [bn(childId1), child.address],
+        [bn(childId2), child.address],
+      ]);
+    });
+
+    it('can mint child into child', async function () {
+      const parentId = 1;
+      const childId1 = 99;
+      const granchildId = 999;
+      await parent.mint(tokenOwner.address, parentId);
+      await child.nestMint(parent.address, childId1, parentId);
+      await child.nestMint(child.address, granchildId, childId1);
+
+      // Check balances -- yes, technically the counted balance indicates `child` owns an instance of itself
+      // and this is a little counterintuitive, but the root owner is the EOA.
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+      expect(await child.balanceOf(child.address)).to.equal(1);
+
+      const pendingChildrenOfChunky10 = await parent.pendingChildrenOf(parentId);
+      const pendingChildrenOfMonkey1 = await child.pendingChildrenOf(childId1);
+
+      expect(pendingChildrenOfChunky10).to.eql([[bn(childId1), child.address]]);
+      expect(pendingChildrenOfMonkey1).to.eql([[bn(granchildId), child.address]]);
+
+      expect(await child.directOwnerOf(granchildId)).to.eql([child.address, bn(childId1), true]);
+
+      expect(await child.ownerOf(granchildId)).to.eql(tokenOwner.address);
+    });
+
+    it('cannot have too many pending children', async () => {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+
+      // First 128 should be fine.
+      for (let i = 1; i <= 128; i++) {
+        await child.nestMint(parent.address, i, parentId);
+      }
+
+      await expect(child.nestMint(parent.address, 129, parentId)).to.be.revertedWithCustomError(
+        child,
+        'MaxPendingChildrenReached',
+      );
+    });
+  });
+
+  describe('Interface support', async function () {
+    it('can support IERC165', async function () {
+      expect(await parent.supportsInterface('0x01ffc9a7')).to.equal(true);
+    });
+
+    it('can support IERC721', async function () {
+      expect(await parent.supportsInterface('0x80ac58cd')).to.equal(true);
+    });
+
+    it('can support INestable', async function () {
+      expect(await parent.supportsInterface('0x42b0e56f')).to.equal(true);
+    });
+
+    it('cannot support other interfaceId', async function () {
+      expect(await parent.supportsInterface('0xffffffff')).to.equal(false);
+    });
+  });
+
+  describe('Adding child', async function () {
+    it('cannot add child from user address', async function () {
+      const tokenOwner1 = addrs[0];
+      const tokenOwner2 = addrs[1];
+      const parentId = 1;
+      await parent.mint(tokenOwner1.address, parentId);
+      const childId1 = 99;
+      await child.mint(tokenOwner2.address, childId1);
+      await expect(parent.addChild(parentId, childId1, '0x')).to.be.revertedWithCustomError(
+        parent,
+        'IsNotContract',
+      );
+    });
+  });
+
+  describe('Accept child', async function () {
+    let parentId: number;
+    let childId1: number;
+
+    beforeEach(async function () {
+      parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+    });
+
+    it('can accept child', async function () {
+      await expect(parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, childId1))
+        .to.emit(parent, 'ChildAccepted')
+        .withArgs(parentId, 0, child.address, childId1);
+      await checkChildWasAccepted();
+    });
+
+    it('can accept child if approved', async function () {
+      const approved = addrs[1];
+      await parent.connect(tokenOwner).approve(approved.address, parentId);
+      await parent.connect(approved).acceptChild(parentId, 0, child.address, childId1);
+      await checkChildWasAccepted();
+    });
+
+    it('can accept child if approved for all', async function () {
+      const operator = addrs[2];
+      await parent.connect(tokenOwner).setApprovalForAll(operator.address, true);
+      await parent.connect(operator).acceptChild(parentId, 0, child.address, childId1);
+      await checkChildWasAccepted();
+    });
+
+    it('cannot accept not owned child', async function () {
+      const notOwner = addrs[3];
+      await expect(
+        parent.connect(notOwner).acceptChild(parentId, 0, child.address, childId1),
+      ).to.be.revertedWithCustomError(parent, 'ERC721NotApprovedOrOwner');
+    });
+
+    it('cannot accept child if address or id do not match', async function () {
+      const otherAddress = addrs[1].address;
+      const otherChildId = 9999;
+      await expect(
+        parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, otherChildId),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+      await expect(
+        parent.connect(tokenOwner).acceptChild(parentId, 0, otherAddress, childId1),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+    });
+
+    it('cannot accept children for non existing index', async () => {
+      await expect(
+        parent.connect(tokenOwner).acceptChild(parentId, 1, child.address, childId1),
+      ).to.be.revertedWithCustomError(parent, 'PendingChildIndexOutOfRange');
+    });
+
+    async function checkChildWasAccepted() {
+      expect(await parent.pendingChildrenOf(parentId)).to.eql([]);
+      expect(await parent.childrenOf(parentId)).to.eql([[bn(childId1), child.address]]);
+    }
+  });
+
+  describe('Rejecting children', async function () {
+    let parentId: number;
+
+    beforeEach(async function () {
+      parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      await child.nestMint(parent.address, 99, parentId);
+    });
+
+    it('can reject all pending children', async function () {
+      // Mint a couple of more children
+      await child.nestMint(parent.address, 100, parentId);
+      await child.nestMint(parent.address, 101, parentId);
+
+      await expect(parent.connect(tokenOwner).rejectAllChildren(parentId, 3))
+        .to.emit(parent, 'AllChildrenRejected')
+        .withArgs(parentId);
+      await checkNoChildrenNorPending(parentId);
+
+      // They are still on the child
+      expect(await child.balanceOf(parent.address)).to.equal(3);
+    });
+
+    it('cannot reject all pending children if there are more than expected', async function () {
+      // Mint a couple of more children
+      await child.nestMint(parent.address, 100, parentId);
+      await child.nestMint(parent.address, 101, parentId);
+
+      await expect(
+        parent.connect(tokenOwner).rejectAllChildren(parentId, 1),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedNumberOfChildren');
+    });
+
+    it('can reject all pending children if approved', async function () {
+      // Mint a couple of more children
+      await child.nestMint(parent.address, 100, parentId);
+      await child.nestMint(parent.address, 101, parentId);
+
+      const rejecter = addrs[1];
+      await parent.connect(tokenOwner).approve(rejecter.address, parentId);
+      await parent.connect(rejecter).rejectAllChildren(parentId, 3);
+      await checkNoChildrenNorPending(parentId);
+    });
+
+    it('can reject all pending children if approved for all', async function () {
+      // Mint a couple of more children
+      await child.nestMint(parent.address, 100, parentId);
+      await child.nestMint(parent.address, 101, parentId);
+
+      const operator = addrs[2];
+      await parent.connect(tokenOwner).setApprovalForAll(operator.address, true);
+      await parent.connect(operator).rejectAllChildren(parentId, 3);
+      await checkNoChildrenNorPending(parentId);
+    });
+
+    it('cannot reject all pending children for not owned pending child', async function () {
+      const notOwner = addrs[3];
+
+      await expect(
+        parent.connect(notOwner).rejectAllChildren(parentId, 2),
+      ).to.be.revertedWithCustomError(parent, 'ERC721NotApprovedOrOwner');
+    });
+  });
+
+  describe('Burning', async function () {
+    let parentId: number;
+
+    beforeEach(async function () {
+      parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+    });
+
+    it('can burn token', async function () {
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+      await parent.connect(tokenOwner)['burn(uint256)'](parentId);
+      await checkBurntParent();
+    });
+
+    it('can burn token if approved', async function () {
+      const approved = addrs[1];
+      await parent.connect(tokenOwner).approve(approved.address, parentId);
+      await parent.connect(approved)['burn(uint256)'](parentId);
+      await checkBurntParent();
+    });
+
+    it('can burn token if approved for all', async function () {
+      const operator = addrs[2];
+      await parent.connect(tokenOwner).setApprovalForAll(operator.address, true);
+      await parent.connect(operator)['burn(uint256)'](parentId);
+      await checkBurntParent();
+    });
+
+    it('can recursively burn nested token', async function () {
+      const childId1 = 99;
+      const granchildId = 999;
+      await child.nestMint(parent.address, childId1, parentId);
+      await child.nestMint(child.address, granchildId, childId1);
+      await parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, childId1);
+      await child.connect(tokenOwner).acceptChild(childId1, 0, child.address, granchildId);
+
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+      expect(await child.balanceOf(child.address)).to.equal(1);
+
+      expect(await parent.childrenOf(parentId)).to.eql([[bn(childId1), child.address]]);
+      expect(await child.childrenOf(childId1)).to.eql([[bn(granchildId), child.address]]);
+      expect(await child.directOwnerOf(granchildId)).to.eql([child.address, bn(childId1), true]);
+
+      // Sets recursive burns to 2
+      await parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 2);
+
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(0);
+      expect(await child.balanceOf(parent.address)).to.equal(0);
+      expect(await child.balanceOf(child.address)).to.equal(0);
+
+      await expect(parent.ownerOf(parentId)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+      await expect(parent.directOwnerOf(parentId)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+
+      await expect(child.ownerOf(childId1)).to.be.revertedWithCustomError(
+        child,
+        'ERC721InvalidTokenId',
+      );
+      await expect(child.directOwnerOf(childId1)).to.be.revertedWithCustomError(
+        child,
+        'ERC721InvalidTokenId',
+      );
+
+      await expect(parent.ownerOf(granchildId)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+      await expect(parent.directOwnerOf(granchildId)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+    });
+
+    it('can recursively burn nested token with the right number of recursive burns', async function () {
+      // Parent
+      // -> Child1
+      //      -> GrandChild1
+      //      -> GrandChild2
+      //        -> GreatGrandChild1
+      // -> Child2
+      // Total tree 5 (4 recursive burns)
+      const childId1 = 99;
+      const childId2 = 100;
+      const grandChild1 = 999;
+      const grandChild2 = 1000;
+      const greatGrandChild1 = 9999;
+      await child.nestMint(parent.address, childId1, parentId);
+      await child.nestMint(parent.address, childId2, parentId);
+      await child.nestMint(child.address, grandChild1, childId1);
+      await child.nestMint(child.address, grandChild2, childId1);
+      await child.nestMint(child.address, greatGrandChild1, grandChild2);
+      await parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, childId1);
+      await parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, childId2);
+      await child.connect(tokenOwner).acceptChild(childId1, 0, child.address, grandChild1);
+      await child.connect(tokenOwner).acceptChild(childId1, 0, child.address, grandChild2);
+      await child.connect(tokenOwner).acceptChild(grandChild2, 0, child.address, greatGrandChild1);
+
+      // 0 is not enough
+      await expect(parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 0))
+        .to.be.revertedWithCustomError(parent, 'MaxRecursiveBurnsReached')
+        .withArgs(child.address, childId1);
+      // 1 is not enough
+      await expect(parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 1))
+        .to.be.revertedWithCustomError(parent, 'MaxRecursiveBurnsReached')
+        .withArgs(child.address, grandChild1);
+      // 2 is not enough
+      await expect(parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 2))
+        .to.be.revertedWithCustomError(parent, 'MaxRecursiveBurnsReached')
+        .withArgs(child.address, grandChild2);
+      // 3 is not enough
+      await expect(parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 3))
+        .to.be.revertedWithCustomError(parent, 'MaxRecursiveBurnsReached')
+        .withArgs(child.address, greatGrandChild1);
+      // 4 is not enough
+      await expect(parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 4))
+        .to.be.revertedWithCustomError(parent, 'MaxRecursiveBurnsReached')
+        .withArgs(child.address, childId2);
+      // 5 is just enough
+      await parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 5);
+    });
+
+    async function checkBurntParent() {
+      expect(await parent.balanceOf(addrs[1].address)).to.equal(0);
+      await expect(parent.ownerOf(parentId)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+    }
+  });
+
+  describe('Transferring Active Children', async function () {
+    let parentId: number;
+    let childId1: number;
+
+    beforeEach(async function () {
+      parentId = 1;
+      childId1 = 99;
+      await parent.mint(tokenOwner.address, parentId);
+      await child.nestMint(parent.address, childId1, parentId);
+      await parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, childId1);
+    });
+
+    it('can transfer child with to as root owner', async function () {
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, tokenOwner.address, 0, 0, child.address, childId1, false, '0x'),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, false);
+
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child to another address', async function () {
+      const toOwnerAddress = addrs[2].address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, child.address, childId1, false, '0x'),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, false);
+
+      await checkChildMovedToRootOwner(toOwnerAddress);
+    });
+
+    it('can transfer child to another NFT', async function () {
+      const newOwnerAddress = addrs[2].address;
+      const newParentId = 2;
+      await parent.mint(newOwnerAddress, newParentId);
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(
+            parentId,
+            parent.address,
+            newParentId,
+            0,
+            child.address,
+            childId1,
+            false,
+            '0x',
+          ),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, false);
+
+      expect(await child.ownerOf(childId1)).to.eql(newOwnerAddress);
+      expect(await child.directOwnerOf(childId1)).to.eql([parent.address, bn(newParentId), true]);
+      expect(await parent.pendingChildrenOf(newParentId)).to.eql([[bn(childId1), child.address]]);
+    });
+
+    it('cannot transfer child out of index', async function () {
+      const toOwnerAddress = addrs[2].address;
+      const badIndex = 2;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, badIndex, child.address, childId1, false, '0x'),
+      ).to.be.revertedWithCustomError(parent, 'ChildIndexOutOfRange');
+    });
+
+    it('cannot transfer child if address or id do not match', async function () {
+      const otherAddress = addrs[1].address;
+      const otherChildId = 9999;
+      const toOwnerAddress = addrs[2].address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, otherAddress, childId1, false, '0x'),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, child.address, otherChildId, false, '0x'),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+    });
+
+    it('can transfer child if approved', async function () {
+      const transferer = addrs[1];
+      const toOwner = tokenOwner.address;
+      await parent.connect(tokenOwner).approve(transferer.address, parentId);
+
+      await parent
+        .connect(transferer)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, false, '0x');
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child if approved for all', async function () {
+      const operator = addrs[2];
+      const toOwner = tokenOwner.address;
+      await parent.connect(tokenOwner).setApprovalForAll(operator.address, true);
+
+      await parent
+        .connect(operator)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, false, '0x');
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child with grandchild and children are ok', async function () {
+      const toOwner = tokenOwner.address;
+      const grandchildId = 999;
+      await child.nestMint(child.address, grandchildId, childId1);
+
+      // Transfer child from parent.
+      await parent
+        .connect(tokenOwner)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, false, '0x');
+
+      // New owner of child
+      expect(await child.ownerOf(childId1)).to.eql(tokenOwner.address);
+      expect(await child.directOwnerOf(childId1)).to.eql([tokenOwner.address, bn(0), false]);
+
+      // Grandchild is still owned by child
+      expect(await child.ownerOf(grandchildId)).to.eql(tokenOwner.address);
+      expect(await child.directOwnerOf(grandchildId)).to.eql([child.address, bn(childId1), true]);
+    });
+
+    it('cannot transfer child if not child root owner', async function () {
+      const toOwner = tokenOwner.address;
+      const notOwner = addrs[3];
+      await expect(
+        parent.connect(notOwner).transferChild(parentId, toOwner, 0, 0, child.address, childId1, false, '0x'),
+      ).to.be.revertedWithCustomError(child, 'ERC721NotApprovedOrOwner');
+    });
+
+    it('cannot transfer child from not existing parent', async function () {
+      const badChildId = 99;
+      const toOwner = tokenOwner.address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(badChildId, toOwner, 0, 0, child.address, childId1, false, '0x'),
+      ).to.be.revertedWithCustomError(child, 'ERC721InvalidTokenId');
+    });
+
+    async function checkChildMovedToRootOwner(rootOwnerAddress?: string) {
+      if (rootOwnerAddress === undefined) {
+        rootOwnerAddress = tokenOwner.address;
+      }
+      expect(await child.ownerOf(childId1)).to.eql(rootOwnerAddress);
+      expect(await child.directOwnerOf(childId1)).to.eql([rootOwnerAddress, bn(0), false]);
+
+      // Transferring updates balances downstream
+      expect(await child.balanceOf(rootOwnerAddress)).to.equal(1);
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+    }
+  });
+
+  describe('Transferring Pending Children', async function () {
+    let parentId: number;
+    let childId1: number;
+
+    beforeEach(async function () {
+      parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+    });
+
+    it('can transfer child with to as root owner', async function () {
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, tokenOwner.address, 0, 0, child.address, childId1, true, '0x'),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, true);
+
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child to another address', async function () {
+      const toOwnerAddress = addrs[2].address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, child.address, childId1, true, '0x'),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, true);
+
+      await checkChildMovedToRootOwner(toOwnerAddress);
+    });
+
+    it('can transfer child to another NFT', async function () {
+      const newOwnerAddress = addrs[2].address;
+      const newParentId = 2;
+      await parent.mint(newOwnerAddress, newParentId);
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(
+            parentId,
+            parent.address,
+            newParentId,
+            0,
+            child.address,
+            childId1,
+            true,
+            '0x',
+          ),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, true);
+
+      expect(await child.ownerOf(childId1)).to.eql(newOwnerAddress);
+      expect(await child.directOwnerOf(childId1)).to.eql([parent.address, bn(newParentId), true]);
+      expect(await parent.pendingChildrenOf(newParentId)).to.eql([[bn(childId1), child.address]]);
+    });
+
+    it('cannot transfer child out of index', async function () {
+      const toOwnerAddress = addrs[2].address;
+      const badIndex = 2;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, badIndex, child.address, childId1, true, '0x'),
+      ).to.be.revertedWithCustomError(parent, 'PendingChildIndexOutOfRange');
+    });
+
+    it('cannot transfer child if address or id do not match', async function () {
+      const otherAddress = addrs[1].address;
+      const otherChildId = 9999;
+      const toOwnerAddress = addrs[2].address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, otherAddress, childId1, true, '0x'),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, child.address, otherChildId, true, '0x'),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+    });
+
+    it('can transfer child if approved', async function () {
+      const transferer = addrs[1];
+      const toOwner = tokenOwner.address;
+      await parent.connect(tokenOwner).approve(transferer.address, parentId);
+
+      await parent
+        .connect(transferer)
+        .transferChild(parentId, toOwner, 0, 0,child.address, childId1, true, '0x');
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child if approved for all', async function () {
+      const operator = addrs[2];
+      const toOwner = tokenOwner.address;
+      await parent.connect(tokenOwner).setApprovalForAll(operator.address, true);
+
+      await parent
+        .connect(operator)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, true, '0x');
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child with grandchild and children are ok', async function () {
+      const toOwner = tokenOwner.address;
+      const grandchildId = 999;
+      await child.nestMint(child.address, grandchildId, childId1);
+
+      // Transfer child from parent.
+      await parent
+        .connect(tokenOwner)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, true, '0x');
+
+      // New owner of child
+      expect(await child.ownerOf(childId1)).to.eql(tokenOwner.address);
+      expect(await child.directOwnerOf(childId1)).to.eql([tokenOwner.address, bn(0), false]);
+
+      // Grandchild is still owned by child
+      expect(await child.ownerOf(grandchildId)).to.eql(tokenOwner.address);
+      expect(await child.directOwnerOf(grandchildId)).to.eql([child.address, bn(childId1), true]);
+    });
+
+    it('cannot transfer child if not child root owner', async function () {
+      const toOwner = tokenOwner.address;
+      const notOwner = addrs[3];
+      await expect(
+        parent.connect(notOwner).transferChild(parentId, toOwner, 0, 0, child.address, childId1, true, '0x'),
+      ).to.be.revertedWithCustomError(child, 'ERC721NotApprovedOrOwner');
+    });
+
+    it('cannot transfer child from not existing parent', async function () {
+      const badChildId = 99;
+      const toOwner = tokenOwner.address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(badChildId, toOwner, 0, 0, child.address, childId1, true, '0x'),
+      ).to.be.revertedWithCustomError(child, 'ERC721InvalidTokenId');
+    });
+
+    async function checkChildMovedToRootOwner(rootOwnerAddress?: string) {
+      if (rootOwnerAddress === undefined) {
+        rootOwnerAddress = tokenOwner.address;
+      }
+      expect(await child.ownerOf(childId1)).to.eql(rootOwnerAddress);
+      expect(await child.directOwnerOf(childId1)).to.eql([rootOwnerAddress, bn(0), false]);
+
+      // Transferring updates balances downstream
+      expect(await child.balanceOf(rootOwnerAddress)).to.equal(1);
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+    }
+  });
+
+  describe('Transfer', async function () {
+    it('can transfer token', async function () {
+      const firstOwner = addrs[1];
+      const newOwner = addrs[2];
+      const tokenId1 = 1;
+      await parent.mint(firstOwner.address, tokenId1);
+      await parent.connect(firstOwner).transfer(newOwner.address, tokenId1);
+
+      // Balances and ownership are updated
+      expect(await parent.ownerOf(tokenId1)).to.eql(newOwner.address);
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(0);
+      expect(await parent.balanceOf(newOwner.address)).to.equal(1);
+    });
+
+    it('cannot transfer not owned token', async function () {
+      const firstOwner = addrs[1];
+      const newOwner = addrs[2];
+      const tokenId1 = 1;
+      await parent.mint(firstOwner.address, tokenId1);
+      await expect(
+        parent.connect(newOwner).transfer(newOwner.address, tokenId1),
+      ).to.be.revertedWithCustomError(child, 'NotApprovedOrDirectOwner');
+    });
+
+    it('cannot transfer to address zero', async function () {
+      const firstOwner = addrs[1];
+      const tokenId1 = 1;
+      await parent.mint(firstOwner.address, tokenId1);
+      await expect(
+        parent.connect(firstOwner).transfer(ADDRESS_ZERO, tokenId1),
+      ).to.be.revertedWithCustomError(child, 'ERC721TransferToTheZeroAddress');
+    });
+
+    it('can transfer token from approved address (not owner)', async function () {
+      const firstOwner = addrs[1];
+      const approved = addrs[2];
+      const newOwner = addrs[3];
+      const tokenId1 = 1;
+      await parent.mint(firstOwner.address, tokenId1);
+
+      await parent.connect(firstOwner).approve(approved.address, tokenId1);
+      await parent.connect(firstOwner).transfer(newOwner.address, tokenId1);
+
+      expect(await parent.ownerOf(tokenId1)).to.eql(newOwner.address);
+    });
+
+    it('can transfer not nested token with child to address and owners/children are ok', async function () {
+      const firstOwner = addrs[1];
+      const newOwner = addrs[2];
+      const parentId = 1;
+      await parent.mint(firstOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      await parent.connect(firstOwner).transfer(newOwner.address, parentId);
+
+      // Balances and ownership are updated
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(0);
+      expect(await parent.balanceOf(newOwner.address)).to.equal(1);
+
+      expect(await parent.ownerOf(parentId)).to.eql(newOwner.address);
+      expect(await parent.directOwnerOf(parentId)).to.eql([newOwner.address, bn(0), false]);
+
+      // New owner of child
+      expect(await child.ownerOf(childId1)).to.eql(newOwner.address);
+      expect(await child.directOwnerOf(childId1)).to.eql([parent.address, bn(parentId), true]);
+
+      // Parent still has its children
+      expect(await parent.pendingChildrenOf(parentId)).to.eql([[bn(childId1), child.address]]);
+    });
+
+    it('cannot directly transfer nested child', async function () {
+      const firstOwner = addrs[1];
+      const newOwner = addrs[2];
+      const parentId = 1;
+      await parent.mint(firstOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      await expect(
+        child.connect(firstOwner).transfer(newOwner.address, childId1),
+      ).to.be.revertedWithCustomError(child, 'NotApprovedOrDirectOwner');
+    });
+
+    it('can transfer parent token to token with same owner, family tree is ok', async function () {
+      const firstOwner = addrs[1];
+      const grandParentId = 999;
+      await parent.mint(firstOwner.address, grandParentId);
+      const parentId = 1;
+      await parent.mint(firstOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      // Check balances
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(2);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+
+      // Transfers token parentId to (parent.address, token grandParentId)
+      await parent.connect(firstOwner).nestTransfer(parent.address, parentId, grandParentId);
+
+      // Balances unchanged since root owner is the same
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(1);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+      expect(await parent.balanceOf(parent.address)).to.equal(1);
+
+      // Parent is still owner of child
+      let expected = [bn(childId1), child.address];
+      checkAcceptedAndPendingChildren(parent, parentId, [expected], []);
+      // Ownership: firstOwner > newGrandparent > parent > child
+      expected = [bn(parentId), parent.address];
+      checkAcceptedAndPendingChildren(parent, grandParentId, [], [expected]);
+    });
+
+    it('can transfer parent token to token with different owner, family tree is ok', async function () {
+      const firstOwner = addrs[1];
+      const otherOwner = addrs[2];
+      const grandParentId = 999;
+      await parent.mint(otherOwner.address, grandParentId);
+      const parentId = 1;
+      await parent.mint(firstOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      // Check balances
+      expect(await parent.balanceOf(otherOwner.address)).to.equal(1);
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(1);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+
+      // firstOwner calls parent to transfer parent token parent
+      await parent.connect(firstOwner).nestTransfer(parent.address, parentId, grandParentId);
+
+      // Balances update
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(0);
+      expect(await parent.balanceOf(parent.address)).to.equal(1);
+      expect(await parent.balanceOf(otherOwner.address)).to.equal(1);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+
+      // Parent is still owner of child
+      let expected = [bn(childId1), child.address];
+      checkAcceptedAndPendingChildren(parent, parentId, [expected], []);
+      // Ownership: firstOwner > newGrandparent > parent > child
+      expected = [bn(parentId), parent.address];
+      checkAcceptedAndPendingChildren(parent, grandParentId, [], [expected]);
+    });
+  });
+
+  describe('Nest Transfer', async function () {
+    let firstOwner: SignerWithAddress;
+    let parentId: number;
+    let childId1: number;
+
+    beforeEach(async function () {
+      firstOwner = addrs[1];
+      parentId = 1;
+      childId1 = 99;
+      await parent.mint(firstOwner.address, parentId);
+      await child.mint(firstOwner.address, childId1);
+    });
+
+    it('cannot nest tranfer from non immediate owner (owner of parent)', async function () {
+      const otherParentId = 2;
+      await parent.mint(firstOwner.address, otherParentId);
+      // We send it to the parent first
+      await child.connect(firstOwner).nestTransfer(parent.address, childId1, parentId);
+      // We can no longer nest transfer it, even if we are the root owner:
+      await expect(
+        child.connect(firstOwner).nestTransfer(parent.address, childId1, otherParentId),
+      ).to.be.revertedWithCustomError(child, 'NotApprovedOrDirectOwner');
+    });
+
+    it('cannot nest tranfer to same NFT', async function () {
+      // We can no longer nest transfer it, even if we are the root owner:
+      await expect(
+        child.connect(firstOwner).nestTransfer(child.address, childId1, childId1),
+      ).to.be.revertedWithCustomError(child, 'NestableTransferToSelf');
+    });
+
+    it('cannot nest tranfer a descendant same NFT', async function () {
+      // We can no longer nest transfer it, even if we are the root owner:
+      await child.connect(firstOwner).nestTransfer(parent.address, childId1, parentId);
+      const grandChildId = 999;
+      await child.nestMint(child.address, grandChildId, childId1);
+      // Ownership is now parent->child->granChild
+      // Cannot send parent to grandChild
+      await expect(
+        parent.connect(firstOwner).nestTransfer(child.address, parentId, grandChildId),
+      ).to.be.revertedWithCustomError(child, 'NestableTransferToDescendant');
+      // Cannot send parent to child
+      await expect(
+        parent.connect(firstOwner).nestTransfer(child.address, parentId, childId1),
+      ).to.be.revertedWithCustomError(child, 'NestableTransferToDescendant');
+    });
+
+    it('cannot nest tranfer if ancestors tree is too deep', async function () {
+      let lastId = childId1;
+      for (let i = 101; i <= 200; i++) {
+        await child.nestMint(child.address, i, lastId);
+        lastId = i;
+      }
+      // Ownership is now parent->child->child->child->child...->lastChild
+      // Cannot send parent to lastChild
+      await expect(
+        parent.connect(firstOwner).nestTransfer(child.address, parentId, lastId),
+      ).to.be.revertedWithCustomError(child, 'NestableTooDeep');
+    });
+
+    it('cannot nest tranfer if not owner', async function () {
+      const notOwner = addrs[3];
+      await expect(
+        child.connect(notOwner).nestTransfer(parent.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'NotApprovedOrDirectOwner');
+    });
+
+    it('cannot nest tranfer to address 0', async function () {
+      await expect(
+        child.connect(firstOwner).nestTransfer(ADDRESS_ZERO, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'ERC721TransferToTheZeroAddress');
+    });
+
+    it('cannot nest tranfer to a non contract', async function () {
+      const newOwner = addrs[2];
+      await expect(
+        child.connect(firstOwner).nestTransfer(newOwner.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'IsNotContract');
+    });
+
+    it('cannot nest tranfer to contract if it does implement INestable', async function () {
+      const ERC721 = await ethers.getContractFactory('ERC721Mock');
+      const nonNestable = await ERC721.deploy('Non receiver', 'NR');
+      await nonNestable.deployed();
+      await expect(
+        child.connect(firstOwner).nestTransfer(nonNestable.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'NestableTransferToNonNestableImplementer');
+    });
+
+    it('can nest tranfer to INestable contract', async function () {
+      await child.connect(firstOwner).nestTransfer(parent.address, childId1, parentId);
+      expect(await child.ownerOf(childId1)).to.eql(firstOwner.address);
+      expect(await child.directOwnerOf(childId1)).to.eql([parent.address, bn(parentId), true]);
+    });
+
+    it('cannot nest tranfer to non existing parent token', async function () {
+      const notExistingParentId = 9999;
+      await expect(
+        child.connect(firstOwner).nestTransfer(parent.address, childId1, notExistingParentId),
+      ).to.be.revertedWithCustomError(parent, 'ERC721InvalidTokenId');
+    });
+  });
+
+  async function checkNoChildrenNorPending(parentId: number): Promise<void> {
+    expect(await parent.pendingChildrenOf(parentId)).to.eql([]);
+    expect(await parent.childrenOf(parentId)).to.eql([]);
+  }
+
+  async function checkAcceptedAndPendingChildren(
+    contract: NestableTokenMock,
+    tokenId1: number,
+    expectedAccepted: any[],
+    expectedPending: any[],
+  ) {
+    const accepted = await contract.childrenOf(tokenId1);
+    expect(accepted).to.eql(expectedAccepted);
+
+    const pending = await contract.pendingChildrenOf(tokenId1);
+    expect(pending).to.eql(expectedPending);
+  }
+});

From 9005f86e77b449dcd28a22b4ad000e0fe8b742be Mon Sep 17 00:00:00 2001
From: yaruno <jarno.marttila@sujuwa.fi>
Date: Fri, 16 Dec 2022 12:04:43 +0100
Subject: [PATCH 044/274] Added security considerations and backwards
 compatibility texts (#6152)

---
 EIPS/eip-5023.md | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-5023.md b/EIPS/eip-5023.md
index 10d806b1573782..6925e4cf1d358b 100644
--- a/EIPS/eip-5023.md
+++ b/EIPS/eip-5023.md
@@ -74,7 +74,7 @@ These tree structures can be further aggregated and collapsed to network represe
 
 ## Backwards Compatibility
 
-TBD
+This proposal is backwards compatible with EIP-721 and EIP-1155.
 
 ## Reference Implementation
 
@@ -161,7 +161,8 @@ contract ShareableERC721 is ERC721URIStorage, Ownable, IERC5023 /* EIP165 */ {
 
 ## Security Considerations
 
-Needs discussion.
+Reference implementation should not be used as is in production.
+There are no other security considerations related directly to implementation of this standard.
 
 ## Copyright
 

From 41411befcda6363f4b1b7f5ccb49e44d1deb3888 Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Fri, 16 Dec 2022 14:34:53 +0100
Subject: [PATCH 045/274] Replace mermaid with images (#6154)

Replaced Mermaid diagrams with images, because the diagrams werent being
rendered in the official collection of EIPs.
---
 EIPS/eip-6059.md                              |  36 +++---------------
 .../eip-6059/img/eip-6059-abandon-child.png   | Bin 0 -> 9616 bytes
 .../eip-6059/img/eip-6059-nestable-tokens.png | Bin 0 -> 20693 bytes
 assets/eip-6059/img/eip-6059-reject-child.png | Bin 0 -> 9497 bytes
 .../img/eip-6059-transfer-child-to-eoa.png    | Bin 0 -> 12219 bytes
 .../img/eip-6059-transfer-child-to-token.png  | Bin 0 -> 14063 bytes
 assets/eip-6059/img/eip-6059-unnest-child.png | Bin 0 -> 8761 bytes
 7 files changed, 6 insertions(+), 30 deletions(-)
 create mode 100644 assets/eip-6059/img/eip-6059-abandon-child.png
 create mode 100644 assets/eip-6059/img/eip-6059-nestable-tokens.png
 create mode 100644 assets/eip-6059/img/eip-6059-reject-child.png
 create mode 100644 assets/eip-6059/img/eip-6059-transfer-child-to-eoa.png
 create mode 100644 assets/eip-6059/img/eip-6059-transfer-child-to-token.png
 create mode 100644 assets/eip-6059/img/eip-6059-unnest-child.png

diff --git a/EIPS/eip-6059.md b/EIPS/eip-6059.md
index fe98f0b0fd8a51..4a6692e713cc0c 100644
--- a/EIPS/eip-6059.md
+++ b/EIPS/eip-6059.md
@@ -21,16 +21,7 @@ The process of nesting an NFT into another is functionally identical to sending
 
 An NFT can be owned by a single other NFT, but can in turn have a number of NFTs that it owns. This proposal establishes the framework for the parent-child relationships of NFTs. A parent token is the one that owns another token. A child token is a token that is owned by another token. A token can be both a parent and child at the same time. Child tokens of a given token can be fully managed by the parent token's owner, but can be proposed by anyone.
 
-```mermaid
-graph LR
-    Z(EOA owning parent NFT) --> A[Parent NFT]
-    A --> B[Child NFT]
-    A --> C[Child NFT]
-    A --> D[Child NFT]
-    C --> E[Child's child NFT]
-    C --> F[Child's child NFT]
-    C --> G[Child's child NFT]
-```
+![Nestable tokens](../assets/eip-6059/img/eip-6059-nestable-tokens.png)
 
 The graph illustrates how a child token can also be a parent token, but both are still administered by the root parent token's owner.
 
@@ -465,38 +456,23 @@ Based on the desired state transitions, the values of these parameters have to b
 
 1. **Reject child token**
 
-```mermaid
-graph LR
-    A(to = 0x0, isPending = true, destinationId = 0) -->|transferChild| B[Rejected child token]
-```
+![Reject child token](../assets/eip-6059/img/eip-6059-reject-child.png)
 
 2. **Abandon child token**
 
-```mermaid
-graph LR
-    A(to = 0x0, isPending = false, destinationId = 0) -->|transferChild| B[Abandoned child token]
-```
+![Abandon child token](../assets/eip-6059/img/eip-6059-abandon-child.png)
 
 3. **Unnest child token**
 
-```mermaid
-graph LR
-    A(to = rootOwner, destinationId = 0) -->|transferChild| B[Unnested child token]
-```
+![Unnest child token](../assets/eip-6059/img/eip-6059-unnest-child.png)
 
 4. **Transfer the child token to an EOA or an `ERC721Receiver`**
 
-```mermaid
-graph LR
-    A(to = newEoAToReceiveTheToken, destinationId = 0) -->|transferChild| B[Transferred child token to EOA or ERC721Receiver]
-```
+![Transfer child token to EOA](../assets/eip-6059/img/eip-6059-transfer-child-to-eoa.png)
 
 5. **Transfer the child token into a new parent token**
 
-```mermaid
-graph LR
-    A(to = collectionSmartContractOfNewParent, destinationId = IdOfNewParentToken) -->|transferChild| B[Transferred child token in a new parent token's pending array]
-```
+![Transfer child token to parent token](../assets/eip-6059/img/eip-6059-transfer-child-to-token.png)
 
 This state change places the token in the pending array of the new parent token. The child token still needs to be accepted by the new parent token's root owner in order to be placed into the active array of that token.
 
diff --git a/assets/eip-6059/img/eip-6059-abandon-child.png b/assets/eip-6059/img/eip-6059-abandon-child.png
new file mode 100644
index 0000000000000000000000000000000000000000..e97465dbca45f132f9371eab01fbde41a08ef657
GIT binary patch
literal 9616
zcmbVybySq$*DZ>)gdixbfOJWNNC=V=0z-F8igXP~N`sVyba!{7fHX67N(|l73~(QQ
z-@W&{f82lWU2E3xt{LWy=Q(Gez4tjG%8Jss*ksr!C@8qHGLkANC=ZLkF+V0cc>lFx
zxd{F|a8!|ghf+37v4w*20!3C*T+J<YZ^2db>C|G!(E%*Q5BB8gqun@PT%9;;T6N{@
zO4mx?f=cq=B#lpK8lRgqTkTH!v03tH8uO54X=a5GvtTmH#o!%KU+?$Cqmk(Pt*4Fr
zyAb9=49?7OTR<KASuy=y{C~YtbA-u#h~2W|>1P!}8LP@l9%K2vXc@tN`CjE$=|-O7
z>(0*a$fDt>L+Ca0<|F~`=aOwN%y+MZND216s&eABi*hQ=cZpC3tA;hW#|ll13$sm>
z734L%FNq$BUu=wy#vQH=7k}t}cJ%3qc>Oh6z?&Q033tLp1CJ}R2YiY_L*XB4iiKGG
zGF)WwtK7)aUp-)^D%ihs{Zji(Fi9iDwZ70+U#DD`tpYsWT^LzynUQ9+fvMZ>oOJM+
zq%i3yf5*BdWJA`?N3cPyyQoYYVj)2=zQ4V-AsjKn>`Wd}Md*G-bK_KPN8&6Q&5Y@n
zA*8^Dr6)a;MAy?Uba)y-mkpln1!mWE!MGT&F>G&Air2}8ZF}=h@A3(F0BMIE!y>lV
zGU=)lmjsW*-KgWq3P`M;Hl%1;hTWoz69iy$@lC{7eu9@3{d<Y&cPPTlt2{9}TEoLR
zN%*zs1?D@nEix+=wE#27h6KT*WpB0h=MZslBJe7}rcoyT&k@0*?En3c`GzYV?CPPN
zyo}5=ON<P%NQnB*nunLSI3*<|U&C4C(Q>+6O#$|QZT$h=lm9-f#VF#p(|yIyud(na
zVZe21&v0{;>SS{))Ymstx0ytv?1n>Mc;r`z|K{RC*b`b0$BV-@?2T7EJU==*jLhs@
zuTC7AoIc4VvMX$jWfRj%ozSz|ygWK`W%jax1O^P6j2DO;w;wDtE2N813b^j8<x)4(
z=(ot2ZNaoIE^96NqW4?8F0%%`O*hV$yD!>b2AhRNMrO$;<_UWyWF?#s5~UxWe0o=j
zkdEBlSdDt~Jr$|O)>|05YG#@P&y`oLv(ZxBcCk+|arT%KLL8i&Y^kP+Kn~7t_^`3D
zr)xeDNd!G!j#UzQ$;YS8wv{H};Fpo{0*OR!F13q_i;E*q;7Ta-E$*>)3r+FvCB!W1
zoM!z`FPDndON~b}#LcKYH%Bu|bQ_QNL^_rXdmj66adU^VrHhJw`x6_iAs#tya1Jrk
zw_9vc1PgF^I#r!(cWzF>>9X7Fb$hwX1*aAm4K8oHY8kf$KWy;6R+`{KCcpKp8wI!i
z<;$1;)`KO5(yvxdPEW<fY5RssoA99*hx+Q}c-`IEXx+g|bllwjjgF{lZ4QgAo?(~&
z{5g3_dN#*mE9>eIqIZ|6={_PKGm)D+<c5ZZ1;=M1BCVHeu^)Ntc89m%y;zSa`iD}c
zSe$l4VK7+N=qM%|+g|%=Ly>kPSAg}@3g+Wf39$~F@Cbz>A$iF5a`*LP>cy}(uAv(0
zLPAZ?$;dJ@GcOmZ%8OcUe;&JfoNPYHmWo)}UucH>ByQZ?v^?9J3r<g`R?Sz;HR=ws
z|GA#0kb;Se`-+1jD($T&tWcHV<n+}2bQ{tL8-v5UJ2I@G@E$n4x(^Qj7tq}7dEGB_
z*Xi%6+eR^v#Qi!xrbQVK5rNuoGWY{Z@y4Y>1qRh9aOQ$Q&<juk0|O<c?6M?+%O0T(
zp>_=HNJvGVAo^k$gC3J=n3H*)*>sMNr{>Djj!sVId7ih0lfn}V3Mgyr7Bc7ElLZ{4
z8tV?GE8i$2H=vH@j~LQ_c;2_zI``wP=cmRfy^k&~XEuw-Gqk&-)!^yrX_^?B@#x}q
z<kgNAIv&OQ>$9H|$@|yLqM}h*Sv0vjEv?Nfdkd$nBKi;&X|OQ;BO@F~&F-onKgP_K
zE0`IZm^e5(c27;6m%?HY=l$_4yNj(Ue73Wk-d9dFHOx?Qa#1K!2O*0)Yi(s!cYbmr
ztfj16!O70PpVLGr^2JnCNJ!|{FG&#HO3trX)WqCZeUJMFif5^I+x=%BPHb*6s+Vfx
ziKUCceC>L|-y?Sns2_YrUKqLT&&#~)qP3dj>F(`Ke1IyIk(t>hwE#BS?TY8CY^?d8
z#F^=7WBY@?2yzWs8Mp9uAD<?dy`hVv^oNI=W2p3s6f))dsLzGQ)8YA1W6kFbme%q*
zM71?FmXjsCOFr%8^TgNDFBfFx<bF*|_#+0U9ukl?hM;1&#Kgn|Wt(_|z39cD=Fw<s
z_xC4CNSMsYk<qaO30z@5l&ITsfz#CFAt1<WcyWj|UOa^v?Xn>tAfT$I_A7?=<J!gs
zyv3dT;X`vHOG`Q>e)@IHxw=wXLBW{W+8q@&HAaK;ZhQ<Z939M#X9gubL#0e$%a?a&
zVox@YUZ?Q;bpP960_T3gXh{V&6J-s7INGaUA|N7CP@iPc)qC6M{?8R1mrUY(-y0%g
zk=y7cm_W*nd@x;M^opFX#PsIs?exry<DNFfTz&b*`O@m>#6<T@<I8MmrJl~t!e1xD
z>7w01xKHTlgu7s{p#6nwSh0o=N>z3BOoPKK1|_Oj3=9}=-gsV}km@e~y_hT&)oc}t
zOW`k9t<EE@t8)&ubp)t-w!a`JCr6l&z~{6%8sFv}oKajX@8ZJu<jH`5kN#}!*2>D)
z_B)>AfB%losZlz*0%2SWwbmSYA1=d3M-3w>-#qFV%Z9NlL;Cy1vM~fczxaNAexQ;a
z#FUoCM*7;Au&0M!7>caW?e&M1-++sAdtYgiuw8}XlG8MJp3{?%OomfYeoLGR&P{{E
z`YW5_Ao(rwgoK1A^opsN9p7KcqioJMa>p_#ts@2!A5#cK$IwcDIp5bC{`n@jx|%!e
z8Hf4x*<PxMck=kS+ThU8)_5Ti6biMplGFL^@9*#M`Ey1=!MAMbC>3R8v1;?7ADl)H
zgMwh{Sqsgs;Q3#|;BW^gCsTl{4b9E)QXPKx+a~9oo&YSOwSh9-#x4LK4Xy`N^z`%%
zjg7CJHkGX=OR!}8`-GggmGc!T@u-Al6czDO`0dS?+Pp14eR>TbiOYZd;=;{kZ}#`z
zTzzF_r4jPth{taJx$hHNspz=4fUq!}moHzw%8N-)9|3qJ=%J?ltf8q%UCOmk8+8(i
z^nxOfIQ=oA%vO8K-OpG_RaG4WZMnE$S~ZqJ4i4>E#l_OWczUEFUJpT5ifx^uWWc;1
zs1;w2f0T}M_EF>I=$Dk1cK9nshfm#OVycGAQGWKAT133<cCl4wcfRqfPQ9ISvAQi-
zVJ7>}DkK<jCqHc$ni6QGv-*aI@8eida3*)%`mY!@45m*=TpL?Z@Do5#m4iu~aO+Tt
zhU4z^OYn_ya~-NgP<S?k1%Z3vx<7B)ANRy*3novcS<JHTrehUGs8eGZmcAs0lE8Y2
zZ)CJ{baL`Ar*q^Of%Ex`Rmbj3I=oDeq3!039H2x&SvP9*kBjHNv$d2@6Ld5+W8&hz
z)jG4G<5LZMMQv_y+@J?|8xV+QVq(%8{c=@CR+ff?Luu>Q-Q7JWPlQ7Q>gTu4^a#{^
zJ;Uyx_=W~Ig69Glj*cu<RdV}9a`K)4AqdUQNk9efiesYv(<ftryx0mSBbL$EXHSO;
z1!3Ut|2dzj-O>3Tn_lI1q;YYrw3?qDS?zu8gV^yw9(ms09Jv2TPUeOpos#)ZLCMiM
zKHc9Rdj8tjxUvO#du^7L<wEe3C+hN_gsdX8A3WvS&Q$qbD1iKnOI(^4hJ5_?`V0&V
z!R&e-@jI#UJ&TJWjgGneaf&~istv^%^YTbgguSl<=I1E@!Yi~xCEPDK)3mC4Vt<w*
z-}#(w6U!$KOX}zZXJok7SdJxFjC_Bv^`i+5C-3ue7b*JV=dy->ZMG+!&1b3vk%tnO
zI?2?+4ZSB@ChoVwfibkGhyTcbf%tw}H&bPXdv|01h*HSOtUvCu#(FA7uet3NjWH=o
zObodo6v^4vhDyrI9G%Fa3TkBU;Go|YJQtsYR_X&CtIb<#A681w$>J##At%PgCM|W+
zMu$~q7Z<#63Q{o;mVyo|n3<WKC<u`><|!yZl9w+X?=O9fu&%7Bp{FyoD>R83VD8;k
zQU7_&{+gS6AW6uX83iEOY8XdbhCw?Ndv15O7Kep}C4o(+=f`W4(eZIQcJ@dTHf>Jh
zUzlWkHhmx|r`vtnyP%$DyDwk83jF)muqTod6l{y>Mn?t|2L}h6*_se~g=Ef8FggGV
zfBO3$8ZNfDj~793EG#V6hf<{Bc?u62oVEzlz0XLUx5r;{auOIA7~E%ks-WZ3vKas@
zU#`z=*GJMvEYiJ$($c6j%5*y?CWsv!e|N|yfy7?j-ygm>TKzLLWOlUj+tl3rAprq_
zZ)>YJDO1OkfscZzDcw*CfA7)~H6<k_7guQ1wOZ_1a&j`mqKixiM|)~sMuxA5H@b<P
z-JcL5=}_BP5dHG<*2tUu<?ZcGkg8Z%Nh}5i+HYT|PI`;SHz`p%2QZ&YLyofs^Aw6P
z@eTY+Z7J!M(&W=c{6Xc+IgGAx-q9Ah$Uq}v7^VYp_V;h$ab>4{&x2PX-!#GckXw#r
zv4QWzG&B;!!(mGvbs*}3f~4*PprYb*Fs=1N8@sR<)_oPrj`B(pbi@K>fmQc{Nuyk!
zIYH6f934bpj@^PsI5|HA;fQUvq%<yW%T~l|oos9d!SM~k)#KzULYHYC=CebRJxj#@
z!7G0ix0DybPfGd;5Drq&cJa-vEn@it<R$kb3?+z1Np!URXUBi6b;wJ{E#FQ4Ucb%F
z&3@E(21{R41snpteKV`Enn(k9Mew8&&DM5L<s1V*l**ndQdDUqVRshd-_`X{?8@ok
zX!S-fkJTEpy)ATMwHF`UMo%mQ{!FC_D!>P)&A;7~rPhU7@VMw`$Z-Omy*+gh?vAX}
ziR*C}Bwta_d|3Cf*v(bM<>dwu@@!79Cp_r`h}>e0;N|tn|NLfh7ZlVl8^a1>9;kM(
zHPqa6i?OWFmvARQPBfcc&^~?Qc+JDJa(!?<R;ojNbw>HvSCZ!E{Fj?6v-$aC5_u5K
zIHIBmHgkXU2&2QluYV_ylc$Vkz1Kn6-J>K<dkn(n>99qsN5qfU-RVm{QQh!rv&tI%
z7B@vuU2JFFR`>S&>+7Su7665AblD?J;iv8zAODaB1)Bm2ZjR#ymE1qQ@3qz%8KtEP
zZWr{ImvE3aH1Eiq7#Kv&dLwZMf0Ac$w*2~)LvP@7gSOi1BWJuqbON-=l8=D4w)Vxv
zNrL^xrY3bXx@uLv8;ZpSIyM_QS8n_h-#@V%j3*SJwpE(+q62{dcnIXutw{Hpi->+O
z!*<T+0mw@_dIhq<iQ;FU;62Tnw-Bb@el_)<S)ubtR$6@gsJ~V9B@My&)O??voE~)y
z4=XNyxo861htsr=Akd6Oy+rw<jfjXy(DRHH3iWCIUJHt+*HvK+S}XMCD)p^r0!T+L
zt8vE5U!{QR!z+v=T3YX}hFe-%rdvJvCyF(C2L|NZyoQo_y-voY!^zL5MzQ$$`RPCW
z5YyGAVAGK+*HTbW$WuyZZ<o%=%ljT1>mMH<FSlXZ6@cZmJN*QOoSfWz@JDAni^k#c
zaaVV@|69*9Wlha5^2l_b+dufC$c~P$sEF7SA(!30TI;E`xyR2r4eNq~gPX1m=Ke#O
z4-da7jmV9mO^B2aj%8nenkae;mbJ!aCi2G*%d0a8a`9&>S>FNq&o}2C<Kup<p7qDq
z2Z^8Nr%MMt#PV{k-<@vvm`!?b7tyLUiYCNAGyDFXFeH3la%1@I55B!}loo^bOzb&@
zWFC2_K>?(g51tpXevHu6uC+2?#Zz975-oFB>w|)FNlUFbUa0C?rr)Z$BJ!fNotKvv
zME-|NcIe?>s@_OSpdrVOPiE_Gp3zEQRoTu7y?dw5ltV;P7d<%mxb4C?LKsCudN7kc
z{<iBb7=QJ?dH~+e$O=TkN?*(kU~?$ay&k{M933uwA;onp3aTUoiEBfzwLyJ8PDx5g
zAQ2b;_e0oS07!VVlg$oer8oBKx>fB<F2WlB)@|=o^BD1uR1_*Slv2-LH<W0={{7BC
zNh$rciJ#?66&qllZs3~wt+R|a>4}Nba&q61_Ii51GnQbm<ee!F)X%5e?*aW-+2B_;
z>I*C)G5}Fb3`27}V@(3w>5HQy5TfzrfOw%Q3$3apD=iSV8xX}NGb1*f2}1(7EsUq@
z?aA?}<|Paagv4ohPm^GKrKQ$m1u-mdTx>czI-<+;JO`Rv*mVUYpiq(SASU!2G&D4|
zay#8JFEcZ<qdEKbzdP3<T{#>IL+$LX)6<SmpFXXynV|^uHbY#@RGYT6dVdQES+5?U
z=eC<y0|`D5A2k)PE+wX&ch3=k08mk(0m9=c3CZ!X88Zn<(Gn-5@ytw)S*KsEhC<^$
zaa#O#tq4O*#b<QXb&ZW_YOUgL1$FiG!q_~IR?z0^?Kfb#^2Z79v=Z9}cfMlz1_q+>
z+sWu;C-Yhd#l$=@GBN@f9cez49G@H<5b%gf#7pMgyN6?AW4|XwJ<q0ib=slcfkBUF
z&NH?f)QDo+%LKJ{KFNh{bGMA7#SgE8B&+W_o@&2NO--GN=bhA`iJ7+8Xl0!eVPcZ~
z)stp&v{H@&Hj5GiZ<j{oR<ZC@s$BnOrrDJxk)s#ZP?^$yDkeKsR#&H(<ec8L{SD{Y
zaGZyaS}v9Pdi@eKv!bG6aM_yI>PP<_M;Jpt_lydk*7a!zg&0ktX8t*10G6p?JLlrX
z#)d^j#THgub}&~T0bGU7f{zb=Bx&^}CORvc^*5y#NaSJ^Rf!>n{$^{}Zu{0`FyW}-
zK7I_bV)t>R_B}b_3GDijl$1$ecrWdwd#~o(eK4r0myEC5XXe?jA0u#87EP_Jq}(o~
zfVr^>whNvU^2TwURrUEB9`g?be0+6k#pdC$s;DQYxz8-Dz~Z!ssLit38!8`b60ot^
zVq@nheW@ywlb27azoMve5+`dRB~LN5wET6@-aFP@?}S{T_R*D~i7~V<N4^;!9c4T}
z*GaaWo2+*KXXWKBYP8mek|wHT1Z<~QbqO+bg!er8Uiu9sbIep*;G{#F2sAYCRaDcB
z%*{XU783QBO)tiM|1Jr(w{Sz3<O7EunfOq$`R_>`ojDc2#=}SgtD!d<;p9`))ai>K
zl6iJY>A&~2=u3r$hW-Hl(7pb0JJclO{el=wdhT+tsB1M4%LR~}o}M>u9V2>UOM#fJ
zH(o10?!AsGM{7X=V~s8b2LlUBanx6p{PFe~&-mnIIYYx2S65e$Nx2?@s#a$+)3w?g
zCI2>|?##d}4@6u*P*9cKf{>rT|EKwe*W4Dvzko8^Y8y$H4_3yd64qS&awRnL9Ab7^
zs^2OEAd-$g!Dl*<wSl!zmnk+i^~34*L>StBIecP5?`(Ub_)C33(eYm(x19`><}@)X
z)Oi=Ep#tABGoP@tQ{7AShRQeS=t01o;Qq3fLwFv$5DaWBW?lRi=w6Y^d0}xR<IZh?
zoPJ!)#E`jp0`mba4*P)WFhJKr{RK_iRUvty@`+;dSP&?jE#^CuwZH&y_}jtmakhJ>
zeeip(mttFm>Ff4RDSj2^+qZg0g@?a!KAF8@iMGE&B&KUt7>2@}t7Jv&zY})_;~yAV
z>*%y0k5(~&0O`An1Sl|BN)9+r^%q1tLJtqf-QydB^NS<Y!9mt>m2bPdyIM^=ehm!<
zS`CM)2^<C)1O&X6qmr3e20eWRWPnw~xgd(<TsqsmlC+n3;>O0ubA0ZWZKf*-6%@7_
zIwgW#RyX)D$;owcuUkA$u??17<fd8|Z!$wuQz>X@`Bzrq<UV(we65tK0nvN(XfVru
z=_RYKKm_21HVap8CyF2&zr!{(wP*Wuv{;Iya6i5OI4kILL&mswZ9A5QJCt0z(tO}j
z;j)L#%34Ay@Hx(_wWzvP-VxFNo?Wl0qeM%7ZB@a*e!@*ptG9Tw)*vA?VYR<RwLdF6
zH{AiyV!6Gma-I6Jft%}da=&e}<?DlXaKUE*fq_OwFK^laHy?Pcwq$By(VO)?tikJ&
zOFn^hd4QwcbV~(c&-|L}`(!puHq-?n6bb6e@bIv1n^)2^4t>U&AL{5p33739_1!yN
znV&a?e-1Do6BVVUrM*HgdjI}?J~j@H|LV$$V&smo%L8K63E-0fyF$jpgY2y*^V#%I
zz%QTB(kD!FGd8DLjTdN@d1TNPjo%mG{wC3Wk4ODF7JWgSd3hqS_^8E?L5B48$#B%B
z#`o@QK+fL!o;U)k%6JkTPD&I2?2B-!h2Xxvh{xpg-b6t{#(2&jcRbb17D~(caZ-}B
z3<1dx#Ibl<_tyJL;OYt;#2Aah05Gg3id~s+0KGn{)Odk=Oh<?XJcU?}X6Oy}pFc{U
zW>m<Y=H`iPq}aa$zQ&tah7rWC5LyaR=yMcQR8$Iz)C)jZK@OlEZbRrRD=iS$?QAnq
zFB_Wqv)_l+&9~hI%U!#>)vRq#$j>+BHniHn{Ft{VOM@k8Uef2exz5dPk7ZK>qefQ2
zTgu#Ah}(kQXm>h;uzm^-XF0mwTWmE5xn_#}`SU#>p~J&Iy!3z2X9m)4%^p~IcqDs~
z&$t@d>V@gIqDLnsb;9$NF8=zHfV*)#{A(Au8n>Z4@SGIV-QORinjiURU_51hA=lpf
zV!xU46_rwg1}-ixaHawZ3maQ@8JqW+nb{OP7E=L5N^Es!hrHE)Uw%{dU&Zj4J?6Bd
zWzkzdxu%9EJR$-iUSy-?PVHfefDa8t05Rvdq4-Bs&Dg>sI4Ox#I*JNnIrC>^gn@&j
ze9+|b;vzaWwi|dlPqpoUHwOH0gMs)1{;kc;==k_o?dm|BF|o3)jTg3W^eO?IR3v`-
z)TzPk$oM*R5ZV3(!Jj7VE(w%14GrJG9onNo8YZTXTasi+z>Y-yyFU3L*CT`Ve}_%c
z_h)9N_~p`(l1!`|N@V>q3~M*1HmhsnzFl4K6w`#Y_iF%I37hzRy2CF;6T_G~H9xNl
zd_0M4DLZU@77>v)O>J#>`I7S4?##P)ekU&>l&^!E3Tofiex&6GtrM-<ZJZ{jEwCSa
z3r(j$NK}?+R{l6VeC2g0j&q-oGt~^Fd^Rnx5H;mWJ0TMjA|a<uxep(BK=y;m`5AaZ
zXJ?Vevdk<Rau|wHAapA$u{K81%@O@R@PZg}Q1VW;d40hN2h*to^7Eg)em%CfW(o)P
z^rgf7`Lo``@6X>-tV8UBbch%cO;;F6qt4FHSF+jF3e>QOGv8G9F*X_D@;rM4wl_RP
zRsni*Y5{T)3lC3~3D<f@8}RLjY-#*x5LWQKQsCpPbOmx_o7gZL1LFb|T-J7XYfH=M
zROC}fM}!{z_U;uwA75u@XUNSpZQ;l6xbSeNIy=2E5W^z3d@sCBe1n3}0cSiszl#F`
z^tm7`5npsSytS1!7;mo!^cSqHb*v_e6oA+(F}Nd^mBkVengnPe3d9E8&g5Q9;>>+T
zwqN2)V2{WU_osigZV%QqAPAk?tY1dRb^og*%|}eRz1{86=5rLl->M8d)c_G#yZrYQ
zk81vR)_a5H-FaW&@}!F15iKr?0EcO?+Tzb~m5Gs2U~VpNv#Y(7v~=RhNg`O<jOm7V
z5FVRNzsN{Da(-w;R1}BnK2p|njUHuX)gB;P@$nH44-d1`USe(*qM>R#&NZa5QILd$
zWOt$Y8HiQjSAw3_+8>{?vN8%Gr*EY?^{@<aROs!c1u*&Vd{|fH!y^W$77sVleSnSn
z?tFg%csQ$obph{q4Mjpi!XL=E<I9b7ZrfQNFE1}f5d6K=J~<M>c)xr6+y2bWr5Hdj
z1A*g8NKLH-9Mis`A;f&6<K3NhV`#fV9%xFft*sFd5_SP=#&W6cEil?8B_#={siXY;
zQTgrWl`qA`Am#NLZ3;qTV;@278!J@B4_wRurg;@G-GBY^iYhLyVfcHtC#u=ZN8#xy
z4O&&h=Sv6KKuX>(B^j?(f);*3R!NhR-o53~TXmfE;ir)E7A%(mxOBh>RudN1{+@8=
z*ByMGa8*=Tb-$yaSx}-!KHL`*3%X-~$s-d%6wkMM;sCLt+YZhB<#1K*=zIzio%&n&
zd_c@cUO<DoJ3Fy}8F24G9v>f9R297kVbbDul&V!7ckbkcJo*g1SbkwWRc6@fr(FAs
zVmoV6Y+|yG4<NA_Jg;1<)=E%O5qER46ko6T4ET|W-q&>wz#aXdFhu%RsA76h&>1Kp
zcEC?SQ_lgw&u2$#Inds!sj0cx%BL1|qz?ja-tm!nEd9{R_QWl#4qq@a3*X;Wc*^cB
zD+spFmtR;x#<J=osRMCT!R7&X5PFGlYJ3Q>wWYMN-RUz}04NlPMU+=uQyvk)#-eUx
zxHn4-Y~BYUlBht%pX|=GQ&>n}xjQ?b3b-FLR#t9U0t17Ba%aGTUn8#B(-E{QvkxT;
z3Jd?_r=znB7L>DATlgqiT5<x)O|CO11e8SlR)Yg73JRLY{Vc#6*IPPfD~4<-G-ETf
z?wU_H({0{w+izU(FfbVA7gC-O5e*e<kWSCNskHpq&|>@;OY3)&v%&qx%iW%pwWaqB
z58@^>Q0z!aw{%<F+Q!9dRrB|OgI3{spgviOlkc+E1ahP+TlyR^2YlFW;6VCgxDt_j
zCM5F?SuV`#EC!mGLBe)-Z6?d~zJC4sq}3BYdSnIkt_}C+3A(ySsyv(-*Vom(E{rTL
z1N@IUxvLE)OL9x}DWw2Rk?}bp!Z;=?-2d@QzTeA%6rUl4^v(3H;~|mpOr?tMQ<mV_
zttVN54WLzRjtg?H#&)jm7ddoivXqq55CsFDYVB{QKalp{M@N;ry1E3MHlyW48H!3v
zBT7rzKtA~LTzGr)`N;O-;^6^GSz4k~j|VbOS69~(mb11a1E8PNas5M9R+a!1DX`>y
zPKl0=4mtqGe;Cr$E*@ZJcwe8*H@ilGB>ZxB>&?o>rq$y1ddce_F7Qx#Iy!to=T5oR
z<9ASLi>%%QW*ME!;k373^Yb+-U&?!UcmVEs2v-v2GV(j2OrrJ?4hQWv0WUXvbaW};
zL>q4^Z+R9$3Nh3&<reZIh2F(qXEVEhG(TQz)YO^)5}y&AEF>ujEiFyo-uVWfS|p~X
zCh?dWcWi3PVha{uqJ0|JGL~aI7s-6Hy#o5afIak_?d`ngE9-1<Pz4<q8qUvnfLU7H
z-TutU&o{C^kokO=D7R$y5XQyjablXlmeLJK=h2~MX2K5%O1Ym!&!0GX#ta1Wide(y
zkku7;Ti{>9K!$?WTYT%$ov)wY!%G%cvDx1u7Q=K-PEMFOItGD)#k%QUFk(P&!8Yd?
z4Tl~^dYsV($IekNQ9WDHtgOUimiwQR2mOmG$_xq$L)*lp+1va3Wh&>l$uq9(HD|R}
z=8$?T=r)9a89o6YY4q5>%<3plm8Yn_+2_S-!2o7Lqt6{4JfDNvbM@}Y^0GW=2Jx}!
z)OAl!2LN*<B&vN#n)=4^ASH_Gt(d`**sYxg7>|Gy{@YMNTTcJ*sED}Yiy5Z(HQvW7
z?b164;M4SimrTG|rWF;%2bC!Z@3eQy)evG)s<O7eUS<57W_=jfy|_&3KXVpx^baSn
zpTBVlMb;AgsWrP$ewr#XnIXTG0MxVM^D_2Fy!#Q1Ou`Vc+J};#X?z(mx|)B_&NeAQ
zHtv7FFn&e#zXmpxpZy>675~@69N0Za{xz6*S$><>0>*KWtELv~v}4h9>R?twoM2Hp
z7rlrOD^Z_*BUB6mF6#$VJr2eGf};fa@9$%~evagdj(A@1i0mBn-_NFq_9KXxF165_
z<co!<!K}wYHdk+fxw&<HWP~D=&hP&ICJ-AW4o=<KJhqe(ld2liA=ql*^bh;JmhZ-i
zU9`x9mmEcilRm@xB#Y|`Bhq3rD-+z{jbOHfkPuh)EL)TdW{`_$9hBpsAbh@zw7#FH
zX<ukgR_tHhEgBAbQJ@FAsY+jlT$vR;Nuj9vnsA48QSH7B7k0%BEm`7oydTbyeE<Ht
z#ryAm<dayZijgyHOa<FW%!B&flCEzT#aoe(pZMYhtb|w$#X|W1HLvpj`rZZN2St!}
W)Id&X;(p!=MfSa-WZ64IzyASXKs<H;

literal 0
HcmV?d00001

diff --git a/assets/eip-6059/img/eip-6059-nestable-tokens.png b/assets/eip-6059/img/eip-6059-nestable-tokens.png
new file mode 100644
index 0000000000000000000000000000000000000000..cfc15eca08d4bc99c02bb4dae5b2ff8fe1f2e453
GIT binary patch
literal 20693
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
R4)_!z=dJ8<jTT;a{{tjK>dF8B

literal 0
HcmV?d00001

diff --git a/assets/eip-6059/img/eip-6059-reject-child.png b/assets/eip-6059/img/eip-6059-reject-child.png
new file mode 100644
index 0000000000000000000000000000000000000000..2dc8979906f210bce8ffb413395cd6372fc56ab8
GIT binary patch
literal 9497
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

literal 0
HcmV?d00001

diff --git a/assets/eip-6059/img/eip-6059-transfer-child-to-eoa.png b/assets/eip-6059/img/eip-6059-transfer-child-to-eoa.png
new file mode 100644
index 0000000000000000000000000000000000000000..e623cbc0346492ea8aad6b6a2a2f8f1c7c3c6483
GIT binary patch
literal 12219
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

literal 0
HcmV?d00001

diff --git a/assets/eip-6059/img/eip-6059-transfer-child-to-token.png b/assets/eip-6059/img/eip-6059-transfer-child-to-token.png
new file mode 100644
index 0000000000000000000000000000000000000000..ee94447fcaef98ba846758cd5f0d2d621e4406f9
GIT binary patch
literal 14063
zcmb_@byQSQyEljl2qGxbD$*t0AfR-IARW@uAq@r~N=QkA<RIN$3P^_x-Q6MG@IB*u
z@49z=e_z&eK-O^P?0xore)a4CMR|$an8cW9XlS>kB%dpzp<Qi&pSf>dhu76Gt|#yf
z-9cGG6fLitbOjCVA)3^45mlG?jfuCa1VdvD+gp9lpFLM4Xu6MQ`NphC{CSR9iir1t
zUv1Of>OW0+-=7B>a+?vjZ`Cq5bBG5S5|Yq9%p@@1qWCxvY5Ynbuj|yKdz*A5A)(S?
zsoTn7i|mf*%|{>qPhZZ25v{Gig&H?UX{f0O)t(iuV}3<_KvNVA-6N&s3X2Cuj)o1t
zW@mWGh_{V*$xj+aeJbjB$#CF4W@W<CrkC}%`dW}Dlh5K3I>{Wz{<NyvydamMjPvjf
z4786Un(x!O<BPgr-5V*XzkFvp{T(fT0=~42kKHHh`jlMneJ>t4b61bLw#kJ=48NAu
z*g``xK?_FNE83cBCQ2?&gC4VmruB5^qWlTfdhXmyp7MQlYQEdw|J|hbr&|q?jVxMI
zbr1g7+9e^<PnZh>+E<<hu&6NOpGW7{mqy?`Ma>x2ko-ryou`^}TyC*-@#iXv)?s(K
z`t2CrFed2zo70u-S>=asXOuHc0`4n0*z+;|`|abH-#7)@x3)-SnXrRC56799<^H?e
zr^}u!PI~=s5t7yMIR5`0h-5|~2BQ>9p}mNfQL4hd2dGc|ba@3?bN&0nq4lKqj1K>O
z&03tNv}T6Z4;?7}O$=M>@N?nc&+yba5RLzNxP2>V`2Rls-^;8F4VnJ``meAYU&H^b
zfhO-*N1t2&`MZCg$nhZ_$LHT2wZ_vZB=-Lq8WN5~&K!B0NzMH7JzaEsi2CDXK_YbO
z|GCNqG7Uraf0ou6Vx<OSeX+~3>G$tdxALUU0DOP5zBE1&5!{HR<0F^8I!~hninWa~
z?(sTL_JO6tt*K-uOVhLSkd-|bbo8YM9GMJLp6Vpr<tKq;{9ph6eVRZ{N!iEe?bF*E
z<>Ic8Eap#LVy5(^J0Wgv<rphpPhyn=`_`>n+SSf45T~*s8M`=GSjGqIZ6#J?U+*(n
z{3$lIe3`2$3tw4Q3h_M8dlGZaM~cW9)R`YYp1mjNR`FxPdA4Z=n{@cq($bEBMl8n<
z`Ecri<IU>Pit6%T9hQ&b7Td~<OjMn9)`H36wokW^PG!PQu4Wz{0)lR54PjIcj?ScV
zEf{}yVp~Imo&T&9b|(r-!8LB(<U!c+>$I4Eeuu%&{zgL~Xl#9=I*3{>3!nHz`8Z}g
zYGiGWV|hdH1<_{7#l~o<)SOT;zqPOgYCQE`f`|{vvy-*%fyA7c+}zy1gGdnJo_@Z*
za0m6sN(WQTQi~Udn-kkRJG1+1Luj%wY`%}g{LIE%KHR`H8_FXy?T$x(`1tYr#jdzw
z_e1NT`muU%;jTDt8b-#YRr%F7Q*}ZehqBHmJbGvG0<L$T!yWUwIeKRtCd+y4+D+){
zxQmfF8He%3Sb0}g4)lDhdf`@7tV`+0kh;Ir!^>1=IrM3NP5t#6Yf)p%{;cO|8M4eu
zOjI;+Nk6krn@<O0z2RNL*}>Qot~Wf-^Rz1+E7va5yv|2eicJKiqnNXID&M_BH!*ST
z9U7WgfGTyr{*3Ko7?lh%cMMIp#-)3qV~LfM6FI`lMxVRueQ`$D=(qobZRei6d=RZ_
zYivP5)Og)FE;V%q-|Y|OhXhwJYzkhtT~F9l4=?HFhezA!fB1xvk${j;eP^L~elU0K
z=$L7tJrc{sjrmu@LtZ%n7h6Ky5IYX*Gcu>OD#Z$0JhVgs*QUO7hX)*HoizMOxSW=Q
zpGAG&xa`d1(I}8F9&KZE#+H68GG<tmbP<ZcAL2{xYZtqRdCkOR@c{{mci0?ybaeFU
znb+yvHqV&a{`8-tr3r;aMK7(3-S(BGBk4b+riSknvl-h9ttZ97i0?jl(E7_4%Yly;
zt*N=0)wrDilYq8ixX_4|y~E9ul7}Zclv3g@5s_4_+kQb&(PKu&K>oLz`i6!n`(Atd
z`!G8%^z?)~4B9g-2D0R?`k^`8#mD!qw_j+_&e<&1uFPK<Elt|l>RCyYV$eIgq~>2e
zpsQ;-P<I}%{J3eHc5zmTc%gz6h>nR_a(r6U*-A^8kzumD()PNpv)7#YY;z)te}{pl
zskv6=)b&pa)zNMb8K2-_0R9arNlE<^M~cp_-78-sB0h>H_paELgxZgnbYGTFQE#6(
zT`e|YN`@OK=42erc%}1OO>?Q%qZ0S$&z@*@(`yF@3lT|M<CS<66bfZlS~785ZIt#`
zu5>5o=l4wi6lP$r|MY2|Z!b?L&eqW}MLcMf@0N`?$D85zpYLU(^;S8VUdLW;UF`A-
zBv}fb@m%5a^tyGdqG`}SG-SFtE-XB<jdmUT!H?ZJ&w%+lS-Gggj4BR|ViO&U!JO<f
z_l;5Ef?@_4gnX@|edi^;RZ@j_R?+33REdutKR&hSr)`g9h`PY#ki1n~Ue2AbSO2@Q
z@k5buN5*9%2LY2Nfu7zJqc0r;0jBS@r%DP6HfE(314ZL_CN_HH?x#EL^`(`jLTY@9
zQ7k4eH4VCdoV*c#Eioa~9Hm%)tO4`>yl9;n;Z$fP|CE!nv6E3j{sv_SF^8G-hwF01
zHAyWY6b6=BvNs;NZOODEoCeXIryJxKyJYfY%dN)l_{=oY^j2)YMI+@aiE~=}w!1!J
z#K?rzn=^u2VzZUVBp7viU}buG;B@txU_&P(Zg8-?;~JNb$1!6-NQmh|`wLQmiZ89L
z>I4ig!<cnWl&hW3u_;W4^5ou3uD5hVJtClg{h`=FWwc}^Wqmt1Ai$t2)|gb-YkJBm
z$Ii}N{`6qeaceRRDzfwDcx!h8NnsIvXO>!Zgy0eyyGbWPvo!YEj%{DM%+j3)E*M60
z<2-zPe-J$i^KIedUp5wBCW(CbJ-g){vAd*TU}z}5yO_H&UdfGCSjb9CfQfxOC}QUF
zDW3I6kslHfGCkWzDqK(XT)b{JJAZv;(i2T0c)fY*@`0b9UquB6!n8+Zd2MZXbAtb6
zzHWP=(W&e9;|DSwS74FE!_erHvQCa%>{t5@{BX#6!l)*pynXa<xnk0jm~(K3fnj62
zze*L$ZIfWVr0!-;U(2%%rF(ns2099<(7Z1yKm78wT1Fz6sH7uOT(*^=R0a<ZKN!pz
zX*oZA3u}pJD4z!RT3LDiv#m)nHR9hfm77XRN~F9+QL&tBKi09PtG6y%26HV(%5C_q
zMjZ|ImM^p`?a_Tqy6TdxC$69EbjU6o_+q|dcRzT2pGi|<vgW?U95Xew-#vy!hrMMX
zLnEWYQYQI0E}cxhdRA^5U8B~on}OtlzSnQZ(v@HC4<&cTAA7C-Dm1zg%{piLGG{pN
z-~pA)s8Z%vP8Qv(mXR;}K0BzWuwR_4J+7-08m}h&<m*eNmev2={qWs<kKV(MAwJ5x
zckgP{y3qkNQ1S7_wnt{;lVtOi%BhTBfd%w>vW959%IP*cyF=Y^2J?sOK{LI{6BfI@
z(vhUggB$K>e2&W^hnpBBd`pBZ?_U)fq7yR5F9NI&kKRXky1$K22*;9@b9IhlX1aOH
zRo)jfGDh$e*T-?Un@MZX_Us6Ke4MY)u-W6+FI_`Z^>4{yEh;5u0gTP&&Q$;fScKh=
zpZ>l6?c242Ql`AKO_iyrug;Yz2!uqnbC9jQMQd;JT;$m0PKTm+V07lVsoAm&pOeM!
z0)u+PH}U)f7wm3&8Ik_#xhJ=Kl7x-7XGgAHji*%4(;gm)Om{y-Z}&TD3TT8G4h9H9
zjh~rWK4wx*uB$JX+bm2s=BN-J^HX>>zk?I<Y6y#C^F8EiYHN92cb=dDfZk{r8j2G2
z#r#w6?fsdMMSgp>c?6zBVPRp8X6fe}xa0-a6MPFLQts~VZU^g9D}Cwc74C=3loG+O
zXPW|YGz#CJ9&Q;K8~avQ^9Kh9qX~GOMIY}jIjjvb?aa4{1rc*Tc&d-KHk9Ae(}U}S
zM=7pvZQVUuYWZ$n0BU<ADZg{z+pS3hOUo~DaU}BcZK;v+i2?!s{x{}YLQFfpF<rfW
zy)Q$K1nOPel=o#&c6Rp51iftae3Pxo+9%Z1$_RNfx5Le#&`>;o9I{_yV<bL5R1nHg
z$T$w|4mWk~v*>nijFq=Vu~3wil@Zl(#V%J-GBV-e<(rL_J*subo#{@{isyB}=C3XS
zd}lk@n)(Ulpu+nSr_v#AdRp<z#kqvOK`3r7vyJfEO@g|*U6+G(R$t7K-jo+4nq_Yg
zta`F6my!%yuIGGV=E&bq4c-&RapleeMgwaLvYt3WXkA>Xal6-@@}k~uvC|Gl{bHeg
zp!9R2<xt-AQu#;ki(?WW)Jg<^v*)N6MbCc8WYCk?_2kJD#e7|{lLIop&`_mVCwC`~
zNU7E3s&jzytH3c?Z6@iB8#PqimtY9kB!eI5R2FB~_(R+euK-YIsOSIe&)Ux&H4^Z?
z;83fjW<Pzmx5l?>rlt2sRXmVFI2vd`p~o@T!hz+`iE_$wy2!r=s{?+(2-pmpnp9^h
zVCiDqa85C3Ts+(DnfmxqAXPHdu*7mHZ+*OV(_S-be~IN0lYI1aIw^XY*Ey#1`fx)W
zcW4B?njfklm#%VKG_u*v+L8;^d`ZxG#jL~kB{7kl)1p6FAt|Xfsz*7SBUR2r>}21N
zB|iYFIhM~vb&sLG{#R>HtgtnI)UJ6rO$s$qHCHoS1%Wd+HzyHrH(fcw;bot$=CPwc
zjv(je?oyKX6E?Oh6iI6I2Cz1-L0Qm0`g_YFUqO5&2O~#3h_A$YBBm?uJX*jN2N(eX
zU0A#ZF8R1`)X?+zgt)%iQ?!fYC7X*gcGpi{Ey1xvMs1mD+4tv`$_Z!?eifBYvjf>r
znRNv|Bqu*Yb6AvJXbr7(T<-la+bm-@->OS3NBk~oNV)EUZ$nyfb&k<s*F+eotU{ro
z-ZoGyE^F<!aGH<@oEB_AgU?RZ6!Y}zMLWK2(5ba2`r~fFd&GeJ94|!0oSp54sAkRk
z#A(q428QuxWU2lT=}G)>G#BF9ZY1d867nbYRH?>=&hK{Iv**uwP?Z14Ja1y+7J|>k
zRqne?RNdK@_XLmK>_b>S8ICLV{W-4)Z}@Az87m7ODW+j{`P*Yba%(70M?`PRXM0ZY
z)-BiWcwQAEe&>gIdDbp2jPqy5DzN3FQ(nmQ=DcEn+XBk(pPGt4I9N7b>;9$G(vy{)
z9U&KYX!)qd^AxK4{l9Y|MxO!#GNdDk%@Z$y<D#1l7gYW}8sd^O{~Ug>;r@5_#ZxF+
z2J@|LXd0UL6)z5Eo7tP1nx2}6asT<F6dfCjM|u|VcFS;OxRB7z&24?WGE~ots58lX
zvuSvk2RU?put5UiYj%1%^T2~aE$jDW?bxT!pHnP{yrSclP#`+@+x4rkw@9Sb#5kYb
zbOR0ugr7&-i9Ze^qoZ3t-V#QAfb+(9TU1Y2{Y6!4AdxUWKE50>g9#8nu>O+O_{Q)G
zQsQVW|I5|ulZy9aVOONU>}hBb&KzubE0fW%vAvIC5d)f)?WCzhxD>^bWO{b=v!bG+
zugIAHF(u`2nH5v2#9?Dgivq8Q5W|qBmXJ{5`be=awOrlOT7I_Oc8ajgWKFl?cy|oD
z@AvOF_BQzAGc(K2_J>{=i)1n5b|s8`yoFyA&Be68$1Ar)N<q<+t2Jc)C*}6y;{A9b
z&#Sm0+rz^I>9R4H#JlSNE^}-A3JV&e^9d*{MP{gBlkp`U9l3a2dJ-3#$n_pYaM$v5
z$%9CJz*~gtx~n<8c|m#o`t=;$TGiuoL=DTMbNlp{xi-A+2Ui0E0+v@+@b2!!V-d<b
z{GFCxpe=#DmYSchkgGXGzl+2*UaV7%^7r?vn@1$MDW*v(og7lU6HT550L7-5{NlR%
zl8!+oj{9_bqdX`E_E-q{1ZcG%fXiPeYyHh+Kg618QD;=RbALVF6*Qly3NLz;^TlJq
zp%2J1D5IadOFcwF9z1BrI}0ja6nE}Cd-H}7pIY`IA0M%bipu*B;rt@}j>|rx$@(A<
zWuu>>>*?t&9Jj!ln3)l&_d2Il&Aj8~<<%L_8@|vH6%JFf*qtDwsCdWoWbY9@{bzs*
z6x4$1kd&4-++Q82sIFG2aj~ZqVr315&52J+DmzwYRaj6ky*iNX;^qdjLu~H%7C-%c
zW^GB>FHlvmxVX4T1>FdIuHPn3BcXV^IsORn7cS(mH7QtTHRhL|PDRG&_+2?&8h%;q
zacm!SdJ_}Vurr!9IxY^GtHq6tjSWmo?l*Jbw|=LO#w~V(ImaKi>P{&V6TkE#Wvm-e
zC3bl9+jkKRb=_J_BOt!dU(_16M;uyio3)Rnrldr3S#dOf_G|{SPzm6aoXmpO*GX8~
zCEULt2y6CwSO?DA!*`BrgGrBHd^T6RsB=FI1|0vpXMQJF>urYOBNAY`(bhFORgNz!
z10|D$#H3_p=hsK@pFC+|D6jN9rLMFmLKZLSZ%)=We`B&NC}DgCx}tw@V?ZijR#_ry
zBY&d0+;+Lwnp*a+vNKPbI<ttq5Uc0O16UAXsc_|JSKb5(3g2WlFetFFWJ>pA12=C-
zmgj|k+goK=iNxDq<$Mih2543F7+t8r0l8Lo#-<%WPi|tmp~xq)&gYr!Ull*>;}}@a
z&Ksj25lb#GbwHAiq}t7O29oMOmS}wUiQGAXuj%#i2x3kPhne@nP)msOkwE)7Y$pA<
ztg38J4}^i5_&|wed%GzOmvDTUFPX19US#YJ&zBd<sq_)YKsm6+=%)s>1_sI4#2kKL
z$}s9}iUBweID4VLl6E&=K(1^QOND=vO%nPB*HWrEQh&BnOMG`n+X&%|0vJX;A(=OC
z!jb|bnY5H*l&Gkv08%~ZU*`OZW>rDY)G9}}nS5Sk(3n(WF(9&0bsM1CaJI?7B4lBv
z@N0V{nX>1_j`2+Z;Mv*PtQtJDi^KZ7XZAns|4uXWIjz2kV)jJORPXU67xdB}$ZDof
z)#A8y+w*6YQ(Yhtdyw0{c0|$=Y&7ssdh0K50>pOcdF#MN^-4BJe*1A?074D}0|Rsw
zEg}O=<JG-Is7F8ERGV~B&=R=GCT*sYmc`J7@Uoj;v=3yXt7b*ic!pCmnNLlU`6#Ea
z1K}r$Vopdl>8kSBl_RTqOW~6=br--;Ec@k#`B)i$r9*b`oulI=A`OlCRF7k6?V9DD
z<6Xo90T)J0-z)B?_8{)QFsOGk@HZ@WpQ{)@87Vdm;q^TE)E=}AatHKGe$k|?<`M<z
z8TPX|Vmu-#mDt&)!LkQXwC<3TXWjK9fVu_NnGRJj2ur^&U$Wa>1BnMhfKE<NPq(&(
z`?EVusNCm1ulN)HIK3d?(@lh^Z@YGdEwQg?vh#cjFk(sxd6VAn%qY1i9;BJ+;l0|A
zm#0(R*&fLs+2Y`AE$!$?FjkhE4ina&J@j>=nj59W0s{kw>xEs1FA@c{3d&g&9343b
zSx%5Y!dE3f!EQ4!`R0#M_@Gfe7*$ch1Gkp(4;!%Vcm5g}2zrMhK_~2BYn!H?&!t`E
z=*Q<2|1L+z(h5w%a6$L7%)nn3{h8O)LF_4x3wd7<0QIb>x<LCba9OgW=rdZnmQBW$
zvl5@1`=!8fMSNi^mcv}C+WGeOp|E%i+dU5Qo}WKMfzbf+UT6FERz7w<DBalWVdYod
zqNcdk)|(6cYk|Li@O6CaG6ptMI<+woSB0cul8L$q1_I`=n4=i%+>1o22>m>ZI85hS
zkgj#R&Fg5!eR;OaeUDys5uC0ku#Qc8UII446lZGglSKNHzN%#zSeUUKWTb>OFCcKA
ze(0Hlon7-p?L813>E4%kXasc1fqzmF-xX<TRWhysF`wy6XW!ctd~QVC|9p%MFO0zi
znGuu$IJURUDtTPVymQa$2{qL!#f7^`J-9yCEcZXif~O+?XQt8L$l6-o#f9e{eVX+i
z(Srw1-S*5P_nqSt64dy@*EcqRw=i;BkAK%JJ+vFn*Are?&as}TVtw6u2Oh3?0-w`O
z9Gu_X-N6}h;S3qp*4Ajlqoec)!IwE2O1y?^dn-urB*_3uc9s;nX;z2wQBQcR+(vx`
z?R2wx3usL8&eqqjchE3F30lW%Xlbz<{l*4PWM^mhh?e$KIE_MIve=EBoSaMz*7N-W
z4^PiONaS4klvm@g$Gleb1eo_3HP9Lcven5hbb1)X!otE<5uCT@KLi)Bp61Ed90)H-
z@#&;NvCOx7OOd%V^7WB$_B=WYrFGVzqU5v_3z;u$0B@k?;`&zQL_$jun=Z+q*UxpS
z7<HItHd2%zE#x-al<e3sMaIu%yESPQsid*cp`HS3j(E;$MwA7Uu<Ym9nELVb4(NA8
zQBY726T2z1xSn1TP{`foKc4dOJd*#r!mDrO!weLeg%XnS?J4RqShc4UoS%lM3hCRv
zy$q%BUhkapzM)udy^3RLWHiUI#z{1S`_)=U0$*-Fa<BaptXuZCn~p##<$<PGxN-W>
zD7*))bnDTh9+bNRD+zoeB+o4Fce%K{_Rvpi*<NBvLRKRM2EIiYjMW|g>U&zr5%5s7
zy30By7>%;|SbDlfVSa?2ZiehNS=r9Nd!#+hUoOCnSxM7PmaDCBTq$brPR2FQvYDuH
z4TAe;vyQ(3GIC*ct_63v-rK(@_pmT0t(Jgd3F-6Ob1-Y432a&(uuEapUk}@LmgzXt
z3>h5o+f+9^YX!}D^R{PlPCUZaHnX|TbIf&TUMZ`&0ln^`iXQ8Jrgz`BmrIh*8h8OX
z%>Iaaia76Epna`ru*UQi6)Cj{{^6#?39MNH-1Nl6x$Qj<;d@kcbhjioKUKT@Ndng-
zy=pne4*VKm_sMLgBR`YxqrH2_9T9nsi>L+@NCky$bfiyk*`4hznnp{#3!HOVT7oxP
zIxJ)CHK?DkWJUez?Y)VCAr|>u6W(htN8$q>7WhWe&l+AWkPr(eYFWYR**EN<v&-BR
zmkkZ&h}4ZYQ!abctV;F~)Av32QAMuB6u{DG-fqrg^9u+NJVXu&8XwtcYsZgnsqj56
z(J3f@EyZ8uwAS<fTCuY6gQcFN$3jB7yk`P0L`C1*N9TmAh;i8*%<U}fqTDxN)so<U
z0jA=5o?y@Y@<jr{M+w(R&(6g2y19|z;b`63>kL>dR(<U)cI2dIff6B`yTD7JZpb+$
zvgp>>sF*BhTF&jQP(Is{OvI%l*z&iw#4l%N&dbrOe}BAd+E-}A5}Ax7ik#$~swHX7
zQu}fXyCxZ1LRz!yQ{a38h2Iaw<aystF)_W&4KyUR{J`;yf3T+7OAg?-s3KHi_D6iA
z7ftm(?Zv;6_xZyIN)UrbrxYmI0&EC3>C!9&S_K}{-LkUgO6LvCM!)l{qOF|CsMVdn
zK#q4o%H(Pes2mG`zp_x*8QGzcj!g&NJqh<kAAMb4idD?bwxx@CsXM9Sa!OoiLRNKQ
zX@^_~FY4E|4`%`RR;-O|Y?3Sr&3#4R)z=Gam0MHM(n`i0`uY23zd4-Q%E<{!N<`FL
z`!g~U6GXyYWIH1Yw$%4^TImj7EW%GAAqZ220h)_8*R)j`ZhG~+oSnDrwO`p%^uj|3
zD_|0NxNWk$PmB0iSy``My*j<Rnq@CfXMS^f1&P4H^nJXK)F4x&CHTD^z&bEDH$}B#
zU%#4h2v&We=P4f!#iW>ItAqUl8#S=vPoHdaawgw$Wki-o(JFo3Szsu1-k^9uvh;gk
zK+cE^r=&-iV}L?fh|sEC&-*epg3%n&_b8O@E;AEoJu2E|^vz8S&cvvIfDsAvya@ZM
zG_Df5aJI*kP7CEWdhAxCW?+!2lE1M~VTO|C`C8TFAbg}sUbE$MaIkcFU~70wJiVI5
z^p<xZ4w;)RNIH5o`-cJo5x^6B(`6{2Y(3u?-7jq~RtD)Z12o`ZV=dszm&V@Sr(+!}
z>v_W7!RFg>Hmet>)9ZvlPGf#3P0(3ZO+tNuL}o2bH*~~})hy2@opfsS<ecLoBD5Iz
zqxquME32h!1_zD}B!H;tQU<9|%?+T`uq_>S<{!n!6R+&0bB;`+-@mti{h=Bq%fgDI
znc1gNoTvEsD$?IdI(iG0*{a`P!!o92TwHVw2o8Qsznc59<rbC<`MsyEJEWy8MP+4F
zFp#rjtkrqL7cXj+=&)xz&wPE;6GT?lNWOmk`hDkB=;IeetcH(+h)eZ5qtV|C7l@`0
z2?#=ci5dCm>&s@VPh-Etm25e5F+4n6WY~O#T-YmfCoV$%u~nKtfa}3}z^Eg7jDpH{
zA^E-(>+|@5?5INfg~wh;$ryre*pC_4sQ`i>v9jX*+x3#xn)$_^U^fd23hpd+Ar9P~
zG|M+T!7qsBTvNAS@|r5RiHqCZSL8E_7eaS07tA3;V>N*2VDR@iKi_8(xxAp{@jST+
zHHzlpbdLSWoWI*4`DefysGMDr8#HKW_Y+XP0L|TbIYlDrR+`5=-71?a-3h0eo+k)%
zVk7aqQZC5Zj4UiN$|z}kx$M?9h3<fQ7|h*WXn04qx6T{ARd16W{?yB*8$_4>c!h{+
zo^}Gn2ap}LN6=A5nsZXJ#l0nd@I?KjuL@_h=?CBOE}`N|MNc5aYE3OIDw&F-YYm?5
zr^<2m%?%A`5)w2hkb)Toqdgk#<PP5U=UVr2<vI_lg}oMB<Nbe%*WX_m!acVG(uh@l
z{P2>g15<td=!H||F}Cf=+Gp=SBq<l@KN`%}`}y&fZhJu^qFtRJAfpnK8Pk3D;h4D3
zD=jU;Yi?$v;uCR$gLyh%l9DKxw93-l4>#d4&dkgtGtLc2nYX4liIiJU6ciNbpP%fL
z3b=eF7jy$>aTM1_x7N)UbR`m@ps+vTpCI!r>xLqo3SSZ|?*yIStNvh@z~B(|Gxfh3
z8!x*k`iE%H-@JLl3>svkUGbS>Fq(|JQtG^w;r_n84*S!m^cc(QP7@SSg;G*dC?^Us
z#@<Q?iuS1drXMO2!xeVvzl&xYYjlzopE|8-1EJBVa>M~)&uTyaIx=`U#5~U1EKAty
zEP-pm25QCnI@`g{NA>(Les`pWRvLtNdd8n$yZ!f02j@_^#Ozi|YU*&UJA1BXsk+}S
zjwl&WeRBJ*ZpQUxB_knut9%sXGGlBhy0v~T?ldfxcCgP-{+7nD3;;~3Jeg^3hH#b<
zknOazCy*3^#kvz7g{=Cw#aX>CuDH0L7P)M{@j7>+MKRZ<BvaZo&rzTmV#$hk$jH)*
z-CmfiHLrSTOcfQ<VKzX*8)4_UyU4k-#1g%@?5<O?D|{gz=gDP#CdmKRdL9rhI%eU|
z@t#C$22KGkgTgh;Cp3My61RVzUZKiW4^0$w54(l$rF=Tk8S|wd=Y!0OAT}<pn!Ce%
zPf~m)B_*Y5M#)Eie=sqh<!O)Bem-n`iYTopj(J7?>sO!m$@d>AF^|2y7{D}A6_N=M
zRzY^wwx!rFtPYPwsaHFPmpN}uc4n&^oL!t^E~tnyWdHhMjV&i6bh)z-o^(VmSjF8X
zpVOH^XVv)i+wiaktUdW+licMY7T2IiT=%{3kc7%LYsepfXUuGQs~T(2Jp)z?eF(H_
zS+ah*bU6q_%O||><)M6V|F#KObXTXI#$KMj9@3n<SRHVf0ZzEQM$(%hM~Hp<ws~I~
z6~A-N(nxX3j|^c^`<9rhM}0AJ40J2}TwLOFqN}5Q2b$SN2B9J4HdAT5st-!OXaTat
zX-UL#S+#A|E0|uK#dz#T)=JkHQ^nH(Me!>wWeTV1QQ~48a9Xu+5YSmjpg>{utD@KP
zu__M_x9T(Z3uip*lDiRgEGlNwYx459QLF+oAK-gR-+k_N#g&_YdcJyXLV@!f&(T{i
z<0CiQPNe*%OshuhP?;<T2gmEaCpHknusN-oK?tjqt0|YT#1Okow|7^&j=a|F?|Oa_
z*Sg$?1pc>!GgCMPff1%8+}3H(-~f`~h7TbN+eMRJvSM$R8Ur!6bzn#cE*2qk+UvG3
z3xvTH$d>W&@ZLp6s`+h_JmXE@fpnW_6Rjh&#x<OTB40PXmfSO4I+FR?)vK>vFz4%$
z)W}t|FJL>xhDS&9AYP?Qr4wMDHxf;Fi)+^sH-KMC#BP#R^lp2;EfssKrN2KAQbpAC
zgR9&Pna<zcu~g>({9ezC(4wBbc0H^w9>lvIPRimT#wL4?;$|w;=`_U~`4I0#^E$9*
ztFstGw9ubFbrs&I870F@N9janWv(TjCi@|t)A9=B8H$Ktc2?Fu;BqvMS0YPeFEYEq
zG=aPyOln^6jgJ}IR{{rRP%aB>-VFJKjz|W=3mv5MV{&q=k_%6>Wh_uKv>F9pyI1eU
z<PsuUChJIXaDvaaTeP8wZ?CHHn0Awzc1D|<Ux*WKoOP}v;SG@G*@3mVvsC`;_wSc$
zF|SAaRu~?ru*Kv06D{`W`H1@FRNBszw3pGyll}s>sGQ!OIia2|Jpeb6FzS79u*&c<
zlAh}A=Z%SKxrN;bgqLy0%je08w$Mkh0O3*X+<2u*JIxYZz(!+xDI`Gv=k4dJKa??i
zMSlW0Pz%N<Bg;MWUTEh8&Ahn$=iH+4O51j1Uuv$@@lIrg+x}fv)~zYD(4va?vNa;A
zCr>g1`&>>BZucY#b}K)^BRa-}8KoDSr+lnyo*<RQf0?CLpDY=gvJPD?yb-+3=`yCS
zrw4KwNL5V(z{`PEDJ5B14v5eqn9nb)Z0TZL+qc-=CqROk_kM@C^|HCr0ijx_Ro)#1
ze&yWiYR0~6dO;bp=u};!YKE;EM12q!pssE_hKpo*B0PeLg|)E1c5@*@UR|A=T%aP`
z`6QJZb|Y}r0?<|$=lrU_2q`F%7E4M>Ue9Z0hucp8#gAI#8f^kSu)~ldCo2mL6clLS
zU8?%wv2j~X8-<4E)2g-WzIx<wxJd?6M!%H5v0c)}&n_0nqlR!=>o)&}JIcn&nhqm{
zo*LS&l0CXD8LRetJ{AL{z%myg;sU>oSW?$0MgOPhc%=gt4MJSgpOV4VWgu(H_WVTe
z>h&z4=f^xXD{Zo<{mH0V@&xL1hOQtX5ZG>z7eH%=%<Fb|S-H3tK`d*2Gi3$4Kg;pS
z3vp_N7p;=y$3nvF$qq~N^0U=%RfK&Nl+vZ|f%qCOmT+3#^B+=1+Q9gRi%oIgy?aML
z1v~HWL9TP^(SQ`u$ibrAj^s6P`vDbsoL2i0()f6Qec|xu(!h{qJA=7JvhaywJfd+W
zUU+Kf{}GqwLp=nDXW(hx{`pe@Ij*aI+|qI?n}1dcZ5H~|x8J`nv1u5ARQMS>0}lCk
zx^k3^v~;_p=M~9;$=(cEX_=Q}dXPP~{CZ5GQ+*%?VjDtmj8WK(QgK!C;;<PZwtyNz
z3~_V<wVWnEg%7|(-FX=+*e`GW5W-h#Tz6wt5W%!Ju6i&pl$1frM#ltZu6*Sd#PM`%
zv!kPs!=o*<tM$FAeO$b6XtlQ`90r~*9>LxnSf-sZ&@4k9%?D)G)Ho@K#5)8+j$jJm
z@4J8WzR%(5gQ`Y(0587On2jH~Pu6}(cikOyT<If(6b@R_eu5;0h@%CPl?47nDb6Or
z7bY3cAl8pJ>GIO=No1<=B765ijOj6@UZMM;iAlG1Ado#2TLpg-5=(t6tB%Q9ty{Rb
z#(T?jXc4pqhg<K%+pt#EfV9EJzJrh7*#9GS1-V4?nSf3jjKq;DC#L#~6Z}%kAsV2k
zfW!Jb^HX#>Rg9qjAP_=l$-i~=y6zJ6PN0l$xH+SXvjL#~N`;1M!Q>MyC;JRfA(#Ro
zXVC*bHaRJOSrYU=%&d;a60#&hlJ^nX0aSj3Id>?aoIw~Tz)2{Jo)=`Octk`Z*)Pf1
z2wEtzv@7}eo!?CN2onMmG?q^if_5gvr4IkBS``*C!s&uiT-I=X7#)(<aGQE7*<{hd
z@p|tY-j_y>TS7h{RbJD}{n*_f8UWYfhQpFPIFa=8ZAQV+CpBudyIA@iL^Wg{5_KNO
zsO9D5B?Bhh+|LjEXs@a^C#r5ggtQaNaKlI?-8D=NyNyxfi;GjXf$SmW>dZPWZ5{9F
z^^v*uYqdJs+Mp(}I=-FD+uH8DUq9TuW`DA$^o@BUEuLPb?9B_Xp3=16-V96X?9Wt+
z`}?;*6-mL__C`~QmSAs<JH9Pkg3ZzFt!9ZC^tWBPfxG#ux%nP<d9bFx2(t8IA?gt%
z_~0n3XL*Xz`-H1d0&@Qbuy8&4%M1&5=66swy>AVd9X}wftX!9^t*xpvZ90LA`9gAx
zQl-5U4(V_k7$>aUJrLe!qe5{o&cpuGSasq8p;b(>TzppQ7rL)s1ym=HyM%r?P6(;+
zEwImw)&@)I$2_u7MEzPAi5&F&jMp5O@3a+(CO3eu3W=kcht63`QJ6oJF@Na2+1~BJ
zfJ}+~{{3&@JuAR?@M$hGoF1@+FS4spA8ZM~N5|kR@;r3|Rg+c>sgrV{;R_sc0Vq4T
zkQPB-s6c<t53fBD5QlV1DOdTO*B|QDc|g4R4MO%atwh1zlW6D%YUuBe$WqI;pZRqS
zEhx1ZT*#5?w=8vab?w*owkE1uV%SYJDr}QSf5g)5?d?6_dIPa!kP%Ej4==BQv2imr
zG4ePpV(U~pr^7!@|8p^FYHBbQi=Eb9c6N1{59Sb&@jEwlbbNsZiQY^lN&?Jla4)U>
z7o3X0M<=QYx)k*4o0i~8|J~nDepO5X{Rv!agH-ioyRd-TujO)r08UlUALQZXOnDxl
z4A6lG9W#-oCPEq6XLDks5%pGM&P$Nl1(J@$QFtwXN;iJzND>Q%5Lh#FGpvb^#Hx_c
zjs@Gw4k8|~->fo*QdNggMNL@(oIwHC&XvJjVTd*>s;VGY(9O1|qcK+*YRe4l7hD^#
zM44id{sv5%B{Se3YYNlqmUpXH9t>|z#C`hgmhJKEgf{|7WX|A8XTA-%A)CM#3$jjT
zbDSC;T)sz#rzWaTAU_}X#b*MTyZT`$a#J2E{+Rc|_!*p(@>}23@(6BkZ(|en1r6r%
z8yTq(0JyIWg~GEEANhT%@pA0=)rjf&iJV4_3m1!?-)os0(ee^L;6AavZsh@$4Bd&k
z&;fQw(#!qlcM+qb(=9Xs!4`*=J|fU~&zHJ?AQX)UrhgiNA1eu!9xOb76)YT_(g=m?
zUT1dLFf@af;C%?&r#HriWMk*$BI!AO=C5D;oxyiGWPW+vGzD81vbIGSpMXd7+3RAP
zDFd*-BVdm`wVA{|*qo5w80~JaY^=0j_=R-9gQ_|GcSaDRE?dZmp>LBm>ES-;T_{(@
zCS7d6@4Jx*5sRKSNJNks$9D(`Th>RyhfB=wL1mPM#tWz4i8KnjbtmoQP=z3Jz6M=m
z&=EQd=ErNkytP3qRDw5L=|D+NKKJR%7o+a@d(igxo{WDGae7+PT@NJ_;Nm?o=c+CE
zv|MkFz}6=JQ+;@6fke<LGDBNi`}pFt3^i$bQ?BC`c4~76MlJF!!#vzzBN{{UytlH8
zPsV>R504z2B;%E;r4G}8@<V&*tgr`i#$~11oUJ~Cs*fO>RG3>6h{XH?)p7E<fvEou
zJm#=GzyRj}8XZ@(>pT+gGmU2E{7g}#g~*Fa&8Wn6my0;*L1uVli83O1w_a@Q_N$U*
z?!lZ_;!t}vYn4{SV)L8~4Ie8c2`xfjfcb?k0Gl~-Q7Jc;vfA0oaHMGJQs;8T6aBl~
z_%|l4P_6PjR&b~{$1B^uKAMa0HPv)AGeIS$s{@vWwlj>2JxNjnS)4?|li}bTKtA7$
zO~F!I!_Hn3fL!nYF2a5thqQTZ2#-<gfFHUO5n$e{l^v@dQl;tTr9noCvO(2$E@Abm
zGp}al=8Q*iag~8YMHvfVXBhuUnfmnUro#UHioMs=U8WhbjIa8FVbG{1pn?L$gawAA
za7dUz{$oK8RNLo!3`a{8T{5Joo@pZ^BLP9dks@O(NU~ErPY+1>(#~&2uo<`8LZ=nn
zdCx@kTOtm#I}06%iBC^qepmZ{a9E8-;M2%Y&&@SPGN{`+Imwk?kLH7}E2D$;5!HO%
z1UODnXpW?YR$<W)azV2RJ_lSZ<v>#2yCfteI27{aa?9)MvX>X<0fB){&?W|DjDE`G
z2L><O?3xjP6st)m2WmC}&~M)4X#r9E<5e;9SeZF@3fDsEA*#)>r3C^=F=~ax)IxR@
zAXEM&bl$+&Vz{ix;R1yg1BR&Q*%p?LoG34LKza||ku_|)YlDi%fe0z3Nfyfbt3&g4
z9GeuGPFcOS&cxAbb|0h0(=T8N<aVUTr^xBhu$M4VS`6j=Ygr)F@}K9v`tpae*xE`6
zSp6FHUc3x1J6rlWaKoux8S+n;6y;6Ra`)2HUWkcN!W_3%IdyD9RW)qRI@?3C5PKUL
z7_@c84QUkU-#6_^{0{VpUgajL1m(FELZAq8C+Af$HbmW>(cA38muHkZ)m|;opxu8#
zoxO3EvySXz6ZXX#(>GP8*2>VcTo;Vt-aBZ@Phg}`b!<P=YKH?O4u^XyM&lD&GfU<C
zjaU<ykDhBfce>x%UUcd!AE~@P4Et~ue8(hdZ<%Bx8OWf<xl@I+puOPUw1``RZar?@
zoW5?u^xwA_pG`eEUq5Ox{nrCVIvgMsUSsE&15LlrgJXE?c%Xlh-Mj8&-?aWJD2jF}
z8IW(NOy>Nw9L4b4@%)p%L`Oex+dD!B3h-l+JT}pi=GW2b^Wi2D2WbUq%eXh*SZQ}e
zJvJd-gIKM*@0jZ2oyS@_P{O3;{YBt_%q0Z~9aLEc>r>^2GAEe370w%=8(2a8d&=KX
zpnLS_-EESK`QgHIFs%MmY#)x;lP1W&BM|+>(gpJdd`Y58Ea~4N5Y%BBC;*VZ@y^V!
zysEUvLp3^qXKFVm0BO3&e_bw!L|r*elC`Eb%E&rV5aYY?)#y93mz*SVDYEfAT61nx
z|2ZeJ{5e5~=wPeojL&!$*|y%nD?}(RE?#1eq-sRo66OTMrtA&xw~dxiI2_Y-X$ie%
zL|$^GFj{8druMOpgO2z9U5M?P^8Y#%(js*u`rpBle=kQ0;r}^W^PhKYCsF@@r&Jtn
zXc+eGa^r3PNuvGFX_`wSRvUc#B{o^NugIDITxrG8hmJto>zL<c0)ZKb`dyRv&#_M~
z1a6<pJq2Z6%sXoQJEiiRk4*oif{b3EYr>s_y@Rndg?kVGov>liX}BP?QF_AExnle8
zPCmUR=5H9aR(;a+`^ouM|F<R9o=tJjtf&9Z$aoayk=~MXapPV!_ExC2<0ZTQ@8nEq
z=fm3Dex0S&^XyLw77CpdhF%eHe5O<6D32)&s5?g7jQ@9MQ4i^EJ=XmVM3z<@k0ks^
z!BAV-KOQIisHj<->VY0V(KqBz)Enz={=`M<)#)a0bbDME>P~unM~#A@S@A2k%%gwj
zdX8+Qq@|_Zf)g($eom(2EI8^nMRmC^V_0I$o-8`@z<@uoNQJ#m{ZK1I(eq!!`k&|U
gfAEu#*5wWIphreYYuGYyf(=dTh5Yk8QT_M-4>ODln*aa+

literal 0
HcmV?d00001

diff --git a/assets/eip-6059/img/eip-6059-unnest-child.png b/assets/eip-6059/img/eip-6059-unnest-child.png
new file mode 100644
index 0000000000000000000000000000000000000000..f675c9c28d59ab530960532d4564e8ca88479374
GIT binary patch
literal 8761
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
Dm(GWM

literal 0
HcmV?d00001


From e59b1dfc6ed42f36ba63f3e27f093535e3a3c5d9 Mon Sep 17 00:00:00 2001
From: Taehee Yoon <th.yoon.dev@gmail.com>
Date: Sat, 17 Dec 2022 00:54:29 +0900
Subject: [PATCH 046/274] Update EIP-5192: Fix typo (#6148)

---
 EIPS/eip-5192.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5192.md b/EIPS/eip-5192.md
index 3ed7d939cf2c90..30e5d147e25d5d 100755
--- a/EIPS/eip-5192.md
+++ b/EIPS/eip-5192.md
@@ -19,7 +19,7 @@ This standard is an extension of [EIP-721](./eip-721.md). It proposes a minimal
 
 The Ethereum community has expressed a need for non-transferrable, non-fungible, and socially-priced tokens similar to World of Warcraft’s soulbound items. But the lack of a token standard leads many developers to simply throw errors upon a user's invocation of transfer functionalities. Over the long term, this will lead to fragmentation and less composability.
 
-In this document, we outline a minimal addition to [EIP-721](./eip-721.md) that allows wallet implementers to check for a token contract's permanent (non-)transferrability using [EIP-165](./eip-165.md).
+In this document, we outline a minimal addition to [EIP-721](./eip-721.md) that allows wallet implementers to check for a token contract's permanent (non-)transferability using [EIP-165](./eip-165.md).
 
 ## Specification
 

From bb8e8a7a5387d9a4e1493c1e6df00b3a4018b3dc Mon Sep 17 00:00:00 2001
From: yaruno <jarno.marttila@sujuwa.fi>
Date: Fri, 16 Dec 2022 16:56:33 +0100
Subject: [PATCH 047/274] Requesting status change to last call, added last
 call deadline date (#6153)

---
 EIPS/eip-5023.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-5023.md b/EIPS/eip-5023.md
index 6925e4cf1d358b..50db6e7d30ef89 100644
--- a/EIPS/eip-5023.md
+++ b/EIPS/eip-5023.md
@@ -4,7 +4,8 @@ title: Shareable Non-Fungible Token
 description: An interface for creating value-holding tokens shareable by multiple owners
 author: Jarno Marttila (@yaruno), Martin Moravek (@mmartinmo)
 discussions-to: https://ethereum-magicians.org/t/new-nft-concept-shareable-nfts/8681
-status: Review
+status: Last Call
+last-call-deadline: 2022-12-31
 type: Standards Track
 category: ERC
 created: 2022-01-28

From ee728c424afb78f04685f74768bd742fbf0c160a Mon Sep 17 00:00:00 2001
From: Marius van der Wijden <m.vanderwijden@live.de>
Date: Fri, 16 Dec 2022 20:33:10 +0100
Subject: [PATCH 048/274] EIP-4938: Move to back to draft (#6014)

* EIP-4938: Move to Last Call

* EIP-4938: fix linting issues

* eip-4938: move to draft

* eip-4938: tag specific version
---
 EIPS/eip-4938.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/EIPS/eip-4938.md b/EIPS/eip-4938.md
index 6194b86ffee24b..3867d780a38955 100644
--- a/EIPS/eip-4938.md
+++ b/EIPS/eip-4938.md
@@ -1,10 +1,10 @@
 ---
 eip: 4938
-title: "eth/67: Removal of GetNodeData"
+title: "eth/67 - Removal of GetNodeData"
 description: "Remove GetNodeData and NodeData messages from the wire protocol"
 author: Marius van der Wijden (@MariusVanDerWijden), Felix Lange <fjl@ethereum.org>, Gary Rong <garyrong@ethereum.org>
 discussions-to: https://ethereum-magicians.org/t/eip-4938-removal-of-getnodedata/8893
-status: Stagnant
+status: Draft
 type: Standards Track
 category: Networking
 created: 2022-03-23
@@ -13,7 +13,7 @@ requires: 2464, 2481
 
 ## Abstract
 
-The [Ethereum Wire Protocol](https://github.com/ethereum/devp2p/tree/master/caps/eth.md) defines request and response messages for exchanging data between clients. The `GetNodeData` request retrieves a set of trie nodes or contract code from the state trie by hash. We propose to remove the `GetNodeData` and `NodeData` messages from the wire protocol.
+The [Ethereum Wire Protocol](https://github.com/ethereum/devp2p/blob/40ab248bf7e017e83cc9812a4e048446709623e8/caps/eth.md) defines request and response messages for exchanging data between clients. The `GetNodeData` request retrieves a set of trie nodes or contract code from the state trie by hash. We propose to remove the `GetNodeData` and `NodeData` messages from the wire protocol.
 
 ## Motivation
 
@@ -34,7 +34,7 @@ Remove the following message types from the `eth` protocol:
 
 ## Rationale
 
-A replacement for `GetNodeData` is available in the [snap protocol](https://github.com/ethereum/devp2p/tree/master/caps/snap.md). Specifically, clients can use the [GetByteCodes](https://github.com/ethereum/devp2p/blob/master/caps/snap.md#getbytecodes-0x04) and [GetTrieNodes](https://github.com/ethereum/devp2p/blob/master/caps/snap.md#gettrienodes-0x06) messages instead of `GetNodeData`. The snap protocol can be used to implement the "fast sync" algorithm, though it is recommended to use it for "snap sync".
+A replacement for `GetNodeData` is available in the [snap protocol](https://github.com/ethereum/devp2p/blob/40ab248bf7e017e83cc9812a4e048446709623e8/caps/snap.md). Specifically, clients can use the [GetByteCodes](https://github.com/ethereum/devp2p/blob/40ab248bf7e017e83cc9812a4e048446709623e8/caps/snap.md#getbytecodes-0x04) and [GetTrieNodes](https://github.com/ethereum/devp2p/blob/40ab248bf7e017e83cc9812a4e048446709623e8/caps/snap.md#gettrienodes-0x06) messages instead of `GetNodeData`. The snap protocol can be used to implement the "fast sync" algorithm, though it is recommended to use it for "snap sync".
 
 ## Backwards Compatibility
 
@@ -47,5 +47,6 @@ This EIP does not change consensus rules of the EVM and does not require a hard
 None
 
 ## Copyright
-Copyright and related rights waived via [CC0](https://creativecommons.org/publicdomain/zero/1.0/).
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
 

From cdb4b438ea6dfda2916a22dddbb36180341e23e8 Mon Sep 17 00:00:00 2001
From: coderfengyun <coderfengyun@gmail.com>
Date: Sat, 17 Dec 2022 03:50:25 +0800
Subject: [PATCH 049/274] Update EIP-5489: Move to final (#6062)

---
 EIPS/eip-5489.md | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/EIPS/eip-5489.md b/EIPS/eip-5489.md
index ff9a5e9fa3f895..aec096b66bc551 100644
--- a/EIPS/eip-5489.md
+++ b/EIPS/eip-5489.md
@@ -4,8 +4,7 @@ title: NFT Hyperlink Extension
 description: NFT Hyperlink Extension embeds hyperlinks onto NFTs, allowing users to click any hNFT and be transported to any url set by the owner.
 author: IronMan_CH (@coderfengyun)
 discussions-to: https://ethereum-magicians.org/t/eip-5489-nft-hyperlink-extension/10431
-status: Last Call
-last-call-deadline: 2022-11-29
+status: Final
 type: Standards Track
 category: ERC
 created: 2022-08-16
@@ -88,7 +87,7 @@ interface IERC5489 {
 
     /**
      * @dev Throws if `tokenId` is not a valid NFT. URIs are defined in RFC 3986.
-     * The URI MUST point to a JSON file that confirms to the "EIP5489 Metadata JSON schema".
+     * The URI MUST point to a JSON file that conforms to the "EIP5489 Metadata JSON schema".
      * 
      * returns the latest uri of an slot on a token, which is indicated by `tokenId`, `slotManagerAddr`
      */
@@ -121,16 +120,6 @@ The `supportInterface` method MUST return true when called with `0x8f65987b`.
 
 The `authorizeSlotTo`, `revokeAuthorization`, and `revokeAllAuthorizations` functions are authenticated if and only if the message sender is the owner of the token.
 
-## Rationale
-
-### Extends NFT with hyperlinks
-
-URIs are used to represent the value of slots to ensure enough flexibility to deal with different use cases.
-
-### Authorize slot to address
-
-We use addresses to represent the key of slots to ensure enough flexibility to deal with all use cases.
-
 ### Metadata JSON schema
 
 ```json
@@ -154,6 +143,16 @@ We use addresses to represent the key of slots to ensure enough flexibility to d
 }
 ```
 
+## Rationale
+
+### Extends NFT with hyperlinks
+
+URIs are used to represent the value of slots to ensure enough flexibility to deal with different use cases.
+
+### Authorize slot to address
+
+We use addresses to represent the key of slots to ensure enough flexibility to deal with all use cases.
+
 ## Backwards Compatibility
 
 As mentioned in the specifications section, this standard can be fully EIP-721 compatible by adding an extension function set.

From 1a99c770885da1bdc853f222c265f2d38acc8ff5 Mon Sep 17 00:00:00 2001
From: lightclient <14004106+lightclient@users.noreply.github.com>
Date: Fri, 16 Dec 2022 14:07:46 -0700
Subject: [PATCH 050/274] eip-5757: move to final (#6033)

---
 EIPS/eip-5757.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/EIPS/eip-5757.md b/EIPS/eip-5757.md
index b9a262997b2f26..373bd7ec801517 100644
--- a/EIPS/eip-5757.md
+++ b/EIPS/eip-5757.md
@@ -4,8 +4,7 @@ title: Process for Approving External Resources
 description: Requirements and process for allowing new origins of external resources
 author: Sam Wilson (@SamWilsn)
 discussions-to: https://ethereum-magicians.org/t/eip-5757-process-for-approving-external-resources/11215
-status: Last Call
-last-call-deadline: 2022-11-16
+status: Final
 type: Meta
 created: 2022-09-30
 requires: 1

From 146380b7a0d2d90918f8049598bc0e1bcf4a68ff Mon Sep 17 00:00:00 2001
From: Matt Solomon <matt@mattsolomon.dev>
Date: Fri, 16 Dec 2022 13:44:37 -0800
Subject: [PATCH 051/274] Add EIP-5744: Latent Fungible Tokens (#5744)

* Latent Fungible Tokens

* update number

* style: add solidity syntax highlighting

* style: syntax highlighting

* Apply suggestions from code review

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* update em dash character

* change token name/symbol from should to must

* cleanup and clarifications

* Apply suggestions from code review

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

Co-authored-by: Payom Dousti <payom@cozy.finance>
Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-5744.md | 93 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 93 insertions(+)
 create mode 100644 EIPS/eip-5744.md

diff --git a/EIPS/eip-5744.md b/EIPS/eip-5744.md
new file mode 100644
index 00000000000000..19431e24941df5
--- /dev/null
+++ b/EIPS/eip-5744.md
@@ -0,0 +1,93 @@
+---
+eip: 5744
+title: Latent Fungible Token
+description: An interface for tokens that become fungible after a period of time.
+author: Cozy Finance (@cozyfinance), Tony Sheng (@tonysheng), Matt Solomon (@mds1), David Laprade (@davidlaprade), Payom Dousti (@payomdousti), Chad Fleming (@chad-js), Franz Chen (@Dendrimer)
+discussions-to: https://ethereum-magicians.org/t/eip-5744-latent-fungible-token/11111
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-09-29
+requires: 20, 2612
+---
+
+## Abstract
+
+The following standard is an extension of [EIP-20](./eip-20.md) that enables tokens to become fungible after some initial non-fungible period.
+Once minted, tokens are non-fungible until they reach maturity.
+At maturity, they become fungible and can be transferred, traded, and used in any way that a standard EIP-20 token can be used.
+
+## Motivation
+
+Example use cases include:
+
+- Receipt tokens that do not become active until a certain date or condition is met. For example, this can be used to enforce minimum deposit durations in lending protocols.
+- Vesting tokens that cannot be transferred or used until the vesting period has elapsed.
+
+## Specification
+
+All latent fungible tokens MUST implement EIP-20 to represent the token.
+The `balanceOf` and `totalSupply` return quantities for all tokens, not just the matured, fungible tokens.
+A new method called `balanceOfMatured` MUST be added to the ABI.
+This method returns the balance of matured tokens for a given address:
+
+```solidity
+function balanceOfMatured(address user) external view returns (uint256);
+```
+
+An additional method called `getMints` MUST be added, which returns an array of all mint metadata for a given address:
+
+```solidity
+struct MintMetadata {
+  // Amount of tokens minted.
+  uint256 amount;
+  // Timestamp of the mint, in seconds.
+  uint256 time;
+  // Delay in seconds until these tokens mature and become fungible. When the
+  // delay is not known (e.g. if it's dependent on other factors aside from
+  // simply elapsed time), this value must be `type(uint256).max`.
+  uint256 delay;
+}
+
+function getMints(address user) external view returns (MintMetadata[] memory);
+```
+
+Note that the implementation does not require that each of the above metadata parameters are stored as a `uint256`, just that they are returned as `uint256`.
+
+An additional method called `mints` MAY be added.
+This method returns the metadata for a mint based on its ID:
+
+```solidity
+function mints(address user, uint256 id) external view returns (MintMetadata memory);
+```
+
+The ID is not prescriptive—it may be an index in an array, or may be generated by other means.
+
+The `transfer` and `transferFrom` methods MAY be modified to revert when transferring tokens that have not matured.
+Similarly, any methods that burn tokens MAY be modified to revert when burning tokens that have not matured.
+
+All latent fungible tokens MUST implement EIP-20’s optional metadata extensions.
+The `name` and `symbol` functions MUST reflect the underlying token’s `name` and `symbol` in some way.
+
+## Rationale
+
+The `mints` method is optional because the ID is optional. In some use cases such as vesting where a user may have a maximum of one mint, an ID is not required.
+
+Similarly, vesting use cases may want to enforce non-transferrable tokens until maturity, whereas lending receipt tokens with a minimum deposit duration may want to support transfers at all times.
+
+It is possible that the number of mints held by a user is so large that it is impractical to return all of them in a single `eth_call`.
+This is unlikely so it was not included in the spec.
+If this is likely for a given use case, the implementer may choose to implement an alternative method that returns a subset of the mints, such as `getMints(address user, uint256 startId, uint256 endId)`.
+However, if IDs are not sequential, a different signature may be required, and therefore this was not included in the specification.
+
+## Backwards Compatibility
+
+This proposal is fully backward compatible with the EIP-20 standard and has no known compatibility issues with other standards.
+
+## Security Considerations
+
+Iterating over large arrays of mints is not recommended, as this is very expensive and may cause the protocol, or just a user's interactions with it, to be stuck if this exceeds the block gas limit and reverts. There are some ways to mitigate this, with specifics dependent on the implementation.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 3be2d38989992d3f91424b025fd9fd23ceef8172 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 17 Dec 2022 16:15:50 -0800
Subject: [PATCH 052/274] (bot 1272989785) moving EIPS/eip-4760.md to stagnant
 (#5962)

PR 5962 with changes to EIPS/eip-4760.md was created on
	(2022-Nov-15th@15.22.32)
which is before the cutoff date of
	(2022-Dec-4th@00.15.49)
i.e. 2 weeks ago
---
 EIPS/eip-4760.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4760.md b/EIPS/eip-4760.md
index 3abf2e381c6bfe..aafcbfd365d511 100644
--- a/EIPS/eip-4760.md
+++ b/EIPS/eip-4760.md
@@ -4,7 +4,7 @@ title: SELFDESTRUCT bomb
 description: Deactivate SELFDESTRUCT by changing it to SENDALL and stage this via a stage of exponential gas cost increases.
 author: Guillaume Ballet (@gballet), Vitalik Buterin (@vbuterin), Dankrad Feist (@dankrad)
 discussions-to: https://ethereum-magicians.org/t/eip-4760-selfdestruct-bomb/8713
-status: Draft
+status: Stagnant
 type: Standards Track
 category: Core
 created: 2022-02-03

From 4cf313025c4e822d0c5df24318b62a555e7ecbe5 Mon Sep 17 00:00:00 2001
From: Taehee Yoon <th.yoon.dev@gmail.com>
Date: Mon, 19 Dec 2022 10:48:49 +0900
Subject: [PATCH 053/274] Update EIP-6093: Fix typos (#6149)

---
 EIPS/eip-6093.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-6093.md b/EIPS/eip-6093.md
index 2f85e9aeb7858f..e47b3373fdb074 100644
--- a/EIPS/eip-6093.md
+++ b/EIPS/eip-6093.md
@@ -19,7 +19,7 @@ Ethereum applications and wallets have historically relied on revert reason stri
 
 ## Motivation
 
-Since the introduction of Solidity custom errors in v0.8.4, these have provided a way to show failures in a more expresive and gas efficient manner with dynamic arguments, while reducing deployment costs.
+Since the introduction of Solidity custom errors in v0.8.4, these have provided a way to show failures in a more expressive and gas efficient manner with dynamic arguments, while reducing deployment costs.
 
 However, [EIP-20](./eip-20.md), [EIP-721](./eip-721.md), [EIP-1155](./eip-1155.md) were already finalized when custom errors were released, so no errors are included in their specification.
 
@@ -295,8 +295,8 @@ Given the above, we can summarize the construction of error names with a grammar
 Where:
 
 - _Domain_: `ERC20`, `ERC721` or `ERC1155`. Although other token standards may be suggested if not considered in this EIP.
-- _ErrorPrefix_: `Invalid`, `Insufficient`, or another if it's more appropiated.
-- _Subject_: `Sender`, `Receiver`, `Balance`, `Approver`, `Operator`, `Approval` or another if it's more appropiated, and must make adjustments based on domain's naming convention.
+- _ErrorPrefix_: `Invalid`, `Insufficient`, or another if it's more appropriated.
+- _Subject_: `Sender`, `Receiver`, `Balance`, `Approver`, `Operator`, `Approval` or another if it's more appropriated, and must make adjustments based on domain's naming convention.
 - _Arguments_: Follow the [_who_, _what_ and _why_ order](#arguments).
 
 ## Backwards Compatibility

From 1377f1a1ba0ee0e29d965c01ed3d2575cb862536 Mon Sep 17 00:00:00 2001
From: Marius van der Wijden <m.vanderwijden@live.de>
Date: Mon, 19 Dec 2022 09:58:32 +0100
Subject: [PATCH 054/274] Update EIP-2481: Move to final (#6015)

* EIP-2481: Move to final

* eip-2481: make linter happy

* Walidator fixes

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* eip-2481: fix a few validator errors

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
Co-authored-by: Sam Wilson <sam@binarycake.ca>
---
 EIPS/eip-2481.md | 43 +++++++++++++++++++++----------------------
 1 file changed, 21 insertions(+), 22 deletions(-)

diff --git a/EIPS/eip-2481.md b/EIPS/eip-2481.md
index 48c87b5031d3c3..c8bc379b8d6dfc 100644
--- a/EIPS/eip-2481.md
+++ b/EIPS/eip-2481.md
@@ -1,25 +1,21 @@
 ---
 eip: 2481
-title: "eth/66: request identifier"
+title: eth/66 request identifier
+description: Introduces a request id for all requests of the eth protocol
 author: Christoph Burgdorf (@cburgdorf)
-discussions-to: https://github.com/ethereum/EIPs/issues/2482
-status: Last Call
-last-call-deadline: 2021-08-11
+discussions-to: https://ethereum-magicians.org/t/eip-2481-eth-66-request-identifiers/12132
+status: Final
 type: Standards Track
 category: Networking
 created: 2020-01-17
 requires: 2464
 ---
 
-## Simple Summary
-
-This document proposes a way to increase the efficiency of the `eth` networking protocol while at the same time reducing complexity in Ethereum node implementations. It does so by introducing a request id to all requests which their corresponding responses must include.
-
 ## Abstract
 
-The `eth` protocol defines various request and response commands that are used to exchange data between Ethereum nodes. For example, to ask a peer node for a specific set of headers, a node sends it the [`GetBlockHeaders`](https://github.com/ethereum/devp2p/blob/master/caps/eth.md#getblockheaders-0x03) command.
+The `eth` protocol defines various request and response commands that are used to exchange data between Ethereum nodes. For example, to ask a peer node for a specific set of headers, a node sends it the [`GetBlockHeaders`](https://github.com/ethereum/devp2p/blob/40ab248bf7e017e83cc9812a4e048446709623e8/caps/eth.md#getblockheaders-0x03) command.
 
-*Citing from the [`GetBlockHeaders` spec definition](https://github.com/ethereum/devp2p/blob/master/caps/eth.md#getblockheaders-0x03):*
+*Citing from the [`GetBlockHeaders` spec definition](https://github.com/ethereum/devp2p/blob/40ab248bf7e017e83cc9812a4e048446709623e8/caps/eth.md#getblockheaders-0x03):*
 
 >`[block: {P, B_32}, maxHeaders: P, skip: P, reverse: P in {0, 1}]`
 
@@ -28,9 +24,9 @@ headers, of rising number when `reverse` is `0`, falling when `1`, `skip` blocks
 beginning at block `block` (denoted by either number or hash) in the canonical chain, and
 with at most `maxHeaders` items.
 
-The node that receives the `GetBlockHeaders` command should answer it with the [`BlockHeaders`](https://github.com/ethereum/devp2p/blob/master/caps/eth.md#blockheaders-0x04) response command accordingly.
+The node that receives the `GetBlockHeaders` command should answer it with the [`BlockHeaders`](https://github.com/ethereum/devp2p/blob/40ab248bf7e017e83cc9812a4e048446709623e8/caps/eth.md#blockheaders-0x04) response command accordingly.
 
-*Citing from the [`BlockHeaders` spec definition](https://github.com/ethereum/devp2p/blob/master/caps/eth.md#blockheaders-0x04):* 
+*Citing from the [`BlockHeaders` spec definition](https://github.com/ethereum/devp2p/blob/40ab248bf7e017e83cc9812a4e048446709623e8/caps/eth.md#blockheaders-0x04):* 
 
 >`[blockHeader_0, blockHeader_1, ...]`
 
@@ -140,16 +136,7 @@ This EIP extends the `eth` protocol in a backwards incompatible way and requires
 
 This EIP does not change the consensus engine, thus does *not* require a hard fork.
 
-## Implementation
-
-Trinity has a [draft PR](https://github.com/ethereum/trinity/pull/1672) with an implementation.
-Geth [PR](https://github.com/ethereum/go-ethereum/pull/22241).
-
-## Security Considerations
-
-None
-
-## Test cases
+## Test Cases
 
 These testcases cover RLP-encoding of all the redefined messages types, where the `rlp` portion is the rlp-encoding of the message defined in the `data` portion. 
 
@@ -170,6 +157,7 @@ These testcases cover RLP-encoding of all the redefined messages types, where th
   }
 }
 ```
+
 ```json
 {
   "type": "GetBlockHeadersPacket66",
@@ -186,6 +174,7 @@ These testcases cover RLP-encoding of all the redefined messages types, where th
   }
 }
 ```
+
 ```json
 {
   "type": "BlockHeadersPacket66",
@@ -215,6 +204,7 @@ These testcases cover RLP-encoding of all the redefined messages types, where th
   }
 }
 ```
+
 ```json
 {
   "type": "GetBlockBodiesPacket66",
@@ -228,6 +218,7 @@ These testcases cover RLP-encoding of all the redefined messages types, where th
   }
 }
 ```
+
 ```json
 {
   "type": "BlockBodiesPacket66",
@@ -287,6 +278,7 @@ These testcases cover RLP-encoding of all the redefined messages types, where th
   }
 }
 ```
+
 ```json
 {
   "type": "GetNodeDataPacket66",
@@ -300,6 +292,7 @@ These testcases cover RLP-encoding of all the redefined messages types, where th
   }
 }
 ```
+
 ```json
 {
   "type": "NodeDataPacket66",
@@ -313,6 +306,7 @@ These testcases cover RLP-encoding of all the redefined messages types, where th
   }
 }
 ```
+
 ```json
 {
   "type": "GetReceiptsPacket66",
@@ -326,6 +320,7 @@ These testcases cover RLP-encoding of all the redefined messages types, where th
   }
 }
 ```
+
 ```json
 {
   "type": "ReceiptsPacket66",
@@ -380,6 +375,7 @@ These testcases cover RLP-encoding of all the redefined messages types, where th
   }
 }
 ```
+
 ```json
 {
   "type": "PooledTransactionsPacket66",
@@ -416,6 +412,9 @@ These testcases cover RLP-encoding of all the redefined messages types, where th
 }
 ```
 
+## Security Considerations
+
+None
 
 ## Copyright
 Copyright and related rights waived via [CC0](../LICENSE.md).

From e40865d17e1913d14cf5676beb028c9904c82e07 Mon Sep 17 00:00:00 2001
From: Ahmad Bitar <33181301+smartprogrammer93@users.noreply.github.com>
Date: Mon, 19 Dec 2022 13:35:42 +0300
Subject: [PATCH 055/274] Remove rerminating instructions validation (#6168)

---
 EIPS/eip-4750.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/EIPS/eip-4750.md b/EIPS/eip-4750.md
index 2da4893dbd9947..9cca0550a75133 100644
--- a/EIPS/eip-4750.md
+++ b/EIPS/eip-4750.md
@@ -125,10 +125,9 @@ If the code is valid EOF1, the following execution rules apply:
 In addition to container format validation rules above, we extend code section validation rules (as defined in [EIP-3670](./eip-3670.md)).
 
 1. Code validation rules of EIP-3670 are applied to every code section.
-2. List of allowed *terminating instructions* in EIP-3670 is extended to include `RETF` and `JUMPF`. (*Note that `CALLF` and `JUMPF`, like other instructions with immediates, cannot be truncated.*)
-3. Code section is invalid in case an immediate argument of any `CALLF` or `JUMPF` is greater than or equal to the total number of code sections.
-4. Code section is invalid in case an immediate argument of any `JUMPF` is such that `type[callee_section_index].outputs != type[caller_section_index].outputs`, i.e. it is allowed to only jump to functions with the same output type.
-5. `RJUMP`, `RJUMPI` and `RJUMPV` immediate argument value (jump destination relative offset) validation:
+2. Code section is invalid in case an immediate argument of any `CALLF` or `JUMPF` is greater than or equal to the total number of code sections.
+3. Code section is invalid in case an immediate argument of any `JUMPF` is such that `type[callee_section_index].outputs != type[caller_section_index].outputs`, i.e. it is allowed to only jump to functions with the same output type.
+4. `RJUMP`, `RJUMPI` and `RJUMPV` immediate argument value (jump destination relative offset) validation:
     1. Code section is invalid in case offset points to a position outside of section bounds.
     2. Code section is invalid in case offset points to one of two bytes directly following `CALLF` or `JUMPF` instruction.
 

From 684f4225c3ef3c7376cc27e41e40249eacf8d5c2 Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Tue, 20 Dec 2022 00:46:52 +0100
Subject: [PATCH 056/274] Add a note about inter-contract compatibility of
 EIP-6059 (#6173)

The note about EIP-6059 being able to support inter-operation between
multiple NFT collections was added.
---
 EIPS/eip-6059.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6059.md b/EIPS/eip-6059.md
index 4a6692e713cc0c..2a1430bf4165ae 100644
--- a/EIPS/eip-6059.md
+++ b/EIPS/eip-6059.md
@@ -405,7 +405,7 @@ The proposal enforces that a parent token can't be nested into one of its child
 
 7. **How does this proposal differ from the other proposals trying to address a similar problem?**
 
-This interface allows for tokens to both be sent to and receive other tokens. The propose-accept and parent governed patterns allow for a more secure use. The backward compatibility is only added for EIP-721, allowing for a simpler interface.
+This interface allows for tokens to both be sent to and receive other tokens. The propose-accept and parent governed patterns allow for a more secure use. The backward compatibility is only added for EIP-721, allowing for a simpler interface. The proposal also allows for different collections to inter-operate, meaning that nesting is not locked to a single smart contract, but can be executed between completely separate NFT collections.
 
 ### Propose-Commit pattern for child token management
 

From 7c8e7e6eb5f80a091998479eb57dbfea8386e8f3 Mon Sep 17 00:00:00 2001
From: William Entriken <github.com@phor.net>
Date: Tue, 20 Dec 2022 13:17:44 -0500
Subject: [PATCH 057/274] Finalize (#6174)

---
 EIPS/eip-6049.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/EIPS/eip-6049.md b/EIPS/eip-6049.md
index dfcfa0a549c8c8..f0159cb299c91d 100644
--- a/EIPS/eip-6049.md
+++ b/EIPS/eip-6049.md
@@ -4,8 +4,7 @@ title: Deprecate SELFDESTRUCT
 description: Deprecate SELFDESTRUCT by discouraging its use and warning about a potential future behavior change.
 author: William Entriken (@fulldecent)
 discussions-to: https://ethereum-magicians.org/t/deprecate-selfdestruct/11907
-status: Last Call
-last-call-deadline: 2022-12-20
+status: Final
 type: Meta
 created: 2022-11-27
 ---

From 694fbebc12a67c7dc5ac2d8ac1be6106808c29b0 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 20 Dec 2022 13:33:49 -0500
Subject: [PATCH 058/274] Update EIP-5615: Change totalSupply behavior when
 exists is false (#6176)

---
 EIPS/eip-5615.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-5615.md b/EIPS/eip-5615.md
index 988c8fbbd6e75f..ec4900adc4f4c5 100644
--- a/EIPS/eip-5615.md
+++ b/EIPS/eip-5615.md
@@ -26,8 +26,7 @@ interface ERC1155Supply is ERC1155 {
   // @return      Whether the given token id exists, previously existed, or may exist
   function exists(uint256 id) external view returns (bool);
 
-  // @notice      If the given id exists, previously existed, or may exist, this function MUST return the number of tokens with a given id. Otherwise, this function MUST revert.
-  // @dev         This MUST revert if exists(id) returns false
+  // @notice      This function MUST return the number of tokens with a given id. If the token id does not exist, it MUST return 0.
   // @param   id  The token id of which fetch the total supply
   // @return      The total supply of the given token id
   function totalSupply(uint256 id) external view returns (uint256);
@@ -40,6 +39,10 @@ This EIP does not implement [EIP-165](./eip-165.md), as this interface is simple
 
 The `totalSupply` and `exists` functions were modeled after [EIP-721](./eip-721.md) and [EIP-20](./eip-20.md).
 
+`totalSupply` does not revert if the token ID does not exist, since contracts that care about that case should use `exists` instead (which might return false even if `totalSupply` is zero).
+
+`exists` is included to differentiate between the two ways that `totalSupply` could equal zero (either no tokens with the given ID have been minted yet, or no tokens with the given ID will ever be minted).
+
 ## Backwards Compatibility
 
 This EIP is designed to be backward compatible with the OpenZeppelin `ERC1155Supply`.

From 607e39bb3ccaa7b0fc4bc7b45add21fe49fa2a18 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 20 Dec 2022 14:54:31 -0500
Subject: [PATCH 059/274] Update EIP-1: Use updated list of EL clients (#6161)

---
 EIPS/eip-1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-1.md b/EIPS/eip-1.md
index f5a96deb32280e..e9812ec609df91 100644
--- a/EIPS/eip-1.md
+++ b/EIPS/eip-1.md
@@ -100,7 +100,7 @@ Each EIP should have the following parts:
 - Preamble - RFC 822 style headers containing metadata about the EIP, including the EIP number, a short descriptive title (limited to a maximum of 44 characters), a description (limited to a maximum of 140 characters), and the author details. Irrespective of the category, the title and description should not include EIP number. See [below](./eip-1.md#eip-header-preamble) for details.
 - Abstract - Abstract is a multi-sentence (short paragraph) technical summary. This should be a very terse and human-readable version of the specification section. Someone should be able to read only the abstract to get the gist of what this specification does.
 - Motivation *(optional)* - A motivation section is critical for EIPs that want to change the Ethereum protocol. It should clearly explain why the existing protocol specification is inadequate to address the problem that the EIP solves. This section may be omitted if the motivation is evident.
-- Specification - The technical specification should describe the syntax and semantics of any new feature. The specification should be detailed enough to allow competing, interoperable implementations for any of the current Ethereum platforms (cpp-ethereum, go-ethereum, parity, ethereumJ, ethereumjs-lib, [and others](https://ethereum.org/en/developers/docs/nodes-and-clients).
+- Specification - The technical specification should describe the syntax and semantics of any new feature. The specification should be detailed enough to allow competing, interoperable implementations for any of the current Ethereum platforms (besu, erigon, ethereumjs, go-ethereum, nethermind, or others).
 - Rationale - The rationale fleshes out the specification by describing what motivated the design and why particular design decisions were made. It should describe alternate designs that were considered and related work, e.g. how the feature is supported in other languages. The rationale should discuss important objections or concerns raised during discussion around the EIP.
 - Backwards Compatibility *(optional)* - All EIPs that introduce backwards incompatibilities must include a section describing these incompatibilities and their consequences. The EIP must explain how the author proposes to deal with these incompatibilities. This section may be omitted if the proposal does not introduce any backwards incompatibilities, but this section must be included if backward incompatibilities exist.
 - Test Cases *(optional)* - Test cases for an implementation are mandatory for EIPs that are affecting consensus changes. Tests should either be inlined in the EIP as data (such as input/expected output pairs, or included in `../assets/eip-###/<filename>`. This section may be omitted for non-Core proposals.

From 5b3d18cf9a0037b6481fe79559dd097b6955b17c Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 20 Dec 2022 14:59:19 -0500
Subject: [PATCH 060/274] CI: Add Link Checker (#5361)

* Replace HTMLProofer with a faster alternative

* Add markdown link checker config

* What a weird bug

* Try this fix?

* Try recursively `chown`ing the directory?

* Please let this work :|

* Escape the star

* Please work...

* Update ci.yml

* Move to config directory

* Oops
---
 .github/workflows/ci.yml | 27 ++++++++++++++++++++-------
 config/mlc_config.json   | 13 +++++++++++++
 2 files changed, 33 insertions(+), 7 deletions(-)
 create mode 100644 config/mlc_config.json

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index b7535193a45372..0cd5b8c17fa566 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -39,31 +39,44 @@ jobs:
   htmlproofer:
     name: HTMLProofer
     runs-on: ubuntu-20.04
-    
+
     steps:
       - name: Checkout EIP Repository
         uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b
 
-      - name: Install OpenSSL
-        run: sudo apt-get update && sudo apt-get install -y libcurl4-openssl-dev
-
       - name: Install Ruby
         uses: ruby/setup-ruby@08245253a76fa4d1e459b7809579c62bd9eb718a
         with:
           ruby-version: 2.6.0
           bundler-cache: true
-        
+
       - name: Build Website
         run: |
           bundle exec jekyll doctor
           bundle exec jekyll build
-      
+
       - name: HTML Proofer
         run: bundle exec htmlproofer ./_site --check-html --check-opengraph --report-missing-names --log-level=:debug --assume-extension --empty-alt-ignore --timeframe=6w --disable-external
-      
+
       - name: DNS Validator
         run: bundle exec github-pages health-check
 
+  link-check:
+    name: Link Check
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout EIP Repository
+        uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b
+        
+      - name: Link Checker
+        uses: gaurav-nelson/github-action-markdown-link-check@0a51127e9955b855a9bbfa1ff5577f1d1338c9a5
+        with:
+          config-file: config/mlc_config.json
+          use-quiet-mode: no
+          use-verbose-mode: yes
+          check-modified-files-only: yes
+
   codespell:
     name: CodeSpell
     runs-on: ubuntu-latest
diff --git a/config/mlc_config.json b/config/mlc_config.json
new file mode 100644
index 00000000000000..c3872447078e07
--- /dev/null
+++ b/config/mlc_config.json
@@ -0,0 +1,13 @@
+{
+  "ignorePatterns": [],
+  "replacementPatterns": [
+    {
+      "pattern": "^/",
+      "replacement": "/github/workspace/"
+    }
+  ],
+  "aliveStatusCodes": [
+    200,
+    429
+  ]
+}

From d4a445968e8ff51f3b685b3f807511b5ef680fa0 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 20 Dec 2022 14:59:56 -0500
Subject: [PATCH 061/274] Update EIP-5289: Add EIP-5568 signals, other
 extensibility, and security considerations (#6179)

* Update EIP-5289: Add EIP-5568 signals, other extensibility, and security considerations

* Add example popup

* Remove old parameter

* Update solidity interface

* Update reference implementation with changes

* Use correct EIP #
---
 EIPS/eip-5289.md                              | 100 ++++++------------
 assets/eip-5289/ERC5289Library.sol            |  14 ++-
 assets/eip-5289/example-popup.png             | Bin 0 -> 41841 bytes
 .../eip-5289/interfaces/IERC5289Library.sol   |   8 +-
 4 files changed, 44 insertions(+), 78 deletions(-)
 create mode 100644 assets/eip-5289/example-popup.png

diff --git a/EIPS/eip-5289.md b/EIPS/eip-5289.md
index 616989d686c5a9..cb08bd694275b5 100644
--- a/EIPS/eip-5289.md
+++ b/EIPS/eip-5289.md
@@ -8,7 +8,7 @@ status: Draft
 type: Standards Track
 category: ERC
 created: 2022-07-16
-requires: 165
+requires: 165, 5568
 ---
 
 ## Abstract
@@ -25,85 +25,53 @@ The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL
 
 ### Legal Contract Library Interface
 
-See [`IERC5289Library`](../assets/eip-5289/interfaces/IERC5289Library.sol).
-
-### Requesting a Signature
-
-To request that certain documents be signed, revert with the following reason:
-
 ```solidity
-string.concat("5289:", libraryAddress1, "-", documentId1OfAddress1, "-", documentId2OfAddress1 ",", libraryAddress2, "-", documentId1OfAddress2, ...)
+/// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "./IERC165.sol";
+
+interface IERC5289Library is IERC165 {
+    /// @notice Emitted when signDocument is called
+    event DocumentSigned(address indexed signer, uint16 indexed documentId);
+    
+    /// @notice An immutable link to the legal document (RECOMMENDED to be hosted on IPFS). This MUST use a common file format, such as PDF, HTML, TeX, or Markdown.
+    function legalDocument(uint16 documentId) external view returns (string memory);
+    
+    /// @notice Returns whether or not the given user signed the document.
+    function documentSigned(address user, uint16 documentId) external view returns (bool signed);
+
+    /// @notice Returns when the the given user signed the document.
+    /// @dev If the user has not signed the document, the timestamp may be anything.
+    function documentSignedAt(address user, uint16 documentId) external view returns (uint64 timestamp);
+
+    /// @notice Sign a document
+    /// @dev This MUST be validated by the smart contract. This MUST emit DocumentSigned or throw.
+    function signDocument(address signer, uint16 documentId) external;
+}
 ```
 
-NOTE: If an address begins with one or more zeros, they may be omitted. Addresses are represented in base 64.
-NOTE 2: The document IDs are represented in base 64.
+### Requesting a Signature
 
-Example:
+To request that certain documents be signed, revert with an [EIP-5568](./eip-5568.md) signal. The format of the `instruction_data` is an ABI-encoded `(address, uint16)` pair, where the address is the address of the library, and the `uint16` is the `documentId` of the document:
 
 ```solidity
-"5289:1-1-2,hElLO/0-7b+A"
-```
-
-#### Base 64
-
-From RFC 4648:
-
-```text
-                  Table 1: The Base 64 Alphabet
-
- Value Encoding  Value Encoding  Value Encoding  Value Encoding
-     0 A            17 R            34 i            51 z
-     1 B            18 S            35 j            52 0
-     2 C            19 T            36 k            53 1
-     3 D            20 U            37 l            54 2
-     4 E            21 V            38 m            55 3
-     5 F            22 W            39 n            56 4
-     6 G            23 X            40 o            57 5
-     7 H            24 Y            41 p            58 6
-     8 I            25 Z            42 q            59 7
-     9 J            26 a            43 r            60 8
-    10 K            27 b            44 s            61 9
-    11 L            28 c            45 t            62 +
-    12 M            29 d            46 u            63 /
-    13 N            30 e            47 v
-    14 O            31 f            48 w         (pad) =
-    15 P            32 g            49 x
-    16 Q            33 h            50 y
+throw WalletSignal24(0, 5289, abi.encode(0xcbd99eb81b2d8ca256bb6a5b0ef7db86489778a7, 12345));
 ```
 
-NOTE: Padding is NOT used.
-
-Here is a TypeScript snippet to convert `Number` objects into base 64 strings and back.
-
-```typescript
-const digits = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz+/";
-
-function toB64(x: Number): string {
-    return x
-      .toString(2)
-      .split(/(?=(?:.{6})+(?!.))/g)
-      .map(bin => parseInt(bin, 2))
-      .map(digit => digits[digit])
-      .join("");
-}
+### Signing a Document
 
-function fromB64(x: string): Number {
-    return Number.parseInt(
-      x.split("").reduce((bin, digit) => bin + new Number(digits.indexOf(digit)).toString(2).padStart(6, '0'), ""),
-      2
-    );
-}
-```
+When a signature is requested, wallets MUST call `legalDocument`, display the resulting document to the user, and prompt them to either sign the document or cancel:
 
-### Signing a Document
+![image](../assets/eip-5289/example-popup.png)
 
-When a signature is requested, wallets MUST call `legalDocument` and fetch the file off of IPFS, and render that file to the user. If the user agrees, the wallet MUST call `signDocument`. Using a form of account abstraction is RECOMMENDED.
+If the user agrees, the wallet MUST call `signDocument`.
 
 ## Rationale
 
 - `uint64` was chosen for the timestamp return type as 64-bit time registers are standard.
 - `uint16` was chosen for the document ID as 65536 documents are likely sufficient for any use case, and the contract can always be re-deployed.
-- `signDocument` used to take a signature, but due to account abstraction being imminent, this was deemed unnecessary.
+- `signDocument` doesn't take an ECDSA signature for future compatibility with account abstraction. In addition, future extensions can supply this functionality.
 - IPFS is mandatory because the authenticity of the signed document can be proven.
 
 ## Backwards Compatibility
@@ -114,11 +82,11 @@ No backwards compatibility issues found.
 
 ### Legal Contract Library
 
-See [`ERC5289Library`](../assets/eip-5289/ERC5289Library.sol).
+See [`IERC5289Library`](../assets/eip-5289/interfaces/IERC5289Library.sol), [`ERC5289Library`](../assets/eip-5289/ERC5289Library.sol).
 
 ## Security Considerations
 
-No security considerations found.
+Users can claim that their private key was stolen and used to fraudulently "sign" contracts. As such, **documents must only be permissive in nature, not restrictive.** For example, a document granting a license to use the image attached to an NFT would be acceptable, as there is no reason for the signer to plausibly deny signing the document.
 
 ## Copyright
 
diff --git a/assets/eip-5289/ERC5289Library.sol b/assets/eip-5289/ERC5289Library.sol
index d6b7867fe1281d..04bb6c72d8ffbb 100644
--- a/assets/eip-5289/ERC5289Library.sol
+++ b/assets/eip-5289/ERC5289Library.sol
@@ -6,19 +6,18 @@ import "./interfaces/IERC5289Library.sol";
 
 contract ERC5289Library is IERC165, IERC5289Library {
     uint16 private counter = 0;
-    mapping(uint16 => bytes) private multihashes;
+    mapping(uint16 => string) private uris;
     mapping(uint16 => mapping(address => uint64)) signedAt;
-    mapping(uint16 => mapping(address => bytes)) signatures;
 
     constructor() { }
 
-    function registerDocument(bytes memory multihash) public returns (uint16) {
-        multihashes[counter] = multihash;
+    function registerDocument(string memory uri) public returns (uint16) {
+        uris[counter] = uri;
         return counter++;
     }
 
-    function legalDocument(uint16 documentId) public view returns (bytes memory) {
-        return multihashes[documentId];
+    function legalDocument(uint16 documentId) public view returns (string uri) {
+        return uris[documentId];
     }
 
     function documentSigned(address user, uint16 documentId) public view returns (bool isSigned) {
@@ -29,11 +28,10 @@ contract ERC5289Library is IERC165, IERC5289Library {
         return signedAt[documentId][user];
     }
 
-    function signDocument(address signer, uint16 documentId, bytes memory signature) public {
+    function signDocument(address signer, uint16 documentId) public {
         require(signer == msg.sender, "invalid user");
 
         signedAt[documentId][msg.sender] = uint64(block.timestamp);
-        signatures[documentId][msg.sender] = signature;
 
         emit DocumentSigned(msg.sender, documentId);
     }
diff --git a/assets/eip-5289/example-popup.png b/assets/eip-5289/example-popup.png
new file mode 100644
index 0000000000000000000000000000000000000000..957bb6ba315232b1094103b43345729967c94709
GIT binary patch
literal 41841
zcmZU)2RNJG8$MpO+FEVZDiNinHH$VzNT@1m)-FXW6eZN&v=mi)6}3mrq6lhJBevMY
z-jOD?M<U^`pYQKKuIv9?*Lx)=*Lk1!oRjmObME_oo^Ty46^3iKuU)!yi9t>EsqUpq
z6vY=8_zKO%FE&8|%oiUNuDU8uE|m{)ZCw<oY!o#WFI}pPp(DMaz9?UPulmyU(j~@@
ze-{PPsmSWmrF37lr;7Ss=J@%*pYEP!Kq5dP{^l)ARPC*CcJzxaV0dkiIo%7z*(Xl-
z4&Mdq-SPMkVfid%OQQ>%Y{liU5q+gr2W-{Urc|SbSH%G=;r2x#wXm^k#qh^)P0~m9
z5YAhXc2Ab-Pir#CkbunX>dA%E^y*{pBbm+9OhV?N*&;A&aS>>bubHg30;OeS6h{AN
z86B&v$p7<I$s%9&pLwwQ$6+xSHvRHIxg_txU^XLc#s90{HJSCdaV=i`Z6Gd&TsZ?g
zUk&v0=wdM%5N##x&8%`yO?CgPxcXT;kT_PY?YF{Q9TRYnSG{;nUd$p7pA(>Lk7wHr
zS&Iwh@pje8O>6h6r<yh%S3{3C&*pLw|DLv*zbu(W7{Fzbs{=u&r-A3&!+#t8l+Sc9
zL7R$Z=s~rr^_D(=U9-Tx{iX{NT;P9g)&e@Vl8<JN1J93#0}hP>-Cwv!J6Odv5V55;
z&|PMzxbIPQR`dO>f8CNEJlV=R+nVw8LwXJboYn>UzHoWSg+=D{i#9qOP1d!zALTIl
z7m4Wr{+aJdw-c#*Mg_7LH&bds#wy8&y<ZY47CQ+NOCgsA9#*`yI8e4g{LeM!*Y$1x
zZC{%yi$F4t>1>IK_1>RVg^2OTQ?Dc&PyaUBXnXx;X1#ae_9K|C_1L#nDl(xEa#$QO
z8XY|rb$+&Zeu^t?C6<O2UOo=?w+QC&I^Tt!AzKvO-87bbFK)20IIXb&3maZ|*xa!>
z8^}ua-w6hCnJc52j%rlvyEd<tv~G@%Tv(-r+$zU#O7l5+8@P~R#%5mu;*Q_p)Nc*K
z{$l^N8V!CsW#&2mK4c}OH1VI)Ss^;d7Q#l3MpF=I@eIERNmRqmM+bYh>}M#Y!pc7&
z41lt_Co-~AUp0!8Eods<=8F)mOhS8-j_?LAlghp)yZBp59$;>PW1*mnF@EmXo9x$%
zLk8fGp;KQcLl*N53+h@9%WS~1qBIM;(Vq0;C*v1g$4&VSPSLAu0!d4>VMI>HUvH$R
zv{Fe)M&>f({-jmlqJ2e$i?{z$L7F4lK1+7%n|(P4@p}bd)5SQ?+E-{a9(WJ?E=VHU
zk@dAZ@{9ZOzW%y}Vl&;bN9ggR<Hf*po%8tQCaW0plPRCgVkh^KO}A~#FXNN1PK2+`
z#;@X@(G9B`S@<6YIjA5<_?YeamxXWf+v_;SPnMhU2vhN|3iF`(%kM-a24rXK3-h|i
zDM>bc7mgQ+5>z^g6Nwm2TO@7d3{)y7i4ot9{4Nyzos+C=0#-f8q$`UYE(5*)b@$>A
z*3R(n)61-4tI)Gs$3v2>%*XMVU+nMI1?#F@O8d%0d+;TMPx5KnZA##}lZ}M!*w-y>
z1Le&}=;f~8b2OYva3=2S@yTnZwplI*ck0-Lc)>4S|KQEGeWr9ghUJgxkzWuhS>_Kd
z^nVmpOEoPs_{xnd8*b+*_^SWJUdDT?AiF+gMF%X=2E29#MI}WfYI7a3xr0SnB`Tk=
z0__3}#C-|<7A-}DJnB;A0I9we>)b`E?h}KTrbQ9B7JIcbVMhR<kVR_2YjtOL*V?#V
zmC#<7w`$32bgP_QSfbwL$}7dsdU(fQ%b{-+_p&doy;FwT=^5Sd+UUDy^o%u|H4e~n
z+SuwFdnZB<E1b_^6Bomnvwdv<zySZPWX9TOO#;h$02T=ui}gL4umec;0penPm>cYf
zj*j?D(z-h+u+qHvxtm+RXIn3R(E%MMx<S{$Ez+~C79G2oj$jZZkLNMV#E;kD-(VF#
zlL{t|Vl?cMVW*slRTxQ&xg+dY-S;|;i-j&CL_1(F!3KEz3yJT7r*T8iUB~32R=$h*
zZ&5c+Mn~s`su*rEW8Xhs#x4uB?g@o0+MSJB5Y;=Jq|XYYqz`A32%YkX<N9(aLEwB1
z^(++>4JGD5WqpZbSrAl$f~k>IebsKo+w`f@a<S7YF;4XAcAql91hXOl^oc$4il@M<
zaC=*wEP@@62ib;mfVN8fMjy=&QB3~$iSP3MZQdBWEFbvC4AhlCW0ijm{wM(14X>88
z85-C~`=Q)R*vW2~cz5f38A=K}JI|Jty*3xR&zVg9IzYMVKK|mxqd%KmB$`$Oi8(-%
z^o*F^#e7^h@$$rfO9Gq})w(OiT2CkLeeW<|K;G^MrNksMbg_Q6;UP>SzoI6clHA=K
zXdHvJ{RQn@;)tZ-bJEPk^5-P{uhNCp23tprui;zB0mZfd*6KXiSjww>$Z0jyH}220
z@~?G$Xd+siaho;clP9_9xNET#V&yxo%C(VE9vuyTz3qMQ?cc2K(!&ALeoqN6#PyyE
zitL?z8PD~vyNB2#*A)jeGHyQ}5m_vrePo&3q=c}GH7hxg!bdc*-RrIRt^Y%#YyJ(Y
zCD{GeXAv!lCZ(zF3AOHjJHzG_sEoAo6zTZeSA2nG&vDQ>)H51;i~~g-H*Lx*^_@OR
zqnY^*H&<Kx!?7Q356f~#-||z2wJ0zkqX%=&R|lZKi_P=r3X19mT-5IYcMo!l_BC$u
zWHE&_MCm)#g_u8_Yz>h`_{q6L>;Cp&lt+spR;3NLg~Cm`3%sD7Fs(b*91pSBbMq3!
znvey1-c@wI8IgME&pG7Xso{8SwEOE*VO?^p5csKwONi6j=N~om<M`i#70RGTmnBq0
z-Gsi*{LJ0kiJP1L=!ZREi#cs(FoqlA`#mtv7IunV^aHymWy)btct_gYmZUZ1q1!m^
zy!hSPng|?A&JFJ;VT@i=khP+{rx5?1>%K^kt*oK&z7xitxxOY!<D?6?@=habEObQu
z$JqPE?Ryb{Z<eZV?}c-$#|GNP20A}Hl=;?Hf9ppBK7M%pZcdtC!~>JK=A(!?E7wMa
zc<q-bCssNUJ^D_I(#do2uAIDNCB189m9x;YAByNnszXWDO36$@q>eJW1SwDzH4_4O
zBKBZ2PO54nC6T?T=up>otqHC2C2DW00HFrS@-8VN-;=|{K@75behL2ViG#%5Xg-lz
z*YUrR7Fu|;yDWJ6y#<?@xQ{5lLe76TmW{n`G6Fz5^KW%TmzBLX%a|Owk+rtEh;lkb
zZovGsWQq8et0%(rq<_=(XGHJcdyU-d*%=bxZ-h%3gTe1r_m?<4LTG2UmXZM*e%b8K
z9j$57!nhq=-v%Wt`_Bm<bdN7MeZO6NPJ$OKkFbvui?FfDgh9Fz09mF{w#yVSgkgJ`
zki<tmP6gW>O~a-guGP5NPqubqA#dp#cEsg3n8(*_j9)|E(C;lVR4OU2QTxrBIy<~1
z-+oyw6vMF9qYWb(aPN8LL$fduG@lDQcW#vc4il!;Wf~6N0(WzTVVBlMl1Ck{m60W$
zb@DcJNBiuFDRqCIokdTHEmAgEbuo#Azv{LpMbVs&vM_jz*$fo+FO8XQG1(ddB%LA&
zY~3UwnpLPooRM%P)7=7XNv%WPB!%m*u0Eu=-$oUgSVeE>-F|gz8#EAb15KlkK~V1S
zytk*I$M$f{)A!BY%*jh^c>ONEPl{^{(i)<CG>!YIz{d=?4KorFvdVjNIXf*x;U&?K
zM65U`zJD46&o5p)$aP{(=|KSVoleR97{$pG%E|Q`;7v~+NJLAiZD$2h^*ZO<QAQD$
z=i%Y$9Vz}oxvoM+LcUSwti)KBl|m1`WYc<%<cUHouhWEQfU=~ps9sCf6QVXCcxT}J
z;i`p8O-oLl3t0&^&n~SgJrR-E*0a=am2MVy^=TV|QdI|jGp&Gay0SJ~%>QoiJma@B
zkt)4McGfG;XV`O<_!Bi@sZp3Wiu}O9b?(-ATsdD$(V4WMaJ3z)NJ5kHJ&D@_FK>;$
zWtj{QfADg0tFbHvOwT(OKx!=WUb?$94xJbH&<3Yu&QLS$!-tPwoDU{CDi_fG<v#&G
zXVlh@hS;lIpYXXI`JTR^cLZ2150=FXKXrTGsOodE%S$9iF+}5Bs&#CVuf>6@;^(vV
zfu@QMI)|pTm@p&T&W&ZWoFSI@!H`+O)GMQPyt03k-fsN_L3`G2%6Dp#DuJC@GsYu)
zAg%dZztjAy?3pr7#5m)pM-5(-N8Z%y2Z{7wKjYx+_xmZ#8Wh=&-A0}M79;(Z4+z(L
zUw7v`OGvf(5i9sqF+-AZWigtr@|e;<bD!c-D=&ml1mztTXvo2Z?wR-bjRN~#bMGk4
z`0+|_BTb-fzx|f}9;$<p-YCYy=%LNvKxro6qw$b}@fCk&XsA#aS`0ptp*^=rjx{An
zYvuIm2BIpU`FSi2BUdZN1-cmHYJvtQawHew<~pqM-vw1ZRLIIrOE#_aA5aIB_^8<d
z38sxt(9w4wDk{Q?vn_`iDbLfeOo;B-TE#!Z7==Jvf^s3IXK2Xu)G(to;{)D>yW#q&
z_KaASs*bhxwF*?x=N~uGBL+cOJ>)m06+S;bu`Fj(yMiI-=Y@uwlM6C2{vDEM@KdG!
zydj40^@K=kCM}IKXmS1Ok^k_KbWmpN4qfX*u8R}A5z~3K4L5to-&Zq>XS0F6BQ79P
zEAL`*)okB6nV@ox0piJ7z;h{#XTYZCQMn*48<k4CrL$=m9^irMLnsb=mL8<iuHqJa
zw*fWsnOGB({WjpqEJI;dUIuT&NrEZxJn(*%{bnFfZ;avv=$Xj^td%rQiM=E_3B<J8
z2TRG%4_(6d_AstxGXqM0u$)QhTlp`2q@}4(%!yl!UF&@w#%k5h3~lI52ouXehtNAH
zhE@<uDsBf*9t3{HrH{m!G}b;c`ANG#v{gE)_5TBQ8<~n(Aig{GJR4f%*b_1FaeFF2
z&M1Z1r+i83%#b)ZptW8}!BI4<gruYY3<JF?(;!RlG=x8S*thoFBphy1o)3R%COr4k
z2kI}0Kol&Tb+(p6%xmu5K8T||46hu|3#O5t%4)JbJ8V6hO2&?3=g^$<s2^ut%;+=J
zo@$^qF8HrnH!MaT<h#nb_)EI+dS2<&+=qzA<*SHxM@NWpsB{Wbx$@R-m|4@jefczx
zPiE*mR#d@ZSFv374dewAguPMsuQb5e<KANei(4t_&Gw)N7j$~PzTpyhiq!3X^EL8M
z&b3zPQvo7+a7bWSaWNVn)J&eTY+0gI31`~7?}6M37Sb|`gkd7|k=_sAcuAm?XdLC!
z6R8EWvu2YW>plRdwr1Fh@;XwO<{1A-H(%6KxiI9A<)4UuIHY(cm<b~7d$Js6bAdf=
zSik?net<#-Ze8!age*BZuKiB}a&KNVaG9FrlOhQJ5YpcWz5iTr3+wy?y8>)kUoH+u
zIp!PWgF>jh9B7WM=s(PSEhfn~@(j0Ave@oiq>TLs3qwQx!_|3tU3oDOSrWY)JJ-9o
zy()`;{#1~+7#p=N%Cb1?SO1lJ+f5gVlgf^+(ucs5i!<H@GN(UVSUmNOnA<@8zrdXB
z!TD<qG&Sk;0x{cI?6O#hpRQY+tt<Eb{SaknCU`#SM4m*2a;J6wYXPH$IY#>Bbs@`V
zI8uKgK`iVf*&?)~^LK+BV?-pS-%iJIkq*3pKJ9iXY1iH2*gc{;BF25AMDyQpX_Lpb
z8SL10B5mYgN9mh#Hb*j9`!W&n^AwzA4f>$_h?#EQ!|xWv@4;||O98uVfxCt$8Wa_I
z8}({9<lDs~_#!Aj?~-?C<g^+o@W>|cDA$AQG3!x;yEhjr2kpsHnAlExE!^~fj}O~L
zf_@IYs!`*@TDW_~c}^s7)_)<|2jVLjkk=Zsz}ro(V$+agSE%QEQmUlQ+pLpLfwy(@
z9<#VnbuqwY6jbfBjTZ9o6}6fBgn?3hK+bl`N3TC+b&T#7d-p6P5Ofeiul5k+s4|8@
z>paPVkd(vJQnwgzN{yc&&kd93ysJViE<fW298^`ilxIP_ax^#m;#+x%V-tnM!`9ty
z&f(Hh(!?rZZWH1etJsP$@qT(Vz4H&0>M%ZlsgtMsb2S}fBDyENDCV)b<)nc*sK~JU
zVFjsFjJmnyg9U#Es~$OrDD0!WfZd#~#_RQuX!(AYgORpm-b(t9R3I|;%Z$hQD=EF6
zntLCiAac7UEky@+B%XPwRE3MI#suDTdjj?-uGJ8}+uglF-EDbrcDkLlmSYBhaf}rg
zf_?Qh2p<O{gQtN`@E)p4Jp0$JH91g})<f&D9?GQhmOb|$1?A|5u4y>|!@F)h{N|Fh
z)^j6|E0vDW(A_RjTvQfn)Nx|^(}_u%M|nwGsmKM-({I#*YOD#I*lnX^N^d@1@J%kL
z7Y`f%+In_a0X!*61N-!}p3ZM`>sqC7p5a95<|GiQv?DXgt)z7&({<Z{sLCnPM{707
zfy;CjUfjbd4-E_QXv_DAEQzM=3#O-e4>hJ8Z&YrE77#1Wb0Vra`OeOU?qTx$Z7Zr6
zWd63C{%sC8(C{Va#WW<|vn%CdKzv7UMuY!OuZFkmA9U$i96IC;x=)!&jfYrRJ%=E2
z1F?s$k$!z03Bw)Lnp+hXc;F(6N!#5jW-w7%#l42fOcyy!>=oiGlnad7^@O~wJ~3)U
z8Ac}u#LIod_V7Yk^Og%+LAsbRse{Atm{DZqccc9^%|I1|t0<I3Ec^vI&lkX#MC*g@
z6)?XE?bBmBQ?t!)It-R0+VKIutwq6+x|Z6UP3uY8gda7<E?2joOS#uT>&HX1aa&DC
znt|?XmSc!;z!<;x1Jc^zgtjkX+JtjGM=UE}bX7#68?p>+w9Nt;gnsMp1N!Z>cYP6$
zvOX_a&6SsagM4V@1@b&tX!SK@9RNH|ob{gJ7+{b}1A9$38?Pr(doZ~wF?qvL>0m1-
zqZ<1Cb`Sz7<_7racXnfbPOalFjAcWM%j#KwG$kHmxE_KjF)ukVnxVlJ^l%V%epCg6
zZ1txpmb=P{U5*qj_1Jr@`>(mvm4J_CQd=<8{Ref-k$%|SA_;rCXg~Q-^jCVTN<HeM
z<^7(pz#5K#K0Zzp;Mq=Cn5=9l|13sjitrjpEH(=DTw^+)&Z$WSe0O<t_W-3cd=yWT
z{p>Kow%0cvM}e{O)POqY1oVAXw6!k`JQP5A3Y%k|gm#JnW?Lw@(Y9jzIY&@QU@Od)
z+?Lr_aNW1O3chwrj05Tb+K@bQfcKq?+|<Ldw^D`AZWGJ5Z+jKHnr{khZb2UpmtE%Q
z$#T|N*XN$u63eRGl9Py!is`+5b`W-QyDYC$*)*S>pSk+=rDu$~Z(S(6UDSI5N7g^d
z78l|bV_R%#xbEtZjLe}tr^_w?{ZteE`OCqNNTsV6115pejbZIHfB2S-Qj=hBzW+_J
zjyz||uN2TZQLz^!PDWZilr9yUQg*m*y47!#ElOvIh2?z_jG-_k<5UX|`0}2L9YwXo
z$&iq4kJ@UO7??MW8{Hp*9%K)P1qAlqy&NarWT<(6WIc7*Z{xiK{B4y|X;d=k+02{1
z<Zw;AJy#()(QFh1%2&4q(C}L#OftItXv#E^2X6MvmPm0KJ=UyzrccN!Z$}nkQBwS(
zoc${Vk5UbI{!WzvfuJ~xSd7s~Yx~#zU_}ldN<Nwr)zsd*;9ChJ`meXyoVB?6D1uZz
z42T)fBJC3ZJXh|zO!3T$^~5;ZQyL>d913w3IvpttLYOyCa!fsjM`d60kxmp%x=NLU
z8vlX_Riiokw?;+x&<2|-F77j_-TbBeh{<6GP2`TaVuBtnhlS7~Ktfs#Q8Am2FlRh?
zy5U}aM&abLaPboR(mj59gfd;9?et#}aAwiyqVpYRH+%e`_WHToMBwx82T(3nw<^V)
z1irKI5b>-U5MWHt;xnKWIQuKSWs7pT@?B=X%u8OTosXS{o{Rp+uM4e>GDLXQt@`6|
zUVF>|yT>n9R9PQf^TqP_$_VI8YCW^Ok~}RUt<5uI#(qW2cc!1l23Z_NtrCA#GrDi7
zANK1cUek<AEt;)qiQ2c_^E&G4t0b>awU&TctF~ual(d5e9?lU$;P=5SQL@I_*woh{
z8rPTW7hg{-J}rczZGVEvyizj~S8erZEs6VA8*>r@aCv1e;<-&)3wpNX$N+~yBo^^;
zhfOl6H30p@AvAQp(nB}nA!3RK{@Tf-XWE$7Dn~3J2_!Qf2M73Mjz0(QD%E}|_IhJ_
zhKvbFU7J$2e1$`{h^)|hd;uCp$*kt04YTB=ucz3WJswm0G19vtw_ZJ2K#aLVmkCNL
zY<cY1`ECE5m~*0cG%j`1#Q!iDp~!hKWzG>89)&QYjT46nNeFJ*JAbqR8v&>p4=ZH-
zmO<xcuGb=y)MpeFbWCF3#^1aWeOaMRvf)-XEEXelT`@4cdNyF$l=2Q7CGEN~uym!7
z^%0d4=E+G8%Z!5QNA}FNxIR>D%&U>=NdsG@K);cay#mK1IO4_Ek5sS*qga)aT8C5V
zsb~IPint()pV4Oq8{%g=_&ZKFD}^HQ!5F!Tz|=vLnOqw@C2?fTxsOKVeDZA^tzZ;N
zYd~g-X&TzFtCCbhjmB#78z7%U&uq6cUUouH4PSoXe#~k}C`D_%?62t7|DM(|q=~a_
zyjhg8N9n!REC0Rm$g+n;t?^AUq!W4+rKLkKXh0)X$}9@}F6%k#iBIx_$~>N?4JJ`S
z6XMLq?b43=-U;iQRKl$82F?NxUa0W<l>miKMp)j32;3z*6<bfE&l5~+;?M@uTUK$m
zB|VT`A%Jo-$hn&Xclf!-6B)r@@!}k51CkUb*#-RD!N2oU!$7jNF>qmBHoR1E1Or_{
z|0#|~)`O0eAkZrdis?M>dXmXgEmZemI?}=C<7Kzg%kE9i?<)Q$-GCwj?)^vgIhVZ0
zvOTEdoXhf*yE2L2Mh+2g8LA+i+utC2Ui@}49TjAc=w4I&DH;P`w%mulbMTMbJNSHQ
zSnqx#jSGRo8#f>3t^g$?5Ay2zEq3@SRg94|4Fa+G9hbzaaI|id70PSo&$Kf@FmlYz
zlZw?wcL%PFBYR}R=XZ3KV3yU{PvI%_qg86D7Bv)=4-Zv+Lw?C%3Y^WjXMcBX1ddC`
zE58$N!&?>vnR{b3uzCqJw_yn_d&OqD-x&h*57`|TOs^q0@<v9FU=_YU50Nhq%U%WC
zoh*k``Jj5Q;|)Qe1+iwb-{7x_M$10KzCx>a?y(gC9F!(-&b=|%wSEVQXBAxq?jN2z
z{a|W9BgCot4?b2Bt!1g!iW>C2E<0tgTZCBqMCFKTz#_&|v@)*`Yz7FTYrFmYAKLUi
zgGp5MQ=-hI_zTcA;#G|224^ofw#_;h!btDXowRQkn@>()@%#18#}J46g93zow5;}g
zR0Pw#zG2!Plve6Kp>4)qim5hdh*nexzbUsV(}BFB#L1xY$b=*5o`u~oTSX2)c1x_+
z2pwI+P@kusWSYrPVt(`Ggbcr!9kciPL=EW0hTP#+T7$SxoIvrBnptVWUFciA@cAcs
z=-4JVLoHVS#NHT!@S}Ki%2gn|kSJ2^TvmEeB9>86s$`#+XqT2ROh!20GToBQ@(T5^
zl(E+JYt;Z+;}U!bJ6WT5?2-Zj_ARw4PJ-RvF~ZRAQ&qQ!@qT^w1Jcj9-IEIQ8U&pV
zDkN+-<=`b^>4l>E1MD$9dGdsDgIR&B>F4iY;`^EoFJV?3=cw2UzdZGu=UWLr_|jHb
z0(KuAXfRqRGP}hzFcejJobu<@%(7fv*hVOa2c?JVp+{8m5boB-GoVM$-ab$B>-FO(
z;jB-ooZj1`QzPncF)KDUBMZ^G5YLqr2QFLNFb~J8*-@=72kXO+fZh3FF0zG#>^)Y=
z!C$4e3(-*@9VYnQp3?4U2C%%E*`*zzw3Cj$BX+myaZA|(>3g*1)^L^szqVAsWVh)K
z#cgc<2_pk2PurK1ACAfeqIKQAtCSu~a3+LkV2bIQza)x`ePqZB&Tw>lUHz3Cr3no9
zA{Ty$iHt7wfh@1S+A9CT;k?`!X`A=4l@INOQaqoQVBg<P!F`m48+LioH6aha1xb&p
zn5sdH^oXNTA{)%dv00Z1)9R*=(1Z`#`91v6GdDH2UBX3b`GWVw&HHv@cRojP9l}f>
zA$ba#enrrpMo{iikyJb&@BG=8hL63L?H!-enOJ0|#+V%tqF=3L<TeUP@6ifS-41is
ziqr#a|7ndJbmrny6=u}|WN0tm{lLKuCnL05Wj`Yf$`>WB7~>I4Jw?K9)QGEvyn7Fj
zd=}k~iVHm{2+>?hj+o1pg%q-^0|Z%jx5r!7v2i0je6EM$1Wg(YKer%RR`t%NC4YkH
zcPSdTQvcm+2lvEgERlY$B3H<m?B=RYW*;mUpT)!-=64Y%V&36Vl<q4X+rkr!{Rb3}
z1mU1{HoS&@cRzbK$rSlA0@EtkZMr00Fm=lknnrn5x0?ym#X1onGRhxL&q5sSSczQ}
zu8BDBvSamuna{FT`U4WWDejLIP8uxnh2tIcOZ<7IZkOQ{`z?GoQAam650>pAn}0A3
zrP6!KUp}(WX$gbR4U9mr9)&N=R1#?S4{-EJQYK(#{Ar?xo+5QkdB!c1dBzC$wbb9o
z{)@*9!N^POoVGcsunc{4gLq_@QsYUmnjKVptow<O(wU}8Uky;nz7Y`-jl#ZuQeC<r
zwj=Q(o-?C_kJx{}5!}`Lw9{kF*`czpRRmq}T`YkQ{&njyHIw~^UelmNMO&pB^#~KA
zQ!2mBlAz(~u)*I<qsSG9ftV3?%0NZ5*dLo0YB(-8$Q)Cr<H<ckd%2DVA8zW}7FA{M
zy1(~_D5BFHkvv|7{HN9rPpG1@Z(hGl4|l`gr20mI_^ai_;&&b~hskwPS!85vr$Ilh
z6-OYdz|_IrGGq;&Qwnfxqke5WU9;>753{2$U49V5YKNfB>!2~{Bixdu>mHJ^QZwQt
zaxOf~kQSaek_T6!U5C>X%3nr>V1=quc6wMjZ8kZcF5I^1lOX70I00O}MgrsRaaXgN
z*X>E4Xw6Lg3v{-&glawqGJBTlz|!HRk>Lr3-G&udq1wZdQ3S=KjK-u*ta4x3BmXEM
zq35TDqkA}obFNc}4{78(C&%}bZ+_v-m5_~d@m~#Z^qLN{8k)mnjPIn$=;C^u=<4}m
zcRNK7Bm(25R=p?i(|Mhf=l)HBiZ~0F)8u|G%b#X0z4xk*ThGbCaqM`53ZIGVZpZVU
zi#pp3*2(?RXNUD3*omC3wxFZt3xQbSd?U?i!9L<B404d8D2l){Dw%$$ZR|A>xKv8N
z9Kkp<VyK<`wH9*5;L5K_IlgvV#>51hw47(LmTXz^r=m4L`kAATfCT|-ANGf9p18fT
zdriLSkdC2tEQ|}YW}&QNXl+aI92uPoBu{N0#+2c@Pi~%k62<b0nOHqs&bA<5i^gF=
zpK7gcF|iO!>6)jxR|L+hnkLeQtnM<KbtIb;Q?gIO=K4xC4|9~x42~v@EaZzR%|{di
z_iBuSi5O1cCnnjPLPmhg?#n1(Q&sF|I*E_69(U{~KE{|I<gzii9ke%gzq}3@Vc&OJ
z$wh}m0?8Pa<Fl@&vy~4~Gp|ZOPKQ2c`&rN(LoFuRP$sL7n=n~QS)zr<jCC-4c9(h9
zaM2itS$<_IXHMudVuVY6MZhS<HJAw7=V#l%6aK%L=+H%fE}<9@>yu=SzG*$)v=CIB
z21V))Dn<*JB0*m3aMeJ5i`gD4>{ecqtL)2MF(Ks*TAakM{*zR_NmC)z(Tpr%<l|lB
z-)hyD>-h4ESPeRjU;OnND33P&5t2ec<<I`r5reD0LOjMFwl@-2_?Vl8ZuOQa({-tZ
z98aK)fA$;>^SZmGzyIZLmHa1=nBtcaL-v@e<a~ect$5Yv({l|FNBKjoy~{Ns2TTJV
zZWrc2MSlJt!M3WOBc}TwlLwA~HL4Ppr^$rq!(}_}<kf(-dDc1K<1{r*?hg4YC)2C#
zAD&@;AuAj?4ooLD?k{=Xt%{sUhfX6aVS%dYm1cw0lD^fx$lkU|whP4Zja{CxUd>C+
zb1Fc(U=`#hPv6r)yEI}1UGQ14HGL?v=8WzLijn80<ImRE=o=U5kcCHIb`aG<It)Ea
ztD3M=imLu*V{=p<<L$}i<ZvkeAfYd9;h^A-m)!7nD#_HT+5PCKuGQab0f_rB?)}xm
ze0J8c5nd59UoBw0uoEgp|MC76`LT+qrExJoTrQ%w@dgWe&TULnsWrxLjn6kBR7H7Y
zQp&GMW$8h>iIMk|%eLE^|8=nE_UBkr@FUzFW{JIF$=UKzqLKGy|E9)|nN6Tf%o8cl
zekMD3{Q+;x<%BR{hir?5{kX&tXstKi-U58!&MiZ@N0_E`5|gf4%<x>OFWhFIR`c0U
zTa*+2j9HgwSjTkJj)ch*v|s6;+aYP<uC65$G9hc-0^3>!i}uV=!%iUXcG~K?s%VS)
z%R|7auK>SK^GTN&H)g_hZzRkiE(DM?;c2s0GvOr2-y;Fyo<>dIq?`zC17Sv^<R#CZ
zXmewY9sF-L8X{KnYB?fQ8X{!254s>|3+FDDYNMtV7T?;Zb(vwTzV>2gI|)6R%Fh>k
zjk`nqYOcymt1W&31$0~Hb!&qedq0O6=fNBdH$&Xl+Q6V?N>^)=>_(V7vIvBii~nV!
z+}KTOSSr<Q6{wjIdT`B^>-`T`Mw?g#^Ot*xx7=cvm=)-Iyy`>pw22SKhSc4-<`y;-
zk#+sj%A5!6K!h?Ind;q1W5#E5%*LtBLg00Wz7cx3Y!F}b$e@iKMzkVw?nF>ez-zZ0
z^~{u+%>?~)WBQXuwjAhka2TV^l*Ph_F9E&aCk|%&aaW!8a+NauzQ5sUk{?di^@^v<
zbv<|kZ7>8^3vfOy_=5F?m&Q!9AC$s(rk;6o0^M|3O=E@p_$a;az_;4C(ed)NSG8*;
z?LM5H2pFa#X%v%$++pH58GEv+A6ojhJ{vh0&q`0xFkER?XhHuV-fby;2$5jq8l!>k
zjZr4%Wu&a~)hbF==8F<@zXQ_VetZ%!bPyQ{Q^h@5;{jqyTXMUZTHp@IuhF~exNs)I
zG|NHMU<s39Zw>>e%)8)cYbkrdXD7(Fn7rBO7qz1n9H(|FZ&59y8`=^Ggczu{K~>zC
z3-;Kf<r@FV(WwEUC9#U?wK6~3$L+HB7RO~vSGtdB8qGc>N*uVD_Oel5UQb_Fmcs*N
zni#K>aJT*1jW1atmy4Jh2th7xDw2Ca9&3Yaw@gqOuV_9i-jY7H<lzo_AQ8$)wp4<s
z20+`ujl8mzHz57|;g<p_pIE9BtEmYR-j&J@C3EoGX9*P`6WU$!bVM47-YQ#fw);}(
zMbrhoEHPh~u68meYIUsBV}%NH+vfq@cpNoT!z4hUvGypniUM$#xFnLJ>F9QH4Y+&r
z<xLf=(H+PQNi;ZAg{MNeAsg7T689H-LWMmijYbQ*O)OAxaO*;XzR;k%!~D8Y0WeCY
zCb`>y+Z1UDV@-UamK8kvRAfZIG5xgMeiF!LL%j2?t#TcY%hJpB&yeW85e0hy)VA(j
zWV|x?s(*`4jMn%0zEbkEm+U*Ph>O#q@Y?EE5ov=Zb}kP}JtqAkDLa?Y?6vn-=0P76
zQCQg0d;Tj_?ctdjQNX<shdXWL&-MZ=<{ubu6Q>8)tXo+PGO7HRnx3GnUnm4>B$IhP
zpjW8s)D$H~Vq*qzxib>B0$c&(0cHfr9ULP;9z6I3u}lk}ZsKiu$!b%~%(QDaLFr$$
zpVywHR?F*`YdUem?8t5_`c74TAZDfioIj`Yon-;OntoRe6UWdD+Tb}D-#6_S*nE73
zyl%Q|?QBiAWV9O0RcecP*salWaGecL$>I>~@%O#3(t+ae6XtQ_8%8S;KUm7R+)7=t
zMV`$_i9auJCtW`kRXVJfTgZvpxP?b=Tdwr56|*NTbG!vuNx^oaWR!L2E`vo?m@P9<
zFb8lnF7#f)H6Kj8Kyv$a8@s}oHiYZ5h&kc~{^;7mM_)xvK#b%l%!8g<Gzy|>spa!g
zNLP9<)wNr=ILRKiR^;oPE|{5xK1%7_y-fx8o0SG0YnpF$39|E3Whj|KUgD<+_$_bI
zXZ&clf`j`YRe0SQtmO)ZGi$Q<S~~J;s+G`A==2YCbY!J=^KTPc%oo`19hzw)`uo}g
zu@8=}VU2$zxcSAWTx*s+x@j@ePBrM{Rb)?CFLAv_jAfH2zhb#$aew&NJX0qZd1l;L
zsg9UA*cB$b`qsg**az!G5!d~}V<Sb@(5N?#-P%UHqzv-s<PBiw<FCZE8F9p}EImH&
zViPN-*SLsi?Q8RJ)Kw)*Tp7m&u~&zvNe6enmb_yC10!j*;W$Ixm`rLVvy1^5?Y0?f
zOmGYFKuM_{5L25jnlf%LR3wuz5Y!<00X@<y8f{KQFq<zexRj6M^pUSWTy@#Ywz+io
z%GMzNL8*?GBfM9tR^6OhwyHz+bCzV!E=>dHuQeX1@4gW>S#eQ((dcK5Py*scFrGK|
zq|LO^x=Ay0*Y5OGnU(+WV!TjYLJfO%*8_JSa~#n*b2V5cZ0b2Dr8uw+O+R<As{A-9
zfT?`L?+|N)L^!*ZS9m=t=;TEo9L@F#cGlVom}?aIJqs0FZLme!MKSqVa(W;el`Sa&
z#1u?n_Z_0;=O6APVFoTgvjWhckg@^Bw3V%AwvO>fFP2mx5uJqik3G^dn|_QGp|>Jw
zzRIOc%gl@Lxzn@rO$IE@wH1*~^EJQgd4GFEmD~PRA@YaFe6h<TVfN)4nQn0R_l%Y5
zA?;-gLnWiZg09zFVkx-uo6lf~_!#ZnG?Ik>xSiD7Wbur58GQLp*b?)kWVxbJZ`DS_
z3UQMfO`Ub#>Z@I!?*A>JSL{PL;bkTvpmKOy{n_$`h_dxW9qjgX=6VT}X8c+XXFk)n
zvcUq3LB6KYA7i=N%EXot=%GmK<U;h&n5Qr>bD3g7Kru<J1znfh7yHYRe68{gDfOsy
z?Zb|(UBPyW6Y3q_Wc6;^n1fX*>F1ZDfH&>x4%C?vasxJT9>iIH_c$~wy-6cC<1+h@
zeDz7xA4}edagh7AG_A+mZF-kYj|Pu#0u1uyT5MIS_1`^jNxMfRw%^q>Gk3Zs>Rlb|
z>YMY|Qj}FVopliYXTh1#A;a{MN7^Zwy!tB}IkEM`vSGn|j$dn@_kZM--_Iyztg&3s
z!oR3BXW5J3W0|?Lp0cjh%gMX6-e^1KosJ)2bfnj_Pv!-|*up5j*;BLkk&`cS`w;yp
zUnb<PS4QwuFDCzCE<gPkP!CsD5vQ?ypET6ykPKh49HN{3U1^d}RS3My{4?zX&(X<)
zhIkcm$txZl0V=ckfFsHT#szK(yEiL6F*SNSr&*wAhbY!>Y|I7)X4K#b<0Km>UFq>V
z?3xJR-dBQIefWO%>hmA!9}L}KF^SqA&9wG-yJ#l<vbma1vqoFR_5H1&DfVOF-mD4u
z5#!psPjc5)_nxONbW*S51wVoc`VhOuUST%K$vxK_Fw#uAP{Xeo-fIr0wK|2G_}0i)
zV9S0lhiV2)Sx6hZ&S#4KP5VR)E+|L9#2GSuQy|9FlogREwGFELxec$D32G;axhT5X
z6KeM~GQx%g^)qwEM%~=XxddZs2b?ux5NSaSEWX|%9|s+7cK%fPLg?t=&Pf`#1k|tO
zJ*Y>Y^?T)h&kWrE`Rv5twjwT9dkOHfl2#t`YEg`S5N(u3M70^G@%TJ#K@_)K8?6<o
z@VAG07k>vtZp}YwzLh5Pjn3X1EcR6EAULt6O5fX)fjj*dkC`vN#>Qy*BQ3YI?{@RC
zsOElnV73%cwZj<_8@fk$%{eqSRIh(}_j}XVd9T$do6X=uoZs&`p^l3f<-gPRoS9pT
z1%x&ZU6C|eGKv-;x3<arTgS*cI+6&ESMnz2mpuaB_4PjJ5GuyT%4PPS^s7|#q_-@;
zz^61E#Hm<t`)`T>!x=Uy{qJj+xXk|(6g<9K#-Pnh9wkh*?lG2qJGlez)Uy3)cOv^G
zWao*Bw>_;-c5=YYMvUqD6~Kdr=W(Vl(a2C3s95bKQQvfY8dZ)R;fMF6u{-_g(OFM=
zm)6nu`0>KmT?aCRU+JJ&?)x;zAGv48T<@~BZvZb?kv+636`$%(AR>&+Vf~fS)Drf|
zJ`XBcoAsnD62tbs@#>-D<O9@QqP1~jeW~@HX7Wt&2TuLm|3~Nx0|t1-1g6yn+_SF9
z<g}kA4<=c7dozk|ZiaGa-mHwMYEX9-pg(lwV*=AOs+OM1Nz)KLj_^j8Hi9juHKW=Y
zExA=As$JXIx*e@+csPk`cU0!f?ngA)j#zWwVw)3t%S1*@6(rdJvco}OlsmVZQoZK@
z3YON;XhLK3weqp|G;F4fuZdvn>(?C%K>Iype8gu#cXpl6aRfzeMz|)2DS5R*iO0fa
zWfQ=aZ|lN0{dgEH*mge4$n5Z#_U8pLjQln_ch@=mCj{_VG*dHYNx$P8J}=`IiR9aB
zxQG9~U%9v!Nw@dh?MIPIc!IUdu8~l3?MXE!8fQx%Du9raq#5tmCa{|wNHR`;!%tDX
zJXB%R6d$qtF*wdHWoQX>y$1eV|4xXUlowW>Sor~xVPfn0mYWHy==W~>G>`)dbA4*>
zS!?B~auk$kls!Mxj05V+ztI>r`-kNyva~PNbOVE5TO$1aL^vb4E^*P)+u!^xWc~X3
zgS2nAkbR}h$%;EJvdt1H?@$R+5(!K$zCU;qbkW~>jw9%A#ROJ~H-8kZ)U+}V!E8gM
zeBiI^J~#Jfg=AA_J%O-1T@a52XUSMjv5tfQYRn3ZAeDTn53vFfJxWpu{(aro>-ROQ
zAJm&Zjq&?Z5TbTfzLG<}d!;dC`e9s(F$N|vGwh^&qFi3N7*q0!L&~6BnCNB+JyM%#
zNZE7dKitWKH7;o?0-bq|L>AV57g}b36j$ginZ=WPo1)1BcHJ$~mURco6`$#EvV)gl
zjJ-C=Xs-cpT(oD#X2FL*@UbD<V0f)GvoWYlR5y_&GO<ptr-aG*HGO=q?8gL`XEpY=
z09x_)=xd3IWt571#xip4_Dgx<tZnW$T)GM}+Vv07VpZ>z!!#mcDQLn>Z<W|f#GCzT
zAtb8e;mbDTj9%2;<>$^bRwKmM4m+JwWf~$E(7)6{gE3h6xox~ign+lJvcOD6)gn8u
zC+-pdaSFbZM!srxfogi<H!lQZ8RlS_TD5Nc<7dbjZIaMYQSEF+R)JsoE~|f!-CPA-
zr4v0$(*l+qauJ<Y(EO)LRH85{%70IQzo6TmT1Hq0^aK~L>_h)2y7%?Fzw(aK@w5Wc
zgKJq6Tvcg5!LbrAB}){G%07S|u1^$3WqeA^5V84n_=YD2??D|+eWm$Y`xoFDCXP8O
zQQ$RdvLNGnI-PK1QgBeY7stc3(qy#Ac_sBFjUM9L9F>?djcy`lF<@!zQ!v}9VIwB5
z^@#tfAJSu9v7CfJ+Tc7`<WZd}Y1VblCzqls)!steV&H_N@|XENX+qcKR!+q+DjxV=
zGwUx}mI?mdwp?z!Py3_myDz_-rj{q&Wa3a^S^KhRnj+n6;NK$Za&Lgqk`EHrQyIP3
z?KhC=cGt*n6@-_4$mm)VEB?ih+V|&773fcpzvR&foy74HU&yfR&l{F{Ep~C@9F2MN
z(Q585xrDkm7FI*c&Q86~&y077Y#TczM$PYze%Q#{Ur{}0MYjsPeY!qWlSDej{+AbX
zkrHDo-AdR<3+s1u5(O_@NU2J`c$@-NQ(%lkU95tlX~r3s1`V?Txo)s;f4k*Sz{mrN
zzGg|HO7rMLjWGh&59*5IM3|EydkT!+h_x{&DwF%Ftxw#<r);xzvG0MlYJD@E3U`fg
z-vMAj8`!zwH?AB_57LYXenN$tyf$Kg{@nwObV5T;XNI{?^vQ~gs6;3Hz20guXtq1~
zaB92jTIy&4`bE&VjNx5#`n{73E_5n=&tAh+v!fFQXC8BECv`p9*U9-izywP=b#==f
zi?|@s<WB)lncNPhq^e?*vIz9r@M)8v+cs_!(E~)Pi3-cttu8W!jVHI9Y#XoLOAGYW
zDkt>^SX20LL|`HbDFY7Vk(dCt?5Jle<ws8YFqaztnj3{>I6uSnPq!Okpzt5Ko^G7Q
z<|DZSb$ZoqBcl3sd5rKdH)cougbFkA0G5ukjKh^H%y4CGLeB|GvpaDZIs+~E<j6kH
z&(F0+@PEu1xmuOsrZKJi=$rQ5@<*?7olIyNT_277m1dtt@uW8>Pdod>39)iodrG`I
zG<m8u<|PS1o5q3kFYe>~G~d}}lFdVMwRcTWm=Y~sU3#qq!D4KeYa5k&@z3cJjdy3?
zAeT}9w|*G(|LBJofn^NsOy9!V-<&$#oc-F>ArWv4j+S<;+74>6ij^&BSDAmdI!)y5
zI?2qJ?PYveytzC1z{?834~HeV6M-zzPgsxt>`GrDNe>2;vg*Pa_fp&=Kmomwqukxv
z%JKyfM%W+CwqOPG^H>jRKW}~4c=okAgX?;J6V7)o$Z+fTQO!_S-K95FF`qUva>Uth
zP0$2MZHtzTofo~oRplk&I6wTTrYE-&tE>h;0_Vi!L|Ih%hVK{sKduu>ECsVJqp5e+
zUks{Q#x5EvY8(nYLsm{Ge+k~pEmfPTpO0wD2nJ-TT^hg2wb^%X=rI19Sqgx|YV`e6
zr53GcNgl*cwXW-UgUb-?ZoAk)6`jj~*270TI$A({^M|eV7VDnXqWBO6s1Jg?zWZ5j
zW;ZSb*SB*qlcJgjHs|`k#y!58%hm~jRq6YW++O{t<xnoB|E<qHqv|BPk3}Z0_0y0<
zcAgorb}z&+2{71ca41#JTP?c|CmGHN0m!))U5VrZD;;2#=Ex_*ZH27cn}2#D3inXY
zFXQ8<7G=JnqSM4@gQ-FOE3=c_nAov65;`oo7PFe%V&LJISgh`yWZ+#E@hTeIAq3I+
zD@Vwm7LdqEg|MJI`Q7z$<lGd^IXaC1Y?h@FiOHRNzsj$oy)UC0`OU4Ei-KY#0W$r0
zX&gEpZ)~UIt{&m;Q>U{n;zALWj8jmtQf#o1I_Kb}W-2|_XjH<~@JJ(*ZH^kZ9147~
z$8-B5CY8-)j|~0sK=0{(#+1yfYnbbVBztWEJetR-LRhS{&qhaCtcYaKtx3cVgNSu>
z&R(5aR#Q;7o>H#nxuMTy2{CiH5`R*@R+EMzlr-~2{xG79NA5yQYmq3f54y*c!IdGD
zJca!IX~Fnnw0bwvvk>-9Q$;Xn!%~+=8U2Yg{{{*bEkB}P-oh*1UXC6S@!&P}8g1+=
zjd5-CXn1PAZu?h2i&s+iphA`^T(3f}=T9kvX*c(7vaGDFipN1>oO)_reNg0@DpY0f
zufW;Pa9mV}I<N?ophAfe1ezAxuO<kGTOeTIA~!|I;p0VT$OW6_9A8(`p8q$UnYyg)
zO35l!#odS0aq3I-nP?SGcSrRHo39bnVJ?S3B>`2crt4^`%R~7&ul)I=1QUdSkCcRx
zHyq!raXQl~(>!Z?)-u@TSPyt{Xc!~q8=odzpD{L?O9>v;L~l15;b>WPt59{#3_TlG
zCL6;i;Z3m5WX(rQnDndyq5^5z>{h^7rrbwYH;D%-Opj^=m}k<by4d8`VY{=umAPh(
zA84_=nsd@fJ#*d6W4q40Un)~Z6xmp+!&l&dvaIX5rZ}T^8q2#04r}gnPU%*2w(3$y
z49i`^X-$Z;qL@GCC48ePDGh#iiSp=+zrwloE*t06iIM<v@)@kC_Tw~LNsG?r6}W__
zI~SMfxn_y-AAROg<Ln=|?-vh0eYaDCFuiSOI--Sx!3%i2z6bMA7EhSfn_j(o<c`tq
z)u?+HOvcbyNlt5AUUT+^%_K2s5L{cEq@qBq=#%0~$y)ZP_KmiuR>4*(P93@e>Mhmn
z;>F*_U3~?_*%nSTHNV1+?%LNB_JWwjG-kdv@f+_o2!=Od@KRc6XILD+y=e<QF?REz
z@#Czg$?k67o^XOs+usm9(mUcrbZJ6A^bP$U>gK7W{6Xn!#*X86ODMc_E5&v;=YiCN
z?8bNT!%5d=(P5e4-<3Tk>eoCMXI@ui=b19XlK;{?oY6R_H;A8q8{5^tlI<8d)bKiC
z`uE?)QA@U3-DK*@5Qy93xV5ltLvA^YpK%~J)dX-YS34s+x6w!9C4JSU5zSQDB69bK
z0Pvj#|NOZpozJkPf4w$6wl2b2X#(wm=3WUegg@Wo$&z*k>wu3O2)TtC%^tSTOBKw?
zCf*}yUzqnIyVSa)N_mY0ZQ~vv0hF*@t`UzdQlR&zFJ%OG0y7Q=pFB|sZ=qG*kZMsb
zHGl9d&^^3Se2w)jQsyE6<fa^rK!<C~hfvbam8&P@OPXLkid1zcm5<qTZES7JQq&1G
z^U2vf%p4<%t;+n24cRftEi7v{(rFavf-jVI(TJtgu1<q?*1o-tKe9%;df8x(5%K#y
z+*a|r$+OQzdMtmh3G8K0pe1XeKcGxOSf(aTP#o>_P^f~x-#TXU_IYe-MY{G(eYeve
zJ?40|9@8Vg5_paCo<q9weev5Iox!lRTA5`w{Dk87tIK)jVCU}+EImR)y+Yibmt_5(
zBP*rfR98y({>qW^!AzFci^ty3<^;R^Nl+taORJJNeAfgT#Z^T&-PpuPt~#H-dR0Cs
zszS+E-u-LRN`uR7S>=kxRjXcZ*6NwT<D__~;+FQd7#?*Kfr+)fmV)mEQH8_fos(Ff
z>nUCZm~FO7J$`xc7Ws8ji-Nf<@a+fSt<trKGm*(dDdGJGvivQ@KK{KA`4<!EacUdZ
z&WOmr5*odn;EP#!1XGbNn(P0-jT1QgN;vrWS%fJF-d6*6Sglq?{{2U_V5fnM4XW<x
zq6gAj()WqHkHY|85Lp?fNSW!34t~#{00Aa>Em_7d7ePWQXKsscmTxwQ>CgtN6>7@?
zN>Qu%u;lkR*8k;ej|G>B={f?|j@rAPCUuNG4w!97;fe4)C$xJ4Fsr@ywM_`lhxx&9
z()~bjw|Rc2vwbQfq;#jutXOd2qE^53m2TXVKx-_cL?IXL#T2RHQDx&ah<3jWW?Y=K
zs>({{rlhl9__>%=7+7m3@Mr`w;44JiRqO3!?=tT($4wonC;Q_vC$|+B!00ajpVh4m
zN^91VNmishV-Rw9OmnkpbG1*XB7OdS2SY@)v)lnnsrp}fq%$a*y%&6Ik47HWw|Qgm
zpY-K%PCnkAryVwk1}LH@)LwFIdWm(%xICbPGb;6qlUI#hY=g~DIHv!FZnue9JNb;I
z(QwlQ9V_t)ePY8Ht$)T{y-gPM-%K|5*+M;&53tP%AG*-6WTta#DG&eUY=>3Zm)F1D
z_LNyK6Y2S2<gi?nfsCFZj;H_u7$LpD2?Hbi?w7&s`pwK{7i*iLbPnQ@!70Myc_4g7
zdN0l>v%GJFPx5xzIi=rSh!PVMy!YAEZDvxx2RgQl_aYm0gf=mXP`GZElP-!@*+{J1
zEvs9Q#i+AN)STrA0Sz1A=Y}youdFpvUHwM_PiGecGNI#Lj=+;P+MxtKlo1f#kw>%~
zfGkIGH>_1SQ`u2s?b9$3+*xaK&beZ<g{>YuwOe_^_mW?^ES#wM)m0`=7wy%_PA%3?
zOh||9g!Q0__dUL7qIgs=$^`>AaySUtdv+g_J?ne2j{8v!+bySWr5646d7L(GHQ1?l
zPpbt8bH90BNd8TCRK}QW5kOc|y3zjsP4LM4+xY)yc3d}^9uVp;`^s%RliwyCRs@n!
zS^<vZ&9eA^3H&))^{$BVe;f}R>TBTa>_Y97QN8}Us`>fO*rd2$;vdg`kve*7wdH$T
zd4K@yDDnnew&wpL?5+QreB<|TX=w!|gpmr;A(ErTsg#0r$|!+>bPW(t0g=%q4I(8m
zQW_*SLKr1uNY{X&Fv2myd%nM)@8@y<bl?BLbzR%zit{{P$MHOlNSF4j;dl6-_81=o
z@|xu&@ap*5DL%6sTAsNN5|qo^WmOWB@GmL|U?C2HT<WoA{@_2zTRGEeB2zqn_a{MN
zK|;LQ=}M*_{iY==CIvu_x&`}RNtg5PaR0r>W1=XicGARP^C%A3q#tzqt(l|iJm?*v
zteNreN5dz7(Y9(Qu^$fNo?o!!kM)UNax_>u+!wiM@=X)4Tc1=osW{-WxZ@|f(D=A}
z{g`<Ht+0hp2HBpWzGr!^eHq5y9SDGpO~i7i$H;=59`6);VF#S=|Cm-Wv)$r~vk_<k
z<5L10J-3yb!G-$Cy7_?PA?xd*Di6JUknUWq4rSPBOnF`?Q_lZe2}*h)Zj(kMyczYo
zbLdyXK`U7dK7`Y~w1By8#fEVYM>joRO`y)kw|d9mdnCyv{D-%wc>@^Lwo5!27F)GI
zIjvLFM8dj$KznO2ALA+A(UB%^fhYoajasQ===YC-pQl?BEnrTHe2;s~#fKhbJGdKn
zh%51IAK^Nk)x+U%okD$&Y96V!A_@=9fPitAq)OW(k|-DU$t1w7h<R@4doAg~@>=Jh
zP-+y;?0-0ngUzu5+EQrp+|(PZ^Z|KdF86$5YPyUsX=@t`3^UjpTlz{9W&Mw)n=!$h
zD9688n)6j)_)yT*e%}1^dz;K_I^Fl;tH|4lGUe>N*bQI3psB|ZewJZt>JZ!@V!4VQ
z&i>K(1V8~m%}5=Ub=^%qFb2n2uWH>oB+EN~S(K;vJ&51;JdrsBcU>L9OMGN}sITKO
zB#BiL8Y|PFId)JyDFnygq8V~o{B+OpT=8RK2`i>LPf`d5O=i)s*N7zJZ$bvnO~NK*
zzn<HFG;Dt!^RY)ep2Amhs3kUaLR0EbZyB}sfGoz*jE7h)X-vjFZ?0jg`HCzX;StHk
zDJmef&Z=;1tg!Cnas+Lr?!5Jdlc5McropY9E~vbv_!g-tiB}S~!(E%x+e8tiS)UsT
zy^_<r;Yw^|dgC0QhA2pGZ6-P8g?zGKi<?&^agYXVL=on3G{rYxx+8FlNddi9j2+83
z`~?>DdFRixL@K`w+uR>kg@aVITyP3Me5$zVdR=Nv0wEJ%DW2Ls_%h)>7uV6K_O-Bm
z!vgr}XPwO$WajVJk~tBp(P#?O)BA<p9JPBTso#-V2JNr&!YCIEm>eGTrY+w??}hu6
z-lyK1GJBn%q!yXBU|$1-vU=V$op^^D2g$Lf<!G?U%9}gI`}aDtgs_Cny{(Q%4oKEj
z*eCuzjr9oFbfoWQKod$0o+tI@Ref)}+ITtMj~3{t*LZ*+-3C6Vdwi@tvJWo%)w7OR
zRE&xGy_;_tRt3$db{#~+OXk~R^L(b&@nzxxZpq$;%xz}f)lny{slDCjP>u&)T(DbG
z{?8KC4vdoy;oo&s3W{P3AY65C!*Lt$A#=qx-p=92pAx-|*Z7n<b-~Je<N*Q6tIv5q
zjDiI9xdX0n-`-~k@(;KIM)4#-gM2*fy=!{zU(p($=>KSw+y)0^$rni!4pM7icYnV}
z7(AYvzWtTAFp{mU$^$O>Gha>`rDf(uV->F_-<704t|#C)oIWJf13OAc<YqKF=rKEg
zU<)t$vS5>9tioDNMA}?<`K~Iy&B$bqg&jl@KwOYhAz-GaRa^2snGN%cl&`n6g);jg
zK@T@C_@FG^9wi>#2RWA>Mco`PK<2^*jV_57_|NTXY|P%h)G?apc3TDg^eWjjX%l6h
zV@D&_{nTWZJ85ruFpj31z<66KuEH|Ux#9$-ywcGK{DI(uGLPa)1CrjSzK|)b`{^Ui
zI|n|Hzh_A~Sh}Ntl$2*Q{P@*w=jC0)rVgx*)GZjXJYr$jRw1{gu_-V|lSQK<)y+z-
zQM0eL%u%*(0%`2HLmvI>y;u#$x=~_y6ct4I?L%zL!&1BB+0Pg)tF4<Ro_O1ci{q_1
z^1a4*iRg^*bQyn-YTl2-*ci#@7W`o-6sQ%Lqh#hK4cEmqhnRdcX?ZU?A8&WQS_H^x
zpUsc6<YC-cZxZ{Ed(-tX?gueuEa>^)H-V*ZGku&SYB6e;{Ixz8w#SubjC+=6(T~mR
z<4wjram<)ODV+8oF!HTgX=y@poRzF%G3T7s;!dTVkK}-w>%PRIt9FozmMe{r5%}$5
z5&PLrgJ&+vB=pjZG@ol5ZckroJ$OIfkbnH;8P82fo^QP<SX+K@>XiBKJ~MN$tg=gv
zxIm#QXJhX?^iHC@O4fL;Zd_S^@f)vrf+@fjLsJ9@fnkK1B-?TIML^;MVTc=a0Fl%4
zqTtv3kk_A91-IADf7u+&k^mL7r6pk2IvL-ljf|1Ukvg;Ha~tpui6f=eMEhP9@1<WO
zl3=rBz#|aiGv6X2;26Q_DYHj3Ut}Y4!<D$(YYPMa8J@U#bCF{IXT`^aj?)=V`~Xh0
z3dq$XR6F1*N^SbRQ;xrWBe-k<J?iMfx)g1`y2hvRvZ?Zs@q9nQuE{5n)zPyi@FGfl
zXa36ZtA7rK0=Gb_E6XiRh7e?k^TE5zn!>>`?^r>wm)mutUlSf7;)jm`Dm+taSg2-3
z2T-iYclsbO?JLKc`xH7(OhgJ1JmkTJRJk>>xcW;`nZUomYRHpE)g`mdeP`b)ri{01
zsBLUy0Wc+fLYOo6c)>y?l`I*$RrU>xp~;gXq;T8X?N1l!=+3p7c_SFv!BEI8E4xo$
zRs)^{NT_|6Wh*~^QrSEXizzDFq-yb15!X;C7@eR7K=4sj^$b@ZMM$-j+WCL(kd5PR
zWvRj|HG2)mcm~Y?mT#awbq6@c8EoeWhLf-g=oAmz9%CUB)g#CrIi95pwxVgaSNf#;
zmzuVE+dGioyJlvd;l||g>uzd%WwK!tOykJM@(2PSDX?lR8`JWsL!fc(4C(LeeJ9=L
zaqy8hPghaV&wh5mC*;#)Ji#vXstxGsf|I!dtg&M4PIyiEF-F*v8@!7al$~uOP#JlN
zKNLzDC+M9w$_+ZMnaOHG5(mxCUIQ^!x#E62@hzGs<Z_E69{ErQI!qAKhHGo$-bGq`
zrpbXu7ol#)?yS-<ry0hmr4WEnIbDk-t@GI;agX+jm4Z1H(;KM9+Y(>-h_@}CBM|e8
z+;<4|VD_|Nu5PVsgmM8}#{sMC4mCB4)gL!PqIzpabiD~djX!c$hM6gjCbUwSs3r5r
zkA}45eUeB%){+u3q%$TtkBP<7byCo4ktQnBuw#^cxd?(?3v*U`TvBSSWk<KZr?*=&
z=r<`WuV?XA+5T*u0s?kX>o39dyF^#&uTKnp5{98%oeWfH_hbsQ*<VtS{6N9PCSoJX
zR{i|oPQ(nqy)f%%G1|TPgz+{FVekH056#TiQbUH+^-bP4u*L}1bur4-1;Tqnu^n`e
zI#{r41MvY=zD49HIK8FinpCob5~z2Vq7FNCbOUaB(zQi)beYsR6{>K-2Kq$1IYDtW
zV1IEQhb_~;M@}P9P9b}WwxTMSHD{=_d>4$BBsqEufL+)d=rAv(Tq*Nj+q~6d!}xsq
zbB{YOlog=p_8}vVpO*5C#;mD^k6Os^2ICc<<Y!MmF#fpsw)`-0lx2Fn@+uI>U;ois
zmSfuvl5u7H&k|+1+Kx6aONamKLAzm8**#^#kS^X|WA*XF4NZJ@xx|}v=4EDF4wM8l
zu$>XY4hZ3AVhWktsz(WTGf}+JLpda|E*hOQc=Yl*m*d(%b9KJG3}5IG|8Gr=O|&?;
z+F(C>neRjZtWuG)TnH;eX|gki?e>=el(9qFtHR1$@o-wC3$(aGLM@&8Il$7jN-c*q
z^)Fg+=|=sv2Z^_s50-AQXs<>B=7XL-WZ$d2#B+`W)rBQ2co?9iz?6BYhhE~pVDzNF
zrd8bOLFB#rA|AKYPWi9MQ<2?mDo=He4_KCprk!(S0?T856pj?mNqxpW(`4@Ea&<|X
zyWXsF;#5~6m-S+1*^Xux$^Bt&p6?IYQ#rjWN68tHKZWi$*J-qE7_tB1V?BQH;)_Il
z$%TLnH0j`haF}d1FXb+(?(RlS{J=Mf`U)M1KqCy*YrA^sK4oyGUL4I~PuoEf<2uI@
z+Zp^tx<!FLA;PR~M(0VLw5?}*b%S=J?y|<%y~ieNE-i&X72!HoDu@yS-sz^@Flk9G
z>*~$|l2YLg$?Ea(=ez40%rm`^lJ*$PiBdp{n~tz`iJ;Ww`waJ0#sj;>nS?;cRZ*EX
zQyDdW4~2=k0sd7UanxNHmp^JVG<z};$tFLMzuAfP8)>6pU}mJ+`S<SZx`}bh;{0y?
zG|h9V{Cd=CI};1Y<EtlkQCOBDoos#~z;JAB{?^&>06pjWP{Be(lDFJjf7eDnir}3Y
zs^EdzwjEyx8uS5C19dZ?Re#zwyvg~OxG&Ml>Xj5!j#oi&)mpzbJ4FiRqbi7Ef-0yu
zoWEXq&iiAuuR6TT9lawk@Rj?nJq|BhnA!Vg(1M)ruK*u%kE+-B<x4Mxjb^ies_Yw-
z(alldJRO#!bV`a4ZqH>O0!d|h=ev>n`$rP~wK$QEj@1;fZ!Eo?Y%%ZeF)h$?i2g82
zn6lE!v7v0aQq$r(__}+E1^ZcIK`+F$h+kxcFDFX#vkg&^cTHcd18LJ+;342C8;qj~
zf^TJw&RvMwv9G)2^uIa$c~Yc({{62ew6-(+U`V;#I}L6Awr}v6w0yomi<mb2p`?6y
zIk@l57l2Y@DoTc3TwAw~`en8xJo#kZi2@&A0sqcO^plCnV(ot`3p}|Ouw4?i+KXmk
z#>RD`kgMcH!oNPR@~iVU5>s^@xM+X(aKDLgP?e_%8yuYV{x%lDHpD8%kk2cu(j1M$
z`=}I`fEn00QyqoWTW0kd*_vQ`y-{Lw(w0{ti-cYYgbnB~Nn`;blE1wZN_;fm)E=^p
zmi(#z$|+-(+~b--{K6THGYLR<LZuSaGNzw<+-!_ENw&&DY<q&bQ%Dd!MWe3^X-kgE
zFg9E`#uM@9|Hae0^J;1K;t#y+O-8S=-pJzYSM&Y#MByuj^ygopNo5}iIZN)A$ImgE
zuQ2D{*Em4C!0-rb4R&R~ja3WlM9mMLf(BCZM1dwsHcrEiy})E2mHz6aXrOYZe$q>0
zDHsn8_ff`;h{I6*@Ww?sgA{e3Y@XK;gvG-V2r!Gi6EMV`0$O0E3sdz}qm~KDQcU<F
z@6`V0|67z{5^LwR&?f{g25;?`?3$R_+|Mmg^8MA9$Body47(R}$S*3Pw*JNLF=f>y
z@{nsW%^_j6t(zZpzAFWH7#6`AGAAB@vIB4G1vz#f|FDXY-(m5{-LXEs__L&b6m~QL
zqRHM68yEEoDh~YzHG}LwKKmKUbg|#S^)JK!D$<5euCFXVRN+zfa|mzf#?N#<JCoq5
zFFR>vi6=)UY;*2Q?-{OyVGH%oZTvszVW;s&v$eyFczNo7s?bwjJFL}q!d$f$*Y-bj
zM}A=nzUjT_U(vk0Dql+fn~v|H2k_^J$MH{6Yr@kEEP_D!{YHZY9DVM3HE3bENg)}I
zkHb~4q~_J#6kSP9;&c|{Ug0ron?LN4`m*+^s9<=L{xu~nE3OM!=iQ)!$+8SY*T`_+
z)O8fyzJlpC_4>_wMu4s4z`RzvYV_CUNF<->EL`1+D|!OqEMAWRn%FQ!k4SYx@kO!A
za0E|I=Rty(b*{}-!#_4j|Cm_~Rr~+q_Ib?fr7t~48xF51swn)JYn`OnYw6sBxGY`#
z3S>S#rIc>;^{W8}huuD9@7jO6)kLq__%Bm`7$j=^=bvnXv<qDD*KYL<6HJx=7l-9D
z9G)-<L;wPFg-ZgqwKLL6#0r!<2K}D#bgeT&!oE!@g<$UR5{He-BsjT`^;JatyjnLh
zR)BkxX2tRH@R41+zr>Z?v1Bv#dY#2I6;R2r)C&7qaZXo|j=V@1ibQ(af<A*JWZ>O)
z*Q+8@5}|(HlC_YaMj4rmVzG~p<KX)mRXZON>#^LyX~MQx)6?>JXpt3|ECHkD{Slp6
ztEL+&mnY2Iid4R1Hmofu=WhEKX?8Kpl-#<L3UxJ8Po|Z?g9a<jRuwK-STX&Zuw>2m
zx#=(<5uaRkk_bVKE4m`wtR(Fab@ge8aF&IAvtQ<6rD|c79XnMYlC@Pir$9NTc8@#T
zj?xS2BV3DWZ5&P5&%6Xw3Cq#(H^H}<)z9~PLd5|?dun3GKQ%+8)}5Pdsk~n8Dkv=0
z`BJH{ZWX!2Bm*AUvnwkc?KijB^!;23ZT}ct$at|y;p>{}bK1)Kr|W&;mv1mC8wg6f
zy}4)&_)03MV&d1;Mi7@BWGa(~<+AEEo6WWc^<#^m9^gK;B|P(FFX!;Ekb8ZINzW<_
zoo?+~sBfzr!*-WM0J|a)lKQxqo~vRuaCCMD6>E1Cw=kKXm$pUcJhSCZE)y+pBf4J%
zb`bE(?3MU(`;z1n&6`W_WHI(DY-m1+tJ)XIwoFPKTaT8nx!_5bXHluSmw_Fdg$7=0
zoupB>Q&`TSBR0?$wlEPQnbHG~Sd8}|V#?Fr)qpOreK#`M-1mbjYuTz{@Ty!$GkE5v
zK%K>^osz|R(-ckRIQFxuqQP8t$0}`q@aCufo5UcITKke)%*nohBzA~=p?a%e6<o$?
zK0Z>=;uA+b&+J=!DzfX+<vmf9kKLaRZaz(o=jCKXDJpi8-43E+qVawe9wEK_P36&*
zs|*liawM&BTlQ7TH@riK+G>`>zATt=EW`Sp=+`g_(fx+HM+C<!CUq83#w=e7KUAZ}
zqf8(ZI~E(xF3R;PAB|&~wE{<f@Z8;B6;L{fu88X)Hv$(+b{J><CjY~tPAw#cB!32`
zLymW`oF0@ILe<`)eV)+Z5tknFY-h%?30AHB8=|dPgO>jN@G#kTKekMy)+%kFbN!nj
z>w_XGsYVF7oM<PTv9}w;G<?|QpwwrpDObI*$-+W7|1)a%t4B?x>srwmsOnli_+;+B
zbt8?iEMG(DkoQf+J7h(P8dYQtJ+yr7iKiO}%jVIdObonXNB)vmk%HH5lVv|viS3|%
zFTXQ8mq35}NZ*gm@Eq63YCYB<-T0Izm_G~&qCQ$T=5bv0v9rA9Hl>x_2E53ScYTa)
zcoCjxMS~la40yYXcBaGi@tlKTY%_m%Ujs^Sv9_k%f1EHE4(OL`9geqlpwdre=$_wD
z9{+7YL)AJFr?#3|y<=|FrB{F)U|OH-QX^eRyKU=EUxD9{Rx;^EimgVr!3x9`Cv>~=
zUZqoH53uJkx0(M?tOiGSa8}JtuU7_r;Rb-;O8DNar)~5#VcYxxg8-+g0=rL^oU9v3
z;k`Q)^Q?DhznMrs;#dOb&gnO$-u<|P^HD^8`u>vK*d`!}?VjxOk2?&OTQ^-@s|sGz
z?wRoMhG0K(3`Me8tf$Y%CEr0({(eGU(DNEKyUa%cU}W<XMOHxk3dp-KpHv-L1k4<5
z*<F)jJYs@}??$JEJH~ow@XE$#UmzdW$P4w<WOaah1YcGr42hiJU)VN3$WcFitS1uV
z)MZXn<J#}!AOyEl;CA?osnS`0-@(T=$Ia+}RDJNM8y#oY<c_eekvyhqOGyV>bY%7x
zvv!VBIlA>OIr7nCz&W-4PuCg^aQ<KFDOA@+nsalZ5*esx>hC=G8Z8h^ufy}Ij_y!|
z-;ATFcb$c$UZ8miax$;bj59)TQsBv3puZ<7O6E@QUGsI$yDE2?UMw?k%cVKlmrog9
zdG${ICU%pJ_tyQa38NU7Jh{e%drgT@$4dM=NfPNG56J?Ui3wbvHOxU7sDu;>N~7Rb
z6u}qBNAI2#<R<IBZYFAbuyGnuSLaShaiq4)&{}q`86Iapa1SlNWY#CPH2*Nr628g{
z<O4PegGOqH6>hR(G@!J}RRVsM=bE_EFGLE)u2q`wFJXnml3_Y9luxc`u*)ZaHe$=~
z33nqgVJO{4_AWhR)+C%fB4CWXVbl=6;?6>CCNlA2l*xEa>Zz?$O;{BmW8me{Z5Ke5
z@y3J&=i-W4a#yyO063i%!|_P{XtHI`_+=`^WCY+0;XGldCUcD^X5fW-{B-w1iy*Q_
zk_2!<ywqf?fLpZ#5WF!qpNJzJD&#GMpKiNYMaZ?Ym{Z1vHOCUW$Nv9C!WjQ=B&^>-
zn3UkU64G{Co$|l5Sgry0sX!CXd$DIqG(X_*#&FyIZQXq5|HBIARIJw-E=k$_ww7kw
zI6p3!w78@=+OG6prmQ`NwCT=o{iBtg`Mu+f*-E9TR6_7MrnO}K&LhP8keeAN#I1w9
zwExbZ%Rm~R4d<X2Bayn!IqzC7Co+ibZ2t};OheK(I(l&@c~*ho0_8bMaf8KA8S=*&
ze*eLr1`x^TLQX|d@Umm09|h~X|L{+)@ME3f^n|6-pC=<U5)?}?{Db_q3T8ReuMYV3
z)aLw4_ZKpwtl{AlRx!^19po1Y+w}aBKdbDFTf*`b@+6O$tMc$MpZ{@l9{6p<*Uufz
zEvQJ}V0r;$Vi;w^Kd$E*p)i82;y=QtJGMaQKOVFq{C}xg#s3?t>w5Ix@570cwu!;F
zf0o6k{J6OKrR)g0T7I!vfEZP^t?``VO$+<(ZhH?!-Ke0?yKjCRNg@lc{G-=iV-J@4
z{q<WFtJ)oTDk7(@iD9kt-T51$iKxZTHZAuT4Q_qj9FW=1RFsv3-6Ngh6e}ip@eg;G
z^yi{WoN{DY<``&d%b%o#T-)W*T)GYA6to*a|DbUfON4#b0>);a%)DKru62XX28PY9
z;<U1$9m3}9jP#Ee0iz1y2sR0)okojy!-9=s-TGjwHHeLP!<=MM9=la`o(t=jgjVON
z!}Vut2Zw%Bt+>;#_+c>@g`cnbNa=KD)gu%x8N_3eo6uM6LjqtkEKP%@e@lw^c5Hrh
zr;fHI<y4~&B-Cod_S|EDZU2B&s6oLGMNYkE>%!_vXJ~|)JjdUE)5U=N;S2Y~s+u;p
z!fM>b?})#+fAA<&3;w`AUZHbazoDi3Vo&>(=oF2*-|<k50dFG-MV*LK3Vq`2vs2ay
z#ynqsQMVS!l>Kiu`GTb!D5^EpE!}!FsY?UUjA;H!T4>X#xPn}oL;JWErBR1GAJu|P
zRcuH|L+xPP1M2ohEKj(fn*tp!MmT$pQA)1L01wy4_58rrleM0*7038=Y=iQ#Pa#^&
zW+mH(8UJE-eXS2@HWU{8rZl3t3z=0Vu9(1fN<?D>RU35~2<%(f_&n2?_l>QGV=ADF
z^e)^jm6Rc+(8J`ziinCaYTPHat_fS&$O#i}cZB*xqB`>CLcd1B+|KV|Z8f~2TTW1>
z0&H^ZO}6*VFi`;tK$X`4xt|-fD4JbWpv>3%CZIn~Ie@8KCXXeNgu=N;gK08!Zy<#0
z83w~Yb#@T0$du(8oZD*Jg|vXb4jL!u)E5iC+iz(#%k&ogg+?l6mwo_Weg{4@yg07z
z_`LZMvWy>*Du8wXgK%(!vln!Yi``{w4H=O-Y(g0w$>(TqZ@mS(&wI6zVR%dJPph`H
zlaZe!mXhmL{f*~p|L8F9nz@BtQLmes+t&MI8XCaaDV+MfX>ppi7CIY61<U?0TWSNU
zeCz`+qRBkx?bA;;ly{E!4NF@_4aT%nft=S0dDU)WOY}eMm7A2UgSpxs!|!3%Yfiod
zUup)93Iz@R=!qcSowc>?tP+t!KMX#9)GSJ4W2J<q)k<XG<89ZW0g6^aijLWd*eK=3
ziEpWk>vu|;Y2GH#);(UO#uoTOa#PEW1J}8<n`E9_u>N-Vpf<x)C<S1RiECo((kqel
z`xzX^doY~o-l)l(7PFLPkUaOy2EV<8@yO1{ANg&R0YV%!M@784zi1mAC&%QvK2GKw
zM<>>-8`UP_kwzPIs$m<x1~5`;GiH>;iCUHP?%q{2Wi~KB<>dIuw8H&2aM%nr<IUtE
zPEq!<q&wV`%b6Wbu6oR3o9$t$sjhO;{<|ymYiA2X6zv7HvopO<1GSl9<;jW3Hs9%Y
zotRaC9(9wV0PiT1Tbo!_D94)2ypondm)57vEiWd8WUDDo+DQbmKWg#}o@6w`6TWhf
zw%55Wb6opkhDk_+U@^iCEGHMqUR#)>=2$^ga-oM%Y^^^-lo6d-khj_P8ExEuK9A^J
zrjkOJ=*Ty+#NZ`5qxssn#NhXn?yP}wke~I>8Q~M**VT)5ccmR_qId~xyui8QjZ#|`
ze~fF@sPk?6st@dt{<xEs0vTifO7QHA(5<-pS@m-_FdPFQo+T7_bb!NEW|4y%-6&1#
zLVn3n<8^?x!*jdS+=hsRB{nw4E{g!&;LKO+@z1%DNikHG0TuyQ=k{vi_u21S>|0LD
zo(9x=@JmysEfg%|@Jj41b3{{-f5t_+U^M2(C_Cw@aL->l<7W+qVeRCd$WNY6PU!sR
z`d~gDEDVYMM?+DL(m5S^PbCQH*0|cdA?;xyA);owdc2{I<M8@R7b|u&U31lu<^0zf
z%D7V04^L61vLv`4N8z&zKs$g^DE#8oyrZdG)rG7%cKL1X$<0Bg{cL$mGo%s<x5Lq4
zo0UyI{Z)oHOKMfYX87o@=8e)jJhBBk=}iYc@pv#6O)Sx}wt8?n4_y9xd@NQ$-a8~>
zBw5?wOE%`v5rF8TBgcFK&pMk;QIlr=yIR*{T#DE4s>=&Wi%#05)b<*f%9>#?J^#ch
z01LOD*{!Uk?Km^XIWN?p!Ca&yS1y6m74szErNs?$GCQZrX6^abHZ+B}&@gV9uq$1t
z&Z(#2`op}EPoWE%mgnRL*L9-bGQP0dck;`^EWA&4<C5oSXbBj;r_@@^8Cpn|5ORk)
z`|3c=$<fs34efU(_Mi*2z@@El*J@xJwa53dR^`}BO>AXft*s^{oW8YjMHqs4>&*Eh
zZp9=vVaRYCe)__uE?!5@Z2de+vH%|E(|onKDg<ivx5f1W7;v8_0$!$ai(mk03}6J+
zKaxoTJopu8HL(^;*#H;_r{Hgg{&~H}AiC<;-r5FU=4Sm62{DqM;4}wQOliQ&iz5wP
zl~dA3{jbq^kU5o2pD5k+Az`RKCP%2FV#Mb(B`Ct9xYgs-IO`(isoxP#E>)}s<^9RV
zRU^(z5HGH&VfFOwF^*SUQj7*`9hW28(f&nJ*qpO73Cjq0=&)s$bid&`AGj(WZDNL?
zK0W^a^}V=|qXvatmwVtyQEkDcJcDa$<fy#e2(*vdb<3?{a4<&wd_|LOBWTU!cp?*q
zSyph;ZgYYb-&q=5mi@xoCn1}e#f%mYQ5L4i;k}W~j?{AT`+l9xuo=`n$Zt!Snh&xN
zYHxOJZ=<;&-26_bwn56Zt+xN##5sU>d9$4A+Ui@PuQ5D_**{Wg&~qK~b?f<Rgw1->
zIAzyvX*Rza8BT4#bEJDE<z}uhZ?>DA>#m^7dZcMUIj}g8&>~Bn?o6sRP-`~Gd7>^i
zDIZXQr>ydOjW+D;jmfYP(3`6{@qU9Yf<)V<TU0)>X|gNj&7OGYrtm1ZbOF;a%+fy?
z^d*JS(gJg`GBNn#JT`;4Q@|HigpZUtqukC^Gg-ubl!YK=e=N4*Z}}#Neeg<>pJ9v3
z{*ieNBQkRO{HMmuOFhpm<1np;d~HngWrduTYLrYcUt^ldqMxoxeEPt5f)NNd{noQ7
z&>;s387-~JfN<qY0!L|_&&*INOpGeF6axP!rHI}aE8e9}EAS-817(uGc5yWz_Z6BH
zkW*clh3C9FJNWujnS=!OH;+AsZIqF>P%d-<Yv`wi{;#RK`Q86Dbvt-Zu!*R1gorxL
zE{E6gvIDFLy|U`S8VXYQ{dwDuvIQ7<a-d%38eL+f*Dwsq5}{mg7VmUW$3$3~au^}n
zF{sa&2mBm>2R%i(h)XoohRDZtBOG32!iT)!?*C?r8p!3F*YLy5ar@TP>P8_z1;f?n
zS1J8>zky4G8=u>~<kAS#t3|4O9#M|93wYV{QBT1MamyDc_b|``_=TeRkmFF6i|2<S
zjb>2P5M<^nno{<%8DMyHOLqiUm9M}0TYmuk>_zID!z@YcuUtr<_Wi9JR4bThehZnu
zR!jD!divLEoPpSa%qM-Ka&h7~$9E_50eaJ+^@T)YmmWr&Xma+t<WRKg(DHM_l?2-=
z)Cu#qc<Vy7aBshS`N-y%%o7zERKyss`P!YiNyFgf&U~~?#~|*;8#7mTu2}Wo>CYRL
zO&{dTya^DCM?@WBr60gVlqIy7f4`SeHbKZ(AUv*kBn5u43{{FcPh)5T;<c)$<k!6N
zf{bd^AdSr3rk89uiH&4jZm0(r>gsnAJjBF;?|719QsKh>2~9}L##q&bQ2|ud;JcJW
z0p0O-_wN33Kh-wIy;ilIjv2V$Ge=6$1<Edj{aK)>KIP*W+oE`(*u9ZqHAX6CNYJ(o
z4tg^DPwZ<r)a*2qw?n>@g-lfLP0)3J!aTHtZfS<ts&7HmMfSLd)R~Vu)y9LzeBXiR
z%hF%+NNcyAq(F%ypum@1=FA|c6$!ifgdwe3m0w@ifR-uYk9Ut|VT{I-6T<bkm6$tG
zwZzWz4JqE8RfVmW!f*3WU`DF~e#QzyV!Uov!Igc6VVFAxDUCW}klXd2)E9@$=8pIg
zSwC0ojESETI`BIbaomqrp3Oi12o8TX=4Db~`a?!(dR8X=t1<gR%B(QtpyB`!np{1M
zBG&J*&ZXp*Rfn$t=0%0UK@Vy$>KC7lW^`}GSA8JcG8vPv)n7M}+%9+{NnE-4F`55V
z2H?ge0+*~c2-mAQs@lQ~o*cZ`EcpaKy&r&n7_#3>!!9-`#}iIiQ4Pj4&WKgC;`?r<
z&fLNkrUla!I(V+HC<gY_an%t+KL!6fT1n+M4auwzpn(N2`fkJk?8A(?rgdH2?gjot
z4PFm>bSnBrINUKi$}k@tSFFPPExpA6Cv*Vv1t=|#X5Whz#}yR>-ravui|UD>o49ka
zrP&s^J21a<{z;wdWfkeZv%XVSrPOxjc+G16kfX7erW<)9=%?x5v^6dpD|IteTq29G
z1j<2uuLl;+U|ZSGED<IuaT5E}xZTia=l8^m3)VlH#AIzP`f(Y(Q>q0txs;z9XOc-?
zS90{FD?UMa!}w{LjfZI0v8F=7<WQCXmwNJd0uw<gtp8mzXT)wlYf@hc8m`nn7*h?I
zCF3fLqn;!25~2tx&=F{M)_bPYH(ZKatlo*#R<{&zO-zkCDrT`{c3E8a*sP{cO>(gC
zDm2l{D7Wt}r#M@A1+BRK5iu^E@12}RhsH1`gEbAe?Q&PWJhj2_Njzm<ucmXa9Cfc`
z9n|xUxZ_7HYIaN4;!Y-6rMeg?AnGM&0b91lr21tngg`4ELLEQkq%M6IHR|GuiDZ3a
zcvM5d<pmY2iu;hjP%gsjCY607Q!@;sHz8nk{5W0WcjVha^lz?%mwq1C!}=eq(cTUi
zl-^)JKTQamcyDVWyk)}t===e~<ag6s$p^psDQz7R3qHtz87uV#qSemgrs%>-1Y_ar
z%u#Te=UcD~z7vp3wp6+afP0r5kn?e>e<0i=J@|2@y|6EM&>@J@_;9!8-<G=OBZux&
zJ;r6arRb3n4^txFU~^vs7hLz1N8Xi+kpt;Re2G*^%4E(_-&|&xWa{7jXp6ob84Egc
zi1EMP)zqC9nf@3CtP1}L!!>>XhsniJ4>|fMTp7ffoa*sYC|@v^muL{gr!J(gae4G#
z3elNO3#H14AI6)P(_@uo{7_%Hv|Y0qSPfGSqwU4>n<L>ee4ev92`-1|wk~Vxup=Gj
z>I$784{`lSgKS<|HnCB&Y`efyI#E(?$4SHcip%XK0gA~nakE=|uAFj66AnuZXQOAF
zBRLJlK&vuDJgDfpS}q%A?pXpqJ?sPnqk17k&uT69mxJL(r0c}PhVa7sDyIGcWv#`p
zaqnkzq=HF^evl9%DbIKBcQd<1CD1ROS^w48Ly?BFl${4dFxSD1qw;WChDT5WsFQ3_
zKxTEV3m)1jie_U#qpz4k6i?_I_cE&N5FV5x=ik`aI4@yes&K4-8!E!9R{d@gVmnd%
znL&BCK$@$dP`nFpQ*i8l{*Sj`t=RtDGzQz#wOYOphmqx1OYLS^uv<W}JnfXLiMc_u
z!48}#aBAB`Zi?<jo1c_W^X2cgUM>U!ewDpD$ZJ`}<!NNeVz<F17NoBH^KbZun4Qw}
znHln5i_?B>l1&96bLjF;z4F+RRMy_D9gWP{!Ri=No0Au^ojEsR?nA}{Cg4yaNJHp?
zLF-)a#@MlN_sOwo+!c)&;EE<S1gW7QdsV)1-R>W;NwzTb@Vf%@-?8j)$M@lv8<$li
z^Af+EQ=F}%H~m$^3)EEe@Mf-B6)_dTR}?Mp6@HjQ11Qcp!4nlhsUDaI-AF(;O4p`v
z%wa8%R<;l!bq-JxY*#+%QBdyu<zLIS^V#E8_jZ{$Dj!y4bA~MI>`?4UOx)8Fvyty7
z^>F~p8{K&S{!rg5{ohbuoq`qmx&DO51xpTIVV=a00ds}*1?s^Fyb|&*%*U{qhxhHy
z)~p~>aa1iRf#`bE%qPr$`&olo3<txw3}+0B;;5fnHS``9{5|JiDn9P~I%%N9xx;Z)
zAL5`b`(!ZVAQpx$%;~BoJx*UrqO;-w1;<}p827*w!ROQSZ?JYw9}=_;L!F4EXqJ-E
zc~V)P-SHAN)7kH}GZK2>%CB8|ABxRS-}veU{dD{INTQq~pf2fTTmayk)wl;Uko}1%
za`8O)C-HrW{-1RY{QlAZn4wtX<J%r>Ao^iz%;D?fYfQ{+*5Y+9c$onJ(iWej0_KN)
zVgr85h9Xv$pE)*HC-!@C<^Sko1rE23#YgfKqGtw11$+F^M_M;ks*87@;ebZr9Lv5k
z?DNs~HrW!ZIkEhQW0K!h9f!<!6nQ~ik7(;COF)8&s~4H6Oedo%md7?QNZ*4<;UHP>
zyv%sUe)ym70c1Q&rG1}y2NLptl^qNoS%x$K>UMdu+Gu~L6W3!Q2iFCigK~|G52dg}
z_%V$z4vMP>bP6utQ8Ww=zF|=(a#(YfCU}AsIOWyzQQU3W=TqE+&dh!8PIu!avTGeX
zD3X~r_pP*_9yuWuWD($qDP$BPS|<lZ@Fl)m`+Y|#tm?y9x-eF|DxFG}*5JTvMC`9f
zoro<CixmR|TP7t;#O`%mQynzRmOm#aCO6mwVYl;`h-<y3YO_-(hAOd47}r|f{B@HI
zj@Zt9IZl)L70{3VN5|~_E{lz`^5=Q81MNf!<$9{@b*syXnA}3rc2cxhw~5s<NPhwn
zybgU2YJw|6@LIA#ocE#R^6w=kX)Z+aFdQ}h#<B(j^3N}ETC+0Q$0k39Q^jn;8VXbC
z0msC0lGB?4Lf%EQ_jx@b9KUYx7cGKMt;J6!iW|8%yeBXN4n7yapYIlqk*y0QW(jFm
z=inh#cAGsV-^SDxS5BzbWIlqawC`~X{!rLT_hory&EO?Gj83=3P+_-gVbKh-@wZ**
z-gM;Ej4t;u@6Vcr0vp*Gga#-}=VjKPl~wzaOiC1-hK-H!;v{l4w!)AwtA>4JN@xji
zkAxM*OE#%qx^i4)QNyIt6e}!ZsPV(1$hU046FxlCm!v!^?@O^-2z5ml{=9<u@>-~f
zp<1}#dOJG#LKHQf?`iLYOsBUinHbCfE(M9_lhE%J!~vc-ifEg5f*dOG3%1Z|uknND
zi1uF*o&%lLG@fB}q?!?wyN+MkLsK%$&10=3vBY;HnN(xO4el1<1e_MZVo<aZP~=D=
zShkG0Kt~M}&w&+u>k0iH4zC6Bz#I#-)(2GZ?>-BL37V}JS^>s`rh}i@G7LIb(66eW
ze<A>O2+8a2qr+kdkc}S<GQ>7do?TL)2H*4UB}L{3@5SO2t&cxMzTkXT=i6a_^J*lm
zd4!+Fva^|Sp4AH)Ksa&E<m$d6sPlQ=oq{~(SLKoRAZ<z6<m(dW_g>2?VGDYbhFBVB
z5GHzrjWf%1^>DKM^;af0IuZ6)k~FzGj`<CBa5@h!U(IOo$f8_qmZ@;>ZM#O$0@21?
z%BztIUG{aiyXk_8$f)gh5w9=(Toh!A@)zSIg4N#KvRZeH@!udj7&7yC%(L{W>M4_>
zSvN1{rr*^>BBQRxJ+o0bRrZIQPAR0p3;oGDSIAUB82Uk|h&Lcq6Iv72w3PK>Y)x>F
z%*&e$PJii8lx`8B=4U{SKnhaxU6AA|GhJh~*z=u(&w_X91!`rFkR=6*k2r5{YHR-#
z=H;c@Gp__&+mybwtEuFxf0ATQd9gnkV>kEg32)cd(%KurQ~me7e5n!i5AUyRh`JbO
zt<p&5?A;w?Q|e{sxWUPhq)hQ<s;}hadM=m(x#ddU(WibADSp?(L3lcx_lwR><M9R^
z1@(93y8_^0AD9$C^sf`rUhl8S*{bngBtn^WnB#NMhh7ai>3jAKBIR(Cji?hSz;W`P
z_kK~{4u|R7OHOfU(7qJUp0>#Fz{7>-)mrE5g;Gu7fQBLS1yRoE4>2C!w8YNKuGtRi
z%PZ#$hWpj#JgR$|BDQfBSLy_vKbYFdQ&ZA9yY3vH-}<TPG#qg*X}=qP1B}+mR`eOd
zL>ZIv^}zef3XFITz5w5uIdUmhE(_TeM1`NX=Tqlr$X`047dtgBbkrvt5%NYZh*Ytw
zDvyrz8(}wvoX+)gS-8k=N$A}O%0{Dl<C**(Q2fkr_0p%D+uKHjgMk_<vZO+ebZ3u`
zkyt2ar+;t$`HSAM^qXxlan%Hhyw|*_F^3sXIu<cMQ?ujuV?|cArsVk5NCP%<KT#i(
z2h=jNQ9wumA<=p#EcQ9K3q=w4Z<MWkvP9~$>>)USc||+$T%w*p;}Q9;O8P`ckkw7)
zv)-`lgNHJzPUBA3{&2GT{o8&&Rr?%@^O(5JPTJ}1iB2E9d*{u)EV$@qIndWZ<$?I+
z7x^K$`9-aV^E?{u^l#|%X?xgdSem;hi9EoAR4PQBer2Vu&3(ll)+8nuJESKhYxz`B
z#Z1A%-nu^eWKN$h!>MkB_OJ4l16dSmnEA|+rQ8BXA$#><TapC{!kF!9X-;4WSN>X1
zt;*wy6^=dr{>G>%p_zDKLTyQ}<}zhnU0f=ab$197MQ^u-F;VBH#5zg4Xbqn6!F41X
z@u3<sq{MyhZ}fY{-P^@dUFRc#Cbb!!d+bT<-FkO}&~UT<{GE$UQ_VnDqfjT-R@6p>
zPqxRw6OZ`z{*x?^URllobGBY(9(0_CAA(nQuHA}1qX}fi5a-|6!0`mT9AD61rX)O~
zxyekQDx+yz4>!hHMKS|cLlOOR;n&+!m3$2}0{sUKH(!sI7{`vT=JMdK|J}~fkIWj)
zQkPUr85f{cduZvzp(%2eYWrCa`I}j^{cWjMtL$`(2ZQU@54{+Idd$znvFY6>yOXwW
zabuPtgc^LRJh2)-mBoZQS^8vatmx{YKL@tprX0b^>9jc9Omtd%k{1^^T0;}JCnCOk
z?<Sa_>+kSRCVMtv${*KCXWU`Q-EUxQF4UroPP8>{e(QfcFUNG|XZJVYze*Ow4^;QU
z?0+yKhyQIt)%oAL)UuFdJViM#>wKd=LB?+$C{K&uq_H*>2o`{-@5?0%r!f`Z>mqI<
z?BxjJh7`kwFY@Hs>DTc`GcR6UyI@&*d=oeF<KXx)g$mrP>W}vu8CUTd3gWLFMRWFl
zM}A|#bNJ<D&Nb`Zee;$D*{rL~y3yR6*M#aXC_{PZ-$gU97>2CSPP`r0XeBzKXJ|7e
zif3P3<8qX-YubNlY|LZARM}Zp7nfzpPPiS;6psza72bW{A8?+0D9^^?UNtx@`TsND
zik|qd9cBAu-fJoJ{GfT>lWVx9ZKraD8^`p!<8X}MjyF|LDSGxKfHrp`V=az-tI&75
zG*i-TEGFclb7`gY5u#(aXzUG#QgMv1NmTRbKfhP^tgufg?;Xg#HdjG&L_je4&JQcE
zyanHJ)jky^Y(<GM(e-XsVs~>#qZ3$)wz#OHsV@t9?QErpF(~nEf+~~MabCSIq2a}1
z;<Ey^>haZhw4s%cjqmsSeM(k!n(I&VLB5FfBrJeu#PKaUzr*iGqSsiil5c((^1Cyp
zWP%7YY~-&EAB+K_3`2cFp%%9D|DduZ;a8D0U6_aOA%v{zV^HW0+*M`2UwJ->eu2H4
zFc2EHop%X=*5zf|vKj}aLd4(khqxEOZ{!Te7(#1Rm4_$7rg9eLLP<_G7t+`Gm?|Jn
zePTkLl>D69QP@DFfffnZ^_}pTHDg4GU%8sw_0ZMiuWzu$=cE7ydN*Fk>TQIp%2p`i
zgZI%Vc{XgiV%$$hbD^!z-lrRxhH9<sz!NmML80p)A-;ir<@yo*WYer|XuwULpykL0
z(hTJH<PoWjXAAd}Bh+tWYj9rWpEPuW`5x_}C|Y3Xq1{??XxaURTXiGoZs2pZjLm3&
zR~6o`?9(E~nZ8GTg4-nJhzs+RBrf$Sg&z(DDJH^{x=4*KOC_vr68am2NivD8icGT%
z9|TDi0+&~{y?fV&1|&4<yKTgGE}b;D>`lzty=O34lu<!28Ew>#1s_|$UdBJvCmGIW
z^CP&|5<ku=klx1yUF+qL$}bZY!=e?59WUce$A-!iW%s7V5b75PX|+DWycng#Un{IR
zZyru&g?kw9UALHa0Vb4Yggai(8LBFHZ`W7?S`XCg!e8xl>%(R}NF;P&o-g&kZ|irS
zY?BdvX||D!XxZRYH??|b8+NR#2F)E2tExw~9NfQe2e0yhrmKi1+Dt16)k=0W^-5jj
znVp_i4XfVNP4>3h?xo?i{=zX8L@I)!nH!u;Uig)x0zp5U2L#Pyl+f9cZLQa1Y!-jU
z_IYvI2d-M@$te(@dYTnOf5jGAN7QMX$OoeLshjh(7Zwuuy^?g#TGNwTzVF%Y*RdKs
zbcPP;FgbZzmD|y*f2OGe*$2L1|L6)&7F^i-nl>KoMTnxBU(bn#zr1!@nTJ~CLIm&s
zI>>I**C;r(=ft2`RsEuem$-h9HO*!Kg9fEe^XLuZepNx)-nd{lcX@Bd!5jI<IgpCH
z&!cmX_~X_1n2E)`i%E($RLxiSt}qXovFxuTp2X9_DLMt(70YAQg6ekLV#TWyw=sh>
zO5E;x)f7Zj4rD_57ufjVT_%To&A~Tg29PiuMRZ@_$RqCxn!E!P<n0`iE$E1;8t}Il
zPqN@WLK#3Qvl08n5u0La<pF~Q+??~n+jB&2lsf`lZ*DG}5pbO}>F_QrOex%?pguZf
zrGLvu$C0x3Q{9YLoBsA5bf=FwT5^D&RYG~!fG>CGrT5RaI)dXfBt#}!Hd-h?YdI1b
z^t2yV#ICaPdrH*L)}`k&sY;c3NmRHbj$duq!J?O!`YH9nwBsx}gyLgv_EF@XsA0G(
z4f=*h(9v}owF*}C=dtM~5Wau}+vGAWJGuU~@Tcr$SJYF}X&F=xZY@#bdJKb7BA%Q?
zzve|;<E*!Lc2K>_VwKHcmGj<;)VEPqfVO;VBGblzIRwd<SzMEC={EzbaZ#u|alIpn
z@nZaFhE8YR{@B{%?a}p~8T}5%SrwznrCa@>{e520D*+W6iXSyq)PNF9QPx*QJ$u@#
z8v&fdtgnV8%y)2TpP8F_j87<N8AVu4NHBy7szEKsZ>7;4uZLgjp|<D;z|kVTXafT<
zQXon5Lnf_3y^2G-f0PnLOBm#n3g1x{GV{36`59*!$;1nnQQ8&w^aWp`eqIwzN=+j5
z2oSrFQpT>GU4d3flysc(WRVUI4wH&p7|>gt4?Y8^)oCQz0Av1&e!<h)wnjl}7cqpH
zv9BMsj%<XPEMs4?Dsq`KY_qp!Xnqj#v<lq<;#+#|ndy4ydghdU7>8fN9|!$l%sz0`
zi=~Z|+BSN&Ri&J`(f(!+>g1vAXwgJw&3-@QL$trcwgXt0twQ-Or7k1WmT9<C?nj$}
z=dFSW*>KOp*E-UBR<14%dgP57ydtvA(%ZDwvW~0%w_~o1zHuklU#5ym{}OP2?{-pi
zll45QvPy`DaHpJK*4=JI|H;uk{***Wy+)4Qw(;o)e)_0O$J-#AAj=1Asq{<RT!kk7
zYbEH2o2Utdj7pz)u_mO?P-E#rK)H}Lj{?{i6TaKi9}RQ#30U-W6#wjspGd>O(-nm%
z&PomAtyR$nYcC^R_tFXaQ0x@31eQwh^oX>fQZ5>BKCnB|Ryi<QF*Qw?2<VLk8izkk
zEIUX!ea*OE+Cmy*o+q~p_&sR<_QsGoeA@7RExFvWRbZE_kOuEzv^+T04h2$>dC&IO
z^tRf7j{C07;Qy4Wzq^9eK$_5RmHWDH{MR7%`{$HIzWfu^e_1?C$S`Q`yTTF>2$wa1
zu_-T`CdvAt(iJpkg)LF20_(?^Sy{3*U<LVitT%~=#O#Ef(rmq?p82OR6&Y~e3R<ry
zby3~5XqY7_MbYBJR6MHx@@cB4dy-8N+q!mb!p68wZo|{G$N4*&#+|;ws2>k*oHA&f
zP=uwej0}!xOV#TVT-ndI3&@O%7*8j_Bq$ttL`c=)bEBPg#*mF`IS&%$d6oJj!FyKo
zSk^H8(c^8=r)3boM|QCc&|Au`DM}~yVwbBWw*oO`-GbO!FV~d3U#{;dPBpmdvC*4Z
z;f@cP!-8d#?%=6cavWO{U9Kt3J+$*#ezrC%@Pvt03NBb{!_{{`Q9(uLWI9f&zAlm^
zt1MZd3_4ud3!@AAe`WU^Yx|}HS@IpV)QLl8ode~<E7NNg%ovZ)dGfBMHG}p|Vz|Jr
zNou?Lx*^hcP5~Pi&{QgzPdv!+71=t1<tAJFMOHxP6>(Ex7ZeQ$%7AY2;k_tQi=TRw
z7(4n1{c0v!z6~UkZT6MU$H|!=j{0g;uc-)ITZ)=fmky;%vLQ7BB2JMreV<o;WP4{?
zxq@iTlG*OIZ2WBVrNI_5*K!B`Uumkk=zpAPx#qbfTt0L1p0OeTF#jN*at|%BKQzti
z2Vnni{dcvJS6K5ku}JQ>CO6eS=7ymk(0b)7L(Xd4;7g8ap;{ApM&PQI9hL!@UBQjN
zi+}t&hOT&aKm*rS6M+vRa1i>TS6mI6RK$_*FO`2s`RDeLdX9H;j)XWOm5wKW$-kcU
z-iV{l$@5#!%l1$DW9@MT6Zo7wu{$)o9^BF+yhr~P&>l%Lx={xi1>Bt*m<8wraKMJ<
z=RS#txz8Wzs|=+-3r)9Iz`a#GhGknHkI)C$no|OE&0M_#zjU9p+N2(0AM&JH64sxT
zY!qBhAmG2g)C(r&Dk&UnbA_L#8PGRQgAyAJ)j)fb^1w={L@koT(!+Fvx_K+QnYm6M
zXMV8`jE{smzCqvH*zRM4SKvi`he<_jZe0mQqE>|Rc*b-o?VA41snxJ7Ld^ilDR5Hr
zX}^aa0>9f0`vSFfO87Ol9T|>6P!D6omiDUx1QakvY?epbsSt!;iSA%g*UWG5+CAlg
zF3gs7n8PChyK5Hixmp`iLt<Rom<a{>q5^ym{kMtMjM=ZoyqpdrPgKsU^mpmoM?8|C
zu%H!yGFS~|YC`}iY^@8l$UB<Wc1+UM@+sSRa1W*5C<*;EDQVP2y&#L;+ft1bk*@oc
zS0xZR5snu+?*MDSZrxqJh=xi;ei)-TYBa0uJ{0ZNK#qh9L5>}t8Axt*89t;T;Rcw3
zHaIT%yoyJxR-&eq<~k3?B>j%fMJ-s?ckSN`+q!OwUG0GpHdU_^Y4<y-iXuwMh$%D@
z{zOFu_!C?6=b$n-P_qL_+3h#*V%3U|b$&JV&tT=KYvs~-O_qU?V;?&JzcsOm1(Lc@
zi2L!rU3TvXFsc1yJE}HP-LY&ORjO`}=MGDv{mQ3;Hnt$VOzXx#h{J6zKE$nV|4An7
zHw9db`Xb?u1XqE?w0l`+IAJOqiqF=?-Y5s>9MLYZVMvt*r?;YSy25kbFm*wGYOXS&
zMs(}(E}L8|A<MntYBui%!wVzM5#tB?VhU}8uM$=Wyy$6yK&VR0zDv_a%?hcZ>s?$Q
z70GVAdhMZI^CKrsnXiiP1Tk?_eEr6SLoKXXvb|L6zC6g(z6p(r0{ckuSJX_)hMOAF
zSLKwG##PwIHV()Url8)`-Y?a@%2z+{>-JRIu^R(PamU1O2#1e4f@&q|5#%{dKA``n
zy>E|avj6`N$sNkwU5#$W-3euKxXYQ{Dz}uHQYeSXvF_v;Bb$X#hA9b&$sv^@<~+8W
z(HwG$Fl6R@7>1dd9lqD}`F?-jKYoAx{{HPRu3eA!;ksUXy<hLw`}ul4?f8QYuKlVh
z2Hg4XcPSSb@06KExKML_;vP+#;w<*_pz;a~$}UpV8uCEqet8S{Q104+T$$gW;%=nq
z+*~PkcR$#2zNF>k%lt=Rs=fGqduk+Z5Y*BT5}fxI%5OD3lhKp<sVV%+6RV)C73x`l
z!pAdDwFH`+7V+%R>l9}~i-O_FK`r)M+r$EC9Vhn-1ihv1-_+<7v`0HfE&L1gmd63_
zE%SApVCC|<VR?X<hYagzTF9c(a~(hsg-x>BE&Dg<vpA(V=ZEKDgMX~K$D6=8Cvdgw
zo$0ddqjC#h8Rd38`~DK|S!yla+fw_)cR%R;;OZX_RqQ&0kuqjhcv=Jec4UAfS<0<v
zNNfIlOp-$M``t|KI}-s}G54VgYZ<$ZG0YFmMq_f7PE+KNvY7I#`qNmQLluY{d0n?D
zv$Z*jrbl6Vr?;BZ_poJ3RZqQjtFE9Lxd-_?BPke^4Wo7yzi5z@E%>@aArpC$RjScL
zbommP6hx50>?@Z^Zg)g3X3H9w_w4#xJmF)-sT6EhoLKGBI4BvDtyByh3UN4-<CyLG
z>>Jki!N9=PGK~U+j~${ud2R6Jk6Y!y`?OU-?)j^BB6B!Jv#*NXJzD&`rp!kxM@8-q
z?tIIOvJ*{J4~mJO_#ZC2tJTJ!CF{SqsT)CtO>(5}RF=M~Wn4TSsP4zV1yI;Ox4if<
z(x_||SNq7<)&8sHRw9KTW&Pk++i}-;T)^=!6)Ay|2UJcLnOXDjYW$`LIoT?K7QY=U
z?m1V*KJ3k9t{v$9f_0__p4_#cyiyU;KJF_G===RMqKR*ac&0=AN8;m^MlG&q!mhTK
z>k}&gXSwf2^B=1<$PS&U_T((xi5qJ9IOi8xkJt37CDV3X)#7yjgUA`m(RiY}?@_ar
zBTF-+UEEc6S3*N8J<9y^(2bMw|4ufqeQi-&+k<=;O-6bA0ekR%eN4$&Pd?$nFDGGT
zJByitXj7B!zoV5FPwl%L9NaC28;^WhJ7U+W2_o7RURM2dVwQ3xr2l&ra_prhpZY?n
z=35ioRC#mYkoowh#KT;}4RT<STt@4!!%X)?Iaka3xkU%US_~vtpJ?j6iH<NI&szFU
zVqCFfcbCkU?n#z|8I|ofrP%OK-7Q2txMqiXaw@#EP~p?WvqkGy5q({5Qj8qAn+eTB
zmNgdFaKU=J7;PboPW!qIF>z+4;faKVDNk1^)NCGXeLz={A%9<1E6)?D*o8cs*7WA`
zlcP5ivVO<P?{^eJexp44;YnF)`0GHQyHI8B*uT9OcMS(TA(`13T{*(_er6>4T!8>2
zx>MIcdxK64mzq}ZIlS0bzz0_9*N%#m!ve0uoWWBAM(TB;^uuk?bbq(s#!u|F1M9!*
z_5cCjlfq1r2p65_u4vGA<V>(!>GppTqFBme$rZR33~blCvH>01Q=QxW8VP<m<pHR|
ztXES^ec5V)CR{qI-y7ARoBy*NJpusM^~P<4;SjU9n7!-2JY>$n&<{BWT2%yel}@v@
zj4sGUpvn-Kfud7gb^COR&FX^dz2%?C_6JHJzUj}}fA^>VgU06mq|z?M{~yRU)Bwm}
zl{#}uN(2iG;g+z|i^RbQv}!D)<Ws@MyRnH-`ffb+hJA;Za6xF4$zK){ghqy$rh*mB
zu1pJbZ3%!1pIyl$8D{d~!T}%l1k@}OHE)Y)OmfEntf6{aP$5jXYjfmCr8%o`3m9z@
z2)dbqr>3Ddeb}7{w&Z;Nm_0gJZ;S1R>mbf$df{pO9~N}>&x~5fxC$?t%HS?|<FP28
ztK9*)%<PS?Ug)Wk*M!9Io!ir(OphT70Yy*hM|9Y<$HWrB8=qG1qZdB;%%Xw)Qwh0a
z449c0ewo)PuxYy6;Ed?-f^woUDT_aaU@{wod~}x=ph-GDsQ_?KdE=Kiv#E@?z+e=8
z(>t=ceHP71t3WwoCZHdLiLy;n;l2ryYXLw7&qURnCIY6MHvq^+1q3FnOzYzuA1l$A
zu~Y_l*#O~NDvo(!!FYAAGYc1@6iM3>y@7zxIw2oVUFMIDPo_7Xos^ayU42Pq)Gm18
zjh76nv~QLxp%(|d@LJqlDx;mqa3UlHl_>mAcM;RxpbU3e`wL_IZlH}Ind_hra;RBs
zagLL-Rb+E}jpL(iWbYNTs-5etHFbKc+}ZGv+jKy3Ltbq-GA&H&0+1hCq>5CiE12Km
zs1UONrDc{W4R7O>l<8{}&TiAt@>x3r$KTPmY%}9DSTu;Q*DbECV6}8*>L$SG^D_p8
zfP!?)St&AE4r-$IClLf7IDyv4699|`7?_swjD~RpcGdBP#$!)=6RogT6~5UNC`U_&
z$AaOERiZUc-&Z<J3I-#94DyHVnt?dVRGOA9MIpj=YpBFDji)*V!Zo*^9cPaWo=uf(
z8-Hs$Yb+^qIDgS9a+!C3_kW%{a$vEV90d$D$X6_&V503pS!jVTSZPD*!rmxvv!G{G
zlWl_!2>oarxvXo_FcW_Q#)*s*FPlwpwt6pxahQj-Y1Rd=loxh*;kIfpDIM;4m_Fl~
zv@#LxRkB%m^=p28O*Cm1L%j3OSe=L<7HyUZT4utYe5w+IlPtFebaxmV+0iYuhB#@Z
zSS6rzp(c-(2RySNnU{Hm>yYd2!h?+|=y{0ET%Pc5;{fW%O7#y>;;VzmA10xe@Wx(#
zVeO8w78Zi{K{L*O(mV~64~TMv$h;8okbe}L2-6bts(wv=J3s}OruSP5&a`(4d0lel
zfEktQ5yxb_@FhZSbE{5FVtFFYLak~8V)G@E24FCwE9Voy_m5*g;Z%7lLdp?5*k@8`
zmGRX{6V=7j-RxMq<Yf;7X<|}>2!Slf>7iGybVbsNqBoS^3pEX|5yEuiR$nwA&>ILj
zOlDCmT(}O$`PqzqMp%SQnJ8Glg>z!y2BcauL|Ec7me+!n-R#~?i|>}G>xsHm4Bd3h
z@375YeG#d(3295}%!70BhYjCUn0v@-mZOCmXkir5qYpUv9NPTX2Hh`_6Lj6|Mxiu&
zH+C=)!pj>mRGjd9_K;#cTI!AE0JYe^sc;_s0X?LWc81-&g+$8UJ(O_f{+jk<WOj)0
zl6_hca}P~Blh5cnb!Bgorw}IH8Ln!2m$Yovq4xQ3hkOBE#b;FUFF&)nJ)4`8hOfKS
z7V3FhqZ`D-ts1s!P~5vXGeek5=CP^JD0ZjDB6H8Q%$&{AyFD3D!3tLH^ouUF`8TB1
ztz{CrXF;j&1iJN-i!Lh>Id>_J`S+UXa#&Z`=_%^l`QHKE;=!xvvcgk*@Zp(X1<&qT
zhx~#9P<0mBC!^PxpH^f1EGgGQ2QD~ezdWsSG+bLQ!*6;b{LzF1F6Fr(O*qA%0zcx{
z#c@q#8~M|B%l&DX7p<E63q7LR-KIvG(pn8=D9A#y*8>(852gQ=buKG8MgQrgRaNJ@
zNlmk4$z13B@)YZFdL&|1q@^5@Q~z+W&+|x{6!+pAG44CW*R$6alS6LG=6t&!cK&bH
zhszLy&I-)v&FW~TtPs-w?5Y{EQGfM@3mAM!2j|l%NF@c*ABQ~eMG7+H@?*q6+ApUk
z0?YYU7XYq2HUq|MI!h%_TyUArf|cPnkLi=z_#FStmQMxmRoFk+QJa${N*dSn?Cf=L
z=^MUK`f>BNKp#5$6|Fsx0P#1zM;zQ!b>jOLO7nEXeI4dsztpp`V58wk*1#7-qnyjL
zH8K51P;*AdwZ<e$tvq(OWDJM+BJ66SMx<HBZ$elA*Z!behBX+RSIsC3q6KbE`?(x=
zEgl-$xWPL{g4Hz7RD1Y<@1@HNa6)gr@VQI!lEck^gHEKBs*J7;TdU56h=0vb+YMCd
zswVF?fgPM4bc;yU=7s2yq7)*ccU!N5x;AsoAZ48kjlXdp;1#+`uE)}nUi9`h;jEw-
zykK5)Bx1o(9Rf+V_#T@hF89=Ftq5nH1o7cMKcOgrxjVTreB)A4-b6R&byr3Qz*DFf
z-kaHJnvJ~Wy5^uqRQpW}N%vs~LG?3H3stA2E3t`?YpUl{vMif5?O>TwZ=d!&c6gI$
zHHu{od9ME0Y5ffZKHZ~C2ozgnB92cfB<o{q9X%lL!g3^7`0AUJtklM%nCH!jvY>k`
zR;j~37`AyNQOXu_&ErmqKjhJT%c&T2@nm4|@tU(fQ*x%BnJg>Hi7yk=w(Wp`SLToK
zWgoT#)L++yZTiVSm`CFK;i*}OPA?%3*X0E`dQ5y?q$O-*gRmoHlv-0Fv*-*ClkRZy
zcz&e@X{xXD>cZuO5H?7Ae{G(Tz3%g;H)<;H6Th_`jI^q}QVU9bcrdS|*-BB@E_*d>
zsJIQj4{Qo9OpLg(i`CO(f3w)5ya3kbNE|bH*zV}mvV1Y&D>qkyd);`}z2~lHmFrD|
z6|vP3(fN-%|BYmisZ5Z^6J)BrB_)#CgU#M5d_vkHs0rU!P3$F^n9f<vxO}Uh|3GCt
z1;oaDq}sEWhG&mdNUIvz@67PIoUTfii(p2Fr_A4eq&FGgHaTB8s(J@5TO9?clSooU
zq9WHyeVz>sM(<zvw|FGV!_rr*+~)p2k>d6qAocQ<!DEXUF-1uc_!_7&Y<}kQpGd2G
zFylYKq9p#<dAQZ)9_!x;Q!|m`a=ZGZ<Xk^4>Kge>R%yY0NOtxpllA6-5J<vo{XMJ$
z2pfd{Y$jQ*OL=CFl#~@iYrrudt9?CH&-zA9!SN<7=Ggwn<gSD=2#tQ{Mw?r0J#CqN
zw}|bCUmcuG>@N44w0fJb%mz<ZRfnS0Q|caKTW7LzJ@0=H`$b~N$VRTs)XR580>CnW
zA7#(4xY$X7Ox8aqcv(`4$&D<ypdFpT|E9(N#&B2JazOtwtI&8h7$CIV1KTNl4_z+=
z6=XI82OWRX9o4PNR70?j>>X^J_FWJ4dB~veSk%3%6}=I4EA(V%t~))syOm&_Ecvt!
z6#2d~iS=1K{}kq0&S=z?QIn-C%lWnM@sNCwVKB$*_6@BPh+ITYwDQm@Bku}&HROSk
zltX$1gA(BrG5~~SX51bu5E7=314VQh{8cUCDnoR#=wiEa@#|H$3Cs(PLn*Z{o`N6_
z%KNI`8GLAW6R-KrcIl+0F~!NEdZ_zvl%$y|Q+k=JzQ)S&X!xwKQ})x>)Ti=ErjqHE
zps4cWgdj|@k<10>J4eI0bSveM<Q<>tPG=ff{vp*DL39)2KD!D&^qp?I4nXHEklbEe
zHn6M+7z{WMgVq@tT`(}@e24SDQx~gfW=dFTM}m&ew_RFEuLd=LDgOIoV`u%lThR8D
zm@jT#XZt%3KGu-JM1{2VyjLKsr&hWK;L|-;rDom_=;_|U*t^_G#VU`*?=G_meQ#fX
zzPP0j*Ze(fQ6>9C?<xL^H}~i-)l%Fq^`8CSQ(EL-!TJ-r_9t1Bn3S?x5xYU$sJE=N
z0k@W<sXFej(}*7tFSj|-mFuqCxu~^2kgs{6#%lQN+pgNrv(>3yhufp~a4rV-L=A=b
z(4*NWW05yQ#mjo1y#`Iid)k}NvyNs)l*(LxWmew@bj8sZPSd^$hS6Jo7<^JnJViO&
zr}~;%yd&DtF@JT%0TZdQ!~Q(z)yVws=bS$W4tF;`NG^)2o$Y&SDg$?RYSHhvQ<OPB
z_Tg6u=%#g0uw<~#VFYXC{gIZ%2Bo9toO4+1sbK3K#_Zr3UMCQbGnNR;F0X@MKd8<f
znzU>z{M=*F*64b6J^Z<2uqtYQv2dqM_TKj?W**;yGcP%wu)kij`n;-|lh}5iD19@h
zTdyWhQ!KCFqHFv_Vny(<oS%L0P@iMy%{yl?PS0*AR{hy?wR7)m-Wv$7+a5=oWvv;f
z>dksb{+>teDZR%*2$yJJOx#hknIJQ71sH8rlct+b;@S)68Ea7CntTNzre)Jx$N=`+
z3=l9-A~g<$4ZsWz9%)Wj_0tw39BIArR7G%k8nhRic`vg_(%u@Vy|4LRaK$ktpz|<A
zCx@O_Vjh~4xie{fUh3`8Ehk7NNJi$x+DK!O9DD~gE3W`Gt3IG=Zyxr1ADI1tKiR7#
z({rFBDapC<oSf-tYX?FSlwT-hF@}kY!y;b{Hw&Ns6K8nLlg8_ynQVP1;eN0v`q40h
z8lBmrd&>cFu!dZ&`T9fGk&IdAsjydFlW2u%ZYlE=0Y&WzxW&W?*U;JgAmNwWadZ@J
zyJ&L-&BF?HzDg{uR$putUr!Nj&P0tXt>%1+85aeBah9cp%o-xdEY5O~^7+H)kxB2!
zHbp0koB2)!7YR?cA){d03Ru1lV1iMa^>n$iRV8H8er|K$2Fw6!NyL<Wgl9lyrvLh6
zag&<a%2O%<U?y1uWkGfUyG@dTPp9UU2$(&n`qR|j_=ssst1YL+^85daKT&)5NS_O`
z`W#wQ0N?DBoHKx2W6s-?9<q-KhbA5wbhp>>Uy7J`Y7O?TS%Ac4&WGP%VTCKuY(C&y
znWI1QNE~_Lc(;oqCR*c<8PIEKj7{;^zcP6dlX^#t<~6;P+Y!zAkgDafUt_TrU&pJ8
zNamO6BG-GQD$M%SHQTfTQ8BirGC)IP;ftVG9)J+;%U2(q?Z>4(*Hpgwcs1WQxu^`y
zg$d_A{~Fo68*mriaulbmH^=>agVzhPn%imw90y3l4O&2ye05dKHWoGDj)$1R-j+{Q
zo=nG7i!Z62_uyMY^|X(-`Xo!7d8<vXsJZWMo`=h3rw}JCO^%T=3K$0T&jL8x^LeX9
zTl=k$-J(GijkUQBJS%$RG<Ur^(OzYpy)&n-xvlZ}@S`nr(5G7U+Q72VsSuTPZ)b~&
zIfL8t8~MTXlR?s#RLq5H!buz?P}E3o%Yqs~7V{#8EKdKSZYlG`@m|=mA5pjWwKhI?
ze6Zkzs%S}hSQ8u<8`C|p1X_o@dK4F9l@YQq@_gjr=ZV|$?^T2=D)7luP2Vi$EzvAX
z`5Mu-@^1PVZadKtvLBS=w6Eq>;Jw8&C1D+-<X=J3GM7*zBe`zo#w~v5LEs02yR=##
zFX^jet|qnh(T~%ElPy-<=or8(<ZGfQ;KBuTeT(xGfPyGSsOBz)GYsP|z-dDBo4`xI
zW&#B0DlW6Au}CS<al%uGtl$kU&J^MVDgbtKxJ=P62N$cSES?h=cP#M6#HBNx73;b6
zb+p@od+%pNB!#|TBVdA5ygQ<IiEtABeP5PsCV_xT+dQLE`M!PCy+1bekz{?PdHoaI
zQ-nWWAz>$(F^{7K=Nf@I_DW#-pu9Mtzd^|By}V7RaK^g}Em)KHmWtM(deU|{)m+$g
z8I6`Rt2Pi-=cmVNNNBOyX#dbvI*Aq0tB>ks;LR5BpyOK<KYqVo2e6qVy0SC6kX}~<
z55F8;lJFBJyznC-wgE=tA}&o;P1-EOpk{1F1UkWsNP(^fYCBBY@!=m*?XQisCT@$o
zs@N_9-8t-{tp>@=7?>9HmnxgIZZ^sj{X@qlw3)(pNR<2c8ymMU2Y4|gro0zWTD~Rk
zEwY7ny0^G+XHT>=pG{k#h<*fAdt|e{tT1ryvs`bO+(4dS!Q>8pH3ZHSZ57G3s_>0q
zc$K<{5+Oa-SX&wPa`LiugxRc2|H`A1S7^33n$6ToMg~ksYK1m14t0eBrz#=JyeSed
zZ9pKeau045`MnqMfw=BS3cmVH1f=RIHS?`o`9gK1ar>L8|1cI_b?jFVtk7WmKA7gk
zpJ}sxvPiAFV-$dvXm<9KhpM*3Wl}BLdcjMuZQ_Op9~(8`n{8AYpMXXLRGP7a2_=oF
z*0g$tCmumu%fdVtnP^hd8ofw4BHCyc+GEN*`g;TqIY1aa!&6+JU^kC$->^6VUJj)&
z%a(2n+PB_7+h!cE14}>L)I=W*(2i^UC-<fSY$P}K2<IpL1RW$p9wCM7dK8`%d}B%?
zvFl+!-fO@q=(12=Mf89RWz7b+URKq4hI;%cx+q*H2?i`W=>B80e7lCi7uf<<VORFn
z$V?}3Rf81BE`W0j@M=I%iy7J;&V;nQs)~?9@g}h@kxuhQCTNRjAaomUGxi5o=AX}I
zFD7whX`2jUc5v7KCE54i{0#9_hEVD@V!`$v<=DSFfRB~MmGi}CU8Cx5vlD5e?k+Pc
z;mWc0Gy_>uz=CexL=zp#HzqT|P;FTn>l2yz8FtHSX$KIp{b07)69dC4loeq%Oe-AA
zihNoB$7$r6K6*{J5XfXs_;d1T##_UET7nVnx(&ImQE7$&nv+06g%q+_-h0St5#Onf
z;e;j`IHwUf&frl71WVUTzweZE8ChSZ0P#I==GZF=&QBv}qsjhT%d%uN=hJNtxw&aQ
z5^B2j?jdFA_V{K#OgWac`3^5<Qk}SgAWky8F(IZWBx&o;v@^T~G`}RxKGS_+xAdu-
zcUDAlMxj3zuCz+!Z9lgpFrZ0p8H;Ah2^yHoLOuyT?Gx9Et}5MIc?X~?U!b5-OST6^
zuMiAADB^CQ$Op(78#cUAeK#gb05DVGo2g_`!efQ@lX}%@B(&XeR2SJJkLuyjw0XmC
z^TsahKQMTiKVKr4XNpq3)$<>UVnu$+@ujFv;enHEHNa{fn?~YIk=>Qo(&_g|?0a!Q
zGL+{0QfW^dch5gyr1IQV?881Lu!IJ1M8Pp#25=j(z~MaX=F6X~C3b@^khAAhevg<z
zM0oR_&TN}-gIt7vQQ?|ivy1AxZCgsp8*i!N{InT%q?!58g!Tp2?w|VDJKYon!Z`_`
zChN&_x&Lh*D4O;NtKYLpXX;gR!DOY-Xh?CdC4Ea8y>Sl)eH7N}R_brFz1DNK(86Ub
zG(biE3hS(x$WQ3kZT(nwQ9fvK)hDUuUrVgZI&Ckxegkq8dw4X8Dch)T>dhxTV<*PJ
zYwpt1240Us(^k+*0;*f-20Efy+lgb?-XbC5I+Mks818Y#%O(^*93y2v$>v|Ikb{+j
zuIz`Fnw*T!9aK^F<&gxl+B|MY`xAF-m#p%R+=i&XILyHC1I*Yjmx@(lHE<OPgJMg^
zc%m>j&5{y#OC1v0bW~ZVZvB&=DG1(uGJc$~k_|r;t3RSGOA2e(%{7?e45Pgjh--0i
zbVuTS1?BZa?JZ#cjxz(YB8vbT!2peHCUkKU=wB55l(GTZWKH+@T=mKcY=n@7ml00O
z$I;ITS6HwE&D4oCVgH=5R99GoHuC#GmZ0@^S{<uE3n+Fki~ve_)4H$8#OzXWeJJ8b
zLDB$+r~6hte%uwwD860IN5s*gJhnEE(kwonhYsW(Y<Jsm*n#}wy_ZZ2{W>SLpI^sB
z5La0<>4<uRUqlvU%4<h&Y5`+RxuyQ#b=95AfJ2sv)hBH}K_=I!$LAVMAjkLP6a)=W
zjue@+g%J843PKtN2)!PHeZlopntq3rH>xR#xG@MYq4<{~0+I=-)GLig#42pk>Cq~@
zF=hpPtAhMz_DTXB5NLGx0<ySzKrIzfzu-(3Eg}g*6lVhPUb<|KtxU|pY64Sa-DJ@v
zI>5A{60stW4hRG0m}{_m1aPn9A~=7Zeu+4FDYg*GpCbcl?q$uc*Glt;Vo>AwE^OFW
z_t-*{sS{*d9Ji1D6owpUQgM80J09q^`D$}BodTd!>7wYBg3G3fJhUk5T8hfNZTrs~
zn**Y|AnU#7u8RJ`_nmzMbgUkK^MAgou-U%g_VSjx=ne~=OPU8ncjTrQfTTqiu6_kx
kkm!QC*ZY{W|G%04_h%D(n<JF?LbWsWdV2Eh|MoTi1>RvZ%>V!Z

literal 0
HcmV?d00001

diff --git a/assets/eip-5289/interfaces/IERC5289Library.sol b/assets/eip-5289/interfaces/IERC5289Library.sol
index 014d156da97099..6eb68b152beb9a 100644
--- a/assets/eip-5289/interfaces/IERC5289Library.sol
+++ b/assets/eip-5289/interfaces/IERC5289Library.sol
@@ -7,8 +7,8 @@ interface IERC5289Library is IERC165 {
     /// @notice Emitted when signDocument is called
     event DocumentSigned(address indexed signer, uint16 indexed documentId);
     
-    /// @notice The IPFS multihash of the legal document. This MUST use a common file format, such as PDF, HTML, TeX, or Markdown.
-    function legalDocument(uint16 documentId) external view returns (bytes memory);
+    /// @notice An immutable link to the legal document (RECOMMENDED to be hosted on IPFS). This MUST use a common file format, such as PDF, HTML, TeX, or Markdown.
+    function legalDocument(uint16 documentId) external view returns (string memory);
     
     /// @notice Returns whether or not the given user signed the document.
     function documentSigned(address user, uint16 documentId) external view returns (bool signed);
@@ -17,7 +17,7 @@ interface IERC5289Library is IERC165 {
     /// @dev If the user has not signed the document, the timestamp may be anything.
     function documentSignedAt(address user, uint16 documentId) external view returns (uint64 timestamp);
 
-    /// @notice Provide a signature
+    /// @notice Sign a document
     /// @dev This MUST be validated by the smart contract. This MUST emit DocumentSigned or throw.
-    function signDocument(address signer, uint16 documentId, bytes memory signature) external;
+    function signDocument(address signer, uint16 documentId) external;
 }

From e533e3920d4f155bfd96ae19384ade23b3f5eb63 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 20 Dec 2022 15:14:14 -0500
Subject: [PATCH 062/274] Update EIP-5507: Add Rationale stub (#6181)

---
 EIPS/eip-5507.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5507.md b/EIPS/eip-5507.md
index 06743c467e8797..aacca4f0a7ecad 100644
--- a/EIPS/eip-5507.md
+++ b/EIPS/eip-5507.md
@@ -143,7 +143,7 @@ interface IERC1155Refund is IERC1155, IERC165 {
 
 ## Rationale
 
-TODO
+`refundDeadlineOf` uses blocks instead of timestamps, as timestamps are less reliable than block numbers.
 
 ## Backwards Compatibility
 

From b6a0fc8bd8a474aaf0dbb4e82d062dba870bcf8e Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 20 Dec 2022 15:15:19 -0500
Subject: [PATCH 063/274] Update EIP-5219: Fix small typo (#6182)

---
 EIPS/eip-5219.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/EIPS/eip-5219.md b/EIPS/eip-5219.md
index fa1d8f14b7e097..47036c23a98267 100644
--- a/EIPS/eip-5219.md
+++ b/EIPS/eip-5219.md
@@ -49,6 +49,7 @@ The `request` method was chosen to be readonly because all data should be sent t
 - Other EIPs can be used to request state changing operations in conjunction with a `307 Temporary Redirect` status code.
 
 Instead of mimicking a full HTTP request, a highly slimmed version was chosen for the following reasons:
+
 - The only particularly relevant HTTP method is `GET`
 - Query parameters can be encoded in the resource.
 - Request headers are, for the most part, unnecessary for `GET` requests.

From 9a2340635de585fee046517aec091e489174ea6c Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 20 Dec 2022 15:35:19 -0500
Subject: [PATCH 064/274] Update EIP-5380: First update (#6184)

---
 EIPS/eip-5380.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/EIPS/eip-5380.md b/EIPS/eip-5380.md
index d86b7ada2b5c03..f4006789463342 100644
--- a/EIPS/eip-5380.md
+++ b/EIPS/eip-5380.md
@@ -13,7 +13,7 @@ requires: 165, 721
 
 ## Abstract
 
-This EIP proposes extensions of the commonly-used [EIP-721](./eip-721.md) standard that allows token owners to grant limited usage of those tokens to other addresses.
+This EIP proposes a new interface that allows [EIP-721](./eip-721.md) token owners to grant limited usage of those tokens to other addresses.
 
 ## Motivation
 
@@ -23,13 +23,13 @@ There are many scenarios in which it makes sense for the owner of a token to gra
 
 The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
 
-### `IERC5380`
+### Base
 
 ```solidity
 /// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.8.0;
 
-interface ERC5380 is ERC165 {
+interface ERC721Entitlement is ERC165 {
     /// @notice Emitted when the amount of entitlement a user has changes. If user is the zero address, then the user is the owner
     event EntitlementChanged(address indexed user, address indexed contract, uint256 indexed tokenId);
 
@@ -53,9 +53,9 @@ interface ERC5380 is ERC165 {
 }
 ```
 
-`supportsInterface` MUST return true when called with `IERC5380`'s interface ID.
+`supportsInterface` MUST return true when called with `ERC721Entitlement`'s interface ID.
 
-### `IERC5380Enumerable`
+### Enumerable
 
 This OPTIONAL interface is RECOMMENDED.
 
@@ -63,7 +63,7 @@ This OPTIONAL interface is RECOMMENDED.
 /// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.8.0;
 
-interface ERC5380Enumerable is ERC5380 /* , ERC165 */ {
+interface ERC721EntitlementEnumerable is ERC721Entitlement /* , ERC165 */ {
     /// @notice         Enumerate tokens assigned to a user
     /// @dev            Throws if the index is out of bounds or if user == address(0)
     /// @param  user    The user to query
@@ -72,11 +72,11 @@ interface ERC5380Enumerable is ERC5380 /* , ERC165 */ {
 }
 ```
 
-`supportsInterface` MUST return true when called with `IERC5380Enumerable`'s interface ID.
+`supportsInterface` MUST return true when called with `ERC721EntitlementEnumerable`'s interface ID.
 
 ## Rationale
 
-TODO.
+[EIP-20](./eip-20.md) and [EIP-1155](./eip-1155.md) are unsupported as partial ownership is much more complex to track than boolean ownership.
 
 ## Backwards Compatibility
 

From 047f16d7fd9f805f3177610161259aca90844dd3 Mon Sep 17 00:00:00 2001
From: Mikhail Kalinin <noblesse.knight@gmail.com>
Date: Wed, 21 Dec 2022 03:53:33 +0600
Subject: [PATCH 065/274] Add EIP-6110: Supply validator deposits on chain
 (#6110)

* EIP-6110: initial draft

* Fix header

* Fill out the discussions-to

* Make linter happy

* Fix color schema for python snippets

* Apply suggestions from code review

Co-authored-by: Danny Ryan <dannyjryan@gmail.com>

* Fix anchor

* Fix eip4881 link

* Fix eip4881 link once again

Co-authored-by: Danny Ryan <dannyjryan@gmail.com>
---
 EIPS/eip-6110.md | 192 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 192 insertions(+)
 create mode 100644 EIPS/eip-6110.md

diff --git a/EIPS/eip-6110.md b/EIPS/eip-6110.md
new file mode 100644
index 00000000000000..64dfa7a9302234
--- /dev/null
+++ b/EIPS/eip-6110.md
@@ -0,0 +1,192 @@
+---
+eip: 6110
+title: Supply validator deposits on chain
+description: Provides validator deposits as a list of deposit operations added to the Execution Layer block
+author: Mikhail Kalinin (@mkalinin), Danny Ryan (@djrtwo)
+discussions-to: https://ethereum-magicians.org/t/eip-6110-supply-validator-deposits-on-chain/12072
+status: Draft
+type: Standards Track
+category: Core
+created: 2022-12-09
+---
+
+## Abstract
+
+Appends validator deposits to the Execution Layer block structure. This shifts responsibliity of deposit inclusion and validation to the Execution Layer and removes the need for deposit (or `eth1data`) voting from the Consensus Layer.
+
+Validator deposits list supplied in a block is obtained by parsing deposit contract log events emitted by each deposit transaction included in a given block.
+
+## Motivation
+
+Validator deposits are a core component of the proof-of-stake consensus mechanism. This EIP allows for an in-protocol mechanism of deposit processing on the Consensus Layer and eliminates the proposer voting mechanism utilized currently. This proposed mechanism relaxes safety assumptions and reduces complexity of client software design, contributing to the security of the deposits flow. It also improves validator UX.
+
+Advantages of in-protocol deposit processing consist of but are not limit to the following:
+
+* Significant increase of deposits security by supplanting proposer voting. With the proposed in-protocol mechanism, an honest online node can't be convinced to process fake deposits even when more than 2/3 portion of stake is adversarial.
+* Decrease of delay between submitting deposit transaction on Execution Layer and its processing on Consensus Layer. That is, ~13 minutes with in-protocol deposit processing compared to ~12 hours with the existing mechanism.
+* Eliminate beacon block proposal dependency on JSON-RPC API data polling that suffers from failures caused by inconsistencies between JSON-RPC API implementations and dependency of API calls processing on the inner state (e.g. syncing) of client software.
+* Eliminate requirement to maintain and distribute deposit contract snapshots ([EIP-4881](./eip-4881.md)).
+* Reduction of design and engineering complexity of Consensus Layer client software on a component that has proven to be brittle.
+
+## Specification
+
+### Constants
+
+| Name | Value | Comment |
+| - | - | - |
+|`FORK_TIMESTAMP` | *TBD* | Mainnet |
+
+### Configuration
+
+| Name | Value | Comment |
+| - | - | - |
+|`DEPOSIT_CONTRACT_ADDRESS` | `0x00000000219ab540356cbb839cbe05303d7705fa` | Mainnet |
+
+`DEPOSIT_CONTRACT_ADDRESS` parameter **MUST** be included into client software binary distribution.
+
+### Definitions
+
+* **`FORK_BLOCK`** -- the first block in a blockchain with the `timestamp` greater or equal to `FORK_TIMESTAMP`.
+
+### Deposit
+
+The structure denoting the new deposit operation consists of the following fields:
+
+1. `pubkey: Bytes48`
+2. `withdrawal_credentials: Bytes32`
+3. `amount: uint64`
+4. `signature: Bytes96`
+5. `index: uint64`
+
+RLP encoding of deposit structure **MUST** be computed in the following way:
+
+```python
+rlp_encoded_deposit = RLP([
+    RLP(pubkey),
+    RLP(withdrawal_credentials),
+    RLP(amount),
+    RLP(signature),
+    RLP(index)
+])
+```
+
+### Block structure
+
+Beginning with the `FORK_BLOCK`, the block body **MUST** be appended with a list of deposit operations. RLP encoding of an extended block body structure **MUST** be computed as follows:
+
+```python
+block_body_rlp = RLP([
+    rlp_encoded_field_0,
+    ...,
+    # Latest block body field before `deposits`
+    rlp_encoded_field_n,
+    
+    RLP([rlp_encoded_deposit_0, ..., rlp_encoded_deposit_k])
+])
+```
+
+Beginning with the `FORK_BLOCK`, the block header **MUST** be appended with the new **`deposits_root`** field. The value of this field is the trie root committing to the list of deposits in the block body. **`deposits_root`** field value **MUST** be computed as follows:
+
+```python
+def compute_trie_root_from_indexed_data(data):
+    trie = Trie.from([(i, obj) for i, obj in enumerate(data)])
+    return trie.root
+
+block.header.deposits_root = compute_trie_root_from_indexed_data(block.body.deposits)
+```
+
+### Block validity
+
+Beginning with the `FORK_BLOCK`, client software **MUST** extend block validity rule set with the following conditions:
+
+1. Value of **`deposits_root`** block header field equals to the trie root committing to the list of deposit operations contained in the block. To illustrate:
+
+```python
+def compute_trie_root_from_indexed_data(data):
+    trie = Trie.from([(i, obj) for i, obj in enumerate(data)])
+    return trie.root
+
+assert block.header.deposits_root == compute_trie_root_from_indexed_data(block.body.deposits)
+```
+
+2. The list of deposit operations contained in the block **MUST** be equivalent to the list of log events emitted by each deposit transaction of the given block, respecting the order of transaction inclusion. To illustrate:
+
+```python
+def parse_deposit_data(deposit_event_data): bytes[]
+  """
+  Parses Deposit operation from DepositContract.DepositEvent data
+  """
+  pass
+
+def little_endian_to_uint64(data: bytes): uint64
+    return uint64(int.from_bytes(data, 'little'))
+
+class Deposit(object):
+    pubkey: Bytes48
+    withdrawal_credentials: Bytes32
+    amount: uint64
+    signature: Bytes96
+    index: uint64
+
+def event_data_to_deposit(deposit_event_data): Deposit
+  deposit_data = parse_deposit_data(deposit_event_data)
+  return Deposit(
+    pubkey=Bytes48(deposit_data[0]),
+    withdrawal_credentials=Bytes32(deposit_data[1]),
+    amount=little_endian_to_uint64(deposit_data[2]),
+    signature=Bytes96(deposit_data[3]),
+    index=little_endian_to_uint64(deposit_data[4])
+  )
+
+# Obtain receipts from block execution result
+receipts = block.execution_result.receipts
+
+# Retrieve all deposits made in the block
+expected_deposits = []
+for receipt in receipts:
+    for log in receipt.logs:
+        if log.address == DEPOSIT_CONTRACT_ADDRESS:
+            deposit = event_data_to_deposit(log.data)
+            expected_deposits.append(deposit)
+
+# Compare retrieved deposits to the list in the block body
+assert block.body.deposits == expected_deposits
+```
+
+A block that does not satisfy the above conditions **MUST** be deemed invalid.
+
+## Rationale
+
+### `index` field
+
+The `index` field may appear unnecessary but it is important information for deposit processing flow on the Consensus Layer.
+
+### Not limiting the size of deposit operations list
+
+The list is unbounded because of negligible data complexity and absence of potential DoS vectors. See [Security Considerations](#security-considerations) for more details.
+
+### Filtering events only by `DEPOSIT_CONTRACT_ADDRESS`
+
+Deposit contract does not emit any events except for `DepositEvent`, thus additional filtering is unnecessary.
+
+## Backwards Compatibility
+
+This EIP introduces backwards incompatible changes to the block structure and block validation rule set. But neither of these changes break anything related to user activity and experience.
+
+## Security Considerations
+
+### Data complexity
+
+At the time of writing this document, the total number of submitted deposits is 478,402 which is 88MB of deposit data. Assuming frequency of deposit transactions remains the same, historic chain data complexity induced by this EIP can be estimated as 50MB per year which is negligible in comparison to other historic data.
+
+After the beacon chain launch in December 2020, the biggest observed spike in a number of submitted deposits was on March 15, 2022. More than 6000 deposit transactions were submitted during 24 hours which on average is less than 1 deposit, or 192 bytes of data, per block.
+
+Considering the above, we conclude that data complexity introduced by this proposal is negligible.
+
+### DoS vectors
+
+With 1 ETH as a minimum deposit amount, the lowest cost of a byte of deposit data is 1 ETH/192 ~ 5,208,333 Gwei. This is several orders of magnitude higher than the cost of a byte of transaction's calldata, thus adding deposit operations to a block does not increase Execution Layer DoS attack surface.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 220fbe24eb7677ce77372ad946797e7ac695b72f Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 20 Dec 2022 20:02:31 -0500
Subject: [PATCH 066/274] Update EIP-5507: Fix typo (wei is a reserved name)
 (#6191)

---
 EIPS/eip-5507.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/EIPS/eip-5507.md b/EIPS/eip-5507.md
index aacca4f0a7ecad..e91fc9180836c7 100644
--- a/EIPS/eip-5507.md
+++ b/EIPS/eip-5507.md
@@ -51,8 +51,8 @@ interface IERC20Refund is ERC20, ERC165 {
     function refund(uint256 amount) external;
 
     /// @notice         Gets the refund price
-    /// @return wei     The amount of ether (in wei) that would be refunded for a single token unit (10**decimals smallest divisible units)
-    function refundOf() external view returns (uint256 wei);
+    /// @return _wei    The amount of ether (in wei) that would be refunded for a single token unit (10**decimals smallest divisible units)
+    function refundOf() external view returns (uint256 _wei);
  
     /// @notice         Gets the first block for which the refund is not active
     /// @return block   The block beyond which the token cannot be refunded
@@ -89,8 +89,8 @@ interface IERC721Refund is ERC721, ERC165 {
 
     /// @notice         Gets the refund price of the specific `tokenId`
     /// @param  tokenId The `tokenId` to query
-    /// @return wei     The amount of ether (in wei) that would be refunded
-    function refundOf(uint256 tokenId) external view returns (uint256 wei);
+    /// @return _wei    The amount of ether (in wei) that would be refunded
+    function refundOf(uint256 tokenId) external view returns (uint256 _wei);
  
     /// @notice         Gets the first block for which the refund is not active for a given `tokenId`
     /// @param  tokenId The `tokenId` to query
@@ -131,8 +131,8 @@ interface IERC1155Refund is IERC1155, IERC165 {
 
     /// @notice         Gets the refund price of the specific `tokenId`
     /// @param  tokenId The `tokenId` to query
-    /// @return wei     The amount of ether (in wei) that would be refunded for a single token
-    function refundOf(uint256 tokenId) external view returns (uint256 wei);
+    /// @return _wei    The amount of ether (in wei) that would be refunded for a single token
+    function refundOf(uint256 tokenId) external view returns (uint256 _wei);
 
     /// @notice         Gets the first block for which the refund is not active for a given `tokenId`
     /// @param  tokenId The `tokenId` to query

From f29a4248a93e1f89839023b790e20ad39b426aaf Mon Sep 17 00:00:00 2001
From: lightclient <14004106+lightclient@users.noreply.github.com>
Date: Wed, 21 Dec 2022 14:52:29 -0700
Subject: [PATCH 067/274] 3540,4570,5450: update EOF container format (#6156)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* 3540: update eof contain format

* 4750,5450: update for new 3540 changes, disallow unreachble code

* 4750,5450: remove ref impls for now

* appease our overlord, walidator

* Apply suggestions from code review

Co-authored-by: Andrei Maiboroda <andrei@ethereum.org>
Co-authored-by: Jochem Brouwer <jochembrouwer96@gmail.com>

* reword type section intro

Co-authored-by: Paweł Bylica <chfast@gmail.com>

* apply feedback from review

Co-authored-by: Paweł Bylica <chfast@gmail.com>

* 4750: do not cleanup stack after jumpf or retf

* remove rationale for stack cleanup

* Apply suggestions from code review

Co-authored-by: Paweł Bylica <chfast@gmail.com>

* 4750: remove jumpf for later definition

* fix stale comment

Co-authored-by: Danno Ferrin <danno.ferrin@swirldslabs.com>

* fix a couple typos and improve clarity

* appease link checker

* note terminating instruction requirement from 5450

* cap max_stack_height at 1023

* add padding to table

* fix padding

Co-authored-by: Andrei Maiboroda <andrei@ethereum.org>

* revert terminating instructions change to 3670

* fix rearranged sections

Co-authored-by: Andrei Maiboroda <andrei@ethereum.org>

* Apply suggestions from code review

Co-authored-by: Paweł Bylica <chfast@gmail.com>

Co-authored-by: Andrei Maiboroda <andrei@ethereum.org>
Co-authored-by: Jochem Brouwer <jochembrouwer96@gmail.com>
Co-authored-by: Paweł Bylica <chfast@gmail.com>
Co-authored-by: Danno Ferrin <danno.ferrin@swirldslabs.com>
---
 EIPS/eip-3540.md | 215 +++++++++++++---------------------------
 EIPS/eip-3670.md |   1 -
 EIPS/eip-4750.md | 251 ++++-------------------------------------------
 EIPS/eip-5450.md | 126 ++----------------------
 4 files changed, 95 insertions(+), 498 deletions(-)

diff --git a/EIPS/eip-3540.md b/EIPS/eip-3540.md
index 6ac7732035c7a1..05e40a0dd026bd 100644
--- a/EIPS/eip-3540.md
+++ b/EIPS/eip-3540.md
@@ -8,7 +8,7 @@ status: Review
 type: Standards Track
 category: Core
 created: 2021-03-16
-requires: 3541, 3860
+requires: 3541, 3860, 4750, 5450
 ---
 
 ## Abstract
@@ -52,6 +52,8 @@ The *initcode* is the code executed in the context of the *create* transaction,
 
 The opcode `0xEF` is currently an undefined instruction, therefore: *It pops no stack items and pushes no stack items, and it causes an exceptional abort when executed.* This means *initcode* or already deployed *code* starting with this instruction will continue to abort execution.
 
+Unless otherwised specified, all integers are encoded in big-endian byte order.
+
 ### Code validation
 
 We introduce *code validation* for new contract creation. To achieve this, we define a format called EVM Object Format (EOF), containing a version indicator, and a ruleset of validity tied to a given version.
@@ -79,43 +81,76 @@ The container starts with the EOF header:
 | magic       | 2-bytes  | 0xEF00     |                    |
 | version     | 1-byte   | 0x01–0xFF  | EOF version number |
 
-The EOF header is followed by at least one section header. Each section header contains two fields, `section_kind` and `section_size`.
+The EOF header is followed by at least one section header. Each section header contains two fields, `section_kind` and either `section_size` or `section_size_list`, depending on the kind. `section_size_list` is a list of size values when multiple sections of this kind are allowed.
 
-| description  | length  | value         |                                                 |
-|--------------|---------|---------------|-------------------------------------------------|
-| section_kind | 1-byte  | 0x01–0xFF     | Encoded as a 8-bit unsigned number.             |
-| section_size | 2-bytes | 0x0001–0xFFFF | Encoded as a 16-bit unsigned big-endian number. |
+| description       | length  | value         |                   |
+|-------------------|---------|---------------|-------------------|
+| section_kind      | 1-byte  | 0x01–0xFF     | `uint8`           |
+| section_size      | 2-bytes | 0x0001–0xFFFF | `uint16`          |
+| section_size_list | dynamic | n/a           | `uint16, uint16+` |
 
-The list of section headers is terminated with the *section headers terminator byte* `0x00`.
+The list of section headers is terminated with the *section headers terminator byte* `0x00`. The body content follows immediately after.
 
 #### Container validation rules
 
-1. `version` MUST NOT be `0`.[^1](#EOF-version-range-start-with-1)
+1. `version` MUST NOT be `0`.[^1](#eof-version-range-start-with-1)
 2. `section_kind` MUST NOT be `0`. The value `0` is reserved for *section headers terminator byte*.
-3. `section_size` MUST NOT be `0`. If a section is empty its section header MUST be omitted.
-4. There MUST be at least one section (and therefore section header).
-5. Section data size MUST be equal to `section_size` declared in its header.
-6. Stray bytes outside of sections MUST NOT be present. This includes trailing bytes after the last section.
+3. There MUST be at least one section (and therefore section header).
+4. Section content size MUST be equal to size declared in its header.
+5. Stray bytes outside of sections MUST NOT be present. This includes trailing bytes after the last section.
 
 ### EOF version 1
 
-#### Section kinds
+EOF version 1 is made up of 5 EIPs, including this one: [EIP-3540](./eip-3540.md), [EIP-3670](./eip-3670.md), [EIP-4200](./eip-4200.md), [EIP-4750](./eip-4750.md), and [EIP-5450](./eip-5450.md). Some values in this specification are only discussed briefly. To understand the full scope of EOF, it is necessary to review each EIP in-depth.
+
+#### Container
+
+The EOF version 1 container consists of a `header` and `body`.
+
+```
+container  := header, body
+header := magic, version, kind_type, type_size, kind_code, num_code_sections, code_size+, kind_data, data_size, terminator
+body := type_section, code_section+, data_section
+type_section := (inputs, outputs, max_stack_height)+
+```
+
+*note: `,` is a concatenation operator and `+` should be interpreted as "one or more" of the preceding item*
+
+##### Header
 
-The section kinds for EOF version 1 are defined as follows. The list may be extended in future versions.
+| name              | length   | value         | description                                                                        |
+|-------------------|----------|---------------|------------------------------------------------------------------------------------|
+| magic             | 2 bytes  | 0xEF00        | EOF prefix                                                                         |
+| version           | 1 byte   | 0x01          | EOF version                                                                        |
+| kind_type         | 1 byte   | 0x01          | kind marker for EIP-4750 type section header                                       |
+| type_size         | 2 bytes  | 0x0003-0xFFFF | uint16 denoting the length of the type section content                             |
+| kind_code         | 1 byte   | 0x02          | kind marker for code size section                                                  |
+| num_code_sections | 2 bytes  | 0x0001-0xFFFF | uint16 denoting the number of the code sections                                    |
+| code_size         | 2 bytes  | 0x0001-0xFFFF | uint16 denoting the length of the code section content                             |
+| kind_data         | 1 byte   | 0x03          | kind marker for data size section                                                  |
+| data_size         | 2 bytes  | 0x0000-0xFFFF | uint16 integer denoting the length of the data section content                     |
+| terminator        | 1 byte   | 0x00          | marks the end of the header                                                        |
 
-| section_kind | meaning                                        |
-|--------------|------------------------------------------------|
-| 0            | *reserved for section headers terminator byte* |
-| 1            | code                                           |
-| 2            | data                                           |
+##### Body
+
+| name             | length   | value        | description |
+|------------------|----------|--------------|-------------|
+| type_section     | variable | n/a          | stores EIP-4750 and EIP-5450 code section metadata  |
+| inputs           | 1 byte   | 0x00-0x7F    | number of stack elements the code section consumes  |
+| outputs          | 1 byte   | 0x00-0x7F    | number of stack elements the code section returns   |
+| max_stack_height | 2 bytes  | 0x0000-0x3FF | max height of data stack during execution           |
+| code_section     | variable | n/a          | arbitrary bytecode                                  |
+| data_section     | variable | n/a          | arbitrary sequence of bytes                         |
+
+See [EIP-4750](./eip-4750.md) for more information on the type section content.
 
 #### EOF version 1 validation rules
 
 1. In addition to general validation rules above, EOF version 1 bytecode conforms to the rules specified below:
-   - Exactly one code section MUST be present.
-   - The code section MUST be the first section.
-   - A single data section MAY follow the code section.
-2. Any other version is invalid.
+   - Exactly one type section header MUST be present immediately following the EOF version. Each code section MUST have a specified type signature in the type body.
+   - Exactly one code section header MUST be present immediately following the type section. A maxmimum of 1024 individual code sections are allowed.
+   - Exactly one data section header MUST be present immediately following the code section.
+2. Any version other than `0x01` is invalid.
 
 (*Remark:* Contract creation code SHOULD set the section size of the data section so that the constructor arguments fit it.)
 
@@ -123,14 +158,14 @@ The section kinds for EOF version 1 are defined as follows. The list may be exte
 
 For clarity, the *container* refers to the complete account code, while *code* refers to the contents of the code section only.
 
-1. `JUMPDEST`-analysis is only run on the *code*.
-2. Execution starts at the first byte of the *code*, and `PC` is set to 0.
-3. Execution stops if `PC` goes outside the code section bounds.
-4. `PC` returns the current position within the *code*.
-5. `JUMP`/`JUMPI` uses an absolute offset within the *code*.
-6. `CODECOPY`/`CODESIZE`/`EXTCODECOPY`/`EXTCODESIZE`/`EXTCODEHASH` keeps operating on the entire *container*.
-7. The input to `CREATE`/`CREATE2` is still the entire *container*.
-8. The size limit for deployed code as specified in [EIP-170](./eip-170.md) and for init code as specified in [EIP-3860](./eip-3860.md) is applied to the entire *container* size, not to the *code* size.
+1. Execution starts at the first byte of the first code section, and PC is set to 0.
+2. Execution stops if `PC` goes outside the code section bounds.
+3. `PC` returns the current position within the *code*.
+4. `CODECOPY`/`CODESIZE`/`EXTCODECOPY`/`EXTCODESIZE`/`EXTCODEHASH` keeps operating on the entire *container*.
+5. The input to `CREATE`/`CREATE2` is still the entire *container*.
+6. The size limit for deployed code as specified in [EIP-170](./eip-170.md) and for init code as specified in [EIP-3860](./eip-3860.md) is applied to the entire *container* size, not to the *code* size.
+
+(*Remark:* Due to [EIP-4750](./eip-4750.md), `JUMP` and `JUMPI` are disabled and therefore are not discussed in relation to EOF.)
 
 ### Changes to contract creation semantics
 
@@ -198,7 +233,7 @@ Also, implementations may use APIs where 0 version number denotes legacy code.
 We have considered different questions for the sections:
 
 - Streaming headers (i.e. `section_header, section_data, section_header, section_data, ...`) are used in some other formats (such as WebAssembly). They are handy for formats which are subject to editing (adding/removing sections). That is not a useful feature for EVM. One minor benefit applicable to our case is that they do not require a specific "header terminator". On the other hand they seem to play worse with code chunking / merkleization, as it is better to have all section headers in a single chunk.
-- Whether to have a header terminator or to encode `number_of_sections` or `total_size_of_headers`. Both raise the question of how large of a value these fields should be able to hold. While today there will be only two sections, in case each "EVM function" would become a separate code section, a fixed 8-bit field may not be big enough. A terminator byte seems to avoid these problems.
+- Whether to have a header terminator or to encode `number_of_sections` or `total_size_of_headers`. Both raise the question of how large of a value these fields should be able to hold. A terminator byte seems to avoid the problem of choosing a size which is too small without any perceptible downside, so it is the path taken.
 - Whether to encode `section_size` as a fixed 16-bit value or some kind of variable length field (e.g. LEB128). We have opted for fixed size, because it simplifies client implementations, and 16-bit seems enough, because of the currently exposed code size limit of 24576 bytes (see [EIP-170](./eip-170.md) and [EIP-3860](./eip-3860.md)). Should this be limiting in the future, a new EOF version could change the format. Besides simplifying client implementations, not using LEB128 also greatly simplifies on-chain parsing.
 
 ### Data-only contracts
@@ -209,9 +244,11 @@ The EOF prevents deploying contracts with arbitrary bytes (data-only contracts:
 EF0001 010001 02<data-size> 00 FE <data>
 ```
 
+It is possible in the future that this data will be accessible with data-specific opcodes, such as `DATACOPY` or `EXTDATACOPY`. Until then, callers will need to determine the data offset manually.
+
 ### PC starts with 0 at the code section
 
-The values for `PC` and `JUMP`/`JUMPI` start with 0 and are within the *code* section. We considered keeping `PC`/`JUMP`/`JUMPI` values to operate on the whole *container* and be consistent with `CODECOPY`/`EXTCODECOPY` but in the end decided otherwise. It looks to be much easier to propose EOF extensions that affect jumps and jumpdests when `JUMP`/`JUMPI` already operates on indexes within *code* section only. This also feels more natural and easier to implement in EVM: the new EOF EVM should only care about traversing *code* and accessing other parts of the *container* only on special occasions (e.g. in `CODECOPY` instruction).
+The value for `PC` is specified to start at 0 and to be within the active *code* section. We considered keeping `PC` to operate on the whole *container* and be consistent with `CODECOPY`/`EXTCODECOPY` but in the end decided otherwise. This also feels more natural and easier to implement in EVM: the new EOF EVM should only care about traversing *code* and accessing other parts of the *container* only on special occasions (e.g. in `CODECOPY` instruction).
 
 ## Backwards Compatibility
 
@@ -221,49 +258,6 @@ The choice of `MAGIC` guarantees that none of the contracts existing on the chai
 
 ## Test Cases
 
-### EOF validation
-
-#### Valid cases
-
-- Code section without data section
-- Code section with data section
-
-#### Invalid cases
-
-| Bytecode                                           | Validation error                                 |
-|----------------------------------------------------|--------------------------------------------------|
-| `EF`                                               | Incomplete magic                                 |
-| `EFFF0101000302000400600000AABBCCDD`               | Invalid magic                                    |
-| `EF00`                                             | No version                                       |
-| `EF000001000302000400600000AABBCCDD`               | Invalid version                                  |
-| `EF000201000302000400600000AABBCCDD`               | Invalid version                                  |
-| `EF00FF01000302000400600000AABBCCDD`               | Invalid version                                  |
-| `EF0001`                                           | No header                                        |
-| `EF000100`                                         | No code section                                  |
-| `EF000101`                                         | No code section size                             |
-| `EF00010100`                                       | Code section size incomplete                     |
-| `EF0001010003`                                     | No section terminator                            |
-| `EF0001010003600000`                               | No section terminator                            |
-| `EF000101000200`                                   | No code section contents                         |
-| `EF00010100020060`                                 | Code section contents incomplete                 |
-| `EF000101000300600000DEADBEEF`                     | Trailing bytes after code section                |
-| `EF000101000301000300600000600000`                 | Multiple code sections                           |
-| `EF000101000000`                                   | Empty code section                               |
-| `EF000101000002000200AABB`                         | Empty code section (with non-empty data section) |
-| `EF000102000401000300AABBCCDD600000`               | Data section preceding code section              |
-| `EF000102000400AABBCCDD`                           | Data section without code section                |
-| `EF000101000202`                                   | No data section size                             |
-| `EF00010100020200`                                 | Data section size incomplete                     |
-| `EF0001010003020004`                               | No section terminator                            |
-| `EF0001010003020004600000AABBCCDD`                 | No section terminator                            |
-| `EF000101000302000400600000`                       | No data section contents                         |
-| `EF000101000302000400600000AABBCC`                 | Data section contents incomplete                 |
-| `EF000101000302000400600000AABBCCDDEE`             | Trailing bytes after data section                |
-| `EF000101000302000402000400600000AABBCCDDAABBCCDD` | Multiple data sections                           |
-| `EF000101000101000102000102000100FEFEAABB`         | Multiple code and data sections                  |
-| `EF000101000302000000600000`                       | Empty data section                               |
-| `EF0001010002030004006000AABBCCDD`                 | Unknown section (id = 3)                         |
-
 ### Contract creation
 
 All cases should be checked for creation transaction, `CREATE` and `CREATE2`.
@@ -282,8 +276,6 @@ All cases should be checked for creation transaction, `CREATE` and `CREATE2`.
 
 ### Contract execution
 
-- Valid EOF code containing `JUMP`/`JUMPI` - offsets relative to code section start are used
-- `JUMP`/`JUMPI` to `5B` (`JUMPDEST`) byte outside of code section - exceptional abort
 - EOF code containing `PC` opcode - offset inside code section is returned
 - EOF code containing `CODECOPY/CODESIZE` - works as in legacy code
   - `CODESIZE` returns the size of entire container
@@ -300,73 +292,6 @@ All cases should be checked for creation transaction, `CREATE` and `CREATE2`.
   - `EXTCODECOPY` can copy entire target container
   - Results don't differ when executed inside legacy or EOF contract
 
-## Reference Implementation
-
-```python
-MAGIC = b'\xEF\x00'
-VERSION = 0x01
-S_TERMINATOR = 0x00
-S_CODE = 0x01
-S_DATA = 0x02
-
-
-# Determines if code is in EOF format of any version.
-def is_eof(code: bytes) -> bool:
-    return code.startswith(MAGIC)
-
-class ValidationException(Exception):
-    pass
-
-# Raises ValidationException on invalid code
-def validate_eof(code: bytes):
-    # Check version
-    if len(code) < 3 or code[2] != VERSION:
-        raise ValidationException("invalid version")
-
-    # Process section headers
-    section_sizes = {S_CODE: 0, S_DATA: 0}
-    pos = 3
-    while True:
-        # Terminator not found
-        if pos >= len(code):
-            raise ValidationException("no section terminator")            
-        
-        section_id = code[pos]
-        pos += 1
-        if section_id == S_TERMINATOR:
-            break
-
-        # Disallow unknown sections
-        if not section_id in section_sizes:
-            raise ValidationException("invalid section id")
-
-        # Data section preceding code section
-        if section_id == S_DATA and section_sizes[S_CODE] == 0:
-            raise ValidationException("data section preceding code section")
-
-        # Multiple sections with the same id
-        if section_sizes[section_id] != 0:
-            raise ValidationException("multiple sections with same id")
-
-        # Truncated section size
-        if (pos + 1) >= len(code):
-            raise ValidationException("truncated section size")
-        section_sizes[section_id] = (code[pos] << 8) | code[pos + 1]
-        pos += 2
-
-        # Empty section
-        if section_sizes[section_id] == 0:
-            raise ValidationException("empty section")
-
-    # Code section cannot be absent
-    if section_sizes[S_CODE] == 0:
-        raise ValidationException("no code section")
-
-    # The entire container must be scanned
-    if len(code) != (pos + section_sizes[S_CODE] + section_sizes[S_DATA]):
-        raise ValidationException("container size not equal to sum of section sizes")
-```
-
 ## Security Considerations
 
 With the anticipated EOF extensions, the validation is expected to have linear computational and space complexity.
diff --git a/EIPS/eip-3670.md b/EIPS/eip-3670.md
index 5ef9b52f780d6e..469450dc38183a 100644
--- a/EIPS/eip-3670.md
+++ b/EIPS/eip-3670.md
@@ -45,7 +45,6 @@ The EOF1 format provides following forward compatibility properties:
 This feature is introduced on the very same block EIP-3540 is enabled, therefore every EOF1-compatible bytecode MUST be validated according to these rules.
 
 1. Previously deprecated instructions `CALLCODE` (0xf2) and `SELFDESTRUCT` (0xff) are invalid and their opcodes are undefined.
-
 2. At contract creation time *instructions validation* is performed on both *initcode* and *code*. The code is invalid if any of the checks below fails. For each instruction:
    1. Check if the opcode is defined. The `INVALID` (0xfe) is considered defined.
    2. Check if all instructions' immediate bytes are present in the code (code does not end in the middle of instruction).
diff --git a/EIPS/eip-4750.md b/EIPS/eip-4750.md
index 9cca0550a75133..4d63a37e045b16 100644
--- a/EIPS/eip-4750.md
+++ b/EIPS/eip-4750.md
@@ -1,19 +1,19 @@
 ---
 eip: 4750
 title: EOF - Functions
-description: Individual sections for functions with `CALLF`, `JUMPF` and `RETF` instructions
+description: Individual sections for functions with `CALLF` and `RETF` instructions
 author: Andrei Maiboroda (@gumb0), Alex Beregszaszi (@axic), Paweł Bylica (@chfast)
 discussions-to: https://ethereum-magicians.org/t/eip-4750-eof-functions/8195
 status: Review
 type: Standards Track
 category: Core
 created: 2022-01-10
-requires: 3540, 3670
+requires: 3540, 3670, 5450
 ---
 
 ## Abstract
 
-Introduce the ability to have several code sections in EOF-formatted ([EIP-3540](./eip-3540.md)) bytecode, each one representing a separate subroutine/function. Two new opcodes,`CALLF` and `RETF`, are introduced to call and return from such a function. Additionally `JUMPF` instruction is introduced to perform a jump to a function. Dynamic jump instructions are disallowed.
+Introduce the ability to have several code sections in EOF-formatted ([EIP-3540](./eip-3540.md)) bytecode, each one representing a separate subroutine/function. Two new opcodes,`CALLF` and `RETF`, are introduced to call and return from such a function. Dynamic jump instructions are disallowed.
 
 ## Motivation
 
@@ -27,28 +27,15 @@ Furthermore, it aims to improve analysis opportunities by encoding the number of
 
 ## Specification
 
-### EOF container changes
+### Type Section
 
-1. The requirement of [EIP-3540](./eip-3540.md) "Exactly one code section MUST be present." is relaxed to "At least one code section MUST be present.", i.e. multiple code sections (`kind = 1`) are allowed.
-2. Total number of code sections MUST NOT exceed 1024.
-3. All code sections MUST precede a data section, if data section is present.
-4. New section with `kind = 3` is introduced called the *type section*.
-5. Exactly one type section MAY be present.
-6. The type section, if present, MUST directly precede all code sections.
-7. The type section, if present, contains a sequence of pairs of bytes: first byte in a pair encodes number of inputs, and second byte encodes number of outputs of the code section with the same index. *Note:* This implies that there is a limit of 256 stack for the input and in the output.
-8. Therefore, type section size MUST be `n * 2` bytes, where `n` is the number of code sections.
-9. First code section MUST have 0 inputs and 0 outputs.
-10. Type section MAY be omitted if only a single code.
-section is present. In that case it implicitly defines 0 inputs and 0 outputs for this code section.
+The type section of EOF containers must adhere to following requirements:
 
-To summarize, a well-formed EOF bytecode will have the following format:
+1. The section is comprised of a list of metadata where the metadata index in the type section corresponds to a code section index. Therefore, the type section size MUST be `n * 4` bytes, where `n` is the number of code sections.
+2. Each metadata item has 3 attributes: a uint8 `inputs`, a uint8 `outputs`, and a uint16 `max_stack_height`. *Note:* This implies that there is a limit of 255 stack for the input and in the output. This is further restricted to 127 stack items, because the upper bit of both the input and output bytes are reserved for future use. `max_stack_height` is further defined in [EIP-5450](./eip-5450.md).
+3. The first code section MUST have 0 inputs and 0 outputs.
 
-```
-bytecode := magic, version, [type_section_header], (code_section_header)+, [data_section_header], 0, [type_section_contents], (code_section_contents)+, [data_section_contents]
-
-type_section_header := 3, number_of_code_sections * 2 # section kind and size
-type_section_contents := 0, 0, code_section_1_inputs, code_section_1_outputs, code_section_2_inputs, code_section_2_outputs, ..., code_section_n_inputs, code_section_n_outputs
-```
+Refer to [EIP-3540](./eip-3540.md) to see the full structure of a well-formed EOF bytecode.
 
 ### New execution state in EVM
 
@@ -66,15 +53,14 @@ We introduce three new instructions:
 
 1. `CALLF` (`0xb0`) - call a function
 2. `RETF` (`0xb1`) - return from a function
-3. `JUMPF` (`0xb2`) - jump to a function (without updating return stack)
 
 If the code is legacy bytecode, any of these instructions results in an *exceptional halt*. (*Note: This means no change to behaviour.*)
 
 First we define several helper values:
 
 - `caller_stack_height = return_stack.top().stack_height` - stack height value saved in the top item of return stack
-- `type[i].inputs = type_section_contents[i * 2]` - number of inputs of ith section
-- `type[i].outputs = type_section_contents[i * 2 + 1]` - number of outputs of ith section
+- `type[i].inputs = type_section_contents[i * 4]` - number of inputs of ith section
+- `type[i].outputs = type_section_contents[i * 4 + 1]` - number of outputs of ith section
 
 If the code is valid EOF1, the following execution rules apply:
 
@@ -96,26 +82,14 @@ If the code is valid EOF1, the following execution rules apply:
    
    Under `PC_post_instruction` we mean the PC position after the entire immediate argument of `CALLF`. Data stack height is saved as it was before function inputs were pushed.
    
-   *Note:* Code validation rules of [EIP-3670](./eip-3670.md) guarantee there is always an instruction following `CALLF` (since terminating instruction is required to be final one in the section), therefore `PC_post_instruction` always points to an instruction inside section bounds.
-   
+   *Note:* Code validation rules of [EIP-5450](./eip-5450.md) guarantee there is always an instruction following `CALLF` (since terminating instruction or unconditional jump is required to be final one in the section), therefore `PC_post_instruction` always points to an instruction inside section bounds.
 8. Sets `current_section_index` to `code_section_index` and `PC` to `0`, and execution continues in the called section.
 
-#### `JUMPF`
-
-1. Has one immediate argument,`code_section_index`, encoded as a 16-bit unsigned big-endian value.
-2. If data stack has less than `caller_stack_height + type[code_section_index].inputs` items, execution results in exceptional halt.
-3. If data stack has more than `caller_stack_height + type[code_section_index].inputs` items, discards the items between `caller_stack_height` and top `type[code_section_index].inputs` items, so that there are exactly `caller_stack_height +  type[code_section_index].inputs` items left.
-4. Charges 4 gas.
-5. Pops nothing and pushes nothing to data stack.
-6. Pushes nothing to return stack.
-7. Sets `current_section_index` to `code_section_index` and `PC` to `0`, and execution continues in the called section.
-
 #### `RETF`
 
 1. Does not have immediate arguments.
-2. If data stack has less than `caller_stack_height + type[code_section_index].outputs` items, execution results in exceptional halt.
-3. If data stack has more than `caller_stack_height + type[code_section_index].outputs` items, discards the items between `caller_stack_height` and top `type[code_section_index].outputs` items, so that there are exactly `caller_stack_height +  type[code_section_index].outputs` items left.
-4. Charges 4 gas.
+2. If data stack does not equal `caller_stack_height + type[current_section_index].outputs` items, execution results in exceptional halt.
+4. Charges 3 gas.
 5. Pops nothing and pushes nothing to data stack.
 6. Pops an item from return stack and sets `current_section_index` and `PC` to values from this item.
    1. If return stack is empty after this, execution halts with success.
@@ -125,11 +99,10 @@ If the code is valid EOF1, the following execution rules apply:
 In addition to container format validation rules above, we extend code section validation rules (as defined in [EIP-3670](./eip-3670.md)).
 
 1. Code validation rules of EIP-3670 are applied to every code section.
-2. Code section is invalid in case an immediate argument of any `CALLF` or `JUMPF` is greater than or equal to the total number of code sections.
-3. Code section is invalid in case an immediate argument of any `JUMPF` is such that `type[callee_section_index].outputs != type[caller_section_index].outputs`, i.e. it is allowed to only jump to functions with the same output type.
-4. `RJUMP`, `RJUMPI` and `RJUMPV` immediate argument value (jump destination relative offset) validation:
+2. Code section is invalid in case an immediate argument of any `CALLF` is greater than or equal to the total number of code sections.
+3. `RJUMP`, `RJUMPI` and `RJUMPV` immediate argument value (jump destination relative offset) validation:
     1. Code section is invalid in case offset points to a position outside of section bounds.
-    2. Code section is invalid in case offset points to one of two bytes directly following `CALLF` or `JUMPF` instruction.
+    2. Code section is invalid in case offset points to one of two bytes directly following `CALLF` instruction.
 
 ### Disallowed instructions
 
@@ -166,202 +139,12 @@ Instead of deprecating `JUMPDEST` we repurpose it as `NOP` instruction, because
 
 The purpose of `JUMPDEST` analysis was to find in code the valid `JUMPDEST` bytes that do not happen to be inside `PUSH` immediate data. Only dynamic jump instructions (`JUMP`, `JUMPI`) required destination to be `JUMPDEST` instruction. Relative static jumps (`RJUMP` and `RJUMPI`) do not have this requirement and are validated once at deploy-time EOF instruction validation. Therefore, without dynamic jump instructions, `JUMPDEST` analysis is not required.
 
-### `JUMPF` instruction cleaning the stack
-
-In case function pushes on the stack more items than inputs required by the jumped-to function, these extra items could be accessed by the jumped-to function, because the underflow check is defined in terms of `caller_stack_height`, which does not change after `JUMPF`:
-
-> 3. If any instruction would access a data stack item below `caller_stack_height`, execution results in exceptional halt.
-
-In other words the entire stack frame of the function executing `JUMPF` is accessible to the jumped-to function.
-
-We believe this introduces unwanted edge-case behaviour with underflow exception depending on how the function was called or jumped-to, and require `JUMPF` to discard extra items to prevent this.
-
-### `RETF` instruction cleaning the stack
-
-The stack for the return items for `RETF` is automatically cleaned up. This could be relaxed and the onus could be put onto the user to clean it up, because the stack height difference can be clearly calculated, both when a function is entered via `CALLF` or `JUMPF`.
-
-However, we hope to relax the clean up requirement for `JUMPF`, and that would mean it is not possible anymore for the user to cleanup for `RETF`, because the height could be different depending on the path a function is entered.
-
 ## Backwards Compatibility
 
 This change poses no risk to backwards compatibility, as it is introduced only for EOF1 contracts, for which deploying undefined instructions is not allowed, therefore there are no existing contracts using these instructions. The new instructions are not introduced for legacy bytecode (code which is not EOF formatted).
 
 The new execution state and multi-section control flow pose no risk to backwards compatibility, because it is a generalization of executing a single code section. Executing existing contracts (both legacy and EOF1) has no user-observable changes.
 
-## Reference Implementation
-
-```python
-MAGIC = b'\xEF\x00'
-VERSION = 0x01
-S_TERMINATOR = 0x00
-S_CODE = 0x01
-S_DATA = 0x02
-S_TYPE = 0x03
-
-# The ranges below are as specified in the Yellow Paper.
-# Note: range(s, e) excludes e, hence the +1
-valid_opcodes = [
-    *range(0x00, 0x0b + 1),
-    *range(0x10, 0x1d + 1),
-    0x20,
-    *range(0x30, 0x3f + 1),
-    *range(0x40, 0x48 + 1),
-    *range(0x50, 0x55 + 1), *range(0x58, 0x5d + 1),
-    *range(0x60, 0x6f + 1),
-    *range(0x70, 0x7f + 1),
-    *range(0x80, 0x8f + 1),
-    *range(0x90, 0x9f + 1),
-    *range(0xa0, 0xa4 + 1),
-    0xb0, 0xb1, 0xb2,
-    # Note: 0xfe is considered assigned.
-    0xf0, 0xf1, 0xf3, 0xf4, 0xf5, 0xfa, 0xfd, 0xfe
-]
-
-# STOP, RETF, JUMPF, RETURN, REVERT, INVALID
-terminating_opcodes = [0x00, 0xb1, 0xb2, 0xf3, 0xfd, 0xfe]
-
-immediate_sizes = 256 * [0]
-immediate_sizes[0x5c] = 2  # RJUMP
-immediate_sizes[0x5d] = 2  # RJUMPI
-immediate_sizes[0xb0] = 2  # CALLF
-immediate_sizes[0xb2] = 2  # JUMPF
-for opcode in range(0x60, 0x7f + 1):  # PUSH1..PUSH32
-    immediate_sizes[opcode] = opcode - 0x60 + 1
-
-# Validate EOF code.
-# Raises ValidationException on invalid code
-def validate_eof(code: bytes):
-    # Check version
-    if len(code) < 3 or code[2] != VERSION:
-        raise ValidationException("invalid version")
-
-    # Process section headers
-    section_sizes = {S_TYPE: [], S_CODE: [], S_DATA: []}
-    pos = 3
-    while True:
-        # Terminator not found
-        if pos >= len(code):
-            raise ValidationException("no section terminator")
-
-        section_id = code[pos]
-        pos += 1
-        if section_id == S_TERMINATOR:
-            break
-
-        # Disallow unknown sections
-        if not section_id in section_sizes:
-            raise ValidationException("invalid section id")
-
-        # Data section preceding code section (i.e. code section following data section)
-        if section_id == S_CODE and len(section_sizes[S_DATA]) != 0:
-            raise ValidationException("data section preceding code section")
-
-        # Code section or data section preceding type section
-        if section_id == S_TYPE and (len(section_sizes[S_CODE]) != 0 or len(section_sizes[S_DATA]) != 0):
-            raise ValidationException("code or data section preceding type section")
-
-        # Multiple type or data sections
-        if section_id == S_TYPE and len(section_sizes[S_TYPE]) != 0:
-            raise ValidationException("multiple type sections")
-        if section_id == S_DATA and len(section_sizes[S_DATA]) != 0:
-            raise ValidationException("multiple data sections")
-
-        # Truncated section size
-        if (pos + 1) >= len(code):
-            raise ValidationException("truncated section size")
-        section_sizes[section_id].append((code[pos] << 8) | code[pos + 1])
-        pos += 2
-
-        # Empty section
-        if section_sizes[section_id][-1] == 0:
-            raise ValidationException("empty section")
-
-    # Code section cannot be absent
-    if len(section_sizes[S_CODE]) == 0:
-        raise ValidationException("no code section")
-
-    # Not more than 1024 code sections
-    if len(section_sizes[S_CODE]) > 1024:
-        raise ValidationException("more than 1024 code sections")
-
-    # Type section can be absent only if single code section is present
-    if len(section_sizes[S_TYPE]) == 0 and len(section_sizes[S_CODE]) != 1:
-        raise ValidationException("no obligatory type section")
-
-    # Type section, if present, has size corresponding to number of code sections
-    if len(section_sizes[S_TYPE]) != 0 and section_sizes[S_TYPE][0] != len(section_sizes[S_CODE]) * 2:
-        raise ValidationException("invalid type section size")
-
-    # The entire container must be scanned
-    if len(code) != (pos + sum(section_sizes[S_TYPE]) + sum(section_sizes[S_CODE]) + sum(section_sizes[S_DATA])):
-        raise ValidationException("container size not equal to sum of section sizes")
-
-    # First type section, if present, has 0 inputs and 0 outputs
-    if len(section_sizes[S_TYPE]) > 0 and (code[pos] != 0 or code[pos + 1] != 0):
-        raise ValidationException("invalid type of section 0")
-
-# Raises ValidationException on invalid code
-def validate_code_section(func_id: int, code: bytes, types: list[FunctionType] = [FunctionType(0, 0)]):
-    # Note that EOF1 already asserts this with the code section requirements
-    assert len(code) > 0
-
-    opcode = 0
-    pos = 0
-    rjumpdests = set()
-    immediates = set()
-    while pos < len(code):
-        # Ensure the opcode is valid
-        opcode = code[pos]
-        pos += 1
-        if not opcode in valid_opcodes:
-            raise ValidationException("undefined instruction")
-
-        if opcode == 0x5c or opcode == 0x5d:
-            if pos + 2 > len(code):
-                raise ValidationException("truncated relative jump offset")
-            offset = int.from_bytes(code[pos:pos+2], byteorder = "big", signed = True)
-
-            rjumpdest = pos + 2 + offset
-            if rjumpdest < 0 or rjumpdest >= len(code):
-                raise ValidationException("relative jump destination out of bounds")
-
-            rjumpdests.add(rjumpdest)
-        elif opcode == 0xb0:
-            if pos + 2 > len(code):
-                raise ValidationException("truncated CALLF immediate")
-            section_id = int.from_bytes(code[pos:pos+2], byteorder = "big", signed = False)
-
-            if section_id >= len(types):
-                raise ValidationException("invalid section id")
-        elif opcode == 0xb2:
-            if pos + 2 > len(code):
-                raise ValidationException("truncated JUMPF immediate")
-            section_id = int.from_bytes(code[pos:pos+2], byteorder = "big", signed = False)
-
-            if section_id >= len(types):
-                raise ValidationException("invalid section id")
-
-            if types[section_id].outputs != types[func_id].outputs:
-                raise ValidationException("incompatible function type for JUMPF")
-
-        # Save immediate value positions
-        immediates.update(range(pos, pos + immediate_sizes[opcode]))
-        # Skip immediates
-        pos += immediate_sizes[opcode]
-
-    # Ensure last opcode's immediate doesn't go over code end
-    if pos != len(code):
-        raise ValidationException("truncated immediate")
-
-    # opcode is the *last opcode*
-    if not opcode in terminating_opcodes:
-        raise ValidationException("no terminating instruction")
-
-    # Ensure relative jump destinations don't target immediates
-    if not rjumpdests.isdisjoint(immediates):
-        raise ValidationException("relative jump destination targets immediate")
-```
-
 ## Security Considerations
 
 TBA
diff --git a/EIPS/eip-5450.md b/EIPS/eip-5450.md
index 9a590b80f74211..36b6de2bac0e86 100644
--- a/EIPS/eip-5450.md
+++ b/EIPS/eip-5450.md
@@ -29,61 +29,33 @@ In particular, this extended code validation eliminates the need for EVM stack u
 
 Code section validation rules as defined by [EIP-3670](./eip-3670.md) (which has been extended by [EIP-4200](./eip-4200.md) and [EIP-4750](./eip-4750.md)) are extended again to include the instruction flow traversal procedure, where every possible code path is examined, and data stack height at each instruction is recorded. 
 
-*Data stack height* here refers to the number of stack values accessible by this function, i.e. it does not take into account values of caller functions' frames (but does include this function's inputs).  Note that validation procedure does not require actual data stack implementation, but only to keep track of its height. Current height value starts at `types[code_section_index].inputs` (number of inputs of this function) at function entry and is updated at each instruction.
+*Data stack height* here refers to the number of stack values accessible by this function, i.e. it does not take into account values of caller functions' frames (but does include this function's inputs). Note that validation procedure does not require actual data stack implementation, but only to keep track of its height. Current height value starts at `type[code_section_index].inputs` (number of inputs of this function) at function entry and is updated at each instruction.
 
 At the same time the following properties are being verified:
 
 1. For each reachable instruction in the section, data stack height is the same for all possible code paths going through this instruction.
 2. For each instruction, data stack always has enough items, i.e. stack underflow is invalid.
 3. For `CALLF` instruction, data stack has enough items to use as input arguments to a called function according to its type defined in the type section.
-4. For every terminating instruction, except `RETF`, data stack is empty after executing it.
-5. For `RETF` instruction, data stack before executing it has exactly `n` items to use as output values returned from a function, where `n` is function's number of outputs according to its type defined in the type section.
-6. Maximum data stack height required by a function does not exceed `1024`.
+4. For `RETF` instruction, data stack before executing it has exactly `n` items to use as output values returned from a function, where `n` is function's number of outputs according to its type defined in the type section.
+5. `max_stack_height` does not exceed 1023.
+6. The maximum data stack height matches the corresponding code section's `max_stack_height` within the type section body.
+7. No unreachable instructions exist in the code section.
 
-To examine every reachable code path, validation needs to traverse every instruction in order, while also following each non-conditional jump, and following both possible branches for each conditional jump. See below for reference implementation.
+To examine every reachable code path, validation needs to traverse every instruction in order, while also following each non-conditional jump, and following both possible branches for each conditional jump. After completing this, verify each instruction was visited at least once. Fail if any instructions were not visited as this invalidates 7).
 
 The complexity of this traversal is linear in the number of instructions, because each code path is examined only once, and property 1 guarantees no loops in the validation.
 
 ### Execution
 
-Given new deploy-time guarantees, EVM implementation is not required anymore to have run-time stack underflow check for each executed instruction. However implementations can keep it if they choose to do so.
+Given new deploy-time guarantees, EVM implementation is not required anymore to have run-time stack underflow check for each executed instruction.
 
 Stack overflow check, on the other hand, is still required at run-time, because function execution can start at arbitrary (i.e. known only at run-time) stack height at `CALLF` instruction of a caller (i.e. each execution can be in arbitrary inner call frame). Verification algorithm examines only stack height changes relative to starting stack height of the function.
 
-#### JUMPF changes
-
-In case a function pushed more items to the stack than is required as inputs by the jumped-to function, the previously defined `JUMPF` instruction behaviour was to remove the extra items:
-
-> 3. If data stack has more than `caller_stack_height + type[code_section_index].inputs` items, discards the items between `caller_stack_height` and top `type[code_section_index].inputs`, so that there are exactly `caller_stack_height +  type[code_section_index].items` items left.
-
-Given the new deploy-time guarantee of no function underflowing its stack frame, `JUMPF` instruction can check only that there is enough items for input arguments of the callee on the stack, without making sure there is exactly `inputs` items and not more. 
-
-Therefore, the previously defined behavior of discarding extra items is removed, and only the check for enough inputs is done:
-
-> 2. If data stack has less than `caller_stack_height + type[code_section_index].inputs` items, execution results in exceptional halt.
-
-With this change `JUMPF` operation complexity does not depend on `ouputs` value and is constant-time, therefore the price of `JUMPF` is lowered to 3 gas.
-
 ## Rationale
 
 ### Stack overflow check only in CALLF
 
-In the current proposal stack overflow checks are unchanged (i.e. are done for every instruction). However, we can provide more efficient variant where stack overflow check is performed only in `CALLF` instruction and uses called function's `max_stack_height` information for this. This decreases flexibility of an EVM program because `max_stack_height` corresponds to the worst-case control-flow path in the function.
-Moreover, the `max_stack_height` computed during validation must be stored alongside the code. This can be in the EOF itself or in implementation-defined format.
-
-### Unreachable code
-
-The current validation algorithm ignores *unreachable* instructions. The algorithm can be extended to reject any code having any unreachable instructions but additional instructions traversal is needed (or more efficient algorithm must be developed).
-
-### Clean stack upon termination
-
-It is currently required that the EVM stack is empty (in the current function context) after any terminating instruction (`STOP`, `RETURN`, etc, but also `RETF`). This requirement can be lifted.
-
-This can be used for implementing more efficient early exits from a function (e.g. assertion failure).
-
-For "exit" instructions which terminates the whole program execution (`STOP`, `RETURN`, etc) this is no change comparing to pre-EOF EVM. I.e. some *garbage* can be left on the stack. Cleaning the stack does not improve EVM implementation performance but makes the EVM programs potentially cost more (compiler is required to insert additional `POP` instructions).
-
-For `RETF` semantic would be more complicated. For `n` function outputs and `s` the stack height at `RETF` the EVM must erase `s-n` non-top stack items and move the `n` stack items to the place of erased ones. Cost of such operation may be relatively cheap but is not constant.
+In this EIP, we provide a more efficient variant of the EVM where stack overflow check is performed only in `CALLF` instruction using the called function's `max_stack_height` information. This decreases flexibility of an EVM program because `max_stack_height` corresponds to the worst-case control-flow path in the function.
 
 ## Backwards Compatibility
 
@@ -91,88 +63,6 @@ This change requires a “network upgrade”, since it modifies consensus rules.
 
 It poses no risk to backwards compatibility, as it is introduced only for EOF1 contracts, for which deploying undefined instructions is not allowed, therefore there are no existing contracts using these instructions. The new instructions are not introduced for legacy bytecode (code which is not EOF formatted).
 
-## Reference Implementation
-
-```python
-# Returns maximum stack height required by function execution frame
-# (not including frames of internal calls)
-# Raises ValidateExceptin if code is invalid.
-def validate_function(func_id: int, code: bytes, types: list[FunctionType] = [FunctionType(0, 0)]) -> int:
-    assert func_id >= 0
-    assert types[func_id].inputs >= 0
-    assert types[func_id].outputs >= 0
-
-    validate_code_section(code, len(types))
-
-    stack_heights = {}
-    start_stack_height = types[func_id].inputs
-    max_stack_height = start_stack_height
-
-    # queue of instructions to analyze, list of (pos, stack_height) pairs
-    worklist = [(0, start_stack_height)]
-
-    while worklist:
-        pos, stack_height = worklist.pop(0)
-        while True:
-            # Assuming code ends with a terminating instruction due to previous validation in validate_code_section()
-            assert pos < len(code), "code is invalid" 
-            op = code[pos]
-            info = TABLE[op]
-
-            # Check if stack height (type arity) at given position is the same
-            # for all control flow paths reaching this position.
-            if pos in stack_heights:
-                if stack_height != stack_heights[pos]:
-                    raise ValidationException("stack height mismatch for different paths")
-                else:
-                    break
-            else:
-                stack_heights[pos] = stack_height
-
-
-            stack_height_required = info.stack_height_required
-            stack_height_change = info.stack_height_change
-
-            if op == OP_CALLF:
-                called_func_id = int.from_bytes(code[pos + 1:pos + 3], byteorder="big", signed=False)
-                # Assuming called_func_id is valid due to previous validation in validate_code_section()
-                stack_height_required += types[called_func_id].inputs
-                stack_height_change += types[called_func_id].outputs - types[called_func_id].inputs
-
-            # Detect stack underflow
-            if stack_height < stack_height_required:
-                raise ValidationException("stack underflow")
-
-            stack_height += stack_height_change
-            max_stack_height = max(max_stack_height, stack_height)
-
-            # Handle jumps
-            if op == OP_RJUMP:
-                offset = int.from_bytes(code[pos + 1:pos + 3], byteorder="big", signed=True)
-                pos += info.immediate_size + 1 + offset  # pos is valid for validated code.
-
-            elif op == OP_RJUMPI:
-                offset = int.from_bytes(code[pos + 1:pos + 3], byteorder="big", signed=True)
-                # Save True branch for later and continue to False branch.
-                worklist.append((pos + 3 + offset, stack_height))
-                pos += info.immediate_size + 1
-
-            elif info.is_terminating:
-                expected_height = types[func_id].outputs if op == OP_RETF else 0
-                if stack_height != expected_height:
-                    raise ValidationException("non-empty stack on terminating instruction")
-                break
-
-            else:
-                pos += info.immediate_size + 1
-
-
-    if max_stack_height > 1024:
-        raise ValidationException("max stack above limit")
-
-    return max_stack_height
-```
-
 ## Security Considerations
 
 Needs discussion.

From 2f369da529eb083f008098779c6a27aeb79adc74 Mon Sep 17 00:00:00 2001
From: Steven Pineda <steven2308@outlook.com>
Date: Wed, 21 Dec 2022 17:07:02 -0500
Subject: [PATCH 068/274] Fixes bug when replacing asset on sample
 implementation of 5773 (#6202)

* Fixes bug when replacing asset on sample implementation of 5773.

* Rename the smart contract in specification

The smart contract specification was renamed to be identic to the name
of the proposal. This has been done so that the assets changes can be
merged.

Co-authored-by: Jan Turk <jan.turk12@gmail.com>
---
 EIPS/eip-5773.md                              |  2 +-
 assets/eip-5773/contracts/MultiAssetToken.sol |  2 +-
 assets/eip-5773/test/multiasset.ts            | 36 +++++++++++++++++++
 3 files changed, 38 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-5773.md b/EIPS/eip-5773.md
index bb146edc1d6f51..23114adaa37b6e 100644
--- a/EIPS/eip-5773.md
+++ b/EIPS/eip-5773.md
@@ -73,7 +73,7 @@ Alternative example of this, could be version control of an IoT device's firmwar
 The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
 
 ```solidity
-/// @title EIP-5773 Multi-Asset context-dependent tokens
+/// @title EIP-5773 Context-Dependent Multi-Asset Tokens
 /// @dev See https://eips.ethereum.org/EIPS/eip-5773
 /// @dev Note: the ERC-165 identifier for this interface is 0xd1526708.
 
diff --git a/assets/eip-5773/contracts/MultiAssetToken.sol b/assets/eip-5773/contracts/MultiAssetToken.sol
index 86d051ede66c80..f35520bd1247e0 100644
--- a/assets/eip-5773/contracts/MultiAssetToken.sol
+++ b/assets/eip-5773/contracts/MultiAssetToken.sol
@@ -468,7 +468,7 @@ contract MultiAssetToken is Context, IERC721, IMultiAsset {
         if (replacefound) {
             // We don't want to remove and then push a new asset.
             // This way we also keep the priority of the original resource
-            _activeAssets[tokenId][index] = assetId;
+            _activeAssets[tokenId][replaceIndex] = assetId;
             delete _tokenAssets[tokenId][replacesId];
         } else {
             // We use the current size as next priority, by default priorities would be [0,1,2...]
diff --git a/assets/eip-5773/test/multiasset.ts b/assets/eip-5773/test/multiasset.ts
index 0685a44e78792e..54a3b5293713ec 100644
--- a/assets/eip-5773/test/multiasset.ts
+++ b/assets/eip-5773/test/multiasset.ts
@@ -370,6 +370,42 @@ describe('MultiAsset', async () => {
         metaURIDefault,
       ]);
     });
+
+    it("can overwrite an existing asset after 3 have been added and 1 accepted", async function () {
+      const resId = 1;
+      const resId2 = 2;
+      const resId3 = 3;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId, resId2, resId3]);
+      await expect(token.addAssetToToken(tokenId, resId, 0)).to.emit(
+        token,
+        "AssetAddedToToken"
+      );
+      await expect(token.addAssetToToken(tokenId, resId2, 0)).to.emit(
+        token,
+        "AssetAddedToToken"
+      );
+      await expect(token.addAssetToToken(tokenId, resId3, resId2))
+        .to.emit(token, "AssetAddedToToken")
+        .withArgs(tokenId, resId3, resId2);
+
+      const pendingIds = await token.getPendingAssets(tokenId);
+
+      expect(
+        await renderUtils.getAssetsById(token.address, tokenId, pendingIds)
+      ).to.be.eql([metaURIDefault, metaURIDefault, metaURIDefault]);
+
+      await expect(token.acceptAsset(tokenId, 1, resId2))
+        .to.emit(token, "AssetAccepted")
+        .withArgs(tokenId, resId2, 0);
+
+      await expect(token.acceptAsset(tokenId, 1, resId3))
+        .to.emit(token, "AssetAccepted")
+        .withArgs(tokenId, resId3, 2);
+    });
+
   });
 
   describe('Rejecting assets', async function () {

From 6f1bac8d1a73bf9ba372f4a2e95da153c53087ef Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <chfast@gmail.com>
Date: Wed, 21 Dec 2022 23:45:50 +0100
Subject: [PATCH 069/274] 4750,5450: Specify stack overflow check only in CALLF
 (#6205)

* 4750,5450: Specify stack overflow check only in CALLF

* Apply suggestions from code review

Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>

Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>
---
 EIPS/eip-4750.md | 2 +-
 EIPS/eip-5450.md | 8 +++-----
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/EIPS/eip-4750.md b/EIPS/eip-4750.md
index 4d63a37e045b16..e3e67a7674c160 100644
--- a/EIPS/eip-4750.md
+++ b/EIPS/eip-4750.md
@@ -68,7 +68,7 @@ If the code is valid EOF1, the following execution rules apply:
 
 1. Has one immediate argument,`code_section_index`, encoded as a 16-bit unsigned big-endian value.
 2. If data stack has less than `caller_stack_height + type[code_section_index].inputs` items, execution results in exceptional halt.
-3. If data stack size after the call would exceed `1024` items, (i.e. if `caller_stack_height - type[code_section_index].inputs + type[code_section_index].ouputs > 1024`), execution results in exceptional halt.
+3. If data stack size exceeds `1024 - type[code_section_index].max_stack_height` (i.e. if the called function may exceed the global stack height limit), execution results in exceptional halt. This also guarantees that the stack height after the call is within the limits.
 4. If return stack already has `1024` items, execution results in exceptional halt.
 5. Charges 5 gas.
 6. Pops nothing and pushes nothing to data stack.
diff --git a/EIPS/eip-5450.md b/EIPS/eip-5450.md
index 36b6de2bac0e86..5a6c369b575a4f 100644
--- a/EIPS/eip-5450.md
+++ b/EIPS/eip-5450.md
@@ -13,13 +13,13 @@ requires: 3540, 3670, 4200, 4750
 
 ## Abstract
 
-Introduce extended validation of code sections to guarantee that stack underflow cannot happen during execution of validated contracts.
+Introduce extended validation of code sections to guarantee that neither stack underflow nor overflow can happen during execution of validated contracts.
 
 ## Motivation
 
 Currently existing EVM implementations perform a number of validity checks for each executed instruction, such as check for stack overflow/underflow, sufficient gas, etc. This change aims to minimize the number of such checks required at run-time, by verifying at deploy-time that no exceptional conditions can happen, and preventing to deploy the code where it could happen.
 
-In particular, this extended code validation eliminates the need for EVM stack underflow checks done for every executed instruction. It also prevents deploying code that can be statically proven to require more than 1024 stack items, however it may still be possible to exceed that limit in some cases, and thus overflow checks cannot be fully eliminated.
+In particular, this extended code validation eliminates the need for EVM stack underflow checks done for every executed instruction. It also prevents deploying code that can be statically proven to require more than 1024 stack items and limits stack overflow checks to the `CALLF` instruction only.
 
 ## Specification
 
@@ -47,9 +47,7 @@ The complexity of this traversal is linear in the number of instructions, becaus
 
 ### Execution
 
-Given new deploy-time guarantees, EVM implementation is not required anymore to have run-time stack underflow check for each executed instruction.
-
-Stack overflow check, on the other hand, is still required at run-time, because function execution can start at arbitrary (i.e. known only at run-time) stack height at `CALLF` instruction of a caller (i.e. each execution can be in arbitrary inner call frame). Verification algorithm examines only stack height changes relative to starting stack height of the function.
+Given new deploy-time guarantees, EVM implementation is not required anymore to have run-time stack underflow nor overflow checks for each executed instruction. The exception is the `CALLF` performing data stack overflow check for the entire called function.
 
 ## Rationale
 

From accf816d3614446b747e2c88a9b42ee368017525 Mon Sep 17 00:00:00 2001
From: lightclient <14004106+lightclient@users.noreply.github.com>
Date: Thu, 22 Dec 2022 11:18:20 -0700
Subject: [PATCH 070/274] Add EIP-6206: EOF - JUMPF instruction (#6206)

* add jumpf eip

* add eip number and discussion link

* Fix markdownlint errors

* Last markdownlint error

* Fix invalid link

* Formatting stuff

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-6206.md | 58 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 58 insertions(+)
 create mode 100644 EIPS/eip-6206.md

diff --git a/EIPS/eip-6206.md b/EIPS/eip-6206.md
new file mode 100644
index 00000000000000..7252e628ed0201
--- /dev/null
+++ b/EIPS/eip-6206.md
@@ -0,0 +1,58 @@
+---
+eip: 6206
+title: EOF - JUMPF instruction
+description: Introduces instruction for chaining function calls.
+author: Andrei Maiboroda (@gumb0), Alex Beregszaszi (@axic), Paweł Bylica (@chfast), Matt Garnett (@lightclient)
+discussions-to: https://ethereum-magicians.org/t/eip-4750-eof-functions/8195
+status: Draft
+type: Standards Track
+category: Core
+created: 2022-12-21
+requires: 4750, 5450
+---
+
+## Abstract
+
+This EIP allows for tail call optimizations in EOF functions ([EIP-4750](./eip-4750.md)) by introducing a new instruction `JUMPF`, which jumps to a code section without adding a new return stack frame.
+
+## Motivation
+
+It is common for functions to make a call at the end of the routine only to then return. `JUMPF` optimizes this behavior by changing code sections without needing to update the return stack.
+
+## Specification
+
+A new instruction, `JUMPF (0xb2)`, is introduced.
+
+### Execution Semantics
+
+1. `JUMPF` has one immediate argument, `code_section_index`, encoded as a 16-bit unsigned big-endian value.
+2. If the data stack size exceeds `1024 - type[code_section_index].max_stack_height` (i.e. if the called function may exceed the global stack height limit), execution results in an exceptional halt. This guarantees that the stack height after the call is within the limits.
+3. `JUMPF` costs 5 gas.
+4. `JUMPF` neither pops nor pushes anything to the data stack.
+
+### Code Validation
+
+Let the definition of `type[i]` be inherited from [EIP-4750](./eip-4750.md) and define `stack_height` to be the height of the stack at a certain instruction during the instruction flow traversal if the data stack at the start of the function were equal to `type[i].inputs`.
+
+* The immediate argument of `JUMPF` MUST be greater than or equal to the total number of code sections.
+* The stack height at `JUMPF` MUST be greater than or equal to `type[code_section_index].inputs`.
+* `type[current_section_index].outputs` MUST equal `stack_height - type[code_section_index].inputs + type[code_section_index].outputs`. This means that `code_section_index` can output less stack elements than the original code section called by the top element on the return stack if the `current_section_index` code section leaves the delta `type[current_section_index] - type[code_section_index]` element(s) on the stack.
+* The code validation defined in [EIP-4200](./eip-4200.md) also fails if any `RJUMP*` offset points to one of the two bytes directly following a `JUMPF` instruction.
+
+## Rationale
+
+### Allowing `JUMPF` to section with less outputs
+
+As long as `JUMPF` prepares the delta `type[current_section_index] - type[code_section_index]` stack elements before changing code sections, it is possible to jump to a section with less outputs than was originally entered via `CALLF`. This will reduce duplicated code as it will allow compilers more flexibility during code generation such that certain helpers can be used generically by functions, regardless of their output values.
+
+## Backwards Compatibility
+
+This change is backward compatible as EOF does not allow undefined instructions to be used or deployed, meaning no contracts will be affected.
+
+## Security Considerations
+
+Needs discussion.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From dc7f4345858793b506e7685bd4bb143a9846d0cb Mon Sep 17 00:00:00 2001
From: Anton Buenavista <ay.buenavista@gmail.com>
Date: Thu, 22 Dec 2022 14:19:06 -0500
Subject: [PATCH 071/274] Update EIP-5115: Updates to interface based on
 community feedback (#6207)

* Update EIP-5115: Changes based from community feedback

* Update EIP-5115: Changes in interface and definitions

* Update EIP-5115: Linting fixes
---
 EIPS/eip-5115.md | 284 +++++++++++++++++++----------------------------
 1 file changed, 114 insertions(+), 170 deletions(-)

diff --git a/EIPS/eip-5115.md b/EIPS/eip-5115.md
index 480b2752b5fd3d..e86ef8a1a3c539 100644
--- a/EIPS/eip-5115.md
+++ b/EIPS/eip-5115.md
@@ -1,9 +1,9 @@
 ---
 eip: 5115
-title: Super Composable Yield Token
-description: Interface for wrapped yield-generating tokens.
+title: SY Token
+description: Interface for wrapped yield-bearing tokens.
 author: Vu Nguyen (@mrenoon), Long Vuong (@UncleGrandpa925), Anton Buenavista (@ayobuenavista)
-discussions-to:	https://ethereum-magicians.org/t/eip-5115-super-composable-yield-token-standard/9423
+discussions-to: https://ethereum-magicians.org/t/eip-5115-super-composable-yield-token-standard/9423
 status: Draft
 type: Standards Track
 category: ERC
@@ -13,31 +13,34 @@ requires: 20
 
 ## Abstract
 
-This standard proposes an API for wrapped yield-generating tokens within smart contracts. It is an extension on the [EIP-20](./eip-20.md) token that provides basic functionality for transferring, depositing, withdrawing tokens, as well as reading balances.
+This standard proposes an API for wrapped yield-bearing tokens within smart contracts. It is an extension on the [EIP-20](./eip-20.md) token that provides basic functionality for transferring, depositing, withdrawing tokens, as well as reading balances.
 
 ## Motivation
 
 Yield generating mechanisms are built in all shapes and sizes, necessitating a manual integration every time a protocol builds on top of another protocol’s yield generating mechanism. 
 
-[EIP-4626](./eip-4626.md) tackled a significant part of this fragmentation by standardizing the interfaces for vaults, a major category among various yield-generating mechanisms.
+[EIP-4626](./eip-4626.md) tackled a significant part of this fragmentation by standardizing the interfaces for vaults, a major category among various yield generating mechanisms.
 
 In this EIP, we’re extending the coverage to include assets beyond EIP-4626’s reach, namely:
-- Yield-generating assets that have different base tokens used for minting vs accounting for the pool value.
-  - This category includes AMM liquidity tokens (which are yield generating assets that yield swap fees) since the value of the pool is measured in “liquidity units” (for example, $\sqrt k$ in UniswapV2, as defined in UniswapV2 whitepaper) which can’t be deposited in (as they are not tokens).
+
+- yield-bearing assets that have different input tokens used for minting vs accounting for the pool value.
+  - This category includes AMM liquidity tokens (which are yield-bearing assets that yield swap fees) since the value of the pool is measured in “liquidity units” (for example, $\sqrt k$ in UniswapV2, as defined in UniswapV2 whitepaper) which can’t be deposited in (as they are not tokens).
   - This extends the flexibility in minting the yield-bearing assets. For example, there could be an ETH vault that wants to allow users to deposit cETH directly instead of ETH, for gas efficiency or UX reasons.
 - Assets with reward tokens by default (e.g. COMP rewards for supplying in Compound). The reward tokens are expected to be sold to compound into the same asset.
+- This EIP can be extended further to include the handling of rewards, such as the claiming of accrued multiple rewards tokens.
 
-While EIP-4626 is a well-designed and suitable standard for most vaults, there will inevitably be some yield-generating mechanisms that do not fit into their category (LP tokens for instance). A more flexible standard is required to standardize the interaction with all types of yield generating mechanisms.
+While EIP-4626 is a well-designed and suitable standard for most vaults, there will inevitably be some yield generating mechanisms that do not fit into their category (LP tokens for instance). A more flexible standard is required to standardize the interaction with all types of yield generating mechanisms.
 
-Therefore, we are proposing Super Composable Yield (SCY), a flexible standard for wrapped yield generating tokens that could cover most mechanisms in DeFi. We foresee that:
+Therefore, we are proposing Standardized Yield (SY), a flexible standard for wrapped yield-bearing tokens that could cover most mechanisms in DeFi. We foresee that:
 
 - EIP-4626 will still be a popular vault standard, that most vaults should adopt.
-- SCY tokens can wrap over most yield generating mechanisms in DeFi, including EIP-4626 vaults for projects built on top of interest-bearing tokens.
-- Whoever needs the functionalities of SCY could integrate with the existing SCY tokens or write a new SCY (to wrap over the target interest-bearing token).
+- SY tokens can wrap over most yield generating mechanisms in DeFi, including EIP-4626 vaults for projects built on top of yield-bearing tokens.
+- Whoever needs the functionalities of SY could integrate with the existing SY tokens or write a new SY (to wrap over the target yield-bearing token).
+- Reward handling can be extended from the SY token.
 
 ### Use Cases
 
-This EIP is designed for flexibility, aiming to accommodate as many yield generating mechanisms as possible. Particularly, this standard aims to be generalized enough that it supports the following uses cases and more:
+This EIP is designed for flexibility, aiming to accommodate as many yield generating mechanisms as possible. Particularly, this standard aims to be generalized enough that it supports the following use cases and more:
 
 - Money market supply positions
     - Lending DAI in Compound, getting DAI interests and COMP rewards
@@ -57,19 +60,18 @@ This EIP is designed for flexibility, aiming to accommodate as many yield genera
     - Provide LOOKS in LooksRare, getting LOOKS yield and WETH rewards
 - Rebasing tokens
     - Stake OHM into sOHM/gOHM, getting OHM rebase yield
-    - Stake BTRFLY into xBTRFLY, getting BTRFLY rebase yield
 
-The EIP hopes to minimize, if not possibly eliminate, the use of customized adapters in order to interact with many different forms of yield-generating token mechanisms.
+The EIP hopes to minimize, if not possibly eliminate, the use of customized adapters in order to interact with many different forms of yield-bearing token mechanisms.
 
 ## Specification
 
 ### Generic Yield Generating Pool
 
-We will first introduce Generic Yield Generating Pool (GYGP), a model to describe most yield generating mechanisms in DeFi. In every yield generating mechanism, there is a pool of funds, whose value is measured in **assets**. There are a number of users who contribute liquidity to the pool, in exchange for **shares** of the pool, which represents units of ownership of the pool. Over time, the value (measured in **assets**) of the pool grows, such that each **share** is worth more **assets** over time. The pool could earn a number of **reward tokens** over time, which are distributed to the users according to some logic (For example, proportionally the number of **shares**).
+We will first introduce Generic Yield Generating Pool (GYGP), a model to describe most yield generating mechanisms in DeFi. In every yield generating mechanism, there is a pool of funds, whose value is measured in **assets**. There are a number of users who contribute liquidity to the pool, in exchange for **shares** of the pool, which represents units of ownership of the pool. Over time, the value (measured in **assets**) of the pool grows, such that each **share** is worth more **assets** over time. The pool could earn a number of **reward tokens** over time, which are distributed to the users according to some logic (for example, proportionally the number of **shares**).
 
 Here are the more concrete definitions of the terms:
 
-#### Definitions:
+#### GYGP Definitions:
 
 - **asset**: Is a unit to measure the value of the pool. At time *t*, the pool has a total value of *TotalAsset(t)* **assets**.
 - **shares**: Is a unit that represents ownership of the pool. At time *t*, there are *TotalShares(t)* **shares** in total.
@@ -79,10 +81,10 @@ Here are the more concrete definitions of the terms:
 
 #### State changes:
 
-1. A user deposits **assets** into the pool, in exchange for new **shares** that will be created for the user, proportionally to the asset amount being deposited compared to the value of the pool.
-2. A user withdraws **assets** from the pool, by burning their **shares**, proportionally to the asset amount being burned compared to the value of the pool
-3. The pool earns some **assets**. The **exchange rate** will simply increase due to the additional **assets.**
-4. The pool earns some **reward tokens**. The additional reward tokens will be distributed among the users.
+1. A user deposits $d_a$ **assets** into the pool at time $t$ ($d_a$ could be negative, which means a withdraw from the pool). $d_s = d_a / ExchangeRate(t)$ new **shares** will be created and given
+to user (or removed and burned from the user when $d_a$ is negative).
+2. The pool earns $d_a$ (or loses $−d_a$ if $d_a$ is negative) **assets** at time $t$. The **exchange rate** simply increases (or decreases if $d_a$ is negative) due to the additional assets.
+3. The pool earns $d_r$ **reward token** $i$. Every user will receive a certain amount of **reward token** $i$.
 
 #### Examples of GYGPs in DeFi:
 
@@ -90,39 +92,41 @@ Here are the more concrete definitions of the terms:
 | --- | --- | --- | --- | --- |
 | Supply USDC in Compound | USDC | cUSDC | COMP | USDC value per cUSDC, increases with USDC supply interests |
 | ETH liquid staking in Lido | stETH | wstETH | None | stETH value per wstETH, increases with ETH staking rewards |
-| Stake LOOKS in LooksRare | LOOKS | shares (in contract) | WETH | LOOKS value per shares, increases with LOOKS rewards |
-| Stake BTRFLY into xBTRFLY | BTRFLY | xBTRFLY | None | BTRFLY value per xBTRFLY, increases due to rebase rewards |
+| Stake LOOKS in LooksRare Compounder | LOOKS | shares (in contract) | WETH | LOOKS value per shares, increases with LOOKS rewards |
+| Stake APE in $APE Compounder | sAPE | shares (in contract) | APE | sAPE value per shares, increases with APE rewards |
 | Provide ETH+USDC liquidity on Sushiswap | ETHUSDC liquidity (a pool of x ETH + y USDC has sqrt(xy) ETHUSDC liquidity) | ETHUSDC Sushiswap LP (SLP) token | None | ETHUSDC liquidity value per ETHUSDC SLP, increases due to swap fees |
 | Provide ETH+USDC liquidity on Sushiswap and stake into Onsen | ETHUSDC liquidity (a pool of x ETH + y USDC has sqrt(xy) ETHUSDC liquidity) | ETHUSDC Sushiswap LP (SLP) token | SUSHI | ETHUSDC liquidity value per ETHUSDC SLP, increases due to swap fees |
-| Provide USDC+USDT+DAI liquidity in Curve | 3crv pool’s liquidity (amount of D per 3crv token) | 3crv token | CRV | 3crv pool’s liquidity per 3crv token, increases due to swap fees |
 | Provide BAL+WETH liquidity in Balancer (80% BAL, 20% WETH) | BALWETH liquidity (a pool of x BAL + y WETH has x^0.8*y^0.2 BALWETH liquidity) | BALWETH Balancer LP token | None | BALWETH liquidity per BALWETH Balancer LP token, increases due to swap fees |
+| Provide USDC+USDT+DAI liquidity in Curve | 3crv pool’s liquidity (amount of D per 3crv token) | 3crv token | CRV | 3crv pool’s liquidity per 3crv token, increases due to swap fees |
+| Provide FRAX+USDC liquidity in Curve then stake LP in Convex | BALWETH liquidity (a pool of x BAL + y WETH has x^0.8*y^0.2 BALWETH liquidity) | BALWETH Balancer LP token | None | BALWETH liquidity per BALWETH Balancer LP token, increases due to swap fees |
+
 
-### Super Composable Yield Token Standard
+### Standardized Yield Token Standard
 
-#### Overview
+#### Overview:
 
-Super Composable Yield is a token standard for all GYGPs. Each Super Composable Yield token represents **shares** in a GYGP and allows for interacting with the GYGP via a standard interface
+Standardized Yield (SY) is a token standard for any yield generating mechanism that conforms to the GYGP model. Each SY token represents **shares** in a GYGP and allows for interacting with the GYGP via a standard interface.
 
-All SCY tokens:
+All SY tokens:
 
 - **MUST** implement **`EIP-20`** to represent shares in the underlying GYGP.
 - **MUST** implement EIP-20’s optional metadata extensions `name`, `symbol`, and `decimals`, which **SHOULD** reflect the underlying GYGP’s accounting asset’s `name`, `symbol`, and `decimals`.
-- **MAY** implement [EIP-2612](./eip-2612.md) to improve the UX of approving SCY tokens on various integrations.
-- **MAY** revert on calls to `transfer` and `transferFrom` if a SCY token is to be non-transferable.
+- **MAY** implement [EIP-2612](./eip-2612.md) to improve the UX of approving SY tokens on various integrations.
+- **MAY** revert on calls to `transfer` and `transferFrom` if a SY token is to be non-transferable.
 - The EIP-20 operations `balanceOf`, `transfer`, `totalSupply`, etc. **SHOULD** operate on the GYGP “shares”, which represent a claim to ownership on a fraction of the GYGP’s underlying holdings.
 
-#### Definition of base tokens
+#### SY Definitions:
 
-Base tokens are tokens that could be deposited to mint SCY tokens (and hence, to enter the underlying GYGP), or redeemed when burning SCY tokens (and hence, exiting the underlying GYGP). Essentially, base tokens are implicitly converted into units of **assets** when deposited or redeemed, to conform to state change #1 and #2 of the GYGP definition above.
+On top of the definitions above for GYGPs, we need to define 2 more concepts:
 
-There could be multiple kinds of base tokens in a SCY. This allows for maximum flexibility in how to mint SCY to enter the underlying yield generating pool. For example, both BAL and WETH (and even BALWETH LP token) could be used to mint the SCY token for BALWETH Balancer pool (by providing single-sided liquidity).
+- **input tokens**: Are tokens that can be converted into assets to enter the pool. Each SY can accept several possible input tokens $tokens_{in_{i}}$
 
-As such, base tokens are not necessarily the same as the asset (which is a key difference between SCY and EIP-4626).
+- **output tokens**: Are tokens that can be redeemed from assets when exiting the pool. Each SY can have several possible output tokens $tokens_{out_{i}}$
 
 #### Interface
 
 ```solidity
-interface ISuperComposableYield {
+interface IStandardizedYield {
     enum AssetType {
         TOKEN,
         LIQUIDITY
@@ -133,62 +137,50 @@ interface ISuperComposableYield {
         address indexed receiver,
         address indexed tokenIn,
         uint256 amountDeposited,
-        uint256 amountScyOut
+        uint256 amountSyOut
     );
 
     event Redeem(
         address indexed caller,
         address indexed receiver,
         address indexed tokenOut,
-        uint256 amountScyToRedeem,
+        uint256 amountSyToRedeem,
         uint256 amountTokenOut
     );
 
-    event ClaimRewards(
-        address indexed caller,
-        address indexed user,
-        address[] rewardTokens,
-        uint256[] rewardAmounts
-    );
-
-    event ExchangeRateUpdated(uint256 oldExchangeRate, uint256 newExchangeRate);
-
     function deposit(
         address receiver,
         address tokenIn,
-        uint256 amountTokenToPull,
-        uint256 minSharesOut
+        uint256 amountTokenToDeposit,
+        uint256 minSharesOut,
+        bool depositFromInternalBalance
     ) external returns (uint256 amountSharesOut);
 
     function redeem(
         address receiver,
-        uint256 amountSharesToPull,
+        uint256 amountSharesToRedeem,
         address tokenOut,
-        uint256 minTokenOut
+        uint256 minTokenOut,
+        bool burnFromInternalBalance
     ) external returns (uint256 amountTokenOut);
 
-    function claimRewards(address user) external returns (uint256[] memory rewardAmounts);
-
-    function exchangeRateCurrent() external returns (uint256);
+    function exchangeRate() external view returns (uint256 res);
 
-    function exchangeRateStored() external view returns (uint256);
+    function getTokensIn() external view returns (address[] memory res);
 
-    function getRewardTokens() external view returns (address[] memory);
-
-    function getBaseTokens() external view returns (address[] memory);
+    function getTokensOut() external view returns (address[] memory res);
 
     function yieldToken() external view returns (address);
 
-    function isValidBaseToken(address token) external view returns (bool);
+    function previewDeposit(address tokenIn, uint256 amountTokenToDeposit)
+        external
+        view
+        returns (uint256 amountSharesOut);
 
-    function assetInfo()
-    external
-    view
-    returns (
-        AssetType assetType,
-        address assetAddress,
-        uint8 assetDecimals
-    );
+    function previewRedeem(address tokenOut, uint256 amountSharesToRedeem)
+        external
+        view
+        returns (uint256 amountTokenOut);
 
     function name() external view returns (string memory);
 
@@ -204,126 +196,105 @@ interface ISuperComposableYield {
 function deposit(
     address receiver,
     address tokenIn,
-    uint256 amountTokenToPull,
-    uint256 minSharesOut
+    uint256 amountTokenToDeposit,
+    uint256 minSharesOut,
+    bool depositFromInternalBalance
 ) external returns (uint256 amountSharesOut);
 ```
 
-This method will first pull `amountTokenToPull` of `tokenIn` (a **base token**), and use the floating amount `tokenIn` in the SCY contract to deposit to mint new **shares**. 
+This function will deposit *amountTokenToDeposit* of input token $i$ (*tokenIn*) to mint new SY shares.
 
-The ideal way to deposit is to send `tokenIn` in first, then call the `deposit` function with `amountTokenToPull = 0`. This pattern is similar to UniswapV2 (and UniswapV3) pools, which allow for better composability and gas efficiency by minimizing token transfers. For example, a router contract could swap from some other token to `tokenIn` which is sent directly to the SCY contract before `deposit` is called.
+If *depositFromInternalBalance* is set to *false*, msg.sender will need to initially deposit *amountTokenToDeposit* of input token $i$ (*tokenIn*) into the SY contract, then this function will convert the *amountTokenToDeposit* of input token $i$ into $d_a$ worth of **asset** and deposit this amount into the pool for the *receiver*, who will receive *amountSharesOut* of SY tokens (**shares**). If *depositFromInternalBalance* is set to *true*, then *amountTokenToDeposit* of input token $i$ (*tokenIn*) will be taken from receiver directly (as msg.sender), and will be converted and shares returned to the receiver similarly to the first case.
 
-This function will convert the amount of `tokenIn` into some worth of **assets** and deposit this amount into the SCY contract for the recipient, who will receive `amountSharesOut` of SCY tokens (**shares**).
+This function should revert if $amountSharesOut \lt minSharesOut$.
 
 - **MUST** emit the `Deposit` event.
-- **MUST** support EIP-20’s `approve` / `transferFrom` flow where `tokenIn` are taken from receiver directly (as msg.sender) or if the msg.sender has EIP-20 approved allowance over the base token of the receiver.
-- **MUST** revert if $amountSharesOut \lt minSharesOut$ (due to deposit limit being reached, slippage, or the user not approving enough `tokenIn` **to the SCY contract, etc).
+- **MUST** support EIP-20’s `approve` / `transferFrom` flow where `tokenIn` are taken from receiver directly (as msg.sender) or if the msg.sender has EIP-20 approved allowance over the input token of the receiver.
+- **MUST** revert if $amountSharesOut \lt minSharesOut$ (due to deposit limit being reached, slippage, or the user not approving enough `tokenIn` **to the SY contract, etc).
+- **MAY** be payable if the `tokenIn` depositing asset is the chain's native currency (e.g. ETH).
 
 ```solidity
 function redeem(
     address receiver,
-    uint256 amountSharesToPull,
+    uint256 amountSharesToRedeem,
     address tokenOut,
-    uint256 minTokenOut
+    uint256 minTokenOut,
+    bool burnFromInternalBalance
 ) external returns (uint256 amountTokenOut);
 ```
 
-This method will first pull `amountSharesToPull` of SCY tokens, and use the floating amount of SCY tokens in the SCY contract to redeem to `tokenOut` (a **base token**). This pattern is similar to the one in `deposit`
+This function will redeem the $d_s$ shares, which is equivalent to $d_a = d_s \times ExchangeRate(t)$ assets, from the pool. The $d_a$ assets is converted into exactly *amountTokenOut* of output token $i$ (*tokenOut*).
+
+If *burnFromInternalBalance* is set to *false*, the user will need to initially deposit *amountSharesToRedeem* into the SY contract, then this function will burn the floating amount $d_s$ of SY tokens (**shares**) in the SY contract to redeem to output token $i$ (*tokenOut*). This pattern is similar to UniswapV2 which allows for more gas efficient ways to interact with the contract. If *burnFromInternalBalance* is set to *true*, then this function will burn *amountSharesToRedeem* $d_s$ of SY tokens directly from the user to redeem to output token $i$ (*tokenOut*).
 
-This function will redeem the exact SCY token (**shares**) from the SCY contract. The **assets** are converted into `tokenOut` of `tokenOut`.
+This function should revert if $amountTokenOut \lt minTokenOut$.
 
 - **MUST** emit the `Redeem` event.
 - **MUST** support EIP-20’s `approve` / `transferFrom` flow where the shares are burned from receiver directly (as msg.sender) or if the msg.sender has EIP-20 approved allowance over the shares of the receiver.
-- **MUST** revert if $tokenOut \lt minTokenOut$ (due to redeem limit being reached, slippage, or the user not approving enough `amountSharesToPull` **to the SCY contract, etc).
+- **MUST** revert if $amountTokenOut \lt minTokenOut$ (due to redeem limit being reached, slippage, or the user not approving enough `amountSharesToRedeem` to the SY contract, etc).
 
 ```solidity
-function claimRewards(address user) external returns (uint256[] memory rewardAmounts);
+function exchangeRate() external view returns (uint256 res);
 ```
 
-This method sends all the available claimable rewards to the user as is, with the amounts in the list being in the same order as `getRewardTokens`.
+This method updates and returns the latest **exchange rate**, which is the **exchange rate** from SY token amount into asset amount, scaled by a fixed scaling factor of 1e18.
 
-- **MUST** emit the `ClaimRewards` event.
-- **MAY** return one or multiple rewards to the user.
-- **MAY** return zero rewards to the user.
+- **MUST** return $ExchangeRate(t_{now})$ such that $ExchangeRate(t_{now}) \times syBalance / 1e18 = assetBalance$.
+- **MUST NOT** include fees that are charged against the underlying yield token in the SY contract.
 
 ```solidity
-function exchangeRateCurrent() external returns (uint256);
+function getTokensIn() external view returns (address[] memory res);
 ```
 
-This method updates and returns the latest **exchange rate**, which is the **exchange rate** from SCY token amount into asset amount, scaled by a fixed scaling factor of 1e18.
+This read-only method returns the list of all input tokens that can be used to deposit into the SY contract.
 
-- **MUST** return $ExchangeRate(t_{now})$ such that $ExchangeRate(t_{now}) \times scyBalance / 1e18 = assetBalance$.
-- **MUST NOT** include fees that are charged against the underlying yield token in the SCY contract.
-
-```solidity
-function exchangeRateStored() external view returns (uint256);
-```
-
-This read-only method returns the last saved value of the exchange rate.
-
-- **MUST** return the value of `exchangeRateCurrent` of a past timestamp where it was last updated in the contract
-- **MUST NOT** include fees that are charged against the underlying yield token in the SCY contract.
-- **MUST NOT** revert.
-
-```solidity
-function yieldToken() external view returns (address);
-```
-
-This read-only method returns the underlying yield-generating token (representing a GYGP) that was wrapped into a SCY token.
-
-- **MUST** return a token address that conforms to the EIP-20 interface, or zero address
+- **MUST** return EIP-20 token addresses.
+- **MUST** return at least one address.
 - **MUST NOT** revert.
-- **MUST** reflect the exact underlying yield-generating token address if the SCY token is a wrapped token.
-- **MAY** return 0x or zero address if the SCY token is natively implemented, and not from wrapping.
 
 ```solidity
-function getRewardTokens() external view returns (address[] memory);
+function getTokensOut() external view returns (address[] memory res);
 ```
 
-This read-only method returns the latest list of all reward tokens.
+This read-only method returns the list of all output tokens that can be converted into when exiting the SY contract.
 
 - **MUST** return EIP-20 token addresses.
+- **MUST** return at least one address.
 - **MUST NOT** revert.
-- **MAY** return an empty list, one, or several token addresses.
-- **MAY** return additional reward tokens over time, depending on when `underlyingYieldToken` supports more or less reward tokens.
 
 ```solidity
-function getBaseTokens() external view returns (address[] memory);
+function yieldToken() external view returns (address);
 ```
 
-This read-only method returns the list of all base tokens that can be used to deposit into the SCY contract.
+This read-only method returns the underlying yield-bearing token (representing a GYGP) address.
 
-- **MUST** return EIP-20 token addresses.
-- **MUST** return at least one address.
+- **MUST** return a token address that conforms to the EIP-20 interface, or zero address
 - **MUST NOT** revert.
+- **MUST** reflect the exact underlying yield-bearing token address if the SY token is a wrapped token.
+- **MAY** return 0x or zero address if the SY token is natively implemented, and not from wrapping.
 
 ```solidity
-function isValidBaseToken(address token) external view returns (bool);
+function previewDeposit(address tokenIn, uint256 amountTokenToDeposit)
+    external
+    view
+    returns (uint256 amountSharesOut);
 ```
 
-This read-only method checks whether a token address entered is a base token that can be used to mint SCY.
+This read-only method returns the amount of shares that a user would have received if they deposit *amountTokenToDeposit* of *tokenIn*.
 
+- **MUST** return less than or equal of *amountSharesOut* to the actual return value of the `deposit` method, and **SHOULD NOT** return greater than the actual return value of the `deposit` method.
 - **MUST NOT** revert.
 
 ```solidity
-function assetInfo()
+function previewRedeem(address tokenOut, uint256 amountSharesToRedeem)
     external
     view
-    returns (
-        AssetType assetType,
-        address assetAddress,
-        uint8 assetDecimals
-    );
+    returns (uint256 amountTokenOut);
 ```
 
-This read-only function returns useful information about the asset, intended for front-ends or off-chain systems to display balances and information about the asset.
+This read-only method returns the amount of *tokenOut* that a user would have received if they redeem *amountSharesToRedeem* of *tokenOut*.
 
-`decimals` is the decimals to format asset balances.
-
-Convention for `assetType` and format of the `info` field: 1) If asset is an EIP-20 token, `assetType = 0`, `assetAddress` is the address of the token; 2) If asset is liquidity of an AMM (like $\sqrt{k}$ in UniswapV2 forks), `assetType = 1`, `assetAddress` is the address of the LP token.
-   
-* **MUST** reflect the underlying asset’s decimals if at all possible in order to eliminate any possible source of confusion or be deemed malicious.
-- **MUST** conform to the conventions for assetType and info.
+- **MUST** return less than or equal of *amountTokenOut* to the actual return value of the `redeem` method, and **SHOULD NOT** return greater than the actual return value of the `redeem` method.
 - **MUST NOT** revert.
 
 #### Events
@@ -334,77 +305,50 @@ event Deposit(
     address indexed receiver,
     address indexed tokenIn,
     uint256 amountDeposited,
-    uint256 amountScyOut
+    uint256 amountSyOut
 );
 ```
 
-`caller` has converted exact base tokens into SCY (shares) and transferred those SCY to `receiver`.
+`caller` has converted exact *tokenIn* tokens into SY (shares) and transferred those SY to `receiver`.
 
-- **MUST** be emitted when base tokens are deposited into the SCY contract via `deposit` method.
+- **MUST** be emitted when input tokens are deposited into the SY contract via `deposit` method.
 
 ```solidity
 event Redeem(
     address indexed caller,
     address indexed receiver,
     address indexed tokenOut,
-    uint256 amountScyToRedeem,
+    uint256 amountSyToRedeem,
     uint256 amountTokenOut
 );
 ```
 
-`caller` has converted exact SCY (shares) into base tokens and transferred those base tokens to `receiver`.
-
-- **MUST** be emitted when base tokens are redeemed from the SCY contract via `redeem` method.
-
-```solidity
-event ClaimRewards(
-    address indexed caller,
-    address indexed user,
-    address[] rewardTokens,
-    uint256[] rewardAmounts
-);
-```
-
-`caller` has claimed user rewards and transferred them to the user.
+`caller` has converted exact SY (shares) into input tokens and transferred those input tokens to `receiver`.
 
-- **MUST** be emitted when rewards are claimed from the SCY contract via `claimRewards` method.
+- **MUST** be emitted when input tokens are redeemed from the SY contract via `redeem` method.
 
-```solidity
-event ExchangeRateUpdated(uint256 oldExchangeRate, uint256 newExchangeRate);
-```
+**"SY" Word Choice:**
 
-The `exchangeRateCurrent` is updated to the latest exchange rate.
-
-- **MUST** be emitted when the exchange rate is updated in the SCY contract via `exchangeRateCurrent` method.
-
-**"SCY" Word Choice:**
-
-"SCY" (pronunciation: */sʌɪ/*), an abbreviation of Super Composable Yield, was found to be appropriate to describe a broad universe of composable yield-bearing digital assets.
+"SY" (pronunciation: */sʌɪ/*), an abbreviation of Standardized Yield, was found to be appropriate to describe a broad universe of standardized composable yield-bearing digital assets.
 
 ## Rationale
 
-[EIP-20](./eip-20.md) is enforced because implementation details such as transfer, token approvals, and balance calculation directly carry over to the SCY tokens. This standardization makes the SCY tokens immediately compatible with all EIP-20 use cases.
+[EIP-20](./eip-20.md) is enforced because implementation details such as transfer, token approvals, and balance calculation directly carry over to the SY tokens. This standardization makes the SY tokens immediately compatible with all EIP-20 use cases.
 
-[EIP-165](./eip-165.md) is not explicitly mentioned to be supported as there are no optional methods in this standard. It is expected for all methods defined in the interface to be implemented.
+[EIP-165](./eip-165.md) can optionally be implemented should you want integrations to detect the IStandardizedYield interface implementation.
 
-[EIP-2612](./eip-2612.md) can optionally be implemented in order to improve the UX of approving SCY tokens on various integrations.
-
-The `exchangeRateStored` read-only method serves as a rough estimate of the prevalent exchange rate since the last update. It is included for frontends, wallets, and applications that need an estimate on the exchange rate of SCY tokens into assets, not an exact value possibly including slippage or other fees as this would require them doing a state update and spending gas. For applications that need an exact exchange rate, the `exchangeRateCurrent` mutable function can be used.
+[EIP-2612](./eip-2612.md) can optionally be implemented in order to improve the UX of approving SY tokens on various integrations.
 
 ## Backwards Compatibility
 
-This EIP is fully backwards compatible as its implementation extends the functionality of [EIP-20](./eip-20.md), however the optional metadata extensions, namely `name`, `decimals`, and `symbol` semantics MUST be implemented for all SCY token implementations.
+This EIP is fully backwards compatible as its implementation extends the functionality of [EIP-20](./eip-20.md), however the optional metadata extensions, namely `name`, `decimals`, and `symbol` semantics MUST be implemented for all SY token implementations.
 
 ## Security Considerations
 
 Malicious implementations which conform to the interface can put users at risk. It is recommended that all integrators (such as wallets, aggregators, or other smart contract protocols) review the implementation to avoid possible exploits and users losing funds.
 
-The method `exchangeRateStored` returns an outdated estimated value and does not confer the exact current exchange rate of asset per share. Should accuracy be needed, `exchangeRateCurrent` should be used instead (which additionally updates `exchangeRateStored`.)
-
-`decimals` in `assetInfo` must strongly reflect the underlying asset’s decimals if at all possible in order to eliminate any possible source of confusion or be deemed malicious.
-
-`yieldToken` must strongly reflect the address of the underlying wrapped yield-generating token. For a native implementation wherein the SCY token does not wrap a yield-generating token, but natively represents a GYGP share, then the address returned MAY be a zero address. Otherwise, for wrapped tokens, you may introduce confusion on what the SCY token represents, or may be deemed malicious.
+`yieldToken` must strongly reflect the address of the underlying wrapped yield-bearing token. For a native implementation wherein the SY token does not wrap a yield-bearing token, but natively represents a GYGP share, then the address returned MAY be a zero address. Otherwise, for wrapped tokens, you may introduce confusion on what the SY token represents, or may be deemed malicious.
 
 ## Copyright
 
-Copyright and related rights waived via [CC0](../LICENSE.md).
\ No newline at end of file
+Copyright and related rights waived via [CC0](../LICENSE.md).

From d64f4c046b628cc78375c275ed5c2ab591c0503b Mon Sep 17 00:00:00 2001
From: Anton Buenavista <ay.buenavista@gmail.com>
Date: Thu, 22 Dec 2022 14:37:35 -0500
Subject: [PATCH 072/274] Update EIP-5115: Minor correction on interface
 (#6208)

---
 EIPS/eip-5115.md | 5 -----
 1 file changed, 5 deletions(-)

diff --git a/EIPS/eip-5115.md b/EIPS/eip-5115.md
index e86ef8a1a3c539..d93052455f2a34 100644
--- a/EIPS/eip-5115.md
+++ b/EIPS/eip-5115.md
@@ -127,11 +127,6 @@ On top of the definitions above for GYGPs, we need to define 2 more concepts:
 
 ```solidity
 interface IStandardizedYield {
-    enum AssetType {
-        TOKEN,
-        LIQUIDITY
-    }
-
     event Deposit(
         address indexed caller,
         address indexed receiver,

From 4edf0d10a324abee0417c3a8527d826e9811309d Mon Sep 17 00:00:00 2001
From: taek <leekt216@gmail.com>
Date: Fri, 23 Dec 2022 09:03:56 +0900
Subject: [PATCH 073/274] Update eip-4337.md : typo desribed -> described
 (#6169)

---
 EIPS/eip-4337.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4337.md b/EIPS/eip-4337.md
index bbfb8c01336497..474d9fae853805 100644
--- a/EIPS/eip-4337.md
+++ b/EIPS/eip-4337.md
@@ -38,7 +38,7 @@ This proposal takes a different approach, avoiding any adjustments to the consen
 
 * **UserOperation** - a structure that describes a transaction to be sent on behalf of a user. To avoid confusion, it is named "transaction".
   * Like a transaction, it contains "sender", "to", "calldata", "maxFeePerGas", "maxPriorityFee", "signature", "nonce"
-  * unlike transaction, it contains several other fields, desribed below
+  * unlike transaction, it contains several other fields, described below
   * also, the "nonce" and "signature" fields usage is not defined by the protocol, but by each account implementation
 * **Sender** - the account contract sending a user operation.
 * **EntryPoint** - a singleton contract to execute bundles of UserOperations. Bundlers/Clients whitelist the supported entrypoint.

From 83beeb22ac47f2623103af8977cabfcb66908afa Mon Sep 17 00:00:00 2001
From: lightclient <14004106+lightclient@users.noreply.github.com>
Date: Fri, 23 Dec 2022 02:30:36 -0700
Subject: [PATCH 074/274] clarify that initcode which fails validation still
 pays 3860 initcode cost (#6210)

---
 EIPS/eip-3540.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-3540.md b/EIPS/eip-3540.md
index 05e40a0dd026bd..951492eaf5a37a 100644
--- a/EIPS/eip-3540.md
+++ b/EIPS/eip-3540.md
@@ -163,7 +163,7 @@ For clarity, the *container* refers to the complete account code, while *code* r
 3. `PC` returns the current position within the *code*.
 4. `CODECOPY`/`CODESIZE`/`EXTCODECOPY`/`EXTCODESIZE`/`EXTCODEHASH` keeps operating on the entire *container*.
 5. The input to `CREATE`/`CREATE2` is still the entire *container*.
-6. The size limit for deployed code as specified in [EIP-170](./eip-170.md) and for init code as specified in [EIP-3860](./eip-3860.md) is applied to the entire *container* size, not to the *code* size.
+6. The size limit for deployed code as specified in [EIP-170](./eip-170.md) and for initcode as specified in [EIP-3860](./eip-3860.md) is applied to the entire *container* size, not to the *code* size. This also means if initcode validation fails, it is still charged the EIP-3860 `initcode_cost`.
 
 (*Remark:* Due to [EIP-4750](./eip-4750.md), `JUMP` and `JUMPI` are disabled and therefore are not discussed in relation to EOF.)
 

From 4e5cd9fe6dd168165a7a5cfef68ead439ef27f17 Mon Sep 17 00:00:00 2001
From: lightclient <14004106+lightclient@users.noreply.github.com>
Date: Fri, 23 Dec 2022 02:57:00 -0700
Subject: [PATCH 075/274] remove pc instruction from eof (#6209)

---
 EIPS/eip-4200.md | 2 +-
 EIPS/eip-4750.md | 4 +++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-4200.md b/EIPS/eip-4200.md
index 828973d6a6a9e8..fc744bc6636c39 100644
--- a/EIPS/eip-4200.md
+++ b/EIPS/eip-4200.md
@@ -63,7 +63,7 @@ Because the destinations are validated upfront, the cost of these instructions a
 
 We chose relative addressing in order to support code which is relocatable. This also means a code snippet can be injected. A technique seen used prior to this EIP to achieve the same goal was to inject code like `PUSHn PC ADD JUMPI`.
 
-We do not see any significant downside to relative addressing, but it also opens possibility to the deprecation of the `PC` instruction.
+We do not see any significant downside to relative addressing and it allows us to also deprecate the `PC` instruction.
 
 ### Immediate size
 
diff --git a/EIPS/eip-4750.md b/EIPS/eip-4750.md
index e3e67a7674c160..87746d15aeb59c 100644
--- a/EIPS/eip-4750.md
+++ b/EIPS/eip-4750.md
@@ -106,10 +106,12 @@ In addition to container format validation rules above, we extend code section v
 
 ### Disallowed instructions
 
-Dynamic jump instructions `JUMP` (`0x56`) and `JUMPI` (`0x57`) and invalid and their opcodes are undefined.
+Dynamic jump instructions `JUMP` (`0x56`) and `JUMPI` (`0x57`) are invalid and their opcodes are undefined.
 
 `JUMPDEST` (`0x5b`) instruction is renamed to `NOP` ("no operation") without the change in behaviour: it pops nothing and pushes nothing to data stack and has no other effects except for `PC` increment and charging 1 gas.
 
+`PC` (0x58) instruction becomes invalid and its opcode is undefined.
+
 *Note:* This change implies that JUMPDEST analysis is no longer required for EOF code.
 
 ### Execution

From af8847df2de8aac666aaf3fcabecf17827d4c1d4 Mon Sep 17 00:00:00 2001
From: Sujith Somraaj <35634175+sujithsomraaj@users.noreply.github.com>
Date: Sun, 25 Dec 2022 22:34:36 +0530
Subject: [PATCH 076/274] Add EIP-6170: Cross-Chain Messaging Interface (#6172)

* cross-chain messaging interface

* fix: markdown linter fix

* chore: updating EIP name

* Apply suggestions from code review

* chore: changing specification to natspec interface

* Update eip-6170.md

Co-authored-by: Matt Stam <mattstam@live.com>

* Update eip-6170.md

* Update eip-6170.md

* chore: remove events to discuss further

* Move file to correct folder

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Co-authored-by: Matt Stam <mattstam@live.com>
---
 EIPS/eip-6170.md | 79 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 EIPS/eip-6170.md

diff --git a/EIPS/eip-6170.md b/EIPS/eip-6170.md
new file mode 100644
index 00000000000000..48339d5a2531b4
--- /dev/null
+++ b/EIPS/eip-6170.md
@@ -0,0 +1,79 @@
+---
+eip: 6170
+title: Cross-Chain Messaging Interface
+description: A common smart contract interface for interacting with messaging protocols.
+author: Sujith Somraaj (@sujithsomraaj)
+discussions-to: https://ethereum-magicians.org/t/cross-chain-messaging-standard/12197
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-12-19
+---
+
+## Abstract
+
+This EIP standardizes an interface for cross-chain messengers, providing basic functionality to send and receive a cross-chain message (state).
+
+## Motivation
+
+Cross-chain messaging protocols lack standardization, resulting in unnecessarily complex competing implementations: Layerzero, Hyperlane & Wormhole each use a different interface. This makes integration difficult at the aggregator or plugin layer for protocols that must conform to any standards and forces each protocol to implement its adapter.
+
+Even chain-native arbitrary messaging protocols like the MATIC State Tunnel has an application-specific interface.
+
+## Specification
+
+The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
+
+Every compliant messaging tunnels must implement the following interface.
+
+``` solidity
+pragma solidity >=0.8.0;
+
+/// @title Cross-Chain Messaging interface
+/// @dev Allows seamless interchain messaging.
+/// @author Sujith Somraaj
+/// Note: Bytes are used along the entire implementation to support non-evm chains.
+
+interface EIP6170 {
+    /// @dev Sends message to a receiving address on different blockchain.
+    /// @param chainId is the unique identifier of receiving blockchain.
+    /// @param receiver is the address of the receiver.
+    /// @param message is the arbitrary message to be delivered.
+    /// @return the status of the process on the sending chain.
+    /// Note: this function is designed to support both evm and non-evm chains
+    /// Note: proposing chain-ids be the bytes encoding of their native token name string. For eg., abi.encode("ETH"), abi.encode("SOL") imagining they cannot override.
+    function sendMessage(
+        bytes memory chainId,
+        bytes memory receiver,
+        bytes memory message
+    ) external returns (bool);
+
+    /// @dev Receives message from a sender on different blockchain.
+    /// @param chainId is the unique identifier of the sending blockchain.
+    /// @param sender is the address of the sender.
+    /// @param message is the arbitrary message sent by the sender.
+    /// @return the status of message processing/storage.
+    /// Note: sender validation (or) message validation should happen before processing the message.
+    function receiveMessage(
+        bytes memory chainId,
+        bytes memory sender,
+        bytes memory message
+    ) external returns (bool);
+}
+```
+
+## Rationale
+
+The Cross-Chain interface is designed to be optimized for interoperability layer integrators with a feature-complete, yet minimal interface. Validations such as sender authentication, receiver whitelisting, relayer mechanisms and cross-chain execution overrides are intentionally not specified, as Messaging protocols are expected to be treated as black boxes on-chain and inspected off-chain before use.
+
+## Security Considerations
+
+Fully permissionless messaging could be a security threat to the protocol. It is recommended that all the integrators review the implementation of messaging tunnels before integrating.
+
+For eg., without sender authentication, anyone could write arbitrary messages into the receiving smart contract.
+
+This EIP focuses only on the way the messages should be sent and received with a specific standard. But any authentication (or) message tunnel specific operations can be implemented inside the receive function by integrators.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md)

From 63e9f33d5e4f6d180474f84ceb6f1ff761ffa9f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <pawel@hepcolgum.band>
Date: Sun, 25 Dec 2022 18:26:55 +0100
Subject: [PATCH 077/274] Ignore JetBrains project files (#6211)

---
 .gitignore | 1 +
 1 file changed, 1 insertion(+)

diff --git a/.gitignore b/.gitignore
index a8bc8dfb50d64d..8503a3cdadb0d7 100644
--- a/.gitignore
+++ b/.gitignore
@@ -7,6 +7,7 @@ vendor
 # Editor files
 .gitpod.yml
 .DS_Store
+/.idea
 
 # Secrets
 .vercel

From 95381a532d075cac0a398e5edc678de28fd513dd Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sun, 25 Dec 2022 13:01:34 -0500
Subject: [PATCH 078/274] Update EIP-5568: Move to review (#6177)

---
 EIPS/eip-5568.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5568.md b/EIPS/eip-5568.md
index dd5b21f852e697..6b18a057643051 100644
--- a/EIPS/eip-5568.md
+++ b/EIPS/eip-5568.md
@@ -4,7 +4,7 @@ title: Required Action Signals Using Revert Reasons
 description: Signal to wallets that an action is needed by returning a custom revert code
 author: Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/eip-5568-revert-signals/10622
-status: Draft
+status: Review
 type: Standards Track
 category: Interface
 created: 2022-08-31

From f5d58e6b0e4d6f0038133670a9ec1f2e71c81cde Mon Sep 17 00:00:00 2001
From: Gaurang Torvekar <gaurangtorvekar@gmail.com>
Date: Sun, 25 Dec 2022 18:21:31 +0000
Subject: [PATCH 079/274] Update EIP-5606: Move to Last Call (#6151)

* Update EIP-5606: Moving to Last Call

* Update EIP-5606: Added Last Call Deadline

* Update EIP-5606: Fixed a typo

* Update EIPS/eip-5606.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-5606.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-5606.md b/EIPS/eip-5606.md
index 0cb79857928d7f..a4307f09e8d250 100644
--- a/EIPS/eip-5606.md
+++ b/EIPS/eip-5606.md
@@ -4,7 +4,8 @@ title: Multiverse NFTs
 description: A universal representation of multiple related NFTs as a single digital asset across various platforms
 author: Gaurang Torvekar (@gaurangtorvekar), Khemraj Adhawade (@akhemraj), Nikhil Asrani (@nikhilasrani)
 discussions-to: https://ethereum-magicians.org/t/eip-5606-multiverse-nfts-for-digital-asset-interoperability/10698
-status: Review
+status: Last Call
+last-call-deadline: 2023-01-02
 type: Standards Track
 category: ERC
 created: 2022-09-06

From aa2ffec08d9e74ced887091cd88fb4a2fdd6fcc6 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sun, 25 Dec 2022 15:01:08 -0500
Subject: [PATCH 080/274] Update EIP-5219: Move to review (#6180)

* Update EIP-5219: Move to review

* Merge master into eip-5219-review (#6183)

* Update EIP-5507: Add Rationale stub (#6181)

* Update EIP-5219: Fix small typo (#6182)
---
 EIPS/eip-5219.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5219.md b/EIPS/eip-5219.md
index 47036c23a98267..4521b6fb9052fa 100644
--- a/EIPS/eip-5219.md
+++ b/EIPS/eip-5219.md
@@ -4,7 +4,7 @@ title: Contract Resource Requests
 description: Allows the requesting of resources from contracts
 author: Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/pr-5219-discussion-contract-rest/9907
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-07-10

From 4943a9ec237e8445de5063e2b3bacc82a30023c4 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sun, 25 Dec 2022 15:26:08 -0500
Subject: [PATCH 081/274] Update EIP-5380: Second Revision (#6214)

---
 EIPS/eip-5380.md | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/EIPS/eip-5380.md b/EIPS/eip-5380.md
index f4006789463342..32e996fc3e6c39 100644
--- a/EIPS/eip-5380.md
+++ b/EIPS/eip-5380.md
@@ -46,10 +46,11 @@ interface ERC721Entitlement is ERC165 {
     function maxEntitlements(address contract, uint256 tokenId) external view (uint256 max);
 
     /// @notice             Get the user associated with the given contract and tokenId.
-    /// @dev                Defaults to contract.ownerOf(tokenId)
+    /// @dev                Defaults to maxEntitlements(contract, tokenId) assigned to contract.ownerOf(tokenId)
+    /// @param  user        The user to query
     /// @param  contract    The contract to query
     /// @param  tokenId     The tokenId to query
-    function entitlementOf(address contract, uint256 tokenId) external view returns (address user);
+    function entitlementOf(address user, address contract, uint256 tokenId) external view returns (uint256 amt);
 }
 ```
 
@@ -64,11 +65,11 @@ This OPTIONAL interface is RECOMMENDED.
 pragma solidity ^0.8.0;
 
 interface ERC721EntitlementEnumerable is ERC721Entitlement /* , ERC165 */ {
-    /// @notice         Enumerate tokens assigned to a user
+    /// @notice         Enumerate tokens with nonzero entitlement assigned to a user
     /// @dev            Throws if the index is out of bounds or if user == address(0)
     /// @param  user    The user to query
     /// @param  index   A counter
-    function tokenOfUserByIndex(address user, uint256 index) external view returns (address contract, uint256 tokenId);
+    function entitlementOfUserByIndex(address user, uint256 index) external view returns (address contract, uint256 tokenId);
 }
 ```
 
@@ -84,7 +85,7 @@ No backward compatibility issues were found.
 
 ## Security Considerations
 
-Needs discussion.
+The security considerations of [EIP-721](./eip-721.md) apply.
 
 ## Copyright
 

From 9c623d3edb4682f45ff48269a7e8b44a23ae0247 Mon Sep 17 00:00:00 2001
From: Peter Kohl-Landgraf <32535675+pekola@users.noreply.github.com>
Date: Mon, 26 Dec 2022 00:23:42 +0100
Subject: [PATCH 082/274] Add EIP-6123: Smart Derivative Contract (#6123)

* added eip markdown file, interface, reference implemntation, unit tests, readme and some docs

* some minor corrections

* some minor adjustment in file naming

* improved markdown linter formatting rules

* Assign EIP-6123

* Rename eip-0000.md to eip-6123.md

* Apply suggestions from code review

* Update assets/eip-0000/contracts/SDC.sol

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update assets/eip-0000/contracts/ISDC.sol

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update assets/eip-0000/contracts/SDCToken.sol

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6123.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6123.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* - renamed asset-folder. added some more details in interface, added some aspects in reference implementation (inline)

* - minor change in sample xml, updated forum link

* - some corrections in interface doc, fixed typos in markdown

* erc20 -> ERC-20

* ERC-20 -> erc-20

* erc-20 -> EIP-20

* Added markdown link.

* Made Trade Data Spec a subsection.

* Changed section title (singular).

* Minor fix to grammar.

* Updated reference to unit tests.

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Co-authored-by: Christian Fries <email@christian-fries.de>
---
 EIPS/eip-6123.md                              | 236 +++++++++
 assets/eip-6123/README.md                     |  47 ++
 assets/eip-6123/contracts/ISDC.sol            | 190 ++++++++
 assets/eip-6123/contracts/SDC.sol             | 446 ++++++++++++++++++
 assets/eip-6123/contracts/SDCToken.sol        |  15 +
 .../doc/sample-tradedata-filestructure.xml    |  77 +++
 .../doc/sdc_livecycle_sequence_diagram.png    | Bin 0 -> 182042 bytes
 .../doc/sdc_trade_and_process_states.png      | Bin 0 -> 82437 bytes
 assets/eip-6123/test/SDC.js                   | 128 +++++
 9 files changed, 1139 insertions(+)
 create mode 100644 EIPS/eip-6123.md
 create mode 100644 assets/eip-6123/README.md
 create mode 100644 assets/eip-6123/contracts/ISDC.sol
 create mode 100644 assets/eip-6123/contracts/SDC.sol
 create mode 100644 assets/eip-6123/contracts/SDCToken.sol
 create mode 100644 assets/eip-6123/doc/sample-tradedata-filestructure.xml
 create mode 100644 assets/eip-6123/doc/sdc_livecycle_sequence_diagram.png
 create mode 100644 assets/eip-6123/doc/sdc_trade_and_process_states.png
 create mode 100644 assets/eip-6123/test/SDC.js

diff --git a/EIPS/eip-6123.md b/EIPS/eip-6123.md
new file mode 100644
index 00000000000000..be7f54b0e883d9
--- /dev/null
+++ b/EIPS/eip-6123.md
@@ -0,0 +1,236 @@
+---
+eip: 6123
+title: Smart Derivative Contract
+description: A deterministic protocol for frictionless post-trade processing of OTC financial contracts
+author: Christian Fries (@cfries), Peter Kohl-Landgraf (@pekola), Alexandros Korpis (@kourouta)
+discussions-to: https://ethereum-magicians.org/t/eip-6123-smart-derivative-contract-frictionless-processing-of-financial-derivatives/12134
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-12-13
+---
+
+## Abstract
+
+The Smart Derivative Contract is a deterministic protocol to trade and process 
+financial derivative contracts frictionless and scalable in a completely automated way. Counterparty credit risk ís removed. 
+Known operational risks and complexities in post-trade processing are removed by construction as all process states 
+are fully specified and are known to the counterparties.
+
+## Motivation
+
+### Rethinking Financial Derivatives
+
+By their very nature, so-called "over-the-counter (OTC)" financial contracts are bilateral contractual agreements on the exchange of long-dated cash flow schedules.
+Since these contracts change their intrinsic market value due to changing market environments, they are subject to counterparty credit risk when one counterparty is subject to default.
+The initial white paper describes the concept of a Smart Derivative Contract with the central aim 
+to detach bilateral financial transactions from counterparty credit risk and to remove complexities 
+in bilateral post-trade processing by a complete redesign.
+
+### Concept of a Smart Derivative Contract
+
+A Smart Derivative Contract is a deterministic settlement protocol which has the same economic behaviour as a collateralized OTC
+Derivative. Every process state is specified; therefore, the entire post-trade process is known in advance.
+A Smart Derivative Contract (SDC) settles outstanding net present value of the underlying financial contract on a frequent basis. With each settlement cycle net present value of the underlying contract is
+exchanged, and the value of the contract is reset to zero. Pre-Agreed margin buffers are locked at the beginning of each settlement cycle such that settlement will be guaranteed up to a certain amount. 
+If a counterparty fails to obey contract rules, e.g. not provide sufficient prefunding, SDC will terminate automatically with the guaranteed transfer of a termination fee by the causing party.
+These features enable two counterparties to process their financial contract fully decentralized without relying on a third central intermediary agent.
+The process logic of SDC can be implemented as a finite state machine on solidity. An [EIP-20](./eip-20.md) token can be used for frictionless decentralized settlement, see reference implementation.
+Combined with an appropriate external market data and valuation oracle which calculates net present values, each known OTC derivative contract is able to be processed using this standard protocol.
+
+
+## Specification
+
+### Methods
+
+The following methods specify  inception and post-trade live cycle of a Smart Derivative Contract. For futher information also please look at the interface documentation ISDC.sol.
+
+#### inceptTrade
+
+A counterparty can initiate a trade by providing trade data as string and calling inceptTrade and initial settlement data. Only registered counteparties are allowed to use that function.
+
+```solidity
+function inceptTrade(string memory _tradeData, string memory _initialSettlementData) external;
+```
+
+#### confirmTrade
+
+A counterparty can confirm a trade by providing the identical trade data and initial settlement information, which are already stored from inceptTrade call.
+
+```solidity
+function confirmTrade(string memory _tradeData, string memory _initialSettlementData) external;
+```
+
+#### initiatePrefunding
+
+This method checks whether contractual prefunding is provided by both counterparties as agreed in the contract terms. Triggers a contract termination if not. 
+
+```solidity
+function initiatePrefunding() external;
+```
+
+#### initiateSettlement
+
+Allows eligible participants (such as counterparties or a delegated agent) to initiate a settlement.
+
+```solidity
+function initiateSettlement() external;
+```
+
+#### performSettlement
+
+Valuation may be provided off-chain via an external oracle service that calculates net present value and uses external market data. 
+Method serves as callback called from an external oracle providing settlement amount and used settlement data which also get stored.
+Settlement amount will be checked according to contract terms resulting in either a reqular settlement or a termination of the trade.
+
+```solidity
+function performSettlement(int256 settlementAmount, string memory settlementData) external;
+```
+
+#### requestTermination
+
+Allows an eligible party to request a mutual termination
+
+```js
+function requestTradeTermination(string memory tradeId) external;
+```
+
+#### confirmTradeTermination
+
+Allows eligible parties to confirm a formerly-requested mutual trade termination.
+
+```solidity
+function confirmTradeTermination(string memory tradeId) external;
+```
+
+### Trade Events
+
+The following events are emitted during an SDC trade livecycle.
+
+#### TradeIncepted
+
+Emitted on trade inception - method 'inceptTrade'
+
+```solidity
+event TradeIncepted(address initiator, string tradeId, string tradeData);
+```
+
+#### TradeConfirmed
+
+Emitted on trade confirmation - method 'confirmTrade'
+
+```solidity
+event TradeConfirmed(address confirmer, string tradeId);
+```
+
+#### TradeActivated
+
+Emitted when trade is activated
+
+```solidity
+event TradeActivated(string tradeId);
+```
+
+#### TradeTerminationRequest
+
+Emitted when termination request is initiated by a counterparty
+
+```solidity
+event TradeTerminationRequest(address cpAddress, string tradeId);
+```
+
+#### TradeTerminationConfirmed
+
+Emitted when termination request is confirmed by a counterparty
+
+```solidity
+event TradeTerminationConfirmed(address cpAddress, string tradeId);
+```
+
+#### TradeTerminated
+
+Emitted when trade is terminated
+
+```solidity
+event TradeTerminated(string cause);
+```
+
+### Process Events
+
+The following events are emitted during SDC's process livecycle.
+
+#### ProcessAwaitingFunding
+
+Emitted when funding phase is initiated
+
+```solidity
+event ProcessAwaitingFunding();
+```
+
+#### ProcessFunded
+
+Emitted when funding has completed successfully - method 'initiatePrefunding'
+
+```solidity
+event ProcessFunded();
+```
+
+#### ProcessSettlementRequest
+
+Emitted when a settlement is initiated - method 'initiateSettlement'
+
+```solidity
+event ProcessSettlementRequest(string tradeData, string lastSettlementData);
+```
+
+#### ProcessSettled
+
+Emitted when settlement was processed successfully - method 'performSettlement'
+
+```solidity
+event ProcessSettled();
+```
+
+## Rationale
+
+The interface design and reference implementation are based on the following considerations:
+
+- A SDC protocol is supposed to be used by two counterparties and enables them to initiate and process a derivative transaction in a bilateral and digital manner.
+- The provided interface specification is supposed to completely reflect the entire trade livecycle.
+- The interface specification is generic enough to handle the case that two counterparties process one or even multiple derivative transactions (on a netted base)
+- Usually, the valuation of an OTC trade will require advanced valuation methodology. This is why the concept will in most cases rely on external market data and valuation algorithms
+- A pull-based valuation based oracle pattern is specified by a simple callback pattern (methods: initiateSettlement, performSettlement)
+- The reference implementation `SDC.sol` is based on a state-machine pattern where the states also serve as guards (via modifiers) to check which method is allowed to be called at a particular given process and trade state
+- Java based state machine and contract implementations are also available. See the github repo link below.
+
+### State diagram of trade and process states 
+
+![image info](../assets/eip-6123/doc/sdc_trade_and_process_states.png)
+
+### Sequence diagram of trade initiation and settlement livecycle
+
+![image info](../assets/eip-6123/doc/sdc_livecycle_sequence_diagram.png)
+
+## Test Cases
+
+Live-cycle unit tests based on the sample implementation and usage of [EIP-20](./eip-20.md) token is provided. See file [test/SDC.js](../assets/eip-6123/test/SDC.js)
+).
+
+## Reference Implementation
+
+A reference implementation SDC.sol is provided and is based on the [EIP-20](./eip-20.md) token standard. 
+See folder /assets/contracts, more explanation on the implementation is provided inline.
+
+### Trade Data Specification (suggestion)
+
+Please take a look at the provided xml file as a suggestion on how trade parameters could be stored.
+
+## Security Considerations
+
+No known security issues up to now.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
+
+
diff --git a/assets/eip-6123/README.md b/assets/eip-6123/README.md
new file mode 100644
index 00000000000000..2bf456a68bda04
--- /dev/null
+++ b/assets/eip-6123/README.md
@@ -0,0 +1,47 @@
+# SDC Solidity implementation
+
+## Description
+This sdc implementation aims to implement process logic in a very lean way using an integrative solidity implementation and according unit tests
+
+### Provided Contracts and Tests
+- `contracts/ISDC.sol` - Interface contract
+- `contracts/SDC.sol` - SDC reference implementation contract
+- `contracts/SDCToken.sol` - Mintable token contract for unit tests
+- `test/SDC.js` - Unit tests for livecycle of sdc implementation 
+
+### Used javascript based testing libraries for solidity
+- `ethereum-waffle`: Waffle is a Solidity testing library. It allows you to write tests for your contracts with JavaScript.
+- `chai`: Chai is an assertion library and provides functions like expect.
+- `ethers`: This is a popular Ethereum client library. It allows you to interface with blockchains that implement the Ethereum API.
+- `solidity-coverage`: This library gives you coverage reports on unit tests with the help of Istanbul.
+
+### Compile and run tests with hardhat
+We provide the essential steps to compile the contracts and run provided unit tests
+Check that you have the latest version of npm and node via `npm -version` (should be better than 8.5.0) and `node -v` (should be better than 16.14.2).
+
+1. Check out project
+2. Go to folder and initialise a new npm project: `npm init -y`. A basic `package.json` file should occur
+3. Install Hardhat as local solidity dev environment: `npx hardhat`
+4. Select following option: Create an empty hardhat.config.js
+5. Install Hardhat as a development dependency: `npm install --save-dev hardhat`
+6. Install further testing dependencies:
+`npm install --save-dev @nomiclabs/hardhat-waffle @nomiclabs/hardhat-ethers ethereum-waffle chai  ethers solidity-coverage`
+7. Install open zeppelin contracts: `npm install @openzeppelin/contracts`
+8. add plugins to hardhat.config.ts: 
+```
+require("@nomiclabs/hardhat-waffle"); 
+require('solidity-coverage');
+```
+
+9. Adding commands to `package.json`:
+``` 
+"scripts": {
+    "build": "hardhat compile",
+    "test:light": "hardhat test",
+    "test": "hardhat coverage"
+  },
+```
+9. run `npm run build`
+10. run `npm run test`
+
+
diff --git a/assets/eip-6123/contracts/ISDC.sol b/assets/eip-6123/contracts/ISDC.sol
new file mode 100644
index 00000000000000..3353ec4e68b04a
--- /dev/null
+++ b/assets/eip-6123/contracts/ISDC.sol
@@ -0,0 +1,190 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity >=0.7.0 <0.9.0;
+
+/*------------------------------------------- DESCRIPTION ---------------------------------------------------------------------------------------*/
+
+/**
+ * @title ERC6123 Smart Derivative Contract
+ * @dev Interface specification for a Smart Derivative Contract, which specifies the post-trade live cycle of an OTC financial derivative in a completely deterministic way.
+ * Counterparty Risk is removed by construction.
+ *
+ * A Smart Derivative Contract is a deterministic settlement protocol which has economically the same behaviour as a collateralized OTC financial derivative.
+ * It aims is to remove many inefficiencies in collateralized OTC transactions and remove counterparty credit risk by construction.
+ *
+ * In contrast to a collateralized derivative contract based and collateral flows are netted. As result, the smart derivative contract generates a stream of
+ * reflecting the settlement of a referenced underlying. The settlement cash flows may be daily (which is the standard frequency in traditional markets)
+ * or at higher frequencies.
+ * With each settlement flow the change is the (discounting adjusted) net present value of the underlying contract is exchanged and the value of the contract is reset to zero.
+ *
+ * To automatically process settlement, counterparties need to provide sufficient prefunded margin amounts and termination fees at the
+ * beginning of each settlement cycle. Through a settlement cycle the margin amounts are locked. Simplified, the contract reverts the classical scheme of
+ * 1) underlying valuation, then 2) funding of a margin call to
+ * 1) pre-funding of a margin buffer (a token), then 2) settlement.
+ *
+ * A SDC automatically terminates the derivatives contract if there is insufficient pre-funding or if the settlement amount exceeds a
+ * prefunded margin balance. Beyond mutual termination is also intended by the function specification.
+ *
+ * Events and Functionality specify the entire live cycle: TradeInception, TradeConfirmation, TradeTermination, Margin-Account-Mechanics, Valuation and Settlement.
+ *
+ * The process can be described by time points and time-intervals which are associated with well defined states:
+ * <ol>
+ *  <li>t < T* (befrore incept).
+ *  </li>
+ *  <li>
+ *      The process runs in cycles. Let i = 0,1,2,... denote the index of the cycle. Within each cycle there are times
+ *      T_{i,0}, T_{i,1}, T_{i,2}, T_{i,3} with T_{i,1} = pre-funding of the Smart Contract, T_{i,2} = request valuation from oracle, T_{i,3} = perform settlement on given valuation, T_{i+1,0} = T_{i,3}.
+ *  </li>
+ *  <li>
+ *      Given this time discretization the states are assigned to time points and time intervalls:
+ *      <dl>
+ *          <dt>Idle</dt>
+ *          <dd>Before incept or after terminate</dd>
+ *
+ *          <dt>Initiation</dt>
+ *          <dd>T* < t < T_{0}, where T* is time of incept and T_{0} = T_{0,0}</dd>
+ *
+ *          <dt>AwaitingFunding</dt>
+ *          <dd>T_{i,0} < t < T_{i,1}</dd>
+ *
+ *          <dt>Funding</dt>
+ *          <dd>t = T_{i,1}</dd>
+ *
+ *          <dt>AwaitingSettlement</dt>
+ *          <dd>T_{i,1} < t < T_{i,2}</dd>
+ *
+ *          <dt>ValuationAndSettlement</dt>
+ *          <dd>T_{i,2} < t < T_{i,3}</dd>
+ *
+ *          <dt>Settled</dt>
+ *          <dd>t = T_{i,3}</dd>
+ *      </dl>
+ *  </li>
+ * </ol>
+ */
+
+interface ISDC {
+    /*------------------------------------------- EVENTS ---------------------------------------------------------------------------------------*/
+    /**
+     * @dev Emitted  when a new trade is incepted from a eligible counterparty
+     * @param initiator is the address from which trade was incepted
+     * @param tradeID is the tradeID (e.g. generated internally)
+     * @param tradeData holding the trade parameters
+     */
+    event TradeIncepted(address initiator, string tradeId, string tradeData);
+
+    /**
+     * @dev Emitted when an incepted trade is confirmed by the opposite counterparty
+     * @param confirmer the confirming party
+     * @param tradeId the trade identifier
+     */
+    event TradeConfirmed(address confirmer, string tradeId);
+
+    /**
+     * @dev Emitted when a confirmed trade is set to active - e.g. when termination fee amounts are provided
+     * @param tradeId the trade identifier of the activated trade
+     */
+    event TradeActivated(string tradeId);
+
+    /**
+     * @dev Emitted when an active trade is terminated
+     * @param cause string holding the cause of the termination
+     */
+    event TradeTerminated(string cause);
+
+    /**
+     * @dev Emitted when funding phase is initiated
+     */
+    event ProcessAwaitingFunding();
+
+    /**
+     * @dev Emitted when margin balance was updated and sufficient funding is provided
+     */
+    event ProcessFunded();
+
+    /**
+     * @dev Emitted when a valuation and settlement is requested
+     * @param tradeData holding the stored trade data
+     * @param lastSettlementData holding the settlementdata from previous settlement (next settlement will be the increment of next valuation compared to former valuation)
+     */
+    event ProcessSettlementRequest(string tradeData, string lastSettlementData);
+
+    /**
+     * @dev Emitted when a settlement was processed succesfully
+     */
+    event ProcessSettled();
+
+    /**
+     * @dev Emitted when a counterparty proactively requests an early termination of the underlying trade
+     * @param cpAddress the address of the requesting party
+     * @param tradeID the trade identifier which is supposed to be terminated
+     */
+    event TradeTerminationRequest(address cpAddress, string tradeId);
+
+    /**
+     * @dev Emitted when early termination request is confirmed by the opposite party
+     * @param cpAddress the party which confirms the trade termination
+     * @param tradeID the trade identifier which is supposed to be terminated
+     */
+    event TradeTerminationConfirmed(address cpAddress, string tradeId);
+
+    /*------------------------------------------- FUNCTIONALITY ---------------------------------------------------------------------------------------*/
+
+    /// Trade Inception
+
+    /**
+     * @notice Handles trade inception, stores trade data
+     * @dev emits a {TradeIncepted} event
+     * @param _tradeData a description of the trade specification e.g. in xml format, suggested structure - see assets/eip-6123/doc/sample-tradedata-filestructure.xml
+     * @param _initialSettlementData the initial settlement data (e.g. initial market data at which trade was incepted)
+     */
+    function inceptTrade(string memory _tradeData, string memory _initialSettlementData) external;
+
+    /**
+     * @notice Performs a matching of provided trade data and settlement data
+     * @dev emits a {TradeConfirmed} event if trade data match
+     * @param _tradeData a description of the trade in sdc.xml, e.g. in xml format, suggested structure - see assets/eip-6123/doc/sample-tradedata-filestructure.xml
+     * @param _initialSettlementData the initial settlement data (e.g. initial market data at which trade was incepted)
+     */
+    function confirmTrade(string memory _tradeData, string memory _initialSettlementData) external;
+
+    /// Settlement Cycle: Prefunding
+
+    /**
+     * @notice Called from outside to check and secure pre-funding. Terminate the trade if prefunding fails.
+     * @dev emits a {ProcessFunded} event if prefunding check is successful or a {TradeTerminated} event if prefunding check fails
+     */
+    function initiatePrefunding() external;
+
+    /// Settlement Cycle: Settlement
+
+    /**
+     * @notice Called to trigger a (maybe external) valuation of the underlying contract and afterwards the according settlement process
+     * @dev emits a {ProcessSettlementRequest}
+     */
+    function initiateSettlement() external;
+
+    /**
+     * @notice Called from outside to trigger according settlement on chain-balances callback for initiateSettlement() event handler
+     * @dev emits a {ProcessSettled} if settlement is successful or {TradeTerminated} if settlement fails
+     * @param settlementAmount the settlement amount. If settlementAmount > 0 then receivingParty receives this amount from other party. If settlementAmount < 0 then other party receives -settlementAmount from receivingParty.
+     * @param settlementData. the tripple (product, previousSettlementData, settlementData) determines the settlementAmount.
+     */
+    function performSettlement(int256 settlementAmount, string memory settlementData) external;
+
+    /// Trade termination
+
+    /**
+     * @notice Called from a counterparty to request a mutual termination
+     * @dev emits a {TradeTerminationRequest}
+     * @param tradeID the trade identifier which is supposed to be terminated
+     */
+    function requestTradeTermination(string memory tradeId) external;
+
+    /**
+     * @notice Called from a counterparty to confirm a termination, which will triggers a final settlement before trade gets inactive
+     * @dev emits a {TradeTerminationConfirmed}
+     * @param tradeID the trade identifier of the trade which is supposed to be terminated
+     */
+    function confirmTradeTermination(string memory tradeId) external;
+}
+
diff --git a/assets/eip-6123/contracts/SDC.sol b/assets/eip-6123/contracts/SDC.sol
new file mode 100644
index 00000000000000..9c1cf84f4faea5
--- /dev/null
+++ b/assets/eip-6123/contracts/SDC.sol
@@ -0,0 +1,446 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity >=0.8.0 <0.9.0;
+
+import "./ISDC.sol";
+import "@openzeppelin/contracts/token/ERC20/IERC20.sol";
+import "@openzeppelin/contracts/utils/Strings.sol";
+
+
+/**
+ * @title Reference Implementation of ERC6123 - Smart Derivative Contract
+ * @notice This reference implementation is based on a finite state machine with predefined trade and process states (see enums below)
+ * Some comments on the implementation:
+ * - trade and process states are used in modifiers to check which function is able to be called at which state
+ * - trade data are stored in the contract
+ * - trade data matching is done in incept and confirm routine (comparing the hash of the provided data)
+ * - ERC-20 token is used for three participants: counterparty1 and counterparty2 and sdc
+ * - when prefunding is done sdc contract will hold agreed amounts and perform settlement on those
+ * - sdc also keeps track on internal balances for each counterparty
+ * - during prefunding sdc will transfer required amounts to its own balance - therefore sufficient approval is needed
+ * - upon termination all remaining 'locked' amounts will be transferred back to the counterparties
+*/
+
+contract SDC is ISDC {
+    /*
+     * Trade States
+     */
+    enum TradeState {
+
+        /*
+         * State before the trade is incepted.
+         */
+        Inactive,
+
+        /*
+         * Incepted: Trade data submitted by one party. Market data for initial valuation is set.
+         */
+        Incepted,
+
+        /*
+         * Confirmed: Trade data accepted by other party.
+         */
+        Confirmed,
+
+        /*
+         * Active (Confirmend + Prefunded Termination Fees). Will cycle through process states.
+         */
+        Active,
+
+        /*
+         * Terminated.
+         */
+        Terminated
+    }
+
+    /*
+     * Process States. t < T* (vor incept). The process runs in cycles. Let i = 0,1,2,... denote the index of the cycle. Within each cycle there are times
+     * T_{i,0}, T_{i,1}, T_{i,2}, T_{i,3} with T_{i,1} = pre-funding of the Smart Contract, T_{i,2} = request valuation from oracle, T_{i,3} = perform settlement on given valuation, T_{i+1,0} = T_{i,3}.
+     * Given this time discretization the states are assigned to time points and time intervalls:
+     * Idle: Before incept or after terminate
+     * Initiation: T* < t < T_{0}, where T* is time of incept and T_{0} = T_{0,0}
+     * AwaitingFunding: T_{i,0} < t < T_{i,1}
+     * Funding: t = T_{i,1}
+     * AwaitingSettlement: T_{i,1} < t < T_{i,2}
+     * ValuationAndSettlement: T_{i,2} < t < T_{i,3}
+     * Settled: t = T_{i,3}
+     */
+    enum ProcessState {
+        /**
+         * @dev The process has not yet started or is terminated
+         */
+        Idle,
+        /*
+         * @dev The process is initiated (incepted, but not yet completed confimation). Next: AwaitingFunding
+         */
+        Initiation,
+        /*
+         * @dev Awaiiting preparation for funding the smart contract. Next: Funding
+         */
+        AwaitingFunding,
+        /*
+         * @dev Prefunding the smart contract. Next: AwaitingSettlement
+         */
+        Funding,
+        /*
+         * @dev The smart contract is completely funded and awaits settlement. Next: ValuationAndSettlement
+         */
+        Funded,
+        /*
+         * @dev The settlement process is initiated. Next: Settled or InTermination
+         */
+        ValuationAndSettlement,
+        /*
+         * @dev Termination started.
+         */
+        InTermination
+    }
+
+    struct MarginRequirement {
+        int256 buffer;
+        int256 terminationFee;
+    }
+
+    /*
+     * Modifiers serve as guards whether at a specific process state a specific function can be called
+     */
+
+    modifier onlyCounterparty() {
+        require(msg.sender == party1 || msg.sender == party2, "You are not a counterparty."); _;
+    }
+    modifier onlyWhenTradeInactive() {
+        require(tradeState == TradeState.Inactive, "Trade state is not 'Inactive'."); _;
+    }
+    modifier onlyWhenTradeIncepted() {
+        require(tradeState == TradeState.Incepted, "Trade state is not 'Incepted'."); _;
+    }
+    modifier onlyWhenProcessAwaitingFunding() {
+        require(processState == ProcessState.AwaitingFunding, "Process state is not 'AwaitingFunding'."); _;
+    }
+    modifier onlyWhenProcessFundedAndTradeActive() {
+        require(processState == ProcessState.Funded && tradeState == TradeState.Active, "Process state is not 'Funded' or Trade is not 'Active'."); _;
+    }
+    modifier onlyWhenProcessValuationAndSettlement() {
+        require(processState == ProcessState.ValuationAndSettlement, "Process state is not 'ValuationAndSettlement'."); _;
+    }
+    TradeState private tradeState;
+    ProcessState private processState;
+
+    address public party1;
+    address public party2;
+    address private immutable receivingPartyAddress; // Determine the receiver: Positive values are consider to be received by receivingPartyAddress. Negative values are received by the other counterparty.
+
+    /*
+     * liquidityToken holds:
+     * - funding account of party1
+     * - funding account of party2
+     * - account for SDC (sum - this is split among parties by sdcBalances)
+     */
+    IERC20 private liquidityToken;
+
+    string private tradeID;
+    string private tradeData;
+    string private lastSettlementData;
+
+    mapping(address => MarginRequirement) private marginRequirements; // Storage of M and P per counterparty address
+    mapping(uint256 => address) private pendingRequests; // Stores open request hashes for several requests: initiation, update and termination
+
+    mapping(address => int256) private sdcBalances; // internal book-keeping: needed to track what part of the gross token balance is held for each party
+
+
+    bool private mutuallyTerminated = false;
+
+    constructor(
+        address counterparty1,
+        address counterparty2,
+        address receivingParty,
+        address tokenAddress,
+        uint256 initialMarginRequirement,
+        uint256 initalTerminationFee
+    ) {
+        party1 = counterparty1;
+        party2 = counterparty2;
+        receivingPartyAddress = receivingParty;
+        liquidityToken = IERC20(tokenAddress);
+        tradeState = TradeState.Inactive;
+        processState = ProcessState.Idle;
+        marginRequirements[party1] = MarginRequirement(int256(initialMarginRequirement), int256(initalTerminationFee));
+        marginRequirements[party2] = MarginRequirement(int256(initialMarginRequirement), int256(initalTerminationFee));
+        sdcBalances[party1] = 0;
+        sdcBalances[party2] = 0;
+    }
+
+    /*
+     * generates a hash from tradeData and generates a map entry in openRequests
+     * emits a TradeIncepted
+     * can be called only when TradeState = Incepted
+     */
+    function inceptTrade(string memory _tradeData, string memory _initialSettlementData) external override onlyCounterparty onlyWhenTradeInactive
+    {
+        processState = ProcessState.Initiation;
+        tradeState = TradeState.Incepted; // Set TradeState to Incepted
+
+        uint256 hash = uint256(keccak256(abi.encode(_tradeData, _initialSettlementData)));
+        pendingRequests[hash] = msg.sender;
+        tradeID = Strings.toString(hash);
+        tradeData = _tradeData; // Set Trade Data to enable querying already in inception state
+
+        emit TradeIncepted(msg.sender, tradeID, _tradeData);
+    }
+
+    /*
+     * generates a hash from tradeData and checks whether an open request can be found by the opposite party
+     * if so, data are stored and open request is deleted
+     * emits a TradeConfirmed
+     * can be called only when TradeState = Incepted
+     */
+    function confirmTrade(string memory _tradeData, string memory _initialSettlementData) external override onlyCounterparty onlyWhenTradeIncepted
+    {
+        address pendingRequestParty = msg.sender == party1 ? party2 : party1;
+        uint256 tradeIDConf = uint256(keccak256(abi.encode(_tradeData, _initialSettlementData)));
+        require(pendingRequests[tradeIDConf] == pendingRequestParty, "Confirmation fails due to inconsistent trade data or wrong party address");
+        delete pendingRequests[tradeIDConf]; // Delete Pending Request
+
+        tradeState = TradeState.Confirmed;
+        emit TradeConfirmed(msg.sender, tradeID);
+
+        // Pre-Conditions
+        if(_lockTerminationFees()) {
+            tradeState = TradeState.Active;
+            emit TradeActivated(tradeID);
+
+            processState = ProcessState.AwaitingFunding;
+            emit ProcessAwaitingFunding();
+        }
+    }
+
+    /**
+     * Check sufficient balances and lock Termination Fees otherwise trade does not get activated
+     */
+    function _lockTerminationFees() internal returns(bool) {
+        bool isAvailableParty1 = (liquidityToken.balanceOf(party1) >= uint(marginRequirements[party1].terminationFee)) && (liquidityToken.allowance(party1,address(this)) >= uint(marginRequirements[party1].terminationFee));
+        bool isAvailableParty2 = (liquidityToken.balanceOf(party2) >= uint(marginRequirements[party2].terminationFee)) && (liquidityToken.allowance(party2,address(this)) >= uint(marginRequirements[party2].terminationFee));
+        if (isAvailableParty1 && isAvailableParty2){
+            liquidityToken.transferFrom(party1, address(this), uint(marginRequirements[party1].terminationFee)); // transfer termination fee party1 to sdc
+            liquidityToken.transferFrom(party2, address(this), uint(marginRequirements[party2].terminationFee)); // transfer termination fee party2 to sdc
+            adjustSDCBalances(marginRequirements[party1].terminationFee, marginRequirements[party2].terminationFee); // Update internal balances
+            return true;
+        }
+        else{
+            tradeState == TradeState.Inactive;
+            processState = ProcessState.Idle;
+            emit TradeTerminated("Termination Fee could not be locked.");
+            return false;
+        }
+    }
+
+    /*
+     * Failsafe: Free up accounts upon termination
+     */
+    function _processTermination() internal {
+        liquidityToken.transfer(party1, uint256(sdcBalances[party1]));
+        liquidityToken.transfer(party2, uint256(sdcBalances[party2]));
+
+        processState = ProcessState.Idle;
+        tradeState = TradeState.Inactive;
+    }
+
+    /*
+     * Settlement Cycle
+     */
+
+    /*
+     * Send an Lock Request Event only when Process State = Funding
+     * Puts Process state to Margin Account Check
+     * can be called only when ProcessState = AwaitingFunding
+     */
+    function initiatePrefunding() external override onlyWhenProcessAwaitingFunding {
+        processState = ProcessState.Funding;
+
+        uint256 balanceParty1 = liquidityToken.balanceOf(party1);
+        uint256 balanceParty2 = liquidityToken.balanceOf(party2);
+
+        /* Calculate gap amount for each party, i.e. residual between buffer and termination fee and actual balance */
+        // max(M+P - sdcBalance,0)
+        uint gapAmountParty1 = marginRequirements[party1].buffer + marginRequirements[party1].terminationFee - sdcBalances[party1] > 0 ? uint(marginRequirements[party1].buffer + marginRequirements[party1].terminationFee - sdcBalances[party1]) : 0;
+        uint gapAmountParty2 = marginRequirements[party2].buffer + marginRequirements[party2].terminationFee - sdcBalances[party2] > 0 ? uint(marginRequirements[party2].buffer + marginRequirements[party2].terminationFee - sdcBalances[party2]) : 0;
+
+        /* Good case: Balances are sufficient and token has enough approval */
+        if ( (balanceParty1 >= gapAmountParty1 && liquidityToken.allowance(party1,address(this)) >= gapAmountParty1) &&
+            (balanceParty2 >= gapAmountParty2 && liquidityToken.allowance(party2,address(this)) >= gapAmountParty2) ) {
+            liquidityToken.transferFrom(party1, address(this), gapAmountParty1);  // Transfer of GapAmount to sdc contract
+            liquidityToken.transferFrom(party2, address(this), gapAmountParty2);  // Transfer of GapAmount to sdc contract
+            processState = ProcessState.Funded;
+            adjustSDCBalances(int(gapAmountParty1),int(gapAmountParty2));  // Update internal balances
+            emit ProcessFunded();
+        }
+        /* Party 1 - Bad case: Balances are insufficient or token has not enough approval */
+        else if ( (balanceParty1 < gapAmountParty1 || liquidityToken.allowance(party1,address(this)) < gapAmountParty1) &&
+            (balanceParty2 >= gapAmountParty2 && liquidityToken.allowance(party2,address(this)) >= gapAmountParty2) ) {
+            tradeState = TradeState.Terminated;
+            processState = ProcessState.InTermination;
+
+            adjustSDCBalances(-marginRequirements[party1].terminationFee,marginRequirements[party1].terminationFee); // Update internal balances
+
+            _processTermination(); // Release all buffers
+            emit TradeTerminated("Termination caused by party1 due to insufficient prefunding");
+        }
+        /* Party 2 - Bad case: Balances are insufficient or token has not enough approval */
+        else if ( (balanceParty1 >= gapAmountParty1 && liquidityToken.allowance(party1,address(this)) >= gapAmountParty1) &&
+            (balanceParty2 < gapAmountParty2 || liquidityToken.allowance(party2,address(this)) < gapAmountParty2) ) {
+            tradeState = TradeState.Terminated;
+            processState = ProcessState.InTermination;
+
+            adjustSDCBalances(marginRequirements[party2].terminationFee,-marginRequirements[party2].terminationFee); // Update internal balances
+
+            _processTermination(); // Release all buffers
+            emit TradeTerminated("Termination caused by party2 due to insufficient prefunding");
+        }
+        /* Both parties fail: Cross Transfer of Termination Fee */
+        else {
+            tradeState = TradeState.Terminated;
+            processState = ProcessState.InTermination;
+            // if ( (balanceParty1 < gapAmountParty1 || liquidityToken.allowance(party1,address(this)) < gapAmountParty1) &&  (balanceParty2 < gapAmountParty2 || liquidityToken.allowance(party2,address(this)) < gapAmountParty2) ) { tradeState = TradeState.Terminated;
+            adjustSDCBalances(marginRequirements[party2].terminationFee-marginRequirements[party1].terminationFee,marginRequirements[party1].terminationFee-marginRequirements[party2].terminationFee); // Update internal balances: Cross Booking of termination fee
+
+            _processTermination(); // Release all buffers
+            emit TradeTerminated("Termination caused by both parties due to insufficient prefunding");
+        }
+    }
+
+    /*
+     * Settlement can be initiated when margin accounts are locked, a valuation request event is emitted containing tradeData and valuationViewParty
+     * Changes Process State to Valuation&Settlement
+     * can be called only when ProcessState = Funded and TradeState = Active
+     */
+    function initiateSettlement() external override onlyCounterparty onlyWhenProcessFundedAndTradeActive
+    {
+        processState = ProcessState.ValuationAndSettlement;
+        emit ProcessSettlementRequest(tradeData, lastSettlementData);
+    }
+
+    /*
+     * Performs a settelement only when processState is ValuationAndSettlement
+     * Puts process state to "inTransfer"
+     * Checks Settlement amount according to valuationViewParty: If SettlementAmount is > 0, valuationViewParty receives
+     * can be called only when ProcessState = ValuationAndSettlement
+     */
+    function performSettlement(int256 settlementAmount, string memory settlementData) onlyWhenProcessValuationAndSettlement external override
+    {
+        lastSettlementData = settlementData;
+        address receivingParty  = settlementAmount > 0 ? receivingPartyAddress : other(receivingPartyAddress);
+        address payingParty     = other(receivingParty);
+
+        bool noTermination = abs(settlementAmount) <= marginRequirements[payingParty].buffer;
+        int256 transferAmount = (noTermination == true) ? abs(settlementAmount) : marginRequirements[payingParty].buffer + marginRequirements[payingParty].terminationFee; // Override with Buffer and Termination Fee: Max Transfer
+
+        if(receivingParty == party1)  // Adjust internal Balances, only debit is booked on sdc balance as receiving party obtains transfer amount directly from sdc
+            adjustSDCBalances(0, -transferAmount);
+        else
+            adjustSDCBalances(-transferAmount, 0);
+
+        liquidityToken.transfer(receivingParty, uint256(transferAmount)); // SDC contract performs transfer to receiving party
+
+        if (noTermination) {   // Regular Settlement
+            emit ProcessSettled();
+            processState = ProcessState.AwaitingFunding;  // Set ProcessState to 'AwaitingFunding'
+        } else {  // Termination Event, buffer not sufficient, transfer margin buffer and termination fee and process termination
+            tradeState = TradeState.Terminated;
+            processState = ProcessState.InTermination;
+            _processTermination(); // Transfer all locked amounts
+            emit TradeTerminated("Termination due to margin buffer exceedance");
+        }
+
+        if (mutuallyTerminated) {  // Both counterparties agreed on a premature termination
+            processState = ProcessState.InTermination;
+            _processTermination();
+        }
+    }
+
+    /*
+     * End of Cycle
+     */
+
+    /*
+     * Can be called by a party for mutual termination
+     * Hash is generated an entry is put into pendingRequests
+     * TerminationRequest is emitted
+     * can be called only when ProcessState = Funded and TradeState = Active
+     */
+    function requestTradeTermination(string memory _tradeID) external override onlyCounterparty onlyWhenProcessFundedAndTradeActive
+    {
+        require(keccak256(abi.encodePacked(tradeID)) == keccak256(abi.encodePacked(_tradeID)), "Trade ID mismatch");
+        uint256 hash = uint256(keccak256(abi.encode(_tradeID, "terminate")));
+        pendingRequests[hash] = msg.sender;
+        emit TradeTerminationRequest(msg.sender, _tradeID);
+    }
+
+    /*
+
+     * Same pattern as for initiation
+     * confirming party generates same hash, looks into pendingRequests, if entry is found with correct address, tradeState is put to terminated
+     * can be called only when ProcessState = Funded and TradeState = Active
+     */
+    function confirmTradeTermination(string memory tradeId) external override onlyCounterparty onlyWhenProcessFundedAndTradeActive
+    {
+        address pendingRequestParty = msg.sender == party1 ? party2 : party1;
+        uint256 hashConfirm = uint256(keccak256(abi.encode(tradeId, "terminate")));
+        require(pendingRequests[hashConfirm] == pendingRequestParty, "Confirmation of termination failed due to wrong party or missing request");
+        delete pendingRequests[hashConfirm];
+        mutuallyTerminated = true;
+        emit TradeTerminationConfirmed(msg.sender, tradeID);
+    }
+
+    function adjustSDCBalances(int256 adjustmentAmountParty1, int256 adjustmentAmountParty2) internal {
+        if (adjustmentAmountParty1 < 0)
+            require(sdcBalances[party1] >= adjustmentAmountParty1, "SDC Balance Adjustment fails for Party1");
+        if (adjustmentAmountParty2 < 0)
+            require(sdcBalances[party2] >= adjustmentAmountParty2, "SDC Balance Adjustment fails for Party2");
+        sdcBalances[party1] = sdcBalances[party1] + adjustmentAmountParty1;
+        sdcBalances[party2] = sdcBalances[party2] + adjustmentAmountParty2;
+    }
+
+    /*
+     * Utilities
+     */
+
+    /**
+     * Absolute value of an integer
+     */
+    function abs(int x) private pure returns (int) {
+        return x >= 0 ? x : -x;
+    }
+
+    /**
+     * Other party
+     */
+    function other(address party) private view returns (address) {
+        return (party == party1 ? party2 : party1);
+    }
+
+    function getTokenAddress() public view returns(address) {
+        return address(liquidityToken);
+    }
+
+    function getTradeID() public view returns (string memory) {
+        return tradeID;
+    }
+
+    function getTradeData() public view returns (string memory) {
+        return tradeData;
+    }
+
+
+    function getTradeState() public view returns (TradeState) {
+        return tradeState;
+    }
+
+    function getProcessState() public view returns (ProcessState) {
+        return processState;
+    }
+
+    function getOwnSdcBalance() public view returns (int256) {
+        return sdcBalances[msg.sender];
+    }
+
+    /**END OF FUNCTIONS WHICH ARE ONLY USED FOR TESTING PURPOSES */
+}
\ No newline at end of file
diff --git a/assets/eip-6123/contracts/SDCToken.sol b/assets/eip-6123/contracts/SDCToken.sol
new file mode 100644
index 00000000000000..45de674b998580
--- /dev/null
+++ b/assets/eip-6123/contracts/SDCToken.sol
@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.0;
+
+import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
+
+contract SDCToken is ERC20{
+    constructor() ERC20("SDCToken", "SDCT"){
+
+    }
+
+    function mint(address to, uint256 amount) public{
+        _mint(to,amount);
+    }
+}
\ No newline at end of file
diff --git a/assets/eip-6123/doc/sample-tradedata-filestructure.xml b/assets/eip-6123/doc/sample-tradedata-filestructure.xml
new file mode 100644
index 00000000000000..c557553cb293c8
--- /dev/null
+++ b/assets/eip-6123/doc/sample-tradedata-filestructure.xml
@@ -0,0 +1,77 @@
+<smartderivativecontract>
+    <valuation> <!-- Section of the software version used to calculate net present value of underlying otc derivative -->
+        <artefact>
+            <groupId>net.finmath</groupId>
+            <artifactId>finmath-smart-derivative-contract</artifactId>
+            <version>0.1.8</version>
+        </artefact>
+    </valuation>
+    <parties>  <!-- Section of SDC contract parameters for both parties -->
+        <party>
+            <name>Counterparty 1</name>
+            <id>party1</id>
+            <marginAccount> <!--margin buffer amount -->
+                <type>constant</type>
+                <value>10000.0</value>
+            </marginAccount>
+            <penaltyFee> <!--penalty / termination fee amount -->
+                <type>constant</type>
+                <value>1000.0</value>
+            </penaltyFee>
+            <address>0x...</address>
+        </party>
+        <party>
+            <name>Counterparty 2</name>
+            <id>party2</id>
+            <marginAccount>
+                <type>constant</type>
+                <value>10000.0</value>
+            </marginAccount>
+            <penaltyFee>
+                <type>constant</type>
+                <value>1000.0</value>
+            </penaltyFee>
+            <address>0x...</address>
+        </party>
+    </parties>
+    <settlement> <!-- Section specifying the settlement procedure -->
+        <settlementDateInitial>
+            2011-12-13T10:15:30
+        </settlementDateInitial>
+        <settlementTime>
+            <type>daily</type>
+            <value>17:00</value>
+        </settlementTime>
+        <marketdata><!--Section for market data specification defining market data symbols (e.g. interest rates or equity spots) relevant for trade valuation-->
+            <provider>xyz</provider>
+            <symbols>
+                <symbol>symbol1</symbol>
+                <symbol>symbol2</symbol>
+                <symbol>...</symbol>
+            </symbols>
+        </marketdata>
+    </settlement>
+    <receiverPartyID>
+        party1
+    </receiverPartyID>
+    <underlyings> <!-- Section for trade specification of the underlying OTC derivative contract-->
+        <underlying>
+            <dataDocument>
+                <trade>
+                    <tradeHeader>
+                        <partyTradeIdentifier>
+                            <partyReference href="party1"/>
+                            <tradeId>CP1</tradeId>
+                        </partyTradeIdentifier>
+                        <partyTradeIdentifier>
+                            <partyReference href="party2"/>
+                            <tradeId>CP2</tradeId>
+                        </partyTradeIdentifier>
+                        <tradeDate>2022-12-13</tradeDate>
+                    </tradeHeader>
+                    <!-- put your trade specification here -->
+                </trade>
+            </dataDocument>
+        </underlying>
+    </underlyings>
+</smartderivativecontract>
\ No newline at end of file
diff --git a/assets/eip-6123/doc/sdc_livecycle_sequence_diagram.png b/assets/eip-6123/doc/sdc_livecycle_sequence_diagram.png
new file mode 100644
index 0000000000000000000000000000000000000000..253bdfe1f8ad04c416cb65770d199106287ada1d
GIT binary patch
literal 182042
zcmeFZbySt@_AZQ~h_M7LkVOdCw7>#M2|*M=q`RaS0@96=A|Z-&NF&`Kjif9DDPhqe
zBHdkQKDzflzw?d#efx~@o%7%C9qxC$vRTi%pF8Hf=5<~3e*HvR0(FY=6afJNO7el&
zQvw1aGy%a0YGNYziEZ437XiT)0!cApdHd+OAqVvfHWMe778ky}7zsOiYS{4At4LLM
zdIJ;T_@I=_sx%QFK7_6-C*aK<nizb#@30<zOTeT*AmSI9alT+=WT(DL=riNjN8?6l
z_Y4N{F_m_Af3CV#3g#%y-(6^9;#iH?4kRG^pZ^4(7SoXVuRq|zGNFC{=ReKY{{Q|p
z`wBU$X8m}>o8Z{kz@;S%dj|))+qX}}@Yyw{$tLDv@pq!{TBT&)=$hy+GCe`(NfjXO
zQB!lTzM&yrtJ*bO(1mwnaYXAzSFuqCJuw}d%}h71gPRk@86sl3x9{FP?R|fgfX8O$
zg2A^)ui;8326*)F@Gvn7bw7wkfX!vcno7{QH2X#{)de!LBXq|Oc4k?9VwKd@&(Iya
z!@)6xVHP^vD;VGWqUxWz`Hg#ovs^2&;|dQC#jRVn!nsT@wZ#gUu2-_Em%3kj6srCG
zqp<IrHy%MjBu5DeJK{x83|cl(Z~c5P(;92FwWQM;!Es`LXI)fY{z64X1t}TXOV|A!
zod&;)Y1!GuJF#)DJGY2PX#9PBiMMuk5?ppS!tYvLZ;KOJ96a%xZhCr}RAjWET`*%-
z(m0nzqwE;nF=uCIlga%S9FE<%^D3w5k29K@nxrCExVe?8+$LK-Jb3)rtGc?nqBUC3
zrGLIFI4+Ka?%1!^h>49}#fiB^6_+2RKNQ?|N~&HYfBp8&i}Yv|#w>kSl8!!s$Wxz?
ztmEQ1jQD}1WH9%rTA|U)!a~lq>8=wU9UUw4Y9-IJW+iRD4t}<x^Q?g%GYg8}MrW7J
z+<s<YK+nN(zS3z^93J<v$7HfycWJbCYdST~#Bye~iD+-M)+4L!^t$oH{s$$^U^^*e
zPRc^l-m|@$PRwPt^M3B`1jKakx#hJknO;0+{|^7`d8g30er@Ba=&bh6E`8C54^KI6
z%o(%09qyOx@qfY+6BEC6GrV)>&fD<to7I{bidjpm?Lrw<i`g3Gq_niGLKs0o8e~AQ
z<fIobUK?@UU+=}Wf3_HVl`!ZV6eRKD#hov8b&~_$XD+|;^E=hEsa}k|%t?vzB>nv(
z3!Pnk;OOb)B~1MC=g((RlfIP3clV~^+^Af$xtP%EN(1_JOJj9(p7+Xa=h+NeDWsx#
z$Z{%HP7!Di6q|iF;#^u?6@C7k<+^mV@9Xn7#$m>u$DIvDWoMAg-gciK3EL^GdT~t`
ze@{%TO&k7g?M1=;JX-xuNJvQdkd~^dp9GD=F?e*k$0sXVi5730*&h)@b{lglOe*<e
z!x6pd3XFR@vpKQR&%AP~c1|5Xe!Q>B#VM;Y^_Ci+wcGAI_k{}=w7*4i74hpoWUW|w
zrGAHhsfG}aM9BETX>u0rI&aj2hYz1p38)PyV|W%O!?eVOg^#dkR-~0yX5)w?0`o&#
zyrpA!BZfAIofd1`+et)-{b_}U=MIL-?dqDEPKXenq2we^PEPjQ&B(~ebJ~3V%+QeG
z&Yh=K`*Cgu!s_Z&u`U}bdrNgBeoZ;bc}E>9X+((m*SqBm79HmL*zKL1L^FDH;asfD
z8@9*Zj}vrZlFndeLeJ#%Gof!YGRF7Lj!jH>z&Y%iJ8)X8Bo`rOQZM~J(e-pd-y?aX
zz&kTO1hua3GWoE`VbuWMcC`NWc^iRSVq)Fyx!5c8Wg?!Qo}7M(LF&xtt3rEAgpnAt
zQ*_6~11Kk7OJ<c&erdDxsJ%i`muEfwG$W|eewlvQWphY1@{Sd1Y&E1iEWh?0V=|V&
z-G|ndLWG#ptY6-8*XuO-_X-EA?UJS+xf1v9-(PW4Qc{}u;&u8GEuYmdDPp?spREiF
zc45tl>5et}U)Hl7=}44_?=bq<HQoA9KusCbtyQFgiRO1WCqfLN?9;GY*JJLUe%^;>
zVJM{p@241u4zl}o`7eEcpL!xIOSj0xXEEw7+Rin6^YCDIk==34sJ_0w23F(i*RRUu
zwpn|9u))W@(a-Nadv<kiZ|{4m4DB1fSH<Qdfw$yRKAQGs`}+HPmXvVo>gg@#xb2_T
za$feDvGTWLneQ)p<jM+BHA}68{`&RCapjrwH>5+fnqu>h5d6s2I8ArVnwQ#jZ&{*X
z_i%4jhJX9#d*oQWdi82_cJ@smH6Oi@kk)$h<B9f_pI_g@?xh-^n27J1{uxtlf?j$Q
z%Jh=-=-s<_FQqC_-u@{0{(4$w<}m_!1%)w)r}e)(5<6hO9y@WOuD6%mtiP~UU~|yp
z{SBGhniFuWE(r<I9UFFDeca%5ndH$G0q)zkTgE%0K79DFVrRWHDjX(=lT8$dqgmy$
ztGXwJ#aFrTy?F70l$si4Zf?$L+<ENt=g*hg7uaJDtM*nN4O-Nph)GC%a&lPTy?>vl
z+i<F3Vt$`L!0xS9sl|~3!*=oAjrlQnt5^Z2qZWJRoQetxUOgE~dNuAxkonWhk%0XS
zi6PH^S$ErVgGI;$b|@Jo<tbKH)`G>^>cjn<Jzlk9tn46iM7JZ4HuCj6_Mx`?RZsyN
zE7o!5782?N1qFQr0~^gshEmFy)FwXV>mb{I@lBpSE)?G7?OW1RZ|3}8btFQbq({fb
z#tb$kM-H24-7<FuVPGP}FDG$f1M8Zdi=oNkXK5!}R*cd=ek4%My7V{-qoD4Vnx1}&
zQ7K!@z~DNBwXym60LXqigQb?~62BaEU3sm3ozZk&zJG>>pMqJn&>bcN(pB)gcdra%
z9U662p7G~oYLs76(sJQCdh{sig$tgUnM@gm*A@m!NVtdX8NPh^GP<}J1i@7opRdpI
z0d+$<y2kV5d5FHmm6}1{zdw2Q?3woZOiy~(f)v$IaHZ9hv_A#=Q3ygFFoCc?pUTNW
zG71`TJJfKEULG0Oa@{@-drl0CWm<C-P=#D`nZqFMEZ46&J40iNYZ8Yk$`dUk+J--x
zm_DGqyu1_-4X{IH7e%_y$QieGwEq|$Ay=!r>EI|(L*sU^eIwRs;jZ<3|3!c?OUui`
z@YL+e4b`7hQyGF&1LoBYuuD72Y)m1^(%-yE4CkiNG^a8}^@*CA+i-;g2b>VdY4G~`
zmb}Sy?~$o07-0I~xxw=O9W|e=c3-ZJQGemBipol|%a>oHpO+qi%>5}qCfL`P@?0oN
zOiYP*`sO}Fs^0i1N%Z7IV}Pi&H77j-Lr1ln8;na~I8E*Ii)$G3;WIE@zrICHl+9*~
z;zF6}JYg+zW*Q$sf`cQ+Yq#J(n^R4L%z1yY8Jt7-%H=k`#c%<Me&t9&K7b;=7aGg0
z%@2^r@Y;L{WmaReTTp+duMe9@&}HWeoXfyv@3)ouqWb#R;JjY(WE*g2Vq_GB%zVWY
zG7f@q*p0ql+1?=sz=auj`%VzIJki9!%S-w4<;&8Ie$$QuLz%tZkwc=7RY$ZmHP32k
zX+gwR8^qr=>*oZ#1^?bIu0Gf~Ez<3OIS%$vbTri&3buR0c+&Id6Z>jych-zy=5dGF
za87Rtih9%%)T}g?7jitEFDEpSE+H4W!o}5-+@7DF{!mcP5Kv3{qW&Xc;g|dv7nlZb
z6xur}=_;|TRltd&f@?|JiyacQUJ%A0#IS4E5Lhn^s%T#F=l%kxIGH-q*w`2uGz6cw
zk&%7?SYR%Wz&Q@t13*B*WAU*fF<&W1lLCXKK(>UZj}N1*^+5TaGDHJHx?`B<gK4E2
zlr;B=U!I_`zh^np7=VVYkgHR7p(JV{+Ui$9Yip|~z&m6EM?~Ce=U`SVmS@goT9(J>
zLNFoLaW$xWODB58vxeGkP-oK#|LFFeGVAGt(*4vp*LQ~jp{D|!7CuADl#1oYXK(I|
zzhQj~s0>0COr>7qnFc$9iiw^NlO3hlwDj~ZA-CjUnVJHrmxt^|zHTbW%Qwem!Etq5
zpYeiuc8EQNLN!1{xUe|(dfT`w<?)L27=T>8-{0dO$jF4{2v~jN>P=ht9U3|o!C@$p
z*zr-+=PXRal}Ikr>*Pdm?2_@Tf?K164iB<nmi=i2C;@ePDQ0{Kdn|$To*yV-0H`ZM
zeD(TuU3g}5bMxDF3|hdkP}j%M)m3nz`p}h_4gy3{I7!k2w=nb1lb5!OH%Ht?7L4B=
zR6QJV0o;?HpZ~MK(|_vxbRKfV)zzcbL)K<`9>r?;oTWC|plNfpD{dijI!x&spZjyf
z2Q@G}JNW+HUEM5fTEIGi8jE`Am1;vcLJ-(3X0u8FUdm~jbFV`lWME@^qIm$YEnzED
zJdny*k*819Ef!9OCu!+o)vkQ%DvZWQGY9@CWd^A*qN!A_9~u36BQAtCE+oVg<}fKG
z1?J@*Ads)`uGzX}i;2ls=lwwq2t-+V=p4qPvDBv*qyw|7801S7f<Eow;NW-qW7XF9
z8^GEa%q0lW;e2-46))u=SwNas8#Ho*Val^sRTzAuG%8XRlaPptxx{M51W1>EwUq;w
z_TA$9g8_}Yo06TKovoTV5U_{JY&=MhzQ6wXsd~){fW(#iZ042giVdccamnI|!q1;)
z>!!wX?uTMVlY7;3wO`^n6%`d*(8-MwjEeH|+E7IpkoQ#pq^%HLXhfTHItduEk}^{p
z+XJxpBxnvn%K$yz<{T;!NEJNwl|dpfttyPmX>$Qq+e<pN4&q`~>Ee2?mXCPi%aW3k
z3PLqq{=;uk+%kFWtQtb}ckXmf&z>;?sBS(&(-cIj<SgjEIx-1iA9g6L<Pv<8aUmlu
z?TP<4l2VNSJI+Pvh&%T!ol>P^AQE`|{%uqcGuT;Jy|;q%8_=k{S6Emu9%Wt?yvPUD
zS$~N+Qkt~KnQvC(<n%o_&7(9=2&;xBpPnkiHM}A3_#}6On68y2yb5xOgHQRjc7e_4
z8EFwUEXrzpX65F5?#}LFwdLwJZc*ZwYirgaVPT9ktlvy~)vW>&JfXa5g!4~AXOeAf
zJ>7Y2TTrG|2Iip_K9jSxdz=6U^=5BVe11J?n)vkTIzW0iM_iZ3@9)iO9X{PhZNY~p
zMLO5GgtmX4hpfS?j)~^8JNr12Gx$(i(y;SLO_-MJE!OfB+!~3{9swN_Nn%J$jG1L>
zGPCKA%-}cvFpW_|)p|{58@QzWdrigtDdKOw*_gvKgmD1gkgEtR7>UWsukEP570R>9
zO=0oerFBT(qaZG;fZR8Gex2Y^5{D7Toja|5>FMdWFOZWnKHps^UnHfXI+LaN2Cx9*
zaCK&;6pMgV`@Mpq1E!eE=c%c)wooBVnia}6F2hgpqrdN{$jcw2GihrZ`fQatp4ZUO
zKz!y5f(Osi3Su`@0W2^51<UeEN_uV4cUQb4ERjSE)rXjkL}a0C?Ay26wv<i^3Lh#M
zM9ofgLoM?&h9U4RMpG)tBm@)M*#$LVFASTL88Y5`^MPC)La3iQ5`FOA>`$yNI6~EH
z%^NfG9TguR&tvt=e`Z&u-`#DoauYUCZ??v_*j0EZ5#rUvi&>x2(?#ICLwd6~*mG!b
zX$wXDXsdw_oq>wCHP8<N@nD{w5C3B1!jr<L=3oXo&z-)tn#sJnfNHDJmAzEkyy=-4
zldD&+-XqqrJz^_i`!;GpIoBt7aRt`aT{_i6I<=rY#4;JnWBvOrzHMDDRa)3LGVz0i
zKgAJ1!VnnmS84ULzkvFr!Su5#1`cr#-Grvgx&p-MXU(MLhZ>Fg9!2VQLpFX>pFW@f
zkMg+gl{#O43fsLk`{fntPo~byM0TaHPJb)I*3fMvFwO*O6WC8Dhg}i-CVLQ=Tg36b
zXL1>e`nu_^)Q$`#RtHUvA!ECl?pwdt9giJ57LFRZ8r(*(v*>onIP&ZD_E*a3k|Ic8
z00>v{3HRT$F7UbT@pzIFpFOKM=d504{i&xK)rr3y7=r3FEq*?vD$Duc5|i?k5%bpf
z`W|cCL&J1cN!1O2#N?>%(FLCku|L?JnvW$i{jdA4@6w}Ly#*F@X5I##R}Is>;pl!1
zDn(DyFXI-HDM<yvOepqZDD!%3?mPX6gQC-<VC0_U=E4x2CmZ8gKxlz1?={M-^UC&w
zAlLzE0fD+?cHP%E%~kJDfqU0!gGn(*GXS<w0z{ydK;~&*`mVgS<bW5CL><=_hR`C!
zJzY^yO-?c#>%kmjynTCVxrtV<BjJ8Hhhd=e&Tdh!CcvRfEb3|Y6@_`v=6$v7!cd*T
z`Hd2^L1^x?P+!6~Uy8ed>RqlqLEBs+88^vXGN`-k0O2zuJ)M-C`~+QVPB|TQkI8iR
zK8Io3$Fwx!)nDK0=I{lR?JAV6iG_vo%l3viA_59_-D93?LWH9Ivc`_`(HwEfmiQ&W
z;>ymk*E*++jL&Err=9GI(eK<dG?p?jHcXyo6WLg}!c8qL5x_8#T-enV{N`G@<4Yss
zK|^Dog_)iVKol7{Reo@8Ay{#l{vaq-7X$L9b<PGVRMleaC&%hSh7@2}Y!9RSao!;z
z7uM$Ra$G5OG7q5OT?4jj-A;DraWUrwKMp{TC+JN4w7N#@M_)u-rlmDs=Hgetl$P;d
zx^yW4xB{4dm;rg}9Os^N1yT|1(VCZ+QssEdg(*AFF17Amy=yssOfgH<%P`L6Qh~uY
z5lHJaPIK(U@ve_i##P&}bP8JSe~SJF*`3ZJvs0%|$;TDgEo%DUh^D!qV9#=_=KL8&
zDq<;cTIK^vUtgb81j<qw8)62o&XI9QD;n#r#!V^Hx#s62s`=FPJrdpIGA-B4bL%_S
z+2Ip`uElV?iz;cfzd}XvbL1D)KzM#9>7A^BN~e;U{hpqll?al?6U6v}1IQh$qQt8l
zdP#&Q{c}!UmxY9`aor6{Q-C296lso%#|eNpxkvmGP|$$006l&Bp)!=x8e<1gxH4%~
zsSi_NhK%XWLe%>6EQV})0VmsyxG1f=PTM>Vx`$-#pX}Srldo^YKH&$9osS7DD8~^Q
ziw<n9@2t-n+LQ$_Xp~+m-BS@<X=b=I(%wnLPrwh<h5_HbB!<g9fr^=sYWy#AeC(ag
zlAeIl_(Ho?GWM;lYGj*4r*dbCM8n-xm9jhjPi<_t3RRgsN&V!u0wn8BZf$ShdLH&m
z=n>zIBppksDMlx|w;9w$#{5Hpu3@k&uShq7@<>WGF%Kk;<){{&BCyz<FM-_y80YMW
z>u#3ri8#*IFMWA>-!z+g@@qT2>XH|Kbbc2%QKuHab>#{{L_|b$YpWP=E2Nh%->M#l
z8e4CJ-;N~l>V688-ccIw?~Tu~J(LmJ=L7~48w$^S?CM_>^KwC%CVBQ)noH<A*z$u5
zBbO&)l48T-fO4FijZ*dt3k$=qdZyj26UmY~!lE@gU{CWwkl|574}>#1Pd$B6ad9Hg
zT-Qn}V^#ktZbO_mWWtO#y-pQ`8?)Nt%PrDmKuJ8?8JLDjF9U0_X70xocz_~`R-?7D
z!;j7x&Pw5*kk20Z!N2o6ab*pGAJ2y<^&0(aVdH-bwVU2-i=~Kb&~M*arFGk*%aNfx
z^nTQ9#a4AaTr3M~VI478<x)O$m|{EMk6(}cC$=-Wnza1Xi}WTV<9qWkOv_YjMB)z6
zh`EKUGFjN0w{E=zNE8=GixhrT0*)7^+T+5w(`g)jlJ#uLmtRS{WfzKSB=-%qjir=n
z`W`Q;z-nzwHBmr{bqRG}&lm3hN^|}^1MU7b>enf@h2wkMt8@_TKhO5&GzAGAr15k<
zrnIeJTeVI`AijvRGrwo4bI5+LmK%z$I|xZ_nVFf^J4ZVd6ckp(E0<+U8j}*YnC745
zavnk^QsyJ9jabZQY4L_nP>ZOuke)kt?t+AOu}RM<nA{Tt2<2>m3#~`CfuRbyzQ?qa
zMuk0@4F9s{USta2t09M%M$?;D+1S2gsjzxCWMV^7n}Fqi#1|>0S3%g`-*(TADF|j5
zCgHxe_QwXD=A@C~?r!<0Y7UdSo1d**%a$9VD7vSpc&XTIz`H9|1~*ZzBrkuDIKI@P
zyuNe(oT<J?f9_3pD@ZtzCb%rIe#`m5eBnr+#|--$<xernJ8IZZSc{GF0tEp2+zpfx
zheUkkg1@l%E2v!~RSeHAo>vaj-QeiXj1UVje+aI_;quo87+lUab_qbq8C9*{SUtIs
zDMVNUas4PAOWapoXT_|370ZR2=%f*RbMu3!!|O$}p}?ZmAuL*2@Yeq3$YcO|g8Eo2
z{K{z?L7=hH+b{E48&x8I-<-DQZSX2YAUCnjAw~H)B^=S{inRXp1s7v~jiSVh@87+<
z;+b3eUY7Sue~dn%g~ODmHIcWqxOcy-Wt(egr#&t-kf*ru$I{8pHqu9RH@ffRM_cV~
z&96<5R983ja!s1R`}rWOp)<S=gk>n?Ll)zBEa^Q-c^ubno;!b@&htqn+w=!@%!8!u
zWQg5<Z(cvt8~5?_yy;zU8NzwV9@gU<wN%YyOb_h#yqW#Z;Es*JT4qZdifc}xO&1vz
z@1=Gj3@w1FSiI>2QF|41j(R}(R4Onn)RX~4P}3Xq-aG2<ae}0*2>aIchL-)<@t!H?
z<p%PzVW?tnS)d%ED=NBwu{}IEIIz_U>5a&*{jivg!4cKuRoAv<2dStk1$(!l@4iTy
znUy4`#IT^%x3L0T{_o0r38{(zoEKv8Kxrbtvr6OkJF3d6_m%n{*84QmtrXKzmml@I
z<UwsviAyTXh8U?(?M6>uw(=Kv_Nk7AH3nQ1aga~H(Lyxce5;6o!EJwC$<y1LR|E5a
zJQXSin%o>LkHbn*1v@V=pbajajn)uI6j)h|U-PwiD``3$7wJ}ye!|-&Ja2S=bj5<n
zL}I~ZsrJOmrrD0eLvry#NXLqJZD%6!`}e&nEHiE8qYL6DUlN`GUKWb>&g4f~f*YVk
z`RP<8QCpbQZ4!jpWh<9o$)bG3cNyyvyAgtFa}Mh~o={m)u>|y`va^}q29r?n16*(S
zC%JEeK_$bEkA|nO{VCcNwCXzB?kWl4cH}V#{k_7o3nb5b^J*y4oKb<mhp13tBob`t
zjHjK>5EIvI%n!^*4xc=K{T}i9=@c4>Jg{WEF>Q0NeiVcL@X0mooE>w}?2jxDfbDCJ
zm3TZotg8SpMSzMeet)McPaPUseZMwfR7NPb0+4Ya3y$Dsf<zEadV8=fC!f{J-x#z0
zw1XiBSa5~IfFjG6zafeYWjFE3VM<qqdTjBd%}|5)HZf&oJdh~5aqZeC>8QdsBX#(H
z@%=k4c{VS9_p6dvcw19Pz&M*r0%(OaZ7RDjIpK&VIP}gCdGNa_mt7CfIxRL(E>&#Y
zMFh(+^4ixo+ZmAwvq^z&tg&hrNaYorhYa13rzZiF$ugHr2nsM5aGgMd%273}!JxiM
zu<)s2GPSB{M3k#Z(~9!P+Jz45VSy&8xwBM@?hMr0LnWtf)1yF|@Jqz8abo--q+9Rp
z)hWj3RuXs%U|%7r3g`6VBwlAwXAu(sH3aYnlC$4H_4Y6Hw(s4db~#FxhR*v@W*<;B
zlc#+~fU;AB2)t2njK$p7l#@~_hPMZM<2R7~zyJ|J<#-&(<dyk<6wOHPTcU>o@8#c$
z8ShmPGxSw^cC|1SiEbgbQpo6#vS7UGQ5Z{vMtx`OWK(GQLfL5%MBo$2=((MJZ3PgL
zaAHRdkl!N8G=?Mp+A#!SO<$y?q~tGr;j>!^$!TY|U(yCuvtc#;ugEfJKM??wwEUo<
zv$#j)eZnVlH~$|}N&{D~dScncH=52Bv*}kU3+go7Ksh1=o`Zu9u>O8cBMwtBE1S!p
z`9wZ$TC6?{gi@Qat<Z9FZw-nSgpj8UXq-Fa56ZxorlzJW{W^SsA=$-?$LU&GDfU3o
zYtav5(69S!HT6A7@;s1qL_q6*aMm(5{<P=HTD_M)?hwm_PU_^ndi5Bs^U_QFzSG8>
z?1iGX5LC9aU6BTcVB-*FYwOb5S=It8H#v4Az~?TcKY4Y&hElA>WI@sTuCB35a&a#q
z6CUbG+qpg+#oJnC){>glt}~xffBs!cY#<CPBNnz()7eawg2wo1%=Hg^6HP&3z1)uh
zCg#awc*>*>ri2bbi4YbRPLI>LfB*Q894+(SweujeH2slT=%|mg%=gU<l(6n>%xCn;
z;xkn^3QjLLCSVcm@+b8<OH0eG-s%Id!9jH~F)>8Rpy0F3?9#7;VEl4)R2$yEc8FcC
zaWs%`;R$x_p?;l$l16f=g(;|aKbI|%19Xb$G~FY+>iMjH6VRDRUtH|TAonJr4Fr0<
z&}=|aF#UUQ`?*}0m9U`Z_X)Oz^iQmKE7lgLJCjd?TIDsHEisoc^-nKA`B@OsU{hbp
z!7l-!b<a2Q4f|OT;z~wb`4&ni&dv>$le@b>>|M*a@JOQJNE=|dFil6vVau!zBS0-D
zl9H3-p~zSv`V90BqAS}EL#_pl3Ibt|l2$-4g9K8Y!SSNcG$Eg|vAyAu)!r4GUyEN{
zfnWSRQVr_F(#D3kqa!bHZ?8ei2I0O1I~5>+3t~oNuy3pFy558wMT+~$U1p8aAAk1t
zBc*?qG+ny>cDe&{m_4ZN5K)Ho7rEzfp56)I-!E3TyX>q9x5o-hj>ym*dtN$5w0(EP
zWi!UvNlMDU$5?^yy%9{y%8Ov2d4)ZQzDk^hV5L$K>%rC8)|#8kb_R_(V>f7d0+|V@
z;H@0?ekTTjYC#esoywEG0ZQG<aU(8D6!5;mQBiN`M7^)vx+TeC2W$wFP}BL<uEZe0
z+cF4z1<{z9MD`lWZ6Z7WNE%*+aen|lga~kJv%Ms$S&A%+RJYLXk*CWZ@`b>B29Pm`
zUtwfC4K4$ix-`?Sm{d3e?l`^&$qqL4zGM`fMsF(u_4wm>oW2nmR+pFEM9=M`=jL|8
zi)=oC03+@?f+#D9;1m$x6%-V-cQ-<_pcdc$<HzEgqV*5`>Lj^hyyZ8qUnhbvDX_A#
zVu8RTFHK;QF3z^!`?lk5J(Ql7b`u$1oeznGs%qpOx8By$*xAP=d5IE1w|`L=nZA;Q
zI^A6lca`7|&FLr&nF)z7KY#s7fTC`t+79SYOlq93?~KqNNy8TyL+!CIUZsHk5N87-
z*bNMzWo2a_JbF|Ie5FFuiA^y)LHC?}GY%&zB61Xx5`uQ5!r6`p?XSIW*etZun+7IL
z0+1s}NIy}M6K^g))c3GNL?&`_A5idgch;u2W-@Xzt4=(z;v9Z;{Itb<Q7=6c(;1je
zL~{Y&ogLs`!Sec$0>*i3%xA?~jaOAR-?WznL<a&G4WhOKVa{&YMkOyVue{HH`t)g#
zwvM{FxouY>LL$M&2UO=}Ahk0j8YHRqnF98~XAllX3xre$+=%#3I5{r}IIh(&1o6Lu
z2}>7T?2-|>Z)=N5NJto+ob&=N6Xt0g-bKl!f|2iX<{w}HbSPB6*G|Fr1qai)6+^ga
zZfUv0w?mOzx!3npQ<G(p&Hi`1PwRpkAd<<LyD8PD&pqOsBIp%_GeM-rP9rgZNUncN
z`fMwBnfTI0h{}zRSSvjNqa*;s|9y5H+ztrg%JzJar(n4;h?>t}vrv`N_89;n*juEC
z;s<g$R6JvOO*C~7R_6~|{Xsey4VIu02I1#t%&-V?K|%Q7XMWcWydh9W-r|Yu19yuc
z$07QtQD@RgMB4&;N?Qz{-dtba&D*!1M(d2f-u_fpMu`ZECMLH*O#=SWA5<np=_6nY
zI|Wtzy>Iv3eZWHj5+EdBx?8tSg8EyV{3tB?Hkx2`Yk7h~$dw=Jl~Ir+LF7zIP1OTd
zB3;zYp$to4@@ohp>vnm7pPvZg&2iemg7Zh*HM#((&=C!d5LDnE%GSW8^+#C?;DC<g
zN90>uTUTIn;PH55*W}vFDnixs_oQU~IVn#H+zwrl0{wSaDhb3D@Dh+wQwIRH`uOo<
z&G_Ql*Y`Kr!32clb^ynSS_nHAoFq%F9PQz#nBNcZ1OyO?f`uL-XC@QQ%swvZCyuqc
zKAc_ed&2$GkjUxT*hoRR7KRNH%Bq#ULq$(-Vvo=c|N1BR(SQH-Uz0)h-?Q=Gd!ysx
zyxZX}Er<q}y>%$yPov&;yW4?WZ$_ofOaS+A+UlY^{QOf4KUhvK9nv5rVgjQo#JJ$l
zP;Y=<>}TrO;E(?RNF4zHK!2>8n8$2`f&l0Re1kK4<=XIA{-_^WYI=KH%a;zX|Kkx5
z0TDf~R+|m^{GUg3fx5)MIcQ~5*{^0;wZEZ8OqUBRB<~>$GO~69;7pP7C2d(3U-S1v
z_IH@j${6@>&d^+}g|MY1JK`_&_df&0D%dmX>&1Tl{HgsTQw2CC@atU_k(DKzlA~w*
z^BLq3v1f2Zp(yx|05DKSKhe|-1f>9+RZ$UKrivOeEL=|~CnuY~e$BfZ<n8S}?nSPd
zHv9EjItLRP84~=F@zy8A5qax`H-hEh>}?hnab4X6T|={{PtWBS6d>-3xj8HdAU7A<
zo0~^FCgd~x{QQ0vQ20-ERaEeUBF`WoKut$SXRvAvdZva9uWXjyzkj=XDk>4WC!RYx
zmNlG<FD+G;<-L02M(;xX)5IbOuJ>QR1*t1fj4eh66e<%3lh-pe$heR(Hon)v*W|y{
zp-9Q|)b}8Su=+D59}H?3T5u8s!Z5b)Zf|eL#yv1u14uRLke!?R{nrEzhYOC0ng3q#
z*!miL{@+Y^t{nISDmXB#tnKkr*RNgs+CEh6R&99wE%7~9*DAS5MF)q^&fcO%MmK%-
z6U4pr3ID9~nTfBtSZ(BiUCLkbYo$AFC?OS5(ew`6E2AaeoT8VY(2A>-1!au?v=8OA
zKdXamj~l=rA&-#KJBcIW`&@P&BOnmd`}|4}IDf1hZeE>ciU!4TQ<_Rvpb>f5#$_gr
zGI`BKdnmGpRw6aZZNXUyzLCsTH(Gcc-=D|H2^CmQh$B)*ZEdX|nIs~m*EcoQ;c!qK
z0%WR9-i%<=d9}9#1(T&inLr**Biq6$_<jo7Wes`xpWUVuB<7+&Pa@tkenoZlxo*=3
zy%Z-=D4WH4vL3xZ+k}eb&qD0};|qbnI!bp8tYK_`^T47v0V2x#UQ5Jf0$T-qbERv7
zOz7~&3!x}mwkl1J0zEwWrAuWM4B^d`b{A9|b82TXPxNa4zM{P@gWX7#3y`I?fZJyF
zMw-~pOtk%(-|qGYhMZ?E-w~^tA2~cIsR%@Ly|PIc(DkW!EC{Y$yM}xU@XXAf)ia8T
zTx_lfUm%5@gpTmD0KQ-Bu`fjf$dG|kK80+`61T7jh^wzp*`Mm}IX>IDx3qc{!n-Yu
zIUfOQBl#K#RD<?dv))}G{<Xn?W;9gB1<-SJYRU(}K*?d6uWCOsp<`Wlj0df|9)s!$
z#T(-OOTKxA#(7ED`uF!EphzyQtccvZM}Qbm5e{KkZoZXhVt~eN&l1cJU!W3(6|7HJ
z$e7vNg}{<`<InjoiUR+KcJo_0Uq8QBVPWKey%19hwlDVxk;f76p}y<YoBIkdHnVC3
zgh$_aQ6G9R41h})P?tEMD3It*c?f@gzVR!{d>kN*H{$;(!=tzd-64h?JAV9Y*Kmos
zR>l6tz=~e?*&Vj3c?8teyd)$eCH+|Tyzx&U;iJ$R#pCmqlE;iiL_`MpZN#_+*$2a{
z&BzQ{*dBL3$-`<>q{Kfv*xLp>DtHzEufVuN4y*6KxwI1eq7hvPBLWksh_W(;Cn@}n
zUw}f<+(@<7@K;vPd+@{lLSsT&TG~O-O4uku(1i$8+Su?0n}G8GfMoh=O~CZy<Ky2!
z!36(rf=Ypb-yJc>=%Re#zl0>Xr2)CZSA($#Hh|4RB^>KM*w3LTsd)&s%)}>82KRa-
z5#C4|dpGR5Yj)w{#dsi1zMB-Slu3gH<2#_e`o_kV*;`;rk$@jOQC2ou-XC^5bO93&
zuKjgDz<pg^`a;z#XKl~rG8Jv@D|`F<lQukEHU(fRhw}Oo7^o3b%po(JxGli^I&6I`
zXdur(aeEDu-DAVyz5GlW(<iCQv%0bp?dS@wVAhI9Gzx&++f(IIq%3E+L_|e_`nI(#
zj!F$oJ3!Kbl&B;^;giA+_yPo;4jTm<7(lld4?Rc(iD7Al!QLPbyiKNBN!y&ImdpAF
z=TlV|JZjy+5Txol2OJ_3?a30TU$BFvWJDe>JT}rZvcEtDm}@qGIYvYT*#y#xLs>Fv
z0vuYp!2WF^Vz4>S2tf6f2|%Pk5+Wp2t#*wliNMwBO|Z$&?m0mK&bt_jf&<<ENLo6u
zB6bN(AvM};h~IamAr^{7Mxh^|(+!`XA2O(jT?TLO*OEtd0uO_K1ii4bnrv#1;E-_L
z14`^h4&mjTC={(A6?lB@w<p8C{rGmqJ90gxv-2r-pcn;i$6BbTCz}KgwkFspuwf{e
z>6^^V4G<W9(%0J$`RnjshM3aQ)@JK?^V-Ci*~;pwz#SJcg12wqUTHVo-CVT${kc)}
z=3OTu5?RrD2r%K^Z$XNZKj4drieenmeEO80_A<A{=sk)vEvWt=!5v~aT@V<9&Cz_e
zOlOD)Q>0@|Fj6((gtEXfm!v&^hHkR=_+ejHrq>h*MffYfPBTQ>f*mUFbFFk|CS$S*
zyg-rM<}4${h>>%<Gglfy{rcU%r#cJ-(TFTQST&?B5Fv(u(Oh!(DFzsmTR(J?);|EK
zz!`EXM_!+>;V?Ez1|xJ-R@8^kP+cgNR*J4lS#1v4)oBBh!w<#fiWBJhU$Ot3hC4J5
zZ?UtJL3+0plHpb5r=zP~m?FDdXMZyp?B%JkO>`k?c}U)q67_}iQ>KxHee11w$5mZZ
zljaN&PQT8VjDhMl+8@k4X3dY#qkw1L`P}^7U&I*eydv2e#Z3Z88%`P*mx60{mMP{z
z2{RbQ*DC>M&6p}<AViz60`vA@(a;>PZ8n4j8_J3q*mLa{K2KdR%#)7fJW1p+pI_Tw
zcDc@;mkCX!?d&b`;zj;9hNd@wAQEaLIOu(&+4Wm4IK<+bn{yrVet-EQ(%?Mv`!bmr
ziuzCFei(gO{A)i^Rx$-iBB%B5ClE_$iA2BQ$zZUrYPAoE=7B((Y+}|Zy8tT*8Fyu!
z8i7V#6km{BE9VsKE!%0t`J7t(>r;OpS;v*HHzo(bx-HtH6Ox$~C21ID!b#~6etp6v
z7&f>!DIlPCEFT&50dVydn?*S{im0eu26ZZhf<c;is_FZU7vfK!zT;o?^7d|7{gjlM
zd1kR<H4yLIqEnT|{`VBW<{<aAO~JBN-m|v1=RpFVkdRQ%X)(2dk3;$TZ`7HPJOOqO
zaxldliIE1%P$yjc{NDriMgY`6n%Tho+O?w{%gf6Tq@+BhQ{}+pRAj?3K`4lrETLL&
zsEz-}Xr<X`28I<ORznn1?tL#6AO(nJ{LBfbUtK^kl*M8bc#%9C?i~Uqfkg0o5T81Q
z<QJ%5*<bv80J}`o)jtEs{Vk|p6G170;EE6*Ks4sUex^7RX!e~&IhO#4@>if0fZNY|
zZ_gPLSw4~pI-t1&N0ee)ppUx*dHNX86-f4jI1gSugz0XW7?j0OoZ&KLKSRxX0X)TC
z@ZGOGJb*``2Z$7GQvhGf00a~;kYMzvt#DX{)kEC|BwGlOu%TnZL{dhk<gO<w_{K$W
zE3r^!g#yITeB?>V_3vR7IT&c-)6yOcTSmQo>pniNyHJtr*kCRAt*z~s^TRa|@&CfW
z{}ne6)^A~n5_bH04X)fl7UT~!Mq)T@atd!_CLR3fbtZHg9kf+E3;g#e@Ub%Hi6~&y
zW~zS=S`kA7vZcN~;In-H{{6foe^bj1yBF4i)Eow9rsNV1|NZxBivkd>@c0pPi-je7
z){Rm_m?!Ss-JpLz2BL-fWN-J?TfxXILKuQS|4Vs*g(5=K(lQUmU<e>?&XM0Il@1xh
zHym!_|6_JM$$eA2-N}8g|KFONs9fwvZ+Csd;Jg2RRk?NW_fSW0MD$iaTD&1hq~zwd
zDJdeWlu~5~en*>w&B#x?70_3bzIp<O#5N$DAb07_7(#?qnyQ{h-LlztVGm#p4V4W=
zJ%`{xc@)^lUy$`W?{xLa^)j|0^CdU(J~C2u$}K0NtUXEcz5EnOC~8E6cs+j%Aa2I$
zV!)?3$;XegR!26xL&^@S!W+pS;cnuHxPt|aLQ(Q@lB>6HL<u-Z{n8paJRI;uDHnjw
z;>4jSsP43*0rodN?HwWS+Jds7E{P;kpRmWU)43)8<?lOAE#8f#tzgN+9UhcvS{lI1
zh40XO!W#L{p0Re|d!z5c>xA=$#8Vb4pMC<$-K>S?XWd=lB^sY>@v7n~m{NGU3Gr5w
z53&Po{+4%*2f0|IL1m0GY%Z$W{Myf)zs!`<HJH#Q!Vo7ap4@=?YyBtbr#rDSfK+B2
zU--_TLQyk+caQ(R4*q*-9yS+t{M}dj9#+P!1KINB&~fq#8bNM0X5PMi8=Ac6@4$9W
z443&#FCp&%qx`#qdTz=X&gV?%OfYH%YU4-MDOZabdssqIGzJwM;t!#s0_Vr9W2f&k
zC_JEa1jq$tEkJk(Dagj{qYXs`pm9XA%9ytd&`uQASTX;w2xh_O+Kn5y(}l~I&r+p$
z&%9Y#c>&P~unn+)KPM-bgGhtP{_`8yKY>$~U_`*;Ho7M&x$b3o^7?*<<bwxq%?H3)
zKO}ucmRb-0@gFDs|9vPSA3h)qFW8!|UTv=HK!7g06iQa(PAn}Pub%?}cJv0%o^_91
zIM*ZazcHu>;^N*7r$x|l%QarnGw+t!v{D$KHyZLoMb-W7*ts4;CUiG~z+u}%DHd<3
zhu4NI`QjLkXsYwiKFGr^xx?vjplfSuQ*=4w^C`Y81=AXq2a^PyOU>k5tUw~{zrLD&
zLK&0xk0O1;M_+WJF~1hp?I-Nhwq$nm@~88<_)!A@7As4VP}#%3Q+T9MJ=Y%9IY+>v
zznkicj*eE1eVDNG@;@*5^U$y`!_Ds;f&8J(F`1}U{g$nSU&S<!tf5uyKTa|F@}fPG
z0k-YCbWE72HKcz^HySc3Q~ts!1DU`dcm4YH7lO&+KK~oT0Ny+h(78`eU5$=O8YbfG
zs{W!41-Q^MHAi0le%P2V{0DLX+7*I^D%eXp&}?{CAT>9a^vIDT7+MgY_@IkX;^5HJ
z^H^&PU+<W)bqRD>Lib!!_KiAvaF*s_)2fl~yw+B!?ZcRD7fWtrLaWTmLqB`~gBU9~
zz5Sf4`xR+JAH!kgX0PhYPCU&5%hW&K@?AqxQd0eEqWGuc7H{+F{YyZm82!k+3~elt
zoW`%<kpTRqU0cD)|8uk3qzLL9;gaV=NZW)nSh&)2%1wH10}svs3Mp7Fes_O5e_blv
z9aM)h&dPsAgVF*lRA*m+)?ym2hK5+5-gTkfISyzv?D#byh4cO-mx>eyD~C-D4R`m3
zq1amC^-AvRKhVa1&+Spf1HJUzk|rY~#@Ynu&lv;d7KhVb%Lhg<B7&%{&e+wIKi2Y^
zuUKPqaRhAGNd48b%Wc*V9j3O6!)B{R{GV5~%s%tF>~MnIG$;7`2iXP|=M>4|wkzPJ
z?}2`BI?6gvL&7qgG948N3)EsSC?hRxdkC9fu1FSx^j;X@^RFSbbpV=s9Qr>YrJ|9p
zz}7e+E!RPq9K<3HV$}o)lYIq-B%v%Ce$bEr4%pF&AR)zy1!$EbijnpyU#vod=Z&Rm
zXND0wTyYtEN_nOfT!3qltm(i1>05s7dnp`|94O3)!TVr;caoUS;&6WxEYr|SlUYTC
z^Y+dv#(6_O#O+@>`@5SH&@H&I-Nci|9*P35VX6IcLRY&XgucO|dB^o0B?d;uN9$D}
z5cXA8rxoLfWb*9PhA(HcFxnumPN9YE#S6JM8j4$lQ?48{^xnRs?<{ZQa(6wjxyvLG
z3tf5Ko}|!`S>Dt1IO5K65QPj%z%BLBZgCh|h3mjuK+qlC0i-1uLlv}U!ANdt9I5hO
zUdP%{8&oA4$KP~f;^Oq+<%1TE2C)8uW94U48Y*$Efn4h&SUdm%8ug@K1YfP04Mj3i
z!B8{1f+?gBTo~X=&mAuUKW#_KW3*Hh<{Ng$i_|YZ0({;cAez(D(<5D(kdf<B9!Fhh
zXJ<wug*8Zg6QFz(5$tVE1X0|5aTR_KT$a9?m5yT|kKS<#NR4$ol_(w{0)$FJVxlFO
z@;@ddd>J=1V})Y{Zjz71=e6F2h549fe{P)H0K4yP+XPo|9RKdkp+!_bXrF=>48#w$
zvJdq^@fS7oN-yZzfp1O(ZbBLS%zG3?`oEwN@a!LxHPT$DT4Zt@Obndn!&G*|4yof;
z6rECzr{M*gp@q4+S_lC25}0ie(iemKW0F(Su(=3~5LBD)Nc$*sh^0Co!VDsN4m?vI
z%?65>*4GuH$tG{Y!EewQ$TqK7CgP+F&~-iG4*DAnZ_HU}==IZBO*Y0~G1H2qaUX)N
z+wBr60_a!>f~pPbbZC$`2ezt4&}6ghEBap~D?Sf_f)HffrOizVV3v?BV(2wjt{REe
zZyGjpsM%Qb?$3X!tV|pruD8KG3r%UjcGyqF*b$_$MlmX8-UI#thD}OC6L^G>XcQj&
zVX>rWju*1&8~>(!iup4!|MUX1<8W5fMgBgYENu<hf+>|?7b-&Bgop>81X(MYXjgIh
zk#2GP(tODX*iI0cRWV3CR~|!9^QXh<t&#{pf5a3JmV%@FClr{;$J&E7Pj>Fyt0L3h
zaX2U8LT-XUfn<fEAj`ld0QaP&&z_~>_k{wO;o7z15Wp03@E>hCr=cQ1+P{>Wwqfgl
zr9j@thLaghbe75&dep{&8mR#)%mM^`;f$VfP}4$a_0%yHP?&?bSp($?0Rhqq{N@rf
zn{GWZ5PPFwZAGl=px@=0j|euH0?)1ser=>l3Z8_t(!)to-OHSB$geE}ztw};Qc!{4
zo0nUR9fc9+Y1bYlxF;!j5}`jq8is|SI6*>#be{$T2@&U|$JUKyM5=xGsTi1ZhaG2`
z!ENdc0bs?n+|i&8oH5I=ttJow8;VQ8o!<=5dv=*Y-2ZKy-eMubdI8hBHCNDX0iFJX
zj<Z=%v*oK|m{bdip}<luGPxK?D+CrLTd2%0f{)0r>9;j6(m()ywyQuTTSBM9n~|5$
z_#FL)uf2tYgro`D>MxeGN8ddUo|P?#UUQMGG0f;+Z82{EGLt|PP7_cpi29ElmMv&W
zhk(GWl(LAlo<h$N(pFdpzwzYh(^rT&gN5bnR9g(8_DH_oVsV8)H99o(12EUfSp9mP
zenl8U*DP~&>U92Rm@V)UO?*m?MP~O2G@--njw3B>Be);=vrM5V7N|+&)UmxiV?ls1
z99~VcX=S&iHu6z`2r$U`L2O;gOru~7X(qR@V1uLn7E~Lgff_2*r~Hko_$yibl`Acb
z1nx*@D)c6?$b^9qf?%Y^gKh=<6X>J@M-Bh(T!CK`Fu$E9_$5dq44j<u?9Lsv9&itY
zMJX0(2!RD%`k`k2wFC$%^*q9^aB%0t*NPD9VC0{Hf8>vM^pN!fVlWdkGD_1;T|3QM
z;SNUwtV*{uCx8{JkFgv6WFG)EEh7zw>z+NrUEA<d1Mn`}vG_)0T$P=jEe=U@87w3%
z?P}$=%pi|jLSG{R?EgS~V0BB&Lm(k1gbue!z~^!6aTC_OD+LwncHppmnDqhmL)VNV
zSw?XC7;lX9@JZwL!oL=E*b2>?kP5D_u(avopQxySPmUPzs4tfRI|sdB&`NUjNr9Xk
zvCcB3RUlwH^})~cJ2iwPH*Kwz6cy=VJz@KVHB5!Kg@O2<0_TGk+C~~iPC`}Uu=<Pc
z=FJDouGRY+XoL!VhaaBoi#2m_a^+@XX3VKR;Dw)FG^9p&4KRCE?;WP#41fawE-ig0
z0$=_o(46*r^JX%!V#r3v&^SC2GBOR9^mAEtbtbLz^%~^109d_Axq4kkxx{}zR8rF?
zd}7rt4`LY7fQxKxgi0Pe4%HeMdEH4x1d}-g1!MnK3f=EvnU|ogF=GDSG34?LWoC3^
zAoUyAuaT9u&z>dK0lneac^0STwtvyFa(LW}BLL@(SX?uDB2oHl-$hB{A#kr8N`Ms$
z_-5es>tSD945H>T32C4%hRm*1(fEe7D$RZY4Ef(Ho$Pw1tpRk;&eU<C{q3@$2j(;w
zrX}F86O6(I3Q8erken|~eYz2Ae-tdXAt|eR;Fn(-^&q*eiF=Cwh>3wUOj5z;J|E(R
zw$gZ@U3_1^7KV0aFz|xQZ>Vbpp;$q_$_zpCTBkMSk3rN@JWV!jX9%4u!1xz$@ApCU
zwz8Zmp8b0rK(6h)DnSk3Vg)pxK790OvZ?RS5r6pbA)E7-h4oDLNoX<?mXbOH%>qdG
z(Kb6cP!We0L~y+gb9l-LfQtk*2a{kjVK#4H^iI~F1TzlIMhNbufYS!FLJ*!f+Z@EM
zi2+XqTzh~d_JZD{b6U1B5GwCO9DiQ<`+<YQUGS|8Z8(a#?@lq=wQq{8tC+!-Li7(}
zI%JuS<U;cSqkShCwTg<0(MVOLM9S$uVp<(rU{ZDqk@1b}=|B%Kn0+<DBe!6jq2l>I
zS2Qs`4%QENosS(x7SK$EsI1^GdEGE}9XeZ}vAIqc{~Zwe_8|j3y~Ti83EkDJ^>e(W
z5LWNO;Z+#Hh4<f2F>DQg30*Kz?L`2&Y}TP8+}JURy%Q3-A;eH1&Sk5rK@v6)Z4SRf
zVN!h2zsc={iS1KLTC=$swufl$=g_y`gqVro!T{vT1zOjw`0>j5h)~F>)Kyhg28-M#
z-8bLp*TLUWbe`X4SszS%FFy?h+W3N5FJQ<-xM_yK<kV;Itl~ED99oeJdxxMPDB!%I
zH2I7;lCOdvh7B%ZL2?yz6*d8`_J;u0uvj9XUkBSjA*a1FQGx`y8w4CAd6Zp$4q_%V
zV`G<7uZA6B#Piz?2>S*uD_AlT!L57iMROX+8ol)OZT2f;LIbcv(H+}Z7&=|Eb3DNb
z%t~8Z_6~aL{iG^ICLd-@SC4l5;X<5@ed}&EG&LpW=Rd8Q2Ujwn3PqgvC1%x|2P4YR
zrG*%%5Kzcr(3;D$kF>Grg!ngo2=#mQ?%g?{y0tr#Bv)jo;SKl!eqhgzeaVks=q>?g
z68IwD07AQHHPv<>_9Wavb9ICpy5V4-N?JzU@~Ewf34sa&9HGb^4uInt^pe_JgY$(c
z#lLQeloNahogHQw{6M6aE?r*?FY?qE-S;go(df<5B7wF$cx~ho18^9HEEX76aSm;}
zK`teZuh49PC~zFESon-pu67jwl}8u<zHN#7U|&%!d+u+G3xI{AqpEoAvOmY5NdNwA
zy@So_Lppwb^;q%O40SjEhBQJlvfztQl*|o&J`Y_n_K@J0x2NKu-|GV6YyvF@^q^a`
z+uT5K!wnmw06lq}x7c9b-+)eqSel@$^g}H}d!d8G7vw!bN&|xcp*?W^?6z~tpsbd2
ze*0%GD=o(&hClq$ZRiT<dLz~bQ3q;sd+0Q>7_UDG96=v=s==_>3TYlXKDJ=<umfWb
z`#M8k^zdMx9p)D?kMp?f6eeWeWMYE7?4y`bR5meEiX~vty0QbeMAVPf`AnV`3kwN>
zlg@GqA_*B_Td<;jgvMfMk2-;9T)?eOz(H;R7@lj`PQ$-ke}07rpOQnTgMY#|Q^)o&
zg%7WkseA;Sav+!e!1@f4YdIeQ*$=TYKpD*gonnv<kgJA#Y?laU{wy>CqshqVSmi()
zGU`b1s)HOLmkWoV6s-H?U{z)}ALd71hTK=P)PfGem;oGSP>!hXzBmRX{8_|aDdhcU
zAK<(}@uU0OPz~U+1~A9Z-MI+X$94x``8|nv$6@>d&;pBe-$IG37=k)+mdaf`u@=e}
zg6<GP2>L!iyzjYYFe`<!kP3ig)NnjOPfza~3#pkI9;w`7M^I|Ghak;<FEUkvY`F&=
zZhpH`Vc%Z8Itssg2wO&HdAwoec*4BOzm8x3O|<LwBsp?%4kD92ct8xW<2%#<(8hlm
zbP10=p6N0{5n^Z)h0=xL?%m7KP^vIwlmp#hX!8o><|M=~37r{;iVTe?K~Po<CmS35
zwKr@uLECIU1+Ft!B!!O(j+G}k{pg@513+Cmof4G`S6gMk#ByA>hVx5y>5?~;cRC>F
z8uez!^yKS6q(t-|XBU@mw%?Iz8?Lufkcy)0${z#j15C<HP`N?7MMstzw}Zs{`ofz$
zFMbjuHz+`ofu_-uaJLS}^Xh$D<h~SeT0&te3dpA6iwGQj+isuJVxVA2F88fYwKD*w
z(Cp<}hoTd??F#6OmvA2elw@9(6OCWVgE16y1GPEDtvpXL$b%8V1mQsd<;Bay39jf-
zF{9xwA+M<CWhX&~H5#tC3k8VJ!1MBNCg8L)uiCy|X19o3G6C8*95%^iwWj=d*ZT8@
zlT%YuqQp9i&40u133s@*1F<KAaaaOeLCgK7IT8OroIpw<S~N5lWU7BY$Ii~~H)38i
z`EY(8&IKaRZ|&|fKphRiUf?V>@6{3Wb_5XfYwz0C{m8!q)d4Zx1;Y)=?$B?D`U1fY
zF*$=Mgp@B3hZL$t{$gN=m5SYyY!BBjBicduq26L!UE*z$lAyS`llb#SZ#}7x;qPBa
zBu)^y<=Z@d^c8*Wang=5y4%NuRn(s_YQKEttN!GeS{~D>3m3#>iR&#tq0Kb>vWkAp
zr<Ph&yDi1udar-IosR##Xw{~T%fW*?9CzO*bFJ$CB2Z9@$&2SL)@|^6+o!DuN8kxa
zNuQrQL5pLFh1Bw1QqwYE?B${kZS`#>uskgS(CIV-eb^vFDWpnM7lG9rE;lKHTaGj&
zCvl&hA^@24Y*D_0+nPQjt?6K!xFsm43E(K`mxgW=9&toHjuX^?y(<sbi~xO_413h5
zCFE9ZZ^~{R?E&eERb)&|*7Kn<V`%-Z9l(QN!cw)R%Z2S@Q`WxmI5G*CF^sBR06QZC
zMxI}nkN{pGO0N#^+ImU#{^KwW+X!ji>7>z-+9Kn6?<EEd+j}x}#iws><#);%FjNgJ
z)q5{MC7gzWrmM_m7Oo%=+@F?l>x9m4j~uW0MsGMT(@@*~SQsj|0Tl7olImLwpHk<T
z+Za1wk^PO5>Yk6n9=@o|{tei<X+WX0w6t_WuRtMqM(2mhm2hFKN^p!kWMpjh>W~f<
z09k4SCFV+Ca{2J~?MK*c58oj+bnuR<LiFf_Xu96a5Ofn{)-d%KlAMe5dQHyt-hL8T
z0)me-CRSMGJY6qcUES_{ecb5lJEjA^s4)qw_Vxd=GE1d5;+&rbP8e;kOkQ-|i#yy)
zy{fRI>I6FfkGoURatn^Y1zy4AnhZdh`r+NX1gQFQz66!$^!#e{W?<a}ca0M4?lN$W
zF;?z_Xm;)T^%>-rpkYG8Orn6kC(FJl0s?uB$8S)r3;*uxfykLodN1u~|G7oCPQ@@L
znWK#-ad7fADzj_@vI_EUa4DNvJx=ig8p`}M02}~EKXuMNj^>eFhla+`3H{8Jz<+)b
zbzZz}P#>vlJ(0m3T@UV}ZF409yLzG^)4tqzma^XozF~}Lbk*(xA7o6ayu3VE&GHtF
z*uI){Q)mtmZpPVosp0#UV1a%E9uJ$~=?D9`SMM!mW(5<IbYQ^ZO$44dn)LgkE(Y}x
z5Zvn_Lz`^=yZ3@np4dl<MrV|k@-)=f--OK!+2RLOIa&)V^+bvqPCy6-=!wEzBoHWG
z-FWQ^PIAVIJqXqD(B^9jHzoDB^!fLclA&+Y<Q*Y!PiMe%FOZ?X1ohQOiDQ>iFo*Lk
zbAf%MmX(g{Pl0)5&}<7pAtC<?>Gu<~&L0tg*@-)kR<@Z3va^vjvCwtju@ao~J3xon
zz)dQrSa+e7neoOA3Ahs_b3xPqZZG*y(+EC`2&$%z_cDSiV@(V(SIY9q;0v-rHH9m{
zVx>tnIxyJ2kI<<(1T0sNYo>os_kSEe_{ckv+il3nQ{mblQ)s`s&CJ{bN6dQigOUl5
zSMSnk(3)=hHpm$P=ZGBquLzpIk-v^OuLcB^*9CUDK;daJP@Dx6611^1K~?q`0&~yG
zB(4W84}z5K@-F=n8d6p=RNWd*^F_6BGD@X}vuwXM|HA++E<mfyTOfne;b1c|Fo*)R
zZPJwz@VsJK+y&MQ868A5kLoRnexO(b%D)6oxBwr59El!avyzjNfTwr_G-Wzs^>Tr0
z|B#_Ti?jMzd)fpKG!+M7ho~DfgZ{(hH&W;^wf={Fr|r+)_{IPK)Ppi_=fy)!!wU?E
z=?6%eWN;&B8a+3ryYbMV24C+@oMD0mwLq@BI?T5U8i;f~P9O)a@8YywNZ*skySpQY
z(gM%8T%n;g)SxZ;@_e0krg#=SwD`@28xJADldjKsM~cvS@#6|y7y=1;O!(`K&C^9B
zd1DmjKtH^ok^m;me<PkvaT+R*ENIFyq9xMfG8xkq1@~1#IuJ@N&CR|$mSVd?(MJf<
zrlFCEX8o`_Fa;RC+ZYUHrisi9?##(pn)2vd;=U{0kT(W=lHbl|Rtg9t5r94tU8%Sl
z0AD8_RL{Gfn_mpmg7pHCLtIwqtWf&gpZ9=NAmrayqrC0)2Gs%g+$2HgNE+=4IQ=}3
zm=)kgpzff=6ncz24SGok?r&3+mX_`gB20S>HjQ{dy5jphfj8>CO(^qTZtK(&HMSs;
zgTTTX!Uh@I7o{MKC76SpB%~|K70_3+$EHiDH;IIB0v=vSM82qc@ANCsrACHMr_GCx
z6vt}2QslkNTVcS!uTW9zirUu`>53|lq6v0=Q9ZDW9{+2=$bu0Bp3S3!e3uu0+ZW~T
zQtv$@fo1ChqAnYxSoz=JVhow!DO+vhW2|h2o30XE$d#G<AgpgbbRz=UNf$&@rJZH?
zT_aeMj;hoCD%22;2(IKq1T|_6XTJ#DYB?~IjQd;Aj!<a7Jf1e<V?>7`MXN*Ao4IC}
z1m2N{Kzr^wL0@iu+Q^9-bFlfuK6Fb(W)9l=9tyd_H3;|jxAwjJv~wZ;iy~LZ0af5X
z`RkX-7tfRMt(liHflcCtdO=`6IwdvL6q+di>tJBP(}94DJ!peF2D)J&39hsWUVZnl
z7F<T(?|}zpWz7k=@Du=jw`MkvEWL;Lq!c(|zY}8$JOWkI>m8RRw5~@jFc4hOiy_lH
z53OZ+FI9lm`BrE#CL+@-FkjeZ{Xf`y52&opZQq;N8){+)0b8sIsKHl75fys{6)`Fx
z5DSQc3N{2xP^@4tu_G!)0kKgOP*E{zf(XcK1%pJIU;$|Y-)~}ec8ZYPd+s^+J9nHt
z_Sj>`;LE$#de-yI`EL_b^VGMW_L_RO^7*Vk#jh;+(cU#JGdlDqz3eY!V=<0y5<k?g
zogz$4cis^&rR61hOS2L;C{<cVyg1~Xcw|V;iP1~guP0BMG$}F9J*BC7qhB9sud|iU
zs{_aLNcjLBm)W&CJk&bBKG3}n<S<p)MqScT?(elam$j|jU9Qz}|5Sai7N2s*u1|k9
z;L}48<83He#LqUZ_DA`F#OBxP<gv!;v<ms;^d{vjt&l6TuGRTv-KXlUzf!M!(43>3
zpjPgilq$;McBi)}XR$)x#;jM}{Jp0v<fd&xt_)y(T^Y_g?x0YzyjY)=EB($0S;p%(
zD^oQ>zE!4nP^c{ZRGqcnn%AjvozFS>Lx||PfgCpfgYSzX)1N*yE0zT~*zT2=JYVkF
z#r3MZ9seh9<26!`SKnN(`cz&}ZL6BIT7_I0#PV3LdZ!5wV~#@V$HCwHU%hpe@Bc7L
zf&cB>V7u6^tG4!iDp<Bb9@HN%$6|_=q)_>Rcg};Pi@F!K$hzR=qvQmqN9SyOI1KBi
zh<EEe)$5Um2OX}~k0}0SzrI;0n53HiO2@>!nzJUOm5^#4;)45i<TI4^5u_XImlaNB
zGjY07yVbC=LBqxpIOa%5+_17}XP?=m@3HZNly5F6?C=m7s1(yHO7zH99ts$+C^64)
zIJE5pKZDElr>s%VlCLQtmVk5pz4$HipUb|)v3*uhx8JuLo2ut*8e^A{baGGISmQZ!
zPOQw&Fg_VpVMun<NS|!3r`4cjDuf;e)>JT+`-@p$eSI@_p!16l3?7f%>?qygNl*bk
z*KgREF&o*{pYgtP=1V;<n;qP@7lcvEf{I+v-PrWZywd#0ursbOA2tI=1f6MmX7*lo
z9{@Ujz9WDq-GP~7{BUEp)y@3sg<Og9yXL_bJdwW$jT-y&FZ1&sEAf)upQqJez=YWT
zyo@u(51K2BZv2)0>X*_EsJiV)bNI<)aB9(jxgy70KBuOwZslfhyQAW?wLXW4yj+$P
zOViKJ8P9pdivII^IL+MYng^Xm-{<LjJ7xBbF81Um0kfQ3H2@dr2`W8KgifO+ODnD4
zzFyWNUiCI8FS35MgmBtrpW2_zNgp3<kwhWZHz&Jx<JLWoOdk{{s>*&|Qr;ZDU6`G$
zv%C>aT<~t|o@@cV&L%xq8vX7BRr&MQar#o$W>s{~@n6La?D)eBI}yqzfs#ZLyR*H!
zm#Vlp;qU_xCudRC@*V7E_Kb8jDMa62$3B$(n8kw};!5EYD5Vyf`!mN`$KYlx0IO$9
zdmI1J9W=^QRT|Gas%ppJf)R)NQ}#q4cz4%Ip^yA&;M;Mtzxl>b{*ZoQsHWW^1Ggwi
zAqrh+rVkBpWyix>HNN!;pZ_Ucu?W5zMg`m1^?Ng<f-mF`W{2*$aj}|4@f{Cn=o636
z)(i^&WnY8C-`_<uloV`XQNMou0E_4-?)C{p!si~p2+a6ib)tU3l(ligl;>=A9J`qk
zx>1_##Z7Wk2v^}E1$&alaPM9}&QRN|M1NaAZ9FW<7>{G69`HQ7Xp7r>L%PPPv@V2I
z`-AbHooTn;aWn0DJ4Mf5d_H>KtWsA8hk2LkeworKp@r#8Z-fV<wgX&96Dqa+(nkyQ
zUL08Ryq_16m9C>75`)INp_9>$%%617@!sf-o}T&(ttC#>Db2HQcPi%RD@We&FgZEZ
zA2l>zURD>R!4dw%q_sLP$Z;e9wkTfpIA!@<I`^L!9}YdLJWZQDes9kqbfI@KAa#vh
z)SRA*z{2$@p|@IUD}YBc5+_egqJhW<e#zWERy%(79<vjOG-k9ibKJ)Fg1CJ3b*tPs
z0%^YNgYD$=PMy|JQnl^KdUX5f3HIWVvL_r|e=i^TRstuueXTPZoyRsRB{sQ&2XhZ+
zf)sB}>o;cnc#8aWx}*Z6I(?qW%da0~9YeHM_t9!SXRYQ90`u>*!eDL;ouAHVz2&ct
z)cBS^Hl}OqereV07j{HA>Tt`tup{ULvTpC-mePGjn9|`^H{T4Zw8l{>`tQhg9S!Pp
zo+Zc45eIP@seldYY($4XYP(~SiRs$Ey`ooSz4)=MU8#G<+R6%Fa;MQHNx`lrnH$^<
z=s{AW{g!Dx-;FN$l(nY1*FgV}AC;0WGHSa3AKZ%mOMV&kre$Rh&gD%<t(_iqp@mu0
zQ6<Q*f!|z@%gR~5X#o!LjCo}BT!Th^cur#KZNEqQrKGS$X|rZ7mJW?GfPF>Yjqvx|
zs83@@QNmb!^js@eD8ec>zUMb3;w>;izLZ)sDmQwN7D1roi8LpYNv|xWqRe7#oE?l<
z{}UmWc~2v+9Fcer7feux>~HHT!kWCXSaiLGrF9HJkvg%991)AuvJcI92|+%Jtrtk<
zVb~%ck*~B>f1CkMw|eVbjbSBGCKnt+o?Upfuwhglz$vHzFGB(r2<HVUQD$8ZI1KGs
z9>(w8v?)PC7)Q$*>9J~#VVHF%-m>7T-m=bsQVq4k28)6u_tM)5N&b^ZvJtT31)rn8
zg+J**%4pw|RcAX-Jamee(2sUw`!UQXgsELv^pi(cBh`B$n^b8zcBl2T1^E_zM`ZrJ
zvFQt6fN2G?`bKv-cub0UiqWmcl~M}#xMAU00VltEVJ|w54z8>=6YChZhK{j|b{;rz
z3h-v&@;5I!9=7@Uko&Ve(eIA~Y@axH?%Y<T(XQ$*NSwz4+=1C}nA%cU6E^Li8e8%H
zg+cbIvp-GZ{6&81gp@uT45p#$dxCULs1Z2j`+#|JE^6#hI(#$FZ$@aY@wz&h%Ih9(
z<!=w`@t42rvYk!WHT;pp!8!f#`5r-r;7=1kmp!dwpjW%Es(+OAJ$mDNmy`2MJXN>r
z5@t&W(OpMpA~_tU)ZB(vF@jCWNsB)u>we&Vy7(J^e_;X6u^kj`+o<6lbR-O5>g|^i
zA(lu#l0MU!R`3$-NFphsqglKoKe~87RWGjy7@*kcl6efT`kDicis$`uqfX(4uYdeH
z+O_Pv6m<^k^41?OwqI2U(0X)<E}47L53LM2+g@F}h7@Sb`Ny449%3=*6h*Ee&GG2s
zM)a0<rtYwg!3pC;r$XOJ&GP3W*04|TnH@t+=i1Hs;<425ft_Qe*xmQtAB%%cm96~_
z3=B&j7o}-cOtYM~mFo9tm1TdcB&EZp?&@lttZJU^E7eC8x8jR6bv7t3=g{d^(asoe
zP^IbGp4KlbCAuOctl0Vj!c?%|Ckaj)RPWsX*LR-KlwQcTLDkI(7v^#FXonUpTYmgT
z{J&Psf3&jseQ)@m-_%sGmVV#xRk14mE1S0q``W5wM4p1sq#%tqq}_j@-~P|Prys3Q
z{+D{}jtXVS$^zT-_9^D<9%Il%qdsI$M<*~QC1^s;I*p8=^kU5CV8eo3J-c`yh<)9v
zU#yqQH>pZU7F>moYtHP0OCQ=~J-HYvUMFaS=@sv1Yu$k?^%uO|`b{_==>*m65jpOG
z(&*iC{?X^N+4NG4{#^V28#b6a!<vn5LsBWiO<%&P%KYqOvlk_wo7;G&r|N7uPy47=
z{kNA6yzU`+Jc|xA&2_mA$3n%CcyXEi>^XA+IN}@Bsu7XCdqyJZ`*PwE+>!M(@*+bf
z)E8ewSF#VwGXT6VcxL+Z=kw5owQurX2RAiD$r-X=gakpzAT9Cqi%S=TTQ9DtU4iRQ
zmoy&ff)ScbV*i51>=a3_+y3yyqiNdO+EXc}rB=sC$#@|D$BVT5yX*J}pv2gO!5cPg
z$hzz8PNUK#cF{S8fYh$>$(Q8Ud8K7w9&QkBP8;VGquRGtigs!5G1N^7V3g!L2h#Nx
z<UW}JQ{;SH$A=Sd^J0s$95VC3$Hq*Upj}vuaK#&i2$hO{mcdz-)oDN(RlzkJ9%Ay5
z6m!Rew+=nnN-M!{c*2kyium{*!IzE>Zg&I>ZS)rXcY6u13Z{V1y!7@bF~cL%)>!<6
z>l4}wDt;wuK6ttot4<8%S#s|8!8R6X5p51En20zNSnX=+0zzzdJI^r;Hjhk17yRY4
z(}PKEx=ZK^SEsQ!e502$sp6~|Ip<}zN}$=rsi;Qo!Vh#Wix{?1m2?+l@|bRH(F%qR
z$|hh&D*p4=JRpOm65(0g<9QZPFi&sOrj2FX1Ect_)LH62w0e+8y`Go(9$37QA8A!^
z*i_~6YtKI(gumasXsEAjatN`6l=w6_n)qRQ2^0sz+b3&~;dnD$Lg2}D>Dshj2F(iX
zLHp!xC++N}MXq#O>*n}$@$E0A$5Ez5F+XJ&cA?xM6%HM)d+=ANcow!#{=WC@TgI^-
zNE5h!HmHZ&Cuj0zEwZautA-kyGTfq?s~)-hvfg<!&~J}F;x)fV?q)35s2cis@!0Uf
z;F;l*2#+yFnj+n*)I$ozRQQl(H=STbn=g)(YMvyvhEe+P(iEL1PoFlTUP=bh7^-cd
zP(aM=arSR#iV#Pch6G`c)6W~abO$4$v%JrU0dF*iahB2A+pG+^@!{=^-hI1DC*&D|
z77FF*XTBMI(}_y=c{hcKq@dicSgZB2T7w#-O~K&--0v;b-0$%r-Z^ED@jmk6NzpeC
zbcj2+1J8PZl%%((IzEx_PxMXw6)AjU-1U9^Maaa8A;P2e`)Lo9Jy*Q>=K75rwg4NJ
zc@u{p9?-PkD$O-uQgyeW7(V{EX35Bn&DAjk-@fiaW7@fsLW~(#l}tsju(1<QDoq!)
zt>)r`5S$Z3+BdD|2f3t2D#&>x!dv&8t)Y@StwYtPh*zl6;n~_&9tU(To5Z`nTk^{t
zV>`Q3$a&OPrO@&Zo$!U(1E(GvRY!uGoukM5&VG-lswj{EUG$xoDoZDSZP)cAowHg$
zhgrw9g1z<_FFu^<@I1Ud)%I}$h}QG!uXyu(>!T=&|Ck#d%y;m8T>q3AB`PrUcDi&w
zUgMXK!@tThSjHB>QmJMOV6RcX71`FflT^)Y^abP)Wx$9wI+PK9wC>B~Q(yb+-P>B9
zrje~wIIjr?WsXqeZLWKu(I)n5l!z1=EpqDDhQEE>X}_FW@kpKa={W_I=ldGiP`S(h
zXP0XBZi(2u;UE*SADqVzDw_bia*L>OJ5TCOXc|c`)S`Lwc~F)@41)Y5M!Qv<md7v;
z7wRn(Eh9Dpv}5=F(#~!<i<8Gi;P{bN=F8hJADTBf)!}m2u3gb5d<VeOyx{O;mBBBo
zL63ifsD}DvU!psgHUYq4=pk>T2Vd2aRtz62t%^T{1elly%?k|(O;RE_B7fekefuHA
zQ6;SYq-H+7eH|SOV+r()ms7~kxTCan!UwYFfLTSIKJ3f}l6CL+CL&YhfZ*oaa#>tz
zV1D*z-4wNId_wW7U)0VO-Lmeo+{cT%SeV1>(+2xu?dfB4Zx}~QLubJP9gbm<I0gsG
z>;Ye?n)mi>Z&$f_paq3(X^tLVI*?U43~6F}njXG*cB0#aPgKgMyqo<=$M)4O;ni7Z
z0VEfPc%Nv^W~bZ}QbVQPcAkb%v=2{P8t&4bSREE^^!>ip>cAx4wHvnV3dHtvF^FnC
zUw~Dx0#vUi8yi=>pTR`z^50O&MnWaUvlvf_bS5jdrphawzKXC8!>g%RDk~^kpEDut
zCprF2t#?Eb@P%ThXJbZHnY0^h*H7(_#K&o$4XOaUChR1A(B`G?1-qDvKu+JRFJo??
zcNSKn-sqN45Cx%qOYA3A1F!T^0oYTEcvAaMhg@j^hQ)Ibo)K-rpV*g?&D32BPFna=
z77&Q8a2N*zcak^hP|*HEhk{Ts4KEv{q7a&r6Hbo-A@dJ3o6v6vXB(U)yyANsd`=-(
zKKm0TqvLb!eNXcd8+x66-FpmRyyEBCJ98>&x{uIEQq~%&FZynt^Pj%lAE=?k5woog
zXK#b}sgi@>WfC`c;MZr7g}~Z)87#D0-@FafRaK<ZjPYJVa>b4j9J<<{tfZ$BN9aW6
zZ;wYX@}I}mNGHk8@7cD0@4us-e%m}gFvNesxBp$^{w+23|AS8HzXi?3EoZ$LO|FLO
z{4eR!qNhi$JkJoBU@Qv9eSK$Cy#KYca<`wjUojpKJofn#*ywgYYr#0h5twvfSK245
zAFi*a{(&9kIAz+Hv4PjaAQa$Pq|Bl=IF&GAz<8;@Xu8gkc%6MXnlkg>Jy%fJ&kcS&
zY+#Tx`_>JQGqIBy7`LlyO_kV&Rd;os%GIL+)I=wLO4HQb{E%<}K2aLMv1SUzFf>s{
zEdi*|5>#0^jIbNr&%KT+z)kzdhxgDv;j^3|>;tHuo@2%lI)@nx!-qpwOcezm%?ljj
zd@9fOq0G`dPL{JD7l<Zq68k5oV9Pg`E67+Bw6F(tyvS~VI2j%4LzS_6K<7e>S9uT4
z3J-F>ewPDBxa-WZ7zdYl51W$aoA4fbxxBP}n3YI(g-*l>FUu{B!fgR>dXEtm8@uvO
z&RgV{NI+L`2yqmNc#7z42rToJna8(gqaHNs``E$o)yp#osNf<z)%uK~HsKI5248l<
zK5JUidkhUp*TO#83BFrU7JH*rUVPY18nAKW63OH7DgUaTN}t-*-nmY@^v|}ZEZ{05
zXbwy!O*%@F`0#HB5AOTKafeL9kj_a&f5avGA}%AldcgAtHvN5!eFBb_A`P8UkD_sF
zk<hdL=0Cr=ZF;n8q|6heQn4X7^~xjsiC-4p@j!Iv4^%px5l*7l0^097V8DRqi(6<E
zZfwy*lvr3(ZK)pVa0BI%IQUIUoHjI9-~GkcM=Aa!a~thlGQmqnAvJ9`sKSy=hGyb;
zIxcM(8O7&8ORpX}>wR>tf{7+0Aq@8QTV!>!bYlPX=KP3GmVvX1(T-~0+F_q*E67xB
z_j3VO)j*V6=&!pzkD!TH4S&pxvqbC+bjp#ht~OlUw##$9*}FVdPnre?y=qb{ON~oZ
zb$%?yBHD-B`Wadijw$c*SGbxlpX<Rg_RmscETfaq<$?x1*JHIRyi~dA7)mE``R?`?
z<JvCT@~MhL>*}B0GpiV808Gj)qiUamV<(YR&LrX^#AD~_nS}m~))@M5?aVyT{i#%P
z-`O`|LLEUZ-M{!EkyO(2+_|l{srxCU)6KizY=P+gT^K`vW*?-a1++1h^%kqKEQ5%`
zCCcEj$CO6=N4wrmmv$**?ZlYKs^#%~w)h~wXvIcV+UzNIc6P7!3ImTmW<=SG#wxaI
z)$agTuX~&^7$CzVd6?Sa&p!*Ke<U&I9$^@S3$<MQU}KOoeub0V+xB@g&d%{%7?IhT
z8#<m6PNp)rYay_dBAK`}-t8VaW&RmU>eg5n=T0ij&#8-!9Xqzud2q!jx<yx4*KnnT
zoI=M@zfWl`Jy;J<Ralt=P#0+T41?IYaw=<Jr@W_T&|y(D?#<pTo~p9CqMB-Tz3Tes
zR~zayT4D6${|^n9Q9|{ryf<W{u)uKx-)?5$$Mw_=hkC5M>q?Kbal?jqY|a7fogn?$
z_<a})eZbgGrmX^D<}=p0@-@YMqqj7t^_xbUZcS)<@cZxmktAeIbSv3G8j%nG-xi^k
zr9mOEiteJHhXtBPPUjH|HOV$?_U!hs@PM>h@$|GN;5Z(QH3C2&cz9#+GBi<Fhp@yI
zcM`k7tYg#8e6xXO=;{p*ENVm14PW`L_DXu&@4DnSuGP5iW_BjQM3ChhSA1V{^}cEj
zw~mT-+YxjaWBHyuefsp9Up4RU>~R?j@~*>&g9&ErWB+s}8><mh=Zx)y1Q!aMKj-uP
z*uaEdt-M+3bk6h>YD_E!BRPgZn7o|Kos%cTqf%(~Zix=$9tlClB&IRn0;br|Q)9qX
z0G3^@W`Hl;S_Z|`)w*VnkpW-pjNIq9aXuUIj_%|}0$mXLYy)i6v|d}U<_MLhOr5%$
z2m;_^KhCT*p0Z!CBbjh&iPqY8;^D1Zo<MhUqOcomE{SWak~pmDdY3Bp^jx^9bSuO0
zxNh#A*0HXw61yMEoM1)N6BgArR#IT2PZPZ@<^Pe0#B0jaM9@nQ%~|qk+_FzpVs{{w
zzqzO_huP^d@#wIs5o3MQ?<t=kN%}Mx8MLqW<uENs`$T2NV`b{b<{E#dlm5h__<2%r
zjH>RJNLjo3q2C#$(brXUV>$DzV!HVrIEp=SJ~w7?AW5RZB%05|6GNqUegv*+K#nu<
z-kfWH?VqGY(HL)sKhR}Yc`AQFCDoqYD)7y0f@&PE*6-3(eP9R0`|)0ebjE1x7W__Q
zx5wBD4PEi<oxkS?Vh@kf@p;~_!g(s7bbUbE=G8Yv&#VlGciGUn>SkJ)8amCciYfo3
zzd<<RP;HMTc=+H2iCEgY4@bsVO@StNFMj*yV*~#F_qO|w$o`5v2mSajEx><4pM#E#
zF4LX8uG!xaI{YX%!LQrjEaU%NY2UwL_BQ|E`%3b;rKRP^6<q&TQvUaD7u^k(re6L8
znF+_7Y3YK#3m;EIVrFqZWua5<@(rqP=v|~JM_+q-PbrF99}a@CBb}BLcX9voJu|He
zmT102Q>Atg=+jbX$ro<RY~NH(h+cYm=C-x~bOGrX<ZqdYDnutORGF%oXHij-Y#Scg
z(K-fF<s_3*#v*i{LinJll}P}7!l`oQcEz(MZUAUQXe~rE=ybh>={$lBTDW>af!T8W
zkx?}n?H`cz3E9d;EU;LsQzpVJkyL&9K0+eLI3hT7Rl^S?S8n1ER4erqRxz*pR4p&H
z@2FUl60%tpkajXBPD>s0QykWkV}LGk8v}(OrlvnpzIwbQ&L5;IA~z!Y9O*u04p(YR
zEdhyQxX_I=o2t}=IyE2dl>f0~!*H)92$V0ie0Y-<o=OMDlR-+n%2%=mo%5^ItAAAH
zdu0_FT<t4tpJH|*Mn{qrfLU>DzfPTvH)A{mTbCTS%XoJVE&sW`^k*=TSr5;jggdgx
z{Um{5WYgqIIOC}*gpqv{{Hmr1q-2|Nd}!nAkE6>r(Qg~nSgSYT94;aziQsZ~?caYA
zUdxH$%W;EB?QWJK4NU0qo=L~|hEGbeijldh-1z{QK!~uZv`+cN7Ko%ud)e206>aq#
zM{z*5kF)Zdx6p1mJlw6w&G!&IN#QEQ-S%TtKRw#F_r6yVU&Pp!uQOj{f&?S6DM@{V
z5N8*Cu0<M-m6JTe?L#d_WXiaX!X?k^)ak20=sp}u$OyS8*~T+7&-U&FDmOcQVVq}O
zjE-kdOgtP!WziL=n4>8P6BsAIcWS}y8y@^tLHk6oBR(Y;Y(k<$OaeLv2+YPSb&p>(
zJy#*_HsXAStEwxe&|(W`DY*N+wB5(>{}|C@Ph#u_==Di_5}7(~#bd+sV$e*A|Bi9;
z69sW+IE;z5Vpz$OMQ%E@2q#2*&pelimlqy&(r{gR8w;2Zia%*(K-0Z3?w6%5aLbP$
zDPK=MTDoo!=p9`qHg;V_i)s5L;{5jQ+oij&G;)=lJ}+$hrcIE4H!DpOAA`iMJnHT|
zC#GhTfg&%AEVw_T<lQ6tqzemXsJ89bGiL$r0J8}G)ZIRsPLFkL3`r>=0{T31RF9)?
z);u9|r1vQn1Td#!%Ee`Q_o;_`SppWkpir0F@}ujT?C)zIB$m4E`S??NeE#`xP+nEn
zs52pA3$?`$B54`&+asQNsEf>y>;iO;W5&QI&|$kL7t_1#+_z6{)w?SovnN=R*(5^+
z<-1~f&Um&?YbreFyS$WOESq8!f+L+4ep?gKr~D)=X#$JSJafUiO{x~FUauuc(+LIE
znC%cun(TZc{Ji(*q#X?)PNoH~Ub1rirO+L?+~JiA3|Bl>o6mO{%ry*~t04aTBs3T9
zw6h=#z9J)2RnxsIgCsLwPkDF8Lx$H+IH*_hB+u1X{xrJmrTs4CUG)03be4Q$w;Ual
zumqH_wbJ5P7D?et=JHEM6NM|(U!}B_0h8@Rw*iufw-K@;fqLCr)(ALHgHoqU#9*Bx
zLR_Ys2|tV+IuTd@*3y++5;@gVg&dM3FUdtgaMd1-U-W?7yx}M@&%>VbhK!OlVwhtg
zvUwB6!}VWyx;#zQvvseb;79jC`M(@34ihG$9Ooa*Wayl*2-1FR&*y;<J3j&EWU>gm
zqTi?MKrDVwkZ|Pb!m?@A=}}S_JTo8R?^aO`FL)5+ki3r>WOek6c!_)2f+u5sv-GiB
zue?FCN)QkG1Gc9hs?9#ys+Prsu1)*BKaxfNG*o*D>dVZ{U;R`s%H<n7a>KT;ckwC>
z4N3r}+FExrdtv}G(mE-k83q!`XOC(9B>Bw#fh*4789B8$&!D$L(o~U2!?9kPFsS$&
z@sX@7$@DdhYWd8{-T5#UIrOBkrZ8kLGM9(ir)Z;I<iIRrCExnthj`)3iBd$w+`p*N
z78$X${cAgiwj;&U_{s&NcNE`B{A>D$Hd@6XSe4d>v#rPTvd||>_d{U;b%Z=a*J?t>
zzUK1OZ&PDgSBMdYmhXyoENW99*sgK7Cw$}DnRD=p0!Res@9puBrR6IT1#!>#bWUg<
z&8L^{V5+5w)A~$3;LXLfa`U#ujXI5v;MMK3s_50$LK$`=Uz+r{&ovs4oE`0zE5<xx
zfYMS5t*blx8n#j&RPla^kZe44$-{cRfQ&fZBAsVX#M;=t$zJoN4`!#E_l`{;q*SX{
zYpAAj=?jlfmQh2?f`NTbH;*YNt0#%^s;yT!Gry_*qGxo`_hIKY=e{7MOoCi6nHaJ9
z$geuY6HA1_SiDESw_?;ft-(61bHod}TuJI#6^MN2(c7#I!HaY;8jrq*l}ta@gGFl0
zHab0ORk*BeXgb-(Z{bWrC?ZX}(B~-WeL9_0GP=MlH=A20aihGu&D94HGR%I!>#+7x
zipvUbxA$pU+Z(SF_7c0s1YpW9mtEXdb_pi2u1;SR&8lsBcX}QHN(1&PJ7*7l9>%h4
zw9v+EBqq_WE^^19{i92t<aN?0U$JS+7M)hf;*t2*BMOUCS-c0nJJZFnqVHlh@-d@E
z8Bx$U;bfc-YjtJMwi4W;VrZmF$vV18`yLT5?iP>cZLZP-bmb9f62}IkDHaJIk89Ls
z)g#=y-Imp`E*xT0_(_87)<jmRIuH2v^0T@ox1)ZlK;k>oMzCy~<00PcAy-19xyj-L
zgC~_RJZ=?;M10x%f?&5m@CG>qR#GfF@ji?{sCWKqvyQ-MvkPfnZ!J2I>i!&X4i%{u
z5`a1tYfIuUZQkx!blgeO_dz-9xOLVJORe$aA^jQj_KBz#v@V?*ZP&Hbsfdwa>HQ|$
zEdJ_N5F%$n8Sr(iIS^-9Vqw?MA$9e!81Ey{|FV7jG^jKub!^?y_pG<*pHM25>*Hqn
zXLL$fhy~!C*JCKaqbzREHeZd9lSw=^<l%JXgdogdPbY~i7pcy&C%3gPe$h!WC4E_J
zS)_x-^gCvd@9r-a)(hoaABKQKRu>@L3C{D{?lGJf$9OBVWYQZ?N{)3z)nER+Ky%Ya
z6~~o6vgMC<nVS3a0lS<l<P3w#mhXk#W(viE*ztWH@ru25LQ(2*$)3qbyi;=Qa}3@~
zDSsC_#=cAC-bcwY^r->CAm}UWqy%N%?y9juv&LvqRyi^iPgDRR@{f1fd5n!@-GP~=
zl|u4~A<tL_=;*IhC{<gj3wX$L>E5(o+mUi|0^VS5kGT4%@v`scWxg6)zmIL=D5UZY
z%Dp*@w)g=9Qw$p4T=D6x8+H2D+UfFc1En*1spBV3cwCChpS`oZEYIyE<(VF<!d<8S
z^Qg`7K-yPbzr1wKgZi^8uF#^KCYi4auj#)o*>*TO=ZD?ABQtVm@9a>P8y4Mawsj0^
zAQ)c7qwUCJWUDNpNXJWUxmHUDq!!9HV3l)HI7N*h=X~O@kE(117I~_`Nhl10_+MEe
zUx{l5CS<G3_9KO@PD(C}fu2)V^HnPj2M}YwfS2wrb=>C~u5Av;Ry%N33F2*2fWXNd
zBcgG~mMB&BJ!0A1gLSm(wRJUOW|l_@S1m!3+27XHG(uZaUKDFk$G~ECm-SBp&NzZ!
zrq(}t`%n*pqz1{q2M9Y)h-X^xGdcO8P*S6JTR>l7AL)3*gYT9_?U}$amQQxbJeHw|
zAoxoZNA{yx|00S>jB;@{BU}TCx38{9hpt`QS(=>3nl|M(2!(Bf4C3L%Wx?i5czuFv
zrF++|^_&f)l+x+)+_fBK`(yy{^h2+W6_vwDh1#daDUiU&i7Q|BsXP{u!0|xf6AE-(
zc>A{><E0ItvYCEq`J!DDnj-oyH=TQ6k%yd{*uv&s+42I}p6nIeZ4=OaEI2mgM6`J7
zadA|LH#61AE4WfxfP8-jhx{RN--is@F5n`Rd<JmWea=Ve71(UG|Mfa{Rad9^>;ul2
z39y`q<ogu2Ti_|RujY(<bq3*GJU+1kzNZPj#G#;wtnTbtS-k9bsiyMrNMJN|DPixI
z>hmOB%}T1K9%Zf?w}J4g^+drLUwI_!ryw(7B#h4$H%Zm91HsHBHLkvSE-mXG3i76l
zd#4BFuxpu$){xpxo+Ia6y%m?IY;WAQ-x1^n^6Jahj_6+d(yObpn%Aq<*ubxZ6FD0o
zehOkCXt8`O=^m?s&V)Qe+O;JJt+~j?di64<w++hwB-f(+&7NC7{@7<@w_M2}#6)Mx
zlb*~Wh^4KSN#^XGQqmrDy8m^6Y49PIjUc*Ivuh7%#dxX)!Q-&_CSjFW@#>o&XNS6!
zE~U;liY~gYBZM3hiL85Lb&}9^sl9WRK8-xv^zwC4d_sEe*aymXqc^qEnF`U@9FFAD
zrDXnq_^N}huQypRk+5^o<qC46P66tkq-NW=WsBSnUer^mw<|`a8(v}A`7HUV|425=
zB!lwTO*95BH<H{0HrSmQoS6Rx*P!1zw0neVx5ai_8%K|u%<tOCC15lmLv}W;eZvi^
zcyjznV-Z28Y*Io)lKH3knfkGtl{GHkQ=@TXQH#)=@m?hnB*EUM*LtR`4Y>h$Bt$;~
zuY-(CbM!r4HzBm7*`iCfeR@fxv$qe<y^7`?(CVYMU$2zfHFg>JO*a!8GrQ>t>!qc+
z9U?bR3Nvy1Zr%;ALX%~7VZZE~4@vx!ZTOdhD|{UMip{I>t#vbX*wAAfEK`WVI>Kb4
z?k<rfS#8C*$LBb-?XtW>o{uLwovQeD`8u(kWya26{4^|b=|4;ZL(On5Z~p$}v}<*e
z<44r3`dfT(*Iux0qke0|I<j6`KM~fsT9fjA^qK(}Fgedn(lZ7Ny!R2VRT+Q7gQ`?s
z*vq|~0D&`@cJt2h2}RfZ{ET=^+pEXpPL&!PNM+`iR4yBjim0o5WFT>X0Tg4F28T1x
ze$K~V`m2a&z&_=x+ZN?##xxoHiHfa^y*kLYIMPYIVaqSpm$;1s^8O&Yi%EIj@0!Qp
z)p)5#eDG2u$tkwHwD~jZIcJM|kI^ptUKL_hf=AdmeXX~6dVVfG{~lEXmKWw7I%^3e
zE>9)3Vbw$fH)<;aB2-B`2SnG9+gel&C%yCwYj^cFOF>tj&ECNByR1{qH?aOxy@No{
zfAg7BpM*TyH$P}YYtjGkWm{GKWoJ0W)@k;4KU66I`VRrs{{`T5)$i`FmVLR(|M$J-
z|NJ(T8NAEY9~f|Ta7EF#Gdmj&-P>t!y*Arb>Th#s)@*Qxra|3qnGK%#dgGK@$G+>_
z;GWi=+U+~6|Dt7!T`J#sTs-!;`PNNGJ2Y(<8)%k2`QoFcPkf&&xcD+RVZnSCH@8;@
z{0+5tELpunvp6d5ZE?pRzW=88H@ZLcUE)EIz-a<BmVK)Jc%<FwUgR5GWy5;#+X7o6
zI>5C`m9S09RB`}3$y;b8c?;N~KJ3f~B#_|?lyoFEkSJqEz`-R6@_6^#3S$>l&T6kv
z$?c#BBSXO&nrbbM<g=mnW9|A;6gG-60!t0lN!!jT8vwTRrg#-+zzQFW!_lTfNMhNH
zjBPt$={OI|d7NmTt}dUbBx{CT=`TXRp>`^dhub+I?7e|Yt05T$??MF>mZm8(Hmr@h
zhydgWHV^8dxP(8EW^{8=F?m9gqeS)MU$~cKNz#g@k?ETZfaowjD3<+CXin0li&qVj
z%r1D&q@NBBFpNdEf2(JsHXh#0p#_%gf&7u$NRNWov#^*FgyZ&WN`zf0d8VM?fU-w9
zkFzQ6Ov{!KW}>1!(#}D03qEq!%OK>eV$zXpzyM$BQ9g}G!t+tC$N{+{pgl5KPr7R1
zjw$gDo1;m;y9lKP>gXec7)y-`PdpQEte@DSw{7$0aQ5)hcgosHv3(5C_(ufCVl$vX
zg3Ud_g<I^<(hHty=a;>-hRX6LRo>L4HiXu$%+QJbQglZ4u5Z<)8^)2i$FZA&WPel6
zEP)HM-fR6r9%3I-6uB+ZdINv;ah+$5L`!tIfQxh(wv39C_@8g~oe;H^TCy+dh#?`*
zsC@2mtCH}p0tR-YQIzm>GVH8+C~~0X(SyAyE#tpg$-#%YVnh3A68b~|e)qPtl$Nba
zh@I40`GoTPI33>iC;S_>(w>K(K$_K6gARkWJ0c}nQ+B)zq+oVykEua3{rN$t^{%ZO
z+0y=7hCX4Sr6k;TYu%`O=guRDP-#%=ExE3u+vWqFzb#G#4bVq`8W0rJSYxt<oge1m
zMWqv2P$yP&E7=Uo4mD1-O~I5v;BnKX#gOe%zO%|u@`&qbepx@!!qG7N1b>j%ca}WI
zURJ{bE#?YxOT2L8LcX`a2V|hmcd;PF*Y9oGC3Nm|6GrWt8sYCqBp`rJSUYF0Tqd<X
z&FXem9w;%$t7%8Y7leIXnPmk0Q)%@HoYAVK`YE?;aN2D8n<-+~LC(u<g6i>;jKI>$
zewW@T#`Rg#%<}U#37rda9!R&szoKZn4-ltbrf#DWcBrX(Rqwvr46`kEMLb`TT~k1G
zBWjD0&PF|3pDH}3NBbbbZh(Z^8vPd!1Dw83OxsZV!+q@!fuNsTRlHb(GKxQ+O4!lW
z8Y2v~9*7&hMT-_|%`wGRoZ<mx(a+r#P!{aM4>-GbBcCfF&wx;buv!?N-ck(8{EaLc
zO<pKN-<RK`SVw7Ym~0Q>0PN7Xv@OaJKc31hU7fO|5<bw6yTHFRTuJ_xpo+w;_Hn#a
z&@h9p%LdaIkNZB@T@qt%PA4<~d>RIk;{C{;+RD;k9CQSeq*jRZO!C@b8hY@rbBr6X
zXEiKad{LW!>ZAGKZm@+xZTBIfYJ)#XqS5wYw-Mmm+ZuT1y=%0r$$)?WqhS$`kpi(u
zv1rZ6EAZ=~*n7fX;(J(GdP{!U%+EY8EEQ=~zmgI57(}L{j>lYal1S_y_x3W3kB@(d
zGCyN4*VvsHHc{C~Hx#SsJdQPH8RE@m0V)-bhgdLGec%s)H~T0ER1Y|MbSM)U<Sm^d
zv#`VZ=>tRroH`{)o-T>K?23x~^QI|fCj$b;0O2NM5Dy04ksCNYbm2ks73sT1RE$tl
z3F>mK&I=I^Gz|H~0hXTF9(A^99Zm{m%G4B_opQb4AENdKZeK}oLROj9911%mjOV7O
zEPZyh_6Jv3znlV60eQ>yNPHf5_F0H`duKMn*{w%p1SfX9F7_dy!FBpssgZ?GcckPs
zDSP9>&F|evhLR`Xdr3l_rVnc=dP;5cORe=5{6yPp{^F%XD0E{?i(^UK>{fT7%o+^P
z#)8fk)_eS99?cHR)_pX`&w2n=5NL2@_wL;R^fwoxUWX4<Ow%e&GPO`05X93|!yk~5
zKDb@e*UiV@|6*ICP5;sYBwr=KpXDf1=2Vft;e?SO^%$>{I^ww*=3$w!&fvW_Pp4f>
zPhGe2_b1=|Xn{;DV}3EJOhHG0ovwNT{x;sE%4sP^`xvhf&Emx?DiK5FBH@F{vzh;R
z0vpU-*jDw|<xW3e+c3StQ$>#6ev+&-4b=ykLAe+sNh(?)nOx-;N~~hw7Xp!tw(<D%
z-PrU92?b#7$mS)_6v^Vc3D212U9RSvQG9|&eOov9i%N(>7);bfykJRZW{>4il(~v0
z+Vod!MgdE!e(LoKksRj7Tw$yyWZzdrbojHdWV!GXV}@HIaR`$CC?>0J-w7N}*U_Dw
zpSOkGtU;;ey^`AbeJi#<)g3Q8QImnMR*y?a#Ocjz*zBOb^M#)tMFl-l=;=MY-*?cS
zSPw!+{8>hQ4$YXwhKQ=RL1f!{wE+1Zrfzx5fi+(oIEn>q=2@K%$NA!2(9VD7am|AV
zYPQHuf`t2En-X@_-`^i#W?S3~@f>ngJzeoagKI<rb^5mK{+1!_TQ~C1jJHCXJTWlD
z5_h6yEO^}g;=H-Ty-IQ|PS}Y2Y@?T#<dx8fe}S~@WPJ37I;*pBaaLKrB(?hBgW%S%
zt=+e{n*0kHl)ygXPxMDFX@l`Zjvjrj%kVbS^3o69@Zg;ns}~nn3ANCZO<LDPYqw=<
z?~#)+3*w<l8sGQHlr+7{2lBY~i4~cS3bd;UNK_4zognU4=7hxR64)vGtQXjHAfhg8
zH#1+NVI`X<34Bi8wD5MPEC##14R1g0?IgP}h%oMqn2y-Q?zd4t6*|NBarkFE2bMy_
zm5?i$%{G{tnr72<PVL#cQDjh*(gB$xXym(q10%YTPyonz57DzD@!-@D<1p`Sf|Sxu
z&@BMazumLZ0!GT_EC!=!ut{cHR{FwvP5tKLK*h{*d!_^4Uhf+kkXJrC(uG24B_lHs
z6dLe~*x*w&eP5uWGOwSNdlhADjy;J^JIHXGf2myXFJNX#O+-Xoxf9{zv@2_p54yp9
z)LT__nxi@x(&x0r!{j+IS19oYXQX@F@PIjyXJQ%r2sKWi^6u7zu3yIjQ~BGcM0qF2
z?e9C0%0;3xnoS(|souN&6I(6_Des;#fk+y);~O_NU{w(|HS=}fK}#q2<p200AZ)vG
z);<Y}X&0TMwK6<NDIq3_%fHLO6Kpo<aNN6Q!)91m1V_G`p5fF=$9xL6_IjOc-7$3C
z^)BWBj(we`J0@k7cH@Lg`Ky|$Zje2L)7z`)*aN30(YDT|R9P`UtE!|v>{#{Apvc}6
zD5Dw$(aeMei0tHl>eM)ScLhMlL<;dbips#Lymzwhcn*@$;z$u7MG!*b>u||=N3WN2
zT?p!Rnkz>Mg4@Kc$WUxCjuC1Jy7E>~WQ>rbkQoq8KoWH--E`fdsSQdW#C00YDI|#+
zfy!C>LmY{XxO%7^9@zVqTUskAe=_oi@ppIG>?8Fkv^g_0VtStA5AKGD1rSj?H%udf
zV77A_>f_$t^XWqPoK(IXRDNV6<eVEWdl;*W{5~rrI1}X?vgJw^-i(x@VJpAOU<<j+
z?G8O?qZp_lO3zmG<>*c?*rx>Xipn~JnXm8s^g9qV!SmSU<jV*_EbNM)T{myuMbu{)
zEB;r3zGw|Z&(Dytmk^-HHt~@!J80l&erdTeKff~d+qzTC%mS%tD}ilCN5`&;y}umq
zQfK1CiA`L}_Uzds0*xEZ7&J0+-Jy=pS-233Hb!=SetrUTlR|Y$iWv$y9BS?`yv_A4
zM3tKIn=&@s+|suHQLgnQZ?)x?&uXa5bguG*o>ru};`yiN7e1LTg#v|7{*}5~UG?;)
z)2Hp~gikz!tjj3E0|j;kYD+3HxC67^mBVw;;fYeo!W~fYU-kN$;)DRJ?(Df7_TZ`>
zWxd}cdX-Wh!0nsX9&Gn&&DDWeqs7E6QKMq@6Fob<M+DD*-yW;MmX_X>Nc>lP%MBXr
zCJJ60VX`2C?a^THe6N}>W1Pzq`~tQQ&KyTe>O;w53wP^f6~k671~yr89C0GrkbASz
z*~DZQL7o0!n!`tq?9sGdR|b&g*NRa!nPIma2D1;@^3)(8{atl*f^YbIp{Axzxggsm
z`B*peL@zT$g#O}MwK)o{9CK({hi=_Q1FgxvYO8OSNFUgT>BN}eN5czZk(k1U1x`Ob
zFY~x~6=*L-n?bpbKp&yUqG@*h+{!P>aB_Y%=Sl#($x0+BF;?z2`=--SF<YC<-H9HE
zL$6O)#kA0|c=7~qm9BMu@&s`+%e2s^(T%kRouUgCUpUpHZBoE4aiB(gp>p|q7NJ>~
zgZGu#W>psS?{@Flv1GV!Z1`tOdHF7gwFIorKHt7G2u>k6`hJ`j;&^sHN=shF!8XTU
z03Qc^Aw%?U1+^EgY*p9*IVvhDVVW*qDRevORo!TO02z{fh=+0c2Or15s=cK#UG+7O
z9)tf_4k>qC^T=EEV!)@-+xX3(eyY46_OC*u1{gb*O>&rB(f5tqS%W|w^yvb1<c!gJ
zAaPk7TaCgP$b1hL;pdDq*k;_B<MJ@$aLv>c(4SApnUj|=n=-yfOwW9RNBc$O%Ik!N
z=4sbt4HcE;GYI`uYp%v;<X4oZR7|E`-Jsf7G8kK0)l4PpvUI(w;)c!6y{-74)@S=p
z@TsMu5;Ss~oEDS2e&0Fnfy3t?FR}MV3MYEGz%NK?^k|3S{>~xK#x(uo=Yr>$Qx5iW
zu2d*z$ESyQ2i*j*sj6fo!iGB(G;*pK8i9VQDDMCDo9B_}th%vL%PLRd{}W(R<$@9M
zYPDZRg^1DWuS&#z)vjLwEPwjbgZaY^R3VwNDun011Xuf?Tk#vj_)l(y(H<-~?BMIn
z2mJ;{`dEZUcNwrO7cJNmfqT%sjEElO7A$!J1YU(dwFW@zOr=4iF(Nuj#i4(-i~AiN
zRYqP`t6NOgq0n~kpc!g)y#WpM{rjbz6?-KOAJJ!){s~xqke~Z#D+@SgXYR-j0e?Yf
z(7k{EuQ^VIxTCv1&pCUy7kCkkt%s!?#!_O$#X+8Jn82ujG#6LOV93|qoI~k_rDCqf
z2r-YbMKnE$CKYV~Z!eLcUiI$luK#}rihTYn6uEjn<W|*R&oJgoi>QJ5d(w7;HD=SK
zn$n~9!LN5WL}YS;>!1xtDlV5}4^kVA-e@o|z>OxQ!>`eK>N;gjp+5iN#an-nT_N%*
zx4ul!6<=d=*dV8}8RnYmf|W@49JK`itoSo+Z2T)>gA?sTEIGWXZFZ*Q?E!G3ES<t&
zx|OB$SjRYV*O`mxtx?Qf%I31W*@%&~nW1r8cRVNU5J{Jy%w%CnF!O-iu#P!8FM0G*
zx-L#1!w*U|K^*|7*QoSB+`$39QakepAC7JlWs~o=Ewo5DWuTyxy&qNvG}yZ2q2_?4
zrvQ-X+C<(c84x*dfFVWU0v;%l+(4emC5z_79STJ1dyp^qG&qi$70Kbz`@v^{hnW|?
z&b%*28tAJHrNsHDU=hm}FTxc1IZ+hkyZF)TRO*<)5|`d#rOKR%;xbo}=(1)L*VJ!j
zdrg{fflq;dscVxd*RNW+7uZJv?LAqZ<|&fX6XU+`kf1B67eem4Mq9xAir`bJv#7(9
zXmW-`J=22^poSECT};%{Pf{0GyT9l7XKz!bE;Vs<Ja@>o#0FRs&JSGozVq~hfT$;_
zpQtGJcv1e+#mtA%_6}|Ganvq2L%rmtht~Vlx>Bx0UV^HZbRTMhWN;f3ItVdkPCMPs
zaojQGD<rV;ic0S)T>%}PToko~cfvam07Hzk-i0z*h`Y3I_+B;-Tgw05KaO=fUyd@x
z7FnpsV}Q(BNJ$Njuc~2RRwDv-9t3X-lYGvzFwh%!$~iaG(4&zt@@mN(q>GtX2|gZC
zJb(8kl{V;XcH{!0PizOC@y1l#ppLuXkpc?h4;Tp+i@5mF&{(oHcxGa8q#6>8&(@`4
z>T`*8icIzilHM~nve2AzHv{23I3u8PGBWvR8G}yqMFOXV45i01nLYcscw}KhzzDiH
z-VqTw_Gb~((gUfH$U$ozV`T_$0fv7RWo`zunpWc2+;!-X`FuMP%cl$<zLv`?AP-T1
zA*$Y$&$o@_UGfJ$nuqF0fYFTk!BM5jY`p${eqH(GOn@#yB0)#9H|wZSlX>(Q^2d7a
zU+@;S%B+blzQ!Vj<{H?r=@A2&edhDDP-q73NZ|cY0%FeI*P_rHn*{oF_qM91s;Uf}
zT&HO{Yac2{-g~(cO{Z4~Y=7Xaa4n8vXQpijSIMMZ6hKjg{^upDS;xH5LB$J_HiO@;
z#Fj80OI3q|gJOZPkOp7%y3JLyQv+i0D86Yu!gFLZWu%Mx&u^5oTyjh;T>9jM@uJQL
zNA=!Q^V`8nAImIsiM55U;y)nQ_wjG&k{XGAqi0SS@EwN-?UQR!j8+!+ms5ehG1|6p
zlgvp<Ud$b4BZ3bwv=0slm}F~fJIxMjO~C6>b+fnWfYjih^3V`DB{>ggZoCu=uRfCx
zKFzbh#&_!V`GzXnsx84!`$j2^=vK*HY2y)pL~D(_y(|i}mze-=$#iOlzOTMMH_zB}
za{j8fKez=JKGRh&0a99LnT_-C!h(~?pvB+F^YFIra9uL2{LvWpdAf`vc&LE`yOp`9
z!I)r8-zC5yWZ?wCBDje{83^!uumeMQO+++}cy%XnWw1)8weAKAUZs;cK4A(NegXQX
zo4Vt_oEc^$B{=<H_NABVi%S*P(nBoS5yX4w`J(0C-m^CnCo@#1ZjDb+9zKkS27ny_
zn9M7AkexdppUK*%Pq#`=Z&VL2RdBE%G5<;v_rbHzks--dfDTP`X*Df<p93YcuUamu
z5;g1#dAPnX7|yHG!~lX}GIQoBpwn!8)R9Lk6e>mUsx4qy>LJfSnx(I06tAx9`=UCL
z(U5?)I0)r^q$oJSJX^nri0ME@MqH1f?;8J22}%dFTiyBM2#7AR@%pl^ZP=o~KkI8W
z>!uJ&3qSs3&%!70O?Q{H0*pv_ASf>+R%5edTFcCkSj`0H55U$o*F(d1UTin8W+L&?
z&|fJHBgnn?+sql!tE1k(FX8=8L>Jg4LDw+U!YstwJJjBArlvX@cV?Z~I=+RGboNh}
zPRthOolNH@$|?{}^IZvDSy=weR*<Gjm=<{lch6WD4+t`Q-w6hmOwVreIi*&;-vNe*
z`{6ZyMGWsQ>Dw>d?fYMjj~ps91DfdPZw1taOEEDwcfD@WL?tS++9F^17TMUkvKmh(
zvFg#4`BRXIK(_^33);^c_e&)$4C03Jqpe<xAJJiEMc!c$VV_x-RURE4$(RgJi<O%-
z^&d{Pn|IS@=czOrzeL3Cce7voxL@*%MB*j_HjUCByKE}|rQo!>dWVA}{N)}g`+MH&
zd-&wfV*~{tvu~&}dZJm#GZ~}$x>h_kkBjh}FT1S2kbCye_~3=e_bFWl47f-S8C5*9
zEf8@2h`(Zk&h(<X3m=E|C|{}a>LuKI6?8St%#}mDfnc;kW>JLH)A!E<PR79>44VFf
z?s$pHLWdSySbwezq7r#NivD|?#eFQV)~a3O+q)Lm<Ny}Rf?brL#z8Ecv8decqw_S(
zvxZC;97xVDoHqB1_q^W&eZ3c{-cYv(6}*E~a1S=B-fuQc64!I;ALaPhc(?vr;E1&o
zCQ6tvML_7&m1B7W*%whEH`W-yP&~;_z+2>fyN>&iM<G{qb@W$u0DA!*(?j6Q4s&(F
zjKr;vLfdx$a}?05{?WikKk2G#s&hzG#`#S@KSqiHb|2Y_IVsoZ+YiCbCCWIkcyZH6
zq_PxSa6W)U8DRL9g^?(vm=tBp&PP0N^1pfb<YM>tFjV4HsjInsFrcR%;17m`PXMIW
z$+HF`3}q|zP4Jy~lJ}P-!od>2Gv_}-xN)FR4e#2qBjJeB2+EEcPgQf^H1WGrvLKeN
z!-m(*(axnX7;bWY?&I)>&{-MrUr~8om@vO~YKdXB&pOJjXq}r8^s1cY{HFO-Ey8UO
z9huQOyI7r9h@s5k(^KN80kK(h1L>2RvSrIkax>JF4WBJV0!b*)s8k6(Fr2u0{=O3v
z4h<A}rsRitSn3v~yx~nI12<Yk3{=Q4Q;&R&sg`;j!Ja^=$bV7hHmtqY{%K2SB6d3`
zWp?G0f6aEgWZ>g}4*h+T{cgefhaXIHm{q!i{K5G{<Mz><9e=m-K1vM<AH^>vqgw16
zEb*A1CoNpKQ2BO3CqxcNK*aGB=(`CS$T@)#;fuwmLFp=`GD{{~KQa-OtXPdeD@AGm
zHzg$hCRI_Lkmw-_%nxxKGA=9V^_shq%F?s-6iPkXIAoJ&>HzUC&E&q2hN#WWWs{Yt
zL_O%LYo*C(Cjumd;DhRd*C+v6*LGlBt=0B@FHZbyVs+0J`P$4aw1+-it6;{edWWiO
zzbdgg+JT!r8^J5|>H7BwUB@1ZX_ZlBRS+>BAfVKhjw`^Fu-aFPu&mBDX2W}vF-w26
z{>Rapi`zfMon+h{LWx`}NS%jA2p`q)o^15a-C}x9F)~Wch*0<Ne*F0Hi11txvPZ~M
zvOHCH!(-VNy?VwnZ6~PTUrAHb&(uXTO=ma{y~t%JCQg1$;L%-nEHfEgN>vCf(EkI(
z2Xm;F9>EQ>XEbp~McA5;NPqfyerElSJy~G7^$A_W*L~z?eiLQQ+_L<;d4>PA2%acI
z{sDr=<I76yHlsQm`ENyG{{*oCeEjc*<K<@maQR<afd3t>-2bDu<^TAtxN|$CJ=Bx<
zqJ3Q6M;E$KhjH#x+?rck?6Oa)PPKS?zJ@wsz2`}c9+_A1Mi?p=p8{qEX0s!jrn^|Y
zEPLL?!2k8wX9&jHco+v$cbc8gPVJ<awx<}+RnWtNq6@!;R(}jce!JMN$k}{B$TN%b
zbPGpD$TmgnG54nfr<2QY)z{Ogz-?W;F{oz9vxmQ#%Rcrw7k7t9<JqTtaRqZXl4N2g
zs({SH6~%`QW2xMX!MgM?N*v6~d!uwHw%G|w#0aw9;|~q|`onoCp-aaN7~^S~_X5$B
zDEFkNqKP_r<Vd@mR&Vf6ek&v*RGldH`E5yfcr{m+0-zA!8^CBvEN4!WU|30;^#dgu
zwcQnQR&vp$$&)9~Up2_Xa*bJqj5UM@UP&}5&F%~ii%cf7_=uHJGSa{^X>bn6@rG5u
z3|pJ3vzzF?C=vyB^_{4N670wbI}8%8-jYZlq7Y0R$SIs)VedZLpt|kDKr$w6eGD$_
zbHAfHLyiN1KQr7a3f&5Pw8}=&M<&n+Ww}_;j&VJv8R-y6TnW8@zW7)SO5(Rj`{-8U
z>()TyEvildqHuhMQnvZ9xW=K8@HTRIm-96!%9rSO#1k>7_<1wodJvd4($AVD9ni*&
z_m)My)hNqd7M(z6e_Z_02(c>4^D4Cc-;GqvjN%uQ;Y|9@NrU&#nv^il^$29=bWj<F
z7cp%)AV1-7`4j=Qpo}G&?e1)3hTf2t;`AxOQ6qk0D%7>tJ>+96$4lYv$)ZRp`C+2#
z(Oo@E1%~4Tw;z*)hb(1?j~GT0OYIlw|CVp?u~jzzl=9X7l=mYr-c*isBm#o`p!@G)
zgTGWTF#D^Vy?L&M7wIa$$w(K24Y8e!YH<q8TY@w~{zi;>A<C$39FN?t?b_GtKz?Dg
zUF%iMgi%Q`U^L{I?QfMp+UwM|O!HeHEh(s@p$-J~B*{7(@Jn5Tq9M~NL%w!>|NYl#
zW%MS~>5m<*ZTUgF+IMaKofmeeT^Fe}s#Cy4+^GE4_<kB%#@<11DbBjc$1F+um*A(_
zGm>}ool*D#$`qYk)Q#EFtiacgU972o>bBbw8O0$nbAI&tJl!cIgh`+h5wLfAK@%p^
zy2NM~{?O&{n(H2bzsbenW}4lnJ^5EK$wwO~wXYOkkgYC=4(cx63hPH&(HE4j*hoAy
zzH%#H1q{5-e8SkV4fRWoToAq*FXT6oTFY2hKnr~|HF`;p=B0`rH(=3Y@n6pB=_l@2
zN!q|-<WD!TPQS@8LYsiDuWHXVtJ^~%l`)dYiIIoZH&u=Tu8K0tnI7vQ_QkTHPaaC5
z0C0}UlqngEf|<-C$d5HBkG~(g>@(>~ZFmzU##e}YpyI%Ut_KIX=;cSSm&I9b*;kb8
zR%S{~1P+~8><VuV8hnB%+%=K8fN83mRK<Nt_u6LZ9e!bqRSXKtbO4sKhs#d=lzpv3
zwQKa^{SZrlGJ!T^_o+<Ziz><LQTD>E+!uPBVy<)My&a$V`uaX{eX7zW<QY|(023m+
z1iHw=@h(l6<D2KBN8dvy$+p8tqiHg)r-UKL0c?CW6vpBc`@HPsHdR3_Bw$0VLXxE@
zfQq=nSl)G`Q-ZnY*#_ll2Kg2h1r~jR+zhQ_h`8g<9b<2<*wzW4aWWXEWymxBSiT2A
z9i2v3ytA)3!D{lj?vcV?A%XZZ>Pu{mz6NFfa5{m4(H+|I-Ef(Rt0K;ij}_8O1Fd6F
z8Hj|5o$ZI7jmk1c8pxbxoK>NxNA^C@Z_!W|9N`4c?gmjil<mw`PPq<ZD9Stm-@sH>
zB6cveH$Yvw@Zw8_z?pnq*)w3Y17!c;LOsZ;5K)-y|7>0imXp(Ht;+!vurl#g&@Ri%
z)46s@?31BcqBj7NBZBRkny>NpV{HB+pk#)WOuIZsn$>B%Y?5RFEpQaKnKWUDz0{yI
zenLW%{No+%M@e3)U~jgsLMq)cEj~^K$hx&pJEgoF6leBQxfSLMz9N%{{^^!VJ5ex2
z{l}G%r5zPBQ!YLXxl*a_C*ETh*%qMRPMTxIT4g?@ss`%aNV~A8Wr0@i$1!aSl_V#-
zTI^@g?yF6!0Zw^Z?w?bvuz5!yKFXLTnuk}+b@|w%t@K<x-l)18{6JFdzy~UCLz}<e
z2AUrSCI|Xcv`-InXzwtdme2+y-Ah|ylxbUZOJ1mi$+rA!*Al#ORLB(>IKf#_`K<{G
z`?It=XN*-$VCd5T_869IjpQjG&TS2|3p_j)tf7xv<JJ3-<;ZkEk|<9e^_Dv+ad4I2
zv;JSdCknMY4f&tV5B5uY-^fs?BJ_*^V%)j8fBg=>SxbJIV|TiPyVDo)E-c5&^|8}S
zhE>`xyyihmyg+%{`$n~^hELubX?9!bK!`rQ+xWkI=9?cpI=^0ZTL-bm;EQ8~(8sEe
zN|(z?4RzZAW|PdM^t_Clt;*I`)?VYkT?5rsu>Z_=^FO`B|B^o7zhSre@wRHUeK7FO
zJanp_uKHONX}vg=;amEYI2AkZCWv^X=89wS!LbEZ)Y7t=W$mnT2Cf}7ap3D=8R-&E
zh@zpu{1<HVh~x|QVI?=Y=rzGAhVV^DDX5^tjL=19NW^0nmi8EKH*eKncY<Ht0F{EF
z)ROqEN(W|@B8=?V34JgMI?LbzoXHtQFap%E{i7ya^YCb|(8Z5d<yOgSayJYz#+R?b
zM1k?BCkWlSJ9(o1@vN+@yS*UB*%l=_6YU{h@chU;mx(ZUiR}1rNIe9jMLlmBT~zUl
z&CW`b(iWq6H{B{4HfV5l!gXCRWPrR%Q}nG{+mVQ~aY?wvyqjCw3;O~F4}FB{JOD7;
zBQp9ggg7KQh0nZe>pw*$D}=Zlqa+`Hp8pOwl71}zVBV^clxn8Ln@DdawgCj2s-;B|
zQcDK}%&tSpL2I+dCFdjlogwpF$}5VtRA5f}g3HNb@_`Y+X2xD{!=$i4B9qng!-2<P
zCs8<z7i|G1DQd;_s%~|w*{3LL2dAll!UOo8b1hpbHgb0SsaWVC8C&Uf218{IjL<>w
zm<1UBG0YX@rC2O`yl5RUIo@b~MQ>x4`{o7oM@MyS(;0T_X_W{PJ_`1kg|@$hw)=e5
zocjYbi;})2^KdwhDr2qm_4U6{tfFp%Fp|tH6CiLZD1y3%acL6BH12G!vMG)v*7-2F
zMIzdK9Wk5O3e##Wvn4_C=TXcO;ZfNN=A4c57&-*{l%#}w3E?<%W|H%}oOm!j>1L^N
zBW}E?K=hEoH%9q+f#Z)LktcU!1E>^L%N~PqOAjqfHY`1U3Op%Y6uMPZZ<R;9tlQ;c
zKF-!T0&e_)j%KkEG0<Q@=K%v|ATqVwvRbBH&|MDIu{f!m)!IXHF4k8LnUwUQmEmNN
zVD?|4>;)0rWRt3-qrtJxNc;3t@~iGa<hM^aH9$dJ_ZqVkNV?H*d+%X1s;Gq4JeiZC
z`+*DYo#WI>d!`ZM=zO^qF69^;8fr|2^I}E06kbeGjSRYg*gY<gdkog?9cH=j1Tn=O
zV|uPv_57P%ME4N!6iLOM?ocgyr*Ws~fz_8jV8XoGCsu&t0O#{F(&x8O=l!&83wLmw
z056#l44Dups#oxG3dJ>E_3OCr>%U}<GX0dru^AzjyiiV0J5Tk)Ek&I7y2w22D=<_p
zD5BtBse|t$eb0VB6O<zRy%Gal1DA5w=;#}>aZ6|}eRRL2y4ss?$;l-WJLq-!j_uq3
z$+ghWNK}}m+jaB(gWDOUMJI_CM7E97$r4q^d*{6;*u-ws=+XX*9^+0rNewN2D`IXB
z(|??x_3+S;`V2yPo!LUVV0r{}Ak6oDk{vn0>ADAu%Q}s@Pyp{1ut6z(nrJ8Ex#7c)
zKi#6wb_6$if4So|sDutTJUmt{#M)|%EXnrLpgw(eDewM`Y;kZJ+KR1~t+9|{n>7nm
z_T)`Hy+@rgu6>s-zBhCxbL%yh+8G;fTL`yx+8WbVo0bxqkEL@)p3S}kq~9X5AhHuf
zkXRaD#9lz1ipy|~IZw|d&A8c>S*LI4T<7*uS<4Vh7FWH<TpA%b_iiEH#60}D>in(Z
z12<lMLzG6+kqA8qRC5jkp^OS+k8Gl`<h)f3484rfVk)y~mx+fGxsx5uqj6^-1p}OD
zm%phDv(JP<hjnt4>>to-^C6B{6g>H<P_onPiqPUTZ&U{g&4(Q^6WCA8Xu7cSci(pI
z=c#Ic>9xmEA0JXLx=J%l=OjJ=wA)=1E;V-})=sAEE+7H1ZWGN!JS{Q`4XKdFpbEG+
zaTE!*g=hvu>PvQR_BxM2??g0%6G3Cps%i4A*EVdW_C8$pYeYr&=_j3jxzh$+R*&x8
zH~xdC2x4@PBTT%%wCvEF0wcH<+wC*eQ5+b!ViLUBWP&Oi#mu|wR-vw@E&@5|*dBBP
z<aWVG1uath99@=7VsjrNTvgw`rVxD%H>sYmp%1i{Ba@^#e?A>ax-CJOY?oVY^tSNt
zp=!qq$HG1+eK8%a#D98+nogPGhkXoFcR1%FFSakhU^d!+%fl7?AhXhri(G`HE6f;{
zTBRV0Mg%*70w9m+I(1md<5Raev`pAz<cMNlL<B@B@pp3Hd0`P&4Wr5`&$6h<%0adX
zaPf|aA?j#M{EKn?gFs!)OX*Nn>6a^dcf$jD990r;s6tq-kNV_Sd(b&XfA}S3jGyUN
z)ervKw|iuFQOwlT(4HCAbm_pqSRy~Drhg?k!pi9?f0fpM^!M-IV{Hfkgz)?*r*Tip
zB)@_*`tpDqA)YHP+3Y*7X<=@j`+eH79HnvgYue{G*Iomz1{4$ludVpGC^|IQCby<%
zMV}vCR+nBrulKZvMS_!tTc4<3u*&kTb<i+yz2u=2Rdn=zo(ZF=8}iRHd213Nvo$QV
zf>(`Cc3L%c>QpARUU>ADSJ}z6B6(VD#k<hxz=9%9pOFL0_lI1$UHI)ouehIn3hFCY
zE=qZGb6l4eDfkhwgZ?2m;Fkh~>P^0?UAy*q*GnJ@@69yq_suzIuysXx5h<<Hx1=EZ
z=;B3&>&n1bdfX??Vk;tD#xK#D_g=2$aowP#*XG6hg0hQFzV5S!I8I!==kKSn*-XnW
z?2e@JQupN8%FDEGJ%aBYl$Jf+TEh*@a{3k>Ub5xy`&zs2$*Xx@<M6g^#xE8u4TqNH
zMd0bT`cp~*cfY2uaSaufh0k=y{Ip2zc=UCT8|9&44?)F1UjVhoFv@%<?<5poD#yO4
z_&+8VcW}Ak@o&VzJ8i>XY?>c5_aD^hF$J88&6<gIs<H-o{qcIA3AmMK@UxQjsseeV
zeal+)#x|joLS-RL<nN;xe%}(NP$V%21N?R(`_bm*f3rm8C6OFneqMFZq3VMoRykX{
z6BF^j9u@KX@Aoku@gH8AzcRMiTz`N6KAIZw;pP7yb$=ypB9P60_*T5~kXiH~?KM&_
zqhEWHQE0iGn2svJ8Wx87%EH`04nx#=O;?L&5zWgopOkga*d(emcGzd2jcKVpbGcJR
z&C5!s(;T9osXLfd10hjRT>2K&=j^BI4(I>p=YC&k{p0)c>`_~F;qJcqVf&3JwH&pV
zlrpIQruew5vZ@*MC%;b=!zv{F*GtP_A*R~|umN0y8fH-;&yk7JL^(QA{10UuO;o%=
z-BqRHo;`N#TKsJLuxE9o*;tSt_ld(~LRv+cjN9<yLYNRx!{Dfr0H5rqn87J4b#FP<
zeS9BE&(tagca?Tb&n&0&!RvM?UqL5~lh72YKB&foP(er?&&fVCb{xDY<?<rOga6`x
z_e8F;k19R^m}#gZvzGAZcQGjb!DK~+sk5Z7qNZPz^fV<M8Oo!y>GtSAq+h9Asle7H
zPYa`7WH|382FwOSt7mzC-QBcI`tM)Gc$T~Dn%QmpzqA1M)*s4l85yfqmU1+NgC+wa
z$<cAZoVjzeNw}PsANOoODIll`Y53I2B2><Q&-qRV)b_~>nsp*J5;6|ECpT}=qW>0E
zj<?N4F|EO@9FC({Hrt>o$-qtk(pw>|X~GS1oMg0)a<&YkG>eZtr>-uMi83CT30uCB
zBEzrG;3Su?RH<_HLUQ^jw3p&qY;4~W7y0ZIR|M?`kR$#Z!d2%SyyP7+!H4I63{+^1
zxnlfe?iwm+Q!JY_agzQ@YVpScUR+BbrGSyZ5J}FZB(&pyJ5LF&7V=C;O+i~w&`Aa?
zs^9x0s#KDs+wnqban2r;K;i5%iue0PH!2vBxU-YQSBh(37hNLha<+7ZC9k)*wT-aj
zljqNT2W`HqQ`yh0qVGyl%&*#G*gZWa^+twT9#hVGazf;ND6J)#4`OOQm2;n`$sim~
z^aQtFycGZ)mZc;q*tNyVQW19r&ghHpQgU&eQ%VoHR+Of!dpZa+1#8+|MxV}^^Gn6t
zyq|o00-BU>NjbH3O{4nF+H~5`w59Q|u4nuVw(8fb@m;N2!%vRT`ug$o+Qal)3_ISk
zgZ8xao1JHWIk5Th4qdHgstljpu8pnP#`!LfS8ASmSa(<Y+fw%>zKurjT^0OnK=`Zj
z18?<wzkmGwxH_-yuGrxWXX?L6J7Sd3)17R7*#7yhs6wdPq@veN@U}oz_8^%Bepk}p
zkmfZjR9?2(X{6rIbNjLbBQiVoZ|rN_U|oOD&t~y>&up2m_`}eJa-(D`LvRf-L$G`@
zaat!yG;6oXC*~pAFF`+F0Gk;={mOV($LCRE8R*$sv<5h|7fNg~^PqR|%K2Cs(pUb}
z|3zD|4v6$XruSel7yan=#?dxAcn0EpC+U9j`MAi4!*+XdH;HLhuoWJu+Mrcoh(Z}u
z7Im|iN!d3s(WGX|>{MPq)^vhUb}}7|j)k928ngum`&9n!=2bJzWME39<SKCyHni5l
z$I`lVD0Ie&ATj{)ExZg(nF<o5>5^|;7FY3pODEB;ix`kWZK80Nu8*}j6?!dk{(eN9
zqE?VZafWaO!*3JRH(}e}$xkLK5}&_jQce)j$at7$3Z5kW8snl{sC&8Udljx%_4~5w
zcsPQ&UagC0seTBeX>XwmVYLi1Z(d(ye{2T#&?vO(KL^Z!sbHU}(=&Y@yC@$Il73c*
zC{al;@A&35qU;v+YVD*&Wd5?G2CXbBNcPE{oRH8}9PrpyNLOF-{6c_L4BC)WA}yg6
zHV$R`zE1l$^G<MDP=wOqc|qr6F%>Sv+H7+y>QaY>!3o;Qq<Ak#5>Y>i?~C91EKCWp
zUPl5qNj>c|9qew##U+E+b%-U{xkBdBN<ivplUR>^1Iy8<@~yg;Rjl3CapdA}=N)MJ
zr`$d5rVCa#92V0gY_RSukA}l)me0zr5kE3GLTQu~{ai9!IZp(-T|2ZrCK|^62uHcy
z@y9;Nva9UM-Lqpyvkj^=q$l6K_r)=1Tv$qrEf6i>OBUg#o8R}nV&)X$4I&2IcJJ%C
z2alt(=-RwNHxfY6CaiBe*~G3jsi)`T5Ino~S<(M<6D@UCj)v1rTnf_dkG=<4PI$N=
zlBUIb$saH86{m3#m(%EV)-l_n59JQ^HhR9YmC1FvWRlyz;Ab%e4|`GwUb@NIF11Fy
zpX$tZ4+m&B{jv5@vzhJGPH$>B>``p(qi|hDFCIh;&W}H-tq4o*>A<hlV?k#z_*)Xr
z3y@X_cV!%FPF$=+QydT8wtv6+236GQq8^dR?z9(3R2|9KmiZHtl0u##7MM&-rwkE4
zbEdZoBL_uO!h`6L?C5YfAwI;CH%O1&)bnt%{NlD{`<9aE@@7XPaXhq*-S9sDO1v|I
z6GjD)3+!+w*o*@JM8Pydf53p!y&>M6xBP$Xy$M*)dE5Wpj2W|-EQ1k6#=ea-v=C)U
zja`Ulq(;ryiXx$?tO+fXeK*R|LTSj77DQzXky4g6MJg&P?e)CQpKI>xy3A;<|M49E
z=f02Up6j@8M??Mk{l4GN_wzZ=_xWCm>u;o^xanH(npxqsVcPa<=5dImUHZ^Z8P?-&
zb^cHpC<jRG;gADH`OkFX>~Kdee|D#9!C5LfqmDCaZzCfk1EyB80^6aS_q^)PyX9lx
znxSHl3b=lKv04<KI9r=Hbh~z^VY3?zkAx8NM!KF8mwujyKH3P?=drVxRD9LDw+V%*
zoFDBC&UMY}u6=cgm(bF8&@Vy*?o?{iu5DWsYz3JO^~-a$E2d2^nlzywU=y2VoKNvV
zqxmqMP0mdsX1FM9&D~yywe34}FV^)+GG3xK(Z5Y|hYsB@X;1Y3K|K}giLf<Q;<WP{
zH7B1i-d$1$RX#Jy@Ce1Mf#mSyFxeS_&5ELH773aTQK{iLhbZC6fk_|wsS@rbA`oE1
zsYt1wCLU6+s^{(p0fH?c(gbLCAHdt0AFh8c$_Q{(UmL?mYz1gSQ`t683Zn?@R(@Cx
zV#)N_TE=XCs-Qts64Pv-VZtC#wa^+M@q~-?kpjp_%*v1|3d}E8QBZWUoAnWn{Sp@%
zxQn4Z;)%)0ANs)zh$&#BamjuEj`+{fpORg%Tr^#>P(+S53qvTA(1olvvE*Ze4waXa
zUEh&e6i<9b%uS8RlC{F$a6yNu<yy;nmau8x;un~An{;m3SvzZeBLUVZ-Q5BT!)Ak?
zB8*roJawub8E%Z**)MSEbB^&8SWG|8ohyb3g4iSWY28*8xva4;w}hs^<p2T{XXpgg
zYGEV*cTRVNNDLGqPT_)msV+J{f+KZ)?&9eBY8x5MtQp?9pl3UwaZw=j1u_$<F0!mP
zpKkE8ik07s)=Z3P3RYI~e2J__wiYA@V*AD{h0S|G?Otau<*m3strG7BA?gwT()2Tx
zpDA(sysBcY2fzsrvW$tAAv=dkK&B2olBkT}xg49^>j?4yo2*M~e5X#jaFOFR<@{o6
zcpW06<6?>_3nMMYBlr`VQk0?H8)19tlecowa^Anwlr6TFy|&35zQ}6vGGh23y|AZo
z?%U?GABAsdX1J35=)&+b>`YCTEnYLPhHvAEE{I$)tMlFiW_sURH)-b~Eu`#Z-|rWn
zSN_mE4YYVk{jp<*?#rxR{NSa$-{_NYo*k$7`P=ok=Gb>QYQOt#ulLUKT{Y+D{9C+Q
zRtuh=NP=1)jC^<EvfTa7+5?{A&X7#=v0R)hw_rCr`i<Qz)|Rp2#S3e!vI%Yn<O%(J
zw$XUPOX_^T6DMx?hIdEDF%7F9jv?m5zdpCI|FzB_EOud|0gkH;TB@p)5<tA5S)++&
zwbH(xYo$7Q=3D2a)&JE?HwxYJ6W!)YE%>}pI|#E@zrNT*IeP$UerPRe@W034b0fpz
zfr?s1q$adSN<+<}oE;xEd=}f#=-VaG&9>3%ht5g6(VMHJ)DmHm-diEy|FQ>ziy<z5
zR}`Rvw0G60(PgHjWYx9tkUOQYR;rQWjEdjyCG0!EFV<n5sxC7=J|B-p+TWMq@5}Jl
zt6{%c4c2KAu|i*Il(D@N@l%p@w!$F%yZek|Qcw+^*H;*ezx%;yj-9O20+Iqx4!y_x
zBbh<jcTWB8N_3_;Br&q}XWA*+VdrOuH=eQ2zVcnecbP5~2dM7?wW*GhUx$9AARfN+
z(c8G(@2b1dOOVbORa6mVFx2HFo`egS<FumY-j<`w$@y*a3*#cH-m<drN8+IZBZ@ut
z&-3fQku$q2^rbOzB@Kifm@=zfipbK~yN){JB*HrePXQ0&g9~oHkbEQ@)`XjDWaLip
z*a`UQU%jdlAwI+dAQ^Gs;`5cCi>c%9?RBZUB_56<a}?8ch7Hb?zFp(jk377<Eg~!7
zZZ9ay^Fa;vf-Q)78R)$9MtCsLX)z|7jsYt@j`$<Wrxa@q90C7PK2C41%#4b-mJEEr
z5*G496wp3m-iKFvK6zN%x`{EE`2HvVJfaERijZiWsiOTl6_c<4E7+H|*zwoi$E7{1
z4sECo9UGP%c>G`zMgB<=p#otwiU(vleQBrC)SSFGdVzOseD1NqMLks|UP?$SjK8)X
z0g3sJk6q2`3UWE|U+r)$|1CP;8Rm;O@b15&=3M#Rg(XMDnqW+lbk$lU6iOtTFgYl~
z#pr+<rW&Dl_qv|ibl?_}^+I(b*H@|!4h-K=W~KpSzs!ARqYY5io4N;&t2>gRM0Gfk
ziPRL7Zd^}V;kL~;mIEE!SgbaSPz4z`LWc+xYBnM~O3Qgii!Vl`{Y3W)-I8_Yy4i3w
zS7Sb2hT@eVZ;MemGKS%lyjvded_;?cR6;CB0&}}d2;t%1e)}yTZ2-DWx%5OK$q$~j
zz3&HM$T+I0af5R$%ae-co!h+qiufU3Q&924YAq9zJk^?1vv;gp;0h}smGu0zwPGqu
zr_V@QXURhd(PAxVoRQpOV~coqPDbPOb5y5z6Kq;#emCtl!h6d90R`t_S@sQ${JP-m
z>03j_0dsC~E|MEUg>If-6F?VMwe8Ck9By4;(56svb{_+Yl(-g{L7UV{0Y3Za=;(Z|
zFfiez=pBrQ-2>^QM`MP!Ww&MO4F!$xorjcer1dp-;1Ed(<7IjBzIJ_1jVX~k0k2De
zy@*AbdGsNzL68`zCb?O~(t`SXOHd$%ZJVm|$HKBj6H`_W3mXeL-++hJ6~&glhYQw9
zC~@G@h61ZtL<)U7&ICUKl*&JG`qmU?nUu@|xxuLTW~+oe!crMK;s+i@-?S1InR@A!
zWMlWu57ho@KSI5L`e1a(LVHs5+8ey)=?T&+jy(M!(bD0j7Iw%h-@Jd?y|LAk2rL@X
zJSkhjoE@znGT&B3Yr(Xmq3w_lTx~tcFnt+O&qnDpwnFJxhKEjIQeE&CWn+V<;)KWz
z7Ko2qps?N~v;_k>LvI&xm4SgV*3ude5Z*l&j-V34Mon5A4|A=tDnKm*Q2|qYll<2L
zOF`Nb61KKo2G`>UfTKsx!lDiu;gH?+mD}wr*{yqOv#A>~Ab$|!=9YVw6bo`F480vE
z`7bRS?Vm{8+Bddo@=t41wBIOZ-c<v|W?!&-9F0<<8nm`cyRTid)_f$PX>0_Owhpq6
z`%C~%+4o*r^JvXt;Y%o`fPh%t6n_T}1O8w-rs2ZyGSE}M{w>o%`^UEP&~K$M0{OiG
zP0Bu%L_frCI=bV-i_7ikqB<{muTTOU(IcC*^Khj*7v~}Y(%6h8)TSI3{){2zQx|#*
z>-L>xo_oV{F}G$z5crp+H6J)qd^0c$?Gk@J)lN5WzeAbGo+`sE*%pX!8OISpc<CDa
z+CO)ku;!2F241Ab`s&RO>5`c9=WU*M9qWDR_3pcb{C4K<#Jlvr$3+@o!jDWpVRjgD
zRRAhyIi%R|a3D$^YkB(Y^oL=y*^ssLcgkm~g-QIb$~5>zT9&SNe=@tUB=7U|4WYS_
zB#DPFJ(Rt3Bx#d2|1OC4tQY^m&umr>L9{K-o)|WSE>&=>8;#3|v|cCdk=TtbQpM_g
z@Lzt8(`{AFWz{_Y<pyTv8nV%@w)^u&?6rdxtG}Z-l5mrn>CQjGREW(UxyiVb9=s0Z
zu2iT9ikyyie_lz{3=R`{g1Ca9Vfb|aAo}Ga0(>H!4);42_9cmQ41WkHP*Sq|W55aX
zPy^4qy)@@&LsG{;O1#xMDy}F<>hE~liYouC)u?{}Yj86Sy%p+%n0LHBo!otIa%Q^5
zQr7h8s1O{uj(B$u(lIp6{zO7n7kST(z2*Wv?c{D>pH~!Gjm4Ne@D|^slP~{reau|=
zAE%SNvs6^H;Eg=KZ;-OTyEFx0_`l*Z*srohwCbHR4-b1&SMvi@G!jqXSyO6|A$AJb
z_<ZMdV%rm~CQ4Tujd|DA_x5fk17UYKPKb;;mAYDF=(gA}k}`hD$)UyIiM<C7EIl8i
z|I%AIylU@zN)yR+0>ii}89t}Byp3OER|e!y`daO)47>fQgS4Rt<;->I2nGI<-JkC@
zLY~mJ8g+)^uVBB!t-z%<h_4*u+RyE!)|`-nSwfE_fDDe@ahT|)_@M-zU6kHoaCDF3
zCQ@Y+r)VpjI~*nOIUjyh=N9c#FjXmJZN(7<`%N;Y6Y@$+ONnUQPW9MZt$86cPa27J
zT`FE69pmcFcu`URFth$_lC^-7+4g2MM`EbK99e-0cJGdpbHAsh4wj*qYk-ILg(43=
zC>~!Xy%oYlsFIRQEqTUJ`lnSJJkfHxNojXPQgEfA!o?WvR+rH0VHT(N)<(RqG|{55
zOZnvkNYWDa8EUD1;RT`0Tj2bP+RMJOB&Hw+n=IiRE@U0hEly>usAZpZDZ$0+nme3b
zMtI{~s>|*$V@HkrwFI)jRy48O&-7~^gG-rJOGw~^-2+B2*%2SJ+}%O-JH*sGgurxh
zWyZ@Y8GKZ0@nb`2f|wMgxHhEJ{V)n76r&MGVu2UXF-R59ZCX%Py9nZe__i#MsX1_P
zWzpbtnmM@oCSkK#rh>vQihOCro14g;O@Vex0`OF7^7Lm~7fF#8=X9Au3qw>~TX+`?
z`8t+r1z!*CtCW>HTCuyY9%EVXI~Ty#o}=)hhw|%Is-JO!xH31;gr4FD)fCg=Nt|I`
zk09CmQ2>%n7Mzk{2lfvEck_OWUej%N>n`?tf6ee*uQGex6Ld=?fbKs20hQ|1<kH{*
zuTmMGBK9zaiJbg`ZvWoVT^8THutwPo|H9Nc(kwBQGzf`O#=@|T<9IN1#<H;NAcJQG
zSTjmI3ZoUF!nX#6S}ez@{9+~%Zoj3T=n)g5w0c{k4`zTZGH~gTg_X}6q*(}Ngk};y
z6wd7siQOdeTpR=S^z;fE4C6K{V%~XT`ntS${``4>&MiwE2qmynvNcB@{)w(ao+8w2
zhTegEJPfEzhnW5(Vbj5{R~k&Wg%Py;=tJvaF_Oc|)`D8vq~c=fEj>O}uQoxit0E5j
z9SgmW*i=lJgsKO#9&B8uM#u$ys`jSjrnXhGf7PWiq;H2JGlPLK4xuth1STM2r{}9G
zneqIi%aujzR61u^Rqi&E)NxcTvN>@9W>h~oJh>O|U7!qreZ+c)C0Y|U9gp=_OTPNB
zLf<%MvA%uQaEy^MD&<q@zOuPjRwcibwhUTsaG9gGr!wyxNJ9UqL-2JQ^mubvwSxJ}
zjsivg2rsBL?{?>c3MbRhZzs6UdQYjRMq?1_<Zxl`!t9kabcP|~H=2;wKc;pGHEZvJ
zN?@bZUfSdFqdPoV9Njk$jgweNjPVmx^NI>je}8#xf+mwF1P@!Ba||%dPHK3$m-UGV
zsGRACs!JwQ@fdcOKIs;wwgJ~m9cWXi?~T)!Gi@{pJ1pt4JfO*itIq6=oFo2R%#-{(
z&4nJ!An*U+gD|@9#nvW1aU{OCEx&-<<|qt{e05%>LNVZ>^iMnGSU4S`v=|cbrp39v
zORA=QrmlvD#tcbzlmRkhEbL&DwNlOf=|=-}>J#;fhe{j;;+!OL-ht#GT?QXn_AYUa
zu;I;04zgquCTO(`dPTqo3sKlT$u#$VOhiXz+oyybK9*?5!@*3(%Y5ldmMMM6h@;I6
zk7M{P5>9$$SrrUIB>>hp^-Pb@`$C$gwUHnfHg{~k_R?Dpm0qe&KeXWAx0rWqD?zUX
z=>byVElqN(o|>E|Fbkr0p@d)*Wdcv4oHK;r*!8iqg{lA!fuX(xXv#6bDPzpARxqhO
za}NdrGjK8CsRsiYnAknl;0NSU<sofXt_B+BD4h{6&G!81hLNH{Pj(3S^~YVaj)95c
z{Pg83#~?kgDH9H6a@;wB^U0CN`oeW0nmnJK0ckCpt2b}n&fI<t(=XFdi(xR^gYknb
zxbldTNk*p-$osVUG?39=H9$}B_XAYQYa)aGqy33G`hWURz#!fo%TWm(YTaYJ?)-k{
z=LZzIIlZrx^@HKN8-=Q2+WRroD|mFFbc`6IU_I+oV|h?XNw<9?0}5Af<(?1cZwE&m
zkMz0o#Kwx9b#4%&l|0lN+fcI91?+gd@!h>`SM5pxm{(UeIvT4VA#ca^@3#YO9v*d#
zBG{VtRNBXh$I?zw0Y%lmy0N(7#>N?cb;b4CTgBqUAo<0JO%~8z|7Snu3ysD1@?y2Y
z-lIeoPYT#O=UhFlYy<jyEz9FlVk6D$fp5aH&3xAg{NdXC-OK2Op@%X`oK5Z9OFNsD
z*GMZ}t0t<kvMrXiUFLkRi+L#vw8gt$`DS9+moR+9-v$2htQ?)f<BZeUaI5b@>&vO%
z)l*4nqS3pH+kKhV>sH=$-+OTE^+bgn;N_@yKamG|g<Wo2*yWDgpRC4WNd2xgo#9BR
z0hi@Za#t0wgyOy@r)3QpB9arO)s2Bcn>wkQFIsALdd`GL4X@x5)i&}p>U}FR^hR%5
z<M24^v2lR;?<wft!{E1P;w3RMGeKs!*sW9il<&Ul!-#Ih%g5&pcA14-EE*zN)70@K
zM@m^rDz$n=p6QN%LIt|*8`+9@+Dc;R{^#@KzCIr*cQ^w6uU@J@W0vC%wfMou(4(b3
zaHt&|Hk)aXB+~pNS_M-KAz3j#4X^(W>vuCOASH;4u02SY)#7Z06^2@cWnNHA)#r_#
zUP|_l1IO5=MLM0H9%|9?4tiWgIenHoIN>D-_XDVsd3m{7+T#xl5viLbHg;N7G6J-B
zEE?P-F_fO%Yg%Eb0P3)4NBP&(K1zMcMwr&fe#3)$$y?rP1Sa%L8A$|LL^+FHbx~yL
zL|RKj@9XeJ@eGy%Er2#kXr!V^L?S8f9YdaMpNc+y(30GQ0G)F_L%otP=j>aze&mFD
zy-b|+1Ey+9!abeSUIG?zrVL>`Dc-fWAymo53&P4-($M9f#%$|BK<Utemtq^v7ZPfN
z4~(RC^}XgUxu)oor{Gw`^ix4_Iy9ZB^*Y+~V3*c;<ZyY{7K5hF<1cxeQ)ofOI+`-L
zUqK~+M*5N)U-^dK4>0LE3j<!?)Fq5fQtG$I`yMw5Dhlt7KROeMr4;z`o~TLhj&3*W
z2tw(p(qV`}K1wf~h@6~Z8Tucbc_Ot7uno=r5ZthLKm>+NHmu}QldDa)G**H%QA#r*
zJC?4lKx%!uW<{DP+HC~z#<{zBql}935%;DXsxRxAj&_@7P72%pQDsxa+{I_;D-TwM
zU(xb1E!73DwkaD2_tC~_G!T#$YVK)i#^r63Q<${9_f#3QGF2KO(RdvO&HEYIjoy+>
zXn<m<O0lT86C2fC&6v}ggk=jQ-@@Xc7}a9<vVh@$qBp}Lj@Q``J6lYbg)Z4=+HrV^
zk^;DGl71k?yb<;UM`^^$aevY*C|CaA{pz}6w@?<!u+rZKazi#df8|!XFB1=-z6D`E
z(Q`&QhE4!o0qAl6ti2zR^FE3nAPZIcf4WMA-x=0MLDcL#b(Xm=7rgq;Ha)_W7EO{n
zNz4(ZULb5bZdX@rv&QLPS(P=#=mq*@&V%~56+U<u^|?R(I3G&}lXyPdSil<Z>Q6ji
z8VA#1`uh0HAlls+%j;FY)p*nXA)MU2>JjcqvItD#A2Gq<dNKN$0k5`iouMI#^^Q=k
z`>-s;=Yf9gx6lTzhG3UyEKJTZZPqWCP{%Evwe0?nCh?vsnq3OQPt3OsD3JAs?C~Hs
zukD2wzuf3Qm86Dg11<oxLB(!Wb-qXFH3^CQ_=7V%5(#+%e#FD9+S&NFrd!WkcKVBa
zCmxcn@hq(QFa}I2>f9QN8%#fK$*2~|?5y0JoVKd0jmi1vNh^AW$z3>s17eTWN9D61
zp85qzN5<st=8=?V-lW1IQ)RhzERbT5%Y;XhHGzOSTyvLZT2nJD$+5NIh#(#TsTK5{
zo<pAE=jP-5l}!iLAm@d`!saprJXCaTsXf%18&B+APP2KhGF%0wBhFUe<=dccX|3At
zFZRpYblen#?pr-0-;`}Cs4O#AG&OKcOwLKK$+}S7#gCh=+u>dFM8ho*5~QqjJo-*Z
z(;2I*W7u&YR&$nh1v5-4X2!U>OtV$NQxM&~+i!W(puDHMHPmT&D;vi|!y<7>w)yrh
zgmRl4i__T&4<-3-bh-`*D;wHRIl8`?Ewr4z`W?TC7}n;~R)75=BxQm10ZbV`G~}$p
z+rv*kWYgX_cV_4_obQ$~H}oEImK8~k^Y_V`wDDk!Ff|$O4|_U)@1tghkdaNRoODL2
z5%C9<8^6k>a3r{ijV55`hLMK@rVf(2pDTqIW#f;?C2vGl2<a7!l!Gp>za@#!NZ2Vb
zz|{vI<Lya;2@U=;y81hUY+z%uJ2CWF*kQbvAvSnNn&@LK33)-IAWildW`B^$&tJ(t
zC0G+5$@rQ(_eG)|dEV|pMhJmAJCFD^fRKG6rcbc0d#V#-BJtSEi^cH3hVFyy*EfWS
zX+BQEVq=TW&gl`3zRe6n%`d##9cqVr5*J=hT{aKN1^}zHiz?p<ryvx}&1zlucbDhT
z5S4)Ltv3pwdtljv`HX^*Ebk->r%idB^TKQHSTmXe7tY}D$<>|cRj+4xH|-Sp4zuhp
ze<&Q>iNngL!6S-En!lZoDFkSMBGAep098&sqiMDuZ;ZudCZ+o>b3bG&k_!$H0eWMy
zrZam5^IaJ~%HR>P20uF=lCC%{<nDgQX|}jvfo(v(O&Gxj!Ucw+gbj{tYMi1IZBMP2
zPCEOlmof)}7GBMNMsodq!WO$pRaHc9s47IC{~vw(nfYDg7bAU{;{R;8t<v)@+G)oB
z&SU=_F3G;?qa0!;UCN)(Z2#*WTyL%F?cE&Xc8|Y$uh-kDnoAH2Il7Yj_6In;YOr><
zHz^S^0^Z&?<h<Xnq35VL#>U5$R@&>DKY0nc<mJtm&}ByNh!3@hdeAOD6Ts56lN%<m
z)sHJ9Ua#D1(Bx&qu$zb8tN%<bG^g&>%7};@o16-Bj#CNrV=)GAEyx%;ixtT$3+x?4
z>3HyvkEQFR8Ov8WJ3EJm9S%x8ja^<!eVv9y{EUi<6k-ayKYeK&*VLe)eLz7ab*cJ5
zZMBXaAus`=^n2?PKCMU_@IyjNXe0V#9UJoI30J|}EAM5t{rO+PXw-}M<?wbh`uJqx
zA+O<WdES2Zj(838^S9f@r-o<Vt!?koP&~i>vy!=4D>@QDbT_4=rD{wbvxcLjq<o9k
z=;V<zXU_Z@6D)a^3;~9`ICD1{^YO&Qc#W9j!Fu)Er%nvi)}B`G%%K<lAg1A3VWmW^
z|C-b8tMA&BR(7>scc|gBX^yKXJY_nTjDX?a;09W3H0?@Cr#8GHaPuFuzK;pWdy4`5
zJ73p*n}!HKeqKbm`mV*4yGeP`4{3~1cHklXhkO4oEvN2F>rrp!-^*I5KJWVPx-=!F
zH}qZm$8qi)wkf@20R9KO<X`&J{pZ7G1KJw>)h}Iay{@-alkXXH;5>ENL;1HBZ{~gU
z%J1f0DrnHZUxaru(tm$ckfx7r^nrt{&(yz>Pd)q{crP%*JK1c1x9dXk5H!U@d3bsf
z^5MbWO)jlv3KCbBIJ9=1Vz)&N8TO@G4{fEhe_V2oHz?zRgF_<5B3oAS_Lr}y>lQs~
z_$}6;(OzNlx%~t)5k|e>Mg54mo~92N*lkiC(C8t)I${Iw^*}4t?>9Gws46)&V}hvH
zRr^w#M)~jsL`+&QGqPRX``r*3qKV|M&|o}=XF9dfqc&isSk<==d+*p^d~Q?@rw3X!
z8Q%yFeYNS&i@s!}KKE+V-HndnhNq8&N`1>idBB^o>N}o+)e%n&y_M0J-eGT5Ek3?@
zWHH<29R#Tm+}c+a7gF#pWeyxy6KMJXqO?dW&xKC<!<8wXd(EBFM>1&Qs9U~_U(A$j
zSh|4)oeo{c&~zOpnT(H$GMh|X1w~0L-1tlIcl1;qH5E!}68wg)GLW&~J=9P14*|48
z2M=D%(Un8m{GgtF<oc0c_EmV+z@3ht_AoJaoNXmZT}x9;XGr7(GEIv1P1Ubo1PhbY
zo9f(?%CsPVFmsTC!y7xjTAJxEIfM9woJe{hX%fUArGOj2K`n%AsQ?tj!*+Ufk?%#m
zkPLUxOw#qGh^yM|Q7z^p-3YG_cP;YvRzBobe*q~c<@LNLg_FQ2m|hmSJ<V2U6u$t=
zyW=sZ;i*riCi1GOXsIELI`WhrHDsu2z-&IK7H`6MJ*VELl^t(=NRH>gp;6w<n;9s%
zK8o4c71<_&zNr%jcP~o(FktM65o;J14y)UvC(ZXyKeenVzHBG_h~hBX^l2P%T2KiL
z_z{?G>38dLx>In%5qP;YlfM}DN~3&rPH%c{ME?90Ha_Jq9_nyIzMslWFWKL?1!r$Y
z1ndW10Sc(Ia}m%^hp&J5Mse*$Daf%IUKhRKsLSj7b0sOo5c`~^mp^Q0nEo1yr?IyI
ziEYeQjvp%5nqVCZ(jhc8xtW|LcWH3TU)|6s6!HMd+m3@n`p3Hq8<2s0k~pTbEQAr_
z%!|vkYo+V0x@}X2a8M|XF&r^1{sBo!gH~1A3&vxKoochN!&q1;F1J?)tt6=I!|Dz^
zfo3=rhDc8Ru&XzEAK&kXd)oPiC>;ywTTnzYFYi$l^To@Z&^N)>oSi%FLlTGOu|ZL0
ztS>E)M*Lz4Av<r-?&m&SI~3~2jvF{&9(`f!)~%20hgDACEe>WXheYdNbeaV_R}e-d
z4GSG*ZjQ{l+kBc&uJ^i$26ao3xmi-{i80?&sJAkY6Sl-ey%&RI#>(pQa*mWt9%iPd
zSZRx*j_)zutZYzQvaaZSPID>J<wtG}Ege7Xb(*zg<8{mDs?mZ;&Qh>T2K@eoM-L^e
z0DtQ?1|#Qt8m=#!G36f4ESz`sQwB!Y2`=!Vzs-+!!(ITBWo!<X5(m)tO~Wgs1Cgh9
zD%Bb~M8SBWM`OL3c4`1;GOAyW+FQB{0(@nhE~>h`E@POs@@<T!i7hkE#f50qtLq7x
zMKK{Keg$NLH<IMhs_P&EStKHvLRReEfD*aspoAyrU6_-iMYj}#FjxkT;BinMX2R`A
zp@~u{j~WU`Lf|GDaPr`e2j)2)UHAH7LS7?^{qNWQUW9Gkf`V?@pD5@ipG!WP_S5$5
zN8o5qKIHOxk0?CduqcoPJc!g1TDA%5u9b%^R=pf8Ee8Tf??>pSqd@jVpeO=)8Ci?z
zGZpYOiI7VgoVVYf=RF^q`)!#?W1MEJ?lLVYTW78aKoN1Oms)1dsMw|qg*=I2ib&-p
z@f^1344!a=k?jT_3p!+52_kV6t6nec-N7)#h1wLVix^Eqdw!7j5(B~@1!mK%Su;o2
zKGRp$`dWt42}ZzF4!4eP4!K4eF2?97kP9^O4Z;osqdbUOc}@c9kqQVHrXVZa!@m)i
ziZ<ny#+IiKW0eRQbuV#mIGE~zH!PRc#y#WzgnI^AMF0h+<bGTFC!JrMbH*WW;>lST
zr=tY+wd|T-QcPr%+E-Y)i<BR)3CirefILlP))1v7bzH;+@=8P_2BejMz6qpN4QkX1
zGLY9_pW@?YZHC9o&ac1ODN`b}_@8g*$y^>_CV9iY*4&)0;um*Ogpz_K%6;|kWP`3p
zw%IP~B#6$Sh2$Me+MbZEfI5a1=xYu0N@CyIPM!k{3FAeej6?A#5jRqD)l?j7;FX==
z8egj&Qbbr2xmO9h<A=f6fy3-so&S^g;zNn`i40V4t`3A^5j=88ZDt93M?$=omokT4
zKv^9&ath_|xdV>(zExmR$0u~l-`qFkHl_mIJJxU7@DGVXx*e1Q-o3cQNUR$^iun!3
zo@#@)qWYilRyFaq8Gz%Klg$j(qk<&IA>dUSCt@&o1<?7FUTvmKoaoKLMF@PiF{$Pb
zUNYp%cV(mSO&fqRYQdzcZQMe~7?%GC>NngZkM)l%87bNoP#E9D8SPX7HwWSRr}zjQ
zx)6|9-{A_P3sQb`Pt$51!SZTXc+|5Wd>5mz!{^VNfnWqLUC9pWh`+)(GzMu=E0-s0
z^4E8djM>&j9ZI1&g7zKJ7ARl3`V9TtaVD&*z8`vE%n{6az4ZtyxnXy^_L;x@xJAFd
z(wd`69AXO=cUt*8?0kIF{w<YT|EX7iGM!fCduVWfQ?y)Rj%%Lz&q&u&_0C}AE4N!L
zP(`LA@&z8?(X)!PVEaq3WS?}TBWOp2<SvY!`D@2(|G%&d=-aQKXLWC{f@Q*@Ve8+q
zsF*~oIPZ>qc|x-j3U$B17h&PK^e;p)G8;fuaWy=h7k0}RM}~;dZi0_<6mRR64=U@M
zqf6@FsPN1~H5$&DM9Bs`Br&fYz9k>}&0hOw!sIiTX-!LG`NMh+b~VG(r|iO{#?<ya
zU=(G5PryTbqg2X`Rv_k)1T!}J1Wj3j+~BSXF9<gLYn$7~B|36Cusp>V=t!*HJ@u+b
z-RHk;Ghov0r=3UG$N2lc1<@dROg=2UCVuI7LQ+C_CB{ppt{G9ompUFdL6hdO|CjD+
zA^Q}Pb>A&UGju8jjinIuig1AvwAe=^(il&Q8_Onwq4*HrxBC+(7RPb3e3ZpuW`K%k
zWGhQ3b{ORa=v=`EBpAPVK~aaSDES#Do%%`SBC>T%fncP=Kn;h!RM3&*VE8u=85q2(
zvjco*-%MHiVY4#}A8Ioonul$S(3(I3x}<uXN3X@~EtH(WnPL>c4lX~;v+@i>fzw==
z43hXJu|=8K1;|&Z<L)8S3K9<jj6rU5p!s789l+r)$+Y^FSxq2K&SD!ogr(@WIjLos
z$@{vsT80&SK3$cV7EtJg+Js!_@#?Nh(T9E?eWucq1ud|5#PFrFwkU5cV{_~y6Z~|?
zU7W#XAan&BYu-cZl4MkdnMqVbea+S*JUpY<3}2n5WZ5Y2%o<6xj>Qc^LJGxZ80<~-
zPPvvP>QzRS|2-}O84`MPQIf6MXN+B1NHs1nJib@L7{+n{zL~_M-YIl`cKb^)Mjhr{
zHW|VerUf!3lkf)7Cv}PErivY>h#62z${dKhsfQ}^d{JD}G2oILkiq!zYx>f$;F|4G
z?GowM;3@&MNEsO-k$as?xSWS_N!zzt#%6}9IGB_)VQ1Q%{r;Wd>7R!-GaR_=mxTq>
z_^W~c$!4`F^+Uh*diS**`?T|LZ{NS=i;nF)p1yylKR=&#?L)s8;!hyHQ!V%dDFOA4
z<G9F){#VnkpADRfSJ7{8oH&4^mWba#|37iz_}|p={`Wuy!X6jw6x{SZU2o^|>W1g(
zPD{5xx!lmuSM~Z&Er03!-qvqcpXznKb1Rcph99@Rf5NuU<gd(Hw$d@Y6tw#1&LL_Q
z%Ip0MyG-_f|5KIWCMKWVs2sZR(7h*tFYX?+K4&*9<!t{$nd<dLy|<13`of~eT90z;
z2IrN3G<(kOJ>$FF+V`m9!qui`UusuM)W-_YznPefdMJO<Rr^$D!Fkd>lrP=+5iWq#
zM@qT_oL=Rwce~kD*F(8pWXYYZnq++uc6pf9x@#WF{XQ0y?~MZ`-u2iQTy5F{+tw{<
zS)IZzTU~AX#d>kZmnnl%XMjOB@txR+5hls0cx-A~HEDK5Adxp|MWCYwVod;f>QNW%
z^TxKPpm~2N_At-iWaIgyWvPdO@}Wmsgxx4JPu}oaNp@KF#+ty`w#0{kz!K2$a~{e?
z44@#3j}Wr>MFm3o7%ttrKQ=Jn%T}tjVofj<Yl5$=)~#fm-AdK0rHGam2`g!J<=>a#
z@5}HXu7<~q?|hoVr=b^VZ%uCdo|2m6{nEw}E~7iAArdz@Q7^=)q%XZY;S;y$R$>;<
zz|C>puJ&lVIc0X0)O2W;ndtq9ICoeUTT5zuKW^+fyL<}<3a$RnJuaLiP%RjRpsyvf
z5vlgaR$6*5*hc}+(I}*QfwQPObp0NJd~Eg9bR@F6|Cc_Y<mbkzECjU5xS=-T&_1|+
zt{Qe%QY%zqLJc%_O1Id%_ZUJA?$I=qp*rsQ+{yLHjv0H)Za#x1I74C?XjVwE51}p)
zGJ#mo=YHLH`U#Kfy&rEFiKP1uy2Nni54+FNb$%zjUCIb%(o+%li`7z3u!EIO7Hd1H
z?yau*)}=$KQ$C!eT!#ac=UAXZ!5+heb9(OA5}P1M2(aF-D*mt~dejcKwY6PA$s`uQ
zj>Q?X;7Q}iC<cx~tiji=ms&{8UJRG-%|CwNnDAqk=t(j(S6hTAKy6}tKt(q;!MbN-
z+r=_(_q54Vr{>gZqHE9fu#3N#i9~w}GzKI&{<aU#e)XkKs-vxaU6suV|1Sd|B~KPb
zOr=As<~lC6D!B5IOned-b78{^)+L_OGWA;0zSt`jCkS&%x}y%1bZ-%zQaB1x$#0Q^
zh+7!c(h)f_3KN=&NNK40j#1neKXIDBIqj!}&^5>EUB4J-ZJ;6HK?1@D1u3{N7-3H9
z)h3Brvg<C`<1+_2JRQ%hwcq5h*`T0QbNj@vj=oIzJwYc<B%=+M1nz`=8^SG1<<1MX
zk(`{IkZQrAK89nTzySP%cVyTukC=-s8`(tN<1T_06x7<(;yrDeIILnnP^Q?VCj2NZ
zGqd6Outmx<GO`tXGsi_WVi%{YHl12m$OSwz0YZ5hGv*HMd0CpZ58%Og8dh=ZkYknh
zty@7N&sAy**ODeTcWaIka=y$jq4P>`%91_&ybxc+>WTY2&CE>2X;e1@1A_v6Y*GzF
z&S4hjh^4w1e2E$vB0*H?Ej<&rWhZKe%}+YwocVD&?oqkQ;UZMy$|XZIYJ)Yyr6w&T
zg+UfFtAIu>Sc=Cb>6i@k1(g=>FR31Z%?>R2wYM{X8&<15#3h17N_UMw+%ebrrPZiW
zhxT=K>O|<SWN;K9j=)Xg7eSDy^o;}`!wbUk(c*XkaT$+pakf7FdbU@G(!r4NPRj!%
zQdzXSG+BEG&h-|+qCzuni02e*gLcwQhzkgt(g7gC^7_J6#Trk-i$^&+hF{4puHRAF
ze(rwY>m%U8!u4^?IJIf{9(Rj8lx1g6-g3E~m}pm)6N;K{lr(A8z1__sbu26~FdGuH
zTrfmP4?vugb=B^H_|Q;)SG-RZfyjx9#KGi;$9cB*2U!MZ52lyuVBoqc*K*%VI+LYI
zV|w;Rj{+-4+)xgrodQh4%a#=(d<j796o?8alw2&E;2jtpa{lqBXn!og(xLF5UKCw5
zhkCr%l5{pKag-DupR8k{^#uiu%`RDPS2+oT1&lr927#=v+gKY^Tyr1Flk62_aT~c_
z$r8FwgnIcf_Xlq7H}j6tmgAqfBDuJMxHyQHdtVo4s+YfH8!@{kW_60x4OSjrzi6da
zCzL)##BnD))gl<94UvnWDT_eL?H`?~rfWYOXAcv?vAeA&XwhJi7$$n+l3^9SGdBAa
z`=M#EO+86s^q^DLS!&Q4M%>cP@iZFNZo;O<N}sgA;-0E-X#BZrLKGBNIX)wa3t3I=
z3Ndn&9P-@M^12&z@k_+$6VTwn#pR)r9nTSwkA&|ICyc_9lxro-PkAb-Py-5&9X*;a
z_y<qh84$_?m}{Ce{8E90^NxsHgulY<LJ~P)P2LKK>Bl`YPCqVdp2iEPMoc)!RPBHy
zXkfvT^7P`ktL_+Xu#u1C=}N+P!e1OrI8=lM$DVgoa8gBYWiEM?++Z2e3j<H~&z}43
z*G|;U{s1b%IL?&Yk|nY9*<@Cy_7abSY<0oFOZd}<Rydeu<~{x9;6?x}yiA^v@pBuP
zRSWT9d+Vim>xs%;wl}6(1%|<9VP9tCtq{haj@?1&s)c?6tRb9F0bwdM@70%fsJZYB
zwjwAR#isQ|W{f52uG0`VSx1j3yg;%J`53Ls!|+HDbtIRKaM2yY{efX3KEhmdJAaMV
z#f}y;T@3Eu-W{(#4$ZtAJpyKD+!)kGRUC(qF-|z7KMO=%FgZ_6Wupz%?6)#@LBDxY
zxIP?_Q@{zBS;hL*NAeNnS;ew%n-G`e!A41hS_~nfoVU<6<id(?;=qBYC)#?HYfZMW
z2x&cOs0m?J>&4$ipm+LL-_#nx!C-WP#Lnl=N@@mtlCFt~$~upJW|8I#`-vM^1_(6|
zr&neD*JhcCLPO^46hulkHnBVHP3%xX$!vL+&e@eZZECB^QPFAO4{34kR7Qmof+R}=
z|3s+(aO*QUw~svzR7TvO1(gxNom*$<60?W81#Oe~CeB9$8<Fj<iu^YHd)t7(K$Bi=
zHdhCB+?Tp)!UQkT(QP|adnBXq0P_cv&>5hk?`~Yy9dK{%zmx+uh=G$h{ld^ItnHh<
zqQhpfSod|?kns}|U&9Q~vXF<Y(tsQNW}Y2ST)MC2^8BRk1w+E>e_2|&&p~WmiAgzN
zJtx#M2A1R5>Z0W?dA4a0jyB!2)#|5q$#8gxvu%Knxb}V>XIOu<0t?u}TAx~`t$nRM
z@$Jq?h{wXDpS34@q4zTfha-ujz-BQ<YF{2Evd0$>v<fEtCZS?7Z?TNuto%|xKFnN<
zBNOLaTd%vBccmuv21|yZ3y+#e{#_=E*h!k?T>!ZXM+H`7WZ5I5F!F4*)hO#uZvB{j
zny~t~Vvbin=_yZxGkzw17VVU;x!YG>)R`xK8jxPSNStLG^Ku>fa%f%IU5?&OwZX4d
z?IKMmtbEN{H{U47SbOU(VTXC9<5Zx{^;oiJ@7@lW3@2|=4v%SymF<Szc9F<G6~UMs
z4U#d6(~xt_F7EL)3MQN63ZqFcis!N=OyRIDh|~s)|GfM=+vgRt_a)xQ4$Bq`E~=yy
z%A6sgq4sI|+R103lyYv0(r)vre(bip%$JNwe!|JCTIK3ck~Km&pW<q|t39l#bzzrl
zI@ORFJgBHHsBUj2)p?JJ`+HfBkIL(KfjN?7H={1qx?dO*_7{uBDwg4RAe?9LrDym~
zg-5?|w;FZApp+3tsu0GxpaIw{Nm<Jfz`4moy|Vc1)Rm0ne(<~l30bwufs`dj{=0xt
zXetk4tMWO^U+CmT>dY?8iF#?4Sr<~gUs+2_%Qx*5&L{zectg$S`8H7pldRxH#GG61
z()rV;Py6>5-t&+KhvHeGufIHQYoKFXJrptKJn8`xbv-891s`}w<pkpT`_kd1BkHRQ
z#YiiFoe4kG84&+q!?mj@pHY)&^E|H$V0XdS7&ZGSmJ<hOxqf`czMs7=jE_upT3Ak?
z$I$v}wINHz4kc9*%2=I-uAj%(^xn5ZF=F!7Id1H!ve+;zn>gDPIWC|)T5wT(Ten<k
z*;lNxn9<M7bC!)K%|5>4a<Y%YZ>g5>hEBFtUEron)qE-=@mofrunURuTF4EWKr<uN
zYdN=a8rZ3Gt~Sq%lt+xS=1Evd^eU%ZEz3g>G7}?5%}J@ZyUqlmi}m>2#Ngt>^V<6o
z$ASJ*>IvfzKH?1(f3EO+B*TvVZB$jI7OAhw3uclI9l``nr%2$L*BSTU#_!<94=!+q
zh_Gc<j1z<iZbgu3uwQ?N(wjOuPLg6}0{7mts;JwY@E9Fu5nod5#MgaS6Wv%{+*FUJ
zj^=7~#(<Zlp_5cMD{nm1^^$`u5S)Ed(PD?=lx#X<Mj_)q?+Duyh0b<{>h&5siLW^f
z;X(}Aqy)wjwWU+nv#<9#u;G6l_Y51~g(WYOm&d3&s2qI|{{=BFL8Tf#Q93JjX;_BX
zR~qDfqFej5g{^LF?p=2KZJI_9{%^N(S>#>jlyLoeU}^Yr9=bvXe4DG&sB@R{j*MJ8
z_SL>xqo$~d7*%#!k@cRCY=c5V?opZgAJo{FmX+s_ea+qdV1-$j1S$HKE=xYHxocC!
zkkFHd(^?k4)VVh>acEa|K4#h*VwL0F<p8|i+`kN~dI=?Dljj=mJHz-l!6vTef$A{l
zGvbn!7cs3SWbW@=0M;bW2i?Q&h9*N+RhA41JN(+FOp=%>o|7vMo5?6wnEX6BzOlL;
z>z`K8NIEh?E!;Y;zX{!^RR86zwZc>CU7toBwy3eZvl2#--8U|l@!|J783`Np0X#!a
z!49kX+ginP@QLHoC#`#k@R^f;Ds?l}xnFeN)#^^U!xBYwjLQc7^y4aQ9ro1@7%Q3u
zDFSfGORdpzLS!N0Vv3hjt~YgniQf&2eV-?j9;f${q^@B<5ygUdCsA1!Fp57L@j^t~
zhbITzinors{$$v4Op2H0TGJwkPaaM<=jkJd7ARLgu)9UIVzA`#WA{#zrpCF)b&ANV
z*{mF<FFVC~Pi0DplchaU8UOkn46U|sb8X?DJS}WCpPrj>(&38v!y8vu9!Px}^~tQ7
zQ<M1DHd~g@Q<(i`+sB4w3uS-Fl3&Dio+Z_@ODCMbe|xy-+0CMH8c}C%S(`<!Se%@i
zA><AwKm^x!F3{#-DpWHHe4T0oN#;>n)~r<R+xzK@s<T_Tsgzd0Qs~IuuC=1Sch|vm
zE>@gy-R})nEwFB_S`^dZ%7bg{GRzil`8btexL!v2B@P$Y$7Xhn?vwF}pGL&9E<AQM
zLq;s^M|Q$A9_|ATIx!gUG;*=$a#To&mXsYYGNNYkJlusFBDJE-=X@<IFid1};Gx#(
zs3zardhq^uh;U^P{d=i-*Y!xHm7w}Pt`46<Cgt=Bq4G6k^>A-xxp&q?kyFGLVA*_!
zZbqub!OK><^z@*3xW_!^%<R~vQM3y}fIcuvSIgA4Wa6)SP!M>S^Th?-Y0Bf`zS_wZ
z7Y1+5yZoaqZSD+3Z7*G&qy=#EI$862XY0%>y_8W-NgE^rcp1w>`M4vd4zsVUPbfU{
zkEik2F-ftP!7d{A_JhM5q%;u300TM*7n5iLCOG5vzf@c(crYdK>PmJ)<V(q+1X36a
zyC4FFl-MZHZ{|l7h6I<c;_isrJ%UyQ;46@gO%AVeS1+eShbUIXq~p_#vCJ#ik=)@I
z{aUJC3O|{KOX0_H5tR^D-NInRQbs!|F>VbBpKQyc!+~~oo@0CkJR*ThWY>`wVQO|n
zBp7P-MH5PK#m?W*&cdU%Y&5-AZnxVMjR$tJ+X?;wmE&CcvVCA_9foRrGpeVD1xs^X
zPY;;Lr>Y_c_0WF)AY3BUd=IU?@N};YZ~lIk>P~5BY07eKUa*8GV_ZjpY}HnkGbtpZ
zppUeUR+l&hNNa1WqaBI)Bu|aFmJ4fNpf_HSrgjg9ovPF6Q<`D3k(7u(A<bR~$7jQe
z3*)*szA`zm#H5Cerc1-vGKni?MVDg{HoE^gvi`*Nh0ZT5<%Q*v>xz-2yj!o6)fu_s
z|FV>FM2vGNX@$)Jj<TSms^AmsW`Yw?$Kir^TAcZf>wXO6@L(6au}gz;A!<879xi@B
zX~SOim_4fE;Ur=7OQo31$et&(H*KDfbZ}AWSXEa%@Sm$Q4fA#JFo)G2D9t`K*n!wy
zDHSR<4Nk5G?Od%#>DJB~FOGA`WD^J^K<kFzm{|6!y6jmIT52XPho~~>S&fDrT;XG|
zQxFiLV*#)r1DiH^^3URP($Oz&Wll=#Pd6mvB@PK}tU=BFM5~M<`X1?m6JC5l^@K7`
z`QXsypk@&`JyJ)i3YkazUg&QMSG^ER8h&6GsDYS}OLvccqL21-g6SF6iY|giMiCUu
zFy3pkRA=(scpKEO;0^YX4XL_p)BfZd>d`46V}JrF@ZM146b1!{Y~J713TSIc_WIUx
zg3zl=`^E2^wC>PGIw;|F;NKQV?ZeW*3`R5`)d8_pX;<CjTrE1ZRu#L9-Fe}<wN+kE
z<cvc<2Bk6?+jimDP*&Yj49g>UC?uzmo%Vp!(>)RR2j#>`ML){?=KjG`;aE&%w#lay
zp^CziB`Q!;qAYtpb(m~!{^(hv@zh4=LrO|N58kV{e9>>Mm!u+<ZfqvA`Y92+<3Wri
z=EUER=}w~~o|`7Jo1Gf(wF&R3M#o8mj5o%+#~FUq*ki*$XRkl?$6=Hj?;H$$h-`uo
zcs3wBVY)No*#Xb;Xhzy(y&=;~O<SpYE4^dn)Xdq|qoN0st>OLH_q?KQMRIx0Zjx=u
zrnHhxnC7jIWs0Qr))Z-kx3ZeiCrV0{DYs{DZ|?J1?GLfOjZK_xt1Z6Oba`WgwL!*V
zv>pje#TuP${XBTcQ0+l&+B4eviwjHB<hA*;PJel2A#-W>`I-^pyZdXQ|NlK06vu$S
zFT?*gW8&4;H*kk-`{{<yT@4=pbBdOIAHtcZCbrn$RJzPh_^)x=9ks?MzPe{mAUYO|
zy|$X7%~#WiqrBWA4-WZO&0~TuOmH^v>81_zsrL_yZLyLrENs`N&9h_s7SS|um}xne
z&6A1R81+0_0w}V<JuVKj8uhr*hEPfOtX2>0NPr1IN>3FAf<VQ7`mZGtXBG}fPd$oK
zeXqJBt{Q#(z_Pu7h<Sxx$IZgBYew4YE^GXyzwzuoZf5|Pmz0O1cHPvvX8{P}rdn6#
zEVm3AR*BYC;-sPT2@E6|mJtwzQXqTFhz#};7^{zYaY<}1#av)guiU)6_$WJK$32F$
zxeL(xqo)KwDe!loM5#L{mjtE8U^IZg5jrZQIyTw1jw=}uOyf86+kmL?f1O6m^jUDq
ziv25qBaewgn?T7g<JChsA4k_QcZ><8G$kVL8`_5<w2@uxKH#KHb(%=8R-k4i>2iV_
z7u4S8_D#i)j}eW`J(W8RHRCOt5|;<}co0t4k}E^O!!I~lI`@EEeU+DMr0}t5cekUD
z<)o$ySisqR)%}CUciF5AV7(pu45LWN_Z3*&`StTaK2*YwFvY|K9VoZ}l6<P<M^W;M
z2|LS3zEdRKIN{D?HsxEGqCa<(wd*g31+8PAD&}zV$urs<BAW%0qvpbl$ZrLB0gRSl
zISQ=NA(_zr0XF6Vjtg!J;ab!i$eT;|<5VSjRwhlfGATlAn||`Ulq$Q+P)#Kn{lZBI
zkJ<&wL1qT`C+lgSK$#o2JK)f>6*SB8wyCPIQ<SK;cL3xUCcc5R^%y6L4>E{w68Ns@
zjC<+n?MwTqbK@t^qalokXxq==M;G7&j%pF7@`BQf$xWD0k+~xt=1-+<=bLiB=7ur6
zn=)t4oZQsRxwdA%{4nNGVG%y`EC*&3$GO{FvoEbZrBS;u9%z_a35YT*aSZsQjLDtL
zo+X6Fd#Sc-JM*Ahy;FN@QFWxOR99`SD!gbJG#}C*wqy??Bx4EwqTG!-=fbF4yvGzU
z8acw!YEu{@SZV9HhdcDS>gOm>8!3ra&&=4@Q2sJwJ0h4=uDyTAN>HRA8gQUJ`m8tj
zV6c5<jh8aFH`L)i(*#+R(o!In5r!f20Rh@S-567I=#dO!4{sRC;_#wS)b9y*bvjq3
z?6-l5hKurqCJ1^a*6+}@aSkUqsdquoz6)%|OC29k5EPuuXeVLzUeFcww%Q98ELh6u
zw-6De30SQBHX&yxnw&^uTv7ADCiJ?Bzu;7}D$uR>(C+qe<0aiW)*&AWhW3N3Cy@?-
z;bDa#7bi01<Ktpu%`O2V)3&)=4A9L56?va@8)8-|wjVSQLBYXnxoxZLZjc#dRqs>4
zt%H0TmUx|cL}zPH8XZ3sYnfq-Kf|(z;%2>QYg!4z7nvzd(yuxqFTp?q|Lg&;Y7DCH
z_(<FEQKuEdHDYRi;UBf&hX#~dUEQqA4SfUN2-57YA8nsK(rVP&#`jWt8#)RsKkq?+
z?+|G|^;*+n%LMiM9?nC(yp+Yv5BM;gUN|A1F^iy(F<)iO-oC){9F7{F%abVxD%WE#
zaS8w^Do;q$+{9WHx~)-1BX+oeTdLEk@fd>B3~O0k{a6wbDECc#XkbDdGlqA<kbRo%
z`5bROzk@g8^eu`9jNN#s;Y+mns5t)m9#vpgDQgOxZi1*&z-*3?s5CD(!Poc3AY2HU
zvCuIHQ6H6i0S+jhD;qkf@~vq<<3F3AS|jQ2GR2}j4`?`B_Tu3TaZDAc4Zfwo{wzAj
zi7nG_JG^3Ie=V{FPp@ESQ>G~Fzge01EQoT8u2zOZvfI&r8TOYAO&m)3X3-5fa!s7A
zV>zj$e<HO|VI>iRXGaLFae{*z$s96v>Z2`|?{O-_US4etq&*||>H{w)Wpl?AQ}~&l
z`;Rzt1~b^}@>k1u^;NUzRTqR-AX=9>bAs4AMb(~Lv9FKz3UwIV(|BN#RkO?I+wwTY
z=-Hb5p(!(ISa|<}!*LnQGjo@bwY0c`v{{Xc%=-aHLlMkGRa`((B0WAs_=!`7f%!;x
zDoQp^;U436x4iINTw_{K)E&V@)HmMLQbBXsv1d<jYfo7><tybP2{i*6i~JgPgp+{2
zG=8mD<{`?L2j8JXvDPUFt6~B}M577lt?*}Nu?PKrxalsljul7ry!}I!8)w?tKaX?g
zrU)NjAa`l+8sq-CTkC17SpVQTf7;T{jWYOd4`o30S1<Oot?B~fjZHpkZrESq>fcQm
zJnR(LbP{teffD$3xPkF+aRcA9fY)l(_p*p~yJdip`2^kA7@O_faJ*lyT^fD+ZgHvt
zMQ-}|m6SJ5RX|N2Jbq>T&}MJwnyWF#sybxZWYt8hnrv~md{%UC3kOgUbU|jn-Ow;Q
z)%j_r=@<RXZg;Eb*()@^y1$)gppJI(@~Y~c0XJsMm=PaY%U~<VqP`@pWp3yivt0)D
zl{tkjw-)qO_#x|aMLqtVO*!+nwS+^2FM0B7FLp-FhDg{5$ro(9Xs9>eXl)T4-QYB|
zgNEg|-?lG(h3@8)t53+o>rna%KLq8gPkhd%4zg^r$!$WZ)}_=-6^>OuM;<G@xN2(T
zQy2r`?01Y9QeRSM#n)c^74Y~(LBWCpa5E%Ht+=N3_SB^=yEMq&)6u@_tY5g&+Q4^L
zL!o5@uP=k5l~u9Uqkf8MYBehwjlId?%QgA#aKcfnZ~Wsmw^yOv&iZtt$t$1OUgV>6
zt9H1P{FogNmOm)s#V&aZvj&X)6MpJ{5j6+Jq-BkE2b(dPCGqO-W|fXA-K1PT`Y*Vt
z?$!p{SGUmkHp*~~hql4J_3!c*MAq0aRaIM9r+*Vs|9{QLT}w8o46NVZ8_t2U-tDW$
zX#}Lbn}xhOs}Q>rPtD<{??I{i=l8!GF}m8cbEPPmsoe&>(D^9t{WE;kQne(iQ8M%J
z5{SzV>S6EoZ?t;p459hN1)nsfc8$U~Edg=vJu<dk-K^0X{$qWsCN@Q=>OX80Jo<q0
zSgWEHa)?H2$F)9bm-gbUVGrfIk%IcNvF-OaG0Z#P2*}q;b#)d5_ouu+^UjUoWW!6e
zjw{SU8SHnfUZgg#hA9U%D*e)~XBU?k{`F_G>|!m};2d+49UUFF)j7FZ$HJ93Om9#?
zg(lFeC{-kSTG7!QLyIR>V);VJ3Dx&2{xMt!QJEArj{5b)dCg*gfKo3>4ABZ7dX-n|
z*E}C6|11L-myCyLZ0rYk$+RQq?%)37)zb4zJB1kUe1pS>?3=3&5wd&5DmK)$ysr!d
zuc-Lr1Fv6Tjb_Fv_f-SG(C1lV>6;G7)AKV?B{L<R@`lYf2zMhH-T2<<_#!Nua9tBh
zUjX*+MMib+Tw%q_s&Bi9hxpja)GmU)o`bp45SGo<e>!7QA(YWQ5ZrVlwY>Ec!h@2r
zba0tfL93FCsQdGJ75nElBu<Nayk+VO1evh>Hm^5mdg&-bfC;eoaH?NgbonFo?V3hX
z*@xB~WQ-4+sAq0;6XR_#k~?W_G=X3f)k+_`8bE~UI_XQd3Btjw-vwgQ18^Xb^}yYr
z>&}<iI`yXiqCzgiJ@I#9Pzy(Ds!TMH?wa+~t}R*~a~DVW4i`=`vYsliM{PZnSQ(5+
zvyf4fPPad#!M_Ak)sZ6n5^ADje$r^>YC|~99cdX0Lfz_uyX8|?opgwTq?_;}8n)Pw
z;>c2&1@JqcG3ZUUb1mK1^iXWIRV?m!C*c2mM}2QPe}16IoC7i&NT&^C85|eQpLp_d
zwAwIMQ`V1uu+c<9W0IMa?XJjYY`3s1XRM*^GcL`Qm@gLFQmKkVcTQn(zn%w{ZpBx6
zM@jro*syostMB4`r6FUVq`G|_CycjG8qB+W2kilwV_~6FKfIfWyl-8v(p(3gU3=?6
zgb%FGY}a{b;MC)N3=A?;Qy+oz?AW<;XGwg^K~z||1IBuF+-PDoLWMtmTLj$wakPK_
zeq~x12$Wpy<JiiXi%5%)HB$`RAwnOhuZd}xDQ1jPgfLDi;OcvrSBS$L+iTe)hs1n|
zB@*P0scBo)`pkwJx8D0!Y5dLwkc-kky3&d%`=l5WbR8iV2f&O73Jmn^R`-0a0o(@0
zsLB}?W(}_zG8^j8$y*Vzy}Da%7*wJV+#mDBaLoKz^dZ|c<mtdsQZ-uEK5kbHFG0lX
zlE+(ceAt3w@hFryfbuYy3sa$lNjP*ls^9=9D$ca@e*H^h)$1oiQ4r1^cQ*5xAZ*p<
zSDjadTMOORQ?t4})UD%%-wa4UlejgslwPjp(v`AA&5EsU3l^(%KYwZV_S&2QV-F>$
zG?(~fmF}0cn)~N=%KLYH%-Z64KFX4=#@lIK5rM?uHq*sEV<g26s@$x+;)4QXZdMj6
zM79gFyw?&Rh~4^>q~!)*iYQyiOl(ni>9B=pmoKvFh>6xM2A08!?aNwO@=XA1li6wj
zZk3~5p7YF1XAlQt=5hVtjdm!4W%krH=AgbyME{6qehHz7bX@>e7*wXLRQ1}VoatI~
zQrO303AJPo2IdyPHPujB_SP=eO8MjN^_Irx^71qB?xa?wTzDk8hxvPLLQK%%o8l?S
zv`fqg5H4*!BLB8S(?}%k5gDUe3~SR?6{eS2@yjV2KWqQFW4bJ}>Z(My5CKnNQvM=Q
zbv%HEt})SRlbKgTlVw2%!MK0|1n4X3|0C7b<YCN?s<`>II9Y50n74=14<^J5jTSk6
z9h>K_Zqjm!kp)f>-xj}Mp!`h|n6D!?p2p4ZVghn1;MARIKEb{J<S^|i!N9|R?*8h7
zJK=N3r>6~IP(Ngs9w4TIqKGg<-KEU8zGS1pvyTiaN96vJp*oNqWMXppLAZ_qY4&(?
z7J3f6bt?LhTxT(s#KLN{{uhNeE17*WFdr$5S#Xe_S^gD*uE0~;|Iw7Xu*2X_jPydv
zU4o+!jzEc`mG2d&0tfz^tz{fE(7G>-v5Mtl`EfFeEY+<tR-G~U=Z+r-9dkCHFnD51
zyr)<DzX$o?(kFhcKG;t_d+aBEYqInnOlmnxPrH^2zEjgkLD;g+Tvh5NCUX}~ELS<I
zFe#0Ib!-ZVA)b%ytnBVrtE204dm5O433QDqlC%z&T}LF&5bIJC^_e6%cvdlObNw`@
zMCW;TAwZ$>n7gj$G4FGBF?G{1JG%oN&oa+)g4lMlNRyEErw7FLy5_tp%xYaX(Nv(=
zNJ?Lxc~V5d@weOf1P8`{;+Oq?Pmk9=tqmR4&TGLvdGz>$J4K7v&fCJn_{Dnuh<hG4
zd;4lWR}24XdfL3Uj^NLNBuh58WW&kVGP9nw43ijOs7?D%tU&AzO60v+Sv)tya7-A?
zp^>jP>sLSPN($l(LOnO_H^>sI92$6`O~9cPb*?l+7^rLsaA@%vOj%^gw?#ILk>hwd
zZo~)|!+&F|IBE<o({Zd6irpG!0`-CeCc!{4u9Iuu4U*|f=!mKE0HaKpDXU4~FYt&2
z$DD<5Dj<yQimCnaKxU1k1aPD4YV!<sbra1J`<Q@Y<<Q9sc%i%e|HG`DU=0P*0#|w(
zT_*Lx^MFj7&G9M8Y*_YdVtZA^&)%-@tEpzxTkR>moQ;~%^<lT}|C{pf1Iydo4B^`_
zik}W3A^QWf#RV|=Om@|AHAMx%Nn?q<Bi2Ew?4m&0-4v!OV%PxnQHUx0tHSUCPUsl1
zZdiK%$6bMt_~gAo#h5rGzZ+xnK?SEq@z9#GYY-vWYSSl{F6BFf#35)4D4ZCKl%GCS
z*RPNEH<@*3MnQIkAZt2#a?2_S_c-3H|M}rCc&1aviIxMGy)H|Bd9p(2X;>j9JG(Wo
zncV~5*BDa`vs2jSOeG{k2uAyDl))WVt%5n}R-2<Pk?NkB&|n<vA9ZyxpD^sNi_?x1
z!q$WtVl?%3x&G$i8?Lu^V#}LmUE)6RV=iq!DC>heU+9h)w03oC!pQle<tpR5pZK*O
zca^Wr`Nw)z^~9DhvOl=9dglJl4~9)_xlpsY|JAhv_+xjvuIJ}1SE(6o(yI7BIEDUO
zYWDv%txoDWJ4@y}&!~nz+<TPG*Q!bM^2S@TXi=D<x*2}@ERNy-Y&idx$^NYtmW;%!
z|MM<`#YpQ>oF->zTQ7-~5`I;Ag%RQngEY;zB!0EE<)TF)NF(wKBiQvj3|(P=MZHOu
zNH3v3{|q{-s{?*ct3pw0Suu<;P*-E`@d+*;DJk6?$9JI_dP*k*ycr2-L)-cJ6KTy6
zIVd_I;R||d;{0uO#h~4$dvMb@03W25riIMX6Gqi1Zl7(`BeDuyfSJ$d^-X)WY!-Go
zYJD8#o8o_$uT9d<ng<-I@nzU--nW<+XZ<jDZZNvE=#YKP)NmuCtyQa`@Jv2AQ^zuO
zA%{V6s&30^oZ8q>bNcUb;5?*Yf>ZX=G1IH6==cY%7iYewG`#flPd5;#Rlp~ZlZYvu
ze1fBl)DgltC_VvGTDl!Ny(x-MAm(eu8R@B|yLaq3>gVUT-oV|AN&L1F9o;o%0JGh@
zX@B6j|1@HI{?NP#<4C0Lx^vgL?LVE}x_#_mn2y%S5iZ^F{&y_;Z)N}A1_%GweICYr
zV`~OLAcoi|%0HsH+RS6KYL*UJ?DQw|O1>7lGE<Z_UAGc_jthEK#3C>QDTNi-5u-v8
z9G*Dw+XY6F^fpMkDkF;HR3uC8%ZiRlN`o}sC~%|eZzZAGlBs33&zB}*zenU&&)VXs
zO_IorZV;7f_gV+vdHmv%x{OJT{vj~){H^Ys{|1!FF0?5+vTY(`=_yy#*Qtw~zjU**
zP*8fc*{b>b4xuz?&Folrt<W@Nc>S$CCk}qnhQW)@%H#W&Z1&U?DCa~-g_PO=fW!7)
z03b9da76LEG96>5Xp1ed&~KC0?pqT2$$x~6DXo5b6rfS$grPB~_rDqFOuM2!%8x#8
zUUgaiCk-p@{NRx!sQ9yyC_W++W@!mS^TMd2abBKOX|1&O2VfSoLKWp&=g6dF(AB+G
zGfjo+*Hcr3vV2rrCFz*Kfok;^>D#MTHmHAUjbMFKbl>MHDtY3au>Z8e59HSUEcHCw
zO2at&TkiI|9ki7~w9YwblLzkaRR6=MsaM4+9k`HCP5=BNv$glyDAJ%!4EmSih-aE@
zulv*|No`@`eX%zbJ92Si!qE&X%0aHRD_k%`^onr(@yDaUESFojwk&@MJcvtxXtH00
z35*8ZRrKh>gld(&OV9`aDKg0PTJ;=@B=2f9v9Bz*IP}I5g<bs*)*$Zw-%n_-%4GIu
z=n(l>2<?Ivf7PANqkta#wy3CCfZFK?Lc`;lu8o~RYKyfeoRh;4mW6snuSGPVZF2d(
zQMUNTwGe?TO^A2eC9~E5^4K1~Wr(tT{55w;D3CCC8X9aIa8evphqeFw<l>d*Qjbqk
z7h-^Ln=rmC2hXUC_VJp9+Cx$=UWK8|fMcOrA-y+?7FI?>ZDPYWTgkm|#%x<uH*VE;
z50$+*ms!97a0X@oOqT;e#RB2NEK$u+t-v~bgV4bQN_ZnpH5rk!bLJv$__;?*#vQ1s
zyO>!wF-`@>cRoU?O{;2W#8jK+rYfiV@T{d&UH6iCG5wdLel*YN?y%XsQ)#(`VMIAA
zIikMvzE((d<?u#bJf0_0I$k@snwg?R6umuOv}KqChMAmOURh|H5$PnV4L*{{C&naU
z9$EOPIREZ(<3$fwnqwcc_fNfBqO2kNqu^!4j->Gp2yc++`QubjqaHDdDNaAAX(T8x
zVGd$RD*zAH{DU9IKe}yx)jihjmuyIAySj;Y2e;B&ujr?4Q5Y_=s9>ILJt8)8>@Y=-
zzHRnJzsbA$&*FNseRY>XCo%~Ep5<3^Lwmu%$H1T(bhq~y-@Iyo&j5#*nA%t4K&W{D
zP}MzK^HC=;4fX4P_jVn0j5|PdKYB_Ip=7fbAn-^QPDE{OZNj9L<_z-zJp%#pp_Ici
z5wk@Wx}eRx2|iCZ-UP&rc>pO`>LM@}DgZ-^rJz)7k2axEXWv{}$O+=C&o@BU160*G
ziM(~mm6Fqm`ZKW^J&8_Q-KjqoK3a7O)9|++lKAnq=U@HWmqICJhUHgds%tVELeMVp
z6iVpCVz<nTQIZ7%j<~a%cxVAQSwvPQbh6)n!9#gtX@*LLYYeoAtw*+KM4QE_m`<NQ
zcB_cL+gl@+=^^g3@a87ue%O}}#BJ|caQt(^8Z;Dyhyb)u)8Z7C^%*r5sGq610%}&=
z`*v==tR?@Vcwf+nnl6zq<5bJha0<N49w10ApmW!-*`$1KJ;G+lEr6BxOa=sRXpOKI
zJ2<Y)DC{S0fYz|l{9LbeyEl7#BxXl8)qm<V<h>_tfNk0UpwN=o7RLQ^4m8WcBw$NT
zO~wl+yU1}#&<43kFii7nT(#$H()HY`Q*3#sA=RyJ7uFta%UgefCBvK(&ytRAInofh
z*bVd8(dkcFPy7^<6LERtqC)B%w4x!V>Zz*mH6>w_WvR=>LMCOD?$dRXaz<g7om>})
zM>y|(HAXU;{9LQ8Q9Ai%CGCD#YC$N>kG?gzbxYS*%;}18(z!o%R_Ztq5zh4ufN^8C
z>I2~KhBKJS9<&SD0Ro|sTXBR8D6Z?N3dgXm)4&IMk-mqjyp$zI&QnuJF5r%}%`zen
z^;%JK`6F?b@Bp?S7u4{>jf|?!obFxD&CEO;fFFR{Gm-KP2`l3?=d*&iCkNDI*DW0(
zVZ95*W0nVwoyylI1uIpFHb`C=!;-58$nO$%`C=^rJ?%f~J*8~0N(YCPVYjrBa5N6k
zQH?6KSh4Zk5ayb3dtLv`+DW#D$cFlc_>8Fde6ybQ>M?P<w++@@=ev0K;<28&{T`U8
zl>ev}J>~wX@4_a|9Q)A^8&<SAdg6!hnd3|>cRs#2eaK`plO<+16MBst^I%R*(88Hd
z%IfQ~m!}ubnNw6{K1cstutjlvPSwUeh0%G@@tz-5+%QjVKHA7A$m-hW4g<bl{l+|7
z98;%6Wk$t(+P067W+nMYE${h->h!x0x0l~iR)+i#9Z>W2g*l^;2sMdU8@$A@ZJ%i$
ztDVD}^imBY9D;ICt8|^P=j+iFA$LVR2!KAOk3PV3lNLi;o=;@@)TZV<=CMtDkHZ-%
zKw6viG7=c`sIwYcV{xY*IdUx{qoab?Z$<V~aVhn_tU8L5y0!7oEpBwh^aF4)RG>)V
z2D3?T@0OF+vY>u!Yt>FJWhU5j;)L{!jq0<_<dMYv`sSK5ugnlvvHowe1ESR@*#2}x
ztaMooGYCNeV%K8mRF|XP&?}`Ty~YME6wlyskV&DK63)6UFWxNa*RKbCGbh#dn{nfs
zMJyCY)4b;&?o8Z2xb=#fJp<<sa;ukFU+@0?g-#_FI%k~A7mVp1?+$17L;VcVBtOro
zXE&Ds?C?eD-<bwYGch;c&(`OMkHxO)#ovep#IdVa4F})4-)!W#B>2cDX(F3G9z9~j
z2w$HnCM`*cuCE75x(Q~B6o((L>NLT6R6tGN3AUB8>m6bOwRzJfOgcv#YKCLkkLX|k
z`{(_;Vf-OG>rvl^2DDpq!{*119ga{=P(lQqIyInIhxInhVyAETwC&hcv-j^<1b!dG
z*hA&~t&f2Oe|gi04SLIRFs-CvZeQ)~#`AuvZ>?(1Y0>v|jdnU0P(G+>z~m7yhdz6l
zQ>l3~>TKMFcKiBsP{#eHFkAcB>uvx1+6E#3p0w@IEg#nEh<4rdE7smPs{^xLUWgfW
z66o`l*SfCbYj9Fr>*^K*a&6_)9fLUSKl`W@H%Y$^95i5A5y!`#Hx6(e-ZtYuHDF|u
z(}THOa}?XqdZ-oN7`*+S2EIW{dm6@=oJ22t4ytyLVezZVrC)zBsIi}@-HzI99GG`+
zpGiHfNBlFV;;nmOY4&DJ&eCP=OFCY(N$~WqIMMG{F2h!PI=jv$<==jN=i6_$Gi?C0
zRDPbqb7y?|u7@Gf)eGPhr{7)358iv{5B?zo<c~K)1?Rh3alZTW3-j+W>C}=VyEYcp
z%{LrwG;07j;H^jXk1-!_T|Vyb_g9-f-N>0Z@Exo3dp<yE?BAE+f7oRheq9I>oC->p
zMyrBcr8SIS2gqD3BD8j4@15H6haj6?-$Ff237py!ibi{-p@nq93>Q^j8{8#}>9U^H
zJEL31-aET+CO>q+Hs+;@wZR3x+>@5&(D*NFPgyb@zsgFM*uT8?<>;b}-?;#3Z#_a|
zad7n9fn#MoXy?D~ApicLtlr9Mwf<4lYF$I4kHgPDuuqzO>zS5?n!K^=@{YIqKj`h<
ze}riLiLN(g`1Bs}RSWSi+kufZMnXr_Q%k$OeUa0alfNb!5ac{z2)WtZXks7TeGz+<
zQcsMyjz84KJQ>fmW;G6%d@OhLF-=BhI_ca5EOqIEuGFh3?E@Qul5mnb<Xau0o_G;@
zoE6T`TeVV*aLqdDxeftmn7SxzHgEvO(%w0}x^x-2Yu2(oLJeYAdd^(`;0q>d--s}m
zU)Hu`$CFT01O7op&f5K6lcxU<d+!~V)w#9%lEjk4U{}-^#Tr`_HHsC`C>U&ry-*^=
zf+9sl1q3V+J17>6Q4p}8D2Nr2qCvzCC<;ae6qKfPq{IFVOjfdz$XffH@4C*p_Rjtz
z+i!_4@0|0Q&ojn7?&3%1;F+UMcg1eqcXu=f5!Q%*f^U}02a5e><LBbH_T!pU?lYhd
za2K*U*VbKXRXk$buz*u5a}r)%c4?w!{8}x$@{pS1cA;HgY^nt@Dy-;Zxx2gm4D9}Y
zu3p$KbUc<H6kmi+9A(^2+=p$V*XZDB{xc@h)y)G}36``(t^!WRrxm$6!GubSgv3+J
zjo{W;I-~aQ(v?c}xI26H@6X6|u%s{B3i+yHdA~SR%G@4mryt(-$94L#gT<_1Yi~y9
z-+u*5iTg5W&?D}CH!yBG7f;KdFtI5rDmtUxu(CAj#*LHQWBx}zwrq)N9{TDbj|kQS
zHoh1DHHPoR!Cg?4*gl${+wpTjV*bNjM4JT!bpi}v;w%3AJlCU=Lyu(z?0TbJm&(AU
zZodlJQ|zjyEl##4_$2Wklo$lD0|Qx>zT)F(qpVs-!IRTYxJxh`zKXsRwDx7*F0k9T
zfb-XY0eJDHh^js}@k+Z>W#+|QUjAaUGCcKpHD4<yF^xTeEWoq+zWc$0r^rxnsT%sj
z_@m?YPD7S{hAa<5<hByi0oVUbjqwk2SFAYSH==TxzE?D9@G$&)zlr%MZ#Qxhov~vb
z%02Nr`muB8&aA)*{1fio55>8LxRGO)e6;;>15>9q{O7I(zT!P*+j;7mv-FsjH?e<;
zUN3EkYc=#dnL^`KE}?a?-Wv$g9%%V&h~5Jn#A>5wh7Fs;uYHIoR}mtKde0NY+>Ez`
z2i{9d%b45V*uL2+_zd!*yi84<eqr%+vHycQ-6XVzo?fExPR=-ea{vA|Vju?5?Tb)n
z3>dO7i%6+P{c}=iCGO(l-N19K%@t^2>ZQqrSe3sgo`{@h&(58P`NonKJW4y?0JDNd
zmUAah?x-g;8%cQW1#U{9O9&M{#coJ*XZ5Yyl*LI?yh^2MHZU-NF*iBIQ6L_1b-Nmf
zlYIARn<CJiz8UYZ3vfTeD8oD>)?2bjOwG)uAD`5IN1OiNP-8Yyb*?twu+_mcT`k?|
zwD@K5^XqE57U5&qDWhx+-a1*lz`drQJi-Lr9NQ_$&|sL}e8@4sz&p#+hq&T)-WC@Z
zM1PVynUX+9;421y!T<y!n}OAc0BH<$>OHrN^U;wET@pj%na_y%RGRr7u>qsgUc#Fs
zVtQ7ZE$%|~HU{I@mciYdfhLLvKpu-WQ~Rm%wyCxNdNbcsiEXwWnJ!q%e=sm)z|)`?
zJm5V<u0T!L<K_IWej4q-V%q3o%U^G=hHbH!r@VFZ=2(c4$Dt+(Yw{#S%~<_ULur(@
zy1G6FuolxgM?_F_LROqW!qG$T7ktcLzI-_lTo3cCMeHgP*n%aezc5;)^;!i_OiW{i
zfFyoMLeP2eL}fW{D&hs2MKkl5y{s6OXg%Y2$>HfW%}-(>GqI(La%#M_;+6}1n+bto
z?+!?Af+*~0gQgR2!|U9EM^KYr!?g(qQZzhJ4AGKk@tTZ}i;I)2pCC6g+$%&3x*_Qu
z+!;x^M5yM`mA!Ey<g$?|Rbq3<s{JGaJzgMd@fZZy{&^RP&J+u~bumvM6pEdZ2rprs
zOa(<3_1TbcKb3@S_MTBuE<#I_5C+;ez>5JoW5z6kKeO(s?A)LZzu<EztSdp0m<ROo
zNNmah0KGJmPlnvKUl^Ytu?<|GVBW(^FEK7+*9ZS;vaYV~3DePdn_i#|Jf!6~2iA%K
z>p@6VSNn^HtNb0m6`z`sXc4CK8zx)K3bVh!wma=j;aAychVi0qFUA0WpE%d;T-#dk
z4SgpqVK!NzQ=F=wsO<DYOL+JxPKZ;*pkjT}JJ>C^ZNwm>zN<L`VeIs#rbXw_<WqvR
zDZ0o@*0WnT9Zt2qE8cA^fOXf(t^$4_p{W@>q_5tUX^JD;xN%d~tO>=@VGzK#c$JQd
z-t%tYIKmQVu2``mHoA9~PHA%WyGyLVfJt6j?Tg+4>Iz}1llJ|~4j6=pO0-l}4mjv|
z>sFryT;tRs0wN1kP0&#UCnBN4+_&MR&(5O-HPya>f$PzmH*a2bG`6r9Qexlc!4vJ&
zh4&70%d}X_!NOuRPN@QnN22+<J_^ny8o>z@dn~oMdHeR~!(Ky_oW?7gl7RJB780%4
z{yF-ae%Pwa?`$0MTw=$5`l+|xFvs%qgiWZgo>!<6QK~c9;ta;)f3D3`TGifbj-ECO
zTy=pf7>SN}u4O3wJDUjY)^L`CtU(S0Z6_%sFx)fNzqIsOa1ifpYmVPUA)N`)a}LL=
zEl-^)Ncc{gn(sDm{`5K2pLup~N;4O+^e>xq95!IUlwG@at;^mStlfTR?fYL?GuA20
zz8JUI>xVB@(em$09a8R9Q>Lajg_lP>cTBZck`A;>y~l9Z7Ns%WVn!5hXBLaQ?s)ll
zNTN$8hX#}1j?>#w4h<2XHXU~VIkTTYFqLeaydJ@4Q!5R(ooQ&1$WB3uaBB%uqKc3t
z19{QKLUUBii%OLjL_th`Q#h<<<J-wgm@Rj(&+tB+KIQ1RR$wy|+*cH&=}9mJk0G8{
zoSdFhn5r6MUMf-R`1RH2%*sl;wR>HKDB#3R>+q;g826lD&*te0W%kH6H)Y<@#=`=D
z$;IiXtDgAz`uO^)e>$1HBch{5OWS)5N(Sm2-Jwj)*l5@SDmCJ>tu@{8{=2I082pqC
z?SyG0xO=M=SJ0qKYOH&8p-&Qzt^JC-(52hION@mLcc$jY2DzX?wwM~)mk%FLW)fv(
z;2G^r*0*lnj78}Db9G6Q^=vj$;%qP>i>!8NW(nLw#^}N0F=oWqu7IbvscNW_(*Vvk
z$a(hVo<9-G&LfbDpeX10T$1LXLC$mdg37L-gW^klPs2Cb3uum0ocs6h|H^4y2CQ*M
z0L$8hq9Uh~`rnt#sh5K<W${nRm0xBowG<ihmaduDVKo}|DyGbzsw$<tNw>E*cXg4)
zG{`z-BzIj*V@IjaK$9n)P7lRb^XAQO@n$)9y}}{GdlSWmR#{pLJ)LM5jyQ6q4fy}$
zF%^^Ckwq273;(&{!%@A;bxMii@aIc+@|x*)S-bvZ?{7Aa{9@S#F$q%{62PE^*tX3W
zUpHIbfyMa%M(@d|mRI`ZMZ7(FE+KU@$I!u{%f-vI{m^Ay^F9u(a99%*^rA9wF9Xvo
zY+-jzTVoN7NA&hdzAc+Ivl(R}3lzX#raio}%Wd@^LZkB*L0tQDoD)MQWh7eXB&=JZ
zp&_Z_51dUS%d`y!I9FGmiFVn)f4@9Oz=VQ_tR}K%ej$e9^(Ovv<L(XfJ!{>cgfED^
zd?!Y|ynfo*Av>nP@;IQev|Uj|&gi!+eGlF!<|f<L)co*S3n>Dd=cclN_oP;)Pty`k
z?<01P!)C@#W%I$LI%NdO2JV_#FYM+)=2*fq&A7<InKEI*gxHM-!`?u3JQ{$@Q={+>
zR2)5{Z9Z1<ccOBgMlr)NTW?Ze0Z^74+hQm@x$BS;)3_Y8d`*iS4CA+D>uBn$2VF}W
zIIf$c5iYq#d8<xCMQj`G^6c5O!`aineSk<HZHS7Bq`}^9bljl8^<j_p?y1)8j#jRj
z<XbP1D}IxDK)C@3)V~roZ}p8z%mXErc1Khpa>xn1MShRO&rq33K_FyxUa%!3Xq6+r
z>!l}DUMYYW0m}9-N_w%d#cH5|RuYS^7~QtOb`;EBY<M!vIyA)Q8`g)i;hR#XIS(0g
zOV%Fml(G8}60bzmSq|*#$95t0#x@mo8i5OP*RKxxTs*(ow3h&ZN#IF-YIHI1X>Y!?
zbJ-n}_knWp=x)KY8-(3_#-Aj3kpfqK8c4H<r|HibB<8vt^*&6C7f}d^79nL$OK-$1
z{i*&lS?+xcs^ICy;&$0hPomFgReQ}i<p*&2t-A!|Og}Y?gh<S-w5_jzl~daeYWfX!
z3v!|j&}dmaBJ6sDo~0kh!Qh@p{7Sl~X|MQ%R}2tQy*oGxb=Nj)kEeZBPrR{sbQ~fu
zj>gd{?CR>s1eh-vl9AZ4D*fX){IHr3ssl%Vo1^iozd47lH`vfjv0qKXA}omK{NBS9
zFdH4UAIBvH-wav<(#8A9FC7(a@ymHVnV?A-Ot&Hqsu?5R0i#T%=#%X@F>#ip1p>%V
zM^b#`oXYd1iD$f})MgKtQVXBgon6~&t(gTLKLaxh_FY>jujY)c);+DR%5_elX<&M}
zTtI2CZ_bbe_6}PT;;)+Z;5o>?!xZqam*HxzR9<65&XVaP&w9?BIkDUBvh>9wy`@5-
zD6$)7U*sp8a{6q!M`FB9p~6};KAG$R^V*-u#k%xm)llvIxU3A3SWwXTq6BSJ-E1a<
zI?j*!VQ)EAL`}+s$eT6f&*3o#54M|$lj94E+9?<(Ef;3Ajg1YR&;iDIfebzy9Lnj*
zbHn4z8}bIa6$#>d%ms@2C^fO;A<YX@DPge$lSm_qV!sKdksK&1Fvdf<pp&1UpOp~k
zC8G#7;FcAkx5@UX`4cD_Jn}qpIc06u$y(BNl=qw(p$?rkc-8B>Z5be#Lr8w%)Z<k+
za&5_}n^#dvXip9QYL#Kf1C7R92_8A{I~A497u_0-0oy-3>y_QQMK>(0IP}Eb!&P;t
z51oLxlkpnEp=jc0rnVFTl~f$!Q^}*wluS$>WHI%FmWA7v+7GHMwOO}l!=HA_z3JwA
z+MEkRITEw@S+Gq?{45Tw2h3J~t~zsjjU3P1+v7|um}ThkJ|~b`^>g`tx|$k3DR;<@
z2c3pCCTA-qec-sYOAqSa(h7L;Z+Pq;5au?$i9h*Ir7qjojoW0s{P}Kf{?pC|&Kq>L
zP0%&mr~Wwe`4f;lc>tjHDRNu#wEsNJ_`mw=fyj|Nuax2=JH;F4V<4Y^vM!^SshW;<
zLM47?$6ry|Cy1p8;`>-Bc#&*g6<+3GpLMk@N=kp8u>3nd`p+O?UH@~n^ZkG3DgPJT
zhS9g?vNZz}?XVOxaXMm%3VUzaI6cAjm2lv>0Ia>xMLp9_;z*z}VP?|xR#N)zTK3jo
zhMD~cqAHuG?ULB<yQ@mY5TPdIEFnNp>dTY_u)PP=M>}$Sq3Ho?3yAZH)p*o8wBDmT
zs0g-HSZP{_H^r+VlSTrouOK!u0}{#C;ekFYB}^Eve_=gHZRK&xao_nuvke|G3(Z&M
zB-F1B;QGsS__q!9+Hh@+J&(3-RW_c{I_L%eT=HkRmLq&eY$#49R#X7_j&rQx$hR-J
z)qRJWM}k1&%xTyWzW)0WNSUU_Gdzk$)yz${Q6)gpL~4m?)ArC*T)rBlwkB^KHNv!)
z+V=O|l+(R*%^@h^K=Dw#XAsqVL)eYjS!0>ge8}s{hh_1BCN=A$XHA}Lea!|?LHxg`
zM>shO#0}^!*8OxWU+Reobp4Xu`}Vai4aV-)0D4&~H8sJY1abc*!r3{c%2KqQCMior
zI|Vc(u1|XI0EUA=cZAIa-XU?^-Sh-wvm|Fo%solSh01vW#!Yv<UOjpQr`TN9R(@Fv
zRoY$4eZoysD=ij(V`y))WjesAFJ&BNXBiaWqb|)ozi1ckqQ`-DMQTKa`I%k2qZHy2
zb|8cgkr^?Ncy1HjepItppmiZ|c*K*wv~;y_D)cpr_jK;kWm{zk?kOMKsrM(FZJ1W6
zuQ3AQ@m4pt1V+zAfOIFo#>&aK%x#{#gz8F$D=7&&Q7$0YC#{mhr7R~|Rl4hwSXm8o
zsti8jV^Y*NtGnX9b`IZ#pq5ZciC|^QfP=Dl3YE(zmwM)OS4cO)U_so2WMn|BumH)}
zwq?=9@13^7qLkG$4M$_mysMwMw_JVA5s~pQo0mTbPMXF2l5B18zd%SIsJ|US`u9--
zT>yl+>PX3Gl-K0;gBvax8H?ms0BR*b;fePi-B4o7t?xo-Xw|HlH}>|6q?jV25&qD)
zR*GIT15V*^nhk;_V+?NZ2B(h&x;$xk`7DLfF=;wv)#>SdMp%NA5za6l9F)I_R#hB1
zmpmSOQpo&=`3)aycboi6t5yo&1~B=ytDn+r(YSLn`rdM|=&_i9s(m~z+n3ir(~F9B
zp=y=jhEZ0-={J~vorgWEr*gxE>Nk^q4=8z^*A&SXk*tvw+7VT6t)^eHGy<L+mho0v
zcOZ_BBf|G5?!*jh#a;Mtenik-4P1`LEbHm88Di#{ClmXDiywYU7c&7|&HV^?9ekAh
z_0D&zUaCZV%4NFNxi`H_%wrrSYC6y@durz$xmWxWCtq0n=&;!&&k?l9MF7j+h6E>`
zSyQ%*9@&op4X^D~dK>mX0hHxp89+6fG(T-wjp{P9(cgc6g!}M`$`;SB7fwoX5@a6b
zf4%1=(CD^?<u3o^YSeWX4EXD}C&XY5n=DAuBzKX;(<nA*e~u<~N|eiSPy1dOD<y4(
zow93Hy4nB`@s+Xth0G?qTT17qicm39h46W`ujvL1A!@s^cV=$Nioup&ga%hbh;5U+
z$|k{L$SO;V(mN*Aoq15R7+kT~1|irK3F25+)z3mRj2V}lC{3K~tE&v@Cg6Jd%Ns6a
z1PLBrJ49i^b=XXH3~-IZm&C!3x4n0M_)#CT(PPG3uOIXRd)_M@HJ&ZI(`Qt4aLiN9
z`qRWf3mj&}_KM4&wo=@8){<+1rCxh2KMl5OJZynD3<^534Q<xn45<^{I%!lEctlLY
z%dqci2f9L`M=eYHRzj{A=nyU9wms*{DbvxsPZEQC_~{|%XYE%#^M3Q@&0#YEE?O!8
zmUeg64-;QQ?DYlVi_-G&33y^%z17~v39mdzN^vlGwuT+z&4p2QB_&$`rW-+>U^`~~
z(#l=Pgxg#tewQ9+&4=##W@QP2<F-hwIR@ET0?acT5f(p7wV{(EzJM9nB0m7;Fv+Uu
z>z^3=7nq>$5KDPMCr(rj_4C459n|n}qBU<6;D9-MSnYAgg4J_pe0_|aRfcJ>TwP6V
zU*!MB1(4Q?{c{O!X6v5X?@*R)Up8XQxWXU`3RWV4I`D-X1~lx{s=Y#XFTl2JcBVMN
zDsWTi*{j#>A=sUr8Aa<R&0MXO19a5KI?)X>wN*A7<9`)f--q$SthDsab-rVy#xZYJ
zSO$;ci~~xQoMFM`Kmi=tDc7Zj!~A{3fRc%9uVP1!=@KL3FLn=!iHRde45<m`c%gYV
zV7BW5@%c0d-(n_`qk={at9aNL(}|O_f=px0o`4C--Nx8WPD$P{47mLWxanr+rtH3=
zD8oQvcLY1;RAwbTBB17~P7rH2@`G)5Ex-%ji8%fkPjLyexB1N#lMW8?hGIUK!7WG5
zOeT&Wn`rBtK4lh3(>c!ZD|tUl>;D^B<6jI2%Au>XW?Mm-=D44~E4O!cV#*L#5nezx
z)JhAI7a~RF?@NqkibQ=!W~T`vuur-Ak?;W`DxT-IWELa>cbyI<#E`b?HB5H)wI+YR
zRDo->iya|83x}Lp!}JqVx(%{QGK96=<6UXNc4cpIBKz<K2xATsmW27WUoo+vP~Gwx
zeYkbKx4^<$T<#BOJJYrCu?_zIzNoZN;Ik>?^-Qq4`c4BF3nH;L5)YLLd%n~N2H2ip
z!GRV2fz5(VRkEak@h}z~khhz;z7OLlDD-D1?9mt~!9g6ft!uvnK0JRQ(){b$kgVPR
z+!L)G?hc;=Sq41ew^eTVa07XcZ7pKR3h73<u7-dAnR2^kBn5ecpV%`A-Zo;NyeyUL
zKm4)15y?#XUMPQcJ;S>e^V=)NwP?%sU)O?Z^Yz@>(G6Psryu%<u=alxZ!hIRAuo|R
zUJOdN<4`xWewS-oie&Te7X7ab*uI)MChi~Y@uI48sd8vv{f!*S*5A60wzwJ7T|?<&
zGsT-O8vn+^^zh_oWl%7`;@<r>jZX2W>kZoc31a+rQ0(f_P3(SU)MV;)f@0R0oizH*
z2*-S?j-3Sxt)V?2+g=E1d3C%`FljyTxHEgj)rS%RErH0v<Uku;Z-Cj>AEy!j2YtOW
z<LCX(Y^!B3bMk_=H!AFMr4%Q!Kb=m(a)a=@OclkjQje(+SUjr@Qs#rBHd*tGo~f5O
zMB(BIJ!R?J{(I7;S%yk;0vgoT9XqDeAw8nSl%mjj0?<5Ki=}Il=_z-ou68??ZUqD{
zqUDqXVIdb}oAH0oFUTMFOIeWj@7@2MO0zzHV4U$C=GAoI`&@O?XPOxr?IJ}DU-CxC
z%D27Vll=8BH4(Xp7$|yLK85v9XVABH<}HkNhBcbcHK4=cjPhB<awQ9CbP<vvq&9z!
zi*(wMg(d?F3lh6@?i>$e?#zglhetpV`Xx(WV;~12BbRC50?by#TDS*%Cakrl2G!ER
zPHBd3n~kuV@r3QeiG$5i8US!7z<W3;?#bf$k`g?As0QOBBe6eOugai)f|jwKAP?yl
z(Ju7xCm3qXt1;db!Av3}qB=Wb#Ct-Wc4pvZhR!|7r+DL>tL$+lCuBSvESNp>YQjFf
z1jG%N^7LVP5F|C>G)2NN)Xs!p#bK`L7$cIh-^g_Iq*ohNzp(!T9Ou<vSYN?K+f~g=
z296W7oZe)8k_IkGP{*<<lDQhDkIX58gjqtVCdOzKOpoa<Wpd)@*F#iRGzJv86Ji~O
zmLoBm4CN$Ck+qQtPZBcM|0emXhR`$v?q;hNEquXCB&kh;JG+|W=pdCkP5U;-YF0u-
zigQ;eLm4#oQsy!22$TuZiK$~nJV(R)v0HZKQ@ZKB<#w$u_?V6sDnfJsF53)9JH%X$
zNypCZv&!-t3afaSC8zjcf2NrdGfca&g5vq`Q@JR>gQ*iHY?t8z9Z|g~mqLBtG$*59
zX<ouaq4^MtqI%DBso(+--1@^h_-&Mf==B68$vU&2n<;c%nVt5FG~W{n1COEiLEWC(
zUJrYGbddo?Meu?R*ETEPZSpHU-#YVhOVdb*04>|LJ%JXrw|32&ZMW%jWh`#Xe5R_<
zt0tb9H=l8Pdu6&gSNe*pjyN*SBo7+a6_kLn)b93F*wT@RKoO6%c)nua|A(wA_adBn
zdO`$|L?rR#6AvFoXOfiKRgXVF0O4hvzQt>UkJH%~9|lpPTcTV#YG<so^jBWhClPc*
z|GR{yNW^0&5JG2jrIIxSvbBDaf#@m$bR;uV){RrKzlrz&_s}5L;Fqj~5kVgrf3Pf;
zDQ3!p7WWgav*LS-piCMLr+4SP^vYwl-G=I6n4+=p{z2^6&%*3#xxz$5&e$QRgv0ps
z;k`ee==Pk6H2%%~GL{Mx2<7&^zDB+D7C$(0tG-(Fb8*qzzkl_$Mmgz8380^?c(}ak
zC)lbbSclH7=?X)0ecvL?*5poipLB31goGaV3VYq#dSyW*80ikv(FF6v_Lqmi3;#*P
zeNvsFifwTHaj=y!+!AIW8!Qvf%o{Bfwg*qzfYC_0)ZrMq<OQ{aqQ9JieS2w0TDOd6
zgDAjn*@%~ueTZXluy(t*uP(wW0Z*Kf==F(HrEGY(3Oa-=MXf|vsUlROmMSX8*=mH$
z@>rCz@JiU*JUd)T9U}f{kp+qC3Z^j*%?|3s#2lpM<Ye#l(3T(of2@8pJ>AREzz*PY
z-P1M9WjUu13oD1Hm&6Yj&pcVzLtR^}So%Yuho`6Uo2W<6YSId1M`k7~;#iEC{Mq*#
zOnM|F)C};NX*?magT7>AQ_q{)B0UEju%;-YrXr&Jo|TiYaP5MEg6uPodaUm-mXi-!
zfe1o5WkmSOwL(#o4#|D1o2=8Lv%ydV)7x%3nqF_c>umh(fWc7rb=M;VLrfhvxITGL
z?EymO_LIs42<hm41b44V@Ca27&XIVqd2Y&VB41RL46E$Mgqqj6sA$zbf-Aj>5)6gt
z%g6sl^i?a>J7fJT%a`8gO=jVKh_38IwVWPz;35D*{p965=BZ=Gj7jv`u!a7HZ;q=S
z-06W!9&c|n#-p{$W*0T<b&IZkp|ZI_U(FZ6BUeB&DJUf7FxR*WF2(2e5fwhmP<5q<
zxNr-X#gkm`YHJn=#4qMod}0`i(I}@k46zq6dhMi^O5s-oxppxC-?(qToy>;$vHEvj
z!)(V%J_9fQBRF0%hs80y$GdQui8DZ;hWI+~qK|1LH&{AW{LTen8U~<~qGMmO+`!PH
z$J@fsFSt+gJr92qTTxxz8$e6Qtv?%f!?8n7&qKhF11TX6n>|Z!-Am(Og>9!pJCt+u
z&$U!hzzy36<;JTZ%KnA2%I0^jjm9irw}|O<gEucfj(hjliSqcEo4Z~_)Y5Mv@^oIE
z9rhdjX3op{2V;^^zxD<FgOSm?teSIu4l@6q`C39IVaKiSbm%vR&3;KFq*xhcHTTSS
zqhiy4-qAOwQJzX+=+-%ULEbp(aoz;zchVDwI+z@bR29TzZ3ximbVyU@QPhnFlYD<r
zYca_;4Mz6Mf#doLQ6}oIM478cqniYcatBfK=GU9!FA!zik)(|$qf|CmBc@+J$riS}
zM%4A|e&GK0;M&;fe}sD37%J5lYeIQqS<FrzvV#b{RRB|7YXPN&JtU6xm<K+P=gNWT
z$DSmN_O5zv+SS1#j=>^t32&%y<-`>~BO~MRl3pta@CJ2d1aStG#g<L;-l5?$<zr#t
zc9jrw82Y2UwgLS0V71d9JQAQqJVfJT{0H{#sc~?G-4xLu;|h5i_>ARP?g1K=*7J|h
z(~)z>Z~aP3sc+J;9M$p{h8@c*myAhN{m;93sz;)Ad67BXLL;`M>5y4O;t$K#*!uQC
z0zf1w93j2z)Rw_78i-@+x)Liw^Eg>%vW*D;gt3cq`(e{?-f_QQ-SV4A7v)w8g}+oM
zjCkahbj@Vrfkbs^8poeJ0<b3$j6gl@Q+wEo7e3eJM`0ip1Dvd)n_b*8fC$$`pRvuJ
zA)6*U(z<keXo^CZ5R{5)`Vsqx2*lUNM1d^rq3)7eoPf$-@87ozotGVE*OkH+^h^wd
zItM;!ij~_!eLF#v5yK0%1Er<c?!-J?+Jx_fk-}6EZZVCJr~w|~(drR<ivQY0rG6ZT
z%kaR;wa_va@CWP6AV*<%<Z$HjL>@p#iG0_FzX*jvlEf?4x9MA6wzWpkM6~)gUCO_U
zY$7BP7e2tF!&8;b3r>x=1n4cnEFjO~#xF8kib?$ZHofi7N36b9-zSV;%tu7k_xT8p
z$$3Zq{2ka#*}PhShH5G0!Pm=<Jb&1u{|wIx>Y!7ML>f-oAcCx=PtJBb<+kNvk86$o
zi+AduZgl0}^!5MK&2rnJ%Z|v-4JBRaRmUz}HY6&UeF)&J)lLQ%O<?eadZfW*S3vv!
z0=-aD`bRSQ0U7hZVKyHeqcW=hhw1U1)Bj1gp~s=0EJO5|F*m6&@eCCS5`u}y>LF{#
zsyR-hV4lIClFX`Mz17rtJKw}S-3HW-X+Vxo?n2H<>TsrYy>>?rLa|6qdDBMqxpPew
zrb7>7oU4~JHqZf;xV;DM+Ov;dp$z%3JY<inM`En+*e1QzkL|l5ncDDLH&xkOoiN)`
zS$rC{Y}qo;SqpyWWDAQ^IhWHrgrW1oxO~ZF=Ly=;F5<!f^zu+AS%3BomyL~7deKE-
zsU50em2?U}8A*K?ff0F0C^Z(K@cH_U*YLw5>T2{{9(=aSA|>jI*Ow93T^=|&hBF!C
zip7fhLd=V!trfsNr<}Dt=3DINAScmiL()pVHFso=ieqx+&`sm(6#53oQYcD7J3Ik#
znHE=XYI}&}G9{D>f&!RweKDwxjGYN23#5&{ZF8_=PP!eUGQl+ZUU@S>stI_*5<k1g
z!$T!F7e34qhDS)Gev+7WtkxSC_d7V)$`eYo|E~y$Fel{RJbPvs6&)>JtdwA1*q?%S
z0;)6?5HAc2?1b=I;o4KX+C$OZU|GVzSOfu5ABc<<dhyPh$w`vs!-SAuEUa3fzK3F?
zQM5jn?=M-b)4{lq3*1JQAmT5v?y|lMVSNu&j!hlxzhyutMGws~PUk;2*ABns7y~^9
z3}+_5iVS^VEi6HTMAf;MsgDRR#3X%GNezaw{vbf|g|Md(>iS_78<nqSb&R$VP0rz`
zj{=P5u6k}eGd4FLe~x(8*mV36X!t{LoBu>Tcwf;VId;VD39TaYM-dEeb?j6I_;WeM
zNlHE{kL;?F<OG=;!v_|AHN}ybB)2cRuv)7mJCC1@n?BQs{;ZcdQFWanjA{Q@TuWVz
zlI_l$LV0%FHTkQP6nH61tbYFCvrcBC@#T=u7f*gJa3&WZ(@Df|`eLR4#X;I;(3~aQ
zQqS<m9UyF@f$Z_+m%2<y)gP7IDm!klOuIw~{46_BIfAZ;Ekidg?UI#5c;U`)x+OT-
zoxWElM3mjLTJO5tZD`3-QMa*z_M*~Jo0MMDq4j)#*iJRuS7_(T!;|<tXg9)Cw`^p%
zwJsb!a--z`A{DIltf#h3(WzW+7Aax`IN6#7H@nDaShA=&rHKRXZau-Krne?bY~q1|
zacb3h4Mhfcfc!oINQjWH=W1iJ_8@c@qPI`b9}mu3KTmi9_YNEt-Z-_XXlLb@^23W*
z679ZTuw8(i>XOw4L7iy$BdUu7FF01LlrTWS8^MCx4Ox)+;3zQkBQgh;z}X*1Xu>qW
z-|5`C=K9WGBZJ1v-JDs!J&b>pN%dfeHw@bxg5+(7nzk_z<wHSk5q0!{_S8hH^t;&f
zA;2%}E%6X%&I2mLH#1@xK12gH{Y|v`TgPZ#OlEq*W#0GIZ1F|@M$EzpR1z<2$?29?
z6rpASpCVb*GNy+IBZ1ALNCFg`PRj-0(7N>C{?OHu>%fxEl%?oZQ@N0JJTxQwuwS4z
zCPzK^G9)p@(wd8Fn%sGN-u$gq2L(#YNiQUx^8si~F`ZzqK|M|{{EZ9n<(J2<Pqn;k
zvWe#Bk)#$tDiBkmX(s9{9(MpcXi6#7w+jj-vXjkX35c#dR0+!lmxhRf^^EBE#3>C_
zd<1v0)`cGR0$odIaR5US>l9nEIWr+22Ehqlg-jrs-j7Q3Y=XRLONbdh%5DlE@fEVh
z3{1d2FLNNy!viZC*)T*3bZGcsYeT<8lw}(2YOj31z~~%OjqT@}S8u-yI>V7<i`)1T
zez6=4Tf7^6I{3q5=N*YnEm#$7>GVFIhc2agg|^e^x(i?L1W8f{hS@HTUFy+i?w4#O
zxTw8KSE>3YA2QywG;NJs#M^8c4V;WFFPjh8K0KpMN&QInvL1OCWdZW3!b9KSIuQaN
z*QzMBH3;$s>K%3IM-)~NC{cm}$V;Q|`sBhA4|eKea^PB(l{s*T2tf~kx<ObN3%-*{
zUVF%VyxOfwi+Qtv>t+NRw_iP%>4Fr^2q=7$6JF+2JWJk$f2$!vNWAKrgf0d5;d`)*
zlq<D(a1F!yg~ODFC{o|JNW(6_vNHJ+Z76(>N$X5hiU)D~Pc`Z=x(6IM;?fYiEoKNa
z%1Uj(_c!aSf2mSzI|Sd=!<Rf>XTLHv8?EORC^QvOO%t-W-Zc{*AR1C$E?$O!t52P(
z3%$fqU|nuH60wPgh7HPaxK3I;w7|jDT0Q%M%?vugzQ}^D)_#{WBJ^bW)tXYhWxJa;
z?>l>^l3v$+-PV8AdC|J{J$8Qa`KPU$wqIp2YUI`_ep8%Gdwel>)RBv87j1davDp`k
zT29{AyvOFRCa!(>W6p)IpD!2|^OX_$&6Dp6D>kG*TejO_d7<WYs}XtCBVw|f{CsQK
zZpHP&FVn|3MnqQ}=tCG;)~id;SN<fy;x_~5_R<(w67y|tp;Ny8dL^#~zxzo4Zt>At
z{7vz1@y<87L2``mZpkX$m6&3*N~?qVwClqR42_LDloaz<X~D3Jbh|eQYvH0CxXKIb
z`c@qc6Q;xG6Cw6kr}h{T?cJ*rb|2mdR51oV-4eo@e)ZDvl(K$?y{vrQpc}SEwD&`@
zx-K>{I^?<f<!3^zVp=6>@9ZR^9J<-RkxJj~!{Y4oO_C0TxQ$w#ymE-Dt9=;#w{G{3
z1z~u<fG-F5Bfg)C<-(#OEjE0A1{!y4?@jV_1_IwPYyp;+s8{sU5`sKO11nEvf8_8S
zPN14Oq?U=*M>ds&E@`6xg642-=hy`C%_!H@>yAGq6<Twe7^qv_FMKt{Z1hyGK$KW_
zY!2#rJXyTj+-DZA6=;Q@pNG7}SwolSr{AdPV4kzQPw(D$5=!(!6VE_s^Gi_l`)*`>
zi9={0G@YkD#z}c*OHL%lKGW_pe*E~kZ^AX!Vz%;IPWN9QN2gza&P}T~ibp<A<50in
z!8T^Qt$IJ+Lin+YWHsEn)AVxA#uom{5q<M53l4zea-xh0JH_5)kAksFglj8BX!bjY
z(8Lr+3y3qD4Yx&H4&CjSTy}qzk8w3JyRnDHI7*qtvK7=8y4}UbYFeid`t&BcblF`<
zH_(6{XPoT?)Uvps-u&gs@1i1BK97iUfmu1mcqLOA*nE;{v&?8F6_*H(Vlx~$;%6cd
z-<2Ig8uMnmg3!Z<569gqbTLVVg5{5A$3(47h9y5os3wD&rj>5rzWvMG`OSK3tnQv}
zvL-*u&%>d6d=oV-)xxDw4jnYo%bNGrI3J&W$029X2ybI!<D@qZ8iti;#oIaV=(^fq
zM9r5ammfdN-Mu=<`$f7FC8j}gZhrWJEvBP6fP5upqh4z5y*G1ATBrZ@@7Yy}Iu>W#
z5``w+=;!w~MNRKr**+z5w;gbp+jW=na{G;uFK*s?wHnP+8{73YFE2$fF!<7><Y7~V
z?)Em`px^%C;o(obB3>JJIL26G$E1*F5PWw`dN9n@7eeu%g0mqZ!w8izFe&|6<)zaX
z_Z*)(nT}rG*Ej9ZqOj5qpLf^yoYte|09R$!X;2Zb!>S~^h0l^}HaVAW($(&^?1YEG
z;?fZo_Y1qtuvl~=#$#36quX*lQbGc9!Ygw0ztSjm3^2-?zo+ts%PbEAocEm55^&BV
zM!{{^G1kJ3An(i0y3G|$2iCRRyo025qD<fR>{R@fU5g_XW2kPH@D7~}2w*l7c2s83
zI63Sx<Gl3c-4+Be9>iQmbFvOC=(`eVNQ$WZ{RuK5>q1nzT>>l2H!G9MBh+tb($fjO
zpk6bl1d$WT*X@OA(he)eISSj<r`yz9OrJC7B#cv?qy#jJ{?JS@9*o6ahH&laDF0-0
z7F3WLIm)r7_Ev6KwIPF(NauOS5U94hN@kjvV7~p$bFwtanK%fk^#tn0imh^gIZ7WQ
zMLtSHV1$HR(u>I&dYCb$APR<HyUX9#0>TI#@7UI?+>k-)Q@iAjAupC69vb5@E6BT>
zwuuy{%nrI5;-uT7ckk>L+mxNWmfWk-GS4KPMcF5!U~iy=E@gFZE5bGoB(Y@}=J4)R
zc=@BiUM)W_3m>(@M;oKYPutbC3}a_4U3yxeLP(5aF)A@86zt7fDGU=HQTV{+Q#*S6
zcyDM5{5FGYDG2|>WrIyLZOEjwLc^IekMkmDV?Qth%UnnR;x}OX@Rj~(3+v~Ny6@c7
zL@j{vFIlQa2qVP<)U|_VyOKf@D~}VsZ6f}BRI2Q{QUr;Q#j?A|^afH}qVzlo0ihSE
znGR(?vM~IEgJ)sl$`@hR8o%2_d-o;B{Om#9HG%{DNtYBXnVv}cB{5DRu1GiRG@tJe
zaKD%^Fv`peD>5JKFX{O0ih>c3mrKR;00F18li<0;R!J%QnblbbMv^@S51vU|vn#NQ
zZcQpr$>HLc16B)y-_9uH<j|PN*CR|!qg?h?u6dM@kWH;9H-H(CboT7pC4YQsc|<Kp
z;Ea%*ot&I}9lncy{CF|raQSLzM~{#rd^KVIo)KHBw|CX(xajv7z3)_luDutxef8<D
zQ|#Jw8=py^4;~x3`~1~cw_{2^Q*x;DU(ET10XmmIg&U#|F*=|&_6kPq(iMHG#%xv&
zK6oMizxxoeI+4DwOPA3+32_|Bf7(eSW!d8?$=#LS{2|u-Up$~Q9gzU;$Mg>l%ocQj
z!mb|iM|SnBroU=kVdh=`@MT==7%f$^Xh3*aGq<yY9e-5waYLo6dx<vvE!ppP<aK?m
zuU#X13v1Q%tpjN6X4EuNRZ^PS`NMBSpPNB1#$DMi%R;{H`Q{(~Q7U0oq5sWk@_YE;
zo6Z`)k{;{Nd(Z#+w6PF5PjCA0_v@ljuOURowU0;t9`|@<v+}$5in&q0B4_IXca=tF
z*Li!dje^H{xcCn_jsN1W|8|F6Qbh9+3%#pa>@q>5|GK(HTMNx~k!D>Rd8Z+@x2MDZ
zKW>i^1HpiRNeqe>7e^?S>HMeLF!LJ=KY#y+5~7D(T?TNct5rHi{HIHLyUbNtWo(0J
zo3tT~YpJPl`F;!N{PPntat-P<<9oT;YsZhO<Hsfid7rpBQuwzXQ0+dnhOelaMlxG#
zuG>IXQ*g@<KbpBa%_v6P@h0sn=JWHu&ocza31QIuNl(?r<mW0a!Z!6o1>w`Ztre1l
z#P4eGm=1kTmAbW(lHryQFBf?yd%qnp?msL%4;FV)(krJ8i|Sr|7w`1cSbbn?<62%V
z%wNn+gRYIXQ2O(WwQ?v~%%?JHZ=6#d3*KY7MV_H*dwH@~n|ye&z8$w&*^~MS>GMf;
zlzK`^>+5)9uei%oSZng(`}m&ri~S$Aex{P|`_}@HC%zLA^M@|5cIfae#(*DM616_2
zUH=df`{xx{tE+7OhiupX@%{L{9jhp|#nG|J9~~WkYxf{<cl_rz$YxRZZCE=#pJ+sX
z6m&Sn%>=)iQ<eHr-e9K6Gr)LvM?-U*1wsKe%e>faaFQ7uo!ZfQSn=Z-HLC-<0#De#
z35w=ll@6@)jOb%Vg9^Sed{vIcu1kQYr>H)4oet5Q1+ID3`*igXMM&ncpQg>2aqO30
z=77OCcobd4&<oCnsrVlHj|dlm97ycxYP)dvK_!>9G1+LX*|rLP&?0=?FnFI1Q&lp}
zDBH6EF5Fb7PMOl&&ei3cPLy=QZ9%gTPQm;nW2q<H7C~G|M+1~;*?5yJfS|ds9~q)=
zbIw`cK@nb4mFv$ez8uBUDN66C%7Yh=y<Vf4fMtB~!r27MivI*Zpp$eT^hc)e7zB={
zR-@oNU7cun2{tU*%2>Kc#w2PhNqGc6%f#|!yXwO{2MM%bR$!7Ap`gKk2ts}O<x5ip
z61oCZGK?=qSa-fW{Y9Ni-FyC;Ii{n*8y-c=-DI3%T=4XSzyG%DE;1P6hHsx@Vv^j;
zZEs?1`J65q(`L@>O;rpGLi-vEj|Xy&t|kEv_AfT7bdHvEE*Lrn6DRISTAiwl;#D+;
zVxNyr=`@Xrj;ki>N~kI)tcRTH?z#FKWU6r-XXLq$6ZNUr&0D+oZB@QlW0=3%Iba5%
zAa;gJ)~vZ#Wp5wEZ!n(BCmY+nYNf2EWr!zyLGrf9O-+^{h7xkBu3Lxpr2h#U3|BT9
zwuca;E|^6(mhVBk294ECbya@JIMPR%TnTga?AZZeCGgqI0l=gz6fqR6tPJT5(3sK8
zJ<9TGRA;pmyn-m>MMdiQg#`s^ApxS9C2vSG>-$@RjnA5un5O@+p{fF6NxQHrkRhlX
zLg59%45=>9ek2~S47eA@c-96VPMdaw!Gp9lGRlaLIQY(Z73iMmF6m$RIKPFSc3)<t
zVoQ@irmZvq8zbi#Iad{vdccjJ=<8<A91hT-VUrHB4uk{=%5oCMnL*9ZgOZ}(M!A5%
z?)TbFJh31?m@DA0=nERKf_|0NGXc0lLIYWKkFKn;awNQUyZv+IGg8D#{mK^+2UB&&
z%<<AjLhwHA9}qI`h4n0;jV;4$G6!q$E@qM32qW?&7Y<H+Qn!1K5XGf|)zSxEjAJO)
zPV+TiLMDk>c>5!*8pPX*Z_(jfB@tLR7?I_$7}IkMxWvE8|Jbo(I$GTWva>Fydp?A~
zB)OyVb}|Nmyfh}Qq#>gzsG90own)*uxi!A&--V_-MMhU3whfQ7NunLKa~fD1>Di}G
zp9N_lvv`Stw-tpkKUfb@9l9$kB!GF2<RFW$e*fghu%KRsd%Yep^S-C1zsyAG{g*Xg
zg_>eVExl6SOMVfZo<0P(&0Cf8!?nZGix+BF%$5NT;}1Aj+lSe#gn=bVlDMKuH$|Tu
zf9ugqV>=x{y2%R`9AhUDgF|=@eP5eN{EEVHB8c$wv}lhEyUU~kL)sN)xeO9SuZEbr
zb}%Y}W4hO};O13F#x9TWG`0vX4VJkQjUdC8mA(mx(<%<MSBRMs8^{TEBiXKPY=Y24
z9;R0vWPg`1%~M*1KgQ6tj~7E7-tYLQCr_T70)W}YdBJJJ%LC^9mI;h8m}+6kk|j%i
zsx-C}h>Rs&QgO=12c~DnD-RRP$LW#O4<9ZfVh6me`aY6fPv(V^dl8T=>Njz!<p1rq
zvSLFv=>EdAD%&#m$XwtL{@0^S!DKKuldY<QU0O55hgoEP#EB9Zk@=XajdvWLqxN1b
z975;nP<motCKfm6n~FZ0^lL6*3NOSo_79duGusDW0plU?7WJMWA}gOR<$53R5n`AR
z<8?7O=R~Jx_qHgrDZ7m**eqZP+QTfuDg;b`<aUAia#-2xpTrGP)b3Db`xJyQK_%(*
zF+n3TD$+!8%E`qpMXuWOqeK)h#te>jf3y7vhB%uK-dtfc6N&DG(!i^3?S~&@Ta2i<
z67f)mC#2RYx9K+$c)*~0j$9Fw!)zg!aS<{lBiRWgZm|7b86!J7hRHXSkrYqxG0y#|
zPG6W*7kG$eijcFJsK)|?$a*F3$FLy%2<HonL`dP&r%v^S(|?iyf`Rt*@0u$P*f+l6
zkQ3cJx4Ys%VdWy(thfrs>}z)Cer*g&5^?BTP3#G?va$qnLX~hQ!At#~UBF#3cp&jH
z!PqMcjv*Em{8*&+TR*4q7OX;;*w`Qpg|B~oyRveGw*SeK@fiJTzDqP?3yT9a6eCBV
zi*C#8d@;veBC}MGHeoA5kLzO+ZW!S3;&>Bb;mb%FMEQ|e%|c@wv+<@&sNZF#5<fWS
z3`(zkZ$N^wT@;p+b#yk$T3~*Dg7-?yo5Umx2!=gSUW#()@@j>t1Ip}gY*i+_{_~CB
zlp`BY%vilU@eGHEIHd}|4+Qu4-rh4oc*a9>ceTIE`rw#;OyMvccnx;-O!m<2m3G!x
z7vb0`(p#|w5Roo$#^Ca={k>)9#0s!iul;KRG1~3Ye1}=sea5CQ8{BwYM}O8#F-Lc*
zhXGk$prQ|mQ{~>j$WCfBG0KJMW4AR`R>(`B|81#kWSeVS3mh8qUxeCg1ct;1?#GG7
z<HP4!tj5RU5jB*b^X%*p6{nvghxb>>O?6!r(;&BdBeo|NNt@z}CJt{0fnj?X+xN^`
zDjOV^=~_8#`0%-C5I|75@mXATyj}$iT`|<OQL`d(s+=E9n{NbucpM|gLumL5&axy4
z0`B>uo1PFznXQg-G6KyMtQ3cjT^{0v%39QosbX#7>O3f`Fs)=c0`g1Z8(<KauG1#B
z(De6p*_+`_SzIhA-XJFWkSYZF8l1f5oXkx?i`27%kC{d?<7C*9WS`wfUI5Nqh8y>)
z4|H3Wzx)+pfx=qE0MN&^CurSPWs!>D66fnW`}`t<yNR)R70Y>au&oV!W2RDL6+=ul
z3dk165`&oJZQ>dDI>DzWH{V6gWVxpYqZx}8XT|Vphv%lGgx<z2HOlNYwkwNggUmoF
zMqOI(PHcJyy>q)_ySxsCQQAY7v)TDY59SGhrTaOUzCniXnmVv-;bZuqdw=@r=_$AD
zm$`c(32+cDm2?u{z#r3rO|z21uE5)PVw(JQANV#O?zqlxA5&tHS6zS6)b3}0dN7U1
zXwwu^-jGMk{#P&pXP%+Yp=40AJ3A~Vs%F41wnnn+G|{d+!yw|8CtKo4=A^9mhomqU
zJ<oL-oK@-)G>_qnja9*$LuuPfY@)9$jKquaRfx)@(7_{q48<OSsrulMyD=mcO*1r9
zEwiPbz-aD-pP5VJ_P=C&U%_8s*ylCgzVC$n{k-EoGfJ?11a$4!VpVcg&MI;9Wn6Ad
z$u^VvmjlmN3xBgIl4ZRkNlIc7^p}|Vv1bd{gOd~FKw@#w>^x2ge|KSg^}&{{TQ8>U
zGl)Kj%`HzKn}%gZ=MrP%m-kCruDuV?`f`lhY6RrRSh124OM>=sepNASc3r24p+PSQ
z0}D?}+?jFttaFVMuL7lvUqVIJ%!qca6dV8wqmby~C!Y1w7+6_-m*TP_?5&O~>FFE4
z>BOLTZWGO-oiJ}yTLnl?8oM>wXN%y!f0i2+JI!KIY5uP}lstJe?yusIQju}si=!t;
zFa&{vOhtx+qGj{vc@8mV%@ypmMR-T}QOHTPL=DGCQB2o$TxUZ(kR&GK!0>Rbtb93C
zMV{t+$qNMkdy6*MfErkQyZPqk#=mg^;Nb8Z7)5ufnYgG;9#4AyF^Lc5DULO2ko|CN
z-Ajs>ixZ~!a*X37UTfI}o{iTXc$6VtUh@{h#-es)ztlIE^B4lS+y+~V(1i9_y%3Xg
z?Peg=l|R%6smpiWS!}rGn{)GO?KQEwiTF}&d}zt@gLiuDX#4e-S@Uc1n$*O;;iK)U
z<rhMTNLPdzlVPo%d0EC+5?K~^hw9sB(lfd5Vwf#<EzD9f(bbecOV?5<Zo_DiG@V#o
ztKO=OqjxAX;t;Xcu}OzG_j`#~Ca6DRni=uwS98;koH=tQF2cBE(tQq$IaHj-ezIKL
zQUSWu`fH7@_Kl6lSuDya^c{NNOFNKr$)Av#g0tKdN|Znx|5{((KE)^fHkB7|JyiUQ
zehIv0Zd;WlM;tAQuWNqwo5gJu?VOCbJ56o%f>t+fKkNwP4$)Ld$&2ClYrmAqMn<RA
zF_n~pgVi99|GMMcf9*I)RgL;;-PoqAlHBkW^CV7`oG{HwLtS%vA31VJKub*P7K<4m
zB(1~D<~2*6Ew_g^feqq3((;C9^}k_%*VrPjLo%%j?1D48R(MH9=&1V+G`;?*G%9Sx
z2HH9{LG;y#-^SyB<LWSBNoS2x5zemuqj2_LfO((D3XiCuzE}FM$}tpKAp4edUJhU1
zJH{KSQSRlxy8H8LL^$DbM|*}k&tKY3(N0pa#B2R#pyGxLD@$l<l&zM}F2%V6Hr`2t
z8l&s9^lOcQ=>x_kEw6c+T)i@FKgH__9+ZK_O`_#Pt_7E<$C<2tv2lN{Gu$RN0@skt
zEQoXreduRj8wMbl=)Ysq&-y=U+?#2!x%ipe{Fm3a>~Q-02>ZZmi~`P5gm;c`RZ+al
zO-{~e5GN~bucxQwnhhB=0HJq!7_B+&lwfO1-#s{lNoY+z?3jt?Oe3+UVGAnxVeq~1
z#763&u^D5kqr&qxs*j2K$z=iqO?BV+=9r~sx6Srcp4fkjG69y0Ruq(zPu9;>nbLM9
z!<G0~zbsy|ggWxsDa9E50|R@$&g~vDYQ?EbGieDa>jvdi4Va^-3w&GDma;`6?W7^&
zfk`XJ(jA^$<|-5glgGkql=8qZHT1Hm5F}d<BX+U2q`Og+9C<2Z?L&v!4}D?6%A+n$
zO*~`ye3+Cz_Ep6RU9{Wp+P%9)v3eFyNqP(hOT7D=5NI5hmyIU>5eI5#x69qkHe~B2
zD+M1r_T{oqQnp3vkB^c-OPM82G_LOUSlP!4HXIGon7)IT=R6xq7ng;+NXk|zqBf~H
zF*Nhz!QQ<qVZZ_=2zyL;tBjaim6(iW7T24tXIbZbhvW)Rxf-%OTW?WL+Ohih#Gj7Q
zlq~(_{E4_7t0UfB2&4wZ`aj7%JH#GM2UqyEx5jn*oM`)Jg5v<e%ivACg?D*%TztRK
z*SmhB*77D|OMM!o$eYT3qW*~dAK2A=bLLK-GR0@E<z*e-4ROFPf|!^sk&$SrB;yD^
zL60oEIF2M5bIttgEd(n01IA&a?>VsK@&Fi6l)z&qE#~>sclpOD`+)zX6$}MU5E0dZ
zRtk0|(V)?So}^Y6n1>B$AljOnL870bU@QXUkw#S(FN9uFRF5AxaNy>S>?VXC^8Dqn
z=x>$vmNj?J&iLZ@>{<!uE(dutga+FYcmSQm@tgD04wNTUp^wF1cXHZ(k;341b|dHo
zMabuyBJJTef=CRNT5ef{+nACc?Zh*cmWSbTCh38XxIFB6z2PwQW&_D`;3UYCTZ+Za
z6sWG#rcZBW+fy?);<#6Xx{z1zS6>;0Ok<Oz_!e%lG>LpaUF}=_m}b(IwykQCF6=z2
zc&4+O%Y6DI>0N?|@Eit>gi^>%lJFDhSNQgSJ1aF9yvVYROp0kOYAwHjrR3M4*k%Ub
zrTeP6!!%U?41(n9cK-~<(CV5gzYOoM(5K23vNUZX&-Po$b5j_{_*$-k=%+5C8VO?s
zJ>mf!11r(34RV1XJ0opaRV|Moy0a%t6@T<##LP-ZFK|U@XejIVJ-RWKx0J=k0Nxks
z&RC<lVd3G%!bMDTY6jut0o~=AD3@6=RkPg6exGjpIBoSE8sp}|x*5p1XhaGuo#tc$
z1|%>7Qpkv`0gGtEc2%_g0bDaJO^Rzcx5jsOUx#WDPbvQB+(LZ;5y5f<qd{nNV8n@M
z2h+#VU*e+PiH3$JY=ZtRjtbh>bVIgr@ImqDr5u^Ydx17=Fl-es5ALowCkfPGV6aOt
z6}pGpw(6B>V`)j)RRd^sDfmQ)wmaMSQ^lnudw<5z;`t_EQj0GqY!0>j>dPSSp)q&%
zZC3^Y)EKNGE%ocFeh13Wy=LPgb2k`T-6L`tXyVF3w!4=&K4$pOdnbc&baA~PDf6&P
zz8Ry2=`KGjAOCB=Puzq<e95?}<RtF0{R;D<Z%g|p*4cfn)%RSb=MDosDWmvh{nkoX
zk6yuVTITb?+Wj9jt!r;qnv+B~B2)n}Ef&?A(5P|5P0ilPfGcJ9*Nb91Qek4qzCfp8
zUGRz0`B2)Pv3*r`1K9RAyKy~C&vGiWqP$!ArW?8&tms(R*^E2PxcGh=U1eBR=K#bI
zE|tsbxH>wEM$0U|9XIX)JH#MF|4fFuZ~|Hm&=|PAF{dvhoG~A$5P-)S53FG4{8&k;
zO(qv}&U8cS5GnO}i?%3hePGDT)UH8aU&dUO<5s})aX!iT)Ri;&;}4A6YNt^%eU6!q
zKK0X>7IjbXt-Eb)r7+cD9#r>mYo^aOSZ}+S?tO5GDkH3`dlwNNdvEI(b<Uc(X8~ha
zsQ<;!{WEo|%}D&`HvEs=hO4jULx<*QSXAuxNu12i>0wL?p3Wxag*IbOReoL5bD5w*
zd}RuQT&G(>Hr6P}fkbHYB75JSJ^Yz{jBZ!9S?J~VwDNPRY>Z9<8jbBRcQkEQ_4Q=!
zpiZS99?;kRilhl<k$o;b^P!ZZuJI2IH3SJ2VpYX3>fF=SZGMW}rtGFw?uUM$?a}b?
z>K4vKhNjd#JdPbk33Uv}xCb2u<k~op8Gli!6jVt0gTg>?D=-0}3K5omh5q^|eEH0;
zy~?)J9t^~B9k8ljfxU`}ZYF2Yj_Ov<5HFv(oj7u23^3vj`zO+DF`0l~1<WGRXPhmu
z%oGEG02ecDVKxI<>tI0GyE$U63UURm{20G>pQOhaHb|(o#E}DIC4l$X0z%!)oeAK5
z&a3JaUqPr}l!Us64i3k?kD=FTU^c$|iNl9GX4SK_v%8EorXBx-RJ{ynX95=+mRJQ*
zV2pTe=7qHc+pmxDYsYGC=Bp6PwERF6xUg24+3W+=C}w~*Cd?R)9Y~-I$xsf7$bcGi
znJ-|-Q0sSZX3NM5)M!`6IYtwvqkGpmzg7A!SsDwzH#FQuH12Tr{iT3{LaXbF;pTJ(
zq8uc(K@D@0%lG~K;*4nPnH8BsOBB5GlI8P(6frlm2Zb)&kclVHc4gr6$zT`&DlLXS
zNy0vnIYB1qyaXi(l@ivKxXTKrj3gMiQ>8Xw{ZgS=8n*mgJa<LvG@VX|xn~yXUI9?H
zr%&I@Bl4A$DC&FZqJ^s{5!e{v@Z<!^7u5{^O6*|ydXh9vISDQ-AwfXHS)hpWTajm<
z$8F`Z<((TYplJU-o9G(G@NZXwV#Mk*aQq~(%J0}QT?RZj`7Zz+y1)E81pQ(tfkVQ1
z{2B1C(0^gQKQR{C$A@`PpC~2T@^}Py#$DM!JsHFra}6FQMUaIAA8_7wiH6swDGjn}
zYDj=6R`8arrNkf9beJJA44@+eiEFu>lRW97`rM0OWfhC1!p;7kObPIS;C;-dSd`WP
zI(2GzF6&W@_;+Z{lvSG$QEkgu72h9m>gjLd%m7oa1g@!BwNt2r29V#VfF-RJkA>U%
z2Z(wRp29*lEvtgpf);Bmy|d>hR0R@}#eltq?S$F0+Xi{>t%E%S3+K$8;bm%WtK37*
zpPxpxyw(0Wd`K}TGf;neX5I#DEodszLOePs+}+*9p$L~q_AE9*ao}CXaKnQ8Ha0#R
z>&{vPQGGbG4*nUBLO8s4Y*a<+Vw1dzzWrIumQ_E8u{$vbkjcyFCYll<lFdqFx%`z~
zzsu`@_4Cpai^K@$2*ZT0G(dcZX9d%=WY7Tb%Qi0cDrfTq+R$mwRnrmNvupf@@Gg8*
ze0(}*y<G!^znezgBtIpkm5<`%*@-3N=~gOt{5>h$5O#rqdZE+$t5@P<kKS+r0FY!c
z7VDPKiEgXTKEKjr{c(Z5^i@{}%>(ekKI#(i$!_Nbs~~1AtJ!o+6`M)nF9+MCiV3&?
zvb$1bM?h?^BZDYjZ#Io)LuY$s3>XJ)ZP`*G`iA|`&r{Xl{ihw*5E!k{`7RSSMeXIS
z&UIkX88DGk@BUw0SwaF3-V%n~6FVeKA&On4fVcKD?TfQYEP`i+?ta_HrtML#%#ZoR
z$-qFXcj*N%2X>|o!R&P8-Q?W&P}8K#mM;_YVERkL`r51?$ie(Q?K(W<5q>Lg-&F{e
z$O(Lnoj`k9DCT@tcV$@7y04)h%SgN>9zCkPZ|9w=>`|0yEt>%N!FraqO2mG=i<~d5
zOHvCIicp{)c2e1C&YMs5Rg7_d)!SrC$fzRnx|-RZ@CBM=BRA&=U=t*?rQ$rnaiXv(
zs21dsT{u(5pzJOK?Fzn^d^jkDf6wIh1=F}`+alV9Mr%CCi3q!Zef3*o;uSqa=*Yj)
z+#k|$+E!QEp_m!T&+V{mdMIOPzhB`B%VkFN`4F%F<DMTo4C&Ho$t!^{!sLnhPc7*^
zBAI9AFdMgrZ@hQXHNJG3-~?I}Vvp8WI!Kx6)0zG{(~s}ZVlw~^Y5Dm^39S*Y63imD
zR64OylTi9so_4PU+d<q5Tl`4CFxa9*JxhqtAa*21S$Y`zOkw9EECrhS5#sc8at`h6
zp%I+3v8Izc3?&8?<tS#5o0V@>zHs4!q_xn*BY<6qkWr7Q$g#EC^I_@8LHL1PMD!`x
zJ}1g`ml<`okktI|>21Ml%p!qbB!lv1*z)F`G?f0#0saG7&bsV|i@SSs_9!NZOMnnQ
zbHj$Q&VLZyKp)_R<+3k0ng+8DqFwMZ(+%kuy=;G$`x>&)@BY!h@o&YI`8~rq0KrUK
znr`s89XIp;=4VH_Dhuxbs#LFDy?owK6TYq(&NSE8Y;NJ|1Y5HXCI$x0_NT6*Vk<1A
zAZ+-u6hcY&*ZBw{Cv|kKIj?!Vtiz(J^nuBrtZA}lN_4|lL)+(;?pu8yMvV~+h?A#J
zFHPIfL~C=|s=dG=BY8fO8k!TF+BjKFf3oMpd{_0peO(m_Q%5Z*3aQmqffrnB0&B_x
z_eUorBy=B9{W7s>TJE}8(MWB=Zi(A2Gmt@8-MxKs4$9*!-GA4-^vMY7^tdMWi*^Hh
zysmhP?C5wFmyuenKYOyP8d%xg)Knw?l7}lpOFZISFvDrPIaPaUjCpv&IW<G?l_({D
z;uW7i%5GBh@bGS)%Nf=uh{1VbsZe-cCr|gZd;MeUveoMg4!W)iO&wxmHaavl_4EZ-
zZCEgOQ^#&^vn#KZesgC;L(}#q)26j7S^ju3gc@LsEy`<kesiq+6?k8-stDfRTuJH7
z#ydUAqUZ0aZmpP8u_W$6b0b~x@H%ot_;09b)wG}d<ud=!RYdM>s{nbDv8v2bmtm6j
zR|VF;sDUoM0eg16kUH4)Kdi|4*IkZv{tvX$$XD$Z2U@iK4?O$6$%*}}l0p|qyI$v)
zyE9m0|G!04z9-lJ;l;u}7~XgtFUN<59K6T>Z&U&Quuy+fg&+{9lcD&prS?Hia=l2B
zCq7MSe*Rrazx5=Oes~nFbdC32vKFWgl={U&p&IJ?Fe^FoQ<N$n<|`@H1Dz5Y>7DA2
zt|qoRLkG}85!<=WD!l0zC@Cs;B(B|8=V`F^yN(+DURzynaK2^T-{2D*S)99Q96nlS
z;oGqdI=wP@+<i9IeH%uS(w4kgc~Q?gQNT|j?weKXT8tcDXLmQUUsFY!!ojAW%=x^|
z8fpDH1T_)O6tPqO<E>lZ@br=u*|xX4MH~`306lbaMN-L}6yE`Af4#aZM-u5m)ch`9
ze4Gd=2GKMegRJc0x#QX6i}BVfwSNxMjPIfzsDX7^HfrqGF<!aZw&VcMam?RlVo@Be
zlsIkj<iqHhMuNya7LNmdsd`wEd!U<U&z^b=>8$p;wLkNA_jY9@uh^mT*Hrux68-xA
zA%8IytR9o(^;Wp1pz72e&`YKe7$|YZRrzktd%9K?9oH^yuZ50N2ivvqD6Pkw>HPc{
zC&&DR*QQ*uRZvM=D=(%rr9-rD*#&uDh}hI@4damV2Oi;R*|}daWP60tEiTK=`vQg$
zl8U;tIHKg@KI%k@19+?#$`gDp{Oa#nRBT6c0XHi<V21M-BX_QO(a2;n)QP~{%X<rF
z82J6h1%S*nXwZd6Y8$p-v_R9~h|A^D3vTmZ^i-QgejPKSMWK2P8{WwA6<y6DrB9Dk
ztDc-5<CP%vI}*kP2YQ|FjDuh?sgkc+l+BuBPpE?=Rkv0*K1Ej`-6HYH$2+V}`Kan?
zMAc76^qnn&F?M0vr}j$xZs)vlyz%r^Yrs>bwfb|Q4KPAq&M`Kt>5ch&5Mg^5e7yde
zjn<PyYw#r9Fbiy6fF~X@DfAOd80IJfDhRV!xSO<b<)x`^l4IOTMWr{H-}0a&%v~h=
z23BGmAnaS2LjZ3uJ;*GHsBugyF~I<jWR;nc@Au0E|L~%t>N-wYBi+MG!g4d0dsQ41
z))|)!na>tdnrmgX+yh*-WnhMHWE_Z1v9DUyx9$TM+--y3{D2&@nn!_7k20K_GTrE=
zr%m+n3Q3xQYbUc>u$c2O=W87%kL0dNAHKtQ6@2D<PKH6PVL4U)vbu1R&)_ebfT=$O
zQ0N?SpShTzMBE01tojW3;+eS?IoFgp?=lmAOh;M>2>}+%H%j?zjNYv1!5nfm`8wjT
zCxbGHDfFs(v(O;g0`;g@+1-T_0UU$Dsqphuj~APbUgF%OOKI?ScV|Q0Opj%%h;l;=
zbw4|^<4%t!(VB`cP`~}A^IH4enf3}#r*d;~w~;T>rTd|poZRY3Vno91P%YEBI^Fra
zY1HQoKxRl5bMbDk$}#GpdFush0bYX!4{c0_GYpWjy{a?4R?vYsrYe$S;k3=wdr%mo
z9SB9jk2$EgEub0hPcr7WNI%`XR=rYpmdqmIxm8uBYbP{RTXPsxG6Ni@HmY4xq-ii8
ziX})@##rqKtHKN0%iFlOs{mW%(J$|+b$w2#SFOT|FCuePi9?oTQLrdhRLh}XCh5cc
zFwBP{(z?}@IlVN#U$`(Eg3x2;YNwpbk2_D{)e6twVKv6J?3aY_V+crV2jb$7bQ%%~
zyikLn7h;x&){|LK?MtLxdaa2VAo+t7;;B*HRSyTu&7cy~jEw{2`LNtPz=sr&%-jlh
z<8k<(w)XFOYpmgx3kW6_ctVtS?_4sojC<79?vSj0(QfjvGW{+U6Y$C!QZKj&d8mk=
z82Y-RiX0Wpg^t&<{$2sJvd>XI*PKiyQ-VLUu(p=r4V~!C1xAIPs(n7sVe0XBvPPkp
z_zL{d#JO~ITAST>dWfe%f!!|CXqVR`0$%rhtf>&o?pt4JKouRHwO`#Se;XXTgIzNT
zZ=W$l)v~Ch60ydZC>H?HEM(kEie?e>Lx<l@Pkv5F{<e27g%_XJ4Z8OFZ_cp6n>DT~
z`!uWftYf==k;*>nzAHUat1biB-gEHaSJ5^D7svOIK%ku~I%)g>^(vvv!?{d_?NfyN
zVb897e_xhdRa$rLU8G>s{hNiG<aTu)0bH@Wt0sY2!c;alKOsOe$HLg88)9xF{7AvR
zaI`8qZROazU}_7MTsoCl%rYcjM;QIEe_bn!Mu#Tmu}$hQHhut-C`qwET|gTCSRXE%
za0)Sg^rM4OAqyk5t5dbd4cMlfT={x%EiG}EWoW*x-UIELLTxZ8VIXGh7mEQ5M*x3w
z%nH7V5={U+qA_8I)GAXNdTmXN{Y45K%cgJD25)}dAg+UDQ{}`cWuLdH4dU2qKm9>}
zfW~(0yqP<X)h^#v&HFR9DtuLp%eM4Ghu`&Gn09ZQvc!rM5r>PKM^dKxC+E6372(6{
z%X!qTvJD1KfxKGTf}V4ih3tPb*O5giW}spSBylgWKc+8Ty7bwlVy~JqFB$IR-T75d
zCyV{qRSB7z$*$b<xLl`_;aI<S&03D_!Tu2eW0qtM7)Q&$D|Mi&GLj)^_rSUDZwF-3
z9+_4(FW<qta;uG1-@a8DJ=}xc`dUxYqUWL%0*}=VyIWCtai!=Lm9)&C;U8(JyQTg-
z{?q@QP1|lA+o(q8Xe#;|bLX3T7?fk!Ay73W)i#cykUHZRLX8iO&_*8(-g5fZr8s8f
z&q;T4uWmg_0_ANdaNJy2o&VC$Lqfg`ytWCipN-Zay42Ay=y80)>rL8~-m1}CDt~b4
zT9v8qJOxvOtpYgp4OiLN6?C+BuiA$INBodhWnN^kT5hmSs>HXB4YOd~Ej#$wP5E?{
z=Ju4-0pqHHw@hx^urp^bYuoLrMql6W)k-Y-p}GA{zpJ$V#lzN$uI6H+1(!@><VqUE
zapY|SS&~JiYm}9tNG^4u_Z8osL)y;9+GM8}g92or@b_5p;&?rY1r{k)tsg7!mE`3B
zer)P`0`iDh`vN3O^0zJ-G&9*1!~=MoyF|;2OvK^cn_Xa;%f(oo*JzhRFA}Pq4N%Ps
z-0WPH;QYwBGTQlDcVPxlj*oGAkjjW;CizxAS}I9iW|C}^>s;d?rIW?u)Wur@@5x!e
zB;c~Ho94Uy61G)^sN*qD-bz)`^#lMci({9yP1?<7La3~DdWHMF1d5k9+p^7=WWWX#
zYi*~}NVRe9!nWeT0q`3aVtrYVs-_C-*>#T3NA_FO&MZ<kd~lT$?AZ`ULS7$OB0fx2
z(1Ujj%Ykz;#Y@Xk{LUyWATa7ipats^5rI$Db6^uW^QDG>Xqk<@{jRQ6&`BSNQi$>s
zA&Kl0AR7=dlWUCJAuM*<(Wd`5aEd02K+QJ$82r-r#e!%FaGfB%ZrYqV2LeK}ddX%_
z73o&q<`VQr<X{`W@xEzRMfq`*Fghc#$P$7Q<=WA>`Fpxb{`yo_7pkoz0OA_iHiK4e
z3D<xQ^+2-x`1<1YghFeJU5v|^pclNb@u1pb8wGKJ+0A0SvJHYpg)~*QB#w-l))>x}
z0i&9tjp}PU6%_A0LO9%Psk|tCM6rTX#oolVcSzj%ql7eC*+<!W!=id04c^?~E`R9Q
zM(bAM)x=jLESv7w_p`E36<ZZ=Et@$Gu%pg9va|ChuahQb&HF!J<X>&zRc`$Q{~=9%
z{+_kpS*y~$IPu5WDgR{=^G`4KXUm5Fui9AE=#Q*Fn^WP?=Gs^xTI7u%+BoQ%Euh!Z
zKY?DGl}Gj?k*)sKZj0XL&a0>P?+a_}zwe4lO8;n+|B-0_>Tyw8^X9qT>S@K--sSK9
z{_Ho8N3Eaz>G-Cjnyx#usQ#XbEt`JdtYyoOS~a_%)uY#|d0Q;D-hBD-r<-qg-rTue
z)Zvdt)vF(M<_otaQ8SK~@4I;Z;^U34oN7{rO?Bydx3Y2m_0bU}wvN>uhw3f(a?8=e
z`S-!FJ_VRk4O*A@9pGb5XN}<Z#!7|18Y{7#H6^TVs4$s$LeF$8tXaz6U2pJu<9i1(
zLBU3tZXk2kbOT^*@V3O1_wFip8~y68LVLdYdV_QkwF3ZIW543~J_J(bcbk&D&C2(M
zTm|}=g3Ct5`@kdh-;GXQG*cWDqZ6_(uA;mzd2i=o{JRnE&s{Wz2=hA;<~OKm&ifRo
z&|1%uT3Gdmu@=^n-gpKY)T(BRXYXIZ=~3aOFB{F?cT|`bKB;dL`%z4ZNcK%Wk`4O|
z?@e6~T@Jcd)c^Y$qdGoD?*Yuzm2>nPyF5kf)8)?DBGk~|x<hmKWBgLDM%8kq#VnF$
z;Xk)uQ-K{yJY>uP(aG2~LIm8`@_(`SCSX11|K5KyW0^r1%P=C$7$IaymbMxDT1d81
zl!k~bg|=^uk-f+kLya}Eq%19}uWVT&grbzSMJs9F?#C-LbAIRdqxt=>|8?K@b)R$2
zb*}52%TV9%=ks1(ujlKzI0;d_acOerasZ6q`6r?pTD*8MW8Iy?9IavY6-;t)zj<MS
z#b#B^0w<E_u{*?z8yLpp;_7<)_Sg3Da%1Ynn>w^Pyuo*`;bP?<(XW9P`r^9I<Q4GU
zPn=k3Psihx)Thk+ibu!X)ZhC$h;ziskG`GLPz6Wtv{?fYdV42f-~%1_Mj<$S_LfgH
z0prm302lf%0v9i_>yo#Ai83`1k*Y21vv=i{0n^SLk(;@aG3RUF;i7T2Sy;>!{=*La
z&G$utPD_0~ulP8eYKrz9Ov%nYOCT0Uu{*AiwtbX$R8`r0QQ<~=$-w&@bl+z&3sa+J
z?6eV=s#)#V`ui!SQx%)Kx<)X|bBJlTJOkB(?(5298RvHtxAwSja@CJN?zE}tgei>z
z2rLqhRXhPCXH(cT2!%9J$r3KG;`)MWc+@hD5i3{x2C<UcN|tADK#uM!q{?<gup||o
z2=<wTgyW$~*EZ6dUTkt&R3mgt&Ctz{kW&BSJ8oMyh0SFUi2fp{MSJD#X*f;2RjXF-
z>MTbQ+x^ykDU_b48?MOzT~dU|Zkj&vYEVb$IKtV)1}Xqy)Odx`5=rRDH3@b{Gj^zG
z#CYKTG>>XqdWS;3!hE2{ccrepaLat_n=XYHsjizmJZUzC5BmVFbRnE+F$|!yH=&a}
z^wRytCOnIUizF#0mtvmr^iA>pKZ}yejif-qwi+~O@F2uK^>nd@_Y|F>OU%Al^)l%B
z-lcc$!R7G(vBU3#R9J|&EOZG0Jp}{XqqATSj8a%AzRwb}7?eqnCZJ;ud;%;WC-562
zd*Ii$&2gU<tcVgD0Bfzoy<x46;XoB_-ObrX5I;u<OOr}U{%{5V_$hG6#BX>ej4xAs
zn}stYE6VA9x%>%L{a|08#vvQ5E@NUa*z*Ez4fykV#e1s0-ZxxK&)OI&T=U~z>+d(D
zR~GydR&z&tC4vP<M1XawBanlGE*(W!D)>b%rkoPW6J6YX;F6)d4y2fkOZAwQ2X`Ms
zxJFLbJmXG59lev<eA(7Z)!3kPc77%D-|aTjY}Cu4OWoc((8T*Jd{xdQ0X90u#1fE$
z)8E4UI6jRjxYA(HX{0IBA+2^l)kWv@&2}}07#}@^$2M@k?Lh^7Gq^i04hJVjSquw$
zPI29E;6jn}JPdef8{@&JHJ1KKJdV-QiyIaGvUGeiWQh!RXUp0cm0JT&FTEaQSXFWm
z)aejSXh!g@o+gBpVrjQ<RJD_<W-xe}Ns8Y{t0A32`ZXP(u4dGD2!~k5&n_vFq1$|)
zxuV0-jHTtSQO{!DgJdE%ZdfW#t-;+jS9Igp*RAac^Y>JxBZ#-zHA50*`z?4f$&h~3
z);)3qslvDGx(Gpuoo}qGGuy@{(|b(Mdyw4EqK<QeN)?_ReCwBlhFfmB4|WFwmsaOs
z`3jJzTfyC>k9$Dp)csa4f<V`sUIX_fHodVxwa(`q6Aqqkg$pVz)tZQt946q^7do|b
ze?8p6;VgKS`@VMt#e`kI>b;|?xthdgkLCjHCw4ZUxbiy5FY8|LN*O7FeY_xKnjj9$
zh^peNoOiTTV?fa6-5eK<YZ4QBJ-EBbxLHg3&Xah!s!moBjOC-fg8IX3#!gkhtkrL6
z<*n9mLZI;VX9grb7)VA3ypH*BVQ3h7Y)yXj<Hc!qi2&XFJv_3Foyu{ui_<IE#1*sb
zX53{X#!R0&>U)hU1FGHO<8u_|q#G)&G9pmAjS>vf)xa`;R2p<dGrYCg0;c)aoCK!?
z7Xq%ezhW5}Y;_srNrH{#d}66LihA?nO5)uBQ%$A<<0P&RF@*!VFKI~){Ip)Jf6GC1
z99KqkHGvNK&wc_<8tPtMo{ELHem~p$Lxn~{mnsGt0`Ql#wj&AU4{+reQ~MDjyp|9v
zz!ENyx>{{2IZL`=t<55dhp13U##oKR@4y`<!;1YQl9s)*ZY{5T@6~#lD@I-i2Zdo%
zNUF{}BrM|KAx4r*#)c-&H2k_!un4fzGeCeBmM8`%W_}3o{%D!>vpr-t2wtA927b6m
z6hc6gFd7@hZXvfK40?9;myH`Y+DzM-!r8D+Ioal_2kbqO@}h^@YBMd`%dk{?v<Qf0
zdxGzCkQxJi1Of)PdUvG+!p?&Tr=>r1>h!B#$7(eAa}!U`lCptF7%|uoS_bE?_o3?I
z>MB3sWFpY-%Gd!ndmNFY#I2AEq}!{i6BrTToI7#w;9odfNIE{VMI%cy-0=0&^Y7Fz
zFJeb8Qda|=)qs1}4W$K1Fx=#vd2S<DZ0Mvj@;(fLBWOwBR|LeqJ+Wl+<Dlo@2<uCx
z%7(~q@bMz?jP>emP)(-C9~pQ2mD!cVK$jiu)VklAh-uGR-reb#W(;0dPHFn-@~;vB
zTX1)(7|B<Zw5)C)!fPXN0Q*#7o3jfm7lNsTyuoVHTv`)`yn?vNPgS}}TJ6;A4E$>R
zL4*SJ_rK%z$;6o(vHKR>llQkx0(JGs>HVkAbUJ>$DquvISc%;DVV8>XC^3fp>=N(Z
zi|MSPaU4C7siM6~f2@#YsKN^hXz|=?bq`KxuIx@YqNx~n_?OZ*+rjE`%PHpjW#U9p
za#5=rX99x<hxb9C{Y-I8cBIz7I1bvf+*zo#r*-{qvk+vESv8gGWCcjbKR*g$ZJa)2
z+l0Bb;mYeIlqVJ{k&Oro`qomyCvQ-_apOiC0#<}W`S*`5XP2kyve_%BC~vkMBPEl?
zPaiAZooYI!B1mi|!=$(1W7qNq&1_;kMt&zvii%2YYvW|F^=0_b-x<_IApgzZT>VvT
zi~IkD4(P)}tm(c#UYP!OX$AlN2cgxaOP4J+(^OQ}Quzi{C|_ID^p^Scr+pLDu_-Qv
z3ke?or#@Q#&0U5nxC?YvS-GDUuc=zM&;E6j{X=JMF&^NRS<~d)CWh9VDtFnjldpJ;
z{_)dWVYuDOR!|<SV@ubm?)cZEhGzJ$m#GD&c+IEaYqf6p0{-((|Hlsjn7OHUItE*f
zKYoD!vBo1-CSGi9eP@K-QEWVGY4%rq24UpdUa!RQ18X@j2>C)hWgT7rebYa=0GkH3
z58A(^mU}?rg5kEbUTR=9<n_NEiC_tTq5&5h!ba(x=6c2BW-aH+hle@UhB2hE&?)Cz
z+T-^k?iTYc1N%sH<v3rxumF3Htkg4oZU6OWEuS9r{FuM*{U3IjTM_H&O#QD=rrwL0
z0;=7DmMh_2Oj)G@M(Lzdw~M>AIM6vyIiNWy#bBc5faa1G#U=we^8{{rdIIq65g|{5
zyK_UF9=%XE8LeyfJiED%PVDY}%iCrey&bi~DFtD^Zx~Wsm>=?dS2CUB$x|~fyg6~^
zj@<6F!x&t&&w<{(Vl1Rmi9xOiGc3<O6Te}dhCSqpHhpHV>m+70A_`d(!<c3w6V#0v
z1yvJ`&9#V|B|YzT)YBU;ZG#aPXi`{FLd-j?NZDq686YJPI{k4Z5)!(|T!l>{lVmlw
zlnv_g$MS=1QgW{*j=z_8nOYRsKK)6K&w#}Ts5_3!cG^X$i3)K*neG^RX*jL{6$X=b
zaO2>XtGrpAVrEM1sd+2dfd+I+Y4L#o1}vE<2OQrIfZ98Q0!!{ptz$e1l3LnU-jQ~J
zm|6aGEZxD4;O+>#Cp}&;7a?{*;%T-d#uWFaQYTS}-5HqPc0_wiQ!Zpl!5Gorg+Dne
zP=ccUqO>u{MyUzgx!LjLfMzDWF8*wh3ExuUKoA>*FQoqBRa1a3a!5ioDVfdP!g3a&
zli5iXIrVXz(lnGB>=><Y86#~`P)LF=9v~)+FmLHsLB5rGd&UJf|1->hq#1+QlOTTH
zG}8=EB;`X?@2g`f8TwEN@~OG8CZ~l8^At=2JYz#fL3legMW!1jN-#OZi=<m+%N8I4
zLJ8sGpB_AWJvxqqjE3jGeQ`DX^-i-*23kQK<IW}Z#<C1avuUaOt;n9Jjifv|s66uk
z=mW|Rk0IdZv^o0@BR!c^n(A`=CPeS9w}Q1%7Iv$)m~;-ZIe5^mdoQORpWI^xwg)vY
zBa^R{-+tll@S-R4iA^?nT^v0Wsx_q^QiUB)J(xx>ZF6{JjO})xR@ZEWSmQt8msX)v
z8ayn4jXK(^={uk0eM+yO&!ZFJ26P2SUXKK#um;30K<aAVOBWrT$#hH)8FU{-{ItgP
z6s|&VerecqJb(~dB^hqZn67bDHD&%}%1_C=K#24dANVr5_+Rp>X+LD6JUlvK$lJGX
zrHaQcrKxK*ZZi&W!n={R4Ywvd<G{xEKr3Usg+nAwnMCHMRP$cyTRxsu&O0Wj`D+=m
zNx|K$S+hwOmMsus0uCGF^Ox<bSj<E=I<6eWynIy2WCmW^PvxEkf>zm8*@|wE|8NXn
za-jy@YP*~;Z;41^_<WB#-66VetD_Xl5(EtJq#jXSWTbczj(psv>XgLCNbp8=MR{tq
zg-qJmPrn2na%EvS64CVRtww4!B9D>XTzLG7$wDzl$Ua@H_V5jWar+R%0I|M{tyIE`
z5=+TULbE3UrbwXluMw$LyWOxrd_b_d03pLRej~x2gFPig<RKX-ycqfDlHoGaZosl^
z9|D2DcW!z4SX63D{mC?}S_MVeE9@%QFaIdW7PKYiZeFoOzWm`f@~XJJA3LudO);m9
z@{U2doy=1?xDfyQeHT@^Rqu#@ncL9~i5G3R8?`5&$TPkRd5o;6&yz_lO^)eT!xH)v
zK7LkL>5<qAGB`0-83HungA@SBFoXCPq!}wc+YUUCr>wRR5eaU<zOL^^x$&FCxtzSC
zrtcc8LdDaK1;;9imsv2o_Kn0b`BlBw7!~7p@dPhsr<Ua@{AbK5m`z#tJZ80uwvxpo
z-k$OgK*=7l3B*-=R81?-CpbAZXt1Sw<vAHDOB|1%ThZ=A)p|F~CQWj<8S{I@6rGBS
zg1B%DNyKj<1ICvmdObKas=1^)uNXV5+S`RwZS>f&4-kn7a%xMz77p=Fm^ALhqqI!%
z<h0Jh_w1`GCqNp`?7PB)dX_|ct4qf{Ljpw)iJh5@)&ZhV;dWG*89zdH7cG6$iq;xI
zI2ul(`x5dA4kdwz>9Eru*6^F|U#gqjQ$8{rs5A84nfri_tOd!2Dnn5u6XY4-d6M^W
zJ-v$Qz6`xNXGeL%!wC>}Wycsj_BnT&n4$@o&SJ^Jn*`&4$@z;1V&7AtP&yaqo&*`Q
zg=d9Z-(e_9gDoD9S1R0OU@g?YTgk>QTV0jL#XD35K?6J&H3vuPeE1ErXYlRY`m8rt
z9seuZy$((9LR_0YZRe@b7Y$^i3fBom*l_@}HLm8JLJYlQ&K^izOHhO<^Y5eiZ;xmH
zeIYe|N6>S891!<k;O88Mq%>+!Ri}eC(>hi=S8zB&-gyY1ImDpGlS`S}zQSBi7a*sb
zmEl4&NzF?Dl^Bv@F@1VBCJZpVMth41SXx%18TwcO1Os)t<jvp2PyjS$P}YevVm~D&
zs81MiUthe{cX&+%?AWnm^R*|o)DIJgMpa!eG<LxaAP-Q3ONw?bVn)arDWW#lBp~_M
z1*JDDTUC3%XUZ-Cxp)FLin=|@u8TcR2wzs2kKB6IgLC81OXDN`ZSQw_<s)w&1?H;-
zGNzzzSY3U<9SEA^y3xRMyDIy-ywIF00WP<K&n`_j8g(D$86*2|nz>U;Xxs`OY;~D!
zAaS;(t_Cuo2uWVD(SnGPXPSD4u1BT%H&<Jhm(t@_@Xd%mKV#cB2<xEL?nUL5vaAPt
z4n(lQ2H3V`%8!lI^`>HI(<@vKgdJ|vd;5Q+jQt}3w&5QEu$LPKkPS<%uwniB3BY{Z
zPtXp2F}`ldN(7Sms?>+{y@@+*M8)|k2cGU85H;E8awLFczIyVd#vO%K@ONzV9S#+v
zo{)AY!MT!W#YOy!@!l#3OLw{80}&KSl8y`*@=cp-<ihUy&B8hJhe{Z`fp-k6T|sp+
zP>6jQr96<B&qhBEHB;OOu!rJ?=*S}A$E;0WyUox1_MJPY@)f(QtanO<g`H-!VSgeZ
zURjpsC5K7g&RwVUef}VHT?wBc>f0Hkz11-T)~gy;SDeB4>L<CVrPkzU3nA^d-_-Ov
zdjo{VZE(=jd7qV_^~wi)o(hzc(4gcza}AHZk21hbCqe&^EGXCCDmUzIzMRXMzr^7%
z${Q>*fUK&su?qtEKqKw8c-9wdSJ8`taZRQa?HN^KRS6x|`@3?5pOK8nCam#GO)scx
zc#RVu)lx@4f5<F0pI;I79xU0q)opL&c)jXf+3#w-o=x4#$lYCP-eFI}p-H^IXFW;w
z{WH<`Kfh3xfo$s<MkGf<$GniZhl&?fB{7CT<Aexxe3etw{CcWu!DfTfSIzkXV%3!#
zC>IhCF-+aHk(;r<5m>MvqaisL5zREIw-yi8xg7gK0F)61i-OFzuuC;OP&t4EwT(I%
zkvJYn7b%MpJuP-QjAec?R=7h&^X{fta*l5n4yboIC2-`=%5L+(u`zTUaoyS(Z&t=o
zHBOCSw^0@E#t57(>(IB{vYVP(&&c=p`vg7b+H1UCmAS=az-0EyFj<Uc_}pO2+xp#^
zrlaiEy_z#@kh)s-e1pU@?d{7S)`z9*%i?B<TUlBC(*0J0uj;?9jD2FfNk$vqHOx5n
zuIAFDGiT1+y5g}d1brXR1%c4;iL+DlK&?35$2&MU>`uMCExovWNK~G;1953G%j;-=
zfo~%a>@&ab!({g<k0f5Kd%(DTt98phM4qb=d7eyk^3#~Q2UMx|{;}w*XmjfEq8B$^
zyo34}9i-ZO{_N_!aYYEmc@+|U{W_|e49Ew>k{Fc^To|6&nHfUeYIEp4TQpuCe%Y!c
zgFv_IN$|OvHB-yhxS#4?UAg6@IL%;+lDECp5uItgvVQoQ2!aJcJNj<$&$rtQ8!=+7
z>pt#<wdQlD@@#RP8=vN);6Zty5E}QJhxs})Z^`J|;<rW~0~NdGQkQ+c!@HW>wU!`E
zM#+7YeOa$Nz-=2^j{u(KY+K#x@%ds7YoZ+o+1Z^oZa>?v^AFy6%ZGVAWTG|Xl>Mx{
zD|wHBys6?RpE7s4ne<wlDO&mWPGdF8+!nbs*I3f#@J%Y2y)U&#?;U=Fho!QdYNmMc
z?Ru-fR`dCDjJ{%3E34I=gy$#qKA}F{A~Nz|w-4#rv{I<g9sLJ6zuG!NGVR3`69qyU
zEZg_@$7rqDTV#WfbGlLyDbsMbqQ`T@wVX1m5O%ZNl6!QQpW@Ix3FMdo18Y3vISI-e
zb)P%o1nOj=a!=v%Hz;}bh1@rc4;u~~;YR84kg!YKex?j!ZYgz?n0G6bhAU2Ppyml+
zn9(ulIYq@}E2{&d@aH+z)B3K0VnCDXn!oahq3v<Gt7Vf7TrxY~dK{B#Jt|r;+3M7W
zFF1nJI$Fb}8b|Y^6d@ek18r)IM7dRtFku^d|E>G6JXWaH5Y~lwIX+V!ai?OfDc;V^
ztX`hOce;zG+8pG-%e`+}bQt9Aw_{PzbKVc7Q=_mS3)kPmg-QCHuE84Dn&60s74|r^
z;!G(XQlr}o$(B2}W6*wdn?f5ni~TsQm9bn9a>_}E%EQ{;;&JhX12OZ^2#fi+6pI{%
z^|a2Lr_?>rw@;t5E8bek-hFarju#4rw(n9K_{+4g{SE8s_wrUJedGeOS{=Pk^)I$X
z#6``Z=ZyL!*quiIRY55Z1vBKGbZm8C$00Fy8nvx6F_fnCtg!aJS+eypOjPdv$<nSP
zi~z#_W=XX@+ln3XBeQOCN<xcWh>~TbH_2T`h3?MWV1t*J%<!1V9C~)u1?A*1Aucc(
z07vG8njm`&tEOk$!oANjs*$UlpBC-2h$})24`fP#Vz7p)$%)r+z3Tn9Q*^<mN5~Xt
zu@J=_ueO|m>8dIJPI@OH8H>lorMy`8BF4AJXnOb*3F0QarC4OaSddMiG3PiIA|!WR
z!S<l%^kY&+{gSXE6yGmxMowE2^Ra}>+@N{tu5_~0cgOJ~voSi@X_N%<&3km>*wLd$
zXLcV@Q@A$kDU@(C1HZsaG4{+&c_0bA^t^Sxt#^64r<$FccbMe>Hc=Bag$Q<t)n&eh
z1lR3zd^AmF>3k;qB&FG2>smE3D)qJgWT~?_vQYUqd$(cxHsu_{%J<vY1ESfbW+<&x
zz*{tU^~*~mYv!qj_od{l-~S^38@cl;t=4(8TC{5J#YXb~gu1Pod#$zZHl4-awOV(o
z5&wN)&!)HQ9#~-Bq0ORJ9KjsJIvmH(>+%P^F3bP3(6Ymx-q-FN8n^d)-2<9m{9DH~
zz4;G+{2KoW0gX7C1{xi_V!PdL@9?h{wW8~4pHM?{`x99GuZ2ziU&15*J#bgRW^l&?
zZ1vAn8qHX8<A=Woj-^_LCHtAm0LU-Tx>ehUCH!w9UH!Qr7{vU~$l+S-|IA)i{a0HN
z9U?HI@O@U&@_G5HfLaGOu<JY;eR}}>tA2Gd-TDkB*s}~5()!R#3Wx$Wd>6Ar5OC8P
zXH$S>kxIUJ`BLB#3R+`~WcrlpK@6G*WW76N%KHH>y>(8Qg&2VZQ<oXOjvFc0y0)zZ
zQB5vgV9;)BmFEg<LuwiOsKoBR<{>dC%+;MqvIYCqEp?6RV>~DcapUods@-~x83KsA
zr}+QV@*gGk1wiE7z4VSc73p(ciTNh#do-(u{e7JSZrT@TR@gOFtLh7tbXDRa1Y;kg
zg3j4MNiO~<{1$R<yeUSG04UZ?t$wjli&jm)s^sOor{U-RKvBh-UuY;&+XJddZwtkv
zVQI34LD*AFytlZoUpQ^@n(B7v{6<<(2jwpS9q@#B_Dgk{l4e?zl;Y<kw1v){hl}$l
z*n?z?h)WfS9<D-<tiANVc~{z>!Us1Kao>W|M5o*^tVes-{8dtu?4x9sYDh?rxHTE^
z`Bl~X0)_~)j=xPcbgynJ^WU+_sr&h7%zva#m9mPobzC}D8~czgFoh!L>&OkWkS+*6
z36NAYpzu5D`8oV%;O4wL<_wU6zw6#x8&yd&nSfo0M6<KdL~jU@s7X}KSHiSYXdd#F
zdiS0n2%{)0F;zALl{cZz=7AmODGzlm|6<ijB1SZ!W>U2tV@8F2X}Hu*XdUafkJ*;D
zF*PqRf6i<M9)NJt6KsmwCHmQ2J!foZMnmShC_5+uO;9nej@g8alb_ru3@GP}y?rO8
zF^{nZZA9_;S51>rvi!=JT8Doscj`!}qEI4e_vX`RO%GYPPk3fmuU(tR*Jw}&!WA@z
zgRJN`P;DPT+Y~@XRGc8?4=LyhabliKXCOw%`2~Izug+&`su{U{7lxGO)%sTqFRrH-
zNV6)@38ESl43<SE9kf{H)CfdSJsmiBu#nMGSNLo_cvp@oPU#Xw?2H$hxL%7*cyyq6
zc=cPDJQY#aB-ol_b4*3Jxt;E0NT!nWK6dOTnGQ%?F*|AxuQR{s{QLx?Ru(Jv%Ld}9
z&Bgf+TIBTnf^?!fQKdnxoWI5^nlhP2<@cn87sl~V#rRjW#Ju*L#GoOoE@mo&#qnNh
zQv7nnsLYlhG)Pb|CLUX2zT*sm`SC!wn7|+AbWPzUFE*MoTjsxuP(~_i(sJw^$|2Zk
z`o;Ovi_RAa0@PEyKv_xi=;RvIxugt^R>Y=?UKd>+rwbXgn@e22{j!c2F2SCi&u@nQ
zBjWN&C#Uy&34D|nPcuSu(L*1u?~~BQ2Q5}SuM5-b+P||1gy+PxLRg|(LM%BMqfN>Z
zgPzkJHi>fQ6EbH*!!z!B44lO`%xoH0g+VuC6viy7!?c|(E2g}Vm}(;<qw5RYnb-j7
z)-+Y6fNK@cnm?x#n81dhp)}7;P|y+HbXzhXD{dK~e!glYwkgLrRcu+?uN9umb7aKO
zGDXRA6K_1&K=i@)B|vK6(zIWbcd=IkXb3yD4}rglf!-U*Fzv9&IcOHDaXHXt&6;(+
zH_Y#y-~%x+ioIC9w9`YSbqb`>;kxxy5>WVk-#)E^5yxRi9GO|PH62$Mpi+cfbw7V@
zJ%p7cfK6bX0pPm;+0EV-FJXi5D9FmO%ddnuHIY%{Vi2EVTeyzhs0Ej9%FJ80tJc}M
z%HFRS9a*HE?V(e?ezLC4-jWS#m^LORCT>yrniq@-6p66fCF${-RW%H@?!}u-@{CrD
z<tVu6dP?Ywg9e4i7OKf{%KWX4{ScVs-721NF9qcHep~9=ppIvC!=j~k2999DEe9`R
zNq>k@eP1mt0qAA-^iN*2nyuG*$rIlnpOs{87n`PP)MlpQvXqu>Yw#x*fJq(f$P8wC
z<2x+UOP=JQ3z@v=S;FErz&&p@gYmt6_A(jX>z23zIR?(nd)UA!32R~&0Ec1ZI#RQ5
zZfI^8$5fm@!dS7@5?##=ss(Ac<5}$zPz%$yu3^vnd9P{YTB@m;rIp8@H0%FiMazx^
zT3`!G+t0+{OM{;~E5ElGTpKe(Wl`r)T$mjhS^K?ft*eum@cn5(fi-)byEGk8)!>&J
zoq%h2&@B7|WRqiEK0fWn%<}1<YeX&JsGDV7!{}<*GxYaMf%=#z16S2IE;QK+4k?a$
z;Sfb1hAy^-DCS}Avw~|-^mjZtNQQ?%)^~+9(QpP?0A&(`F5WHvQ9>5<k5C0tCqP1;
zM4X@d&A<sMFI}17vBvwqT7Zyvmn_#F-bwbBXP#dPc^niSb!Ye?{|UTM%kK{WDI;O<
zEO8lVb94I=>&p;yziFlhJYd>cCxU5ZN8pQ8VSz)HpUc2mREd)~53mHQZ~62myD!^O
z4*Y00021X##3L*FM$_k?1UVH~!j|eLyMy+#Yoa$k_Z{tI+{y1mghsTnW1An!2i19Q
zba1xc<T=c+hI`qt_8cCXPT5f&B}L3mo4Uq%ChFzye-enaL(}o7LM1>Q8)(y#-q`P%
zvZZP&C%=-)M2<ZW@CQowYLgVL59rG%JEph&2OAx4kvr!Q|BB^1|4Qnuk;VrlAdk~$
zr;A@s&1rW-qI}pj&-&?qSK00@iMO>#WB7KG4+QO7pcYo2373bjThTNT@kSTCney`o
zD+(T0Bx^@<n)AQAsIjz-+UKi&q*33vVZ$%2)}8k|kwOh5R$vVNgi9ckI*{sH<{btB
zo=C_t2;4a!PO%LH>1$Bu^F8`5=WDp?s3+uDmMf3o?q_Qh^$FV$mw9e=xpg`A{0WYD
zrrDF}>rp&ABwXkb-yb|jPX-(CK*hVh<(F;Uo9Qth65j`GAWV@sOKb$j`q6n;nbWiI
z<d=xa8^wy@>z4v~9Xxo@5kOloM(5W%rf8GQfV8t<yVuehl6-r{Oqg&oDG;72gM<27
z0W<E!t*dPCwXXWF<reim|4hiEK)BP-+f7^3YMp`~(xQ2DsSCQXtpYqy@&0;+`IH|a
z4o0_qdJo|a6~i}ltu3fcD@r%L|NCmB1u}vArc-7dX3J1DNSVpEY-CV6ZFkTt?xC6s
zHPYE}+D_Bw?jwvfbi}%XdSWv2S9rK=%a_lZC!7cAnV~3sEh>EqKPg|ZHK~(oN#2m;
zpD_`n%94A6AGzANwU$N1RQMKu)QKQvj(8r{(<)0MGMeM5D*&ln=0ZQ9K&fk3jRDJk
z<}y;E@=}<$P2$=<XLWVMmZUJQ4}|PS9KBMgGT4_nKO^NjUSVuViOK@-diHX{y_c@<
ziob9A<y`g=zBKFUGfcV4p&RvjwSL8)yWvX~&<A6Grh~u4_`R8Ph(Ik0bH|~nx7h2v
zspD)bK@@oeG6#YHu;z*f$9nT7&~xNV0uL6VN?BX;b|^!S^NNpgnt-@Y;`Cbm+2vP%
z`({-3hT)oI*;(h}x3bYZ`u5k^q^@7K-T#s9w;yjXRPLZ{x=Eb6XX2u?YaZNIGPnm|
zh98dM)_*9&{-Y&*7CX%DD9&H7+U6{?JKcTEPMcvZ2*IsQXO^G(wc2;<@iMPXtyYq^
zK~-bKS|}~g#Io+6b!|?7kHdy#vP&PC80)uu!Ns9foJC=HGB(K6$+bh%F2yCZRyX^`
zP|Xy)R#)QTZrm1cy|N`<D5WAbJgd)DjxEp~UuYO#(Kuf>e@wf)9e$Y`JOelRg^{@;
zrhydmJzqi_=u({54f~%pq5@;o@#dyxpo6PR#Jj#T?!5(5J=RNSd+~~eGTBmAn?8KY
z`Pr?wgoAL6e$|!4XRlLNz4MHViwo?flgLSmxJ`?Z8RmYw{u0`Kc${g4iQ`kM_jjcx
zDbB)6;nfsJzQ@u0>g`UiOMdy~7d|+&Bn{7y>ORiFu&JD1lvpOkX)C`lt?qj}Peu8K
z^1)k+(%q*rN^X|y7D%30Ka1SAa8<hV1^7QFwkN%;`Hmsok6(gd_O|880MAs4m#`S|
z3C(`1ajl+Kb>r>JT^BA~xW?=84S4w#3PaY)*Z-tTwD42~$0QzlO?;Puu##vv0?J$_
zJT~ICQ46$F2|)P!DIsH(uJsoQ{1qetpZqHqtX8-CmPyUcw#K#UDm|)MsR7sjMxJ?j
zcRSWwqrcHl?hOl?1?A`K8n*Pu+V4NLes_`+XKwiDh5Sir%b#PYPl`zX52!i+W6%B%
zuvqW^QDD)d?+DsQag^;_l(o-}TS8hJy@Ihj42wGdjj&fSkYYFi_T!r;3FU`<EBv%=
zy`jb2aw~^EU}EDHNMItVL5#5(IY!-F*#Fb}6D_jV6%V{vySeY(J0RYAi0St_D+IZ^
zIQ6g>c5#m-1YPAXS+eq4;$1KR@pfhYV?sFt$MGOW7;nUBM@%cu#2J_gi*QPyucG)u
zs?1-by`Dxmoe};Q;!_x@b3r4}cKQL(sOcRcgN4yx<I+7sJ2N*oXP^y*3`Iv5U>$J*
zgEMqJZY+5$H18*X8|Wsw>gwv2r0&2m<a+RlrmrjABcO{?@d#qk(LR+rkBX}wMHVoW
zjLW3F_ycGI9^?vN;~IN|g1tP94p!X8xT|Hr2AFqJNP%?14b|P>Rc3&ag;{D*CSY<d
z1RPqV<Dfy(4@o*!ekCZ(4hT!I6DOhC6262$Y1D<6tIWrKuxMv47SEj)D8KfK$D(4$
zgNI_>-j-KVo(jA|=cR!R$>b02B?ZYrfQ(6Hakaj-^Op1N@=IMMfkjXq={k7Sl1nGR
z7Jljhp`la7?HJmM<m*->f)|LM2{@3XpskD)4@(ms;{j^X6<(<f1nG{%3r$={rcIkB
zh!OArHLyRKTI12HN@Va^h<mWtdXx<O&dp{B6hA=8uiu@gz&C+z8$HD_7HKEV;$6s-
zgwlQ|BT(u+dc6ht)_Y~GO%yQg)-J6CYHo4A5r)F6_0Kn0JYMuJ!3;BZfJ<#Sqtvao
zRTZV!_%(29BmmwgF`JeK!;SR|xAX5Ds2wHICLU%R5y|bEseKow)iN?zytIWsh}dc#
zcXrmQ`s(BPqkgk4{W`k3wDZ5{82-TzplJSPRd`+<s{<+^DRn7!(ZN_w5YJT?-~Kpr
z+D;mo$Ir@_=R7$~r~ESUE}%xA&t?h~0@G~>X5<u#e}O7qBdu$6f}n~FN$aQ5`|FF9
zoqt8BP>o#OAQ|d0%s(XH$Nul{CoV!Pb(9$|0$E&rkbSe~=tyJg!HNQxs_XTb)ebd_
zX1!a)IB0rbma5Y(unK!-!wQYk>g+#3NY6Ku{ceKLf7;a`C!vj+k-}Sna@xjdm32W4
zl3}=BjsICP{jgNDn~wx_?A!OurNHHABkS95i%S<2+VQe#|GCdEt?6i~d%q^96_yI2
zaN|J)1*y5-{5}7leN^cY!PuyMrK^B|$Z99;aZY|~|DflvBp>l;kFwHk<rSmr)PGgX
zSKorJkr>{AuY91t^3^k$%ufOc(K+Przqaie{Hka~($0?85ZgbIHK&}Xx9AhpG1=`{
z7agFBH{yEt;Ka1Pu)J@4P}%dCCLgYLZT_b*!pE-C@^jbfm4~aGr)xn>IcP<LgYU-T
z*pr;N2;L7{m_uQgQ!@qJhK|OU5@1bp6gG4*6XYD>sKm&_3=qL!e%5d19e|rs=G{B6
zhMgqQtDr$^Ba|>x*nB(0iiwkpapWj*>Km-?k1e0qD+Mls2jMO}gs0(8J2Q{RJe`C|
zcuefv&p$hpxaggxes*Fn>uZhbeqJ5+^X2t1;DrdDkLSO=LH02Wj&I-T=(bIiGj8Gp
zyHIgj1e*rG%aDvXN?%Oaj`j&T*QaT1PoiKnM4qj)4Q*%mf&n}L84}NkSJrD))xLSx
z$@M?rg<-B2{0M&K#-aJE`+3Y4mu|Egf9g8*{12>CxHm{K`@I^}qNsX=i!k!+lOTS8
zdmDYr{`4c=ZNYAny68*>zWS;RJPSlWD0aaz=QcmE9faTQd%}0%(w|2H_C-a!y{7is
zH~1L*Kbxxl&#B-$=}eLcqE$hoai0BWg?t3ms1Sd0!dQ~xARs6-Z%K?HSBymyDKrGO
zm+6XC8RdCOOFB(y&|7?2=e=0d_vmplw(fzKFJ6d5LV}OEd_++IXR4{|3ul`C>8EF|
zk{n|QaL4FIxMmt!w0}lM!4x!%l1wKMvwwuj65trxQ9A2GObGB{>Q_?4G2ewImM{1a
z7Q7g+fjv$#@XOmS?`<G949pcW#gz+AAAlV~-{$Y?RQ@NBL371|^&5IN)u(Zl^ODG|
z*A^X~0OY(m<_|087ys$N05U`&B&1XEVF=93U&K<K7O1W3-V5ByG$hY7=SZM+Ny!SU
zAwP7$fTZ>D_y1~qa(he-1DZkH#GEJRXo&?L<k+gGmDu*nI%i4ariU8E&*v$`Ln;y(
z%a+8`^1bjb>o@Pgmejl{&`c#rq)$Shsbo~k<${nxcuqjg@RlF)^LYBCkbboJSNta!
zqGeI_OGyr=bOHeHS`Z~}7=YE@{2t~Tg3$tf`u2fmW+(?Vbi@FTAP#|@A~Pl}Z>`=>
z?Z2$!aJyfEya{1g1v<S;Xh`4RcaEnZLA)$T_s4m);zYPQZ@GX{Fa1|?=D<{*!q!K0
zb9PH&(@eMB{{a<*aLEtl8Hr*>c>5Gg{a(a((MNnFao@N0MjijIR(lu4W^6QI%^D(o
z-62USd_~T5gV)1OVZl^fn=j18%pmL4InZbmgdC^m`!`NC1N1dw>X{+E!s_B(AFS&C
zu#EZW$!Nb$^`h3X1Bo+X|Lqet?7#8jk@4D0qq2~QzCw<IuhjxnKIyHK<6tGn>1Bf(
z4fbZjPx|(45G>w#bma0FM<_uV=X}C7r{brb!|cASW2B{n<L@My(Q>?gUXjp7-`Qd4
z{*KH&nOolHvc0OQW<LBsQFi{3p#l5wV&+%N+x(#0hq<F>(`S2BO|cF7M^WKF6bFzR
zjEpgxcqN_dKZ_y%>F>o+a()0|w3>g5!_VKp#hT99$Vso(`rYb_Ma}~4PneD8Pc1JG
z*NOjr#z!Ap#s4=SM0H%s)9PWS9dfG;FE$#ma=^+4Z>DZP{d!!=p>sY*o%;TKJZ)Uc
z>;*Oto`k0z>3re7A~>R}d3?W+`@xgrfB3$^j8PMYc#qUHuk)(nr-b7A%JhhK^?U}7
z(9I4?C|sfEuCjL4o!FIww0uTwN_?hH6E~Aoi<IwlR^WXlURG;4(wF|_d|xb9RSkna
z%m0QrkSq1-qi{78C#o|NpeG?2p<*;O6#y_~ooWicQ@Bu-iWGhCUugyU;+HkpP9<U(
z5ynB$LeOl&k4a;3gO3ndkt=Rj-{5xD!)i6ZuQ66w3Nf>qQ)7YBX}H}YFY&4Zk+lC>
zEdqJ5Y_rSARtMJT+&lEPTFpnZTD>MwWd)X7`c|uj3fx{CwLWyFWB??KVODpH)Cam(
zMKroRp0q9h;%!wCC#R6<NoT82=GqhJSj(@kXk&F5?g>=i6AES9kXu^csySac<?CMM
zB(j%O&&T8JN-QIvl2G&Mr|=>@@oq|r?}N;R>8tO|m@#9Ndy3^~_bVRQw}<jAbU*!o
zE1Ibp`RaAO+>4Ob!|0&9Q6PhR_Zep*Gfw(m64CqNey?8;+qaBH(q@m`xt%ZfvYJ|*
z(5KN5`1<Qg^|%+~5nX48XliOoO(Xswbj0FyOa;|q^YFq%YcE@nYsO^{AguJGcBCdN
zbZ!J2WKx$F!CJrBz<;18oo8!1Va^<Xk$;I_HBFu9(V%P}W5S>4pVw8V)6(wk-QI5%
z2_hMyn00V78Nu`1G|<gH!L*o$!?iS6YFqy6%w9*y$dno8y3z_lO{E4SI{tV56DmZR
zmVaeEZt2o92kssH5J&SKa)ONOdj~zA?0NXWfx)7E!&77j)+)I19F2-fITJXr*7sS`
zLnoQinN+0-Q>N@vRF%##ojh4a*_as5n>+U|N-*)b8g_6(xwT9ASH-ifhXCJG6dyTq
zq_g9)WpCa*JicN0!3OnKOD*`|(W4`Lb1|5JAHFa!=I)ax0etBNsZsiAm9!R8DvT|-
zW<Ngy!U3M-5~3{DD@S2!q^+7B5;Tj>T$s*y)t)RXbFML<rJ|$IZDuj$sr3*7mcQG&
zu5o*V8mD$Z2(i`@5k$E*PmJDEY^@wC%N)u7oz9=&mhP7Fh}sYm!hPD!NhCJY@slQ}
z*;yy~W>5s$Q#uH*2Y2uOP7Jk(F}98ziutc^@~+w!aY#+IR_?ZM-#!fV7dJ^sc=YII
zuSWg)_rIlWudmbEV?Wf7D|>sk*&HBW&h5hTJc(@giwT0zE$r)}q*S-!eeAmTVjYv<
zRf-b~MW=Ro|Id>NVH@kKHw|4;aOE=88~_B{XSFV)&bBt{tEedPNo>}5?Kyx6pZM;S
z+I{ET$u4~NfEcY_joKM1k`<ONE*B74H#68gF*xS_3^TLeeu<u${I-HPgW5J`NaA=i
zv-wKV2rM?<v9xd2XIW;ORq+Q|++J<-aK?KPKE;v=>oF^X_a3PpbMN2?>s%LRVPYsw
z1DGA34a1!|&qIob!%P$i%f9BiDJe0ZnQbQCFZYD|0nvp2B=8m>RFSRsdR5_Ip(}mq
z+gQwT*^EU=vH_G;&at*4v!e+tbgqm*Y|5?+C#)*AJe_;Ix!S_lQ?b3%cE7s5q1m5Y
zfGSsDi~0G_qD2_R@&NRCe#32dt!JWQqiTP{5CzG>jV{Y6P*#zcqV8bCk>avaff!mp
z>gOTFUYmy>Brix2TaNwmlP6EIY%<@xnb@gWko)IKAS4M&tV~A?74=K>@7S71iW`i$
z8wQqHi7xn^w7rGo8c*&fnTY;C==Q=mIs{GPYTFUKVss8hgLE9K-KmA=_apw@A`rp%
zvci&?WgNIxR;!b&ZRgDsB8Nl+5H#6OM+XdR%*{J@in6PpU8$G%wOU&)r3x`Pyi>y<
z6${atyY1~#yNryC@znW*H{VN-={YTUD7e!)7k7msDh1TZr<nAws#cp-kJ!#*$}6Xs
z(cS?aIcTR$nN$5Z-q`RYmTNJ46%?jlSr0j29aQC4jF0xMssbj<n$6Z<X*+`REZF#<
zL&1ET(Dka1;=4GyN2k%T>&iBhP&gh%Z{?^Z6zD#!wp1Oi^%A=p7Zj~+e`O_lxRWz3
zOvc(>q)QHvSA6{AACrp*E8el}z3sWPXA`yRM1YL(`7MMlKS)=%5M7XF(=RJt1c9|Q
z6s8@E?xp&QK(ZMJv^@_)f#9*NBRkEq8|lzJA<%LPYgaf({FY+}4-OHle}?I?i{CGs
zQCRr-y~4u6qJ~3LU3Vv6sTZ#;1IptkPK-Ty^5h#{{;*+d*umL}i!@^<V#JS+gB$rC
zTu4}vt){m_a5CJkWKC1<_DxTV{<WysxGQLXSlGax-*h@2k~nkE5z*hX*t^nU0V~$P
zaKO{$ac0w}6M1<gJ3HIQZ>Igig^$>x0tPa^e-oDOTYlAV_>GCEKzU=N4i;2-dN$TC
zd|=Xs$VMI&f{ae$O20`KA-<GH*tZgm%~8koNq=Wi^KBiyRCj4vKB5<D(RgjkM)g>Q
zt;;`i-I#>Ud-4eokuJKrX0#mfSe74yMe$vl?RGXGXz3Bjumhf!ewVN_ER@%)Dx20I
z4M_$cS&!f8X!q|gTJ}hU_h>%vC=7r8-LTdr@p{)L)&3*uUG6ozb-kd^l+Lv-_|hM&
zh8S;Mm8g<TYSO36t({5Vs<ly5bJ^VJO1)>)PPG(1$)1UK6BCb$lC^cCqBh^s-BA<P
zvgg8fB=&-n!$`I3vFkGl4i$j2PQ|>Z(C*~59G9E9mRe_FVShDI)6abzY{Q{9>Z*s3
z^QcNL2G+cMP~Rz*^mxlZT`MM^O0XN?QglL!2zHY1@UJqyFh2OImeMe!pzeWj@eh!J
zx0kCBi04YZ-|N@@J)Z_ePc$<-4nojeZRNsRFPL{@uGSml=y*=j*{#0FuV#Sq>3aJX
z{#xC|&w$;#UbW<5t$%sr6b_7W?BGlojoHQ4^~##pTB=8EQdL=}T1jU3fBkCzqFJpk
z@V`^z^S|j)Tzo(sYt!0;QpDM{9A5=`4XzDkiOu>C6@$`JqcTVA9KIlLSvb;d2b@mT
z^4b-iTAi<C5!Tj$Cc`KKs|3`1v><G(<TFF$(vKXct|*x$!s*+$Z<irTF3*Wt{QOc~
zB21=2@1h`=Lxvkj;+v9|xU^`|B16l)bPVwlZPet-SHC>oJ=tCH72rxO-R;W6E$enQ
z`6eVJgsN8WOUr4~oRaRuZ9acqXV`aNZ&ufzF6E99xzo_-;HZxaIC?a+M+gQ|hP8LJ
zq0Ol*=0hWq<f$$#?lZZRoSfZ9j@`Lqq+j}Kn^?n1hBaXANo)wGoH7qGltd-u&w$^L
z4gAEt&@%Ql9HqPDDg@GHP;1U(B)E9h3o0lfOwuV(iHVp3_Ii?gioVWX-Q`A9mm*%J
ze)A4D_@g}(q+F60m^?5SvGFT1tS<E$ynno3lkDa0r$b5dflwwxKEOHgkQDqIUhn48
zP^fS7csr7zh4~B|viGzziS7$$1ajf-!NG`r%q1e5*S5trrNqS=UM7E6UJnT*h+|j#
z#C=OCPf08967cyxjt@C;1q^!L$gpSSXJ0sAyqYOPV^o=EiLj=RB0u{_cO0Fv3(7z*
zS$PJ)rN1VW0^y321*2aX9EzDIEnT{Sy%)@xYmv&RsHhlHvBS@Ly3qtr4|g~Qf4ybn
zwT0=1)zheiWX#wPyK4zGy}F_0;;)Yc-m-tH)gD{plc+~nS8Z^8p*G!5_s6>m2nYzZ
z4$6%IcaTB&r!W*{IgM(IM)l6|;mP{VKmsiYaZdfHq@<)m{#yVs9g@+d;pch)w+^4`
zUpuMQ(1wM9kI5{nN?2nl?$vJPu9A-`i7m9J<H@I$M6;2dnl=9ldy0d!6+HH1`}hBZ
zH?dRfYK{Ie9+b*r<1EDncF_y{ewHAL9zAjjoHKJYGBvw(Bd*nfT5<-yip(r%QH}i4
z3mHcc<DRUzz`M7#wH0?_MaA0@w7fE6B1=OYfoAVHBKDVT1yP|$jy7|;bI9WBuKwxa
zqes`w1I6QkQ{lnGhc<>6_xbs?Z}lT9zQy{XVp$|TDucfhbUua9mY(>3#mZPSSW>N?
z@L*6{C;9mwJvvg%ODVq#5f^j;@t~WPgk5^#_xKTYgU!#q*XOpH@qS72K;moQKI8x&
zn@N4q0_Td7#iBa6H&^?4&em9a5Q!PnW7Ju4%pmsZIZYHl6c*4CW4}|ZFMeRueX#!*
zFDCZcW!PqOx7Ll`prn{U2YJdo>;Ra{JPP<CTj%oI9=XNsmAKp10)1V~Q+InmL4JJ=
z%oD4uD%9fBKW@@NLrpE*(D4pAN~idlMP*KGM^=a!tlrcfCzAd?jlR$Ie{28qRS&VS
zq8QdUm=TA6fDD_8oi@4Q3NEHR4AFX+hmJ=BwXU>>*KCSpn(%!CmtIp?0%)*Z-;-za
z(-GS@bSuXR;Z<)wYHU1%&NFA1yuRs^RhX7~_OyeS>LbTFGj{C+?TFEP)~@l|mx>K3
zWqP{HvQMWb+`s?b<zC`E>J$G>ixzX)I7LaY9z?(k4Aa@z*KVz5Rva`7Hqtr9GCl>z
zPM+K`tM$Bv3v&yKMt1)2#G~kSed2-1j|&=*Wld`$@h%5%wckA46wdzAJrGquC2lD$
zgd{HV@9;OzRS1;CULA}3Si`NCzs=6BgoDBQP6+FO{=Fy(08657VOWS;1sj5(xrd4^
z<@m!+f^+6)EWlSkib|QI(Tgr~i+tZwt*2$w3HB6!cD0>JA5fE)4c5F!F(kaKd}+_A
zr#s}@I(C0#Z!<L^>$c%O`%HDU6sPod=p3$9di><%6vpGv4!Qh%k@@dI2400~4R_A$
z)w+2Hp1)j!2wgg+xgjHu=WvpV7*vUIRGbp_%wJ(Ax#$~R?&ZLC<p7&)HKb3%VaIF)
zPn!n@j!<{%)bmFii{>M~_U!4d-R2=&eycm_2)ns^#VpUZnOa#J4y7OMLg@oO28mWI
z#J#V`IKKE57s!-etwrd?R8HovkDGW;5A<K8Yc<5gWSi(sAj@)c9SsVafVx3)mn+?t
zu?XNTjBBkXH!%_}H2&%n=g&WWJnL{^;-dE%6L@UY{o^>1JmcgXfugfmIj#>{g7T&K
zH@y@ialiEVgogIZy;Kn(EW01HzdUt*q?<3i>(H0&4HXd}tEC27#hlCR(WuHIvxf-@
zw*YwtIb463vvsW9$h7e6oJ4={I3}}KXUsvrvekCaD9b8ei_qk<LBY8PuXv=$4sEKo
z5F5&mA>7I_@3lu88&;lWDYq?%f}s??K~<ma#bw3;C+<x&4~`BFiSCNr<bmZ^SB{H+
z9N(pqMp*7J?9=l~Y(05n^o^pV4=oNkdsdo32@PY0&ouqp0*8?|PUAInWqtFaa?Unu
z#jV+FB#|hA#yRV^XLub57+QL+Zp1oOpt7ByU0e(g?%kWE%n1H1>3bjs{S}WYt9HdY
zK28eK08X)}nr(F%Bg3aJ?IV)A)?RMpUw{eP1#%LAlVF`ghO9;a;m_ea_K4HVRc{v!
zurnNQMgu>x(~E98$rYd9b1%JRDKlIAEfUjz^Y*q{`)hke$xpmeYO0N;2D+GCh`tH(
zid;mjgRxgaOMiOW-o0W1zv}@_%ftKkt^9rlpLNDQqddX_{l@Ri)8*9f(W3{EP9~gC
za_%CViBntvR1o}@D}3jB$Ay(YU*<<Ra(eT|v({_)j_=Zfdt#g0<L|ewW5bFIHm}M^
z!)UJ<e7)y3;<~v3M6t<jRR+*$dEEmilWu6++uN0J^__%EB<e8o-UE&wH=#!d9^@Lz
zP7OW^ECNa<FdNZXVkT1)J|Ewz(80y$$T6|!fu^*1^X3m|_nhQPt=(C{A=bt%)Vw1r
zZd~yo8(WqnxFEJFk(E}d%W-yg`P3{zF)nC-WaLwYg{{i+op8c3W!LcCe*XCgi)D^s
zf-9yg66l2ul~l5*RK2M)%&*pHT}9IhO^Xlz9+W4>+!OM%EgCE|O?Tn7$XuYJqQWQd
z3=l5v$Wvy`+D}a<rzLEb$L=YWKRtc)XmVvyh|&~cg&3OcPTO4nioN1gl`onGp2b)>
zF72lf+BppqK7pOG<J~ZxkZ5*3*0Do@c{gv4mWqPWfJobbr-gii?a!6Hxd3ufR@G~w
zegZBN)|{v;b#tA^>FAh8xlWUO_yKJvbJTzYzEF&Lwd|TlTH4Q05tj<oqrK?akE-NC
z@S`4puRcsnY+bOJbh3M>1%!_eX$lzC4GqQ&zmT=IDeG)Ryu#ev?b{2f)!tz}U381&
zoZMx&Td*V%OEEZLzJ6t2N?t7+q`co1kD{Vwkrcs#{6*oiuBfixRHbBJOSQ7{B`OxR
z-10d_p8o*Ls4V=#>I=o@T7K7s=GGsO8I=$cv6aJXX+NHh;!wE$qqseX;N1PG9_hSp
zN1e0h&i$|n5JyF2k!CHwykM!_NZ>#mM!5u^{kk>!9mT|aFcp4<=PQyN=%W(gQDr6y
zd`-0D`|{rJccH`T(q?mbcy4YToX)`EMgCk?c|ODb`63^#mUaJxEGrfS&4L;xo-h2|
zwqLCoEb<bHl{bmxylA_Y<SPt4s=Of?q45ZlAIqu2t;IgdD^5C~q`qga*yNwku;2Ww
z0dMNyRDCJFOIS>Nm$%xZzX8(umzm^KbligsEhKnM@cvKE6)$YFT75V$qvrW8gxmDT
zZ17)N<Yf@##~9z^5>-)2uB9%Km9X=-gI|d2b|@~opBh&t1$NY#${pYcsjz05spPk>
z{k-4@USulz$s?tPc>53I&42j{{}~PcAHd_U!N7m>N3p19+r}<S_Q}Z8&`_CLwbem4
z8*jY*<Bz6l)vuTj`MR>`;-#F5HW5o+ZxGfOVJP2v>}N1L8q|eySiJEV7*VU1SC-Yg
zt6S?Ly;J$bT3EnX6DhAm$dIk*i=+LK+W(2~OjcSp))I*?UG_|+rDyIRbM=h#zH^L=
zpZg}?35<qME#7Z3o26ZQ@c8jDa3RL0LtFJUmp^e}e4|iCefHk-(<i3R2MOZkeHrfk
zbSj#aeXr9U<~Jz(W~Wr?j1bG38RQie6)BWPt1Q2$^-H~_UO56EuUoVA0ORwhsHa0q
zu1sfq2gwfc)(*IfVl4{aY*6lJN=919@`q9i3m@CpDec=z8kOGu#~23F(lW0-Jif~z
zCbdFl?{mAP{vcvLs-ZVc6FWRd5H7i}*X4z!t3x)EG$yL8Np5a#ficYadIPuLsB)!^
z7k|sxASHxKxza$A9B^%WBLqQ;E{at~a5k-nZ<1R(GA=w>|EkBEH}h)h0%{T1hmy-x
z;Afu|D%M_{(=w64-SRFnLI-*T!JwkDA355Dt$2Ijk0Ct}lo){dxxQOpnXX~%%S|Dz
zJZ1F>)(s$mB)1gV0y%xNTrbjXv$nRjkmaSY;PXww4v>Dy$8WrH$ID~KkH>%SrFVcw
z!T-{L_#`ES=LVXGH7i&w)d7`~b?zA<2)I3UP{vI*HND!d0B24Yy|j<wXMJ+}2;PP(
zfFMsmYgJXnN-}&$21dNw;I?POh6Yb@#1nm>eDzqLua{TnRB4aCH+PZ*n9>*dQ@8?J
zju$gjsY3T$yEa@V1ftxdh+p^h_u2JJox__H7xlA#x~!UHUWs91MZ7_ppTM}O-P3wN
zXp8;MT%gI;sEqu+&1R@-PSj`#%v;5m?fm)kzgniMEL07O{xn&}W5v?6*a=K6DG6m}
zkAJRSnxPJ>jZY$~Rrn#tsF9}NZ#mw^=CIoyDb~``o}@4S3kZ2&aJ!YI>wf4K!u>yT
zWcZvrd+%W?H{WoJ(^9(<K5#!Iyu9IQOvBC_8qmVgkvzgEjRg2WezApLab#rV3|fN+
zptABYkVI#Z;N82)wGjs=NNUa6ChZ?#0W4`lG6HX#bh6^-A<%7L!~QObyP(5J;<uw&
zKlJ?a+T-WWJv7J#7ZzTCSXPVao}jDLcaJFk7<_(4<!;LZlhwkO>&zsQschF~>ocfX
zrtp*R`09&#lSdwK{`}-4rS3t``zuQ~3pRV|RL>mTMCh%{D4KI_?asE>fvPbNPH(`;
zlMm%{BJMzbJ)f4gcX8d2m~CuWCez3GNp!<yIri?ysb$N<mo!sjJHHojl9qIkTiMx5
z&lkn!?BNHV4GGD@cViOcojZgqi_0GL_TJUMD`B|EKY~<~i64caWSFr6x>;FW#(DgR
zmqFP`RaI5_BtU&F*AL~R{p@$dKd~uz5S-<sCr^$8{=G-<Xswt(6L*b0gB$}GzB;^p
zF$}hYIphH&KaNMR9|<+FK384uw?DZ6WC^j}<h}9wG+Q*t<UKESP(vVKn3k2QJx=t$
zG@={J_pXmxKJ?%OR4|cHQ|2vLU`i)1y;y#h+QpL{YlCB&X8l3Wc(%HUv;MdNZ69F=
zZj}-O+9{nA4W@?j^7GTkz}1)Tfn>rBLeUR=D$a*=K<C`&|E{a4gA8N1>}|GjPJNle
zL3HLgY+2l4jy)-QF8nj;(vf!Z5?w017BPFq!9u+}$85bS@|8ynyRD7lxe<O^T~ETz
z&UsxZf1OB>A2$@@sqEr@+S(9Az%j0CkCO=ChoB`deTx+wuG7Po93ERxZFTu}y7itT
z;;XXYaqv||`DB`QFZYUrf(<Oy4Ik*s5fz$Lj7uT?Xz=%|kWc-|LP?H_+mm(@+~7}?
zPuVpHREOpNM*I+C-%2BL#Uu9v(r2A}kTX}nUazD`7htO3?2r*Cy2V*OA?{@-A<#g7
zxv#LK9TXo(V7%yi3$_4x6uFGhZe!Z1+4`_Rjk2<Oi?V7da=+KP;!H=o1DLR2+ry`8
zF3%D^d77Jh$>sLi3zG-zPOH|>Px(z+SnY8_Dc6d8KQYkHAGAhJ5Kcomu3P;eFmGjA
zf8{;lgW0F(Rk9_{xIYQ+5B`sRz+J8`5(n$CNgulxAvP&=-i?)xTR5)<MOCE26FZm0
zn0>I)mm2Vw7FUm|CX7K7c#A%s8|}xtNlv?V?!2j8t);VfkYl&B3Jt=hfykm2x{rk}
zcM5dO_R_Ck$*swFU4oo0UAp9xbno`t?zryL7jG!v+e9yaW#w55Bdg2InpkYy%TJ1@
zWfd9g=zN5i(>9JlQchOI&xp!A*Q<UEAv6^T)HvQmlFuz-OV$74{uBk(K{>-gCsHR)
zFzYA<f+bAjuS9|xKPmQNvhH1(vbZ4KxJWiotrW?oa_)S9(!wq0z?XhVdkpmSCQDE+
zyd@u`r%M1uW&Az;AYY@`a^n5;(@$P;nyIXI_DrImVT%S=_556oITqeyc!L?vSWtVi
zDokR7%#82F|Hg|DhhZW-{nAt8H@=(R<W7GbohNzo=g;3*+G9IYW4$z|JQu609=Qpx
zIiKEBl_c2%Q{#g^uqDGY0uSTm^3S~g!%0h}LE5_u`o6dsWT3R!^x?_Ft?3xAEe`tX
z?K9MSTMae0%g8dAzvo7bhp2L*XO0KFd<bk0QERqgqWz3O@l9amyfn};G)(nW1w>*v
zAo`?9CME~DVPWcz0*>gt>zse$-O9pFC*s@-+(M2W8--m$0^41LDiHk=qn`sL%(h=m
z^B<h5>m1&=d!(D&7om=|G}m9NS^ZG1J=#rwQPRD8`|+D7|Ll26C;mjnKp=UPY`gL`
zc4&<C5mTVfZV_w@Zw6|x_l$R|dF)4!@xHV-ESg+HXF?1Y#G0r~3y<;O35lAnUAuOX
zzRINf=@RbEG^+gS85eImyQ%0ws4lkVmtobq-X%W+Tr0FkP{-Z=6N1(EMwL1anr>#+
z^2<7HV>}3u)6Kma;UXP+jNZ8Ij=HI?k(~>)M@xh|6O~xE=iC;HwXWyr=p<(|NAL`b
za-sfMW|^I1yZuD!=+Q+wg1whV9t4a%^BW~`@}Sx)St;-VyGcPYllusmkQ25t{f6Em
zvuV?geT0gX;5^{N%uudzVPsLzp=Bx~T|T?uwECgkH*fBP;|Ncu{Ig22tmVe7xq|(A
z#@)WXIqXFL<AH%8mWjn|M7jS!T&)zpuz}{0ZXvetl!pfa<={_BDA^ff6O19`5rabm
zA->7Zo&?cPY6{wd<6&Ws6<=rh;#JEnD0)V@iudUXGBp=JprS7xE^NP7QcJmGWlG3?
zkl~ulJ%J`?D%FPu2a%epDzsPF9Ke_Nv+TpU6p7Tk%BY}yb;()^)rDj1PFr*c2aHOq
zdjMV2JohNrMwGWFEh482or;T-2lA?$PFpT#sDj)wWfWC1&njLK%az6eblC$+ToXCN
zEnJ*eWk}5I{_)op;V1aE+!Kj0<yhk$MS{aF4r!|<lsBmpWJo9@HrLW69OdQxevp!L
z*@;IDhf0^=>9i_?!Q_aLRohyvGkPC+&_Aog?m&B$5Rck=p&=1Wvq_ve{y~W+5+inC
zwxMy_DzkX)b93U<g|iE{SN0}IU#o)OBW?E#BDF$jENcdL#O!4rV~C=H;Ntfk92t9v
zDHy$oxb}+aE<PRN+s2gRjj?-~NpizZW{{3(+q!eE{Mj^-C^&uk^z3-bsQI*T;!caU
z2Od^Gr+2f<qn+a;z8)neZksl3@~Q75*1AxxK(rHgU2w7Mbz3cZ7KM>aXJu%<<kd)-
zp%=YgRQ@c&b`N@D@0~qo1YpYyFHWF&R>%1-#svrMKYVx?a1$It&+<{_xd~FB@hJRR
z22yN>u$9>GU%Vqhb{)em{+EZqur$-BK;U_~LB(p0k@}OcrE|OjA8(0uTL!Kpw()?}
zfrbN9IbE=%7%hh{U@Yb<hh%D;b&ioQwT~%SD6Lo_5cLd}-bSa6xgSMz%{)~_21`}L
z6KKSII)gNg^`$w#rsQ6JIxXZWBTH$Zz+3^-jbRNfc2#4B>|L62FWzxWY(oE)W;lF&
z3X+0Bzp~Yy-+mMSM8V)wwHnq6Ve$7bYR!TRDbsgHZiIaU77xaO?;d@S1N=>e(oW@B
zz1sSidMe6a*|SN;nI^DdVUNV<Eoh-qQfu$?|63>kgg9jM=naH79iXwOnzxsMAW1Lv
zRW1hNb@9ojOW~#JF{>f~|HxDS&foS_Ri5{sz`}0;61Y-<1=gn@yU;{bRNmKy|E*K4
z`Uwd5_v%_8%HekTO(b=%a&2uJeYHE{36%`PT5rXQ)!>{zR@YkaKWi^Yb6JyGo*5bo
z#%(Hh-D|B)OX|xbs;YHm{vUiq=PgZY_=4<&^2+u<E);c3t&gh`H3%2=aWU3z`eg>(
zfj7nODq+L^?tLvIbc%V05yp26L%>P;G?K@zVqVK*&oSDh%AMy7pQYc-iz>Rvae;+T
z)(S{(P?g3})b+8kv7!IwDB=A1d7MOu7Bl<({qMLP7t|2~24@ovN((PtpZTrsvJ-MI
zSn>lvS5@vB*Rlc%T<oUOcrh*7>tHvP$X<|^bTdw`%wqS8pQ+@}ANuLd!)9Jxs6CoF
zmor9W@T5-bmXQNc``XPhTBrJ`^jt`Y#wMJIRBAt@mQS=h{k|o(Mm%TLT1uzfD~U5R
zyNXwm%1X6bHrLY|LD5T=I>^3I>0irJVH{O&40X*Zi^wN=)heH>sMNMYk^;NR4-6gl
z=|}bdT_E*86NFFCgZ?`WQ+kavk+3Z>Y8AN(`h!Y^lj18vr_v3NF8}@AyCv}FZ}e(Z
z`C7|8v-s9hjW9|r;1=-fGQFo8T53+3KK)7Fu41F~_b!QlaYV~1gHvlKEL_p-(j|03
zlj+}}Q>V-*N+Mb1F3@~gPJ4q$CuGrrK_E5CqHm4JiK!g30y7WiM&C!yh*4}(jcoUF
zUpC_fW{Q?>g{GI{)yYKz{gawiSX^}2h2^h9%tIIbB=7}g88k^5Sqn)ZDJ0I|Hs#dp
z)*d}tG$8a~r2HKiW?t!LGiIEWTr-pdG_!~Yz+&&g*;|t26`dCpeZ%cWlRqXFT{7b#
zfy_lXGYGDb(h@n3`}6XSwOyDVE2<mTFazR~4p5=eCWN>eJbK+(ry@9Jg~rl%DsLt3
z5NNB=X%B#AoYGf-r1e8l$j^<et|}Ke)l*$x;=+y{IB>~;*|lV(!Jaq{iYXL2o*&T)
z2dL(+?agD#D=i(rM)J?3`2wUqhocKMd2-Rq&>2C|Sy`#K-EM5I8g$B1Eo*+s-+qCq
zG+LWVM_Hr60B;0Sr#GmCSs7$}0bPIH)zJoi2VSJrf4WNs04eqnZ#_OCW@K;@&Nq_o
zJ~`Q3AWGok-hSV=ZJZ^R6v%<-3#3e!nM&HK)6~%<Zj7Qd7a|3`2I1_Km6e6wI%{>c
z0YD=!ToNGflaC`j0{l*=psfn$f2<6ITO_MV>Udx<FWp>UfpSG!$E=El0osHDa+6Oy
z6NIb~W#vh_09u-UE=6|bhMAC?7VmPwdnVE%=E%40)x7niK%vFCn5JSfSg3@k%up(3
zhyx{Qx5A!9L~%twKa__8YpM&)D*Gv+Z=BviNSlwV3g&7D#HhQ7;{^7&`^5=F#Ei&?
z;;gfC28}C<dXcsQCg&+2wYg9~5Jzkn`dtmw<JiyUW{XNj8(yWt17$K1l6ney3-f}i
zw_ffUIK7&}-GU@+UERXn+S)p~cY1nyahX?1u74yuw{oEH*LeIg?V+_D{iZcyODs?W
zA?MD|xVv9?pHK4?{uD0rh~|`$6pT1Fc>tTF$l1)5>V#cKDBm={RQnT&i_r6g8k)gq
zgS%roWr_y)5F9G;TC$9ah$#?`U}3?>20;yYX8LIkB8&rd5nU@Y2}wHXDbg8Dn3*ja
zbR~yYE2`uGE>P;t)#Q`j{>`5=NpMX1W*A0e-ptQE8Ip2eva*0-gx8BUv#2r@0D*a*
zDfp)RXsavhEZRqmbFg$~NG8dwnyni#nK71@3(WaJdXA%Jj2JVB7>j++?jPdOXnk0Z
zZ3Df2Q?AXanVEJ;bJ<|KN5q>jZs=v5UE3U<T@`gY%5d%FS!@O2H_NI6R%m8n$Y@EZ
zuP`!sLEXps8O(rT<e9rs-%S<k@gp&LYk7ffdd*zPfp!07u`lGS{c*RlThxApL_(Wl
zn@_@NlvnhIZdUlTxMsuXz5cz|T;5qxl78ib$d+n?aSNsI`0-l`l}zzL0**iA;ZYCb
zu5esgQ#`;kh6ZgL%al=mzbrbew=~-}PEsBdOqOGE9wtLFjOB25L~`ikKjTJRoEPj^
zR<Wpg0Y60QCp$7ZIoT(ET9e^2i^<8!DSDl&NPbE-*fdy9f*An|9^wHFO4Ep%kEW3#
zH<IA3fWW{6FvGKG+=SDO?yS#kv+CO(v%R$1HlB||>>#IihpNgFl<;2VF`~bHfTP1<
zrc+%2MP1FAg0WqBnuqyvGB1&~Tf5EX(h6Rq%>Ot?9bVsTN#L!liF3v;UuigPiwq1M
z=*v;bGPA`5e9+RgO``J>_#to`Dqt{gup=;{10pp;Z!Lo<w}JaAw9C}&Bla&E0F{u@
z8_X6#VFBzWB9x}0+w-6|h>|QssCZ?ttP2??b>jg8LkL*n+1~IJlUSTdx}`09lPdx~
z%uxllHLOgTVi(FFUg*;NLjZe;YlSK3HhfLWC+As3wkP}#mBss2$-4!_b!k(B%!-LD
z4nY`nAAu|<6k;gGiwW!gGDD_VU|2wrAoV-)=jY;vDfDxRyJDLML`7NfG>Z!Rx|KPM
z+c(IRyD^+8uzYf)<o*dSb9165aaAG)jKoV<ULcB6;r;xobWAG>W%?|ZTYi4_?#9B>
zZRc(nUg|QHUx`+rhCzI5Dq27EcGtCC6t_Kwx?94-6Zd)a%`#CIP>*NJiQVN`VpHs7
zxVGSD9zA!?6qjQO_RXH_9qSep68PLVs=dX9W#f2$i``opGt#7xSX6P&`^&%CM^`=A
z`}6UF7BeLw4RhMZq(7ZvhZpjcOJ4Sn7eQ{gf95G=83OtA_7^`g4AQ$YnuJh$tJfwU
zugp^}b|p3AD&xf;##O#Paghk1V-haocqA07E0wd)*>Ftqi)O`^Bi|IbG!hhtWxi3>
z$kU#6(%Zjl&z_U9ii$OEt7RT~H!A7_-TI|^of9WdZgx67;189x_6L>q&dQ>bdJ9I{
z7q|3}iGTP|%xs=CaW(^$vR2Pv7{Y7`-AanW(!|6h_KO1{-~S=kPRtuqBqu&6E*~VP
zSP)H-tu}dwh(@3Fc!NEFSK3L2@(}W6-nq%8okx__YDd3H?gfr_acQF_3=7wK|LTvy
znVnLfLMhaLa9L7n)i=%6*bEd`ESH6TM;IeBA7b6XZ^hB9pkD}<>uiOqmD|H@$j@CI
zGRxBWf|i6E_l{Y(=Lo})PM3RSr*_I*pY&3;k7z#_8mq_kf1Ees>FP|7<U;0<Pwd@M
zSU^>cN6BKm`{z8UbV@Bbz&LF=a|Whq8|%FtIx%Sf>C?T^veNly2xT)1^4{bYU-gah
z7<Z;PZ!O<L?2jtX7pl3e_pQ2BTNAiW^=+B+?LWAnGB3f{57u*_D9Y8Amw}Go#*__W
zhRBj+fCbcs6JMfe9wfQi+F&8T8HRj&D~tFr3<0zW^pzaO+|SPC20iB%+u(Au!I%zB
z*OeysuO2=)n8zsasB6h0ahnpF<iq1rtQW3MF{p+Rn|&)oM`ysms9eL|<(&Li^k-UH
zSS++mee}iN$RPEj=X||irxgrzEjiuj^69{a8bKW&mv4xF8RYAEq&#6yVGCW+=8x@L
znz)77%cXlb;~2k!VO}$L4{4?bz-yhdD_c&oa{o&`gonY1(xoEwx4bj@Vasy%NUoif
z3><x;KZYd$p4>ttEk9Q~6mh7{h!Mu6xS0v5giAt<C`8@+l6!~PJ-67HeKH38DG7YV
zY}Jn)dN#ZBTYs&d2*lfrO`D&~&bx1~C{PnlhIrHy(A&TKe9#^7X(p~fIP{n#v~7MP
zJS!)PDw!kViBEAQFe}Q0GO+TLtkN+3Q<&|W&=~Yq+Pr$NH@2^VPFsCv?X>7y6wy*#
zFvjU~JH>j4rMo4~LdTw6m{hLVIo2+t%3%d#?Yvf5dFyA_+}UOcCdR2v;u!o>RF^B{
zI=i+eIcZI8c-)YPC@YW_HKADxKJ&lYyVj^C&n`>rRHtK65h;OiQBkDD3J8X)fJHzN
zMLJbMkwBn|6$mH@$R%EC<eK=Yt>A@JXp0pEBcdpmXbD6=1w?9zT!kp8Krkpb1Ig?M
z?P~3Z%&ax@XVxlf@k7P%yzl$G=Q(HZv-jyN_i&-31AZ7x<R`|)tI$9G1sWTGl@o{+
z?Fpi$Ep1^|QkoC6UC80oUzC9@D20Oq>BK^Sh7)F>(tA*R0k+2wAvAb+|7y7~VCV0>
z04Fl-qb?$<7osVHyxBy~WXAYrRJ|7u_A>oSmL(o-=;I;cZb7=~OECPqsjTcg@9a|O
zB6yu4rS{jWdJ7m%Svkqir0b=|Nt{mfpW}v_c@%$jTsgQ$4yp{iCG-GoMZ_K=PY?e1
z9d%y(8?S!uZB(OPV{rnxr*j$uAt5583t=R{+vgFXd>RVKA9*8)wDax-z2Y!5jW-Th
zxDiJI(&~)7^(jPC1jmPgn*PqEX%w@$(hq(<-}uY!8Bvf>EL9xb2^Cs6?p}X-cfAkJ
zT5LfEYx>j!pQE27=uSL@DLo{X<A@>IyzhP|a;upuy!ig`GU1eMIbyx2%c8V`9hiSY
z%0Hc(Yuw?5xK9S1JYcnK0+ZQ0)tELySQh!lRfaUXzMBT&y*0OP@dKO|zX=(=y$6Y#
zCAK$m#loVT1J_PX0P}#FPgy>9slv4bonA=di6jiu0V9C%$Cuhi|9S%Ks&MqtRwmyc
zX&bVDLYCWo3ueiRbN-Y(G%Ap}xL}>+JyQOS-Pewm=|y+->@1dnWkUAaP$RJ4+2IZ&
z2$4=~6tor4>a6{up1-Zqer=So=-87R!+59V&fm#xdcm49MdIf3O&ezFdR+8aX2DX7
z6m_mJF)@kKp`J6nTR$~_)8RDLHE4x^2K^6lLg4Xu5gWF#zBnRC5*8l|H%Y>~EX|Cf
zt7SpwBVATKCX?R{sn3=s);|ZN&5aT`BPe}|-McB+$tCs8ApJ<kot~1gn8;?#OdR71
zTBNJ4^jWxta*S*1jONESL!$IkjDa6Y9(Q#7Cl-%{GRn`x-NQ<UGn}U1btQo4Nq*=}
z!2>KS)7P_$UJJqsiEl27HKJQ{9V`g^!~bU-cq?(kU#Z1kG0K~Cu*=_jgjvi8=|LFT
z%&Crjiy_QH*OqU9)8@^mFd(6O${FnZDQM<`zOKqM_zcKRo{8em<mM~E70pCFi=abf
zC<1It&cKR+klC0!`D&!;mKYse$OW>IlEL2MYtk05awT7XRxZd`wEdGQI!F$Q?g1ca
zEurbUZtZr<B}2d=$-F{8c`c_)jHGFAkR^G>F?A&}KkxCx4I1;+sk?0}rJ;|@4&RY^
zndFrq_4TFu#30uNa$AeQXn;HhRq!V|(`-4a$k$0RLhK7WIy&rmc?%zi4|SV0<%yr8
zk7E<kT%rzzv;sw5&e^k{5@v5^lGsE$q=JoU&R!_s(N&*+3G*9KFswq%4Hs;CUP)z=
zS(Z5OUx^$PV|}G$d?@6r@JPAa)lVc@sA%PVWI*&<7Z;a1{SnX=p?s7-J%_ls4#Kg)
zra?TY3n>1(HC^+@gpwP75rgt-QjE$ABfHke<8;MYc@JG0-^!JRQ7n%y?nfy^R0_o<
zp=!@JA50FI8~8CJ;)?Jd#b{sN(aJL^4!4`<{gn8l=XaYU&HhpJBjw_uxf=~NSIrDq
zb|Eoio!PDB?`aws)Sel>F}>#gZ@!O;ho=ne&Tna*+V#?=nwwdZaVuwOU-Y`Ai_)#@
z>Xt@u%k6sVmM*PQ8Y|EklcqoNa7s8jSfhbRwEuJ>G+8Q@deXm%y(Ir)`2AW~$t3UH
zyLafu^aN8WMpf=8PR>dMQ6>WD(T?<KmyS(@(JQ(9;K_ZVcE`-V2#$tSFaZ9de8~Cy
z_g-}iHcD2;?j=*G<8Dq}E*LzzCObYJ%)SPd7MutyqEmLqyhezf!@zE?+R97qEVF6|
zh(6bQ5W~SZEiEnSuu8tryY<M*;4^D5oy?6f>Ct@JqXo2i?!gyq+=ES5oe-Ng0jy9*
zp_N))T^(ehElZ(~%ms9>36(FU&z+4}TLFWqcDRgE2fu=h%MKk@>fl^M74**R3U*fX
z;7e_o3#Va@Sp|l0Yr?%M83Q)vRj|R!RRWL+AW1JKrFtPL_F;|oqj^!*Av368quEu6
zDqnJPXLS;X!+9c=a#9vuJ2U)#Rd&2o2IJyQ=X|a%Cf5taB_GDA{&bN-q40vGFb<Ff
z$Z7-NClL<DVA|Cd_!w^@op5lcx;HZa;R?DWi=s%mcJ>O>PH@sBc`gbbUBtJ9h+VrX
zQB`N<=QD4bOoQ*COL3aP&%5bbH9gh{*uf7j&L@+VkuB6VHc}DBTMyOMpR|ivOlI(O
zbUFKkS7?L-RRHUgWyHW6#z(w^Aq_=#jPv7Bv1w+bsW;z0EX=g*<&P%LbUK|Z6_tb*
z>CD5FtB{+@1N2HZ3|2P8z0B5612-Nj-WE(+LAb_wMRNhr=%X&@;^`IPEjv;39px6#
zyZ{_RW{BlpCDGxaNBqS<Z%=M-uAA3CFi?r@gv&A61u$kI?W1YaDm6CvsNo55&?YE?
zIX4BG>*gYcQ?96qOj-b#z{$+aL}lf&aMR_5XuHeo*uK0eqHeXUmYZNfZYv;zaG2g!
z2$XWbPo-Nf$?ru8<jqgIx>C?g;p*YxG4|uo6LDg^*D*JEmdN+@knJuQN)aUDSq|NF
zwV#PuDBJISl{$-xl{&TrS+L`$=fiCHq?H<dq+K%roP6#5`(t|<@y?;zrt4gId^}l>
z*9E_2<T)YLJf5RU?Trt=BntCP9UXm+<Ux0^Aj>VglrkJ7WIq#5=AWKNbM$36B`}<R
z5l+r67fvp?l%%S1-7B=X=dzhc)rMKwqV(zaBI5+B7G0f3=385#crD^+QqQVWh3vy(
zm6#;e;Uv`$)v4#EsZ;OVGXw+kBLK4sl+*1<W@RW$M1qmq0wE9>2?~6@7m@}IsxNkO
zG(2sykzEWgSw>7T(_9RYZqf3d%%*+0fR?B_pZ{LpOlqGxb*3TBOV^N={^M$piEhB+
zlF6K-nB&FJup?h^z0KXeA=nDSDe_^VS08^jC&!t}T}(T=(Rm90v<-h*uu+ogp=07h
zJn<n@{*7n&UKj$7ILvT2D>z6)cfuQy5p+rXT=B%z)O3dP9Gd$#;@PyL!pS#R1>f`t
zUXd>Li^TVLmu*CBQojN^q9SFnRB=2Ejaix&)eXK+X}NjVKCQOy)Zw3=JN{Z=wu7$q
za9M@sB$avId`3kPgV<fSGZh_7A^XD_<KF1?o#KZUZYqxJ&acV-HOPX29WFzv?c!;b
zc5iv2D#K}I@SYMOdql|oCP{Vu!6el!+c0xuk9n;ZzYYBw9DqU}S^K^_vZ<(?Omaz9
z)$|El)(t(fP=dDjckh>sC#8IUG|TWYjm?ZZ;qKU)h2l(vnoxq4uS5cqJeDz>A{qO|
zYiCktoABp2@aOn5_TR_1cLSKohwf;dR#+hf7ES!YmkcM`I6<o?y4JhL#cNNE`)q08
z<-cDt(LQqAKGE{`{5H}4QaPWbdOzu1PfKMZ=8C-gJ^TBD-wF*AKH=wW1pqsrAZ3*I
z`|VKLBRqYKhyyUTb)YfAaOMQ}Ic^A^We%Zb!yO&GE2ML~<BnFnXrRB}IlDH|C0p&y
zVMibOMYA1!_NyD2^?@WVo!eOWDbbE>Jr%h=ZbYKbC3F**t8XK$Q$GGIIX}K<yHm>m
zynV^%bY{keiaTdfpLtBMO`o?N)27<XAJkM{zwW3527ok@lhYkdT54Pt#<Bs@R}T@S
zNn`}*ApNAd^wF<h4i1V?3+W^KjP`+TzL}L(dW1KlJOlH>-<8;?+|?tE(d`^tX(A3n
z*R5N(j$H#YPC}Jc+xA*;pGu`1Sb<a$0SXfJ+U90m<q%g%A;}W}4-sm=v6B!z*VBg&
zC}UYyOHl@Qm}|Ig*c^HPOg;J?P4X~bY7SF=?^xL^a%vx0;86)!je+`=k0g97rWX{L
zmtmZ`2q$L%k^qt~bePYD#<^_Hl^mmFF`CUr9@7<H0qQUyhQ7x(@A4*Aj#Y!Ku1&4r
zUDpd!waghXTagX2l!H#0krxn7hPnibuJk3_*GEJ~R=kNtL1ipd#xg!Pej(AlU;$}@
zSGfX`gc>E!C3)L1pB*c23r;|_F`ulQq+A8nHpYuep8qn0!~fSfC0r@k@vET(x9tuA
zzDgMw^du5$9}L+hr!`Fa!;z&<mpeZKa+`hSiY56?V=?wYfopJ(!31%}G1e#M@wX(A
zBL}C1oUL#HS&nQX7*n5O+@qqRBBG*1z+3g<TlaY!%sjZ*ow(;|n?kS7NAvR4p_aii
zP3#vZd+Dg4X-)i=a(O^GvKtN9^`x{a6@z?q+@)j8Xk3RmFNr?-Y(qGFd4|y7P6b-d
zB=-s%yeb+e6*<Z|$a&|$d<TX!6ubm759Ldbu>^RUo*e}RTMEdBB}m%wq0U%lcSE5u
zK+9R6ks{*yj_^{A^Gg=vpGhJM6ukX5U9p4Y^nfd70>j(J-osP8%rOHpHUyEjF8B$z
zk3RZH2qi{47|i4>qjokmG!eobnxuS1OWcd9Cp|rBXgsn(Q6M2dL3Ss}I#9ZW=vn?_
zD~-GeNGK)xiZ*?QpWp0+fdXCyIkch1P9kl_SPjY8$>EFpl|=FwlDT<7$1T3=GC`Q%
zGXlDMSdArnd41A!p~!xK-@z*`E|#DHU3bSFY_I^B=s0DXJqJx;kNTi~<V9cw8`(jH
zM?&8bD_HhOvQic$XGL57JNOt<$(+!~_~zcR8<STo)!yMv5=0b89bZ9gWl7R$HHTiX
zL0QGcwy;*Iox^0oTOhkONcixfA9(>_^V0rvPNueOv0iL9pX_yFZDdfU1aX`O9s@x6
zSO#l9c(tYi3bUEavf(W+(qWF$#Sgr7m>jr=xS$^6n|9p(tjfV-9?b{y>14Qo1aS`!
zB7nF~+twsx@eoaiqk@}e-2wgnOlrf538KoOR+uduJhh{<)a0K&di97IuylENh+Eoy
z@izN|MC5-JFzam{d9i$K;s*n$sTqtoP+5^*QHjDe+o&atXk7IA%!uuhOSV~e?2ecQ
z9@%TYak2_hgq7<n!h|)O6j=!tWV6k3R;#D8;xR^5nBy?|RE$Z92%Z;Ww8$05wX5?I
zL9hq`KeponzP8`qUP`tg9DY*;@?t>>c335X*@>EjB22?`DV^3k`dGP~Q4VR3%c#z#
z%fYw_S$LH(8^G?-4zj0`R6{Uc;hjnB&0g~I;MvhUGR%+TnfkY8JG{uK5vp1?nLY|3
z4;ty?5~W=&nMiak8nb7yTm8h53xOe)GUZ&vSzM-*Z~ga13KN=+?XHCh@TlNW=DAIp
zG>JTSU~>t#yC7`8G1Q519$px8jJZ0Wk*L`rhYm~wO%Q1qK4Xq<>ap?=q=u(S7c`Mv
zEN7@uFxrTamk0TO(ZhXHH~Jn-60$L)$QH1wMaN^4&DSiX;Lp@d=)pnLCkj~!qobo(
z4+8-)K+n>f-$qyV(+`$9%7R?L5DaR6LUXU&b`-r2590V;NAn+JNTC|^blGLfU#6O*
z;=JU<Xpxig+~#5$-c9mCBbc*K8h$+wKUSXbbe+pF)U??9%2pA8BL>jY@V-a4JWW{G
zmF0@lBaoW?H%}voOX3hYI?z@gMBIqOao?h0D<#4G3e_{mvf)J(YM=WMp(2HpWxsZ<
zn@^kNTpPFd35bi-SMS%-<qh@h5=Y|S`(jRx4TdyrazACW1al>;tzfb<0-bMaZ+vfT
zRh^3}V%UbVzHhB?E|h@PC0TnV2Dwns7QsbOBUv$;;7v(D8M>dJpaK0{AY5RClcw9v
zaF$6wIb1gK*hGYJ<L&rgiKOu(w5SavvvyT|@=z5sK^?aSMMSc=V5^6YeVi4PwHaj3
zzv!QZd$`J^)PevM<mEw=hX~t{Bn@WBYQ!ZmJ4pcy#gKh_t1An#Ssbd11S5T9t>mMC
zT2jdkcu|o%*wd(qpidHhqvR-$br>c2AN<p46D7Mn;rLDDmjJS`#()B~=H}+`T4znw
z;R6GRhPd|2jiD)|1DXWjv$=WN{kzwtsgi^OjU+-yQ81v&V0Ub+1a2MFzR!Pi_7uWP
zK^s^LshWu}3D|@oT)_%E<YavE+lWQJmLIx;w8?EIXbVmTV!ad&OiTn}V75^*nf}25
ze_2~sr%pU^3G$D2iMlv`ClLja#Ea&TfCiVbMaQxMc#9ao@52#zUGcSW<0T_<x8~G%
zMZ*_@z)H0b9%vy(X?+MqvKqm8u+EP9Z9fRO<3lkt<|@xwvh&P%V_aqc@}S!KdQC*4
zSrdm<mDlyl^R_fqp1i4(yl+)!8Zo4Aoa+2_)esjAE{9IXVPl2Hl1fy;e=TbND16$=
z^{H;>v(T6O&W}53&2Jm6Z9~TC1Z-fOD(-a|#5Omf9VIe4h{=Ln(DMA33jcgH-=83O
zm<t27V(SdB9!-h7UV_5x3by5%Br}8(Y`hI8Bs`=uNO^%?eH}gmJ%x*%0^)%}E5-g@
zya7s(GQJ_;dceb)$hghYx@=tst--4>{uANw2?z@dOLssIkb&Y{AD~vV$y26C{*(9W
zOOhFXo9{99^JE@4N1N*MYWK8h(>SkQ(2F@ro^qI{#&v)O<F=%gN_{p$p*$VJhjO*3
zE&94-bU3m{YJZo*Z^Fqd7QBTMZfXuFU!hF*#wd+M9uvOi`e!65S(JYLz)0%^Y&Ziw
z0k-Q#9lFBwRRREnsLwdc@0)X$PHte~VxCimcIwiP$zKMEJSyWuNr=P5UT*XV4(-M5
zHJ?I}aq|Zs-nFJ2SKG4Mpj52eHsMlX*ANPxwCE9p#f^H(7V+9n(e)J~9$vldgsK)M
z8uIvlH{R#JxA<+41&`ncnuquJoOJowCdc!YKzvs!NV)afGYdD=OJo9f>rka72^nj$
z|1INR!JpUL>m)`o=j1Ga^|dzgr{3eDl<^Rl*Oha5h6WYZeN=LiA_<EX%f<m((LOy^
zqK9q4NraqR3R#RNz2uq^_U-Doz?eVpTU{!_4#|f?fK&pU;a?Hl-#?hVI}lAemH;-C
z*!zwLp1di??MwJ`zMbG*co%dvVSW1M^2S4#{<xrbAz6PT5N{zye}!B^(#SYQw5~rQ
zjp_K>^P#nb;k3Ea!fpLQ>$Jn(4P=<>_e*j-&sJlWD}v&h>@R0wdtW`Z4R65g8E-?7
ze?P}R5g@<6KL5Wq?n@i5ZWWae9;{rx>`RruVYL4_jP`e!`UCYJKQ3Rmy{LF0O6#u}
z`yY$J=vkhYKLupb5U+mcV%{l!8*-WSyOP4%Ac$!kKSt`Bez#^JIrAHtPQ?Vb-v+2k
zeYXxMi!JE)S65g@6*HZh6IDO74R2qLS}%AximGr7ljOcq;DoPWjn=aY<%VLd3uC2;
z{2_YHBt-xZL?t{0ATRv)ecrznnxkM*L)oW$AKAYIupZ?_I;!H*9tU?775xO%#U8Gs
zF@fkH;bZE68EcC*q@%yD=_$Mpvh7{UFmACDHlcPMk|(ev3=ycVU9f-u{s8-*%AOxE
z5yI8p;+Y)zS^YrcT1!UxydKOkiA0Jy)T$h9-9^_Z@Ek;wqbrcA;(YdlDPQ++R0D?p
zxuI+(0eTt}ma3>!_A!+MOj3+orgNu%3ciHG1^Xa^69)eMq5DOQTZ_h61^mI@UC3T}
z{51nZivyo?9ix*12wE<iL7nZu_wP$mJ!0{i?+G3Pk+288V3meomLzj%jtPwNN9t6=
zZLf)j2hTxzsi+&!QdfiMt#k_B1K#A;0-F21H>6k_xDypamte{XkOZj*#VX*uj(7y8
z|L}%eDPI8I%RN<WN+U~#ogH{9L!Q`l<r`j%jXB;b=@h<yFnA7AJ>((yaC^T0;Wylt
zDi5MJQ!_@n7#xc~=E;LzN{_=WT>YAArrLvs@M8$se2@j@(TS=cvrLEo_c!3qo$l0@
zDb`s0S{7EO686&!D*3xiEay7!2rgFTB#i&f&26&>lRV<)YNtUeHu8W#KidYmr6G;v
z$z5iRzIU?|Xq8UC;6uj#jEwj*gP7$gLU{yTSxpC#Iv2CLL%JG9`=`tX^IoIGPhz?h
lTor%+S{?L%_(!EaCFAy_4>a~6$g8NVbY8PO?{mL>{{=<tyG;N9

literal 0
HcmV?d00001

diff --git a/assets/eip-6123/doc/sdc_trade_and_process_states.png b/assets/eip-6123/doc/sdc_trade_and_process_states.png
new file mode 100644
index 0000000000000000000000000000000000000000..f9e1a2246cadc99a06505b5b91a45550c60f924c
GIT binary patch
literal 82437
zcmeFYXIPW#vOlaWR6tQcKm{d0LKje~3M9BF2~B!$D!l}hUIGymr3f(rq=P`{O}f%z
z1EfP}(v=>Hp+f>m-nh?R`~1)M_v7ZeXt{DvrqA3nzbD4v0hE=6hvn3%Q><Drb)!?K
zn1QEGoeg06i~b6HV(1P17xNRCrSGXzd|&>2pY|H`2h(3nGtf2BpwVb26w2Y@VNhye
zMMcHz>?|ISzx6NxjYfNVdVc==xv{ZvdwZL(w)X!0`-#cP@87?dwti1aN-8ZajfsgV
zC@7d;SXf+M`TKbe5{c~YAK3g&Gz@-i6Ojn@iI#mF^zPle)YMczKfi(L`S_wbRab<R
zt#5O4OZ|8JtNi!D!NF;@pR%&DGBPqEt2!;w?`<-Nz0tYu@mYyktm&st@t@LCzi$$B
zdLxV3Ve$ia6r6`i*wg98!$~&0!j1Iay?q+(LtuTX%I9ZG8dPQC8Hb*l6Wh~8&~YEO
z_o}BD*q)tY<Ue(q>A!#eR}cSng8v4?e>1^<Gvfb$<v{fw;}@&c2O1*`|M4qj{`Wyt
z5)p@6Sena$<Xnjsx-{P{^iTPDqH-DywYp9@oU=!UCDW*6qBMm%movOBu>|{1dNOck
z7=R@6k=M7ksht7n{bO960r|vcIWB+mKgRpX!th9s8H;P1rG0={)jcGa`r!vAxlDbT
z{!{KmB_g6OR8#g%Z{{2Gh|Lx|;&C9K6#0%i-hWrc2pwkEC=k#SdJ+HmWhb-%!<}NL
zAN;>;{LN55FfWib3az%`Nd6XW&77~BDDZFPeR!>Ubd!b962++l3g${yKR9rDBgXn~
zEvQZ~jZi6+xrKyN+BM{(IU+Lcc8Mptu=OAIZB$h=U|N1dc4>geLbvVlXHvyj{yF=R
z>EwiB-G}re?TA`xEj5`~o&S$=F&sySkv5xQH})4^y>1jzVO{!9ZC8z9dLf8DNFF#t
zblicf8^uKG8UMp9O!wy@vFb{6-q$<`NGzsz^V@qdrhh(9i|IQnyb%UU3q5`X5=vft
z>?Zsl6~bWjgF4<Mh#%%R5jPJK!s^}rM?czstJ+|v<S`stLLcqYng7Eh2isAwTGK&g
z&fXQ{Q=oTx?Eib<r==Ge=WK<w4R#!(&3^<5#oX<C@$b6)^JavGwiM<&7Jx%a_h+O2
zw{v;N$oO~H_yd7!TD)2ibx`t8jGN$pIJ~3tb0t2ILX7`FInvg~Th4R-ljG^fjIO&4
zyAz}}r?lDp)Bh3p(_Mz0>r*BvP~lT|US(3)zDKHhPi#0p<?BC9m*JB+!+={toh6Vk
zVQyh_g;7S}mfe1T)(QfxS?6B)#drTbfT3N)Ku5ws!4&edyBo}vqbNBouyu@+_=__8
z2n#0;I&m@Fj<9NEugVU)p}rf~(^9uriHc2i$jKu&C%^xT!AWrIWOhK0xsi5cC%jW9
zAI3|t<C}hoRv(D`bUNZeo$`+z>Xg+AC2YNZ_Rx^scS|$`$8n(gPM0w|YzNKPqu#ay
zXEkm_tB?EAkW0s0rxKVqT(Oe@j5o_CFw6cfs0lve#mJ!XkOup}7F+ntNa1X+*;<uV
zL$as)ZKb305k_pEpyC>-2+u`d7F3N&fD+CDMEYU*q0pM?!q||zg7Jc5g(YX-h=moL
zg13MM-uJd8R^|IktX{}l)niV7wQoWx@i!l8k|sVUPl?BB%2<q>o*U?BfW5z3w%PRk
zXGv?)eh^~w{*@$^ICHTY&oV3b8GlZB5%=UX3_^m>P$qc~Nuwim-tMv?gmaAzq*1*O
z=~K+gEgH2;7Dm<0hPC@LvE=)M3F$+tCA_^${&#IOE|nPuVxfyK#gkpH%A0?E#96Yp
z=^8N3qgfVk3s7a&Qw@`}b*xT!D;-$2s&NxL<f*XUrXk_MBd@MfvMXs;)=a&X-nDG-
zU>Iqkk%zP3HxOnxf;q*$)rZ@jP}BQ;Coi^umSH<3DNiIz*xoz9hl|C4@cMo63-0s8
zV#CIlWB0>?MU>3Y#n;Nv&X~7ys97vbKRGlyiPdQr?T0omNQfk8Gv`~%y}>!yYASR%
zz^kkrT8sNCV0vc^#<|uwP9jwAGW`T510T%R%bcX`OvB8?yDH$2*5~bK?*9~KFaxTn
zlMfo6j<5r?J}POS727n58`EZL?M|=&ik%aCtw4gR*m^;M6KatKO{`wnZ>EEBFL%tP
z?*YVKYp(VEO{glAV(%RbQAF|^@X%!|U`}>n)gwM?fNEk~uph27O~W3#|Mm!tJF8>q
z{FpeB7g1T8JM->gLHpp33$=u5g)D1Fg~k=>z$#2L2#guh?S`hS>o-N3?Y)!3SmmfY
zv}#dZ<K^PV*8Hlp#k+oHSec>mk8iSxUOJ7y?tJSmd;7pR2O{%U`$9wTsNsiHP9_V0
z8=HJicJ}P7-IaOZwRpL?QCL9grYf)%rV!xkD2J(zF!^Y=SIWbEko?)v%OT^cP@%#)
z>%OaGQR3xp3+p<3nLclkR`TNr)otdVKrV=;UBlpzK?cX4kC<@yP`u7;5nne#y5E%E
zP#?k5eU>9*B@9q<C4RA^j$Dlz8Q~(R7Yu`qL}WBfKFXiPbhPK-+3AjN`~AfAeQj>T
z@i8s@I3l|2nW{G9Jz;ZlJCmTPoAOw|EHuQh@pB9u+c{~rW|39HS*kSSc&)^G^fAB<
zSuQz3nl3e9yS3f$>(ku7>9x2%Sv3Gs_NUIP+b}ZX1^JoB<kJ?aTk!*r*Y`$SX-~oU
zy8yRJ%|UKp7Ha0Tu)7gVMOe}7uqMjZcEAlF_94!$!0*Q!-7QTy4DP;dL1eA!J9Wk_
zv^M8WRQj4TgH{%1@B1!Hc}>(tTb$7@e^mS1n`r`sx6kCFzYm~9A=bHXRqGg5A!^lg
zlr{#d36r-bM0^-@1!Y{T<ner6U?po6uZeEUsFbkO%O5@HZ#0pL)8_w~c?yj2{g(NY
zF(T)I@PvZf6bb~&;_ojMzszL+)?sPkrrlfbuWd4cO+GzsH?u0+A~x^iOPy3VAG{oB
zKt`%UzBUMVDtxI7c(%My(6S~d<NfIft~`ENQeSs%bQXMf+>^~v0bvbJ?W$j&X>@A*
z42QGG>BRgA0#OS-`O!YmlqPWIig)Q|E|qm#G`!J9``BMH;LG0>$GN&amkZO=j9X35
z4eyRWT`0zI&<*GIQ+sw}j&?WAaVi>H#(}vfk@)VZz>of*+Evc6;a5;#xTS)lU4GGT
z+p8LJeQ)!VuLL(lSvp#*wl3Z8v-|$1MfoIf8UcFsq=anCfTQ^oq50;<Veyq0WHas7
zrtU`RU%4|`DzUDSvGkY2H{Cl36E!!*mR7qtKc(Q^@4dT-rfllNTURwaNX^Q&s_^<+
zO`QERl|Loj3-k=-2UNX?d-<&FRsA&pVV!tr!%KM|705FkYz}Vq{nSuXyVI=*=mICs
z-?#<vP9PSOKO{9xA$&zhguEkI(Z}~(3~VseDX>w<%@VQOr(ZSJ&&<(|$j7aZG7CcZ
zM?V%cm|E~ofD|8izYPkro~YE6Ir9}R<Sr@2252fNOOmK>4{5cid!Eo?li?Li=wTL#
zkC_<xEw9_=^@I7jMt)^O!@8lbz`2Ie&qiH;&s>ut*A)i7+SgQeoT#l;=&63BuVQYx
zw%M*E5>M!WrYnRf4T%XE^3WR^&ZK9T0fd1SdxcPi;S|8!d6qQi8ysx$d#jb+ErGj8
zH7`@U0q4(CRzk-I<6*(yMs#i#xqDPgy053iOqVGSLfSXC#jPYq-SrzPn%Ay`zxPBf
zQQfp&#7HE@^D@f?t-T(3KWWnq)wfC*HT6F)JJwL4dBbE@gXy~r)3`fX^&`=mEg<Ld
zKF5eljjwQ^&ZytrEDIGB&su!?d&}IIMN4jS!1fSqCSEFW-*2gM$8{{bH_vrc(UBgm
ze0>>c<$F}8ii-#XC8vgL(UA2u1V})tb9Jhw_o>D)?*Y$*bcQQue8>IJwTXPg^vp91
zG0cb!VAz~JhFVIw@Ffs=8b>AVt$5&LrEVUk9@U7YN}nzQ<0+v$ZsPj82;R9aUoPj|
z-XamCBiUX)?7h_<n}HHfMfwan{AFY>O(w{q@~yjB+Jp{GYl<g-!gJ<^=8o>Gt{*0a
z3H1tw#RqMySn9Icy54$TmpD(Li$`mlas0jFmL4q5YX5lOVEIha)Yp1X%QTVh9(hT#
zA+;)qwRnSfD_O0MLtr#|Y~9R(Ki}mMQHW>%SYEcE-?KFYGxg15=w^tkGV@7MhfbYL
zr9nBGacXTTm#@4dUdur^@v69G!$!TjOqcP-)Ve7SIB#rrzG?5}r3q=Lq0_q?Lw-vn
zpPOv-o>2`z@ZOhR+2o)m>eeb#FGL2);d540NAGG`7}xB!7i^&$s>P4edkAQ((n)yu
z3K`BaWD!1Yzh7I{^w=O(L%-BKZshX4B}Mv+06(y95&Mhvda?^im7*Mnz}RoKjVX7M
zU@}wL<glukn7r<uOQVUUI0XYi_eP$2oU%@H>knJTmwnKXSaMu)n-j6$!rMnrO;0XU
z8*FGCHfEpHkO}p;o#8IAA9NIz_G{t@wp{WEE_Cm?K{l)OapyrmeNZ{P(niFx&d0q3
z`d*>#rER(C=W`V7>nP6&w>);swRa3RTP>noCf-uKf8QLiIr3fNKz%XJjUaLy4MNF2
zPkuC7#AgPZ@({2vGSsvf(w4Ia*P|UDtYnq8g&!YKvTTXo9ngDB7LVrcA@VBL_-NtO
z6Q9S-8dnL(hvQ>qZ>cJ?r#X*d?umTuLk_St+X3B+(<$~2hWcxV=HYz>R{$Q^G`!h1
zp358fdaSg0JgIQfY*=Zip|9|7O53`J<@Ba>p3xYYy?Fjw#W^eYj`5pSvU)JHmzwL}
z9d0F+4mmhJhwY7iSrwGOT>Eq6`QO6vN}g+hVG`DjV0^;&K@{t{yRG96T65X5B;Ry!
z#;u^zzsNAS@?cAH=NmHU_nV;Wg1;!Q7{PmJKH7=C<W6gqJuStg{yT*DKpV7O;6B$z
zJtE^=Jhc2H$x5*+iJ7}}k-a*g<Xa;elcba58PUS(g+n#_w`0F@CN;<Qgm9}r14qa(
zeU`-V*DKoL-}dpbnmU&0-H&AkEZCH^JkbvEj(lDG=lsc+0`-PqH;zqi`rA)6q<58c
zOuz#tWvgAJI(i&`Ol-TF)C6n*nTzu?29iMdxPuu-J(cYl@ZEi_N3}d%WLQ&i*sYGl
zQJCNt#~68xiW%Rrd^l#sHTq$QaYA;@o5eUynclJ5`q#}-Qwk4$FUmz(Zb`CSW|?7|
zH!Kh0Y?B9&VFxSPXQdu!X9pttW_QuxbDtrHkP)PPn>(Q7a!Vl9Lk_P3Hu`m(0e@!=
z(Aq)&?O-l`*~JA8^x(!o5TClqu)pd*7QBw_L$!hil}ncNI-Zxa@Q8k0wE$Y4;p!f)
z*6d4j#l{5BhCJj5Y#6;>=W(oXmD>O~Lpa#nsR3i~Fz@Cmr?BT0ZhG<sXdd@y-FRg$
zIU~{j0ZktsfL4IS439@%P<bDpghNXHudhM+KrIdo)?-~`5%26a=hpaS7d*~|h_l%S
z<Xi_3Qkkv6{9C!Gx=|RhJJ(ogwg*ZU=z<*+CbJ&;ltvyOcY4Tifbr)dq{gJ^&JlWd
z%Gz?5Q(iF!_V)EYx`9VaWS}@pQq}<5V;L`Jj9c#H>H3|lD{RQ+9{aVSKND^5vk6rB
zVH~z+1OpH(fY)k^FUKcYH#CZBVN=X&p*z)zO)gMiS88Tb&8GtdwnCF<J!JVTO*tgF
z(Z2xwve0=G*q1lB_Q=+P=C%NYKLXi!;3^dwr9sMzUmkb5Tuo)4I=}w0{tg&l!6*@M
z5(@6G^qbg6x1Ep!Xh(4BiQZkEIY?MGgm$ujShz(C?_a^SdBi(r72ygt2JG#1nM+)u
zK&@^=NgKrRK_BP|l60^eOx;Zc{~lJX&I|9B3jJv(nNfSAg5G}=9NufK+T0F{ualeY
zQ09>`lW?-~Ot}FN8vz>)J5IiMeAew3HddP<o@d!|m3P9^X(!y*K7%|nJ~3$q>@qOW
zQ`j?!$a4298Aisg0$EXV82MhuJ8+(gQLZtCd}~anBvHs^${A5_qL9)Dog9TRBS87+
zaul``QXn`43(L|OGt;zvFZWR^^wu`|;0Y*XSKL>O$?8?l_O<fA1A_W5n=Y(pJ^NC4
zi3zlaR&aphA`kLmH{{6&M>=75OWS*2?k$wfvX4<k+8Xcv+)kkcP|9Z|HtS@c;uU@0
zpCl_6Ns}!sbHv-Z%&#NN?z!T)>zDQ-QFQ`Vd&w>-1A-rs$ctT-uSwtiqSiF)uWahH
zlrP**2Leg}ecbmeBpkGWDn=&8D4iUQGCK<ocaN_og$CB~oKu1h`^_`MjbAV27dS4I
z?|q+rAW!TpiU#AiEvES0{X_Ch)v12<lv}cg*<Jqoj*<Cp`6N(M{-dIqSTn&KsV-<u
z8``99Bz2=&CCyfB!=qNsXxX0IJzP8{%e5}NLSgh$F{)%9SaRpJqwAgR#{jm(4<}1!
z^fLvn#B=@x+VZt%1D=+kKs*GOtKdLK2CVcBkuWevC5g$vip(L}!WzfBD{gGvDS02O
z^wftIbM)sN$804rRFPt27z!}5zeKVOuguQLLB?ug7%`+OWSbUW1W(xU$xQ-Z;>t>g
zNWsgC?sp~MjF=&?HG4~w#2aeclxKF0E1mW@)ay&<oy9*+8WzjHw)p$8+Vwt^+#5^>
zlqJXHkr1k|)>V?A;f{dUg~W{s1}DXiClg}nsctj5g!3xB5Qg7YGRx!A1e%6h$Ai}v
zb9|0qYhwP-540^|f>GbBti8Rx6R!)M78#csmxxQ(+i?Wr`z@xFNU%^a=8mR}`C^=z
zV|;S?CCA6wruE-oZ^tg`AwUtit%Em20acSs2%FWyR+0XP5Gh5|(CyDhuq(i_qtjQ&
zFi1Fa)j`T}C-D%4gm|3smF_Oe4ezBgN3IZ2DAXiCM$K8~VIeDsbePQ}e=OiGvYPs<
z?ikuN^EPu6U?oF2Iw6%MAx!v^lMpR5(3hSKqq5NYmgBE6D3kR5>rH!T@F47d*wG|Q
zleD&)-tR?`21QQ!%9QsKttK?X=Djh}QQwby^<zhF(?(ylFdDK*+k^PC!^tJj0qU?4
zjY74Np1kJk4|=8jkAL~!Oo*d0&zU*IW|6Jc0feA(NsGPXxb(E@pxkUe88=TSLf)La
zD6816MuSyHuWN?L>+g=n?qx5n%_rR+w_dDuE6u(mcuDB?^LGv8Pka(lOPTleH3W+H
zt^LJ{2aG)G$j*A3hUdYUlihuR5R03On)3-E-Enz%w;$IEmpatbj;9jj0(ty%uR{1W
zzaK1$NxR1YF6YlNZf1vH&~?pL8dkWwz4P;Gb4@V0clk*gsQ0(rs}7f9xci)AewwV~
z!4-g*>_~X#st-Vn366OqdaYJBvcZb|FRhHf#OEfDVEgajh3Ajl<FTCsu~sg!&le5*
z4;G3HyuuPS+(7%{J%*CbyD>QW)t!)pqupc2B`Hvjh>fxr@5L?eOg1viPggH(q5Eyy
zqmD1nYgy>ZVMv6w_gr4FD+|`&<1^e#bi$iM+H^!#yX=F(3H%qJK#FEpK-!E+@5ho0
z9Az5Vk>@_E>3KQWq!0ccJ&O-Ef1k_EYStd`<@)}qNUWJI)WMTl<7*KIgGUz>V)R+T
zaf$0^Nw4acFQYDHeCz-F@`o?bdzo5B1=qT&rpEc@BG<PKsrM`QhQ~iGUhY~Onf`PT
zM8m~=xn1oxI}f~ZB1OINLfpx1rLAGX>f*(TmUgJPpZS!>G<`BGFs^rmw<ZziT73&h
znsf2V&QY)YxrU(k`l0tc{i|mefHCRUpbo){ajw{j^3jSjeV-9{Sw-Ijv$94_kAme#
zSD_UL>W;x`!o;;WB{G}JsFKWh6iiG^K00hDSkBJRq<dTw7;^|3NFf~BEfPYeiUvF{
zrNj(~#E}e~^3v4$fUbXEyFIFjxvRm)6NA7$4zq}xOP4@kH{qUS^Ua~zH5$|>euJ1D
zEu4%3*$r0VoJi!uxq<tVROXYpT7weGkOnFYi-SvA0|<VSPvN0eN3eF{lZL1VBCwD{
zLr~+wM?6$Jd|sOj>)Hm1$Dlx|o?whCNLH}qyZ;{Nimd##((k$Fp87n_he7y-%jp>{
z)(0bC5X_T%PhDC~R;9Jn<OQbbsqxG8UdimusPDJx4SzdM-$n3=M8hxEqu#~H<8?0z
z0JJ_kirtA&1Gwn>{!kQjpMNBu{HFu3$Eoy0H(J&0UWN?x#R@0C<4paigB{cas({0-
zU{;NMFQ)d<)I;AqNH2M;@x~t+iY8-FSO>#c$N;YIW?s>J(0W7FMR~jpP4kYr4Luyy
z!5B4$M)P<S=z<2Ygy^i4k`(1mtTG|4xxd^Kk!>t;1i0-x7P$^Gbb^I70Y75x`T}<o
zP#_etA=xV%T<d!T;z`@?@5>Dc@h?N0t^Ks=nA}2p{s_{7{p1D^GRPOkxZ%O<tU^{D
zi%-^hhmsgEi<|ws->5~z`9@s0y;F;I$|mD*P@+%DmjLSnS4H=AV5@bUiqFa!fY_sv
zU1?#hDWwP<e^aA|U0hq4HT^~|-_#dz1dDvU03^JC52*)w`_vY|F3W!Xs5>siQ&OAY
zEUitwdS+Kp@zI({bM#Q1$If@hD`mObZ|7XG4X))sTqYeQH~D6hul*QJQ+)N?1LQ9v
zN`ifPRj|eAwS`vi(A@`4j|`^w^Vg(lD}nKl8nxeMQ`o=^fSUh$Mz$!u%~5#}xm7Du
zJYtd2vT+P6^0-TWL=OW*;FQAFAriW+<MI4!(kA@awu0{bf&ju>*A+j&Xa`h=hag~u
z0`S!xI{2*BX|lLW8@po8{euON5s112uGS3ksJB~0=Dj-5&3-@kdPMg;Z@kHruDww0
z^Y*_2q=yc+-cfl7w_A?}|B44ahSNA3`P){1WX?Y|<Q22wXHYzX?Kragj;Hs&0fF&3
zdM_KsV9q`LN$6(WGr_95DiDuWcURuUv1{6x+_0a(uF637i3-E21t3?kOO{*g*B78y
zYH$}R@u-<2SfkoED91|$e^*!GL(hyl5d98s6fF`E+rM?c;_8{<@lwsrnM3r*aff>a
zeFAB?E)H;W2h=+7S(P`$MjFLD$S9Dlb<<rl2tC_1F&4OawYreEMl7d~<*?rA>qJiN
z^iN>aL7|-dI$AdXwC4OMsXLHl9u3RsB+5L(qZ15yP0SK^GWm+`ce-M|@4GJNn(%0C
zvU3$c7r@0Dqjin+hOgMZDMMqYYR=u{UAYc>7-$FWMbNuT;x_BIh&NG0dEe#{GfHtl
zfGn9uHS^KEvH`vAzezCnVHjW8@U2UI#`-_dUHzjgx_p1v((~l+Uu)5o*^9$`?qS%<
z2g_arOLNqN+>1VKi=3BM#@m^%vw!#ubw77r@(K0rbwNwC$XL2qd|N3}bTznPWlAd{
zDU~FH0^o!LHC9WKzQxL1_R*0UhD<`qo?%!Td?x?7)q&#>l@|emwtmy7ujIhk^d~Gv
ze!ZV{1Usi%85D;C4XzEjitmE0;!Wbl65o04q7`^b6x>JLFRjJMn0;>1)X#c9V-d?Z
z$#qM=BH)LCk+!g@x4%_ca=H&yAYHzYGSPEDkljgIIokSdE0Wp2h>p%s+q||Wb0%~}
z%INM?Xwe73-tileD8CzxYkdBbs}m`Fg5j^H9Io?++GnJnA*6WHiiGzT_YEEOHir+1
zIo!FPhUb*S(QbCQuAu3KIb0#~_vnl1U40~yvZHsf?vhws^cq1Wn_kG5#(+ilsgnNb
zX!-5LN&7aWp|2NUq-L&RCXhanU+aV*JG0ysUp7`jsBi5|XA7di93)udUQr9;d>237
z7nY8|zD+;lGch6yXy*~T;NtFK+=i-%ENLxa4YBbu2bOexQkRvlMu)TL28x1>*tEZ(
zJ(C@UDSK(jSPA$gVp*63>E7IR_W}N8%;fEKEvM$94^dlAoy%OP9xE-v7dE=>$Vy3<
z+Oga(b1GiOA~V8cB^);d(&Vk{5}LO4SPM#~CN}Z_Qh5bvae>AN`s@rU+=R^jVfi-6
zs>V|1xE`@35sSj+CNB(pL8JGmUnjLcp8*gKZv6s^z1#t%W=H273EYkg)^Xn9`plVr
z?$e7kLjj}0D*2=^)z>G+^>b_MmVEoQkLN9P$&!@JtF1U-^4g7>QKt6+Cwpm|zcS9@
zzrFJ6H}LM8`mD~Xu#qJQPF^=hfW}{hl|dp<pqE3=K0tp6ZP^WL|Lq}WWr|Aa{7u`|
ziFwx!nHTK>dXMfLX{c<QVMl7G(}l%!aC=44K~zUjQmVmPbc{Gjhw8*phns<{>k4V9
zVY=ZD@Zpk8^NGkUG-nO|W<ud4mE!Hjl<DsJuQ+<3Ax>yGL7bPpYl{!a7AwMiA4r;*
zYrXrpwgv|&3M91yi_S0CHL}Czfhys1*SJVtznz8!m$uh)AahGYbvqzy3bk_~1%fOa
z?K_P^&EZaNPrWWDk(UNis+5dRe`h!I?V7w|I#5WhvTysbpKqmW3q@|Dz1A;G@JZ6+
zQ)BCZ)gH-vBYU$R8>oQ5PFc<aXZi=Hc(%|jtQGm^b$$ZF_L>WJ%MV#LzL&Iay3Ab%
zT+PsPxm15<3w_<613F5jQWieYK&%I$OX0MDk;&Jkl6fd~FkbR=XXA$`J8~xnYA-Fs
z)`0^+XwAw00`G*1o7($70wvFAvTUKfh+pXmP<F53ECS@Mw!ZqsYY)vLl=v^&=A*Ib
zq=0kc&GDR^|C8VKPqnp6?%^SCgRlc5>pa`&mW$ri(q8ESni%EMir!slsp~J`%&f~c
zdeL(JW)Xeuk+u9~?2sw7q<WY-j(D(7q0E}rw5Bpr^@0<yotU{1VMFo%;T8Zu#96Nv
zAa8ENa!SVK1AH*D4<1O!8rCGmsHXnDt|ikRK%h}xqx?e8bwHc4avSA;0)u(2pjVcY
zQ7<%oMszYwk57)PIE^uF)NrX*&40+A`afjnfx$Oszu4Qv=EG5Zuj|mLBu!L1RQq{e
zkw2XrkA-;(*F5m!-#V>YOe5j6l(F~g3&b7NpZ8&hGbM)GB#f59ZS5a}oSJij9DADg
zT-1Qc;1^46&)lrUv`|a9B0UWZ-H6AsVEpEV){4`BuBpL$O}9EGuSXP2zF@>_Yms#@
zXziSM6I}qkZ+j6&a=eX*OSJHrf+_o`+4o;w04B?N@zs;(<earIY3SaC#GZ?1>CwmZ
zf8F9M)Q9n{`{m0pHBgu&trzyvoSo?55RUy8MpD0zh`VgyGp(-d^TNKvm`?Dvdv-m^
z84Z%c<FapkhBm3Z`M)No8=KDEd8U)l1vxD$4EuL~tsWSECX7@p+SbmFu~B40*=(l}
z7mr{|acQq4xzT=KIZt8Y7FjRTMOBMI`6;P+dwhcKDAXlLT>x~kTa>m&f7;#O1*uS1
z(CXsYKi;SjMtXOvt^M?y%sCEJ=3fR4!*s?ZABQ(6BB+$(V|g=7Zzbh;0w_#p?Hqkz
zAMkQ^>=|ki?s~)aDi{NNZxSjH(M~Mun4*#?%>lpCSZrIO59`q=Kb@4%|F4?^!I<%1
zlEdv$5G3tz|8EJxv3E|#gh|~WPp|#IVt>H_D3&K()Bc>BkIi|-B?y?)ie2htTdat0
zK}6&K<ZX5Cxq0po0zgL@@1h;g_DofQ5hOvV>U6Zj=PSSKE7Jw3U8P$m`{n<m1e>dj
zCn9X!&#Yyn3C*I|9I*1cP5xqyJ@j|_q!q8>y)7yAWvS)X_LGFv%XC~xCDRKlAxdDs
zE?Gx&Vv*#@r~LJRjo#A;pnK*PfVTbRGSHtuQ{fRCQAUIiKhO))Mmg$#H<ix;qmlh^
zG_UJ%t3WiWjyG3loK9J2xj}jRNl(fo9XoNz$gM3*p{`d|9p58tAKS}(6XwQvr%hVZ
zH#XMX<CVXFwmOvzoxgyl{NHT^8Cyj77hDHu;&=CsaWv|&&RbeiDE4j60AIp;_=2VS
zAAf}-r0l;oe#lJg0Y<;lX&RyLR~%vdHp;Y<KZu!qB>mX#ggs5PFc!s`_<_m=AcO?W
z0%A~$VbLE|nM|Uejb{&)+~NLLGBLqoyuLQVw8b-gz5#jr>8lI6ddc*)p_fbS|J5e{
zPe_Cy8MX+V!4tP6y>e5i)!%?&g(H6u5&XRLWpShL|C<t|E-<id<*5F<O$t2XZXDF1
zS<Ius#_oT>8gE$X8{etB3;&yDC9j-4&2*&y?%$<a>3=hZnEc;#2<rEjr|99FNzd9Y
zt8msM*zC)<=bxWqJP{fsq&fX)lxR=8=59o<>oJcMaTyuOA?)PyZ5r%(@8N%K|EPJ$
z`bVz2Om(lEKh{cD%*%xurB^pJMFlF3TqW|Hc^2($_>6x;E+S~-(?j|W?U||;(;hJ(
z<x%sUJ}HzY3!mKAUs=&0%ciKU`7O!V;bc>tXlV8PeUCrD84&*<H__qP9`c#pl1mJ&
zS?Up~Eg<$*<2{-I5m!!jtJ!5kIcAEUq3h|L0b@WsR&WA#KX?bt-~kdtn{e_n&*d59
z$RMzhQO}qEAe><85659^BKHLI{}$RoM>cKGs|#>_)BFPME>00vVFeo*870vL=QjW`
zgl&e4p2Hd_7#Rr1*LA^oxIurY!2q{Mxp&a9-0YKo{V~qzhzj(GzQMg_!2&!?0jTxD
zS)hi_8+PNKd!FnspwJg}fj{UP4Imq@R(lOvI~nCDi*fu`aaFNi>&n+g(Xo}+L7WnN
zb!Y!5Muwr9PRvZX%&1@ot*eQ-V17{Z#dlfxh}-3qQ%gpW<Au!O`==O!*@~B*8jY{W
zX&Qa@#QH1&uK~4c&@99Ew<K+lo>FBwK{g$6csji?#$_6{>1hD2-5yCv^e>aWlXDwG
zzLrVA7$@~WSxhvIo_f+dZ7G8LwWM}v_bHj8KdVxKEuuYg=1%<HF8!3h&iUAoav4ml
zGcfrkfR69M#QWv5=vTe^X^riaiBFG)@^F^?#lZFi`g1s$M=NQl*2`2BjK}?+OtJ6l
zhOMmxl80TS(ok4B2_NH(Q|*m+X3BOZwUu`S2Z9AoMZ93F+((CZ@MwhxbGP4S;jr`1
zdt5O;0dwks8fh9m@^Vjnw_pugBc*W(@}=c2tFt}(B+vK-S-Fe;5|8rhv+Q}Q+Z?1|
zM3OUVy+v1P(I1tHp#D+m9YMBZSZ>>)D|vcCawr?Df2f?-zB@9Tk41nooH^D6>*4sA
z5*^c#@Nl~gv(#lWB*#YDVO->Buj{qBa3^MGcXIM~)ss~!XIHaDby!@^Z$qw)3pB?;
zC6<7$91QY@Sg`I-C(>F^&CTA;w$9Xv8X>k05)4V%mpvloVC`v#!@uE3GjE{@Q7SV_
z-%DiC{f7tN`v;6HR)7=}u2hYi!nLLAi7bt4U2kCvOH-}uONMVlk0F$FYR)n7N*?Sk
zfDmW%jy&)y2Ri<!2}e^B`xbf3{S@iTbE)%JTQRv)+TpM@-@+vbp$-zFe8?6Z_X?>~
z&ibILz=cxX0LE0JO<S)<084&sKi>0#17Bx1@(@yN&|@&86G*5(&a)I#N`&|i;-u8^
zMUTS{Z70$@&xfja^ALy<8MftL+k{_Qcmhf+Oln>GJX6~(WBn5#F`*J?P)vTx7+Bxu
zp{45FXN>OF@z|T#gTH5KMM8bGEnH9Q*z&cQbNSz><Ya$MPgR3FC)6_K4$!}h1m$*t
zF;`_?8Xx5t>KM)2r<pwzxTc?T!{#oJ*qLIkVc3~NbnL!$_I(fWRp1Ow6*#liF0TQc
zQAMd$2|nzcR9`*W&&d|m0>wX&V}X~x-WWPNG}3nVvrGNT%0Zig183J+*<xWexc23G
z4I_fOP(j-Dt6E&6u)vbM@>EUnqcHfjVoYS#{CP0mbZ#<Pg$YnnlRL2aMeXUUZ|9Ai
z2a#*?28!jIQ{cS3k&9xkrp7j&5_uyhuzCwMt^3JGl)F-Z-`~ajUA1*I<ne6ren(0)
z;I;)Xy_Pj2=x6}rj|l8>C<4nHetHn5_-SEqohdqRNX?Nx!KKf)i(Vvgl)9s}n;`?*
zN2!N`ReQCtas|vDXj5t8>mtn1R=Aze#NFo0$wRntE5(zZ@n5`MuOYF#RqnTI&4kP0
z^>PI1KaTDku`q0h!3F&`94BNnoyWf!lS#WNO=)_j*QeAEK-RvZV3P*K+pKCqvd-G=
zxMB%8yb?}z(G&OAa%3NU^888MZ0H&oLjf-dv7g>Sb3Dp3NN4=^+t3ZBy?WIe*3tV~
z(}*w~U>FK&bv<l>93nubs-*^JG1m*uZO%LFOYjh~<_hEF>9@X4&}G!07UhEUxa1;m
zGrXuK{4KqbSgLcvGM=R>n*r0R6_PzFhz=fc$h|on1X-$;FruY@1k*HW2V;z&GX6$4
ztJQf`AOrM~fA@^{wr8T7LUwfnr)$XVv6rZ%vi^_178ij9Th}U0xLmQ?QO#Gc99N=1
zO0SQB5*<*yo95H91%dh-=d~3mlNahs#F88tygt_I(PA#?5V_)$7<8ontO)U}_k_mP
zx}e&>)NBgG2VthM0k<nnS&Ju*Cq221GEt5$ck$0%N-M^m#AZ}<O!hV%!S1;z4PFLX
zYH%@{gPEi%X&ZE@Z|3cuX&Hna!9K2K@;*pF`B8z|F}4hJ!SN4OE;9&*jfBCqS5tFk
zyP$Xnct*9nSndI0wwL+6!MSKR$Hdq4A=6zGz4sLR%xy`*wb~wu;$ltuOzB9Gjz>w=
zy4&!kc5_Dp|Fvlwt$e}#v$UH_IA{SF^|Zg?b+X$wsN+pH)X10N>dLAM;y7JCJ4q97
zey!9^*dbIbsc+1UrAX<rL_tS>9#0Gjoe)mhMkl;Ua{9{wUJ?c{%NLY0lApIJF5_hO
zTLijw0o#U<IXR<QH2QX=T?ivd>pttmFUGt#SA}f%!N_~uPwV{9o+9!fQMrF{MgMMO
zaKqg3P}5PHf*k&Kch%DrrQ`11$ppgE$Ef4U{s2ps4Gz_RDd9YW$O@F>7Z4A<2CF%d
zu<EQ+j{()EqU&=)W?Vt*q9xmRj-M#r1seo@OVcn<-C6nxEI5^fz;f~znrURa3#Irb
zqLQrUN?;m`KvU45MpN$!60+`?H$dwccJ4{{dU$j~MCLe#ZTBR-=^Un#4{=C{z6P~;
zi8O}{rx}rEGt{0>{yFlhjlgjKXm?JZMmZ)9Wa&9Wd5{vNfBI9Zd?)mtvr&TN>-vIi
zQ;XbtTWE34jd|NrL-16<jW)&5JqPzo=d+}mB$pmn(3M%;kZ+IN`5$H8osw$fQK`Hf
zzxedY$GRlucW9$iYwZ@iyTD`(jvMufbV0!1OiLN!O$uCnD;n8FD>Xw-s6l%UTeD{&
zz72Go$_}MfqV4hVAxh#av?<a}fIc85G!Q?n-OvLY?LY44ve$X{fxbLr6Xw>s;(_H@
z1X3tBuX+5U{U%Be#sVmgNY>}x00tod0f^9;b=gH5t%+*1;o(zMo8$P-r}v+s)TN)P
z8ZmUq;|~WQG*4XKbXC^~6M%{(HvD`XpA-znr`SVscp)@W)6^Pj3;<B#_;TxH|44!f
zhcJ=()z*o7{&O7aw2cPmC9bs5C?}-N{9RsvSVh9lP#R0!rTC;h399->W1bTE9L42b
zYEKOzAQ(QX6c++%9lr3uhChS<4Nt@(4?*WDqJKvTFA~2Oh-h@!-0l3!&ia##<=6o6
z(4I;)ywraLnQ{Qz81oR+hGI~A0=Ve_u+-u(HCI>R?v$H<(zMiG-sOC>*AeTTTy#gq
zTA@RVAVH{2)-8L?auAj=SUn&4=?srnp~#0->y4Q&knFEH#NV$2mC5<&@RJg))irvq
znc(M;IT1+l)-4(!9KjBcU{A-zC(6wJB3eEp*E)7g;@3o%K0ViL`nB?tK09~C9yrRF
zhA6k_=(JrQ-{s%eC-2%_9oy^IvVcfAHu!y=+-ePLo*IHF?lE3e(f`R1pOlRnVHRG&
zMJH>L2M>Rg%+FUh=<cGa+%bE*#N*D+&Z?Z}D_PFSI`Z`f`XgtA#Web;<3;nQ<M6Xt
z8iV1){C8lTgSLjGd)g6(8*;4ie$*by3`bEI_N5VD)njNwPJleDbbXV5wUp%?C8n~G
z67H4sUCefGnluC>cBI{KV}q5W!x35=5gUlaEW1sRA&aj)9e*rDx_8hQexk)>bI~gE
zW#E$84!V*t<?zv*$LFen`&)KW4@HW7?X7v{UYM3H{1rcP9VWQgbJx~qGyG}UK^RcZ
zD4A?~w@Ut(e#41@ryM^2K?&)2V76R!4u_ZsrX4Ny95ncE>o0EM=>MM>AAN$7n*ui|
ztt}~PnPiydvS$x2NGU^yR&9Bi-}-T<t_W{DXR}-P1CIBxZBkO}3TLKIO`W6?hs+E1
z)3(qG&$R1zv@mE;00g;F7qT)eOq&g=JFHJj*irc{-H=iI^<wC^2c}N8?a-!Q=T?C6
zBM9cmY`p68h!f<UB%HJ5EbAdhMNUU3(f-vdZ~FycM$JGA;q2#dK75;I2=8pX;!0wG
zpQ87-pOaNc<3Rew`(^g0+!bcf7|a?_!i@+y8A0<7U&(lm>opag{W5D!-FMNOjgo1>
zrWjCJPu#?L-9u<a>AEsfUx#vUfRE%1D>hCp$Gw8Ag>8-pdhejWu^q4cOj+G-4*t<Q
zpQ85*{E!UY64jLNvLkc9uwn^2fA0|at+cXBKbsRrgBqRt;_~Rk^m7%Q!|dYf9FkU^
zw_P6YqUdxnJ%7%}eo9RIqxbRlbzLH$=srAS14pSN3>dK~G|7|pQWFF*;=kcODN%MR
z8|)wLjd@sAfhARa5-GzZSV(!r#C4vkBCfiOz@1UUVfV#~+%}EK17*IKy!s>N;mzKr
zz0b8BStcbVY@5iNUtT9~wtPGvndJ*9?$moxGh!m?9TsNrW7wxO|FFwj!`?jD0H+ck
zeyv!xR`nBCM11ev<5sS@ap8}UId$CXQX;!T&Pb<*q_1hu6_S9r{%F<5fCTJG(T5fu
zA2Kw>1nTOb9uPI0&_Z!rlWAUp+Hzzz(geZ7O@b@Hn0L$#IPc}ZIR$rH+DgVCuXLAQ
z_1|RJFlTeECP}!`hBBkN6&T~H?A0HXw9nQBsM4s-#m4n7auhXYBf7%i#AjXpyXI-M
z`}gjPmi~}Z%27CeMDSN5-AqdmG&-8#PKqv@`gJi>-A4bTJuTI%Z_a}Wu?mbyFa#Sx
ziqp#V3hX<y1qj5nsM|02dQ%=K`;8^Go)>x=VkH}MhCU(8uL_t`?s`<6;4a>&Em@<N
zG+uU3LyzKCW?alw|6(%mUa`GL{?WiE&P8d)X|^AT-R$FzY5J}vbe8)(VSO&AKu5xM
z_oxwZwJi*Ja_lS0*GU-<Fi5llKt>~@_^xm~7qg)6w~rzC&CvviJ@@Cmo*Zd%fHUcF
zPMq$MxRKVtX`p}9Tw6E=3--3_MPYZI6&^o9GUaXUnhOZr+p+{IKNNpmc;EUeGtcgD
zAZ@|iz~dZ*cBoY@bR&{bM6?&42aQG!(8v11Kk6p$<w-xx!69gZvOe>`%~!eCiRx!5
zVKlXS^xb0T=OR7i+k5t4)=`%(KhEu}4OX;_iz-wBa1iZdb1-2>eYzWF5pM+<fl*XL
z6?crzug#oWl4|WTKSWGipYDQusJkThmY6X%^-x){v1ngIqE+j5*P$5;EXe@s*Ke$|
z#JAbXz9givAkh4IChH_=dS<3%;_UCp_PCL4@vltU-0`pGafePhp2pD4F=^`nZaK^?
zr>9W<YR$<-VAmzTTj;q3z#%?{R@BzBS9UT&JF;e7j`ouw6+C_^T4tYorBNL(=BQ?y
zj5EK>8M0(2j0_+1kV${nIlCxgi@JnJsS0@oHhM{d(WWdMmoZCK{P@VN&U{3P=!;HW
zBE0_qMMv&S2poB4%A1~8YUNe!%y4}dT|ylX$iy|2(%!V4d<gjFaI~$qY#m!6Z2J2f
zeci&K{X0WAx9yx?KH?%6POjZ^DaRz2r*a!Qb+okmEAI#QQeyFLr+Bo$<Z&s08>rw_
zQZzwlDPXT+B6<dpJV@bJS_<uXogbf^9nAWdZ_4CD_TopfPxDL!YBySkpl2URn`!mI
z!T3+J-wr^uhA}Ak+sd6%NabWp9=dY#?Ddpr)yMI5>p=fHr|l!0D(hd<$hi;4f(Sl<
zN3NmDAqr0MwkO@UU)?!8+^J$~6~0S{aI1t*^(MHCEei8x6z-XV<IP}MG$YfzUl=D$
zt|o`m)wxk;>BZ2ix|;=Eimj7kn{zH9NWh9`9Fh*OAMq%^*$C6fE@gvhx3sNqMYrAS
z#ulBheJU)LLY}-rU>$@>-slhRn-X1`WdD`nfU4s+<eP-d%@6r7BED3+%V}F21xAtV
zjm0HZfwntQfd&C0BBEow4rS55xdRHM=d?n8>RR7F-z=^*{`g{Rj3FmLw906t-*E)*
zVYKR08%m7#gm*#49CaT|sMUDNV}hlT?bpZGFY(6vS<niL?d}7`-rekHqUZBNIvVFd
z(f;+Tft^b~Xq%Ly?oIFIo)bGufgO1%$g099EX>1W!EGJb1>df=8e}fa$XNM3GduqF
z*9mNgNNx?KKSDJM+1fPKslni1#G*+{?{(#sYc)&~=n%1KTC1eg0lMq;mE3zNu?eej
z(KQUF;c$9z9Qv%i(9x&DEvAK%bAINT2oBLo$+0pv{y7u0x@-Dly|p(2lY-ew!2&dO
zL+JJW=scT=c=}ToGh58lTzAZ#L~EAnDP^UP+#3oh#<7F-(0A`iz_=<(K){KIMkRfp
zt4oJ2Vv2!igZe(@q)=}YQsc{FY*6_3%RD7l7@MrR%xVtnZ;W~O^U&xQ<-yB$_LL*O
z@wkmcWpFE~o#t|kgF2(@l0)0x;>@mo?afGoFmvy4TDv?;eMxoeA@1^s=OfbXD{!I0
zI8%$Z-df7S4=9H^@5bYbu1gay(N5w&9*|&~7dJUmLeu7pOkPaZDdkBks!ss&eR-Gx
zU6JA=Jzo+u%H)6*hyw^*8+e1B3a{Z0Dx;b9A1SS|M>Vyq^FG(SM_ZzL#SHUwaaNVQ
z7PKVae}{iDBKUjIdBc;P@p&t2jXho>)EVt4=>Oq5ukO6s!EEtby0?#r*VVPjLpl7<
z-vx8#fsF*COS}L=ad<0)`dpJ^^5$<Q&+zhraO-w%6j^1QmS@^PbFoZB;?fyGwoxbU
z-YHR@lW)!E#;s1n!?2SL<%j~Bfe<*Ydxi|VmQWw#;n)FIcyZ>3rV02}_sWD!jjsMN
zteL0F00R<gHbk7=-b+}`XtDKoFF@a%)YCaI+oB@@Ip^d3vU8AaC#2n#xS;p<5XU(R
z3qZ=XvW||h`z>81eo+Gv^KQ`gf3N^e6Pq8Pobydy-i$nMhh@88_J?^&hKY@Kk8SJ9
z&}82FJk2kWiuK+Lmt#!W+iT&U;(T)LMy`ZTUHq`wdb`_sx*_q_rYp8c^Qw9Nd9ip$
z&7*{M#rjm7D^?OQcKuHWm=Fe%zeC>&bU*(w4$Glkk#<jYSwOE6JvM>uv^#CMl-$A(
z8#F8ikcZYKzwT$GZHa^(dYJV;9l|()F~!+I%0qINLXX;iB&+b7e{^z8)&A^O%vkuj
z%+VmzE3W|_M<m0#XA%!X_m*abjpL`of}G1)0b03|KLopB6tC2|i(FmL^)n98zYllN
zd!qHqq(bN4FO)Xe&oqB3%b@qytGwR0t#c$8@BWZt$<$hFc}L+JJRO?*=<v3H40UYg
zW?^K}+hTs%D+NuT;VbbIkhc#i#u|7Cdfk4@6=OOsF6DikU_;zQE-erJLM~2;VH>qi
zB9>+$K%u-f`^rg`Xk_E0laiIQ;`d8Ul2zA5;O}%51HblISR>wrQ$UR_mQJ9+55cz~
zm~NA~qU%#`Yq6})B=fOgjD|SwStuCKPATCdnz$JK&t(LAi_4uo7g!rJwup2$8dB|3
zY@oTxf-%8%8Hgrbdjpc!VV;0r)xVtk(;w$<`UU+}hvJ-Tciw{{z03P9eiAbT(qZ#Q
z4SL;U4)DGRsy@~8?W@TI%w%YOY_wp=u=G=Fg~R^+FMSpnrp_{B0eRFTbyqBJ2*ayv
zk@vK9%4hR2W`GtYyN7)TUSPMuajC1Fm`q^z0Fe}<soZl%Fmb~7Le7jGWX}tT^QIw3
z68J=GE>qQP@%j}>OS-ibY8tmEBrdBfs99S+Wl5-;^QxwIlsT74u$|`OqO>O5B{kC_
zfv___ID?XGak_s!ptVEq^$87BG&4ZIq1S+PpDsWbE(gPvH1jXKryjWpOVh;-wtJAi
z!hP}PI7hU<)=k+(|CZL_InPaRdHj<FCVBg%9^DmBB1>u0kdjh8VKnRO-o^}>S>&m}
z5KLRY>jV}McR?(*ein_|dq6o*mBZK1JX_#kr#rBMeZ$(}bo3RHig}=C7lpk2oMREt
z<fEh)>TTs#V6U5izGG-ik#}498{<E8soEQR_#KkzAs+Wdw{x=}+I<V4rT@5&9c`~(
zB>K?oT5N}*LmZSY?n35f&}2s6y4|)dKucmsjcoKO)4H!Q9)%4ti{T~(M%FVIjDH96
zE+$sf?dwoO7nc{H<<FHCHdFjNf50I|ik4rPhvo>w<wzwN03{u`1Op0X!W_|jViz&J
z=Phe52^lI<;wnbQLl0@uK@;7AyUwmCqf5#|@fP2@VVHE!vPFA*Q}(MMqr$_rM*1Q(
z>!OUcvEUmEVAd9Te)`(Bc(}MF=+Z@5=F7f73?IZz=$(~#$t23%3YJw<fq7DXEHHPJ
ztLIEUMy^R1a@-nG*$C-Shaf;<wRU&LasEi!h`3?+*KDr5PW>Id+)6VyP%v7^IlUJ;
znPx9OayC=u^1*74%0ljA3jOI}1StN49Fote6u4ems?eiCSsQLTbZZ{Z5z4A<rQ`XW
zL>qN721X50qJ2xqX#+VtEAA9C9k)W7%6naC1!{!}H`E{<AC_0z*{_S2!3x7Jz{Bwt
ztf<!1h&w=^gIPa!$qI~PI9%3BB=Y-%3Q*vE2|b0?F8{9e<&RHm0xWQ|tt5J^<cd65
z4Q8N&<7Q7_lY|(eM>9?8MjM4RZbQwLnDap8J>$-ykygfSRDw-u)Skr9!kkfKo6Xcj
z<-7S5Qf;_V7Y!Tp2U2_xoCnB!mz~L`iwt`!$3v2QvI2Cv1HrJd{Sth<N(vT`);=$$
zUvxkkmliM`e*AO*YIMlrMWoCfL5;LF#607?6<_8C99|@pef^q)3-7Lip95$`NDk$3
zjQ2wI<gFO%S+=P~n|5Jun*wj3r>EN98U38Mq5N@-%6~b=NJ@8doWG}njG7sk$HSxh
zWa56sP)-?9Qqpb2ak{>v#S74Nz~AMQNYyDD8d7s<eK!*njBd$GXDVw|6pZ<zl|POS
z7~h|0k1UnvfwMmdBe4@8b&iEzW$3dtGHLorYW@Z^uVxKXTjq$b{BQm=etut|m}&);
z1p57AZ5MxhWi6)?HK#H2o%i-F?lq__<sD5wd+z4c-mdJ3@cs=id^{gbggJP5_CcZ~
z@RF}_obrqAL<DGGgQoQt2P0f|x*(@6Ps-OlF-if9f9Y0(z-Cn|B!2gY*&ko@$=j+`
z6#;0S$ybhZUCr`TN&X~h<VqVZgy^iLH8d-N#Y1n)sg-x;bne(tUrAE(!Qh+Y?66{V
zQkBD75q8B8ON((A&$dF1oOK4<Az5d`L_Kk>{I?C_Er-sYZKQ(Ge!YN3Bl{XrU#$xu
ze;eXwchK>7Ytu)*xbS+X=67hhzo{Sogvtz(wr@FO4y4&p%AxIxQ-|X&3o8(CIGJ>E
zLP`uv|FMu_zq_)MgWGtpKQLE?bNqT>gPIHXn(eNRUm>j^7e6wSb+*?VNxK6`J^(J9
zO0Ryz^Co^jG<4qHoodQOA;Y`4Xk_~hmXo8MVCwWyOE9u`Z`ehN`Af<GZg0@(q;zeH
zbI$AJfP^G3f9VV(%N&tbYQHVV^{VVoTzv97cdG4ITZ3fW<MOcM7T>SMuY1$8-;?Un
zG`n3&kVRlCy5oS$3WtjYp(<aloA1yIcU;@{!TFp)nEo#5cM?=)Wc0mEM=|;rLMBVD
zA@Jl9U&yc)@zF!<1K%xts^41tmEfd`o8A?(ev`wpLN{965{})?dy*3Ko}1a0{(tO!
zcRbba`#&P9WXlmp&XKJWGP1&P4p}E7vt^HzJ&S~l<2c7CGjYTrN=7oWl8CZ}Xc^ff
zTjh7Zj^5wz`!j!!$M5goU-fXGdtK|k?(2Hq*Q;B{hp*T9s_3b6;<IR}=GS&Ir-e6W
zPuI*}l<m2BJ>Z^9Sn)N?&&;i>LAmvT*kaoxC8Z<0WfMtwWPRT=xA#j`=LZC;%gp;p
zuU;)YnlH^CV0uE}%!HfKzUC3+;nh3V$l+0OuWq!W@u?Nk7Ju=%POEE>+|234d;P7~
zFIvTwC_JgrFe!fat0mY@-lOBkFpJvp^p{*0-(9v}UiW;N1LAkW3LteaqO7~NALp%U
z__^x`ZAllJ=Vrb*&U-Z^<TC$M%*Dq9nNA(0!R^~~0J(z}l)e_33ZMSktQ$fFoBnxk
zr$*QSK(2|}K{#zh9iO8wNkfniH@-cx2?ClEb-N|URr9u&30Ruc06B-7qz=RMMMe;$
z3;qS7hoP+xxey7_sF<k)@AcvslrFWDDwc`Wi`>+KPkKxCQWk?vM_v>Mwr)wG{0gm1
zH`;dr?)NF*i8L|<!BI}+!yLY47-W2N1|$B&ws=`B;w+NaI(rWaDsa*`GFA<uH+FZX
zKorRHryM5GC747a#hAqhlgd7MaeffK^kCcA%(VQ|!k2~QQkJlCM!Rf+%%(N~sPM}`
z@R=XvuwYVoJy*z+L%8vvJ1<_YGJufsCEoY9GT$58SvmsTPORO)S^_?)DXL1>^!rrw
zT+PXekSM%KUP*d$MGgTQx)1>+uPuj3KB`dkxjDIz22RF)nY`j5WMqtc^%LEy*0qUl
zJ=b0ukujhCa$k|(Q*%|~8RvL9ngs?E6U0fip6(}Vzy%^cbG!7obCid4PwpEcfY(gA
zosn7=%XFdcuxkxqOYAWvH<68syrrWhST5Tw097z0&rV)1b|P_R2R$S#5m@qcEXF|e
zzR9r)YYN~T;vcQ&^l8N@F?VjNKT9aB{A&pydDK7KkZOBF8_FZ;)c@W@>!918g=Ng2
zt3UPj7D(Bzv?fTriJ<~{!5-T<kYqC9#(4J`tPrr9tmb5<C&3_bUD)U2Rb>WN*;NOn
zWpsvfk$i7Jmgkf;SsaA*xvojCAEN=;zi|Zr?(amrcL(W+)f=7aY2~MZ^g$B<Q({ub
zk}=J7>&9=1rOo=qckgf9I$DOQ-a;=NUs_Jw@d`F%IyvW)$laNnu`_1&^wej>M0aO<
zut6|MMh9Q%sQ0;OXK|<IIR2fX=h5;cxt`n~%s+2#tm)hkTwjnL&vd>qmBHjk<5_uX
z{?de6syT#{oLEeVcuBJX-lul`QWQ9Dm+=hcxv+fZCR~Z93?F^;D}w8su<7;3^R4%o
z)mAt^9W|0z<Z#1V**cvMqE{-i7halr`|0Ax-yRB{R`un(QxU5o)02n_evY3zZy!9|
zQPAhml&r$9PCfAGw|wo_Uv2whc*l^Ev1RPD`YqXN-pb986x(1^cYR)eNQdd{p!o*@
zU+V`#TXLKqb+(s><O*~8cO`d|SR~diF73mal-r_%1gXMi84mm!L=T3&_*}4_>4o#w
zaAjIRm>M9sl%sy%j!&)yFiuaiB!E3(($A&=Z`Oa$*F^mALaJ&shLCm&ok_P_5jX0q
zNrJFxcFUv)@UwH-cVS|q!N`rJQ$W5x3oQ|(Lz6X(gGmPjy_g`tgaN~e0bgbC%4ht*
zGJ#ko?v4p2^+d);YEsec(1IsjdCF1azt^h$b->Jp$-QW5RqV=`1_tWd0t#4o2b~$#
zTp<v#k264uP0V>P`v@pV64t~fnu9l~4n{7x>V147kq_jSed8b#1c4ESL7*ALSukEC
z7;h8Zrc5skm1p6M13(*6&jjMd1I?A&w#^~#JPqyH0A|jsKFJBaEzbbOI;#04ppKxI
zMRFx_qas<}TlNSI>jx1d3aaSWVViXp__T~|iQYHFi(}`0LH(>jt%K@J$&CtO$GiBX
z3{z*luZX|*BYSV5KMq!YBCGnFE8<>-xWiZX`vUj}tEfD*)NkRS)8z?Sb}+!=5s3JL
zMki<}Agt=V#00!IbKNRl7%ukDFe2S|tZ*^KqMj5aoLv4e_X|K&sP2J}=3Bo%0}$VP
z%bqqcc$?hinJ6&k=NJeYWCxgV>XnY}yTWqeWr8lB5{!kKVU7b(6CmGi#z_Z7;k|i}
z59TcstT`Utgt$-w$_R`aaD%Bd0TUnVTCxBC>Ha@4|1YA_JhO@Z(j@sqxdy9eKpuxg
zO+Y>E5H-UqNaqQ7PMxVV^I(!|fuh3X#I>>miwlu{=jo?J9g>|$S6)Y$0qx-709ti;
zsGAx(P{u}$z?;$gEZT=tcgH6dCTxz4fxue;4_2Ci##DGuH?0B@07|^tbH<DhlM|nG
zwz?<*$C*v&nM3sfSlKw53P3eCfnxKTz0r|D5q*i{h7oQ^S?tRDeZW41UHPK~QXv4u
z${k1+sA)s9BgjfaXlj^Pzpa)%z+uHhn7=4Iq_4>UVu-@#JtK6X+tgSnCez>#EYBMj
zOal1eAU8Lp>GUJ{qi9uZ_2}JUV75L&x)d(}bg5Z)3*Bhqh%lXfBtOmUL>h-P=mP5%
zaqQ1tst-VW!K%v36AP1YcTl=7IE?uLA`lK)jG=D`VaE$na7-L>o-)NWGuW3J>mS3t
z2M+Y+rK}?4@kwH#J>nsuXF<D<9?(G>qQeS>4jq6F*p~l719(v!DP{=mMCuD-;{wZ5
zge)EZ8OTDK{vad~Oyu|&aY;Xa03@J#_J=*zdh0y^ei4M`erfU!brzBLDYk$OAQPh?
z^YalhKOJK_X|j_)0^)ZU{U&|}$Y+Df5n{>XAc3lmJqY%A`Y#Bj1c=jpuSgF#9$w4$
z^y5BaBcCjGe}W<%_zfLI2Qi2a_g~;;JFOm$-}<ewvP3%1j!R<EaS5ZM_55S9t*Yr%
zdjwQuu^hPaL4-dA>~|9MepN6gbr-)XotDd=x`R&q8In<J6^c@tiF5-d9lE7aP?_uz
z3z=s((LtA%z!9^qMC(BTGm3-)5$IPIZhm?`$kCi7z1jA3RM|0A`$<)H7$8WMAC?us
z0Qbx>0Kg54q-`h%lj?v|*o6+_zkM1yHHbjIff?omy0PA@1v)y{>nyQA=)o(H@o!JT
zCmr@ZMh99?d;{$J$GJ_#bfGj5Ban>YMYdW9>6maII^G_y5L})ts=Aje8=QOU1oalW
z4VW<R!!QPHIV;*AyImD473ep4-`I}T_jP(+CWFhZwd*Ax{riLJ(VsFF!`T<%MH`<H
z^ZSJ0jJWbo2!9|n>VhXBo{%RIa@C7t_dmsFjeX;ECE1o+C@m(Bj{Ih=TT~x<bRcJI
z>}ZgO!({Lx%sME-@MWXUaPw^dc^{r-tpywrOvnfY4wLI@N!3<^PFk@qE2=E>^psit
zml|QW^Dc|>==cnaeY2yw@8%l-&F(<!-e4GmPD(WJGgPsKTWGiw$@k0v_reAJhXV?w
zc#`6R6KRyVtTE~1hgWSkA(=I&b?Zmzm!|7GTa9F)hRI$v)i%BK0>8joH2;wj4PJ2a
zNh|HLAxVF$q5}_pSHo!&qas?ahLC=X#+Y5ryvC{e=7PBw`yETf+Mu3|XD%TS>p5zA
z+i|InS35Vm@@DFr${QE>P~A>K%7HVSzCYCaErJN*=HDz?PYe5BFtp#fQcKiaEf}Fx
z>8f@c1#kZynJbGDH8?vh3&)iKbWQcJY|lfK%WQn5q1dS3#)F<>JTMbLNwuKu#%!Sz
zmn8%F4uuEGGJ^-qziAD-Gwt00Fd)ZbBagQ;iBJ}Y8vSA!Igo^M(K?m;=n4+WXS*Hl
zBu1xGHni=|TAtfoIFzaVt-E@MWWd&eXd5z1*BLeLOClcXo_+gPbY}mJ^S3V})v&QX
z<-sqkw8fXv;^{u0a*|yd2XuxNM|>+PZJ%#nHC?O$YZZWbR&K~)Yt-fzsXdqW<Ho7P
zO@T=WU|ssC!$hOpAjdtw0uwt$=4+9UTPHl~J~yPIXM8e;gvvSZ@(iFEW+WsCG)07_
zHOu7Sm{-Tsc=b(VlaQ8o8IeKz3%4V&D$gubWZk)=FZUTM6;)cky*R>IOt7s`N^`j^
z8@u0gxb)hfWMPr;0pE9(Wy4(&9bK7y{#O83qrhwXA_DiXFQYcM9vE#ecA=+F<)MJc
z@<3{2J&x!H#X)>SeMM)3krJs&x(uV*AvHmq`ls2&2GDg*1?%gkM~9vaw4A^mpS01N
zzW1U>)qP$tIzrYws9z>Viw?x>)8sRgWM@Y*!^mS}gJ#b?)`olyKE`ILvZH5AHqkLn
z4jKq|K$%-2>_B6tk35DnZS%gmX)uzFk5C!rd)*0+89DpxhH$Ryay6*-C06rBazMvL
zJ2y{KfBEjYmqeMk{e^D?vHKHKbPn1}4s{;4^o&>=XdazYN9em%`|EL?X8g*b;@TjY
zR+Ps*m*MUxm!#2{@}_u$Czuo>Z|g*AtUc*wTlZa6ynR%ZbQGA9D2gd*sG+#n_wnT?
zJyt_MP}61N`^vrcb>y75JDBViaMvS{`3ihm7^VVBYDD(Ug?RWz=H(ZoK*fyT7A|7A
z^26Gol#x$1A+WpX+PRAd+go7HV(Ic*Xl2I{i-S#3KIJaouYTGJ$CuMj+ThBqS)|SR
zivu>6vN_UOVn1x`8x84u;Kx*36L92?SKX<tHs6_^OyiY=r06^N@<C;aDgLZUle|pG
z%IQAF*2Z3{O4P+NHKAo9vrObGZi+m!&z2OZa|<T<hrct&);zw<>53fk_yJ02kjb5-
z#xPXc{cZ)`c-NLkCUb~XuNZu};>f$gxdS^z$<K<%EP%moti4wzMJTb6BqB%ZD-o)F
zGtv6=!e5{Na&KPv>dtuap3JMFm}6=~*IIgblg|>hAv5thOb+sU;T%=7ZF4Fu+fTAw
zRC{{tSUPhr?-*Hq4<^xP+DZ*i>gRd6+6eKg<q(F;3LHIeJx0a&;ApnNvoO;OL7+yM
zZV=s9qkfYWg25H=&hN6Fcl<lMm=IDaC%_miJ7u_ysFW7YNpHVFH|b#G<lic*5-XQ&
zeUr6_YdBPZYsF*U@*(ea|Dt-+w*v3D$BqlCXzrlf3@d|vHi(jn@g|9fYTxdv-E5zc
zu;*|vgN#O%U|0WcrOEDV$qt!wrU)P5=;~vqxQksIV+B43TC}G24bxeEe^?a#(eT(t
zw)To>#na<MBQ9C<f#sG?<7SBH6U5-T?13jO1Mhj^7zm$pVN8!COLUHTv2pA1f<1GM
zi~9Rxr}ceww@`?AAcH>AGiXm@`GC?WKcMuB+FZh`m(1ZCXCB#vmDZ1W+%J`9Yg*2>
zs&%ga9PQWBXj|>@qOXA+M+zZ1d`+Csy5&5F*b03cW2U>U3HR_>OKahY*;aoB>CSaj
zcCm-t@d0@5Ic)WK^tg+T=hcvl*Ye?F`zEj7L?(Ag`6X8LZE3xI(-EIzRbGJzP#;Fe
z$YC9ik+rcV<L_SU5T6yc>%UuvkRq0HjuI*Z4ry0pvF@D3b~p9p97BueE<Kj|pg7{~
z^|hq@QeEn2Oy-UgbV97eqbzCHqLD@Oy3u+A6VG1+k-OM%s{=>A?@B8si`SH^_T;su
zu7r<;cWYP*jgHn;{jR#T)w;&(_ABJ%zy*j6>YoE?)@laLx<ZUy96d!~<kN9B_n#K=
z=e=uQS!-0)ELIKXKTUGdi=){Z>5o>kDSj{>QY?3q|9R4#Q#&mTJ#rmuA4f7vp5^qx
zYXUs;-yuzXd3<cnp4N^NFm+Xc*W;!v!&BRbZJe!_attLUY8+z?C1swd-Q=I46}K6G
z1qT*EG+&N*_|%~sFU!H`c!%>jpe#~!Q5Q_?#&q579_w$2d3XJ72i7|%VT+xDdPC7)
zernIs9BblHx@v)xmnscc!Aq5(MwMd1q{b%ll)g_~$Klm)BmJ*`yzD$R^R6N^Fwm(l
z-zRnWqvYhvXHh9{`fQ6nVbi}^b#DK#2f@ztRa^P}=bxV>pWeon<jK#wA{FyHKc>i?
z{}m0h-C4sdmWaWe7hhJEx_tCkC66FXzpWcSs(cl@qEw;#Oci_UP(t|W)Xt+8gQrpy
zt7r=M>XyR66TNwzwQ`gT{hGu1JMnBH;U_K});OAO+X0Gt5ZNrt4)f{sp$vWBUMjMH
z>C0*44)?i5Y5>>+YMK4hYNYwBexbgLZ*B+<`JCZRx62Sib}lS!_?L+pX^rqTacyE<
zY5vmwhZRjMh7N`Dw<bg_w1mGPoIyEB;JHwR6@t2W!?8axIHabmr)%ng`@DXrHlD;Z
zWNx-lmYu~+NRIw6&P?y%?KG?IIKdfxtpifW5~GI?yCMUMG0t083lF1HU%!nt87<jJ
zQuKLDi2H(swTV7$hMDXOZ?hIShv<}%su1D8Ay4!4@yVp{&9n*Q4IY&owFMY%adJ^_
z<qo#Emk!=0W-AWe=BdIYAbNx=lL=av?y3@$nMY7MXcuB7UaRE0ip=dtbq|(J^m4-j
zQyxh3G7A|WzoCk)#blZ}XXf1{<<-8PHoys*co;e(>jKgfLM}9`lL$(?*gjA!haA5B
z?DE4iCz3Db%OA-+=N@+tlpsnT@BIm)Z)DZxz4F5tXmWy59zpAfv;9$~W>J3L%^n!q
zfi__}KdJKmoFVs%ryf@|ye$!_H=ev~qdTqicqkZmzPUvwZDTEG^*+p1d4=G{{-RjJ
z;7a6jmR;XMgANn7l80^y=}}scw@k%J+e%nl0g^m6e;YrZa=ZeBi-1Gz1MXkzFEV@3
zrA=%>Z|){c_I=P<GkSE;)J01s$*nSh4VL4vsv8`-Dc`C}%)Ex_5H)Q<zGJ|z;rcG~
z2)kBpq2E@89(bHuHU!gZ8p<zk*+MTj*xo7w?@V=PzuP?$`r&7e5KAUSvSdmRIfLMm
z7Yt1y_jTp43eQlvzpw!7nXm(5?ZENii3SK-0kuf2$#i*JgNv>LH|zyw0)OiF^^X12
zA-*kMLp>&F*{9Ox)deFFn8(}G7PHR0_{8W83-8sOJ3|<Fo4CA{W^0zWNbyM4#k3;S
zupL`nuFNaIdcR?{9hfsdKK=CGN;ouJK)?+`<*sM`OyjZ#<_iCc5oafS*Z44MMsm%@
zVI_74$wK(pd>o^NI#ahU;_l^<&V8g5r8JGOi1=Z*a3N91<(&SgisMH?5FfXtt_T=m
zP}~?(w=8pZb!wf)&I~+%spQnEBco^lIw_?}yYKoxhORw9%8QU?<BSJI6IT*G-ZHS2
zPbP}U634GT&v!9?o}X$x_h<kS!YgoUS~Kt(72&W{9=@-vGd_g$t+bLKN1{!!v)-_^
zOzafXLZo7-%e{?ZZEv1xQiIB*b0egr#YaA~iK~Y~NV$m?0i=s(20+k`9E>iY1uPF$
z2BxTOh+6|O|KjGuZYi0Ot_#nIueu2NNur-nLFzK3N`Irt_g^kp(ZHQ0%W_<$eP#vt
zU6Ba8l*JvioP-aHy~(Z-f<LoEpkQz0Hnl)Xj4go~Tmr{GFlQ4|G)|a$T`XdJ+A`tn
z%zsp^QYzKoYQZ^Ctcu?ARywylc$tk%BK`V)1=L>B*+Lt>KAN^4w_IzEckETI-MFZ0
z@oCzK$~~Ag{o0=>6x4j<7Y@blo^R>zEi-Dl(|Q$m2cPsaSBDbPd;vm?y76^XFmipJ
zNU>ObDSs}~rIA#Wn4l%)lfTYV*4eAe5<>EVVcypl7Z(&?7}_A%*<K5B;N2eKP)`RA
zr9&l?*ve%9_s9-UbT=$YC!SGvPU?_$1lVqzzcD?q4AfCTONh-<p(vMDzX~z_qZrL&
zI~ERyXHv(Jsb|D|?|qHSz5#An#GSD?ry-JY>vSI<4?4?Z<%I3aYrOypNQ~Q@w!X$&
zIl`l!4jV_JP|;e$_l$pmdL&99YM~=ibQh#5bboi}A|X3u4PqL?ty%RbB6x>D#&4IZ
zvpK#IM|8`SUMKc%sb`r;u!CZ*?qaDQ{lb-nJ-?nT+mw4LQGC3$K-gNg!^?n0mdNnH
z((goy^7oFUb0cYAVMsagg5&hxY(=#JDSid*?rfVV?@jtFY>M*s(ioT@Vf?w@Figh1
z%@kQS_Ny;i^=BDV<$BUiwSTZUj5|v1(r`CsZfXujrj{E^>AJNHi{9*K(pk{u^G@0(
z2p@2<>^kB^5;0bHA&*vU&~?4maS`9q<(Za_4@Q2wNfsFqhff28@N4o(+$;MUyVKAk
z7I!;EK4{0W(Cj)XV8=B-J5@GN>gX%wr2%%Kouav?jgK88)C?VIUl7cQTfA+=bEtW9
z|1DwSS-BV3TCtn%x--w)j}xQCwP6RdB6FTRnz_W=Il@xgwsShQ*NRtLX3X(iPBToa
zak^KJ@a`tta<)7SV;<-&<J087d;tNTA?|)RW`|+~(h!fYzQ2e#nB^->yf42zl7FEQ
z9qpff=Gy#%0k2$TpP+QE?}4>+|MNc!y$MGIulkkR2%ps%e6Dz2(su0J=rUoss959P
zvwXZ?%af79)#2#GmZ=1Dyc|2wal8N}Vm^MB3WTcGf6Dd5`(J+{zF;g_J~ME~)2|wD
zI9d9yGGHr=vxB2+4t#U$SK`3r5L6XXTLH98Y)c1Egd!fEM?u)+NRYiOQQ=6%?@>?1
zIlcDhTqoYi_Oy!p_;<UrMx^paW{?v%Bo=1VhwWl=Z%P@Q3#?x%4*Hr%-lC143DgzH
z^49gdXr*+73<*XkJwz7zlU_Kxg*mmJgS>7R)<xzmgSx9@e-N#+db1vHcz(5$sn@8~
z^MzJ6^2Sph^7Wxuqi+1;v#>VZ9P`0_?v8oplNjY8XHv&;sQ|-#NY1GlL?KJGLk*jL
zOv2QuPo5Q0{#VWB$0b$MDp@^jz3QI&wtieCld^HaY)D5I>77Vr#A9nTsmzSP^6Ult
zSeHO;VC)K2E&+Q_-BDuo0>b{Lb6b!Sh5qX5Al{}scBl*OD6Bt2cSgV!@z2y$hKczw
zdRI1ebf(O`9+s&u|BrJ<&w-+Z|HN8fS?mn^cee-ue1*OAE^)&fia`Q0g2YQwEj*j>
zPB*QO*-jb>h<Zy<6e>L5-~~}(UmQx;h9<MP>nbj3D^GZFnqpC@s6lK|EI>^ik(n$@
z=2`N8jDz;6LK*Z;1lXr1sGi;@+%?2>>a^7}KG(NDd;XfUKp|`_SatF3?t<mE&zL9`
z{^_8Uy2O|}%|DWRbwLEjPm!f#C-}$OWRi9}T#rw!fA8I3`c)J5_eF7i;V|HX*p?LD
z5DN-K9i1MGdP-Fcl@LAas&Hg#yZ&;C<2_doIO~ny-0(KVD+ZA7p1n!?Xh2;?hRiCD
z1=Z6Z-#kB8YAEvf8I(sdph4$BQ)7=VT?s+jAM=U5grEZ_6|H=oE(ki5o_S2R{eEMj
zd0<5V($E%$f;f_YZLw{fD@ePdj(j!CCR|~kt{+$?^h7}q^ub67L0(L|CUKXi8PX=H
zaxqg7>17;`c3C1As9)xQj7<}3LL9P)$aDqDa^8P=8Fm}x$-^3q^m8NgLentOCJ{(>
zSPeHMNE=^Ca{;gGOl~ZgM&iq(!YOga7*uwy$8Y!;R|}X!{K6p(#0zEyRibib-vKDF
zcaY}zYm{zoq3q1(mzA=jk1o)|#I*0zn|?v?Q+<(wR&bl`{!GSv(+5BTx>>jr(vP}P
z$Fnsh4a%vJ&Z@_eYQCO99E6J{XFoD$go&x7M9G29>|a#&Iw!=DzS=>AqMH@?r_P$6
z?Kcw)w4M8I<CFHcaL%eD@)&+(iwBeT3D!csj*$XQCU^(_@8;DM3@*q!Zw#vd56?7C
zwkUO>#hT6(Fu|v(7(6J+KAido_ju-I1*?6LQx#lA;n{?bE&JeY{8lcJkQcR|nt<+{
ztU6%;bONTKU&<njjX80s5Y%0xYO>l(K4uGJ%M>N!!2Mj@j2=)emi~XJ_Su)lOo&Sd
z2`Y#P^qIJVb;o!;0jX}4Ba}F&kt7XYG_u*9t_=fq=J}`2W;Dv|WJOUFn7gM~Lx0O(
z7Td1wSJ<pG9M&if5$y`whh#Ld$|f!YF!hQLyDYKB|1;vnRlQC~YOW!!3ld_E5<x10
z*=0rtSPq?PGArCU{5IF#!mlIunq&I)yU+_?!|>zrQgV<3T@}&57;QpJxC3fY81Wy8
zMR`*7n}L!Ce>I0SVE!~~n(!Zq`RC@W24!}!T`{U9Ldl`RL_{~*;OUI+GT~!so&z+o
zIfuWw(8O`Du9En|#C`wVJjlMOE;JzpH6JX@{nmw!Z_usSL@#{6o`Uu)!5Az`SmDNO
zqRmnL-Itw^I+yY+|3}P$=l>2(3f2Y`^U?6}<%G5ILXA!o9e^5j|1@6q@d1ro7NF7Y
zuSRw>=?tak<$viZN6U`cYm~d}<97fC<YVQ3Hgt~z4VJ_KmUNH4f0_*lum6iDoqr_g
z`pK|Y>|*u2&zA|(@rAwn0Hv2eJ(fQ_k`}%mro~R+w6zR@O#p?@zJG-uAS^Bmm_*>c
zsqQ?7__%_&PS9$1tpci3&*C}LQL#=gw)LplP3oTbg0QDe>xDug;G-L7qm%GJ2$lGB
zm=umBWTL9Qf`v^$Dh)KZF<46yR@lG_+nO+9j<mo|X*v$7w?M-SUZ)O|Kw<@i7~#{m
z?_>KI!=M9zm`H^cgXqo7Xe~@wsj4{$pKf|HX?vza_{FC$_Kr{{{YWIC5Yi!}@bx^c
z_TLMj)(`2ZzGcZNMNx~3Zl~|m4X<~ax~>^>uBoYdRxjv=jrQKOR$Z(E_mp5#?bXgL
zs55P2KfBn@7tq&R+3m2lavFMOLAz|8S0HC%y>q%^Ij}NI&T8?#_7|lY-<^DX-1C9l
z<woakDlNgC2EftbDx>cb2lg0Cdo2NN5eo)(4Rp9V;J@*7((RM@OowgWW0fnaK|{(<
zRf0YQ9rtkPo}InKb<iM|l+~l=$X!h6aDJa8`FeqJ=$#ZYkN{g2=cvL6*;6F&dttFx
zvyG0=OD`=EERBmts&-DiOKw5MbGe(R@bOxvwXQ!3<$5M<mdz=qzh&`YImqZNWi;T}
z#jGIx(e|)Dqjf0Lz$pFumH<z0oj5mtK+Of(%O2PEk3Pb-A7R`7MJxT>{Oj71;2iDa
zfivE#j|_4z$GGA+Wx@9#>`x9>v<C4UH-3(o=ty<tAd{r%W_~Cz7M@y+Kq1Jz`&aTu
zoi1E;?f&jFH?(e<v5`*M$5`p)Phj%<89z!Ap4CCD`^r*tceN)S<!TI%?Uy{@V)(Wy
z%^2yLYwRHvku=rIUBLlobK)!LHEDgXHPX=+BW@aWUgC*v$6=goG^#LVOWbmCu9%E9
zMy{!ld+S7%T@UM<h8XI4MHHr4=;2z)z3mUKxpHYs$jMv?!bYJOU(b-PKic!1dK)}t
zAQ_CJ#R3kEje@!|hZ|@Yr@lFzc`$gp27OI1C}!sCtQJAe^=vW0p{U>0a6H;yS5DaM
zD*~p=s?xFD>wMZp_sW`{Y})(0F7>&G<UVncL73QFk%j_!f_$9bZR1^3x98Yhxt{QD
z^sI62$==*s-wKAD?p`4Vt~$GRD+PY{K^Wg?R0wo_tA8WJ-iyn%jUqb|D^MAZ0$7*{
z5}VTO4or%7cS;*~VP}rBCUg4m?1e1_msDpshAgriAaM5TciMG^c|<C)+Pd}Ql*6e~
z9bG49oUDz`*I#jQ%H=iB;dSVi9aZdkhjVFK`aa_JZqb*^*9bXT8S`Q@bPr`7*)c47
zrzOs{dr)Sd;IV%Povfcz(toE1y`2;pJZS=?mujQ9&q*tH$Wlbu-PKr?crsC|>Q$t{
zC484EQEZ1qOXwUDh`CF!Ka8;iCFO%$OOjp_ElGEWYe$205&fnQlRHjaTD8pn0csl~
z9g=wyi?ltSnGFu>yGwKtGoh2+=z}v8I5HJ!#9p9vr4C-b*mP1Wm?S}EWiHBKix=^h
zz3Se6j-9T&JX!-(y0yDrk3$uqUnTdW4ZB^W-s-06lsU=s)w!6Gim>uszKg-1bkZc~
z^5l9fS5hnk^SjaVaOdpdhaQD|#oR6p`gzB=-1dkqxhhK!h|M0xDU3CPh&|}t)tUJ-
z{LLGpyYTC?GBXZ^vP60BxO2t^coNTAPXDu=6C=w6<d=fHl$V<*m&ctmS5=PW_Y&lT
zKCKa0<cLs-Y%*W*ewmG)%Df1Rw-lBh`z{N@0R>0GOu#JA!O8VYcAYTU?O!~XI@&Uc
zAnPw~qE98aOD%MP)K!IFM~HhhY8ElSfRiH*sDg?TpfY8tynE93(n?LZGuuJ<Smak_
zu04)%9p5fz0E07xB?)8Yp~2<qdPS47>ud+NC*^;xACqt{2M^htadzOL!ku-3nT(`E
zB943J(R1}@$;caR(pEUTvb6PeP%P(!Wo$oE?Ax!p(#rUkVfx3Y5{AJYHme<ed~%OV
z4u`T$frGtE+f-9Wnw1^1BP2rBWbm<0F6IfpBx2bfHS=D`vV}=&2knq_4qxG{spENP
zm2LZ_{0nL|>o@06LPbseg{M<RD|+3dGGAhKt#C-wS@0~m!cy;=O}e~;tIv!A9DuB{
zdFy;<Rs=c7Q(ZblU9&Rd9}5j@)nC7!S3^=RE`du0P?B1morYY49ztFNxpc+_W8OB+
zm_QYGn(0)ea{3k_?y0c@k>3?On&`NJ)IqBfKUS+5_v*#J-hNa;Z;{NIH;uMMgv<_^
zAzDCu(R_m40@s&{nQr_Eh4Wl~xCJR^syx?y!0zX)U@f29{ID@s@9j-Z%H3<{yC=xf
zQPEss@a{bkA3t+_5x7$}y&=uEMLg0SnySYRmL>$QRi#B&3m2Cx>M`>X{W;giBX6z=
z>AVTo=(}%Se00{`E6Sqo342BO(=nG+$9wlR`;S(p)YZw^gqfW5=+6^S?5oTv;bWDz
z>`Ai?whX%FW0vml+w=a_62qj$2NaX~k}x?3h@j1=KtwNafWy3GwlqEHJrOQ&=(Vt#
zP$y9@Q&bvDPIf3J_a#GmrYn5O1d4%v7NU8FBnClefiX$Xs!A9ymTF*Y7Iog1`}1we
zp+U!RS|6Olg{X#yTAt9UBi>`ttQ=5PJbt1r(L1)%4mxXNxPw6bp<RYM{3#(cy{n5(
zBl_oH1{;R=7HVDwKD}`H-p>07cgtxQx9<!`^0rBpFvL5Ps?WWG4E{RVKBvd)RcQRa
z*<cd4w>=l_oSW;<zeh{W-A0MKIrX?+pb)yQz!=;luBSC<*4JGcLM$azOAi-6t??`A
z`!t@e8(fWduQW46^fNiHxzT*RLYZJ(=w=_d?ai_Ki+w(S(r@HmbKrL@(uY~<%8}lZ
zEYu8F;9M`Js_cJnMGY)r^s+rH2Ww^wkfxSGbWWsiFDFM+AQBV(GNYJptA7FD2ZKAW
zQWH(wqwk=Ux(91Vk|27nl>E4^!76%$`t`6u<SSgF$qlG^Xz<L)eM<A=+3Sj|qJkh+
zm#A^$E7H_P=pn&iUGBZS14O<vvr5)1v`lC!+^T_5j~`L|I6zn|uF5@;r+6~8GYZxR
zXqhmfrIi~^#7gv8(0OduRn`4HWK_2LJgT@EI1>RdrRE049C?&LBimCG(wWN-c``_R
z^}%~IVYfj=j5_#zS#5T9jDpwV?oMWBx(cP;L+Kz7O;{8ArN{H(T_h1=0-EU*Y&!hi
z<l7R;zK@4Q&W5Vr0KuXV&h&CE(EmIN5z;qwX6PPeXQa2+d09nIP|Nm2HDYwY><8??
ze=|GrnUvwx0uPu|hY4|j;lF(+9R<UuoP<q(dpFrKMj4)mKQcB{{UI1Wlkxq$5Mwka
z0)=Qnp1Dc!p8`IDM<NWIcL4I*TJRbd22DD6S+-|?M7;!M@LNG_=KI5PSi#_K$ZH&+
zS?ZE(PfEmd*S)PNv+?W)SI-6=C3uV#Sh{o6ahNlG<dY&w^Ti$3LAtQ7tm+8iyDe*A
z>hf3~T)AFz?;2%g`8Ido-c}C-z|R!q;lUUrvPZy1wnu<P?Gr`hf6i%GbJ50VfmngD
ztZmw$B$^ab<wOb*uzg9f^#Ma+RiX@>5MtO^p~)4@J{>9ro2I&p_n=6e>N>oH5r9J*
zE?71BTT2tG8C^>ZPRe5Gu4F=VEmZgW%6>HA6p$Dab(IP7ix59S8^M2c*@I$t+Um!e
zxiqq!XuHtS2+ve>leW_SSd@~(*ME{$u=q2`dv}r6Bo6Ctv`F@5r5L1o<5r)(1PU6R
z0Z|a1SI8Go_XsYWcT9}q2u10$eE6m5Y3PulsA{ArMw?x_2UF-oO1$uMcu$;*rmoAe
ziV6W~myXeuA>4`ehKa+bWqF=dQsntBfdv??XHSuAm@4$*2>_Pg_d36mLiq>V2M1}w
zt^k>|IehPj5F^jD3dspPqw+6Tp{&mM`4_C9kr7Q?g$?Y!7u0T(<3#f7-Yi2<+6|w4
z(G@f@fmW|Gc@<2*s@gT<M0$E^{>|>AAIfDt&h>^ZWqb1dzMAFUzAzeSE`cOG#D;xY
z{oUxsx1*y=2Hab@yMtR)u@`G7+rGJWq+~yhHnQQu2$yldMIg+oO%_LSeckP%W@x`+
z{L{^f<CF!MzyIPQXru)eFsL=5Lb#)~o!}55i~TVC9Z`Yh=M#GaDQ3u~^HmXWNv8q2
zVajS43nZxZganCjo6PUfdz|YTL8cD`1>m<negNNV{Ad8Qd-iY^I}qYil0_tf8;W=%
zQQQt;UjPimyWp`8p!DCzbAY0{cUpn0db8N)$r9Vq&un|%DxOfCe}4@;f^5sb*<7KX
zeIH20;Ohw^u>N<%$4Mx5gqQ)QkO=thy?#|4SpDoXv;gL;WVQnhBw$w|ixpWXh}-{}
z>(;m^_^{ze6qqaUW)1jBQs`Cilcg)cq#E5JG_MPQy0ZsQih}dwqZSp;d*91qV3LFz
zFPy|7QA8}J|If}as@_Q;>v-)bAgBInnuCUra1Qv5oril-3NGm(bPBDKb6J5=-v^|e
z?=xN44PYMH1kLmj(^ezm4tvWXhRi|r^sEiROe)GgB#1zF4ir5itQNcX-nkwumNHtm
zyNQ0e%3HFJrbQUcg)4PFN?_*zP-|iwsSpahM60m?8$ugn2(~nExWc12TdCFD01*u#
z|HL$*qbTzUO9>}U0Gm2uLi^?IDXBEnOs#^g<sm(v$dtFetIPug5a<KnySVf)Uy*ew
zf$FNe!2XJYdnU5DJ~x)Wkm!ZqZZ3WS@ljVIlpz5zdHkjq#;^&%nr*EG+^cCZ`Glmq
zVmmU@X5|#+Z;3fm92SZPd{RYKWDkOJst;SmivXjUwiWX&SeNcX6VR1?zX!r(4+$wP
zOv<X*y&8mJRuK5|EdJ_op-`v|Ak}B?a8iOn8Nk#iO6ZP(W8@C1x|DhTh^+|RIck3q
z@YFbfE-5zZ=H-L)%i4)FA=bC${`MLa+5DN)k$TjK3y895v^O<WOz14a)E5X7nd*Ua
z8Wr_>P*&*7q3Z<cLlA!Ri5e963&-e#G^R5c6I7cuqX*lNmhI`$AYChvsVN0_Wxl3Y
z4}m)(1O|;hVJv!(#tF#-BR{(e+-m1wQK&xO=3QXY5lVA<$y5;3&^GGp%gWUYSa8BG
zu>h+wM%_HQ3MK|iwcie_&U+1_!XQu-&Cv=XyBH`8{ZK2_WN$C+@!&N^QhPp87hH}H
zfxoGSHkWvV&LEn(CJK=CcwspJzFUM&3H}pq1`nuUZ4oHTNALnGmkvm4rc)GdNCG{*
z146s(x=EM_$`1<XF7R!E1fDn<c<h^@V7dDg=5+7vEf@d)v|N)5h=Y^3hs<F}A2VNw
z_9m*ykQWxL4i0|mBffch*{iT=G28w3X874;LVP;>$8J@xemFHD0f|P>FMljZ++05g
z48_%BZa1{DL0zNb$}cjCxmNMMu?eX~xI{sJ#o>UF$caa$5f|E^y^&d|^VwLJ(!iJd
zK$X^kmSk(h{9*Y_J^Rj{ZFH}olTF}U>WXrw_}M)-Nc-+-_t4N!fT1^ApBtH*-^7_L
zrr8Iho*$Wy4<TI+FRe`42G0rdXo)U>*c*%|2G&*i)=B5Gf5OP!M`Y<&>JbOMuZ24y
zGx6RfAGvn!iRnzgo&lVreFK2~;4lTBWfVR9@^lM5&O73+ag-z|Es-2`%lm?T>+l<$
zm0!%^v*GH$!Sq|L*)mc~dWeJDKa_KA?DP-4#7z-hWwQ)tCX2_mhMyP)+W3Uu48E8y
z|L}jo8d-g=^{2@jJH<EOn(Yuy3=f%G;Ive+_AeEyj2OmIfNmeV%oktXbS6C)bUI8H
z64(AzK5)pT^976RVG)P=J1eROOcvs#*qs!G$s^w)q=y4eC6}9E%KH2`ySDo6gD;%4
zE#q@-24V15&UCcF$3VGUFK=dFcL7(VJ9{*0hVF7*H=Bi>LtJnI!@0?|6HZoeGW->c
zY|cD<aEs%xHd1(`IO=8XgTCYG{8Ye}jAlSZKz{=VWQ*f%)5Yjpu(kt9QqPYWKQ)p!
zMlb}nQ^D@a1||&VJ&Ob1rX#NxToAL7<2ELpE)TCvv&K$d>d`5bVZ7Jw0^Gd*SO~Ur
z57>1t%)ROjhNO!KpKS-@XAT~Z^`|o()EKw}x#u<XQKNPN3}<uwvtC)o#P-6^Q2m7k
z_)sdZY)Cwk>z120s^)Yb(cjI;qgamC^S$amj^GkoD5s;j39ut8r%EDf3s+o8hl_}E
zx(Hslb2^^$L)5eWaP@h1wYJHN@F~O)xq80z*+pIhOGlf{r|iKb1@T%aA%ji@2FgC$
zWJ5I!3}D$RsmlcFAWVc|NG$~27VZu7w19=yn^&qm*t+N8H_|O%hw1-FxpS;y_jcYh
zkmj2Hg@-|pf4m`&41l9C>Okt+#@;;Q>cGG;%-J{;5s8rSO&JMBDi1jH#%Ilq-k87i
zFeAV8<37JIRjhX2jF8k24tlyps_Nxt*u((q{Jx5NrSNAj8uf1OzLq7GyDYdGI?%np
zOu*p*O3&w_)$V26*u}eLt-}6|I^uSY`NqJQ9s&ZYs#S^{{QLkV1Hc&j64A2Q!v&?4
z>kgmK-RWoyaR)HC!aV7dCZ~}7=Pa=_?wma2$KbpZZ=1?;IGg<na7p6EQu}~+JxC&|
zn@!!-9nzBrAAIRm*Aq5ArL1ibU*QveeaNLRsF<0fGH=Gdv|3}25tNvaD#VDBg>-et
z>SeK~4k*2T>+G%%efVn=?Rhah^U%uEH>iu`Qu$@VWV-Q-4+6SBWAG+j3kGF?dMh02
zh-9_Mycaa@!CosKd92+cP`y&c0w_;d-@(Um?9t_7o+~daU%q+##ed6T|04S=!t^Ob
zf3oa@U>H+a54b55mp_!a*sRiv77BLp3(xyl3||o81Bl)<nR?$4#lss-nL;3SC=@ql
zhq_kRckJFVq|`itE&y00VDxU^$#77oV6z11pF7=~Ohv&8z?XTjHLf1#azfyk(RPnm
z$@N&b*TY{eQpR7(cN+%|WnK~t%e{lQd%Da6UG`@H1IUQHCLre42r2jBZq)PIwZ7zm
zd!D;#0<IiaF^5Rx)toNm#pA;6Ry@;lJdEFh7xPaTrG0-_dqxWW%4p`=y97ImRAJVn
zxIsQp7#up*J$VZ%G{S>WAyIut4?n*dfm=0Km&!3B!zFcDlFy3UANzd$x%g=OgmYuE
zmcX>kTb0)@>i0JFF<gJ2;Aa)^vCu_L>kMYe8kDZ2m9(@d;#%M~Qqkxm;VqQ5yb-7%
z1w5iNh)~puWVZIpBeFd~Uoj3;1tTFNQ=ea&Z(a(rhced$wYl<xG&jMC)rnU~`3g!z
z(yut|nDwL_JM?XESu><4r7}p(+KO9ZeNUeM$=d*T$C%8#7di%`Ljxm7xjL&r4|-Ls
zMvZdkZ7SM!;7FPLKAbYi1VH>>9d<i4pY)bg<a;RxHT-^uA0uyxF_%-Uv@A$PR}p|C
za++p*X&g`-?wskmVQL04cz=K(pOqj77<_G20-U-f{Tguo!Dr_UZP{3PqClP}TQ?K1
zN)>e6y8dL`qI<7DsC~WC{7M_-aV)_0q?p??G=W6g6osoQv4FbOJRqn~tpn2EP=WNT
zG)^RZ`MZjpB|>}<%nC|_lFm}$l9*8981S!mG0XOMg<ujg1TO=n3Q7bazr9OgT<L%N
zmCWLf0Pj)#vm|ga%kGLMa06$&Lg{<%H*lcNJm`boQGA9DcaU%!1>Ro>$){vA3O`=b
z3gvT*ZU7g@w056ez?Kuq)u&4bl<u}4ic$otG!g@QPiFFa$rFp(M$cN;9D<8|vh5rK
zNdr9OF|l0hmIfvC{wy(P%?ql}?5`PGD(`XD;wQ7lUo)Bf%rayK?{<iLAFOTv04m)5
zSzr66MK(y4sfz*X>arbEgITEHWG~z#UF#VFD{RdVF9MrpLW5(CW`E1zF)n??+Uw@!
zuKC>~=EpnhnPdBH7S!zfvbIm;a@>Fcr@tDIwUBS8<4LU(tW71<cJP-XlW*jlY>!Q2
z$=*o>2(ZP|+hofIBR_qJd2$)LtdUl8Q2*@hv1D@>w?mg?Z1)wzAi>YzIS+F8isc81
zvj{GE*=adR$Olfc?JHmesULm7sWfIQesIhwhFX@3QygIJSe5y(&|AO|{y6?9q7Kvp
zy{wsN+f2EIO>5)QfTijM%Qf)2T(l2(kMu^dX7*4Ri0o9Fufn>72QFIueeU&`E_B2}
z{lJ5i8+RU$oC^?e11Q!Y%TuW&2pnXp3MW&_mGrL&)#v}VLnl(N^@kZC4sFzZIi{)5
zJzU&!&iN4SPej9o^jjyT=C~dbnE29GVJT3X?s1nsT55(2;0XNZ9d@CAx0F9Mzw_^6
zSwOkKhkW~~sbz`#3bc!4C|8H_54{2mn>yfd`p-KA*n~fh_rJ2@_3+PF=gUtRa3&wR
zNP|x)Yzj2aJq83_7AV1g+##?@|CtqsU6nf{idldp9#NOFOr{7%PD|FhdV?C!ga5Ka
zC@SzDSaD)t^5Qw>AZ;g7Q{=I_NP8#}))NbZob^8+vY=co{&k14#Q)3+U;><_-F$#Y
zJx=A)UD!bhyGyN?)6@J0D3t%Q!!GEX%Kx4fKxzMrbi@Di4zmgWg%u!D_#dTP^}p;8
zyzcsstca_i=&!L4h((;zn+0FQWa3LI=i8H3Wnbv!+!0`Cl#oq9j<n(=!nS4|sDhW8
zTzLwJpTa+gA8wq&91tqeu<9dNMo#8k{BWN%wkJ<Bjk#wjhV!aBy}JKwygC&8fXAq^
zN7&gGUPaJRqC9?ZQwXJS02qhBvkuU7R}gKR=wBVIQ@3&`V)?uK5gqGNCeXJH2A=QR
zg(O1L?|8h)Q9hvP>TrcLD8ir%?3)#%XYdso(;jr=m2`Zc;kh^Aw>QxOv;;k10D)mg
zRzt(*5oj_ABo1Ps9f-Zyuiy9zinE6X0pqa|rx-45B!we+xS!ub|I+oL3I?T{(_<q-
zry%=tra`;9*2S5mZjU6BNFczmiPqkJ)eXFY&nO_<d#9iHBZ3KvSU|ezsjiyzN@wM0
zjP*WR!An3NzB8t>72HQ*c`-sn?$l+eSJA+Tb>P9L7kU{O{PltCJZZLi99xtIMI*l0
zs7ac!T0cLg4Anv?xr%{aUaPW)2%e%b?L`v_-lremhpsFRa1jGwS*k>U344G4)CC&w
z1U$Cpa=lA;t4^Wis~5Hmo8THK{~*`uscTUN2=I_y<bgGARP~0kSXBU|1fE?gtP9cf
z_o6cgv_peM<M88}oG<nRR|nYPZVnlQks{87?{rXVx6~VG#UBUF5)yh3F!)2`;=`@V
z^}veRqx&9bpxX@)H!fOrtA75w66M4=Bc%x9B1DSGj`&6DJpqn4pmqA9vA2%)_n<45
z)!j(#iWrKi_<C#H`6z8W6ytiP^Hgj8NfPRrG<HG@OR?!%4?@zI{`Ul&6L%)zVol@-
zl*qdHw|i9Xk?Jo1soS}pV4qi>g*mrs7v6`K^#zf<Jrep_Gn*6gsI~9^bh7i2?a7KY
zk=pCK^364@C{&#QqRU*0N?8@f;5%sz+J#AbeFN5iHB6{yhXN0U?m)~F{lXZOk|&`M
zxwoa4H;u2`u!=&_h!_s$MJp^DD0ib>nDD3XF0PU8te_tdkQY(eN(T!f0X|tsjL=u0
zMWP&V$={8vk+hz|p{RDQTNMVjjJVbKSQB0mO8C{J_{pIXZt&;~ctD3{xKtduK*U~}
z$c=fpOW2F)e@d@9%P_7Fg3F5xCf|Q@0q?5{&2?jMX<XY2pRq?1I6y%RgU?0&mb-F2
zQPM<q%<m~A#fTPe3OC7V3R(f@#r|zgkK+$pMCJ{G_?Nv_@n7yuEt-NHVCkusCXq3r
zivXM!OVTDz?J*1a5_*R-2&huRcz!oBbP6UG7HdMixAO8WyHcQ)3LtEq4t*o$T!RNL
z>5Vp4sBJNW1nG3ovQC^7a9SW|qh|u+4rg7mL<oBmYW?=s4i6sq035Ra_2U{GaY-Mv
zdxYA)?G1n>9^$tL$G;U+ae-MSzV2>lD{PvEr_F0`1>W8H_$Cm2;sO(tguXsH$hKsT
zuo(xmANMez$kTK+{-_Q(MB0EKMl8!2$I;gIqj{>)w#s|L$ft%s0?GwsK(RuoG<<C6
z6WH_>9!xCK&}(mz&LJnrK#%<KK#zj#K4d9T8_M-?NfTT5CJ<XQ6ouXqLxC@f`3rpj
zn-=H6L?hMy46vYD2;tHW0}epC_Bjt#-J`uSfT75&{d(Jk7Ha|Ik+w&w?l5l{BW&h{
zwr2L&^K6&F3&mi91K?^Gw)e|{Dt+kFRp>0Gy|o`vdz%5H;Q}F5D{UH^J8xGF5u@Wm
zThn`eW0oF1I>@?|4x&AumZkdo1M&&i0O`H=b``Ph-Fuk99|M%s{z7bk@k?h?x(yPZ
zN#Pszq}pUT6OAexxO3z?asRYD(~B0XLJRzv_x7zZX93zXf*|Cf!TQ#d5yVhTtdYBa
zSZ1NRS<XQ-0fb%LV@`L_^NB3hg`GS!mn=<$%TkV&RgJ@YYzG#=<OCMOPNV8f;uI!c
zJavtd;vxor7X=RTM*!6Yuhx$Qu~Fk?vAQqNE(Q82VLEtWN|N4YbvpM1h=9=nAAZlz
z{|#V*Hpo2UPqsbs%&JC0?mkik&<9iisU?J-2FTLraY7=+mQ*kQfZ|XM7C`nL*^C9H
zXkI#zR)vWQn7R{E9a{s5kXP4!x+jC5#uRvug=dqPJ#kr1ByTT5A3ELk4DYqQH2%1k
z{wcxFCxL08`1zfnT+S<Pta#g@Kk8k6NP*(rF72KFZ<ul8=Y#@?Rg}z*_?$>)q(%cD
zIGHF{fn^PZViNkM!oRVUOTX5iyV8N8E>o4|1%100<MdY&a_a@g_qaW_J68sz6b+uF
zW0j6DU(owja{cYng28X|ncaFNtj?q1e46!K=JdU-pOEDQFK(odft1c+3kw#fx^qmG
zKYzWrbg;TsvF>@89-&WMZz`~!lC>jk<TeNZR3$%<-@NA1(2DYHZPz~hdu`Y5iFu1E
zPK*GWBnWv6-T@mE4B()Y0R+9bEN(n~v)&1}rh%Y~6>&5m9%A1MuKz_2$QAChHC_%T
z=^P3s30|K>R@B~i<^!MX^56vD5aI%Pm-Ocv$Foo?O*-s^@z<D@CT;M=wAx>1zcdLN
zX@fb&P<8&Wwx}(Fi66+KZhaB5CxasTE9*6}%;D;n!4bj45mU~Gtqn$AlqE8Yv~lo=
z=|Sh|@I~G|-v?X`67HT}1aQ9y86S~09;h9p!%D)>gX`WU5S|Pe;pjrMXr_A_5Kl{E
zQ^1v@?J|A73xm2kxTXe-uz^swW_n@bI6gKh4+x9rP$QX-hSdmiBq{;aI3rSCTci!~
zXV~)a^NO^Bg1}PM&hH<0t2yZIVn8%!7i$jM1uO8q?gBW{g%;Qd`?`hB>cDeuq$Xt`
z>yg+<Fs;}^G!!)}0cLPA#%*DZ+Yk}pwOEgH7dId}?h!U=$M3+w(9jKNa`{(I$f<|=
zjhGdEAxg?9!|%EQRaiS^)pP*Xrx{e1IG(B1ZUj!v7mJ@WsA)`rmZU#d3C);4a5gA6
zas0tvqkUH+s7)Yl04^XSEC4~R?d0J}Jd*_FeS%4nN(xh<>J`AU*5cG)Vu@X2pOIUl
zdzq|M@9PFMVY=Y@)j6`1OL)dO-)}&?_h+g4^iz_o1v0={^T@@c+C|IFl`uDTNe7^C
z2Z}$VS3SE4kYa5AgN*sdXM>Ux$H{+I)8D9gh_+A<cqJZJLCFdWrzh8m!O458=}=M-
zxvg#wj`sk*Kv}HsLz`N;<5snQTIZA$9B-?eQr3C~Cf3|#D@y$Nr|p2ULjG-lmjJ|d
z|J;qXh+G#UjF<kIa;Op9@C%{v;7C<sS*EkoaaN3~-riat@n<AzWD}vaMuJ)%BVFLr
z2)2LPD)}?YG_qqT>;UP=IL&k;<d)PPad-hc=);(x$esLmC(>ih8h_pEUg=YR$m2sl
z70g;704{>hPwF7-1%_!2h>L&P0_dmi0L&1uHnj&86-S1m)*mO1*Zo=Rr$$8t0B1mJ
zz55L@!8&}(fVlgoqbB`S5^KR>Xi#b$#01;$p-d7JdT$>B{25+nvn?rW9djaCpWO*d
zG@*;8q~+T4!o9EzCZN&|@%a}NVuEAXFO#JEr=u#^<k@UphybYcjQNbSJMoDo2mf>=
zhkIFqua1Fx?bv?sl;=rTmN!vcXpaH`KG)wdhs}U&{EGa56Y1mGpe9UV%-%L81{xJl
z(uza=qkBO&dMjf64W=;ePupOl;wjp~vycQJaH#f^<@5$vpFc{{%JPnU)QAl-4g1qF
z=Fe!>Od(Ctdm6AZ_c?=)rXLvc75R6-PmA<z1zFHPgAO+;D$<H;K!Y~Nq1sQE^NEnL
zf9U2xKQ+f%KtqvL(56^EfGJG*)9+)Wq6)1zbiH&>=tc)bnJHtq68EIBR#{;x3Sgoj
zZG1iMHYG6JGV;vj&zM2<`P8gSSrAE&zSe11E5}{??f#~UZsUQB(q$k>h@Oo7G+e+s
zugGsYk$!59Xd)Du&+^0Dc&)_2B}x+F{yY=Z0`Sf}`~HFyKc(1~fA@F5A747p${&ZM
zU~M)Bmj1wj8$k57bEE{Q^)07v^uiTzp6|h?!FO_q&uyr2|N3`W8~8m6tQa7NPd5C8
znWrdZ4Gm0ew<`x=(t-T#A&Q~vm`4qb;>cDMH*Q>d|6kDPOOP7QGi{>(<?oORnuEM6
z+!6r95B~)a4;2PW`}coGtyD^66ITB1#?;^W{(h(pQ0~-!q1-P(vf)by5}p4{ISPej
zvH$Y>Oghmskl(KM^dEN2uxS8dkGJmp1KFV4E7+^f;lJ;diuw~UNfYqPf8P)lZ7{ga
zwW~G#eb6vXn#>zsL#iMBS3-)F{fi!aY<?{SC86O5|K7KOI&57W))`38XIRg#U1q$o
zDqYD9GN@v^m!Jm$e~7P6$52}?{o;+;Dm(3EBH~#0dE%9%wsf$*03AUFa0L9t?Q9y_
zfmuCi&%?s}s;*jx?wOn$ss%^ig!auKTL7QY9(DzJT8=zbU;-Kfxi4P3(Cd2Hy%j{k
z(=)$0U5WMBpj}rlLyV1?$8+c{1HP`{+5RSD{)XAgu{lF-NBRbi<9xh%Xn#3yYKO;L
z`+JP0zt8D65_`1n&sF?d!=o~00IO6mTAW)z9w#OR-pz@mt4Q$dc9N!Zn01ol8|tj(
zybta1^WXLe4!cPqm)CF2y5iHizmxg;awj!srLbQeq|<G+naM}XH2O0A1}olqa;xBW
zG(N<o{EF(=)#^C|(+Yo7AXFha(7iHoO_&9%kh1++vn;h<8)#g+n$q8RVnj`I419<~
zThIP*zjt-FAh=tz6~7X&)FM7HiM5qt<aJHFQj8vbYK9*(As2XT&@~nbTuetv@ZP`r
z*gZV&g9OlgIQ(ziE1;rI#P`KJ9Q%U4c*Fc)R%d^g6{~D6C>wK1S%lc8<ASPQIyc^H
z%_v;cmy>E>Zz(=>2NhGw`I8GSwoCQ!ANUKBV-2>h`MX{GVz|B&m_fsCA%^PiLW$!V
z0QV$rS!mA{aYHO*2`Q6Y-naQNBg0*<{PS^OH1+|6!T%TyE<x}WI@H)5k8YQ~3{WKD
z)BQ(s*b{K=z~D|NlG7R~<#gNBSn^pFW#pi_HYj=3697W^^h|$~aB=lZpL7E6zLv3G
zzy2M;7*)+}fI<|vs6TtVAd5~cAU{{tl9I(9C|G&|8LWSt`;shn<Xud0Sp^Q2mW~kw
z&oKpI?fl?k?yQ_RUV`UDNn}>a#ypCvNPaY%P?mYC;2#ASB_m;{zhHgps{7UCYok`t
zc+Le-8^vnan%(b>6A1<KVWRyLjqa66)N=9rD+K3eszGD`Gt~%8uF={|=kvf_F~r;^
znm24xmUSsnT_R>cKNa5QM2bIC=F6$VKaN;KVw|~gTB5u-q~b@c8&}&;odI_lHy1>z
z0@lUo+W%qiJ)@dhyS7nvqhh5>RZ$YUfFf0z)P!C|0Rg2G2uSZBDxg4sgeD?L37vpa
zf^-!D=@6Q9lqMh`N=M+_EAD4MzWdqZ9q0MR_vegpe)vbS)_t#e*E#2PU6Yn27ruKK
zqmR43)z=0b-jdR-KG)YQl$PpuWK7rJ|4dBk5vVMxSJ}~YNY}jC87I6PCeq7V8@a=K
zG`CwM=0I<iQ>&u_@uM!W{gdBM(UklL#R}F>EqP>sGrwXnb@v2_9{3!mqdMlILZ&}V
z08|G=>$<1@>%y)60(jRD_2)5I*ATeE<PbT+;s!&Yp+E2fKw7T+TY-+uUtw=LcO&4h
zUr)6J2lmn*qUQ((qMtgun`cUF2}>fQmuhYVmYBYeBS+(CCbg2F982s2(4_a%ckaSx
z*G*EaX$e&p{!vPP@inZPlbFLkzlaUoU!nZaeR5o;@bSR#0>{y{^c9YVBJQ2k8IfV*
zbxwidVZ8{5^$o~Biq8!|rkk4k;z1W;5#_VQWSP03s+evr>6v1e`o*@5_3In6)dj(!
zndI0>=vVJw#E@fP8|9!V<2Nua7zht;qvzZ=6V_+ZCJf{Z=m))|YssoiVZTJlbxK6#
zWBM8Q8*>+)iuyR`z8tt3JjJAUDJSs}yPmM^hL5#C@ykN3SFW$yWcn{7k`(G2?0at^
z+t2wcqIrS3D9=Rk<xb+KH)arym-;m@_?)@*B$8j~>aK0?<8(u9)}pE1yo+brGeU;)
zv!A_avqUrWPZfPV^{@k3(?aKu@2zIe<&w>BU^ww0)2HJu^_OFd^=a3T(swG0<{iT}
z2hW?vJj{rrCx)uRESV{izudTy%BG?rgOk5_qSOBB*-Zfd0xc&%d9XGIk{My!Uj>^&
zxT!@5O)Xzq=OpwQ4T~+f=U?eMhAeR}8a3{JuqW=bDE468r*C;xd0s*mV@ve$eksxK
z{EDEAJ8~++I>VXK9si|r+!veF>v5V5L0GrU=`8B(S`y1RYNy5Jqc`xKx?L>FxO#J_
z_}T@4+4-)rZYJ|DEC9ARjAs_oi<meEdD<7tfKI!ug8RLkqh0ae-E5s7_n%<)F;)ta
z`a`GcTJgA4RoB!F!SpQNvUav11^|j5>b^$b!12)f>J9rY)5qWETEk@gO5;TgiJ_71
z{;U|dP=p`6o|3KEWdcm0dx#6qznBF@X-21hK!lbE3LctrFp~?A);k)Uf#f=nczl)m
zCd@~B`3R~B)pymm)D-(J-N(|;G1Cu!&ecNi5~v-yAtlfishkx#TK^)Q(WGzv<cwht
zXvXylHp=of_$ToVEP>asZ};|QrYV$0%A%eX0qHZh!&R6l%Sb|5V|%v|Cf#snhKE+n
zt~N}0`(S4y!boXh&7meT{qhLi<s|c0%Ct9Dsk!+2+P@_}x1RmhaqU@6PGFhCY3VLx
z<wc_c6KC|`S={I?){QbNI-QO~2gfOIUv5$h-2J}PSNG*-??eXs^7+=tpWv`8d>pib
zeURuSUwp~BdtxcgP6)HgrDTs!buABj_IZ;D1D_l6p^32xyl_c?n2p`8oJnQmZ&!Wk
z>ZR@bst45+3h0M^@Dm!QuZz&F4}iwc#Gyk8?JM6M8;WqZT69f8?vu~Fd>MACYyoD0
zzFQCwp^STv=PGMOrYABXgP36@Fqb5{B=c)&%_9SxC5N9T>+u)&Zg+h8F5vg_bMsl0
zFzFp00ZI{$?b~2-uZ`D%E8BN)AHM&li9*!1`h)C4-%~LL-MP&t1&Vo#M5LR-)!WlI
z9u->!&NC*aDRmCf3Z$f`JnL3s#OitYoMN_)RuXLtUD)`^!wF3$=PO5WQ<QTSN4H-b
zQvhs+i-osf!P0TJEdB7)9s*xM{$EC_^43i?LcBUBwYp`;fn1{*DWhDSs#Ich)!6p7
z<+_$FU0hq5GOQ2YW8BgK00PYj^8$^GcZi`y(E^ZHK6cDu#w(Y<Z;BVi8Sl}%*z(K=
z-JE4;tWlTFhRLn#@yrgGYfj<zIX=B$Cb&`;CyAPg&&jRrN5D*wd(7>+me2&GNtWxK
zN6HiXkfXLt{ZknwFQR(A2%(EyW!<*;+>r*ed=0ZHx>tO6hz;}ImE9HL2E1xj%+h^a
zRQW1h80(r`mJeg+#~ejbWudlA4pbs6D!L6#$&C(WJ<)uH{7DMmu*IL+3_+N4ffDqV
zS#fmEGIy`SINZ8>RL!hTMi@v*&F8Mr65h*`B(j9`TCL|3X70$$iA;~zEbejp%q;|#
zhn1TdBSw9eZ|uXoh(<M{Ml&zo4v1hgib0Uh?eKKUPqjN2Ce6TIhQJwmdw6FE2wu^N
zY-QBSwht+vY95GJ5+)T!mGX1?Aonzcfb2r4_Km#2M~}8&T!t}sj-5T<(OYZH|M5IZ
zL>IBhyqd^n$A#ZSN?yJND6KfU%Mxd1ypuku<F$u1clnCGJ5Aloyn4Q|<#o9X3H0^4
zTg=J)xz(ddQTTATjH4oo-|!)am9J%fPMe6YtBgc}JBj`0x-T0Imy$mw?bMsvo92s5
z>2-@f>^bKgWm#R>H&EdtA{kE*&5<u|I_bD@)hSE`RD&}+G4JE3l3Og>x5Gt<_a-*a
z+$+;!96CE>mopcO|LmPFP}VB3u9>#L(+>oM%o`r|gMBrWqOC^4Q<W;$+n?(*TW;Xn
zmVx|jE*EOiwJAaWwPjOj(K|;eS9=93pG%3znG%#qzBbmiPeXF}lJa$AW$o|hhSy0z
zS8|Hlp=@yWJy8J58>~9>LyZU@QV9_Riv%6)(fIE;0JIfD?poZO)xE`LcQxX|{^!M7
zjB*u=3Zo&xjc>~Ox%f?s2g)R5*v?Um{>VqKkz#P{{($|$xQoN@_`y{WI74GoBmRnn
zb|62G62=9HW`SBiD14}`^peb16x;-Ew6N|Gt1MK(VhazYQO`uV5cS?7ITC2dh+`85
zW>v5PLhi3%8_h2mvZJrogl!_VP-;NFh1o6*pUht7eUZZ&_x+_<f7V7JtjsWECf=A$
z#lY}5Ko;k|dAm|>M^4?5f%O1Q7SY`^emVpy#{j9Rr8q0u;VU&~MYq(}<5`lUR<mrp
zu=E_>-(FV;0)<{H%AOonOzaV*`Pb3cp~TMIyDn{@I^0Fkc2-bm@^<+-kL~Y8gqSU)
z@d>*o1g?3WQ_erDX~^=OnLA_Dm~p~fEJJeISfny9LRJB|K-s~yYW({imLDIGuO}gQ
zr}Y6c_I~oDRi2Ic6Vu6^LD3>f3p6NMhz5PT<}#?iQC8MhAlQ%6r5e<~TAE|&WTB@~
zHaSHjvMg{IxNb<_^=8;sIlP2{jNlhK!OQjFz8TazltFy|?e>Us>si}}78mrnc;~zg
zRtp5H^y(;Fz6w8ms$w+5FVV4d<0?_zjo*6dX_rjmdqEc&lT(oI2OzToN8Eu&eh;GR
zzJ7ZB`N4pdptEFUmfJ6vlj$*~p|C!&wvuFCO<r;}ZyvBo|E$OSb|(j^%4Kjv`v*r7
za<4A`=3aprT}yYtMslAr<KM0UbXH4(e8Nvy#Q*tAA-D5CTvo`TrcwU4LmkvY^F_L}
zx1^u;QrVWmzOCw_vg}(dJr6z9dVSDut>1uMjz3D`^sTnmkUm!as@~=`eS>9+MO8^$
z-#c*CnPy}E-AQ5!QWDND>+3;x3hvr6d!UA0?$WzIxI>RFe`#<UGS}q)a3f${kI&;k
zC6(S`!J((EzQQD#SfOfY(s2CGmj<ljR>PXQrxbNSy8SxOCMOgTq5jRB`eE0_9hEay
zv<tnjoyUX-xpAsh4WF$+wdSl}X5wG)$)JC#q%~<k-H`yRdL<cevWX1QO5FPlTH^n`
zCHkNthjRq$j0?7k`2z#CnXB4145#83a?VhE;`U+9uR+bV8+7}Ko{aDQN?=yf8^ll3
z$lx0F@?@cj5d53f&cN<84h`iej_k{V`H?ZiO`EBoq_mit?HU)$LJE&4YhH>c>FnBC
zT>Jzxl;ZG_13kI)drz1SW?+qU%uF_nOR3XJ_483`7J<6=ll|~Uy|F?=^71gA+tWr6
zz!oGW{tD0VD!&0p>)ypyp=im0?d~L_b77(S#)wHwI6Z}h)#Ya0q*WFyOHj{uN(??N
zcAg3f@BGi_?-VZEvnuk{6mY$LXkxO)A!0|Z^heAG{#y}IrCzv1IE;WT1>)SgTRtac
zboZ_({5GS)XfDf;lFA-WeKziH?f9Xb)oOcAi#1n7S3KNw=q}K&m<f0QoOGYxo%Ab*
zlwt1R3SGIL(u^3o!{lTg*~?-_Ta#;|3Ts9?t#@W!=F0?;zZO~b|M{480h%RuXUOuN
zhGOTCmum9moP4x110V-3d~sN0kkL)t0pbt)Uw(JH8z`CBc)lnvID1MYJpoM5bSqCO
zobgCVzSRals!_p-lg*A^TKc4ceOw7Bo2w#u0$AthY0T86BX@K5-_8~UKmoiwg;X)r
zm+)k&etSuO0FpFrH=Q<g2w!m!nQxo}Y!syQ4pBOVFwW_T3c#;i*vrVD&@zOAGHg5`
zM0F+gFy!3f=pOH;Pa(96pF?{^(<!j0owPj&LFT}L6b<~AXyp2GH*)amYy|XkaJ_H^
zKb)nk7-m~H_VIpwwTSSf%Joda%#PM!d+K)RiVq$=OMAg)CmI>D%vxVHYL&E{aF_MF
z#2FSIwx#E1fQtu`M$nDoU_ohkf2C)A@_rjXo!tw3^csLdF*C40=(+=ksz5tc!o{ZJ
zS8;%|a<~FOtOp7#+P27DODzC@^;UN5MCL_fVqYj575#`1n}s+F2ZDs4qm_kl4wkDb
zio1%@k7@ctokfqe$EdTwqu0Sv4$acfu&`$SwiH*f?yU*Zw%1dIDLxE#i0Dfy>&7|2
zZCLD>G?H}a`PV3%sQ3)g#J;O>iXzQdIT$Slsg+Q*#sJ3wyt?~uBtRSxSYov93Jx$`
zBzlnx-F`AXoznr2Q|6NsZ0V1<uF+>EeBpSydNV(uZb=m13pIA&Pzu0HOtXH#VD))e
zo70qaJ7Wv@@^gsKc*N|^u05FGnHOvWVhi6FmqF4H_```H3FQ)LP~R4<&ky~c#Hj<<
znsQX6;w}A=!x5Eqn{Wg>RuV6L>CXXz1JkH*OI*@hnCF2Mt}FVHd^+-i-Kd%r!hp`r
z^bK02`R-x4`%(BS-$1etj0P<=*!>T}vz1D*`d3(aSb?r1s^-IfuLe3DI|k}zVxN0h
zlhxiP&VW6+x;_^JiC-Jq;%h~t)!iiXb*_>kR<PffmY=gh9rlJg92F;oLsgWs4<C8`
z%*NNYII{QFusjFHU?#IhR=1H{3gI)F4B-aN%Yca4_EW7Rz75E{XPDUFDEew;t>l-Z
zxB4Fh2%mgVxJ`F5-2ma}X7T6jdJaOV*TO$|2PscG;MIk77d1MWB=XB{+9w)SiH38^
zby=KNncYpKgGT9FFbHbQvP(ErnjTRbu(3V8+9Td!g7Vlg!Ibf{_=GH0CUO?{IIUTQ
zEE*}KXwy<8hxkx7r;iIVg@4U)1qe6De}4>;_7b-{*3>w;E_>F#sOoQ9uOcB6O%8AY
za3GkE`@jk7Xb`76Hu)27i+6RlmL;!(>vsS##O_7YisbBfju^U2QG%B``8Sc?q}dVj
zP=SC8%iP&4b$G;&7(iAGzq$kILx2`{z;qm&b^h5=;nzGx0Vty%ilN8|XzLpd7=WlR
zIsS=Ardck-l&Us|jjR3f{7xN5$WPt`Q!Dx5%<WoBmqUL4(32{1W2x9kSnI!LF#=2%
zwr-uB=dB6qnlGh169<=U3iyr3o}VH&S$N@k$GU_qxxKfDYm7GQ;5rEPWgSFP7JrBb
z%tDPl005gIMcL>n@mPmHN9i`mXt<p=;G}KbQi-1xxH`P6*)$ZQBR!n|$$|VW6CA*M
zt9W@WK``<88z(lN(ncMPqd$BwmXWdpu#dmOHBhSM8sjXv*IoqdHEcz7K<~}&Y9rX-
zWak<sxi24K-$)ks1F0U%I(-<FVO0BN>`oJF;!Y3PgcWDL8;POdzJ5e*aX@y__Blj_
zA(<UwyayO8Bs+m&0{PQcnh?iXM;#URlL(`gzF$;QSp>Ut#+M)MItwpt*uRPr_Ghkj
z(?7ego4QL%4wVzH^R-L*u(aqfT4ouGcCF@lOAhrMJ64^FrN!}@TmfGeEkXV=Rsf1p
zDsk_P%W1#aeJ#wi{tiR#bQ-}7ZZ;fI=AL28pd_e!k4eO!csX}8wvLZKDbk|@^>${{
zRr&$Bh{ihDvKK#nn>z&vtHM{YmpinI$%9lEP_U?k$<}x;^Q_Q1`NG-o<EV}F><0Fe
z3{>5%=68Q!!J+#h1zXvGW>WGj>$qeT#aWi7X)-h};ZXh}J@n0aEh9OiNl=O08wd_d
z^}uVJ76L3fl!E~|%H_p+)<N7)((Bp?ZlXp^hIIMa(~l8r=l06_xGCL0DRI_jF5TmZ
z9b`#dr3!&@G<T!L1Euu&%;7Ry&IMn|%tyUly-KSq#f^|-b3p>6nm~mULlqZd=iy61
z2UJRsf|RlhDy<j3m<7l?34>sI?pb)Zgbsqg<O2#mSQ=9@8mWw0hO^vir|)fVcPhDY
zAp;dE`7jQrIpx6j66|zuGC`V3fWzP!5bU3ocds~a7diXGyZ-0?BB_3wffOZz%Sq-F
zCVd~VvaZ_Senq^l`$XB_j-Yx)x0Uy#7J#OSNy4V75`W@Vg!Kn<gh?x!!Z>qC!}B%*
zOxttiv}c3C#KWs8MaGILhZb&r0<ZlTB|_3IjuRx54z2<v-O{ur)l(@1gP3Ohy%-8S
z9k?urSiQI;RLfuwZ@<2!*(BMGoRvB96=dYcKwf-!$3e9gkdy@OCoEvCO#+CELba>k
zN?7Kuu{Fama0{!28%z=GSXt{t$5}+!53Hp)|5#NKRyiFT>FFp;%RJ2L0O@B#0;3!p
zH!5AgMsu-Be+uc{jbw~^)sQWbkBz^%g>=!!#xFDtm0o61x_d9%QR%9hvCZuhj3p{N
z${DtkGt6wcwdd^V{M}#n*n%~2o4*KJi?ra#<anpwC_m-!BHZYbseqSz9+r0r)^0jm
zQ}sn7QKkEJx9utYc%UqzZR*KoRDS+iqu9JseyHi>U18a?_Mqfi#pvQ4AcnEMIahJ|
zZNRTxjLCj@_ER?y_;-C<eVw&IiAscYC+6;|W&i4U_NRNx0(%2huN;83g=uKL)$Q!+
z(~X|rJ-p+h;4OK`)-@SjwP}=KTvD&MuJ_=!fS3rv(#*OgAo`S^^V8nd12x!cL+R#N
z>`V>N2jKzgF{eF_*t?r0Nt>Rz1MNW3PXUI-T;GcCF&M{J=dd`p8z4Hdop?0Of0z=L
z7irMtSes{aA*81L>Ft~C`?r&*Ks`>mVr+we-C&8#+|he(Ap=`TwHr5`;}=A9sXelM
zsx<_%L>E8yz3k~vR1~R^b2|BO9dAJjSHJi}tQ2wf>q&I;>vx}1(>cHq_z9c{$Jx^D
zSwZUvf!xbOJf0J<X71=Xd4mIM4~M$;^aUec_3C%FX}9WMqApQs2|@LLNzJwoAcd(A
zn<sS2mhF3<Zvyzz_0-EC`^%@!O>(3Jheh|f#Td7>Y7iF45DS<O(-so#zIFcfP@u1G
zm)7k*mR!M}&Bw()F_msKSoNMyJ+~^f2HK+FOM2LNRzEzu$q_VUn!nH^FHWF!@0RK<
zRVx?2L&T~f*tm{=Q6g05(uieZO|2N%YO*URQN?$8ejJ)RC}|~b@(I?wq6BXGN@3&|
zIRes2B?bgqfp#3@*$jPwZ9bM}ffMc{PhJr}9>--D=g~gwg7ZE>(sHTT;cG`CGuLyb
zILbJeF_ZW)vn!pVGP-AJO`$Un4>1s9gBY@}fqnB9Q>IJzI6)beKdEU4mn_F`B3jPj
zb_Q72PZon{!4n#-V$P`BXTnwTN+mSXJqo`8TITHMHu9Xi3D6Lgw6|BNKq<;_Y@a|v
z_2X3Uxx8sPwKP4z?CNpyY<76u&k?q~>(nakWS#iMKOAFiWI7FN)=@G7cGeZPJptfg
ztl(rq|2*y|4EEf60yGF>fvEoxjp?Jg(*R{EgB#^gQC@jC3It~)MutP4MCqSceVN<~
zl;sZBvp_e{LjZ+II3RbghXQPP&V53&#j-{)G}YF1STp7)ic&+E6a=0@4Lu<RDmpa#
z8mHL;{&UA+40*pVhJjT2xrK;MfQ34}X|Mn{mF!0r&D^r5U3)lTTfpBhO?(_trovmk
z-T7L_*8+WW3dT=9?3nFa<Hc-1G~hO1rdQyT>_@>Cu}R05fqwf325yb5L1=hzH}_CI
z*abYUkgv&myb{J|By!|y%H5Fxo(0)N8>uQz8*UQN$oR_)jYE!;HzzW{M)ttfAmA*c
zIJLMC&RQSyZ1@Xa8JAYtH9}-yl&G#Z8)Mx-wwL<{N9lWGN^Lbdm7bA5rVy%Bb%rQ(
z7D!hxW?CF`^JooHruEm=v#|G%3qgzEd<4VW5xRDx?p00n%#Ts?&x9=EI(B(gMp}?8
z`3T(YPk(+~$p&@?i+e%7<B~wuTlIyV913o;bNfPscEy+FAZ6V@tjZewXhMel@Vl>w
zGf7f$mRDY=^<()-e$;Xzb9JRGCtMLpIUtpjfWWE)X56f~hk4*17`F$<L5eC!7@`0k
zX^`&^igFXU#Fz`y+th~DB+hmdL(Q$8pSQOkvKb+U3f;i*k{t4E%6TSvN^!^n&NAU=
zi}rr-mEy2c00`z`0h~ta*BEfI_-pn=e69H6RNgIijY|ggP4`8=@xz(dX`#)Hn2J%^
zkyt-epX6GCoU23>f|PRJCq}bo#eDgRy$5TLio(zAgpl^JNPDgCmE;4z(-cCXv)=7E
z62uGkYj0LGSS($fIu{xQ^#Cn*U({zlwCv`UNz1vquruXMq6h_V-EUGPR#vBsnTIDG
z$O7_63;@#Prd=`u6bV-vp4vSX(mPdK{D5uWb0yEWmuQ{oDZnuVZdf_YgdvbsSV|u(
zW^P|yat*S9?zBOc;MB!A^WNowPICSyhj;=Krz=|9JnCXz5d+|^+!VW^6LPaQ8|ltW
z9qGzUr48Dojk2|LE|nFOl28*pSX&2zN`ZSoVmEy414Iad@tfORDkt(MU?Lfn$7a}B
znp-Z<A6~P)GdZknf!4xCR6cntT*B&2-q8<%YlQCoTWx^6Hv1W;7(`#E4p7d#VHSfC
zS#qyU`C7SC&Vc#?3pqvc?s!KgOY%df!G+mPoZ%${FjgwP**@Iv6Zujw-h9ir^i}A#
zj@XyxeXCxAlc4%6OsQK{5GJfkT$yozFs}fovY8G#DN6oO-c4jTZ=@Ak<V53Vj=?r~
z+2AHJiPl+#yn~HEJ6IA8Lm4QB*Qu2C>#I_+%ACW<!*0xL2E1H$=lT1L4NId+_1-y5
z3qpn%21og5$IDa^aQQz06sUB63bnc>BrXPUS)fh)2aL2rK3b-tv#w%Md~r=CF~@ML
zKaqql8d@f`AJ$Qj;_ieP1jJfV0*|9t*0gX825%8S%WH6fTQ`As<7bit&PYet%jn5l
zP+CBHMw!K9+~9DAbK!|%;HH5RYXF9R?ggt+sPeU=g5)oJkb8(rMz`yHhd~Boa?~ym
zhnICK9B5Uc?nQjppGaM2cS4we!@MR1tnD|4p$pjk8-?j$Cav(2XVR~!z=|n#JvG{X
z3N6WM2#HlrK*`_3ee%639qSdB;pF*xjLnX<<z5YrryOJ~4pLeI)D-a&_pHll@cNJ8
zMS-}|m*y;XzOus=-=NOke?tJRIda_kI0?2Q`50*I+kOq>+AZUK72RlZg#k;5%6Du=
zO7j6Yb!*6Dz&8Vo!%KFo@CeYz>Me!>PB0bjlluY6w*TqSyvBh=8#fUa$OPO)bA7+v
z7<}-r!5FYWC*>!;?<^g4xC?n<*IR(Y#PbKgraQEUU=@Q#Zq3X!PSTw<y}_0n;3-fG
zUHC5Cg8}n8QrsG;2OTz#xqg4-)|9)K#o=S81H~a1tFsLu4;J$+u$WcJ2tFVH>zZc5
zsePgROtU;}tpjpjK<c{QK`^2OAkWVL;S@5=@25iki+9fguNFJVd9Z+k_R?fa#RY8*
z0IT(8_52H*1*(hzK>xo1sNentZu;;S+6uy({S!zELU8^gYU_VPbNv%Y3iN3B%wG-v
z8!iUWdjE*Fg21qVmGIx8xuCH1-{E3lO_&@6NSD9=|Njx*?H|xw<PQS@qrc<VAjIT9
z;^6*|@NWNrgM&T{)DQg+*cpTr=7R!z|2Ob%P=xbuz&!GY{nHQwym{3j5PbbRK8|dm
z--q&am*mpFumEIT(>q}A1H%m%T<_A4(15tH(BEKvXGq9k%ta7ZxBd6bAp;Gy)1IUK
z@Sj&d?`ScX9R@JRE&y}90VyY-SNXoe+?Bhj$`tF3YCkoAsm}Iq5Fuo|G{E%fL>x!x
zc<L-;`geW&g(8o59|1_aNSS|w`^cRK9rLgN(c*dZ;5UY~hZk=5vZb#qEjbJTtezLB
za7mUk{S#4`6RkY7jVv2{nN6=tEyaU@w@yu45l4%}tTv8<SBw1n)sVg9gI$PXR|;gy
zvP$9uB%f;Z+JAh}SD9a}2nwCiJ?p*s4anB227@i{BG^GrKk@oe`#^>?m8NszCX7Gw
z+ByCRBiZ!S-ROiEkiFP&26*vbio<H;LDIg6p>Mi37`^k+r)D&1&@|nLy7zp)GuFZE
zZ~cZ4kNQa1U|OlWT5d*Ht-Ytd?Jxi=J87~X!{EPEff_+0_c9GAuips;HwMYeKaB{{
z%0fY`?ixhmDGSfnbe-$1qa9Uk2H?Hgf47Hr2hk()U3rZhae`1mH#DSB`a__kud<n~
z^Q+%sahe|vj29?{4<4dMJ^^4nj_8K`EKo@3tJS$R;@upPav*f6)U6iT14kQA?;Clr
z@G#nR?H_P~Oaf7-Jnn3k8C}HS{qXlj7Z9GqZj0Lv`Pg}#-WQ6ZTFph=j7um$Agi*-
z4X(fb5F9RoAb#Ra)2PR&10E9Cw=z9pyhb>UQZmMrzGhV&S~n$<c+4Htg2?$rp5S{r
zpo-qNi@*U0^=hduk!Mli$v}37m7e;z*~A^tV@$A-`<U3U?Cp*uqo<}WN9Y3?C0l6!
z9j4)pE#bdXu-hfJ<&+_@eHUa%0?+L}Hhqw~2a;5j_GNSZtGx2Qx~N}5f0@xbr$Ac*
z;D+Ma9qW&1@WZdX)i(MO`W?fPVYq6s+8-yCsp6*n`Qd?3!dUHn!)o>NhS}ZS<YDRI
zvLXDHt=GNU?T&NfWC6wRMH}~&pc=2jy4~zJBj3CXY$<~s8#it+%9<cTdt$CEpDX6%
zwWL>K;o>O{-=Dr7IqG@&il>;7>J?W-CZ(*#%{O#s%KCNa39Qb?ey}85eKI{@k4Kwt
z2kZuWk#*U472nuVP*ih52gD~rr1Eja^L<po^%Dp<gYGK+61?Wo(PL_Fg^a2hf3E8u
zne|B6&L>H(KdxG-Jug{kd%k@e)9+AW+%WSEMDT`-`jP9KyOk$?2#_hFPg8rSDZR*Z
zxXS<uQ#n}`Gd*Evzx+tBJBm%mm5Iv6{m8@VyLdCIuc`IBP0QmFpS@grETh>@E)BX6
zSVeHsd#}BNKmL-E{Ij3Xfmz)LO1l+mdR`0g8AjpfjNl}3V)TR5AFFPcLoKUh!%Vk-
z+!?!>IYf|7;Q89>5PLU}cD2%kzhsD@NzFzhyq(vhZn{)?N@C5rByW02PRl}KxY<8U
zY{=zq;91O$i|zs}c-PUhu<&|vVYh#@{VgfCMefnn=_MtzUObzs^t`uQ(&P=+<FCot
z;p0pJ&nOOdLi7v6>*Wc0=h#$uA{q^-cqo#cS10XS<q5&Yhcm}IIPN0jCj@i@-e2d?
z_Qbq}ISqGT-({}NW1shCcdfW8Aj5u^VA-liPhh`sY3!1HK9Uq|nkn(n_QxN!gSM?@
zH{!6*J8bcDmyC+ivErI8m12Xh@-{L}UH!yxEAsAIDfEsxgpz0UJ!%fo&9&zIzwmTQ
zDgD>qAV5Y#M)`)Bo;wf%L*((Kl~z?t847ZaeKc*f-xj$orBtINnbU50+o4dTIVoNZ
zRn&*<u4EKVFZ)oWyh{BZL2-5MYk7AyL+>*kiz;sx%r!Z2gJ;&XN*WpFMApfAMi82m
z7fLHtK5oNjXFZNAwlzqYZ6RcY8u=4kGC{!7HXVy|Qqa*@T#qT0zs>1dT^sg!7cjNZ
zmbNPwy4V5Nlnw+dwGMgvF@pnQ{<HDXW?97b`B1I0vN<`7t-dkeIePWp>j|bP)zaSd
zHTl>9UFpM`TSz&woUA~3xpx5@<4qt-deh|Ri!7Gf;ZZMkw%j6pEoxya2hC*7k;1Zd
zLS?rUr8Qq)UW%@x0{{3mY#t~t5_~CV5@vTAs(Ex40=!=w@yjoaR3<Ty1_whpWn({o
zG%T>BnZ8OVY3pQ%(CSymg+9-r5ub(uC(Xf1Bi~4CM~j#~n3us&Ql7Q6m+*(DSV|Xi
z(zY<tFf1Xnh7Xny8@x(;DLrdQOvk64Q;^X6T+0?7bOB%<R9q*hz%4o&!08oUZyA^*
zKSxXVdx&?g)BNn1zoS=xh1c8c*ox^jZX?+>3*duS0l@%^qO##tKqfL1*<-ljftUx!
ztGZD%Umc~=ut!$*QZ|v>Zd%tyjgz%f-rF<Sonui6Hg^JbbL!u+0uuu=9PUJ3a8AiJ
zkWe1|+V@~vauOYGz`gOj;SW1!H*-vHg5umme^EA-Hh4aE-4C9Lg=6LlyX_aZk@<a!
zf<orj@m$QJ!=tbJkg7^{gFoooxnkxld1nX4;#v;hWK0t#DJn0l>PnK3{Y}NQJiRBj
zkio}~Vt{QO0Sk0kV>8U}Ua&9@ce2bXTUKx5^NU+7I_2)Mk@Ul|i+$>|>dWWL7l3Ll
zQJT$;Gg6;#UiG`SKZxHWu#Xc*t+-k2JSPocxw=NM=3UeZ4XB@OY{Ql~x{17!)y^kF
zI&zo~KqL6TOfLlT-cDeq(<s|BC;1>?Wz(G7@v75<#v#|5jPSaG4tex*sXbBtIiQSp
z@}32xar+%>bgc|9*WguK9aCm%O6V0rX`gUh?qN4wqRcCPv8eOCj{LqXI#=V}McH`P
zu~RRxcB$7qZh~}$dtAfL!zlggr_eN>FaiJs`{pxyujg&ybYXM#-|xJ4;8Ki9tb{o@
z9oy;73FI35s3mu~Pi#|`#|bG|C4=in4k3yW$n(U?szB-G=5t%PD0(Nyq73JZZkCfb
z-0KsLdh@y1l{o7a(h-bZjwWNJALd9nttOBvVQeZ(w#L${EL5;=rz)1_^L3tA8oU8B
zQ8)JvIiPYIn$aAiw-*XEJBaS))+m;F&v=gwB<!$=%2U(u37stk6OO2m?IVFV6f}-;
z?II+U({)&U5+vBWHumxp&m-Ikd0(v)+l;4gMOo(E?^ieI9}*aHEalSY3TL0boLg}a
zr4Y9zZI9Np@q@e8jv?0xM@ZN8#BbSOZ97{uWcUVXtAgs^hfm6CJh*QIJUyusU)Ejn
zCSeU3H`-H7!^ctdY5f{ydp;+utNNE7$=QbGOK@u#mPzUxud#Vspe`eFVP7xaML6*J
zmW~yKX-XPomu0K^%vn`kc{z>JyU`MVQc_R)y^R)QIf9La$Tj~c>D`K^fAyH@YgzK{
z_wMkEBXVyf!Pc@Y&tj$x=0xR&89(7@rkW2%JRgZp%9%|Lt`Rd<M4LOS{5toAB74EP
z&rLq}slZ_?x^2^MLh%XZoB#AZ@eKb%qh!YvLoqV-+KNG6lOm{v?B=Zk^@CyR4%7MM
zL?6`S5xg~*n$Kg@ZXtf>rKJM-&9NGa5+^9~)FJ<DH9w~0TvV9~H`|f+Ox57i4}yGX
zA73Ke@Z8<ob*!We)P)1td!QO}#X%n=&7Z^HTzIc?NyecdGO84i3SRbE3(~E@jk=L7
zQhDz4qZv=IevcjR7F{GCxgRyJ*I$@81(9pyy}d5>^&(x8_U6lE65SMG?wmc!S8vkU
zUHoxC|CgHejRJe;3hEC*;KFwF%i#0kYb<s)03u1iWUwtv*XOrM!ArzvDpo(M@ceL4
zB+hm~OnNI;Lnu~7<_G26M8Fm!%jWKdh+NIadS9WD;f<A>P!PsRwn+V}bigm74|G4K
zdw;p0%nH|75KPO$BWGK9Nw*16i8~t#9N{M*vQC@9Yy9^34zejNZ_Ov!2dyhRHtBK#
zY>$<j$kU&6MIhcK!~xRE0j2wB-`)FR8x7Cw;RWU78JZ_S*eNpcCGg~dc$kcC%k^+Q
z6QFH@qbY@3=|-KC(Va(@pZN?!8@>b?RdGlWkwSDIm7jtAZnJB8;v04h=DOnnN-Q($
z0=0&FA>eXsb0E%BOk%jA=`<jAQUaZ!cbS0P`37R85xK}-831zqMsxa?<9!|!Y6!gu
z=ueahP*nl4kdH5!{shV;{0G}eSa&H6cr;9hz(e<PSq@QO24RS?br4|&d@Py&L38@$
z!L#vfbbW?NoCLHbh1bv>l?iNl-~q^?1uy!GyFvXDdXdNBe`o;mE4ct#?C%Ybc~rpj
z{*MNLf8$H`2mjUp*+B)M0O&>a)Dtj?M{0dw6TS$&NDF`=*r1vf|F2C1L4`nNn%^mC
z<d_1m_1|p@+4`RvfJk}})$BjM;D0rd3(@uOUqI%&l7kKZ&7l3m82qm$B1bv?*1(^>
z_kYZa|8>xSt^Yd{fq4zt`v1nfuImcfjW<2N)MjswGcy*F`LUZFq4_u}mc~}|4^V;v
zB5`g5?3z5Q=+b(;BYz#y(r*Tml4`u!I0vGo^W>PfD;R^5=*1<+*FVf)O<9(H^WZ0!
zC;2AbKxA%>yz1Kk6y@Y%3KodI{8G)G2JBlgiaa^ULly@M`6QZ9H3_@%L7B{4{_C$`
zsyy!|b2^bg+4dK0wd|p*3#I-8u*%0mm@%>Tww@7qUb0}VAO5zaI9KR(4#>S^wFb-Z
z)M6tNl%)UlVEIE=4@!NoT{aJMPXe^hkkP={M+2T;+OV<zqJx5n6h?@JXST}-mTM&X
zi=;h!x?}Dlpo~HMQ_!TVEddK~KV;f_tn1O)RcgTg0<jD^z@j~8gofW}`|~qK-%7|*
z{3H{wuW;H(E_b0|x#oYqbNO_~*2M`~Xs@@3h>G>K{e`qigR}{19`+od^a2uYQ|QOw
z^Fu|yp3eVMDA#3qLioU;F*5y{8W@fWo#FE58~0CZo*)B6;ZCrx3Ci<gY8BP-K(q1N
zww97dXK4eXQbzSGP)dh`9HDAs?xW0~ErSA?{oLpbC#H*J38lDi#!omE0E-Bu-3;I0
z#0CV}a!Xw@VowPMLr2=4)pbx9@J~HBzPCEIc-@v5dErWWa3jv87?&5OIm7|-K)l`u
z#+_tXa;d?S7;flEpZ)sI^S>(%0I4$`t>fKabOFl&e<)y~3r^_;v71ZoI|_zAUzGoV
z(G^XHUTe2=*9L%I?m?X45c`9u1_W=W6pvzt8l;JP{2RXl-GvDV%20jk^6w4)r4;}&
zK%De;ViXvCRd3zL$_et|49wh(lk+DBbA(A3X`IF~u*WZosSZAdIs<pA&3{czNgofU
zSMaHJ!YP<dRqS^>HAVpXj><K@2a`a?%@y2-I%s$o1N`v+?rLu7xQ6iALzx$W1vGL5
z(A+G!zdgCi7xW#pnF&l=6?@CB<@ZMMBtOP(ZOT}{&egS3@GSiFyJ6=>ZXN)!@*rby
z$daS&&4U7uM!2nDs$>)Fj4F_?48R1(rauKwz~XdM=+nD1yMVw^D4X{fKnB@C1>=%z
z@6Id0&d58)7SoXb7`#=Oc9Hs9JhU7@RQB1!Y5O2}%fwuKV>SQL^0NVhugE_e3-ENl
zOU-=}*qE%k@IV>0{_u`>qPTXZ6HaLPg(EY??#4#SDBY2o5-VLk?c<Op-1^NUYv5i0
z)pmrUWn;_F7oCg5Mz9q1rpu35=8wMh%GOTr8!*z=((htm5%$3-axpuJ=$2nGabuxk
zWL7xHVz-}R*n}85`c4u|8-H*yUrl7dE7$qst1dkMicIvO&cb6W<*1kR{XEJzK54@9
z6k+Y|XeYg4g(0qIKbN+EWXp^EYciyRG-E(sAr~wces{c5ZkH3Lx8U&GVP$QpU^$x~
z)>R}eseaL87Re>mT?pL=T<Stn<)CbGDjh|ca@|Ei!Qrf>0`xHHYe?Bge%ExY$Nae6
z^%BD{Nc}k7udnMg<t8~k^3kUdJ7rT{wq+7H=wC9J2b8l<Jrqe=Bs8)(WDXFsJO|?C
zF7VEkejJqLUdQ4IbkZ%N&)u{liHoJv7bz==3|uUB*?TpO@zC`2-WhEOmID|Apn7*q
zY3S6-ZCJD5l-rLgQ>q7go-fymx{*n$bc9u_Xu%P?=AEOUE-a}(DwvgpryCLEhgW>c
z4K$@j0Fj<({N>E{tvXj?+*(Pul29)L7uTuA`cKLNYm2vr?@SJSEm&k2S;Ia{de@%4
zGU_E6VI6snYJ*<W7>89{a}WyGJi`*PY`IUGfi*J?6E*pA0VYJ_R27=0lV|;zhaWuG
zX}DnX5eV6`MwTxo3~iwLtzLxGw{LmQkJEW>B7^sAd&I%$L2jKPw&SN%$_^5Bf&aWi
z%nP5ZLw$tMFxTNoe-#=ITSfUq2fIwYwky7e+2kd7V>7d+l$eAgOue4wRlaLZj-$H!
zt;>(bilLP4YrM7INI_^;#I3bS{-)p*mOPE*yI)}%4=xmTpI?2c&4pTsUnFK`4Bt4R
zaAQXqRx`i-uJX){`A7VHc~2a?&Qvh;iel`R`bQjy4?KR9WdljfGkvDJD~G=ffYtvU
zt6zQ>c)Wil>uc@d-DjOsh$DSj1Z>3tDtlENQ(~7G%N+k>tEjUXeWU<6>@5^_QlI}7
zQ};EwzB6i94CivoiyahoVU$PP<(Mv+KXKOoVwbi+DKBB;x71+T5~I%|5UW1_L~$4$
zj?Y}+&~IvJXKCpllHa|eYVZ4QC}}90!T-F3b<s>#PK(iP^R(WH-}<Lsx&>&2uOXd6
zNutES*D7UHOKRMT?t8Ahg%|58ADMWQX^x~BT=ds72hbw}=|#q~Bco*x8%9Ty&nuOf
zD@LMQ#RrVd;E~Nq42JBd`-XKX9*I7mihcMjr3_j6VST;ip?q=CRX>*2aOsVtr!r;9
za3={J6QdnY25mLeh+V4}cV(X7qAsIF(we~ulxmvv2fI>%UV@JoYxsv}j}MCm*gu&P
z%E0W1@L}jxeVepQXb>)WGp4)W1FB-7$(<|H0I~Go;FgJVEOhrR!YZE3G4olhVY1-r
zP@Ff;MwrHZ)nQTD;!HnY(ByLKp4ib3k7-oiJF=D|lt~e4@NVHF(K*b%<%#N9`2MMe
z$j&FRgMy{88`~r7BL#J?**}vS!tHc^h;(GKTq;=IzHDRM8!k~UtY%iz+oyBNU(X|M
zjQyQz-TA(eC^gEE$aiVV#}?zhlqboOcRN}w0Kt620}gY&YHx!j-wux-B72!dp+Xa7
zRgddaZ^#GcW7`~Qjt*O%8>D9h#eZFFzpf#Ta3W8MdCmR0V#Uf|@gEIoH|$^p{foH>
zF(s=%8fHzy{vbA^aEJOI;tu&N0$f?WkEo<cM{avb`!S`8M1y7}RD*|piNnjqrH|f1
zY6Nhy;Tc~6T$v^$Tte@Z66d=N6XCMv)(9Coecp;#YMxpL%G|K4dbD{q=->W!3-;u4
zn0taPBR{B?dx4`P0$nQcqjB^}=zF;T5Iya*xo}Toz3yya7q3dWPjO<ualnr?Zx3Od
zCD-Ek0O#0~IEi*UZM_?4BaU@!yh}Tm<jRIl`-A#e?I)@}sgBtJHwLWVB94=@xgVn6
zpBfMO#wUDmUj+B_9pBrRHX)bTjCO0?Pz3lk8z{tn7{L7SJMY8f<_F%PGL%KPG)M<x
z#QDEBwv@Jq@t1x?rutLmS4EdzbXPYvZ4-JG-xH}kR3WVQ>bWy2yfr8<IEij3JWfMY
zdLhS}=aqiw7w^(Cm*L#;uP+0gHVs~bf^*pqwy;8n+U+iATY=z!Q^s<gGA%2@>iFP6
z!L=V_eR~nd=hBpgvZBAxPr}a8gE3kWPtoT+gdA386=7G#tYF{gVk1yxy`N{XXBqO)
zj^4(Nvj(T)l>FGN7LWlIs3Jo*94Sb-*dspomK0$z{l>`5BiwCA6L!h-p8BqVld$I1
zgRB_(VXLegGfq6hv|GsG!Z!e8GyyrDj;|R~4S;QOGVT>v%L;`lW&eCs6R?n3*N1Eo
zAKa8d1;F`J6j5K#NM&Nx(}`yVSnS3TVIsJb*^8Gr{q10e4rxSYni$l&KYZ{){XG(s
ziq*U$!(ipcZF&)gtn!8ctZ?;RRav*H`5~eV?(2{(zH-PF^h!@&IJzGxxt0$TRpSxH
zy$^=c;`jBy)~mTPV_2~vG3*mdC<+;JAeGoMxK0kb<YQwUs4<p^cLh;y`p^`5^Z3le
z=c$?fVrAT086%9&j=gO$LNGmU(=NpX*-NEj{nk>KOf>h9HS9~h(TVD>@YWl|$d1}5
z%cYOuorOc}B~}Z#tj(E6yO=}8G9;aLUHMjCX8Yl7r1P$G{;EANl#FhQnc%;*T0kCp
zbqcelF%$ioy|K-3$sQl1Vcy?k&c`;Flgb^3L0c*|S!Qq@VP`6(9L~XhM1(o@-z-i?
zzld<Tg=}NbpYR|N%1-MLq8pJ1lX}s_ygX6#;EK0;1N(RLo;HT@=P&C(z6E^U58|WS
zptMi<3qK$~Mg4EM4M=Qjc)x5MosomhFZo;*;>ftHdOVkPxy+e8E4mi5phAj^O>otJ
zS@DsQ-<~m7jz2@*vR^r-wnhimkD#qFU*zEt4{UP4`9%1xmR`31gD>&fJW<N7kiH8o
z!lf7JIYeuGtGMsEdb?1npp~9q4`r@xV8LRJ_1n8@K$~EQeYn^9rlNvLm1RN+Cdv&R
zA$}V4P8Em&^5l}@@*gPUnpu^6KC%T!dT}^n)k#eD@ER>g_nQxFc&ye=W6uK}^W(fV
zwDyd!YrU}%K1}mymMT3~5%V8OGq2!!@8l_BJOWRjXjY6&%QI|$Na&FMa>U)A(@Lw%
z>h)I@QVqJJ`__wl<^1e_%;$L+IyCqXnjaZFLggd6*nZ3^>hRsBp-5Cbt&x!9vOQRS
z&l~pmgO%CYR4O6B&_pb_HS&x}@fAH#rZsLr(XCAiq+j?_Bee=wur-76G~K<%*pqA8
zQ`n&+H$BtKa%$I&itn1`Q?*FDHM}ODo+#@5Hqv~KsVqG>xDOQ?9QzhN_sL~R#rTEs
zZgIKqDLVitY(J`F5woY3-~GzMK@zPqAeN{VJ5h3m>izM25jejIZx;^b`fhY*NIjg&
ze#uE+|0`^<w@8qEPY=3*!cCrl1#l0jii&1?{V1pgN;N~&S6q<$l?&N^9~7D^doapE
zjVfwxk8N>{sc4V03=S<1ulJ^hyfW`zVc%91bk1_Gt{>wn|8aoU{d+C5sw6kO5!=U_
z<hn8G!`NS;8>MwMT%t$Q_$$n@Z~gV>AUtzoCZULbtk80-5mB7ClsdDQ^{BKNF2}>c
z6m=vo|0P(JU=E%>9|+Q)(7pKVyY}*V0AFe!@Xn}<dGVva$a9{MJ)@wo5OvqWF*(KA
zLdfp%BiqDt-*bj)9<W;(t*L0SUfm5jx9x*k<LvQiJ+1ZRc$nvhXX@u9Qp7~76pgCe
zS?9k!lvi~f5y{#f5nLb9qQdyt6z8gU?2?|k&0`p)Jvfg#46{#$kiJz6y&`yx6lrDG
z>?K!}wy*z8SAF>}EP%6xqe`ipT5s-#{dv)ChNh)w1hX^am&oViR>0ePfBDci<zeW6
zK0}q5>*Q}MA2+$pL~$I%%!uzEu`h-IM4A4nzPx<MjpJD?Iynzukf#B};2iDBj5JHG
zQ6*=4KA2OWs@6<Z*omO)cOiT(>oa3kgD1}yg@X^eqbbQ(hSBXaZ&!fpBmv^O$uRw)
zT>$ZV;b$NKC;J-uL(7~jr-Mi!wD+giH79@f`pT&wvTLbUN6QUZ3%6APfSl(QDHZ{G
z{N1o3n%rYuyV`JDZVFW(azrGBEZqjMAjac=ggO0cHhJgx9e}U9#|Kiu#>W`ey#Pc&
zcB|kvGL`J^z8sepK6z*ia67!|TIx@{MO11tY5M_<Qt-8N-(a1-;O2`4J<il9y$m>1
zqQ5<Qd0Yh42OJ~Eo=a`<CxQ<)h*6Nex$51e&p-o@3HUpIn((*h{%u1bnTdR#v;he0
z+$XtfFOuyr)$VzQT;U7Y!NJxM%_Kvb;d&8w;@ID82p~<5RIAu9ZfTcOH$(okLtT=s
zIE5-Sa->J|q>%LAyE{iJqG$nLWC8@^g*?}tOl*q4&$#SOehSWkjqf{J18lzCSa&~s
zxR(wSfLa1*+1zp4Y4P_(&ld-b1HMbF%OC1lsPZCng}1q#L4oq<2yj$3i^si;H3L*S
z5z>Ubvu^Zf@(knnX^`Gb&CLv~jyrtG+jW<O6g;d$l^`;S_A=Z`k1ga_whrZ30e<B-
zP`R305aiaqEj+WPfmG#HM&qv08b>+SnL<M{zu8j<Zw*C#A&g4OUl^L4n5e1K0#J?N
z5J(M6`Yq_EOUN;RcX1pUnE97Z78xJ(5Bgak>IB7Q{{vnFLPP)f|KyP1Kj4PQz$ZvV
z=%4UGZy@Qg-x!St4yyetLjCvO{|YPvir{}E^z~1;Au`0~|A&ShA_qkNdnvSk7~=o$
zLc@NCgZ&N}`}6<F8gC#h{CBA}a=aW;bNa`*_z&nm$U^@lM)%(=G9Z3QIV`d}-a1mK
zpYquA00aWW|F(9ty$^+dN;du4Y9dx3MLT`~%Kqs5My0-gePPLwdq1(RzUsW99|(=M
z$fp1H_<@7=a6`6Ztj%@jgTSA%e*4q6(?R#PrS`Xe%>JyH-0#wJfCIMZV^G{NihIQx
zY!PpNr$56EEzX*~sP(H$m|j`Y+1=fn?kSob(vb)hEiDVS^n*LV13y<*(1JsT+r=2v
zU{{FxrP+7q#hV}Hf*Tv`VKV!EDVL^XiW*k8vg6fdYyEu31n0XY(eOk+e9AsC5fP;3
z#j}Y#CMR*JKSjKt`st1Fz?K|9WrtL-&Tvs{?rm*PE@XGkw6>vwyQ=$T1GfYA*M@tw
z6o-&PGPJbK^&p-sbrQ8A2-K_HZu&8SD$-V5+B-kXAE(Z4h{$jLTwI6}d@(Ml4MZ`J
zx`RklQ`0A~7}cI`WbPe2u9Xr1YC;l3B1q&g=R31;w*BYl)KAO?p05jBzbvA{tkQyD
zXPqNO>V<s=0nSIw<;rC7D!&EE+gfiaAHApx+_$0m=v+p{I<U36*{2|=5&=YiS=dY^
zCDl}cektxq;Yd3<iy2py-L;)g_cX9(-v;XyZMQPFw_Fmb*Dbj9(%&5ZB<c~y?L$M<
z#wIei@m2phslJ~4SNlX{Q89bpFR^jm5xa0FilG<h_tok6;O=WZg0eDOq7zvW@M5gr
z!tlBeC_Hn-gC3(i`bea|seR_#q%ojLhCSfBTO!0mmf3HCr#{C&qnI(P+gBI*Ktv!K
zXQWDSL-n6b2E;y<GnO2$lY?b4|FjdP#O)=`bA&0EaHE!!>-t43hI$HXwboG>%c$}E
zDx?!xSY0Vh61@_3eRFZI^Hq<D@7~YOY{9_5xarnxrx#l47b-S?OeWpDaOeu|gYtJi
zd{Vv~46TiSDHLUj>o0z6{e7{R33yMMr9T6GXX_KVOG56Z3O5P!YnZvWrVkm}Z~XMA
z+YgoO{CTjuSp6Wj!mCr~QDW#PpUcZNHcaaGiSr8^$s)LXC-WOCnNr~Ltl#jnC+iyZ
z)7_-H!u^<g+ne=muXcZYoz;>aCZ;&;G*zh_d^b=Mm>;+m`5a*bBn4nvpBiVbTKmGD
zVI<S1$Acqk^2*osF!a{PGfhkR(HrW0Ek)%gN>yN1k#v?BPep6TnL*LF^`|zzlU8k~
zDZeV+@v9oMTL0E6bN_u<#`MC^uX6)N%R{T{#HxYr@**i8?z<9B3HPEyi=)w00}pYV
z$Z=JdQrjpal8SW*P5YR6=F+NcXa{4r(-}{$6KAwSzE?PB##WLnp7?~1Rp@G%d}cR@
zG3`pqxfOK_l^0(<#Bs_k^AGi*b9A;sE;726JO1>}>BX36g-hFV(fwMdwJSV<Xm{qL
zBXSeQ6z5X{3RX*$1c&5?N*^b!7XK{IJZt-NlKA{>JeQ5R-I<!_((SF{Ert>wYTeKE
z)?Q|rGv-;!F_5aJmWH?3GBjoH20eR>xf<PG7h19q&ob70;Au*j){CMWml#*|O>*=5
zdt=4@^;Rk>Wlg?BmUhUSNd95V{N-o)vk{YxclOLX{+^?+SnMix{A1UYPaaWSdr-Pp
z-a%-4H*E)RgvBM^jGR6d)ZL@e$Vc_Abr|o8j#1yPxF(`IYdspm8#20>wLVp8B3oDf
zXu6n5S#cMtu}UYt?5U(`NB2cDIrME(4)%hV0h)mQjNL=v7VS?k&Ulp8(yHa=t_GOM
zQ^{5u7@ZecjZ9?>Hy7gNq5G0iOKe-(&@u1~J0p3cjzioZeMn9azy(|;&K#<s^?JJB
zy1t@Sr;k*=K4R@VlAe?;lrmue#9rjsnlH`(1=^y|ga>I@;=5S-c_wcdZ}yo-9`0EP
zL#hI57nWR`qo$#B6?W*nG4;`))pENAOBsHK;`1JXd}mtw9a5=)`0qv)cfMqq^@%=3
z({3baIs#FA)+_jW3PokP*xY5cD-Bv5#8n-GEafmqM>T2{cM{UZ7B5xwdC~lewXdXR
zp*~z}qcuJF!!7<LOYa_Co{IgpZDgn8)Orn*hDN!gT10PIq0E!De7ELtwa!~lPYHVf
zvdj&$9o<R;sO@FXBd_|Ag|#w3jpzIJkb!dJP26G3gEy~ezKrbMsziROUyMJllEiPw
zXUCzgb8;RJf_Y(;sxnW)qgIbS-vHG(VTVx{O-Y|k1?x1-lFq5wEbq#C7Lt-}@s^_Z
z3o4I=@;>pqc$|;*%O7k!RXZlJ8<GUzBDp+T!Q#{~o|IEc7pg1TrTnMX@`I51yV|l>
zsT^3t&&A!$5N*hf0lyrIojz2afvr6Zn3CsKu$76dJp~>rjWFqaSGv;7#?P?9HN{aT
zV;E2;yP&(Gni`?3>WANGVji^n!wod1htc00PjLz|<^zfzM;=8{i=RJKCzL^`ugj<X
z(yApJn1T;XdKX&Kl&)2!30$4rFZt6Cfs`#(s>2xkGt#%sf7FJdDR;Cw5Bv4$*VGJ#
zPoXlpmuc9V_Y#?ailg-*_x8v3{s+WJRj-OAb&QBjnuz9Jcg#J1bk^Psoy514@4}?H
zpw8HOg;YlhQy~xK)nzrE)!H{MugldrCHR@Nl7)4T_`U6=d;th`ncPG}?9NcgXlhkg
zd1-Q<7>&wZy^wR9EY0f$&3Dihi~N-&1#G`RJj2n=Y<SlgcCt~ygp-b2H=H{*N7|k3
zLvk6XqxD9ZvXHdLvWF2{bKm$(>}lOBDa?B>{6qNDhy4j}zRtm=E56Ls92zoj)rBA4
zcU(K^dRPEVt4-u#Q|=^ru<g+$QkA#*qv^`DRjcT9)Ees3QZ5MfAstf|SLFGpbQ}gg
zpCLpdP?vn0r<~EMS*g8NLP3`DLE`aa6-f5?(yU@700*lc>tMpw3+i{w2YQ{p@$ps)
z7|T5QS~~>{rKP@x+tvNXdy5fX+X>&FO7Ch6oG>I0Ht!VemK3)PY1XfQz2)iRm#syk
z@g_kv*Ka#ZesI1Ty&b2trQAI@?d;alMs6*g>=)CI-6KTBCYfR)p@|#Qkr^>sagzQ~
zr{{pryRE^7Bq_vDgNdZ3Xv>bWRFbKvu~~U4PR$z{W*p-I%r&D!f<F>U7Xv-@kV4&^
zq_CDowLfNG>vBOUzscZNXl`K=5wBi>+<tRwol6_~f+1OB#rxM)FI1YeBsHBgfup%=
zvS{{4!xBwL$dBodxEEg$VzGlgi}HYP>;;xap@-?XwLqc({o;(O{Dj(}s2{6u^Lk87
z;5~Ee(PvRoX7ibr#*xcl0Av#wOd}sru7PMhDch^xv(k5eK<vj>5=9GC>U&)MRKvw@
z$AUU~EQ-rvoz9~c-l|R~_R4N+n9pvS{=3VK4o+$<u_uOW<o!Q6iOf7ckpLAairf@R
zn~Q^ed)<3gk_s?!Q4(-FVz0^J=T2b$sZ3%87*MZAmq+v+@2dJYEW-tbsKib3Y514=
ziLaxQ%Y$o2n```UbC$T*>{>7jRA2GP8f(f2MSxugOWmvZZ1m7X$wOfO_Ja#t0~IS%
zuWF(33DQz<W07QL9$2-Dy&X%ACZOK~QMZu)r@i+MYqIIqM-@@AAYCMsAfX5dD7_=n
z61t%%-9oR@rN4-RAR#6+=>nk%h;->zdXdnigVa!^cQ_MxzrFYG`rduczvrCm`!83L
zXP%igYt~vbbFX#JY#ANkQQg0P4-7wxA{n)vQk5I_^CQ?pmi9821SSP4e2fap4!vp)
z$PX@ep$hx#>h{8wy+dA*|2UB&U5ZA;7<ph{xAMiUJ{CFb=(qs}hTU|U8F_rG{FKx#
zJSkQETloPVS<H7SB>?AE_Fn3NFKfOixkVv`t!Ibbk>tMjUe)VSfOKhi<!9noLkh7;
zg72jG&`&|vKC9d$&K0wG4^yo&>DMf?&<|d1;~__a@~*2egO;NjO^A&Ol-uijPt4QU
zj^^F>&l4h-a~}^bjk>8t4c6Lhd2dq;);UaVJe2=S*}DU`z-Nv7{Yng&%pf)MQ8M+8
z1=6Rh9jjSP!pO&}FDc}p7ZnV+P$hsJ2-CpdYI%>+<J(88bKM@^8d5AbuwN8m2iasb
zZr(C7Ppw4nRhCFAq;*Dx$TzZOq)p?uFpHe3;yyYWI!OAZVEI19um#ipUI)>|hZzQ3
zZ{vEhJLlUcBVR-{@~ZSTP!*`yCVbf+|HV`ZJ1t4x6W@jv;})A2;dpU#_{Oz_9!Kw1
z^}Vido*Sn<H!;_W9Uef}LA6+>!*hWB?`h})V_=;eR;c}(vZT=fo17;0b449AL3!76
zXV*3TP(7)9`61Ryw$X*3!tZTal=OuXpA0!Iw~&E5?iP`iUEY(rPKzy^HM29;O=mc|
z6}4VUYo~`I^_NJ$6iY+z{t(o2))~=blgWJV#h2nAqLWj0ONdu%-BIYHjd)a%;Eh>h
zC(Mjjg^G?j`hym{{_+OLv!Ph`twua=&xOfHSBr#)j3|c*=-mr+%<j(D?RITwkS*Lb
zxPzKd{!9v|V7A*V2pZX5FdXA)FcD9P6Y(MkO*Q=pmUN(Qh4xLHHzVAQ(SX<-mJ}_>
zqQA7w+wlwM-NF~Yb+T7$J~G02ci8>{5k{B#@0m5_r?NI;kTYxB>w$)svs_#a&E!Pq
zy?djxgv0kP^(=RgFc5|kHRucBIf3!&16htAg01>xskyr-BoAUFm$^E^v|lTkv6<xP
zP^t0RJe;?coGWeZ>gRgBUF&x}<k`H(a<u>E3qnQ<({Q3TJ9?(_O)n4Tfy3T|EnZNC
z=hh;6$mnSXe|@^tf%HeXMmND#?vwsvyY(0ZTN2>)?8)`TC0J+QW`1t|o3GZmyC37<
zZNq;Qauhj{nod`SC<+KL2GolgvO<^O(~3-OT?s=Ar&oQ3aTu&Z6|Bue7DnLQFYVvi
z`BNe{xE-f#2yq%6r>R_l>)d|gCd2D-wJ`6BuA1P$Ps=xNCHb?NJD#Y>YDI^~(4i(t
zvAPjYYGm<cZ(h-Gsh4~=d=+nNox(%L`TOwKH@CKYTLoC-^B6J~XLo<K3t1R^I?x9-
zxdYuHPKN6kVqsB{+yx`8a2R1A0WO5AmNmR(Jlp41xG2Ua8saI7*E1aR;kCvsukfS^
zLvqO8i*f?Jv?uDNna%ydx+FTlObwrbUvvtfJL?*$Y)E6#srs#UMLrn$vaXEhXl-+4
zMXiCL1GQ=JDoawfjkhY~N<=*@4EmsOz`9=MEmU-uR`Vu=UC{K6p70r%iT#fpKmIDW
zzd~`9y%A`W_(~uCij4)$iiiT%pUigS+IE~-7I$fW0V=7&*3OM3^H%NqeFi=7E$^+?
z*?b*~<QF^#0Z7w}%`OGW#iHgOt!4ayX!9G)YnLE7pBBbpbPX|$wN&sK@9<R&eAV7)
ztC(rOlJDX)Cu)77z|{2H*pIxS1z%OM*ul-xrgyn@X79NdVGi~!Q<_moD5B+>f#r--
z{-Zn%=3ER(KE_;IOZt}B0VC=*a^*4Gkqu^CHLkKl`4XWbO!2+BFuvQd4}-mkdOi9r
z6?0p`V(yAtQmscOHMHrMc3FhI+g5U%(SZ(%J-_64W6iKyR<iI-{hC`9_w%c?BWEU6
ziy&HQ86jdnJfP_BZyh45gKFPl!oH!=x=coFKFSY$IfqrfFKngA31TiH(0wg&J6>fg
zu6{tJ)GzrTUV2^=k^(YIGEIsLM6laNj2w8!3C#1t$}V_*4{X`l*V9?npbIW99(}K~
zvY^Ep7Yr#&87z7g-eik&9jw{Vgo#*af4Zr^{8sjpYw4$2aWPO-T1xO~RZr1@2LlLi
zFwKsw+Sym--`cV}ztb1SURJ^CBf8RX)w;gz?OP7$GHGd9Y<ufHP`L9qKIHFCk4<F}
zZexlMcVlHc@0eA0MDE0-6)W;hk#Fdr++sqMcYia*R+Zxcof=%Z9xfKQbfGIfm1ZMS
zTtem^mnN(&{L=+>sJ=d|6h+Q{VCkLK)ZvSZpi?k_+KAha*7Q3TQix#JyjxTEdSeCi
zjXU9ek6A11*eA$e&gh??lTn6QTv@J%4ObbC`aO}xdxlP#v7n;ly4cxdk$0bak}asP
z8gGX9NxZkrxg=}07w1tpEW6ZKi7Ktjz)W++c7?>!SWOO9A4(?3X+l{tbpEVtH1u~B
z#D=smN~EWV#Zq+PLNu1_gr+nI&;p9C7HAVfj__0`hr4Be^4?@e%fv)_#5*}F3XYT`
z)z*eVtp?cQEKCA5?u)zCdlz0$R?`Rf&@J6~WFCWiVWSU2_1sm9D(sYHKutau@WTaD
z@p&}9L0uaNJ*D0a#yQlN*&voQ@2sP-!I_H!$b0|<_Y<-lByAeWy=thDRi2P;aRrSw
zxBfqrKbh(i74-YfVN{a*bl;JYKoiA^nX{XIjHBd&r^Q;ioNp@TE2|K5Co1XFt+xgY
zYY?|&mJ+tN9WyR#11N{iss4SzZnc^E^`e?{Uns~GRR^u!zi7I)bpPJ<`q10MUb{gC
z{37p46_SPr{99)W$a31K*9Ai#jWUK7mREWm=v-^4>4ZDV6i;A+Z6WPTJ@LwwPM%*g
zsUZ5DB|SJQ4@j2aiyOHZ^S|8ex@|Odbv}btBs|!c$=gW&bmHCZrd@cQo-{+*(mE@S
zD1xl3TUCBSbUG#4i;hyF>6!Y%Na1_*NgoHHxQSTFd`sH6gz<&YgiR~ryqn}d>0cF+
z#mBt6cr#d;=L-LcA!7*Sx_8F1$w?gFZ{Xt7|77k)oPt}*`PGTUhSeNpLk6_)(RJ5*
zX32@h!ScBLl$11Y)30NXnA$rOVKs_hW|3lBlN^`L_^sr{d+~79vme~n*@C?JOMi7j
z?EGO@8mA@%E~H9v&BRiq6)ID-h0yGL^vEu*APZ@q%7~)uFTMu~putgVU5bzVuc%6<
ztutYpp5ZXbq%O~DGBK^K;WT__@|7>PyWgfOK&f0z<1MZzpor^)i$1&7Lg`dvVq5B7
zQ57>X#wMFP8Z^(#;7}tEQ<~E)XA|xFt_wYU{HI;zV!ekTqA(7-qDI4=W0-SJLpa%9
zIApX-<#B77CgBmiFw%K{<=8vdk-6coE1($zzAHg|oe(LOd#gH(qK*XFlw{j8F!YoT
z%Df(y@#I5;yt$)O)rFuO_h7}T#u%=2%=0_DL+$<qQIry`45Iv}oL`Y9jNn;3p)MSA
z4<lCsp{Cln?;Wuo=C3+sCh=BwWH*(4AxJiy;5-z*<$_S8#pl#eI8-=H7^cfbUvFQ!
zz*2-?dMPB6XO%h3O2FfL+p`6X+PG9|g&elpzQK*TYqSKAA8pPe${FGzMV)7t32^>}
zyiu0(Fq#2Hra{x9;AGaO7p*KN_b>Sfx?5B&x8BYfiEfB^yJ%S1<haJ!=1`tx$jr(3
zHCb3U_M_UjGC7%Q?wBZziw;L1w?Za2O*IV@#>P9!>1<9cxqNUT96LDh+`KwsXMA*-
zBknr4?}L$Fmb7>q16kzTk-kl_r}G0JsBAKr)3lkc^BGKk?Pz^296L(*K)6ivBR$vB
z7x&QKqw&SLBs!iadlIf@Mw{BH`p(onuOz-bNmn)m*6w;zax;^X7k}s&;_-(7&9ddq
zB}YBRIE?aOaAWy}K^76CE2yXp=eHo2!FlLkv!%X4QDLxPokYj*aqT?eji8!j;hl0m
z7W|#VV#mJ*YxV{=WwCBy6_`5%e=tJWrpOX^9DOIe-cYdPZLuqNQ;=?}+XS%XOFs`n
zcoo9TUtuo%{@T2|n~F<c`9dqvMH3MqA&1q0XBlmlE?yDnix(903=oc)iJpw=H)brC
zxCXHiN+{X{UI~UeHt>5&V^cSG#16tveUw|2sylp2X|)^7UuZp`47G`i>JlJiL2N9f
z@i%7oKfZp&a2rJ(0#8Y>W*57t#*XQF#g<^Mh2-&y)rbvT33ih)m~P6qWq{gDX{UWV
z<ha^vfc({K;#0b2FZB}VZr%>KE9u=vFEc@=qkcVSObAv1Tlgzwpt#KynUi%*AK0P`
zbJ&#V_3tX*-kxNQzkscDIQW*b4G(1>q*%*>5Ejg)Yei+Qa0(wag|WD1Fthb7XNX`;
zqNx<TUzObyOf;h4YX)g#>lto|1R1MxG=-4VW0e5G2~2Bq|88o@4Iz>5k9WVSKnTw8
zbC~MZ%_lnEiv~|7l^LV`XOk!z-!3L~PU%yjq8OV!13_lV^+#t&J=p%lH!=)5n+Ggx
z`D+9n`rc;2E?RX-<}fIG?Z;*(QW#bKhBYnjr=Q<5n~<+g3l~~XMVp6Ma%EsWB{YA-
zWWt&+rE98;l+=Qr*@eWnym1h!HM(enT7P8Z{-UL`LJy<QL0)e}*{ou_<kqB{hrjw!
z_R}Q5&ZZ~>&5-~%x)FSs12*k&W$K`M{<TYM^G^2cgQJ%BON|Gt7>1mXOx}BP49^xX
zGcgFuMy~Wv%jF`$H04Gvg8aA}6@?mmaIQzU4s-W7EY>j>J~5$7{BQI}hWk>ZN(u$m
zngZc|?DLg=VO9^9a9THfe4H+={|gInFtShEU7r+v<_6nPF>y=q^<QdCn~p(32@6GD
z<C2&>@j0}L#LbBWRG32d>uor}&tWY@<UH5JWj;T4KhIi5G;J^xt+Gq-#f7j6GW&Vc
zcD@IF$gY5k2o>Xm5$OIh<a|(H%OUGLEJ?J^T$qK~D8Sfx^nJf$pUzacI1oY~+=6XB
zc?Wsb7l*v%N=ZRxoXo*hu_Lx0l(Hcp$^qfVYG(e-!TB!R?Uj@oKoN)Tj-1k}M%8mL
z8+rB?m-N=OsNr{>zn(}y5z~pnBA{T@{5>PNs3DkGu|<j^-rjM=f^tJiK2sJ;Yq=5u
z&@Dkx;2_`}%g;&L>)O(RAK&f`U<sv*m!mQF5cMiNN3~@MtiFxSkraNo;yg5Nxlc=#
zW4Q=GaWOqIYfwS;{_h8NR=QZ#`4GI07NP&#0t``v`pMY!qZQrl%!6Q5ZE!a;TA|N@
zssI4Nn;CHGm2+NLLWwNu&X`5=r>je~AJ(&cQlicMaUT*=k-6+Mu&J(w!UI2t%7l4&
zE$4N&)gqUM_{7nW3C!1x9Sqa88JNaYvIN8Mx>^Uq!5lsNrM;~SCHs9h_4@;~W^%Ho
zWMI^Y@94X2ts-_F!Zrwa+GZ@Y0M0<>G>gK<Dv{FjwlPJ?3K^L&-m45XQHZ|P+)d~7
z<0b_GjG5Wcs1_|8KrP1g%F?iF*0d-?$Xo<#Q#$fCLS?sG1>a$QDb1PdvQqy8yKEax
zJ!O`B=v-^NFME~Q<W(^v@iW{88Z-U9Jb-2I=lY+ss7ZNz3-OGG#aJ`(F$1Y3VQs+Q
zVV_FNzqQ=IoZ?30bX_BjG*&5>J<h7?G8AE-HyJEwv$o%9XfdodK_+u<96gy?4m|$q
z{mQ~8Vg%%_Z)}EHkTwNv%IK?UEF#K(h!n%&Vdsbue1h%0!qKy_)8XHCbZ(VwSmX5u
zMwn}YLk|enrcU6f>qslHo;?y;x3xqbg7zH9H=^Ci^RC%S#mps{xq2L*(NOSnX%^Cw
z<h;fVJufB1?lTT<xZSZd7!k>m3sdF!p@KzxEH1AJ6|bn-@pPS6Y&K37Ot`6~rOB7U
z82P>_c+#Xw5m7T3aAbb<uc?{h!GI;%s!|0+#!j1@(6m&3B9r${vgI8iJdaJ)3jC2%
zm5b!u6*U}w$}4wnX3p_R#fRwn6uSNgeX-1-BBY=R@l<Vf%;h(&+VwvZv92EVEoO@~
zeORl{N$h7LhjJ9#lx4X#cAnup7tI(hMZuYMcn;p=u`5M(Oplj~KCC3nXz}G^u|@IQ
z$Xp|beDzc1j}9CNFdOkCKEH$&u6TBeMskB-Tb=?nfj`BciZ?CWHZxmmJHmXg4!rgQ
z9l#s^j}E+Peyb%J)Em%Ux0^V$3*CR?EdKK5XgAzUWc%G-*FCjSSP$O=7@@bM+vC9A
ztaQi*R}kh^0|oQH```1=P0Am@345WRMKz!x+BnNtrN}!B_e$1G62?2qMa*p3y7=`m
z9*D|3%JRJHnFx{Ss(QEO^K7)MQJ_8ji}q1&k*65bNSucJ&)6Ejr0tcBr{W(uJKl*1
zE2Kg^zx5W^+(4pe%L;<;XMSDhx2Gsbn{|YkTrMyt!|T4c$+B7JEL3rtSSszmX#@!x
z*QP*1OtiX}=k4yZ4^m#}t%BB~a38l?9Am%Se)1%F@pn;!^dRwoz>1Uw&p2qh^+qXI
zPk`^+Q!gW<5$$<UpM(Z`A6!6jE<R1e?G+X9KYy1Sr6($XOMAvvP*)Y5#&V^g`|)){
z#E-4~2Mmaf%-_9=O>!a$JpPds)Q_(=^m$$?wsG+*SZMPORSq+>eI}+`$1!xrB>Ux@
z@|**83)MiM?I&%%{@XpN3AU61LxFp?&hF4$kDrO(ZErJFvh@egKKvFMrsEvD<?f=m
z@)NESm1mL=hA!cin3EsVCjH7)u{?ZpSTD7>A#0Lrd4qeWvwd#?TvB-KJG=Qg$cS8)
zdL1e*!3*JDvinj*dB`RY5tNIJiu5n;yxa7ku+|o_bLjOmluM9q`oY~-E;cXZ+2ibf
z6cxY{ENuFn6^nG%wVq{(^xbj0NBNRDW652+^vxIzho-hpk{un6|8BoDrdcCSRTYwP
z-^46|8|(0jH1Z97*cTf4j}sQ}y4-M=Kok)A?bzM<!Tv0pxztOvu}Rb+NJjQGdRP4m
zB9#Z)RH!$ct+GdK1R8$HrYk0dy|J11Q&_xBzSz!dQQ6;KI?;_E+`#Mm9c&r}Gbc&T
z-(afOhZ2}UNIemHwd#p`z6h2|7=tfTCw&{SoA*r|O3;)IQONL&x5#ee%fhH*>=n*U
zZ)2#@O?y9}DB8_IO9{EsWru)W!xc>RQSzCwZ8GCb*K1SmTSpl|9}|7JJ$b-kwA7(E
z=T@ov?*}#cr&%6QxxF`uPZgA+FN1wZ{qUT%EaCZ>rb#0$+>g%)!Xqp8d)7c>H}tDB
zBqul6fxEZY&z9d!WqAJMmTDhi&{1>(7FS#CBh@R#v=y(+Z{dftS1`WC`$b*oz^{Kr
zP+a+;#-6WTocHKW`lcz5@R`*bQQ)gSTGqt^UWkXV(|hV7HG^%TpH#RKa^gFU)l?o&
zjC&5=0|%#BX!a}Gk1u81OxhHumqJK07aQ=k4yyZzW*(^pR3i%wuC5B~j40;V9oTJD
zYhOxtLqc;>jU^^v3=}+gLtYSuLS1C>NZ8AuU+RVIw~J+wW!H0*@rBZ6(s+31%Q&r(
zb{;u#5zcIAzkn93sqrpA)3ef(h#g^X)on(rRQgLcc|2Xy+WJXb)Qx~GZcn^jFLi&+
zAXIa1zy_@|96cqBWJ(YuUp&hG#WA%NRyo&yuV4O`*{|A4b7}mqi)=bgFHJ$^YiYwZ
z%!eKmF<OSQZn&j1=!7+Hs{Bbq%R`2-SG@~Cq5H*{=f^&c$`5L7`{ROfvP2bEt3|iR
z?wcX!-M5kZr-`qZmcu8E?;34<SooO6F&)TYOj~AtvvdtJ*%rS0tQVFW;&`JhJZ4FN
zw`t(JTjR?wtwT96yKuqn8+4B}d-HbSq0)jp@If^pLZ^^wt2Iu_=T3fxKIFNw;qNU3
zOlk9UUoU*MQJLo+I3ee&Gt85JC`XdCV@Ey4o}}vSsY19<y|98{dht9)(gw#Iz%&e>
z$-F$Aob$4A=#OFWlR=Azjx$d2vLZ9Eqy(S-%1eGJ2QMq>+hFB%sOZ`PjV0Mgtw+~h
zM2cVDc%sk?j&kNiO{|#_)^jiuLYRj%zCjj$ca*j7RVmtBB%x-5Z;(<L8*ClRED(g-
zb*`}rXGbf;n%Z7-aZH8o4XBc|J*sB?GcW3VL2}Oy$7QA3MDtLmG)nFVv2P8q(Cb~5
zPAZrD7~{Pt2jCf=k>uTq!$<l98ZNR}|5ypG4L2phKlW*yP6~dp@vZJ|e$HZXuU?j1
zGrl~PSsnpNP97NSK|;CTB0NWaeEy{e-Gj5G>Nmg`I7FrEVuD{O<GXG(iQmuxHW!o!
z&K-|dZoY<)?T2#^xoD^EzZM}|Ks;Pu<Df$9b-=vhgr`?;*3ilHM~(UbC-FfpVmS8)
zPK<f;rR_73@aNXq!`F*nZ9YrBX*lh8B=uzb)h$VAedMU6&QFF$(l?g;i-exXx2q!`
z{X*^iNb89mIMA1_DEjfdD^;gDsjKO+%f?NYEE!=NRB(Ms<(moB;nX3ya$l;pOtBD`
z&-$)Bt^!Tsf5v~e(KU&FKU)>+HzH7FdamIDzX-Ov2&38!4_A?F7dV&yfio~52SXbl
z(!D&=DSCw2S63-l8fYe(id}e$iE4YwPF|yn8TR%)krq^5w8m!vRMg18bTmpg4S0B-
zy-TetbLtP>Vju{Ls(F}+tE{HDNpePRQzp|W@G}>;o%dq^Nh;rqfuuX9W4|n+xN9?o
zu=~e70B6`{-<ZBYNyeL2Q?KuBl$mh;3@gPv2Xm>g2S+qNle=-cLm2zte?Na9>iVaW
zYPQ|1%Ri>hCw%ZQ;rWh;C(HoPSMdR?6uLhXzv^OrmJK4pz{}(_I!3P{lK-9_RkH)(
zrC($(3R;p2XFcv?gpX3s|B26Vj%nw5W8b_1Zh&$CqWyj^Deud_oFGmA{UEZol<7Mo
zN#~-5ExUV)2MuCvuv_wC0PacoYxxIUsL4U}liT;dcdBeG2~xtE#29lF!8N1XdH|Jp
zpe@z22b$~*;hr>z@|MG-h8=~%toyvEb>vOnH0asW%fi@eh}ysVm%iQG)d*vI6D=~q
z%-*=~;RQ9)e@YiLw(MU%s+a5W#k=V3Wl9k%k`Wu+J3`Wl^qY6~5aP=hUL3`kSjcbf
zb+I3SoBiUf0Hq1(oS5eR0ugImnn3K6SIa5NkT?T%^mVa{(!y#h41ku!2$RTvrhaP?
z%zn1B&gpRBNF&7Ve5XccUp{N4HSYOm>P>CZ>MnSCZm*Xl*{XK8nylmT{pw`5%cor$
zGU#;N`Mjni$3gT^veh}Ev*V*_=V1u`pYV-3Rv9UUQDH0`7vss6Lxkx}_K#9%mXnf<
zx9mH6z5VlOPaaX;Kayr<wfg5n8aN>8d=Y9UNStU4d?XY{G>6EhQL`&EX9HVO`VCNN
z4LhRxc;Caf?yXR@9V0U?l<xDz=^s5llUxSPTbY94iHfTl?9s&AP#)L(t~ZiYpQKyd
z%FoJgEyprDt`$d4J#>&?$xW2o06J}DK>tDWKF!Q3Gs%>%b8S}|NlS#gN`gr>BvO|c
zF!KCa<tS+&<p=fgb#7cs@txyno8g+U-}!^X)vcpPnUJ+cD-QN0!)yiJhMMtXE73Ct
zIkD?)Iixe;imNRM9^x&d-fz_`stwp5!K2vr7(OfdbH#mw<d*pTg-sD7Q8G!fHR^gc
zhS>r%$IU(trim2{H~ajS$iR3wa810_O}v=njtq=T!Rg5C<;TVe9#MRpqMhI7(Z$7d
za)^LWUJm9hP2Lk87JoJeMke;InIuBZ(rs2S)PGc9`3UwDMI>>i2=JpTKNsd`-VV14
z6dzb+{^(raSVs9MHtiFpCpWGe3ecFgJLv~=>K*CUS*J>C+bZ$<-%A{({1pU9>Iq4T
ztMC(<Zf^4<=}1zj$iA7$9XU`+J>r^s;8616&GVJE{^kRR6z1RJn@U+(S=SH^m|RE+
zo*uOxsJN<f^04h6u|S>dn}Gxe4`ic5JVR}JK=<Ni-ZbG9%qC${hm(Q?(AiUPV8u=}
zC8{A7dyVqf9oAiuqm`u8?*ip(4O8FXqNFlKfF%s_ke%6}H=?}4-x^0w-9&#PD9I7I
zvnBgC$iffXoXToc7N@3XMt6tn_|q}pRURwi?-_pptAHM2<6D||jXRFDDa#9ceD5x@
zo$#4kH{tX8Xg|88pe=QFwPD|ExU!#J2y+j94bf8zx9gUK3geaO5%cU&&dB2n<epil
zGg(MI5{dweh{h1l^kShl@+>aFP7iWAB;_lVxh}Obl5;fgs><gxsP)j-lcDfqjiB4o
z;}9f8k_ZM)c4S4yqL*C~Op>LO4jv>Z3+8)I@(Mx_-UH`Wq2*=FUOZ^r&PE?Rr4sJ{
z>Uc5WF}}+-)15TeYDV^@s}A;d1x+`rl+t7S>dL(#O}pd@E*H8)u^X6M*oZ@jY#2>;
zjq>hSrPaG9GZ69HNDDT9=MIa?>gxPxr1YbOnS2xf=H0HkhS;9-nC@}oF4v#wnDti<
z;W*k0yg#V3tCV-~N~`iGkB1#pQZtjxlS)zu#BN@<DTozF_bj$ApqE?is8@E8rB=pc
zxYoqu&0J9>FJDgvo(z|{p)Xm#H~O>HnF_n7?Uuq=M)dbrI0*YXnP%z;#D<qX=kR2{
z-AG5h;>iM^aNH`rid}N(x}@bG)vL&IugWeTQ@>?+WMA6teetiq1Eeh*9@2>LzmgtH
zZD2l?E;g=uMz!S^E6+J5O01sg*R}dv9h&P%gdrp<^6!LL;-;#dMjJ$y4W+|y-8C4I
zUbs<&lIl7VrF6VPa+U&aiOZ2OC4cr>`{VHLY%*nbf%0z5Yurnu-^o9kBI_6vIZ3a;
zK~~0{?ONtaQ09G*I;Z|`yEX`=Y^Nug0_;)I9Yce#UOm_%D`t-OM88H3ImW+V*M<aI
z?GC6uSv&}|eUI_L!b|B8$D8%#qqI|}NM3@BcOItO=iy}CI<UnXm^q%4hnwhMdxG-q
zH^8|^S|jxqbD*IuE{OxFandcquvj=bC|S`?I&0U$aARDQCOchuK!L4C=Va1E1A2ae
z^6!%hz@b4S6#JjwAs0bz%}KecaCX5mmPHat-VyC`$q&y6Hh_UO1qs|f<LRrOWZhb@
z#VNKP*W?q$^Q`ra0!4T|uHP{m<nPWdrU@Ld!O58548u--*Brge1G48w0Uysg`2*Tv
z^qpa0{0Kji`J|gRbp^0eP!OO1<jd4rDuyPKb*sas#@KqaPrB){Yf62Ngz^{sui7${
z^)HNAptlXq*ci9_w-XpK)BX*bp9e`uy`g_9ZjqGY;Sv?_Qkr84;=b1AkOqG)CwtLZ
z9tPEWB#gh8G5?9thzk{!@LE^wZ*5qTJ6}@EM#^$n9lR%Eu{j!0xA|Iod|<s)Ph7&?
z&JZPxjNnJMomk8q#{gFGlpsp+o#ncA|MULa%XLS`|K5hvX=)C~>qAjdxvzBvPMUr{
z2qkNuVI@6W$Ode7sQl9$viKC4{Oq8_9sTo4Fo&0+cfBaH0YQAf();L>buqP)!5+Lt
z>H$a#4)>P7e7Pj`$U%hK&tW7$q4|t9J*vB=?>*<})O&t32RG4?L~r#>!9_Sf=Av;T
zNQdZ7!O?BF+SNQd^>>`$vOJXic`oOPChGp#ivD9tNfuC1E9&EFxb-MeW^s1>i+grO
zesM@)RVd#C?5w3uiLQDJ<FF(JMX~+obR!iQvq^JA`In8K@UsY<zDDB7oUR;lznh|C
zd$SEcI@qGF-q#8?J6irx`oT3vuK8iQ;?xU|ZvuoT#XjaU8MHBM@_*9K{89?$>DQyt
zBH{0e<aL&IS}$eR`Vdi@Q3`7PBXE`CC$p7)^!oD!-N3)HnO)5iW+50g%R-W@3E5EF
zBC*<+IkzAJBKX|Ipia1;%U-~euj#Nh2lH}3C7z0cP_Od-tI`~TaSmi%MZq_oo~)4M
z{oyg;*BoQMIPJ-BaoMCe-@}v@KbFaKx3o5M?eeR4<yn0+S-#GW2OQPBm<Ul@dBeiO
zf_tIcvj*dMtX9BK%8n$&X6Ht%Pur9e#Oa0c&eMx6`W=uSBS-%CeVI;W*#@7VF1C&>
zuL-Of?i_=laLs0yh5wL|&91<`#W7^e^YjFAd>p4ys~x3ckwO4d)z+=*ZXZ+p-T?0X
zdMSZi|03dkf+-cW8J?lN&y`zgKGDesgk#cNX8Y7lQapcvjSs?f5a7h16nQjvpx>15
zmU<lgWC)N#Ja3YIXBM15DR#cyy2Bo^fx-$=!Vm?j@>%h%SMo7;i!(*Ac@lgU7d<Q*
zGSuIhZ(2=89r&sjY{MI(@)rjoNgsw1Kl=S(Q|o<Kz*pU9c8w2aDiZeHOmhL8;J!<w
z`F(>jTkQ0`JKmo#LP6#kRUa^lOg5y*pSEl*PkyN2{Txztj0Qwqph>~hJr*J2{qZUr
zVak&4-5iD=2;+ORYwv%AV|34l(nb-(u3Aq55<&u{rnHz4#tZP;e5b&hSb1N70^I#Z
zo4q%BUQ$SEQt5@3pd6MlYEg19k&U`@V-#BTs#0>mXmHj}joP$e%lchSdl;X{AIv0L
z`H?1)j~y9G#PdBKb&7XQBvt&Jw+;7Z!t}r~ja=okI+0X^{X)J75u~lW0Ubwat1kj!
zvKE1kvS`@-0#f(rVxFfdB4z$=<D*^TXIZLWvoNLK(1YcTDJ3nJ^+0q<8Yb^7M{4~v
zzt|HvVv+Fe+v}k{&ex^c5pQ_?98}(x@WnHcUjw`hnMq-^Fsv;banl4SM@?#VpMSo1
z+Tm)&-awuYt*Ti9LouIJ-X4s%vf0pVFig2fFC%tQZ|h6HEn7Z`SA>yuO!O0$uJgMC
z5!^<D<sy<91r9!jqc;s+z~8@CJl=KttyN}-lghHO`Z?_Siw-}sY)dwmMtV2YTC>+Q
zxHog$M)H-oMYMj0Yu-B>*n0h;V-yW4s$1eKK!3y32d-+=s|=9f+m%-75v7=u&1jOq
zL!P^=9PgHuU1hP1#f$Z@P;0?1Mh0ix>z1fDv1J45cF+~f5No=dH1dX$`Be_F-$oZd
zt(NsV*8<KMAt$ra_!YPr)qq{V2wRRU_3@sjq)$ZMg6sha;Pu*p7kJ06N5?TEKX1c@
zyaIkonI2}9qPOAg&!|z8lhMhRcsju~4h|X~6xvf7m^jI)4Wmy5`M(mUd9k+aCzAYO
zI-$4~bZ55mCsOD}O~E3P6wO@d&;YZ65$fa$0u;|OoI%JQEF)VoEcDhC#b#uizMrn#
z&uC>COV)6Sy0e0b5OgpTg+K{vihFd8I_y0Nw&-l2j+<34a>!3BJS4#K+t4_l@%2@e
z5>4wcTMRB%4s*Ewxc7$(9@2F6r>ou3)?9BsT<|4!sT`&lp)C0o=g<k5fB9G!_1NVw
zy1b#sd)$F}l1xF;%YlE!J2I$5VguAw;^E0H_lvJKe>h6o_ac)D;AhTTnr}KfG>%9j
zgB(fhtf`<au<spp+;(R4I?BwiGUOess_^W4A;dVUB4(0m%O;w7JPpIp>&%8y(QRt%
zJ!&UC_o#HtAq~_c(Hx#ddAL_Rs))&19XGLs#<)ex4#tKWb?W)z!Z<BEES=2;lTVdr
zC!^u-<4#n_!5M=j1<v&KDTs}LZ*;!8nbC!uCI$8$jgzKTKh;Z+l1g*kF*A}8IJG;_
z+-Ub~V8Ase>E!WfXO!z@vTY4OyPCYC0*l7>`6c0Y5jbiQup8s<6F(pLS04xyHq_<(
z9Hu7S<+yT!Pn1HpU8MaU>zL5#-GR9{KadN#T8WO-RXLFy4*@cBi}DYVO-CjYV2kuk
zJw36u+$Ym-VKTvVp5zd~qkDuv28_j&$dDd;kIqSVn=9)ju8{6?5WDNzu@9e`atAJ5
z=kI2hAv18wKheZyg|y6!LcNA9)R86}Cl=$oU7~{gXB`kad2=S$mI<!y`f=ry{oUJX
zk@iB?F|Om@dI}@sybccE;*{gscsCwcad9wz0Ng6nHdoG^Mgt?#Beb(#8lBMRB#B6O
zF}gq9dAx71n2vrT|Cx9r<vq;|&6%wBw^B#?Nez&CpX`tA62HlRRv=j~?GYk?QO#^H
zYW|O(7wi%z<Uh-Sat9l&60*pCuVH_6B<jDO{@2gM#uIli%^mYGn#g<;oFH);cKXCs
zUi{?*g1%g<dV(FVT*06OLL?U0q$#s!OjIDrG#p6eku?S6ZEcyt7+TZFjL$vx#2zRZ
zPcYGt_=7TNJwl__xF7(_Un(;k?X(OPVj-~JXE_hzyo(^tGrInOf+ec9>>F<E5=PgD
zK6C{hQn4h?L&~as8DzRX{=_25Ba43|_-E%WI|VSWehx!@9&hau)9-%fB8tS45lYbZ
zIxttqQV=B$;OPorn(0XnDc=?3CszQnp9iL5?&V&$t|El2r14)qNME@OB2`Tgse0m~
z$r|_JA!^^waW!3{&rv5HqkOVUgeiQcKW;j{w(QLGh5}a;O(^)~^Ch$bNR9QP0S?Y7
zt>=}B+2HlHKY@{xf7?{%RmjXQ%0EFwC0Pqsmb5ng_GQi(n;fo$Z)HHc{p3XlfyXO=
z`b~uu3x1ikld|XORm6(%Bjbp>=Z`?xA%9UE3p)m6@h0>=RbuyI2j=C9&$zQ2I4-^q
zCb8mop873coI(~G4C{;iThwL~Oi+>yP+#o5RRnl4sjnNcYJC%H*$#wZ<^_JEY($^(
zbJ!`&L$Xh+NcxJhNj)6|o1)_ZZ`&naz4LAf#JqEHk9G%m-rVmRo{m!l82isJRcHWQ
zq#7`wtg;#8i-Q>UI&|E<MeJlzy#Feq$;hhhbgX%G);OL?kp&aoRECVQz!iAL@9BqN
z!;lJ^z4*iD;}{4-F8ghQjHsI^-#$h_sZPQH3WNMf21z$Ek&^a+2}JQ~C;Uf7s<WZ7
zJsXe{s2B;<ZssMRKMk!0@D;T)$2bTucj81{uBHWtFPQt_{@dmR1ORGM0xmS&4z<9Y
zfByl*``)G(LI2qbi1<CwCIB6RmqZZfO5iLQ^*=Us8ujn*2Fq*>2~?|SZovCrSO97-
zB^X`oIZ)^S7d2o&eoB<37xx(K-(LsGNsa|2CplKblzI5ck0G^!plAfy&p!PQwbRg?
ze{SiP+`m8Zj`#}j*uM$qUmg7Crr!O#a89IFTc$cm2Ve}46J#?;4yPh6pnvQwuvBZv
z&tS?xqS22G&~5QDMZjjt1TxNnG<|XZOG|72AdvrC`3L^5or3%?lKLls03%^~aT^}p
z$O}NT!XQ)wpjl7>26pV2{;9WMWHTB6q<6<Hwf=)b{@=^|f9;g@|0XFvhkxrW=+8fE
z2=I~rxEM}!{vXDD+|oa-lK%%q_+LBq53A%@QvbBx{2czdx9?14@m|uh)|Lfaox3Xq
zobyHtGwnusnn4eR!zTz09Ge5+u9m*Gng<kiWZRLwB8&IoByxAUaB2&ngtbwLJH7%#
z(Q|qCuf5;k+gwZ7^>c>2xFm9IU5>x7Pu~|;^JhvA)Tg9x+HwZiC80;4RLdKoK-jX~
z{N)t#HzOajMm<6D+F|X}f^I3OO_1`%=#^OSIq%UY{>CXg7};s$Dga|Te?GzZ5EqBI
z3p6KpsWr4j&#Z1a4`b{{V~38V@WmnaA5}+G;s>*uZL29-7K$;oWqz|$`t<(?Zi@Ad
zSYSFHo@CmwY4H+e38SS=O0G<4OMB??q1~$ZRwuk^iFK~|RZ8XuAv?~Rr*=|pr!sN1
z=?S!<^}DR{eN5}aUp78C7tbW7f8=T?ltqf$MyzWVze2NDS$fNqj7#FPH5E!Niyv<0
z@mq3wciRo5>aIHXMp66lua_=fxRo+zjq?@vr#%ZLz<BII@evn}r|NzVS*kI$iT<wF
zd1(kH3A222)lWvuZ-R3^{P1dpRFq%GmzUL7Q1MMmOy%ZlCf9Hqd;=wLqk|Ye9T7^u
zCs+LW;<<-;e<RML2P^fp#0b?H4KNgEk>u?;)j4uKg@Bmx{zqnUX`s#$UG!YseFx#B
zhN1y%^Z3(W;XQXlhV0~Fi!TKVnyqow@LF^bdOi7q5pX_<7nm?;VZFZMrQ*i$;Mw#g
zH>!^3BNdR%z2T1m`5*QU8f|e?jyu)XB7=pMVS{ZklJp+AQXyRgMcw;`qn}N#QU!Kh
zN^81X(sGA9K?Y;oe=137Xn8aEJ-4V{Ub2tjtI#V6H@%Za5{hFL$$!-ObiIsG$x#k_
zZfPVY9dDXjeyGcit#oor>Ct`>Jv8Id)5|yPlv>~*=P%I%N}7_c2HgV5OLrd80Cf@w
zgyG?ask0pR+{5l7di1|1tD)$qVHxfFX?pE?H~q|nM2z#LwD~&O$%Ss+5MtprGMhw-
zYqLF;v`s~&I=>zEaa7NbvpxGIhw9<)OYXSY1V@V^_3w8t1|_qk4V&)5@$tMSX-@Sp
zrNY9b4@#I&k<6Oh8hW7HRMS*|O6vR%^pi1|U+c?!;CLfQBeDzf^YbKVZ0@C5ynYoL
zu8fB$Z<Shj4%Ui!uKi-WBKwQsEn}-9jIit7)EoPklX9!NyH)@0NUEUwdiFvp#z9_f
z5AJNgR9HM^fi^IJ_lKj|Ap}#Wa!8I1ZA`Z8?S$avEQ+U?+KpiJI-ju;oidD0N&nCt
zW-@kMru`zvQ$Tm#ja+$n^#zPh;A-R##l5=>DBNuuji_M<5q#s&Ljh*1T=&Ix)?Tr3
zfC!KNBhUUVyu@b1p6^}HDM3egeBmplL+b;M*A)f%+zKg~p}#K<`8n|2{(?jS?3^a7
ze{Udpk%6y7sBBzToaT^G0OYp)rDuE(EL8jdu~6ASS-D{IaCaRvnQi%C$70z~j;QHo
zsf}Kmg_ehB8m6^Qyma?jolp-v^nKIS+YrQPy2p|*UiB~Wvc)&GpLAg$JF`{uNf*kB
z5|{=h7$TJpN-#JO<yyb#(i$!1zV+;pKTc+B>OLJR3fi&(qT_kR?c*48?A7kTdWG1;
z%f?GxeU{oc{n!baMG)>PK(%U_Rv)_VT{9YI&8}nC(0KL2hn|-Vh~cuDN4!4YLN6wL
zq(-a0hRws8eB4s3c@|9x7HMo11#RlV=B=4@fCGY@y?k;CM!qnX&u-5#(!tN$8BWa@
z2;icCrV`|{9EV8_lOPSp?zUiIP{6thm&nj3mI;`JXMr_)y1t<MqGm28(YNz@@rK22
z#+W8=0;VR;Ec0<Q>8E0v`*V^WrBp^a>^i5}Ct`75{Q5_KG6!i0#SdNuP!CHFyaV$M
zF({#1v)uf#{uBT|Myu2QiYSgG39?cEudw+Dn8RuBj=d7b`&H41miAh=)EwRG7LQKt
zObzpa-8+*eUoTjP!^p%9>z@-@CslF8byOwk!zy;qtrWq<F*|1^3#%Kg7xwCBjhE0y
zOVJUvpP))GDQ5Yh#8SPRXFeo2p+346aFPB5h{`#DA?MooVS;5iRk`?pUiEuYm!;EO
zEu%-gCx+i?ZgKDHGo0UrX(SZNO&<<D_eEuw@)9FBBbL6vbkA%MRFiT}Tg155WImR0
zEi;vg^^{>W7Yvzn*$P9O`xN$i8looWjEZb9muPkkMxToc70ZsOp$#khG`Moq%j5gK
zov*K2;j)6%9dHlv-kNeP3vbfio*S??B-mX_6EjiPFjp~!gw~2Cw0;A}9AOhD=`O^`
z^E1^B{7d%eQvc~YNj6nZEXr(GkOA*QNM6>I{ZcK?>`z$|P5Jgy_M*ADQ<K>+_vuyz
zReQhl9NdC}<6o2cub<uZc%@Zz-^spgPs8t7#W&66r8xz~woNyQYu3USEfH<+2Aw=J
zFvuGVakU>CrEe(RUoPLXeC-fn-%q5@K$~fncETkB_gOE?;?HaU0(DU*)y8}w?hzAm
zt|R(v`3037aY<}<Whd4<+n<)Imc26Suy4+*m21zE8l^w7ZmH!aw4PIT_M_c<I(QB3
zCcc@$90#KQ)ag6G_>7YdWCe9iJOI>H8D|oglW5`)?_EI3k_&fJojkaV5X-ka%(|mU
zq}`3U^Ghb?M{d+&O4LPF94O`UMG4^O9w$2xv4vD5=Q$tly__uFJ(9YWQ$$f`b+_4Z
zNwh%$=Ab}mY&kv(jMzt}?hsjlSw8~OIm4ptMZ@E5aTz@o7m;NgY<&SZ&&Bk=z<ERl
z*KI((Hz}X_Ur;+XKyY~44D55H8{LRcHwCqX>bxMb0bV){Xn+YXomw{D;e=#=sH{#=
zoSy-eqVE76>O&jc$G&xkovqwFp$}s>b69*s0ZtVRit@&bzXBjO?n|3@-|6$sc0|4}
zeYHva{;$s?q}~Vq0k(%u$zz-D)nAg5Oy(l709uLj820eW#>~ZhE$BFpS{H$-693<r
za;HxQU?dtje`|BJ9O$c%MH|XidgLqr5~`BrEz<uMf(C;tl5S90Wo=0WqtKQiaY_(D
zu%MX5ASgTc>jg%#4e1iY&wdqF3hl{q7Zp1Cd4ioo!r*!<VD6$NQZ!TEz})!)L8LTQ
z%+0vmHOa!bT+mNowZ;wLT-HLPJeH59IX|8!mQ3^{RqmtN@DL;8A1P_;dS-V{z8ijy
zRLQe#wpyh6m3iMWh|ru*vJPUJG_N6lOUi-#eB}|ZeM^09PG22##EuspTUGqzO$;Pw
z$LE)zJ3tqj+Wq?Z$Y<-@yyh*&%ga+^@=u-f&Dw*?UM$U$-`n#SmyVuJ8qICmFzKLc
z5>|ZfUJ!CWf&2z@W*JbXvK*6S0NHPPE<zN!1=TFy<I=a6gK8_OGlW8wqK9%Wd9K4v
zw0@7@C0E+N+?`_xFE{o~3*Mp;>0HgA${oKIBY97ad^vco+@3MJ*Ii9X{sy#w<D)4O
z<@TP_lTXK!XZ-gkfgb`<OpovnZkkVGXHy<#ueVH=kK|D>H4YAHYkd7<oBF#6w-{y)
zVf*sfWLOLHLK*uSw*)%3#4x=Nq8D50pMDOHD9aQd8Q-8{Wk7Y`d*9P(t0GDfRUPJI
zF8iWyPD52QN?b0fJVMv^>PvU7>vwyw%z_Q7T1kU+UhaTfEXRjR#(|@&TO_(N;wwDF
zVJ--iMsXXcxdKtU(W&@kkkc7e^36TJY93oFYC=S2dO(_~^4TK&O!<Ij;8Dt}tWC#?
zAy48cjenq_Tu8;xQd<@g|B8oN#uelT#Qo)oGaMKUeOwr(xcY1D!bIqZxPG5}6j`+8
zoN@+)`&0S1Z}c>T%3>DGi$%4zoKT)e=761sMyDtTe;)SsX{a(@sfau--dU9`&&{sJ
z=qH>7#{?D^mbet&JtxK99-QIP_lPjb_iUxMab|xG5A|TUAyk&_u#kFZQd8mbb!YTC
zUhi9(dSG`i3%<sdz*5X=m~F@Cn1i`m$lsfit?d?@Z}&}9(WL43O?Csu`c>+Ph3R)f
zwz75=lS_7&Hb#gTK&~%t>?v1;vFH1h0czYFm=4Np)<6*5M3k0JyC>eG6#(<<SUKSq
zVk{8FFU*?-QLVp9P>RxY%LjSH72P$+xn@oGsBjh4Fa{`hE=IW*7yn8wY8zh34V$3Y
zSfEu)!%#yJu`QzJwrBfl@HH+YL;)is{)d1=l`G#|@2@{?ShjKoO6cE_yZ;-;G5>q{
zT3wUgLSln0uCKw<mWmLq2>UU>T%^{ubFWv$B^bkCWqzJ94r}RppD+I2&!4i$G*Fu}
zipf~)`&k7ThnrUc;CDt23pVcnHE)m~YrjHG1V;`@m*J-)n1#*jnJa3`GD~B=Dls+P
zNRu)$mYmS%*^DfN_vyQHKy0ijGI%BC8{Ee;Ac(KOR^WwKtVQK=%krd9IF+z@S&3l-
z&w~3V3gO%@mGO!X=D@|XZbP1nCa~fg7cQ^2+3ac-eHfC?T;6r6G(fH2VRvUf*Qt%p
z^?)GG+0FmX^2WW%Yq^#I=Y;P%3}<N4wys~p)%x1cHl6<99+-jd)~_pFzmTD3?<b9A
zp!_g}5mpR)OF!7x+ZPczB*Z0)6l67CZWCo^Mk|^n)VCplvBvFAMF~AWMH&%!N9Tv9
z0-=)Hi+v)`;#8-fx0rzn-|wd3??Z0W0LXM_<=|m<upvpQ#rICXo9Tan$|sfAj6-AM
z-{-!bf7W^7+{)k&Cm$N)fj-WyZ7od!|M^F1T_`^XUI;?9{js~BY}{LAa=m%e>Fc+Y
z1j(JhfZ7J*-sz|+P`GgME=rQ<Q#LvONE=t5z3+W-@u6gtX6~l8l#(}Q1wN7c<9loI
zFw4M7pZtVB6~(ahU{~+smCObfcTKL9$vK0}i0W(noP9{Q%&Zh)5%&jDKe;bYJ$OC-
za>4O()-<K4z2}W)m2=O{LZ7%LRl_e2Cq7*Fxh=6+;ugAe@EBjL#I88-CfH%+rTX;b
z_}8}%6xjdPGXzQH(fl`#ih{*&N%nbUKsS`A@0kmMyH7laD3Pd_ne5ZvfJZhWdKEad
z<|lq1VX2ra!O3Tchicnz?^sPGAEH}6Zu|tN>mluTE;N9{_fv5SL{G4NC2+R9BI{5}
z?}m{iXc+idIaWxH?=<nO7l<Q*cw9HDv%PV0zkcD^*ZuVwu=wF2ZzTN{VLi8V6Twyp
zcvxD%2&8*!jOT?4Oz--o5<s6wd_EjJ-$-4i=GqCb(oVl}{Lg2aM6Z7q@ZX(SD)8{6
z2H4JsbzZDjfa%@h7QS%&@O$t--HpprKV^lHS12!>20r){NiC6P<Bc;|_lRj)qG!Lu
z>I77%I#mA_3nb?`A{9Y=FRQjY`0~BgjgZY$jLTnevg3~bK@pQ#!a-#(xL_99adTb(
zSuv$i@*Lp9>C`W304)Uad=I|VlTnZ;p+H5QQM^kO)L-CG92h$D|1xyoyGFpk%<Ys$
z7apSg{vpzu`gm}<Nv9w=a}3R?e%3f9R%(*tkq}F%t+Gx4^MP&U1~vG>S{nh)dC}xQ
zlom#wjl3I4l;E9rbKpz84(%(83b3hD7|P?3i~(bSJ<p)>FCzy=x5^1Bvn5!cok+#-
zyrl)4eZ<k}5l@4?gI%nlfCA~&3!)HCogO`oaKyo=*<Hhqn|lK|nUN!kyw@mDx?gaB
zYl1ksY~tMa2t_IE{e(;0VJAHv$+j{vWUB9kv#`e<heqIF7^uN2r{R}p*0_tDFF65n
z0*s^weEB{(m1!VEx%o8P_2ZFz79+-Bg8!w%|C!?dO!0qK@qbqF|9=d1d$Oa!+_8fy
zxV{JuRDs*LNd0X83o?MD_@b%T-!AOf7!s}Iu{A!nwg35e?5_SJ5~9cdk7^u;8vl{Q
zf9%8mrxruiqV&wEQ>Wq)it@Vuue0%iBp3Ffj1CV<U2|_*gI=COC}}Ewxcl(={{{4u
BeZT+!

literal 0
HcmV?d00001

diff --git a/assets/eip-6123/test/SDC.js b/assets/eip-6123/test/SDC.js
new file mode 100644
index 00000000000000..06b579b10d4ae0
--- /dev/null
+++ b/assets/eip-6123/test/SDC.js
@@ -0,0 +1,128 @@
+const { ethers } = require("hardhat");
+const { expect } = require("chai");
+const AbiCoder = ethers.utils.AbiCoder;
+const Keccak256 = ethers.utils.keccak256;
+
+describe("Livecycle Unit-Tests for Smart Derivative Contract", () => {
+
+    // Define objects for TradeState enum, since solidity enums cannot provide their member names...
+  const TradeState = {
+      Inactive: 0,
+      Incepted: 1,
+      Confirmed: 2,
+      Active: 3,
+      Terminated: 4,
+  };
+
+  const abiCoder = new AbiCoder();
+  const trade_data = "<xml>here are the trade specification</xml";
+  let sdc;
+  let token;
+  let tokenManager;
+  let counterparty1;
+  let counterparty2;
+  let trade_id;
+  let initialLiquidityBalance = 5000;
+  let terminationFee = 100;
+  let marginBufferAmount = 900;
+  const settlementAmount1 = 200; // successful settlement in favour to CP1
+  const settlementAmount2 = -1400; // failing settlement larger than buffer in favour to CP1
+
+  before(async () => {
+    const [_tokenManager, _counterparty1, _counterparty2] = await ethers.getSigners();
+    tokenManager = _tokenManager;
+    counterparty1 = _counterparty1;
+    counterparty2 = _counterparty2;
+    const ERC20Factory = await ethers.getContractFactory("SDCToken");
+    const SDCFactory = await ethers.getContractFactory("SDC");
+    token = await ERC20Factory.deploy();
+    await token.deployed();
+    sdc = await SDCFactory.deploy(counterparty1.address, counterparty2.address,counterparty1.address, token.address,marginBufferAmount,terminationFee);
+    await sdc.deployed();
+    console.log("SDC Address: %s", sdc.address);
+  });
+
+  it("Initial minting and approvals for SDC", async () => {
+    await token.connect(counterparty1).mint(counterparty1.address,initialLiquidityBalance);
+    await token.connect(counterparty2).mint(counterparty2.address,initialLiquidityBalance);
+    await token.connect(counterparty1).approve(sdc.address,terminationFee+marginBufferAmount);
+    await token.connect(counterparty2).approve(sdc.address,terminationFee+marginBufferAmount);
+    let allowanceSDCParty1 = await token.connect(counterparty1).allowance(counterparty1.address, sdc.address);
+    let allowanceSDCParty2 = await token.connect(counterparty2).allowance(counterparty2.address, sdc.address);
+    await expect(allowanceSDCParty1).equal(terminationFee+marginBufferAmount);
+  });
+
+  it("Counterparty1 incepts a trade", async () => {
+     const incept_call = await sdc.connect(counterparty1).inceptTrade(trade_data,"initialMarketData");
+     let tradeid =  await sdc.connect(counterparty1).getTradeID();
+     //console.log("TradeId: %s", tradeid);
+     await expect(incept_call).to.emit(sdc, "TradeIncepted").withArgs(counterparty1.address,tradeid,trade_data);
+     let trade_state =  await sdc.connect(counterparty1).getTradeState();
+     await expect(trade_state).equal(TradeState.Incepted);
+   });
+
+
+  it("Counterparty2 confirms a trade", async () => {
+     const confirm_call = await sdc.connect(counterparty2).confirmTrade(trade_data,"initialMarketData");
+     //console.log("TradeId: %s", await sdc.callStatic.getTradeState());
+     let balanceSDC = await token.connect(counterparty2).balanceOf(sdc.address);
+     await expect(confirm_call).to.emit(sdc, "TradeConfirmed");
+     await expect(balanceSDC).equal(2*terminationFee);
+     let trade_state =  await sdc.connect(counterparty1).getTradeState();
+     await expect(trade_state).equal(TradeState.Active);
+   });
+
+   it("Processing first prefunding phase", async () => {
+     const call = await sdc.connect(counterparty2).initiatePrefunding();
+     let balanceSDC = await token.connect(counterparty2).balanceOf(sdc.address);
+     let balanceCP2 = await token.connect(counterparty2).balanceOf(counterparty2.address);
+     await expect(balanceSDC).equal(2*(terminationFee+marginBufferAmount));
+     await expect(balanceCP2).equal(initialLiquidityBalance-(terminationFee+marginBufferAmount));
+     await expect(call).to.emit(sdc, "ProcessFunded");
+   });
+
+   it("Initiate and perform first successful settlement in favour to counterparty 1", async () => {
+     const callInitSettlement = await sdc.connect(counterparty2).initiateSettlement();
+     await expect(callInitSettlement).to.emit(sdc, "ProcessSettlementRequest");
+     let balanceCP1 = parseInt(await token.connect(counterparty1).balanceOf(counterparty1.address));
+     let balanceCP2 = parseInt(await token.connect(counterparty2).balanceOf(counterparty1.address));
+     const callPerformSettlement = await sdc.connect(counterparty2).performSettlement(settlementAmount1,"settlementData");
+     await expect(callPerformSettlement).to.emit(sdc, "ProcessSettled");
+     let balanceSDC_afterSettlement = await token.connect(counterparty2).balanceOf(sdc.address);
+     let balanceCP1_afterSettlement = await token.connect(counterparty1).balanceOf(counterparty1.address);
+     let balanceCP2_afterSettlement = await token.connect(counterparty2).balanceOf(counterparty2.address);
+     await expect(balanceSDC_afterSettlement).equal(2*(terminationFee+marginBufferAmount)-settlementAmount1); // SDC balance less settlement
+     await expect(balanceCP1_afterSettlement).equal(balanceCP1+settlementAmount1);  // settlement in favour to CP1
+     await expect(balanceCP2_afterSettlement).equal(balanceCP2); // CP2 balance is not touched as transfer is booked from SDC balance
+   });
+
+   it("Process successfully second prefunding phase successful ", async () => {
+     await token.connect(counterparty2).approve(sdc.address,settlementAmount1);  // CP2 increases allowance
+     const call = await sdc.connect(counterparty1).initiatePrefunding(); //Prefunding: SDC transfers missing gap amount from CP2
+     let balanceSDC = await token.connect(counterparty2).balanceOf(sdc.address);
+     let balanceCP2 = await token.connect(counterparty2).balanceOf(counterparty2.address);
+     await expect(balanceSDC).equal(2*(terminationFee+marginBufferAmount));
+     await expect(balanceCP2).equal(initialLiquidityBalance-(terminationFee+marginBufferAmount)-settlementAmount1);
+     await expect(call).to.emit(sdc, "ProcessFunded");
+   });
+
+
+   it("Second settlement fails due to high transfer amount in favour to counteparty 2 - Trade terminates", async () => {
+     const callInitSettlement = await sdc.connect(counterparty2).initiateSettlement();
+     await expect(callInitSettlement).to.emit(sdc, "ProcessSettlementRequest");
+     const callPerformSettlement = await sdc.connect(counterparty2).performSettlement(settlementAmount2,"settlementData");
+     await expect(callPerformSettlement).to.emit(sdc, "TradeTerminated");
+
+     let balanceSDC = parseInt(await token.connect(counterparty2).balanceOf(sdc.address));
+     let balanceCP1 = await token.connect(counterparty1).balanceOf(counterparty1.address);
+     let balanceCP2 = await token.connect(counterparty2).balanceOf(counterparty2.address);
+     let expectedBalanceCP1 = initialLiquidityBalance + settlementAmount1 - (marginBufferAmount + terminationFee); //CP1 received settlementAmount1 and paid margin buffer and termination fee
+     let expectedBalanceCP2 = initialLiquidityBalance - settlementAmount1 + (marginBufferAmount + terminationFee); //CP2 paid settlementAmount1 and receives margin buffer and termination fee
+     await expect(balanceCP1).equal(expectedBalanceCP1);
+     await expect(balanceCP2).equal(expectedBalanceCP2);
+     await expect(balanceSDC).equal(0);
+   });
+
+
+
+});
\ No newline at end of file

From 7cac73fa988b939af4f5bfb15b0dbaca4ef66a20 Mon Sep 17 00:00:00 2001
From: Simon Brown <brown.j.simon@gmail.com>
Date: Mon, 26 Dec 2022 16:24:03 +0000
Subject: [PATCH 083/274] Add EIP-5902: Smart Contract Event Hooks (#5902)

* Adding EIP-5897 | Smart Contract Event Hooks Standard

* Updated GitHub username to triangular brackets

* Fixed markdown linting errors

* Updated order of sections to move rationale after specification

* Reverted change of EIP numbers to links

* Fixed 'markdown-link-first' linting errors

* Fixed filename case-sensitity issue in linking to existing EIP

* Update EIP number to 5902

* Amended readme file

* Updated code examples

* Updated format for Hook event payload

* Fix some formatting stuff

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-5902.md | 641 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 641 insertions(+)
 create mode 100644 EIPS/eip-5902.md

diff --git a/EIPS/eip-5902.md b/EIPS/eip-5902.md
new file mode 100644
index 00000000000000..e9ffe7073892d5
--- /dev/null
+++ b/EIPS/eip-5902.md
@@ -0,0 +1,641 @@
+---
+eip: 5902
+title: Smart Contract Event Hooks
+description: Format that allows contracts to semi-autonoumously respond to events emitted by other contracts
+author: Simon Brown (@orbmis)
+discussions-to: https://ethereum-magicians.org/t/idea-smart-contract-event-hooks-standard/11503
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-11-09
+requires: 712
+---
+
+## Abstract
+
+This EIP proposes a standard for creating "hooks" that allow a smart contract function to be called automatically in response to a trigger fired by another contract, by using a public relayer network as a messaging bus.
+
+While there are many similar solutions in existence already, this proposal describes a simple yet powerful primitive that can be employed within many applications in an open, permissionless and decentralized manner.
+
+It relies on two interfaces, one for a publisher contract and one for a subscriber contract. The publisher contract emits events that are picked up by "relayers", who are independent entities that subscribe to hook events on publisher contracts, and call a function on the respective subscriber contracts whenever a hook event is fired by the publisher contracts. When a relayer calls the respective subscriber's contract with the details of the hook event emitted by the publisher contract, they are paid a fee by the subscriber. Both the publisher and subscriber contracts are registered in a central registry smart contract that relayers can use to discover hooks.
+
+## Motivation
+
+There exists a number of use cases that require some off-chain party to monitor the chain and respond to on-chain events by broadcasting a transaction. Such cases usually require some off-chain process to run alongside an Ethereum node, in order to subscribe to events via a web socket connection, and perform some logic in response to an event, by broadcasting a respective transaction to the network. For some use-cases, this may require an Ethereum node and an open websocket connection to some long-running process that may only be used infrequently, resulting in a sub-optimal use of resources.
+
+This proposal would allow for a smart contract to contain the logic it needs to respond to events without having to store that logic in some off-chain process. The smart contract can subscribe to events fired by other smart contracts and would only execute the required logic when it is needed. This method would suit any contract logic that does not require off-chain computation, but requires an off-chain process to monitor chain state in order to call one of its functions in response.
+
+Firing hooks from publisher smart contracts still requires some off-chain impetus. To put it another way, somebody has to pull the trigger on the publisher contract, by submitting a transaction to the publisher contract in order to emit the hook event. This is how it works today, and this proposal doesn't change that. Where it does offer an improvement, is that each subscriber no longer needs its own dedicated off-chain process for monitoring and responding to these events. Instead, a single incentivized relayer can subscribe to many different events on behalf of multiple subscriber contracts.
+
+Thanks to innovations such as web3 webhooks from Moralis, web3 actions from Tenderly, or hal.xyz, creating a relayer is easier than ever.
+
+Examples of use cases that would benefit from this scheme include:
+
+### Collateralised lending protocols
+
+For example, Maker uses the "medianizer" smart contract which maintains a whitelist of price feed contracts which are allowed to post price updates. Every time a new price update is received, the median of all feed prices is re-computed and the medianized value is updated. In this case, the medianizer smart contract could fire a hook event that would allow subscriber contracts to decide to re-collateralize their positions.
+
+### Automated market makers
+
+AMM liquidity pools could fire a hook event whenever liquidity is added or removed. This could allow a subscriber smart contracts to add or remove liquidity once the total pool liquidity reaches a certain point.
+
+AMMs can fire a hook whenever there is a trade within a trading pair, emitting the time-weighted-price-oracle update via an hook event. Subscribers can use this to create an automated Limit-Order-Book contract to buy/sell tokens once an asset's spot price breaches a pre-specified threshold.
+
+### DAO voting
+
+Hook events can be emitted by a DAO governance contract to signal that a proposal has been published, voted on, carried or vetoed, and would allow any subscriber contract to automatically respond accordingly.
+
+### Scheduled function calls
+
+A scheduler service can be created whereby a subscriber can register for a scheduled funtion call, this could be done using unix cron format and the service can fire events from a smart contract on separate threads. Subscriber contracts can subscriber to the respective threads in order to subscribe to certain schedules (e.g. daily, weekly, hourly etc.), and could even register customer cron schedules.
+
+### Coordination via Delegation
+
+Hook event payloads can contain any arbitrary data, this means you can use things like the Delegatable framework to sign off-chain delegations which can faciliate a chain of authorized entities to publish valid Hook events. You can also use things like BLS threshold signatures.
+
+## Specification
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
+
+### Registering a Publisher
+
+Both the publisher and subscriber contracts **MUST** register in a specific register contract, similarly to how smart contracts register an interface in the [EIP-1820](./eip-1820.md) contract.
+
+To register a hook in a publisher contract, the `registerHook` function **MUST** be called on the registry contract. The parameters that need to be supplied are:
+
+ - `address` - The publisher contract address, in the form of an ethereum address
+ - `bytes32` - The public key associated with the hook events
+ - `uint256` - The thread id that the hooks events will reference (a single contract can fire hook events with any number of threads, subscribers can choose which threads to subscribe to)
+
+When the `registerHook` function is called on the registry contract, the registry contract **MUST** make a downstream call to the publisher contract address, by calling the publisher contract's `verifyEventHookRegistration` function, with the same arguments as passed to the `registerHook` function on the registry contract. The `verifyEventHookRegistration` function in the publisher contract **MUST** return `true` to indicate that the contract will allow itself to be added to the registry as a publisher. The registry contract **MUST** emit a `HookRegistered` event to indicate that a new publisher contract has been added.
+
+### Updating a Publisher
+
+Publishers may want to revoke or update public keys associated with a hook event, or indeed remove support for a hook event completely. The registry contract **MUST** implement the `updatePublisher` function to allow for an existing publisher contract to be updated in the registry. The registry contract **MUST** emit a `PublisherUpdated` event to indicate that the publisher contract was updated.
+
+### Registering a Subscriber
+
+To register a subscriber to a hook, the `registerSubscriber` function **MUST** be called on the registry contract with the following parameters:
+
+ - `address` - The publisher contract address
+ - `bytes32` - The subscriber contract address
+ - `uint256` - The thread id to subscribe to
+ - `uint256` - the fee that the subscriber is willing to pay to get updates
+ - `uint256` - the maximum gas that the subscriber will allow for updates, to prevent griefing attacks
+ - `uint256` - the maximum gas price that the subscriber is willing to rebate, or 0 to indicate no rebates, in which case it assumed the relay fee covers gas fees
+ - `uint256` - the chain id that the subscriber wants updates on
+ - `address` - the address of the token that the fee will be paid in or 0x0 for the chain's native asset (e.g. ETH, MATIC etc.)
+
+The subscriber contract **MAY** implement gas refunds on top of the fixed fee per update. When a subscriber chooses to do this, they **SHOULD** specify the `maximum gas` and `maximum gas price` parameters in order to protect themselves from griefing attacks. This is so that a malicious or careless relay doesn't set an exorbitantly high gas price and ends up draining the subscriber contracts. Subscriber contracts can otherwise choose to set a fee that is estimated to be sufficiently high to cover gas fees, but they will need to take care to check that the specified gas price does not effectively reduce the fee to zero (see the note under front-running below for a more detailed explanation).
+
+Note that while the chain ID and the token address were not included in the original version of the spec, the simple addition of these two parameters allows for cross chain messages, should the subscriber wish to do this, and also allows for payment in various tokens.
+
+### Updating a subscriber
+
+To update a subscription, the `updateSubscriber` function **MUST** be called with the same set of parameters as the `registerSubscriber` function. This might be done in order to cancel a subscription, or to change the subscription fee. Note that if the average gas fees on a network change over time, the subscription fee might not be enough to incentivise relayers to notify the subscribers of hook events, so in this case the subscription fee might want to be updated periodically. Note that the `updateSubscriber` function **MUST** maintain the same `msg.sender` that the `registerSubscriber` function was called with.
+
+### Publishing an event
+
+A publisher contract **SHOULD** emit a hook event from at least one function. The emitted event **MUST** be called `Hook` and **MUST** contain the following parameters:
+
+ - `uint256 indexed` threadId
+ - `uint256 indexed` nonce
+ - `bytes32` digest
+ - `bytes` payload
+ - `bytes32` checksum
+
+The `nonce` value **MUST** be incremented every time a `Hook` event is fired by a publisher contract. Every `Hook` event **MUST** have a unique `nonce` value. The `nonce` property is initialized to `1`, but the first `Hook` event **MUST** have a nonce of `2`, to allow for simpler logic in initiating and auto-incremental state variable.
+
+The `digest` parameter of the event **MUST** be the keccak256 hash of the payload, and the `checksum` **MUST** be the keccak256 hash of the concatenation of the `digest` with the current block number, e.g.:
+
+```solidity
+bytes32 checksum = keccak256(abi.encodePacked(digest, block.number));
+```
+
+The function in the publisher contract that emits the `Hook` event **MAY** be passed a signature from an EOA that calls the function. This signature **MUST** be verified by the subscriber's contracts. When using this approach, the signature **SHOULD** be placed at the start of the payload (e.g. bytes `0` to `65` for an ECDSA signature with `r`, `s`, and `v` properties).
+
+The publisher contract **MAY** emit a `Hook` event without a signature, which allows the `Hook` event to be triggered by a function call from ANY EOA or external contract, and allows the payload to be created dynamically within the publisher contract. In this case the subscriber contract **SHOULD** call the `verifyEventHook` function on the publisher contract to verify that the received Hook payload is valid.
+
+The payload **MAY** be passed to the function firing the event or **MAY** be generated by the contract itself, but if a signature is provided, it **MUST** sign a hash of the payload, and it is strongly recommended to use the [EIP-712](./eip-712.md) standard as described in the "Replay Attacks" section below. This signature **SHOULD** be verified by the subscribers to ensure they are getting authentic events. The signature **MUST** correspond to the public key that was registered with the event.
+
+The payload **MUST** be passed as a byte array in calldata. The subscriber smart contract **SHOULD** convert the byte array into the required data type. For example, if the payload is a snark proof, the actual payload might look something like:
+
+- `uint256[2]` a
+- `uint256[2][2]` b
+- `uint256[2]` c
+- `uint256[1]` input
+
+In this case the publisher would need to serialize the variables into a bytes32 array, and the subscriber smart contract would need to deserialize it on the other end, e.g.:
+
+```text
+a[0]     = uint256(bytes32(payload[0:32]));
+a[1]     = uint256(bytes32(payload[32:64]));
+b[0][0]  = uint256(bytes32(payload[64:96]));
+b[0][1]  = uint256(bytes32(payload[96:128]));
+b[1][0]  = uint256(bytes32(payload[128:160]));
+b[1][1]  = uint256(bytes32(payload[160:192]));
+c[0]     = uint256(bytes32(payload[192:224]));
+c[1]     = uint256(bytes32(payload[224:256]));
+input[0] = uint256(bytes32(payload[256:288]));
+```
+
+### Relayers
+
+Relayers are independent parties that listen to `Hook` events on publisher smart contracts. Relayers retrieve a list of subscribers for different hooks from the registry, and listen for hook events being fired on the publisher contracts. Once a hook event has been fired by a publisher smart contract, relayers can decide to relay the hook event's payload to the subscriber contracts by broadcasting a transaction that calls the subscriber contract's `verifyHook` function. Relayers are incentivised to do this because it is expected that the subscriber contract will remunerate them with ETH, or potentially some other asset.
+
+Relayers **SHOULD** simulate the transaction locally before broadcasting it to make sure that the contract has sufficient balance for payment of the fee. This requires subscriber contracts to maintain a balance of ETH in order to provision payment of relayer fees. A subscriber contract **MAY** decide to revert a transaction based on some logic, which subsequently allows the subscriber contract to conditionally respond to events, depending on the data in the payload. In this case the relayer will simulate the transaction locally and determine not to relay the Hook event to the publisher contract.
+
+### Verifying a hook event
+
+The `verifyHook` function of the subscriber contracts **SHOULD** include logic to ensure that they are retrieving authentic events. In the case where the Hook event contains a signature, then subscriber contracts **SHOULD** create a hash of the required parameters, and **SHOULD** verify that the signature in the hook event is valid against the derived hash and the publisher's public key (see the [EIP-712](./eip-712.md) example for reference). The hook function **SHOULD** also verify the nonce of the hook event and record it internally, in order to prevent replay attacks.
+
+For Hook events without signatures, the subscriber contract **SHOULD** call the `verifyHookEvent` on the publisher contract in order to verify that the hook event is valid. The publisher smart contract **MUST** implement the `verifyHookEvent`, which accepts the hash of the payload, the thread id, the nonce, and the block height associated with the Hook event, and returns a boolean value to indicate the Hook event's authenticity.
+
+### Interfaces
+
+#### `IRegistry`
+
+```solidity
+/// @title IRegistry
+/// @dev Implements the registry contract
+interface IRegistry {
+    /// @dev Registers a new hook event by a publisher
+    /// @param publisherContract The address of the publisher contract
+    /// @param threadId The id of the thread these hook events will be fired on
+    /// @return Returns true if the hook is successfully registered
+    function registerHook(address publisherContract, uint256 threadId) external returns (bool);
+
+    /// @dev Verifies a hook with the publisher smart contract before adding it to the registry
+    /// @param publisherAddress The address of the publisher contract
+    /// @param threadId The id of the thread these hook events will be fired on
+    /// @return Returns true if the hook is successfully verified
+    function verifyHook(address publisherAddress, uint256 threadId) external returns (bool);
+
+    /// @dev Update a previously registered hook event
+    /// @dev Can be used to transfer hook authorization to a new address
+    /// @dev To remove a hook, transfer it to the burn address
+    /// @param publisherContract The address of the publisher contract
+    /// @param publisherPubKey The public key used to verify the hook signatures
+    /// @param threadId The id of the thread these hook events will be fired on
+    /// @return Returns true if the hook is successfully updated
+    function updateHook(
+        address publisherContract,
+        address publisherPubKey,
+        uint256 threadId
+    ) external returns (bool);
+
+    /// @dev Registers a subscriber to a hook event
+    /// @param publisherContract The address of the publisher contract
+    /// @param subscriberContract The address of the contract subscribing to the event hooks
+    /// @param threadId The id of the thread these hook events will be fired on
+    /// @param fee The fee that the subscriber contract will pay the relayer
+    /// @param maxGas The maximum gas that the subscriber allow to spend, to prevent griefing attacks
+    /// @param maxGasPrice The maximum gas price that the subscriber is willing to rebate
+    /// @param chainId The chain id that the subscriber wants updates on
+    /// @param feeToken The address of the token that the fee will be paid in or 0x0 for the chain's native asset (e.g. ETH)
+    /// @return Returns true if the subscriber is successfully registered
+    function registerSubscriber(
+        address publisherContract,
+        address subscriberContract,
+        uint256 threadId,
+        uint256 fee,
+        uint256 maxGas,
+        uint256 maxGasPrice,
+        uint256 chainId,
+        address feeToken
+    ) external returns (bool);
+
+    /// @dev Registers a subscriber to a hook event
+    /// @param publisherContract The address of the publisher contract
+    /// @param subscriberContract The address of the contract subscribing to the event hooks
+    /// @param threadId The id of the thread these hook events will be fired on
+    /// @param fee The fee that the subscriber contract will pay the relayer
+    /// @return Returns true if the subscriber is successfully updated
+    function updateSubscriber(
+        address publisherContract,
+        address subscriberContract,
+        uint256 threadId,
+        uint256 fee
+    ) external returns (bool);
+}
+
+```
+
+#### `IPublisher`
+
+```solidity
+/// @title IPublisher
+/// @dev Implements a publisher contract
+interface IPublisher {
+    /// @dev Example of a function that fires a hook event when it is called
+    /// @param payload The actual payload of the hook event
+    /// @param digest Hash of the hook event payload that was signed
+    /// @param threadId The thread number to fire the hook event on
+    function fireHook(bytes calldata payload, bytes32 digest, uint256 threadId) external;
+
+    /// @dev Adds / updates a new hook event internally
+    /// @param threadId The thread id of the hook
+    /// @param publisherPubKey The public key associated with the private key that signs the hook events
+    function addHook(uint256 threadId, address publisherPubKey) external;
+
+    /// @dev Called by the registry contract when registering a hook, used to verify the hook is valid before adding
+    /// @param threadId The thread id of the hook
+    /// @param publisherPubKey The public key associated with the private key that signs the hook events
+    /// @return Returns true if the hook is valid and is ok to add to the registry
+    function verifyEventHookRegistration(uint256 threadId, address publisherPubKey) external view returns (bool);
+
+    /// @dev Returns the address that will sign the hook events on a given thread
+    /// @param threadId The thread id of the hook
+    /// @return Returns the address that will sign the hook events on a given thread
+    function getEventHook(uint256 threadId) external view returns (address);
+
+    /// @dev Returns true if the specified hook is valid
+    /// @param payloadhash The hash of the hook's data payload
+    /// @param threadId The thread id of the hook
+    /// @param nonce The nonce of the current thread
+    /// @param blockheight The blockheight that the hook was fired at
+    /// @return Returns true if the specified hook is valid
+    function verifyEventHook(
+        bytes32 payloadhash,
+        uint256 threadId,
+        uint256 nonce,
+        uint256 blockheight
+    ) external view returns (bool);
+}
+
+```
+
+#### `ISubscriber`
+
+```solidity
+/// @title ISubscriber
+/// @dev Implements a subscriber contract
+interface ISubscriber {
+    /// @dev Example of a function that is called when a hook is fired by a publisher
+    /// @param publisher The address of the publisher contract in order to verify hook event with
+    /// @param payload Hash of the hook event payload that was signed
+    /// @param threadId The id of the thread this hook was fired on
+    /// @param nonce Unique nonce of this hook
+    /// @param blockheight The block height at which the hook event was fired
+    function verifyHook(
+        address publisher,
+        bytes calldata payload,
+        uint256 threadId,
+        uint256 nonce,
+        uint256 blockheight
+    ) external;
+}
+
+```
+
+## Rationale
+
+The rationale for this design is that it allows smart contract developers to write contract logic that listens and responds to events fired in other smart contracts, without requiring them to run some dedicated off-chain process to achieve this. This best suits any simple smart contract logic that runs relatively infrequently in response to events in other contracts.
+
+This improves on the existing solutions to achieve a pub/sub design pattern. To elaborate: a number of service providers currently offer "webhooks" as a way to subscribe to events emitted by smart contracts, by having some API endpoint called when the events are emitted, or alternatively offer some serverless feature that can be triggered by some smart contract event. This approach works very well, but it does require that some API endpoint or serverless function be always available, which may require some dedicated server / process, which in turn will need to have some private key, and some amount of ETH in order to re-broadcast transactions.
+
+This approach offers a more suitable alternative for when an "always-on" server instance is not desirable, e.g. in the case that it will be called infrequently.
+
+This proposal incorporates a decentralized market-driven relay network, and this decision is based on the fact that this is a highly scalable approach. Conversely, it is possible to implement this functionality without resorting to a market-driven approach, by simply defining a standard for contracts to allow other contracts to subscribe directly. That approach is conceptually simpler, but has its drawbacks, in so far as it requires a publisher contract to record subscribers in its own state, creating an overhead for data management, upgradeability etc. That approach would also require the publisher to call the `verifyHook` function on each subscriber contract, which will incur potentially significant gas costs for the publisher contract.
+
+## Reference Implementation
+
+### `Registry`
+
+```solidity
+contract Registry is IRegistry {
+    event HookRegistered(
+        address indexed publisherContract,
+        address publisherPubKey,
+        uint256 threadId,
+        address result,
+        bool valid
+    );
+
+    event HookUpdated(
+        address indexed publisherContract,
+        address publisherPubKey,
+        uint256 threadId
+    );
+
+    event SubscriberRegistered(
+        address indexed publisherContract,
+        address indexed subscriberContract,
+        uint256 threadId,
+        uint256 fee,
+        uint256 maxGas,
+        uint256 maxGasPrice,
+        uint256 chainId,
+        address feeToken
+    );
+
+    event SubscriberUpdated(
+        address indexed publisherContract,
+        address indexed subscriberContract,
+        uint256 threadId,
+        uint256 fee
+    );
+
+    /// mapping of publisherContractAddress to threadId to publisherPubKey
+    /// a publisher contract can pubish multiple different hooks on different thread ids
+    mapping(address => mapping(uint256 => address)) public publishers;
+
+    /// mapping of subscriberContractAddress to publisherContractAddress to threadIds to fee
+    /// a subscriber contract can subscribe to multiple hook events on one or more contracts
+    mapping(address => mapping(address => mapping(uint256 => uint256))) public subscribers;
+
+    /// records the owners of a subscriber contract so that updates can be authorized
+    mapping(address => address) public owners;
+
+    function registerHook(address publisherContract, uint256 threadId) public returns (bool) {
+        require(
+            (publishers[publisherContract][threadId] == address(0)),
+            "Hook already registered"
+        );
+
+        address result = IPublisher(publisherContract).getEventHook(threadId);
+
+        bool isHookValid = verifyHook(publisherContract, threadId);
+
+        require(isHookValid, "Hook not valid");
+
+        // the sender must be the account that signs the hook events
+        publishers[publisherContract][threadId] = msg.sender;
+
+        emit HookRegistered(publisherContract, msg.sender, threadId, result, isHookValid);
+
+        return true;
+    }
+
+    function verifyHook(address publisherAddress, uint256 threadId) public view returns (bool) {
+        return IPublisher(publisherAddress).verifyEventHookRegistration(threadId, msg.sender);
+    }
+
+    function updateHook(
+        address publisherContract,
+        address publisherPubKey,
+        uint256 threadId
+    ) public returns (bool) {
+        require(
+            publishers[publisherContract][threadId] == msg.sender,
+            "Not authorized to update hook"
+        );
+
+        publishers[publisherContract][threadId] = publisherPubKey;
+
+        emit HookUpdated(publisherContract, publisherPubKey, threadId);
+
+        return true;
+    }
+
+    function registerSubscriber(
+        address publisherContract,
+        address subscriberContract,
+        uint256 threadId,
+        uint256 fee,
+        uint256 maxGas,
+        uint256 maxGasPrice,
+        uint256 chainId,
+        address feeToken
+    ) public returns (bool) {
+        require(fee > 0, "Fee must be greater than 0");
+
+        require(
+            subscribers[subscriberContract][publisherContract][threadId] != fee,
+            "Subscriber already registered"
+        );
+
+        subscribers[subscriberContract][publisherContract][threadId] = fee;
+
+        owners[subscriberContract] = msg.sender;
+
+        emit SubscriberRegistered(publisherContract, subscriberContract, threadId, fee, maxGas, maxGasPrice, chainId, feeToken);
+
+        return true;
+    }
+
+    function updateSubscriber(
+        address publisherContract,
+        address subscriberContract,
+        uint256 threadId,
+        uint256 fee
+    ) public returns (bool) {
+        require(owners[subscriberContract] == msg.sender, "Not authorized to update subscriber");
+
+        subscribers[subscriberContract][publisherContract][threadId] = fee;
+
+        emit SubscriberUpdated(publisherContract, subscriberContract, threadId, fee);
+
+        return true;
+    }
+}
+```
+
+### `Publisher`
+
+```solidity
+contract Publisher is IPublisher, Ownable {
+    uint256 public hookNonce = 1;
+
+    // mapping of threadId to nonce to digest (payload data hash)
+    mapping(uint256 => mapping(uint256 => bytes32)) public firedHooks;
+
+    event Hook(
+        uint256 indexed threadId,
+        uint256 indexed nonce,
+        bytes32 digest,
+        bytes payload,
+        bytes32 checksum
+    );
+
+    mapping(uint256 => address) public hooks;
+
+    function fireHook(
+        bytes calldata payload,
+        bytes32 digest,
+        uint256 threadId
+    ) public onlyOwner {
+        hookNonce++;
+
+        bytes32 checksum = keccak256(abi.encodePacked(digest, block.number));
+
+        firedHooks[threadId][hookNonce] = checksum;
+
+        emit Hook(threadId, hookNonce, digest, payload, checksum);
+    }
+
+    function addHook(uint256 threadId, address publisherPubKey) public onlyOwner {
+        hooks[threadId] = publisherPubKey;
+    }
+
+    function verifyEventHookRegistration(
+        uint256 threadId,
+        address publisherPubKey
+    ) public view override returns (bool) {
+        return (hooks[threadId] == publisherPubKey);
+    }
+
+    function verifyEventHook(
+        bytes32 payloadhash,
+        uint256 threadId,
+        uint256 nonce,
+        uint256 blockheight
+    ) external view returns (bool) {
+        bytes32 checksum = keccak256(abi.encodePacked(payloadhash, blockheight));
+
+        bool result = firedHooks[threadId][nonce] == checksum;
+
+        return result;
+    }
+
+    function getEventHook(uint256 threadId) public view returns (address) {
+        return hooks[threadId];
+    }
+}
+```
+
+### `Subscriber`
+
+```solidity
+contract Subscriber is ISubscriber, Ownable {
+    uint256 public constant RELAYER_FEE = 0.001 ether;
+    uint256 public constant MAX_AGE = 4;
+    uint256 public constant STARTING_GAS = 21000;
+    uint256 public constant VERIFY_HOOK_ENTRY_GAS = 8000;
+    uint256 public constant VERIFY_HOOK_GAS_COST = 60000;
+    uint256 public constant MAX_GAS_PRICE = 10000000000;
+
+    uint256 public constant MAX_GAS_ALLOWED =
+        STARTING_GAS + VERIFY_HOOK_ENTRY_GAS + VERIFY_HOOK_GAS_COST;
+
+    // mapping of publisher address to threadId to nonce
+    mapping(address => mapping(uint256 => uint256)) public validPublishers;
+
+    receive() external payable {}
+
+    function updateValidPublishers(
+        address publisher,
+        uint256 threadId,
+        uint256 nonce
+    ) public onlyOwner {
+        require(nonce > 0, "nonce must be greater than zero");
+        validPublishers[publisher][threadId] = nonce;
+    }
+
+    function getPublisherNonce(address publisher, uint256 threadId) public view returns (uint256) {
+        return validPublishers[publisher][threadId];
+    }
+
+    function verifyHook(
+        address publisher,
+        bytes calldata payload,
+        uint256 threadId,
+        uint256 nonce,
+        uint256 blockheight
+    ) public {
+        uint256 gasStart = gasleft();
+
+        bool isHookValid = IPublisher(publisher).verifyEventHook(
+            keccak256(payload),
+            threadId,
+            nonce,
+            blockheight
+        );
+
+        // checks
+        require(isHookValid, "Hook not verified by publisher");
+        require(nonce > validPublishers[publisher][threadId], "Obsolete hook detected");
+        require(tx.gasprice <= MAX_GAS_PRICE, "Gas price is too high");
+        require(blockheight < block.number, "Hook event not valid yet");
+        require((block.number - blockheight) < MAX_AGE, "Hook has expired");
+        require(validPublishers[publisher][threadId] != 0, "Publisher not valid");
+
+        // effects
+        validPublishers[publisher][threadId] = nonce;
+
+        // interactions
+        (bool result, ) = msg.sender.call{value: RELAYER_FEE}("");
+
+        require(result, "Failed to send relayer fee");
+
+        require(
+            (gasStart - gasleft()) < MAX_GAS_ALLOWED,
+            "Function call exceeded gas allowance"
+        );
+    }
+}
+```
+
+## Security Considerations
+
+### Griefing attacks
+
+It is imperative that subscriber contracts trust the publisher contracts not to fire events that hold no intrinsic interest or value for them, as it is possible that malicious publisher contracts can publish a large number of events that will in turn drain the ETH from the subscriber contracts. If the private key used to sign the hook events is ever compromised, then the potential to drain ETH from all subscriber contracts is a very real possibility.
+
+### Front-running attacks
+
+When using signatures to validate Hook events, it is important for publishers and subscribers of hooks to realize that it is possible for a relayer to relay hook events before they are broadcast, by examining the publisher's originating transaction in the mempool. The normal flow is for the originating transaction to call a function in the publisher smart contract, which in turn fires an event which is then picked up by relayers. Competitive relayers will observe that it is possible to pluck the signature from the originating transaction from the mempool and simply relay it to subscriber contracts before the originating transaction has been actually included in a block. In fact, it is possible that the subscriber contracts process the event before the originating transaction is processed, based purely on gas fee dynamics. This can mitigated against by subscriber contracts calling the `verifyEventHook` function on the publisher contract when they receive a Hook event.
+
+Another risk from front-running affects relayers, whereby the relayer's transactions to the subscriber contracts can be front-run by generalized MEV searchers in the mempool. It is likely that this sort of MEV capture will occur in the public mempool, and therefore it is advised that relayers use private channels to block builders to mitigate against this issue. By broadcasting transactions to a segregated mempool, relayers protect themselves from front-running by generalized MEV bots, but their transactions can still fail due to competition from other relayers. If two or more relayers decide to start relaying hook events from the same publisher, then the relay transactions with the highest gas price will be executed before the others. This will result in the other relayer's transactions potentially failing on-chain, by being included later in the same block. For now, there are certain transaction optimization services that will prevent transactions from failing on-chain, which will offer a solution to this problem, though this is out-of-scope for this document. A future iteration of this proposal may well include the option for trusted relayers, who can enter into an on-chain enforceable agreement with subscribers, which should reduce the race-to-the-bottom competitive gas fee issue.
+
+In order to cultivate and maintain a reliable relayer market, it is recommended that where possible, a subscriber contract implements logic to either rebate any gas fees up to a specified limit, (while still allowing for execution of hook updates under normal conditions), or implements a logical condition that checks that the gas price of the transaction that is calling the `verifyHook` function to ensure that the gas price does not effectively reduce the fee to zero. This would require that the smart contract have some knowledge of the approximate gas used by the `verifyHook` function, and checks that the condition `minFee >= fee - (gasPrice * gasUsed)`. This will mitigate against competitive bidding that would drive the _effective_ relayer fee to zero, by ensuring that there is some minimum fee below which the effective fee is not allowed to drop. This would mean that the highest gas price that can be paid before the transaction reverts is `fee - minFee + ε` where `ε ~= 1 gwei`. This will require careful estimation of the gas cost of the `verifyHook` function and an awareness that the gas used may change over time as the contract's state changes.
+
+Another important consideration is with batching of Hook events. If a relayer decides to batch multiple Hook event updates to various subscriber contracts into a single transaction, via a multi-call proxy contract, then they increase the risk of the entire batching failing on-chain. For example, if relayer A batches x number of Hook updates, and relayer B batches y number of Hook updates, it is possible that relayer A's batch is included in the same block in front of relayer B's batch, and if both batches contain at least one duplicate, (i.e. the same Hook event to the same subscriber), then this will cause relayer B entire batch transaction to revert on-chain. This is an inportant consideration for relayers.
+
+### Replay attacks
+
+When using signature verification, it is advised to use the [EIP-712](./eip-712.md) standard in order to prevent cross network replay attacks, where the same contract deployed on more than one network can have its hook events pushed to subscribers on other networks, e.g. a publisher contract on Polygon can fire an hook event that could be relayed to a subscriber contract on Gnosis Chain. Whereas the keys used to sign the hook events should ideally be unique, in reality this may not always be the case.
+
+For this reason, it is recommended to use [EIP-721](./eip-712.md) Typed Data Signatures. In this case the off-chain process that initiates the hook should create the signature according to the following data structure:
+
+```solidity
+const domain = [
+  { name: "name", type: "string"  },
+  { name: "version", type: "string" },
+  { name: "chainId", type: "uint256" },
+  { name: "verifyingContract", type: "address" },
+  { name: "salt", type: "bytes32" }
+]
+ 
+const hook = [
+  { name: "payload", type: "string" },
+  { type: "uint256", name: "nonce" },
+  { type: "uint256", name: "blockheight" },
+  { type: "uint256", name: "threadId" },
+]
+ 
+const domainData = {
+  name: "Name of Publisher Dapp",
+  version: "1",
+  chainId: parseInt(web3.version.network, 10),
+  verifyingContract: "0x123456789abcedf....publisher contract address",
+  salt: "0x123456789abcedf....random hash unique to publisher contract"
+}
+ 
+const message = {
+  payload: "bytes array serialized payload"
+  nonce: 1,
+  blockheight: 999999,
+  threadId: 1,
+}
+ 
+const eip712TypedData = {
+  types: {
+    EIP712Domain: domain,
+    Hook: hook
+  },
+  domain: domainData,
+  primaryType: "Hook",
+  message: message
+}
+```
+
+Note: please refer to the unit tests for an example of how a hook event should be constructed properly by the publisher.
+
+Replay attacks can also occur on the same network that the event hook was fired, by simply re-broadcasting an event hook that was already broadcast previously. For this reason, subscriber contracts should check that a nonce is included in the event hook being received, and record the nonce in the contract's state. If the hook nonce is not valid, or has already been recorded, the transaction should revert.
+
+It is worth noting that the `chainId` event topic should also be used to prevent cross chain replay attacks, in the case that a dapp is deployed on multiple networks. There is also the possibility to leverage the `chainId` for more than preventing replay attacks, but also for accepting messages from other chains.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 6133a6c1d180aa9d23d7b3614aaea42f8777ef63 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Mon, 26 Dec 2022 11:31:05 -0500
Subject: [PATCH 084/274] Update EIP-5507: Add interface IDs and use consistent
 formatting (#6218)

---
 EIPS/eip-5507.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/EIPS/eip-5507.md b/EIPS/eip-5507.md
index e91fc9180836c7..6d6c987de77290 100644
--- a/EIPS/eip-5507.md
+++ b/EIPS/eip-5507.md
@@ -28,14 +28,14 @@ The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL
 ```solidity
 // SPDX-License-Identifier: CC0-1.0
 
-pragma solidity ^0.8.4;
+pragma solidity ^0.8.17;
 
 import "IERC20.sol";
 import "IERC165.sol";
 
 /// @notice Refundable EIP-20 tokens
-/// @dev    The EIP-165 identifier of this interface is `0xTODO`
-interface IERC20Refund is ERC20, ERC165 {
+/// @dev    The EIP-165 identifier of this interface is `0xf0ca2917`
+interface ERC20Refund is ERC20, ERC165 {
     /// @notice           Emitted when a token is refunded
     /// @dev              Emitted by `refund`
     /// @param  _sender   The person that requested a refund
@@ -65,14 +65,14 @@ interface IERC20Refund is ERC20, ERC165 {
 ```solidity
 // SPDX-License-Identifier: CC0-1.0
 
-pragma solidity ^0.8.4;
+pragma solidity ^0.8.17;
 
 import "IERC721.sol";
 import "IERC165.sol";
 
 /// @notice Refundable EIP-721 tokens
-/// @dev    The EIP-165 identifier of this interface is `0xTODO`
-interface IERC721Refund is ERC721, ERC165 {
+/// @dev    The EIP-165 identifier of this interface is `0xe97f3c83`
+interface ERC721Refund is ERC721 /* , ERC165 */ {
     /// @notice           Emitted when a token is refunded
     /// @dev              Emitted by `refund`
     /// @param  _sender   The person that requested a refund
@@ -104,14 +104,14 @@ interface IERC721Refund is ERC721, ERC165 {
 ```solidity
 // SPDX-License-Identifier: CC0-1.0
 
-pragma solidity ^0.8.4;
+pragma solidity ^0.8.17;
 
 import "IERC1155.sol";
 import "IERC165.sol";
 
 /// @notice Refundable EIP-1155 tokens
-/// @dev    The EIP-165 identifier of this interface is `0xTODO`
-interface IERC1155Refund is IERC1155, IERC165 {
+/// @dev    The EIP-165 identifier of this interface is `0x94029f5c`
+interface ERC1155Refund is ERC1155 /* , ERC165 */ {
     /// @notice           Emitted when a token is refunded
     /// @dev              Emitted by `refund`
     /// @param  _sender   The person that requested a refund

From 16f7cb55c21057b9edd2f6f1f6337f46bf172974 Mon Sep 17 00:00:00 2001
From: Suning Yao <sy2940@nyu.edu>
Date: Mon, 26 Dec 2022 18:41:44 -0500
Subject: [PATCH 085/274] Add EIP-6150: Hierarchical NFTs (#6150)

* Add EIP: Hierarchical NFTs

* Update EIP number

* Update discussion link

* Fix markdown linter check failure

* Fix markdown linter check failure

* Fix EIP-6150 implementation link

* Update demo implementation
---
 EIPS/eip-6150.md                        | 286 ++++++++++++++++++++++++
 assets/eip-6150/contracts/ERC-6150.sol  | 122 ++++++++++
 assets/eip-6150/contracts/IERC-6150.sol |  47 ++++
 assets/eip-6150/linux-hierarchy.png     | Bin 0 -> 12588 bytes
 assets/eip-6150/website-hierarchy.png   | Bin 0 -> 162576 bytes
 5 files changed, 455 insertions(+)
 create mode 100644 EIPS/eip-6150.md
 create mode 100644 assets/eip-6150/contracts/ERC-6150.sol
 create mode 100644 assets/eip-6150/contracts/IERC-6150.sol
 create mode 100644 assets/eip-6150/linux-hierarchy.png
 create mode 100644 assets/eip-6150/website-hierarchy.png

diff --git a/EIPS/eip-6150.md b/EIPS/eip-6150.md
new file mode 100644
index 00000000000000..3c065319ed5bcf
--- /dev/null
+++ b/EIPS/eip-6150.md
@@ -0,0 +1,286 @@
+---
+eip: 6150
+title: Hierarchical NFTs
+description: Hierarchical NFTs, an extension to EIP-721.
+author: Keegan Lee (@keeganlee), msfew <msfew@hyperoracle.io>, Kartin <kartin@hyperoracle.io>, qizhou (@qizhou)
+discussions-to: https://ethereum-magicians.org/t/eip-6150-hierarchical-nfts-an-extension-to-erc-721/12173
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-12-15
+requires: 165, 721
+---
+
+## Abstract
+
+This standard is an extension to [EIP-721](./eip-721.md). It proposes a multi-layer filesystem-like hierarchical NFTs. This standard provides interfaces to get parent NFT or children NFTs and whether NFT is a leaf node or root node, maintaining the hierarchical relationship among them.
+
+## Motivation
+
+This EIP standardizes the interface of filesystem-like hierarchical NFTs and provides a reference implementation.
+
+Hierarchy structure is commonly implemented for file systems by operating systems such as Linux Filesystem Hierarchy (FHS).
+
+![Linux Hierarchical File Structure](../assets/eip-6150/linux-hierarchy.png)
+
+Websites often use a directory and category hierarchy structure, such as eBay (Home -> Electronics -> Video Games -> Xbox -> Products), and Twitter (Home -> Lists -> List -> Tweets), and Reddit (Home -> r/ ethereum -> Posts -> Hot).
+
+![Website Hierarchical Structure](../assets/eip-6150/website-hierarchy.png)
+
+A single smart contract can be the `root`, managing every directory/category as individual NFT and hierarchy relations of NFTs. Each NFT's `tokenURI` may be another contract address, a website link, or any form of metadata.
+
+The advantages and the advancement of the Ethereum ecosystem of using this standard include:
+
+- Complete on-chain storage of hierarchy, which can also be governed on-chain by additional DAO contract
+- Only need a single contract to manage and operate the hierarchical relations
+- Transferrable directory/category ownership as NFT, which is great for use cases such as on-chain forums
+- Easy and permissionless data access to the hierarchical structure by front-end
+- Ideal structure for traditional applications such as e-commerce, or forums
+- Easy-to-understand interfaces for developers, which are similar to Linux filesystem commands in concept
+
+The use cases can include:
+
+- On-chain forum, like Reddit
+- On-chain social media, like Twitter
+- On-chain corporation, for managing organizational structures
+- On-chain e-commerce platforms, like eBay or individual stores
+- Any application with tree-like structures
+
+In the future, with the development of the data availability solutions of Ethereum and an external permissionless data retention network, the content (posts, listed items, or tweets) of these platforms can also be entirely stored on-chain, thus realizing fully decentralized applications.
+
+## Specification
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+Every [EIP-6150](./eip-6150.md) compliant contract must implement the [EIP-6150](./eip-6150.md), [EIP-721](./eip-721.md) and [EIP-165](./eip-165.md) interfaces.
+
+```solidity
+pragma solidity ^0.8.0;
+
+interface IERC6150 /* is IERC721, IERC165 */ {
+    /**
+     * @notice Emitted when `tokenId` token under `parentId` is minted.
+     * @param minter The address of minter
+     * @param to The address received token
+     * @param parentId The id of parent token, if it's zero, it means minted `tokenId` is a root token.
+     * @param tokenId The id of minted token, required to be greater than zero
+     */
+    event Minted(
+        address indexed minter,
+        address indexed to,
+        uint256 parentId,
+        uint256 tokenId
+    );
+
+    /**
+     * @notice Get the parent token of `tokenId` token.
+     * @param tokenId The child token
+     * @return parentId The Parent token found
+     */
+    function parentOf(uint256 tokenId) external view returns (uint256 parentId);
+
+    /**
+     * @notice Get the children tokens of `tokenId` token.
+     * @param tokenId The parent token
+     * @return childrenIds The array of children tokens
+     */
+    function childrenOf(
+        uint256 tokenId
+    ) external view returns (uint256[] memory childrenIds);
+
+    /**
+     * @notice Check the `tokenId` token if it is a root token.
+     * @param tokenId The token want to be checked
+     * @return Return `true` if it is a root token; if not, return `false`
+     */
+    function isRoot(uint256 tokenId) external view returns (bool);
+
+    /**
+     * @notice Check the `tokenId` token if it is a leaf token.
+     * @param tokenId The token want to be checked
+     * @return Return `true` if it is a leaf token; if not, return `false`
+     */
+    function isLeaf(uint256 tokenId) external view returns (bool);
+}
+```
+
+Optional Extension: Enumerable
+
+```solidity
+interface IERC6150Enumerable is IERC6150 /* IERC721Enumerable */ {
+    /**
+     * @notice Get total amount of children tokens under `parentId` token.
+     * @dev If `parentId` is zero, it means get total amount of root tokens.
+     * @return The total amount of children tokens under `parentId` token.
+     */
+    function childrenCountOf(uint256 parentId) external view returns (uint256);
+
+    /**
+     * @notice Get the token at the specified index of all children tokens under `parentId` token.
+     * @dev If `parentId` is zero, it means get root token.
+     * @return The token ID at `index` of all chlidren tokens under `parentId` token.
+     */
+    function childOfParentByIndex(
+        uint256 parentId,
+        uint256 index
+    ) external view returns (uint256);
+
+    /**
+     * @notice Get the index position of specified token in the children enumeration under specified parent token.
+     * @dev Throws if the `tokenId` is not found in the children enumeration.
+     * If `parentId` is zero, means get root token index.
+     * @param parentId The parent token
+     * @param tokenId The specified token to be found
+     * @return The index position of `tokenId` found in the children enumeration
+     */
+    function indexInChildrenEnumeration(
+        uint256 parentId,
+        uint256 tokenId
+    ) external view returns (uint256);
+}
+```
+
+Optional Extension: Burnable
+
+```solidity
+interface IERC6150Burnable is IERC6150 {
+    /**
+     * @notice Burn the `tokenId` token.
+     * @dev Throws if `tokenId` is not a leaf token.
+     * Throws if `tokenId` is not a valid NFT.
+     * Throws if `owner` is not the owner of `tokenId` token.
+     * Throws unless `msg.sender` is the current owner, an authorized operator, or the approved address for this token.
+     * @param tokenId The token to be burnt
+     */
+    function safeBurn(uint256 tokenId) external;
+
+    /**
+     * @notice Batch burn tokens.
+     * @dev Throws if one of `tokenIds` is not a leaf token.
+     * Throws if one of `tokenIds` is not a valid NFT.
+     * Throws if `owner` is not the owner of all `tokenIds` tokens.
+     * Throws unless `msg.sender` is the current owner, an authorized operator, or the approved address for all `tokenIds`.
+     * @param tokenIds The tokens to be burnt
+     */
+    function safeBatchBurn(uint256[] memory tokenIds) external;
+}
+```
+
+Optional Extension: ParentTransferable
+
+```solidity
+interface IERC6150ParentTransferable is IERC6150 {
+    /**
+     * @notice Emitted when the parent of `tokenId` token changed.
+     * @param tokenId The token changed
+     * @param oldParentId Previous parent token
+     * @param newParentId New parent token
+     */
+    event ParentTransferred(
+        uint256 tokenId,
+        uint256 oldParentId,
+        uint256 newParentId
+    );
+
+    /**
+     * @notice Transfer parentship of `tokenId` token to a new parent token
+     * @param newParentId New parent token id
+     * @param tokenId The token to be changed
+     */
+    function transferParent(uint256 newParentId, uint256 tokenId) external;
+
+    /**
+     * @notice Batch transfer parentship of `tokenIds` to a new parent token
+     * @param newParentId New parent token id
+     * @param tokenIds Array of token ids to be changed
+     */
+    function batchTransferParent(
+        uint256 newParentId,
+        uint256[] memory tokenIds
+    ) external;
+}
+```
+
+Optional Extension: Access Control
+
+```solidity
+interface IERC6150AccessControl is IERC6150 {
+    /**
+     * @notice Check the account whether a admin of `tokenId` token.
+     * @dev Each token can be set more than one admin. Admin have permission to do something to the token, like mint child token,
+     * or burn token, or transfer parentship.
+     * @param tokenId The specified token
+     * @param account The account to be checked
+     * @return If the account has admin permission, return true; otherwise, return false.
+     */
+    function isAdminOf(uint256 tokenId, address account)
+        external
+        view
+        returns (bool);
+
+    /**
+     * @notice Check whether the specified parent token and account can mint children tokens
+     * @dev If the `parentId` is zero, check whether account can mint root nodes
+     * @param parentId The specified parent token to be checked
+     * @param account The specified account to be checked
+     * @return If the token and account has mint permission, return true; otherwise, return false.
+     */
+    function canMintChildren(
+        uint256 parentId,
+        address account
+    ) external view returns (bool);
+
+    /**
+     * @notice Check whether the specified token can be burnt by specified account
+     * @param tokenId The specified token to be checked
+     * @param account The specified account to be checked
+     * @return If the tokenId can be burnt by account, return true; otherwise, return false.
+     */
+    function canBurnTokenByAccount(uint256 tokenId, address account)
+        external
+        view
+        returns (bool);
+}
+```
+
+## Rationale
+
+As mentioned in the abstract, this EIP's goal is to have a simple interface for supporting Hierarchical NFTs. Here are a few design decisions and why they were made:
+
+### Relationship between NFTs
+
+All NFTs will make up a hierarchical relationship tree. Each NFT is a node of the tree, maybe as a root node or a leaf node, as a parent node or a child node.
+
+[EIP-6150](./eip-6150.md) standardizes the event `Minted` to indicate the parent and child relationship when minting a new node. When a root node is minted, parentId should be zero. That means a token id of zero could not be a real node. So a real node token id must be greater than zero.
+
+In a hierarchical tree, it's common to query upper and lower nodes. So [EIP-6150](./eip-6150.md) standardizes function `parentOf` to get the parent node of the specified node and standardizes function `childrenOf` to get all children nodes.
+
+Functions `isRoot` and `isLeaf` can check if one node is a root node or a leaf node, which would be very useful for many cases.
+
+### Enumerable Extension
+
+[EIP-6150](./eip-6150.md) standardizes three functions as an extension to support enumerable queries involving children nodes. Each function all have param `parentId`, for compatibility, when the `parentId` specified zero means query root nodes.
+
+### ParentTransferable Extension
+
+In some cases, such as filesystem, a directory or a file could be moved from one directory to another. So [EIP-6150](./eip-6150.md) adds ParentTransferable Extension to support this situation.
+
+### Access Control
+
+In a hierarchical structure, usually, there is more than one account has permission to operate a node, like mint children nodes, transfer node, burn node. [EIP-6150](./eip-6150.md) adds a few functions as standard to check access control permissions.
+
+## Backwards Compatibility
+
+This proposal is fully backward compatible with [EIP-721](./eip-721.md).
+
+## Reference Implementation
+
+Implementation: [EIP-6150.sol](../assets/eip-6150/contracts/ERC-6150.sol)
+
+## Security Considerations
+
+No security considerations were found.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-6150/contracts/ERC-6150.sol b/assets/eip-6150/contracts/ERC-6150.sol
new file mode 100644
index 00000000000000..11fdeb5a31c3b4
--- /dev/null
+++ b/assets/eip-6150/contracts/ERC-6150.sol
@@ -0,0 +1,122 @@
+pragma solidity ^0.8.0;
+
+import "./IERC-6150.sol";
+import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+
+abstract contract ERC6150 is ERC721, IERC6150 {
+    mapping(uint256 => uint256) private _parentOf;
+    mapping(uint256 => uint256[]) private _childrenOf;
+
+    constructor(
+        string memory name_,
+        string memory symbol_
+    ) ERC721(name_, symbol_) {}
+
+    /**
+     * @dev See {IERC165-supportsInterface}.
+     */
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual override(IERC165, ERC721) returns (bool) {
+        return
+            interfaceId == type(IERC6150).interfaceId ||
+            super.supportsInterface(interfaceId);
+    }
+
+    function parentOf(
+        uint256 tokenId
+    ) public view virtual override returns (uint256 parentId) {
+        _requireMinted(tokenId);
+        parentId = _parentOf[tokenId];
+    }
+
+    function childrenOf(
+        uint256 tokenId
+    ) public view virtual override returns (uint256[] memory childrenIds) {
+        _requireMinted(tokenId);
+        childrenIds = _childrenOf[tokenId];
+    }
+
+    function isRoot(
+        uint256 tokenId
+    ) public view virtual override returns (bool) {
+        _requireMinted(tokenId);
+        return _parentOf[tokenId] == 0;
+    }
+
+    function isLeaf(
+        uint256 tokenId
+    ) public view virtual override returns (bool) {
+        _requireMinted(tokenId);
+        return _childrenOf[tokenId].length == 0;
+    }
+
+    function _safeBatchMintWithParent(
+        address to,
+        uint256 parentId,
+        uint256[] memory tokenIds
+    ) internal virtual {
+        _safeBatchMintWithParent(
+            to,
+            parentId,
+            tokenIds,
+            new bytes[](tokenIds.length)
+        );
+    }
+
+    function _safeBatchMintWithParent(
+        address to,
+        uint256 parentId,
+        uint256[] memory tokenIds,
+        bytes[] memory datas
+    ) internal virtual {
+        require(
+            tokenIds.length == datas.length,
+            "EIP6150: tokenIds.length != datas.length"
+        );
+        for (uint256 i = 0; i < tokenIds.length; i++) {
+            _safeMintWithParent(to, parentId, tokenIds[i], datas[i]);
+        }
+    }
+
+    function _safeMintWithParent(
+        address to,
+        uint256 parentId,
+        uint256 tokenId
+    ) internal virtual {
+        _safeMintWithParent(to, parentId, tokenId, "");
+    }
+
+    function _safeMintWithParent(
+        address to,
+        uint256 parentId,
+        uint256 tokenId,
+        bytes memory data
+    ) internal virtual {
+        require(tokenId > 0, "EIP6150: tokenId is zero");
+        if (parentId != 0)
+            require(_exists(parentId), "EIP6150: parentId doesn't exists");
+
+        _beforeMintWithParent(to, parentId, tokenId);
+
+        _parentOf[tokenId] = parentId;
+        _childrenOf[parentId].push(tokenId);
+
+        _safeMint(to, tokenId, data);
+        emit Minted(msg.sender, to, parentId, tokenId);
+
+        _afterMintWithParent(to, parentId, tokenId);
+    }
+
+    function _beforeMintWithParent(
+        address to,
+        uint256 parentId,
+        uint256 tokenId
+    ) internal virtual {}
+
+    function _afterMintWithParent(
+        address to,
+        uint256 parentId,
+        uint256 tokenId
+    ) internal virtual {}
+}
diff --git a/assets/eip-6150/contracts/IERC-6150.sol b/assets/eip-6150/contracts/IERC-6150.sol
new file mode 100644
index 00000000000000..d4830852a9b425
--- /dev/null
+++ b/assets/eip-6150/contracts/IERC-6150.sol
@@ -0,0 +1,47 @@
+pragma solidity ^0.8.0;
+
+interface IERC6150 /* is IERC721, IERC165 */ {
+    /**
+     * @notice Emitted when `tokenId` token under `parentId` is minted.
+     * @param minter The address of minter
+     * @param to The address received token
+     * @param parentId The id of parent token, if it's zero, it means minted `tokenId` is a root token.
+     * @param tokenId The id of minted token, required to be greater than zero
+     */
+    event Minted(
+        address indexed minter,
+        address indexed to,
+        uint256 parentId,
+        uint256 tokenId
+    );
+
+    /**
+     * @notice Get the parent token of `tokenId` token.
+     * @param tokenId The child token
+     * @return parentId The Parent token found
+     */
+    function parentOf(uint256 tokenId) external view returns (uint256 parentId);
+
+    /**
+     * @notice Get the children tokens of `tokenId` token.
+     * @param tokenId The parent token
+     * @return childrenIds The array of children tokens
+     */
+    function childrenOf(
+        uint256 tokenId
+    ) external view returns (uint256[] memory childrenIds);
+
+    /**
+     * @notice Check the `tokenId` token if it is a root token.
+     * @param tokenId The token want to be checked
+     * @return Return `true` if it is a root token; if not, return `false`
+     */
+    function isRoot(uint256 tokenId) external view returns (bool);
+
+    /**
+     * @notice Check the `tokenId` token if it is a leaf token.
+     * @param tokenId The token want to be checked
+     * @return Return `true` if it is a leaf token; if not, return `false`
+     */
+    function isLeaf(uint256 tokenId) external view returns (bool);
+}
diff --git a/assets/eip-6150/linux-hierarchy.png b/assets/eip-6150/linux-hierarchy.png
new file mode 100644
index 0000000000000000000000000000000000000000..60ecc1fc0ed2ad7b4280adc717d166bbc89b7413
GIT binary patch
literal 12588
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

literal 0
HcmV?d00001

diff --git a/assets/eip-6150/website-hierarchy.png b/assets/eip-6150/website-hierarchy.png
new file mode 100644
index 0000000000000000000000000000000000000000..85215eccf6be5bbf11befbf673ab22882f7702f8
GIT binary patch
literal 162576
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
H@ArQIig%E@

literal 0
HcmV?d00001


From e666b5b02c7d05116ca8718aa1f9d12f22c8f5d6 Mon Sep 17 00:00:00 2001
From: Weiji Guo <118721011+weiji-cryptonatty@users.noreply.github.com>
Date: Tue, 27 Dec 2022 22:58:25 +0800
Subject: [PATCH 086/274] Add EIP-6051: Private Key Encapsulation (#6051)

* added EIP draft for private key encapsulation

* minor updates to spec: intake function shall return the Ethereum address of the private key

* added test vector #1

* minor formatting

* minor edits

* added test vector #2 and #3, added signature verification data to #1

* changed signature to against byte values

* added test vector generator

* renamed file to assigned EIP number

* fixed file header

* updated default value for salt

* fixed offending links etc.

* fixed typo

Co-authored-by: xinbenlv <zzn@zzn.im>

* updated based on review comments

* replaced json formatting with none for better rendering

* fixed grammar

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar

Co-authored-by: xinbenlv <zzn@zzn.im>

* revision suggestions taken with gratitudes

Co-authored-by: xinbenlv <zzn@zzn.im>

* revision suggestions taken with gratitudes

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar

Co-authored-by: xinbenlv <zzn@zzn.im>

* revision suggestions taken with gratitudes

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar as suggested

Co-authored-by: xinbenlv <zzn@zzn.im>

* revision suggestions taken with gratitudes

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar as suggested

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar as suggested

Co-authored-by: xinbenlv <zzn@zzn.im>

* fixed grammar as suggested

* fixed based on grammarly.com suggestions

* Update EIPS/eip-6051.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6051.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-6051.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* replacing bold fonts with links as suggested

* fixed dead links

* fixed markdown linter errors

Co-authored-by: xinbenlv <zzn@zzn.im>
Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-6051.md | 523 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 523 insertions(+)
 create mode 100644 EIPS/eip-6051.md

diff --git a/EIPS/eip-6051.md b/EIPS/eip-6051.md
new file mode 100644
index 00000000000000..c1f380db909a2e
--- /dev/null
+++ b/EIPS/eip-6051.md
@@ -0,0 +1,523 @@
+---
+eip: 6051
+title: Private Key Encapsulation
+description: defines a specification for encapsulating private keys.
+author: Base Labs (@Base-Labs), Weiji Guo (@weiji-cryptonatty)
+discussions-to: https://ethereum-magicians.org/t/private-key-encapsulation-to-move-around-securely-without-entering-seed/11604
+status: Draft
+type: Standards Track
+category: Interface
+created: 2022-11-21
+---
+
+
+## Abstract
+
+This EIP proposes a mechanism to encapsulate a private key so that it could be securely relocated to another application without providing the seed. This EIP combines `ECIES` (Elliptic Curve Integrated Encryption Scheme) and optional signature verification under various choices to ensure that the private key is encapsulated for a known or trusted party.
+
+## Motivation
+
+There are various cases in which we might want to export one of many private keys from a much more secure but less convenient wallet, which is controlled with a seed or passphrase.
+
+1. We might dedicate one of many private keys for messaging purposes, and that private key is probably managed in a not-so-secure manner;
+2. We might want to export one of many private keys from a hardware wallet, and split it with MPC technology so that a 3rd party service could help us identify potential frauds or known bad addresses, enforce 2FA, etc., meanwhile we can initiate transactions from a mobile device with much better UX and without carrying a hardware wallet.
+
+In both cases, it is safer not to provide the seed which controls the whole wallet and might contains many addresses in multiple chains.
+
+This EIP aims to enable such use cases.
+
+## Specification
+
+### Sender and Recipient
+
+We hereby define:
+
+- *Sender* as the party who holds in custody the private key to be encapsulated; *Sender Application* as the client-side application that said *Sender* uses to send the encapsulated private key.
+
+- *Recipient* as the party who accepts the encapsulated private key, unwraps, and then uses it; *Recipient Application* as the client-side application that *Recipient* uses to receive the encapsulated private key.
+
+### Core Algorithms
+
+The basic idea is to encapsulate the private key with ECIES. To ensure that the ephemeral public key to encapsulate the private key is indeed generated from a trusted party and has not been tampered with, we also provided an option to sign that ephemeral public key in this standard.
+
+There should be a mandatory  `version`  parameter. This allows various kinds of Key Encapsulation Mechanisms to be adopted depending on security considerations or preferences. The list shall be short to minimize compatibility issues among different vendors.
+
+In addition to a `version` parameter, the following keys and functions are involved:
+
+1. The Sender's private key  `sk`, which is to be encapsulated to the Recipient, and the corresponding address `account`.
+2. The ephemeral Recipient key pair  `(r, R)`  such that `R = [r]G`. `G` denotes the base point of the elliptic curve, and `[r]G` denotes scalar multiplication. Optionally, `R` could be signed, and `signerPubKey` and `signature` are then provided for Sender to verify if `R`  could be trusted or not.
+3. The ephemeral Sender key pair  `(s, S)`  such that `S = [s]G`.
+4. The share secret  `ss := [s]R = [r]S` according to ECDH. Note that for secp256k1 this EIP follows RFC5903 and uses compact representation, which means to use *only* the `x` coordinate as the shared secret. For Curve25519 this EIP follows RFC7748.
+5. The out-of-band data `oob`, optional. This could be digits or an alpha-numeric string entered by the user.
+6. Let  `derivedKey  :=  HKDF(hash=SHA256, ikm=ss, info=oob,  salt,  length)`. HKDF is defined in RFC5869. The  `length`  should be determined by  `skey`  and  `IV`  requirements such that the symmetric key  `skey  = derivedKey[0:keySize]`, and  `IV  = derivedKey[keySize:length]`.  `keySize`  denotes the key size of the underlying symmetric algorithm, for example, 16 (bytes) for AES-128, and 32 (bytes) for Chacha20. See **Security Considerations** for the use of  `salt`.
+7. Let `cipher  := authenticated_encryption(symAlg,  skey,  IV, data=sk)`. The symmetric cipher algorithm `symAlg` and authentication scheme are decided by the version parameter. No additional authentication data `aad` is used.
+
+A much-simplified example flow without signature and verification is:
+
+1. *Recipient Application* generates  `(r, R)`.
+2. User inputs  `R`  to *Sender Application*, along with a six-digit code “123456” as  `oob`.
+3. *Sender Application* generates  `(s, S)`, and computes  `cipher`, then returns `S || cipher`.
+4. *Recipient Application* scans to read  `S`  and  `cipher`. The user enters “123456” as  `oob`  to *Recipient Application*.
+5. *Recipient Application* decrypts  `cipher`  to get  `sk`.
+6. *Recipient Application* derives the address corresponding to  `sk`  so that the user can confirm the correctness.
+
+With signature and verification, the signature to `R` by `singerPubKey` is appended to `R`. `signerPubKey` itself could have been already signed by `trustedPubKey`, and that signature is appended to `signerPubKey`. Note that the signature is applied to the byte array data instead of its string representation, which might lead to confusion and interoperability issues (such as hex or base64, lower case v.s. upper case, etc.). See [Requests](#requests) and [Test Cases](#test-cases) for further clarification and examples.
+
+### Requests
+
+#### Encoding of data and messages
+
+- Raw bytes are encoded in hex and prefixed with '0x'.
+- Unless specified otherwise, all parameters and return values are hex-encoded bytes.
+- `cipher`  is encoded into a single byte buffer as: `[IV  || encrypted_sk || tag]`.
+- `R`, `S`, `signerPubKey`, and `trustedPubKey` are compressed if applicable.
+- `R` or `signerPubKey` could be followed by a signature to it: `[pub || sig]`. Note that for the secp256k1 curve, the signature is just 64 bytes without the `v` indicator as found in a typical Ethereum signature.
+
+#### R1. Request for Recipient to generate ephemeral key pair
+
+```javascript
+request({
+	method: 'eth_generateEphemeralKeyPair',
+	params: [version, signerPubKey],
+})
+// expected return value: R
+```
+
+`signerPubKey`  is optional. If provided, it is assumed that the implementation has the corresponding private key and the implementation MUST sign the ephemeral public key (in the form of what is to be returned). The signature algorithm is determined by the curve part of the  `version`  parameter, that is, ECDSA for secp256k1, and Ed25519 for Curve25519. And in this situation, it should be the case that *Sender* trusts  `signerPubKey`, no matter how this trust is maintained. If not, the next request WILL be rejected by *Sender Application*. Also, see [Security Considerations](#security-considerations).
+
+The implementation then MUST generate random private key `r` with a cryptographic secure random number generator (CSRNG), and derive ephemeral public key `R = [r]G`. The implementation SHOULD keep the generated key pair `(r, R)` in a secure manner in accordance with the circumstances, and SHOULD keep it only for a limited duration, but the specific duration is left to individual implementations. The implementation SHOULD be able to retrieve `r` when given back the corresponding public key `R` if within the said duration.
+
+The return value is `R`, compressed if applicable. If  `signerPubKey`  is provided, then the `signature` is appended to `R`, also hex-encoded.
+
+Alternatively, `signature` could be calculated separately, and then appended to the returned data.
+
+#### R2. Request for Sender to encapsulate the private key
+
+```javascript
+request({
+	method: 'eth_encapsulatePrivateKey',
+	params: [
+		version,
+		recipient, // public key, may be followed by its signature, see signerPubKey
+		signerPubKey,
+		oob,
+		salt,
+		account
+	],
+})
+// expected return value: S || cipher
+```
+
+`recipient`  is the return value from the call to generate ephemeral key pair, with the optional `signature` appended either as returned or separately.
+
+`oob`  and  `salt`  are just byte arrays.
+
+`account`  is used to identify which private key to be encapsulated. With Ethereum, it is an address. Also, see [Encoding of data and messages](#encoding-of-data-and-messages).
+
+If  `signerPubKey`  is provided or  `recipient`  contains `signature` data, the implementation MUST perform signature verification. Missing data or incorrect format MUST either fail the call or result in an empty return and optional error logs.
+
+`signerPubKey` could have been further signed by another key pair `(trusted, trustedPubKey)`, which is trusted by *Sender Application*. In that case, `signerPubKey` is appended with the corresponding signature data, which SHOULD be verified against `trustedPubKey`. See [Test Cases](#test-cases) for further clarification.
+
+The implementation shall then proceed to retrieve the private key `sk` corresponding to  `account`, and follow the [Core Algorithms](#core-algorithms) to encrypt it.
+
+The return data is a byte array that contains first *Sender*'s ephemeral public key `S` (compressed if applicable), then `cipher` including any authentication tag, that is, `S || cipher`.
+
+#### R3. Request for Recipient to unwrap and intake the private key
+
+```javascript
+request({
+	method: 'eth_intakePrivateKey',
+	params: [
+		version,
+		recipientPublicKey, //  no signature this time
+		oob,
+		salt,
+		data
+	],
+})
+// expected return value: account
+```
+
+This time  `recipientPublicKey`  is only the ephemeral public key `R` generated earlier in the Recipient side, just for the implementation to retrieve the corresponding private key `r`.  `data`  is the return value from the call to encapsulate private key, which is `S || cipher`.
+
+When the encapsulated private key `sk` is decrypted successfully, the implementation can process it further according to the designated purposes. Some general security guidelines SHALL be followed, for example, do  *not*  log the value, do securely wipe it after use, etc.
+
+The return value is the corresponding Ethereum address for `sk`, or empty if any error.
+
+### Options and Parameters
+
+Available elliptic curves are:
+
+- secp256k1 (mandatory)
+- Curve25519
+
+Available authenticated encryption schemes are:
+
+- AES-128-GCM (mandatory)
+- AES-256-GCM
+- Chacha20-Poly1305
+
+The version string is simply the concatenation of the elliptic curve and AE scheme, for example, secp256k1-AES-128-GCM. The above lists allow a combination of six different concrete schemes. Implementations are encouraged to implement curve-related logic separately from authenticated encryption schemes to avoid duplication and to promote interoperability.
+
+Signature algorithms for each curve are:
+
+- secp256k1 --> ECDSA
+- Curve25519 --> Ed25519
+
+## Rationale
+
+A critical difference between this [EIP-6051](./eip-6051.md) with [EIP-5630](./eip-5630.md) is that, as the purpose of key encapsulation is to transport a private key securely, the public key from the key recipient should be ephemeral, and mostly used only one-time. While in EIP-5630 settings, the public key of the message recipient shall be stable for a while so that message senders can encrypt messages without key discovery every time.
+
+There is security implication to this difference, including perfect forward secrecy. We aim to achieve perfect forward secrecy by generating ephemeral key pairs on both sides every time:
+
+1) first *Recipient* shall generate an ephemeral key pair, retain the private key securely, and export the public key;
+2) then *Sender* can securely wrap the private key in ECIES, with another ephemeral key pair, then destroy the ephemeral key securely;
+3) finally *Recipient* can unwrap the private key, then destroy its ephemeral key pair securely. After these steps, the cipher text in transport intercepted by a malicious 3rd party is no longer decryptable.
+
+## Backwards Compatibility
+
+No backward compatibility issues for this new proposal.
+
+### Interoperability
+
+To minimize potential compatibility issues among applications (including hardware wallets), this EIP requires that version secp256k1-AES-128-GCM MUST be supported.
+
+The version could be decided by the user or negotiated by both sides. When there is no user input or negotiation, secp256k1-AES-128-GCM is assumed.
+
+It is expected that implementations cover curve supports separately from encryption support, that is, all the versions that could be derived from the supported curve and supported encryption scheme should work.
+
+Signatures to `R` and `signerPubKey` are applied to byte array values instead of the encoded string.
+
+### UX Recommendations
+
+`salt` and/or `oob` data: both are inputs to the HKDF function (`oob` as “info” parameter). For better user experiences we suggest to require from users only one of them but this is up to the implementation.
+
+*Recipient Application* is assumed to be powerful enough. *Sender Application* could have very limited computing power and user interaction capabilities.
+
+## Test Cases
+
+For review purposes, the program to generate the test vectors is open-sourced and provided in the corresponding discussion thread.
+
+### Data Fixation
+
+Throughout the test cases, we fix values for the below data:
+
+- `sk`, the private key to be encapsulated, fixed to: `0xf8f8a2f43c8376ccb0871305060d7b27b0554d2cc72bccf41b2705608452f315`. The corresponding address is `0x001d3f1ef827552ae1114027bd3ecf1f086ba0f9`, called `account`. Note that these values come from the book *Mastering Ethereum* by Andreas M. Antonopoulos and Gavin Wood.
+- `r`, the Recipient private key, fixed to `0x6f2dd2a7804705d2d536bee92221051865a639efa23f5ca7c810e77048253a79`
+- `s`, the Sender private key, fixed to `0x28fa2db9f916e44fcc88370bedaf5eb3ec45632f040f4c1450c0f101e1e8bac8`
+- `signer`, the private key to sign the ephemeral public key, fixed to `0xac304db075d1685284ba5e10c343f2324ee32df3394fc093c98932517d36e344`. When used for Ed25519 signing, however, this value acts as `seed`, while the actual private key is calculated as `SHA512(seed)[:32]`. Or put another way, the public key is the scalar multiplication of hashed private key to the base point. Same for `trusted`.
+- `trusted`, the private key to sign `signerPubKey`, fixed to `0xda6649d68fc03b807e444e0034b3b59ec60716212007d72c9ddbfd33e25d38d1`
+- `oob`, fixed to `0x313233343536` (string value: `123456`)
+- `salt`, fixed to `0x6569703a2070726976617465206b657920656e63617073756c6174696f6e` (string value: `eip: private key encapsulation`)
+
+### Case 1
+
+Use `version` as `secp256k1-AES-128-GCM`. **R1** is provided as:
+
+```javascript
+request({
+	method: 'eth_generateEphemeralKeyPair',
+	params: [
+		version: 'secp256k1-AES-128-GCM',
+		signerPubKey: '0x035a5ca16997f9b9ead9572c9bde36c5dab584b17bc965cdd7c2945c776e981b0b'
+	],
+})
+```
+
+Suppose the implementation generates an ephemeral key pair `(r, R)`:
+
+```
+r: '0x6f2dd2a7804705d2d536bee92221051865a639efa23f5ca7c810e77048253a79',
+R: '0x039ef98feddb39664450c3876878093c70652caba7e3fd04333c0558ffdf798d09'
+```
+
+The return value could be:
+
+```
+'0x039ef98feddb39664450c3876878093c70652caba7e3fd04333c0558ffdf798d09536da06b8d9207040ada179dc2c38f701a1a21c9ab5a7d52f5da50ea438e8ccf47dac77547fbdde194f71db52860b9e10ca2b089646f133d172124504ac1996a'
+```
+
+Note that `R` is compressed and `R` leads the return value: `R || sig`.
+
+Therefore **R2** could be provided as:
+
+```javascript
+request({
+	method: 'eth_encapsulatePrivateKey',
+	params: [
+		version: 'secp256k1-AES-128-GCM',
+		recipient: '0x039ef98feddb39664450c3876878093c70652caba7e3fd04333c0558ffdf798d09536da06b8d9207040ada179dc2c38f701a1a21c9ab5a7d52f5da50ea438e8ccf47dac77547fbdde194f71db52860b9e10ca2b089646f133d172124504ac1996a',
+		signerPubKey: '0x035a5ca16997f9b9ead9572c9bde36c5dab584b17bc965cdd7c2945c776e981b0b5bd427c527b7f1012b8edfd179b9002a7f2d7fc326bb6ae9aaf38b44eb93c397631fd8bb05fd78fa16ecca1eb19652b200f9048611265bc81f485cf60f29d6de',
+		oob: '0x313233343536',
+		salt: '0x6569703a2070726976617465206b657920656e63617073756c6174696f6e',
+		account: '0x001d3f1ef827552ae1114027bd3ecf1f086ba0f9'
+	],
+})
+```
+
+*Sender Application* first verifies first layer signature as ECDSA over secp256k1:
+
+```
+// actual message to be signed should be the decoded byte array
+msg: '0x039ef98feddb39664450c3876878093c70652caba7e3fd04333c0558ffdf798d09',
+sig: '0x536da06b8d9207040ada179dc2c38f701a1a21c9ab5a7d52f5da50ea438e8ccf47dac77547fbdde194f71db52860b9e10ca2b089646f133d172124504ac1996aaf4a811661741a43587dd458858b75c582ca7db82fa77b',
+//signerPubKey
+pub: '0x035a5ca16997f9b9ead9572c9bde36c5dab584b17bc965cdd7c2945c776e981b0b'
+```
+
+Then it proceeds to verify the second layer signature, also as ECDSA over secp256k1:
+
+```
+// actual message to be signed should be the decoded byte array
+msg: '0x035a5ca16997f9b9ead9572c9bde36c5dab584b17bc965cdd7c2945c776e981b0b',
+sig: '0x5bd427c527b7f1012b8edfd179b9002a7f2d7fc326bb6ae9aaf38b44eb93c397631fd8bb05fd78fa16ecca1eb19652b200f9048611265bc81f485cf60f29d6de',
+//trustedPubKey
+pub: '0x027fb72176f1f9852ce7dd9dc3aa4711675d3d8dc5102b86d758d853002137e839'
+```
+
+Since *Sender Application* trusts `trustedPubKey`, the signature verification succeeds.
+
+Suppose the implementation generates an ephemeral key pair `(s, S)` as:
+
+```
+s: '0x28fa2db9f916e44fcc88370bedaf5eb3ec45632f040f4c1450c0f101e1e8bac8',
+S: '0x02ced2278d9ebb193f166d4ee5bbbc5ab8ca4b9ddf23c4172ad11185c079944c02'
+```
+
+The shared secret, symmetric key, and IV should be:
+
+```
+ss: '0x8e83bc5a9c77b11afc12c9a8262b16e899678d1720459e3b73ca2abcfed1fca3',
+skey: '0x6ccc02a61aa16d6c66a1277e5e2434b8',
+IV: '0x9c7a0f870d17ced2d2c3d1cf'
+```
+
+Then the return value should be:
+
+```
+'0x02ced2278d9ebb193f166d4ee5bbbc5ab8ca4b9ddf23c4172ad11185c079944c02abff407e8901bb37d13d724a2e3a8a1a5af300adc286aa2ec65ef2a38c10c5cec68a949d0a20dbad2a8e5dfd7a14bbcb'
+```
+
+With compressed public key `S` leading `cipher`, which in turn is (added prefix '0x'):
+
+```
+'0xabff407e8901bb37d13d724a2e3a8a1a5af300adc286aa2ec65ef2a38c10c5cec68a949d0a20dbad2a8e5dfd7a14bbcb'
+```
+
+Then **R3** is provided as:
+
+```javascript
+request({
+	method: 'eth_intakePrivateKey',
+	params: [
+		version: 'secp256k1-AES-128-GCM',
+		recipientPublicKey: '0x039ef98feddb39664450c3876878093c70652caba7e3fd04333c0558ffdf798d09',
+		oob: '0x313233343536',
+		salt: '0x6569703a2070726976617465206b657920656e63617073756c6174696f6e',
+		data: '0x02ced2278d9ebb193f166d4ee5bbbc5ab8ca4b9ddf23c4172ad11185c079944c02abff407e8901bb37d13d724a2e3a8a1a5af300adc286aa2ec65ef2a38c10c5cec68a949d0a20dbad2a8e5dfd7a14bbcb'
+	],
+})
+```
+
+The return value should be `0x001d3f1ef827552ae1114027bd3ecf1f086ba0f9`. This matches the `account` parameter in **R2**.
+
+### Case 2
+
+Use `version` as `secp256k1-AES-256-GCM`. The calculated symmetric key `skey`, `IV`, and `cipher` will be different. **R1** is provided as:
+
+```javascript
+request({
+	method: 'eth_generateEphemeralKeyPair',
+	params: [
+		version: 'secp256k1-AES-256-GCM',
+		signerPubKey: '0x035a5ca16997f9b9ead9572c9bde36c5dab584b17bc965cdd7c2945c776e981b0b'
+	],
+})
+```
+
+Note that only the `version` is different (AES key size). We keep using the same `(r, R)` (this is just a test vector).
+
+Therefore **R2** is provided as:
+
+```javascript
+request({
+	method: 'eth_encapsulatePrivateKey',
+	params: [
+		version: 'secp256k1-AES-256-GCM',
+		recipient: '0x039ef98feddb39664450c3876878093c70652caba7e3fd04333c0558ffdf798d09536da06b8d9207040ada179dc2c38f701a1a21c9ab5a7d52f5da50ea438e8ccf47dac77547fbdde194f71db52860b9e10ca2b089646f133d172124504ac1996a',
+		signerPubKey: '0x035a5ca16997f9b9ead9572c9bde36c5dab584b17bc965cdd7c2945c776e981b0b5bd427c527b7f1012b8edfd179b9002a7f2d7fc326bb6ae9aaf38b44eb93c397631fd8bb05fd78fa16ecca1eb19652b200f9048611265bc81f485cf60f29d6de',
+		oob: '0x313233343536',
+		salt: '0x6569703a2070726976617465206b657920656e63617073756c6174696f6e',
+		account: '0x001d3f1ef827552ae1114027bd3ecf1f086ba0f9'
+	],
+})
+```
+
+Suppose the implementation generates the same `(s, S)` as [Case 1](#case-1). The shared secret, symmetric key, and IV should be:
+
+```
+ss: '0x8e83bc5a9c77b11afc12c9a8262b16e899678d1720459e3b73ca2abcfed1fca3',
+skey: '0x6ccc02a61aa16d6c66a1277e5e2434b89c7a0f870d17ced2d2c3d1cfd0e6f199',
+IV: '0x3369b9570b9d207a0a8ebe27'
+```
+
+With shared secret `ss` remaining the same as [Case 1](#case-1), symmetric key `skey` contains both the `skey` and `IV` from [Case 1](#case-1). IV is changed.
+
+Then the return value should be the following, with the `S` part the same as [Case 1](#case-1) and the `cipher` part different:
+
+```
+'0x02ced2278d9ebb193f166d4ee5bbbc5ab8ca4b9ddf23c4172ad11185c079944c0293910a91270b5deb0a645cc33604ed91668daf72328739d52a5af5a4760c4f3a9592b8f6d9b3ebe25127e7bf1c43b839'
+```
+
+Then **R3** is provided as:
+
+```javascript
+request({
+	method: 'eth_intakePrivateKey',
+	params: [
+		version: 'secp256k1-AES-256-GCM',
+		recipientPublicKey: '0x039ef98feddb39664450c3876878093c70652caba7e3fd04333c0558ffdf798d09',
+		oob: '0x313233343536',
+		salt: '0x6569703a2070726976617465206b657920656e63617073756c6174696f6e',
+		data: '0x02ced2278d9ebb193f166d4ee5bbbc5ab8ca4b9ddf23c4172ad11185c079944c0293910a91270b5deb0a645cc33604ed91668daf72328739d52a5af5a4760c4f3a9592b8f6d9b3ebe25127e7bf1c43b839'
+	],
+})
+```
+
+The return value should be `0x001d3f1ef827552ae1114027bd3ecf1f086ba0f9`. This matches the `account` parameter in **R2**.
+
+### Case 3
+
+Use `version` as: `Curve-25519-Chacha20-Poly1305`. **R1** is provided as:
+
+```javascript
+request({
+	method: 'eth_generateEphemeralKeyPair',
+	params: [
+		version: 'Curve25519-Chacha20-Poly1305',
+		signerPubKey: '0xe509fb840f6d5a69333ef68d69b86de55b9b905e45b16e3591912c097ba69938'
+	],
+})
+```
+
+Note that with Curve25519 the size is 32 (bytes) for both the public key and private key. And there is no compression for the public key. `signerPubKey` is calculated as:
+
+```
+//signer is '0xac304db075d1685284ba5e10c343f2324ee32df3394fc093c98932517d36e344'
+s := SHA512(signer)[:32]
+signerPubKey := Curve25519.ScalarBaseMult(s).ToHex()
+```
+
+The same technique applies to `trustedPubKey`. With `r` the same as in [Case 1](#case-1) and [Case 2](#case-2) and the curve being changed, the return value is `R = [r]G || sig`:
+
+```
+R = '0xc0ea3514b0ab83b2fe4f4ef96159cda8fa836ce549ef09569b901eef0723bf79cac06de279ec7f65f6b75f6bee740496df0650a6de61da5e691d7c5da1c7cb1ece61c669dd588a1029c38f11ad1714c1c9742232f9562ca6bbc7bad57882da04'
+```
+
+**R2** is provided as:
+
+```javascript
+request({
+	method: 'eth_encapsulatePrivateKey',
+	params: [
+		version: 'Curve25519-Chacha20-Poly1305',
+		recipient: '0xc0ea3514b0ab83b2fe4f4ef96159cda8fa836ce549ef09569b901eef0723bf79879d900f04a955078ff6ae86f1d1b69b3e1265370e64bf064adaecb895c51effa3bdae7964bf8f9a6bfaef3b66306c1bc36afa5607a51b9768aa42ac2c961f02',
+		signerPubKey: '0xe509fb840f6d5a69333ef68d69b86de55b9b905e45b16e3591912c097ba69938d43e06a0f32c9e5ddb39fce34fac2b6f5314a1b1583134f27426d50af7094b0c101e848737e7f717da8c8497be06bab2a9536856c56eee194e89e94fd1bba509',
+		oob: '0x313233343536',
+		salt: '0x6569703a2070726976617465206b657920656e63617073756c6174696f6e',
+		account: '0x001d3f1ef827552ae1114027bd3ecf1f086ba0f9'
+	],
+})
+```
+
+Both `recipient` and `signerPubKey` have been signed in Ed25519. Verifying signature to `R` is carried out as:
+
+```
+// actual message to be signed should be the decoded byte array
+msg: '0xc0ea3514b0ab83b2fe4f4ef96159cda8fa836ce549ef09569b901eef0723bf79',
+sig: '0x879d900f04a955078ff6ae86f1d1b69b3e1265370e64bf064adaecb895c51effa3bdae7964bf8f9a6bfaef3b66306c1bc36afa5607a51b9768aa42ac2c961f02',
+//signerPubKey
+pub: '0xe509fb840f6d5a69333ef68d69b86de55b9b905e45b16e3591912c097ba69938'
+```
+
+After successfully verifying the signature (and the one by `trustedPubKey`), the implementation then generates ephemeral key pair `(s, S)` in Curve25519:
+
+```
+// s same as Case 1 and Case 2
+s = '0x28fa2db9f916e44fcc88370bedaf5eb3ec45632f040f4c1450c0f101e1e8bac8',
+S = '0xd2fd6fcaac231d08363e736e61edb7e7696b13a727e3d2a239415cb8dc6ee278'
+```
+
+The shared secret, symmetric key, and IV should be:
+
+```
+ss: '0xe0b36f56cdb63c27e933a5a67a5e97db4b566c9276a36aeee5dc6e87da118867',
+skey: '0x7c6fa749e6df13c8578dc44cb24cdf46a44cb163e1e570c2e590c720aed5783f',
+IV: '0x3c98ef6fc34b0d6e7e16bd78'
+```
+
+Then the return value should be `S || cipher`:
+
+```
+'0xd2fd6fcaac231d08363e736e61edb7e7696b13a727e3d2a239415cb8dc6ee2786a7e2e40efb86dc68f44f3e032bbedb1259fa820e548ac5adbf191784c568d4f642ca5b60c0b2142189dff6ee464b95c'
+```
+
+Then **R3** is provided as:
+
+```javascript
+request({
+	method: 'eth_intakePrivateKey',
+	params: [
+		version: 'Curve25519-Chacha20-Poly1305',
+		recipientPublicKey: '0xc0ea3514b0ab83b2fe4f4ef96159cda8fa836ce549ef09569b901eef0723bf79',
+		oob: '0x313233343536',
+		salt: '0x6569703a2070726976617465206b657920656e63617073756c6174696f6e',
+		data: '0xd2fd6fcaac231d08363e736e61edb7e7696b13a727e3d2a239415cb8dc6ee2786a7e2e40efb86dc68f44f3e032bbedb1259fa820e548ac5adbf191784c568d4f642ca5b60c0b2142189dff6ee464b95c'
+	],
+})
+```
+
+The return value should be `0x001d3f1ef827552ae1114027bd3ecf1f086ba0f9`. This matches the `account` parameter in **R2**.
+
+## Security Considerations
+
+### Perfect Forward Secrecy
+
+PFS is achieved by using ephemeral key pairs on both sides.
+
+### Optional Signature and Trusted Public Keys
+
+`R` could be signed so that *Sender Application* can verify if `R` could be trusted or not. This involves both signature verification and if the signer could be trusted or not. While signature verification is quite straightforward in itself, the latter should be managed with care. To facilitate this trust management issue, `signerPubKey` could be further signed, creating a dual-layer trust structure:
+
+```
+R <-- signerPubKey <-- trustedPubKey
+```
+
+This allows various strategies to manage trust. For example:
+
+- A hardware wallet vendor which takes it very seriously about the brand reputation and the fund safety for its customers, could choose to trust only its own public keys, all instances of `trustedPubKey`. These public keys only sign `signerPubKey` from selected partners.
+- A MPC service could publish its `signerPubKey` online so that *Sender Application* won't verify the signature against a wrong or fake public key.
+
+Note that it is advised that a separate key pair should be used for signing on each curve.
+
+### Security Level
+
+1. We are not considering post-quantum security. If the quantum computer becomes a materialized threat, the underlying cipher of Ethereum and other L1 chains would have been replaced, and this EIP will be outdated then (as the EC part of ECIES is also broken).
+2. The security level shall match that of the elliptic curve used by the underlying chains. It does not make much sense to use AES-256 to safeguard a secp256k1 private key but implementations could choose freely.
+3. That being said, a key might be used in multiple chains. So the security level shall cover the most demanding requirement and potential future developments.
+
+AES-128, AES-256, and ChaCha20 are provided.
+
+### Randomness
+
+`r` and `s` must be generated with a cryptographic secure random number generator (CSRNG).
+
+`salt`  could be random bytes generated the same way as  `r`  or  `s`.  `salt`  could be in any length but the general suggestion is 12 or 16, which could be displayed as a QR code by the screen of some hardware wallet (so that another application could scan to read). If  `salt`  is not provided, this EIP uses the default value as `EIP-6051`.
+
+### Out of Band Data
+
+`oob`  data is optional. When non-empty, its content is digits or an alpha-numeric string from the user. *Sender Application* may mandate  `oob`  from the user.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 0386f347448b73d4eecc5d3555de7f1da6223eae Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 27 Dec 2022 10:15:11 -0500
Subject: [PATCH 087/274] Update EIP-5380: Move to Review (#6217)

---
 EIPS/eip-5380.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5380.md b/EIPS/eip-5380.md
index 32e996fc3e6c39..1da37a40cf1650 100644
--- a/EIPS/eip-5380.md
+++ b/EIPS/eip-5380.md
@@ -4,7 +4,7 @@ title: EIP-721 Entitlement Extension
 description: Allows token owners to grant the ability for others to use specific properties of those tokens
 author: Pandapip1 (@Pandapip1), Tim Daubenschütz (@TimDaub)
 discussions-to: https://ethereum-magicians.org/t/pr-5380-eip-4907-alternative-design/10190
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-03-11

From 732793d584b023adec15c5126829016b91e04753 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 27 Dec 2022 12:57:03 -0500
Subject: [PATCH 088/274] Update EIP-6059: Fix multi-line list elements (#6223)

---
 EIPS/eip-6059.md | 63 ++++++++++++++----------------------------------
 1 file changed, 18 insertions(+), 45 deletions(-)

diff --git a/EIPS/eip-6059.md b/EIPS/eip-6059.md
index 2a1430bf4165ae..ebafebe5ef4fd2 100644
--- a/EIPS/eip-6059.md
+++ b/EIPS/eip-6059.md
@@ -371,40 +371,23 @@ ID MUST never be a `0` value, as this proposal uses `0` values do signify that t
 
 Designing the proposal, we considered the following questions:
 
-1. **How to name the proposal?**
-
+1. **How to name the proposal?**\
 In an effort to provide as much information about the proposal we identified the most important aspect of the proposal; the parent centered control over nesting. The child token's role is only to be able to be `Nestable` and support a token owning it. This is how we landed on the `Parent-Centered` part of the title.
-
-2. **Why is automatically accepting a child using [EIP-712](./eip-712.md) permit-style signatures not a part of this proposal?**
-
+2. **Why is automatically accepting a child using [EIP-712](./eip-712.md) permit-style signatures not a part of this proposal?**\
 For consistency. This proposal extends EIP-721 which already uses 1 transaction for approving operations with tokens. It would be inconsistent to have this and also support signing messages for operations with assets.
-
-3. **Why use indexes?** 
-
-To reduce the gas consumption. If the token ID was used to find which token to accept or reject, iteration over arrays would be required and the cost of the operation would depend on the size of the active or pending children arrays. With the index, the cost is fixed. Lists of active and pending children per token need to be maintained, since methods to get them are part of the proposed interface.
-
-To avoid race conditions in which the index of a token changes, the expected token ID as well as the expected token's collection smart contract is included in operations requiring token index, to verify that the token being accessed using the index is the expected one.
-
+3. **Why use indexes?**\
+To reduce the gas consumption. If the token ID was used to find which token to accept or reject, iteration over arrays would be required and the cost of the operation would depend on the size of the active or pending children arrays. With the index, the cost is fixed. Lists of active and pending children per token need to be maintained, since methods to get them are part of the proposed interface.\
+To avoid race conditions in which the index of a token changes, the expected token ID as well as the expected token's collection smart contract is included in operations requiring token index, to verify that the token being accessed using the index is the expected one.\
 Implementation that would internally keep track of indices using mapping was attempted. The minimum cost of accepting a child token was increased by over 20% and the cost of minting has increased by over 15%. We concluded that it is not necessary for this proposal and can be implemented as an extension for use cases willing to accept the increased transaction cost this incurs. In the sample implementation provided, there are several hooks which make this possible.
-
-4. **Why is the pending children array limited instead of supporting pagination?**
-
-The pending child tokens array is not meant to be a buffer to collect the tokens that the root owner of the parent token wants to keep, but not enough to promote them to active children. It is meant to be an easily traversable list of child token candidates and should be regularly maintained; by either accepting or rejecting proposed child tokens. There is also no need for the pending child tokens array to be unbounded, because active child tokens array is.
-
-Another benefit of having bounded child tokens array is to guard against spam and griefing. As minting malicious or spam tokens could be relatively easy and low-cost, the bounded pending array assures that all of the tokens in it are easy to identify and that legitimate tokens are not lost in a flood of spam tokens, if one occurs.
-
+4. **Why is the pending children array limited instead of supporting pagination?**\
+The pending child tokens array is not meant to be a buffer to collect the tokens that the root owner of the parent token wants to keep, but not enough to promote them to active children. It is meant to be an easily traversable list of child token candidates and should be regularly maintained; by either accepting or rejecting proposed child tokens. There is also no need for the pending child tokens array to be unbounded, because active child tokens array is.\
+Another benefit of having bounded child tokens array is to guard against spam and griefing. As minting malicious or spam tokens could be relatively easy and low-cost, the bounded pending array assures that all of the tokens in it are easy to identify and that legitimate tokens are not lost in a flood of spam tokens, if one occurs.\
 A consideration tied to this issue was also how to make sure, that a legitimate token is not accidentally rejected when clearing the pending child tokens array. We added the maximum pending children to reject argument to the clear pending child tokens array call. This assures that only the intended number of pending child tokens is rejected and if a new token is added to the pending child tokens array during the course of preparing such call and executing it, the clearing of this array SHOULD result in a reverted transaction.
-
-5. **Should we allow tokens to be nested into one of its children?**
-
+5. **Should we allow tokens to be nested into one of its children?**\
 The proposal enforces that a parent token can't be nested into one of its child token, or downstream child tokens for that matter. A parent token and its children are all managed by the parent token's root owner. This means that if a token would be nested into one of its children, this would create the ownership loop and none of the tokens within the loop could be managed anymore.
-
-6. **Why is there not a "safe" nest transfer method?**
-
+6. **Why is there not a "safe" nest transfer method?**\
 `nestTransfer` is always "safe" since it MUST check for `INestable` compatibility on the destination.
-
-7. **How does this proposal differ from the other proposals trying to address a similar problem?**
-
+7. **How does this proposal differ from the other proposals trying to address a similar problem?**\
 This interface allows for tokens to both be sent to and receive other tokens. The propose-accept and parent governed patterns allow for a more secure use. The backward compatibility is only added for EIP-721, allowing for a simpler interface. The proposal also allows for different collections to inter-operate, meaning that nesting is not locked to a single smart contract, but can be executed between completely separate NFT collections.
 
 ### Propose-Commit pattern for child token management
@@ -454,26 +437,16 @@ To better understand how these state transitions are achieved, we have to look a
 
 Based on the desired state transitions, the values of these parameters have to be set accordingly (any parameters not set in the following examples depend on the child token being managed):
 
-1. **Reject child token**
-
+1. **Reject child token**\
 ![Reject child token](../assets/eip-6059/img/eip-6059-reject-child.png)
-
-2. **Abandon child token**
-
+2. **Abandon child token**\
 ![Abandon child token](../assets/eip-6059/img/eip-6059-abandon-child.png)
-
-3. **Unnest child token**
-
-![Unnest child token](../assets/eip-6059/img/eip-6059-unnest-child.png)
-
-4. **Transfer the child token to an EOA or an `ERC721Receiver`**
-
+3. **Unnest child token**\
+![Unnest child token](../assets/eip-6059/img/eip-6059-unnest-child.png)\
+4. **Transfer the child token to an EOA or an `ERC721Receiver`**\
 ![Transfer child token to EOA](../assets/eip-6059/img/eip-6059-transfer-child-to-eoa.png)
-
-5. **Transfer the child token into a new parent token**
-
-![Transfer child token to parent token](../assets/eip-6059/img/eip-6059-transfer-child-to-token.png)
-
+5. **Transfer the child token into a new parent token**\
+![Transfer child token to parent token](../assets/eip-6059/img/eip-6059-transfer-child-to-token.png)\
 This state change places the token in the pending array of the new parent token. The child token still needs to be accepted by the new parent token's root owner in order to be placed into the active array of that token.
 
 ## Backwards Compatibility

From 3419568ae831ab6a07de8713c2a34eeaacc975d3 Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Tue, 27 Dec 2022 19:13:44 +0100
Subject: [PATCH 089/274] Fix formatting of ordered list in Rationale (#6225)

---
 EIPS/eip-5773.md | 39 ++++++++++++---------------------------
 1 file changed, 12 insertions(+), 27 deletions(-)

diff --git a/EIPS/eip-5773.md b/EIPS/eip-5773.md
index 23114adaa37b6e..43918b3f44db52 100644
--- a/EIPS/eip-5773.md
+++ b/EIPS/eip-5773.md
@@ -425,39 +425,24 @@ The optional properties of the metadata JSON MAY include the following fields, o
 
 Designing the proposal, we considered the following questions:
 
-1. **Should we use Asset or Resource when referring to the structure that comprises the token?**
-
-The original idea was to call the proposal Multi-Resource, but while this denoted the broadness of the structures that could be held by a single token, the term *asset* represents it better.
-
+1. **Should we use Asset or Resource when referring to the structure that comprises the token?**\
+The original idea was to call the proposal Multi-Resource, but while this denoted the broadness of the structures that could be held by a single token, the term *asset* represents it better.\
 An asset is defined as something that is owned by a person, company, or organization, such as money, property, or land. This is the best representation of what an asset of this proposal can be. An asset in this proposal can be a multimedia file, technical information, a land deed, or anything that the implementer has decided to be an asset of the token they are implementing.
-
-2. **Why are [EIP-712](./eip-712.md) permit-style signatures to manage approvals not used?**
-
+2. **Why are [EIP-712](./eip-712.md) permit-style signatures to manage approvals not used?**\
 For consistency. This proposal extends EIP-721 which already uses 1 transaction for approving operations with tokens. It would be inconsistent to have this and also support signing messages for operations with assets.
-
-3. **Why use indexes?**
-
-To reduce the gas consumption. If the asset ID was used to find which asset to accept or reject, iteration over arrays would be required and the cost of the operation would depend on the size of the active or pending assets arrays. With the index, the cost is fixed. A list of active and pending assets arrays per token need to be maintained, since methods to get them are part of the proposed interface.
-
-To avoid race conditions in which the index of an asset changes, the expected asset ID is included in operations requiring asset index, to verify that the asset being accessed using the index is the expected asset.
-
+3. **Why use indexes?**\
+To reduce the gas consumption. If the asset ID was used to find which asset to accept or reject, iteration over arrays would be required and the cost of the operation would depend on the size of the active or pending assets arrays. With the index, the cost is fixed. A list of active and pending assets arrays per token need to be maintained, since methods to get them are part of the proposed interface.\
+To avoid race conditions in which the index of an asset changes, the expected asset ID is included in operations requiring asset index, to verify that the asset being accessed using the index is the expected asset.\
 Implementation that would internally keep track of indices using mapping was attempted. The average cost of adding an asset to a token increased by over 25%, costs of accepting and rejecting assets also increased 4.6% and 7.1% respectively. We concluded that it is not necessary for this proposal and can be implemented as an extension for use cases willing to accept this cost. In the sample implementation provided, there are several hooks which make this possible.
-
-4. **Why is a method to get all the assets not included?**
-
+4. **Why is a method to get all the assets not included?**\
 Getting all assets might not be an operation necessary for all implementers. Additionally, it can be added either as an extension, doable with hooks, or can be emulated using an indexer.
-
-5. **Why is pagination not included?**
-
+5. **Why is pagination not included?**\
 Asset IDs use `uint64`, testing has confirmed that the limit of IDs you can read before reaching the gas limit is around 30.000. This is not expected to be a common use case so it is not a part of the interface. However, an implementer can create an extension for this use case if needed.
-
-6. **How does this proposal differ from the other proposals trying to address a similar problem?**
-
+6. **How does this proposal differ from the other proposals trying to address a similar problem?**\
 After reviewing them, we concluded that each contains at least one of these limitations:
-
-- Using a single URI which is replaced as new assets are needed, this introduces a trust issue for the token owner.
-- Focusing only on a type of asset, while this proposal is asset type agnostic.
-- Having a different token for each new use case, this means that the token is not forward-compatible.
+   - Using a single URI which is replaced as new assets are needed, this introduces a trust issue for the token owner.
+   - Focusing only on a type of asset, while this proposal is asset type agnostic.
+   - Having a different token for each new use case, this means that the token is not forward-compatible.
 
 ### Multi-Asset Storage Schema
 

From 6ea1ff17507188bf0283081f1287fdfff74984d5 Mon Sep 17 00:00:00 2001
From: Ori Pomerantz <qbzzt1@gmail.com>
Date: Wed, 28 Dec 2022 00:22:46 -0600
Subject: [PATCH 090/274] Updated EIP 3540's data section to new format (#6222)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Updated EIP 3540's data section to new format

* Update EIPS/eip-3540.md

Co-authored-by: Paweł Bylica <chfast@gmail.com>

Co-authored-by: Paweł Bylica <chfast@gmail.com>
---
 EIPS/eip-3540.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-3540.md b/EIPS/eip-3540.md
index 951492eaf5a37a..5a1da1e40d80b1 100644
--- a/EIPS/eip-3540.md
+++ b/EIPS/eip-3540.md
@@ -238,10 +238,10 @@ We have considered different questions for the sections:
 
 ### Data-only contracts
 
-The EOF prevents deploying contracts with arbitrary bytes (data-only contracts: their purpose is to store data not execution). **EOF1 requires** presence of a **code section** therefore the minimal overhead EOF data contract consist of a data section and one code section with single instruction. We recommend to use `INVALID` instruction in this case. In total there are 11 additional bytes required.
+The EOF prevents deploying contracts with arbitrary bytes (data-only contracts: their purpose is to store data not execution). **EOF1 requires** presence of a **code section** therefore the minimal overhead EOF data contract consist of a data section and one code section with single instruction. We recommend to use `INVALID` instruction in this case. In total there are 20 additional bytes required.
 
 ```
-EF0001 010001 02<data-size> 00 FE <data>
+EF0001 010004 020001 0001 03 <data size (2 bytes)> 00 00000000 FE <data>
 ```
 
 It is possible in the future that this data will be accessible with data-specific opcodes, such as `DATACOPY` or `EXTDATACOPY`. Until then, callers will need to determine the data offset manually.

From f6c5558bc9a2841ab2d9811ffee7702b14f82209 Mon Sep 17 00:00:00 2001
From: Sam Porter <79773335+SamPorter1984@users.noreply.github.com>
Date: Wed, 28 Dec 2022 14:02:45 +0300
Subject: [PATCH 091/274] Update eip-3561.md (#6230)

* Update eip-3561.md

* Update eip-3561.md

* Update eip-3561.md
---
 EIPS/eip-3561.md | 374 +++++++++++++++++++++++++++--------------------
 1 file changed, 212 insertions(+), 162 deletions(-)

diff --git a/EIPS/eip-3561.md b/EIPS/eip-3561.md
index d2f17744f291f3..f3fbee881717ab 100644
--- a/EIPS/eip-3561.md
+++ b/EIPS/eip-3561.md
@@ -11,10 +11,12 @@ created: 2021-05-09
 ---
 
 ## Abstract
-Removing trust from upgradeability proxy is required for anonymous developers. To achieve that, disallowing instant, potentially malicious upgrades is required. This EIP introduces additional storage slots for upgradeability proxy which are assumed to decrease trust in interaction with upgradeable smart contracts. Defined by the admin implementation becomes an active implementation only after Zero Trust Period allows.
+
+Removing trust from upgradeability proxy is necessary for anonymous developers. In order to accomplish this, instant and potentially malicious upgrades must be prevented. This EIP introduces additional storage slots for upgradeability proxy which are assumed to decrease trust in interaction with upgradeable smart contracts. Defined by the admin implementation logic can be made an active implementation logic only after Zero Trust Period allows.
 
 ## Motivation
-It's usually not possible for anonymous developers who uses upgradeability proxies to gain community trust.
+
+Anonymous developers who utilize upgradeability proxies typically struggle to earn the trust of the community.
 
 Fairer, better future for humanity absolutely requires some developers to stay anonymous while still attract vital attention to solutions they propose and at the same time leverage the benefits of possible upgradeability.
 
@@ -24,17 +26,19 @@ The specification is an addition to the standard [EIP-1967](./eip-1967.md) trans
 The specification focuses on the slots it adds. All admin interactions with trust minimized proxy must emit an event to make admin actions trackable, and all admin actions must be guarded with `onlyAdmin()` modifier.
 
 ### Next Logic Contract Address
+
 Storage slot `0x19e3fabe07b65998b604369d85524946766191ac9434b39e27c424c976493685` (obtained as `bytes32(uint256(keccak256('eip3561.proxy.next.logic')) - 1)`).
-Logic address must be first defined as next logic, before it can function as actual logic implementation stored in EIP-1967 `IMPLEMENTATION_SLOT`.
+Desirable implementation logic address must be first defined as next logic, before it can function as actual logic implementation stored in EIP-1967 `IMPLEMENTATION_SLOT`.
 Admin interactions with next logic contract address correspond with these methods and events:
+
 ```solidity
-// sets next logic contract address and initializes it. Emits NextLogicDefined
-// 0x as calldata is an equivalent of proposeTo()
-// calldata is ignored here if zero trust period, described below, was already set
-function proposeTo(address implementation, bytes calldata data) external onlyAdmin;
-// sets the address stored as next implementation as current IMPLEMENTATION_SLOT
-// as soon UPGRADE_BLOCK_SLOT allows
-function upgrade() external onlyAdmin;
+// Sets next logic contract address. Emits NextLogicDefined
+// If current implementation is address(0), then upgrades to IMPLEMENTATION_SLOT
+// immedeatelly, therefore takes data as an argument
+function proposeTo(address implementation, bytes calldata data) external IfAdmin
+// As soon UPGRADE_BLOCK_SLOT allows, sets the address stored as next implementation
+// as current IMPLEMENTATION_SLOT and initializes it.
+function upgrade(bytes calldata data) external IfAdmin
 // cancelling is possible for as long as upgrade() for given next logic was not called
 // emits NextLogicCanceled
 function cancelUpgrade() external onlyAdmin;
@@ -44,189 +48,235 @@ event NextLogicCanceled(address indexed oldLogic);
 ```
 
 ### Upgrade Block
+
 Storage slot `0xe3228ec3416340815a9ca41bfee1103c47feb764b4f0f4412f5d92df539fe0ee` (obtained as `bytes32(uint256(keccak256('eip3561.proxy.next.logic.block')) - 1)`).
-On/after this block next logic contract address can be set to EIP-1967 `IMPLEMENTATION_SLOT` or, in other words, start to function as current logic. Updated automatically according to Zero Trust Period, shown as `earliestArrivalBlock` in the event `NextLogicDefined`.
+On/after this block next logic contract address can be set to EIP-1967 `IMPLEMENTATION_SLOT` or, in other words, `upgrade()` can be called. Updated automatically according to Zero Trust Period, shown as `earliestArrivalBlock` in the event `NextLogicDefined`.
 
 ### Propose Block
+
 Storage slot `0x4b50776e56454fad8a52805daac1d9fd77ef59e4f1a053c342aaae5568af1388` (obtained as `bytes32(uint256(keccak256('eip3561.proxy.propose.block')) - 1)`).
 Defines after/on which block *proposing* next logic is possible. Required for convenience, for example can be manually set to a year from given time. Can be set to maximum number to completely seal the code.
 Admin interactions with this slot correspond with this method and event:
+
 ```solidity
 function prolongLock(uint b) external onlyAdmin;
 event ProposingUpgradesRestrictedUntil(uint block, uint nextProposedLogicEarliestArrival);
 ```
 
 ### Zero Trust Period
+
 Storage slot `0x7913203adedf5aca5386654362047f05edbd30729ae4b0351441c46289146720` (obtained as `bytes32(uint256(keccak256('eip3561.proxy.zero.trust.period')) - 1)`).
 Zero Trust Period in amount of blocks, can only be set higher than previous value. While it is at default value(0), the proxy operates exactly as standard EIP-1967 transparent proxy. After zero trust period is set, all above specification is enforced.
 Admin interactions with this slot should correspond with this method and event:
+
 ```solidity
 function setZeroTrustPeriod(uint blocks) external onlyAdmin;
 event ZeroTrustPeriodSet(uint blocks);
 ```
+
 ### Implementation Example
+
 ```solidity
-pragma solidity >=0.8.0;//important
+pragma solidity >=0.8.0; //important
 
 // EIP-3561 trust minimized proxy implementation https://github.com/ethereum/EIPs/blob/master/EIPS/eip-3561.md
-
-contract TrustMinimizedProxy{
-	event Upgraded(address indexed toLogic);
-	event AdminChanged(address indexed previousAdmin, address indexed newAdmin);
-	event NextLogicDefined(address indexed nextLogic, uint earliestArrivalBlock);
-	event ProposingUpgradesRestrictedUntil(uint block, uint nextProposedLogicEarliestArrival);
-	event NextLogicCanceled();
-	event ZeroTrustPeriodSet(uint blocks);
-
-	bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
-	bytes32 internal constant LOGIC_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
-	bytes32 internal constant NEXT_LOGIC_SLOT = 0x19e3fabe07b65998b604369d85524946766191ac9434b39e27c424c976493685;
-	bytes32 internal constant NEXT_LOGIC_BLOCK_SLOT = 0xe3228ec3416340815a9ca41bfee1103c47feb764b4f0f4412f5d92df539fe0ee;
-	bytes32 internal constant PROPOSE_BLOCK_SLOT = 0x4b50776e56454fad8a52805daac1d9fd77ef59e4f1a053c342aaae5568af1388;
-	bytes32 internal constant ZERO_TRUST_PERIOD_SLOT = 0x7913203adedf5aca5386654362047f05edbd30729ae4b0351441c46289146720;
-
-	constructor() payable {
-		require(ADMIN_SLOT == bytes32(uint256(keccak256('eip1967.proxy.admin')) - 1) && LOGIC_SLOT==bytes32(uint256(keccak256('eip1967.proxy.implementation')) - 1)
-		&& NEXT_LOGIC_SLOT == bytes32(uint256(keccak256('eip3561.proxy.next.logic')) - 1) && NEXT_LOGIC_BLOCK_SLOT == bytes32(uint256(keccak256('eip3561.proxy.next.logic.block')) - 1)
-		&& PROPOSE_BLOCK_SLOT == bytes32(uint256(keccak256('eip3561.proxy.propose.block')) - 1) && ZERO_TRUST_PERIOD_SLOT == bytes32(uint256(keccak256('eip3561.proxy.zero.trust.period')) - 1));
-		_setAdmin(msg.sender);
-	}
-
-	modifier ifAdmin() {
-		if (msg.sender == _admin()) {
-			_;
-		} else {
-			_fallback();
-		}
-	}
-
-	function _logic() internal view returns (address logic) {
-		assembly { logic := sload(LOGIC_SLOT) }
-	}
-
-	function _nextLogic() internal view returns (address nextLogic) {
-		assembly { nextLogic := sload(NEXT_LOGIC_SLOT) }
-	}
-
-	function _proposeBlock() internal view returns (uint bl) {
-		assembly { bl := sload(PROPOSE_BLOCK_SLOT) }
-	}
-
-	function _nextLogicBlock() internal view returns (uint bl) {
-		assembly { bl := sload(NEXT_LOGIC_BLOCK_SLOT) }
-	}
-
-	function _zeroTrustPeriod() internal view returns (uint tm) {
-		assembly { tm := sload(ZERO_TRUST_PERIOD_SLOT) }
-	}
-
-	function _admin() internal view returns (address adm) {
-		assembly { adm := sload(ADMIN_SLOT) }
-	}
-
-	function _setAdmin(address newAdm) internal {
-		assembly { sstore(ADMIN_SLOT, newAdm) }
-	}
-
-	function changeAdmin(address newAdm) external ifAdmin {
-		emit AdminChanged(_admin(), newAdm);
-		_setAdmin(newAdm);
-	}
-
-	function upgrade(bytes calldata data) external ifAdmin {
-		require(block.number>=_nextLogicBlock(),"too soon");
-		address logic;
-		assembly {
-			logic := sload(NEXT_LOGIC_SLOT) 
-			sstore(LOGIC_SLOT,logic)
-		}
-		(bool success,) = logic.delegatecall(data);
-		require(success,"failed to call");
-		emit Upgraded(logic);
-	}
-
-	fallback () external payable {
-		_fallback();
-	}
-
-	receive () external payable {
-		_fallback();
-	}
-
-	function _fallback() internal {
-		require(msg.sender != _admin());
-		_delegate(_logic());
-	}
-
-	function cancelUpgrade() external ifAdmin {
-		address logic;
-		assembly {
-			logic := sload(LOGIC_SLOT)
-			sstore(NEXT_LOGIC_SLOT, logic)
-		}
-		emit NextLogicCanceled();
-	}
-
-	function prolongLock(uint b) external ifAdmin {
-		require(b > _proposeBlock(),"get maxxed");
-		assembly {sstore(PROPOSE_BLOCK_SLOT,b)}
-		emit ProposingUpgradesRestrictedUntil(b,b+_zeroTrustPeriod());
-	}
-
-	function setZeroTrustPeriod(uint blocks) external ifAdmin { // before this set at least once acts like a normal eip 1967 transparent proxy
-		uint ztp;
-		assembly { ztp := sload(ZERO_TRUST_PERIOD_SLOT) }
-		require(blocks>ztp,"can be only set higher");
-		assembly{ sstore(ZERO_TRUST_PERIOD_SLOT, blocks) }
-		emit ZeroTrustPeriodSet(blocks);
-	}
-	
-	function _updateBlockSlot() internal {
-		uint nlb = block.number + _zeroTrustPeriod();
-		assembly {sstore(NEXT_LOGIC_BLOCK_SLOT,nlb)}
-	}
-
-	function _setNextLogic(address nl) internal {
-		require(block.number >= _proposeBlock(),"too soon");
-		_updateBlockSlot();
-		assembly { sstore(NEXT_LOGIC_SLOT, nl)}
-		emit NextLogicDefined(nl,block.number + _zeroTrustPeriod());
-	}
-
-	function proposeTo(address newLogic, bytes calldata data) payable external ifAdmin {
-		if (_zeroTrustPeriod() == 0) {
-			_updateBlockSlot();
-			assembly {sstore(LOGIC_SLOT,newLogic)}
-			(bool success,) = newLogic.delegatecall(data);
-			require(success,"failed to call");
-			emit Upgraded(newLogic);
-		} else{
-			_setNextLogic(newLogic);
-		}
-	}
-
-	function _delegate(address logic_) internal {
-		assembly {
-			calldatacopy(0, 0, calldatasize())
-			let result := delegatecall(gas(), logic_, 0, calldatasize(), 0, 0)
-			returndatacopy(0, 0, returndatasize())
-			switch result
-			case 0 { revert(0, returndatasize()) }
-			default { return(0, returndatasize()) }
-		}
-	}
+// Based on EIP-1967 upgradeability proxy: https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1967.md
+
+contract TrustMinimizedProxy {
+    event Upgraded(address indexed toLogic);
+    event AdminChanged(address indexed previousAdmin, address indexed newAdmin);
+    event NextLogicDefined(address indexed nextLogic, uint earliestArrivalBlock);
+    event ProposingUpgradesRestrictedUntil(uint block, uint nextProposedLogicEarliestArrival);
+    event NextLogicCanceled();
+    event ZeroTrustPeriodSet(uint blocks);
+
+    bytes32 internal constant ADMIN_SLOT = 0xb53127684a568b3173ae13b9f8a6016e243e63b6e8ee1178d6a717850b5d6103;
+    bytes32 internal constant LOGIC_SLOT = 0x360894a13ba1a3210667c828492db98dca3e2076cc3735a920a3ca505d382bbc;
+    bytes32 internal constant NEXT_LOGIC_SLOT = 0x19e3fabe07b65998b604369d85524946766191ac9434b39e27c424c976493685;
+    bytes32 internal constant NEXT_LOGIC_BLOCK_SLOT = 0xe3228ec3416340815a9ca41bfee1103c47feb764b4f0f4412f5d92df539fe0ee;
+    bytes32 internal constant PROPOSE_BLOCK_SLOT = 0x4b50776e56454fad8a52805daac1d9fd77ef59e4f1a053c342aaae5568af1388;
+    bytes32 internal constant ZERO_TRUST_PERIOD_SLOT = 0x7913203adedf5aca5386654362047f05edbd30729ae4b0351441c46289146720;
+
+    constructor() payable {
+        require(
+            ADMIN_SLOT == bytes32(uint256(keccak256('eip1967.proxy.admin')) - 1) &&
+                LOGIC_SLOT == bytes32(uint256(keccak256('eip1967.proxy.implementation')) - 1) &&
+                NEXT_LOGIC_SLOT == bytes32(uint256(keccak256('eip3561.proxy.next.logic')) - 1) &&
+                NEXT_LOGIC_BLOCK_SLOT == bytes32(uint256(keccak256('eip3561.proxy.next.logic.block')) - 1) &&
+                PROPOSE_BLOCK_SLOT == bytes32(uint256(keccak256('eip3561.proxy.propose.block')) - 1) &&
+                ZERO_TRUST_PERIOD_SLOT == bytes32(uint256(keccak256('eip3561.proxy.zero.trust.period')) - 1)
+        );
+        _setAdmin(msg.sender);
+    }
+
+    modifier IfAdmin() {
+        if (msg.sender == _admin()) {
+            _;
+        } else {
+            _fallback();
+        }
+    }
+
+    function _logic() internal view returns (address logic) {
+        assembly {
+            logic := sload(LOGIC_SLOT)
+        }
+    }
+
+    function _nextLogic() internal view returns (address nextLogic) {
+        assembly {
+            nextLogic := sload(NEXT_LOGIC_SLOT)
+        }
+    }
+
+    function _proposeBlock() internal view returns (uint b) {
+        assembly {
+            b := sload(PROPOSE_BLOCK_SLOT)
+        }
+    }
+
+    function _nextLogicBlock() internal view returns (uint b) {
+        assembly {
+            b := sload(NEXT_LOGIC_BLOCK_SLOT)
+        }
+    }
+
+    function _zeroTrustPeriod() internal view returns (uint ztp) {
+        assembly {
+            ztp := sload(ZERO_TRUST_PERIOD_SLOT)
+        }
+    }
+
+    function _admin() internal view returns (address adm) {
+        assembly {
+            adm := sload(ADMIN_SLOT)
+        }
+    }
+
+    function _setAdmin(address newAdm) internal {
+        assembly {
+            sstore(ADMIN_SLOT, newAdm)
+        }
+    }
+
+    function changeAdmin(address newAdm) external IfAdmin {
+        emit AdminChanged(_admin(), newAdm);
+        _setAdmin(newAdm);
+    }
+
+    function upgrade(bytes calldata data) external IfAdmin {
+        require(block.number >= _nextLogicBlock(), 'too soon');
+        address logic;
+        assembly {
+            logic := sload(NEXT_LOGIC_SLOT)
+            sstore(LOGIC_SLOT, logic)
+        }
+        (bool success, ) = logic.delegatecall(data);
+        require(success, 'failed to call');
+        emit Upgraded(logic);
+    }
+
+    fallback() external payable {
+        _fallback();
+    }
+
+    receive() external payable {
+        _fallback();
+    }
+
+    function _fallback() internal {
+        require(msg.sender != _admin());
+        _delegate(_logic());
+    }
+
+    function cancelUpgrade() external IfAdmin {
+        address logic;
+        assembly {
+            logic := sload(LOGIC_SLOT)
+            sstore(NEXT_LOGIC_SLOT, logic)
+        }
+        emit NextLogicCanceled();
+    }
+
+    function prolongLock(uint b) external IfAdmin {
+        require(b > _proposeBlock(), 'can be only set higher');
+        assembly {
+            sstore(PROPOSE_BLOCK_SLOT, b)
+        }
+        emit ProposingUpgradesRestrictedUntil(b, b + _zeroTrustPeriod());
+    }
+
+    function setZeroTrustPeriod(uint blocks) external IfAdmin {
+        // before this set at least once acts like a normal eip 1967 transparent proxy
+        uint ztp;
+        assembly {
+            ztp := sload(ZERO_TRUST_PERIOD_SLOT)
+        }
+        require(blocks > ztp, 'can be only set higher');
+        assembly {
+            sstore(ZERO_TRUST_PERIOD_SLOT, blocks)
+        }
+        _updateNextBlockSlot();
+        emit ZeroTrustPeriodSet(blocks);
+    }
+
+    function _updateNextBlockSlot() internal {
+        uint nlb = block.number + _zeroTrustPeriod();
+        assembly {
+            sstore(NEXT_LOGIC_BLOCK_SLOT, nlb)
+        }
+    }
+
+    function _setNextLogic(address nl) internal {
+        require(block.number >= _proposeBlock(), 'too soon');
+        _updateNextBlockSlot();
+        assembly {
+            sstore(NEXT_LOGIC_SLOT, nl)
+        }
+        emit NextLogicDefined(nl, block.number + _zeroTrustPeriod());
+    }
+
+    function proposeTo(address newLogic, bytes calldata data) external payable IfAdmin {
+        if (_zeroTrustPeriod() == 0 || _logic() == address(0)) {
+            _updateNextBlockSlot();
+            assembly {
+                sstore(LOGIC_SLOT, newLogic)
+            }
+            (bool success, ) = newLogic.delegatecall(data);
+            require(success, 'failed to call');
+            emit Upgraded(newLogic);
+        } else {
+            _setNextLogic(newLogic);
+        }
+    }
+
+    function _delegate(address logic_) internal {
+        assembly {
+            calldatacopy(0, 0, calldatasize())
+            let result := delegatecall(gas(), logic_, 0, calldatasize(), 0, 0)
+            returndatacopy(0, 0, returndatasize())
+            switch result
+            case 0 {
+                revert(0, returndatasize())
+            }
+            default {
+                return(0, returndatasize())
+            }
+        }
+    }
 }
 ```
 
 ## Rationale
-An argument "just don't make such contracts upgadeable at all" fails when it comes to complex systems which do or do not heavily reliant on human factor which might manifest itself in unprecedented ways. It might be impossible to model some systems right on first try. Using decentralized governance for upgrade management coupled with EIP-1967 proxy could also become a serious bottleneck for certain protocols before they mature and data is at hand.
 
-A proxy without a time delay before an actual upgrade is obviously abusable. A time delay is probably unavoidable, even if it means that inexperienced developers might not have confidence using it. Albeit this is a downside of this EIP, it's a critically important option to have in smart contract development today.
+An argument "just don't make such contracts upgadeable at all" fails when it comes to complex systems which do or do not heavily rely on human factor, which might manifest itself in unprecedented ways. It might be impossible to model some systems right on first try. Using decentralized governance for upgrade management coupled with EIP-1967 proxy might become a serious bottleneck for certain protocols before they mature and data is at hand.
 
-Propose block adds to convenience if used, so should be kept.
+A proxy without a time delay before an actual upgrade is obviously abusable. A time delay is probably unavoidable, even if it means that inexperienced developers might not have confidence using it. Albeit this is a downside of this EIP, it's a critically important option to have in smart contract development today.
 
 ## Security Considerations
-Users must ensure that a trust-minimized proxy they interact with does not allow overflows, ideally represents the exact copy of the code in implementation example above, and also they must ensure that Zero Trust Period length is reasonable(at the very least two weeks if finalized upgrades are usually being revealed beforehand, and in most cases at least a month).
+
+Users must ensure that a trust-minimized proxy they interact with does not allow overflows, ideally represents the exact copy of the code in implementation example above, and also they must ensure that Zero Trust Period length is reasonable(at the very least two weeks if upgrades are usually being revealed beforehand, and in most cases at least a month).
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).

From a53796fb48328ec3c491e1222b6e707801e4fe87 Mon Sep 17 00:00:00 2001
From: Ori Pomerantz <qbzzt1@gmail.com>
Date: Wed, 28 Dec 2022 14:36:21 -0600
Subject: [PATCH 092/274] Explained typesize in the v.1 header (#6232)

Also, fixed the minimum (0003 -> 0004) and maximum (FFFF -> FFFC) because it has to be divisible by four
---
 EIPS/eip-3540.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-3540.md b/EIPS/eip-3540.md
index 5a1da1e40d80b1..ef9e1997a7d189 100644
--- a/EIPS/eip-3540.md
+++ b/EIPS/eip-3540.md
@@ -123,7 +123,7 @@ type_section := (inputs, outputs, max_stack_height)+
 | magic             | 2 bytes  | 0xEF00        | EOF prefix                                                                         |
 | version           | 1 byte   | 0x01          | EOF version                                                                        |
 | kind_type         | 1 byte   | 0x01          | kind marker for EIP-4750 type section header                                       |
-| type_size         | 2 bytes  | 0x0003-0xFFFF | uint16 denoting the length of the type section content                             |
+| type_size         | 2 bytes  | 0x0004-0xFFFC | uint16 denoting the length of the type section content, 4 bytes per code segment   |
 | kind_code         | 1 byte   | 0x02          | kind marker for code size section                                                  |
 | num_code_sections | 2 bytes  | 0x0001-0xFFFF | uint16 denoting the number of the code sections                                    |
 | code_size         | 2 bytes  | 0x0001-0xFFFF | uint16 denoting the length of the code section content                             |

From e6d574be6c45c79750f559bb5f8247e9d37c46f1 Mon Sep 17 00:00:00 2001
From: Dror Tirosh <dror@opengsn.org>
Date: Thu, 29 Dec 2022 18:19:18 +0200
Subject: [PATCH 093/274] Update EIP-4337 to latest working version (#6233)

* Update to latest working version

Update the EIP to the working version from
https://github.com/eth-infinitism/account-abstraction/blob/develop/eip/EIPS/eip-4337.md

Changes:

    AA-94 update keccak rules.
    AA-93 Adding debug RPC APIs for the Bundler to use (#153)
    AA 92 simulate execution (#152)
    AA 73 unify reputation (#144)
    AA-68 rpc calls (#132)
    AA-61 rename wallet to account (#134)
    AA-69 wallet support for simulation without signing (#133)
    AA-70 rename requestId to userOpHash (#138)
    AA-67 relax storage rules in opcode banning (#121)
    AA-63 remove paymaster stake value from EntryPoint (#119)
    AA-51 simpler simulation api, including aggregation
    AA-60 validate timestamp (#117)
Clarify wallet factory behavior when the wallet already exists
(#118)

* lint fixes
---
 EIPS/eip-4337.md | 741 +++++++++++++++++++++++++++++++++++++----------
 1 file changed, 584 insertions(+), 157 deletions(-)

diff --git a/EIPS/eip-4337.md b/EIPS/eip-4337.md
index 474d9fae853805..da3ef3156e5d73 100644
--- a/EIPS/eip-4337.md
+++ b/EIPS/eip-4337.md
@@ -1,6 +1,6 @@
 ---
 eip: 4337
-title: Account Abstraction using alt mempool
+title: Account Abstraction Using Alt Mempool
 description: An account abstraction proposal which completely avoids consensus-layer protocol changes, instead relying on higher-layer infrastructure.
 author: Vitalik Buterin (@vbuterin), Yoav Weiss (@yoavw), Kristof Gazso (@kristofgazso), Namra Patel (@namrapatel), Dror Tirosh (@drortirosh), Shahaf Nacson (@shahafn), Tjaden Hess (@tjade273)
 discussions-to: https://ethereum-magicians.org/t/erc-4337-account-abstraction-via-entry-point-contract-specification/7160
@@ -12,7 +12,7 @@ created: 2021-09-29
 
 ## Abstract
 
-An account abstraction proposal which completely avoids the need for consensus-layer protocol changes. Instead of adding new protocol features and changing the bottom-layer transaction type, this proposal instead introduces a higher-layer pseudo-transaction object called a `UserOperation`. Users send `UserOperation` objects into a separate mempool. A special class of actor called bundlers (either miners, or users that can send transactions to miners through a bundle marketplace) package up a set of these objects into a transaction making a `handleOps` call to a special contract, and that transaction then gets included in a block.
+An account abstraction proposal which completely avoids the need for consensus-layer protocol changes. Instead of adding new protocol features and changing the bottom-layer transaction type, this proposal instead introduces a higher-layer pseudo-transaction object called a `UserOperation`. Users send `UserOperation` objects into a separate mempool. A special class of actor called bundlers (either block builders, or users that can send transactions to block builders through a bundle marketplace) package up a set of these objects into a transaction making a `handleOps` call to a special contract, and that transaction then gets included in a block.
 
 ## Motivation
 
@@ -22,13 +22,13 @@ This proposal takes a different approach, avoiding any adjustments to the consen
 
 * **Achieve the key goal of account abstraction**: allow users to use smart contract wallets containing arbitrary verification logic instead of EOAs as their primary account. Completely remove any need at all for users to also have EOAs (as status quo SC wallets and [EIP-3074](./eip-3074.md) both require)
 * **Decentralization**
-    * Allow any bundler (think: miner) to participate in the process of including account-abstracted user operations
+    * Allow any bundler (think: block builder) to participate in the process of including account-abstracted user operations
     * Work with all activity happening over a public mempool; users do not need to know the direct communication addresses (eg. IP, onion) of any specific actors
     * Avoid trust assumptions on bundlers
 * **Do not require any Ethereum consensus changes**: Ethereum consensus layer development is focusing on the merge and later on scalability-oriented features, and there may not be any opportunity for further protocol changes for a long time. Hence, to increase the chance of faster adoption, this proposal avoids Ethereum consensus changes.
 * **Try to support other use cases**
     * Privacy-preserving applications
-    * Atomic multi-operations (similar goal to EIP-3074)
+    * Atomic multi-operations (similar goal to [EIP-3074](./eip-3074.md))
     * Pay tx fees with [EIP-20](./eip-20.md) tokens, allow developers to pay fees for their users, and [EIP-3074](./eip-3074.md)-like **sponsored transaction** use cases more generally
     * Support aggregated signature (e.g. BLS)
 
@@ -42,15 +42,17 @@ This proposal takes a different approach, avoiding any adjustments to the consen
   * also, the "nonce" and "signature" fields usage is not defined by the protocol, but by each account implementation
 * **Sender** - the account contract sending a user operation.
 * **EntryPoint** - a singleton contract to execute bundles of UserOperations. Bundlers/Clients whitelist the supported entrypoint.
-* **Aggregator** - a helper contract trusted by wallets to validate an aggregated signature. Bundlers/Clients whitelist the supported aggregators.
+* **Bundler** - a node (block builder) that bundles multiple UserOperations and create an EntryPoint.handleOps() transaction. Note that not all block-builders on the network are required to be bundlers
+* **Aggregator** - a helper contract trusted by accounts to validate an aggregated signature. Bundlers/Clients whitelist the supported aggregators.
 
-To avoid Ethereum consensus changes, we do not attempt to create new transaction types for account-abstracted transactions. Instead, users package up the action they want their wallet to take in an ABI-encoded struct called a `UserOperation`:
+
+To avoid Ethereum consensus changes, we do not attempt to create new transaction types for account-abstracted transactions. Instead, users package up the action they want their account to take in an ABI-encoded struct called a `UserOperation`:
 
 | Field | Type | Description
 | - | - | - |
-| `sender` | `address` | The wallet making the operation |
-| `nonce` | `uint256` | Anti-replay parameter; also used as the salt for first-time wallet creation |
-| `initCode` | `bytes` | The initCode of the wallet (needed if and only if the wallet is not yet on-chain and needs to be created) |
+| `sender` | `address` | The account making the operation |
+| `nonce` | `uint256` | Anti-replay parameter; also used as the salt for first-time account creation |
+| `initCode` | `bytes` | The initCode of the account (needed if and only if the account is not yet on-chain and needs to be created) |
 | `callData` | `bytes` | The data to pass to the `sender` during the main execution call |
 | `callGasLimit` | `uint256` | The amount of gas to allocate the main execution call |
 | `verificationGasLimit` | `uint256` | The amount of gas to allocate for the verification step |
@@ -58,15 +60,15 @@ To avoid Ethereum consensus changes, we do not attempt to create new transaction
 | `maxFeePerGas` | `uint256` | Maximum fee per gas (similar to [EIP-1559](./eip-1559.md) `max_fee_per_gas`) |
 | `maxPriorityFeePerGas` | `uint256` | Maximum priority fee per gas (similar to EIP-1559 `max_priority_fee_per_gas`) |
 | `paymasterAndData` | `bytes` | Address of paymaster sponsoring the transaction, followed by extra data to send to the paymaster (empty for self-sponsored transaction) |
-| `signature` | `bytes` | Data passed into the wallet along with the nonce during the verification step |
+| `signature` | `bytes` | Data passed into the account along with the nonce during the verification step |
 
-Users send `UserOperation` objects to a dedicated user operation mempool. A specialized class of actors called **bundlers** (either miners running special-purpose code, or users that can relay transactions to miners eg. through a bundle marketplace such as Flashbots that can guarantee next-block-or-never inclusion) listen in on the user operation mempool, and create **bundle transactions**. A bundle transaction packages up multiple `UserOperation` objects into a single `handleOps` call to a pre-published global **entry point contract**.
+Users send `UserOperation` objects to a dedicated user operation mempool. A specialized class of actors called **bundlers** (either block builders running special-purpose code, or users that can relay transactions to block builders eg. through a bundle marketplace such as Flashbots that can guarantee next-block-or-never inclusion) listen in on the user operation mempool, and create **bundle transactions**. A bundle transaction packages up multiple `UserOperation` objects into a single `handleOps` call to a pre-published global **entry point contract**.
 
 To prevent replay attacks (both cross-chain and multiple `EntryPoint` implementations), the `signature` should depend on `chainid` and the `EntryPoint` address.
 
 The core interface of the entry point contract is as follows:
 
-```c++
+```solidity
 function handleOps(UserOperation[] calldata ops, address payable beneficiary);
 
 function handleAggregatedOps(
@@ -74,104 +76,117 @@ function handleAggregatedOps(
     address payable beneficiary
 );
 
-function simulateValidation
-    (UserOperation calldata userOp, bool offChainSigCheck)
-    external returns (uint256 preOpGas, uint256 prefund, address actualAggregator, bytes memory sigForUserOp, bytes memory sigForAggregation, bytes memory offChainSigInfo) {
     
 struct UserOpsPerAggregator {
     UserOperation[] userOps;
     IAggregator aggregator;
     bytes signature;
 }
+function simulateValidation(UserOperation calldata userOp);
+
+error ValidationResult(uint256 preOpGas, uint256 prefund, uint256 deadline,
+  StakeInfo senderInfo, StakeInfo factoryInfo, StakeInfo paymasterInfo);
+
+error ValidationResultWithAggregation(uint256 preOpGas, uint256 prefund, uint256 deadline,
+  StakeInfo senderInfo, StakeInfo factoryInfo, StakeInfo paymasterInfo, AggregatorStakeInfo aggregatorInfo);
+
+struct StakeInfo {
+  uint256 stake;
+  uint256 unstakeDelaySec;
+}
+
+struct AggregatorStakeInfo {
+    address actualAggregator;
+    StakeInfo stakeInfo;
+}
 ```
 
-The core interface required for a wallet to have is:
+The core interface required for an account to have is:
 
 ```solidity
-interface IWallet {
+interface IAccount {
   function validateUserOp
-      (UserOperation calldata userOp, bytes32 requestId, address aggregator, uint256 missingWalletFunds)
-      external;
+      (UserOperation calldata userOp, bytes32 userOpHash, address aggregator, uint256 missingAccountFunds)
+      external returns (uint256 deadline);
 }
 ```
-The wallet
+
+The account
+
 * MUST validate the caller is a trusted EntryPoint
-* The requestId is a hash over the userOp (except signature), entryPoint and chainId
-* If the wallet does not support signature aggregation, it MUST validate the signature is a valid signature of the `requestId` 
-* MUST pay the entryPoint (caller) at least the "missingWalletFunds" (which might be zero, in case current wallet's deposit is high enough)
-* The wallet MAY pay more than this minimum, to cover future transactions (it can always issue `withdrawTo` to retrieve it)
-* The `aggregator` SHOULD be ignored for wallets that don't use an aggregator
+* The userOpHash is a hash over the userOp (except signature), entryPoint and chainId
+* If the account does not support signature aggregation, it MUST validate the signature is a valid signature of the `userOpHash`, and
+  SHOULD return SIG_VALIDATION_FAILED (and not revert) on signature mismatch. Any other error should revert.
+* MUST pay the entryPoint (caller) at least the "missingAccountFunds" (which might be zero, in case current account's deposit is high enough)
+* The account MAY pay more than this minimum, to cover future transactions (it can always issue `withdrawTo` to retrieve it)
+* The `aggregator` SHOULD be ignored for accounts that don't use an aggregator
+* The return value `deadline` is either zero (meaning "indefinitely"), or the last timestamp this request is deemed valid.
+  (or SIG_VALIDATION_FAILED on signature mismatch)
+
+An account that works with aggregated signature should have the interface:
 
-A Wallet that works with aggregated signature should have the interface:
 ```solidity
-interface IAggregatedWallet is IWallet {
+interface IAggregatedAccount is IAccount {
 
   function getAggregator() view returns (address);
 }
 ```
-* **getAggregator()** returns the aggregator this wallet supports.
-* **validateUserOp()** (inherited from IWallet interface) MUST verify the `aggregator` parameter is valid and the same as `getAggregator`
-* The wallet should also support aggregator-specific getter (e.g. `getAggregationInfo()`).
-  This method should export the wallet's public-key to the aggregator, and possibly more info
+
+* **getAggregator()** returns the aggregator this account supports.
+* **validateUserOp()** (inherited from IAccount interface) MUST verify the `aggregator` parameter is valid and the same as `getAggregator`
+* The account should also support aggregator-specific getter (e.g. `getAggregationInfo()`).
+  This method should export the account's public-key to the aggregator, and possibly more info
   (note that it is not called directly by the entryPoint) 
 * validateUserOp MAY ignore the signature field
-  (the signature might contain data extracted by the `aggregator.validateUserOpSignature`, and used by `aggregator.validateSignatures`) 
 
 The core interface required by an aggregator is:
+
 ```solidity
 interface IAggregator {
 
-  function validateUserOpSignature(UserOperation calldata userOp, bool offChainSigCheck) external view returns (bytes memory sigForUserOp, bytes memory sigForAggregation, bytes memory offChainSigInfo);
+  function validateUserOpSignature(UserOperation calldata userOp)
+  external view returns (bytes memory sigForUserOp);
 
-  function aggregateSignatures(bytes[] calldata sigsForAggregation) external view returns (bytes memory aggregatesSignature);
+  function aggregateSignatures(UserOperation[] calldata userOps) external view returns (bytes memory aggregatesSignature);
 
   function validateSignatures(UserOperation[] calldata userOps, bytes calldata signature) view external;
 }
 ```
 
-* **validateUserOpSignature()** must validate the userOp's signature against the UserOp's hash (the same hash MUST be used for
-  **validateUserOpSignature** and later for **validateSignatures**)
-* it is called (as an off-chain view call) from `simulateValidation()`.
-* The method should return a replacement value for the UserOp.signature, and a value used for aggregation
-  (the trivial "split" is return "" for the sigForUserOp, and the signature itself for sigForAggregation)
-* if the **offChainSigCheck** param is true, it should not validate the signature, and instead return **offChainSigInfo**, 
-  which is used by a companion off-chain library code to validate the signature 
-* **aggregateSignatures()** must aggregate all "sigForAggregation" into a single value.  
-  This method is a helper method for the bundler. The bundler MAY use a native library to perform the signature aggregation 
+* If an account uses an aggregator (returns it with getAggregator()), then its address is returned by `simulateValidation()` reverting with `ValidationResultWithAggregator` instead of `ValidationResult`
+* To accept the UserOp, the bundler must call **validateUserOpSignature()** to validate the userOp's signature.
+* **aggregateSignatures()** must aggregate all UserOp signature into a single value.  
+* Note that the above methods are helper method for the bundler. The bundler MAY use a native library to perform the same validation and aggregation logic.
 * **validateSignatures()** MUST validate the aggregated signature matches for all UserOperations in the array, and revert otherwise.
   This method is called on-chain by `handleOps()`
 
-#### Trusting aggregators and off-chain optimization
+#### Using signature aggregators
+
+An account signify it uses signature aggregation by exposing the aggregator's address in the `getAggregator()` method.
+During `simulateValidation`, this aggregator is returned (in the `ValidationResultWithAggregator`)
 
-The aggregators SHOULD stake just like a paymaster. Bundlers MAY throttle down and ban aggregators in case they take too much 
-resources (or revert) when the above methods are called in view mode.
-Alternately, bundlers, MAY "whitelist" specific implementations of aggregators.
-Blocking userOp with a banned aggregator is done during [Simulation](#simulation)
-The aggregator of a given wallet is exposed by the `getAggregator()` method. 
-In case the UserOp creates a new wallet, the aggregator is returned by the `simulateValidation()` call.
+The bundler should first accept the aggregator (validate its stake info and that it is not throttled/banned)
+Then it MUST verify the userOp using `aggregator.validateUserOpSignature()`
 
-To use an off-chain optimized implementation, the bundler MAY:
-* call `simulateValidation()` with **offChainSigCheck=true**
-* validate the response to have the correct aggregator.
-* call off-chain library to validate the signature
-* In case the aggregator is trusted, but doesn't support off-chain optimization, the bundler MAY  
-  repeat the simulateValidation, or just call the aggregator.validateUserOpSignature (as a view call) to complete the validation. 
+Signature aggregator SHOULD stake just like a paymaster, unless it is exempt due to not accessing global storage - see [reputation, throttling and banning section](#reputation-scoring-and-throttlingbanning-for-global-entities) for details. Bundlers MAY throttle down and ban aggregators in case they take too much
+resources (or revert) when the above methods are called in view mode, or if the signature aggregation fails.
 
 ### Required entry point contract functionality
 
 There are 2 separate entry point methods: `handleOps` and `handleAggregatedOps`
-* `handleOps` handle userOps of wallets that don't require any signature aggregator.
+
+* `handleOps` handle userOps of accounts that don't require any signature aggregator.
 * `handleAggregatedOps` can handle a batch that contains userOps of multiple aggregators (and also requests without any aggregator)
-* `handleAggregatedOps` performs the same logic below as `handleOps`, but it must transfer the correct aggregator to each userOp, and also must call `validateSignatures` on each aggregator after doing all the per-wallet validation.
+* `handleAggregatedOps` performs the same logic below as `handleOps`, but it must transfer the correct aggregator to each userOp, and also must call `validateSignatures` on each aggregator after doing all the per-account validation.
 The entry point's `handleOps` function must perform the following steps (we first describe the simpler non-paymaster case). It must make two loops, the **verification loop** and the **execution loop**. In the verification loop, the `handleOps` call must perform the following steps for each `UserOperation`:
 
-* **Create the wallet if it does not yet exist**, using the initcode provided in the `UserOperation`. If the wallet does not exist, _and_ the initcode is empty, or does not deploy a contract at the "sender" address, the call must fail.
-* **Call `validateUserOp` on the wallet**, passing in the `UserOperation`, the required fee and aggregator (if there is one). The wallet should verify the operation's signature, and pay the fee if the wallet considers the operation valid. If any `validateUserOp` call fails, `handleOps` must skip execution of at least that operation, and may revert entirely.
-* Validate the wallet's deposit in the entryPoint is high enough to cover the max possible cost (cover the already-done verification and max execution gas)
+* **Create the account if it does not yet exist**, using the initcode provided in the `UserOperation`. If the account does not exist, _and_ the initcode is empty, or does not deploy a contract at the "sender" address, the call must fail.
+* **Call `validateUserOp` on the account**, passing in the `UserOperation`, the required fee and aggregator (if there is one). The account should verify the operation's signature, and pay the fee if the account considers the operation valid. If any `validateUserOp` call fails, `handleOps` must skip execution of at least that operation, and may revert entirely.
+* Validate the account's deposit in the entryPoint is high enough to cover the max possible cost (cover the already-done verification and max execution gas)
 
 In the execution loop, the `handleOps` call must perform the following steps for each `UserOperation`:
 
-* **Call the wallet with the `UserOperation`'s calldata**. It's up to the wallet to choose how to parse the calldata; an expected workflow is for the wallet to have an `execute` function that parses the remaining calldata as a series of one or more calls that the wallet should make.
+* **Call the account with the `UserOperation`'s calldata**. It's up to the account to choose how to parse the calldata; an expected workflow is for the account to have an `execute` function that parses the remaining calldata as a series of one or more calls that the account should make.
 
 ![](../assets/eip-4337/image1.png)
 
@@ -180,22 +195,22 @@ A node/bundler SHOULD drop (and not add to the mempool) `UserOperation` that fai
 
 ### Extension: paymasters
 
-We extend the entry point logic to support **paymasters** that can sponsor transactions for other users. This feature can be used to allow application developers to subsidize fees for their users, allow users to pay fees with EIP-20 tokens and many other use cases. When the paymaster is not equal to the zero address, the entry point implements a different flow:
+We extend the entry point logic to support **paymasters** that can sponsor transactions for other users. This feature can be used to allow application developers to subsidize fees for their users, allow users to pay fees with [EIP-20](./eip-20.md) tokens and many other use cases. When the paymaster is not equal to the zero address, the entry point implements a different flow:
 
 ![](../assets/eip-4337/image2.png)
 
-During the verification loop, in addition to calling `validateUserOp`, the `handleOps` execution also must check that the paymaster is staked, and also has enough ETH deposited with the entry point to pay for the operation, and then call `validatePaymasterUserOp` on the paymaster to verify that the paymaster is willing to pay for the operation. Note that in this case, the `validateUserOp` is called with a `missingWalletFunds` of 0 to reflect that the wallet's deposit is not used for payment for this userOp.
+During the verification loop, in addition to calling `validateUserOp`, the `handleOps` execution also must check that the paymaster has enough ETH deposited with the entry point to pay for the operation, and then call `validatePaymasterUserOp` on the paymaster to verify that the paymaster is willing to pay for the operation. Note that in this case, the `validateUserOp` is called with a `missingAccountFunds` of 0 to reflect that the account's deposit is not used for payment for this userOp.
 
-During the execution loop, the `handleOps` execution must call `postOp` on the paymaster after making the main execution call. It must guarantee the execution of `postOp`, by making the main execution inside an inner call context, and if the inner call context reverts attempting to call `postOp` again in an outer call context.
+If the paymaster's validatePaymasterUserOp returns a "context", then `handleOps` must call `postOp` on the paymaster after making the main execution call. It must guarantee the execution of `postOp`, by making the main execution inside an inner call context, and if the inner call context reverts attempting to call `postOp` again in an outer call context.
 
-Maliciously crafted paymasters _can_ DoS the system. To prevent this, we use a paymaster reputation system; see the [reputation, throttling and banning section](#reputation-scoring-and-throttlingbanning-for-paymasters) for details.
+Maliciously crafted paymasters _can_ DoS the system. To prevent this, we use a reputation system. paymaster must either limit its storage usage, or have a stake. see the [reputation, throttling and banning section](#reputation-scoring-and-throttlingbanning-for-global-entities) for details.
 
 The paymaster interface is as follows:
 
 ```c++
 function validatePaymasterUserOp
-    (UserOperation calldata userOp, bytes32 requestId, uint256 maxCost)
-    external returns (bytes memory context);
+    (UserOperation calldata userOp, bytes32 userOpHash, uint256 maxCost)
+    external returns (bytes memory context, uint256 deadline);
 
 function postOp
     (PostOpMode mode, bytes calldata context, uint256 actualGasCost)
@@ -208,7 +223,6 @@ enum PostOpMode {
 }
 ```
 
-To prevent attacks involving malicious `UserOperation` objects listing other users' wallets as their paymasters, the entry point contract must require a paymaster to call the entry point to lock their stake and thereby consent to being a paymaster. Unlocking stake must have a delay. The extended interface for the entry point, adding functions for paymasters to add and withdraw stake, is:
 
 ```c++
 // add a paymaster stake (must be called by the paymaster)
@@ -221,7 +235,10 @@ function unlockStake() external
 function withdrawStake(address payable withdrawAddress) external
 ```
 
-The paymaster must also have a deposit, which the entry point will charge UserOperation costs from.  The entry point must implement the following interface to allow paymasters (and optionally wallets) manage their deposit:
+The paymaster must also have a deposit, which the entry point will charge UserOperation costs from.
+The deposit (for paying gas fees) is separate from the stake (which is locked).
+
+The entry point must implement the following interface to allow paymasters (and optionally accounts) manage their deposit:
 
 ```c++
 // return the deposit of an account
@@ -232,70 +249,109 @@ function depositTo(address account) public payable
 
 // withdraw from the deposit
 function withdrawTo(address payable withdrawAddress, uint256 withdrawAmount) external
-
 ```
 
 ### Client behavior upon receiving a UserOperation
 
 When a client receives a `UserOperation`, it must first run some basic sanity checks, namely that:
 
-- Either the `sender` is an existing contract, or the `initCode` is not empty (but not both)
-- The `verificationGasLimit` is sufficiently low (`<= MAX_VERIFICATION_GAS`) and the `preVerificationGas` is sufficiently high (enough to pay for the calldata gas cost of serializing the `UserOperation` plus `PRE_VERIFICATION_OVERHEAD_GAS`)
-- The paymaster is either the zero address or is a contract which (i) currently has nonempty code on chain, (ii) has registered and staked, (iii) has a sufficient deposit to pay for the UserOperation, and (iv) is not currently banned.
-- The callgas is at least the cost of a `CALL` with non-zero value.
-- The `maxFeePerGas` and `maxPriorityFeePerGas` are above a configurable minimum value that the client is willing to accept. At the minimum, they are sufficiently high to be included with the current `block.basefee`.
-- The sender doesn't have another `UserOperation` already present in the pool (or it replaces an existing entry with the same sender and nonce, with a higher `maxPriorityFeePerGas` and an equally increased `maxFeePerGas`). Only one `UserOperation` per sender may be included in a single batch.
+* Either the `sender` is an existing contract, or the `initCode` is not empty (but not both)
+* If `initCode` is not empty, parse its first 20 bytes as a factory address.  Record whether the factory is staked, in case the later simulation indicates that it needs to be.  If the factory accesses global state, it must be staked - see [reputation, throttling and banning section](#reputation-scoring-and-throttlingbanning-for-global-entities) for details.
+* The `verificationGasLimit` is sufficiently low (`<= MAX_VERIFICATION_GAS`) and the `preVerificationGas` is sufficiently high (enough to pay for the calldata gas cost of serializing the `UserOperation` plus `PRE_VERIFICATION_OVERHEAD_GAS`)
+* The `paymasterAndData` is either empty, or start with the **paymaster** address, which is a contract that (i) currently has nonempty code on chain, (ii) has a sufficient deposit to pay for the UserOperation, and (iii) is not currently banned. During simulation, the paymaster's stake is also checked, depending on its storage usage - see [reputation, throttling and banning section](#reputation-scoring-and-throttlingbanning-for-global-entities) for details.
+* The callgas is at least the cost of a `CALL` with non-zero value.
+* The `maxFeePerGas` and `maxPriorityFeePerGas` are above a configurable minimum value that the client is willing to accept. At the minimum, they are sufficiently high to be included with the current `block.basefee`.
+* The sender doesn't have another `UserOperation` already present in the pool (or it replaces an existing entry with the same sender and nonce, with a higher `maxPriorityFeePerGas` and an equally increased `maxFeePerGas`). Only one `UserOperation` per sender may be included in a single batch. A sender is exempt from this rule and may have multiple `UserOperations` in the pool and in a batch if it is staked (see [reputation, throttling and banning section](#reputation-scoring-and-throttlingbanning-for-global-entities) below), but this exception is of limited use to normal accounts.
 
-If the `UserOperation` object passes these sanity checks, the client must next run the first op simulation, and if the simulation succeeds, the client must add the op to the pool. A second simulation must also happen during bundling to make sure that the storage accessed is the same as the `accessList` that was saved during the initial simulation.
+If the `UserOperation` object passes these sanity checks, the client must next run the first op simulation, and if the simulation succeeds, the client must add the op to the pool. A second simulation must also happen during bundling to make sure the UserOperation is still valid.
 
 ### Simulation
 
-To simulate a `UserOperation` validation, the client makes a view call to `simulateValidation(userop)`, with a "from" address set to all-zeros
+#### Simulation Rationale
+
+In order to add a UserOperation into the mempool (and later to add it into a bundle) we need to "simulate" it to make sure it is valid, and that it is capable of paying for its own execution.
+In addition, we need to verify that the same will hold true when executed on-chain.
+For this purpose, a UserOperation is not allowed to access any information that might change between simulation and execution, such as current block time, number, hash etc.
+In addition, a UserOperation is only allowed to access data related to this sender address: Multiple UserOperations should not access the same storage, so that it is impossible to invalidate a large number of UserOperations with a single state change.
+There are 3 special contracts that interact with the account: the factory (initCode) that deploys the contract, the paymaster that can pay for the gas, and signature aggregator (described later)
+Each of these contracts is also restricted in its storage access, to make sure UserOperation validations are isolated.
+
+#### Specification:
+
+To simulate a `UserOperation` validation, the client makes a view call to `simulateValidation(userop)`
 
-If the call returns an error, the client rejects this `userOp`.
+This method always revert with `ValidationResult` as successful response.
+If the call reverts with other error, the client rejects this `userOp`.
 
-The simulated call performs the full validation, by  
-calling:
-1. `wallet.validateUserOp`.
-2. if specified a paymaster: `paymaster.validatePaymasterUserOp`.
-3. if using an aggregator: `aggregator.validateUserOpSignature`.
+The simulated call performs the full validation, by calling:
+
+1. If `initCode` is present, create the account.
+2. `account.validateUserOp`.
+3. if specified a paymaster: `paymaster.validatePaymasterUserOp`.
+
+Either `validateUserOp` or `validatePaymasterUserOp` may return a "deadline", which is the latest timestamp that this UserOperation is valid on-chain.
+the simulateValidation call returns the minimum of those deadlines.
+A node MAY drop a UserOperation if the deadline is too soon (e.g. wouldn't make it to the next block)
 
 The operations differ in their opcode banning policy.
-In order to distinguish between them, there is a call to the NUMBER opcode (`block.number`), used as a delimiter between the validation functions.
+In order to distinguish between them, there is a call to the NUMBER opcode (`block.number`), used as a delimiter between the 3 functions.
 While simulating `userOp` validation, the client should make sure that:
 
-1. Neither call's execution trace invokes any **forbidden opcodes**
-2. The first (validateUserOp) call does not access _mutable state_ of any contract except the wallet itself and its deposit in the entry point contract. _Mutable state_ definition includes both storage and balance.
-3. The second (validatePaymasterUserOp) call does not access _mutable state_ of any contract except the paymaster itself. The paymaster is also not allowed to make any state-change calls (SSTORE)
-   A bundler MAY whitelist specific paymaster addresses, and not enforce the above storage limitations
-4. The third (validateUserOpSignature) view-call doesn't access _mutable state_ of any contract except the aggregator AND wallet itself.
-5. The third (validateUserOpSignature) is the first view call after the "NUMBER" marker. If that aggregator is banned, then this staticcall MUST revert immediately, as if it was called with zero gas.
-6. Any `CALL` or `CALLCODE` during validation has `value=0`, except for the transfer from the wallet to the entry point.
-7. No `CALL`, `DELEGATECALL`, `CALLCODE`, `STATICCALL` results in an out-of-gas revert.
-8. No `CALL`, `DELEGATECALL`, `CALLCODE`, `STATICCALL` to addresses with `EXTCODESIZE=0`.
-9. Any `GAS` opcode is followed immediately by one of { `CALL`, `DELEGATECALL`, `CALLCODE`, `STATICCALL` }.
-10. `EXTCODEHASH` of every address accessed (by any opcode) does not change between first and second simulations of the op.
-11. If `op.initcode.length != 0` , allow only one `CREATE2` opcode call (in the validateUserOp block), otherwise forbid `CREATE2`.
-
-Since the wallet is allowed to access its own entry point deposit in order to top it up when needed, the client must know the storage slot in order to whitelist it. The entry point therefore implements the following view function:
-
-```c++
-function getSenderStorage(address sender) external view returns (uint256[] memory senderStorageCells)
-```
+1. May not invokes any **forbidden opcodes**
+2. Must not use GAS opcode (unless followed immediately by one of { `CALL`, `DELEGATECALL`, `CALLCODE`, `STATICCALL` }.)
+3. Storage access is limited as follows:
+   1. self storage (of factory/paymaster, respectively) is allowed, but only if self entity is staked
+   2. account storage access is allowed (see Storage access by Slots, below),
+   3. in any case, may not use storage used by another UserOp `sender` in the same bundle (that is, paymaster and factory are not allowed as senders)
+4. Limitation on "CALL" opcodes (`CALL`, `DELEGATECALL`, `CALLCODE`, `STATICCALL`):
+   1. must not use value (except from account to the entrypoint)
+   2. must not revert with out-of-gas
+   3. destination address must have code (EXTCODESIZE>0)
+   4. cannot call EntryPoint's `handleOps` method (to avoid recursion)
+5. `EXTCODEHASH` of every address accessed (by any opcode) does not change between first and second simulations of the op.
+6. `EXTCODEHASH`, `EXTCODELENGTH`, `EXTCODECOPY` may not access address with no code.
+7. If `op.initcode.length != 0` , allow only one `CREATE2` opcode call (in the first (deployment) block), otherwise forbid `CREATE2`.
+
+#### Storage associated with an address
+
+We define storage slots as "associated with an address" as all the slots that uniquely related on this address, and cannot be related with any other address.
+In solidity, this includes all storage of the contract itself, and any storage of other contracts that use this contract address as a mapping key.
+
+An address `A` is associated with:
+
+1. Slots of contract `A` address itself.
+2. Slot `A` on any other address.
+3. Slots of type `keccak256(A || X) + n` on any other address. (to cover `mapping(address => value)`, which is usually used for balance in EIP-20 tokens).
+   `n` is an offset value up to 128, to allow accessing fields in the format `mapping(address => struct)`
+
+
+#### Alternative Mempools
+
+The simulation rules above are strict and prevent the ability of paymasters and signature aggregators to grief the system.
+However, there might be use-cases where specific paymasters (and signature aggregators) can be validated
+(through manual auditing) and verified that they cannot cause any problem, while still require relaxing of the opcode rules.
+A bundler cannot simply "whitelist" request from a specific paymaster: if that paymaster is not accepted by all
+bundlers, then its support will be sporadic at best.
+Instead, we introduce the term "alternate mempool".
+UserOperations that use  whitelisted paymasters (or signature aggregators) are put into a separate mempool.
+Only bundlers that support this whitelist will use UserOperations from this mempool.
+These UserOperations can be bundled together with UserOperations from the main mempool
 
 ### Bundling
 
 During bundling, the client should:
-- Exclude UserOps that access any sender address created by another UserOp on the same batch (via CREATE2 factory).
-- For each paymaster used in the batch, keep track of the balance while adding UserOps. Ensure that it has sufficient deposit to pay for all the UserOps that use it.
-- Sort UserOps by aggregator, to create the lists of UserOps-per-aggregator.
-- For each aggregator, run the aggregator-specific code to create aggregated signature, and update the UserOps
+
+* Exclude UserOps that access any sender address created by another UserOp on the same batch (via a factory).
+* For each paymaster used in the batch, keep track of the balance while adding UserOps. Ensure that it has sufficient deposit to pay for all the UserOps that use it.
+* Sort UserOps by aggregator, to create the lists of UserOps-per-aggregator.
+* For each aggregator, run the aggregator-specific code to create aggregated signature, and update the UserOps
 
 After creating the batch, before including the transaction in a block, the client should:
-- Run `eth_estimateGas` with maximum possible gas, to verify the entire `handleOps` batch transaction, and use the estimated gas for the actual transaction execution.
-- If the call reverted, check the `FailedOp` event. A `FailedOp` during `handleOps` simulation is an unexpected event since it was supposed to be caught by the single-UserOperation simulation. Remove the failed op that caused the revert from the batch and drop from the mempool. Other ops from the same paymaster should be removed from the current batch, but kept in the mempool. Repeat until `eth_estimateGas` succeeds.
 
-In practice, restrictions (2) and (3) basically mean that the only external accesses that the wallet and the paymaster can make are reading code of other contracts if their code is guaranteed to be immutable (eg. this is useful for calling or delegatecalling to libraries).
+* Run `eth_estimateGas` with maximum possible gas, to verify the entire `handleOps` batch transaction, and use the estimated gas for the actual transaction execution.
+* If the call reverted, check the `FailedOp` event. A `FailedOp` during `handleOps` simulation is an unexpected event since it was supposed to be caught by the single-UserOperation simulation. Remove the failed op that caused the revert from the batch and drop from the mempool. Other ops from the same paymaster should be removed from the current batch, but kept in the mempool. Repeat until `eth_estimateGas` succeeds.
+
+In practice, restrictions (2) and (3) basically mean that the only external accesses that the account and the paymaster can make are reading code of other contracts if their code is guaranteed to be immutable (eg. this is useful for calling or delegatecalling to libraries).
 
 If any of the three conditions is violated, the client should reject the `op`. If both calls succeed (or, if `op.paymaster == ZERO_ADDRESS` and the first call succeeds)without violating the three conditions, the client should accept the op. On a bundler node, the storage keys accessed by both calls must be saved as the `accessList` of the `UserOperation`
 
@@ -303,27 +359,50 @@ When a bundler includes a bundle in a block it must ensure that earlier transact
 
 #### Forbidden opcodes
 
-The forbidden opcodes are to be forbidden when `depth > 2` (i.e. when it is the wallet, paymaster, or other contracts called by them that are being executed). They are: `GASPRICE`, `GASLIMIT`, `DIFFICULTY`, `TIMESTAMP`, `BASEFEE`, `BLOCKHASH`, `NUMBER`, `SELFBALANCE`, `BALANCE`, `ORIGIN`, `GAS`, `CREATE`, `COINBASE`. They should only be forbidden during verification, not execution. These opcodes are forbidden because their outputs may differ between simulation and execution, so simulation of calls using these opcodes does not reliably tell what would happen if these calls are later done on-chain.
+The forbidden opcodes are to be forbidden when `depth > 2` (i.e. when it is the factory, account, paymaster, or other contracts called by them that are being executed). They are: `GASPRICE`, `GASLIMIT`, `DIFFICULTY`, `TIMESTAMP`, `BASEFEE`, `BLOCKHASH`, `NUMBER`, `SELFBALANCE`, `BALANCE`, `ORIGIN`, `GAS`, `CREATE`, `COINBASE`, `SELFDESTRUCT`. They should only be forbidden during verification, not execution. These opcodes are forbidden because their outputs may differ between simulation and execution, so simulation of calls using these opcodes does not reliably tell what would happen if these calls are later done on-chain.
 
 Exceptions to the forbidden opcodes:
+
 1. A single `CREATE2` is allowed if `op.initcode.length != 0` and must result in the deployment of a previously-undeployed `UserOperation.sender`.
 2. `GAS` is allowed if followed immediately by one of { `CALL`, `DELEGATECALL`, `CALLCODE`, `STATICCALL` }.
    (that is, making calls is allowed, using `gasleft()` or `gas` opcode directly is forbidden)
 
-### Reputation scoring and throttling/banning for paymasters
+### Reputation scoring and throttling/banning for global entities
+
+#### ReputationRationale.
+
+UserOperation's storage access rules prevent them from interfere with each other.
+But "global" entities - paymasters, factories and aggregators are accessed by multiple UserOperations, and thus might invalidate multiple previously-valid UserOperations.
+
+To prevent abuse, we throttle down (or completely ban for a period of time) an entity that causes invalidation of large number of UserOperations in the mempool.
+To prevent such entities from "sybil-attack", we require them to stake with the system, and thus make such DoS attack very expensive.
+Note that this stake is never slashed, and can be withdrawn any time (after unstake delay)
+The only exemption from staking is if the entity doesn't use storage during validation.
+(unstaked entity may use storage [associated with the sender](#storage-associated-with-an-address))
+When staked, an entity is also allowed to use its own associated storage, in addition to sender's associated storage.
+
+The stake value is not enforced on-chain, but specifically by each node while simulating a transaction.
+The stake is expected to be above MIN_STAKE_VALUE, and unstake delay above MIN_UNSTAKE_DELAY
+The value of MIN_UNSTAKE_DELAY is 84600 (one day)
+The value of MIN_STAKE_VALUE is determined per chain, and specified in the "bundler specification test suite"
 
-Clients maintain two mappings with a value for each paymaster:
+#### Specification.
+
+In the following specification, "entity" is either address that is explicitly referenced by the UserOperation: sender, factory, paymaster and aggregator.
+Clients maintain two mappings with a value for staked entities:
 
 * `opsSeen: Map[Address, int]`
 * `opsIncluded: Map[Address, int]`
 
-When the client learns of a new `paymaster`, it sets `opsSeen[paymaster] = 0` and `opsIncluded[paymaster] = 0` .
+If an entity doesn't use storage at all, or only reference storage associated with the "sender" (see [Storage associated with an address](#storage-associated-with-an-address)), then it is considered "OK", without using the rules below.
+
+When the client learns of a new staked entity, it sets `opsSeen[paymaster] = 0` and `opsIncluded[paymaster] = 0` .
 
-The client sets `opsSeen[paymaster] +=1` each time it adds an op with that `paymaster` to the `UserOperationPool`, and the client sets `opsIncluded[paymaster] += 1` each time an op that was in the `UserOperationPool` is included on-chain.
+The client sets `opsSeen[entity] +=1` each time it adds an op with that `entity` to the `UserOperationPool`, and the client sets `opsIncluded[entity] += 1` each time an op that was in the `UserOperationPool` is included on-chain.
 
-Every hour, the client sets `opsSeen[paymaster] -= opsSeen[paymaster] // 24` and `opsIncluded[paymaster] -= opsIncluded[paymaster] // 24` for all paymasters (so both values are 24-hour exponential moving averages).
+Every hour, the client sets `opsSeen[entity] -= opsSeen[entity] // 24` and `opsIncluded[entity] -= opsIncluded[entity] // 24` for all entities (so both values are 24-hour exponential moving averages).
 
-We define the **status** of a paymaster as follows:
+We define the **status** of an entity as follows:
 
 ```python
 OK, THROTTLED, BANNED = 0, 1, 2
@@ -342,7 +421,7 @@ def status(paymaster: Address,
         return BANNED
 ```
 
-Stated in simpler terms, we expect at least `1 / MIN_INCLUSION_RATE_DENOMINATOR` of all ops seen on the network to get included. If a paymaster falls too far behind this minimum, the paymaster gets **throttled** (meaning, the client does not accept ops from that paymaster if there is already an op from that paymaster, and an op only stays in the pool for 10 blocks), If the paymaster falls even further behind, it gets **banned**. Throttling and banning naturally reverse over time because of the exponential-moving-average rule.
+Stated in simpler terms, we expect at least `1 / MIN_INCLUSION_RATE_DENOMINATOR` of all ops seen on the network to get included. If an entity falls too far behind this minimum, it gets **throttled** (meaning, the client does not accept ops from that paymaster if there is already an op with that entity, and an op only stays in the pool for 10 blocks), If the entity falls even further behind, it gets **banned**. Throttling and banning naturally decay over time because of the exponential-moving-average rule.
 
 **Non-bundling clients and bundlers should use different settings for the above params**:
 
@@ -354,16 +433,87 @@ Stated in simpler terms, we expect at least `1 / MIN_INCLUSION_RATE_DENOMINATOR`
 
 To help make sense of these params, note that a malicious paymaster can at most cause the network (only the p2p network, not the blockchain) to process `BAN_SLACK * MIN_INCLUSION_RATE_DENOMINATOR / 24` non-paying ops per hour.
 
-### RPC methods
+## Rationale
+
+The main challenge with a purely smart contract wallet based account abstraction system is DoS safety: how can a block builder including an operation make sure that it will actually pay fees, without having to first execute the entire operation? Requiring the block builder to execute the entire operation opens a DoS attack vector, as an attacker could easily send many operations that pretend to pay a fee but then revert at the last moment after a long execution. Similarly, to prevent attackers from cheaply clogging the mempool, nodes in the P2P network need to check if an operation will pay a fee before they are willing to forward it.
+
+In this proposal, we expect accounts to have a `validateUserOp` method that takes as input a `UserOperation`, and verify the signature and pay the fee. This method is required to be almost-pure: it is only allowed to access the storage of the account itself, cannot use environment opcodes (eg. `TIMESTAMP`), and can only edit the storage of the account, and can also send out ETH (needed to pay the entry point). The method is gas-limited by the `verificationGasLimit` of the `UserOperation`; nodes can choose to reject operations whose `verificationGasLimit` is too high. These restrictions allow block builders and network nodes to simulate the verification step locally, and be confident that the result will match the result when the operation actually gets included into a block.
+
+The entry point-based approach allows for a clean separation between verification and execution, and keeps accounts' logic simple. The alternative would be to require accounts to follow a template where they first self-call to verify and then self-call to execute (so that the execution is sandboxed and cannot cause the fee payment to revert); template-based approaches were rejected due to being harder to implement, as existing code compilation and verification tooling is not designed around template verification.
+
+### Paymasters
+
+Paymasters facilitate transaction sponsorship, allowing third-party-designed mechanisms to pay for transactions. Many of these mechanisms _could_ be done by having the paymaster wrap a `UserOperation` with their own, but there are some important fundamental limitations to that approach:
+
+* No possibility for "passive" paymasters (eg. that accept fees in some EIP-20 token at an exchange rate pulled from an on-chain DEX)
+* Paymasters run the risk of getting griefed, as users could send ops that appear to pay the paymaster but then change their behavior after a block
+
+The paymaster scheme allows a contract to passively pay on users' behalf under arbitrary conditions. It even allows EIP-20 token paymasters to secure a guarantee that they would only need to pay if the user pays them: the paymaster contract can check that there is sufficient approved EIP-20 balance in the `validatePaymasterUserOp` method, and then extract it with `transferFrom` in the `postOp` call; if the op itself transfers out or de-approves too much of the EIP-20s, the inner `postOp` will fail and revert the execution and the outer `postOp` can extract payment (note that because of storage access restrictions the EIP-20 would need to be a wrapper defined within the paymaster itself).
+
+### First-time account creation
+
+It is an important design goal of this proposal to replicate the key property of EOAs that users do not need to perform some custom action or rely on an existing user to create their wallet; they can simply generate an address locally and immediately start accepting funds.
+
+The wallet creation itself is done by a "factory" contract, with wallet-specific data.
+The factory is expected to use CREATE2 (not CREATE) to create the wallet, so that the order of creation of wallets doesn't interfere with the generated addresses.
+The `initCode` field (if non-zero length) is parsed as a 20-byte address, followed by "calldata" to pass to this address.
+This method call is expected to create a wallet and return its address.
+If the factory does use CREATE2 or some other deterministic method to create the wallet, it's expected to return the wallet address even if the wallet has already been created.  This is to make it easier for clients to query the address without knowing if the wallet has already been deployed, by simulating a call to `entryPoint.getSenderAddress()`, which calls the factory under the hood.
+When `initCode` is specified, if either the `sender` address points to an existing contract, or (after calling the initCode) the `sender` address still does not exist,
+then the operation is aborted.
+The `initCode` MUST NOT be called directly from the entryPoint, but from another address.
+The contract created by this factory method should accept a call to `validateUserOp` to validate the UserOp's signature.
+For security reasons, it is important that the generated contract address will depend on the initial signature.
+This way, even if someone can create a wallet at that address, he can't set different credentials to control it.
+The factory has to be staked if it accesses global storage - see [reputation, throttling and banning section](#reputation-scoring-and-throttlingbanning-for-global-entities) for details.
+
+NOTE: In order for the wallet to determine the "counterfactual" address of the wallet (prior its creation),
+it should make a static call to the `entryPoint.getSenderAddress()`
+
+### Entry point upgrading
+
+Accounts are encouraged to be DELEGATECALL forwarding contracts for gas efficiency and to allow account upgradability. The account code is expected to hard-code the entry point into their code for gas efficiency. If a new entry point is introduced, whether to add new functionality, improve gas efficiency, or fix a critical security bug, users can self-call to replace their account's code address with a new code address containing code that points to a new entry point. During an upgrade process, it's expected that two mempools will run in parallel.
 
-`eth_sendUserOperation`
+### RPC methods (eth namespace)
 
-eth_sendUserOperation submits a User Operation object to the User Operation pool of the client. An entryPoint address `MUST` be specified, and the client `MUST` only simulate and submit the User Operation through the specified entryPoint.
+#### * eth_sendUserOperation
 
-The result `SHOULD` be set to true if and only if the request passed simulation and was accepted in the client's User Operation pool. If the validation, simulation, or User Operation pool inclusion fails, `result` `SHOULD NOT` be returned. Rather, the client `SHOULD` return the failure reason.
+eth_sendUserOperation submits a User Operation object to the User Operation pool of the client. The client MUST validate the UserOperation, and return a result accordingly.
+
+The result `SHOULD` be set to the **userOpHash** if and only if the request passed simulation and was accepted in the client's User Operation pool. If the validation, simulation, or User Operation pool inclusion fails, `result` `SHOULD NOT` be returned. Rather, the client `SHOULD` return the failure reason.
+
+##### Parameters:
+
+1. **UserOperation** a full user-operation struct. All fields MUST be set as hex values. empty `bytes` block (e.g. empty `initCode`) MUST be set to `"0x"`
+2. **EntryPoint** the entrypoint address the request should be sent through. this MUST be one of the entry points returned by the `supportedEntryPoints` rpc call.
+
+##### Return value:
+
+* If the UserOperation is valid, the client MUST return the calculated **userOpHash** for it
+* in case of failure, MUST return an `error` result object, with `code` and `message`. The error code and message SHOULD be set as follows:
+  * **code: -32602** - invalid UserOperation struct/fields
+  * **code: -32500** - transaction rejected by entryPoint's simulateValidation, during wallet creation or validation
+    * The `message` field MUST be set to the FailedOp's "`AAxx`" error message from the EntryPoint
+  * **code: -32501** - transaction rejected by paymaster's validatePaymasterUserOp
+    * The `message` field SHOULD be set to the revert message from the paymaster
+    * The `data` field MUST contain a `paymaster` value
+  * **code: -32502** - transaction rejected because of opcode validation
+  * **code: -32503** - UserOperation expires shortly: either wallet or paymaster returned an `deadline` that will expire soon
+    * The `data` field SHOULD contain a `deadline` value
+    * The `data` field SHOULD contain a `paymaster` value, if this error was triggered by the paymaster
+  * **code: -32504** - transaction rejected because paymaster (or signature aggregator) is throttled/banned
+    * The `data` field SHOULD contain a `paymaster` or `aggregator` value, depending on the failed entity
+  * **code: -32505** - transaction rejected because paymaster (or signature aggregator) stake or unstake-delay is too low
+    * The `data` field SHOULD contain a `paymaster` or `aggregator` value, depending on the failed entity
+    * The `data` field SHOULD contain a `minimumStake` and `minimumUnstakeDelay`
+  * **code: -32506** - transaction rejected because wallet specified unsupported signature aggregator
+    * The `data` field SHOULD contain an `aggregator` value
+
+##### Example:
+
+Request:
 
 ```json=
-# Request
 {
   "jsonrpc": "2.0",
   "id": 1,
@@ -386,17 +536,110 @@ The result `SHOULD` be set to true if and only if the request passed simulation
   ]
 }
 
-# Response
+```
+
+Response:
+
+```
 {
   "jsonrpc": "2.0",
   "id": 1,
-  "result": true
+  "result": "0x1234...5678"
 }
 ```
 
-`eth_supportedEntryPoints`
+##### Example failure responses:
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "error": {
+    "message": "AA21 didn't pay prefund",
+    "code": -32500
+  }
+}
+```
+
+```json
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "error": {
+    "message": "paymaster stake too low",
+    "data": {
+      "paymaster": "0x123456789012345678901234567890123456790",
+      "minimumStake": "0xde0b6b3a7640000",
+      "minimumUnstakeDelay": "0x15180"
+    },
+    "code": -32504
+  }
+}
+```
+
+
+#### * eth_estimateUserOperationGas
+
+Estimate the gas values for a UserOperation.
+Given UserOperation optionally without gas limits and gas prices, return the needed gas limits.
+The signature field is ignored by the wallet, so that the operation will not require user's approval.
+Still, it might require putting a "semi-valid" signature (e.g. a signature in the right length)
+
+**Parameters**: same as `eth_sendUserOperation`
+  gas limits (and prices) parameters are optional, but are used if specified.
+  `maxFeePerGas` and `maxPriorityFeePerGas` default to zero, so no payment is required by neither account nor paymaster.
+
+**Return Values:**
+
+* **preVerificationGas** gas overhead of this UserOperation
+* **verificationGasLimit** actual gas used by the validation of this UserOperation
+* **callGasLimit** value used by inner account execution
+
+##### Error Codes:
 
-eth_supportedEntryPoints returns an array of the entryPoint addresses supported by the client. The first element of the array `SHOULD` be the entryPoint addressed preferred by the client.
+Same as `eth_sendUserOperation`
+This operation may also return an error if the inner call to the account contract reverts.
+
+#### * eth_getUserOperationByHash
+
+Return a UserOperation based on a hash (userOpHash) returned by `eth_sendUserOperation`
+
+**Parameters**
+
+* **hash** a userOpHash value returned by `eth_sendUserOperation`
+
+**Return value**:
+
+`null` in case the UserOperation is not yet included in a block, or a full UserOperation, with the addition of `entryPoint`, `blockNumber`, `blockHash` and `transactionHash`
+
+#### * eth_getUserOperationReceipt
+
+Return a UserOperation receipt based on a hash (userOpHash) returned by `eth_sendUserOperation`
+
+**Parameters**
+
+* **hash** a userOpHash value returned by `eth_sendUserOperation`
+
+**Return value**:
+
+`null` in case the UserOperation is not yet included in a block, or:
+
+* **userOpHash** the request hash
+* **entryPoint**
+* **sender**
+* **nonce**
+* **paymaster** the paymaster used for this userOp (or empty)
+* **actualGasCost** - actual amount paid (by account or paymaster) for this UserOperation
+* **actualGasUsed** - total gas used by this UserOperation (including preVerification, creation, validation and execution)
+* **success** boolean - did this execution completed without revert
+* **reason** in case of revert, this is the revert reason
+* **logs** the logs generated by this UserOperation (not including logs of other UserOperations in the same bundle)
+* **receipt** the TransactionReceipt object.
+  Note that the returned TransactionReceipt is for the entire bundle, not only for this UserOperation.
+
+#### * eth_supportedEntryPoints
+
+Returns an array of the entryPoint addresses supported by the client. The first element of the array `SHOULD` be the entryPoint addressed preferred by the client.
 
 ```json=
 # Request
@@ -418,48 +661,232 @@ eth_supportedEntryPoints returns an array of the entryPoint addresses supported
 }
 ```
 
-## Rationale
+#### * eth_chainId
 
-The main challenge with a purely smart contract wallet based account abstraction system is DoS safety: how can a miner including an operation make sure that it will actually pay fees, without having to first execute the entire operation? Requiring the miner to execute the entire operation opens a DoS attack vector, as an attacker could easily send many operations that pretend to pay a fee but then revert at the last moment after a long execution. Similarly, to prevent attackers from cheaply clogging the mempool, nodes in the P2P network need to check if an operation will pay a fee before they are willing to forward it.
+Returns [EIP-155](./eip-155.md) Chain ID.
 
-In this proposal, we expect wallets to have a `validateUserOp` method that takes as input a `UserOperation`, and verify the signature and pay the fee. This method is required to be almost-pure: it is only allowed to access the storage of the wallet itself, cannot use environment opcodes (eg. `TIMESTAMP`), and can only edit the storage of the wallet, and can also send out ETH (needed to pay the entry point). The method is gas-limited by the `verificationGasLimit` of the `UserOperation`; nodes can choose to reject operations whose `verificationGasLimit` is too high. These restrictions allow miners and network nodes to simulate the verification step locally, and be confident that the result will match the result when the operation actually gets included into a block.
+```json=
+# Request
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "eth_chainId",
+  "params": []
+}
 
-The entry point-based approach allows for a clean separation between verification and execution, and keeps wallets' logic simple. The alternative would be to require wallets to follow a template where they first self-call to verify and then self-call to execute (so that the execution is sandboxed and cannot cause the fee payment to revert); template-based approaches were rejected due to being harder to implement, as existing code compilation and verification tooling is not designed around template verification.
+# Response
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "result": "0x1"
+}
+```
 
-### Paymasters
+### RPC methods (debug Namespace)
 
-Paymasters facilitate transaction sponsorship, allowing third-party-designed mechanisms to pay for transactions. Many of these mechanisms _could_ be done by having the paymaster wrap a `UserOperation` with their own, but there are some important fundamental limitations to that approach:
+This api must only be available on testing mode and is required by the compatibility test suite. In production, any `debug_*` rpc calls should be blocked.
 
-* No possibility for "passive" paymasters (eg. that accept fees in some EIP-20 token at an exchange rate pulled from an on-chain DEX)
-* Paymasters run the risk of getting griefed, as users could send ops that appear to pay the paymaster but then change their behavior after a block
+#### * debug_bundler_clearState
 
-The paymaster scheme allows a contract to passively pay on users' behalf under arbitrary conditions. It even allows EIP-20 token paymasters to secure a guarantee that they would only need to pay if the user pays them: the paymaster contract can check that there is sufficient approved EIP-20 balance in the `validatePaymasterUserOp` method, and then extract it with `transferFrom` in the `postOp` call; if the op itself transfers out or de-approves too much of the EIP-20s, the inner `postOp` will fail and revert the execution and the outer `postOp` can extract payment (note that because of storage access restrictions the EIP-20 would need to be a wrapper defined within the paymaster itself).
+Clears the bundler mempool and reputation data of paymasters/accounts/factories/aggregators.
 
-### First-time wallet creation
+```json=
+# Request
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "debug_bundler_clearState",
+  "params": []
+}
 
-It is an important design goal of this proposal to replicate the key property of EOAs that users do not need to perform some custom action or rely on an existing user to create their wallet; they can simply generate an address locally and immediately start accepting funds.
+# Response
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "result": "ok"
+}
+```
 
-The wallet creation itself is done by a "factory" contract, with wallet-specific data.
-The factory is expected to use CREATE2 (not CREATE) to create the wallet, so that the order of creation of wallets doesn't interfere with the generated addresses.
-The `initCode` field (if non-zero length) is parsed as a 20-byte address, followed by "calldata" to pass to this address.
-This method call is expected to create a wallet and return its address.
-When `initCode` is specified, if either the `sender` address points to an existing contract, or (after calling the initCode) the `sender` address still does not exist,
-then the operation is aborted.
-The `initCode` MUST NOT be called directly from the entryPoint, but from another address.
-The contract created by this factory method should accept a call to `validateUserOp` to validate the UserOp's signature.
-For security reasons, it is important that the generated contract address will depend on the initial signature.
-This way, even if someone can create a wallet at that address, he can't set different credentials to control it.
+#### * debug_bundler_dumpMempool
 
-NOTE: In order for the wallet to determine the "counterfactual" address of the wallet (prior its creation), 
-it should make a static call to the `entryPoint.createSender()`
+Dumps the current UserOperations mempool
 
-### Entry point upgrading
+**Parameters:**
+
+* **EntryPoint** the entrypoint used by eth_sendUserOperation
+
+**Returns:**
+
+`array` - Array of UserOperations currently in the mempool.
+
+```json=
+# Request
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "debug_bundler_dumpMempool",
+  "params": ["0x1306b01bC3e4AD202612D3843387e94737673F53"]
+}
+
+# Response
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "result": [
+    {
+        sender, // address
+        nonce, // uint256
+        initCode, // bytes
+        callData, // bytes
+        callGasLimit, // uint256
+        verificationGasLimit, // uint256
+        preVerificationGas, // uint256
+        maxFeePerGas, // uint256
+        maxPriorityFeePerGas, // uint256
+        paymasterAndData, // bytes
+        signature // bytes
+    }
+  ]
+}
+```
+
+#### * debug_bundler_sendBundleNow
+
+Forces the bundler to build and execute a bundle from the mempool as `handleOps()` transaction.
+
+Returns: `transactionHash`
+
+```json=
+# Request
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "debug_bundler_sendBundleNow",
+  "params": []
+}
+
+# Response
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "result": "0xdead9e43632ac70c46b4003434058b18db0ad809617bd29f3448d46ca9085576"
+}
+```
+
+#### * debug_bundler_setBundlingMode
+
+Sets bundling mode.
 
-Wallets are encouraged to be DELEGATECALL forwarding contracts for gas efficiency and to allow wallet upgradability. The wallet code is expected to hard-code the entry point into their code for gas efficiency. If a new entry point is introduced, whether to add new functionality, improve gas efficiency, or fix a critical security bug, users can self-call to replace their wallet's code address with a new code address containing code that points to a new entry point. During an upgrade process, it's expected that two mempools will run in parallel.
+After setting mode to "manual", an explicit call to debug_bundler_sendBundleNow is required to send a bundle.
+
+##### parameters:
+
+`mode` - 'manual' | 'auto'
+
+```json=
+# Request
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "debug_bundler_setBundlingMode",
+  "params": ["manual"]
+}
+
+# Response
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "result": "ok"
+}
+```
+
+#### * debug_bundler_setReputation
+
+Sets reputation of given addresses. parameters:
+
+**Parameters:**
+
+* An array of reputation entries to add/replace, with the fields:
+
+  * `address` - The address to set the reputation for.
+  * `opsSeen` - number of times a user operations with that entity was seen and added to the mempool
+  * `opsIncluded` - number of times a user operations that uses this entity was included on-chain
+  * `status` - (string) The status of the address in the bundler 'ok' | 'throttled' | 'banned'.
+
+* **EntryPoint** the entrypoint used by eth_sendUserOperation
+
+```json=
+# Request
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "debug_bundler_setReputation",
+  "params": [
+    [
+      {
+        "address": "0x7A0A0d159218E6a2f407B99173A2b12A6DDfC2a6",
+        "opsSeen": 20,
+        "opsIncluded": 13
+      }
+    ],
+    "0x1306b01bC3e4AD202612D3843387e94737673F53"
+  ]
+}
+
+# Response
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "result": "ok"
+}
+```
+
+
+#### * debug_bundler_dumpReputation
+
+Returns the reputation data of all observed addresses.
+Returns an array of reputation objects, each with the fields described above in `debug_bundler_setReputation` with the
+
+
+**Parameters:**
+
+* **EntryPoint** the entrypoint used by eth_sendUserOperation
+
+**Return value:**
+
+An array of reputation entries with the fields:
+
+* `address` - The address to set the reputation for.
+* `opsSeen` - number of times a user operations with that entity was seen and added to the mempool
+* `opsIncluded` - number of times a user operations that uses this entity was included on-chain
+* `status` - (string) The status of the address in the bundler 'ok' | 'throttled' | 'banned'.
+
+```json=
+# Request
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "method": "debug_bundler_dumpReputation",
+  "params": ["0x1306b01bC3e4AD202612D3843387e94737673F53"]
+}
+
+# Response
+{
+  "jsonrpc": "2.0",
+  "id": 1,
+  "result": [
+    { "address": "0x7A0A0d159218E6a2f407B99173A2b12A6DDfC2a6",
+      "opsSeen": 20,
+      "opsIncluded": 19,
+      "status": "ok"
+    }
+  ]
+}
+```
 
 ## Backwards Compatibility
 
-This EIP does not change the consensus layer, so there are no backwards compatibility issues for Ethereum as a whole. Unfortunately it is not easily compatible with pre-4337 wallets, because those wallets do not have a `validateUserOp` function. If the wallet has a function for authorizing a trusted op submitter, then this could be fixed by creating an 4337-compatible wallet that re-implements the verification logic as a wrapper and setting it to be the original wallet's trusted op submitter.
+This EIP does not change the consensus layer, so there are no backwards compatibility issues for Ethereum as a whole. Unfortunately it is not easily compatible with pre-[EIP-4337](./eip-4337.md) accounts, because those accounts do not have a `validateUserOp` function. If the account has a function for authorizing a trusted op submitter, then this could be fixed by creating an [EIP-4337](./eip-4337.md) compatible account that re-implements the verification logic as a wrapper and setting it to be the original account's trusted op submitter.
 
 ## Reference Implementation
 
@@ -467,13 +894,13 @@ See `https://github.com/eth-infinitism/account-abstraction/tree/main/contracts`
 
 ## Security Considerations
 
-The entry point contract will need to be very heavily audited and formally verified, because it will serve as a central trust point for _all_ [EIP-4337](./eip-4337.md) wallets. In total, this architecture reduces auditing and formal verification load for the ecosystem, because the amount of work that individual _wallets_ have to do becomes much smaller (they need only verify the `validateUserOp` function and its "check signature, increment nonce and pay fees" logic) and check that other functions are `msg.sender == ENTRY_POINT` gated (perhaps also allowing `msg.sender == self`), but it is nevertheless the case that this is done precisely by concentrating security risk in the entry point contract that needs to be verified to be very robust.
+The entry point contract will need to be very heavily audited and formally verified, because it will serve as a central trust point for _all_ [EIP-4337](./eip-4337.md). In total, this architecture reduces auditing and formal verification load for the ecosystem, because the amount of work that individual _accounts_ have to do becomes much smaller (they need only verify the `validateUserOp` function and its "check signature, increment nonce and pay fees" logic) and check that other functions are `msg.sender == ENTRY_POINT` gated (perhaps also allowing `msg.sender == self`), but it is nevertheless the case that this is done precisely by concentrating security risk in the entry point contract that needs to be verified to be very robust.
 
 Verification would need to cover two primary claims (not including claims needed to protect paymasters, and claims needed to establish p2p-level DoS resistance):
 
-* **Safety against arbitrary hijacking**: The entry point only calls a wallet generically if `validateUserOp` to that specific wallet has passed (and with `op.calldata` equal to the generic call's calldata)
+* **Safety against arbitrary hijacking**: The entry point only calls an account generically if `validateUserOp` to that specific account has passed (and with `op.calldata` equal to the generic call's calldata)
 * **Safety against fee draining**: If the entry point calls `validateUserOp` and passes, it also must make the generic call with calldata equal to `op.calldata`
 
 ## Copyright
-Copyright and related rights waived via [CC0](../LICENSE.md).
 
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 452992c400fddd5747c690d78774505965d11bc7 Mon Sep 17 00:00:00 2001
From: Firn Protocol <93839494+firnprotocol@users.noreply.github.com>
Date: Thu, 29 Dec 2022 11:29:46 -0500
Subject: [PATCH 094/274] add material to EIP-5630 (#6235)

* first commit for update to EIP-5630

* add material on encrypting to contract

* linting fixes. add blank lines and links.
---
 EIPS/eip-5630.md | 119 ++++++++++++++++++++++++++++-------------------
 1 file changed, 70 insertions(+), 49 deletions(-)

diff --git a/EIPS/eip-5630.md b/EIPS/eip-5630.md
index 445bd02506116a..1d96108a1693cb 100644
--- a/EIPS/eip-5630.md
+++ b/EIPS/eip-5630.md
@@ -13,38 +13,25 @@ created: 2022-09-07
 
 ## Abstract
 
-This EIP proposes a new way to encrypt and decrypt using Ethereum keys. This EIP uses separate, unlinkable, pseudorandom keys for signing and encryption; it uses _only_ the `secp256k1` curve, and it uses a standardized version of ECIES. In contrast, other EIPs reused secret keys across both signing and encryption, and moreover reused the same secret key across both the `secp256k1` and `ec25519` curves.
+This EIP proposes a new way to encrypt and decrypt using Ethereum keys. This EIP uses _only_ the `secp256k1` curve, and it uses a standardized version of ECIES. In contrast, a previous EIPs used the same secret key, in both signing and encryption, on two _different_ curves (namely, `secp256k1` and `ec25519`).
 
 ## Motivation
 
-We discuss a few motivating examples. In a certain common design pattern, a dApp generates a fresh secret on behalf of a user. It is of interest if, instead of forcing this user to independently store, safeguard, and back up this latter secret, the dApp may instead encrypt this secret to a public key which the user controls—and whose secret key, crucially, can be derived deterministically from the user's HD wallet hierarchy—and then post the resulting ciphertext to secure storage (e.g., on-chain).
+We discuss a few motivating examples. One key motivation is direct-to-address encryption on Ethereum. Using our EIP, one can directly send encrypted messages to some desired recipient on-chain, without having a prior direct channel to that recipient. (Note that in this EIP, we standardize _only_ the encryption procedure—that is, the generation of the ciphertext—and _not_ how exactly the on-chain message should be sent. In practice, ideally, smart-contract infrastructure will be set up for this purpose; barring this, encryptors could make use of the raw `data` field available in each standard transfer.)
 
-This design pattern allows the dApp/user to bootstrap the security of the _fresh_ secret onto the security of the user's existing HD wallet seed phrase, which the user has already gone through the trouble of safeguarding and storing. This represents a far lower UX burden than forcing the user to store and manage fresh keys directly (which can, and often does, lead to loss of funds). We note that this _exact_ design pattern described above is used today by, e.g., Tornado Cash.
-
-As a separate motivation, we mention the possibility of dApps which facilitate end-to-end encrypted messaging.
+We discuss a second sort of example. In a certain common design pattern, a dApp generates a fresh secret on behalf of a user. It is of interest if, instead of forcing this user to independently store, safeguard, and back up this latter secret, the dApp may instead encrypt this secret to a public key which the user controls—and whose secret key, crucially, resides within the user's HD wallet hierarchy—and then post the resulting ciphertext to secure storage (e.g., on-chain).  This design pattern allows the dApp/user to bootstrap the security of the _fresh_ secret onto the security of the user's existing HD wallet seed phrase, which the user has already gone through the trouble of safeguarding and storing. This represents a far lower UX burden than forcing the user to store and manage fresh keys directly (which can, and often does, lead to loss of funds). We note that this design pattern described above is used today by, various dApps (e.g., Tornado Cash).
 
 ## Specification
 
-We describe our approach here; we compare our approach to other EIPs in the **Rationale** section below.
+We describe our approach here; we compare our approach to prior EIPs in the **Rationale** section below.
 
-We use the `secp256k1` curve for both signing and encryption (with different keys, see below).
-In the latter case, we use ECIES; specifically, we use a standardized variant.
-Specifically, we propose the choices:
+We use the `secp256k1` curve for both signing and encryption.
+For encryption, we use ECIES. Specifically, we propose the standardized choices:
 
 - the KDF `ANSI-X9.63-KDF`, where the hash function `SHA-512` is used,
 - the HMAC `HMAC–SHA-256–256 with 32 octet or 256 bit keys`,
 - the symmetric encryption scheme `AES–256 in CBC mode`.
 
-We finally describe a method to derive encryption secret keys deterministically—but pseudorandomly—from signing keys, in such a way that a natural one-to-one relationship obtains between these keys (this latter property is essential, since it allows Ethereum accounts to be used as handles onto encryption/decryption keys, as both the former and current API interfaces do).
-Indeed, we propose that, given a signing private key _sk_ ∈ 𝔽_q—which is naturally represented as a 32-byte big-endian byte string—the corresponding decryption key _dk_ ∈ 𝔽_q be generated as the 32-byte secret:
-
-```solidity
-    dk := ANSI-X9.63-KDF(sk),
-```
-
-where moreover the _Ethereum `keccak256`_ hash is used for this KDF. This latter decision is essentially for implementation convenience; indeed, MetaMask's `eth-simple-keyring` already has something close to this functionality built in, and it requires only a minimal code change (see our implementation below).
-We set _SharedInfo_ to be empty here.
-
 We propose that the binary, _concatenated_ serialization mode for ECIES ciphertexts be used, both for encryption and decryption, where moreover elliptic curve points are _compressed_. This approach is considerably more space-efficient than the prior approach, which outputted a stringified JSON object (itself containing base64-encoded fields).
 We moreover propose that binary data be serialized to and from `0x`-prefixed hex strings. We moreover use `0x`-prefixed hex strings to specify private keys and public keys, and represent public keys in compressed form. We represent Ethereum accounts in the usual way (`0x`-prefixed, 20-byte hex strings).
 
@@ -58,10 +45,10 @@ request({
 ```
 
 where `account` is a standard 20-byte, `0x`-prefixed, hex-encoded Ethereum account, the client should operate as follows:
- - find the secret signing key `sk` corresponding to the Ethereum account `account`, or else return an error if none exists.
- - compute the 32-byte secret `dk := ANSI-X9.63-KDF(sk)`, where the `keccak256` hash is used in the KDF.
- - compute the `secp256k1` public key corresponding to `dk`.
- - return this public key in compressed, `0x`-prefixed, hex-encoded form.
+
+- find the secret signing key `sk` corresponding to the Ethereum account `account`, or else return an error if none exists.
+- compute the `secp256k1` public key corresponding to `sk`.
+- return this public key in compressed, `0x`-prefixed, hex-encoded form.
 
 On the request
 
@@ -73,45 +60,77 @@ request({
 ```
 
 where `account` is as above, and `encryptedMessage` is a JSON object with the properties `version` (an arbitrary string) and `ciphertext` (a `0x`-prefixed, hex-encoded, bytes-like string), the client should operate as follows:
- - perform a `switch` on the value `encryptedMessage.version`. if it equals:
-   - `x25519-xsalsa20-poly1305`, then use #1098's specification;
-   - `secp256k1-sha512kdf-aes256cbc-hmacsha256`, then proceed as described below;
-   - if it equals neither, throw an error.
- - find the secret key `sk` corresponding to the Ethereum account `account`, or else return an error if none exists.
- - compute the 32-byte secret `dk := ANSI-X9.63-KDF(sk)`, where the `keccak256` hash is used in the KDF.
- - using `dk`, perform an ECIES decryption of `encryptedMessage.ciphertext`, where the above choices of parameters are used.
- - decode the resulting binary plaintext as a `utf-8` string, and return it.
+
+- perform a `switch` on the value `encryptedMessage.version`. if it equals:
+   - `secp256k1-sha512kdf-aes256cbc-hmacsha256`, then break from the switch and proceed as in the bullets below;
+   - `x25519-xsalsa20-poly1305`, then, optionally, use #1098's specification _if_ backwards compatibility is desired, and otherwise fallthrough;
+   - `default`, throw an error.
+- find the secret key `sk` corresponding to the Ethereum account `account`, or else return an error if none exists.
+- using `sk`, perform an ECIES decryption of `encryptedMessage.ciphertext`, where the above choices of parameters are used.
+- decode the resulting binary plaintext as a `utf-8` string, and return it.
 
 Test vectors are given below.
+
+### Encrypting to a smart contract
+
+In light of account abstraction, [EIP-4337](eip-4337.md), and the advent of smart-contract wallets, we moreover specify a way to encrypt to a contract.
+More precisely, we specify a way for a contract to _advertise_ how it would like encryptions to it to be constructed. This should be viewed as an analogue of [EIP-1271](eip-1271.md), but for encryption, as opposed to signing.
+
+Our specification is as follows.
+
+```solidity
+pragma solidity ^0.8.0;
+
+contract ERC5630 {
+  /**
+   * @dev Should return an encryption of the provided plaintext, using the provided randomness.
+   * @param plaintext_      Plaintext to be encrypted
+   * @param randomness_     Entropy to be used during encryption
+  function encryptTo(bytes memory plaintext, bytes32 randomness)
+    public
+    view
+    returns (string memory version, bytes memory ciphertext);
+}
+```
+
+Each contract should implement `encryptToAccount` as it desires; for example, it could use our specification above (i.e., for some fixed public key depending on the contract), or something arbitrary.
+
 ## Rationale
 
 There is _no security proof_ for a scheme which simultaneously invokes signing on the `secp256k1` curve and encryption on the `ec25519` curve, and where _the same secret key is moreover used in both cases_. Though no attacks are known, it is not desirable to use a scheme which lacks a proof in this way.
-Certain papers have studied the reuse of the same key in signing and encryption, but where _the same curve is used in both_ (e.g., in the context of EMV payments). Those papers have found the joint scheme to be secure in the generic group model.
-Though this result provides _some level of_ assurance of security of this joint scheme (where, we stress, _only one_ curve is used), it is at least as secure to use different, pseudorandomly unlinkable keys for signing and encryption. Indeed, we note that if the hash function is modeled as a random oracle, then each decryption key `dk` is completely random, and in particular uncorrelated with its corresponding signing key.
+We, instead, propose the reuse of the same key in signing and encryption, but where _the same curve is used in both_. This very setting has been studied in prior work; see, e.g., Degabriele, Lehmann, Paterson, Smart and Strefler, _On the Joint Security of Encryption and Signature in EMV_, 2011. That work found this joint scheme to be secure in the generic group model.
+We note that this very joint scheme (i.e., using ECDSA and ECIES on the same curve) is used live in production in EMV payments.
+
+We now discuss a few further aspects of our approach.
+
+**On-chain public key discovery.** Our proposal has an important feature whereby an encryption _to_ some account can be constructed whenever that account has signed at least one transaction.
+Indeed, it is possible to recover an account's `secp256k1` public key directly from any signature on behalf of that account.
+
+**Twist attacks.** A certain GitHub post by Christian Lundkvist warns against "twist attacks" on the `secp256k1` curve. These attacks are not applicable to this EIP, for multiple _distinct_ reasons, which we itemize:
+- **Only applies to ECDH, not ECIES.** This attack only applies to a scenario in which an attacker can induce a victim to exponentiate an attacker-supplied point by a sensitive scalar, and then moreover send the result back to the attacker. But this pattern only happens in ECDH, and never ECIES. Indeed, in ECIES, we recall that the only sensitive Diffie–Hellman operation happens during decryption, but in this case, the victim (who would be the decryptor) never sends the resulting DH point back to the attacker (rather, the victim merely uses it locally to attempt an AES decryption). During _encryption_, the exponentiation is done by the encryptor, who has no secret at all (sure enough, the exponentiation is by an ephemeral scalar), so here there would be nothing for the attacker to learn.
+- **Only applies to uncompressed points.** Indeed, we use compressed points in this EIP; when compressed points are used, any 32-byte string supplied by an attacker will resolve canonically to a point on the right curve, or else generate an error; there is no possibility of a "wrong curve" point.
+- **Only applies when you fail to check a point is on the curve.** But this is inapplicable for us anyway, since we use compressed points (see above).
 
 ## Backwards Compatibility
-The previous proposal stipulated that encryption and decryption requests contain a `version` string. Our proposal merely adds a case for this string; encryption and decryption requests under the existing scheme will be handled identically. Unfortunately, the previous proposal did _not_ include a version string in `encryptionPublicKey`, and merely returned the `ec25519` public key directly as a string. We thus propose to immediately return the `secp256k1` public key, overwriting the previous behavior. The old behavior can be kept via a legacy method.
 
-We note that the previous EIP is _not_ (to our knowledge) implemented in a non-deprecated manner in _any_ production code today, and the EIP stagnated. We thus have a lot of flexibility here; we only need enough backwards compatibility to allow dApps to migrate.
+The previous EIP stipulated that encryption and decryption requests contain a `version` string. Our proposal merely adds a case for this string; encryption and decryption requests under the existing scheme will be handled identically.
+The previous proposal did _not_ include a version string in `encryptionPublicKey`, and merely returned the `ec25519` public key directly as a string. We thus propose to immediately return the `secp256k1` public key, overwriting the previous behavior.
+It is unlikely that this will be an issue, since encryption keys need be newly retrieved _only_ upon the time of encryption; on the other hand, _new_ ciphertexts will be generated using our new approach.
+
+In any case, the previous EIP was never standardized, and is _not_ (to our knowledge) implemented in a non-deprecated manner in _any_ production code today. We thus have a lot of flexibility here; we only need enough backwards compatibility to allow dApps to migrate.
 
 ### Test Cases
 
-Starting from the secret _signing key_
+The secret _signing key_
 
 ```
     0x439047a312c8502d7dd276540e89fe6639d39da1d8466f79be390579d7eaa3b2
 ```
 
-with Ethereum address `0x72682F2A3c160947696ac3c9CC48d290aa89549c`, the `keccak256`-based KDF described above yields the secret _decryption key_
+with Ethereum address `0x72682F2A3c160947696ac3c9CC48d290aa89549c`, has `secp256k1` public key
 
 ```
-    0xecb4fbc91b48954259469d13d2e69c6fe4b57b73dd9dd277085b2d5e764a4023
-```
-
-with `secp256k1` public key
-
-```
-    0x023e5feced05739d8aad239b037787ba763706fb603e3e92ff0a629e8b4ec2f9be
+    0x03ff5763a2d3113229f2eda8305fae5cc1729e89037532a42df357437532770010
 ```
 
 Thus, the request:
@@ -126,15 +145,15 @@ request({
 should return:
 
 ```javascript
-"0x023e5feced05739d8aad239b037787ba763706fb603e3e92ff0a629e8b4ec2f9be"
+"0x03ff5763a2d3113229f2eda8305fae5cc1729e89037532a42df357437532770010"
 ```
 
-Encrypting the message `"My name is Satoshi Buterin"` under the above public key could yield, for example:
+Encrypting the UTF-8 message `I use Firn Protocol to gain privacy on Ethereum.` under the above public key could yield, for example:
 
 ```javascript
 {
   version: 'secp256k1-sha512kdf-aes256cbc-hmacsha256',
-  ciphertext: '0x03ab54b1b866c5231787fddc2b4dfe9813b6222646b811a2a395040e24e098ae93e39ceedec5516dbf04dbd7b8f5f5030cde786f6aeed187b1d10965714f8d383c2240b4014809077248ddb66cc8bd86eb815dff0e42b0613bbdd3024532c19d0a',
+  ciphertext: '0x036f06f9355b0e3f7d2971da61834513d5870413d28a16d7d68ce05dc78744daf850e6c2af8fb38e3e31d679deac82bd12148332fa0e34aecb31981bd4fe8f7ac1b74866ce65cbe848ee7a9d39093e0de0bd8523a615af8d6a83bbd8541bf174f47b1ea2bd57396b4a950a0a2eb77af09e36bd5832b8841848a8b302bd816c41ce',
 }
 ```
 
@@ -145,15 +164,17 @@ request({
   method: 'eth_decrypt',
   params: [{
     version: 'secp256k1-sha512kdf-aes256cbc-hmacsha256',
-    ciphertext: '0x03ab54b1b866c5231787fddc2b4dfe9813b6222646b811a2a395040e24e098ae93e39ceedec5516dbf04dbd7b8f5f5030cde786f6aeed187b1d10965714f8d383c2240b4014809077248ddb66cc8bd86eb815dff0e42b0613bbdd3024532c19d0a',
+    ciphertext: '0x036f06f9355b0e3f7d2971da61834513d5870413d28a16d7d68ce05dc78744daf850e6c2af8fb38e3e31d679deac82bd12148332fa0e34aecb31981bd4fe8f7ac1b74866ce65cbe848ee7a9d39093e0de0bd8523a615af8d6a83bbd8541bf174f47b1ea2bd57396b4a950a0a2eb77af09e36bd5832b8841848a8b302bd816c41ce',
   }, "0x72682F2A3c160947696ac3c9CC48d290aa89549c"],
 })
 ```
 
-should return the string `"My name is Satoshi Buterin"`.
+should return the string `I use Firn Protocol to gain privacy on Ethereum.`.
 
 ## Security Considerations
+
 Our proposal uses heavily standardized algorithms and follows all best practices.
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 805feb30e3e36d3ac5dcc27e4eb0617afd9c4480 Mon Sep 17 00:00:00 2001
From: Firn Protocol <93839494+firnprotocol@users.noreply.github.com>
Date: Thu, 29 Dec 2022 11:40:52 -0500
Subject: [PATCH 095/274] small cleanups (#6236)

---
 EIPS/eip-5630.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-5630.md b/EIPS/eip-5630.md
index 1d96108a1693cb..ad56f63de637b6 100644
--- a/EIPS/eip-5630.md
+++ b/EIPS/eip-5630.md
@@ -84,8 +84,9 @@ pragma solidity ^0.8.0;
 contract ERC5630 {
   /**
    * @dev Should return an encryption of the provided plaintext, using the provided randomness.
-   * @param plaintext_      Plaintext to be encrypted
-   * @param randomness_     Entropy to be used during encryption
+   * @param plaintext      Plaintext to be encrypted
+   * @param randomness     Entropy to be used during encryption
+   */
   function encryptTo(bytes memory plaintext, bytes32 randomness)
     public
     view
@@ -107,6 +108,7 @@ We now discuss a few further aspects of our approach.
 Indeed, it is possible to recover an account's `secp256k1` public key directly from any signature on behalf of that account.
 
 **Twist attacks.** A certain GitHub post by Christian Lundkvist warns against "twist attacks" on the `secp256k1` curve. These attacks are not applicable to this EIP, for multiple _distinct_ reasons, which we itemize:
+
 - **Only applies to ECDH, not ECIES.** This attack only applies to a scenario in which an attacker can induce a victim to exponentiate an attacker-supplied point by a sensitive scalar, and then moreover send the result back to the attacker. But this pattern only happens in ECDH, and never ECIES. Indeed, in ECIES, we recall that the only sensitive Diffie–Hellman operation happens during decryption, but in this case, the victim (who would be the decryptor) never sends the resulting DH point back to the attacker (rather, the victim merely uses it locally to attempt an AES decryption). During _encryption_, the exponentiation is done by the encryptor, who has no secret at all (sure enough, the exponentiation is by an ephemeral scalar), so here there would be nothing for the attacker to learn.
 - **Only applies to uncompressed points.** Indeed, we use compressed points in this EIP; when compressed points are used, any 32-byte string supplied by an attacker will resolve canonically to a point on the right curve, or else generate an error; there is no possibility of a "wrong curve" point.
 - **Only applies when you fail to check a point is on the curve.** But this is inapplicable for us anyway, since we use compressed points (see above).

From 63011d318fa80dbfee8dde77e97cc5e42f578a18 Mon Sep 17 00:00:00 2001
From: Hugo <jhugodc@gmail.com>
Date: Fri, 30 Dec 2022 05:48:25 -0700
Subject: [PATCH 096/274] Test cases: specify when contract creation fails in
 Valid initcode (#6237)

---
 EIPS/eip-3540.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/EIPS/eip-3540.md b/EIPS/eip-3540.md
index ef9e1997a7d189..038500049c4b23 100644
--- a/EIPS/eip-3540.md
+++ b/EIPS/eip-3540.md
@@ -265,13 +265,13 @@ All cases should be checked for creation transaction, `CREATE` and `CREATE2`.
 - Legacy init code
   - Returns legacy code
   - Returns valid EOF1 code
-  - Returns invalid EOF1 code
-  - Returns 0xEF not followed by EOF1 code
+  - Returns invalid EOF1 code, contract creation fails
+  - Returns 0xEF not followed by EOF1 code, contract creation fails
 - Valid EOF1 init code
-  - Returns legacy code
+  - Returns legacy code, contract creation fails
   - Returns valid EOF1 code
-  - Returns invalid EOF1 code
-  - Returns 0xEF not followed by EOF1 code
+  - Returns invalid EOF1 code, contract creation fails
+  - Returns 0xEF not followed by EOF1 code, contract creation fails
 - Invalid EOF1 init code
 
 ### Contract execution

From 778ea2b5179c97d12b674d317ab9367ef9897efe Mon Sep 17 00:00:00 2001
From: Austin Zhu <42071208+AustinZhu@users.noreply.github.com>
Date: Fri, 30 Dec 2022 23:00:27 +0900
Subject: [PATCH 097/274] Update EIP-5727: rename soul to owner; improve
 SlotEnumerable methods (#6240)

* feat: upload eip draft

* fix: update erc number

* feat: upload assets

* fix: update implementation link

* fix: update author info

* feat: upload sample implementation

* fix: add hardhat project config

* fix: revise eip-5727

* fix: change ERC to EIP

* fix: fix links to eip

* fix: update tests

* feat: include interface id; update sample

* fix: rename soul to owner; add methods to SlotEnumerable

* fix: fix markdown lint problems
---
 EIPS/eip-5727.md                              |  179 +-
 assets/eip-5727/contracts/ERC5727.sol         |   34 +-
 assets/eip-5727/contracts/ERC5727Delegate.sol |   12 +-
 .../eip-5727/contracts/ERC5727Enumerable.sol  |   76 +-
 assets/eip-5727/contracts/ERC5727Example.sol  |   30 +-
 .../eip-5727/contracts/ERC5727Governance.sol  |   20 +-
 assets/eip-5727/contracts/ERC5727Recovery.sol |    8 +-
 assets/eip-5727/contracts/ERC5727Shadow.sol   |    4 +-
 .../contracts/ERC5727SlotEnumerable.sol       |  105 +-
 .../contracts/interfaces/IERC5727.sol         |   20 +-
 .../contracts/interfaces/IERC5727Delegate.sol |   22 +-
 .../interfaces/IERC5727Enumerable.sol         |   40 +-
 .../interfaces/IERC5727Governance.sol         |    6 +-
 .../contracts/interfaces/IERC5727Recovery.sol |    8 +-
 .../interfaces/IERC5727SlotEnumerable.sol     |   51 +
 assets/eip-5727/pnpm-lock.yaml                | 4782 +++++++++++++++++
 16 files changed, 5186 insertions(+), 211 deletions(-)
 create mode 100644 assets/eip-5727/pnpm-lock.yaml

diff --git a/EIPS/eip-5727.md b/EIPS/eip-5727.md
index aae92a5f99355b..5784ebabfe8d1e 100644
--- a/EIPS/eip-5727.md
+++ b/EIPS/eip-5727.md
@@ -12,14 +12,16 @@ requires: 165
 ---
 
 ## Abstract
-An interface for soulbound tokens (SBT), which are non-transferable tokens representing a person's identity, credentials, affiliations, reputation, and private assets.
+
+An interface for soulbound tokens (SBT), which are non-transferable tokens representing a person's identity, credentials, affiliations, and reputation.
 
 Our interface can handle a combination of fungible and non-fungible tokens in an organized way. It provides a set of core methods that can be used to manage the lifecycle of soulbound tokens, as well as a rich set of extensions that enables DAO governance, privacy protection, token expiration, and account recovery.
 
 This interface aims to provide a flexible and extensible framework for the development of soulbound token systems.
 
 ## Motivation
-The Web3 ecosystem nowadays is largely dominated by highly-financialized tokens, which are designed to be freely transferable and interchangeable. However, there are many use cases in our society that requires non-transferablity. For example, a membership card guarantees one's proprietary rights in a community, and such rights should not be transferable to others.
+
+The Web3 ecosystem nowadays is largely dominated by highly-financialized tokens, which are designed to be freely transferable and interchangeable. However, there are many use cases in our society that require non-transferablity. For example, a membership card guarantees one's proprietary rights in a community, and such rights should not be transferable to others.
 
 We have already seen many attempts to create such non-transferable tokens in the Ethereum community. However, most of them rely heavily on NFT standards like [EIP-721](./eip-721.md), which are not designed for non-transferability. Others lack the flexibility to support both fungible and non-fungible tokens and do not provide extensible features for critical use cases.
 
@@ -35,6 +37,7 @@ Our interface can be used to represent non-transferable ownerships, and provides
 A common interface for soulbound tokens will not only help enrich the Web3 ecosystem but also facilitates the growth of a decentralized society.
 
 ## Specification
+
 The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
 
 A token is identified by its `tokenId`, which is a 256-bit unsigned integer. A token can also have a value denoting its denomination.
@@ -42,6 +45,7 @@ A token is identified by its `tokenId`, which is a 256-bit unsigned integer. A t
 A slot is identified by its `slotId`, which is a 256-bit unsigned integer. Slots are used to group fungible and non-fungible tokens together, thus make tokens semi-fungible. A token can only belong to one slot at a time.
 
 ### Core
+
 The core methods are used to manage the lifecycle of SBTs. They MUST be supported by all semi-fungible SBT implementations.
 
 ```solidity
@@ -57,18 +61,18 @@ import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
 interface IERC5727 is IERC165 {
     /**
      * @dev MUST emit when a token is minted.
-     * @param soul The address that the token is minted to
+     * @param owner The address that the token is minted to
      * @param tokenId The token minted
      * @param value The value of the token minted
      */
-    event Minted(address indexed soul, uint256 indexed tokenId, uint256 value);
+    event Minted(address indexed owner, uint256 indexed tokenId, uint256 value);
 
     /**
      * @dev MUST emit when a token is revoked.
-     * @param soul The owner soul of the revoked token
+     * @param owner The owner of the revoked token
      * @param tokenId The revoked token
      */
-    event Revoked(address indexed soul, uint256 indexed tokenId);
+    event Revoked(address indexed owner, uint256 indexed tokenId);
 
     /**
      * @dev MUST emit when a token is charged.
@@ -86,13 +90,14 @@ interface IERC5727 is IERC165 {
 
     /**
      * @dev MUST emit when a token is destroyed.
-     * @param soul The owner soul of the destroyed token
+     * @param owner The owner of the destroyed token
      * @param tokenId The token to destroy.
      */
-    event Destroyed(address indexed soul, uint256 indexed tokenId);
+    event Destroyed(address indexed owner, uint256 indexed tokenId);
 
     /**
      * @dev MUST emit when the slot of a token is set or changed.
+     * @dev In case a new slot is set, the `oldSlot` MUST be 0.
      * @param tokenId The token of which slot is set or changed
      * @param oldSlot The previous slot of the token
      * @param newSlot The updated slot of the token
@@ -120,16 +125,17 @@ interface IERC5727 is IERC165 {
     function slotOf(uint256 tokenId) external view returns (uint256);
 
     /**
-     * @notice Get the owner soul of a token.
+     * @notice Get the owner of a token.
      * @dev MUST revert if the `tokenId` does not exist
-     * @param tokenId the token for which to query the owner soul
-     * @return The address of the owner soul of `tokenId`
+     * @param tokenId the token for which to query the owner
+     * @return The address of the owner of `tokenId`
      */
-    function soulOf(uint256 tokenId) external view returns (address);
+    function ownerOf(uint256 tokenId) external view returns (address);
 
     /**
      * @notice Get the validity of a token.
      * @dev MUST revert if the `tokenId` does not exist
+     * @dev A token is valid if it is not revoked.
      * @param tokenId the token for which to query the validity
      * @return If the token is valid
      */
@@ -146,9 +152,12 @@ interface IERC5727 is IERC165 {
 ```
 
 ### Extensions
+
 All extensions below are OPTIONAL for [EIP-5727](./eip-5727.md) implementations. An implementation MAY choose to implement some, none, or all of them.
+
 #### Enumerable
-This extension provides methods to enumerate the tokens of a soul. It is recommended to be implemented together with the core interface.
+
+This extension provides methods to enumerate the tokens of a owner. It is recommended to be implemented together with the core interface.
 
 ```solidity
 pragma solidity ^0.8.0;
@@ -157,7 +166,7 @@ import "./IERC5727.sol";
 
 /**
  * @title ERC5727 Soulbound Token Enumerable Interface
- * @dev This extension allows querying the tokens of a soul.
+ * @dev This extension allows querying the tokens of a owner.
  * @dev interfaceId = 0x211ec300
  */
 interface IERC5727Enumerable is IERC5727 {
@@ -168,19 +177,19 @@ interface IERC5727Enumerable is IERC5727 {
     function emittedCount() external view returns (uint256);
 
     /**
-     * @notice Get the total number of souls.
-     * @return The total number of souls
+     * @notice Get the total number of owners.
+     * @return The total number of owners
      */
-    function soulsCount() external view returns (uint256);
+    function ownersCount() external view returns (uint256);
 
     /**
-     * @notice Get the tokenId with `index` of the `soul`.
-     * @dev MUST revert if the `index` exceed the number of tokens owned by the `soul`.
-     * @param soul The soul whose token is queried for.
+     * @notice Get the tokenId with `index` of the `owner`.
+     * @dev MUST revert if the `index` exceed the number of tokens owned by the `owner`.
+     * @param owner The owner whose token is queried for.
      * @param index The index of the token queried for
      * @return The token is queried for
      */
-    function tokenOfSoulByIndex(address soul, uint256 index)
+    function tokenOfSoulByIndex(address owner, uint256 index)
         external
         view
         returns (uint256);
@@ -194,23 +203,24 @@ interface IERC5727Enumerable is IERC5727 {
     function tokenByIndex(uint256 index) external view returns (uint256);
 
     /**
-     * @notice Get the number of tokens owned by the `soul`.
-     * @dev MUST revert if the `soul` does not have any token.
-     * @param soul The soul whose balance is queried for
-     * @return The number of tokens of the `soul`
+     * @notice Get the number of tokens owned by the `owner`.
+     * @dev MUST revert if the `owner` does not have any token.
+     * @param owner The owner whose balance is queried for
+     * @return The number of tokens of the `owner`
      */
-    function balanceOf(address soul) external view returns (uint256);
+    function balanceOf(address owner) external view returns (uint256);
 
     /**
-     * @notice Get if the `soul` owns any valid tokens.
-     * @param soul The soul whose valid token infomation is queried for
-     * @return if the `soul` owns any valid tokens
+     * @notice Get if the `owner` owns any valid tokens.
+     * @param owner The owner whose valid token information is queried for
+     * @return if the `owner` owns any valid tokens
      */
-    function hasValid(address soul) external view returns (bool);
+    function hasValid(address owner) external view returns (bool);
 }
 ```
 
 #### Metadata
+
 This extension provides methods to fetch the metadata of a token, a slot and the contract itself. It is recommended to be implemented if you need to specify the appearance and properties of tokens, slots and the contract (i.e. the SBT collection).
 
 ```solidity
@@ -261,6 +271,7 @@ interface IERC5727Metadata is IERC5727 {
 ```
 
 #### Governance
+
 This extension provides methods to manage the mint and revocation permissions through voting. It is useful if you want to rely on a group of voters to decide the issuance a particular SBT.
 
 ```solidity
@@ -281,12 +292,12 @@ interface IERC5727Governance is IERC5727 {
     function voters() external view returns (address[] memory);
 
     /**
-     * @notice Approve to mint the token described by the `approvalRequestId` to `soul`.
+     * @notice Approve to mint the token described by the `approvalRequestId` to `owner`.
      * @dev MUST revert if the caller is not a voter.
-     * @param soul The soul which the token to mint to
+     * @param owner The owner which the token to mint to
      * @param approvalRequestId The approval request describing the value and slot of the token to mint
      */
-    function approveMint(address soul, uint256 approvalRequestId) external;
+    function approveMint(address owner, uint256 approvalRequestId) external;
 
     /**
      * @notice Approve to revoke the `tokenId`.
@@ -300,7 +311,7 @@ interface IERC5727Governance is IERC5727 {
      * @dev MUST revert when `value` is zero.
      * @param value The value of the approval request to create
      */
-    function createApprovalRequest(uint256 value, uint256 slot) external;
+    function createApprovalRequest(uint256 value, uint256 slot) external returns (uint256 approvalRequestId);
 
     /**
      * @notice Remove `approvalRequestId` approval request.
@@ -328,6 +339,7 @@ interface IERC5727Governance is IERC5727 {
 ```
 
 #### Delegate
+
 This extension provides methods to delegate a one-time mint and revocation right to an operator. It is useful if you want to temporarily allow an operator to mint and revoke tokens on your behalf.
 
 ```solidity
@@ -344,8 +356,8 @@ interface IERC5727Delegate is IERC5727 {
     /**
      * @notice Delegate a one-time minting right to `operator` for `delegateRequestId` delegate request.
      * @dev MUST revert if the caller does not have the right to delegate.
-     * @param operator The soul to which the minting right is delegated
-     * @param delegateRequestId The delegate request describing the soul, value and slot of the token to mint
+     * @param operator The owner to which the minting right is delegated
+     * @param delegateRequestId The delegate request describing the owner, value and slot of the token to mint
      */
     function mintDelegate(address operator, uint256 delegateRequestId) external;
 
@@ -353,8 +365,8 @@ interface IERC5727Delegate is IERC5727 {
      * @notice Delegate one-time minting rights to `operators` for corresponding delegate request in `delegateRequestIds`.
      * @dev MUST revert if the caller does not have the right to delegate.
      *   MUST revert if the length of `operators` and `delegateRequestIds` do not match.
-     * @param operators The souls to which the minting right is delegated
-     * @param delegateRequestIds The delegate requests describing the soul, value and slot of the tokens to mint
+     * @param operators The owners to which the minting right is delegated
+     * @param delegateRequestIds The delegate requests describing the owner, value and slot of the tokens to mint
      */
     function mintDelegateBatch(
         address[] memory operators,
@@ -364,7 +376,7 @@ interface IERC5727Delegate is IERC5727 {
     /**
      * @notice Delegate a one-time revoking right to `operator` for `tokenId` token.
      * @dev MUST revert if the caller does not have the right to delegate.
-     * @param operator The soul to which the revoking right is delegated
+     * @param operator The owner to which the revoking right is delegated
      * @param tokenId The token to revoke
      */
     function revokeDelegate(address operator, uint256 tokenId) external;
@@ -373,7 +385,7 @@ interface IERC5727Delegate is IERC5727 {
      * @notice Delegate one-time minting rights to `operators` for corresponding token in `tokenIds`.
      * @dev MUST revert if the caller does not have the right to delegate.
      *   MUST revert if the length of `operators` and `tokenIds` do not match.
-     * @param operators The souls to which the revoking right is delegated
+     * @param operators The owners to which the revoking right is delegated
      * @param tokenIds The tokens to revoke
      */
     function revokeDelegateBatch(
@@ -384,14 +396,14 @@ interface IERC5727Delegate is IERC5727 {
     /**
      * @notice Mint a token described by `delegateRequestId` delegate request as a delegate.
      * @dev MUST revert if the caller is not delegated.
-     * @param delegateRequestId The delegate requests describing the soul, value and slot of the token to mint.
+     * @param delegateRequestId The delegate requests describing the owner, value and slot of the token to mint.
      */
     function delegateMint(uint256 delegateRequestId) external;
 
     /**
      * @notice Mint tokens described by `delegateRequestIds` delegate request as a delegate.
      * @dev MUST revert if the caller is not delegated.
-     * @param delegateRequestIds The delegate requests describing the soul, value and slot of the tokens to mint.
+     * @param delegateRequestIds The delegate requests describing the owner, value and slot of the tokens to mint.
      */
     function delegateMintBatch(uint256[] memory delegateRequestIds) external;
 
@@ -410,14 +422,14 @@ interface IERC5727Delegate is IERC5727 {
     function delegateRevokeBatch(uint256[] memory tokenIds) external;
 
     /**
-     * @notice Create a delegate request describing the `soul`, `value` and `slot` of a token.
-     * @param soul The soul of the delegate request.
+     * @notice Create a delegate request describing the `owner`, `value` and `slot` of a token.
+     * @param owner The owner of the delegate request.
      * @param value The value of the delegate request.
      * @param slot The slot of the delegate request.
      * @return delegateRequestId The id of the delegate request
      */
     function createDelegateRequest(
-        address soul,
+        address owner,
         uint256 value,
         uint256 slot
     ) external returns (uint256 delegateRequestId);
@@ -433,7 +445,8 @@ interface IERC5727Delegate is IERC5727 {
 ```
 
 #### Recovery
-This extension provides methods to recover tokens from a stale soul. It is recommended to use this extension so that users are able to retrieve their tokens from a compromised or old wallet in certain situations.
+
+This extension provides methods to recover tokens from a stale owner. It is recommended to use this extension so that users are able to retrieve their tokens from a compromised or old wallet in certain situations.
 
 ```solidity
 pragma solidity ^0.8.0;
@@ -447,15 +460,17 @@ import "./IERC5727.sol";
  */
 interface IERC5727Recovery is IERC5727 {
     /**
-     * @notice Recover the tokens of `soul` with `signature`.
+     * @notice Recover the tokens of `owner` with `signature`.
      * @dev MUST revert if the signature is invalid.
-     * @param soul The soul whose tokens are recovered
-     * @param signature The signature signed by the `soul`
+     * @param owner The owner whose tokens are recovered
+     * @param signature The signature signed by the `owner`
      */
-    function recover(address soul, bytes memory signature) external;
+    function recover(address owner, bytes memory signature) external;
 }
 ```
+
 #### Expirable
+
 This extension provides methods to manage the expiration of tokens. It is useful if you want to expire/invalidate tokens after a certain period of time.
 
 ```solidity
@@ -510,6 +525,7 @@ interface IERC5727Expirable is IERC5727 {
 ```
 
 #### Shadow
+
 This extension provides methods to manage the visibility of tokens. It is useful if you want to hide tokens that you don't want to show to the public.
 
 ```solidity
@@ -540,6 +556,7 @@ interface IERC5727Shadow is IERC5727 {
 ```
 
 #### SlotEnumerable
+
 This extension provides methods to enumerate slots. A slot is used to group tokens that share similar utility and properties.
 
 ```solidity
@@ -587,11 +604,64 @@ interface IERC5727SlotEnumerable is IERC5727, IERC5727Enumerable {
         external
         view
         returns (uint256);
+    
+    /**
+     * @notice Get the number of owners in a slot.
+     * @dev MUST revert if the slot does not exist.
+     * @param slot The slot whose number of owners is queried for
+     * @return The number of owners in the `slot`
+     */
+    function ownersInSlot(uint256 slot) external view returns (uint256);
+
+    /**
+     * @notice Check if a owner is in a slot.
+     * @dev MUST revert if the slot does not exist.
+     * @param owner The owner whose existence in the slot is queried for
+     * @param slot The slot whose existence of the owner is queried for
+     * @return True if the `owner` is in the `slot`, false otherwise
+     */
+    function isOwnerInSlot(
+        address owner,
+        uint256 slot
+    ) external view returns (bool);
+
+    /**
+     * @notice Get the owner with `index` of the `slot`.
+     * @dev MUST revert if the `index` exceed the number of owners in the `slot`.
+     * @param slot The slot whose owner is queried for.
+     * @param index The index of the owner queried for
+     * @return The owner is queried for
+     */
+    function ownerInSlotByIndex(
+        uint256 slot,
+        uint256 index
+    ) external view returns (address);
+
+    /**
+     * @notice Get the number of slots of a owner.
+     * @param owner The owner whose number of slots is queried for
+     * @return The number of slots of the `owner`
+     */
+    function slotCountOfOwner(address owner) external view returns (uint256);
+
+    /**
+     * @notice Get the slot with `index` of the `owner`.
+     * @dev MUST revert if the `index` exceed the number of slots of the `owner`.
+     * @param owner The owner whose slot is queried for.
+     * @param index The index of the slot queried for
+     * @return The slot is queried for
+     */
+    function slotOfOwnerByIndex(
+        address owner,
+        uint256 index
+    ) external view returns (uint256);
 }
 ```
 
 ## Rationale
+
 ### Token storage model
+
 We adopt semi-fungible token storage models designed to support both fungible and non-fungible tokens, inspired by the semi-fungible token standard. We found that such a model is better suited to the representation of SBT than the model used in [EIP-1155](./eip-1155.md).
 
 Firstly, each slot can be used to represent different categories of SBTs. For instance, a DAO can have membership SBTs, role badges, scores, etc. in one SBT collection.
@@ -599,28 +669,35 @@ Firstly, each slot can be used to represent different categories of SBTs. For in
 Secondly, unlike [EIP-1155](./eip-1155.md), in which each unit of fungible tokens is exactly the same, our interface can help differentiate between similar tokens. This is justified by that credential scores obtained from different entities differ not only in value but also in their effects, validity periods, origins, etc. However, they still share the same slot as they all contribute to a person's credibility, membership, etc.
 
 ### Recovery mechanism
-To prevent the loss of SBTs, we propose a recovery mechanism that allows users to recover their tokens by providing a signature signed by their soul address. This mechanism is inspired by [EIP-1271](./eip-1271.md).
+
+To prevent the loss of SBTs, we propose a recovery mechanism that allows users to recover their tokens by providing a signature signed by their owner address. This mechanism is inspired by [EIP-1271](./eip-1271.md).
 
 Since SBTs are bound to an address and are meant to represent the identity of the address, which cannot be split into fractions. Therefore, each recovery should be considered as a transfer of all the tokens of the owner. This is why we use the `recover` function instead of `transferFrom` or `safeTransferFrom`.
 
 ### Token visibility control
+
 Our interface allows users to control the visibility of their tokens (shadowing and revealing). This is useful when a user wants to hide some of their tokens from the public, for example, when they want to keep their membership secret. Generally, the issuer and the owner of the token have access to the token by default and can control the visibility of the token. After the token is shadowed, information about the token (e.g. token URI, owner of the token) cannot be queried by the public.
 
 ## Backwards Compatibility
+
 This EIP proposes a new token interface which is meant to be used standalone, and is not backwards compatible with [EIP-721](./eip-721.md), [EIP-1155](./eip-1155.md), [EIP-3525](./eip-3525.md) or any other token standards. However, the naming style of functions and arguments follows the convention of [EIP-721](./eip-721.md) and [EIP-3525](./eip-3525.md), so that developers can understand the intentions easily.
 
 This EIP is compatible with [EIP-165](./eip-165.md).
 
 ## Test Cases
+
 Our sample implementation includes test cases written using Hardhat.
 
 ## Reference Implementation
+
 You can find our sample implementation [here](../assets/eip-5727/contracts/ERC5727Example.sol).
 
 ## Security Considerations
+
 This EIP does not involve the general transfer of tokens, and thus there will be no security issues related to token transfer generally.
 
 However, users should be aware of the security risks of using the recovery mechanism. If a user loses his/her private key, all his/her soulbound tokens will be exposed to potential theft. The attacker can create a signature and restore all SBTs of the victim. Therefore, users should always keep their private keys safe. We recommend developers implement a recovery mechanism that requires multiple signatures to restore SBTs.
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-5727/contracts/ERC5727.sol b/assets/eip-5727/contracts/ERC5727.sol
index d3331759213584..ac3668a2097d34 100644
--- a/assets/eip-5727/contracts/ERC5727.sol
+++ b/assets/eip-5727/contracts/ERC5727.sol
@@ -24,7 +24,7 @@ abstract contract ERC5727 is
 
     struct Token {
         address issuer;
-        address soul;
+        address owner;
         bool valid;
         uint256 value;
         uint256 slot;
@@ -60,37 +60,37 @@ abstract contract ERC5727 is
         returns (Token storage)
     {
         Token storage token = _tokens[tokenId];
-        require(token.soul != address(0), "ERC5727: Token does not exist");
+        require(token.owner != address(0), "ERC5727: Token does not exist");
         return token;
     }
 
     function _mintUnsafe(
-        address soul,
+        address owner,
         uint256 tokenId,
         uint256 value,
         uint256 slot,
         bool valid
     ) internal {
-        _mintUnsafe(_msgSender(), soul, tokenId, value, slot, valid);
+        _mintUnsafe(_msgSender(), owner, tokenId, value, slot, valid);
     }
 
     function _mintUnsafe(
         address issuer,
-        address soul,
+        address owner,
         uint256 tokenId,
         uint256 value,
         uint256 slot,
         bool valid
     ) internal {
         require(
-            _tokens[tokenId].soul == address(0),
+            _tokens[tokenId].owner == address(0),
             "ERC5727: Cannot mint an assigned token"
         );
         require(value != 0, "ERC5727: Cannot mint zero value");
-        _beforeTokenMint(issuer, soul, tokenId, value, slot, valid);
-        _tokens[tokenId] = Token(issuer, soul, valid, value, slot);
-        _afterTokenMint(issuer, soul, tokenId, value, slot, valid);
-        emit Minted(soul, tokenId, value);
+        _beforeTokenMint(issuer, owner, tokenId, value, slot, valid);
+        _tokens[tokenId] = Token(issuer, owner, valid, value, slot);
+        _afterTokenMint(issuer, owner, tokenId, value, slot, valid);
+        emit Minted(owner, tokenId, value);
         emit SlotChanged(tokenId, 0, slot);
     }
 
@@ -142,7 +142,7 @@ abstract contract ERC5727 is
         _beforeTokenRevoke(tokenId);
         _tokens[tokenId].valid = false;
         _afterTokenRevoke(tokenId);
-        emit Revoked(_tokens[tokenId].soul, tokenId);
+        emit Revoked(_tokens[tokenId].owner, tokenId);
     }
 
     function _revokeBatch(uint256[] memory tokenIds) internal virtual {
@@ -152,7 +152,7 @@ abstract contract ERC5727 is
     }
 
     function _destroy(uint256 tokenId) internal virtual {
-        address soul = soulOf(tokenId);
+        address owner = ownerOf(tokenId);
         uint256 slot = slotOf(tokenId);
         uint256 value = valueOf(tokenId);
 
@@ -161,7 +161,7 @@ abstract contract ERC5727 is
         _afterTokenDestroy(tokenId);
 
         emit Consumed(tokenId, value);
-        emit Destroyed(soul, tokenId);
+        emit Destroyed(owner, tokenId);
         emit SlotChanged(tokenId, slot, 0);
     }
 
@@ -173,7 +173,7 @@ abstract contract ERC5727 is
 
     function _beforeTokenMint(
         address issuer,
-        address soul,
+        address owner,
         uint256 tokenId,
         uint256 value,
         uint256 slot,
@@ -182,7 +182,7 @@ abstract contract ERC5727 is
 
     function _afterTokenMint(
         address issuer,
-        address soul,
+        address owner,
         uint256 tokenId,
         uint256 value,
         uint256 slot,
@@ -197,7 +197,7 @@ abstract contract ERC5727 is
 
     function _afterTokenDestroy(uint256 tokenId) internal virtual {}
 
-    function soulOf(uint256 tokenId)
+    function ownerOf(uint256 tokenId)
         public
         view
         virtual
@@ -205,7 +205,7 @@ abstract contract ERC5727 is
         returns (address)
     {
         _beforeView(tokenId);
-        return _getTokenOrRevert(tokenId).soul;
+        return _getTokenOrRevert(tokenId).owner;
     }
 
     function valueOf(uint256 tokenId)
diff --git a/assets/eip-5727/contracts/ERC5727Delegate.sol b/assets/eip-5727/contracts/ERC5727Delegate.sol
index 36cbe90e5e3816..ff19ad40d2bbed 100644
--- a/assets/eip-5727/contracts/ERC5727Delegate.sol
+++ b/assets/eip-5727/contracts/ERC5727Delegate.sol
@@ -10,7 +10,7 @@ import "./ERC5727Enumerable.sol";
 
 abstract contract ERC5727Delegate is ERC5727Enumerable, IERC5727Delegate {
     struct DelegateRequest {
-        address soul;
+        address owner;
         uint256 value;
         uint256 slot;
     }
@@ -86,7 +86,7 @@ abstract contract ERC5727Delegate is ERC5727Enumerable, IERC5727Delegate {
             _mintAllowed[_msgSender()][delegateRequestId] = false;
         }
         _mint(
-            _delegateRequests[delegateRequestId].soul,
+            _delegateRequests[delegateRequestId].owner,
             _delegateRequests[delegateRequestId].value,
             _delegateRequests[delegateRequestId].slot
         );
@@ -192,7 +192,7 @@ abstract contract ERC5727Delegate is ERC5727Enumerable, IERC5727Delegate {
     }
 
     function createDelegateRequest(
-        address soul,
+        address owner,
         uint256 value,
         uint256 slot
     ) external virtual override returns (uint256 delegateRequestId) {
@@ -202,7 +202,7 @@ abstract contract ERC5727Delegate is ERC5727Enumerable, IERC5727Delegate {
             "ERC5727Delegate: Value of Delegate Request cannot be zero"
         );
         delegateRequestId = _delegateRequestCount;
-        _delegateRequests[_delegateRequestCount].soul = soul;
+        _delegateRequests[_delegateRequestCount].owner = owner;
         _delegateRequests[_delegateRequestCount].value = value;
         _delegateRequests[_delegateRequestCount].slot = slot;
         _delegateRequestCount++;
@@ -235,7 +235,7 @@ abstract contract ERC5727Delegate is ERC5727Enumerable, IERC5727Delegate {
         return _delegatedTokens[operator].values();
     }
 
-    function soulOfDelegateRequest(uint256 delegateRequestId)
+    function ownerOfDelegateRequest(uint256 delegateRequestId)
         public
         view
         virtual
@@ -245,7 +245,7 @@ abstract contract ERC5727Delegate is ERC5727Enumerable, IERC5727Delegate {
             delegateRequestId < _delegateRequestCount,
             "ERC5727Delegate: Delegate request does not exist"
         );
-        return _delegateRequests[delegateRequestId].soul;
+        return _delegateRequests[delegateRequestId].owner;
     }
 
     function valueOfDelegateRequest(uint256 delegateRequestId)
diff --git a/assets/eip-5727/contracts/ERC5727Enumerable.sol b/assets/eip-5727/contracts/ERC5727Enumerable.sol
index 9d76812451b159..33453497db6cfa 100644
--- a/assets/eip-5727/contracts/ERC5727Enumerable.sol
+++ b/assets/eip-5727/contracts/ERC5727Enumerable.sol
@@ -15,7 +15,7 @@ abstract contract ERC5727Enumerable is ERC5727, IERC5727Enumerable {
     mapping(address => uint256) private _numberOfValidTokens;
 
     Counters.Counter private _emittedCount;
-    Counters.Counter private _soulsCount;
+    Counters.Counter private _ownersCount;
 
     function supportsInterface(bytes4 interfaceId)
         public
@@ -31,14 +31,14 @@ abstract contract ERC5727Enumerable is ERC5727, IERC5727Enumerable {
 
     function _beforeTokenMint(
         address issuer,
-        address soul,
+        address owner,
         uint256 tokenId,
         uint256 value,
         uint256 slot,
         bool valid
     ) internal virtual override {
-        if (_indexedTokenIds[soul].length() == 0) {
-            _soulsCount.increment();
+        if (_indexedTokenIds[owner].length() == 0) {
+            _ownersCount.increment();
         }
         //unused variables
         issuer;
@@ -50,15 +50,15 @@ abstract contract ERC5727Enumerable is ERC5727, IERC5727Enumerable {
 
     function _afterTokenMint(
         address issuer,
-        address soul,
+        address owner,
         uint256 tokenId,
         uint256 value,
         uint256 slot,
         bool valid
     ) internal virtual override {
-        _indexedTokenIds[soul].add(tokenId);
+        _indexedTokenIds[owner].add(tokenId);
         if (valid) {
-            _numberOfValidTokens[soul] += 1;
+            _numberOfValidTokens[owner] += 1;
         }
         //unused variables
         issuer;
@@ -68,55 +68,55 @@ abstract contract ERC5727Enumerable is ERC5727, IERC5727Enumerable {
     }
 
     function _mint(
-        address soul,
+        address owner,
         uint256 value,
         uint256 slot
     ) internal virtual returns (uint256 tokenId) {
         tokenId = _emittedCount.current();
-        _mintUnsafe(soul, tokenId, value, slot, true);
-        emit Minted(soul, tokenId, value);
+        _mintUnsafe(owner, tokenId, value, slot, true);
+        emit Minted(owner, tokenId, value);
         _emittedCount.increment();
     }
 
     function _mint(
         address issuer,
-        address soul,
+        address owner,
         uint256 value,
         uint256 slot
     ) internal virtual returns (uint256 tokenId) {
         tokenId = _emittedCount.current();
-        _mintUnsafe(issuer, soul, tokenId, value, slot, true);
-        emit Minted(soul, tokenId, value);
+        _mintUnsafe(issuer, owner, tokenId, value, slot, true);
+        emit Minted(owner, tokenId, value);
         _emittedCount.increment();
     }
 
     function _mintBatch(
-        address[] memory souls,
+        address[] memory owners,
         uint256 value,
         uint256 slot
     ) internal virtual returns (uint256[] memory tokenIds) {
-        tokenIds = new uint256[](souls.length);
-        for (uint256 i = 0; i < souls.length; i++) {
-            tokenIds[i] = _mint(souls[i], value, slot);
+        tokenIds = new uint256[](owners.length);
+        for (uint256 i = 0; i < owners.length; i++) {
+            tokenIds[i] = _mint(owners[i], value, slot);
         }
     }
 
     function _afterTokenRevoke(uint256 tokenId) internal virtual override {
-        assert(_numberOfValidTokens[_getTokenOrRevert(tokenId).soul] > 0);
-        _numberOfValidTokens[_getTokenOrRevert(tokenId).soul] -= 1;
+        assert(_numberOfValidTokens[_getTokenOrRevert(tokenId).owner] > 0);
+        _numberOfValidTokens[_getTokenOrRevert(tokenId).owner] -= 1;
     }
 
     function _beforeTokenDestroy(uint256 tokenId) internal virtual override {
-        address soul = soulOf(tokenId);
+        address owner = ownerOf(tokenId);
 
         if (_getTokenOrRevert(tokenId).valid) {
-            assert(_numberOfValidTokens[soul] > 0);
-            _numberOfValidTokens[soul] -= 1;
+            assert(_numberOfValidTokens[owner] > 0);
+            _numberOfValidTokens[owner] -= 1;
         }
-        EnumerableSet.remove(_indexedTokenIds[soul], tokenId);
-        if (EnumerableSet.length(_indexedTokenIds[soul]) == 0) {
-            assert(_soulsCount.current() > 0);
-            _soulsCount.decrement();
+        EnumerableSet.remove(_indexedTokenIds[owner], tokenId);
+        if (EnumerableSet.length(_indexedTokenIds[owner]) == 0) {
+            assert(_ownersCount.current() > 0);
+            _ownersCount.decrement();
         }
     }
 
@@ -124,51 +124,51 @@ abstract contract ERC5727Enumerable is ERC5727, IERC5727Enumerable {
         _emittedCount.increment();
     }
 
-    function _tokensOfSoul(address soul)
+    function _tokensOfOwner(address owner)
         internal
         view
         returns (uint256[] memory tokenIds)
     {
-        tokenIds = _indexedTokenIds[soul].values();
-        require(tokenIds.length != 0, "ERC5727: the soul has no token");
+        tokenIds = _indexedTokenIds[owner].values();
+        require(tokenIds.length != 0, "ERC5727: the owner has no token");
     }
 
-    function emittedCount() public view virtual override returns (uint256) {
+    function totalSupply() public view virtual override returns (uint256) {
         return _emittedCount.current();
     }
 
-    function soulsCount() public view virtual override returns (uint256) {
-        return _soulsCount.current();
+    function ownersCount() public view virtual override returns (uint256) {
+        return _ownersCount.current();
     }
 
-    function balanceOf(address soul)
+    function balanceOf(address owner)
         public
         view
         virtual
         override
         returns (uint256)
     {
-        return _indexedTokenIds[soul].length();
+        return _indexedTokenIds[owner].length();
     }
 
-    function hasValid(address soul)
+    function hasValid(address owner)
         public
         view
         virtual
         override
         returns (bool)
     {
-        return _numberOfValidTokens[soul] > 0;
+        return _numberOfValidTokens[owner] > 0;
     }
 
-    function tokenOfSoulByIndex(address soul, uint256 index)
+    function tokenOfOwnerByIndex(address owner, uint256 index)
         public
         view
         virtual
         override
         returns (uint256)
     {
-        EnumerableSet.UintSet storage ids = _indexedTokenIds[soul];
+        EnumerableSet.UintSet storage ids = _indexedTokenIds[owner];
         require(
             index < EnumerableSet.length(ids),
             "ERC5727: Token does not exist"
diff --git a/assets/eip-5727/contracts/ERC5727Example.sol b/assets/eip-5727/contracts/ERC5727Example.sol
index f357b05cd1fbf7..35ae865fc9a8f9 100644
--- a/assets/eip-5727/contracts/ERC5727Example.sol
+++ b/assets/eip-5727/contracts/ERC5727Example.sol
@@ -59,13 +59,13 @@ contract ERC5727Example is
     }
 
     function mint(
-        address soul,
+        address owner,
         uint256 value,
         uint256 slot,
         uint256 expiryDate,
         bool shadowed
     ) public virtual onlyOwner {
-        uint256 tokenId = _mint(soul, value, slot);
+        uint256 tokenId = _mint(owner, value, slot);
         if (shadowed) {
             _shadow(tokenId);
         }
@@ -77,13 +77,13 @@ contract ERC5727Example is
     }
 
     function mintBatch(
-        address[] memory souls,
+        address[] memory owners,
         uint256 value,
         uint256 slot,
         uint256 expiryDate,
         bool shadowed
     ) public virtual onlyOwner {
-        uint256[] memory tokenIds = _mintBatch(souls, value, slot);
+        uint256[] memory tokenIds = _mintBatch(owners, value, slot);
         for (uint256 i = 0; i < tokenIds.length; i++) {
             if (shadowed) _shadow(tokenIds[i]);
             _setExpiryDate(tokenIds[i], expiryDate);
@@ -96,7 +96,7 @@ contract ERC5727Example is
 
     function _beforeTokenMint(
         address issuer,
-        address soul,
+        address owner,
         uint256 tokenId,
         uint256 value,
         uint256 slot,
@@ -108,7 +108,7 @@ contract ERC5727Example is
     {
         ERC5727Enumerable._beforeTokenMint(
             issuer,
-            soul,
+            owner,
             tokenId,
             value,
             slot,
@@ -116,7 +116,7 @@ contract ERC5727Example is
         );
         ERC5727SlotEnumerable._beforeTokenMint(
             issuer,
-            soul,
+            owner,
             tokenId,
             value,
             slot,
@@ -126,7 +126,7 @@ contract ERC5727Example is
 
     function _afterTokenMint(
         address issuer,
-        address soul,
+        address owner,
         uint256 tokenId,
         uint256 value,
         uint256 slot,
@@ -134,7 +134,7 @@ contract ERC5727Example is
     ) internal virtual override(ERC5727, ERC5727Enumerable) {
         ERC5727Enumerable._afterTokenMint(
             issuer,
-            soul,
+            owner,
             tokenId,
             value,
             slot,
@@ -158,4 +158,16 @@ contract ERC5727Example is
         ERC5727Enumerable._beforeTokenDestroy(tokenId);
         ERC5727SlotEnumerable._beforeTokenDestroy(tokenId);
     }
+
+    function slotURI(
+        uint256 slot
+    )
+        public
+        view
+        virtual
+        override(ERC5727, ERC5727SlotEnumerable)
+        returns (string memory)
+    {
+        return ERC5727SlotEnumerable.slotURI(slot);
+    }
 }
diff --git a/assets/eip-5727/contracts/ERC5727Governance.sol b/assets/eip-5727/contracts/ERC5727Governance.sol
index 3c10bbe1ce9726..972f6a4c1dfa69 100644
--- a/assets/eip-5727/contracts/ERC5727Governance.sol
+++ b/assets/eip-5727/contracts/ERC5727Governance.sol
@@ -50,26 +50,26 @@ abstract contract ERC5727Governance is ERC5727Enumerable, IERC5727Governance {
         return _votersArray.values();
     }
 
-    function approveMint(address soul, uint256 approvalRequestId)
+    function approveMint(address owner, uint256 approvalRequestId)
         public
         virtual
         override
         onlyRole(VOTER_ROLE)
     {
         require(
-            !_mintApprovals[_msgSender()][approvalRequestId][soul],
+            !_mintApprovals[_msgSender()][approvalRequestId][owner],
             "ERC5727Governance: You already approved this address"
         );
-        _mintApprovals[_msgSender()][approvalRequestId][soul] = true;
-        _mintApprovalCounts[approvalRequestId][soul] += 1;
+        _mintApprovals[_msgSender()][approvalRequestId][owner] = true;
+        _mintApprovalCounts[approvalRequestId][owner] += 1;
         if (
-            _mintApprovalCounts[approvalRequestId][soul] ==
+            _mintApprovalCounts[approvalRequestId][owner] ==
             _votersArray.length()
         ) {
-            _resetMintApprovals(approvalRequestId, soul);
+            _resetMintApprovals(approvalRequestId, owner);
             _mint(
                 _approvalRequests[approvalRequestId].creator,
-                soul,
+                owner,
                 _approvalRequests[approvalRequestId].value,
                 _approvalRequests[approvalRequestId].slot
             );
@@ -106,13 +106,13 @@ abstract contract ERC5727Governance is ERC5727Enumerable, IERC5727Governance {
             super.supportsInterface(interfaceId);
     }
 
-    function _resetMintApprovals(uint256 approvalRequestId, address soul)
+    function _resetMintApprovals(uint256 approvalRequestId, address owner)
         private
     {
         for (uint256 i = 0; i < _votersArray.length(); i++) {
-            _mintApprovals[_votersArray.at(i)][approvalRequestId][soul] = false;
+            _mintApprovals[_votersArray.at(i)][approvalRequestId][owner] = false;
         }
-        _mintApprovalCounts[approvalRequestId][soul] = 0;
+        _mintApprovalCounts[approvalRequestId][owner] = 0;
     }
 
     function _resetRevokeApprovals(uint256 tokenId) private {
diff --git a/assets/eip-5727/contracts/ERC5727Recovery.sol b/assets/eip-5727/contracts/ERC5727Recovery.sol
index bf679ce63f36cd..88ff487c2990ef 100644
--- a/assets/eip-5727/contracts/ERC5727Recovery.sol
+++ b/assets/eip-5727/contracts/ERC5727Recovery.sol
@@ -10,16 +10,16 @@ import "./ERC5727Enumerable.sol";
 abstract contract ERC5727Recovery is ERC5727Enumerable, IERC5727Recovery {
     using ECDSA for bytes32;
 
-    function recover(address soul, bytes memory signature)
+    function recover(address owner, bytes memory signature)
         public
         virtual
         override
     {
         address recipient = _msgSender();
-        bytes32 messageHash = keccak256(abi.encodePacked(soul, recipient));
+        bytes32 messageHash = keccak256(abi.encodePacked(owner, recipient));
         bytes32 signedHash = messageHash.toEthSignedMessageHash();
-        require(signedHash.recover(signature) == soul, "Invalid signature");
-        uint256[] memory tokenIds = _tokensOfSoul(soul);
+        require(signedHash.recover(signature) == owner, "Invalid signature");
+        uint256[] memory tokenIds = _tokensOfOwner(owner);
         for (uint256 i = 0; i < tokenIds.length; i++) {
             Token storage token = _getTokenOrRevert(tokenIds[i]);
             address issuer = token.issuer;
diff --git a/assets/eip-5727/contracts/ERC5727Shadow.sol b/assets/eip-5727/contracts/ERC5727Shadow.sol
index 176d9bd485063a..d5ef9c138ad09a 100644
--- a/assets/eip-5727/contracts/ERC5727Shadow.sol
+++ b/assets/eip-5727/contracts/ERC5727Shadow.sol
@@ -9,7 +9,7 @@ abstract contract ERC5727Shadow is ERC5727, IERC5727Shadow {
 
     modifier onlyManager(uint256 tokenId) {
         require(
-            _msgSender() == _getTokenOrRevert(tokenId).soul ||
+            _msgSender() == _getTokenOrRevert(tokenId).owner ||
                 _msgSender() == _getTokenOrRevert(tokenId).issuer,
             "ERC5727Shadow: You are not the manager"
         );
@@ -19,7 +19,7 @@ abstract contract ERC5727Shadow is ERC5727, IERC5727Shadow {
     function _beforeView(uint256 tokenId) internal view virtual override {
         require(
             !_shadowed[tokenId] ||
-                _msgSender() == _getTokenOrRevert(tokenId).soul ||
+                _msgSender() == _getTokenOrRevert(tokenId).owner ||
                 _msgSender() == _getTokenOrRevert(tokenId).issuer,
             "ERC5727Shadow: the token is shadowed"
         );
diff --git a/assets/eip-5727/contracts/ERC5727SlotEnumerable.sol b/assets/eip-5727/contracts/ERC5727SlotEnumerable.sol
index 6dc36723cc60db..b9f6b982a9c6d7 100644
--- a/assets/eip-5727/contracts/ERC5727SlotEnumerable.sol
+++ b/assets/eip-5727/contracts/ERC5727SlotEnumerable.sol
@@ -1,4 +1,4 @@
-//SPDX-License-Identifier: CC0-1.0
+//SPDX-License-Identifier: MIT
 pragma solidity ^0.8.0;
 
 import "@openzeppelin/contracts/utils/structs/EnumerableSet.sol";
@@ -8,9 +8,14 @@ import "./interfaces/IERC5727SlotEnumerable.sol";
 
 abstract contract ERC5727SlotEnumerable is ERC5727, IERC5727SlotEnumerable {
     using EnumerableSet for EnumerableSet.UintSet;
+    using EnumerableSet for EnumerableSet.AddressSet;
 
     mapping(uint256 => EnumerableSet.UintSet) private _tokensInSlot;
 
+    mapping(uint256 => EnumerableSet.AddressSet) private _ownersInSlot;
+
+    mapping(address => EnumerableSet.UintSet) private _slotsOfOwner;
+
     EnumerableSet.UintSet private _allSlots;
 
     function slotCount() public view override returns (uint256) {
@@ -29,24 +34,19 @@ abstract contract ERC5727SlotEnumerable is ERC5727, IERC5727SlotEnumerable {
         return _allSlots.length() != 0 && _allSlots.contains(slot);
     }
 
-    function tokenSupplyInSlot(uint256 slot)
-        public
-        view
-        override
-        returns (uint256)
-    {
+    function tokenSupplyInSlot(
+        uint256 slot
+    ) public view override returns (uint256) {
         if (!_slotExists(slot)) {
             return 0;
         }
         return _tokensInSlot[slot].length();
     }
 
-    function tokenInSlotByIndex(uint256 slot, uint256 index)
-        public
-        view
-        override
-        returns (uint256)
-    {
+    function tokenInSlotByIndex(
+        uint256 slot,
+        uint256 index
+    ) public view override returns (uint256) {
         require(
             index < ERC5727SlotEnumerable.tokenSupplyInSlot(slot),
             "ERC5727SlotEnumerable: slot token index out of bounds"
@@ -54,13 +54,51 @@ abstract contract ERC5727SlotEnumerable is ERC5727, IERC5727SlotEnumerable {
         return _tokensInSlot[slot].at(index);
     }
 
-    function supportsInterface(bytes4 interfaceId)
-        public
-        view
-        virtual
-        override(IERC165, ERC5727)
-        returns (bool)
-    {
+    function ownersInSlot(uint256 slot) public view override returns (uint256) {
+        if (!_slotExists(slot)) {
+            return 0;
+        }
+        return _ownersInSlot[slot].length();
+    }
+
+    function ownerInSlotByIndex(
+        uint256 slot,
+        uint256 index
+    ) public view override returns (address) {
+        require(
+            index < ERC5727SlotEnumerable.ownersInSlot(slot),
+            "ERC5727SlotEnumerable: slot owner index out of bounds"
+        );
+        return _ownersInSlot[slot].at(index);
+    }
+
+    function slotCountOfOwner(
+        address owner
+    ) public view override returns (uint256) {
+        return _slotsOfOwner[owner].length();
+    }
+
+    function slotOfOwnerByIndex(
+        address owner,
+        uint256 index
+    ) public view override returns (uint256) {
+        require(
+            index < ERC5727SlotEnumerable.slotCountOfOwner(owner),
+            "ERC5727SlotEnumerable: owner slot index out of bounds"
+        );
+        return _slotsOfOwner[owner].at(index);
+    }
+
+    function isOwnerInSlot(
+        address owner,
+        uint256 slot
+    ) public view virtual override returns (bool) {
+        return _ownersInSlot[slot].contains(owner);
+    }
+
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual override(IERC165, ERC5727) returns (bool) {
         return
             interfaceId == type(IERC5727SlotEnumerable).interfaceId ||
             super.supportsInterface(interfaceId);
@@ -68,7 +106,7 @@ abstract contract ERC5727SlotEnumerable is ERC5727, IERC5727SlotEnumerable {
 
     function _beforeTokenMint(
         address issuer,
-        address soul,
+        address owner,
         uint256 tokenId,
         uint256 value,
         uint256 slot,
@@ -78,11 +116,16 @@ abstract contract ERC5727SlotEnumerable is ERC5727, IERC5727SlotEnumerable {
             _allSlots.add(slot);
         }
         _tokensInSlot[slot].add(tokenId);
-        //unused
-        issuer;
-        soul;
-        value;
-        valid;
+        if (!_ownersInSlot[slot].contains(owner)) {
+            _ownersInSlot[slot].add(owner);
+        }
+        _slotsOfOwner[owner].add(slot);
+    }
+
+    function _addSlot(uint256 slot) internal virtual {
+        if (!_slotExists(slot)) {
+            _allSlots.add(slot);
+        }
     }
 
     function _beforeTokenDestroy(uint256 tokenId) internal virtual override {
@@ -92,4 +135,14 @@ abstract contract ERC5727SlotEnumerable is ERC5727, IERC5727SlotEnumerable {
             _allSlots.remove(slot);
         }
     }
+
+    function slotURI(
+        uint256 slot
+    ) public view virtual override returns (string memory) {
+        require(
+            _slotExists(slot),
+            "ERC5727SlotEnumerable: slot does not exist"
+        );
+        return super.slotURI(slot);
+    }
 }
diff --git a/assets/eip-5727/contracts/interfaces/IERC5727.sol b/assets/eip-5727/contracts/interfaces/IERC5727.sol
index dddfcce32c53e9..0e013ed2be3999 100644
--- a/assets/eip-5727/contracts/interfaces/IERC5727.sol
+++ b/assets/eip-5727/contracts/interfaces/IERC5727.sol
@@ -10,18 +10,18 @@ import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
 interface IERC5727 is IERC165 {
     /**
      * @dev MUST emit when a token is minted.
-     * @param soul The address that the token is minted to
+     * @param owner The address that the token is minted to
      * @param tokenId The token minted
      * @param value The value of the token minted
      */
-    event Minted(address indexed soul, uint256 indexed tokenId, uint256 value);
+    event Minted(address indexed owner, uint256 indexed tokenId, uint256 value);
 
     /**
      * @dev MUST emit when a token is revoked.
-     * @param soul The owner soul of the revoked token
+     * @param owner The owner of the revoked token
      * @param tokenId The revoked token
      */
-    event Revoked(address indexed soul, uint256 indexed tokenId);
+    event Revoked(address indexed owner, uint256 indexed tokenId);
 
     /**
      * @dev MUST emit when a token is charged.
@@ -39,10 +39,10 @@ interface IERC5727 is IERC165 {
 
     /**
      * @dev MUST emit when a token is destroyed.
-     * @param soul The owner soul of the destroyed token
+     * @param owner The owner of the destroyed token
      * @param tokenId The token to destroy.
      */
-    event Destroyed(address indexed soul, uint256 indexed tokenId);
+    event Destroyed(address indexed owner, uint256 indexed tokenId);
 
     /**
      * @dev MUST emit when the slot of a token is set or changed.
@@ -73,12 +73,12 @@ interface IERC5727 is IERC165 {
     function slotOf(uint256 tokenId) external view returns (uint256);
 
     /**
-     * @notice Get the owner soul of a token.
+     * @notice Get the owner of a token.
      * @dev MUST revert if the `tokenId` does not exist
-     * @param tokenId the token for which to query the owner soul
-     * @return The address of the owner soul of `tokenId`
+     * @param tokenId the token for which to query the owner
+     * @return The address of the owner of `tokenId`
      */
-    function soulOf(uint256 tokenId) external view returns (address);
+    function ownerOf(uint256 tokenId) external view returns (address);
 
     /**
      * @notice Get the validity of a token.
diff --git a/assets/eip-5727/contracts/interfaces/IERC5727Delegate.sol b/assets/eip-5727/contracts/interfaces/IERC5727Delegate.sol
index eeeeecdb9dc59f..397fc231477080 100644
--- a/assets/eip-5727/contracts/interfaces/IERC5727Delegate.sol
+++ b/assets/eip-5727/contracts/interfaces/IERC5727Delegate.sol
@@ -12,8 +12,8 @@ interface IERC5727Delegate is IERC5727 {
     /**
      * @notice Delegate a one-time minting right to `operator` for `delegateRequestId` delegate request.
      * @dev MUST revert if the caller does not have the right to delegate.
-     * @param operator The soul to which the minting right is delegated
-     * @param delegateRequestId The delegate request describing the soul, value and slot of the token to mint
+     * @param operator The owner to which the minting right is delegated
+     * @param delegateRequestId The delegate request describing the owner, value and slot of the token to mint
      */
     function mintDelegate(address operator, uint256 delegateRequestId) external;
 
@@ -21,8 +21,8 @@ interface IERC5727Delegate is IERC5727 {
      * @notice Delegate one-time minting rights to `operators` for corresponding delegate request in `delegateRequestIds`.
      * @dev MUST revert if the caller does not have the right to delegate.
      *   MUST revert if the length of `operators` and `delegateRequestIds` do not match.
-     * @param operators The souls to which the minting right is delegated
-     * @param delegateRequestIds The delegate requests describing the soul, value and slot of the tokens to mint
+     * @param operators The owners to which the minting right is delegated
+     * @param delegateRequestIds The delegate requests describing the owner, value and slot of the tokens to mint
      */
     function mintDelegateBatch(
         address[] memory operators,
@@ -32,7 +32,7 @@ interface IERC5727Delegate is IERC5727 {
     /**
      * @notice Delegate a one-time revoking right to `operator` for `tokenId` token.
      * @dev MUST revert if the caller does not have the right to delegate.
-     * @param operator The soul to which the revoking right is delegated
+     * @param operator The owner to which the revoking right is delegated
      * @param tokenId The token to revoke
      */
     function revokeDelegate(address operator, uint256 tokenId) external;
@@ -41,7 +41,7 @@ interface IERC5727Delegate is IERC5727 {
      * @notice Delegate one-time minting rights to `operators` for corresponding token in `tokenIds`.
      * @dev MUST revert if the caller does not have the right to delegate.
      *   MUST revert if the length of `operators` and `tokenIds` do not match.
-     * @param operators The souls to which the revoking right is delegated
+     * @param operators The owners to which the revoking right is delegated
      * @param tokenIds The tokens to revoke
      */
     function revokeDelegateBatch(
@@ -52,14 +52,14 @@ interface IERC5727Delegate is IERC5727 {
     /**
      * @notice Mint a token described by `delegateRequestId` delegate request as a delegate.
      * @dev MUST revert if the caller is not delegated.
-     * @param delegateRequestId The delegate requests describing the soul, value and slot of the token to mint.
+     * @param delegateRequestId The delegate requests describing the owner, value and slot of the token to mint.
      */
     function delegateMint(uint256 delegateRequestId) external;
 
     /**
      * @notice Mint tokens described by `delegateRequestIds` delegate request as a delegate.
      * @dev MUST revert if the caller is not delegated.
-     * @param delegateRequestIds The delegate requests describing the soul, value and slot of the tokens to mint.
+     * @param delegateRequestIds The delegate requests describing the owner, value and slot of the tokens to mint.
      */
     function delegateMintBatch(uint256[] memory delegateRequestIds) external;
 
@@ -78,14 +78,14 @@ interface IERC5727Delegate is IERC5727 {
     function delegateRevokeBatch(uint256[] memory tokenIds) external;
 
     /**
-     * @notice Create a delegate request describing the `soul`, `value` and `slot` of a token.
-     * @param soul The soul of the delegate request.
+     * @notice Create a delegate request describing the `owner`, `value` and `slot` of a token.
+     * @param owner The owner of the delegate request.
      * @param value The value of the delegate request.
      * @param slot The slot of the delegate request.
      * @return delegateRequestId The id of the delegate request
      */
     function createDelegateRequest(
-        address soul,
+        address owner,
         uint256 value,
         uint256 slot
     ) external returns (uint256 delegateRequestId);
diff --git a/assets/eip-5727/contracts/interfaces/IERC5727Enumerable.sol b/assets/eip-5727/contracts/interfaces/IERC5727Enumerable.sol
index a0a5f9e36006c4..b07ef309d346f2 100644
--- a/assets/eip-5727/contracts/interfaces/IERC5727Enumerable.sol
+++ b/assets/eip-5727/contracts/interfaces/IERC5727Enumerable.sol
@@ -5,29 +5,29 @@ import "./IERC5727.sol";
 
 /**
  * @title ERC5727 Soulbound Token Enumerable Interface
- * @dev This extension allows querying the tokens of a soul.
+ * @dev This extension allows querying the tokens of a owner.
  */
 interface IERC5727Enumerable is IERC5727 {
     /**
-     * @notice Get the total number of tokens emitted.
-     * @return The total number of tokens emitted
+     * @notice Get the total number of tokens tracked by this contract.
+     * @return The total number of tokens tracked by this contract
      */
-    function emittedCount() external view returns (uint256);
+    function totalSupply() external view returns (uint256);
 
     /**
-     * @notice Get the total number of souls.
-     * @return The total number of souls
+     * @notice Get the total number of owners.
+     * @return The total number of owners
      */
-    function soulsCount() external view returns (uint256);
+    function ownersCount() external view returns (uint256);
 
     /**
-     * @notice Get the tokenId with `index` of the `soul`.
-     * @dev MUST revert if the `index` exceed the number of tokens owned by the `soul`.
-     * @param soul The soul whose token is queried for.
+     * @notice Get the tokenId with `index` of the `owner`.
+     * @dev MUST revert if the `index` exceed the number of tokens owned by the `owner`.
+     * @param owner The owner whose token is queried for.
      * @param index The index of the token queried for
      * @return The token is queried for
      */
-    function tokenOfSoulByIndex(address soul, uint256 index)
+    function tokenOfOwnerByIndex(address owner, uint256 index)
         external
         view
         returns (uint256);
@@ -41,17 +41,17 @@ interface IERC5727Enumerable is IERC5727 {
     function tokenByIndex(uint256 index) external view returns (uint256);
 
     /**
-     * @notice Get the number of tokens owned by the `soul`.
-     * @dev MUST revert if the `soul` does not have any token.
-     * @param soul The soul whose balance is queried for
-     * @return The number of tokens of the `soul`
+     * @notice Get the number of tokens owned by the `owner`.
+     * @dev MUST revert if the `owner` does not have any token.
+     * @param owner The owner whose balance is queried for
+     * @return The number of tokens of the `owner`
      */
-    function balanceOf(address soul) external view returns (uint256);
+    function balanceOf(address owner) external view returns (uint256);
 
     /**
-     * @notice Get if the `soul` owns any valid tokens.
-     * @param soul The soul whose valid token infomation is queried for
-     * @return if the `soul` owns any valid tokens
+     * @notice Get if the `owner` owns any valid tokens.
+     * @param owner The owner whose valid token infomation is queried for
+     * @return if the `owner` owns any valid tokens
      */
-    function hasValid(address soul) external view returns (bool);
+    function hasValid(address owner) external view returns (bool);
 }
diff --git a/assets/eip-5727/contracts/interfaces/IERC5727Governance.sol b/assets/eip-5727/contracts/interfaces/IERC5727Governance.sol
index 72a173edd7ebc2..ffa6b82c7b4d19 100644
--- a/assets/eip-5727/contracts/interfaces/IERC5727Governance.sol
+++ b/assets/eip-5727/contracts/interfaces/IERC5727Governance.sol
@@ -15,12 +15,12 @@ interface IERC5727Governance is IERC5727 {
     function voters() external view returns (address[] memory);
 
     /**
-     * @notice Approve to mint the token described by the `approvalRequestId` to `soul`.
+     * @notice Approve to mint the token described by the `approvalRequestId` to `owner`.
      * @dev MUST revert if the caller is not a voter.
-     * @param soul The soul which the token to mint to
+     * @param owner The owner which the token to mint to
      * @param approvalRequestId The approval request describing the value and slot of the token to mint
      */
-    function approveMint(address soul, uint256 approvalRequestId) external;
+    function approveMint(address owner, uint256 approvalRequestId) external;
 
     /**
      * @notice Approve to revoke the `tokenId`.
diff --git a/assets/eip-5727/contracts/interfaces/IERC5727Recovery.sol b/assets/eip-5727/contracts/interfaces/IERC5727Recovery.sol
index ce715d07251732..7ed01170a523af 100644
--- a/assets/eip-5727/contracts/interfaces/IERC5727Recovery.sol
+++ b/assets/eip-5727/contracts/interfaces/IERC5727Recovery.sol
@@ -9,10 +9,10 @@ import "./IERC5727.sol";
  */
 interface IERC5727Recovery is IERC5727 {
     /**
-     * @notice Recover the tokens of `soul` with `signature`.
+     * @notice Recover the tokens of `owner` with `signature`.
      * @dev MUST revert if the signature is invalid.
-     * @param soul The soul whose tokens are recovered
-     * @param signature The signature signed by the `soul`
+     * @param owner The owner whose tokens are recovered
+     * @param signature The signature signed by the `owner`
      */
-    function recover(address soul, bytes memory signature) external;
+    function recover(address owner, bytes memory signature) external;
 }
diff --git a/assets/eip-5727/contracts/interfaces/IERC5727SlotEnumerable.sol b/assets/eip-5727/contracts/interfaces/IERC5727SlotEnumerable.sol
index fa224bcb8d1662..1fe889a6a991d8 100644
--- a/assets/eip-5727/contracts/interfaces/IERC5727SlotEnumerable.sol
+++ b/assets/eip-5727/contracts/interfaces/IERC5727SlotEnumerable.sol
@@ -42,4 +42,55 @@ interface IERC5727SlotEnumerable is IERC5727, IERC5727Enumerable {
         external
         view
         returns (uint256);
+    
+    /**
+     * @notice Get the number of owners in a slot.
+     * @dev MUST revert if the slot does not exist.
+     * @param slot The slot whose number of owners is queried for
+     * @return The number of owners in the `slot`
+     */
+    function ownersInSlot(uint256 slot) external view returns (uint256);
+
+    /**
+     * @notice Check if a owner is in a slot.
+     * @dev MUST revert if the slot does not exist.
+     * @param owner The owner whose existence in the slot is queried for
+     * @param slot The slot whose existence of the owner is queried for
+     * @return True if the `owner` is in the `slot`, false otherwise
+     */
+    function isOwnerInSlot(
+        address owner,
+        uint256 slot
+    ) external view returns (bool);
+
+    /**
+     * @notice Get the owner with `index` of the `slot`.
+     * @dev MUST revert if the `index` exceed the number of owners in the `slot`.
+     * @param slot The slot whose owner is queried for.
+     * @param index The index of the owner queried for
+     * @return The owner is queried for
+     */
+    function ownerInSlotByIndex(
+        uint256 slot,
+        uint256 index
+    ) external view returns (address);
+
+    /**
+     * @notice Get the number of slots of a owner.
+     * @param owner The owner whose number of slots is queried for
+     * @return The number of slots of the `owner`
+     */
+    function slotCountOfOwner(address owner) external view returns (uint256);
+
+    /**
+     * @notice Get the slot with `index` of the `owner`.
+     * @dev MUST revert if the `index` exceed the number of slots of the `owner`.
+     * @param owner The owner whose slot is queried for.
+     * @param index The index of the slot queried for
+     * @return The slot is queried for
+     */
+    function slotOfOwnerByIndex(
+        address owner,
+        uint256 index
+    ) external view returns (uint256);
 }
diff --git a/assets/eip-5727/pnpm-lock.yaml b/assets/eip-5727/pnpm-lock.yaml
new file mode 100644
index 00000000000000..b01e41c47c3ace
--- /dev/null
+++ b/assets/eip-5727/pnpm-lock.yaml
@@ -0,0 +1,4782 @@
+lockfileVersion: 5.4
+
+specifiers:
+  '@nomicfoundation/hardhat-toolbox': 2.0.0
+  '@openzeppelin/contracts': 4.7.3
+  '@typechain/hardhat': 6.1.3
+  '@types/node': 18.7.13
+  hardhat: 2.11.2
+  ts-node: 10.9.1
+  typescript: 4.8.4
+
+dependencies:
+  '@openzeppelin/contracts': 4.7.3
+
+devDependencies:
+  '@nomicfoundation/hardhat-toolbox': 2.0.0_epcfcfx6issnt2xkawqsyw6j2u
+  '@typechain/hardhat': 6.1.3_hdc77mquumuyu4r5wip4q5ohha
+  '@types/node': 18.7.13
+  hardhat: 2.11.2_mwhvu7sfp6vq5ryuwb6hlbjfka
+  ts-node: 10.9.1_ieummqxttktzud32hpyrer46t4
+  typescript: 4.8.4
+
+packages:
+
+  /@cspotcode/source-map-support/0.8.1:
+    resolution: {integrity: sha512-IchNf6dN4tHoMFIn/7OE8LWZ19Y6q/67Bmf6vnGREv8RSbBVb9LPJxEcnwrcwX6ixSvaiGoomAUvu4YSxXrVgw==}
+    engines: {node: '>=12'}
+    dependencies:
+      '@jridgewell/trace-mapping': 0.3.9
+    dev: true
+
+  /@ethersproject/abi/5.7.0:
+    resolution: {integrity: sha512-351ktp42TiRcYB3H1OP8yajPeAQstMW/yCFokj/AthP9bLHzQFPlOrxOcwYEDkUAICmOHljvN4K39OMTMUa9RA==}
+    dependencies:
+      '@ethersproject/address': 5.7.0
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/constants': 5.7.0
+      '@ethersproject/hash': 5.7.0
+      '@ethersproject/keccak256': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/strings': 5.7.0
+    dev: true
+
+  /@ethersproject/abstract-provider/5.7.0:
+    resolution: {integrity: sha512-R41c9UkchKCpAqStMYUpdunjo3pkEvZC3FAwZn5S5MGbXoMQOHIdHItezTETxAO5bevtMApSyEhn9+CHcDsWBw==}
+    dependencies:
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/networks': 5.7.1
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/transactions': 5.7.0
+      '@ethersproject/web': 5.7.1
+    dev: true
+
+  /@ethersproject/abstract-signer/5.7.0:
+    resolution: {integrity: sha512-a16V8bq1/Cz+TGCkE2OPMTOUDLS3grCpdjoJCYNnVBbdYEMSgKrU0+B90s8b6H+ByYTBZN7a3g76jdIJi7UfKQ==}
+    dependencies:
+      '@ethersproject/abstract-provider': 5.7.0
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/properties': 5.7.0
+    dev: true
+
+  /@ethersproject/address/5.7.0:
+    resolution: {integrity: sha512-9wYhYt7aghVGo758POM5nqcOMaE168Q6aRLJZwUmiqSrAungkG74gSSeKEIR7ukixesdRZGPgVqme6vmxs1fkA==}
+    dependencies:
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/keccak256': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/rlp': 5.7.0
+    dev: true
+
+  /@ethersproject/base64/5.7.0:
+    resolution: {integrity: sha512-Dr8tcHt2mEbsZr/mwTPIQAf3Ai0Bks/7gTw9dSqk1mQvhW3XvRlmDJr/4n+wg1JmCl16NZue17CDh8xb/vZ0sQ==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+    dev: true
+
+  /@ethersproject/basex/5.7.0:
+    resolution: {integrity: sha512-ywlh43GwZLv2Voc2gQVTKBoVQ1mti3d8HK5aMxsfu/nRDnMmNqaSJ3r3n85HBByT8OpoY96SXM1FogC533T4zw==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/properties': 5.7.0
+    dev: true
+
+  /@ethersproject/bignumber/5.7.0:
+    resolution: {integrity: sha512-n1CAdIHRWjSucQO3MC1zPSVgV/6dy/fjL9pMrPP9peL+QxEg9wOsVqwD4+818B6LUEtaXzVHQiuivzRoxPxUGw==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      bn.js: 5.2.1
+    dev: true
+
+  /@ethersproject/bytes/5.7.0:
+    resolution: {integrity: sha512-nsbxwgFXWh9NyYWo+U8atvmMsSdKJprTcICAkvbBffT75qDocbuggBU0SJiVK2MuTrp0q+xvLkTnGMPK1+uA9A==}
+    dependencies:
+      '@ethersproject/logger': 5.7.0
+    dev: true
+
+  /@ethersproject/constants/5.7.0:
+    resolution: {integrity: sha512-DHI+y5dBNvkpYUMiRQyxRBYBefZkJfo70VUkUAsRjcPs47muV9evftfZ0PJVCXYbAiCgght0DtcF9srFQmIgWA==}
+    dependencies:
+      '@ethersproject/bignumber': 5.7.0
+    dev: true
+
+  /@ethersproject/contracts/5.7.0:
+    resolution: {integrity: sha512-5GJbzEU3X+d33CdfPhcyS+z8MzsTrBGk/sc+G+59+tPa9yFkl6HQ9D6L0QMgNTA9q8dT0XKxxkyp883XsQvbbg==}
+    dependencies:
+      '@ethersproject/abi': 5.7.0
+      '@ethersproject/abstract-provider': 5.7.0
+      '@ethersproject/abstract-signer': 5.7.0
+      '@ethersproject/address': 5.7.0
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/constants': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/transactions': 5.7.0
+    dev: true
+
+  /@ethersproject/hash/5.7.0:
+    resolution: {integrity: sha512-qX5WrQfnah1EFnO5zJv1v46a8HW0+E5xuBBDTwMFZLuVTx0tbU2kkx15NqdjxecrLGatQN9FGQKpb1FKdHCt+g==}
+    dependencies:
+      '@ethersproject/abstract-signer': 5.7.0
+      '@ethersproject/address': 5.7.0
+      '@ethersproject/base64': 5.7.0
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/keccak256': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/strings': 5.7.0
+    dev: true
+
+  /@ethersproject/hdnode/5.7.0:
+    resolution: {integrity: sha512-OmyYo9EENBPPf4ERhR7oj6uAtUAhYGqOnIS+jE5pTXvdKBS99ikzq1E7Iv0ZQZ5V36Lqx1qZLeak0Ra16qpeOg==}
+    dependencies:
+      '@ethersproject/abstract-signer': 5.7.0
+      '@ethersproject/basex': 5.7.0
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/pbkdf2': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/sha2': 5.7.0
+      '@ethersproject/signing-key': 5.7.0
+      '@ethersproject/strings': 5.7.0
+      '@ethersproject/transactions': 5.7.0
+      '@ethersproject/wordlists': 5.7.0
+    dev: true
+
+  /@ethersproject/json-wallets/5.7.0:
+    resolution: {integrity: sha512-8oee5Xgu6+RKgJTkvEMl2wDgSPSAQ9MB/3JYjFV9jlKvcYHUXZC+cQp0njgmxdHkYWn8s6/IqIZYm0YWCjO/0g==}
+    dependencies:
+      '@ethersproject/abstract-signer': 5.7.0
+      '@ethersproject/address': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/hdnode': 5.7.0
+      '@ethersproject/keccak256': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/pbkdf2': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/random': 5.7.0
+      '@ethersproject/strings': 5.7.0
+      '@ethersproject/transactions': 5.7.0
+      aes-js: 3.0.0
+      scrypt-js: 3.0.1
+    dev: true
+
+  /@ethersproject/keccak256/5.7.0:
+    resolution: {integrity: sha512-2UcPboeL/iW+pSg6vZ6ydF8tCnv3Iu/8tUmLLzWWGzxWKFFqOBQFLo6uLUv6BDrLgCDfN28RJ/wtByx+jZ4KBg==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+      js-sha3: 0.8.0
+    dev: true
+
+  /@ethersproject/logger/5.7.0:
+    resolution: {integrity: sha512-0odtFdXu/XHtjQXJYA3u9G0G8btm0ND5Cu8M7i5vhEcE8/HmF4Lbdqanwyv4uQTr2tx6b7fQRmgLrsnpQlmnig==}
+    dev: true
+
+  /@ethersproject/networks/5.7.1:
+    resolution: {integrity: sha512-n/MufjFYv3yFcUyfhnXotyDlNdFb7onmkSy8aQERi2PjNcnWQ66xXxa3XlS8nCcA8aJKJjIIMNJTC7tu80GwpQ==}
+    dependencies:
+      '@ethersproject/logger': 5.7.0
+    dev: true
+
+  /@ethersproject/pbkdf2/5.7.0:
+    resolution: {integrity: sha512-oR/dBRZR6GTyaofd86DehG72hY6NpAjhabkhxgr3X2FpJtJuodEl2auADWBZfhDHgVCbu3/H/Ocq2uC6dpNjjw==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/sha2': 5.7.0
+    dev: true
+
+  /@ethersproject/properties/5.7.0:
+    resolution: {integrity: sha512-J87jy8suntrAkIZtecpxEPxY//szqr1mlBaYlQ0r4RCaiD2hjheqF9s1LVE8vVuJCXisjIP+JgtK/Do54ej4Sw==}
+    dependencies:
+      '@ethersproject/logger': 5.7.0
+    dev: true
+
+  /@ethersproject/providers/5.7.1:
+    resolution: {integrity: sha512-vZveG/DLyo+wk4Ga1yx6jSEHrLPgmTt+dFv0dv8URpVCRf0jVhalps1jq/emN/oXnMRsC7cQgAF32DcXLL7BPQ==}
+    dependencies:
+      '@ethersproject/abstract-provider': 5.7.0
+      '@ethersproject/abstract-signer': 5.7.0
+      '@ethersproject/address': 5.7.0
+      '@ethersproject/base64': 5.7.0
+      '@ethersproject/basex': 5.7.0
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/constants': 5.7.0
+      '@ethersproject/hash': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/networks': 5.7.1
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/random': 5.7.0
+      '@ethersproject/rlp': 5.7.0
+      '@ethersproject/sha2': 5.7.0
+      '@ethersproject/strings': 5.7.0
+      '@ethersproject/transactions': 5.7.0
+      '@ethersproject/web': 5.7.1
+      bech32: 1.1.4
+      ws: 7.4.6
+    transitivePeerDependencies:
+      - bufferutil
+      - utf-8-validate
+    dev: true
+
+  /@ethersproject/random/5.7.0:
+    resolution: {integrity: sha512-19WjScqRA8IIeWclFme75VMXSBvi4e6InrUNuaR4s5pTF2qNhcGdCUwdxUVGtDDqC00sDLCO93jPQoDUH4HVmQ==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/logger': 5.7.0
+    dev: true
+
+  /@ethersproject/rlp/5.7.0:
+    resolution: {integrity: sha512-rBxzX2vK8mVF7b0Tol44t5Tb8gomOHkj5guL+HhzQ1yBh/ydjGnpw6at+X6Iw0Kp3OzzzkcKp8N9r0W4kYSs9w==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/logger': 5.7.0
+    dev: true
+
+  /@ethersproject/sha2/5.7.0:
+    resolution: {integrity: sha512-gKlH42riwb3KYp0reLsFTokByAKoJdgFCwI+CCiX/k+Jm2mbNs6oOaCjYQSlI1+XBVejwH2KrmCbMAT/GnRDQw==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      hash.js: 1.1.7
+    dev: true
+
+  /@ethersproject/signing-key/5.7.0:
+    resolution: {integrity: sha512-MZdy2nL3wO0u7gkB4nA/pEf8lu1TlFswPNmy8AiYkfKTdO6eXBJyUdmHO/ehm/htHw9K/qF8ujnTyUAD+Ry54Q==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      bn.js: 5.2.1
+      elliptic: 6.5.4
+      hash.js: 1.1.7
+    dev: true
+
+  /@ethersproject/solidity/5.7.0:
+    resolution: {integrity: sha512-HmabMd2Dt/raavyaGukF4XxizWKhKQ24DoLtdNbBmNKUOPqwjsKQSdV9GQtj9CBEea9DlzETlVER1gYeXXBGaA==}
+    dependencies:
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/keccak256': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/sha2': 5.7.0
+      '@ethersproject/strings': 5.7.0
+    dev: true
+
+  /@ethersproject/strings/5.7.0:
+    resolution: {integrity: sha512-/9nu+lj0YswRNSH0NXYqrh8775XNyEdUQAuf3f+SmOrnVewcJ5SBNAjF7lpgehKi4abvNNXyf+HX86czCdJ8Mg==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/constants': 5.7.0
+      '@ethersproject/logger': 5.7.0
+    dev: true
+
+  /@ethersproject/transactions/5.7.0:
+    resolution: {integrity: sha512-kmcNicCp1lp8qanMTC3RIikGgoJ80ztTyvtsFvCYpSCfkjhD0jZ2LOrnbcuxuToLIUYYf+4XwD1rP+B/erDIhQ==}
+    dependencies:
+      '@ethersproject/address': 5.7.0
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/constants': 5.7.0
+      '@ethersproject/keccak256': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/rlp': 5.7.0
+      '@ethersproject/signing-key': 5.7.0
+    dev: true
+
+  /@ethersproject/units/5.7.0:
+    resolution: {integrity: sha512-pD3xLMy3SJu9kG5xDGI7+xhTEmGXlEqXU4OfNapmfnxLVY4EMSSRp7j1k7eezutBPH7RBN/7QPnwR7hzNlEFeg==}
+    dependencies:
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/constants': 5.7.0
+      '@ethersproject/logger': 5.7.0
+    dev: true
+
+  /@ethersproject/wallet/5.7.0:
+    resolution: {integrity: sha512-MhmXlJXEJFBFVKrDLB4ZdDzxcBxQ3rLyCkhNqVu3CDYvR97E+8r01UgrI+TI99Le+aYm/in/0vp86guJuM7FCA==}
+    dependencies:
+      '@ethersproject/abstract-provider': 5.7.0
+      '@ethersproject/abstract-signer': 5.7.0
+      '@ethersproject/address': 5.7.0
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/hash': 5.7.0
+      '@ethersproject/hdnode': 5.7.0
+      '@ethersproject/json-wallets': 5.7.0
+      '@ethersproject/keccak256': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/random': 5.7.0
+      '@ethersproject/signing-key': 5.7.0
+      '@ethersproject/transactions': 5.7.0
+      '@ethersproject/wordlists': 5.7.0
+    dev: true
+
+  /@ethersproject/web/5.7.1:
+    resolution: {integrity: sha512-Gueu8lSvyjBWL4cYsWsjh6MtMwM0+H4HvqFPZfB6dV8ctbP9zFAO73VG1cMWae0FLPCtz0peKPpZY8/ugJJX2w==}
+    dependencies:
+      '@ethersproject/base64': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/strings': 5.7.0
+    dev: true
+
+  /@ethersproject/wordlists/5.7.0:
+    resolution: {integrity: sha512-S2TFNJNfHWVHNE6cNDjbVlZ6MgE17MIxMbMg2zv3wn+3XSJGosL1m9ZVv3GXCf/2ymSsQ+hRI5IzoMJTG6aoVA==}
+    dependencies:
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/hash': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/strings': 5.7.0
+    dev: true
+
+  /@jridgewell/resolve-uri/3.1.0:
+    resolution: {integrity: sha512-F2msla3tad+Mfht5cJq7LSXcdudKTWCVYUgw6pLFOOHSTtZlj6SWNYAp+AhuqLmWdBO2X5hPrLcu8cVP8fy28w==}
+    engines: {node: '>=6.0.0'}
+    dev: true
+
+  /@jridgewell/sourcemap-codec/1.4.14:
+    resolution: {integrity: sha512-XPSJHWmi394fuUuzDnGz1wiKqWfo1yXecHQMRf2l6hztTO+nPru658AyDngaBe7isIxEkRsPR3FZh+s7iVa4Uw==}
+    dev: true
+
+  /@jridgewell/trace-mapping/0.3.9:
+    resolution: {integrity: sha512-3Belt6tdc8bPgAtbcmdtNJlirVoTmEb5e2gC94PnkwEW9jI6CAHUeoG85tjWP5WquqfavoMtMwiG4P926ZKKuQ==}
+    dependencies:
+      '@jridgewell/resolve-uri': 3.1.0
+      '@jridgewell/sourcemap-codec': 1.4.14
+    dev: true
+
+  /@metamask/eth-sig-util/4.0.1:
+    resolution: {integrity: sha512-tghyZKLHZjcdlDqCA3gNZmLeR0XvOE9U1qoQO9ohyAZT6Pya+H9vkBPcsyXytmYLNgVoin7CKCmweo/R43V+tQ==}
+    engines: {node: '>=12.0.0'}
+    dependencies:
+      ethereumjs-abi: 0.6.8
+      ethereumjs-util: 6.2.1
+      ethjs-util: 0.1.6
+      tweetnacl: 1.0.3
+      tweetnacl-util: 0.15.1
+    dev: true
+
+  /@noble/hashes/1.1.2:
+    resolution: {integrity: sha512-KYRCASVTv6aeUi1tsF8/vpyR7zpfs3FUzy2Jqm+MU+LmUKhQ0y2FpfwqkCcxSg2ua4GALJd8k2R76WxwZGbQpA==}
+    dev: true
+
+  /@noble/secp256k1/1.6.3:
+    resolution: {integrity: sha512-T04e4iTurVy7I8Sw4+c5OSN9/RkPlo1uKxAomtxQNLq8j1uPAqnsqG1bqvY3Jv7c13gyr6dui0zmh/I3+f/JaQ==}
+    dev: true
+
+  /@nodelib/fs.scandir/2.1.5:
+    resolution: {integrity: sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==}
+    engines: {node: '>= 8'}
+    dependencies:
+      '@nodelib/fs.stat': 2.0.5
+      run-parallel: 1.2.0
+    dev: true
+
+  /@nodelib/fs.stat/2.0.5:
+    resolution: {integrity: sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==}
+    engines: {node: '>= 8'}
+    dev: true
+
+  /@nodelib/fs.walk/1.2.8:
+    resolution: {integrity: sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==}
+    engines: {node: '>= 8'}
+    dependencies:
+      '@nodelib/fs.scandir': 2.1.5
+      fastq: 1.13.0
+    dev: true
+
+  /@nomicfoundation/ethereumjs-block/4.0.0:
+    resolution: {integrity: sha512-bk8uP8VuexLgyIZAHExH1QEovqx0Lzhc9Ntm63nCRKLHXIZkobaFaeCVwTESV7YkPKUk7NiK11s8ryed4CS9yA==}
+    engines: {node: '>=14'}
+    dependencies:
+      '@nomicfoundation/ethereumjs-common': 3.0.0
+      '@nomicfoundation/ethereumjs-rlp': 4.0.0
+      '@nomicfoundation/ethereumjs-trie': 5.0.0
+      '@nomicfoundation/ethereumjs-tx': 4.0.0
+      '@nomicfoundation/ethereumjs-util': 8.0.0
+      ethereum-cryptography: 0.1.3
+    dev: true
+
+  /@nomicfoundation/ethereumjs-blockchain/6.0.0:
+    resolution: {integrity: sha512-pLFEoea6MWd81QQYSReLlLfH7N9v7lH66JC/NMPN848ySPPQA5renWnE7wPByfQFzNrPBuDDRFFULMDmj1C0xw==}
+    engines: {node: '>=14'}
+    dependencies:
+      '@nomicfoundation/ethereumjs-block': 4.0.0
+      '@nomicfoundation/ethereumjs-common': 3.0.0
+      '@nomicfoundation/ethereumjs-ethash': 2.0.0
+      '@nomicfoundation/ethereumjs-rlp': 4.0.0
+      '@nomicfoundation/ethereumjs-trie': 5.0.0
+      '@nomicfoundation/ethereumjs-util': 8.0.0
+      abstract-level: 1.0.3
+      debug: 4.3.4
+      ethereum-cryptography: 0.1.3
+      level: 8.0.0
+      lru-cache: 5.1.1
+      memory-level: 1.0.0
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@nomicfoundation/ethereumjs-common/3.0.0:
+    resolution: {integrity: sha512-WS7qSshQfxoZOpHG/XqlHEGRG1zmyjYrvmATvc4c62+gZXgre1ymYP8ZNgx/3FyZY0TWe9OjFlKOfLqmgOeYwA==}
+    dependencies:
+      '@nomicfoundation/ethereumjs-util': 8.0.0
+      crc-32: 1.2.2
+    dev: true
+
+  /@nomicfoundation/ethereumjs-ethash/2.0.0:
+    resolution: {integrity: sha512-WpDvnRncfDUuXdsAXlI4lXbqUDOA+adYRQaEezIkxqDkc+LDyYDbd/xairmY98GnQzo1zIqsIL6GB5MoMSJDew==}
+    engines: {node: '>=14'}
+    dependencies:
+      '@nomicfoundation/ethereumjs-block': 4.0.0
+      '@nomicfoundation/ethereumjs-rlp': 4.0.0
+      '@nomicfoundation/ethereumjs-util': 8.0.0
+      abstract-level: 1.0.3
+      bigint-crypto-utils: 3.1.7
+      ethereum-cryptography: 0.1.3
+    dev: true
+
+  /@nomicfoundation/ethereumjs-evm/1.0.0:
+    resolution: {integrity: sha512-hVS6qRo3V1PLKCO210UfcEQHvlG7GqR8iFzp0yyjTg2TmJQizcChKgWo8KFsdMw6AyoLgLhHGHw4HdlP8a4i+Q==}
+    engines: {node: '>=14'}
+    dependencies:
+      '@nomicfoundation/ethereumjs-common': 3.0.0
+      '@nomicfoundation/ethereumjs-util': 8.0.0
+      '@types/async-eventemitter': 0.2.1
+      async-eventemitter: 0.2.4
+      debug: 4.3.4
+      ethereum-cryptography: 0.1.3
+      mcl-wasm: 0.7.9
+      rustbn.js: 0.2.0
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@nomicfoundation/ethereumjs-rlp/4.0.0:
+    resolution: {integrity: sha512-GaSOGk5QbUk4eBP5qFbpXoZoZUj/NrW7MRa0tKY4Ew4c2HAS0GXArEMAamtFrkazp0BO4K5p2ZCG3b2FmbShmw==}
+    engines: {node: '>=14'}
+    hasBin: true
+    dev: true
+
+  /@nomicfoundation/ethereumjs-statemanager/1.0.0:
+    resolution: {integrity: sha512-jCtqFjcd2QejtuAMjQzbil/4NHf5aAWxUc+CvS0JclQpl+7M0bxMofR2AJdtz+P3u0ke2euhYREDiE7iSO31vQ==}
+    dependencies:
+      '@nomicfoundation/ethereumjs-common': 3.0.0
+      '@nomicfoundation/ethereumjs-rlp': 4.0.0
+      '@nomicfoundation/ethereumjs-trie': 5.0.0
+      '@nomicfoundation/ethereumjs-util': 8.0.0
+      debug: 4.3.4
+      ethereum-cryptography: 0.1.3
+      functional-red-black-tree: 1.0.1
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@nomicfoundation/ethereumjs-trie/5.0.0:
+    resolution: {integrity: sha512-LIj5XdE+s+t6WSuq/ttegJzZ1vliwg6wlb+Y9f4RlBpuK35B9K02bO7xU+E6Rgg9RGptkWd6TVLdedTI4eNc2A==}
+    engines: {node: '>=14'}
+    dependencies:
+      '@nomicfoundation/ethereumjs-rlp': 4.0.0
+      '@nomicfoundation/ethereumjs-util': 8.0.0
+      ethereum-cryptography: 0.1.3
+      readable-stream: 3.6.0
+    dev: true
+
+  /@nomicfoundation/ethereumjs-tx/4.0.0:
+    resolution: {integrity: sha512-Gg3Lir2lNUck43Kp/3x6TfBNwcWC9Z1wYue9Nz3v4xjdcv6oDW9QSMJxqsKw9QEGoBBZ+gqwpW7+F05/rs/g1w==}
+    engines: {node: '>=14'}
+    dependencies:
+      '@nomicfoundation/ethereumjs-common': 3.0.0
+      '@nomicfoundation/ethereumjs-rlp': 4.0.0
+      '@nomicfoundation/ethereumjs-util': 8.0.0
+      ethereum-cryptography: 0.1.3
+    dev: true
+
+  /@nomicfoundation/ethereumjs-util/8.0.0:
+    resolution: {integrity: sha512-2emi0NJ/HmTG+CGY58fa+DQuAoroFeSH9gKu9O6JnwTtlzJtgfTixuoOqLEgyyzZVvwfIpRueuePb8TonL1y+A==}
+    engines: {node: '>=14'}
+    dependencies:
+      '@nomicfoundation/ethereumjs-rlp': 4.0.0
+      ethereum-cryptography: 0.1.3
+    dev: true
+
+  /@nomicfoundation/ethereumjs-vm/6.0.0:
+    resolution: {integrity: sha512-JMPxvPQ3fzD063Sg3Tp+UdwUkVxMoo1uML6KSzFhMH3hoQi/LMuXBoEHAoW83/vyNS9BxEe6jm6LmT5xdeEJ6w==}
+    engines: {node: '>=14'}
+    dependencies:
+      '@nomicfoundation/ethereumjs-block': 4.0.0
+      '@nomicfoundation/ethereumjs-blockchain': 6.0.0
+      '@nomicfoundation/ethereumjs-common': 3.0.0
+      '@nomicfoundation/ethereumjs-evm': 1.0.0
+      '@nomicfoundation/ethereumjs-rlp': 4.0.0
+      '@nomicfoundation/ethereumjs-statemanager': 1.0.0
+      '@nomicfoundation/ethereumjs-trie': 5.0.0
+      '@nomicfoundation/ethereumjs-tx': 4.0.0
+      '@nomicfoundation/ethereumjs-util': 8.0.0
+      '@types/async-eventemitter': 0.2.1
+      async-eventemitter: 0.2.4
+      debug: 4.3.4
+      ethereum-cryptography: 0.1.3
+      functional-red-black-tree: 1.0.1
+      mcl-wasm: 0.7.9
+      rustbn.js: 0.2.0
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@nomicfoundation/hardhat-chai-matchers/1.0.3_u4bbm4ajgevldrm2ufutb7vine:
+    resolution: {integrity: sha512-qEE7Drs2HSY+krH09TXm6P9LFogs0BqbUq6wPD7nQRhmJ+p5zoDaIZjM5WL1pHqU5MpGqya3y+BdwmTYBfU5UA==}
+    peerDependencies:
+      '@nomiclabs/hardhat-ethers': ^2.0.0
+      chai: ^4.2.0
+      ethers: ^5.0.0
+      hardhat: ^2.9.4
+    dependencies:
+      '@ethersproject/abi': 5.7.0
+      '@nomiclabs/hardhat-ethers': 2.1.1_liuail6phkx7un26teqxcf6yx4
+      '@types/chai-as-promised': 7.1.5
+      chai: 4.3.6
+      chai-as-promised: 7.1.1_chai@4.3.6
+      chalk: 2.4.2
+      deep-eql: 4.1.1
+      ethers: 5.7.1
+      hardhat: 2.11.2_mwhvu7sfp6vq5ryuwb6hlbjfka
+      ordinal: 1.0.3
+    dev: true
+
+  /@nomicfoundation/hardhat-network-helpers/1.0.6_hardhat@2.11.2:
+    resolution: {integrity: sha512-a35iVD4ycF6AoTfllAnKm96IPIzzHpgKX/ep4oKc2bsUKFfMlacWdyntgC/7d5blyCTXfFssgNAvXDZfzNWVGQ==}
+    peerDependencies:
+      hardhat: ^2.9.5
+    dependencies:
+      ethereumjs-util: 7.1.5
+      hardhat: 2.11.2_mwhvu7sfp6vq5ryuwb6hlbjfka
+    dev: true
+
+  /@nomicfoundation/hardhat-toolbox/2.0.0_epcfcfx6issnt2xkawqsyw6j2u:
+    resolution: {integrity: sha512-BoOPbzLQ1GArnBZd4Jz4IU8FY3RY4nUwpXlfymXwxlXNimngkPRJj7ivVNurD7igohEjf90v/Axn2M5WwAdCJQ==}
+    peerDependencies:
+      '@ethersproject/abi': ^5.4.7
+      '@ethersproject/providers': ^5.4.7
+      '@nomicfoundation/hardhat-chai-matchers': ^1.0.0
+      '@nomicfoundation/hardhat-network-helpers': ^1.0.0
+      '@nomiclabs/hardhat-ethers': ^2.0.0
+      '@nomiclabs/hardhat-etherscan': ^3.0.0
+      '@typechain/ethers-v5': ^10.1.0
+      '@typechain/hardhat': ^6.1.2
+      '@types/chai': ^4.2.0
+      '@types/mocha': ^9.1.0
+      '@types/node': '>=12.0.0'
+      chai: ^4.2.0
+      ethers: ^5.4.7
+      hardhat: ^2.11.0
+      hardhat-gas-reporter: ^1.0.8
+      solidity-coverage: ^0.8.1
+      ts-node: '>=8.0.0'
+      typechain: ^8.1.0
+      typescript: '>=4.5.0'
+    dependencies:
+      '@ethersproject/abi': 5.7.0
+      '@ethersproject/providers': 5.7.1
+      '@nomicfoundation/hardhat-chai-matchers': 1.0.3_u4bbm4ajgevldrm2ufutb7vine
+      '@nomicfoundation/hardhat-network-helpers': 1.0.6_hardhat@2.11.2
+      '@nomiclabs/hardhat-ethers': 2.1.1_liuail6phkx7un26teqxcf6yx4
+      '@nomiclabs/hardhat-etherscan': 3.1.0_hardhat@2.11.2
+      '@typechain/ethers-v5': 10.1.0_ap4nli2xeolmikzlf5243gdnwy
+      '@typechain/hardhat': 6.1.3_hdc77mquumuyu4r5wip4q5ohha
+      '@types/chai': 4.3.3
+      '@types/mocha': 9.1.1
+      '@types/node': 18.7.13
+      chai: 4.3.6
+      ethers: 5.7.1
+      hardhat: 2.11.2_mwhvu7sfp6vq5ryuwb6hlbjfka
+      hardhat-gas-reporter: 1.0.9_hardhat@2.11.2
+      solidity-coverage: 0.8.2_hardhat@2.11.2
+      ts-node: 10.9.1_ieummqxttktzud32hpyrer46t4
+      typechain: 8.1.0_typescript@4.8.4
+      typescript: 4.8.4
+    dev: true
+
+  /@nomicfoundation/solidity-analyzer-darwin-arm64/0.0.3:
+    resolution: {integrity: sha512-W+bIiNiZmiy+MTYFZn3nwjyPUO6wfWJ0lnXx2zZrM8xExKObMrhCh50yy8pQING24mHfpPFCn89wEB/iG7vZDw==}
+    engines: {node: '>= 10'}
+    cpu: [arm64]
+    os: [darwin]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@nomicfoundation/solidity-analyzer-darwin-x64/0.0.3:
+    resolution: {integrity: sha512-HuJd1K+2MgmFIYEpx46uzwEFjvzKAI765mmoMxy4K+Aqq1p+q7hHRlsFU2kx3NB8InwotkkIq3A5FLU1sI1WDw==}
+    engines: {node: '>= 10'}
+    cpu: [x64]
+    os: [darwin]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@nomicfoundation/solidity-analyzer-freebsd-x64/0.0.3:
+    resolution: {integrity: sha512-2cR8JNy23jZaO/vZrsAnWCsO73asU7ylrHIe0fEsXbZYqBP9sMr+/+xP3CELDHJxUbzBY8zqGvQt1ULpyrG+Kw==}
+    engines: {node: '>= 10'}
+    cpu: [x64]
+    os: [freebsd]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@nomicfoundation/solidity-analyzer-linux-arm64-gnu/0.0.3:
+    resolution: {integrity: sha512-Eyv50EfYbFthoOb0I1568p+eqHGLwEUhYGOxcRNywtlTE9nj+c+MT1LA53HnxD9GsboH4YtOOmJOulrjG7KtbA==}
+    engines: {node: '>= 10'}
+    cpu: [arm64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@nomicfoundation/solidity-analyzer-linux-arm64-musl/0.0.3:
+    resolution: {integrity: sha512-V8grDqI+ivNrgwEt2HFdlwqV2/EQbYAdj3hbOvjrA8Qv+nq4h9jhQUxFpegYMDtpU8URJmNNlXgtfucSrAQwtQ==}
+    engines: {node: '>= 10'}
+    cpu: [arm64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@nomicfoundation/solidity-analyzer-linux-x64-gnu/0.0.3:
+    resolution: {integrity: sha512-uRfVDlxtwT1vIy7MAExWAkRD4r9M79zMG7S09mCrWUn58DbLs7UFl+dZXBX0/8FTGYWHhOT/1Etw1ZpAf5DTrg==}
+    engines: {node: '>= 10'}
+    cpu: [x64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@nomicfoundation/solidity-analyzer-linux-x64-musl/0.0.3:
+    resolution: {integrity: sha512-8HPwYdLbhcPpSwsE0yiU/aZkXV43vlXT2ycH+XlOjWOnLfH8C41z0njK8DHRtEFnp4OVN6E7E5lHBBKDZXCliA==}
+    engines: {node: '>= 10'}
+    cpu: [x64]
+    os: [linux]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@nomicfoundation/solidity-analyzer-win32-arm64-msvc/0.0.3:
+    resolution: {integrity: sha512-5WWcT6ZNvfCuxjlpZOY7tdvOqT1kIQYlDF9Q42wMpZ5aTm4PvjdCmFDDmmTvyXEBJ4WTVmY5dWNWaxy8h/E28g==}
+    engines: {node: '>= 10'}
+    cpu: [arm64]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@nomicfoundation/solidity-analyzer-win32-ia32-msvc/0.0.3:
+    resolution: {integrity: sha512-P/LWGZwWkyjSwkzq6skvS2wRc3gabzAbk6Akqs1/Iiuggql2CqdLBkcYWL5Xfv3haynhL+2jlNkak+v2BTZI4A==}
+    engines: {node: '>= 10'}
+    cpu: [ia32]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@nomicfoundation/solidity-analyzer-win32-x64-msvc/0.0.3:
+    resolution: {integrity: sha512-4AcTtLZG1s/S5mYAIr/sdzywdNwJpOcdStGF3QMBzEt+cGn3MchMaS9b1gyhb2KKM2c39SmPF5fUuWq1oBSQZQ==}
+    engines: {node: '>= 10'}
+    cpu: [x64]
+    os: [win32]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /@nomicfoundation/solidity-analyzer/0.0.3:
+    resolution: {integrity: sha512-VFMiOQvsw7nx5bFmrmVp2Q9rhIjw2AFST4DYvWVVO9PMHPE23BY2+kyfrQ4J3xCMFC8fcBbGLt7l4q7m1SlTqg==}
+    engines: {node: '>= 12'}
+    optionalDependencies:
+      '@nomicfoundation/solidity-analyzer-darwin-arm64': 0.0.3
+      '@nomicfoundation/solidity-analyzer-darwin-x64': 0.0.3
+      '@nomicfoundation/solidity-analyzer-freebsd-x64': 0.0.3
+      '@nomicfoundation/solidity-analyzer-linux-arm64-gnu': 0.0.3
+      '@nomicfoundation/solidity-analyzer-linux-arm64-musl': 0.0.3
+      '@nomicfoundation/solidity-analyzer-linux-x64-gnu': 0.0.3
+      '@nomicfoundation/solidity-analyzer-linux-x64-musl': 0.0.3
+      '@nomicfoundation/solidity-analyzer-win32-arm64-msvc': 0.0.3
+      '@nomicfoundation/solidity-analyzer-win32-ia32-msvc': 0.0.3
+      '@nomicfoundation/solidity-analyzer-win32-x64-msvc': 0.0.3
+    dev: true
+
+  /@nomiclabs/hardhat-ethers/2.1.1_liuail6phkx7un26teqxcf6yx4:
+    resolution: {integrity: sha512-Gg0IFkT/DW3vOpih4/kMjeZCLYqtfgECLeLXTs7ZDPzcK0cfoc5wKk4nq5n/izCUzdhidO/Utd6ptF9JrWwWVA==}
+    peerDependencies:
+      ethers: ^5.0.0
+      hardhat: ^2.0.0
+    dependencies:
+      ethers: 5.7.1
+      hardhat: 2.11.2_mwhvu7sfp6vq5ryuwb6hlbjfka
+    dev: true
+
+  /@nomiclabs/hardhat-etherscan/3.1.0_hardhat@2.11.2:
+    resolution: {integrity: sha512-JroYgfN1AlYFkQTQ3nRwFi4o8NtZF7K/qFR2dxDUgHbCtIagkUseca9L4E/D2ScUm4XT40+8PbCdqZi+XmHyQA==}
+    peerDependencies:
+      hardhat: ^2.0.4
+    dependencies:
+      '@ethersproject/abi': 5.7.0
+      '@ethersproject/address': 5.7.0
+      cbor: 5.2.0
+      chalk: 2.4.2
+      debug: 4.3.4
+      fs-extra: 7.0.1
+      hardhat: 2.11.2_mwhvu7sfp6vq5ryuwb6hlbjfka
+      lodash: 4.17.21
+      semver: 6.3.0
+      table: 6.8.0
+      undici: 5.11.0
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@openzeppelin/contracts/4.7.3:
+    resolution: {integrity: sha512-dGRS0agJzu8ybo44pCIf3xBaPQN/65AIXNgK8+4gzKd5kbvlqyxryUYVLJv7fK98Seyd2hDZzVEHSWAh0Bt1Yw==}
+    dev: false
+
+  /@scure/base/1.1.1:
+    resolution: {integrity: sha512-ZxOhsSyxYwLJj3pLZCefNitxsj093tb2vq90mp2txoYeBqbcjDjqFhyM8eUjq/uFm6zJ+mUuqxlS2FkuSY1MTA==}
+    dev: true
+
+  /@scure/bip32/1.1.0:
+    resolution: {integrity: sha512-ftTW3kKX54YXLCxH6BB7oEEoJfoE2pIgw7MINKAs5PsS6nqKPuKk1haTF/EuHmYqG330t5GSrdmtRuHaY1a62Q==}
+    dependencies:
+      '@noble/hashes': 1.1.2
+      '@noble/secp256k1': 1.6.3
+      '@scure/base': 1.1.1
+    dev: true
+
+  /@scure/bip39/1.1.0:
+    resolution: {integrity: sha512-pwrPOS16VeTKg98dYXQyIjJEcWfz7/1YJIwxUEPFfQPtc86Ym/1sVgQ2RLoD43AazMk2l/unK4ITySSpW2+82w==}
+    dependencies:
+      '@noble/hashes': 1.1.2
+      '@scure/base': 1.1.1
+    dev: true
+
+  /@sentry/core/5.30.0:
+    resolution: {integrity: sha512-TmfrII8w1PQZSZgPpUESqjB+jC6MvZJZdLtE/0hZ+SrnKhW3x5WlYLvTXZpcWePYBku7rl2wn1RZu6uT0qCTeg==}
+    engines: {node: '>=6'}
+    dependencies:
+      '@sentry/hub': 5.30.0
+      '@sentry/minimal': 5.30.0
+      '@sentry/types': 5.30.0
+      '@sentry/utils': 5.30.0
+      tslib: 1.14.1
+    dev: true
+
+  /@sentry/hub/5.30.0:
+    resolution: {integrity: sha512-2tYrGnzb1gKz2EkMDQcfLrDTvmGcQPuWxLnJKXJvYTQDGLlEvi2tWz1VIHjunmOvJrB5aIQLhm+dcMRwFZDCqQ==}
+    engines: {node: '>=6'}
+    dependencies:
+      '@sentry/types': 5.30.0
+      '@sentry/utils': 5.30.0
+      tslib: 1.14.1
+    dev: true
+
+  /@sentry/minimal/5.30.0:
+    resolution: {integrity: sha512-BwWb/owZKtkDX+Sc4zCSTNcvZUq7YcH3uAVlmh/gtR9rmUvbzAA3ewLuB3myi4wWRAMEtny6+J/FN/x+2wn9Xw==}
+    engines: {node: '>=6'}
+    dependencies:
+      '@sentry/hub': 5.30.0
+      '@sentry/types': 5.30.0
+      tslib: 1.14.1
+    dev: true
+
+  /@sentry/node/5.30.0:
+    resolution: {integrity: sha512-Br5oyVBF0fZo6ZS9bxbJZG4ApAjRqAnqFFurMVJJdunNb80brh7a5Qva2kjhm+U6r9NJAB5OmDyPkA1Qnt+QVg==}
+    engines: {node: '>=6'}
+    dependencies:
+      '@sentry/core': 5.30.0
+      '@sentry/hub': 5.30.0
+      '@sentry/tracing': 5.30.0
+      '@sentry/types': 5.30.0
+      '@sentry/utils': 5.30.0
+      cookie: 0.4.2
+      https-proxy-agent: 5.0.1
+      lru_map: 0.3.3
+      tslib: 1.14.1
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /@sentry/tracing/5.30.0:
+    resolution: {integrity: sha512-dUFowCr0AIMwiLD7Fs314Mdzcug+gBVo/+NCMyDw8tFxJkwWAKl7Qa2OZxLQ0ZHjakcj1hNKfCQJ9rhyfOl4Aw==}
+    engines: {node: '>=6'}
+    dependencies:
+      '@sentry/hub': 5.30.0
+      '@sentry/minimal': 5.30.0
+      '@sentry/types': 5.30.0
+      '@sentry/utils': 5.30.0
+      tslib: 1.14.1
+    dev: true
+
+  /@sentry/types/5.30.0:
+    resolution: {integrity: sha512-R8xOqlSTZ+htqrfteCWU5Nk0CDN5ApUTvrlvBuiH1DyP6czDZ4ktbZB0hAgBlVcK0U+qpD3ag3Tqqpa5Q67rPw==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /@sentry/utils/5.30.0:
+    resolution: {integrity: sha512-zaYmoH0NWWtvnJjC9/CBseXMtKHm/tm40sz3YfJRxeQjyzRqNQPgivpd9R/oDJCYj999mzdW382p/qi2ypjLww==}
+    engines: {node: '>=6'}
+    dependencies:
+      '@sentry/types': 5.30.0
+      tslib: 1.14.1
+    dev: true
+
+  /@solidity-parser/parser/0.14.3:
+    resolution: {integrity: sha512-29g2SZ29HtsqA58pLCtopI1P/cPy5/UAzlcAXO6T/CNJimG6yA8kx4NaseMyJULiC+TEs02Y9/yeHzClqoA0hw==}
+    dependencies:
+      antlr4ts: 0.5.0-alpha.4
+    dev: true
+
+  /@tsconfig/node10/1.0.9:
+    resolution: {integrity: sha512-jNsYVVxU8v5g43Erja32laIDHXeoNvFEpX33OK4d6hljo3jDhCBDhx5dhCCTMWUojscpAagGiRkBKxpdl9fxqA==}
+    dev: true
+
+  /@tsconfig/node12/1.0.11:
+    resolution: {integrity: sha512-cqefuRsh12pWyGsIoBKJA9luFu3mRxCA+ORZvA4ktLSzIuCUtWVxGIuXigEwO5/ywWFMZ2QEGKWvkZG1zDMTag==}
+    dev: true
+
+  /@tsconfig/node14/1.0.3:
+    resolution: {integrity: sha512-ysT8mhdixWK6Hw3i1V2AeRqZ5WfXg1G43mqoYlM2nc6388Fq5jcXyr5mRsqViLx/GJYdoL0bfXD8nmF+Zn/Iow==}
+    dev: true
+
+  /@tsconfig/node16/1.0.3:
+    resolution: {integrity: sha512-yOlFc+7UtL/89t2ZhjPvvB/DeAr3r+Dq58IgzsFkOAvVC6NMJXmCGjbptdXdR9qsX7pKcTL+s87FtYREi2dEEQ==}
+    dev: true
+
+  /@typechain/ethers-v5/10.1.0_ap4nli2xeolmikzlf5243gdnwy:
+    resolution: {integrity: sha512-3LIb+eUpV3mNCrjUKT5oqp8PBsZYSnVrkfk6pY/ZM0boRs2mKxjFZ7bktx42vfDye8PPz3NxtW4DL5NsNsFqlg==}
+    peerDependencies:
+      '@ethersproject/abi': ^5.0.0
+      '@ethersproject/bytes': ^5.0.0
+      '@ethersproject/providers': ^5.0.0
+      ethers: ^5.1.3
+      typechain: ^8.1.0
+      typescript: '>=4.3.0'
+    dependencies:
+      '@ethersproject/abi': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/providers': 5.7.1
+      ethers: 5.7.1
+      lodash: 4.17.21
+      ts-essentials: 7.0.3_typescript@4.8.4
+      typechain: 8.1.0_typescript@4.8.4
+      typescript: 4.8.4
+    dev: true
+
+  /@typechain/hardhat/6.1.3_hdc77mquumuyu4r5wip4q5ohha:
+    resolution: {integrity: sha512-e1H9MVl286ma0HuD9CBL248+pbdA7lWF6+I7FYwzykIrjilKhvLUv0Q7LtcyZztzgbP2g4Tyg1UPE+xy+qR7cA==}
+    peerDependencies:
+      '@ethersproject/abi': ^5.4.7
+      '@ethersproject/providers': ^5.4.7
+      '@typechain/ethers-v5': ^10.1.0
+      ethers: ^5.4.7
+      hardhat: ^2.9.9
+      typechain: ^8.1.0
+    dependencies:
+      '@ethersproject/abi': 5.7.0
+      '@ethersproject/providers': 5.7.1
+      '@typechain/ethers-v5': 10.1.0_ap4nli2xeolmikzlf5243gdnwy
+      ethers: 5.7.1
+      fs-extra: 9.1.0
+      hardhat: 2.11.2_mwhvu7sfp6vq5ryuwb6hlbjfka
+      typechain: 8.1.0_typescript@4.8.4
+    dev: true
+
+  /@types/async-eventemitter/0.2.1:
+    resolution: {integrity: sha512-M2P4Ng26QbAeITiH7w1d7OxtldgfAe0wobpyJzVK/XOb0cUGKU2R4pfAhqcJBXAe2ife5ZOhSv4wk7p+ffURtg==}
+    dev: true
+
+  /@types/bn.js/4.11.6:
+    resolution: {integrity: sha512-pqr857jrp2kPuO9uRjZ3PwnJTjoQy+fcdxvBTvHm6dkmEL9q+hDD/2j/0ELOBPtPnS8LjCX0gI9nbl8lVkadpg==}
+    dependencies:
+      '@types/node': 18.7.13
+    dev: true
+
+  /@types/bn.js/5.1.1:
+    resolution: {integrity: sha512-qNrYbZqMx0uJAfKnKclPh+dTwK33KfLHYqtyODwd5HnXOjnkhc4qgn3BrK6RWyGZm5+sIFE7Q7Vz6QQtJB7w7g==}
+    dependencies:
+      '@types/node': 18.7.13
+    dev: true
+
+  /@types/chai-as-promised/7.1.5:
+    resolution: {integrity: sha512-jStwss93SITGBwt/niYrkf2C+/1KTeZCZl1LaeezTlqppAKeoQC7jxyqYuP72sxBGKCIbw7oHgbYssIRzT5FCQ==}
+    dependencies:
+      '@types/chai': 4.3.3
+    dev: true
+
+  /@types/chai/4.3.3:
+    resolution: {integrity: sha512-hC7OMnszpxhZPduX+m+nrx+uFoLkWOMiR4oa/AZF3MuSETYTZmFfJAHqZEM8MVlvfG7BEUcgvtwoCTxBp6hm3g==}
+    dev: true
+
+  /@types/concat-stream/1.6.1:
+    resolution: {integrity: sha512-eHE4cQPoj6ngxBZMvVf6Hw7Mh4jMW4U9lpGmS5GBPB9RYxlFg+CHaVN7ErNY4W9XfLIEn20b4VDYaIrbq0q4uA==}
+    dependencies:
+      '@types/node': 18.7.13
+    dev: true
+
+  /@types/form-data/0.0.33:
+    resolution: {integrity: sha512-8BSvG1kGm83cyJITQMZSulnl6QV8jqAGreJsc5tPu1Jq0vTSOiY/k24Wx82JRpWwZSqrala6sd5rWi6aNXvqcw==}
+    dependencies:
+      '@types/node': 18.7.13
+    dev: true
+
+  /@types/glob/7.2.0:
+    resolution: {integrity: sha512-ZUxbzKl0IfJILTS6t7ip5fQQM/J3TJYubDm3nMbgubNNYS62eXeUpoLUC8/7fJNiFYHTrGPQn7hspDUzIHX3UA==}
+    dependencies:
+      '@types/minimatch': 5.1.2
+      '@types/node': 18.7.13
+    dev: true
+
+  /@types/lru-cache/5.1.1:
+    resolution: {integrity: sha512-ssE3Vlrys7sdIzs5LOxCzTVMsU7i9oa/IaW92wF32JFb3CVczqOkru2xspuKczHEbG3nvmPY7IFqVmGGHdNbYw==}
+    dev: true
+
+  /@types/minimatch/5.1.2:
+    resolution: {integrity: sha512-K0VQKziLUWkVKiRVrx4a40iPaxTUefQmjtkQofBkYRcoaaL/8rhwDWww9qWbrgicNOgnpIsMxyNIUM4+n6dUIA==}
+    dev: true
+
+  /@types/mocha/9.1.1:
+    resolution: {integrity: sha512-Z61JK7DKDtdKTWwLeElSEBcWGRLY8g95ic5FoQqI9CMx0ns/Ghep3B4DfcEimiKMvtamNVULVNKEsiwV3aQmXw==}
+    dev: true
+
+  /@types/node/10.17.60:
+    resolution: {integrity: sha512-F0KIgDJfy2nA3zMLmWGKxcH2ZVEtCZXHHdOQs2gSaQ27+lNeEfGxzkIw90aXswATX7AZ33tahPbzy6KAfUreVw==}
+    dev: true
+
+  /@types/node/18.7.13:
+    resolution: {integrity: sha512-46yIhxSe5xEaJZXWdIBP7GU4HDTG8/eo0qd9atdiL+lFpA03y8KS+lkTN834TWJj5767GbWv4n/P6efyTFt1Dw==}
+    dev: true
+
+  /@types/node/8.10.66:
+    resolution: {integrity: sha512-tktOkFUA4kXx2hhhrB8bIFb5TbwzS4uOhKEmwiD+NoiL0qtP2OQ9mFldbgD4dV1djrlBYP6eBuQZiWjuHUpqFw==}
+    dev: true
+
+  /@types/pbkdf2/3.1.0:
+    resolution: {integrity: sha512-Cf63Rv7jCQ0LaL8tNXmEyqTHuIJxRdlS5vMh1mj5voN4+QFhVZnlZruezqpWYDiJ8UTzhP0VmeLXCmBk66YrMQ==}
+    dependencies:
+      '@types/node': 18.7.13
+    dev: true
+
+  /@types/prettier/2.7.1:
+    resolution: {integrity: sha512-ri0UmynRRvZiiUJdiz38MmIblKK+oH30MztdBVR95dv/Ubw6neWSb8u1XpRb72L4qsZOhz+L+z9JD40SJmfWow==}
+    dev: true
+
+  /@types/qs/6.9.7:
+    resolution: {integrity: sha512-FGa1F62FT09qcrueBA6qYTrJPVDzah9a+493+o2PCXsesWHIn27G98TsSMs3WPNbZIEj4+VJf6saSFpvD+3Zsw==}
+    dev: true
+
+  /@types/secp256k1/4.0.3:
+    resolution: {integrity: sha512-Da66lEIFeIz9ltsdMZcpQvmrmmoqrfju8pm1BH8WbYjZSwUgCwXLb9C+9XYogwBITnbsSaMdVPb2ekf7TV+03w==}
+    dependencies:
+      '@types/node': 18.7.13
+    dev: true
+
+  /@ungap/promise-all-settled/1.1.2:
+    resolution: {integrity: sha512-sL/cEvJWAnClXw0wHk85/2L0G6Sj8UB0Ctc1TEMbKSsmpRosqhwj9gWgFRZSrBr2f9tiXISwNhCPmlfqUqyb9Q==}
+    dev: true
+
+  /abbrev/1.0.9:
+    resolution: {integrity: sha512-LEyx4aLEC3x6T0UguF6YILf+ntvmOaWsVfENmIW0E9H09vKlLDGelMjjSm0jkDHALj8A8quZ/HapKNigzwge+Q==}
+    dev: true
+
+  /abort-controller/3.0.0:
+    resolution: {integrity: sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==}
+    engines: {node: '>=6.5'}
+    dependencies:
+      event-target-shim: 5.0.1
+    dev: true
+
+  /abstract-level/1.0.3:
+    resolution: {integrity: sha512-t6jv+xHy+VYwc4xqZMn2Pa9DjcdzvzZmQGRjTFc8spIbRGHgBrEKbPq+rYXc7CCo0lxgYvSgKVg9qZAhpVQSjA==}
+    engines: {node: '>=12'}
+    dependencies:
+      buffer: 6.0.3
+      catering: 2.1.1
+      is-buffer: 2.0.5
+      level-supports: 4.0.1
+      level-transcoder: 1.0.1
+      module-error: 1.0.2
+      queue-microtask: 1.2.3
+    dev: true
+
+  /acorn-walk/8.2.0:
+    resolution: {integrity: sha512-k+iyHEuPgSw6SbuDpGQM+06HQUa04DZ3o+F6CSzXMvvI5KMvnaEqXe+YVe555R9nn6GPt404fos4wcgpw12SDA==}
+    engines: {node: '>=0.4.0'}
+    dev: true
+
+  /acorn/8.8.0:
+    resolution: {integrity: sha512-QOxyigPVrpZ2GXT+PFyZTl6TtOFc5egxHIP9IlQ+RbupQuX4RkT/Bee4/kQuC02Xkzg84JcT7oLYtDIQxp+v7w==}
+    engines: {node: '>=0.4.0'}
+    hasBin: true
+    dev: true
+
+  /address/1.2.1:
+    resolution: {integrity: sha512-B+6bi5D34+fDYENiH5qOlA0cV2rAGKuWZ9LeyUUehbXy8e0VS9e498yO0Jeeh+iM+6KbfudHTFjXw2MmJD4QRA==}
+    engines: {node: '>= 10.0.0'}
+    dev: true
+
+  /adm-zip/0.4.16:
+    resolution: {integrity: sha512-TFi4HBKSGfIKsK5YCkKaaFG2m4PEDyViZmEwof3MTIgzimHLto6muaHVpbrljdIvIrFZzEq/p4nafOeLcYegrg==}
+    engines: {node: '>=0.3.0'}
+    dev: true
+
+  /aes-js/3.0.0:
+    resolution: {integrity: sha512-H7wUZRn8WpTq9jocdxQ2c8x2sKo9ZVmzfRE13GiNJXfp7NcKYEdvl3vspKjXox6RIG2VtaRe4JFvxG4rqp2Zuw==}
+    dev: true
+
+  /agent-base/6.0.2:
+    resolution: {integrity: sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ==}
+    engines: {node: '>= 6.0.0'}
+    dependencies:
+      debug: 4.3.4
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /aggregate-error/3.1.0:
+    resolution: {integrity: sha512-4I7Td01quW/RpocfNayFdFVk1qSuoh0E7JrbRJ16nH01HhKFQ88INq9Sd+nd72zqRySlr9BmDA8xlEJ6vJMrYA==}
+    engines: {node: '>=8'}
+    dependencies:
+      clean-stack: 2.2.0
+      indent-string: 4.0.0
+    dev: true
+
+  /ajv/6.12.6:
+    resolution: {integrity: sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==}
+    dependencies:
+      fast-deep-equal: 3.1.3
+      fast-json-stable-stringify: 2.1.0
+      json-schema-traverse: 0.4.1
+      uri-js: 4.4.1
+    dev: true
+
+  /ajv/8.11.0:
+    resolution: {integrity: sha512-wGgprdCvMalC0BztXvitD2hC04YffAvtsUn93JbGXYLAtCUO4xd17mCCZQxUOItiBwZvJScWo8NIvQMQ71rdpg==}
+    dependencies:
+      fast-deep-equal: 3.1.3
+      json-schema-traverse: 1.0.0
+      require-from-string: 2.0.2
+      uri-js: 4.4.1
+    dev: true
+
+  /amdefine/1.0.1:
+    resolution: {integrity: sha512-S2Hw0TtNkMJhIabBwIojKL9YHO5T0n5eNqWJ7Lrlel/zDbftQpxpapi8tZs3X1HWa+u+QeydGmzzNU0m09+Rcg==}
+    engines: {node: '>=0.4.2'}
+    dev: true
+    optional: true
+
+  /ansi-colors/3.2.3:
+    resolution: {integrity: sha512-LEHHyuhlPY3TmuUYMh2oz89lTShfvgbmzaBcxve9t/9Wuy7Dwf4yoAKcND7KFT1HAQfqZ12qtc+DUrBMeKF9nw==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /ansi-colors/4.1.1:
+    resolution: {integrity: sha512-JoX0apGbHaUJBNl6yF+p6JAFYZ666/hhCGKN5t9QFjbJQKUU/g8MNbFDbvfrgKXvI1QpZplPOnwIo99lX/AAmA==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /ansi-colors/4.1.3:
+    resolution: {integrity: sha512-/6w/C21Pm1A7aZitlI5Ni/2J6FFQN8i1Cvz3kHABAAbw93v/NlvKdVOqz7CCWz/3iv/JplRSEEZ83XION15ovw==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /ansi-escapes/4.3.2:
+    resolution: {integrity: sha512-gKXj5ALrKWQLsYG9jlTRmR/xKluxHV+Z9QEwNIgCfM1/uwPMCuzVVnh5mwTd+OuBZcwSIMbqssNWRm1lE51QaQ==}
+    engines: {node: '>=8'}
+    dependencies:
+      type-fest: 0.21.3
+    dev: true
+
+  /ansi-regex/3.0.1:
+    resolution: {integrity: sha512-+O9Jct8wf++lXxxFc4hc8LsjaSq0HFzzL7cVsw8pRDIPdjKD2mT4ytDZlLuSBZ4cLKZFXIrMGO7DbQCtMJJMKw==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /ansi-regex/4.1.1:
+    resolution: {integrity: sha512-ILlv4k/3f6vfQ4OoP2AGvirOktlQ98ZEL1k9FaQjxa3L1abBgbuTDAdPOpvbGncC0BTVQrl+OM8xZGK6tWXt7g==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /ansi-regex/5.0.1:
+    resolution: {integrity: sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /ansi-styles/3.2.1:
+    resolution: {integrity: sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==}
+    engines: {node: '>=4'}
+    dependencies:
+      color-convert: 1.9.3
+    dev: true
+
+  /ansi-styles/4.3.0:
+    resolution: {integrity: sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==}
+    engines: {node: '>=8'}
+    dependencies:
+      color-convert: 2.0.1
+    dev: true
+
+  /antlr4ts/0.5.0-alpha.4:
+    resolution: {integrity: sha512-WPQDt1B74OfPv/IMS2ekXAKkTZIHl88uMetg6q3OTqgFxZ/dxDXI0EWLyZid/1Pe6hTftyg5N7gel5wNAGxXyQ==}
+    dev: true
+
+  /anymatch/3.1.2:
+    resolution: {integrity: sha512-P43ePfOAIupkguHUycrc4qJ9kz8ZiuOUijaETwX7THt0Y/GNK7v0aa8rY816xWjZ7rJdA5XdMcpVFTKMq+RvWg==}
+    engines: {node: '>= 8'}
+    dependencies:
+      normalize-path: 3.0.0
+      picomatch: 2.3.1
+    dev: true
+
+  /arg/4.1.3:
+    resolution: {integrity: sha512-58S9QDqG0Xx27YwPSt9fJxivjYl432YCwfDMfZ+71RAqUrZef7LrKQZ3LHLOwCS4FLNBplP533Zx895SeOCHvA==}
+    dev: true
+
+  /argparse/1.0.10:
+    resolution: {integrity: sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==}
+    dependencies:
+      sprintf-js: 1.0.3
+    dev: true
+
+  /argparse/2.0.1:
+    resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
+    dev: true
+
+  /array-back/3.1.0:
+    resolution: {integrity: sha512-TkuxA4UCOvxuDK6NZYXCalszEzj+TLszyASooky+i742l9TqsOdYCMJJupxRic61hwquNtppB3hgcuq9SVSH1Q==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /array-back/4.0.2:
+    resolution: {integrity: sha512-NbdMezxqf94cnNfWLL7V/im0Ub+Anbb0IoZhvzie8+4HJ4nMQuzHuy49FkGYCJK2yAloZ3meiB6AVMClbrI1vg==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /array-union/2.1.0:
+    resolution: {integrity: sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /array-uniq/1.0.3:
+    resolution: {integrity: sha512-MNha4BWQ6JbwhFhj03YK552f7cb3AzoE8SzeljgChvL1dl3IcvggXVz1DilzySZkCja+CXuZbdW7yATchWn8/Q==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /array.prototype.reduce/1.0.4:
+    resolution: {integrity: sha512-WnM+AjG/DvLRLo4DDl+r+SvCzYtD2Jd9oeBYMcEaI7t3fFrHY9M53/wdLcTvmZNQ70IU6Htj0emFkZ5TS+lrdw==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      call-bind: 1.0.2
+      define-properties: 1.1.4
+      es-abstract: 1.20.4
+      es-array-method-boxes-properly: 1.0.0
+      is-string: 1.0.7
+    dev: true
+
+  /asap/2.0.6:
+    resolution: {integrity: sha512-BSHWgDSAiKs50o2Re8ppvp3seVHXSRM44cdSsT9FfNEUUZLOGWVCsiWaRPWM1Znn+mqZ1OfVZ3z3DWEzSp7hRA==}
+    dev: true
+
+  /asn1/0.2.6:
+    resolution: {integrity: sha512-ix/FxPn0MDjeyJ7i/yoHGFt/EX6LyNbxSEhPPXODPL+KB0VPk86UYfL0lMdy+KCnv+fmvIzySwaK5COwqVbWTQ==}
+    dependencies:
+      safer-buffer: 2.1.2
+    dev: true
+
+  /assert-plus/1.0.0:
+    resolution: {integrity: sha512-NfJ4UzBCcQGLDlQq7nHxH+tv3kyZ0hHQqF5BO6J7tNJeP5do1llPr8dZ8zHonfhAu0PHAdMkSo+8o0wxg9lZWw==}
+    engines: {node: '>=0.8'}
+    dev: true
+
+  /assertion-error/1.1.0:
+    resolution: {integrity: sha512-jgsaNduz+ndvGyFt3uSuWqvy4lCnIJiovtouQN5JZHOKCS2QuhEdbcQHFhVksz2N2U9hXJo8odG7ETyWlEeuDw==}
+    dev: true
+
+  /astral-regex/2.0.0:
+    resolution: {integrity: sha512-Z7tMw1ytTXt5jqMcOP+OQteU1VuNK9Y02uuJtKQ1Sv69jXQKKg5cibLwGJow8yzZP+eAc18EmLGPal0bp36rvQ==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /async-eventemitter/0.2.4:
+    resolution: {integrity: sha512-pd20BwL7Yt1zwDFy+8MX8F1+WCT8aQeKj0kQnTrH9WaeRETlRamVhD0JtRPmrV4GfOJ2F9CvdQkZeZhnh2TuHw==}
+    dependencies:
+      async: 2.6.4
+    dev: true
+
+  /async/1.5.2:
+    resolution: {integrity: sha512-nSVgobk4rv61R9PUSDtYt7mPVB2olxNR5RWJcAsH676/ef11bUZwvu7+RGYrYauVdDPcO519v68wRhXQtxsV9w==}
+    dev: true
+
+  /async/2.6.4:
+    resolution: {integrity: sha512-mzo5dfJYwAn29PeiJ0zvwTo04zj8HDJj0Mn8TD7sno7q12prdbnasKJHhkm2c1LgrhlJ0teaea8860oxi51mGA==}
+    dependencies:
+      lodash: 4.17.21
+    dev: true
+
+  /asynckit/0.4.0:
+    resolution: {integrity: sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==}
+    dev: true
+
+  /at-least-node/1.0.0:
+    resolution: {integrity: sha512-+q/t7Ekv1EDY2l6Gda6LLiX14rU9TV20Wa3ofeQmwPFZbOMo9DXrLbOjFaaclkXKWidIaopwAObQDqwWtGUjqg==}
+    engines: {node: '>= 4.0.0'}
+    dev: true
+
+  /aws-sign2/0.7.0:
+    resolution: {integrity: sha512-08kcGqnYf/YmjoRhfxyu+CLxBjUtHLXLXX/vUfx9l2LYzG3c1m61nrpyFUZI6zeS+Li/wWMMidD9KgrqtGq3mA==}
+    dev: true
+
+  /aws4/1.11.0:
+    resolution: {integrity: sha512-xh1Rl34h6Fi1DC2WWKfxUTVqRsNnr6LsKz2+hfwDxQJWmrx8+c7ylaqBMcHfl1U1r2dsifOvKX3LQuLNZ+XSvA==}
+    dev: true
+
+  /balanced-match/1.0.2:
+    resolution: {integrity: sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==}
+    dev: true
+
+  /base-x/3.0.9:
+    resolution: {integrity: sha512-H7JU6iBHTal1gp56aKoaa//YUxEaAOUiydvrV/pILqIHXTtqxSkATOnDA2u+jZ/61sD+L/412+7kzXRtWukhpQ==}
+    dependencies:
+      safe-buffer: 5.2.1
+    dev: true
+
+  /base64-js/1.5.1:
+    resolution: {integrity: sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==}
+    dev: true
+
+  /bcrypt-pbkdf/1.0.2:
+    resolution: {integrity: sha512-qeFIXtP4MSoi6NLqO12WfqARWWuCKi2Rn/9hJLEmtB5yTNr9DqFWkJRCf2qShWzPeAMRnOgCrq0sg/KLv5ES9w==}
+    dependencies:
+      tweetnacl: 0.14.5
+    dev: true
+
+  /bech32/1.1.4:
+    resolution: {integrity: sha512-s0IrSOzLlbvX7yp4WBfPITzpAU8sqQcpsmwXDiKwrG4r491vwCO/XpejasRNl0piBMe/DvP4Tz0mIS/X1DPJBQ==}
+    dev: true
+
+  /bigint-crypto-utils/3.1.7:
+    resolution: {integrity: sha512-zpCQpIE2Oy5WIQpjC9iYZf8Uh9QqoS51ZCooAcNvzv1AQ3VWdT52D0ksr1+/faeK8HVIej1bxXcP75YcqH3KPA==}
+    engines: {node: '>=10.4.0'}
+    dependencies:
+      bigint-mod-arith: 3.1.2
+    dev: true
+
+  /bigint-mod-arith/3.1.2:
+    resolution: {integrity: sha512-nx8J8bBeiRR+NlsROFH9jHswW5HO8mgfOSqW0AmjicMMvaONDa8AO+5ViKDUUNytBPWiwfvZP4/Bj4Y3lUfvgQ==}
+    engines: {node: '>=10.4.0'}
+    dev: true
+
+  /bignumber.js/9.1.0:
+    resolution: {integrity: sha512-4LwHK4nfDOraBCtst+wOWIHbu1vhvAPJK8g8nROd4iuc3PSEjWif/qwbkh8jwCJz6yDBvtU4KPynETgrfh7y3A==}
+    dev: true
+
+  /binary-extensions/2.2.0:
+    resolution: {integrity: sha512-jDctJ/IVQbZoJykoeHbhXpOlNBqGNcwXJKJog42E5HDPUwQTSdjCHdihjj0DlnheQ7blbT6dHOafNAiS8ooQKA==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /blakejs/1.2.1:
+    resolution: {integrity: sha512-QXUSXI3QVc/gJME0dBpXrag1kbzOqCjCX8/b54ntNyW6sjtoqxqRk3LTmXzaJoh71zMsDCjM+47jS7XiwN/+fQ==}
+    dev: true
+
+  /bn.js/4.11.6:
+    resolution: {integrity: sha512-XWwnNNFCuuSQ0m3r3C4LE3EiORltHd9M05pq6FOlVeiophzRbMo50Sbz1ehl8K3Z+jw9+vmgnXefY1hz8X+2wA==}
+    dev: true
+
+  /bn.js/4.12.0:
+    resolution: {integrity: sha512-c98Bf3tPniI+scsdk237ku1Dc3ujXQTSgyiPUDEOe7tRkhrqridvh8klBv0HCEso1OLOYcHuCv/cS6DNxKH+ZA==}
+    dev: true
+
+  /bn.js/5.2.1:
+    resolution: {integrity: sha512-eXRvHzWyYPBuB4NBy0cmYQjGitUrtqwbvlzP3G6VFnNRbsZQIxQ10PbKKHt8gZ/HW/D/747aDl+QkDqg3KQLMQ==}
+    dev: true
+
+  /brace-expansion/1.1.11:
+    resolution: {integrity: sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==}
+    dependencies:
+      balanced-match: 1.0.2
+      concat-map: 0.0.1
+    dev: true
+
+  /brace-expansion/2.0.1:
+    resolution: {integrity: sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==}
+    dependencies:
+      balanced-match: 1.0.2
+    dev: true
+
+  /braces/3.0.2:
+    resolution: {integrity: sha512-b8um+L1RzM3WDSzvhm6gIz1yfTbBt6YTlcEKAvsmqCZZFw46z626lVj9j1yEPW33H5H+lBQpZMP1k8l+78Ha0A==}
+    engines: {node: '>=8'}
+    dependencies:
+      fill-range: 7.0.1
+    dev: true
+
+  /brorand/1.1.0:
+    resolution: {integrity: sha512-cKV8tMCEpQs4hK/ik71d6LrPOnpkpGBR0wzxqr68g2m/LB2GxVYQroAjMJZRVM1Y4BCjCKc3vAamxSzOY2RP+w==}
+    dev: true
+
+  /browser-level/1.0.1:
+    resolution: {integrity: sha512-XECYKJ+Dbzw0lbydyQuJzwNXtOpbMSq737qxJN11sIRTErOMShvDpbzTlgju7orJKvx4epULolZAuJGLzCmWRQ==}
+    dependencies:
+      abstract-level: 1.0.3
+      catering: 2.1.1
+      module-error: 1.0.2
+      run-parallel-limit: 1.1.0
+    dev: true
+
+  /browser-stdout/1.3.1:
+    resolution: {integrity: sha512-qhAVI1+Av2X7qelOfAIYwXONood6XlZE/fXaBSmW/T5SzLAmCgzi+eiWE7fUvbHaeNBQH13UftjpXxsfLkMpgw==}
+    dev: true
+
+  /browserify-aes/1.2.0:
+    resolution: {integrity: sha512-+7CHXqGuspUn/Sl5aO7Ea0xWGAtETPXNSAjHo48JfLdPWcMng33Xe4znFvQweqc/uzk5zSOI3H52CYnjCfb5hA==}
+    dependencies:
+      buffer-xor: 1.0.3
+      cipher-base: 1.0.4
+      create-hash: 1.2.0
+      evp_bytestokey: 1.0.3
+      inherits: 2.0.4
+      safe-buffer: 5.2.1
+    dev: true
+
+  /bs58/4.0.1:
+    resolution: {integrity: sha512-Ok3Wdf5vOIlBrgCvTq96gBkJw+JUEzdBgyaza5HLtPm7yTHkjRy8+JzNyHF7BHa0bNWOQIp3m5YF0nnFcOIKLw==}
+    dependencies:
+      base-x: 3.0.9
+    dev: true
+
+  /bs58check/2.1.2:
+    resolution: {integrity: sha512-0TS1jicxdU09dwJMNZtVAfzPi6Q6QeN0pM1Fkzrjn+XYHvzMKPU3pHVpva+769iNVSfIYWf7LJ6WR+BuuMf8cA==}
+    dependencies:
+      bs58: 4.0.1
+      create-hash: 1.2.0
+      safe-buffer: 5.2.1
+    dev: true
+
+  /buffer-from/1.1.2:
+    resolution: {integrity: sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==}
+    dev: true
+
+  /buffer-xor/1.0.3:
+    resolution: {integrity: sha512-571s0T7nZWK6vB67HI5dyUF7wXiNcfaPPPTl6zYCNApANjIvYJTg7hlud/+cJpdAhS7dVzqMLmfhfHR3rAcOjQ==}
+    dev: true
+
+  /buffer/6.0.3:
+    resolution: {integrity: sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==}
+    dependencies:
+      base64-js: 1.5.1
+      ieee754: 1.2.1
+    dev: true
+
+  /busboy/1.6.0:
+    resolution: {integrity: sha512-8SFQbg/0hQ9xy3UNTB0YEnsNBbWfhf7RtnzpL7TkBiTBRfrQ9Fxcnz7VJsleJpyp6rVLvXiuORqjlHi5q+PYuA==}
+    engines: {node: '>=10.16.0'}
+    dependencies:
+      streamsearch: 1.1.0
+    dev: true
+
+  /bytes/3.1.2:
+    resolution: {integrity: sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==}
+    engines: {node: '>= 0.8'}
+    dev: true
+
+  /call-bind/1.0.2:
+    resolution: {integrity: sha512-7O+FbCihrB5WGbFYesctwmTKae6rOiIzmz1icreWJ+0aA7LJfuqhEso2T9ncpcFtzMQtzXf2QGGueWJGTYsqrA==}
+    dependencies:
+      function-bind: 1.1.1
+      get-intrinsic: 1.1.3
+    dev: true
+
+  /camelcase/5.3.1:
+    resolution: {integrity: sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /camelcase/6.3.0:
+    resolution: {integrity: sha512-Gmy6FhYlCY7uOElZUSbxo2UCDH8owEk996gkbrpsgGtrJLM3J7jGxl9Ic7Qwwj4ivOE5AWZWRMecDdF7hqGjFA==}
+    engines: {node: '>=10'}
+    dev: true
+
+  /caseless/0.12.0:
+    resolution: {integrity: sha512-4tYFyifaFfGacoiObjJegolkwSU4xQNGbVgUiNYVUxbQ2x2lUsFvY4hVgVzGiIe6WLOPqycWXA40l+PWsxthUw==}
+    dev: true
+
+  /catering/2.1.1:
+    resolution: {integrity: sha512-K7Qy8O9p76sL3/3m7/zLKbRkyOlSZAgzEaLhyj2mXS8PsCud2Eo4hAb8aLtZqHh0QGqLcb9dlJSu6lHRVENm1w==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /cbor/5.2.0:
+    resolution: {integrity: sha512-5IMhi9e1QU76ppa5/ajP1BmMWZ2FHkhAhjeVKQ/EFCgYSEaeVaoGtL7cxJskf9oCCk+XjzaIdc3IuU/dbA/o2A==}
+    engines: {node: '>=6.0.0'}
+    dependencies:
+      bignumber.js: 9.1.0
+      nofilter: 1.0.4
+    dev: true
+
+  /chai-as-promised/7.1.1_chai@4.3.6:
+    resolution: {integrity: sha512-azL6xMoi+uxu6z4rhWQ1jbdUhOMhis2PvscD/xjLqNMkv3BPPp2JyyuTHOrf9BOosGpNQ11v6BKv/g57RXbiaA==}
+    peerDependencies:
+      chai: '>= 2.1.2 < 5'
+    dependencies:
+      chai: 4.3.6
+      check-error: 1.0.2
+    dev: true
+
+  /chai/4.3.6:
+    resolution: {integrity: sha512-bbcp3YfHCUzMOvKqsztczerVgBKSsEijCySNlHHbX3VG1nskvqjz5Rfso1gGwD6w6oOV3eI60pKuMOV5MV7p3Q==}
+    engines: {node: '>=4'}
+    dependencies:
+      assertion-error: 1.1.0
+      check-error: 1.0.2
+      deep-eql: 3.0.1
+      get-func-name: 2.0.0
+      loupe: 2.3.4
+      pathval: 1.1.1
+      type-detect: 4.0.8
+    dev: true
+
+  /chalk/2.4.2:
+    resolution: {integrity: sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==}
+    engines: {node: '>=4'}
+    dependencies:
+      ansi-styles: 3.2.1
+      escape-string-regexp: 1.0.5
+      supports-color: 5.5.0
+    dev: true
+
+  /chalk/4.1.2:
+    resolution: {integrity: sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==}
+    engines: {node: '>=10'}
+    dependencies:
+      ansi-styles: 4.3.0
+      supports-color: 7.2.0
+    dev: true
+
+  /charenc/0.0.2:
+    resolution: {integrity: sha512-yrLQ/yVUFXkzg7EDQsPieE/53+0RlaWTs+wBrvW36cyilJ2SaDWfl4Yj7MtLTXleV9uEKefbAGUPv2/iWSooRA==}
+    dev: true
+
+  /check-error/1.0.2:
+    resolution: {integrity: sha512-BrgHpW9NURQgzoNyjfq0Wu6VFO6D7IZEmJNdtgNqpzGG8RuNFHt2jQxWlAs4HMe119chBnv+34syEZtc6IhLtA==}
+    dev: true
+
+  /chokidar/3.3.0:
+    resolution: {integrity: sha512-dGmKLDdT3Gdl7fBUe8XK+gAtGmzy5Fn0XkkWQuYxGIgWVPPse2CxFA5mtrlD0TOHaHjEUqkWNyP1XdHoJES/4A==}
+    engines: {node: '>= 8.10.0'}
+    dependencies:
+      anymatch: 3.1.2
+      braces: 3.0.2
+      glob-parent: 5.1.2
+      is-binary-path: 2.1.0
+      is-glob: 4.0.3
+      normalize-path: 3.0.0
+      readdirp: 3.2.0
+    optionalDependencies:
+      fsevents: 2.1.3
+    dev: true
+
+  /chokidar/3.5.3:
+    resolution: {integrity: sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw==}
+    engines: {node: '>= 8.10.0'}
+    dependencies:
+      anymatch: 3.1.2
+      braces: 3.0.2
+      glob-parent: 5.1.2
+      is-binary-path: 2.1.0
+      is-glob: 4.0.3
+      normalize-path: 3.0.0
+      readdirp: 3.6.0
+    optionalDependencies:
+      fsevents: 2.3.2
+    dev: true
+
+  /ci-info/2.0.0:
+    resolution: {integrity: sha512-5tK7EtrZ0N+OLFMthtqOj4fI2Jeb88C4CAZPu25LDVUgXJ0A3Js4PMGqrn0JU1W0Mh1/Z8wZzYPxqUrXeBboCQ==}
+    dev: true
+
+  /cipher-base/1.0.4:
+    resolution: {integrity: sha512-Kkht5ye6ZGmwv40uUDZztayT2ThLQGfnj/T71N/XzeZeo3nf8foyW7zGTsPYkEya3m5f3cAypH+qe7YOrM1U2Q==}
+    dependencies:
+      inherits: 2.0.4
+      safe-buffer: 5.2.1
+    dev: true
+
+  /classic-level/1.2.0:
+    resolution: {integrity: sha512-qw5B31ANxSluWz9xBzklRWTUAJ1SXIdaVKTVS7HcTGKOAmExx65Wo5BUICW+YGORe2FOUaDghoI9ZDxj82QcFg==}
+    engines: {node: '>=12'}
+    requiresBuild: true
+    dependencies:
+      abstract-level: 1.0.3
+      catering: 2.1.1
+      module-error: 1.0.2
+      napi-macros: 2.0.0
+      node-gyp-build: 4.5.0
+    dev: true
+
+  /clean-stack/2.2.0:
+    resolution: {integrity: sha512-4diC9HaTE+KRAMWhDhrGOECgWZxoevMc5TlkObMqNSsVU62PYzXZ/SMTjzyGAFF1YusgxGcSWTEXBhp0CPwQ1A==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /cli-table3/0.5.1:
+    resolution: {integrity: sha512-7Qg2Jrep1S/+Q3EceiZtQcDPWxhAvBw+ERf1162v4sikJrvojMHFqXt8QIVha8UlH9rgU0BeWPytZ9/TzYqlUw==}
+    engines: {node: '>=6'}
+    dependencies:
+      object-assign: 4.1.1
+      string-width: 2.1.1
+    optionalDependencies:
+      colors: 1.4.0
+    dev: true
+
+  /cliui/5.0.0:
+    resolution: {integrity: sha512-PYeGSEmmHM6zvoef2w8TPzlrnNpXIjTipYK780YswmIP9vjxmd6Y2a3CB2Ks6/AU8NHjZugXvo8w3oWM2qnwXA==}
+    dependencies:
+      string-width: 3.1.0
+      strip-ansi: 5.2.0
+      wrap-ansi: 5.1.0
+    dev: true
+
+  /cliui/7.0.4:
+    resolution: {integrity: sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==}
+    dependencies:
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+      wrap-ansi: 7.0.0
+    dev: true
+
+  /color-convert/1.9.3:
+    resolution: {integrity: sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==}
+    dependencies:
+      color-name: 1.1.3
+    dev: true
+
+  /color-convert/2.0.1:
+    resolution: {integrity: sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==}
+    engines: {node: '>=7.0.0'}
+    dependencies:
+      color-name: 1.1.4
+    dev: true
+
+  /color-name/1.1.3:
+    resolution: {integrity: sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==}
+    dev: true
+
+  /color-name/1.1.4:
+    resolution: {integrity: sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==}
+    dev: true
+
+  /colors/1.4.0:
+    resolution: {integrity: sha512-a+UqTh4kgZg/SlGvfbzDHpgRu7AAQOmmqRHJnxhRZICKFUT91brVhNNt58CMWU9PsBbv3PDCZUHbVxuDiH2mtA==}
+    engines: {node: '>=0.1.90'}
+    dev: true
+
+  /combined-stream/1.0.8:
+    resolution: {integrity: sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==}
+    engines: {node: '>= 0.8'}
+    dependencies:
+      delayed-stream: 1.0.0
+    dev: true
+
+  /command-exists/1.2.9:
+    resolution: {integrity: sha512-LTQ/SGc+s0Xc0Fu5WaKnR0YiygZkm9eKFvyS+fRsU7/ZWFF8ykFM6Pc9aCVf1+xasOOZpO3BAVgVrKvsqKHV7w==}
+    dev: true
+
+  /command-line-args/5.2.1:
+    resolution: {integrity: sha512-H4UfQhZyakIjC74I9d34fGYDwk3XpSr17QhEd0Q3I9Xq1CETHo4Hcuo87WyWHpAF1aSLjLRf5lD9ZGX2qStUvg==}
+    engines: {node: '>=4.0.0'}
+    dependencies:
+      array-back: 3.1.0
+      find-replace: 3.0.0
+      lodash.camelcase: 4.3.0
+      typical: 4.0.0
+    dev: true
+
+  /command-line-usage/6.1.3:
+    resolution: {integrity: sha512-sH5ZSPr+7UStsloltmDh7Ce5fb8XPlHyoPzTpyyMuYCtervL65+ubVZ6Q61cFtFl62UyJlc8/JwERRbAFPUqgw==}
+    engines: {node: '>=8.0.0'}
+    dependencies:
+      array-back: 4.0.2
+      chalk: 2.4.2
+      table-layout: 1.0.2
+      typical: 5.2.0
+    dev: true
+
+  /commander/3.0.2:
+    resolution: {integrity: sha512-Gar0ASD4BDyKC4hl4DwHqDrmvjoxWKZigVnAbn5H1owvm4CxCPdb0HQDehwNYMJpla5+M2tPmPARzhtYuwpHow==}
+    dev: true
+
+  /concat-map/0.0.1:
+    resolution: {integrity: sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=}
+    dev: true
+
+  /concat-stream/1.6.2:
+    resolution: {integrity: sha512-27HBghJxjiZtIk3Ycvn/4kbJk/1uZuJFfuPEns6LaEvpvG1f0hTea8lilrouyo9mVc2GWdcEZ8OLoGmSADlrCw==}
+    engines: {'0': node >= 0.8}
+    dependencies:
+      buffer-from: 1.1.2
+      inherits: 2.0.4
+      readable-stream: 2.3.7
+      typedarray: 0.0.6
+    dev: true
+
+  /cookie/0.4.2:
+    resolution: {integrity: sha512-aSWTXFzaKWkvHO1Ny/s+ePFpvKsPnjc551iI41v3ny/ow6tBG5Vd+FuqGNhh1LxOmVzOlGUriIlOaokOvhaStA==}
+    engines: {node: '>= 0.6'}
+    dev: true
+
+  /core-util-is/1.0.2:
+    resolution: {integrity: sha512-3lqz5YjWTYnW6dlDa5TLaTCcShfar1e40rmcJVwCBJC6mWlFuj0eCHIElmG1g5kyuJ/GD+8Wn4FFCcz4gJPfaQ==}
+    dev: true
+
+  /core-util-is/1.0.3:
+    resolution: {integrity: sha512-ZQBvi1DcpJ4GDqanjucZ2Hj3wEO5pZDS89BWbkcrvdxksJorwUDDZamX9ldFkp9aw2lmBDLgkObEA4DWNJ9FYQ==}
+    dev: true
+
+  /crc-32/1.2.2:
+    resolution: {integrity: sha512-ROmzCKrTnOwybPcJApAA6WBWij23HVfGVNKqqrZpuyZOHqK2CwHSvpGuyt/UNNvaIjEd8X5IFGp4Mh+Ie1IHJQ==}
+    engines: {node: '>=0.8'}
+    hasBin: true
+    dev: true
+
+  /create-hash/1.2.0:
+    resolution: {integrity: sha512-z00bCGNHDG8mHAkP7CtT1qVu+bFQUPjYq/4Iv3C3kWjTFV10zIjfSoeqXo9Asws8gwSHDGj/hl2u4OGIjapeCg==}
+    dependencies:
+      cipher-base: 1.0.4
+      inherits: 2.0.4
+      md5.js: 1.3.5
+      ripemd160: 2.0.2
+      sha.js: 2.4.11
+    dev: true
+
+  /create-hmac/1.1.7:
+    resolution: {integrity: sha512-MJG9liiZ+ogc4TzUwuvbER1JRdgvUFSB5+VR/g5h82fGaIRWMWddtKBHi7/sVhfjQZ6SehlyhvQYrcYkaUIpLg==}
+    dependencies:
+      cipher-base: 1.0.4
+      create-hash: 1.2.0
+      inherits: 2.0.4
+      ripemd160: 2.0.2
+      safe-buffer: 5.2.1
+      sha.js: 2.4.11
+    dev: true
+
+  /create-require/1.1.1:
+    resolution: {integrity: sha512-dcKFX3jn0MpIaXjisoRvexIJVEKzaq7z2rZKxf+MSr9TkdmHmsU4m2lcLojrj/FHl8mk5VxMmYA+ftRkP/3oKQ==}
+    dev: true
+
+  /crypt/0.0.2:
+    resolution: {integrity: sha512-mCxBlsHFYh9C+HVpiEacem8FEBnMXgU9gy4zmNC+SXAZNB/1idgp/aulFJ4FgCi7GPEVbfyng092GqL2k2rmow==}
+    dev: true
+
+  /dashdash/1.14.1:
+    resolution: {integrity: sha512-jRFi8UDGo6j+odZiEpjazZaWqEal3w/basFjQHQEwVtZJGDpxbH1MeYluwCS8Xq5wmLJooDlMgvVarmWfGM44g==}
+    engines: {node: '>=0.10'}
+    dependencies:
+      assert-plus: 1.0.0
+    dev: true
+
+  /death/1.1.0:
+    resolution: {integrity: sha512-vsV6S4KVHvTGxbEcij7hkWRv0It+sGGWVOM67dQde/o5Xjnr+KmLjxWJii2uEObIrt1CcM9w0Yaovx+iOlIL+w==}
+    dev: true
+
+  /debug/3.2.6_supports-color@6.0.0:
+    resolution: {integrity: sha512-mel+jf7nrtEl5Pn1Qx46zARXKDpBbvzezse7p7LqINmdoIk8PYP5SySaxEmYv6TZ0JyEKA1hsCId6DIhgITtWQ==}
+    deprecated: Debug versions >=3.2.0 <3.2.7 || >=4 <4.3.1 have a low-severity ReDos regression when used in a Node.js environment. It is recommended you upgrade to 3.2.7 or 4.3.1. (https://github.com/visionmedia/debug/issues/797)
+    peerDependencies:
+      supports-color: '*'
+    peerDependenciesMeta:
+      supports-color:
+        optional: true
+    dependencies:
+      ms: 2.1.3
+      supports-color: 6.0.0
+    dev: true
+
+  /debug/4.3.4:
+    resolution: {integrity: sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==}
+    engines: {node: '>=6.0'}
+    peerDependencies:
+      supports-color: '*'
+    peerDependenciesMeta:
+      supports-color:
+        optional: true
+    dependencies:
+      ms: 2.1.2
+    dev: true
+
+  /debug/4.3.4_supports-color@8.1.1:
+    resolution: {integrity: sha512-PRWFHuSU3eDtQJPvnNY7Jcket1j0t5OuOsFzPPzsekD52Zl8qUfFIPEiswXqIvHWGVHOgX+7G/vCNNhehwxfkQ==}
+    engines: {node: '>=6.0'}
+    peerDependencies:
+      supports-color: '*'
+    peerDependenciesMeta:
+      supports-color:
+        optional: true
+    dependencies:
+      ms: 2.1.2
+      supports-color: 8.1.1
+    dev: true
+
+  /decamelize/1.2.0:
+    resolution: {integrity: sha512-z2S+W9X73hAUUki+N+9Za2lBlun89zigOyGrsax+KUQ6wKW4ZoWpEYBkGhQjwAjjDCkWxhY0VKEhk8wzY7F5cA==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /decamelize/4.0.0:
+    resolution: {integrity: sha512-9iE1PgSik9HeIIw2JO94IidnE3eBoQrFJ3w7sFuzSX4DpmZ3v5sZpUiV5Swcf6mQEF+Y0ru8Neo+p+nyh2J+hQ==}
+    engines: {node: '>=10'}
+    dev: true
+
+  /deep-eql/3.0.1:
+    resolution: {integrity: sha512-+QeIQyN5ZuO+3Uk5DYh6/1eKO0m0YmJFGNmFHGACpf1ClL1nmlV/p4gNgbl2pJGxgXb4faqo6UE+M5ACEMyVcw==}
+    engines: {node: '>=0.12'}
+    dependencies:
+      type-detect: 4.0.8
+    dev: true
+
+  /deep-eql/4.1.1:
+    resolution: {integrity: sha512-rc6HkZswtl+KMi/IODZ8k7C/P37clC2Rf1HYI11GqdbgvggIyHjsU5MdjlTlaP6eu24c0sR3mcW2SqsVZ1sXUw==}
+    engines: {node: '>=6'}
+    dependencies:
+      type-detect: 4.0.8
+    dev: true
+
+  /deep-extend/0.6.0:
+    resolution: {integrity: sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA==}
+    engines: {node: '>=4.0.0'}
+    dev: true
+
+  /deep-is/0.1.4:
+    resolution: {integrity: sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==}
+    dev: true
+
+  /define-properties/1.1.4:
+    resolution: {integrity: sha512-uckOqKcfaVvtBdsVkdPv3XjveQJsNQqmhXgRi8uhvWWuPYZCNlzT8qAyblUgNoXdHdjMTzAqeGjAoli8f+bzPA==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      has-property-descriptors: 1.0.0
+      object-keys: 1.1.1
+    dev: true
+
+  /delayed-stream/1.0.0:
+    resolution: {integrity: sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==}
+    engines: {node: '>=0.4.0'}
+    dev: true
+
+  /depd/2.0.0:
+    resolution: {integrity: sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==}
+    engines: {node: '>= 0.8'}
+    dev: true
+
+  /detect-port/1.5.1:
+    resolution: {integrity: sha512-aBzdj76lueB6uUst5iAs7+0H/oOjqI5D16XUWxlWMIMROhcM0rfsNVk93zTngq1dDNpoXRr++Sus7ETAExppAQ==}
+    hasBin: true
+    dependencies:
+      address: 1.2.1
+      debug: 4.3.4
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /diff/3.5.0:
+    resolution: {integrity: sha512-A46qtFgd+g7pDZinpnwiRJtxbC1hpgf0uzP3iG89scHk0AUC7A1TGxf5OiiOUv/JMZR8GOt8hL900hV0bOy5xA==}
+    engines: {node: '>=0.3.1'}
+    dev: true
+
+  /diff/4.0.2:
+    resolution: {integrity: sha512-58lmxKSA4BNyLz+HHMUzlOEpg09FV+ev6ZMe3vJihgdxzgcwZ8VoEEPmALCZG9LmqfVoNMMKpttIYTVG6uDY7A==}
+    engines: {node: '>=0.3.1'}
+    dev: true
+
+  /diff/5.0.0:
+    resolution: {integrity: sha512-/VTCrvm5Z0JGty/BWHljh+BAiw3IK+2j87NGMu8Nwc/f48WoDAC395uomO9ZD117ZOBaHmkX1oyLvkVM/aIT3w==}
+    engines: {node: '>=0.3.1'}
+    dev: true
+
+  /difflib/0.2.4:
+    resolution: {integrity: sha512-9YVwmMb0wQHQNr5J9m6BSj6fk4pfGITGQOOs+D9Fl+INODWFOfvhIU1hNv6GgR1RBoC/9NJcwu77zShxV0kT7w==}
+    dependencies:
+      heap: 0.2.7
+    dev: true
+
+  /dir-glob/3.0.1:
+    resolution: {integrity: sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==}
+    engines: {node: '>=8'}
+    dependencies:
+      path-type: 4.0.0
+    dev: true
+
+  /ecc-jsbn/0.1.2:
+    resolution: {integrity: sha512-eh9O+hwRHNbG4BLTjEl3nw044CkGm5X6LoaCf7LPp7UU8Qrt47JYNi6nPX8xjW97TKGKm1ouctg0QSpZe9qrnw==}
+    dependencies:
+      jsbn: 0.1.1
+      safer-buffer: 2.1.2
+    dev: true
+
+  /elliptic/6.5.4:
+    resolution: {integrity: sha512-iLhC6ULemrljPZb+QutR5TQGB+pdW6KGD5RSegS+8sorOZT+rdQFbsQFJgvN3eRqNALqJer4oQ16YvJHlU8hzQ==}
+    dependencies:
+      bn.js: 4.12.0
+      brorand: 1.1.0
+      hash.js: 1.1.7
+      hmac-drbg: 1.0.1
+      inherits: 2.0.4
+      minimalistic-assert: 1.0.1
+      minimalistic-crypto-utils: 1.0.1
+    dev: true
+
+  /emoji-regex/7.0.3:
+    resolution: {integrity: sha512-CwBLREIQ7LvYFB0WyRvwhq5N5qPhc6PMjD6bYggFlI5YyDgl+0vxq5VHbMOFqLg7hfWzmu8T5Z1QofhmTIhItA==}
+    dev: true
+
+  /emoji-regex/8.0.0:
+    resolution: {integrity: sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==}
+    dev: true
+
+  /enquirer/2.3.6:
+    resolution: {integrity: sha512-yjNnPr315/FjS4zIsUxYguYUPP2e1NK4d7E7ZOLiyYCcbFBiTMyID+2wvm2w6+pZ/odMA7cRkjhsPbltwBOrLg==}
+    engines: {node: '>=8.6'}
+    dependencies:
+      ansi-colors: 4.1.3
+    dev: true
+
+  /env-paths/2.2.1:
+    resolution: {integrity: sha512-+h1lkLKhZMTYjog1VEpJNG7NZJWcuc2DDk/qsqSTRRCOXiLjeQ1d1/udrUGhqMxUgAlwKNZ0cf2uqan5GLuS2A==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /es-abstract/1.20.4:
+    resolution: {integrity: sha512-0UtvRN79eMe2L+UNEF1BwRe364sj/DXhQ/k5FmivgoSdpM90b8Jc0mDzKMGo7QS0BVbOP/bTwBKNnDc9rNzaPA==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      call-bind: 1.0.2
+      es-to-primitive: 1.2.1
+      function-bind: 1.1.1
+      function.prototype.name: 1.1.5
+      get-intrinsic: 1.1.3
+      get-symbol-description: 1.0.0
+      has: 1.0.3
+      has-property-descriptors: 1.0.0
+      has-symbols: 1.0.3
+      internal-slot: 1.0.3
+      is-callable: 1.2.7
+      is-negative-zero: 2.0.2
+      is-regex: 1.1.4
+      is-shared-array-buffer: 1.0.2
+      is-string: 1.0.7
+      is-weakref: 1.0.2
+      object-inspect: 1.12.2
+      object-keys: 1.1.1
+      object.assign: 4.1.4
+      regexp.prototype.flags: 1.4.3
+      safe-regex-test: 1.0.0
+      string.prototype.trimend: 1.0.5
+      string.prototype.trimstart: 1.0.5
+      unbox-primitive: 1.0.2
+    dev: true
+
+  /es-array-method-boxes-properly/1.0.0:
+    resolution: {integrity: sha512-wd6JXUmyHmt8T5a2xreUwKcGPq6f1f+WwIJkijUqiGcJz1qqnZgP6XIK+QyIWU5lT7imeNxUll48bziG+TSYcA==}
+    dev: true
+
+  /es-to-primitive/1.2.1:
+    resolution: {integrity: sha512-QCOllgZJtaUo9miYBcLChTUaHNjJF3PYs1VidD7AwiEj1kYxKeQTctLAezAOH5ZKRH0g2IgPn6KwB4IT8iRpvA==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      is-callable: 1.2.7
+      is-date-object: 1.0.5
+      is-symbol: 1.0.4
+    dev: true
+
+  /escalade/3.1.1:
+    resolution: {integrity: sha512-k0er2gUkLf8O0zKJiAhmkTnJlTvINGv7ygDNPbeIsX/TJjGJZHuh9B2UxbsaEkmlEo9MfhrSzmhIlhRlI2GXnw==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /escape-string-regexp/1.0.5:
+    resolution: {integrity: sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==}
+    engines: {node: '>=0.8.0'}
+    dev: true
+
+  /escape-string-regexp/4.0.0:
+    resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==}
+    engines: {node: '>=10'}
+    dev: true
+
+  /escodegen/1.8.1:
+    resolution: {integrity: sha512-yhi5S+mNTOuRvyW4gWlg5W1byMaQGWWSYHXsuFZ7GBo7tpyOwi2EdzMP/QWxh9hwkD2m+wDVHJsxhRIj+v/b/A==}
+    engines: {node: '>=0.12.0'}
+    hasBin: true
+    dependencies:
+      esprima: 2.7.3
+      estraverse: 1.9.3
+      esutils: 2.0.3
+      optionator: 0.8.3
+    optionalDependencies:
+      source-map: 0.2.0
+    dev: true
+
+  /esprima/2.7.3:
+    resolution: {integrity: sha512-OarPfz0lFCiW4/AV2Oy1Rp9qu0iusTKqykwTspGCZtPxmF81JR4MmIebvF1F9+UOKth2ZubLQ4XGGaU+hSn99A==}
+    engines: {node: '>=0.10.0'}
+    hasBin: true
+    dev: true
+
+  /esprima/4.0.1:
+    resolution: {integrity: sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==}
+    engines: {node: '>=4'}
+    hasBin: true
+    dev: true
+
+  /estraverse/1.9.3:
+    resolution: {integrity: sha512-25w1fMXQrGdoquWnScXZGckOv+Wes+JDnuN/+7ex3SauFRS72r2lFDec0EKPt2YD1wUJ/IrfEex+9yp4hfSOJA==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /esutils/2.0.3:
+    resolution: {integrity: sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /eth-gas-reporter/0.2.25:
+    resolution: {integrity: sha512-1fRgyE4xUB8SoqLgN3eDfpDfwEfRxh2Sz1b7wzFbyQA+9TekMmvSjjoRu9SKcSVyK+vLkLIsVbJDsTWjw195OQ==}
+    peerDependencies:
+      '@codechecks/client': ^0.1.0
+    peerDependenciesMeta:
+      '@codechecks/client':
+        optional: true
+    dependencies:
+      '@ethersproject/abi': 5.7.0
+      '@solidity-parser/parser': 0.14.3
+      cli-table3: 0.5.1
+      colors: 1.4.0
+      ethereum-cryptography: 1.1.2
+      ethers: 4.0.49
+      fs-readdir-recursive: 1.1.0
+      lodash: 4.17.21
+      markdown-table: 1.1.3
+      mocha: 7.2.0
+      req-cwd: 2.0.0
+      request: 2.88.2
+      request-promise-native: 1.0.9_request@2.88.2
+      sha1: 1.1.1
+      sync-request: 6.1.0
+    dev: true
+
+  /ethereum-bloom-filters/1.0.10:
+    resolution: {integrity: sha512-rxJ5OFN3RwjQxDcFP2Z5+Q9ho4eIdEmSc2ht0fCu8Se9nbXjZ7/031uXoUYJ87KHCOdVeiUuwSnoS7hmYAGVHA==}
+    dependencies:
+      js-sha3: 0.8.0
+    dev: true
+
+  /ethereum-cryptography/0.1.3:
+    resolution: {integrity: sha512-w8/4x1SGGzc+tO97TASLja6SLd3fRIK2tLVcV2Gx4IB21hE19atll5Cq9o3d0ZmAYC/8aw0ipieTSiekAea4SQ==}
+    dependencies:
+      '@types/pbkdf2': 3.1.0
+      '@types/secp256k1': 4.0.3
+      blakejs: 1.2.1
+      browserify-aes: 1.2.0
+      bs58check: 2.1.2
+      create-hash: 1.2.0
+      create-hmac: 1.1.7
+      hash.js: 1.1.7
+      keccak: 3.0.2
+      pbkdf2: 3.1.2
+      randombytes: 2.1.0
+      safe-buffer: 5.2.1
+      scrypt-js: 3.0.1
+      secp256k1: 4.0.3
+      setimmediate: 1.0.5
+    dev: true
+
+  /ethereum-cryptography/1.1.2:
+    resolution: {integrity: sha512-XDSJlg4BD+hq9N2FjvotwUET9Tfxpxc3kWGE2AqUG5vcbeunnbImVk3cj6e/xT3phdW21mE8R5IugU4fspQDcQ==}
+    dependencies:
+      '@noble/hashes': 1.1.2
+      '@noble/secp256k1': 1.6.3
+      '@scure/bip32': 1.1.0
+      '@scure/bip39': 1.1.0
+    dev: true
+
+  /ethereumjs-abi/0.6.8:
+    resolution: {integrity: sha512-Tx0r/iXI6r+lRsdvkFDlut0N08jWMnKRZ6Gkq+Nmw75lZe4e6o3EkSnkaBP5NF6+m5PTGAr9JP43N3LyeoglsA==}
+    dependencies:
+      bn.js: 4.12.0
+      ethereumjs-util: 6.2.1
+    dev: true
+
+  /ethereumjs-util/6.2.1:
+    resolution: {integrity: sha512-W2Ktez4L01Vexijrm5EB6w7dg4n/TgpoYU4avuT5T3Vmnw/eCRtiBrJfQYS/DCSvDIOLn2k57GcHdeBcgVxAqw==}
+    dependencies:
+      '@types/bn.js': 4.11.6
+      bn.js: 4.12.0
+      create-hash: 1.2.0
+      elliptic: 6.5.4
+      ethereum-cryptography: 0.1.3
+      ethjs-util: 0.1.6
+      rlp: 2.2.7
+    dev: true
+
+  /ethereumjs-util/7.1.5:
+    resolution: {integrity: sha512-SDl5kKrQAudFBUe5OJM9Ac6WmMyYmXX/6sTmLZ3ffG2eY6ZIGBes3pEDxNN6V72WyOw4CPD5RomKdsa8DAAwLg==}
+    engines: {node: '>=10.0.0'}
+    dependencies:
+      '@types/bn.js': 5.1.1
+      bn.js: 5.2.1
+      create-hash: 1.2.0
+      ethereum-cryptography: 0.1.3
+      rlp: 2.2.7
+    dev: true
+
+  /ethers/4.0.49:
+    resolution: {integrity: sha512-kPltTvWiyu+OktYy1IStSO16i2e7cS9D9OxZ81q2UUaiNPVrm/RTcbxamCXF9VUSKzJIdJV68EAIhTEVBalRWg==}
+    dependencies:
+      aes-js: 3.0.0
+      bn.js: 4.12.0
+      elliptic: 6.5.4
+      hash.js: 1.1.3
+      js-sha3: 0.5.7
+      scrypt-js: 2.0.4
+      setimmediate: 1.0.4
+      uuid: 2.0.1
+      xmlhttprequest: 1.8.0
+    dev: true
+
+  /ethers/5.7.1:
+    resolution: {integrity: sha512-5krze4dRLITX7FpU8J4WscXqADiKmyeNlylmmDLbS95DaZpBhDe2YSwRQwKXWNyXcox7a3gBgm/MkGXV1O1S/Q==}
+    dependencies:
+      '@ethersproject/abi': 5.7.0
+      '@ethersproject/abstract-provider': 5.7.0
+      '@ethersproject/abstract-signer': 5.7.0
+      '@ethersproject/address': 5.7.0
+      '@ethersproject/base64': 5.7.0
+      '@ethersproject/basex': 5.7.0
+      '@ethersproject/bignumber': 5.7.0
+      '@ethersproject/bytes': 5.7.0
+      '@ethersproject/constants': 5.7.0
+      '@ethersproject/contracts': 5.7.0
+      '@ethersproject/hash': 5.7.0
+      '@ethersproject/hdnode': 5.7.0
+      '@ethersproject/json-wallets': 5.7.0
+      '@ethersproject/keccak256': 5.7.0
+      '@ethersproject/logger': 5.7.0
+      '@ethersproject/networks': 5.7.1
+      '@ethersproject/pbkdf2': 5.7.0
+      '@ethersproject/properties': 5.7.0
+      '@ethersproject/providers': 5.7.1
+      '@ethersproject/random': 5.7.0
+      '@ethersproject/rlp': 5.7.0
+      '@ethersproject/sha2': 5.7.0
+      '@ethersproject/signing-key': 5.7.0
+      '@ethersproject/solidity': 5.7.0
+      '@ethersproject/strings': 5.7.0
+      '@ethersproject/transactions': 5.7.0
+      '@ethersproject/units': 5.7.0
+      '@ethersproject/wallet': 5.7.0
+      '@ethersproject/web': 5.7.1
+      '@ethersproject/wordlists': 5.7.0
+    transitivePeerDependencies:
+      - bufferutil
+      - utf-8-validate
+    dev: true
+
+  /ethjs-unit/0.1.6:
+    resolution: {integrity: sha1-xmWSHkduh7ziqdWIpv4EBbLEFpk=}
+    engines: {node: '>=6.5.0', npm: '>=3'}
+    dependencies:
+      bn.js: 4.11.6
+      number-to-bn: 1.7.0
+    dev: true
+
+  /ethjs-util/0.1.6:
+    resolution: {integrity: sha512-CUnVOQq7gSpDHZVVrQW8ExxUETWrnrvXYvYz55wOU8Uj4VCgw56XC2B/fVqQN+f7gmrnRHSLVnFAwsCuNwji8w==}
+    engines: {node: '>=6.5.0', npm: '>=3'}
+    dependencies:
+      is-hex-prefixed: 1.0.0
+      strip-hex-prefix: 1.0.0
+    dev: true
+
+  /event-target-shim/5.0.1:
+    resolution: {integrity: sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /evp_bytestokey/1.0.3:
+    resolution: {integrity: sha512-/f2Go4TognH/KvCISP7OUsHn85hT9nUkxxA9BEWxFn+Oj9o8ZNLm/40hdlgSLyuOimsrTKLUMEorQexp/aPQeA==}
+    dependencies:
+      md5.js: 1.3.5
+      safe-buffer: 5.2.1
+    dev: true
+
+  /extend/3.0.2:
+    resolution: {integrity: sha512-fjquC59cD7CyW6urNXK0FBufkZcoiGG80wTuPujX590cB5Ttln20E2UB4S/WARVqhXffZl2LNgS+gQdPIIim/g==}
+    dev: true
+
+  /extsprintf/1.3.0:
+    resolution: {integrity: sha512-11Ndz7Nv+mvAC1j0ktTa7fAb0vLyGGX+rMHNBYQviQDGU0Hw7lhctJANqbPhu9nV9/izT/IntTgZ7Im/9LJs9g==}
+    engines: {'0': node >=0.6.0}
+    dev: true
+
+  /fast-deep-equal/3.1.3:
+    resolution: {integrity: sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==}
+    dev: true
+
+  /fast-glob/3.2.12:
+    resolution: {integrity: sha512-DVj4CQIYYow0BlaelwK1pHl5n5cRSJfM60UA0zK891sVInoPri2Ekj7+e1CT3/3qxXenpI+nBBmQAcJPJgaj4w==}
+    engines: {node: '>=8.6.0'}
+    dependencies:
+      '@nodelib/fs.stat': 2.0.5
+      '@nodelib/fs.walk': 1.2.8
+      glob-parent: 5.1.2
+      merge2: 1.4.1
+      micromatch: 4.0.5
+    dev: true
+
+  /fast-json-stable-stringify/2.1.0:
+    resolution: {integrity: sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==}
+    dev: true
+
+  /fast-levenshtein/2.0.6:
+    resolution: {integrity: sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==}
+    dev: true
+
+  /fastq/1.13.0:
+    resolution: {integrity: sha512-YpkpUnK8od0o1hmeSc7UUs/eB/vIPWJYjKck2QKIzAf71Vm1AAQ3EbuZB3g2JIy+pg+ERD0vqI79KyZiB2e2Nw==}
+    dependencies:
+      reusify: 1.0.4
+    dev: true
+
+  /fill-range/7.0.1:
+    resolution: {integrity: sha512-qOo9F+dMUmC2Lcb4BbVvnKJxTPjCm+RRpe4gDuGrzkL7mEVl/djYSu2OdQ2Pa302N4oqkSg9ir6jaLWJ2USVpQ==}
+    engines: {node: '>=8'}
+    dependencies:
+      to-regex-range: 5.0.1
+    dev: true
+
+  /find-replace/3.0.0:
+    resolution: {integrity: sha512-6Tb2myMioCAgv5kfvP5/PkZZ/ntTpVK39fHY7WkWBgvbeE+VHd/tZuZ4mrC+bxh4cfOZeYKVPaJIZtZXV7GNCQ==}
+    engines: {node: '>=4.0.0'}
+    dependencies:
+      array-back: 3.1.0
+    dev: true
+
+  /find-up/2.1.0:
+    resolution: {integrity: sha512-NWzkk0jSJtTt08+FBFMvXoeZnOJD+jTtsRmBYbAIzJdX6l7dLgR7CTubCM5/eDdPUBvLCeVasP1brfVR/9/EZQ==}
+    engines: {node: '>=4'}
+    dependencies:
+      locate-path: 2.0.0
+    dev: true
+
+  /find-up/3.0.0:
+    resolution: {integrity: sha512-1yD6RmLI1XBfxugvORwlck6f75tYL+iR0jqwsOrOxMZyGYqUuDhJ0l4AXdO1iX/FTs9cBAMEk1gWSEx1kSbylg==}
+    engines: {node: '>=6'}
+    dependencies:
+      locate-path: 3.0.0
+    dev: true
+
+  /find-up/5.0.0:
+    resolution: {integrity: sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==}
+    engines: {node: '>=10'}
+    dependencies:
+      locate-path: 6.0.0
+      path-exists: 4.0.0
+    dev: true
+
+  /flat/4.1.1:
+    resolution: {integrity: sha512-FmTtBsHskrU6FJ2VxCnsDb84wu9zhmO3cUX2kGFb5tuwhfXxGciiT0oRY+cck35QmG+NmGh5eLz6lLCpWTqwpA==}
+    hasBin: true
+    dependencies:
+      is-buffer: 2.0.5
+    dev: true
+
+  /flat/5.0.2:
+    resolution: {integrity: sha512-b6suED+5/3rTpUBdG1gupIl8MPFCAMA0QXwmljLhvCUKcUvdE4gWky9zpuGCcXHOsz4J9wPGNWq6OKpmIzz3hQ==}
+    hasBin: true
+    dev: true
+
+  /follow-redirects/1.15.2_debug@4.3.4:
+    resolution: {integrity: sha512-VQLG33o04KaQ8uYi2tVNbdrWp1QWxNNea+nmIB4EVM28v0hmP17z7aG1+wAkNzVq4KeXTq3221ye5qTJP91JwA==}
+    engines: {node: '>=4.0'}
+    peerDependencies:
+      debug: '*'
+    peerDependenciesMeta:
+      debug:
+        optional: true
+    dependencies:
+      debug: 4.3.4
+    dev: true
+
+  /forever-agent/0.6.1:
+    resolution: {integrity: sha512-j0KLYPhm6zeac4lz3oJ3o65qvgQCcPubiyotZrXqEaG4hNagNYO8qdlUrX5vwqv9ohqeT/Z3j6+yW067yWWdUw==}
+    dev: true
+
+  /form-data/2.3.3:
+    resolution: {integrity: sha512-1lLKB2Mu3aGP1Q/2eCOx0fNbRMe7XdwktwOruhfqqd0rIJWwN4Dh+E3hrPSlDCXnSR7UtZ1N38rVXm+6+MEhJQ==}
+    engines: {node: '>= 0.12'}
+    dependencies:
+      asynckit: 0.4.0
+      combined-stream: 1.0.8
+      mime-types: 2.1.35
+    dev: true
+
+  /form-data/2.5.1:
+    resolution: {integrity: sha512-m21N3WOmEEURgk6B9GLOE4RuWOFf28Lhh9qGYeNlGq4VDXUlJy2th2slBNU8Gp8EzloYZOibZJ7t5ecIrFSjVA==}
+    engines: {node: '>= 0.12'}
+    dependencies:
+      asynckit: 0.4.0
+      combined-stream: 1.0.8
+      mime-types: 2.1.35
+    dev: true
+
+  /fp-ts/1.19.3:
+    resolution: {integrity: sha512-H5KQDspykdHuztLTg+ajGN0Z2qUjcEf3Ybxc6hLt0k7/zPkn29XnKnxlBPyW2XIddWrGaJBzBl4VLYOtk39yZg==}
+    dev: true
+
+  /fs-extra/0.30.0:
+    resolution: {integrity: sha512-UvSPKyhMn6LEd/WpUaV9C9t3zATuqoqfWc3QdPhPLb58prN9tqYPlPWi8Krxi44loBoUzlobqZ3+8tGpxxSzwA==}
+    dependencies:
+      graceful-fs: 4.2.10
+      jsonfile: 2.4.0
+      klaw: 1.3.1
+      path-is-absolute: 1.0.1
+      rimraf: 2.7.1
+    dev: true
+
+  /fs-extra/7.0.1:
+    resolution: {integrity: sha512-YJDaCJZEnBmcbw13fvdAM9AwNOJwOzrE4pqMqBq5nFiEqXUqHwlK4B+3pUw6JNvfSPtX05xFHtYy/1ni01eGCw==}
+    engines: {node: '>=6 <7 || >=8'}
+    dependencies:
+      graceful-fs: 4.2.10
+      jsonfile: 4.0.0
+      universalify: 0.1.2
+    dev: true
+
+  /fs-extra/8.1.0:
+    resolution: {integrity: sha512-yhlQgA6mnOJUKOsRUFsgJdQCvkKhcz8tlZG5HBQfReYZy46OwLcY+Zia0mtdHsOo9y/hP+CxMN0TU9QxoOtG4g==}
+    engines: {node: '>=6 <7 || >=8'}
+    dependencies:
+      graceful-fs: 4.2.10
+      jsonfile: 4.0.0
+      universalify: 0.1.2
+    dev: true
+
+  /fs-extra/9.1.0:
+    resolution: {integrity: sha512-hcg3ZmepS30/7BSFqRvoo3DOMQu7IjqxO5nCDt+zM9XWjb33Wg7ziNT+Qvqbuc3+gWpzO02JubVyk2G4Zvo1OQ==}
+    engines: {node: '>=10'}
+    dependencies:
+      at-least-node: 1.0.0
+      graceful-fs: 4.2.10
+      jsonfile: 6.1.0
+      universalify: 2.0.0
+    dev: true
+
+  /fs-readdir-recursive/1.1.0:
+    resolution: {integrity: sha512-GNanXlVr2pf02+sPN40XN8HG+ePaNcvM0q5mZBd668Obwb0yD5GiUbZOFgwn8kGMY6I3mdyDJzieUy3PTYyTRA==}
+    dev: true
+
+  /fs.realpath/1.0.0:
+    resolution: {integrity: sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==}
+    dev: true
+
+  /fsevents/2.1.3:
+    resolution: {integrity: sha512-Auw9a4AxqWpa9GUfj370BMPzzyncfBABW8Mab7BGWBYDj4Isgq+cDKtx0i6u9jcX9pQDnswsaaOTgTmA5pEjuQ==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+    deprecated: '"Please update to latest v2.3 or v2.2"'
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /fsevents/2.3.2:
+    resolution: {integrity: sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /function-bind/1.1.1:
+    resolution: {integrity: sha512-yIovAzMX49sF8Yl58fSCWJ5svSLuaibPxXQJFLmBObTuCr0Mf1KiPopGM9NiFjiYBCbfaa2Fh6breQ6ANVTI0A==}
+    dev: true
+
+  /function.prototype.name/1.1.5:
+    resolution: {integrity: sha512-uN7m/BzVKQnCUF/iW8jYea67v++2u7m5UgENbHRtdDVclOUP+FMPlCNdmk0h/ysGyo2tavMJEDqJAkJdRa1vMA==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      call-bind: 1.0.2
+      define-properties: 1.1.4
+      es-abstract: 1.20.4
+      functions-have-names: 1.2.3
+    dev: true
+
+  /functional-red-black-tree/1.0.1:
+    resolution: {integrity: sha512-dsKNQNdj6xA3T+QlADDA7mOSlX0qiMINjn0cgr+eGHGsbSHzTabcIogz2+p/iqP1Xs6EP/sS2SbqH+brGTbq0g==}
+    dev: true
+
+  /functions-have-names/1.2.3:
+    resolution: {integrity: sha512-xckBUXyTIqT97tq2x2AMb+g163b5JFysYk0x4qxNFwbfQkmNZoiRHb6sPzI9/QV33WeuvVYBUIiD4NzNIyqaRQ==}
+    dev: true
+
+  /get-caller-file/2.0.5:
+    resolution: {integrity: sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==}
+    engines: {node: 6.* || 8.* || >= 10.*}
+    dev: true
+
+  /get-func-name/2.0.0:
+    resolution: {integrity: sha512-Hm0ixYtaSZ/V7C8FJrtZIuBBI+iSgL+1Aq82zSu8VQNB4S3Gk8e7Qs3VwBDJAhmRZcFqkl3tQu36g/Foh5I5ig==}
+    dev: true
+
+  /get-intrinsic/1.1.3:
+    resolution: {integrity: sha512-QJVz1Tj7MS099PevUG5jvnt9tSkXN8K14dxQlikJuPt4uD9hHAHjLyLBiLR5zELelBdD9QNRAXZzsJx0WaDL9A==}
+    dependencies:
+      function-bind: 1.1.1
+      has: 1.0.3
+      has-symbols: 1.0.3
+    dev: true
+
+  /get-port/3.2.0:
+    resolution: {integrity: sha512-x5UJKlgeUiNT8nyo/AcnwLnZuZNcSjSw0kogRB+Whd1fjjFq4B1hySFxSFWWSn4mIBzg3sRNUDFYc4g5gjPoLg==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /get-symbol-description/1.0.0:
+    resolution: {integrity: sha512-2EmdH1YvIQiZpltCNgkuiUnyukzxM/R6NDJX31Ke3BG1Nq5b0S2PhX59UKi9vZpPDQVdqn+1IcaAwnzTT5vCjw==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      call-bind: 1.0.2
+      get-intrinsic: 1.1.3
+    dev: true
+
+  /getpass/0.1.7:
+    resolution: {integrity: sha512-0fzj9JxOLfJ+XGLhR8ze3unN0KZCgZwiSSDz168VERjK8Wl8kVSdcu2kspd4s4wtAa1y/qrVRiAA0WclVsu0ng==}
+    dependencies:
+      assert-plus: 1.0.0
+    dev: true
+
+  /ghost-testrpc/0.0.2:
+    resolution: {integrity: sha512-i08dAEgJ2g8z5buJIrCTduwPIhih3DP+hOCTyyryikfV8T0bNvHnGXO67i0DD1H4GBDETTclPy9njZbfluQYrQ==}
+    hasBin: true
+    dependencies:
+      chalk: 2.4.2
+      node-emoji: 1.11.0
+    dev: true
+
+  /glob-parent/5.1.2:
+    resolution: {integrity: sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==}
+    engines: {node: '>= 6'}
+    dependencies:
+      is-glob: 4.0.3
+    dev: true
+
+  /glob/5.0.15:
+    resolution: {integrity: sha512-c9IPMazfRITpmAAKi22dK1VKxGDX9ehhqfABDriL/lzO92xcUKEJPQHrVA/2YHSNFB4iFlykVmWvwo48nr3OxA==}
+    dependencies:
+      inflight: 1.0.6
+      inherits: 2.0.4
+      minimatch: 3.1.2
+      once: 1.4.0
+      path-is-absolute: 1.0.1
+    dev: true
+
+  /glob/7.1.3:
+    resolution: {integrity: sha512-vcfuiIxogLV4DlGBHIUOwI0IbrJ8HWPc4MU7HzviGeNho/UJDfi6B5p3sHeWIQ0KGIU0Jpxi5ZHxemQfLkkAwQ==}
+    dependencies:
+      fs.realpath: 1.0.0
+      inflight: 1.0.6
+      inherits: 2.0.4
+      minimatch: 3.1.2
+      once: 1.4.0
+      path-is-absolute: 1.0.1
+    dev: true
+
+  /glob/7.1.7:
+    resolution: {integrity: sha512-OvD9ENzPLbegENnYP5UUfJIirTg4+XwMWGaQfQTY0JenxNvvIKP3U3/tAQSPIu/lHxXYSZmpXlUHeqAIdKzBLQ==}
+    dependencies:
+      fs.realpath: 1.0.0
+      inflight: 1.0.6
+      inherits: 2.0.4
+      minimatch: 3.1.2
+      once: 1.4.0
+      path-is-absolute: 1.0.1
+    dev: true
+
+  /glob/7.2.0:
+    resolution: {integrity: sha512-lmLf6gtyrPq8tTjSmrO94wBeQbFR3HbLHbuyD69wuyQkImp2hWqMGB47OX65FBkPffO641IP9jWa1z4ivqG26Q==}
+    dependencies:
+      fs.realpath: 1.0.0
+      inflight: 1.0.6
+      inherits: 2.0.4
+      minimatch: 3.1.2
+      once: 1.4.0
+      path-is-absolute: 1.0.1
+    dev: true
+
+  /glob/7.2.3:
+    resolution: {integrity: sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==}
+    dependencies:
+      fs.realpath: 1.0.0
+      inflight: 1.0.6
+      inherits: 2.0.4
+      minimatch: 3.1.2
+      once: 1.4.0
+      path-is-absolute: 1.0.1
+    dev: true
+
+  /global-modules/2.0.0:
+    resolution: {integrity: sha512-NGbfmJBp9x8IxyJSd1P+otYK8vonoJactOogrVfFRIAEY1ukil8RSKDz2Yo7wh1oihl51l/r6W4epkeKJHqL8A==}
+    engines: {node: '>=6'}
+    dependencies:
+      global-prefix: 3.0.0
+    dev: true
+
+  /global-prefix/3.0.0:
+    resolution: {integrity: sha512-awConJSVCHVGND6x3tmMaKcQvwXLhjdkmomy2W+Goaui8YPgYgXJZewhg3fWC+DlfqqQuWg8AwqjGTD2nAPVWg==}
+    engines: {node: '>=6'}
+    dependencies:
+      ini: 1.3.8
+      kind-of: 6.0.3
+      which: 1.3.1
+    dev: true
+
+  /globby/10.0.2:
+    resolution: {integrity: sha512-7dUi7RvCoT/xast/o/dLN53oqND4yk0nsHkhRgn9w65C4PofCLOoJ39iSOg+qVDdWQPIEj+eszMHQ+aLVwwQSg==}
+    engines: {node: '>=8'}
+    dependencies:
+      '@types/glob': 7.2.0
+      array-union: 2.1.0
+      dir-glob: 3.0.1
+      fast-glob: 3.2.12
+      glob: 7.2.3
+      ignore: 5.2.0
+      merge2: 1.4.1
+      slash: 3.0.0
+    dev: true
+
+  /graceful-fs/4.2.10:
+    resolution: {integrity: sha512-9ByhssR2fPVsNZj478qUUbKfmL0+t5BDVyjShtyZZLiK7ZDAArFFfopyOTj0M05wE2tJPisA4iTnnXl2YoPvOA==}
+    dev: true
+
+  /growl/1.10.5:
+    resolution: {integrity: sha512-qBr4OuELkhPenW6goKVXiv47US3clb3/IbuWF9KNKEijAy9oeHxU9IgzjvJhHkUzhaj7rOUD7+YGWqUjLp5oSA==}
+    engines: {node: '>=4.x'}
+    dev: true
+
+  /handlebars/4.7.7:
+    resolution: {integrity: sha512-aAcXm5OAfE/8IXkcZvCepKU3VzW1/39Fb5ZuqMtgI/hT8X2YgoMvBY5dLhq/cpOvw7Lk1nK/UF71aLG/ZnVYRA==}
+    engines: {node: '>=0.4.7'}
+    hasBin: true
+    dependencies:
+      minimist: 1.2.6
+      neo-async: 2.6.2
+      source-map: 0.6.1
+      wordwrap: 1.0.0
+    optionalDependencies:
+      uglify-js: 3.17.3
+    dev: true
+
+  /har-schema/2.0.0:
+    resolution: {integrity: sha512-Oqluz6zhGX8cyRaTQlFMPw80bSJVG2x/cFb8ZPhUILGgHka9SsokCCOQgpveePerqidZOrT14ipqfJb7ILcW5Q==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /har-validator/5.1.5:
+    resolution: {integrity: sha512-nmT2T0lljbxdQZfspsno9hgrG3Uir6Ks5afism62poxqBM6sDnMEuPmzTq8XN0OEwqKLLdh1jQI3qyE66Nzb3w==}
+    engines: {node: '>=6'}
+    deprecated: this library is no longer supported
+    dependencies:
+      ajv: 6.12.6
+      har-schema: 2.0.0
+    dev: true
+
+  /hardhat-gas-reporter/1.0.9_hardhat@2.11.2:
+    resolution: {integrity: sha512-INN26G3EW43adGKBNzYWOlI3+rlLnasXTwW79YNnUhXPDa+yHESgt639dJEs37gCjhkbNKcRRJnomXEuMFBXJg==}
+    peerDependencies:
+      hardhat: ^2.0.2
+    dependencies:
+      array-uniq: 1.0.3
+      eth-gas-reporter: 0.2.25
+      hardhat: 2.11.2_mwhvu7sfp6vq5ryuwb6hlbjfka
+      sha1: 1.1.1
+    transitivePeerDependencies:
+      - '@codechecks/client'
+    dev: true
+
+  /hardhat/2.11.2_mwhvu7sfp6vq5ryuwb6hlbjfka:
+    resolution: {integrity: sha512-BdsXC1CFJQDJKmAgCwpmGhFuVU6dcqlgMgT0Kg/xmFAFVugkpYu6NRmh4AaJ3Fah0/BR9DOR4XgQGIbg4eon/Q==}
+    engines: {node: ^14.0.0 || ^16.0.0 || ^18.0.0}
+    hasBin: true
+    peerDependencies:
+      ts-node: '*'
+      typescript: '*'
+    peerDependenciesMeta:
+      ts-node:
+        optional: true
+      typescript:
+        optional: true
+    dependencies:
+      '@ethersproject/abi': 5.7.0
+      '@metamask/eth-sig-util': 4.0.1
+      '@nomicfoundation/ethereumjs-block': 4.0.0
+      '@nomicfoundation/ethereumjs-blockchain': 6.0.0
+      '@nomicfoundation/ethereumjs-common': 3.0.0
+      '@nomicfoundation/ethereumjs-evm': 1.0.0
+      '@nomicfoundation/ethereumjs-rlp': 4.0.0
+      '@nomicfoundation/ethereumjs-statemanager': 1.0.0
+      '@nomicfoundation/ethereumjs-trie': 5.0.0
+      '@nomicfoundation/ethereumjs-tx': 4.0.0
+      '@nomicfoundation/ethereumjs-util': 8.0.0
+      '@nomicfoundation/ethereumjs-vm': 6.0.0
+      '@nomicfoundation/solidity-analyzer': 0.0.3
+      '@sentry/node': 5.30.0
+      '@types/bn.js': 5.1.1
+      '@types/lru-cache': 5.1.1
+      abort-controller: 3.0.0
+      adm-zip: 0.4.16
+      aggregate-error: 3.1.0
+      ansi-escapes: 4.3.2
+      chalk: 2.4.2
+      chokidar: 3.5.3
+      ci-info: 2.0.0
+      debug: 4.3.4
+      enquirer: 2.3.6
+      env-paths: 2.2.1
+      ethereum-cryptography: 1.1.2
+      ethereumjs-abi: 0.6.8
+      find-up: 2.1.0
+      fp-ts: 1.19.3
+      fs-extra: 7.0.1
+      glob: 7.2.0
+      immutable: 4.1.0
+      io-ts: 1.10.4
+      keccak: 3.0.2
+      lodash: 4.17.21
+      mnemonist: 0.38.5
+      mocha: 10.0.0
+      p-map: 4.0.0
+      qs: 6.11.0
+      raw-body: 2.5.1
+      resolve: 1.17.0
+      semver: 6.3.0
+      solc: 0.7.3_debug@4.3.4
+      source-map-support: 0.5.21
+      stacktrace-parser: 0.1.10
+      ts-node: 10.9.1_ieummqxttktzud32hpyrer46t4
+      tsort: 0.0.1
+      typescript: 4.8.4
+      undici: 5.11.0
+      uuid: 8.3.2
+      ws: 7.5.9
+    transitivePeerDependencies:
+      - bufferutil
+      - supports-color
+      - utf-8-validate
+    dev: true
+
+  /has-bigints/1.0.2:
+    resolution: {integrity: sha512-tSvCKtBr9lkF0Ex0aQiP9N+OpV4zi2r/Nee5VkRDbaqv35RLYMzbwQfFSZZH0kR+Rd6302UJZ2p/bJCEoR3VoQ==}
+    dev: true
+
+  /has-flag/1.0.0:
+    resolution: {integrity: sha512-DyYHfIYwAJmjAjSSPKANxI8bFY9YtFrgkAfinBojQ8YJTOuOuav64tMUJv584SES4xl74PmuaevIyaLESHdTAA==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /has-flag/3.0.0:
+    resolution: {integrity: sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /has-flag/4.0.0:
+    resolution: {integrity: sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /has-property-descriptors/1.0.0:
+    resolution: {integrity: sha512-62DVLZGoiEBDHQyqG4w9xCuZ7eJEwNmJRWw2VY84Oedb7WFcA27fiEVe8oUQx9hAUJ4ekurquucTGwsyO1XGdQ==}
+    dependencies:
+      get-intrinsic: 1.1.3
+    dev: true
+
+  /has-symbols/1.0.3:
+    resolution: {integrity: sha512-l3LCuF6MgDNwTDKkdYGEihYjt5pRPbEg46rtlmnSPlUbgmB8LOIrKJbYYFBSbnPaJexMKtiPO8hmeRjRz2Td+A==}
+    engines: {node: '>= 0.4'}
+    dev: true
+
+  /has-tostringtag/1.0.0:
+    resolution: {integrity: sha512-kFjcSNhnlGV1kyoGk7OXKSawH5JOb/LzUc5w9B02hOTO0dfFRjbHQKvg1d6cf3HbeUmtU9VbbV3qzZ2Teh97WQ==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      has-symbols: 1.0.3
+    dev: true
+
+  /has/1.0.3:
+    resolution: {integrity: sha512-f2dvO0VU6Oej7RkWJGrehjbzMAjFp5/VKPp5tTpWIV4JHHZK1/BxbFRtf/siA2SWTe09caDmVtYYzWEIbBS4zw==}
+    engines: {node: '>= 0.4.0'}
+    dependencies:
+      function-bind: 1.1.1
+    dev: true
+
+  /hash-base/3.1.0:
+    resolution: {integrity: sha512-1nmYp/rhMDiE7AYkDw+lLwlAzz0AntGIe51F3RfFfEqyQ3feY2eI/NcwC6umIQVOASPMsWJLJScWKSSvzL9IVA==}
+    engines: {node: '>=4'}
+    dependencies:
+      inherits: 2.0.4
+      readable-stream: 3.6.0
+      safe-buffer: 5.2.1
+    dev: true
+
+  /hash.js/1.1.3:
+    resolution: {integrity: sha512-/UETyP0W22QILqS+6HowevwhEFJ3MBJnwTf75Qob9Wz9t0DPuisL8kW8YZMK62dHAKE1c1p+gY1TtOLY+USEHA==}
+    dependencies:
+      inherits: 2.0.4
+      minimalistic-assert: 1.0.1
+    dev: true
+
+  /hash.js/1.1.7:
+    resolution: {integrity: sha512-taOaskGt4z4SOANNseOviYDvjEJinIkRgmp7LbKP2YTTmVxWBl87s/uzK9r+44BclBSp2X7K1hqeNfz9JbBeXA==}
+    dependencies:
+      inherits: 2.0.4
+      minimalistic-assert: 1.0.1
+    dev: true
+
+  /he/1.2.0:
+    resolution: {integrity: sha512-F/1DnUGPopORZi0ni+CvrCgHQ5FyEAHRLSApuYWMmrbSwoN2Mn/7k+Gl38gJnR7yyDZk6WLXwiGod1JOWNDKGw==}
+    hasBin: true
+    dev: true
+
+  /heap/0.2.7:
+    resolution: {integrity: sha512-2bsegYkkHO+h/9MGbn6KWcE45cHZgPANo5LXF7EvWdT0yT2EguSVO1nDgU5c8+ZOPwp2vMNa7YFsJhVcDR9Sdg==}
+    dev: true
+
+  /hmac-drbg/1.0.1:
+    resolution: {integrity: sha512-Tti3gMqLdZfhOQY1Mzf/AanLiqh1WTiJgEj26ZuYQ9fbkLomzGchCws4FyrSd4VkpBfiNhaE1On+lOz894jvXg==}
+    dependencies:
+      hash.js: 1.1.7
+      minimalistic-assert: 1.0.1
+      minimalistic-crypto-utils: 1.0.1
+    dev: true
+
+  /http-basic/8.1.3:
+    resolution: {integrity: sha512-/EcDMwJZh3mABI2NhGfHOGOeOZITqfkEO4p/xK+l3NpyncIHUQBoMvCSF/b5GqvKtySC2srL/GGG3+EtlqlmCw==}
+    engines: {node: '>=6.0.0'}
+    dependencies:
+      caseless: 0.12.0
+      concat-stream: 1.6.2
+      http-response-object: 3.0.2
+      parse-cache-control: 1.0.1
+    dev: true
+
+  /http-errors/2.0.0:
+    resolution: {integrity: sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==}
+    engines: {node: '>= 0.8'}
+    dependencies:
+      depd: 2.0.0
+      inherits: 2.0.4
+      setprototypeof: 1.2.0
+      statuses: 2.0.1
+      toidentifier: 1.0.1
+    dev: true
+
+  /http-response-object/3.0.2:
+    resolution: {integrity: sha512-bqX0XTF6fnXSQcEJ2Iuyr75yVakyjIDCqroJQ/aHfSdlM743Cwqoi2nDYMzLGWUcuTWGWy8AAvOKXTfiv6q9RA==}
+    dependencies:
+      '@types/node': 10.17.60
+    dev: true
+
+  /http-signature/1.2.0:
+    resolution: {integrity: sha512-CAbnr6Rz4CYQkLYUtSNXxQPUH2gK8f3iWexVlsnMeD+GjlsQ0Xsy1cOX+mN3dtxYomRy21CiOzU8Uhw6OwncEQ==}
+    engines: {node: '>=0.8', npm: '>=1.3.7'}
+    dependencies:
+      assert-plus: 1.0.0
+      jsprim: 1.4.2
+      sshpk: 1.17.0
+    dev: true
+
+  /https-proxy-agent/5.0.1:
+    resolution: {integrity: sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA==}
+    engines: {node: '>= 6'}
+    dependencies:
+      agent-base: 6.0.2
+      debug: 4.3.4
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /iconv-lite/0.4.24:
+    resolution: {integrity: sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==}
+    engines: {node: '>=0.10.0'}
+    dependencies:
+      safer-buffer: 2.1.2
+    dev: true
+
+  /ieee754/1.2.1:
+    resolution: {integrity: sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==}
+    dev: true
+
+  /ignore/5.2.0:
+    resolution: {integrity: sha512-CmxgYGiEPCLhfLnpPp1MoRmifwEIOgjcHXxOBjv7mY96c+eWScsOP9c112ZyLdWHi0FxHjI+4uVhKYp/gcdRmQ==}
+    engines: {node: '>= 4'}
+    dev: true
+
+  /immutable/4.1.0:
+    resolution: {integrity: sha512-oNkuqVTA8jqG1Q6c+UglTOD1xhC1BtjKI7XkCXRkZHrN5m18/XsnUp8Q89GkQO/z+0WjonSvl0FLhDYftp46nQ==}
+    dev: true
+
+  /indent-string/4.0.0:
+    resolution: {integrity: sha512-EdDDZu4A2OyIK7Lr/2zG+w5jmbuk1DVBnEwREQvBzspBJkCEbRa8GxU1lghYcaGJCnRWibjDXlq779X1/y5xwg==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /inflight/1.0.6:
+    resolution: {integrity: sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==}
+    dependencies:
+      once: 1.4.0
+      wrappy: 1.0.2
+    dev: true
+
+  /inherits/2.0.4:
+    resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==}
+    dev: true
+
+  /ini/1.3.8:
+    resolution: {integrity: sha512-JV/yugV2uzW5iMRSiZAyDtQd+nxtUnjeLt0acNdw98kKLrvuRVyB80tsREOE7yvGVgalhZ6RNXCmEHkUKBKxew==}
+    dev: true
+
+  /internal-slot/1.0.3:
+    resolution: {integrity: sha512-O0DB1JC/sPyZl7cIo78n5dR7eUSwwpYPiXRhTzNxZVAMUuB8vlnRFyLxdrVToks6XPLVnFfbzaVd5WLjhgg+vA==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      get-intrinsic: 1.1.3
+      has: 1.0.3
+      side-channel: 1.0.4
+    dev: true
+
+  /interpret/1.4.0:
+    resolution: {integrity: sha512-agE4QfB2Lkp9uICn7BAqoscw4SZP9kTE2hxiFI3jBPmXJfdqiahTbUuKGsMoN2GtqL9AxhYioAcVvgsb1HvRbA==}
+    engines: {node: '>= 0.10'}
+    dev: true
+
+  /io-ts/1.10.4:
+    resolution: {integrity: sha512-b23PteSnYXSONJ6JQXRAlvJhuw8KOtkqa87W4wDtvMrud/DTJd5X+NpOOI+O/zZwVq6v0VLAaJ+1EDViKEuN9g==}
+    dependencies:
+      fp-ts: 1.19.3
+    dev: true
+
+  /is-bigint/1.0.4:
+    resolution: {integrity: sha512-zB9CruMamjym81i2JZ3UMn54PKGsQzsJeo6xvN3HJJ4CAsQNB6iRutp2To77OfCNuoxspsIhzaPoO1zyCEhFOg==}
+    dependencies:
+      has-bigints: 1.0.2
+    dev: true
+
+  /is-binary-path/2.1.0:
+    resolution: {integrity: sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==}
+    engines: {node: '>=8'}
+    dependencies:
+      binary-extensions: 2.2.0
+    dev: true
+
+  /is-boolean-object/1.1.2:
+    resolution: {integrity: sha512-gDYaKHJmnj4aWxyj6YHyXVpdQawtVLHU5cb+eztPGczf6cjuTdwve5ZIEfgXqH4e57An1D1AKf8CZ3kYrQRqYA==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      call-bind: 1.0.2
+      has-tostringtag: 1.0.0
+    dev: true
+
+  /is-buffer/2.0.5:
+    resolution: {integrity: sha512-i2R6zNFDwgEHJyQUtJEk0XFi1i0dPFn/oqjK3/vPCcDeJvW5NQ83V8QbicfF1SupOaB0h8ntgBC2YiE7dfyctQ==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /is-callable/1.2.7:
+    resolution: {integrity: sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA==}
+    engines: {node: '>= 0.4'}
+    dev: true
+
+  /is-core-module/2.10.0:
+    resolution: {integrity: sha512-Erxj2n/LDAZ7H8WNJXd9tw38GYM3dv8rk8Zcs+jJuxYTW7sozH+SS8NtrSjVL1/vpLvWi1hxy96IzjJ3EHTJJg==}
+    dependencies:
+      has: 1.0.3
+    dev: true
+
+  /is-date-object/1.0.5:
+    resolution: {integrity: sha512-9YQaSxsAiSwcvS33MBk3wTCVnWK+HhF8VZR2jRxehM16QcVOdHqPn4VPHmRK4lSr38n9JriurInLcP90xsYNfQ==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      has-tostringtag: 1.0.0
+    dev: true
+
+  /is-extglob/2.1.1:
+    resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /is-fullwidth-code-point/2.0.0:
+    resolution: {integrity: sha512-VHskAKYM8RfSFXwee5t5cbN5PZeq1Wrh6qd5bkyiXIf6UQcN6w/A0eXM9r6t8d+GYOh+o6ZhiEnb88LN/Y8m2w==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /is-fullwidth-code-point/3.0.0:
+    resolution: {integrity: sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /is-glob/4.0.3:
+    resolution: {integrity: sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==}
+    engines: {node: '>=0.10.0'}
+    dependencies:
+      is-extglob: 2.1.1
+    dev: true
+
+  /is-hex-prefixed/1.0.0:
+    resolution: {integrity: sha1-fY035q135dEnFIkTxXPggtd39VQ=}
+    engines: {node: '>=6.5.0', npm: '>=3'}
+    dev: true
+
+  /is-negative-zero/2.0.2:
+    resolution: {integrity: sha512-dqJvarLawXsFbNDeJW7zAz8ItJ9cd28YufuuFzh0G8pNHjJMnY08Dv7sYX2uF5UpQOwieAeOExEYAWWfu7ZZUA==}
+    engines: {node: '>= 0.4'}
+    dev: true
+
+  /is-number-object/1.0.7:
+    resolution: {integrity: sha512-k1U0IRzLMo7ZlYIfzRu23Oh6MiIFasgpb9X76eqfFZAqwH44UI4KTBvBYIZ1dSL9ZzChTB9ShHfLkR4pdW5krQ==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      has-tostringtag: 1.0.0
+    dev: true
+
+  /is-number/7.0.0:
+    resolution: {integrity: sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==}
+    engines: {node: '>=0.12.0'}
+    dev: true
+
+  /is-plain-obj/2.1.0:
+    resolution: {integrity: sha512-YWnfyRwxL/+SsrWYfOpUtz5b3YD+nyfkHvjbcanzk8zgyO4ASD67uVMRt8k5bM4lLMDnXfriRhOpemw+NfT1eA==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /is-regex/1.1.4:
+    resolution: {integrity: sha512-kvRdxDsxZjhzUX07ZnLydzS1TU/TJlTUHHY4YLL87e37oUA49DfkLqgy+VjFocowy29cKvcSiu+kIv728jTTVg==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      call-bind: 1.0.2
+      has-tostringtag: 1.0.0
+    dev: true
+
+  /is-shared-array-buffer/1.0.2:
+    resolution: {integrity: sha512-sqN2UDu1/0y6uvXyStCOzyhAjCSlHceFoMKJW8W9EU9cvic/QdsZ0kEU93HEy3IUEFZIiH/3w+AH/UQbPHNdhA==}
+    dependencies:
+      call-bind: 1.0.2
+    dev: true
+
+  /is-string/1.0.7:
+    resolution: {integrity: sha512-tE2UXzivje6ofPW7l23cjDOMa09gb7xlAqG6jG5ej6uPV32TlWP3NKPigtaGeHNu9fohccRYvIiZMfOOnOYUtg==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      has-tostringtag: 1.0.0
+    dev: true
+
+  /is-symbol/1.0.4:
+    resolution: {integrity: sha512-C/CPBqKWnvdcxqIARxyOh4v1UUEOCHpgDa0WYgpKDFMszcrPcffg5uhwSgPCLD2WWxmq6isisz87tzT01tuGhg==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      has-symbols: 1.0.3
+    dev: true
+
+  /is-typedarray/1.0.0:
+    resolution: {integrity: sha512-cyA56iCMHAh5CdzjJIa4aohJyeO1YbwLi3Jc35MmRU6poroFjIGZzUzupGiRPOjgHg9TLu43xbpwXk523fMxKA==}
+    dev: true
+
+  /is-unicode-supported/0.1.0:
+    resolution: {integrity: sha512-knxG2q4UC3u8stRGyAVJCOdxFmv5DZiRcdlIaAQXAbSfJya+OhopNotLQrstBhququ4ZpuKbDc/8S6mgXgPFPw==}
+    engines: {node: '>=10'}
+    dev: true
+
+  /is-weakref/1.0.2:
+    resolution: {integrity: sha512-qctsuLZmIQ0+vSSMfoVvyFe2+GSEvnmZ2ezTup1SBse9+twCCeial6EEi3Nc2KFcf6+qz2FBPnjXsk8xhKSaPQ==}
+    dependencies:
+      call-bind: 1.0.2
+    dev: true
+
+  /isarray/1.0.0:
+    resolution: {integrity: sha512-VLghIWNM6ELQzo7zwmcg0NmTVyWKYjvIeM83yjp0wRDTmUnrM678fQbcKBo6n2CJEF0szoG//ytg+TKla89ALQ==}
+    dev: true
+
+  /isexe/2.0.0:
+    resolution: {integrity: sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==}
+    dev: true
+
+  /isstream/0.1.2:
+    resolution: {integrity: sha512-Yljz7ffyPbrLpLngrMtZ7NduUgVvi6wG9RJ9IUcyCd59YQ911PBJphODUcbOVbqYfxe1wuYf/LJ8PauMRwsM/g==}
+    dev: true
+
+  /js-sha3/0.5.7:
+    resolution: {integrity: sha512-GII20kjaPX0zJ8wzkTbNDYMY7msuZcTWk8S5UOh6806Jq/wz1J8/bnr8uGU0DAUmYDjj2Mr4X1cW8v/GLYnR+g==}
+    dev: true
+
+  /js-sha3/0.8.0:
+    resolution: {integrity: sha512-gF1cRrHhIzNfToc802P800N8PpXS+evLLXfsVpowqmAFR9uwbi89WvXg2QspOmXL8QL86J4T1EpFu+yUkwJY3Q==}
+    dev: true
+
+  /js-yaml/3.13.1:
+    resolution: {integrity: sha512-YfbcO7jXDdyj0DGxYVSlSeQNHbD7XPWvrVWeVUujrQEoZzWJIRrCPoyk6kL6IAjAG2IolMK4T0hNUe0HOUs5Jw==}
+    hasBin: true
+    dependencies:
+      argparse: 1.0.10
+      esprima: 4.0.1
+    dev: true
+
+  /js-yaml/3.14.1:
+    resolution: {integrity: sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==}
+    hasBin: true
+    dependencies:
+      argparse: 1.0.10
+      esprima: 4.0.1
+    dev: true
+
+  /js-yaml/4.1.0:
+    resolution: {integrity: sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==}
+    hasBin: true
+    dependencies:
+      argparse: 2.0.1
+    dev: true
+
+  /jsbn/0.1.1:
+    resolution: {integrity: sha512-UVU9dibq2JcFWxQPA6KCqj5O42VOmAY3zQUfEKxU0KpTGXwNoCjkX1e13eHNvw/xPynt6pU0rZ1htjWTNTSXsg==}
+    dev: true
+
+  /json-schema-traverse/0.4.1:
+    resolution: {integrity: sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==}
+    dev: true
+
+  /json-schema-traverse/1.0.0:
+    resolution: {integrity: sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==}
+    dev: true
+
+  /json-schema/0.4.0:
+    resolution: {integrity: sha512-es94M3nTIfsEPisRafak+HDLfHXnKBhV3vU5eqPcS3flIWqcxJWgXHXiey3YrpaNsanY5ei1VoYEbOzijuq9BA==}
+    dev: true
+
+  /json-stringify-safe/5.0.1:
+    resolution: {integrity: sha512-ZClg6AaYvamvYEE82d3Iyd3vSSIjQ+odgjaTzRuO3s7toCdFKczob2i0zCh7JE8kWn17yvAWhUVxvqGwUalsRA==}
+    dev: true
+
+  /jsonfile/2.4.0:
+    resolution: {integrity: sha512-PKllAqbgLgxHaj8TElYymKCAgrASebJrWpTnEkOaTowt23VKXXN0sUeriJ+eh7y6ufb/CC5ap11pz71/cM0hUw==}
+    optionalDependencies:
+      graceful-fs: 4.2.10
+    dev: true
+
+  /jsonfile/4.0.0:
+    resolution: {integrity: sha512-m6F1R3z8jjlf2imQHS2Qez5sjKWQzbuuhuJ/FKYFRZvPE3PuHcSMVZzfsLhGVOkfd20obL5SWEBew5ShlquNxg==}
+    optionalDependencies:
+      graceful-fs: 4.2.10
+    dev: true
+
+  /jsonfile/6.1.0:
+    resolution: {integrity: sha512-5dgndWOriYSm5cnYaJNhalLNDKOqFwyDB/rr1E9ZsGciGvKPs8R2xYGCacuf3z6K1YKDz182fd+fY3cn3pMqXQ==}
+    dependencies:
+      universalify: 2.0.0
+    optionalDependencies:
+      graceful-fs: 4.2.10
+    dev: true
+
+  /jsonschema/1.4.1:
+    resolution: {integrity: sha512-S6cATIPVv1z0IlxdN+zUk5EPjkGCdnhN4wVSBlvoUO1tOLJootbo9CquNJmbIh4yikWHiUedhRYrNPn1arpEmQ==}
+    dev: true
+
+  /jsprim/1.4.2:
+    resolution: {integrity: sha512-P2bSOMAc/ciLz6DzgjVlGJP9+BrJWu5UDGK70C2iweC5QBIeFf0ZXRvGjEj2uYgrY2MkAAhsSWHDWlFtEroZWw==}
+    engines: {node: '>=0.6.0'}
+    dependencies:
+      assert-plus: 1.0.0
+      extsprintf: 1.3.0
+      json-schema: 0.4.0
+      verror: 1.10.0
+    dev: true
+
+  /keccak/3.0.2:
+    resolution: {integrity: sha512-PyKKjkH53wDMLGrvmRGSNWgmSxZOUqbnXwKL9tmgbFYA1iAYqW21kfR7mZXV0MlESiefxQQE9X9fTa3X+2MPDQ==}
+    engines: {node: '>=10.0.0'}
+    requiresBuild: true
+    dependencies:
+      node-addon-api: 2.0.2
+      node-gyp-build: 4.5.0
+      readable-stream: 3.6.0
+    dev: true
+
+  /kind-of/6.0.3:
+    resolution: {integrity: sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /klaw/1.3.1:
+    resolution: {integrity: sha512-TED5xi9gGQjGpNnvRWknrwAB1eL5GciPfVFOt3Vk1OJCVDQbzuSfrF3hkUQKlsgKrG1F+0t5W0m+Fje1jIt8rw==}
+    optionalDependencies:
+      graceful-fs: 4.2.10
+    dev: true
+
+  /level-supports/4.0.1:
+    resolution: {integrity: sha512-PbXpve8rKeNcZ9C1mUicC9auIYFyGpkV9/i6g76tLgANwWhtG2v7I4xNBUlkn3lE2/dZF3Pi0ygYGtLc4RXXdA==}
+    engines: {node: '>=12'}
+    dev: true
+
+  /level-transcoder/1.0.1:
+    resolution: {integrity: sha512-t7bFwFtsQeD8cl8NIoQ2iwxA0CL/9IFw7/9gAjOonH0PWTTiRfY7Hq+Ejbsxh86tXobDQ6IOiddjNYIfOBs06w==}
+    engines: {node: '>=12'}
+    dependencies:
+      buffer: 6.0.3
+      module-error: 1.0.2
+    dev: true
+
+  /level/8.0.0:
+    resolution: {integrity: sha512-ypf0jjAk2BWI33yzEaaotpq7fkOPALKAgDBxggO6Q9HGX2MRXn0wbP1Jn/tJv1gtL867+YOjOB49WaUF3UoJNQ==}
+    engines: {node: '>=12'}
+    dependencies:
+      browser-level: 1.0.1
+      classic-level: 1.2.0
+    dev: true
+
+  /levn/0.3.0:
+    resolution: {integrity: sha512-0OO4y2iOHix2W6ujICbKIaEQXvFQHue65vUG3pb5EUomzPI90z9hsA1VsO/dbIIpC53J8gxM9Q4Oho0jrCM/yA==}
+    engines: {node: '>= 0.8.0'}
+    dependencies:
+      prelude-ls: 1.1.2
+      type-check: 0.3.2
+    dev: true
+
+  /locate-path/2.0.0:
+    resolution: {integrity: sha512-NCI2kiDkyR7VeEKm27Kda/iQHyKJe1Bu0FlTbYp3CqJu+9IFe9bLyAjMxf5ZDDbEg+iMPzB5zYyUTSm8wVTKmA==}
+    engines: {node: '>=4'}
+    dependencies:
+      p-locate: 2.0.0
+      path-exists: 3.0.0
+    dev: true
+
+  /locate-path/3.0.0:
+    resolution: {integrity: sha512-7AO748wWnIhNqAuaty2ZWHkQHRSNfPVIsPIfwEOWO22AmaoVrWavlOcMR5nzTLNYvp36X220/maaRsrec1G65A==}
+    engines: {node: '>=6'}
+    dependencies:
+      p-locate: 3.0.0
+      path-exists: 3.0.0
+    dev: true
+
+  /locate-path/6.0.0:
+    resolution: {integrity: sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==}
+    engines: {node: '>=10'}
+    dependencies:
+      p-locate: 5.0.0
+    dev: true
+
+  /lodash.camelcase/4.3.0:
+    resolution: {integrity: sha512-TwuEnCnxbc3rAvhf/LbG7tJUDzhqXyFnv3dtzLOPgCG/hODL7WFnsbwktkD7yUV0RrreP/l1PALq/YSg6VvjlA==}
+    dev: true
+
+  /lodash.truncate/4.4.2:
+    resolution: {integrity: sha512-jttmRe7bRse52OsWIMDLaXxWqRAmtIUccAQ3garviCqJjafXOfNMO0yMfNpdD6zbGaTU0P5Nz7e7gAT6cKmJRw==}
+    dev: true
+
+  /lodash/4.17.21:
+    resolution: {integrity: sha512-v2kDEe57lecTulaDIuNTPy3Ry4gLGJ6Z1O3vE1krgXZNrsQ+LFTGHVxVjcXPs17LhbZVGedAJv8XZ1tvj5FvSg==}
+    dev: true
+
+  /log-symbols/3.0.0:
+    resolution: {integrity: sha512-dSkNGuI7iG3mfvDzUuYZyvk5dD9ocYCYzNU6CYDE6+Xqd+gwme6Z00NS3dUh8mq/73HaEtT7m6W+yUPtU6BZnQ==}
+    engines: {node: '>=8'}
+    dependencies:
+      chalk: 2.4.2
+    dev: true
+
+  /log-symbols/4.1.0:
+    resolution: {integrity: sha512-8XPvpAA8uyhfteu8pIvQxpJZ7SYYdpUivZpGy6sFsBuKRY/7rQGavedeB8aK+Zkyq6upMFVL/9AW6vOYzfRyLg==}
+    engines: {node: '>=10'}
+    dependencies:
+      chalk: 4.1.2
+      is-unicode-supported: 0.1.0
+    dev: true
+
+  /loupe/2.3.4:
+    resolution: {integrity: sha512-OvKfgCC2Ndby6aSTREl5aCCPTNIzlDfQZvZxNUrBrihDhL3xcrYegTblhmEiCrg2kKQz4XsFIaemE5BF4ybSaQ==}
+    dependencies:
+      get-func-name: 2.0.0
+    dev: true
+
+  /lru-cache/5.1.1:
+    resolution: {integrity: sha512-KpNARQA3Iwv+jTA0utUVVbrh+Jlrr1Fv0e56GGzAFOXN7dk/FviaDW8LHmK52DlcH4WP2n6gI8vN1aesBFgo9w==}
+    dependencies:
+      yallist: 3.1.1
+    dev: true
+
+  /lru-cache/6.0.0:
+    resolution: {integrity: sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==}
+    engines: {node: '>=10'}
+    dependencies:
+      yallist: 4.0.0
+    dev: true
+
+  /lru_map/0.3.3:
+    resolution: {integrity: sha512-Pn9cox5CsMYngeDbmChANltQl+5pi6XmTrraMSzhPmMBbmgcxmqWry0U3PGapCU1yB4/LqCcom7qhHZiF/jGfQ==}
+    dev: true
+
+  /make-error/1.3.6:
+    resolution: {integrity: sha512-s8UhlNe7vPKomQhC1qFelMokr/Sc3AgNbso3n74mVPA5LTZwkB9NlXf4XPamLxJE8h0gh73rM94xvwRT2CVInw==}
+    dev: true
+
+  /markdown-table/1.1.3:
+    resolution: {integrity: sha512-1RUZVgQlpJSPWYbFSpmudq5nHY1doEIv89gBtF0s4gW1GF2XorxcA/70M5vq7rLv0a6mhOUccRsqkwhwLCIQ2Q==}
+    dev: true
+
+  /mcl-wasm/0.7.9:
+    resolution: {integrity: sha512-iJIUcQWA88IJB/5L15GnJVnSQJmf/YaxxV6zRavv83HILHaJQb6y0iFyDMdDO0gN8X37tdxmAOrH/P8B6RB8sQ==}
+    engines: {node: '>=8.9.0'}
+    dev: true
+
+  /md5.js/1.3.5:
+    resolution: {integrity: sha512-xitP+WxNPcTTOgnTJcrhM0xvdPepipPSf3I8EIpGKeFLjt3PlJLIDG3u8EX53ZIubkb+5U2+3rELYpEhHhzdkg==}
+    dependencies:
+      hash-base: 3.1.0
+      inherits: 2.0.4
+      safe-buffer: 5.2.1
+    dev: true
+
+  /memory-level/1.0.0:
+    resolution: {integrity: sha512-UXzwewuWeHBz5krr7EvehKcmLFNoXxGcvuYhC41tRnkrTbJohtS7kVn9akmgirtRygg+f7Yjsfi8Uu5SGSQ4Og==}
+    engines: {node: '>=12'}
+    dependencies:
+      abstract-level: 1.0.3
+      functional-red-black-tree: 1.0.1
+      module-error: 1.0.2
+    dev: true
+
+  /memorystream/0.3.1:
+    resolution: {integrity: sha512-S3UwM3yj5mtUSEfP41UZmt/0SCoVYUcU1rkXv+BQ5Ig8ndL4sPoJNBUJERafdPb5jjHJGuMgytgKvKIf58XNBw==}
+    engines: {node: '>= 0.10.0'}
+    dev: true
+
+  /merge2/1.4.1:
+    resolution: {integrity: sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==}
+    engines: {node: '>= 8'}
+    dev: true
+
+  /micromatch/4.0.5:
+    resolution: {integrity: sha512-DMy+ERcEW2q8Z2Po+WNXuw3c5YaUSFjAO5GsJqfEl7UjvtIuFKO6ZrKvcItdy98dwFI2N1tg3zNIdKaQT+aNdA==}
+    engines: {node: '>=8.6'}
+    dependencies:
+      braces: 3.0.2
+      picomatch: 2.3.1
+    dev: true
+
+  /mime-db/1.52.0:
+    resolution: {integrity: sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==}
+    engines: {node: '>= 0.6'}
+    dev: true
+
+  /mime-types/2.1.35:
+    resolution: {integrity: sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==}
+    engines: {node: '>= 0.6'}
+    dependencies:
+      mime-db: 1.52.0
+    dev: true
+
+  /minimalistic-assert/1.0.1:
+    resolution: {integrity: sha512-UtJcAD4yEaGtjPezWuO9wC4nwUnVH/8/Im3yEHQP4b67cXlD/Qr9hdITCU1xDbSEXg2XKNaP8jsReV7vQd00/A==}
+    dev: true
+
+  /minimalistic-crypto-utils/1.0.1:
+    resolution: {integrity: sha512-JIYlbt6g8i5jKfJ3xz7rF0LXmv2TkDxBLUkiBeZ7bAx4GnnNMr8xFpGnOxn6GhTEHx3SjRrZEoU+j04prX1ktg==}
+    dev: true
+
+  /minimatch/3.0.4:
+    resolution: {integrity: sha512-yJHVQEhyqPLUTgt9B83PXu6W3rx4MvvHvSUvToogpwoGDOUQ+yDrR0HRot+yOCdCO7u4hX3pWft6kWBBcqh0UA==}
+    dependencies:
+      brace-expansion: 1.1.11
+    dev: true
+
+  /minimatch/3.1.2:
+    resolution: {integrity: sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==}
+    dependencies:
+      brace-expansion: 1.1.11
+    dev: true
+
+  /minimatch/5.0.1:
+    resolution: {integrity: sha512-nLDxIFRyhDblz3qMuq+SoRZED4+miJ/G+tdDrjkkkRnjAsBexeGpgjLEQ0blJy7rHhR2b93rhQY4SvyWu9v03g==}
+    engines: {node: '>=10'}
+    dependencies:
+      brace-expansion: 2.0.1
+    dev: true
+
+  /minimist/1.2.6:
+    resolution: {integrity: sha512-Jsjnk4bw3YJqYzbdyBiNsPWHPfO++UGG749Cxs6peCu5Xg4nrena6OVxOYxrQTqww0Jmwt+Ref8rggumkTLz9Q==}
+    dev: true
+
+  /mkdirp/0.5.5:
+    resolution: {integrity: sha512-NKmAlESf6jMGym1++R0Ra7wvhV+wFW63FaSOFPwRahvea0gMUcGUhVeAg/0BC0wiv9ih5NYPB1Wn1UEI1/L+xQ==}
+    hasBin: true
+    dependencies:
+      minimist: 1.2.6
+    dev: true
+
+  /mkdirp/0.5.6:
+    resolution: {integrity: sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==}
+    hasBin: true
+    dependencies:
+      minimist: 1.2.6
+    dev: true
+
+  /mkdirp/1.0.4:
+    resolution: {integrity: sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw==}
+    engines: {node: '>=10'}
+    hasBin: true
+    dev: true
+
+  /mnemonist/0.38.5:
+    resolution: {integrity: sha512-bZTFT5rrPKtPJxj8KSV0WkPyNxl72vQepqqVUAW2ARUpUSF2qXMB6jZj7hW5/k7C1rtpzqbD/IIbJwLXUjCHeg==}
+    dependencies:
+      obliterator: 2.0.4
+    dev: true
+
+  /mocha/10.0.0:
+    resolution: {integrity: sha512-0Wl+elVUD43Y0BqPZBzZt8Tnkw9CMUdNYnUsTfOM1vuhJVZL+kiesFYsqwBkEEuEixaiPe5ZQdqDgX2jddhmoA==}
+    engines: {node: '>= 14.0.0'}
+    hasBin: true
+    dependencies:
+      '@ungap/promise-all-settled': 1.1.2
+      ansi-colors: 4.1.1
+      browser-stdout: 1.3.1
+      chokidar: 3.5.3
+      debug: 4.3.4_supports-color@8.1.1
+      diff: 5.0.0
+      escape-string-regexp: 4.0.0
+      find-up: 5.0.0
+      glob: 7.2.0
+      he: 1.2.0
+      js-yaml: 4.1.0
+      log-symbols: 4.1.0
+      minimatch: 5.0.1
+      ms: 2.1.3
+      nanoid: 3.3.3
+      serialize-javascript: 6.0.0
+      strip-json-comments: 3.1.1
+      supports-color: 8.1.1
+      workerpool: 6.2.1
+      yargs: 16.2.0
+      yargs-parser: 20.2.4
+      yargs-unparser: 2.0.0
+    dev: true
+
+  /mocha/7.1.2:
+    resolution: {integrity: sha512-o96kdRKMKI3E8U0bjnfqW4QMk12MwZ4mhdBTf+B5a1q9+aq2HRnj+3ZdJu0B/ZhJeK78MgYuv6L8d/rA5AeBJA==}
+    engines: {node: '>= 8.10.0'}
+    hasBin: true
+    dependencies:
+      ansi-colors: 3.2.3
+      browser-stdout: 1.3.1
+      chokidar: 3.3.0
+      debug: 3.2.6_supports-color@6.0.0
+      diff: 3.5.0
+      escape-string-regexp: 1.0.5
+      find-up: 3.0.0
+      glob: 7.1.3
+      growl: 1.10.5
+      he: 1.2.0
+      js-yaml: 3.13.1
+      log-symbols: 3.0.0
+      minimatch: 3.0.4
+      mkdirp: 0.5.5
+      ms: 2.1.1
+      node-environment-flags: 1.0.6
+      object.assign: 4.1.0
+      strip-json-comments: 2.0.1
+      supports-color: 6.0.0
+      which: 1.3.1
+      wide-align: 1.1.3
+      yargs: 13.3.2
+      yargs-parser: 13.1.2
+      yargs-unparser: 1.6.0
+    dev: true
+
+  /mocha/7.2.0:
+    resolution: {integrity: sha512-O9CIypScywTVpNaRrCAgoUnJgozpIofjKUYmJhiCIJMiuYnLI6otcb1/kpW9/n/tJODHGZ7i8aLQoDVsMtOKQQ==}
+    engines: {node: '>= 8.10.0'}
+    hasBin: true
+    dependencies:
+      ansi-colors: 3.2.3
+      browser-stdout: 1.3.1
+      chokidar: 3.3.0
+      debug: 3.2.6_supports-color@6.0.0
+      diff: 3.5.0
+      escape-string-regexp: 1.0.5
+      find-up: 3.0.0
+      glob: 7.1.3
+      growl: 1.10.5
+      he: 1.2.0
+      js-yaml: 3.13.1
+      log-symbols: 3.0.0
+      minimatch: 3.0.4
+      mkdirp: 0.5.5
+      ms: 2.1.1
+      node-environment-flags: 1.0.6
+      object.assign: 4.1.0
+      strip-json-comments: 2.0.1
+      supports-color: 6.0.0
+      which: 1.3.1
+      wide-align: 1.1.3
+      yargs: 13.3.2
+      yargs-parser: 13.1.2
+      yargs-unparser: 1.6.0
+    dev: true
+
+  /module-error/1.0.2:
+    resolution: {integrity: sha512-0yuvsqSCv8LbaOKhnsQ/T5JhyFlCYLPXK3U2sgV10zoKQwzs/MyfuQUOZQ1V/6OCOJsK/TRgNVrPuPDqtdMFtA==}
+    engines: {node: '>=10'}
+    dev: true
+
+  /ms/2.1.1:
+    resolution: {integrity: sha512-tgp+dl5cGk28utYktBsrFqA7HKgrhgPsg6Z/EfhWI4gl1Hwq8B/GmY/0oXZ6nF8hDVesS/FpnYaD/kOWhYQvyg==}
+    dev: true
+
+  /ms/2.1.2:
+    resolution: {integrity: sha512-sGkPx+VjMtmA6MX27oA4FBFELFCZZ4S4XqeGOXCv68tT+jb3vk/RyaKWP0PTKyWtmLSM0b+adUTEvbs1PEaH2w==}
+    dev: true
+
+  /ms/2.1.3:
+    resolution: {integrity: sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==}
+    dev: true
+
+  /nanoid/3.3.3:
+    resolution: {integrity: sha512-p1sjXuopFs0xg+fPASzQ28agW1oHD7xDsd9Xkf3T15H3c/cifrFHVwrh74PdoklAPi+i7MdRsE47vm2r6JoB+w==}
+    engines: {node: ^10 || ^12 || ^13.7 || ^14 || >=15.0.1}
+    hasBin: true
+    dev: true
+
+  /napi-macros/2.0.0:
+    resolution: {integrity: sha512-A0xLykHtARfueITVDernsAWdtIMbOJgKgcluwENp3AlsKN/PloyO10HtmoqnFAQAcxPkgZN7wdfPfEd0zNGxbg==}
+    dev: true
+
+  /neo-async/2.6.2:
+    resolution: {integrity: sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==}
+    dev: true
+
+  /node-addon-api/2.0.2:
+    resolution: {integrity: sha512-Ntyt4AIXyaLIuMHF6IOoTakB3K+RWxwtsHNRxllEoA6vPwP9o4866g6YWDLUdnucilZhmkxiHwHr11gAENw+QA==}
+    dev: true
+
+  /node-emoji/1.11.0:
+    resolution: {integrity: sha512-wo2DpQkQp7Sjm2A0cq+sN7EHKO6Sl0ctXeBdFZrL9T9+UywORbufTcTZxom8YqpLQt/FqNMUkOpkZrJVYSKD3A==}
+    dependencies:
+      lodash: 4.17.21
+    dev: true
+
+  /node-environment-flags/1.0.6:
+    resolution: {integrity: sha512-5Evy2epuL+6TM0lCQGpFIj6KwiEsGh1SrHUhTbNX+sLbBtjidPZFAnVK9y5yU1+h//RitLbRHTIMyxQPtxMdHw==}
+    dependencies:
+      object.getownpropertydescriptors: 2.1.4
+      semver: 5.7.1
+    dev: true
+
+  /node-gyp-build/4.5.0:
+    resolution: {integrity: sha512-2iGbaQBV+ITgCz76ZEjmhUKAKVf7xfY1sRl4UiKQspfZMH2h06SyhNsnSVy50cwkFQDGLyif6m/6uFXHkOZ6rg==}
+    hasBin: true
+    dev: true
+
+  /nofilter/1.0.4:
+    resolution: {integrity: sha512-N8lidFp+fCz+TD51+haYdbDGrcBWwuHX40F5+z0qkUjMJ5Tp+rdSuAkMJ9N9eoolDlEVTf6u5icM+cNKkKW2mA==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /nopt/3.0.6:
+    resolution: {integrity: sha512-4GUt3kSEYmk4ITxzB/b9vaIDfUVWN/Ml1Fwl11IlnIG2iaJ9O6WXZ9SrYM9NLI8OCBieN2Y8SWC2oJV0RQ7qYg==}
+    hasBin: true
+    dependencies:
+      abbrev: 1.0.9
+    dev: true
+
+  /normalize-path/3.0.0:
+    resolution: {integrity: sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /number-to-bn/1.7.0:
+    resolution: {integrity: sha1-uzYjWS9+X54AMLGXe9QaDFP+HqA=}
+    engines: {node: '>=6.5.0', npm: '>=3'}
+    dependencies:
+      bn.js: 4.11.6
+      strip-hex-prefix: 1.0.0
+    dev: true
+
+  /oauth-sign/0.9.0:
+    resolution: {integrity: sha512-fexhUFFPTGV8ybAtSIGbV6gOkSv8UtRbDBnAyLQw4QPKkgNlsH2ByPGtMUqdWkos6YCRmAqViwgZrJc/mRDzZQ==}
+    dev: true
+
+  /object-assign/4.1.1:
+    resolution: {integrity: sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /object-inspect/1.12.2:
+    resolution: {integrity: sha512-z+cPxW0QGUp0mcqcsgQyLVRDoXFQbXOwBaqyF7VIgI4TWNQsDHrBpUQslRmIfAoYWdYzs6UlKJtB2XJpTaNSpQ==}
+    dev: true
+
+  /object-keys/1.1.1:
+    resolution: {integrity: sha512-NuAESUOUMrlIXOfHKzD6bpPu3tYt3xvjNdRIQ+FeT0lNb4K8WR70CaDxhuNguS2XG+GjkyMwOzsN5ZktImfhLA==}
+    engines: {node: '>= 0.4'}
+    dev: true
+
+  /object.assign/4.1.0:
+    resolution: {integrity: sha512-exHJeq6kBKj58mqGyTQ9DFvrZC/eR6OwxzoM9YRoGBqrXYonaFyGiFMuc9VZrXf7DarreEwMpurG3dd+CNyW5w==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      define-properties: 1.1.4
+      function-bind: 1.1.1
+      has-symbols: 1.0.3
+      object-keys: 1.1.1
+    dev: true
+
+  /object.assign/4.1.4:
+    resolution: {integrity: sha512-1mxKf0e58bvyjSCtKYY4sRe9itRk3PJpquJOjeIkz885CczcI4IvJJDLPS72oowuSh+pBxUFROpX+TU++hxhZQ==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      call-bind: 1.0.2
+      define-properties: 1.1.4
+      has-symbols: 1.0.3
+      object-keys: 1.1.1
+    dev: true
+
+  /object.getownpropertydescriptors/2.1.4:
+    resolution: {integrity: sha512-sccv3L/pMModT6dJAYF3fzGMVcb38ysQ0tEE6ixv2yXJDtEIPph268OlAdJj5/qZMZDq2g/jqvwppt36uS/uQQ==}
+    engines: {node: '>= 0.8'}
+    dependencies:
+      array.prototype.reduce: 1.0.4
+      call-bind: 1.0.2
+      define-properties: 1.1.4
+      es-abstract: 1.20.4
+    dev: true
+
+  /obliterator/2.0.4:
+    resolution: {integrity: sha512-lgHwxlxV1qIg1Eap7LgIeoBWIMFibOjbrYPIPJZcI1mmGAI2m3lNYpK12Y+GBdPQ0U1hRwSord7GIaawz962qQ==}
+    dev: true
+
+  /once/1.4.0:
+    resolution: {integrity: sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==}
+    dependencies:
+      wrappy: 1.0.2
+    dev: true
+
+  /optionator/0.8.3:
+    resolution: {integrity: sha512-+IW9pACdk3XWmmTXG8m3upGUJst5XRGzxMRjXzAuJ1XnIFNvfhjjIuYkDvysnPQ7qzqVzLt78BCruntqRhWQbA==}
+    engines: {node: '>= 0.8.0'}
+    dependencies:
+      deep-is: 0.1.4
+      fast-levenshtein: 2.0.6
+      levn: 0.3.0
+      prelude-ls: 1.1.2
+      type-check: 0.3.2
+      word-wrap: 1.2.3
+    dev: true
+
+  /ordinal/1.0.3:
+    resolution: {integrity: sha512-cMddMgb2QElm8G7vdaa02jhUNbTSrhsgAGUz1OokD83uJTwSUn+nKoNoKVVaRa08yF6sgfO7Maou1+bgLd9rdQ==}
+    dev: true
+
+  /os-tmpdir/1.0.2:
+    resolution: {integrity: sha512-D2FR03Vir7FIu45XBY20mTb+/ZSWB00sjU9jdQXt83gDrI4Ztz5Fs7/yy74g2N5SVQY4xY1qDr4rNddwYRVX0g==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /p-limit/1.3.0:
+    resolution: {integrity: sha512-vvcXsLAJ9Dr5rQOPk7toZQZJApBl2K4J6dANSsEuh6QI41JYcsS/qhTGa9ErIUUgK3WNQoJYvylxvjqmiqEA9Q==}
+    engines: {node: '>=4'}
+    dependencies:
+      p-try: 1.0.0
+    dev: true
+
+  /p-limit/2.3.0:
+    resolution: {integrity: sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==}
+    engines: {node: '>=6'}
+    dependencies:
+      p-try: 2.2.0
+    dev: true
+
+  /p-limit/3.1.0:
+    resolution: {integrity: sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==}
+    engines: {node: '>=10'}
+    dependencies:
+      yocto-queue: 0.1.0
+    dev: true
+
+  /p-locate/2.0.0:
+    resolution: {integrity: sha512-nQja7m7gSKuewoVRen45CtVfODR3crN3goVQ0DDZ9N3yHxgpkuBhZqsaiotSQRrADUrne346peY7kT3TSACykg==}
+    engines: {node: '>=4'}
+    dependencies:
+      p-limit: 1.3.0
+    dev: true
+
+  /p-locate/3.0.0:
+    resolution: {integrity: sha512-x+12w/To+4GFfgJhBEpiDcLozRJGegY+Ei7/z0tSLkMmxGZNybVMSfWj9aJn8Z5Fc7dBUNJOOVgPv2H7IwulSQ==}
+    engines: {node: '>=6'}
+    dependencies:
+      p-limit: 2.3.0
+    dev: true
+
+  /p-locate/5.0.0:
+    resolution: {integrity: sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==}
+    engines: {node: '>=10'}
+    dependencies:
+      p-limit: 3.1.0
+    dev: true
+
+  /p-map/4.0.0:
+    resolution: {integrity: sha512-/bjOqmgETBYB5BoEeGVea8dmvHb2m9GLy1E9W43yeyfP6QQCZGFNa+XRceJEuDB6zqr+gKpIAmlLebMpykw/MQ==}
+    engines: {node: '>=10'}
+    dependencies:
+      aggregate-error: 3.1.0
+    dev: true
+
+  /p-try/1.0.0:
+    resolution: {integrity: sha512-U1etNYuMJoIz3ZXSrrySFjsXQTWOx2/jdi86L+2pRvph/qMKL6sbcCYdH23fqsbm8TH2Gn0OybpT4eSFlCVHww==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /p-try/2.2.0:
+    resolution: {integrity: sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /parse-cache-control/1.0.1:
+    resolution: {integrity: sha512-60zvsJReQPX5/QP0Kzfd/VrpjScIQ7SHBW6bFCYfEP+fp0Eppr1SHhIO5nd1PjZtvclzSzES9D/p5nFJurwfWg==}
+    dev: true
+
+  /path-exists/3.0.0:
+    resolution: {integrity: sha512-bpC7GYwiDYQ4wYLe+FA8lhRjhQCMcQGuSgGGqDkg/QerRWw9CmGRT0iSOVRSZJ29NMLZgIzqaljJ63oaL4NIJQ==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /path-exists/4.0.0:
+    resolution: {integrity: sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /path-is-absolute/1.0.1:
+    resolution: {integrity: sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /path-parse/1.0.7:
+    resolution: {integrity: sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==}
+    dev: true
+
+  /path-type/4.0.0:
+    resolution: {integrity: sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /pathval/1.1.1:
+    resolution: {integrity: sha512-Dp6zGqpTdETdR63lehJYPeIOqpiNBNtc7BpWSLrOje7UaIsE5aY92r/AunQA7rsXvet3lrJ3JnZX29UPTKXyKQ==}
+    dev: true
+
+  /pbkdf2/3.1.2:
+    resolution: {integrity: sha512-iuh7L6jA7JEGu2WxDwtQP1ddOpaJNC4KlDEFfdQajSGgGPNi4OyDc2R7QnbY2bR9QjBVGwgvTdNJZoE7RaxUMA==}
+    engines: {node: '>=0.12'}
+    dependencies:
+      create-hash: 1.2.0
+      create-hmac: 1.1.7
+      ripemd160: 2.0.2
+      safe-buffer: 5.2.1
+      sha.js: 2.4.11
+    dev: true
+
+  /performance-now/2.1.0:
+    resolution: {integrity: sha512-7EAHlyLHI56VEIdK57uwHdHKIaAGbnXPiw0yWbarQZOKaKpvUIgW0jWRVLiatnM+XXlSwsanIBH/hzGMJulMow==}
+    dev: true
+
+  /picomatch/2.3.1:
+    resolution: {integrity: sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==}
+    engines: {node: '>=8.6'}
+    dev: true
+
+  /pify/4.0.1:
+    resolution: {integrity: sha512-uB80kBFb/tfd68bVleG9T5GGsGPjJrLAUpR5PZIrhBnIaRTQRjqdJSsIKkOP6OAIFbj7GOrcudc5pNjZ+geV2g==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /prelude-ls/1.1.2:
+    resolution: {integrity: sha512-ESF23V4SKG6lVSGZgYNpbsiaAkdab6ZgOxe52p7+Kid3W3u3bxR4Vfd/o21dmN7jSt0IwgZ4v5MUd26FEtXE9w==}
+    engines: {node: '>= 0.8.0'}
+    dev: true
+
+  /prettier/2.7.1:
+    resolution: {integrity: sha512-ujppO+MkdPqoVINuDFDRLClm7D78qbDt0/NR+wp5FqEZOoTNAjPHWj17QRhu7geIHJfcNhRk1XVQmF8Bp3ye+g==}
+    engines: {node: '>=10.13.0'}
+    hasBin: true
+    dev: true
+
+  /process-nextick-args/2.0.1:
+    resolution: {integrity: sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag==}
+    dev: true
+
+  /promise/8.2.0:
+    resolution: {integrity: sha512-+CMAlLHqwRYwBMXKCP+o8ns7DN+xHDUiI+0nArsiJ9y+kJVPLFxEaSw6Ha9s9H0tftxg2Yzl25wqj9G7m5wLZg==}
+    dependencies:
+      asap: 2.0.6
+    dev: true
+
+  /psl/1.9.0:
+    resolution: {integrity: sha512-E/ZsdU4HLs/68gYzgGTkMicWTLPdAftJLfJFlLUAAKZGkStNU72sZjT66SnMDVOfOWY/YAoiD7Jxa9iHvngcag==}
+    dev: true
+
+  /punycode/2.1.1:
+    resolution: {integrity: sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /qs/6.11.0:
+    resolution: {integrity: sha512-MvjoMCJwEarSbUYk5O+nmoSzSutSsTwF85zcHPQ9OrlFoZOYIjaqBAJIqIXjptyD5vThxGq52Xu/MaJzRkIk4Q==}
+    engines: {node: '>=0.6'}
+    dependencies:
+      side-channel: 1.0.4
+    dev: true
+
+  /qs/6.5.3:
+    resolution: {integrity: sha512-qxXIEh4pCGfHICj1mAJQ2/2XVZkjCDTcEgfoSQxc/fYivUZxTkk7L3bDBJSoNrEzXI17oUO5Dp07ktqE5KzczA==}
+    engines: {node: '>=0.6'}
+    dev: true
+
+  /queue-microtask/1.2.3:
+    resolution: {integrity: sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==}
+    dev: true
+
+  /randombytes/2.1.0:
+    resolution: {integrity: sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==}
+    dependencies:
+      safe-buffer: 5.2.1
+    dev: true
+
+  /raw-body/2.5.1:
+    resolution: {integrity: sha512-qqJBtEyVgS0ZmPGdCFPWJ3FreoqvG4MVQln/kCgF7Olq95IbOp0/BWyMwbdtn4VTvkM8Y7khCQ2Xgk/tcrCXig==}
+    engines: {node: '>= 0.8'}
+    dependencies:
+      bytes: 3.1.2
+      http-errors: 2.0.0
+      iconv-lite: 0.4.24
+      unpipe: 1.0.0
+    dev: true
+
+  /readable-stream/2.3.7:
+    resolution: {integrity: sha512-Ebho8K4jIbHAxnuxi7o42OrZgF/ZTNcsZj6nRKyUmkhLFq8CHItp/fy6hQZuZmP/n3yZ9VBUbp4zz/mX8hmYPw==}
+    dependencies:
+      core-util-is: 1.0.3
+      inherits: 2.0.4
+      isarray: 1.0.0
+      process-nextick-args: 2.0.1
+      safe-buffer: 5.1.2
+      string_decoder: 1.1.1
+      util-deprecate: 1.0.2
+    dev: true
+
+  /readable-stream/3.6.0:
+    resolution: {integrity: sha512-BViHy7LKeTz4oNnkcLJ+lVSL6vpiFeX6/d3oSH8zCW7UxP2onchk+vTGB143xuFjHS3deTgkKoXXymXqymiIdA==}
+    engines: {node: '>= 6'}
+    dependencies:
+      inherits: 2.0.4
+      string_decoder: 1.3.0
+      util-deprecate: 1.0.2
+    dev: true
+
+  /readdirp/3.2.0:
+    resolution: {integrity: sha512-crk4Qu3pmXwgxdSgGhgA/eXiJAPQiX4GMOZZMXnqKxHX7TaoL+3gQVo/WeuAiogr07DpnfjIMpXXa+PAIvwPGQ==}
+    engines: {node: '>= 8'}
+    dependencies:
+      picomatch: 2.3.1
+    dev: true
+
+  /readdirp/3.6.0:
+    resolution: {integrity: sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==}
+    engines: {node: '>=8.10.0'}
+    dependencies:
+      picomatch: 2.3.1
+    dev: true
+
+  /rechoir/0.6.2:
+    resolution: {integrity: sha512-HFM8rkZ+i3zrV+4LQjwQ0W+ez98pApMGM3HUrN04j3CqzPOzl9nmP15Y8YXNm8QHGv/eacOVEjqhmWpkRV0NAw==}
+    engines: {node: '>= 0.10'}
+    dependencies:
+      resolve: 1.22.1
+    dev: true
+
+  /recursive-readdir/2.2.2:
+    resolution: {integrity: sha512-nRCcW9Sj7NuZwa2XvH9co8NPeXUBhZP7CRKJtU+cS6PW9FpCIFoI5ib0NT1ZrbNuPoRy0ylyCaUL8Gih4LSyFg==}
+    engines: {node: '>=0.10.0'}
+    dependencies:
+      minimatch: 3.0.4
+    dev: true
+
+  /reduce-flatten/2.0.0:
+    resolution: {integrity: sha512-EJ4UNY/U1t2P/2k6oqotuX2Cc3T6nxJwsM0N0asT7dhrtH1ltUxDn4NalSYmPE2rCkVpcf/X6R0wDwcFpzhd4w==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /regexp.prototype.flags/1.4.3:
+    resolution: {integrity: sha512-fjggEOO3slI6Wvgjwflkc4NFRCTZAu5CnNfBd5qOMYhWdn67nJBBu34/TkD++eeFmd8C9r9jfXJ27+nSiRkSUA==}
+    engines: {node: '>= 0.4'}
+    dependencies:
+      call-bind: 1.0.2
+      define-properties: 1.1.4
+      functions-have-names: 1.2.3
+    dev: true
+
+  /req-cwd/2.0.0:
+    resolution: {integrity: sha512-ueoIoLo1OfB6b05COxAA9UpeoscNpYyM+BqYlA7H6LVF4hKGPXQQSSaD2YmvDVJMkk4UDpAHIeU1zG53IqjvlQ==}
+    engines: {node: '>=4'}
+    dependencies:
+      req-from: 2.0.0
+    dev: true
+
+  /req-from/2.0.0:
+    resolution: {integrity: sha512-LzTfEVDVQHBRfjOUMgNBA+V6DWsSnoeKzf42J7l0xa/B4jyPOuuF5MlNSmomLNGemWTnV2TIdjSSLnEn95fOQA==}
+    engines: {node: '>=4'}
+    dependencies:
+      resolve-from: 3.0.0
+    dev: true
+
+  /request-promise-core/1.1.4_request@2.88.2:
+    resolution: {integrity: sha512-TTbAfBBRdWD7aNNOoVOBH4pN/KigV6LyapYNNlAPA8JwbovRti1E88m3sYAwsLi5ryhPKsE9APwnjFTgdUjTpw==}
+    engines: {node: '>=0.10.0'}
+    peerDependencies:
+      request: ^2.34
+    dependencies:
+      lodash: 4.17.21
+      request: 2.88.2
+    dev: true
+
+  /request-promise-native/1.0.9_request@2.88.2:
+    resolution: {integrity: sha512-wcW+sIUiWnKgNY0dqCpOZkUbF/I+YPi+f09JZIDa39Ec+q82CpSYniDp+ISgTTbKmnpJWASeJBPZmoxH84wt3g==}
+    engines: {node: '>=0.12.0'}
+    deprecated: request-promise-native has been deprecated because it extends the now deprecated request package, see https://github.com/request/request/issues/3142
+    peerDependencies:
+      request: ^2.34
+    dependencies:
+      request: 2.88.2
+      request-promise-core: 1.1.4_request@2.88.2
+      stealthy-require: 1.1.1
+      tough-cookie: 2.5.0
+    dev: true
+
+  /request/2.88.2:
+    resolution: {integrity: sha512-MsvtOrfG9ZcrOwAW+Qi+F6HbD0CWXEh9ou77uOb7FM2WPhwT7smM833PzanhJLsgXjN89Ir6V2PczXNnMpwKhw==}
+    engines: {node: '>= 6'}
+    deprecated: request has been deprecated, see https://github.com/request/request/issues/3142
+    dependencies:
+      aws-sign2: 0.7.0
+      aws4: 1.11.0
+      caseless: 0.12.0
+      combined-stream: 1.0.8
+      extend: 3.0.2
+      forever-agent: 0.6.1
+      form-data: 2.3.3
+      har-validator: 5.1.5
+      http-signature: 1.2.0
+      is-typedarray: 1.0.0
+      isstream: 0.1.2
+      json-stringify-safe: 5.0.1
+      mime-types: 2.1.35
+      oauth-sign: 0.9.0
+      performance-now: 2.1.0
+      qs: 6.5.3
+      safe-buffer: 5.2.1
+      tough-cookie: 2.5.0
+      tunnel-agent: 0.6.0
+      uuid: 3.4.0
+    dev: true
+
+  /require-directory/2.1.1:
+    resolution: {integrity: sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /require-from-string/2.0.2:
+    resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /require-main-filename/2.0.0:
+    resolution: {integrity: sha512-NKN5kMDylKuldxYLSUfrbo5Tuzh4hd+2E8NPPX02mZtn1VuREQToYe/ZdlJy+J3uCpfaiGF05e7B8W0iXbQHmg==}
+    dev: true
+
+  /resolve-from/3.0.0:
+    resolution: {integrity: sha512-GnlH6vxLymXJNMBo7XP1fJIzBFbdYt49CuTwmB/6N53t+kMPRMFKz783LlQ4tv28XoQfMWinAJX6WCGf2IlaIw==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /resolve/1.1.7:
+    resolution: {integrity: sha512-9znBF0vBcaSN3W2j7wKvdERPwqTxSpCq+if5C0WoTCyV9n24rua28jeuQ2pL/HOf+yUe/Mef+H/5p60K0Id3bg==}
+    dev: true
+
+  /resolve/1.17.0:
+    resolution: {integrity: sha512-ic+7JYiV8Vi2yzQGFWOkiZD5Z9z7O2Zhm9XMaTxdJExKasieFCr+yXZ/WmXsckHiKl12ar0y6XiXDx3m4RHn1w==}
+    dependencies:
+      path-parse: 1.0.7
+    dev: true
+
+  /resolve/1.22.1:
+    resolution: {integrity: sha512-nBpuuYuY5jFsli/JIs1oldw6fOQCBioohqWZg/2hiaOybXOft4lonv85uDOKXdf8rhyK159cxU5cDcK/NKk8zw==}
+    hasBin: true
+    dependencies:
+      is-core-module: 2.10.0
+      path-parse: 1.0.7
+      supports-preserve-symlinks-flag: 1.0.0
+    dev: true
+
+  /reusify/1.0.4:
+    resolution: {integrity: sha512-U9nH88a3fc/ekCF1l0/UP1IosiuIjyTh7hBvXVMHYgVcfGvt897Xguj2UOLDeI5BG2m7/uwyaLVT6fbtCwTyzw==}
+    engines: {iojs: '>=1.0.0', node: '>=0.10.0'}
+    dev: true
+
+  /rimraf/2.7.1:
+    resolution: {integrity: sha512-uWjbaKIK3T1OSVptzX7Nl6PvQ3qAGtKEtVRjRuazjfL3Bx5eI409VZSqgND+4UNnmzLVdPj9FqFJNPqBZFve4w==}
+    hasBin: true
+    dependencies:
+      glob: 7.2.0
+    dev: true
+
+  /ripemd160/2.0.2:
+    resolution: {integrity: sha512-ii4iagi25WusVoiC4B4lq7pbXfAp3D9v5CwfkY33vffw2+pkDjY1D8GaN7spsxvCSx8dkPqOZCEZyfxcmJG2IA==}
+    dependencies:
+      hash-base: 3.1.0
+      inherits: 2.0.4
+    dev: true
+
+  /rlp/2.2.7:
+    resolution: {integrity: sha512-d5gdPmgQ0Z+AklL2NVXr/IoSjNZFfTVvQWzL/AM2AOcSzYP2xjlb0AC8YyCLc41MSNf6P6QVtjgPdmVtzb+4lQ==}
+    hasBin: true
+    dependencies:
+      bn.js: 5.2.1
+    dev: true
+
+  /run-parallel-limit/1.1.0:
+    resolution: {integrity: sha512-jJA7irRNM91jaKc3Hcl1npHsFLOXOoTkPCUL1JEa1R82O2miplXXRaGdjW/KM/98YQWDhJLiSs793CnXfblJUw==}
+    dependencies:
+      queue-microtask: 1.2.3
+    dev: true
+
+  /run-parallel/1.2.0:
+    resolution: {integrity: sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==}
+    dependencies:
+      queue-microtask: 1.2.3
+    dev: true
+
+  /rustbn.js/0.2.0:
+    resolution: {integrity: sha512-4VlvkRUuCJvr2J6Y0ImW7NvTCriMi7ErOAqWk1y69vAdoNIzCF3yPmgeNzx+RQTLEDFq5sHfscn1MwHxP9hNfA==}
+    dev: true
+
+  /safe-buffer/5.1.2:
+    resolution: {integrity: sha512-Gd2UZBJDkXlY7GbJxfsE8/nvKkUEU1G38c1siN6QP6a9PT9MmHB8GnpscSmMJSoF8LOIrt8ud/wPtojys4G6+g==}
+    dev: true
+
+  /safe-buffer/5.2.1:
+    resolution: {integrity: sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==}
+    dev: true
+
+  /safe-regex-test/1.0.0:
+    resolution: {integrity: sha512-JBUUzyOgEwXQY1NuPtvcj/qcBDbDmEvWufhlnXZIm75DEHp+afM1r1ujJpJsV/gSM4t59tpDyPi1sd6ZaPFfsA==}
+    dependencies:
+      call-bind: 1.0.2
+      get-intrinsic: 1.1.3
+      is-regex: 1.1.4
+    dev: true
+
+  /safer-buffer/2.1.2:
+    resolution: {integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==}
+    dev: true
+
+  /sc-istanbul/0.4.6:
+    resolution: {integrity: sha512-qJFF/8tW/zJsbyfh/iT/ZM5QNHE3CXxtLJbZsL+CzdJLBsPD7SedJZoUA4d8iAcN2IoMp/Dx80shOOd2x96X/g==}
+    hasBin: true
+    dependencies:
+      abbrev: 1.0.9
+      async: 1.5.2
+      escodegen: 1.8.1
+      esprima: 2.7.3
+      glob: 5.0.15
+      handlebars: 4.7.7
+      js-yaml: 3.14.1
+      mkdirp: 0.5.6
+      nopt: 3.0.6
+      once: 1.4.0
+      resolve: 1.1.7
+      supports-color: 3.2.3
+      which: 1.3.1
+      wordwrap: 1.0.0
+    dev: true
+
+  /scrypt-js/2.0.4:
+    resolution: {integrity: sha512-4KsaGcPnuhtCZQCxFxN3GVYIhKFPTdLd8PLC552XwbMndtD0cjRFAhDuuydXQ0h08ZfPgzqe6EKHozpuH74iDw==}
+    dev: true
+
+  /scrypt-js/3.0.1:
+    resolution: {integrity: sha512-cdwTTnqPu0Hyvf5in5asVdZocVDTNRmR7XEcJuIzMjJeSHybHl7vpB66AzwTaIg6CLSbtjcxc8fqcySfnTkccA==}
+    dev: true
+
+  /secp256k1/4.0.3:
+    resolution: {integrity: sha512-NLZVf+ROMxwtEj3Xa562qgv2BK5e2WNmXPiOdVIPLgs6lyTzMvBq0aWTYMI5XCP9jZMVKOcqZLw/Wc4vDkuxhA==}
+    engines: {node: '>=10.0.0'}
+    requiresBuild: true
+    dependencies:
+      elliptic: 6.5.4
+      node-addon-api: 2.0.2
+      node-gyp-build: 4.5.0
+    dev: true
+
+  /semver/5.7.1:
+    resolution: {integrity: sha512-sauaDf/PZdVgrLTNYHRtpXa1iRiKcaebiKQ1BJdpQlWH2lCvexQdX55snPFyK7QzpudqbCI0qXFfOasHdyNDGQ==}
+    hasBin: true
+    dev: true
+
+  /semver/6.3.0:
+    resolution: {integrity: sha512-b39TBaTSfV6yBrapU89p5fKekE2m/NwnDocOVruQFS1/veMgdzuPcnOM34M6CwxW8jH/lxEa5rBoDeUwu5HHTw==}
+    hasBin: true
+    dev: true
+
+  /semver/7.3.8:
+    resolution: {integrity: sha512-NB1ctGL5rlHrPJtFDVIVzTyQylMLu9N9VICA6HSFJo8MCGVTMW6gfpicwKmmK/dAjTOrqu5l63JJOpDSrAis3A==}
+    engines: {node: '>=10'}
+    hasBin: true
+    dependencies:
+      lru-cache: 6.0.0
+    dev: true
+
+  /serialize-javascript/6.0.0:
+    resolution: {integrity: sha512-Qr3TosvguFt8ePWqsvRfrKyQXIiW+nGbYpy8XK24NQHE83caxWt+mIymTT19DGFbNWNLfEwsrkSmN64lVWB9ag==}
+    dependencies:
+      randombytes: 2.1.0
+    dev: true
+
+  /set-blocking/2.0.0:
+    resolution: {integrity: sha512-KiKBS8AnWGEyLzofFfmvKwpdPzqiy16LvQfK3yv/fVH7Bj13/wl3JSR1J+rfgRE9q7xUJK4qvgS8raSOeLUehw==}
+    dev: true
+
+  /setimmediate/1.0.4:
+    resolution: {integrity: sha512-/TjEmXQVEzdod/FFskf3o7oOAsGhHf2j1dZqRFbDzq4F3mvvxflIIi4Hd3bLQE9y/CpwqfSQam5JakI/mi3Pog==}
+    dev: true
+
+  /setimmediate/1.0.5:
+    resolution: {integrity: sha512-MATJdZp8sLqDl/68LfQmbP8zKPLQNV6BIZoIgrscFDQ+RsvK/BxeDQOgyxKKoh0y/8h3BqVFnCqQ/gd+reiIXA==}
+    dev: true
+
+  /setprototypeof/1.2.0:
+    resolution: {integrity: sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==}
+    dev: true
+
+  /sha.js/2.4.11:
+    resolution: {integrity: sha512-QMEp5B7cftE7APOjk5Y6xgrbWu+WkLVQwk8JNjZ8nKRciZaByEW6MubieAiToS7+dwvrjGhH8jRXz3MVd0AYqQ==}
+    hasBin: true
+    dependencies:
+      inherits: 2.0.4
+      safe-buffer: 5.2.1
+    dev: true
+
+  /sha1/1.1.1:
+    resolution: {integrity: sha512-dZBS6OrMjtgVkopB1Gmo4RQCDKiZsqcpAQpkV/aaj+FCrCg8r4I4qMkDPQjBgLIxlmu9k4nUbWq6ohXahOneYA==}
+    dependencies:
+      charenc: 0.0.2
+      crypt: 0.0.2
+    dev: true
+
+  /shelljs/0.8.5:
+    resolution: {integrity: sha512-TiwcRcrkhHvbrZbnRcFYMLl30Dfov3HKqzp5tO5b4pt6G/SezKcYhmDg15zXVBswHmctSAQKznqNW2LO5tTDow==}
+    engines: {node: '>=4'}
+    hasBin: true
+    dependencies:
+      glob: 7.2.3
+      interpret: 1.4.0
+      rechoir: 0.6.2
+    dev: true
+
+  /side-channel/1.0.4:
+    resolution: {integrity: sha512-q5XPytqFEIKHkGdiMIrY10mvLRvnQh42/+GoBlFW3b2LXLE2xxJpZFdm94we0BaoV3RwJyGqg5wS7epxTv0Zvw==}
+    dependencies:
+      call-bind: 1.0.2
+      get-intrinsic: 1.1.3
+      object-inspect: 1.12.2
+    dev: true
+
+  /slash/3.0.0:
+    resolution: {integrity: sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /slice-ansi/4.0.0:
+    resolution: {integrity: sha512-qMCMfhY040cVHT43K9BFygqYbUPFZKHOg7K73mtTWJRb8pyP3fzf4Ixd5SzdEJQ6MRUg/WBnOLxghZtKKurENQ==}
+    engines: {node: '>=10'}
+    dependencies:
+      ansi-styles: 4.3.0
+      astral-regex: 2.0.0
+      is-fullwidth-code-point: 3.0.0
+    dev: true
+
+  /solc/0.7.3_debug@4.3.4:
+    resolution: {integrity: sha512-GAsWNAjGzIDg7VxzP6mPjdurby3IkGCjQcM8GFYZT6RyaoUZKmMU6Y7YwG+tFGhv7dwZ8rmR4iwFDrrD99JwqA==}
+    engines: {node: '>=8.0.0'}
+    hasBin: true
+    dependencies:
+      command-exists: 1.2.9
+      commander: 3.0.2
+      follow-redirects: 1.15.2_debug@4.3.4
+      fs-extra: 0.30.0
+      js-sha3: 0.8.0
+      memorystream: 0.3.1
+      require-from-string: 2.0.2
+      semver: 5.7.1
+      tmp: 0.0.33
+    transitivePeerDependencies:
+      - debug
+    dev: true
+
+  /solidity-coverage/0.8.2_hardhat@2.11.2:
+    resolution: {integrity: sha512-cv2bWb7lOXPE9/SSleDO6czkFiMHgP4NXPj+iW9W7iEKLBk7Cj0AGBiNmGX3V1totl9wjPrT0gHmABZKZt65rQ==}
+    hasBin: true
+    peerDependencies:
+      hardhat: ^2.11.0
+    dependencies:
+      '@ethersproject/abi': 5.7.0
+      '@solidity-parser/parser': 0.14.3
+      chalk: 2.4.2
+      death: 1.1.0
+      detect-port: 1.5.1
+      difflib: 0.2.4
+      fs-extra: 8.1.0
+      ghost-testrpc: 0.0.2
+      global-modules: 2.0.0
+      globby: 10.0.2
+      hardhat: 2.11.2_mwhvu7sfp6vq5ryuwb6hlbjfka
+      jsonschema: 1.4.1
+      lodash: 4.17.21
+      mocha: 7.1.2
+      node-emoji: 1.11.0
+      pify: 4.0.1
+      recursive-readdir: 2.2.2
+      sc-istanbul: 0.4.6
+      semver: 7.3.8
+      shelljs: 0.8.5
+      web3-utils: 1.8.0
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /source-map-support/0.5.21:
+    resolution: {integrity: sha512-uBHU3L3czsIyYXKX88fdrGovxdSCoTGDRZ6SYXtSRxLZUzHg5P/66Ht6uoUlHu9EZod+inXhKo3qQgwXUT/y1w==}
+    dependencies:
+      buffer-from: 1.1.2
+      source-map: 0.6.1
+    dev: true
+
+  /source-map/0.2.0:
+    resolution: {integrity: sha512-CBdZ2oa/BHhS4xj5DlhjWNHcan57/5YuvfdLf17iVmIpd9KRm+DFLmC6nBNj+6Ua7Kt3TmOjDpQT1aTYOQtoUA==}
+    engines: {node: '>=0.8.0'}
+    requiresBuild: true
+    dependencies:
+      amdefine: 1.0.1
+    dev: true
+    optional: true
+
+  /source-map/0.6.1:
+    resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /sprintf-js/1.0.3:
+    resolution: {integrity: sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==}
+    dev: true
+
+  /sshpk/1.17.0:
+    resolution: {integrity: sha512-/9HIEs1ZXGhSPE8X6Ccm7Nam1z8KcoCqPdI7ecm1N33EzAetWahvQWVqLZtaZQ+IDKX4IyA2o0gBzqIMkAagHQ==}
+    engines: {node: '>=0.10.0'}
+    hasBin: true
+    dependencies:
+      asn1: 0.2.6
+      assert-plus: 1.0.0
+      bcrypt-pbkdf: 1.0.2
+      dashdash: 1.14.1
+      ecc-jsbn: 0.1.2
+      getpass: 0.1.7
+      jsbn: 0.1.1
+      safer-buffer: 2.1.2
+      tweetnacl: 0.14.5
+    dev: true
+
+  /stacktrace-parser/0.1.10:
+    resolution: {integrity: sha512-KJP1OCML99+8fhOHxwwzyWrlUuVX5GQ0ZpJTd1DFXhdkrvg1szxfHhawXUZ3g9TkXORQd4/WG68jMlQZ2p8wlg==}
+    engines: {node: '>=6'}
+    dependencies:
+      type-fest: 0.7.1
+    dev: true
+
+  /statuses/2.0.1:
+    resolution: {integrity: sha512-RwNA9Z/7PrK06rYLIzFMlaF+l73iwpzsqRIFgbMLbTcLD6cOao82TaWefPXQvB2fOC4AjuYSEndS7N/mTCbkdQ==}
+    engines: {node: '>= 0.8'}
+    dev: true
+
+  /stealthy-require/1.1.1:
+    resolution: {integrity: sha512-ZnWpYnYugiOVEY5GkcuJK1io5V8QmNYChG62gSit9pQVGErXtrKuPC55ITaVSukmMta5qpMU7vqLt2Lnni4f/g==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /streamsearch/1.1.0:
+    resolution: {integrity: sha512-Mcc5wHehp9aXz1ax6bZUyY5afg9u2rv5cqQI3mRrYkGC8rW2hM02jWuwjtL++LS5qinSyhj2QfLyNsuc+VsExg==}
+    engines: {node: '>=10.0.0'}
+    dev: true
+
+  /string-format/2.0.0:
+    resolution: {integrity: sha512-bbEs3scLeYNXLecRRuk6uJxdXUSj6le/8rNPHChIJTn2V79aXVTR1EH2OH5zLKKoz0V02fOUKZZcw01pLUShZA==}
+    dev: true
+
+  /string-width/2.1.1:
+    resolution: {integrity: sha512-nOqH59deCq9SRHlxq1Aw85Jnt4w6KvLKqWVik6oA9ZklXLNIOlqg4F2yrT1MVaTjAqvVwdfeZ7w7aCvJD7ugkw==}
+    engines: {node: '>=4'}
+    dependencies:
+      is-fullwidth-code-point: 2.0.0
+      strip-ansi: 4.0.0
+    dev: true
+
+  /string-width/3.1.0:
+    resolution: {integrity: sha512-vafcv6KjVZKSgz06oM/H6GDBrAtz8vdhQakGjFIvNrHA6y3HCF1CInLy+QLq8dTJPQ1b+KDUqDFctkdRW44e1w==}
+    engines: {node: '>=6'}
+    dependencies:
+      emoji-regex: 7.0.3
+      is-fullwidth-code-point: 2.0.0
+      strip-ansi: 5.2.0
+    dev: true
+
+  /string-width/4.2.3:
+    resolution: {integrity: sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==}
+    engines: {node: '>=8'}
+    dependencies:
+      emoji-regex: 8.0.0
+      is-fullwidth-code-point: 3.0.0
+      strip-ansi: 6.0.1
+    dev: true
+
+  /string.prototype.trimend/1.0.5:
+    resolution: {integrity: sha512-I7RGvmjV4pJ7O3kdf+LXFpVfdNOxtCW/2C8f6jNiW4+PQchwxkCDzlk1/7p+Wl4bqFIZeF47qAHXLuHHWKAxog==}
+    dependencies:
+      call-bind: 1.0.2
+      define-properties: 1.1.4
+      es-abstract: 1.20.4
+    dev: true
+
+  /string.prototype.trimstart/1.0.5:
+    resolution: {integrity: sha512-THx16TJCGlsN0o6dl2o6ncWUsdgnLRSA23rRE5pyGBw/mLr3Ej/R2LaqCtgP8VNMGZsvMWnf9ooZPyY2bHvUFg==}
+    dependencies:
+      call-bind: 1.0.2
+      define-properties: 1.1.4
+      es-abstract: 1.20.4
+    dev: true
+
+  /string_decoder/1.1.1:
+    resolution: {integrity: sha512-n/ShnvDi6FHbbVfviro+WojiFzv+s8MPMHBczVePfUpDJLwoLT0ht1l4YwBCbi8pJAveEEdnkHyPyTP/mzRfwg==}
+    dependencies:
+      safe-buffer: 5.1.2
+    dev: true
+
+  /string_decoder/1.3.0:
+    resolution: {integrity: sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==}
+    dependencies:
+      safe-buffer: 5.2.1
+    dev: true
+
+  /strip-ansi/4.0.0:
+    resolution: {integrity: sha512-4XaJ2zQdCzROZDivEVIDPkcQn8LMFSa8kj8Gxb/Lnwzv9A8VctNZ+lfivC/sV3ivW8ElJTERXZoPBRrZKkNKow==}
+    engines: {node: '>=4'}
+    dependencies:
+      ansi-regex: 3.0.1
+    dev: true
+
+  /strip-ansi/5.2.0:
+    resolution: {integrity: sha512-DuRs1gKbBqsMKIZlrffwlug8MHkcnpjs5VPmL1PAh+mA30U0DTotfDZ0d2UUsXpPmPmMMJ6W773MaA3J+lbiWA==}
+    engines: {node: '>=6'}
+    dependencies:
+      ansi-regex: 4.1.1
+    dev: true
+
+  /strip-ansi/6.0.1:
+    resolution: {integrity: sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==}
+    engines: {node: '>=8'}
+    dependencies:
+      ansi-regex: 5.0.1
+    dev: true
+
+  /strip-hex-prefix/1.0.0:
+    resolution: {integrity: sha1-DF8VX+8RUTczd96du1iNoFUA428=}
+    engines: {node: '>=6.5.0', npm: '>=3'}
+    dependencies:
+      is-hex-prefixed: 1.0.0
+    dev: true
+
+  /strip-json-comments/2.0.1:
+    resolution: {integrity: sha512-4gB8na07fecVVkOI6Rs4e7T6NOTki5EmL7TUduTs6bu3EdnSycntVJ4re8kgZA+wx9IueI2Y11bfbgwtzuE0KQ==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /strip-json-comments/3.1.1:
+    resolution: {integrity: sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /supports-color/3.2.3:
+    resolution: {integrity: sha512-Jds2VIYDrlp5ui7t8abHN2bjAu4LV/q4N2KivFPpGH0lrka0BMq/33AmECUXlKPcHigkNaqfXRENFju+rlcy+A==}
+    engines: {node: '>=0.8.0'}
+    dependencies:
+      has-flag: 1.0.0
+    dev: true
+
+  /supports-color/5.5.0:
+    resolution: {integrity: sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==}
+    engines: {node: '>=4'}
+    dependencies:
+      has-flag: 3.0.0
+    dev: true
+
+  /supports-color/6.0.0:
+    resolution: {integrity: sha512-on9Kwidc1IUQo+bQdhi8+Tijpo0e1SS6RoGo2guUwn5vdaxw8RXOF9Vb2ws+ihWOmh4JnCJOvaziZWP1VABaLg==}
+    engines: {node: '>=6'}
+    dependencies:
+      has-flag: 3.0.0
+    dev: true
+
+  /supports-color/7.2.0:
+    resolution: {integrity: sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==}
+    engines: {node: '>=8'}
+    dependencies:
+      has-flag: 4.0.0
+    dev: true
+
+  /supports-color/8.1.1:
+    resolution: {integrity: sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q==}
+    engines: {node: '>=10'}
+    dependencies:
+      has-flag: 4.0.0
+    dev: true
+
+  /supports-preserve-symlinks-flag/1.0.0:
+    resolution: {integrity: sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==}
+    engines: {node: '>= 0.4'}
+    dev: true
+
+  /sync-request/6.1.0:
+    resolution: {integrity: sha512-8fjNkrNlNCrVc/av+Jn+xxqfCjYaBoHqCsDz6mt030UMxJGr+GSfCV1dQt2gRtlL63+VPidwDVLr7V2OcTSdRw==}
+    engines: {node: '>=8.0.0'}
+    dependencies:
+      http-response-object: 3.0.2
+      sync-rpc: 1.3.6
+      then-request: 6.0.2
+    dev: true
+
+  /sync-rpc/1.3.6:
+    resolution: {integrity: sha512-J8jTXuZzRlvU7HemDgHi3pGnh/rkoqR/OZSjhTyyZrEkkYQbk7Z33AXp37mkPfPpfdOuj7Ex3H/TJM1z48uPQw==}
+    dependencies:
+      get-port: 3.2.0
+    dev: true
+
+  /table-layout/1.0.2:
+    resolution: {integrity: sha512-qd/R7n5rQTRFi+Zf2sk5XVVd9UQl6ZkduPFC3S7WEGJAmetDTjY3qPN50eSKzwuzEyQKy5TN2TiZdkIjos2L6A==}
+    engines: {node: '>=8.0.0'}
+    dependencies:
+      array-back: 4.0.2
+      deep-extend: 0.6.0
+      typical: 5.2.0
+      wordwrapjs: 4.0.1
+    dev: true
+
+  /table/6.8.0:
+    resolution: {integrity: sha512-s/fitrbVeEyHKFa7mFdkuQMWlH1Wgw/yEXMt5xACT4ZpzWFluehAxRtUUQKPuWhaLAWhFcVx6w3oC8VKaUfPGA==}
+    engines: {node: '>=10.0.0'}
+    dependencies:
+      ajv: 8.11.0
+      lodash.truncate: 4.4.2
+      slice-ansi: 4.0.0
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+    dev: true
+
+  /then-request/6.0.2:
+    resolution: {integrity: sha512-3ZBiG7JvP3wbDzA9iNY5zJQcHL4jn/0BWtXIkagfz7QgOL/LqjCEOBQuJNZfu0XYnv5JhKh+cDxCPM4ILrqruA==}
+    engines: {node: '>=6.0.0'}
+    dependencies:
+      '@types/concat-stream': 1.6.1
+      '@types/form-data': 0.0.33
+      '@types/node': 8.10.66
+      '@types/qs': 6.9.7
+      caseless: 0.12.0
+      concat-stream: 1.6.2
+      form-data: 2.5.1
+      http-basic: 8.1.3
+      http-response-object: 3.0.2
+      promise: 8.2.0
+      qs: 6.11.0
+    dev: true
+
+  /tmp/0.0.33:
+    resolution: {integrity: sha512-jRCJlojKnZ3addtTOjdIqoRuPEKBvNXcGYqzO6zWZX8KfKEpnGY5jfggJQ3EjKuu8D4bJRr0y+cYJFmYbImXGw==}
+    engines: {node: '>=0.6.0'}
+    dependencies:
+      os-tmpdir: 1.0.2
+    dev: true
+
+  /to-regex-range/5.0.1:
+    resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==}
+    engines: {node: '>=8.0'}
+    dependencies:
+      is-number: 7.0.0
+    dev: true
+
+  /toidentifier/1.0.1:
+    resolution: {integrity: sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==}
+    engines: {node: '>=0.6'}
+    dev: true
+
+  /tough-cookie/2.5.0:
+    resolution: {integrity: sha512-nlLsUzgm1kfLXSXfRZMc1KLAugd4hqJHDTvc2hDIwS3mZAfMEuMbc03SujMF+GEcpaX/qboeycw6iO8JwVv2+g==}
+    engines: {node: '>=0.8'}
+    dependencies:
+      psl: 1.9.0
+      punycode: 2.1.1
+    dev: true
+
+  /ts-command-line-args/2.3.1:
+    resolution: {integrity: sha512-FR3y7pLl/fuUNSmnPhfLArGqRrpojQgIEEOVzYx9DhTmfIN7C9RWSfpkJEF4J+Gk7aVx5pak8I7vWZsaN4N84g==}
+    hasBin: true
+    dependencies:
+      chalk: 4.1.2
+      command-line-args: 5.2.1
+      command-line-usage: 6.1.3
+      string-format: 2.0.0
+    dev: true
+
+  /ts-essentials/7.0.3_typescript@4.8.4:
+    resolution: {integrity: sha512-8+gr5+lqO3G84KdiTSMRLtuyJ+nTBVRKuCrK4lidMPdVeEp0uqC875uE5NMcaA7YYMN7XsNiFQuMvasF8HT/xQ==}
+    peerDependencies:
+      typescript: '>=3.7.0'
+    dependencies:
+      typescript: 4.8.4
+    dev: true
+
+  /ts-node/10.9.1_ieummqxttktzud32hpyrer46t4:
+    resolution: {integrity: sha512-NtVysVPkxxrwFGUUxGYhfux8k78pQB3JqYBXlLRZgdGUqTO5wU/UyHop5p70iEbGhB7q5KmiZiU0Y3KlJrScEw==}
+    hasBin: true
+    peerDependencies:
+      '@swc/core': '>=1.2.50'
+      '@swc/wasm': '>=1.2.50'
+      '@types/node': '*'
+      typescript: '>=2.7'
+    peerDependenciesMeta:
+      '@swc/core':
+        optional: true
+      '@swc/wasm':
+        optional: true
+    dependencies:
+      '@cspotcode/source-map-support': 0.8.1
+      '@tsconfig/node10': 1.0.9
+      '@tsconfig/node12': 1.0.11
+      '@tsconfig/node14': 1.0.3
+      '@tsconfig/node16': 1.0.3
+      '@types/node': 18.7.13
+      acorn: 8.8.0
+      acorn-walk: 8.2.0
+      arg: 4.1.3
+      create-require: 1.1.1
+      diff: 4.0.2
+      make-error: 1.3.6
+      typescript: 4.8.4
+      v8-compile-cache-lib: 3.0.1
+      yn: 3.1.1
+    dev: true
+
+  /tslib/1.14.1:
+    resolution: {integrity: sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==}
+    dev: true
+
+  /tsort/0.0.1:
+    resolution: {integrity: sha1-4igPXoF/i/QnVlf9D5rr1E9aJ4Y=}
+    dev: true
+
+  /tunnel-agent/0.6.0:
+    resolution: {integrity: sha512-McnNiV1l8RYeY8tBgEpuodCC1mLUdbSN+CYBL7kJsJNInOP8UjDDEwdk6Mw60vdLLrr5NHKZhMAOSrR2NZuQ+w==}
+    dependencies:
+      safe-buffer: 5.2.1
+    dev: true
+
+  /tweetnacl-util/0.15.1:
+    resolution: {integrity: sha512-RKJBIj8lySrShN4w6i/BonWp2Z/uxwC3h4y7xsRrpP59ZboCd0GpEVsOnMDYLMmKBpYhb5TgHzZXy7wTfYFBRw==}
+    dev: true
+
+  /tweetnacl/0.14.5:
+    resolution: {integrity: sha512-KXXFFdAbFXY4geFIwoyNK+f5Z1b7swfXABfL7HXCmoIWMKU3dmS26672A4EeQtDzLKy7SXmfBu51JolvEKwtGA==}
+    dev: true
+
+  /tweetnacl/1.0.3:
+    resolution: {integrity: sha512-6rt+RN7aOi1nGMyC4Xa5DdYiukl2UWCbcJft7YhxReBGQD7OAM8Pbxw6YMo4r2diNEA8FEmu32YOn9rhaiE5yw==}
+    dev: true
+
+  /type-check/0.3.2:
+    resolution: {integrity: sha512-ZCmOJdvOWDBYJlzAoFkC+Q0+bUyEOS1ltgp1MGU03fqHG+dbi9tBFU2Rd9QKiDZFAYrhPh2JUf7rZRIuHRKtOg==}
+    engines: {node: '>= 0.8.0'}
+    dependencies:
+      prelude-ls: 1.1.2
+    dev: true
+
+  /type-detect/4.0.8:
+    resolution: {integrity: sha512-0fr/mIH1dlO+x7TlcMy+bIDqKPsw/70tVyeHW787goQjhmqaZe10uwLujubK9q9Lg6Fiho1KUKDYz0Z7k7g5/g==}
+    engines: {node: '>=4'}
+    dev: true
+
+  /type-fest/0.21.3:
+    resolution: {integrity: sha512-t0rzBq87m3fVcduHDUFhKmyyX+9eo6WQjZvf51Ea/M0Q7+T374Jp1aUiyUl0GKxp8M/OETVHSDvmkyPgvX+X2w==}
+    engines: {node: '>=10'}
+    dev: true
+
+  /type-fest/0.7.1:
+    resolution: {integrity: sha512-Ne2YiiGN8bmrmJJEuTWTLJR32nh/JdL1+PSicowtNb0WFpn59GK8/lfD61bVtzguz7b3PBt74nxpv/Pw5po5Rg==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /typechain/8.1.0_typescript@4.8.4:
+    resolution: {integrity: sha512-5jToLgKTjHdI1VKqs/K8BLYy42Sr3o8bV5ojh4MnR9ExHO83cyyUdw+7+vMJCpKXUiVUvARM4qmHTFuyaCMAZQ==}
+    hasBin: true
+    peerDependencies:
+      typescript: '>=4.3.0'
+    dependencies:
+      '@types/prettier': 2.7.1
+      debug: 4.3.4
+      fs-extra: 7.0.1
+      glob: 7.1.7
+      js-sha3: 0.8.0
+      lodash: 4.17.21
+      mkdirp: 1.0.4
+      prettier: 2.7.1
+      ts-command-line-args: 2.3.1
+      ts-essentials: 7.0.3_typescript@4.8.4
+      typescript: 4.8.4
+    transitivePeerDependencies:
+      - supports-color
+    dev: true
+
+  /typedarray/0.0.6:
+    resolution: {integrity: sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==}
+    dev: true
+
+  /typescript/4.8.4:
+    resolution: {integrity: sha512-QCh+85mCy+h0IGff8r5XWzOVSbBO+KfeYrMQh7NJ58QujwcE22u+NUSmUxqF+un70P9GXKxa2HCNiTTMJknyjQ==}
+    engines: {node: '>=4.2.0'}
+    hasBin: true
+    dev: true
+
+  /typical/4.0.0:
+    resolution: {integrity: sha512-VAH4IvQ7BDFYglMd7BPRDfLgxZZX4O4TFcRDA6EN5X7erNJJq+McIEp8np9aVtxrCJ6qx4GTYVfOWNjcqwZgRw==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /typical/5.2.0:
+    resolution: {integrity: sha512-dvdQgNDNJo+8B2uBQoqdb11eUCE1JQXhvjC/CZtgvZseVd5TYMXnq0+vuUemXbd/Se29cTaUuPX3YIc2xgbvIg==}
+    engines: {node: '>=8'}
+    dev: true
+
+  /uglify-js/3.17.3:
+    resolution: {integrity: sha512-JmMFDME3iufZnBpyKL+uS78LRiC+mK55zWfM5f/pWBJfpOttXAqYfdDGRukYhJuyRinvPVAtUhvy7rlDybNtFg==}
+    engines: {node: '>=0.8.0'}
+    hasBin: true
+    requiresBuild: true
+    dev: true
+    optional: true
+
+  /unbox-primitive/1.0.2:
+    resolution: {integrity: sha512-61pPlCD9h51VoreyJ0BReideM3MDKMKnh6+V9L08331ipq6Q8OFXZYiqP6n/tbHx4s5I9uRhcye6BrbkizkBDw==}
+    dependencies:
+      call-bind: 1.0.2
+      has-bigints: 1.0.2
+      has-symbols: 1.0.3
+      which-boxed-primitive: 1.0.2
+    dev: true
+
+  /undici/5.11.0:
+    resolution: {integrity: sha512-oWjWJHzFet0Ow4YZBkyiJwiK5vWqEYoH7BINzJAJOLedZ++JpAlCbUktW2GQ2DS2FpKmxD/JMtWUUWl1BtghGw==}
+    engines: {node: '>=12.18'}
+    dependencies:
+      busboy: 1.6.0
+    dev: true
+
+  /universalify/0.1.2:
+    resolution: {integrity: sha512-rBJeI5CXAlmy1pV+617WB9J63U6XcazHHF2f2dbJix4XzpUF0RS3Zbj0FGIOCAva5P/d/GBOYaACQ1w+0azUkg==}
+    engines: {node: '>= 4.0.0'}
+    dev: true
+
+  /universalify/2.0.0:
+    resolution: {integrity: sha512-hAZsKq7Yy11Zu1DE0OzWjw7nnLZmJZYTDZZyEFHZdUhV8FkH5MCfoU1XMaxXovpyW5nq5scPqq0ZDP9Zyl04oQ==}
+    engines: {node: '>= 10.0.0'}
+    dev: true
+
+  /unpipe/1.0.0:
+    resolution: {integrity: sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==}
+    engines: {node: '>= 0.8'}
+    dev: true
+
+  /uri-js/4.4.1:
+    resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==}
+    dependencies:
+      punycode: 2.1.1
+    dev: true
+
+  /utf8/3.0.0:
+    resolution: {integrity: sha512-E8VjFIQ/TyQgp+TZfS6l8yp/xWppSAHzidGiRrqe4bK4XP9pTRyKFgGJpO3SN7zdX4DeomTrwaseCHovfpFcqQ==}
+    dev: true
+
+  /util-deprecate/1.0.2:
+    resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}
+    dev: true
+
+  /uuid/2.0.1:
+    resolution: {integrity: sha512-nWg9+Oa3qD2CQzHIP4qKUqwNfzKn8P0LtFhotaCTFchsV7ZfDhAybeip/HZVeMIpZi9JgY1E3nUlwaCmZT1sEg==}
+    deprecated: Please upgrade  to version 7 or higher.  Older versions may use Math.random() in certain circumstances, which is known to be problematic.  See https://v8.dev/blog/math-random for details.
+    dev: true
+
+  /uuid/3.4.0:
+    resolution: {integrity: sha512-HjSDRw6gZE5JMggctHBcjVak08+KEVhSIiDzFnT9S9aegmp85S/bReBVTb4QTFaRNptJ9kuYaNhnbNEOkbKb/A==}
+    deprecated: Please upgrade  to version 7 or higher.  Older versions may use Math.random() in certain circumstances, which is known to be problematic.  See https://v8.dev/blog/math-random for details.
+    hasBin: true
+    dev: true
+
+  /uuid/8.3.2:
+    resolution: {integrity: sha512-+NYs2QeMWy+GWFOEm9xnn6HCDp0l7QBD7ml8zLUmJ+93Q5NF0NocErnwkTkXVFNiX3/fpC6afS8Dhb/gz7R7eg==}
+    hasBin: true
+    dev: true
+
+  /v8-compile-cache-lib/3.0.1:
+    resolution: {integrity: sha512-wa7YjyUGfNZngI/vtK0UHAN+lgDCxBPCylVXGp0zu59Fz5aiGtNXaq3DhIov063MorB+VfufLh3JlF2KdTK3xg==}
+    dev: true
+
+  /verror/1.10.0:
+    resolution: {integrity: sha1-OhBcoXBTr1XW4nDB+CiGguGNpAA=}
+    engines: {'0': node >=0.6.0}
+    dependencies:
+      assert-plus: 1.0.0
+      core-util-is: 1.0.2
+      extsprintf: 1.3.0
+    dev: true
+
+  /web3-utils/1.8.0:
+    resolution: {integrity: sha512-7nUIl7UWpLVka2f09CMbKOSEvorvHnaugIabU4mj7zfMvm0tSByLcEu3eyV9qgS11qxxLuOkzBIwCstTflhmpQ==}
+    engines: {node: '>=8.0.0'}
+    dependencies:
+      bn.js: 5.2.1
+      ethereum-bloom-filters: 1.0.10
+      ethereumjs-util: 7.1.5
+      ethjs-unit: 0.1.6
+      number-to-bn: 1.7.0
+      randombytes: 2.1.0
+      utf8: 3.0.0
+    dev: true
+
+  /which-boxed-primitive/1.0.2:
+    resolution: {integrity: sha512-bwZdv0AKLpplFY2KZRX6TvyuN7ojjr7lwkg6ml0roIy9YeuSr7JS372qlNW18UQYzgYK9ziGcerWqZOmEn9VNg==}
+    dependencies:
+      is-bigint: 1.0.4
+      is-boolean-object: 1.1.2
+      is-number-object: 1.0.7
+      is-string: 1.0.7
+      is-symbol: 1.0.4
+    dev: true
+
+  /which-module/2.0.0:
+    resolution: {integrity: sha512-B+enWhmw6cjfVC7kS8Pj9pCrKSc5txArRyaYGe088shv/FGWH+0Rjx/xPgtsWfsUtS27FkP697E4DDhgrgoc0Q==}
+    dev: true
+
+  /which/1.3.1:
+    resolution: {integrity: sha512-HxJdYWq1MTIQbJ3nw0cqssHoTNU267KlrDuGZ1WYlxDStUtKUhOaJmh112/TZmHxxUfuJqPXSOm7tDyas0OSIQ==}
+    hasBin: true
+    dependencies:
+      isexe: 2.0.0
+    dev: true
+
+  /wide-align/1.1.3:
+    resolution: {integrity: sha512-QGkOQc8XL6Bt5PwnsExKBPuMKBxnGxWWW3fU55Xt4feHozMUhdUMaBCk290qpm/wG5u/RSKzwdAC4i51YigihA==}
+    dependencies:
+      string-width: 2.1.1
+    dev: true
+
+  /word-wrap/1.2.3:
+    resolution: {integrity: sha512-Hz/mrNwitNRh/HUAtM/VT/5VH+ygD6DV7mYKZAtHOrbs8U7lvPS6xf7EJKMF0uW1KJCl0H701g3ZGus+muE5vQ==}
+    engines: {node: '>=0.10.0'}
+    dev: true
+
+  /wordwrap/1.0.0:
+    resolution: {integrity: sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==}
+    dev: true
+
+  /wordwrapjs/4.0.1:
+    resolution: {integrity: sha512-kKlNACbvHrkpIw6oPeYDSmdCTu2hdMHoyXLTcUKala++lx5Y+wjJ/e474Jqv5abnVmwxw08DiTuHmw69lJGksA==}
+    engines: {node: '>=8.0.0'}
+    dependencies:
+      reduce-flatten: 2.0.0
+      typical: 5.2.0
+    dev: true
+
+  /workerpool/6.2.1:
+    resolution: {integrity: sha512-ILEIE97kDZvF9Wb9f6h5aXK4swSlKGUcOEGiIYb2OOu/IrDU9iwj0fD//SsA6E5ibwJxpEvhullJY4Sl4GcpAw==}
+    dev: true
+
+  /wrap-ansi/5.1.0:
+    resolution: {integrity: sha512-QC1/iN/2/RPVJ5jYK8BGttj5z83LmSKmvbvrXPNCLZSEb32KKVDJDl/MOt2N01qU2H/FkzEa9PKto1BqDjtd7Q==}
+    engines: {node: '>=6'}
+    dependencies:
+      ansi-styles: 3.2.1
+      string-width: 3.1.0
+      strip-ansi: 5.2.0
+    dev: true
+
+  /wrap-ansi/7.0.0:
+    resolution: {integrity: sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==}
+    engines: {node: '>=10'}
+    dependencies:
+      ansi-styles: 4.3.0
+      string-width: 4.2.3
+      strip-ansi: 6.0.1
+    dev: true
+
+  /wrappy/1.0.2:
+    resolution: {integrity: sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==}
+    dev: true
+
+  /ws/7.4.6:
+    resolution: {integrity: sha512-YmhHDO4MzaDLB+M9ym/mDA5z0naX8j7SIlT8f8z+I0VtzsRbekxEutHSme7NPS2qE8StCYQNUnfWdXta/Yu85A==}
+    engines: {node: '>=8.3.0'}
+    peerDependencies:
+      bufferutil: ^4.0.1
+      utf-8-validate: ^5.0.2
+    peerDependenciesMeta:
+      bufferutil:
+        optional: true
+      utf-8-validate:
+        optional: true
+    dev: true
+
+  /ws/7.5.9:
+    resolution: {integrity: sha512-F+P9Jil7UiSKSkppIiD94dN07AwvFixvLIj1Og1Rl9GGMuNipJnV9JzjD6XuqmAeiswGvUmNLjr5cFuXwNS77Q==}
+    engines: {node: '>=8.3.0'}
+    peerDependencies:
+      bufferutil: ^4.0.1
+      utf-8-validate: ^5.0.2
+    peerDependenciesMeta:
+      bufferutil:
+        optional: true
+      utf-8-validate:
+        optional: true
+    dev: true
+
+  /xmlhttprequest/1.8.0:
+    resolution: {integrity: sha1-Z/4HXFwk/vOfnWX197f+dRcZaPw=}
+    engines: {node: '>=0.4.0'}
+    dev: true
+
+  /y18n/4.0.3:
+    resolution: {integrity: sha512-JKhqTOwSrqNA1NY5lSztJ1GrBiUodLMmIZuLiDaMRJ+itFd+ABVE8XBjOvIWL+rSqNDC74LCSFmlb/U4UZ4hJQ==}
+    dev: true
+
+  /y18n/5.0.8:
+    resolution: {integrity: sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==}
+    engines: {node: '>=10'}
+    dev: true
+
+  /yallist/3.1.1:
+    resolution: {integrity: sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g==}
+    dev: true
+
+  /yallist/4.0.0:
+    resolution: {integrity: sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==}
+    dev: true
+
+  /yargs-parser/13.1.2:
+    resolution: {integrity: sha512-3lbsNRf/j+A4QuSZfDRA7HRSfWrzO0YjqTJd5kjAq37Zep1CEgaYmrH9Q3GwPiB9cHyd1Y1UwggGhJGoxipbzg==}
+    dependencies:
+      camelcase: 5.3.1
+      decamelize: 1.2.0
+    dev: true
+
+  /yargs-parser/20.2.4:
+    resolution: {integrity: sha512-WOkpgNhPTlE73h4VFAFsOnomJVaovO8VqLDzy5saChRBFQFBoMYirowyW+Q9HB4HFF4Z7VZTiG3iSzJJA29yRA==}
+    engines: {node: '>=10'}
+    dev: true
+
+  /yargs-unparser/1.6.0:
+    resolution: {integrity: sha512-W9tKgmSn0DpSatfri0nx52Joq5hVXgeLiqR/5G0sZNDoLZFOr/xjBUDcShCOGNsBnEMNo1KAMBkTej1Hm62HTw==}
+    engines: {node: '>=6'}
+    dependencies:
+      flat: 4.1.1
+      lodash: 4.17.21
+      yargs: 13.3.2
+    dev: true
+
+  /yargs-unparser/2.0.0:
+    resolution: {integrity: sha512-7pRTIA9Qc1caZ0bZ6RYRGbHJthJWuakf+WmHK0rVeLkNrrGhfoabBNdue6kdINI6r4if7ocq9aD/n7xwKOdzOA==}
+    engines: {node: '>=10'}
+    dependencies:
+      camelcase: 6.3.0
+      decamelize: 4.0.0
+      flat: 5.0.2
+      is-plain-obj: 2.1.0
+    dev: true
+
+  /yargs/13.3.2:
+    resolution: {integrity: sha512-AX3Zw5iPruN5ie6xGRIDgqkT+ZhnRlZMLMHAs8tg7nRruy2Nb+i5o9bwghAogtM08q1dpr2LVoS8KSTMYpWXUw==}
+    dependencies:
+      cliui: 5.0.0
+      find-up: 3.0.0
+      get-caller-file: 2.0.5
+      require-directory: 2.1.1
+      require-main-filename: 2.0.0
+      set-blocking: 2.0.0
+      string-width: 3.1.0
+      which-module: 2.0.0
+      y18n: 4.0.3
+      yargs-parser: 13.1.2
+    dev: true
+
+  /yargs/16.2.0:
+    resolution: {integrity: sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==}
+    engines: {node: '>=10'}
+    dependencies:
+      cliui: 7.0.4
+      escalade: 3.1.1
+      get-caller-file: 2.0.5
+      require-directory: 2.1.1
+      string-width: 4.2.3
+      y18n: 5.0.8
+      yargs-parser: 20.2.4
+    dev: true
+
+  /yn/3.1.1:
+    resolution: {integrity: sha512-Ux4ygGWsu2c7isFWe8Yu1YluJmqVhxqK2cLXNQA5AcC3QfbGNpM7fu0Y8b/z16pXLnFxZYvWhd3fhBY9DLmC6Q==}
+    engines: {node: '>=6'}
+    dev: true
+
+  /yocto-queue/0.1.0:
+    resolution: {integrity: sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==}
+    engines: {node: '>=10'}
+    dev: true

From 2fbadd621ea523c42bbedaf5014fb43f17aa16cb Mon Sep 17 00:00:00 2001
From: Dror Tirosh <dror@opengsn.org>
Date: Mon, 2 Jan 2023 04:00:02 +0200
Subject: [PATCH 098/274] EIP-4337 - AA-100: Change bundling rules to prevent
 any cross-op access (#6246)

---
 EIPS/eip-4337.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-4337.md b/EIPS/eip-4337.md
index da3ef3156e5d73..65b4d0e14cdcc0 100644
--- a/EIPS/eip-4337.md
+++ b/EIPS/eip-4337.md
@@ -341,7 +341,8 @@ These UserOperations can be bundled together with UserOperations from the main m
 
 During bundling, the client should:
 
-* Exclude UserOps that access any sender address created by another UserOp on the same batch (via a factory).
+* Exclude UserOps that access any sender address of another UserOp in the same batch.
+* Exclude UserOps that access any address created by another UserOp validation in the same batch (via a factory).
 * For each paymaster used in the batch, keep track of the balance while adding UserOps. Ensure that it has sufficient deposit to pay for all the UserOps that use it.
 * Sort UserOps by aggregator, to create the lists of UserOps-per-aggregator.
 * For each aggregator, run the aggregator-specific code to create aggregated signature, and update the UserOps

From 1dcee3f1235607692053191c2952d1977f57d7a2 Mon Sep 17 00:00:00 2001
From: lightclient <14004106+lightclient@users.noreply.github.com>
Date: Mon, 2 Jan 2023 01:28:38 -0700
Subject: [PATCH 099/274] 3540: type size range should start at 0 (#6248)

---
 EIPS/eip-3540.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-3540.md b/EIPS/eip-3540.md
index 038500049c4b23..89aa8a109cc51c 100644
--- a/EIPS/eip-3540.md
+++ b/EIPS/eip-3540.md
@@ -86,7 +86,7 @@ The EOF header is followed by at least one section header. Each section header c
 | description       | length  | value         |                   |
 |-------------------|---------|---------------|-------------------|
 | section_kind      | 1-byte  | 0x01–0xFF     | `uint8`           |
-| section_size      | 2-bytes | 0x0001–0xFFFF | `uint16`          |
+| section_size      | 2-bytes | 0x0000–0xFFFF | `uint16`          |
 | section_size_list | dynamic | n/a           | `uint16, uint16+` |
 
 The list of section headers is terminated with the *section headers terminator byte* `0x00`. The body content follows immediately after.

From 82701cd81fcba1238c200ae6865c88a9db36ad69 Mon Sep 17 00:00:00 2001
From: Dror Tirosh <dror@opengsn.org>
Date: Mon, 2 Jan 2023 13:56:45 +0200
Subject: [PATCH 100/274] EIP-4337 AA-99 account returns validAfter,validUntil
 (#6250)

---
 EIPS/eip-4337.md | 44 ++++++++++++++++++++++++++++----------------
 1 file changed, 28 insertions(+), 16 deletions(-)

diff --git a/EIPS/eip-4337.md b/EIPS/eip-4337.md
index 65b4d0e14cdcc0..86ee5bb9705f7a 100644
--- a/EIPS/eip-4337.md
+++ b/EIPS/eip-4337.md
@@ -84,11 +84,21 @@ struct UserOpsPerAggregator {
 }
 function simulateValidation(UserOperation calldata userOp);
 
-error ValidationResult(uint256 preOpGas, uint256 prefund, uint256 deadline,
-  StakeInfo senderInfo, StakeInfo factoryInfo, StakeInfo paymasterInfo);
-
-error ValidationResultWithAggregation(uint256 preOpGas, uint256 prefund, uint256 deadline,
-  StakeInfo senderInfo, StakeInfo factoryInfo, StakeInfo paymasterInfo, AggregatorStakeInfo aggregatorInfo);
+error ValidationResult(ReturnInfo returnInfo,
+    StakeInfo senderInfo, StakeInfo factoryInfo, StakeInfo paymasterInfo);
+
+error ValidationResultWithAggregation(ReturnInfo returnInfo,
+    StakeInfo senderInfo, StakeInfo factoryInfo, StakeInfo paymasterInfo,
+    AggregatorStakeInfo aggregatorInfo);
+
+struct ReturnInfo {
+  uint256 preOpGas;
+  uint256 prefund;
+  bool sigFailed;
+  uint64 validAfter;
+  uint64 validUntil;
+  bytes paymasterContext;
+}
 
 struct StakeInfo {
   uint256 stake;
@@ -107,7 +117,7 @@ The core interface required for an account to have is:
 interface IAccount {
   function validateUserOp
       (UserOperation calldata userOp, bytes32 userOpHash, address aggregator, uint256 missingAccountFunds)
-      external returns (uint256 deadline);
+      external returns (uint256 sigTimeRange);
 }
 ```
 
@@ -120,9 +130,11 @@ The account
 * MUST pay the entryPoint (caller) at least the "missingAccountFunds" (which might be zero, in case current account's deposit is high enough)
 * The account MAY pay more than this minimum, to cover future transactions (it can always issue `withdrawTo` to retrieve it)
 * The `aggregator` SHOULD be ignored for accounts that don't use an aggregator
-* The return value `deadline` is either zero (meaning "indefinitely"), or the last timestamp this request is deemed valid.
-  (or SIG_VALIDATION_FAILED on signature mismatch)
-
+* The return value is packed of sigFailure, validUntil and validAfter  timestamps.
+  * `sigFailure` is 1 byte value of "1" the signature check failed (should not revert on signature failure, to support estimate)
+  * `validUntil` is 8-byte timestamp value, or zero for "infinite". The UserOp is valid only up to this time.
+  * `validAfter` is 8-byte timestamp. The UserOp is valid only after this time.
+  
 An account that works with aggregated signature should have the interface:
 
 ```solidity
@@ -208,9 +220,9 @@ Maliciously crafted paymasters _can_ DoS the system. To prevent this, we use a r
 The paymaster interface is as follows:
 
 ```c++
-function validatePaymasterUserOp
+  function validatePaymasterUserOp
     (UserOperation calldata userOp, bytes32 userOpHash, uint256 maxCost)
-    external returns (bytes memory context, uint256 deadline);
+    external returns (bytes memory context, uint256 sigTimeRange);
 
 function postOp
     (PostOpMode mode, bytes calldata context, uint256 actualGasCost)
@@ -289,9 +301,9 @@ The simulated call performs the full validation, by calling:
 2. `account.validateUserOp`.
 3. if specified a paymaster: `paymaster.validatePaymasterUserOp`.
 
-Either `validateUserOp` or `validatePaymasterUserOp` may return a "deadline", which is the latest timestamp that this UserOperation is valid on-chain.
-the simulateValidation call returns the minimum of those deadlines.
-A node MAY drop a UserOperation if the deadline is too soon (e.g. wouldn't make it to the next block)
+Either `validateUserOp` or `validatePaymasterUserOp` may return a "validAfter" and "validUntil" timestamps, which is the time-range that this UserOperation is valid on-chain.
+The simulateValidation call returns this range.
+A node MAY drop a UserOperation if it expires too soon (e.g. wouldn't make it to the next block)
 
 The operations differ in their opcode banning policy.
 In order to distinguish between them, there is a call to the NUMBER opcode (`block.number`), used as a delimiter between the 3 functions.
@@ -499,8 +511,8 @@ The result `SHOULD` be set to the **userOpHash** if and only if the request pass
     * The `message` field SHOULD be set to the revert message from the paymaster
     * The `data` field MUST contain a `paymaster` value
   * **code: -32502** - transaction rejected because of opcode validation
-  * **code: -32503** - UserOperation expires shortly: either wallet or paymaster returned an `deadline` that will expire soon
-    * The `data` field SHOULD contain a `deadline` value
+  * **code: -32503** - UserOperation out of time-range: either wallet or paymaster returned a time-range, and it is already expired (or will expire soon)
+    * The `data` field SHOULD contain the `validUntil` and `validAfter` values
     * The `data` field SHOULD contain a `paymaster` value, if this error was triggered by the paymaster
   * **code: -32504** - transaction rejected because paymaster (or signature aggregator) is throttled/banned
     * The `data` field SHOULD contain a `paymaster` or `aggregator` value, depending on the failed entity

From d45b70b0ee58960a3e86dea9e83f5ffa6120cba0 Mon Sep 17 00:00:00 2001
From: Dror Tirosh <dror@opengsn.org>
Date: Tue, 3 Jan 2023 00:05:54 +0200
Subject: [PATCH 101/274] update unstaked entity rules (#6252)

---
 EIPS/eip-4337.md | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-4337.md b/EIPS/eip-4337.md
index 86ee5bb9705f7a..5ca80ed964d3d7 100644
--- a/EIPS/eip-4337.md
+++ b/EIPS/eip-4337.md
@@ -382,7 +382,7 @@ Exceptions to the forbidden opcodes:
 
 ### Reputation scoring and throttling/banning for global entities
 
-#### ReputationRationale.
+#### Reputation Rationale.
 
 UserOperation's storage access rules prevent them from interfere with each other.
 But "global" entities - paymasters, factories and aggregators are accessed by multiple UserOperations, and thus might invalidate multiple previously-valid UserOperations.
@@ -390,8 +390,9 @@ But "global" entities - paymasters, factories and aggregators are accessed by mu
 To prevent abuse, we throttle down (or completely ban for a period of time) an entity that causes invalidation of large number of UserOperations in the mempool.
 To prevent such entities from "sybil-attack", we require them to stake with the system, and thus make such DoS attack very expensive.
 Note that this stake is never slashed, and can be withdrawn any time (after unstake delay)
-The only exemption from staking is if the entity doesn't use storage during validation.
-(unstaked entity may use storage [associated with the sender](#storage-associated-with-an-address))
+
+Unstaked entities are allowed, under the rules below.
+
 When staked, an entity is also allowed to use its own associated storage, in addition to sender's associated storage.
 
 The stake value is not enforced on-chain, but specifically by each node while simulating a transaction.
@@ -399,6 +400,14 @@ The stake is expected to be above MIN_STAKE_VALUE, and unstake delay above MIN_U
 The value of MIN_UNSTAKE_DELAY is 84600 (one day)
 The value of MIN_STAKE_VALUE is determined per chain, and specified in the "bundler specification test suite"
 
+#### Un-staked entities
+
+Under the following special conditions, unstaked entities still can be used:
+
+- An entity that doesn't use any storage at all, or only the senders's storage (not the entity's storage - that does require a stake)
+- If the UserOp doesn't create a new account (that is initCode is empty), then the entity may also use [storage associated with the sender](#storage-associated-with-an-address))
+- A paymaster that has a “postOp()” method (that is, validatePaymasterUserOp returns “context”) must be staked
+
 #### Specification.
 
 In the following specification, "entity" is either address that is explicitly referenced by the UserOperation: sender, factory, paymaster and aggregator.

From a277b08d87d97ebf9d06ab7f8d770281b1994fe3 Mon Sep 17 00:00:00 2001
From: Zergity <37166829+Zergity@users.noreply.github.com>
Date: Tue, 3 Jan 2023 05:07:39 +0700
Subject: [PATCH 102/274] Add EIP-6120: Universal Token Router (#6120)

* add templater EIP

* fill in informations

* spec action and interface

* update specs

* Reference Implementation and Usage Samples

* <TBD> quote

* EVM-compatible networks

* more code comments

* update Abstract

* autho email in angle brackets

* correct the description

* address PR comments

* asign EIP number

* code formats

* rename title and address PR comments

* add discussions topic URL

* eipw: markdown-link-first

* correct the Output Action number for verification

* remove iface in js code

* Apply suggestions from code review

* add some motivation texts and update new reference implementation

* RFC 2119 keywords

* add some security related contents

* rename all 'Universal Router' to 'Universal Token Router'

* update new specs

* fix the optional output execution and texts

* remove unused UniswapV2Helper01.swapTokensForExactTokens function

* update style and correct typos

* completely rewritten

* status: Review

* address CI issues

* some text for clarification

* address CI issues
---
 EIPS/eip-6120.md | 517 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 517 insertions(+)
 create mode 100644 EIPS/eip-6120.md

diff --git a/EIPS/eip-6120.md b/EIPS/eip-6120.md
new file mode 100644
index 00000000000000..71757b910dfff4
--- /dev/null
+++ b/EIPS/eip-6120.md
@@ -0,0 +1,517 @@
+---
+eip: 6120
+title: Universal Token Router
+description: A single router contract enables tokens to be sent to application contracts in the transfer-and-call manner instead of approve-then-call.
+author: Zergity (@Zergity), Zergity <zergity@gmail.com>
+discussions-to: https://ethereum-magicians.org/t/eip-6120-universal-token-router/12142
+status: Review
+type: Standards Track
+category: ERC
+created: 2022-12-12
+requires: 20, 721, 1155
+---
+
+## Abstract
+
+ETH is designed with transfer-and-call as the default behavior in a transaction. Unfortunately, [EIP-20](./eip-20.md) is not designed with that pattern in mind and newer standards are too late to replace it as the de facto standard.
+
+Application and router contracts have to use the approve-then-call pattern which costs additional `n*m*l` `allow` (or `permit`) transactions, for `n` contracts, `m` tokens, and `l` user addresses. These allowance transactions not only cost enormous amounts of user gas, waste network storage and throughput, and worsen user experience, but also put users at serious security risks as they often have to approve unaudited, unverified and upgradable proxy contracts.
+
+The Universal Token Router (UTR) separates the token allowance from the application logic, allowing any token to be spent in a contract call the same way with ETH, without approving any other application contracts.
+
+Tokens approved to the Universal Token Router can only be spent in transactions directly signed by their owner, and they have clearly visible token transfer behavior, including token types (ETH, [EIP-20](./eip-20.md), [EIP-721](./eip-721.md) or [EIP-1155](./eip-1155.md)), `amountInMax`, `amountOutMin`, and `recipient`.
+
+The Universal Token Router contract is counter-factually deployed using `CREATE2` at a single address across all EVM-compatible networks, so new token contracts can pre-configure it as a trusted spender and no approval transaction is necessary ever again.
+
+## Motivation
+
+When users approve their tokens to a contract, they trust that:
+
+* it only spends the tokens with their permission (usually from `msg.sender` or using `ecrecover`)
+* it does not use `delegatecall` (mostly in upgradable proxies)
+
+By performing the same security conditions above, the Universal Token Router can be shared by all applications, saving `(n-1)*m*l` approval transactions for old tokens and **ALL** approval transactions for new tokens.
+
+Before this EIP, when users sign transactions to spend their approved tokens, they trust the front-end code entirely to construct those transactions honestly and correctly. This puts them at great risk of phishing sites.
+
+The Universal Token Router function arguments can act as a manifest for users when signing a transaction. With the support from wallets, users can see and review their expected token behavior instead of blindly trusting the application contracts and front-end code. Phishing sites will be much easier to detect and avoid for users.
+
+Application contracts follow this standard can use the Universal Token Router to have the following benefits:
+
+* Share the user token allowance with all other applications.
+* Freely update their helper contract logic.
+* Save development and security audit costs on router contracts.
+
+## Specification
+
+```solidity
+struct Token {
+    uint eip;       // token standard: 0 for ETH or EIP number
+    address adr;    // token contract address
+    uint id;        // token id for EIP721 and EIP1155
+    uint amount;    // amountInMax for input action, amountOutMin for output action
+    uint offset;    // byte offset to get the amountIn from the last inputParams
+    address recipient;
+}
+```
+
+```solidity
+struct Action {
+    uint output;    // 0 for input, 1 for mandatory output, 2 for optional (failable) output
+    address code;   // contract code address
+    bytes data;     // contract input data
+    Token[] tokens; // tokens to transfer or verify balance
+}
+```
+
+```solidity
+interface IUniversalTokenRouter {
+    function exec(Action[] calldata actions) external payable;
+}
+```
+
+### Input Action
+
+Actions with `action.output == 0` declare which and how many tokens are transferred from `msg.sender` to `token.recipient`.
+
+1. If the `action.data` is not empty, `action.code.call(action.data)` is executed and the value returned is recorded in `amountIns` as a `bytes` for subsequence token transfer amounts.
+2. For each `token` in `action.tokens`:
+   * (a) The amount of token to be transferred is determined as:
+     * if `offset < 32`, `amountIn = token.amount`
+     * if `offset >= 32`, `amountIn = amountIns.slice(offset-32, offset)`
+     * `amountIn` MUST NOT greater than `token.amount`, otherwise, transaction will be reverted with `EXCESSIVE_INPUT_AMOUNT` reason.
+   * (b) If the token is `ETH` and the `recipient` is `0x0`, step **(c)** is skipped and the `amountIn` will be passed to the next output action as the transaction value.
+   * (c) Transfer `amountIn` of token from `msg.sender` to `recipient`.
+
+Note: `amountIns` is the last value returned by an input action's code contract call. It can be shared by multiple input actions until another action's code is executed. Using `amountIns` (by passing `offset >= 32`) before any input action execution can produce unexpected `amountIn` value.
+
+### Output Action
+
+Actions with `action.output > 0` declare the main application action to execute, and optionally verify the output tokens after all is done.
+
+1. For each `token` in `action.tokens` with `amount > 0`, the current token balance of `recipient` is recorded for later verification.
+2. Execute the `action.code.call{value: value}(action.data)`, where `value` can be zero or the `amountIn` of the last `ETH` input with `recipient == 0x0` (see Input Action 2b).
+3. `action.code` execution failure (revert) can be ignored by passing `action.output == 2`.
+
+The last `amountIns` bytes can be passed to an output action code execution by:
+
+* using a function with the last param is a `bytes memory` or `bytes calldata` type.
+* pass the following value to that last param in the output `action.data`:
+    `AMOUNT_INS_PLACEHOLDER = keccak256('UniversalTokenRouter.AMOUNT_INS_PLACEHOLDER')`
+
+### Output Token Verification
+
+After all the actions are handled as above, every token balance tracked in Output Action #1 is queried again for comparison. The balance change MUST NOT be less than `amount` of each token, otherwise, transaction will be reverted with `INSUFFICIENT_OUTPUT_AMOUNT` reason.
+
+A special id `EIP_721_ALL = keccak256('UniversalTokenRouter.EIP_721_ALL')` is reserved for EIP-721, which can be used in output actions to verify the total amount of all ids owned by the `recipient` address.
+
+### Usage Samples
+
+#### `UniswapRouter.swapExactTokensForTokens`
+
+Legacy function:
+
+```solidity
+UniswapV2Router01.swapExactTokensForTokens(
+    uint amountIn,
+    uint amountOutMin,
+    address[] calldata path,
+    address to,
+    uint deadline
+)
+```
+
+This function does what `UniswapV2Router01.swapExactTokensForTokens` does, without the token transfer part:
+
+```solidity
+UniswapV2Helper01.swapExactTokensForTokens(
+    uint amountIn,
+    uint amountOutMin,
+    address[] calldata path,
+    address to,
+    uint deadline
+)
+```
+
+This transaction is signed by users to execute the swap instead of the legacy function:
+
+```javascript
+UniversalTokenRouter.exec([{
+    output: 0,
+    code: AddressZero,
+    data: '0x',
+    tokens: [{
+        eip: 20,
+        token: path[0],
+        id: 0,
+        amount: amountIn,
+        offset: 0, // use amount specified above
+        recipient: UniswapV2Library.pairFor(factory, path[0], path[1]),
+    }],
+}, {
+    output: 1,
+    code: UniswapV2Helper01.address,
+    data: encodeFunctionData("swapExactTokensForTokens", [amountIn, amountOutMin, path, to, deadline]),
+    tokens: [{
+        eip: 20,
+        token: path[path.length-1],
+        id: 0,
+        amount: amountOutMin,
+        offset: 0, // unused for output action
+        recipient: to,
+    }],
+}])
+```
+
+#### `UniswapRouter.swapTokensForExactTokens`
+
+Legacy function:
+
+```solidity
+UniswapV2Router01.swapTokensForExactTokens(
+    uint amountOut,
+    uint amountInMax,
+    address[] calldata path,
+    address to,
+    uint deadline
+)
+```
+
+This function accepts the `uint[] amounts` as the last `bytes` param, decode and pass to the internal function `_swap` of `UniswapV2Helper01`.
+
+```solidity
+UniswapV2Helper01.swap(address[] calldata path, address _to, bytes calldata amountsBytes) external {
+    uint[] memory amounts = abi.decode(amountsBytes, (uint[]));
+    _swap(amounts, path, _to);
+}
+```
+
+This transaction is signed by users to execute the swap instead of the legacy function:
+
+```javascript
+UniversalTokenRouter.exec([{
+    output: 0,
+    code: UniswapV2Helper01.address,
+    data: encodeFunctionData("getAmountIns", [amountOut, path]),
+    tokens: [{
+        eip: 20,
+        token: path[0],
+        id: 0,
+        amount: amountInMax,
+        offset: 64, // first item of getAmountIns result
+        recipient: UniswapV2Library.pairFor(factory, path[0], path[1]),
+    }],
+}, {
+    output: 1,
+    code: UniswapV2Helper01.address,
+    data: encodeFunctionData("swap", [path, to, AMOUNT_INS_PLACEHOLDER]),
+    tokens: [{
+        eip: 20,
+        token: path[path.length-1],
+        id: 0,
+        amount: amountOut,
+        offset: 0, // unused for output action
+        recipient: to,
+    }],
+}])
+```
+
+The result of input action's `getAmountIns` will replace the `AMOUNT_INS_PLACEHOLDER` bytes, save the transaction from calculating twice with the same data.
+
+#### `UniswapRouter.addLiquidity`
+
+Legacy function:
+
+```solidity
+UniswapV2Router01.addLiquidity(
+    address tokenA,
+    address tokenB,
+    uint amountADesired,
+    uint amountBDesired,
+    uint amountAMin,
+    uint amountBMin,
+    address to,
+    uint deadline
+)
+```
+
+This transaction is signed by users to execute the swap instead of the legacy function:
+
+```javascript
+UniversalTokenRouter.exec([{
+    output: 0,
+    code: UniswapV2Helper01.address,
+    data: encodeFunctionData("_addLiquidity", [
+        tokenA,
+        tokenB,
+        amountADesired,
+        amountBDesired,
+        amountAMin,
+        amountBMin,
+    ]),
+    tokens: [{
+        eip: 20,
+        token: tokenA,
+        id: 0,
+        amount: amountADesired,
+        offset: 32, // first item of _addLiquidity result
+        recipient: UniswapV2Library.pairFor(factory, tokenA, tokenB),
+    }, {
+        eip: 20,
+        token: tokenB,
+        id: 0,
+        amount: amountBDesired,
+        offset: 64, // second item of _addLiquidity result
+        recipient: UniswapV2Library.pairFor(factory, tokenA, tokenB),
+    }],
+}, {
+    output: 1,
+    code: UniswapV2Library.pairFor(factory, tokenA, tokenB),
+    data: encodeFunctionData("mint", [to]),
+    tokens: [{
+        eip: 20,
+        token: UniswapV2Library.pairFor(factory, tokenA, tokenB),
+        id: 0,
+        amount: 1,  // just enough to verify the correct recipient
+        offset: 0,  // unused for output action
+        recipient: to,
+    }],
+}])
+```
+
+The `tokens` verification of the last output action is not performed by Uniswap's legacy function and can be skipped. But the output token verification SHOULD always be done for the `UniversalTokenRouter` so user can see and review the token behavior instead of blindly trust the front-end code.
+
+## Rationale
+
+The `Permit` type signature is not supported since the purpose of the Universal Token Router is to eliminate all `approve` signatures for new tokens, and *most* for old tokens.
+
+Flashloan transactions are out of scope since it requires support from the application contracts themself.
+
+## Backwards Compatibility
+
+Old token contracts (EIP-20, EIP-721 and EIP-1155) require approval for the Universal Token Router once for each account.
+
+New token contracts can pre-configure the Universal Token Router as a trusted spender, and no approval transaction is required.
+
+## Reference Implementation
+
+```solidity
+contract UniversalTokenRouter is IUniversalTokenRouter {
+    uint constant AMOUNT_INS_PLACEHOLDER = uint(keccak256('UniversalTokenRouter.AMOUNT_INS_PLACEHOLDER'));
+    uint constant EIP_721_ALL = uint(keccak256('UniversalTokenRouter.EIP_721_ALL'));
+
+    function exec(
+        Action[] calldata actions
+    ) override external payable {
+    unchecked {
+        uint[][] memory amounts = new uint[][](actions.length);
+        uint value; // track the ETH value to pass to next output action transaction value
+        bytes memory amountIns;
+        for (uint i = 0; i < actions.length; ++i) {
+            Action memory action = actions[i];
+            if (action.output > 0) {
+                // output action
+                amounts[i] = new uint[](action.tokens.length);
+                for (uint j = 0; j < action.tokens.length; ++j) {
+                    Token memory token = action.tokens[j];
+                    if (token.amount > 0) {
+                        // track the recipient balance before the action is executed
+                        amounts[i][j] = _balanceOf(token);
+                    }
+                }
+                if (action.data.length > 0) {
+                    uint length = action.data.length;
+                    if (length >= 4+32*3 &&
+                        _sliceUint(action.data, length) == AMOUNT_INS_PLACEHOLDER &&
+                        _sliceUint(action.data, length-32) == 32)
+                    {
+                        action.data = _concat(action.data, length-32, amountIns);
+                    }
+                    (bool success, bytes memory result) = action.code.call{value: value}(action.data);
+                    // ignore output action error if output == 2
+                    if (!success && action.output == 2) {
+                        assembly {
+                            revert(add(result,32),mload(result))
+                        }
+                    }
+                    delete value; // clear the ETH value after transfer
+                }
+                continue;
+            }
+            // input action
+            if (action.data.length > 0) {
+                bool success;
+                (success, amountIns) = action.code.call(action.data);
+                if (!success) {
+                    assembly {
+                        revert(add(amountIns,32),mload(amountIns))
+                    }
+                }
+            }
+            for (uint j = 0; j < action.tokens.length; ++j) {
+                Token memory token = action.tokens[j];
+                if (token.offset >= 32) {
+                    uint amount = _sliceUint(amountIns, token.offset);
+                    require(amount <= token.amount, "UniversalTokenRouter: EXCESSIVE_INPUT_AMOUNT");
+                    token.amount = amount;
+                }
+                if (token.eip == 0 && token.recipient == address(0x0)) {
+                    value = token.amount;
+                    continue; // ETH not transfered here will be passed to the next output call value
+                }
+                if (token.amount > 0) {
+                    _transfer(token);
+                }
+            }
+        }
+        // refund any left-over ETH
+        uint leftOver = address(this).balance;
+        if (leftOver > 0) {
+            TransferHelper.safeTransferETH(msg.sender, leftOver);
+        }
+        // verify the balance change
+        for (uint i = 0; i < actions.length; ++i) {
+            if (actions[i].output == 0) {
+                continue;
+            }
+            for (uint j = 0; j < actions[i].tokens.length; ++j) {
+                Token memory token = actions[i].tokens[j];
+                if (token.amount == 0) {
+                    continue;
+                }
+                uint balance = _balanceOf(token);
+                uint change = balance - amounts[i][j]; // overflow checked with `change <= balance` bellow
+                require(change >= token.amount && change <= balance, 'UniversalTokenRouter: INSUFFICIENT_OUTPUT_AMOUNT');
+                amounts[i][j] = change;
+            }
+        }
+    } }
+
+    function _transfer(Token memory token) internal {
+    unchecked {
+        if (token.eip == 20) {
+            TransferHelper.safeTransferFrom(token.adr, msg.sender, token.recipient, token.amount);
+        } else if (token.eip == 1155) {
+            IERC1155(token.adr).safeTransferFrom(msg.sender, token.recipient, token.id, token.amount, "");
+        } else if (token.eip == 721) {
+            IERC721(token.adr).safeTransferFrom(msg.sender, token.recipient, token.id);
+        } else if (token.eip == 0) {
+            TransferHelper.safeTransferETH(token.recipient, token.amount);
+        } else {
+            revert("UniversalTokenRouter: INVALID_EIP");
+        }
+    } }
+
+    function _balanceOf(Token memory token) internal view returns (uint balance) {
+    unchecked {
+        if (token.eip == 20) {
+            return IERC20(token.adr).balanceOf(token.recipient);
+        }
+        if (token.eip == 1155) {
+            return IERC1155(token.adr).balanceOf(token.recipient, token.id);
+        }
+        if (token.eip == 721) {
+            if (token.id == EIP_721_ALL) {
+                return IERC721(token.adr).balanceOf(token.recipient);
+            }
+            return IERC721(token.adr).ownerOf(token.id) == token.recipient ? 1 : 0;
+        }
+        if (token.eip == 0) {
+            return token.recipient.balance;
+        }
+        revert("UniversalTokenRouter: INVALID_EIP");
+    } }
+
+    // https://ethereum.stackexchange.com/a/54405
+    function _sliceUint(bytes memory bs, uint start) internal pure returns (uint x) {
+    unchecked {
+        // require(bs.length >= start + 32, "slicing out of range");
+        assembly {
+            x := mload(add(bs, start))
+        }
+    } }
+
+    // https://github.com/GNSPS/solidity-bytes-utils/blob/master/contracts/BytesLib.sol
+    function _concat(
+        bytes memory preBytes,
+        uint length,
+        bytes memory postBytes
+    )
+        internal
+        pure
+        returns (bytes memory bothBytes)
+    {
+        assembly {
+            // Get a location of some free memory and store it in bothBytes as
+            // Solidity does for memory variables.
+            bothBytes := mload(0x40)
+
+            // Store the length of the first bytes array at the beginning of
+            // the memory for bothBytes.
+            mstore(bothBytes, length)
+
+            // Maintain a memory counter for the current write location in the
+            // temp bytes array by adding the 32 bytes for the array length to
+            // the starting location.
+            let mc := add(bothBytes, 0x20)
+            // Stop copying when the memory counter reaches the length of the
+            // first bytes array.
+            let end := add(mc, length)
+
+            for {
+                // Initialize a copy counter to the start of the preBytes data,
+                // 32 bytes into its memory.
+                let cc := add(preBytes, 0x20)
+            } lt(mc, end) {
+                // Increase both counters by 32 bytes each iteration.
+                mc := add(mc, 0x20)
+                cc := add(cc, 0x20)
+            } {
+                // Write the preBytes data into the bothBytes memory 32 bytes
+                // at a time.
+                mstore(mc, mload(cc))
+            }
+
+            // Add the length of postBytes to the current length of bothBytes
+            // and store it as the new length in the first 32 bytes of the
+            // bothBytes memory.
+            length := mload(postBytes)
+            mstore(bothBytes, add(length, mload(bothBytes)))
+
+            // Move the memory counter back from a multiple of 0x20 to the
+            // actual end of the preBytes data.
+            mc := sub(end, 0x20)
+            // Stop copying when the memory counter reaches the new combined
+            // length of the arrays.
+            end := add(end, length)
+
+            for {
+                let cc := postBytes
+            } lt(mc, end) {
+                mc := add(mc, 0x20)
+                cc := add(cc, 0x20)
+            } {
+                mstore(mc, mload(cc))
+            }
+
+            // Update the free-memory pointer by padding our last write location
+            // to 32 bytes: add 31 bytes to the end of bothBytes to move to the
+            // next 32 byte block, then round down to the nearest multiple of
+            // 32. If the sum of the length of the two arrays is zero then add
+            // one before rounding down to leave a blank 32 bytes (the length block with 0).
+            mstore(0x40, and(
+              add(add(end, iszero(add(length, mload(preBytes)))), 31),
+              not(31) // Round down to the nearest 32 bytes.
+            ))
+        }
+    }
+}
+```
+
+## Security Considerations
+
+As long as user tokens are only transferred from `msg.sender`, the token allowance can only be used with transactions signed by the token owner.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 788baf9f005ca7cebdd6e07cf39576aaac61ab0b Mon Sep 17 00:00:00 2001
From: Yamen Merhi <yamennmerhi@gmail.com>
Date: Tue, 3 Jan 2023 14:28:09 +0200
Subject: [PATCH 103/274] Update EIP-725: Improvements (#6103)

* update eip-725 standard

* add example code in assets folder

* resolve ci warnings

* update pragma version for eip725 assets

* resolve other ci warnings

* resolve more ci warnings

* replace issue with ethereum magicians link
---
 EIPS/eip-725.md           |  342 ++++++----
 assets/eip-725/ERC725.sol | 1283 +++++++++++++++++++++++++++++++++++++
 2 files changed, 1506 insertions(+), 119 deletions(-)
 create mode 100644 assets/eip-725/ERC725.sol

diff --git a/EIPS/eip-725.md b/EIPS/eip-725.md
index 5d5e90f4c7a4a6..08452e2464d570 100644
--- a/EIPS/eip-725.md
+++ b/EIPS/eip-725.md
@@ -1,86 +1,165 @@
 ---
 eip: 725
-title: General key-value store and execution standard
+title: General data key/value store and execution
+description: An interface for a smart contract based account with attachable data key/value store
 author: Fabian Vogelsteller (@frozeman), Tyler Yasaka (@tyleryasaka)
-discussions-to: https://github.com/ethereum/EIPs/issues/725
-status: Stagnant
+discussions-to: https://ethereum-magicians.org/t/discussion-for-eip725/12158
+status: Draft
 type: Standards Track
 category: ERC
-requires: 165, 173
 created: 2017-10-02
+requires: 165, 173
 ---
 
-## Simple Summary
+## Abstract
 
-A standard interface for a smart contract based account with attachable key value store.
+The following describes two standards that allow for a generic data storage in a smart contract and a generic execution through a smart contract. These can be used separately or in conjunction and can serve as building blocks for smart contract accounts, upgradable metadata, and other means.
 
-## Abstract
+## Motivation
 
-The following describes standard functions for a unique smart contract based account that can be used by humans,
-groups, organisations, objects and machines.
+The initial motivation came out of the need to create a smart contract account system that's flexible enough to be viable long-term but also defined enough to be standardized. They are a generic set of two standardized building blocks to be used in all forms of smart contracts.
 
-The standard is divided into two sub standards:
+This standard consists of two sub-standards, a generic data key/value store (`ERC725Y`) and a generic execute function (`ERC725X`). Both of these in combination allow for a very flexible and long-lasting account system. The account version of `ERC725` is standardized under `LSP0-ERC725Account`.
 
-`ERC725X`:
-Can execute arbitrary smart contracts and deploy other smart contracts.
+These standards (`ERC725` X and Y) can also be used separately as `ERC725Y` can be used to enhance NFTs and Token metadata or other types of smart contracts. `ERC725X` allows for a generic execution through a smart contract, functioning as an account or actor.
 
-`ERC725Y`:
-Can hold arbitrary data through a generic key/value store.
+## Specification
 
-## Motivation
+### Ownership
 
-Standardizing a minimal interface for a smart contract based account allows any interface to operate through these account types.
-Smart contact based accounts following this standard have the following advantages:
+This contract is controlled by a single owner. The owner can be a smart contract or an external account.
+This standard requires [EIP-173](./eip-173.md) and SHOULD implement the functions:
 
-- can hold any asset (native token, e.g. ERC20 like tokens)
-- can execute any smart contract and deploy smart contracts
-- have upgradeable security (through owner change, e.g. to a gnosis safe)
-- are basic enough to work for for a long time
-- are extensible though additional standardisation of the key/value data.
-- can function as an owner/controller or proxy of other smart contracts
+- `owner() view`
+- `transferOwnership(address newOwner)`
 
-## Specification
+And the event:
+
+- `OwnershipTransferred(address indexed previousOwner, address indexed newOwner)`
+
+---
+
+### `ERC725X`
+
+**`ERC725X`** interface id according to [EIP-165](./eip-165.md): `0x570ef073`.
+
+Smart contracts implementing the `ERC725X` standard MUST implement the [EIP-165](./eip-165.md) `supportsInterface(..)` function and MUST support the `ERC165` and `ERC725X` interface ids.
 
-### ERC725X
+### `ERC725X` Methods
 
-ERC165 identifier: `0x44c028fe`
+Smart contracts implementing the `ERC725X` standard SHOULD implement all of the functions listed below:
 
 #### execute
 
 ```solidity
-function execute(uint256 operationType, address to, uint256 value, bytes calldata data) public payable returns(bytes memory)
+function execute(uint256 operationType, address target, uint256 value, bytes memory data) external payable returns(bytes memory)
 ```
 
-Executes a call on any other smart contracts, transfers the blockchains native token, or deploys a new smart contract.
-MUST only be called by the current owner of the contract.
+Function Selector: `0x44c028fe`
+
+Executes a call on any other smart contracts or address, transfers the blockchains native token, or deploys a new smart contract.
+
 
 _Parameters:_
 
-- `operationType`: the operation to execute.
-- `to`: the smart contract or address to interact with. `to` will be unused if a contract is created (operation 1 and 2).
-- `value`: the value of ETH to transfer.
-- `data`: the call data, or the contract data to deploy.
+- `operationType`: the operation type used to execute.
+- `target`: the smart contract or address to call. `target` will be unused if a contract is created (operation types 1 and 2).
+- `value`: the amount of native tokens to transfer (in Wei).
+- `data`: the call data, or the creation bytecode of the contract to deploy.
 
-_Returns:_ `bytes` , the returned data of the called function, or the address of the contract created (operation 1 and 2).
 
-The `operationType` can be the following:
+_Requirements:_
 
-- `0` for `call`
-- `1` for `create`
-- `2` for `create2`
-- `3` for `staticcall`
-- `4` for `delegatecall`
+- MUST only be called by the current owner of the contract.
+- MUST revert when the execution or the contract creation fails.
+- `target` SHOULD be address(0) in case of contract creation with `CREATE` and `CREATE2` (operation types 1 and 2).
+- `value` SHOULD be zero in case of `STATICCALL` or `DELEGATECALL` (operation types 3 and 4).
 
-Others may be added in the future.
+
+_Returns:_ `bytes` , the returned data of the called function, or the address of the contract deployed (operation types 1 and 2).
 
 **Triggers Event:** [ContractCreated](#contractcreated), [Executed](#executed)
 
-### Events
+The following `operationType` COULD exist:
+
+- `0` for `CALL`
+- `1` for `CREATE`
+- `2` for `CREATE2`
+- `3` for `STATICCALL`
+- `4` for `DELEGATECALL` - **NOTE** This is a potentially dangerous operation type
+
+Others may be added in the future.
+
+#### data parameter
+
+- For operationType, `CALL`, `STATICCALL` and `DELEGATECALL` the data field can be random bytes or an abi-encoded function call.
+
+- For operationType, `CREATE` the `data` field is the creation bytecode of the contract to deploy appended with the constructor argument(s) abi-encoded.
+
+- For operationType, `CREATE2` the `data` field is the creation bytecode of the contract to deploy appended with:
+  1. the constructor argument(s) abi-encoded
+  2. a `bytes32` salt.
+
+```
+data = <contract-creation-code> + <abi-encoded-constructor-arguments> + <bytes32-salt>
+```
+
+> See [EIP-1014: Skinny CREATE2](./eip-1014.md) for more information.
+
+#### execute (Array)
+
+```solidity
+function execute(uint256[] memory operationsType, address[] memory targets, uint256[] memory values, bytes[] memory datas) external payable returns(bytes[] memory)
+```
+
+Function Selector: `0x13ced88d`
+
+Executes a batch of calls on any other smart contracts, transfers the blockchain native token, or deploys a new smart contract.
+
+_Parameters:_
+
+- `operationsType`: the list of operations type used to execute.
+- `targets`: the list of addresses to call. `targets` will be unused if a contract is created (operation types 1 and 2).
+- `values`: the list of native token amounts to transfer (in Wei).
+- `datas`: the list of call data, or the creation bytecode of the contract to deploy.
+
+_Requirements:_
+
+- Parameters array MUST have the same length.
+- MUST only be called by the current owner of the contract.
+- MUST revert when the execution or the contract creation fails.
+- `target` SHOULD be address(0) in case of contract creation with `CREATE` and `CREATE2` (operation types 1 and 2).
+- `value` SHOULD be zero in case of `STATICCALL` or `DELEGATECALL` (operation types 3 and 4).
+
+_Returns:_ `bytes[]` , array list of returned data of the called function, or the address(es) of the contract deployed (operation types 1 and 2).
+
+**Triggers Event:** [ContractCreated](#contractcreated), [Executed](#executed) on each call iteration
+
+
+**Note:** The `execute()` functions use function overloading, therefore it is better to reference them by the given function signature as follows:
+
+```js
+// web3.js example
+
+// execute
+myContract.methods['execute(uint256,address,uint256,bytes)'](OPERATION_CALL, target.address, 2WEI, "0x").send();
+// execute Array 
+myContract.methods['execute(uint256[],address[],uint256[],bytes[])']([OPERATION_CALL, OPERATION_CREATE], [target.address, ZERO_ADDRESS], [2WEI, 0WEI], ["0x", CONTRACT_BYTECODE]).send();
+
+// OR
+
+// execute
+myContract.methods['0x44c028fe'](OPERATION_CALL, target.address, 2WEI, "0x").send();
+// execute Array 
+myContract.methods['0x13ced88d']([OPERATION_CALL, OPERATION_CREATE], [target.address, ZERO_ADDRESS], [2WEI, 0WEI], ["0x", CONTRACT_BYTECODE]).send();
+```
+
+### `ERC725X` Events
 
 #### Executed
 
 ```solidity
-event Executed(uint256 indexed _operation, address indexed _to, uint256 indexed _value, bytes _data);
+event Executed(uint256 indexed operationType, address indexed target, uint256 indexed value, bytes4 data);
 ```
 
 MUST be triggered when `execute` creates a new call using the `operationType` `0`, `3`, `4`.
@@ -88,162 +167,187 @@ MUST be triggered when `execute` creates a new call using the `operationType` `0
 #### ContractCreated
 
 ```solidity
-event ContractCreated(uint256 indexed _operation, address indexed _contractAddress, uint256 indexed _value);
+event ContractCreated(uint256 indexed operationType, address indexed contractAddress, uint256 indexed value, bytes32 salt);
 ```
 
 MUST be triggered when `execute` creates a new contract using the `operationType` `1`, `2`.
 
-### ERC725Y
+---
 
-ERC165 identifier: `0x714df77c`
+### `ERC725Y`
 
-#### setData
+**`ERC725Y`** interface id according to [EIP-165](./eip-165.md): `0x714df77c`.
+
+Smart contracts implementing the `ERC725Y` standard MUST implement the [EIP-165](./eip-165.md) `supportsInterface(..)` function and MUST support the `ERC165` and `ERC725Y` interface ids.
+
+### `ERC725Y` Methods
+
+Smart contracts implementing the `ERC725Y` standard MUST implement all of the functions listed below:
+
+#### getData
 
 ```solidity
-function setData(bytes32 key, bytes memory value) public
+function getData(bytes32 dataKey) external view returns(bytes memory)
 ```
 
-Sets data as bytes in the storage for a single key. MUST only be called by the current owner of the contract.
+Function Selector: `0x54f6127f`
+
+Gets the data set for the given data key.
 
 _Parameters:_
 
-- `key`: the key which value to set.
-- `value`: the data to set.
+- `dataKey`: the data key which value to retrieve.
 
-**Triggers Event:** [DataChanged](#datachanged)
-#### setData (Array)
+_Returns:_ `bytes` , The data for the requested data key.
+
+#### getData (Array)
 
 ```solidity
-function setData(bytes32[] memory keys, bytes[] memory values) public
+function getData(bytes32[] memory dataKeys) external view returns(bytes[] memory)
 ```
 
-Sets array of data at multiple keys. MUST only be called by the current owner of the contract.
+Function Selector: `0x4e3e6e9c`
+
+Gets array of data at multiple given data keys.
 
 _Parameters:_
 
-- `keys`: the keys which values to set.
-- `values`: the array of bytes to set.
+- `dataKeys`: the data keys which values to retrieve.
 
-**Triggers Event:** [DataChanged](#datachanged)
-#### getData
+_Returns:_ `bytes[]` , array of data values for the requested data keys.
+
+#### setData
 
 ```solidity
-function getData(bytes32 key) public view returns(bytes memory)
+function setData(bytes32 dataKey, bytes memory dataValue) external
 ```
 
-Gets the data set for the given key.
+Function Selector: `0x7f23690c`
+
+Sets data as bytes in the storage for a single data key. 
 
 _Parameters:_
 
-- `key`: the key which value to retrieve.
+- `dataKey`: the data key which value to set.
+- `dataValue`: the data to store.
 
-_Returns:_ `bytes` , The data for the requested key.
-#### getData (Array)
+_Requirements:_
+
+- MUST only be called by the current owner of the contract.
+
+**Triggers Event:** [DataChanged](#datachanged)
+
+#### setData (Array)
 
 ```solidity
-function getData(bytes32[] memory keys) public view returns(bytes[] memory)
+function setData(bytes32[] memory dataKeys, bytes[] memory dataValues) external
 ```
 
-Gets array of data at multiple given key.
+Function Selector: `0x14a6e293`
+
+Sets array of data at multiple data keys. MUST only be called by the current owner of the contract.
 
 _Parameters:_
 
-- `keys`: the keys which values to retrieve.
+- `dataKeys`: the data keys which values to set.
+- `dataValues`: the array of bytes to set.
 
-_Returns:_ `bytes[]` , array of the values for the requested keys.
+_Requirements:_
 
+- Array parameters MUST have the same length.
+- MUST only be called by the current owner of the contract.
 
+**Triggers Event:** [DataChanged](#datachanged)
 
+**Note:** `setData()` and `getData()` uses function overloading, therefore it is better to reference them by the given function signature as follows:
 
-### Events
+```js
+// web3.js example
 
-#### DataChanged
+// setData
+myContract.methods['setData(bytes32,bytes)'](dataKey, dataValue).send();
+// setData Array
+myContract.methods['setData(bytes32[],bytes[])']([dataKeys, ...], [dataValues, ...]).send();
 
-```solidity
-event DataChanged(bytes32 indexed key, bytes value)
+// OR
+
+// setData
+myContract.methods['0x7f23690c'](dataKey, dataValue).send();
+// setData Array
+myContract.methods['0x14a6e293']([dataKeys, ...], [dataValues, ...]).send();
 ```
 
-MUST be triggered when `setData` was successfully called.
+### `ERC725Y` Events
 
-### Ownership
-
-This contract is controlled by an owner. The owner can be a smart contract or an external account.
-This standard requires [ERC173](https://github.com/ethereum/EIPs/blob/master/EIPS/eip-173.md) and should implement the functions:
+#### DataChanged
 
-- `owner() view`
-- `transferOwnership(address newOwner)` <br>
+```solidity
+event DataChanged(bytes32 indexed dataKey, bytes dataValue)
+```
 
-The event:
+MUST be triggered when a data key was successfully set.
 
-- `OwnershipTransferred(address indexed previousOwner, address indexed newOwner)`
+### `ERC725Y` Data keys
 
-### Data keys
+Data keys, are the way to retrieve values via `getData()`. These `bytes32` values can be freely chosen, or defined by a standard.
+A common way to define data keys is the hash of a word, e.g. `keccak256('ERCXXXMyNewKeyType')` which results in: `0x6935a24ea384927f250ee0b954ed498cd9203fc5d2bf95c735e52e6ca675e047`
 
-Data keys, should be the keccak256 hash of a type name.
-e.g. `keccak256('ERCXXXMyNewKeyType')` is `0x6935a24ea384927f250ee0b954ed498cd9203fc5d2bf95c735e52e6ca675e047`
+The `LSP2-ERC725JSONSchema` standard is a more explicit `ERC725Y` data key standard, that defines key types and value types, and their encoding and decoding.
 
-The [ERC725JSONSchema standard](https://github.com/lukso-network/LIPs/blob/master/LSPs/LSP-2-ERC725YJSONSchema.md) defines how keys should be named and generated.
-This JSON schema can be used to auto decode ERC725Y values from smart contracts for application and smart contract interactions.
+## Rationale
 
-#### Default key values
+The generic way of storing data keys with values was chosen to allow upgradability over time. Stored data values can be changed over time. Other smart contract protocols can then interpret this data in new ways and react to interactions from a `ERC725` smart contract differently.
 
-ERC725 key standards need to be defined within new standards, we suggest the following defaults:
+The data stored in an `ERC725Y` smart contract is not only readable/writable by off-chain applications, but also by other smart contracts. Function overloading was used to allow for the retrievable of single and multiple keys, to keep gas costs minimal for both use cases.
 
-| Name                   | Description                                              | Key                                                                                                                                        | value                                                                                                  |
-| ---------------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------ |
-| SupportedStandards:XYZ | Allows to determine standards supported by this contract | `0xeafec4d89fa9619884b6b89135626455000000000000000000000000xxxxxxxx`, where `xxxxxxxx` is the 4 bytes identifier of the standard supported | Value can be defined by the standard, by default it should be the 4 bytes identifier e.g. `0x7a30e6fc` |
+## Backwards Compatibility
 
-#### ERC725Account
+All contracts since `ERC725v2` from 2018/19 should be compatible with the current version of the standard. Mainly interface ID and Event parameters have changed, while `getData(bytes32[])` and `setData(bytes32[], bytes[])` was added as an efficient way to set/get multiple keys at once. The same applies to execution, as `execute(..[])` was added as an efficient way to batch calls.
 
-The specification of an ERC725Account can be found in [LSP0-ERC725Account](https://github.com/lukso-network/LIPs/blob/master/LSPs/LSP-0-ERC725Account.md).
+## Reference Implementation
 
-## Rationale
+Reference implementations can be found in [`ERC725.sol`](../assets/eip-725/ERC725.sol).
 
-The purpose of an smart contract account is to allow an entity to exist as a first-class citizen with the ability to execute arbitrary contract calls.
+## Security Considerations
 
-## Implementation
+This contract allows generic executions, therefore special care needs to be taken to prevent re-entrancy attacks and other forms of call chain attacks.
 
-- [Latest implementation](https://github.com/ERC725Alliance/ERC725/tree/master/implementations/contracts)
+When using the operation type `4` for `delegatecall`, it is important to consider that the called contracts can alter the state of the calling contract and also change owner variables and `ERC725Y` data storage entries at will. Additionally calls to `selfdestruct` are possible and other harmful state-changing operations.
 
 ### Solidity Interfaces
 
 ```solidity
 // SPDX-License-Identifier: CC0-1.0
+
 pragma solidity >=0.5.0 <0.7.0;
 
-//ERC165 identifier: `0x44c028fe`
+// ERC165 identifier: `0x570ef073`
 interface IERC725X  /* is ERC165, ERC173 */ {
-    event ContractCreated(uint256 indexed operation, address indexed contractAddress, uint256 indexed value);
-    event Executed(uint256 indexed operation, address indexed to, uint256 indexed  value, bytes data);
 
-    function execute(uint256 operationType, address to, uint256 value, bytes calldata data) external payable returns(bytes memory);
+    event Executed(uint256 indexed operationType, address indexed target, uint256 indexed  value, bytes4 data);
+    event ContractCreated(uint256 indexed operationType, address indexed contractAddress, uint256 indexed value, bytes32 salt);
+
+
+    function execute(uint256 operationType, address target, uint256 value, bytes memory data) external payable returns(bytes memory);
+
+    function execute(uint256[] memory operationsType, address[] memory targets, uint256[] memory values, bytes memory datas) external payable returns(bytes[] memory);
 }
 
-//ERC165 identifier: `0x714df77c`
+// ERC165 identifier: `0x714df77c`
 interface IERC725Y /* is ERC165, ERC173 */ {
-    event DataChanged(bytes32 indexed key, bytes value);
+    
+    event DataChanged(bytes32 indexed dataKey, bytes dataValue);
 
-    function setData(bytes32 key, bytes memory value) external;
-    function setData(bytes32[] memory keys, bytes[] memory values) external;
-    function getData(bytes32 key) external view returns(bytes memory);
-    function getData(bytes32[] memory keys) external view returns(bytes[] memory);
-}
+    function getData(bytes32 dataKey) external view returns(bytes memory);
+    function getData(bytes32[] memory dataKeys) external view returns(bytes[] memory);
 
+    function setData(bytes32 dataKey, bytes memory dataValue) external;
+    function setData(bytes32[] memory dataKeys, bytes[] memory dataValues) external;
+}
 interface IERC725 /* is IERC725X, IERC725Y */ {
-
 }
-
 ```
 
-## Additional References
-
-- [Slides of the ERC Identity presentation](https://www.slideshare.net/FabianVogelsteller/erc-725-identity)
-- [In-contract claim VS claim registry](https://github.com/ethereum/wiki/wiki/ERC-735:-Claim-Holder-Registry-vs.-in-contract)
-- [Identity related reports](https://www.weboftrust.info/specs.html)
-- [W3C Verifiable Claims Use Cases](https://w3c.github.io/vc-use-cases/)
-- [Decentralised Identity Foundation](https://identity.foundation)
-- [Sovrin Foundation Self Sovereign Identity](https://sovrin.org/wp-content/uploads/2017/06/The-Inevitable-Rise-of-Self-Sovereign-Identity.pdf)
-
 ## Copyright
 
 Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-725/ERC725.sol b/assets/eip-725/ERC725.sol
new file mode 100644
index 00000000000000..fbab76f8ef12f1
--- /dev/null
+++ b/assets/eip-725/ERC725.sol
@@ -0,0 +1,1283 @@
+pragma solidity ^0.8.8;
+
+interface IERC165 {
+    /**
+     * @dev Returns true if this contract implements the interface defined by
+     * `interfaceId`. See the corresponding [ERC165] standard.
+     * to learn more about how these ids are created.
+     *
+     * This function call must use less than 30 000 gas.
+     */
+    function supportsInterface(bytes4 interfaceId) external view returns (bool);
+}
+
+contract ERC165 is IERC165 {
+    /**
+     * @inheritdoc IERC165
+     */
+    function supportsInterface(bytes4 interfaceId)
+        public
+        view
+        virtual
+        override
+        returns (bool)
+    {
+        return interfaceId == type(IERC165).interfaceId;
+    }
+}
+
+contract ERC173 {
+    address private _owner;
+
+    event OwnershipTransferred(
+        address indexed previousOwner,
+        address indexed newOwner
+    );
+
+    /**
+     * @dev Initializes the contract setting the deployer as the initial owner.
+     */
+    constructor() {
+        _transferOwnership(msg.sender);
+    }
+
+    /**
+     * @dev Throws if called by any account other than the owner.
+     */
+    modifier onlyOwner() {
+        _checkOwner();
+        _;
+    }
+
+    /**
+     * @dev Returns the address of the current owner.
+     */
+    function owner() public view virtual returns (address) {
+        return _owner;
+    }
+
+    /**
+     * @dev Throws if the sender is not the owner.
+     */
+    function _checkOwner() internal view virtual {
+        require(owner() == msg.sender, "Ownable: caller is not the owner");
+    }
+
+    /**
+     * @dev Leaves the contract without owner. It will not be possible to call
+     * `onlyOwner` functions anymore. Can only be called by the current owner.
+     *
+     * NOTE: Renouncing ownership will leave the contract without an owner,
+     * thereby removing any functionality that is only available to the owner.
+     */
+    function renounceOwnership() public virtual onlyOwner {
+        _transferOwnership(address(0));
+    }
+
+    /**
+     * @dev Transfers ownership of the contract to a new account (`newOwner`).
+     * Can only be called by the current owner.
+     */
+    function transferOwnership(address newOwner) public virtual onlyOwner {
+        require(
+            newOwner != address(0),
+            "Ownable: new owner is the zero address"
+        );
+        _transferOwnership(newOwner);
+    }
+
+    /**
+     * @dev Transfers ownership of the contract to a new account (`newOwner`).
+     * Internal function without access restriction.
+     */
+    function _transferOwnership(address newOwner) internal virtual {
+        address oldOwner = _owner;
+        _owner = newOwner;
+        emit OwnershipTransferred(oldOwner, newOwner);
+    }
+}
+
+interface IERC725X is IERC165 {
+    /**
+     * @notice Emitted when deploying a contract
+     * @param operationType The opcode used to deploy the contract (CREATE or CREATE2)
+     * @param contractAddress The created contract address
+     * @param value The amount of native tokens (in Wei) sent to fund the created contract address
+     * @param salt The salt used in case of CREATE2. Will be bytes32(0) in case of CREATE operation
+     */
+    event ContractCreated(
+        uint256 indexed operationType,
+        address indexed contractAddress,
+        uint256 indexed value,
+        bytes32 salt
+    );
+
+    /**
+     * @notice Emitted when calling an address (EOA or contract)
+     * @param operationType The low-level call opcode used to call the `to` address (CALL, STATICALL or DELEGATECALL)
+     * @param target The address to call. `target` will be unused if a contract is created (operation types 1 and 2).
+     * @param value The amount of native tokens transferred with the call (in Wei)
+     * @param selector The first 4 bytes (= function selector) of the data sent with the call
+     */
+    event Executed(
+        uint256 indexed operationType,
+        address indexed target,
+        uint256 indexed value,
+        bytes4 selector
+    );
+
+    /**
+     * @param operationType The operation type used: CALL = 0; CREATE = 1; CREATE2 = 2; STATICCALL = 3; DELEGATECALL = 4
+     * @param target The address of the EOA or smart contract.  (unused if a contract is created via operation type 1 or 2)
+     * @param value The amount of native tokens to transfer (in Wei)
+     * @param data The call data, or the creation bytecode of the contract to deploy
+     *
+     * @dev Generic executor function to:
+     *
+     * - send native tokens to any address.
+     * - interact with any contract by passing an abi-encoded function call in the `data` parameter.
+     * - deploy a contract by providing its creation bytecode in the `data` parameter.
+     *
+     * Requirements:
+     *
+     * - SHOULD only be callable by the owner of the contract set via ERC173.
+     * - if a `value` is provided, the contract MUST have at least this amount in its balance to execute successfully.
+     * - if the operation type is STATICCALL or DELEGATECALL, `value` SHOULD be 0.
+     * - `target` SHOULD be address(0) when deploying a contract.
+     *
+     * Emits an {Executed} event, when a call is made with `operationType` 0 (CALL), 3 (STATICCALL) or 4 (DELEGATECALL)
+     * Emits a {ContractCreated} event, when deploying a contract with `operationType` 1 (CREATE) or 2 (CREATE2)
+     */
+    function execute(
+        uint256 operationType,
+        address target,
+        uint256 value,
+        bytes memory data
+    ) external payable returns (bytes memory);
+
+    /**
+     * @param operationsType The list of operations type used: CALL = 0; CREATE = 1; CREATE2 = 2; STATICCALL = 3; DELEGATECALL = 4
+     * @param targets The list of addresses to call. `targets` will be unused if a contract is created (operation types 1 and 2).
+     * @param values The list of native token amounts to transfer (in Wei)
+     * @param datas The list of call data, or the creation bytecode of the contract to deploy
+     *
+     * @dev Generic batch executor function to:
+     *
+     * - send native tokens to any address.
+     * - interact with any contract by passing an abi-encoded function call in the `datas` parameter.
+     * - deploy a contract by providing its creation bytecode in the `datas` parameter.
+     *
+     * Requirements:
+     *
+     * - The length of the parameters provided MUST be equal
+     * - SHOULD only be callable by the owner of the contract set via ERC173.
+     * - if a `values` is provided, the contract MUST have at least this amount in its balance to execute successfully.
+     * - if the operation type is STATICCALL or DELEGATECALL, `values` SHOULD be 0.
+     * - `targets` SHOULD be address(0) when deploying a contract.
+     *
+     * Emits an {Executed} event, when a call is made with `operationType` 0 (CALL), 3 (STATICCALL) or 4 (DELEGATECALL)
+     * Emits a {ContractCreated} event, when deploying a contract with `operationType` 1 (CREATE) or 2 (CREATE2)
+     */
+    function execute(
+        uint256[] memory operationsType,
+        address[] memory targets,
+        uint256[] memory values,
+        bytes[] memory datas
+    ) external payable returns (bytes[] memory);
+}
+
+// ERC165 INTERFACE IDs
+bytes4 constant _INTERFACEID_ERC725X = 0x570ef073;
+
+// ERC725X OPERATION TYPES
+uint256 constant OPERATION_0_CALL = 0;
+uint256 constant OPERATION_1_CREATE = 1;
+uint256 constant OPERATION_2_CREATE2 = 2;
+uint256 constant OPERATION_3_STATICCALL = 3;
+uint256 constant OPERATION_4_DELEGATECALL = 4;
+
+/**
+ * @dev reverts when trying to send more native tokens `value` than available in current `balance`.
+ * @param balance the balance of the ERC725X contract.
+ * @param value the amount of native tokens sent via `ERC725X.execute(...)`.
+ */
+error ERC725X_InsufficientBalance(uint256 balance, uint256 value);
+
+/**
+ * @dev reverts when the `operationTypeProvided` is none of the default operation types available.
+ * (CALL = 0; CREATE = 1; CREATE2 = 2; STATICCALL = 3; DELEGATECALL = 4)
+ */
+error ERC725X_UnknownOperationType(uint256 operationTypeProvided);
+
+/**
+ * @dev the `value` parameter (= sending native tokens) is not allowed when making a staticcall
+ * via `ERC725X.execute(...)` because sending native tokens is a state changing operation.
+ */
+error ERC725X_MsgValueDisallowedInStaticCall();
+
+/**
+ * @dev the `value` parameter (= sending native tokens) is not allowed when making a delegatecall
+ * via `ERC725X.execute(...)` because msg.value is persisting.
+ */
+error ERC725X_MsgValueDisallowedInDelegateCall();
+
+/**
+ * @dev reverts when passing a `to` address while deploying a contract va `ERC725X.execute(...)`
+ * whether using operation type 1 (CREATE) or 2 (CREATE2).
+ */
+error ERC725X_CreateOperationsRequireEmptyRecipientAddress();
+
+/**
+ * @dev reverts when contract deployment via `ERC725X.execute(...)` failed.
+ * whether using operation type 1 (CREATE) or 2 (CREATE2).
+ */
+error ERC725X_ContractDeploymentFailed();
+
+/**
+ * @dev reverts when no contract bytecode was provided as parameter when trying to deploy a contract
+ * via `ERC725X.execute(...)`, whether using operation type 1 (CREATE) or 2 (CREATE2).
+ */
+error ERC725X_NoContractBytecodeProvided();
+
+/**
+ * @dev reverts when there is not the same number of operation, to addresses, value, and data.
+ */
+error ERC725X_ExecuteParametersLengthMismatch();
+
+contract ERC725X is ERC173, ERC165, IERC725X {
+    /**
+     * @inheritdoc ERC165
+     */
+    function supportsInterface(bytes4 interfaceId)
+        public
+        view
+        virtual
+        override(IERC165, ERC165)
+        returns (bool)
+    {
+        return
+            interfaceId == _INTERFACEID_ERC725X ||
+            super.supportsInterface(interfaceId);
+    }
+
+    /**
+     * @inheritdoc IERC725X
+     */
+    function execute(
+        uint256 operationType,
+        address target,
+        uint256 value,
+        bytes memory data
+    ) public payable virtual onlyOwner returns (bytes memory) {
+        if (address(this).balance < value) {
+            revert ERC725X_InsufficientBalance(address(this).balance, value);
+        }
+        return _execute(operationType, target, value, data);
+    }
+
+    /**
+     * @inheritdoc IERC725X
+     */
+    function execute(
+        uint256[] memory operationsType,
+        address[] memory targets,
+        uint256[] memory values,
+        bytes[] memory datas
+    ) public payable virtual onlyOwner returns (bytes[] memory result) {
+        if (
+            operationsType.length != targets.length ||
+            (targets.length != values.length || values.length != datas.length)
+        ) revert ERC725X_ExecuteParametersLengthMismatch();
+
+        result = new bytes[](operationsType.length);
+        for (uint256 i = 0; i < operationsType.length; i++) {
+            if (address(this).balance < values[i])
+                revert ERC725X_InsufficientBalance(
+                    address(this).balance,
+                    values[i]
+                );
+
+            result[i] = _execute(
+                operationsType[i],
+                targets[i],
+                values[i],
+                datas[i]
+            );
+        }
+    }
+
+    function _execute(
+        uint256 operationType,
+        address target,
+        uint256 value,
+        bytes memory data
+    ) internal virtual returns (bytes memory) {
+        // CALL
+        if (operationType == OPERATION_0_CALL) {
+            return _executeCall(target, value, data);
+        }
+
+        // Deploy with CREATE
+        if (operationType == uint256(OPERATION_1_CREATE)) {
+            if (target != address(0))
+                revert ERC725X_CreateOperationsRequireEmptyRecipientAddress();
+            return _deployCreate(value, data);
+        }
+
+        // Deploy with CREATE2
+        if (operationType == uint256(OPERATION_2_CREATE2)) {
+            if (target != address(0))
+                revert ERC725X_CreateOperationsRequireEmptyRecipientAddress();
+            return _deployCreate2(value, data);
+        }
+
+        // STATICCALL
+        if (operationType == uint256(OPERATION_3_STATICCALL)) {
+            if (value != 0) revert ERC725X_MsgValueDisallowedInStaticCall();
+            return _executeStaticCall(target, data);
+        }
+
+        // DELEGATECALL
+        //
+        // WARNING! delegatecall is a dangerous operation type! use with EXTRA CAUTION
+        //
+        // delegate allows to call another deployed contract and use its functions
+        // to update the state of the current calling contract.
+        //
+        // this can lead to unexpected behaviour on the contract storage, such as:
+        // - updating any state variables (even if these are protected)
+        // - update the contract owner
+        // - run selfdestruct in the context of this contract
+        //
+        if (operationType == uint256(OPERATION_4_DELEGATECALL)) {
+            if (value != 0) revert ERC725X_MsgValueDisallowedInDelegateCall();
+            return _executeDelegateCall(target, data);
+        }
+
+        revert ERC725X_UnknownOperationType(operationType);
+    }
+
+    /**
+     * @dev perform low-level call (operation type = 0)
+     * @param target The address on which call is executed
+     * @param value The value to be sent with the call
+     * @param data The data to be sent with the call
+     * @return result The data from the call
+     */
+    function _executeCall(
+        address target,
+        uint256 value,
+        bytes memory data
+    ) internal virtual returns (bytes memory result) {
+        emit Executed(OPERATION_0_CALL, target, value, bytes4(data));
+
+        // solhint-disable avoid-low-level-calls
+        (bool success, bytes memory returnData) = target.call{value: value}(
+            data
+        );
+        result = Address.verifyCallResult(
+            success,
+            returnData,
+            "ERC725X: Unknown Error"
+        );
+    }
+
+    /**
+     * @dev perform low-level staticcall (operation type = 3)
+     * @param target The address on which staticcall is executed
+     * @param data The data to be sent with the staticcall
+     * @return result The data returned from the staticcall
+     */
+    function _executeStaticCall(address target, bytes memory data)
+        internal
+        virtual
+        returns (bytes memory result)
+    {
+        emit Executed(OPERATION_3_STATICCALL, target, 0, bytes4(data));
+
+        // solhint-disable avoid-low-level-calls
+        (bool success, bytes memory returnData) = target.staticcall(data);
+        result = Address.verifyCallResult(
+            success,
+            returnData,
+            "ERC725X: Unknown Error"
+        );
+    }
+
+    /**
+     * @dev perform low-level delegatecall (operation type = 4)
+     * @param target The address on which delegatecall is executed
+     * @param data The data to be sent with the delegatecall
+     * @return result The data returned from the delegatecall
+     */
+    function _executeDelegateCall(address target, bytes memory data)
+        internal
+        virtual
+        returns (bytes memory result)
+    {
+        emit Executed(OPERATION_4_DELEGATECALL, target, 0, bytes4(data));
+
+        // solhint-disable avoid-low-level-calls
+        (bool success, bytes memory returnData) = target.delegatecall(data);
+        result = Address.verifyCallResult(
+            success,
+            returnData,
+            "ERC725X: Unknown Error"
+        );
+    }
+
+    /**
+     * @dev deploy a contract using the CREATE opcode (operation type = 1)
+     * @param value The value to be sent to the contract created
+     * @param creationCode The contract creation bytecode to deploy appended with the constructor argument(s)
+     * @return newContract The address of the contract created as bytes
+     */
+    function _deployCreate(uint256 value, bytes memory creationCode)
+        internal
+        virtual
+        returns (bytes memory newContract)
+    {
+        if (creationCode.length == 0) {
+            revert ERC725X_NoContractBytecodeProvided();
+        }
+
+        address contractAddress;
+        // solhint-disable no-inline-assembly
+        assembly {
+            contractAddress := create(
+                value,
+                add(creationCode, 0x20),
+                mload(creationCode)
+            )
+        }
+
+        if (contractAddress == address(0)) {
+            revert ERC725X_ContractDeploymentFailed();
+        }
+
+        newContract = abi.encodePacked(contractAddress);
+        emit ContractCreated(
+            OPERATION_1_CREATE,
+            contractAddress,
+            value,
+            bytes32(0)
+        );
+    }
+
+    /**
+     * @dev deploy a contract using the CREATE2 opcode (operation type = 2)
+     * @param value The value to be sent to the contract created
+     * @param creationCode The contract creation bytecode to deploy appended with the constructor argument(s) and a bytes32 salt
+     * @return newContract The address of the contract created as bytes
+     */
+    function _deployCreate2(uint256 value, bytes memory creationCode)
+        internal
+        virtual
+        returns (bytes memory newContract)
+    {
+        bytes32 salt = BytesLib.toBytes32(
+            creationCode,
+            creationCode.length - 32
+        );
+        bytes memory bytecode = BytesLib.slice(
+            creationCode,
+            0,
+            creationCode.length - 32
+        );
+
+        address contractAddress;
+        require(
+            address(this).balance >= value,
+            "Create2: insufficient balance"
+        );
+        require(creationCode.length != 0, "Create2: bytecode length is zero");
+        /// @solidity memory-safe-assembly
+        assembly {
+            contractAddress := create2(
+                value,
+                add(bytecode, 0x20),
+                mload(bytecode),
+                salt
+            )
+        }
+        require(contractAddress != address(0), "Create2: Failed on deploy");
+
+        newContract = abi.encodePacked(contractAddress);
+        emit ContractCreated(OPERATION_2_CREATE2, contractAddress, value, salt);
+    }
+}
+
+/**
+ * @title The interface for ERC725Y General data key/value store
+ * @dev ERC725Y provides the ability to set arbitrary data key/value pairs that can be changed over time
+ * It is intended to standardise certain data key/value pairs to allow automated read and writes
+ * from/to the contract storage
+ */
+interface IERC725Y is IERC165 {
+    /**
+     * @notice Emitted when data at a key is changed
+     * @param dataKey The data key which data value is set
+     * @param dataValue The data value to set
+     */
+    event DataChanged(bytes32 indexed dataKey, bytes dataValue);
+
+    /**
+     * @notice Gets singular data at a given `dataKey`
+     * @param dataKey The key which value to retrieve
+     * @return dataValue The data stored at the key
+     */
+    function getData(bytes32 dataKey)
+        external
+        view
+        returns (bytes memory dataValue);
+
+    /**
+     * @notice Gets array of data for multiple given keys
+     * @param dataKeys The array of keys which values to retrieve
+     * @return dataValues The array of data stored at multiple keys
+     */
+    function getData(bytes32[] memory dataKeys)
+        external
+        view
+        returns (bytes[] memory dataValues);
+
+    /**
+     * @notice Sets singular data for a given `dataKey`
+     * @param dataKey The key to retrieve stored value
+     * @param dataValue The value to set
+     * SHOULD only be callable by the owner of the contract set via ERC173
+     *
+     * Emits a {DataChanged} event.
+     */
+    function setData(bytes32 dataKey, bytes memory dataValue) external;
+
+    /**
+     * @param dataKeys The array of data keys for values to set
+     * @param dataValues The array of values to set
+     * @dev Sets array of data for multiple given `dataKeys`
+     * SHOULD only be callable by the owner of the contract set via ERC173
+     *
+     * Emits a {DataChanged} event.
+     */
+    function setData(bytes32[] memory dataKeys, bytes[] memory dataValues)
+        external;
+}
+
+// ERC165 INTERFACE IDs
+bytes4 constant _INTERFACEID_ERC725Y = 0x714df77c;
+
+/**
+ * @dev reverts when there is not the same number of elements in the lists of data keys and data values
+ * when calling setData(bytes32[],bytes[]).
+ * @param dataKeysLength the number of data keys in the bytes32[] dataKeys
+ * @param dataValuesLength the number of data value in the bytes[] dataValue
+ */
+error ERC725Y_DataKeysValuesLengthMismatch(
+    uint256 dataKeysLength,
+    uint256 dataValuesLength
+);
+
+contract ERC725Y is ERC173, ERC165, IERC725Y {
+    // overrides
+
+    /**
+     * @inheritdoc ERC165
+     */
+    function supportsInterface(bytes4 interfaceId)
+        public
+        view
+        virtual
+        override(IERC165, ERC165)
+        returns (bool)
+    {
+        return
+            interfaceId == _INTERFACEID_ERC725Y ||
+            super.supportsInterface(interfaceId);
+    }
+
+    /**
+     * @dev Map the dataKeys to their dataValues
+     */
+    mapping(bytes32 => bytes) internal _store;
+
+    /**
+     * @inheritdoc IERC725Y
+     */
+    function getData(bytes32 dataKey)
+        public
+        view
+        virtual
+        returns (bytes memory dataValue)
+    {
+        dataValue = _getData(dataKey);
+    }
+
+    /**
+     * @inheritdoc IERC725Y
+     */
+    function getData(bytes32[] memory dataKeys)
+        public
+        view
+        virtual
+        returns (bytes[] memory dataValues)
+    {
+        dataValues = new bytes[](dataKeys.length);
+
+        for (uint256 i = 0; i < dataKeys.length; i++) {
+            dataValues[i] = _getData(dataKeys[i]);
+        }
+
+        return dataValues;
+    }
+
+    /**
+     * @inheritdoc IERC725Y
+     */
+    function setData(bytes32 dataKey, bytes memory dataValue)
+        public
+        virtual
+        onlyOwner
+    {
+        _setData(dataKey, dataValue);
+    }
+
+    /**
+     * @inheritdoc IERC725Y
+     */
+    function setData(bytes32[] memory dataKeys, bytes[] memory dataValues)
+        public
+        virtual
+        onlyOwner
+    {
+        if (dataKeys.length != dataValues.length) {
+            revert ERC725Y_DataKeysValuesLengthMismatch(
+                dataKeys.length,
+                dataValues.length
+            );
+        }
+
+        for (uint256 i = 0; i < dataKeys.length; i++) {
+            _setData(dataKeys[i], dataValues[i]);
+        }
+    }
+
+    function _getData(bytes32 dataKey)
+        internal
+        view
+        virtual
+        returns (bytes memory dataValue)
+    {
+        return _store[dataKey];
+    }
+
+    function _setData(bytes32 dataKey, bytes memory dataValue)
+        internal
+        virtual
+    {
+        _store[dataKey] = dataValue;
+        emit DataChanged(dataKey, dataValue);
+    }
+}
+
+contract ERC725 is ERC725X, ERC725Y {
+    /**
+     * @inheritdoc ERC165
+     */
+    function supportsInterface(bytes4 interfaceId)
+        public
+        view
+        virtual
+        override(ERC725X, ERC725Y)
+        returns (bool)
+    {
+        return
+            interfaceId == _INTERFACEID_ERC725X ||
+            interfaceId == _INTERFACEID_ERC725Y ||
+            super.supportsInterface(interfaceId);
+    }
+}
+
+// external needed libraries
+
+library BytesLib {
+    function concat(bytes memory _preBytes, bytes memory _postBytes)
+        internal
+        pure
+        returns (bytes memory)
+    {
+        bytes memory tempBytes;
+
+        assembly {
+            // Get a location of some free memory and store it in tempBytes as
+            // Solidity does for memory variables.
+            tempBytes := mload(0x40)
+
+            // Store the length of the first bytes array at the beginning of
+            // the memory for tempBytes.
+            let length := mload(_preBytes)
+            mstore(tempBytes, length)
+
+            // Maintain a memory counter for the current write location in the
+            // temp bytes array by adding the 32 bytes for the array length to
+            // the starting location.
+            let mc := add(tempBytes, 0x20)
+            // Stop copying when the memory counter reaches the length of the
+            // first bytes array.
+            let end := add(mc, length)
+
+            for {
+                // Initialize a copy counter to the start of the _preBytes data,
+                // 32 bytes into its memory.
+                let cc := add(_preBytes, 0x20)
+            } lt(mc, end) {
+                // Increase both counters by 32 bytes each iteration.
+                mc := add(mc, 0x20)
+                cc := add(cc, 0x20)
+            } {
+                // Write the _preBytes data into the tempBytes memory 32 bytes
+                // at a time.
+                mstore(mc, mload(cc))
+            }
+
+            // Add the length of _postBytes to the current length of tempBytes
+            // and store it as the new length in the first 32 bytes of the
+            // tempBytes memory.
+            length := mload(_postBytes)
+            mstore(tempBytes, add(length, mload(tempBytes)))
+
+            // Move the memory counter back from a multiple of 0x20 to the
+            // actual end of the _preBytes data.
+            mc := end
+            // Stop copying when the memory counter reaches the new combined
+            // length of the arrays.
+            end := add(mc, length)
+
+            for {
+                let cc := add(_postBytes, 0x20)
+            } lt(mc, end) {
+                mc := add(mc, 0x20)
+                cc := add(cc, 0x20)
+            } {
+                mstore(mc, mload(cc))
+            }
+
+            // Update the free-memory pointer by padding our last write location
+            // to 32 bytes: add 31 bytes to the end of tempBytes to move to the
+            // next 32 byte block, then round down to the nearest multiple of
+            // 32. If the sum of the length of the two arrays is zero then add
+            // one before rounding down to leave a blank 32 bytes (the length block with 0).
+            mstore(
+                0x40,
+                and(
+                    add(add(end, iszero(add(length, mload(_preBytes)))), 31),
+                    not(31) // Round down to the nearest 32 bytes.
+                )
+            )
+        }
+
+        return tempBytes;
+    }
+
+    function concatStorage(bytes storage _preBytes, bytes memory _postBytes)
+        internal
+    {
+        assembly {
+            // Read the first 32 bytes of _preBytes storage, which is the length
+            // of the array. (We don't need to use the offset into the slot
+            // because arrays use the entire slot.)
+            let fslot := sload(_preBytes.slot)
+            // Arrays of 31 bytes or less have an even value in their slot,
+            // while longer arrays have an odd value. The actual length is
+            // the slot divided by two for odd values, and the lowest order
+            // byte divided by two for even values.
+            // If the slot is even, bitwise and the slot with 255 and divide by
+            // two to get the length. If the slot is odd, bitwise and the slot
+            // with -1 and divide by two.
+            let slength := div(
+                and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)),
+                2
+            )
+            let mlength := mload(_postBytes)
+            let newlength := add(slength, mlength)
+            // slength can contain both the length and contents of the array
+            // if length < 32 bytes so let's prepare for that
+            // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage
+            switch add(lt(slength, 32), lt(newlength, 32))
+            case 2 {
+                // Since the new array still fits in the slot, we just need to
+                // update the contents of the slot.
+                // uint256(bytes_storage) = uint256(bytes_storage) + uint256(bytes_memory) + new_length
+                sstore(
+                    _preBytes.slot,
+                    // all the modifications to the slot are inside this
+                    // next block
+                    add(
+                        // we can just add to the slot contents because the
+                        // bytes we want to change are the LSBs
+                        fslot,
+                        add(
+                            mul(
+                                div(
+                                    // load the bytes from memory
+                                    mload(add(_postBytes, 0x20)),
+                                    // zero all bytes to the right
+                                    exp(0x100, sub(32, mlength))
+                                ),
+                                // and now shift left the number of bytes to
+                                // leave space for the length in the slot
+                                exp(0x100, sub(32, newlength))
+                            ),
+                            // increase length by the double of the memory
+                            // bytes length
+                            mul(mlength, 2)
+                        )
+                    )
+                )
+            }
+            case 1 {
+                // The stored value fits in the slot, but the combined value
+                // will exceed it.
+                // get the keccak hash to get the contents of the array
+                mstore(0x0, _preBytes.slot)
+                let sc := add(keccak256(0x0, 0x20), div(slength, 32))
+
+                // save new length
+                sstore(_preBytes.slot, add(mul(newlength, 2), 1))
+
+                // The contents of the _postBytes array start 32 bytes into
+                // the structure. Our first read should obtain the `submod`
+                // bytes that can fit into the unused space in the last word
+                // of the stored array. To get this, we read 32 bytes starting
+                // from `submod`, so the data we read overlaps with the array
+                // contents by `submod` bytes. Masking the lowest-order
+                // `submod` bytes allows us to add that value directly to the
+                // stored value.
+
+                let submod := sub(32, slength)
+                let mc := add(_postBytes, submod)
+                let end := add(_postBytes, mlength)
+                let mask := sub(exp(0x100, submod), 1)
+
+                sstore(
+                    sc,
+                    add(
+                        and(
+                            fslot,
+                            0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff00
+                        ),
+                        and(mload(mc), mask)
+                    )
+                )
+
+                for {
+                    mc := add(mc, 0x20)
+                    sc := add(sc, 1)
+                } lt(mc, end) {
+                    sc := add(sc, 1)
+                    mc := add(mc, 0x20)
+                } {
+                    sstore(sc, mload(mc))
+                }
+
+                mask := exp(0x100, sub(mc, end))
+
+                sstore(sc, mul(div(mload(mc), mask), mask))
+            }
+            default {
+                // get the keccak hash to get the contents of the array
+                mstore(0x0, _preBytes.slot)
+                // Start copying to the last used word of the stored array.
+                let sc := add(keccak256(0x0, 0x20), div(slength, 32))
+
+                // save new length
+                sstore(_preBytes.slot, add(mul(newlength, 2), 1))
+
+                // Copy over the first `submod` bytes of the new data as in
+                // case 1 above.
+                let slengthmod := mod(slength, 32)
+                let mlengthmod := mod(mlength, 32)
+                let submod := sub(32, slengthmod)
+                let mc := add(_postBytes, submod)
+                let end := add(_postBytes, mlength)
+                let mask := sub(exp(0x100, submod), 1)
+
+                sstore(sc, add(sload(sc), and(mload(mc), mask)))
+
+                for {
+                    sc := add(sc, 1)
+                    mc := add(mc, 0x20)
+                } lt(mc, end) {
+                    sc := add(sc, 1)
+                    mc := add(mc, 0x20)
+                } {
+                    sstore(sc, mload(mc))
+                }
+
+                mask := exp(0x100, sub(mc, end))
+
+                sstore(sc, mul(div(mload(mc), mask), mask))
+            }
+        }
+    }
+
+    function slice(
+        bytes memory _bytes,
+        uint256 _start,
+        uint256 _length
+    ) internal pure returns (bytes memory) {
+        require(_length + 31 >= _length, "slice_overflow");
+        require(_bytes.length >= _start + _length, "slice_outOfBounds");
+
+        bytes memory tempBytes;
+
+        assembly {
+            switch iszero(_length)
+            case 0 {
+                // Get a location of some free memory and store it in tempBytes as
+                // Solidity does for memory variables.
+                tempBytes := mload(0x40)
+
+                // The first word of the slice result is potentially a partial
+                // word read from the original array. To read it, we calculate
+                // the length of that partial word and start copying that many
+                // bytes into the array. The first word we copy will start with
+                // data we don't care about, but the last `lengthmod` bytes will
+                // land at the beginning of the contents of the new array. When
+                // we're done copying, we overwrite the full first word with
+                // the actual length of the slice.
+                let lengthmod := and(_length, 31)
+
+                // The multiplication in the next line is necessary
+                // because when slicing multiples of 32 bytes (lengthmod == 0)
+                // the following copy loop was copying the origin's length
+                // and then ending prematurely not copying everything it should.
+                let mc := add(
+                    add(tempBytes, lengthmod),
+                    mul(0x20, iszero(lengthmod))
+                )
+                let end := add(mc, _length)
+
+                for {
+                    // The multiplication in the next line has the same exact purpose
+                    // as the one above.
+                    let cc := add(
+                        add(
+                            add(_bytes, lengthmod),
+                            mul(0x20, iszero(lengthmod))
+                        ),
+                        _start
+                    )
+                } lt(mc, end) {
+                    mc := add(mc, 0x20)
+                    cc := add(cc, 0x20)
+                } {
+                    mstore(mc, mload(cc))
+                }
+
+                mstore(tempBytes, _length)
+
+                //update free-memory pointer
+                //allocating the array padded to 32 bytes like the compiler does now
+                mstore(0x40, and(add(mc, 31), not(31)))
+            }
+            //if we want a zero-length slice let's just return a zero-length array
+            default {
+                tempBytes := mload(0x40)
+                //zero out the 32 bytes slice we are about to return
+                //we need to do it because Solidity does not garbage collect
+                mstore(tempBytes, 0)
+
+                mstore(0x40, add(tempBytes, 0x20))
+            }
+        }
+
+        return tempBytes;
+    }
+
+    function toAddress(bytes memory _bytes, uint256 _start)
+        internal
+        pure
+        returns (address)
+    {
+        require(_bytes.length >= _start + 20, "toAddress_outOfBounds");
+        address tempAddress;
+
+        assembly {
+            tempAddress := div(
+                mload(add(add(_bytes, 0x20), _start)),
+                0x1000000000000000000000000
+            )
+        }
+
+        return tempAddress;
+    }
+
+    function toUint8(bytes memory _bytes, uint256 _start)
+        internal
+        pure
+        returns (uint8)
+    {
+        require(_bytes.length >= _start + 1, "toUint8_outOfBounds");
+        uint8 tempUint;
+
+        assembly {
+            tempUint := mload(add(add(_bytes, 0x1), _start))
+        }
+
+        return tempUint;
+    }
+
+    function toUint16(bytes memory _bytes, uint256 _start)
+        internal
+        pure
+        returns (uint16)
+    {
+        require(_bytes.length >= _start + 2, "toUint16_outOfBounds");
+        uint16 tempUint;
+
+        assembly {
+            tempUint := mload(add(add(_bytes, 0x2), _start))
+        }
+
+        return tempUint;
+    }
+
+    function toUint32(bytes memory _bytes, uint256 _start)
+        internal
+        pure
+        returns (uint32)
+    {
+        require(_bytes.length >= _start + 4, "toUint32_outOfBounds");
+        uint32 tempUint;
+
+        assembly {
+            tempUint := mload(add(add(_bytes, 0x4), _start))
+        }
+
+        return tempUint;
+    }
+
+    function toUint64(bytes memory _bytes, uint256 _start)
+        internal
+        pure
+        returns (uint64)
+    {
+        require(_bytes.length >= _start + 8, "toUint64_outOfBounds");
+        uint64 tempUint;
+
+        assembly {
+            tempUint := mload(add(add(_bytes, 0x8), _start))
+        }
+
+        return tempUint;
+    }
+
+    function toUint96(bytes memory _bytes, uint256 _start)
+        internal
+        pure
+        returns (uint96)
+    {
+        require(_bytes.length >= _start + 12, "toUint96_outOfBounds");
+        uint96 tempUint;
+
+        assembly {
+            tempUint := mload(add(add(_bytes, 0xc), _start))
+        }
+
+        return tempUint;
+    }
+
+    function toUint128(bytes memory _bytes, uint256 _start)
+        internal
+        pure
+        returns (uint128)
+    {
+        require(_bytes.length >= _start + 16, "toUint128_outOfBounds");
+        uint128 tempUint;
+
+        assembly {
+            tempUint := mload(add(add(_bytes, 0x10), _start))
+        }
+
+        return tempUint;
+    }
+
+    function toUint256(bytes memory _bytes, uint256 _start)
+        internal
+        pure
+        returns (uint256)
+    {
+        require(_bytes.length >= _start + 32, "toUint256_outOfBounds");
+        uint256 tempUint;
+
+        assembly {
+            tempUint := mload(add(add(_bytes, 0x20), _start))
+        }
+
+        return tempUint;
+    }
+
+    function toBytes32(bytes memory _bytes, uint256 _start)
+        internal
+        pure
+        returns (bytes32)
+    {
+        require(_bytes.length >= _start + 32, "toBytes32_outOfBounds");
+        bytes32 tempBytes32;
+
+        assembly {
+            tempBytes32 := mload(add(add(_bytes, 0x20), _start))
+        }
+
+        return tempBytes32;
+    }
+
+    function equal(bytes memory _preBytes, bytes memory _postBytes)
+        internal
+        pure
+        returns (bool)
+    {
+        bool success = true;
+
+        assembly {
+            let length := mload(_preBytes)
+
+            // if lengths don't match the arrays are not equal
+            switch eq(length, mload(_postBytes))
+            case 1 {
+                // cb is a circuit breaker in the for loop since there's
+                //  no said feature for inline assembly loops
+                // cb = 1 - don't breaker
+                // cb = 0 - break
+                let cb := 1
+
+                let mc := add(_preBytes, 0x20)
+                let end := add(mc, length)
+
+                for {
+                    let cc := add(_postBytes, 0x20)
+                    // the next line is the loop condition:
+                    // while(uint256(mc < end) + cb == 2)
+                } eq(add(lt(mc, end), cb), 2) {
+                    mc := add(mc, 0x20)
+                    cc := add(cc, 0x20)
+                } {
+                    // if any of these checks fails then arrays are not equal
+                    if iszero(eq(mload(mc), mload(cc))) {
+                        // unsuccess:
+                        success := 0
+                        cb := 0
+                    }
+                }
+            }
+            default {
+                // unsuccess:
+                success := 0
+            }
+        }
+
+        return success;
+    }
+
+    function equalStorage(bytes storage _preBytes, bytes memory _postBytes)
+        internal
+        view
+        returns (bool)
+    {
+        bool success = true;
+
+        assembly {
+            // we know _preBytes_offset is 0
+            let fslot := sload(_preBytes.slot)
+            // Decode the length of the stored array like in concatStorage().
+            let slength := div(
+                and(fslot, sub(mul(0x100, iszero(and(fslot, 1))), 1)),
+                2
+            )
+            let mlength := mload(_postBytes)
+
+            // if lengths don't match the arrays are not equal
+            switch eq(slength, mlength)
+            case 1 {
+                // slength can contain both the length and contents of the array
+                // if length < 32 bytes so let's prepare for that
+                // v. http://solidity.readthedocs.io/en/latest/miscellaneous.html#layout-of-state-variables-in-storage
+                if iszero(iszero(slength)) {
+                    switch lt(slength, 32)
+                    case 1 {
+                        // blank the last byte which is the length
+                        fslot := mul(div(fslot, 0x100), 0x100)
+
+                        if iszero(eq(fslot, mload(add(_postBytes, 0x20)))) {
+                            // unsuccess:
+                            success := 0
+                        }
+                    }
+                    default {
+                        // cb is a circuit breaker in the for loop since there's
+                        //  no said feature for inline assembly loops
+                        // cb = 1 - don't breaker
+                        // cb = 0 - break
+                        let cb := 1
+
+                        // get the keccak hash to get the contents of the array
+                        mstore(0x0, _preBytes.slot)
+                        let sc := keccak256(0x0, 0x20)
+
+                        let mc := add(_postBytes, 0x20)
+                        let end := add(mc, mlength)
+
+                        // the next line is the loop condition:
+                        // while(uint256(mc < end) + cb == 2)
+                        for {
+
+                        } eq(add(lt(mc, end), cb), 2) {
+                            sc := add(sc, 1)
+                            mc := add(mc, 0x20)
+                        } {
+                            if iszero(eq(sload(sc), mload(mc))) {
+                                // unsuccess:
+                                success := 0
+                                cb := 0
+                            }
+                        }
+                    }
+                }
+            }
+            default {
+                // unsuccess:
+                success := 0
+            }
+        }
+
+        return success;
+    }
+}
+
+library Address {
+    /**
+     * @dev Tool to verifies that a low level call was successful, and revert if it wasn't, either by bubbling the
+     * revert reason using the provided one.
+     */
+    function verifyCallResult(
+        bool success,
+        bytes memory returndata,
+        string memory errorMessage
+    ) internal pure returns (bytes memory) {
+        if (success) {
+            return returndata;
+        } else {
+            // Look for revert reason and bubble it up if present
+            if (returndata.length > 0) {
+                // The easiest way to bubble the revert reason is using memory via assembly
+                /// @solidity memory-safe-assembly
+                assembly {
+                    let returndata_size := mload(returndata)
+                    revert(add(32, returndata), returndata_size)
+                }
+            } else {
+                revert(errorMessage);
+            }
+        }
+    }
+}

From 03cc2f375bc920429d402c5734bd99c24a4a5558 Mon Sep 17 00:00:00 2001
From: Antonio Viggiano <agfviggiano@gmail.com>
Date: Tue, 3 Jan 2023 11:44:10 -0300
Subject: [PATCH 104/274] Center layout (#6231)

---
 assets/css/style.scss | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/assets/css/style.scss b/assets/css/style.scss
index 717e3cd4b983ac..125b56640af918 100644
--- a/assets/css/style.scss
+++ b/assets/css/style.scss
@@ -25,6 +25,10 @@
 }
 
 main.page-content {
+  max-width: 960px;
+  display: flex;
+  align-self: center;
+
   div.wrapper {
     max-width: unset;
   }

From 043ba73ee6c4a1175e68c3d77357bbaa5d9a0251 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <chfast@gmail.com>
Date: Tue, 3 Jan 2023 16:35:04 +0100
Subject: [PATCH 105/274] EIP-5450: Revision 2 (#5993)

* EIP-5450: Revision 2

* Change steps structure

* EIP-5450: Add definition of terminating instruction

* EIP-5450: Avoid vague "required stack height" term

* Fix typos

Co-authored-by: Jochem Brouwer <jochembrouwer96@gmail.com>

Co-authored-by: Jochem Brouwer <jochembrouwer96@gmail.com>
---
 EIPS/eip-5450.md | 93 ++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 75 insertions(+), 18 deletions(-)

diff --git a/EIPS/eip-5450.md b/EIPS/eip-5450.md
index 5a6c369b575a4f..9e47d3617231e3 100644
--- a/EIPS/eip-5450.md
+++ b/EIPS/eip-5450.md
@@ -13,41 +13,87 @@ requires: 3540, 3670, 4200, 4750
 
 ## Abstract
 
-Introduce extended validation of code sections to guarantee that neither stack underflow nor overflow can happen during execution of validated contracts.
+Introduce extended validation of EOF code sections to guarantee that neither stack underflow nor overflow can happen during execution of validated contracts.
 
 ## Motivation
 
-Currently existing EVM implementations perform a number of validity checks for each executed instruction, such as check for stack overflow/underflow, sufficient gas, etc. This change aims to minimize the number of such checks required at run-time, by verifying at deploy-time that no exceptional conditions can happen, and preventing to deploy the code where it could happen.
+The current EVM performs a number of validity checks for each executed instruction, such as checking
+for instruction being defined, stack overflow and underflow, and enough amount of gas remaining.
 
-In particular, this extended code validation eliminates the need for EVM stack underflow checks done for every executed instruction. It also prevents deploying code that can be statically proven to require more than 1024 stack items and limits stack overflow checks to the `CALLF` instruction only.
+This EIP minimizes the number of such checks required at run-time
+by verifying that no exceptional conditions can happen
+and preventing the execution and deployment of any invalid code.
+
+The operand stack validation provides several benefits:
+
+- removes run-time stack underflow check for all instructions,
+- removes run-time stack overflow check for all instruction except `CALLF`,
+- ensures that an execution terminates with one of the terminating instructions,
+- prevents the deployment of code with unreachable instructions, which discourages the use of code sections for data storage.
+
+It also has some disadvantages:
+
+- adds constraints to the code structure (similar to JVM, CPython bytecode, WebAssembly and others); however, these constraints can be lifted in a backward-compatible manner if they are shown to be user-unfriendly,
+- adds second validation pass; however, validation's computational and space complexity remains linear.
 
 ## Specification
 
 ### Code validation
 
-*Remark:* We rely on the notions of *data stack* and *type section* as defined by [EIP-4750](./eip-4750.md).
+*Remark:* We rely on the notions of *operand stack* (FIXME) and *type section* as defined by [EIP-4750](./eip-4750.md).
+
+Each code section is validated independently.
+
+#### Instructions validation
+
+In the first validation phase defined in [EIP-3670](./eip-3670.md) (and extended by [EIP-4200](./eip-4200.md) and [EIP-4750](./eip-4750.md)) instructions are inspected independently to check if their opcodes and immediate values are valid.
+
+#### Operand stack validation
+
+In the second validation phase control-flow analysis is performed on the code.
 
-Code section validation rules as defined by [EIP-3670](./eip-3670.md) (which has been extended by [EIP-4200](./eip-4200.md) and [EIP-4750](./eip-4750.md)) are extended again to include the instruction flow traversal procedure, where every possible code path is examined, and data stack height at each instruction is recorded. 
+*Operand stack height* here refers to the number of stack values accessible by this function, i.e. it does not take into account values of caller functions' frames (but does include this function's inputs). Note that validation procedure does not require actual data stack implementation, but only to keep track of its height.
 
-*Data stack height* here refers to the number of stack values accessible by this function, i.e. it does not take into account values of caller functions' frames (but does include this function's inputs). Note that validation procedure does not require actual data stack implementation, but only to keep track of its height. Current height value starts at `type[code_section_index].inputs` (number of inputs of this function) at function entry and is updated at each instruction.
+*Terminating instructions* refers to the instructions either:
 
-At the same time the following properties are being verified:
+- ending function execution: `RETF`, or
+- ending whole EVM execution: `STOP`, `RETURN`, `REVERT`, `INVALID`.
 
-1. For each reachable instruction in the section, data stack height is the same for all possible code paths going through this instruction.
-2. For each instruction, data stack always has enough items, i.e. stack underflow is invalid.
-3. For `CALLF` instruction, data stack has enough items to use as input arguments to a called function according to its type defined in the type section.
-4. For `RETF` instruction, data stack before executing it has exactly `n` items to use as output values returned from a function, where `n` is function's number of outputs according to its type defined in the type section.
-5. `max_stack_height` does not exceed 1023.
-6. The maximum data stack height matches the corresponding code section's `max_stack_height` within the type section body.
-7. No unreachable instructions exist in the code section.
+For each reachable instruction in the code the operand stack height is recorded.
+The first instruction has the recorded stack height equal to the number of inputs to the function type matching the code (`type[code_section_index].inputs`).
 
-To examine every reachable code path, validation needs to traverse every instruction in order, while also following each non-conditional jump, and following both possible branches for each conditional jump. After completing this, verify each instruction was visited at least once. Fail if any instructions were not visited as this invalidates 7).
+The FIFO queue *worklist* is used for tracking "to be inspected" instructions. Initially, it contains the first instruction.
 
-The complexity of this traversal is linear in the number of instructions, because each code path is examined only once, and property 1 guarantees no loops in the validation.
+While *worklist* is not empty, dequeue an instruction and:
+
+1. Determine the effect the instruction has on the operand stack:
+   1. **Check** if the recorded stack height satisfies the instruction requirements. Specifically:
+      - for `CALLF` instruction the recorded stack height must be at least the number of inputs of the called function according to its type defined in the type section.
+      - for `RETF` instruction the recorded stack height must be exactly the number of outputs of the function matching the code.
+   2. Compute new stack height after the instruction execution.
+2. Determine the list of successor instructions that can follow the current instructions:
+   1. The next instruction for all instructions other than terminating instructions and unconditional jump.
+   2. All targets of a conditional or unconditional jump.
+3. For each successor instruction:
+   1. **Check** if the instruction is present in the code (i.e. execution must not "fall off" the code).
+   2. If the instruction does not have stack height recorded (visited for the first time):
+      1. Record the instruction stack height as the value computed in 1.2.
+      2. Add the instruction to the *worklist*.
+   3. Otherwise, **check** if the recorded stack height equals the value computed in 1.2.
+
+When *worklist* is empty:
+
+1. **Check** if all instruction were reached by the analysis.
+2. Determine the function maximum operand stack height:
+   1. Compute the maximum stack height as the maximum of all recorded stack heights.
+   2. **Check** if the maximum stack height does not exceed the limit of 1023 (`0x3FF`).
+   3. **Check** if the maximum stack height matches the corresponding code section's `max_stack_height` within the type section.
+
+The computational and space complexity of this pass is *O(len(code))*. Each instruction is visited at most once.
 
 ### Execution
 
-Given new deploy-time guarantees, EVM implementation is not required anymore to have run-time stack underflow nor overflow checks for each executed instruction. The exception is the `CALLF` performing data stack overflow check for the entire called function.
+Given the deploy-time validation guarantees, an EVM implementation is not required anymore to have run-time stack underflow nor overflow checks for each executed instruction. The exception is the `CALLF` performing data stack overflow check for the entire called function.
 
 ## Rationale
 
@@ -55,9 +101,20 @@ Given new deploy-time guarantees, EVM implementation is not required anymore to
 
 In this EIP, we provide a more efficient variant of the EVM where stack overflow check is performed only in `CALLF` instruction using the called function's `max_stack_height` information. This decreases flexibility of an EVM program because `max_stack_height` corresponds to the worst-case control-flow path in the function.
 
+### Unreachable code
+
+The operand stack validation algorithm rejects any code having any unreachable instructions. This check can be performed very cheaply. It prevents deploying degenerated code. Moreover, it enables combining instruction validation and operand stack validation into single pass.
+
+### Clean stack upon termination
+
+It is currently required that the operand stack is empty (in the current function context) after the `RETF` instruction.
+Otherwise, the `RETF` semantic would be more complicated. For `n` function outputs and `s` the stack height at `RETF` the EVM must erase `s-n` non-top stack items and move the `n` stack items to the place of erased ones. Cost of such operation may be relatively cheap but is not constant.
+However, lifting the requirement and modifying the `RETF` semantic as described above is backward
+compatible and can be easily introduced in the future.
+
 ## Backwards Compatibility
 
-This change requires a “network upgrade”, since it modifies consensus rules.
+This change requires a "network upgrade", since it modifies consensus rules.
 
 It poses no risk to backwards compatibility, as it is introduced only for EOF1 contracts, for which deploying undefined instructions is not allowed, therefore there are no existing contracts using these instructions. The new instructions are not introduced for legacy bytecode (code which is not EOF formatted).
 

From b81f1f5d18e9a7b695b148b1774ba968b70cf70c Mon Sep 17 00:00:00 2001
From: William Morriss <wjmelements@gmail.com>
Date: Tue, 3 Jan 2023 10:08:38 -0600
Subject: [PATCH 106/274] Revert #6009 and satisfy updated lint (#6226)

* Revert "(bot 1272989785) moving EIPS/eip-3651.md to stagnant (#6009)"

This reverts commit 2d2e28b8bacd2b069897b38183a05a0dc6223441.

* lint

* linkify eip-20

* consistent pronouns
---
 EIPS/eip-3651.md | 13 ++++++++++---
 1 file changed, 10 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-3651.md b/EIPS/eip-3651.md
index 96688016921f23..67666a415871b2 100644
--- a/EIPS/eip-3651.md
+++ b/EIPS/eip-3651.md
@@ -4,7 +4,7 @@ title: Warm COINBASE
 description: Starts the `COINBASE` address warm
 author: William Morriss (@wjmelements)
 discussions-to: https://ethereum-magicians.org/t/eip-3651-warm-coinbase/6640
-status: Stagnant
+status: Review
 type: Standards Track
 category: Core
 created: 2021-07-12
@@ -12,27 +12,34 @@ requires: 2929
 ---
 
 ## Abstract
+
 The `COINBASE` address shall be warm at the start of transaction execution, in accordance with the actual cost of reading that account.
 
 ## Motivation
+
 Direct `COINBASE` payments are becoming increasingly popular because they allow conditional payments, which provide benefits such as implicit cancellation of transactions that would revert.
 But accessing `COINBASE` is overpriced; the address is initially cold under the access list framework introduced in [EIP-2929](./eip-2929.md).
-This gas cost mismatch can incentivize alternative payments besides ETH, such as ERC20, but ETH should be the primary means of paying for transactions on Ethereum.
+This gas cost mismatch can incentivize alternative payments besides ETH, such as [EIP-20](./eip-20.md), but ETH should be the primary means of paying for transactions on Ethereum.
 
 ## Specification
+
 At the start of transaction execution, `accessed_addresses` shall be initialized to also include the address returned by `COINBASE` (`0x41`).
 
 ## Rationale
+
 The addresses currently initialized warm are the addresses that should already be loaded at the start of transaction validation.
 The `ORIGIN` address is always loaded to check its balance against the gas limit and the gas price.
 The `tx.to` address is always loaded to begin execution.
-The `COINBASE` address should also be always be loaded because they receive the block reward as well as the transaction fees.
+The `COINBASE` address should also be always be loaded because it receives the block reward and the transaction fees.
 
 ## Backwards Compatibility
+
 There are no known backward compatibility issues presented by this change.
 
 ## Security Considerations
+
 There are no known security considerations introduced by this change.
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 112571f73ebe6bd4c1e8c6eaeea979d8b92a257f Mon Sep 17 00:00:00 2001
From: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
Date: Tue, 3 Jan 2023 12:02:04 -0500
Subject: [PATCH 107/274] Attempt to fix the page width issue (#6254)

---
 assets/css/style.scss | 12 ++----------
 1 file changed, 2 insertions(+), 10 deletions(-)

diff --git a/assets/css/style.scss b/assets/css/style.scss
index 125b56640af918..2624f9b84cb5d2 100644
--- a/assets/css/style.scss
+++ b/assets/css/style.scss
@@ -2,6 +2,8 @@
 # Only the main Sass file needs front matter (the dashes are enough)
 ---
 
+$content-width: 960px;
+
 @import 'minima';
 
 .site-header {
@@ -24,16 +26,6 @@
   }
 }
 
-main.page-content {
-  max-width: 960px;
-  display: flex;
-  align-self: center;
-
-  div.wrapper {
-    max-width: unset;
-  }
-}
-
 .footer-col-wrapper {
   color: #111;
 }

From 9fd46dd724d9528bb98164625779fdefb607ff23 Mon Sep 17 00:00:00 2001
From: yaruno <jarno.marttila@sujuwa.fi>
Date: Tue, 3 Jan 2023 18:31:41 +0100
Subject: [PATCH 108/274] Update from last call to final (#6244)

---
 EIPS/eip-5023.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/EIPS/eip-5023.md b/EIPS/eip-5023.md
index 50db6e7d30ef89..c3e36b57e2b83c 100644
--- a/EIPS/eip-5023.md
+++ b/EIPS/eip-5023.md
@@ -4,8 +4,7 @@ title: Shareable Non-Fungible Token
 description: An interface for creating value-holding tokens shareable by multiple owners
 author: Jarno Marttila (@yaruno), Martin Moravek (@mmartinmo)
 discussions-to: https://ethereum-magicians.org/t/new-nft-concept-shareable-nfts/8681
-status: Last Call
-last-call-deadline: 2022-12-31
+status: Final
 type: Standards Track
 category: ERC
 created: 2022-01-28

From ce9748cc0881632974943ad55f67518dde8a8de1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <pawel@ethereum.org>
Date: Wed, 4 Jan 2023 13:15:05 +0100
Subject: [PATCH 109/274] 3540,4750,5450: Rename data stack to operand stack
 (#6253)

---
 EIPS/eip-3540.md | 16 ++++++++--------
 EIPS/eip-4750.md | 24 ++++++++++++------------
 EIPS/eip-5450.md |  6 +++---
 3 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/EIPS/eip-3540.md b/EIPS/eip-3540.md
index 89aa8a109cc51c..a9b51afac6c92e 100644
--- a/EIPS/eip-3540.md
+++ b/EIPS/eip-3540.md
@@ -133,14 +133,14 @@ type_section := (inputs, outputs, max_stack_height)+
 
 ##### Body
 
-| name             | length   | value        | description |
-|------------------|----------|--------------|-------------|
-| type_section     | variable | n/a          | stores EIP-4750 and EIP-5450 code section metadata  |
-| inputs           | 1 byte   | 0x00-0x7F    | number of stack elements the code section consumes  |
-| outputs          | 1 byte   | 0x00-0x7F    | number of stack elements the code section returns   |
-| max_stack_height | 2 bytes  | 0x0000-0x3FF | max height of data stack during execution           |
-| code_section     | variable | n/a          | arbitrary bytecode                                  |
-| data_section     | variable | n/a          | arbitrary sequence of bytes                         |
+| name             | length   | value        | description                                        |
+|------------------|----------|--------------|----------------------------------------------------|
+| type_section     | variable | n/a          | stores EIP-4750 and EIP-5450 code section metadata |
+| inputs           | 1 byte   | 0x00-0x7F    | number of stack elements the code section consumes |
+| outputs          | 1 byte   | 0x00-0x7F    | number of stack elements the code section returns  |
+| max_stack_height | 2 bytes  | 0x0000-0x3FF | max height of operand stack during execution       |
+| code_section     | variable | n/a          | arbitrary bytecode                                 |
+| data_section     | variable | n/a          | arbitrary sequence of bytes                        |
 
 See [EIP-4750](./eip-4750.md) for more information on the type section content.
 
diff --git a/EIPS/eip-4750.md b/EIPS/eip-4750.md
index 87746d15aeb59c..8dded5a807b6c1 100644
--- a/EIPS/eip-4750.md
+++ b/EIPS/eip-4750.md
@@ -39,7 +39,7 @@ Refer to [EIP-3540](./eip-3540.md) to see the full structure of a well-formed EO
 
 ### New execution state in EVM
 
-A return stack is introduced, separate from the data stack. It is a stack of items representing execution state to return to after function execution is finished. Each item is comprised of: code section index, offset in the code section (PC value), calling function stack height.
+A return stack is introduced, separate from the operand stack. It is a stack of items representing execution state to return to after function execution is finished. Each item is comprised of: code section index, offset in the code section (PC value), calling function stack height.
 
 Note: Implementations are free to choose particular encoding for a stack item. In the specification below we assume that representation is three unsigned integers: `code_section_index`, `offset`, `stack_height`.
 
@@ -67,11 +67,11 @@ If the code is valid EOF1, the following execution rules apply:
 #### `CALLF`
 
 1. Has one immediate argument,`code_section_index`, encoded as a 16-bit unsigned big-endian value.
-2. If data stack has less than `caller_stack_height + type[code_section_index].inputs` items, execution results in exceptional halt.
-3. If data stack size exceeds `1024 - type[code_section_index].max_stack_height` (i.e. if the called function may exceed the global stack height limit), execution results in exceptional halt. This also guarantees that the stack height after the call is within the limits.
+2. If operand stack has less than `caller_stack_height + type[code_section_index].inputs` items, execution results in exceptional halt.
+3. If operand stack size exceeds `1024 - type[code_section_index].max_stack_height` (i.e. if the called function may exceed the global stack height limit), execution results in exceptional halt. This also guarantees that the stack height after the call is within the limits.
 4. If return stack already has `1024` items, execution results in exceptional halt.
 5. Charges 5 gas.
-6. Pops nothing and pushes nothing to data stack.
+6. Pops nothing and pushes nothing to operand stack.
 7. Pushes to return stack an item:
 
    ```
@@ -80,7 +80,7 @@ If the code is valid EOF1, the following execution rules apply:
    stack_height = data_stack.height - types[code_section_index].inputs)
    ```
    
-   Under `PC_post_instruction` we mean the PC position after the entire immediate argument of `CALLF`. Data stack height is saved as it was before function inputs were pushed.
+   Under `PC_post_instruction` we mean the PC position after the entire immediate argument of `CALLF`. Operand stack height is saved as it was before function inputs were pushed.
    
    *Note:* Code validation rules of [EIP-5450](./eip-5450.md) guarantee there is always an instruction following `CALLF` (since terminating instruction or unconditional jump is required to be final one in the section), therefore `PC_post_instruction` always points to an instruction inside section bounds.
 8. Sets `current_section_index` to `code_section_index` and `PC` to `0`, and execution continues in the called section.
@@ -88,10 +88,10 @@ If the code is valid EOF1, the following execution rules apply:
 #### `RETF`
 
 1. Does not have immediate arguments.
-2. If data stack does not equal `caller_stack_height + type[current_section_index].outputs` items, execution results in exceptional halt.
-4. Charges 3 gas.
-5. Pops nothing and pushes nothing to data stack.
-6. Pops an item from return stack and sets `current_section_index` and `PC` to values from this item.
+2. If operand stack does not equal `caller_stack_height + type[current_section_index].outputs` items, execution results in exceptional halt.
+3. Charges 3 gas.
+4. Pops nothing and pushes nothing to operand stack.
+5. Pops an item from return stack and sets `current_section_index` and `PC` to values from this item.
    1. If return stack is empty after this, execution halts with success.
 
 ### Code Validation
@@ -108,7 +108,7 @@ In addition to container format validation rules above, we extend code section v
 
 Dynamic jump instructions `JUMP` (`0x56`) and `JUMPI` (`0x57`) are invalid and their opcodes are undefined.
 
-`JUMPDEST` (`0x5b`) instruction is renamed to `NOP` ("no operation") without the change in behaviour: it pops nothing and pushes nothing to data stack and has no other effects except for `PC` increment and charging 1 gas.
+`JUMPDEST` (`0x5b`) instruction is renamed to `NOP` ("no operation") without the change in behaviour: it pops nothing and pushes nothing to operand stack and has no other effects except for `PC` increment and charging 1 gas.
 
 `PC` (0x58) instruction becomes invalid and its opcode is undefined.
 
@@ -118,8 +118,8 @@ Dynamic jump instructions `JUMP` (`0x56`) and `JUMPI` (`0x57`) are invalid and t
 
 1. Execution starts at the first byte of the first code section, and PC is set to 0.
 2. Return stack is initialized to contain one item: `(code_section_index = 0, offset = 0, stack_height = 0)`
-3. If any instruction would access a data stack item below `caller_stack_height`, execution results in exceptional halt. This rule replaces the old stack underflow check.
-4. No change in stack overflow check: if any instruction would result in data stack size exceeding `1024` items, execution results in exceptional halt.
+3. If any instruction access the operand stack item below `caller_stack_height`, execution results in exceptional halt. This rule replaces the old stack underflow check.
+4. No change in stack overflow check: if any instruction causes the operand stack height to exceed `1024`, execution results in exceptional halt.
 
 ## Rationale
 
diff --git a/EIPS/eip-5450.md b/EIPS/eip-5450.md
index 9e47d3617231e3..1a7fb49a9448f6 100644
--- a/EIPS/eip-5450.md
+++ b/EIPS/eip-5450.md
@@ -40,7 +40,7 @@ It also has some disadvantages:
 
 ### Code validation
 
-*Remark:* We rely on the notions of *operand stack* (FIXME) and *type section* as defined by [EIP-4750](./eip-4750.md).
+*Remark:* We rely on the notions of *operand stack* and *type section* as defined by [EIP-4750](./eip-4750.md).
 
 Each code section is validated independently.
 
@@ -52,7 +52,7 @@ In the first validation phase defined in [EIP-3670](./eip-3670.md) (and extended
 
 In the second validation phase control-flow analysis is performed on the code.
 
-*Operand stack height* here refers to the number of stack values accessible by this function, i.e. it does not take into account values of caller functions' frames (but does include this function's inputs). Note that validation procedure does not require actual data stack implementation, but only to keep track of its height.
+*Operand stack height* here refers to the number of stack values accessible by this function, i.e. it does not take into account values of caller functions' frames (but does include this function's inputs). Note that validation procedure does not require actual operand stack implementation, but only to keep track of its height.
 
 *Terminating instructions* refers to the instructions either:
 
@@ -93,7 +93,7 @@ The computational and space complexity of this pass is *O(len(code))*. Each inst
 
 ### Execution
 
-Given the deploy-time validation guarantees, an EVM implementation is not required anymore to have run-time stack underflow nor overflow checks for each executed instruction. The exception is the `CALLF` performing data stack overflow check for the entire called function.
+Given the deploy-time validation guarantees, an EVM implementation is not required anymore to have run-time stack underflow nor overflow checks for each executed instruction. The exception is the `CALLF` performing operand stack overflow check for the entire called function.
 
 ## Rationale
 

From e049d8020e2c36629dc57a5f02554176dc30d7d1 Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Wed, 4 Jan 2023 23:18:32 +0100
Subject: [PATCH 110/274] Upgrade EIP-6059 to Review status (#6221)

As the EIP-6059 is ready for peer review, we are upgrading it to
`Review` status to request it.
---
 EIPS/eip-6059.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6059.md b/EIPS/eip-6059.md
index ebafebe5ef4fd2..216cea55f0f2d9 100644
--- a/EIPS/eip-6059.md
+++ b/EIPS/eip-6059.md
@@ -4,7 +4,7 @@ title: Parent-Governed Nestable Non-Fungible Tokens
 description: An interface for Nestable Non-Fungible Tokens with emphasis on parent token's control over the relationship.
 author: Bruno Škvorc (@Swader), Cicada (@CicadaNCR), Steven Pineda (@steven2308), Stevan Bogosavljevic (@stevyhacker), Jan Turk (@ThunderDeliverer)
 discussions-to: https://ethereum-magicians.org/t/eip-6059-parent-governed-nestable-non-fungible-tokens/11914
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-11-15

From ff0c652dc6c5b28951ceba405856dfe5b263e31e Mon Sep 17 00:00:00 2001
From: Suning Yao <sy2940@nyu.edu>
Date: Wed, 4 Jan 2023 17:23:11 -0500
Subject: [PATCH 111/274] Update EIP-6150: Move to Review (#6219)

* Update EIP-6150: Move to Review

* Update EIP-6150: Fix wording

* Update EIP-6150: Fix typo

* Update EIP-6150: Add ERC-165 identifiers
---
 EIPS/eip-6150.md | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/EIPS/eip-6150.md b/EIPS/eip-6150.md
index 3c065319ed5bcf..279ea7ba531057 100644
--- a/EIPS/eip-6150.md
+++ b/EIPS/eip-6150.md
@@ -4,7 +4,7 @@ title: Hierarchical NFTs
 description: Hierarchical NFTs, an extension to EIP-721.
 author: Keegan Lee (@keeganlee), msfew <msfew@hyperoracle.io>, Kartin <kartin@hyperoracle.io>, qizhou (@qizhou)
 discussions-to: https://ethereum-magicians.org/t/eip-6150-hierarchical-nfts-an-extension-to-erc-721/12173
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-12-15
@@ -23,7 +23,7 @@ Hierarchy structure is commonly implemented for file systems by operating system
 
 ![Linux Hierarchical File Structure](../assets/eip-6150/linux-hierarchy.png)
 
-Websites often use a directory and category hierarchy structure, such as eBay (Home -> Electronics -> Video Games -> Xbox -> Products), and Twitter (Home -> Lists -> List -> Tweets), and Reddit (Home -> r/ ethereum -> Posts -> Hot).
+Websites often use a directory and category hierarchy structure, such as eBay (Home -> Electronics -> Video Games -> Xbox -> Products), and Twitter (Home -> Lists -> List -> Tweets), and Reddit (Home -> r/ethereum -> Posts -> Hot).
 
 ![Website Hierarchical Structure](../assets/eip-6150/website-hierarchy.png)
 
@@ -52,11 +52,12 @@ In the future, with the development of the data availability solutions of Ethere
 
 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174.
 
-Every [EIP-6150](./eip-6150.md) compliant contract must implement the [EIP-6150](./eip-6150.md), [EIP-721](./eip-721.md) and [EIP-165](./eip-165.md) interfaces.
+Every compliant contract must implement this proposal, [EIP-721](./eip-721.md) and [EIP-165](./eip-165.md) interfaces.
 
 ```solidity
 pragma solidity ^0.8.0;
 
+// Note: the ERC-165 identifier for this interface is 0x897e2c73.
 interface IERC6150 /* is IERC721, IERC165 */ {
     /**
      * @notice Emitted when `tokenId` token under `parentId` is minted.
@@ -107,6 +108,7 @@ interface IERC6150 /* is IERC721, IERC165 */ {
 Optional Extension: Enumerable
 
 ```solidity
+// Note: the ERC-165 identifier for this interface is 0xba541a2e.
 interface IERC6150Enumerable is IERC6150 /* IERC721Enumerable */ {
     /**
      * @notice Get total amount of children tokens under `parentId` token.
@@ -143,6 +145,7 @@ interface IERC6150Enumerable is IERC6150 /* IERC721Enumerable */ {
 Optional Extension: Burnable
 
 ```solidity
+// Note: the ERC-165 identifier for this interface is 0x4ac0aa46.
 interface IERC6150Burnable is IERC6150 {
     /**
      * @notice Burn the `tokenId` token.
@@ -169,6 +172,7 @@ interface IERC6150Burnable is IERC6150 {
 Optional Extension: ParentTransferable
 
 ```solidity
+// Note: the ERC-165 identifier for this interface is 0xfa574808.
 interface IERC6150ParentTransferable is IERC6150 {
     /**
      * @notice Emitted when the parent of `tokenId` token changed.
@@ -204,6 +208,7 @@ interface IERC6150ParentTransferable is IERC6150 {
 Optional Extension: Access Control
 
 ```solidity
+// Note: the ERC-165 identifier for this interface is 0x1d04f0b3.
 interface IERC6150AccessControl is IERC6150 {
     /**
      * @notice Check the account whether a admin of `tokenId` token.
@@ -251,23 +256,23 @@ As mentioned in the abstract, this EIP's goal is to have a simple interface for
 
 All NFTs will make up a hierarchical relationship tree. Each NFT is a node of the tree, maybe as a root node or a leaf node, as a parent node or a child node.
 
-[EIP-6150](./eip-6150.md) standardizes the event `Minted` to indicate the parent and child relationship when minting a new node. When a root node is minted, parentId should be zero. That means a token id of zero could not be a real node. So a real node token id must be greater than zero.
+This proposal standardizes the event `Minted` to indicate the parent and child relationship when minting a new node. When a root node is minted, parentId should be zero. That means a token id of zero could not be a real node. So a real node token id must be greater than zero.
 
-In a hierarchical tree, it's common to query upper and lower nodes. So [EIP-6150](./eip-6150.md) standardizes function `parentOf` to get the parent node of the specified node and standardizes function `childrenOf` to get all children nodes.
+In a hierarchical tree, it's common to query upper and lower nodes. So this proposal standardizes function `parentOf` to get the parent node of the specified node and standardizes function `childrenOf` to get all children nodes.
 
 Functions `isRoot` and `isLeaf` can check if one node is a root node or a leaf node, which would be very useful for many cases.
 
 ### Enumerable Extension
 
-[EIP-6150](./eip-6150.md) standardizes three functions as an extension to support enumerable queries involving children nodes. Each function all have param `parentId`, for compatibility, when the `parentId` specified zero means query root nodes.
+This proposal standardizes three functions as an extension to support enumerable queries involving children nodes. Each function all have param `parentId`, for compatibility, when the `parentId` specified zero means query root nodes.
 
 ### ParentTransferable Extension
 
-In some cases, such as filesystem, a directory or a file could be moved from one directory to another. So [EIP-6150](./eip-6150.md) adds ParentTransferable Extension to support this situation.
+In some cases, such as filesystem, a directory or a file could be moved from one directory to another. So this proposal adds ParentTransferable Extension to support this situation.
 
 ### Access Control
 
-In a hierarchical structure, usually, there is more than one account has permission to operate a node, like mint children nodes, transfer node, burn node. [EIP-6150](./eip-6150.md) adds a few functions as standard to check access control permissions.
+In a hierarchical structure, usually, there is more than one account has permission to operate a node, like mint children nodes, transfer node, burn node. This proposal adds a few functions as standard to check access control permissions.
 
 ## Backwards Compatibility
 

From 4c156ea983c18c0add9e93a63cf0be5891943707 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Wed, 4 Jan 2023 14:45:12 -0800
Subject: [PATCH 112/274] Add EIP-5982: Role-based Access Control (#5982)

* Add ACL

* Add ACL

* Draft

* Draft

* Add events

* Update EIPS/eip-5982.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5982.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5982.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update

* Add role bytes32 def

* Define role

* Define role

* Update eip-5982.md

* Update eip-5982.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-5982.md | 92 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 EIPS/eip-5982.md

diff --git a/EIPS/eip-5982.md b/EIPS/eip-5982.md
new file mode 100644
index 00000000000000..ec9a80335aff52
--- /dev/null
+++ b/EIPS/eip-5982.md
@@ -0,0 +1,92 @@
+---
+eip: 5982
+title: Role-based Access Control
+description: An interface for role-based access control for smart contracts.
+author: Zainan Victor Zhou (@xinbenlv)
+discussions-to: https://ethereum-magicians.org/t/eip-5982-role-based-access-control/11759
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-11-15
+requires: 165, 5750
+---
+
+## Abstract
+
+This EIP defines an interface for role-based access control for smart contracts. Roles are defined as `byte32`. The interface specifies how to read, grant, create and destroy roles. It specifies the sense of role power in the format of its ability to call a given method
+identified by `bytes4` method selector. It also specifies how metadata of roles are represented.
+
+## Motivation
+
+There are many ways to establish access control for privileged actions. One common pattern is "role-based" access control, where one or more users are assigned to one or more "roles," which grant access to privileged actions. This pattern is more secure and flexible than ownership-based access control since it allows for many people to be granted permissions according to the principle of least privilege.
+
+## Specification
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+Interfaces of reference is described as followed:
+
+```solidity
+interface IERC_ACL_CORE {
+    function hasRole(bytes32 role, address account) external view returns (bool);
+    function grantRole(bytes32 role, address account) external;
+    function revokeRole(bytes32 role, address account) external;
+}
+```
+
+```solidity
+interface IERC_ACL_GENERAL {
+    event RoleGranted(address indexed grantor, bytes32 indexed role, address indexed grantee, bytes _data);
+    event RoleRevoked(address indexed revoker, bytes32 indexed role, address indexed revokee, bytes _data);
+
+    event RoleCreated(address indexed roleGrantor, bytes32 role, bytes32 adminOfRole, string name, string desc, string uri, bytes32 calldata _data);
+    event RoleDestroyed(address indexed roleDestroyer, bytes32 role, bytes32 calldata _data);
+    event RolePowerSet(address indexed rolePowerSetter, bytes32 role, bytes4 methods, bytes calldata _data);
+
+    function grantRole(bytes32 role, address account, bytes calldata _data) external;
+    function revokeRole(bytes32 role, address account, bytes calldata _data) external;
+
+    function createRole(bytes32 role, bytes32 adminOfRole, string name, string desc, string uri, bytes32 calldata _data) external;
+    function destroyRole(bytes32 role, bytes32 calldata _data) external;
+    function setRolePower(bytes32 role, bytes4 methods, bytes calldata _data) view external returns(bool);
+
+    function hasRole(bytes32 role, address account, bytes calldata _data) external view returns (bool);
+    function canGrantRole(bytes32 grantor, bytes32 grantee, bytes calldata _data) view external returns(bool);
+    function canRevokeRole(bytes32 revoker, bytes32 revokee, address account, bytes calldata _data) view external returns(bool);
+    function canExecute(bytes32 executor, bytes4 methods, bytes32 calldata payload, bytes calldata _data) view external returns(bool);
+}
+```
+
+```solidity
+interface IERC_ACL_METADATA {
+    function roleName(bytes32) external view returns(string);
+    function roleDescription(bytes32) external view returns(string);
+    function roleURI(bytes32) external view returns(string);
+}
+```
+
+1. Compliant contracts MUST implement `IERC_ACL_CORE`
+2. It is RECOMMENDED for compliant contracts to implement the optional extension `IERC_ACL_GENERAL`.
+3. Compliant contracts MAY implement the optional extension `IERC_ACL_METADATA`.
+4. A role in a compliant smart contract is represented in the format of `bytes32`. It's RECOMMENDED the value of such role is computed as a
+`keccak256` hash of a string of the role name, in this format: `bytes32 role = keccak256("<role_name>")`. such as `bytes32 role = keccak256("MINTER")`.
+5. Compliant contracts SHOULD implement [EIP-165](./eip-165.md) identifier.
+
+## Rationale
+
+1. The names and parameters of methods in `IERC_ACL_CORE` are chosen to allow backward compatibility with OpenZeppelin's implementation.
+2. The methods in `IERC_ACL_GENERAL` conform to [EIP-5750](./eip-5750.md) to allow extension.
+3. The method of `renounceRole` was not adopted, consolidating with `revokeRole` to simplify interface.
+
+
+## Backwards Compatibility
+
+Needs discussion.
+
+## Security Considerations
+
+Needs discussion.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 84b493573c37233f105ec39a723960631cd36e13 Mon Sep 17 00:00:00 2001
From: Bumblefudge <jcaballero@centre.io>
Date: Thu, 5 Jan 2023 01:28:37 -0800
Subject: [PATCH 113/274] minor typos on EIP 5573 (#6257)

---
 EIPS/eip-5573.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-5573.md b/EIPS/eip-5573.md
index cfbe42628a3783..781478bf6c3f49 100644
--- a/EIPS/eip-5573.md
+++ b/EIPS/eip-5573.md
@@ -165,9 +165,9 @@ The following is a non-normative example of a ReCap Capability Object with `def`
 }
 ```
 
-In the example above, the delegee is authorized to perform the action `read` independent of any resource, `append`, `delete` on resource `my.resource.1`, `append` on resource `my.resource.2` and `append` on `my.resource.3`. Note, the delegee can invoke each action invididually and independent from each other in the RS. Additionally the ReCap Capability Object contains some additional information that the RS will need during verification. The responsibility for defining the structure and semantics of this data lies with the RS.
+In the example above, the delegee is authorized to perform the action `read` independent of any resource, `append`, `delete` on resource `my.resource.1`, `append` on resource `my.resource.2` and `append` on `my.resource.3`. Note, the delegee can invoke each action individually and independently from each other in the RS. Additionally the ReCap Capability Object contains some additional information that the RS will need during verification. The responsibility for defining the structure and semantics of this data lies with the RS.
 
-It is expected that RS implementers define which resources they want to expose through ReCap Details Objects and which actions they want to allow to invoke on them.
+It is expected that RS implementers define which resources they want to expose through ReCap Details Objects and which actions they want to allow users to invoke on them.
 
 #### ReCap Translation Algorithm
 
@@ -270,4 +270,4 @@ TBD
 Resource service implementer's should not consider ReCaps as bearer tokens but instead require to authenticate the delegee in addition. The process of authenticating the delegee against the resource service is out of scope of this specification and can be done in various different ways.
 
 ## Copyright
-Copyright and related rights waived via [CC0](../LICENSE.md).
\ No newline at end of file
+Copyright and related rights waived via [CC0](../LICENSE.md).

From b2be680d5fb6a7515afc5d228e1eb858ce0d12cc Mon Sep 17 00:00:00 2001
From: Matt Stam <mattstam@live.com>
Date: Thu, 5 Jan 2023 06:46:10 -0800
Subject: [PATCH 114/274] Update EIP-4337: fix miscellaneous typos (#6234)

---
 EIPS/eip-4337.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-4337.md b/EIPS/eip-4337.md
index 5ca80ed964d3d7..0d669ab8e78ede 100644
--- a/EIPS/eip-4337.md
+++ b/EIPS/eip-4337.md
@@ -36,9 +36,9 @@ This proposal takes a different approach, avoiding any adjustments to the consen
 
 ### Definitions
 
-* **UserOperation** - a structure that describes a transaction to be sent on behalf of a user. To avoid confusion, it is named "transaction".
+* **UserOperation** - a structure that describes a transaction to be sent on behalf of a user. To avoid confusion, it is not named "transaction".
   * Like a transaction, it contains "sender", "to", "calldata", "maxFeePerGas", "maxPriorityFee", "signature", "nonce"
-  * unlike transaction, it contains several other fields, described below
+  * unlike a transaction, it contains several other fields, described below
   * also, the "nonce" and "signature" fields usage is not defined by the protocol, but by each account implementation
 * **Sender** - the account contract sending a user operation.
 * **EntryPoint** - a singleton contract to execute bundles of UserOperations. Bundlers/Clients whitelist the supported entrypoint.
@@ -203,7 +203,7 @@ In the execution loop, the `handleOps` call must perform the following steps for
 ![](../assets/eip-4337/image1.png)
 
 Before accepting a `UserOperation`, bundlers should use an RPC method to locally call the `simulateValidation` function of the entry point, to verify that the signature is correct and the operation actually pays fees; see the [Simulation section below](#simulation) for details.
-A node/bundler SHOULD drop (and not add to the mempool) `UserOperation` that fails the validation
+A node/bundler SHOULD drop (not add to the mempool) a `UserOperation` that fails the validation
 
 ### Extension: paymasters
 

From c9d646c9dd0208372baf23c0958134c56f047330 Mon Sep 17 00:00:00 2001
From: lightclient <14004106+lightclient@users.noreply.github.com>
Date: Thu, 5 Jan 2023 08:56:11 -0700
Subject: [PATCH 115/274] 3540: restrict number of code sections to 1024
 (#6251)

---
 EIPS/eip-3540.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-3540.md b/EIPS/eip-3540.md
index a9b51afac6c92e..b9a3fcfc31f490 100644
--- a/EIPS/eip-3540.md
+++ b/EIPS/eip-3540.md
@@ -125,7 +125,7 @@ type_section := (inputs, outputs, max_stack_height)+
 | kind_type         | 1 byte   | 0x01          | kind marker for EIP-4750 type section header                                       |
 | type_size         | 2 bytes  | 0x0004-0xFFFC | uint16 denoting the length of the type section content, 4 bytes per code segment   |
 | kind_code         | 1 byte   | 0x02          | kind marker for code size section                                                  |
-| num_code_sections | 2 bytes  | 0x0001-0xFFFF | uint16 denoting the number of the code sections                                    |
+| num_code_sections | 2 bytes  | 0x0001-0x0400 | uint16 denoting the number of the code sections                                    |
 | code_size         | 2 bytes  | 0x0001-0xFFFF | uint16 denoting the length of the code section content                             |
 | kind_data         | 1 byte   | 0x03          | kind marker for data size section                                                  |
 | data_size         | 2 bytes  | 0x0000-0xFFFF | uint16 integer denoting the length of the data section content                     |

From 2101931bac496e5b25f76262d3bfd210b112294a Mon Sep 17 00:00:00 2001
From: Firn Protocol <93839494+firnprotocol@users.noreply.github.com>
Date: Thu, 5 Jan 2023 13:25:24 -0500
Subject: [PATCH 116/274] another update to EIP-5630: only do ECDH (#6262)

* another update to EIP-5630: only do ECDH

* add missing blank lines

* decrypt --> performECDH
---
 EIPS/eip-5630.md | 95 ++++++++++++++++++++++++++++++------------------
 1 file changed, 59 insertions(+), 36 deletions(-)

diff --git a/EIPS/eip-5630.md b/EIPS/eip-5630.md
index ad56f63de637b6..3015bc13359a46 100644
--- a/EIPS/eip-5630.md
+++ b/EIPS/eip-5630.md
@@ -13,7 +13,7 @@ created: 2022-09-07
 
 ## Abstract
 
-This EIP proposes a new way to encrypt and decrypt using Ethereum keys. This EIP uses _only_ the `secp256k1` curve, and it uses a standardized version of ECIES. In contrast, a previous EIPs used the same secret key, in both signing and encryption, on two _different_ curves (namely, `secp256k1` and `ec25519`).
+This EIP proposes a new way to encrypt and decrypt using Ethereum keys. This EIP uses _only_ the `secp256k1` curve, and proposes two new RPC methods: `eth_getEncryptionPublicKey` and `eth_performECDH`. These two methods, in conjunction, allow users to receive encryptions and perform decryptions (respectively). We require that the wallet _only_ perform the core ECDH operation, leaving the ECIES operations up to implementers (we do suggest a standardized version of ECIES, however). In contrast, a previous EIPs used the same secret key, in both signing and encryption, on two _different_ curves (namely, `secp256k1` and `ec25519`), and hardcoded a particular version of ECIES.
 
 ## Motivation
 
@@ -23,24 +23,34 @@ We discuss a second sort of example. In a certain common design pattern, a dApp
 
 ## Specification
 
-We describe our approach here; we compare our approach to prior EIPs in the **Rationale** section below.
+We describe our approach here; we compare our approach to prior EIPs in the **Rationale** section below. Throughout, we make reference to SEC 1: Elliptic Curve Cryptography, by Daniel R. L. Brown.
 
 We use the `secp256k1` curve for both signing and encryption.
-For encryption, we use ECIES. Specifically, we propose the standardized choices:
+For encryption, we use ECIES. We specify that the wallet _only_ perform the sensitive ECDH operation. This lets implementers select their own ECIES variants at will.
+
+We propose that all binary data be serialized to and from `0x`-prefixed hex strings. We moreover use `0x`-prefixed hex strings to specify private keys and public keys, and represent public keys in compressed form. We represent Ethereum accounts in the usual way (`0x`-prefixed, 20-byte hex strings). Specifically, to serialize and deserialize elliptic curve points, implementers MUST use the following standard:
+
+- to serialize a point: use [SEC 1, §2.3.3], with point compression.
+- to deserialize a point: use [SEC 1, §2.3.3], while _requiring_ point compression; that is:
+
+  - the input byte string MUST have length ⌈log₂q / 8⌉ + 1 = `33`.
+  - the first byte MUST be `0x02` or `0x03`.
+  - that the integer represented by the remaining 32 bytes (as in [SEC 1, §2.3.8]) MUST reside in {1, ..., _p_ - 1}, and moreover MUST yield a quadratic residue modulo _p_ under the Weierstrass expression X^3 + 7 (modulo _p_).
+
+For application-level implementers actually implementing ECIES, we propose the following variant. Unless they have a reason to do otherwise, implementers SHOULD use the following standardized choices:
 
 - the KDF `ANSI-X9.63-KDF`, where the hash function `SHA-512` is used,
 - the HMAC `HMAC–SHA-256–256 with 32 octet or 256 bit keys`,
 - the symmetric encryption scheme `AES–256 in CBC mode`.
 
-We propose that the binary, _concatenated_ serialization mode for ECIES ciphertexts be used, both for encryption and decryption, where moreover elliptic curve points are _compressed_. This approach is considerably more space-efficient than the prior approach, which outputted a stringified JSON object (itself containing base64-encoded fields).
-We moreover propose that binary data be serialized to and from `0x`-prefixed hex strings. We moreover use `0x`-prefixed hex strings to specify private keys and public keys, and represent public keys in compressed form. We represent Ethereum accounts in the usual way (`0x`-prefixed, 20-byte hex strings).
+We propose that the binary, _concatenated_ serialization mode for ECIES ciphertexts be used, both for encryption and decryption, where moreover elliptic curve points are _compressed_.
 
 Thus, on the request:
 
 ```javascript
 request({
   method: 'eth_getEncryptionPublicKey',
-  params: [account],
+  params: [account]
 })
 ```
 
@@ -48,26 +58,23 @@ where `account` is a standard 20-byte, `0x`-prefixed, hex-encoded Ethereum accou
 
 - find the secret signing key `sk` corresponding to the Ethereum account `account`, or else return an error if none exists.
 - compute the `secp256k1` public key corresponding to `sk`.
-- return this public key in compressed, `0x`-prefixed, hex-encoded form.
+- return this public key in compressed, `0x`-prefixed, hex-encoded form, following [SEC 1, §2.3.3].
 
 On the request
 
 ```javascript
 request({
-  method: 'eth_decrypt',
-  params: [encryptedMessage, account],
+  method: 'eth_performECDH',
+  params: [account, ephemeralKey]
 })
 ```
 
-where `account` is as above, and `encryptedMessage` is a JSON object with the properties `version` (an arbitrary string) and `ciphertext` (a `0x`-prefixed, hex-encoded, bytes-like string), the client should operate as follows:
+where `account` is as above, and `ephemeralKey` is an elliptic curve point encoded as above:
 
-- perform a `switch` on the value `encryptedMessage.version`. if it equals:
-   - `secp256k1-sha512kdf-aes256cbc-hmacsha256`, then break from the switch and proceed as in the bullets below;
-   - `x25519-xsalsa20-poly1305`, then, optionally, use #1098's specification _if_ backwards compatibility is desired, and otherwise fallthrough;
-   - `default`, throw an error.
 - find the secret key `sk` corresponding to the Ethereum account `account`, or else return an error if none exists.
-- using `sk`, perform an ECIES decryption of `encryptedMessage.ciphertext`, where the above choices of parameters are used.
-- decode the resulting binary plaintext as a `utf-8` string, and return it.
+- deserialize `ephemeralKey` to an elliptic curve point using [SEC 1, §2.3.3] (where compression is required), throwing an error if deserialization fails.
+- compute the elliptic curve Diffie–Hellman secret, following [SEC 1, §3.3.1].
+- return the resulting field element as an 0x-prefixed, hex-encoded, 32-byte string, using [SEC 1, §2.3.5].
 
 Test vectors are given below.
 
@@ -94,7 +101,7 @@ contract ERC5630 {
 }
 ```
 
-Each contract should implement `encryptToAccount` as it desires; for example, it could use our specification above (i.e., for some fixed public key depending on the contract), or something arbitrary.
+Each contract MAY implement `encryptTo` as it desires. Unless it has a good reason to do otherwise, it SHOULD use the ECIES variant we propose above.
 
 ## Rationale
 
@@ -107,19 +114,26 @@ We now discuss a few further aspects of our approach.
 **On-chain public key discovery.** Our proposal has an important feature whereby an encryption _to_ some account can be constructed whenever that account has signed at least one transaction.
 Indeed, it is possible to recover an account's `secp256k1` public key directly from any signature on behalf of that account.
 
+**ECDH vs. ECIES.** We specify that the wallet _only_ perform the sensitive ECDH operation, and let application-level implementers perform the remaining steps of ECIES. This has two distinct advantages:
+
+- **Flexibility.** It allows implementers to select arbitrary variants of ECIES, without having to update what the wallet does.
+- **Bandwidth.** Our approach requires that only small messages (on the order of 32 bytes) be exchanged between the client and the wallet. This could be material in settings in which the plaintexts and ciphertexts at play are large, and when the client and the wallet are separated by an internet connection. 
+
 **Twist attacks.** A certain GitHub post by Christian Lundkvist warns against "twist attacks" on the `secp256k1` curve. These attacks are not applicable to this EIP, for multiple _distinct_ reasons, which we itemize:
 
-- **Only applies to ECDH, not ECIES.** This attack only applies to a scenario in which an attacker can induce a victim to exponentiate an attacker-supplied point by a sensitive scalar, and then moreover send the result back to the attacker. But this pattern only happens in ECDH, and never ECIES. Indeed, in ECIES, we recall that the only sensitive Diffie–Hellman operation happens during decryption, but in this case, the victim (who would be the decryptor) never sends the resulting DH point back to the attacker (rather, the victim merely uses it locally to attempt an AES decryption). During _encryption_, the exponentiation is done by the encryptor, who has no secret at all (sure enough, the exponentiation is by an ephemeral scalar), so here there would be nothing for the attacker to learn.
-- **Only applies to uncompressed points.** Indeed, we use compressed points in this EIP; when compressed points are used, any 32-byte string supplied by an attacker will resolve canonically to a point on the right curve, or else generate an error; there is no possibility of a "wrong curve" point.
-- **Only applies when you fail to check a point is on the curve.** But this is inapplicable for us anyway, since we use compressed points (see above).
+- **Only applies to classical ECDH, not ECIES.** This attack only applies to classical ECDH (i.e., in which both parties use persistent, authenticated public keys), and not to ECIES (in which one party, the encryptor, uses an ephemeral key). Indeed, it only applies to a scenario in which an attacker can induce a victim to exponentiate an attacker-supplied point by a sensitive scalar, and then moreover send the result back to the attacker. But this pattern only happens in classical Diffie–Hellman, and never in ECIES. Indeed, in ECIES, we recall that the only sensitive Diffie–Hellman operation happens during decryption, but in this case, the victim (who would be the decryptor) never sends the resulting DH point back to the attacker (rather, the victim merely uses it locally to attempt an AES decryption). During _encryption_, the exponentiation is done by the encryptor, who has no secret at all (sure enough, the exponentiation is by an ephemeral scalar), so here there would be nothing for the attacker to learn.
+- **Only applies to uncompressed points.** Indeed, we use compressed points in this EIP. When compressed points are used, each 33-byte string _necessarily_ either resolves to a point on the correct curve, or else has no reasonable interpretation. There is no such thing as "a point not on the curve" (which, in particular, can pass undetectedly as such).
+- **Only applies when you fail to check a point is on the curve.** But this is inapplicable for us anyway, since we use compressed points (see above). We also require that all validations be performed.
 
 ## Backwards Compatibility
 
-The previous EIP stipulated that encryption and decryption requests contain a `version` string. Our proposal merely adds a case for this string; encryption and decryption requests under the existing scheme will be handled identically.
-The previous proposal did _not_ include a version string in `encryptionPublicKey`, and merely returned the `ec25519` public key directly as a string. We thus propose to immediately return the `secp256k1` public key, overwriting the previous behavior.
+Our `eth_performECDH` method is new, and so doesn't raise any backwards compatibility issues.
+
+A previous proposal proposed an `eth_getEncryptionPublicKey` method (together with an `eth_decrypt` method unrelated to this EIP). Our proposal overwrites the previous behavior of `eth_getEncryptionPublicKey`.
 It is unlikely that this will be an issue, since encryption keys need be newly retrieved _only_ upon the time of encryption; on the other hand, _new_ ciphertexts will be generated using our new approach.
+(In particular, our modification will not affect the ability of ciphertexts generated using the old EIP to be `eth_decrypt`ed.)
 
-In any case, the previous EIP was never standardized, and is _not_ (to our knowledge) implemented in a non-deprecated manner in _any_ production code today. We thus have a lot of flexibility here; we only need enough backwards compatibility to allow dApps to migrate.
+In any case, the previous EIP was never standardized, and is _not_ (to our knowledge) implemented in a non-deprecated manner in _any_ production code today.
 
 ### Test Cases
 
@@ -140,7 +154,7 @@ Thus, the request:
 ```javascript
 request({
   method: 'eth_getEncryptionPublicKey',
-  params: ["0x72682F2A3c160947696ac3c9CC48d290aa89549c"],
+  params: ["0x72682F2A3c160947696ac3c9CC48d290aa89549c"]
 })
 ```
 
@@ -150,28 +164,37 @@ should return:
 "0x03ff5763a2d3113229f2eda8305fae5cc1729e89037532a42df357437532770010"
 ```
 
-Encrypting the UTF-8 message `I use Firn Protocol to gain privacy on Ethereum.` under the above public key could yield, for example:
+If an encryptor were to encrypt a message—say, `I use Firn Protocol to gain privacy on Ethereum.`—under the above public key, using the above ECIES variant, he could obtain, for example:
 
 ```javascript
-{
-  version: 'secp256k1-sha512kdf-aes256cbc-hmacsha256',
-  ciphertext: '0x036f06f9355b0e3f7d2971da61834513d5870413d28a16d7d68ce05dc78744daf850e6c2af8fb38e3e31d679deac82bd12148332fa0e34aecb31981bd4fe8f7ac1b74866ce65cbe848ee7a9d39093e0de0bd8523a615af8d6a83bbd8541bf174f47b1ea2bd57396b4a950a0a2eb77af09e36bd5832b8841848a8b302bd816c41ce',
-}
+"0x036f06f9355b0e3f7d2971da61834513d5870413d28a16d7d68ce05dc78744daf850e6c2af8fb38e3e31d679deac82bd12148332fa0e34aecb31981bd4fe8f7ac1b74866ce65cbe848ee7a9d39093e0de0bd8523a615af8d6a83bbd8541bf174f47b1ea2bd57396b4a950a0a2eb77af09e36bd5832b8841848a8b302bd816c41ce"
 ```
 
-Therefore, the request
+Upon obtaining this ciphertext, the decryptor would extract the relevant ephemeral public key, namely:
+
+```javascript
+"0x036f06f9355b0e3f7d2971da61834513d5870413d28a16d7d68ce05dc78744daf8"
+```
+
+And submit the request:
 
 ```javascript
 request({
-  method: 'eth_decrypt',
-  params: [{
-    version: 'secp256k1-sha512kdf-aes256cbc-hmacsha256',
-    ciphertext: '0x036f06f9355b0e3f7d2971da61834513d5870413d28a16d7d68ce05dc78744daf850e6c2af8fb38e3e31d679deac82bd12148332fa0e34aecb31981bd4fe8f7ac1b74866ce65cbe848ee7a9d39093e0de0bd8523a615af8d6a83bbd8541bf174f47b1ea2bd57396b4a950a0a2eb77af09e36bd5832b8841848a8b302bd816c41ce',
-  }, "0x72682F2A3c160947696ac3c9CC48d290aa89549c"],
+  method: 'eth_performECDH',
+  params: [
+    "0x72682F2A3c160947696ac3c9CC48d290aa89549c",
+    "0x036f06f9355b0e3f7d2971da61834513d5870413d28a16d7d68ce05dc78744daf8"
+  ]
 })
 ```
 
-should return the string `I use Firn Protocol to gain privacy on Ethereum.`.
+which in turn would return the Diffie–Hellman secret:
+
+```javascript
+"0x4ad782e7409702101abe6d0279f242a2c545c46dd50a6704a4b9e3ae2730522e"
+```
+
+Upon proceeding with the above ECIES variant, the decryptor would then obtain the string `I use Firn Protocol to gain privacy on Ethereum.`.
 
 ## Security Considerations
 

From 15c0e2b8a488d21852680d0dea39d6b3ba22910d Mon Sep 17 00:00:00 2001
From: Firn Protocol <93839494+firnprotocol@users.noreply.github.com>
Date: Thu, 5 Jan 2023 13:51:18 -0500
Subject: [PATCH 117/274] very minor edits (#6263)

---
 EIPS/eip-5630.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5630.md b/EIPS/eip-5630.md
index 3015bc13359a46..a604a1c886e1f3 100644
--- a/EIPS/eip-5630.md
+++ b/EIPS/eip-5630.md
@@ -35,7 +35,7 @@ We propose that all binary data be serialized to and from `0x`-prefixed hex stri
 
   - the input byte string MUST have length ⌈log₂q / 8⌉ + 1 = `33`.
   - the first byte MUST be `0x02` or `0x03`.
-  - that the integer represented by the remaining 32 bytes (as in [SEC 1, §2.3.8]) MUST reside in {1, ..., _p_ - 1}, and moreover MUST yield a quadratic residue modulo _p_ under the Weierstrass expression X^3 + 7 (modulo _p_).
+  - the integer represented by the remaining 32 bytes (as in [SEC 1, §2.3.8]) MUST reside in {0, ..., _p_ - 1}, and moreover MUST yield a quadratic residue modulo _p_ under the Weierstrass expression X^3 + 7 (modulo _p_).
 
 For application-level implementers actually implementing ECIES, we propose the following variant. Unless they have a reason to do otherwise, implementers SHOULD use the following standardized choices:
 

From c3a1a5db84e81d713a5e28d97443d23732324998 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Thu, 5 Jan 2023 20:51:26 -0500
Subject: [PATCH 118/274] Add EIP-6188: Nonce Cap (#6188)

* Cap Nonce

* Assign EIP-6188

* Rename eip-nonce-cap.md to eip-6188.md

* Add discussions URL

* Remove circular link

* Apply suggestions from code review

* Oops yea that shouldn't be allowed, either

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* GitHub Copilot fail

Other people: "Wait, what do you mean 90% of this was written by an AI?"

* Add note saying why there are no security considerations

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-6188.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)
 create mode 100644 EIPS/eip-6188.md

diff --git a/EIPS/eip-6188.md b/EIPS/eip-6188.md
new file mode 100644
index 00000000000000..3b6cb1da12716b
--- /dev/null
+++ b/EIPS/eip-6188.md
@@ -0,0 +1,48 @@
+---
+eip: 6188
+title: Nonce Cap
+description: Caps the nonce at 2^64-2
+author: Pandapip1 (@Pandapip1)
+discussions-to: https://ethereum-magicians.org/t/eip-6190-functional-selfdestruct/12232
+status: Draft
+type: Standards Track
+category: Core
+created: 2022-12-20
+requires: 2929
+---
+
+## Abstract
+
+This EIP caps the nonce at `2^64-2`, reserving it for contracts with unusual behavior, as defined in other EIPs.
+
+## Motivation
+
+This EIP is not terribly useful on its own, as it adds additional computation without any useful side effects. However, it can be used by other EIPs.
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+### EOA Transactions
+
+The nonce of a transaction originating from an EOA MUST be less than `2^64-2`. If the nonce is either `2^64-1` or `2^64-2`, the transaction MUST be invalid.
+
+### `CREATE` and `CREATE2`
+
+If a nonce would be incremented to `2^64-1` by `CREATE` or `CREATE2`, it is instead set to `2^64-2`. `2^64-1` is reserved for alias or other special contracts.
+
+## Rationale
+
+Capping a nonce allows for contracts with special properties to be created, with their functionality based on their contract code. As such, only one nonce needs to be reserved.
+
+## Backwards Compatibility
+
+This EIP requires a protocol upgrade, since it modifies consensus rules. The further restriction of nonce should not have an effect on accounts, as reaching a nonce of `2^64-2` is unfeasible.
+
+## Security Considerations
+
+As it is infeasible for contract accounts to get to the nonce limit, any potential problems with opcodes that depend on the value of an account's nonce can be safely ignored.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From a82f8407166bc2c2244000994d8d7472f46c0276 Mon Sep 17 00:00:00 2001
From: Zergity <37166829+Zergity@users.noreply.github.com>
Date: Fri, 6 Jan 2023 10:53:29 +0700
Subject: [PATCH 119/274] Update EIP-6120: more contents and token-transfer
 sub-action (#6259)

* remove unnessary output token.amount > 0 condition

* security consideration for AMOUNT_INS_PLACEHOLDER

* no need to specify memory or calldata for bytes type

* support token-transfer sub-action and add more contents

* address CI issue

* texts and comments update for clarification
---
 EIPS/eip-6120.md | 272 ++++++++++++++++++++++++++++++-----------------
 1 file changed, 175 insertions(+), 97 deletions(-)

diff --git a/EIPS/eip-6120.md b/EIPS/eip-6120.md
index 71757b910dfff4..13fbd8a7a34e96 100644
--- a/EIPS/eip-6120.md
+++ b/EIPS/eip-6120.md
@@ -38,10 +38,12 @@ The Universal Token Router function arguments can act as a manifest for users wh
 
 Application contracts follow this standard can use the Universal Token Router to have the following benefits:
 
-* Share the user token allowance with all other applications.
+* Safely share the user token allowance with all other applications.
 * Freely update their helper contract logic.
 * Save development and security audit costs on router contracts.
 
+The Universal Token Router promotes the **security-by-result** model in decentralized applications instead of **security-by-process**. By directly querying token balance change for output verification, user transactions can be secured even while interacting with erroneous or malicious contracts. With non-token results, application helper contracts can provide additional result-checking functions for UTR's output action.
+
 ## Specification
 
 ```solidity
@@ -50,7 +52,8 @@ struct Token {
     address adr;    // token contract address
     uint id;        // token id for EIP721 and EIP1155
     uint amount;    // amountInMax for input action, amountOutMin for output action
-    uint offset;    // byte offset to get the amountIn from the last inputParams
+    uint offset;    // with input actions: byte offset to get the amountIn from the lastInputResult bytes
+                    // with output actions: 0 for token balance change verification, or output token transfer
     address recipient;
 }
 ```
@@ -74,36 +77,50 @@ interface IUniversalTokenRouter {
 
 Actions with `action.output == 0` declare which and how many tokens are transferred from `msg.sender` to `token.recipient`.
 
-1. If the `action.data` is not empty, `action.code.call(action.data)` is executed and the value returned is recorded in `amountIns` as a `bytes` for subsequence token transfer amounts.
+1. If the `action.data` is not empty, `action.code.call(action.data)` is executed and the value returned is recorded in `lastInputResult` as a `bytes` for subsequence token transfer amounts.
 2. For each `token` in `action.tokens`:
    * (a) The amount of token to be transferred is determined as:
      * if `offset < 32`, `amountIn = token.amount`
-     * if `offset >= 32`, `amountIn = amountIns.slice(offset-32, offset)`
-     * `amountIn` MUST NOT greater than `token.amount`, otherwise, transaction will be reverted with `EXCESSIVE_INPUT_AMOUNT` reason.
-   * (b) If the token is `ETH` and the `recipient` is `0x0`, step **(c)** is skipped and the `amountIn` will be passed to the next output action as the transaction value.
+     * if `offset >= 32`, `amountIn = lastInputResult.slice(offset-32, offset)`
+     * `amountIn` MUST NOT be greater than `token.amount`, otherwise, the transaction will be reverted with `EXCESSIVE_INPUT_AMOUNT`.
+   * (b) If the token is `ETH` and the `recipient` is `0x0`, the next step **(c)** is skipped and the `amountIn` will be passed to the next output action as the transaction value.
    * (c) Transfer `amountIn` of token from `msg.sender` to `recipient`.
 
-Note: `amountIns` is the last value returned by an input action's code contract call. It can be shared by multiple input actions until another action's code is executed. Using `amountIns` (by passing `offset >= 32`) before any input action execution can produce unexpected `amountIn` value.
+Note: `lastInputResult` is the last value returned by an input action's code contract call. It can be shared by multiple input actions until another action's code is executed. Using `lastInputResult` before any input action execution can produce unexpected `amountIn` values.
 
 ### Output Action
 
-Actions with `action.output > 0` declare the main application action to execute, and optionally verify the output tokens after all is done.
+Actions with `action.output > 0` declare the main application action to execute, and optionally transfer and verify the output tokens after that.
 
-1. For each `token` in `action.tokens` with `amount > 0`, the current token balance of `recipient` is recorded for later verification.
-2. Execute the `action.code.call{value: value}(action.data)`, where `value` can be zero or the `amountIn` of the last `ETH` input with `recipient == 0x0` (see Input Action 2b).
-3. `action.code` execution failure (revert) can be ignored by passing `action.output == 2`.
+1. If the `action.data` is not empty, execute the `action.code.call{value: value}(action.data)`, where:
+   * `value` can be zero or the `amountIn` of the last `ETH` input with `recipient == 0x0` (see Input Action 2b),
+   * any failure of the output execution will be ignored if the `action.output == 2`
+2. For each `token` in `action.tokens`:
+   * if `token.offset > 0`, transfer the following `amountOut` of token from `this` (UTR contract) to `token.recipient`:
+     * if `token.offset >= 32`, `amountOut = lastInputResult.slice(offset-32, offset)`
+     * if `token.offset == 1`:
+       * if `token.amount > 0`, `amountOut = token.amount`,
+       * if `token.amount == 0`, `amountOut` is the current token balance owned by `this` (UTR contract).
+   * if `token.offset == 0`, verify the balance change of `token.recipient`. The balance change MUST NOT be less than `token.amount` of each token, otherwise, the transaction will be reverted with `INSUFFICIENT_OUTPUT_AMOUNT`.
 
-The last `amountIns` bytes can be passed to an output action code execution by:
+The last `lastInputResult` bytes can be passed to an output action code execution by:
 
-* using a function with the last param is a `bytes memory` or `bytes calldata` type.
+* using a function with the last param as a `bytes` type.
 * pass the following value to that last param in the output `action.data`:
-    `AMOUNT_INS_PLACEHOLDER = keccak256('UniversalTokenRouter.AMOUNT_INS_PLACEHOLDER')`
+
+```
+LAST_INPUT_RESULT = keccak256('UniversalTokenRouter.LAST_INPUT_RESULT')
+```
 
 ### Output Token Verification
 
-After all the actions are handled as above, every token balance tracked in Output Action #1 is queried again for comparison. The balance change MUST NOT be less than `amount` of each token, otherwise, transaction will be reverted with `INSUFFICIENT_OUTPUT_AMOUNT` reason.
+At the very beginning of the `exec` function, for all output actions, each token with `token.offset == 0` has its balance of `token.recipient` recorded for later verification. After each output action, those token balances are queried again for comparison.
 
-A special id `EIP_721_ALL = keccak256('UniversalTokenRouter.EIP_721_ALL')` is reserved for EIP-721, which can be used in output actions to verify the total amount of all ids owned by the `recipient` address.
+A special id `EIP_721_ALL` is reserved for EIP-721, which can be used in output actions to verify the total amount of all ids owned by the `recipient` address.
+
+```
+EIP_721_ALL = keccak256('UniversalTokenRouter.EIP_721_ALL')
+```
 
 ### Usage Samples
 
@@ -144,8 +161,8 @@ UniversalTokenRouter.exec([{
         eip: 20,
         token: path[0],
         id: 0,
+        offset: 0, // use exact amount specified bellow
         amount: amountIn,
-        offset: 0, // use amount specified above
         recipient: UniswapV2Library.pairFor(factory, path[0], path[1]),
     }],
 }, {
@@ -153,11 +170,11 @@ UniversalTokenRouter.exec([{
     code: UniswapV2Helper01.address,
     data: encodeFunctionData("swapExactTokensForTokens", [amountIn, amountOutMin, path, to, deadline]),
     tokens: [{
+        offset: 0, // balance change verification
         eip: 20,
         token: path[path.length-1],
         id: 0,
         amount: amountOutMin,
-        offset: 0, // unused for output action
         recipient: to,
     }],
 }])
@@ -197,26 +214,26 @@ UniversalTokenRouter.exec([{
         eip: 20,
         token: path[0],
         id: 0,
+        offset: 64, // first item of getAmountIns result array
         amount: amountInMax,
-        offset: 64, // first item of getAmountIns result
         recipient: UniswapV2Library.pairFor(factory, path[0], path[1]),
     }],
 }, {
     output: 1,
     code: UniswapV2Helper01.address,
-    data: encodeFunctionData("swap", [path, to, AMOUNT_INS_PLACEHOLDER]),
+    data: encodeFunctionData("swap", [path, to, LAST_INPUT_RESULT]),
     tokens: [{
+        offset: 0, // balance change verification
         eip: 20,
         token: path[path.length-1],
         id: 0,
         amount: amountOut,
-        offset: 0, // unused for output action
         recipient: to,
     }],
 }])
 ```
 
-The result of input action's `getAmountIns` will replace the `AMOUNT_INS_PLACEHOLDER` bytes, save the transaction from calculating twice with the same data.
+The result of input action's `getAmountIns` will replace the `LAST_INPUT_RESULT` bytes, save the transaction from calculating twice with the same data.
 
 #### `UniswapRouter.addLiquidity`
 
@@ -253,15 +270,15 @@ UniversalTokenRouter.exec([{
         eip: 20,
         token: tokenA,
         id: 0,
-        amount: amountADesired,
-        offset: 32, // first item of _addLiquidity result
+        offset: 32,             // first item of _addLiquidity results
+        amount: amountADesired, // amountInMax
         recipient: UniswapV2Library.pairFor(factory, tokenA, tokenB),
     }, {
         eip: 20,
         token: tokenB,
         id: 0,
-        amount: amountBDesired,
-        offset: 64, // second item of _addLiquidity result
+        offset: 64,             // second item of _addLiquidity results
+        amount: amountBDesired, // amountInMax
         recipient: UniswapV2Library.pairFor(factory, tokenA, tokenB),
     }],
 }, {
@@ -269,11 +286,11 @@ UniversalTokenRouter.exec([{
     code: UniswapV2Library.pairFor(factory, tokenA, tokenB),
     data: encodeFunctionData("mint", [to]),
     tokens: [{
+        offset: 0,  // balance change verification
         eip: 20,
         token: UniswapV2Library.pairFor(factory, tokenA, tokenB),
         id: 0,
-        amount: 1,  // just enough to verify the correct recipient
-        offset: 0,  // unused for output action
+        amount: 1,  // amountOutMin: just enough to verify the correct recipient
         recipient: to,
     }],
 }])
@@ -289,43 +306,128 @@ Flashloan transactions are out of scope since it requires support from the appli
 
 ## Backwards Compatibility
 
+### Tokens
+
 Old token contracts (EIP-20, EIP-721 and EIP-1155) require approval for the Universal Token Router once for each account.
 
 New token contracts can pre-configure the Universal Token Router as a trusted spender, and no approval transaction is required.
 
+### Application Contracts
+
+All application contracts that accept `recipient` (or `to`) argument instead of using `msg.sender` as the beneficiary address are compatible with the UTR out of the box.
+
+Application contracts that transfer tokens (EIP-20, EIP-721, and EIP-1155) to `msg.sender` can use the UTR output token transfer sub-action to re-direct tokens to another `recipient` address.
+
+```javascript
+// sample code to deposit WETH and transfer them out
+UniversalTokenRouter.exec([{
+    output: 0,
+    code: AddressZero,
+    data: '0x',
+    tokens: [{
+        eip: 0,                 // ETH
+        adr: AddressZero,
+        id: 0,
+        offset: 0,              // use the exact amount specified bellow
+        amount: 123,
+        recipient: AddressZero, // pass it as the value for the next output action
+    }],
+}, {
+    output: 1,
+    code: WETH.address,
+    data: encodeFunctionData('deposit', []),    // WETH.deposit returns WETH token to the UTR contract
+    tokens: [{
+        offset: 1,  // token transfer sub-action
+        eip: 20,
+        adr: WETH.address,
+        id: 0,
+        amount: 0,  // entire WETH balance of this UTR contract
+        recipient: SomeRecipient,
+    }],
+}, {
+    // ... continue to use WETH in SomeRecipient
+}], {value: 123})
+```
+
+Applications can also deploy additional adapter contracts to add a `recipient` to their functions.
+
+```solidity
+// sample adapter contract for WETH
+contract WethAdapter {
+    address immutable WETH = 0x....;
+    function deposit(address recipient) external payable {
+        IWETH(WETH).deposit(){value: msg.value};
+        TransferHelper.safeTransfer(WETH, recipient, msg.value);
+    }
+}
+```
+
+Application contracts that use `msg.sender` as the beneficiary address in their internal storage without any function for ownership transfer are incompatible with the UTR.
+
 ## Reference Implementation
 
 ```solidity
 contract UniversalTokenRouter is IUniversalTokenRouter {
-    uint constant AMOUNT_INS_PLACEHOLDER = uint(keccak256('UniversalTokenRouter.AMOUNT_INS_PLACEHOLDER'));
+    uint constant LAST_INPUT_RESULT = uint(keccak256('UniversalTokenRouter.LAST_INPUT_RESULT'));
     uint constant EIP_721_ALL = uint(keccak256('UniversalTokenRouter.EIP_721_ALL'));
 
     function exec(
         Action[] calldata actions
     ) override external payable {
     unchecked {
-        uint[][] memory amounts = new uint[][](actions.length);
+        // track the balances before any action is executed
+        uint[][] memory balances = new uint[][](actions.length);
+        for (uint i = 0; i < actions.length; ++i) {
+            if (actions[i].output == 0 || actions[i].tokens.length == 0) {
+                continue;
+            }
+            balances[i] = new uint[](actions[i].tokens.length);
+            for (uint j = 0; j < balances[i].length; ++j) {
+                if (actions[i].tokens[j].offset == 0) {
+                    balances[i][j] = _balanceOf(actions[i].tokens[j], actions[i].tokens[j].recipient);
+                }
+            }
+        }
+
         uint value; // track the ETH value to pass to next output action transaction value
-        bytes memory amountIns;
+        bytes memory lastInputResult;
         for (uint i = 0; i < actions.length; ++i) {
             Action memory action = actions[i];
-            if (action.output > 0) {
-                // output action
-                amounts[i] = new uint[](action.tokens.length);
+            if (action.output == 0) {
+                // input action
+                if (action.data.length > 0) {
+                    bool success;
+                    (success, lastInputResult) = action.code.call(action.data);
+                    if (!success) {
+                        assembly {
+                            revert(add(lastInputResult,32),mload(lastInputResult))
+                        }
+                    }
+                }
                 for (uint j = 0; j < action.tokens.length; ++j) {
                     Token memory token = action.tokens[j];
-                    if (token.amount > 0) {
-                        // track the recipient balance before the action is executed
-                        amounts[i][j] = _balanceOf(token);
+                    if (token.offset >= 32) {
+                        // require(inputParams.length > 0, "UniversalTokenRouter: OFFSET_OF_EMPTY_INPUT");
+                        uint amount = _sliceUint(lastInputResult, token.offset);
+                        require(amount <= token.amount, "UniversalTokenRouter: EXCESSIVE_INPUT_AMOUNT");
+                        token.amount = amount;
+                    }
+                    if (token.eip == 0 && token.recipient == address(0x0)) {
+                        value = token.amount;
+                        // ETH not transfered here will be passed to the next output call value
+                    } else if (token.amount > 0) {
+                        _transferFrom(token, msg.sender);
                     }
                 }
+            } else {
+                // output action
                 if (action.data.length > 0) {
                     uint length = action.data.length;
                     if (length >= 4+32*3 &&
-                        _sliceUint(action.data, length) == AMOUNT_INS_PLACEHOLDER &&
+                        _sliceUint(action.data, length) == LAST_INPUT_RESULT &&
                         _sliceUint(action.data, length-32) == 32)
                     {
-                        action.data = _concat(action.data, length-32, amountIns);
+                        action.data = _concat(action.data, length-32, lastInputResult);
                     }
                     (bool success, bytes memory result) = action.code.call{value: value}(action.data);
                     // ignore output action error if output == 2
@@ -336,65 +438,45 @@ contract UniversalTokenRouter is IUniversalTokenRouter {
                     }
                     delete value; // clear the ETH value after transfer
                 }
-                continue;
-            }
-            // input action
-            if (action.data.length > 0) {
-                bool success;
-                (success, amountIns) = action.code.call(action.data);
-                if (!success) {
-                    assembly {
-                        revert(add(amountIns,32),mload(amountIns))
+                for (uint j = 0; j < action.tokens.length; ++j) {
+                    Token memory token = actions[i].tokens[j];
+                    if (token.offset > 0) {
+                        // token transfer sub-action
+                        if (token.offset >= 32) {
+                            token.amount = _sliceUint(lastInputResult, token.offset);
+                        } else if (token.amount == 0) {
+                            token.amount = _balanceOf(token, address(this));
+                        }
+                        _transferFrom(token, address(this));
+                    } else {
+                        // verify the balance change
+                        uint balance = _balanceOf(token, token.recipient);
+                        uint change = balance - balances[i][j]; // overflow checked with `change <= balance` bellow
+                        require(change >= token.amount && change <= balance, 'UniversalTokenRouter: INSUFFICIENT_OUTPUT_AMOUNT');
                     }
                 }
             }
-            for (uint j = 0; j < action.tokens.length; ++j) {
-                Token memory token = action.tokens[j];
-                if (token.offset >= 32) {
-                    uint amount = _sliceUint(amountIns, token.offset);
-                    require(amount <= token.amount, "UniversalTokenRouter: EXCESSIVE_INPUT_AMOUNT");
-                    token.amount = amount;
-                }
-                if (token.eip == 0 && token.recipient == address(0x0)) {
-                    value = token.amount;
-                    continue; // ETH not transfered here will be passed to the next output call value
-                }
-                if (token.amount > 0) {
-                    _transfer(token);
-                }
-            }
         }
+
         // refund any left-over ETH
         uint leftOver = address(this).balance;
         if (leftOver > 0) {
             TransferHelper.safeTransferETH(msg.sender, leftOver);
         }
-        // verify the balance change
-        for (uint i = 0; i < actions.length; ++i) {
-            if (actions[i].output == 0) {
-                continue;
-            }
-            for (uint j = 0; j < actions[i].tokens.length; ++j) {
-                Token memory token = actions[i].tokens[j];
-                if (token.amount == 0) {
-                    continue;
-                }
-                uint balance = _balanceOf(token);
-                uint change = balance - amounts[i][j]; // overflow checked with `change <= balance` bellow
-                require(change >= token.amount && change <= balance, 'UniversalTokenRouter: INSUFFICIENT_OUTPUT_AMOUNT');
-                amounts[i][j] = change;
-            }
-        }
     } }
 
-    function _transfer(Token memory token) internal {
+    function _transferFrom(Token memory token, address from) internal {
     unchecked {
         if (token.eip == 20) {
-            TransferHelper.safeTransferFrom(token.adr, msg.sender, token.recipient, token.amount);
+            if (from == address(this)) {
+                TransferHelper.safeTransfer(token.adr, token.recipient, token.amount);
+            } else {
+                TransferHelper.safeTransferFrom(token.adr, from, token.recipient, token.amount);
+            }
         } else if (token.eip == 1155) {
-            IERC1155(token.adr).safeTransferFrom(msg.sender, token.recipient, token.id, token.amount, "");
+            IERC1155(token.adr).safeTransferFrom(from, token.recipient, token.id, token.amount, "");
         } else if (token.eip == 721) {
-            IERC721(token.adr).safeTransferFrom(msg.sender, token.recipient, token.id);
+            IERC721(token.adr).safeTransferFrom(from, token.recipient, token.id);
         } else if (token.eip == 0) {
             TransferHelper.safeTransferETH(token.recipient, token.amount);
         } else {
@@ -402,27 +484,26 @@ contract UniversalTokenRouter is IUniversalTokenRouter {
         }
     } }
 
-    function _balanceOf(Token memory token) internal view returns (uint balance) {
+    function _balanceOf(Token memory token, address owner) internal view returns (uint balance) {
     unchecked {
         if (token.eip == 20) {
-            return IERC20(token.adr).balanceOf(token.recipient);
+            return IERC20(token.adr).balanceOf(owner);
         }
         if (token.eip == 1155) {
-            return IERC1155(token.adr).balanceOf(token.recipient, token.id);
+            return IERC1155(token.adr).balanceOf(owner, token.id);
         }
         if (token.eip == 721) {
             if (token.id == EIP_721_ALL) {
-                return IERC721(token.adr).balanceOf(token.recipient);
+                return IERC721(token.adr).balanceOf(owner);
             }
-            return IERC721(token.adr).ownerOf(token.id) == token.recipient ? 1 : 0;
+            return IERC721(token.adr).ownerOf(token.id) == owner ? 1 : 0;
         }
         if (token.eip == 0) {
-            return token.recipient.balance;
+            return owner.balance;
         }
         revert("UniversalTokenRouter: INVALID_EIP");
     } }
 
-    // https://ethereum.stackexchange.com/a/54405
     function _sliceUint(bytes memory bs, uint start) internal pure returns (uint x) {
     unchecked {
         // require(bs.length >= start + 32, "slicing out of range");
@@ -431,16 +512,13 @@ contract UniversalTokenRouter is IUniversalTokenRouter {
         }
     } }
 
-    // https://github.com/GNSPS/solidity-bytes-utils/blob/master/contracts/BytesLib.sol
+    /// https://github.com/GNSPS/solidity-bytes-utils/blob/master/contracts/BytesLib.sol
+    /// @param length length of the first preBytes
     function _concat(
         bytes memory preBytes,
         uint length,
         bytes memory postBytes
-    )
-        internal
-        pure
-        returns (bytes memory bothBytes)
-    {
+    ) internal pure returns (bytes memory bothBytes) {
         assembly {
             // Get a location of some free memory and store it in bothBytes as
             // Solidity does for memory variables.
@@ -510,7 +588,7 @@ contract UniversalTokenRouter is IUniversalTokenRouter {
 
 ## Security Considerations
 
-As long as user tokens are only transferred from `msg.sender`, the token allowance can only be used with transactions signed by the token owner.
+`LAST_INPUT_RESULT` SHOULD only be used in output action for gas optimization, not as trusted conditions. Application contract code MUST always expect arbitruary, malformed or mallicious `bytes` data can be passed in where the `LAST_INPUT_RESULT` is expected.
 
 ## Copyright
 

From 7bf7799eedd19d50fd1ac6c7a2782de906ddcfaf Mon Sep 17 00:00:00 2001
From: Weiji Guo <weiji.g@gmail.com>
Date: Fri, 6 Jan 2023 14:36:52 +0800
Subject: [PATCH 120/274] Added coauthor (#6267)

---
 EIPS/eip-5630.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5630.md b/EIPS/eip-5630.md
index a604a1c886e1f3..db1ba3b0eed985 100644
--- a/EIPS/eip-5630.md
+++ b/EIPS/eip-5630.md
@@ -2,7 +2,7 @@
 eip: 5630
 title: New approach for encryption / decryption
 description: defines a specification for encryption and decryption using deterministically derived, pseudorandom keys.
-author: Firn Protocol (@firnprotocol), Fried L. Trout
+author: Firn Protocol (@firnprotocol), Fried L. Trout, Weiji Guo (@weijiguo)
 discussions-to: https://ethereum-magicians.org/t/eip-5630-encryption-and-decryption/10761
 status: Draft
 type: Standards Track

From 98b75d56b17e71b29af4f982553908910ceb61d9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20Daubensch=C3=BCtz?= <tim@daubenschuetz.de>
Date: Fri, 6 Jan 2023 10:24:38 -0500
Subject: [PATCH 121/274] Improvements for signature generation (#6270)

- Remove EIP-2098 support
- Switch `string tokenURI` to more generic `bytes metadata`
---
 EIPS/eip-4973.md                              |  73 +++--
 .../{ERC-4973.sol => ERC4973-flat.sol}        | 301 +++++++++---------
 assets/eip-4973/package.json                  |  45 +++
 .../src/index.mjs}                            |  12 +-
 .../test/index_test.mjs}                      |  27 +-
 5 files changed, 251 insertions(+), 207 deletions(-)
 rename assets/eip-4973/{ERC-4973.sol => ERC4973-flat.sol} (87%)
 create mode 100644 assets/eip-4973/package.json
 rename assets/eip-4973/{generateSignature.mjs => sdk/src/index.mjs} (50%)
 rename assets/eip-4973/{generateSignature_test.mjs => sdk/test/index_test.mjs} (56%)

diff --git a/EIPS/eip-4973.md b/EIPS/eip-4973.md
index 0a0d042b9ee14c..a16ced13212217 100644
--- a/EIPS/eip-4973.md
+++ b/EIPS/eip-4973.md
@@ -8,7 +8,7 @@ status: Review
 type: Standards Track
 category: ERC
 created: 2022-04-01
-requires: 165, 712, 721, 1271, 2098
+requires: 165, 712, 721, 1271
 ---
 
 ## Abstract
@@ -54,21 +54,20 @@ pragma solidity ^0.8.6;
 
 /// @title Account-bound tokens
 /// @dev See https://eips.ethereum.org/EIPS/eip-4973
-/// Note: the ERC-165 identifier for this interface is 0x8d7bac72
+/// Note: the ERC-165 identifier for this interface is 0xeb72bb7c
 interface IERC4973 {
   /// @dev This emits when ownership of any ABT changes by any mechanism.
   ///  This event emits when ABTs are given or equipped and unequipped
   ///  (`to` == 0).
   event Transfer(
-    address indexed from,
-    address indexed to,
-    uint256 indexed tokenId
+    address indexed from, address indexed to, uint256 indexed tokenId
   );
   /// @notice Count all ABTs assigned to an owner
   /// @dev ABTs assigned to the zero address are considered invalid, and this
   ///  function throws for queries about the zero address.
   /// @param owner An address for whom to query the balance
   /// @return The number of ABTs owned by `address owner`, possibly zero
+
   function balanceOf(address owner) external view returns (uint256);
   /// @notice Find the address bound to an ERC4973 account-bound token
   /// @dev ABTs assigned to zero address are considered invalid, and queries
@@ -87,11 +86,11 @@ interface IERC4973 {
   function unequip(uint256 tokenId) external;
   /// @notice Creates and transfers the ownership of an ABT from the
   ///  transaction's `msg.sender` to `address to`.
-  /// @dev Throws unless `bytes signature` represents an EIP-2098 Compact
-  ///  Signature of the EIP-712 structured data hash
-  ///  `Agreement(address active,address passive,string tokenURI)` expressing
+  /// @dev Throws unless `bytes signature` represents a signature of the
+  //   EIP-712 structured data hash
+  ///  `Agreement(address active,address passive,bytes metadata)` expressing
   ///  `address to`'s explicit agreement to be publicly associated with
-  ///  `msg.sender` and `string tokenURI`. A unique `uint256 tokenId` must be
+  ///  `msg.sender` and `bytes metadata`. A unique `uint256 tokenId` must be
   ///  generated by type-casting the `bytes32` EIP-712 structured data hash to a
   ///  `uint256`. If `bytes signature` is empty or `address to` is a contract,
   ///  an EIP-1271-compatible call to `function isValidSignatureNow(...)` must
@@ -99,25 +98,22 @@ interface IERC4973 {
   ///  `event Transfer(msg.sender, to, tokenId)`. Once an ABT exists as an
   ///  `uint256 tokenId` in the contract, `function give(...)` must throw.
   /// @param to The receiver of the ABT.
-  /// @param uri A distinct Uniform Resource Identifier (URI) for a given ABT.
-  /// @param signature A EIP-2098-compatible Compact Signature of the EIP-712
-  ///  structured data hash
-  ///  `Agreement(address active,address passive,string tokenURI)` signed by
+  /// @param metadata The metadata that will be associated to the ABT.
+  /// @param signature A signature of the EIP-712 structured data hash
+  ///  `Agreement(address active,address passive,bytes metadata)` signed by
   ///  `address to`.
   /// @return A unique `uint256 tokenId` generated by type-casting the `bytes32`
   ///  EIP-712 structured data hash to a `uint256`.
-  function give(
-    address to,
-    string calldata uri,
-    bytes calldata signature
-  ) external returns (uint256);
+  function give(address to, bytes calldata metadata, bytes calldata signature)
+    external
+    returns (uint256);
   /// @notice Creates and transfers the ownership of an ABT from an
   /// `address from` to the transaction's `msg.sender`.
-  /// @dev Throws unless `bytes signature` represents an EIP-2098 Compact
-  ///  Signature of the EIP-712 structured data hash
-  ///  `Agreement(address active,address passive,string tokenURI)` expressing
+  /// @dev Throws unless `bytes signature` represents a signature of the
+  ///  EIP-712 structured data hash
+  ///  `Agreement(address active,address passive,bytes metadata)` expressing
   ///  `address from`'s explicit agreement to be publicly associated with
-  ///  `msg.sender` and `string tokenURI`. A unique `uint256 tokenId` must be
+  ///  `msg.sender` and `bytes metadata`. A unique `uint256 tokenId` must be
   ///  generated by type-casting the `bytes32` EIP-712 structured data hash to a
   ///  `uint256`. If `bytes signature` is empty or `address from` is a contract,
   ///  an EIP-1271-compatible call to `function isValidSignatureNow(...)` must
@@ -126,26 +122,35 @@ interface IERC4973 {
   ///  exists as an `uint256 tokenId` in the contract, `function take(...)` must
   ///  throw.
   /// @param from The origin of the ABT.
-  /// @param uri A distinct Uniform Resource Identifier (URI) for a given ABT.
-  /// @param signature A EIP-2098-compatible Compact Signature of the EIP-712
-  ///  structured data hash
-  ///  `Agreement(address active,address passive,string tokenURI)` signed by
+  /// @param metadata The metadata that will be associated to the ABT.
+  /// @param signature A signature of the EIP-712 structured data hash
+  ///  `Agreement(address active,address passive,bytes metadata)` signed by
   ///  `address from`.
   /// @return A unique `uint256 tokenId` generated by type-casting the `bytes32`
   ///  EIP-712 structured data hash to a `uint256`.
-  function take(
-    address from,
-    string calldata uri,
-    bytes calldata signature
-  ) external returns (uint256);
+  function take(address from, bytes calldata metadata, bytes calldata signature)
+    external
+    returns (uint256);
+  /// @notice Decodes the opaque metadata bytestring of an ABT into the token
+  ///  URI that will be associated with it once it is created on chain.
+  /// @param metadata The metadata that will be associated to an ABT.
+  /// @return A URI that represents the metadata.
+  function decodeURI(bytes calldata metadata) external returns (string memory);
 }
 ```
 
 See [EIP-721](./eip-721.md) for a definition of its metadata JSON Schema.
 
-### [EIP-712](./eip-712.md) Typed Structured Data Hashing and [EIP-2098](./eip-2098) Compact Signature Creation
+### [EIP-712](./eip-712.md) Typed Structured Data Hashing and Bytearray Signature Creation
+
+To invoke `function give(...)` and `function take(...)` a bytearray signature must be created using [EIP-712](./eip-712.md). A tested reference implementation in Node.js is attached at [../assets/eip-4973/sdk/src/index.mjs](../assets/eip-4973/sdk/src/index.mjs), [../assets/eip-4973/sdk/test/index_test.mjs](../assets/eip-4973/sdk/test/index_test.mjs) and [../assets/eip-4973/package.json](../assets/eip-4973/package.json). In Solidity, this bytearray signature can be created as follows:
 
-To invoke `function give(...)` and `function take(...)` an [EIP-2098](./eip-2098.md) compact signature must be created using [EIP-712](./eip-712.md). A tested reference implementation is attached at [../assets/eip-4973/generateSignature.mjs](../assets/eip-4973/generateSignature.mjs) and [../assets/eip-4973/generateSignature_test.mjs](../assets/eip-4973/generateSignature_test.mjs).
+```solidity
+bytes32 r = 0x68a020a209d3d56c46f38cc50a33f704f4a9a10a59377f8dd762ac66910e9b90;
+bytes32 s = 0x7e865ad05c4035ab5792787d4a0297a43617ae897930a6fe4d822b8faea52064;
+uint8 v   = 27;
+bytes memory signature = abi.encodePacked(r, s, v);
+```
 
 ## Rationale
 
@@ -181,7 +186,7 @@ We have adopted the [EIP-165](./eip-165.md) and `ERC721Metadata` functions purpo
 
 ## Reference Implementation
 
-You can find an implementation of this standard in [../assets/eip-4973](../assets/eip-4973/ERC-4973.sol).
+You can find an implementation of this standard in [../assets/eip-4973](../assets/eip-4973/ERC4973-flat.sol).
 
 ## Security Considerations
 
diff --git a/assets/eip-4973/ERC-4973.sol b/assets/eip-4973/ERC4973-flat.sol
similarity index 87%
rename from assets/eip-4973/ERC-4973.sol
rename to assets/eip-4973/ERC4973-flat.sol
index 4b7b60540a3bad..e20aa82208f0ae 100644
--- a/assets/eip-4973/ERC-4973.sol
+++ b/assets/eip-4973/ERC4973-flat.sol
@@ -1,11 +1,11 @@
 // SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.8.8;
 
-// OpenZeppelin Contracts (last updated v4.5.0) (utils/cryptography/SignatureChecker.sol)
+// OpenZeppelin Contracts (last updated v4.7.1) (utils/cryptography/SignatureChecker.sol)
 
-// OpenZeppelin Contracts (last updated v4.5.0) (utils/cryptography/ECDSA.sol)
+// OpenZeppelin Contracts (last updated v4.7.3) (utils/cryptography/ECDSA.sol)
 
-// OpenZeppelin Contracts v4.4.1 (utils/Strings.sol)
+// OpenZeppelin Contracts (last updated v4.7.0) (utils/Strings.sol)
 
 /**
  * @dev String operations.
@@ -128,9 +128,6 @@ library ECDSA {
      * _Available since v4.3._
      */
     function tryRecover(bytes32 hash, bytes memory signature) internal pure returns (address, RecoverError) {
-        // Check the signature length
-        // - case 65: r,s,v signature (standard)
-        // - case 64: r,vs signature (cf https://eips.ethereum.org/EIPS/eip-2098) _Available since v4.1._
         if (signature.length == 65) {
             bytes32 r;
             bytes32 s;
@@ -144,17 +141,6 @@ library ECDSA {
                 v := byte(0, mload(add(signature, 0x60)))
             }
             return tryRecover(hash, v, r, s);
-        } else if (signature.length == 64) {
-            bytes32 r;
-            bytes32 vs;
-            // ecrecover takes the signature parameters, and the only way to get them
-            // currently is to use assembly.
-            /// @solidity memory-safe-assembly
-            assembly {
-                r := mload(add(signature, 0x20))
-                vs := mload(add(signature, 0x40))
-            }
-            return tryRecover(hash, r, vs);
         } else {
             return (address(0), RecoverError.InvalidSignatureLength);
         }
@@ -304,7 +290,7 @@ library ECDSA {
     }
 }
 
-// OpenZeppelin Contracts (last updated v4.5.0) (utils/Address.sol)
+// OpenZeppelin Contracts (last updated v4.7.0) (utils/Address.sol)
 
 /**
  * @dev Collection of functions related to the address type
@@ -386,7 +372,7 @@ library Address {
      * _Available since v3.1._
      */
     function functionCall(address target, bytes memory data) internal returns (bytes memory) {
-        return functionCallWithValue(target, data, 0, "Address: low-level call failed");
+        return functionCall(target, data, "Address: low-level call failed");
     }
 
     /**
@@ -569,7 +555,9 @@ library SignatureChecker {
         (bool success, bytes memory result) = signer.staticcall(
             abi.encodeWithSelector(IERC1271.isValidSignature.selector, hash, signature)
         );
-        return (success && result.length == 32 && abi.decode(result, (bytes4)) == IERC1271.isValidSignature.selector);
+        return (success &&
+            result.length == 32 &&
+            abi.decode(result, (bytes32)) == bytes32(IERC1271.isValidSignature.selector));
     }
 }
 
@@ -673,6 +661,54 @@ abstract contract EIP712 {
     }
 }
 
+// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
+
+// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
+
+/**
+ * @dev Interface of the ERC165 standard, as defined in the
+ * https://eips.ethereum.org/EIPS/eip-165[EIP].
+ *
+ * Implementers can declare support of contract interfaces, which can then be
+ * queried by others ({ERC165Checker}).
+ *
+ * For an implementation, see {ERC165}.
+ */
+interface IERC165 {
+    /**
+     * @dev Returns true if this contract implements the interface defined by
+     * `interfaceId`. See the corresponding
+     * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
+     * to learn more about how these ids are created.
+     *
+     * This function call must use less than 30 000 gas.
+     */
+    function supportsInterface(bytes4 interfaceId) external view returns (bool);
+}
+
+/**
+ * @dev Implementation of the {IERC165} interface.
+ *
+ * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
+ * for the additional interface id that will be supported. For example:
+ *
+ * ```solidity
+ * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
+ *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
+ * }
+ * ```
+ *
+ * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
+ */
+abstract contract ERC165 is IERC165 {
+    /**
+     * @dev See {IERC165-supportsInterface}.
+     */
+    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
+        return interfaceId == type(IERC165).interfaceId;
+    }
+}
+
 // OpenZeppelin Contracts v4.4.1 (utils/structs/BitMaps.sol)
 
 /**
@@ -727,54 +763,6 @@ library BitMaps {
     }
 }
 
-// OpenZeppelin Contracts v4.4.1 (utils/introspection/ERC165.sol)
-
-// OpenZeppelin Contracts v4.4.1 (utils/introspection/IERC165.sol)
-
-/**
- * @dev Interface of the ERC165 standard, as defined in the
- * https://eips.ethereum.org/EIPS/eip-165[EIP].
- *
- * Implementers can declare support of contract interfaces, which can then be
- * queried by others ({ERC165Checker}).
- *
- * For an implementation, see {ERC165}.
- */
-interface IERC165 {
-  /**
-   * @dev Returns true if this contract implements the interface defined by
-   * `interfaceId`. See the corresponding
-   * https://eips.ethereum.org/EIPS/eip-165#how-interfaces-are-identified[EIP section]
-   * to learn more about how these ids are created.
-   *
-   * This function call must use less than 30 000 gas.
-   */
-  function supportsInterface(bytes4 interfaceId) external view returns (bool);
-}
-
-/**
- * @dev Implementation of the {IERC165} interface.
- *
- * Contracts that want to implement ERC165 should inherit from this contract and override {supportsInterface} to check
- * for the additional interface id that will be supported. For example:
- *
- * ```solidity
- * function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
- *     return interfaceId == type(MyInterface).interfaceId || super.supportsInterface(interfaceId);
- * }
- * ```
- *
- * Alternatively, {ERC165Storage} provides an easier to use but more expensive implementation.
- */
-abstract contract ERC165 is IERC165 {
-  /**
-   * @dev See {IERC165-supportsInterface}.
-   */
-  function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
-      return interfaceId == type(IERC165).interfaceId;
-  }
-}
-
 interface IERC721Metadata {
   function name() external view returns (string memory);
   function symbol() external view returns (string memory);
@@ -783,21 +771,20 @@ interface IERC721Metadata {
 
 /// @title Account-bound tokens
 /// @dev See https://eips.ethereum.org/EIPS/eip-4973
-/// Note: the ERC-165 identifier for this interface is 0x8d7bac72
+/// Note: the ERC-165 identifier for this interface is 0xeb72bb7c
 interface IERC4973 {
   /// @dev This emits when ownership of any ABT changes by any mechanism.
   ///  This event emits when ABTs are given or equipped and unequipped
   ///  (`to` == 0).
   event Transfer(
-    address indexed from,
-    address indexed to,
-    uint256 indexed tokenId
+    address indexed from, address indexed to, uint256 indexed tokenId
   );
   /// @notice Count all ABTs assigned to an owner
   /// @dev ABTs assigned to the zero address are considered invalid, and this
   ///  function throws for queries about the zero address.
   /// @param owner An address for whom to query the balance
   /// @return The number of ABTs owned by `address owner`, possibly zero
+
   function balanceOf(address owner) external view returns (uint256);
   /// @notice Find the address bound to an ERC4973 account-bound token
   /// @dev ABTs assigned to zero address are considered invalid, and queries
@@ -816,11 +803,11 @@ interface IERC4973 {
   function unequip(uint256 tokenId) external;
   /// @notice Creates and transfers the ownership of an ABT from the
   ///  transaction's `msg.sender` to `address to`.
-  /// @dev Throws unless `bytes signature` represents an EIP-2098 Compact
-  ///  Signature of the EIP-712 structured data hash
-  ///  `Agreement(address active,address passive,string tokenURI)` expressing
+  /// @dev Throws unless `bytes signature` represents a signature of the
+  //   EIP-712 structured data hash
+  ///  `Agreement(address active,address passive,bytes metadata)` expressing
   ///  `address to`'s explicit agreement to be publicly associated with
-  ///  `msg.sender` and `string tokenURI`. A unique `uint256 tokenId` must be
+  ///  `msg.sender` and `bytes metadata`. A unique `uint256 tokenId` must be
   ///  generated by type-casting the `bytes32` EIP-712 structured data hash to a
   ///  `uint256`. If `bytes signature` is empty or `address to` is a contract,
   ///  an EIP-1271-compatible call to `function isValidSignatureNow(...)` must
@@ -828,25 +815,22 @@ interface IERC4973 {
   ///  `event Transfer(msg.sender, to, tokenId)`. Once an ABT exists as an
   ///  `uint256 tokenId` in the contract, `function give(...)` must throw.
   /// @param to The receiver of the ABT.
-  /// @param uri A distinct Uniform Resource Identifier (URI) for a given ABT.
-  /// @param signature A EIP-2098-compatible Compact Signature of the EIP-712
-  ///  structured data hash
-  ///  `Agreement(address active,address passive,string tokenURI)` signed by
+  /// @param metadata The metadata that will be associated to the ABT.
+  /// @param signature A signature of the EIP-712 structured data hash
+  ///  `Agreement(address active,address passive,bytes metadata)` signed by
   ///  `address to`.
   /// @return A unique `uint256 tokenId` generated by type-casting the `bytes32`
   ///  EIP-712 structured data hash to a `uint256`.
-  function give(
-    address to,
-    string calldata uri,
-    bytes calldata signature
-  ) external returns (uint256);
+  function give(address to, bytes calldata metadata, bytes calldata signature)
+    external
+    returns (uint256);
   /// @notice Creates and transfers the ownership of an ABT from an
   /// `address from` to the transaction's `msg.sender`.
-  /// @dev Throws unless `bytes signature` represents an EIP-2098 Compact
-  ///  Signature of the EIP-712 structured data hash
-  ///  `Agreement(address active,address passive,string tokenURI)` expressing
+  /// @dev Throws unless `bytes signature` represents a signature of the
+  ///  EIP-712 structured data hash
+  ///  `Agreement(address active,address passive,bytes metadata)` expressing
   ///  `address from`'s explicit agreement to be publicly associated with
-  ///  `msg.sender` and `string tokenURI`. A unique `uint256 tokenId` must be
+  ///  `msg.sender` and `bytes metadata`. A unique `uint256 tokenId` must be
   ///  generated by type-casting the `bytes32` EIP-712 structured data hash to a
   ///  `uint256`. If `bytes signature` is empty or `address from` is a contract,
   ///  an EIP-1271-compatible call to `function isValidSignatureNow(...)` must
@@ -855,29 +839,30 @@ interface IERC4973 {
   ///  exists as an `uint256 tokenId` in the contract, `function take(...)` must
   ///  throw.
   /// @param from The origin of the ABT.
-  /// @param uri A distinct Uniform Resource Identifier (URI) for a given ABT.
-  /// @param signature A EIP-2098-compatible Compact Signature of the EIP-712
-  ///  structured data hash
-  ///  `Agreement(address active,address passive,string tokenURI)` signed by
+  /// @param metadata The metadata that will be associated to the ABT.
+  /// @param signature A signature of the EIP-712 structured data hash
+  ///  `Agreement(address active,address passive,bytes metadata)` signed by
   ///  `address from`.
   /// @return A unique `uint256 tokenId` generated by type-casting the `bytes32`
   ///  EIP-712 structured data hash to a `uint256`.
-  function take(
-    address from,
-    string calldata uri,
-    bytes calldata signature
-  ) external returns (uint256);
+  function take(address from, bytes calldata metadata, bytes calldata signature)
+    external
+    returns (uint256);
+  /// @notice Decodes the opaque metadata bytestring of an ABT into the token
+  ///  URI that will be associated with it once it is created on chain.
+  /// @param metadata The metadata that will be associated to an ABT.
+  /// @return A URI that represents the metadata.
+  function decodeURI(bytes calldata metadata) external returns (string memory);
 }
 
 bytes32 constant AGREEMENT_HASH =
-  keccak256(
-    "Agreement(address active,address passive,string tokenURI)"
-);
+  keccak256("Agreement(address active,address passive,bytes metadata)");
 
 /// @notice Reference implementation of EIP-4973 tokens.
 /// @author Tim Daubenschütz, Rahul Rumalla (https://github.com/rugpullindex/ERC4973/blob/master/src/ERC4973.sol)
 abstract contract ERC4973 is EIP712, ERC165, IERC721Metadata, IERC4973 {
   using BitMaps for BitMaps.BitMap;
+
   BitMaps.BitMap private _usedHashes;
 
   string private _name;
@@ -887,20 +872,23 @@ abstract contract ERC4973 is EIP712, ERC165, IERC721Metadata, IERC4973 {
   mapping(uint256 => string) private _tokenURIs;
   mapping(address => uint256) private _balances;
 
-  constructor(
-    string memory name_,
-    string memory symbol_,
-    string memory version
-  ) EIP712(name_, version) {
+  constructor(string memory name_, string memory symbol_, string memory version)
+    EIP712(name_, version)
+  {
     _name = name_;
     _symbol = symbol_;
   }
 
-  function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
-    return
-      interfaceId == type(IERC721Metadata).interfaceId ||
-      interfaceId == type(IERC4973).interfaceId ||
-      super.supportsInterface(interfaceId);
+  function supportsInterface(bytes4 interfaceId)
+    public
+    view
+    virtual
+    override
+    returns (bool)
+  {
+    return interfaceId == type(IERC721Metadata).interfaceId
+      || interfaceId == type(IERC4973).interfaceId
+      || super.supportsInterface(interfaceId);
   }
 
   function name() public view virtual override returns (string memory) {
@@ -911,7 +899,13 @@ abstract contract ERC4973 is EIP712, ERC165, IERC721Metadata, IERC4973 {
     return _symbol;
   }
 
-  function tokenURI(uint256 tokenId) public view virtual override returns (string memory) {
+  function tokenURI(uint256 tokenId)
+    public
+    view
+    virtual
+    override
+    returns (string memory)
+  {
     require(_exists(tokenId), "tokenURI: token doesn't exist");
     return _tokenURIs[tokenId];
   }
@@ -922,7 +916,13 @@ abstract contract ERC4973 is EIP712, ERC165, IERC721Metadata, IERC4973 {
     _burn(tokenId);
   }
 
-  function balanceOf(address owner) public view virtual override returns (uint256) {
+  function balanceOf(address owner)
+    public
+    view
+    virtual
+    override
+    returns (uint256)
+  {
     require(owner != address(0), "balanceOf: address zero is not a valid owner");
     return _balances[owner];
   }
@@ -933,37 +933,51 @@ abstract contract ERC4973 is EIP712, ERC165, IERC721Metadata, IERC4973 {
     return owner;
   }
 
-  function give(
-    address to,
-    string calldata uri,
-    bytes calldata signature
-  ) external virtual returns (uint256) {
+  function give(address to, bytes calldata metadata, bytes calldata signature)
+    external
+    virtual
+    returns (uint256)
+  {
     require(msg.sender != to, "give: cannot give from self");
-    uint256 tokenId = _safeCheckAgreement(msg.sender, to, uri, signature);
+    uint256 tokenId = _safeCheckAgreement(msg.sender, to, metadata, signature);
+    string memory uri = decodeURI(metadata);
     _mint(msg.sender, to, tokenId, uri);
     _usedHashes.set(tokenId);
     return tokenId;
   }
 
-  function take(
-    address from,
-    string calldata uri,
-    bytes calldata signature
-  ) external virtual returns (uint256) {
+  function take(address from, bytes calldata metadata, bytes calldata signature)
+    external
+    virtual
+    returns (uint256)
+  {
     require(msg.sender != from, "take: cannot take from self");
-    uint256 tokenId = _safeCheckAgreement(msg.sender, from, uri, signature);
+    uint256 tokenId = _safeCheckAgreement(msg.sender, from, metadata, signature);
+    string memory uri = decodeURI(metadata);
     _mint(from, msg.sender, tokenId, uri);
     _usedHashes.set(tokenId);
     return tokenId;
   }
 
+  function decodeURI(bytes calldata metadata)
+    public
+    virtual
+    returns (string memory)
+  {
+    return string(metadata);
+  }
+
   function _safeCheckAgreement(
     address active,
     address passive,
-    string calldata uri,
+    bytes calldata metadata,
     bytes calldata signature
-  ) internal virtual returns (uint256) {
-    bytes32 hash = _getHash(active, passive, uri);
+  )
+    internal
+    virtual
+    returns (uint256)
+  {
+    bytes32 hash = _getHash(active, passive, metadata);
     uint256 tokenId = uint256(hash);
 
     require(
@@ -974,19 +988,13 @@ abstract contract ERC4973 is EIP712, ERC165, IERC721Metadata, IERC4973 {
     return tokenId;
   }
 
-  function _getHash(
-    address active,
-    address passive,
-    string calldata uri
-  ) internal view returns (bytes32) {
-    bytes32 structHash = keccak256(
-      abi.encode(
-        AGREEMENT_HASH,
-        active,
-        passive,
-        keccak256(bytes(uri))
-      )
-    );
+  function _getHash(address active, address passive, bytes calldata metadata)
+    internal
+    view
+    returns (bytes32)
+  {
+    bytes32 structHash =
+      keccak256(abi.encode(AGREEMENT_HASH, active, passive, keccak256(metadata)));
     return _hashTypedDataV4(structHash);
   }
 
@@ -994,12 +1002,11 @@ abstract contract ERC4973 is EIP712, ERC165, IERC721Metadata, IERC4973 {
     return _owners[tokenId] != address(0);
   }
 
-  function _mint(
-    address from,
-    address to,
-    uint256 tokenId,
-    string memory uri
-  ) internal virtual returns (uint256) {
+  function _mint(address from, address to, uint256 tokenId, string memory uri)
+    internal
+    virtual
+    returns (uint256)
+  {
     require(!_exists(tokenId), "mint: tokenID exists");
     _balances[to] += 1;
     _owners[tokenId] = to;
diff --git a/assets/eip-4973/package.json b/assets/eip-4973/package.json
new file mode 100644
index 00000000000000..496d41afa50b0f
--- /dev/null
+++ b/assets/eip-4973/package.json
@@ -0,0 +1,45 @@
+{
+  "name": "erc4973",
+  "version": "0.4.0",
+  "description": "A standard interface for non-transferrable non-fungible tokens, also known as \"account-bound\" or \"soulbound tokens\" or \"badges\".",
+  "files": [
+    "/src/ERC4973.sol",
+    "/src/ERC165.sol",
+    "/src/interfaces/IERC165.sol",
+    "/src/interfaces/IERC4973.sol",
+    "/src/interfaces/IERC721Metadata.sol",
+    "/sdk/src/index.mjs"
+  ],
+  "scripts": {
+    "test": "forge test",
+    "test:sdk": "ava sdk/test",
+    "gen:flatfile": "forge flatten src/ERC4973.sol > ./assets/ERC4973-flat.sol",
+    "gen:sdk": "cp package.json assets/package.json && cp -r sdk/ assets/sdk",
+    "gen:assets": "npm run gen:flatfile && npm run gen:sdk"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rugpullindex/ERC4973.git"
+  },
+  "keywords": [
+    "account-bound",
+    "soulbound",
+    "tokens",
+    "ethereum",
+    "eip",
+    "badges",
+    "non-transferrable"
+  ],
+  "author": "Tim Daubenschütz <tim@daubenschuetz.de> (https://timdaub.github.io/)",
+  "license": "CC0-1.0",
+  "bugs": {
+    "url": "https://github.com/rugpullindex/ERC4973/issues"
+  },
+  "homepage": "https://github.com/rugpullindex/ERC4973#readme",
+  "dependencies": {
+    "ethers": "5.7.2"
+  },
+  "devDependencies": {
+    "ava": "4.3.1"
+  }
+}
diff --git a/assets/eip-4973/generateSignature.mjs b/assets/eip-4973/sdk/src/index.mjs
similarity index 50%
rename from assets/eip-4973/generateSignature.mjs
rename to assets/eip-4973/sdk/src/index.mjs
index b9a9f3eef8e64d..dc94ae324a214c 100644
--- a/assets/eip-4973/generateSignature.mjs
+++ b/assets/eip-4973/sdk/src/index.mjs
@@ -1,15 +1,9 @@
-// "ethers": "5.6.9"
 import { utils } from "ethers";
 
 // See: https://docs.ethers.io/v5/api/signer/#Signer-signTypedData for more
 // detailed instructions.
-export async function generateCompactSignature(
-  signer,
-  types,
-  domain,
-  agreement
-) {
+export async function generateSignature(signer, types, domain, agreement) {
   const signature = await signer._signTypedData(domain, types, agreement);
-  const { compact } = utils.splitSignature(signature);
-  return compact;
+  const { r, s, v } = utils.splitSignature(signature);
+  return utils.solidityPack(["bytes32", "bytes32", "uint8"], [r, s, v]);
 }
diff --git a/assets/eip-4973/generateSignature_test.mjs b/assets/eip-4973/sdk/test/index_test.mjs
similarity index 56%
rename from assets/eip-4973/generateSignature_test.mjs
rename to assets/eip-4973/sdk/test/index_test.mjs
index eb110676a125ac..2adf1fc7a12fc2 100644
--- a/assets/eip-4973/generateSignature_test.mjs
+++ b/assets/eip-4973/sdk/test/index_test.mjs
@@ -1,11 +1,9 @@
 // @format
-// "ava": "4.3.1"
 import test from "ava";
 
-// "ethers": "5.6.9"
-import { Wallet } from "ethers";
+import { Wallet, utils } from "ethers";
 
-import { generateCompactSignature } from "../src/index.mjs";
+import { generateSignature } from "../src/index.mjs";
 
 test("generating a compact signature for function give", async (t) => {
   // from: https://docs.ethers.io/v5/api/signer/#Wallet--methods
@@ -19,7 +17,7 @@ test("generating a compact signature for function give", async (t) => {
     Agreement: [
       { name: "active", type: "address" },
       { name: "passive", type: "address" },
-      { name: "tokenURI", type: "string" },
+      { name: "metadata", type: "bytes" },
     ],
   };
   const domain = {
@@ -32,19 +30,14 @@ test("generating a compact signature for function give", async (t) => {
   const agreement = {
     active: "0xb4c79dab8f259c7aee6e5b2aa729821864227e84",
     passive: passiveAddress,
-    tokenURI: "https://contenthash.com",
+    metadata: utils.toUtf8Bytes("https://example.com/metadata.json"),
   };
-  const compactSignature = await generateCompactSignature(
-    signer,
-    types,
-    domain,
-    agreement
-  );
-  t.truthy(compactSignature);
-  // For length of compact signature, see https://eips.ethereum.org/EIPS/eip-2098#backwards-compatibility
-  t.is(compactSignature.length, 64 * 2 + 2);
+
+  const signature = await generateSignature(signer, types, domain, agreement);
+  t.truthy(signature);
+  t.is(signature.length, 64 + 64 + 2 + 2);
   t.is(
-    compactSignature,
-    "0x238e1616c507f9779469b0276eef73a3a438b65706ca18c6ab38062c588674f9719c9f5412b0379e7918f19da1de71b9370ed9917fadcb6690e71f5a1de24816"
+    signature,
+    "0x4473afdec84287f10aa0b5eb608d360e2e9220bee657a4a5ca468e69a4de255c38691fca0c52f295d1831beaa0b7f079c1ab7959257578d2fb8d98740d9b0e111c"
   );
 });

From e6a2a4adea36283d847bcaca9c1aa672553af769 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20Daubensch=C3=BCtz?= <tim@daubenschuetz.de>
Date: Fri, 6 Jan 2023 10:33:24 -0500
Subject: [PATCH 122/274] Clarify document ownership (#6271)

---
 EIPS/eip-4973.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4973.md b/EIPS/eip-4973.md
index a16ced13212217..7a8f4e89cc1b9b 100644
--- a/EIPS/eip-4973.md
+++ b/EIPS/eip-4973.md
@@ -2,7 +2,7 @@
 eip: 4973
 title: Account-bound Tokens
 description: An interface for non-transferrable NFTs binding to an Ethereum account like a legendary World of Warcraft item binds to a character.
-author: Tim Daubenschütz (@TimDaub), Raphael Roullet (@ra-phael)
+author: Tim Daubenschütz (@TimDaub)
 discussions-to: https://ethereum-magicians.org/t/eip-4973-non-transferrable-non-fungible-tokens-soulbound-tokens-or-badges/8825
 status: Review
 type: Standards Track

From 6f89fdd006e00ac575546eb189ccb79d50e80f1c Mon Sep 17 00:00:00 2001
From: lightclient <14004106+lightclient@users.noreply.github.com>
Date: Fri, 6 Jan 2023 10:31:07 -0700
Subject: [PATCH 123/274] Update EIP-1459: unstagnate and add security
 consideration (#6265)

* 1459: unstagnate and add security consideration

* appease our overlord, master walidator
---
 EIPS/eip-1459.md | 26 +++++++++++++++-----------
 1 file changed, 15 insertions(+), 11 deletions(-)

diff --git a/EIPS/eip-1459.md b/EIPS/eip-1459.md
index 00416b0dc86487..b59df0eddbd370 100644
--- a/EIPS/eip-1459.md
+++ b/EIPS/eip-1459.md
@@ -3,12 +3,12 @@ eip: 1459
 title: Node Discovery via DNS
 description: Scheme for authenticated updateable Ethereum node lists via DNS.
 author: Felix Lange (@fjl), Péter Szilágyi (@karalabe)
+discussions-to: https://github.com/ethereum/devp2p/issues/50
+status: Draft
 type: Standards Track
 category: Networking
-status: Stagnant
 created: 2018-09-26
 requires: 778
-discussions-to: https://github.com/ethereum/devp2p/issues/50
 ---
 
 ## Abstract
@@ -90,15 +90,13 @@ packets. This limits the number of hashes that can be placed into an
 
 Example in zone file format:
 
-```text
-; name                        ttl     class type  content
-@                             60      IN    TXT   enrtree-root:v1 e=JWXYDBPXYWG6FX3GMDIBFA6CJ4 l=C7HRFPF3BLGF3YR4DY5KX3SMBE seq=1 sig=o908WmNp7LibOfPsr4btQwatZJ5URBr2ZAuxvK4UWHlsB9sUOTJQaGAlLPVAhM__XJesCHxLISo94z5Z2a463gA
-C7HRFPF3BLGF3YR4DY5KX3SMBE    86900   IN    TXT   enrtree://AM5FCQLWIZX2QFPNJAP7VUERCCRNGRHWZG3YYHIUV7BVDQ5FDPRT2@morenodes.example.org
-JWXYDBPXYWG6FX3GMDIBFA6CJ4    86900   IN    TXT   enrtree-branch:2XS2367YHAXJFGLZHVAWLQD4ZY,H4FHT4B454P6UXFD7JCYQ5PWDY,MHTDO6TMUBRIA2XWG5LUDACK24
-2XS2367YHAXJFGLZHVAWLQD4ZY    86900   IN    TXT   enr:-HW4QOFzoVLaFJnNhbgMoDXPnOvcdVuj7pDpqRvh6BRDO68aVi5ZcjB3vzQRZH2IcLBGHzo8uUN3snqmgTiE56CH3AMBgmlkgnY0iXNlY3AyNTZrMaECC2_24YYkYHEgdzxlSNKQEnHhuNAbNlMlWJxrJxbAFvA
-H4FHT4B454P6UXFD7JCYQ5PWDY    86900   IN    TXT   enr:-HW4QAggRauloj2SDLtIHN1XBkvhFZ1vtf1raYQp9TBW2RD5EEawDzbtSmlXUfnaHcvwOizhVYLtr7e6vw7NAf6mTuoCgmlkgnY0iXNlY3AyNTZrMaECjrXI8TLNXU0f8cthpAMxEshUyQlK-AM0PW2wfrnacNI
-MHTDO6TMUBRIA2XWG5LUDACK24    86900   IN    TXT   enr:-HW4QLAYqmrwllBEnzWWs7I5Ev2IAs7x_dZlbYdRdMUx5EyKHDXp7AV5CkuPGUPdvbv1_Ms1CPfhcGCvSElSosZmyoqAgmlkgnY0iXNlY3AyNTZrMaECriawHKWdDRk2xeZkrOXBQ0dfMFLHY4eENZwdufn1S1o
-```
+    ; name                        ttl     class type  content
+    @                             60      IN    TXT   enrtree-root:v1 e=JWXYDBPXYWG6FX3GMDIBFA6CJ4 l=C7HRFPF3BLGF3YR4DY5KX3SMBE seq=1 sig=o908WmNp7LibOfPsr4btQwatZJ5URBr2ZAuxvK4UWHlsB9sUOTJQaGAlLPVAhM__XJesCHxLISo94z5Z2a463gA
+    C7HRFPF3BLGF3YR4DY5KX3SMBE    86900   IN    TXT   enrtree://AM5FCQLWIZX2QFPNJAP7VUERCCRNGRHWZG3YYHIUV7BVDQ5FDPRT2@morenodes.example.org
+    JWXYDBPXYWG6FX3GMDIBFA6CJ4    86900   IN    TXT   enrtree-branch:2XS2367YHAXJFGLZHVAWLQD4ZY,H4FHT4B454P6UXFD7JCYQ5PWDY,MHTDO6TMUBRIA2XWG5LUDACK24
+    2XS2367YHAXJFGLZHVAWLQD4ZY    86900   IN    TXT   enr:-HW4QOFzoVLaFJnNhbgMoDXPnOvcdVuj7pDpqRvh6BRDO68aVi5ZcjB3vzQRZH2IcLBGHzo8uUN3snqmgTiE56CH3AMBgmlkgnY0iXNlY3AyNTZrMaECC2_24YYkYHEgdzxlSNKQEnHhuNAbNlMlWJxrJxbAFvA
+    H4FHT4B454P6UXFD7JCYQ5PWDY    86900   IN    TXT   enr:-HW4QAggRauloj2SDLtIHN1XBkvhFZ1vtf1raYQp9TBW2RD5EEawDzbtSmlXUfnaHcvwOizhVYLtr7e6vw7NAf6mTuoCgmlkgnY0iXNlY3AyNTZrMaECjrXI8TLNXU0f8cthpAMxEshUyQlK-AM0PW2wfrnacNI
+    MHTDO6TMUBRIA2XWG5LUDACK24    86900   IN    TXT   enr:-HW4QLAYqmrwllBEnzWWs7I5Ev2IAs7x_dZlbYdRdMUx5EyKHDXp7AV5CkuPGUPdvbv1_Ms1CPfhcGCvSElSosZmyoqAgmlkgnY0iXNlY3AyNTZrMaECriawHKWdDRk2xeZkrOXBQ0dfMFLHY4eENZwdufn1S1o
 
 ### Client Protocol
 
@@ -163,6 +161,12 @@ enable client implementations to sync these trees independently. A client
 wanting to get as many nodes as possible will sync the link tree first and add
 all linked names to the sync horizon.
 
+## Security Considerations
+
+Discovery via DNS is less secure than via DHT, because it relies on a trusted
+party to publish the records regularly. The actor could easily eclipse
+bootstrapping nodes by only publishing node records that it controls.
+
 ## Copyright
 
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 3f3f99e447a5a1c6cb8678fd5dad2c85a9dd94bd Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 12:31:34 -0500
Subject: [PATCH 124/274] CI: Only run label bot on PRs to master (#6255)

---
 .github/workflows/auto-label-bot.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/auto-label-bot.yml b/.github/workflows/auto-label-bot.yml
index d4edd8fdb50bb5..aded93281f751b 100644
--- a/.github/workflows/auto-label-bot.yml
+++ b/.github/workflows/auto-label-bot.yml
@@ -1,5 +1,7 @@
 on:
   pull_request_target:
+    branches:
+      - master
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}

From e3c784a40563893c7d9eb573aeb4a9bd6182b738 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 12:33:04 -0500
Subject: [PATCH 125/274] Update EIP-3267: Fix SPDX license identifier (#5227)

* Make EIP-3267 assets CC0

* I guess I'll fix a typo to allow EIP bot to merge this with approval
---
 EIPS/eip-3267.md                                            | 2 +-
 assets/eip-3267/contracts/BaseBidOnAddresses.sol            | 2 +-
 assets/eip-3267/contracts/BaseLock.sol                      | 2 +-
 assets/eip-3267/contracts/BaseRestorableSalary.sol          | 2 +-
 assets/eip-3267/contracts/BaseSalary.sol                    | 2 +-
 assets/eip-3267/contracts/BidOnAddresses.sol                | 2 +-
 assets/eip-3267/contracts/DAOInterface.sol                  | 2 +-
 assets/eip-3267/contracts/DefaultDAOInterface.sol           | 2 +-
 assets/eip-3267/contracts/ERC1155/ERC1155.sol               | 2 +-
 assets/eip-3267/contracts/ERC1155/ERC1155TokenReceiver.sol  | 2 +-
 assets/eip-3267/contracts/ERC1155/ERC1155WithTotals.sol     | 2 +-
 assets/eip-3267/contracts/ERC1155/IERC1155.sol              | 2 +-
 assets/eip-3267/contracts/ERC1155/IERC1155TokenReceiver.sol | 2 +-
 assets/eip-3267/contracts/Salary.sol                        | 2 +-
 assets/eip-3267/contracts/SalaryWithDAO.sol                 | 2 +-
 15 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/EIPS/eip-3267.md b/EIPS/eip-3267.md
index 8363e0719ac84f..c44fe3e481a54a 100644
--- a/EIPS/eip-3267.md
+++ b/EIPS/eip-3267.md
@@ -37,7 +37,7 @@ Paradoxically, it will directly benefit miners/validators, see the discussion.
 
 `MineFraction` = `TBD` (0..1)
 
-[The contracts source](../assets/eip-3267/contracts/README.md)
+[The contract's source](../assets/eip-3267/contracts/README.md)
 
 Prior to `FORK_BLOCK_NUMBER`, `SalaryWithDAO` and `DefaultDAOInterface` contracts will be deployed to the network and exist at the above specified addresses.
 
diff --git a/assets/eip-3267/contracts/BaseBidOnAddresses.sol b/assets/eip-3267/contracts/BaseBidOnAddresses.sol
index f39deebf7c8567..ca693462ab989e 100644
--- a/assets/eip-3267/contracts/BaseBidOnAddresses.sol
+++ b/assets/eip-3267/contracts/BaseBidOnAddresses.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 import { SafeMath } from "@openzeppelin/contracts/math/SafeMath.sol";
 import { ABDKMath64x64 } from "abdk-libraries-solidity/ABDKMath64x64.sol";
diff --git a/assets/eip-3267/contracts/BaseLock.sol b/assets/eip-3267/contracts/BaseLock.sol
index ca661791fab447..7e45627d436743 100644
--- a/assets/eip-3267/contracts/BaseLock.sol
+++ b/assets/eip-3267/contracts/BaseLock.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 import { SafeMath } from "@openzeppelin/contracts/math/SafeMath.sol";
 import { ABDKMath64x64 } from "abdk-libraries-solidity/ABDKMath64x64.sol";
diff --git a/assets/eip-3267/contracts/BaseRestorableSalary.sol b/assets/eip-3267/contracts/BaseRestorableSalary.sol
index 2916b6c8705740..d7eac2da5cc0ea 100644
--- a/assets/eip-3267/contracts/BaseRestorableSalary.sol
+++ b/assets/eip-3267/contracts/BaseRestorableSalary.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 import "./Salary.sol";
 
diff --git a/assets/eip-3267/contracts/BaseSalary.sol b/assets/eip-3267/contracts/BaseSalary.sol
index 276b97369f2de3..a695f5353baee6 100644
--- a/assets/eip-3267/contracts/BaseSalary.sol
+++ b/assets/eip-3267/contracts/BaseSalary.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 import "./BaseBidOnAddresses.sol";
 
diff --git a/assets/eip-3267/contracts/BidOnAddresses.sol b/assets/eip-3267/contracts/BidOnAddresses.sol
index baeb637c45cb09..ec41e778029dba 100644
--- a/assets/eip-3267/contracts/BidOnAddresses.sol
+++ b/assets/eip-3267/contracts/BidOnAddresses.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 import "./BaseBidOnAddresses.sol";
 
diff --git a/assets/eip-3267/contracts/DAOInterface.sol b/assets/eip-3267/contracts/DAOInterface.sol
index 86417857ced575..c2f15efa833da0 100644
--- a/assets/eip-3267/contracts/DAOInterface.sol
+++ b/assets/eip-3267/contracts/DAOInterface.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 
 /// @notice The "DAO plugin" interface.
diff --git a/assets/eip-3267/contracts/DefaultDAOInterface.sol b/assets/eip-3267/contracts/DefaultDAOInterface.sol
index 79cf6838de89b8..15514550e45f53 100644
--- a/assets/eip-3267/contracts/DefaultDAOInterface.sol
+++ b/assets/eip-3267/contracts/DefaultDAOInterface.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 import "./DAOInterface.sol";
 
diff --git a/assets/eip-3267/contracts/ERC1155/ERC1155.sol b/assets/eip-3267/contracts/ERC1155/ERC1155.sol
index de4637f9b78fa1..d7f2af5b9a6ed1 100644
--- a/assets/eip-3267/contracts/ERC1155/ERC1155.sol
+++ b/assets/eip-3267/contracts/ERC1155/ERC1155.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: MIT
+// SPDX-License-Identifier: CC0-1.0
 
 pragma solidity >=0.6.0 <0.8.0;
 
diff --git a/assets/eip-3267/contracts/ERC1155/ERC1155TokenReceiver.sol b/assets/eip-3267/contracts/ERC1155/ERC1155TokenReceiver.sol
index 7e888ba6599b6d..9832abca30cb2d 100644
--- a/assets/eip-3267/contracts/ERC1155/ERC1155TokenReceiver.sol
+++ b/assets/eip-3267/contracts/ERC1155/ERC1155TokenReceiver.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 
 import "./IERC1155TokenReceiver.sol";
diff --git a/assets/eip-3267/contracts/ERC1155/ERC1155WithTotals.sol b/assets/eip-3267/contracts/ERC1155/ERC1155WithTotals.sol
index 95bf2285ced6a5..407356f7c6c33d 100644
--- a/assets/eip-3267/contracts/ERC1155/ERC1155WithTotals.sol
+++ b/assets/eip-3267/contracts/ERC1155/ERC1155WithTotals.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 import "@openzeppelin/contracts/math/SafeMath.sol";
 import { ERC1155 } from "./ERC1155.sol";
diff --git a/assets/eip-3267/contracts/ERC1155/IERC1155.sol b/assets/eip-3267/contracts/ERC1155/IERC1155.sol
index 2ecf0f1821e23d..e763657c8e14d1 100644
--- a/assets/eip-3267/contracts/ERC1155/IERC1155.sol
+++ b/assets/eip-3267/contracts/ERC1155/IERC1155.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 
 import "@openzeppelin/contracts/introspection/IERC165.sol";
diff --git a/assets/eip-3267/contracts/ERC1155/IERC1155TokenReceiver.sol b/assets/eip-3267/contracts/ERC1155/IERC1155TokenReceiver.sol
index f737f41c7104a6..044260ad747cd5 100644
--- a/assets/eip-3267/contracts/ERC1155/IERC1155TokenReceiver.sol
+++ b/assets/eip-3267/contracts/ERC1155/IERC1155TokenReceiver.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 
 import "@openzeppelin/contracts/introspection/IERC165.sol";
diff --git a/assets/eip-3267/contracts/Salary.sol b/assets/eip-3267/contracts/Salary.sol
index 5cbc23d57d4389..83d48086d50a61 100644
--- a/assets/eip-3267/contracts/Salary.sol
+++ b/assets/eip-3267/contracts/Salary.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 import "./BaseSalary.sol";
 
diff --git a/assets/eip-3267/contracts/SalaryWithDAO.sol b/assets/eip-3267/contracts/SalaryWithDAO.sol
index 6b6fc23172669c..cbe21106d9ff41 100644
--- a/assets/eip-3267/contracts/SalaryWithDAO.sol
+++ b/assets/eip-3267/contracts/SalaryWithDAO.sol
@@ -1,4 +1,4 @@
-// SPDX-License-Identifier: LGPL-3.0-or-later
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.7.1;
 import { ABDKMath64x64 } from "abdk-libraries-solidity/ABDKMath64x64.sol";
 import "./BaseRestorableSalary.sol";

From 56c518715225e914c2e8d5a88ed2c1825ba2c72d Mon Sep 17 00:00:00 2001
From: Hadrien Croubois <hadrien.croubois@gmail.com>
Date: Fri, 6 Jan 2023 19:43:35 +0100
Subject: [PATCH 126/274] Add EIP-5805: Voting with delegation (#5805)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* initial draft

* add eip number

* rename focument

* add discussion

* fix EIP Walidator checks

* Apply suggestions from code review

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* fix typo

* rename now → clock

* fix markdown linter

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-5805.md | 406 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 406 insertions(+)
 create mode 100644 EIPS/eip-5805.md

diff --git a/EIPS/eip-5805.md b/EIPS/eip-5805.md
new file mode 100644
index 00000000000000..657216340d39d7
--- /dev/null
+++ b/EIPS/eip-5805.md
@@ -0,0 +1,406 @@
+---
+eip: 5805
+title: Voting with delegation
+description: An interface for voting weight tracking, with delegation support
+author: Hadrien Croubois (@Amxx)
+discussions-to: https://ethereum-magicians.org/t/eip-5805-voting-with-delegation/11407
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-07-04
+requires: 712
+---
+
+## Abstract
+
+Many DAOs (decentralized autonomous organizations) rely on tokens to represent one's voting power. In order to perform this task effectively, the token contracts need to include specific mechanisms such as checkpoints and delegation. The existing implementations are not standardized. This EIP proposes to standardize the way votes are delegated from one account to another, and the way current and past votes are tracked and queried. The corresponding behavior is compatible with many token types, including but not limited to [EIP-20](./eip-20.md) and [EIP-721](./eip-721.md). This EIP also considers the diversity of time tracking functions, allowing the voting tokens (and any contract associated with it) to track the votes based on `block.number`, `block.timestamp`, or any other non-decreasing function.
+
+## Motivation
+
+Beyond simple monetary transactions, decentralized autonomous organizations are arguably one of the most important use cases of blockchain and smart contract technologies. Today, many communities are organized around a governance contract that allows users to vote. Among these communities, some represent voting power using transferable tokens ([EIP-20](./eip-20.md), [EIP-721](./eip-721.md), other). In this context, the more tokens one owns, the more voting power one has. Governor contracts, such as Compound's `GovernorBravo`, read from these "voting token" contracts to get the voting power of the users.
+
+Unfortunately, simply using the `balanceOf(address)` function present in most token standards is not good enough:
+
+- The values are not checkpointed, so a user can vote, transfer its tokens to a new account, and vote again with the same tokens.
+- A user cannot delegate their voting power to someone else without transferring full ownership of the tokens.
+
+These constraints have led to the emergence of voting tokens with delegation that the following logic:
+
+- Users can delegate the voting power of their tokens to themselves or a third party. This creates a distinction between balance and voting weight.
+- The voting weights of accounts are checkpointed, allowing lookups for past values at different points in time.
+- The balances are not checkpointed.
+
+This EIP is proposing to standardize the interface and behavior of these voting tokens.
+
+Additionally, the existing (non-standardized) implementations are limited to `block.number` based checkpoints. This choice causes many issues in a multichain environment, where some chains (particularly L2s) have an inconsistent or unpredictable time between blocks. This EIP also addresses this issue by allowing the voting token to use any time tracking function it wants, and exposing it so that other contracts (such as a Governor) can stay consistent with the token checkpoints.
+
+## Specification
+
+Following pre-existing (but not-standardized) implementation, the EIP proposes the following mechanism.
+
+Each user account (address) can delegate to an account of its choice. This can be itself, someone else, or no one (represented by `address(0)`). Assets held by the user cannot express their voting power unless they are delegated.
+
+When a "delegator" delegates its tokens voting power to a "delegatee", its balance is added to the voting power of the delegatee. If the delegator changes its delegation, the voting power is subtracted from the old delegatee's voting power and added to the new delegate's voting power. The voting power of each account is tracked through time so that it is possible to query its value in the past. With tokens being delegated to at most one delegate at a given point in time, double voting is prevented.
+
+Whenever tokens are transferred from one account to another, the associated voting power should be deducted from the sender's delegate and added to the receiver's delegate.
+
+Tokens that are delegated to `address(0)` should not be tracked. This allows users to optimize the gas cost of their token transfers by skipping the checkpoint update for their delegate.
+
+To accommodate different types of chains, we want the voting checkpoint system to support different forms of time tracking. On the Ethereum mainnet, using block numbers provides backward compatibility with applications that historically use it. On the other hand, using timestamps provides better semantics for end users, and accommodates use cases where the duration is expressed in seconds. Other monotonic functions could also be deemed relevant by developers based on the characteristics of future applications and blockchains.
+
+Both timestamps, block numbers, and other possible modes use the same external interfaces. This allows transparent binding of third-party contracts, such as governor systems, to the vote tracking built into the voting contracts. For this to be effective, the voting contracts must, in addition to all the vote-tracking functions, expose the current value used for time-tracking.
+
+### Methods
+
+#### clock
+
+This function returns the current timepoint. It could be `block.timestamp`, `block.number` (or any other **non-decreasing** function) depending on the mode the contract is operating on.
+
+- If operating using **block number**, then this function SHOULD be implemented.
+- If operating using **timestamp**, then this function MUST be implemented.
+- If operating using any other mode, then this function MUST be implemented.
+
+This function is thus optional, and its absence should be considered as a marker of the contract operating using block number. (This makes this EIP compatible with pre-existing voting contracts)
+
+```yaml
+- name: clock
+  type: function
+  stateMutability: view
+  inputs: []
+  outputs:
+    - name: timepoint
+      type: uint256
+```
+
+#### getVotes
+
+This function returns the current voting weight of an account. This corresponds to all the voting power delegated to it at the moment this function is called.
+
+As tokens delegated to `address(0)` should not be counted/snapshoted, `getVotes(0)` SHOULD always return `0`.
+
+This function MUST be implemented
+
+```yaml
+- name: getVotes
+  type: function
+  stateMutability: view
+  inputs:
+    - name: account
+      type: address
+  outputs:
+    - name: votingWeight
+      type: uint256
+```
+
+#### getPastVotes
+
+This function returns the historical voting weight of an account. This corresponds to all the voting power delegated to it at a specific timepoint. The timepoint parameter should match the operating mode of the contract. This function SHOULD only serve past checkpoints that are immutable. Calling this function with a timepoint that is greater or equal to `clock()` SHOULD revert. For any timepoint that is strictly smaller than `clock()`, the value returned by `getPastVotes` should be constant.
+
+As tokens delegated to `address(0)` should not be counted/snapshoted, `getPastVotes(0,x)` SHOULD always return `0` (for all values of `x`).
+
+This function MUST be implemented
+
+```yaml
+- name: getPastVotes
+  type: function
+  stateMutability: view
+  inputs:
+    - name: account
+      type: address
+    - name: timepoint
+      type: uint256
+  outputs:
+    - name: votingWeight
+      type: uint256
+```
+
+#### delegates
+
+This function returns the address to which the voting power of an account is currently delegated.
+
+Note that if the delegate is `address(0)` then the voting power SHOULD NOT be checkpointed, and it should not be possible to vote with it.
+
+This function MUST be implemented
+
+```yaml
+- name: delegates
+  type: function
+  stateMutability: view
+  inputs:
+    - name: account
+      type: address
+  outputs:
+    - name: delegatee
+      type: address
+```
+
+#### delegate
+
+This function changes the caller's delegate, updating the vote delegation in the meantime.
+
+This function MUST be implemented
+
+```yaml
+- name: delegate
+  type: function
+  stateMutability: nonpayable
+  inputs:
+    - name: delegatee
+      type: address
+  outputs: []
+```
+
+#### delegateBySig
+
+This function changes an account's delegate using a signature, updating the vote delegation in the meantime.
+
+This function MUST be implemented
+
+```yaml
+- name: delegateBySig
+  type: function
+  stateMutability: nonpayable
+  inputs:
+    - name: delegatee
+      type: address
+    - name: nonce
+      type: uint256
+    - name: expiry
+      type: uint256
+    - name: v
+      type: uint8
+    - name: r
+      type: bytes32
+    - name: s
+      type: bytes32
+  outputs: []
+```
+
+This signature should follow the [EIP-712](./eip-712.md) format:
+
+A call to `delegateBySig(delegatee, nonce, expiry, v, r, s)` changes the signer's delegate to `delegatee`, increment the signer's nonce by 1, and emits a corresponding `DelegateChanged` event, and possibly `DelegateVotesChanged` events for the old and the new delegate accounts, if and only if the following conditions are met:
+
+
+- The current timestamp is less than or equal to `expiry`.
+- `nonces(signer)` (before the state update) is equal to `nonce`.
+
+If any of these conditions are not met, the `delegateBySig` call must revert. This translate to the following solidity code:
+
+```sol
+require(expiry <= block.timestamp)
+bytes signer = ecrecover(
+  keccak256(abi.encodePacked(
+    hex"1901",
+    DOMAIN_SEPARATOR,
+    keccak256(abi.encode(
+      keccak256("Delegation(address delegatee,uint256 nonce,uint256 expiry)"),
+      delegatee,
+      nonce,
+      expiry)),
+  v, r, s)
+require(signer != address(0));
+require(nounces[signer] == nonce);
+// increment nonce
+// set delegation of `signer` to `delegatee`
+```
+
+where `DOMAIN_SEPARATOR` is defined according to [EIP-712](./eip-712.md). The `DOMAIN_SEPARATOR` should be unique to the contract and chain to prevent replay attacks from other domains,
+and satisfy the requirements of EIP-712, but is otherwise unconstrained.
+
+A common choice for `DOMAIN_SEPARATOR` is:
+
+```solidity
+DOMAIN_SEPARATOR = keccak256(
+    abi.encode(
+        keccak256('EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)'),
+        keccak256(bytes(name)),
+        keccak256(bytes(version)),
+        chainid,
+        address(this)
+));
+```
+
+In other words, the message is the EIP-712 typed structure:
+
+```js
+{
+  "types": {
+    "EIP712Domain": [
+      {
+        "name": "name",
+        "type": "string"
+      },
+      {
+        "name": "version",
+        "type": "string"
+      },
+      {
+        "name": "chainId",
+        "type": "uint256"
+      },
+      {
+        "name": "verifyingContract",
+        "type": "address"
+      }
+    ],
+    "Delegation": [{
+      "name": "delegatee",
+      "type": "address"
+      },
+      {
+        "name": "nonce",
+        "type": "uint256"
+      },
+      {
+        "name": "expiry",
+        "type": "uint256"
+      }
+    ],
+    "primaryType": "Permit",
+    "domain": {
+      "name": contractName,
+      "version": version,
+      "chainId": chainid,
+      "verifyingContract": contractAddress
+  },
+  "message": {
+    "delegatee": delegatee,
+    "nonce": nonce,
+    "expiry": expiry
+  }
+}}
+```
+
+Note that nowhere in this definition do we refer to `msg.sender`. The caller of the `delegateBySig` function can be any address.
+
+When this function is successfully executed, the delegator's nonce MUST be incremented to prevent replay attacks.
+
+#### nonces
+
+This function returns the current nonce for a given account.
+
+Signed delegations (see `delegateBySig`) are only accepted if the nonce used in the EIP-712 signature matches the return of this function. This value of `nonce(delegator)` should be incremented whenever a call to `delegateBySig` is performed on behalf of `delegator`.
+
+This function MUST be implemented
+
+```yaml
+- name: nonces
+  type: function
+  stateMutability: view
+  inputs:
+    - name: account
+      type: delegator
+  outputs:
+    - name: nonce
+      type: uint256
+```
+
+### Events
+
+#### DelegateChanged
+
+`delegator` changes the delegation of its assets from `fromDelegate` to `toDelegate`.
+
+MUST be emitted when the delegate for an account is modified by `delegate(address)` or `delegateBySig(address,uint256,uint256,uint8,bytes32,bytes32)`.
+
+```yaml
+- name: DelegateChanged
+  type: event
+  inputs:
+    - name: delegator
+      indexed: true
+      type: address
+    - name: fromDelegate
+      indexed: true
+      type: address
+    - name: toDelegate
+      indexed: true
+      type: address
+```
+
+#### DelegateVotesChanged
+
+`delegate` available voting power changes from `previousBalance` to `newBalance`.
+
+This MUST be emitted when:
+
+- an account (that holds more than 0 assets) updates its delegation from or to `delegate`,
+- an asset transfer from or to an account that is delegated to `delegate`.
+
+```yaml
+- name: DelegateVotesChanged
+  type: event
+  inputs:
+    - name: delegate
+      indexed: true
+      type: address
+    - name: previousBalance
+      indexed: false
+      type: uint256
+    - name: newBalance
+      indexed: false
+      type: uint256
+```
+
+### Solidity interface
+
+```sol
+interface IERC_XXXX {
+  event DelegateChanged(address indexed delegator, address indexed fromDelegate, address indexed toDelegate);
+  event DelegateVotesChanged(address indexed delegate, uint256 previousBalance, uint256 newBalance);
+
+  function clock() external view returns (uint256);
+  function getVotes(address account) external view returns (uint256);
+  function getPastVotes(address account, uint256 timepoint) external view returns (uint256);
+  function delegates(address account) external view returns (address);
+  function nonces(address owner) public view virtual returns (uint256)
+
+  function delegate(address delegatee) external;
+  function delegateBySig(address delegatee, uint256 nonce, uint256 expiry, uint8 v, bytes32 r, bytes32 s) external;
+}
+```
+
+### Expected properties
+
+- The `clock()` function MUST be non-decreasing.
+- For all timepoints `t < clock()`, `getVotes(address(0))` and `getPastVotes(address(0), t)` SHOULD return 0.
+- For all accounts `a != 0`, `getVotes(a)` SHOULD be the sum of the "balances" of all the accounts that delegate to `a`.
+- For all accounts `a != 0` and all timestamp `t < clock()`, `getPastVotes(a, t)` SHOULD be the sum of the "balances" of all the accounts that delegated to `a` when `clock()` overtook `t`.
+- For all accounts `a`, `getPastVotes(a, t)` MUST be constant after `t < clock()` is reached.
+- For all accounts `a`, the action of changing the delegate from `b` to `c` MUST not increase the current voting power of `b` (`getVotes(b)`) and MUST not decrease the current voting power of `c` (`getVotes(c)`).
+
+## Rationale
+
+Delegation allows token holders to trust a delegate with their vote while keeping full custody of their token. This means that only a small-ish number of delegates need to pay gas for voting. This leads to better representation of small token holders by allowing their votes to be cast without requiring them to pay expensive gas fees. Users can take over their voting power at any point, and delegate it to someone else, or to themselves.
+
+The use of checkpoints prevents double voting. Votes, for example in the context of a governance proposal, should rely on a snapshot defined by a timepoint. Only tokens delegated at that timepoint can be used for voting. This means any token transfer performed after the snapshot will not affect the voting power of the sender/receiver's delegate. This also means that in order to vote, someone must acquire tokens and delegate them before the snapshot is taken. Governors can, and do, include a delay between the proposal is submitted and the snapshot is taken so that users can take the necessary actions (change their delegation, buy more tokens, ...).
+
+`delegateBySig` is necessary to offer a gasless workflow to token holders that do not want to pay gas for voting.
+
+The `nonces` mapping is given for replay protection.
+
+EIP-712 typed messages are included because of its widespread adoption in many wallet providers.
+
+## Backwards Compatibility
+
+Compound and OpenZeppelin already provide implementations of voting tokens. The delegation-related methods are shared between the two implementations and this EIP. For the vote lookup, this EIP uses OpenZeppelin's implementation (with return type uint256) as Compound's implementation causes significant restrictions of the acceptable values (return type is uint96).
+
+Both implementations use `block.number` for their checkpoints and do not implement the `clock()` method, which is compatible with this EIP.
+
+Existing governors, that are currently compatible with OpenZeppelin's implementation will be compatible with the "block number mode" of this EIP.
+
+## Security Considerations
+
+Before doing a lookup, one should check the return value of `clock()` and make sure that the parameters of the lookup are consistent. Performing a lookup using a timestamp argument on a contract that uses block numbers will very likely cause a revert. On the other end, performing a lookup using a block number argument on a contract that uses timestamps will likely return 0.
+
+Though the signer of a `Delegation` may have a certain party in mind to submit their transaction, another party can always front-run this transaction and call `delegateBySig` before the intended party. The result is the same for the `Delegation` signer, however.
+
+Since the ecrecover precompile fails silently and just returns the zero address as `signer` when given malformed messages, it is important to ensure `signer != address(0)` to avoid `delegateBySig` from delegating "zombie funds" belonging to the zero address.
+
+Signed `Delegation` messages are censorable. The relaying party can always choose to not submit the `Delegation` after having received it, withholding the option to submit it. The `expiry` parameter is one mitigation to this. If the signing party holds ETH they can also just submit the `Delegation` themselves, which can render previously signed `Delegation`s invalid.
+
+If the `DOMAIN_SEPARATOR` contains the `chainId` and is defined at contract deployment instead of reconstructed for every signature, there is a risk of possible replay attacks between chains in the event of a future chain split.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From e21db665baa287b0b6e67baf9d4f593725f96d99 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 14:06:31 -0500
Subject: [PATCH 127/274] Update EIP-2771: Fix markdownlint issues (#6274)

---
 EIPS/eip-2771.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/EIPS/eip-2771.md b/EIPS/eip-2771.md
index 117c47304a25e2..efcd7e61fa2c2a 100644
--- a/EIPS/eip-2771.md
+++ b/EIPS/eip-2771.md
@@ -95,6 +95,7 @@ Internally, the **Recipient** MUST then accept a request from forwarder.
   to support multiple forwarders with no change to code.
 * `msg.sender` is a transaction parameter that can be inspected by a contract to determine who signed the transaction. The integrity of this parameter is guaranteed by the Ethereum EVM, but for a meta transaction securing `msg.sender` is insufficient.
   * The problem is that for a contract that is not natively aware of meta transactions, the `msg.sender` of the transaction will make it appear to be coming from the **Gas Relay** and not the **Transaction Signer**. A secure protocol for a contract to accept meta transactions needs to prevent the **Gas Relay** from forging, modifying or duplicating requests by the **Transaction Signer**.
+
 ## Reference Implementation
 
 ### Recipient Example 

From da1957f1b04001cc11a94d3c0c6bd8f5ce168e4d Mon Sep 17 00:00:00 2001
From: Suriyaa Sundararuban <github@suriyaa.tk>
Date: Fri, 6 Jan 2023 20:35:23 +0100
Subject: [PATCH 128/274] Update GitHub docs link (#6213)

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f4135b539e6eee..dbf8c9d68528c5 100644
--- a/README.md
+++ b/README.md
@@ -78,4 +78,4 @@ eipv <INPUT FILE / DIRECTORY>
 
 2. Preview your local Jekyll site in your web browser at <http://localhost:4000>.
 
-More information on Jekyll and GitHub Pages [here](https://help.github.com/en/enterprise/2.14/user/articles/setting-up-your-github-pages-site-locally-with-jekyll).
+More information on Jekyll and GitHub Pages [here](https://docs.github.com/en/enterprise/2.14/user/articles/setting-up-your-github-pages-site-locally-with-jekyll).

From 96e1162f422b6da79f7af9b9a63b95e4f08d4a61 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 14:38:42 -0500
Subject: [PATCH 129/274] Update CI: Fix EIP bot sometimes not triggering
 (#6275)

---
 .github/workflows/auto-review-bot.yml | 4 ----
 1 file changed, 4 deletions(-)

diff --git a/.github/workflows/auto-review-bot.yml b/.github/workflows/auto-review-bot.yml
index e0dd983eea6f07..696694c700aa17 100644
--- a/.github/workflows/auto-review-bot.yml
+++ b/.github/workflows/auto-review-bot.yml
@@ -5,10 +5,6 @@ on:
     types:
       - completed
 
-concurrency:
-  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
-  cancel-in-progress: true
-
 name: Auto Review Bot
 jobs:
   auto-review-bot:

From e50c6873f9d7c25865a57882f38eab38dcde9564 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 14:40:08 -0500
Subject: [PATCH 130/274] Update CI: Fix automatic messaging and labeling
 (#6276)

There were a few typos/other errors
---
 .github/workflows/post-ci.yml | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/post-ci.yml b/.github/workflows/post-ci.yml
index 1198d47c66d2b7..b6243f0292ca57 100644
--- a/.github/workflows/post-ci.yml
+++ b/.github/workflows/post-ci.yml
@@ -31,6 +31,7 @@ jobs:
         uses: marocchino/sticky-pull-request-comment@39c5b5dc7717447d0cba270cd115037d32d28443
         if: ${{ github.event.workflow_run.conclusion == 'failure' }}
         with:
+          number: ${{ steps.save-pr-data.outputs.pr_number }}
           recreate: true
           message: |
             The commit ${{ steps.save-pr-data.outputs.pr_sha }} (as a parent of ${{ steps.save-pr-data.outputs.merge_sha }}) contains errors.
@@ -41,8 +42,9 @@ jobs:
         if: ${{ github.event.workflow_run.conclusion == 'failure' }}
         with:
           labels: w-ci
-          number: ${{ steps.save-pr-data.outputs.pr_number }}'
+          number: ${{ steps.save-pr-data.outputs.pr_number }}
           repo: ${{ github.repository }}
+          github_token: ${{ github.token }}
 
       - name: Remove Waiting Label
         uses: actions-ecosystem/action-remove-labels@2ce5d41b4b6aa8503e285553f75ed56e0a40bae0
@@ -51,3 +53,4 @@ jobs:
           labels: w-ci
           number: ${{ steps.save-pr-data.outputs.pr_number }}
           repo: ${{ github.repository }}
+          github_token: ${{ github.token }}

From d8e492c69309d532234b78da23b817055dceceb3 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 15:12:42 -0500
Subject: [PATCH 131/274] Update EIP-2771: Move to Last Call (#6264)

---
 EIPS/eip-2771.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-2771.md b/EIPS/eip-2771.md
index efcd7e61fa2c2a..75f3f2fbfd6151 100644
--- a/EIPS/eip-2771.md
+++ b/EIPS/eip-2771.md
@@ -4,7 +4,8 @@ title: Secure Protocol for Native Meta Transactions
 description: A contract interface for receiving meta transactions through a trusted forwarder
 author: Ronan Sandford (@wighawag), Liraz Siri (@lirazsiri), Dror Tirosh (@drortirosh), Yoav Weiss (@yoavw), Alex Forshtat (@forshtat), Hadrien Croubois (@Amxx), Sachin Tomar (@tomarsachin2271), Patrick McCorry (@stonecoldpat), Nicolas Venturo (@nventuro), Fabian Vogelsteller (@frozeman), Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/erc-2771-secure-protocol-for-native-meta-transactions/4488
-status: Review
+status: Last Call
+last-call-deadline: 2023-01-20
 type: Standards Track
 category: ERC
 created: 2020-07-01

From cc3c7677d8fd33c4b95e6ab8620ca0333da88ac1 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 15:28:07 -0500
Subject: [PATCH 132/274] Update EIP-2771: Fix typo (#6281)

---
 EIPS/eip-2771.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-2771.md b/EIPS/eip-2771.md
index 75f3f2fbfd6151..1c008c157547bd 100644
--- a/EIPS/eip-2771.md
+++ b/EIPS/eip-2771.md
@@ -75,7 +75,7 @@ function isTrustedForwarder(address forwarder) external view returns(bool);
 
 Internally, the **Recipient** MUST then accept a request from forwarder.
 
-`isTrustedForwarder` function MAY be called on-chain, and as such gas restrictions MUST be put in place. A Gas limit of 50k SHOULD be sufficient to making the decision either inside the contract, or delegating it to another contract and doing some memory access calculations, like querying a mapping.
+`isTrustedForwarder` function MAY be called on-chain, and as such gas restrictions MUST be put in place. A gas limit of 50k SHOULD be sufficient to making the decision either inside the contract, or delegating it to another contract and doing some memory access calculations, like querying a mapping.
 
 ## Rationale
 

From 23c08bfb8cbf4855e402d35de75c7d9f951f8703 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 15:46:58 -0500
Subject: [PATCH 133/274] Update EIP-5507: Fix file names (#6282)

---
 EIPS/eip-5507.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/EIPS/eip-5507.md b/EIPS/eip-5507.md
index 6d6c987de77290..e329cde7ff7317 100644
--- a/EIPS/eip-5507.md
+++ b/EIPS/eip-5507.md
@@ -30,8 +30,8 @@ The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL
 
 pragma solidity ^0.8.17;
 
-import "IERC20.sol";
-import "IERC165.sol";
+import "ERC20.sol";
+import "ERC165.sol";
 
 /// @notice Refundable EIP-20 tokens
 /// @dev    The EIP-165 identifier of this interface is `0xf0ca2917`
@@ -67,8 +67,8 @@ interface ERC20Refund is ERC20, ERC165 {
 
 pragma solidity ^0.8.17;
 
-import "IERC721.sol";
-import "IERC165.sol";
+import "ERC721.sol";
+import "ERC165.sol";
 
 /// @notice Refundable EIP-721 tokens
 /// @dev    The EIP-165 identifier of this interface is `0xe97f3c83`
@@ -106,8 +106,8 @@ interface ERC721Refund is ERC721 /* , ERC165 */ {
 
 pragma solidity ^0.8.17;
 
-import "IERC1155.sol";
-import "IERC165.sol";
+import "ERC1155.sol";
+import "ERC165.sol";
 
 /// @notice Refundable EIP-1155 tokens
 /// @dev    The EIP-165 identifier of this interface is `0x94029f5c`

From f97ecf2ab4808fe83d7d3a812bbdeedab6de226e Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Fri, 6 Jan 2023 12:50:30 -0800
Subject: [PATCH 134/274] This PR shouldn't be able to be merged by me

---
 404.html | 1 -
 1 file changed, 1 deletion(-)

diff --git a/404.html b/404.html
index c472b4ea0a7810..faf7e23559089f 100644
--- a/404.html
+++ b/404.html
@@ -18,7 +18,6 @@
 
 <div class="container">
   <h1>404</h1>
-
   <p><strong>Page not found :(</strong></p>
   <p>The requested page could not be found.</p>
 </div>

From 8e27eca8acf0d926e269b325be4974cdee92660b Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 16:02:47 -0500
Subject: [PATCH 135/274] Update EIP-5507: Final changes before last call
 (#6283)

* Update EIP-5507: Final changes before last call

* Fix walidator issue
---
 EIPS/eip-5507.md | 14 ++++++++++----
 1 file changed, 10 insertions(+), 4 deletions(-)

diff --git a/EIPS/eip-5507.md b/EIPS/eip-5507.md
index e329cde7ff7317..6bbb9493300256 100644
--- a/EIPS/eip-5507.md
+++ b/EIPS/eip-5507.md
@@ -55,7 +55,7 @@ interface ERC20Refund is ERC20, ERC165 {
     function refundOf() external view returns (uint256 _wei);
  
     /// @notice         Gets the first block for which the refund is not active
-    /// @return block   The block beyond which the token cannot be refunded
+    /// @return block   The first block where the token cannot be refunded
     function refundDeadlineOf() external view returns (uint256 block);
 }
 ```
@@ -94,7 +94,7 @@ interface ERC721Refund is ERC721 /* , ERC165 */ {
  
     /// @notice         Gets the first block for which the refund is not active for a given `tokenId`
     /// @param  tokenId The `tokenId` to query
-    /// @return block   The block beyond which the token cannot be refunded
+    /// @return block   The first block where token cannot be refunded
     function refundDeadlineOf(uint256 tokenId) external view returns (uint256 block);
 }
 ```
@@ -136,7 +136,7 @@ interface ERC1155Refund is ERC1155 /* , ERC165 */ {
 
     /// @notice         Gets the first block for which the refund is not active for a given `tokenId`
     /// @param  tokenId The `tokenId` to query
-    /// @return block   The block beyond which the token cannot be refunded
+    /// @return block   The first block where the token cannot be refunded
     function refundDeadlineOf(uint256 tokenId) external view returns (uint256 block);
 }
 ```
@@ -145,13 +145,19 @@ interface ERC1155Refund is ERC1155 /* , ERC165 */ {
 
 `refundDeadlineOf` uses blocks instead of timestamps, as timestamps are less reliable than block numbers.
 
+The function names of `refund`, `refundOf`, and `refundDeadlineOf` were chosen to fit the naming style of EIP-20, EIP-721, and EIP-1155.
+
+[EIP-165](./eip-165.md) is required as introspection by DApps would be made significantly harder if it weren't.
+
+Custom EIP-20 tokens are not supported, as it needlessly increases complexity.
+
 ## Backwards Compatibility
 
 No backward compatibility issues were found.
 
 ## Security Considerations
 
-Needs discussion.
+There is a potential re-entrancy risk with the `refund` function. Make sure to perform the ether transfer **after** the tokens are destroyed (i.e. obey the checks, effects, interactions pattern).
 
 ## Copyright
 

From 2dc5c71cba420495ab0085145aaeae5e0c2938df Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 16:22:14 -0500
Subject: [PATCH 136/274] CI: Make @eth-bot run on every PR action (#6284)

---
 .github/workflows/auto-review-trigger.yml | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/.github/workflows/auto-review-trigger.yml b/.github/workflows/auto-review-trigger.yml
index 644e1b01622567..a6f36363a93f55 100644
--- a/.github/workflows/auto-review-trigger.yml
+++ b/.github/workflows/auto-review-trigger.yml
@@ -1,14 +1,6 @@
 on:
   pull_request_target:
-    types:
-      - opened
-      - reopened
-      - synchronize
-      - ready_for_review
   pull_request_review:
-    types:
-      - submitted
-      - dismissed
   workflow_dispatch:
     inputs:
       pr_number:

From b86ce9e53e7cfff49204391f4b004a549ac8ee17 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 16:29:29 -0500
Subject: [PATCH 137/274] Update EIP-4834: Add changes to increase flexibility
 (#6285)

* Update EIP-4834: Add changes to increase flexibility

* Delete IDomain.sol

* Delete IDomainAccessControl.sol

* Delete IDomainEnumerable.sol

* Delete OwnableDomain.sol

* Remove reference implementation

* Fix typo

* Update eip-4834.md
---
 EIPS/eip-4834.md                         | 107 ++++++++-----------
 assets/eip-4834/IDomain.sol              |  92 ----------------
 assets/eip-4834/IDomainAccessControl.sol |  26 -----
 assets/eip-4834/IDomainEnumerable.sol    |  17 ---
 assets/eip-4834/OwnableDomain.sol        | 130 -----------------------
 5 files changed, 47 insertions(+), 325 deletions(-)
 delete mode 100644 assets/eip-4834/IDomain.sol
 delete mode 100644 assets/eip-4834/IDomainAccessControl.sol
 delete mode 100644 assets/eip-4834/IDomainEnumerable.sol
 delete mode 100644 assets/eip-4834/OwnableDomain.sol

diff --git a/EIPS/eip-4834.md b/EIPS/eip-4834.md
index d497c34b9a54b5..1a17cebfd92581 100644
--- a/EIPS/eip-4834.md
+++ b/EIPS/eip-4834.md
@@ -8,16 +8,11 @@ status: Review
 type: Standards Track
 category: ERC
 created: 2022-02-22
-requires: 137, 165
 ---
 
 ## Abstract
 
-This is a standard for generic name resolution with access control. It permits a contract that implements this EIP (referred to as a "domain" hereafter) to be addressable with a more human-friendly name, with a similar purpose to [EIP-137](./eip-137.md) (referred to as "ENS" hereafter).
-
-Any program that resolves domains should treat domains as equivalent to their resolved addresses. In practice, this means users of DApps that implement this EIP's name resolution may specify an address that looks like `dai.token` instead of `0x6b175474e89094c44da98b954eedeac495271d0f`. In this instance, `dai.token` and `0x6b175474e89094c44da98b954eedeac495271d0f` are not different, unlike ENS, where names are simply keys to be hashed and inputted into a storage contract that then resolves the name to an address.
-
-Another notable divergence from ENS is that access control can be arbitrarily complex. ENS domains have a defined owner that has full permission to create, update, and delete subdomains, as well as update the metadata of the domain in resolver contracts. While this can be made more strict by delegating control of the ENS domain to a smart contract, this EIP takes a different approach, and permits any access control patterns to be implemented.
+This is a standard for generic name resolution with arbitrarily complex access control and resolution. It permits a contract that implements this EIP (referred to as a "domain" hereafter) to be addressable with a more human-friendly name, with a similar purpose to [EIP-137](./eip-137.md) (also known as "ENS").
 
 ## Motivation
 
@@ -34,7 +29,50 @@ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "S
 Solidity Interface with NatSpec & OpenZeppelin v4 Interfaces (also available at [IDomain.sol](../assets/eip-4834/IDomain.sol)):
 
 ```solidity
-interface IDomain is IERC165 {
+interface IDomain {
+    /// @notice     Query if a domain has a subdomain with a given name
+    /// @param      name The subdomain to query, in right to left order
+    /// @return     `true` if the domain has a subdomain with the given name, `false` otherwise
+    function hasDomain(string[] memory name) external view returns (bool);
+
+    /// @notice     Fetch the subdomain with a given name
+    /// @dev        This should revert if `hasDomain(name)` is `false`
+    /// @param      name The subdomain to fetch, in right to left order
+    /// @return     The subdomain with the given name
+    function getDomain(string[] memory name) external view returns (address);
+}
+```
+
+### Name Resolution
+
+To resolve a name (like `"a.b.c"`), split it by the delimiter (resulting in something like `["a", "b", "c"]`). Set `domain` initially to the root domain, and `path` to be an empty list.
+
+Pop off the last element of the array (`"c"`) and add it to the path, then call `domain.hasDomain(path)`. If it's `false`, then the domain resolution fails. Otherwise, set the domain to `domain.getDomain(path)`. Repeat until the list of split segments is empty.
+
+There is no limit to the amount of nesting that is possible. For example, `0.1.2.3.4.5.6.7.8.9.a.b.c.d.e.f.g.h.i.j.k.l.m.n.o.p.q.r.s.t.u.v.w.x.y.z` would be valid if the root contains `z`, and `z` contains `y`, and so on.
+
+Here is a solidity function that resolves a name:
+
+```solidity
+function resolve(string[] calldata splitName, IDomain root) public view returns (address) {
+    IDomain current = root;
+    string[] memory path = [];
+    for (uint i = splitName.length - 1; i >= 0; i--) {
+        // Append to back of list
+        path.push(splitName[i]);
+        // Require that the current domain has a domain
+        require(current.hasDomain(path), "Name resolution failed");
+        // Resolve subdomain
+        current = current.getDomain(path);
+    }
+    return current;
+}
+```
+
+### Optional Extension: Registerable
+
+```solidity
+interface IDomainRegisterable is IDomain {
     //// Events
     
     /// @notice     Must be emitted when a new subdomain is created (e.g. through `createDomain`)
@@ -56,25 +94,13 @@ interface IDomain is IERC165 {
     /// @param      subdomain the old subdomain
     event SubdomainDelete(address indexed sender, string name, address subdomain);
 
-
     //// CRUD
-
-    /// @notice     Query if a domain has a subdomain with a given name
-    /// @param      name The subdomain to query
-    /// @return     `true` if the domain has a subdomain with the given name, `false` otherwise
-    function hasDomain(string memory name) external view returns (bool);
-
-    /// @notice     Fetch the subdomain with a given name
-    /// @dev        This should revert if `hasDomain(name)` is `false`
-    /// @param      name The subdomain to fetch
-    /// @return     The subdomain with the given name
-    function getDomain(string memory name) external view returns (address);
     
     /// @notice     Create a subdomain with a given name
     /// @dev        This should revert if `canCreateDomain(msg.sender, name, pointer)` is `false` or if the domain exists
     /// @param      name The subdomain name to be created
     /// @param      subdomain The subdomain to create
-    function createDomain(string memory name, address subdomain) external;
+    function createDomain(string memory name, address subdomain) external payable;
 
     /// @notice     Update a subdomain with a given name
     /// @dev        This should revert if `canSetDomain(msg.sender, name, pointer)` is `false` of if the domain doesn't exist
@@ -117,35 +143,8 @@ interface IDomain is IERC165 {
 }
 ```
 
-As per [EIP-165](./eip-165.md), `supportsInterface(0xe3ffd947)` MUST return `true`.
-
-### Name Resolution
-
-To resolve a name (like `"a.b.c"`), split it by the delimiter (resulting in something like `["a", "b", "c"]`). Set `domain` initially to the root domain.
-
-Pop off the last element of the array (`"c"`), then call `domain.hasDomain(lastElement)`. If it's `false`, then the domain resolution fails. Otherwise, set the domain to `domain.getDomain(lastElement)`. Repeat until the list of split segments is empty.
-
-There is no limit to the amount of nesting that is possible. For example, `0.1.2.3.4.5.6.7.8.9.a.b.c.d.e.f.g.h.i.j.k.l.m.n.o.p.q.r.s.t.u.v.w.x.y.z` would be valid if the root contains `z`, and `z` contains `y`, and so on.
-
-Here is a solidity function that resolves a name:
-
-```solidity
-function resolve(string[] calldata splitName, IDomain root) public view returns (address) {
-    IDomain current = root;
-    for (uint i = splitName.length - 1; i >= 0; i--) {
-        // Require that the current domain has a domain
-        require(current.hasDomain(splitName[i]), "Name resolution failed: );
-        // Resolve subdomain
-        current = current.getDomain(splitName[i]);
-    }
-    return current;
-}
-```
-
 ### Optional Extension: Enumerable
 
-Solidity Interface with NatSpec & OpenZeppelin v4 Interfaces (also available at [IDomainEnumerable.sol](../assets/eip-4834/IDomainEnumerable.sol)):
-
 ```solidity
 interface IDomainEnumerable is IDomain {
     /// @notice     Query all subdomains. Must revert if the number of domains is unknown or infinite.
@@ -158,12 +157,8 @@ interface IDomainEnumerable is IDomain {
 }
 ```
 
-As per [EIP-165](./eip-165.md), `supportsInterface(0x8d5fd78e)` MUST return `true` if `IDomainEnumerable` is used.
-
 ### Optional Extension: Access Control
 
-Solidity Interface with NatSpec & OpenZeppelin v4 Interfaces (also available at [IDomainAccessControl.sol](../assets/eip-4834/IDomainAccessControl.sol)):
-
 ```solidity
 interface IDomainAccessControl is IDomain {
     /// @notice     Get if an account can move the subdomain away from the current domain
@@ -185,8 +180,6 @@ interface IDomainAccessControl is IDomain {
 }
 ```
 
-As per [EIP-165](./eip-165.md), `supportsInterface(0x1b2e22d2)` MUST return `true` if `IDomainAccessControl` is used.
-
 ## Rationale
 
 This EIP's goal, as mentioned in the abstract, is to have a simple interface for resolving names. Here are a few design decisions and why they were made:
@@ -205,13 +198,7 @@ This EIP's goal, as mentioned in the abstract, is to have a simple interface for
 
 ## Backwards Compatibility
 
-There is no compatibility with ENS because ENS domains are indexed by the hash of the entire domain, while domains under this EIP are indexed by the subdomain name.
-
-## Reference Implementation
-
-Some of these implementations use some contracts from OpenZeppelin for ease of understandability.
-
-Ownable Domain Implementation: [OwnableDomain.sol](../assets/eip-4834/OwnableDomain.sol)
+This EIP is general enough to support ENS, but ENS is not general enough to support this EIP.
 
 ## Security Considerations
 
diff --git a/assets/eip-4834/IDomain.sol b/assets/eip-4834/IDomain.sol
deleted file mode 100644
index e92f842e2bf203..00000000000000
--- a/assets/eip-4834/IDomain.sol
+++ /dev/null
@@ -1,92 +0,0 @@
-// SPDX-License-Identifier: CC0-1.0
-pragma solidity ^0.8.9;
-
-import "@openzeppelin/contracts/interfaces/IERC165.sol";
-
-/// @title          ERC-4835 Heirarchal Domains Standard
-/// @author         Pandapip1
-/// @dev            https://eips.ethereum.org/EIPS/eip-4835
-interface IDomain is IERC165 {
-    //// Events
-    
-    /// @notice     Must be emitted when a new subdomain is created (eg. through `createDomain`.)
-    /// @param      sender msg.sender for createDomain
-    /// @param      name name for createDomain
-    /// @param      subdomain subdomain in createDomain
-    event SubdomainCreate(address indexed sender, string name, address subdomain);
-
-    /// @notice     Must be emitted when the resolved address for a domain is changed (eg. with `setDomain`)
-    /// @param      sender msg.sender for setDomain
-    /// @param      name name for setDomain
-    /// @param      subdomain subdomain in setDomain
-    /// @param      oldSubdomain the old subdomain
-    event SubdomainUpdate(address indexed sender, string name, address subdomain, address oldSubdomain);
-
-    /// @notice     Must be emitted when a domain is unmapped (eg. with `deleteDomain`)
-    /// @param      sender msg.sender for deleteDomain
-    /// @param      name name for deleteDomain
-    /// @param      subdomain the old subdomain
-    event SubdomainDelete(address indexed sender, string name, address subdomain);
-
-
-    //// CRUD
-
-    /// @notice     Query if a domain has a subdomain with a given name
-    /// @param      name The subdomain to query
-    /// @return     `true` if the domain has a subdomain with the given name, `false` otherwise
-    function hasDomain(string memory name) external view returns (bool);
-
-    /// @notice     Fetch the subdomain with a given name
-    /// @dev        This should revert if `hasDomain(name)` is `false`
-    /// @param      name The subdomain to fetch
-    /// @return     The subdomain with the given name
-    function getDomain(string memory name) external view returns (address);
-
-    /// @notice     Create a subdomain with a given name
-    /// @dev        This should revert if `canCreateDomain(msg.sender, name, pointer)` is `false` or if the domain exists
-    /// @param      name The subdomain name to be created
-    /// @param      subdomain The subdomain to create
-    function createDomain(string memory name, address subdomain) external;
-
-    /// @notice     Update a subdomain with a given name
-    /// @dev        This should revert if `canSetDomain(msg.sender, name, pointer)` is `false` of if the domain does not exist
-    /// @param      name The subdomain name to be updated
-    /// @param      subdomain The subdomain to set
-    function setDomain(string memory name, address subdomain) external;
-
-    /// @notice     Delete the subdomain with a given name
-    /// @dev        This should revert if the domain does not exist or if
-    ///             `canDeleteDomain(msg.sender, name, this)` is `false`
-    /// @param      name The subdomain to delete
-    function deleteDomain(string memory name) external;
-
-
-    //// Parent Domain Access Control
-
-    /// @notice     Get if an account can create a subdomain with a given name
-    /// @dev        This must return `false` if `hasDomain(name)` is `true`.
-    /// @param      updater The account that may or may not be able to create/update a subdomain
-    /// @param      name The subdomain name that would be created/updated
-    /// @param      subdomain The subdomain that would be set
-    /// @return     Whether an account can update or create the subdomain
-    function canCreateDomain(address updater, string memory name, address subdomain) external view returns (bool);
-
-    /// @notice     Get if an account can update or create a subdomain with a given name
-    /// @dev        This must return `false` if `hasDomain(name)` is `false`.
-    ///             If `getDomain(name)` is also a domain, this should return `false` if
-    ///             `getDomain(name).canMoveSubdomain(msg.sender, this, subdomain)` is `false`.
-    /// @param      updater The account that may or may not be able to create/update a subdomain
-    /// @param      name The subdomain name that would be created/updated
-    /// @param      subdomain The subdomain that would be set
-    /// @return     Whether an account can update or create the subdomain
-    function canSetDomain(address updater, string memory name, address subdomain) external view returns (bool);
-
-    /// @notice     Get if an account can delete the subdomain with a given name
-    /// @dev        This must return `false` if `hasDomain(name)` is `false`.
-    ///             If `getDomain(name)` is a domain, this should return `false` if
-    ///             `getDomain(name).canDeleteSubdomain(msg.sender, this, subdomain)` is `false`.
-    /// @param      updater The account that may or may not be able to delete a subdomain
-    /// @param      name The subdomain to delete
-    /// @return     Whether an account can delete the subdomain
-    function canDeleteDomain(address updater, string memory name) external view returns (bool);
-}
diff --git a/assets/eip-4834/IDomainAccessControl.sol b/assets/eip-4834/IDomainAccessControl.sol
deleted file mode 100644
index 8923a9f138db36..00000000000000
--- a/assets/eip-4834/IDomainAccessControl.sol
+++ /dev/null
@@ -1,26 +0,0 @@
-// SPDX-License-Identifier: CC0-1.0
-pragma solidity ^0.8.9;
-
-import "./IDomain.sol";
-
-/// @title          ERC-4835 Heirarchal Domains Standard (Access Control Extension)
-/// @author         Pandapip1
-/// @dev            https://eips.ethereum.org/EIPS/eip-4835
-interface IDomainAccessControl is IDomain {
-    /// @notice     Get if an account can move the subdomain away from the current domain
-    /// @dev        May be called by `canSetDomain` of the parent domain - implement access control here!!!
-    /// @param      updater The account that may be moving the subdomain
-    /// @param      name The subdomain name
-    /// @param      parent The parent domain
-    /// @param      newSubdomain The domain that will be set next
-    /// @return     Whether an account can update the subdomain
-    function canMoveSubdomain(address updater, string memory name, IDomain parent, address newSubdomain) external view returns (bool);
-
-    /// @notice     Get if an account can unset this domain as a subdomain
-    /// @dev        May be called by `canDeleteDomain` of the parent domain - implement access control here!!!
-    /// @param      updater The account that may or may not be able to delete a subdomain
-    /// @param      name The subdomain to delete
-    /// @param      parent The parent domain
-    /// @return     Whether an account can delete the subdomain
-    function canDeleteSubdomain(address updater, string memory name, IDomain parent) external view returns (bool);
-}
diff --git a/assets/eip-4834/IDomainEnumerable.sol b/assets/eip-4834/IDomainEnumerable.sol
deleted file mode 100644
index ae4161ef27ecbf..00000000000000
--- a/assets/eip-4834/IDomainEnumerable.sol
+++ /dev/null
@@ -1,17 +0,0 @@
-// SPDX-License-Identifier: CC0-1.0
-pragma solidity ^0.8.9;
-
-import "./IDomain.sol";
-
-/// @title          ERC-4835 Heirarchal Domains Standard (Enumerable Extension)
-/// @author         Pandapip1
-/// @dev            https://eips.ethereum.org/EIPS/eip-4835
-interface IDomainEnumerable is IDomain {
-    /// @notice     Query all subdomains. Must revert if the number of domains is unknown or infinite.
-    /// @return     The subdomain with the given index.
-    function subdomainByIndex(uint256 index) external view returns (string memory);
-    
-    /// @notice     Get the total number of subdomains. Must revert if the number of domains is unknown or infinite.
-    /// @return     The total number of subdomains
-    function totalSubdomains() external view returns (uint256);
-}
diff --git a/assets/eip-4834/OwnableDomain.sol b/assets/eip-4834/OwnableDomain.sol
deleted file mode 100644
index 6af8c8ad62c78c..00000000000000
--- a/assets/eip-4834/OwnableDomain.sol
+++ /dev/null
@@ -1,130 +0,0 @@
-// SPDX-License-Identifier: CC0-1.0
-pragma solidity ^0.8.9;
-
-// NOTE: This is very untested. Do not use!
-
-import "./IDomain.sol";
-import "./IDomainAccessControl.sol";
-import "./IDomainEnumerable.sol";
-import "@openzeppelin/contracts/utils/introspection/ERC165Storage.sol";
-import "@openzeppelin/contracts/utils/introspection/ERC165Checker.sol";
-import "@openzeppelin/contracts/access/Ownable.sol";
-
-contract OwnableDomain is IDomain, IDomainAccessControl, ERC165Storage, Ownable, ERC165Checker {
-    //// States
-    mapping(string => address) public subdomains;
-    mapping(string => bool) public subdomainsPresent;
-    mapping(string => uint) public subdomainIndeces;
-    string[] public subdomainList;
-
-
-    //// Constructor
-
-    constructor() {
-        _registerInterface(type(IDomain).interfaceId);
-        _registerInterface(type(IDomainAccessControl).interfaceId);
-    }
-
-
-    //// CRUD
-
-    function hasDomain(string memory name) public view returns (bool) {
-        return subdomainsPresent[name];
-    }
-
-    function getDomain(string memory name) public view returns (address) {
-        require(this.hasDomain(name));
-        return subdomains[name];
-    }
-
-    function createDomain(string memory name, IDomain subdomain) public {
-        require(!this.hasDomain(name));
-        require(this.canCreateDomain(msg.sender, name, subdomain));
-        
-        subdomainsPresent[name] = true;
-        subdomains[name] = subdomain;
-
-        subdomainIndeces[name] = subdomainList.length;
-        subdomainList.push(name);
-
-        emit SubdomainCreate(msg.sender, name, subdomain);
-    }
-
-    function setDomain(string memory name, address subdomain) public {
-        require(this.hasDomain(name));
-        require(this.canSetDomain(msg.sender, name, subdomain));
-
-        address oldSubdomain = subdomains[name];
-        subdomains[name] = subdomain;
-
-        emit SubdomainUpdate(msg.sender, name, subdomain, oldSubdomain);
-    }
-
-    function deleteDomain(string memory name) public {
-        require(this.hasDomain(name));
-        require(this.canDeleteDomain(msg.sender, name));
-
-        subdomainsPresent[name] = false; // Only need to mark it as deleted
-        delete subdomainList[subdomainIndeces[name]]; // Remove subdomain from list
-
-        emit SubdomainDelete(msg.sender, name, subdomains[name]);
-    }
-
-
-    //// Parent Domain Access Control
-
-    function canCreateDomain(address updater, string memory name, address subdomain) public view returns (bool) {
-        // Existence Check
-        if (this.hasDomain(name)) {
-            return false;
-        }
-
-        // Is user owner
-        bool isTheOwner = this.owner() == updater;
-
-        // Return
-        return isTheOwner;
-    }
-
-    function canSetDomain(address updater, string memory name, address subdomain) public view returns (bool) {
-        // Existence Check
-        if (!this.hasDomain(name)) {
-            return false;
-        }
-
-        // Is user owner
-        bool isTheOwner = this.owner() == updater;
-
-        // Auth Check
-        bool isMovable = this.supportsInterface(this.getDomain(name), type(IDomainAccessControl).interfaceId) && IDomainAccessControl(this.getDomain(name)).canMoveSubdomain(updater, name, this, subdomain);
-
-        // Return
-        return (isTheOwner || isMovable);
-    }
-
-    function canDeleteDomain(address updater, string memory name) public view returns (bool) {
-        // Existence Check
-        if (!this.hasDomain(name)) {
-            return false;
-        }
-
-        // Is user owner
-        bool isTheOwner = this.owner() == updater;
-
-        // Auth Check
-        bool isDeletable = this.supportsInterface(this.getDomain(name), type(IDomainAccessControl).interfaceId) && IDomainAccessControl(this.getDomain(name)).canDeleteDomain(updater, name, this);
-
-        // Return
-        return isTheOwner || isDeletable;
-    }
-
-    //// Subdomain Access Control
-
-    function canMoveSubdomain(address updater, string memory name, IDomain parent, address newSubdomain) public virtual view returns (bool) {
-        return this.owner() == updater;
-    }
-
-    function canDeleteSubdomain(address updater, string memory name, IDomain parent) public virtual view returns (bool) {
-        return this.owner() == updater;
-    }
-}

From fb7ea45bf315a46906d2936bd5f6498cf0db6c7f Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 16:37:20 -0500
Subject: [PATCH 138/274] Update EIP-4834: Remove old links (#6288)

---
 EIPS/eip-4834.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/EIPS/eip-4834.md b/EIPS/eip-4834.md
index 1a17cebfd92581..dbd29f8d4c8e29 100644
--- a/EIPS/eip-4834.md
+++ b/EIPS/eip-4834.md
@@ -26,8 +26,6 @@ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "S
 
 ### Contract Interface
 
-Solidity Interface with NatSpec & OpenZeppelin v4 Interfaces (also available at [IDomain.sol](../assets/eip-4834/IDomain.sol)):
-
 ```solidity
 interface IDomain {
     /// @notice     Query if a domain has a subdomain with a given name
@@ -222,10 +220,6 @@ Clients should help by warning if `canMoveSubdomain` or `canDeleteSubdomain` for
 
 Parent domains have full control of name resolution for their subdomains. If a particular domain is linked to `a.b.c`, then `b.c` can, depending on its code, set `a.b.c` to any domain, and `c` can set `b.c` itself to any domain.
 
-#### Examples: Parent Domain Resolution
-
-The reference Ownable domain implementation: [OwnableDomain.sol](../assets/eip-4834/OwnableDomain.sol)
-
 #### Mitigation: Parent Domain Resolution
 
 Before acquiring a domain that has been pre-linked, it is recommended to always have the contract **and** all the parents up to the root audited.

From 6cab84b017b57956eef8bb67626323b22a57d8dd Mon Sep 17 00:00:00 2001
From: Dror Tirosh <dror@opengsn.org>
Date: Sat, 7 Jan 2023 02:21:32 +0200
Subject: [PATCH 139/274] Update eip-2771.md (#6290)

---
 EIPS/eip-2771.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-2771.md b/EIPS/eip-2771.md
index 1c008c157547bd..b2d0542e1d97b2 100644
--- a/EIPS/eip-2771.md
+++ b/EIPS/eip-2771.md
@@ -75,7 +75,7 @@ function isTrustedForwarder(address forwarder) external view returns(bool);
 
 Internally, the **Recipient** MUST then accept a request from forwarder.
 
-`isTrustedForwarder` function MAY be called on-chain, and as such gas restrictions MUST be put in place. A gas limit of 50k SHOULD be sufficient to making the decision either inside the contract, or delegating it to another contract and doing some memory access calculations, like querying a mapping.
+`isTrustedForwarder` function MAY be called on-chain, and as such gas restrictions MUST be put in place. It SHOULD NOT consume more than 50,000 gas
 
 ## Rationale
 

From 932574d7581de03764eb00b9e2c34b2d7c5ce265 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Fri, 6 Jan 2023 20:26:21 -0500
Subject: [PATCH 140/274] Update EIP-5568: Micah's review (#6291)

* Update EIP-5568: Micah's review

* Remove Well-known from title
---
 EIPS/eip-5568.md | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/EIPS/eip-5568.md b/EIPS/eip-5568.md
index 6b18a057643051..495bf6dc8986e2 100644
--- a/EIPS/eip-5568.md
+++ b/EIPS/eip-5568.md
@@ -1,12 +1,12 @@
 ---
 eip: 5568
-title: Required Action Signals Using Revert Reasons
+title: Revert Reason for Required Actions
 description: Signal to wallets that an action is needed by returning a custom revert code
 author: Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/eip-5568-revert-signals/10622
 status: Review
 type: Standards Track
-category: Interface
+category: ERC
 created: 2022-08-31
 requires: 140
 ---
@@ -27,27 +27,25 @@ The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL
 
 ### Custom Revert Reason
 
-To send a signal to a wallet, a compliant smart contract MUST revert with the following error:
+To signal an action needs to be taken, a compliant smart contract MUST revert with the following error:
 
 ```solidity
-error WalletSignal24(uint8 number_hint, uint24 instruction_id, bytes instruction_data)
+error WalletSignal24(uint24 instruction_id, bytes instruction_data)
 ```
 
-The `number_hint` is an estimate of the number of signals that will be sent after the current signal. If a guess is availabe, `number_hint` MUST be that estimate. If a guess is unavailable, `number_hint` MUST be `0`.
-
 The `instruction_id` of an instruction defined by an EIP MUST be its EIP number unless there are exceptional circumstances (be reasonable). An EIP MUST define exactly zero or one `instruction_id`. The structure of the instruction data for any `instruction_id` MUST be defined by the EIP that defines the `instruction_id`.
 
-### Signal Response
+### Responding to a Revert
 
-Before submitting a transaction to the mempool, it MUST be evaluated locally. If it reverts and the revert signature matches the custom error, then it MUST be treated as a signal. (It is RECOMMENDED for wallets to show a warning if the transaction reverts, even if the revert is not a signal).
+Before submitting a transaction to the mempool, it MUST be evaluated locally. If it reverts and the revert signature matches the custom error, then the following applies.
 
-The `number_hint`, `instruction_id`, and `instruction_data` MUST be parsed from the revert data. It is RECOMMENDED for wallets to show a progress indicator using the `number_hint`. The instruction SHOULD be evaluated as per the relevant EIP. If the instruction is not supported by the wallet, it MUST display an error to the user indicating that is the case. The wallet MUST then re-evaluate the transaction, except if an instruction explicitly states that the transaction MUST NOT be re-evaluated.
+The `instruction_id`, and `instruction_data` MUST be parsed from the revert data. The instruction SHOULD be evaluated as per the relevant EIP. If the instruction is not supported by the wallet, it MUST display an error to the user indicating that is the case. The wallet MUST then re-evaluate the transaction, except if an instruction explicitly states that the transaction MUST NOT be re-evaluated.
 
-If an instruction is invalid, or the `number_hint`, `instruction_id`, and `instruction_data` cannot be parsed, then an error MUST be displayed to the user indicating that is the case.
+If an instruction is invalid, or the `instruction_id`, and `instruction_data` cannot be parsed, then an error MUST be displayed to the user indicating that is the case. The transaction MUST NOT be re-evaluated.
 
 ## Rationale
 
-This EIP was explicitly optimized for deployment gas cost and simplicity. It is expected that libraries will eventually be developed that makes sending and receiving signals more developer-friendly.
+This EIP was explicitly optimized for deployment gas cost and simplicity. It is expected that libraries will eventually be developed that makes sending and receiving these well-known reverts more developer-friendly.
 
 ## Backwards Compatibility
 

From f8a3cc25f903713a986c4614348b6fe56fb46f2f Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sat, 7 Jan 2023 15:58:15 -0500
Subject: [PATCH 141/274] Update EIP-5920: Prepare for Review (#6289)

---
 EIPS/eip-5920.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/EIPS/eip-5920.md b/EIPS/eip-5920.md
index 13d7d6f0ee0f99..569071de44e136 100644
--- a/EIPS/eip-5920.md
+++ b/EIPS/eip-5920.md
@@ -12,7 +12,7 @@ created: 2022-03-14
 
 ## Abstract
 
-This EIP introduces a new opcode, `PAY(addr, val)`, that transfers `val` wei to the address `addr` without calling it. After `FORK_BLKNUM`, this opcode is added to the EVM.
+This EIP introduces a new opcode, `PAY(addr, val)`, that transfers `val` wei to the address `addr` without calling it.
 
 ## Motivation
 
@@ -22,8 +22,7 @@ Currently, to send ether to an address requires you to call a function of that a
 
 | Parameter           | Value   |
 | ------------------- | ------- |
-| `FORK_BLKNUM`       | TBD     |
-| `PAY_OPCODE`        | TBD     |
+| `PAY_OPCODE`        | `0xf9`  |
 | `BASE_GAS_COST`     | `8600`  |
 | `COLD_GAS_COST`     | `11100`  |
 | `CREATION_GAS_COST` | `32600` |
@@ -47,7 +46,7 @@ The order of arguments mimicks that of `CALL`, which pops `addr` before `val`. B
 
 ## Backwards Compatibility
 
-Needs discussion.
+This change requires a hard fork.
 
 ## Security Considerations
 

From e7dd3fc058a9359895c5d5d7a6ddaf3da1e688e3 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sat, 7 Jan 2023 18:14:01 -0500
Subject: [PATCH 142/274] Update EIP-5920: Update abstract (#6292)

---
 EIPS/eip-5920.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5920.md b/EIPS/eip-5920.md
index 569071de44e136..4ce6395152349f 100644
--- a/EIPS/eip-5920.md
+++ b/EIPS/eip-5920.md
@@ -12,7 +12,7 @@ created: 2022-03-14
 
 ## Abstract
 
-This EIP introduces a new opcode, `PAY(addr, val)`, that transfers `val` wei to the address `addr` without calling it.
+This EIP introduces a new opcode, `PAY`, taking two stack parameters, `addr` and `val`, that transfers `val` wei to the address `addr` without calling any of its functions.
 
 ## Motivation
 

From 14c4fbd6f625c9cfc398fa1e3d86f19f0b135e3e Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sat, 7 Jan 2023 19:42:29 -0500
Subject: [PATCH 143/274] Update EIP-6188: Fix minor typo (#6296)

---
 EIPS/eip-6188.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6188.md b/EIPS/eip-6188.md
index 3b6cb1da12716b..2166cd8b18f11b 100644
--- a/EIPS/eip-6188.md
+++ b/EIPS/eip-6188.md
@@ -41,7 +41,7 @@ This EIP requires a protocol upgrade, since it modifies consensus rules. The fur
 
 ## Security Considerations
 
-As it is infeasible for contract accounts to get to the nonce limit, any potential problems with opcodes that depend on the value of an account's nonce can be safely ignored.
+As it is not feasible for contract accounts to get to the nonce limit, any potential problems with opcodes that depend on the value of an account's nonce can be safely ignored.
 
 ## Copyright
 

From d256c38fb6b806c2886e0a5f1e4186a80814a334 Mon Sep 17 00:00:00 2001
From: Francisco <frangio.1@gmail.com>
Date: Sun, 8 Jan 2023 00:05:30 -0300
Subject: [PATCH 144/274] EIP-5267: Clarify use of extensions and add event
 (#6297)

* Add clarity on meaning of extensions

* Add event on change
---
 EIPS/eip-5267.md | 52 ++++++++++++++++++++++++++++++++++++++++++------
 1 file changed, 46 insertions(+), 6 deletions(-)

diff --git a/EIPS/eip-5267.md b/EIPS/eip-5267.md
index 7cf07d57935764..e26892def69231 100644
--- a/EIPS/eip-5267.md
+++ b/EIPS/eip-5267.md
@@ -41,9 +41,13 @@ The return values of this function MUST describe the domain separator that is us
 
 - `fields`: A bit map where bit `i` is set to 1 if and only if domain field `i` is present (`0 ≤ i ≤ 4`). Bits are read from least significant to most significant, and fields are indexed in the order that is specified by EIP-712, identical to the order in which they are listed in the function type.
 - `name`, `version`, `chainId`, `verifyingContract`, `salt`: The value of the corresponding field in `EIP712Domain`, if present according to `fields`. If the field is not present, the value is unspecified. The semantics of each field is defined in EIP-712.
-- `extensions`: A list of EIP numbers that specify additional fields in the domain. The method to obtain the value for each of these additional fields and any conditions for inclusion are expected to be specified in the respective EIP. The value of `fields` does not affect their inclusion.
+- `extensions`: A list of EIP numbers, each of which MUST refer to an EIP that extends EIP-712 with new domain fields, along with a method to obtain the value for those fields, and potentially conditions for inclusion. The value of `fields` does not affect their inclusion.
 
-The return values of this function (equivalently, its EIP-712 domain) MAY change throughout the lifetime of a contract, but changes SHOULD NOT be frequent. The `chainId` field, if used, SHOULD change to mirror the [EIP-155](./eip-155.md) id of the underlying chain.
+The return values of this function (equivalently, its EIP-712 domain) MAY change throughout the lifetime of a contract, but changes SHOULD NOT be frequent. The `chainId` field, if used, SHOULD change to mirror the [EIP-155](./eip-155.md) id of the underlying chain. Contracts MAY emit the event `EIP712DomainChanged` defined below to signal that the domain could have changed.
+
+```solidity
+event EIP712DomainChanged();
+```
 
 ## Rationale
 
@@ -106,14 +110,22 @@ Assuming this contract is on Ethereum mainnet and its address is 0x0000000000000
 A domain object can be constructed based on the return values of an `eip712Domain()` invocation.
 
 ```javascript
-const fieldNames = ['name', 'version', 'chainId', 'verifyingContract', 'salt'];
+/** Retrieves the EIP-712 domain of a contract using EIP-5267 without extensions. */
+async function getDomain(contract) {
+  const { fields, name, version, chainId, verifyingContract, salt, extensions } =
+    await contract.eip712Domain();
 
-/** Builds a domain object based on the values obtained by calling `eip712Domain()` in a contract. */
-function buildDomain(fields, name, version, chainId, verifyingContract, salt, extensions) {
   if (extensions.length > 0) {
-    throw Error("extensions not implemented");
+    throw Error("Extensions not implemented");
   }
 
+  return buildBasicDomain(fields, name, version, chainId, verifyingContract, salt);
+}
+
+const fieldNames = ['name', 'version', 'chainId', 'verifyingContract', 'salt'];
+
+/** Builds a domain object without extensions based on the return values of `eip712Domain()`. */
+function buildBasicDomain(fields, name, version, chainId, verifyingContract, salt) {
   const domain = { name, version, chainId, verifyingContract, salt };
 
   for (const [i, field] of fieldNames.entries()) {
@@ -126,6 +138,34 @@ function buildDomain(fields, name, version, chainId, verifyingContract, salt, ex
 }
 ```
 
+#### Extensions
+
+Suppose EIP-XYZ defines a new field `subdomain` of type `bytes32` and a function `getSubdomain()` to retrieve its value.
+
+The function `getDomain` from above would be extended as follows.
+
+```javascript
+/** Retrieves the EIP-712 domain of a contract using EIP-5267 with support for EIP-XYZ. */
+async function getDomain(contract) {
+  const { fields, name, version, chainId, verifyingContract, salt, extensions } =
+    await contract.eip712Domain();
+
+  const domain = buildBasicDomain(fields, name, version, chainId, verifyingContract, salt);
+
+  for (const n of extensions) {
+    if (n === XYZ) {
+      domain.subdomain = await contract.getSubdomain();
+    } else {
+      throw Error(`EIP-${n} extension not implemented`);
+    }
+  }
+
+  return domain;
+}
+```
+
+Additionally, the type of the `EIP712Domain` struct needs to be extended with the `subdomain` field. This is left out of scope of this reference implementation.
+
 ## Security Considerations
 
 While this EIP allows a contract to specify a `verifyingContract` other than itself, as well as a `chainId` other than that of the current chain, user-agents and applications should in general validate that these do match the contract and chain before requesting any user signatures for the domain. This may not always be a valid assumption.

From 8061f8e2243eaae829d1fa91f7a763c889aca371 Mon Sep 17 00:00:00 2001
From: Firn Protocol <93839494+firnprotocol@users.noreply.github.com>
Date: Sun, 8 Jan 2023 12:35:02 -0500
Subject: [PATCH 145/274] more minor changes to 5630 (#6298)

---
 EIPS/eip-5630.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-5630.md b/EIPS/eip-5630.md
index db1ba3b0eed985..45cea4e9d3a619 100644
--- a/EIPS/eip-5630.md
+++ b/EIPS/eip-5630.md
@@ -1,7 +1,7 @@
 ---
 eip: 5630
 title: New approach for encryption / decryption
-description: defines a specification for encryption and decryption using deterministically derived, pseudorandom keys.
+description: defines a specification for encryption and decryption using Ethereum wallets.
 author: Firn Protocol (@firnprotocol), Fried L. Trout, Weiji Guo (@weijiguo)
 discussions-to: https://ethereum-magicians.org/t/eip-5630-encryption-and-decryption/10761
 status: Draft
@@ -97,7 +97,7 @@ contract ERC5630 {
   function encryptTo(bytes memory plaintext, bytes32 randomness)
     public
     view
-    returns (string memory version, bytes memory ciphertext);
+    returns (bytes memory ciphertext);
 }
 ```
 

From 7debfefdfa7f02bee40f54d033777544b1ecf601 Mon Sep 17 00:00:00 2001
From: Sean <darcys22@gmail.com>
Date: Mon, 9 Jan 2023 17:08:51 +1100
Subject: [PATCH 146/274] Make signature of signature optional (#6302)

Although forcing signatures upon the vendors would be useful, allowing
third parties and users to create their own receipts that are valid (but
ultimately not legal receipts) does offer some opportunites for
projects.
---
 EIPS/eip-5570.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-5570.md b/EIPS/eip-5570.md
index 1b33d2966c58e0..ab27f62db8158c 100644
--- a/EIPS/eip-5570.md
+++ b/EIPS/eip-5570.md
@@ -46,7 +46,7 @@ The JSON schema is composed of 2 parts. The root schema contains high level deta
   "id": "receipt.json#",
   "description": "Receipt Schema for Digital Receipt Non-Fungible Tokens",
   "type": "object",
-  "required": ["name", "description", "image", "receipt", "signature"],
+  "required": ["name", "description", "image", "receipt"],
   "properties": {
     "name": {
       "title": "Name",
@@ -257,7 +257,7 @@ The JSON schema is composed of 2 parts. The root schema contains high level deta
 
 ## Rationale
 
-The schema introduced complies with EIP-721's metadata extension, conveniently allowing previous tools for viewing NFTs to show our receipts. The new property "receipt" contains our newly provided receipt structure and the signature property requires the vendor to digitally sign the receipt structure.
+The schema introduced complies with EIP-721's metadata extension, conveniently allowing previous tools for viewing NFTs to show our receipts. The new property "receipt" contains our newly provided receipt structure and the signature property optionally allows the vendor to digitally sign the receipt structure.
 
 ## Backwards Compatibility
 

From b0ace5758c494b5c7d7a481de81d2113da6ecdf1 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <chfast@gmail.com>
Date: Mon, 9 Jan 2023 14:42:48 +0100
Subject: [PATCH 147/274] EIP-3860: Change the failure to OOG (#6249)

* EIP-3860: Change the failure to OOG

Change the failure in case of exceeding the initcode size limit for
CREATE instructions to be OOG (same as the other check and many others).

* EIP-3860: Fix typo

Co-authored-by: Alex Stokes <r.alex.stokes@gmail.com>

Co-authored-by: Alex Stokes <r.alex.stokes@gmail.com>
---
 EIPS/eip-3860.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-3860.md b/EIPS/eip-3860.md
index a6a0a03374e7ff..51fb6003054b88 100644
--- a/EIPS/eip-3860.md
+++ b/EIPS/eip-3860.md
@@ -56,8 +56,8 @@ We define `initcode_cost(initcode)` to equal `INITCODE_WORD_COST * ceil(len(init
 
 1. If length of transaction data (`initcode`) in a create transaction exceeds `MAX_INITCODE_SIZE`, transaction is invalid. (*Note that this is similar to transactions considered invalid for not meeting the intrinsic gas cost requirement.*)
 2. For a create transaction, extend the transaction data cost formula to include `initcode_cost(initcode)`. (*Note that this is included in transaction intrinsic cost, i.e. transaction with not enough gas to cover initcode cost is invalid.*)
-3. If length of `initcode` to `CREATE` or `CREATE2` instructions exceeds `MAX_INITCODE_SIZE`, instruction execution ends with the result `0` pushed on the stack. Gas for initcode execution is not deducted and caller's nonce is not incremented in this case.
-4. For the `CREATE` and `CREATE2` instructions charge an extra gas cost equaling to `initcode_cost(initcode)`. This cost is deducted before the calculation of the resulting contract address and the execution of `initcode`. (*Note that this means before or at the same time as the hashing cost is applied in `CREATE2`.*) If the instruction fails due to the `initcode` length check of point 3, this cost is not deducted. 
+3. If length of `initcode` to `CREATE` or `CREATE2` instructions exceeds `MAX_INITCODE_SIZE`, instruction execution exceptionally aborts (as if it runs out of gas).
+4. For the `CREATE` and `CREATE2` instructions charge an extra gas cost equaling to `initcode_cost(initcode)`. This cost is deducted before the calculation of the resulting contract address and the execution of `initcode`. (*Note that this means before or at the same time as the hashing cost is applied in `CREATE2`.*)
 
 ## Rationale
 
@@ -94,7 +94,7 @@ The initcode cost for create transaction data (0.0625 gas per byte) is negligibl
 
 ### How to report initcode limit violation?
 
-We specified that initcode size limit violation for `CREATE`/`CREATE2` results in `0` on stack. Most checks in these instructions are specified this way, except for 3 checks not specific to creation instructions (stack underflow, out of gas, static call violation). In these three cases the entire execution is exceptionally aborted. However, we decided to be consistent with the majority of the possible error conditions in order to keep the specification and implementations simple.
+We specified that initcode size limit violation for `CREATE`/`CREATE2` results in exceptional abort of the execution. This places it in the group of early out-of-gas checks, including: stack underflow, memory expansion, static call violation, initcode hashing cost, and initcode cost introduced by this EIP. They precede the later "light" checks: call depth and balance. The choice gives consistency to the order of checks and lowers implementation complexity (out-of-gas checks can be performed in any order).
 
 ## Backwards Compatibility
 

From 6a54217df7e3a2855f7117ec7285259e96038446 Mon Sep 17 00:00:00 2001
From: chaals <chaals@users.noreply.github.com>
Date: Mon, 9 Jan 2023 18:13:10 +0100
Subject: [PATCH 148/274] update EIP3220 to give 8 bytes for Native Chain ID
 (#6272)

---
 EIPS/eip-3220.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-3220.md b/EIPS/eip-3220.md
index 991396963f2ce8..949413a3f24231 100644
--- a/EIPS/eip-3220.md
+++ b/EIPS/eip-3220.md
@@ -45,10 +45,10 @@ Hence there is need for a more robust blockchain identifier that will overcome t
 | Name          | Size(bytes) | Description |
 |---------------|-------------|-------------|
 | Truncated Block Hash | 16 | This is the block hash of the genesis block or the block hash of of the block immediate prior to the fork for a fork of a blockchain. The 16 bytes is the 16 least significant bytes, assuming network byte order.|
-|Native Chain ID| 4 | This is the **Chain Id** value that should be used with the blockchain when signing transactions. For blockchains that do not have a concept of **Chain Id**, this value is zero.|
+|Native Chain ID| 8 | This is the **Chain Id** value that should be used with the blockchain when signing transactions. For blockchains that do not have a concept of **Chain Id**, this value is zero.|
 |Chain Type| 2 |  Reserve 0x00 as undefined chaintype. 0x01 as mainnet type. 0x1[0-A]: testnet, 0x2[0-A]: private development network|
 | Governance Identifier | 2 |  For new blockchains, a governance_identifier can be specified to identify an original **owner** of a blockchain, to help settle forked / main chain disputes. For all existing blockchains and for blockchains that do not have the concept of an **owner**, this field is zero. |
-| Reserved | 7 | Reserved for future use. Use 000000 for now. |
+| Reserved | 3 | Reserved for future use. Use 000000 for now. |
 | Checksum | 1 | Used to verify the integrity of the identifier. This integrity check is targeted at detecting Crosschain Identifiers mis-typed by human users. The value is calculated as the truncated SHA256 message digest of the rest of the identifier, using the least significant byte, assuming network byte order. Note that this checksum byte only detects integrity with a probability of one in 256. This probability is adequate for the intended usage of detecting typographical errors by people manually entering the Crosschain Identifier. |
 
 
@@ -58,7 +58,8 @@ We have considered various alternative specifications such as using a random uni
 
 ## Backwards Compatibility
 
-Crosschainid can be backward compatible with EIP-155.  The crosschain id contains a 4 byte segment to record the chainid based on EIP-155.
+Crosschainid can be backward compatible with EIP-155.  The crosschain id contains an 8 byte segment to record the `Native Chain ID`.
+For Ethereum chains, that can be used for a value intended to be used with EIP-155.
 
 ## Security Considerations
 

From 01cfec7f09a116a86e77d4f90296e4433ba21d08 Mon Sep 17 00:00:00 2001
From: Sean <darcys22@gmail.com>
Date: Tue, 10 Jan 2023 04:13:56 +1100
Subject: [PATCH 149/274] Update EIP-5570: Move to review (#6303)

* move ERC5570 to review

* linter over 5570
---
 EIPS/eip-5570.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-5570.md b/EIPS/eip-5570.md
index ab27f62db8158c..04ed1d66f1a462 100644
--- a/EIPS/eip-5570.md
+++ b/EIPS/eip-5570.md
@@ -4,7 +4,7 @@ title: Digital Receipt Non-Fungible Tokens
 description: Non-Fungible Tokens as digital receipts for physical purchases, where the metadata represents a JSON receipt
 author: Sean Darcy (@darcys22)
 discussions-to: https://ethereum-magicians.org/t/idea-standard-digital-receipts-using-erc-721/9908
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-09-01
@@ -33,14 +33,17 @@ One of the major roadblocks to fully automating our finance world has been the d
 ## Specification
 
 Transaction Flow:
+
  - A customer purchases an item from an online retailer, checking out leads the customer to an option to mint a NFT.
  - The smart contract provides the user with a Digital Receipt Non-Fungible Token.
  - When fulfilling the order, the retailer will upload the digital receipt specified in in the JSON schema below as the metadata to the previously minted NFT.
 
 ### Digital Receipt JSON Schema
+
 The JSON schema is composed of 2 parts. The root schema contains high level details of the receipt (for example Date and Vendor) and another schema for the optionally recurring line items contained in the receipt.
 
 #### Root Schema
+
 ```json
 {
   "id": "receipt.json#",
@@ -182,6 +185,7 @@ The JSON schema is composed of 2 parts. The root schema contains high level deta
 ```
 
 #### Line Items Schema
+
 ```json
 {
   "type": "object",
@@ -267,8 +271,6 @@ This standard is an extension of EIP-721. It is compatible with both optional ex
 
 The data stored in the receipt contains personally identifying information. This information should be encrypted to ensure privacy for the customer.
 
-<!-- TODO sean - draft up a separate EIP for the encryption of NFT metadata. -->
-
 ## Copyright
 
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 43ee7f9e64fde082f2712070d7b62a37650cb4b0 Mon Sep 17 00:00:00 2001
From: Roberto Bayardo <bayardo@alum.mit.edu>
Date: Mon, 9 Jan 2023 09:21:05 -0800
Subject: [PATCH 150/274] clarify signed blob transaction hashing (#6238)

* clarify how to compute the tx-hash of a signed blob transaction for non-signing purposes

* Update EIPS/eip-4844.md

Co-authored-by: Micah Zoltu <micah@zoltu.net>

* Update EIPS/eip-4844.md

Co-authored-by: Micah Zoltu <micah@zoltu.net>

Co-authored-by: Micah Zoltu <micah@zoltu.net>
---
 EIPS/eip-4844.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/EIPS/eip-4844.md b/EIPS/eip-4844.md
index df8423c5b84df3..15e66ea3e4f404 100644
--- a/EIPS/eip-4844.md
+++ b/EIPS/eip-4844.md
@@ -174,6 +174,13 @@ def get_origin(tx: SignedBlobTransaction) -> Address:
     return ecrecover(tx_hash(tx), int(sig.y_parity)+27, sig.r, sig.s)
 ```
 
+The transaction hash of a signed blob transaction should be computed as:
+
+```python
+def signed_tx_hash(tx: SignedBlobTransaction) -> Bytes32:
+    return keccak256(BLOB_TX_TYPE + ssz.serialize(tx))
+```
+
 ### Header extension
 
 The current header encoding is extended with a new 256-bit unsigned integer field `excess_data_gas`. This is the running

From 7cd2762b54b98c6298b8c952fcfadeabf8b146d6 Mon Sep 17 00:00:00 2001
From: Roberto Bayardo <bayardo@alum.mit.edu>
Date: Mon, 9 Jan 2023 12:46:50 -0800
Subject: [PATCH 151/274] change blob tx_hash to use serialize instead of
 hash_tree_root to make it more consistent with computing the regular blob tx
 hash (#6241)

---
 EIPS/eip-4844.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/EIPS/eip-4844.md b/EIPS/eip-4844.md
index 15e66ea3e4f404..b380662ef7088a 100644
--- a/EIPS/eip-4844.md
+++ b/EIPS/eip-4844.md
@@ -164,17 +164,17 @@ The execution layer verifies the wrapper validity against the inner `Transaction
 The signature is verified and `tx.origin` is calculated as follows:
 
 ```python
-def tx_hash(tx: SignedBlobTransaction) -> Bytes32:
+def unsigned_tx_hash(tx: SignedBlobTransaction) -> Bytes32:
     # The pre-image is prefixed with the transaction-type to avoid hash collisions with other tx hashers and types
-    return keccak256(BLOB_TX_TYPE + ssz.hash_tree_root(tx.message))
+    return keccak256(BLOB_TX_TYPE + ssz.serialize(tx.message))
 
 def get_origin(tx: SignedBlobTransaction) -> Address:
     sig = tx.signature
     # v = int(y_parity) + 27, same as EIP-1559
-    return ecrecover(tx_hash(tx), int(sig.y_parity)+27, sig.r, sig.s)
+    return ecrecover(unsigned_tx_hash(tx), int(sig.y_parity)+27, sig.r, sig.s)
 ```
 
-The transaction hash of a signed blob transaction should be computed as:
+The hash of a signed blob transaction should be computed as:
 
 ```python
 def signed_tx_hash(tx: SignedBlobTransaction) -> Bytes32:

From 22061ae55a4a08969ef23474b0c17d1873bbe9e6 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 10 Jan 2023 10:05:02 -0500
Subject: [PATCH 152/274] Update EIP-4834: Move to Last Call (#6287)

---
 EIPS/eip-4834.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-4834.md b/EIPS/eip-4834.md
index dbd29f8d4c8e29..9310db9baf2c0e 100644
--- a/EIPS/eip-4834.md
+++ b/EIPS/eip-4834.md
@@ -4,7 +4,8 @@ title: Hierarchical Domains
 description: Extremely generic name resolution
 author: Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/erc-4834-hierarchical-domains-standard/8388
-status: Review
+status: Last Call
+last-call-deadline: 2023-01-20
 type: Standards Track
 category: ERC
 created: 2022-02-22

From d6f47fc5ccd769ad9de587dfeee5275e9187b46a Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 10 Jan 2023 10:15:32 -0500
Subject: [PATCH 153/274] Update EIP-5507: Move to review (#6186)

---
 EIPS/eip-5507.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5507.md b/EIPS/eip-5507.md
index 6bbb9493300256..683cc10c034325 100644
--- a/EIPS/eip-5507.md
+++ b/EIPS/eip-5507.md
@@ -4,7 +4,7 @@ title: Refundable Tokens
 description: Adds refund functionality to EIP-20, EIP-721, and EIP-1155 tokens
 author: elie222 (@elie222), Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/eip-5507-refundable-nfts/10451
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-08-19

From 914695888ca2ecd395bff92987b18312d61f62d5 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 10 Jan 2023 10:16:08 -0500
Subject: [PATCH 154/274] Update EIP-5920: Move to Review (#6295)

---
 EIPS/eip-5920.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5920.md b/EIPS/eip-5920.md
index 4ce6395152349f..99922143cdfae2 100644
--- a/EIPS/eip-5920.md
+++ b/EIPS/eip-5920.md
@@ -4,7 +4,7 @@ title: PAY opcode
 description: Introduces a new opcode, PAY, to send ether to an address without calling any of its functions
 author: Pandapip1 (@Pandapip1), Zainan Victor Zhou (@xinbenlv)
 discussions-to: https://ethereum-magicians.org/t/eip-5920-pay-opcode/11717
-status: Draft
+status: Review
 type: Standards Track
 category: Core
 created: 2022-03-14

From a041be396ad6c503c9c89ff18284d156d54c5db0 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 10 Jan 2023 10:20:08 -0500
Subject: [PATCH 155/274] Add EIP-6189: Alias Contracts (#6189)

* Add contract aliases

* Add CREATE behavior

* Assign EIP-6189

* Rename eip-contract-alias.md to eip-6189.md

* Add discussions URL

* Add RFC 8174

* Recognize EOA Transactions

* Add contract-linking to CREATE and CREATE2

* Expand Motivation

* Add RPC endpoint change for eth_getStorageAt

* Fix a few isssues with the EIP

* Fix another small issue

* Clear check annotations
---
 EIPS/eip-6189.md | 98 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 98 insertions(+)
 create mode 100644 EIPS/eip-6189.md

diff --git a/EIPS/eip-6189.md b/EIPS/eip-6189.md
new file mode 100644
index 00000000000000..2dc6ccc08550f9
--- /dev/null
+++ b/EIPS/eip-6189.md
@@ -0,0 +1,98 @@
+---
+eip: 6189
+title: Alias Contracts
+description: Allows the creation of contracts that forward calls to other contracts
+author: Pandapip1 (@Pandapip1)
+discussions-to: https://ethereum-magicians.org/t/eip-6190-functional-selfdestruct/12232
+status: Draft
+type: Standards Track
+category: Core
+created: 2022-12-20
+requires: 2929, 6188
+---
+
+## Abstract
+
+This EIP allows contracts to be turned into "alias contracts" using a magic nonce. Alias contracts automatically forward calls to other contracts.
+
+## Motivation
+
+This EIP is not terribly useful on its own, as it adds additional computation and gas costs without any useful side effects. However, in conjunction with another EIP<!-- link not included to avoid circular dependencies, once it is merged I will update this EIP -->, it can be used to make SELFDESTRUCT compatible with Verkle trees.
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+### Definitions
+
+A contract is an alias contract if its nonce is `2^64-1`, and its contract code is equal to `0x1`.
+
+### Prerequisites
+
+[EIP-6188](./eip-6188.md) MUST be used to protect the magic nonce value of `2^64-1`.
+
+### Opcode Changes
+
+#### `CALL`, `CALLCODE`, `DELEGATECALL`, `STATICCALL`, and EOA Transactions
+
+The "callee" refers to the account that is being called.
+
+If the nonce of the callee is `2^64-1`, the call is forwarded to the address stored in the `0`th storage slot of the callee (as if the callee was the address stored in the `0`th storage slot of the callee). This repeats until a non-alias contract is reached. The `CALLER` remains unchanged.
+
+If there is more than one alias contract in the chain, the original callee and all subsequent callees (except the last one) have their `0`th storage slot set to the address of the final non-alias contract. Then, the call is forwarded as usual. **This occurs even in a read-only context.**
+
+For example, if `A` is an alias contract that forwards calls to `B`, which is an alias contract that forwards calls to `C`, then `A`'s `0`th storage slot is set to `C`'s address. Then, the call is forwarded to `C`.
+
+The `CALL`, `CALLCODE`, `DELEGATECALL`, and `STATICCALL` opcodes and EOA Transactions MUST cost an `25` gas per account accessed in this manner (including the final one, and including if no aliased accounts were used), in addition to all the regular costs incurred by accessing accounts (see [EIP-2929](./eip-2929.md)). For every account whose `0`th storage slot is updated, those opcodes must also cost an additional `5000` gas.
+
+If an infinite loop occurs, the transaction runs out of gas and reverts.
+
+#### `EXTCODEHASH`, `EXTCODECOPY`, `EXTCODESIZE`, and `BALANCE`
+
+The "accessed account" refers to the account that is being accessed (i.e. the account whose code is being accessed, or the account whose balance is being accessed).
+
+Similar to the `CALL` family of opcodes, if the nonce of the accessed account is `2^64-1`, the accessed account is replaced with the address stored in the `0`th storage slot of the accessed account. This repeats until a non-alias contract is reached.
+
+If there is more than one alias contract in the chain, the original accessed account and all subsequent accessed accounts (except the last one) have their `0`th storage slot set to the address of the final non-alias contract. Then, the accessed account is replaced as usual.
+
+The `EXTCODEHASH`, `EXTCODECOPY`, `EXTCODESIZE`, and `BALANCE` opcodes MUST cost an `25` gas per account accessed in this manner (including the final one, and including if no aliased accounts were used), in addition to all the regular costs incurred by accessing accounts (see [EIP-2929](./eip-2929.md)). For every account whose `0`th storage slot is updated, those opcodes must also cost an additional `5000` gas.
+
+If an infinite loop occurs, the transaction runs out of gas and reverts.
+
+#### `CREATE` and `CREATE2`
+
+If `CREATE` or `CREATE2` would fail because there is already a an account at the address, and that contract's code is `0x1`, and its nonce is `2^64-1`, then instead of failing, an attempt should be made to create a contract at the address stored in the `0`th storage slot of the existing contract. This repeats until a non-alias contract is reached, at which point either the creation succeeds, or it fails because there is already an account at the address.
+
+Regardless of if creation succeeds, if there is more than one alias contract in the chain, the original accessed account and all subsequent accessed accounts (except the last one) have their `0`th storage slot set to the address of the final non-alias contract. Then, the accessed account is replaced as usual.
+
+The `CREATE` and `CREATE2` opcodes MUST cost an `25` gas per account accessed in this manner (including the final one, and including if no aliased accounts were used), in addition to all the regular costs incurred by accessing accounts (see [EIP-2929](./eip-2929.md)). For every account whose `0`th storage slot is updated, those opcodes must also cost an additional `5000` gas.
+
+If an infinite loop occurs, the transaction runs out of gas and reverts.
+
+### RPC Endpoint Changes
+
+#### `eth_getStorageAt`
+
+The `eth_getStorageAt` RPC endpoint must error if the target contract has a contract code of `0x1` and a nonce of `2^64-1`.
+
+## Rationale
+
+The additional gas cost of `25` represents the cost of fetching the nonce and comparing it to the given value.
+
+`eth_getStorageAt` was modified to throw an error because of alias contracts' special behavior.
+
+The nonce of `2^64-1` was chosen since it is the nonce protected by [EIP-6188](./eip-6188.md).
+
+The contract code of `0x1` was chosen arbitrarily. A nonzero code was chosen just in case a non-alias contract with nonce `2^64-1` somehow had its code set to `0x0`, or an EOA had its nonce set to `2^64-1`.
+
+## Backwards Compatibility
+
+This EIP requires a protocol upgrade, since it modifies consensus rules. No existing contracts should be affected, as they will not have a nonce of `2^64-1`, nor will they have the contract code `0x1`.
+
+## Security Considerations
+
+The additional gas costs may cause potential DoS attacks if they access an arbitrary contract's data or make frequent contract deactivations. Contract authors must be aware and design contracts accordingly. There may be an effect on existing deployed code performing autonomous destruction and revival.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 533a1f89140151ab620218cad89bdff55d63e692 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 10 Jan 2023 11:08:15 -0500
Subject: [PATCH 156/274] Add EIP-6190: Functional SELFDESTRUCT (#6190)

* Functional selfdestruct

* Assign EIP-6190

* Rename eip-functional-selfdestruct.md to eip-6190.md

* Add discussions url

* Add RFC 8174

* Adjust some things to make SELFDESTRUCT work a bit smoother

* Make verkle trees expected

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Add gas cost Rationale

* Add proper Rationale

* CREATE-based addresses

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-6190.md | 66 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 EIPS/eip-6190.md

diff --git a/EIPS/eip-6190.md b/EIPS/eip-6190.md
new file mode 100644
index 00000000000000..e8f5aa9bfc46f7
--- /dev/null
+++ b/EIPS/eip-6190.md
@@ -0,0 +1,66 @@
+---
+eip: 6190
+title: Functional SELFDESTRUCT
+description: Changes SELFDESTRUCT to only cause a finite number of state changes
+author: Pandapip1 (@Pandapip1), Alex Beregszaszi (@axic)
+discussions-to: https://ethereum-magicians.org/t/eip-6190-functional-selfdestruct/12232
+status: Draft
+type: Standards Track
+category: Core
+created: 2022-12-20
+requires: 2929, 6188, 6189
+---
+
+## Abstract
+
+Changes `SELFDESTRUCT` to only cause a finite number of state changes.
+
+## Motivation
+
+The `SELFDESTRUCT` instruction has a fixed price, but is unbounded in storage/account changes (it needs to delete all keys). This has been an outstanding concern for some time.
+
+Furthermore, with *Verkle trees* accounts will be organised differently. Account properties, including storage, would have individual keys. It would not be possible to traverse and find all used keys. This makes `SELFDESTRUCT` very challenging to support in Verkle trees. This EIP is a step towards supporting `SELFDESTRUCT` in Verkle trees.
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+### Prerequisites
+
+[EIP-6188](./eip-6188.md) and [EIP-6189](./eip-6189.md) must be used for this EIP to function correctly.
+
+### `SELFDESTRUCT` Behaviour
+
+Instead of destroying the contract at the end of the transaction, instead, the following will occur at the end of the transaction in which it is invoked:
+
+1. The contract's code is set to `0x1`, and its nonce is set to `2^64-1`.
+2. The contract's `0`th storage slot is set to the address that would be issued if the contract used the `CREATE` opcode (`keccak256(contractAddress, nonce)`). Note that the nonce is always `2^64-1`.
+3. If the contract was self-destructed after the call being forwarded by one or more alias contracts, the alias contract's `0`th storage slot is set to the address calculated in step 2.
+4. The contract's balance is transferred, in its entirety, to the address on the top of the stack.
+5. The top of the stack is popped.
+
+### Gas Cost of `SELFDESTRUCT`
+
+The base gas cost of `SELFDESTRUCT` is set to `5000`. The gas cost of `SELFDESTRUCT` is increased by `5000` for each alias contract that forwarded to the contract being self-destructed. Finally, the [EIP-2929](./eip-2929.md) gas cost increase is applied.
+
+## Rationale
+
+This EIP is designed to be a step towards supporting `SELFDESTRUCT` in Verkle trees while making the minimum amount of changes.
+
+The `5000` base gas cost and additional alias contracts represents the cost of setting the account nonce and first storage slot. The [EIP-2929](./eip-2929.md) gas cost increase is preserved for the reasons mentioned in said EIP's Rationale.
+
+The nonce of `2^64-1` was chosen since it is the nonce protected by [EIP-6188](./eip-6188.md). The account code of `0x1` was chosen since it was the code specified in [EIP-6189](./eip-6189.md).
+
+The address being the same as the one created by `CREATE` is designed to reduce possible attack vectors by not introducing a new mechanism by which accounts can be created at specific addresses.
+
+## Backwards Compatibility
+
+This EIP requires a protocol upgrade, since it modifies consensus rules.
+
+## Security Considerations
+
+Needs discussion.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From fc2cefa3e8e8e448c34a308e7ee19ce5a0c51e63 Mon Sep 17 00:00:00 2001
From: "5660.eth" <76733013+5660-eth@users.noreply.github.com>
Date: Wed, 11 Jan 2023 01:28:34 +0800
Subject: [PATCH 157/274] Add EIP-6147: Guard of NFT/SBT, an Extension of
 EIP-721 (#6147)

* Create eip-draft_tittle_GONS.md

* Update and rename eip-draft_tittle_GONS.md to eip-6147.md

* Update eip-6147.md

* Update eip-6147.md

* Update eip-6147.md

* Update eip-6147.md

* Update eip-6147.md

* Update eip-6147.md

* Apply suggestions from code review

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-6147.md | 289 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 289 insertions(+)
 create mode 100644 EIPS/eip-6147.md

diff --git a/EIPS/eip-6147.md b/EIPS/eip-6147.md
new file mode 100644
index 00000000000000..394dab6a54c06c
--- /dev/null
+++ b/EIPS/eip-6147.md
@@ -0,0 +1,289 @@
+---
+eip: 6147
+title: Guard of NFT/SBT, an Extension of EIP-721
+description: A new management role of NFT/SBT is defined, which realizes the separation of transfer right and holding right of NFT/SBT.
+author: 5660-eth (@5660-eth), Wizard Wang
+discussions-to: https://ethereum-magicians.org/t/guard-of-nft-sbt-an-extension-of-eip-721/12052
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-12-07
+requires: 165, 721
+---
+
+## Abstract
+
+This standard is an extension of [EIP-721](./eip-721.md). It separates the holding right and transfer right of non-fungible tokens (NFTs) and Soulbound Tokens (SBTs) and defines a new role, `guard`. The flexibility of the `guard` setting enables the design of NFT anti-theft, NFT lending, NFT leasing, SBT, etc.
+
+## Motivation
+
+NFTs are assets that have both use and financial value.
+
+Many cases of NFT theft currently exist, and current NFT anti-theft schemes, such as transferring NFTs to cold wallets, make NFTs inconvenient to be used.
+
+In current NFT lending, the NFT owner needs to transfer the NFT to the NFT lending contract, and the NFT owner no longer has the right to use the NFT while he or she has obtained the loan. In the real world, for example, if a person takes out a mortgage on his own house, he still has the right to use that house.
+
+For SBT, the current mainstream view is that an SBT is not transferable, which makes an SBT bound to an Ether address. However, when the private key of the user address is leaked or lost, retrieving SBT will become a complicated task and there is no corresponding specification. The SBTs essentially realizes the separation of NFT holding right and transfer right. When the wallet where SBT is located is stolen or unavailable, SBT should be able to be recoverable. 
+
+In addition, SBTs still need to be managed in use. For example, if a university issues diploma SBTs to its graduates, and if the university later finds that a graduate has committed academic misconduct or jeopardized the reputation of the university, it should have the ability to retrieve the diploma SBT. 
+
+
+## Specification
+
+The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY" and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
+
+EIP-721 compliant contracts MAY implement this EIP.
+
+When a token has no guard, owner, authorised operators and approved address of the token MUST have permission to set guard.
+
+When a token has no guard, `guardOf` MUST return `address(0)`.
+  
+When a token has a guard, owner, authorised operators and approved address of the token MUST NOT be able to change guard, and they MUST NOT be able to transfer the token.
+  
+When a token has a guard, `guardOf` MUST return the address of the guard.
+  
+When a token has a guard, the guard must be able to remove guard, change guard and transfer the token.
+
+When a token has a guard, if the token burns, the guard MUST be deleted.
+
+If issuing or minting SBTs, the guard MAY be uniformly set to the designated address to facilitate management. 
+
+### Contract Interface
+
+  
+```solidity
+ interface IERC6147 {
+
+    /// Logged when the guard of an NFT is changed 
+    /// @notice Emitted when  the `guard` is changed
+    /// The zero address for guard indicates that there is no guard address
+    event UpdateGuardLog(uint256 indexed tokenId,address indexed newGuard,address oldGuard);
+    
+    /// @notice  Owner, authorised operators and approved address of the NFT can set guard of the NFT and guard can modifiy guard of the NFT
+    /// If the NFT has a guard role, the owner, authorised operators and approved address of the NFT cannot modify guard
+    /// @dev The newGuard can not be zero address
+    /// Throws if `tokenId` is not valid NFT
+    /// @param tokenId The NFT to get the guard address for
+    /// @param newGuard The new guard address of the NFT
+    function changeGuard(uint256 tokenId, address newGuard) external;
+
+  
+    /// @notice Remove the guard of the NFT
+    /// Only guard can remove its own guard role
+    /// @dev The guard address is set to 0 address
+    /// Throws if `tokenId` is not valid NFT
+    /// @param tokenId The NFT to remove the guard address for
+    function removeGuard(uint256 tokenId) external;
+    
+    /// @notice Transfer the NFT and remove its guard role
+    /// @dev The NFT is transferred to `to` and the guard address is set to 0 address
+    /// Throws if `tokenId` is not valid NFT
+    /// @param from The address of the previous owner of the NFT
+    /// @param to The address of NFT recipient 
+    /// @param tokenId The NFT to get transferred for
+    function transferAndRemove(address from,address to,uint256 tokenId) external;
+
+    /// @notice Get the guard address of the NFT
+    /// @dev The zero address indicates that there is no guard
+    /// Throws if `tokenId` is not valid NFT
+    /// @param tokenId The NFT to get the guard address for
+    /// @return The guard address for the NFT
+   function guardOf(uint256 tokenId) external view returns (address);   
+}
+  
+  ```
+
+The `changeGuard(uint256 tokenId, address newGuard)` function MAY be implemented as `public` or `external`.
+
+The `removeGuard(uint256 tokenId)` function MAY be implemented as `public` or `external`.
+
+The `transferAndRemove(address from,address to,uint256 tokenId)` function MAY be implemented as `public` or `external`.
+
+The `guardOf(uint256 tokenId)` function MAY be implemented as `pure` or `view`.
+
+The `UpdateGuardLog` event MUST be emitted when a guard is changed.
+
+The `supportsInterface` method MUST return `true` when called with `0xc0655ef1`.
+
+## Rationale 
+
+### Universality
+
+There are many application scenarios for NFT/SBT, and there is no need to propose a dedicated EIP for each one, which would make the overall number of EIPS inevitably increase and add to the burden of developers. The standard is based on the analysis of the right attached to assets in the real world, and abstracts the right attached to NFT/SBT into holding right and transfer right making the standard more universal.
+
+For example, the standard has and has more than the following use cases:
+
+SBTs. The SBTs issuer can assign a uniform role of `guard` to the SBTs before they are minted, so that the SBTs cannot be transferred by the corresponding holders and can be managed by the SBTs issuer through the `guard`.
+
+NFT anti-theft. If an NFT holder sets a `guard` address of an NFT as his or her own cold wallet address, the NFT can still be used by the NFT holder, but the risk of theft is greatly reduced.
+
+NFT lending. The borrower sets the `guard` of his or her own NFT as the lender's address, the borrower still has the right to use the NFT while obtaining the loan, but at the same time cannot transfer or sell the NFT. If the borrower defaults on the loan, the lender can transfer and sell the NFT.
+
+### Simplicity
+
+Improvements to the ETH protocol should be as simple as possible. Entities should not be multiplied beyond necessity.
+
+### Extensibility
+  
+This standard only defines a `guard`, for the complex functions required by NFTs and SBTs, such as social recovery, multi-signature, expires management, according to the specific application scenarios, the `guard` can be set as a third-party protocol address, through the third-party protocol to achieve more flexible and diverse functions.
+
+### Naming
+
+The alternative names are `guardian` and `guard`, both of which basically match the permissions corresponding to the role: protection of NFT or necessary management according to its application scenarios. The `guard` has fewer characters than the `guardian` and is more concise.
+
+## Backwards Compatibility
+
+This standard can be fully EIP-721 compatible by adding an extension function set.
+
+If the NFT issued based on the above standard does not set a `guard` , then it is no different from the current NFT issued based on the EIP-721 standard.
+
+
+## Reference Implementation
+  
+```solidity
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.8;
+
+import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+import "./IERC6147.sol";
+
+abstract contract ERC721QS is ERC721, IERC6147 {
+    
+    mapping(uint256 => address) internal token_guard_map;
+
+    /// @notice Update the guard of the NFT
+    /// @dev Delete function: set guard  to 0 address,update function: set guard to new address
+    /// Throws if `tokenId` is not valid NFT
+    /// @param tokenId The NFT to update the guard address for
+    /// @param newGuard The newGuard address
+    /// @param allowNull Allow 0 address
+    function updateGuard(uint256 tokenId,address newGuard,bool allowNull) internal {
+        address guard = guardOf(tokenId);
+        if (!allowNull) {
+            require(newGuard != address(0), "New guard can not be null");
+        }
+        if (guard != address(0)) { 
+            require(guard == _msgSender(), "only guard can change it self"); 
+        } else { 
+            require(_isApprovedOrOwner(_msgSender(), tokenId),"ERC721QS: caller is not owner nor approved");
+        } 
+
+        if (guard != address(0) || newGuard != address(0)) {
+            token_guard_map[tokenId] = newGuard;
+            emit UpdateGuardLog(tokenId, newGuard, guard);
+        }
+    }
+
+    /// @notice Owner sets guard or guard modifies guard
+    /// @dev The newGuard can not be zero address
+    /// Throws if `tokenId` is not valid NFT
+    /// @param tokenId The NFT to get the guard address for
+    /// @param newGuard The new guard address of the NFT
+    function changeGuard(uint256 tokenId, address newGuard) public virtual{
+        updateGuard(tokenId, newGuard, false);
+    }
+
+    /// @notice Remove the guard of the NFT
+    /// @dev The guard address is set to 0 address
+    ///      Only guard can remove its own guard role
+    /// Throws if `tokenId` is not valid NFT
+    /// @param tokenId The NFT to remove the guard address for
+    function removeGuard(uint256 tokenId) public virtual  {
+        updateGuard(tokenId, address(0), true);
+    }
+    
+    /// @notice Transfer the NFT and remove its guard role
+    /// Throws  if `tokenId` is not valid NFT
+    /// @param  from The address of the previous owner of the NFT
+    /// @param  to The address of NFT recipient 
+    /// @param  tokenId The NFT to get transferred for
+    function transferAndRemove(address from,address to,uint256 tokenId) public virtual {
+        transferFrom(from,to,tokenId);
+        removeGuard(tokenId);
+    }
+    
+    /// @notice Get the guard address of the NFT
+    /// @dev The zero address indicates that there is no guard
+    /// Throws if `tokenId` is not valid NFT
+    /// @param tokenId The NFT to get the guard address for
+    /// @return The guard address for the NFT
+    function guardOf(uint256 tokenId) public view virtual returns (address) {
+        return token_guard_map[tokenId];
+    }
+    
+    /// @notice Check the guard address
+    /// @dev The zero address indicates there is no guard
+    /// Throws if `tokenId` is not valid NFT
+    /// @param tokenId The NFT to check the guard address for
+    /// @return The guard address
+    function checkGuard(uint256 tokenId) internal view returns (address) {
+        address guard = guardOf(tokenId);
+        address sender = _msgSender();
+        if (guard != address(0)) {
+            require(guard == sender, "sender is not guard of token");
+            return guard;
+        }else{
+            return address(0);
+        }
+    }
+
+    ///@dev When burning, delete `token_guard_map[tokenId]`
+    function _burn(uint256 tokenId) internal virtual override {
+        address guard=guardOf(tokenId);
+        super._burn(tokenId);
+        delete token_guard_map[tokenId];
+        emit UpdateGuardLog(tokenId, address(0), guard);
+    }
+ 
+    /// @dev Before transferring the NFT, need to check the gurard address
+    function transferFrom(address from,address to,uint256 tokenId) public virtual override {
+        address guard;
+        address new_from = from;
+        if (from != address(0)) {
+            guard = checkGuard(tokenId);
+            new_from = ownerOf(tokenId);
+        }
+        if (guard == address(0)) {
+            require(
+                _isApprovedOrOwner(_msgSender(), tokenId),
+                "ERC721: transfer caller is not owner nor approved"
+            );
+        }
+        _transfer(new_from, to, tokenId);
+    }
+
+    /// @dev Before safe transferring the NFT, need to check the gurard address
+    function safeTransferFrom(address from,address to,uint256 tokenId,bytes memory _data) public virtual override {
+        address guard;
+        address new_from = from;
+        if (from != address(0)) {
+            guard = checkGuard(tokenId);
+            new_from = ownerOf(tokenId);
+        }
+        if (guard == address(0)) {
+            require(
+                _isApprovedOrOwner(_msgSender(), tokenId),
+                "ERC721: transfer caller is not owner nor approved"
+            );
+        }
+        _safeTransfer(from, to, tokenId, _data);
+    }
+
+    /// @dev See {IERC165-supportsInterface}.
+    function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
+        return interfaceId == type(IERC721QS).interfaceId || super.supportsInterface(interfaceId);
+    }
+}
+
+```
+
+
+## Security Considerations
+
+When an NFT has a `guard`, even if an address is authorized as an operator through `approve` or `setApprovalForAll`, the operator still has no right to transfer the NFT.
+
+For NFT trading platforms that trade through `setApprovalForAll` + holder's signature, when an NFT has a `guard`, it cannot be traded. It is recommended to prevent such pending orders by checking the interface beforehand.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From c550c5788b5bfa48bd65ade705dd1c56fb78ae7f Mon Sep 17 00:00:00 2001
From: Francisco <frangio.1@gmail.com>
Date: Tue, 10 Jan 2023 15:55:42 -0300
Subject: [PATCH 158/274] Update EIP-5267: Move to Last Call (#6300)

* EIP-5267: Move to Last Call

* lint
---
 EIPS/eip-5267.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-5267.md b/EIPS/eip-5267.md
index e26892def69231..c0b7722ab96c9c 100644
--- a/EIPS/eip-5267.md
+++ b/EIPS/eip-5267.md
@@ -4,7 +4,8 @@ title: Retrieval of EIP-712 domain
 description: A way to describe and retrieve an EIP-712 domain to securely integrate EIP-712 signatures.
 author: Francisco Giordano (@frangio)
 discussions-to: https://ethereum-magicians.org/t/eip-5267-retrieval-of-eip-712-domain/9951
-status: Review
+status: Last Call
+last-call-deadline: 2023-01-23
 type: Standards Track
 category: ERC
 created: 2022-07-14
@@ -61,7 +62,7 @@ This is an optional extension to EIP-712 that does not introduce backwards compa
 
 Upgradeable contracts that make use of EIP-712 signatures MAY be upgraded to implement this EIP.
 
-User-agents or applications that implement this EIP SHOULD additionally support those contracts that due to their immutability cannot be upgraded to implement this EIP, by hardcoding their domain based on contract address and chain id.
+User-agents or applications that use this EIP SHOULD additionally support those contracts that due to their immutability cannot be upgraded to implement it. The simplest way to achieve this is to hardcode common domains based on contract address and chain id. However, it is also possible to implement a more general solution by guessing possible domains based on a few common patterns using the available information, and selecting the one whose hash matches a `DOMAIN_SEPARATOR` or `domainSeparator` function in the contract.
 
 ## Reference Implementation
 
@@ -171,4 +172,5 @@ Additionally, the type of the `EIP712Domain` struct needs to be extended with th
 While this EIP allows a contract to specify a `verifyingContract` other than itself, as well as a `chainId` other than that of the current chain, user-agents and applications should in general validate that these do match the contract and chain before requesting any user signatures for the domain. This may not always be a valid assumption.
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 0ede4d5d3d6a64a3f6bea2a4ed916d8a401f78d1 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Tue, 10 Jan 2023 13:10:35 -0800
Subject: [PATCH 159/274] Update EIP-5269 EIP/ERC Detection and Discovery
 (#6307)

* Update

* Update
---
 EIPS/eip-5269.md | 70 ++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 56 insertions(+), 14 deletions(-)

diff --git a/EIPS/eip-5269.md b/EIPS/eip-5269.md
index dab91003d8b624..b5e8bc62b9071d 100644
--- a/EIPS/eip-5269.md
+++ b/EIPS/eip-5269.md
@@ -1,6 +1,6 @@
 ---
 eip: 5269
-title: ERC-identifying Interface
+title: EIP/ERC Detection and Discovery
 description: An interface to identify if major behavior or optional behavior specified in an ERC is supported for a given caller.
 author: Zainan Victor Zhou (@xinbenlv)
 discussions-to: https://ethereum-magicians.org/t/erc5269-human-readable-interface-detection/9957
@@ -8,9 +8,11 @@ status: Draft
 type: Standards Track
 category: ERC
 created: 2022-07-15
+requires: 5750
 ---
 
 ## Abstract
+
 An interface that returns true or false when queried by ERC numbers, if it implement certain ERC number.
 
 ## Motivation
@@ -23,44 +25,84 @@ Here are the major differences between this EIP and [EIP-165](./eip-165.md).
 therefore it requires a method to *exist* in the first place. In some case, some ERCs interface are not represented in the way
 of method signature, such as some EIPs related to data format and signature schemes.
 2. [EIP-165](./eip-165.md) doesn't provide query ability based on caller. This EIP respond `true` or `false` based on caller.
-An example would be the OpenZeppelin has Transparency Proxy contract that behaves differently when
-ProxyAdmin calls or other user calls.
-3. Using ERC numbers improves human readability as well as make it easier to work with named contract such as ENS.
+
+
+Here is the motivation for this EIP given EIP-165 already exists:
+
+1. Using EIP/ERC numbers improves human readability as well as make it easier to work with named contract such as ENS.
+
+2. Instead of using an EIP-165 identifier, we have seen an increasing interest for using EIP/ERC numbers as the way to identify or specify a EIP/ERCs. For example
+
+- [EIP-5267](./eip-5267.md) specifies `extensions` to be a list of EIP numbers.
+- [EIP-600](./eip-600.md), [EIP-601](./eip-601.md) specifies EIP number in `m / purpose' / subpurpose' / EIP' / wallet'`
+- [EIP-5568](./eip-5568.md) specifies `The instruction_id of an instruction defined by an EIP MUST be its EIP number unless there are exceptional circumstances (be reasonable)`
+- [EIP-6120](./eip-6120.md) specifies `struct Token { uint eip; ..., }` where `uint eip` is an EIP number to identify EIPs.
+- `EIP-867`(Stagnant) proposes to create `erpId: A string identifier for this ERP (likely the associated EIP number, e.g. “EIP-1234”).`
+
+3. Having a ERC/EIP number detection interface reduces the need for a lookup table in smart contract to
+convert a function method or whole interface in any EIP/ERC in the bytes4 EIP-165 identifier into its respective EIP number and massively simplify the way to specify EIP for behavior expansion.
+
+4. We also recognize a smart contract might have different behavior given different caller. Most notable use case is that a common practice when using Transparent Upgradable Pattern is to give Admin and Non-Admin caller different treatment when calling a Proxy.
 
 ## Specification
 
+In the following description we use EIP and ERC interexchangabily. This was because while most of the time the description applies to ERC category of the Standards Track of EIP, the ERC number space is a subspace of EIP number space and we might sometimes encounter EIPs that aren't recognized as ERCs but has behavior that's worthy of queried.
+
 1. Any compliant smart contract MUST implement the following interface
 
 ```solidity
 interface IERC5269 {
-  function supportsErc(uint256 majorNumber, uint256 minorNumber, address caller) external view returns (boolean isSupported);
+  event OnSupportEIP(
+      bool state, // `true` means start supporting an EIP or some EIP behavior. `false` means stops supporting a EIP or some EIP behavior.
+      address indexed caller, // when emitted with `address(0x0)` means all callers.
+      uint256 indexed majorEIPIdentifier,
+      bytes32 indexed minorEIPIdentifier, // 0 means the entire EIP
+      bytes calldata extraData
+  );
+
+  /// @dev The core method of EIP/ERC Interface Detection
+  /// @param caller, a `address` value of the address of a caller being queried whether the given EIP is supported.
+  /// @param majorEIPIdentifier, a `uint256` value and SHOULD BE the EIP number being queried. Unless superseded by future EIP, such EIP number SHOULD BE less or equal to (0, 2^32-1]. For a function call to `supportEIP`, any value outside of this range is deemed unspecified and open to implementation's choice or for future EIPs to specify.
+  /// @param minorEIPIdentifier, a `bytes32` value reserved for authors of individual EIP to specify. For example the author of [EIP-721](./eip-721.md) MAY specify `keccak256("ERC721Metadata")` or `keccak256("ERC721Metadata.tokenURI")` as `minorEIPIdentifier` to be quired for support. Author could also use this minorEIPIdentifier to specify different versions, such as EIP-712 has its V1-V4 with different behavior.
+  /// @param extraData, a `bytes` for [EIP-5750](./eip-5750.md) for future extensions.
+  /// @returns magicWorld a bytes32 and SHOULD BE `bytes32 MAGIC_WORD = keccak256("EIP-5679")` if the contract supports an EIP and that behavior.
+  function supportEIP(
+    address caller,
+    uint256 majorEIPIdentifier,
+    bytes32 minorEIPIdentifier,
+    bytes calldata extraData)
+  external view returns (bytes32 magicWord);
 }
 ```
 
-2. `majorNumber` is the ERC number under query. `minorNumber = 0`is to reserved for the main interface.
-Other `minorNumber` is reserved for the optional interface extension of that ERC.
+In addition to the behavior specified in the comments of `IERC5269`:
 
-3. Any compliant contract that is an `IERC5629` MUST return `true` for the call of `supportsErc(5269, 0, (any caller))`.
 
-4. Any compliant standard is RECOMMENDED to declare the `minorNumber` for their optional interface extensions.
+1. Any `minorEIPIdentifier=0` is reserved to be referring to the main behavior of the EIP being queried.
+2. Authors of compliant EIP is RECOMMENDED to declare a list of `minorEIPIdentifier` for their optional interfaces, behaviors and value range for future extension.
 
-5. Any compliant contract MUST return `true` when a behavior defined in that ERC and optional interface extensions is available to a` caller`.
+3. Any compliant contract that is an `IERC5629` MUST return `MAGIC_WORD` for the call of `supportEIP((any caller), 5269, 0)`.
+4. Any compliant contract SHOULD emit a `OnSupportEIP(true, address(0), 5269, 0, [])`
+5. Any compliant contract MAY declare for easy discovery any EIP main behavior or sub-behaviors by emitting event of `OnSupportEIP` with relevant values.
 
 ## Rationale
 
-1. EIP numbers are returned in an array to reflect the practice that a smart contract usually implements more than one interface.
+1. When data type `uint256 majorEIPIdentifier`, there are other alternative options such as (1) use a hashed version of EIP number, or (2) use raw number, (3) use EIP-165 identifier. The pros for (1) is it automatically supports any evolvement of future EIP numbering/naming convention. But the cons is it's not backward readable: seeing a `hash(EIP-number)` one usually can't easily guess what EIP number is. We choose the (2) in the rationale laid out in motivation.
+2. We have a `bytes32 minorEIPIdentifier`, alternatively it could be (1) a number, forcing all EIP author to define its numbering for subbehaviors so we go with a `bytes32` and asking EIP author to use a hash for a string name for their subbehaviors which they are already doing by coming up with interface name or method name in their specification.
 
-2. We didn't require the ordering of return value. And we only suggest but didn't require deduplication because it's cheaper to do such computation outside of chain.
+3. Alternatively it's possible we add extra data as return value or an array of all EIP being supported but we are unsure how much value this complexity brings.
 
-3. Compared to [EIP-165](./eip-165.md), we also add an addition input of `address caller`, given the increasing popularity of proxy patterns such as those enabled by [EIP-1967](./eip-1967.md). One may ask: why not simply use `msg.sender`? This is because
+4. Compared to [EIP-165](./eip-165.md), we also add an addition input of `address caller`, given the increasing popularity of proxy patterns such as those enabled by [EIP-1967](./eip-1967.md). One may ask: why not simply use `msg.sender`? This is because
 we want to allow query them without transaction or a proxy contract to query if whether interface ERC-`number` will be available to
 that particular sender.
 
-4. We reserve the input `ercNumber` above 2**32 in case we need to support other collection of standards which are not ERC/EIP.
+1. We reserve the input `majorEIPIdentifier` greater than or equals 2^32 in case we need to support other collection of standards which are not ERC/EIP.
 
 ## Security Considerations
+
 Similar to [EIP-165](./eip-165.md) callers of the interface MUST assume the smart contract
 declaring they support such EIP interfaces doesn't necessarily correctly support them.
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 76323946830d577ffd775505b1f1a2bfff7cde25 Mon Sep 17 00:00:00 2001
From: Keegan Lee <keegan.lee704@gmail.com>
Date: Wed, 11 Jan 2023 11:04:45 +0800
Subject: [PATCH 160/274] Update EIP-6150: Optimize and add more implementation
 (#6308)

* Update EIP-6150: Optimize and add more implementation.

* fix `EIP-N` check
---
 EIPS/eip-6150.md                              |  2 +-
 .../contracts/{ERC-6150.sol => ERC6150.sol}   | 39 ++++++++++--
 .../contracts/ERC6150AccessControl.sol        | 62 +++++++++++++++++++
 assets/eip-6150/contracts/ERC6150Burnable.sol | 32 ++++++++++
 .../eip-6150/contracts/ERC6150Enumerable.sol  | 40 ++++++++++++
 .../contracts/ERC6150ParentTransferable.sol   | 52 ++++++++++++++++
 .../IERC6150.sol}                             | 11 +++-
 .../interfaces/IERC6150AccessControl.sol      | 47 ++++++++++++++
 .../contracts/interfaces/IERC6150Burnable.sol | 31 ++++++++++
 .../interfaces/IERC6150Enumerable.sol         | 42 +++++++++++++
 .../interfaces/IERC6150ParentTransferable.sol | 40 ++++++++++++
 11 files changed, 391 insertions(+), 7 deletions(-)
 rename assets/eip-6150/contracts/{ERC-6150.sol => ERC6150.sol} (68%)
 create mode 100644 assets/eip-6150/contracts/ERC6150AccessControl.sol
 create mode 100644 assets/eip-6150/contracts/ERC6150Burnable.sol
 create mode 100644 assets/eip-6150/contracts/ERC6150Enumerable.sol
 create mode 100644 assets/eip-6150/contracts/ERC6150ParentTransferable.sol
 rename assets/eip-6150/contracts/{IERC-6150.sol => interfaces/IERC6150.sol} (84%)
 create mode 100644 assets/eip-6150/contracts/interfaces/IERC6150AccessControl.sol
 create mode 100644 assets/eip-6150/contracts/interfaces/IERC6150Burnable.sol
 create mode 100644 assets/eip-6150/contracts/interfaces/IERC6150Enumerable.sol
 create mode 100644 assets/eip-6150/contracts/interfaces/IERC6150ParentTransferable.sol

diff --git a/EIPS/eip-6150.md b/EIPS/eip-6150.md
index 279ea7ba531057..952a36f92c6754 100644
--- a/EIPS/eip-6150.md
+++ b/EIPS/eip-6150.md
@@ -280,7 +280,7 @@ This proposal is fully backward compatible with [EIP-721](./eip-721.md).
 
 ## Reference Implementation
 
-Implementation: [EIP-6150.sol](../assets/eip-6150/contracts/ERC-6150.sol)
+Implementation: [EIP-6150](../assets/eip-6150/contracts/ERC6150.sol)
 
 ## Security Considerations
 
diff --git a/assets/eip-6150/contracts/ERC-6150.sol b/assets/eip-6150/contracts/ERC6150.sol
similarity index 68%
rename from assets/eip-6150/contracts/ERC-6150.sol
rename to assets/eip-6150/contracts/ERC6150.sol
index 11fdeb5a31c3b4..efac087ef95a1a 100644
--- a/assets/eip-6150/contracts/ERC-6150.sol
+++ b/assets/eip-6150/contracts/ERC6150.sol
@@ -1,11 +1,13 @@
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.8.0;
 
-import "./IERC-6150.sol";
+import "./interfaces/IERC6150.sol";
 import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
 
 abstract contract ERC6150 is ERC721, IERC6150 {
     mapping(uint256 => uint256) private _parentOf;
     mapping(uint256 => uint256[]) private _childrenOf;
+    mapping(uint256 => uint256) private _indexInChildrenArray;
 
     constructor(
         string memory name_,
@@ -33,7 +35,9 @@ abstract contract ERC6150 is ERC721, IERC6150 {
     function childrenOf(
         uint256 tokenId
     ) public view virtual override returns (uint256[] memory childrenIds) {
-        _requireMinted(tokenId);
+        if (tokenId > 0) {
+            _requireMinted(tokenId);
+        }
         childrenIds = _childrenOf[tokenId];
     }
 
@@ -51,6 +55,10 @@ abstract contract ERC6150 is ERC721, IERC6150 {
         return _childrenOf[tokenId].length == 0;
     }
 
+    function _getIndexInChildrenArray(uint256 tokenId) internal view virtual {
+        return _indexInChildrenArray[tokenId];
+    }
+
     function _safeBatchMintWithParent(
         address to,
         uint256 parentId,
@@ -72,7 +80,7 @@ abstract contract ERC6150 is ERC721, IERC6150 {
     ) internal virtual {
         require(
             tokenIds.length == datas.length,
-            "EIP6150: tokenIds.length != datas.length"
+            "ERC6150: tokenIds.length != datas.length"
         );
         for (uint256 i = 0; i < tokenIds.length; i++) {
             _safeMintWithParent(to, parentId, tokenIds[i], datas[i]);
@@ -93,13 +101,14 @@ abstract contract ERC6150 is ERC721, IERC6150 {
         uint256 tokenId,
         bytes memory data
     ) internal virtual {
-        require(tokenId > 0, "EIP6150: tokenId is zero");
+        require(tokenId > 0, "ERC6150: tokenId is zero");
         if (parentId != 0)
-            require(_exists(parentId), "EIP6150: parentId doesn't exists");
+            require(_exists(parentId), "ERC6150: parentId doesn't exist");
 
         _beforeMintWithParent(to, parentId, tokenId);
 
         _parentOf[tokenId] = parentId;
+        _indexInChildrenArray[tokenId] = _childrenOf.length;
         _childrenOf[parentId].push(tokenId);
 
         _safeMint(to, tokenId, data);
@@ -108,6 +117,26 @@ abstract contract ERC6150 is ERC721, IERC6150 {
         _afterMintWithParent(to, parentId, tokenId);
     }
 
+    function _safeBurn(uint256 tokenId) internal virtual {
+        require(_exists(tokenId), "ERC6150: tokenId doesn't exist");
+        require(isLeaf(tokenId), "ERC6150: tokenId is not a leaf");
+
+        uint256 parent = _parentOf[tokenId];
+        uint256 lastTokenIndex = _childrenOf[parent].length - 1;
+        uint256 targetTokenIndex = _indexInChildrenArray[tokenId];
+        uint256 lastIndexToken = _childrenOf[parent][lastTokenIndex];
+        if (lastTokenIndex > targetTokenIndex) {
+            _childrenOf[parent][targetTokenIndex] = lastIndexToken;
+            _indexInChildrenArray[lastIndexToken] = targetTokenIndex;
+        }
+
+        delete _childrenOf[parent][lastIndexToken];
+        delete _indexInChildrenArray[tokenId];
+        delete _parentOf[tokenId];
+
+        _burn(tokenId);
+    }
+
     function _beforeMintWithParent(
         address to,
         uint256 parentId,
diff --git a/assets/eip-6150/contracts/ERC6150AccessControl.sol b/assets/eip-6150/contracts/ERC6150AccessControl.sol
new file mode 100644
index 00000000000000..7182e374b395cf
--- /dev/null
+++ b/assets/eip-6150/contracts/ERC6150AccessControl.sol
@@ -0,0 +1,62 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "./ERC6150.sol";
+import "./interfaces/IERC6150AccessControl.sol";
+
+abstract contract ERC6150AccessControl is ERC6150, IERC6150AccessControl {
+    mapping(address => mapping(uint256 => bool)) private _isAdminOf;
+
+    /**
+     * @dev See {IERC165-supportsInterface}.
+     */
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual override(IERC165, ERC6150) returns (bool) {
+        return
+            interfaceId == type(IERC6150AccessControl).interfaceId ||
+            super.supportsInterface(interfaceId);
+    }
+
+    function isAdminOf(
+        uint256 tokenId,
+        address account
+    ) public view virtual override returns (bool) {
+        return _isAdminOf[account][tokenId];
+    }
+
+    function canMintChildren(
+        uint256 parentId,
+        address account
+    ) public view virtual override returns (bool) {
+        return isAdminOf(parentId, account);
+    }
+
+    function canBurnTokenByAccount(
+        uint256 tokenId,
+        address account
+    ) public view virtual override returns (bool) {
+        require(isLeaf(tokenId), "not a leaf token");
+        return isAdminOf(tokenId, account);
+    }
+
+    function _afterMintWithParent(
+        address to,
+        uint256 parentId,
+        uint256 tokenId
+    ) internal virtual override {
+        _isAdminOf[to][tokenId] = true;
+    }
+
+    function _addAdmin(address admin, uint256 tokenId) internal virtual {
+        require(admin != address(0), "zero address");
+        require(_exists(tokenId), "tokenId doesn't exist");
+        _isAdminOf[admin][tokenId] = true;
+    }
+
+    function _removeAdmin(address admin, uint256 tokenId) internal virtual {
+        require(_isAdminOf[admin][tokenId] == true, "not an admin");
+        require(admin != ownerOf(tokenId), "cannot remove owner");
+        _isAdminOf[admin][tokenId] = false;
+    }
+}
diff --git a/assets/eip-6150/contracts/ERC6150Burnable.sol b/assets/eip-6150/contracts/ERC6150Burnable.sol
new file mode 100644
index 00000000000000..34f0d1eea77f33
--- /dev/null
+++ b/assets/eip-6150/contracts/ERC6150Burnable.sol
@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "./ERC6150.sol";
+import "./interfaces/IERC6150Burnable.sol";
+
+abstract contract ERC6150Burnable is ERC6150, IERC6150Burnable {
+    /**
+     * @dev See {IERC165-supportsInterface}.
+     */
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual override(IERC165, ERC6150) returns (bool) {
+        return
+            interfaceId == type(IERC6150Burnable).interfaceId ||
+            super.supportsInterface(interfaceId);
+    }
+
+    function safeBurn(uint256 tokenId) public virtual override {
+        require(
+            _isApprovedOrOwner(_msgSender(), tokenId),
+            "ERC6150Burnable: caller is neither token owner nor approved"
+        );
+        _safeBurn(tokenId);
+    }
+
+    function safeBatchBurn(uint256[] memory tokenIds) public virtual override {
+        for (uint256 i = 0; i < tokenIds.length; i++) {
+            safeBurn(tokenIds[i]);
+        }
+    }
+}
diff --git a/assets/eip-6150/contracts/ERC6150Enumerable.sol b/assets/eip-6150/contracts/ERC6150Enumerable.sol
new file mode 100644
index 00000000000000..02751de61cf76f
--- /dev/null
+++ b/assets/eip-6150/contracts/ERC6150Enumerable.sol
@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "./ERC6150.sol";
+import "./interfaces/IERC6150Enumerable.sol";
+
+abstract contract ERC6150Enumerable is ERC6150, IERC6150Enumerable {
+    /**
+     * @dev See {IERC165-supportsInterface}.
+     */
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual override(IERC165, ERC6150) returns (bool) {
+        return
+            interfaceId == type(IERC6150Enumerable).interfaceId ||
+            super.supportsInterface(interfaceId);
+    }
+
+    function childrenCountOf(
+        uint256 parentId
+    ) external view virtual override returns (uint256) {
+        return childrenOf(parentId).length;
+    }
+
+    function childOfParentByIndex(
+        uint256 parentId,
+        uint256 index
+    ) external view virtual override returns (uint256) {
+        uint256[] memory children = childrenOf(parentId);
+        return children[index];
+    }
+
+    function indexInChildrenEnumeration(
+        uint256 parentId,
+        uint256 tokenId
+    ) external view virtual override returns (uint256) {
+        require(parentOf(tokenId) == parentId, "wrong parent");
+        return _getIndexInChildrenArray(tokenId);
+    }
+}
diff --git a/assets/eip-6150/contracts/ERC6150ParentTransferable.sol b/assets/eip-6150/contracts/ERC6150ParentTransferable.sol
new file mode 100644
index 00000000000000..bb97f35a66bdfc
--- /dev/null
+++ b/assets/eip-6150/contracts/ERC6150ParentTransferable.sol
@@ -0,0 +1,52 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "./ERC6150.sol";
+import "./interfaces/IERC6150ParentTransferable.sol";
+
+abstract contract ERC6150ParentTransferable is
+    ERC6150,
+    IERC6150ParentTransferable
+{
+    /**
+     * @dev See {IERC165-supportsInterface}.
+     */
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual override(IERC165, ERC6150) returns (bool) {
+        return
+            interfaceId == type(IERC6150ParentTransferable).interfaceId ||
+            super.supportsInterface(interfaceId);
+    }
+
+    function transferParent(
+        uint256 newParentId,
+        uint256 tokenId
+    ) public virtual override {
+        require(
+            _isApprovedOrOwner(_msgSender(), tokenId),
+            "ERC6150ParentTransferable: caller is not token owner nor approved"
+        );
+        if (newParentId != 0) {
+            require(
+                _exists(newParentId),
+                "ERC6150ParentTransferable: newParentId doesn't exists"
+            );
+        }
+
+        uint256 owner = ownerOf(tokenId);
+        uint256 oldParentId = parentOf[tokenId];
+        _safeBurn(tokenId);
+        _safeMintWithParent(owner, newParentId, tokenId);
+        emit ParentTransferred(tokenId, oldParentId, newParantId);
+    }
+
+    function batchTransferParent(
+        uint256 newParentId,
+        uint256[] memory tokenIds
+    ) public virtual override {
+        for (uint256 i = 0; i < tokenIds.length; i++) {
+            transferParent(tokenIds[i], newParentId);
+        }
+    }
+}
diff --git a/assets/eip-6150/contracts/IERC-6150.sol b/assets/eip-6150/contracts/interfaces/IERC6150.sol
similarity index 84%
rename from assets/eip-6150/contracts/IERC-6150.sol
rename to assets/eip-6150/contracts/interfaces/IERC6150.sol
index d4830852a9b425..7da6ed559a868d 100644
--- a/assets/eip-6150/contracts/IERC-6150.sol
+++ b/assets/eip-6150/contracts/interfaces/IERC6150.sol
@@ -1,6 +1,15 @@
+// SPDX-License-Identifier: CC0-1.0
 pragma solidity ^0.8.0;
 
-interface IERC6150 /* is IERC721, IERC165 */ {
+import "IERC721.sol";
+import "IERC165.sol";
+
+/**
+ * @title ERC-6150 Hierarchical NFTs Token Standard
+ * @dev See https://eips.ethereum.org/EIPS/eip-6150
+ * Note: the ERC-165 identifier for this interface is 0x897e2c73.
+ */
+interface IERC6150 is IERC721, IERC165 {
     /**
      * @notice Emitted when `tokenId` token under `parentId` is minted.
      * @param minter The address of minter
diff --git a/assets/eip-6150/contracts/interfaces/IERC6150AccessControl.sol b/assets/eip-6150/contracts/interfaces/IERC6150AccessControl.sol
new file mode 100644
index 00000000000000..661679d446dd08
--- /dev/null
+++ b/assets/eip-6150/contracts/interfaces/IERC6150AccessControl.sol
@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "./IERC6150.sol";
+
+/**
+ * @title ERC-6150 Hierarchical NFTs Token Standard, optional extension for access control
+ * @dev See https://eips.ethereum.org/EIPS/eip-6150
+ * Note: the ERC-165 identifier for this interface is 0x1d04f0b3.
+ */
+interface IERC6150AccessControl is IERC6150 {
+    /**
+     * @notice Check the account whether a admin of `tokenId` token.
+     * @dev Each token can be set more than one admin. Admin have permission to do something to the token, like mint child token,
+     * or burn token, or transfer parentship.
+     * @param tokenId The specified token
+     * @param account The account to be checked
+     * @return If the account has admin permission, return true; otherwise, return false.
+     */
+    function isAdminOf(
+        uint256 tokenId,
+        address account
+    ) external view returns (bool);
+
+    /**
+     * @notice Check whether the specified parent token and account can mint children tokens
+     * @dev If the `parentId` is zero, check whether account can mint root nodes
+     * @param parentId The specified parent token to be checked
+     * @param account The specified account to be checked
+     * @return If the token and account has mint permission, return true; otherwise, return false.
+     */
+    function canMintChildren(
+        uint256 parentId,
+        address account
+    ) external view returns (bool);
+
+    /**
+     * @notice Check whether the specified token can be burnt by specified account
+     * @param tokenId The specified token to be checked
+     * @param account The specified account to be checked
+     * @return If the tokenId can be burnt by account, return true; otherwise, return false.
+     */
+    function canBurnTokenByAccount(
+        uint256 tokenId,
+        address account
+    ) external view returns (bool);
+}
diff --git a/assets/eip-6150/contracts/interfaces/IERC6150Burnable.sol b/assets/eip-6150/contracts/interfaces/IERC6150Burnable.sol
new file mode 100644
index 00000000000000..5cb8c9a302e0e9
--- /dev/null
+++ b/assets/eip-6150/contracts/interfaces/IERC6150Burnable.sol
@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "./IERC6150.sol";
+
+/**
+ * @title ERC-6150 Hierarchical NFTs Token Standard, optional extension for burnable
+ * @dev See https://eips.ethereum.org/EIPS/eip-6150
+ * Note: the ERC-165 identifier for this interface is 0x4ac0aa46.
+ */
+interface IERC6150Burnable is IERC6150 {
+    /**
+     * @notice Burn the `tokenId` token.
+     * @dev Throws if `tokenId` is not a leaf token.
+     * Throws if `tokenId` is not a valid NFT.
+     * Throws if `owner` is not the owner of `tokenId` token.
+     * Throws unless `msg.sender` is the current owner, an authorized operator, or the approved address for this token.
+     * @param tokenId The token to be burnt
+     */
+    function safeBurn(uint256 tokenId) external;
+
+    /**
+     * @notice Batch burn tokens.
+     * @dev Throws if one of `tokenIds` is not a leaf token.
+     * Throws if one of `tokenIds` is not a valid NFT.
+     * Throws if `owner` is not the owner of all `tokenIds` tokens.
+     * Throws unless `msg.sender` is the current owner, an authorized operator, or the approved address for all `tokenIds`.
+     * @param tokenIds The tokens to be burnt
+     */
+    function safeBatchBurn(uint256[] memory tokenIds) external;
+}
diff --git a/assets/eip-6150/contracts/interfaces/IERC6150Enumerable.sol b/assets/eip-6150/contracts/interfaces/IERC6150Enumerable.sol
new file mode 100644
index 00000000000000..030e4d9b3dbdb4
--- /dev/null
+++ b/assets/eip-6150/contracts/interfaces/IERC6150Enumerable.sol
@@ -0,0 +1,42 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "./IERC6150.sol";
+import "IERC721Enumerable.sol";
+
+/**
+ * @title ERC-6150 Hierarchical NFTs Token Standard, optional extension for enumerable
+ * @dev See https://eips.ethereum.org/EIPS/eip-6150
+ * Note: the ERC-165 identifier for this interface is 0xba541a2e.
+ */
+interface IERC6150Enumerable is IERC6150, IERC721Enumerable {
+    /**
+     * @notice Get total amount of children tokens under `parentId` token.
+     * @dev If `parentId` is zero, it means get total amount of root tokens.
+     * @return The total amount of children tokens under `parentId` token.
+     */
+    function childrenCountOf(uint256 parentId) external view returns (uint256);
+
+    /**
+     * @notice Get the token at the specified index of all children tokens under `parentId` token.
+     * @dev If `parentId` is zero, it means get root token.
+     * @return The token ID at `index` of all chlidren tokens under `parentId` token.
+     */
+    function childOfParentByIndex(
+        uint256 parentId,
+        uint256 index
+    ) external view returns (uint256);
+
+    /**
+     * @notice Get the index position of specified token in the children enumeration under specified parent token.
+     * @dev Throws if the `tokenId` is not found in the children enumeration.
+     * If `parentId` is zero, means get root token index.
+     * @param parentId The parent token
+     * @param tokenId The specified token to be found
+     * @return The index position of `tokenId` found in the children enumeration
+     */
+    function indexInChildrenEnumeration(
+        uint256 parentId,
+        uint256 tokenId
+    ) external view returns (uint256);
+}
diff --git a/assets/eip-6150/contracts/interfaces/IERC6150ParentTransferable.sol b/assets/eip-6150/contracts/interfaces/IERC6150ParentTransferable.sol
new file mode 100644
index 00000000000000..2ecfa97f61dce0
--- /dev/null
+++ b/assets/eip-6150/contracts/interfaces/IERC6150ParentTransferable.sol
@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "./IERC6150.sol";
+
+/**
+ * @title ERC-6150 Hierarchical NFTs Token Standard, optional extension for parent transferable
+ * @dev See https://eips.ethereum.org/EIPS/eip-6150
+ * Note: the ERC-165 identifier for this interface is 0xfa574808.
+ */
+interface IERC6150ParentTransferable is IERC6150 {
+    /**
+     * @notice Emitted when the parent of `tokenId` token changed.
+     * @param tokenId The token changed
+     * @param oldParentId Previous parent token
+     * @param newParentId New parent token
+     */
+    event ParentTransferred(
+        uint256 tokenId,
+        uint256 oldParentId,
+        uint256 newParentId
+    );
+
+    /**
+     * @notice Transfer parentship of `tokenId` token to a new parent token
+     * @param newParentId New parent token id
+     * @param tokenId The token to be changed
+     */
+    function transferParent(uint256 newParentId, uint256 tokenId) external;
+
+    /**
+     * @notice Batch transfer parentship of `tokenIds` to a new parent token
+     * @param newParentId New parent token id
+     * @param tokenIds Array of token ids to be changed
+     */
+    function batchTransferParent(
+        uint256 newParentId,
+        uint256[] memory tokenIds
+    ) external;
+}

From 5cb167fe34d41993992cf936d8ccacf5d3de112f Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 11 Jan 2023 13:52:36 -0500
Subject: [PATCH 161/274] Update EIP-6190: Rename to verkle-compatible
 SELFDESTRUCT (#6313)

---
 EIPS/eip-6190.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6190.md b/EIPS/eip-6190.md
index e8f5aa9bfc46f7..90fddc4871cfa4 100644
--- a/EIPS/eip-6190.md
+++ b/EIPS/eip-6190.md
@@ -1,6 +1,6 @@
 ---
 eip: 6190
-title: Functional SELFDESTRUCT
+title: Verkle-compatible SELFDESTRUCT
 description: Changes SELFDESTRUCT to only cause a finite number of state changes
 author: Pandapip1 (@Pandapip1), Alex Beregszaszi (@axic)
 discussions-to: https://ethereum-magicians.org/t/eip-6190-functional-selfdestruct/12232

From 57a14f9fb9982894f81248046d2e45d2ecfdf14e Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Wed, 11 Jan 2023 10:56:41 -0800
Subject: [PATCH 162/274] Update EIP-5629 about DRAFT identifier (#6312)

* Update

* Update

* Move to review

* Update

* Update

* update

* update
---
 EIPS/eip-5269.md | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/EIPS/eip-5269.md b/EIPS/eip-5269.md
index b5e8bc62b9071d..65d78dadf77369 100644
--- a/EIPS/eip-5269.md
+++ b/EIPS/eip-5269.md
@@ -46,17 +46,17 @@ convert a function method or whole interface in any EIP/ERC in the bytes4 EIP-16
 
 ## Specification
 
-In the following description we use EIP and ERC interexchangabily. This was because while most of the time the description applies to ERC category of the Standards Track of EIP, the ERC number space is a subspace of EIP number space and we might sometimes encounter EIPs that aren't recognized as ERCs but has behavior that's worthy of queried.
+In the following description we use EIP and ERC inter-exchangebly. This was because while most of the time the description applies to ERC category of the Standards Track of EIP, the ERC number space is a subspace of EIP number space and we might sometimes encounter EIPs that aren't recognized as ERCs but has behavior that's worthy of queried.
 
 1. Any compliant smart contract MUST implement the following interface
 
 ```solidity
 interface IERC5269 {
   event OnSupportEIP(
-      bool state, // `true` means start supporting an EIP or some EIP behavior. `false` means stops supporting a EIP or some EIP behavior.
       address indexed caller, // when emitted with `address(0x0)` means all callers.
       uint256 indexed majorEIPIdentifier,
       bytes32 indexed minorEIPIdentifier, // 0 means the entire EIP
+      bytes32 eipStatus,
       bytes calldata extraData
   );
 
@@ -65,30 +65,38 @@ interface IERC5269 {
   /// @param majorEIPIdentifier, a `uint256` value and SHOULD BE the EIP number being queried. Unless superseded by future EIP, such EIP number SHOULD BE less or equal to (0, 2^32-1]. For a function call to `supportEIP`, any value outside of this range is deemed unspecified and open to implementation's choice or for future EIPs to specify.
   /// @param minorEIPIdentifier, a `bytes32` value reserved for authors of individual EIP to specify. For example the author of [EIP-721](./eip-721.md) MAY specify `keccak256("ERC721Metadata")` or `keccak256("ERC721Metadata.tokenURI")` as `minorEIPIdentifier` to be quired for support. Author could also use this minorEIPIdentifier to specify different versions, such as EIP-712 has its V1-V4 with different behavior.
   /// @param extraData, a `bytes` for [EIP-5750](./eip-5750.md) for future extensions.
-  /// @returns magicWorld a bytes32 and SHOULD BE `bytes32 MAGIC_WORD = keccak256("EIP-5679")` if the contract supports an EIP and that behavior.
+  /// @returns eipStatus a bytes32 indicating the status of EIP the contract supports.
+  ///                    - For FINAL EIPs, it MUST return `keccak256("FINAL")`.
+  ///                    - For non-FINAL EIPs, it SHOULD return `keccak256("DRAFT")`.
+  ///                      During EIP procedure, EIP authors are allowed to specify their own
+  ///                      eipStatus other than `FINAL` or `DRAFT` at their discretion such as `keccak256("DRAFTv1")`
+  ///                      or `keccak256("DRAFT-option1")`and such value of eipStatus MUST be documented in the EIP body
   function supportEIP(
     address caller,
     uint256 majorEIPIdentifier,
     bytes32 minorEIPIdentifier,
     bytes calldata extraData)
-  external view returns (bytes32 magicWord);
+  external view returns (bytes32 eipStatus);
 }
 ```
 
 In addition to the behavior specified in the comments of `IERC5269`:
 
-
 1. Any `minorEIPIdentifier=0` is reserved to be referring to the main behavior of the EIP being queried.
 2. Authors of compliant EIP is RECOMMENDED to declare a list of `minorEIPIdentifier` for their optional interfaces, behaviors and value range for future extension.
+3. When this EIP is FINAL, any compliant contract that is an `IERC5629` MUST return `keccak256("FINAL")` for the call of `supportEIP((any caller), 5269, 0, [])`.
+
+*Note*: at the current snapshot, `supportEIP((any caller), 5269, 0, [])` MUST return `keccak256("DRAFT")`.
 
-3. Any compliant contract that is an `IERC5629` MUST return `MAGIC_WORD` for the call of `supportEIP((any caller), 5269, 0)`.
 4. Any compliant contract SHOULD emit a `OnSupportEIP(true, address(0), 5269, 0, [])`
 5. Any compliant contract MAY declare for easy discovery any EIP main behavior or sub-behaviors by emitting event of `OnSupportEIP` with relevant values.
+6. For any `EIP-XXX` that is NOT in `Final` status, when querying `supportEIP((any caller), xxx, (any minor identifier), [])`, it MUST NOT return `keccak256("FINAL")`.
+7. The `supportEIP` MUST be `view`, ie. it MUST NOT mutate any global state of EVM.
 
 ## Rationale
 
 1. When data type `uint256 majorEIPIdentifier`, there are other alternative options such as (1) use a hashed version of EIP number, or (2) use raw number, (3) use EIP-165 identifier. The pros for (1) is it automatically supports any evolvement of future EIP numbering/naming convention. But the cons is it's not backward readable: seeing a `hash(EIP-number)` one usually can't easily guess what EIP number is. We choose the (2) in the rationale laid out in motivation.
-2. We have a `bytes32 minorEIPIdentifier`, alternatively it could be (1) a number, forcing all EIP author to define its numbering for subbehaviors so we go with a `bytes32` and asking EIP author to use a hash for a string name for their subbehaviors which they are already doing by coming up with interface name or method name in their specification.
+2. We have a `bytes32 minorEIPIdentifier`, alternatively it could be (1) a number, forcing all EIP author to define its numbering for sub-behaviors so we go with a `bytes32` and asking EIP author to use a hash for a string name for their sub-behaviors which they are already doing by coming up with interface name or method name in their specification.
 
 3. Alternatively it's possible we add extra data as return value or an array of all EIP being supported but we are unsure how much value this complexity brings.
 

From 118a5a0e9c1956a909e43d8749ff140a4e05468a Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Wed, 11 Jan 2023 22:14:48 -0800
Subject: [PATCH 163/274] Update EIP-5269 (#6316)

* Update

* Update

* Move to review

* Update

* Update

* update

* update

* Add RefImpl

* Fix

* Update

* Update

* Update

* Update

* Update
---
 EIPS/eip-5269.md | 161 +++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 155 insertions(+), 6 deletions(-)

diff --git a/EIPS/eip-5269.md b/EIPS/eip-5269.md
index 65d78dadf77369..d10af7da99eb9f 100644
--- a/EIPS/eip-5269.md
+++ b/EIPS/eip-5269.md
@@ -13,7 +13,16 @@ requires: 5750
 
 ## Abstract
 
-An interface that returns true or false when queried by ERC numbers, if it implement certain ERC number.
+An interface for better identification and detection of EIP/ERC by numbers.
+
+It designate a field in which it's called `majorEIPIdentifier` which is normally known or referred to as "EIP number". For example, `ERC-721` aka [EIP-721](./eip-721.md) has a `majorEIPIdentifier = 721`. This EIP has a `majorEIPIdentifier = 5269`.
+Calling it as "majorEIPIdentifier" instead of EIP number to make it future proof: anticipating there is a possibility where future EIP is not numbered or if we want to
+incorporate other type of standards.
+It also proposes a new concept of `minorEIPIdentifier` which is left for authors of
+individual EIP to define. For example, EIP-721's author may define `ERC721Metadata`
+interface as `minorEIPIdentifier= keccak256("ERC721Metadata")`.
+
+It also proposes an event to allow contract to optionally declare EIPs they support.
 
 ## Motivation
 
@@ -51,21 +60,24 @@ In the following description we use EIP and ERC inter-exchangebly. This was beca
 1. Any compliant smart contract MUST implement the following interface
 
 ```solidity
+// DRAFTv1
+pragma solidity ^0.8.9;
+
 interface IERC5269 {
   event OnSupportEIP(
       address indexed caller, // when emitted with `address(0x0)` means all callers.
       uint256 indexed majorEIPIdentifier,
       bytes32 indexed minorEIPIdentifier, // 0 means the entire EIP
       bytes32 eipStatus,
-      bytes calldata extraData
+      bytes extraData
   );
 
   /// @dev The core method of EIP/ERC Interface Detection
   /// @param caller, a `address` value of the address of a caller being queried whether the given EIP is supported.
   /// @param majorEIPIdentifier, a `uint256` value and SHOULD BE the EIP number being queried. Unless superseded by future EIP, such EIP number SHOULD BE less or equal to (0, 2^32-1]. For a function call to `supportEIP`, any value outside of this range is deemed unspecified and open to implementation's choice or for future EIPs to specify.
-  /// @param minorEIPIdentifier, a `bytes32` value reserved for authors of individual EIP to specify. For example the author of [EIP-721](./eip-721.md) MAY specify `keccak256("ERC721Metadata")` or `keccak256("ERC721Metadata.tokenURI")` as `minorEIPIdentifier` to be quired for support. Author could also use this minorEIPIdentifier to specify different versions, such as EIP-712 has its V1-V4 with different behavior.
-  /// @param extraData, a `bytes` for [EIP-5750](./eip-5750.md) for future extensions.
-  /// @returns eipStatus a bytes32 indicating the status of EIP the contract supports.
+  /// @param minorEIPIdentifier, a `bytes32` value reserved for authors of individual EIP to specify. For example the author of [EIP-721](/EIPS/eip-721) MAY specify `keccak256("ERC721Metadata")` or `keccak256("ERC721Metadata.tokenURI")` as `minorEIPIdentifier` to be quired for support. Author could also use this minorEIPIdentifier to specify different versions, such as EIP-712 has its V1-V4 with different behavior.
+  /// @param extraData, a `bytes` for [EIP-5750](/EIPS/eip-5750) for future extensions.
+  /// @return eipStatus a bytes32 indicating the status of EIP the contract supports.
   ///                    - For FINAL EIPs, it MUST return `keccak256("FINAL")`.
   ///                    - For non-FINAL EIPs, it SHOULD return `keccak256("DRAFT")`.
   ///                      During EIP procedure, EIP authors are allowed to specify their own
@@ -104,7 +116,144 @@ In addition to the behavior specified in the comments of `IERC5269`:
 we want to allow query them without transaction or a proxy contract to query if whether interface ERC-`number` will be available to
 that particular sender.
 
-1. We reserve the input `majorEIPIdentifier` greater than or equals 2^32 in case we need to support other collection of standards which are not ERC/EIP.
+5. We reserve the input `majorEIPIdentifier` greater than or equals 2^32 in case we need to support other collection of standards which are not ERC/EIP.
+
+## Test Cases
+
+Here is an example of test cases.
+See Reference Implementation section for a reference implementation being tested.
+
+```typescript
+
+describe("ERC5269", function () {
+  async function deployFixture() {
+    // ...
+  }
+
+  describe("Deployment", function () {
+    // ...
+    it("Should emit proper OnSupportEIP events", async function () {
+      let { txDeployErc721 } = await loadFixture(deployFixture);
+      let events = txDeployErc721.events?.filter(event => event.event === 'OnSupportEIP');
+      expect(events).to.have.lengthOf(4);
+
+      let ev5269 = events!.filter(
+        (event) => event.args!.majorEIPIdentifier.eq(5269));
+      expect(ev5269).to.have.lengthOf(1);
+      expect(ev5269[0].args!.caller).to.equal(BigNumber.from(0));
+      expect(ev5269[0].args!.minorEIPIdentifier).to.equal(BigNumber.from(0));
+      expect(ev5269[0].args!.eipStatus).to.equal(ethers.utils.id("DRAFTv1"));
+
+      let ev721 = events!.filter(
+        (event) => event.args!.majorEIPIdentifier.eq(721));
+      expect(ev721).to.have.lengthOf(3);
+      expect(ev721[0].args!.caller).to.equal(BigNumber.from(0));
+      expect(ev721[0].args!.minorEIPIdentifier).to.equal(BigNumber.from(0));
+      expect(ev721[0].args!.eipStatus).to.equal(ethers.utils.id("FINAL"));
+
+      expect(ev721[1].args!.caller).to.equal(BigNumber.from(0));
+      expect(ev721[1].args!.minorEIPIdentifier).to.equal(ethers.utils.id("ERC721Metadata"));
+      expect(ev721[1].args!.eipStatus).to.equal(ethers.utils.id("FINAL"));
+
+      // ...
+    });
+
+    it("Should return proper eipStatus value when called supportEIP() for declared supported EIP/features", async function () {
+      let { erc721ForTesting, owner } = await loadFixture(deployFixture);
+      expect(await erc721ForTesting.supportEIP(owner.address, 5269, ethers.utils.hexZeroPad("0x00", 32), [])).to.equal(ethers.utils.id("DRAFTv1"));
+      expect(await erc721ForTesting.supportEIP(owner.address, 721, ethers.utils.hexZeroPad("0x00", 32), [])).to.equal(ethers.utils.id("FINAL"));
+      expect(await erc721ForTesting.supportEIP(owner.address, 721, ethers.utils.id("ERC721Metadata"), [])).to.equal(ethers.utils.id("FINAL"));
+      // ...
+
+      expect(await erc721ForTesting.supportEIP(owner.address, 721, ethers.utils.id("WRONG FEATURE"), [])).to.equal(BigNumber.from(0));
+      expect(await erc721ForTesting.supportEIP(owner.address, 9999, ethers.utils.hexZeroPad("0x00", 32), [])).to.equal(BigNumber.from(0));
+    });
+
+    it("Should return zero as eipStatus value when called supportEIP() for non declared EIP/features", async function () {
+      let { erc721ForTesting, owner } = await loadFixture(deployFixture);
+      expect(await erc721ForTesting.supportEIP(owner.address, 721, ethers.utils.id("WRONG FEATURE"), [])).to.equal(BigNumber.from(0));
+      expect(await erc721ForTesting.supportEIP(owner.address, 9999, ethers.utils.hexZeroPad("0x00", 32), [])).to.equal(BigNumber.from(0));
+    });
+  });
+});
+```
+
+## Reference Implementation
+
+Here is a reference implementation for this EIP:
+
+```solidity
+
+contract ERC5269 is IERC5269 {
+    bytes32 constant public EIP_STATUS = keccak256("DRAFTv1");
+    constructor () {
+        emit OnSupportEIP(address(0x0), 5269, bytes32(0), EIP_STATUS, "");
+    }
+
+    function _supportEIP(
+        address /*caller*/,
+        uint256 majorEIPIdentifier,
+        bytes32 minorEIPIdentifier,
+        bytes calldata /*extraData*/)
+    internal virtual view returns (bytes32 eipStatus) {
+        if (majorEIPIdentifier == 5269) {
+            if (minorEIPIdentifier == bytes32(0)) {
+                return EIP_STATUS;
+            }
+        }
+        return bytes32(0);
+    }
+
+    function supportEIP(
+        address caller,
+        uint256 majorEIPIdentifier,
+        bytes32 minorEIPIdentifier,
+        bytes calldata extraData)
+    external virtual view returns (bytes32 eipStatus) {
+        return _supportEIP(caller, majorEIPIdentifier, minorEIPIdentifier, extraData);
+    }
+}
+```
+
+Here is an example where a contract of [EIP-721](./eip-721.md) also implement this EIP to make it easier
+to detect and discover:
+
+```solidity
+import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+import "../ERC5269.sol";
+contract ERC721ForTesting is ERC721, ERC5269 {
+
+    bytes32 constant public EIP_FINAL = keccak256("FINAL");
+    constructor() ERC721("ERC721ForTesting", "E721FT") ERC5269() {
+        _mint(msg.sender, 0);
+        emit OnSupportEIP(address(0x0), 721, bytes32(0), EIP_FINAL, "");
+        emit OnSupportEIP(address(0x0), 721, keccak256("ERC721Metadata"), EIP_FINAL, "");
+        emit OnSupportEIP(address(0x0), 721, keccak256("ERC721Enumerable"), EIP_FINAL, "");
+    }
+
+  function supportEIP(
+    address caller,
+    uint256 majorEIPIdentifier,
+    bytes32 minorEIPIdentifier,
+    bytes calldata extraData)
+  external
+  override
+  view
+  returns (bytes32 eipStatus) {
+    if (majorEIPIdentifier == 721) {
+      if (minorEIPIdentifier == 0) {
+        return keccak256("FINAL");
+      } else if (minorEIPIdentifier == keccak256("ERC721Metadata")) {
+        return keccak256("FINAL");
+      } else if (minorEIPIdentifier == keccak256("ERC721Enumerable")) {
+        return keccak256("FINAL");
+      }
+    }
+    return super._supportEIP(caller, majorEIPIdentifier, minorEIPIdentifier, extraData);
+  }
+}
+
+```
 
 ## Security Considerations
 

From 1df2353b14dd0860d3d0a8deddf4d03707b8be7d Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Wed, 11 Jan 2023 22:37:02 -0800
Subject: [PATCH 164/274] Add asset file for EIP-5269 (#6317)

* Add asset file for eip-5269

* Add asset file for eip-5269
---
 EIPS/eip-5269.md                              |  2 +-
 assets/eip-5269/contracts/ERC5269.sol         | 39 ++++++++
 assets/eip-5269/contracts/IERC5269.sol        | 34 +++++++
 .../contracts/testing/ERC721ForTesting.sol    | 42 +++++++++
 assets/eip-5269/test/TestERC5269.ts           | 88 +++++++++++++++++++
 5 files changed, 204 insertions(+), 1 deletion(-)
 create mode 100644 assets/eip-5269/contracts/ERC5269.sol
 create mode 100644 assets/eip-5269/contracts/IERC5269.sol
 create mode 100644 assets/eip-5269/contracts/testing/ERC721ForTesting.sol
 create mode 100644 assets/eip-5269/test/TestERC5269.ts

diff --git a/EIPS/eip-5269.md b/EIPS/eip-5269.md
index d10af7da99eb9f..b6eab38a830020 100644
--- a/EIPS/eip-5269.md
+++ b/EIPS/eip-5269.md
@@ -102,7 +102,7 @@ In addition to the behavior specified in the comments of `IERC5269`:
 
 4. Any compliant contract SHOULD emit a `OnSupportEIP(true, address(0), 5269, 0, [])`
 5. Any compliant contract MAY declare for easy discovery any EIP main behavior or sub-behaviors by emitting event of `OnSupportEIP` with relevant values.
-6. For any `EIP-XXX` that is NOT in `Final` status, when querying `supportEIP((any caller), xxx, (any minor identifier), [])`, it MUST NOT return `keccak256("FINAL")`.
+6. For any `EIP-XXX` that is NOT in `Final` status, when querying `supportEIP((any caller), xxx, (any minor identifier), [])`, it MUST NOT return `keccak256("FINAL")`, it is RECOMMENDED to return `0`.
 7. The `supportEIP` MUST be `view`, ie. it MUST NOT mutate any global state of EVM.
 
 ## Rationale
diff --git a/assets/eip-5269/contracts/ERC5269.sol b/assets/eip-5269/contracts/ERC5269.sol
new file mode 100644
index 00000000000000..4d89b471c9767e
--- /dev/null
+++ b/assets/eip-5269/contracts/ERC5269.sol
@@ -0,0 +1,39 @@
+// SPDX-License-Identifier: CC0-1.0
+// Author: Zainan Victor Zhou <ercref@zzn.im>
+// DRAFTv1
+// Source https://github.com/ercref/ercref-contracts/tree/main/ERCs/eip-5269
+// Deployment https://goerli.etherscan.io/address/0x33F735852619E3f99E1AF069cCf3b9232b2806bE#code
+
+pragma solidity ^0.8.9;
+
+import "./IERC5269.sol";
+
+contract ERC5269 is IERC5269 {
+    bytes32 constant public EIP_STATUS = keccak256("DRAFTv1");
+    constructor () {
+        emit OnSupportEIP(address(0x0), 5269, bytes32(0), EIP_STATUS, "");
+    }
+
+    function _supportEIP(
+        address /*caller*/,
+        uint256 majorEIPIdentifier,
+        bytes32 minorEIPIdentifier,
+        bytes calldata /*extraData*/)
+    internal virtual view returns (bytes32 eipStatus) {
+        if (majorEIPIdentifier == 5269) {
+            if (minorEIPIdentifier == bytes32(0)) {
+                return EIP_STATUS;
+            }
+        }
+        return bytes32(0);
+    }
+
+    function supportEIP(
+        address caller,
+        uint256 majorEIPIdentifier,
+        bytes32 minorEIPIdentifier,
+        bytes calldata extraData)
+    external virtual view returns (bytes32 eipStatus) {
+        return _supportEIP(caller, majorEIPIdentifier, minorEIPIdentifier, extraData);
+    }
+}
diff --git a/assets/eip-5269/contracts/IERC5269.sol b/assets/eip-5269/contracts/IERC5269.sol
new file mode 100644
index 00000000000000..8b444549578895
--- /dev/null
+++ b/assets/eip-5269/contracts/IERC5269.sol
@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: CC0-1.0
+// Author: Zainan Victor Zhou <ercref@zzn.im>
+// DRAFTv1
+// Source https://github.com/ercref/ercref-contracts/tree/main/ERCs/eip-5269
+// Deployment https://goerli.etherscan.io/address/0x33F735852619E3f99E1AF069cCf3b9232b2806bE#code
+pragma solidity ^0.8.9;
+
+interface IERC5269 {
+  event OnSupportEIP(
+      address indexed caller, // when emitted with `address(0x0)` means all callers.
+      uint256 indexed majorEIPIdentifier,
+      bytes32 indexed minorEIPIdentifier, // 0 means the entire EIP
+      bytes32 eipStatus,
+      bytes extraData
+  );
+
+  /// @dev The core method of EIP/ERC Interface Detection
+  /// @param caller, a `address` value of the address of a caller being queried whether the given EIP is supported.
+  /// @param majorEIPIdentifier, a `uint256` value and SHOULD BE the EIP number being queried. Unless superseded by future EIP, such EIP number SHOULD BE less or equal to (0, 2^32-1]. For a function call to `supportEIP`, any value outside of this range is deemed unspecified and open to implementation's choice or for future EIPs to specify.
+  /// @param minorEIPIdentifier, a `bytes32` value reserved for authors of individual EIP to specify. For example the author of [EIP-721](/EIPS/eip-721) MAY specify `keccak256("ERC721Metadata")` or `keccak256("ERC721Metadata.tokenURI")` as `minorEIPIdentifier` to be quired for support. Author could also use this minorEIPIdentifier to specify different versions, such as EIP-712 has its V1-V4 with different behavior.
+  /// @param extraData, a `bytes` for [EIP-5750](/EIPS/eip-5750) for future extensions.
+  /// @return eipStatus a bytes32 indicating the status of EIP the contract supports.
+  ///                    - For FINAL EIPs, it MUST return `keccak256("FINAL")`.
+  ///                    - For non-FINAL EIPs, it SHOULD return `keccak256("DRAFT")`.
+  ///                      During EIP procedure, EIP authors are allowed to specify their own
+  ///                      eipStatus other than `FINAL` or `DRAFT` at their discretion such as `keccak256("DRAFTv1")`
+  ///                      or `keccak256("DRAFT-option1")`and such value of eipStatus MUST be documented in the EIP body
+  function supportEIP(
+    address caller,
+    uint256 majorEIPIdentifier,
+    bytes32 minorEIPIdentifier,
+    bytes calldata extraData)
+  external view returns (bytes32 eipStatus);
+}
diff --git a/assets/eip-5269/contracts/testing/ERC721ForTesting.sol b/assets/eip-5269/contracts/testing/ERC721ForTesting.sol
new file mode 100644
index 00000000000000..22d21c469b9c4f
--- /dev/null
+++ b/assets/eip-5269/contracts/testing/ERC721ForTesting.sol
@@ -0,0 +1,42 @@
+// SPDX-License-Identifier: CC0-1.0
+// Author: Zainan Victor Zhou <ercref@zzn.im>
+// DRAFTv1
+// Source https://github.com/ercref/ercref-contracts/tree/main/ERCs/eip-5269
+// Deployment https://goerli.etherscan.io/address/0x33F735852619E3f99E1AF069cCf3b9232b2806bE#code
+pragma solidity ^0.8.9;
+// import 721
+import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+// impport 5269
+import "../ERC5269.sol";
+
+contract ERC721ForTesting is ERC721, ERC5269 {
+
+    bytes32 constant public EIP_FINAL = keccak256("FINAL");
+    constructor() ERC721("ERC721ForTesting", "E721FT") ERC5269() {
+        _mint(msg.sender, 0);
+        emit OnSupportEIP(address(0x0), 721, bytes32(0), EIP_FINAL, "");
+        emit OnSupportEIP(address(0x0), 721, keccak256("ERC721Metadata"), EIP_FINAL, "");
+        emit OnSupportEIP(address(0x0), 721, keccak256("ERC721Enumerable"), EIP_FINAL, "");
+    }
+
+  function supportEIP(
+    address caller,
+    uint256 majorEIPIdentifier,
+    bytes32 minorEIPIdentifier,
+    bytes calldata extraData)
+  external
+  override
+  view
+  returns (bytes32 eipStatus) {
+    if (majorEIPIdentifier == 721) {
+      if (minorEIPIdentifier == 0) {
+        return keccak256("FINAL");
+      } else if (minorEIPIdentifier == keccak256("ERC721Metadata")) {
+        return keccak256("FINAL");
+      } else if (minorEIPIdentifier == keccak256("ERC721Enumerable")) {
+        return keccak256("FINAL");
+      }
+    }
+    return super._supportEIP(caller, majorEIPIdentifier, minorEIPIdentifier, extraData);
+  }
+}
diff --git a/assets/eip-5269/test/TestERC5269.ts b/assets/eip-5269/test/TestERC5269.ts
new file mode 100644
index 00000000000000..b71635df22b2af
--- /dev/null
+++ b/assets/eip-5269/test/TestERC5269.ts
@@ -0,0 +1,88 @@
+// SPDX-License-Identifier: CC0-1.0
+// Author: Zainan Victor Zhou <ercref@zzn.im>
+// DRAFTv1
+// Source https://github.com/ercref/ercref-contracts/tree/main/ERCs/eip-5269
+// Deployment https://goerli.etherscan.io/address/0x33F735852619E3f99E1AF069cCf3b9232b2806bE#code
+
+import { loadFixture, mine } from "@nomicfoundation/hardhat-network-helpers";
+import { expect } from "chai";
+import { BigNumber, ContractReceipt, Wallet } from "ethers";
+import { ethers } from "hardhat";
+
+describe("ERC5269", function () {
+  async function deployFixture() {
+    // Contracts are deployed using the first signer/account by default
+    const [owner, mintSender, recipient] = await ethers.getSigners();
+    const testWallet: Wallet = new ethers.Wallet("0x0000000000000000000000000000000000000000000000000000000000000001");
+
+    const factory = await ethers.getContractFactory("ERC5269");
+    const contract = await factory.deploy();
+    let tx1 = await contract.deployed();
+    let txDeployErc5269: ContractReceipt = await tx1.deployTransaction.wait();
+
+    const ERC721ForTesting = await ethers.getContractFactory("ERC721ForTesting");
+    const erc721ForTesting = await ERC721ForTesting.deploy();
+    let tx2 = await erc721ForTesting.deployed();
+    const txDeployErc721: ContractReceipt = await tx2.deployTransaction.wait();
+    const provider = ethers.provider;
+    return {
+      provider,
+      contract,
+      erc721ForTesting,
+      tx1, txDeployErc5269,
+      tx2, txDeployErc721,
+      owner, mintSender, recipient, testWallet
+    };
+  }
+
+  describe("Deployment", function () {
+    it("Should be deployable", async function () {
+      await loadFixture(deployFixture);
+    });
+
+    it("Should emit proper OnSupportEIP events", async function () {
+      let { txDeployErc721 } = await loadFixture(deployFixture);
+      let events = txDeployErc721.events?.filter(event => event.event === 'OnSupportEIP');
+      expect(events).to.have.lengthOf(4);
+
+      let ev5269 = events!.filter(
+        (event) => event.args!.majorEIPIdentifier.eq(5269));
+      expect(ev5269).to.have.lengthOf(1);
+      expect(ev5269[0].args!.caller).to.equal(BigNumber.from(0));
+      expect(ev5269[0].args!.minorEIPIdentifier).to.equal(BigNumber.from(0));
+      expect(ev5269[0].args!.eipStatus).to.equal(ethers.utils.id("DRAFTv1"));
+
+      let ev721 = events!.filter(
+        (event) => event.args!.majorEIPIdentifier.eq(721));
+      expect(ev721).to.have.lengthOf(3);
+      expect(ev721[0].args!.caller).to.equal(BigNumber.from(0));
+      expect(ev721[0].args!.minorEIPIdentifier).to.equal(BigNumber.from(0));
+      expect(ev721[0].args!.eipStatus).to.equal(ethers.utils.id("FINAL"));
+
+      expect(ev721[1].args!.caller).to.equal(BigNumber.from(0));
+      expect(ev721[1].args!.minorEIPIdentifier).to.equal(ethers.utils.id("ERC721Metadata"));
+      expect(ev721[1].args!.eipStatus).to.equal(ethers.utils.id("FINAL"));
+
+      expect(ev721[2].args!.caller).to.equal(BigNumber.from(0));
+      expect(ev721[2].args!.minorEIPIdentifier).to.equal(ethers.utils.id("ERC721Enumerable"));
+      expect(ev721[2].args!.eipStatus).to.equal(ethers.utils.id("FINAL"));
+    });
+
+    it("Should return proper eipStatus value when called supportEIP() for declared supported EIP/features", async function () {
+      let { erc721ForTesting, owner } = await loadFixture(deployFixture);
+      expect(await erc721ForTesting.supportEIP(owner.address, 5269, ethers.utils.hexZeroPad("0x00", 32), [])).to.equal(ethers.utils.id("DRAFTv1"));
+      expect(await erc721ForTesting.supportEIP(owner.address, 721, ethers.utils.hexZeroPad("0x00", 32), [])).to.equal(ethers.utils.id("FINAL"));
+      expect(await erc721ForTesting.supportEIP(owner.address, 721, ethers.utils.id("ERC721Metadata"), [])).to.equal(ethers.utils.id("FINAL"));
+      expect(await erc721ForTesting.supportEIP(owner.address, 721, ethers.utils.id("ERC721Enumerable"), [])).to.equal(ethers.utils.id("FINAL"));
+
+      expect(await erc721ForTesting.supportEIP(owner.address, 721, ethers.utils.id("WRONG FEATURE"), [])).to.equal(BigNumber.from(0));
+      expect(await erc721ForTesting.supportEIP(owner.address, 9999, ethers.utils.hexZeroPad("0x00", 32), [])).to.equal(BigNumber.from(0));
+    });
+
+    it("Should return zero as eipStatus value when called supportEIP() for non declared EIP/features", async function () {
+      let { erc721ForTesting, owner } = await loadFixture(deployFixture);
+      expect(await erc721ForTesting.supportEIP(owner.address, 721, ethers.utils.id("WRONG FEATURE"), [])).to.equal(BigNumber.from(0));
+      expect(await erc721ForTesting.supportEIP(owner.address, 9999, ethers.utils.hexZeroPad("0x00", 32), [])).to.equal(BigNumber.from(0));
+    });
+  });
+});

From 46fc45f6a6e3692cfaf8105637a0c94ff4da0549 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Wed, 11 Jan 2023 22:44:18 -0800
Subject: [PATCH 165/274] Add asset file for eip-5269 (#6318)

---
 EIPS/eip-5269.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/EIPS/eip-5269.md b/EIPS/eip-5269.md
index b6eab38a830020..4eb7f537868273 100644
--- a/EIPS/eip-5269.md
+++ b/EIPS/eip-5269.md
@@ -92,6 +92,8 @@ interface IERC5269 {
 }
 ```
 
+See [`IERC5269.sol`](../assets/eip-5269/contracts/IERC5269.sol).
+
 In addition to the behavior specified in the comments of `IERC5269`:
 
 1. Any `minorEIPIdentifier=0` is reserved to be referring to the main behavior of the EIP being queried.
@@ -178,6 +180,8 @@ describe("ERC5269", function () {
 });
 ```
 
+See [`TestERC5269.ts`](../assets/eip-5269/test/TestERC5269.ts).
+
 ## Reference Implementation
 
 Here is a reference implementation for this EIP:
@@ -215,6 +219,8 @@ contract ERC5269 is IERC5269 {
 }
 ```
 
+See [`ERC5269.sol`](../assets/eip-5269/contracts/ERC5269.sol).
+
 Here is an example where a contract of [EIP-721](./eip-721.md) also implement this EIP to make it easier
 to detect and discover:
 
@@ -255,6 +261,8 @@ contract ERC721ForTesting is ERC721, ERC5269 {
 
 ```
 
+See [`ERC721ForTesting.sol`](../assets/eip-5269/contracts/testing/ERC721ForTesting.sol).
+
 ## Security Considerations
 
 Similar to [EIP-165](./eip-165.md) callers of the interface MUST assume the smart contract

From 1066169cd6a07bd1ef2394acfdfb5390282a18c2 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Wed, 11 Jan 2023 23:02:45 -0800
Subject: [PATCH 166/274] Update EIP-5269 (#6319)

* Update

* Merge
---
 EIPS/eip-5269.md | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/EIPS/eip-5269.md b/EIPS/eip-5269.md
index 4eb7f537868273..9896ac0d03a2b6 100644
--- a/EIPS/eip-5269.md
+++ b/EIPS/eip-5269.md
@@ -16,8 +16,10 @@ requires: 5750
 An interface for better identification and detection of EIP/ERC by numbers.
 
 It designate a field in which it's called `majorEIPIdentifier` which is normally known or referred to as "EIP number". For example, `ERC-721` aka [EIP-721](./eip-721.md) has a `majorEIPIdentifier = 721`. This EIP has a `majorEIPIdentifier = 5269`.
-Calling it as "majorEIPIdentifier" instead of EIP number to make it future proof: anticipating there is a possibility where future EIP is not numbered or if we want to
+
+Calling it as "majorEIPIdentifier" instead of "EIP number" makes it future proof: anticipating there is a possibility where future EIP is not numbered or if we want to
 incorporate other type of standards.
+
 It also proposes a new concept of `minorEIPIdentifier` which is left for authors of
 individual EIP to define. For example, EIP-721's author may define `ERC721Metadata`
 interface as `minorEIPIdentifier= keccak256("ERC721Metadata")`.
@@ -77,7 +79,7 @@ interface IERC5269 {
   /// @param majorEIPIdentifier, a `uint256` value and SHOULD BE the EIP number being queried. Unless superseded by future EIP, such EIP number SHOULD BE less or equal to (0, 2^32-1]. For a function call to `supportEIP`, any value outside of this range is deemed unspecified and open to implementation's choice or for future EIPs to specify.
   /// @param minorEIPIdentifier, a `bytes32` value reserved for authors of individual EIP to specify. For example the author of [EIP-721](/EIPS/eip-721) MAY specify `keccak256("ERC721Metadata")` or `keccak256("ERC721Metadata.tokenURI")` as `minorEIPIdentifier` to be quired for support. Author could also use this minorEIPIdentifier to specify different versions, such as EIP-712 has its V1-V4 with different behavior.
   /// @param extraData, a `bytes` for [EIP-5750](/EIPS/eip-5750) for future extensions.
-  /// @return eipStatus a bytes32 indicating the status of EIP the contract supports.
+  /// @return eipStatus, a `bytes32` indicating the status of EIP the contract supports.
   ///                    - For FINAL EIPs, it MUST return `keccak256("FINAL")`.
   ///                    - For non-FINAL EIPs, it SHOULD return `keccak256("DRAFT")`.
   ///                      During EIP procedure, EIP authors are allowed to specify their own
@@ -92,20 +94,20 @@ interface IERC5269 {
 }
 ```
 
-See [`IERC5269.sol`](../assets/eip-5269/contracts/IERC5269.sol).
+In the following description, `EIP_5269_STATUS` is set to be `keccak256("DRAFTv1")`.
 
 In addition to the behavior specified in the comments of `IERC5269`:
 
 1. Any `minorEIPIdentifier=0` is reserved to be referring to the main behavior of the EIP being queried.
 2. Authors of compliant EIP is RECOMMENDED to declare a list of `minorEIPIdentifier` for their optional interfaces, behaviors and value range for future extension.
-3. When this EIP is FINAL, any compliant contract that is an `IERC5629` MUST return `keccak256("FINAL")` for the call of `supportEIP((any caller), 5269, 0, [])`.
+3. When this EIP is FINAL, any compliant contract MUST return a `EIP_5269_STATUS` for the call of `supportEIP((any caller), 5269, 0, [])`
 
-*Note*: at the current snapshot, `supportEIP((any caller), 5269, 0, [])` MUST return `keccak256("DRAFT")`.
+*Note*: at the current snapshot, `supportEIP((any caller), 5269, 0, [])` MUST return `EIP_5269_STATUS`.
 
-4. Any compliant contract SHOULD emit a `OnSupportEIP(true, address(0), 5269, 0, [])`
-5. Any compliant contract MAY declare for easy discovery any EIP main behavior or sub-behaviors by emitting event of `OnSupportEIP` with relevant values.
-6. For any `EIP-XXX` that is NOT in `Final` status, when querying `supportEIP((any caller), xxx, (any minor identifier), [])`, it MUST NOT return `keccak256("FINAL")`, it is RECOMMENDED to return `0`.
-7. The `supportEIP` MUST be `view`, ie. it MUST NOT mutate any global state of EVM.
+4. Any compliant contract SHOULD emit a `OnSupportEIP(address(0), 5269, 0, EIP_5269_STATUS, [])` event upon construction or upgrade.
+5. Any compliant contract MAY declare for easy discovery any EIP main behavior or sub-behaviors by emitting event of `OnSupportEIP` with relevant values and when compliant contract changes whether the support an EIP or certain behavior for certain caller or all callers.
+6. For any `EIP-XXX` that is NOT in `Final` status, when querying `supportEIP((any caller), xxx, (any minor identifier), [])`, it MUST NOT return `keccak256("FINAL")`. It is RECOMMENDED to return `0` in this case but other value of `eipStatus` is allowed. Caller MUST treat any returned value other than `keccak256("FINAL")` as non-final, and MUST treat 0 as strictly "not supported".
+7. The `supportEIP` MUST be `view`, i.e. it MUST NOT mutate any global state of EVM.
 
 ## Rationale
 

From e120ebad090f2a06008ea7913ca2f1920adfad37 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Toni=20Wahrst=C3=A4tter?=
 <51536394+nerolation@users.noreply.github.com>
Date: Thu, 12 Jan 2023 11:24:21 +0100
Subject: [PATCH 167/274] Update design of eip-5564 (#6321)

* update eip-5564

* Update eip-5564

* Update eip-5564.md

* Update eip-5564.md
---
 EIPS/eip-5564.md                  | 329 ++++++++++++++------
 assets/eip-5564/minimal_poc.ipynb | 491 ++++++++++++++++++++++++++++--
 2 files changed, 690 insertions(+), 130 deletions(-)

diff --git a/EIPS/eip-5564.md b/EIPS/eip-5564.md
index 03d8d51e31d75a..c66ebf67a36f83 100644
--- a/EIPS/eip-5564.md
+++ b/EIPS/eip-5564.md
@@ -1,163 +1,294 @@
 ---
 eip: 5564
-title: Stealth Address Wallets
-description: Stealth addresses for smart contract wallets
-author: Anton Wahrstätter (@Nerolation)
+title: Non-Interactive Stealth Address Generation
+description: Stealth addresses for private transfers
+author: Toni Wahrstätter (@nerolation), Matt Solomon (@mds1), Ben DiFrancesco (@apbendi), Vitalik Buterin <vitalik.buterin@ethereum.org>
 discussions-to: https://ethereum-magicians.org/t/eip-5566-stealth-addresses-for-smart-contract-wallets/10614
 status: Draft
 type: Standards Track
 category: ERC
 created: 2022-08-13
-requires: 165
 ---
 
 
 ## Abstract
-This specification defines a standardized way of creating stealth addresses for smart contract wallets. This EIP enables senders of transactions/transfers to generate private stealth addresses for their recipients that only the recipient can eventually unlock.
+
+This specification defines a standardized way of creating stealth addresses. This EIP enables senders of transactions/transfers to non-interactively generate private stealth addresses for their recipients that only the recipients can unlock.
 
 ## Motivation
-The standardization of stealth address generation may unlock significant privacy potential within Smart Contract Wallets, allowing the recipient of a transfer to remain private when receiving an asset. A Stealth address is generated by the sender from a shared secret between sender and recipient and can only be unlocked by the recipient because only the recipient can compute the matching private key.
 
-Observers have no possibility of linking the recipient's stealth address to the recipient's identity, leaving only the sender with that information.
+The standardization of non-interactive stealth address generation holds the potential to greatly enhance the privacy capabilities of Ethereum by enabling the recipient of a transfer to remain anonymous when receiving an asset. This is achieved through the generation of a stealth address by the sender, using a shared secret between the sender and recipient. Only the recipient is able to unlock the funds at the stealth address, as they are the only ones with access to the private key required for this purpose. As a result, observers are unable to link the recipient's stealth address to their identity, preserving the privacy of the recipient and leaving only the sender with this information.
 
 ## Specification
+
 The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
 
-Every smart contract compliant with this EIP wallet MUST implement the [EIP-165](./eip-165.md) (`0x01ffc9a7`) interface.
+The follow contracts are part of this specification:
+
+- `IERC5564Registry` stores the stealth public keys for users. This MUST be a singleton contract, with one instance per chain.
+
+- `IERC5565Generator` contracts are used to compute stealth addresses for a user based on a given curve. There can be many of these per chain, and for a given curve there SHOULD be one implementation per chain. Generator contracts are intended to primarily serve as reference implementations for off-chain libraries, as calling a method over HTTPS to generate a stealth address may compromise the user's privacy depending on who runs the node.
+
+- `IERC5564Messenger` emits events to announce when something is sent to a stealth address. This MUST be a singleton contract, with one instance per chain.
+
+The interface for each is specified as follows:
+
+### `IERC5564Registry`
 
 ```solidity
-// SPDX-License-Identifier: CC0-1.0
-pragma solidity ^0.8.6;
-...
-interface IERC5564 {
-    
-    /// @notice Public Key coordinates of the wallet owner
-    /// @dev Is used by other wallets to generate stealth addresses
-    ///  on behalf of the wallet owner.
-    bytes publicKey;
-
-
-    /// @notice Generates a stealth address that can be accessed only by the recipient.
-    /// @dev Function is executed locally by the sender on the recipient's wallet to
-    ///  generate a stealthAddress and publishableData S. The Caller/Sender must select a secret
-    ///  value s and compute the stealth address of the wallet owner and the matching public key S
-    ///  to the selected secret s.
-    /// @param secret A secret value selected by the sender
-    function generateStealthAddress(uint256 secret) returns (bytes publishableData, address stealthAddress)
+/// @notice Registry to map an address to its stealth key information.
+interface IERC5564Registry {
+  /// @notice Returns the stealth public keys for the given `registrant` to compute a stealth
+  /// address accessible only to that `registrant` using the provided `generator` contract.
+  /// @dev MUST return zero if a registrant has not registered keys for the given generator.
+  function stealthKeys(address registrant, address generator)
+    external
+    view
+    returns (bytes memory spendingPubKey, bytes memory viewingPubKey);
+
+  /// @notice Sets the caller's stealth public keys for the `generator` contract.
+  function registerKeys(address generator, bytes memory spendingPubKey, bytes memory viewingPubKey)
+    external;
+
+  /// @notice Sets the `registrant`s stealth public keys for the `generator` contract using their
+  /// `signature`.
+  /// @dev MUST support both EOA signatures and EIP-1271 signatures.
+  function registerKeysOnBehalf(
+    address registrant,
+    address generator,
+    bytes memory signature,
+    bytes memory spendingPubKey,
+    bytes memory viewingPubKey
+  ) external;
+
+  /// @dev Emitted when a registrant updates their registered stealth keys.
+  event StealthKeyChanged(
+    address indexed registrant, address indexed generator, bytes spendingPubKey, bytes viewingPubKey
+  );
+}
+```
 
+### `IERC5564Generator`
+
+```solidity
+/// @notice Interface for generating stealth addresses for keys from a given stealth address scheme.
+/// @dev The Generator contract MUST have a method called `stealthKeys` that returns the recipient's
+/// public keys as the correct types. The return types will vary for each generator, so a sample
+/// is shown below.
+interface IERC5564Generator {
+  /// @notice Given a `registrant`, returns all relevant data to compute a stealth address.
+  /// @dev MUST return all zeroes if the registrant has not registered keys for this generator.
+  /// @dev The returned `viewTag` MUST be the hash of the `sharedSecret`. THe hashing function used
+  /// is specified by the generator.
+  /// @dev `ephemeralPubKey` represents the ephemeral public key used by the sender.
+  /// @dev Intended to be used off-chain only to prevent exposing secrets on-chain.
+  /// @dev Consider running this against a local node, or using an off-chain library with the same
+  /// logic, instead of via an `eth_call` to a public RPC provider to avoid leaking secrets.
+  function generateStealthAddress(address registrant)
+    external
+    view
+    returns (
+      address stealthAddress,
+      bytes memory ephemeralPubKey,
+      bytes memory sharedSecret,
+      bytes32 viewTag
+    );
+
+  /// @notice Returns the stealth public keys for the given `registrant`, in the types that best
+  /// represent the curve.
+  /// @dev The below is an example for the secp256k1 curve.
+  function stealthKeys(address registrant)
+    external
+    view
+    returns (
+      uint256 spendingPubKeyX,
+      uint256 spendingPubKeyY,
+      uint256 viewingPubKeyX,
+      uint256 viewingPubKeyY
+    );
 }
+```
+
+### `IERC5564Messenger`
 
-interface PubStealthInfoContract {
-
-    /// @noticeImmutable contract that broadcasts an 
-    ///  event with the address of the stealthRecipient and 
-    ///  publishableData S for every privateTransfer. 
-    /// @dev Emits event with private transfer information S and the recipient's address.
-    ///  S is generated by the sender and represents the public key to the secret s.
-    ///  The sender broadcasts S for every private transfer. Users can use S to check if they were
-    ///  the recipients of a respective transfer by comparing it to stealthRecipient.
-    /// @param stealthRecipient The address to send the funds to
-    /// @param publishableData The public key to the sender's secret
-    event PrivateTransfer(address indexed stealthRecipient, bytes publishableData)
+```solidity
+/// @notice Interface for announcing that something was sent to a stealth address.
+interface IERC5564Messenger {
+  /// @dev Emitted when sending something to a stealth address.
+  /// @dev See `announce` for documentation on the parameters.
+  event Announcement(
+    bytes ephemeralPubKey, bytes32 indexed stealthRecipientAndViewTag, bytes32 metadata
+  );
+
+  /// @dev Called by integrators to emit an `Announcement` event.
+  /// @dev `ephemeralPubKey` represents the ephemeral public key used by the sender.
+  /// @dev `stealthRecipientAndViewTag` contains the stealth address (20 bytes) and the view tag (12
+  /// bytes).
+  /// @dev `metadata` is an arbitrary field that the sender can use however they like, but the below
+  /// guidelines are recommended:
+  ///   - When sending ERC-20 tokens, the metadata SHOULD include the token address as the first 20
+  ///     bytes, and the amount being sent as the following 32 bytes.
+  ///   - When sending ERC-721 tokens, the metadata SHOULD include the token address as the first 20
+  ///     bytes, and the token ID being sent as the following 32 bytes.
+  function announce(
+    bytes memory ephemeralPubKey,
+    bytes32 stealthRecipientAndViewTag,
+    bytes32 metadata
+  ) external;
 }
 ```
 
-#### Stealth Address Generation (executed locally)
+### Sample Generator Implementation
 
 ```solidity
-function generateStealthAddress(uint256 secret) public view returns (bytes, address){
-        //  s*G = S
-        pubkeyFromSecret = ecMul(secret, G);
-        //  s*P = q
-        sharedSecret = ecMul(secret, Publickey);
-        // hash(sharedSecret)
-        hashedSharedSecret = keccak256(sharedSecret);
-        // hash value to public key
-        pubkeyFromHashedSecret = ecMul(hashedSharedSecret, G);
-        // derive new public key
-        stealthPubkeyRecipient = ecAdd(Publickey, pubkeyFromHashedSecret);
-        // generate stealth address
-        stealthAddressRecipient = address(stealthPubkeyRecipient);
-        // return public key coordinates and stealthAddress
-        return (pubkeyFromSecret, stealthAddressRecipient);
+/// @notice Sample IERC5564Generator implementation for the secp256k1 curve.
+contract Secp256k1Generator is IERC5564Generator {
+  /// @notice Address of this chain's registry contract.
+  IERC5564Registry public constant REGISTRY = IERC5564Registry(address(0));
+
+  /// @notice Sample implementation for parsing stealth keys on the secp256k1 curve.
+  function stealthKeys(address registrant)
+    external
+    view
+    returns (
+      uint256 spendingPubKeyX,
+      uint256 spendingPubKeyY,
+      uint256 viewingPubKeyX,
+      uint256 viewingPubKeyY
+    )
+  {
+    // Fetch the raw spending and viewing keys from the registry.
+    (bytes memory spendingPubKey, bytes memory viewingPubKey) =
+      REGISTRY.stealthKeys(registrant, address(this));
+
+    // Parse the keys.
+    assembly {
+      spendingPubKeyX := mload(add(spendingPubKey, 0x20))
+      spendingPubKeyY := mload(add(spendingPubKey, 0x40))
+      viewingPubKeyX := mload(add(viewingPubKey, 0x20))
+      viewingPubKeyY := mload(add(viewingPubKey, 0x40))
     }
+  }
+
+  /// @notice Sample implementation for generating stealth addresses for the secp256k1 curve.
+  function generateStealthAddress(address registrant, bytes memory ephemeralPrivKey)
+    external
+    view
+    returns (
+      address stealthAddress,
+      bytes memory ephemeralPubKey,
+      bytes memory sharedSecret,
+      bytes32 viewTag
+    )
+  {
+    // Get the ephemeral public key from the private key.
+    ephemeralPubKey = ecMul(ephemeralPrivKey, G);
+
+    // Get user's parsed public keys.
+    (
+      uint256 spendingPubKeyX,
+      uint256 spendingPubKeyY,
+      uint256 viewingPubKeyX,
+      uint256 viewingPubKeyY
+    ) = stealthKeys(registrant, address(this));
+
+    // Generate shared secret from sender's private key and recipient's viewing key.
+    sharedSecret = ecMul(ephemeralPrivKey, viewingPubKeyX, viewingPubKeyY);
+    bytes32 sharedSecretHash = keccak256(sharedSecret);
+
+    // Generate view tag for enabling faster parsing for the recipient
+    viewTag = sharedSecretHash[0:12];
+
+    // Generate a point from the hash of the shared secret
+    bytes memory sharedSecretPoint = ecMul(sharedSecret, G);
+
+    // Generate sender's public key from their ephemeral private key.
+    bytes memory stealthPubKey = ecAdd(spendingPubKeyX, spendingPubKeyY, sharedSecretPoint);
+
+    // Compute stealth address from the stealth public key.
+    stealthAddress = pubkeyToAddress(stealthPubKey);
+  }
 ```
 
+Stealth addresses are computed using the algorithm below, assuming elliptic curves.
+Other encryption schemes such as post-quantum encryption with Kyber may need to modify this approach.
 
----
-
-#### For transfering:
+- $G$ is the generator point of the curve.
 
-Recipient Keypair --> $(p,P) | P = p * G$
+- Recipient has private keys $p_{view}$ and $p_{spend}$.
 
+- Recipient publishes corresponding public keys $P_{view}$ and $P_{spend}$ in the `IERC5564Registry`.
 
-##### Recipient:
-```solidity
-bytes public pubkeyRecipient;
-```
-NOTE: `pubkeyRecipient` MUST be incorporated in the smart contract wallet contract as a public state variable.
+- Sender generates random 32-byte entropy ephemeral private key $p_{ephemeral}$.
 
----
+- Sender passes the recipient address and $p_{ephemeral}$ to the `IERC5564Generator` contract's `generateStealthAddress` function.
 
-##### Sender:
+- This function performs the following computations:
+  - A shared secret $s$ is computed as $s = p_{ephemeral} \cdot P_{view}$.
+  - The secret is hashed $s_{h} = h(s)$.
+  - The view tag $v$ is extracted by taking the most significant 12 bytes $s_{h}[0:12]$,
+  - Multiplying the shared secret with the generator point $S = s \cdot G$.
+  - The recipient's stealth public key is computed as $P_{stealth} = P_{spend} + S$.
+  - The recipient's stealth address $a_{stealth}$ is computed as $\textrm{pubkeyToAddress}(P_{stealth})$.
 
-Sender senderKeypair  --> $(s,S) | S = s * G $
-```solidity
-bytes pubkeyFromSecret = ecMul(s, G);
-```
-NOTE: The parameter `s` represents a sender-generated secret and MUST NOT equal a user's private key.
+Sending funds now works as follows:
 
-$sharedSecret    = s * P$
+- Sender uses the contract of their choice to send something to $a_{stealth}$, and provides $P_{ephemeral}$ and any other metadata to the send method.
 
-```solidity
-bytes sharedSecret = ecMul(s, pubkeyRecipient);
-```
+- The contract calls `IERC5564Messenger.announce` with $a_{stealth}$, $v$, $P_{ephemeral}$, and any metadata.
 
+To scan for funds, a recipient must retrieve all logs from the `IERC5564Messenger` contract.
+They then check if they can compute the stealth address $P_{stealth}$ that was emitted as stealth address $a_{stealth}$ in the `Announcement`. If successful, the recipient can generate  $p_{stealth}$, representing the private key that can eventually access $P_{stealth}$.
 
+The parsing process can be presented as follows:
 
+- Recipient has private keys $p_{view}$ and $p_{spend}$.
 
-stealthAddress  = $pubtoaddr(P + (G * keccak(sharedSecret)))$
-```solidity
-bytes32 hashedSharedSecret = keccak256(sharedSecret);
-bytes pubkeyFromHashedSecret = ecMul(hashedSharedSecret, G);
-bytes stealthPubkeyRecipient = ecAdd(pubkeyRecipient, pubkeyFromHashedSecret);
-address stealthAddressRecipient = address(stealthPubkeyRecipient);
-```
-Transfer MUST emit a `PrivateTransfer` Event containing `S` and the `stealthAddressRecipient`.
+- Recipient parses all Announcements $a_i$ performs the following operations:
 
+- This function performs the following computations:
+  - Computing the shared secret $s$ is computed as $s = a_{i, P_{ephemeral}} \cdot p_{view}$.
+  - Hashing the shared secret, $s_{h} = h(s)$.
+  - Comparing the most significant 12 bytes of the resulting hash with the view tag emitted in the event and continue if they match.
+  - Multiplying the shared secret with the generator point $S = s \cdot G$.
+  - Compute stealth public key as $P_{stealth} = P_{spend} + S$.
+  - The recipient's address is computed as $a_{stealth} = \textrm{pubkeyToAddress}(P_{stealth})$.
+  - Compare $a_{stealth}$ with the stealth address logged the emitted `Announcement` event.
 
----
+### Parsing considerations
 
+Usually, the recipient of a stealth address transaction has to perform the following operations to check weather he was the recipient of a certain transaction:
 
-#### For receiving (executed locally):
+- 2x ecMUL,
 
-for all `PrivateTransfer` events do:
+- 2x HASH,
 
-if $pubtoaddr(P + (G * keccak(S * p)))$ == $stealthAddressRecipient$:
-```solidity
-bytes32 hashedSecret = keccak256(S);
-bytes sharedSecret = ecMul(hashedSecret, p);
-bytes pubkeyFromSharedSecret = ecMul(sharedSecret, G);
-bytes stealthPubkeyRecipient = ecAdd(pubkeyRecipient, pubkeyFromSharedSecret);
-address stealthAddressRecipient = address(stealthPubkeyRecipient);
-store_key_locally(p + keccak(S * p));
-```
+- 1x ecADD,
 
+The view tags approach is introduced to reduce the parsing time by around 6x. Users only need to perform 1x ecMUL and 1x HASH (skipping 1x ecMUL, 1x ecADD and 1x HASH) for every parsed announcement. The 12 bytes length was is based on the freely available space in the first log of the `Announcement` Event. With 12 bytes as `viewTag` the probability for users to skip the remaining computations after hashing the shared secret $h(s)$ can be determined as follows: $1/(256^{12})$. This means that users can almost certainly skip the above three operations for any announcements that to do not involve them.
 
 ## Rationale
-This EIP emerged from the need of having privacy-preserving ways to transfer ownership without revealing the recipient's identity. Tokens can reveal sensitive private information about the owner. While users might want to prove the ownership of an NFT concert ticket, they might not want to reveal personal account-related information at the same time. The standardization of stealth address generation represents a significant effort for privacy. Privacy-preserving solutions require standards to gain adoption, therefore it is critical to focus on generalizable ways of implementing related solutions.
 
-This extension standardizes the method to generate and look up stealth addresses. Users can send assets without having to interact with the recipient beforehand. Furthermore, users can verify if they have been the recipient of a transfer without requiring interactions with the chain. Stealth addresses allow only the recipients of token transfers to see that they were the recipients.
+This EIP emerged from the need of having privacy-preserving ways to transfer ownership without revealing the recipient's identity. Tokens can reveal sensitive private information about the owner. While users might want to donate money to a specific organization/country but they might not want to reveal personal account-related information at the same time. The standardization of stealth address generation represents a significant effort for privacy: privacy-preserving solutions require standards to gain adoption, therefore it is critical to focus on generalizable ways of implementing related solutions.
+
+The stealth address extension standardizes a protocol for generating and locating stealth addresses, enabling the transfer of assets without the need for prior interaction with the recipient and allowing recipients to verify the receipt of a transfer without interacting with the blockchain. Importantly, stealth addresses allow the recipient of a token transfer to verify receipt while maintaining their privacy, as only the recipient is able to see that they have been the recipient of the transfer.
+
+The authors identify the trade-off between on- and off-chain efficiency: Although, including a Monero-like `view tags` mechanism helps recipients to parse announcements more quickly, it adds complexity to the announcement event.
 
+The address of the recipient and the `viewTag` MUST be included in the announcement event, allowing users to quickly verify ownership without having to query the chain for positive account balances.
 
 ## Backwards Compatibility
-No backward compatibility issues were found.
+
+This EIP is fully backward compatible.
 
 ## Reference Implementation
-You can find an implementation of this standard in [gnosisSafeModule.sol](../assets/eip-5564/gnosisSafeModule.sol).
+
+You can find an implementation of this standard in TBD.
 
 ## Security Considerations
-The funding of the stealth address wallet represents a known issue that might breach privacy. The wallet that funds the stealth address wallet MUST NOT have any physical connection to the stealth address owner in order to fully leverage the privacy improvements.
+
+The funding of the stealth address wallet represents a known issue that might breach privacy. The wallet that funds the stealth address MUST NOT have any physical connection to the stealth address owner in order to fully leverage the privacy improvements.
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-5564/minimal_poc.ipynb b/assets/eip-5564/minimal_poc.ipynb
index db16b65696bba5..c7e589d14fc45b 100644
--- a/assets/eip-5564/minimal_poc.ipynb
+++ b/assets/eip-5564/minimal_poc.ipynb
@@ -7,10 +7,7 @@
    "metadata": {},
    "outputs": [],
    "source": [
-    "# Note that this poc is based on the reply of Vitalik on EthResearch here:\n",
-    "# https://ethresear.ch/t/erc721-extension-for-zk-snarks/13237/13\n",
-    "\n",
-    "# The code is not part of the zk-SNARK implementation an will be moved."
+    "# PoC using scaning and spending keys"
    ]
   },
   {
@@ -26,6 +23,14 @@
     "from eth_account import Account"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "4e25cb04",
+   "metadata": {},
+   "source": [
+    "## Sender"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "22ca0bf7",
@@ -60,6 +65,14 @@
     "S"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "c8240f67",
+   "metadata": {},
+   "source": [
+    "## Recipient"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "6895e603",
@@ -77,8 +90,10 @@
     {
      "data": {
       "text/plain": [
-       "(89565891926547004231252920425935692360644145829622209833684329913297188986597,\n",
-       " 12158399299693830322967808612713398636155367887041628176798871954788371653930)"
+       "((89565891926547004231252920425935692360644145829622209833684329913297188986597,\n",
+       "  12158399299693830322967808612713398636155367887041628176798871954788371653930),\n",
+       " (112711660439710606056748659173929673102114977341539408544630613555209775888121,\n",
+       "  25583027980570883691656905877401976406448868254816295069919888960541586679410))"
       ]
      },
      "execution_count": 4,
@@ -89,9 +104,12 @@
    "source": [
     "# privkey: 0x0000000000000000000000000000000000000000000000000000000000000001\n",
     "# address: 0x7E5F4552091A69125d5DfCb7b8C2659029395Bdf\n",
-    "p = int(0x0000000000000000000000000000000000000000000000000000000000000002) # private key\n",
-    "P = secp256k1.privtopub(p.to_bytes(32, \"big\")) # public key\n",
-    "P"
+    "p_scan = int(0x0000000000000000000000000000000000000000000000000000000000000002) # private key\n",
+    "p_spend = int(0x0000000000000000000000000000000000000000000000000000000000000003) # private key\n",
+    "\n",
+    "P_scan = secp256k1.privtopub(p_scan.to_bytes(32, \"big\")) # public key\n",
+    "P_spend = secp256k1.privtopub(p_spend.to_bytes(32, \"big\")) # public key\n",
+    "P_scan, P_spend"
    ]
   },
   {
@@ -99,20 +117,28 @@
    "id": "174929d7",
    "metadata": {},
    "source": [
-    "$P + G*hash(Q)$"
+    "## Calculate Stealth Address: $P_{spend} + G*hash(Q)$"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8b39ed39",
+   "metadata": {},
+   "source": [
+    "$Q = S * p_{scan}$"
    ]
   },
   {
    "cell_type": "code",
    "execution_count": 5,
-   "id": "5f5fbcf4",
+   "id": "63a022d7",
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "(34986710196311298046001056196012031484809340405385241652824827959002221322031,\n",
-       " 37835699564152814660978587905143437663484333033321007899868184134470225816011)"
+       "(65311808848028536848162101908966111079795231803322390815513763038079235257196,\n",
+       " 43767810034999830518515787564234053904327508763526333662117780420755425490082)"
       ]
      },
      "execution_count": 5,
@@ -121,13 +147,226 @@
     }
    ],
    "source": [
-    "Q = secp256k1.multiply(S, p)\n",
-    "assert Q == secp256k1.multiply(P, s)\n",
-    "Q_hex = sha3.keccak_256(Q[0].to_bytes(32, \"big\")+Q[1].to_bytes(32, \"big\")).hexdigest() # note, toStr conversion\n",
+    "Q = secp256k1.multiply(P_scan, s)\n",
+    "Q"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "d79c69fc",
+   "metadata": {},
+   "source": [
+    "$Q = S * p_{scan} = P_{scan} * s$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 6,
+   "id": "5f5fbcf4",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "assert Q == secp256k1.multiply(S, p_scan)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "0d5803ff",
+   "metadata": {},
+   "source": [
+    "$h(Q)$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 7,
+   "id": "f1b38cb0",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "Q_hex = sha3.keccak_256(Q[0].to_bytes(32, \"big\") \n",
+    "                        + Q[1].to_bytes(32, \"big\")\n",
+    "                       ).hexdigest()\n",
+    "Q_hased = bytearray.fromhex(Q_hex)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "a0647821",
+   "metadata": {},
+   "source": [
+    "$ stA = h(Q) * G + P_{spend}$"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "865e7f72",
+   "metadata": {},
+   "source": [
+    "#### Sender sends funds to..."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 8,
+   "id": "d9dd755f",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'0xfed69df0a27f1dae0d7430ead82aaedfad6332bb'"
+      ]
+     },
+     "execution_count": 8,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "stP = secp256k1.add(P_spend, secp256k1.privtopub(Q_hased))\n",
+    "stA = \"0x\"+ sha3.keccak_256(stP[0].to_bytes(32, \"big\")\n",
+    "                            +stP[1].to_bytes(32, \"big\")\n",
+    "                           ).hexdigest()[-40:]\n",
+    "stA"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "38e69080",
+   "metadata": {},
+   "source": [
+    "#### Sender broadcasts"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 9,
+   "id": "cdf57fef",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "((22246744184454969143801186698733154500632648736073949898323976612504587645286,\n",
+       "  110772761940586493986212935445517909380300793379795289150161960681985511655321),\n",
+       " '0xfed69df0a27f1dae0d7430ead82aaedfad6332bb')"
+      ]
+     },
+     "execution_count": 9,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "S, stA"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "588ccc7c",
+   "metadata": {},
+   "source": [
+    "## Parse received funds"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "462f8c8d",
+   "metadata": {},
+   "source": [
+    "* Note that $p_{scan}$ and $P_{spend}$ can be shared with a trusted party\n",
+    "* There may be many S to be parsed"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8ba2a295",
+   "metadata": {},
+   "source": [
+    "$h(p_{scan}*S)*G + P_{spend} => toAddress$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "id": "50b63208",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'0xfed69df0a27f1dae0d7430ead82aaedfad6332bb'"
+      ]
+     },
+     "execution_count": 10,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "Q = secp256k1.multiply(S, p_scan)\n",
+    "Q_hex = sha3.keccak_256(Q[0].to_bytes(32, \"big\")+Q[1].to_bytes(32, \"big\")).hexdigest()\n",
     "Q_hased = bytearray.fromhex(Q_hex)\n",
     "\n",
-    "# Sender sends to ...\n",
-    "secp256k1.add(P, secp256k1.privtopub(Q_hased))"
+    "P_stealth = secp256k1.add(P_spend, secp256k1.privtopub(Q_hased))\n",
+    "P_stealthAddress  = \"0x\"+ sha3.keccak_256(stP[0].to_bytes(32, \"big\")\n",
+    "                                        + stP[1].to_bytes(32, \"big\")\n",
+    "                                        ).hexdigest()[-40:]\n",
+    "P_stealthAddress"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8055d075",
+   "metadata": {},
+   "source": [
+    "logged stealth address $stA$ equals the derived stealth address $P_stealthAddress$"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "26758ea5",
+   "metadata": {},
+   "source": [
+    "$stA==stA_d$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 11,
+   "id": "3faed6a3",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 11,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "P_stealthAddress == stA"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "050e346c",
+   "metadata": {},
+   "source": [
+    "## Derive private key"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "44801516",
+   "metadata": {},
+   "source": [
+    "#### Only the recipient has access to $p_{spend}$"
    ]
   },
   {
@@ -135,30 +374,60 @@
    "id": "7673e439",
    "metadata": {},
    "source": [
-    "$p+hash(Q)$"
+    "$p_{stealth}=p_{spend}+hash(Q)$"
    ]
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": 12,
    "id": "4013b57e",
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "(34986710196311298046001056196012031484809340405385241652824827959002221322031,\n",
-       " 37835699564152814660978587905143437663484333033321007899868184134470225816011)"
+       "39153944482575822531387237249775711740128993925789544779866399859639729033274"
       ]
      },
-     "execution_count": 6,
+     "execution_count": 12,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "Q = secp256k1.multiply(S, p_scan)\n",
+    "Q_hex = sha3.keccak_256(Q[0].to_bytes(32, \"big\")+Q[1].to_bytes(32, \"big\")).hexdigest()\n",
+    "p_stealth = p_spend + int(Q_hex, 16)\n",
+    "p_stealth"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "dc31c1aa",
+   "metadata": {},
+   "source": [
+    "$P_{stealth} = p_{stealth}*G$"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 13,
+   "id": "09b5ccc2",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "(67663851387124608323744162645277269585638670865381831245083336172545348387042,\n",
+       " 80449904826544093817252981338261706033086352950841917067356875711772573870404)"
+      ]
+     },
+     "execution_count": 13,
      "metadata": {},
      "output_type": "execute_result"
     }
    ],
    "source": [
-    "p_stealth = p + int(Q_hex, 16)\n",
-    "\n",
     "# Recipient has private key to ...\n",
     "P_stealth = secp256k1.privtopub(p_stealth.to_bytes(32, \"big\"))\n",
     "P_stealth"
@@ -166,17 +435,41 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": 14,
+   "id": "a3ead30e",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'0xfed69df0a27f1dae0d7430ead82aaedfad6332bb'"
+      ]
+     },
+     "execution_count": 14,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "P_stealthAddress_d  = \"0x\"+ sha3.keccak_256(P_stealth[0].to_bytes(32, \"big\")\n",
+    "                                        + P_stealth[1].to_bytes(32, \"big\")\n",
+    "                                        ).hexdigest()[-40:]\n",
+    "P_stealthAddress_d"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 15,
    "id": "2712c07b",
    "metadata": {},
    "outputs": [
     {
      "data": {
       "text/plain": [
-       "'0xa423e468c7987026D1dC797425a870C5e704E75d'"
+       "'0xfEd69Df0a27F1daE0D7430EAd82aaEdfAD6332bb'"
       ]
      },
-     "execution_count": 7,
+     "execution_count": 15,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -184,13 +477,149 @@
    "source": [
     "Account.from_key((p_stealth).to_bytes(32, \"big\")).address"
    ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "74f0325e",
+   "metadata": {},
+   "source": [
+    "## Additionally add view tags"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "ac45bb87",
+   "metadata": {},
+   "source": [
+    "In addition to S and stA, the sender also broadcasts the first byte of h(Q)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 16,
+   "id": "9645b880",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "86"
+      ]
+     },
+     "execution_count": 16,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "Q_hased[0]"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "8788f2f5",
+   "metadata": {},
+   "source": [
+    "The recipient can do the the same a before without one EC Multiplication, one EC Addition and on Public Key to Address Conversion in order to check being a potential recipient."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 17,
+   "id": "bb9f5852",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "Q_derived = secp256k1.multiply(S, p_scan)\n",
+    "Q_hex_derived = sha3.keccak_256(Q_derived[0].to_bytes(32, \"big\")\n",
+    "                                +Q_derived[1].to_bytes(32, \"big\")\n",
+    "                               ).hexdigest()\n",
+    "Q_hashed_derived = bytearray.fromhex(Q_hex_derived)"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "f7dc4624",
+   "metadata": {},
+   "source": [
+    "Check view tag"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 18,
+   "id": "953bf07d",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 18,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "run = Q_hased[0] == Q_hashed_derived[0] \n",
+    "run"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 19,
+   "id": "e11ec134",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'0xfed69df0a27f1dae0d7430ead82aaedfad6332bb'"
+      ]
+     },
+     "execution_count": 19,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "if run:\n",
+    "    P_stealth = secp256k1.add(P_spend, secp256k1.privtopub(Q_hased))\n",
+    "    P_stealthAddress  = \"0x\"+ sha3.keccak_256(stP[0].to_bytes(32, \"big\")\n",
+    "                                            + stP[1].to_bytes(32, \"big\")\n",
+    "                                            ).hexdigest()[-40:]\n",
+    "P_stealthAddress"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 20,
+   "id": "bd06ffc5",
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "True"
+      ]
+     },
+     "execution_count": 20,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "P_stealthAddress==stA"
+   ]
   }
  ],
  "metadata": {
   "kernelspec": {
-   "display_name": "stealth2",
+   "display_name": "hackathon",
    "language": "python",
-   "name": "stealth2"
+   "name": "hackathon"
   },
   "language_info": {
    "codemirror_mode": {
@@ -202,7 +631,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.10.4"
+   "version": "3.10.8"
   }
  },
  "nbformat": 4,

From 3f6dec1b006ce6d868ecf81cab0de21377de54d4 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Thu, 12 Jan 2023 11:28:55 -0800
Subject: [PATCH 168/274] Update EIP-5269 (#6320)

* Move to REview

* Update eip-5269.md

* Update

* Fix
---
 EIPS/eip-5269.md | 71 ++++++++++++++++++++++++------------------------
 1 file changed, 36 insertions(+), 35 deletions(-)

diff --git a/EIPS/eip-5269.md b/EIPS/eip-5269.md
index 9896ac0d03a2b6..161cb9ff7a872e 100644
--- a/EIPS/eip-5269.md
+++ b/EIPS/eip-5269.md
@@ -14,50 +14,47 @@ requires: 5750
 ## Abstract
 
 An interface for better identification and detection of EIP/ERC by numbers.
+It designates a field in which it's called `majorEIPIdentifier` which is normally known or referred to as "EIP number". For example, `ERC-721` aka [EIP-721](./eip-721.md) has a `majorEIPIdentifier = 721`. This EIP has a `majorEIPIdentifier = 5269`.
 
-It designate a field in which it's called `majorEIPIdentifier` which is normally known or referred to as "EIP number". For example, `ERC-721` aka [EIP-721](./eip-721.md) has a `majorEIPIdentifier = 721`. This EIP has a `majorEIPIdentifier = 5269`.
-
-Calling it as "majorEIPIdentifier" instead of "EIP number" makes it future proof: anticipating there is a possibility where future EIP is not numbered or if we want to
-incorporate other type of standards.
+Calling it a `majorEIPIdentifier` instead of `EIPNumber` makes it future-proof: anticipating there is a possibility where future EIP is not numbered or if we want to incorporate other types of standards.
 
 It also proposes a new concept of `minorEIPIdentifier` which is left for authors of
 individual EIP to define. For example, EIP-721's author may define `ERC721Metadata`
 interface as `minorEIPIdentifier= keccak256("ERC721Metadata")`.
 
-It also proposes an event to allow contract to optionally declare EIPs they support.
+It also proposes an event to allow smart contracts to optionally declare the EIPs they support.
 
 ## Motivation
 
-This EIP is created as a supplement to and competing standard for against [EIP-165](./eip-165.md).
+This EIP is created as a competing standard for [EIP-165](./eip-165.md).
 
 Here are the major differences between this EIP and [EIP-165](./eip-165.md).
 
-1. [EIP-165](./eip-165.md) uses hash of method signature which basically declares the existence of method or list of methods,
-therefore it requires a method to *exist* in the first place. In some case, some ERCs interface are not represented in the way
-of method signature, such as some EIPs related to data format and signature schemes.
-2. [EIP-165](./eip-165.md) doesn't provide query ability based on caller. This EIP respond `true` or `false` based on caller.
-
+1. [EIP-165](./eip-165.md) uses the hash of a method's signature which declares the existence of one method or multiple methods,
+therefore it requires at least one method to *exist* in the first place. In some cases, some EIP/ERCs interface does not have a method, such as some EIPs related to data format and signature schemes or the "Soul-Bound-ness" aka SBT which could just revert a transfer call without needing any specific method.
+1. [EIP-165](./eip-165.md) doesn't provide query ability based on the caller.
+The compliant contract of this EIP will respond to whether it supports certain EIP *based on* a given caller.
 
 Here is the motivation for this EIP given EIP-165 already exists:
 
 1. Using EIP/ERC numbers improves human readability as well as make it easier to work with named contract such as ENS.
 
-2. Instead of using an EIP-165 identifier, we have seen an increasing interest for using EIP/ERC numbers as the way to identify or specify a EIP/ERCs. For example
+2. Instead of using an EIP-165 identifier, we have seen an increasing interest to use EIP/ERC numbers as the way to identify or specify an EIP/ERC. For example
 
 - [EIP-5267](./eip-5267.md) specifies `extensions` to be a list of EIP numbers.
-- [EIP-600](./eip-600.md), [EIP-601](./eip-601.md) specifies EIP number in `m / purpose' / subpurpose' / EIP' / wallet'`
+- [EIP-600](./eip-600.md), and [EIP-601](./eip-601.md) specify an `EIP` number in the `m / purpose' / subpurpose' / EIP' / wallet'` path.
 - [EIP-5568](./eip-5568.md) specifies `The instruction_id of an instruction defined by an EIP MUST be its EIP number unless there are exceptional circumstances (be reasonable)`
 - [EIP-6120](./eip-6120.md) specifies `struct Token { uint eip; ..., }` where `uint eip` is an EIP number to identify EIPs.
 - `EIP-867`(Stagnant) proposes to create `erpId: A string identifier for this ERP (likely the associated EIP number, e.g. “EIP-1234”).`
 
-3. Having a ERC/EIP number detection interface reduces the need for a lookup table in smart contract to
-convert a function method or whole interface in any EIP/ERC in the bytes4 EIP-165 identifier into its respective EIP number and massively simplify the way to specify EIP for behavior expansion.
+3. Having an ERC/EIP number detection interface reduces the need for a lookup table in smart contract to
+convert a function method or whole interface in any EIP/ERC in the bytes4 EIP-165 identifier into its respective EIP number and massively simplifies the way to specify EIP for behavior expansion.
 
-4. We also recognize a smart contract might have different behavior given different caller. Most notable use case is that a common practice when using Transparent Upgradable Pattern is to give Admin and Non-Admin caller different treatment when calling a Proxy.
+4. We also recognize a smart contract might have different behavior given different caller accounts. One of the most notable use cases is that when using Transparent Upgradable Pattern, a proxy contract gives an Admin account and Non-Admin account different treatment when they call.
 
 ## Specification
 
-In the following description we use EIP and ERC inter-exchangebly. This was because while most of the time the description applies to ERC category of the Standards Track of EIP, the ERC number space is a subspace of EIP number space and we might sometimes encounter EIPs that aren't recognized as ERCs but has behavior that's worthy of queried.
+In the following description, we use EIP and ERC inter-exchangeably. This was because while most of the time the description applies to an ERC category of the Standards Track of EIP, the ERC number space is a subspace of EIP number space and we might sometimes encounter EIPs that aren't recognized as ERCs but has behavior that's worthy of a query.
 
 1. Any compliant smart contract MUST implement the following interface
 
@@ -99,33 +96,38 @@ In the following description, `EIP_5269_STATUS` is set to be `keccak256("DRAFTv1
 In addition to the behavior specified in the comments of `IERC5269`:
 
 1. Any `minorEIPIdentifier=0` is reserved to be referring to the main behavior of the EIP being queried.
-2. Authors of compliant EIP is RECOMMENDED to declare a list of `minorEIPIdentifier` for their optional interfaces, behaviors and value range for future extension.
-3. When this EIP is FINAL, any compliant contract MUST return a `EIP_5269_STATUS` for the call of `supportEIP((any caller), 5269, 0, [])`
+2. The Author of compliant EIP is RECOMMENDED to declare a list of `minorEIPIdentifier` for their optional interfaces, behaviors and value range for future extension.
+3. When this EIP is FINAL, any compliant contract MUST return an `EIP_5269_STATUS` for the call of `supportEIP((any caller), 5269, 0, [])`
 
-*Note*: at the current snapshot, `supportEIP((any caller), 5269, 0, [])` MUST return `EIP_5269_STATUS`.
+*Note*: at the current snapshot, the `supportEIP((any caller), 5269, 0, [])` MUST return `EIP_5269_STATUS`.
 
-4. Any compliant contract SHOULD emit a `OnSupportEIP(address(0), 5269, 0, EIP_5269_STATUS, [])` event upon construction or upgrade.
-5. Any compliant contract MAY declare for easy discovery any EIP main behavior or sub-behaviors by emitting event of `OnSupportEIP` with relevant values and when compliant contract changes whether the support an EIP or certain behavior for certain caller or all callers.
-6. For any `EIP-XXX` that is NOT in `Final` status, when querying `supportEIP((any caller), xxx, (any minor identifier), [])`, it MUST NOT return `keccak256("FINAL")`. It is RECOMMENDED to return `0` in this case but other value of `eipStatus` is allowed. Caller MUST treat any returned value other than `keccak256("FINAL")` as non-final, and MUST treat 0 as strictly "not supported".
-7. The `supportEIP` MUST be `view`, i.e. it MUST NOT mutate any global state of EVM.
+4. Any complying contract SHOULD emit an `OnSupportEIP(address(0), 5269, 0, EIP_5269_STATUS, [])` event upon construction or upgrade.
+5. Any complying contract MAY declare for easy discovery any EIP main behavior or sub-behaviors by emitting an event of `OnSupportEIP` with relevant values and when the compliant contract changes whether the support an EIP or certain behavior for a certain caller or all callers.
+6. For any `EIP-XXX` that is NOT in `Final` status, when querying the `supportEIP((any caller), xxx, (any minor identifier), [])`, it MUST NOT return `keccak256("FINAL")`. It is RECOMMENDED to return `0` in this case but other values of `eipStatus` is allowed. Caller MUST treat any returned value other than `keccak256("FINAL")` as non-final, and MUST treat 0 as strictly "not supported".
+7. The function `supportEIP` MUST be mutability `view`, i.e. it MUST NOT mutate any global state of EVM.
 
 ## Rationale
 
-1. When data type `uint256 majorEIPIdentifier`, there are other alternative options such as (1) use a hashed version of EIP number, or (2) use raw number, (3) use EIP-165 identifier. The pros for (1) is it automatically supports any evolvement of future EIP numbering/naming convention. But the cons is it's not backward readable: seeing a `hash(EIP-number)` one usually can't easily guess what EIP number is. We choose the (2) in the rationale laid out in motivation.
-2. We have a `bytes32 minorEIPIdentifier`, alternatively it could be (1) a number, forcing all EIP author to define its numbering for sub-behaviors so we go with a `bytes32` and asking EIP author to use a hash for a string name for their sub-behaviors which they are already doing by coming up with interface name or method name in their specification.
+1. When data type `uint256 majorEIPIdentifier`, there are other alternative options such as:
 
-3. Alternatively it's possible we add extra data as return value or an array of all EIP being supported but we are unsure how much value this complexity brings.
+- (1) using a hashed version of the EIP number,
+- (2) use a raw number, or
+- (3) use an EIP-165 identifier.
 
-4. Compared to [EIP-165](./eip-165.md), we also add an addition input of `address caller`, given the increasing popularity of proxy patterns such as those enabled by [EIP-1967](./eip-1967.md). One may ask: why not simply use `msg.sender`? This is because
-we want to allow query them without transaction or a proxy contract to query if whether interface ERC-`number` will be available to
-that particular sender.
+The pros for (1) are that it automatically supports any evolvement of future EIP numbering/naming conventions.
+But the cons are it's not backward readable: seeing a `hash(EIP-number)` one usually can't easily guess what their EIP number is.
 
-5. We reserve the input `majorEIPIdentifier` greater than or equals 2^32 in case we need to support other collection of standards which are not ERC/EIP.
+We choose the (2) in the rationale laid out in motivation.
 
-## Test Cases
+2. We have a `bytes32 minorEIPIdentifier` in our design decision. Alternatively, it could be (1) a number, forcing all EIP authors to define its numbering for sub-behaviors so we go with a `bytes32` and ask the EIP authors to use a hash for a string name for their sub-behaviors which they are already doing by coming up with interface name or method name in their specification.
+
+3. Alternatively, it's possible we add extra data as a return value or an array of all EIP being supported but we are unsure how much value this complexity brings and whether the extra overhead is justified.
 
-Here is an example of test cases.
-See Reference Implementation section for a reference implementation being tested.
+4. Compared to [EIP-165](./eip-165.md), we also add an additional input of `address caller`, given the increasing popularity of proxy patterns such as those enabled by [EIP-1967](./eip-1967.md). One may ask: why not simply use `msg.sender`? This is because we want to allow query them without transaction or a proxy contract to query whether interface ERC-`number` will be available to that particular sender.
+
+1. We reserve the input `majorEIPIdentifier` greater than or equals `2^32` in case we need to support other collections of standards which is not an ERC/EIP.
+
+## Test Cases
 
 ```typescript
 
@@ -189,7 +191,6 @@ See [`TestERC5269.ts`](../assets/eip-5269/test/TestERC5269.ts).
 Here is a reference implementation for this EIP:
 
 ```solidity
-
 contract ERC5269 is IERC5269 {
     bytes32 constant public EIP_STATUS = keccak256("DRAFTv1");
     constructor () {

From 250420822fb0a6bf96e2703e79325896fa697827 Mon Sep 17 00:00:00 2001
From: Dhruv Malik <malikdhruv1994@gmail.com>
Date: Sun, 15 Jan 2023 02:51:16 +0100
Subject: [PATCH 169/274] Add EIP-5851: On-Chain Verifiable Credentials (#5851)

* WIP: defining ERC standard for ZK based KYC verifier.

* modified:   EIPS/eip-draft-ZKID-standard.md

* WIp: description of the functions

* WIP: metadata description

* removing metadata to local docs, adding examples

* WIp: adapting the certifier contract and interface

* WIP: code refactor and adding examples

* spaces and author name

* WIP: removing eipv errors

* contd

* minor issues

* removing identation issues

* resolving another round of markdown and EIPV issues

* last one hopefully !!!

* Update spaces in-lining

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* link and image format

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* defining definition of ZK term

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Refactoring the description

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* removing redundant description of motivation points

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* refactor description

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update description points

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* explain the efficiency aspect

* title description

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* addingdefinitions to be described

* reference changes

* did all the spec changes , along with renaming asset folder

* minor refactor

* minor corrections of formula

* broken links

* linting issues

* adding new diagram

* wip: define latest workflow diagram

* leaf -> proof in setting information

* feat: reviewed with all the intial corrections and diagram description

* corrections pointed out by @Pandapip1

* never mind

* removing lint issues

* refactoring the diagram along with description of spec

* WIP: rectifying the code contracts.

* Update EIPS/eip-5851.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5851.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5851.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5851.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5851.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* WIP: commit changes by the reviewer

* Update EIPS/eip-5851.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* WIp: other description errors.

* fix lint

* fixing explanation

* adding Verifiable description changes

* contd

* WIP: rewriting the standard (currently not completed).

* changing the metadata details

* WIp: defining the example of VC.

* modified:   EIPS/eip-5851.md

* Update eip-5851.md

* Update eip-5851.md

* refactoring the description along with adding the new diagram.

 - WIP: @yuliu-debond to define the workflow regarding how the third party will  integrate the standard.

* update EIP examples and their description

* update

* Update eip-5851.md

* Update eip-5851.md

* Update eip-5851.md

* Update eip-5851.md

* Update IERC5851.sol

* Update IERC5851.sol

* Update eip-5851.md

* Update eip-5851.md

* Update eip-5851.md

* Update eip-5851.md

* Update eip-5851.md

* Update eip-5851.md

* Update IERC5851.sol

* Update verification_modifier.sol

* Update IERC5851.sol

* Update eip-5851.md

* Update IERC5851.sol

* Update SBT_certification.sol

* Create EIP-5851Verifier

* Rename EIP-5851Verifier to EIP-5851Verifier.sol

* Rename SBT_certification.sol to ERC5851Issuer.sol

* Rename EIP-5851Verifier.sol to ERC5851Verifier.sol

* Delete verification_modifier.sol

* Update test.sol

* Update ERC5851Verifier.sol

* Update ERC5851Issuer.sol

* Update ERC5851Issuer.sol

* Update IERC5851.sol

* Update ERC5851Issuer.sol

* Create ERC5851Verifier.sol

* Update test.sol

* Update eip-5851.md

* Update eip-5851.md

* Update eip-5851.md

* Update eip-5851.md

* Delete architecture-diagram-5851.png

* modified:   EIPS/eip-5851.md
- Rectifying linting issues like spacing between the headings and spellings

* adding suggestions from 5851.

	modified:   EIPS/eip-5851.md
	modified:   assets/eip-3475/ERC3475.sol
	modified:   assets/eip-5851/contracts/interfaces/IERC5851.sol

- l#3: minor refactoring
- shifting the definitions to the specification section.
- rewriting the description of claim structures.
- black-ticks for marking code.
- l#61: refactoring the description of metadata in the nature of exposure to given
- changing name of metadata type to kind for standardised names.
- refactoting the JSON description along with sentences description about the example requirement structure.
- l#95: refactoring the definition.
- defining the logic operations supported by the claim structure along with their ASCII code representation.
- defining the abstract more comprehensively.
- l#137: completing the description about the function logic.

* Update definition ZKP

* Update eip-5851.md

* update json example format eip-5851.md

* Update eip-5851.md

* minr lint

* Updated titile

* Update eip-5851.md

* resolving minor functions

* improve clarity of 'value information'

* Update eip-5851.md

* add a blank line before/after fenced code blocks

* Delete eip-5851.md

* Delete ERC5851Issuer.sol

* Delete ERC3475.sol

* Create eip-5851.md

* Create ERC5851Issuer.sol

* Create ERC3475.sol

* Update ERC3475.sol

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Co-authored-by: Shebin John <admin@remedcu.com>
Co-authored-by: yuliu-debond <79855548+yuliu-debond@users.noreply.github.com>
Co-authored-by: jooeys <zhongjunyi.dev@gmail.com>
---
 EIPS/eip-5851.md                              | 265 ++++++++++++++++++
 assets/eip-5851/contracts/ERC5851Issuer.sol   |  46 +++
 assets/eip-5851/contracts/ERC5851Verifier.sol |  17 ++
 .../contracts/interfaces/IERC5851.sol         | 130 +++++++++
 assets/eip-5851/contracts/test.sol            |  17 ++
 assets/eip-5851/script/offchainOperations.js  |  69 +++++
 6 files changed, 544 insertions(+)
 create mode 100644 EIPS/eip-5851.md
 create mode 100644 assets/eip-5851/contracts/ERC5851Issuer.sol
 create mode 100644 assets/eip-5851/contracts/ERC5851Verifier.sol
 create mode 100644 assets/eip-5851/contracts/interfaces/IERC5851.sol
 create mode 100644 assets/eip-5851/contracts/test.sol
 create mode 100644 assets/eip-5851/script/offchainOperations.js

diff --git a/EIPS/eip-5851.md b/EIPS/eip-5851.md
new file mode 100644
index 00000000000000..a886e1442f7203
--- /dev/null
+++ b/EIPS/eip-5851.md
@@ -0,0 +1,265 @@
+---
+eip: 5851
+title: On-Chain Verifiable Credentials
+description: Interface for contracts that manage verifiable claims and identifiers as Soulbound tokens.
+author: Yu Liu (@yuliu-debond), Junyi Zhong (@Jooeys)
+discussions-to: https://ethereum-magicians.org/t/eip-5815-kyc-certification-issuer-and-verifier-standard/11513
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-10-18
+requires: 721, 1155, 1167, 1967, 3475
+---
+## Abstract
+
+This proposal introduces a method of certifying that a particular address meets a claim, and a method of verifying those certifications using on-chain metadata. Claims are assertions or statements made about a subject having certain properties that may be met conditions (for example: `age >= 18`), and are certified by issuers using a Soundbound Token (SBT).
+
+## Motivation
+
+On-chain issuance of verifiable attestations are essential for use-case like:
+
+- Avoiding Sybil attacks with one person one vote
+- Participation in certain events with credentials
+- Compliance to government financial regulations etc.
+
+We are proposing a standard claims structure for Decentralized Identity (DID) issuers and verifier entities to create smart contracts in order to provide on-chain commitment of the off-chain verification process, and once the given address is associated with the given attestation of the identity verification off-chain, the issuers can then onboard other verifiers (i.e. governance, financial institution, non-profit organization, web3 related cooperation) to define the condition of the ownership of the user in order to reduce the technical barriers and overhead of current implementations.
+
+The motivation behind this proposal is to create a standard for verifier and issuer smart contracts to communicate with each other in a more efficient way. This will reduce the cost of KYC processes, and provide the possibility for on-chain KYC checks.  By creating a standard for communication between verifiers and issuers, it will create an ecosystem in which users can be sure their data is secure and private. This will ultimately lead to more efficient KYC processes and help create a more trustful environment for users. It will also help to ensure that all verifier and issuer smart contracts are up-to-date with the most recent KYC regulations.
+
+## Specification
+
+The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+### Definitions
+
+- Zero-Knowledge Proof (ZKP): a cryptographic device that can convince a verifier that an assertion is correct without revealing all of the inputs to the assertion.
+
+- Soulbound Token (SBT): A non-fungible and non-transferrable token that is used for defining the identity of the users.
+
+- SBT Certificate: An SBT that represents the ownership of ID signatures corresponding to the claims defined in `function standardClaim()`.
+
+- Verifiable Credential (VC): A collection of claims made by an issuer. These are temper evident credentials that allow the holders to prove that they posses certain characteristics (for example, passport verification, constraints like value of tokens in your wallet, etc) as demanded by the verifier entity.
+
+- Claim: An assertion that the DID Holder must fulfill to be verified.
+
+- Holder: The entity that stores the claim, such as a digital identity provider or a DID registry. The holder is responsible for validating the claim and providing verifiable evidence of the claim.
+
+- Claimer: The party making a claim, such as in an identity verification process.
+
+- Issuer: The entity that creates a verifiable credential from claims about one or more subjects to a holder. Example issuers include governments, corporations, non-profit organizations, trade associations, and individuals.
+
+- Verifier: An entity that validates data provided by an issuer of verifiable credentials, determining its accuracy, origin, currency and trustworthiness.
+
+
+
+### Metadata Standard
+
+Claims MUST be exposed in the following structures:
+
+#### 1. Metadata information
+
+Each claim requirement MUST be exposed using the following structure:
+
+```solidity
+    /** Metadata
+    * 
+    * @param title defines the name of the claim field
+    * @param _type is the type of the data (bool,string,address,bytes,..)
+    * @param description additional information about claim details.
+     */
+    struct Metadata {
+        string title;
+        string _type;
+        string description;
+    }
+```
+
+#### 2. Values Information
+
+This following structure will be used to define the actual claim information, based on the description of the `Metadata` structure, the structure is the same as `Values` structure of [EIP-3475](./eip-3475.md).
+
+```solidity
+   struct Values{
+       string stringValue;
+       uint uintValue;
+       address addressValue;
+       bool boolValue;
+  }
+```
+
+#### 3. Claim structure
+
+Claims (eg. `age >= 18`, jurisdiction in allowlist, etc.) are represented by one or many instances of the `Claim` structure below:
+
+```solidity
+    /** Claims
+    * 
+    * Claims structure consist of the conditions and value that holder claims to associate and verifier has to validate them.
+    * @notice the below given parameters are for reference purposes only, developers can optimize the fields that are needed to be represented on-chain by using schemes like TLV, encoding into base64 etc.
+    * @dev structure that defines the parameters for specific claims of the SBT certificate
+    * @notice this structure is used for the verification process, it contains the metadata, logic and expectation
+    * @notice logic can represent either the enum format for defining the different operations, or they can be logic operators (stored in form of ASCII figure based on unicode standard). like  e.g: 
+("⊄" = U+2284, "⊂" = U+2282,  "<" = U+003C , "<=" = U + 2265,"==" = U + 003D, "!="U + 2260, ">=" = U + 2265,">" =  U + 2262).
+    */
+    struct Claim {
+        Metadata metadata;
+        string logic;
+        Values expectation;
+   
+    }
+```
+
+description of some logic functions that can be used are as follows: 
+
+| Symbol | Description |
+|--------|--------------|
+| ⊄ | does not belong to the set of values (or range) defined by the corresponding `Values`  |
+| ⊂ | condition that the parameter belongs to one of values defined by the `Values`  |
+| < | condition that the parameter is greater than  value defined by the `Values`  |
+| == | condition that the parameter is strictly equal to the value defined by the `Values` structure |
+
+#### Claim Example
+
+```json
+{
+   "title":"age",
+   "type":"unit",
+   "description":"age of the person based on the birth date on the legal document",
+   "logic":">=",
+   "value":"18"
+}
+```
+
+Defines the condition encoded for the index 1 (i.e the holder must be equal or more than 18 years old).
+
+### Interface specification
+
+#### Verifier
+
+```solidity
+
+    /// @notice getter function to validate if the address `claimer` is the holder of the claim defined by the tokenId `SBTID`
+    /// @dev it MUST be defining the conditional operator (logic explained below) to allow the application to convert it into code logic 
+    /// @dev logic given here MUST be the conditiaonl operator, MUST be one of ("⊄", "⊂", "<", "<=", "==", "!=", ">=", ">")
+    /// @param claimer is the EOA address that wants to validate the SBT issued to it by the issuer. 
+    /// @param SBTID is the Id of the SBT that user is the claimer.
+    /// @return true if the assertion is valid, else false
+    /**
+    example ifVerified(0xfoo, 1) => true will mean that 0xfoo is the holder of the SBT identity token defined by tokenId of the given collection. 
+    */
+    function ifVerified(address claimer, uint256 SBTID) external view returns (bool);
+```
+
+#### Issuer  
+
+```solidity
+  
+    /// @notice getter function to fetch the on-chain identification logic for the given identity holder.
+    /// @dev it MUST not be defined for address(0). 
+    /// @param SBTID is the Id of the SBT that the user is the claimer.
+    /// @return the struct array of all the descriptions of condition metadata that is defined by the administrator for the given KYC provider.
+    /**
+    ex: standardClaim(1) --> {
+    { "title":"age",
+        "type": "uint",
+        "description": "age of the person based on the birth date on the legal document",
+        },
+       "logic": ">=",
+    "value":"18"  
+    }
+    Defines the condition encoded for the identity index 1, defining the identity condition that holder must be equal or more than 18 years old.
+    **/
+
+    function standardClaim(uint256 SBTID) external view returns (Claim[] memory);
+
+    /// @notice function for setting the claim requirement logic (defined by Claims metadata) details for the given identity token defined by SBTID.
+    /// @dev it should only be called by the admin address.
+    /// @param SBTID is the Id of the SBT-based identity certificate for which the admin wants to define the Claims.
+    /// @param `claims` is the struct array of all the descriptions of condition metadata that is defined by the administrator. check metadata section for more information.
+    /**
+    example: changeStandardClaim(1, { "title":"age",
+            "type": "uint",
+            "description": "age of the person based on the birth date on the legal document",
+            },
+        "logic": ">=",
+        "value":"18"  
+    }); 
+    will correspond to the functionality that admin needs to adjust the standard claim for the identification SBT with tokenId = 1, based on the conditions described in the Claims array struct details.
+    **/
+
+    function changeStandardClaim(uint256 SBTID, Claim[] memory _claims) external returns (bool);
+
+    /// @notice function which uses the ZKProof protocol to validate the identity based on the given 
+    /// @dev it should only be called by the admin address.
+    /// @param SBTID is the Id of the SBT-based identity certificate for which admin wants to define the Claims.
+    /// @param claimer is the address that needs to be proven as the owner of the SBT defined by the tokenID.
+    /**
+    example: certify(0xA....., 10) means that admin assigns the DID badge with id 10 to the address defined by the `0xA....` wallet.
+    */
+    function certify(address claimer, uint256 SBTID) external returns (bool);
+
+    /// @notice function which uses the ZKProof protocol to validate the identity based on the given 
+    /// @dev it should only be called by the admin address.
+    /// @param SBTID is the Id of the SBT-based identity certificate for which the admin wants to define the Claims.
+    /// @param claimer is the address that needs to be proven as the owner of the SBT defined by the tokenID.
+    /* eg: revoke(0xfoo,1): means that KYC admin revokes the SBT certificate number 1 for the address '0xfoo'. */
+    function revoke(address certifying, uint256 SBTID) external returns (bool);
+
+```
+
+#### Events
+
+```solidity
+    /** 
+    * standardChanged
+    * @notice standardChanged MUST be triggered when claims are changed by the admin. 
+    * @dev standardChanged MUST also be triggered for the creation of a new SBTID.
+    e.g : emit StandardChanged(1, Claims(Metadata('age', 'uint', 'age of the person based on the birth date on the legal document' ), ">=", "18");
+    is emitted when the Claim condition is changed which allows the certificate holder to call the functions with the modifier, claims that the holder must be equal or more than 18 years old.
+    */
+    event StandardChanged(uint256 SBTID, Claim[] _claims);
+    
+    /** 
+    * certified
+    * @notice certified MUST be triggered when the SBT certificate is given to the certifying address. 
+    * eg: Certified(0xfoo,2); means that wallet holder address `0xfoo` is certified to hold a certificate issued with id 2, and thus can satisfy all the conditions defined by the required interface.
+    */
+    event Certified(address claimer, uint256 SBTID);
+    
+    /** 
+    * revoked
+    * @notice revoked MUST be triggered when the SBT certificate is revoked. 
+    * eg: Revoked( 0xfoo,1); means that entity user 0xfoo has been revoked to all the function access defined by the SBT ID 1.
+    */
+    event Revoked(address claimer, uint256 SBTID);
+}
+```
+
+## Rationale
+
+TBD
+
+## Backwards Compatibility
+
+- This EIP is backward compliant for the contracts that keep intact the metadata structure of previous issued SBT's with their ID and claim requirement details.
+  - For e.g if the DeFI provider (using the modifiers to validate the ownership of required SBT by owner) wants the admin to change the logic of verification or remove certain claim structure, the previous holders of the certificates will be affected by these changes.
+
+## Test Cases
+
+Test cases for the minimal reference implementation can be found [here](../assets/eip-5851/contracts/test.sol) for using transaction verification regarding whether the users hold the tokens or not. Use Remix IDE to compile and test the contracts.
+
+## Reference Implementation
+
+The [interface](../assets/eip-5851/contracts/interfaces/IERC5851.sol) is divided into two separate implementations:
+
+- [EIP-5851 Verifier](../assets/eip-5851/contracts/ERC5851Verifier.sol) is a simple modifier that needs to be imported by functions that are to be only called by holders of the SBT certificates. Then the modifier will call the issuer contract to verifiy if the claimer has the SBT certifcate in question.
+
+- [EIP-5851 Issuer](../assets/eip-5851/contracts/ERC5851Issuer.sol) is an example of an identity certificate that can be assigned by a KYC controller contract. This is a full implementation of the standard interface.
+
+## Security Considerations
+
+1. Implementation of functional interfaces for creating KYC on SBT (i.e `changeStandardClaim()`, `certify()` and `revoke()`) are dependent on the admin role. Thus the developer must insure security of admin role and rotation of this role to the entity entrusted by the KYC attestation service provider and DeFI protocols that are using this attestation service.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-5851/contracts/ERC5851Issuer.sol b/assets/eip-5851/contracts/ERC5851Issuer.sol
new file mode 100644
index 00000000000000..f6e91ded89560e
--- /dev/null
+++ b/assets/eip-5851/contracts/ERC5851Issuer.sol
@@ -0,0 +1,46 @@
+
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+import "./interfaces/IERC5851.sol";
+
+
+abstract contract ERC5851Issuer is IERC5851{
+    mapping(uint256 => IERC5851.Claim[]) private _claimMetadata;
+    mapping(address => mapping(uint256 => bool)) private _SBTVerified;
+    address public admin;
+    
+    constructor() {
+        admin = msg.sender;
+
+    }
+    
+    function ifVerified(address claimmer, uint256 SBTID) public override view returns (bool){
+        return(_SBTVerified[claimmer][SBTID]);
+    }
+    
+    function standardClaim(uint256 SBTID) public override view returns (Claim[] memory){
+        return(_claimMetadata[SBTID]);
+    }
+
+    function changeStandardClaim(uint256 SBTID, Claim[] memory _claims) public override returns (bool){
+        require(msg.sender == admin);
+        _claimMetadata[SBTID] = _claims;    
+        emit StandardChanged(SBTID, _claims);
+        return(true);     
+    }
+
+    function certify(address claimer, uint256 SBTID) public override returns (bool){
+        require(msg.sender == admin);
+        _SBTVerified[claimer][SBTID] = true;
+        emit Certified(claimer, SBTID);
+        return(true);     
+    }
+
+    function revoke(address claimer, uint256 SBTID) external override returns (bool){
+        require(msg.sender == admin);
+        _SBTVerified[claimer][SBTID] = false;
+        emit Revoked(claimer, SBTID);
+        return(true);     
+    }
+
+}
diff --git a/assets/eip-5851/contracts/ERC5851Verifier.sol b/assets/eip-5851/contracts/ERC5851Verifier.sol
new file mode 100644
index 00000000000000..75c663379e4a32
--- /dev/null
+++ b/assets/eip-5851/contracts/ERC5851Verifier.sol
@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+import "./interfaces/IERC5851.sol";
+
+abstract contract ERC5851Verifier is IERC5851 {
+    address private _issuer;
+
+    constructor(address issuer) {
+        _issuer = issuer;
+    }
+
+    modifier KYCApproved(address claimer, uint256 SBTID) {
+        IERC5851(_issuer).ifVerified(claimer, SBTID);
+        _;
+    }
+
+}
diff --git a/assets/eip-5851/contracts/interfaces/IERC5851.sol b/assets/eip-5851/contracts/interfaces/IERC5851.sol
new file mode 100644
index 00000000000000..a045e9cae718d5
--- /dev/null
+++ b/assets/eip-5851/contracts/interfaces/IERC5851.sol
@@ -0,0 +1,130 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.0;
+
+interface IERC5851{
+    
+    /** Metadata
+    * 
+    * @param title defines the name of the claim field
+    * @param kind is the nature of the data (bool,string,address,bytes,..)
+    * @param description additional information about claim details.
+    */
+    struct Metadata {
+        string title;
+        string kind;
+        string description;
+    }
+    
+    /** Values
+    * 
+    * @dev Values here can be read and wrote by smartcontract and front-end, cited from [EIP-3475](./eip-3475.md) 
+    */   
+    struct Values { 
+        string stringValue;
+        uint uintValue;
+        address addressValue;
+        bool boolValue;
+    }
+
+    /** Claim
+    * 
+    * Claims structure consist of the conditions and value that holder claims to associate and verifier has to validate them.
+    * @notice the below given parameters are for reference purposes only, developers can optimize the fields that are needed to be represented on-chain by using schemes like TLV, encoding into base64 etc.
+    * @dev structure that DeFines the parameters for specific claims of the SBT certificate
+    * @notice this structure is used for the verification process, it contains the metadata, logic and expectation
+    * @logic given here MUST be one of ("⊄", "⊂", "<", "<=", "==", "!=", ">=",">")
+    */
+    struct Claim {
+        Metadata metadata;
+        string logic;
+        Values expectation;   
+    }
+
+    //Verifier
+    /// @notice getter function to validate if the address `claimer` is the holder of the claim Defined by the tokenId `SBTID`
+    /// @dev it MUST be Defining the logic to fetch the result of the ZK verification (either from).
+    /// @dev logic given here MUST be one of ("⊄", "⊂", "<", "<=", "==", "!=", ">=", ">")
+    /// @param claimer is the EOA address that wants to validate the SBT issued to it by the KYC. 
+    /// @param SBTID is the Id of the SBT that user is the claimer.
+    /// @return true if the assertion is valid, else false
+    /**
+    example ifVerified(0xfoo, 1) => true will mean that 0xfoo is the holder of the SBT identity token DeFined by tokenId of the given collection. 
+    */
+    function ifVerified(address claimer, uint256 SBTID) external view returns (bool);
+
+    //Issuer
+    /// @notice getter function to fetch the on-chain identification logic for the given identity holder.
+    /// @dev it MUST not be defined for address(0). 
+    /// @param SBTID is the Id of the SBT that the user is the claimer.
+    /// @return the struct array of all the descriptions of condition metadata that is defined by the administrator for the given KYC provider.
+    /**
+    ex: standardClaim(1) --> {
+    { "title":"age",
+        "kind": "uint",
+        "description": "age of the person based on the birth date on the legal document",
+        },
+       "logic": ">=",
+    "value":"18"  
+    }
+    Defines the condition encoded for the identity index 1, DeFining the identity condition that holder must be equal or more than 18 years old.
+    **/
+    function standardClaim(uint256 SBTID) external view returns (Claim[] memory);
+
+    /// @notice function for setting the claim requirement logic (defined by Claims metadata) details for the given identity token defined by SBTID.
+    /// @dev it should only be called by the admin address.
+    /// @param SBTID is the Id of the SBT-based identity certificate for which the admin wants to define the Claims.
+    /// @param `claims` is the struct array of all the descriptions of condition metadata that is defined by the administrator. check metadata section for more information.
+    /**
+    example: changeStandardClaim(1, { "title":"age",
+            "kind": "uint",
+            "description": "age of the person based on the birth date on the legal document",
+            },
+        "logic": ">=",
+        "value":"18"  
+    }); 
+    will correspond to the functionality that admin needs to adjust the standard claim for the identification SBT with tokenId = 1, based on the conditions described in the Claims array struct details.
+    **/
+    function changeStandardClaim(uint256 SBTID, Claim[] memory _claims) external returns (bool);
+
+    /// @notice function which uses the ZKProof protocol to validate the identity based on the given 
+    /// @dev it should only be called by the admin address.
+    /// @param SBTID is the Id of the SBT-based identity certificate for which admin wants to define the Claims.
+    /// @param claimer is the address that needs to be proven as the owner of the SBT defined by the tokenID.
+    /**
+    example: certify(0xA....., 10) means that admin assigns the DID badge with id 10 to the address defined by the `0xA....` wallet.
+    */
+    function certify(address claimer, uint256 SBTID) external returns (bool);
+
+    /// @notice function which uses the ZKProof protocol to validate the identity based on the given 
+    /// @dev it should only be called by the admin address.
+    /// @param SBTID is the Id of the SBT-based identity certificate for which the admin wants to define the Claims.
+    /// @param certifying is the address that needs to be proven as the owner of the SBT defined by the tokenID.
+    // eg: revoke(0xfoo,1): means that KYC admin revokes the SBT certificate number 1 for the address '0xfoo'.
+    function revoke(address certifying, uint256 SBTID) external returns (bool);
+
+
+// Events
+    /** 
+    * standardChanged
+    * @notice standardChanged MUST be triggered when claims are changed by the admin. 
+    * @dev standardChanged MUST also be triggered for the creation of a new SBTID.
+    e.g : emit StandardChanged(1, Claims(Metadata('age', 'uint', 'age of the person based on the birth date on the legal document'), ">=", "18");
+    is emitted when the Claim condition is changed which allows the certificate holder to call the functions with the modifier, claims that the holder must be equal or more than 18 years old.
+    */
+    event StandardChanged(uint256 SBTID, Claim[] _claims);
+    
+    /** 
+    * certified
+    * @notice certified MUST be triggered when the SBT certificate is given to the certifying address. 
+    * eg: Certified(0xfoo,2); means that wallet holder address 0xfoo is certified to hold a certificate issued with id 2, and thus can satisfy all the conditions defined by the required interface.
+    */
+    event Certified(address claimer, uint256 SBTID);
+    
+    /** 
+    * revoked
+    * @notice revoked MUST be triggered when the SBT certificate is revoked. 
+    * eg: Revoked( 0xfoo,1); means that entity user 0xfoo has been revoked to all the function access defined by the SBT ID 1.
+    */
+    event Revoked(address claimer, uint256 SBTID);
+}
diff --git a/assets/eip-5851/contracts/test.sol b/assets/eip-5851/contracts/test.sol
new file mode 100644
index 00000000000000..a299dbb65685d8
--- /dev/null
+++ b/assets/eip-5851/contracts/test.sol
@@ -0,0 +1,17 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+import "./ERC5851Verifier.sol";
+
+abstract contract Token is ERC5851Verifier {
+    uint public test;
+    uint public SBTID;
+    function mint(address to, uint256 amount) public KYCApproved(to, SBTID){
+        _mint(to, amount);
+    }
+
+    function _mint(address account, uint256 amount) internal  {
+        require(account != address(0), "ERC20: mint to the zero address");
+        test = amount;
+    }
+
+}
diff --git a/assets/eip-5851/script/offchainOperations.js b/assets/eip-5851/script/offchainOperations.js
new file mode 100644
index 00000000000000..e2636d32d830d6
--- /dev/null
+++ b/assets/eip-5851/script/offchainOperations.js
@@ -0,0 +1,69 @@
+// CC0 license.
+// taken from (credits): https://soliditydeveloper.com/merkle-tree 
+const keccak256 = require("keccak256");
+const { MerkleTree } = require("merkletreejs");
+
+const Web3 = require("web3");
+
+const web3 = new Web3();
+
+
+/**
+ * generates the proof offchain using the  PII information of the user and associated it with the other parameter details.
+ * 
+ */
+
+async function generateProof() {
+
+// consider the given information that is verified privately off-chain  (storing with wallet, name, age, personal ID, jurisdiction) 
+// they will be considered as leaves for the application.
+const personalIdentifiedInfo = ["0x00000a86986129038908a9808098-toto-18-99123456-France", "0x00000a86986129038908a9808098-john-20-1276546-England"].map(x => keccak256(x));
+const tree = new MerkleTree(leaves,keccak256);
+
+}
+
+
+/**
+ * this checks the ownership of the information from requirement (stored onchain) and then verify whether the keccak256 representation is a member of the given proof. 
+ * we follow the checkProof  
+ */
+async function verifyRequirement(verifyingAddress,leafNodes) {
+const buf2hex = x => '0x'+x.toString('hex')
+const leaf = keccak256('0x00000a86986129038908a9808098-toto-18-99123456-France')
+
+const leafInfo = buf2hex(leaf);
+
+const hexproof = tree.getProof(leaf).map(x => buf2hex(x.data));
+
+const positions = tree.getProof(leaf).map(x => x.position === 'right' ? 1 : 0)
+
+
+
+//TODO: fetch the 
+const SBTCertification = await web3.eth.Contract();
+
+const verifiedOnchain = await SBTCertification.ifVerified(verifyingAddress, leafNodes);
+
+assert.equal(MerkleTree.verify(proof,leaf,root), verifiedOnchain);
+
+}
+
+
+
+const root = tree.getRoot();
+
+
+// this is the root generated by claim verifier, by doing the operations offchain.
+const hexroot = buf2hex(root);
+
+const merkleTree = new MerkleTree(leafNodes, keccak256, { sortPairs: true });
+
+console.log("---------");
+console.log("Merke Tree");
+console.log("---------");
+console.log(merkleTree.toString());
+console.log("---------");
+console.log("Merkle Root: " + merkleTree.getHexRoot());
+
+console.log("Proof 1: " + merkleTree.getHexProof(leafNodes[0]));
+console.log("Proof 2: " + merkleTree.getHexProof(leafNodes[1]));

From eca64fe83d7df37b3f3b1e2cb512cf6f671d3b20 Mon Sep 17 00:00:00 2001
From: "5660.eth" <76733013+5660-eth@users.noreply.github.com>
Date: Sun, 15 Jan 2023 12:12:59 +0800
Subject: [PATCH 170/274] Update eip-6147.md (#6331)

---
 EIPS/eip-6147.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/EIPS/eip-6147.md b/EIPS/eip-6147.md
index 394dab6a54c06c..1c790503c96523 100644
--- a/EIPS/eip-6147.md
+++ b/EIPS/eip-6147.md
@@ -147,7 +147,7 @@ pragma solidity ^0.8.8;
 import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
 import "./IERC6147.sol";
 
-abstract contract ERC721QS is ERC721, IERC6147 {
+abstract contract ERC6147 is ERC721, IERC6147 {
     
     mapping(uint256 => address) internal token_guard_map;
 
@@ -160,12 +160,12 @@ abstract contract ERC721QS is ERC721, IERC6147 {
     function updateGuard(uint256 tokenId,address newGuard,bool allowNull) internal {
         address guard = guardOf(tokenId);
         if (!allowNull) {
-            require(newGuard != address(0), "New guard can not be null");
+            require(newGuard != address(0), "ERC6147: new guard can not be null");
         }
         if (guard != address(0)) { 
-            require(guard == _msgSender(), "only guard can change it self"); 
+            require(guard == _msgSender(), "ERC6147: only guard can change it self"); 
         } else { 
-            require(_isApprovedOrOwner(_msgSender(), tokenId),"ERC721QS: caller is not owner nor approved");
+            require(_isApprovedOrOwner(_msgSender(), tokenId),""ERC6147: caller is not owner nor approved");
         } 
 
         if (guard != address(0) || newGuard != address(0)) {
@@ -271,7 +271,7 @@ abstract contract ERC721QS is ERC721, IERC6147 {
 
     /// @dev See {IERC165-supportsInterface}.
     function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
-        return interfaceId == type(IERC721QS).interfaceId || super.supportsInterface(interfaceId);
+        return interfaceId == type(IERC6147).interfaceId || super.supportsInterface(interfaceId);
     }
 }
 

From 725c2da2fab4d576a264c485b873abf71904db7f Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sun, 15 Jan 2023 09:04:24 -0500
Subject: [PATCH 171/274] Update EIP-5920: Gas cost update and burning via zero
 address (#6332)

---
 EIPS/eip-5920.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/EIPS/eip-5920.md b/EIPS/eip-5920.md
index 99922143cdfae2..9a899d93eb924d 100644
--- a/EIPS/eip-5920.md
+++ b/EIPS/eip-5920.md
@@ -23,16 +23,17 @@ Currently, to send ether to an address requires you to call a function of that a
 | Parameter           | Value   |
 | ------------------- | ------- |
 | `PAY_OPCODE`        | `0xf9`  |
-| `BASE_GAS_COST`     | `8600`  |
-| `COLD_GAS_COST`     | `11100`  |
+| `BASE_GAS_COST`     | `8500`  |
+| `WARM_GAS_COST`     | `100`   |
+| `COLD_GAS_COST`     | `2500`  |
 | `CREATION_GAS_COST` | `32600` |
 
 A new opcode is introduced: `PAY` (`PAY_OPCODE`), which:
 
 - Pops two values from the stack: `addr` then `val`.
-- Transfers `val` wei to the address `addr`.
+- Transfers `val` wei from the executing address to the address `addr`. If `addr` is the zero address, instead, `val` wei is burned from the executing address.
 
-The cost of this opcode is `BASE_GAS_COST` if `addr` is a warm account, `COLD_GAS_COST` if `addr` is a cold account that is already in the state trie, or `BASE_GAS_COST+CREATION_GAS_COST` if `addr` has not yet been added to the state trie.
+The cost of this opcode is `BASE_GAS_COST`. If `addr` is not the zero address, this opcode costs an additional `WARM_GAS_COST` if `addr` is a warm account, `COLD_GAS_COST` if `addr` is a cold account, or `CREATION_GAS_COST` if `addr` has not yet been created.
 
 ## Rationale
 

From eaabdb7a266df4546eaacd027f6b62aac4919ecf Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sun, 15 Jan 2023 09:08:11 -0500
Subject: [PATCH 172/274] Update EIP-6189: Add support for EIP-5920 (#6333)

---
 EIPS/eip-6189.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-6189.md b/EIPS/eip-6189.md
index 2dc6ccc08550f9..8608ead4dd637e 100644
--- a/EIPS/eip-6189.md
+++ b/EIPS/eip-6189.md
@@ -33,9 +33,9 @@ A contract is an alias contract if its nonce is `2^64-1`, and its contract code
 
 ### Opcode Changes
 
-#### `CALL`, `CALLCODE`, `DELEGATECALL`, `STATICCALL`, and EOA Transactions
+#### `CALL`, `CALLCODE`, `DELEGATECALL`, `STATICCALL`, `PAY`, and EOA Transactions
 
-The "callee" refers to the account that is being called.
+The "callee" refers to the account that is being called or being paid.
 
 If the nonce of the callee is `2^64-1`, the call is forwarded to the address stored in the `0`th storage slot of the callee (as if the callee was the address stored in the `0`th storage slot of the callee). This repeats until a non-alias contract is reached. The `CALLER` remains unchanged.
 

From 3f430daecc31005ae99981e1f877c38e76af10c6 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Mon, 16 Jan 2023 06:21:14 -0800
Subject: [PATCH 173/274] Move to Review (#6326)

---
 EIPS/eip-5269.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5269.md b/EIPS/eip-5269.md
index 161cb9ff7a872e..eb1b25ea608d9e 100644
--- a/EIPS/eip-5269.md
+++ b/EIPS/eip-5269.md
@@ -4,7 +4,7 @@ title: EIP/ERC Detection and Discovery
 description: An interface to identify if major behavior or optional behavior specified in an ERC is supported for a given caller.
 author: Zainan Victor Zhou (@xinbenlv)
 discussions-to: https://ethereum-magicians.org/t/erc5269-human-readable-interface-detection/9957
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-07-15

From b56a299fbad4ee701e6d4cea025096effaf301fa Mon Sep 17 00:00:00 2001
From: Alex Stokes <r.alex.stokes@gmail.com>
Date: Mon, 16 Jan 2023 11:17:11 -0700
Subject: [PATCH 174/274] EIP-4895: CL-EL withdrawals harmonization: using
 units of Gwei (#6325)

* harmonize the CL-EL representation of the withdrawal amounts

* Update EIPS/eip-4895.md

* harmonize the CL-EL representation of the withdrawal amounts
---
 EIPS/eip-4895.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-4895.md b/EIPS/eip-4895.md
index bf45884c9940f8..0966bbc3ff9212 100644
--- a/EIPS/eip-4895.md
+++ b/EIPS/eip-4895.md
@@ -41,10 +41,11 @@ Define a new payload-level object called a `withdrawal` that describes withdrawa
 `Withdrawal`s are syntactically similar to a user-level transaction but live in a different domain than user-level transactions.
 
 `Withdrawal`s provide key information from the consensus layer:
+
 1. a monotonically increasing `index`, starting from 0, as a `uint64` value that increments by 1 per withdrawal to uniquely identify each withdrawal
 2. the `validator_index` of the validator, as a `uint64` value, on the consensus layer the withdrawal corresponds to
 3. a recipient for the withdrawn ether `address` as a 20-byte value
-4. a nonzero `amount` of ether given in wei as a `uint256` value.
+4. a nonzero `amount` of ether given in Gwei (1e9 wei) as a `uint64` value.
 
 *NOTE*: the `index` for each withdrawal is a global counter spanning the entire sequence of withdrawals.
 
@@ -129,6 +130,8 @@ The `withdrawals` in an execution payload are processed **after** any user-level
 
 For each `withdrawal` in the list of `execution_payload.withdrawals`, the implementation increases the balance of the `address` specified by the `amount` given.
 
+Recall that the `amount` is given in units of Gwei so a conversion to units of wei must be performed when working with account balances in the execution state.
+
 This balance change is unconditional and **MUST** not fail.
 
 This operation has no associated gas costs.

From e9f53e712fbf6f51d6edcc0c3fd0761d633b99c5 Mon Sep 17 00:00:00 2001
From: Artem Chystiakov <47551140+Arvolear@users.noreply.github.com>
Date: Mon, 16 Jan 2023 20:31:55 +0200
Subject: [PATCH 175/274] Add EIP-6224: Contracts Dependencies Registry (#6224)

* added EIP: ContractsRegistry the Dependency Injector

* updated EIP number

* fix typos

* fix headings linting errors

* updated discussion link

* Apply suggestions from code review

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* code review fixes

* fix eip name and description

* fix discussion link

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-6224.md | 255 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 255 insertions(+)
 create mode 100644 EIPS/eip-6224.md

diff --git a/EIPS/eip-6224.md b/EIPS/eip-6224.md
new file mode 100644
index 00000000000000..0f815adc0948bc
--- /dev/null
+++ b/EIPS/eip-6224.md
@@ -0,0 +1,255 @@
+---
+eip: 6224
+title: Contracts Dependencies Registry
+description: An interface for managing smart contracts with their dependencies.
+author: Artem Chystiakov (@arvolear)
+discussions-to: https://ethereum-magicians.org/t/eip-6224-contracts-dependencies-registry/12316
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-12-27
+requires: 1967, 5750
+---
+
+## Abstract
+
+The EIP standardizes the management of smart contracts within the decentralized application ecosystem. It enables protocols to become upgradeable and reduces their maintenance threshold. This EIP additionally introduces a smart contract dependency injection mechanism to audit dependency usage, to aid larger composite projects.
+
+## Motivation
+
+In the ever-growing Ethereum, projects tend to become more and more complex. Modern protocols require portability and agility to satisfy customer needs by continuously delivering new features and staying on pace with the industry. However, the requirement is hard to achieve due to the immutable nature of blockchains and smart contracts. Moreover, the increased complexity and continuous delivery bring bugs and entangle the dependencies between the contracts, making systems less supportable.
+
+Applications that have a clear facade and transparency upon their dependencies are easier to develop and maintain. The given EIP tries to solve the aforementioned problems by presenting two concepts: the **contracts registry** and the **dependant**.
+
+The advantages of using the provided pattern might be:
+
+- Structured smart contracts management via specialized contract.
+- Ad-hoc upgradeability provision.
+- Runtime smart contracts addition, removal, and substitution.
+- Dependency injection mechanism to keep smart contracts' dependencies under control.
+
+## Specification
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+### ContractsRegistry
+
+The `ContractsRegistry` MUST implement the following interface:
+
+```solidity
+pragma solidity ^0.8.0;
+
+interface IContractsRegistry {
+   /**
+    *  @notice REQUIRED The event that is emitted when the contract gets added to the registry
+    *  @param name the name of the contract
+    *  @param contractAddress the address of the added contract
+    *  @param isProxy whether the added contract is a proxy
+    */
+   event AddedContract(string name, address contractAddress, bool isProxy);
+
+   /**
+    *  @notice REQUIRED The event that is emitted when the contract get removed from the registry
+    *  @param name the name of the removed contract
+    */
+   event RemovedContract(string name);
+
+   /**
+    *  @notice REQUIRED The function that returns an associated contract by the name
+    *  @param name the name of the contract
+    *  @return the address of the contract
+    */
+   function getContract(string memory name) external view returns (address);
+
+   /**
+    *  @notice OPTIONAL The function that checks if a contract with a given name has been added
+    *  @param name the name of the contract
+    *  @return true if the contract is present in the registry
+    */
+   function hasContract(string memory name) external view returns (bool);
+
+   /**
+    *  @notice RECOMMENDED The function that returns the admin of the added proxy contracts
+    *  @return the proxy admin address
+    */
+   function getProxyUpgrader() external view returns (address);
+
+   /**
+    *  @notice RECOMMENDED The function that returns an implementation of the given proxy contract
+    *  @param name the name of the contract
+    *  @return the implementation address
+    */
+   function getImplementation(string memory name) external view returns (address);
+
+   /**
+    *  @notice REQUIRED The function that injects dependencies into the given contract.
+    *  MUST call the setDependencies() with address(this) and bytes("") as arguments on the substituted contract
+    *  @param name the name of the contract
+    */
+   function injectDependencies(string memory name) external;
+
+   /**
+    *  @notice REQUIRED The function that injects dependencies into the given contract with extra data.
+    *  MUST call the setDependencies() with address(this) and given data as arguments on the substituted contract
+    *  @param name the name of the contract
+    *  @param data the extra context data
+    */
+   function injectDependenciesWithData(
+        string calldata name,
+        bytes calldata data
+    ) external;
+
+   /**
+    *  @notice REQUIRED The function that upgrades added proxy contract with a new implementation
+    *  @param name the name of the proxy contract
+    *  @param newImplementation the new implementation the proxy will be upgraded to
+    *
+    *  It is the Owner's responsibility to ensure the compatibility between implementations
+    */
+   function upgradeContract(string memory name, address newImplementation) external;
+
+   /**
+    *  @notice RECOMMENDED The function that upgrades added proxy contract with a new implementation, providing data
+    *  @param name the name of the proxy contract
+    *  @param newImplementation the new implementation the proxy will be upgraded to
+    *  @param data the data that the new implementation will be called with. This can be an ABI encoded function call
+    *
+    *  It is the Owner's responsibility to ensure the compatibility between implementations
+    */
+   function upgradeContractAndCall(
+       string memory name,
+       address newImplementation,
+       bytes memory data
+   ) external;
+
+   /**
+    *  @notice REQUIRED The function that adds pure (non-proxy) contracts to the ContractsRegistry. The contracts MAY either be
+    *  the ones the system does not have direct upgradeability control over or the ones that are not upgradeable by design
+    *  @param name the name to associate the contract with
+    *  @param contractAddress the address of the contract
+    */
+   function addContract(string memory name, address contractAddress) external;
+
+   /**
+    *  @notice REQUIRED The function that adds the contracts and deploys the Transaprent proxy above them.
+    *  It MAY be used to add contract that the ContractsRegistry has to be able to upgrade
+    *  @param name the name to associate the contract with
+    *  @param contractAddress the address of the implementation
+    */
+   function addProxyContract(string memory name, address contractAddress) external;
+
+   /**
+    *  @notice RECOMMENDED The function that adds an already deployed proxy to the ContractsRegistry. It MAY be used
+    *  when the system migrates to the new ContractRegistry. In that case, the new ProxyUpgrader MUST have the
+    *  credentials to upgrade the newly added proxies
+    *  @param name the name to associate the contract with
+    *  @param contractAddress the address of the proxy
+    */
+   function justAddProxyContract(string memory name, address contractAddress) external;
+
+   /**
+    *  @notice REQUIRED The function to remove contracts from the ContractsRegistry
+    *  @param name the associated name with the contract
+    */
+   function removeContract(string memory name) external;
+}
+```
+
+- The `ContractsRegistry` MUST deploy the `ProxyUpgrader` contract in the constructor that MUST be set as an admin of `Transparent` proxies deployed via `addProxyContract` method.
+- It MUST NOT be possible to add the zero address to the `ContractsRegistry`.
+- The `ContractsRegistry` MUST use the `IDependant` interface in the `injectDependencies` and `injectDependenciesWithData` methods.
+
+### Dependant
+
+The `Dependant` contract is the one that depends on other contracts present in the system. In order to support dependency injection mechanism, the dependant contract MUST implement the following interface:
+
+```solidity
+pragma solidity ^0.8.0;
+
+interface IDependant {
+   /**
+    *  @notice The function that is called from the ContractsRegistry (or factory) to inject dependencies.
+    *  @param contractsRegistry the registry to pull dependencies from
+    *  @param data the extra data that might provide additional application-specific context/behavior
+    *
+    *  The Dependant MUST perform a dependency injector access check to this method
+    */
+   function setDependencies(address contractsRegistry, bytes calldata data) external;
+
+   /**
+    *  @notice The function that sets the new dependency injector.
+    *  @param injector the new dependency injector
+    *
+    *  The Dependant MUST perform a dependency injector access check to this method
+    */
+   function setInjector(address injector) external;
+
+   /**
+    *  @notice The function that gets the current dependency injector
+    *  @return the current dependency injector
+    */
+   function getInjector() external view returns (address);
+}
+```
+
+- The `Dependant` contract MUST pull its dependencies in the `setDependencies` method from the passed `contractsRegistry` address.
+- The `Dependant` contract MAY store the dependency injector address in the special slot `0x3d1f25f1ac447e55e7fec744471c4dab1c6a2b6ffb897825f9ea3d2e8c9be583` (obtained as `bytes32(uint256(keccak256("eip6224.dependant.slot")) - 1)`).
+
+
+## Rationale
+
+There are a few design decisions that have to be specified explicitly:
+
+### ContractsRegistry Rationale
+
+#### Usage
+
+The extensions of this EIP SHOULD add proper access control checks to the described non-view methods. 
+
+The `getContract` and `getImplementation` methods MUST revert if the nonexistent contracts are queried.
+
+The `ContractsRegistry` MAY be set behind the proxy to enable runtime addition of custom methods. Applications MAY also leverage the pattern to develop custom tree-like `ContractsRegistry` data structures.
+
+#### Contracts identifier
+
+The `string` contracts identifier is chosen over the `uint256` and `bytes32` to maintain code readability and reduce the human-error chances when interacting with the `ContractsRegistry`. Being the topmost smart contract, it MAY be typical for the users to interact with it via block explorers or DAOs. Clarity was prioritized over gas usage.
+
+#### Proxy
+
+The `Transparent` proxy is chosen over the `UUPS` proxy to hand the upgradeability responsibility to the `ContractsRegistry` itself. The extensions of this EIP MAY use the proxy of their choice.
+
+### Dependant Rationale
+
+#### Dependencies
+
+The required dependencies MUST be set in the overridden `setDependencies` method, not in the `constructor` or `initializer` methods.
+
+The `data` parameter is provided to carry additional application-specific context. It MAY be used to extend the method's behavior.
+
+#### Injector
+
+Only the injector MUST be able to call the `setDependencies` and `setInjector` methods. The initial injector will be a zero address, in that case, the call MUST NOT revert on access control checks. The `setInjector` function is made `external` to support the dependency injection mechanism for factory-made contracts. However, the method SHOULD be used with extra care.
+
+The injector address MAY be stored in the dedicated slot `0x3d1f25f1ac447e55e7fec744471c4dab1c6a2b6ffb897825f9ea3d2e8c9be583` to exclude the chances of storage collision.
+
+## Reference Implementation
+
+*0xdistributedlab-solidity-library dev-modules* provides a reference implementation.
+
+## Security Considerations
+
+The described EIP must be used with extra care as the loss/leakage of credentials to the `ContractsRegistry` leads to the application's point of no return. The `ContractRegistry` is a cornerstone of the protocol, access must be granted to the trusted parties only.
+
+### ContractsRegistry Security Considerations
+
+- The non-view methods of `ContractsRegistry` contract MUST be overridden with proper access control checks.  
+- The `ContractsRegistry` does not perform any upgradeability checks between the proxy upgrades. It is the user's responsibility to make sure that the new implementation is compatible with the old one.
+
+### Dependant Security Considerations
+
+- The non-view methods of `Dependant` contract MUST be overridden with proper access control checks. Only the dependency injector MUST be able to call them.
+- The `Dependant` contract MUST set its dependency injector no later than the first call to the `setDependencies` function is made. That being said, it is possible to front-run the first dependency injection.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 9dbb2489c2f5ff751ceb1b3505f854f3679d83bc Mon Sep 17 00:00:00 2001
From: Alex Beregszaszi <alex@rtfs.hu>
Date: Tue, 17 Jan 2023 03:23:49 +0100
Subject: [PATCH 176/274] EIP-4844: Explicitly state sha256 is used (#6345)

---
 EIPS/eip-4844.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4844.md b/EIPS/eip-4844.md
index b380662ef7088a..fbf8bd3c4f6087 100644
--- a/EIPS/eip-4844.md
+++ b/EIPS/eip-4844.md
@@ -82,7 +82,7 @@ Specifically, we use the following methods from [`polynomial-commitments.md`](ht
 
 ```python
 def kzg_to_versioned_hash(kzg: KZGCommitment) -> VersionedHash:
-    return BLOB_COMMITMENT_VERSION_KZG + hash(kzg)[1:]
+    return BLOB_COMMITMENT_VERSION_KZG + sha256(kzg)[1:]
 ```
 
 Approximates `factor * e ** (numerator / denominator)` using Taylor expansion:

From 739e75c93b94fc49e8005943d052fa4e1ac1be80 Mon Sep 17 00:00:00 2001
From: protolambda <proto@protolambda.com>
Date: Tue, 17 Jan 2023 17:09:47 +0100
Subject: [PATCH 177/274] Update EIP-4844: clarify datahash return value
 (#6348)

It is replaced with the input on the stack.
---
 EIPS/eip-4844.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-4844.md b/EIPS/eip-4844.md
index fbf8bd3c4f6087..ef61aa9370fe7a 100644
--- a/EIPS/eip-4844.md
+++ b/EIPS/eip-4844.md
@@ -243,9 +243,9 @@ The `ethereum/consensus-specs` repository defines the following beacon-node chan
 
 ### Opcode to get versioned hashes
 
-We add an opcode `DATAHASH` (with byte value `HASH_OPCODE_BYTE`) which takes as input one stack argument `index`,
-and returns `tx.message.blob_versioned_hashes[index]` if `index < len(tx.message.blob_versioned_hashes)`,
-and otherwise zero.
+We add an opcode `DATAHASH` (with byte value `HASH_OPCODE_BYTE`) which reads `index` from the top of the stack
+as big-endian `uint256`, and replaces it on the stack with `tx.message.blob_versioned_hashes[index]`
+if `index < len(tx.message.blob_versioned_hashes)`, and otherwise with a zeroed `bytes32` value.
 The opcode has a gas cost of `HASH_OPCODE_GAS`.
 
 ### Point evaluation precompile

From fe8f0223dbd730d6996bfe2a172de0ec775463b5 Mon Sep 17 00:00:00 2001
From: Leeren <leeren@leerenchang.com>
Date: Tue, 17 Jan 2023 14:11:34 -0800
Subject: [PATCH 178/274] Add EIP-5700: Bindable Token Standard (#5700)

* Add EIP-5700: Bindable Token Standard

* Finalizes EIP draft

* Adds implementation references

* Fixes improper file naming

* Fixes final lint issue

* Ensures all assets are CC0 licensed

* Removes watermarks

* Fixes misplaced tab characters

* Fixes last linting bugs

* small lint
---
 EIPS/eip-5700.md                              | 826 ++++++++++++++++++
 assets/eip-5700/erc1155/ERC1155.sol           | 192 ++++
 assets/eip-5700/erc1155/ERC1155Bindable.sol   | 239 +++++
 assets/eip-5700/erc1155/ERC1155Binder.sol     | 108 +++
 assets/eip-5700/erc721/ERC721.sol             | 232 +++++
 assets/eip-5700/erc721/ERC721Bindable.sol     | 210 +++++
 assets/eip-5700/erc721/ERC721Binder.sol       | 135 +++
 .../eip-5700/interfaces/IERC1155Bindable.sol  | 239 +++++
 .../interfaces/IERC1155BindableErrors.sol     |  13 +
 assets/eip-5700/interfaces/IERC1155Binder.sol | 130 +++
 .../interfaces/IERC1155BinderErrors.sol       |  13 +
 assets/eip-5700/interfaces/IERC1155Errors.sol |  28 +
 .../eip-5700/interfaces/IERC721Bindable.sol   | 112 +++
 .../interfaces/IERC721BindableErrors.sol      |  19 +
 assets/eip-5700/interfaces/IERC721Binder.sol  |  72 ++
 .../interfaces/IERC721BinderErrors.sol        |  25 +
 assets/eip-5700/interfaces/IERC721Errors.sol  |  29 +
 17 files changed, 2622 insertions(+)
 create mode 100644 EIPS/eip-5700.md
 create mode 100644 assets/eip-5700/erc1155/ERC1155.sol
 create mode 100644 assets/eip-5700/erc1155/ERC1155Bindable.sol
 create mode 100644 assets/eip-5700/erc1155/ERC1155Binder.sol
 create mode 100644 assets/eip-5700/erc721/ERC721.sol
 create mode 100644 assets/eip-5700/erc721/ERC721Bindable.sol
 create mode 100644 assets/eip-5700/erc721/ERC721Binder.sol
 create mode 100644 assets/eip-5700/interfaces/IERC1155Bindable.sol
 create mode 100644 assets/eip-5700/interfaces/IERC1155BindableErrors.sol
 create mode 100644 assets/eip-5700/interfaces/IERC1155Binder.sol
 create mode 100644 assets/eip-5700/interfaces/IERC1155BinderErrors.sol
 create mode 100644 assets/eip-5700/interfaces/IERC1155Errors.sol
 create mode 100644 assets/eip-5700/interfaces/IERC721Bindable.sol
 create mode 100644 assets/eip-5700/interfaces/IERC721BindableErrors.sol
 create mode 100644 assets/eip-5700/interfaces/IERC721Binder.sol
 create mode 100644 assets/eip-5700/interfaces/IERC721BinderErrors.sol
 create mode 100644 assets/eip-5700/interfaces/IERC721Errors.sol

diff --git a/EIPS/eip-5700.md b/EIPS/eip-5700.md
new file mode 100644
index 00000000000000..0de0f5c8ae402c
--- /dev/null
+++ b/EIPS/eip-5700.md
@@ -0,0 +1,826 @@
+---
+eip: 5700
+title: Bindable Token Interface
+description: Interface for binding fungible and non-fungible tokens to assets.
+author: Leeren (@leeren)
+discussions-to: https://ethereum-magicians.org/t/eip-5700-bindable-token-standard/11077
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-09-22
+requires: 165, 721, 1155
+---
+
+## Abstract
+
+The proposed standard defines an interface by which fungible and non-fungible tokens may be bound to arbitrary assets (typically represented as NFTs themselves), enabling token ownership and transfer attribution to be proxied through the assets they are bound to.
+
+A bindable token ("bindable") is an [EIP-721](./eip-721.md) or [EIP-1155](./eip-1155.md) token which, when bound to an asset, delegates ownership and tracking through its bound asset, remaining locked for direct transfers until it is unbound. When unbound, bindable tokens function normally according to their base token implementations.
+
+A bound asset ("binder") has few restrictions on how it is represented, except that it be unique and expose an interface for ownership queries. A binder would most commonly be represented as an [EIP-721](./eip-721.md) NFT. Binders and bindables form a one-to-many relationship.
+
+Below are example use-cases that benefit from such a standard:
+
+- NFT-bundled physical assets: microchipped streetwear bundles, digitized automobile collections, digitally-twinned real-estate property
+- NFT-bundled digital assets: accessorizable virtual wardrobes, composable music tracks, customizable metaverse land
+
+## Motivation
+
+A standard interface for token binding allows tokens to be bundled and transferred with other assets in a way that is easily integrable with wallets, marketplaces, and other NFT applications, and avoids the need for ad-hoc ownership attribution strategies that are neither flexible nor backwards-compatible.
+
+Unlike other standards tackling delegated ownership attribution, which look at composability on the account level, this standard addresses composability on the asset level, with the goal of creating a universal interface for token modularity that is compatible with existing [EIP-721](./eip-721.md) and [EIP-1155](./eip-1155.md) standards.
+
+## Specification
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
+
+### EIP-721 Bindable
+
+**Smart contracts implementing the EIP-721 bindable standard MUST implement the `IERC721Bindable` interface.**
+
+**Implementers of the `IER721Bindable` interface MUST return `true` if `0x82a34a7d` is passed as the identifier to the `supportsInterface` function.**
+
+```solidity
+/// @title ERC-721 Bindable Token Standard
+/// @dev See https://eips.ethereum.org/EIPS/eip-5700
+///  Note: the ERC-165 identifier for this interface is 0x82a34a7d.
+interface IERC721Bindable /* is IERC721 */ {
+
+    /// @notice The `Bind` event MUST emit when NFT ownership is delegated
+    ///  through an asset and when minting an NFT bound to an existing asset.
+    /// @dev When minting bound NFTs, `from` MUST be set to the zero address.
+    /// @param operator The address calling the bind.
+    /// @param from The unbound NFT owner address.
+    /// @param to The bound NFT owner delegate address.
+    /// @param tokenId The identifier of the NFT being bound.
+    /// @param bindId The identifier of the asset being bound to.
+    /// @param bindAddress The contract address handling asset ownership.
+    event Bind(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        address indexed bindAddress
+    );
+
+    /// @notice The `Unbind` event MUST emit when asset-bound NFT ownership is
+    ///  revoked, as well as when burning an NFT bound to an existing asset.
+    /// @dev When burning bound NFTs, `to` MUST be set to the zero address.
+    /// @param operator The address calling the unbind.
+    /// @param from The bound asset owner address.
+    /// @param to The unbound NFT owner address.
+    /// @param tokenId The identifier of the NFT being unbound.
+    /// @param bindId The identifier of the asset being unbound from.
+    /// @param bindAddress The contract address handling bound asset ownership.
+    event Unbind(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        address indexed bindAddress
+    );
+
+    /// @notice Binds NFT `tokenId` owned by `from` to asset `bindId` at address
+    ///  `bindAddress`, delegating NFT-bound ownership to `to`.
+    /// @dev The function MUST throw unless `msg.sender` is the current owner, 
+    ///  an authorized operator, or the approved address for the NFT. It also
+    ///  MUST throw if the NFT is already bound, if `from` is not the NFT owner, 
+    ///  or if `to` is not `bindAddress` or its asset owner. After binding, the
+    ///  function MUST check if `bindAddress` is a valid contract /  (code size 
+    ///  > 0), and if so, call `onERC721Bind` on it, throwing if the wrong 
+    ///  identifier is returned (see "Binding Rules") or if the contract is 
+    ///  invalid. On bind completion, the function MUST emit `Bind` & `Transfer`
+    ///  events to reflect delegated ownership change.
+    /// @param from The unbound NFT original owner address.
+    /// @param to The bound NFT delegate owner address (SHOULD be `bindAddress`).
+    /// @param tokenId The identifier of the NFT being bound.
+    /// @param bindId The identifier of the asset being bound to.
+    /// @param bindAddress The contract address handling asset ownership.
+    /// @param data Additional data sent with the `onERC721Bind` hook.
+    function bind(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) external;
+
+    /// @notice Unbinds NFT `tokenId` from asset `bindId` owned by `from` at 
+    ///  address `bindAddress`, assigning unbound NFT ownership to `to`.
+    /// @dev The function MUST throw unless `msg.sender` is the asset owner or
+    ///  an approved operator. It also MUST throw if NFT `tokenId` is not bound, 
+    ///  if `from` is not the asset owner, or if `to` is the zero address. After 
+    ///  unbinding, the function MUST check if `bindAddress` is a valid contract 
+    ///  (code size > 0), and if so, call `onERC721Unbind` on it, throwing if 
+    ///  the wrong identifier is returned (see "Binding Rules") or if the 
+    ///  contract is invalid. The function also MUST check if `to` is a valid 
+    ///  contract, and if so, call `onERC721Received`, throwing if the wrong 
+    ///  identifier is returned. On unbind completion, the function MUST emit 
+    ///  `Unbind` & `Transfer` events to reflect delegated ownership change.
+    /// @param from The bound asset owner address.
+    /// @param to The unbound NFT owner address.
+    /// @param tokenId The identifier of the NFT being unbound.
+    /// @param bindId The identifier of the asset being unbound from.
+    /// @param bindAddress The contract address handling bound asset ownership.
+    /// @param data Additional data sent with the `onERC721Unbind` hook.
+    function unbind(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) external;
+
+    /// @notice Gets the asset identifier and address which an NFT is bound to.
+    /// @param tokenId The identifier of the NFT being queried.
+    /// @return The bound asset identifier and contract address.
+    function binderOf(uint256 tokenId) external returns (uint256, address);
+
+    /// @notice Counts NFTs bound to asset `bindId` at address `bindAddress`.
+    /// @param bindAddress The contract address handling bound asset ownership.
+    /// @param bindId The identifier of the bound asset.
+    /// @return The total number of NFTs bound to the asset.
+    function boundBalanceOf(address bindAddress, uint256 bindId) external returns (uint256);
+
+```
+
+**Smart contracts managing assets MUST implement the `IERC721Binder` interface if they are to accept binds from EIP-721 bindables.**
+
+**Implementers of the `IERC721Binder` interface MUST return `true` if `0x2ac2d2bc` is passed as the identifier to the `supportsInterface` function.**
+
+```solidity
+/// @dev Note: the ERC-165 identifier for this interface is 0x2ac2d2bc.
+interface IERC721Binder /* is IERC165 */ {
+
+    /// @notice Handles the binding of an IERC721Bindable-compliant NFT.
+    /// @dev An IERC721Bindable-compliant smart contract MUST call this function
+    ///  at the end of a `bind` after ownership is delegated through an asset.
+    ///  The function MUST revert if `to` is not the asset owner or the binder
+    ///  address. The function MUST revert if it rejects the bind. If accepting 
+    ///  the bind, the function MUST return `bytes4(keccak256("onERC721Bind(address,address,address,uint256,uint256,bytes)"))`
+    ///  Caller MUST revert the transaction if the above value is not returned.
+    ///  Note: The contract address of the binding NFT is `msg.sender`.
+    /// @param operator The address initiating the bind.
+    /// @param from The unbound NFT owner address.
+    /// @param to The bound NFT owner delegate address.
+    /// @param tokenId The identifier of the NFT being bound.
+    /// @param bindId The identifier of the asset being bound to.
+    /// @param data Additional data sent along with no specified format.
+    /// @return `bytes4(keccak256("onERC721Bind(address,address,address,uint256,uint256,bytes)"))`
+    function onERC721Bind(
+        address operator,
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        bytes calldata data
+  ) external returns (bytes4);
+
+    /// @notice Handles the unbinding of an IERC721Bindable-compliant NFT.
+    /// @dev An IERC721Bindable-compliant smart contract MUST call this function
+    ///  at the end of an `unbind` after revoking asset-delegated ownership.
+    ///  The function MUST revert if `from` is not the asset owner of `bindId`.
+    ///  The function MUST revert if it rejects the unbind. If accepting the 
+    ///  unbind, the function MUST return `bytes4(keccak256("onERC721Unbind(address,address,address,uint256,uint256,bytes)"))`
+    ///  Caller MUST revert the transaction if the above value is not returned.
+    ///  Note: The contract address of the unbinding NFT is `msg.sender`.
+    /// @param from The bound asset owner address.
+    /// @param to The unbound NFT owner address.
+    /// @param tokenId The identifier of the NFT being unbound.
+    /// @param bindId The identifier of the asset being unbound from.
+    /// @param data Additional data with no specified format.
+    /// @return `bytes4(keccak256("onERC721Unbind(address,address,address,uint256,uint256,bytes)"))`
+    function onERC721Unbind(
+        address operator,
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        bytes calldata data
+    ) external returns (bytes4);
+
+    /// @notice Gets the owner address of the asset identified by `bindId`.
+    /// @dev This function MUST throw for assets assigned to the zero address.
+    /// @param bindId The identifier of the asset whose owner is being queried.
+    /// @return The address of the owner of the asset.
+    function ownerOf(uint256 bindId) external view returns (address);
+
+    /// @notice Checks if an operator can act on behalf of an asset owner.
+    /// @param owner The address that owns an asset.
+    /// @param operator The address that can act on behalf of the asset owner.
+    /// @return True if `operator` can act on behalf of `owner`, else False.
+    function isApprovedForAll(address owner, address operator) external view returns (bool);
+
+}
+```
+
+### EIP-1155 Bindable
+
+**Smart contracts implementing the EIP-1155 Bindable standard MUST implement the `IERC1155Bindable` interface.**
+
+**Implementers of the `IER1155Bindable` interface MUST return `true` if `0xd0d55c6` is passed as the identifier to the `supportsInterface` function.**
+
+```solidity
+/// @title ERC-1155 Bindable Token Standard
+/// @dev See https://eips.ethereum.org/EIPS/eip-5700
+///  Note: the ERC-165 identifier for this interface is 0xd0d555c6.
+interface IERC1155Bindable /* is IERC1155 */ {
+
+    /// @notice The `Bind` event MUST emit when token ownership is delegated
+    ///  through an asset and when minting tokens bound to an existing asset.
+    /// @dev When minting bound tokens, `from` MUST be set to the zero address.
+    /// @param operator The address calling the bind.
+    /// @param from The owner address of the unbound tokens.
+    /// @param to The delegate owner address of the bound tokens.
+    /// @param tokenId The identifier of the token type being bound.
+    /// @param amount The number of tokens of type `tokenId` being bound.
+    /// @param bindId The identifier of the asset being bound to.
+    /// @param bindAddress The contract address handling asset ownership.
+    event Bind(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        address indexed bindAddress
+    );
+
+    /// @notice The `BindBatch` event MUST emit when token ownership of 
+    ///  different token types are delegated through multiple assets and when
+    ///  minting different token types bound to multiple existing assets.
+    /// @dev When minting bound tokens, `from` MUST be set to the zero address.
+    /// @param operator The address calling the bind.
+    /// @param from The owner address of the unbound tokens.
+    /// @param to The delegate owner address of the bound tokens.
+    /// @param tokenIds The identifiers of the token types being bound.
+    /// @param amounts The number of tokens for each token type being bound.
+    /// @param bindIds The identifiers of the assets being bound to.
+    /// @param bindAddress The contract address handling asset ownership.
+    event BindBatch(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256[] tokenIds,
+        uint256[] amounts,
+        uint256[] bindIds,
+        address indexed bindAddress
+    );
+
+    /// @notice The `Unbind` event MUST emit when asset-delegated token 
+    ///  ownership is revoked and when burning tokens bound to existing assets.
+    /// @dev When burning bound tokens, `to` MUST be set to the zero address.
+    /// @param operator The address calling the unbind.
+    /// @param from The owner address of the bound asset.
+    /// @param to The owner address of the unbound tokens.
+    /// @param tokenId The identifier of the token type being unbound.
+    /// @param amount The number of tokens of type `tokenId` being unbound.
+    /// @param bindId The identifier of the asset being unbound from.
+    /// @param bindAddress The contract address handling bound asset ownership.
+    event Unbind(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        address indexed bindAddress
+    );
+
+    /// @notice The `UnbindBatch` event MUST emit when asset-delegated token 
+    ///  ownership is revoked for different token types and when burning 
+    ///  different token types bound to multiple existing assets.
+    /// @dev When burning bound tokens, `to` MUST be set to the zero address.
+    /// @param operator The address calling the unbind.
+    /// @param from The owner address of the bound asset.
+    /// @param to The owner address of the unbound tokens.
+    /// @param tokenIds The identifiers of the token types being unbound.
+    /// @param amounts The number of tokens for each token type being unbound.
+    /// @param bindIds The identifiers of the assets being unbound from.
+    /// @param bindAddress The contract address handling bound asset ownership.
+    event UnbindBatch(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256[] tokenIds,
+        uint256[] amounts,
+        uint256[] bindIds,
+        address indexed bindAddress
+    );
+
+    /// @notice Binds `amount` tokens of type `tokenId` owned by `from` to asset
+    ///  `bindId` at `bindAddress`, delegating token-bound ownership to `to`.
+    /// @dev The function MUST throw unless `msg.sender` is an approved operator
+    ///  for `from`. The function also MUST throw if `from` owns fewer than 
+    ///  `amount` tokens, or if `to` is not `bindAddress` or its asset owner. 
+    ///  After binding, the function MUST check if `bindAddress` is a valid 
+    ///  contract (code size > 0), and if so, call `onERC1155Bind` on it, 
+    ///  throwing if the wrong identifier is returned (see "Binding Rules") or
+    ///  if the contract is invalid. On bind completion, the function MUST emit
+    ///  `Bind` & `TransferSingle` events to reflect delegated ownership change.
+    /// @param from The owner address of the unbound tokens.
+    /// @param to The delegate owner address of the bound tokens (SHOULD be `bindAddress`).
+    /// @param tokenId The identifier of the token type being bound.
+    /// @param amount The number of tokens of type `tokenId` being bound.
+    /// @param bindId The identifier of the asset being bound to.
+    /// @param bindAddress The contract address handling asset ownership.
+    /// @param data Additional data sent with the `onERC1155Bind` hook.
+    function bind(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) external;
+
+    /// @notice Binds `amounts` tokens of types `tokenIds` owned by `from` to 
+    ///   assets `bindIds` at `bindAddress`, delegating bound ownership to `to`.
+    /// @dev The function MUST throw unless `msg.sender` is an approved operator
+    ///  for `from`. The function also MUST throw if length of `amounts` is not 
+    ///  the same as `tokenIds` or `bindIds`, if any balances of `tokenIds` for
+    ///  `from` is less than that of `amounts`, or if `to` is not `bindAddress`
+    ///  or the asset owner. After delegating ownership, the function MUST check 
+    ///  if `bindAddress` is a valid contract (code size > 0), and if so, call 
+    ///  `onERC1155BatchBind` on it, throwing if the wrong identifier is 
+    ///  returned (see "Binding Rules") or if the contract is invalid. On bind
+    ///  completion, the function MUST emit `BindBatch` & `TransferBatch` events
+    ///  to reflect delegated ownership changes.
+    /// @param from The owner address of the unbound tokens.
+    /// @param to The delegate owner address of the bound tokens (SHOULD be `bindAddress`).
+    /// @param tokenIds The identifiers of the token types being bound.
+    /// @param amounts The number of tokens for each token type being bound.
+    /// @param bindIds The identifiers of the assets being bound to.
+    /// @param bindAddress The contract address handling asset ownership.
+    /// @param data Additional data sent with the `onERC1155BatchBind` hook.
+    function batchBind(
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+        uint256[] calldata bindIds,
+        address bindAddress,
+        bytes calldata data
+    ) external;
+
+    /// @notice Revokes delegated ownership of `amount` tokens of type `tokenId`
+    ///  owned by `from` bound to `bindId`, switching ownership to `to`.
+    /// @dev The function MUST throw unless `msg.sender` is the asset owner or
+    ///  an approved operator. It also MUST throw if `from` is not the asset 
+    ///  owner, if fewer than `amount` tokens are bound to the asset, or if `to`
+    ///  is the zero address. Once delegated ownership is revoked, the function 
+    ///  MUST check if `bindAddress` is a valid contract (code size > 0), and if 
+    ///  so, call `onERC1155Unbind` on it, throwing if the wrong identifier is 
+    ///  returned (see "Binding Rules") or if the contract is invalid. The 
+    ///  function also MUST check if `to` is a contract, and if so, call on it 
+    ///  `onERC1155Received`, throwing if the wrong identifier is returned. On 
+    ///  unbind completion, the function MUST emit `Unbind` & `TransferSingle` 
+    ///  events to reflect delegated ownership change.
+    /// @param from The owner address of the bound asset.
+    /// @param to The owner address of the unbound tokens.
+    /// @param tokenId The identifier of the token type being unbound.
+    /// @param amount The number of tokens of type `tokenId` being unbound.
+    /// @param bindId The identifier of the asset being unbound from.
+    /// @param bindAddress The contract address handling bound asset ownership.
+    /// @param data Additional data sent with the `onERC1155Unbind` hook.
+    function unbind(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) external;
+
+    /// @notice Revokes delegated ownership of `amounts` tokens of `tokenIds`
+    ///  owned by `from` bound to assets `bindIds`, switching ownership to `to`.
+    /// @dev The function MUST throw unless `msg.sender` is the assets' owner or
+    ///  approved operator. It also MUST throw if the length of `amounts` is not
+    ///  the same as `tokenIds` or `bindIds`, if `from` is not the owner of all
+    ///  assets, if any count in `amounts` is fewer than the number of tokens
+    ///  bound for the corresponding token-asset pair given by `tokenIds` and
+    ///  `bindIds`, or if `to` is the zero address. Once delegated ownership is 
+    ///  revoked for all tokens, the function MUST check if `bindAddress` is a 
+    ///  valid contract (code size >  0), and if so, call `onERC1155BatchUnbind` 
+    ///  on it, throwing if a wrong identifier is returned (see "Binding Rules") 
+    ///  or if the contract is invalid. The function also MUST check if `to` is 
+    ///  valid contract, and if so, call `onERC1155BatchReceived` on it, 
+    ///  throwing if the wrong identifier is returned. On unbind completion, the 
+    ///  function MUST emit `BatchUnbind` and `TransferBatch` events to reflect 
+    ///  delegated ownership change.
+    /// @param from The owner address of the bound asset.
+    /// @param to The owner address of the unbound tokens.
+    /// @param tokenIds The identifiers of the token types being unbound.
+    /// @param amounts The number of tokens for each token type being unbound.
+    /// @param bindIds The identifier of the assets being unbound from.
+    /// @param bindAddress The contract address handling bound asset ownership.
+    /// @param data Additional data sent with the `onERC1155BatchUnbind` hook.
+    function batchUnbind(
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+        uint256[] calldata bindIds,
+        address bindAddress,
+        bytes calldata data
+    ) external;
+
+    /// @notice Gets the balance of bound tokens of type `tokenId` bound to the
+    ///  asset `bindId` at address `bindAddress`.
+    /// @param bindAddress The contract address handling bound asset ownership.
+    /// @param bindId The identifier of the bound asset.
+    /// @param tokenId The identifier of the counted bound token type.
+    /// @return The total number of tokens of type `tokenId` bound to the asset.
+    function boundBalanceOf(
+        address bindAddress,
+        uint256 bindId,
+        uint256 tokenId
+    ) external returns (uint256);
+
+    /// @notice Gets the balance of bound tokens for multiple token types given
+    ///  by `tokenIds` bound to assets `bindIds` at address `bindAddress`.
+    /// @param bindAddress The contract address handling bound asset ownership.
+    /// @param bindIds List of bound asset identifiers.
+    /// @param tokenIds The identifiers of the counted bound token types.
+    /// @return balances The bound balances for each asset / token type pair.
+    function boundBalanceOfBatch(
+        address bindAddress,
+        uint256[] calldata bindIds,
+        uint256[] calldata tokenIds
+    ) external returns (uint256[] memory balances);
+
+}
+```
+
+**Smart contracts managing assets MUST implement the `IERC1155Binder` interface if they are to accept binds from EIP-1155 bindables.**
+
+**Implementers of the `IERC1155Binder` interface MUST return `true` if `0x6fc97e78` is passed as the identifier to the `supportsInterface` function.**
+
+```solidity
+pragma solidity ^0.8.16;
+
+/// @dev Note: the ERC-165 identifier for this interface is 0x6fc97e78.
+interface IERC1155Binder /* is IERC165 */ {
+
+    /// @notice Handles binding of an IERC1155Bindable-compliant token type.
+    /// @dev An IERC1155Bindable-compliant smart contract MUST call this 
+    ///  function at the end of a `bind` after ownership is delegated through an
+    ///  asset. The function MUST revert if `to` is not the asset owner or 
+    ///  binder address. The function MUST revert if it rejects the bind. If 
+    ///  accepting the bind, the function MUST return `bytes4(keccak256("onERC1155Bind(address,address,address,uint256,uint256,uint256,bytes)"))`
+    ///  Caller MUST revert the transaction if the above value is not returned.
+    ///  Note: The contract address of the binding token is `msg.sender`.
+    /// @param operator The address responsible for binding.
+    /// @param from The owner address of the unbound tokens.
+    /// @param to The delegate owner address of the bound tokens.
+    /// @param tokenId The identifier of the token type being bound.
+    /// @param bindId The identifier of the asset being bound to.
+    /// @param data Additional data sent along with no specified format.
+    /// @return `bytes4(keccak256("onERC1155Bind(address,address,address,uint256,uint256,uint256,bytes)"))`
+    function onERC1155Bind(
+        address operator,
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        bytes calldata data
+    ) external returns (bytes4);
+
+    /// @notice Handles binding of multiple IERC1155Bindable-compliant tokens 
+    ///  `tokenIds` to multiple assets `bindIds`.
+    /// @dev An IERC1155Bindable-compliant smart contract MUST call this 
+    ///  function at the end of a `batchBind` after delegating ownership of 
+    ///  multiple token types to the asset owner. The function MUST revert if 
+    ///  `to` is not the asset owner or binder address. The function MUST revert
+    ///  if it rejects the bind. If accepting the bind, the function MUST return 
+    ///  `bytes4(keccak256("onERC1155BatchBind(address,address,address,uint256[],uint256[],uint256[],bytes)"))`
+    ///  Caller MUST revert the transaction if the above value is not returned.
+    ///  Note: The contract address of the binding token is `msg.sender`.
+    /// @param operator The address responsible for performing the binds.
+    /// @param from The unbound tokens' original owner address.
+    /// @param to The bound tokens' delegate owner address (SHOULD be `bindAddress`).
+    /// @param tokenIds The list of token types being bound.
+    /// @param amounts The number of tokens for each token type being bound.
+    /// @param bindIds The identifiers of the assets being bound to.
+    /// @param data Additional data sent along with no specified format.
+    /// @return `bytes4(keccak256("onERC1155Bind(address,address,address,uint256[],uint256[],uint256[],bytes)"))`
+    function onERC1155BatchBind(
+        address operator,
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+        uint256[] calldata bindIds,
+        bytes calldata data
+    ) external returns (bytes4);
+
+    /// @notice Handles unbinding of an IERC1155Bindable-compliant token type.
+    /// @dev An IERC1155Bindable-compliant contract MUST call this function at
+    ///  the end of an `unbind` after revoking delegated asset ownership. The 
+    ///  function MUST revert if `from` is not the asset owner. The function 
+    ///  MUST revert if it rejects the unbind. If accepting the unbind, the 
+    ///  function MUST return `bytes4(keccak256("onERC1155Unbind(address,address,address,uint256,uint256,uint256,bytes)"))`
+    ///  Caller MUST revert the transaction if the above value is not returned.
+    ///  Note: The contract address of the unbinding token is `msg.sender`.
+    /// @param operator The address responsible for performing the unbind.
+    /// @param from The owner address of the bound asset.
+    /// @param to The owner address of the unbound tokens.
+    /// @param tokenId The token type being unbound.
+    /// @param amount The number of tokens of type `tokenId` being unbound.
+    /// @param bindId The identifier of the asset being unbound from.
+    /// @param data Additional data sent along with no specified format.
+    /// @return `bytes4(keccak256("onERC1155Unbind(address,address,address,uint256,uint256,uint256,bytes)"))`
+    function onERC1155Unbind(
+        address operator,
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        bytes calldata data
+    ) external returns (bytes4);
+
+    /// @notice Handles unbinding of multiple IERC1155Bindable-compliant token types.
+    /// @dev An IERC1155Bindable-compliant contract MUST call this function at
+    ///  the end of a `batchUnbind` after revoking asset-delegated ownership.
+    ///  The function MUST revert if `from` is not the asset owner. The function 
+    ///  MUST revert if it rejects the unbinds. If accepting the unbinds, the 
+    ///  function MUST return `bytes4(keccak256("onERC1155Unbind(address,address,address,uint256[],uint256[],uint256[],bytes)"))`
+    ///  Caller MUST revert the transaction if the above value is not returned.
+    ///  Note: The contract address of the unbinding token is `msg.sender`.
+    /// @param operator The address responsible for performing the unbinds.
+    /// @param from The owner address of the bound asset.
+    /// @param to The owner address of the unbound tokens.
+    /// @param tokenIds The list of token types being unbound.
+    /// @param amounts The number of tokens for each token type being unbound.
+    /// @param bindIds The identifiers of the assets being unbound from.
+    /// @param data Additional data sent along with no specified format.
+    /// @return `bytes4(keccak256("onERC1155Unbind(address,address,address,uint256[],uint256[],uint256[],bytes)"))`
+    function onERC1155BatchUnbind(
+        address operator,
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+        uint256[] calldata bindIds,
+        bytes calldata data
+    ) external returns (bytes4);
+
+    /// @notice Gets the owner address of the asset represented by id `bindId`.
+    /// @param bindId The identifier of the asset whose owner is being queried.
+    /// @return The address of the owner of the asset.
+    function ownerOf(uint256 bindId) external view returns (address);
+
+    /// @notice Checks if an operator can act on behalf of an asset owner.
+    /// @param owner The owner address of an asset.
+    /// @param operator The address operating on behalf of the asset owner.
+    /// @return True if `operator` can act on behalf of `owner`, else False.
+    function isApprovedForAll(address owner, address operator) external view returns (bool);
+
+}
+```
+
+### Rules
+
+This standard supports two modes of binding, depending on whether ownership is delegated to the asset owner or binder address.
+
+- _Delegated (RECOMMENDED):_
+    - Bindable ownership is delegated to the binder address (`to` is `bindAddress` in a bind).
+    - Bindable ownership queries return the binder address.
+    - Bindable transfers MUST always throw.
+- _Legacy (NOT RECOMMENDED):_
+    - Bindable ownership is delegated to the asset owner address (`to` is the asset owner address in a bind).
+    - Bindable ownership queries return the asset owner address.
+    - Bindable transfers MUST always throw, except when invoked as a result of bound assets being transferred.
+    - Transferrable bound assets MUST keep track of bound tokens following this binding mode.
+    - On transfer, bound assets MUST invoke ownership transfers for bound tokens following this binding mode.
+
+_Binders SHOULD choose to only support the "delegated" binding mode by throwing if `to` is not `bindAddress`, otherwise both modes MAY be supported._
+
+**_`bind` rules:_**
+
+- When binding an EIP-721 bindable to an asset:
+    - MUST throw if caller is not the current NFT owner, the approved address for the NFT, or an approved operator for `from`.
+    - MUST throw if NFT `tokenId` is already bound.
+    - MUST throw if `from` is not the NFT owner.
+    - MUST throw if `to` is not `bindAddress` or the asset owner.
+    - After above conditions are met, MUST check if `bindAddress` is a smart contract (code size > 0). If so, it MUST call `onERC721Bind` on `bindAddress` with `data` passed unaltered and act appropriately (see "Hook Rules").
+    - MUST emit the `Bind` event to reflect asset-bound ownership delegation.
+    - MUST emit the `Transfer` event if `from` is different than `to` to reflect delegated ownership change.
+- When binding an EIP-1155 bindable to an asset:
+    - MUST throw if caller is not an approved operator for `from`.
+    - MUST throw if `from` owns fewer than `amount` unbound tokens of type `tokenId`.
+    - MUST throw if `to` is not `bindAddress` or the asset owner.
+    - After above conditions are met, MUST check if `bindAddress` is a smart contract (code size > 0). If so, it MUST call `onERC1155Bind` on `bindAddress` with `data` passed unaltered and act appropriately (see "Hook Rules").
+    - MUST emit the `Bind` event to reflect asset-bound ownership delegation.
+    - MUST emit the `TransferSingle` event if `from` is different than `to` to reflect delegated ownership change.
+
+**_`unbind` rules:_**
+
+- When unbinding an EIP-721 bindable from an asset:
+    - MUST throw if caller is not the owner of the asset or an approved asset operator for `from`.
+    - MUST throw if NFT `tokenId` is not bound.
+    - MUST throw if `from` is not the asset owner.
+    - MUST throw if `to` is the zero address.
+    - After above conditions are met, MUST check if `bindAddress` is a smart contract (code size > 0). If so, it MUST call `onERC721Unbind` on `bindAddress` with `data` passed unaltered and act appropriately (see "Hook Rules").
+    - In addition, it MUST check if `to` is a smart contract (code size > 0), and call `onERC721Received` on `to` with `data` passed unaltered and act appropriately (see "Hook Rules").
+    - MUST emit the `Unbind` event to reflect asset-bound ownership revocation.
+    - MUST emit the `Transfer` event if `from` is different than `to` to reflect delegated ownership change.
+- When unbinding a an EIP-1155 bindable from an asset:
+    - MUST throw if caller is not the owner of the asset or an approved asset operator for `from`.
+    - MUST throw if `from` is not the asset owner.
+    - MUST throw if fewer than `amount` tokens of type `tokenId` are bound to `bindId`.
+    - MUST throw if `to` is the zero address.
+    - After above conditions are met, MUST check if `bindAddress` is a smart contract (code size > 0). If so, it MUST call `onERC1155Unbind` on `bindAddress` with `data` passed unaltered and act appropriately (see "Hook Rules").
+    - In addition, it MUST check if `to` is a smart contract (code size > 0), and call `onERC1155Received` on `to` with `data` passed unaltered and act appropriately (see "Hook Rules").
+    - MUST emit the `Unbind` event to reflect asset-bound ownership revocation.
+    - MUST emit the `TransferSingle` event if `from` is different than `to` to reflect delegated ownership change.
+
+**_`batchBind` & `batchUnbind` rules:_**
+
+- When performing a `batchBind` on EIP-1155 bindables:
+    - MUST throw if caller is not an approved operator for `from`.
+    - MUST throw if length of `tokenIds` is not the same as that of `amounts` or `bindIds`.
+    - MUST throw if any unbound token balances of `tokenIds` for `from` are less than that of `amounts`.
+    - MUST throw if `to` is not `bindAddress` or the asset owner.
+    - After above conditions are met, MUST check if `bindAddress` is a smart contract (code size > 0). If so, it MUST call `onERC1155BatchBind` on `bindAddress` with `data` passed unaltered and act appropriately (see "Hook Rules").
+    - MUST emit either `Bind` or `BindBatch` events to properly reflect asset-delegated ownership attribution for all bound tokens.
+    - MUST emit either `TransferSingle` or `TransferBatch` events if `from` is different than `to` to reflect delegated ownership changes for all tokens.
+- When performing a `batchUnbind` on EIP-1155 bindables:
+    - MUST throw if caller is not the owner of all assets or an approved asset operator for `from`.
+    - MUST throw if length of `tokenIds` is not the same as that of `amounts` or `bindIds`.
+    - MUST throw if `from` is not the owner of all assets.
+- MUST throw if any count in `amounts` is fewer than the number of tokens bound for the corresponding token-asset pair given by `tokenIds` and `bindIds`.
+    - MUST throw if `to` is the zero address.
+    - After above conditions are met, MUST check if `bindAddress` is a smart contract (code size > 0). If so, it MUST call `onERC1155Unbind` on `bindAddress` with `data` passed unaltered and act appropriately (see "Hook Rules").
+    - In addition, it MUST check if `to` is a smart contract (code size > 0), and call `onERC1155Received` on `to` with `data` passed unaltered and act appropriately (see "Hook Rules").
+    - MUST emit `Bind` event to reflect asset-bound ownership revocation.
+    - MUST emit the `TransferSingle` event if `from` is different than `to` to reflect delegated ownership change.
+
+**_`Bind` event rules:_**
+
+- When emitting an EIP-721 bindable `Bind` event:
+  - SHOULD be emitted to indicate a single bind has occurred between a `tokenId` and `bindId` pair.
+  - MAY be emitted multiple times to indicate multiple binds have occurred in a single transaction.
+  - The `operator` argument MUST be the owner of the NFT `tokenId`, the approved address for the NFT, or the authorized operator of `from`.
+  - The `from` argument MUST be the owner of the NFT `tokenId`.
+  - The `to` argument MUST be `binderAddress` (indicates "delegated" bind) or the owner of the bound asset (indicates "legacy" bind).
+  - The `tokenId` argument MUST be the NFT being bound.
+  - The `bindId` argument MUST be the identifier of the asset being bound to.
+  - The `bindAddress` argument MUST be the contract address of the asset being bound to.
+  - When minting NFTs bound to an asset, the `Bind` event must be emitted with the `from` argument set to `0x0`.
+  - `Bind` events MUST be emitted to reflect asset-bound ownership delegation before calls to `onERC721Bind`.
+- When emitting an EIP-1155 bindable `Bind` event:
+  - SHOULD be emitted to indicate a bind has occurred between a single `tokenId` type and `binderId` pair.
+  - MAY be emitted multiple times to indicate multiple binds have occurred in a single transaction, but `BindBatch` should be preferred in this case to reduce gas consumption.
+  - The `operator` argument MUST be an authorized operator for `from`.
+  - The `from` argument MUST be the owner of the unbound tokens.
+  - The `to` argument MUST be `binderAddress` (indicates "delegated" bind) or the owner of the bound asset `bindId` (indicates "legacy" bind).
+  - The `tokenId` argument MUST be the token type being bound.
+  - The `amount` argument MUST be the number of tokens of type `tokenId` being bound.
+  - The `bindId` argument MUST be the identifier of the asset being bound to.
+  - The `bindAddress` argument MUST be the contract address of the asset being bound to.
+  - When minting NFTs bound to an asset, the `Bind` event must be emitted with the `from` argument set to `0x0`.
+  - `Bind` events MUST be emitted to reflect asset-bound ownership delegation before calls to `onERC1155Bind` or `onERC1155BindBatch`.
+
+**_`Unbind` event rules:_**
+
+- When emitting an EIP-721 bindable `Unbind` event:
+  - SHOULD be emitted to indicate a single unbind has occurred between a `tokenId` and `bindId` pair.
+  - MAY be emitted multiple times to indicate multiple unbinds have occurred in a single transaction.
+  - The `operator` argument MUST be the owner of the asset or an approved asset operator for `from`.
+  - The `from` argument MUST be the owner of the asset.
+  - The `to` argument MUST be the recipient address of the unbound NFT.
+  - The `tokenId` argument MUST be the NFT being unbound.
+  - The `bindId` argument MUST be the identifier of the asset being unbound from.
+  - The `bindAddress` argument MUST be the contract address of the asset being unbound from.
+  - When burning NFTs bound to an asset, the `Bind` event must be emitted with the `to` argument set to `0x0`.
+  - `Bind` events MUST be emitted to reflect delegated ownership revocation changes before calls to `onERC721Unbind`.
+- When emitting an EIP-1155 bindable `Unbind` event:
+  - SHOULD be emitted to indicate an unbind has occurred between a single `tokenId` type and `binderId` pair.
+  - MAY be emitted multiple times to indicate multiple unbinds have occurred in a single transaction, but `UnbindBatch` should be preferred in this case to reduce gas consumption.
+  - The `operator` argument MUST be the owner of the asset or an approved asset operator for `from`.
+  - The `from` argument MUST be the asset owner.
+  - The `to` argument MUST be the recipient address of the unbound tokens.
+  - The `tokenId` argument MUST be the token type being unbound.
+  - The `amount` argument MUST be the number of tokens of type `tokenId` being unbound.
+  - The `bindId` argument MUST be the identifier of the asset being unbound from.
+  - The `bindAddress` argument MUST be the contract address of the asset being unbound from.
+  - When burning NFTs bound to an asset, the `Bind` event must be emitted with the `to` argument set to `0x0`.
+  - `Bind` events MUST be emitted to reflect delegated ownership revocation changes before calls to `onERC1155Unbind` or `onERC1155UnbindBatch`
+
+**_`BindBatch` & `UnbindBatch` event rules:_**
+
+- When emitting a `BindBatch` event:
+  - SHOULD be emitted to indicate a bind has occurred between multiple `tokenId` and `binderId` pairs.
+  - The `operator` argument MUST be an authorized operator for `from`.
+  - The `from` argument MUST be the owner of the unbound tokens.
+  - The `to` argument MUST be `binderAddress` (indicates "delegated" bind) or the owner of the bound asset (indicates "legacy" bind).
+  - The `tokenIds` argument MUST be the identifiers of the token types being bound.
+  - The `amounts` argument MUST be the number of tokens for each type in `tokenIds` being bound.
+  - The `bindIds` argument MUST be the identifiers for all assets being bound to.
+  - The `bindAddress` argument MUST be the contract address of the assets being bound to.
+  - When batch minting NFTs bound to an asset, the `BindBatch` event must be emitted with the `from` argument set to `0x0`.
+  - `BindBatch` events MUST be emitted to reflect asset-bound ownership delegation before calls to `onERC1155BindBatch`
+- When emitting a `batchUnbind` event:
+  - SHOULD be emitted to indicate an unbind has occurred between multiple `tokenId` and `binderId` pairs.
+  - The `operator` argument MUST be an authorized operator or owner of the asset.
+  - The `from` argument MUST be the owner of all assets.
+  - The `to` argument MUST be the recipient address of the unbound tokens.
+  - The `tokenIds` argument MUST be the identifiers of the token types being unbound.
+  - The `amounts` argument MUST be the number of tokens for each type `tokenId` being unbound.
+  - The `bindIds` argument MUST be the identifiers for the assets being unbound from.
+  - The `bindAddress` argument MUST be the contract address of the assets being unbound from.
+  - When burning tokens bound to an asset, the `UnbindBatch` event must be emitted with the `to` argument set to `0x0`.
+  - `UnbindBatch` events MUST be emitted to reflect asset-delegated ownership changes before calls to `onERC1155UnbindBatch`
+
+**_`bind` hook rules:_**
+
+- The `operator` argument MUST be the address calling the bind hook.
+- The `from` argument MUST be the owner of the NFT or token type being bound.
+    - FROM must be `0x0` for a mint.
+- The `to` argument MUST be `binderAddress` (indicates "delegated" bind) or the owner of the bound asset (indicates "legacy" bind).
+    - The binder contract MAY choose to reject legacy binds.
+- For `onERC721Bind` / `onERC1155Bind`, the `tokenId` argument MUST be the NFT / token type being bound.
+- For `onERC1155BatchBind`, `tokenIds` MUST be the list of token types being bound.
+- For `onERC1155Bind`, the `amount` argument MUST be the number of tokens of type `tokenId` being bound.
+- For `onERC1155BatchBind`, the `amounts` argument MUST be a list of the number of tokens of each token type being bound.
+- For `onERC721Bind` / `onERC1155Bind`, the `bindId` argument MUST be the identifier for the asset being bound to.
+- For `onERC1155BatchBind`, `bindIds` MUST be the list of assets being bound to.
+- The `data` argument MUST contain data provided by the caller for the bind with contents unaltered.
+- The binder contract MAY accept the bind by returning the binder call's designated magic value, in which case the bind MUST complete or revert if any other conditions for success are not met:
+    - `onERC721Bind`: `bytes4(keccak256("onERC721Bind(address,address,address,uint256,uint256,bytes)"))`
+    - `onERC1155Bind`: `bytes4(keccak256("onERC1155Bind(address,address,address,uint256,uint256,uint256,bytes)"))`
+    - `onERC1155BindBatch`: `bytes4(keccak256("onERC1155BindBatch(address,address,address,uint256[],uint256[],uint256[],bytes)"))`
+- The binder contract MAY reject the bind by calling revert.
+- A return of any other value than the designated magic value MUST result in the transaction being reverted by the caller.
+
+**_`unbind` hook rules:_**
+
+- The `operator` argument MUST be the address calling the unbind hook.
+- The `from` argument MUST be the asset owner.
+- The `to` argument MUST the the recipient address of the unbound NFT or token type.
+    - TO must be `0x0` for a burn.
+- For `onERC721Unbind` / `onERC1155Unbind`, the `tokenId` argument MUST be the NFT / token type being unbound.
+- For `onERC1155BatchUnbind`, `tokenIds` MUST be the list of token types being unbound.
+- For `onERC1155Unbind`, the `amount` argument MUST be the number of tokens of type `tokenId` being unbound.
+- For `onERC1155BatchUnbind`, the `amounts` argument MUST be a list of the number of tokens of each token type being unbound.
+- For `onERC721Bind` / `onERC1155Bind`, the `bindId` argument MUST be the identifier for the asset being unbound from.
+- For `onERC1155BatchBind`, `bindIds` MUST be the list of assets being unbound from.
+- The `data` argument MUST contain data provided by the caller for the bind with contents unaltered.
+- The binder contract MAY accept the unbind by returning the binder call's designated magic value, in which case the unbind MUST complete or MUST revert if any other conditions for success are not met:
+    - `onERC721Unbind`: `bytes4(keccak256("onERC721Unbind(address,address,address,uint256,uint256,bytes)"))`
+    - `onERC1155Unbind`: `bytes4(keccak256("onERC1155Unbind(address,address,address,uint256,uint256,uint256,bytes)"))`
+    - `onERC1155UnbindBatch`: `bytes4(keccak256("onERC1155UnbindBatch(address,address,address,uint256[],uint256[],uint256[],bytes)"))`
+- The binder contract MAY reject the bind by calling revert.
+- A return of any other value than the designated magic value MUST result in the transaction being reverted by the caller.
+
+## Rationale
+
+A backwards-compatible standard for token binding unlocks a new layer of composability for allowing wallets, applications, and protocols to interact with, trade and display bundled assets. One example use-case of this is at Dopamine, where microchipped streetwear garments may be bundled with NFTs such as music, avatars, or digital-twins of the garments themselves, by linking chips to binder smart contracts capable of accepting token binds.
+
+### Binding Mechanism
+
+In the “delegated” mode, because token ownership is attributed to the contract address of the asset it is bound to, asset ownership modifications are completely decoupled from bound tokens, making bundled transfers efficient as no state management overhead is imposed. This is the recommended binding mode.
+
+The “legacy” binding mode was included purely for backwards-compatibility purposes, so that existing applications that have yet to integrate the standard can still display bundled tokens out-of-the-box. Here, since token ownership is attributed to the owner of the bound asset, asset ownership modifications are coupled to that of its bound tokens, making bundled transfers inefficient as binder contracts are required to track all bound tokens.
+
+Binder and bindable implementations MAY choose to support both modes of binding.
+
+### Transfer Mechanism
+
+One important consideration was whether binds should support transfers or not. Indeed, it would be much simpler for binds and unbinds to be processed only by addresses who owns both the bindable tokens and assets being bound to. Going this route, binds would not require any dependence on transfers, as asset-delegated ownership would not change, and applications could simply transfer the assets themselves following prescribed asset transfer rules. However, this was ruled out due to the lack of flexibility offered, especially around friction added for consumers wishing to bind their tokens to unowned assets.
+
+## Backwards Compatibility
+
+The bindable interface is designed to be compatible with existing EIP-721 and EIP-1155 standards.
+
+## Reference Implementation
+
+For reference EIP-721 implementations supporting "delegated" and "legacy" binding modes:
+
+- [EIP-721 Bindable](../assets/eip-5700/erc721/ERC721Bindable.sol).
+- [EIP-721 Binder](../assets/eip-5700/erc721/ERC721Binder.sol).
+
+For reference EIP-1155 implementations supporting only the "delegated" binding mode:
+
+- [EIP-1155 Bindable](../assets/eip-5700/erc1155/ERC1155Bindable.sol).
+- [EIP-1155 Binder](../assets/eip-5700/erc1155/ERC1155Binder.sol).
+
+## Security Considerations
+
+Bindable contracts supporting the "legacy" binding mode should be cautious with authorizing transfers once their tokens are bound. These should only be authorized as a result of their bound assets being transferred, and careful consideration must be taken when ensuring account balances are properly processed.
+
+Binder contracts supporting the "legacy" binding mode must ensure that any accepted binds are tracked, and that asset transfers result in proper changing of bound token ownership.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-5700/erc1155/ERC1155.sol b/assets/eip-5700/erc1155/ERC1155.sol
new file mode 100644
index 00000000000000..652ebb7e7f6729
--- /dev/null
+++ b/assets/eip-5700/erc1155/ERC1155.sol
@@ -0,0 +1,192 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+import {IERC1155} from "@openzeppelin/contracts/token/ERC1155/IERC1155.sol";
+import {IERC1155Receiver} from "@openzeppelin/contracts/token/ERC1155/IERC1155Receiver.sol";
+
+import {IERC1155Errors} from "../interfaces/IERC1155Errors.sol";
+
+/// @title Dopamine Minimal ERC-1155 Contract
+/// @notice This is a minimal ERC-1155 implementation that 
+contract ERC1155 is IERC1155, IERC1155Errors {
+
+    /// @notice Checks for an owner if an address is an authorized operator.
+    mapping(address => mapping(address => bool)) public isApprovedForAll;
+
+    /// @dev  EIP-165 identifiers for all supported interfaces.
+    bytes4 private constant _ERC165_INTERFACE_ID = 0x01ffc9a7;
+    bytes4 private constant _ERC1155_INTERFACE_ID = 0xd9b67a26;
+
+    /// @notice Gets an address' number of tokens owned of a specific type.
+    mapping(address => mapping(uint256 => uint256)) public _balanceOf;
+
+    /// @notice Transfers `amount` tokens of id `id` from address `from` to 
+    ///  address `to`, while ensuring `to` is capable of receiving the token.
+    /// @dev Safety checks are only performed if `to` is a smart contract.
+    /// @param from The existing owner address of the token to be transferred.
+    /// @param to The new owner address of the token being transferred.
+    /// @param id The id of the token being transferred.
+    /// @param amount The number of tokens being transferred.
+    /// @param data Additional transfer data to pass to the receiving contract.
+    function safeTransferFrom(
+        address from,
+        address to,
+        uint256 id,
+        uint256 amount,
+        bytes memory data
+    ) public virtual {
+        if (msg.sender != from && !isApprovedForAll[from][msg.sender]) {
+            revert SenderUnauthorized();
+        }
+
+        _balanceOf[from][id] -= amount;
+        _balanceOf[to][id] += amount;
+
+        emit TransferSingle(msg.sender, from, to, id, amount);
+
+        if (
+            to.code.length != 0 &&
+            IERC1155Receiver(to).onERC1155Received(
+                msg.sender,
+                address(0),
+                id,
+                amount,
+                data
+            ) !=
+            IERC1155Receiver.onERC1155Received.selector
+        ) {
+            revert SafeTransferUnsupported();
+        } else if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+    }
+
+    /// @notice Transfers tokens `ids` in corresponding batches `amounts` from 
+    ///  address `from` to address `to`, while ensuring `to` can receive tokens.
+    /// @dev Safety checks are only performed if `to` is a smart contract.
+    /// @param from The existing owner address of the token to be transferred.
+    /// @param to The new owner address of the token being transferred.
+    /// @param ids A list of the token ids being transferred.
+    /// @param amounts A list of the amounts of each token id being transferred.
+    /// @param data Additional transfer data to pass to the receiving contract.
+    function safeBatchTransferFrom(
+        address from,
+        address to,
+        uint256[] memory ids,
+        uint256[] memory amounts,
+        bytes memory data
+    ) public virtual {
+        if (ids.length != amounts.length) {
+            revert ArityMismatch();
+        }
+
+        if (msg.sender != from && !isApprovedForAll[from][msg.sender]) {
+            revert SenderUnauthorized();
+        }
+
+        uint256 id;
+        uint256 amount;
+
+        for (uint256 i = 0; i < ids.length; ) {
+            id = ids[i];
+            amount = amounts[i];
+            _balanceOf[from][id] -= amount;
+            _balanceOf[to][id] += amount;
+            unchecked { 
+                ++i;
+            }
+        }
+
+        emit TransferBatch(msg.sender, from, to, ids, amounts);
+
+        if (
+            to.code.length != 0 &&
+            IERC1155Receiver(to).onERC1155BatchReceived(
+                msg.sender,
+                from,
+                ids,
+                amounts,
+                data
+            ) !=
+            IERC1155Receiver.onERC1155BatchReceived.selector
+        ) {
+            revert SafeTransferUnsupported();
+        } else if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+    }
+
+    /// @notice Retrieves balance of address `owner` for token of id `id`.
+    /// @param owner The token owner's address.
+    /// @param id The id of the token being queried.
+    /// @return The number of tokens address `owner` owns of type `id`.
+    function balanceOf(address owner, uint256 id) public view virtual returns (uint256) {
+        return _balanceOf[owner][id];
+    }
+
+    /// @notice Retrieves balances of multiple owner / token type pairs.
+    /// @param owners List of token owner addresses.
+    /// @param ids List of token type identifiers.
+    /// @return balances List of balances corresponding to the owner / id pairs.
+    function balanceOfBatch(address[] memory owners, uint256[] memory ids)
+        public
+        view
+        virtual
+        returns (uint256[] memory balances)
+    {
+        if (owners.length != ids.length) {
+            revert ArityMismatch();
+        }
+
+        balances = new uint256[](owners.length);
+
+        unchecked {
+            for (uint256 i = 0; i < owners.length; ++i) {
+                balances[i] = _balanceOf[owners[i]][ids[i]];
+            }
+        }
+    }
+
+    /// @notice Sets the operator for the sender address.
+    function setApprovalForAll(address operator, bool approved) public virtual {
+        isApprovedForAll[msg.sender][operator] = approved;
+    }
+
+    /// @notice Checks if interface of identifier `id` is supported.
+    /// @param id The ERC-165 interface identifier.
+    /// @return True if interface id `id` is supported, False otherwise.
+    function supportsInterface(bytes4 id) public pure virtual returns (bool) {
+        return
+            id == _ERC165_INTERFACE_ID ||
+            id == _ERC1155_INTERFACE_ID;
+    }
+
+    /// @notice Mints token of id `id` to address `to`.
+    /// @param to Address receiving the minted NFT.
+    /// @param id The id of the token type being minted.
+    function _mint(address to, uint256 id) internal virtual {
+        unchecked {
+            ++_balanceOf[to][id];
+        }
+
+        emit TransferSingle(msg.sender, address(0), to, id, 1);
+
+        if (
+            to.code.length != 0 &&
+            IERC1155Receiver(to).onERC1155Received(
+                msg.sender,
+                address(0),
+                id,
+                1,
+                ""
+            ) !=
+            IERC1155Receiver.onERC1155Received.selector
+        ) {
+            revert SafeTransferUnsupported();
+        } else if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+    }
+
+}
+
diff --git a/assets/eip-5700/erc1155/ERC1155Bindable.sol b/assets/eip-5700/erc1155/ERC1155Bindable.sol
new file mode 100644
index 00000000000000..d7615a2695530f
--- /dev/null
+++ b/assets/eip-5700/erc1155/ERC1155Bindable.sol
@@ -0,0 +1,239 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+import {IERC1155Receiver} from "@openzeppelin/contracts/token/ERC1155/IERC1155Receiver.sol";
+
+import {ERC1155} from "./ERC1155.sol";
+import {IERC1155Bindable} from "../interfaces/IERC1155Bindable.sol";
+import {IERC1155Binder} from "../interfaces/IERC1155Binder.sol";
+
+/// @title ERC-1155 Bindable Reference Implementation.
+/// @dev Only supports the "delegated" binding mode.
+contract ERC1155Bindable is ERC1155, IERC1155Bindable {
+
+    /// @notice Tracks the bound balance of an asset for a specific token type.
+    mapping(address => mapping(uint256 => mapping(uint256 => uint256))) public boundBalanceOf; 
+
+    /// @dev  EIP-165 identifiers for all supported interfaces.
+    bytes4 private constant _ERC165_INTERFACE_ID = 0x01ffc9a7;
+    bytes4 private constant _ERC1155_BINDER_INTERFACE_ID = 0x2ac2d2bc;
+    bytes4 private constant _ERC1155_BINDABLE_INTERFACE_ID = 0xd92c3ff0;
+
+    /// @inheritdoc IERC1155Bindable
+    function boundBalanceOfBatch(
+        address bindAddress,
+        uint256[] calldata bindIds,
+        uint256[] calldata tokenIds
+    ) public view returns (uint256[] memory balances) {
+        if (bindIds.length != tokenIds.length) {
+            revert ArityMismatch();
+        }
+
+        balances = new uint256[](bindIds.length);
+
+        unchecked {
+            for (uint256 i = 0; i < bindIds.length; ++i) {
+                balances[i] = boundBalanceOf[bindAddress][bindIds[i]][tokenIds[i]];
+            }
+        }
+    }
+
+    /// @inheritdoc IERC1155Bindable
+    function bind(
+        address from,
+        address to,
+        uint256 tokenId,
+		uint256 amount,
+        uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) public {
+        if (msg.sender != from && !isApprovedForAll[from][msg.sender]) {
+            revert SenderUnauthorized();
+        }
+
+		IERC1155Binder binder = IERC1155Binder(bindAddress);
+		if (to != bindAddress) {
+			revert BinderInvalid();
+		}
+
+        boundBalanceOf[bindAddress][bindId][tokenId] += amount;
+        _balanceOf[from][tokenId] -= amount;
+        _balanceOf[to][tokenId] += amount;
+		
+        emit Bind(msg.sender, from, bindAddress, tokenId, amount, bindId, bindAddress);
+		emit TransferSingle(msg.sender, from, bindAddress, tokenId, amount);
+
+        if (
+            binder.onERC1155Bind(msg.sender, from, to, tokenId, amount, bindId, data)
+            !=
+            IERC1155Binder.onERC1155Bind.selector
+        ) {
+            revert BindInvalid();
+        } 
+
+    }
+
+    /// @inheritdoc IERC1155Bindable
+    function batchBind(
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+        uint256[] calldata bindIds,
+        address bindAddress,
+        bytes calldata data
+    ) public {
+        if (msg.sender != from && !isApprovedForAll[from][msg.sender]) {
+            revert SenderUnauthorized();
+        }
+
+		IERC1155Binder binder = IERC1155Binder(bindAddress);
+		if (to != bindAddress) {
+			revert BinderInvalid();
+		}
+
+        if (tokenIds.length != amounts.length || tokenIds.length != bindIds.length) {
+            revert ArityMismatch();
+        }
+
+        for (uint256 i = 0; i < tokenIds.length; i++) {
+
+            boundBalanceOf[bindAddress][bindIds[i]][tokenIds[i]] += amounts[i];
+            _balanceOf[from][tokenIds[i]] -= amounts[i];
+            _balanceOf[to][tokenIds[i]] += amounts[i];
+        }
+		
+        emit BindBatch(msg.sender, from, bindAddress, tokenIds, amounts, bindIds, bindAddress);
+		emit TransferBatch(msg.sender, from, bindAddress, tokenIds, amounts);
+
+        if (
+            binder.onERC1155BatchBind(msg.sender, from, to, tokenIds, amounts, bindIds, data)
+            !=
+            IERC1155Binder.onERC1155Bind.selector
+        ) {
+            revert BindInvalid();
+        } 
+
+    }
+
+    /// @inheritdoc IERC1155Bindable
+    function unbind(
+        address from,
+        address to,
+        uint256 tokenId,
+		uint256 amount,
+		uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) public {
+		IERC1155Binder binder = IERC1155Binder(bindAddress);
+        if (
+			binder.ownerOf(bindId) != from
+		) {
+            revert BinderInvalid();
+        }
+
+        if (
+            msg.sender != from &&
+            !binder.isApprovedForAll(from, msg.sender)
+        ) {
+            revert SenderUnauthorized();
+        }
+
+        if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+
+		_balanceOf[to][tokenId] += amount;
+		_balanceOf[from][tokenId] -= amount;
+        boundBalanceOf[bindAddress][bindId][tokenId] -= amount;
+
+        emit Bind(msg.sender, bindAddress, to, tokenId, amount, bindId, bindAddress);
+		emit TransferSingle(msg.sender, bindAddress, to, tokenId, amount);
+
+        if (
+            binder.onERC1155Unbind(msg.sender, from, to, tokenId, amount, bindId, data)
+            !=
+            IERC1155Binder.onERC1155Unbind.selector
+        ) {
+            revert BindInvalid();
+        } 
+
+		if (
+			to.code.length != 0 &&
+				IERC1155Receiver(to).onERC1155Received(msg.sender, from, amount, tokenId, "")
+                !=
+                IERC1155Receiver.onERC1155Received.selector
+		) {
+			revert SafeTransferUnsupported();
+        }
+
+    }
+
+    /// @inheritdoc IERC1155Bindable
+    function batchUnbind(
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+		uint256[] calldata bindIds,
+		address bindAddress,
+        bytes calldata data
+    ) public {
+		IERC1155Binder binder = IERC1155Binder(bindAddress);
+
+        if (
+            msg.sender != from &&
+            !binder.isApprovedForAll(from, msg.sender)
+        ) {
+            revert SenderUnauthorized();
+        }
+
+        if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+
+        if (tokenIds.length != amounts.length || tokenIds.length != bindIds.length) {
+            revert ArityMismatch();
+        }
+
+        for (uint256 i = 0; i < tokenIds.length; i++) {
+
+            if (binder.ownerOf(bindIds[i]) != from) { 
+                revert BinderInvalid(); 
+            }
+
+            _balanceOf[to][tokenIds[i]] += amounts[i];
+            _balanceOf[from][tokenIds[i]] -= amounts[i];
+            boundBalanceOf[bindAddress][bindIds[i]][tokenIds[i]] -= amounts[i];
+        }
+		
+        emit UnbindBatch(msg.sender, from, bindAddress, tokenIds, amounts, bindIds, bindAddress);
+		emit TransferBatch(msg.sender, from, bindAddress, tokenIds, amounts);
+
+        if (
+            binder.onERC1155BatchUnbind(msg.sender, from, to, tokenIds, amounts, bindIds, data)
+            !=
+            IERC1155Binder.onERC1155BatchUnbind.selector
+        ) {
+            revert BindInvalid();
+        } 
+
+		if (
+			to.code.length != 0 &&
+				IERC1155Receiver(to).onERC1155BatchReceived(msg.sender, from, tokenIds, amounts, "")
+                !=
+                IERC1155Receiver.onERC1155BatchReceived.selector
+		) {
+			revert SafeTransferUnsupported();
+        }
+    }
+
+
+    function supportsInterface(bytes4 id) public pure override(ERC1155, IERC165) returns (bool) {
+        return super.supportsInterface(id) || id == _ERC1155_BINDABLE_INTERFACE_ID;
+    }
+
+}
diff --git a/assets/eip-5700/erc1155/ERC1155Binder.sol b/assets/eip-5700/erc1155/ERC1155Binder.sol
new file mode 100644
index 00000000000000..2ac1dcb5762d3e
--- /dev/null
+++ b/assets/eip-5700/erc1155/ERC1155Binder.sol
@@ -0,0 +1,108 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+import {IERC1155} from "@openzeppelin/contracts/token/ERC1155/IERC1155.sol";
+
+import {IERC1155Bindable} from "../interfaces/IERC1155Bindable.sol";
+import {IERC1155Binder} from "../interfaces/IERC1155Binder.sol";
+
+/// @title ERC-1155 Binder Reference Implementation
+contract ERC1155Binder is IERC1155Binder {
+
+    struct Bindable {
+        address tokenAddress;
+        uint256 tokenId;
+    }
+
+    /// @notice Checks for an owner if an address is an authorized operator.
+    mapping(address => mapping(address => bool)) public _isApprovedForAll;
+
+    /// @notice Tracks ownership of bound assets.
+    mapping(uint256 => address) _ownerOf;
+
+    /// @dev  EIP-165 identifiers for all supported interfaces.
+    bytes4 private constant _ERC165_INTERFACE_ID = 0x01ffc9a7;
+    bytes4 private constant _ERC1155_BINDER_INTERFACE_ID = 0x2ac2d2bc;
+    bytes4 private constant _ERC1155_BINDABLE_INTERFACE_ID = 0xd92c3ff0;
+
+    /// @inheritdoc IERC1155Binder
+    function isApprovedForAll(address owner, address operator) external view override returns (bool) {
+        return _isApprovedForAll[owner][operator];
+    }
+
+    /// @inheritdoc IERC1155Binder
+    function ownerOf(uint256 id) public view returns (address) {
+        return _ownerOf[id];
+    }
+
+    /// @inheritdoc IERC1155Binder
+    function onERC1155Bind(
+        address operator,
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        bytes calldata data
+    ) public returns (bytes4) {
+        return IERC1155Binder.onERC1155Bind.selector;
+    }
+
+    /// @inheritdoc IERC1155Binder
+	function onERC1155BatchBind(
+        address operator,
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+        uint256[] calldata bindIds,
+        bytes calldata data
+	) public returns (bytes4) {
+        return IERC1155Binder.onERC1155BatchBind.selector;
+    }
+
+    /// @inheritdoc IERC1155Binder
+    function onERC1155Unbind(
+        address operator,
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        bytes calldata data
+    ) public returns (bytes4) {
+        return IERC1155Binder.onERC1155Unbind.selector;
+    }
+
+    /// @inheritdoc IERC1155Binder
+	function onERC1155BatchUnbind(
+        address operator,
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+        uint256[] calldata bindIds,
+        bytes calldata data
+	) public returns (bytes4) {
+        return IERC1155Binder.onERC1155BatchUnbind.selector;
+    }
+
+    function supportsInterface(bytes4 id) external pure returns (bool) {
+        return id == _ERC165_INTERFACE_ID || id == _ERC1155_BINDER_INTERFACE_ID;
+    }
+
+    /// @notice Mints a new asset identified by `id` to address `to`.
+    function _mint(address to, uint256 id) internal {
+        if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+
+        if (_ownerOf[id] != address(0)) {
+            revert AssetAlreadyMinted();
+        }
+
+        _ownerOf[id] = to;
+    }
+
+}
diff --git a/assets/eip-5700/erc721/ERC721.sol b/assets/eip-5700/erc721/ERC721.sol
new file mode 100644
index 00000000000000..c3f50d98bbdf00
--- /dev/null
+++ b/assets/eip-5700/erc721/ERC721.sol
@@ -0,0 +1,232 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+import {IERC721} from "@openzeppelin/contracts/token/ERC721/IERC721.sol";
+import {IERC721Receiver} from "@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol";
+
+import {IERC721Errors} from "../interfaces/IERC721Errors.sol";
+
+/// @title Reference Minimal ERC-721 Contract
+contract ERC721 is IERC721, IERC721Errors {
+
+    /// @notice The total number of NFTs in circulation.
+    uint256 public totalSupply;
+
+    /// @notice Gets the approved address for an NFT.
+    /// @dev This implementation does not throw for zero-address queries.
+    mapping(uint256 => address) public getApproved;
+
+    /// @notice Gets the number of NFTs owned by an address.
+    mapping(address => uint256) internal _balanceOf;
+
+    /// @dev Tracks the assigned owner of an address.
+    mapping(uint256 => address) internal _ownerOf;
+
+    /// @dev Checks for an owner if an address is an authorized operator.
+    mapping(address => mapping(address => bool)) internal _operatorApprovals;
+
+    /// @dev  EIP-165 identifiers for all supported interfaces.
+    bytes4 private constant _ERC165_INTERFACE_ID = 0x01ffc9a7;
+    bytes4 private constant _ERC721_INTERFACE_ID = 0x80ac58cd;
+
+    /// @notice Gets the assigned owner for token `id`.
+    /// @param id The id of the NFT being queried.
+    /// @return The address of the owner of the NFT of id `id`.
+    function ownerOf(uint256 id) external view virtual returns (address) {
+        return _ownerOf[id];
+    }
+
+    /// @notice Gets number of NFTs owned by address `owner`.
+    /// @param owner The address whose balance is being queried.
+    /// @return The number of NFTs owned by address `owner`.
+    function balanceOf(address owner) external view virtual returns (uint256) {
+        return _balanceOf[owner];
+    }
+
+    /// @notice Sets approved address of NFT of id `id` to address `approved`.
+    /// @param approved The new approved address for the NFT.
+    /// @param id The id of the NFT to approve.
+    function approve(address approved, uint256 id) external virtual {
+        address owner = _ownerOf[id];
+
+        if (msg.sender != owner && !_operatorApprovals[owner][msg.sender]) {
+            revert SenderUnauthorized();
+        }
+
+        getApproved[id] = approved;
+        emit Approval(owner, approved, id);
+    }
+
+    /// @notice Checks if `operator` is an authorized operator for `owner`.
+    /// @param owner The address of the owner.
+    /// @param operator The address of the owner's operator.
+    /// @return True if `operator` is approved operator of `owner`, else False.
+    function isApprovedForAll(address owner, address operator)
+        external
+        view
+        virtual returns (bool)
+    {
+        return _operatorApprovals[owner][operator];
+    }
+
+    /// @notice Sets the operator for `msg.sender` to `operator`.
+    /// @param operator The operator address that will manage the sender's NFTs.
+    /// @param approved Whether operator is allowed to operate sender's NFTs.
+    function setApprovalForAll(address operator, bool approved) external virtual {
+        _operatorApprovals[msg.sender][operator] = approved;
+        emit ApprovalForAll(msg.sender, operator, approved);
+    }
+
+    /// @notice Checks if interface of identifier `id` is supported.
+    /// @param id The ERC-165 interface identifier.
+    /// @return True if interface id `id` is supported, false otherwise.
+    function supportsInterface(bytes4 id) public pure virtual returns (bool) {
+        return
+            id == _ERC165_INTERFACE_ID ||
+            id == _ERC721_INTERFACE_ID;
+    }
+
+    /// @notice Transfers NFT of id `id` from address `from` to address `to`,
+    ///  with safety checks ensuring `to` is capable of receiving the NFT.
+    /// @dev Safety checks are only performed if `to` is a smart contract.
+    /// @param from The existing owner address of the NFT to be transferred.
+    /// @param to The new owner address of the NFT being transferred.
+    /// @param id The id of the NFT being transferred.
+    /// @param data Additional transfer data to pass to the receiving contract.
+    function safeTransferFrom(
+        address from,
+        address to,
+        uint256 id,
+        bytes memory data
+    ) public virtual {
+        transferFrom(from, to, id);
+
+        if (
+            to.code.length != 0 &&
+                IERC721Receiver(to).onERC721Received(msg.sender, from, id, data)
+                !=
+                IERC721Receiver.onERC721Received.selector
+        ) {
+            revert SafeTransferUnsupported();
+        }
+    }
+
+    /// @notice Transfers NFT of id `id` from address `from` to address `to`,
+    ///  with safety checks ensuring `to` is capable of receiving the NFT.
+    /// @dev Safety checks are only performed if `to` is a smart contract.
+    /// @param from The existing owner address of the NFT to be transferred.
+    /// @param to The new owner address of the NFT being transferred.
+    /// @param id The id of the NFT being transferred.
+    function safeTransferFrom(
+        address from,
+        address to,
+        uint256 id
+    ) public virtual {
+        transferFrom(from, to, id);
+
+        if (
+            to.code.length != 0 &&
+                IERC721Receiver(to).onERC721Received(msg.sender, from, id, "")
+                !=
+                IERC721Receiver.onERC721Received.selector
+        ) {
+            revert SafeTransferUnsupported();
+        }
+    }
+
+    /// @notice Transfers NFT of id `id` from address `from` to address `to`,
+    ///  without performing any safety checks.
+    /// @dev Existence of an NFT is inferred by having a non-zero owner address.
+    ///  Transfers clear owner approvals, but `Approval` events are omitted.
+    /// @param from The existing owner address of the NFT being transferred.
+    /// @param to The new owner address of the NFT being transferred.
+    /// @param id The id of the NFT being transferred.
+    function transferFrom(
+        address from,
+        address to,
+        uint256 id
+    ) public virtual {
+        if (from != _ownerOf[id]) {
+            revert OwnerInvalid();
+        }
+
+        if (
+            msg.sender != from &&
+            msg.sender != getApproved[id] &&
+            !_operatorApprovals[from][msg.sender]
+        ) {
+            revert SenderUnauthorized();
+        }
+
+        if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+
+        _beforeTokenTransfer(from, to, id);
+
+        delete getApproved[id];
+
+        unchecked {
+            _balanceOf[from]--;
+            _balanceOf[to]++;
+        }
+
+        _ownerOf[id] = to;
+        emit Transfer(from, to, id);
+    }
+
+    /// @dev Mints NFT of id `id` to address `to`. To save gas, it is assumed
+    ///  that `maxSupply` < `type(uint256).max` (ex. for tabs, cap is very low).
+    /// @param to Address receiving the minted NFT.
+    /// @param id Identifier of the NFT being minted.
+    /// @return The id of the minted NFT.
+    function _mint(address to, uint256 id) internal virtual returns (uint256) {
+        if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+        if (_ownerOf[id] != address(0)) {
+            revert TokenAlreadyMinted();
+        }
+
+        _beforeTokenTransfer(address(0), to, id);
+
+        unchecked {
+            totalSupply++;
+            _balanceOf[to]++;
+        }
+
+        _ownerOf[id] = to;
+        emit Transfer(address(0), to, id);
+        return id;
+    }
+
+    /// @dev Burns NFT of id `id`, removing it from existence.
+    /// @param id Identifier of the NFT being burned
+    function _burn(uint256 id) internal virtual {
+        address owner = _ownerOf[id];
+
+        if (owner == address(0)) {
+            revert TokenNonExistent();
+        }
+
+        _beforeTokenTransfer(owner, address(0), id);
+
+        unchecked {
+            totalSupply--;
+            _balanceOf[owner]--;
+        }
+
+        delete _ownerOf[id];
+        emit Transfer(owner, address(0), id);
+    }
+
+    /// @notice Pre-transfer hook for embedding additional transfer behavior.
+    /// @param from The address of the existing owner of the NFT.
+    /// @param to The address of the new owner of the NFT.
+    /// @param id The id of the NFT being transferred.
+    function _beforeTokenTransfer(address from, address to, uint256 id)
+        internal
+        virtual
+        {}
+
+}
diff --git a/assets/eip-5700/erc721/ERC721Bindable.sol b/assets/eip-5700/erc721/ERC721Bindable.sol
new file mode 100644
index 00000000000000..d772721e6cc5aa
--- /dev/null
+++ b/assets/eip-5700/erc721/ERC721Bindable.sol
@@ -0,0 +1,210 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+import {IERC721} from "@openzeppelin/contracts/token/ERC721/IERC721.sol";
+import {IERC721Receiver} from "@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol";
+
+import {ERC721} from "./ERC721.sol";
+import {IERC721Bindable} from "../interfaces/IERC721Bindable.sol";
+import {IERC721Binder} from "../interfaces/IERC721Binder.sol";
+
+/// @title ERC-721 Bindable Reference Implementation.
+/// @dev Supports both "legacy" and "delegated" binding modes.
+contract ERC721Bindable is ERC721, IERC721Bindable {
+
+    /// @notice Encapsulates a bound asset contract address and identifier.
+    struct Binder {
+        address bindAddress;
+        uint256 bindId;
+    }
+
+    /// @notice Tracks the bound balance of a specific asset.
+    mapping(address => mapping(uint256 => uint256)) public boundBalanceOf; 
+
+    /// @notice Tracks bound assets of an NFT.
+    mapping(uint256 => Binder) internal _bound;
+
+    /// @dev EIP-165 identifiers for all supported interfaces.
+    bytes4 private constant _ERC165_INTERFACE_ID = 0x01ffc9a7;
+    bytes4 private constant _ERC721_BINDER_INTERFACE_ID = 0x2ac2d2bc;
+    bytes4 private constant _ERC721_BINDABLE_INTERFACE_ID = 0xd92c3ff0;
+
+    /// @inheritdoc IERC721Bindable
+    function binderOf(uint256 tokenId) public returns (address, uint256) {
+        Binder memory bound = _bound[tokenId];
+        return (bound.bindAddress, bound.bindId);
+    }
+
+    /// @inheritdoc IERC721Bindable
+    function bind(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) public {
+        if (_bound[tokenId].bindAddress != address(0)) {
+            revert BindExistent();
+        }
+
+        if (from != _ownerOf[tokenId]) {
+            revert OwnerInvalid();
+        }
+
+		IERC721Binder binder = IERC721Binder(bindAddress);
+        address assetOwner = binder.ownerOf(bindId);
+		if (to != assetOwner && to != bindAddress) {
+			revert BinderInvalid();
+		}
+
+        if (
+            msg.sender != from &&
+            msg.sender != getApproved[tokenId] &&
+            !_operatorApprovals[from][msg.sender]
+        ) {
+            revert SenderUnauthorized();
+        }
+
+        delete getApproved[tokenId];
+
+        unchecked {
+            _balanceOf[from]--;
+            _balanceOf[bindAddress]++;
+            _balanceOf[assetOwner]++;
+            boundBalanceOf[bindAddress][bindId]++;
+        }
+
+        _ownerOf[tokenId] = to;
+        _bound[tokenId] = Binder(bindAddress, bindId);
+
+        emit Bind(msg.sender, from, to, tokenId, bindId, bindAddress);
+        emit Transfer(from, to, tokenId);
+
+        if (
+            binder.onERC721Bind(msg.sender, from, to, tokenId, bindId, "")
+            !=
+            IERC721Binder.onERC721Bind.selector
+        ) {
+            revert BindInvalid();
+        } 
+
+    }
+
+    /// @inheritdoc IERC721Bindable
+    function unbind(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) public {
+        Binder memory bound = _bound[tokenId];
+        if (bound.bindAddress != address(0)) {
+            revert BindNonexistent();
+        }
+
+		IERC721Binder binder = IERC721Binder(bindAddress);
+        if (
+			bound.bindAddress != bindAddress || 
+		    bound.bindId != bindId ||
+			binder.ownerOf(bindId) != from
+		) {
+            revert BinderInvalid();
+        }
+
+        if (
+            msg.sender != from &&
+            !binder.isApprovedForAll(from, msg.sender)
+        ) {
+            revert SenderUnauthorized();
+        }
+
+        if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+
+        address delegatedOwner = _ownerOf[tokenId];
+
+        delete getApproved[tokenId];
+
+        unchecked {
+            _balanceOf[to]++;
+            _balanceOf[from]--;
+            _balanceOf[bindAddress]--;
+            boundBalanceOf[bindAddress][bindId]--;
+        }
+
+        _ownerOf[tokenId] = to;
+        delete _bound[tokenId];
+
+        emit Bind(msg.sender, from, to, tokenId, bindId, bindAddress);
+        emit Transfer(delegatedOwner, to, tokenId);
+
+        if (
+            binder.onERC721Unbind(msg.sender, from, to, tokenId, bindId, "")
+            !=
+            IERC721Binder.onERC721Unbind.selector
+        ) {
+            revert BindInvalid();
+        } 
+
+		if (
+			to.code.length != 0 &&
+				IERC721Receiver(to).onERC721Received(msg.sender, delegatedOwner, tokenId, "")
+                !=
+                IERC721Receiver.onERC721Received.selector
+		) {
+			revert SafeTransferUnsupported();
+        }
+
+    }
+
+    /// @inheritdoc IERC721
+    function transferFrom(
+        address from,
+        address to,
+        uint256 tokenId
+    ) public override(IERC721, ERC721) {
+
+        address bindAddress = _bound[tokenId].bindAddress;
+        uint256 bindId = _bound[tokenId].bindId;
+
+        if (bindAddress == address(0)) {
+            return super.transferFrom(from, to, tokenId);
+        } 
+
+        if (msg.sender != bindAddress) {
+            revert BindExistent();
+        }
+
+		IERC721Binder binder = IERC721Binder(bindAddress);
+
+        if (
+			binder.ownerOf(bindId) != from
+		) {
+            revert BinderInvalid();
+        }
+
+        if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+
+        delete getApproved[tokenId];
+
+        uint256 bindBal = boundBalanceOf[bindAddress][bindId];
+        unchecked {
+            _balanceOf[from] -= bindBal;
+            _balanceOf[to] += bindBal;
+        }
+
+        emit Transfer(from, to, tokenId);
+    }
+
+    function supportsInterface(bytes4 id) public pure override(ERC721, IERC165) returns (bool) {
+        return super.supportsInterface(id) || id == _ERC721_BINDABLE_INTERFACE_ID;
+    }
+
+}
diff --git a/assets/eip-5700/erc721/ERC721Binder.sol b/assets/eip-5700/erc721/ERC721Binder.sol
new file mode 100644
index 00000000000000..e8f939aae7b15f
--- /dev/null
+++ b/assets/eip-5700/erc721/ERC721Binder.sol
@@ -0,0 +1,135 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+
+import {ERC721} from "./ERC721.sol";
+import {IERC721Bindable} from "../interfaces/IERC721Bindable.sol";
+import {IERC721Binder} from "../interfaces/IERC721Binder.sol";
+
+/// @title ERC-721 Binder Reference Implementation
+contract ERC721Binder is IERC721Binder {
+
+    struct Bindable {
+        address tokenAddress;
+        uint256 tokenId;
+    }
+
+    /// @notice Checks for an owner if an address is an authorized operator.
+    mapping(address => mapping(address => bool)) public _isApprovedForAll;
+
+    /// @notice Tracks ownership of bound assets.
+    mapping(uint256 => address) _ownerOf;
+
+    /// @notice Maps an asset to a list of all bound bindables.
+    mapping(uint256 => Bindable[]) _boundTokens;
+
+    /// @notice Maps a token address and identifier to the bound tokens index.
+    mapping(address => mapping(uint256 => uint256)) _boundIndexes;
+
+    /// @dev  EIP-165 identifiers for all supported interfaces.
+    bytes4 private constant _ERC165_INTERFACE_ID = 0x01ffc9a7;
+    bytes4 private constant _ERC721_BINDER_INTERFACE_ID = 0x2ac2d2bc;
+    bytes4 private constant _ERC721_BINDABLE_INTERFACE_ID = 0xd92c3ff0;
+
+    /// @inheritdoc IERC721Binder
+    function isApprovedForAll(address owner, address operator) external view override returns (bool) {
+        return _isApprovedForAll[owner][operator];
+    }
+
+    /// @inheritdoc IERC721Binder
+    function ownerOf(uint256 id) public view returns (address) {
+        return _ownerOf[id];
+    }
+
+    /// @inheritdoc IERC721Binder
+    function onERC721Bind(
+        address operator,
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        bytes calldata data
+    ) public returns (bytes4) {
+        if (_ownerOf[bindId] != to) {
+            revert OwnerInvalid();
+        }
+
+        if (_boundIndexes[msg.sender][tokenId] != 0) {
+            revert BindExistent();
+        }
+
+        if (!IERC721Bindable(msg.sender).supportsInterface(_ERC721_BINDABLE_INTERFACE_ID)) {
+            revert BindInvalid();
+        }
+
+        _boundIndexes[msg.sender][tokenId] = _boundTokens[bindId].length;
+        _boundTokens[bindId].push(Bindable(msg.sender, tokenId));
+
+        return IERC721Binder.onERC721Bind.selector;
+    }
+
+    /// @inheritdoc IERC721Binder
+    function onERC721Unbind(
+        address operator,
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        bytes calldata data
+    ) public returns (bytes4) {
+        if (_ownerOf[bindId] != from) {
+            revert OwnerInvalid();
+        }
+
+        if (_boundIndexes[msg.sender][tokenId] == 0) {
+            revert BindNonexistent();
+        }
+
+        uint256 boundLastIndex = _boundTokens[bindId].length - 1;
+        uint256 boundIndex = _boundIndexes[msg.sender][tokenId];
+
+        if (boundIndex != boundLastIndex) {
+            Bindable memory bindable = _boundTokens[bindId][boundLastIndex];
+            _boundTokens[bindId][boundIndex] = bindable;
+            _boundIndexes[bindable.tokenAddress][bindable.tokenId] = boundIndex;
+        }
+
+        delete _boundIndexes[msg.sender][tokenId];
+        delete _boundTokens[bindId][boundLastIndex];
+
+        return IERC721Binder.onERC721Unbind.selector;
+    }
+
+    /// @notice Transfers an asset from address `from` to address `to`.
+    function transfer(
+        address from,
+        address to,
+        uint256 bindId
+    ) public {
+        if (msg.sender != from && !_isApprovedForAll[from][msg.sender]) {
+            revert SenderUnauthorized();
+        }
+
+        if (from != _ownerOf[bindId]) {
+            revert OwnerInvalid();
+        }
+ 
+        if (to == address(0)) {
+            revert ReceiverInvalid();
+        }
+
+        _ownerOf[bindId] = to;
+
+        Bindable[] memory bindables = _boundTokens[bindId];
+        for (uint256 i = 0; i < bindables.length; ++i) {
+            IERC721Bindable(bindables[i].tokenAddress).transferFrom(from, to, bindables[i].tokenId);
+        }
+
+    }
+
+    function supportsInterface(bytes4 id) external pure returns (bool) {
+        return id == _ERC165_INTERFACE_ID || id == _ERC721_BINDER_INTERFACE_ID;
+    }
+
+}
diff --git a/assets/eip-5700/interfaces/IERC1155Bindable.sol b/assets/eip-5700/interfaces/IERC1155Bindable.sol
new file mode 100644
index 00000000000000..c4d491a6e981af
--- /dev/null
+++ b/assets/eip-5700/interfaces/IERC1155Bindable.sol
@@ -0,0 +1,239 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+import {IERC1155} from "@openzeppelin/contracts/token/ERC1155/IERC1155.sol";
+
+import {IERC1155BindableErrors} from "./IERC1155BindableErrors.sol";
+
+/// @title ERC-1155 Bindable Token Standard
+/// @dev See https://eips.ethereum.org/EIPS/eip-5656
+///  Note: the ERC-165 identifier for this interface is 0xd0d555c6.
+interface IERC1155Bindable is IERC1155, IERC1155BindableErrors {
+
+	/// @notice The `Bind` event MUST emit when token ownership is delegated
+	///  through an asset and when minting tokens bound to an existing asset.
+	/// @dev When minting bound tokens, `from` MUST be set to the zero address.
+	/// @param operator The address calling the bind (SHOULD be `msg.sender`).
+	/// @param from The address which owns the unbound token(s).
+	/// @param to The address which owns the asset being bound to.
+	/// @param tokenId The identifier of the token type being bound.
+	/// @param amount The number of tokens of type `tokenId` being bound.
+	/// @param bindId The identifier of the asset being bound to.
+	/// @param bindAddress The contract address handling asset ownership.
+    event Bind(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        address indexed bindAddress
+    );
+
+	/// @notice The `BindBatch` event MUST emit when token ownership of 
+	///  different token types are delegated through different assets at once
+	///  and when minting multiple token types bound to existing assets at once.
+	/// @dev When minting bound tokens, `from` MUST be set to the zero address.
+	/// @param operator The address calling the bind (SHOULD be `msg.sender`).
+	/// @param from The address which owns the unbound token(s).
+	/// @param to The address which owns the asset being bound to.
+	/// @param tokenIds The identifiers of the token types being bound.
+	/// @param amounts The number of tokens for each token type being bound.
+	/// @param bindIds The identifiers of the assets being bound to.
+	/// @param bindAddress The contract address handling asset ownership.
+    event BindBatch(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256[] tokenIds,
+        uint256[] amounts,
+        uint256[] bindIds,
+        address indexed bindAddress
+    );
+
+    /// @notice The `Unbind` event MUST emit when asset-delegated token 
+	///  ownership is revoked and when burning tokens bound to existing assets.
+	/// @dev When burning bound tokens, `to` MUST be set to the zero address.
+	/// @param operator The address calling the unbind (SHOULD be `msg.sender`).
+	/// @param from The address which owns the asset the token(s) are bound to.
+	/// @param to The address which will own the token(s) once unbound.
+	/// @param tokenId The identifier of the token type being unbound.
+	/// @param amount The number of tokens of type `tokenId` being unbound.
+	/// @param bindId The identifier of the asset being unbound from.
+	/// @param bindAddress The contract address handling bound asset ownership.
+    event Unbind(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256 tokenId,
+		uint256 amount,
+        uint256 bindId,
+        address indexed bindAddress
+    );
+
+    /// @notice The `UnbindBatch` event MUST emit when asset-delegated token 
+	///  ownership is revoked for multiple token types at once and when burning 
+	///  multiple token types bound to existing assets at once.
+	/// @dev When burning bound tokens, `to` MUST be set to the zero address.
+	/// @param operator The address calling the unbind (SHOULD be `msg.sender`).
+	/// @param from The address which owns the asset the token(s) are bound to.
+	/// @param to The address which will own the token(s) once unbound.
+	/// @param tokenIds The identifiers of the token types being unbound.
+	/// @param amounts The number of tokens for each token type being unbound.
+	/// @param bindIds The identifier of the assets being unbound from.
+	/// @param bindAddress The contract address handling bound asset ownership.
+    event UnbindBatch(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256[] tokenIds,
+        uint256[] amounts,
+        uint256[] bindIds,
+        address indexed bindAddress
+    );
+
+	/// @notice Delegates ownership of `amount` tokens of type `tokenId` from 
+	///  address `from` through asset `bindId` owned by address `to`.
+	/// @dev The function MUST throw unless `msg.sender` is an approved operator
+	///  for `from`. The function also MUST throw if `from` owns fewer than 
+    ///  `amount` unbound tokens, or if `to` is not the asset owner. After 
+    ///  delegation of ownership, the function MUST check if `bindAddress` is a 
+    ///  valid contract (code size > 0), and if so, call `onERC1155Bind` on the 
+    ///  contract, throwing if the wrong identifier is returned (see "Binding 
+    ///  Rules") or if the contract is invalid. On bind completion, the function
+    ///  MUST emit both `Bind` and IERC-1155 `TransferSingle` events to reflect 
+    ///  delegated ownership change.
+	/// @param from The address which owns the unbound token(s).
+	/// @param to The address which owns the asset being bound to.
+	/// @param tokenId The identifier of the token type being bound.
+	/// @param amount The number of tokens of type `tokenId` being bound.
+	/// @param bindId The identifier of the asset being bound to.
+	/// @param bindAddress The contract address handling asset ownership.
+    /// @param data Additional data sent with the `onERC1155Bind` hook.
+    function bind(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) external;
+
+	/// @notice Delegates ownership of `amounts` tokens of types `tokenIds` from 
+	///  address `from` through assets `bindIds` owned by address `to`.
+	/// @dev The function MUST throw unless `msg.sender` is an approved operator
+	///  for `from`. The function also MUST throw if length of `amounts` is not 
+    ///  the same as `tokenIds` or `bindIds`, if any unbound balances of 
+    ///  `tokenIds` for `from` is less than that of `amounts`, or if `to` is not
+    ///  the asset owner. After delegating ownership, the function MUST check if 
+    ///  `bindAddress` is a valid contract (code size > 0), and if so, call 
+    ///  `onERC1155BatchBind` on the contract, throwing if the wrong identifier 
+    ///  is returned (see "Binding Rules") or if the contract is invalid. On 
+    ///  bind completion, the function MUST emit both `BindBatch` and IERC-1155 
+    ///  `TransferBatch` events to reflect delegated ownership changes.
+	/// @param from The address which owns the unbound tokens.
+	/// @param to The address which owns the assets being bound to.
+	/// @param tokenIds The identifiers of the token types being bound.
+	/// @param amounts The number of tokens for each token type being bound.
+	/// @param bindIds The identifiers of the assets being bound to.
+	/// @param bindAddress The contract address handling asset ownership.
+    /// @param data Additional data sent with the `onERC1155BatchBind` hook.
+    function batchBind(
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+        uint256[] calldata bindIds,
+        address bindAddress,
+        bytes calldata data
+    ) external;
+
+    /// @notice Revokes delegated ownership of `amount` tokens of type `tokenId`
+	///  owned by `from` bound to `bindId`, binding direct ownership to `to`.
+	/// @dev The function MUST throw unless `msg.sender` is an approved operator
+    ///  or owner of the delegated asset `tokenId` is bound to. It also MUST 
+    ///  throw if `from` owns fewer than `amount` bound tokens, or if `to` is 
+    ///  the zero address. Once delegated ownership is revoked, the function 
+    ///  MUST check if `bindAddress` is a valid contract (code size > 0), and if 
+    ///  so, call `onERC1155Unbind` on the contract, throwing if the wrong 
+    ///  identifier is returned (see "Binding Rules") or if the contract is 
+    ///  invalid. The function also MUST check if `to` is a contract, and if so,
+    ///  call on it `onERC1155Received`, throwing if the wrong identifier is 
+    ///  returned. On unbind completion, the function MUST emit both `Unbind` 
+    ///  and IERC-1155 `TransferSingle` events to reflect delegated ownership change.
+	/// @param from The address which owns the asset the token(s) are bound to.
+	/// @param to The address which will own the tokens once unbound.
+	/// @param tokenId The identifier of the token type being unbound.
+	/// @param amount The number of tokens of type `tokenId` being unbound.
+	/// @param bindId The identifier of the asset being unbound from.
+	/// @param bindAddress The contract address handling bound asset ownership.
+    /// @param data Additional data sent with the `onERC1155Unbind` hook.
+    function unbind(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+		uint256 bindId,
+		address bindAddress,
+        bytes calldata data
+    ) external;
+
+    /// @notice Revokes delegated ownership of `amounts` tokens of `tokenIds`
+	///  bound to assets `bindIds`, binding direct ownership to `to`.
+	/// @dev The function MUST throw unless `msg.sender` is an approved operator
+    ///  or owner of all delegated assets `tokenIds` are bound to. It also MUST
+    ///  throw if the length of `amounts` is not the same as `tokenIds` or 
+    ///  `bindIds`, if any bound balances of `tokenId` for `from` is less than 
+    ///  that of `amounts`, or if `to` is the zero address. Once delegated 
+    ///  ownership is revoked, the function MUST check if `bindAddress` is a 
+    ///  valid contract (code size >  0), and if so, call onERC1155BatchUnbind` 
+    ///  on it, throwing if a wrong identifier is returned (see "Binding Rules") 
+    ///  or if the contract is invalid. The function also MUST check if `to` is 
+    ///  a valid contract, and if so, call `onERC1155BatchReceived`, throwing if 
+    ///  the wrong identifier is returned. On unbind completion, the function 
+    ///  MUST emit the `BatchUnbind` and IERC-1155 `TransferBatch` events to 
+    ///  reflect delegated ownership changes.
+	/// @param from The address which owns the asset the tokens are bound to.
+	/// @param to The address which will own the tokens once unbound.
+	/// @param tokenIds The identifiers of the token types being unbound.
+	/// @param amounts The number of tokens for each token type being unbound.
+	/// @param bindIds The identifier of the assets being unbound from.
+	/// @param bindAddress The contract address handling bound asset ownership.
+    /// @param data Additional data sent with the `onERC1155BatchUnbind` hook.
+    function batchUnbind(
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+		uint256[] calldata bindIds,
+		address bindAddress,
+        bytes calldata data
+    ) external;
+
+    /// @notice Gets the balance of bound tokens of type `tokenId` bound to the
+    ///  asset `bindId` at address `bindAddress`.
+    /// @param bindId The identifier of the bound asset.
+    /// @param bindAddress The contract address handling bound asset ownership.
+	/// @param tokenId The identifier of the bound token type being counted.
+    /// @return The total number of NFTs bound to the asset.
+    function boundBalanceOf(
+        address bindAddress,
+        uint256 bindId,
+        uint256 tokenId
+    ) external returns (uint256);
+
+	/// @notice Gets the balance of bound tokens for multiple token types given
+    ///  by `tokenIds` bound to assets `bindIds` at address `bindAddress`.
+    /// @notice Retrieves bound balances of multiple asset / token type pairs.
+    /// @param bindIds List of bound asset identifiers.
+    /// @param bindAddress The contract address handling bound asset ownership.
+	/// @param tokenIds The identifiers of the token type being counted.
+    /// @return balances The bound balances for each asset / token type pair.
+    function boundBalanceOfBatch(
+        address bindAddress,
+        uint256[] calldata bindIds,
+        uint256[] calldata tokenIds
+    ) external returns (uint256[] memory balances);
+
+}
diff --git a/assets/eip-5700/interfaces/IERC1155BindableErrors.sol b/assets/eip-5700/interfaces/IERC1155BindableErrors.sol
new file mode 100644
index 00000000000000..4b6aefa89cd352
--- /dev/null
+++ b/assets/eip-5700/interfaces/IERC1155BindableErrors.sol
@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+/// @title ERC-1155 Bindable Errors Interface
+interface IERC1155BindableErrors {
+
+    /// @notice Bind is not valid.
+    error BindInvalid();
+
+    /// @notice Bound asset or bound asset owner is not valid.
+    error BinderInvalid();
+
+}
diff --git a/assets/eip-5700/interfaces/IERC1155Binder.sol b/assets/eip-5700/interfaces/IERC1155Binder.sol
new file mode 100644
index 00000000000000..4466ae7e372f0a
--- /dev/null
+++ b/assets/eip-5700/interfaces/IERC1155Binder.sol
@@ -0,0 +1,130 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+
+import {IERC1155BinderErrors} from "./IERC1155BinderErrors.sol";
+
+/// @dev Note: the ERC-165 identifier for this interface is 0x6fc97e78.
+interface IERC1155Binder is IERC165, IERC1155BinderErrors {
+
+	/// @notice Handles binding of an IERC1155Bindable-compliant token type.
+	/// @dev An IERC1155Bindable-compliant smart contract MUST call this 
+	///  function at the end of a `bind` after delegating ownership to the asset 
+	///  owner. The function MUST revert if `to` is not the asset owner of
+    ///  `bindId`, or if `bindId` is not a valid asset. The function MUST revert
+    ///  if it rejects the bind. If accepting the bind, the function MUST return
+	///  `bytes4(keccak256("onERC1155Bind(address,address,address,uint256,uint256,uint256,bytes)"))`
+	///  Caller MUST revert the transaction if the above value is not returned.
+	///  Note: The contract address of the binding token is `msg.sender`.
+	/// @param operator The address responsible for binding.
+	/// @param from The address which owns the unbound tokens.
+	/// @param to The address which owns the asset being bound to.
+	/// @param tokenId The identifier of the token type being bound.
+	/// @param bindId The identifier of the asset being bound to.
+    /// @param data Additional data sent along with no specified format.
+	/// @return `bytes4(keccak256("onERC1155Bind(address,address,address,uint256,uint256,uint256,bytes)"))`
+	function onERC1155Bind(
+        address operator,
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        bytes calldata data
+	) external returns (bytes4);
+
+	/// @notice Handles binding of multiple IERC1155Bindable-compliant tokens 
+    ///  `tokenIds` to multiple assets `bindIds`.
+	/// @dev An IERC1155Bindable-compliant smart contract MUST call this 
+	///  function at the end of a `batchBind` after delegating ownership of 
+    ///  multiple token types to the asset owner. The function MUST revert if 
+    ///  `to` is not the asset owner of `bindId`, or if `bindId` is not a valid 
+    ///  asset. The function MUST revert if it rejects the binds. If accepting 
+    ///  the binds, the function MUST return `bytes4(keccak256("onERC1155BatchBind(address,address,address,uint256[],uint256[],uint256[],bytes)"))`
+	///  Caller MUST revert the transaction if the above value is not returned.
+	///  Note: The contract address of the binding token is `msg.sender`.
+	/// @param operator The address responsible for performing the binds.
+	/// @param from The address which owns the unbound tokens.
+	/// @param to The address which owns the assets being bound to.
+	/// @param tokenIds The list of token types being bound.
+	/// @param amounts The number of tokens for each token type being bound.
+	/// @param bindIds The identifiers of the assets being bound to.
+    /// @param data Additional data sent along with no specified format.
+	/// @return `bytes4(keccak256("onERC1155Bind(address,address,address,uint256[],uint256[],uint256[],bytes)"))`
+	function onERC1155BatchBind(
+        address operator,
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+        uint256[] calldata bindIds,
+        bytes calldata data
+	) external returns (bytes4);
+
+	/// @notice Handles unbinding of an IERC1155Bindable-compliant token type.
+	/// @dev An IERC1155Bindable-compliant contract MUST call this function at
+	///  the end of an `unbind` after revoking delegated asset ownership. The 
+	///  function MUST revert if `from` is not the asset owner of `bindId`, 
+	///  or if `bindId` is not a valid asset. The function MUST revert if it
+	///  rejects the unbind. If accepting the unbind, the function MUST return
+	///  `bytes4(keccak256("onERC1155Unbind(address,address,address,uint256,uint256,uint256,bytes)"))`
+	///  Caller MUST revert the transaction if the above value is not returned.
+	///  Note: The contract address of the unbinding token is `msg.sender`.
+	/// @param operator The address responsible for performing the unbind.
+	/// @param from The address which owns the asset the token type is bound to.
+	/// @param to The address which will own the tokens once unbound.
+	/// @param tokenId The token type being unbound.
+	/// @param amount The number of tokens of type `tokenId` being unbound.
+	/// @param bindId The identifier of the asset being unbound from.
+    /// @param data Additional data sent along with no specified format.
+	/// @return `bytes4(keccak256("onERC1155Unbind(address,address,address,uint256,uint256,uint256,bytes)"))`
+	function onERC1155Unbind(
+        address operator,
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 amount,
+        uint256 bindId,
+        bytes calldata data
+	) external returns (bytes4);
+
+	/// @notice Handles unbinding of multiple IERC1155Bindable-compliant token types.
+	/// @dev An IERC1155Bindable-compliant contract MUST call this function at
+	///  the end of an `batchUnbind` after revoking delegated asset ownership. 
+    ///  The function MUST revert if `from` is not the asset owner of `bindId`, 
+	///  or if `bindId` is not a valid asset. The function MUST revert if it
+	///  rejects the unbinds. If accepting the unbinds, the function MUST return
+	///  `bytes4(keccak256("onERC1155Unbind(address,address,address,uint256[],uint256[],uint256[],bytes)"))`
+	///  Caller MUST revert the transaction if the above value is not returned.
+	///  Note: The contract address of the unbinding token is `msg.sender`.
+	/// @param operator The address responsible for performing the unbinds.
+	/// @param from The address which owns the assets being unbound from.
+	/// @param to The address which will own the tokens once unbound.
+	/// @param tokenIds The list of token types being unbound.
+	/// @param amounts The number of tokens for each token type being unbound.
+	/// @param bindIds The identifiers of the assets being unbound from.
+    /// @param data Additional data sent along with no specified format.
+	/// @return `bytes4(keccak256("onERC1155Unbind(address,address,address,uint256[],uint256[],uint256[],bytes)"))`
+	function onERC1155BatchUnbind(
+        address operator,
+        address from,
+        address to,
+        uint256[] calldata tokenIds,
+        uint256[] calldata amounts,
+        uint256[] calldata bindIds,
+        bytes calldata data
+	) external returns (bytes4);
+
+    /// @notice Gets the owner address of the asset represented by id `bindId`.
+	/// @param bindId The identifier of the asset whose owner is being queried.
+    /// @return The address of the owner of the asset.
+	function ownerOf(uint256 bindId) external view returns (address);
+
+    /// @notice Checks if an operator can act on behalf of an asset owner.
+    /// @param owner The address that owns an asset.
+    /// @param operator The address that acts on behalf of owner `owner`.
+    /// @return True if `operator` can act on behalf of `owner`, else False.
+    function isApprovedForAll(address owner, address operator) external view returns (bool);
+
+}
diff --git a/assets/eip-5700/interfaces/IERC1155BinderErrors.sol b/assets/eip-5700/interfaces/IERC1155BinderErrors.sol
new file mode 100644
index 00000000000000..9c438338910d66
--- /dev/null
+++ b/assets/eip-5700/interfaces/IERC1155BinderErrors.sol
@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+/// @title ERC-1155 Binder Errors Interface
+interface IERC1155BinderErrors {
+
+    /// @notice Asset has already minted.
+    error AssetAlreadyMinted();
+
+    /// @notice Receiving address cannot be the zero address.
+    error ReceiverInvalid();
+
+}
diff --git a/assets/eip-5700/interfaces/IERC1155Errors.sol b/assets/eip-5700/interfaces/IERC1155Errors.sol
new file mode 100644
index 00000000000000..d3f07129986394
--- /dev/null
+++ b/assets/eip-5700/interfaces/IERC1155Errors.sol
@@ -0,0 +1,28 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+/// @title ERC-1155 Errors Interface
+interface IERC1155Errors {
+
+    /// @notice Arity mismatch between two arrays.
+    error ArityMismatch();
+
+    /// @notice Originating address does not own the NFT.
+    error OwnerInvalid();
+
+    /// @notice Receiving address cannot be the zero address.
+    error ReceiverInvalid();
+
+    /// @notice Receiving contract does not implement the ERC-1155 wallet interface.
+    error SafeTransferUnsupported();
+
+    /// @notice Sender is not NFT owner, approved address, or owner operator.
+    error SenderUnauthorized();
+
+    /// @notice Token has already minted.
+    error TokenAlreadyMinted();
+
+    /// @notice NFT does not exist.
+    error TokenNonExistent();
+
+}
diff --git a/assets/eip-5700/interfaces/IERC721Bindable.sol b/assets/eip-5700/interfaces/IERC721Bindable.sol
new file mode 100644
index 00000000000000..f8ac283ec25c1c
--- /dev/null
+++ b/assets/eip-5700/interfaces/IERC721Bindable.sol
@@ -0,0 +1,112 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+import {IERC721} from "@openzeppelin/contracts/token/ERC721/IERC721.sol";
+
+import {IERC721BindableErrors} from "./IERC721BindableErrors.sol";
+
+/// @title ERC-721 Bindable Token Standard
+/// @dev See https://eips.ethereum.org/EIPS/eip-5700
+///  Note: the ERC-165 identifier for this interface is 0x82a34a7d.
+interface IERC721Bindable is IERC721, IERC721BindableErrors {
+
+	/// @notice The `Bind` event MUST emit when NFT ownership is delegated
+	///  through an asset and when minting an NFT bound to an existing asset.
+	/// @dev When minting bound NFTs, `from` MUST be set to the zero address.
+	/// @param operator The address calling the bind (SHOULD be `msg.sender`).
+	/// @param from The address which owns the unbound NFT.
+	/// @param to The address which owns the asset being bound to.
+	/// @param tokenId The identifier of the NFT being bound.
+	/// @param bindId The identifier of the asset being bound to.
+	/// @param bindAddress The contract address handling asset ownership.
+    event Bind(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        address indexed bindAddress
+    );
+
+    /// @notice The `Unbind` event MUST emit when asset-delegated NFT ownership 
+	///  is revoked, as well as when burning an NFT bound to an existing asset.
+	/// @dev When burning bound NFTs, `to` MUST be set to the zero address.
+	/// @param operator The address calling the unbind (SHOULD be `msg.sender`).
+	/// @param from The address which owns the asset the NFT is bound to.
+	/// @param to The address which will own the NFT once unbound.
+	/// @param tokenId The identifier of the NFT being unbound.
+	/// @param bindId The identifier of the asset being unbound from.
+	/// @param bindAddress The contract address handling bound asset ownership.
+    event Unbind(
+        address indexed operator,
+        address indexed from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        address indexed bindAddress
+    );
+
+	/// @notice Delegates NFT ownership of NFT `tokenId` from address `from`
+	///  through the asset `bindId` owned by address `to`.
+	/// @dev The function MUST throw unless `msg.sender` is the current owner, 
+	///  an authorized operator, or the approved address for the NFT. It also
+	///  MUST throw if NFT `tokenId` is already bound, if `from` is not the NFT 
+	///  owner, or if `to` is not the asset owner. After ownership delegation, 
+    ///  the function MUST check if `bindAddress` is a valid contract (code size
+    ///  > 0), and if so, call `onERC721Bind` on the contract, throwing if the 
+    ///  wrong identifier is returned (see "Binding Rules") or if the contract 
+    ///  is invalid. On bind completion, the function MUST emit both `Bind` and 
+    ///  IERC-721 `Transfer` events to reflect delegated ownership change.
+	/// @param from The address which owns the unbound NFT.
+	/// @param to The address which owns the asset being bound to.
+	/// @param tokenId The identifier of the NFT being bound.
+	/// @param bindId The identifier of the asset being bound to.
+	/// @param bindAddress The contract address handling asset ownership.
+    /// @param data Additional data sent with the `onERC721Bind` hook.
+    function bind(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) external;
+
+	/// @dev The function MUST throw unless `msg.sender` is an approved operator
+    ///  or owner of the delegated asset of `tokenId`. It also MUST throw if NFT
+    ///  `tokenId` is not bound, if `from` is not the asset owner, or if `to` 
+    ///  is the zero address. After ownership transition, the function MUST 
+    ///  check if `bindAddress` is a valid contract (code size > 0), and if so, 
+    ///  call `onERC721Unbind` the contract, throwing if the wrong identifier is 
+    ///  returned (see "Binding Rules") or if the contract is invalid. 
+    ///  The function also MUST check if `to` is a valid contract, and if so, 
+    ///  call `onERC721Received`, throwing if the wrong identifier is returned.
+    ///  On unbind completion, the function MUST emit both `Unbind` and IERC-721 
+    ///  `Transfer` events to reflect delegated ownership change.
+	/// @param from The address which owns the asset the NFT is bound to.
+	/// @param to The address which will own the NFT once unbound.
+	/// @param tokenId The identifier of the NFT being unbound.
+	/// @param bindId The identifier of the asset being unbound from.
+	/// @param bindAddress The contract address handling bound asset ownership.
+    /// @param data Additional data sent with the `onERC721Unbind` hook.
+    function unbind(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 bindId,
+        address bindAddress,
+        bytes calldata data
+    ) external;
+
+	/// @notice Gets the asset identifier and address which a token is bound to.
+    /// @param tokenId The identifier of the NFT being queried.
+    /// @return The bound asset identifier and contract address.
+    function binderOf(uint256 tokenId) external returns (address, uint256);
+
+    /// @notice Counts NFTs bound to asset `bindId` at address `bindAddress`.
+    /// @param bindId The identifier of the bound asset.
+    /// @param bindAddress The contract address handling bound asset ownership.
+    /// @return The total number of NFTs bound to the asset.
+    function boundBalanceOf(address bindAddress, uint256 bindId) external returns (uint256);
+
+}
diff --git a/assets/eip-5700/interfaces/IERC721BindableErrors.sol b/assets/eip-5700/interfaces/IERC721BindableErrors.sol
new file mode 100644
index 00000000000000..112493270eecdf
--- /dev/null
+++ b/assets/eip-5700/interfaces/IERC721BindableErrors.sol
@@ -0,0 +1,19 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+/// @title ERC-721 Bindable Errors Interface
+interface IERC721BindableErrors {
+
+    /// @notice Bind already exists.
+    error BindExistent();
+
+    /// @notice Bind does not exist.
+    error BindNonexistent();
+
+    /// @notice Bind is not valid.
+    error BindInvalid();
+
+    /// @notice Bound asset or bound asset owner is not valid.
+    error BinderInvalid();
+
+}
diff --git a/assets/eip-5700/interfaces/IERC721Binder.sol b/assets/eip-5700/interfaces/IERC721Binder.sol
new file mode 100644
index 00000000000000..93426e29f56fce
--- /dev/null
+++ b/assets/eip-5700/interfaces/IERC721Binder.sol
@@ -0,0 +1,72 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+import {IERC165} from "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+
+import {IERC721BinderErrors} from "./IERC721BinderErrors.sol";
+
+/// @dev Note: the ERC-165 identifier for this interface is 0x2ac2d2bc.
+interface IERC721Binder is IERC165, IERC721BinderErrors {
+
+	/// @notice Handles the binding of an IERC721Bindable-compliant NFT.
+	/// @dev An IERC721Bindable-compliant smart contract MUST call this function
+	///  at the end of a `bind` after delegating ownership to the asset owner.
+	///  The function MUST revert if `to` is not the asset owner of `bindId` or 
+    ///  if asset `bindId` is not a valid asset. The function MUST revert if it 
+    ///  rejects the bind. If accepting the bind, the function MUST return 
+    /// `bytes4(keccak256("onERC721Bind(address,address,address,uint256,uint256,bytes)"))`
+	///  Caller MUST revert the transaction if the above value is not returned.
+	///  Note: The contract address of the binding NFT is `msg.sender`.
+	/// @param operator The address responsible for initiating the bind.
+	/// @param from The address which owns the unbound NFT.
+	/// @param to The address which owns the asset being bound to.
+	/// @param tokenId The identifier of the NFT being bound.
+	/// @param bindId The identifier of the asset being bound to.
+    /// @param data Additional data sent along with no specified format.
+	/// @return `bytes4(keccak256("onERC721Bind(address,address,address,uint256,uint256,bytes)"))`
+	function onERC721Bind(
+			address operator,
+			address from,
+			address to,
+			uint256 tokenId,
+			uint256 bindId,
+			bytes calldata data
+	) external returns (bytes4);
+
+	/// @notice Handles the unbinding of an IERC721Bindable-compliant NFT.
+	/// @dev An IERC721Bindable-compliant smart contract MUST call this function
+	///  at the end of an `unbind` after revoking delegated asset ownership.
+	///  The function MUST revert if `from` is not the asset owner of `bindId`
+    ///  or if `bindId` is not a valid asset. The function MUST revert if it 
+    ///  rejects the unbind. If accepting the unbind, the function MUST return
+    ///  `bytes4(keccak256("onERC721Unbind(address,address,address,uint256,uint256,bytes)"))`
+	///  Caller MUST revert the transaction if the above value is not returned.
+	///  Note: The contract address of the unbinding NFT is `msg.sender`.
+	/// @param from The address which owns the asset the NFT is bound to.
+	/// @param to The address which will own the NFT once unbound.
+	/// @param tokenId The identifier of the NFT being unbound.
+	/// @param bindId The identifier of the asset being unbound from.
+    /// @param data Additional data with no specified format.
+	/// @return `bytes4(keccak256("onERC721Unbind(address,address,address,uint256,uint256,bytes)"))`
+	function onERC721Unbind(
+			address operator,
+			address from,
+			address to,
+			uint256 tokenId,
+			uint256 bindId,
+			bytes calldata data
+	) external returns (bytes4);
+
+    /// @notice Gets the owner address of the asset represented by id `bindId`.
+    /// @dev Queries for assets assigned to the zero address MUST throw.
+	/// @param bindId The identifier of the asset whose owner is being queried.
+    /// @return The address of the owner of the asset.
+	function ownerOf(uint256 bindId) external view returns (address);
+
+    /// @notice Checks if an operator can act on behalf of an asset owner.
+    /// @param owner The address that owns an asset.
+    /// @param operator The address that acts on behalf of owner `owner`.
+    /// @return True if `operator` can act on behalf of `owner`, else False.
+    function isApprovedForAll(address owner, address operator) external view returns (bool);
+
+}
diff --git a/assets/eip-5700/interfaces/IERC721BinderErrors.sol b/assets/eip-5700/interfaces/IERC721BinderErrors.sol
new file mode 100644
index 00000000000000..c949e6e57c960c
--- /dev/null
+++ b/assets/eip-5700/interfaces/IERC721BinderErrors.sol
@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+/// @title ERC-721 Binder Errors Interface
+interface IERC721BinderErrors {
+
+    /// @notice Asset binding already exists.
+    error BindExistent();
+
+    /// @notice Asset binding is not valid.
+    error BindInvalid();
+
+    /// @notice Asset binding does not exist.
+    error BindNonexistent();
+
+    /// @notice Originating address does not own the asset.
+    error OwnerInvalid();
+
+    /// @notice Receiving address cannot be the zero address.
+    error ReceiverInvalid();
+
+    /// @notice Sender is not NFT owner, approved address, or owner operator.
+    error SenderUnauthorized();
+
+}
diff --git a/assets/eip-5700/interfaces/IERC721Errors.sol b/assets/eip-5700/interfaces/IERC721Errors.sol
new file mode 100644
index 00000000000000..2fc6494c098d5b
--- /dev/null
+++ b/assets/eip-5700/interfaces/IERC721Errors.sol
@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.16;
+
+/// @title ERC-721 Errors Interface
+interface IERC721Errors {
+
+    /// @notice Originating address does not own the NFT.
+    error OwnerInvalid();
+
+    /// @notice Receiving address cannot be the zero address.
+    error ReceiverInvalid();
+
+    /// @notice Receiving contract does not implement the ERC-721 wallet interface.
+    error SafeTransferUnsupported();
+
+    /// @notice Sender is not NFT owner, approved address, or owner operator.
+    error SenderUnauthorized();
+
+    /// @notice NFT supply has hit maximum capacity.
+    error SupplyMaxCapacity();
+
+    /// @notice Token has already minted.
+    error TokenAlreadyMinted();
+
+    /// @notice NFT does not exist.
+    error TokenNonExistent();
+
+}
+

From 40ef70fd4b94c978de2e2e1a450407a8af20759a Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 17 Jan 2023 19:30:05 -0500
Subject: [PATCH 179/274] Update EIP-5920: Reduce account creation gas (#6349)

---
 EIPS/eip-5920.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5920.md b/EIPS/eip-5920.md
index 9a899d93eb924d..b2bffafcbded2b 100644
--- a/EIPS/eip-5920.md
+++ b/EIPS/eip-5920.md
@@ -26,7 +26,7 @@ Currently, to send ether to an address requires you to call a function of that a
 | `BASE_GAS_COST`     | `8500`  |
 | `WARM_GAS_COST`     | `100`   |
 | `COLD_GAS_COST`     | `2500`  |
-| `CREATION_GAS_COST` | `32600` |
+| `CREATION_GAS_COST` | `32000` |
 
 A new opcode is introduced: `PAY` (`PAY_OPCODE`), which:
 

From e6d47e7600b6d076e09ccdd8c0b9e7dcadc4c159 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 17 Jan 2023 19:59:37 -0500
Subject: [PATCH 180/274] Update EIP-5920: Reference eip-2929 and massively
 reduce pay opcode price (#6350)

* Update EIP-5920: Reference eip-2929 and massively reduce pay opcode price

* Add 2929 to requires
---
 EIPS/eip-5920.md | 8 +++-----
 1 file changed, 3 insertions(+), 5 deletions(-)

diff --git a/EIPS/eip-5920.md b/EIPS/eip-5920.md
index b2bffafcbded2b..d442dfa66bf569 100644
--- a/EIPS/eip-5920.md
+++ b/EIPS/eip-5920.md
@@ -8,6 +8,7 @@ status: Review
 type: Standards Track
 category: Core
 created: 2022-03-14
+requires: 2929
 ---
 
 ## Abstract
@@ -23,17 +24,14 @@ Currently, to send ether to an address requires you to call a function of that a
 | Parameter           | Value   |
 | ------------------- | ------- |
 | `PAY_OPCODE`        | `0xf9`  |
-| `BASE_GAS_COST`     | `8500`  |
-| `WARM_GAS_COST`     | `100`   |
-| `COLD_GAS_COST`     | `2500`  |
-| `CREATION_GAS_COST` | `32000` |
+| `GAS_COST`          | `3000`  |
 
 A new opcode is introduced: `PAY` (`PAY_OPCODE`), which:
 
 - Pops two values from the stack: `addr` then `val`.
 - Transfers `val` wei from the executing address to the address `addr`. If `addr` is the zero address, instead, `val` wei is burned from the executing address.
 
-The cost of this opcode is `BASE_GAS_COST`. If `addr` is not the zero address, this opcode costs an additional `WARM_GAS_COST` if `addr` is a warm account, `COLD_GAS_COST` if `addr` is a cold account, or `CREATION_GAS_COST` if `addr` has not yet been created.
+The cost of this opcode is `GAS_COST`. If `addr` is not the zero address, the [EIP-2929](./eip-2929.md) account access costs are also incurred.
 
 ## Rationale
 

From 29ed3d5af63010133844b16110e27b9ab784dd97 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 17 Jan 2023 23:15:58 -0500
Subject: [PATCH 181/274] Update EIP-6190: Remove axic as an author (#6352)

---
 EIPS/eip-6190.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6190.md b/EIPS/eip-6190.md
index 90fddc4871cfa4..5407aa6991448b 100644
--- a/EIPS/eip-6190.md
+++ b/EIPS/eip-6190.md
@@ -2,7 +2,7 @@
 eip: 6190
 title: Verkle-compatible SELFDESTRUCT
 description: Changes SELFDESTRUCT to only cause a finite number of state changes
-author: Pandapip1 (@Pandapip1), Alex Beregszaszi (@axic)
+author: Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/eip-6190-functional-selfdestruct/12232
 status: Draft
 type: Standards Track

From b959821529d9b954ae130076ebe39149435cb973 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Tue, 17 Jan 2023 20:27:51 -0800
Subject: [PATCH 182/274] Update EIP-2135: Move to Last Call (#6338)

* Update eip-2135.md

* Update eip-2135.md
---
 EIPS/eip-2135.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-2135.md b/EIPS/eip-2135.md
index 6c3d32582c5816..811258895652f3 100644
--- a/EIPS/eip-2135.md
+++ b/EIPS/eip-2135.md
@@ -4,7 +4,8 @@ title: Consumable Interface (Tickets, etc)
 description: An interface extending EIP-721 and EIP-1155 for consumability, supporting use case such as an event ticket.
 author: Zainan Victor Zhou (@xinbenlv)
 discussions-to: https://ethereum-magicians.org/t/eip-2135-erc-consumable-interface/3439
-status: Review
+status: Last Call
+last-call-deadline: 2023-02-01
 type: Standards Track
 category: ERC
 created: 2019-06-23
@@ -163,4 +164,5 @@ Security audits and tests should be used to verify that the access control to th
 function behaves as expected.
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 67558acc2baf5e7a6993bedad0de9b78a9fefde3 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Tue, 17 Jan 2023 20:28:43 -0800
Subject: [PATCH 183/274] Update eip-5982.md (#6340)

---
 EIPS/eip-5982.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5982.md b/EIPS/eip-5982.md
index ec9a80335aff52..1a2be955ca2298 100644
--- a/EIPS/eip-5982.md
+++ b/EIPS/eip-5982.md
@@ -4,7 +4,7 @@ title: Role-based Access Control
 description: An interface for role-based access control for smart contracts.
 author: Zainan Victor Zhou (@xinbenlv)
 discussions-to: https://ethereum-magicians.org/t/eip-5982-role-based-access-control/11759
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-11-15

From 39afe1d932ee4c612003a640c1d2a61fbe8c243a Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Tue, 17 Jan 2023 20:30:22 -0800
Subject: [PATCH 184/274] Update eip-5604.md (#6342)

---
 EIPS/eip-5604.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5604.md b/EIPS/eip-5604.md
index f07521ce8e421c..43b0a60a7a084f 100644
--- a/EIPS/eip-5604.md
+++ b/EIPS/eip-5604.md
@@ -4,7 +4,7 @@ title: NFT Lien
 description: Extend EIP-721 to support putting liens on NFT
 author: Allen Zhou <allen@ubiloan.io>, Alex Qin <alex@ubiloan.io>, Zainan Victor Zhou (@xinbenlv)
 discussions-to: https://ethereum-magicians.org/t/creating-a-new-erc-proposal-for-nft-lien/10683
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-09-05

From 6e1cc697fa5fdcf8bd27cdf74e27371e1318eade Mon Sep 17 00:00:00 2001
From: Hadrien Croubois <hadrien.croubois@gmail.com>
Date: Wed, 18 Jan 2023 20:56:28 +0100
Subject: [PATCH 185/274] Update to EIP-5805  (#6356)

* change getPastVotes requirements

* add CLOCK_MODE

* add missing function details

* use uint48 timepoints

* update from= param for CLOCK_MODE

* Update eip-5805.md

* Apply suggestions from code review

Co-authored-by: Francisco <fg@frang.io>

* Add @frangio as a co-author

* Update eip-5805.md

Co-authored-by: Francisco <fg@frang.io>
---
 EIPS/eip-5805.md | 42 ++++++++++++++++++++++++++++++++++++++----
 1 file changed, 38 insertions(+), 4 deletions(-)

diff --git a/EIPS/eip-5805.md b/EIPS/eip-5805.md
index 657216340d39d7..233fa77c7df22d 100644
--- a/EIPS/eip-5805.md
+++ b/EIPS/eip-5805.md
@@ -2,7 +2,7 @@
 eip: 5805
 title: Voting with delegation
 description: An interface for voting weight tracking, with delegation support
-author: Hadrien Croubois (@Amxx)
+author: Hadrien Croubois (@Amxx), Francisco Giordano (@frangio)
 discussions-to: https://ethereum-magicians.org/t/eip-5805-voting-with-delegation/11407
 status: Draft
 type: Standards Track
@@ -60,7 +60,7 @@ This function returns the current timepoint. It could be `block.timestamp`, `blo
 - If operating using **timestamp**, then this function MUST be implemented.
 - If operating using any other mode, then this function MUST be implemented.
 
-This function is thus optional, and its absence should be considered as a marker of the contract operating using block number. (This makes this EIP compatible with pre-existing voting contracts)
+This function is thus optional, and its absence should be considered as a marker of the contract operating using block number. (This makes this EIP compatible with pre-existing voting contracts).
 
 ```yaml
 - name: clock
@@ -69,7 +69,33 @@ This function is thus optional, and its absence should be considered as a marker
   inputs: []
   outputs:
     - name: timepoint
-      type: uint256
+      type: uint48
+```
+
+### CLOCK_MODE
+
+This function returns a string describing the clock the contract is operating on.
+
+- If operating using **block number**:
+  - If the block numbers are those of the `NUMBER` opcode (`0x43`), then this function SHOULD be implemented and return `mode=blocknumber&from=default`.
+  - If it is any other block number, then this function MUST be implemented and return `mode=blocknumber&from=<CAIP2ID>`, where `<CAIP2ID>` is a CAIP-2 Blockchain ID such as `eip155:1`.
+- If operating using **timestamp**, then this function MUST be implemented and return `mode=timestamp`.
+- If operating using any other mode, then this function MUST be implemented and return a unique identifier for the encoded `mode` field.
+
+This function is thus optional, and its absence should be considered as a marker of the contract operating using block numbers, which can be clearly idenfitied from the absence of this function. (This makes this EIP compatible with pre-existing voting contracts).
+
+Note that when operating using **block number**, the `clock()` is expected to returns the value given by the `NUMBER` opcode (`0x43`). In some cases this can be the block number of another chain (in arbitrum, opcode `0x43` returns the block number of the last recorded operation on the parent chain). A contract can use `from=default` to specify that the block number used is the one provided by the `NUMBER` opcode (`0x43`). If a more explicit description is needed, CAIP-2 blockchain id should be used, as shown in the above.
+
+The return string MUST be formatted like a URL query string (a.k.a. `application/x-www-form-urlencoded`). This allows easy decoding in standard JavaScript with `new URLSearchParams(CLOCK_MODE)`.
+
+```yaml
+- name: CLOCK_MODE
+  type: function
+  stateMutability: view
+  inputs: []
+  outputs:
+    - name: descriptor
+      type: string
 ```
 
 #### getVotes
@@ -94,7 +120,11 @@ This function MUST be implemented
 
 #### getPastVotes
 
-This function returns the historical voting weight of an account. This corresponds to all the voting power delegated to it at a specific timepoint. The timepoint parameter should match the operating mode of the contract. This function SHOULD only serve past checkpoints that are immutable. Calling this function with a timepoint that is greater or equal to `clock()` SHOULD revert. For any timepoint that is strictly smaller than `clock()`, the value returned by `getPastVotes` should be constant.
+This function returns the historical voting weight of an account. This corresponds to all the voting power delegated to it at a specific timepoint. The timepoint parameter MUST match the operating mode of the contract. This function SHOULD only serve past checkpoints, which SHOULD be immutable.
+
+- Calling this function with a timepoint that is greater or equal to `clock()` SHOULD revert.
+- Calling this function with a timepoint scrictly smaller than `clock()` SHOULD NOT revert.
+- For any integer that is strictly smaller than `clock()`, the value returned by `getPastVotes` SHOULD be constant. This means that for any call to this function that returns a value, re-executing the same call (at any time in the future) SHOULD return the same value.
 
 As tokens delegated to `address(0)` should not be counted/snapshoted, `getPastVotes(0,x)` SHOULD always return `0` (for all values of `x`).
 
@@ -375,6 +405,10 @@ Delegation allows token holders to trust a delegate with their vote while keepin
 
 The use of checkpoints prevents double voting. Votes, for example in the context of a governance proposal, should rely on a snapshot defined by a timepoint. Only tokens delegated at that timepoint can be used for voting. This means any token transfer performed after the snapshot will not affect the voting power of the sender/receiver's delegate. This also means that in order to vote, someone must acquire tokens and delegate them before the snapshot is taken. Governors can, and do, include a delay between the proposal is submitted and the snapshot is taken so that users can take the necessary actions (change their delegation, buy more tokens, ...).
 
+`clock` returns `uint48` as it is largelly sufficient for storing realistic values. In timestamp mode, `uint48` will be enough until the year 8921556. Even in block number mode, with 10,000 blocks per seconds, it would be enough until the year 2861. Using a type smaller than uint256 allows some storage packing of timepoints with other associated values. Greatly reducing the cost of writting and reading from storage. Depending on the evolution of the blockchain (particularly layer twos), `uint32` might cause issues fairly quickly. On the other hand, anything bigger than `uint48` is overkill.
+
+While timestamps produced by `clock` are represented as `uint48`, `getPastVotes`'s timepoint argument is `uint256` for backward compatibility. Any timepoint `>=2**48` passed to `getPastVotes` SHOULD cause the function to revert, as it would be a lookup in the future.
+
 `delegateBySig` is necessary to offer a gasless workflow to token holders that do not want to pay gas for voting.
 
 The `nonces` mapping is given for replay protection.

From dc305bb3078701d894acfd9d901c1da37bfb659c Mon Sep 17 00:00:00 2001
From: Hadrien Croubois <hadrien.croubois@gmail.com>
Date: Fri, 20 Jan 2023 11:14:28 +0100
Subject: [PATCH 186/274] update interface (#6361)

---
 EIPS/eip-5805.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-5805.md b/EIPS/eip-5805.md
index 233fa77c7df22d..6521b4ff3e3b85 100644
--- a/EIPS/eip-5805.md
+++ b/EIPS/eip-5805.md
@@ -375,11 +375,13 @@ This MUST be emitted when:
 ### Solidity interface
 
 ```sol
-interface IERC_XXXX {
+interface IERC5805 {
   event DelegateChanged(address indexed delegator, address indexed fromDelegate, address indexed toDelegate);
   event DelegateVotesChanged(address indexed delegate, uint256 previousBalance, uint256 newBalance);
 
-  function clock() external view returns (uint256);
+  function clock() external view returns (uint48);
+  function CLOCK_MODE() external view returns (string);
+
   function getVotes(address account) external view returns (uint256);
   function getPastVotes(address account, uint256 timepoint) external view returns (uint256);
   function delegates(address account) external view returns (address);

From db23d1d125b631c335f68e734da8e107878801a6 Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Fri, 20 Jan 2023 06:43:22 -0800
Subject: [PATCH 187/274] Update EIP-5298: Move to Review (#6343)

* Update eip-5298.md

* Update eip-5298.md

* Update eip-5298.md

* Update eip-5298.md

* Fix grammar

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-5298.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-5298.md b/EIPS/eip-5298.md
index 19a368e1aa05c1..5f885097c80ab4 100644
--- a/EIPS/eip-5298.md
+++ b/EIPS/eip-5298.md
@@ -4,7 +4,7 @@ title: ENS Trust to hold NFTs under ENS name
 description: An interface for a smart contract acting as a "trust" that holds tokens by ENS name.
 author: Zainan Victor Zhou (@xinbenlv)
 discussions-to: https://ethereum-magicians.org/t/erc-eip-5198-ens-as-token-holder/10374
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-07-12
@@ -30,13 +30,17 @@ interface IERC_ENS_TRUST is ERC721Receiver, ERC1155Receiver {
 }
 ```
 
-3. `claimTo` MUST check if `msg.sender` is the owner of the ENS node (and/or approved by the domain in implementation-specific ways). The compliant contract then MUST make a call to the `safeTransferFrom` function of [EIP-721](./eip-712.md) or [EIP-1155](./eip-1155.md).
+3. `claimTo` MUST check if `msg.sender` is the owner of the ENS node identified by `bytes32 ensNode` (and/or approved by the domain in implementation-specific ways). The compliant contract then MUST make a call to the `safeTransferFrom` function of [EIP-721](./eip-712.md) or [EIP-1155](./eip-1155.md).
+
+4. Any `ensNode` is allowed.
 
 ## Rationale
 
 1. ENS was chosen because it is a well-established scoped ownership namespace.
 This is nonetheless compatible with other scoped ownership namespaces.
 
+2. We didn't expose getters or setters for ensRoot because it is outside of the scope of this EIP.
+
 ## Backwards Compatibility
 
 No backward compatibility issues were found.

From 74689658b615c51f292dc383194ed7042e9d3f6a Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Fri, 20 Jan 2023 18:33:32 +0100
Subject: [PATCH 188/274] Add EIP-6220: Propose Composable NFTs utilizing
 Equippable Parts (#6220)

* Propose Composable NFTs utilizing Equippable Parts

Proposed an interface for Composable non-fungible tokens through fixed
and slot parts equipping.

* Assign EIP number

Assigned EIP number based on proposal PR number. This is following past
experience, but can easily be changed if requested by EIP editors.

* Add discussion URI

* Fix links to test cases

* Add a single trailing newline to the proposal

* Updated and expanded the proposal

* Slightly refined Abstract

* Additional refinements

* Fix formatting of ordered list in Rationale

* Removes configuration files and simplifies package.json.

* EIP-6220: Leaves only minimal needed packages to compile and run tests.

Co-authored-by: steven2308 <steven2308@outlook.com>
---
 EIPS/eip-6220.md                              |  477 ++++
 assets/eip-6220/contracts/Catalog.sol         |  267 ++
 assets/eip-6220/contracts/EquippableToken.sol | 2402 +++++++++++++++++
 assets/eip-6220/contracts/ICatalog.sol        |  160 ++
 assets/eip-6220/contracts/IERC5773.sol        |   92 +
 assets/eip-6220/contracts/IERC6059.sol        |  114 +
 assets/eip-6220/contracts/IEquippable.sol     |  194 ++
 .../contracts/library/EquippableLib.sol       |   29 +
 .../eip-6220/contracts/mocks/CatalogMock.sol  |   41 +
 .../eip-6220/contracts/mocks/ERC721Mock.sol   |   16 +
 .../contracts/mocks/ERC721ReceiverMock.sol    |   16 +
 .../contracts/mocks/EquippableTokenMock.sol   |  100 +
 .../contracts/mocks/NonReceiverMock.sol       |    7 +
 .../contracts/security/ReentrancyGuard.sol    |   77 +
 .../contracts/utils/EquipRenderUtils.sol      |  481 ++++
 .../contracts/utils/MultiAssetRenderUtils.sol |  194 ++
 assets/eip-6220/hardhat.config.ts             |   18 +
 assets/eip-6220/package.json                  |   29 +
 assets/eip-6220/test/catalog.ts               |  280 ++
 assets/eip-6220/test/equippableFixedParts.ts  |  588 ++++
 assets/eip-6220/test/equippableSlotParts.ts   |  923 +++++++
 assets/eip-6220/test/multiasset.ts            |  670 +++++
 assets/eip-6220/test/nestable.ts              | 1180 ++++++++
 assets/eip-6220/test/renderUtils.ts           |  129 +
 24 files changed, 8484 insertions(+)
 create mode 100644 EIPS/eip-6220.md
 create mode 100644 assets/eip-6220/contracts/Catalog.sol
 create mode 100644 assets/eip-6220/contracts/EquippableToken.sol
 create mode 100644 assets/eip-6220/contracts/ICatalog.sol
 create mode 100644 assets/eip-6220/contracts/IERC5773.sol
 create mode 100644 assets/eip-6220/contracts/IERC6059.sol
 create mode 100644 assets/eip-6220/contracts/IEquippable.sol
 create mode 100644 assets/eip-6220/contracts/library/EquippableLib.sol
 create mode 100644 assets/eip-6220/contracts/mocks/CatalogMock.sol
 create mode 100644 assets/eip-6220/contracts/mocks/ERC721Mock.sol
 create mode 100644 assets/eip-6220/contracts/mocks/ERC721ReceiverMock.sol
 create mode 100644 assets/eip-6220/contracts/mocks/EquippableTokenMock.sol
 create mode 100644 assets/eip-6220/contracts/mocks/NonReceiverMock.sol
 create mode 100644 assets/eip-6220/contracts/security/ReentrancyGuard.sol
 create mode 100644 assets/eip-6220/contracts/utils/EquipRenderUtils.sol
 create mode 100644 assets/eip-6220/contracts/utils/MultiAssetRenderUtils.sol
 create mode 100644 assets/eip-6220/hardhat.config.ts
 create mode 100644 assets/eip-6220/package.json
 create mode 100644 assets/eip-6220/test/catalog.ts
 create mode 100644 assets/eip-6220/test/equippableFixedParts.ts
 create mode 100644 assets/eip-6220/test/equippableSlotParts.ts
 create mode 100644 assets/eip-6220/test/multiasset.ts
 create mode 100644 assets/eip-6220/test/nestable.ts
 create mode 100644 assets/eip-6220/test/renderUtils.ts

diff --git a/EIPS/eip-6220.md b/EIPS/eip-6220.md
new file mode 100644
index 00000000000000..879b32ce9d327c
--- /dev/null
+++ b/EIPS/eip-6220.md
@@ -0,0 +1,477 @@
+---
+eip: 6220
+title: Composable NFTs utilizing Equippable Parts
+description: An interface for Composable non-fungible tokens through fixed and slot parts equipping.
+author: Bruno Škvorc (@Swader), Cicada (@CicadaNCR), Steven Pineda (@steven2308), Stevan Bogosavljevic (@stevyhacker), Jan Turk (@ThunderDeliverer)
+discussions-to: https://ethereum-magicians.org/t/eip-6220-composable-nfts-utilizing-equippable-parts/12289
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-12-20
+requires: 165, 721, 5773, 6059
+---
+
+## Abstract
+
+The Composable NFTs utilizing equippable parts standard extends [EIP-721](./eip-721.md) by allowing the NFTs to selectively add parts to themselves via equipping.
+
+Tokens can be composed by cherry picking the list of parts from a Catalog for each NFT instance, and are able to equip other NFTs into slots, which are also defined within the Catalog. Catalogs contain parts from which NFTs can be composed.
+
+This proposal introduces two types of parts; slot type of parts and fixed type of parts. The slot type of parts allow for other NFT collections to be equipped into them, while fixed parts are full components with their own metadata.
+
+Equipping a part into an NFT doesn't generate a new token, but rather adds another component to be rendered when retrieving the token.
+
+## Motivation
+
+With NFTs being a widespread form of tokens in the Ethereum ecosystem and being used for a variety of use cases, it is time to standardize additional utility for them. Having the ability for tokens to equip other tokens and be composed from a set of available parts allows for greater utility, usability and forward compatibility.
+
+In the four years since [EIP-721](./eip-721.md) was published, the need for additional functionality has resulted in countless extensions. This EIP improves upon EIP-721 in the following areas:
+
+- [Composing](#composing)
+- [Token progression](#token-progression)
+- [Merit tracking](#merit-tracking)
+- [Provable Digital Scarcity](#provable-digital-scarcity)
+
+### Composing
+
+NFTs can work together to create a greater construct. Prior to this proposal, multiple NFTs could be composed into a single construct either by checking all of the compatible NFTs associated with a given account and used indiscriminately (which could result in unexpected result if there was more than one NFT intended to be used in the same slot), or by keeping a custom ledger of parts to compose together (either in a smart contract or an off-chain database). This proposal establishes a standardized framework for composable NFTs, where a single NFT can select which parts should be a part of the whole, with the information being on chain. Composing NFTs in such a way allows for virtually unbounded customization of the base NFT. An example of this could be a movie NFT. Some parts, like credits, should be fixed. Other parts, like scenes, should be interchangeable, so that various releases (base version, extended cuts, anniversary editions,...) can be replaced.
+
+### Token progression
+
+As the token progresses through various stages of its existence, it can attain or be awarded various parts. This can be explained in terms of gaming. A character could be represented by an NFT utilizing this proposal and would be able to equip gear acquired through the gameplay activities and as it progresses further in the game, better items would be available. In stead of having numerous NFTs representing the items collected through its progression, equippable parts can be unlocked and the NFT owner would be able to decide which items to equip and which to keep in the inventory (not equipped) without need of a centralized party.
+
+### Merit tracking
+
+An equippable NFT can also be used to track merit. An example of this is academic merit. The equippable NFT in this case would represent a sort of digital portfolio of academic achievements, where the owner would be able to equip their diplomas, published articles and awards for all to see.
+
+### Provable Digital Scarcity
+
+The majority of current NFT projects are only mock-scarce. Even with a limited supply of tokens, the utility of these (if any) is uncapped. As an example, you can log into 500 different instances of the same game using the same wallet and the same NFT. You can then equip the same hat onto 500 different in-game avatars at the same time, because its visual representation is just a client-side mechanic. 
+
+This proposal adds the ability to enforce that, if a hat is equipped on one avatar (by being sent into it and then equipped), it cannot be equipped on another. This provides real digital scarcity.
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
+
+### Equippable tokens
+
+The interface of the core smart contract of the equippable tokens.
+
+```solidity
+/// @title EIP-X Composable NFTs utilizing Equippable Parts
+/// @dev See https://eips.ethereum.org/EIPS/eip-6220
+/// @dev Note: the ERC-165 identifier for this interface is 0x28bc9ae4.
+
+pragma solidity ^0.8.16;
+
+import "./IERC5773.sol";
+
+interface IEquippable is IERC5773 {
+    /**
+     * @notice Used to store the core structure of the `Equippable` component.
+     * @return assetId The ID of the asset equipping a child
+     * @return childAssetId The ID of the asset used as equipment
+     * @return childId The ID of token that is equipped
+     * @return childEquippableAddress Address of the collection to which the child asset belongs to
+     */
+    struct Equipment {
+        uint64 assetId;
+        uint64 childAssetId;
+        uint256 childId;
+        address childEquippableAddress;
+    }
+
+    /**
+     * @notice Used to provide a struct for inputing equip data.
+     * @dev Only used for input and not storage of data.
+     * @return tokenId ID of the token we are managing
+     * @return childIndex Index of a child in the list of token's active children
+     * @return assetId ID of the asset that we are equipping into
+     * @return slotPartId ID of the slot part that we are using to equip
+     * @return childAssetId ID of the asset that we are equipping
+     */
+    struct IntakeEquip {
+        uint256 tokenId;
+        uint256 childIndex;
+        uint64 assetId;
+        uint64 slotPartId;
+        uint64 childAssetId;
+    }
+
+    /**
+     * @notice Used to notify listeners that a child's asset has been equipped into one of its parent assets.
+     * @param tokenId ID of the token that had an asset equipped
+     * @param assetId ID of the asset associated with the token we are equipping into
+     * @param slotPartId ID of the slot we are using to equip
+     * @param childId ID of the child token we are equipping into the slot
+     * @param childAddress Address of the child token's collection
+     * @param childAssetId ID of the asset associated with the token we are equipping
+     */
+    event ChildAssetEquipped(
+        uint256 indexed tokenId,
+        uint64 indexed assetId,
+        uint64 indexed slotPartId,
+        uint256 childId,
+        address childAddress,
+        uint64 childAssetId
+    );
+
+    /**
+     * @notice Used to notify listeners that a child's asset has been unequipped from one of its parent assets.
+     * @param tokenId ID of the token that had an asset unequipped
+     * @param assetId ID of the asset associated with the token we are unequipping out of
+     * @param slotPartId ID of the slot we are unequipping from
+     * @param childId ID of the token being unequipped
+     * @param childAddress Address of the collection that a token that is being unequipped belongs to
+     * @param childAssetId ID of the asset associated with the token we are unequipping
+     */
+    event ChildAssetUnequipped(
+        uint256 indexed tokenId,
+        uint64 indexed assetId,
+        uint64 indexed slotPartId,
+        uint256 childId,
+        address childAddress,
+        uint64 childAssetId
+    );
+
+    /**
+     * @notice Used to notify listeners that the assets belonging to a `equippableGroupId` have been marked as
+     *  equippable into a given slot and parent
+     * @param equippableGroupId ID of the equippable group being marked as equippable into the slot associated with
+     *  `slotPartId` of the `parentAddress` collection
+     * @param slotPartId ID of the slot part of the catalog into which the parts belonging to the equippable group
+     *  associated with `equippableGroupId` can be equipped
+     * @param parentAddress Address of the collection into which the parts belonging to `equippableGroupId` can be
+     *  equipped
+     */
+    event ValidParentEquippableGroupIdSet(
+        uint64 indexed equippableGroupId,
+        uint64 indexed slotPartId,
+        address parentAddress
+    );
+
+    /**
+     * @notice Used to equip a child into a token.
+     * @dev The `IntakeEquip` stuct contains the following data:
+     *  [
+     *      tokenId,
+     *      childIndex,
+     *      assetId,
+     *      slotPartId,
+     *      childAssetId
+     *  ]
+     * @param data An `IntakeEquip` struct specifying the equip data
+     */
+    function equip(
+        IntakeEquip memory data
+    ) external;
+
+    /**
+     * @notice Used to unequip child from parent token.
+     * @dev This can only be called by the owner of the token or by an account that has been granted permission to
+     *  manage the given token by the current owner.
+     * @param tokenId ID of the parent from which the child is being unequipped
+     * @param assetId ID of the parent's asset that contains the `Slot` into which the child is equipped
+     * @param slotPartId ID of the `Slot` from which to unequip the child
+     */
+    function unequip(
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 slotPartId
+    ) external;
+
+    /**
+     * @notice Used to check whether the token has a given child equipped.
+     * @dev This is used to prevent from transferring a child that is equipped.
+     * @param tokenId ID of the parent token for which we are querying for
+     * @param childAddress Address of the child token's smart contract
+     * @param childId ID of the child token
+     * @return bool The boolean value indicating whether the child token is equipped into the given token or not
+     */
+    function isChildEquipped(
+        uint256 tokenId,
+        address childAddress,
+        uint256 childId
+    ) external view returns (bool);
+
+    /**
+     * @notice Used to verify whether a token can be equipped into a given parent's slot.
+     * @param parent Address of the parent token's smart contract
+     * @param tokenId ID of the token we want to equip
+     * @param assetId ID of the asset associated with the token we want to equip
+     * @param slotId ID of the slot that we want to equip the token into
+     * @return bool The boolean indicating whether the token with the given asset can be equipped into the desired
+     *  slot
+     */
+    function canTokenBeEquippedWithAssetIntoSlot(
+        address parent,
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 slotId
+    ) external view returns (bool);
+
+    /**
+     * @notice Used to get the Equipment object equipped into the specified slot of the desired token.
+     * @dev The `Equipment` struct consists of the following data:
+     *  [
+     *      assetId,
+     *      childAssetId,
+     *      childId,
+     *      childEquippableAddress
+     *  ]
+     * @param tokenId ID of the token for which we are retrieving the equipped object
+     * @param targetCatalogAddress Address of the `Catalog` associated with the `Slot` part of the token
+     * @param slotPartId ID of the `Slot` part that we are checking for equipped objects
+     * @return struct The `Equipment` struct containing data about the equipped object
+     */
+    function getEquipment(
+        uint256 tokenId,
+        address targetCatalogAddress,
+        uint64 slotPartId
+    ) external view returns (Equipment memory);
+
+    /**
+     * @notice Used to get the asset and equippable data associated with given `assetId`.
+     * @param tokenId ID of the token for which to retrieve the asset
+     * @param assetId ID of the asset of which we are retrieving
+     * @return metadataURI The metadata URI of the asset
+     * @return equippableGroupId ID of the equippable group this asset belongs to
+     * @return catalogAddress The address of the catalog the part belongs to
+     * @return partIds An array of IDs of parts included in the asset
+     */
+    function getAssetAndEquippableData(uint256 tokenId, uint64 assetId)
+        external
+        view
+        returns (
+            string memory metadataURI,
+            uint64 equippableGroupId,
+            address catalogAddress,
+            uint64[] calldata partIds
+        );
+}
+```
+
+### Catalog
+
+The interface of the Catalog containing the equippable parts. Catalogs are collections of equippable fixed and slot parts and are not restricted to a single collection, but can support any number of NFT collections.
+
+```solidity
+/**
+ * @title ICatalog
+ * @notice An interface Catalog for equippable module.
+ * @dev Note: the ERC-165 identifier for this interface is 0xd912401f.
+ */
+
+pragma solidity ^0.8.16;
+
+import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+
+interface ICatalog is IERC165 {
+    /**
+     * @notice Event to announce addition of a new part.
+     * @dev It is emitted when a new part is added.
+     * @param partId ID of the part that was added
+     * @param itemType Enum value specifying whether the part is `None`, `Slot` and `Fixed`
+     * @param zIndex An uint specifying the z value of the part. It is used to specify the depth which the part should
+     *  be rendered at
+     * @param equippableAddresses An array of addresses that can equip this part
+     * @param metadataURI The metadata URI of the part
+     */
+    event AddedPart(
+        uint64 indexed partId,
+        ItemType indexed itemType,
+        uint8 zIndex,
+        address[] equippableAddresses,
+        string metadataURI
+    );
+
+    /**
+     * @notice Event to announce new equippables to the part.
+     * @dev It is emitted when new addresses are marked as equippable for `partId`.
+     * @param partId ID of the part that had new equippable addresses added
+     * @param equippableAddresses An array of the new addresses that can equip this part
+     */
+    event AddedEquippables(
+        uint64 indexed partId,
+        address[] equippableAddresses
+    );
+
+    /**
+     * @notice Event to announce the overriding of equippable addresses of the part.
+     * @dev It is emitted when the existing list of addresses marked as equippable for `partId` is overwritten by a new
+     *  one.
+     * @param partId ID of the part whose list of equippable addresses was overwritten
+     * @param equippableAddresses The new, full, list of addresses that can equip this part
+     */
+    event SetEquippables(uint64 indexed partId, address[] equippableAddresses);
+
+    /**
+     * @notice Event to announce that a given part can be equipped by any address.
+     * @dev It is emitted when a given part is marked as equippable by any.
+     * @param partId ID of the part marked as equippable by any address
+     */
+    event SetEquippableToAll(uint64 indexed partId);
+
+    /**
+     * @notice Used to define a type of the item. Possible values are `None`, `Slot` or `Fixed`.
+     * @dev Used for fixed and slot parts.
+     */
+    enum ItemType {
+        None,
+        Slot,
+        Fixed
+    }
+
+    /**
+     * @notice The integral structure of a standard RMRK catalog item defining it.
+     * @dev Requires a minimum of 3 storage slots per catalog item, equivalent to roughly 60,000 gas as of Berlin hard fork
+     *  (April 14, 2021), though 5-7 storage slots is more realistic, given the standard length of an IPFS URI. This
+     *  will result in between 25,000,000 and 35,000,000 gas per 250 assets--the maximum block size of Ethereum
+     *  mainnet is 30M at peak usage.
+     * @return itemType The item type of the part
+     * @return z The z value of the part defining how it should be rendered when presenting the full NFT
+     * @return equippable The array of addresses allowed to be equipped in this part
+     * @return metadataURI The metadata URI of the part
+     */
+    struct Part {
+        ItemType itemType; //1 byte
+        uint8 z; //1 byte
+        address[] equippable; //n Collections that can be equipped into this slot
+        string metadataURI; //n bytes 32+
+    }
+
+    /**
+     * @notice The structure used to add a new `Part`.
+     * @dev The part is added with specified ID, so you have to make sure that you are using an unused `partId`,
+     *  otherwise the addition of the part vill be reverted.
+     * @dev The full `IntakeStruct` looks like this:
+     *  [
+     *          partID,
+     *      [
+     *          itemType,
+     *          z,
+     *          [
+     *               permittedCollectionAddress0,
+     *               permittedCollectionAddress1,
+     *               permittedCollectionAddress2
+     *           ],
+     *           metadataURI
+     *       ]
+     *   ]
+     * @return partId ID to be assigned to the `Part`
+     * @return part A `Part` to be added
+     */
+    struct IntakeStruct {
+        uint64 partId;
+        Part part;
+    }
+
+    /**
+     * @notice Used to return the metadata URI of the associated catalog.
+     * @return string Base metadata URI
+     */
+    function getMetadataURI() external view returns (string memory);
+
+    /**
+     * @notice Used to return the `itemType` of the associated catalog
+     * @return string `itemType` of the associated catalog
+     */
+    function getType() external view returns (string memory);
+
+    /**
+     * @notice Used to check whether the given address is allowed to equip the desired `Part`.
+     * @dev Returns true if a collection may equip asset with `partId`.
+     * @param partId The ID of the part that we are checking
+     * @param targetAddress The address that we are checking for whether the part can be equipped into it or not
+     * @return bool The status indicating whether the `targetAddress` can be equipped into `Part` with `partId` or not
+     */
+    function checkIsEquippable(uint64 partId, address targetAddress)
+        external
+        view
+        returns (bool);
+
+    /**
+     * @notice Used to check if the part is equippable by all addresses.
+     * @dev Returns true if part is equippable to all.
+     * @param partId ID of the part that we are checking
+     * @return bool The status indicating whether the part with `partId` can be equipped by any address or not
+     */
+    function checkIsEquippableToAll(uint64 partId) external view returns (bool);
+
+    /**
+     * @notice Used to retrieve a `Part` with id `partId`
+     * @param partId ID of the part that we are retrieving
+     * @return struct The `Part` struct associated with given `partId`
+     */
+    function getPart(uint64 partId) external view returns (Part memory);
+
+    /**
+     * @notice Used to retrieve multiple parts at the same time.
+     * @param partIds An array of part IDs that we want to retrieve
+     * @return struct An array of `Part` structs associated with given `partIds`
+     */
+    function getParts(uint64[] calldata partIds)
+        external
+        view
+        returns (Part[] memory);
+}
+```
+
+## Rationale
+
+Designing the proposal, we considered the following questions:
+
+1. **Why are we using a Catalog in stead of supporting direct NFT equipping?**\
+If NFTs could be directly equipped into other NFTs without any oversight, the resulting composite would be unpredictable. Catalog allows for parts to be pre-verified in order to result in a composite that composes as expected. Another benefit of Catalog is the ability of defining reusable fixed parts.
+2. **Why do we propose two types of parts?**\
+Some parts, that are the same for all of the tokens, don't make sense to be represented by individual NFTs, so they can be represented by fixed parts. This reduces the clutter of the owner's wallet as well as introduces an efficient way of disseminating repetitive assets tied to NFTs.\
+The slot parts allow for equipping NFTs into them. This provides the ability to equip unrelated NFT collections into the base NFT after the unrelated collection has been verified to compose properly.\
+Having two parts allows for support of numerous use cases and, since the proposal doesn't enforce the use of both it can be applied in any configuration needed.
+3. **Why is a method to get all of the equipped parts not included?**\
+Getting all parts might not be an operation necessary for all implementers. Additionally, it can be added either as an extension, doable with hooks, or can be emulated using an indexer.
+4. **Should Catalog be limited to support one NFT collection at a time or be able to support any nunmber of collections?**\
+As the Catalog is designed in a way that is agnostic to the use case using it. It makes sense to support as wide reusability as possible. Having one Catalog supporting multiple collections allows for optimized operation and reduced gas prices when deploying it and setting fixed as well as slot parts.
+
+### Fixed parts
+
+Fixed parts are defined and contained in the Catalog. They have their own metadata and are not meant to change through the lifecycle of the NFT. 
+
+A fixed part cannot be replaced.
+
+The benefit of fixed parts is that they represent equippable parts that can be equipped by any number of tokens in any number of collections and only need to be defined once.
+
+### Slot parts
+
+Slot parts are defined and contained in the Catalog. They don't have their own metadata, but rather support equipping of selected NFT collections into them. The tokens equipped into the slots however, contain their own metadata. This allows for an equippable modifialbe content of the base NFT controlled by its owner. As they can be equipped into any number of tokens of any number of collections, they allow for reliable composing of the final tokens by vetting which NFTs can be equipped by a given slot once and then reused any number of times.
+
+## Backwards Compatibility
+
+The Equippable token standard has been made compatible with [EIP-721](./eip-721.md) in order to take advantage of the robust tooling available for implementations of EIP-721 and to ensure compatibility with existing EIP-721 infrastructure.
+
+## Test Cases
+
+Tests are included in [`equippableFixedParts.ts`](../assets/eip-6220/test/equippableFixedParts.ts) and [`equippableSlotParts.ts`](../assets/eip-6220/test/equippableSlotParts.ts).
+
+To run them in terminal, you can use the following commands:
+
+```
+cd ../assets/eip-6220
+npm install
+npx hardhat test
+```
+
+## Reference Implementation
+
+See [`EquippableToken.sol`](../assets/eip-6220/contracts/EquippableToken.sol).
+
+
+## Security Considerations
+
+The same security considerations as with [EIP-721](./eip-721.md) apply: hidden logic may be present in any of the functions, including burn, add resource, accept resource, and more.
+
+Caution is advised when dealing with non-audited contracts.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-6220/contracts/Catalog.sol b/assets/eip-6220/contracts/Catalog.sol
new file mode 100644
index 00000000000000..45d522ef8ba4fb
--- /dev/null
+++ b/assets/eip-6220/contracts/Catalog.sol
@@ -0,0 +1,267 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "./ICatalog.sol";
+import "@openzeppelin/contracts/utils/Address.sol";
+
+error BadConfig();
+error IdZeroForbidden();
+error PartAlreadyExists();
+error PartDoesNotExist();
+error PartIsNotSlot();
+error ZeroLengthIdsPassed();
+
+/**
+ * @title Catalog
+ * @author RMRK team
+ * @notice Catalog contract for RMRK equippable module.
+ */
+contract Catalog is ICatalog {
+    using Address for address;
+
+    /**
+     * @notice Mapping of uint64 `partId` to Catalog `Part` struct
+     */
+    mapping(uint64 => Part) private _parts;
+
+    /**
+     * @notice Mapping of uint64 `partId` to boolean flag, indicating that a given `Part` can be equippable by any address
+     */
+    mapping(uint64 => bool) private _isEquippableToAll;
+
+    uint64[] private _partIds;
+
+    string private _metadataURI;
+    string private _type;
+
+    /**
+     * @notice Used to initialize the catalog.
+     * @param metadataURI Base metadata URI of the catalog
+     * @param type_ Type of catalog
+     */
+    constructor(string memory metadataURI, string memory type_) {
+        _metadataURI = metadataURI;
+        _type = type_;
+    }
+
+    /**
+     * @notice Used to limit execution of functions intended for the `Slot` parts to only execute when used with such
+     *  parts.
+     * @dev Reverts execution of a function if the part with associated `partId` is uninitailized or is `Fixed`.
+     * @param partId ID of the part that we want the function to interact with
+     */
+    modifier onlySlot(uint64 partId) {
+        _onlySlot(partId);
+        _;
+    }
+
+    function _onlySlot(uint64 partId) private view {
+        ItemType itemType = _parts[partId].itemType;
+        if (itemType == ItemType.None) revert PartDoesNotExist();
+        if (itemType == ItemType.Fixed) revert PartIsNotSlot();
+    }
+
+    /**
+     * @inheritdoc IERC165
+     */
+    function supportsInterface(bytes4 interfaceId)
+        public
+        view
+        virtual
+        returns (bool)
+    {
+        return
+            interfaceId == type(IERC165).interfaceId ||
+            interfaceId == type(ICatalog).interfaceId;
+    }
+
+    /**
+     * @inheritdoc ICatalog
+     */
+    function getMetadataURI() external view returns (string memory) {
+        return _metadataURI;
+    }
+
+    /**
+     * @inheritdoc ICatalog
+     */
+    function getType() external view returns (string memory) {
+        return _type;
+    }
+
+    /**
+     * @notice Internal helper function that adds `Part` entries to storage.
+     * @dev Delegates to { _addPart } below.
+     * @param partIntake An array of `IntakeStruct` structs, consisting of `partId` and a nested `Part` struct
+     */
+    function _addPartList(IntakeStruct[] calldata partIntake) internal {
+        uint256 len = partIntake.length;
+        for (uint256 i; i < len; ) {
+            _addPart(partIntake[i]);
+            unchecked {
+                ++i;
+            }
+        }
+    }
+
+    /**
+     * @notice Internal function that adds a single `Part` to storage.
+     * @param partIntake `IntakeStruct` struct consisting of `partId` and a nested `Part` struct
+     *
+     */
+    function _addPart(IntakeStruct calldata partIntake) internal {
+        uint64 partId = partIntake.partId;
+        Part memory part = partIntake.part;
+
+        if (partId == uint64(0)) revert IdZeroForbidden();
+        if (_parts[partId].itemType != ItemType.None)
+            revert PartAlreadyExists();
+        if (part.itemType == ItemType.None) revert BadConfig();
+        if (part.itemType == ItemType.Fixed && part.equippable.length != 0)
+            revert BadConfig();
+
+        _parts[partId] = part;
+        _partIds.push(partId);
+
+        emit AddedPart(
+            partId,
+            part.itemType,
+            part.z,
+            part.equippable,
+            part.metadataURI
+        );
+    }
+
+    /**
+     * @notice Internal function used to add multiple `equippableAddresses` to a single catalog entry.
+     * @dev Can only be called on `Part`s of `Slot` type.
+     * @param partId ID of the `Part` that we are adding the equippable addresses to
+     * @param equippableAddresses An array of addresses that can be equipped into the `Part` associated with the `partId`
+     */
+    function _addEquippableAddresses(
+        uint64 partId,
+        address[] calldata equippableAddresses
+    ) internal onlySlot(partId) {
+        if (equippableAddresses.length <= 0) revert ZeroLengthIdsPassed();
+
+        uint256 len = equippableAddresses.length;
+        for (uint256 i; i < len; ) {
+            _parts[partId].equippable.push(equippableAddresses[i]);
+            unchecked {
+                ++i;
+            }
+        }
+        delete _isEquippableToAll[partId];
+
+        emit AddedEquippables(partId, equippableAddresses);
+    }
+
+    /**
+     * @notice Internal function used to set the new list of `equippableAddresses`.
+     * @dev Overwrites existing `equippableAddresses`.
+     * @dev Can only be called on `Part`s of `Slot` type.
+     * @param partId ID of the `Part`s that we are overwiting the `equippableAddresses` for
+     * @param equippableAddresses A full array of addresses that can be equipped into this `Part`
+     */
+    function _setEquippableAddresses(
+        uint64 partId,
+        address[] calldata equippableAddresses
+    ) internal onlySlot(partId) {
+        if (equippableAddresses.length <= 0) revert ZeroLengthIdsPassed();
+        _parts[partId].equippable = equippableAddresses;
+        delete _isEquippableToAll[partId];
+
+        emit SetEquippables(partId, equippableAddresses);
+    }
+
+    /**
+     * @notice Internal function used to remove all of the `equippableAddresses` for a `Part` associated with the `partId`.
+     * @dev Can only be called on `Part`s of `Slot` type.
+     * @param partId ID of the part that we are clearing the `equippableAddresses` from
+     */
+    function _resetEquippableAddresses(uint64 partId)
+        internal
+        onlySlot(partId)
+    {
+        delete _parts[partId].equippable;
+        delete _isEquippableToAll[partId];
+
+        emit SetEquippables(partId, new address[](0));
+    }
+
+    /**
+     * @notice Sets the isEquippableToAll flag to true, meaning that any collection may be equipped into the `Part` with this
+     *  `partId`.
+     * @dev Can only be called on `Part`s of `Slot` type.
+     * @param partId ID of the `Part` that we are setting as equippable by any address
+     */
+    function _setEquippableToAll(uint64 partId) internal onlySlot(partId) {
+        _isEquippableToAll[partId] = true;
+        emit SetEquippableToAll(partId);
+    }
+
+    /**
+     * @inheritdoc ICatalog
+     */
+    function checkIsEquippableToAll(uint64 partId) public view returns (bool) {
+        return _isEquippableToAll[partId];
+    }
+
+    /**
+     * @inheritdoc ICatalog
+     */
+    function checkIsEquippable(uint64 partId, address targetAddress)
+        public
+        view
+        returns (bool)
+    {
+        // If this is equippable to all, we're good
+        bool isEquippable = _isEquippableToAll[partId];
+
+        // Otherwise, must check against each of the equippable for the part
+        if (!isEquippable && _parts[partId].itemType == ItemType.Slot) {
+            address[] memory equippable = _parts[partId].equippable;
+            uint256 len = equippable.length;
+            for (uint256 i; i < len; ) {
+                if (targetAddress == equippable[i]) {
+                    isEquippable = true;
+                    break;
+                }
+                unchecked {
+                    ++i;
+                }
+            }
+        }
+        return isEquippable;
+    }
+
+    /**
+     * @inheritdoc ICatalog
+     */
+    function getPart(uint64 partId) public view returns (Part memory) {
+        return (_parts[partId]);
+    }
+
+    /**
+     * @inheritdoc ICatalog
+     */
+    function getParts(uint64[] calldata partIds)
+        public
+        view
+        returns (Part[] memory)
+    {
+        uint256 numParts = partIds.length;
+        Part[] memory parts = new Part[](numParts);
+
+        for (uint256 i; i < numParts; ) {
+            uint64 partId = partIds[i];
+            parts[i] = _parts[partId];
+            unchecked {
+                ++i;
+            }
+        }
+
+        return parts;
+    }
+}
diff --git a/assets/eip-6220/contracts/EquippableToken.sol b/assets/eip-6220/contracts/EquippableToken.sol
new file mode 100644
index 00000000000000..ea60fbca457d05
--- /dev/null
+++ b/assets/eip-6220/contracts/EquippableToken.sol
@@ -0,0 +1,2402 @@
+// SPDX-License-Identifier: CC0-1.0
+
+//Generally all interactions should propagate downstream
+
+pragma solidity ^0.8.16;
+
+import "./ICatalog.sol";
+import "./IEquippable.sol";
+import "./IERC6059.sol";
+import "./library/EquippableLib.sol";
+import "./security/ReentrancyGuard.sol";
+import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
+import "@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol";
+import "@openzeppelin/contracts/utils/Address.sol";
+import "@openzeppelin/contracts/utils/Context.sol";
+import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+
+error ApprovalForAssetsToCurrentOwner();
+error ApproveForAssetsCallerIsNotOwnerNorApprovedForAll();
+error AssetAlreadyExists();
+error BadPriorityListLength();
+error CatalogRequiredForParts();
+error ChildAlreadyExists();
+error ChildIndexOutOfRange();
+error EquippableEquipNotAllowedByCatalog();
+error ERC721AddressZeroIsNotaValidOwner();
+error ERC721ApprovalToCurrentOwner();
+error ERC721ApproveCallerIsNotOwnerNorApprovedForAll();
+error ERC721ApproveToCaller();
+error ERC721InvalidTokenId();
+error ERC721MintToTheZeroAddress();
+error ERC721NotApprovedOrOwner();
+error ERC721TokenAlreadyMinted();
+error ERC721TransferFromIncorrectOwner();
+error ERC721TransferToNonReceiverImplementer();
+error ERC721TransferToTheZeroAddress();
+error IdZeroForbidden();
+error IndexOutOfRange();
+error IsNotContract();
+error MaxPendingAssetsReached();
+error MaxPendingChildrenReached();
+error MaxRecursiveBurnsReached(address childContract, uint256 childId);
+error MintToNonNestableImplementer();
+error MustUnequipFirst();
+error NestableTooDeep();
+error NestableTransferToDescendant();
+error NestableTransferToNonNestableImplementer();
+error NestableTransferToSelf();
+error NoAssetMatchingId();
+error NotApprovedForAssetsOrOwner();
+error NotApprovedOrDirectOwner();
+error NotEquipped();
+error PendingChildIndexOutOfRange();
+error SlotAlreadyUsed();
+error TargetAssetCannotReceiveSlot();
+error TokenCannotBeEquippedWithAssetIntoSlot();
+error TokenDoesNotHaveAsset();
+error UnexpectedAssetId();
+error UnexpectedChildId();
+error UnexpectedNumberOfAssets();
+error UnexpectedNumberOfChildren();
+
+/**
+ * @title EquippableToken
+ * @author RMRK team
+ * @notice Smart contract of the Equippable module.
+ */
+contract EquippableToken is
+    Context,
+    ReentrancyGuard,
+    IERC165,
+    IERC721,
+    IERC6059,
+    IEquippable
+{
+    using Address for address;
+    using EquippableLib for uint64[];
+
+    // ----------------- ERC721 -------------
+
+    // Mapping owner address to token count
+    mapping(address => uint256) private _balances;
+
+    // Mapping from token ID to approver address to approved address
+    // The approver is necessary so approvals are invalidated for nested children on transfer
+    // WARNING: If a child NFT returns to a previous root owner, old permissions would be active again
+    mapping(uint256 => mapping(address => address)) private _tokenApprovals;
+
+    // Mapping from owner to operator approvals
+    mapping(address => mapping(address => bool)) private _operatorApprovals;
+
+    // ----------------- MULTIASSETS -------------
+
+    /// Mapping of uint64 Ids to asset metadata
+    mapping(uint64 => string) private _assets;
+
+    /// Mapping of tokenId to new asset, to asset to be replaced
+    mapping(uint256 => mapping(uint64 => uint64)) private _assetReplacements;
+
+    /// Mapping of tokenId to an array of active assets
+    /// @dev Active recurses is unbounded, getting all would reach gas limit at around 30k items
+    /// so we leave this as internal in case a custom implementation needs to implement pagination
+    mapping(uint256 => uint64[]) internal _activeAssets;
+
+    /// Mapping of tokenId to an array of pending assets
+    mapping(uint256 => uint64[]) internal _pendingAssets;
+
+    /// Mapping of tokenId to an array of priorities for active assets
+    mapping(uint256 => uint16[]) internal _activeAssetPriorities;
+
+    /// Mapping of tokenId to assetId to whether the token has this asset assigned
+    mapping(uint256 => mapping(uint64 => bool)) private _tokenAssets;
+
+    /// Mapping from owner to operator approvals for assets
+    mapping(address => mapping(address => bool))
+        private _operatorApprovalsForAssets;
+
+    /**
+     * @notice Mapping from token ID to approver address to approved address for assets.
+     * @dev The approver is necessary so approvals are invalidated for nested children on transfer.
+     * @dev WARNING: If a child NFT returns the original root owner, old permissions would be active again.
+     */
+    mapping(uint256 => mapping(address => address))
+        private _tokenApprovalsForAssets;
+
+    // ------------------- NESTABLE --------------
+
+    uint256 private constant _MAX_LEVELS_TO_CHECK_FOR_INHERITANCE_LOOP = 100;
+
+    // Mapping from token ID to DirectOwner struct
+    mapping(uint256 => DirectOwner) private _directOwners;
+
+    // Mapping of tokenId to array of active children structs
+    mapping(uint256 => Child[]) private _activeChildren;
+
+    // Mapping of tokenId to array of pending children structs
+    mapping(uint256 => Child[]) private _pendingChildren;
+
+    // Mapping of child token address to child token ID to whether they are pending or active on any token
+    // We might have a first extra mapping from token ID, but since the same child cannot be nested into multiple tokens
+    //  we can strip it for size/gas savings.
+    mapping(address => mapping(uint256 => uint256)) private _childIsInActive;
+
+    // ------------------- EQUIPPABLE --------------
+
+    /// Mapping of uint64 asset ID to corresponding catalog address.
+    mapping(uint64 => address) private _catalogAddresses;
+    /// Mapping of uint64 ID to asset object.
+    mapping(uint64 => uint64) private _equippableGroupIds;
+    /// Mapping of assetId to catalog parts applicable to this asset, both fixed and slot
+    mapping(uint64 => uint64[]) private _partIds;
+
+    /// Mapping of token ID to catalog address to slot part ID to equipment information. Used to compose an NFT.
+    mapping(uint256 => mapping(address => mapping(uint64 => Equipment)))
+        private _equipments;
+
+    /// Mapping of token ID to child (nestable) address to child ID to count of equipped items. Used to check if equipped.
+    mapping(uint256 => mapping(address => mapping(uint256 => uint8)))
+        private _equipCountPerChild;
+
+    /// Mapping of `equippableGroupId` to parent contract address and valid `slotId`.
+    mapping(uint64 => mapping(address => uint64)) private _validParentSlots;
+
+    // -------------------------- MODIFIERS ----------------------------
+
+    /**
+     * @notice Used to verify that the caller is either the owner of the token or approved to manage it by its owner.
+     * @param tokenId ID of the token to check
+     */
+    modifier onlyApprovedOrOwner(uint256 tokenId) {
+        _onlyApprovedOrOwner(tokenId);
+        _;
+    }
+
+    /**
+     * @notice Used to verify that the caller is approved to manage the given token or is its direct owner.
+     * @param tokenId ID of the token to check
+     */
+    modifier onlyApprovedOrDirectOwner(uint256 tokenId) {
+        _onlyApprovedOrDirectOwner(tokenId);
+        _;
+    }
+
+    /**
+     * @notice Used to ensure that the caller is either the owner of the given token or approved to manage the token's assets
+     *  of the owner.
+     * @dev If that is not the case, the execution of the function will be reverted.
+     * @param tokenId ID of the token that we are checking
+     */
+    modifier onlyApprovedForAssetsOrOwner(uint256 tokenId) {
+        _onlyApprovedForAssetsOrOwner(tokenId);
+        _;
+    }
+
+    // --------------------- ERC721 GETTERS ---------------------
+
+    /**
+     * @notice Used to retrieve the root owner of the given token.
+     * @dev Root owner is always the externally owned account.
+     * @dev If the given token is owned by another token, it will recursively query the parent tokens until reaching the
+     *  root owner.
+     * @param tokenId ID of the token for which the root owner is being retrieved
+     * @return address Address of the root owner of the given token
+     */
+    function ownerOf(
+        uint256 tokenId
+    ) public view virtual override(IERC6059, IERC721) returns (address) {
+        (address owner, uint256 ownerTokenId, bool isNft) = directOwnerOf(
+            tokenId
+        );
+        if (isNft) {
+            owner = IERC6059(owner).ownerOf(ownerTokenId);
+        }
+        return owner;
+    }
+
+    /**
+     * @inheritdoc IERC165
+     */
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual returns (bool) {
+        return
+            interfaceId == type(IERC165).interfaceId ||
+            interfaceId == type(IERC721).interfaceId ||
+            interfaceId == type(IERC5773).interfaceId ||
+            interfaceId == type(IERC6059).interfaceId ||
+            interfaceId == type(IEquippable).interfaceId;
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function balanceOf(address owner) public view virtual returns (uint256) {
+        if (owner == address(0)) revert ERC721AddressZeroIsNotaValidOwner();
+        return _balances[owner];
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function getApproved(
+        uint256 tokenId
+    ) public view virtual returns (address) {
+        _requireMinted(tokenId);
+
+        return _tokenApprovals[tokenId][ownerOf(tokenId)];
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function isApprovedForAll(
+        address owner,
+        address operator
+    ) public view virtual returns (bool) {
+        return _operatorApprovals[owner][operator];
+    }
+
+    // --------------------- ERC721 SETTERS ---------------------
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function approve(address to, uint256 tokenId) public virtual {
+        address owner = ownerOf(tokenId);
+        if (to == owner) revert ERC721ApprovalToCurrentOwner();
+
+        if (_msgSender() != owner && !isApprovedForAll(owner, _msgSender()))
+            revert ERC721ApproveCallerIsNotOwnerNorApprovedForAll();
+
+        _approve(to, tokenId);
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function setApprovalForAll(address operator, bool approved) public virtual {
+        if (_msgSender() == operator) revert ERC721ApproveToCaller();
+        _operatorApprovals[_msgSender()][operator] = approved;
+        emit ApprovalForAll(_msgSender(), operator, approved);
+    }
+
+    /**
+     * @notice Used to burn a given token.
+     * @param tokenId ID of the token to burn
+     */
+    function burn(uint256 tokenId) public virtual {
+        burn(tokenId, 0);
+    }
+
+    /**
+     * @notice Used to burn a token.
+     * @dev When a token is burned, its children are recursively burned as well.
+     * @dev The approvals are cleared when the token is burned.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist.
+     * @dev Emits a {Transfer} event.
+     * @param tokenId ID of the token to burn
+     * @param maxChildrenBurns Maximum children to recursively burn
+     * @return uint256 The number of recursive burns it took to burn all of the children
+     */
+    function burn(
+        uint256 tokenId,
+        uint256 maxChildrenBurns
+    ) public virtual onlyApprovedOrDirectOwner(tokenId) returns (uint256) {
+        return _burn(tokenId, maxChildrenBurns);
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function transferFrom(
+        address from,
+        address to,
+        uint256 tokenId
+    ) public virtual onlyApprovedOrDirectOwner(tokenId) {
+        _transfer(from, to, tokenId);
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function safeTransferFrom(
+        address from,
+        address to,
+        uint256 tokenId
+    ) public virtual {
+        safeTransferFrom(from, to, tokenId, "");
+    }
+
+    /**
+     * @inheritdoc IERC721
+     */
+    function safeTransferFrom(
+        address from,
+        address to,
+        uint256 tokenId,
+        bytes memory data
+    ) public virtual onlyApprovedOrDirectOwner(tokenId) {
+        _safeTransfer(from, to, tokenId, data);
+    }
+
+    // --------------------- ERC721 INTERNAL ---------------------
+
+    /**
+     * @notice Used to grant an approval to manage a given token.
+     * @dev Emits an {Approval} event.
+     * @param to Address to which the approval is being granted
+     * @param tokenId ID of the token for which the approval is being granted
+     */
+    function _approve(address to, uint256 tokenId) internal virtual {
+        address owner = ownerOf(tokenId);
+        _tokenApprovals[tokenId][owner] = to;
+        emit Approval(owner, to, tokenId);
+    }
+
+    /**
+     * @notice Used to update the owner of the token and clear the approvals associated with the previous owner.
+     * @dev The `destinationId` should equal `0` if the new owner is an externally owned account.
+     * @param tokenId ID of the token being updated
+     * @param destinationId ID of the token to receive the given token
+     * @param to Address of account to receive the token
+     * @param isNft A boolean value signifying whether the new owner is a token (`true`) or externally owned account
+     *  (`false`)
+     */
+    function _updateOwnerAndClearApprovals(
+        uint256 tokenId,
+        uint256 destinationId,
+        address to,
+        bool isNft
+    ) internal {
+        _directOwners[tokenId] = DirectOwner({
+            ownerAddress: to,
+            tokenId: destinationId,
+            isNft: isNft
+        });
+
+        // Clear approvals from the previous owner
+        _approve(address(0), tokenId);
+        _approveForAssets(address(0), tokenId);
+    }
+
+    /**
+     * @notice Used to enforce that the given token has been minted.
+     * @dev Reverts if the `tokenId` has not been minted yet.
+     * @dev The validation checks whether the owner of a given token is a `0x0` address and considers it not minted if
+     *  it is. This means that both tokens that haven't been minted yet as well as the ones that have already been
+     *  burned will cause the transaction to be reverted.
+     * @param tokenId ID of the token to check
+     */
+    function _requireMinted(uint256 tokenId) internal view virtual {
+        if (!_exists(tokenId)) revert ERC721InvalidTokenId();
+    }
+
+    /**
+     * @notice Used to check whether the given token exists.
+     * @dev Tokens start existing when they are minted (`_mint`) and stop existing when they are burned (`_burn`).
+     * @param tokenId ID of the token being checked
+     * @return bool The boolean value signifying whether the token exists
+     */
+    function _exists(uint256 tokenId) internal view virtual returns (bool) {
+        return _directOwners[tokenId].ownerAddress != address(0);
+    }
+
+    /**
+     * @notice Used to invoke {IERC721Receiver-onERC721Received} on a target address.
+     * @dev The call is not executed if the target address is not a contract.
+     * @param from Address representing the previous owner of the given token
+     * @param to Yarget address that will receive the tokens
+     * @param tokenId ID of the token to be transferred
+     * @param data Optional data to send along with the call
+     * @return bool Boolean value signifying whether the call correctly returned the expected magic value
+     */
+    function _checkOnERC721Received(
+        address from,
+        address to,
+        uint256 tokenId,
+        bytes memory data
+    ) private returns (bool) {
+        if (to.isContract()) {
+            try
+                IERC721Receiver(to).onERC721Received(
+                    _msgSender(),
+                    from,
+                    tokenId,
+                    data
+                )
+            returns (bytes4 retval) {
+                return retval == IERC721Receiver.onERC721Received.selector;
+            } catch (bytes memory reason) {
+                if (reason.length == 0) {
+                    revert ERC721TransferToNonReceiverImplementer();
+                } else {
+                    /// @solidity memory-safe-assembly
+                    assembly {
+                        revert(add(32, reason), mload(reason))
+                    }
+                }
+            }
+        } else {
+            return true;
+        }
+    }
+
+    /**
+     * @notice Used to safely mint a token to a specified address.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must not exist.
+     *  - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
+     * @dev Emits a {Transfer} event.
+     * @param to Address to which to safely mint the gven token
+     * @param tokenId ID of the token to mint to the specified address
+     */
+    function _safeMint(address to, uint256 tokenId) internal virtual {
+        _safeMint(to, tokenId, "");
+    }
+
+    /**
+     * @notice Used to safely mint the token to the specified address while passing the additional data to contract
+     *  recipients.
+     * @param to Address to which to mint the token
+     * @param tokenId ID of the token to mint
+     * @param data Additional data to send with the tokens
+     */
+    function _safeMint(
+        address to,
+        uint256 tokenId,
+        bytes memory data
+    ) internal virtual {
+        _mint(to, tokenId);
+        if (!_checkOnERC721Received(address(0), to, tokenId, data))
+            revert ERC721TransferToNonReceiverImplementer();
+    }
+
+    /**
+     * @notice Used to mint a specified token to a given address.
+     * @dev WARNING: Usage of this method is discouraged, use {_safeMint} whenever possible.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must not exist.
+     *  - `to` cannot be the zero address.
+     * @dev Emits a {Transfer} event.
+     * @param to Address to mint the token to
+     * @param tokenId ID of the token to mint
+     */
+    function _mint(address to, uint256 tokenId) internal virtual {
+        _innerMint(to, tokenId, 0);
+
+        emit Transfer(address(0), to, tokenId);
+        emit NestTransfer(address(0), to, 0, 0, tokenId);
+
+        _afterTokenTransfer(address(0), to, tokenId);
+        _afterNestedTokenTransfer(address(0), to, 0, 0, tokenId);
+    }
+
+    /**
+     * @notice Used to mint a child token to a given parent token.
+     * @param to Address of the collection smart contract of the token into which to mint the child token
+     * @param tokenId ID of the token to mint
+     * @param destinationId ID of the token into which to mint the new child token
+     * @param data Additional data with no specified format, sent in the addChild call
+     */
+    function _nestMint(
+        address to,
+        uint256 tokenId,
+        uint256 destinationId,
+        bytes memory data
+    ) internal virtual {
+        // It seems redundant, but otherwise it would revert with no error
+        if (!to.isContract()) revert IsNotContract();
+        if (!IERC165(to).supportsInterface(type(IERC6059).interfaceId))
+            revert MintToNonNestableImplementer();
+
+        _innerMint(to, tokenId, destinationId);
+        _sendToNFT(address(0), to, 0, destinationId, tokenId, data);
+    }
+
+    /**
+     * @notice Used to mint a child token into a given parent token.
+     * @dev Requirements:
+     *
+     *  - `to` cannot be the zero address.
+     *  - `tokenId` must not exist.
+     *  - `tokenId` must not be `0`.
+     * @param to Address of the collection smart contract of the token into which to mint the child token
+     * @param tokenId ID of the token to mint
+     * @param destinationId ID of the token into which to mint the new token
+     */
+    function _innerMint(
+        address to,
+        uint256 tokenId,
+        uint256 destinationId
+    ) private {
+        if (to == address(0)) revert ERC721MintToTheZeroAddress();
+        if (_exists(tokenId)) revert ERC721TokenAlreadyMinted();
+        if (tokenId == 0) revert IdZeroForbidden();
+
+        _beforeTokenTransfer(address(0), to, tokenId);
+        _beforeNestedTokenTransfer(address(0), to, 0, destinationId, tokenId);
+
+        _balances[to] += 1;
+        _directOwners[tokenId] = DirectOwner({
+            ownerAddress: to,
+            tokenId: destinationId,
+            isNft: destinationId != 0
+        });
+    }
+
+    /**
+     * @notice Used to burn a token.
+     * @dev When a token is burned, its children are recursively burned as well.
+     * @dev The approvals are cleared when the token is burned.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist.
+     * @dev Emits a {Transfer} event.
+     * @dev Emits a {NestTransfer} event.
+     * @param tokenId ID of the token to burn
+     * @param maxChildrenBurns Maximum children to recursively burn
+     * @return uint256 The number of recursive burns it took to burn all of the children
+     */
+    function _burn(
+        uint256 tokenId,
+        uint256 maxChildrenBurns
+    ) internal virtual returns (uint256) {
+        (address immediateOwner, uint256 parentId, ) = directOwnerOf(tokenId);
+        address owner = ownerOf(tokenId);
+        _balances[immediateOwner] -= 1;
+
+        _beforeTokenTransfer(owner, address(0), tokenId);
+        _beforeNestedTokenTransfer(
+            immediateOwner,
+            address(0),
+            parentId,
+            0,
+            tokenId
+        );
+
+        _approve(address(0), tokenId);
+        _approveForAssets(address(0), tokenId);
+
+        Child[] memory children = childrenOf(tokenId);
+
+        delete _activeChildren[tokenId];
+        delete _pendingChildren[tokenId];
+        delete _tokenApprovals[tokenId][owner];
+
+        uint256 pendingRecursiveBurns;
+        uint256 totalChildBurns;
+
+        uint256 length = children.length; //gas savings
+        for (uint256 i; i < length; ) {
+            if (totalChildBurns >= maxChildrenBurns)
+                revert MaxRecursiveBurnsReached(
+                    children[i].contractAddress,
+                    children[i].tokenId
+                );
+            delete _childIsInActive[children[i].contractAddress][
+                children[i].tokenId
+            ];
+            unchecked {
+                // At this point we know pendingRecursiveBurns must be at least 1
+                pendingRecursiveBurns = maxChildrenBurns - totalChildBurns;
+            }
+            // We substract one to the next level to count for the token being burned, then add it again on returns
+            // This is to allow the behavior of 0 recursive burns meaning only the current token is deleted.
+            totalChildBurns +=
+                IERC6059(children[i].contractAddress).burn(
+                    children[i].tokenId,
+                    pendingRecursiveBurns - 1
+                ) +
+                1;
+            unchecked {
+                ++i;
+            }
+        }
+        // Can't remove before burning child since child will call back to get root owner
+        delete _directOwners[tokenId];
+
+        _afterTokenTransfer(owner, address(0), tokenId);
+        _afterNestedTokenTransfer(
+            immediateOwner,
+            address(0),
+            parentId,
+            0,
+            tokenId
+        );
+        emit Transfer(owner, address(0), tokenId);
+        emit NestTransfer(immediateOwner, address(0), parentId, 0, tokenId);
+
+        return totalChildBurns;
+    }
+
+    /**
+     * @notice Used to safely transfer the token form `from` to `to`.
+     * @dev The function checks that contract recipients are aware of the ERC721 protocol to prevent tokens from being
+     *  forever locked.
+     * @dev This internal function is equivalent to {safeTransferFrom}, and can be used to e.g. implement alternative
+     *  mechanisms to perform token transfer, such as signature-based.
+     * @dev Requirements:
+     *
+     *  - `from` cannot be the zero address.
+     *  - `to` cannot be the zero address.
+     *  - `tokenId` token must exist and be owned by `from`.
+     *  - If `to` refers to a smart contract, it must implement {IERC721Receiver-onERC721Received}, which is called upon a safe transfer.
+     * @dev Emits a {Transfer} event.
+     * @param from Address of the account currently owning the given token
+     * @param to Address to transfer the token to
+     * @param tokenId ID of the token to transfer
+     * @param data Additional data with no specified format, sent in call to `to`
+     */
+    function _safeTransfer(
+        address from,
+        address to,
+        uint256 tokenId,
+        bytes memory data
+    ) internal virtual {
+        _transfer(from, to, tokenId);
+        if (!_checkOnERC721Received(from, to, tokenId, data))
+            revert ERC721TransferToNonReceiverImplementer();
+    }
+
+    /**
+     * @notice Used to transfer the token from `from` to `to`.
+     * @dev As opposed to {transferFrom}, this imposes no restrictions on msg.sender.
+     * @dev Requirements:
+     *
+     *  - `to` cannot be the zero address.
+     *  - `tokenId` token must be owned by `from`.
+     * @dev Emits a {Transfer} event.
+     * @param from Address of the account currently owning the given token
+     * @param to Address to transfer the token to
+     * @param tokenId ID of the token to transfer
+     */
+    function _transfer(
+        address from,
+        address to,
+        uint256 tokenId
+    ) internal virtual {
+        (address immediateOwner, uint256 parentId, ) = directOwnerOf(tokenId);
+        if (immediateOwner != from) revert ERC721TransferFromIncorrectOwner();
+        if (to == address(0)) revert ERC721TransferToTheZeroAddress();
+
+        _beforeTokenTransfer(from, to, tokenId);
+        _beforeNestedTokenTransfer(immediateOwner, to, parentId, 0, tokenId);
+
+        _balances[from] -= 1;
+        _updateOwnerAndClearApprovals(tokenId, 0, to, false);
+        _balances[to] += 1;
+
+        emit Transfer(from, to, tokenId);
+        emit NestTransfer(immediateOwner, to, parentId, 0, tokenId);
+
+        _afterTokenTransfer(from, to, tokenId);
+        _afterNestedTokenTransfer(immediateOwner, to, parentId, 0, tokenId);
+    }
+
+    // --------------------- NESTABLE GETTERS ---------------------
+
+    /**
+     * @notice Used to retrieve the immediate owner of the given token.
+     * @dev In the event the NFT is owned by an externally owned account, `tokenId` will be `0` and `isNft` will be
+     *  `false`.
+     * @param tokenId ID of the token for which the immediate owner is being retrieved
+     * @return address Address of the immediate owner. If the token is owned by an externally owned account, its address
+     *  will be returned. If the token is owned by another token, the parent token's collection smart contract address
+     *  is returned
+     * @return uint256 Token ID of the immediate owner. If the immediate owner is an externally owned account, the value
+     *  should be `0`
+     * @return bool A boolean value signifying whether the immediate owner is a token (`true`) or not (`false`)
+     */
+    function directOwnerOf(
+        uint256 tokenId
+    ) public view virtual returns (address, uint256, bool) {
+        DirectOwner memory owner = _directOwners[tokenId];
+        if (owner.ownerAddress == address(0)) revert ERC721InvalidTokenId();
+
+        return (owner.ownerAddress, owner.tokenId, owner.isNft);
+    }
+
+    /**
+     * @notice Used to retrieve the active child tokens of a given parent token.
+     * @dev Returns array of Child structs existing for parent token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which to retrieve the active child tokens
+     * @return struct[] An array of Child structs containing the parent token's active child tokens
+     */
+
+    function childrenOf(
+        uint256 parentId
+    ) public view virtual returns (Child[] memory) {
+        Child[] memory children = _activeChildren[parentId];
+        return children;
+    }
+
+    /**
+     * @notice Used to retrieve the pending child tokens of a given parent token.
+     * @dev Returns array of pending Child structs existing for given parent.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which to retrieve the pending child tokens
+     * @return struct[] An array of Child structs containing the parent token's pending child tokens
+     */
+
+    function pendingChildrenOf(
+        uint256 parentId
+    ) public view virtual returns (Child[] memory) {
+        Child[] memory pendingChildren = _pendingChildren[parentId];
+        return pendingChildren;
+    }
+
+    /**
+     * @notice Used to retrieve a specific active child token for a given parent token.
+     * @dev Returns a single Child struct locating at `index` of parent token's active child tokens array.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which the child is being retrieved
+     * @param index Index of the child token in the parent token's active child tokens array
+     * @return struct A Child struct containing data about the specified child
+     */
+    function childOf(
+        uint256 parentId,
+        uint256 index
+    ) public view virtual returns (Child memory) {
+        if (childrenOf(parentId).length <= index) revert ChildIndexOutOfRange();
+        Child memory child = _activeChildren[parentId][index];
+        return child;
+    }
+
+    /**
+     * @notice Used to retrieve a specific pending child token from a given parent token.
+     * @dev Returns a single Child struct locating at `index` of parent token's active child tokens array.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param parentId ID of the parent token for which the pending child token is being retrieved
+     * @param index Index of the child token in the parent token's pending child tokens array
+     * @return struct A Child struct containting data about the specified child
+     */
+    function pendingChildOf(
+        uint256 parentId,
+        uint256 index
+    ) public view virtual returns (Child memory) {
+        if (pendingChildrenOf(parentId).length <= index)
+            revert PendingChildIndexOutOfRange();
+        Child memory child = _pendingChildren[parentId][index];
+        return child;
+    }
+
+    /**
+     * @notice Used to verify that the given child tokwn is included in an active array of a token.
+     * @param childAddress Address of the given token's collection smart contract
+     * @param childId ID of the child token being checked
+     * @return bool A boolean value signifying whether the given child token is included in an active child tokens array
+     *  of a token (`true`) or not (`false`)
+     */
+    function childIsInActive(
+        address childAddress,
+        uint256 childId
+    ) public view virtual returns (bool) {
+        return _childIsInActive[childAddress][childId] != 0;
+    }
+
+    // --------------------- NESTABLE SETTERS ---------------------
+    /**
+     * @notice Used to add a child token to a given parent token.
+     * @dev This adds the iichild token into the given parent token's pending child tokens array.
+     * @dev You MUST NOT call this method directly. To add a a child to an NFT you must use either
+     *  `nestTransfer`, `nestMint` or `transferChild` to the NFT.
+     * @dev Requirements:
+     *
+     *  - `ownerOf` on the child contract must resolve to the called contract.
+     *  - The pending array of the parent contract must not be full.
+     * @param parentId ID of the parent token to receive the new child token
+     * @param childId ID of the new proposed child token
+     * @param data Additional data with no specified format
+     */
+    function addChild(
+        uint256 parentId,
+        uint256 childId,
+        bytes memory data
+    ) public virtual {
+        _requireMinted(parentId);
+
+        address childAddress = _msgSender();
+        if (!childAddress.isContract()) revert IsNotContract();
+
+        Child memory child = Child({
+            contractAddress: childAddress,
+            tokenId: childId
+        });
+
+        _beforeAddChild(parentId, childAddress, childId);
+
+        uint256 length = pendingChildrenOf(parentId).length;
+
+        if (length < 128) {
+            _pendingChildren[parentId].push(child);
+        } else {
+            revert MaxPendingChildrenReached();
+        }
+
+        // Previous length matches the index for the new child
+        emit ChildProposed(parentId, length, childAddress, childId);
+
+        _afterAddChild(parentId, childAddress, childId);
+    }
+
+    /**
+     * @notice @notice Used to accept a pending child token for a given parent token.
+     * @dev This moves the child token from parent token's pending child tokens array into the active child tokens
+     *  array.
+     * @param parentId ID of the parent token for which the child token is being accepted
+     * @param childIndex Index of a child tokem in the given parent's pending children array
+     * @param childAddress Address of the collection smart contract of the child token expected to be located at the
+     *  specified index of the given parent token's pending children array
+     * @param childId ID of the child token expected to be located at the specified index of the given parent token's
+     *  pending children array
+     */
+    function acceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) public virtual onlyApprovedOrOwner(parentId) {
+        _acceptChild(parentId, childIndex, childAddress, childId);
+    }
+
+    /**
+     * @notice Used to reject all pending children of a given parent token.
+     * @dev Removes the children from the pending array mapping.
+     * @dev This does not update the ownership storage data on children. If necessary, ownership can be reclaimed by the
+     *  rootOwner of the previous parent.
+     * @param tokenId ID of the parent token for which to reject all of the pending tokens
+     */
+    function rejectAllChildren(
+        uint256 tokenId,
+        uint256 maxRejections
+    ) public virtual onlyApprovedOrOwner(tokenId) {
+        _rejectAllChildren(tokenId, maxRejections);
+    }
+
+    /**
+     * @notice Used to transfer a child token from a given parent token.
+     * @param tokenId ID of the parent token from which the child token is being transferred
+     * @param to Address to which to transfer the token to
+     * @param destinationId ID of the token to receive this child token (MUST be 0 if the destination is not a token)
+     * @param childIndex Index of a token we are transferring, in the array it belongs to (can be either active array or
+     *  pending array)
+     * @param childAddress Address of the child token's collection smart contract.
+     * @param childId ID of the child token in its own collection smart contract.
+     * @param isPending A boolean value indicating whether the child token being transferred is in the pending array of the
+     *  parent token (`true`) or in the active array (`false`)
+     * @param data Additional data with no specified format, sent in call to `_to`
+     */
+    function transferChild(
+        uint256 tokenId,
+        address to,
+        uint256 destinationId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending,
+        bytes memory data
+    ) public virtual onlyApprovedOrOwner(tokenId) {
+        _transferChild(
+            tokenId,
+            to,
+            destinationId,
+            childIndex,
+            childAddress,
+            childId,
+            isPending,
+            data
+        );
+    }
+
+    /**
+     * @notice Used to transfer the token into another token.
+     * @dev The destination token MUST NOT be a child token of the token being transferred or one of its downstream
+     *  child tokens.
+     * @param from Address of the direct owner of the token to be transferred
+     * @param to Address of the receiving token's collection smart contract
+     * @param tokenId ID of the token being transferred
+     * @param destinationId ID of the token to receive the token being transferred
+     */
+    function nestTransferFrom(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 destinationId,
+        bytes memory data
+    ) public virtual onlyApprovedOrDirectOwner(tokenId) {
+        _nestTransfer(from, to, tokenId, destinationId, data);
+    }
+
+    // --------------------- NESTABLE INTERNAL ---------------------
+
+    /**
+     * @notice Used to transfer a child token from a given parent token.
+     * @dev When transferring a child token, the owner of the token is set to `to`, or is not updated in the event of `to`
+     *  being the `0x0` address.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist.
+     * @dev Emits {ChildTransferred} event.
+     * @param tokenId ID of the parent token from which the child token is being transferred
+     * @param to Address to which to transfer the token to
+     * @param destinationId ID of the token to receive this child token (MUST be 0 if the destination is not a token)
+     * @param childIndex Index of a token we are transferring, in the array it belongs to (can be either active array or
+     *  pending array)
+     * @param childAddress Address of the child token's collection smart contract.
+     * @param childId ID of the child token in its own collection smart contract.
+     * @param isPending A boolean value indicating whether the child token being transferred is in the pending array of the
+     *  parent token (`true`) or in the active array (`false`)
+     * @param data Additional data with no specified format, sent in call to `_to`
+     */
+    function _transferChild(
+        uint256 tokenId,
+        address to,
+        uint256 destinationId, // newParentId
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending,
+        bytes memory data
+    ) internal virtual {
+        Child memory child;
+        if (!isPending) {
+            if (isChildEquipped(tokenId, childAddress, childId))
+                revert MustUnequipFirst();
+        }
+        if (isPending) {
+            child = pendingChildOf(tokenId, childIndex);
+        } else {
+            child = childOf(tokenId, childIndex);
+        }
+        _checkExpectedChild(child, childAddress, childId);
+
+        _beforeTransferChild(
+            tokenId,
+            childIndex,
+            childAddress,
+            childId,
+            isPending
+        );
+
+        if (isPending) {
+            _removeChildByIndex(_pendingChildren[tokenId], childIndex);
+        } else {
+            delete _childIsInActive[childAddress][childId];
+            _removeChildByIndex(_activeChildren[tokenId], childIndex);
+        }
+
+        if (to != address(0)) {
+            if (destinationId == 0) {
+                IERC721(childAddress).safeTransferFrom(
+                    address(this),
+                    to,
+                    childId,
+                    data
+                );
+            } else {
+                // Destination is an NFT
+                IERC6059(child.contractAddress).nestTransferFrom(
+                    address(this),
+                    to,
+                    child.tokenId,
+                    destinationId,
+                    data
+                );
+            }
+        }
+
+        emit ChildTransferred(
+            tokenId,
+            childIndex,
+            childAddress,
+            childId,
+            isPending
+        );
+        _afterTransferChild(
+            tokenId,
+            childIndex,
+            childAddress,
+            childId,
+            isPending
+        );
+    }
+
+    /**
+     * @notice Used to accept a pending child token for a given parent token.
+     * @dev This moves the child token from parent token's pending child tokens array into the active child tokens
+     *  array.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist
+     *  - `index` must be in range of the pending children array
+     * @param parentId ID of the parent token for which the child token is being accepted
+     * @param childIndex Index of a child tokem in the given parent's pending children array
+     * @param childAddress Address of the collection smart contract of the child token expected to be located at the
+     *  specified index of the given parent token's pending children array
+     * @param childId ID of the child token expected to be located at the specified index of the given parent token's
+     *  pending children array
+     */
+    function _acceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) internal virtual {
+        if (pendingChildrenOf(parentId).length <= childIndex)
+            revert PendingChildIndexOutOfRange();
+
+        Child memory child = pendingChildOf(parentId, childIndex);
+        _checkExpectedChild(child, childAddress, childId);
+        if (_childIsInActive[childAddress][childId] != 0)
+            revert ChildAlreadyExists();
+
+        _beforeAcceptChild(parentId, childIndex, childAddress, childId);
+
+        // Remove from pending:
+        _removeChildByIndex(_pendingChildren[parentId], childIndex);
+
+        // Add to active:
+        _activeChildren[parentId].push(child);
+        _childIsInActive[childAddress][childId] = 1; // We use 1 as true
+
+        emit ChildAccepted(parentId, childIndex, childAddress, childId);
+
+        _afterAcceptChild(parentId, childIndex, childAddress, childId);
+    }
+
+    /**
+     * @notice Used to reject all pending children of a given parent token.
+     * @dev Removes the children from the pending array mapping.
+     * @dev This does not update the ownership storage data on children. If necessary, ownership can be reclaimed by the
+     *  rootOwner of the previous parent.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist
+     * @param tokenId ID of the parent token for which to reject all of the pending tokens.
+     * @param maxRejections Maximum number of expected children to reject, used to prevent from
+     *  rejecting children which arrive just before this operation.
+     */
+    function _rejectAllChildren(
+        uint256 tokenId,
+        uint256 maxRejections
+    ) internal virtual {
+        if (_pendingChildren[tokenId].length > maxRejections)
+            revert UnexpectedNumberOfChildren();
+
+        _beforeRejectAllChildren(tokenId);
+        delete _pendingChildren[tokenId];
+        emit AllChildrenRejected(tokenId);
+        _afterRejectAllChildren(tokenId);
+    }
+
+    function _checkExpectedChild(
+        Child memory child,
+        address expectedAddress,
+        uint256 expectedId
+    ) private pure {
+        if (
+            expectedAddress != child.contractAddress ||
+            expectedId != child.tokenId
+        ) revert UnexpectedChildId();
+    }
+
+    /**
+     * @notice Used to remove a specified child token form an array using its index within said array.
+     * @dev The caller must ensure that the length of the array is valid compared to the index passed.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @param array An array od Child struct containing info about the child tokens in a given child tokens array
+     * @param index An index of the child token to remove in the accompanying array
+     */
+    function _removeChildByIndex(Child[] storage array, uint256 index) private {
+        array[index] = array[array.length - 1];
+        array.pop();
+    }
+
+    /**
+     * @notice Used to transfer a token into another token.
+     * @dev Attempting to nest a token into `0x0` address will result in reverted transaction.
+     * @dev Attempting to nest a token into itself will result in reverted transaction.
+     * @param from Address of the account currently owning the given token
+     * @param to Address of the receiving token's collection smart contract
+     * @param tokenId ID of the token to transfer
+     * @param destinationId ID of the token receiving the given token
+     * @param data Additional data with no specified format, sent in the addChild call
+     */
+    function _nestTransfer(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 destinationId,
+        bytes memory data
+    ) internal virtual {
+        (address immediateOwner, uint256 parentId, ) = directOwnerOf(tokenId);
+        if (immediateOwner != from) revert ERC721TransferFromIncorrectOwner();
+        if (to == address(0)) revert ERC721TransferToTheZeroAddress();
+        if (to == address(this) && tokenId == destinationId)
+            revert NestableTransferToSelf();
+
+        // Destination contract checks:
+        // It seems redundant, but otherwise it would revert with no error
+        if (!to.isContract()) revert IsNotContract();
+        if (!IERC165(to).supportsInterface(type(IERC6059).interfaceId))
+            revert NestableTransferToNonNestableImplementer();
+        _checkForInheritanceLoop(tokenId, to, destinationId);
+
+        _beforeTokenTransfer(from, to, tokenId);
+        _beforeNestedTokenTransfer(
+            immediateOwner,
+            to,
+            parentId,
+            destinationId,
+            tokenId
+        );
+        _balances[from] -= 1;
+        _updateOwnerAndClearApprovals(tokenId, destinationId, to, true);
+        _balances[to] += 1;
+
+        // Sending to NFT:
+        _sendToNFT(immediateOwner, to, parentId, destinationId, tokenId, data);
+    }
+
+    /**
+     * @notice Used to send a token to another token.
+     * @dev If the token being sent is currently owned by an externally owned account, the `parentId` should equal `0`.
+     * @dev Emits {Transfer} event.
+     * @dev Emits {NestTransfer} event.
+     * @param from Address from which the token is being sent
+     * @param to Address of the collection smart contract of the token to receive the given token
+     * @param parentId ID of the current parent token of the token being sent
+     * @param destinationId ID of the tokento receive the token being sent
+     * @param tokenId ID of the token being sent
+     * @param data Additional data with no specified format, sent in the addChild call
+     */
+    function _sendToNFT(
+        address from,
+        address to,
+        uint256 parentId,
+        uint256 destinationId,
+        uint256 tokenId,
+        bytes memory data
+    ) private {
+        IERC6059 destContract = IERC6059(to);
+        destContract.addChild(destinationId, tokenId, data);
+        _afterTokenTransfer(from, to, tokenId);
+        _afterNestedTokenTransfer(from, to, parentId, destinationId, tokenId);
+
+        emit Transfer(from, to, tokenId);
+        emit NestTransfer(from, to, parentId, destinationId, tokenId);
+    }
+
+    /**
+     * @notice Used to check if nesting a given token into a specified token would create an inheritance loop.
+     * @dev If a loop would occur, the tokens would be unmanageable, so the execution is reverted if one is detected.
+     * @dev The check for inheritance loop is bounded to guard against too much gas being consumed.
+     * @param currentId ID of the token that would be nested
+     * @param targetContract Address of the collection smart contract of the token into which the given token would be
+     *  nested
+     * @param targetId ID of the token into which the given token would be nested
+     */
+    function _checkForInheritanceLoop(
+        uint256 currentId,
+        address targetContract,
+        uint256 targetId
+    ) private view {
+        for (uint256 i; i < _MAX_LEVELS_TO_CHECK_FOR_INHERITANCE_LOOP; ) {
+            (
+                address nextOwner,
+                uint256 nextOwnerTokenId,
+                bool isNft
+            ) = IERC6059(targetContract).directOwnerOf(targetId);
+            // If there's a final address, we're good. There's no loop.
+            if (!isNft) {
+                return;
+            }
+            // Ff the current nft is an ancestor at some point, there is an inheritance loop
+            if (nextOwner == address(this) && nextOwnerTokenId == currentId) {
+                revert NestableTransferToDescendant();
+            }
+            // We reuse the parameters to save some contract size
+            targetContract = nextOwner;
+            targetId = nextOwnerTokenId;
+            unchecked {
+                ++i;
+            }
+        }
+        revert NestableTooDeep();
+    }
+
+    // --------------------- MULTIASSET GETTERS ---------------------
+
+    /**
+     * @notice Used to get the address of the user that is approved to manage the specified token from the current
+     *  owner.
+     * @param tokenId ID of the token we are checking
+     * @return address Address of the account that is approved to manage the token
+     */
+    function getApprovedForAssets(
+        uint256 tokenId
+    ) public view virtual returns (address) {
+        _requireMinted(tokenId);
+        return _tokenApprovalsForAssets[tokenId][ownerOf(tokenId)];
+    }
+
+    /**
+     * @inheritdoc IERC5773
+     */
+    function getAssetMetadata(
+        uint256 tokenId,
+        uint64 assetId
+    ) public view virtual returns (string memory) {
+        if (!_tokenAssets[tokenId][assetId]) revert TokenDoesNotHaveAsset();
+        return _assets[assetId];
+    }
+
+    /**
+     * @inheritdoc IERC5773
+     */
+    function getActiveAssets(
+        uint256 tokenId
+    ) public view virtual returns (uint64[] memory) {
+        return _activeAssets[tokenId];
+    }
+
+    /**
+     * @inheritdoc IERC5773
+     */
+    function getPendingAssets(
+        uint256 tokenId
+    ) public view virtual returns (uint64[] memory) {
+        return _pendingAssets[tokenId];
+    }
+
+    /**
+     * @inheritdoc IERC5773
+     */
+    function getActiveAssetPriorities(
+        uint256 tokenId
+    ) public view virtual returns (uint16[] memory) {
+        return _activeAssetPriorities[tokenId];
+    }
+
+    /**
+     * @inheritdoc IERC5773
+     */
+    function getAssetReplacements(
+        uint256 tokenId,
+        uint64 newAssetId
+    ) public view virtual returns (uint64) {
+        return _assetReplacements[tokenId][newAssetId];
+    }
+
+    /**
+     * @inheritdoc IERC5773
+     */
+    function isApprovedForAllForAssets(
+        address owner,
+        address operator
+    ) public view virtual returns (bool) {
+        return _operatorApprovalsForAssets[owner][operator];
+    }
+
+    // --------------------- MULTIASSET SETTERS ---------------------
+    /**
+     * @notice Used to grant approvals for specific tokens to a specified address.
+     * @dev This can only be called by the owner of the token or by an account that has been granted permission to
+     *  manage all of the owner's assets.
+     * @param to Address of the account to receive the approval to the specified token
+     * @param tokenId ID of the token for which we are granting the permission
+     */
+    function approveForAssets(address to, uint256 tokenId) public virtual {
+        address owner = ownerOf(tokenId);
+        if (to == owner) revert ApprovalForAssetsToCurrentOwner();
+
+        if (
+            _msgSender() != owner &&
+            !isApprovedForAllForAssets(owner, _msgSender())
+        ) revert ApproveForAssetsCallerIsNotOwnerNorApprovedForAll();
+        _approveForAssets(to, tokenId);
+    }
+
+    /**
+     * @inheritdoc IERC5773
+     */
+    function setApprovalForAllForAssets(
+        address operator,
+        bool approved
+    ) public virtual {
+        address owner = _msgSender();
+        if (owner == operator) revert ApprovalForAssetsToCurrentOwner();
+
+        _operatorApprovalsForAssets[owner][operator] = approved;
+        emit ApprovalForAllForAssets(owner, operator, approved);
+    }
+
+    /**
+     * @notice Accepts a asset at from the pending array of given token.
+     * @dev Migrates the asset from the token's pending asset array to the token's active asset array.
+     * @dev Active assets cannot be removed by anyone, but can be replaced by a new asset.
+     * @dev Requirements:
+     *
+     *  - The caller must own the token or be approved to manage the token's assets
+     *  - `tokenId` must exist.
+     *  - `index` must be in range of the length of the pending asset array.
+     * @dev Emits an {AssetAccepted} event.
+     * @param tokenId ID of the token for which to accept the pending asset
+     * @param index Index of the asset in the pending array to accept
+     */
+    function acceptAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint64 assetId
+    ) public virtual onlyApprovedForAssetsOrOwner(tokenId) {
+        _acceptAsset(tokenId, index, assetId);
+    }
+
+    /**
+     * @notice Rejects a asset from the pending array of given token.
+     * @dev Removes the asset from the token's pending asset array.
+     * @dev Requirements:
+     *
+     *  - The caller must own the token or be approved to manage the token's assets
+     *  - `tokenId` must exist.
+     *  - `index` must be in range of the length of the pending asset array.
+     * @dev Emits a {AssetRejected} event.
+     * @param tokenId ID of the token that the asset is being rejected from
+     * @param index Index of the asset in the pending array to be rejected
+     */
+    function rejectAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint64 assetId
+    ) public virtual onlyApprovedForAssetsOrOwner(tokenId) {
+        _rejectAsset(tokenId, index, assetId);
+    }
+
+    /**
+     * @notice Rejects all assets from the pending array of a given token.
+     * @dev Effecitvely deletes the pending array.
+     * @dev Requirements:
+     *
+     *  - The caller must own the token or be approved to manage the token's assets
+     *  - `tokenId` must exist.
+     * @dev Emits a {AssetRejected} event with assetId = 0.
+     * @param tokenId ID of the token of which to clear the pending array.
+     * @param maxRejections Maximum number of expected assets to reject, used to prevent from rejecting assets which
+     *  arrive just before this operation.
+     */
+    function rejectAllAssets(
+        uint256 tokenId,
+        uint256 maxRejections
+    ) public virtual onlyApprovedForAssetsOrOwner(tokenId) {
+        _rejectAllAssets(tokenId, maxRejections);
+    }
+
+    /**
+     * @notice Sets a new priority array for a given token.
+     * @dev The priority array is a non-sequential list of `uint16`s, where the lowest value is considered highest
+     *  priority.
+     * @dev Value `0` of a priority is a special case equivalent to unitialized.
+     * @dev Requirements:
+     *
+     *  - The caller must own the token or be approved to manage the token's assets
+     *  - `tokenId` must exist.
+     *  - The length of `priorities` must be equal the length of the active assets array.
+     * @dev Emits a {AssetPrioritySet} event.
+     * @param tokenId ID of the token to set the priorities for
+     * @param priorities An array of priority values
+     */
+    function setPriority(
+        uint256 tokenId,
+        uint16[] calldata priorities
+    ) public virtual onlyApprovedForAssetsOrOwner(tokenId) {
+        _setPriority(tokenId, priorities);
+    }
+
+    // --------------------- MULTIASSET INTERNAL ---------------------
+
+    /**
+     * @notice Internal function for granting approvals for a specific token.
+     * @param to Address of the account we are granting an approval to
+     * @param tokenId ID of the token we are granting the approval for
+     */
+    function _approveForAssets(address to, uint256 tokenId) internal virtual {
+        address owner = ownerOf(tokenId);
+        _tokenApprovalsForAssets[tokenId][owner] = to;
+        emit ApprovalForAssets(owner, to, tokenId);
+    }
+
+    /**
+     * @notice Used to add a asset entry.
+     * @dev This internal function warrants custom access control to be implemented when used.
+     * @param id ID of the asset being added
+     * @param equippableGroupId ID of the equippable group being marked as equippable into the slot associated with
+     *  `Parts` of the `Slot` type
+     * @param catalogAddress Address of the `Catalog` associated with the asset
+     * @param metadataURI The metadata URI of the asset
+     * @param partIds An array of IDs of fixed and slot parts to be included in the asset
+     */
+    function _addAssetEntry(
+        uint64 id,
+        uint64 equippableGroupId,
+        address catalogAddress,
+        string memory metadataURI,
+        uint64[] calldata partIds
+    ) internal virtual {
+        _addAssetEntry(id, metadataURI);
+
+        if (catalogAddress == address(0) && partIds.length != 0)
+            revert CatalogRequiredForParts();
+
+        _catalogAddresses[id] = catalogAddress;
+        _equippableGroupIds[id] = equippableGroupId;
+        _partIds[id] = partIds;
+    }
+
+    /**
+     * @notice Used to accept a pending asset.
+     * @dev The call is reverted if there is no pending asset at a given index.
+     * @param tokenId ID of the token for which to accept the pending asset
+     * @param index Index of the asset in the pending array to accept
+     * @param assetId ID of the asset to accept in token's pending array
+     */
+    function _acceptAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint64 assetId
+    ) internal virtual {
+        _validatePendingAssetAtIndex(tokenId, index, assetId);
+        _beforeAcceptAsset(tokenId, index, assetId);
+
+        uint64 replacesId = _assetReplacements[tokenId][assetId];
+        uint256 replaceIndex;
+        bool replacefound;
+        if (replacesId != uint64(0))
+            (replaceIndex, replacefound) = _activeAssets[tokenId].indexOf(
+                replacesId
+            );
+
+        if (replacefound) {
+            // We don't want to remove and then push a new asset.
+            // This way we also keep the priority of the original asset
+            _activeAssets[tokenId][replaceIndex] = assetId;
+            delete _tokenAssets[tokenId][replacesId];
+        } else {
+            // We use the current size as next priority, by default priorities would be [0,1,2...]
+            _activeAssetPriorities[tokenId].push(
+                uint16(_activeAssets[tokenId].length)
+            );
+            _activeAssets[tokenId].push(assetId);
+            replacesId = uint64(0);
+        }
+        _removePendingAsset(tokenId, index, assetId);
+
+        emit AssetAccepted(tokenId, assetId, replacesId);
+        _afterAcceptAsset(tokenId, index, assetId);
+    }
+
+    /**
+     * @notice Used to reject the specified asset from the pending array.
+     * @dev The call is reverted if there is no pending asset at a given index.
+     * @param tokenId ID of the token that the asset is being rejected from
+     * @param index Index of the asset in the pending array to be rejected
+     * @param assetId ID of the asset expected to be in the index
+     */
+    function _rejectAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint64 assetId
+    ) internal virtual {
+        _validatePendingAssetAtIndex(tokenId, index, assetId);
+        _beforeRejectAsset(tokenId, index, assetId);
+
+        _removePendingAsset(tokenId, index, assetId);
+        delete _tokenAssets[tokenId][assetId];
+
+        emit AssetRejected(tokenId, assetId);
+        _afterRejectAsset(tokenId, index, assetId);
+    }
+
+    /**
+     * @notice Used to validate the index on the pending assets array
+     * @dev The call is reverted if the index is out of range or the asset Id is not present at the index.
+     * @param tokenId ID of the token that the asset is validated from
+     * @param index Index of the asset in the pending array
+     * @param assetId Id of the asset expected to be in the index
+     */
+    function _validatePendingAssetAtIndex(
+        uint256 tokenId,
+        uint256 index,
+        uint64 assetId
+    ) private view {
+        if (index >= _pendingAssets[tokenId].length) revert IndexOutOfRange();
+        if (assetId != _pendingAssets[tokenId][index])
+            revert UnexpectedAssetId();
+    }
+
+    /**
+     * @notice Used to remove the asset at the index on the pending assets array
+     * @param tokenId ID of the token that the asset is being removed from
+     * @param index Index of the asset in the pending array
+     * @param assetId Id of the asset expected to be in the index
+     */
+    function _removePendingAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint64 assetId
+    ) private {
+        _pendingAssets[tokenId].removeItemByIndex(index);
+        delete _assetReplacements[tokenId][assetId];
+    }
+
+    /**
+     * @notice Used to reject all of the pending assets for the given token.
+     * @dev When rejecting all assets, the pending array is indiscriminately cleared.
+     * @dev If the number of pending assets is greater than the value of `maxRejections`, the exectuion will be
+     *  reverted.
+     * @param tokenId ID of the token to reject all of the pending assets.
+     * @param maxRejections Maximum number of expected assets to reject, used to prevent from
+     *  rejecting assets which arrive just before this operation.
+     */
+    function _rejectAllAssets(
+        uint256 tokenId,
+        uint256 maxRejections
+    ) internal virtual {
+        uint256 len = _pendingAssets[tokenId].length;
+        if (len > maxRejections) revert UnexpectedNumberOfAssets();
+
+        _beforeRejectAllAssets(tokenId);
+
+        for (uint256 i; i < len; ) {
+            uint64 assetId = _pendingAssets[tokenId][i];
+            delete _assetReplacements[tokenId][assetId];
+            unchecked {
+                ++i;
+            }
+        }
+        delete (_pendingAssets[tokenId]);
+
+        emit AssetRejected(tokenId, uint64(0));
+        _afterRejectAllAssets(tokenId);
+    }
+
+    /**
+     * @notice Used to specify the priorities for a given token's active assets.
+     * @dev If the length of the priorities array doesn't match the length of the active assets array, the execution
+     *  will be reverted.
+     * @dev The position of the priority value in the array corresponds the position of the asset in the active
+     *  assets array it will be applied to.
+     * @param tokenId ID of the token for which the priorities are being set
+     * @param priorities Array of priorities for the assets
+     */
+    function _setPriority(
+        uint256 tokenId,
+        uint16[] calldata priorities
+    ) internal virtual {
+        uint256 length = priorities.length;
+        if (length != _activeAssets[tokenId].length)
+            revert BadPriorityListLength();
+
+        _beforeSetPriority(tokenId, priorities);
+        _activeAssetPriorities[tokenId] = priorities;
+
+        emit AssetPrioritySet(tokenId);
+        _afterSetPriority(tokenId, priorities);
+    }
+
+    /**
+     * @notice Used to add an asset entry.
+     * @dev If the specified ID is already used by another asset, the execution will be reverted.
+     * @dev This internal function warrants custom access control to be implemented when used.
+     * @param id ID of the asset to assign to the new asset
+     * @param metadataURI Metadata URI of the asset
+     */
+    function _addAssetEntry(
+        uint64 id,
+        string memory metadataURI
+    ) internal virtual {
+        if (id == uint64(0)) revert IdZeroForbidden();
+        if (bytes(_assets[id]).length > 0) revert AssetAlreadyExists();
+
+        _beforeAddAsset(id, metadataURI);
+        _assets[id] = metadataURI;
+
+        emit AssetSet(id);
+        _afterAddAsset(id, metadataURI);
+    }
+
+    /**
+     * @notice Used to add an asset to a token.
+     * @dev If the given asset is already added to the token, the execution will be reverted.
+     * @dev If the asset ID is invalid, the execution will be reverted.
+     * @dev If the token already has the maximum amount of pending assets (128), the execution will be
+     *  reverted.
+     * @param tokenId ID of the token to add the asset to
+     * @param assetId ID of the asset to add to the token
+     * @param replacesAssetWithId ID of the asset to replace from the token's list of active assets
+     */
+    function _addAssetToToken(
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 replacesAssetWithId
+    ) internal virtual {
+        if (_tokenAssets[tokenId][assetId]) revert AssetAlreadyExists();
+
+        if (bytes(_assets[assetId]).length == 0) revert NoAssetMatchingId();
+
+        if (_pendingAssets[tokenId].length >= 128)
+            revert MaxPendingAssetsReached();
+
+        _beforeAddAssetToToken(tokenId, assetId, replacesAssetWithId);
+        _tokenAssets[tokenId][assetId] = true;
+        _pendingAssets[tokenId].push(assetId);
+
+        if (replacesAssetWithId != uint64(0)) {
+            _assetReplacements[tokenId][assetId] = replacesAssetWithId;
+        }
+
+        emit AssetAddedToToken(tokenId, assetId, replacesAssetWithId);
+        _afterAddAssetToToken(tokenId, assetId, replacesAssetWithId);
+    }
+
+    // --------------------- EQUIPPABLE GETTERS ---------------------
+
+    /**
+     * @inheritdoc IEquippable
+     */
+    function canTokenBeEquippedWithAssetIntoSlot(
+        address parent,
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 slotId
+    ) public view virtual returns (bool) {
+        uint64 equippableGroupId = _equippableGroupIds[assetId];
+        uint64 equippableSlot = _validParentSlots[equippableGroupId][parent];
+        if (equippableSlot == slotId) {
+            (, bool found) = getActiveAssets(tokenId).indexOf(assetId);
+            return found;
+        }
+        return false;
+    }
+
+    /**
+     * @inheritdoc IEquippable
+     */
+    function isChildEquipped(
+        uint256 tokenId,
+        address childAddress,
+        uint256 childId
+    ) public view virtual returns (bool) {
+        return _equipCountPerChild[tokenId][childAddress][childId] != uint8(0);
+    }
+
+    /**
+     * @inheritdoc IEquippable
+     */
+    function getAssetAndEquippableData(
+        uint256 tokenId,
+        uint64 assetId
+    )
+        public
+        view
+        virtual
+        returns (string memory, uint64, address, uint64[] memory)
+    {
+        return (
+            getAssetMetadata(tokenId, assetId),
+            _equippableGroupIds[assetId],
+            _catalogAddresses[assetId],
+            _partIds[assetId]
+        );
+    }
+
+    /**
+     * @inheritdoc IEquippable
+     */
+    function getEquipment(
+        uint256 tokenId,
+        address targetCatalogAddress,
+        uint64 slotPartId
+    ) public view virtual returns (Equipment memory) {
+        return _equipments[tokenId][targetCatalogAddress][slotPartId];
+    }
+
+    // --------------------- EQUIPPABLE SETTERS ---------------------
+
+    /**
+     * @inheritdoc IEquippable
+     */
+    function equip(
+        IntakeEquip memory data
+    ) public virtual onlyApprovedOrOwner(data.tokenId) nonReentrant {
+        _equip(data);
+    }
+
+    /**
+     * @inheritdoc IEquippable
+     */
+    function unequip(
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 slotPartId
+    ) public virtual onlyApprovedOrOwner(tokenId) {
+        _unequip(tokenId, assetId, slotPartId);
+    }
+
+    // --------------------- EQUIPPABLE INTERNAL ---------------------
+
+    /**
+     * @notice Private function used to equip a child into a token.
+     * @dev If the `Slot` already has an item equipped, the execution will be reverted.
+     * @dev If the child can't be used in the given `Slot`, the execution will be reverted.
+     * @dev If the catalog doesn't allow this equip to happen, the execution will be reverted.
+     * @dev The `IntakeEquip` stuct contains the following data:
+     *  [
+     *      tokenId,
+     *      childIndex,
+     *      assetId,
+     *      slotPartId,
+     *      childAssetId
+     *  ]
+     * @param data An `IntakeEquip` struct specifying the equip data
+     */
+    function _equip(IntakeEquip memory data) internal virtual {
+        address catalogAddress = _catalogAddresses[data.assetId];
+        uint64 slotPartId = data.slotPartId;
+        if (
+            _equipments[data.tokenId][catalogAddress][slotPartId]
+                .childEquippableAddress != address(0)
+        ) revert SlotAlreadyUsed();
+
+        // Check from parent's asset perspective:
+        (, bool found) = _partIds[data.assetId].indexOf(slotPartId);
+        if (!found) revert TargetAssetCannotReceiveSlot();
+
+        IERC6059.Child memory child = childOf(data.tokenId, data.childIndex);
+
+        // Check from child perspective intention to be used in part
+        // We add reentrancy guard because of this call, it happens before updating state
+        if (
+            !IEquippable(child.contractAddress)
+                .canTokenBeEquippedWithAssetIntoSlot(
+                    address(this),
+                    child.tokenId,
+                    data.childAssetId,
+                    slotPartId
+                )
+        ) revert TokenCannotBeEquippedWithAssetIntoSlot();
+
+        // Check from catalog perspective
+        if (
+            !ICatalog(catalogAddress).checkIsEquippable(
+                slotPartId,
+                child.contractAddress
+            )
+        ) revert EquippableEquipNotAllowedByCatalog();
+
+        _beforeEquip(data);
+        Equipment memory newEquip = Equipment({
+            assetId: data.assetId,
+            childAssetId: data.childAssetId,
+            childId: child.tokenId,
+            childEquippableAddress: child.contractAddress
+        });
+
+        _equipments[data.tokenId][catalogAddress][slotPartId] = newEquip;
+        _equipCountPerChild[data.tokenId][child.contractAddress][
+            child.tokenId
+        ] += 1;
+
+        emit ChildAssetEquipped(
+            data.tokenId,
+            data.assetId,
+            slotPartId,
+            child.tokenId,
+            child.contractAddress,
+            data.childAssetId
+        );
+        _afterEquip(data);
+    }
+
+    /**
+     * @notice Private function used to unequip child from parent token.
+     * @param tokenId ID of the parent from which the child is being unequipped
+     * @param assetId ID of the parent's asset that contains the `Slot` into which the child is equipped
+     * @param slotPartId ID of the `Slot` from which to unequip the child
+     */
+    function _unequip(
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 slotPartId
+    ) internal virtual {
+        address targetCatalogAddress = _catalogAddresses[assetId];
+        Equipment memory equipment = _equipments[tokenId][targetCatalogAddress][
+            slotPartId
+        ];
+        if (equipment.childEquippableAddress == address(0))
+            revert NotEquipped();
+        _beforeUnequip(tokenId, assetId, slotPartId);
+
+        delete _equipments[tokenId][targetCatalogAddress][slotPartId];
+        _equipCountPerChild[tokenId][equipment.childEquippableAddress][
+            equipment.childId
+        ] -= 1;
+
+        emit ChildAssetUnequipped(
+            tokenId,
+            assetId,
+            slotPartId,
+            equipment.childId,
+            equipment.childEquippableAddress,
+            equipment.childAssetId
+        );
+        _afterUnequip(tokenId, assetId, slotPartId);
+    }
+
+    /**
+     * @notice Internal function used to declare that the assets belonging to a given `equippableGroupId` are
+     *  equippable into the `Slot` associated with the `partId` of the collection at the specified `parentAddress`
+     * @param equippableGroupId ID of the equippable group
+     * @param parentAddress Address of the parent into which the equippable group can be equipped into
+     * @param slotPartId ID of the `Slot` that the items belonging to the equippable group can be equipped into
+     */
+    function _setValidParentForEquippableGroup(
+        uint64 equippableGroupId,
+        address parentAddress,
+        uint64 slotPartId
+    ) internal virtual {
+        if (equippableGroupId == uint64(0) || slotPartId == uint64(0))
+            revert IdZeroForbidden();
+        _validParentSlots[equippableGroupId][parentAddress] = slotPartId;
+        emit ValidParentEquippableGroupIdSet(
+            equippableGroupId,
+            slotPartId,
+            parentAddress
+        );
+    }
+
+    // --------------------- MODIFIERS IMPLEMENTATIONS ---------------------
+
+    /**
+     * @notice Used to verify that the caller is either the owner of the token or approved to manage it by its owner.
+     * @dev If the caller is not the owner of the token or approved to manage it by its owner, the execution will be
+     *  reverted.
+     * @param tokenId ID of the token to check
+     */
+    function _onlyApprovedOrOwner(uint256 tokenId) private view {
+        if (!_isApprovedOrOwner(_msgSender(), tokenId))
+            revert ERC721NotApprovedOrOwner();
+    }
+
+    /**
+     * @notice Used to verify that the caller is approved to manage the given token or it its direct owner.
+     * @dev This does not delegate to ownerOf, which returns the root owner, but rater uses an owner from DirectOwner
+     *  struct.
+     * @dev The execution is reverted if the caller is not immediate owner or approved to manage the given token.
+     * @dev Used for parent-scoped transfers.
+     * @param tokenId ID of the token to check.
+     */
+    function _onlyApprovedOrDirectOwner(uint256 tokenId) private view {
+        if (!_isApprovedOrDirectOwner(_msgSender(), tokenId))
+            revert NotApprovedOrDirectOwner();
+    }
+
+    /**
+     * @notice Used to verify that the caller is either the owner of the given token or approved to manage the token's assets
+     *  of the owner.
+     * @param tokenId ID of the token that we are checking
+     */
+    function _onlyApprovedForAssetsOrOwner(uint256 tokenId) private view {
+        if (!_isApprovedForAssetsOrOwner(_msgSender(), tokenId))
+            revert NotApprovedForAssetsOrOwner();
+    }
+
+    /**
+     * @notice Used to check whether the given account is allowed to manage the given token.
+     * @dev Requirements:
+     *
+     *  - `tokenId` must exist.
+     * @param spender Address that is being checked for approval
+     * @param tokenId ID of the token being checked
+     * @return bool The boolean value indicating whether the `spender` is approved to manage the given token
+     */
+    function _isApprovedOrOwner(
+        address spender,
+        uint256 tokenId
+    ) internal view virtual returns (bool) {
+        address owner = ownerOf(tokenId);
+        return (spender == owner ||
+            isApprovedForAll(owner, spender) ||
+            getApproved(tokenId) == spender);
+    }
+
+    /**
+     * @notice Used to check whether the account is approved to manage the token or its direct owner.
+     * @param spender Address that is being checked for approval or direct ownership
+     * @param tokenId ID of the token being checked
+     * @return bool The boolean value indicating whether the `spender` is approved to manage the given token or its
+     *  direct owner
+     */
+    function _isApprovedOrDirectOwner(
+        address spender,
+        uint256 tokenId
+    ) internal view virtual returns (bool) {
+        (address owner, uint256 parentId, ) = directOwnerOf(tokenId);
+        // When the parent is an NFT, only it can do operations
+        if (parentId != 0) {
+            return (spender == owner);
+        }
+        // Otherwise, the owner or approved address can
+        return (spender == owner ||
+            isApprovedForAll(owner, spender) ||
+            getApproved(tokenId) == spender);
+    }
+
+    /**
+     * @notice Internal function to check whether the queried user is either:
+     *   1. The root owner of the token associated with `tokenId`.
+     *   2. Is approved for all assets of the current owner via the `setApprovalForAllForAssets` function.
+     *   3. Is granted approval for the specific tokenId for asset management via the `approveForAssets` function.
+     * @param user Address of the user we are checking for permission
+     * @param tokenId ID of the token to query for permission for a given `user`
+     * @return bool A boolean value indicating whether the user is approved to manage the token or not
+     */
+    function _isApprovedForAssetsOrOwner(
+        address user,
+        uint256 tokenId
+    ) internal view virtual returns (bool) {
+        address owner = ownerOf(tokenId);
+        return (user == owner ||
+            isApprovedForAllForAssets(owner, user) ||
+            getApprovedForAssets(tokenId) == user);
+    }
+
+    // --------------------- MULTIASSET HOOKS ---------------------
+
+    /**
+     * @notice Hook that is called before an asset is added.
+     * @param id ID of the asset
+     * @param metadataURI Metadata URI of the asset
+     */
+    function _beforeAddAsset(
+        uint64 id,
+        string memory metadataURI
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after an asset is added.
+     * @param id ID of the asset
+     * @param metadataURI Metadata URI of the asset
+     */
+    function _afterAddAsset(
+        uint64 id,
+        string memory metadataURI
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before adding an asset to a token's pending assets array.
+     * @dev If the asset doesn't intend to replace another asset, the `replacesAssetWithId` value should be `0`.
+     * @param tokenId ID of the token to which the asset is being added
+     * @param assetId ID of the asset that is being added
+     * @param replacesAssetWithId ID of the asset that this asset is attempting to replace
+     */
+    function _beforeAddAssetToToken(
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 replacesAssetWithId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after an asset has been added to a token's pending assets array.
+     * @dev If the asset doesn't intend to replace another asset, the `replacesAssetWithId` value should be `0`.
+     * @param tokenId ID of the token to which the asset is has been added
+     * @param assetId ID of the asset that is has been added
+     * @param replacesAssetWithId ID of the asset that this asset is attempting to replace
+     */
+    function _afterAddAssetToToken(
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 replacesAssetWithId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before an asset is accepted to a token's active assets array.
+     * @param tokenId ID of the token for which the asset is being accepted
+     * @param index Index of the asset in the token's pending assets array
+     * @param assetId ID of the asset expected to be located at the specified `index`
+     */
+    function _beforeAcceptAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint256 assetId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after an asset is accepted to a token's active assets array.
+     * @param tokenId ID of the token for which the asset has been accepted
+     * @param index Index of the asset in the token's pending assets array
+     * @param assetId ID of the asset expected to have been located at the specified `index`
+     */
+    function _afterAcceptAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint256 assetId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before rejecting an asset.
+     * @param tokenId ID of the token from which the asset is being rejected
+     * @param index Index of the asset in the token's pending assets array
+     * @param assetId ID of the asset expected to be located at the specified `index`
+     */
+    function _beforeRejectAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint256 assetId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after rejecting an asset.
+     * @param tokenId ID of the token from which the asset has been rejected
+     * @param index Index of the asset in the token's pending assets array
+     * @param assetId ID of the asset expected to have been located at the specified `index`
+     */
+    function _afterRejectAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint256 assetId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before rejecting all assets of a token.
+     * @param tokenId ID of the token from which all of the assets are being rejected
+     */
+    function _beforeRejectAllAssets(uint256 tokenId) internal virtual {}
+
+    /**
+     * @notice Hook that is called after rejecting all assets of a token.
+     * @param tokenId ID of the token from which all of the assets have been rejected
+     */
+    function _afterRejectAllAssets(uint256 tokenId) internal virtual {}
+
+    /**
+     * @notice Hook that is called before the priorities for token's assets is set.
+     * @param tokenId ID of the token for which the asset priorities are being set
+     * @param priorities[] An array of priorities for token's active resources
+     */
+    function _beforeSetPriority(
+        uint256 tokenId,
+        uint16[] calldata priorities
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after the priorities for token's assets is set.
+     * @param tokenId ID of the token for which the asset priorities have been set
+     * @param priorities[] An array of priorities for token's active resources
+     */
+    function _afterSetPriority(
+        uint256 tokenId,
+        uint16[] calldata priorities
+    ) internal virtual {}
+
+    // --------------------- NESTABLE HOOKS ---------------------
+
+    /**
+     * @notice Hook that is called before any token transfer. This includes minting and burning.
+     * @dev Calling conditions:
+     *
+     *  - When `from` and `to` are both non-zero, ``from``'s `tokenId` will be transferred to `to`.
+     *  - When `from` is zero, `tokenId` will be minted to `to`.
+     *  - When `to` is zero, ``from``'s `tokenId` will be burned.
+     *  - `from` and `to` are never zero at the same time.
+     *
+     *  To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param from Address from which the token is being transferred
+     * @param to Address to which the token is being transferred
+     * @param tokenId ID of the token being transferred
+     */
+    function _beforeTokenTransfer(
+        address from,
+        address to,
+        uint256 tokenId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after any transfer of tokens. This includes minting and burning.
+     * @dev Calling conditions:
+     *
+     *  - When `from` and `to` are both non-zero.
+     *  - `from` and `to` are never zero at the same time.
+     *
+     *  To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param from Address from which the token has been transferred
+     * @param to Address to which the token has been transferred
+     * @param tokenId ID of the token that has been transferred
+     */
+    function _afterTokenTransfer(
+        address from,
+        address to,
+        uint256 tokenId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before nested token transfer.
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param from Address from which the token is being transferred
+     * @param to Address to which the token is being transferred
+     * @param fromTokenId ID of the token from which the given token is being transferred
+     * @param toTokenId ID of the token to which the given token is being transferred
+     * @param tokenId ID of the token being transferred
+     */
+    function _beforeNestedTokenTransfer(
+        address from,
+        address to,
+        uint256 fromTokenId,
+        uint256 toTokenId,
+        uint256 tokenId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after nested token transfer.
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param from Address from which the token was transferred
+     * @param to Address to which the token was transferred
+     * @param fromTokenId ID of the token from which the given token was transferred
+     * @param toTokenId ID of the token to which the given token was transferred
+     * @param tokenId ID of the token that was transferred
+     */
+    function _afterNestedTokenTransfer(
+        address from,
+        address to,
+        uint256 fromTokenId,
+        uint256 toTokenId,
+        uint256 tokenId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before a child is added to the pending tokens array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that will receive a new pending child token
+     * @param childAddress Address of the collection smart contract of the child token expected to be located at the
+     *  specified index of the given parent token's pending children array
+     * @param childId ID of the child token expected to be located at the specified index of the given parent token's
+     *  pending children array
+     */
+    function _beforeAddChild(
+        uint256 tokenId,
+        address childAddress,
+        uint256 childId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after a child is added to the pending tokens array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that has received a new pending child token
+     * @param childAddress Address of the collection smart contract of the child token expected to be located at the
+     *  specified index of the given parent token's pending children array
+     * @param childId ID of the child token expected to be located at the specified index of the given parent token's
+     *  pending children array
+     */
+    function _afterAddChild(
+        uint256 tokenId,
+        address childAddress,
+        uint256 childId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before a child is accepted to the active tokens array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param parentId ID of the token that will accept a pending child token
+     * @param childIndex Index of the child token to accept in the given parent token's pending children array
+     * @param childAddress Address of the collection smart contract of the child token expected to be located at the
+     *  specified index of the given parent token's pending children array
+     * @param childId ID of the child token expected to be located at the specified index of the given parent token's
+     *  pending children array
+     */
+    function _beforeAcceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after a child is accepted to the active tokens array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param parentId ID of the token that has accepted a pending child token
+     * @param childIndex Index of the child token that was accpeted in the given parent token's pending children array
+     * @param childAddress Address of the collection smart contract of the child token that was expected to be located
+     *  at the specified index of the given parent token's pending children array
+     * @param childId ID of the child token that was expected to be located at the specified index of the given parent
+     *  token's pending children array
+     */
+    function _afterAcceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before a child is transferred from a given child token array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that will transfer a child token
+     * @param childIndex Index of the child token that will be transferred from the given parent token's children array
+     * @param childAddress Address of the collection smart contract of the child token that is expected to be located
+     *  at the specified index of the given parent token's children array
+     * @param childId ID of the child token that is expected to be located at the specified index of the given parent
+     *  token's children array
+     * @param isPending A boolean value signifying whether the child token is being transferred from the pending child
+     *  tokens array (`true`) or from the active child tokens array (`false`)
+     */
+    function _beforeTransferChild(
+        uint256 tokenId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called after a child is transferred from a given child token array of a given token.
+     * @dev The Child struct consists of the following values:
+     *  [
+     *      tokenId,
+     *      contractAddress
+     *  ]
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that has transferred a child token
+     * @param childIndex Index of the child token that was transferred from the given parent token's children array
+     * @param childAddress Address of the collection smart contract of the child token that was expected to be located
+     *  at the specified index of the given parent token's children array
+     * @param childId ID of the child token that was expected to be located at the specified index of the given parent
+     *  token's children array
+     * @param isPending A boolean value signifying whether the child token was transferred from the pending child tokens
+     *  array (`true`) or from the active child tokens array (`false`)
+     */
+    function _afterTransferChild(
+        uint256 tokenId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending
+    ) internal virtual {}
+
+    /**
+     * @notice Hook that is called before a pending child tokens array of a given token is cleared.
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that will reject all of the pending child tokens
+     */
+    function _beforeRejectAllChildren(uint256 tokenId) internal virtual {}
+
+    /**
+     * @notice Hook that is called after a pending child tokens array of a given token is cleared.
+     * @dev To learn more about hooks, head to xref:ROOT:extending-contracts.adoc#using-hooks[Using Hooks].
+     * @param tokenId ID of the token that has rejected all of the pending child tokens
+     */
+    function _afterRejectAllChildren(uint256 tokenId) internal virtual {}
+
+    // --------------------- EQUIPPABLE HOOKS ---------------------
+
+    /**
+     * @notice A hook to be called before a equipping a asset to the token.
+     * @dev The `IntakeEquip` struct consist of the following data:
+     *  [
+     *      tokenId,
+     *      childIndex,
+     *      assetId,
+     *      slotPartId,
+     *      childAssetId
+     *  ]
+     * @param data The `IntakeEquip` struct containing data of the asset that is being equipped
+     */
+    function _beforeEquip(IntakeEquip memory data) internal virtual {}
+
+    /**
+     * @notice A hook to be called after equipping a asset to the token.
+     * @dev The `IntakeEquip` struct consist of the following data:
+     *  [
+     *      tokenId,
+     *      childIndex,
+     *      assetId,
+     *      slotPartId,
+     *      childAssetId
+     *  ]
+     * @param data The `IntakeEquip` struct containing data of the asset that was equipped
+     */
+    function _afterEquip(IntakeEquip memory data) internal virtual {}
+
+    /**
+     * @notice A hook to be called before unequipping a asset from the token.
+     * @param tokenId ID of the token from which the asset is being unequipped
+     * @param assetId ID of the asset being unequipped
+     * @param slotPartId ID of the slot from which the asset is being unequipped
+     */
+    function _beforeUnequip(
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 slotPartId
+    ) internal virtual {}
+
+    /**
+     * @notice A hook to be called after unequipping a asset from the token.
+     * @param tokenId ID of the token from which the asset was unequipped
+     * @param assetId ID of the asset that was unequipped
+     * @param slotPartId ID of the slot from which the asset was unequipped
+     */
+    function _afterUnequip(
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 slotPartId
+    ) internal virtual {}
+}
diff --git a/assets/eip-6220/contracts/ICatalog.sol b/assets/eip-6220/contracts/ICatalog.sol
new file mode 100644
index 00000000000000..ba91ebb7584fc1
--- /dev/null
+++ b/assets/eip-6220/contracts/ICatalog.sol
@@ -0,0 +1,160 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+
+/**
+ * @title ICatalog
+ * @author RMRK team
+ * @notice An interface Catalog for equippable module.
+ */
+interface ICatalog is IERC165 {
+    /**
+     * @notice Event to announce addition of a new part.
+     * @dev It is emitted when a new part is added.
+     * @param partId ID of the part that was added
+     * @param itemType Enum value specifying whether the part is `None`, `Slot` and `Fixed`
+     * @param zIndex An uint specifying the z value of the part. It is used to specify the depth which the part should
+     *  be rendered at
+     * @param equippableAddresses An array of addresses that can equip this part
+     * @param metadataURI The metadata URI of the part
+     */
+    event AddedPart(
+        uint64 indexed partId,
+        ItemType indexed itemType,
+        uint8 zIndex,
+        address[] equippableAddresses,
+        string metadataURI
+    );
+
+    /**
+     * @notice Event to announce new equippables to the part.
+     * @dev It is emitted when new addresses are marked as equippable for `partId`.
+     * @param partId ID of the part that had new equippable addresses added
+     * @param equippableAddresses An array of the new addresses that can equip this part
+     */
+    event AddedEquippables(
+        uint64 indexed partId,
+        address[] equippableAddresses
+    );
+
+    /**
+     * @notice Event to announce the overriding of equippable addresses of the part.
+     * @dev It is emitted when the existing list of addresses marked as equippable for `partId` is overwritten by a new
+     *  one.
+     * @param partId ID of the part whose list of equippable addresses was overwritten
+     * @param equippableAddresses The new, full, list of addresses that can equip this part
+     */
+    event SetEquippables(uint64 indexed partId, address[] equippableAddresses);
+
+    /**
+     * @notice Event to announce that a given part can be equipped by any address.
+     * @dev It is emitted when a given part is marked as equippable by any.
+     * @param partId ID of the part marked as equippable by any address
+     */
+    event SetEquippableToAll(uint64 indexed partId);
+
+    /**
+     * @notice Used to define a type of the item. Possible values are `None`, `Slot` or `Fixed`.
+     * @dev Used for fixed and slot parts.
+     */
+    enum ItemType {
+        None,
+        Slot,
+        Fixed
+    }
+
+    /**
+     * @notice The integral structure of a standard RMRK catalog item defining it.
+     * @dev Requires a minimum of 3 storage slots per catalog item, equivalent to roughly 60,000 gas as of Berlin hard fork
+     *  (April 14, 2021), though 5-7 storage slots is more realistic, given the standard length of an IPFS URI. This
+     *  will result in between 25,000,000 and 35,000,000 gas per 250 assets--the maximum block size of Ethereum
+     *  mainnet is 30M at peak usage.
+     * @return itemType The item type of the part
+     * @return z The z value of the part defining how it should be rendered when presenting the full NFT
+     * @return equippable The array of addresses allowed to be equipped in this part
+     * @return metadataURI The metadata URI of the part
+     */
+    struct Part {
+        ItemType itemType; //1 byte
+        uint8 z; //1 byte
+        address[] equippable; //n Collections that can be equipped into this slot
+        string metadataURI; //n bytes 32+
+    }
+
+    /**
+     * @notice The structure used to add a new `Part`.
+     * @dev The part is added with specified ID, so you have to make sure that you are using an unused `partId`,
+     *  otherwise the addition of the part vill be reverted.
+     * @dev The full `IntakeStruct` looks like this:
+     *  [
+     *          partID,
+     *      [
+     *          itemType,
+     *          z,
+     *          [
+     *               permittedCollectionAddress0,
+     *               permittedCollectionAddress1,
+     *               permittedCollectionAddress2
+     *           ],
+     *           metadataURI
+     *       ]
+     *   ]
+     * @return partId ID to be assigned to the `Part`
+     * @return part A `Part` to be added
+     */
+    struct IntakeStruct {
+        uint64 partId;
+        Part part;
+    }
+
+    /**
+     * @notice Used to return the metadata URI of the associated catalog.
+     * @return string Base metadata URI
+     */
+    function getMetadataURI() external view returns (string memory);
+
+    /**
+     * @notice Used to return the `itemType` of the associated catalog
+     * @return string `itemType` of the associated catalog
+     */
+    function getType() external view returns (string memory);
+
+    /**
+     * @notice Used to check whether the given address is allowed to equip the desired `Part`.
+     * @dev Returns true if a collection may equip asset with `partId`.
+     * @param partId The ID of the part that we are checking
+     * @param targetAddress The address that we are checking for whether the part can be equipped into it or not
+     * @return bool The status indicating whether the `targetAddress` can be equipped into `Part` with `partId` or not
+     */
+    function checkIsEquippable(uint64 partId, address targetAddress)
+        external
+        view
+        returns (bool);
+
+    /**
+     * @notice Used to check if the part is equippable by all addresses.
+     * @dev Returns true if part is equippable to all.
+     * @param partId ID of the part that we are checking
+     * @return bool The status indicating whether the part with `partId` can be equipped by any address or not
+     */
+    function checkIsEquippableToAll(uint64 partId) external view returns (bool);
+
+    /**
+     * @notice Used to retrieve a `Part` with id `partId`
+     * @param partId ID of the part that we are retrieving
+     * @return struct The `Part` struct associated with given `partId`
+     */
+    function getPart(uint64 partId) external view returns (Part memory);
+
+    /**
+     * @notice Used to retrieve multiple parts at the same time.
+     * @param partIds An array of part IDs that we want to retrieve
+     * @return struct An array of `Part` structs associated with given `partIds`
+     */
+    function getParts(uint64[] calldata partIds)
+        external
+        view
+        returns (Part[] memory);
+}
diff --git a/assets/eip-6220/contracts/IERC5773.sol b/assets/eip-6220/contracts/IERC5773.sol
new file mode 100644
index 00000000000000..de7515c088c1ad
--- /dev/null
+++ b/assets/eip-6220/contracts/IERC5773.sol
@@ -0,0 +1,92 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.0;
+
+interface IERC5773 {
+    event AssetSet(uint64 assetId);
+
+    event AssetAddedToToken(
+        uint256 indexed tokenId,
+        uint64 indexed assetId,
+        uint64 indexed replacesId
+    );
+
+    event AssetAccepted(
+        uint256 indexed tokenId,
+        uint64 indexed assetId,
+        uint64 indexed replacesId
+    );
+
+    event AssetRejected(uint256 indexed tokenId, uint64 indexed assetId);
+
+    event AssetPrioritySet(uint256 indexed tokenId);
+
+    event ApprovalForAssets(
+        address indexed owner,
+        address indexed approved,
+        uint256 indexed tokenId
+    );
+
+    event ApprovalForAllForAssets(
+        address indexed owner,
+        address indexed operator,
+        bool approved
+    );
+
+    function acceptAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint64 assetId
+    ) external;
+
+    function rejectAsset(
+        uint256 tokenId,
+        uint256 index,
+        uint64 assetId
+    ) external;
+
+    function rejectAllAssets(uint256 tokenId, uint256 maxRejections) external;
+
+    function setPriority(
+        uint256 tokenId,
+        uint16[] calldata priorities
+    ) external;
+
+    function getActiveAssets(
+        uint256 tokenId
+    ) external view returns (uint64[] memory);
+
+    function getPendingAssets(
+        uint256 tokenId
+    ) external view returns (uint64[] memory);
+
+    function getActiveAssetPriorities(
+        uint256 tokenId
+    ) external view returns (uint16[] memory);
+
+    function getAssetReplacements(
+        uint256 tokenId,
+        uint64 newAssetId
+    ) external view returns (uint64);
+
+    function getAssetMetadata(
+        uint256 tokenId,
+        uint64 assetId
+    ) external view returns (string memory);
+
+    function approveForAssets(address to, uint256 tokenId) external;
+
+    function getApprovedForAssets(
+        uint256 tokenId
+    ) external view returns (address);
+
+    function setApprovalForAllForAssets(
+        address operator,
+        bool approved
+    ) external;
+
+    function isApprovedForAllForAssets(
+        address owner,
+        address operator
+    ) external view returns (bool);
+}
diff --git a/assets/eip-6220/contracts/IERC6059.sol b/assets/eip-6220/contracts/IERC6059.sol
new file mode 100644
index 00000000000000..dbad8969f5f4df
--- /dev/null
+++ b/assets/eip-6220/contracts/IERC6059.sol
@@ -0,0 +1,114 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+interface IERC6059 {
+    struct DirectOwner {
+        uint256 tokenId;
+        address ownerAddress;
+        bool isNft;
+    }
+
+    event NestTransfer(
+        address indexed from,
+        address indexed to,
+        uint256 fromTokenId,
+        uint256 toTokenId,
+        uint256 indexed tokenId
+    );
+
+    event ChildProposed(
+        uint256 indexed tokenId,
+        uint256 childIndex,
+        address indexed childAddress,
+        uint256 indexed childId
+    );
+
+    event ChildAccepted(
+        uint256 indexed tokenId,
+        uint256 childIndex,
+        address indexed childAddress,
+        uint256 indexed childId
+    );
+
+    event AllChildrenRejected(uint256 indexed tokenId);
+
+    event ChildTransferred(
+        uint256 indexed tokenId,
+        uint256 childIndex,
+        address indexed childAddress,
+        uint256 indexed childId,
+        bool fromPending
+    );
+
+    struct Child {
+        uint256 tokenId;
+        address contractAddress;
+    }
+
+    function ownerOf(uint256 tokenId) external view returns (address owner);
+
+    function directOwnerOf(
+        uint256 tokenId
+    ) external view returns (address, uint256, bool);
+
+    function burn(
+        uint256 tokenId,
+        uint256 maxRecursiveBurns
+    ) external returns (uint256);
+
+    function addChild(
+        uint256 parentId,
+        uint256 childId,
+        bytes memory data
+    ) external;
+
+    function acceptChild(
+        uint256 parentId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId
+    ) external;
+
+    function rejectAllChildren(
+        uint256 parentId,
+        uint256 maxRejections
+    ) external;
+
+    function transferChild(
+        uint256 tokenId,
+        address to,
+        uint256 destinationId,
+        uint256 childIndex,
+        address childAddress,
+        uint256 childId,
+        bool isPending,
+        bytes memory data
+    ) external;
+
+    function childrenOf(
+        uint256 parentId
+    ) external view returns (Child[] memory);
+
+    function pendingChildrenOf(
+        uint256 parentId
+    ) external view returns (Child[] memory);
+
+    function childOf(
+        uint256 parentId,
+        uint256 index
+    ) external view returns (Child memory);
+
+    function pendingChildOf(
+        uint256 parentId,
+        uint256 index
+    ) external view returns (Child memory);
+
+    function nestTransferFrom(
+        address from,
+        address to,
+        uint256 tokenId,
+        uint256 destinationId,
+        bytes memory data
+    ) external;
+}
diff --git a/assets/eip-6220/contracts/IEquippable.sol b/assets/eip-6220/contracts/IEquippable.sol
new file mode 100644
index 00000000000000..72edc119dadd3b
--- /dev/null
+++ b/assets/eip-6220/contracts/IEquippable.sol
@@ -0,0 +1,194 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "./IERC5773.sol";
+
+/**
+ * @title IEquippable
+ * @author RMRK team
+ * @notice Interface smart contract of the equippable module.
+ */
+interface IEquippable is IERC5773 {
+    /**
+     * @notice Used to store the core structure of the `Equippable` component.
+     * @return assetId The ID of the asset equipping a child
+     * @return childAssetId The ID of the asset used as equipment
+     * @return childId The ID of token that is equipped
+     * @return childEquippableAddress Address of the collection to which the child asset belongs to
+     */
+    struct Equipment {
+        uint64 assetId;
+        uint64 childAssetId;
+        uint256 childId;
+        address childEquippableAddress;
+    }
+
+    /**
+     * @notice Used to provide a struct for inputing equip data.
+     * @dev Only used for input and not storage of data.
+     * @return tokenId ID of the token we are managing
+     * @return childIndex Index of a child in the list of token's active children
+     * @return assetId ID of the asset that we are equipping into
+     * @return slotPartId ID of the slot part that we are using to equip
+     * @return childAssetId ID of the asset that we are equipping
+     */
+    struct IntakeEquip {
+        uint256 tokenId;
+        uint256 childIndex;
+        uint64 assetId;
+        uint64 slotPartId;
+        uint64 childAssetId;
+    }
+
+    /**
+     * @notice Used to notify listeners that a child's asset has been equipped into one of its parent assets.
+     * @param tokenId ID of the token that had an asset equipped
+     * @param assetId ID of the asset associated with the token we are equipping into
+     * @param slotPartId ID of the slot we are using to equip
+     * @param childId ID of the child token we are equipping into the slot
+     * @param childAddress Address of the child token's collection
+     * @param childAssetId ID of the asset associated with the token we are equipping
+     */
+    event ChildAssetEquipped(
+        uint256 indexed tokenId,
+        uint64 indexed assetId,
+        uint64 indexed slotPartId,
+        uint256 childId,
+        address childAddress,
+        uint64 childAssetId
+    );
+
+    /**
+     * @notice Used to notify listeners that a child's asset has been unequipped from one of its parent assets.
+     * @param tokenId ID of the token that had an asset unequipped
+     * @param assetId ID of the asset associated with the token we are unequipping out of
+     * @param slotPartId ID of the slot we are unequipping from
+     * @param childId ID of the token being unequipped
+     * @param childAddress Address of the collection that a token that is being unequipped belongs to
+     * @param childAssetId ID of the asset associated with the token we are unequipping
+     */
+    event ChildAssetUnequipped(
+        uint256 indexed tokenId,
+        uint64 indexed assetId,
+        uint64 indexed slotPartId,
+        uint256 childId,
+        address childAddress,
+        uint64 childAssetId
+    );
+
+    /**
+     * @notice Used to notify listeners that the assets belonging to a `equippableGroupId` have been marked as
+     *  equippable into a given slot and parent
+     * @param equippableGroupId ID of the equippable group being marked as equippable into the slot associated with
+     *  `slotPartId` of the `parentAddress` collection
+     * @param slotPartId ID of the slot part of the catalog into which the parts belonging to the equippable group
+     *  associated with `equippableGroupId` can be equipped
+     * @param parentAddress Address of the collection into which the parts belonging to `equippableGroupId` can be
+     *  equipped
+     */
+    event ValidParentEquippableGroupIdSet(
+        uint64 indexed equippableGroupId,
+        uint64 indexed slotPartId,
+        address parentAddress
+    );
+
+    /**
+     * @notice Used to equip a child into a token.
+     * @dev The `IntakeEquip` stuct contains the following data:
+     *  [
+     *      tokenId,
+     *      childIndex,
+     *      assetId,
+     *      slotPartId,
+     *      childAssetId
+     *  ]
+     * @param data An `IntakeEquip` struct specifying the equip data
+     */
+    function equip(
+        IntakeEquip memory data
+    ) external;
+
+    /**
+     * @notice Used to unequip child from parent token.
+     * @dev This can only be called by the owner of the token or by an account that has been granted permission to
+     *  manage the given token by the current owner.
+     * @param tokenId ID of the parent from which the child is being unequipped
+     * @param assetId ID of the parent's asset that contains the `Slot` into which the child is equipped
+     * @param slotPartId ID of the `Slot` from which to unequip the child
+     */
+    function unequip(
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 slotPartId
+    ) external;
+
+    /**
+     * @notice Used to check whether the token has a given child equipped.
+     * @dev This is used to prevent from transferring a child that is equipped.
+     * @param tokenId ID of the parent token for which we are querying for
+     * @param childAddress Address of the child token's smart contract
+     * @param childId ID of the child token
+     * @return bool The boolean value indicating whether the child token is equipped into the given token or not
+     */
+    function isChildEquipped(
+        uint256 tokenId,
+        address childAddress,
+        uint256 childId
+    ) external view returns (bool);
+
+    /**
+     * @notice Used to verify whether a token can be equipped into a given parent's slot.
+     * @param parent Address of the parent token's smart contract
+     * @param tokenId ID of the token we want to equip
+     * @param assetId ID of the asset associated with the token we want to equip
+     * @param slotId ID of the slot that we want to equip the token into
+     * @return bool The boolean indicating whether the token with the given asset can be equipped into the desired
+     *  slot
+     */
+    function canTokenBeEquippedWithAssetIntoSlot(
+        address parent,
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 slotId
+    ) external view returns (bool);
+
+    /**
+     * @notice Used to get the Equipment object equipped into the specified slot of the desired token.
+     * @dev The `Equipment` struct consists of the following data:
+     *  [
+     *      assetId,
+     *      childAssetId,
+     *      childId,
+     *      childEquippableAddress
+     *  ]
+     * @param tokenId ID of the token for which we are retrieving the equipped object
+     * @param targetCatalogAddress Address of the `Catalog` associated with the `Slot` part of the token
+     * @param slotPartId ID of the `Slot` part that we are checking for equipped objects
+     * @return struct The `Equipment` struct containing data about the equipped object
+     */
+    function getEquipment(
+        uint256 tokenId,
+        address targetCatalogAddress,
+        uint64 slotPartId
+    ) external view returns (Equipment memory);
+
+    /**
+     * @notice Used to get the asset and equippable data associated with given `assetId`.
+     * @param tokenId ID of the token for which to retrieve the asset
+     * @param assetId ID of the asset of which we are retrieving
+     * @return metadataURI The metadata URI of the asset
+     * @return equippableGroupId ID of the equippable group this asset belongs to
+     * @return catalogAddress The address of the catalog the part belongs to
+     * @return partIds An array of IDs of parts included in the asset
+     */
+    function getAssetAndEquippableData(uint256 tokenId, uint64 assetId)
+        external
+        view
+        returns (
+            string memory metadataURI,
+            uint64 equippableGroupId,
+            address catalogAddress,
+            uint64[] calldata partIds
+        );
+}
diff --git a/assets/eip-6220/contracts/library/EquippableLib.sol b/assets/eip-6220/contracts/library/EquippableLib.sol
new file mode 100644
index 00000000000000..1ae233ab71b1ae
--- /dev/null
+++ b/assets/eip-6220/contracts/library/EquippableLib.sol
@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.0;
+
+library EquippableLib {
+    function indexOf(
+        uint64[] memory A,
+        uint64 a
+    ) internal pure returns (uint256, bool) {
+        uint256 length = A.length;
+        for (uint256 i; i < length; ) {
+            if (A[i] == a) {
+                return (i, true);
+            }
+            unchecked {
+                ++i;
+            }
+        }
+        return (0, false);
+    }
+
+    //For reasource storage array
+    function removeItemByIndex(uint64[] storage array, uint256 index) internal {
+        //Check to see if this is already gated by require in all calls
+        require(index < array.length);
+        array[index] = array[array.length - 1];
+        array.pop();
+    }
+}
diff --git a/assets/eip-6220/contracts/mocks/CatalogMock.sol b/assets/eip-6220/contracts/mocks/CatalogMock.sol
new file mode 100644
index 00000000000000..106762aaf3c5e2
--- /dev/null
+++ b/assets/eip-6220/contracts/mocks/CatalogMock.sol
@@ -0,0 +1,41 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "../Catalog.sol";
+
+contract CatalogMock is Catalog {
+    constructor(string memory metadataURI, string memory type_)
+        Catalog(metadataURI, type_)
+    {}
+
+    function addPart(IntakeStruct calldata intakeStruct) external {
+        _addPart(intakeStruct);
+    }
+
+    function addPartList(IntakeStruct[] calldata intakeStructs) external {
+        _addPartList(intakeStructs);
+    }
+
+    function addEquippableAddresses(
+        uint64 partId,
+        address[] calldata equippableAddresses
+    ) external {
+        _addEquippableAddresses(partId, equippableAddresses);
+    }
+
+    function setEquippableAddresses(
+        uint64 partId,
+        address[] calldata equippableAddresses
+    ) external {
+        _setEquippableAddresses(partId, equippableAddresses);
+    }
+
+    function setEquippableToAll(uint64 partId) external {
+        _setEquippableToAll(partId);
+    }
+
+    function resetEquippableAddresses(uint64 partId) external {
+        _resetEquippableAddresses(partId);
+    }
+}
diff --git a/assets/eip-6220/contracts/mocks/ERC721Mock.sol b/assets/eip-6220/contracts/mocks/ERC721Mock.sol
new file mode 100644
index 00000000000000..995868858e680b
--- /dev/null
+++ b/assets/eip-6220/contracts/mocks/ERC721Mock.sol
@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+
+/**
+ * @title ERC721Mock
+ * Used for tests with non ERC721 implementer
+ */
+contract ERC721Mock is ERC721 {
+    constructor(
+        string memory name,
+        string memory symbol
+    ) ERC721(name, symbol) {}
+}
diff --git a/assets/eip-6220/contracts/mocks/ERC721ReceiverMock.sol b/assets/eip-6220/contracts/mocks/ERC721ReceiverMock.sol
new file mode 100644
index 00000000000000..1f0665b8c304ca
--- /dev/null
+++ b/assets/eip-6220/contracts/mocks/ERC721ReceiverMock.sol
@@ -0,0 +1,16 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.15;
+
+contract ERC721ReceiverMock {
+    bytes4 constant ERC721_RECEIVED = 0x150b7a02;
+
+    function onERC721Received(
+        address,
+        address,
+        uint256,
+        bytes calldata
+    ) public returns (bytes4) {
+        return ERC721_RECEIVED;
+    }
+}
diff --git a/assets/eip-6220/contracts/mocks/EquippableTokenMock.sol b/assets/eip-6220/contracts/mocks/EquippableTokenMock.sol
new file mode 100644
index 00000000000000..243be8340f6b90
--- /dev/null
+++ b/assets/eip-6220/contracts/mocks/EquippableTokenMock.sol
@@ -0,0 +1,100 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "../EquippableToken.sol";
+
+//Minimal public implementation of INestable for testing.
+contract EquippableTokenMock is EquippableToken {
+    address private _issuer;
+
+    constructor() EquippableToken() {
+        _setIssuer(_msgSender());
+    }
+
+    modifier onlyIssuer() {
+        require(_msgSender() == _issuer, "RMRK: Only issuer");
+        _;
+    }
+
+    function setIssuer(address issuer) external onlyIssuer {
+        _setIssuer(issuer);
+    }
+
+    function _setIssuer(address issuer) private {
+        _issuer = issuer;
+    }
+
+    function getIssuer() external view returns (address) {
+        return _issuer;
+    }
+
+    function mint(address to, uint256 tokenId) external onlyIssuer {
+        _mint(to, tokenId);
+    }
+
+    function nestMint(
+        address to,
+        uint256 tokenId,
+        uint256 destinationId
+    ) external {
+        _nestMint(to, tokenId, destinationId, "");
+    }
+
+    // Utility transfers:
+
+    function transfer(address to, uint256 tokenId) public virtual {
+        transferFrom(_msgSender(), to, tokenId);
+    }
+
+    function nestTransfer(
+        address to,
+        uint256 tokenId,
+        uint256 destinationId
+    ) public virtual {
+        nestTransferFrom(_msgSender(), to, tokenId, destinationId, "");
+    }
+
+    function addAssetToToken(
+        uint256 tokenId,
+        uint64 assetId,
+        uint64 replacesAssetWithId
+    ) external onlyIssuer {
+        _addAssetToToken(tokenId, assetId, replacesAssetWithId);
+    }
+
+    function addAssetEntry(
+        uint64 id,
+        string memory metadataURI
+    ) external onlyIssuer {
+        _addAssetEntry(id, metadataURI);
+    }
+
+    function addEquippableAssetEntry(
+        uint64 id,
+        uint64 equippableGroupId,
+        address catalogAddress,
+        string memory metadataURI,
+        uint64[] calldata partIds
+    ) external onlyIssuer {
+        _addAssetEntry(
+            id,
+            equippableGroupId,
+            catalogAddress,
+            metadataURI,
+            partIds
+        );
+    }
+
+    function setValidParentForEquippableGroup(
+        uint64 equippableGroupId,
+        address parentAddress,
+        uint64 partId
+    ) external {
+        _setValidParentForEquippableGroup(
+            equippableGroupId,
+            parentAddress,
+            partId
+        );
+    }
+}
diff --git a/assets/eip-6220/contracts/mocks/NonReceiverMock.sol b/assets/eip-6220/contracts/mocks/NonReceiverMock.sol
new file mode 100644
index 00000000000000..e9d2d6ed3ecb2e
--- /dev/null
+++ b/assets/eip-6220/contracts/mocks/NonReceiverMock.sol
@@ -0,0 +1,7 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.15;
+
+contract NonReceiverMock {
+    function dummy() external {}
+}
diff --git a/assets/eip-6220/contracts/security/ReentrancyGuard.sol b/assets/eip-6220/contracts/security/ReentrancyGuard.sol
new file mode 100644
index 00000000000000..5fab06e46f0c5c
--- /dev/null
+++ b/assets/eip-6220/contracts/security/ReentrancyGuard.sol
@@ -0,0 +1,77 @@
+// SPDX-License-Identifier: MIT
+// OpenZeppelin Contracts v4.4.1 (security/ReentrancyGuard.sol)
+
+pragma solidity ^0.8.16;
+
+error RentrantCall();
+
+/**
+ * @title ReentrancyGuard
+ * @notice Smart contract used to guard against potential reentrancy exploits.
+ * @dev Contract module that helps prevent reentrant calls to a function.
+ *
+ * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
+ * available, which can be applied to functions to make sure there are no nested
+ * (reentrant) calls to them.
+ *
+ * Note that because there is a single `nonReentrant` guard, functions marked as
+ * `nonReentrant` may not call one another. This can be worked around by making
+ * those functions `private`, and then adding `external` `nonReentrant` entry
+ * points to them.
+ *
+ * TIP: If you would like to learn more about reentrancy and alternative ways
+ * to protect against it, check out our blog post
+ * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
+ */
+abstract contract ReentrancyGuard {
+    // Booleans are more expensive than uint256 or any type that takes up a full
+    // word because each write operation emits an extra SLOAD to first read the
+    // slot's contents, replace the bits taken up by the boolean, and then write
+    // back. This is the compiler's defense against contract upgrades and
+    // pointer aliasing, and it cannot be disabled.
+
+    // The values being non-zero value makes deployment a bit more expensive,
+    // but in exchange the refund on every call to nonReentrant will be lower in
+    // amount. Since refunds are capped to a percentage of the total
+    // transaction's gas, it is best to keep them low in cases like this one, to
+    // increase the likelihood of the full refund coming into effect.
+    uint256 private constant _NOT_ENTERED = 1;
+    uint256 private constant _ENTERED = 2;
+
+    uint256 private _status;
+
+    /**
+     * @notice Initializes the ReentrancyGuard with the `_status` of `_NOT_ENTERED`.
+     */
+    constructor() {
+        _status = _NOT_ENTERED;
+    }
+
+    /**
+     * @notice Used to ensure that the function it is applied to cannot be reentered.
+     * @dev Prevents a contract from calling itself, directly or indirectly.
+     * Calling a `nonReentrant` function from another `nonReentrant`
+     * function is not supported. It is possible to prevent this from happening
+     * by making the `nonReentrant` function external, and making it call a
+     * `private` function that does the actual work.
+     */
+    modifier nonReentrant() {
+        _nonReentrantIn();
+        _;
+        // By storing the original value once again, a refund is triggered (see
+        // https://eips.ethereum.org/EIPS/eip-2200)
+        _status = _NOT_ENTERED;
+    }
+
+    /**
+     * @notice Used to ensure that the current call is not a reentrant call.
+     * @dev If reentrant call is detected, the execution will be reverted.
+     */
+    function _nonReentrantIn() private {
+        // On the first call to nonReentrant, _notEntered will be true
+        if (_status == _ENTERED) revert RentrantCall();
+
+        // Any calls to nonReentrant after this point will fail
+        _status = _ENTERED;
+    }
+}
diff --git a/assets/eip-6220/contracts/utils/EquipRenderUtils.sol b/assets/eip-6220/contracts/utils/EquipRenderUtils.sol
new file mode 100644
index 00000000000000..6637d5a86d8829
--- /dev/null
+++ b/assets/eip-6220/contracts/utils/EquipRenderUtils.sol
@@ -0,0 +1,481 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "../ICatalog.sol";
+import "../IEquippable.sol";
+import "../library/EquippableLib.sol";
+
+error TokenHasNoAssets();
+error NotComposableAsset();
+
+/**
+ * @title EquipRenderUtils
+ * @author RMRK team
+ * @notice Smart contract of the RMRK Equip render utils module.
+ * @dev Extra utility functions for composing RMRK extended assets.
+ */
+contract EquipRenderUtils {
+    using EquippableLib for uint64[];
+
+    /**
+     * @notice The structure used to display a full information of an active asset.
+     * @return id ID of the asset
+     * @return equppableGroupId ID of the equippable group this asset belongs to
+     * @return priority Priority of the asset in the active assets array it belongs to
+     * @return catalogAddress Address of the `Catalog` smart contract this asset belongs to
+     * @return metadata Metadata URI of the asset
+     * @return partIds[] An array of IDs of fixed and slot parts present in the asset
+     */
+    struct ExtendedActiveAsset {
+        uint64 id;
+        uint64 equippableGroupId;
+        uint16 priority;
+        address catalogAddress;
+        string metadata;
+        uint64[] partIds;
+    }
+
+    /**
+     * @notice The structure used to display a full information of a pending asset.
+     * @return id ID of the asset
+     * @return equppableGroupId ID of the equippable group this asset belongs to
+     * @return acceptRejectIndex The index of the given asset in the pending assets array it belongs to
+     * @return replacesAssetWithId ID of the asset the given asset will replace if accepted
+     * @return catalogAddress Address of the `Catalog` smart contract this asset belongs to
+     * @return metadata Metadata URI of the asset
+     * @return partIds[] An array of IDs of fixed and slot parts present in the asset
+     */
+    struct ExtendedPendingAsset {
+        uint64 id;
+        uint64 equippableGroupId;
+        uint128 acceptRejectIndex;
+        uint64 replacesAssetWithId;
+        address catalogAddress;
+        string metadata;
+        uint64[] partIds;
+    }
+
+    /**
+     * @notice The structure used to display a full information of an equippend slot part.
+     * @return partId ID of the slot part
+     * @return childAssetId ID of the child asset equipped into the slot part
+     * @return z The z value of the part defining how it should be rendered when presenting the full NFT
+     * @return childAddress Address of the collection smart contract of the child token equipped into the slot
+     * @return childId ID of the child token equipped into the slot
+     * @return childAssetMetadata Metadata URI of the child token equipped into the slot
+     * @return partMetadata Metadata URI of the given slot part
+     */
+    struct EquippedSlotPart {
+        uint64 partId;
+        uint64 childAssetId;
+        uint8 z; //1 byte
+        address childAddress;
+        uint256 childId;
+        string childAssetMetadata; //n bytes 32+
+        string partMetadata; //n bytes 32+
+    }
+
+    /**
+     * @notice Used to provide data about fixed parts.
+     * @return partId ID of the part
+     * @return z The z value of the asset, specifying how the part should be rendered in a composed NFT
+     * @return matadataURI The metadata URI of the fixed part
+     */
+    struct FixedPart {
+        uint64 partId;
+        uint8 z; //1 byte
+        string metadataURI; //n bytes 32+
+    }
+
+    /**
+     * @notice Used to get extended active assets of the given token.
+     * @dev The full `ExtendedActiveAsset` looks like this:
+     *  [
+     *      ID,
+     *      equippableGroupId,
+     *      priority,
+     *      catalogAddress,
+     *      metadata,
+     *      [
+     *          fixedPartId0,
+     *          fixedPartId1,
+     *          fixedPartId2,
+     *          slotPartId0,
+     *          slotPartId1,
+     *          slotPartId2
+     *      ]
+     *  ]
+     * @param target Address of the smart contract of the given token
+     * @param tokenId ID of the token to retrieve the extended active assets for
+     * @return sturct[] An array of ExtendedActiveAssets present on the given token
+     */
+    function getExtendedActiveAssets(address target, uint256 tokenId)
+        public
+        view
+        virtual
+        returns (ExtendedActiveAsset[] memory)
+    {
+        IEquippable target_ = IEquippable(target);
+
+        uint64[] memory assets = target_.getActiveAssets(tokenId);
+        uint16[] memory priorities = target_.getActiveAssetPriorities(tokenId);
+        uint256 len = assets.length;
+        if (len == 0) {
+            revert TokenHasNoAssets();
+        }
+
+        ExtendedActiveAsset[] memory activeAssets = new ExtendedActiveAsset[](
+            len
+        );
+
+        for (uint256 i; i < len; ) {
+            (
+                string memory metadataURI,
+                uint64 equippableGroupId,
+                address catalogAddress,
+                uint64[] memory partIds
+            ) = target_.getAssetAndEquippableData(tokenId, assets[i]);
+            activeAssets[i] = ExtendedActiveAsset({
+                id: assets[i],
+                equippableGroupId: equippableGroupId,
+                priority: priorities[i],
+                catalogAddress: catalogAddress,
+                metadata: metadataURI,
+                partIds: partIds
+            });
+            unchecked {
+                ++i;
+            }
+        }
+        return activeAssets;
+    }
+
+    /**
+     * @notice Used to get the extended pending assets of the given token.
+     * @dev The full `ExtendedPendingAsset` looks like this:
+     *  [
+     *      ID,
+     *      equippableGroupId,
+     *      acceptRejectIndex,
+     *      replacesAssetWithId,
+     *      catalogAddress,
+     *      metadata,
+     *      [
+     *          fixedPartId0,
+     *          fixedPartId1,
+     *          fixedPartId2,
+     *          slotPartId0,
+     *          slotPartId1,
+     *          slotPartId2
+     *      ]
+     *  ]
+     * @param target Address of the smart contract of the given token
+     * @param tokenId ID of the token to retrieve the extended pending assets for
+     * @return sturct[] An array of ExtendedPendingAssets present on the given token
+     */
+    function getExtendedPendingAssets(address target, uint256 tokenId)
+        public
+        view
+        virtual
+        returns (ExtendedPendingAsset[] memory)
+    {
+        IEquippable target_ = IEquippable(target);
+
+        uint64[] memory assets = target_.getPendingAssets(tokenId);
+        uint256 len = assets.length;
+        if (len == 0) {
+            revert TokenHasNoAssets();
+        }
+
+        ExtendedPendingAsset[]
+            memory pendingAssets = new ExtendedPendingAsset[](len);
+        uint64 replacesAssetWithId;
+        for (uint256 i; i < len; ) {
+            (
+                string memory metadataURI,
+                uint64 equippableGroupId,
+                address catalogAddress,
+                uint64[] memory partIds
+            ) = target_.getAssetAndEquippableData(tokenId, assets[i]);
+            replacesAssetWithId = target_.getAssetReplacements(
+                tokenId,
+                assets[i]
+            );
+            pendingAssets[i] = ExtendedPendingAsset({
+                id: assets[i],
+                equippableGroupId: equippableGroupId,
+                acceptRejectIndex: uint128(i),
+                replacesAssetWithId: replacesAssetWithId,
+                catalogAddress: catalogAddress,
+                metadata: metadataURI,
+                partIds: partIds
+            });
+            unchecked {
+                ++i;
+            }
+        }
+        return pendingAssets;
+    }
+
+    /**
+     * @notice Used to retrieve the equipped parts of the given token.
+     * @dev NOTE: Some of the equipped children might be empty.
+     * @dev The full `Equipment` struct looks like this:
+     *  [
+     *      assetId,
+     *      childAssetId,
+     *      childId,
+     *      childEquippableAddress
+     *  ]
+     * @param target Address of the smart contract of the given token
+     * @param tokenId ID of the token to retrieve the equipped items in the asset for
+     * @param assetId ID of the asset being queried for equipped parts
+     * @return slotPartIds An array of the IDs of the slot parts present in the given asset
+     * @return childrenEquipped An array of `Equipment` structs containing info about the equipped children
+     */
+    function getEquipped(
+        address target,
+        uint64 tokenId,
+        uint64 assetId
+    )
+        public
+        view
+        returns (
+            uint64[] memory slotPartIds,
+            IEquippable.Equipment[] memory childrenEquipped
+        )
+    {
+        IEquippable target_ = IEquippable(target);
+
+        (, , address catalogAddress, uint64[] memory partIds) = target_
+            .getAssetAndEquippableData(tokenId, assetId);
+
+        (slotPartIds, ) = splitSlotAndFixedParts(partIds, catalogAddress);
+        childrenEquipped = new IEquippable.Equipment[](slotPartIds.length);
+
+        uint256 len = slotPartIds.length;
+        for (uint256 i; i < len; ) {
+            IEquippable.Equipment memory equipment = target_.getEquipment(
+                tokenId,
+                catalogAddress,
+                slotPartIds[i]
+            );
+            if (equipment.assetId == assetId) {
+                childrenEquipped[i] = equipment;
+            }
+            unchecked {
+                ++i;
+            }
+        }
+    }
+
+    /**
+     * @notice Used to compose the given equippables.
+     * @dev The full `FixedPart` struct looks like this:
+     *  [
+     *      partId,
+     *      z,
+     *      metadataURI
+     *  ]
+     * @dev The full `EquippedSlotPart` struct looks like this:
+     *  [
+     *      partId,
+     *      childAssetId,
+     *      z,
+     *      childAddress,
+     *      childId,
+     *      childAssetMetadata,
+     *      partMetadata
+     *  ]
+     * @param target Address of the smart contract of the given token
+     * @param tokenId ID of the token to compose the equipped items in the asset for
+     * @param assetId ID of the asset being queried for equipped parts
+     * @return metadataURI Metadata URI of the asset
+     * @return equippableGroupId Equippable group ID of the asset
+     * @return catalogAddress Address of the catalog to which the asset belongs to
+     * @return fixedParts An array of fixed parts respresented by the `FixedPart` structs present on the asset
+     * @return slotParts An array of slot parts represented by the `EquippedSlotPart` structs present on the asset
+     */
+    function composeEquippables(
+        address target,
+        uint256 tokenId,
+        uint64 assetId
+    )
+        public
+        view
+        returns (
+            string memory metadataURI,
+            uint64 equippableGroupId,
+            address catalogAddress,
+            FixedPart[] memory fixedParts,
+            EquippedSlotPart[] memory slotParts
+        )
+    {
+        IEquippable target_ = IEquippable(target);
+        uint64[] memory partIds;
+
+        // If token does not have uint64[] memory slotPartId to save the asset, it would fail here.
+        (metadataURI, equippableGroupId, catalogAddress, partIds) = target_
+            .getAssetAndEquippableData(tokenId, assetId);
+        if (catalogAddress == address(0)) revert NotComposableAsset();
+
+        (
+            uint64[] memory slotPartIds,
+            uint64[] memory fixedPartIds
+        ) = splitSlotAndFixedParts(partIds, catalogAddress);
+
+        // Fixed parts:
+        fixedParts = new FixedPart[](fixedPartIds.length);
+
+        uint256 len = fixedPartIds.length;
+        if (len != 0) {
+            ICatalog.Part[] memory catalogFixedParts = ICatalog(
+                catalogAddress
+            ).getParts(fixedPartIds);
+            for (uint256 i; i < len; ) {
+                fixedParts[i] = FixedPart({
+                    partId: fixedPartIds[i],
+                    z: catalogFixedParts[i].z,
+                    metadataURI: catalogFixedParts[i].metadataURI
+                });
+                unchecked {
+                    ++i;
+                }
+            }
+        }
+
+        slotParts = getEquippedSlotParts(
+            target_,
+            tokenId,
+            assetId,
+            catalogAddress,
+            slotPartIds
+        );
+    }
+
+    /**
+     * @notice Used to retrieve the equipped slot parts.
+     * @dev The full `EquippedSlotPart` struct looks like this:
+     *  [
+     *      partId,
+     *      childAssetId,
+     *      z,
+     *      childAddress,
+     *      childId,
+     *      childAssetMetadata,
+     *      partMetadata
+     *  ]
+     * @param target_ An address of the `IEquippable` smart contract to retrieve the equipped slot parts from.
+     * @param tokenId ID of the token for which to retrieve the equipped slot parts
+     * @param assetId ID of the asset on the token to retrieve the equipped slot parts
+     * @param catalogAddress The address of the catalog to which the given asset belongs to
+     * @param slotPartIds An array of slot part IDs in the asset for which to retrieve the equipped slot parts
+     * @return slotParts An array of `EquippedSlotPart` structs representing the equipped slot parts
+     */
+    function getEquippedSlotParts(
+        IEquippable target_,
+        uint256 tokenId,
+        uint64 assetId,
+        address catalogAddress,
+        uint64[] memory slotPartIds
+    ) private view returns (EquippedSlotPart[] memory slotParts) {
+        slotParts = new EquippedSlotPart[](slotPartIds.length);
+        uint256 len = slotPartIds.length;
+
+        if (len != 0) {
+            string memory metadata;
+            ICatalog.Part[] memory catalogSlotParts = ICatalog(catalogAddress)
+                .getParts(slotPartIds);
+            for (uint256 i; i < len; ) {
+                IEquippable.Equipment memory equipment = target_.getEquipment(
+                    tokenId,
+                    catalogAddress,
+                    slotPartIds[i]
+                );
+                if (equipment.assetId == assetId) {
+                    metadata = IEquippable(equipment.childEquippableAddress)
+                        .getAssetMetadata(
+                            equipment.childId,
+                            equipment.childAssetId
+                        );
+                    slotParts[i] = EquippedSlotPart({
+                        partId: slotPartIds[i],
+                        childAssetId: equipment.childAssetId,
+                        z: catalogSlotParts[i].z,
+                        childId: equipment.childId,
+                        childAddress: equipment.childEquippableAddress,
+                        childAssetMetadata: metadata,
+                        partMetadata: catalogSlotParts[i].metadataURI
+                    });
+                } else {
+                    slotParts[i] = EquippedSlotPart({
+                        partId: slotPartIds[i],
+                        childAssetId: uint64(0),
+                        z: catalogSlotParts[i].z,
+                        childId: uint256(0),
+                        childAddress: address(0),
+                        childAssetMetadata: "",
+                        partMetadata: catalogSlotParts[i].metadataURI
+                    });
+                }
+                unchecked {
+                    ++i;
+                }
+            }
+        }
+    }
+
+    /**
+     * @notice Used to split slot and fixed parts.
+     * @param allPartIds[] An array of `Part` IDs containing both, `Slot` and `Fixed` parts
+     * @param catalogAddress An address of the catalog to which the given `Part`s belong to
+     * @return slotPartIds An array of IDs of the `Slot` parts included in the `allPartIds`
+     * @return fixedPartIds An array of IDs of the `Fixed` parts included in the `allPartIds`
+     */
+    function splitSlotAndFixedParts(
+        uint64[] memory allPartIds,
+        address catalogAddress
+    )
+        public
+        view
+        returns (uint64[] memory slotPartIds, uint64[] memory fixedPartIds)
+    {
+        ICatalog.Part[] memory allParts = ICatalog(catalogAddress)
+            .getParts(allPartIds);
+        uint256 numFixedParts;
+        uint256 numSlotParts;
+
+        uint256 numParts = allPartIds.length;
+        // This for loop is just to discover the right size of the split arrays, since we can't create them dynamically
+        for (uint256 i; i < numParts; ) {
+            if (allParts[i].itemType == ICatalog.ItemType.Fixed)
+                numFixedParts += 1;
+                // We could just take the numParts - numFixedParts, but it doesn't hurt to double check it's not an uninitialized part:
+            else if (allParts[i].itemType == ICatalog.ItemType.Slot)
+                numSlotParts += 1;
+            unchecked {
+                ++i;
+            }
+        }
+
+        slotPartIds = new uint64[](numSlotParts);
+        fixedPartIds = new uint64[](numFixedParts);
+        uint256 slotPartsIndex;
+        uint256 fixedPartsIndex;
+
+        // This for loop is to actually fill the split arrays
+        for (uint256 i; i < numParts; ) {
+            if (allParts[i].itemType == ICatalog.ItemType.Fixed) {
+                fixedPartIds[fixedPartsIndex] = allPartIds[i];
+                fixedPartsIndex += 1;
+            } else if (allParts[i].itemType == ICatalog.ItemType.Slot) {
+                slotPartIds[slotPartsIndex] = allPartIds[i];
+                slotPartsIndex += 1;
+            }
+            unchecked {
+                ++i;
+            }
+        }
+    }
+}
diff --git a/assets/eip-6220/contracts/utils/MultiAssetRenderUtils.sol b/assets/eip-6220/contracts/utils/MultiAssetRenderUtils.sol
new file mode 100644
index 00000000000000..47d8dcbe945ee0
--- /dev/null
+++ b/assets/eip-6220/contracts/utils/MultiAssetRenderUtils.sol
@@ -0,0 +1,194 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "../IERC5773.sol";
+
+error TokenHasNoAssets();
+
+/**
+ * @title MultiAssetRenderUtils
+ * @author RMRK team
+ */
+contract MultiAssetRenderUtils {
+    uint16 private constant _LOWEST_POSSIBLE_PRIORITY = 2**16 - 1;
+
+    /**
+     * @notice The structure used to display information about an active asset.
+     * @return id ID of the asset
+     * @return priority The priority assigned to the asset
+     * @return metadata The metadata URI of the asset
+     */
+    struct ActiveAsset {
+        uint64 id;
+        uint16 priority;
+        string metadata;
+    }
+
+    /**
+     * @notice The structure used to display information about a pending asset.
+     * @return id ID of the asset
+     * @return acceptRejectIndex An index to use in order to accept or reject the given asset
+     * @return replacesAssetWithId ID of the asset that would be replaced if this asset gets accepted
+     * @return metadata The metadata URI of the asset
+     */
+    struct PendingAsset {
+        uint64 id;
+        uint128 acceptRejectIndex;
+        uint64 replacesAssetWithId;
+        string metadata;
+    }
+
+    /**
+     * @notice Used to get the active assets of the given token.
+     * @dev The full `ActiveAsset` looks like this:
+     *  [
+     *      id,
+     *      priority,
+     *      metadata
+     *  ]
+     * @param target Address of the smart contract of the given token
+     * @param tokenId ID of the token to retrieve the active assets for
+     * @return struct[] An array of ActiveAssets present on the given token
+     */
+    function getActiveAssets(address target, uint256 tokenId)
+        public
+        view
+        virtual
+        returns (ActiveAsset[] memory)
+    {
+        IERC5773 target_ = IERC5773(target);
+
+        uint64[] memory assets = target_.getActiveAssets(tokenId);
+        uint16[] memory priorities = target_.getActiveAssetPriorities(tokenId);
+        uint256 len = assets.length;
+        if (len == 0) {
+            revert TokenHasNoAssets();
+        }
+
+        ActiveAsset[] memory activeAssets = new ActiveAsset[](len);
+        string memory metadata;
+        for (uint256 i; i < len; ) {
+            metadata = target_.getAssetMetadata(tokenId, assets[i]);
+            activeAssets[i] = ActiveAsset({
+                id: assets[i],
+                priority: priorities[i],
+                metadata: metadata
+            });
+            unchecked {
+                ++i;
+            }
+        }
+        return activeAssets;
+    }
+
+    /**
+     * @notice Used to get the pending assets of the given token.
+     * @dev The full `PendingAsset` looks like this:
+     *  [
+     *      id,
+     *      acceptRejectIndex,
+     *      replacesAssetWithId,
+     *      metadata
+     *  ]
+     * @param target Address of the smart contract of the given token
+     * @param tokenId ID of the token to retrieve the pending assets for
+     * @return struct[] An array of PendingAssets present on the given token
+     */
+    function getPendingAssets(address target, uint256 tokenId)
+        public
+        view
+        virtual
+        returns (PendingAsset[] memory)
+    {
+        IERC5773 target_ = IERC5773(target);
+
+        uint64[] memory assets = target_.getPendingAssets(tokenId);
+        uint256 len = assets.length;
+        if (len == 0) {
+            revert TokenHasNoAssets();
+        }
+
+        PendingAsset[] memory pendingAssets = new PendingAsset[](len);
+        string memory metadata;
+        uint64 replacesAssetWithId;
+        for (uint256 i; i < len; ) {
+            metadata = target_.getAssetMetadata(tokenId, assets[i]);
+            replacesAssetWithId = target_.getAssetReplacements(
+                tokenId,
+                assets[i]
+            );
+            pendingAssets[i] = PendingAsset({
+                id: assets[i],
+                acceptRejectIndex: uint128(i),
+                replacesAssetWithId: replacesAssetWithId,
+                metadata: metadata
+            });
+            unchecked {
+                ++i;
+            }
+        }
+        return pendingAssets;
+    }
+
+    /**
+     * @notice Used to retrieve the metadata URI of specified assets in the specified token.
+     * @dev Requirements:
+     *
+     *  - `assetIds` must exist.
+     * @param target Address of the smart contract of the given token
+     * @param tokenId ID of the token to retrieve the specified assets for
+     * @param assetIds[] An array of asset IDs for which to retrieve the metadata URIs
+     * @return string[] An array of metadata URIs belonging to specified assets
+     */
+    function getAssetsById(
+        address target,
+        uint256 tokenId,
+        uint64[] calldata assetIds
+    ) public view virtual returns (string[] memory) {
+        IERC5773 target_ = IERC5773(target);
+        uint256 len = assetIds.length;
+        string[] memory assets = new string[](len);
+        for (uint256 i; i < len; ) {
+            assets[i] = target_.getAssetMetadata(tokenId, assetIds[i]);
+            unchecked {
+                ++i;
+            }
+        }
+        return assets;
+    }
+
+    /**
+     * @notice Used to retrieve the metadata URI of the specified token's asset with the highest priority.
+     * @param target Address of the smart contract of the given token
+     * @param tokenId ID of the token for which to retrieve the metadata URI of the asset with the highest priority
+     * @return string The metadata URI of the asset with the highest priority
+     */
+    function getTopAssetMetaForToken(address target, uint256 tokenId)
+        external
+        view
+        returns (string memory)
+    {
+        IERC5773 target_ = IERC5773(target);
+        uint16[] memory priorities = target_.getActiveAssetPriorities(tokenId);
+        uint64[] memory assets = target_.getActiveAssets(tokenId);
+        uint256 len = priorities.length;
+        if (len == 0) {
+            revert TokenHasNoAssets();
+        }
+
+        uint16 maxPriority = _LOWEST_POSSIBLE_PRIORITY;
+        uint64 maxPriorityAsset;
+        for (uint64 i; i < len; ) {
+            uint16 currentPrio = priorities[i];
+            if (currentPrio < maxPriority) {
+                maxPriority = currentPrio;
+                maxPriorityAsset = assets[i];
+            }
+            unchecked {
+                ++i;
+            }
+        }
+        return target_.getAssetMetadata(tokenId, maxPriorityAsset);
+    }
+}
diff --git a/assets/eip-6220/hardhat.config.ts b/assets/eip-6220/hardhat.config.ts
new file mode 100644
index 00000000000000..68bbc2796a8937
--- /dev/null
+++ b/assets/eip-6220/hardhat.config.ts
@@ -0,0 +1,18 @@
+import { HardhatUserConfig } from 'hardhat/config';
+import '@nomicfoundation/hardhat-chai-matchers';
+import '@nomiclabs/hardhat-etherscan';
+import '@typechain/hardhat';
+
+const config: HardhatUserConfig = {
+  solidity: {
+    version: '0.8.16',
+    settings: {
+      optimizer: {
+        enabled: true,
+        runs: 200,
+      },
+    },
+  },
+};
+
+export default config;
diff --git a/assets/eip-6220/package.json b/assets/eip-6220/package.json
new file mode 100644
index 00000000000000..7f79171d1eff2c
--- /dev/null
+++ b/assets/eip-6220/package.json
@@ -0,0 +1,29 @@
+{
+  "name": "equippable-tokens",
+  "dependencies": {
+    "@openzeppelin/contracts": "^4.6.0"
+  },
+  "devDependencies": {
+    "@nomicfoundation/hardhat-chai-matchers": "^1.0.1",
+    "@nomicfoundation/hardhat-network-helpers": "^1.0.3",
+    "@nomiclabs/hardhat-ethers": "^2.2.1",
+    "@nomiclabs/hardhat-etherscan": "^3.1.0",
+    "@openzeppelin/test-helpers": "^0.5.15",
+    "@primitivefi/hardhat-dodoc": "^0.2.3",
+    "@typechain/ethers-v5": "^10.1.0",
+    "@typechain/hardhat": "^6.1.2",
+    "@types/chai": "^4.3.1",
+    "@types/mocha": "^9.1.0",
+    "@types/node": "^18.0.3",
+    "@typescript-eslint/eslint-plugin": "^5.30.6",
+    "@typescript-eslint/parser": "^5.30.6",
+    "chai": "^4.3.6",
+    "ethers": "^5.6.9",
+    "hardhat": "^2.12.2",
+    "solc": "^0.8.9",
+    "ts-node": "^10.8.2",
+    "typechain": "^8.1.0",
+    "typescript": "^4.7.4",
+    "walk-sync": "^3.0.0"
+  }
+}
diff --git a/assets/eip-6220/test/catalog.ts b/assets/eip-6220/test/catalog.ts
new file mode 100644
index 00000000000000..8c0e34ea893159
--- /dev/null
+++ b/assets/eip-6220/test/catalog.ts
@@ -0,0 +1,280 @@
+import { loadFixture } from '@nomicfoundation/hardhat-network-helpers';
+import { SignerWithAddress } from '@nomiclabs/hardhat-ethers/signers';
+import { expect } from 'chai';
+import { ethers } from 'hardhat';
+import { CatalogMock } from '../typechain-types';
+
+async function catalogFixture(): Promise<CatalogMock> {
+  const Catalog = await ethers.getContractFactory('CatalogMock');
+  const testCatalog = await Catalog.deploy('ipfs//:meta', 'misc');
+  await testCatalog.deployed();
+
+  return testCatalog;
+}
+
+describe('CatalogMock', async () => {
+  let testCatalog: CatalogMock;
+
+  let addrs: SignerWithAddress[];
+  const metadataUriDefault = 'src';
+
+  const noType = 0;
+  const slotType = 1;
+  const fixedType = 2;
+
+  const sampleSlotPartData = {
+    itemType: slotType,
+    z: 0,
+    equippable: [],
+    metadataURI: metadataUriDefault,
+  };
+
+  beforeEach(async () => {
+    [, ...addrs] = await ethers.getSigners();
+    testCatalog = await loadFixture(catalogFixture);
+  });
+
+  describe('Init Catalog', async function () {
+    it('has right metadataURI', async function () {
+      expect(await testCatalog.getMetadataURI()).to.equal('ipfs//:meta');
+    });
+
+    it('has right type', async function () {
+      expect(await testCatalog.getType()).to.equal('misc');
+    });
+
+    it('supports interface', async function () {
+      expect(await testCatalog.supportsInterface('0xd912401f')).to.equal(true);
+    });
+
+    it('does not support other interfaces', async function () {
+      expect(await testCatalog.supportsInterface('0xffffffff')).to.equal(false);
+    });
+  });
+
+  describe('add catalog entries', async function () {
+    it('can add fixed part', async function () {
+      const partId = 1;
+      const partData = {
+        itemType: fixedType,
+        z: 0,
+        equippable: [],
+        metadataURI: metadataUriDefault,
+      };
+
+      await testCatalog.addPart({ partId: partId, part: partData });
+      expect(await testCatalog.getPart(partId)).to.eql([2, 0, [], metadataUriDefault]);
+    });
+
+    it('can add slot part', async function () {
+      const partId = 2;
+      await testCatalog.addPart({ partId: partId, part: sampleSlotPartData });
+      expect(await testCatalog.getPart(partId)).to.eql([1, 0, [], metadataUriDefault]);
+    });
+
+    it('can add parts list', async function () {
+      const partId = 1;
+      const partId2 = 2;
+      const partData1 = {
+        itemType: slotType,
+        z: 0,
+        equippable: [],
+        metadataURI: 'src1',
+      };
+      const partData2 = {
+        itemType: fixedType,
+        z: 1,
+        equippable: [],
+        metadataURI: 'src2',
+      };
+      await testCatalog.addPartList([
+        { partId: partId, part: partData1 },
+        { partId: partId2, part: partData2 },
+      ]);
+      expect(await testCatalog.getParts([partId, partId2])).to.eql([
+        [slotType, 0, [], 'src1'],
+        [fixedType, 1, [], 'src2'],
+      ]);
+    });
+
+    it('cannot add part with id 0', async function () {
+      const partId = 0;
+      await expect(
+        testCatalog.addPart({ partId: partId, part: sampleSlotPartData }),
+      ).to.be.revertedWithCustomError(testCatalog, 'IdZeroForbidden');
+    });
+
+    it('cannot add part with existing partId', async function () {
+      const partId = 3;
+      await testCatalog.addPart({ partId: partId, part: sampleSlotPartData });
+      await expect(
+        testCatalog.addPart({ partId: partId, part: sampleSlotPartData }),
+      ).to.be.revertedWithCustomError(testCatalog, 'PartAlreadyExists');
+    });
+
+    it('cannot add part with item type None', async function () {
+      const partId = 1;
+      const badPartData = {
+        itemType: noType,
+        z: 0,
+        equippable: [],
+        metadataURI: metadataUriDefault,
+      };
+      await expect(
+        testCatalog.addPart({ partId: partId, part: badPartData }),
+      ).to.be.revertedWithCustomError(testCatalog, 'BadConfig');
+    });
+
+    it('cannot add fixed part with equippable addresses', async function () {
+      const partId = 1;
+      const badPartData = {
+        itemType: fixedType,
+        z: 0,
+        equippable: [addrs[3].address],
+        metadataURI: metadataUriDefault,
+      };
+      await expect(
+        testCatalog.addPart({ partId: partId, part: badPartData }),
+      ).to.be.revertedWithCustomError(testCatalog, 'BadConfig');
+    });
+
+    it('is not equippable if address was not added', async function () {
+      const partId = 4;
+      await testCatalog.addPart({ partId: partId, part: sampleSlotPartData });
+      expect(await testCatalog.checkIsEquippable(partId, addrs[1].address)).to.eql(false);
+    });
+
+    it('is equippable if added in the part definition', async function () {
+      const partId = 1;
+      const partData = {
+        itemType: slotType,
+        z: 0,
+        equippable: [addrs[1].address, addrs[2].address],
+        metadataURI: metadataUriDefault,
+      };
+      await testCatalog.addPart({ partId: partId, part: partData });
+      expect(await testCatalog.checkIsEquippable(partId, addrs[2].address)).to.eql(true);
+    });
+
+    it('is equippable if added afterward', async function () {
+      const partId = 1;
+      await expect(testCatalog.addPart({ partId: partId, part: sampleSlotPartData }))
+        .to.emit(testCatalog, 'AddedPart')
+        .withArgs(
+          partId,
+          sampleSlotPartData.itemType,
+          sampleSlotPartData.z,
+          sampleSlotPartData.equippable,
+          sampleSlotPartData.metadataURI,
+        );
+      await expect(testCatalog.addEquippableAddresses(partId, [addrs[1].address]))
+        .to.emit(testCatalog, 'AddedEquippables')
+        .withArgs(partId, [addrs[1].address]);
+      expect(await testCatalog.checkIsEquippable(partId, addrs[1].address)).to.eql(true);
+    });
+
+    it('is equippable if set afterward', async function () {
+      const partId = 1;
+      await testCatalog.addPart({ partId: partId, part: sampleSlotPartData });
+      await expect(testCatalog.setEquippableAddresses(partId, [addrs[1].address]))
+        .to.emit(testCatalog, 'SetEquippables')
+        .withArgs(partId, [addrs[1].address]);
+      expect(await testCatalog.checkIsEquippable(partId, addrs[1].address)).to.eql(true);
+    });
+
+    it('is equippable if set to all', async function () {
+      const partId = 1;
+      await testCatalog.addPart({ partId: partId, part: sampleSlotPartData });
+      await expect(testCatalog.setEquippableToAll(partId))
+        .to.emit(testCatalog, 'SetEquippableToAll')
+        .withArgs(partId);
+      expect(await testCatalog.checkIsEquippableToAll(partId)).to.eql(true);
+      expect(await testCatalog.checkIsEquippable(partId, addrs[1].address)).to.eql(true);
+    });
+
+    it('cannot add nor set equippable addresses for non existing part', async function () {
+      const partId = 1;
+      await testCatalog.addPart({ partId: partId, part: sampleSlotPartData });
+      await expect(testCatalog.addEquippableAddresses(partId, [])).to.be.revertedWithCustomError(
+        testCatalog,
+        'ZeroLengthIdsPassed',
+      );
+      await expect(testCatalog.setEquippableAddresses(partId, [])).to.be.revertedWithCustomError(
+        testCatalog,
+        'ZeroLengthIdsPassed',
+      );
+    });
+
+    it('cannot add nor set empty list of equippable addresses', async function () {
+      const NonExistingPartId = 1;
+      await expect(
+        testCatalog.addEquippableAddresses(NonExistingPartId, [addrs[1].address]),
+      ).to.be.revertedWithCustomError(testCatalog, 'PartDoesNotExist');
+      await expect(
+        testCatalog.setEquippableAddresses(NonExistingPartId, [addrs[1].address]),
+      ).to.be.revertedWithCustomError(testCatalog, 'PartDoesNotExist');
+      await expect(testCatalog.setEquippableToAll(NonExistingPartId)).to.be.revertedWithCustomError(
+        testCatalog,
+        'PartDoesNotExist',
+      );
+    });
+
+    it('cannot add nor set equippable addresses to non slot part', async function () {
+      const fixedPartId = 1;
+      const partData = {
+        itemType: fixedType, // This is what we're testing
+        z: 0,
+        equippable: [],
+        metadataURI: metadataUriDefault,
+      };
+      await testCatalog.addPart({ partId: fixedPartId, part: partData });
+      await expect(
+        testCatalog.addEquippableAddresses(fixedPartId, [addrs[1].address]),
+      ).to.be.revertedWithCustomError(testCatalog, 'PartIsNotSlot');
+      await expect(
+        testCatalog.setEquippableAddresses(fixedPartId, [addrs[1].address]),
+      ).to.be.revertedWithCustomError(testCatalog, 'PartIsNotSlot');
+      await expect(testCatalog.setEquippableToAll(fixedPartId)).to.be.revertedWithCustomError(
+        testCatalog,
+        'PartIsNotSlot',
+      );
+    });
+
+    it('cannot set equippable to all on non existing part', async function () {
+      const nonExistingPartId = 1;
+      await expect(testCatalog.setEquippableToAll(nonExistingPartId)).to.be.revertedWithCustomError(
+        testCatalog,
+        'PartDoesNotExist',
+      );
+    });
+
+    it('resets equippable to all if addresses are set', async function () {
+      const partId = 1;
+      await testCatalog.addPart({ partId: partId, part: sampleSlotPartData });
+      await testCatalog.setEquippableToAll(partId);
+
+      // This should reset it:
+      testCatalog.setEquippableAddresses(partId, [addrs[1].address]);
+      expect(await testCatalog.checkIsEquippableToAll(partId)).to.eql(false);
+    });
+
+    it('resets equippable to all if addresses are added', async function () {
+      const partId = 1;
+      await testCatalog.addPart({ partId: partId, part: sampleSlotPartData });
+      await testCatalog.setEquippableToAll(partId);
+
+      // This should reset it:
+      await testCatalog.addEquippableAddresses(partId, [addrs[1].address]);
+      expect(await testCatalog.checkIsEquippableToAll(partId)).to.eql(false);
+    });
+
+    it('can reset equippable addresses', async function () {
+      const partId = 1;
+      await testCatalog.addPart({ partId: partId, part: sampleSlotPartData });
+      await testCatalog.addEquippableAddresses(partId, [addrs[1].address, addrs[2].address]);
+
+      await testCatalog.resetEquippableAddresses(partId);
+      expect(await testCatalog.checkIsEquippable(partId, addrs[1].address)).to.eql(false);
+    });
+  });
+});
diff --git a/assets/eip-6220/test/equippableFixedParts.ts b/assets/eip-6220/test/equippableFixedParts.ts
new file mode 100644
index 00000000000000..9a54684b5e48c8
--- /dev/null
+++ b/assets/eip-6220/test/equippableFixedParts.ts
@@ -0,0 +1,588 @@
+import { loadFixture } from '@nomicfoundation/hardhat-network-helpers';
+import { SignerWithAddress } from '@nomiclabs/hardhat-ethers/signers';
+import { expect } from 'chai';
+import { BigNumber } from 'ethers';
+import { ethers } from 'hardhat';
+import { CatalogMock, EquippableTokenMock, EquipRenderUtils } from '../typechain-types';
+
+let addrs: SignerWithAddress[];
+
+const partIdForHead1 = 1;
+const partIdForHead2 = 2;
+const partIdForHead3 = 3;
+const partIdForBody1 = 4;
+const partIdForBody2 = 5;
+const partIdForHair1 = 6;
+const partIdForHair2 = 7;
+const partIdForHair3 = 8;
+const partIdForMaskCatalog1 = 9;
+const partIdForMaskCatalog2 = 10;
+const partIdForMaskCatalog3 = 11;
+const partIdForEars1 = 12;
+const partIdForEars2 = 13;
+const partIdForHorns1 = 14;
+const partIdForHorns2 = 15;
+const partIdForHorns3 = 16;
+const partIdForMaskCatalogEquipped1 = 17;
+const partIdForMaskCatalogEquipped2 = 18;
+const partIdForMaskCatalogEquipped3 = 19;
+const partIdForEarsEquipped1 = 20;
+const partIdForEarsEquipped2 = 21;
+const partIdForHornsEquipped1 = 22;
+const partIdForHornsEquipped2 = 23;
+const partIdForHornsEquipped3 = 24;
+const partIdForMask = 25;
+
+const uniqueNeons = 10;
+const uniqueMasks = 4;
+// Ids could be the same since they are different collections, but to avoid log problems we have them unique
+const neons: number[] = [];
+const masks: number[] = [];
+
+const neonResIds = [100, 101, 102, 103, 104];
+const maskAssetsFull = [1, 2, 3, 4]; // Must match the total of uniqueAssets
+const maskAssetsEquip = [5, 6, 7, 8]; // Must match the total of uniqueAssets
+const maskpableGroupId = 1; // Assets to equip will all use this
+
+enum ItemType {
+  None,
+  Slot,
+  Fixed,
+}
+
+let nextTokenId = 1;
+let nextChildTokenId = 100;
+
+async function mint(token: EquippableTokenMock, to: string): Promise<number> {
+  const tokenId = nextTokenId;
+  nextTokenId++;
+  await token['mint(address,uint256)'](to, tokenId);
+  return tokenId;
+}
+
+async function nestMint(token: EquippableTokenMock, to: string, parentId: number): Promise<number> {
+  const childTokenId = nextChildTokenId;
+  nextChildTokenId++;
+  await token['nestMint(address,uint256,uint256)'](to, childTokenId, parentId);
+  return childTokenId;
+}
+
+async function setupContextForParts(
+  catalog: CatalogMock,
+  neon: EquippableTokenMock,
+  mask: EquippableTokenMock,
+) {
+  [, ...addrs] = await ethers.getSigners();
+  await setupCatalog();
+
+  await mintNeons();
+  await mintMasks();
+
+  await addAssetsToNeon();
+  await addAssetsToMask();
+
+  async function setupCatalog(): Promise<void> {
+    const partForHead1 = {
+      itemType: ItemType.Fixed,
+      z: 1,
+      equippable: [],
+      metadataURI: 'ipfs://head1.png',
+    };
+    const partForHead2 = {
+      itemType: ItemType.Fixed,
+      z: 1,
+      equippable: [],
+      metadataURI: 'ipfs://head2.png',
+    };
+    const partForHead3 = {
+      itemType: ItemType.Fixed,
+      z: 1,
+      equippable: [],
+      metadataURI: 'ipfs://head3.png',
+    };
+    const partForBody1 = {
+      itemType: ItemType.Fixed,
+      z: 1,
+      equippable: [],
+      metadataURI: 'ipfs://body1.png',
+    };
+    const partForBody2 = {
+      itemType: ItemType.Fixed,
+      z: 1,
+      equippable: [],
+      metadataURI: 'ipfs://body2.png',
+    };
+    const partForHair1 = {
+      itemType: ItemType.Fixed,
+      z: 2,
+      equippable: [],
+      metadataURI: 'ipfs://hair1.png',
+    };
+    const partForHair2 = {
+      itemType: ItemType.Fixed,
+      z: 2,
+      equippable: [],
+      metadataURI: 'ipfs://hair2.png',
+    };
+    const partForHair3 = {
+      itemType: ItemType.Fixed,
+      z: 2,
+      equippable: [],
+      metadataURI: 'ipfs://hair3.png',
+    };
+    const partForMaskCatalog1 = {
+      itemType: ItemType.Fixed,
+      z: 3,
+      equippable: [],
+      metadataURI: 'ipfs://maskCatalog1.png',
+    };
+    const partForMaskCatalog2 = {
+      itemType: ItemType.Fixed,
+      z: 3,
+      equippable: [],
+      metadataURI: 'ipfs://maskCatalog2.png',
+    };
+    const partForMaskCatalog3 = {
+      itemType: ItemType.Fixed,
+      z: 3,
+      equippable: [],
+      metadataURI: 'ipfs://maskCatalog3.png',
+    };
+    const partForEars1 = {
+      itemType: ItemType.Fixed,
+      z: 4,
+      equippable: [],
+      metadataURI: 'ipfs://ears1.png',
+    };
+    const partForEars2 = {
+      itemType: ItemType.Fixed,
+      z: 4,
+      equippable: [],
+      metadataURI: 'ipfs://ears2.png',
+    };
+    const partForHorns1 = {
+      itemType: ItemType.Fixed,
+      z: 5,
+      equippable: [],
+      metadataURI: 'ipfs://horn1.png',
+    };
+    const partForHorns2 = {
+      itemType: ItemType.Fixed,
+      z: 5,
+      equippable: [],
+      metadataURI: 'ipfs://horn2.png',
+    };
+    const partForHorns3 = {
+      itemType: ItemType.Fixed,
+      z: 5,
+      equippable: [],
+      metadataURI: 'ipfs://horn3.png',
+    };
+    const partForMaskCatalogEquipped1 = {
+      itemType: ItemType.Fixed,
+      z: 3,
+      equippable: [],
+      metadataURI: 'ipfs://maskCatalogEquipped1.png',
+    };
+    const partForMaskCatalogEquipped2 = {
+      itemType: ItemType.Fixed,
+      z: 3,
+      equippable: [],
+      metadataURI: 'ipfs://maskCatalogEquipped2.png',
+    };
+    const partForMaskCatalogEquipped3 = {
+      itemType: ItemType.Fixed,
+      z: 3,
+      equippable: [],
+      metadataURI: 'ipfs://maskCatalogEquipped3.png',
+    };
+    const partForEarsEquipped1 = {
+      itemType: ItemType.Fixed,
+      z: 4,
+      equippable: [],
+      metadataURI: 'ipfs://earsEquipped1.png',
+    };
+    const partForEarsEquipped2 = {
+      itemType: ItemType.Fixed,
+      z: 4,
+      equippable: [],
+      metadataURI: 'ipfs://earsEquipped2.png',
+    };
+    const partForHornsEquipped1 = {
+      itemType: ItemType.Fixed,
+      z: 5,
+      equippable: [],
+      metadataURI: 'ipfs://hornEquipped1.png',
+    };
+    const partForHornsEquipped2 = {
+      itemType: ItemType.Fixed,
+      z: 5,
+      equippable: [],
+      metadataURI: 'ipfs://hornEquipped2.png',
+    };
+    const partForHornsEquipped3 = {
+      itemType: ItemType.Fixed,
+      z: 5,
+      equippable: [],
+      metadataURI: 'ipfs://hornEquipped3.png',
+    };
+    const partForMask = {
+      itemType: ItemType.Slot,
+      z: 2,
+      equippable: [mask.address],
+      metadataURI: '',
+    };
+
+    await catalog.addPartList([
+      { partId: partIdForHead1, part: partForHead1 },
+      { partId: partIdForHead2, part: partForHead2 },
+      { partId: partIdForHead3, part: partForHead3 },
+      { partId: partIdForBody1, part: partForBody1 },
+      { partId: partIdForBody2, part: partForBody2 },
+      { partId: partIdForHair1, part: partForHair1 },
+      { partId: partIdForHair2, part: partForHair2 },
+      { partId: partIdForHair3, part: partForHair3 },
+      { partId: partIdForMaskCatalog1, part: partForMaskCatalog1 },
+      { partId: partIdForMaskCatalog2, part: partForMaskCatalog2 },
+      { partId: partIdForMaskCatalog3, part: partForMaskCatalog3 },
+      { partId: partIdForEars1, part: partForEars1 },
+      { partId: partIdForEars2, part: partForEars2 },
+      { partId: partIdForHorns1, part: partForHorns1 },
+      { partId: partIdForHorns2, part: partForHorns2 },
+      { partId: partIdForHorns3, part: partForHorns3 },
+      { partId: partIdForMaskCatalogEquipped1, part: partForMaskCatalogEquipped1 },
+      { partId: partIdForMaskCatalogEquipped2, part: partForMaskCatalogEquipped2 },
+      { partId: partIdForMaskCatalogEquipped3, part: partForMaskCatalogEquipped3 },
+      { partId: partIdForEarsEquipped1, part: partForEarsEquipped1 },
+      { partId: partIdForEarsEquipped2, part: partForEarsEquipped2 },
+      { partId: partIdForHornsEquipped1, part: partForHornsEquipped1 },
+      { partId: partIdForHornsEquipped2, part: partForHornsEquipped2 },
+      { partId: partIdForHornsEquipped3, part: partForHornsEquipped3 },
+      { partId: partIdForMask, part: partForMask },
+    ]);
+  }
+
+  async function mintNeons(): Promise<void> {
+    // This array is reused, so we "empty" it before
+    neons.length = 0;
+    // Using only first 3 addresses to mint
+    for (let i = 0; i < uniqueNeons; i++) {
+      const newId = await mint(neon, addrs[i % 3].address);
+      neons.push(newId);
+    }
+  }
+
+  async function mintMasks(): Promise<void> {
+    // This array is reused, so we "empty" it before
+    masks.length = 0;
+    // Mint one weapon to neon
+    for (let i = 0; i < uniqueNeons; i++) {
+      const newId = await nestMint(mask, neon.address, neons[i]);
+      masks.push(newId);
+      await neon.connect(addrs[i % 3]).acceptChild(neons[i], 0, mask.address, newId);
+    }
+  }
+
+  async function addAssetsToNeon(): Promise<void> {
+    await neon.addEquippableAssetEntry(neonResIds[0], 0, catalog.address, 'ipfs:neonRes/1', [
+      partIdForHead1,
+      partIdForBody1,
+      partIdForHair1,
+      partIdForMask,
+    ]);
+    await neon.addEquippableAssetEntry(neonResIds[1], 0, catalog.address, 'ipfs:neonRes/2', [
+      partIdForHead2,
+      partIdForBody2,
+      partIdForHair2,
+      partIdForMask,
+    ]);
+    await neon.addEquippableAssetEntry(neonResIds[2], 0, catalog.address, 'ipfs:neonRes/3', [
+      partIdForHead3,
+      partIdForBody1,
+      partIdForHair3,
+      partIdForMask,
+    ]);
+    await neon.addEquippableAssetEntry(neonResIds[3], 0, catalog.address, 'ipfs:neonRes/4', [
+      partIdForHead1,
+      partIdForBody2,
+      partIdForHair2,
+      partIdForMask,
+    ]);
+    await neon.addEquippableAssetEntry(neonResIds[4], 0, catalog.address, 'ipfs:neonRes/1', [
+      partIdForHead2,
+      partIdForBody1,
+      partIdForHair1,
+      partIdForMask,
+    ]);
+
+    for (let i = 0; i < uniqueNeons; i++) {
+      await neon.addAssetToToken(neons[i], neonResIds[i % neonResIds.length], 0);
+      await neon.connect(addrs[i % 3]).acceptAsset(neons[i], 0, neonResIds[i % neonResIds.length]);
+    }
+  }
+
+  async function addAssetsToMask(): Promise<void> {
+    // Assets for full view, composed with fixed parts
+    await mask.addEquippableAssetEntry(
+      maskAssetsFull[0],
+      0, // Not meant to equip
+      catalog.address, // Not meant to equip, but catalog needed for parts
+      `ipfs:weapon/full/${maskAssetsFull[0]}`,
+      [partIdForMaskCatalog1, partIdForHorns1, partIdForEars1],
+    );
+    await mask.addEquippableAssetEntry(
+      maskAssetsFull[1],
+      0, // Not meant to equip
+      catalog.address, // Not meant to equip, but catalog needed for parts
+      `ipfs:weapon/full/${maskAssetsFull[1]}`,
+      [partIdForMaskCatalog2, partIdForHorns2, partIdForEars2],
+    );
+    await mask.addEquippableAssetEntry(
+      maskAssetsFull[2],
+      0, // Not meant to equip
+      catalog.address, // Not meant to equip, but catalog needed for parts
+      `ipfs:weapon/full/${maskAssetsFull[2]}`,
+      [partIdForMaskCatalog3, partIdForHorns1, partIdForEars2],
+    );
+    await mask.addEquippableAssetEntry(
+      maskAssetsFull[3],
+      0, // Not meant to equip
+      catalog.address, // Not meant to equip, but catalog needed for parts
+      `ipfs:weapon/full/${maskAssetsFull[3]}`,
+      [partIdForMaskCatalog2, partIdForHorns2, partIdForEars1],
+    );
+
+    // Assets for equipping view, also composed with fixed parts
+    await mask.addEquippableAssetEntry(
+      maskAssetsEquip[0],
+      maskpableGroupId,
+      catalog.address,
+      `ipfs:weapon/equip/${maskAssetsEquip[0]}`,
+      [partIdForMaskCatalog1, partIdForHorns1, partIdForEars1],
+    );
+
+    // Assets for equipping view, also composed with fixed parts
+    await mask.addEquippableAssetEntry(
+      maskAssetsEquip[1],
+      maskpableGroupId,
+      catalog.address,
+      `ipfs:weapon/equip/${maskAssetsEquip[1]}`,
+      [partIdForMaskCatalog2, partIdForHorns2, partIdForEars2],
+    );
+
+    // Assets for equipping view, also composed with fixed parts
+    await mask.addEquippableAssetEntry(
+      maskAssetsEquip[2],
+      maskpableGroupId,
+      catalog.address,
+      `ipfs:weapon/equip/${maskAssetsEquip[2]}`,
+      [partIdForMaskCatalog3, partIdForHorns1, partIdForEars2],
+    );
+
+    // Assets for equipping view, also composed with fixed parts
+    await mask.addEquippableAssetEntry(
+      maskAssetsEquip[3],
+      maskpableGroupId,
+      catalog.address,
+      `ipfs:weapon/equip/${maskAssetsEquip[3]}`,
+      [partIdForMaskCatalog2, partIdForHorns2, partIdForEars1],
+    );
+
+    // Can be equipped into neons
+    await mask.setValidParentForEquippableGroup(maskpableGroupId, neon.address, partIdForMask);
+
+    // Add 2 assets to each weapon, one full, one for equip
+    // There are 10 weapon tokens for 4 unique assets so we use %
+    for (let i = 0; i < masks.length; i++) {
+      await mask.addAssetToToken(masks[i], maskAssetsFull[i % uniqueMasks], 0);
+      await mask.addAssetToToken(masks[i], maskAssetsEquip[i % uniqueMasks], 0);
+      await mask.connect(addrs[i % 3]).acceptAsset(masks[i], 0, maskAssetsFull[i % uniqueMasks]);
+      await mask.connect(addrs[i % 3]).acceptAsset(masks[i], 0, maskAssetsEquip[i % uniqueMasks]);
+    }
+  }
+}
+
+async function partsFixture() {
+  const baseSymbol = 'NCB';
+  const baseType = 'mixed';
+
+  const baseFactory = await ethers.getContractFactory('CatalogMock');
+  const equipFactory = await ethers.getContractFactory('EquippableTokenMock');
+  const viewFactory = await ethers.getContractFactory('EquipRenderUtils');
+
+  // Catalog
+  const catalog = <CatalogMock>await baseFactory.deploy(baseSymbol, baseType);
+  await catalog.deployed();
+
+  // Neon token
+  const neon = <EquippableTokenMock>await equipFactory.deploy();
+  await neon.deployed();
+
+  // Weapon
+  const mask = <EquippableTokenMock>await equipFactory.deploy();
+  await mask.deployed();
+
+  // View
+  const view = <EquipRenderUtils>await viewFactory.deploy();
+  await view.deployed();
+
+  await setupContextForParts(catalog, neon, mask);
+  return { catalog, neon, mask, view };
+}
+
+// The general idea is having these tokens: Neon and Mask
+// Masks can be equipped into Neons.
+// All use a single catalog.
+// Neon will use an asset per token, which uses fixed parts to compose the body
+// Mask will have 2 assets per weapon, one for full view, one for equipping. Both are composed using fixed parts
+describe('EquippableTokenMock with Parts', async () => {
+  let catalog: CatalogMock;
+  let neon: EquippableTokenMock;
+  let mask: EquippableTokenMock;
+  let view: EquipRenderUtils;
+  let addrs: SignerWithAddress[];
+
+  beforeEach(async function () {
+    [, ...addrs] = await ethers.getSigners();
+    ({ catalog, neon, mask, view } = await loadFixture(partsFixture));
+  });
+
+  describe('Equip', async function () {
+    it('can equip weapon', async function () {
+      // Weapon is child on index 0, background on index 1
+      const childIndex = 0;
+      const weaponResId = maskAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await expect(
+        neon
+          .connect(addrs[0])
+          .equip([neons[0], childIndex, neonResIds[0], partIdForMask, weaponResId]),
+      )
+        .to.emit(neon, 'ChildAssetEquipped')
+        .withArgs(neons[0], neonResIds[0], partIdForMask, masks[0], mask.address, weaponResId);
+
+      // All part slots are included on the response:
+      const expectedSlots = [bn(partIdForMask)];
+      const expectedEquips = [[bn(neonResIds[0]), bn(weaponResId), bn(masks[0]), mask.address]];
+      expect(await view.getEquipped(neon.address, neons[0], neonResIds[0])).to.eql([
+        expectedSlots,
+        expectedEquips,
+      ]);
+
+      // Child is marked as equipped:
+      expect(await neon.isChildEquipped(neons[0], mask.address, masks[0])).to.eql(true);
+    });
+
+    it('cannot equip non existing child in slot', async function () {
+      // Weapon is child on index 0
+      const badChildIndex = 3;
+      const weaponResId = maskAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await expect(
+        neon
+          .connect(addrs[0])
+          .equip([neons[0], badChildIndex, neonResIds[0], partIdForMask, weaponResId]),
+      ).to.be.reverted; // Bad index
+    });
+  });
+
+  describe('Compose', async function () {
+    it('can compose all parts for neon', async function () {
+      const childIndex = 0;
+      const weaponResId = maskAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await neon
+        .connect(addrs[0])
+        .equip([neons[0], childIndex, neonResIds[0], partIdForMask, weaponResId]);
+
+      const expectedFixedParts = [
+        [
+          bn(partIdForHead1), // partId
+          1, // z
+          'ipfs://head1.png', // metadataURI
+        ],
+        [
+          bn(partIdForBody1), // partId
+          1, // z
+          'ipfs://body1.png', // metadataURI
+        ],
+        [
+          bn(partIdForHair1), // partId
+          2, // z
+          'ipfs://hair1.png', // metadataURI
+        ],
+      ];
+      const expectedSlotParts = [
+        [
+          bn(partIdForMask), // partId
+          bn(maskAssetsEquip[0]), // childAssetId
+          2, // z
+          mask.address, // childAddress
+          bn(masks[0]), // childTokenId
+          'ipfs:weapon/equip/5', // childAssetMetadata
+          '', // partMetadata
+        ],
+      ];
+      const allAssets = await view.composeEquippables(neon.address, neons[0], neonResIds[0]);
+      expect(allAssets).to.eql([
+        'ipfs:neonRes/1', // metadataURI
+        bn(0), // equippableGroupId
+        catalog.address, // baseAddress,
+        expectedFixedParts,
+        expectedSlotParts,
+      ]);
+    });
+
+    it('can compose all parts for mask', async function () {
+      const expectedFixedParts = [
+        [
+          bn(partIdForMaskCatalog1), // partId
+          3, // z
+          'ipfs://maskCatalog1.png', // metadataURI
+        ],
+        [
+          bn(partIdForHorns1), // partId
+          5, // z
+          'ipfs://horn1.png', // metadataURI
+        ],
+        [
+          bn(partIdForEars1), // partId
+          4, // z
+          'ipfs://ears1.png', // metadataURI
+        ],
+      ];
+      const allAssets = await view.composeEquippables(mask.address, masks[0], maskAssetsEquip[0]);
+      expect(allAssets).to.eql([
+        `ipfs:weapon/equip/${maskAssetsEquip[0]}`, // metadataURI
+        bn(maskpableGroupId), // equippableGroupId
+        catalog.address, // baseAddress
+        expectedFixedParts,
+        [],
+      ]);
+    });
+
+    it('cannot compose equippables for neon with not associated asset', async function () {
+      const wrongResId = maskAssetsEquip[1];
+      await expect(
+        view.composeEquippables(mask.address, masks[0], wrongResId),
+      ).to.be.revertedWithCustomError(mask, 'TokenDoesNotHaveAsset');
+    });
+
+    it('cannot compose equippables for mask for asset with no catalog', async function () {
+      const noCatalogAssetId = 99;
+      await mask.addEquippableAssetEntry(
+        noCatalogAssetId,
+        0, // Not meant to equip
+        ethers.constants.AddressZero, // Not meant to equip
+        `ipfs:weapon/full/customAsset.png`,
+        [],
+      );
+      await mask.addAssetToToken(masks[0], noCatalogAssetId, 0);
+      await mask.connect(addrs[0]).acceptAsset(masks[0], 0, noCatalogAssetId);
+      await expect(
+        view.composeEquippables(mask.address, masks[0], noCatalogAssetId),
+      ).to.be.revertedWithCustomError(view, 'NotComposableAsset');
+    });
+  });
+});
+
+function bn(x: number): BigNumber {
+  return BigNumber.from(x);
+}
diff --git a/assets/eip-6220/test/equippableSlotParts.ts b/assets/eip-6220/test/equippableSlotParts.ts
new file mode 100644
index 00000000000000..ff0481f8d545ca
--- /dev/null
+++ b/assets/eip-6220/test/equippableSlotParts.ts
@@ -0,0 +1,923 @@
+import { loadFixture } from '@nomicfoundation/hardhat-network-helpers';
+import { SignerWithAddress } from '@nomiclabs/hardhat-ethers/signers';
+import { expect } from 'chai';
+import { BigNumber } from 'ethers';
+import { ethers } from 'hardhat';
+import { CatalogMock, EquippableTokenMock, EquipRenderUtils } from '../typechain-types';
+
+const partIdForBody = 1;
+const partIdForWeapon = 2;
+const partIdForWeaponGem = 3;
+const partIdForBackground = 4;
+
+const uniqueSnakeSoldiers = 10;
+const uniqueWeapons = 4;
+// const uniqueWeaponGems = 2;
+// const uniqueBackgrounds = 3;
+
+const snakeSoldiersIds: number[] = [];
+const weaponsIds: number[] = [];
+const weaponGemsIds: number[] = [];
+const backgroundsIds: number[] = [];
+
+const soldierResId = 100;
+const weaponAssetsFull = [1, 2, 3, 4]; // Must match the total of uniqueAssets
+const weaponAssetsEquip = [5, 6, 7, 8]; // Must match the total of uniqueAssets
+const weaponGemAssetFull = 101;
+const weaponGemAssetEquip = 102;
+const backgroundAssetId = 200;
+
+enum ItemType {
+  None,
+  Slot,
+  Fixed,
+}
+
+let addrs: SignerWithAddress[];
+
+let nextTokenId = 1;
+let nextChildTokenId = 100;
+
+async function mint(token: EquippableTokenMock, to: string): Promise<number> {
+  const tokenId = nextTokenId;
+  nextTokenId++;
+  await token['mint(address,uint256)'](to, tokenId);
+  return tokenId;
+}
+
+async function nestMint(token: EquippableTokenMock, to: string, parentId: number): Promise<number> {
+  const childTokenId = nextChildTokenId;
+  nextChildTokenId++;
+  await token['nestMint(address,uint256,uint256)'](to, childTokenId, parentId);
+  return childTokenId;
+}
+
+async function setupContextForSlots(
+  catalog: CatalogMock,
+  soldier: EquippableTokenMock,
+  weapon: EquippableTokenMock,
+  weaponGem: EquippableTokenMock,
+  background: EquippableTokenMock,
+) {
+  [, ...addrs] = await ethers.getSigners();
+
+  await setupCatalog();
+
+  await mintSnakeSoldiers();
+  await mintWeapons();
+  await mintWeaponGems();
+  await mintBackgrounds();
+
+  await addAssetsToSoldier();
+  await addAssetsToWeapon();
+  await addAssetsToWeaponGem();
+  await addAssetsToBackground();
+
+  return {
+    catalog,
+    soldier,
+    weapon,
+    background,
+  };
+
+  async function setupCatalog(): Promise<void> {
+    const partForBody = {
+      itemType: ItemType.Fixed,
+      z: 1,
+      equippable: [],
+      metadataURI: 'genericBody.png',
+    };
+    const partForWeapon = {
+      itemType: ItemType.Slot,
+      z: 2,
+      equippable: [weapon.address],
+      metadataURI: '',
+    };
+    const partForWeaponGem = {
+      itemType: ItemType.Slot,
+      z: 3,
+      equippable: [weaponGem.address],
+      metadataURI: 'noGem.png',
+    };
+    const partForBackground = {
+      itemType: ItemType.Slot,
+      z: 0,
+      equippable: [background.address],
+      metadataURI: 'noBackground.png',
+    };
+
+    await catalog.addPartList([
+      { partId: partIdForBody, part: partForBody },
+      { partId: partIdForWeapon, part: partForWeapon },
+      { partId: partIdForWeaponGem, part: partForWeaponGem },
+      { partId: partIdForBackground, part: partForBackground },
+    ]);
+  }
+
+  async function mintSnakeSoldiers(): Promise<void> {
+    // This array is reused, so we "empty" it before
+    snakeSoldiersIds.length = 0;
+    // Using only first 3 addresses to mint
+    for (let i = 0; i < uniqueSnakeSoldiers; i++) {
+      const newId = await mint(soldier, addrs[i % 3].address);
+      snakeSoldiersIds.push(newId);
+    }
+  }
+
+  async function mintWeapons(): Promise<void> {
+    // This array is reused, so we "empty" it before
+    weaponsIds.length = 0;
+    // Mint one weapon to soldier
+    for (let i = 0; i < uniqueSnakeSoldiers; i++) {
+      const newId = await nestMint(weapon, soldier.address, snakeSoldiersIds[i]);
+      weaponsIds.push(newId);
+      await soldier
+        .connect(addrs[i % 3])
+        .acceptChild(snakeSoldiersIds[i], 0, weapon.address, newId);
+    }
+  }
+
+  async function mintWeaponGems(): Promise<void> {
+    // This array is reused, so we "empty" it before
+    weaponGemsIds.length = 0;
+    // Mint one weapon gem for each weapon on each soldier
+    for (let i = 0; i < uniqueSnakeSoldiers; i++) {
+      const newId = await nestMint(weaponGem, weapon.address, weaponsIds[i]);
+      weaponGemsIds.push(newId);
+      await weapon.connect(addrs[i % 3]).acceptChild(weaponsIds[i], 0, weaponGem.address, newId);
+    }
+  }
+
+  async function mintBackgrounds(): Promise<void> {
+    // This array is reused, so we "empty" it before
+    backgroundsIds.length = 0;
+    // Mint one background to soldier
+    for (let i = 0; i < uniqueSnakeSoldiers; i++) {
+      const newId = await nestMint(background, soldier.address, snakeSoldiersIds[i]);
+      backgroundsIds.push(newId);
+      await soldier
+        .connect(addrs[i % 3])
+        .acceptChild(snakeSoldiersIds[i], 0, background.address, newId);
+    }
+  }
+
+  async function addAssetsToSoldier(): Promise<void> {
+    await soldier.addEquippableAssetEntry(soldierResId, 0, catalog.address, 'ipfs:soldier/', [
+      partIdForBody,
+      partIdForWeapon,
+      partIdForBackground,
+    ]);
+    for (let i = 0; i < uniqueSnakeSoldiers; i++) {
+      await soldier.addAssetToToken(snakeSoldiersIds[i], soldierResId, 0);
+      await soldier.connect(addrs[i % 3]).acceptAsset(snakeSoldiersIds[i], 0, soldierResId);
+    }
+  }
+
+  async function addAssetsToWeapon(): Promise<void> {
+    const equippableGroupId = 1; // Assets to equip will both use this
+
+    for (let i = 0; i < weaponAssetsFull.length; i++) {
+      await weapon.addEquippableAssetEntry(
+        weaponAssetsFull[i],
+        0, // Not meant to equip
+        ethers.constants.AddressZero, // Not meant to equip
+        `ipfs:weapon/full/${weaponAssetsFull[i]}`,
+        [],
+      );
+    }
+    for (let i = 0; i < weaponAssetsEquip.length; i++) {
+      await weapon.addEquippableAssetEntry(
+        weaponAssetsEquip[i],
+        equippableGroupId,
+        catalog.address,
+        `ipfs:weapon/equip/${weaponAssetsEquip[i]}`,
+        [partIdForWeaponGem],
+      );
+    }
+
+    // Can be equipped into snakeSoldiers
+    await weapon.setValidParentForEquippableGroup(
+      equippableGroupId,
+      soldier.address,
+      partIdForWeapon,
+    );
+
+    // Add 2 assets to each weapon, one full, one for equip
+    // There are 10 weapon tokens for 4 unique assets so we use %
+    for (let i = 0; i < weaponsIds.length; i++) {
+      await weapon.addAssetToToken(weaponsIds[i], weaponAssetsFull[i % uniqueWeapons], 0);
+      await weapon.addAssetToToken(weaponsIds[i], weaponAssetsEquip[i % uniqueWeapons], 0);
+      await weapon
+        .connect(addrs[i % 3])
+        .acceptAsset(weaponsIds[i], 0, weaponAssetsFull[i % uniqueWeapons]);
+      await weapon
+        .connect(addrs[i % 3])
+        .acceptAsset(weaponsIds[i], 0, weaponAssetsEquip[i % uniqueWeapons]);
+    }
+  }
+
+  async function addAssetsToWeaponGem(): Promise<void> {
+    const equippableGroupId = 1; // Assets to equip will use this
+    await weaponGem.addEquippableAssetEntry(
+      weaponGemAssetFull,
+      0, // Not meant to equip
+      ethers.constants.AddressZero, // Not meant to equip
+      'ipfs:weagponGem/full/',
+      [],
+    );
+    await weaponGem.addEquippableAssetEntry(
+      weaponGemAssetEquip,
+      equippableGroupId,
+      catalog.address,
+      'ipfs:weagponGem/equip/',
+      [],
+    );
+    await weaponGem.setValidParentForEquippableGroup(
+      // Can be equipped into weapons
+      equippableGroupId,
+      weapon.address,
+      partIdForWeaponGem,
+    );
+
+    for (let i = 0; i < uniqueSnakeSoldiers; i++) {
+      await weaponGem.addAssetToToken(weaponGemsIds[i], weaponGemAssetFull, 0);
+      await weaponGem.addAssetToToken(weaponGemsIds[i], weaponGemAssetEquip, 0);
+      await weaponGem.connect(addrs[i % 3]).acceptAsset(weaponGemsIds[i], 0, weaponGemAssetFull);
+      await weaponGem.connect(addrs[i % 3]).acceptAsset(weaponGemsIds[i], 0, weaponGemAssetEquip);
+    }
+  }
+
+  async function addAssetsToBackground(): Promise<void> {
+    const equippableGroupId = 1; // Assets to equip will use this
+    await background.addEquippableAssetEntry(
+      backgroundAssetId,
+      equippableGroupId,
+      catalog.address,
+      'ipfs:background/',
+      [],
+    );
+    // Can be equipped into snakeSoldiers
+    await background.setValidParentForEquippableGroup(
+      equippableGroupId,
+      soldier.address,
+      partIdForBackground,
+    );
+
+    for (let i = 0; i < uniqueSnakeSoldiers; i++) {
+      await background.addAssetToToken(backgroundsIds[i], backgroundAssetId, 0);
+      await background.connect(addrs[i % 3]).acceptAsset(backgroundsIds[i], 0, backgroundAssetId);
+    }
+  }
+}
+
+async function slotsFixture() {
+  const catalogSymbol = 'SSB';
+  const catalogType = 'mixed';
+
+  const catalogFactory = await ethers.getContractFactory('CatalogMock');
+  const equipFactory = await ethers.getContractFactory('EquippableTokenMock');
+  const viewFactory = await ethers.getContractFactory('EquipRenderUtils');
+
+  // View
+  const view = <EquipRenderUtils>await viewFactory.deploy();
+  await view.deployed();
+
+  // Catalog
+  const catalog = <CatalogMock>await catalogFactory.deploy(catalogSymbol, catalogType);
+  await catalog.deployed();
+
+  // Soldier token
+  const soldier = <EquippableTokenMock>await equipFactory.deploy();
+  await soldier.deployed();
+
+  // Weapon
+  const weapon = <EquippableTokenMock>await equipFactory.deploy();
+  await weapon.deployed();
+
+  // Weapon Gem
+  const weaponGem = <EquippableTokenMock>await equipFactory.deploy();
+  await weaponGem.deployed();
+
+  // Background
+  const background = <EquippableTokenMock>await equipFactory.deploy();
+  await background.deployed();
+
+  await setupContextForSlots(catalog, soldier, weapon, weaponGem, background);
+
+  return { catalog, soldier, weapon, weaponGem, background, view };
+}
+
+// The general idea is having these tokens: Soldier, Weapon, WeaponGem and Background.
+// Weapon and Background can be equipped into Soldier. WeaponGem can be equipped into Weapon
+// All use a single catalog.
+// Soldier will use a single enumerated fixed asset for simplicity
+// Weapon will have 2 assets per weapon, one for full view, one for equipping
+// Background will have a single asset for each, it can be used as full view and to equip
+// Weapon Gems will have 2 enumerated assets, one for full view, one for equipping.
+describe('EquippableTokenMock with Slots', async () => {
+  let catalog: CatalogMock;
+  let soldier: EquippableTokenMock;
+  let weapon: EquippableTokenMock;
+  let weaponGem: EquippableTokenMock;
+  let background: EquippableTokenMock;
+  let view: EquipRenderUtils;
+
+  let addrs: SignerWithAddress[];
+
+  beforeEach(async function () {
+    [, ...addrs] = await ethers.getSigners();
+    ({ catalog, soldier, weapon, weaponGem, background, view } = await loadFixture(slotsFixture));
+  });
+
+  it('can support IEquippable', async function () {
+    expect(await soldier.supportsInterface('0x28bc9ae4')).to.equal(true);
+  });
+
+  describe('Validations', async function () {
+    it('can validate equips of weapons into snakeSoldiers', async function () {
+      // This asset is not equippable
+      expect(
+        await weapon.canTokenBeEquippedWithAssetIntoSlot(
+          soldier.address,
+          weaponsIds[0],
+          weaponAssetsFull[0],
+          partIdForWeapon,
+        ),
+      ).to.eql(false);
+
+      // This asset is equippable into weapon part
+      expect(
+        await weapon.canTokenBeEquippedWithAssetIntoSlot(
+          soldier.address,
+          weaponsIds[0],
+          weaponAssetsEquip[0],
+          partIdForWeapon,
+        ),
+      ).to.eql(true);
+
+      // This asset is NOT equippable into weapon gem part
+      expect(
+        await weapon.canTokenBeEquippedWithAssetIntoSlot(
+          soldier.address,
+          weaponsIds[0],
+          weaponAssetsEquip[0],
+          partIdForWeaponGem,
+        ),
+      ).to.eql(false);
+    });
+
+    it('can validate equips of weapon gems into weapons', async function () {
+      // This asset is not equippable
+      expect(
+        await weaponGem.canTokenBeEquippedWithAssetIntoSlot(
+          weapon.address,
+          weaponGemsIds[0],
+          weaponGemAssetFull,
+          partIdForWeaponGem,
+        ),
+      ).to.eql(false);
+
+      // This asset is equippable into weapon gem slot
+      expect(
+        await weaponGem.canTokenBeEquippedWithAssetIntoSlot(
+          weapon.address,
+          weaponGemsIds[0],
+          weaponGemAssetEquip,
+          partIdForWeaponGem,
+        ),
+      ).to.eql(true);
+
+      // This asset is NOT equippable into background slot
+      expect(
+        await weaponGem.canTokenBeEquippedWithAssetIntoSlot(
+          weapon.address,
+          weaponGemsIds[0],
+          weaponGemAssetEquip,
+          partIdForBackground,
+        ),
+      ).to.eql(false);
+    });
+
+    it('can validate equips of backgrounds into snakeSoldiers', async function () {
+      // This asset is equippable into background slot
+      expect(
+        await background.canTokenBeEquippedWithAssetIntoSlot(
+          soldier.address,
+          backgroundsIds[0],
+          backgroundAssetId,
+          partIdForBackground,
+        ),
+      ).to.eql(true);
+
+      // This asset is NOT equippable into weapon slot
+      expect(
+        await background.canTokenBeEquippedWithAssetIntoSlot(
+          soldier.address,
+          backgroundsIds[0],
+          backgroundAssetId,
+          partIdForWeapon,
+        ),
+      ).to.eql(false);
+    });
+  });
+
+  describe('Equip', async function () {
+    it('can equip weapon', async function () {
+      // Weapon is child on index 0, background on index 1
+      const soldierOwner = addrs[0];
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await equipWeaponAndCheckFromAddress(soldierOwner, childIndex, weaponResId);
+    });
+
+    it('can equip weapon if approved', async function () {
+      // Weapon is child on index 0, background on index 1
+      const soldierOwner = addrs[0];
+      const approved = addrs[1];
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await soldier.connect(soldierOwner).approve(approved.address, snakeSoldiersIds[0]);
+      await equipWeaponAndCheckFromAddress(approved, childIndex, weaponResId);
+    });
+
+    it('can equip weapon if approved for all', async function () {
+      // Weapon is child on index 0, background on index 1
+      const soldierOwner = addrs[0];
+      const approved = addrs[1];
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await soldier.connect(soldierOwner).setApprovalForAll(approved.address, true);
+      await equipWeaponAndCheckFromAddress(approved, childIndex, weaponResId);
+    });
+
+    it('can equip weapon and background', async function () {
+      // Weapon is child on index 0, background on index 1
+      const weaponChildIndex = 0;
+      const backgroundChildIndex = 1;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await soldier
+        .connect(addrs[0])
+        .equip([snakeSoldiersIds[0], weaponChildIndex, soldierResId, partIdForWeapon, weaponResId]);
+      await soldier
+        .connect(addrs[0])
+        .equip([
+          snakeSoldiersIds[0],
+          backgroundChildIndex,
+          soldierResId,
+          partIdForBackground,
+          backgroundAssetId,
+        ]);
+
+      const expectedSlots = [bn(partIdForWeapon), bn(partIdForBackground)];
+      const expectedEquips = [
+        [bn(soldierResId), bn(weaponResId), bn(weaponsIds[0]), weapon.address],
+        [bn(soldierResId), bn(backgroundAssetId), bn(backgroundsIds[0]), background.address],
+      ];
+      expect(await view.getEquipped(soldier.address, snakeSoldiersIds[0], soldierResId)).to.eql([
+        expectedSlots,
+        expectedEquips,
+      ]);
+
+      // Children are marked as equipped:
+      expect(
+        await soldier.isChildEquipped(snakeSoldiersIds[0], weapon.address, weaponsIds[0]),
+      ).to.eql(true);
+      expect(
+        await soldier.isChildEquipped(snakeSoldiersIds[0], background.address, backgroundsIds[0]),
+      ).to.eql(true);
+    });
+
+    it('cannot equip non existing child in slot (weapon in background)', async function () {
+      // Weapon is child on index 0, background on index 1
+      const badChildIndex = 3;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await expect(
+        soldier
+          .connect(addrs[0])
+          .equip([snakeSoldiersIds[0], badChildIndex, soldierResId, partIdForWeapon, weaponResId]),
+      ).to.be.reverted; // Bad index
+    });
+
+    it('cannot set a valid equippable group with id 0', async function () {
+      const equippableGroupId = 0;
+      // The malicious child indicates it can be equipped into soldier:
+      await expect(
+        weaponGem.setValidParentForEquippableGroup(
+          equippableGroupId,
+          soldier.address,
+          partIdForWeaponGem,
+        ),
+      ).to.be.revertedWithCustomError(weaponGem, 'IdZeroForbidden');
+    });
+
+    it('cannot set a valid equippable group with part id 0', async function () {
+      const equippableGroupId = 1;
+      const partId = 0;
+      // The malicious child indicates it can be equipped into soldier:
+      await expect(
+        weaponGem.setValidParentForEquippableGroup(equippableGroupId, soldier.address, partId),
+      ).to.be.revertedWithCustomError(weaponGem, 'IdZeroForbidden');
+    });
+
+    it('cannot equip into a slot not set on the parent asset (gem into soldier)', async function () {
+      const soldierOwner = addrs[0];
+      const soldierId = snakeSoldiersIds[0];
+      const childIndex = 2;
+
+      const newWeaponGemId = await nestMint(weaponGem, soldier.address, soldierId);
+      await soldier
+        .connect(soldierOwner)
+        .acceptChild(soldierId, 0, weaponGem.address, newWeaponGemId);
+
+      // Add assets to weapon
+      await weaponGem.addAssetToToken(newWeaponGemId, weaponGemAssetFull, 0);
+      await weaponGem.addAssetToToken(newWeaponGemId, weaponGemAssetEquip, 0);
+      await weaponGem.connect(soldierOwner).acceptAsset(newWeaponGemId, 0, weaponGemAssetFull);
+      await weaponGem.connect(soldierOwner).acceptAsset(newWeaponGemId, 0, weaponGemAssetEquip);
+
+      // The malicious child indicates it can be equipped into soldier:
+      await weaponGem.setValidParentForEquippableGroup(
+        1, // equippableGroupId for gems
+        soldier.address,
+        partIdForWeaponGem,
+      );
+
+      // Weapon is child on index 0, background on index 1
+      await expect(
+        soldier
+          .connect(addrs[0])
+          .equip([soldierId, childIndex, soldierResId, partIdForWeaponGem, weaponGemAssetEquip]),
+      ).to.be.revertedWithCustomError(soldier, 'TargetAssetCannotReceiveSlot');
+    });
+
+    it('cannot equip wrong child in slot (weapon in background)', async function () {
+      // Weapon is child on index 0, background on index 1
+      const backgroundChildIndex = 1;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await expect(
+        soldier
+          .connect(addrs[0])
+          .equip([
+            snakeSoldiersIds[0],
+            backgroundChildIndex,
+            soldierResId,
+            partIdForWeapon,
+            weaponResId,
+          ]),
+      ).to.be.revertedWithCustomError(soldier, 'TokenCannotBeEquippedWithAssetIntoSlot');
+    });
+
+    it('cannot equip child in wrong slot (weapon in background)', async function () {
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await expect(
+        soldier
+          .connect(addrs[0])
+          .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForBackground, weaponResId]),
+      ).to.be.revertedWithCustomError(soldier, 'TokenCannotBeEquippedWithAssetIntoSlot');
+    });
+
+    it('cannot equip child with wrong asset (weapon in background)', async function () {
+      const childIndex = 0;
+      await expect(
+        soldier
+          .connect(addrs[0])
+          .equip([
+            snakeSoldiersIds[0],
+            childIndex,
+            soldierResId,
+            partIdForWeapon,
+            backgroundAssetId,
+          ]),
+      ).to.be.revertedWithCustomError(soldier, 'TokenCannotBeEquippedWithAssetIntoSlot');
+    });
+
+    it('cannot equip if not owner', async function () {
+      // Weapon is child on index 0, background on index 1
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await expect(
+        soldier
+          .connect(addrs[1]) // Owner is addrs[0]
+          .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]),
+      ).to.be.revertedWithCustomError(soldier, 'ERC721NotApprovedOrOwner');
+    });
+
+    it('cannot equip 2 children into the same slot', async function () {
+      // Weapon is child on index 0, background on index 1
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await soldier
+        .connect(addrs[0])
+        .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]);
+
+      const weaponAssetIndex = 3;
+      await mintWeaponToSoldier(addrs[0], snakeSoldiersIds[0], weaponAssetIndex);
+
+      const newWeaponChildIndex = 2;
+      const newWeaponResId = weaponAssetsEquip[weaponAssetIndex];
+      await expect(
+        soldier
+          .connect(addrs[0])
+          .equip([
+            snakeSoldiersIds[0],
+            newWeaponChildIndex,
+            soldierResId,
+            partIdForWeapon,
+            newWeaponResId,
+          ]),
+      ).to.be.revertedWithCustomError(soldier, 'SlotAlreadyUsed');
+    });
+
+    it('cannot equip if not intented on catalog', async function () {
+      // Weapon is child on index 0, background on index 1
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+
+      // Remove equippable addresses for part.
+      await catalog.resetEquippableAddresses(partIdForWeapon);
+      await expect(
+        soldier
+          .connect(addrs[0]) // Owner is addrs[0]
+          .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]),
+      ).to.be.revertedWithCustomError(soldier, 'EquippableEquipNotAllowedByCatalog');
+    });
+  });
+
+  describe('Unequip', async function () {
+    it('can unequip', async function () {
+      // Weapon is child on index 0, background on index 1
+      const soldierOwner = addrs[0];
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+
+      await soldier
+        .connect(soldierOwner)
+        .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]);
+
+      await unequipWeaponAndCheckFromAddress(soldierOwner);
+    });
+
+    it('can unequip if approved', async function () {
+      // Weapon is child on index 0, background on index 1
+      const soldierOwner = addrs[0];
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      const approved = addrs[1];
+
+      await soldier
+        .connect(soldierOwner)
+        .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]);
+
+      await soldier.connect(soldierOwner).approve(approved.address, snakeSoldiersIds[0]);
+      await unequipWeaponAndCheckFromAddress(approved);
+    });
+
+    it('can unequip if approved for all', async function () {
+      // Weapon is child on index 0, background on index 1
+      const soldierOwner = addrs[0];
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      const approved = addrs[1];
+
+      await soldier
+        .connect(soldierOwner)
+        .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]);
+
+      await soldier.connect(soldierOwner).setApprovalForAll(approved.address, true);
+      await unequipWeaponAndCheckFromAddress(approved);
+    });
+
+    it('cannot unequip if not equipped', async function () {
+      await expect(
+        soldier.connect(addrs[0]).unequip(snakeSoldiersIds[0], soldierResId, partIdForWeapon),
+      ).to.be.revertedWithCustomError(soldier, 'NotEquipped');
+    });
+
+    it('cannot unequip if not owner', async function () {
+      // Weapon is child on index 0, background on index 1
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await soldier
+        .connect(addrs[0])
+        .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]);
+
+      await expect(
+        soldier.connect(addrs[1]).unequip(snakeSoldiersIds[0], soldierResId, partIdForWeapon),
+      ).to.be.revertedWithCustomError(soldier, 'ERC721NotApprovedOrOwner');
+    });
+  });
+
+  describe('Transfer equipped', async function () {
+    it('can unequip and transfer child', async function () {
+      // Weapon is child on index 0, background on index 1
+      const soldierOwner = addrs[0];
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+
+      await soldier
+        .connect(soldierOwner)
+        .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]);
+
+      await unequipWeaponAndCheckFromAddress(soldierOwner);
+      await soldier
+        .connect(soldierOwner)
+        .transferChild(
+          snakeSoldiersIds[0],
+          soldierOwner.address,
+          0,
+          childIndex,
+          weapon.address,
+          weaponsIds[0],
+          false,
+          '0x',
+        );
+    });
+
+    it('child transfer fails if child is equipped', async function () {
+      const soldierOwner = addrs[0];
+      // Weapon is child on index 0
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await soldier
+        .connect(addrs[0])
+        .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]);
+
+      await expect(
+        soldier
+          .connect(soldierOwner)
+          .transferChild(
+            snakeSoldiersIds[0],
+            soldierOwner.address,
+            0,
+            childIndex,
+            weapon.address,
+            weaponsIds[0],
+            false,
+            '0x',
+          ),
+      ).to.be.revertedWithCustomError(weapon, 'MustUnequipFirst');
+    });
+  });
+
+  describe('Compose', async function () {
+    it('can compose equippables for soldier', async function () {
+      const childIndex = 0;
+      const weaponResId = weaponAssetsEquip[0]; // This asset is assigned to weapon first weapon
+      await soldier
+        .connect(addrs[0])
+        .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]);
+
+      const expectedFixedParts = [
+        [
+          bn(partIdForBody), // partId
+          1, // z
+          'genericBody.png', // metadataURI
+        ],
+      ];
+      const expectedSlotParts = [
+        [
+          bn(partIdForWeapon), // partId
+          bn(weaponAssetsEquip[0]), // childAssetId
+          2, // z
+          weapon.address, // childAddress
+          bn(weaponsIds[0]), // childTokenId
+          'ipfs:weapon/equip/5', // childAssetMetadata
+          '', // partMetadata
+        ],
+        [
+          // Nothing on equipped on background slot:
+          bn(partIdForBackground), // partId
+          bn(0), // childAssetId
+          0, // z
+          ethers.constants.AddressZero, // childAddress
+          bn(0), // childTokenId
+          '', // childAssetMetadata
+          'noBackground.png', // partMetadata
+        ],
+      ];
+      const allAssets = await view.composeEquippables(
+        soldier.address,
+        snakeSoldiersIds[0],
+        soldierResId,
+      );
+      expect(allAssets).to.eql([
+        'ipfs:soldier/', // metadataURI
+        bn(0), // equippableGroupId
+        catalog.address, // catalogAddress
+        expectedFixedParts,
+        expectedSlotParts,
+      ]);
+    });
+
+    it('can compose equippables for simple asset', async function () {
+      const allAssets = await view.composeEquippables(
+        background.address,
+        backgroundsIds[0],
+        backgroundAssetId,
+      );
+      expect(allAssets).to.eql([
+        'ipfs:background/', // metadataURI
+        bn(1), // equippableGroupId
+        catalog.address, // catalogAddress,
+        [],
+        [],
+      ]);
+    });
+
+    it('cannot compose equippables for soldier with not associated asset', async function () {
+      const wrongResId = weaponAssetsEquip[1];
+      await expect(
+        view.composeEquippables(weapon.address, weaponsIds[0], wrongResId),
+      ).to.be.revertedWithCustomError(weapon, 'TokenDoesNotHaveAsset');
+    });
+  });
+
+  async function equipWeaponAndCheckFromAddress(
+    from: SignerWithAddress,
+    childIndex: number,
+    weaponResId: number,
+  ): Promise<void> {
+    await expect(
+      soldier
+        .connect(from)
+        .equip([snakeSoldiersIds[0], childIndex, soldierResId, partIdForWeapon, weaponResId]),
+    )
+      .to.emit(soldier, 'ChildAssetEquipped')
+      .withArgs(
+        snakeSoldiersIds[0],
+        soldierResId,
+        partIdForWeapon,
+        weaponsIds[0],
+        weapon.address,
+        weaponAssetsEquip[0],
+      );
+    // All part slots are included on the response:
+    const expectedSlots = [bn(partIdForWeapon), bn(partIdForBackground)];
+    // If a slot has nothing equipped, it returns an empty equip:
+    const expectedEquips = [
+      [bn(soldierResId), bn(weaponResId), bn(weaponsIds[0]), weapon.address],
+      [bn(0), bn(0), bn(0), ethers.constants.AddressZero],
+    ];
+    expect(await view.getEquipped(soldier.address, snakeSoldiersIds[0], soldierResId)).to.eql([
+      expectedSlots,
+      expectedEquips,
+    ]);
+
+    // Child is marked as equipped:
+    expect(
+      await soldier.isChildEquipped(snakeSoldiersIds[0], weapon.address, weaponsIds[0]),
+    ).to.eql(true);
+  }
+
+  async function unequipWeaponAndCheckFromAddress(from: SignerWithAddress): Promise<void> {
+    await expect(soldier.connect(from).unequip(snakeSoldiersIds[0], soldierResId, partIdForWeapon))
+      .to.emit(soldier, 'ChildAssetUnequipped')
+      .withArgs(
+        snakeSoldiersIds[0],
+        soldierResId,
+        partIdForWeapon,
+        weaponsIds[0],
+        weapon.address,
+        weaponAssetsEquip[0],
+      );
+
+    const expectedSlots = [bn(partIdForWeapon), bn(partIdForBackground)];
+    // If a slot has nothing equipped, it returns an empty equip:
+    const expectedEquips = [
+      [bn(0), bn(0), bn(0), ethers.constants.AddressZero],
+      [bn(0), bn(0), bn(0), ethers.constants.AddressZero],
+    ];
+    expect(await view.getEquipped(soldier.address, snakeSoldiersIds[0], soldierResId)).to.eql([
+      expectedSlots,
+      expectedEquips,
+    ]);
+
+    // Child is marked as not equipped:
+    expect(
+      await soldier.isChildEquipped(snakeSoldiersIds[0], weapon.address, weaponsIds[0]),
+    ).to.eql(false);
+  }
+
+  async function mintWeaponToSoldier(
+    soldierOwner: SignerWithAddress,
+    soldierId: number,
+    assetIndex: number,
+  ): Promise<number> {
+    // Mint another weapon to the soldier and accept it
+    const newWeaponId = await nestMint(weapon, soldier.address, soldierId);
+    await soldier.connect(soldierOwner).acceptChild(soldierId, 0, weapon.address, newWeaponId);
+
+    // Add assets to weapon
+    await weapon.addAssetToToken(newWeaponId, weaponAssetsFull[assetIndex], 0);
+    await weapon.addAssetToToken(newWeaponId, weaponAssetsEquip[assetIndex], 0);
+    await weapon.connect(soldierOwner).acceptAsset(newWeaponId, 0, weaponAssetsFull[assetIndex]);
+    await weapon.connect(soldierOwner).acceptAsset(newWeaponId, 0, weaponAssetsEquip[assetIndex]);
+
+    return newWeaponId;
+  }
+});
+
+function bn(x: number): BigNumber {
+  return BigNumber.from(x);
+}
diff --git a/assets/eip-6220/test/multiasset.ts b/assets/eip-6220/test/multiasset.ts
new file mode 100644
index 00000000000000..0d511556bacd41
--- /dev/null
+++ b/assets/eip-6220/test/multiasset.ts
@@ -0,0 +1,670 @@
+import { SignerWithAddress } from '@nomiclabs/hardhat-ethers/signers';
+import { expect } from 'chai';
+import { ethers } from 'hardhat';
+import {
+  EquippableTokenMock,
+  ERC721ReceiverMock,
+  MultiAssetRenderUtils,
+  NonReceiverMock
+} from '../typechain-types';
+
+describe('MultiAsset', async () => {
+  let token: EquippableTokenMock;
+  let renderUtils: MultiAssetRenderUtils;
+  let nonReceiver: NonReceiverMock;
+  let receiver721: ERC721ReceiverMock;
+
+  let owner: SignerWithAddress;
+  let addrs: SignerWithAddress[];
+
+  const metaURIDefault = 'metaURI';
+
+  beforeEach(async () => {
+    [owner, ...addrs] = await ethers.getSigners();
+
+    const equppableFactory = await ethers.getContractFactory('EquippableTokenMock');
+    token = await equppableFactory.deploy();
+    await token.deployed();
+
+    const renderFactory = await ethers.getContractFactory('MultiAssetRenderUtils');
+    renderUtils = await renderFactory.deploy();
+    await renderUtils.deployed();
+  });
+
+  describe('ERC165 check', async function () {
+    it('can support IERC165', async function () {
+      expect(await token.supportsInterface('0x01ffc9a7')).to.equal(true);
+    });
+
+    it('can support IERC721', async function () {
+      expect(await token.supportsInterface('0x80ac58cd')).to.equal(true);
+    });
+
+    it('can support IMultiAsset', async function () {
+      expect(await token.supportsInterface('0xd1526708')).to.equal(true);
+    });
+
+    it('cannot support other interfaceId', async function () {
+      expect(await token.supportsInterface('0xffffffff')).to.equal(false);
+    });
+  });
+
+  describe('Check OnReceived ERC721 and Multiasset', async function () {
+    it('Revert on transfer to non onERC721/onMultiasset implementer', async function () {
+      const tokenId = 1;
+      await token.mint(owner.address, tokenId);
+
+      const NonReceiver = await ethers.getContractFactory('NonReceiverMock');
+      nonReceiver = await NonReceiver.deploy();
+      await nonReceiver.deployed();
+
+      await expect(
+        token
+          .connect(owner)
+          ['safeTransferFrom(address,address,uint256)'](owner.address, nonReceiver.address, 1),
+      ).to.be.revertedWithCustomError(token, 'ERC721TransferToNonReceiverImplementer');
+    });
+
+    it('onERC721Received callback on transfer', async function () {
+      const tokenId = 1;
+      await token.mint(owner.address, tokenId);
+
+      const ERC721Receiver = await ethers.getContractFactory('ERC721ReceiverMock');
+      receiver721 = await ERC721Receiver.deploy();
+      await receiver721.deployed();
+
+      await token
+        .connect(owner)
+        ['safeTransferFrom(address,address,uint256)'](owner.address, receiver721.address, 1);
+      expect(await token.ownerOf(1)).to.equal(receiver721.address);
+    });
+  });
+
+  describe('Asset storage', async function () {
+    it('can add asset', async function () {
+      const id = 10;
+
+      await expect(token.addAssetEntry(id, metaURIDefault)).to.emit(token, 'AssetSet').withArgs(id);
+    });
+
+    it('cannot get non existing asset', async function () {
+      const tokenId = 1;
+      const resId = 10;
+      await token.mint(owner.address, tokenId);
+      await expect(token.getAssetMetadata(tokenId, resId)).to.be.revertedWithCustomError(
+        token,
+        'TokenDoesNotHaveAsset',
+      );
+    });
+
+    it('cannot add asset entry if not issuer', async function () {
+      const id = 10;
+      await expect(token.connect(addrs[1]).addAssetEntry(id, metaURIDefault)).to.be.revertedWith(
+        'RMRK: Only issuer',
+      );
+    });
+
+    it('can set and get issuer', async function () {
+      const newIssuerAddr = addrs[1].address;
+      expect(await token.getIssuer()).to.equal(owner.address);
+
+      await token.setIssuer(newIssuerAddr);
+      expect(await token.getIssuer()).to.equal(newIssuerAddr);
+    });
+
+    it('cannot set issuer if not issuer', async function () {
+      const newIssuer = addrs[1];
+      await expect(token.connect(newIssuer).setIssuer(newIssuer.address)).to.be.revertedWith(
+        'RMRK: Only issuer',
+      );
+    });
+
+    it('cannot overwrite asset', async function () {
+      const id = 10;
+
+      await token.addAssetEntry(id, metaURIDefault);
+      await expect(token.addAssetEntry(id, metaURIDefault)).to.be.revertedWithCustomError(
+        token,
+        'AssetAlreadyExists',
+      );
+    });
+
+    it('cannot add asset with id 0', async function () {
+      const id = ethers.utils.hexZeroPad('0x0', 8);
+
+      await expect(token.addAssetEntry(id, metaURIDefault)).to.be.revertedWithCustomError(
+        token,
+        'IdZeroForbidden',
+      );
+    });
+
+    it('cannot add same asset twice', async function () {
+      const id = 10;
+
+      await expect(token.addAssetEntry(id, metaURIDefault)).to.emit(token, 'AssetSet').withArgs(id);
+
+      await expect(token.addAssetEntry(id, metaURIDefault)).to.be.revertedWithCustomError(
+        token,
+        'AssetAlreadyExists',
+      );
+    });
+  });
+
+  describe('Adding assets', async function () {
+    it('can add asset to token', async function () {
+      const resId = 1;
+      const resId2 = 2;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId, resId2]);
+      await expect(token.addAssetToToken(tokenId, resId, 0)).to.emit(token, 'AssetAddedToToken');
+      await expect(token.addAssetToToken(tokenId, resId2, 0)).to.emit(token, 'AssetAddedToToken');
+
+      const pendingIds = await token.getPendingAssets(tokenId);
+      expect(await renderUtils.getAssetsById(token.address, tokenId, pendingIds)).to.be.eql([
+        metaURIDefault,
+        metaURIDefault,
+      ]);
+    });
+
+    it('cannot add non existing asset to token', async function () {
+      const resId = 1;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await expect(token.addAssetToToken(tokenId, resId, 0)).to.be.revertedWithCustomError(
+        token,
+        'NoAssetMatchingId',
+      );
+    });
+
+    it('can add asset to non existing token and it is pending when minted', async function () {
+      const resId = 1;
+      const tokenId = 1;
+      await addAssets([resId]);
+
+      await token.addAssetToToken(tokenId, resId, 0);
+      await token.mint(owner.address, tokenId);
+      expect(await token.getPendingAssets(tokenId)).to.eql([ethers.BigNumber.from(resId)]);
+    });
+
+    it('cannot add asset twice to the same token', async function () {
+      const resId = 1;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId]);
+      await token.addAssetToToken(tokenId, resId, 0);
+      await expect(
+        token.addAssetToToken(tokenId, ethers.BigNumber.from(resId), 0),
+      ).to.be.revertedWithCustomError(token, 'AssetAlreadyExists');
+    });
+
+    it('cannot add too many assets to the same token', async function () {
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      for (let i = 1; i <= 128; i++) {
+        await addAssets([i]);
+        await token.addAssetToToken(tokenId, i, 0);
+      }
+
+      // Now it's full, next should fail
+      const resId = 129;
+      await addAssets([resId]);
+      await expect(token.addAssetToToken(tokenId, resId, 0)).to.be.revertedWithCustomError(
+        token,
+        'MaxPendingAssetsReached',
+      );
+    });
+
+    it('can add same asset to 2 different tokens', async function () {
+      const resId = 1;
+      const tokenId1 = 1;
+      const tokenId2 = 2;
+
+      await token.mint(owner.address, tokenId1);
+      await token.mint(owner.address, tokenId2);
+      await addAssets([resId]);
+      await token.addAssetToToken(tokenId1, resId, 0);
+      await token.addAssetToToken(tokenId2, resId, 0);
+    });
+  });
+
+  describe('Accepting assets', async function () {
+    it('can accept asset if owner', async function () {
+      const { tokenOwner, tokenId } = await mintSampleToken();
+      const approved = tokenOwner;
+
+      await checkAcceptFromAddress(approved, tokenId);
+    });
+
+    it('can accept asset if approved for assets', async function () {
+      const { tokenId } = await mintSampleToken();
+      const approved = addrs[1];
+
+      await token.approveForAssets(approved.address, tokenId);
+      await checkAcceptFromAddress(approved, tokenId);
+    });
+
+    it('can accept asset if approved for assets for all', async function () {
+      const { tokenId } = await mintSampleToken();
+      const approved = addrs[2];
+
+      await token.setApprovalForAllForAssets(approved.address, true);
+      await checkAcceptFromAddress(approved, tokenId);
+    });
+
+    it('can accept multiple assets', async function () {
+      const resId = 1;
+      const resId2 = 2;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId, resId2]);
+      await token.addAssetToToken(tokenId, resId, 0);
+      await token.addAssetToToken(tokenId, resId2, 0);
+      await expect(token.acceptAsset(tokenId, 1, resId2))
+        .to.emit(token, 'AssetAccepted')
+        .withArgs(tokenId, resId2, 0);
+      await expect(token.acceptAsset(tokenId, 0, resId))
+        .to.emit(token, 'AssetAccepted')
+        .withArgs(tokenId, resId, 0);
+
+      expect(await token.getPendingAssets(tokenId)).to.be.eql([]);
+
+      const activeIds = await token.getActiveAssets(tokenId);
+      expect(await renderUtils.getAssetsById(token.address, tokenId, activeIds)).to.eql([
+        metaURIDefault,
+        metaURIDefault,
+      ]);
+    });
+
+    it('cannot accept asset twice', async function () {
+      const resId = 1;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId]);
+      await token.addAssetToToken(tokenId, resId, 0);
+      await token.acceptAsset(tokenId, 0, resId);
+    });
+
+    it('cannot accept asset if not owner', async function () {
+      const resId = 1;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId]);
+      await token.addAssetToToken(tokenId, resId, 0);
+      await expect(
+        token.connect(addrs[1]).acceptAsset(tokenId, 0, resId),
+      ).to.be.revertedWithCustomError(token, 'NotApprovedForAssetsOrOwner');
+    });
+
+    it('cannot accept non existing asset', async function () {
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await expect(token.acceptAsset(tokenId, 0, 1)).to.be.revertedWithCustomError(
+        token,
+        'IndexOutOfRange',
+      );
+    });
+  });
+
+  describe('Overwriting assets', async function () {
+    it('can add asset to token overwritting an existing one', async function () {
+      const resId = 1;
+      const resId2 = 2;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId, resId2]);
+      await token.addAssetToToken(tokenId, resId, 0);
+      await token.acceptAsset(tokenId, 0, resId);
+
+      // Add new asset to overwrite the first, and accept
+      const activeAssets = await token.getActiveAssets(tokenId);
+      await expect(token.addAssetToToken(tokenId, resId2, activeAssets[0]))
+        .to.emit(token, 'AssetAddedToToken')
+        .withArgs(tokenId, resId2, resId);
+      const pendingAssets = await token.getPendingAssets(tokenId);
+
+      expect(await token.getAssetReplacements(tokenId, pendingAssets[0])).to.eql(activeAssets[0]);
+      await expect(token.acceptAsset(tokenId, 0, resId2))
+        .to.emit(token, 'AssetAccepted')
+        .withArgs(tokenId, resId2, resId);
+
+      const activeIds = await token.getActiveAssets(tokenId);
+      expect(await renderUtils.getAssetsById(token.address, tokenId, activeIds)).to.eql([
+        metaURIDefault,
+      ]);
+      // Overwrite should be gone
+      expect(await token.getAssetReplacements(tokenId, pendingAssets[0])).to.eql(
+        ethers.BigNumber.from(0),
+      );
+    });
+
+    it('can overwrite non existing asset to token, it could have been deleted', async function () {
+      const resId = 1;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId]);
+      await token.addAssetToToken(tokenId, resId, ethers.utils.hexZeroPad('0x1', 8));
+      await token.acceptAsset(tokenId, 0, resId);
+
+      const activeIds = await token.getActiveAssets(tokenId);
+      expect(await renderUtils.getAssetsById(token.address, tokenId, activeIds)).to.eql([
+        metaURIDefault,
+      ]);
+    });
+  });
+
+  describe('Rejecting assets', async function () {
+    it('can reject asset if owner', async function () {
+      const { tokenOwner, tokenId } = await mintSampleToken();
+      const approved = tokenOwner;
+
+      await checkRejectFromAddress(approved, tokenId);
+    });
+
+    it('can reject asset if approved for assets', async function () {
+      const { tokenId } = await mintSampleToken();
+      const approved = addrs[1];
+
+      await token.approveForAssets(approved.address, tokenId);
+      await checkRejectFromAddress(approved, tokenId);
+    });
+
+    it('can reject asset if approved for assets for all', async function () {
+      const { tokenId } = await mintSampleToken();
+      const approved = addrs[2];
+
+      await token.setApprovalForAllForAssets(approved.address, true);
+      await checkRejectFromAddress(approved, tokenId);
+    });
+
+    it('can reject all assets if owner', async function () {
+      const { tokenOwner, tokenId } = await mintSampleToken();
+      const approved = tokenOwner;
+
+      await checkRejectAllFromAddress(approved, tokenId);
+    });
+
+    it('can reject all assets if approved for assets', async function () {
+      const { tokenId } = await mintSampleToken();
+      const approved = addrs[1];
+
+      await token.approveForAssets(approved.address, tokenId);
+      await checkRejectAllFromAddress(approved, tokenId);
+    });
+
+    it('can reject all assets if approved for assets for all', async function () {
+      const { tokenId } = await mintSampleToken();
+      const approved = addrs[2];
+
+      await token.setApprovalForAllForAssets(approved.address, true);
+      await checkRejectAllFromAddress(approved, tokenId);
+    });
+
+    it('can reject asset and overwrites are cleared', async function () {
+      const resId = 1;
+      const resId2 = 2;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId, resId2]);
+      await token.addAssetToToken(tokenId, resId, 0);
+      await token.acceptAsset(tokenId, 0, resId);
+
+      // Will try to overwrite but we reject it
+      await token.addAssetToToken(tokenId, resId2, resId);
+      await token.rejectAsset(tokenId, 0, resId2);
+
+      expect(await token.getAssetReplacements(tokenId, resId2)).to.eql(ethers.BigNumber.from(0));
+    });
+
+    it('can reject all assets and overwrites are cleared', async function () {
+      const resId = 1;
+      const resId2 = 2;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId, resId2]);
+      await token.addAssetToToken(tokenId, resId, 0);
+      await token.acceptAsset(tokenId, 0, resId);
+
+      // Will try to overwrite but we reject all
+      await token.addAssetToToken(tokenId, resId2, resId);
+      await token.rejectAllAssets(tokenId, 1);
+
+      expect(await token.getAssetReplacements(tokenId, resId2)).to.eql(ethers.BigNumber.from(0));
+    });
+
+    it('can reject all pending assets at max capacity', async function () {
+      const tokenId = 1;
+      const resArr = [];
+
+      for (let i = 1; i < 128; i++) {
+        resArr.push(i);
+      }
+
+      await token.mint(owner.address, tokenId);
+      await addAssets(resArr);
+
+      for (let i = 1; i < 128; i++) {
+        await token.addAssetToToken(tokenId, i, 1);
+      }
+      await token.rejectAllAssets(tokenId, 128);
+
+      expect(await token.getAssetReplacements(1, 2)).to.eql(ethers.BigNumber.from(0));
+    });
+
+    it('cannot reject asset twice', async function () {
+      const resId = 1;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId]);
+      await token.addAssetToToken(tokenId, resId, 0);
+      await token.rejectAsset(tokenId, 0, resId);
+    });
+
+    it('cannot reject asset nor reject all if not owner', async function () {
+      const resId = 1;
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await addAssets([resId]);
+      await token.addAssetToToken(tokenId, resId, 0);
+
+      await expect(
+        token.connect(addrs[1]).rejectAsset(tokenId, 0, resId),
+      ).to.be.revertedWithCustomError(token, 'NotApprovedForAssetsOrOwner');
+      await expect(
+        token.connect(addrs[1]).rejectAllAssets(tokenId, 1),
+      ).to.be.revertedWithCustomError(token, 'NotApprovedForAssetsOrOwner');
+    });
+
+    it('cannot reject non existing asset', async function () {
+      const tokenId = 1;
+
+      await token.mint(owner.address, tokenId);
+      await expect(token.rejectAsset(tokenId, 0, 1)).to.be.revertedWithCustomError(
+        token,
+        'IndexOutOfRange',
+      );
+    });
+  });
+
+  describe('Priorities', async function () {
+    it('can set and get priorities', async function () {
+      const tokenId = 1;
+      await addAssetsToToken(tokenId);
+
+      expect(await token.getActiveAssetPriorities(tokenId)).to.be.eql([0, 1]);
+      await expect(token.setPriority(tokenId, [2, 1]))
+        .to.emit(token, 'AssetPrioritySet')
+        .withArgs(tokenId);
+      expect(await token.getActiveAssetPriorities(tokenId)).to.be.eql([2, 1]);
+    });
+
+    it('cannot set priorities for non owned token', async function () {
+      const tokenId = 1;
+      await addAssetsToToken(tokenId);
+      await expect(
+        token.connect(addrs[1]).setPriority(tokenId, [2, 1]),
+      ).to.be.revertedWithCustomError(token, 'NotApprovedForAssetsOrOwner');
+    });
+
+    it('cannot set different number of priorities', async function () {
+      const tokenId = 1;
+      await addAssetsToToken(tokenId);
+      await expect(token.setPriority(tokenId, [1])).to.be.revertedWithCustomError(
+        token,
+        'BadPriorityListLength',
+      );
+      await expect(token.setPriority(tokenId, [2, 1, 3])).to.be.revertedWithCustomError(
+        token,
+        'BadPriorityListLength',
+      );
+    });
+
+    it('cannot set priorities for non existing token', async function () {
+      const tokenId = 1;
+      await expect(token.connect(addrs[1]).setPriority(tokenId, [])).to.be.revertedWithCustomError(
+        token,
+        'ERC721InvalidTokenId',
+      );
+    });
+  });
+
+  describe('Approval Cleaning', async function () {
+    it('cleans token and assets approvals on transfer', async function () {
+      const tokenId = 1;
+      const tokenOwner = addrs[1];
+      const newOwner = addrs[2];
+      const approved = addrs[3];
+      await token.mint(tokenOwner.address, tokenId);
+      await token.connect(tokenOwner).approve(approved.address, tokenId);
+      await token.connect(tokenOwner).approveForAssets(approved.address, tokenId);
+
+      expect(await token.getApproved(tokenId)).to.eql(approved.address);
+      expect(await token.getApprovedForAssets(tokenId)).to.eql(approved.address);
+
+      await token.connect(tokenOwner).transfer(newOwner.address, tokenId);
+
+      expect(await token.getApproved(tokenId)).to.eql(ethers.constants.AddressZero);
+      expect(await token.getApprovedForAssets(tokenId)).to.eql(ethers.constants.AddressZero);
+    });
+
+    it('cleans token and assets approvals on burn', async function () {
+      const tokenId = 1;
+      const tokenOwner = addrs[1];
+      const approved = addrs[3];
+      await token.mint(tokenOwner.address, tokenId);
+      await token.connect(tokenOwner).approve(approved.address, tokenId);
+      await token.connect(tokenOwner).approveForAssets(approved.address, tokenId);
+
+      expect(await token.getApproved(tokenId)).to.eql(approved.address);
+      expect(await token.getApprovedForAssets(tokenId)).to.eql(approved.address);
+
+      await token.connect(tokenOwner)['burn(uint256)'](tokenId);
+
+      await expect(token.getApproved(tokenId)).to.be.revertedWithCustomError(
+        token,
+        'ERC721InvalidTokenId',
+      );
+      await expect(token.getApprovedForAssets(tokenId)).to.be.revertedWithCustomError(
+        token,
+        'ERC721InvalidTokenId',
+      );
+    });
+  });
+
+  async function mintSampleToken(): Promise<{ tokenOwner: SignerWithAddress; tokenId: number }> {
+    const tokenOwner = owner;
+    const tokenId = 1;
+    await token.mint(tokenOwner.address, tokenId);
+
+    return { tokenOwner, tokenId };
+  }
+
+  async function addAssets(ids: number[]): Promise<void> {
+    ids.forEach(async (resId) => {
+      await token.addAssetEntry(resId, metaURIDefault);
+    });
+  }
+
+  async function addAssetsToToken(tokenId: number): Promise<void> {
+    const resId = 1;
+    const resId2 = 2;
+    await token.mint(owner.address, tokenId);
+    await addAssets([resId, resId2]);
+    await token.addAssetToToken(tokenId, resId, 0);
+    await token.addAssetToToken(tokenId, resId2, 0);
+    await token.acceptAsset(tokenId, 0, resId);
+    await token.acceptAsset(tokenId, 0, resId2);
+  }
+
+  async function checkAcceptFromAddress(
+    accepter: SignerWithAddress,
+    tokenId: number,
+  ): Promise<void> {
+    const resId = 1;
+
+    await addAssets([resId]);
+    await token.addAssetToToken(tokenId, resId, 0);
+    await expect(token.connect(accepter).acceptAsset(tokenId, 0, resId))
+      .to.emit(token, 'AssetAccepted')
+      .withArgs(tokenId, resId, 0);
+
+    expect(await token.getPendingAssets(tokenId)).to.be.eql([]);
+
+    const activeIds = await token.getActiveAssets(tokenId);
+    expect(await renderUtils.getAssetsById(token.address, tokenId, activeIds)).to.eql([
+      metaURIDefault,
+    ]);
+  }
+
+  async function checkRejectFromAddress(
+    rejecter: SignerWithAddress,
+    tokenId: number,
+  ): Promise<void> {
+    const resId = 1;
+
+    await addAssets([resId]);
+    await token.addAssetToToken(tokenId, resId, 0);
+
+    await expect(token.connect(rejecter).rejectAsset(tokenId, 0, resId)).to.emit(
+      token,
+      'AssetRejected',
+    );
+
+    expect(await token.getPendingAssets(tokenId)).to.be.eql([]);
+    expect(await token.getActiveAssets(tokenId)).to.be.eql([]);
+  }
+
+  async function checkRejectAllFromAddress(
+    rejecter: SignerWithAddress,
+    tokenId: number,
+  ): Promise<void> {
+    const resId = 1;
+    const resId2 = 2;
+
+    await addAssets([resId, resId2]);
+    await token.addAssetToToken(tokenId, resId, 0);
+    await token.addAssetToToken(tokenId, resId2, 0);
+
+    await expect(token.connect(rejecter).rejectAllAssets(tokenId, 2)).to.emit(
+      token,
+      'AssetRejected',
+    );
+
+    expect(await token.getPendingAssets(tokenId)).to.be.eql([]);
+    expect(await token.getActiveAssets(tokenId)).to.be.eql([]);
+  }
+});
diff --git a/assets/eip-6220/test/nestable.ts b/assets/eip-6220/test/nestable.ts
new file mode 100644
index 00000000000000..88a0b863f45fac
--- /dev/null
+++ b/assets/eip-6220/test/nestable.ts
@@ -0,0 +1,1180 @@
+import { loadFixture } from '@nomicfoundation/hardhat-network-helpers';
+import { SignerWithAddress } from '@nomiclabs/hardhat-ethers/signers';
+import { expect } from 'chai';
+import { BigNumber, constants } from 'ethers';
+import { ethers } from 'hardhat';
+import { EquippableTokenMock } from '../typechain-types';
+
+function bn(x: number): BigNumber {
+  return BigNumber.from(x);
+}
+
+const ADDRESS_ZERO = constants.AddressZero;
+
+async function parentChildFixture(): Promise<{
+  parent: EquippableTokenMock;
+  child: EquippableTokenMock;
+}> {
+  const factory = await ethers.getContractFactory('EquippableTokenMock');
+
+  const parent = await factory.deploy();
+  await parent.deployed();
+  const child = await factory.deploy();
+  await child.deployed();
+  return { parent, child };
+}
+
+describe('NestableToken', function () {
+  let parent: EquippableTokenMock;
+  let child: EquippableTokenMock;
+  let owner: SignerWithAddress;
+  let tokenOwner: SignerWithAddress;
+  let addrs: SignerWithAddress[];
+
+  beforeEach(async function () {
+    [owner, tokenOwner, ...addrs] = await ethers.getSigners();
+    ({ parent, child } = await loadFixture(parentChildFixture));
+  });
+
+  describe('Minting', async function () {
+    it('cannot mint id 0', async function () {
+      const tokenId1 = 0;
+      await expect(child.mint(owner.address, tokenId1)).to.be.revertedWithCustomError(
+        child,
+        'IdZeroForbidden',
+      );
+    });
+
+    it('cannot nest mint id 0', async function () {
+      const parentId = 1;
+      await child.mint(owner.address, parentId);
+      const childId1 = 0;
+      await expect(
+        child.nestMint(parent.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'IdZeroForbidden');
+    });
+
+    it('cannot mint already minted token', async function () {
+      const tokenId1 = 1;
+      await child.mint(owner.address, tokenId1);
+      await expect(child.mint(owner.address, tokenId1)).to.be.revertedWithCustomError(
+        child,
+        'ERC721TokenAlreadyMinted',
+      );
+    });
+
+    it('cannot nest mint already minted token', async function () {
+      const parentId = 1;
+      const childId1 = 99;
+      await parent.mint(owner.address, parentId);
+      await child.nestMint(parent.address, childId1, parentId);
+
+      await expect(
+        child.nestMint(parent.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'ERC721TokenAlreadyMinted');
+    });
+
+    it('cannot nest mint already minted token', async function () {
+      const parentId = 1;
+      const childId1 = 99;
+      await parent.mint(owner.address, parentId);
+      await child.nestMint(parent.address, childId1, parentId);
+
+      await expect(
+        child.nestMint(parent.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'ERC721TokenAlreadyMinted');
+    });
+
+    it('can mint with no destination', async function () {
+      const tokenId1 = 1;
+      await child.mint(tokenOwner.address, tokenId1);
+      expect(await child.ownerOf(tokenId1)).to.equal(tokenOwner.address);
+      expect(await child.directOwnerOf(tokenId1)).to.eql([tokenOwner.address, bn(0), false]);
+    });
+
+    it('has right owners', async function () {
+      const otherOwner = addrs[2];
+      const tokenId1 = 1;
+      await parent.mint(tokenOwner.address, tokenId1);
+      const tokenId2 = 2;
+      await parent.mint(otherOwner.address, tokenId2);
+      const tokenId3 = 3;
+      await parent.mint(otherOwner.address, tokenId3);
+
+      expect(await parent.ownerOf(tokenId1)).to.equal(tokenOwner.address);
+      expect(await parent.ownerOf(tokenId2)).to.equal(otherOwner.address);
+      expect(await parent.ownerOf(tokenId3)).to.equal(otherOwner.address);
+
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+      expect(await parent.balanceOf(otherOwner.address)).to.equal(2);
+
+      await expect(parent.ownerOf(9999)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+    });
+
+    it('cannot mint to zero address', async function () {
+      await expect(child.mint(ADDRESS_ZERO, 1)).to.be.revertedWithCustomError(
+        child,
+        'ERC721MintToTheZeroAddress',
+      );
+    });
+
+    it('cannot nest mint to a non-contract destination', async function () {
+      await expect(child.nestMint(tokenOwner.address, 1, 1)).to.be.revertedWithCustomError(
+        child,
+        'IsNotContract',
+      );
+    });
+
+    it('cannot nest mint to non nestable receiver', async function () {
+      const ERC721 = await ethers.getContractFactory('ERC721Mock');
+      const nonReceiver = await ERC721.deploy('Non receiver', 'NR');
+      await nonReceiver.deployed();
+
+      await expect(child.nestMint(nonReceiver.address, 1, 1)).to.be.revertedWithCustomError(
+        child,
+        'MintToNonNestableImplementer',
+      );
+    });
+
+    it('cannot nest mint to a non-existent token', async function () {
+      await expect(child.nestMint(parent.address, 1, 1)).to.be.revertedWithCustomError(
+        child,
+        'ERC721InvalidTokenId',
+      );
+    });
+
+    it('cannot nest mint to zero address', async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      await expect(child.nestMint(ADDRESS_ZERO, parentId, 1)).to.be.revertedWithCustomError(
+        child,
+        'IsNotContract',
+      );
+    });
+
+    it('can mint to contract and owners are ok', async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      // owner is the same adress
+      expect(await parent.ownerOf(parentId)).to.equal(tokenOwner.address);
+      expect(await child.ownerOf(childId1)).to.equal(tokenOwner.address);
+
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+    });
+
+    it('can mint to contract and direct owners are ok', async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      // Direct owner is an address for the parent
+      expect(await parent.directOwnerOf(parentId)).to.eql([tokenOwner.address, bn(0), false]);
+      // Direct owner is a contract for the child
+      expect(await child.directOwnerOf(childId1)).to.eql([parent.address, bn(parentId), true]);
+    });
+
+    it("can mint to contract and parent's children are ok", async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      const children = await parent.childrenOf(parentId);
+      expect(children).to.eql([]);
+
+      const pendingChildren = await parent.pendingChildrenOf(parentId);
+      expect(pendingChildren).to.eql([[bn(childId1), child.address]]);
+      expect(await parent.pendingChildOf(parentId, 0)).to.eql([bn(childId1), child.address]);
+    });
+
+    it('cannot get child out of index', async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      await expect(parent.childOf(parentId, 0)).to.be.revertedWithCustomError(
+        parent,
+        'ChildIndexOutOfRange',
+      );
+    });
+
+    it('cannot get pending child out of index', async function () {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      await expect(parent.pendingChildOf(parentId, 0)).to.be.revertedWithCustomError(
+        parent,
+        'PendingChildIndexOutOfRange',
+      );
+    });
+
+    it('can mint multiple children', async function () {
+      const parentId = 1;
+      const childId1 = 99;
+      const childId2 = 100;
+      await parent.mint(tokenOwner.address, parentId);
+      await child.nestMint(parent.address, childId1, parentId);
+      await child.nestMint(parent.address, childId2, parentId);
+
+      expect(await child.ownerOf(childId1)).to.equal(tokenOwner.address);
+      expect(await child.ownerOf(childId2)).to.equal(tokenOwner.address);
+
+      expect(await child.balanceOf(parent.address)).to.equal(2);
+
+      const pendingChildren = await parent.pendingChildrenOf(parentId);
+      expect(pendingChildren).to.eql([
+        [bn(childId1), child.address],
+        [bn(childId2), child.address],
+      ]);
+    });
+
+    it('can mint child into child', async function () {
+      const parentId = 1;
+      const childId1 = 99;
+      const granchildId = 999;
+      await parent.mint(tokenOwner.address, parentId);
+      await child.nestMint(parent.address, childId1, parentId);
+      await child.nestMint(child.address, granchildId, childId1);
+
+      // Check balances -- yes, technically the counted balance indicates `child` owns an instance of itself
+      // and this is a little counterintuitive, but the root owner is the EOA.
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+      expect(await child.balanceOf(child.address)).to.equal(1);
+
+      const pendingChildrenOfChunky10 = await parent.pendingChildrenOf(parentId);
+      const pendingChildrenOfMonkey1 = await child.pendingChildrenOf(childId1);
+
+      expect(pendingChildrenOfChunky10).to.eql([[bn(childId1), child.address]]);
+      expect(pendingChildrenOfMonkey1).to.eql([[bn(granchildId), child.address]]);
+
+      expect(await child.directOwnerOf(granchildId)).to.eql([child.address, bn(childId1), true]);
+
+      expect(await child.ownerOf(granchildId)).to.eql(tokenOwner.address);
+    });
+
+    it('cannot have too many pending children', async () => {
+      const parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+
+      // First 128 should be fine.
+      for (let i = 1; i <= 128; i++) {
+        await child.nestMint(parent.address, i, parentId);
+      }
+
+      await expect(child.nestMint(parent.address, 129, parentId)).to.be.revertedWithCustomError(
+        child,
+        'MaxPendingChildrenReached',
+      );
+    });
+  });
+
+  describe('Interface support', async function () {
+    it('can support IERC165', async function () {
+      expect(await parent.supportsInterface('0x01ffc9a7')).to.equal(true);
+    });
+
+    it('can support IERC721', async function () {
+      expect(await parent.supportsInterface('0x80ac58cd')).to.equal(true);
+    });
+
+    it('can support INestable', async function () {
+      expect(await parent.supportsInterface('0x42b0e56f')).to.equal(true);
+    });
+
+    it('cannot support other interfaceId', async function () {
+      expect(await parent.supportsInterface('0xffffffff')).to.equal(false);
+    });
+  });
+
+  describe('Adding child', async function () {
+    it('cannot add child from user address', async function () {
+      const tokenOwner1 = addrs[0];
+      const tokenOwner2 = addrs[1];
+      const parentId = 1;
+      await parent.mint(tokenOwner1.address, parentId);
+      const childId1 = 99;
+      await child.mint(tokenOwner2.address, childId1);
+      await expect(parent.addChild(parentId, childId1, '0x')).to.be.revertedWithCustomError(
+        parent,
+        'IsNotContract',
+      );
+    });
+  });
+
+  describe('Accept child', async function () {
+    let parentId: number;
+    let childId1: number;
+
+    beforeEach(async function () {
+      parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+    });
+
+    it('can accept child', async function () {
+      await expect(parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, childId1))
+        .to.emit(parent, 'ChildAccepted')
+        .withArgs(parentId, 0, child.address, childId1);
+      await checkChildWasAccepted();
+    });
+
+    it('can accept child if approved', async function () {
+      const approved = addrs[1];
+      await parent.connect(tokenOwner).approve(approved.address, parentId);
+      await parent.connect(approved).acceptChild(parentId, 0, child.address, childId1);
+      await checkChildWasAccepted();
+    });
+
+    it('can accept child if approved for all', async function () {
+      const operator = addrs[2];
+      await parent.connect(tokenOwner).setApprovalForAll(operator.address, true);
+      await parent.connect(operator).acceptChild(parentId, 0, child.address, childId1);
+      await checkChildWasAccepted();
+    });
+
+    it('cannot accept not owned child', async function () {
+      const notOwner = addrs[3];
+      await expect(
+        parent.connect(notOwner).acceptChild(parentId, 0, child.address, childId1),
+      ).to.be.revertedWithCustomError(parent, 'ERC721NotApprovedOrOwner');
+    });
+
+    it('cannot accept child if address or id do not match', async function () {
+      const otherAddress = addrs[1].address;
+      const otherChildId = 9999;
+      await expect(
+        parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, otherChildId),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+      await expect(
+        parent.connect(tokenOwner).acceptChild(parentId, 0, otherAddress, childId1),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+    });
+
+    it('cannot accept children for non existing index', async () => {
+      await expect(
+        parent.connect(tokenOwner).acceptChild(parentId, 1, child.address, childId1),
+      ).to.be.revertedWithCustomError(parent, 'PendingChildIndexOutOfRange');
+    });
+
+    async function checkChildWasAccepted() {
+      expect(await parent.pendingChildrenOf(parentId)).to.eql([]);
+      expect(await parent.childrenOf(parentId)).to.eql([[bn(childId1), child.address]]);
+    }
+  });
+
+  describe('Rejecting children', async function () {
+    let parentId: number;
+
+    beforeEach(async function () {
+      parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      await child.nestMint(parent.address, 99, parentId);
+    });
+
+    it('can reject all pending children', async function () {
+      // Mint a couple of more children
+      await child.nestMint(parent.address, 100, parentId);
+      await child.nestMint(parent.address, 101, parentId);
+
+      await expect(parent.connect(tokenOwner).rejectAllChildren(parentId, 3))
+        .to.emit(parent, 'AllChildrenRejected')
+        .withArgs(parentId);
+      await checkNoChildrenNorPending(parentId);
+
+      // They are still on the child
+      expect(await child.balanceOf(parent.address)).to.equal(3);
+    });
+
+    it('cannot reject all pending children if there are more than expected', async function () {
+      // Mint a couple of more children
+      await child.nestMint(parent.address, 100, parentId);
+      await child.nestMint(parent.address, 101, parentId);
+
+      await expect(
+        parent.connect(tokenOwner).rejectAllChildren(parentId, 1),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedNumberOfChildren');
+    });
+
+    it('can reject all pending children if approved', async function () {
+      // Mint a couple of more children
+      await child.nestMint(parent.address, 100, parentId);
+      await child.nestMint(parent.address, 101, parentId);
+
+      const rejecter = addrs[1];
+      await parent.connect(tokenOwner).approve(rejecter.address, parentId);
+      await parent.connect(rejecter).rejectAllChildren(parentId, 3);
+      await checkNoChildrenNorPending(parentId);
+    });
+
+    it('can reject all pending children if approved for all', async function () {
+      // Mint a couple of more children
+      await child.nestMint(parent.address, 100, parentId);
+      await child.nestMint(parent.address, 101, parentId);
+
+      const operator = addrs[2];
+      await parent.connect(tokenOwner).setApprovalForAll(operator.address, true);
+      await parent.connect(operator).rejectAllChildren(parentId, 3);
+      await checkNoChildrenNorPending(parentId);
+    });
+
+    it('cannot reject all pending children for not owned pending child', async function () {
+      const notOwner = addrs[3];
+
+      await expect(
+        parent.connect(notOwner).rejectAllChildren(parentId, 2),
+      ).to.be.revertedWithCustomError(parent, 'ERC721NotApprovedOrOwner');
+    });
+  });
+
+  describe('Burning', async function () {
+    let parentId: number;
+
+    beforeEach(async function () {
+      parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+    });
+
+    it('can burn token', async function () {
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+      await parent.connect(tokenOwner)['burn(uint256)'](parentId);
+      await checkBurntParent();
+    });
+
+    it('can burn token if approved', async function () {
+      const approved = addrs[1];
+      await parent.connect(tokenOwner).approve(approved.address, parentId);
+      await parent.connect(approved)['burn(uint256)'](parentId);
+      await checkBurntParent();
+    });
+
+    it('can burn token if approved for all', async function () {
+      const operator = addrs[2];
+      await parent.connect(tokenOwner).setApprovalForAll(operator.address, true);
+      await parent.connect(operator)['burn(uint256)'](parentId);
+      await checkBurntParent();
+    });
+
+    it('can recursively burn nested token', async function () {
+      const childId1 = 99;
+      const granchildId = 999;
+      await child.nestMint(parent.address, childId1, parentId);
+      await child.nestMint(child.address, granchildId, childId1);
+      await parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, childId1);
+      await child.connect(tokenOwner).acceptChild(childId1, 0, child.address, granchildId);
+
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+      expect(await child.balanceOf(child.address)).to.equal(1);
+
+      expect(await parent.childrenOf(parentId)).to.eql([[bn(childId1), child.address]]);
+      expect(await child.childrenOf(childId1)).to.eql([[bn(granchildId), child.address]]);
+      expect(await child.directOwnerOf(granchildId)).to.eql([child.address, bn(childId1), true]);
+
+      // Sets recursive burns to 2
+      await parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 2);
+
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(0);
+      expect(await child.balanceOf(parent.address)).to.equal(0);
+      expect(await child.balanceOf(child.address)).to.equal(0);
+
+      await expect(parent.ownerOf(parentId)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+      await expect(parent.directOwnerOf(parentId)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+
+      await expect(child.ownerOf(childId1)).to.be.revertedWithCustomError(
+        child,
+        'ERC721InvalidTokenId',
+      );
+      await expect(child.directOwnerOf(childId1)).to.be.revertedWithCustomError(
+        child,
+        'ERC721InvalidTokenId',
+      );
+
+      await expect(parent.ownerOf(granchildId)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+      await expect(parent.directOwnerOf(granchildId)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+    });
+
+    it('can recursively burn nested token with the right number of recursive burns', async function () {
+      // Parent
+      // -> Child1
+      //      -> GrandChild1
+      //      -> GrandChild2
+      //        -> GreatGrandChild1
+      // -> Child2
+      // Total tree 5 (4 recursive burns)
+      const childId1 = 99;
+      const childId2 = 100;
+      const grandChild1 = 999;
+      const grandChild2 = 1000;
+      const greatGrandChild1 = 9999;
+      await child.nestMint(parent.address, childId1, parentId);
+      await child.nestMint(parent.address, childId2, parentId);
+      await child.nestMint(child.address, grandChild1, childId1);
+      await child.nestMint(child.address, grandChild2, childId1);
+      await child.nestMint(child.address, greatGrandChild1, grandChild2);
+      await parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, childId1);
+      await parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, childId2);
+      await child.connect(tokenOwner).acceptChild(childId1, 0, child.address, grandChild1);
+      await child.connect(tokenOwner).acceptChild(childId1, 0, child.address, grandChild2);
+      await child.connect(tokenOwner).acceptChild(grandChild2, 0, child.address, greatGrandChild1);
+
+      // 0 is not enough
+      await expect(parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 0))
+        .to.be.revertedWithCustomError(parent, 'MaxRecursiveBurnsReached')
+        .withArgs(child.address, childId1);
+      // 1 is not enough
+      await expect(parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 1))
+        .to.be.revertedWithCustomError(parent, 'MaxRecursiveBurnsReached')
+        .withArgs(child.address, grandChild1);
+      // 2 is not enough
+      await expect(parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 2))
+        .to.be.revertedWithCustomError(parent, 'MaxRecursiveBurnsReached')
+        .withArgs(child.address, grandChild2);
+      // 3 is not enough
+      await expect(parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 3))
+        .to.be.revertedWithCustomError(parent, 'MaxRecursiveBurnsReached')
+        .withArgs(child.address, greatGrandChild1);
+      // 4 is not enough
+      await expect(parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 4))
+        .to.be.revertedWithCustomError(parent, 'MaxRecursiveBurnsReached')
+        .withArgs(child.address, childId2);
+      // 5 is just enough
+      await parent.connect(tokenOwner)['burn(uint256,uint256)'](parentId, 5);
+    });
+
+    async function checkBurntParent() {
+      expect(await parent.balanceOf(addrs[1].address)).to.equal(0);
+      await expect(parent.ownerOf(parentId)).to.be.revertedWithCustomError(
+        parent,
+        'ERC721InvalidTokenId',
+      );
+    }
+  });
+
+  describe('Transferring Active Children', async function () {
+    let parentId: number;
+    let childId1: number;
+
+    beforeEach(async function () {
+      parentId = 1;
+      childId1 = 99;
+      await parent.mint(tokenOwner.address, parentId);
+      await child.nestMint(parent.address, childId1, parentId);
+      await parent.connect(tokenOwner).acceptChild(parentId, 0, child.address, childId1);
+    });
+
+    it('can transfer child with to as root owner', async function () {
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, tokenOwner.address, 0, 0, child.address, childId1, false, '0x'),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, false);
+
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child to another address', async function () {
+      const toOwnerAddress = addrs[2].address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, child.address, childId1, false, '0x'),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, false);
+
+      await checkChildMovedToRootOwner(toOwnerAddress);
+    });
+
+    it('can transfer child to another NFT', async function () {
+      const newOwnerAddress = addrs[2].address;
+      const newParentId = 2;
+      await parent.mint(newOwnerAddress, newParentId);
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(
+            parentId,
+            parent.address,
+            newParentId,
+            0,
+            child.address,
+            childId1,
+            false,
+            '0x',
+          ),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, false);
+
+      expect(await child.ownerOf(childId1)).to.eql(newOwnerAddress);
+      expect(await child.directOwnerOf(childId1)).to.eql([parent.address, bn(newParentId), true]);
+      expect(await parent.pendingChildrenOf(newParentId)).to.eql([[bn(childId1), child.address]]);
+    });
+
+    it('cannot transfer child out of index', async function () {
+      const toOwnerAddress = addrs[2].address;
+      const badIndex = 2;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(
+            parentId,
+            toOwnerAddress,
+            0,
+            badIndex,
+            child.address,
+            childId1,
+            false,
+            '0x',
+          ),
+      ).to.be.revertedWithCustomError(parent, 'ChildIndexOutOfRange');
+    });
+
+    it('cannot transfer child if address or id do not match', async function () {
+      const otherAddress = addrs[1].address;
+      const otherChildId = 9999;
+      const toOwnerAddress = addrs[2].address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, otherAddress, childId1, false, '0x'),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, child.address, otherChildId, false, '0x'),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+    });
+
+    it('can transfer child if approved', async function () {
+      const transferer = addrs[1];
+      const toOwner = tokenOwner.address;
+      await parent.connect(tokenOwner).approve(transferer.address, parentId);
+
+      await parent
+        .connect(transferer)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, false, '0x');
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child if approved for all', async function () {
+      const operator = addrs[2];
+      const toOwner = tokenOwner.address;
+      await parent.connect(tokenOwner).setApprovalForAll(operator.address, true);
+
+      await parent
+        .connect(operator)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, false, '0x');
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child with grandchild and children are ok', async function () {
+      const toOwner = tokenOwner.address;
+      const grandchildId = 999;
+      await child.nestMint(child.address, grandchildId, childId1);
+
+      // Transfer child from parent.
+      await parent
+        .connect(tokenOwner)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, false, '0x');
+
+      // New owner of child
+      expect(await child.ownerOf(childId1)).to.eql(tokenOwner.address);
+      expect(await child.directOwnerOf(childId1)).to.eql([tokenOwner.address, bn(0), false]);
+
+      // Grandchild is still owned by child
+      expect(await child.ownerOf(grandchildId)).to.eql(tokenOwner.address);
+      expect(await child.directOwnerOf(grandchildId)).to.eql([child.address, bn(childId1), true]);
+    });
+
+    it('cannot transfer child if not child root owner', async function () {
+      const toOwner = tokenOwner.address;
+      const notOwner = addrs[3];
+      await expect(
+        parent
+          .connect(notOwner)
+          .transferChild(parentId, toOwner, 0, 0, child.address, childId1, false, '0x'),
+      ).to.be.revertedWithCustomError(child, 'ERC721NotApprovedOrOwner');
+    });
+
+    it('cannot transfer child from not existing parent', async function () {
+      const badChildId = 99;
+      const toOwner = tokenOwner.address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(badChildId, toOwner, 0, 0, child.address, childId1, false, '0x'),
+      ).to.be.revertedWithCustomError(child, 'ERC721InvalidTokenId');
+    });
+
+    async function checkChildMovedToRootOwner(rootOwnerAddress?: string) {
+      if (rootOwnerAddress === undefined) {
+        rootOwnerAddress = tokenOwner.address;
+      }
+      expect(await child.ownerOf(childId1)).to.eql(rootOwnerAddress);
+      expect(await child.directOwnerOf(childId1)).to.eql([rootOwnerAddress, bn(0), false]);
+
+      // Transferring updates balances downstream
+      expect(await child.balanceOf(rootOwnerAddress)).to.equal(1);
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+    }
+  });
+
+  describe('Transferring Pending Children', async function () {
+    let parentId: number;
+    let childId1: number;
+
+    beforeEach(async function () {
+      parentId = 1;
+      await parent.mint(tokenOwner.address, parentId);
+      childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+    });
+
+    it('can transfer child with to as root owner', async function () {
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, tokenOwner.address, 0, 0, child.address, childId1, true, '0x'),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, true);
+
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child to another address', async function () {
+      const toOwnerAddress = addrs[2].address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, child.address, childId1, true, '0x'),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, true);
+
+      await checkChildMovedToRootOwner(toOwnerAddress);
+    });
+
+    it('can transfer child to another NFT', async function () {
+      const newOwnerAddress = addrs[2].address;
+      const newParentId = 2;
+      await parent.mint(newOwnerAddress, newParentId);
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(
+            parentId,
+            parent.address,
+            newParentId,
+            0,
+            child.address,
+            childId1,
+            true,
+            '0x',
+          ),
+      )
+        .to.emit(parent, 'ChildTransferred')
+        .withArgs(parentId, 0, child.address, childId1, true);
+
+      expect(await child.ownerOf(childId1)).to.eql(newOwnerAddress);
+      expect(await child.directOwnerOf(childId1)).to.eql([parent.address, bn(newParentId), true]);
+      expect(await parent.pendingChildrenOf(newParentId)).to.eql([[bn(childId1), child.address]]);
+    });
+
+    it('cannot transfer child out of index', async function () {
+      const toOwnerAddress = addrs[2].address;
+      const badIndex = 2;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(
+            parentId,
+            toOwnerAddress,
+            0,
+            badIndex,
+            child.address,
+            childId1,
+            true,
+            '0x',
+          ),
+      ).to.be.revertedWithCustomError(parent, 'PendingChildIndexOutOfRange');
+    });
+
+    it('cannot transfer child if address or id do not match', async function () {
+      const otherAddress = addrs[1].address;
+      const otherChildId = 9999;
+      const toOwnerAddress = addrs[2].address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, otherAddress, childId1, true, '0x'),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(parentId, toOwnerAddress, 0, 0, child.address, otherChildId, true, '0x'),
+      ).to.be.revertedWithCustomError(parent, 'UnexpectedChildId');
+    });
+
+    it('can transfer child if approved', async function () {
+      const transferer = addrs[1];
+      const toOwner = tokenOwner.address;
+      await parent.connect(tokenOwner).approve(transferer.address, parentId);
+
+      await parent
+        .connect(transferer)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, true, '0x');
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child if approved for all', async function () {
+      const operator = addrs[2];
+      const toOwner = tokenOwner.address;
+      await parent.connect(tokenOwner).setApprovalForAll(operator.address, true);
+
+      await parent
+        .connect(operator)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, true, '0x');
+      await checkChildMovedToRootOwner();
+    });
+
+    it('can transfer child with grandchild and children are ok', async function () {
+      const toOwner = tokenOwner.address;
+      const grandchildId = 999;
+      await child.nestMint(child.address, grandchildId, childId1);
+
+      // Transfer child from parent.
+      await parent
+        .connect(tokenOwner)
+        .transferChild(parentId, toOwner, 0, 0, child.address, childId1, true, '0x');
+
+      // New owner of child
+      expect(await child.ownerOf(childId1)).to.eql(tokenOwner.address);
+      expect(await child.directOwnerOf(childId1)).to.eql([tokenOwner.address, bn(0), false]);
+
+      // Grandchild is still owned by child
+      expect(await child.ownerOf(grandchildId)).to.eql(tokenOwner.address);
+      expect(await child.directOwnerOf(grandchildId)).to.eql([child.address, bn(childId1), true]);
+    });
+
+    it('cannot transfer child if not child root owner', async function () {
+      const toOwner = tokenOwner.address;
+      const notOwner = addrs[3];
+      await expect(
+        parent
+          .connect(notOwner)
+          .transferChild(parentId, toOwner, 0, 0, child.address, childId1, true, '0x'),
+      ).to.be.revertedWithCustomError(child, 'ERC721NotApprovedOrOwner');
+    });
+
+    it('cannot transfer child from not existing parent', async function () {
+      const badChildId = 99;
+      const toOwner = tokenOwner.address;
+      await expect(
+        parent
+          .connect(tokenOwner)
+          .transferChild(badChildId, toOwner, 0, 0, child.address, childId1, true, '0x'),
+      ).to.be.revertedWithCustomError(child, 'ERC721InvalidTokenId');
+    });
+
+    async function checkChildMovedToRootOwner(rootOwnerAddress?: string) {
+      if (rootOwnerAddress === undefined) {
+        rootOwnerAddress = tokenOwner.address;
+      }
+      expect(await child.ownerOf(childId1)).to.eql(rootOwnerAddress);
+      expect(await child.directOwnerOf(childId1)).to.eql([rootOwnerAddress, bn(0), false]);
+
+      // Transferring updates balances downstream
+      expect(await child.balanceOf(rootOwnerAddress)).to.equal(1);
+      expect(await parent.balanceOf(tokenOwner.address)).to.equal(1);
+    }
+  });
+
+  describe('Transfer', async function () {
+    it('can transfer token', async function () {
+      const firstOwner = addrs[1];
+      const newOwner = addrs[2];
+      const tokenId1 = 1;
+      await parent.mint(firstOwner.address, tokenId1);
+      await parent.connect(firstOwner).transfer(newOwner.address, tokenId1);
+
+      // Balances and ownership are updated
+      expect(await parent.ownerOf(tokenId1)).to.eql(newOwner.address);
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(0);
+      expect(await parent.balanceOf(newOwner.address)).to.equal(1);
+    });
+
+    it('cannot transfer not owned token', async function () {
+      const firstOwner = addrs[1];
+      const newOwner = addrs[2];
+      const tokenId1 = 1;
+      await parent.mint(firstOwner.address, tokenId1);
+      await expect(
+        parent.connect(newOwner).transfer(newOwner.address, tokenId1),
+      ).to.be.revertedWithCustomError(child, 'NotApprovedOrDirectOwner');
+    });
+
+    it('cannot transfer to address zero', async function () {
+      const firstOwner = addrs[1];
+      const tokenId1 = 1;
+      await parent.mint(firstOwner.address, tokenId1);
+      await expect(
+        parent.connect(firstOwner).transfer(ADDRESS_ZERO, tokenId1),
+      ).to.be.revertedWithCustomError(child, 'ERC721TransferToTheZeroAddress');
+    });
+
+    it('can transfer token from approved address (not owner)', async function () {
+      const firstOwner = addrs[1];
+      const approved = addrs[2];
+      const newOwner = addrs[3];
+      const tokenId1 = 1;
+      await parent.mint(firstOwner.address, tokenId1);
+
+      await parent.connect(firstOwner).approve(approved.address, tokenId1);
+      await parent.connect(firstOwner).transfer(newOwner.address, tokenId1);
+
+      expect(await parent.ownerOf(tokenId1)).to.eql(newOwner.address);
+    });
+
+    it('can transfer not nested token with child to address and owners/children are ok', async function () {
+      const firstOwner = addrs[1];
+      const newOwner = addrs[2];
+      const parentId = 1;
+      await parent.mint(firstOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      await parent.connect(firstOwner).transfer(newOwner.address, parentId);
+
+      // Balances and ownership are updated
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(0);
+      expect(await parent.balanceOf(newOwner.address)).to.equal(1);
+
+      expect(await parent.ownerOf(parentId)).to.eql(newOwner.address);
+      expect(await parent.directOwnerOf(parentId)).to.eql([newOwner.address, bn(0), false]);
+
+      // New owner of child
+      expect(await child.ownerOf(childId1)).to.eql(newOwner.address);
+      expect(await child.directOwnerOf(childId1)).to.eql([parent.address, bn(parentId), true]);
+
+      // Parent still has its children
+      expect(await parent.pendingChildrenOf(parentId)).to.eql([[bn(childId1), child.address]]);
+    });
+
+    it('cannot directly transfer nested child', async function () {
+      const firstOwner = addrs[1];
+      const newOwner = addrs[2];
+      const parentId = 1;
+      await parent.mint(firstOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      await expect(
+        child.connect(firstOwner).transfer(newOwner.address, childId1),
+      ).to.be.revertedWithCustomError(child, 'NotApprovedOrDirectOwner');
+    });
+
+    it('can transfer parent token to token with same owner, family tree is ok', async function () {
+      const firstOwner = addrs[1];
+      const grandParentId = 999;
+      await parent.mint(firstOwner.address, grandParentId);
+      const parentId = 1;
+      await parent.mint(firstOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      // Check balances
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(2);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+
+      // Transfers token parentId to (parent.address, token grandParentId)
+      await parent.connect(firstOwner).nestTransfer(parent.address, parentId, grandParentId);
+
+      // Balances unchanged since root owner is the same
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(1);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+      expect(await parent.balanceOf(parent.address)).to.equal(1);
+
+      // Parent is still owner of child
+      let expected = [bn(childId1), child.address];
+      checkAcceptedAndPendingChildren(parent, parentId, [expected], []);
+      // Ownership: firstOwner > newGrandparent > parent > child
+      expected = [bn(parentId), parent.address];
+      checkAcceptedAndPendingChildren(parent, grandParentId, [], [expected]);
+    });
+
+    it('can transfer parent token to token with different owner, family tree is ok', async function () {
+      const firstOwner = addrs[1];
+      const otherOwner = addrs[2];
+      const grandParentId = 999;
+      await parent.mint(otherOwner.address, grandParentId);
+      const parentId = 1;
+      await parent.mint(firstOwner.address, parentId);
+      const childId1 = 99;
+      await child.nestMint(parent.address, childId1, parentId);
+
+      // Check balances
+      expect(await parent.balanceOf(otherOwner.address)).to.equal(1);
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(1);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+
+      // firstOwner calls parent to transfer parent token parent
+      await parent.connect(firstOwner).nestTransfer(parent.address, parentId, grandParentId);
+
+      // Balances update
+      expect(await parent.balanceOf(firstOwner.address)).to.equal(0);
+      expect(await parent.balanceOf(parent.address)).to.equal(1);
+      expect(await parent.balanceOf(otherOwner.address)).to.equal(1);
+      expect(await child.balanceOf(parent.address)).to.equal(1);
+
+      // Parent is still owner of child
+      let expected = [bn(childId1), child.address];
+      checkAcceptedAndPendingChildren(parent, parentId, [expected], []);
+      // Ownership: firstOwner > newGrandparent > parent > child
+      expected = [bn(parentId), parent.address];
+      checkAcceptedAndPendingChildren(parent, grandParentId, [], [expected]);
+    });
+  });
+
+  describe('Nest Transfer', async function () {
+    let firstOwner: SignerWithAddress;
+    let parentId: number;
+    let childId1: number;
+
+    beforeEach(async function () {
+      firstOwner = addrs[1];
+      parentId = 1;
+      childId1 = 99;
+      await parent.mint(firstOwner.address, parentId);
+      await child.mint(firstOwner.address, childId1);
+    });
+
+    it('cannot nest tranfer from non immediate owner (owner of parent)', async function () {
+      const otherParentId = 2;
+      await parent.mint(firstOwner.address, otherParentId);
+      // We send it to the parent first
+      await child.connect(firstOwner).nestTransfer(parent.address, childId1, parentId);
+      // We can no longer nest transfer it, even if we are the root owner:
+      await expect(
+        child.connect(firstOwner).nestTransfer(parent.address, childId1, otherParentId),
+      ).to.be.revertedWithCustomError(child, 'NotApprovedOrDirectOwner');
+    });
+
+    it('cannot nest tranfer to same NFT', async function () {
+      // We can no longer nest transfer it, even if we are the root owner:
+      await expect(
+        child.connect(firstOwner).nestTransfer(child.address, childId1, childId1),
+      ).to.be.revertedWithCustomError(child, 'NestableTransferToSelf');
+    });
+
+    it('cannot nest tranfer a descendant same NFT', async function () {
+      // We can no longer nest transfer it, even if we are the root owner:
+      await child.connect(firstOwner).nestTransfer(parent.address, childId1, parentId);
+      const grandChildId = 999;
+      await child.nestMint(child.address, grandChildId, childId1);
+      // Ownership is now parent->child->granChild
+      // Cannot send parent to grandChild
+      await expect(
+        parent.connect(firstOwner).nestTransfer(child.address, parentId, grandChildId),
+      ).to.be.revertedWithCustomError(child, 'NestableTransferToDescendant');
+      // Cannot send parent to child
+      await expect(
+        parent.connect(firstOwner).nestTransfer(child.address, parentId, childId1),
+      ).to.be.revertedWithCustomError(child, 'NestableTransferToDescendant');
+    });
+
+    it('cannot nest tranfer if ancestors tree is too deep', async function () {
+      let lastId = childId1;
+      for (let i = 101; i <= 200; i++) {
+        await child.nestMint(child.address, i, lastId);
+        lastId = i;
+      }
+      // Ownership is now parent->child->child->child->child...->lastChild
+      // Cannot send parent to lastChild
+      await expect(
+        parent.connect(firstOwner).nestTransfer(child.address, parentId, lastId),
+      ).to.be.revertedWithCustomError(child, 'NestableTooDeep');
+    });
+
+    it('cannot nest tranfer if not owner', async function () {
+      const notOwner = addrs[3];
+      await expect(
+        child.connect(notOwner).nestTransfer(parent.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'NotApprovedOrDirectOwner');
+    });
+
+    it('cannot nest tranfer to address 0', async function () {
+      await expect(
+        child.connect(firstOwner).nestTransfer(ADDRESS_ZERO, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'ERC721TransferToTheZeroAddress');
+    });
+
+    it('cannot nest tranfer to a non contract', async function () {
+      const newOwner = addrs[2];
+      await expect(
+        child.connect(firstOwner).nestTransfer(newOwner.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'IsNotContract');
+    });
+
+    it('cannot nest tranfer to contract if it does implement INestable', async function () {
+      const ERC721 = await ethers.getContractFactory('ERC721Mock');
+      const nonNestable = await ERC721.deploy('Non receiver', 'NR');
+      await nonNestable.deployed();
+      await expect(
+        child.connect(firstOwner).nestTransfer(nonNestable.address, childId1, parentId),
+      ).to.be.revertedWithCustomError(child, 'NestableTransferToNonNestableImplementer');
+    });
+
+    it('can nest tranfer to INestable contract', async function () {
+      await child.connect(firstOwner).nestTransfer(parent.address, childId1, parentId);
+      expect(await child.ownerOf(childId1)).to.eql(firstOwner.address);
+      expect(await child.directOwnerOf(childId1)).to.eql([parent.address, bn(parentId), true]);
+    });
+
+    it('cannot nest tranfer to non existing parent token', async function () {
+      const notExistingParentId = 9999;
+      await expect(
+        child.connect(firstOwner).nestTransfer(parent.address, childId1, notExistingParentId),
+      ).to.be.revertedWithCustomError(parent, 'ERC721InvalidTokenId');
+    });
+  });
+
+  async function checkNoChildrenNorPending(parentId: number): Promise<void> {
+    expect(await parent.pendingChildrenOf(parentId)).to.eql([]);
+    expect(await parent.childrenOf(parentId)).to.eql([]);
+  }
+
+  async function checkAcceptedAndPendingChildren(
+    contract: EquippableTokenMock,
+    tokenId1: number,
+    expectedAccepted: any[],
+    expectedPending: any[],
+  ) {
+    const accepted = await contract.childrenOf(tokenId1);
+    expect(accepted).to.eql(expectedAccepted);
+
+    const pending = await contract.pendingChildrenOf(tokenId1);
+    expect(pending).to.eql(expectedPending);
+  }
+});
diff --git a/assets/eip-6220/test/renderUtils.ts b/assets/eip-6220/test/renderUtils.ts
new file mode 100644
index 00000000000000..479139681d3c7b
--- /dev/null
+++ b/assets/eip-6220/test/renderUtils.ts
@@ -0,0 +1,129 @@
+import { loadFixture } from '@nomicfoundation/hardhat-network-helpers';
+import { SignerWithAddress } from '@nomiclabs/hardhat-ethers/signers';
+import { expect } from 'chai';
+import { BigNumber } from 'ethers';
+import { ethers } from 'hardhat';
+import { EquippableTokenMock, EquipRenderUtils, MultiAssetRenderUtils } from '../typechain-types';
+
+function bn(x: number): BigNumber {
+  return BigNumber.from(x);
+}
+
+async function assetsFixture() {
+  const equipFactory = await ethers.getContractFactory('EquippableTokenMock');
+  const renderUtilsFactory = await ethers.getContractFactory('MultiAssetRenderUtils');
+  const renderUtilsEquipFactory = await ethers.getContractFactory('EquipRenderUtils');
+
+  const equip = <EquippableTokenMock>await equipFactory.deploy();
+  await equip.deployed();
+
+  const renderUtils = <MultiAssetRenderUtils>await renderUtilsFactory.deploy();
+  await renderUtils.deployed();
+
+  const renderUtilsEquip = <EquipRenderUtils>await renderUtilsEquipFactory.deploy();
+  await renderUtilsEquip.deployed();
+
+  return { equip, renderUtils, renderUtilsEquip };
+}
+
+describe('Render Utils', async function () {
+  let owner: SignerWithAddress;
+  let someCatalog: SignerWithAddress;
+  let equip: EquippableTokenMock;
+  let renderUtils: MultiAssetRenderUtils;
+  let renderUtilsEquip: EquipRenderUtils;
+  let tokenId: number;
+
+  const resId = bn(1);
+  const resId2 = bn(2);
+  const resId3 = bn(3);
+  const resId4 = bn(4);
+
+  before(async function () {
+    ({ equip, renderUtils, renderUtilsEquip } = await loadFixture(assetsFixture));
+
+    const signers = await ethers.getSigners();
+    owner = signers[0];
+    someCatalog = signers[1];
+    tokenId = 1;
+
+    await equip.mint(owner.address, tokenId);
+    await equip.addEquippableAssetEntry(
+      resId,
+      0,
+      ethers.constants.AddressZero,
+      'ipfs://res1.jpg',
+      [],
+    );
+    await equip.addEquippableAssetEntry(resId2, 1, someCatalog.address, 'ipfs://res2.jpg', [1, 3, 4]);
+    await equip.addEquippableAssetEntry(
+      resId3,
+      0,
+      ethers.constants.AddressZero,
+      'ipfs://res3.jpg',
+      [],
+    );
+    await equip.addEquippableAssetEntry(resId4, 2, someCatalog.address, 'ipfs://res4.jpg', [4]);
+    await equip.addAssetToToken(tokenId, resId, 0);
+    await equip.addAssetToToken(tokenId, resId2, 0);
+    await equip.addAssetToToken(tokenId, resId3, resId);
+    await equip.addAssetToToken(tokenId, resId4, 0);
+
+    await equip.acceptAsset(tokenId, 0, resId);
+    await equip.acceptAsset(tokenId, 1, resId2);
+    await equip.setPriority(tokenId, [10, 5]);
+  });
+
+  describe('Render Utils MultiAsset', async function () {
+    it('can get active assets', async function () {
+      expect(await renderUtils.getActiveAssets(equip.address, tokenId)).to.eql([
+        [resId, 10, 'ipfs://res1.jpg'],
+        [resId2, 5, 'ipfs://res2.jpg'],
+      ]);
+    });
+
+    it('can get assets by id', async function () {
+      expect(await renderUtils.getAssetsById(equip.address, tokenId, [resId, resId2])).to.eql([
+        'ipfs://res1.jpg',
+        'ipfs://res2.jpg',
+      ]);
+    });
+
+    it('can get pending assets', async function () {
+      expect(await renderUtils.getPendingAssets(equip.address, tokenId)).to.eql([
+        [resId4, bn(0), bn(0), 'ipfs://res4.jpg'],
+        [resId3, bn(1), resId, 'ipfs://res3.jpg'],
+      ]);
+    });
+
+    it('can get top asset by priority', async function () {
+      expect(await renderUtils.getTopAssetMetaForToken(equip.address, tokenId)).to.eql(
+        'ipfs://res2.jpg',
+      );
+    });
+
+    it('cannot get top asset if token has no assets', async function () {
+      const otherTokenId = 2;
+      await equip.mint(owner.address, otherTokenId);
+      await expect(
+        renderUtils.getTopAssetMetaForToken(equip.address, otherTokenId),
+      ).to.be.revertedWithCustomError(renderUtils, 'TokenHasNoAssets');
+    });
+  });
+
+  describe('Render Utils Equip', async function () {
+    it('can get active assets', async function () {
+      expect(await renderUtilsEquip.getExtendedActiveAssets(equip.address, tokenId)).to.eql([
+        [resId, bn(0), 10, ethers.constants.AddressZero, 'ipfs://res1.jpg', []],
+        [resId2, bn(1), 5, someCatalog.address, 'ipfs://res2.jpg', [bn(1), bn(3), bn(4)]],
+      ]);
+    });
+
+    it('can get pending assets', async function () {
+      expect(await renderUtilsEquip.getExtendedPendingAssets(equip.address, tokenId)).to.eql([
+        [resId4, bn(2), bn(0), bn(0), someCatalog.address, 'ipfs://res4.jpg', [bn(4)]],
+        [resId3, bn(0), bn(1), resId, ethers.constants.AddressZero, 'ipfs://res3.jpg', []],
+      ]);
+    });
+  });
+});

From 234eafd55cab78fbd03fb9baae3f9a5cba30012d Mon Sep 17 00:00:00 2001
From: Chris Whinfrey <cwhinfrey@gmail.com>
Date: Fri, 20 Jan 2023 15:01:39 -0800
Subject: [PATCH 189/274] Update EIP-5164: Add chainId and naming (#6146)

* Add relayCall function

* Fix typo

* Add toChainId and fromChainId

* Remove gasLimit

* sender to from

* Fix linter error

* add author

* relayer/executor to dispatcher/executor

* Remove dispatch calls

* nonce to messageId

* Use message instead of call

* Refactor MessageDispatcher with extensions

* Fix indexes

* Combine extension interfaces

* PR feedback, typos, naming

* Add messageId to MessageFailure error

Co-authored-by: Pierrick Turelier <pierrick@turelier.com>

* Add messageId to MessageBatchFailure error

Co-authored-by: Pierrick Turelier <pierrick@turelier.com>

* Fix typo

Co-authored-by: Pierrick Turelier <pierrick@turelier.com>

* Add getMessageExecutorAddress method

Co-authored-by: Pierrick Turelier <pierrick@turelier.com>
---
 EIPS/eip-5164.md | 304 ++++++++++++++++++++++++++++++++---------------
 1 file changed, 210 insertions(+), 94 deletions(-)

diff --git a/EIPS/eip-5164.md b/EIPS/eip-5164.md
index 357e12cafb1244..97f35699254053 100644
--- a/EIPS/eip-5164.md
+++ b/EIPS/eip-5164.md
@@ -2,7 +2,7 @@
 eip: 5164
 title: Cross-Chain Execution
 description: Defines an interface that supports execution across EVM networks.
-author: Brendan Asselstine (@asselstine), Pierrick Turelier (@PierrickGT)
+author: Brendan Asselstine (@asselstine), Pierrick Turelier (@PierrickGT), Chris Whinfrey (@cwhinfrey)
 discussions-to: https://ethereum-magicians.org/t/eip-5164-cross-chain-execution/9658
 status: Review
 type: Standards Track
@@ -12,9 +12,9 @@ created: 2022-06-14
 
 ## Abstract
 
-This specification defines a cross-chain execution interface for EVM-based blockchains. Implementations of this specification will allow contracts on one chain to call contracts on another.
+This specification defines a cross-chain execution interface for EVM-based blockchains. Implementations of this specification will allow contracts on one chain to call contracts on another by sending a cross-chain message.
 
-The specification defines two components: the "Cross Chain Relayer" and the "Cross Chain Executor". The Cross Chain Relayer lives on the calling side, and the executor lives on the receiving side. Calls sent to Cross Chain Relayers will move through a transport layer to Cross Chain Executor(s), where they are executed. Implementations of this specification must implement both components.
+The specification defines two components: the "Message Dispatcher" and the "Message Executor". The Message Dispatcher lives on the calling side, and the executor lives on the receiving side. When a message is sent, a Message Dispatcher will move the message through a transport layer to a Message Executor, where they are executed. Implementations of this specification must implement both components.
 
 ## Motivation
 
@@ -26,203 +26,319 @@ The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL
 
 This specification allows contracts on one chain to send messages to contracts on another chain. There are two key interfaces that needs to be implemented:
 
-- `CrossChainRelayer`
-- `CrossChainExecutor`
+- `MessageDispatcher`
+- `MessageExecutor`
 
-The `CrossChainRelayer` lives on the origin chain. Users can share a single `CrossChainRelayer` or deploy their own.
+The `MessageDispatcher` lives on the origin chain and dispatches messages to the `MessageExecutor` for execution. The `MessageExecutor` lives on the destination chain and executes dispatched messages.
 
-The `CrossChainExecutor` lives on the destination chain and executes relayed calls. Users can share a single `CrossChainExecutor` or deploy their own.
+There are also extensions of `MessageDispatcher`, each defining a method for initiating a message or message batch:
 
-### CrossChainRelayer
+- `SingleMessageDispatcher`
+- `BatchMessageDispatcher`
 
-The `CrossChainRelayer` lives on the chain from which messages are sent. The Relayer's job is to broadcast calls through a transport layer to one or more `CrossChainExecutor` contracts.
+Alternatively, `MessageDispatcher`s may implement a custom interface for initiating messages.
 
-#### Methods
+### MessageDispatcher
 
-**relayCalls**
+The `MessageDispatcher` lives on the chain from which messages are sent. The Dispatcher's job is to broadcast messages through a transport layer to one or more `MessageExecutor` contracts.
 
-Will relay a batch of `Call` structs to be executed by any `CrossChainExecutor`(s) that execute calls from this Relayer. The `gasLimit` is used as a limit on the executing side.
+A unique `messageId` MUST be generated for each message or message batch.
 
-`CrossChainRelayer`s MUST emit the `RelayedCalls` event when a batch of calls is relayed.
+To ensure uniqueness, it is RECOMMENDED that a monotonically increasing nonce is used in the calculation of the `messageId`.
 
-`CrossChainRelayer`s MUST increment a `nonce` so that each batch of calls can be uniquely identified.
+#### MessageDispatcher Methods
 
-`CrossChainRelayer`s MUST return the `nonce` to allow callers to track the batch of calls.
+**getMessageExecutorAddress**
 
-`CrossChainRelayer`s SHOULD pass the `nonce` as well as the address of the `sender` in the call to `CrossChainExecutor` to uniquely identify the message on the receiving chain.
+Will return the address of `MessageExecutor` on the `toChainId`.
 
-`CrossChainRelayer`s MAY require payment.
+`MessageDispatcher`s MUST revert if the `toChainId` is not supported.
 
 ```solidity
-struct Call {
-  address target;
-  bytes data;
-}
-
-interface CrossChainRelayer {
-  function relayCalls(Call[] calldata calls, uint256 gasLimit) external payable returns (uint256 nonce);
+interface MessageDispatcher {
+  function getMessageExecutorAddress(uint256 toChainId) external returns (address);
 }
 ```
 
 ```yaml
-- name: relayCalls
+- name: getMessageExecutorAddress
   type: function
-  stateMutability: payable
   inputs:
-    - name: calls
-      type: Call[]
-    - name: gasLimit
+    - name: toChainId
       type: uint256
   outputs:
-    - name: nonce
-      type: uint256
+    - type: address
 ```
 
-#### Events
+#### MessageDispatcher Events
 
-**RelayedCalls**
+**MessageDispatched**
 
-The `RelayedCalls` event MUST be emitted by the `CrossChainRelayer` when `relayCalls` is called.
+The `MessageDispatched` event MUST be emitted by the `MessageDispatcher` when an individual message is dispatched.
 
 ```solidity
-interface CrossChainRelayer {
-  event RelayedCalls(
-    uint256 indexed nonce,
-    address indexed sender,
-    Call[] calls,
-    uint256 gasLimit
+interface MessageDispatcher {
+  event MessageDispatched(
+    bytes32 indexed messageId,
+    address indexed from,
+    uint256 indexed toChainId,
+    address to,
+    bytes data,
   );
 }
 ```
 
 ```yaml
-- name: RelayedCalls
+- name: MessageDispatched
   type: event
   inputs:
-    - name: nonce
+    - name: messageId
+      indexed: true
+      type: bytes32
+    - name: from
+      indexed: true
+      type: address
+    - name: toChainId
       indexed: true
       type: uint256
-    - name: sender
+    - name: to
+      type: address
+    - name: data
+      type: bytes
+```
+
+**MessageBatchDispatched**
+
+The `MessageBatchDispatched` event MUST be emitted by the `MessageDispatcher` when a batch of messages is dispatched.
+
+```solidity
+struct Message {
+  address to;
+  bytes data;
+}
+
+interface MessageDispatcher {
+  event MessageBatchDispatched(
+    bytes32 indexed messageId,
+    address indexed from,
+    uint256 indexed toChainId,
+    Message[] messages
+  );
+}
+```
+
+```yaml
+- name: MessageBatchDispatched
+  type: event
+  inputs:
+    - name: messageId
+      indexed: true
+      type: bytes32
+    - name: from
       indexed: true
       type: address
-    - name: calls
-      type: Call[]
-    - name: gasLimit
+    - name: toChainId
+      indexed: true
       type: uint256
+    - name: messages
+      type: Message[]
 ```
 
-#### Error handling
+### SingleMessageDispatcher
+
+The `SingleMessageDispatcher` is an extension of `MessageDispatcher` that defines a method, `dispatchMessage`, for dispatching an individual message to be executed on the `toChainId`.
+
+#### SingleMessageDispatcher Methods
+
+**dispatchMessage**
+
+Will dispatch a message to be executed by the `MessageExecutor` on the destination chain specified by `toChainId`.
 
-**GasLimitTooHigh**
+`SingleMessageDispatcher`s MUST emit the `MessageDispatched` event when a message is dispatched.
 
-`CrossChainRelayer`s MAY revert with `GasLimitTooHigh` if the `gasLimit` passed to `relayCalls` is higher than the maximum gas limit accepted by the bridge being used.
+`SingleMessageDispatcher`s MUST revert if `toChainId` is not supported.
+
+`SingleMessageDispatcher`s MUST forward the message to a `MessageExecutor` on the `toChainId`.
+
+`SingleMessageDispatcher`s MUST use a unique `messageId` for each message.
+
+`SingleMessageDispatcher`s MUST return the `messageId` to allow the message sender to track the message.
+
+`SingleMessageDispatcher`s MAY require payment.
 
 ```solidity
-interface CrossChainRelayer {
-  error GasLimitTooHigh(
-    uint256 gasLimit,
-    uint256 maxGasLimit
-  );
+interface SingleMessageDispatcher is MessageDispatcher {
+  function dispatchMessage(uint256 toChainId, address to, bytes calldata data) external payable returns (bytes32 messageId);
+}
+```
+
+```yaml
+- name: dispatchMessage
+  type: function
+  stateMutability: payable
+  inputs:
+    - name: toChainId
+      type: uint256
+    - name: to
+      type: address
+    - name: data
+      type: bytes
+  outputs:
+    - name: messageId
+      type: bytes32
+```
+
+### BatchedMessageDispatcher
+
+The `BatchedMessageDispatcher` is an extension of `MessageDispatcher` that defines a method, `dispatchMessageBatch`, for dispatching a batch of messages to be executed on the `toChainId`.
+
+#### BatchedMessageDispatcher Methods
+
+**dispatchMessageBatch**
+
+Will dispatch a batch of messages to be executed by the `MessageExecutor` on the destination chain specified by `toChainId`.
+
+`BatchedMessageDispatcher`s MUST emit the `MessageBatchDispatched` event when a message batch is dispatched.
+
+`BatchedMessageDispatcher`s MUST revert if `toChainId` is not supported.
+
+`BatchedMessageDispatcher`s MUST forward the message batch to the `MessageExecutor` on the `toChainId`.
+
+`BatchedMessageDispatcher`s MUST use a unique `messageId` for each batch of messages.
+
+`BatchedMessageDispatcher`s MUST return the `messageId` to allow the message sender to track the batch of messages.
+
+`BatchedMessageDispatcher`s MAY require payment.
+
+```solidity
+interface BatchedMessageDispatcher is MessageDispatcher {
+  function dispatchMessageBatch(uint256 toChainId, Message[] calldata messages) external payable returns (bytes32 messageId);
 }
 ```
 
-### CrossChainExecutor
+```yaml
+- name: dispatchMessageBatch
+  type: function
+  stateMutability: payable
+  inputs:
+    - name: toChainId
+      type: uint256
+    - name: messages
+      type: Message[]
+  outputs:
+    - name: messageId
+      type: bytes32
+```
+
+### MessageExecutor
 
-The `CrossChainExecutor` executes relayed calls. Developers must implement a `CrossChainExecutor` in order to execute messages on the receiving chain.
+The `MessageExecutor` executes dispatched messages and message batches. Developers must implement a `MessageExecutor` in order to execute messages on the receiving chain.
 
-The `CrossChainExecutor` will execute a nonce only once, but may execute nonces in any order. This specification makes no ordering guarantees, because messages may travel non-sequentially through the transport layer.
+The `MessageExecutor` will execute a messageId only once, but may execute messageIds in any order. This specification makes no ordering guarantees, because messages and message batches may travel non-sequentially through the transport layer.
 
 #### Execution
 
-`CrossChainExecutor`s SHOULD authenticate that the call has been performed by the bridge transport layer.
+`MessageExecutor`s SHOULD verify all message data with the bridge transport layer.
+
+`MessageExecutor`s MUST NOT successfully execute a message more than once.
 
-`CrossChainExecutor`s MUST NOT execute a batch of calls more than once.
+`MessageExecutor`s MUST revert the transaction when a message fails to be executed allowing the message to be retried at a later time.
 
 **Calldata**
 
-`CrossChainExecutor`s MUST append the ABI-packed (`nonce`, `sender`) to the calldata for each call being executed. It allows the receiver of the call to check the true `sender` of the transaction and use the `nonce` to apply any transaction ordering logic.
+`MessageExecutor`s MUST append the ABI-packed (`messageId`, `fromChainId`, `from`) to the calldata for each message being executed. This allows the receiver of the message to verify the cross-chain sender and the chain that the message is coming from.
 
 ```solidity
-interface CrossChainExecutor {
-  bytes calldata = abi.encode(Call.data, nonce, sender); // Can also use abi.encodePacked
-}
+to.call(abi.encodePacked(data, messageId, fromChainId, from));
 ```
 
 ```yaml
 - name: calldata
   type: bytes
   inputs:
-    - name: Call.data
+    - name: data
       type: bytes
-    - name: nonce
+    - name: messageId
+      type: bytes32
+    - name: fromChainId
       type: uint256
-    - name: sender
+    - name: from
       type: address
 ```
 
 #### Error handling
 
-**CallsAlreadyExecuted**
+**MessageAlreadyExecuted**
 
-`CrossChainExecutor`s MUST revert if a batch of calls has already been executed and SHOULD emit `CallsAlreadyExecuted` custom error.
+`MessageExecutor`s MUST revert if a messageId has already been executed and SHOULD emit a `MessageIdAlreadyExecuted` custom error.
 
 ```solidity
-interface CrossChainExecutor {
-  error CallsAlreadyExecuted(
-    uint256 nonce
+interface MessageExecutor {
+  error MessageIdAlreadyExecuted(
+    bytes32 messageId
   );
 }
 ```
 
-**CallFailure**
+**MessageFailure**
 
-`CrossChainExecutor`s SHOULD revert with a `CallFailure` error if a call fails.
+`MessageExecutor`s MUST revert if an individual message fails and SHOULD emit a `MessageFailure` custom error.
 
 ```solidity
-interface CrossChainExecutor {
-  error CallFailure(
-    uint256 callIndex,
+interface MessageExecutor {
+  error MessageFailure(
+    bytes32 messageId,
     bytes errorData
   );
 }
 ```
 
-#### Events
+**MessageBatchFailure**
 
-**ExecutedCalls**
+`MessageExecutor`s MUST revert the entire batch if any message in a batch fails and SHOULD emit a `MessageBatchFailure` custom error.
 
-`ExecutedCalls` MUST be emitted once calls have been executed.
+```solidity
+interface MessageExecutor {
+  error MessageBatchFailure(
+    bytes32 messageId,
+    uint256 messageIndex,
+    bytes errorData
+  );
+}
+```
+
+#### MessageExecutor Events
+
+**MessageIdExecuted**
+
+`MessageIdExecuted` MUST be emitted once a message or message batch has been executed.
 
 ```solidity
-interface CrossChainExecutor {
-  event ExecutedCalls(
-    CrossChainRelayer indexed relayer,
-    uint256 indexed nonce
+interface MessageExecutor {
+  event MessageIdExecuted(
+    uint256 indexed fromChainId,
+    bytes32 indexed messageId
   );
 }
 ```
 
 ```yaml
-- name: ExecutedCalls
+- name: MessageIdExecuted
   type: event
   inputs:
-    - name: relayer
-      indexed: true
-      type: CrossChainRelayer
-    - name: nonce
+    - name: fromChainId
       indexed: true
       type: uint256
+    - name: messageId
+      indexed: true
+      type: bytes32
 ```
 
 ## Rationale
 
-The `CrossChainRelayer` can be coupled to one or more `CrossChainExecutor`. It is up to bridges to decide how to couple the two. Users can easily bridge a message by calling `relayCalls` without being aware of the `CrossChainExecutor` address. Messages can also be traced by a client using the data logged by the `ExecutedCalls` event.
-
-Calls are relayed in batches because it is such a common action. Rather than have implementors take different approaches to encoding multiple calls into the `data` portion, this specification includes call batching to take away any guess work.
-
-Some bridges may require payment in the native currency, so the `relayCalls` function is payable.
+The `MessageDispatcher` can be coupled to one or more `MessageExecutor`. It is up to bridges to decide how to couple the two. Users can easily bridge a message by calling `dispatchMessage` without being aware of the `MessageExecutor` address. Messages can also be traced by a client using the data logged by the `MessageIdExecuted` event.
 
-Bridges relay messages in various ways, applications should be aware of how the bridge they rely on operates and decide if they want to enforce transaction ordering by using the `nonce`.
+Some bridges may require payment in the native currency, so the `dispatchMessage` function is payable.
 
 ## Backwards Compatibility
 

From c7c44aaa7baf401328e6c0e5a9ee1de49c31d97a Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sat, 21 Jan 2023 10:06:36 -0500
Subject: [PATCH 190/274] Update EIP-4834: Move to Final (#6363)

---
 EIPS/eip-4834.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/EIPS/eip-4834.md b/EIPS/eip-4834.md
index 9310db9baf2c0e..8ddcc36d958b7e 100644
--- a/EIPS/eip-4834.md
+++ b/EIPS/eip-4834.md
@@ -4,8 +4,7 @@ title: Hierarchical Domains
 description: Extremely generic name resolution
 author: Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/erc-4834-hierarchical-domains-standard/8388
-status: Last Call
-last-call-deadline: 2023-01-20
+status: Final
 type: Standards Track
 category: ERC
 created: 2022-02-22

From 3927907a647cc63b3ae42f479cd8355261d3a0a5 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sat, 21 Jan 2023 10:06:55 -0500
Subject: [PATCH 191/274] Update EIP-2771: Move to Final (#6362)

---
 EIPS/eip-2771.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/EIPS/eip-2771.md b/EIPS/eip-2771.md
index b2d0542e1d97b2..9fb1ba84e03cf8 100644
--- a/EIPS/eip-2771.md
+++ b/EIPS/eip-2771.md
@@ -4,8 +4,7 @@ title: Secure Protocol for Native Meta Transactions
 description: A contract interface for receiving meta transactions through a trusted forwarder
 author: Ronan Sandford (@wighawag), Liraz Siri (@lirazsiri), Dror Tirosh (@drortirosh), Yoav Weiss (@yoavw), Alex Forshtat (@forshtat), Hadrien Croubois (@Amxx), Sachin Tomar (@tomarsachin2271), Patrick McCorry (@stonecoldpat), Nicolas Venturo (@nventuro), Fabian Vogelsteller (@frozeman), Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/erc-2771-secure-protocol-for-native-meta-transactions/4488
-status: Last Call
-last-call-deadline: 2023-01-20
+status: Final
 type: Standards Track
 category: ERC
 created: 2020-07-01

From 1b4112a8207ffe0e54910c772e6d12d2886300d8 Mon Sep 17 00:00:00 2001
From: Hugo <jhugodc@gmail.com>
Date: Sun, 22 Jan 2023 23:02:05 -0700
Subject: [PATCH 192/274] fix RJUMPI -> JUMPI (#6368)

---
 EIPS/eip-4200.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4200.md b/EIPS/eip-4200.md
index fc744bc6636c39..19497a60abcc80 100644
--- a/EIPS/eip-4200.md
+++ b/EIPS/eip-4200.md
@@ -77,7 +77,7 @@ Should there be a need to have immediate encodings of other size (such as 8-bits
 
 ### `PUSHn JUMP` sequences
 
-If we chose absolute addressing, then `RJUMP` could be viewed similar to the sequence `PUSHn JUMP` (and `RJUMPI` similar to `PUSHn RJUMPI`). In that case one could argue that instead of introducing a new instruction, such sequences should get a discount, because EVMs could optimise them.
+If we chose absolute addressing, then `RJUMP` could be viewed similar to the sequence `PUSHn JUMP` (and `RJUMPI` similar to `PUSHn JUMPI`). In that case one could argue that instead of introducing a new instruction, such sequences should get a discount, because EVMs could optimise them.
 
 We think this is a bad direction to go:
 

From 394bdcca14c2417b086e03dff489e30b67436e6a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <pawel@ethereum.org>
Date: Mon, 23 Jan 2023 10:52:17 +0100
Subject: [PATCH 193/274] EIP-3540: Add @lightclient as author (#6347)

---
 EIPS/eip-3540.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-3540.md b/EIPS/eip-3540.md
index b9a3fcfc31f490..78f594f49303be 100644
--- a/EIPS/eip-3540.md
+++ b/EIPS/eip-3540.md
@@ -2,7 +2,7 @@
 eip: 3540
 title: EOF - EVM Object Format v1
 description: EOF is an extensible and versioned container format for EVM bytecode with a once-off validation at deploy time.
-author: Alex Beregszaszi (@axic), Paweł Bylica (@chfast), Andrei Maiboroda (@gumb0)
+author: Alex Beregszaszi (@axic), Paweł Bylica (@chfast), Andrei Maiboroda (@gumb0), Matt Garnett (@lightclient)
 discussions-to: https://ethereum-magicians.org/t/evm-object-format-eof/5727
 status: Review
 type: Standards Track

From 0f3191f6e8a1613972d7fdaecc01470c50bd00b8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Pawe=C5=82=20Bylica?= <pawel@ethereum.org>
Date: Mon, 23 Jan 2023 10:54:46 +0100
Subject: [PATCH 194/274] EIP-5450: Extend motivation of AOT/JIT compilation
 (#6346)

* EIP-5450: Extend motivation of AOT/JIT compilation

* Apply suggestions from code review

Co-authored-by: Andrei Maiboroda <andrei@ethereum.org>

Co-authored-by: Danno Ferrin <danno.ferrin@swirldslabs.com>
Co-authored-by: Andrei Maiboroda <andrei@ethereum.org>
---
 EIPS/eip-5450.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-5450.md b/EIPS/eip-5450.md
index 1a7fb49a9448f6..d419ce19f625cb 100644
--- a/EIPS/eip-5450.md
+++ b/EIPS/eip-5450.md
@@ -2,7 +2,7 @@
 eip: 5450
 title: EOF - Stack Validation
 description: Deploy-time validation of stack usage for EOF functions.
-author: Andrei Maiboroda (@gumb0), Paweł Bylica (@chfast), Alex Beregszaszi (@axic)
+author: Andrei Maiboroda (@gumb0), Paweł Bylica (@chfast), Alex Beregszaszi (@axic), Danno Ferrin (@shemnon)
 discussions-to: https://ethereum-magicians.org/t/eip-5450-eof-stack-validation/10410
 status: Review
 type: Standards Track
@@ -36,6 +36,8 @@ It also has some disadvantages:
 - adds constraints to the code structure (similar to JVM, CPython bytecode, WebAssembly and others); however, these constraints can be lifted in a backward-compatible manner if they are shown to be user-unfriendly,
 - adds second validation pass; however, validation's computational and space complexity remains linear.
 
+The guarantees created by these validation rules also improve the feasabiliy of Ahead-Of-Time and Just-In-Time compilation of EVM code. Single pass transpilation passes can be safely executed with the code validation and advanced stack/register handling can be applied with the stack height validaitons. While not as impactful to a mainnet validator node that is bound mostly by storage state sizes, these can significantly speed up witness validation and other non-mainnet use cases.
+
 ## Specification
 
 ### Code validation

From ce37c2ae7a9746472e3cf996e48402bfa2a7ae4a Mon Sep 17 00:00:00 2001
From: xinbenlv <zzn-github@zzn.im>
Date: Tue, 24 Jan 2023 06:11:53 -0800
Subject: [PATCH 195/274] Move EIP-5298 to Review (#5934)


From c2f9703c35f953e5ae274b01146a300bbf8262fc Mon Sep 17 00:00:00 2001
From: ashhanai <ashhab.naim@gmail.com>
Date: Tue, 24 Jan 2023 14:12:33 +0000
Subject: [PATCH 196/274] Update EIP-5646: Move to Final (#6365)

* Add EIP-5646: Token state fingerprint

* Update EIP-5646: add link to discussion

* Update EIP-5646: reference ERC standards as EIP-N

* Update EIP-5646: update all EIP references to links

* Update EIP-5646: fix incorrect EIP references

* Update EIP-5646: Rework the structure of the whole draft

* Update EIP-5646: Move to Final
---
 EIPS/eip-5646.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/EIPS/eip-5646.md b/EIPS/eip-5646.md
index d7696e0424d204..db381c1f58fac1 100644
--- a/EIPS/eip-5646.md
+++ b/EIPS/eip-5646.md
@@ -4,8 +4,7 @@ title: Token State Fingerprint
 description: Unambiguous token state identifier
 author: Naim Ashhab (@ashhanai)
 discussions-to: https://ethereum-magicians.org/t/eip-5646-discussion-token-state-fingerprint/10808
-status: Last Call
-last-call-deadline: 2022-12-21
+status: Final
 type: Standards Track
 category: ERC
 created: 2022-09-11

From 8d864ed31396543751e82929ff637955b9d655a1 Mon Sep 17 00:00:00 2001
From: Dhruv Malik <malikdhruv1994@gmail.com>
Date: Tue, 24 Jan 2023 15:14:11 +0100
Subject: [PATCH 197/274] Update EIP-3475: Changing comments (#5789)

* some minor description changes in interface and example implemenation.

* rectifying description of the array struct.

* Update assets/eip-3475/interfaces/IERC3475.sol

grammer refactor

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update assets/eip-3475/interfaces/IERC3475.sol

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update assets/eip-3475/interfaces/IERC3475.sol

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update assets/eip-3475/interfaces/IERC3475.sol

refactor

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* refactoring and addressing ambiguous descriptions

* refactor

* refactor final

* adding correct syntax and all refactoring done !!

* spaces and refactoring

* update

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* adding the comments in the interfaces from the standard description.

* separating the examples for events, decluttering.

* updating  the example class name

* removing redundant metadata description.

* refactor the standard based on feedback  PR #6128

* add example

* modified:   EIPS/eip-3475.md
- Rectifying the example on explaining the approval function(L#126).
- Changing the formatting of subheadings in rational to be better visiblity and linting. (L#268).
- Rectifying the definition of `event Redeem()` to include transaction struct parameter. (L#297).
- Linting suggestion(L#346,L#385, L#404).
- Re-writing the sentence that defines the rational of having metadata structure(L#365)

	modified:   assets/eip-3475/ERC3475.sol
- clarifying the correct definition of value in metadata.

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-3475.md                        | 120 ++++++++++++++----------
 assets/eip-3475/ERC3475.sol             |  23 +++--
 assets/eip-3475/interfaces/IERC3475.sol |  19 +++-
 3 files changed, 100 insertions(+), 62 deletions(-)

diff --git a/EIPS/eip-3475.md b/EIPS/eip-3475.md
index c8b909f94c8712..f55b6dc3e3334d 100644
--- a/EIPS/eip-3475.md
+++ b/EIPS/eip-3475.md
@@ -13,19 +13,20 @@ requires: 20, 721, 1155
 
 ## Abstract
 
-- This EIP allows the creation of tokenized obligations with abstract on-chain metadata storage. Issuing bonds with multiple redemption data cannot be achieved with existing token standards. 
+- This EIP allows the creation of tokenized obligations with abstract on-chain metadata storage. Issuing bonds with multiple redemption data cannot be achieved with existing token standards.
 
 - This EIP enables each bond class ID to represent a new configurable token type and corresponding to each class, corresponding bond nonces to represent an issuing condition or any other form of data in uint256. Every single nonce of a bond class can have its metadata, supply, and other redemption conditions.
 
 - Bonds created by this EIP can also be batched for issuance/redemption conditions for efficiency on gas costs and UX side. And finally, bonds created from this standard can be divided and exchanged in a secondary market.
 
 ## Motivation
+
 Current LP (Liquidity Provider) tokens are simple [EIP-20](./eip-20.md) tokens with no complex data structure. To allow more complex reward and redemption logic to be stored on-chain, we need a new token standard that:
 
- - Supports multiple token IDs
- - Can store on-chain metadata
- - Doesn't require a fixed storage pattern
- - Is gas-efficient.
+- Supports multiple token IDs
+- Can store on-chain metadata
+- Doesn't require a fixed storage pattern
+- Is gas-efficient.
 
 Also Some benefits:
 
@@ -50,9 +51,11 @@ pragma solidity ^0.8.0;
 * @param _to argument is the address of the bond recipient whose balance is about to increase.
 * @param _transactions is the `Transaction[] calldata` (of type ['classId', 'nonceId', '_amountBonds']) structure defined in the rationale section below.
 * @dev transferFrom MUST have the `isApprovedFor(_from, _to, _transactions[i].classId)` approval to transfer `_from` address to `_to` address for given classId (i.e for Transaction tuple corresponding to all nonces).
+e.g:
+* function transferFrom(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, 0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B, [IERC3475.Transaction(1,14,500)]);
+* transfer from `_from` address, to `_to` address, `500000000` bonds of type class`1` and nonce `42`.
 */
-// function transferFrom(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, 0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B, [IERC3475.Transaction(1,14,500)]);
-// transfer from `_from` address, to `_to` address, `500000000` bonds of type class`1` and nonce `42`.
+
 function transferFrom(address _from, address _to, Transaction[] calldata _transactions) external;
 
 /**
@@ -62,10 +65,12 @@ function transferFrom(address _from, address _to, Transaction[] calldata _transa
 * @param _to is the address of the recipient whose balance is about to increase.
 * @param _transactions is the `Transaction[] calldata` structure defined in the section `rationale` below.
 * @dev transferAllowanceFrom MUST have the `allowance(_from, msg.sender, _transactions[i].classId, _transactions[i].nonceId)` (where `i` looping for [ 0 ...Transaction.length - 1] ) 
+e.g:
+* function transferAllowanceFrom(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, 0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B, [IERC3475.Transaction(1,14,500)]);
+* transfer from `_from` address, to `_to` address, `500000000` bonds of type class`1` and nonce `42`.
 */
-// function transferAllowanceFrom(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, 0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B, [IERC3475.Transaction(1,14,500)]);
-// transfer from `_from` address, to `_to` address, `500000000` bonds of type class`1` and nonce `42`.
-function transferAllowanceFrom(address _from,address _to, Transaction[] calldata _transactions) public virtual override
+
+function transferAllowanceFrom(address _from,address _to, Transaction[] calldata _transactions) public ;
 
 /**
 * issue 
@@ -74,9 +79,10 @@ function transferAllowanceFrom(address _from,address _to, Transaction[] calldata
 * @param `_to` argument is the address to which the bond will be issued.
 * @param `_transactions` is the `Transaction[] calldata` (ie array of issued bond class, bond nonce and amount of bonds to be issued).
 * @dev transferAllowanceFrom MUST have the `allowance(_from, msg.sender, _transactions[i].classId, _transactions[i].nonceId)` (where `i` looping for [ 0 ...Transaction.length - 1] ) 
+e.g:
+example: issue(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,[IERC3475.Transaction(1,14,500)]);
+issues `1000` bonds with a class of `0` to address `0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef` with a nonce of `5`.
 */
-// example: issue(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,[IERC3475.Transaction(1,14,500)]);
-// issues `1000` bonds with a class of `0` to address `0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef` with a nonce of `5`.
 function issue(address _to, Transaction[] calldata _transaction) external; 
 
 /**
@@ -87,9 +93,11 @@ function issue(address _to, Transaction[] calldata _transaction) external;
 * @param `_transactions` is the `Transaction[] calldata` structure (i.e., array of tuples with the pairs of (class, nonce and amount) of the bonds that are to be redeemed). Further defined in the rationale section.
 * @dev redeem function for a given class, and nonce category MUST BE done after certain conditions for maturity (can be end time, total active liquidity, etc.) are met. 
 * @dev furthermore, it SHOULD ONLY be called by the bank or secondary market maker contract.
+e.g:
+* redeem(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, [IERC3475.Transaction(1,14,500)]);
+means “redeem from wallet address(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef), 500000000 of bond class1 and nonce 42.
 */
-// redeem(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, [IERC3475.Transaction(1,14,500)]);
-// means “redeem from wallet address(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef), 500000000 of bond class1 and nonce 42.
+
 function redeem(address _from, Transaction[] calldata _transactions) external; 
 
 /**
@@ -100,9 +108,10 @@ function redeem(address _from, Transaction[] calldata _transactions) external;
 * @param `_transactions` is the `Transaction[] calldata` structure (i.e., array of tuple with the pairs of (class, nonce and amount) of the bonds that are to be burned). further defined in the rationale.
 * @dev burn function for a given class, and nonce category MUST BE done only after certain conditions for maturity (can be end time, total active liquidity, etc). 
 * @dev furthermore, it SHOULD ONLY be called by the bank or secondary market maker contract.
+* e.g:  
+* burn(0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B,[IERC3475.Transaction(1,14,500)]);
+* means burning 500000000 bonds of class 1 nonce 42 owned by address 0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B.
 */
-// burnBond(0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B,[IERC3475.Transaction(1,14,500)]);
-// means burning 500000000 bonds of class 1 nonce 42 owned by address 0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B.
 function burn(address _from, Transaction[] calldata _transactions) external; 
 
 /**
@@ -112,9 +121,11 @@ function burn(address _from, Transaction[] calldata _transactions) external;
 * @dev `approve()` should only be callable by the bank, or the owner of the account.
 * @param `_spender` argument is the address of the user who is approved to transfer the bonds.
 * @param `_transactions` is the `Transaction[] calldata` structure (ie array of tuple with the pairs of (class,nonce, and amount) of the bonds that are to be approved to be spend by _spender). Further defined in the rationale section.
+* e.g: 
+* approve(0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B,[IERC3475.Transaction(1,14,500)]);
+* means owner of address 0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B is approved to manage 500 bonds from class 1 and Nonce 14.
 */
-// approve(0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B,[IERC3475.Transaction(1,14,500)]);
-// means owner of address 0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B is approved to manage 30000 bonds from class 0 and Nonce 1.
+
 function approve(address _spender, Transaction[] calldata _transactions) external;
 
 /**
@@ -126,9 +137,10 @@ function approve(address _spender, Transaction[] calldata _transactions) externa
 * @param `classId` is the class id of the bond.
 * @param `_approved` is true if the operator is approved (based on the conditions provided), false meaning approval is revoked.
 * @dev contract MUST define internal function regarding the conditions for setting approval and should be callable only by bank or owner.
+* e.g: setApprovalFor(0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B,0,true);
+* means that address 0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B is authorized to transfer bonds from class 0 (across all nonces).
 */
-// setApprovalFor(0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B,0,true);
-// means that address 0x82a55a613429Aeb3D01fbE6841bE1AcA4fFD5b2B is authorized to transfer bonds from class 0 (across all nonces).
+
 function setApprovalFor(address _operator, bool _approved) external returns(bool approved);
 
 /**
@@ -137,9 +149,10 @@ function setApprovalFor(address _operator, bool _approved) external returns(bool
 * @param classId is the corresponding class Id of the bond.
 * @param nonceId is the nonce Id of the given bond class.
 * @return the supply of the bonds
+* e.g:
+* totalSupply(0, 1);
+* it finds the total supply of the bonds of classid 0 and bond nonce 1.
 */
-// totalSupply(0, 1);
-// it finds the total supply of the bonds of classid 0 and bond nonce 1.
 function totalSupply(uint256 classId, uint256 nonceId) external view returns (uint256);
 
 /**
@@ -239,7 +252,7 @@ function getProgress(uint256 classId, uint256 nonceId) external view returns (ui
 * @param nonceId is the nonceId of the given bond class. 
 * @notice Returns the _amount which spender is still allowed to withdraw from _owner.
 */
-function allowance(address _owner, address _spender, uint256 classId, uint256 nonceId) external view returns(uint256);
+function allowance(address _owner, address _spender, uint256 classId, uint256 nonceId) external returns(uint256);
 
 /** 
 * isApprovedFor
@@ -252,7 +265,7 @@ function allowance(address _owner, address _spender, uint256 classId, uint256 no
 function isApprovedFor(address _owner, address _operator) external view returns (bool);
 ```
 
-**Events**
+### Events
 
 ```solidity
 /** 
@@ -260,47 +273,51 @@ function isApprovedFor(address _owner, address _operator) external view returns
 * @notice Issue MUST trigger when Bonds are issued. This SHOULD not include zero value Issuing.
 * @dev This SHOULD not include zero value issuing.
 * @dev Issue MUST be triggered when the operator (i.e Bank address) contract issues bonds to the given entity.
+* eg: emit Issue(_operator, 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,[IERC3475.Transaction(1,14,500)]); 
+* issue by address(operator) 500 Bonds(nonce14,class 1) to address 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef.
 */
+
 event Issue(address indexed _operator, address indexed _to, Transaction[] _transactions); 
-// eg:
- 
-emit Issue(_operator, 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,[IERC3475.Transaction(1,14,500)]); 
-// issue by address(operator) 500 DBIT-USD Bond(nonce14,class 0) to address 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef.
 
 /** 
 * Redeem
 * @notice Redeem MUST trigger when Bonds are redeemed. This SHOULD not include zero value redemption.
+*e.g: emit Redeem(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,0x492Af743654549b12b1B807a9E0e8F397E44236E,[IERC3475.Transaction(1,14,500)]);
+* emit event when 5000 bonds of class 1, nonce 14 owned by address 0x492Af743654549b12b1B807a9E0e8F397E44236E are being redeemed by 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef.
 */
-event Redeem(address indexed _operator, address indexed _from, uint256 classId, uint256 nonceId, uint256 _amount);
-//e.g: 
-emit Redeem(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,0x492Af743654549b12b1B807a9E0e8F397E44236E,[IERC3475.Transaction(1,14,500)]);
-//emit event when 5000 bonds of class 1, nonce 14 owned by address 0x492Af743654549b12b1B807a9E0e8F397E44236E are being redeemed by 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef.
+
+event Redeem(address indexed _operator, address indexed _from, Transaction[] _transactions);
+
 
 /** 
 * Burn.
 * @dev `Burn` MUST trigger when the bonds are being redeemed via staking (or being invalidated) by the bank contract.
 * @dev `Burn` MUST trigger when Bonds are burned. This SHOULD not include zero value burning.
+* e.g : emit Burn(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,0x492Af743654549b12b1B807a9E0e8F397E44236E,[IERC3475.Transaction(1,14,500)]);
+* emits event when 500 bonds of owner 0x492Af743654549b12b1B807a9E0e8F397E44236E of type (class 1, nonce 14) are burned by operator  0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef.
 */
- emit Burn(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,0x492Af743654549b12b1B807a9E0e8F397E44236E,[IERC3475.Transaction(1,14,500)]);
-//emits event when 5000 bonds of owner 0x492Af743654549b12b1B807a9E0e8F397E44236E of type (class 1, nonce 14) are burned by operator 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef.
+
+event burn(address _operator, address _owner, Transaction[] _transactions);
 
 /** 
 * Transfer
 * @dev its emitted when the bond is transferred by address(operator) from owner address(_from) to address(_to) with the bonds transferred, whose params are defined by _transactions struct array. 
 * @dev Transfer MUST trigger when Bonds are transferred. This SHOULD not include zero value transfers.
 * @dev Transfer event with the _from `0x0` MUST not create this event(use `event Issued` instead). 
+* e.g  emit Transfer(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, 0x492Af743654549b12b1B807a9E0e8F397E44236E, _to, [IERC3475.Transaction(1,14,500)]);
+* transfer by address(_operator) amount 500 bonds with (Class 1 and Nonce 14) from 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, to address(_to).
 */
-emit Transfer(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, 0x492Af743654549b12b1B807a9E0e8F397E44236E, _to, [IERC3475.Transaction(1,14,500)]);
-// transfer by address(_operator) amount 500 DBIT-USD bonds with (Class 1 and Nonce 14) from 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, to address(_to).
+
 event Transfer(address indexed _operator, address indexed _from, address indexed _to, Transaction[] _transactions);
 
 /**
 * ApprovalFor
 * @dev its emitted when address(_owner) approves the address(_operator) to transfer his bonds.
 * @notice Approval MUST trigger when bond holders are approving an _operator. This SHOULD not include zero value approval. 
+* eg: emit ApprovalFor(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, 0x492Af743654549b12b1B807a9E0e8F397E44236E, true);
+* this means 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef gives 0x492Af743654549b12b1B807a9E0e8F397E44236E access permission for transfer of its bonds.
 */
-emit ApprovalFor(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, 0x492Af743654549b12b1B807a9E0e8F397E44236E);
-// this means 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef gives 0x492Af743654549b12b1B807a9E0e8F397E44236E access permission for transfer of its bonds.
+
 event ApprovalFor(address indexed _owner, address indexed _operator, bool _approved);
 ```
 
@@ -326,17 +343,17 @@ Some specific examples of metadata can be the localization of bonds, jurisdictio
 
 This structure defines the details of the class information (symbol, risk information, etc.). the example is explained [here](../assets/eip-3475/Metadata.md) in the class metadata section.
 
-### 4. Decoding data:
+### 4. Decoding data
 
-First, the functions for analyzing the metadata (i.e `ClassMetadata` and `NonceMetadata`) are to be used by the corresponding frontend to decode the information of the bond. 
+First, the functions for analyzing the metadata (i.e `ClassMetadata` and `NonceMetadata`) are to be used by the corresponding frontend to decode the information of the bond.
 
-This is done via overriding the function interface for functions `classValues` and `nonceValues` by defining the key (which SHOULD be an index) to read the corresponding information stored as a JSON object. 
+This is done via overriding the function interface for functions `classValues` and `nonceValues` by defining the key (which SHOULD be an index) to read the corresponding information stored as a JSON object.
 
 ```JSON
 {
 "title": "symbol",
 "_type": "string",
-"description": "Lorem ipsum..."
+"description": "defines the unique identifier name in following format: (symbol, bondType, maturity in months)",
 "values": ["Class Name 1","Class Name 2","DBIT Fix 6M"],
 }
 ```
@@ -345,7 +362,9 @@ e.g. In the above example, to get the `symbol` of the given class id, we can use
 
 ## Rationale
 
-**Metadata structure**: Instead of utilizing a mapping from address, the bond's metadata like the time of redemption, redemption conditions, and interest rate can be stored in the bond class and nonce structures. Classes represent the different bond types, and nonces represent the various period of issuances. Nonces under the same class share the same metadata. Meanwhile, nonces are non-fungible. Each nonce can store a different set of metadata. Thus, upon transfer of a bond, all the metadata will be transferred to the new owner of the bond.
+### Metadata structure
+
+Instead of storing the details about the class and their issuances to the user (ie nonce) externally, we store the details in the respective structures. Classes represent the different bond types, and nonces represent the various period of issuances. Nonces under the same class share the same metadata. Meanwhile, nonces are non-fungible. Each nonce can store a different set of metadata. Thus, upon transfer of a bond, all the metadata will be transferred to the new owner of the bond.
 
 ```solidity
  struct Values{
@@ -353,6 +372,7 @@ e.g. In the above example, to get the `symbol` of the given class id, we can use
  uint uintValue;
  address addressValue;
  bool boolValue;
+ bytes bytesValue;
  }
 ```
 
@@ -364,8 +384,7 @@ e.g. In the above example, to get the `symbol` of the given class id, we can use
  }
 ```
 
-
-**Batch function:**
+### Batch function
 
  This EIP supports batch operations. It allows the user to transfer different bonds along with their metadata to a new address instantaneously in a single transaction. After execution, the new owner holds the right to reclaim the face value of each of the bonds. This mechanism helps with the "packaging" of bonds–helpful in use cases like trades on a secondary market.
 
@@ -384,8 +403,9 @@ The `nonceId` is the nonce id of the given bond class. This param is for distinc
 
 The `_amount` is the amount of the bond for which the spender is approved.
 
+### AMM optimization
 
-**AMM optimization**: One of the most obvious use cases of this EIP is the multilayered pool. The early version of AMM uses a separate smart contract and an [EIP-20](./eip-20.md) LP token to manage a pair. By doing so, the overall liquidity inside of one pool is significantly reduced and thus generates unnecessary gas spent and slippage. Using this EIP standard, one can build a big liquidity pool with all the pairs inside (thanks to the presence of the data structures consisting of the liquidity corresponding to the given class and nonce of bonds). Thus by knowing the class and nonce of the bonds, the liquidity can be represented as the percentage of a given token pair for the owner of the bond in the given pool. Effectively, the [EIP-20](./eip-20.md) LP token (defined by a unique smart contract in the pool factory contract) is aggregated into a single bond and consolidated into a single pool.
+ One of the most obvious use cases of this EIP is the multilayered pool. The early version of AMM uses a separate smart contract and an [EIP-20](./eip-20.md) LP token to manage a pair. By doing so, the overall liquidity inside of one pool is significantly reduced and thus generates unnecessary gas spent and slippage. Using this EIP standard, one can build a big liquidity pool with all the pairs inside (thanks to the presence of the data structures consisting of the liquidity corresponding to the given class and nonce of bonds). Thus by knowing the class and nonce of the bonds, the liquidity can be represented as the percentage of a given token pair for the owner of the bond in the given pool. Effectively, the [EIP-20](./eip-20.md) LP token (defined by a unique smart contract in the pool factory contract) is aggregated into a single bond and consolidated into a single pool.
 
 - The reason behind the standard's name (abstract storage bond) is its ability to store all the specifications (metadata/values and transaction as defined in the following sections) without needing external storage on-chain/off-chain.
 
@@ -401,7 +421,7 @@ To ensure the indexing of transactions throughout the bond lifecycle (i.e "Issue
 
 However, creating a separate bank contract is recommended for reading the bonds and future upgrade needs.
 
-Acceptable collateral can be in the form of [EIP-20](./eip-20.md) tokens, [EIP-721](./eip-721.md) tokens, or other bonds represented by the standard. Thus bonds can now represent a collection of collaterals (of the same type) of all fungible/non-fungible or semi-fungible tokens.
+Acceptable collateral can be in the form of fungible (like [EIP-20](./eip-20.md)), non-fungible ([EIP-721](./eip-721.md), [EIP-1155](./eip-1155.md)) , or other bonds represented by this standard.
 
 ## Test Cases
 
@@ -412,16 +432,14 @@ Test-case for the minimal reference implementation is [here](../assets/eip-3475/
 - [Interface](../assets/eip-3475/interfaces/IERC3475.sol).
 
 - [Basic Example](../assets/eip-3475/ERC3475.sol).
- - This demonstration shows only minimalist implementation.
+  - This demonstration shows only minimalist implementation.
 
 ## Security Considerations
 
-- The `function setApprovalFor()` gives the operator role in this standard. It has all the permissions to transfer, burn and redeem bonds by default.
+- The `function setApprovalFor(address _operatorAddress)` gives the operator role to `_operatorAddress`. It has all the permissions to transfer, burn and redeem bonds by default.
 
 - If the owner wants to give a one-time allocation to an address for specific bonds(classId,bondsId), he should call the `function approve()` giving the `Transaction[]` allocated rather than approving all the classes using `setApprovalFor`.
 
-- The `function issue()` can only be called by the bank contract (what we call issuer in this EIP). This can be either a smart contract managing the logic of liquidity management and routing the collateral, but also EOA multi-sig.
-
 ## Copyright
 
 Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-3475/ERC3475.sol b/assets/eip-3475/ERC3475.sol
index 157476587c42f1..43448e132e1999 100644
--- a/assets/eip-3475/ERC3475.sol
+++ b/assets/eip-3475/ERC3475.sol
@@ -49,16 +49,18 @@ contract ERC3475 is IERC3475 {
         _classMetadata[0].title = "symbol";
         _classMetadata[0]._type = "string";
         _classMetadata[0].description = "symbol of the class";
-        _classes[0]._values[0].stringValue = "DBIT Fix 6M";
-        _classMetadata[1].title = "symbol";
-        _classMetadata[1]._type = "string";
-        _classMetadata[1].description = "symbol of the class";
-        _classes[1]._values[0].stringValue = "DBIT Fix test Instantaneous";
-
         // define "period of the class";
         _classMetadata[5].title = "period";
         _classMetadata[5]._type = "int";
-        _classMetadata[5].description = "details about issuance and redemption time";
+        _classMetadata[5].description = "value (in months) about maturity time";
+
+
+
+
+        // describing the symbol of the different class
+        _classes[0]._values[0].stringValue = "DBIT Fix 6M";
+        _classes[1]._values[0].stringValue = "DBIT Fix test Instantaneous";
+
         
         // define the maturity time period (for the test class).
         _classes[0]._values[5].uintValue = 10;
@@ -74,15 +76,16 @@ contract ERC3475 is IERC3475 {
         _classes[1].nonces[1]._values[0].uintValue = block.timestamp + 2;
         _classes[1].nonces[2]._values[0].uintValue = block.timestamp + 3;
 
-        // define "maturity of the nonce";
+        // define metadata explaining "maturity of the nonce";
         _classes[0]._nonceMetadata[0].title = "maturity";
         _classes[0]._nonceMetadata[0]._type = "int";
         _classes[0]._nonceMetadata[0].description = "maturity date in integer";
+        
         _classes[1]._nonceMetadata[0].title = "maturity";
-        _classes[0]._nonceMetadata[0]._type = "int";
+        _classes[1]._nonceMetadata[0]._type = "int";
         _classes[1]._nonceMetadata[0].description = "maturity date in integer";
 
-        // defining the value status 
+        // initializing all of the nonces for issued bonds
         _classes[0].nonces[0]._values[0].boolValue = true;
         _classes[0].nonces[1]._values[0].boolValue = true;
         _classes[0].nonces[2]._values[0].boolValue = true;
diff --git a/assets/eip-3475/interfaces/IERC3475.sol b/assets/eip-3475/interfaces/IERC3475.sol
index 9dc5a45e06deb4..9fa2b1b44c2c5e 100644
--- a/assets/eip-3475/interfaces/IERC3475.sol
+++ b/assets/eip-3475/interfaces/IERC3475.sol
@@ -180,22 +180,39 @@ interface IERC3475 {
     // EVENTS
     /**
      * @notice MUST trigger when tokens are transferred, including zero value transfers.
+     * e.g: 
+     emit Transfer(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef, 0x492Af743654549b12b1B807a9E0e8F397E44236E,0x3d03B6C79B75eE7aB35298878D05fe36DC1fEf, [IERC3475.Transaction(1,14,500)])
+    means that operator 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef wants to transfer 500 bonds of class 1 , Nonce 14 of owner 0x492Af743654549b12b1B807a9E0e8F397E44236E to address  0x3d03B6C79B75eE7aB35298878D05fe36DC1fEf.
      */
     event Transfer(address indexed _operator, address indexed _from, address indexed _to, Transaction[] _transactions);
     /**
      * @notice MUST trigger when tokens are issued
+     * @notice Issue MUST trigger when Bonds are issued. This SHOULD not include zero value Issuing.
+    * @dev This SHOULD not include zero value issuing.
+    * @dev Issue MUST be triggered when the operator (i.e Bank address) contract issues bonds to the given entity.
+    eg: emit Issue(_operator, 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,[IERC3475.Transaction(1,14,500)]); 
+    issue by address(operator) 500 Bonds(nonce14,class 0) to address 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef.
      */
     event Issue(address indexed _operator, address indexed _to, Transaction[] _transactions);
     /**
-     * @notice MUST trigger when tokens are redeemed
+     * @notice MUST trigger when tokens are redeemed.
+     * @notice Redeem MUST trigger when Bonds are redeemed. This SHOULD not include zero value redemption.
+     * eg: emit Redeem(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,0x492Af743654549b12b1B807a9E0e8F397E44236E,[IERC3475.Transaction(1,14,500)]);
+     * this emit event when 5000 bonds of class 1, nonce 14 owned by address 0x492Af743654549b12b1B807a9E0e8F397E44236E are being redeemed by 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef.
      */
     event Redeem(address indexed _operator, address indexed _from, Transaction[] _transactions);
     /**
      * @notice MUST trigger when tokens are burned
+     * @dev `Burn` MUST trigger when the bonds are being redeemed via staking (or being invalidated) by the bank contract.
+     * @dev `Burn` MUST trigger when Bonds are burned. This SHOULD not include zero value burning
+     * @notice emit Burn(0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef,0x492Af743654549b12b1B807a9E0e8F397E44236E,[IERC3475.Transaction(1,14,500)]);
+     * emits event when 5000 bonds of owner 0x492Af743654549b12b1B807a9E0e8F397E44236E of type (class 1, nonce 14) are burned by operator 0x2d03B6C79B75eE7aB35298878D05fe36DC1fE8Ef.
      */
     event Burn(address indexed _operator, address indexed _from, Transaction[] _transactions);
     /**
      * @dev MUST emit when approval for a second party/operator address to manage all bonds from a classId given for an owner address is enabled or disabled (absence of an event assumes disabled).
+     * @dev its emitted when address(_owner) approves the address(_operator) to transfer his bonds.
+     * @notice Approval MUST trigger when bond holders are approving an _operator. This SHOULD not include zero value approval. 
      */
     event ApprovalFor(address indexed _owner, address indexed _operator, bool _approved);
 }

From 66e3399fd708a4d2438cf800fdb05c57ab6c6674 Mon Sep 17 00:00:00 2001
From: Suning Yao <sy2940@nyu.edu>
Date: Tue, 24 Jan 2023 09:30:53 -0500
Subject: [PATCH 198/274] Update EIP-6150: Move to Last Call (#6311)

---
 EIPS/eip-6150.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-6150.md b/EIPS/eip-6150.md
index 952a36f92c6754..f88da482e745ac 100644
--- a/EIPS/eip-6150.md
+++ b/EIPS/eip-6150.md
@@ -4,7 +4,8 @@ title: Hierarchical NFTs
 description: Hierarchical NFTs, an extension to EIP-721.
 author: Keegan Lee (@keeganlee), msfew <msfew@hyperoracle.io>, Kartin <kartin@hyperoracle.io>, qizhou (@qizhou)
 discussions-to: https://ethereum-magicians.org/t/eip-6150-hierarchical-nfts-an-extension-to-erc-721/12173
-status: Review
+status: Last Call
+last-call-deadline: 2023-01-25
 type: Standards Track
 category: ERC
 created: 2022-12-15

From f26568d954d666af60930563d8469855b62a3f28 Mon Sep 17 00:00:00 2001
From: Hadrien Croubois <hadrien.croubois@gmail.com>
Date: Wed, 25 Jan 2023 15:17:39 +0100
Subject: [PATCH 199/274] Add EIP-6372: Contract clock (#6372)

* add new contract clock EIP

* numbring

* add discussion link

* spelling

* add missing section
---
 EIPS/eip-6372.md | 92 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 EIPS/eip-6372.md

diff --git a/EIPS/eip-6372.md b/EIPS/eip-6372.md
new file mode 100644
index 00000000000000..45fc0c266d4a02
--- /dev/null
+++ b/EIPS/eip-6372.md
@@ -0,0 +1,92 @@
+---
+eip: 6372
+title: Contract clock
+description: An interface for exposing a contract's clock value and details
+author: Hadrien Croubois (@Amxx), Francisco Giordano (@frangio)
+discussions-to: https://ethereum-magicians.org/t/eip-6372-contract-clock/12689
+status: Draft
+type: Standards Track
+category: ERC
+created: 2023-01-25
+---
+
+## Abstract
+
+Many contracts rely on some clock for enforcing delays and storing historical data. While contracts rely on block numbers, others use timestamps. There is currently no easy way to discover which time-tracking function a contract internally uses. This EIP proposes to standardize an interface for contracts to expose their internal clock and thus improve composability.
+
+## Motivation
+
+Many contracts check or store time-related information. For example, timelock contracts enforce a delay before an operation can be executed. Similarly, DAOs enforce a voting period during which stakeholders can approve or reject a proposal. Last but not least, voting tokens often store the history of voting power using timed snapshots.
+
+Some contracts do time tracking using timestamps while others use block numbers. In some cases, more exotic functions might be used to track time.
+
+There is currently no interface for an external observer to detect which clock a contract uses. This seriously limits interoperability and forces devs to make assumptions.
+
+## Specification
+
+### Methods
+
+#### clock
+
+This function returns the current timepoint. It could be `block.timestamp`, `block.number` (or any other **non-decreasing** function) depending on the mode the contract is operating on.
+
+```yaml
+- name: clock
+  type: function
+  stateMutability: view
+  inputs: []
+  outputs:
+    - name: timepoint
+      type: uint48
+```
+
+### CLOCK_MODE
+
+This function returns a string describing the clock the contract is operating on.
+
+- If operating using **block number**:
+  - If the block numbers are those of the `NUMBER` opcode (`0x43`), then this function SHOULD return `mode=blocknumber&from=default`.
+  - If it is any other block number, then this function SHOULD return `mode=blocknumber&from=<CAIP2ID>`, where `<CAIP2ID>` is a CAIP-2 Blockchain ID such as `eip155:1`.
+- If operating using **timestamp**, then this function SHOULD return `mode=timestamp`.
+- If operating using any other mode, then this function SHOULD return a unique identifier for the encoded `mode` field.
+
+Note that when operating using **block number**, the `clock()` is expected to return the value given by the `NUMBER` opcode (`0x43`). In some cases, this can be the block number of another chain (in arbitrum, opcode `0x43` returns the block number of the last recorded operation on the parent chain). A contract can use `from=default` to specify that the block number used is the one provided by the `NUMBER` opcode (`0x43`). If a more explicit description is needed, CAIP-2 blockchain id should be used to identify the corresponding blockchain.
+
+The return string MUST be formatted like a URL query string (a.k.a. `application/x-www-form-urlencoded`). This allows easy decoding in standard JavaScript with `new URLSearchParams(CLOCK_MODE)`.
+
+```yaml
+- name: CLOCK_MODE
+  type: function
+  stateMutability: view
+  inputs: []
+  outputs:
+    - name: descriptor
+      type: string
+```
+
+### Solidity interface
+
+```sol
+interface IERC6372 {
+  function clock() external view returns (uint48);
+  function CLOCK_MODE() external view returns (string);
+}
+```
+
+### Expected properties
+
+- The `clock()` function MUST be non-decreasing.
+
+## Rationale
+
+`clock` returns `uint48` as it is largely sufficient for storing realistic values. In timestamp mode, `uint48` will be enough until the year 8921556. Even in block number mode, with 10,000 blocks per second, it would be enough until the year 2861. Using a type smaller than uint256 allows some storage packing of timepoints with other associated values. Greatly reducing the cost of writing and reading from storage.
+
+Depending on the evolution of the blockchain (particularly layer twos), using a smaller type, such as `uint32` might cause issues fairly quickly. On the other hand, anything bigger than `uint48` is overkill.
+
+## Security Considerations
+
+No known security issues.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 8bb8117251c3b3477b3c470d6b7a0035b5ca487b Mon Sep 17 00:00:00 2001
From: Sally MacFarlane <macfarla.github@gmail.com>
Date: Thu, 26 Jan 2023 01:08:23 +1000
Subject: [PATCH 200/274] Update EIP-1898: Move to Review (#6309)

* removed dependency on 1474, added safe/finalized string options

Signed-off-by: Sally MacFarlane <macfarla.github@gmail.com>

* changed status to review

Signed-off-by: Sally MacFarlane <macfarla.github@gmail.com>

Signed-off-by: Sally MacFarlane <macfarla.github@gmail.com>
---
 EIPS/eip-1898.md | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-1898.md b/EIPS/eip-1898.md
index d4bb6eed02dd36..0bb8bc4d7c5ae6 100644
--- a/EIPS/eip-1898.md
+++ b/EIPS/eip-1898.md
@@ -4,11 +4,11 @@ title: Add `blockHash` to defaultBlock methods
 description: Add `blockHash` option to JSON-RPC methods that currently support defaultBlock parameter.
 author: Charles Cooper (@charles-cooper)
 discussions-to: https://ethereum-magicians.org/t/eip-1898-add-blockhash-option-to-json-rpc-methods-that-currently-support-defaultblock-parameter/11757
-status: Draft
+status: Review
 type: Standards Track
 category: Interface
 created: 2019-04-01
-requires: 234, 1474
+requires: 234
 ---
 
 ## Abstract
@@ -32,8 +32,10 @@ The following options, quoted from the Ethereum JSON-RPC spec, are currently pos
 
 > - HEX String - an integer block number
 > - String "earliest" for the earliest/genesis block
-> - String "latest" - for the latest mined block
+> - String "latest" - for the latest canonical block
 > - String "pending" - for the pending state/transactions
+> - String "safe" - for the most recent safe block
+> - String "finalized" - for the most recent finalized block
 
 Since there is no way to clearly distinguish between a DATA parameter and a QUANTITY parameter, this EIP proposes a new scheme for the block parameter. The following option is additionally allowed:
 

From a72a2ca96d5786c0cf94ad69f0097c7c3e5ea678 Mon Sep 17 00:00:00 2001
From: Ignacio Mazzara <nachomazzara@gmail.com>
Date: Wed, 25 Jan 2023 16:10:39 +0100
Subject: [PATCH 201/274] Update EIP-4955: Move to Last Call (#6329)

* feat: add eip 4899

* feat: move EIP to last call

* feat: wrong file

* fix: images and deadline
---
 EIPS/eip-4955.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/EIPS/eip-4955.md b/EIPS/eip-4955.md
index 87e045447fa20c..f9be560bf80908 100644
--- a/EIPS/eip-4955.md
+++ b/EIPS/eip-4955.md
@@ -4,7 +4,8 @@ title: Vendor Metadata Extension for NFTs
 description: Add a new field to NFT metadata to store vendor specific data
 author: Ignacio Mazzara (@nachomazzara)
 discussions-to: https://ethereum-magicians.org/t/eip-4955-non-fungible-token-metadata-namespaces-extension/8746
-status: Review
+status: Last Call
+last-call-deadline: 2023-02-01
 type: Standards Track
 category: ERC
 created: 2022-03-29
@@ -98,8 +99,7 @@ The main differences between the projects that are rendering 3d NFTs (models) ar
 
 Every metaverse uses its own armature. There is a standard for humanoids but it is not being used for every metaverse and not all the metaverses use humanoids. For example, Decentraland has a different aesthetic than Cryptovoxels and TheSandbox. It means that every metaverse will need a different model and they may have the same extension (GLB, GLTF)
 
-<img src="../assets/eip-4955/different-renders.jpeg" alt="EIP 4955 Different Renders" />
-
+![](../assets/eip-4955/different-renders.jpeg)
 
 ### Metadata (Representations Files)
 

From 87f5d840004e3e65bd08e50423f764b4bd0f10b1 Mon Sep 17 00:00:00 2001
From: Benjamin Evans Chodroff
 <4411206+benjaminchodroff@users.noreply.github.com>
Date: Thu, 26 Jan 2023 00:11:10 +0900
Subject: [PATCH 202/274] Update EIP-4736: Move to Draft (#6304)

* Updated to Set Withdrawal Address and ethdo format

* ethdo spec format

* Remove Acceptance in favor of simplified broadcast file

* Removing github external link

* Markdown Linter fixes

* Lint Unordered list style and code blocks
---
 EIPS/eip-4736.md | 190 +++++++++++++++++++++--------------------------
 1 file changed, 86 insertions(+), 104 deletions(-)

diff --git a/EIPS/eip-4736.md b/EIPS/eip-4736.md
index 4375d8d9b4cb74..4fbb85965586a0 100644
--- a/EIPS/eip-4736.md
+++ b/EIPS/eip-4736.md
@@ -1,186 +1,167 @@
 ---
 eip: 4736
 title: Consensus Layer Withdrawal Protection
-description: Additional security for "change withdrawal address" operation when a consensus layer mnemonic may be compromised, without changing consensus
+description: Additional security for "set withdrawal address" operation when a consensus layer mnemonic may be compromised, without changing consensus
 author: Benjamin Chodroff (@benjaminchodroff), Jim McDonald (@mcdee)
 discussions-to: https://ethereum-magicians.org/t/consensus-layer-withdrawal-protection/8161
-status: Stagnant
+status: Draft
 type: Standards Track
 category: Interface
 created: 2022-01-30
 ---
 
 ## Abstract
+
 If a consensus layer mnemonic phrase is compromised, it is impossible for the consensus layer network to differentiate the "legitimate" holder of the key from an "illegitimate" holder. However, there are signals that can be considered in a wider sense without changing core Ethereum consensus. This proposal outlines ways in which the execution layer deposit address, a consensus layer rebroadcast delay, and list of signed messages could create a social consensus that would significantly favor but not guarantee legitimate mnemonic holders would win a race condition against an attacker, while not changing core Ethereum consensus. 
 
 ## Motivation
-The consensus layer change withdrawal credentials proposal is secure for a single user who has certainty their keys and mnemonic have not been compromised. However, as validator withdrawals on the consensus layer are not yet possible, no user can have absolute certainty that their keys are not compromised until the change withdrawal address is on chain, and by then too late to change. All legitimate mnemonic phrase holders were originally in control of the execution layer deposit address. Beacon node clients and node operators may optionally load a list of verifiable deposit addresses, a list of verifiable change withdrawal address messages to broadcasts, and specify a rebroadcast delay that may create a social consensus for legitimate holders to successfully win a race condition against an attacker. If attackers compromise a significant number of consensus layer nodes, it would pose risks to the entire Ethereum community.
 
-Setting a withdrawal address to an execution layer address was not supported by the eth2.0-deposit-cli until v1.1.1 on March 23, 2021, leaving early adopters wishing they could force change their execution layer address earlier. Forcing this change is not something that can be enforced in-protocol, partly due to lack of information on the beacon chain about the execution layer deposit address and partly due to the fact that this was never listed as a requirement. It is also possible that the execution layer deposit address is no longer under the control of the legitimate holder of the withdrawal private key. 
+The consensus layer set withdrawal address proposal is secure for a single user who has certainty their keys and mnemonic have not been compromised. However, as validator withdrawals on the consensus layer are not yet possible, no user can have absolute certainty that their keys are not compromised until the set withdrawal address is on chain, and by then too late to change. All legitimate mnemonic phrase holders were originally in control of the execution layer deposit address. Beacon node clients and node operators may optionally load a list of verifiable deposit addresses, a list of verifiable set withdrawal address messages to broadcasts, and specify a rebroadcast delay that may create a social consensus for legitimate holders to successfully win a race condition against an attacker. If attackers compromise a significant number of consensus layer nodes, it would pose risks to the entire Ethereum community.
+
+Setting a withdrawal address to an execution layer address was not supported by the eth2.0-deposit-cli until v1.1.1 on March 23, 2021, leaving early adopters wishing they could force set their execution layer address earlier. Forcing this change is not something that can be enforced in-protocol, partly due to lack of information on the beacon chain about the execution layer deposit address and partly due to the fact that this was never listed as a requirement. It is also possible that the execution layer deposit address is no longer under the control of the legitimate holder of the withdrawal private key. 
 
-However, it is possible for individual nodes to locally restrict the changes they wish to include in blocks they propose, and which they propagate around the network, in a way that does not change consensus. It is also possible for client nodes to help broadcast signed change withdrawal address requests to ensure as many nodes witness this change as soon as possible in a fair manner. Further, such change withdrawal address signed messages can be preloaded into clients in advance to further help nodes filter attacking requests.
+However, it is possible for individual nodes to locally restrict the changes they wish to include in blocks they propose, and which they propagate around the network, in a way that does not change consensus. It is also possible for client nodes to help broadcast signed set withdrawal address requests to ensure as many nodes witness this message as soon as possible in a fair manner. Further, such set withdrawal address signed messages can be preloaded into clients in advance to further help nodes filter attacking requests.
 	
-This proposal provides purely optional additional protection. It aims to request nodes set a priority on withdrawal credential claims that favour a verifiable execution layer deposit address in the event of two conflicting change withdrawal credentials. It also establishes a list of change withdrawal address signed messages to help broadcast "as soon as possible" when the network supports it, and encourage client teams to help use these lists to honour filter and prioritize accepting requests by REST and transmitting them via P2P. This will not change consensus, but may help prevent propagating an attack where a withdrawal key has been knowingly or unknowingly compromised. 
+This proposal provides purely optional additional protection. It aims to request nodes set a priority on withdrawal credential claims that favour a verifiable execution layer deposit address in the event of two conflicting set withdrawal credentials. It also establishes a list of set withdrawal address signed messages to help broadcast "as soon as possible" when the network supports it, and encourage client teams to help use these lists to honour filter and prioritize accepting requests by REST and transmitting them via P2P. This will not change consensus, but may help prevent propagating an attack where a withdrawal key has been knowingly or unknowingly compromised. 
 	
-It is critical to understand that this proposal is not a consensus change. Nothing in this proposal restricts the validity of withdrawal credential change operations within the protocol. It is a voluntary change by client teams to build this functionality in to their beacon nodes, and a voluntary change by node operators to accept any or all of the restrictions and broadcasting capabilities suggested by end users.
+It is critical to understand that this proposal is not a consensus change. Nothing in this proposal restricts the validity of withdrawal credential operations within the protocol. It is a voluntary change by client teams to build this functionality in to their beacon nodes, and a voluntary change by node operators to accept any or all of the restrictions and broadcasting capabilities suggested by end users.
 
 Because of the above, even if fully implemented, it will be down to chance as to which validators propose blocks, and which voluntary restrictions those validators’ beacon nodes are running. Node operators can do what they will to help the community prevent attacks on any compromised consensus layer keys, but there are no guarantees of success this will prevent a successful attack. 
 
 ## Specification
-The Consensus Layer change withdrawal credentials operation is not yet fully specified, but MUST have at least the following fields:
+
+The Consensus Layer set withdrawal credentials operation MUST have at least the following fields:
+
 * Validator index
-* Current withdrawal public key
+* Current withdrawal BLS public key
 * Proposed execution layer withdrawal address
 * Signature by withdrawal private key over the prior fields
 	
 This proposal describes three OPTIONAL and RECOMMENDED mechanisms which a client beacon node MAY implement, and end users are RECOMMENDED to use in their beacon node operation.
 
-### 1. Change Withdrawal Address Acceptance File
-Beacon node clients MAY support an OPTIONAL file in the format "withdrawal credentials, execution layer address" which, if implemented and if provided, SHALL allow clients to load, or RECOMMENDED packaged by default, a verifiable list matching the consensus layer withdrawal credentials and the original execution layer deposit address. While any withdrawal credential and execution layer address found in the file SHALL be supported, this list MAY be used to help enforce a deposit address is given preference in rebroadcasting, even if other clients do not support or have not loaded an OPTIONAL "Change Withdrawal Address Broadcast" file. 
+### 1. Set Withdrawal Address Broadcast File
 
-### 2. Change Withdrawal Address Broadcast File
-Beacon node clients MAY support an OPTIONAL file of lines specifying "validator index,current withdrawal public key,proposed execution layer withdrawal address,consensus layer signature" which, if implemented and if provided, SHALL instruct nodes to automatically submit a one-time change withdrawal address broadcast message for each valid line at the block height the network supports a "change withdrawal address" operation. This file SHALL give all node operators an OPTIONAL opportunity to ensure any valid change withdrawal address messages are broadcast, heard, and shared by nodes during the first epoch supporting the change withdrawal address operation. This OPTIONAL file SHALL also instruct nodes to perpetually prefer accepting and repeating signatures matching the signature in the file, and SHALL reject accepting or rebroadcasting messages which do not match a signature for a given withdrawal credential. 
+Beacon node clients MAY support an OPTIONAL file of lines specifying "validator index" , "current withdrawal BLS public key" , "proposed execution layer withdrawal address", and "signature" which, if implemented and if provided, SHALL instruct nodes to automatically submit a one-time set withdrawal address broadcast message for each valid signature at the block height the network supports a "set withdrawal address" operation. This file SHALL give all node operators an OPTIONAL opportunity to ensure any valid set withdrawal address messages are broadcast, heard, and shared by nodes during the first epoch supporting the set withdrawal address operation. This OPTIONAL file SHALL also instruct nodes to perpetually prefer accepting and repeating signatures matching the signature in the file, and SHALL reject accepting or rebroadcasting messages which do not match a signature for a given withdrawal credential. 
 	
-### 3. Change Withdrawal Address Rebroadcast Delay
-Beacon node clients MAY implement an OPTIONAL time measurement parameter "change withdrawal address rebroadcast delay" that, if implemented and if provided, SHALL create a delay in rebroadcasting change withdrawal addresses (RECOMMENDED to default to 2000 seconds (>5 epochs), or OPTIONAL set to 0 seconds for no delay, or MAY set to -1 to strictly only rebroadcast requests matching a "Change Withdrawal Address Broadcast File" signature or "Change Withdrawal Address Acceptance File" entry). This setting SHALL allow change withdrawal address requests time for peer replication of client accepted valid requests that are preferred by the community. This MAY prevent a "first to arrive" critical race condition for a conflicting change withdraw address.
+### 2. Set Withdrawal Address Rebroadcast Delay
+
+Beacon node clients MAY implement an OPTIONAL time measurement parameter "set withdrawal address rebroadcast delay" that, if implemented and if provided, SHALL create a delay in rebroadcasting set withdrawal addresses (RECOMMENDED to default to 2000 seconds (>5 epochs), or OPTIONAL set to 0 seconds for no delay, or MAY set to -1 to strictly only rebroadcast requests matching a "Set Withdrawal Address Broadcast" entry). This setting SHALL allow set withdrawal address requests time for peer replication of client accepted valid requests that are preferred by the community. This MAY prevent a "first to arrive" critical race condition for a conflicting set withdraw address.
 
-### Change Withdrawal Address Handling
-Beacon node clients are RECOMMENDED to first rely on a "Change Withdrawal Address Broadcast" file of verifiable signatures, then MAY fallback to a "Change Withdrawal Address Acceptance" file intended to be loaded with all validator original deposit address information, and then MAY fallback to accept a "first request" but delay in rebroadcasting it via P2P. All of this proposal is OPTIONAL for beacon nodes to implement or use, but all client teams are RECOMMENDED to include a copy or link to the uncontested verification file and RECOMMENDED enable it by default to protect the entire Ethereum community. This OPTIONAL protection will prove the user was both in control of the consensus layer and execution layer address, while making sure their intended change withdrawal address message is ready to broadcast as soon as the network supports it. 
+### Set Withdrawal Address Handling
 
-If a node is presented with a change withdrawal address operation via the REST API or P2P, they are RECOMMENDED to follow this process:
+Beacon node clients are RECOMMENDED to first rely on a "Set Withdrawal Address Broadcast" file of verifiable signatures, and then MAY fallback to accept a "first request" but delay in rebroadcasting it via P2P. All of this proposal is OPTIONAL for beacon nodes to implement or use, but all client teams are RECOMMENDED to include a copy or link to the uncontested verification file and RECOMMENDED enable it by default to protect the entire Ethereum community. This OPTIONAL protection will prove the user was both in control of the consensus layer and execution layer address, while making sure their intended set withdrawal address message is ready to broadcast as soon as the network supports it. 
 
-A) Withdrawal credential found in "Change Withdrawal Address Broadcast" file:
-  1. Signature Match: If a valid change withdrawal request signature is received for a withdrawal credential that matches the first signature found in the "Change Withdrawal Address Broadcast" file, accept it via REST API, rebroadcast it via P2P, and drop any pending “first preferred” if existing. 
-  2. Signature Mismatch: If a valid change withdrawal request is received for a withdrawal credential that does not match the first signature found in the "Change Withdrawal Address Broadcast" file, reject it via REST API, and drop it to prevent rebroadcasting it via P2P.
+If a node is presented with a set withdrawal address operation via the REST API or P2P, they are RECOMMENDED to follow this process:
 
-B) Withdrawal credential not found in or no "Change Withdrawal Address Broadcast" file provided, or capability not implemented in the client:
-1. Matching withdraw credential and withdraw address in "Change Withdrawal Address Acceptance" file: If a valid change withdrawal address request is received for a withdrawal credential that matches the first found withdrawal address provided in the "Change Withdrawal Address Acceptance" file, accept it via REST API, rebroadcast it via P2P, and drop any pending “first preferred” if existing. 
-2. Mismatching withdraw credential and withdraw address in "Change Withdrawal Address Acceptance" file: If a valid change withdrawal request is received for a withdrawal credential that does not match the first found withdrawal address provided in the "withdrawal address" file, reject it via REST API, and drop it to prevent rebroadcasting it via P2P.
-3. Missing withdraw address in or no "Change Withdrawal Address Acceptance" file: 
+A) Withdrawal credential found in "Set Withdrawal Address Broadcast" file:
 
-    i. First Preferred: If first valid change withdrawal request is received for a not finalized withdrawal credential that does not have any listed withdrawal credential entry in the "Change Withdrawal Address Acceptance" file, accept it via REST API, but do not yet rebroadcast it via P2P (“grace period”) and do not yet propose any local blocks with this message. Once the client “Change Withdrawal Address Grace Period” has expired and no other messages have invalidated this message, rebroadcast the request via P2P and include in locally built blocks if not already present. 
+  1. Signature Match: If a valid set withdrawal request signature is received for a withdrawal credential that matches the first signature found in the "Set Withdrawal Address Broadcast" file, accept it via REST API, rebroadcast it via P2P, and drop any pending “first preferred” if existing. 
+  2. Signature Mismatch: If a valid set withdrawal request is received for a withdrawal credential that does not match the first signature found in the "Set Withdrawal Address Broadcast" file, reject it via REST API, and drop it to prevent rebroadcasting it via P2P.
+
+B) Withdrawal credential not found in or no "Set Withdrawal Address Broadcast" file provided, or capability not implemented in the client:
+
+1. Matching withdraw credential and withdraw address in "Set Withdrawal Address Broadcast" file: If a valid set withdrawal address request is received for a withdrawal credential that matches the first found withdrawal address provided in the "Set Withdrawal Address Broadcast" file, accept it via REST API, rebroadcast it via P2P, and drop any pending “first preferred” if existing. 
+2. Mismatching withdraw credential and withdraw address in "Set Withdrawal Address Broadcast" file: If a valid set withdrawal request is received for a withdrawal credential that does not match the first found withdrawal address provided in the "withdrawal address" file, reject it via REST API, and drop it to prevent rebroadcasting it via P2P.
+3. Missing withdraw address in or no "Set Withdrawal Address Broadcast" file: 
+
+    i. First Preferred: If first valid set withdrawal address request is received for a not finalized withdrawal credential that does not have any listed withdrawal credential entry in the "Set Withdrawal Address Broadcast" file, accept it via REST API, but do not yet rebroadcast it via P2P (“grace period”) and do not yet propose any local blocks with this message. Once the client “Set Withdrawal Address Grace Period” has expired and no other messages have invalidated this message, rebroadcast the request via P2P and include in locally built blocks if not already present. 
   
     ii. Subsequent Rejected: If an existing valid "First Preferred" request exists for a not finalized withdrawal credential, reject it via REST API, and drop it to prevent rebroadcasting via P2P. 
 
-Note that these restrictions SHALL NOT apply to withdrawal credential change operations found in blocks. If any operation has been included on-chain, it MUST by definition be valid regardless of its contents or protective mechanisms described above. 
+Note that these restrictions SHALL NOT apply to set withdrawal credential operations found in blocks. If any operation has been included on-chain, it MUST by definition be valid regardless of its contents or protective mechanisms described above. 
 
 ## Rationale
-This proposal is intended to protect legitimate mnemonic phrase holders where the phrase was knowingly or unknowingly compromised. As there is no safe way to transfer ownership of a validator without exiting, it can safely be assumed that all current validator holders intend to change to a withdrawal address they specify. Using the deposit address in the execution layer to determine the legitimate holder is not possible to consider in consensus as it may be far back in history and place an overwhelming burden to maintain such a list. As such, this proposal outlines optional mechanism which protect legitimate original mnemonic holders and does so in a way that does not place any mandatory burden on client node software or operators. 
+
+This proposal is intended to protect legitimate mnemonic phrase holders where the phrase was knowingly or unknowingly compromised. As there is no safe way to transfer ownership of a validator without exiting, it can safely be assumed that all current validator holders intend to set to a withdrawal address they specify. Using the deposit address in the execution layer to determine the legitimate holder is not possible to consider in consensus as it may be far back in history and place an overwhelming burden to maintain such a list. As such, this proposal outlines optional mechanism which protect legitimate original mnemonic holders and does so in a way that does not place any mandatory burden on client node software or operators. 
 
 ## Backwards Compatibility
-As there is currently no existing "change withdrawal address" operation in existence, there is no documented backwards compatibility. As all of the proposal is OPTIONAL in both implementation and operation, it is expected that client beacon nodes that do not implement this functionality would still remain fully backwards compatible with any or all clients that do implement part or all of the functionality described in this proposal. Additionally, while users are RECOMMENDED to enable these OPTIONAL features, if they decide to either disable or ignore some or all of the features, or even purposefully load content contrary to the intended purpose, the beacon node client will continue to execute fully compatible with the rest of the network as none of the proposal will change core Ethereum consensus. 
+
+As there is currently no existing "set withdrawal address" operation, there is no documented backwards compatibility. As all of the proposal is OPTIONAL in both implementation and operation, it is expected that client beacon nodes that do not implement this functionality would still remain fully backwards compatible with any or all clients that do implement part or all of the functionality described in this proposal. Additionally, while users are RECOMMENDED to enable these OPTIONAL features, if they decide to either disable or ignore some or all of the features, or even purposefully load content contrary to the intended purpose, the beacon node client will continue to execute fully compatible with the rest of the network as none of the proposal will change core Ethereum consensus. 
 
 ## Reference Implementation
-### Change Withdrawal Address Acceptance File
-A file intended to be preloaded with all consensus layer withdrawal credentials and verifiable execution layer deposit addresses. This file will be generated by a script and able to be independently verified by community members using the consensus and execution layers, and intended to be included by all clients, enabled by default. Client nodes are encouraged to enable packaging this independently verifiable list with the client software, and enable it by default to help further protect the community from unsuspected attacks. 
 
-depositAddress.csv format (both fields required):
-`withdrawal credential, withdrawal address`
+### Set Withdrawal Address Broadcast File
 
-Example depositAddress.csv:
-```
-000092c20062cee70389f1cb4fa566a2be5e2319ff43965db26dbaa3ce90b9df99,01c34eb7e3f34e54646d7cd140bb7c20a466b3e852
-0000d66cf353931500a54cbd0bc59cbaac6690cb0932f42dc8afeddc88feeaad6f,01c34eb7e3f34e54646d7cd140bb7c20a466b3e852
-0000d6b91fbbce0146739afb0f541d6c21e8c41e92b97874828f402597bf530ce4,01c34eb7e3f34e54646d7cd140bb7c20a466b3e852
-000037ca9a1cf2223d8b9f81a14d4937fef94890ae4fcdfbba928a4dc2ff7fcf3b,01c34eb7e3f34e54646d7cd140bb7c20a466b3e852
-0000344b6c73f71b11c56aba0d01b7d8ad83559f209d0a4101a515f6ad54c89771,01f19b1c91faacf8071bd4bb5ab99db0193809068e
-```
+A "change-operations.json" file intended to be preloaded with all consensus layer withdrawal credential signatures and verifiable execution layer deposit addresses. This file may be generated by a script and able to be independently verified by community members using the consensus layer node, and intended to be included by all clients, enabled by default. Client nodes are encouraged to enable packaging this independently verifiable list with the client software, and enable it by default to help further protect the community from unsuspected attacks. 
+
+The change-operations.json format is the "Set Withdrawal Address File - Claim" combined into a single JSON array.
 
-### Change Withdrawal Address Broadcast File - Claim
-A community collected and independently verifiable list of "Change Withdrawal Address Broadcasts" containing verifiable claims will be collected. Client teams and node operators may verify these claims independently and are suggested to include "Uncontested and Verified" claims enabled by default in their package. 
+### Set Withdrawal Address Broadcast File - Claim
 
-To make a verifiable claim, users must upload using their GitHub ID with the following contents to the [CLWP repository](https://github.com/benjaminchodroff/ConsensusLayerWithdrawalProtection) in a text file "claims/validatorIndex-gitHubUser.txt" such as "123456-myGitHubID.txt"
+A community collected and independently verifiable list of "Set Withdrawal Address Broadcasts" containing verifiable claims will be collected. Client teams and node operators may verify these claims independently and are suggested to include "Uncontested and Verified" claims enabled by default in their package. 
+
+To make a verifiable claim, users MAY upload using their GitHub ID with the following contents to the CLWP repository in a text file "[chain]/validatorIndex.json" such as "mainnet/123456.json" or MAY construct a repository of their own.
+
+123456.json:
 
-123456-myGitHubID.txt:
 ```
-current_withdrawal_public_key=b03c5ea17b017cffd22b6031575c4453f20a4737393de16a626fb0a8b0655fe66472765720abed97e8022680204d3868
-proposed_withdrawal_address=0108f2e9Ce74d5e787428d261E01b437dC579a5164
-consensus_layer_withdrawal_signature=
-execution_layer_deposit_signature=
-execution_layer_withdrawal_signature=
-email=noreply@ethereum.org
+[{"message":{"validator_index":"123456","from_bls_pubkey":"0x977cc21a067003e848eb3924bcf41bd0e820fbbce026a0ff8e9c3b6b92f1fea968ca2e73b55b3908507b4df89eae6bfb","to_execution_address":"0x08f2e9Ce74d5e787428d261E01b437dC579a5164"},"signature":"0x872935e0724b31b2f0209ac408b673e6fe2f35b640971eb2e3b429a8d46be007c005431ef46e9eb11a3937f920cafe610c797820ca088543c6baa0b33797f0a38f6db3ac68ffc4fd03290e35ffa085f0bfd56b571d7b2f13c03f7b6ce141c283"}]
 ```
 
-| Key | Value | 
-| ----| ------|
-| **current_withdrawal_public_key** | (Required) The "pubkey" field found in deposit_data json file matching the validator index| Required | Necessary for verification |
-| **proposed_withdrawal_address** | (Required) The address in Ethereum you wish to authorize withdrawals to, prefaced by "01" without any "0x", such that an address "0x08f2e9Ce74d5e787428d261E01b437dC579a5164" turns into "0108f2e9Ce74d5e787428d261E01b437dC579a5164 |
-| **consensus_layer_withdrawal_signature** | (Required) The verifiable signature generated by signing "validator_index,current_withdrawal_public_key,proposed_withdrawal_address" using the consensus layer private key | 
-| execution_layer_deposit_signature | (Optional) The verifiable signature generated by signing "validator_index,current_withdrawal_public_key,proposed_withdrawal_address" using the execution layer deposit address private key | 
-| execution_layer_withdrawal_signature | (Optional) The verifiable signature generated by signing "validator_index,current_withdrawal_public_key,proposed_withdrawal_address" using the execution layer proposed withdrawal address private key. This may be the same result as the "execution_layer_deposit_signature" if the user intends to withdraw to the same execution layer deposit address. |
-| email | (Optional) Any actively monitored email address to notify if contested | 
-
 #### Claim Acceptance
-In order for a submission to be merged into CLWP GitHub repository, the submission must have:
-1. Valid filename in the format validatorIndex-githubUsername.txt
-2. Valid validator index which is deposited, pending, or active on the consensus layer 
-3. Matching GitHub username in file name to the user submitting the request
-4. Verifiable consensus_layer_withdrawal_signature, and a verifiable execution_layer_deposit_signature and execution_layer_withdrawal_signature if included
-5. All required fields in the file with no other content present
 
-All merge requests that fail will be provided a reason from above which must be addressed prior to merge. Any future verifiable amendments to accepted claims must be proposed by the same GitHub user, or it will be treated as a contention.
+In order for a submission to be merged into CLWP GitHub repository, the submission must have:
 
-#### Change Withdrawal Address Broadcast
-Anyone in the community will be able to generate the following verifiable files from the claims provided:
-	A. UncontestedVerified - Community collected list of all verifiable uncontested change withdrawal address final requests (no conflicting withdrawal credentials allowed from different GitHub users)
-	B. ContestedVerified - Community collected list of all contested verifiable change withdrawal address requests (will contain only verifiable but conflicting withdrawal credentials from different GitHub users)
+1. Valid filename in the format validatorIndex.json
+2. Valid validator index which is active on the consensus layer 
+3. Verifiable signature
+5. A single change operation for a single validator, with all required fields in the file with no other content present
 
-A claim will be considered contested if a claim arrives where the verifiable consensus layer signatures differ between two or more GitHub submissions, where neither party has proven ownership of the execution layer deposit address. If a contested but verified "Change Withdrawal Address Broadcast" request arrives to the GitHub community, all parties will be notified via GitHub, forced into the ContestedVerified list, and may try to convince the wider community by providing any off chain evidence supporting their claim to then include their claim in nodes. All node operators are encouraged to load the UncontestedVerified signatures file as enabled, and optionally append only ContestedVerified signatures that they have been convinced are the rightful owner in a manner to further strengthen the community. 
+All merge requests that fail will be provided a reason from above which must be addressed prior to merge. Any future verifiable amendments to accepted claims must be proposed by the same GitHub user, or it will be treated as a contention.
 
-The uncontested lists will be of the format:
+#### Set Withdrawal Address Broadcast
 
-UncontestedVerified-datetime.txt:
-```
-validator_index,current_withdrawal_public_key,proposed_withdrawal_address,consensus_layer_withdrawal_signature
-```
+Anyone in the community will be able to independently verify the files from the claims provided using the Capella spec and command line clients such as "ethdo" which support the specification. 
 
-The contested list will be of the format:
-
-ContestedVerified-datetime.txt
-```
-validator_index,current_withdrawal_public_key,proposed_withdrawal_address,consensus_layer_withdrawal_signature,email
-```
+A claim will be considered contested if a claim arrives where the verifiable consensus layer signatures differ between two or more GitHub submissions, where neither party has proven ownership of the execution layer deposit address. If a contested but verified "Set Withdrawal Address Broadcast" request arrives to the GitHub community, all parties will be notified via GitHub, and may try to convince the wider community by providing any publicly verifiable on chain evidence or off chain evidence supporting their claim to then include their claim in nodes. Node operators may decide which verifiable claims they wish to include based on social consensus. 
 
 ## Security Considerations
 
 ### 1: Attacker lacks EL deposit key, uncontested claim
-- User A: Controls the CL keys and the EL key used for the deposit
-- User B: Controls the CL keys, but does not control the EL key for the deposit
 
-User A signs and submits a claim to the CLWP repository, clients load User A message into the "Change Withdrawal Address Broadcast" file. At the time of the first epoch support Change Withdrawal Address, many (not all) nodes begin to broadcast the message. User B also tries to submit a different but valid Change Withdrawal Address to an address that does not match the signature in the claim. This message is successfully received via REST API, but some (not all) nodes begin to silently drop this message as the signature does not match the signature in the "Change Withdrawal Address Broadcast" file. As such, these nodes do not replicate this message via P2P. The nodes which do not have a Change Withdrawal Address Broadcast file loaded may still impose a "Change Withdrawal Address Rebroadcast Delay" to keep listening (for about 5 epochs) to see if there are any conflicts to this message. This delay may give User A an advantage in beating User B to consensus, but there is no certainty as it will depend on chance which validator and nodes are involved. 
+* User A: Controls the CL keys and the EL key used for the deposit
+* User B: Controls the CL keys, but does not control the EL key for the deposit
+
+User A signs and submits a claim to the CLWP repository, clients load User A message into the "Set Withdrawal Address Broadcast" file. At the time of the first epoch support Set Withdrawal Address, many (not all) nodes begin to broadcast the message. User B also tries to submit a different but valid Set Withdrawal Address to an address that does not match the signature in the claim. This message is successfully received via REST API, but some (not all) nodes begin to silently drop this message as the signature does not match the signature in the "Set Withdrawal Address Broadcast" file. As such, these nodes do not replicate this message via P2P. The nodes which do not have a Set Withdrawal Address Broadcast file loaded may still impose a "Set Withdrawal Address Rebroadcast Delay" to keep listening (for about 5 epochs) to see if there are any conflicts to this message. This delay may give User A an advantage in beating User B to consensus, but there is no certainty as it will depend on chance which validator and nodes are involved. 
 
 ### 2: Attacker has both EL deposit key and CL keys, uncontested claim
-- User A: Controls the CL key/mnemonic and the EL key used for the deposit, and submits a claim to move to a new address
-- User B: Controls the CL and EL key/mnemonic used for the EL deposit, but fails to submit a claim
+
+* User A: Controls the CL key/mnemonic and the EL key used for the deposit, and submits a claim to move to a new address
+* User B: Controls the CL and EL key/mnemonic used for the EL deposit, but fails to submit a claim
 
 It is possible/likely that User A would notice that all their funds in the EL deposit address had been stolen. This may signal that their CL key is compromised as well, so they decide to pick a new address for the withdrawal. The story will play out the same as Scenario 1 as the claim is uncontested. 
 
 ### 3: Same as #2, but the attacker submits a contested claim
-- User A: Controls the CL keys/mnemonic and the EL key used for the deposit, and submits a claim to move to a new address
-- User B: Controls the CL keys/mnemonic and the EL key used for the deposit, and submits a claim to move to a new address
 
-This is a contested claim and as such there is no way to prove who is in control using on chain data. Instead, either user may try to persuade the community they are the rightful owner (identity verification, social media, etc.) in an attempt to get node operators to load their contested claim into their "Change Withdrawal Address Broadcast" file. However, there is no way to fully prove it. 
+* User A: Controls the CL keys/mnemonic and the EL key used for the deposit, and submits a claim to move to a new address
+* User B: Controls the CL keys/mnemonic and the EL key used for the deposit, and submits a claim to move to a new address
+
+This is a contested claim and as such there is no way to prove who is in control using on chain data. Instead, either user may try to persuade the community they are the rightful owner (identity verification, social media, etc.) in an attempt to get node operators to load their contested claim into their "Set Withdrawal Address Broadcast" file. However, there is no way to fully prove it. 
 
 ### 4: A user has lost either their CL key and/or mnemonic (no withdrawal key)
-- User A: Lacks the CL keys and mnemonic
+
+* User A: Lacks the CL keys and mnemonic
 
 There is no way to recover this scenario with this proposal as we cannot prove a user has lost their keys, and the mnemonic is required to generate the withdrawal key. 
 
 ### 5: End game - attacker
-- User A: Controls EL and CL key/mnemonic, successfully achieves a change address withdrawal
-- User B: Controls CL key, decides to attack
 
-Upon noticing User A has submitted a successful change address withdrawal, User B may run a validator and attempt to get User A slashed
+* User A: Controls EL and CL key/mnemonic, successfully achieves a set address withdrawal
+* User B: Controls CL key, decides to attack
+
+Upon noticing User A has submitted a successful set address withdrawal, User B may run a validator and attempt to get User A slashed
 
 ### 6: Compromised key, but not vulnerable to withdrawal
-- User A: Controls EL and CL key/mnemonic, but has a vulnerability which leaks their CL key but NOT their CL mnemonic
-- User B: Controls the CL key, but lacks the CL mnemonic
+
+* User A: Controls EL and CL key/mnemonic, but has a vulnerability which leaks their CL key but NOT their CL mnemonic
+* User B: Controls the CL key, but lacks the CL mnemonic
 
 User A may generate the withdrawal key (requires the mnemonic). User B can attack User A by getting them slashed, but will be unable to generate the withdrawal key. 
 
-### 7: Attacker loads a malicious Change Withdrawal Address Broadcast and Change Withdrawal Address Acceptance files into one or multiple nodes, User A submits claim
-- User A: Submits a valid uncontested claim which is broadcast out as soon as possible by many nodes
-- User B: Submits no claim, but broadcasts a valid malicious claim out through their Change Withdrawal Address Broadcast list, and blocks User A's claim from their node.
+### 7: Attacker loads a malicious Set Withdrawal Address Broadcast file into one or multiple nodes, User A submits claim
+
+* User A: Submits a valid uncontested claim which is broadcast out as soon as possible by many nodes
+* User B: Submits no claim, but broadcasts a valid malicious claim out through their Set Withdrawal Address Broadcast list, and blocks User A's claim from their node.
 
 User B's claim will make it into many nodes, but when it hits nodes that have adopted User A's signature they will be dropped and not rebroadcast. Statistically, User B will have a harder time achieving consensus among the entire community, but it will be down to chance. 
 
@@ -189,10 +170,11 @@ User B's claim will make it into many nodes, but when it hits nodes that have ad
 The attacker will statistically likely win as they will be first to have their message broadcast to many nodes and, unless User A submits a request exactly at the time of support, it is unlikely to be heard by enough nodes to gain consensus. All users are encouraged to submit claims for this reason because nobody can be certain their mnemonic has not been compromised until it is too late. 
 
 ### Second Order Effects
-1. A user who participates in the "Change Withdrawal Address Broadcast" may cause the attacker to give up early and instead start to slash. For some users, the thought of getting slashed is preferable to giving an adversary any funds. As the proposal is voluntary, users may choose not to participate if they fear this scenario.
-2. The attacker may set up their own unverified list of their own Change Withdrawal Address Acceptance file and nodes adopting this list to break ties in their favour. It is unlikely they would operate enough beacon nodes to form a consensus. 
-3. The attacker may set up their own Change Withdrawal Address Broadcast to reject signatures not matching their attack. This is possible with or without this proposal. 
-4. The attacker may be the one collecting "Change Withdrawal Address Broadcast" claims for this proposal and may purposefully reject legitimate requests. Anyone is free to set up their own community claim collection and gather their own community support using the same mechanisms described in this proposal to form an alternative social consensus. Come at me bro.
+
+1. A user who participates in the "Set Withdrawal Address Broadcast" may cause the attacker to give up early and instead start to slash. For some users, the thought of getting slashed is preferable to giving an adversary any funds. As the proposal is voluntary, users may choose not to participate if they fear this scenario.
+2. The attacker may set up their own Set Withdrawal Address Broadcast to reject signatures not matching their attack. This is possible with or without this proposal. 
+3. The attacker may be the one collecting "Set Withdrawal Address Broadcast" claims for this proposal and may purposefully reject legitimate requests. Anyone is free to set up their own community claim collection and gather their own community support using the same mechanisms described in this proposal to form an alternative social consensus. Come at me bro.
 
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 318d5684602d0a43df762ee08306bc4cf6d0151b Mon Sep 17 00:00:00 2001
From: Daniel Tedesco <dtedesco1@gmail.com>
Date: Wed, 25 Jan 2023 23:32:01 +0800
Subject: [PATCH 203/274] Update EIP-4974: Move to Review (#6334)

* Apply suggestions from initial review

co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

update links

Apply initial suggestions from code review

Update EIP number and typos.

Co-authored-by: William Schwab <31592931+wschwab@users.noreply.github.com>
Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>

rename, add enumerable, update language

update name conventions, ERC165 identifier

update backwards compatability

* minor wording edit

* update with participate and transfer nomenclature

* update reference links

* update reference to assets folder

* removing the assets link

* small update

* begin update to rating

* Apply suggestions from code review

* Full update to Ratings

* Fix links

* Update interface and add implementation example

* Update EIPS/eip-4974.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-4974.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Remove self-references

* Fix bot errors

* Last bot errors

* Update EIP-5570: Move to Review

After community feedback and the draft process, this EIP is ready for the Review stage.

* Fix license

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-4974.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-4974.md b/EIPS/eip-4974.md
index 4334f4a86c6ce4..304bbebb25a0fe 100644
--- a/EIPS/eip-4974.md
+++ b/EIPS/eip-4974.md
@@ -4,7 +4,7 @@ title: Ratings
 description: An interface for assigning and managing numerical ratings
 author: Daniel Tedesco (@dtedesco1)
 discussions-to: https://ethereum-magicians.org/t/8805
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-04-02
@@ -158,4 +158,4 @@ Overall, the security of compliant contracts will depend on the careful manageme
 
 ## Copyright
 
-Copyright and related rights waived via CC0.
+Copyright and related rights waived via [CC0](../LICENSE.md).

From cf35f4c7097dd12618a741c5eb69199e0c72e6df Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Wed, 25 Jan 2023 17:45:12 +0100
Subject: [PATCH 204/274] Purge EIP-6220 of bloated asset (#6369)

A ReentrancyGuard guard was removed from the example implementation of
EIP-6220.

Two references in the Specification were updated.
---
 EIPS/eip-6220.md                              |  4 +-
 assets/eip-6220/contracts/EquippableToken.sol |  4 +-
 .../contracts/security/ReentrancyGuard.sol    | 77 -------------------
 3 files changed, 3 insertions(+), 82 deletions(-)
 delete mode 100644 assets/eip-6220/contracts/security/ReentrancyGuard.sol

diff --git a/EIPS/eip-6220.md b/EIPS/eip-6220.md
index 879b32ce9d327c..f61f15dac27007 100644
--- a/EIPS/eip-6220.md
+++ b/EIPS/eip-6220.md
@@ -59,7 +59,7 @@ The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL
 The interface of the core smart contract of the equippable tokens.
 
 ```solidity
-/// @title EIP-X Composable NFTs utilizing Equippable Parts
+/// @title EIP-6220 Composable NFTs utilizing Equippable Parts
 /// @dev See https://eips.ethereum.org/EIPS/eip-6220
 /// @dev Note: the ERC-165 identifier for this interface is 0x28bc9ae4.
 
@@ -265,7 +265,7 @@ The interface of the Catalog containing the equippable parts. Catalogs are colle
 
 pragma solidity ^0.8.16;
 
-import "@openzeppelin/contracts/utils/introspection/IERC165.sol";
+import "./IERC165.sol";
 
 interface ICatalog is IERC165 {
     /**
diff --git a/assets/eip-6220/contracts/EquippableToken.sol b/assets/eip-6220/contracts/EquippableToken.sol
index ea60fbca457d05..84e85f30ac904d 100644
--- a/assets/eip-6220/contracts/EquippableToken.sol
+++ b/assets/eip-6220/contracts/EquippableToken.sol
@@ -8,7 +8,6 @@ import "./ICatalog.sol";
 import "./IEquippable.sol";
 import "./IERC6059.sol";
 import "./library/EquippableLib.sol";
-import "./security/ReentrancyGuard.sol";
 import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
 import "@openzeppelin/contracts/token/ERC721/IERC721Receiver.sol";
 import "@openzeppelin/contracts/utils/Address.sol";
@@ -67,7 +66,6 @@ error UnexpectedNumberOfChildren();
  */
 contract EquippableToken is
     Context,
-    ReentrancyGuard,
     IERC165,
     IERC721,
     IERC6059,
@@ -1753,7 +1751,7 @@ contract EquippableToken is
      */
     function equip(
         IntakeEquip memory data
-    ) public virtual onlyApprovedOrOwner(data.tokenId) nonReentrant {
+    ) public virtual onlyApprovedOrOwner(data.tokenId) {
         _equip(data);
     }
 
diff --git a/assets/eip-6220/contracts/security/ReentrancyGuard.sol b/assets/eip-6220/contracts/security/ReentrancyGuard.sol
deleted file mode 100644
index 5fab06e46f0c5c..00000000000000
--- a/assets/eip-6220/contracts/security/ReentrancyGuard.sol
+++ /dev/null
@@ -1,77 +0,0 @@
-// SPDX-License-Identifier: MIT
-// OpenZeppelin Contracts v4.4.1 (security/ReentrancyGuard.sol)
-
-pragma solidity ^0.8.16;
-
-error RentrantCall();
-
-/**
- * @title ReentrancyGuard
- * @notice Smart contract used to guard against potential reentrancy exploits.
- * @dev Contract module that helps prevent reentrant calls to a function.
- *
- * Inheriting from `ReentrancyGuard` will make the {nonReentrant} modifier
- * available, which can be applied to functions to make sure there are no nested
- * (reentrant) calls to them.
- *
- * Note that because there is a single `nonReentrant` guard, functions marked as
- * `nonReentrant` may not call one another. This can be worked around by making
- * those functions `private`, and then adding `external` `nonReentrant` entry
- * points to them.
- *
- * TIP: If you would like to learn more about reentrancy and alternative ways
- * to protect against it, check out our blog post
- * https://blog.openzeppelin.com/reentrancy-after-istanbul/[Reentrancy After Istanbul].
- */
-abstract contract ReentrancyGuard {
-    // Booleans are more expensive than uint256 or any type that takes up a full
-    // word because each write operation emits an extra SLOAD to first read the
-    // slot's contents, replace the bits taken up by the boolean, and then write
-    // back. This is the compiler's defense against contract upgrades and
-    // pointer aliasing, and it cannot be disabled.
-
-    // The values being non-zero value makes deployment a bit more expensive,
-    // but in exchange the refund on every call to nonReentrant will be lower in
-    // amount. Since refunds are capped to a percentage of the total
-    // transaction's gas, it is best to keep them low in cases like this one, to
-    // increase the likelihood of the full refund coming into effect.
-    uint256 private constant _NOT_ENTERED = 1;
-    uint256 private constant _ENTERED = 2;
-
-    uint256 private _status;
-
-    /**
-     * @notice Initializes the ReentrancyGuard with the `_status` of `_NOT_ENTERED`.
-     */
-    constructor() {
-        _status = _NOT_ENTERED;
-    }
-
-    /**
-     * @notice Used to ensure that the function it is applied to cannot be reentered.
-     * @dev Prevents a contract from calling itself, directly or indirectly.
-     * Calling a `nonReentrant` function from another `nonReentrant`
-     * function is not supported. It is possible to prevent this from happening
-     * by making the `nonReentrant` function external, and making it call a
-     * `private` function that does the actual work.
-     */
-    modifier nonReentrant() {
-        _nonReentrantIn();
-        _;
-        // By storing the original value once again, a refund is triggered (see
-        // https://eips.ethereum.org/EIPS/eip-2200)
-        _status = _NOT_ENTERED;
-    }
-
-    /**
-     * @notice Used to ensure that the current call is not a reentrant call.
-     * @dev If reentrant call is detected, the execution will be reverted.
-     */
-    function _nonReentrantIn() private {
-        // On the first call to nonReentrant, _notEntered will be true
-        if (_status == _ENTERED) revert RentrantCall();
-
-        // Any calls to nonReentrant after this point will fail
-        _status = _ENTERED;
-    }
-}

From f6a82e5e19fcf563db0dd3b8920d2c0335442892 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 25 Jan 2023 12:50:30 -0500
Subject: [PATCH 205/274] Update CI: Remove consensus and review labels as
 being exempt from stale (#6370)

---
 .github/workflows/stale.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/.github/workflows/stale.yml b/.github/workflows/stale.yml
index f0eebe2a6c43e0..731f68b5313662 100644
--- a/.github/workflows/stale.yml
+++ b/.github/workflows/stale.yml
@@ -24,13 +24,12 @@ jobs:
         close-issue-message: This issue was closed due to inactivity. If you are still pursuing it, feel free to reopen it and respond to any feedback.
         days-before-issue-stale: 7
         days-before-issue-close: 49 # 49 + 7 weeks = 3 months
-        exempt-issue-labels: discussions-to, e-consensus
+        exempt-issue-labels: discussions-to
         stale-issue-label: w-stale
         # PR config
         stale-pr-message: There has been no activity on this pull request for 2 weeks. It will be closed after 3 months of inactivity. If you would like to move this PR forward, please respond to any outstanding feedback or add a comment indicating that you have addressed all required feedback and are ready for a review.
         close-pr-message: This pull request was closed due to inactivity. If you are still pursuing it, feel free to reopen it and respond to any feedback or request a review in a comment.
         days-before-pr-stale: 14
         days-before-pr-close: 42 # 42 + 14 weeks = 3 months
-        exempt-pr-labels: e-review, e-consensus
         exempt-pr-milestones: "Manual Merge Queue"
         stale-pr-label: w-stale

From d005d7cacac96fe417208d624c2529902e9e7522 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 25 Jan 2023 13:02:52 -0500
Subject: [PATCH 206/274] Update EIP template: Add acceptable placeholders
 (#5576)

* Update EIP template: Remove non-required fields and add acceptable placeholders

* Update eip-template.md

* Update eip-template.md

Co-authored-by: xinbenlv <zzn-github@zzn.im>

* Update eip-template.md

* Add Test Cases and Reference Implementation sections back

* Add Motivation section back

* Apply suggestions from code review

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Small tweaks

Co-authored-by: xinbenlv <zzn-github@zzn.im>
Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
Co-authored-by: Sam Wilson <sam@binarycake.ca>
---
 eip-template.md | 94 +++++++++++++++++++++++++++++++++++++++++--------
 index.html      |  2 +-
 2 files changed, 80 insertions(+), 16 deletions(-)

diff --git a/eip-template.md b/eip-template.md
index d71731fb7b83aa..892fda11e785ca 100644
--- a/eip-template.md
+++ b/eip-template.md
@@ -1,55 +1,119 @@
 ---
-eip: <to be assigned>
 title: <The EIP title is a few words, not a complete sentence>
 description: <Description is one full (short) sentence>
 author: <a comma separated list of the author's or authors' name + GitHub username (in parenthesis), or name and email (in angle brackets).  Example, FirstName LastName (@GitHubUsername), FirstName LastName <foo@bar.com>, FirstName (@GitHubUsername) and GitHubUsername (@GitHubUsername)>
 discussions-to: <URL>
 status: Draft
 type: <Standards Track, Meta, or Informational>
-category (*only required for Standards Track): <Core, Networking, Interface, or ERC>
+category: <Core, Networking, Interface, or ERC> # Only required for Standards Track. Otherwise, remove this field.
 created: <date created on, in ISO 8601 (yyyy-mm-dd) format>
-requires (*optional): <EIP number(s)>
+requires: <EIP number(s)> # Only required when you reference an EIP in the `Specification` section. Otherwise, remove this field.
 ---
 
-This is the suggested template for new EIPs.
+<!--
+  READ EIP-1 (https://eips.ethereum.org/EIPS/eip-1) BEFORE USING THIS TEMPLATE!
 
-Note that an EIP number will be assigned by an editor. When opening a pull request to submit your EIP, please use an abbreviated title in the filename, `eip-draft_title_abbrev.md`.
+  This is the suggested template for new EIPs. After you have filled in the requisite fields, please delete these comments.
 
-The title should be 44 characters or less. It should not repeat the EIP number in title, irrespective of the category.
+  Note that an EIP number will be assigned by an editor. When opening a pull request to submit your EIP, please use an abbreviated title in the filename, `eip-draft_title_abbrev.md`.
+
+  The title should be 44 characters or less. It should not repeat the EIP number in title, irrespective of the category.
+
+  TODO: Remove this comment before submitting
+-->
 
 ## Abstract
 
-Abstract is a multi-sentence (short paragraph) technical summary. This should be a very terse and human-readable version of the specification section. Someone should be able to read only the abstract to get the gist of what this specification does.
+<!--
+  The Abstract is a multi-sentence (short paragraph) technical summary. This should be a very terse and human-readable version of the specification section. Someone should be able to read only the abstract to get the gist of what this specification does.
+
+  TODO: Remove this comment before submitting
+-->
 
 ## Motivation
 
-The motivation section should describe the "why" of this EIP. What problem does it solve? Why should someone want to implement this standard? What benefit does it provide to the Ethereum ecosystem? What use cases does this EIP address?
+<!--
+  This section is optional.
+
+  The motivation section should include a description of any nontrivial problems the EIP solves. It should not describe how the EIP solves those problems, unless it is not immediately obvious. It should not describe why the EIP should be made into a standard, unless it is not immediately obvious.
+
+  With a few exceptions, external links are not allowed. If you feel that a particular resource would demonstrate a compelling case for your EIP, then save it as a printer-friendly PDF, put it in the assets folder, and link to that copy.
+
+  TODO: Remove this comment before submitting
+-->
 
 ## Specification
 
-The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+<!--
+  The Specification section should describe the syntax and semantics of any new feature. The specification should be detailed enough to allow competing, interoperable implementations for any of the current Ethereum platforms (besu, erigon, ethereumjs, go-ethereum, nethermind, or others).
 
-The technical specification should describe the syntax and semantics of any new feature. The specification should be detailed enough to allow competing, interoperable implementations for any of the current Ethereum platforms (go-ethereum, parity, cpp-ethereum, ethereumj, ethereumjs, and [others](https://ethereum.org/en/developers/docs/nodes-and-clients/)).
+  It is recommended to follow RFC 2119 and RFC 8170. Do not remove the key word definitions if RFC 2119 and RFC 8170 are followed.
+
+  TODO: Remove this comment before submitting
+-->
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174.
 
 ## Rationale
 
-The rationale fleshes out the specification by describing what motivated the design and why particular design decisions were made. It should describe alternate designs that were considered and related work, e.g. how the feature is supported in other languages.
+<!--
+  The rationale fleshes out the specification by describing what motivated the design and why particular design decisions were made. It should describe alternate designs that were considered and related work, e.g. how the feature is supported in other languages.
+
+  The current placeholder is acceptable for a draft.
+
+  TODO: Remove this comment before submitting
+-->
+
+TBD
 
 ## Backwards Compatibility
 
-All EIPs that introduce backwards incompatibilities must include a section describing these incompatibilities and their severity. The EIP must explain how the author proposes to deal with these incompatibilities. EIP submissions without a sufficient backwards compatibility treatise may be rejected outright.
+<!--
+
+  This section is optional.
+
+  All EIPs that introduce backwards incompatibilities must include a section describing these incompatibilities and their severity. The EIP must explain how the author proposes to deal with these incompatibilities. EIP submissions without a sufficient backwards compatibility treatise may be rejected outright.
+
+  The current placeholder is acceptable for a draft.
+
+  TODO: Remove this comment before submitting
+-->
+
+No backward compatibility issues found.
 
 ## Test Cases
 
-Test cases for an implementation are mandatory for EIPs that are affecting consensus changes.  If the test suite is too large to reasonably be included inline, then consider adding it as one or more files in `../assets/eip-####/`.
+<!--
+  This section is optional for non-Core EIPs.
+
+  The Test Cases section should include expected input/output pairs, but may include a succinct set of executable tests. It should not include project build files. No new requirements may be be introduced here (meaning an implementation following only the Specification section should pass all tests here.)
+  If the test suite is too large to reasonably be included inline, then consider adding it as one or more files in `../assets/eip-####/`. External links will not be allowed
+
+  TODO: Remove this comment before submitting
+-->
 
 ## Reference Implementation
 
-An optional section that contains a reference/example implementation that people can use to assist in understanding or implementing this specification.  If the implementation is too large to reasonably be included inline, then consider adding it as one or more files in `../assets/eip-####/`.
+<!--
+  This section is optional.
+
+  The Reference Implementation section should include a minimal implementation that assists in understanding or implementing this specification. It should not include project build files. The reference implementation is not a replacement for the Specification section, and the proposal should still be understandable without it.
+  If the reference implementation is too large to reasonably be included inline, then consider adding it as one or more files in `../assets/eip-####/`. External links will not be allowed.
+
+  TODO: Remove this comment before submitting
+-->
 
 ## Security Considerations
 
-All EIPs must contain a section that discusses the security implications/considerations relevant to the proposed change. Include information that might be important for security discussions, surfaces risks and can be used throughout the life cycle of the proposal. E.g. include security-relevant design decisions, concerns, important discussions, implementation-specific guidance and pitfalls, an outline of threats and risks and how they are being addressed. EIP submissions missing the "Security Considerations" section will be rejected. An EIP cannot proceed to status "Final" without a Security Considerations discussion deemed sufficient by the reviewers.
+<!--
+  All EIPs must contain a section that discusses the security implications/considerations relevant to the proposed change. Include information that might be important for security discussions, surfaces risks and can be used throughout the life cycle of the proposal. For example, include security-relevant design decisions, concerns, important discussions, implementation-specific guidance and pitfalls, an outline of threats and risks and how they are being addressed. EIP submissions missing the "Security Considerations" section will be rejected. An EIP cannot proceed to status "Final" without a Security Considerations discussion deemed sufficient by the reviewers.
+
+  The current placeholder is acceptable for a draft.
+
+  TODO: Remove this comment before submitting
+-->
+
+Needs discussion.
 
 ## Copyright
 
diff --git a/index.html b/index.html
index 8ef51c6686e5ee..7f7c55bae4922c 100644
--- a/index.html
+++ b/index.html
@@ -12,7 +12,7 @@ <h1 class="page-heading">EIPs
 <p>Ethereum Improvement Proposals (EIPs) describe standards for the Ethereum platform, including core protocol specifications, client APIs, and contract standards. Network upgrades are discussed separately in the <a target="_blank" href="/ethereum/pm/">Ethereum Project Management</a> repository.</p>
 
 <h2>Contributing</h2>
-<p>First review <a href="EIPS/eip-1">EIP-1</a>. Then clone the repository and add your EIP to it. There is a <a href="/ethereum/EIPs/blob/master/eip-template.md">template EIP here</a>. Then submit a Pull Request to Ethereum's <a href="/ethereum/EIPs">EIPs repository</a>.</p>
+<p>First review <a href="EIPS/eip-1">EIP-1</a>. Then clone the repository and add your EIP to it. There is a <a href="/ethereum/EIPs/blob/master/eip-template.md?plain=1">template EIP here</a>. Then submit a Pull Request to Ethereum's <a href="/ethereum/EIPs">EIPs repository</a>.</p>
 
 <h2>EIP status terms</h2>
 <ul>

From d65ccef09c561fa459b2418366da233a72d35c08 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 25 Jan 2023 13:13:52 -0500
Subject: [PATCH 207/274] Update README: Add friendlier introduction (#5927)

* Update README: Add friendlier introduction

* Apply suggestions from code review

Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>

* Readd 5069

* Remove trailing space

* Apply suggestions from code review

Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>
Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 README.md | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index dbf8c9d68528c5..682a1c91324e30 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,21 @@
 # Ethereum Improvement Proposals (EIPs)
 
-**Before you initiate a pull request**, please read the [EIP-1](https://eips.ethereum.org/EIPS/eip-1) process document. Ideas should be thoroughly discussed on [Ethereum Research](https://ethresear.ch/t/read-this-before-posting/8) or [Ethereum Magicians](https://ethereum-magicians.org/) first.
+The goal of the EIP project is to standardize and provide high-quality documentation for Ethereum itself and conventions built upon it. This repository tracks past and ongoing improvements to Ethereum in the form of Ethereum Improvement Proposals (EIPs). [EIP-1](https://eips.ethereum.org/EIPS/eip-1) governs how EIPs are published.
 
-This repository tracks ongoing improvements to Ethereum. It contains:
+The [status page](https://eips.ethereum.org/) tracks and lists EIPs, which can be divided into the following categories:
 
-- The [EIP status page](https://eips.ethereum.org), tracking protocols for Ethereum clients and applications
-- The [process document](https://eips.ethereum.org/EIPS/eip-1) that governs how protocols are published here
+- [Core EIPs](https://eips.ethereum.org/core) are improvements to the Ethereum consensus protocol.
+- [Networking EIPs](https://eips.ethereum.org/networking) specify the peer-to-peer networking layer of Ethereum.
+- [Interface EIPs](https://eips.ethereum.org/interface) standardize interfaces to Ethereum, which determine how users and applications interact with the blockchain.
+- [ERCs](https://eips.ethereum.org/erc) specify application layer standards, which determine how applications running on Ethereum can interact with each other.
+- [Meta EIPs](https://eips.ethereum.org/meta) are miscellaneous improvements that nonetheless require some sort of consensus.
+- [Informational EIPs](https://eips.ethereum.org/informational) are non-standard improvements that do not require any form of consensus.
 
-For help *implementing* an EIP, please visit [Ethereum Stack Exchange](https://ethereum.stackexchange.com).
+**Before you write an EIP, ideas MUST be thoroughly discussed on [Ethereum Magicians](https://ethereum-magicians.org/) or [Ethereum Research](https://ethresear.ch/t/read-this-before-posting/8). Once consensus is reached, thoroughly read and review [EIP-1](https://eips.ethereum.org/EIPS/eip-1), which describes the EIP process.**
 
-If you would like to become an EIP Editor, please check [EIP-5069](./EIPS/eip-5069.md).
+Please note that this repository is for documenting standards and not for help implementing them. These types of inquiries should be directed to the [Ethereum Stack Exchange](https://ethereum.stackexchange.com). For specific questions and concerns regarding EIPs, it's best to comment on the relevant discussion thread of the EIP denoted by the `discussions-to` tag in the EIP's preamble.
 
-## Mission
-
-The goal of the EIP project is to document standardized protocols for Ethereum clients and applications and to document them in a high-quality and implementable way.
+If you would like to become an EIP Editor, please read [EIP-5069](./EIPS/eip-5069.md).
 
 ## Preferred Citation Format
 

From b216982e68c5b15400f6d68d24a78c05712b2df5 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 25 Jan 2023 15:59:02 -0500
Subject: [PATCH 208/274] Website: Human-friendly preamble (#6017)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

* Website: Human-friendly preamble

* Fix syntax error

* Fix more syntax errors

* Indicate authors a little better

* Fix small typo

* Fix another syntax error

* Make use of blockquotes for withdraw reason

* Remove redunant/removed items

* Add additional linebreak

* Include bootstrap CSS

* Move to correct folder

* Add responsive meta tag

* Badges fade on hover

* Commit changes so far

* Temporarily delete integrities while in development

* Delete custom-head.html

* Update eip.html

* Update eip.html

* Update style.scss

* Remove bootstrap references

* Use remove theme that adds markdown

* Use regular minima again

* Add bootstrap styling

* Remove MathJax and bootstrap from eips rendering

* ... and place it in the head

* Fix typos

* Make header work with bootstrap

* Add category badges

* Update styles

* Fix integrities

* Upgrade to mathjax v3

* Update style.scss

* Use correct mathjax integrity

* Change badge color scheme

* Move badges to before title

* Always link to discussion

* Automatically open discussion links in new tab

* Reorder preamble items & fix some rendering issues

* Fix page title for ERCs

* Add descriptions

* @SamWilsn's authorlist suggestion

* Some changes that @SamWilsn suggested

* Update authorlist to use no break spaces

* Make data wrap better & center-align discussion link

* Move @ into GitHub link

* Actually center link

* Use table layout instead of an actual table

* Fix table formatting

* Go back to normal table layout

* Add magic sauce

* Add unknown magical @SamWilsn code

I hope you know what you're doing

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* TIL there IS an else tag

* 🤦‍♂️🤦‍♂️ Double facepalm

* Add inline svg style

* Use inline SVG styling & add discussion bubble

* Remove third typo

* Add styling to make SVG links a bit better

* Add no-underline class

* Add no-underline class to icon links

* Add padding to footer to fix some styling issues

* Target the right class

* Fix footer

* Use different target for footer fix

* Final(tm) footer fix

* Use Sam's magic answer with SCSS and see how it turns out

* Fix it

* Update content-width to 100%

* Oops typo

* Make icons a tad bit smaller

* Make badges a bit bigger

* Add EIP- prefix to requires items

TODO: maybe use ERC prefix when needed?

* Fix width

* Lower font size

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 _includes/authorlist.html |   4 +-
 _includes/eipnums.html    |   2 +-
 _includes/head.html       |  35 ++++++++-
 _includes/header.html     |  29 ++++++++
 _layouts/eip.html         | 144 +++++++++++++++++++++++---------------
 assets/css/style.scss     |  65 +++++++++--------
 6 files changed, 187 insertions(+), 92 deletions(-)
 create mode 100644 _includes/header.html

diff --git a/_includes/authorlist.html b/_includes/authorlist.html
index ff78bba7262460..21784681ce485d 100644
--- a/_includes/authorlist.html
+++ b/_includes/authorlist.html
@@ -2,10 +2,10 @@
 {%- for author in authors -%}
   {%- if author contains "<" -%}
     {%- assign authorparts=author|split:"<" -%}
-    <a href="mailto:{{authorparts[1]|remove:">"}}">{{authorparts[0]|strip}}</a>
+    {{authorparts[0]|strip}}&nbsp;&lt;<a href="mailto:{{authorparts[1]|remove:">"}}">{{authorparts[1]|remove:">"}}</a>&gt;
   {%- elsif author contains "(@" -%}
     {%- assign authorparts=author|split:"(@" -%}
-    <a href="/{{authorparts[1]|remove:")"}}">{{authorparts[0]|strip}}</a>
+    {{authorparts[0]|strip}}&nbsp;(<a href="/{{authorparts[1]|remove:")"}}">@{{authorparts[1]|remove:")"}}</a>)
   {%- else -%}
     {{author}}
   {%- endif -%}
diff --git a/_includes/eipnums.html b/_includes/eipnums.html
index cd823d545d16cf..4edcd30b7028ad 100644
--- a/_includes/eipnums.html
+++ b/_includes/eipnums.html
@@ -1,4 +1,4 @@
 {% assign eips=include.eips|split:"," %}
 {% for eipnum in eips %}
-  <a href="{{eipnum|strip|prepend:"eip-" }}">{{eipnum|strip}}</a>{% if forloop.last == false %}, {% endif %}
+  <a href="{{eipnum|strip|prepend:"eip-" }}">EIP-{{eipnum|strip}}</a>{% if forloop.last == false %}, {% endif %}
 {% endfor %}
diff --git a/_includes/head.html b/_includes/head.html
index 4ee006aa2d4324..d5a2675e807dc0 100644
--- a/_includes/head.html
+++ b/_includes/head.html
@@ -3,8 +3,13 @@
   <meta http-equiv="X-UA-Compatible" content="IE=edge" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
   {% if page.layout == "eip" %}
-    <title>EIP-{{ page.eip }}: {{ page.title | escape }}</title>
-    <meta property="og:title" content="EIP-{{ page.eip }}: {{ page.title | escape }}" />
+    {% if page.category == "ERC" %}
+      <title>ERC-{{ page.eip }}: {{ page.title | escape }}</title>
+      <meta propery="og:title" content="ERC-{{ page.eip }}: {{ page.title | escape }}" />
+    {% else %}
+      <title>EIP-{{ page.eip }}: {{ page.title | escape }}</title>
+      <meta property="og:title" content="EIP-{{ page.eip }}: {{ page.title | escape }}" />
+    {% endif %}
     <meta name="description" content="{{page.description | escape }}" />
     <meta property="og:description" content="{{page.description | escape }}" />
     <meta name="twitter:description" content="{{page.description | escape }}" />
@@ -36,5 +41,29 @@
   </script>
   <link rel="stylesheet" href="{{ '/assets/css/style.css' | relative_url }}" />
   {%- feed_meta -%}
-  <script async src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.6/MathJax.js?config=TeX-AMS-MML_HTMLorMML" integrity="sha256-nlrDrBTHxJJlDDX22AS33xYI1OJHnGMDhiYMSe2U0e0=" crossorigin="anonymous"></script>
+  <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.3/dist/css/bootstrap.min.css" rel="stylesheet" integrity="sha384-rbsA2VBKQhggwzxH7pPCaAqO46MgnOM80zW1RWuH61DGLwZJEdK2Kadq2F9CUG65" crossorigin="anonymous">
+  <script src="https://polyfill.io/v3/polyfill.min.js?features=es6"></script>
+  <script src="https://cdn.jsdelivr.net/npm/@popperjs/core@2.11.6/dist/umd/popper.min.js" integrity="sha384-oBqDVmMz9ATKxIep9tiCxS/Z9fNfEXiDAYTujMAeBAsjFuCZSmKbSSUnQlmh/jp3" crossorigin="anonymous"></script>
+  <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.2.3/dist/js/bootstrap.min.js" integrity="sha384-cuYeSxntonz0PPNlHhBs68uyIAVpIIOZZ5JqeqvYYIcEL727kskC66kF92t6Xl2V" crossorigin="anonymous"></script>
+  <script type="text/javascript">
+    document.addEventListener("DOMContentLoaded", (event) => {
+      const tooltipTriggerList = document.querySelectorAll('[data-bs-toggle="tooltip"]')
+      const tooltipList = [...tooltipTriggerList].map(tooltipTriggerEl => new bootstrap.Tooltip(tooltipTriggerEl))
+    });
+  </script>
+  <script type="text/javascript">
+    window.MathJax = {
+      loader: {
+        load: ['input/tex-base', 'output/chtml', 'ui/lazy']
+      },
+      tex: {
+        inlineMath: [['$', '$']],
+        displayMath: [['$$', '$$']],
+        processEscapes: true,
+        processEnvironments: false,
+        processRefs: false
+      }
+    };
+  </script>
+  <script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3.0.1/es5/tex-mml-chtml.js" integrity="sha384-/1zmJ1mBdfKIOnwPxpdG6yaRrxP6qu3eVYm0cz2nOx+AcL4d3AqEFrwcqGZVVroG" crossorigin="anonymous"></script>
         <style>
          .commit-tease,
          .user-profile-mini-avatar,
          .avatar,
          .vcard-details,
          .signup-prompt-bg {
            display: none !IMPORTANT;
          }
        </style>
         <script>
          document.addEventListener('DOMContentLoaded', function() {
            this.querySelectorAll('a').forEach(anchor => {
              anchor.addEventListener('click', e => {
                e.preventDefault();

                const redact = new URLSearchParams(window.location.search).get('redact');
                const hasExistingParams = anchor.href.includes('?');
                window.location.href = anchor.href + (hasExistingParams ? `&redact=${redact}` : `?redact=${redact}`);
              });
            });
          });
        </script>
 </head>
diff --git a/_includes/header.html b/_includes/header.html
new file mode 100644
index 00000000000000..2afd73fb539985
--- /dev/null
+++ b/_includes/header.html
@@ -0,0 +1,29 @@
+<header class="site-header" role="banner">
+  <div class="wrapper">
+    {%- assign default_paths = site.pages | map: "path" -%}
+    {%- assign page_paths = site.header_pages | default: default_paths -%}
+    <a class="site-title" rel="author" href="{{ "/" | relative_url }}">{{ site.title | escape }}</a>
+
+    {%- if page_paths -%}
+      <nav class="site-nav d-flex">
+        <input type="checkbox" id="nav-trigger" class="nav-trigger" />
+        <label for="nav-trigger">
+          <span class="menu-icon">
+            <svg viewBox="0 0 18 15" width="18px" height="15px">
+              <path d="M18,1.484c0,0.82-0.665,1.484-1.484,1.484H1.484C0.665,2.969,0,2.304,0,1.484l0,0C0,0.665,0.665,0,1.484,0 h15.032C17.335,0,18,0.665,18,1.484L18,1.484z M18,7.516C18,8.335,17.335,9,16.516,9H1.484C0.665,9,0,8.335,0,7.516l0,0 c0-0.82,0.665-1.484,1.484-1.484h15.032C17.335,6.031,18,6.696,18,7.516L18,7.516z M18,13.516C18,14.335,17.335,15,16.516,15H1.484 C0.665,15,0,14.335,0,13.516l0,0c0-0.82,0.665-1.483,1.484-1.483h15.032C17.335,12.031,18,12.695,18,13.516L18,13.516z"/>
+            </svg>
+          </span>
+        </label>
+
+        <div class="trigger row p-2">
+          {%- for path in page_paths -%}
+            {%- assign my_page = site.pages | where: "path", path | first -%}
+            {%- if my_page.title -%}
+            <a class="page-link col" href="{{ my_page.url | relative_url }}">{{ my_page.title | escape }}</a>
+            {%- endif -%}
+          {%- endfor -%}
+        </div>
+      </nav>
+    {%- endif -%}
+  </div>
+</header>
diff --git a/_layouts/eip.html b/_layouts/eip.html
index d8d5cbe8ff9484..27544d8f97a689 100644
--- a/_layouts/eip.html
+++ b/_layouts/eip.html
@@ -2,59 +2,103 @@
 layout: default
 ---
 
-{% if page.status == "Draft" %}
-  <div class="draft">
-    ⚠️ This EIP is not recommended for general use or implementation as it is likely to change.
-  </div>
-{% elsif page.status == "Review" %}
-  <div class="review">
-    📖 This EIP is in the review stage. It is subject to changes and feedback is appreciated.
-  </div>
-{% elsif page.status == "Last Call" %}
-  <div class="lastcall">
-    📢 This EIP is in the last call for review stage. The authors wish to finalize the EIP and appreciate feedback.
-  </div>
-{% elsif page.status == "Stagnant" %}
-  <div class="stagnant">
-    🚧 This EIP had no activity for at least 6 months.
-  </div>
-{% elsif page.status == "Withdrawn" %}
-  <div class="withdrawn">
-    🛑 This EIP has been withdrawn.
-  </div>
-{% endif %}
+<svg xmlns="http://www.w3.org/2000/svg" style="display: none;">
+  <symbol id="bi-megaphone-fill" fill="currentColor" viewBox="0 0 16 16">
+    <title>Alert</title>
+    <path d="M13 2.5a1.5 1.5 0 0 1 3 0v11a1.5 1.5 0 0 1-3 0v-11zm-1 .724c-2.067.95-4.539 1.481-7 1.656v6.237a25.222 25.222 0 0 1 1.088.085c2.053.204 4.038.668 5.912 1.56V3.224zm-8 7.841V4.934c-.68.027-1.399.043-2.008.053A2.02 2.02 0 0 0 0 7v2c0 1.106.896 1.996 1.994 2.009a68.14 68.14 0 0 1 .496.008 64 64 0 0 1 1.51.048zm1.39 1.081c.285.021.569.047.85.078l.253 1.69a1 1 0 0 1-.983 1.187h-.548a1 1 0 0 1-.916-.599l-1.314-2.48a65.81 65.81 0 0 1 1.692.064c.327.017.65.037.966.06z"/>
+  </symbol>
+  <symbol id="bi-code" fill="currentColor" viewBox="0 0 16 16">
+    <title>Source</title>
+    <path d="M5.854 4.854a.5.5 0 1 0-.708-.708l-3.5 3.5a.5.5 0 0 0 0 .708l3.5 3.5a.5.5 0 0 0 .708-.708L2.707 8l3.147-3.146zm4.292 0a.5.5 0 0 1 .708-.708l3.5 3.5a.5.5 0 0 1 0 .708l-3.5 3.5a.5.5 0 0 1-.708-.708L13.293 8l-3.147-3.146z"/>
+  </symbol>
+  <svg id="bi-chat" fill="currentColor" viewBox="0 0 16 16">
+    <title>Discuss</title>
+    <path d="M2.678 11.894a1 1 0 0 1 .287.801 10.97 10.97 0 0 1-.398 2c1.395-.323 2.247-.697 2.634-.893a1 1 0 0 1 .71-.074A8.06 8.06 0 0 0 8 14c3.996 0 7-2.807 7-6 0-3.192-3.004-6-7-6S1 4.808 1 8c0 1.468.617 2.83 1.678 3.894zm-.493 3.905a21.682 21.682 0 0 1-.713.129c-.2.032-.352-.176-.273-.362a9.68 9.68 0 0 0 .244-.637l.003-.01c.248-.72.45-1.548.524-2.319C.743 11.37 0 9.76 0 8c0-3.866 3.582-7 8-7s8 3.134 8 7-3.582 7-8 7a9.06 9.06 0 0 1-2.347-.306c-.52.263-1.639.742-3.468 1.105z"/>
+  </svg>
+</svg>
 
 <div class="home">
-  <h1 class="page-heading">
-    EIP-{{ page.eip | xml_escape }}: {{ page.title | xml_escape }}
-    <a href="{{site.github.repository_url}}/blob/master/{{page.path}}"><svg role="img" aria-label="Source" xmlns="https://www.w3.org/2000/svg" width="14" height="16" viewBox="0 0 14 16"><title>Source</title><path fill-rule="evenodd" d="M9.5 3L8 4.5 11.5 8 8 11.5 9.5 13 14 8 9.5 3zm-5 0L0 8l4.5 5L6 11.5 2.5 8 6 4.5 4.5 3z"/></svg></a>
-  </h1>
-  <h3>{{ page.description | xml_escape }}</h3>
-  <table>
-    <tr><th>Author</th><td>{% include authorlist.html authors=page.author %}</td></tr>
-    {% if page["discussions-to"] != undefined %}
-      <tr><th>Discussions-To</th><td><a href="{{ page["discussions-to"] | uri_escape }}">{{ page["discussions-to"] | xml_escape }}</a></td></tr>
+  <span class="h5">
+    {% if page.status == "Stagnant" %}
+      <span class="badge text-light bg-danger" data-bs-toggle="tooltip" data-bs-title="This EIP had no activity for at least 6 months. This EIP should not be used.">🚧 Stagnant</span>
     {% endif %}
-    <tr><th>Status</th><td>{{ page.status | xml_escape }}
-    {% if page.last-call-deadline != undefined %}
-      <tr><th>Last Call Deadline</th><td>{{ page.last-call-deadline | xml_escape }}</td></tr>
+    {% if page.status == "Withdrawn" %}
+      <span class="badge text-light bg-danger" data-bs-toggle="tooltip" data-bs-title="This EIP has been withdrawn, and should not be used.">🛑 Withdrawn</span>
     {% endif %}
-    </td></tr>
-    <tr><th>Type</th><td>{{ page.type | xml_escape }}</td></tr>
-    {% if page.category != undefined %}
-      <tr><th>Category</th><td>{{ page.category | xml_escape }}</td></tr>
+    {% if page.status == "Draft" or	page.status == "Review" %}
+      <span class="badge text-light bg-warning" data-bs-toggle="tooltip" data-bs-title="This EIP is not yet recommended for general use or implementation, as it is subject to normative (breaking) changes.">⚠️ {{ page.status }}</span>
     {% endif %}
-    <tr><th>Created</th><td>{{ page.created | xml_escape }}</td></tr>
-    {% if page.updated != undefined %}
-    <tr><th>Updated</th><td>{{ page.updated | xml_escape }}</td></tr>
+    {% if page.status == "Last Call" %}
+      <span class="badge text-light bg-success" data-bs-toggle="tooltip" data-bs-title="This EIP is in the last call for review stage. The authors wish to finalize the EIP and ask you to provide feedback.">📢 Last Call</span>
     {% endif %}
-    {% if page.requires != undefined %}
-      <tr><th>Requires</th><td>{% include eipnums.html eips=page.requires %}</td></tr>
+    {% if page.category == "ERC" %}
+      <a class="badge text-light bg-primary" data-bs-toggle="tooltip" data-bs-title="Application-level standards and conventions, including contract standards such as token standards, name registries, URI schemes, library/package formats, and wallet formats." href="../erc">Standards Track: ERC</a>
+    {% elsif page.category == "Interface" %}
+      <a class="badge text-light bg-primary" data-bs-toggle="tooltip" data-bs-title="Improvements around client API/RPC specifications and standards, and also certain language-level standards like method names and contract ABIs." href="../interface">Standards Track: Interface</a>
+    {% elsif page.category == "Networking" %}
+      <a class="badge text-light bg-primary" data-bs-toggle="tooltip" data-bs-title="Improvements around devp2p and Light Ethereum Subprotocol, as well as proposed improvements to network protocol specifications of whisper and swarm." href="../networking">Standards Track: Networking</a>
+    {% elsif page.category == "Core" %}
+      <a class="badge text-light bg-primary" data-bs-toggle="tooltip" data-bs-title="Improvements requiring a consensus fork, as well as changes that are not necessarily consensus critical but may be relevant to “core dev” discussions." href="../core">Standards Track: Core</a>
+    {% elsif page.type == "Informational" %}
+      <a class="badge text-light bg-primary" data-bs-toggle="tooltip" data-bs-title="Describes an Ethereum design issue, or provides general guidelines or information to the Ethereum community, but does not propose a new feature. Informational EIPs do not necessarily represent Ethereum community consensus or a recommendation, so users and implementers are free to ignore Informational EIPs or follow their advice." href="../informational">Informational</a>
+    {% elsif page.type == "Meta" %}
+      <a class="badge text-light bg-primary" data-bs-toggle="tooltip" data-bs-title="Describes a process surrounding Ethereum or proposes a change to (or an event in) a process. " href="../meta">Meta</a>
     {% endif %}
-    {% if page["withdrawal-reason"] != undefined %}
-      <tr><th>Withdrawal reason</th><td>{{ page["withdrawal-reason"] | xml_escape }}</td></tr>
+  </span>
+  <h1 class="page-heading">
+    {% if page.category == "ERC" %}
+      ERC-{{ page.eip | xml_escape }}: {{ page.title | xml_escape }}
+    {% elsif page.category != "ERC" %}
+      EIP-{{ page.eip | xml_escape }}: {{ page.title | xml_escape }}
     {% endif %}
+    <a href="{{ page["discussions-to"] | uri_escape }}" class="no-underline">
+      <svg role="img" aria-label="Discuss" class="inline-svg" xmlns="https://www.w3.org/2000/svg" viewBox="0 0 16 16">
+        <use xlink:href="#bi-chat"/>
+      </svg>
+    </a>
+    <a href="{{site.github.repository_url}}/blob/master/{{page.path}}" class="no-underline">
+      <svg role="img" aria-label="Source" class="inline-svg" xmlns="https://www.w3.org/2000/svg" viewBox="0 0 16 16">
+        <use xlink:href="#bi-code"/>
+      </svg>
+    </a>
+  </h1>
+  <h3>{{ page.description | xml_escape }}</h3>
+  <table class="table table-borderless preamble">
+    <tbody>
+      <tr>
+        <th scope="row">Authors</th>
+        <td>{% include authorlist.html authors=page.author %}</td>
+      </tr>
+      {% if page.created != undefined %}
+        <tr>
+          <th scope="row">Created</th>
+          <td>{{ page.created }}</td>
+        </tr>
+      {% endif %}
+      {% if page.status != "Review" and page.status != "Last Call" and page.status != "Final" and page["discussions-to"] != undefined %}
+        <tr>
+          <th scope="row">Discussion Link</th>
+          <td><a href="{{ page["discussions-to"] | uri_escape }}" target="__blank">{{ page["discussions-to"] | xml_escape }}</a></td>
+        </tr>
+      {% endif %}
+      {% if page.requires != undefined %}
+        <tr>
+          <th scope="row">Requires</th>
+          <td>{% include eipnums.html eips=page.requires %}</td>
+        </tr>
+      {% endif %}
+    </tbody>
   </table>
+  <br/>
+
+  {% if page.status == "Review" or page.status == "Last Call" %}
+    <div class="alert alert-primary d-flex align-items-center" role="alert">
+      <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Info:" style="width:2.5em;height:2.5em;"><use xlink:href="#bi-megaphone-fill"/></svg>
+      <div class="text-center w-100">
+        <a href="{{ page["discussions-to"] | uri_escape }}" target="__blank">This EIP is in the process of being peer-reviewed. If you are interested in this EIP, please participate using this discussion link.</a>
+      </div>
+    </div>
+  {% endif %}
 
   <div class="toc">
     <h2>Table of Contents</h2>
@@ -92,15 +136,3 @@ <h2>Citation</h2>
     "copyrightYear": "{{ page.created | date: "%Y" }}"
   }
 </script>
-<script type="text/javascript" async src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.3/MathJax.js?config=TeX-MML-AM_CHTML" integrity="sha512-bzXk9PaBIjgXcM+0Z7wbOE4AAMnmMoecyB8zX3irP4IRUDNGMmWXoLiRvEDeeq0RfhLA0eOFvB3wPFzBvWcVdw==" crossorigin="anonymous">
-  MathJax.Hub.Config({
-    tex2jax: {
-      inlineMath: [["$", "$"]],
-      displayMath: [["$$", "$$"]],
-      processEscapes: true
-    },
-    asciimath2jax: {
-      delimiters: [] // Disable asciimath
-    }
-  });
-</script>
diff --git a/assets/css/style.scss b/assets/css/style.scss
index 2624f9b84cb5d2..c2c72c25ffd15e 100644
--- a/assets/css/style.scss
+++ b/assets/css/style.scss
@@ -2,7 +2,7 @@
 # Only the main Sass file needs front matter (the dashes are enough)
 ---
 
-$content-width: 960px;
+$content-width: 1152px;
 
 @import 'minima';
 
@@ -30,10 +30,22 @@ $content-width: 960px;
   color: #111;
 }
 
+.table-borderless, .table-borderless * {
+  border-style : hidden !important; // !important To override Jekyll styling
+  background-color: rgba(0,0,0,0) !important;
+}
+
+table.preamble > tbody > tr > :not(:first-child) {
+  width: 100%;
+}
+
+table.preamble > tbody > tr > :first-child {
+  white-space: nowrap;
+}
+
 a, a:link {
   color: #726E97;
   text-decoration: none;
-  transition: 0.5s;
 }
 
 a:visited {
@@ -42,44 +54,37 @@ a:visited {
 
 a:hover, a:active {
   color: #7F557D;
-  box-shadow: 0 3px 0 #7F557D;
+  text-decoration: underline;
 }
 
-.status {
-  border-radius: 6px;
-  line-height: 18px;
-  overflow: hidden;
-  padding: 12px;
-  display: inline-block;
-  margin-bottom: 15px;
+.site-footer, .site-footer * {
+  box-sizing: content-box !important; // !important To override bootstrap styling
 }
 
-.draft {
-  @extend .status;
-  background-color: #fffbea;
-  border: solid 1px #f1c40f;
+.no-underline {
+  text-decoration: none !important; // !important To override previous <a> styling
 }
 
-.review {
-  @extend .status;
-  background-color: #f0f7fb;
-  border: solid 1px #3498db;
+.badge:hover {
+  filter: brightness(75%);
+  transition: all 0.25s ease;
 }
 
-.lastcall {
-  @extend .status;
-  background-color: #e7f6f0;
-  border: solid 1px #27ae60;
+h1 {
+  vertical-align: middle;
 }
 
-.stagnant {
-  @extend .status;
-  background-color: #ffdead;
-  border: solid 1px #ff6700;
+h1 a {
+  height: 1em;
+  display: inline-block;
+  vertical-align: baseline;
 }
 
-.withdrawn {
-  @extend .status;
-  background-color: #f9e7e5;
-  border: solid 1px #c0392b;
+.inline-svg {
+  display: inline-block;
+  vertical-align: bottom;
+  fill: currentColor;
+  width: 1.5ex;
+  height: 100%;
+  object-fit: cover;
 }

From e88a96e3f1bee0c803d297ae913407ff8a2976df Mon Sep 17 00:00:00 2001
From: Hugo <jhugodc@gmail.com>
Date: Thu, 26 Jan 2023 12:59:14 -0700
Subject: [PATCH 209/274] Fix total of introduced instructions (#6382)

---
 EIPS/eip-4750.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4750.md b/EIPS/eip-4750.md
index 8dded5a807b6c1..0b621a8ec5d882 100644
--- a/EIPS/eip-4750.md
+++ b/EIPS/eip-4750.md
@@ -49,7 +49,7 @@ Additionally, EVM keeps track of the index of currently executing section - `cur
 
 ### New instructions
 
-We introduce three new instructions:
+We introduce two new instructions:
 
 1. `CALLF` (`0xb0`) - call a function
 2. `RETF` (`0xb1`) - return from a function

From 7338b41e5ccba20536133143c6b1c7c1fec7d653 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ernesto=20Garc=C3=ADa?= <ernestognw@gmail.com>
Date: Fri, 27 Jan 2023 03:08:54 -0600
Subject: [PATCH 210/274] Fix grammar errors (#6387)

---
 EIPS/eip-5805.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/EIPS/eip-5805.md b/EIPS/eip-5805.md
index 6521b4ff3e3b85..024df6d7579e90 100644
--- a/EIPS/eip-5805.md
+++ b/EIPS/eip-5805.md
@@ -24,7 +24,7 @@ Unfortunately, simply using the `balanceOf(address)` function present in most to
 - The values are not checkpointed, so a user can vote, transfer its tokens to a new account, and vote again with the same tokens.
 - A user cannot delegate their voting power to someone else without transferring full ownership of the tokens.
 
-These constraints have led to the emergence of voting tokens with delegation that the following logic:
+These constraints have led to the emergence of voting tokens with delegation that contain the following logic:
 
 - Users can delegate the voting power of their tokens to themselves or a third party. This creates a distinction between balance and voting weight.
 - The voting weights of accounts are checkpointed, allowing lookups for past values at different points in time.
@@ -82,9 +82,9 @@ This function returns a string describing the clock the contract is operating on
 - If operating using **timestamp**, then this function MUST be implemented and return `mode=timestamp`.
 - If operating using any other mode, then this function MUST be implemented and return a unique identifier for the encoded `mode` field.
 
-This function is thus optional, and its absence should be considered as a marker of the contract operating using block numbers, which can be clearly idenfitied from the absence of this function. (This makes this EIP compatible with pre-existing voting contracts).
+This function is thus optional, and its absence should be considered as a marker of the contract operating using block numbers, which can be clearly identified from the absence of this function. (This makes this EIP compatible with pre-existing voting contracts).
 
-Note that when operating using **block number**, the `clock()` is expected to returns the value given by the `NUMBER` opcode (`0x43`). In some cases this can be the block number of another chain (in arbitrum, opcode `0x43` returns the block number of the last recorded operation on the parent chain). A contract can use `from=default` to specify that the block number used is the one provided by the `NUMBER` opcode (`0x43`). If a more explicit description is needed, CAIP-2 blockchain id should be used, as shown in the above.
+Note that when operating using **block number**, the `clock()` is expected to return the value given by the `NUMBER` opcode (`0x43`). In some cases this can be the block number of another chain (in arbitrum, opcode `0x43` returns the block number of the last recorded operation on the parent chain). A contract can use `from=default` to specify that the block number used is the one provided by the `NUMBER` opcode (`0x43`). If a more explicit description is needed, CAIP-2 blockchain id should be used, as shown in the above.
 
 The return string MUST be formatted like a URL query string (a.k.a. `application/x-www-form-urlencoded`). This allows easy decoding in standard JavaScript with `new URLSearchParams(CLOCK_MODE)`.
 
@@ -102,7 +102,7 @@ The return string MUST be formatted like a URL query string (a.k.a. `application
 
 This function returns the current voting weight of an account. This corresponds to all the voting power delegated to it at the moment this function is called.
 
-As tokens delegated to `address(0)` should not be counted/snapshoted, `getVotes(0)` SHOULD always return `0`.
+As tokens delegated to `address(0)` should not be counted/snapshotted, `getVotes(0)` SHOULD always return `0`.
 
 This function MUST be implemented
 
@@ -123,10 +123,10 @@ This function MUST be implemented
 This function returns the historical voting weight of an account. This corresponds to all the voting power delegated to it at a specific timepoint. The timepoint parameter MUST match the operating mode of the contract. This function SHOULD only serve past checkpoints, which SHOULD be immutable.
 
 - Calling this function with a timepoint that is greater or equal to `clock()` SHOULD revert.
-- Calling this function with a timepoint scrictly smaller than `clock()` SHOULD NOT revert.
+- Calling this function with a timepoint strictly smaller than `clock()` SHOULD NOT revert.
 - For any integer that is strictly smaller than `clock()`, the value returned by `getPastVotes` SHOULD be constant. This means that for any call to this function that returns a value, re-executing the same call (at any time in the future) SHOULD return the same value.
 
-As tokens delegated to `address(0)` should not be counted/snapshoted, `getPastVotes(0,x)` SHOULD always return `0` (for all values of `x`).
+As tokens delegated to `address(0)` should not be counted/snapshotted, `getPastVotes(0,x)` SHOULD always return `0` (for all values of `x`).
 
 This function MUST be implemented
 
@@ -214,7 +214,7 @@ A call to `delegateBySig(delegatee, nonce, expiry, v, r, s)` changes the signer'
 - The current timestamp is less than or equal to `expiry`.
 - `nonces(signer)` (before the state update) is equal to `nonce`.
 
-If any of these conditions are not met, the `delegateBySig` call must revert. This translate to the following solidity code:
+If any of these conditions are not met, the `delegateBySig` call must revert. This translates to the following solidity code:
 
 ```sol
 require(expiry <= block.timestamp)
@@ -407,7 +407,7 @@ Delegation allows token holders to trust a delegate with their vote while keepin
 
 The use of checkpoints prevents double voting. Votes, for example in the context of a governance proposal, should rely on a snapshot defined by a timepoint. Only tokens delegated at that timepoint can be used for voting. This means any token transfer performed after the snapshot will not affect the voting power of the sender/receiver's delegate. This also means that in order to vote, someone must acquire tokens and delegate them before the snapshot is taken. Governors can, and do, include a delay between the proposal is submitted and the snapshot is taken so that users can take the necessary actions (change their delegation, buy more tokens, ...).
 
-`clock` returns `uint48` as it is largelly sufficient for storing realistic values. In timestamp mode, `uint48` will be enough until the year 8921556. Even in block number mode, with 10,000 blocks per seconds, it would be enough until the year 2861. Using a type smaller than uint256 allows some storage packing of timepoints with other associated values. Greatly reducing the cost of writting and reading from storage. Depending on the evolution of the blockchain (particularly layer twos), `uint32` might cause issues fairly quickly. On the other hand, anything bigger than `uint48` is overkill.
+`clock` returns `uint48` as it is largely sufficient for storing realistic values. In timestamp mode, `uint48` will be enough until the year 8921556. Even in block number mode, with 10,000 blocks per second, it would be enough until the year 2861. Using a type smaller than uint256 allows some storage packing of timepoints with other associated values. Greatly reducing the cost of writing and reading from storage. Depending on the evolution of the blockchain (particularly layer twos), `uint32` might cause issues fairly quickly. On the other hand, anything bigger than `uint48` is overkill.
 
 While timestamps produced by `clock` are represented as `uint48`, `getPastVotes`'s timepoint argument is `uint256` for backward compatibility. Any timepoint `>=2**48` passed to `getPastVotes` SHOULD cause the function to revert, as it would be a lookup in the future.
 
@@ -415,7 +415,7 @@ While timestamps produced by `clock` are represented as `uint48`, `getPastVotes`
 
 The `nonces` mapping is given for replay protection.
 
-EIP-712 typed messages are included because of its widespread adoption in many wallet providers.
+EIP-712 typed messages are included because of their widespread adoption in many wallet providers.
 
 ## Backwards Compatibility
 

From 3128f3839a8f02c36f56507656fe6fddc9044297 Mon Sep 17 00:00:00 2001
From: Andrei Maiboroda <andrei@ethereum.org>
Date: Mon, 30 Jan 2023 16:00:12 +0100
Subject: [PATCH 211/274] EIP-6206: Fix typos (#6367)

* Update EIP-6206: Change data stack => operand stack

* Update EIP-6206: Fix immediate argument validation condition

* Update EIP-6206: Fixes ins stack height requirements
---
 EIPS/eip-6206.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/EIPS/eip-6206.md b/EIPS/eip-6206.md
index 7252e628ed0201..b8edde0f14791d 100644
--- a/EIPS/eip-6206.md
+++ b/EIPS/eip-6206.md
@@ -26,24 +26,24 @@ A new instruction, `JUMPF (0xb2)`, is introduced.
 ### Execution Semantics
 
 1. `JUMPF` has one immediate argument, `code_section_index`, encoded as a 16-bit unsigned big-endian value.
-2. If the data stack size exceeds `1024 - type[code_section_index].max_stack_height` (i.e. if the called function may exceed the global stack height limit), execution results in an exceptional halt. This guarantees that the stack height after the call is within the limits.
+2. If the operand stack size exceeds `1024 - type[code_section_index].max_stack_height` (i.e. if the called function may exceed the global stack height limit), execution results in an exceptional halt. This guarantees that the stack height after the call is within the limits.
 3. `JUMPF` costs 5 gas.
-4. `JUMPF` neither pops nor pushes anything to the data stack.
+4. `JUMPF` neither pops nor pushes anything to the operand stack.
 
 ### Code Validation
 
-Let the definition of `type[i]` be inherited from [EIP-4750](./eip-4750.md) and define `stack_height` to be the height of the stack at a certain instruction during the instruction flow traversal if the data stack at the start of the function were equal to `type[i].inputs`.
+Let the definition of `type[i]` be inherited from [EIP-4750](./eip-4750.md) and define `stack_height` to be the height of the stack at a certain instruction during the instruction flow traversal if the operand stack at the start of the function were equal to `type[i].inputs`.
 
-* The immediate argument of `JUMPF` MUST be greater than or equal to the total number of code sections.
+* The immediate argument of `JUMPF` MUST be less than the total number of code sections.
 * The stack height at `JUMPF` MUST be greater than or equal to `type[code_section_index].inputs`.
-* `type[current_section_index].outputs` MUST equal `stack_height - type[code_section_index].inputs + type[code_section_index].outputs`. This means that `code_section_index` can output less stack elements than the original code section called by the top element on the return stack if the `current_section_index` code section leaves the delta `type[current_section_index] - type[code_section_index]` element(s) on the stack.
+* `type[current_section_index].outputs` MUST equal `stack_height - type[code_section_index].inputs + type[code_section_index].outputs`. This means that `code_section_index` can output less stack elements than the original code section called by the top element on the return stack if the `current_section_index` code section leaves the delta `type[current_section_index].outputs - type[code_section_index].outputs` element(s) on the stack.
 * The code validation defined in [EIP-4200](./eip-4200.md) also fails if any `RJUMP*` offset points to one of the two bytes directly following a `JUMPF` instruction.
 
 ## Rationale
 
 ### Allowing `JUMPF` to section with less outputs
 
-As long as `JUMPF` prepares the delta `type[current_section_index] - type[code_section_index]` stack elements before changing code sections, it is possible to jump to a section with less outputs than was originally entered via `CALLF`. This will reduce duplicated code as it will allow compilers more flexibility during code generation such that certain helpers can be used generically by functions, regardless of their output values.
+As long as `JUMPF` prepares the delta `type[current_section_index].outputs - type[code_section_index].outputs` stack elements before changing code sections, it is possible to jump to a section with less outputs than was originally entered via `CALLF`. This will reduce duplicated code as it will allow compilers more flexibility during code generation such that certain helpers can be used generically by functions, regardless of their output values.
 
 ## Backwards Compatibility
 

From 404e8ef58077730f2ee1bb2179c45320124d018e Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Mon, 30 Jan 2023 22:00:36 +0100
Subject: [PATCH 212/274] EIP-6220: Update status to Review (#6378)

The proposal is ready to move into Review stage, so we are marking it as
such.
---
 EIPS/eip-6220.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6220.md b/EIPS/eip-6220.md
index f61f15dac27007..d1d215785e14ed 100644
--- a/EIPS/eip-6220.md
+++ b/EIPS/eip-6220.md
@@ -4,7 +4,7 @@ title: Composable NFTs utilizing Equippable Parts
 description: An interface for Composable non-fungible tokens through fixed and slot parts equipping.
 author: Bruno Škvorc (@Swader), Cicada (@CicadaNCR), Steven Pineda (@steven2308), Stevan Bogosavljevic (@stevyhacker), Jan Turk (@ThunderDeliverer)
 discussions-to: https://ethereum-magicians.org/t/eip-6220-composable-nfts-utilizing-equippable-parts/12289
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-12-20

From ee5cf6d50d224b1f569072450fbe3a016b7c4bdc Mon Sep 17 00:00:00 2001
From: Vazi <106611793+DeVaz1@users.noreply.github.com>
Date: Tue, 31 Jan 2023 02:29:49 +0200
Subject: [PATCH 213/274] initial commit for eip-6384 (#6384)

* initial commit for eip-readable-signatures

* Update EIPS/eip-readable-signatures.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* removed build files

* updated links

* updated links

* eip.md updated according to linter suggestions

* updated EIP according to linter

* updated the eip according to the linter

* fixed linter errors at the md file

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* updated signature paramater name to typedDataBuffer

* updated signature paramater name to typedDataBuffer

* added explanation to the rationale section

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6384.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* removed unnecessary media

* removed unnecessary media

* Update EIPS/eip-6384.md

---------

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-6384.md                              | 144 ++++++++++++++++++
 .../implementation/src/IEvalEIP712Buffer.sol  |   9 ++
 .../implementation/src/MyToken/MyToken.sol    |  62 ++++++++
 .../src/MyToken/MyToken712ParserHelper.sol    |  35 +++++
 .../src/MyToken/MyTokenStructs.sol            |  10 ++
 .../src/SeaPort/SeaPort712ParserHelper.sol    | 113 ++++++++++++++
 .../src/SeaPort/SeaPortMock.sol               |  39 +++++
 .../src/SeaPort/SeaPortStructs.sol            |  61 ++++++++
 .../implementation/test/MyToken.t.sol         |  71 +++++++++
 .../implementation/test/OrderGenerator.sol    |  34 +++++
 .../test/SeaPort712Parser.t.sol               |  26 ++++
 .../eip-6384/implementation/test/SigUtils.sol |  31 ++++
 .../media/MiceyMask-non-compliant.png         | Bin 0 -> 278862 bytes
 assets/eip-6384/media/ZenGo-EIP-compliant.png | Bin 0 -> 240406 bytes
 14 files changed, 635 insertions(+)
 create mode 100644 EIPS/eip-6384.md
 create mode 100644 assets/eip-6384/implementation/src/IEvalEIP712Buffer.sol
 create mode 100644 assets/eip-6384/implementation/src/MyToken/MyToken.sol
 create mode 100644 assets/eip-6384/implementation/src/MyToken/MyToken712ParserHelper.sol
 create mode 100644 assets/eip-6384/implementation/src/MyToken/MyTokenStructs.sol
 create mode 100644 assets/eip-6384/implementation/src/SeaPort/SeaPort712ParserHelper.sol
 create mode 100644 assets/eip-6384/implementation/src/SeaPort/SeaPortMock.sol
 create mode 100644 assets/eip-6384/implementation/src/SeaPort/SeaPortStructs.sol
 create mode 100644 assets/eip-6384/implementation/test/MyToken.t.sol
 create mode 100644 assets/eip-6384/implementation/test/OrderGenerator.sol
 create mode 100644 assets/eip-6384/implementation/test/SeaPort712Parser.t.sol
 create mode 100644 assets/eip-6384/implementation/test/SigUtils.sol
 create mode 100644 assets/eip-6384/media/MiceyMask-non-compliant.png
 create mode 100644 assets/eip-6384/media/ZenGo-EIP-compliant.png

diff --git a/EIPS/eip-6384.md b/EIPS/eip-6384.md
new file mode 100644
index 00000000000000..966af6fe0b0ac7
--- /dev/null
+++ b/EIPS/eip-6384.md
@@ -0,0 +1,144 @@
+---
+eip: 6384
+title: Human-readable offline signatures
+description: A method for retrieving a human-readable description of EIP-712 typed and structured data.
+author: Tal Be'ery (@talbeerysec), RoiV (@DeVaz1)
+discussions-to: https://ethereum-magicians.org/t/eip-6384-readable-eip-712-signatures/12752
+status: Draft
+type: Standards Track
+category: ERC
+created: 2023-01-08
+requires: 712
+---
+
+## Abstract
+
+This EIP introduces the `evalEIP712Buffer` function, which takes an [EIP-712](./eip-712.md) buffer and returns a human-readable text description.
+
+## Motivation
+
+The use case of Web3 off-chain signatures intended to be used within on-chain transaction is gaining traction and being used in multiple leading protocols (e.g. OpenSea) and standards [EIP-2612](./eip-2612.md), mainly as it offers a fee-less experience.
+Attackers are known to actively and successfully abuse such off-chain signatures, leveraging the fact that users are blindly signing off-chain messages, since they are not humanly readable.
+While [EIP-712](./eip-712.md) originally declared in its title that being ”humanly readable” is one of its goals, it did not live up to its promise eventually and EIP-712 messages are not understandable by an average user.
+
+In one example, victims browse a malicious phishing website. It requests the victim to sign a message that will put their NFT token for sale on OpenSea platform, virtually for free.
+
+The user interface for some popular wallet implementations is not conveying the actual meaning of signing such transactions.
+
+In this proposal we offer a secure and scalable method to bring true human readability to EIP-712 messages by leveraging their bound smart contracts.
+As a result, once implemented this EIP wallets can upgrade their user experience from current state:
+
+![](../assets/eip-6384/media/MiceyMask-non-compliant.png)
+
+to a much clearer user experience:
+
+![](../assets/eip-6384/media/ZenGo-EIP-compliant.png)
+
+The proposed solution solves the readability issues by allowing the wallet to query the `verifyingContract`. The incentives for keeping the EIP-712 message description as accurate as possible are aligned, as the responsibility for the description is now owned by the contract, that:
+
+- Knows the message meaning exactly (and probably can reuse the code that handles this message when received on chain)
+- Natively incentivized to provide the best explanation to prevent a possible fraud
+- Not involving a third party that needs to be trusted
+- Maintains the fee-less customer experience as the added function is in “view” mode and does not require an on-chain execution and fees.
+- Maintains Web3’s composability property
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
+
+EIP-712 already formally binds an off-chain signature to a contract, with the `verifyingContract` parameter. We suggest adding a “view” function (`"stateMutability":"view"`) to such contracts, that returns a human readable description of the meaning of this specific off-chain buffer.
+
+```solidity
+/**
+ * @dev Returns the expected result of the offchain message.
+*/
+
+     function evalEIP712Buffer(bytes32 domainHash, string memory primaryType, bytes memory typedDataBuffer)
+     external
+     view
+     returns (string[] memory) {
+   ...
+
+}
+```
+
+**Every compliant contract MUST implement this function.**
+
+Using this function, wallets can submit the proposed off-chain signature to the contract and present the results to the user, allowing them to enjoy an “on-chain simulation equivalent” experience to their off-chain message.
+
+This function will have a well known name and signature, such that there is no need for updates in the EIP-712 structure.
+
+### Function's inputs
+
+The inputs of the function:
+
+- `domainHash` is the EIP-712's domainSeparator, a hashed `eip712Domain` struct.
+- `primaryType`is the EIP-712's `primaryType`.
+- `typedDataBuffer` is an ABI encoded message part of the EIP-712 full message.
+
+### Function's output(s)
+
+The output of the the function is an array of strings. The wallet SHOULD display them to its end-users. The wallet MAY choose to augment the returned strings with additional data. (e.g. resolve contract addresses to their name)
+
+The strings SHOULD NOT be formatted (e.g. should not contain HTML code) and wallets SHOULD treat this string as an untrusted input and handle its rendering as such.
+
+### Support for EIP-712 messages that are not meant to be used on-chain
+
+If `verifyingContract` is not included in the EIP-712 domain separator, wallets MUST NOT retrieve a human-readable description using this EIP. In this case, wallets SHOULD fallback to their original EIP-712 display.
+
+## Rationale
+
+- We chose to implement the `typeDataBuffer` parameter as abi encoded as it is a generic way to pass the data to the contract. The alternative was to pass the `typedData` struct, which is not generic as it requires the contract to specify the message data.
+- We chose to return an array of strings and not a single string as there are potential cases where the message is composed of multiple parts. For example, in the case of a multiple assets transfers in the same `typedDataBuffer`, the contract is advised to describe each transfer in a separate string to allow the wallet to display each transfer separately.
+
+### Alternative solutions
+
+#### Third party services:
+
+Currently, the best choice for users is to rely on some 3rd party solutions that get the proposed message as input and explain its intended meaning to the user. This approach is:
+
+- Not scalable: 3rd party provider needs to learn all such proprietary messages
+- Not necessarily correct: the explanation is based on 3rd party interpretation of the original message author
+- Introduces an unnecessary dependency of a third party which may have some operational, security, and privacy implications.
+
+#### Domain name binding
+
+Alternatively, wallets can bind domain name to a signature. i.e. only accept EIP-712 message if it comes from a web2 domain that its `name` as defined by EIP-712 is included in `eip712Domain`. However this approach has the following disadvantages:
+
+- It breaks Web3’s composability, as now other dapps cannot interact with such messages
+- Does not protect against bad messages coming from the specified web2 domain, e.g. when web2 domain is hacked
+- Some current connector, such as WalletConnect do not allow wallets to verify the web2 domain authenticity
+
+## Backwards Compatibility
+
+For non-supporting contracts the wallets will default to showing whatever they are showing today.
+Non-supporting wallets will not call this function and will default to showing whatever they are showing today.
+
+## Reference Implementation
+
+A reference implementation can be found [here](../assets/eip-6384/implementation/src/MyToken/MyToken.sol).
+This toy example shows how an [EIP-20](./eip-20.md) contract supporting this EIP implements an EIP-712 support for "transferWithSig" functionality (a non-standard variation on Permit, as the point of this EIP is to allow readability to non-standard EIP-712 buffers).
+To illustrate the usability of this EIP to some real world use case, a helper function for the actual OpenSea's SeaPort EIP-712 is implemented too in [here](../assets/eip-6384/implementation/src/SeaPort/SeaPort712ParserHelper.sol).
+
+## Security Considerations
+
+### The threat model:
+
+The attack is facilitated by a rogue web2 interface (“dapp”) that provides bad parameters for an EIP-712 formatted message that is intended to be consumed by a legitimate contract. Therefore, the message is controlled by attackers and cannot be trusted, however the contract is controlled by a legitimate party and can be trusted.
+
+The attacker intends to use that signed EIP-712 message on-chain later on, with a transaction crafted by the attackers. If the subsequent on-chain transaction was to be sent by the victim, then a regular transaction simulation would have sufficed.
+
+The case of a rogue contract is irrelevant, as such a rogue contract can already facilitate the attack regardless of the existence of the EIP-712 formatted message.
+
+Having said that, a rogue contract may try to abuse this functionality in order to send some maliciously crafted string in order to exploit vulnerabilities in wallet rendering of the string. Therefore wallets should treat this string as an untrusted input and handle its renderring it as such.
+
+### Analysis of the proposed solution
+
+The explanation is controlled by the relevant contract which is controlled by a legitimate party. The attacker must specify the relevant contract address, as otherwise it will not be accepted by it. Therefore, the attacker cannot create false explanations using this method.
+Please note that if the explanation was part of the message to sign it would have been under the control of the attacker and hence irrelevant for security purposes.
+
+Since the added functionality to the contract has the “view” modifier, it cannot change the on-chain state and harm the existing functionalities of the contract.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-6384/implementation/src/IEvalEIP712Buffer.sol b/assets/eip-6384/implementation/src/IEvalEIP712Buffer.sol
new file mode 100644
index 00000000000000..2fcaf2917fffd6
--- /dev/null
+++ b/assets/eip-6384/implementation/src/IEvalEIP712Buffer.sol
@@ -0,0 +1,9 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
+
+interface IEvalEIP712Buffer {
+    function evalEIP712Buffer(bytes32 domainHash, string memory primaryType, bytes memory typedDataBuffer)
+        external
+        view
+        returns (string[] memory);
+}
diff --git a/assets/eip-6384/implementation/src/MyToken/MyToken.sol b/assets/eip-6384/implementation/src/MyToken/MyToken.sol
new file mode 100644
index 00000000000000..f3d479b34c5c31
--- /dev/null
+++ b/assets/eip-6384/implementation/src/MyToken/MyToken.sol
@@ -0,0 +1,62 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
+
+import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
+import "@openzeppelin/contracts/utils/cryptography/EIP712.sol";
+import "@openzeppelin/contracts/utils/cryptography/ECDSA.sol";
+import {IEvalEIP712Buffer} from "../IEvalEIP712Buffer.sol";
+import {MyToken712ParserHelper} from "./MyToken712ParserHelper.sol";
+import {TransferParameters} from "./MyTokenStructs.sol";
+
+contract MyToken is ERC20, EIP712, IEvalEIP712Buffer {
+    mapping(address => uint256) private _nonces;
+    address public eip712TransalatorContract;
+
+    bytes32 private constant TYPE_HASH =
+        keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");
+
+    bytes32 private constant TRANSFER_TYPEHASH =
+        keccak256("Transfer(address from,address to,uint256 amount,uint256 nonce,uint256 deadline)");
+
+    constructor(address _eip712Transaltor) ERC20("MyToken", "MT") EIP712("MyToken", "1") {
+        eip712TransalatorContract = _eip712Transaltor;
+        _mint(msg.sender, 1e18);
+    }
+
+    function mintToCaller() public {
+        _mint(msg.sender, 1e18);
+    }
+
+    function nonces(address owner) public view returns (uint256) {
+        return _nonces[owner];
+    }
+
+    function transferWithSig(address from, address to, uint256 amount, uint256 deadline, uint8 r, bytes32 v, bytes32 s)
+        public
+    {
+        require(block.timestamp <= deadline, "TransferSig: expired deadline");
+        bytes32 structHash = keccak256(abi.encode(TRANSFER_TYPEHASH, from, to, amount, _nonces[from]++, deadline));
+        // _hashTypedDataV4 is a helper function from EIP712.sol that gets the strcutHash and uses the domain separator in order to hash the message
+        bytes32 hash = _hashTypedDataV4(structHash);
+        address signer = ECDSA.recover(hash, r, v, s);
+        require(signer == from, "TransferSig: unauthorized");
+        _transfer(from, to, amount);
+    }
+
+    function DOMAIN_SEPARATOR() public view returns (bytes32) {
+        return _domainSeparatorV4();
+    }
+
+    function evalEIP712Buffer(
+        bytes32 domainSeparator,
+        string memory primaryType,
+        bytes memory typedDataBuffer
+    ) public view override returns (string[] memory) {
+        require(
+            keccak256(abi.encodePacked(primaryType)) == keccak256(abi.encodePacked("Transfer")),
+            "MyToken: invalid primary type"
+        );
+        require(domainSeparator == _domainSeparatorV4(), "MyToken: Invalid domain");
+        return MyToken712ParserHelper(eip712TransalatorContract).parseSig(encodedData);
+    }
+}
diff --git a/assets/eip-6384/implementation/src/MyToken/MyToken712ParserHelper.sol b/assets/eip-6384/implementation/src/MyToken/MyToken712ParserHelper.sol
new file mode 100644
index 00000000000000..8b808455199a17
--- /dev/null
+++ b/assets/eip-6384/implementation/src/MyToken/MyToken712ParserHelper.sol
@@ -0,0 +1,35 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
+
+import "src/MyToken/MyToken.sol";
+import "@openzeppelin/contracts/utils/Strings.sol";
+
+contract MyToken712ParserHelper {
+    string sigMessage =
+        "This is MyToken transferWithSig message, by signing this message you are authorizing the transfer of MyToken from your account to the recipient account.";
+
+    struct Transfer {
+        address from;
+        address to;
+        uint256 amount;
+        uint256 nonce;
+        uint256 deadline;
+    }
+
+    function parseSig(bytes memory signature) public view returns (string[] memory sigTranslatedMessage) {
+        Transfer memory transfer = abi.decode(signature, (Transfer));
+        sigTranslatedMessage = new string[](3);
+        sigTranslatedMessage[0] = sigMessage;
+        sigTranslatedMessage[1] = Strings.toString(transfer.deadline);
+        sigTranslatedMessage[2] = string(
+            abi.encodePacked(
+                "By signing this message you allow ",
+                Strings.toHexString(transfer.to),
+                " to transfer ",
+                Strings.toString(transfer.amount),
+                " of MyToken from your account."
+            )
+        );
+        return sigTranslatedMessage;
+    }
+}
diff --git a/assets/eip-6384/implementation/src/MyToken/MyTokenStructs.sol b/assets/eip-6384/implementation/src/MyToken/MyTokenStructs.sol
new file mode 100644
index 00000000000000..a78f3a05dc7967
--- /dev/null
+++ b/assets/eip-6384/implementation/src/MyToken/MyTokenStructs.sol
@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
+
+struct TransferParameters {
+    address from;
+    address to;
+    uint256 amount;
+    uint256 nonce;
+    uint256 deadline;
+}
diff --git a/assets/eip-6384/implementation/src/SeaPort/SeaPort712ParserHelper.sol b/assets/eip-6384/implementation/src/SeaPort/SeaPort712ParserHelper.sol
new file mode 100644
index 00000000000000..f5487613e76db8
--- /dev/null
+++ b/assets/eip-6384/implementation/src/SeaPort/SeaPort712ParserHelper.sol
@@ -0,0 +1,113 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
+
+import {ItemType, OrderType, OfferItem, ConsiderationItem, OrderComponents} from "src/SeaPort/SeaPortStructs.sol";
+import "@openzeppelin/contracts/utils/Strings.sol";
+
+contract SeaPort712ParserHelper {
+    bytes32 private domainSeperator = keccak256(
+        abi.encodePacked("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)")
+    );
+
+    string sigMessage =
+        "This is a Seaport listing message, mostly used by OpenSea Dapp, be aware of the potential balance changes";
+
+    struct BalanceOut {
+        uint256 amount;
+        address token;
+    }
+
+    struct BalanceIn {
+        uint256 amount;
+        address token;
+    }
+
+    function getTokenNameByAddress(address _token) private view returns (string memory) {
+        if (_token == address(0)) {
+            return "ETH";
+        } else {
+            (bool success, bytes memory returnData) = _token.staticcall(abi.encodeWithSignature("name()"));
+            if (success && returnData.length > 0) {
+                return string(returnData);
+            } else {
+                return "Unknown";
+            }
+        }
+    }
+
+    // need to manage array length because of the fact that default array values are 0x0 which represents 'native token'
+    function getElementIndexInArray(address addressToSearch, uint256 arrayLength, address[] memory visitedAddresses)
+        private
+        pure
+        returns (uint256)
+    {
+        for (uint256 i; i < arrayLength; i++) {
+            if (addressToSearch == visitedAddresses[i]) {
+                return i;
+            }
+        }
+        return visitedAddresses.length + 1;
+    }
+
+    function parseSig(bytes memory signature) public view returns (string[] memory sigTranslatedMessage) {
+        OrderComponents memory order = abi.decode(signature, (OrderComponents));
+        BalanceOut[] memory tempBalanceOut = new BalanceOut[](order.offer.length);
+        BalanceIn[] memory tempBalanceIn = new BalanceIn[](order.consideration.length);
+        address[] memory outTokenAddresses = new address[](order.offer.length);
+        address[] memory inTokenAddresses = new address[](order.consideration.length);
+
+        uint256 outLength;
+        for (uint256 i; i < order.offer.length; i++) {
+            uint256 index = getElementIndexInArray(order.offer[i].token, outLength, outTokenAddresses);
+            if (index != outTokenAddresses.length + 1) {
+                tempBalanceOut[index].amount += order.offer[i].startAmount;
+            } else {
+                outTokenAddresses[outLength] = order.offer[i].token;
+                tempBalanceOut[outLength] = BalanceOut(order.offer[i].startAmount, order.offer[i].token);
+                outLength++;
+            }
+        }
+
+        uint256 inLength;
+        for (uint256 i; i < order.consideration.length; i++) {
+            if (order.offerer == order.consideration[i].recipient) {
+                uint256 index = getElementIndexInArray(order.consideration[i].token, inLength, inTokenAddresses);
+                if (index != inTokenAddresses.length + 1) {
+                    tempBalanceIn[index].amount += order.consideration[i].startAmount;
+                } else {
+                    inTokenAddresses[inLength] = order.consideration[i].token;
+                    tempBalanceIn[inLength] =
+                        BalanceIn(order.consideration[i].startAmount, order.consideration[i].token);
+                    inLength++;
+                }
+            }
+        }
+
+        sigTranslatedMessage = new string[](outLength + inLength + 2);
+        sigTranslatedMessage[0] = sigMessage;
+        sigTranslatedMessage[1] =
+            string(abi.encodePacked("The signature is valid until ", Strings.toString(order.endTime)));
+        for (uint256 i; i < inLength; i++) {
+            sigTranslatedMessage[i + 2] = string(
+                abi.encodePacked(
+                    "You will receive ",
+                    Strings.toString(tempBalanceIn[i].amount),
+                    " of ",
+                    getTokenNameByAddress(tempBalanceIn[i].token)
+                )
+            );
+        }
+
+        for (uint256 i; i < outLength; i++) {
+            sigTranslatedMessage[i + inLength + 2] = string(
+                abi.encodePacked(
+                    "You will send ",
+                    Strings.toString(tempBalanceOut[i].amount),
+                    " of ",
+                    getTokenNameByAddress(tempBalanceOut[i].token)
+                )
+            );
+        }
+        return (sigTranslatedMessage);
+    }
+}
diff --git a/assets/eip-6384/implementation/src/SeaPort/SeaPortMock.sol b/assets/eip-6384/implementation/src/SeaPort/SeaPortMock.sol
new file mode 100644
index 00000000000000..73c374fcd38c6a
--- /dev/null
+++ b/assets/eip-6384/implementation/src/SeaPort/SeaPortMock.sol
@@ -0,0 +1,39 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
+
+import "src/IEvalEIP712Buffer.sol";
+import {ItemType, OrderType, OfferItem, ConsiderationItem, OrderComponents} from "src/SeaPort/SeaPortStructs.sol";
+import {SeaPort712ParserHelper} from "src/SeaPort/SeaPort712ParserHelper.sol";
+
+contract SeaPortMock is IEvalEIP712Buffer {
+    address public immutable eip712TransalatorContract;
+
+    bytes32 private constant TYPE_HASH =
+        keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");
+
+    constructor(address _translator) {
+        eip712TransalatorContract = _translator;
+    }
+
+    // SeaPort logic
+
+    function evalEIP712Buffer(
+        bytes32 domainSeparator,
+        string memory primaryType,
+        bytes memory typedDataBuffer
+    ) public view override returns (string[] memory) {
+        require(
+            keccak256(abi.encodePacked(primaryType)) == keccak256(abi.encodePacked("OrderComponents")),
+            "SeaPortMock: Invalid primary type"
+        );
+        require(domainSeparator == DOMAIN_SEPARATOR(), "SeaPortMock: Invalid domain");
+        return SeaPort712ParserHelper(eip712TransalatorContract).parseSig(encodedSignature);
+    }
+
+    function DOMAIN_SEPARATOR() public view returns (bytes32) {
+        // prettier-ignore
+        return keccak256(
+            abi.encode(TYPE_HASH, keccak256(bytes("Seaport")), keccak256(bytes("1.1")), block.chainid, address(this))
+        );
+    }
+}
diff --git a/assets/eip-6384/implementation/src/SeaPort/SeaPortStructs.sol b/assets/eip-6384/implementation/src/SeaPort/SeaPortStructs.sol
new file mode 100644
index 00000000000000..3d19f6b8fd107f
--- /dev/null
+++ b/assets/eip-6384/implementation/src/SeaPort/SeaPortStructs.sol
@@ -0,0 +1,61 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
+
+enum ItemType
+// 0: ETH on mainnet, MATIC on polygon, etc.
+{
+    NATIVE,
+    // 1: ERC20 items (ERC777 and ERC20 analogues could also technically work)
+    ERC20,
+    // 2: ERC721 items
+    ERC721,
+    // 3: ERC1155 items
+    ERC1155,
+    // 4: ERC721 items where a number of tokenIds are supported
+    ERC721_WITH_CRITERIA,
+    // 5: ERC1155 items where a number of ids are supported
+    ERC1155_WITH_CRITERIA
+}
+
+enum OrderType
+// 0: no partial fills, anyone can execute
+{
+    FULL_OPEN,
+    // 1: partial fills supported, anyone can execute
+    PARTIAL_OPEN,
+    // 2: no partial fills, only offerer or zone can execute
+    FULL_RESTRICTED,
+    // 3: partial fills supported, only offerer or zone can execute
+    PARTIAL_RESTRICTED
+}
+
+struct OfferItem {
+    ItemType itemType;
+    address token;
+    uint256 identifierOrCriteria;
+    uint256 startAmount;
+    uint256 endAmount;
+}
+
+struct ConsiderationItem {
+    ItemType itemType;
+    address token;
+    uint256 identifierOrCriteria;
+    uint256 startAmount;
+    uint256 endAmount;
+    address payable recipient;
+}
+
+struct OrderComponents {
+    address offerer;
+    address zone;
+    OfferItem[] offer;
+    ConsiderationItem[] consideration;
+    OrderType orderType;
+    uint256 startTime;
+    uint256 endTime;
+    bytes32 zoneHash;
+    uint256 salt;
+    bytes32 conduitKey;
+    uint256 counter;
+}
diff --git a/assets/eip-6384/implementation/test/MyToken.t.sol b/assets/eip-6384/implementation/test/MyToken.t.sol
new file mode 100644
index 00000000000000..2d6d750ba24cda
--- /dev/null
+++ b/assets/eip-6384/implementation/test/MyToken.t.sol
@@ -0,0 +1,71 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
+
+import "forge-std/Test.sol";
+import {MyToken, IEvalEIP712Buffer} from "src/MyToken/MyToken.sol";
+import {TransferParameters} from "src/MyToken/MyTokenStructs.sol";
+import {MyToken712ParserHelper} from "src/MyToken/MyToken712ParserHelper.sol";
+import {SigUtils} from "./SigUtils.sol";
+
+contract MyTokenTest is Test {
+    MyToken myToken;
+    MyToken712ParserHelper myToken712ParserHelper;
+    SigUtils sigUtils;
+    uint256 internal ownerPrivateKey;
+    uint256 internal toPrivateKey;
+
+    address internal owner;
+    address internal to;
+
+    bytes32 private constant TYPE_HASH =
+        keccak256("EIP712Domain(string name,string version,uint256 chainId,address verifyingContract)");
+
+    function setUp() public {
+        myToken712ParserHelper = new MyToken712ParserHelper();
+        myToken = new MyToken(address(myToken712ParserHelper));
+        sigUtils = new SigUtils(myToken.DOMAIN_SEPARATOR());
+        ownerPrivateKey = 0xA11CE;
+        toPrivateKey = 0xB0B;
+        owner = vm.addr(ownerPrivateKey);
+        to = vm.addr(toPrivateKey);
+        vm.prank(owner);
+        myToken.mintToCaller();
+    }
+
+    function testNonce() public {
+        uint256 currentNonce = myToken.nonces(address(this));
+    }
+
+    function test_Transfer() public {
+        TransferParameters memory transfer = generateSigPayload();
+        bytes32 digest = sigUtils.getTypedDataHash(transfer);
+        (uint8 v, bytes32 r, bytes32 s) = vm.sign(ownerPrivateKey, digest);
+        console.log(myToken.balanceOf(owner));
+
+        myToken.transferWithSig(transfer.from, transfer.to, transfer.amount, transfer.deadline, v, r, s);
+        console.log(myToken.balanceOf(owner));
+        assertEq(myToken.balanceOf(owner), 0);
+    }
+
+    function testEvalEIP712BufferTransfer() public view {
+        //SigUtils.Transfer memory transferPayload = generateSigPayload();
+        TransferParameters memory transferPayload = generateSigPayload();
+        bytes memory encodedTransfer = abi.encode(transferPayload);
+        string[] memory translatedSig = myToken.evalEIP712Buffer(myToken.DOMAIN_SEPARATOR(), "Transfer", encodedTransfer);
+        for (uint256 i = 0; i < translatedSig.length; i++) {
+            console.log(translatedSig[i]);
+        }
+    }
+
+    function generateSigPayload() public view returns (TransferParameters memory transfer) {
+        transfer = TransferParameters({
+            from: owner,
+            to: to,
+            amount: myToken.balanceOf(owner),
+            nonce: myToken.nonces(owner),
+            deadline: block.timestamp + 1000
+        });
+        //transfer = My
+        return transfer;
+    }
+}
diff --git a/assets/eip-6384/implementation/test/OrderGenerator.sol b/assets/eip-6384/implementation/test/OrderGenerator.sol
new file mode 100644
index 00000000000000..bb31a20cf17457
--- /dev/null
+++ b/assets/eip-6384/implementation/test/OrderGenerator.sol
@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
+
+import {ItemType, OrderType, OfferItem, ConsiderationItem, OrderComponents} from "src/SeaPort/SeaPortStructs.sol";
+
+contract OrderGenerator {
+    function generateOrder() public view returns (OrderComponents memory) {
+        OrderComponents memory order;
+        order.orderType = OrderType.FULL_OPEN;
+        order.offerer = msg.sender;
+        order.zone = address(0);
+        order.startTime = block.timestamp;
+        order.endTime = block.timestamp + 1000;
+        order.salt = 100;
+        order.conduitKey = bytes32(0);
+        order.counter = 1;
+
+        order.offer = new OfferItem[](1);
+        order.offer[0].token = 0x696383fc9C5C8568C2E7aF8731279b58B9201394;
+        order.offer[0].itemType = ItemType.ERC721;
+        order.offer[0].startAmount = 1;
+        order.offer[0].endAmount = 1;
+        order.offer[0].identifierOrCriteria = 9243;
+
+        order.consideration = new ConsiderationItem[](1);
+        order.consideration[0].itemType = ItemType.NATIVE;
+        order.consideration[0].token = address(0);
+        order.consideration[0].identifierOrCriteria = 0;
+        order.consideration[0].startAmount = 0;
+        order.consideration[0].endAmount = 0;
+        order.consideration[0].recipient = payable(msg.sender);
+        return order;
+    }
+}
diff --git a/assets/eip-6384/implementation/test/SeaPort712Parser.t.sol b/assets/eip-6384/implementation/test/SeaPort712Parser.t.sol
new file mode 100644
index 00000000000000..390feccca84171
--- /dev/null
+++ b/assets/eip-6384/implementation/test/SeaPort712Parser.t.sol
@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.17;
+
+import {SeaPort712ParserHelper} from "src/SeaPort/SeaPort712ParserHelper.sol";
+import {IEvalEIP712Buffer, SeaPortMock} from "src/SeaPort/SeaPortMock.sol";
+import "test/OrderGenerator.sol";
+import "forge-std/Test.sol";
+
+contract SeaPort712ParserTest is Test, OrderGenerator {
+    SeaPortMock seaPortMock;
+    SeaPort712ParserHelper seaPort712ParserHelper;
+
+    function setUp() public {
+        seaPort712ParserHelper = new SeaPort712ParserHelper();
+        seaPortMock = new SeaPortMock(address(seaPort712ParserHelper));
+    }
+
+    function testEvalEIP712BufferSeaport() public view {
+        OrderComponents memory order = generateOrder();
+        bytes memory encodedOrder = abi.encode(order);
+        string[] memory translatedSig = seaPortMock.evalEIP712Buffer(seaPortMock.DOMAIN_SEPARATOR(), "OrderComponents", encodedOrder);
+        for (uint256 i = 0; i < translatedSig.length; i++) {
+            console.log(translatedSig[i]);
+        }
+    }
+}
diff --git a/assets/eip-6384/implementation/test/SigUtils.sol b/assets/eip-6384/implementation/test/SigUtils.sol
new file mode 100644
index 00000000000000..970e215b6f857c
--- /dev/null
+++ b/assets/eip-6384/implementation/test/SigUtils.sol
@@ -0,0 +1,31 @@
+// SPDX-License-Identifier: MIT
+pragma solidity 0.8.17;
+
+import {TransferParameters} from "src/MyToken/MyTokenStructs.sol";
+
+contract SigUtils {
+    bytes32 internal DOMAIN_SEPARATOR;
+
+    constructor(bytes32 _DOMAIN_SEPARATOR) {
+        DOMAIN_SEPARATOR = _DOMAIN_SEPARATOR;
+    }
+
+    // keccak256("Permit(address owner,address spender,uint256 value,uint256 nonce,uint256 deadline)");
+    //bytes32 public constant PERMIT_TYPEHASH = 0x6e71edae12b1b97f4d1f60370fef10105fa2faae0126114a169c64845d6126c9;
+    bytes32 public constant TRANSFER_TYPEHASH =
+        keccak256("Transfer(address from,address to,uint256 amount,uint256 nonce,uint256 deadline)");
+
+    // computes the hash of a permit
+    function getStructHash(TransferParameters memory _transfer) internal pure returns (bytes32) {
+        return keccak256(
+            abi.encode(
+                TRANSFER_TYPEHASH, _transfer.from, _transfer.to, _transfer.amount, _transfer.nonce, _transfer.deadline
+            )
+        );
+    }
+
+    // computes the hash of the fully encoded EIP-712 message for the domain, which can be used to recover the signer
+    function getTypedDataHash(TransferParameters memory _transfer) public view returns (bytes32) {
+        return keccak256(abi.encodePacked("\x19\x01", DOMAIN_SEPARATOR, getStructHash(_transfer)));
+    }
+}
diff --git a/assets/eip-6384/media/MiceyMask-non-compliant.png b/assets/eip-6384/media/MiceyMask-non-compliant.png
new file mode 100644
index 0000000000000000000000000000000000000000..b1cc4bba9608be5f1dd5a0afd9e6b26753cff38c
GIT binary patch
literal 278862
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%0AwHGTQ82E3;54pD!R3vvEvQ@z%K{wljAu;6x
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

literal 0
HcmV?d00001

diff --git a/assets/eip-6384/media/ZenGo-EIP-compliant.png b/assets/eip-6384/media/ZenGo-EIP-compliant.png
new file mode 100644
index 0000000000000000000000000000000000000000..eef608bc6d1d73fd73f2f1223704f15fa67946fd
GIT binary patch
literal 240406
zcmZsC1y~eo|2EPgozh5yluD;`ilFoYQUX#-Hwe;=fFLcY0!zcv4I-`5xil=@%{P0_
z`=0mU|Kqxr9cJcv=850@;=XUfUp!a9#iqnYLPEk-Qk2z1LP7x{Az=t%q623h4fUiU
zA>FsOmXUd(BqKxr!pY%{wXFpbl45w04u<Z_Ub0Ms4{>qB$b@l3Uc|Cq@kG**^z<~g
zK}>NkOjR*C+$=QOsw3I7i^Fn?IO!uJCi-$FE=`}w>5=0^<Q%Y|xy<S`yEi-RTnRg`
zN-{q=9Yo5W?MqTTctL}7(1rH%ER5jITYZs)qx<woXsNCDbsaq)V{vkGQ%XHpzvbR_
zkg{RZ$sh&YQs0*5^pJn|K%!rwA6)M9I42N9c~`ool!t~yK<ZV*jz)x*iBjH7f{wY*
zfi|cOGsI5++ODRY*6AV8nS5_J+o|rSEmGCaGx5r}WL(cG37IX9)yPgHEByCDajeS+
z4BDL%k0kv+AnQok;%_q(ba=c|Uv*EP^j{jHUS4ym#3<+B$+rrMF#jO7Q*~SU^w!|u
za2Z9y)+84@KYl;r$^_S8<#~kWYmQFC#r_msxe|sQ(tRyg45WO_m3So%@83bJW*ryz
z&^sYM_EsdFECivEho(8B7yXYkgfL8@`omvyke@&73?bkl`QA?STOchzVR5v1xc(7)
zTK-tpigJ=4X*2D2=LFriH-ggl6b53gNwJ7u(iceC8nP+J1nA<JlIz(^Cr-UFkB_5y
z@|rQJhjXzuM97Ff22*3-ELiX7o=3H>b+awKv2Epx&Tx$-6twnEMJ?a51Tn~CzZ4ud
zJ^DAyxO<r9Uq?{t_Rv0?e48m>Lw3{*OfA&WBp@nHjeN=E>G;-rMl+85^RR*R76Yg1
zi=nOroQ1_#`%8Ks0->^6=^h$*?yu50Xnh`pq1zH*r%2%$u%w_mz57yK)QoeZ86AYe
z9T#Xzk2Lsppf!qQC5%FXSc>qB_~E@c+(8_T7;Gtq-~JDNf6E-CR}t3#k{*wfDV>g=
zBSm|~r87u`@1=sSo-KcbzYCi1;GGkjAX&OKlFYs?FnOj{rO!yW_x(3*8B++MOn7`J
zI0wZ(3S;rc<EamN$7;ysLNkh|PbI4ua}^;iA%u7etClrlRmnfh>8Vxd6>L-A+|L+i
zhRn%pk--DWJhWd3MG$=uigDD@{yy7M{fkA>lJ=|MbClEh$7eh9FQ(%Sd)YiOg;Q*A
zmsGhFxQ3pQ$(6K}#&V4Hw|P}!DEJ)>-9RpUCKRr%!nr!}OfAcnCWMQziZE2SD8}9y
zcE+&nEo^$_fDBRQ7L)durD;bbuN+4uNRtxl#-MKXe%jHbm<42P0<_*A%u`<_ay@!o
zu`vFubvewFyCcOOV!wmL*3AEHeB2=9fGUu8(Er!KDLQ>Nw56qGBaQp5C=$l6g_D*O
zHOo`N=G+n_p@w+YWU_BA(8Xu(9I))5zoJOy`Cj86I-(f0(xJZR<;Cs{l#N4YY30Cy
zi6jTIzeZ2NQI>k3i?03N^)>MXwp&2c0@4=@wFMy|T<&*$3nEY)9d!&3tok<Z;ZS-^
ztj`QCotS(Iwgjx5xckqL<9V4V!xetU-DjdAWOOn|e@w?NqfHNw<5J{5z;U7wj!Bo9
zikto}lSl0N-bb1*F=8{f;0u=s_3<-3E0WZ(7=_A_UMoWVDDG#R!yGR7`k}N6JlW$T
zZb!^h@9(J+o4qDWd9wPxyj=GYO<#N7#G_&o&Yo{&`o)AdLptSd#W<H?#Ev3^of$Cf
zn9c++t;B<@V4m)ASi_#k6_X#Sf0+A{G1k*SthVq4g#`jltjQquAR=jD6ATyujATZI
zCg@c5Vf?cyMz4;h6#0IJ=d9c;_Vhc90>sl{vEkxOM7?3lve@)pAE0^2npoCc*7zF~
z8`xjp|1SFc)dT`7AcVw27{*cxH6Y~%OJBN4qb(_Y&1oudCu6BqRuc;2lRwnPQ}rf)
zr&*SW;O>ecl2XcBezB^_!B(C4GSNG+HZ?W%V`_7%*;Bbx=ck-cPi-<seZHK>e^YSH
ztN6O~#c7jh^ZDB+#{$P((ejn~Xup11qg63iy`93ELeVcJGwhR#%<URaEz$a_Rp=@Q
zPZH3ZmQTwUf7YPb0J_XRVczDZsfa1TGYBnuqEe{2RyL@XL2FpQgE^}^>oeO`-{3m5
zAu-OlF}WGMv40$KT(g-m?5*0fuI(a_p^&9MFE1&#JIuN{z2SW1eAIVzx>>vFPPP8P
zgMx`lmH*3AA=BZ(R*IVYc#N^-iH`3a-|t(8Z4itRw8hEEybT3CIA{ZZF)91pTJ{^9
z1#|6Cmsic@%?0JI$REp}Mmw4*Eb(=}j1r{Gdb~sVP4c%tn}gNHFpA7>N;XRj%Rb95
zwVG7W(+xiUC(*n~DG+{flPQaCUL1iwJ_8H4-^IVu?P;yJ9~)cv^<Sa=de>{Z%Ey_)
z`e~Mog)E-TDUyq<gv|G&+ef93hmTJ6=4x|v&vh;IN-Ex#Z`KIZ(%Ol4)OTOR;7)e;
z$Xiu*uSN}E7>G`jOrzBt*9>jn-xhL{bK`eA-LgJ;c9O7Nv{fohK;uL0L?a*sa+9SI
zrwNWpib+m?!OFuL{|mja#w5t3xudh=Tga?Sfk<UKPKHf7T|F--$8fdocS9qky||d~
z*#XQl#NYMUWx#oM)yq9-E=+@QHQI`Lzk6ULdQE%7Z6ITnc1L2msqMNtG$FLrEVqYC
zy?)JV2rZK<)3~v*DbJ|dC}VDH?!g?q$>C!Cvh)1Wi7;Gc4|hLfdwThDWT>ySb@$!8
z@y*~(-A%)FR%{g&J4Kz{@)A-Xl6~vPcPCPBUdu16ww};O(%Zk#8qR%P^xAJPX2J3i
zhBlrJK3przChY0*i|-gUblxlt!X!A+m|VDaxW8~zunovh=w}{_i8it{inc#7^^$dF
zVtCBq<hiUC!yel6b=4*IfR^9+cQ4!9SJJ=hzbK5vjQm{h9$8=4$kmByCO0EyjQJXi
zR-QhQRDQa&waC(QEf6BaVz0WAQn=5!XxW*il+CKDI+3v_!N=riy*SHs$>gc2QsH(0
zUEW;AXaCI3sX6sBv~W<hDeg@=i?WR(Yd&k?uHx<kDgn3Si5SPsCFSl}3I{>I%`<1>
zDAr{)p~o8D58W5r?n}!ncke_E&FI>b*0Lrf)JasP^{ke_nwBvRb@oNk?gf$tTI$`?
z<E+TE#4s=I-yuQA>I*h}SYws3?)uz(upk}3uDnjv`SMWn;AF*S*>ahV3?A;>#mf3g
zEmh>J+9DHse3kl1TBDa!?NjA?nUL?@eU#Wou+KL+Ge$QFS0*N}O)N}y6PMXB3OApV
zsy7J@I8NnQ4@I;`)~NRs9v0O0m!<HzcXxa${$%imq4Ke1b$?B&p;&|2^UicbXLe`j
zwHt{c*SQGK-POW=herZjnJ=%-3d6GADpx7zF$<EP@k~?^7_;e5)PMIKnUXVBInQ6~
z1NHsrli*q9lDIt#%i{FgG5%1U=lXU0XLMg!UuU2FBYgd4o8X;@9MV{w7$d#fh`Mhs
zqYb0PI$4~jZ1Yti74ppmO%LmHOiGTYENmo8i6IR}4>ao>ntCtf;F7ir4$uld53_CH
z1+_?%up_f;u4Xn>F-)@4I@ewtYcEl+Wp)s)oVD~m##^GX5N+Nf*|nV~ZGoFtySpCS
zC(NqY3{!fltz|lTbMNBLPQQSI8Z79{j3@odjGJ$}cpkLO2obnuuVfFkO&Qzy8TyC$
zeW}9xnx;K&$W!d#plD+yDz*t$$@O3QJP-1lo-`kM<=MIL{bz1sZkNJkEGZ4#`r}h~
znjwiBsD)|YEb&)XNCvfY#qq1(Un>hc)U$*-M4Y#5TPF*g{nqfZPKAyA+u+i(azl}!
zey3O0FN$<*W|?<YaFcy`1Z$#gMZK8Uf9w~1)=@WJ0yTieSG}gA^Qda=V;Uy?BK_g#
z+l|wuyCicP4WetbFry9MjLQ{#RoYkAu)UsUx6%_vd>J|;pTxcO9kaQmWOZ|O33n37
zd~q)SH#fx>b<>9hgL{L0Jl)Of9_*fz<5~xWJ6Uk!$(D=b(uEdow?a4f#*fWA{*`AX
zBhwkXVsq6;oyTGxS+~u*GS;OUyO3B3x*;Fs^P^&iAC^DYB6#qODO==yo5r)|=Xqet
zbw6^E(5X_B&|1?nkcJl~1Mqh363f3eWNQ+PUTcN7`nP|(%+YK_`VyS6NHJuO{#w$u
z#yL@kG+U^h6&>aGtZ&&@xsNM51&cZDX#}5ZTW(9(k@Dn`niVfEF9nWH{U_1iH{nVh
znvc@FVvzN)oS^<DRjc!+AdpVhRq~p<ht4}YtQF;I;ua?@Db{I7cw_{qJt8c0mENeS
zA#ni5m`JGiD3Q>BqkF(d;vUsM$MW~skWl_QkBo#AYK?^YpL?DI--w?$;Dc!M_czLi
z5F`xXFCyUMk&XP{yHP;dDE~di5CX0tJ$osmqy&7wG;^}Buy?j{a4|)@QUp$5ffe<f
zk&wuk5ubZXnoN5@|KrxLbX|1SR7K1j?6^(L9ZW5_J?y}UevrgGM1Vs(3l|f54?A0X
zXAuwahkxB60vsbw^E{;g>lPOq@rSx<FX&|)oGj=CxOusGA4*`;)6<JNnZFUyl$HNa
zbKo!WhgL2wU=bc3cXxMg_b1#APL@1;!otElypMSvKjs4N;Bxk~cQNtcvUg_uyOaO+
zBWvMo=41_av39VhNAzoA>fq`k{_r8<LI3>xJx&V`>;FB;-uXY%0w&0VxWdE7&CByo
z-#}9_#95IS)*cqNda~Abz?uQikl+(~DkSz-ga32se~<iEQ{DeH6%ye6cgufW`Lm^#
zvxSq4gB|cp7m5Gv*MA!S`{I8Zit!+({;#F@d!7F}3oNt*wiwSpn<jzXR@AKm>?5_c
ztoke98?Z9O4@x@li|y}k;P_sHh>sl0FC-)>BqiBruRQK;WnjEBm#c2E5h!mc+xj5;
zn2m*iF#fgtD<5?<teouENR>Bg6m#BTf$LAie23D}`YCvGvdx)tQPG&z=z#_TL#ns%
zqRGvsU(TY>hj#jpbf#QRx9eStnho4fu6Bf7?dNfC8zDqfY`%8C?X;^)Py}s?mrtjf
z$7oAWPCu})3>S!{iv751!jV}weQCHpK<V(17&0DT08Qn8QEF1F?uYDaCML|GX1TU(
zIb#)MHqbIs?!76vW}=?4!!JC+cat#nW0=zY^L}Yb)x3R%PiI9D@9oDa>XZE0+^8A}
zjKa_o*Bt$#i_eq$1`ypAj1s|kkzeC63ml@t10lb+P6aNfi|aObEqu9Xi?&WT2Z?uN
z9G^y2ocSic-!OfdyVVPwY7$C*D>_D^mz!Zjb?CiIpljIOoKxiUyoCE^MPc`IiQ297
z2?0*1$SP`gZ%gfQgT`%gxp{|1AEeWy>A{J`Bkz}EZaXG68DGY}`LWqlLQ6d5-nM?J
zdb81OddVnR`w05udH?s-srjGJveIbtjEoP<H?QZaV2*kw_Z6OmsKu%z+PQHI6;92j
znikcX*~$3r(jXU2Pw2SdW*HQv-R|X{PSh6oGk8aZcF?>;URs}@K7b@T(7a?RcZ|_@
zW5$CIl<}C&=1!eB;~T(btF@11?7X{nX=*aktTrg>4!)g!MAey8(i`numvo&t{fQ#D
zX(JD+U&@=9usX8CD~nXC_FV2YZb~EeJNT6v#As`R>~eWw1B+X^y?QQvwQ|ZCieEK-
z6<RyDG#@m*MEv>~uO+|5x2RNQWtM%u{=$p@N^x}VmE`?f-(#Ppg{u;)65>()QT%AH
zNv~<fRI2jNBaR`rV=urZ5Xs2g_1m(MV#p1i=sNWLXV-{(`B%sHmSV1X2E=}1(Y?)8
zirK*llG@|OIH8$WIYnrgW?d~^4<6SQVYxeH%{vO!lX0Jq&cfpjDeEj;PrrIJzIFIU
z7tsQN3{j`Ike9eV9DQ4|`Qu)dcAb7Ceu=x~3SUS|Gy%wFbI8Q?MaSj%K`sC2?nhCf
z0@4Pt3vNNd0-3C^=vcQ3^-jL&wIo!1p>s3W>uRtSnvR&7S=YRc6m&3PR6RSt#oMOd
zV5ukpG0|c_iK0MSV5z?W(@c7AUE+jT^R-7G7APHVo2x`2`(w9*>I$shZk|Vm_K*ZZ
zwF}>=jD-YRMIPL;-d;L5ytEg_+A?K@{JQx3^ye!&K5bZx)MCgE@d6Rg^J<o4pHtCc
zugIeMn$4GR?^weD#2mYKbdL>I7t+6viNwFH)^=TCNYjCgEy%zP^(Jq=*E+I8<=uX9
zt)NEuYyGf^dJCrzl>FALmX}eavn{(><-08rz(Q=|YUrR=&o`sLArZ_!ZkiBK%6(&l
z*Gef-@osz%YdyMyoX5EUwC}BhNwT)TPDS_D<Y?Q)!itmX>q)`I=d_aApW2rg&%LXv
z4Gw>dQjX%695wl6I1+2>wnW}kL`dyR8&_A`WOYN&A;-=+g1_@4-E+*=&u?Or`#qXc
z%fXF%yPt5{{9k*mzKSgjh`E@bmOpg+9bL*){VhW)YfP;3t?@THZTGAxQSi6fG427*
zm+$>KQparv3wFB&=zL}xm26y+rE(*i1{ht-zY4_K9=l<>Ed8)w^B6M}M-{2Rkr#a+
zBD8LWU*~02<DZE4!euRM@}xn;@pK*Yppyn7o^^&Qf7L`aKutTM8|t%J`|>s!4}Y}V
ze$-4yva0;>OHqycu(H9ZK{0hvwQi+L6&Ds{y!j>$+?${LQD8wHOHm4$DDE996a78J
zVM26kBKymBZ38>fnz^^|vZY^{WNy<IwPnAai&l%PqUlV3pLzE021M)p$j;-2f{iYv
z$ssz8SEMGjhVFKrXV{RB8hRRc?{r0;wyjk2m~AV?4Q<|u`}pE$)??eXLxw2SUnQDC
zbAm{PQ|ZoV#HC)J6i>oR96VJ#dZy>*T&ft+bR3hD7FF7`f)*|Bj6HiCi@siB@8(qS
z*oB`A#L3=#@*?5Q(M6Ec)xYLP6xRwy4kD*LEYGEaY-oaUEmsBabR&h#MeK20gm=G(
z_AtEum=xqXa`yhetMhk90o|zIjXbX0WAUdQT70eL&~(_z1eNa$oX9G=wI@c5gZf}<
zJV`qy5Pp$JX|`Nht&`6wHo*_d-<x6kYq|d!*+MId5vjy+xcbMy^#<$w1&(Xim2QSM
zSEXEz8<xAbX0u{#HDB()Fy=)+yKG@YG#}X~{<D97bvR5Jz*RHxFx_#}IzNdNl&|~e
z)3W)I)9h;Wgy2J#iQ3xWBvZ%SKc+Z_$<*eW8d$`yKlb5|&e89o=}?swbNn$X8e}dU
zNc>k=D4xv6_DCLn6%*0n63#m}9iaz=1j1M0A(<Vd+Tw0DsHAA)m`wKnv%bGZABXvr
z5F{9tsGkH&BLNLE{johOs8i%1{%vZX@9_KV#U_h7e_SV^AOcx_Y+r9UuP4ISQPV=x
z!6j(<V|R3wq}o<q{qbC0c~laR8S2;@=D%Ns|LzSvbWma-PTDf?k0pW-zW}?^e8v5v
zZ;FT63r;L|-zp*sM&xL;@nb#}pdPW0UJud3R-kwM)2w8(>lQcyIS7rhArI*#Rqh&;
zu3Yx#g?co6odhQWe2M1e4=mMJdUsy0IH_I27vSSLVfW7e4*joDw7z{<CTtB;FHImb
z!XJMtf<r5Rr(H@SYAPm#%1qH@>5H@sHtR|w_{E(Lq{uO==%JK!E7>wea7qYz*qg!h
z2LdzTj<Pu~c(Ci39_uTPq%!l~4`r|00(t#!u8!*3c5*Mm%^)o|7aJ453f1wiudiWk
z7<BjD=Y8FEtE@B(?9|f)xT-6AS<-^4$Bjg{RlK8?ZZ3E6@g=Xo2HSdfX4WM2S`nO~
zCGxx30MgSj3T1=-IH#|wnJ|q+c%@)Nw@GH(>QQYNU#zDp1qB5rzWC7#=*mZfcFCLl
zSnz%qc_@`bBVVy@c~0YJyc(yi?b>+>vD3OCTy?*LgkR;BLzy%mxeUncTdq&QN~%r=
zwJq0NG_{{zNL!T;$2xA6b>MAu39+dpbE_>uH@_9N=O-JbcE3-ly1U0R2<zb`-ZS5>
zheKf1rM`9(Hl<A;_BcfEx5I%h?appaTj&PGPiK|`IEuyx1v<wvy>}kW9YfrM*CcPx
zdyBLiZW&|6hz2EZufXkCtU<u!xIDkUh40anALp@(vp3!xm#Ujh`Wz1QePiaC4JJ3D
zXx@)@2$H<sP!Bla`q!S#GV+>rN0qgqQw7yIuZ4IXu4*x+l#R2!fB)WOf3b@_0*fkP
z90gx2uEw>9{3u|_4E{Vrq}pJ>tvX|+FIgw|d)Ol?e7UyKmCDvU|C7orni#Qz?@TpT
znF-hHxv?RaI}JR(M((q&3AK^)DI^}DF+z)B%iE^YR@lh9DP}QPLmu5vkjc?#`K50N
zo&_O0eTGzz>2DBt)JXu#9z1`0bDIA-THT|axV>TidS|a&u$gbzlH0udnRirpWOSL_
z)KYDlL$h%7rB2I*mQLrAl@PS_pSLe%9kr}nV9F}D^+QY#u*K|w)_^lp%Br1pn>L>w
zNag3mO~|L6NIjkNc8HLAm>R*B2W*7EjOSX$20tY&W^s@Bj-yG#b`4INeZBQ)Cbe3c
zSvilu?x>D24Ww>0)%-RFV<ZW6{K2s_wu2RcCRCG`Qd7w18!w^cSsQ+cd*c$#2FA`)
zg2##!bg=iB#M~4?BQG-#5?wwMgq#8c;%ht~aCmN098ybxOiq-^(vD0hHg4?ii@jD<
z($jU8OLxsCw(B{BQ#`pik!<LucVJ4W{C$_lZ$Gl*N!EEkQ})EIV9UAM*)pr-C+Yi<
z+YAMGl2?0s;p#pQM+ac<*D~CVC~=nPRS)!rytIi@!i2exI3du7o*nj3Scs{!-^YLa
zb;1WE6|T&)PF9vQNNFh#7Yw=-Bl@AW&2KXg{OhVb*4NhK;#XGY$FMThpcNX~$JH;P
z`+$+&il;kvKY%SKsN)IFy1azKAq_vH58b9d?{rf+P#f(9lIL9^c??lZdk{S7a#a2F
zn0c~92%8(a5XdAXDvr_Rrf~V7&Gk7=8>xMGV9}%vkPyguok!fy`TmvKZNenU!<}KU
zMVT2pPWgUyQR5<M>6cENydP{vvPl$9y5X7muR`nh?PXV5QSgh$dR3Q#4Lo5u#=635
z>CPM)ov&`L)+BY@=6z3<kMg3wTms{5AtE*%266C#z_PPzVr#-lY&#r|2l*n7xH>Bx
zbT@ltH;!BD3`OZKKb1HQzP(yB3{*aH!7b_$$`LGey4Wbxfp^K$C!IF!`Z8X8>{)6U
zk8o}kUZ4i!31Ot8Bv|8hT2LoZth@|gWSNxViz;=x+V9cH!L*sCjR^cqlpD|Cy;ZKT
z5@~#8$~?zgI;ER?4IUCdeRZ?ue^W^0&|hfw+N{QzHfQ3SY^e0g3Xi`hb3_}qubt)X
zs0O)#nAZY_gD>2G(@{y4nI)Er+&3z)$mv(LU}EzHfdS$34yR#wzh=t4^6v2ARyLuZ
zEHm}RHX;}6xz0(OqO@#{GR5;#UhtA%vvE&`#GY)`&iidRL&7dk$Xm|jJXSc3AH3L3
zMD))Pk!SMh-dg{sghs8&hH5aZefe{{vwTIAspqe>ITDG3_*kaW2h;w5J%p(HZocfj
zPK9qboz7WPg+Iph&chEP|FBY~yJx%Ia(e^AkUV=frFzmqtS-jq36D6wdh}12XJHJe
z9Fh=~yL>&pB7O7|$Wy2mqYoOtZix12*33Bdl?_Q;<{ck;RQ*sUF=C&j%%qBu`Aw)H
zA4GSMLnkXY${9rM2kf?@8)M(Iy})YCGTiW=?MBR?SSvQ7&hi4z=`ST!zpQDx!^Xeq
znOrSvv<loz4*7lj*#30dve=*Q0Gwgymtvsf1@$OB{n=5y$*onQ!xl2HwZ|q`pI^#0
z%%K6+a?oAKh(NZ~H5Ak1JE<Y!DR?X12&#_A5M>xq1C<;eX5BUtbr6JBCtVWqtSXbp
zjS86g>|*Xx8dXEdiipNNwe}L5R=6D4?IIf(J?fkQ8$STdtgOmjqIq}a@ENz0<6o9D
zcyFz>GYw@z!(zpP$6K%O<OK;<Qi@6a!Dy*pHBra0{L@gHuxQt5yISVyD7LQ-eun@)
z=XaEw<U!nYa8ldSMC7oi(+v209Ux3)z2a`UIxr_E>U~xEy40kBEVqnupoI;pN%FFW
z2VZF69Z4^#L;tv_tWIrD+6~uXXM<d)*8Njk&n$T}x^0JOG0^AC?;Q3z;F61uxDM3A
zt%tuM+ES$Ix}cX@;k0F-CZZ<Iq|?SV@eUUGBd}KU<?L<&uN*g}>?Fd)DmNDK7SqCl
zZZF1LzS&*(_+Ke7OWfM%W-OLV9)23i!%3#G67*UPsSBywBXm8A*HMkpm?9&$26~F^
z>w4Ev@9{{oG?lR;F8H4}i=~@-q2O`NE0BU#IDGyW+*;jR|M6lZ%w?7U<Y?%REz_?e
zQDG81905P&95-|~WcIT8c@UHGyZCcP@HWNxqz-}XMBF}~Ea^v|#H5sJ5iZHL9UB22
z8?<pmF#X1*H|ADbtLD<?>U^L5kvBVZ)1zQhO_5t#OrcJ;)-u>*-0L`(s^(yc?p8=g
zo&5KB^GP+~ajweK+3K@F_vV-3CcYbsrO^%7KXjTkO&+cWR>Z>m7^i;thKGxXl$>51
z6-pY0@2u4yANqB<Ul2T5e)U`k7UZIP!v+{RS5it!Zi!oj-G!&=72~q!ftWDhNf7p6
zo`r%*-l!mV8R7b(ht}H`ZTeAc3soQ|3kOxX5oZVv3y+p+n0A{1S;7~s*zkp=0{8oC
zDuUnZlm-VJZ6z-<F6G5LbwDB?#+G_4SSDYo?ou<p8GF9H?7P`Cj?KOGb5u{B5nAR*
zm{fh@+*I!7ElLY{T;3&srjr&J`J#!(cSB`VF5!{O)zIzLkS44{DR!t=x%csbxy8@h
zgXETCBc|>2EocY_R?Q3<LqPP2LR>s1BRScd3dPD1iLUtrLpn0`#l?a>+VS_*GxFu)
zl9%|k|LkZw%91r+9QC7umqP`b$KnMvrJYslTHb|Jf$&~+Kc@(<hv{)t6V&gSnH*_!
zwX7KOOi!AyRW#jZ9D9^O@TB(D8+gl2QF|nlmE*SNL8nQ=!|sYT>;}6^tD{O)R9HLT
zUO~Jf*D4VO*~+V3YE|>LE+RS#aygqO$C$1YCMYD57V<$y3p`6U4j%P>pb6cKWh8&2
zx-HRf=e?4oqm3uBp3U?|sF%%lM{290kDI;Qtt*05D?os<&2{r@p>~8jS1M2%H|@A4
zEz*Snff7QL1%Gk9G-6d@Q7(s`k{%!LST={lW1Q=IZ8z!@AN=UAEqw>fpVx0qN>xgO
zRIi$jK>U1$bo;AmliL`0gv=&a_q|+q$FA?LcT&nzMj8|zQWYgkJ99&#hwSrP+_XIY
z@`_!uv`P3r3n)n`*>)54{$kF6DrM^82YX?<Cd1S>3ffOSuTCW5(a1lw&Y#rO=J&^2
zd}{9No*uBnMH{yhoFNI;ZW@ond<n+Am1(2FXcWVY13^U(fH)(JRVvsB!zCS4Cse1(
zN=Rx{oz!X)K_e$u^AXV9G0oR%3!Z2v?#>%9jXXN_=))6Uj@zWmvVX2QO)1f{%z(d!
zm>MDsM%m-hKi)%vVYPS2Owbq=EjmSwazTX(kAlt3^9<KSX*n(wWeMTXDfYat3XQ%y
z&RHsRB{{=klcm$oaV1C4$W4<HPpZS$w0o+bVz==#b&`NOcsv?GO!2LiT1P^oM)c+`
zuoz6o%JWG*Oh}4f6XVE1sN~h>3tO(3>a|R70b2~%>5%_T<rLRW9ynew)g_Fp(OGWj
zqp8i=xkKmBy!pz1g7sj)J|D(+qn>&e=~K2DwzXA9KF-5b0#Mg^z{HeY?d;EJAN!x~
z`j~XG9`R?nS`OOfbmxcW1R$aN1ZAG8MR4E40fAUpkl@E=Y2V#3j?&~nn`JsYS#s+s
zrOEJ9Y=+=g>392|Y=ivI`;0YDQVJ!Gzm7)IobpbZiwK`T0zE3YSss*&ndY*I#nMq_
zRIi9RL){PQS%u)k;%n!;Z0c7D4Z;M(4H(y?9yr(b_WqM(EScezp$4K-bOrL(?ROvD
zpEAcUv2F{F)>VaQZ*dAxxG}o1;Onn;S)!Ux;@&>0M`XV-#0skDZO3z`&9y7cPiGso
zNkMij-BuV9$idaG!X9*vm-=7Bm3^!n(RPW-p-?v^K-Gi8EO}BM8%-cC?3Nt-q4*wW
zgQ#OaU(bC5(U9yMzor|aac{ua=F2QO-2mC=<eu<->RPs%359ZgiJOrx?lH4F=l_Xq
z0Y>R46H3KttmfdkM$ZlLX~Rz#bD0%Hbl9NkjIpYPhr~|>%r&GKstB~njeQ)I`$ICq
zdsrmmgeKFMiG()t5`L<kEgqIn?C$#CdJ|E}KC-~uZd6Ba3&u!rwb_nppmI%EsF(19
zDjRu0MF`APO)I`H>*Ok_dC<1Al8?!514Uy8%e_m<{c!c-bf5%HGBEw&Iu;r~lcVht
zkNO@hu5Rzqql%G4HKG%Me#L=lxqKeq>7Xllk1qk;ocv)LX*M=?+;9sO{o64kOudX{
z4atqz?fLUZ&xGb4Sf<C1?JoPNp|;5x6Kaaxf3V-_fhgXv+gW3Cw=$?M#AMGe=WqRp
zY=TrC*60>$YqyNrB|HPiAD53fzcsKJu@^@j=hCoEYHHsWoCEciPA{%ajc@aP?%rwG
z5&4!dZXep??OQRnN6ld*_C69P-zbalc?%GBE98}jjM?5anMejrBXWYo<|jH=Ksq4a
z?%hQfvuOGQk?dPYKN1yCCuJ=%;Z8R4vYw4hwiJsqO=L}b307K~)U-X1wVs@DN;_=-
zkBN;PQ3Ifsv0>fq&1L1MggHW*mg{YYB7sR+LQt8{%o44R@aC6Xj;!k~%U?3dPmJxe
z86mpT?U6&aeS(*DCWFz}3F;D_zky|Y?$Q=~S~^N{_Q|n!&VUT0=P}y6+YGlK?VT=p
zuJ+pvEPnWU(MKVe^*v)u!~=(e3CvT*EgtfAtbOH``9o21{7kN(=iG=QX5&faUx`hu
zn&IQA#9&gQ8r>@yS-QR*FJ9UpEi!|u@CoU6D>vsmlEpyi{Kpv;3WFz1LQN{7*b1}!
zyhi;#DFzlracO8`P=lo^p6q*FAD8;839jqi@M$wR6YGKF&m9xg1RfAFXm`6ks$qxb
znC`MnkT<Q%CE;*Gv%TVpSKW_B6!04upQ-XO_;fC;N<WOKC}zjxZpVrYjC6f%A^lC8
zI{tc(ztmGr|1_!RyUf9!)k*~bb^H*WKOfXYM?}?MXz6gGgR=n#zbDM7ZQeS&T~FwK
zTqIvEc)PEqi>++@<DaygUq8m-7Sj{!JWY2V{948xX+b*?cHZ>_T6S0ls~2ZwsaW`7
z)MEd{x>_7fCmHaan=*74FGhcLqDgJ-9giDl?TE$Mg;;_~$saG;wXYaBJdUeR6avwj
z_B?46lApw4xgy{Tsf}tc*R$%C^8`wjLY%lQeo%VdLMFF2?LGWAEQ#g1$tU1mXFfr%
zcvzvp(~9C2dxPWH_m9kB{|s}dKcM#!)Pro3P=T7SU!qUI(62{+3HE(9Q@uJc(z2h7
z*lT$yc2qPbLc8Y(ND3vynJB61M}501jAYte6+pFGmyh$x_UTY$iSdgr&w3<{NDWoR
zf^baHK5LQi<%Qh>MVv81l1~${T3RRU1A82Ai&uNpb-3EfL&j?#?wNaE#kpIqft%FT
zxp-`1`K{#C4eg7P+@%RfLD6eUP0rhHb^pn!-Z{T^`D;;aYgi@Edr3dWCz9H#iGdLC
z!sb*`#$c&_+p)v#i9-@lAvsrvLwY%&7dz06H_x>@oEF+JLL<5Bpe7kcmwZO|8Rh~o
z`IcULj5o}Yn$E0aqH4GVpHUa@wcK8|z<`is5@u9J=qfTvK&}!3g+A^K4qzzA!q>Qp
zwqo(hZbu~V1W#xSB!-ix4n8C|GWjeLXJIz%HhXWYtF_GgU2ZefH*{pU&rMcANdJSk
z6U9jhV#&6VHUs5nwAJG`9QXG_oTg~U!NF{*^1s9TSfzcqt*2-moI=;RC^bTH9W!2y
z4%PuElypC~P|jSR@y!8&LtyNL#1t-H4!hWfk~+2mt*3bye6wgkuAG#+VXI=VK(L9u
zQ}!)`Jd2h;ygStY_S7F=<9je$g|v^NOE%pI1Hs}!^1E%(F=p(3g5>t6;;Q`_1bAY5
ztps#f1UbC8>A(05b3!?<R<<ft8a^*@bp4!?XE8d`4?cTW=b~W?;4Ta-1(+k#B&L`q
zVH?67E6K*Rrh(A}O&TTqQ>I+9I!7V-OX4f+>R8mGkgv))+z?Wn{Yl&a_nWZ9a4tNV
zd7vyMHZ2B6Di~@-3)InXRyTbs$ok&`xnof~eP>``K~*uOuZ<cYPF4;&OG&G;F3fPl
z=9`oa8(RCJ^<kDM*%#F>mmbPHR{lAH84{0=S#!3qTy>rk$*nw3NMH9F-sO740O=S?
ztG_VftS2zwbCeGgMs7#Ik1PTdg1?qJQc#xGboW157?Qi@1_xc&9}bF!(zws?by_@C
z+UvHe7!eTNye0+Z%1=P=1(E;A!iwXO4Z<Xszkg`cc*y3z;&DE4^j;JNQzE8_f|42J
zp8Ovq<~4|@b@~X1)Ph?;`OLnEIlcCSv-Ez}#qYv)M3nw**{BO3Lf*)8yg31T=nPC@
zJLf<VlCb$&L1PWb9gPpHOjJxddyawe8)NfPxqfqB{~TH%5=OWsZeKv>KI6z95l%H@
zrd6>X;fW*-`avjh1;Y<5DsA@aw-w8&U3~wMn8#Kr#l#?{@B<C4(EaDaD~aI40YTPj
zceT^<@P+z(_AV5BiSKdk{Jv!3&Hq4caZ(T8l}GDf?~>-AY7iudqKeT7e+%1|J$MnD
z_KPIw0ilSVVtKSkP{B$Voh-U5fsvjqK|2|7DswCax}+<u-x=&EXQ2GiQHI&!4FKmv
zeTC8oMttWId$+GwVclpZT=RUoyFoF<QdL(+d_JRQwB$MjbzC@qpes%qAXOgRAyu+_
zFzM?7<oT1BXIS69E<qipZBB0mo6)apS#XAXO`wfh7Dg=3KR^V+d{m{8fh0MD%L8g;
zp$KD2C&N>^gM6=}2Xq5`guxOeB-H}MZ%hiB6~e7yxZ8(3G8ZPKyTfm^trUyA>**5N
zAAAE5#d8EaE$XxM!@<{`8Gn3l{w+1=SsQ<P?EF7A{I?;PBV$4ihwNp*D>R3f_q?Ew
zvFHEb8tyX=>w;(7DIwAiZn&<q7dZCz|72#615QwNOnR>N-@ONQB<Y=T-x;oAw&Lr<
z0jgk<F)wI@H{_~#fg@m%<&Po9BL%_(>usR+btOz;V4+$RJg;g!>`=!2wEyiqV#EQm
zz|5}m6XoY;xv(KPYB<K&!_ohOnE~hJ0FWTZC+F@*cTTrb5Ge-2sl`ENVG{*+rWjzv
z{BEJXEOViLZEU*826{HElbz@<w7_4AM{eY!0V9|EgHDM<LIrHXGoSY&BCx1Reg@hS
zSVT)%dzT#%e=gNFx<uRxyL;M9L8^`4&DQP?n?SVgh^z$8FyP7CtI@K7ZaPlgjzVDH
zdb+poOaYkLL}1>7W3+J^K0*2Cu^M>FZCZm}C3kLmhf0YJ@t+M@cndo5J`Q-pZX5O8
z`0jjZnR%I@gFH08S%F1~kyLjs-ovVrrN@E*Fphqp1@j-9v`rudHvFv!CZ%&z?WpDp
z2_dO@KV5(4@lrg50NF*Jh*!5eH@#ats>8^!bGfM#jKfoJ)#)a9m!BY7cSXjA7-ijy
zF~0K>P&@%n^U2tB-0ixQ7<l|uvKK?JduLob%d_ARl9LOPKe$vWal}%ND}qO-omWnL
z@m+9rh-Gj7hXx|-|A-Ai`bmg^)UX5L$O&(reqJ8B`zRhF#4JAIHSIQw?!0{lrUC4}
zYwa#GjbL}7+`{T@S|a!b>RGgJ`cpJ~)c_6&fS>cLAa~a_U<~s<9$v`J&CQX1vyZ24
zjji5-@8gfaKInk8hU|=ujZ^q-v~?{rT-)WT>_`w))=@J+mgL!C^2+IuCe!`<y&WdI
z*GYy9A5oygMUYdvWv`z>fugh>07t1lavM^Tap{wwqoYr~br#dHXM^rIFy!qeVLXqC
zlMWi&nyl=YsdMfCP^Po8>yzow<1qtuNB&I9Qs0DsP<o;i5>x`+uu{?8#wQ@xQ7x03
ztMdeT54-YnGS~+%TFB*YW5Wg|M5p=fEmlj2&1(NAB`bys07wsA?oB0mGXCt}`}{hP
zkiKdUV4!exK#p<;UNGFW@A)`^IQTlAs*AEnGH3J;ZGhzaIW3o%;ayMmdVr9A3&4eg
zVE{OyLR;DuNnTnv7<KR+6QZK921`u|<P0U)0j`+<aaS1@lxx1Rb9W!fu>g+kA;@zj
z2^NUMt!UHCkyLQc!%)o2JyjWSI8GQ^#x@MW#4o`EX@Wdkb!(X>0QQM%&iDtBwiJsr
z$4&J13P>xT8<p;lcXW%teFWWkYl1s|k60ZXZw<b^KE*e%tJb0)ZIHWb%Ppt`hCnz}
zIP2o^i+@ZVGoKl=r6<$I-x9vi{`vF=77MiCc?M-B0CeW_8!+{i{d?)8ke9NMa^MGj
zJot#p!pm>`Y<K?!J|W1zX(8w5&Ivy;Xsdb%l?YTk{g4=@Vst<>Zkv?pbSFr?z9M>!
zJFaJ$LCW2Hw)hSy4U-uQf&<5fc&9>?r`M2vwkPu-Q#l}cK*oS{kX&HS!z`<mf9`qA
zb^QPAAx;Vh)kEl@w)wauQ8qVt)22~b9Sf4&e3Wm}L*xEbshcv(&Fv05oI!jBH@;1k
z#_@c8;K3u#2wfe_pu!W~;+4Vbxs0mv|Mxyw1+*f%!h)^5WrNZ}y*(5e_JhyMTZPBK
zSt;8N4}(Z{fRt#%)8GxWt;vc0odsS>Zv|L1as)%^m?dSV2sQ*MSC#?-g3+loeh_)g
zEk7uf&d<Z6-;8!?s-z-eUEtqNO_dipk{r;+0w{8iZ>k6C_&j$pC-f$XM$dJB*SFPg
z$p~!Me7*`pR9d{aKC{2p@&7&W6fo*@vHebPA6IP@JSte60g7OO_JAT`-uwaa4pGG&
z5B5cUA?nE>Ce!fx?ry2EHSTRi7a4$ppZ?wllU^ASw{=tlOhnLj%{2Gkuvz4txW_Au
z2?EGXn0w2mp>DI!Ih5vwWnd9+debT0Ekkf9t(O&jG5AL!dvNCEU4cu=cT_TN5JimW
z4z#thuG{7r*ihRYS4SLQ$K)yTGjJ17-Qxjdn*BPwPnZk`W$$ii=Vid6uTo4e2Z(gX
z>Dx>KkOH-15Z06KZIUXpf3L%OlvKVZmhsghIm!c^9vh`Vc#ev4!+33WOlVPA5U0x~
zY|1=At^HT#N!8x(LJ9sR;sZg;!E`=Cz}Hp9&z1aqxpl|4s@ftSt_|&aeQdYr`xuNt
z>p?%`dpZlNnYPE#F?7{Z9&B54Qz341b<i*vtr9;X4uoHkWpx0Au1&C|#Nj7c_Io_+
zA+NE@_6v9^-5Y>RA2agaZgpU)1~_}%H-AVkijrCv7GD4GQGAToPPU&t>%H3q+bk-@
z1AL0U&`RP<WO$E0doBS;W?;AJwpk5P{{o4z5xr-ZeZw{x@V+cn6(~E7{$Q_&xwB_w
z1z7j*-_NTy^=Jl2fBzr^k^#f_Ka+V08`TA07sZF#Sbg{29oGeKHy#cuS#2ZS4?r7Z
z!HX*gQ{SxY{}Gs7RFO)@OKRs*8x0YxuO`%_sk{3Xn4#h?zFz!fg0VkMa0uMyW!ZK&
zZ)gpA_^t>3Ig}PV8RVpN22k7anHbsv@3@q3{73RFB!ipLXuO~Z1qGtQ0-wP`F~mS#
z)yn7ff7sFjs-lwr0RMOpf@SmBwlSuP&uIoy_0nfQqZl5`Fa(p|?+6<9S`(drPy^JK
ziTBMWV*UQ@MF5Aw8;*H&dKwDw-0VI8{G(R7IQ(Iu9-0{npCdyZZ!U)EGea>M#Q^B1
z-8u6xo!9r`XtDfXY~EjS@U<q9Zn>!(^xy|)M|lse=%dE6qClHa8aGTtrRg!*XY?`i
zD?huE2;0A3cEGbTqhj(jE(GGV1F@545D0ItP}*EQ1;s$lYlFCeam#ufrp;4(d?~-<
zV}PWxl+a^2UZGuyH6!t(E<<ZQ3-l!VbFfEk=FL%IsP(UcV@jQ#yUHR(dO(8mS4Cs_
z+rj^G8c<I4vW<hUmo|&qb(#;7$^hIeEq++(u9WKN>AlQf$AyyD?9?v9&tQB&F2GG!
zvM}{J7q<gAyHN%x3XY%ZV%)7N6p@etn$=t1-gUNmT)ypiT$9ZgXQ!b>N&ifFLNtV^
znM1-Ej_cqdqwCOgtW4!}_bsOnFnU;KHIlPeWPHux^OU=RGI#+SX1D93;L&F=Pib`4
zPG0X;l>8>nEa_hn;T`HG(QB@8*KtGgxr5c(p!w^Ayq{h`VIzHZQQJ&<GVL$ffu%zD
zhYhW3A)n4TtDo(v`*Qd!=F)M>0oyMEpK)%tZ`h?30K|Ad<^PW~j2!C`2+Di4nP(h)
zZCviYv1dR85}b2VnK;3kuJ<b<`TR$&WyIX-429HPZ0<q1YB&&2@N(&0EHhDc6|xyC
z{{KDzVUy>FYoXN_1t0NRnA`Zx#`<|}PPTY0ekA^X8^j5j^)51-Oy))^ht7XkNPXg9
zpCaJvWsUNGly7~g=oskjGKb`e4`2NMb!|Yhy=2byhpE~DWlVK+Kh3`rKOlFlk_Xar
zjQi}i(I2b-yz~qxInW;!{ZX!1g}w_cqR}6_yLn8*=mBj3ZF_MH!FB|d-|l!W`T#O4
zU`(hM{C|vTn+O<_O8>>beLo;s(`U+FcuSZ#`sa95fbnqi!S7Z;L{{;@c;sGa|0~@@
z$livz1DK#>XA4Vib$WNpfjFs`Ks`_pR(w|kr<jc>69%Dm$$t#K0FXVY5$fI5gvLo(
z0;e+^oq7J4lNvD9)Q1&+O6dkM*`Ojzt44oJH5FI^emQfrKRU?(WNxnA15JOdz*A;m
zVIsa`|IvvEWA?&kRGRl)Whs%BayBd4IDf1J3Ag`xTiJDb9gH1bOf{DJIG_E?8`2$v
z=BFUSX===*y{I~PXtZVVs4cnwe*vAplP?zGfJ|agEw>)Y-1QJ=yLjKnkgvYJFd73f
z?yZ*nHzqq(8#Gy)Y2=cWF)i>K@aC0w?hG~z4emfOSGiJSQlwWYYX6IddDsRO0$q&Q
z%jfZBp8>QSqn{lrdRbsx2+=D-_%geSffW_f8Z9_S(F`byLJ-LP=o>`Q0tQf^5Z{x@
z!upa?{L@)?V~-xuIYP2Wy1cf@4n9j%Fo1VGD6{)JDg?|i4Lb+IEl+0%n|&_TfPal6
z-G~}Weas&LvCCPX66;T!YhJHs4=*w3pv#@mmk>&snqlx7AaEKo_RpP5*NV|cwj<K5
zFjqPQsu_yEgj@ju0h@EqtNmD|9$lR60935;pRpqRRP)sePiQ1hGjyuI%KBG3;Qy%s
zj=fZ?w)z4F_`bJifNp~<rK9WMJ>3;O0z~Xm`&+scK+B96r~^LNeY(aQI@rxh-?u`a
z?XSPu4Fu;!JnP5OBy#JUCNVn49NlMA#SHqiBe+f`pJ12ZI~?Yfo%ibvr0%(6Dbf=`
z0i9Y0LgNQs3}?k#8X<2QMhJER58F&2F!B1mNz1t$as~k#F{r9?RNEj}9Z<i(0GXAk
z!2klff_*E3P`c&5Lni^*nN(E(b|0Xmmc52bZuBK#w}sVbzlN$KkhHIe)%`h%VQ49d
zA-tBp-X63udGYJ&vi)b9miw}M>JuK%TDP=XKWx2X+EyT)l`=#I06*gnK%dhE23V|^
zFNYI75(15f8N2s+yeIqQuU65qs#LNw7xWS3DFWZ!`;71VWrYRM6wQDEvMvabfObk?
zLkJaT5btQVCDu{;!lEiqID?9RR1TbzuL|t<%%y~C+>xecQrn~jT43`YJqM>e*b-ia
zv7=(QGI<!~x)xk(+pIRh&oZzs|1f3-vP+cGkBTT~{cbPkLvOF=Z*e)bi!p6Vs<m6s
z3<1UFLhYv~mLUjj1q^|PvpzxZsY%8BO$_pQnY9<h8ie4uO~#7Ha)?tB{Leb*+AA!I
z9<m(pl7K!1?f&&j4krXg{%ZEfU%$AZ5e&V=h6Nwytb277ghA9gLYP0HJLr-So6q>#
z2#H5<O?|gma~;QVh@pMlrOmR~fU3_3zTB=Y+$);DS{1YowX2zA`AfoyAd(PTPvnrj
zCE8Oc6O{J$tVhs}<a3S3{^E<T0CEvDS!o%H0C}rB+}p{O`W<(hPSHOw6DWs}+jU2E
z!#ZOnF09@r3$Ru7M*f_irvn5x{=o?KAs~5Vv=-g|aD>vPTRPk`W4y_$J(V{^;>TEr
z(j$-h7uF64OC3{0T;E<aok$)bQf3w3XQ*J?Zuyj%M$f~yMTNUzpqNUZbB<Wa9@A@3
z(_;!ow24BfeYgZa_GR7;u$n`NYF4MGvWv_hs8DQ$U2Sq4uE07C$KswcmAGoTJ-z)<
zSfn={wS>qhDAhA<x_tFXLHJ^OQX-c9Dy!Ro!yp%!b@_F)=qwuS><L&&5WKWSf_XoM
z=*gZFEkHZNk>Fyb`ql}~-oRoN*sQ=p>7Fwr^fMb(jecWW(LJ&O@CF#9VMn<UDnH?$
z8!dnh%-++h`ez{sW3I|^(jqzE^E<zcK|gc1Y5=n{cNSHQLerJEebGq<JfxH3DCxS6
zh3+t=hly{H?-63BMHq%F195aC(Jyif;l{8u4VPI10z-J$@`F(O3X205yH^B;f{(nI
zEEvVi+ODnV?_Yh=u%)Tdv>n)zjyOly;yM~Kf?{t+n49?m@0_LB(gWDGgTJ@XcGa(T
zgj6yJNhYQGF;J|$e#x|T2)rg0^#!ZKL!QrnxP(!hpAY%dBFX?JGh9ZnSK}C={<M9A
z9fAR+`3pBO;S~K2=p3(?!~0sAj`DfbuG?NnAgT|Oc!~g~>((zFP&u{_M@xv(W6o|u
zR63$L)90YqS~O<`p;J05y}c*}1EP_Fd4iC-0Ysr5urw9{#o=k>9qkz|Q0oq1%b|-R
zeD8>$C~j|dZ)xAkaZ1AxYE}{L9qKhCzVgX8X)9_SbL2q1=yy3ij|Ugb*_kklrP0PW
zOMc|n0$5?kq-9n{)WVG5eZ9s{VG%$s%GG#~RI1wT^W?q9#66L-pNinNi1OMGV($;-
zDIOV3RQyy0n+#_G+RcFTA>maq@Sx&CTY9>vyZwYkvZ3;j-u6BLI;Jzx5HH3$vEaSe
z{pmU4jos##K~KhCHU$og0Hu(oLBHLU>5U`z;c?*Jg!7Pi2cT<Q46$>Blmg1wr-HrG
z%94{G*Pd)MVD_$_<&ZbAflCB9w%h?+B4{aAQX<@as_&56-oU=jLg;MaeFtDxsTV`S
z(jFQUCkPq}tFpq3o?~D8vHH0|{3Vvm)an~#f4ZCP`5P{=<FD#mHtlu@3)&=Fw{AmA
zQpjBwVUB<}%zLURlV&LqYM#}r)qIJ7z;h==7z+F(p8$@(*CM$N9xP}_DQ<8$hV#U%
zTLviRhehsn-s_e?=k6xyCWl)oR{FM~k>?%rQTR|qQK(Wt2Yvvx{cJ1F`-F;dBk%lU
zV+!k;I&QBPCj*Kbig>`$7>oFQdiJB-|0tJk#jw4|==htt2kcYBMnT#KzVQ8I6*3YJ
zPF__6k`YUwOyPNy6vRLhWmd6b(*M)A5gFVYY#R*(ABWL~caB#GiCMbe#fDN@JIDOU
z(B<CqhMCzOdO2NF4@-QsW2}v<vD)UO`~I6tO5Q+01QMi?q?K;p*yDXcfPskOFW(+l
zG2CE~d9VTWraF3KiUmCVOJwU}Bcs<mARcGtK?^z4P10|xzPW(^MOTI2kLf*s*qC(l
zltT=%fDl-SNMgzdNs;wz0Z^@>Q!lg9Ri&ge{m|&*{z9Ol=^P!R`q@zT_u60Ew2blm
zsl>{xA@kO2RZ7o9;-S5g^dTU!l^h73^75EYSqo!arOnALrk4_03&Xb$T*&{%6~<sM
z3-(=LU-F)uF;Ab7T98L_PDn$xKzrtOzLH$nLfT)H<IX>BIR|!z0cv`c>sz2SPqCNU
zyTk$1#CvV{e!QL;&evBlY_jR`bwubEYwvBs(%5E#7Fe)(24fNBp%f>oml62hM!Z!@
z#^c+}y;)HQT=$+e=amW*5<?7yk!oMn!<$gHAA{cr4TA8S`9kP+h`Pu&R=9ws-l&jf
zpghUg^<fRhuV9rYpDRHW@O#rhU78`C%1eeda+!5|o+b6&Bv+FYO2E4nYguGlqE^lo
zWhebZ_elsQ=STgv;P{xZx}%>eaLR(M*k|GK-5Kupf0%wH1^t#IF_|zy9YfrM)S0V5
zp{KD`(y&vnl(*=}8S@~Q&~Ii#;kSj!`vBb9NbY(z8X_}FnN(*D1KxH%)!ReK+sd~`
zL?XRUe($Yo@D}ecP`m!tu%?z92`hXz4#-tfqNcB?e4pKaO|r!GzDqX|*l5@LwM#Qs
zfCN#^8JF<_0hbY7AIGRu&5$fyY3yy4OU~un7LOBy!nlHv78xRQw?-Bl9c8lF+){8b
z>k$e!Mp^QlB|v|mL~H7yxe!v;j?<xw$;TXN${m)5z;u*&f4P-|oA;okU4%Z+6QROd
z`OgEOKIte=WKMfzdKaf>)UfImd1UFQS!O|$W_iZcD2@p@Ygtb(!t(Xi$uH-@9k}67
z1l63pJ?E#~SB2)->}AdIb;R3(DV9H32l0|Sbhi@l4eG92+K1X;@(tpWG!FcQMwbu(
z|52HD1oq(`|9W^!nqV?Rwgal)^yCO4fzaHxN)X(xOK1WrWU{U?zzIz814v5OJYtV8
zQ3u5i`<K<|gF>Y-M-?P5MwnjkP7s<2&)}h~M~_4X!Y04`#^#nKl;_>`$md<<`+w}c
zXHZmI+cpSI>Lzv*o1Ak7NdijFIfs^vh=4R8&>|?I$xV<fNlBuTL7<63lLbjiP!VY|
zq67g&P@IkD`JUrB?^jbbRr6zNW`05K-L==+Yu$NW*S&YZ!7InMPPaT~@^E$)G#=Xh
z$CBqe7!T%-NA;-jiIEfKgh(UzCp}}>G&9Y50cM5_b6wkehu(n@j6eA)S5hNEA9gUI
zoc*IqJzbLh1vP2na~$qR_&y5yQE!taF0kQ>9WFZh8zf3?o{xkYMSA%hWW8(o7W?Hg
z{3}Wvbw*F(+76hB_=)g!S!=?0X=6J+kOb=xav6^UTVw8ELK-c;2oY!z9w|!3vjytO
zERS|#L_4IOwgU4U9%_o4<T`}y6y6@p?TTzB>sO0sa#t%q_zBn>)WzKtVx|q&U1klg
zWbs*c{0u&ijfQ%Gt!H~UUxEA}NvsH+#RCfLZ2~$R+*M7KXptT|ub5TdN+r->Thd-%
zCy5xN@mg0zcon*@OU1fpl)wU_u*+e*m|UfJJvY{%bYvgE+z9n9ZsL6Yd_#3tpSvo&
zvOeeDcKWR$lp;qdED9uf5*z7Cy+WcnZ2tJ$Z#cv!cTU3(2Y2&=eu(!_WN**~W%*F2
zp^AqRWKQBYpjXGX!+A@KmzKHbQEy~fkC(fmc~`F9t(C@6wMq9Xc@@iSv<37Y0U0e|
z;4wg2tCkSY{eVT)UT`785nIO9PHsItB-R2JEM)(MKd<b6rt3+-DQns&VqUYE9G@S*
zGhcw0!%Y{0D_vHXYBW4v*Sd;ublD*HSqE3hF6~9}J;I8nHRzls@NzgL6Beox!y`}`
zQqjpywGO@79jKeo0C*7G3!Z_>y7mo77A(oXjdBQ3Ds>XV8``oU5|l0(w3G2QWub(9
zFj!<s;$-RF*WBz%KgUa~6U1=~QohoiPl#+O^)cH0#6E#Sw~X0}Ay_x7#xt^&qHasD
zYu~$gH4(;s*rJ$4sU_3`g#!<jPnv3dI_Jn-=b`@SGPYtLbyxli?CR^EKw;OK%8O6s
z^XBH8{`57K;0|B{{oEUz>SLXeH1GCq&N32@u$I}a2@vw2n{S{zf!F`WKLvygKY`%L
z1Q(UANbW`xHS)vt%u50#0256x$3&1vQ}$XPp4Hz-zLh>9S}dfJRz2q~VX?{kIUp!X
zUKpu8whMs!XWRqD?*P<-CyU`OpAfPrub}7ix%(?6nxD+`(okTfs}iUP*xIea!w4YK
zHYs`fJ>PA7igB4rS`V-IEJm>4mWJykZg?Aqow6Q2%%z5XY`+$lic`G*96hw$fK$#k
zyuYL|`2};CnB`{)`=Ew%lZ)rwer^Txz4<AL*t4#$ft_~-{#P%6<~sHe)k@AEY3JD)
zEl{Cg5u&N3zj7IS`W1OPT{6%zAkv{bF<Vk_gE=H|H>rk)`Lf|dRS;Ziq50CU9|x~e
z(S)wpbvZV85_%>;u(+NNBaOL?38KV?RTv?;!QgwNI*0&gj0OiP8UJ9nnC>KAFlA-!
z+(`tWGVPo#3kabrRJ`{(Hqal;p@!8%y>wY5?!f#BrZ{Ef-0X4~R6t<(B3?`Vv71_M
z3M_^#jY>x$njog2<9MM&cfov59>A9bJfZ#|?cv&UoD_R7*f27!tImaQ9>JsGmGI7L
z@iOEhG^CnULuHl`<EBMa5|F@-2D#NN+Fk$V|Lry~))F_{UbWQ5F=k`+^4ZE|oeOD#
zn0+tTffLOe#89_{Tp|BDDq$^@Y$#0C9=)>P*CQFXvPMK}g912aR-B}%4|Nw-B3{Ps
zY2DD{LI{BsajZ>4f^+VvOIt78@;^Vb9c$OU+ZGbI$+iryV?TJ<vLycU=s4xfYpO4_
zU-aihbiC3?L*uuci}WYKU*CAen*yjOeX$0rG|mI=2|+C-1)@u*ZzjG3i7c3@Wd*2a
zGoa}=5{~@7p8$FH-ddbt@o2T*sz0>2sdRW1UMQ>Lii%=por5ka)^;==*v?9}0)?9{
zptxlnxFdN7seX*BnTz*fRFzqt>r!~jS8@054_~Iy)W{VeZB~yI3kSeWzij0gA!~g-
zYZ4I>U=mEI$_4t_J1#ff(&t2*qba1dSiu)D<!_^haqgO%JfMUx)n2NixBQZDwKm9r
z_@aK=Bg`e-{o&Pb=NRhdL_%E|a>@bU{#kN~llX>jKo-&=@?v^i?pN=%N_NW2<bz^7
zHO01I!UXk{A->%h!KkwpSlJRgS2FJpZ~;zHKp3>a$NB>PhOIygjvU3K`6h>pDF)FS
zgmr|m(o+hUH!^3hds(9uUq)zBF4u^XJADi;J2xib;}C8il;fsgNg>LzHPvYlA+;!7
z56MOg2NA$xbt!i(d3y&OxY61s7c|1|D&oCgEItlrTlD6v<8#tor;Xs@OOrCKB_ij(
z0T$~_rElRC`}*PTuh+XW`$Zx-Kgdk!7CDHiNeBmw$<db&<R5&<xT4z(NrNE*^*Dz#
zj=z|w8_5Xn_n5nA!+AAYogP5D60WJN+ArilBvLKudkSf8P<wQ5MaKSGnpqPtr#{lk
z;(6xN)f0Q=$2qf^3n<ae7!fzZI5_75in{jBvW&{sH|j?mWc$wcdxuXiU43=f_BHf5
zP_29kL2fY9fJ1Yo7xsnfbz<vFd>39BILT(r-E{GFO^~DI12)Ya+{c_|)rAXV?o>ui
z3nj?no<N=20Eey;fExdp2pWu))=#kQew79@ooC^I8PqJfg@Y9}I#?JoJdvT7;?*;_
z2u;a2Qo~{|oMP?;OVFeJOk^iQDZ@{a_qe|kk;G&K;fSJy!7izzMR&+Gh+NT?l1!9d
zIEp5G>ZBIIh2=Cjejep2l%SSc(8bpF`9>!YUSVK$d>ni#e(?9<<B29vNAwh)aAc9a
zUkL97KSN&Q!`juM1*KTG7r-usZ~E-y<#7=EnB2DdTCgeiL1uJi;@%~+49P6&Zc8c;
zY_U3bnMC(1p4s7uyp(F)Bg;d=O!4`r82C%cw~tg$oCWB8-s%2WQg_>d(he7Tv1%kt
zRDWA;ApOn)grFFhx=tPs$*xpM8@fYY<VS=$n`a0B)MTYhuzmZ|NeU+fd07+c9x09F
z*rJOq;6;OjWP5qei$^ek%pGMS+mKx)Fa@x&yUkJiZ-5)mbP0HAr?Pgxy0Zle7TGqq
zfL*~n^k0guW7Kw>nyz(K151yF;kD6bGopOh9=hzg(fW08$uoe{VigKZC;?3Q<t-BT
zk$RtKknOXFtJX2Qj^7;#+sbH)I<n9o(k#O8%!ML<k52d3Zjo0f=rmxx+M5W8dI1k|
ze=-u@qI%7Ksn~kWPJ5*oo<Rkt7vYF;CLQ64Fp(S`x8$${OUf1B&CD8V*ZeNFffk+9
zw&EomN??`RpUpJ}9kfj15f1-;c<(4q%A>F_)Z$wojHv7W5)N2$hA4IQYGhdybUKU#
zhBJ;IBS~Xfd|&vO(3Ec@GvuH->zzh843}6*epb!B8qQ7q!eWd!I*=3A^F8mGt}`s~
z*#Op?W>*pvt7OrspOI$z+}=GdU4W1}DBBMM$?3#Cy49eX3j_<!c@zn*<nB0G!<-(S
zSPwQ-RNJ5sAjeZ$9pA$qQoD<>Qam?zLBr#fV;i1J*KUY9X>O7I;yvGyxX5T9{`4@n
zWI0F2@qG5PlSv%%Afv>LBIL~l@|vIYSL9xe)X`ouA&7}J6DGE0q(p(GmXo&C0uA9F
z@O`*4J*5Qh&YoH}kP*hV#)@6{^xODp@1<?$`t{Q!6Pgx(t~Rxu#gFc#YudTJUXzo5
zPm4hHpuSpk-%gX_do51!U}0lfc{{?z1kM6D!GIfkPE(h3_{Z!FV{K!1t6TftCB(-c
z^c)Q6N!**u=hoUwr&o0vxb*CVxr{Z9o#*kpihE0LKN7^pRijA)qC!bb1%nvOv$b!1
zZCpJ<y(DG=MYi4V`*o3-Nh1-HG(gNyNYQz9%=HFay@2$GLLm;`+t2rwmfEz0R=YRC
zFr2QbC|+OMH2?0Mz@i`H#*lHkIYN9-!Vm&#hO%lK$6M1|wNdXTuo8QHjccp{4EX1u
z7=8+a)V{Y0HyAI7pyO#n@_r4TODkItWt~SQ38CRMeP`kCWFrMQb>Jy_I-fN0M&!{Q
zU0?RbtsMM*(;W3(d&SFzsEMMaTAikm4}6m#LQ0`dA#j`tdFVTR^2mLMmbfw-B)$m$
z#v}y|3;hbI7`2~)@}dTkIL<@!boZY+(#D~mQBu(m<xw5Z=!D%{@2x61Bve?chhBW1
zHYFC~PCg=cgX~i3OA2{LCx3>221{tr>@PqE;~wJ_2O|d)Dxhw0trcJGwLEs+sca;k
zsjK!==-d^J4T{BH^P;j4{cKTrZ%IRnM+UkHUmcUgc&~$^83x~U^g2kYm?%}(0&&4`
zuLOnsF}K}2NP$P~J*(1?alAM#*<hIW2Qv|ldOvwi;`S~0UB(RbD*y~H$r4}!wfhw0
zV>FCALq%Vce9rqK(DhSwrN$4aK!JUFVeF)(N-63EGz1j`j_~Z_{%}B%#<}=bto=F(
zQ-rG@^PEuZExn7kwd~5Gy)p{O>_5$rOW^YF&+(0pkkrYocsD~sk|O<XmX*!4R0{&o
z%o`w8N$iaTpBB_to6njlP4hggu3^-3No#o1eWfdxPv?s8j|M!8C1!8dwD&2rRi>0>
zs%;QsgHkK`<G;A5x!SErKe3e((q~I2A>|N~dCWj!zSwGmY^Y6ys_YEUiNfOtd_BPz
zH4c*?(!dm*_$gn$#UQ`KQOr`b`{^E%ggSx{K`9a8B60~zEBN|_H}D9yN+)MU#zbMg
z!YG(=2~7g=pt)GHYwWZ8b5FVZ!LYtEZ97&7Z_@ppYw>ajlxpL>G?>XIyGDt1uk|O>
z*2@aC2)5)qO**MkHvK$<ha12VNfvD(pAh}*ZSLZ{_*+JR@N48YqwV(^Tas7_J)dm6
zQos1al+l@wtGDUJ_ock@@`(-fCEjbW9ZZ9hdUZX`XRggWWprjB)dn9^p|i#h#f?1|
z<sdqn1WPmn{yEroUD%DKj#2Wf=OyXTpxc1GUy<>@Wxgr7P182M4GBEK2tw23RL<=V
zK4G)JEVoY(=CUBR<e%}oqM`sfe72<Fdyi{nZ1YXnO&1{q1gms(Dr=imL-`}>VyRCP
z+)0l%B|^dGrl(D};X@1o4{<|eLslPNsvqK5CAW}#>aMmwCfq4Wk4utTI)@xHRaHy?
zqxDhu4is&(o!BfSDsRKXQCwee5gHI_o@CG?Ky8fOA}qU*JSu#sFMH(XQuJ+orkifm
z{vL?K+>KK+DK$s^{NA^4jZ>_lY42n0$VPe0L^Da>{bzgCFGUvjy?QTiS0u%L(C5*J
zz|BCPqQTRlsfmO}zxLUdzdsRAaKi~5w7D&yHydiJ?gco%8@G$_7r;tQLZ)uNd$*XQ
zaj+LCeMe(8@C2z+P|fXjV+|;pHb}ZDvmQS)TqeWP_w5JXejnzgQeA>8E3`a%C0`n?
zG*Rf&%w@4>CabWwxIU@f&p1KH>%n+0rZo?9hd$#56qKNgwHf9bhDKLYjQIhA-_l1Z
zomFSLuJ{A8QFRn(`GAiH6%-UmcVaGzogbtkD$dQ_h6%hVgF^d$TcY=TK*fAJZXhjg
zWw%qV5H>Jd8a>Yv_Bi0@hOg(;(ZS|cd&AO}#m(R#hqtpH{E-cDt-Q%lN-4_FS#X0(
zmy>#71F68}WHMgZ1OrEm!^&eD<dneHOX-I}(J|p{l#0dsnh&H5f_hN`{2|get89?2
zzPqq4O^=#U`yXG<5^~Nd+qcxg`=wHsaJy1$L0eYH2F{X152I1;8|Zj^Kwq+rsIQ%2
z9ISB8-?iS2>tJcN(ai9pyVVM_Yhm^GUfv8&vt(D}`6~e_jvREPk{h`}n!N=YSZ1Bz
zDc-E@gVfxZ$y&Bronij%ES8sv%V(d%ZwO$oQTS6V)0$F?!HVpCdy`k09fyvT-*gOI
z0u;q*{Ks+BrzhIPT%X#u%p8}%bhLFI60cX@m=@C2LTL3@<@9`cRip(ygj<H#O4!Hk
zCB_JgBXUTXcw+CsZ1j6?kICtDG{+)UwUiFham~2!<rBB@CH#wM*4_a*4Xl$NKEJPE
z*f<XX*oL3@UDD-*dK2;m{o+0clfluKEN3~B9Kn0F`%1TK=PQkn_#;*Bu+}yujVR7V
z#GsQX^>_ANj^(rhYWiBak0)%k=)PY-y@3jRSiaOQom8{3ljOD?by_;lLaq>L4g^<9
zm+IZ@DJ44<gxY0bANVI(2q}GbR5mc~a0B?y1wwx-sY0m`JBln-ca%LCqG7}U<iI$j
zpd&Zl5grS_4>v~3eZff1-t)jm=W!8|#3815ZA7t(0?`;WIhY1lC^asvu_YS1)6`QU
zQQ{3AbpzX1Mkjx@d!V6bXEIDkqs7E+&R5X$P)E@vomWH}+Z2US(<+=X^h(kD0n~jR
zjuPt6l7a@>CGxo9q#~1}vo4t{+E&N9SHoY>V{ALg4r!*+Q^Hd<e@S7bU&DF|MbU)Y
zHyZ_|<fbcrJ>$Vb6;W2Bvk+GoUV-GGm|6fR`C6S4nseW>k9RTe`NB=Lg{3WxJnnGl
zE3j>bHdi;a3YD>E5a?S=)G7N+*OisSzOz<pd?I5xyq=oewXgj$d35X$KNqG^ap>J(
z=SyzX*xl5D&X*g>5%#&UD6dOXlH@^<DQ!;s(^#nqpISKGMh4lnSBwX=-RN4LW9(Uy
zf-<nJpEp?H3&@eV%kD0BmfF^_V9mji@17hDI<=@Pxe$rjiYWmc%Z`-COP-CG0^(<e
z+=cgpbe#9er{lw$5{xQ5=hWX$oo_3xoj!2tI~NUSJigny2t7OO>2eKF_x;S$NA{t9
z%f|Km{Nar_+HTCbTkMBYi@88Mb@-=sd}N-?ovtm}!fQawDFYBtHrlUF8R1p|N=n5^
zJ{2Dc`xJTjlFbCjNokhX&ij7UUjgPEIxjshr6PU3jWvZZ@mNib%dYWWV!&__s$ack
zquK_^@J`*=bC-Eg#^=hHD?u0I_mk(<h8a{1%3z4<sb0I))Z1SpC-3G3Ru-FyYVnf_
zfxx8n#8ljYn0xWNISl=R(J>o3Yr$@99NSmHWgaPxUD3VCL&T<LU)OsgyBkvD<rPUW
zQcKd)O-pNqZauu@$#HkO+?zYP7<vZ~CI0YNZ!|{&q`tuN`8tL*_&J{gmzC6xxpJC@
zDBank`juiR<{&{ClPc?iAMS4>cu`4#2B?z+xI6W#hh*Vh4J~i~?ain@<^E<J87j2K
zrQGV=e$5xg;6W{X_?nbOx2!4j3YhDXtP`3HbbsaQ{<s{8Aey{1eg!Y5p|ue-p;G3I
z5F8`=s*U7MzzX+-k8C_QLP}GAgwaAe#M(E#{Gu2pOx!tD?39>w?=QJI-_WVQgz4^~
zS08R$dPMT`>OvvSx-i7_OT+h~1M~H@n$MZP`4_<P`9;Av=$%i4KA@7QwofeDv#j#(
z+dUhyzf}pghuDX9?G@LwP$}0aOWGb?0jZi2l+h5eP0*06V3bD|?1y5et6j<)sQJA{
z`po#M6Od|J))Igh)P$C$%PB4p4m}nTJtQl`ObTJ1IMC?SER{;cG2_r;H;%{$MYsd2
zm0a1a8ZbJ@De98DDDk~Q516Cx^RKd`syY`INeAa2F9o=LcBEc;5iGsB@1(k+G%-@3
z)9L=nZ6Py(Fa9ZmsOwFj!^kzuT+m%i;OyG#N6eBt%5NuXz!IrZt|^sq(q?)72}n$k
z;%tr$G1Dp6AdDA5_C|RmWS!NG(3AoZ=*oH!7c_{_fv$qw*X2HYP7V0iufB~GcT<V)
z*=Kc2E+9wMC2?rIT@GKluOYN{fU|=IVjg_Y_jj6P+=jyx&`OM%(@RA$bPBrHhj5B-
z27?o@%PekPwv1jtZ0m0Rpnwu}1Pw=xz+BsUAoonx^*a3!xeE&;peI1F7yB$xp<xqN
zcIAcx7k1OXTe#1dpq3E6TqIUN(Pr9x4rdxB4l_X(F=`T~b$x#uS(zNIyKO8wFk8*2
z;>e7+BT07!Ezm7VUdz6Y`Jt<{yU{@$meTX2vN#_HX=^g()=DAy2rjfCC%woW<`FU)
zS|iP&zhGvB09-NH3+IkwKWkcP7um7eFcV5m4oGrwPoafSN}WhAUN@{+;_0L)OP&;=
zl*crG@^*8kl*5>5P;WW!ztL~|JVh??*0qRc+Z&wLFKT%Kc@Q8)E=_Bn99v06_;&0z
z8b0jwbb-1Wnl{81WMrvH7sH+g=3(w*-Bp`Pmu%7huy==>6#rVt-E*<-)i)awCLCEG
zhbe~<J{HR*7ygx;;dJupk{jnbIlei;USnp-$}uknWe2{$QrO!i)DjqhrafRG)a}rQ
z<!(<p12jufopdSxWRUQjCS_pJvRs9@Ryd;*kQ==bjZeTA28c6J%rR}S?ZTF;T1*R_
zi7$@?LgiE*DkfKkMT@ph+`_X3Y7*3i7Vl!>(+yD4AMUbsx&9Ep26*Y*Tly$opi2*r
zQPYq(XYRqo2Z#y=?5vXNNf{LJTY>1$5h(3mZ>IP9I{azo#KRQF3gme|F=_q^DOQ#o
z%byN=^oU38(q(8L#l(4P#p*ojmbV-<_fF~)T@&MYV(1qDH_!tmL=)=RF)CN5xfBuO
zO=}n_U%BbQLPw=vOGgF@(;?8N+>ub<Ln2eAI93p71=H~feu9#^uIkwKUZz)Dh~YEz
z>OiuTboVRLl9+0HR}8qY5k!I6>71qL%Zq^C`Ao0z1)70^Z4r_3g|14|;xU5J9lzjh
zx2_m8eSO2(Cto*Ea;ftg8R6u0bu<s@7N=W5w<j<2S2zIS08Zd#UZP#9hH7kSE~#XS
z-R4)i#F78DpUhrr8DIK*jC1hHgls}R-w&zVW-zZK4f!qBVjdhRjPEeE0DPZ<LrsfP
zgZ^Is_bLTR@8k%);q3$g;9D4O5<J)7yq|mF>bRCLk|>P_(BbOdl}7}Ay+mnn$y&M_
zW>R&qK+o8=m*M3#Y|}5=v@Zk}Z&A!i+?U_iSxdJ)fowRyY<J<`clD*Ma@(s-HE*sJ
z$fBcoijx=j+zQw@<1hsWQ3@$-qu)I+hw=N<UbDC4FLDlq{5)sq5P(z#vG5CcbZdV<
zGpmuasPCm9n>>zR-0Xg?s`FP2bI}zsL{E(8{8MrspBe)2zawH>`C%!Jwt`|3ra^I1
z2GZa%3sdA;NYJK@IWnc9@=<l&LiWav3b#iaCp_sepgPvb{_gcw*M7GiFH<g{BpwTM
zT9<qJ{;tfO4HfQmXsPyoq?E+LH95CPMK#4G^HTA*<Dg3TrTNDx%l@|{0=l6H^jToH
zLz`2e@?lg1cX(b5f)4$rh1YJLsm@X2Q}R+3Q<Bk7_cT@cSdptRLp=eAw!^-`l=C39
z;SH5Z=i0KF2-S`K6M!IR6b@1q#tNKy2N45jg{q*J#I{{O^ZkItApi3&fKCG7ieUD0
z81&PUM6_c@N~YO+hpE`dg5h~bj;M*o_#^=34dYySc<tjSHY|XEl)4BUHB9XX`9t(v
z3V~8*N)w%1D4&!82vx41(|6D;gwou%+Gmq!j9CsYt6#@R%{Pr-6phtf-!qvtZ=B6U
zzIQq*7f?IX1%eBA04eE1*+mAl?HY^*YCmF+-##LqWh2z^)X(URDT7%Jpc&Cd>&=1a
zDq52Qx(I04aJwjN{&@>XzxZplZLr%Oz$_YpSs1s-enjz2t^f~Iy+p`%R?gRxe}N+g
z`DH|~lI+6D(Tha+>tvWoo++?fGFk|Q{mB3A@%y>o;H<w#=BpnBLrre3-}ka<8n~C8
zQhm2f4tvfQ&3d6sgSqe?9#rP1&<Yq?zR5fS?r4wut8G_2F0D#~Q5}J_j2VIHY-luZ
zxu4*H(1=7nf4_IQ)!lO}tW?<fipf6vFP77Wmk>v)|0pU~^z!`uJ&oz^%%9WE4psXe
zC;&$OP#7pnT58#xLskF4p-wUbm%SDi4F5s;`Tq`L6+rmX-}{?6{@3E%)B!FtD}4KR
zo6aoYgjASE^gMw5V;MKk4^Cxo?C=8?;Ey~1|APN-A;SM}TW}q5?9~Z-L8Bu1nx?Xj
ze?z(Tja-mODY39k{50&VICl5UU`sMKMRu;3{gF|T!~C-DKSTzQo=7!*@>>2h36a?I
zt^mvbU=;z<RRh?h=D`t%KjjY)#kT?gPMh_<@}KetJnUKuAenL||D)ZkJfQRcqv>$E
znh#**Y62Q_{$U`vqFMle`CFZJ>VJ*t0D!=+r)2&Q5Wg|7!}2nre<;ZLzd(LYV(U{_
z{ck1l18i8!y|$QtjX4X{k^ir73V<<L1bzOEM=t<g-_K*`4|De$-75!-Ijd;@Z<F^9
zczr+KAhLgL$^XCP|9cw8|I?OSeD34+wqfvg*Ma+4P4$${^X!?>e~|CnjUQS(dF|JD
z?0AMa9Us5t_&zRdm5jtTUXaE00zi}DD{j<#vD<7s`_9R6;xByle<UaG8Ziq*^v;T$
zqM{vxOUg&nXAP~>&Lp;?S#IoFmUlc$25OU@FcLZ#|Lqq52sypB4Wsk-h(=9wq?}@(
zy%Bdky*-uM_sl;<{Vi8I3B1(D#pU70pV!M0A(lYlJMd{zu^5_>Ke;aB<Bfm1po@Iz
zn$$4oP60=A<V>MCdgk>L%lKQ*u0K7t{(ERZ@i%3n#5x5Eh75a~153G{C6&a4J!=mq
zc~ki3*bZFjs#iKUCi@seSX-^>5&N$_N~{r;ayKUO*#G3V^zaErPA<=U_;4AoZEH#)
z(P=jT#pz%2XD|NqX#(_wod`7CWVQK<swg%|V|1?<68!#+{omRY#la&rH5YPJzGUHh
zG|BMM><@mR012VW6*}n>oe7A<z-&2okq!O#!_{bjmaL^!mBhJjRb+Jr@qduvrJjI|
zE=<kHMjJNBJ*kx?J3sFGj}M;gBNoWm{K(uZ=lAvk=hcNirV7nJ$R>FRVu7U1kC5Jh
zgJviK)%F`^{olx_XO*koZ6GP&fy|w03JEQnuQ!ZSz1M{Pd;fQw05(Ez+%&%4n?2`e
zTy$}US@`e40l@(}WhB%BeEFV(_CfdiucJrJaQljDpZ>A^?S=%s1NpW4b^<j^GFeC!
z6NOX0KOPdbL)X(0yNP=zxA>x*0U${Ozv(nqIQ`=-xqv8M%BhLb!~n?G@P}KkhSrVV
z{*w(QB>}+<P2%*0u~5eZiGT8PCzXi@-9ah(f>^tb*rnz7=LgvTSwG+v4jH5N*VpoI
zMvpc-b_J^|IsAE(9)f9YMr0Zwx894G$o-?Y_QP-B^ado*3UFn;?fe(_vY|A&=LaNz
z$DW&4Kr6!4NDGKWrsv^~_S*0t!oZgf!Bp1c^m(zAf@7~n0piIYQ<9I`r?*jjLOh3I
zmJPdoRVnPxy8uYSg`LTJdG6-@3(=!Tjy_=`x5EGY0frM)y`q7{e|E_9oCZt0>a82`
zUTyeuY^iQACO4kTl)QJ~M4WgI=-fXzXWydm=iJkKSb#O34KQZu)sE9Z|Le`t0jHB3
zL{Q?1!$^Rdh5sDg2*|Oy0|v|YkT8RU_|bnZwjLKinDeA93s=y@3lX*h*}#9S53p(i
z+<^DYHF+9cWyt0Ck5=QE2|Xx1s>{L}<P3<+&8JAAKPS3L3($$8dVGv8CHq)_B_8z7
zR4{wX{`reMEx_qrQM~UV)ZaJoKPLnSnuizfaY&HZ7MuL88~we5+JF<~Nuj>Xiv<hw
z$#wp7chl8?faC?A&VKC@3yDhTpUk};KH%0z+=w+Yn6T9NkDb+Xp#`{U!T53!Y&*e}
zz#nhVCk26|Qy0f`7BJqS7i8*{130xk|7uh4f76H<cTmjFpCxzqGwOfz#^V~}IjBZC
zuh5_5O3;WhN~Z0K;+B$nOD0Bb(A~n8nt9VqCuC%}BrNBH)2k*F5w9xIPnu@QEgu;}
zWH-hjJ`;`#W5o)BV|l8w)lFv$Qo)0V0Y*Kwzrz%@N?_%SGDJUBE{XK~rmaUoOdiTe
zK}i{P)sHs&T)#(?xQ;}}?jO0>HF(^DC*ZClU8Jl?H4#4+m`Ft}mv4h3Vgjgk3ARy{
z=<X+$D_^l{Vc);ht4L&|T5Eb5@OKZHMl=M9Symb)*9nceF@H)6b}vY1u-~p@UH5BL
zpLf|d#ucV0P`<i4t{40p?FZN_Ul89*E=PR6NH*#dKft%M-*QBL_^J8pV)oDWz;|QK
zUh%^FoLD()C_?t?aoTeJ@@~Mn@?dg+u(diWo++;PxO=%IzI5(-z@{@y)y^;{jsew}
za}*!7S^ZQiDmKsHm(-DV0K@WgRdW<~_X%oXH~aX*83WONGY{p%F`ISEr<7lHOBiFV
ze<-+LcRoZ7nAnz1ve+$h=14j)0%R)2lT%yt6H9mHR~mW1nI37{2eIm|5gpeqL0|US
z#lwa&_D83``I<c}z()gE_)#Qt|52u>8Dp-vQ|laY2+%ek*TYK_+q*WZQE`{6y`Yr9
zVTx0eaHU8O2hOcacu<B)a(djmIbh&a^V+uGI?E`bCdvTV0pX>!B)6wBc8N!1*F-LM
zmI@`mdsJ_FSa_sOD9?w5Uf=(<4<|C8Jd#X}7L618I&{Y<F<2zqP61$KO%!uH(!tC5
zeQw4bwguq|{aPruecL?kZZ{cEH(1#IXZ<m^0j)AG=J{jN+FW6^xYBsdwGuK7{-lCq
zmn=9BT-9{ShauSFiwSogn3W9!dcrw1!#U@LPc(=Y4Y_cu1!`jsANa6$m5OIJ-P#<%
zPh;m>M!OA*kR|~-4T`o*F{Np$=mdsotK0Nav?zv6K^>?1teNeibdvdZ(n2v4(rgX>
zIzOOukuUR_O!B(N3+rb|S>u>leWA09VWU#+@0F4y)9uey6i}G+8MFO8;|4xxm%Zy0
zFSl4?!*()fDv!@CddJaB1<}Mu&uT@;tA((n`*z$p&?~5pj7be&s-JP7q<rC@m!Jc)
zYKM_{64r!eN@j+;2E}#4mMbhZ-qODHlH?Noz`^$%{i1D)X<2rjN7>x~N@q-6)O@AT
zoP{DjEAJZbx0EC22sE?KlpKFtooSJ@tdYIXRg6+0?9o^u`=ggdtXKWIy(v}0eH|{#
z=Lq>Z{`N+H5m_CBB}r@<Vt==&0UQLH>QbZBp=!HSQngURFdVL`hf0fEuon{Sw_Yf=
za9FZVdf=A8#UaUNL<E*>;g@F6HlsKFQLN(JV2q=I83^Aa<sB+u&}MY=`S^NEbJ?e&
zOeDEB{8KMBq>8r7foQ5juKq%|8+;|}$-c|feL1<7dz}bW`^oau%AD|2-%Kme)}P^#
zaT*NMaCs`3@h;f41|9;J<s1+DB;fjWFfEZgp~>AggEPhH_Xg;>Pyv1;<qNS8RtGZq
z{#+YxW~$L!>t9oC<cg)t_#ExQRQ(`H`u4t_`D?Rj*6SiSl0iOFHATxS2E7BO-pa1g
z3Ax9q;N)WAGd!Ei726+U4w8%BL@AmMC>2LEN9lw4AfYauLyMBdQWpwo;s6(WdLa6w
zl5l3xq!@|Rv!U*{ruVb7Kb3nu^sHD^-ijUpsDQN|BSRW2jm>g$=$BTMg5PZ6=Dx$_
zu?19_)a|~bWtMuONqQ$(>bckG$p=WrEc|!>mY^HZ1dh_Z;UC9I9OAQH_iUhTF-+j8
zC?Ot8u2RwDbfHKKE|=G8=2!U}vS(cecELhtxj4!)58S9+!jNc-Y@|!lt|m)r$Qy+_
zrn=<=sIg=ISm<ELa%;&XPN;>n%&QvLUMEy<(U>|v*DHiQE@r7FubuZI{@}u9ODU>_
zG%iw-y@e%3UA3jR!}t-@IfmC6C6~m#^3vv(m!&jGdoWkb{A#R@Zr!ilHIGBp<u}}b
z)-DLJ=Vcysz^kbJ?oubk0`g9o#hKZoCMGY|YzBPP^w=+~;%iA)Zt&>Uj_B0Q5=sIe
z8G7n{s6M=2v%o027ZkQQ3+&0;r_Z`Y+q3PqwOPGi+NvWfR#t+OhCU@9-NMH`g+?bV
zxm_;wldeW0-%M|Qc3_D`gkK9>VB?%*I8D8#>8tH351lK}2BKaEO6%3$k*2G0FEE>J
z`7Jh-!kCF48otIwu+|#7xmz!(e`Y^%6?RQ)xcsxBm)RUu)4E0K+GnglE=%vUWp&DV
z9=TKjDYQ>kKhU6$c=LB_qKn*-v<_ddfe&^Q^rcIe99k3&c(SbM9m-FVX_$1<%U^#g
z_vH-K9rz~XX(kWmCN^P2n6EzUk0WLb6g<;=U($LkewI^cZ>~7N$2{^b_Hh!&qeIrq
zg9672QC@-k>I|x`*_*cvH7EiY=zRAcuG}m?ez^ML3$Sx%*f^j12j$ESj{BF7U)X3h
z$f+r=E`7lYR7*;{%V*?7t2~RV^0x^;^Poq>m?Msc<PdyQkE`VbZ?&DQ9On+1NG6|3
zB)TS#?tL{bpp{=h#ni9SwUP%Z6td3cYD@fQ6aCINQLE;^n>Z;!*m;RYCv7%bxokd6
zDycxox3sb{O^{T#BwNLiFVhYPs<q9TYv^tDJ^6dHTksJE<X}^~A7%`80k^G@+|T3s
z?Ot#sEG@S_Tbb-jJy3|tn7yv;nvI@q#9k7;%F9>AjYsPz4E#JPU1Gt|SP8I)U*?do
zcs+#F<;dw&3EMime0!Hr;EjFJcI^x6_cKby-#one_@p&7c=9~Zy^(};m|ik3%1bR1
z?rb{&IQ$8mlk>7XX?Ty~JG6T#SjLVR!WTuHq$iYyyQY(Q`(o%CcK5XAiYhG=rJm=9
zQ_7$IFKgdgH}^e%p6~TI*S}`Bj?myG<IgKu>gxyIqbt4@ke3OsAo{}nGuL&!w?R(#
z)l2aQn!aAhW&(*DWmC$!?3+(*ujgIWAEjFL8?9AR_SwBJuQDj@3Lz&Zi3X`h{W7Ho
z_smp|5n@m1rPw&=!NB!yN0L>ZnS>B$#cM4gpr>3Puk1p?JJHbjFN*@|Og;R^(_XBq
zj$PY|Y;D2(kEi!pDNc)dYV$h7P^7mZSVda31MAy2vcza#luX>L&J}w4oZ_27s*NKZ
z>)e{}e*3__2)|Vaqvu^v!_^v-XDa4L;kA%l)@o}f+w0a<vx!YZTQ4?bZ3wWhld~Td
zN?DrK*$iIPciJEoSCF|1+qGu_YsTk9Ca<`~CkN$3DGW9MRF$I94IQ#iO1TJM0E*8s
z8Y`no4>2_35`xknPgrvi*giNRUHWL*gGBvx?FRidOP1Ea*S=fn_V<Z34EEd<m-W@w
zJkcWDpL%U*uqutw6P*iYKTY1gFG-?0vVe6+2#(s`b*>A(9wBhyRm<6?kbI}V=$#Ky
zKJFs!pM_eD)E-%AEL2hN*mRKI^zP6$Wr#q$7Z}QjneyyN?3m$V?1s2_gVqF8ofvkS
ztg7r|_47r?I2mF2_e#p8Xy9uH{m(bZsS$}rgN9(sm_CBndCZ=1koEPCAUD6&YoG|Z
z@pt7}4W!6y(O^d>$#;os!O9ISzLrgzUx8LoFN^Pv$oh^RKHHHIQ;&M62E60mgK{;3
z+Doxiz}80M_x`%}nI3wKs+%P&tcgcrkrBiSX%1G>SXdU!kAP_+K&6ArXf5{QLtFXB
zenoxn#pMq_`S?3>evR~5ad@kGDRI1a=wgWhV?b-Tv+*6E$BCM*)S585$Hq{U+O|W#
zFkCZ}U-Styl;T^JP0dhMOH>VuXRN0I;ph=L@PlRz9=90LVDU_S`{HsOqGb5uCV%W!
zRCGmNkmzL@-;okL92;q9vTME{>{2xnEQ)chv1%BY$q=t?sug#rX}NBy7&Pv5ki_&R
zsQZ__yu2KB)8Myt1vtmK2m^1oblE7101;up99d;b*oXh?+6POuqtG?}<kS!G9l`TP
z{2^jvRs%6~RzJixlH|DOzgS1|R~m{wPzv|{wJ3duk=u%<x|^^ij5;^d#-H=Ub27Wa
ziC*K4wQ!kX6~d{g<aCNiLw)pTQqhO6szHdwK5Z!JZtzE92LhLu*ZZzB6jriS+=<MY
zm03fBYDKynsY;it)NEtaQd&TASl`sWWL!`B+83fM`bXjlcJ&v6{MO==bC@|=vT(9+
zOFAZ#zNl6q%kq~g0l>pW*BY~*@{ij$A{zZ11$94rn_iqK4xb`v+0fsZKOQTeAY5-{
z{XczoN8yJ`O|$DYw?A><q^a#oucV!p&Ck6TD~{Eqb}EG}2#`tO_~?byHGwl`B7P}a
zq_?x`N3JwMdf^6?QVEygUd6Yt-BYi(>}c4+ce$JFgt_BYK>?JJYd2SV_(KgxVh-JB
z-eysNY*a%HE6{$kHqGwYNA1?a`=Ue$(JY2qkV92JE*HBYvlUHMJaXZgOr+JLYBT*9
z7Tp}XV==ReQzM!00ZFudn3E1<TVodeI$;B)s?&RkgP;-Q_M`CPT9F>>r#60Fjns$M
zzLAMpUU6i8-xi*IUX=HeZF2Mt`4;jnY?hj}7_KhABl%yc=X`W7^%azVO8qYzg7`{9
zkn6X8BE}jH{wdRYTlrymB!l}mL|lfPw^hk_A`PRMsS)MhZ)xC3Z$h}jBFlf0SXYL%
zqJ)vtx6i8m7{}kd`$%X@>3_#*_uaB(v~Zzsq?oF*FDz%OmIAvu^3-yAh$R=+Xvo_b
z*5+5y%))<1&XGqI3CnZfJBfJmuAV&4dZp0#q~{~3e!AWIsb`^xfX>wm5Dn=Iy0-aF
zHN@1p>z^zT;g?4Fh9dJKMRPel#wC_l)^-SsmU~4il4l%ZrL${#3Y{EvlUi<vO^1xX
zoIf1PqDo15+q0KWWt{e=f7Y9ogA?CL*#2Wz9d&NPqd~t2$%z4**AJ)#Ih>m2_q8+|
z0<uRP$exRWJFSnOp_ym4lpG1D$5!FQ3tEwhL5#bbAMn_CieaP>Ebq|8P$E~^LeY}E
z8Hss|Vzg*Dc{O;uvx4s1`r4P|k2uv<F;a=5<QNVT1gs(wB#}+qLQpG@Y~B}J`eK2*
zKKFF(Q4Jx&P!TaC>Zv^Y^ljpemo}yC)_Sk51uQat1KM_WTRFA18;}QdwqyO-4TRqV
zR-c)=gn8#<g;>FeJ@w{`#z#$A%vU!*FCSzn--e8vH&Z`}S32pvnh<vvlsdc9CN3|l
z>dL#~Zu5}MoQ|(buv$_2dfBTL8@66?ipc@zxca|5+!@2UgNysq!G)1)_1Ika#pQ`U
zt#<UhBi?3LZ$hcMZvv{9*hyQjv<Psv_$3@W$qm8MBJn$gAKwL<(cTQ;Ars|TW=>mq
zb>q<APZ4o3?Sbf}4(Ddu#?8sK9mWSERCGO0LTKhKWL$0a(HBgbKdR8BPn9}Xy?pyL
zSigRkz>&T5jWD;^oL`g$uJ6!-{YLe>eVc*V$l81Z2m{lE5{biFVB#btNP$3_&{oBT
z<CQR?8s2^pYp1_Zdx1aBo2-`bSf&p#<URVOTfloqO86#eu5VJrcz%B4LCB|iKgUN=
z;)ON$V53y{Br1<630i2f_9)0nlQ%~G!q~Pi5)clx{|HBf5HzxiX8-0jKwU^E<H^oL
z0Ydr&J)Td+sL6{%J1K&)jO=)sk+!5{vNt&v{pFzy5XpE7Jp)?vJmeB6nt<|1-kZ7>
zm0G>HU)UFA)N@3Yyhz|7Z$Mr&3<$(x-OTM8+JO`<>XKqk7NT62QA6@XGJ2$305%_M
zpCa<pPR*vtNb7cmPX)Pm)M2o=tl(^T+12=bPqNxuI}u&>1Mfkzj|qK=?1O2^S^N8f
z+$2aQrA=rkrjF(Kc2{`#h<dVKWrKJ!jlv6iK3j;mXB_rZx?>!u42hnUsl6@U*MHaH
z7ytQ9%gm!k0)Ei>7c^AT0Wy1ot1sU0bh*Uvagi^|*o%S?eY|787#<ovjpqj<1u(hF
z4H6Ji^~TmR5fSo8*hNtVxH^AGu65MdEX@50nhvv`dq}(l$`vMkGG9dN>uurs(r~7t
zQj`b5Q}VN%!zHVK#KJk#V9Uw`K5=jD!9}e11CGWc0>cZqc6>-%%&OpuDlEmO$6%s8
zN!ioj@@rIBPlY9vkdw?y=*yL<U3Rr6#&wLsG28uJbt^W~mxF2;->~2rM8{q>4~J3C
zZGp#UH7Z?w4y(npZ6HIBPgjSGUqA{7?9rLI1Xwn5cI<^56b$|G4xL)g&Ky3oA*5NR
z`>|#nlT<#DjxOQTn!d7-oiUqtva&uwmapVZgz-y4J2nB67O}pR2*oS+32C8ib6`Q!
zT6@?M3-e1^^~Nw9j`nvz7!69(1^jE8ZnG{sUF5d88~Wv6AqAWvL8!`y?sV~DSgZCJ
z6@L$mND1lf7-4WSVR*dh33_%BZR8T9Bn45=VC^9h;$z6?{zf)A`2*pwY^B*X`Ie|A
z#fwa$>*cA#4>$)lWOZ(im4I;rvvKe-d;ST|bREtgc}9uyuB{>6u}N{kIOzBA@8RmJ
zv|3W%0r+OeQMAXHf=>t<n(Uqq*N(9v`pRg_1ZgEu`Ce_T)rnB)&Dqmun%qQ?wH!Kk
zUMpmI+GD0RB3NkH!_Q8BzmqD{MNwJ)s`6l^@5Cx2NOsUS97UYK(%WmXJ4@gle|Y;z
zIrP|okzB1HGFdd}KA1f|?m*EkMt=Cxf1~H2TEO89)xJ?+gGFw$u7V|h$0I$VHELSS
zS6FSUZf$NiH1S_EW5y5OW$oeZPA7_OnyC=fk77P!(W9jvKnkp<ztXlZV&iNfG2Y1-
zDWX-WAAA#YN5g4of;vbw0p_u#_<3uH;;MY)=*sj;P@>KS<GeVA;3&GDstS6IljiGd
zIo5`Xj%&li11{9nIfAscW+GUSP_da3Hw3Nw!pDYZxODtyR-&&zfeUQ^TmEP=RjugF
z>6SAyna!1Dzpf$LH0Qq8R|Y}_$V@6?nNQkuNJ;&Y8hdM2=vw@IaUmu~?+%yhspz<!
ziEBxPILExdcr34FViDd>{sgvU4t`T*HjjRoKS`98)eM<6c>yK5+4dFB{g*Z|o@*0h
zbN4_uA+|eK2w(G;%&^m&wINRXFZrn6%nUXV>?I-0Sf5TRG3=rHHI(>}B^xSJhNNUx
zot!>BQBZWUavHXe6jizeQYg~&z5`i)#rx*UxUF<~o8f8?|MltOuu1B`LB-5*(fPLo
z5`#Kjr4L?B1e0SU#n-!d6#DYZVe&%k)wJp6qWcIF=&!{RM7_EmsXm%uMFbffy;$A1
z?GutEg9~O8Hx68Q*k4Z+NiOoUTPrZqnx-rqGeV_MONRJ_yuRO&(NvkG;UYQ|j&Mi2
z_;P=VxN&o=Wy#l%z2F%{z(fLsh*1(Sy87}SD$n(f<ml8l?P%Bh4BQQw(Y(B%{P;DC
zH#wsW>)#FDk!<)i9Zck}ER=NaW$n50{$8qZCcsypNNAmebO3)tKB6c7lA~5Lg3W8P
z_X7@k>+A}^sGrJDe-R_dyOEo;7q-k67?d197kEzRZT-Jqavx12(XukgHKQuLt=jc%
zEobEO^sN=qz3SMXT}~#aqv~O+iq9h#q(A?<w&aHRxI&BhzC(@h^$B#1tkQSU(WGX2
zg0`Yq4kQ$-PR2S4CPq4!U-pT;ZC8TW^Ju<0G&kqRVOvFvoaw}*Cl&>C@PxI~0tW0S
z7-X7aOg=E4Gx+0LsA1@;`%AnHgAm;qm6W9I>>wDI$IRUF=AL=6u3y--u`6}G;k~5v
z{1d8cjm)E<E0C`WC(r1qK2*>Lbmi24pGjhOwr{ousl2_`8F6Dw;?@iMkj48=IoxR8
z{|0#Pg`tt#9j~@NycZ>ydoF5xe4gTg$-|pKky>6yd2-)AxYXPdkhiJJuuJ~6fd4W{
z5&4lG>8;^vaRMGS+j{VPmy3^U`S6a|#M50%tqwKqbe=d6Rz>Cx(Ze4itUY|!ruK-h
zAFBEhq>gtrJn!&}j2)b&s6-KCu~HBD=daV5so&1&vnkR$4wH)-&3>3w?|zWQ#8GF(
zj<sn^lM6vSp`)0%ZP-lPGf>`dAmmY7T^=8GK~eHsZ=QUlPahznwR+#)I=U@sQ7j23
z-p(GocX60+So;OBt{zh%54bPNCvUN4xt<DtgKFu{n!W-((i7Wi6vrX4P%G5Okf+y1
z1+*S|H+<ddfAs>$47rv_KQO>hSQ~dE`&RdK$j*-V*S?8}jG`tVmivb!=)W8rkkV&@
z042=S_<%nkKzvYtxEJs{6Gml$U<W>O-<<tlmWA3gc?o`uiaiq#Ui!iz#-&?N1bdP-
z`Ck0<(4|DDk%wG*^$fX$AUA?cHYxR7e`VwV)7K!M%*QuLe2*VpqsTQleWAX6^8IJo
zJnyR`VeUg(?d*@<cO)%NH_P1wvxOR`J7x%59Q+7vKiz;}uVXbC5ViaovZ=Oud>+$y
z?e+H#{>_BdIW<K0MdjEe3(Kx2e{ZSp%m0*Vk;bCx1pDcje_3=#{2g)$d)+7@oP#KL
zXZtmq2S(hIt*=5vhRSv@De@Ik-kUCqVcfz(kqDVWMQv`7m-b%#=+;*ECX=PVUGz!^
zfmQ5wEiFOgbgEEHIa{N_Exvd6`l{Y=O&+Z_d3_#oy4g_F;BF{phobyXdBnd8F!27O
z6QO5jzhZJ<#;rcut+tv!*IFPjAh0Vc3w1ca*Ev?UFA%Z6AbFpy!Jd8ggcw;yQ$>b=
zL=Jb+69}Cd)e$4qEO|(2X{OCa@WN(<w4KDJsW}MA)Tx~x1ut2<pH`clCsq7m7mEa0
z$<^R724L&O$BD6-Sxb=i3me(B?AlpOAO!GfYN~W>pSHeh_V-qUa{8RS+di>5)hk-P
zoWQ~%n+=S64d<S!%@{Nr7=_P>T(fwRlh<KL%_NNJ$(n^@Z~9{<b~#@MElqdH+PsfH
z+Y@s!u%OKoPIcsQzS$}|;T2=0o;sB)r)z+x1ioSr%hQw9suJY8rYCI_B*|{7wc1|T
zY_d1x7OR$)&7kby)cSNOtGK?F3r@9)m4keR8wG!kmu#DN`t>$<K4(ifmGZ9w44|FL
zfFp=d4(?8#0R94Or7OR!TclbvEpA*>!O<&%<1s;eWFqx=Mu%Z%TqqZ~kY9~#EI=s3
zoqsYtlQ&+UfSzb5uKc2bL^guE2T<sN4TkLgo`LVCN)En3e!JgkC+ok&Nl+USTB<I+
zY5^%+XtgER(<cxH(XhN^!?uGY2%c8xp~jjodZH@GJ!7_wEyxHZ3Ts!!MuO?<9e6Hi
z?&Lgtq~U-U>1E!=A{YoB8F;(KLy{P7)dfJ#R)2VFv&|O!<SsGmWf)dY8xU4}we@x;
zUwXly3wbFNR;@e}m1C+cueEx*FpvF)Okqq2sYFOUc!9qWU|LwEZxoT4(M!6DweXw2
zHzTKvZS)nKwXG@tK81YWd3o&lgW8HVoBW{NMS1t<KV<8gA4I(O*(9R)Rk<?wVQ`P_
zcl_0zeXhOPB5C+8APNI$l0Ja;*56{_O03u9aSg?Dhc)JTk(=!aSJ!9tU!*qbvQUbb
z=%tD5CnLxOfubl0a|_uS+r&>KomMCMBQuCiZn{M!^cYpCjS`Z=gA!mW_2k&sOfxeZ
ztQ&zFU?#&I>c8aC+lEX+P5VLcZT?tswTd@x{3Z1|r`9C#RYnH*{KzVnH!7aDhLEi}
zd1I&)NZRPjN7?fdO<g7^9TKmq*wGn&Gfk5mwL{iO!*30Q_w;+SFPM4r@!D>c9J(rN
zA8W@Af1@m64#cnane!zSWb=u+4?oH~M%`4Sw(Wf{PMEt6ts=Y=JXpD3C?>4{cjXYg
zPvct@Agm<KGtArjjYm*wAiu}l>WRC2W}}zN8t8Q8!>Qlxw*#i@*Z&)z-8BWm)?dXk
zAJ$HR1vD(d-2h5MJ?qvF2No>IB5PJo#d!EiiR{4iY!0-{$9mK-NJN(lC6ht*GeQK2
z{Kyj0J|D80)RtTnHaR0Ip2b^Et0mFH0>D%Z4?=^jehF^qnY{{1Gda>%3fwBM4otIC
zcmZL@Zr*yEXT|&l<Vl>A6jSMye0&(zMFo5zU5@t9BiN5&(?KHCw`8_q<<Os9u-#0Z
zIl6|W$G(qNbOkws?0$QAQwb>}psUO2Pnixfd>>EdrB;0Gmy<C%#JT%zIU#G%V8Vul
zO!Tti@(MkAi$gAUzn+%jzPk^aqm~B}*Y=F9_QJzCx8nN7Y$1Pyrx?oz8K~Xh(RFD~
zyZBuZLa+dmhR#U7h`4jL%1`gI3gVe<*C+n3IhT*w3ySj(>%>+5%9<bcD2M{Swm|Nd
z(Jt{)m{DMCQ4COPd-*8xp{_SN-oN#6=O@pg%0jlD0Wo(!0=>(7*>;<~Ol-VPU-l@z
znkkih6Na=9Q2p$vlDVk*z#%*{CX6dKV&z?XPRAA1ge}k&R&M6NRJKmGAjKSQMZx*y
zRceHA6ytdQ`a#mhVQG0i8G?;k%=^=oP^=1VvE4Bo=&9;D(@3Hrm}>F#o0O`#U>->u
zY0ooe$CxieB3w2k*v>4o`ij%5h3qNW)-FPe85EW8UV*JmHhV~1o|c>KzKAuXyL#{S
z5646A3Sm~Ot&$jl4YSun1fF*_Z_$z`rrOfvCdvCm&R$HNZ7-g2pS|YD4)v8COrX`(
zeofIxyU04X{&t~0%}rCZsYp3=zV7Uc<XhG|CxTmEgFh+$YwCWxS^bQmuR1_p@W^&v
z`P@@@0H1w^n;Tp+j6Wv)r6+_=FrWjE#%z6ASZ_*2NNBLRwF-t<uvLd4`8O?0XM~TZ
zx2e{Xm<a-+Kv5JMF&>Iu;l?!m(BVzF$(i0}eAJbw`^CzSoMb|u-<;-{7pj<yqS&*z
z&^fUkt4zFx)g0QYHrC+o8>|795&#Ehv)5zwW9A%Nv?2!^99~f`Ba0q78}`h2AU@uI
zO5pf^@b%SiQLkIyGjyY*G}0X^NQWQ|A{|3X2}2Csos!bsAksYyjUe4fgD`Y=_lx`N
z^PGLI>%Gn&F!RIuu6y0<6KmbrR@{;AS4ZmvBV^mxOA9<y!b0@X8eb$uhospt1Y#l^
zSab-Dr%Denx_!HgnQ=*=#30uN<dDB_Fyt2*L5L3XKU99F)%Cl0++YKrGfy)OPlD4T
zJ`Wj^LN4u6zgF1==^=X{)~W_8u9ga)uY~WF`P}q4kHv8wjdV!-)qy-+4|#uz+sEjh
zI~KsSaUvV}pN`Io2-z1?&@<^h<H1{SydTCn6Hv%MgVOLwQuZYrnbC>7F;uE>O=*;_
ze)~DxpMwDBM_`lP=Rm{V=kVN?FUZOtD<yGZ@n?k&PA~@I3w1+UxBw3dHo$iqLBQ@a
z@-08aj@@MnAaovu4vn8c?d|;-=BgoUf(6=WpUjRf!LU+iW(HNnN}@r^;zNTgFkr>;
zM2Te)4A`jUP<3X`Qq|VNs-Hj_QdF)`A_S_gnO#}KJdaZdR&;R^hid>#2S*o>RMKVs
zfQ8kcl2?TZLqtlD?7c4`Rsz!f*7&6Z)1kQOQ#0G9&y0|@JM|ag*O60DXtcqDzD2_h
zW*z<U4cMSS)3&_)(xYp@0K@VA0~rg^ea+FI!2CI#(NFBn?sIm^X^p2Oqu1qQ`jcc>
z7`>AMu1(r*UzYanWHzO}P^a@tuD?kVBG3W>?UO(BKDuRQ%i|=;blxT*sSAh5pML85
zC<`R$cxD$v1oiY0cDv3%BvwiR;J}_itOvmbbP@?9H`nW~K#(;sx_rPKUE4_PC#`Z1
zlv;Xp9Y+OAj~i0(3I2()+*O3b9p+nxH(J*n*dxbE02z8sJpJ4k+$yf}(lm~zdm8Re
z=sv&WPgTBTrhw!1EWP#_RhVtMohxJpf!9Gnd5?oIhcFe+C*hXeUMj1d$0c()wP7g4
zG8J#s>XwqdvgB1M<l-wdWc>|2>%1<s(9?!<8X4R5*KOU|OP{M5m+{NzNpCM4SANep
zDa?|XXBs`OUM^X2`fTHJYkcPVH+F!?JzWKb`L3R1Kp16~&GPp@vVjK(*r0oBTeY<&
zUdjrWZV|&FJmUhAB9Ip>6}8FvF1L3@-@?+BMEA4-*rSMmFrhcJ@2O&G<|eZUIuq~6
ziNsSDS6x~S#lggt#|dCoAXlbP$}Uiy`{&ObyaOigau`w!7@d>+$gvvc$sLqOzct4+
z`^yuA?$3xOYrX&jDR`3$>Y;;`HMF|NblBfoTbJ3CfU!GXlLndt4BCeUF7=RucEk)5
zD2oK(+Fe25l{ZDDD(ha>F7Q#w_PlxHAwcT&J4#fGQ2kPW(-+b2gc}!{a@o`bW=x(b
zmVcz>sp{w7VK<C**ztUBLv($pW#`WhUEizXQ$UB^Ave-SRYchyqvGgPecl?}#DS6~
z;o-TVNSy`&JvLrv*&KS`>RQ`4PmNIgTWX-z_@kxy;3NDWJ$ALIDkeHijFU>yFrB-T
z8W7i{jl;{Q^pI!JqSM0UNKV4nYc%kif}it2*I<NOt-!Ag>p<z1UnjvYjk`{&EyxVs
zGe2zEi|Dn_KuXFwB?B$#s$Gn=c3C`ytp)ooBm;Im%&p@uaX>KxNj@Aq1pXkk-rxP*
zaa8yUG2?W-Ma?pZZ<&F6-=i_NR`4RFdi=m;KZSHzd3?k9u2eb^nfpN%!{<Bk!n`kN
zWzbxmQj#!7@u-3NrnN-~de};HNQoxgeR^asUQ}|+T?RAH4&aC7q$!ioB$<-~h#~6q
zPL)V%>S%3RwER^%(qQ*Gf%N);TXYpvudnITzfkxO)WVZ_9a-KiXazOdQztlnzjPg?
zq8yz)f9{#ncC+(hH8I7);}>W1nD=p{EgDCXBgVh(iLECTTQbsy@gGXs^N@M;d$O=+
z$m|Js2npx)FFgb@7RHGMCB0AGzujVYk@>6w-(S5pTmcgKCVL;1NV3PF+CviWLPSI#
z?o-A)U=?yvNl&}RP#Vt3S<j`I=bGgowLnsgqgxG9d&PLIyzsnC4ir+V5<7d2V`;ff
z$Lx0P0i0)2-0cp2c5BU|{pO8$kiKPm#4p#d(2$BrAY(t;K*`Vcim5U=U#XVaml&-Q
zU#PwW1BhM9TyX<_LGt-f42uCe1En~Md@AQ?Z@=EZ>Ct#TO4|8bMK)&vswVdk3#!zj
zwLw-!tWCzUA{^D}`l$Q#Z|@g8e)1FcR8U7CA*w$M-d(#aIuZ4f80XX{FV8o%ouss{
zM$+N<VzT@?!M$79Ih9<%!max{9+R`O?Qypay1l)9WwOlu7wAVqz7p*^^Wo}#yghvk
zA>T15Pq<#%u&ts?{J^ngaA(`JhKjnP5^dWw?XwsHggu<rVw>YU)lVe}WPq>gfkxRN
z=jjanN!Hd46&Wze9fqWHccfXA^C0~_U?ATxBnoQhNe*-5NPI)@WdSNEhlfzz$nvv^
zX~p(=5Sjs<exS^0W`7&Sf+7=I)%!(o0A?mZhV8-baY%O66DzwHASfk-Uo(_tExoAr
znG0(M1=3a6&vIOdFwL}GQ)Lq@Gj|%8RZh;pa$(7*&NI~4rDIwUUy0+&^G2HZ(8Awj
zC@G<r0m!w{&|#rsD1-O{{AOMQAznjkT84w|BTCVDXCgIY(#r#3+aOPohb2MxhH?IW
z5?L(AmQgJIQ~ffh^0tn;q=rS7Q_IOOndZtcT^>$mh3u9OIPA%IkghGd6p99#7RKl9
zS-so}m*ni9)vM34<y)-j=uQNJlq>*T1E*}KcK3H=OP@vWYitcgMPrnR68~cGDvSOo
zDx1?(|0lM#UnU|%vWSz^FWXSKz{f^h6Yj2~JsLiU1@~Wm8pYG<%3eQ0<hufga9)er
zt08Fsf^WY0X5moNC_D@7I}UTSY3X#UZ4>;Yq6Sz$LV@s*sE%ldtLYbdIboN%vmcGY
z0KDut4lo&6LynYBv4)1ML*yERY<rdGTj*ceX-JfDG;v{;01bSXqW9Vc;U^tL&%RA#
z%iYcKDKq=Brl|HJx9BLRqJq$1fP9P=147>-NfJZ!t<sfN9zbe&Kl7;=r8r6V@pIN1
z;??*r(-46WIlT3F9+^HZ6c~|RW8#1?yjatZy&rwu9v!xz8*U`;viEh{rJT5#vl!2+
z+5iKR(9s-0!QS34Dn)gkVCu_p6~jYgBT|hpPn_8{{cxw}V@tbg^lA-TyVKzha%=c2
zfS3Orz*E#v|F$%NhS;Sf^0+`1WFVt>0;mw1>m<~9fuV)dg*9`J7)=G22=Z+t2w4tm
zqFE)iMn3!7E8h1tyTY^Ft~{+-aflUx7~Z9bN$$xIH*y#gr<!)i*7r?c3w;iH5~%A`
z1CRdukrHzSe2T)?$O9Xwzki3ticuY2BlUs=V|pQ2TJPkH!tb11V7?i=m4wefjUjul
zx$>l_!M-?5<|`;qQ-cGHd29-J?GN{+i5!8lJfJEJUyWR<5(LS*hG`oVM$W7%hOfWO
ztj%EhiAWs^fhEWj=rCB;tLg7tQH0dCU-}Z0>|l<1R=l&ecCs(qS>X1JtVDxt(b$|U
zc%O5u!@&0V<f?~2Vh?~iGg}$f&F7&S9IhxK1KXE`+EE?@%l$)2N^@X?N6d>3DvuVM
ziAT!7kbmW5%3mR^|7S>}5ZYDG+7%PEgb?5Wo}04$5+S^HU?`s17P~l}2O>2BJBbpv
zVb?PvK|>rd&x1lhBY{sjv8?wNBU-61)}7=Hs63u}h*+uhx&PP?Sv*5}g3+8s?he|s
zxx7serBp#Z9RGB5F`51@pcRs4O1f{!RzYBx|D_wuRfCFHB&|u8q5xRkKW6!s=@c=u
zQK!gq!sFZ$d&cq^9-3<rC^o0?Hwl7Geo8+Xe>pm2a=VE|Jv1D3Zii2U{UB|abr&E$
zgf;wPwHPSOlU<ThKpx{EWig<l?_=UUHU;TVg!B^)q!(%!3n6gugVb;8`S1n4D~tva
zobg}D8f(}rN$@ql#R-YNSJ^vU%5;=YBJfSf`)T*}&@g$I*iBD?(F*W_3;;U;Oj953
zi|m4KuiLK7S+SzKmt_AYztXh+SSq})|9ML>Rl0ZNBD(10hBeVM_Q+3P+2N{PRk(@A
zRlLi8(Q@`n)EUYP$DBd%CJ&`fjO25<*WK+AIQuzvWS^vF|J{Lp%iNyYAsImFI>oO8
z)6|j?q2#1ev!JN>aQ+3T=P#0BP@ZxFZSIlZ%+KeNXEsXB#`-}V-{pXlgj$H{QX+9k
z6oRP7r#=`kX#<D`XoTpqADe|wt5X+8$k$dv%|fE6pq;GY8a={-9s{*{Z-h;e7m7lS
zWhaiRJ4h?l$|lej+nrX06c4I~MXby9kS$4lO-b5|fL3*&uxS{G?_=tMmN-etc@+C{
zF+0$PhrArkWhhlRWMEl#l$D*Z@yENyY`ErIns$}%GFS%Oc=8vK=t-*W`l)@1m|8k{
z*ZGRdr2H}RGfV*fz|Mrt88*|PX6vqH?xwZP2TsAq_oBr$e=ChvmQR$}`Sm&K|GAQm
zg!6oxbmi^qKZVGhTKUl)-}7@F4=fB|QUN(GHO^v}E(_%_JlYGqS&{Xw7IgNW@t1ZD
z$B~z-wy&E8As}Zk2D8sT{d(ebee5Kn%cIUc=4@xxz7oOA^NnxB(<JrxRdV}5g0DFu
z<pef~BQ3~|77y&_5PD!aM^sve2$JsC=fgz!q+lGjh4NK-u=9Yh%RKw-L0#T%$&}2q
z+%f%vks>3B_T}<E|CXCs;`tO~b8QFH85;6327CsWt)^m)x>yyNuTnwdKLzG`*Na!S
zc*d$axL9Shf2<dufO^zb5LN`1$>n|LJ&WYt8AU#Dr?Ur{!EKBh_~XC%vOEz~>|U>T
zrtxrD8AOnq`)noxdv6?#hs)@qQdQ7+sI*aBz~8@CGiQTwwo(yb-PJLXaOWZ))_`I3
zo8{_!xdZpP)BWqVW8M%!FP^{IpEUKq^7r%~`D@FhtXsdexXboYe*+cjUUtP_K}mgI
z>XH`NQJX2BKjIdbbrmJ^F!;fXoVfvHUtimOpds|K%8CvMxCQ8;7vLj+^!PynsPH^*
zCQ4VrLsl(ty)47p)5YYY9MnBAmOqfb#4OS8peR~Ji+X#MXvivo8z(_DZQmYSLO+TJ
zaeJ3jj;kA{;mh{9e+qpNcKvXFG3j+VW8Y+%K?gSO6PTpW&bRh(!JbVKwD;BSN>nPJ
z{|Wz^QGe<QF3+%zta}dP02Q5wP5Ks~v>5Va#MK1{IvwN;mQ6K0zFPOBhkuJlIZ%nG
zu^(aYC)@o}+N2v2H8SsRfnAS1sv`UH_{86!K~se#n0+bi{M2J(4TR|KShmto594~q
z09PR~Cw<E%eRj)5G_@x-4kg0lMRZggSpP(ky~ZW6<|XulXFVuS_2RzmUMWrJmWG+)
z?{>iAuhOge&(a%+Ft*&3ymdvnKoEN*`ShHyVUN$x0sdU_p}Yz7%yxzy@u&-YR|{K8
zuRK%`z#qiYpu+9gMGePMtMFmX%^!)LwnGpS4RJ42d-Y=Els*Z?<Oq%}4oa$SRBh4s
z=jq-WPL0|SvZD^cyW;hg|B4JpKS2VO&P_SChXq{rg)r-a5aY{X4;r^{;?~c&oRl@k
zIZ=AejOLu)-TC_|h>1kZ^dRs|ukzG}Ghvy|w~?LY;z;Z$EjyD6c1qDs0ZjfA_TqMp
zPMvs^DM*RjnMs0R47XEF+4y6DN(Y8T5WU>hlwTR14GAR?if$^?bs#%eR6!6j0v`a5
z)0#}q2>3<8N}PO)G{<W=?Wca&qy!+LaXn1@IeIIr*sRb{;2W+YGgQZe0U27yhepD?
z*%6u3fY5F?Vc*rn$p_GfWxBqF?0vV{k=cfdd%|JDzXR>|SD;<~8R%eyOMQ8QJ0pP9
z!Sf?pLp(=xsG8K)frjk^iwo?`LBAY>wQcve?zo+OzI#uP5;0&ZfJ1SH)in(9wJ%CK
zd&5%$*7VB0=ZP>U1K2CC-pKK($>nZ@sn8e&&gY%(@^J_C6ABB*{7MhYW;_rIO2d~(
zyn!NV+rxOF%#3RBfj0OqyEA=p&fA2Vvpub@k!3vcyuzuKHHA%37mtqNblI7M*$C@-
z0YfK%rBjs+BBBLZ7Q2qu7p}-I=z93-3zN;cJ4A;mtsLTrz>Y)}Ol^7fZ22!i@f_v$
z;te3ecg+3yMCG|oUp&flX9aG{N9*gF^>gDZBN}EPNy<w>0GWftbdd(#1?Cc>AL@66
zpXZT{L>v5~s_mQ4bc{&EGH>cn;t8VGf9Wg1>I|Vy$^}8_X+QT#;k%}vy<2#{M6mb2
zMBTiYad@0ApxYt75BpoYwvzg*K9~KcK0|I;D_adO;EHDI{pi<zl)tb>ZhmmgsGu)0
z!&i7jZ_ZWqMenGtw@2jt67l0@q?CxiW~-apoPFv#h>!Xz5zv{RH#?~*+^20vEN|G|
z;nYklKZ-2rD3qZLB;__~_);UTA0}a5nz|%kSs?30Q7M!!QF$KPS>SPE)Ddr*UVM4K
zyMEF7;ju)09?Yv9v3Eyd;nDXiWFLKAh6toer9LgyQ_TyFbaj)O(k{}875TpKEQ@os
zdn`VIa?UKgfRUScTB*C}yPNpSFM$a}>wbi~TH5rkc{}*DoDeET87?+pjcK-OWnBa<
zRHI_7y6YTC7p5E5krZVQQvzzTh3_uUol<OrPsTqGn{?ied)xr7K1m<0A~eP;^J&P;
zJ7?Q98Oo1#2_QqT$9vY>>Agsd<1(QWNBP40^$*=rm!R*qbpN7a3{_eFz~2htCn^CU
zxbqLI{L8>E?=qFb*gF2bFgM>9|Fv%bE^Y|7Y*qgWlHozM=c={G)7ItI!{_mxnz#`F
zj_7-QM<B92^vM+wgMIVyQBxBq$$PJc1t9S#A|ZDi<Qs)!YQv(sW`gxvr27)c{-&Wi
z7k)omzlxqjh<I2@|M|?iL2qYi#T_s`<g#d+)wYeITSi%HEg=srs5A@s(r8U0H$&1C
zV&y1go52%{Fbx)2wzEk-m8IQSlp7^0xNa0E(evjHX0O>qWfS%m>BDz>6Cd#|7v@>@
zo-+|p+IM<lITXb<y`Ol$dohWsu{Yc~07bZ(Y^cCleo=NqdMWqH=xyc}pExH4Cwb;4
z?lmj)Qr|gjxcycv)T;7IlkVD;9qzAvO`5Xy0!~V3g>7QhBj#`J-r!0EA!KGZ5itvq
zLoTd+6RkyKE9iaHv)`O`lW{fvH!!w(_gC^3{8#cqMhMMVrHz?ZP#fhg#FC}Ytz($B
zDsvav%RCtpk5HGM8Hl~e#p35Uu1RP57ztwaQ+em0)pvXX2C!mmex0Y|T0V{H)ELR}
zdy!s$*3L~KP8Qyekzsa6h#T?VG=y0rfk40)9RtYwBdL98b;WK15A>lt382#Ma`=Px
zVuY$~f>Pv&N6;r}_A(=@s>R$i1(3{llMrm`SA+nGB}1zA#bvd_^-W|DIKU%WVsS~?
zO1_3#rdvBMm}N@BB)wmJ;S=p7N-uUCV{{F6*E#Dcut%I4!kOz=8Mon!ufEP<oH=03
zv~75|cmUh{uIKbS!}->_ey*cK{N3BchC|X<_T&y;P6Qbvy?Vs(vzTibofMW%YN$N*
zx5fIa+nCJKVs4~oHCkG<@vn!m&8#%J`%<f|gV5k|?rNTyBIR^WVLKFH3!7KNn%SjC
z+CDcHdjBJvb^S0*124UvCu<=EUgdDSScxKsk%QK-it?4SX=Y+q=~Ch7$zOc><Plna
z6bDeid=XL0Uo;A}e0|09Lp9y3mmw+|fjZE|KQIc!CUW_Dd!eNOa}Vv+o%m+d<yH%-
z2{44xuUwxiCa8U2cZ)A{li(}Uj0&^ST{;v4pU~$fb$9QZhiz?24)T1a0i95;P1Cn=
z-X{7FsZ`muDAeV#FVS4Z0^)HHv<Ww+5TL0dW87jih2d31=H1o@cQqFN{cevbxsyC=
zu+9FEz&BzHAI}ry7F*ArJwKYywE5t34YryeBp0@nb#Ds|?g0wAdiL40o&#^UP(_V!
z58EQ2MbR%XxOW1|IdX`sTN%Z<llv~$HNViuV0Kfr9Z5MPUErtlLzoqiDm%JUyO!sI
z!t3KkBlZK#ej#x5)1fl4PH2|lGrz|hu8}nQ$#GTJR+ppaaW1a)FH6if)jt%Zf!lwK
zi-q+F(uZ7vj<50e$_1JFUMv^#imoA}SCN^>G0?fvJkSs0-p#m=<COYFi0+2?9KPm}
z`4Wx<!qLMRe)bt1HZfmtBCc@^6y2#Sp;jyi#4#3#!%q}}(~8G+svMF&Z5_DLnvNQi
zLX2M8?3~$NNm<>hT&e5sr_z`1OaFa6`n+l5h7*7J!B-C=)paqfZvAGmRw2)n*?yr3
zrddXaAS4GMs?a^N<0)xpl1dt8FI38tEj~p5%&dev+j~(oLr6!5D2OSe8X;`qvsVFl
zPC5v4{y~{eRXf7#JbSu$MkKfzp~su8qNt`!rGd(iOJz_)R`F0>M%geDyv<r8)rUjQ
zZ&NRPRQcP(u`i0dN^{7GKw&$4Wy;BCtMC*CmT@zE=Ve7|jv9i6T?6~fe*?piY_old
zqkoW?M2N#+9qfd)MVej8RhAMh%d2pF4=%6ea38vdkIX@dTR$2||F5`TuG&yA;$&Wz
zU3F1DK1a9sLG*Fl087`t5lNHm2@ThmUH%}wKe}{6ggJ^>JBYk*EU_Am!vqF!M8$-d
zY^4O$rU@DgS;W}U%0QB7kKWyDpZstH^6PZq-^YLn+A0FnFbeUz!o{TRF3@SF>$bDw
z`?YEHYIhIa0GC^&th_e$+JY8M!A*lD$f?{w`&E<qVn*HC+Of{SfCAO9q%}uVKZfzi
z$YOB>CP;*D9M<v9tP#y-Ph}XA<F2|KE{|OeenFG5>~HFF?Xr}*$C_yUBF)Ed_oLvY
z-oVa<v;#53HMhFCI^4EPm8R^<rQzR=R)_(qSIJe%P^~fqur$rBsOF-P=I`^b?9VO7
z{3BX6BM%Wy!;!6lWgM#tkVAdvUQaXGi-C>Pd;+uWkBBgPGeH!5faW+9sQ)^iIO=&W
z_s_syl6F@0-kWB<n<ySd?c+W3`OK`VIIWqZ7k{ZeyeUuW*v(zXe;lcNUWC*?J8bU1
z&hFS9h@T-4Sd})iiu)SMDWR5hFgBMe4<`vqiA|vd@<Y&_9dU$(?M2S5+(rWtiN$;s
zC%W!q<OwSLQS`X<$)g-C^$@pCD{&ShJZh2j{hMAWdoEakXWSuII~np_VRIun5e`oH
zBpW|ibUZvmD6~OU30_oH$CIqqwbh^b8HAN4m@EiPmTl_nVvw{2Y*V$)OXc>z(gdBx
z8R?RzZfJw$ygoE9(MRbQgglR<a6q#Nu=<5qu;unc8B>umH~r}Kb>SSQ_az0?c)*!~
zbVDB&+`&m2ucd!|T`@PVDQYBoSId)@R`T(UjHQvP5yRdD1yZvViN}xf7Kbj5`xEb`
z^X2!tJ^UsU2Xb<_n&Oq~)Pssg4I7LDCcaN>opeo%VvWr&5J>DBBJr2-JOqxL$&*rM
zIUH3H9}?LJMMF2kj^X=tAHSBIfxo@tihm6dv>pA&G_PcU+|M|4a78z}CBF~=_`>)+
zxWa0{NaZvdAYWMr1mWmDL3Zj-sQaY>9$?(yGZoBAxH!3eBVT<IL3NooJMP%%?Qy0M
zc%Y0_t7!9%3nu~Ub`^9})&4BfdQ~(8OHbu8+hta>q`at}05m2?%=R(;4OwPY==am6
zgXU=*&;w4I&;xRs(i=8Z@&ZUrtWb#pXQaFuK&cu@k#0Lf4zn0ZQ~Qo7vq;6nGlFnb
zuF{^{Wgl<xu*<`j80%+h_S<mmVO{#FBYf%C(2Lwhn+oqvpBkFePt1IhTnxxjaluzV
z>hBv`K5dB43pZOy6O$^W53c>}qEDl+odMjNVug8yH;Y<bl9N<^@O1kj;_~ac;LpH5
z#dKD7oNwbl*5Te)mai71Ghuhn$xE5v5fr|P83O3l<l_&oKosLz`QBNqJ%cAOGSMYy
zqFdbE7e|+*kypO<KH;=BJRonA`rD44Ci@pupZ^b3PjAH_Z~C?8SCV2L_P`$VrSn-D
z0%6N)`#KbdBW`6vcBzx+_>!XWO1#{hV!)k+x?`Eu`@<bwyNXXN-kB@9k1&Fs-4aoj
zoni>P7sDMq<?a0h3pRlyno@l13m}JHbRw}!*Ysra+EzX}luu1_!n|FBQTX%u4`%rf
zgW5TK2yY7Z8^N|!f+A-c^L8tif)3w}1H|z6<pD(H34DlXgO(kJ8o1v_c`ND7<tsx-
z3ItK)+~)&7Zb9$$Ndh(wUKIoDcp=SmfaxD~wfD0R`NEfFRM1V)UH-%mIhgBFa^|IW
z&=K#A0V1yr+r8~BMCadLjQho%=(@XDGY5mYEo+0pEpTKBUOQ(TNc?JY!8qh+6#LLj
zVcU2WuKs-`1*l9nfS^YzBUXxftc~O|YtU)ph>2D5Nslb3Y#U?}x6q>o1*<Nc(S4gl
z8s&+YSEp;?l6RGgRp~+UB?5=qnY*QVELY6`e9xHx`!`?mM<Dg`{{4@S0L75pSrYIp
zp-<(J0lF&Bre@YP*3dJ4$=WY2aG2Q^zBO+?Jly8jr)?Q=PEQYEL%>z4t17k{mUxk$
zY#>$P$6C&c_6w<vLijY3T5{W6;K@hzF?$V1t~c_vxZMw>^2EK~J~v(FviYOYZ0i*A
zn%8EG?3|mdG*|vrPQJ0ut)GLA*%K+L%QIpd2`+PA{&snkxJbBc8(=tS8XTr#Ugdp{
zBSr#{OJ`=E`Ki7t{t6(;!Wdseh?w_jvyO`5bFw%nc|>cnp57%~p9_4dbBSU#$^5a|
zTEyDN-gCiwJ0NL(Ru^g%wVZEf@3(`I^|-J5Fh1OP*{Pu`Y?b8!GrH7xBknLaJfyx?
zI1;s|&Pi33f@#r8YW}8CKgnY+YOdp^;lg&>bniZE-rR*k;N3_9gTls5`djQbrocg(
zdo%ws5}d3)fDQr&R9Y*<u30KM9Q@V0Tqx!kV@L)O)c7N+7JiUtGbJ_bQ?!2<voucj
zKfgu2_fI^=LsYCQKaLp$%1;7#7Doa4!eXt}*zHUmzy0L0=~<3P)O3k`4thT8ntzPV
zw%y{^Z}9JodiSb%?L);RQ^7zrl=(~C2>sCsff#v}nHpUB@vFLko8ZS{?vKYU&I1%K
zGhgDQlZjo2P{y&-NGU4IepcIx8Yc~9xa9~h%Z}9crC9r-l#_3VZ7W3W@OAGY;^6}M
z3aa%kkE3<YCNJlaXHl(%bnDpwbc{+y6bHrIB)xb{_B96wV;NnPZtd*y=r1dh8CetP
z;@^!vRZl>oFDqUdAS#u*VN79e^NACRX`Asr6iz}An33Bmvv1+mq0%j#HMrk7oO|CR
z0`5tQp2udT5JW-U99xYo>eaW?n9ID4{YWN?n`DO+>G!mLxq>}p-r0{`J<Ea$b{E=m
zsH!>NiP>Y9&&R#=KI#bT+?v@Bf;l`%?pyG{&ab-~K_U@eCof<$jS){~c1lgXst6Bb
zzE<X9lCi0~vKnx6UaokgeM|Z`1Jm$lSa$Q0;y=pQc9Ac_>(>70&APn16?5In_4clP
zwA7~=82$du_LI+*E7KykpK*#+m6Ad%0K7D0W4@&?38CAbPkw3mIIb%rmB?nK%=FL5
zj}|#JE66$sxeN!2#4|eO8~cBDo2MPln&VP=_ZBl!LaQcHh3y1mHsTR%$WWhUCl;(j
z6Mi8=<5Qti6Z#%MKHN3$3qR5rBFyYG2sct|u9BjI9R)5%TT%BP1{RHValE>R^URCC
zTA`Jsr!6$A;^IeXF{aczy9Y{rf4OTCQWl$0t=_>SP*<%uA4XV$s}eTzh6I9c$Qs+U
zzOS}`J1q+kVs9?>X$?nukbfw-zpJ>*yi_d;DFbdzjcy*GM$g{*Tq|CLO<9B5OfEIj
zoc*bznfvcD1rn+m4~OT5!!dX(<H93yS#1*XBOBv2zt!u+dxd%JFMiAhx9Pd9Qi#nr
zUnUYV1(5gro_psr#oNKP0pR4<H3m$h6|&^pU5rz-m+pG$Gt1E?pcOro;Vd<bbRqL;
zpc7b_O6{XQ?5Xk@zT^vNlltoj@y7hsHdX(lZ4xGA8cO?pB*Gx1-~Pqoyj{B9|8^pP
zeMq}*`BRaL{Je-=rD2#Tj(Y15=OgyfoG%9>QG)?FBm7f>YOe9q2!k3g6a49IdG@hA
zA{o5&+PL*#3V!c#k&D@pd5X*5)(Puz&>H1BO+DqxQ*%M6m;4;cwqHkSRj6#}<|bME
zI{p5UWye7=c8cEBtJ|@+cf}bk4)qf8u^4r|;&CPU#ci+RunwE983gZAF6W24DrOo2
z26*GaaqoIt<MEtjw|5apGVYwgSXMQY&Qli|T2)|Nj=2Yko|LaJD|2ke{Vv_KiwJ9U
zI5K3?6>Vt?L1l-z1RpnxBfl(o^%7c9U_GL{XguO`bGpE<a&Ck#%(8W|jB8+e*}6M)
zaf%;e<(_Ti<j)#=W{FL-Rng%^O7>x<9S3gD;0(hHbluWHv;1h(-Z*PfQk(VpHaf%j
z@oY?RFHTecy@}@l<EzY7P*WJmy!PN68{qBBnOr(Mz)?SgpyN*`U!m(LftT&Q$&Gpp
zpEd-+1EzFW#w`e=DjHYS_1+WR8_wGu|1Nq`e_cS6|G0oMG1!DYk3~{desA95h)|#w
zk6{pW9zC%}Hu(w0(nnwg#($Q-y%iUpnY+U3#dG9$-PX=#I9hRNUm>viLhShQoDZmL
zo%@SyzgAtP#(Ct^_``O<VV#6DWi2A=K~0QOU#pLFx4x6nk4$%*7D<VG6b!7LcAWrx
zAfFSIH6G5+;j}lk9`99E_1k;pa?xh#^2{7axHCUq=f|#x7kb3YDrQ^;f(F$8wj7xD
zT-b=x2b&WnTA4iaz$h%#O|Eo4R?wBRs%c7^b6!P6-AhEpooVgjDN&A1&e60Kgj_^y
zm$qEo<?6lpmBSYENd#6h<n=y&V-i*YBrVV=q3}5LvuoO_;HWu;X1?z-k_^oO<<r5Z
z>qPI%>gOgRA5AKj8b19({<LV9JU$qyK5Fulww)Y3Xq%*#d{f_-AxZT_^&~l4tx}#T
znBLr~?8M}D*N5Ne@u-iiEFr>*d}f{}{^bigYrzy&tJJMay9=sM>|deDA7LnnM2;>b
zU`*-q06y$D*3PjS=1o#v+ZZ<U?u^!=XB#dv_*tj#9&bATW#OA)`!i{Jnuha#W4G`#
zHF*2^RKt1PpkUn!H64>mTinK+J=4>OPG+2#_?|m@F(94NcKfn5f|edl0LT}y9U|(R
z5SGJAqt4~r{Y2~G!o>i+ewZ^IJ4L5?t!9JVljKz{-f&~*Yr-U*ylTr2?c(m8U5FQZ
zrzg%E<Yn?|7wE4lBL=5ZWVBCB`?L_SiYL(uOTf2@jTh_Zxx(Anw$RO%6(?SiSKT<p
zC#nrJX?*g@7IbwbAuQGQ1(xBrhxO~=$H`ZhdZvQE!g=}Q>jr<?=nmS{vmWX~2W(n@
zQR?Vd)4vl?IZNJO;ms0Agfd2$wR|X+kzG6;?wfUNv{r;y1l&%oXn@7cGGzlbr*)lY
zkGbbhr*P*M9XKw+Bof}r4Vb+)I((=Tt;D?WnaC7v`Lvp6zx;w}-5VKhX&4I+w@^W3
z<Xc7?t^26Nbd*43-{hKxEog7jv3MR6=5-{G8UL_uMRsY&P#0j1ciU>sC-H^m9wfm}
zW|mn-j?Y~P<N&`-b}9X_Fs<005HIm*Z(u<pA+Sph(JR@|4cKE>5LZq7Fm5{^?z2Pe
zSoLqjllNz2x^3qlh({i|vEHYD&P5Mc8PA=Gr28|nu!vjrCIBG+Y<;8!fbRWkcS*it
za21{WNZoGFjw(qk%;4Ui-KFl+kpMD?e9P2}46-p1JkZ&!uDB3yFAToSvYJILZykQv
z56`MQ>2Fs2XmbS~c~MK{;l9`naf@Y6XY60b%iq#QR@Op>`TFzP)&nYe^f}p_tw?0F
z261Nl9P|xGJnwC1E`&W~h2lF2dxls|mDfEHC~?aS*%TLw>u6E;k2K4nQyJ5<2UbJf
z=FoX-O!eE%5?d(Q1r^e$z@YCWw8iZmo0-E!dKpPtchJu0X>G69nqN{1jWJM%hWdLS
zpFB*8LheLBY?22PG4ZxewEoa%3=DEWRcZ)4EAiT{STr_Yx>FJqbov=ACC;dVcrBNV
z8xC`S_e$lg_<i2O+v(RgRiD~dQ0P2x{b|b`=J#Xn4?jTn!Y}E4i_<f>Q>%oHNdys<
z)4JAE0nlzK3<XGfp=0a|FSReJPGAjisZ)ujjt02)cZ@D)y>;1K9nXPzW@fdi@2+;m
zHHpV++LFD_Lk4cZ9}m-$2UPQ^SVn6$EZY5}Tqa`FmU~3kQ8h2pAe-^gb$#*f!y;LR
zsovB-m$G9Uhi3O@0g>#Ih_YPdv$nB);tU=S;(>a?<^vg=e#vM#sJb{tdlf1jDBCXU
z7ughm_{IC>=-J7)dLg^Kwj-HJ^SGHQRY@W-t$7wWn%m?_+r^?`ctYpa^fMamh`*F(
zPh@X0(W*zuJDIcD`ZxD}3_6oN#2D05j9eM9Vu`);O_XkQFvi$8^5!_kahY9j4c)Ii
z?=ls%pVosuw2Oe*2InJPmTa<G)`{Gc`+224O#DI_(r@Ci{g8oVC`B^>6hoh>#xdb2
zRd&`y==aU1EAUn9u99TVL0~-DI)>DLuHW+tYPlKm5l^8t#BBe_7b>1md2i6Th$3=w
z>uh#UxzTB<ZIf&-Do$(>xNQWI@_&{4vTRFCJ3HTTWilXexk#P+c5sr%<B|~F!_cc8
z3efrhfDO|`L5SOV-+!2SL2{Ir7ocF1PTTVFG|_Gv+ZQvbLfbmW6tkxS`SW{d^<w3^
z%6y_FJAx1?RE~Kgi1W(mcBsBJE&SiAKjmM<yxwkze{MkMzea0$;}FhE9){;oZF8D&
zJY;IF1(>)$5Egk0@kthK%0ANDDXaK%i4)UU?8nT!mFsRR#F!jK>N~JM*7<mHkl438
zzL_q;C3V$Umt0spM_C;-^}Xe>W_rd$^g#riM7&o(cYMF_3&VL4WJ1?kBbe9T^6>?7
z5otRS<R>(pLMO^9GO)vGq3n$~F|yo7vdutJ*Fm;$?S2FAX}>{L-|r7AlIaqr5&rC`
z<umL4v|6swIZh-7U(71KTz;EtdY!~wtdHoKonlH`ry_Myy?9a<H(p(+W%l^yU@2)<
zw+oM95^@v4`Zf9^aOV|NAv{Kdgx!ruwT?0zpgQp;`y<fpcH3=!Bw>i2uHr-~f9DjX
zh?Vr>y`ZzvwmSoze!YU<b_P1M7XT`HIc202+)22d@=C%5YBE*@E6=B$n!>xt;Z)l{
zY>QyvHSu6_5%Td@QSb#vo%GlNtdQU=QCJY0ak6cE`CREj{dy>QxegiJQWxDEoWNZX
zp9Ym-UZc6!JxypV%f2pW6#f0MmL-B`z$b+AXB^&7G54>^xb<I^u|LZ#%_(Ye)%e5L
z?j)Ik<=oOyj|yLgA736ifzN01{kRlKOE0fiF}KDYv{$Ad{Bh&#YZr!A$Z<gKL*oAI
zW$hXvSmy%6Q|>Nvlv=VgX%9VzGh@cLR_5P~Y<>FTg-@;ecTOaW9ri=*Ta>;)P~r41
z4Oc*^^Yy^x39z1f{mOmV8B5V-pES<h1iBZjWl*wj<Q94Up?MleiVye(DtDbBZA*SX
z;!mWQRzNrs-OzeafB7)kv>!F%GZ>apEgZ5~l{Kqfd6<@6%sGE7`&Ip*5IvOkrVdFA
z0UGL7u>-S}_r;K?aiU&FYB6K9J1X8!_bTHuueeVdnVDjr*TVxE`XfoudoLWl^|AaQ
z;+(QiqE+n~wI*gF|1mW=-WbJ^9&L~se`ynL4_~L8j1K;|5g_6yWb}B|mFl&_v9Z*T
zJ&WIS>b&f@=&WRtQo?4PN2^Un$)VM%1(5SlE_0N*sh^9-$AINqq`c}#Pzfi5ueeoB
zRL1dvScjq_4;PGm+_pDihJVx28z2A30ZUH*kOK-3z)AO<;1SW#=RpJFBsuBq;?u#e
z3w+3$U<MQ#{A$~8nB7Xl1c=YJL>UQxxA4AQTs0kkiE01bL>#3s76-_S%Dt6OXj*3T
zv#q{xUqbV@iO;o*k6EWi9o2kB^^(_EC^lirblC4MO<8~Lx%eICNaez{=Umh&&)!Pm
zXd=M-nBP%+mqGVNdbw9p)QwY7uzz#r#(SE&RQa1&G--YS!2>}ygE1<E*wG0YBvjAL
zZdGYFlw@0V`Eckm)2AzH`+<CGX2fb})}f~nTJT~Ppq!-UC^Vd?DTnaB@sViA1U*3{
zcZ`L5=M+rGC}puSG4H%5`AY+mP1%bzf5my<+LEmQ-DqXONkaBJGkV$Y>xKdL+o1Yc
zRp|@-xv^I)56$eu72;oV@i12TVQWOMyg@Zka?x5Xy$^Hi^>zCJZ=LpK=tuZYp~RyC
zS+e!c3L94TLdLYlXExYl(%<agwaPPRyLHS3n%0KWMEHe!3uNHV=rAMd?urrnkzfpI
zt?EeB%<pGVwfP(WyT(QT1;)z%0mj$~wH~$}t$(l6wrilc_NsnNHtsrC-li^ayQ!~I
z^wA^>efBhPHsTj<ErZqmY;tSL*nSMD8^@@bR_xdD-E$itH2}kqF<Es_D99BiqkUvK
zj-w&9hx>Tp<$OP6P+Mc~<T39Melek!&PrQ~fQHs31Bcb_H22U?1{7q66VW@$a(vaO
z<u~;rp=Nq7gPhD{NrM%*NS9qQCo@;ZSObMTuv%S~`1DD+q$8Rzu?3uRIr^{j```0V
zqd;Pw8%^t9^4uo5wEiY)yU_MnhRvo8bIe?*{YD9wEG{Wz!My`$l14Y_3e`b;-=tKj
zP^4*@;!@hqzr@2Ytk2<Q4i1UtI-LGA-r9Oj?s0v1pCY_&F;Z<r{g%c`;<6U<dGX+?
zseVRv-k{py+q9MM_Rk3_hCXb@AvGnLkr$;q#<mX8?CEWD?j7ax(^a?&qtJOJyx^FD
zdFPv!i}Cupq~4p1IJdOa{`ua|e#e{a^87|B7bNmYZXKzE(hM_}_9FDciFR1X5hd|N
z96<enrv)5i({=qKeJfw@Pd8gvdV>EpRcil5cf9=v-C<GGeiGuH^r|I}PgmOo7HeP6
zM5fT+_37dJ3mD|<!ZM8rIb801f&ICBz5ws!2ES(?_b1&FvG7ME33OyDz#9avb3c0W
zMuOfLhFx5EnAHBmdg=Z0l27}SYzw|Pi%Grjln+ip#dN_`$M?^DWkVz^Y0a-8KsGId
zAV30V3D{lzMn0Ob*Ptkg?(U|C>Iy#*(?O_bFm{ogXLDcNwZ7pO{gkpocd9sM-qj!^
zDPbBFVTTB_jOWt#7>c~`b7}c4a0#*&6#-w|)YNEHqLkyup?rW}jOiw{uZPJKcs%<)
zE*+V|%@n_SWodFrVL3NNp`A9HT89q<88o$6x)g>dJ~f5=JwCh9R=Y<q2?NB`(t14S
z(;gAChKh$sucft4-X5e85(TaxY4>fK>AmW*@%Q{5>|(X8M6(a8%(qDu6MGJquTmU7
zjY>f(p}#8Xh^6=LWEq6Ims3AckPHbz3Qo^<mU-n?dD|!3mo1+mE{WCH(^und>Xm(t
zdL@Q=rL$T?Xw^p8UeebkdQ*`0VW92QX!Ktjua2Lb6}!hQ(}EoT@K&h!b>TkxImu&k
z5q*9ClnJu<@$-GxU&-kCV!=<_D9x|@%JJT?vG%Xxl^%TVW5I)<H!mEIe{g;4S<6^L
zi${h~d6mvmABRX_^!p7n%|csjUE39W-FZ^cppGipW=_xt@S@N764J`yrLz~fi$E|+
zoPgwP_|E<7cw*-dSqw?Xm;7Q?Mu_5EDC8`-lV4R)uN=YXf{mH=O%9tn4_$4aSBVY$
z<<*Y*zO36c1pWMiWT-RETyc9>C}K<HbvbYSX<5l*6{jYPPq63f#Bajc8Od&nI<%u-
z_bz_2kw5$tD}yLwzacf3mb(apXg{!dw4~HF9hA=A$3JEyFIq1>&OiR*aG%0t3#geP
z_|6?1a2q|df9Mk;Y_u=uaRTMZienAPOQaU6#x!vT%J==wAFP%V>-k}f-n0@Gbw8h>
zC#am8|H_~eoo1>2_2!g*KN_;$JlcFR-5ZH^9x*mgfgYFgLthVTAgIoLz^{Y>PIFxK
z6KNdd5t0;sIW_7{cv+6*$|I|O_meoFv&$gxFWi+T^B2`I`(M2~o97xXu>5`cOL}~~
z<mDeEFfDzJnSeY>-Uh;4>xymsA+%aZLv1k;PCYBob<4p|%ilb{Sk3j{y8v+OkKUkG
zp}{+GJ%Mo*Rsl-B{k|EcxN~ibM_*g^1Cr+6=ka*Vp9Wi5iix4#jmp#cs!RyD8uIt=
zRL4&+a|m}zwwk1d`@E1pWPRppp<A+O-Ye3{y;+nnc%a=oH+HITvs!V3%z7Y%N{r!a
z#K@gWEsOusIR80tshZPsXK8QM=ae^1zh%VRPPgY_AjJ*L<(8CQ^-=D&TC%1PG82#c
z4xfmZV1zFqre|PPWYR7TZ5WOX&XLWy>B6aOfRWF#Uuu@AP!}9Ak5tv@U#LPiI|}Eo
zt_Vo!ttcuR9=pl*x7H7<TlRJL_lk-M8Aq`TOXLSV-v;3KG^|Nd@Da^!ZqMIz2vZ1x
zhIP{Po2_1=LY5(sYiL7;^h(}|tu=Q2_|l=F#1PX{yS+B|v(&XMO<*}G*L$1b1m+(g
zROKY(@O<ym<3*MO4fM<MFl9YFCQ+|0o&~G_)oL(`o=8uza|&3YH-3V5yv&jMaFD3+
zfh>@o>zym$8<K|5z@!~~=L{}C(y}j8XCqAg%g;W0&88@SbN~w&5BvE{prhQ9E)1Gg
z-O+ZnmEe5!Lw7$~pD&E{S7qo!&YaFbqmwT(8p$`8Vy<4gc9<@DdRe}7-fJ$?#u5^F
zOtH<c>#OT^rPS%vh_Ja-&Eoj#w7L1R+Y^H-_7N{+o6+nKzHBZ<%=IC+mUgWI_>bP}
zHCgrYk2ht!RgTg3^%ODpy%%h8uS?=zRX<;-+XI*eQD){~s>(5Wt$jBlu*BkVFNx3m
zPV7%Y|7b)B)U#+hlnH3)iPfOu&;gGGCAJ;$U+ihNQc@!{iVd(lbNscQq`g0PIe&2>
zGA}Y#xnlU!wSoAc<%bCFpv!)-;M_%lN27Bo5+6dpY%J=p1~&Q>{&~5x+XiC*@$i%9
zbh;bUnvCS7R(^67IX)$(=hNATk3l2y7%z(l*9HqTx~Bl;^eFQB!DVlK#XubI7v*X1
zg&S5*HSHMxO(FhSQ{?46{a@#5&}S{WOcw}S`|L)QbW>kj9D?~h1{0aRh;HPz#up<x
z6qRkw>^;ttsZmG7t-6iD#CX-qrR5Bf!f9>cd!S<bdJCvh!=I9dp3<4wn9V8dVjWfP
z;s96Al2f42n3FFLyd4x=mzd`0PH+7}8XT&1MpL;SN4m=J<aSp{Z5%!fUtmwT*v1AX
zQAZGnB0AE5NEH(ozSHgPo@zH8qH{uLA5R8&ou>3r*&1|Mh^*`t@KH;EM<Aar^^0Sd
z#~{KFp1&7i!bTP8LjYxV)@NfP;zjzwqY-pbaop0${Ukhg_Nav=to7ldrg#|hNZxPk
zf~S&y6=Pi`)PCUDHzHv5HF5U6>5UPO#gyL5HMns|6F$_|=q0f0B&f8T!0}v{1B<u@
ztP>y9d4gwy$DPP}_F3%wz?VFGjkmPph$+7m1TbSK&68y30h<{>SSFW<;pVdhQR(If
zlk&d&9&|Et86c?Y_4I}SVJxa<iGn2-r0nAfY)Ve`U2^TZ&N$0id<+^cVEnNAGP~Ck
zcwJ`zBdz;;u@vwBuQN=3yvow{*hdo0mc?0<c4QflgyDdiiLka&?@)%10v0JaytkS<
zk*(gtXzlBew0`rxBxe8G<ri)aDo5f->c{93MR+Nm^w6Ss+u%kFkbj=}Qu%Ws#s$~G
zFHz48Db}GSixJV+)ywO_*Z}$0@i<E3A#bQ%SW#z{rDoQdWn~Q{$(v}FDQb~GR_^>c
zav182TL(nK8iPykQG|~-fBxi@a&|K9s206pm_Mzae(ue^141Eoqe`HbEFYP+y-M{u
zp;|PZ6l^uD$oxEC0ySap^i-DsxtIjHl{48++-V_jbWMX5<k%gPu&K*RRm)LJ)c`4z
z)f@0!tgl|A?MfMIJ?F)8*eRXKkZ_daqc7&Ib7maZ+5<|NK=_;OtYYn!W}C@td}#9_
z2l&a^?0Ajz^{$daz<cn(8)nAn$Nu{pxpasQJ#KZe3B>cep<oY+HEs*YK|2<&20M)n
z&k?P81Mq(P+isE{GyOA;7%`ZCXWfD!-i8K-W_ae4l*RIf<(VQ}ibcT3(Q&Z+deFS#
z^Z%@X9Jlgd4su7h${WwH&#u5E#N>YT-^>0+YAn)ydP2)wD0rqpEMyT#nqo=h<>j{Z
zY(HK*S>hOxwXd)AGOIokjWBz|dQNF}Nil2zjgT3Z8Oi#6gUa3V+uVJHidi(fHQnS;
z%N~=tZUD!Vcqjbyuu9jm9D<=#XrQ11nIV&=JW>Z&dM;B?IGXRMbCUY0J@c~_D1M;o
zo>!6eW1m4yQB4*Sz~X=%AQ^(ld9KleBkVa*-mr)7ytz(QS>u<ksl>Q1)PKzYECcz;
zrhF;;fC=L&q5-iFEz!f}5dAE=zxPG&wnxaFYs_c}>Ll3J!$Jhyr}{y-&j#(Iu-3mM
zjA_g3AIY%_9pizC%}Wz#im410r2^x>(!lJk7Adc8hMYHtrstLeP)px6d`ilEb)aAn
z%L?Zp-u&?K6`zdCGJ%855capRD&v|4A_oV0D{}KnF+hm>Fr7MyUc4l%xACW|hT6N(
zU+Na$AUD2Jj@v8t-<Sl0cJ?A(57&P1Im>&f`=1SaOmtf(X%AICQe>}7gYMY_T5#;2
zt(`ujgl+5BM$x;StRY;7OZJ+q98``o{w8?#b(HI#4ZGFLkZm<NQKa(P?kEB!9TfXM
z?B^)lpTZfFN?RdW6tGQRc{a8e4p{T03uR-0>pf`SpFx&!8UpATWk&%ESM4*?v<NM{
zUx~#6E0m))j_u(H<gU|m8Tk~(uhzgdn=`%9kKgv)FTxkRitVBW$m1PRch*i)g(0_k
z&ZmW<W<BNiwZc4AmYkF$bJ|Fz1h4e^Pa*&q?}Q-DNMG5pea*Yzg@l<uly?^%NjLR^
ztv-iWGpruilc!7i==A9D8QAYX*<(Xq4c86Aurn^L<o8=&Y^5e@2RY1C8u!RM4-8$-
zE57}0hKUIS(P1*2Wqhwyb?I_i6H__gG%VRQe*vd9;lZF*T80b}HbNsaYnZzQLla3~
zQ_^25S+$}X1N7fmvahlv0@P!#C}5tkpT+p)V+$C17Cj!~_Gk}%sHB7cwR_3xZ_@7{
zZd@Ifqa)KpXum}LX`a4=&hocsFgOnJ@nPXjDa3|`oT%XW&Qd>8+jvS|{U)R+{_Erb
zhHj#oGRm{|v;zpeAJ80Fly}{9Rh8L`gC{B~cGdZn9!1*kJGVSmq%J#;i9ze#Dev1y
zZ8GaY-P5(=NFoR{RDueCqw+JA@oCN)mnGvAACVZx2Gm_fO3nI7F_dOu9pN4I_ozig
z%8AWDi=GxHKTc!KM02+DKcofc&Byl86aMb<PDg<s(|rj}f_7(t!jRK*=lh;T^B@VA
z8G6Yk(MY_OS+!{l1rvoEf#(<P*dO;lR+nHsqgh<$@S_Ifi{-0~C&HZ7bueJAQxp?S
z{8pNw5$0J!98b<|)|JIv&#^}18Z!xe4RGOJ&MINk&IM1?d8@jvswk;(ya&^ze0ko(
zJb<G?PqsCi0LQeEIGg(k3ZGK0I?`K_9ZV5`pMO?R!C;oCT$FXoN<?^CR8`(}j<Ozz
zlnA$}n-RY~>e3}beIwD^Ta$Heb=%bDPHg+Xz7OPRY0-GVMPHtfT=WLW5yXxL8$Xad
z4gk^nVg$man^!u$a`Lf0!JROm{qSuQw{8;4iPB%+5%ky<GI`a#6=qnu{KaxXV=4j0
zi73=6h^z4<k(I(WvoRJM)ud+LMdaLjicLG?xU&~tk0$1HQ96>L5`I@M2?qseg)+(*
z<}k5ueUWvc5ieqs1X%j~#)W^VOKxW_eqd_&S}j}^dSS|U437Mw$C425wXu~wssB&{
z-Axb$Q}kc%AV~i|s=mUZ$^UD68ynr-FhH6CB3%O{RZx_Y(J48)VYD=;gwh5`I(qZ~
zDWz2!+&~FwQ9|mS-|zE#e$V?S-1qsMb6w{;CC-Px%Y=JqF1c_%^@OYA4Ay?}ln4D=
zxyzBirqWX@Mke~T#mZa@$bbPm0<MUUjisbh7y;SF)LegIf_f+Fl;H%g-i7P578}U6
z8hmuPLh-AO`(_ZuStwwDPG1ZM(%+Tuc&*L;`Oq2AevFwki=Rf70>t9ij5XH@`wHi7
zsYT@bU5|T)qDZXD9GB7=FsMEkU(E+M6K~=TCJ7S_o=Qmk`^mlL2kvvjUqmPOxq?pT
zUEel{!LJRTThH~DbmC6cUH487TYP{2PmyZ$-y+r4|0l&#BM#`4Loe3F=N_5M<@P<t
zlc-O;F?q@v_MK<<HodM+ynCVW9RsU$fi8{Ew*xhWh4sEdE<!nGJ~7nh5vOmdCZ%L^
zQjn3xa<{*QL<Ub8GboG8G<?)?ZkgZs1~wccT?fB>aHZp&Dc%tJ>Jf=ocTai*u4TvK
zexmDWZx4_%yhs8&@L8<id<9M}Y|s?tmOLdBwV06A@P?7JCwsXs8_(x)7}FAQ;2HW>
zRKI=Ab~>l%*v511i?=|leF0&mo6^85tEy+Zuo<^zbeq@l(!R;U)o@hf+>hAX)Rb`&
zGh_`Lvo~a8*Xd2VNmx~4F~2=Wf@Bpz?!e?b27l7c@|(f_O~_|cSjJP{o6V~U_j)&p
z9L1$1-ff<OaM$5?!4tI)Ms}4r=gjuD=10#Kni1oE`2uuGls{np_aFK{)fBXQSxFYJ
zBON|Gd~3zykzuU{Dllfto6wOB!lo0|#y*oSn<&=`)@9(WSpn4!ErG&W9$%}@oHAd%
z@S?#yaIWm;CyLb$TiS|Tj9l%$$|0ux&pg;as*&0MuNw8dvwn1@b}YTtDr(97b{Jpn
z7&7*Ot+ZGea$_Sgj9ejkO3~d(C+S9UbD-Dsi&l|*AxC`C#o12nf_HuYRbr=1^wU?B
zEmz*oZDFBD!(HA2w4gXyTF0cAn8zNV`p3L0wKNg1w|lBV5r2Xrc2^R3^FP4!7#*{g
z0Q$VqnQ_};f(?7BGD}x}kzZu}6UZz?qhGHhsw;j}hIub3Wsl#EQtdu#7b|KhE#%lK
zN#^EI7qH9zqF=@Sz;n2=G)J?2?4_?5kJ4uyeyXtkOPLyv2_(%O0p$so&C*wmq45$Y
z7bbxp9)}=9X^HgMqbanW!I>}?D6)h_=s*psmZ^7Z!#e&1|N8w8asPVr@WiLDg?qWI
zB;&>cpjx<YGv@gpeaoJ)V`ms5s1|t`0O}t=iWnVYG{0}@La}?5U(>pp8~7lAszAKj
zDE@bk_41+<)g2^pU5=^jnjx3@b2J<Oikv6o4e)0v&$F@zxdF&dDa<W0fC=5egJ<w3
zl&&M+c%%iIQJ?kdH43!Lbg<J2^O|Ay_gXF@tjlZMZu7Phi}I$*V1+->s<5aCsof1+
zT_s-TEd8je)b=!ql~c2W0zM=4`V$X@0w>ulJ2<oEy^@u5$BZ*3IL=D&*!5<PCTND)
zQQV`4Q<?-ez@YgQ1PG=~G7%LO+m<OldubJn4?}u0iSR;RW3l((Sf&Fj3Jf3l+cjf2
z`Sw%tYVFDc#h@j7uCxHt0)316a;|$}RwzJ1GqflEU4Og@`U&#2sE%csTg)4=0oIv}
zhaKUqs&ec1ERW6^<X(HGamffcH4F@RDjAoX(Zo2!?l*CVZ|<RpOunW<0xa=40;1Jn
z-%3rxXCZR<I6r_9(gHvo$JzV9FQTS%zkF}5u419a|1QZ`mh65!k3OuLDM|S;2THS+
zjF?Cq*+Oa@N8?O7!u@2tnHU!C9N`7Hp(WVmCH_M>%4EQr{Yp+u_1Hk{dFt(WFzi>q
z=nlBH_L=7_W^8Tw)WyB+N=e!4W=dLItTyroHZMPG^j+7h3Arz}m+U8*6qG!&)Q@I>
zCL*cjh1KAh<S`S<Rc8&Ejg-@eDDE<^M6lX)pd%za#9^L0vUHH!`dM?@V~y=Vvy^ci
zYs&dEl0A`gIu&`VTE4NRmpYghmpCvoTL9RFs=`wv;^ja9bE+0}We4NxV<OCp8ZJX_
zmQXJgf6JRU6m#V5z<hIBwsa^L%ve5`Ot{z7#KcMcd{}b(&fqvXNl7PTCdk+pF3gKd
zK6ydd@C|w3N3h<JKI8?*kDciDOSd#jx9Yc@lgaGz79BOqeWxo(yS&+#Z^QGLOwyXn
zzeG-3UGJTimtQD2_1m7*y|SaKvPQF+a2@SF>JMCbkD-!)F!N^J1lI4f^=`yS!DB$6
zCEEHNP4-^_P1l-Be~ij)u1H#*V#sm;-!Sq-dK<3pO|n-V!vmvNT~yqY+#~w-ehK6t
z*H9_Cs<&Xhp4SZDC|#(gOpao|lB)+NJNE7OpyN;pK45Hi-L*U(*?0D3Ooe`LvU!v~
z&EtO{CmpUMNKjQ340FJl+NRc)ua2rl%l1MUdyRGG{(1V+uH({_Xwr$#@#a0$j;CUf
zf(QK1b?Av;sMs&DN?@L{BuPLx6R6F#qhDGMWCnfWXv^iauxRf3QJ!gb$#35CQc2;?
zrY|KIO;(Tg*mI)btd<RMC>amMdM^Vt0y7rJ=HDLtl`jZmP@TMq&w8Hehe_aHY#^U7
zNp>egJ)oI3T+Mw<Ju>I!y5k>IRo28o!7KAwN{W~$QH%od#pLL0>&k<KGx%<>-_9Ep
z!BRw;K%m+C8F5^)aLJ2XKoPW&=tL}K?D5wyo~b(T`j{iZEkyTXn_Nv@a2e5IwP;QF
zY^152+Y6=#={_?KRLr=D^NK`|-NnHgOw&Mm?T`8tfTgz@uN~8OEF&DE812`s(gS&_
z3ozgep9fwaWvf~M1XV|-28{nfaRuVffIPo2C<<`xkz7^CxmVST3np>@#cjWQJz;8d
z0BP}Ve=DMcrsPeo{984=Xq@=hRZ&Dk2`;bH=XPZlq?XdS|J{<YD@~(e<F1U_BYvZB
zW#f_{OQGJawh37L<-An)qt%2ox#M?Hbw`6<^+AS)bI<4~X>PLe7KoI6k_4Sc*I;!v
zc*vA(y`W*dYO4d<U~z<_v!>uA?uFIk5x;%6-K04kaq$jN$?wm-)cNi83vy*2aH-Nz
zGTl+b27I*MvmQ>~@XO3r^H(!p`i8A>_Ih@th<+cG6+IhStRmtS?GFXcO?(wv&`f0D
z0VU3!)Lwp?(>=cMOI#dV!Jr8dxyJwkW9a(5Rkwt2{mwaWb13W8_R$;-RFQP!jyAa-
zP(%vFNQ=}Cp99rC2358aEOu56qFK74MHGCQ{xs=fnIqY})+AO_QnfT-nCI+JHiE8~
zCb2Xcw#~o5ecee{e%C_f&SLo{VE)mo)xcqBznnuOo<em$W{wC5MJx={YPy{G?xoNl
z<^f^?3JK>A>IFR|-wD^JF{HOVFTN;ZqACQKlVXLxOg;)QT6AKHI=jBcDSH+!q~+=W
z6iF!2M&cs?lGb{%i=^g;A}ZtgcDlMLVa)S(+=h=Gf<ErEt=-eQU%J%#a`A_A#E@Xu
z1qkt8vl~!rD88KfQR++PBU*gmxcWJbWyJB9z(09P%5I=FZ66ihEN+hxO7rxatV6cm
z(y7pdGi162-G(sfPT!(9+(8VNLv2>i=PWW(_2=vy)*ckuBC!k>s;PRfWIqJo*e8Rp
zHsF}`+&1oR-XF&yPK65gB*J0LsnLhctcDv&GWFPgMZ|$)uK}8S#+DKZMl|93A5{&U
z+@h=0=hop19Vz~3E@qojf#aZiXr56+MG^ld^CD|2p3dvJvs!c{wfc(i*%uyfvfZj;
z0uJd#17D+1Vk;k+k=l%RM+ts4>%x?G`0Z0O67Oef*3dI8VdcTq#8E?w^}$8!&PRT7
zo-a8_G`G}vZWVR7=Xtc9j}H8-<G3b<HX5&PY$$g~zZ>KF1VR)Z9kgMu2ko5(;d=Fb
zX@zv4ucey07UcRyEo_wfD<#igQbl}Xn;X#1(R_INNB7c0i|4$IO6%=Qp%L850DwJc
z1m{~9)n;ud@GTA5X9pKjNqp+x=sJ!@BEB&d_3?EV&C%}O2}_yV&Shvm8oK5AON50;
z_yf)h`iwe7p&SRJL$%q?Nm%}RDbaTJFn?NZa9QQKz9ib3Y3;S=T#O4z!H5Fyqg7qo
zIdSX*X)S>CFA&CxO-07;4b@rO8lzVlva3$tJ&rJyw5b%<+{~E*<=^7p?J0HEs{(Ks
zQTHCKC~lljO0PCd4*p#4*OffkaH0F4mq-DOvB356YgK7F=ie;rwMUs<TdXbRtu7_Z
zL|EW7{RKG{0W1X_a+t6hQhtwt>E2UIfNqyXv2sG@u!0P?{n*T=OR;zH=~T=4(H|(}
zHHwi{kDL_4*G1SMd=vNuK`>Z^X*5K#!?tBPFtPL33dQu@hGFvdOg?U#pMx|Up7(`#
zoS#xFEt6O2%%!y;T#hdejiw<uB~L_>m0|<fi>7xIZOC$(Sb#UAKQ3j^-hav8Paa1c
zxAbO9T6gpNvl@@L^$GG;9wb(Q*-mKM>rpg8Z|19ie{GpVCw6<rR=sGzCIq5r&84Xg
z$G9UU!^;}_(+Xu;i70k>K`g)wXxwa_ccSz(Ss`o!oT?JG;^g>{Gpfv_>$h<gr`q&h
z&likqoHUbCYkAX~z8v+l*EN_cB@WLj9C5(HITKg&Bfpe8F!{5QN7-_IZX=>n-lGjd
zpn*_iRIOFNPYa);WIXhJRVLRy);G*6dhXiSswP>HvM^m=N`wQFr-6}~79*7*ZhoI)
zbu>p)C0Ct&lKgk)K7PO37U=l!9ux_!roCY7TM~VbQ1Rb^nK4bTvM2jrd>KkM2cA{O
zq;n|!0NMshz2X~~BNp~dtocGzlQ$BVMrP#$une)NusRr)oZnm*)3VzK{kl&uMf5+u
zv+#d?$GqA1jn(h$cXLnrZ)K72nWOW>)b0R~qY5YH`Qe1+vz(pXOMX{YfipHyE@>RO
zbM1oHcJ2%1%=!b&pk0{QanSC8_tnW0!=V)&z21QkD*<k!b!yg4L}4?N*y_<#ro+z0
zc+^*Nk~F|8;0-`n8U;^%Z&;Vd)5K|84aZ+S`#lO?*h@WiJLt&7fiI>PV!fJB*;St3
zA7XMovVx5HqvEIvpgS2`tJ$a{A*X41(qd(I#^aMZ&f&n|yyNcWSywg?YT4o(D`9o=
zQX<4Ty(TOqN%B{Le$zbfNPx1RZ&pOODdfqc*EN)fUr^7GRX7;XV~W*==9fs^p$XUw
zO`5`gY@3DWa1L6yT3k$*ZQEyKn3@6@>rfuqPCklZ;i{!9kZUvTq=A3<i6<FHQFKDg
zla6Ld5o`k6SXOe|6sDJ7HAiGp>>Mhuu6ul8o#9nLWCu%vYw4%o<R{7w<w*&|w^~|F
zBzv$g(nAY_i}+L)GJE>AQ`EZ#1Px7kQ>_mI{t|A~KZM)lzl6JiywNUwDxT*OGa3~M
zMUmP}A84y5NY1_@rfHGq@rk*!w5M0a-P*l$wefXlx7*6$PJYfD<muC+VTLDip7dRx
z`M0=aRuow$RA1)DOa5e2u!*}?rX4hxGNC=uW8Yu#J8w|7<>T6o+s&`KemYbY1U@!8
z6-9kAZeO_;wpq^8EJNc}-)k`P(te66hC_=igk$+t3l4ntp52%mrl*Dvz%tMBD-2vC
z5q}qRI5%zurg)ub)A?q|>!FPkM99i*uxphQF>X#c=`8WEaki-Vs-VWIwbxC4#+;&F
z#@Ee+T}o3*Tt{xOPqYpH>)Ot<N7|+_itc2B{k+4x{u$I+c4H5!*#YsYT0|7I^0VmD
zp)RCn)lwUPja)hp_F5ABl<qk??*^wxjL>xfC8Q7fwMC96$n3FGFbk`#UE9Z=Dij+%
zSy-^VHbBu?{5GEenv;Ut3}{`opDwze{vq!dQNVNKBE#q9(Z^>8Ij$)Ogq^W*jOpyk
zJ!;2W%9)R~$Yjn7HxmD{HiLgyo5X)vo7n#8yNh=hr?p|#brqA{{w(;EqlwC%z^Sak
zg`TJBXgdd*#y9TP&6eI*O*Q7{-eF?&PT@Z=zRH23C_b|Kp4^~t$)Ma61a_3x&>S!!
zjMZ%4HKu#7cU!M0t5z%Y<WwZgHnNqf^;d)3#bSy?lH?iXEBA^8d!vhAw*ocs-JT-?
zSS>bu{QY+m%-i?kTJJfw#E6?iDA>Xvw_e$kn&EUXa;`CIJy{BC+{XzG+RUIS+b-to
zf^y7rO98Pp9@8PsU-7yNGUF;PMk<%yRW;t=k4*N~7UZb@+mU&(@inw}T`P#i_S~9e
z1O>L0*C`va`jpQVFDwo^*py5uzZ1<mW)^_l`T4U|)?z(3>js$xx7BMOp|cC$pz^&C
z{Kz`$PfLAwVuE+U_Hkg|7<P*2RNW1>ut@S>zYaeqtnXtvZGZ^a*t##Sx0B*|TIOLZ
z`Wima#MTfY3n!2b#iuU8ptKuhAEf=D^&<6Dp|7==buE<~nX<nJPWX5?1YNENA+`Ty
zZ2SK(w)Ouqwnk8Q>#ok(<#?0>M;15tWpdPWBi^XfYX0;FHWDru2O+NXR#g$e%on-!
z;jrqL4U@0}Q#YRQThF<qifl%JN+rNDZ=rCe&?(Arr}FmxG(2iI#%{cE+nlsD!eoHC
z6D8X!Sm;dBdG#reKTftAxwo4xw{U*W8TKQwxbZ1Xx&>wWq_d+uBBh2E8tH({5RGFU
zV7*TAn6G+5@uf^($o*DoDjV{sZW$Ixv{Y>9w`ZD4_snxE-=Jr?7xNnbTzq{rETTKV
zYNYOY$RfV~Ykx_PdvX-51*g=gA(6_}@l65^Km(^OuQ4a9xrdK*g^keyM0m@|x%_sd
zqYM}G;H38^AkzygPkR>Kh3m)9yOz8{pw1HLoee#@0+e5#WPf-xtMGhqa7hcCe|v74
zB)zRisCmT)V5gxX^g9@WQK`;^u@uTuR?%X0aeOD)y&=^gq=~%^nN&3xmAyJWf-q0;
z)2B5nK*tBM4f;rH(ut9n%-OjhygrQwcW3CR6DR<|Y3}@W8hP0NaT+vol0NK8NZmVy
zS+d6uY_p2LGe<Y{Ab6^-oX-JInUb5cKt!`_cZE65XeK+v2r>rD3ONgG_cDC+n2`GH
zJj>JdI&6cd{v^a%W0#Fy57(PMZAOfbf{==hcxe1g{f^8tKC|o(F|#;0(YgnOhUqP%
zAMFsgug`p~%gL7H#ouHx&UUE=p?{VAe8%-;1I?=WCz$73BU%BF2+agbmRYUOoB25F
zy)U9*5JL9@BD7KB2|~>FVwG4QrzF)baXXr79*3q_ng*x*AD+Wg*UTAONhXM|Qc55t
zeGi8KlKTvHwe1Z0(hsZAojnF<;e%>ApR)mx*qsS|^UPLu7{_5X1E#+AL6A}D7l+Oo
zr8alKX!?Wf&NJODPpvZYixqBUMzVqpMKj{XgN<okZBkmX6MYjT*?ee=f9KtdsFoP{
z>{tiZAZVW^9vMB)**w99%6lk%gBHdzJ!MZGra8?U$3orPUhyr#@B3njk)rWIuB{E_
zi74@FCjPXD{>;+A#la}oSTq8aOt6r#EwAWb*<kv=vOx%BtZUohXu`n=1kUr1w)vi=
z)?rVIs9p6OfDX<+t~;}^`sCbx(foCOv785ePrK&mIm3sYPQ9Xg#$?Kg@c2M(H9a#5
zo9R}#boCP)D^JMWrz<-;N3CEh<*7c&8ZNIIp@@+WH0nz)9zM*BiO9O3aF6ZW-@cD3
z@)CFkxDmbfWT{3@rgM3WJz=8dCASzGV@qWZ(mgXZ=2+0RA3!%$@1;%ZBo01jyuPPs
zC7&KYF{t|E%~NU1HmGyUdHX!Kh0>7ebh8D+9~V=Nu}K4>Hig_OicO;Stl(E1*w0kC
zVxK-e(q1Cv@zC9H3d&E@0wsSed%ts`n>+W|PER3b{I<>b;O%JATn`a+vHFCqQH{1{
z+7I$YC9gwy{(A{T%zuap>yS5T8)q}`CWo=mT3_6;RZ*~qB7MRj7~w}KtJ~rC;Df39
zGAgy#E!n6xeETPC=ulz_A&58;f^|B|p|czQCU`3oWFJDJEK^du&=@ZI)RWNx|LsTJ
z)1CK{2o}nl>i<dwcmMiN?tlGfTx@^I2H~#WzUKT|>FW~+40G*dMST^kwG+pm(Nys%
zz41?uTszevW=;JJMFn$hxkW8e_c2|f;X)_c<-<ONXKrtCvzH~<S@4%5yMH*T68QRq
z11e&Zvf70o%;h`7CVkc4F=8GLzHv*Thg8jWOG;w;f<VQ_Y}^=jxI$EG_jfvRzBRh{
z^6T6eQ(5A5I(l=|uQgzNiA{?STFAU^KT_pe5eYzIkm3D|r>jKsLUA?Pvgq+#GV#bK
zkRuc|VZ}c!xG%K{fu`W&7K0o-uN#uTihb6@HwmfG5hKpK)2{$i$MhP$u$6Pv1G$Gt
z_t_2Pv<&QoT~#&>x+`SVfc`wNa0p9mch=~D4#d_Wi&&2f+y|Zz-?+!m6BsD2LUTo}
z9_xa0c^4N-C|da-U*&(tu=vOSi2kVkh}D!eww;LtNmo`0==E=@q$|?juhfhTPGB?T
z&kko=^T_V~Zjd90V`jGS33;BTju+1loX(DPxgfX+oSgC|1dO2j+J+K)iE@JxsG8b4
z>^V!$?Dyh}Hr1;Y`m3q*xV3%P>v95$LxwMWUXCjK1dAu+*PZcT`qxy?XtvyH8r(1<
zgQ=qRx4u5G6EYf9DRu*}^!~o?^lK16^7bo-vmPn0B>J_jzpS&z=ui5v;KLgW*AE=q
zkER!-gDO=A?f5*R=>fd25@>X()48i`PV%hIlIj9CKEp<IL3vW`L~C45v@kPxNw2Pr
zI9n$3B83Am6V2i8v02L}4lh6}7jM>a6s0dr{UIMI)O;AIA{6uIE?K}FZK5j1n*}bm
zGZDY9`JTCK^AhMmj`MW_pdfiOIx^nEYv{DNR#~6BQ#vM$mgIB9Gfv6d6`@$Om+ZJ?
zU7hPGFclsz{4pNziIcS%<U#51jR@189WVJV$>*$S^(V<U7mw=L(P)Zdilr~)(G=r7
zKV}IYNh`;W&&4unJ+>u7C8K2-(|K7m30JF>!+YqeWBN>Xu}r#pf_-GGIn~^biJix{
z<i24Y6d3=NrBM(5%F<2$Wyy!+jg8F<Av~v&VWez-2;c>EL#5OQCynL>#&M;eB0f>8
zjJ#OL-`?%Eb~#*I_O5u4l8qmBN&7IHEyT1?{pwa-8FSb7Pk7MVObSw|I8vjxz^Z<&
z6{V3M96-xki3?AuNM@G~b1d8~B_?>4Gm^6JP63+v;(DpL9(d|<hd;i!sI}bLdG%uF
zs?+-!70+jGN8)db(rvCNlDz`jfi*CbF^T$$!WZTS$VYO|qeJIo3CX56JNn`}l)029
zr}9{u;1TE9HZsKRXVKr-9*L7Krg_Ax7K~_Hv64LA?~O5xg9bWqPKYFQJ#orL#){T3
z*gY<MT)us?yJM}8;rzPms%_kTj2!^+b``5_Zf_7A^HnU~frec7h3XMkESaL|uavs$
z9+?2*rdU-q8S$)Q3cwo#>2qlO?HBhzK`CR?NbIz59GqH<bdC1*b|pwPN3)xr(7y)H
zP2^=}S-^>qEF2VfDk)R%{0r;%|AwXG{|!r-Ead0gFD$pu%xt{f<ve~#?i3)k;jH(h
zXAKq3&EYeXa$dc_=0~60+7FA|J$eplh*XT_nkpyMkPk-22Imo4g8)h?mZ5dFN&JeA
zDV8OwcI%lw)BM1E+>#6pnV4K!GfRvA!#fWA1%fCt1e7m^Wu16L6(meq!S2Wte%ybQ
z^7Ud-sg8Pf^S=EN{%O@tiO4mnR^0n+Y(O#u8c-A*BkfOG=<XUVldV7hr>#+S|8}f|
z=W|!T7RH4q(=aS8FSx~?Jp3oK7RzZ1>MAR#4JgTNOgd}eK=-X^%rK6KubP(Sc_mj6
zyqDr!FK9((EgK){gC%QAU>U3eaBk@CQNH3g2vOhz@5IAknFT(HANR;-$vJDyct2+E
z^JK=-JAZ+C)D?>(?W!BUgEoHtxV*hF&oA+Oxs#OF1SQV@xq;CO#|xOz1I(~i^T<_-
z+w~bZ3|T+EooTxa{!t$(p5Ow48x{mK--$XFicSAbNa6`HC7kK6OnLCXq&K7#+W|@0
zAu@{?T<b&+mGZ9cQjWgL;|jrQ=+Q+n(mzUV{8?$&?6vCaDACcABN;L91d!ENIjR<F
z+*%m>;Najoinujt_-7t*5j9KZtD09s%<t~ZYE>o9o|j1nUd1@&BveiHA(a$v7Ifbv
z<um8~4k?Mwi*YztIF|5kxc=Iz8-K(x`f$tBSYN0Yhvc$LbJA;9bMjB3>Q{qcExYPQ
zD-$2gCI^UEHoPISi_lY4_wSH(GN?}QVzNKas~ML$rb7YLy0DTORPjkNt~Vy}KQu3j
zs4<p#QT+nkKqUTU21CjF9=n3~Vny~3Lu07h-p?jkMo!xgxjhzp8(kc1$ZT_yEn8KC
zcs&u?k+uD8E2-4lyuKzT!@naqNr)^`q3omfh#!c;?NmnbroFiK?J=NB3R*icWsWqF
zSHMqT%`>fE$%Q}jrlXW5C7mkiti3N4#u5Na@Xw*-@@!B$cBo=kzP8X1_>Te^UGZ0e
z3}g9^0y#thAyp~9oX^<#v*2v0rN!TM-j|OL3JLFf2YZK(6*6if8o1L$wo22e@#Tx0
z_cH&{eqYP%+UUpX8=vfiZ23ODk@>KL(RwQ9c>7-FQ0ZLtn>SeN<-F#>oU)zxvU}6l
zw{6b`3r>s7`Kff@koZ4I@MAo=b@DPJj2RfoI<@u<gc0ul64ZV1U;$&7CSl!7nL^iM
zu63X2y3llKETd`Dk7i>y2a8NCw=^|AgJj_@76iKVi13V+Ky-a@TX-m*1|#D+*naWg
zrg#jQ6)%i7l|#ux`VsLuQo5tQ>ea`oouOZoX~Qnmr9d4gq`DX7f*;P#4@7rFosQAG
zNS;X8@9)pQh{Q^bb^4N!DQ;UXSWZfQa(T}=tKvi4W)C&11EZNam9r0WW=R7(x)YgK
zoK;3OH&(UNW3eW2v>Lt4GqaWN3u^52cBPftsrnXc+yG|u=>9+P0N4!3Z&K%W@gwhx
zUZV*n<p){+05akqK<@kxAj6l1_j9||Y;7)kygi5OnUMCZYr5uuV0?bCzE4G3?0x^)
z&uq<KBhBS0>`+FkK7>6PG8`lKGr;s#m)e)uQvH0jiVq*MUPSoaX{f2ZHCHJp;J_-s
zG+?AU#a$>f==Si1_$aMB#w89Cs+LZnKn<e64*-(M$+L90R)sfy?8}xW(6Bpxchd5h
ziX%HgIM$2?OiwM_d!llnUt((*ww!8uUOeO~MAqXr8g1*otsMn!q59sVwR=rL7lNFk
zDA5w-;M;106|~2E6|~J5Vl(oj>x7_YZX~oQf<dr3ioO=qU=CV=7Q%M%jdpvb36C(g
z!rvGYi$QTt^u3u~(gW-MF}*Gcf-kR$`Ho7yOZ%Lzz_o!@o4wcUL6}`i><V^aPLycw
z)%8;O*zHb@2o@k*?GV#y)~J0Ke;V+`JTFwh)}3-4X~zL7N2?^D^?HQ|W7qMPMh|Ej
zp6^{1+)>2)cV|QrA`dTwxE@3ZJKi=}rh9PNT#zxZH{)A(*ZPmO=Pxc+ZH#QGL;(rP
zN)}(iHY+Ks`uW#4X&0ip`*u)dBt4yvT7<Z-swB+!9|tr}V+(&Y)0qndy`Sir{tV8g
zgv;8GFy<?Kr`-a-SNZdve|mN*^}#j{h*3_b5&#d9#QmAv{F$j7zOxrlkY`BbS8-P|
z&pp2Jd;fRLpcIF)?~R9`>iGqaPdV(CX6=w;J1b41@bVj|B&n4k^0heWGwW1+C?IQh
z18u{7c0r1eYN*F%8$b(aQ>0xoZ}300dX>tnmH5LXKC_QkQ!Q5g{!y30noH=-xaZhX
zz7hJ4**MQUmM1)qqoP*_Q#90FW9v>OE}FLsNT3P$JeJrG3ga=>C$~{GtWTV!$aJKO
z@?q1o3W!x&Lj`uUYyp`J0D*`VOV@w2onUP#U(gOkt;%$V$}URNzW6s8Ly7%O#%Kua
z=70Yyuip9YK>K#PdiQir4I)<ZCo-3{GU1S#3h7o!oYqKmtp0(THR^F1r&6!z$JOa&
zYX`Ahb?;j_V~Opbou3LCHdT<^Zo&8IJ{-*%J=$JWY~FYiKb<ODtuQXCg%Rm(3HN7r
z{M5&NEF2fhSVFHVIS~^JNk65#Q*TYH26!=1gznG0Ii{?M<Kct}R-&HXB-W51;RVrL
zuCgV}&^2!q`4}=34{QCzluN{4&cYz&;t<@nA=Hle2n@T+T3h1yn^X;~KG)77Fi~>n
zJN5lQaL?hv?l#*o@0Yt~k?-sJICv%(oO(WN)q`}#*82(?xHEaT>J<k$nbik$)t_>a
zE+C;UW72)A_CSX?1`y^0z|0&rG9V};$4nrNuy3{?Gs?Tfi7C`<#hvJm`Lf~*pz?}U
zZeq)%^*<n4@()N}{1+tOVAtkD&v514j~aNwDG8085_G&L62&%`r`Oc%v`8}QHc7_N
z6=z)beZ({k_OG4Zy|Z%gTUVo$5p*i=+9@PG-fC1FS97>!Cf?jOFgl&(M#MNV3`Afx
zN-s2pZGC2cs_uUG&!%7mq=|1$eCMlnVs#sO!5c?ez?r~JZ_a5A7vQYrAyVK}3*W|E
zn;+ERO}fds-|s@$1)_RlejNjpnU}HCk*9awr}3aE5hKc_ctkN*ks(PM^Q-iJjtAKw
z=ORP)g-Y~RcFci&!M4x_MVL}3Mp7rkO~Wc(m8CM~)||}SwefW~di*R5lh1>H&dSZU
zC{KmHxx&z9*?%C8bn*y)6rCoS0@bqPq~OZW2AGjK-~Kj9^|rQ1Wyv{Wg~L=eG={JN
z>tB$o{R?v4fd4JybQq&-+M=RX3z4mtwjXoe4Kz4Ki-jB9HQ*#;(xKvTKf9A>uOG)I
z#~+Ta4UF}it1p`LHZ^_H2zzb3cT+QE`T@yQL!tsu1s(><ZAVaRzApsGh6BHPSm~0Q
zn{)*->4D5+3|z<c^)dSL>^{4UA$`#lxG4&mxyw+EEPTM*AKiO()F#rn*jl<i(u?It
zs#Oqna_9%4W=Cy|Y@VVNx#?<`us<BEl`eoTS9r;Z`<W4$VSP@fOasFUz2Ah?0%!}J
z8fGr&c^<=aAR^ZG@|Tmvxibwy6DahL_?ZsANHEQ<)^KVwJ_^M5p))nc=TI`lnF;d(
zrt-B3vJh5X!Q2Pmpky|otcx9M8!0Oec`h_Tsx)KtZ@-M`-^AqNe-o2$g&+?3nR(rJ
ze{z<>uK1+_al1H<$Q)0V?bM`+6zLWr;C^pVXx<II;`Cqp8p%NbMmE$hfCAKQ@|_)i
z&$5@EOSG3t`L|yjF=vBhP6=d8IyHUErYFEI7tH)EXJ7UWsil91iV);Da><(${_N@-
zX49JPM@;-PG9GX(c)%vk=frlhD5885N!N`0YA860YG(qlOfP`o#CGw#*UOAY(ucek
z&WQG7&JLz`jh*(mQVX-Cg4M(t$?)h*CC6K6VwQLJfxUt)w%c}GU(W(mq>ronVCN*q
zJ$35x>C$OqTEeFz--i{}JelUeuVZ-<n_6`2s%|RSsifV`2!6!2p|XL}+IgQ5)lZ!E
z{9DTu&EMaIV#Hq2B|c7E6t92RBFJ`LoV+73<hEcW@^%4n_~GmGNYVWV_0_+qE}|w+
zbVafzUgJDFxC?U#ViiCXt1jBzj;B8Bk(A1H?{~ZUnc;nWB6(uHXR~%NT7>${@kd7)
zVlz+CD!s}L@0oe=K}nO^uCW`S2(I1FAUgZGul|b>4VwRnx(nJE<~`81v*Sd@htBO}
zOR0iLD)=aewcfpDXtUsyK09{gP;h>k3Z6P3wCSYi&Ev80hqlbq;2XsFxZ52XID5B~
z8=4ekmO$j2{l`5j(*6sUAg7a?J%pi1wTusgoTgMLF(UZyHjEEJJc|zMK^ss%M)%(f
z8QnGtx92)1y+Kiu;__A>Nv7^&6s7yt8cdRsq)FeO1i+vt4lwn6<Hib{QGXPo#FAQF
z;I_9+shYILx<;s#&x|_+Gyla4I63Ao4qwrp=;{+7<K{n5yvJzXT{lqsXP#zfER3h|
zD4klRII8e?{oCFhW)fIrs}LWKvHRyCCxtu1O$-f!9dV7!sZ<R4ddNV528~-Uv56dz
zE{PknfC?d<v}iy14+gt8LT6h$wFP?CZ>YPx^Wky4@#|LPi`A7H#oP)33&Qm!D4qQ3
zg{_B^3}cxDA^gMjpzA)rY5%aA>QS}feWAbG+wVtOUc$B1gp~2BvphvI0PbHIb#=(a
zxW1A<V%YD+(!JOv`+fi>uVzw<Z*pL7-QcH)dEzlSSM9b$Fpq~Cwf~2+`(C$Av|iH2
zMH4{4AlWmR8KWcfh!|DHxcM`suK%9THbI@NFpC&Bs3bo1{H66b`tw3Se>vjSwf&4I
z1e*BxuWkch7J=uw9}#8DnROqF<)1C4oIJ_U^$#rBilI4K+Ppdli#*!&A?MK)#toOy
zZ5=%3Xi&i1&xSBwQVW)yhF6ym*E78ojQ+TVo7JHBtw-A-xflDXYn)q(se|VIAl7|o
zS9jk|^?^{w`-A7$?3+`m!79|eJ$&72)@_!0&!W@91V?e4wJ-&%rCC3T+M+RP1+PLt
z4;D{Oj3pr_-_te!IZ85cfV=GKqfw)eRIqj0g7C(NIC^~Wd8yc`WF$dD#W|J7EucW^
z&9uD<cu94c8=+RTMiv-%hO>CSyUe0Se7hg-o1HD_85~lVCLvLu1*q*gXv_vS8{CbW
zc$_77_%dToqr5|G!{%R+(YVBnkj}qjY!Bqc&C4!*HXu}p&&^6&-;8!$UR3SO=kGPP
z{UI!m`=pA8MuM*n$9qJI0El1A;en!nZGf-AN73rKn*LRsDpgw$oX?JrYL`ravO$Z4
z8Zp~&>$P7w(LnFlxkXaR9&HfuI32=VQQ=Ni4e5Fwb1YiBI(Cw1)<6L%ovmV*GSPqZ
z$Q(g!7AMZB?4cMg9YQeft0e{(a0<_-h!xk9U``T>qs!{so<<7a4v{Jt^-IDj$KvrM
zp_eJzBoqM{<n`!}(P<O$eSpS|1fO5$oXcVu$+Hzd7HKA^+pl0j?XsV`Rv?y7IEFU+
zcy7}nM?o#Z%psw=el0xUUJH>~fKxoz&$Un6amN?s*TgC(a{u9EaPn^ih5Unw14}vt
z(a!tg#oyH1mND21Z+|w`66JNQ`U|{v11hVOa!Azug~9nG3*L8l4xhmK3=uC9QRXp8
zB}txpRu~37i6O^4{==q8(?C;C2aT}>vf91FL4q(Ffr=h=%ws->pt}cWFZtY*3w%`k
zgJNV{)7v;70uVj|=kOd&0Nqw1^^7SN5>!EADL()&uVR=ZCrYI7!w|-}X?*~TgeIHU
zaqf#GGuKgt%RWwAqNz88-|jg$a`KZ?sS@1&TSII|N07h)>BMyaY*{Q0)|>N{<q#h}
z>8xapdSF;B=n*m>=GqsZLFOn8^1l8^s~#&$PQgP%jLdfESv@%8aV?Md=`QDcr4_F7
zZ-+-F$dbTT=O1PiUJBsm9}R#0w=D<20_Zwzo;xBEPdM*gaq4-hY)&T(FcYRm2!QQ1
z;kM^+HPU1)Fb<f>pl}~(OAE^rTs{M4hCm}|5v0-^Df?J@jH1RBcO+{8@g4lj;<EeN
z!u-W_pX)hb_2lc}{QwQJ#d21T=#&6Z=;{u@0@+Av!Kq2ZB^kc^ej1oq#j&|VRe`4n
z#c;FqJe7AEf14WOOs%AHR0q$>{CUn@JrEjf?XAy3<M7?VeveE;Sc_d9sa|_MCwg?S
zjq=^MfaZRqXC*v)VxLK8h-hQmsuPpr5iXPgDHBF?%yY?h)Mg^6AU*v>om}S7sZ_e8
z#xz#7k#xmFO=b2JP8O)&tN(d49S?!PnJU@23K<Y#Bj&Aaf}YQcBL8eF{cZ2^8+-e%
zQILg%7R71WvPRMwfJiun$1{N3=5&}Oow_=jW;th!YJ8<z9La?IZZ+*x2`7O)pegN_
zbo9>j{2E3T5CeJM>cRye&R^+BWLyz2Y7iUSOy=)^QJV?xQnMKTEW+?ai;boMz`B(r
z`9v(&nVK0eDiSJOu-6qqI6i2d3uEK}W>e?Qr2JLwiL468r`bd9@G?*go7=%$L=pR5
zzYlL`B#{2$e$n)FbU>Yy8Kqy<$z)HmCql1z4Ha86W1-blvabV%!36_)I!_nlgV%2Q
z)CrBU8q@c2)`B=v6cG-h41xQTgL5K07v5E@N_^Wl!~TW-jaMjCRR*u}**$DiLvlse
z-!kF7=+<$`dhhTnGr6<k42MEdECdck1~;4XJ5m(|sPJ+)_VkoS4=&bULspTJC~R^9
z7ZRBX*V{|`0AtptoLI`S)rZ8JA0vPcAmU0QpANQlSafI1k;0ze^SeEz6b_QT(yF}6
zpGt|3{aca<XCz%tK|_TK8}OW7FIeOvR~(~n<nxS_icgc;FNSYygik)#41TRn@kfaC
z4*~|D#|x9{z7N5&aKRRPujk!oekb0tQt2iJf9qg*C-%+O)&$RPV%G(6w3M2m8>=`m
z*RNrcjd-+2K+y39@*a^ALcx%iDN<X%SI2gzhD?t_y;jAGgva-B=kI!>**L8XyIcQ=
z+JqLi1Ok|Qk~X|5hai+IpZ(A$1e#2y4Y2?DX<!_)y=N^XC3iJNrG_K?OOP-YijD6!
zI#8EfeCnhb_;c$-<E;<<PgT+1G5LctrF2+<jc6{=+X<oZ{ns<!eb7F+10T8&G9S1K
ztK0iG?=Q|KIN<D%>G}eh@E8vEL$VV<2RD|vk8Bdu%*b~}YnXSCsR=_ZrXhPNS)v6!
z>{6iTwW0g8&5bXpwy+PaSefa_JL|NlVVsgAJ^S4gc+GCG7Hlz9LH!mbx1*MBdgD#~
z=bjJi2Il3x&@nJaZAvB0Yeye_AZQc#y-AzezV8$953K<YxlNN2opX9wIco)s@n$}k
zrXeGO*(`I7WDeUBd!ZRzmq&*e7QJQjgf`i~-7!^!WUlk!(?TVF+`LHZ0}BFD0jsfP
zqfLRMcY<cU-*qpU)>`qvwNVm|(I{D0F`yi$!w{s_Y+nXIU4WeZKt9J2Gx*5^P~zjN
zK?7h;_%@leqEd!6`M8_|k4;OT62n5wW2?X!BDP#S+5q|8@KTqcwh2is^5;^0bHd63
zG$Q`xV(p~Y(<7)^Y@bGX$oSW>Mh=CTy4n!BqBV`&DSE~AUBR%xp)>k)sUuoF3ZO+#
z6y}3_@aG#?VWRa4$06G)ZfW*)^6GRUBNG4s4$!};@gVRw`z_he?G6LY)K;|=2x(MN
zd8&|yQ#MuH_;Swg;2?w8F4b${gxk$=Y{-^`XG{z4KVa_gs4p)2{@6S!lY!O$?CI-F
z`&XEGjcq3UBTvhGt~Ng0JoNbk{l7d2N8Zs9-gL2_J2O|jdy**I+>9@{A8q4DN*eu9
zNb=wYl(&8I`@s)?4>-TVk*d~LQX|4piy%GGL%IQETK{@z9d~+&VhOqWKA4W%^l_NX
zsB&ovQv{4<_s%R|o-IU*<l4>I9y};d(Z6mSrw%fsL48<9MxSB0%}BJ!ftE`{6M8s4
z54zeIv|1dk?`6&>hP`O_qIM#AT^k_sKm|Zs?1RlZDXQ2DDJWAmv$j8QROD>*+H&*k
z0evhGN@)8WM-wBBA27X%Te;W_hGe84D(rX7a=3@3VDZVow#*k<WHKMv49$zs7m3g2
zER9sg#=6c|<vbQ08}I$273xLrh!C)<NOPeThMP}^w~7DFLWb^@a2&R*skCD+_h#hn
z?Y<4x)O0o+y8#gAdhBo?VqQ+L6i%o<H#B+}Pbw6$98H16I$Q#1C%^F7pS%};@N*=l
zI(-yMnac_r3N0u$*+^%jrC=f@%<HJ|^M(RloT4dsW8}cKQgy`MJ)if%Fc(n}i`U|C
z<36Ca7S_vb=&Qvgh$Zd)LuihzW2n>%31@ZT3tzj_dYD)u)8DIzcpINKo=FU(hh3bK
zd0JC!Fw%0UP0jWGv8HtShP#`X8xs?D5NWY9D>5Fe2SpKjHJAqN$Ftw`%SGO8EmS$w
zYsabP&NcF9K;HhbZMbk1`uowDpao+%wn@S%aK8iPP7-e{``5MLroh@;zlWas?dW#5
z^>Bx8Z!Z6C<rLiaEVenhI8*P5wp{@b95jmwJy`?VkJFdwFl1(r5#=REtP_umC=hpI
z@Zay!HNJV(2WI8gWC5`(IO!*1`+LwVy)T45!c}|OGCDn_>;Wvc6dVlB!4HGCH+=&@
z&5L+Yc<Vx36J`Sm@q1f8&Z4FQO<2W80A1qlre{&JjQe!f;5cU~FB-gPzS#z9xnZw5
z6z&};2Ge2VYcfk9v#%J2QXgw{Ru?U&sw2~W8Y|tsCc`-JRC?sA!F-Y~mlw~~M54#Q
z$STmTUnA_|*<an5@D>P!Zoc;BJ1Y(B@A*F)m4EvnO4K0_7v^_r=V%safL4dh9iPj|
zyABw*0Hh_<>bo^?b{sLQ@K7(=+<T4a_G+!w_nFs7Y#3Pqy-hVS7G_}TMr=TVZzkXE
zIwfc=wvXJR&s}k2|3x43ksXIoK~LZ|g~JYzmkz_)qucx=Vf9Nt6%RqH5ZK1_5&G@J
zVQMzanaH>zx+>Dl1D}=CtWGH{1%5CPv(Z==39yQ08xT5ZU~M>l--EVATt4IEDU{J<
ziT)@bK6b>U!p{*b*|px_d#H$@MhxjG1Vo(;oqcs#FY-&z&dI5Z{vSfJT|z(?E=D)Y
zFJQ!ivCjHG4F>OOuxk<lfvYtQJ3j~;)ZgSS^wXEzMKZ$Sq}S%eEZBKfn2^_*0K*zY
zclOED>x&oPthkJ=+6!~TlhdhS4HPlN<&q)f{x`nu`Cif34mh&LNyo6@lfTR**u_CT
z;`jUAsU-n<+;FNw@fhYnfCPvIo{EiE?K`~=mU!(EB)U4(Nfg){BMrik+uvS@zEoNO
z=xvbNuASaM(wGJXi7&{73A&~n75veGC`76i(-iEoiqLWt)&Sbfhuw*l8$<hle^8U;
zmP^R&O=1w5b=qs4fJKaJ%lXDlFU0tY{$p)Idj+=XzHet+J!<RAi;dKOx?Xgd%sT^L
zE%`5W9wp}Q*1r)mRTfr|{uKzvk(W@cnZQ-z$b@(RglhF5m~Wk;9QOH;K_PZ4-r|EV
zi&#h8;d>ez_hfWWB|u_qxK}?lc2JvJi4|pzJ3)Fe6iSSJ<zsB6AZ#=Vi7^S&C9xHw
znl-Q#?N>!edaw<!P2maC)i-}97&w!R)zPxCvFoi<&qOTMR`;#jp*m=8*t+tH+V&Zx
z#*cHMSc=G2_Z<pcs4mldU-BWH78LzM9`kW@`EnNr_eRyTaZd`~W_90d-CqivyT&s2
zI*H-p#eaZc>~F+V?6fwq#Qql5_t*Rj1nB$Zv~6A;zr6`xy$ANM(Xb3(7#t`D0vv&T
zWFU0_Qx7x9;O<Nx&?os9Bd5dO;0R2wg?#5kU2f3j*dI9(rZBW0&Wte^8IS{uar%v!
zQl_)B0FP9a56aAGC}_2L?d?<3(+v}=$7;C&EHhtYw&EN2*|v!=rG45nqAketZAp}X
z`CSF-g159N(mRpaCExCTGiPeXF`OJ?s^S~$2zXG+vM&6C)pc0WE*=a|l+t8@LDWHM
z`;X2~qyrBi>+|1pt?i!*8QDYrLz^Ik9KW6Sp%(+ttd?DgAQKVh)Lww1KmC@sDc}0e
z<UUC@OxE9;00;2lbXa}f_R1<~K=e|m*?Ug`$)xs_vI0mZ`pmmEv~x%HbNy*^rR@*F
zg6A}gc=-b<W$u>>=Qt%61wkYeUaf0ZdQHa1`o0P`1t)Cc4m<V<F<knY6a-DKQN@*{
z5#HmV$&#Knp>38zovTI7Gr|MI6!ZAq_8+}Fcp<-y%m5WoJPEoB0x?(;<CuEQG8>mA
zPrvL7V|2~MP!f@R9w8vAbRlq!8T;IckHgMOit(mno4~p|&pT|!n79o7r9fkUW0yt$
zpU*7F-*h*5{_*1Wx7Zf}7Uf$5$~)h)-Bl6PC(+C3cxsxA9y4y^JP1s1d}H)FsW3T;
z0*|_Vf@;&wWB3k5frU|wQQl8mI$Qu$R5Fntb_re4wbi#=#1k&()CMjm%=owq4%P1F
z67Kbuh(TDYUNtPtE4NoOZSF288BfQrdSR@ej~Nn(l|-9C=b!!bp5U1Ktm3r^SSA&j
zEig6bAQNNRTN>2I;@)whS5hT7k#qg}0KbfjB%<KHJk>3z7S*I^ODc!1%a%$zC%Wm1
zvB$Jl?tjdeOo&xh_aw^GP-422|9(23D14*sd+phFoBCJJ@$N>(P6!sik1q`b(9_cc
zNCj@b@Fhvk?7!R1YWp@5rLEVy4rbZwm)3%up1mlI24C~i_`1=nz8X#)jHGjDv)O%C
zdL1uDmtrBkSaXwa?U?)zIRfS^d|Uc8Z920?Rb5TrLv&M1c{N8EN$oDLg%0yh%-I<{
z*qi4r)@VS{8cKRVzVsG5yJ}G!v6k6yRFK5X$FN?6kBwT>*oST?vos?|E<0&J)&PX`
zh8&yMG-SQdlf@>u$o6CQ=YK>{xc^^iN|y0I<>O3H1moK|WACW;E4s73;@$f4_3n)%
zVNMZJ#2B4_9jWCk5j{B@Opmr#G2yI#6Mk)lT05EpLVI{>4yS2c*BP=kbCi#{k8}3n
zRpCJE1(90KHS}Z5>J{*otfoUpk1#ivkg2SidO=l?UDF8nd|6=Q3rppihNh+KJ6xs{
zbJ6K!`W+;4-Aq#BA|fdWR<nfXWcM;k;~e268U>OovI#7qoC1>jY@~)KJX@iO%N0DI
z4(tzZb!-P%D7JqGIP+zp`7;zg!&*1Ol~;eYEaXYQnuY(<oy!XejQuN9@{#{%j8rc=
zk`bq5l`;O@Tm9-{^k`hSsQ!p?5jsVcJl?~H?D=kwu>}?g?WSzPdm{K$7>QC>P_+Wh
z3gXo_RnmWW(C9%QOFc`cU0u{!r@+Sm6w0Mh6jz7OcJ;oGncnzJkI@xjK9`WV^Rhdx
zSP1h*dcBh4BEYuRR190$TJ!10!}%KO36rl=cAgTR)3FktmebGZ%Sa=)WoJpS@fj+8
zpARg7ET!Zn5OYz2T>OBrrK-2!bqAY~GtCJlUWhZXA1dbG6#OLOrRZ30cJ_RoOhz+}
zl}|<IPK|f-hvZ~*_R(M5Ap~2Fzg@|U_x@ANgOht`MH|AW3qmAkzsy|pb4RTyS~l4+
zkOI9Ju_8m7dN{%pY<oypKy2S@TF-iBFLn^IXaKPDK{)hMTxZc*$D}jc#lq;vr3sg5
z{*cqV@!p`hp}Ag3;zhrHYZBt1XJ?^5Wl&d_L0NmCUfZ3mIh7hX^2seeUmI5marN}_
zYLd9)IX(N?zHoNR)6={l#V+1rW7YA-R2GXdz1IiI1b_k!zrVnWb_{(Vd5D^L`Yk+3
zRC>uf530cRiw5!^_1;H4&OK~<5x<7;fhz}t^JlQmAwz{-bFrR=3c~mP&CqsD{?;yy
z{!=ajitMwKBfUO<klorbis~Hq!uT~ySax!s0H5*Rh&Cg&DR^aqNJXk+42M@70SG{K
zy<^g~r(|M~V7kl=|9+rrKeyM=5kTtbdjyz`EZTcljjlN_I+L2Y?(q(p-<xY247+R$
zuIT+xdEN?!T~m%}+)J66#d*7?QO{;JbW;V8U}wiWRClJoOt}r9H8q(GfcGbqHM7z&
zbd@07%U9oF%!9e{*V=q73O@L<tA+4vC)Aov#6%n)Z4JJzCZx(*Hyrpf5A@P~b`@Q0
z3u_Lyu|#FK=a~oh{`0ci|Gw-e|L0|M-7P6=Uf#W2e|5Cpt!isD64ld&JEFzp?Z?oX
zkfROW(`uR<yImtab8v-fq`=HTUS^<xC$scqF$_;_uvA0}(zi45kGqzcu?Zfl&~OFY
zBaOSXwLV_vgvb^l)Bw;uf#&&K)G#h$<gljh?p3nTXK3d1X=dzn*?_5~&5UFI7JJRB
zin;5Ubd>{(Trn_gyWy@0oY3XPcBE!QA&*bCi!7vOi59U8|G_e_#y=KghJ3#NouB0M
z0m{W^?AY0aluhM)B6ho=VcE{5^Y8|TeBh1Rs{gTX5rIrG-Lv?webKSxuiM(TTeT$@
z#%sI36j`4<sae7dXU0twRy|o^EhwiKlMw6csEO0c9sjCn9h|@-n05OVV@dYS&K3JO
zHqeB@6aT*d$KG2;Rn@is!iXTTiA`?0Luo`Lr5hAcnoT1px#><xK|-V(RFDqo?ha`r
zHz3_e*So;y_QwA?;~nE2?>J+e56`zf*4k^XIj?#3^}FUm(8l0tp<}I5A+C~n_CO;n
z@Hq-k;1+f{FZ3JIvL8HlWTk-*rf&{(YnQ2-HM-@UeqqS5cwK~fz*<JwP+In7hGcy$
zFS8OEsOH)<TJMR`_!JP%B=kk^6U@DfDI{n-*+V=E&g{??gyqgJK6I0TfNPxCKx#U8
zQ3Gfx!QjsDPHP!|>%pM*iO(^KR$QUHJ@D_OYu9Zb*S-YjwW9t^@UNm4_}UPCDphTN
z_|{=rn6ii<XH4^@ZRA^Jw5AKWIT(H1xDOjdgb8boiQ4PVhZUbFgt8CxqOoZKDDz~~
z%qfs1^`;ZeMuYa`XF{$$;2IdtB5&d&wrqu(T@1h2`c~mD<fsqK+XeGf&ELaH)=1(l
zX!Xogp1#c+S2qKSiJIukpdWCXSJNdN`cmvhIH4U17<cTdXkc)%J2{!%QRreQ8fb<h
zyhiu72&LZlx3F4m9E^*qmlvl`VF@_JCwca*I<O_?eb10GTK^{^bOn-?Y7%~bFyNmW
z*zONZPrp5Znr$vsZ<holpO=p`JYhn@Cosf<B;_Df%)P!-_5p((={09d;kS?bg|Wwo
zaDT62Byu(c{7B<PMAdMkxBE4*4isYuI_K_`Vvr-2Wc9nY#Z}=L8F;c>sM;2&q~@YB
z`cKM8dS+>0tUA@5ss?7rEHoC>soBi1(k2r}Lv+27b+;3=dJ+W4b9Bpiaploc8=B^0
z7a2pLp^y>XH|^`P6|Q&;Aw>%&eTB?ywGE+y=2ZbNiog7mf)%=ML0tROXibGobARBS
z@;bKgNyzkBLHp)U6*EC`y<9LGAwqC4{?Ig2TTPw~f+}&@-a`c9Lo98t5?(QkxcQ`Y
zQ)KG5zU*GA4z%jl-;EH7xrp{+mj&f%+Q=DtsbHUr8%7!jnwE^sOyBGlHjN<UL)0t^
z>2pRk?}~wj@(|c6RO<XyM<aZKTKn8Cqx-45?=S+zZ#9K%_|-0+8K+TrH`U!sva0(=
zb2hDok0%1*%^QW{UnV|7YP+93agN5!&i~`=Iwf7>8StV1+LVoZ$UhKtjs%aho_Ign
zGvl!o-Fx>~@j}O^g^0dGPhE7b=~M%Wtx5}MMKj`D1V9}9POm}<o56g->jdrH+IeIF
z-QK}o;)ZDSn9D)3T>KH<1KMmMpD_zZ1_#YCpXQZW%4gJ8*u1SRG%vN7`PN#+S>KHS
z^}~9OK=<pdATeKqr1^XeYqF6{+IE8>pKXO;BDm1c+C`ma2}XcVQwUB8z$P_#d6@9p
zB+;QbDPTtw=<O28{*O8#1(Lzc>05u$887sB9yILKJ=Iz>@3Uq95xGzJ!^I1t%^0ih
zm1mH1pY;w<$41pv*bX%!i9KqyuNJfrTz2EE36BGnutf)u(3pp%`K2}gbVb1SyyA+~
z3+JT;iX8<dcd;NZ8p;u?;v?t`#R)5tJ)NWSbn7ShNpVzH8d_V38grQ)b7Zuk8O%A-
zFnT05w|SqAEi>d$)$l?93W<o$xrNhwM-#7oLSvh^wa;^G^|A5rea9t-$eJ~&YfBG!
zI7&depA8-I7!T$r_nQ4W(K0T8uNSNPRQv6d{d1axa#+yFuw{{*BSZ`ZZU;p6cGiY_
z7><>5FzY^5L9897cX#WW3Pl@20|;rR!d?585sh|_JgCX(`ClSXp|Jf*>EeeX<va8&
z%tP~yb6ZRG<!f0rOJ{(kywB4qY2+s%733Ctsa@#g;z(hz&l2Qu7)7ZQHWv5#Eiw0s
z>7DLDA`!mghrq!RO|2v*%Sk5=)pJvhBoMAIpiG+IX(88uYg4u@dW*G0kx_MRAvH$*
zLRaY{BV%}B;S|#dn!c?3P-rG7h>K&H8Ap*HhP-aWDS8j0V*Hxg8$=4^ycVea5GXD$
zm*+d4Af#C$LYmOsDIj9#lbnh<n5*!(Jed2_yxMOh)PCJ#6Y<=nd9`VG&^Y+rMGbB6
zK}X1i*$?&6orFm*QK1Ds8{DCprq4@NR8_}!+sR&83BlD}+rKhS7N)&L)=V?{oftl(
zxz^CS{{J8Wz3`oq@UuiK;QPUZlhHpk&CJ@#*clod#B>r%eg;#~W>Ahzq~{QLsZh=#
zuJ}%%KXH~sg~m3IG%NTCg@NMGzw?l@`4f!Ny1}NGSj&hSN>TSKM)M|(EIO29+veL7
zn}0qgPEK*=M1}IA#W1%NiV*n|+9-^?`n+X~N&2v*&u#g^VYEj3L<lYRK6j%IBbq(w
zwQ~fp#Q!c-B}LDjtoZ)eJbM?`tnAnY4-O{gDiy?g%>e?=`=|m^<SVYw<ta8V)r#+;
zwB`UrnsPY5@1wmQIU7UoYq2k4Ri<W-$HrgqY6YuVm0<$Q7#%PoMu5C*uoWVD&WylT
zUdgKl3MJf9@@b)Hh0S(#cbhL3rX8vxjB1!9n!d!2HGrxG+biFs24CoHt6d{l$ak?R
znw9>!HmmH#rfdPEFT7rGLBBrQWKi&)cVqqHy}W(Wu<O%|Otr8KGfWSCB!(XMb%30W
z&7;S@qL9ee&=7Cw!^i}Q*L3&#W5Y><gvTS!gCQ7$9T21NM|ZE%xI`!h#|^EQ8r}pO
zTB?5SO|<qUx0}0k*vnmj8<AI8y~|Pho%i>;qO>`8-IXHf!?tXnEx(i#onDI1TVOi<
z8r4Ece<}RIN*M=MtJJk#ca!j$E<nK3<7jomdr@UO>n%Z)nDCR@bITGL;jk+yqG5U&
zX0Me^i^}+^dSrY6b<Xq~>j7q2ep#QYc~+?k>3UvWU8~E0BaR;PJx6A5Bl4aPyw+3d
z2|^axy}WDB1;F9<4IeLZ5&NS5$*Y~Acfj8rW8E^II{64!x}8|OYTDD&qj6$Cj(|gc
zXxs{U62a|I&tMI-$;sl?xuQ`*adfR80(qZHx=q9L3Nrv4aKtxLBN;LQQz9y}kf+n0
z#qT9lMfo*v(pYyMgs0qe)T{mLd)@HVjgPWebS=B=YX8daZv}gu?sd++hH!P?@?U<3
zC&1Gp6gPN7n}6qi{lM?r;q5oCgZ}q*H^JP0X#HPe{&T$0Z+&q?oBy)Pf938Uwef$4
zRvBl;?=X5eIx+F)+yETb&Ke=3uCEW*;e3qwI}Of$qxTL0ui^JuS=YAt0rGJ`0_>xf
zL6JHguUzJks+yXK?Q&l!0ki6OET`edPBV77Qiha<l9JL^p2L|nQ`C=a#Y^p<`>=u=
z52^#@+6$RY|HlhyAk9Xouh_>HRa6YymFMB9BAGh=tfuQWJ1{o1-MieIU~+J9pd~t%
z7C>Pt?vF9?Y9%`_uT=PQH_Tx<$q{f`a;mkgJkKUK?@}Iny(bqao3-8ujXVcX1sP$d
z_4S4I+1X42i{audaSHyK-vAIk5ULK{=xm{XbhbB-#2p_MY3YE{Z{Nm!kU>);bJkCv
zzQ?2#ngZMai~5Vh{r9?y@^W&A6+^rJs6{B2B&PE2<!Z+~zNFf8O%~SHyAElq!j}ue
z8>^WqGw3fo&L(Gn{8}BV4cnY9sb5zV-1WWKa;z^|PVuZe+6%;?-6-w`%0lclg-26c
zLgR({z_C`Nqob4D`s>xR7x}xFze_T1&##>f)<0R3ntb$u?=+~n+SQ|$)tiqKp176?
zkQ8tSme+1tICRp-jDLLaa>{;g`$?1qbK#pIhU&}H>wMDbP#N>90`Rwcm?VpOt~-q=
zlfW!3Go-^D0^VrxZ==nfE(>418H3usXVobF<k*8`fe4wsNM=IJfATr^Gz!3zT3x3z
zb}fJ~@%Q<5HJ0e$vK75)xBXs+v(0iV$hT9hjr3r)V&?pcraSst90TROBIh++4I^qP
z#l;T=_ItRrmmA-r9Mx{593jE-w95ND_7i5ufnCIQ>?3;7#Rqkp<ud8pa3rf<_~d2g
zn3W}T&1;i4sC03_X8%56svrTt30wXu<m?+-E!a6C=J6pezwGK{OfgTnI$yR}8A!X(
z9_70a1{#d1v<vQH3l4ak4yBMRa~-g{B33ws#pt+nF2j0LglF5rD6Ot{gWR@<)7`3G
zOBht)kdwHk0F*szm9N|OAhiE<<L^}67cmLex8#|&8_L;|=E*279^@M2G>2WB9+cUw
zzA&@2+=A5f@h)Ig?{zUhk!{Z59|{^nV!P~J(K>yr^~Ff|@_1qMZ1&1ycC9SaYh8uM
zh5Q+6g$_!DJqYl3XJ9v8x%VG=piuLAQyzy8&jG#=o703UFE9V(O{44VnU3N|9K<`+
zb2F~n_A#H+()5{k43Y}mH_fEVgF7E7m#L--2L$hb>w9tpJ=+Nop3;ijel?P<a(KKD
zHknsGvj$JDg;<L?u1gD_Mvyy<>sJE!8Lh8r*f-8#t?u=r9qImAbYVNeT+C_8`6A<C
z2W^<SJ-b+giSU_*;R_7oj&-fr;)G6ap~IpuK8!_vP6hGHUMr8GF|#g<_R>V6st#nk
z<|cF7W`E56Ry*h9xSa}4W||Ue3cCT(HeVdO35RbmbA|VP9K6OGppvOwJ}llj1lOU2
z86#Th&?!qt_PXPFRYQ8Ohl!z76EicGSC>cio0ZGS`$Z3*@{MKkuVrPJ&$k3!3SLa7
z3eU~E<?i<h^b74pgqe@{#y<=~8>>GZEw3vju;Vm@SI-=<olPwZm8&Fd@<E4vy=tBJ
zjZ?x}U58jR*e2yl`;NrQgW~=D_B*rSX0<V2zA*ILoa}Y8pVbqTVd8niu!y*@ic>72
zfQQ`*!k!$)vO+5cW>IEAvjCnlIg7=A5?AHAL_EHJbFv2gA5L{uzT?vwsVKCn*Sb(R
z@TBs5uX}Son0*UU*5rcZgF@*xP<MGya3qFVz=^TTtb6jV8tVJ8kb`Sh_i_(%RZN+j
z;o2qv_9fNPt#K+UIBKms5%}o7EB}jcInfY$_O;$wUSD_0w)g(bLVop@4S3%6XA@QZ
z4i}x(Xs!lU@FXHTVke`}E*i@FLQk>ItMmRVqDYx3STm-OD!&q3olgf5qXaG4{cxfH
z@!4SsR|COJ3>!^KP!Mxd)AF1X5qi8<88X!E*_W4$RJf_J$;p0(41vk8CbYvwY>xp3
z#pJ}vB+7l~IKs=zv+eELwnzKtJcGJ}7^BNh*Sl41*5&GVWQbD3*siOjq`&QPR6Q-Z
ziCv=usyHUA2i8qKH{rM?K-GXJHG9(M$lr5>rHS&J4S#p?HwiPHH|O7&i*ZtdImn5?
zRz<VNZm_O7w;(@v{rOM!Gi3ifrg?Ek$MU<AiF~$h5sN$g)bF++W1Hw8YCjDy8o53^
z#z73!_};eDrjb2Yd?kIM?L=QevW|5{v&8tlFbL9(DSCe+V_S$K>}(u07^8b(dwr^j
z(_=-Pa*xjp?#z%wrNF5z^zzdY&*;w4B{Bp$*ARbpzG0%~72GeDx%D#TRGAllR!vQf
z6!@%1^rhFj!0bsVV-3|ObF&NfHS3L{_Nwl-<sR1IgSDK3Ll!@{v#FFwhE}YWYCiPM
zn6_im*w2_i=y-2lyP>HhRVK5H^fz`p3sA)jz`m!&$cc)vARGOwjTo%CcHv9w0B4`1
zn@~#6>biEY+w1G;MC*`oecGsu_mlL7wUL~Q;9u@X(_@pu^$000YhMp%uP$aMwT*bp
zB}~@T>Q6^hZ5viT4k*P1?o<{2LV?=7Ark6fADcY0dA35+u@meu+jQu8zCbxWL6f>6
zL*4QH1P%V7zNC4O66O~yw6BBlz%8%IFAXh`G0ARFb;JR=;<){I!X)M3M58i^GchbR
zUhDKOo4*m8Zk=1TA%h*x!&NM$^}>z&Fr^sbtCRjM%b#_3FDb(?$m#Fn?Ge9=*COI~
zS^XUI14U@Zdur&?$_K<8K%G{@YdU-%+x=5;v};%%iLo%4>}p^5YRI@J_WSIsq{til
zO>kqs@BOjgPqG`*C4)C6XD`dFDGAwL%Rkpcoed@I1I<I+J>sxH+Q|M5oAp<h@CVq<
z>+3Mi#P@8-^&5B?sHW#MPes&=4E&na$M1M%Qdqa(9DWb;7!DQO>)83`NzLd4-Vp=S
zDD28#YM3Pb+#gtR0+SJ~9Ts?A<dn0XxdBFOgMU$q4j|`7<N>2X?40gAnwf8_NwRYr
zc>(k&klGd_hE8T62)#QW0V0mTx4o8~laF4#YrS*nIP31X%|`(|Ivm^YFlF67G5q!A
zbe!QA*(&2ilPIkfo860jZQobY-ogCmz+R>VX!=_aW61>yoUUY$&z)HEEw7;nAA1AM
zL#;VVFWKlD7O5)PAb0ZFVM=O*mje1J=40dIuN9vhe7s8N^y3gZ$`rnMbH$U2#Kx9z
zjeaPE+?;9h;#ivQ2-~S;YZy3x4!EjCFc&XpSIn#XfCcao4tMhFCbpZ_FE&s7V*2ow
z75)6`uTY^I0jW)cDb20>b~NM3x~V6A3C|#Sk6=$ZEPdk(!Ra&m$w%Y#F;Lv(y+;So
zn0Nc%uN6zYo<d)P5Ff>*(n5?Iza|C<1Ee3asljtDHcJUB5{h&JoAMfu{#4h9!J@?D
z<!E`x(labG<{yq1t$l~BF6G+BClf#12;dN{^*Ag^@ym1rp2Lxgg}&XUNqi~IQMp+*
zNoFIqqmN>@TX)>beo9texIm7~#un0J9+P&@E}wThbO4WGF;xfpV$K_d0><;O2Bp9g
z4$>`@jb!l4JhiWIipZzdepY8#ch}zmx6k9anUdt{>9W6zO(;=gjDGQNzpNI>Vyd;2
z)BG`((gd+QR>_`~eaQ44oS)aD)?wyWV7si?R4>~?o9-~rb3?^!k)wB?h35>^$?64d
zJqWcqFK3MOQ|u})0aI<x?HH(AIJ+C_IPQ5d=6NDW?oqjv$jVTXiq|5>v%qTQ9PED5
zt?Myzwc6?t#~n5ht;Nd|qJfB}%QA_`hR8%sGZq9VLiKkOYLZo7A>5rnwb7r@m_uKl
zPzsnD;P=66{u%pBs2t$5%tV`a;@FY0zNf{QqM`gYmTKzb?DmEU*HVgOF!7khZM(;-
z10$Fkwo8&0{EV)VnS~6}Ow{bjEI50;+fdICOYP%)r_k-WHd3o!EzFfyD2U6hI4;Ch
z+5f2P>u!7ITZYhk8u)-N9d#Bv%sT15nDol8BNS*QwNE8SgV5^7Dck-hhk)EV<VcYA
zgh-G1f;hS8LiO!2UV%W`@i4X*PHc{f?IB*ReCGQ4Dd#kl{2~{3Ak#4g`tLcbpziHm
zJAzeEg*TLhhq80?T>b!s=bvZ<toAgEd8OKR3<%d{PQjk?`;*Df^4XYAQo`I<<#laj
zHb_;akB!zm{h9YXSlsfh+!jbLg)Wdh04fxvY`br}*4lm>hb&ug7TvoOYq&I3M$QVn
zRb2Tb`PdWVmph6b(dsd)R$1;5p<Od7)E&?Jm+FA`bxLRs^QN;6c_&QtSd!L2?Yff&
z@D4W70op6bH53*m$vzTU_IoC8`I-bp9sv$zu6n@&42|~)?9uj~blLv&QZJTD91p^x
zKHwS@iqq)hT1BkzqtTaGKTW=gqsk%=M{<D5+%J@9a`%!<cLjQY0zDsmW?{4Z+3)C6
zbkAW&c-hTfrmi6P6}BJRd7~zh8E#E+=on^EENdw3L!|@904-gIVmeaJwmwAcb_@?F
zAM|NxH4o9BP@0=htTrpC9lbm(ulIXO{_fZuiJkw28zUa$Gdl#Diifr5WpbVkt)<nd
z@ffU|TD)PwW?eWhnrY_HqXvLJQtw)oYr)|8<2n~g6Qq)gAH7{IZEh;$^3Ucpx0IIm
zl;s+aUTw6UPQCOBE^IxhbDF(G7xgz2v5tTj!k!HW2%qaKI*7ummg3E(&_D&-UCF7P
zz7)R1(PMZO4t6z2Tnya$Vv)gYRavvYjsfD4i}_$KyC1M(+%am3fF4h&%+1$u_%q^G
z+03eKJvniVct#5Uup=4s!OZI?qK-Pyjm?yHeHQe|O~!BXPsVRN1D)g7yHEu2#wIaF
zAB2|Y738c(Gp+>z&OiG)_3u47OsWpI^lY#{`57Z1I1sT`Fu+Lz`(BF*B4_Z&c=({T
zD~fsZsQ&6gRhFa4MWAGM(mQwy9I3-`2Px?>Tj7+hGp%><LK<niWG-Jyuzs}r%ZBC9
zI8WLWs9nyA-QI*vuotr$COMGH4KKK{Z-2_i-cPbcJokf$9NIWUjNQ7Q+U;oGO{0~P
ze(U+DsY!VqkehHcd0=9fC(CD$%_75g|B<pET%W?Ro^DOuuj0n|DzFr5C|J~VFs8e`
zI@9d$%ku?K_}74V^UKL;u5;iJI-<*C7k;QO)|dGHUgM5CLlFivX#Ao`YGN$QY_+Oc
zr=*xrGM*$h1_S+y<!qH4LAS^tIaFOB6mwGvq)QSoCi_$peb$ErRelN7`@P+6a^skP
zx;r<NkXNK&mwi0-C%rS_4=-m727~(Dmblt5tR|VEu0e5Uv298Fp-p>V72Uh~gw8hd
zmXrX#R>*4DX|U-1sV|1nC)(93C_O;4$hl93Cx3oW;AzjpTEo+fS5PsJZYZ~-&04?+
z`>rCm`E6)QqlcVb)E6d+YMf<=`nJ;klwupRfgm)<_UExxZfWVr%QM@2%1F<F(wc=(
zfigLyrsc)>S4gXcs1;)L*XaSOl$)Tl`j!T}gE%<f8vF!J)ba(oN27_RQ{Q%cAQH+X
zlfAwDVg1!v{dJ6WlwaFY1zm~JxNA#Jo4k!(u_CoA|9Cm%z<!vwJY>INt7<(z@6_Zz
zHFemLzC&%@8+hEY&qdKQPrv@BB0a!rmI-%{9(S*!K{2oew`=wVS>3l{9ez4lA?9DU
z^&d&b1XJ}s|6VxIYZxtMOoah3i?Y~tugIRpjWJ^WV~pAfQpH<xZF&l05_r8so0X)=
ze^Tube)_egwPHSP)6FVW{;p3lzq<8=m-1po`bnd>Wi=p(`Izv~t$Wk?;Hs6^yTHda
znR&jVG_S`dg@qIH3n~2AeM@<s$|FvdME!*-v%Bpe-Ug%%@vkiMuuL;+t2EQENcJ*Y
zF2;W-{<9e-ZwpBQzSLcUWW$<2B{sGWWNutW;<ZhZ?4t`ngrfxiDgB8E-DH;>{$$k;
zD-e;uU-pg1De5_v39GQ6JVCM~yq<xfxRBge?v@Jmy(j#Ye&G&3qtsjy>NIu%Jy!NP
zLrP@cJ=QPG(`__QYk7-w8XU^WlH2S{Q3>wg;BJ~2QPZ6Uy+>l?HwS#OFPYZMf)DcR
z51K&i<3J$7?s_<3(hNXh4>F8<<3|!Y6&p%zfd+yHz6(Gc7E^o0fZC5i@JdzkvYN`v
z+7hyC%NgZqSxh*3(FCcR+h%s-M9hDVc70xXhsjM=EB{Xvzn+eel*f^D1Oz8K_KHoQ
zWiaPrs3#FoXuJDtQ)zB~)f$s-Gqc@0n{~i6_|hQaX|ssoY&RBi`H+vLb+KXyFUB}B
zw9LgE6&4D?!x~y!t(wKc4F|Er$lzfxndK1OMO%<Ik-y^Llb14S&U^2s9&HK~V?okl
zgPwX^tn0cuG(Fd?d&zJ*CzX{>+T|(S9mBr;G`Z1HJRsu1nr#dU80N=h3KU@fmtD}|
zK_*&i<u0i3;uvz?HrF?92C-E%j47ixBc2_8r-X6JQ?GNigyfHwp^sV65Y+<a(snG*
z>IouAyXVkT9*ZckI;+~L{&Vu)N*x91J|r>>NsM5!{3P3oEK+g_fBYGzh4;Ym(@oF2
z#-_MfK28t|pL8nLnHE{x88eg13<lzv#h{xi&5M7s#dG#5UIV4Cztbr0_QBZmhoS@u
za_SogM&_GJF?J2*tg7TDnE*2|1~<^EqQw^6@d`-b%+Xd~@!)tRIMkD3)AfLYf~apA
zecjhp3=-)z@N>RO8^d)&z~fTqOK{tx4Gd}{L@fWOdv2CEuuVajlCVD^t{d9Gl$9Ad
z+oeF-)_J+O`ts<}Y^WFWk?yC^>)lqn+3nnacRL?Jyg63p?VMP9(7=nAFBg_k+0Sd+
z1_Zu@GMZa2)G&GU*$1AI9+!Eo18K6oG7PST3!=kzS5C6`#OFkzQYi2CJId5}J^XWl
z6kJPtKN9f<aPk`&rTAzC&it3B3C0SYGrH6@*3Y!q&N)M@+d_yh%Jc_OtN5n^{6MFB
z6qUjJCAy*Ssl)Ztnx&8RoL&t#g}fhT=Ltgdj^;l+@*ooHI_fFxDdecJIzQfpx6f2s
zVX$I=QXV8uLXts8!wH2Fdb+hPrTvrhd>&t^L`qmo7wgHZv@lLK3OLSp>dv+%nZA9r
zH|a}!V<&h<DE6?#;-LgL%XxXTW5Y?n|K2O!@n>pahf|y52p&s&*N+{)iqX|W)41pz
z`7xTR3#t&iPfg@^l)li2zb#-JHsxxIMHKl6HZ_GxhQx9>G4{06B6DFn0|6eB|3I6)
zPOT2RD$)(*oad8cp{t!LJHRFzlQ&jU_)ipA^FmMBi@AV89h>%dss4qY0PvSG+JQqh
zP(@j0cs^iTIl_TV4d$ovJQE<Xc^x~G14jv$(lXUbkpm1Em>~~b#NY+C_wH8Iy7vuk
z`2WW+OZ_QUQx!Td)kFE$?kh6(OA!92N(r0|6MxO+R<|H3|DS4+Xi%t$uj_xX-M6a>
z`M|JHZU?w}Ln$czYtWxU<xORd2m#&bAu%n?`bsJagYc`B)tk+uLuC5|voe8VBaN>F
z1}bMf*{BsW_kY^!{;tLUGjyTjbr&n<wsb=&sf04*nshf%#+yng6*gcqH~nLnfPc_r
zUuQLMm%RdjO>k(ICxC6<!x{1WdqN%J$b+%MBh%A)d{CtsR&Qp)U=4kJ{g0Nzs<&To
zy-|WMfsG>7$?`Je3Cv=<^@5vP$~E2_lU?QiZFX{VOk$cYmVb8OpCQgY5Bu)+<)?2n
z8_FQA`XS+(qSxZNV3S9r2g;z}AmK|OD+!S@QKfq!ONihoze~p#ee>cIZEblt5-K$s
zcn}0W?&H$WH?i89neLr1-<olsIe%Q9#JAkTb(G9?<vi;wjTq$R!yIvcCu@!gp+6lr
z+zW}0>JFNW2qJElAtHLdswuQai>`0rpNs#wPlvd_)C)R~pzyGskk<IpGQnl6DtOMw
zpy-m*$)%MoeKhcfGhqKg1yfmyl^ihEKf|Vq<2{F!zSw83&_w%G9r5qW!bQk&^f1{Z
z#^%3O?ZAresl~8q6EaGNvHqURf1V#E@;;jN6y^vsvyS&MvmQJe|1<LSOB!fsQ|C<S
zzZo%Y{3tbJ-t3*eUdKQ07C}4^5osKe%L|;N`4lew^!6Rxa1qu|zL^ATG@rm}lA2CS
zHg9e{cl{F|ns-hv0*lCd9(illz|ZHP2k<w3z@(LMxCq2V|GrCgeU~q+3J1#2m&(U|
zL)U-igMe5X&hd6Xi?mVll}sXBkWJ?G?RTzJAep|pBxHTA=F{yAB|nmW)eC$+`p*dA
zsP`*ygH%22DAbtm+B@EU@^t``DSaZ?&i*I-;S)E3b8e@uzivw+Qo8?AN~~`+WL4Kj
zWApkzk~|>xH#t_EfFa1;XmlNYK<toCE~nwY7{EJJJax22E4)CUQS!4w@*U*Ao+b|#
z$#X7G)s69yXIE=K)z{GaGizW0!|9H}s$b<BC0i4_k^jeoZ$(&L%BghAeS*6x!4L5t
z{q-D=x8{MRXl*_+1VAgLbR&@*T-+^jxV19!7zBg$x7b3cEDq3M)iEE?9K%3XYeCX7
z-M?g`@*bsro|ESL)xn;<V#kuYYRBR4off$OH{|#^g4osaG^asq4a`-h2kXnuvbPvX
z4~{y#SCi-Vp5J#ay{T`xi>JE(_SOt|piz~*xUZi#mfnoYMk4lIWnEXgU-34-ji7yF
zERuZ6{}CAA9ozlCHvY9I(vO63A6Nh$R5@NU;)F|E@X_Ct5b{2}UzYlV8W}<$4TEpa
zEB?)NrZFO}1X|$DLV%34Wgm9tOBrqv0N4S-J1^?@r9Xrmz9!d%eb@6PVEFzjP~Y_&
z-L>x)IS*tI3RH2m1k2RccYK2V#b1Bk5fjIlTvwaekN#H#vLJ{Le8Fk0`-kS}`Ox*B
zk})&+WJD={2|Xt2aIhM4m|SC2X2cWe*Sj&rL`*eZ2q!OYlO#_8AuS4`wK<&=)t)ie
zHPiw86TaIeyd-q^^^Z=vmYwI}B08_>8&zO2+-lIq5sAn}WJv#zE?z6}t=C)A$ITL<
z3d*G`99&0F7;V);&nJ9jD3=vMfukEslZy<VR{r<Tsm)*!1^ttD;LnD&&Cg-1Mj$m@
zt@mgJ-z-kjNL=gP1a#$Z?SCpEDjoczaE$5pPf3+a=Q_7qVKrE(4QN?X`I0Z-fv2{|
z$`>K_*_pB1vr$(@VnX|RUeqPrU*9L(AF~?RPXHw^8p$j9YjFb%fTpqVnRxrR<|2>q
z^2wnstFpgEd4Lu_e1XePIb6ZF1w|&67WX;KzD2eC_HF_iE&&YaUNmEDn!mWgP6AN#
zq2p_#8vhamSnO*&;PT_f4blH0_%eVB#nGDPzfBMkL<=$CGDGZ>z`qxRgLc1y-ylcJ
z<nQ@C1$5UBq!N_d`riwQpXLs-nzXt7I?G@4`-TQwPS87~x=qb+5ox;AxwXJN%cR?q
zN9FyP8n6I(JrojuEoLPUpz42#eQPWKPZK+DYAxlsg>jyuo6?!9R_#)d@c6j?{PD?=
zJKL?@^)92?`7TYVBB*?MA=f|Tx>_{<jDI`<J>Sn9=Bso<S)I)go9$i}o~h4yn}b*g
z5uXMz39(--NF*?ot233LVrS2p-kExq#4jltMe$O}PniauahnxMa63S`bPYo1JIx=6
z%qr|JYG1%q-VD)w0;@YmM9mbu7!JEd96Bm*DL}+q7iygM*M6*jp3B~$7kR!LBcbY|
zt^acN!@t@OkU_!^B0AD!1?2yn1>gifm@k-7XjB<Z56q#DR!?s{&n<rH_TbjC@1T8q
z=#6izZbiY4Jl3xJaq)YXYpLdmz~a{5lVC#n(9Y~!?KC~}v@xnwFFqrxMb*_xxnK7-
zb8p5Wh=IPVV9(@Zu~rOD<+`EjyIvZ&Y~2=@EJj3GyWMe}yk_)#e6d(y6bq4lt=pp<
zC{X!9_Qom1F$6x%y)YlyR~)RmW%Gtfy${I@#^FdY201ex9;4F#KAV~W)_bPrnlLt!
zc6~SF96vAfU($=z;=Z;@&jIXUt7`4#Vs6Z>Thg=x$r5S-I8eHF4pAxTvj>{G|L(H4
z3;lo&a2E{CEf}e^UG|ER|J%x~y=^$#uBRMZ&;I#ixOPs=h`J1{9slp}*Oo#U=|?la
zHel(&TE4iZw<!`Xa)Bda=MErFxT~eqv_Wj*XzSZ3uioF@falK;8e0?dHNRC6K>cw?
z=f`?&Z*RTGI-Z`s(UR@1x|wRZPxtdC&9iK0q1!J}w?i`JHq+Ne2S$fXLnfZwR+_1*
zXu}4hO;z|%?J7G?X8pWNbV2ri*MA3%g$A)SRwQE!31V9ghUQn62G+H1ss2lN5kzi<
z)KT2m!%1^A$b$RjfB6V9sS7w+rIk>7`iftc_BE6rxo=wzkz|p)S1h^Ajh`KvuT=Ic
zZ&Qt*!CMoZ8Mya~={WS{ZSm;s6?NcceJ*SQ+*yCTrFsLQm|Kz{(oX+eUf&ORVU@$?
z59@lBQRwZt;@-!}isG(ZlY;Si=KPx83;OGwf_Ijzi`XDD`K@p4X)6-zOL^<1DE?y5
zQpr?RLeYFsW9vC9l3M1oB-5OzC#1LOC8Jja&Wdt|qUW~`o>Sa1?|?N^|9I`d%RsPW
z(6}^lva0{uM{;nMUkkB498UAGP(FsuekZCB{q~~6Ma*yj%ZV$?g<pm%<4Ai;lD+w9
z0DJSfO&PfTzub8a`U+pC`SiR|MY<k6=eE`LR;A&vnyG1+orea?10l)#Rm)q9_XFZR
zjK+8;K{e%i(gXSDB0I3%%v;hZlgft#WL^lj0O-j8PzdF)S?pNCw@z@7NhKr{wmhO>
zLsk<wUvmA|?bqYPa{_7u&C~&8xT@;<emmv$7Z#i;?*nv|uiqg;*mx~tBBoA%Ir6>K
zUUU3&UU!?`G3OKI*B<^@!hd6vpiyG%$C%>wFofa>e+^KCus#!gd(ZDZ&kQdH8E;|d
zp5)^>r{Ptg`i=>}rZ9d*xE`z#sA{~5Dg+>3kO}+PC$0`eJV0Wf+f>;JKxo|!x*x4!
z9LM2yywicruAdk0lS7~>)i{C<p7#60BP$3<vHe_c20!fp&^dpIt{W%R`Dav`)odM5
zAw3qu#|98R!D8v3?}Mphpf<7<XIs^G)83IW61$JwxqHvI_wgjlM)h``{)md&Q_9jV
zT7#8F6iN(FARE~XRQblJM3LH!e_*ELTFtOkZ{Yf=%VW7sT9miC)6y*WC27eCMH~XF
zHw)+oYP<UTy*y#?IMxYAE%Tf?Q{*lnNcLJ``?G%{<an_{?k*KqmuJoPW7-fM07$Ts
z)+qnhE0w)+_=UWr{$Q=^QQ@RzwO_yI<-Y#Js~8Ky2;i$+PXI)dFq)$9g<UL{$ursT
zMUZU>n|4);I|YD<QaXm^ruz?^4W(S-=ht7JI+?F2cLpM@1DR#s`9RtxU^!E{Qz)pF
z`~AYgQyyoV`g@C=m=Z>pL=y1_Thjt=Tec~|KE=BA9w%XtGh1Xe=11NDp{c4se?;hc
zCK7`}EcnSIUrZVr5<Gh46c73)qspJrAl<VcW9egGNC=Vou|0O)?zG@3O6*3@65_NM
z?X`;^=YAWMgI6qsf@nbuYfb?2u?fg*le5*I@2MA@7m>O?TcJ!}Z@7ycf>>Cz>2$SG
z(vQV6>t-AK@Ri(M9F4C!u=Sx#MSN|57j(1eze_U65eh#eevmWbtmLi=k>w)dOilYM
za;8J{#n!Ry<%R=niP}>jCpC*xfRXMOE`WqM|A2U#I;4+(J(t67W#HE#Vi-_Xma71`
zloU0Y+;NI?qxNW~NHCdOPy)cry^Q6xHel(mE1&f^g8|jX0PazBLvQ!T%a}`M7eKiT
zGc(CSbG2so5e}~Nu#&VNu&gI8pTIs4C`=S1L*Z<5qQvBQqThp1Dun2JR_6MsmK7#M
z$4TF5vvf>O%+DPcw-WA8+NKTvP8+g&vYZlDuo}z`kOdCl)_^Q;ku?95fhV9k#P9|x
z04_pUy~RaII8MNfngKW@1)k7z?iw!CdrfPxCI=%09^5V^eFEDxM7YQ6x>r@+UZO-w
zbuVnnP$-<JJp9AuX7GI5L{Z4`{V|Af&oas0A`$Y;I2qzI(j_<S+#`4Y^&QTYa-tBK
z{6#%=L%4|u=S5G!{CFU1%On6+B#Sh%+x)>@rx-|UTTpk>YxNkc4RERjzFAZg2^yuu
z>lpwVLQgF_i0M0gkJKDYY{S2C_BAv4o$XjGUH~<N<BvC)JFV;<obT$7mkcfy0Wrn|
z6eM!sme?O-Fih<I^<`#T<<lN<v12N+$3I?Yzy@U*B_p^UHpX8>i`D2kHBdM&M(hCj
z`+`MG@$k7;eIYgHM<c{0i8xQxd><G%#awP*U9#tv^zkbp{Is5z6<AKRO)n1yiy!*M
z(rUEFo8`yNe(PKwM&1VCb_aQb&L2K5j2nhwrkoCE67oKV+d1W;x-0naEV}L3P>=2%
z4v1s>T|+qT2+7KLERfEkx^7jP^ti;%5-O6;h<^xsE^Q7}c0zs3j;0;^t*XY8f&A5-
z+W#p(CP*^?>hwMm7)kx=@}e227UI?Y`phmFrt<mQPT;qc%U_vFsn7jA7|=KYi4M4@
z!zM8b6rg^HeB|JHXGAK`Ui(OrlqiT)W?a+<RP&N3?Oi*WtpXKN5q%rq<pSju>NUDd
zz7^H;9H1~xGm*U2QgS#SPNQ!*D>21mLH8bwZqhUTtB;KUAJ*;wmB=UPoi^V)m)UD}
z#Ev(uJW0iwou4ie?^mE&(79P#CtNF9AZ+_f(PnWWF0_YX1BxjnBj8;&PFuhV74bb)
zS>TJM2IM(vI?nW#;va$ly~cw<Az0xZ5L~I`6#GFf;QcO<MNuo^dw<koA;?TwJB2ID
z7HJsid>B|lLe3Vm9}n)^gW0^JYEjbr7!H8Ob`fW?zbV!jWG1_qD)>ays3tP&@Q<!_
zk*2-%MW?~#lptP@;*KuGVFwCZfYNSV#Q)gn8jxy;S*XcT<Mvf3c)@Lr=FL4_^}h^O
z5Q0G<i%0$0^!B_~54)yC=}6OVJ0;~~03Q3!Cm0h4Y&XE!Mdk0*GdT-@0q-Y&fCRR_
z?_6uYWOnwxA8fML!_^<MpFda!<_a+B<WdLaR!V(9ud&Rn^iv}2C!zS<hEdeW7s*14
zhTQ~4L+&xbr^}$-{}Fo>6#`ZeBk1<iI8AKtW~*j7-wpE&v0voY;q;x1*0SvEZnZ?u
z_j%e7quHnePH+7avWg_(G-v_Dbd+R&hASn{R%ryCBLa-B2tv_)jt2``26Pi5J)gl(
zKFGOUoy~^r$B;~7iv<|r`x1Up-tDoa!MB!)Hp-~<55U;|0hl+^V5&o~EQ{$>EPSM?
z*<YF!jZK1%q5<9<5Yt3IaZgbl-POnwwG%+xy4?95Cp>x$eFHE)=hXh{dqVIJ!|RbL
z=SChSt%p!xngDxKi3I=gSiSk_cL1=U6tzfngApob6G%2tbW|i6Z?qhMjkP(;Ifp4S
zy}S&pp!pQ$7g>~7_Jhe75vuP;(8Xi16Ys1Bpx|faCa%f=WwL^1Dmxzn;7mCZ0odke
zzd+g6XT_m_iOy{-+G7Vp1Md?uGSqMoCqF1AWx%F*u!ZC2YiNL~ykuul+{y4&rd7J@
z0zh(x#ZgRn+4t;Bahl{40^wF60X`J@j^@8k=kS9&O?Pzx>r3?P2oUbfkEk@d+Aa5J
zKyb+>&=PsXWA}ykJbhN9b0>f^v<d5fa`X{t3{b3OwF*54*~XuefJV}OqWvtHv}aWZ
zOC+l+Xu%3nO(B#3EXq1x!=>OHr_nD^4B;m-1TlQ4>rnuPl+k@UIO;vfhrsaO!gy*#
zv}q$tQmNPl{Qz=8EWX8X)7BpwT*zvo!vHTJu>Knduf-yygSPuFj%F#h05j?}#_UHF
zt(M?HA9n!e?9rm>lyW8%?)nJIpLUpJC3Bpz_TH&8Rb{K#k>ebDz{&v4Gd~4B(`9gH
zv2;|E*`m0?(9kECPuppE@K>TuqaOnOM)BAEmoQeZnnqHf-_WZWa?80rkn(btr^}=A
zg$;g^g||X<L*h_zh@vpylImpp>2-j@VGl=r>-_8*JG(Gn|B;cI^6Supm%W63a|T!>
z)S)91O2FIp8zaYJ1I+Z1#~yaG;EAKlV(Wsw1mx&3ufUm52j>60FZC`Cm3}MG3SbZ|
zO!$lb98<r+r{1aln1$G90f1mU1>lB4CJzP0b5)`UpD-Zp0*(eoPbRPzp^RF3@n_tC
zpG)*&`~x49#YMr?RnU=$CX9~6DVu}~38H~1YZQU~pawuQFHDsJnSj=Gr|b@|V*m@*
zGS-{aY!CP)ZG6z&PCxjnA=VgBHYC+$-?{>LMoR?X_S9QKi9#1X3a9zrdJPif+Mp(q
zx%A?}$VidB2lz08g&);@jwbviLri*N8@q}6jxs1OfX~=`un2!940q<4f{8zPNkttT
zNL8cUTiQ<PDag?2w4PUP5aE3nrLC~#+Jk(*h1h66>wbicWZd<l<5WAa{`^$a=~AY_
zdq<&-FLH|3xpDC9q<y`hUWkFQ@ogX{cBqR=cVaAieO3x{1v;)Oi~#AiHJTk2qHRg|
z2Z*r(D8r;5bz!*&&B}Af<9IIP1SH^-=DD1&FH)928*Vw>JYe~x`Jr|UhPE)p!MaFn
zZZ_apdsk73FbdFTrivvAIEL<*y!iQHPVNmHhaNbY2@9far-V;q4jkWqq9J_Th)u%6
z<OZyw&D^7tw5_H9fd8v;cI)pEeqQ+04jkLn=8Nz2_5-=gO4^M(KEj<pShk9zBtZir
zWNcHX1i}4dO?$u^xsiV5Y-suV&Hk-bOJfM)A|5}Pb<uJUqRJKy008Lfy><I2%7BkM
z8=j}XR(ENONs8IjUv@t3Ix5N10T%v2<v$BYK(y+KBcO<V$S25S>*8d8n9H$R%Lku6
zngtD&3|H(IlbRPN%iCeq^0VXIv(tEprzP)a?{bKxbwmpGx8KHzR(7IS5V}rLzlI=n
zJPTZ=cg~UV_0B}M_KgCu&14upGkCx4wk%K+Qg*VG5CB97<=z3yrDHmvYlEDK9bG1H
z@oOl95w%~5o;K%NYM`2hL}@KTG9xpwGCAKUn=Zh-xyybLJ3h|pMi7Ng_O5OmsUVmE
zCc7_v+0ZiqziZq%J;m3a2bqbuTpWF!_ZW(_9jCeTXG?)Tjm)Pcg2fa>VpyZHpCVws
zRoqdfMUA0^a1fw706!7X9Xf#`Re_mFuwC;`Nv^1U>+j%(jDvxXj!jRk6j2qQrI57s
zCq+7cyJRek=U;2+X)cut)6vhEac_=xkHKoLK2mn#M((|-Sq!7z5!;UC@+-e*$f>g=
z^ttj`6cU8yt|F!mTZjjP&s#cTr;ZQby&0LQLCDJxPNBnbL*{oOKnRFDT4Uh-s^&G(
z3}ubT(>&{_&^U_SAAp9k_}<(m$kvC$P9BFRyQ^b~nhT)5+W1tQ!zc}c{et2$qj<#V
zHNYoHjx#}4C00!sJb(lE&Yf)OBQ+iT{lUt2S~9ntMov~YLqrbCasR6a73fVj9KS1u
z1az{5+>2DykbfJL{w`lkUF-9X)^;!E*i$mf%l$1a_yqA#^I7FUV>E@H-eVWubhY}O
z)mPD=gu~5(71IYI<=6R&LL$^~bc$Wyjz;wrBGJ8*eovwBPd=qzfL0H$`>OesOYuY=
zGV>t-vV;m9ziXi12n$aGwR?LrH}l{c#Qo7I!}IFWdUxU4ih3&p9a9o$6kq5DWQIiz
z&>o)B)21QM2Oi|gXosnxZL4h0)DAIx50*g05Ht;x3K>2~TmZc68n5<u9HNBm&nP&{
z7%SVImy;lr-RrGF8e<@AY6@mw2E=#!y(!FRjn#g<hO=+LE<ijHYTH#dVNCk?E80sK
zfw{jX9<*g>25=pUR2A5u?gt}xbt_EqF!6kT(VhV<Q^d3BmMl%uZUw3dNM%zt-7li4
z`oIw3b-hmnlaN*oylMcA?-=utwsesw#9*_q8H<xvNxrMJ++wz`WpsO%i1hMc)R%(~
zMBa1u?VbsS|Ev8HRcN->%H(IWmC-jr8~*(D{zJul+E&Ioh07(*It#^0eMdGl@57rg
zT@NtNuyv@-Bb=*UjNk#kGjhXhcWP98cX77-kDI{SX1PUD=i;Bj&wX0mH9p1I?K<UN
zH+)pEUT_f70d8{%5Ud^RAI?r%)ssIFzK)17Bp2OBM`$F#1q8_y{HIgpI3|hmxb))1
zizFC>*G3bw2|+rHf*kBQwTvU@6eF}B*Wbe3xaTfgqexeiI@`#}tM-tIhGAEe^Eg=D
zV20>IPC`j;r_mW#N5<(@rDJgaIOXcRRn2bOpv$XOK`CPm0yMluC^*+wm!=GWw1|JN
z5dPpuMTe7GY5+(etCE>dFeN@MH4!c1dTz<HM2xtpv61Xxtz)1A>U{>Dx%6~LVx*LD
zc9g~Y{@9g{EV(Y1x3Be(d=<DfUm*sI!>-%YIG+hT9nNzzj+&)kj41R1<e_r!p8d|&
zFP3K)<pp6_o+-ytv3%QaKa6Yg<EbSatWrMS9Afvshoxilbs*C=rqJl{NlFR^4^r2|
z`t_f2Tuu8EZUrdCuok5f<7i*C<qe)nj{+fhLnCurrS`jg{^KTfWHg!7d^D<emOxa0
zFWn2BmWXJ0$@WyhDIB$2{_E)O=^U~lCR>fcuTG|k>t>i0oCFSiu|(2VkKLWz>a8lJ
z4r&`Pv|n&vLDrnJ9i-o)TiL$yCBgC?A`a(UYYJMf2wNbM;~tL|bvcwz50$2H{`8GC
zJ($k~m2S-sOd~*@oMq&D?*kGNd|15}sJ=e3rlV5jIP6S)sKc`s6xeFZ<8gjWv?*Q>
zNt4A5*OZNpSj(N0qa)laibjU082myil2ouVjKq970x1WQp7%5GTjmWyTn0GXr}I@9
zQs=UJURl=$>s9Ubj%7H4ilWRn%_&B=?xILWe6uO1xC0;l__WiKBTUhiXNvD652njd
z!(gn#6;ezKuyO!951sjh)vEDk&R4^e-ziZRe#D+Q18>87EOGs<ZrN=Z-py62s0^nf
zxdke{;5Rq<qw8D;O72TBbR@L>7<DUVKX5T+3!yuTpebsJO>?zm7A4%bvuxZTm?&Fj
zFs#OU<2p|7!<642J{CN9&lgam7Tga*8epVXDEj)Etc8*~F0gEmABJ(7_vR^k3t@8e
zTP*(j4|5jz7LJ3v0e7V{lU=28`kUr%O#t)e#{(PyCYVBW^$x+ThY+BNF=ULNIn%JB
z$vT+pfpU&QDj^aCvJK?GSitN$t08Y*N+riHSm!C%MbDmb?7y0R^hS)=wkKF$j*uj_
z33XS7oZsnl;q>6$<`){rdh!<L(IY$YJz7#u^S(W2emFW6lY`y<?D-szj5*9#g{F0G
zg8CoP2=l(qioO^h^uu3M_>MCd)ZqGkH_gc-tc3=$N}zd)7Z=tq5#cbh_$YKxtvh{g
z4c~u-L+2E@a}M4M$jo{n78F3~!F$*m+w9jt{pw7|b#vtPniCQM1<So2G(U3%1sbo%
zK!@0hN(T0GAuDFj{8hd)nr{(>qBXCbabnBhINMZdF`xR|Nn;hcQf4i!h16gKpJpkL
zAi8TRYTDdv2<=VQ=POKcJ~_BiKRgNmlIUkbYXYz-XXse!Tzi;vqaNiwO@@IU$HoWc
z8Ya852uAkSGX>=(yEjEJW1wlh`Z~>=m&twB><q759cmJo5G>&4VjrI~*HNS2hNQ2r
zp)I7ZxU65CB(sU(ViSEc7<U{%PjjTLUnNYeOSmb8i;#j-7kZ(rVhF^q8KU^_E`0K4
zYyme)s_V#Oib@}o`vg4~SW>610jqpUGkMo`x?Vsji4DT!S<)7(!FeOGhlPZl9#%&?
zlhGDZX&RU(P3iuK10}?rs%1xrQ}}(QvQs-)Jn^pkax@Xm9?<v}cJ@U_L9{V40M9#I
z=9F@S^t+~6a-OmxvKmcMc-W>WOo`hA7GgTrmbWNooRAJEGX&16Rp~bDL`ssd_dzvw
z(7M2oy>RqLtQ`S7zJ6QRd5j{BPRZW7*g)C1MT0NoFztOc%k%r)($H~7!!~55yoH9x
zPB4;c4r|V|y5R)Fo%l^+3wS}ibcB1%*xMs;$H#@5%0N!^Ha=?{czUAnQ8a4)o{Kfh
zp+=s?_?Ic*v}sN`hx6U`a^5`i6Oa9ZH(Cb8Ly}PrevAhN!)+(UQOQGW-*9;D)GZU?
z#Z;md&Zf6%YL**)omKQ$jT_8Yf4TlmWfW`jfD&9~WTDx4dC~XDJb$cWr!8?pf70V_
zi7yeeKf%NADxFfj@i><pmgW`Q%x|AJKi-;VC##+>EYygu{Eh7KK9odgj4H-28+CK`
zg&2ey5eO=}<03)ai`!1QoNcBUD@|}iWr&w_dD<%+OQay_s8;yykG3Yyt<P!N>Tt4$
zgI)RD=}u!%m643-t+XQ+N*y%%glEgmH!pZf>%)pY_BV*Rm@N;3IwNP~?zR%}%=LbD
zvBOR(mURy9{t-OqgH0|!YQqaOQZZL)K~!P83kJXLG`3)SQ$8SvLaWX@cDx22nAp9g
z^qApg$l$D)u+EFj|9GKy?gS19(bPMi8w0XG73>}z3LlML(6@O^lnv6!)-AU1EK5S-
z_WX_4^*>gB!=X27g|~-LO92gVu0~muK3=h}q--lHte@3{QKi%NBO~<F(6YUM)g}78
z5$hh&a&zn3Tu}w7*3ZI^<>`E~7Mg%2@#+=~3G0Q8`XzL>`4r-!uIdF@DIeGR&-q7^
z4=Os6TTsd2gl^c!Y}VfM)eV7^%RP=kBdgu@@<Fnf5!;Z>yN0|rMN9XZ{NiWt!U;Aa
zzjM}Qf()Ubz8FztFC@Ft2=W=4zJa7rR6vjWcDTjLnZ`0Bb=~-<IGta_Mvhp=<%XK%
zRy`XR>=qf1osQ~VuHumI*tJ`dY?i6A?yzC@%P1abqSxd#7$4_!`&}^o;oneUy@1$V
zJ@=XKVEE<aQYyu(A^;OX(4w>M1H!)N`8DIIN%EuA+y?Ef33Z}I$x%}Nxt4L7GBDXs
zset5MPK8T4E=;z4qeRH+i#XTOkJeiX{&YE5<jdXc^@5j5SP^ey>F(;xtf<ratJhP1
z7W-){!H6f-EiJLK7#YO)+3II36eH;KGpPV_YCE-Pk1HT)&+@8WHYHQKVkpjp-hT8;
z)^OT#qGbi#zd{K4=gth3&(4}Qkik$2v=$7xAP177oT2=65f@`*jgs2=74z?4Ku{J<
z1k(X3p`Ju>uPCw!8vQzGBJpgG+l=S41|8A92W1(*$GHUmI={zEjF_zMd>EA4TkiQI
z`Ost-Qz;BJGYLM0+gyF19z8V=>KD{xk~(bY9-ZLL9nCOV8SXeK+SM@BK_62jp+uF2
zvT6+<S2vG^pmE9xFuCqo0s=olYS^rz;RFu}i?ngGX()!Ti>qRGvuaFmsg{9sf2+Rt
zV7&nXcE}M;(`M-@ed-+3cv&f1g}+fzxm|vojBGo3gk-$Zs4$hd!i*+U#ZE&ZE`K_0
z5aMCjvUe~FT+glXgEbVooC}Jc8Uis_>`36a9A5|BRk_v?k>3N55%$G!9Ul|hU3V>K
z4h4qgz7(CZbMBx__ia4^+Yu!*sDJJe9F7c1$Ym5Yp)l?Q%R6Otc`7?qfh%0MYmX4w
z4s04*D{WZ}KFc1&m;2#BKP5=U(yV<L3pI~IeU2ohbG{U&vU!re1EYS&Ub*;zca_I4
z$Og+z@tCcV9Q&0``vT`;b&JG|T+x=BFmU)m*~$bNP}_R&3*X-tx0td_cC(#xC;7U6
zlRnIp``$_aO!uMv?z&+U@`6;%%*^Bc7fB^cr%!=A!Q*}9>5qOibxH1FkGmdXTh4mw
z5e<}9%~d}EJ!t7ZfJQ&2(8@H~hV{G?Z|=Cf(yA!7qY?TCM59-PcYm9->;R4U#duds
zcM1N7u1E|&HEny9#GVc~SOPT^Pf?K5zu@!B*FkeGTv{pK-_kzuz4E=+Oe#?Ufjc_U
z?Bs^8CBYtx%@;1#HV*mmrVY6QHJNr84-!d|;o*B~Au!6DVH8CS3i46MhMjzOAf*>d
z!J<Q}tbU)Jl2JiADO7L*d%vwNzh<v1R-66*VedcV;d<Nl4>SeQ8N}$lCTeuidk`fO
zC0cZ%_f9Zc^j<@v1QA^rf-rgyNt6&~bkRod?91<d?t4Ga|Fhrh_xJ03WM<a7)^(lh
zJdfjh>@a@N;9BZ!dc~gWBDeXI-3(ErrNBm)^3$NCQ!|R1j!OY*RVEPpB#No|=#Te&
zrYA(We*hDzZcBgEnUInw(y%HN>@!I0-2cfJ{z^k#bRp5_HNG(R{g#j}E8f^I4M+r@
zFDe|`(@mP97vs*XKvwC)TZV@!gt;Ix9&vqAIcGo)cH-I5|BkNK!T->WygLv2&DcD0
zV%S!!Ea{82L`U5Lf^CDtUknVUN%Ml4B=|ht%KEa(D`~x`Md9XmV#k%}rDdxFGbMMj
zeG#90JD)XW)HNA>-uE1wAzd^KdlcezvX>QQ;<Q{Jo$&7#*H2=gR_f>}^(2Ct>B0I?
zabnjO`)YaA;`KM<Em7cXQe%A14I~eZGF>c;;e4-H-Ng4iY$1dJJ+qV&Tt4B%dQlOb
zMA8zt346Xzxu4=CWS%ec22*xY+9{d8-?dzZ{<1=FymOPg#jjwr_nu({+jGdji$l|z
zPXGIp>vhdwDonZ=^c-kO(CFkpYQ!$AjCwD5JS*__ZbM<-W|$Das1u2?k5;_cN+uRv
zDp>eZX3FQ^PfIR|?Vo5NljLn#?A2X%JA3X%t;uLH@DUq+Zi|0azI0#p+~IGHkqcu~
z0)QN>F@Dk&j_!XBZBP{DhZ2sGFurM7aYrbL>HSp|i`^kHrwGZDv$V5E@Ma}s;A_&E
zefsP`<lp9AZIh2L!&1f8uc9L4e|b2Wv2q8Itu-i5D8{l?*{?h?^Luso9)j9^l}JJh
z*#j}enwa@SvpKcIQ|=^lg2K!~p6#DZE_fAXOLM3-$m)Oix2#cS3(V*5JER;jz}v1b
zca)uR?%X1xkc-mbnk&4aP-trrCr=u6gez|VaK&qNr#C*bmWh|d9WOW+sc9|6uQ(~O
zIAwnnc>7*(-#3b)6Gy@z=CJ&+Cz=~xW4`Rq3AFngJnGjo7g<pPFnafb<Xi7aNBxIb
z5mQG8KQt4b@cKxC$(3k+Ocxymt#2&{oewf(jP(Be#fdb07HlzNUn8KHix+6&+SdUC
zB+s9?)co20x<ePPu=hEzWd@V(0S-@#9JW;EqE)AVST7dQ44wbxnC+beOs}~<>g7<p
z4>5`Tcpa*Ws92jc7N&kt5!hq7bm5Mv6)>*g3V-*}(N{s@>ZDgXUXHvc%4=ndQ9Z@Q
zS_*a3V_Iu1z|Z5JxH9KsaO^y%a2)x~N<;6e@wHkC`@<(+&83Tqhu5R#y@nDVHep2c
zf6RN~y1HQ^hU?w;DA_@k9NvF4I^G#9qW1m6zvTy7{y;E*IaAb%%_II18><T^k4U^3
z8*4=}5E#y5rw_6p!ihCl-l@2UqWAcAqGJR4sgru&u7-Az4lysnVNro#ycT8h;o=Bf
z>HuE|IZzU~^)oB><~JEo<TLw~(r+n<Qp&C5x{pM!$`-)Dh_C!-4O`4SQSeD;=0(_^
zPiUzPE-$k`>ZT7*!PdXplAs(5108EApF5{&?g{#Xp?oTtX3L-{t-yD=X(Rn`n7X`v
z=fI>1DQ8P8r4mI)C*wo9(0^y#2SqL%%SW5g>(-HW{rR^$LbU8LU58~oWWPU|Vl}Yk
z?akoxBIx7RUV;zXu4?fPy@@=`VK0*@5BRUXrAn2|`FuwsbRYe`1O$T@2k&>q=1JQG
zE`+l!6fq{3xW1w?rv*A=)$402C*J;Pj&#cE{lv*!gl?HM;dK0neDDGNKN6VtD?kp3
zEBwTt#7Iy$W}H!l*py-+Qqg`FH%atXNa&l6QtJKWfyoF4%G-Ay47<zOGOA<YQxFfn
zI7{$V*nB*Eyx;@#DMs@Q)IWDAel!ngJ{FO*yGnk}D-JcL$z0!0mC(p026cSidvk;%
zVUBB=%qpc1-J8)3Me!Fm{l`YlJVNnhj|0dPiiLQWhS#+F_LWU+UMo6ltOjVbOY!sL
zn~Q0gXSnyf`|gX=DzFROvg2JDWo!`juH|0{bg&af^bpQuhvH56-j2A3+wp>XDTynB
zg-o{30{g-5RIz}7UP!r5#j`aI6Ui?3tFP%*)Fv{&*THBz-g)tqRUvu#R<=bN#-x1C
z4zZu5<8-RAz%GbhMV6aw<{C_k8>vMu>Y1<(>P{W_vEx>L>^u7(z0!NHn+w;V2rk_7
zwD01NCN9C)jSB})yb(qoPb2oo`oLb*1+|Rgt*}>ArrVM8h3nFBn?S`Uqi*3tWZoVx
zr6F6vaSy{^_|*g~kW-4eI|`yyOi?cU7})!h=oS9RxYPw7d14k=HKP;`<KjO31@fM&
z29Z0U2>5Ja2dkTiwwMj!F&*H`cM(@kWv;>;Ri2EvW|hDgHP(kx7>OT3jdJgq$2Qpw
z*MLFHy_i6@1geFQ#AhU0&+YS9XdXK1@W8R}D>$&5Wj8zwW_eDcNxHwnH<HxF-jac@
z-DOnQCDEE6Toe?=&0|8r1!=QfTzVYw%0i2Qay9)rulV=}^M1=o5S#Xp1P@6J($_wo
z5#A6isz#Uci+!4#+L1PWketuyH6gTLc-!~*9ePfg-kOr&ad@4cDX$@iZ`-lJR{6#5
zrNa!K2{kPbl?YqV&t=kgh}+XNl_`-|ywB@eVypf=s?-m-dF-bfMLHBcA)MH3Ew=)0
zqd$E&P_!M}bx?IlO1$MvjIcC|^VRgQ&ALu;FvEbpv&6W?geQN2a<ph8VT#1S_NmLn
zQw)59GeX0FxC;r!W?OM(^jNDGn16fRU(h$pfT8wifbo5DMm(S7-^9_knGH`9yshj#
zja@o0ixZm^fx6LkKf#9t(%7GpaqVE1mw{KwI8DPDFKhnxbp(<bU%)q;*vOKUWh)3G
z-=1WUsMW3-T3&qaREA`->tWQq5@|^d$71{HvqjMPF)-c9jekKtKS<QD)BcKSCiU`H
z_C_Raw#tr_l-fv0B;F21PiTLn6(uf_VUS9|R`7ogc=DSA{>U~VG$x+M-j?y1ihDdn
zBT6sIvjn~L>Sx6>6~_HAY>0Yji~^-c5rljAi!liHh;Ue5CF71o7V!8~t1NV!GL&YP
zbko#;vR&HRRza(F1(d0qH;pvVEVHL}sFoE4UC=_kC@twOjtCh>41Rhx10J}(9-gN0
z%fg4`T;~aBk@y&80(-oU@M^@})LQ0+5GEKYPg-(z>N~d--a$+NsqILS(0jU#TqLl4
zTr0}tk+Mt6RHh_Er1x7`(k-Bi7g3drWXe*`7RVTQ?%ze-bDV<yu`-oQv>Hy|b`bza
zZHcJm(AOan(Z%;8BP+8eKV^d-;P*;ZSecj9C?SCBr|#AqGtC#o_iF$22$O${Gv6Qm
z^H4tVCo_6Z=_*Hphp56HL#%C%+bN#BiUTK|p^qcDM(cx5BHq}%j{^VYf)7iiD6mH_
zWUECz1ZVFOe+HgeRAyI9n%ty5ekP%~`*&j7q6(Whc72BDYnv$&7MA4ZSuOlDk)v6U
zQvtCQ>fw|AE72h$j&cE`BW;4*Le>HU>j`7^1R<w_K9V1iqYS4jAd&a@t^|9CD2)1&
z4*WkUpTjKu)FaxhOpJBF)Zl12p`P<DR<6Z>UsR$J#r_|CvZEl~gkTLS`nJcfgM?M%
zYcxhpP#0g6U{}V?x&#j$%8-82q-7b_?rlNWJyU$l`=8Bb4ylRTvWG8UwkrQ{|7L#s
z`ajp?DbT^=E;v<%#=It#Qjx=X)?LEaBoW_(F$wzc(6-~&owNx#gnbxA*~)tVPGij~
zc+Vl$8hY||;qAkPN(gl5n>cu3wOA2TAng|*e%!zICWVfU7ccK&9`iG7?XFJQDHgMI
zU-?W%;S^}>sj+2Wr$1J?oBU=qQV@qP87+(EtHQU|x5wi-8lHVLA<3LW&$<1hMQpr+
zSqiD85Ky0vEV%M1Qt?Y_DQ>xEb5h?msMut=n&<Ci#KRC+g7c8IOzDdPP1z<wB6%pt
zZDJxnU~{gWsjok%W#FY*!qCRg;<p(aQ8siqM4Evj)d?fh-fOc$6GSt5S)GT7SUY~!
zi>;LTw~+>qW{%qidFbO!?b5yr;7$L>R8%Sn%m$&3<9VRVt1Q8gPOKf3&?3YJM>~u~
zciV?SZ_9Q{5!0o$uzQ>sSPFZ7T37jT%B@+e1!mw<HI?M3&@_yv;(AAFpZqb%J!SY%
zicIAU`McRodcMp;5*x|8cVE$wyEi5)V<*tsb?AtnJdZy>MNxE7_8|IbBHg*F@K$Bv
zZ0^hYP+a+?YAs&(rDwLL;A+K3MkZJ=8llmQDk+VTO}az*g-*XRdq|y@zD<xBS(3nn
zD7k)!kqktOB(qSbIe-cJ*w^d^cCIwXl&B)(GLbm}e6yjez6S<Rx^`(h>arC0=gr#k
z?E)KASGBI@{0;oC=hZYLbLO+2pV{g+ZlfmcoidC4cF4tr7FNaG4`NX1jqH|lpM1@h
zi<={_2Pej<#=bh+(Vw!{)j9G|iU?n<4^OJjRe1Uz5h_=Sa>agT8s9rd|3}U1s0k+9
ziN5|&BM%=4)(y@|H7^HN#NW}qy1bvIZ~AuAA2vB=R?J0fE?&3T6Bn~zr1B&oiQ}#&
z{sOb}=Wd0UN1&A?)b=!rc?OyG#JzRxx!yp7$m^e_nOt{ocdiaun9q@oDqDXD;Ve@U
zpEEXigxBJcOK*S$N#Kk-!C}uO&dg6!(0&ls3-hZ>bpM^M0AZPXbwz?m@!O{?c%zv0
zL?o|vKFR2=tFov?Eod5*Qm>zvJsjm%z}T<Q$9>-tw4R&o=kT;6oR8I>ZL6~zo0%(l
zhk1Xaj~qt_Usj=yA%-NyA#5^$zH}7yj9+{jT^lR3pkQaL+sxl#HjBY0L0+nd-NDD;
z^Ff2reb)}{ymY)`4%3}|x-p+SFRnlXTw7Ae@%4#Yx~I$Ud;1$5EB=HuWIC-x0~1r9
zSeidtZnzj9u56$V#p*gM@1_$_AFtCl+ju?@S&9CW=KBSkJ%DZB&CIxN6P8b3FL$!1
z+9_YP>0kMuQaR_JQaPOP<=^)EvoFfY*d_RQc^c;YHZsX+cr`5|7-T4nJjN6W<nYQ2
zi;E~XSHqzuQ3e;pIv%h25zFW!V#0{y$Pq547|#!DLre;2K86CqQ81*fZq^q)cLtz2
z)VLaN9Amui4klg6u*kf`HmPeDqJ6o?mv84U5I#AhAxu#t0<?QA{6u)#iYkV4Ywe4a
z%xY$=X3EX3D-n$7ak0v_v%mbevFW7ZBd6p9llhpVxx1K|A`i}eKh$wxLJtvxVbu!H
zOTHr*rzIpYc(=NJzx;fu<KpU|KxU#Y5gW}}fOlK-F$0M&JrT$HHN?>FiosJhx5mrh
zMoC*sVg7dYZLJRjP8mx;l9qPcjL#KNmR)x>ES!g-I4!7?E9-xP@KyIQ&<+VVX!d&6
z$Ufuzeb3-ojG5W=rik_vkK!#V|6JPci6V}Mym$PPPCY>rTfZK&4SxUni$ZMve+1}1
zv2G4!uhM%Rn0H|JP;Nfd$!|Wf!8yVb<pLN|pHa>!dmyu3(S9cT*nJ*FDWPdM%sV$o
zJwrm+)BMr{F&M`uT6>R#T+b<2dcT+>M<kgSDO6}-;sjJ|4rI3dhTW?)cL`5D(5G%b
zO?~4kFMZ>)Fyw-A_Ew{)5Wk7DuzOp$Uw3rZpk0#SVM|P9?}+Jt=A%1R&Ad+Cxq|0@
zhsInkrXf=L#a*9Jd|XUc3ERP15PBy)|Fq45OC#<cX-K|E7g<4!=Z_Pf<(X(VhlDka
zEE-O=$Hih^X>Gixmm)_2O2VZsLv;z^B{mv(`;Ts?<BxgTrZ>}SPA0!gw`FPPbCkSJ
z+8e_8y7ev^rMYNIz&o0q??o3pe<S+1M`*&oDPpVGYDiFXstP7HGRBbi35Y<~xt7zr
zzG_@!oE{_FdTN$;rxfF6eqNj}UT^CSPqQDtx=JqgclY}<-n)0{s<GboXIu(5EZ+d-
z6LjkCurBuH=m_lD3U)(B+o(IYrOD;c8sh6kd;o@~65cGdf>NDAi+-<B^w_mhl}<bm
zOTgx)Kp8L;#drHbtkPl~LRj`*Y3QE0eGJqkHF7uy>dfwgRXhLqnB!;|70@4b)jV^<
zZ0I<TIA;GQrSEG1BX=)Gd+oN=__-&&pNrx~5JJS3C&)u%ESMB_gOWK|cNty#fbJQ(
z@jE$Yynxs!m-$0rJ<gmKhHewuJm<jQqE+aT=63xLjku9RIgg}W;<50On9Jhkx++Vb
zM-Vd@-?&D-9>m{jA{KoJ&BLu4$@(SZ!JQLbWKnmjYiMJDdG4`Il48fz@pNM`%=PP{
zQpk6Nd{0ni9v=@FCT{U9FY+liY`sg9^g*klkjuKy9PZn34Bm7=OU>@gR#}hck(&6}
zJ#VO7%R$BMk}gU*ppjOH-}V)dbn1Es^4rOZ8f3&Ko56p7+L?{aHVw0NNY-iYm`t}e
z+HeVod^Od~6y*#!FdI}bym}LOelSuH?3ecUk>l?JKB4o)w${x@ck84UpPdd<2Wm)`
z5*_}1_s(>_EfDl=>b0l?6VK`$J>Zyx``Qzu`H~h_?T)9B`I!>y6>NsiWpsb!OFmn)
z!nr&_;M?wC!cA+YH+5}2Q2dm|PR0HG_<0)L`jXTMG7R;T>r~;<3N54RC(0}|vCwD#
z@X1@dJ>hqRjj$t#=;<;SyMHVBz_V*_Bp-ZL0ItHpW0Jc<ubqCX2?|=xZewHzBdZ^-
zNT&t=qx~QxW|`$b)BPBAySeFzQ<+?LTJ*<QVo?QrMyLLBxmM5~Eb3Qohp0|XE%f=^
zhVWTF>JnXrFe|}s@Sjg<rGiFYYF|X9fZ4gPwk4DBK9;=PQ!~}a7O=mlWx0Amwm19d
zDx+DQJ+8zt6dTqxQy#whroY=*6R^D>$ui~P>|0p!Mzds+Q1!iZwKQjWXzeRGm=NwA
zQ^X4MCczpItNZp-!>5@7`&HZ{IX#G5g;`Xwa{yPfR9}2Xqg68(rBvGR*6(`fZ`Ci;
z2U-nRb`jP#g&EG@q}f|C!wIAWJ>8CuosRs140pxM%k|hAjz(7;85>l@s{T14fCK40
z{o%yS4s7t+&5_*cI-pECt;wlYYU09wiaf`eMyhF$(9DIc1?|TjE4jZ3R8+xpR3<@I
z>UA;4AnkOsWwF6*@?B$sm5Kjl96Dy7X8`N{>L{<%QM?=V_P3omvl+*Rs5{AxRbNpn
zF001J5$jnpqGvIYFbH+!%x6ww3sZl|i^U$pPEt)NQsH@zLiBp87v3N~P2%J61^-XT
z2Yqc57<wIl$sWXimpzE3mzH{aOZ;G{NzMTsU>3{EVIHAPC_aPtH9uU;%YBd`yYHxv
z9zT;;xz(48$kTpX>JJYFOk|!_fpjZ=GO36Q@0_-Mup22eprQij47>fSB}?(Q*@C}2
z;>oD={k$9@$)RDVJVkuXsqw7#-_m%Dvm$t!&mHc6urs)^D11?SbGrjbZrF1@M^4T5
zzUnNrGtCvf(4)*&TpAjdFm{fx(<zB0stp=@Z<T?=PUCG!cK<-x@U?G8_j|Um%%@w$
zrr)H@dXo$z-+9gQ&}|>OE_V8UYh_XACN<iRq^gUGJ6^4#>~EvS3!C-Mmqbh$I;H=a
zU)3Z6&YybLoH-LBy&ti&K*erbf<bH?Jn#t5L|}cGPr$HLRJy8M?8QRQB<I&?r-`qo
zq5-Fj2IQSVAMCw!{#D_=m%<??^q$VYrn)-sThzXVdV2QL>9JLk$RCSvh}q=j;>w8_
z<e^XV(TvULcXqr%`?6)s$q4GtInjAf<&U@1N&<=ky@#1x(@mO9$!kS|*U3LxwPgD?
z4G^IEny$8!2MfRdc8hs>Cpaw@-IphMosp*B@gn+J%`ur#_ldzv@SX2ruvsBCMx9&8
zuY@`GrvfGD%gx@Kb*dIYdQgA-VWT{C0aHSFvMkyW|LUn8s=d*YlRF6V0OQ)%2qoqT
zf?hgLpKjdz{Xx9N3m&<hZ~GObi0_OKyC2;baatN~0rByXj-4gPvlUM|e)Uz7`#fI3
z>T5BTmbl#HpgBJK$zwLUSta%n`I@je-LVk)nv%B>7}9=o-o_wDZ1mgdAOd&VNKLXN
z1zJ*v51B~KYHv^Xp+5cbk2v%@B$zoiW&8ZQ(B{CF^>%v0zV<(=gTD#wpAG6d^D9pb
zeb!LD=HnGVG%j^1sy&vi0yDi2bMScMo-ld!$z2@H2CkC(HvwDqF|8Y+p6tZPzeK5P
zGT=tS4EPEk<{afpuI>g$R5Rh{dp2ORKDWJ0h#S3e^!$8$yLSKbgnc!_yF{J9zOv@^
zNsnGa^f65JaK*%JWi*&pDZ!W9n&6@bM>%pCi|A9mUEvNVoJ#S>UwZJ$$Mipn#ebW*
zzjxpyVk{PCnBdr4?=|vcIG1cS5}sR4pMRQup=S!+Zae+}|G3nsA;I$*WL(7{aPJ%a
zT5H(00SB$b{r{_O_HelahF3v8qH3wT=Yy3)k7&FJlxbaED3VxfORc@<&t*=|zg!QD
zmyBZf2CY|DUp3p?e26msbl(mQbP%`W70={=?6vCu5qT48ym1I_{1fC2KcW}uK3D_K
z(R2O4U#J&l68oF`sN}&)T%FqPpyO%(V?MVTZi|L*pTgbfAHd!C$ai&sJh2^o)Bi1P
z78eaMsI!Tru2YP1ZriH-UNQ3w^>Zhe42#gH`9Yd?VQ&N;Pcv6bPO&L_Cquu0O4Xdv
zARf;I!7}{7zI^&qXJka!(L8&#u)dIe1y^`cC;R=t!jx$@cK)3(Uo$T@BZvr3K<?cX
zNg*{edAhd$<?35|h0&+wBhLnRIz0~PI4s<GM>F~LQv@oFzp6()yn+$_iI)9(I=j4z
zDqd<Y@%z`~3s3l7{&Id}I&xsAjum+G3GBdq+(W1R$AgwAbC0<ijyd_d93KyKNMEka
z7Q4ULQ#;;(3hO&>Q5@+zc21BO89Fp*Q>1do&e}z5{33)(`+M(wMV&%T2%R-Diz3To
z(?iSgqj>+_Rs;TFaq<u`_mzmpJ8is1m&eovnPR*4y%8vRy-M7hzr%%Iqu%ndsxg0?
zZ}Sg#Z1~M}ur}BFI_o0xG*NCPc&lwD{)2y`)9F)kpLn!Et^FjMJdvTAOCT!oveR#)
zlCqgtcM8@jydCHAgWDTclJ9HM@uEky;{{e%#=l!yV0F^Qw1YtflrCUx%w-+yQ*~r?
zu4}i=QsP8PaZw?WbU49HXJ>qlXR$78viW#9j^a!nhOf&$S?$rUU`}d0cA#Dj@!T;n
zc3B?O^PhVey0OMfN225acdEmfoSHNtx`yvgpu18=Ip70S%Ktw;yTyUFGDA5I$L5`T
z5F3wp<R9-p{G0Ds5vA68R^}Ud{`9fYOd1lX%<7)M<y}H8pVIn+KLSLAe*Nh1GyTLW
z16;g2_3;1Ps5K;p)WBb9v7E4j#r#}qP?1tb5K)t8oUZJ?D9Z&qSSQ#Ua0AZ{aM=Tv
zOREukVdYMyS06&lbNdSXE5Na*`+o)DZ!qpe3shcgd_lF{ql<U1(U97GXx4o{y<7$B
z!{NEZ)x;7P>qWeQ_=)CLoBP@ig_ZU_T2A;tG*|N^cpM!5p9fckAt14W`EYihH^Ma6
z+jR|)b*DTQ2|CU0?Lb#OmUoBVotrcuchgYOC3$iE597rb-dAt`wvVVZ&e7mXnokIQ
zsA(~Fqi|X(NB$piz04g{Ay=gffcv9}vNHW14AxId4vNBm5YE818fQK&wPxqB_MJ=)
zH%6Y*1&9viiam6IcZj3*^Zz`?r}+M@e<)-*YCqJzkYEze(5dFhTC?Tk-Y`|m_PB5K
z_bTUkJ{Oro#jK~<W48>AVky~T2Gz4`;C=o^|M3qpgk&?xlmu*+SJ}{gE=Qb*uv_le
z`9&^gP?M!oOK^Dop6_4r1(lHfRCQYCs#KjaMS5|<&Ma7125Aqnphm6!hq1k93MHD)
zf7c(F?3lFH;=f@=q~|z4^Q#&s#nh93;0GQ^+uetfM%+r)|J#JCggrE<Fd4%ekLzu<
z;U>8^rQ=%eG<~K|Z=Hp|YQ4UQLu<K<+N%9hr%Nd;Xf5PmsrO=j1h4WF^@`Nye3kQ*
zZ?9u#<zwf3fA5YG+{y@bG9v=t`jfQK^6oya|ApMq3U6072tdI_=J0u~`}xtYTlYu4
zPEXK>(@FZn%;a?m<s(0nVJSZoxVm*qyzPmC>~o@*9~JG8gG3^pf9ugbCpczjv6Rd7
zLTAnP4Qspat?pU(nly|#p1j%57xMR#`8lR%64cZ&rla@edoTU7o#>RgftC6|Voa-V
zL4gao4Ic*<4*e}Ia!`L97}svA9TN@O7*J=tbnE~4_DlaNSZbO7?^1iu6as9$)~K+$
z&LM-kh1H>&zw?cnb>w#{;qvoFTsQ5B8X&Cy-wzMik^W`^s>rLw2mk$t|17fqUXuSV
zhW{>x|LzR`-4p-6=iz_%#Q*Mz|J@V+|J)N_;HbY7mQ>H=<5UOz+!ir2^GtD1zs&PF
ze^l79H1<E;_>BqfgY91e2U|1jTwgcaZ(dM3+i$Ds{VAab?PN#go2lNH|MTKreJg}W
z>V%=?=<Ec&q%#`9U)4tbQ8OO`$kDXdbN<(@fHo6}0<uE<19@@pZJK7Ub&_VDX(5lD
zhUaTPO1$-*(C_&?`c%zYJty%co4rk6UAHj;N);^_tH@6LpLcqh=v#932bp@Eg$a`P
zl@bEETR;obtY;`I3w~Bw|5Qg)-19G4x{+J|_eRaC>IK}v$iqp)$DbQD*joHJTC&Yo
zS4s5AZVJz`|GSqawQnr;L@Lt<KajXa41x~1vy!u}wxG{9EGx4J`-+;EQw}K*v$gMO
zZ@0(yzzhQqjMQIZe+~dB6EVnt@O<B&-Qi83BE51Sy+lo~n&AJaMRz1fy>3$mo}Mv1
z#?Ohwom&lmm|~}1{rULz1WZc5zrFb`X8-%UyuVAz07FMR<W005UyH;JC`^8yu7gq%
zv=~3EtTvjmEF?e>GB*+$fAuo3>~-q}*wJesdARB||B%NCC&$eRe;M5lUh1f0LyrJ>
zh4}0LbbHSk&`9}&h{xN_A}wcU)FB!MYOx!Vmx;dnD?(o>W{!8}c{ghpz06i=8y&rx
z{H9!f*W2-rseHoQpFP=c%ZfUIm)<BV{$+v%UdWpO5MlTj9RPZmp^+VP61du5s&9O~
z4U94rs6&xi8WSoZapd~zXzo^zZ<~J79O`)ztg)jj{$IL?DF%527y_K~TM<|rRezET
zw)|#5J{r@Fd%F01<!Hv4UU<f#?)x9E_^oE+na+OjlF;z10;iHa&xh#(<b}n5`3nfE
z`T)Yx*_XsDpTTA9pwojr4d$<%faFgvQtT9Xenen;u>j3^@OL#Px*bpuDCY(z%%2?H
z@CH5ur}}g=ms(L{K<W)bDujv!ZQbw@00}$|eJ=WKIycE9AYSX^VmXmtOn`OjX{W$w
zE7^A2`5e}9=*shqa}4)psm4({!1IX^D(RDR+z0cc@Ea46n!R*u_p*Vh!#mFj9DwjK
zjv3T_fUa;3e0US*!K!;R(whPdlRCk(zz2@o{v@_SH_`(R`=>6K0Fi+QNbJ_1@7MhH
zX#0i^=Y=^oOn>ap9(Vl)2r`{Fe3Zswr-z@b<=}t@l*2VcMUDJRFJP^nDQNd>mX_HC
zTtjnxK%IDLaqQVdgsEpNT%HD+Qh#&X0c*XpqVbx2*7Nw%Y#_CayK-x9kN`J-)-$pi
zXwP6!6FTbcmi<aJz`uX-k&db)m^5Xl@$8Zvrpk2Oy<K|;pf{{e0R88Ab7P|=J@$ti
zQE$MOy{WxcEQ|^ElX)q5Y!#KK67|XgG+AR~cX(gl{4SWifs6K+;`EmfOx{p*Q;K`o
z{`$@1)NvF06mg^SlK_I`T?w({8;ueTkgdKL{mL9%iu~JG;rxe{A>>FES!R=$@BvoU
zD#gR|YBt&LU}$3e_k(?ht!8)f)>_L(zV&yUDBwUFEil~1#y4vC+3dYT9xuB2Mlrp~
zMH`!k$;~8Sw;K)g`lZkR&`J8;2s$5fwH}NY9}nb%c2M+5bHzW)y3(^l@$g31cw^m!
z0ZDMt>)gEsa-*&nH|PQ0a0R#B3y_uujR$#Kp%u@+b>BBSoN1U)2jex(JMJqZ1R18j
zPaEbYQf_PNsX0~%>EY$ixi?l1pg)+cY#t+0*XwG1jZ!)Tk0pu0BeOexQM9t1VM}u4
zxq#DaX;L{d%ssKW1?1=Z#l(ukSt5$kZ?I|4czt8CXzMu1ZfxJ{TPCf3m@BsY2~GSu
zE<#E@$55f0?GXXoRIdEAQUN~r+?JuX7W<&njQI^e<^w#`o?qrT@utg$OYCzt4Mp7a
zc;^D#&0~(ozXi`{8oMkt7<Q*_1GvgArGT}A@GD;%K%f_S*<y;=)i@bQGTZv1>+CxH
z5jPc&=ZyLBR=tkCRoaW}2UMa}RvE@#A!V4jm26{8vT^^&pA&)nxs(Y<P<ZN9n2ar|
zc|+F(U0sS~N)6E#X6td=wW%)y&gI>t7;B3j*HdP*d#-a}Y-Tf?npB|)f*4Vyh4F8z
zAn`xL0s{egs78I@Z|d(4$(bw@{wqUS1cdW-HltWo`@A=41PqQ`DPGiSavi&Xf&keV
z<}VeQA@$aHd-PEWJ+RT?tED;MI_JJJ6z#f`OX|8l$W^D_m+!BJ0ZpkD`_=+!0G_YC
znX`YPI^L4P7kDQl&gnr<D*IRMVMDX!aobZ7O32YvU<p?zvfYR2iOX*2IbcCZWc`uf
zi9e1{&$TPj$j9EO`091?H^Wf+iEa}Tn8@Q0Ny>DT!qb*1>AB{!>HchoOLONxbu`0o
zLUf7)U7Roe>;yqU)Z|ZO>v+uO6Colf?E;_|SiArI*mYSaea1ICXy}%|M6*uR0svzC
zT`7~Z_UlmOwEb(-r-ufas~XZVL8O-iE5Ah=G)1*b>LoAn&aCg=BXn@RW|_Y?DDZSt
z%y|SSzJIN5H>2_As@l$&vjz2;Yib}shAm!5oIR{I1<qThZ}owGMNZD&F1>DGS>|GA
zPwOSEUXOugW60`xfVche*W1+;>(rf8Uepba#25|I93NhbUTKlD+4TS_1YI7$6QKtl
zRw=l)cfX~_g+haV0tZsS&?7<1zC_F*!3%U|-60T%cg2tzkV8x;q-AQkoPf7^R|txu
zz)TrK?42O7rxJ@=k>{~)F<rkil97uSWa7c!+`~Z)O>A*xyat3G$Y}U+Q&iwzo&2}b
zCl_89-+L42=|^++pF#!y4kzTr2rfjy=x?0dh5XA=?{5Mt1)byeL!es+U<<>jeazoT
zpxxUY4B$4ywa*;2#nXUK?Dq<=JUI~0k2b|o@H0I><4Gk%lK#^`1l#bB+W5WjZ|6Eb
z>&s(!_-}+fiAk(BYtBc^>eM}0!Bk)_C(}x*<?`rp?fF2AU5d3d&zGOcsCu1m_s{g!
z=mq`R?+XL1kmBlD1hrGtaTg9L8!X4Ut;s{-3?F}dT(6y?UUKby7!`h|E{PFnc6;Ao
zISSrbyuRCuq|?lg=A>kymuJ~)$#%U~zU8866GXYH9E=ULM+K(U0LsuCGz{X=sOHP-
zrOz-ySf^cBLMFK!JraOK@NQ<<vpcg~f@xCZVdKlku1B)pfJ#c6pOSL5<LH3DPioi~
zX;u_GuHQ-=dmsz`IOq}inJ|bm@+#AuKw{KE4{AiE&!{Qn-d<5(Hnfa20xH3k4%L)K
zARUanw@~^Cb$guqG7X@Mbn-b&RZmS8I*KZNqQB%l^Q{-T6#s31_)E{Z-sIHXZt$iL
zSZ{Cag1Rpon>c*WqUg=%aLY?hdWh@=(1%N&E~V^-DvK!@!;z`fh?toBOm}3vh&U(_
z>o@!r84h8q+{e&S@ag-z`dzO9A1FA!`{YB?t3{9?s1f#uZvl}2bO1z748k{-&~Q*v
z281L*gStTQ-ZL2mbDI5FfsrV4o~_Inaww*RD{x~3FJ3+TMSWz%aFZi<qTJK%R%i_O
z1(m_KD0*NGT<F3~CEH1mI<qB11oT}|+%LLJ7E*S(!R;lH4q_JJ{EDgoWE|;_zl#I^
zMYz;Iz{u-I;8dLq3Yj6g8ee);n}GgnMdNR-O;NX;&x=>z{B4_%3sM>l2t(&f@AbC%
z*}JG^@v}bp&K~B8gt>^7bo<v|fq)OYpepFFT$@42(`b7>7yy>2)eB2m;A=(mfMTJ|
z#RoTVVxgI_NRV83V>9QUJ|90Kh*$#W4>kz$kRcOm(Q}Go>$-c%xbl(JHFG{*h4D<F
zf6eCVVpTffL&1&lip(tv66-P;!`lY$c+VF|hgEwGs9cJ>az*M*jJF`h_{eR5UeFFm
zQ^p4Az`{me(^fSJa=r?GZqQ-O#RJE^_AsK=tb$Zx+XDka$%F4$IoCivg@1#k>nFVt
zl67;X;(N^l48*R#+B`Sq<>RwN7A*^6y3rNDW2D%KN*toTH2!^qElY@{CQUhg<ah|!
zPKh2Bcsy-Bu|<5@Z?t4A`CrP|GR9mkR}_cFXy=0PDvq~=M{za5L4C1;tWYm;EM~%c
zG%hkz;Hs$c%!l7MGLkvbu0!({(!wrKsAf>IP-8!l`U-%D)G%5XsT`+fyBqm3l)|ie
zIo+_}#H=1~vET%_n8ZGotO^}2$wf>pDihUN{>&O<4tnl;y9d*?@sC#wv-5I6xsgjp
zg5#?+`ldw+JZ5<5y@J#j9g;r*?8NVx>kg;M49gDxsTix*aApHG-k~Of=kI@1cQg?0
zIGiwkxOrG+jHv$bP(<_z#^lfSx=!WkZ<a<IJKwH5xIUr2vGU5Deg4gSN%@F=`#ejM
zJnE`cx3X;XwSfx=Gt<MZf<SoUD34vS?3yw%Vpz6M4<fJ5CcpKxk<YQlo{JUSWt7in
zRh&jknMZakY6k74;2p?6z^UvceEgX#Fa^pCToQ|XLU(sVZ>b_;_uo7BG<{4|A4xja
zUyPNy9oX6OB@J1Spn6R(X7~jC(LMBXCC8a=tptKnFs2e{@y6F69sW6$n%FbI^XXV@
z{wH0`Uy5Hx=h|%JHlwzpt!$3hH-_P}`TH!bhDY${>2zOoCZ<h{bT>j{#$s-$LMYzg
zQ#HF*T=DHFZu9);%cm109o<E<Ac2<G&|!C*LvHHc`GT^11cMR_h;xIUbS#W(NEd)=
zU77~GLW~W^ilPu*QCQM+T~H?<xkEl4)u_9(ofLWeBh)o8NpL?=H(7WGd?0;q?}j@l
z`;J(}QmSPsS#7Ea0Kt^rQe3_#NYT#wc@U)-`$Za!#by?YN1fDv%2v}Y1%IV=%_6v)
zx|^Ytj?G&{3vYjfNc#+KHtYy>Cr*E<KwbYXmk*IMC3Ma5mxK|YjmHj%x=nB&;<(GK
zz$;fPfx)=-L;0VRLSGOddrsQr6JQ4P-UB)AscnJhFwO1Sz$vF3ZdGkck7ntitCgWk
z2I~h!%)Rz=t2;o=WOdi^dSE+&G}}E2PH+qgF-oeo(?j0I*X&<}FriGLm!MF|&)RK!
zb_rL0lo$nXUlZVamA&JV;SbN$3BSeoIqsa>YMp|VuuoFr5OZo?*U<64r10`S66btX
z${%D4bxRQ(+n>q8=Er#3H$vGXt_V<W*u2|^G(^tEr{ZN`ZCKQCk3E2~)@q*VmtFV&
zE`yPq1MZ~%=Do3NM5!ijP1wCarisUj3?yj^(qU3KG18=m$;a4Z!S;AW&_Eg=7l*Te
zC>aWV<FGdCzxLWTe{lxM^7@-}*#D|MUQ*=#P@sUfyg~MX>*Ed5s-uKA;2%cBo|qAk
z@Ot7WbyCZ((Lo`xBf`>rN>AYwuYd>fCQ-F8>WSRjnA?@s;(Gy2r@LrM9xomR*c@Xe
zoMFLa4%8^*nUg=q>(Li*uvMCNLs&=h=@%ve8w9J;Cn&(^J9c1~Xb{!?(;JT>CJnUL
z5}Rw}J~=l1#DUCG4T1FQF5RGbXrbEAESE6g)evfsx2#DhuWAzqhP6f3v2I1Gnttr3
zwZMmXUcG3JC?$pZbiI7d%%eafU;wyc;v{l?80HvUA{IR3^<tG?NB{FKJwtLb9G(%u
zo*z`{LI3*i+N_T7yn_N8+-r#B4wrzbR-mY<17kJlh^R57T?S^hDqAX&m;f5B=6ly(
zTJJP0#T;?+eCF*SubyM7sMM9z@`k5PNG4cSlL0OS2ODd<*H@l{Z}qF~OP{0uK=K_N
z9XhxOQ~TOiKCR)|)t}L;ChGKz^xM6y>BM4Ko<Cmk7lho_#ZpNjHh+Bd!~?$|YQIE-
zW*=0Zj(oogl93A%IIW9$qxE-3Qrhm^{iV=V&D*th3{?LVfhk9t(xI}tEqVvRd@$-&
znI${`6H6dQ1=p+9);O}jMd`vOa@iMBgf-2noM~4xkMXskXF2uMmrs93+R@<`>}NJu
zxzKeeV%u<2%!hb50W9Ky%a=!os-YV<sooc^`;<&?Ak;ynQALXh(o$D%no33VTo^ex
zBJuL*g{&wQ&1)Yp-(OZz7m&l$g!U+gCHCxLK!G(+eXWbyvjY>_b-A#zs@&IP7P|)-
zjBU42fF;qbJV#M33Uska_pn$KOT*tcQJ6XSza+OA3Sf`b{&1tr+r2luAt;*xH}6uP
zLn4;6c@Q*2ix-(EXK7Ud#U29XEbuA9Dk|tVRf+xHGVm*%5gZUhBfcga_n^;q5#H)G
zY3yt6H&45xGP1-bAG{n3iEsD_QMQw6zHaImjA%Wc<#wn?osETs_YGvc6LD@sstQFR
zHsoQG%31doD~2}Q)K(0#@(&msb+&3Yl8rlkSMwm^jpj>QO~``Lb|hoMQ_9P55RZ3l
z`07o%zk@wCj{@1TZ@f;BlzR88>^pKe^3^wVLRaJ?$C!*L4yuADd@Xzj;S@$s^BPWM
zkLceyVtoT;-@#NqGH?Zk@*MPU0yfT-!ocIN^W2K}iUU{Zt8Os8ZMmd947_)e`U+bz
z5=OBLEw`cONm8_jW)*eJ@uEx(1T*z%$c3o`oh-HVGYgu0S*MRdvwj;D#T=Y%B2f-l
zO*%`E876DuI(&2|k$h$#2%5&{ihPa-41`m-TOFO<&@2t%LJT7bis|>HBi&*2Oi!37
z80{*Nh~bfLmZ!Rw7?DLpv04mE19804a^YzC_(4n@&7U`jl~?EKxI8@Yp%TQq5uy|b
zog7D2ee~{f8}NNBtmZ-sEq%OCZoAW2j+)JoE%dhOf63EkilrAkRFC0Eo()wXf076Z
zm624kX2b{P%b|P(b*7RKh2z4)fFd0*z6InHtLN&S22`o`azKruxOf_jRKzs@_WLeq
z7i~vCbPLw}Z{CanlflmBiYb;(V7~nOPe_xqW9=B0*`%=-_8<Wr8K$0Z7I0@u*=V_1
zuax<68DgJCP&+^P6E?p3i;h?Pdez`w%i+h@0FC&%m*+ax5{IRd>44X{f)!2ylK@yK
zDuwu>MPyCEjvPs><pB<bWifpiq&pOeAdML7SFUHEdqBDW34-P0#E11_H-euy2OLRb
zysvJhe{(~n4xsyTz0SOS*7&dxluM4AZ3&SZ<6P8C2;5HhUIsxr@z~=T5F}Je8?VE8
zK*WAKzj%#{DLPX%xmK^2^zuad%)cH}N1Ct23!A4P@pZ?|>)i)Q93HBin7i*zQ~ln>
zV3qYWA^B>*=W>O|3WKoVnqh2i9*ndgE*xGcg@lxy1}PM}5KdX4GV!cKQEUJNxcT=C
zM{8jMatoL1SVvvN8j2}gIi`89&sWP-4vRvpfL2Ud;@K0GN1u9*))A^FOw1}#Eci9@
z4e|>177_R2-8c`D9rtn6K%0YE5{7pHqEsCnG6?2)p++!GxA-mr<_2^+>WlpB!pF&f
zc-F6WA)<?)O~dt+65_PUpT5I94nu*APM{ynP<;8B1dHoWa0sC{Ye)AjddBc7o8yqx
ze1ArXi@w6?TTAzz(((k2wC;tPUV9|@!QsaX@A~`&s2+=LXW=`f&wqQV=HeQxAoGHR
z6<_YhH{gZ`i^lSf<r@JjVe41Wq|SCb*20}#u<DgRbguF-BvBMRG60{HO5DYMnXB4!
zNmm1#Qn}mG@=+a^m5W!|&+DTKUn9PS;h7ufS!o3ZbWRZq@$k#-)r^lyF7ZpZ+wJwF
z65>aRTODFnNp)Nl@r$qVIk`UAzGIIIC;Q0vs0*WzDwcvcIg;N^fr4(gCw2)q$A}qW
z1;+kcUv@puh<J&D?a0FM7^PERGxHkB5JQc~_!NjZ=YII^&LOaQlq8Au*J&s@W%2j!
zuJ{<0x}w}W7!Qc~J0;j!0%LDo0Vguvko%&$L<mgUO}1;p6TsVh=)IfUFAqwj<Lq>G
zBt%d#aAdh}LElGrkd~TZ{uNSUgz;ld54_7rL_M|+GH}0HorIeL#x8m<?TURmkqceJ
zhW~iXLb{caxu(VxdBLdV@z&}xf%UB7Fu<NO)VDhMuI^Jok45xSc>nFegFnvup)vkc
zV{|Z*wu8M=uH4I0pZt8Oz>epuakP!j`Ew{6>C+&)>o~{B<l{j}BOfj7{nzTLOUF;?
zLo|*GvOBwPaRi12_`JM2!EbrgmkYiTDn!<0tha;Wy%oBNKdG}d%U2I}VCK;4mw7;%
z4D5a8`S`a=%BVME*3vKDd;JdfD<bNx8J7|L!A@*c7W^zG6pvpe_`aDTAmq9+5tu#%
z8Xt~}Pn;dyx3RP2T>ur)lRuXD1I%U(G=O5?9e%`sGIJZr==}W=E@r2csv@5)w=vZV
zZh(Yx6qN#b#K~eoX8>#M3?EKP49<?gGemdfiCrG^6|p)tLl^dP-)!eOyj)XkIaPF&
zdt3B;=O(~jLbqAe75{I$Vg*0*U1qriK6M9eyh_#8j$xP|2~}2?Me$a^zv7$7xkF-t
zu2<0~q?(aUO{|KaXkFJ5(`q?lWwTtelmArBCm`%W=Xt1dHB7E?=y5Uz6vE|^*Bcus
zGzdF3-~7q@b@Nfp?8B<qO0TGKn`sJr^~cv+De<O7q2;qF&%{H>CG5C~^t3w^O`}w@
z$##E)KInQ1)O`GDZ&ZrOT7Qo3zw*bNL}=LuQOe`yjDA{3-{LIdd+`QB&K8m!LbOBF
zlR!5q$xIFRs_Bt18oJA@&Wpp-g>OQatRgsx{+L$6W(u%2#(gq<3c5=6*sLsU)VnI!
zH|W)2pT$?tVS+~#8;1OPF)p{2MoM{27!fo&xqNbOzXfDkg8FEgBTu|VC5|%d4rP-n
z3d@lZ5NJu*H7+T3Su8_xR8Luc^o&d&|08XDHAZ~W8`t>Hv_t*eXFcg-JmM8n*U$;5
z0;^4Y4!=wS4PN})$pfKDeQq_B6xTst0sqHQh5&TjX3*93<~ze!;}?{@P{)!~dwwiZ
zjttc}vM4RwJ96;1vy5*O*;uk85;G|lNQu~Ne~b9A^LN;e_r<WWC_Er56X(V)78$5;
zi&TA>kzOz^EHhYNIZyY^^%#t(+^zH1bEj92Sp`;y#LmxV>LyLD4~-`V6)C|Dm0*0A
z*LpvH^Nc03^KjK>5!s?;u@z%;6%OT6_vUUZEDUpxqpK9h;d!u#LKP5&jM1ADH>9~d
zNnbr1=Vegmagd;^1SnN<F++a%V8hh5et4sKe#>|Q^CSRa0~&7o_Zm~&%C{UP1;~X|
zh#EEtVu`69xKMnesJ&P^6c?YwYr`fW$&n(ZMwI~)`n}BXDWY!1(nktnS}mSK3L0}{
zA0nQAmc?G^X40kZOw)wm7@>Vy^w}^t2xv_hy6(IFvhtR=llE51bxu${2Fgn(#C69t
z@;e@5Zw=~6%v*(bgq%eS5JZv$PnTc;-r{eq&tW9TaUUqV?_B*OoDIQYuU-$&7~i1_
z5{$egh)DfX+qvl0MoLP;9N`sEFR*Iqs9M!}r3*0;b)K_Zza(n38SP0oZ+Ar@Fq_so
zW@%8nCV5mv-}+V^t?0Qr1%k&M8;i=TnkA&~)qO3O*R|>Bt|RZbKkAdWB@xz7PgNDC
z>;mzX7iBor$FDapV$)J_Xi4IZ1N#AGT6)eq>M@-IPR_&#{#zsb+MLY}2Zd{Oj55_;
zZg8+~r#S4iGKO#MQn|0|%Hdit&;E=euvR8=ei6{Sp%NOCyqL<aSp7<nYt}L~tIB-w
zz7aOZgDV#vih{6<@?y0N@;IV`Xa&^={1J?)nQw@RDCc<OaBu_^)RTTh=zXf`C@RI0
z9;;4<hOb6p-O`Oy;*u;h^}&!oNzCtt{ixZ}z~hndPc8ZbceP+VnCmazWOj~UEP4$o
z7!9cGDPNwyDQwvC+Ry17G{0RO%CG;am~rccA6^D>Lr3ALGv^ZLTu-IEcq@k1boctJ
zv&JuWgI{OH$Hbg%uPFET6~5Y#(UBttbu0WHK($W%Hy-z?JrX_r;lHg>lIQm9hs{ev
z>WAD$HXVu|_|Kr)lnMRu5K8{imx%9sGrQP4!Wv^-xNfjSMoCx*s<dl%@Aidrhf;@P
z5LMD61wtW#anZi;1YgbjM)!2aJ3aXl8m<cp|7dU+&pftu5BI`==2$C)A|SCU3{nHa
zz##6CK*Qz4qx6he@cC4S|9C7WZO}?5?kKSdhg&0+@t?TRn4C1XG8UD1VYx7Uqcr#8
zbS{Huxp%{vZPCO}10vrbemoZ*n9})>Nd3lLHeff5ufXGR@m?WKz~@H50Y<p@xKZRW
z9d+^x=izZ>mBcPE3HDJiMe?aqmFu_t0M5B2bzF-sI@Wa@-dG6l-iW9vf-on#YeD9c
z^&jm4sS>io^pefd54C*JLP>*i_EcWY_tt1$?y>)ooBKoY{Bmq0;YZF+OOExy@B_Ez
zDZ<fdP~b`(9#_%*^=YgPZ1CR8CH*m;KmTK3!I9g&6a$I~?U)?HHGr(ko}wu*DzZE8
zUy?td+{-P#mYowcdFKXGzg0LYdtwS>*!$e${#?V9q6*3MDRMPPfg4iXnfn4pF6=+&
zj!&b8EqF3!`qo9|8RMF~g7%{`J_l0mUmOd4Wrd@6P2=fxT)JP-2fT2h9V*=VcEaw&
z_UQMVR-~@2o{MV=0|Q#Wn`_;bBiFF*L3ltydjZXBvcy+{_jYA>31HY8Oya~6&oLB`
zfS-s8VKQlwC=|;l9Z(5_+z){_8AM<usVX|8jGovDKG^?WtrecMGkvdk3@4?C>RHp$
zgAFD=U>%rSI1yED(XDP572d1kC^He3(1lTrS1a9BoTJ9%L>rC48StkG@1#T%<A_8h
zqc<b1Ahu?tobXo(t4RYf+S<txsV?`FT9rNxkoB&VgCXv19FM&Ao>dbSBI!N-Gd?|1
zhhFPpaS3DB_3rgE`>KJ_lERo5#{tbEm;RH;7BvZflfc6-^#P|A+^de=S0$@9lV2u{
zvYgK6p6+V*nowgx87;}`nIiqT7PH>EM6Vl|`;Md$O0C~9<5H&dMywU&f9LQM=Z3H0
zX_Y0msYP+L7-3hgK^Z;~TO4E%+eT4fMe}1&H6fQ`Bjfa3wE4n9Y!JBX!MiObpO`K=
zR@4aCXapdt2b!795m!XHS&=cm<)uu~HTZXbkYPs48jfp->NfNrt!Iph;JP-rEf0ti
zU``T8cZlFtVlix8^-Iq@CpXIF4Sn-AeD?Vm|El|lBTGj&L7a-bdbmw&B8d0K&XD)0
z;Z`93;3tS7m^k~BAF2!cRl^(0hb<u()dO#`i{%KUYf^S!9pP5^gQU8?j)OA^@+lYx
z$Xmo1-gF1!6W;16-4>gmz<JASM?nw9vrKk^R3#_zdT(Fx=|SVHX_(UjZA(=It%7}0
zZ9UG;&m+6YubHE0jIL0B%>BW=nv!D5#>%`$dciLz4M}76Wr+#D_@C!S?$*u#FC9RN
zecL<J>hmstoGq{l^9antJ`LT6lF_aa8%adk?VO+I4~X?U*EctPSdJgQ<J3R8{lrw<
z>FB%7JHH<saP%6QYxPtr9rXld;Q7aMlE5%kLu%i59M!vK$~QIe-WnSpb~``P^QB9T
zF;>MoG?h7=nET-I8q}pNiu>&8L*365*(_OCSPQXD+Jibvv0&+QJy+~uzHh>I^ps!l
zjAO~|M^zYgAX$O4xmZCwan+J-I3sZsArq8qg?;()3J+_2;sM4;h{V~iay{t2X@_`a
zBwZzg*vTiPc&749@Gmf$9iLT)Ar+fEq^O^|>`D%f_kHh+Tw8EgxL2qh8xNbw8-?&a
z-}z9$;Iyu^m=CE@l<<fpOUpp9*=$!T#*n8;^US$lEEO<P4Jui5_UY7JJd%)H5)UUf
zlf+<)Q>$A(%~MKQG;9m-9n%V5TlkuUUvpF0lNaj8`lLA)U_#Fq7~8+F=0B_??F~^T
zCNe%XdoCqB|4*z!dl#{f-|*Q%WN-eEN##V0O;=K`=gPXGEvm)W{YOdumfH21rDjmX
zHM{rH<VT=P5GJ=jO|$vgSOsVKb9HI>(xl`aCN+q9+8~JzaWPA*9_yR8exG)lu`sP`
z5+QXriA|vy_7r54?#Oi!-R)6mRG1Sy@4{0Ej*^{=!d`HP;a<jq92xh_%+E}4{fs{H
zOujYa?Lvj;c)cW-bZ5Q?(>FuIf?!4ZQU?VhZo`JpQ4+6vMAMfgC>2ViA-}5b8_C+B
zUv&I)h<u7cE+`??U?LoBBh+dxxADdlqkR;hg;dKqk6$s>!zrVg*@D+V!uSIx^hw*r
z+tsM8ih*sf2IbECGc-?K#(a=}<P^I11a0?$g%PlEc9`dM45Ci^2I3gzL@>;JgR1qV
zOdwBS7|1QAE8n7h>+4(*Gg3H`x|@9FF&Q{07-Dh!k+<&$U^^GRWM&REvj0~y2q8hp
zsPueJy5zx(1iRkI@&N6TSFFunMNrhux1Kh8oIsR|j~jP}!f{Qw_8MMt-=;q=3>z{s
zmA)EVz}a=G$&V&6@_5Dhy?r)YAsy{)u*ugx$gr(|2MFg7`R3b<K0b+SdV-`JXtq01
z-zD-oh9$gTU_g82f@95%?I%8SuG}jOCL0ZG>-AabWR-a3gSk5(M5VrKf)bNgPro;2
z@fh2yi~N%2nOxNNO^YDn!~ci9w~mUk>;8uoK|qj{lJ2fSTDm(_Lb@9VhLVm!x?@0)
zR#1=z38^7v=#Y{ax|Nop-i!PGKELmM`~3cU|9jWFmTS$Dnd>^|?7h$4XYaH3{s3o0
z`bR5%<1V2%!)gP<-4vtWiruM&Ck=YyYF+1>7__2nM1|$?-kprb_JltO`SAnFI@Sk<
z)JPVD&8!~S^PlNi(MQ|PF{=~ucUFPJQevR=xXOymZJ#oc-{a34e&;9#U&TMyu>$~{
z6}}2Tv>^|TBS3!~T@`y071X2FQxpLlA4{@@_x*+_^skju7;9*Vg&D8;9!r0<SdFf;
zY&dC*>g-En>`J<VJ$wV@Zh!Jvy^D@{8(Y{M`Zq#fh@8^WdzhI@!qX-OeXdKp@u72j
zC6M1~Ripof&FlDbobi|}Gv4*N*(T39`%>JCc)MeMCEBz=aPQvM*Kj-hi`Hkf1j}!J
zS+rM}Fv8x3jJTKUy{5$C0<Lk{blDRp&~v)8DMi<cu;{cq*_2uVu(|vVy7OmGl@R&Y
zRa_OoU6&dE9jaXVWY?CH?}Qgv#}S(m^kT|}O9sn6K0GzFV@wQJ4E08V%$CJe-#QzA
z1l?S9FLD1g;+LmH20u?*sJ2l9Fm*-vP;5T)CAI3G?ghm6P&FP(Zc5QPACO7{{rtj9
z;vfvGDX%9ZB@1$+_^kTrV*?+B?LOM!pu7_2P>F!W$(j{OKG`WAlj6{iFs(F~NwQOv
zDjwa886|uF>J2^JH<BWPm%<sLrOPjta&zNb(xWLKkA^8P)5hRQ>^pSbXB1oEuMdkX
z)LHAX&6>A`YU=JK(Hj5mdjE_$D#Q6kxM|Pv_0!u^W>ZAFz;L-%g4Dr=eB*CL-Yx^B
z*R%Rs8XMUGdcGU9bM8vNyQ@fPPp=4-1~?8oT$_;Movm4)XxkI*_^&VmSr7#5qr7y<
z7zZ*~^pjZlCwEvC_)9nj-RRu=UdhGAGl7&Wdz$1==)i>G*_ijX86UDG)V?#l0`3qG
z`Z*go&^$c<F8`6nC-yn6VjcffoWm~GWyo9W3}i*|7BFPMVup;xg&?+OVn@dn#koHM
z^u<dX%g~wlG=cOax6qi$N5(R6{l8xVL<5<nC8vJEq>^%m7Ru+F&uaI!9KC~5VZ8#U
zom8rke?dU9<N(zv3|1KW3c=<7!BCNYS>q+=dzldQO#xprgKyN+V`!#neH$^ZF*U^+
zI}${Vt&RbV7p<?-@q#d~^gp0B+5|pVgI~t`r9KZqJX+E@=N}I7PGUcKq$+a#o7XPi
z)3a&S2vbXIENZX$A-1x)2k?r~^Vsvxp-$@ZJpW0Amc~J6LsdFW?bo_?ewb)OZ53oF
z;*`cU_3c_Ed?R_ttD$e~rNXlSme=WcH9>L-U><LZ0C__SMZkRSn3()k%L-(`(W6Za
zPUmtS1ty12^=R;ZIN1??@A8vhq2Epp5qn~bI(B&Nm|RiB$=fUvaP$?UarZ2#^8*fr
z6J;PTaPW%1rHR_VXwuGy=F^-(6wUz^mz>R9@Y&fjPWE#`Ep;Z0^}dd0eQM!%w$BNj
zNNW7uy*typ%C4fRTD%q&t0nqcGbeqmYXY{B$1yA?=*$`jtdxrAmV7{c5y{=AroYa5
zKybd0$h^R?YpT6{Nxta<e^(3hlvdfNGvfiQ6-&yeKEoVFdsq)#+2@G^30@qgnE#sH
z-&ubE82pQ`0Hnn~2=UjcUhuY;yN}zyhr5+`M|B|i^<bHy0fj<w)x1n9{6D<BWk+5-
zkjzO^@d==XwEn-aDK)UQ-Hw5Kc;!cJnOx$DXIESM5*pq?)4g-v+QD|uv(h%wGtx^B
z)YI7;SYp0jr2P}u(wkTsj6^PbR;zai8m`V){Ac;M^I_u42Zp3>FO4X@M=%fl=U0xm
zNXa2FpO&`o$O{9>v;e{WdICsxyoG08D&S}kyECfsfBt+s|2ODt=`y3ZkOmH8WAv$5
z3W2d&hj9+)?ic^47rjMp0rI^(m!ki#F92rKQ1YN0Puhd{@8SL)xr82&IZPgoP$%CU
z%vjogp=JTuv_KbRjHu{}RWN%4hwOhg_1{F8h;46gmtO8IpdjJpvcwsE|DX0Y|FZ$G
z0Lh@!Ie77}o%I(tfYo4Y8RXNHN0aIQ-@YX<_Gx4p$FuG@yX6KxvNGYzPmz)1tg(oi
zcrlPh)@mrpK*!|Nl)f0p;$NMF{|{GMG|hqD7U2<2Akhg~u+B#?kfE0HZ8YFN8~g96
znJ5Ar$j2#I+9psI{ugTJTLQXQI30qS=SF#DaS<_zvQXH6dWrte7<rWIOUoP+K!0q~
z9Aln8$OUY+&YOFB9J_ql!mR(~EW3Ihr7AqEf|Q0wvr9Exd*rVu`hOUI7t2FV#V5W{
zC^Y7h`>3Iz=wE2HzFBv|LGVt&874=@hC5M9paiGtoA*E3{wY%|FzGL=uVnJ|LSuj{
z3HLvc>wglFlani7s(Y#UluO@6z`5mNYe>Jd^}~UG%FoC{Vw&C;CBU^)5iVz}+Rop;
z+yBU+Z-TUNII(P-S17_Uyv6(3>z;o~5f<9K?mNEtVz1B`;w(|f2a9mG@PL19mIQ)L
zp`WDFPV5cY=#5JIY+BF$N9z9~6EoWU`uy^UBYT4gKcq1)@1LTSCyb??lxRsYubo+`
z{<S_7VO)M_bK3IH<!@``QMMQnRD51qUd@K#Jop#=fG@Mw=N*|$oI1MwjiIDsy!tCP
zXRrQu-vQP9VbWjT5Z#}DiNm9rjQ04Ft!X*=g5#eIL=kL$*M`#>`*n0jy{zNo`BL%E
z<(J^!mBl7Bo_Cg@Z)mu)4)Hu{%kTZC;DnrF@okX4z;2%RRRk02Ms61P{+}kbe+!nn
z3EF(lmlrH^0--S}dLC)KEkFOs8@>}Pb>=FJ`5YqS?8<^aR``J?<ReQx-4DoLkIKmW
zr@h>*e6>%|^O1Cudid#r-IgQE*(in=|3w|9k$31HK23+(4nHXWt^Z&&{Lc8lWHV%+
zL3+zOkig{Gs3NiP4aS{2H#fnR$+7=Iwcee_47OGn#r)Mvtpu`CoVW*(9$<*hDan8g
z0skl<L!wqg*o+)1+5>Fs{&Wv4e?JHPpkBN<(Q#UY*m~RAt$TTuKUnwjUT+DUzbP*-
z4|?G}tatPD;FX;)PM_DtY`$TY`x=_Q##t}m6x!?6yZjPhCR9cz3X!M#-;Z>fkeXr1
zW<#JH_BD5a3#nOHjj*%5rucbk4u*5xdjg)%iva4xgDu&wy8nI<_@DU}!SqOSs^`vk
zLFFlT7?bfkngM5h%*0E9|9$^o4^69M4XEmszTw2yk5fEpR)@g`^i>%Wv6#@Jr2qFr
z9q+EZnjV4(ZrJBIsmzT0G`e{i@7%51`D1bNF6)i@A2U~!zw<46s*Lb+FblRm9slrf
zpF6#YsZ7^;BeRt1AHO9E!9!Di@s;57?-t06`c)>>sc#?mkff;e0@Am9c=%6(+^)-(
z5KH%c$jQ%|w}ac0Nh%G#`JgU8nfB#$I`ivtsnVdIfuv_cXMq74*ExT#fhgo0OUIv7
zs*vWu`^@g_=(nHRIWSzP#5}VhvHx?@cYi#<#f~OZn_f%w?DsDw<7d<ChVTEF3>{&{
zL-b_uprVv5=YMnH0iiNnF#KKei~nBnj5Hngl=HDwJ;NW|P)7ei5c2;I_74#;|NqJO
zZ_)byf`AZQHB9OmJ#_Olef!6rV?qP4<bdqEi-0H3ezGFp7K?|OpU(s|a!ckGM_#i1
z*LHb{9(w!zT{g*F!OCPXfTu>Mf2&fzCL5gGVPE`n>-7ZRDX0Si@rMr>gx**de~4r<
zexXmNCsTc?uJR9|`&$VQM%;nd1zw?&_hjL=GRfe&7IJx~wf?ls!M7NnhlKvEA-SB;
zZKHf#4xl*SR150Ldad*%|20{2MMCMX-#;4(f7x&n6@tVt8&|))%~dm$ZJ-k8*~$Kc
z4$kaY=m#(35x8HJ;c14Sxozxi#fkrA9c;1h&hYqsO;2%lgR1G_AXWc+0c#QM?u;fz
zkC3X>b(i;_e;4`JjOYkA8R!t<KHQiymRM6j0aOYr0S{)}fEdfaR6i5iJvwu<sZ6^Z
z(e^Yozi*^64WOF3TGezdtv@Kn64LJ8=P~#c7)}s-atQSA`4WX}Nt@4}c?>>5x{KV0
zrzQWfVkWejnD!?r<(bUJt#(e6pI$V+a`NhZQP1_qq%-7}03>9`4+nltw&~zCdJ0Gr
ztnJ^tU_ui}xKqtMzQz~lketb63<w0<%x4EQv7P@OG)2MuF^qJG3fcc2n(|_qOXAPr
zY|%fsI3NcI%b%u!-%d*Hr2jE*b<(?rJP4d(8waF1VflcohTiL%<39|A`7EJyZK#Ka
zoQYjDcx~acgZ9TVx&O7Uf6czK77HEu_6^sRIw4PQJEIBvKke_|zgS}kwx2<yL7ig7
z5@$a1hh{1;|G_E*RfvP=Q!87L@oR$~5G|qM)t@to#VRvvYdv_m4Gct3{*=oq_U(Va
zMj*JomWwl+0$vB;)D8r{v?l(y4!SkO##ri|)$mL@<HjH-V~)(VKUq){7Ciodo6}e|
z6B}L!TqyL=l&AhNncHoK7UD47Tepi1yE5w2qrs$gOq2RkZshNvQ3^S;nT38$#k6BW
zs+#<H+#m|clm`qdd6S?P8`Zr?L-{{Q%NGXBRV7>?3E5Blzz*zTo$}{$_~|MqSV>rr
zkL6fx3IB`me89;7`MAoAi+uohDw1w}?~h-!$1)^Box0*R;DQXnul@cUz4Nc9At~TE
zEc1mwPbC9<XetegyFZwW8PPJnu>QeMfmmsxazb%oY@mtze-DexcsuOS|C?bAS&UmL
zE`9>#093N#yOnY)?*}{k7q3shti#$aZH|I&&VmLNc-)iLqxHX9LPBti&8ICDn@s&C
zklt+<CN(GDjfAI~7f#*+VDoM|dlVlTUPBo8EdD~STnF%$wO;r4r*R@0<^iCX^&H>z
zOgkX}eE3z?EgtnCP<Od#yrrt|=(X^Aqj4CvOqMbVB&<$d0%_<x32i^tc&5rsTbguk
z{+64b@OFpdci*$!``I7n24`RV*l?Zh?fxya^66Q+z{OuQPACosyG&Q+k7n*nRhW6i
z)P^4^kQbzAihX>&c(EX?zu;L8c_*t&x^jma+<tdZN%AmhS$huvcNz?%InJ}KXgTHR
zvfIB)e5v4<*a{F}ZSbt^=IU_X;r1iTZ{a9s5P)<R?_kx^8ojO4%esZci_6{l{+W~H
zh}u2!CkC%i2MDRI<x;~EqaeL_y{+Hoh$pt0r`rXzBW_)9nrd-{03fi9mxFp#e!EqJ
zKxR2=9VijCSUCa^A&XzHGSbeJy{vPrN}xV(t#g_Z$~_;jdwW~A@xILH$1>@l#J*bs
zGixZLFc;3PyYNwV38-Upylts1SezT^`*8|DWSlofKG5&``TX4{)3+`Cx00&`(1kka
z@?h{bk6)I9bdG7J)Myd)J=}wyjViBse$N%sO|OFgx=-$nkgD=h3{c6s4zv(<mjC`O
z3_t-`UpQ;^b~|0C;p;FH$pq?7eU4I#pW5(z@{Ce5E;wJpl$y>y`?~RNDFxPQkG^wT
zT60vBdsTK06mU*l0yQ8m*3yxZivaf?&!7{>$A;RQ^&cuoAD;pPSsnqBRq#Z1y}zMl
z&*hcTwb1=rKyx82|7BvtqVqI>{eD11VA$U(wOiTw_7=LD`RIdX_0lashMM_@=TC0_
zvU}#ZSpLU_v@Qz(9t3Qua5?9s%uW#P>4w-;V~@5kX%g14A|1B=E93it-Y>DHZeO$h
z?x(+<+b7I&{|#BSE9+Vw-_aOST@VkvyTflhYvFmew4uO9ztz2R@0J}~MsX}y<oEHM
z)7o_)&zYN>>>vnXv@n*v@pNO0j$b^e-<s}i_5Jh&4CG!t!9mmPWVs&8yIbZChVyvj
z?=zpDK?#2Ya5b}+KtT(a79sjHP{cw;l4t;+FQ5Q;_=GIGrz;fQ$jYy$pY&TCkJg3T
zUhf(XrD#buZoV7fsDhr2!CF0r-FW9tf%%l4ci;zVgBGV6dIaA_NbFj~<^F9gj^)}f
zT`$78??KI2g8N`w%(wng@=uM&fKS25kPUU>yCa%n_8U&tpDa6iEdB$D*WE$8yMJID
zZtuo%17M>+ir5$W(x?Fe2;i|9JMZHtaIVXhe~ZSx=zoqdTd<Z&V1|Mysxzo8{Q}6*
z+&`+BeBxRm+7ky#r=-qR*NN8&e1;%7&p=uW(!tgtS5$hW495L(yOPKG_=0V}yLqE|
zHh*R<UaogaI(F>D2^w;$`9ub!0OA{<cKXTh=#~`KxQD<mYz^0AelKq8ed#ZOkd<7D
z1ExYqMw;%Rk1>IZ)4`uE(poU)yamRD+zwZ56?OpJu(-%ywFEqrgWNMU)@7uKb1wRr
zxXsgD152j<A0#>_y^^O@-J>)c$#9>cDApW<^y(R2ro!syaO_l@=IL&p?_~y6mLEUy
zA8Z5yg#xdDy?!=eqfvVXfS>q7(n^ir*P758MLT}X@5|$YD(ByOM1vZM5EA~1d}#ML
zH_E#`5#I++oHIfN0AH<@JDDE69R#X?H*JCY8QSX94-`-^d+LE5FIV9f88!_H`HnKS
z4!}{FWNzMN6tj74CB@*N6&~h^CEj8B{x3_)M~eo?Y3s@7^^aNsj*YlT-+f4~QN8l7
z(WYc*X^ir9izor$Uo!NM%Qm0{!;VgFbIo6GshPdxsd_%3c#J9eE9A<R{U@({1A%Dq
z<#b*`EuFT|k28?#kz~nmME{0Af6;b<Gm``4)pkU#FC7COj#~*9E7*8%LMUt`hr{JX
zxey$}ACZEd{mbvi3eD8zrjiuL8p8e?*N-htZ;p6p;|<p0-&V9229RGJm}FyX=jA8v
zd9qSE-Y0neOK7<kI~oxMRK(0O*JLqOt)VvL!oC8#9c;57a1C`%AX3K5+L?hF181$0
zIytBg)l5O;;t!}(Ytt!8o%VId3tD{8dIYm^OOAM-AAdZTAq&cJx+N2p#lsmh6bs2d
zbCR17KMoB%8RMU-`tnOyaWh^Fk8!pqheF>1Vfppp%lIk+D_IJi_}s8)UwfPbe`wIO
zue=eQr<a_z$Cf;yPLj9BYtjWz{DX@J>#UIayY0iC6Y<!kwfCAHy``KwHw~@^l(@s>
za)p~2?wcQ5b%yAUqBmHO+o$%|5-wO!t?K6|V$F3J#qYk3o_g(6PD*KA&h-e0H|IVN
zdgWbC{gy<I{9^li)#c;+7F^*Pd5J0nJQM<cVYfh3)l6{*=@N$XG!09Whz#-lb11PU
z+t6dXKF^j@?92fh_-#oYY=_%hz=969+<PRPIqHZoB#_VjB^Bust4>Y;$iyzB;|q=P
zsnY%Sv8VSGntA+@IIs;PUpoiWvxUIn{niQ%kSh3?Yj{KtuR+3Qc8i(P0ZyTp>TnZt
z_zkec-wmq0G7-if>~v0#=}a`gFaia(cA|XUQOPF!jfU4JfaQCCoYa(6rZIxI^y_8G
z0!rF%3nQSqYcOWTTK#poL^$8lv|k0O=0m%MWM$c#r&AZly7Q?Orq#m78n3qvQnH)W
z+nQTlDXH^P()FA4TPD7l76l&ODqLdfLQW4<LeQnvsM9c5IZ6Vutu-Yon!a!aESk65
z^t2l0;_BTzM{;%iX2WrX&T?Sb+x`v6*h)0N6^dz+eznWIjfv?pqV$W8G*)gJK4}0d
zm)m@|6PK$6)b2tkyk;hi77o+jONj)*zOFKF%!YHl*0XLfFJBA|E-CfhG?LY~-j*P%
zmo%EAIhNC(#_@Y%QBUA{JO$axZxz0-Q)(Nv8qRk*k$mzKzouhBz@Hiedv}u{d%`el
z6XOETLQy>Hk}Y!FBN%@W(RMb!^Z0jH279>o^(d)}rQb=oWJm(2;ATl67c!`~Mfv;w
z^|6xpQ%X`)63>K~w!XsR$1t+&Lj1{2ANPuSzZ1&bek`MJuJ$o!(@JL!n3Q=x*K0D5
zr;h3r+A1kV@dEY(SH@)I<g;q4a%m`<j~RE#O+ZprMyTGFo<7Ts=*PW*ZKYvCAMf!;
z_z1nz6&51&@*vggY4ZJ;()f_Hhv4aEOd!9W$xai{PS5aHOzR1*m})Jpt!aOViWKgq
zC^gR2uV<p=6&oa1r4_QrZGn~o(*l0dQ5RJGYaV(9xDmg)jy4cridVnJc;G_tV2v$i
zRF>ppR_C{;kMRL}Lk1WX6ZtonbE|^6ZnV`6Rc4Z|@NUCu-o7zbJeNc=5^v|HjNU-c
zhGz2JCVsr*B_I9*s*kJ^TPn=+W@erFRTc|l%6^jYjwq+40iC)t$HBLPHbgPQ_s_qb
z1N|)|*0;;JHCaLYP`;(~DN$Xcp5CIN#P4vOsxMtAFrJyj-HEA_3zOCOqm}3Nya8Kk
zHp$1P-2KoM>YqNnhc&rX6+b@)31b^}(!|HL2&5ZjK>eb;Ag3BMUFg_5JXL(y7?OA^
zeEi?h5KbmLFPT$p9SYo=(1z{Xb~%-*VQiRNzfSI&L}*`_9v6@ex+J#(hZ56xp)dLb
zGkg~ALXl!_e6H>(Sx<zUM&qKxrVt@~da0$0_(0XFC|7|iixY80Yg@-dS8b|={b^yE
zO>z^)Q^ol;9&h#wvbKY`SC0x-u7DcjAsYv3_x0McP1f8KqJS+<-1~%kz?q-}fKWU(
zqU1X9yFDzb9L$=t9~MhpZG~d9*3$gs`Eb+ILQG&m<ulEB-Z&hvAJhZBx)Z>`MzALa
z;HV;q43ZqtdRe8;zlA%aj7%^v08@bfyXLs?8EzfyUU(|B5|M4(E3vp^dd3m&<F9v9
z6mgmkkEt<8@PrP2{CsPc5DQuX3a&sO0a$C{Vpw!Q>M(Hl?O*E)zup-6B%DRIk{eG^
zm~QgG7ku4%T2~>M3qX(EDA8i*l<8^H;<@Xq@1qhVYwUU)H{UzWJnG7!7T^(yMkXp6
zmT$z)=@--VU>fP*`0WRtJ}1a`!aqs4r(@o3`@5NQyF+niPOZ4<M4BxdUdoLZS%Bkd
zl!~dpGNw<p**sg`dn9twN($A?vf8c(msz~7$(k=)x-B+n{?T)P8(-)HsnuN>!m?Q)
z$svY%Cm!F1BY{TaaM}&8jo7;`W`r97kAocXNZ{vlI)7?>`EDuy)qs-cqP;NOQV{pu
z?rGHFz(x;-xa;M8l_<MW{*b%F0(OiH^X{^}yB#RND=|%Pn7S(93fTHZbriDpou8LJ
z<F=Os*;B58mRCNVl<OXrl5m@-7MqcExhs`om%2?)p9Hs^JbuZfgEwWp+llRTK`dw?
zfKMlFnI!dv32r0$xEN8SA`elABBy<|povx;6eSOLWT7$nO10{bS+LJQ-?KrATF*fs
z(%8ogmhfNadGJcWrmJt?BK^e_7MQTGrr6e!V8?z7PC=UAOA(hKmlyHKCf!?|5SX5Q
zjBxaK9Ru-2mC(8OXMQ{|-ZW$g%r?|yyF89jxfgX*W(u{+2TdYYQAqrt2KDk;uKv%t
zsT)TbV2kxf{eZ{^LQ=91>xP-mzkg}1Qy)7}w*h}YA$%8F<;&TtD;^Kod+vp;zts79
z30>Y$Cw^lj4XBzu?e5qx{w{mN)#i~11t}lL<f5YRdM>C4SWOwi>q;OR4I<##q5<$H
z6Iv+ZTPBOMCU*c%1Z_?ZrSBTn8H)4qww+hdRJsl}%nSV8Mj=iqXq*yd&t)HTP*UOF
zlkeNbNTWmLa}wAqzA)+!;A`*(<X@H3do~|O91!n4P6yLJ&o&&QQF_V3aLmW2L#Fwb
zm}0V-R8!otFKP;JIk0I(@~49U{0+K$S6>NKjR3yz)arTGq*_}<;3h=oosz`1PPZOi
z#`da0Zs&CgPA{=eJ!`pZ?jgb5;>zgD8rGf!SpBGt@3NTHaKi{b+Jk&Z|3)8U<8joU
zKBib6)s-ryd4+nB$~$T=G^K*_zV8UYs1ZHauHRs1M5#88dRa%klg%l>U8@woZPcNb
zuKi9Tch4=(&OQc3AQW$UZulkKMV4x&qHpzr%GDzx{&Cnkk5xt-!xa|Hw+%Qcb3<92
z!|Fd~iJ^?=QxS$=ScwU@VHjNaMypaL@a}~gjR-1t<x#7vLLUB#k}xrBgNzD{Sy|zU
zW>Oi(4zaE#(g0opX(<9NS*g@}`T<0H5ixnVW6>UySC&+OcbLn?JN%s%<k3U3`xVp7
zQ}~QB!Gi=FQql4f%>^apA#GAS6GNx5enN*lBIIdOHp5`AmC2gM52<%u{6^FNi9TBX
z7rT}oxAv-(1VLV>bEmEf4|_J>A#P8@DVX1jh5O@cVumm__nwal??v8r9uQ4#a7A#*
zH^@^ept#Sin79RG?8#LXr;^sQX*BaxMxhL{QUl){V}TPK!aVVSNXEv4B0xufsOVcy
z(FeS2rj$E!&hRlk;(of&N;i2Vl7i(<CR5R%fXHi*G8Nj?+YEDyMnf1A*YQ(Lv8Nio
z^7liJzRj%c`g-j(4CvGBroK<8%`IHfzGvgcpq`wrzNIwtIH1cRHQ!)dQAn;<>(Qxa
zg`dgmnDN>sX5MTnl!BS)?`(z9fPhy~B*nU`;w;-dNcRdaNBsHVG?m$8?jd;*`Gqz>
zB|k%{-w@u{&Pqh@>Ju>U44L3PrlMbN7`y9hxlH0vC!BmlUeGFt1iJcXl!w4BQnkJ)
z9BtJNkR_Mk^$_xV)rtdY25I4s<;_JnkYkHj%$P5-thq%xvqd~ZF+){ZV=<;CR!oKD
zyWaAQ-~_0c=e5b*q_T6$)GpHVhS@e8(~i9_M^PnNh|7Q2N(^LJSQ(j&&l!&Gxb><b
zGH5Hqf*xJd`uDF!Z%`OjbcIAbVyd*UgjQx|lw{xnv*S@8P~g{BvE<EEK___;R2mt?
z*53^DHwYSTyF_sr(z{Fw1r$>a+tsZ2op0h?FpDrK6QOn`8z{(jTQ96nYRzcjojy}$
z)ppLIZo7yz#+pIGjgj64kS2zf^~1E@oKhv1V(WBtZGX+D8=1rYw)C#s=$O_r)SJNr
zMW9+0qpxSdm{0RW*7*a?nHxGpZH=&uPwMzTsh`RP6nsYI95Wbi(=&Dv;#ckJw`>+v
zPlLr=oOhndKmXO|DVQ01p>#gOY|J;3fJ%$6vO}@0lMK7ZHD+_aU_HIR-WOBf3F>OV
z6{r2#{gf0zj_fk+x2J%lv%N)Z2J<^oRkc)C=UbsL*o&;3^CjJ+jC!x{$D?8wI!DO`
zwHSqW9~@ezL47CWUp5cElc%lG>SqP^L9Wx>waa%9C@i$u^!Pn#5v~y56I+Zibn5#j
znA_EdXERE{^Ld?WfIH3-3*@fzz-^Mvu_(mjiF-$_3;Zc4hwj{SwA?7;&!)#A<k0~Q
zJx%TqtsK|{B1}P<k5W5CtAGP%&bK^6hWZgC?Sa1(#nm|$S+DV<u~h~6VcMgN-bYp@
z3-&ksuP1tqA*6&nDK~VMM9Zsgd`o0z`;N(YqmqXBDQHOLD885Jpjfc4f`h2p37xP-
zrn!c4;M-L5eH-1~HQY_3B(G5m_-LBVgcfolgG$t#VU&uDm;e*KG1^8kn>9%>Q+}AA
z(7h5a^GwKn_3<Kg50dHnyLUGF7_;%hI8Dm=+w>&|9OTmxjiDeB0?7pDSSRbpT+RGj
z#N;CoYcW*#b>={w!u*QZsE?*2)>Q>I?93vT&y7KpdG@o(tgcmyDE^={%es*+7H85P
z-6yKm+sgYa5hAc0ln}#8&5SYu^+X=sXXM!fz%}f_*R^bfwd2?&<v3;WzDx)Vt*WnP
zrIN9va$mlB?ro)hf6+kigP#bbdS5vLWQ7~2+VC{@>i8=FLH8y0p;hq^dZQw>h))vo
zgyyRH`M3{OfL^*=)Bx0Ac~zpmYdVFHPY<JCcKX>+0l!+?Nv@53)z5GV>xicbeFf)F
zv8vA!T_|LS*mcar+9~w(fA{D<9pdq~*>#f1n7$)5AC^e3E<=|jm{|ng<z`m`Ib|Uq
zdx@fqskboDlqa4^!I?vCLSI)i_mnn;LtgQS)tUq>y#lDXUBZLXe22ZeB?>3BdU;bR
z(Vy~=A+jn@e|q3>o&0)>h$n;^67#e95g(I>Ou(kXX7vu2i6E(L(12U(lX+EAtFS)u
z$5PIWA^D;?`(TC^e6=geEBJRt9yI4|OyP_jveoh5Hkgy_&b(uoQ@-Wn_^30NSAIrS
zO3vbb+a$}6yMm01A2Gb-ef>?XKjZl;@=W~1As~@}wP{#$)=cr0MPf46u`Ccs<9+_d
zCt(x_7evkp&ApGkZondwbJSg_>@6yw&*?abt(EM&x(#HxRzn75p=zt62>Cq!BtGJ2
z@<plijMgB&*KXP53$r2ML4UaPkWz#ENEs$s3v0Ib$x`sv20@CFdR`>0F~eiZspAWF
zUyiX7?peB~xUUnI+U~815|$tVl_+U^MwCKORF^yM)A7|&k`yW3_E97oy*WdHXV#?B
z4R~xKOTg7kXUc6vQhqoYH^7022wDF%0=%2ZT;ShCMC|eUC_9LYzB>EiT~?4ydJ&ZP
zJF{`N>XgAL;p%>N!Fps<6LHeB_{iM{$Rhd=vn84=FKohV^mrU^biBnhr$irMy<ZCD
zJ&8ZKv-lQV^)OpywdMO7Tg|m7H&l%>@pv{LDL>NNF15WUW+h|R+0y(mAQ_6tFd9#`
z^E-DO)vA8QFeslpHg$D6S8<$qmWYL(yrR6BZmz~_vbq_tE|8lkK4A46ZgV-3MD}$F
z0}^uAbMyYoSQ$;O>S>Y-`PdL}_Ff0JxU6u}V{-JQWhxwH4~1X7pqE#D>90xM6?0Fh
z3mAXNB)V!A50nc*+xe<xsC=y6njASZ%@T3SN=-i>=JRrNlbVw`tEF^Ea3b(KjWJ;Y
z%_Dy+Q8-g(G1jON&<@9yRo)?RkD?+Hy2D>YX5z*T=Mk4{g2q62IjxL|4LT^RaK*JH
z?QfzQb?)QQfaaXltWB4jbb`FFVTYnOAfCE1ljizF+YBO?uo%%Vq+XiZ56aOyY;xfX
z<Jexj%9X(pJ0}|4`@)zMQYe_jk1x#6kM*TWBcy4@6pkr%6P6~#6pOd)r%hH;<HKXK
z!0cqmG0gxhE$f--gx5)$jz;KA{`bR7SGcw_rM@`dMgXU8?k}dxHaM5BGkH+IB#2Io
zisX-sp*IHMR_n)RsAPrlK+LgYH{A4)R4KnKn_TGO%mq7ao+)inw4)$V@F!8m?WOmD
z79M2J5>Pb5{8%lQ`xtUebm^sB>ELb%mtjp$HY2^`EB9^TUmB!TJTslXvMVF>%zXuG
zbk#;zSb5AQ$1)T6?CVdW6Hkfo7?rvZKM!>87m%ur0;W5{AR5@=*)jpFp|d1=3Zxpl
z9@6jBf1}dDIr1J`G}LnOT)o@ORJbRyLy@S+Y>08>btyJXV+$PP3yVQr3IK9-vc!`j
zO@@uB#3%cG*5^1hZOY%u0uZa;@_}I@u;`ql1XM39=M!zRxzw|1`~Z7VZIRS$&&*)c
z`ayS=)!1=$ML=(+?dlQ0A)kyROPzy#iG2GHinUCTxMI7V4fKLYS@+rmVok1akg1#!
zB5UK4u@CyZ8`Mlrmc!jp7ev{j)W0cM{dsQ}<X-#}*-i6($Sw617b1{B2&||`z+NA6
zkJ7hDD^;+BymME-c7AdD?CsQ7poTeZoY@%kBQ!7)-Ef@96VHQpIqWwBR<;8`kjQ&P
zJP?IiY70I^-#85Ddhk6wHmICo<b!5DO+epuFmUQL4M~lm1)aVKqEp`0*GH!wyvKh{
z$Z@1I&7bKa7U9ep(Ms{E1ubEh6W6jaSNhX=Fi!@f<?CF@_ryK)@51dim8Ga-e6>Qs
z*w0JPX48v^j&SCc9z`*K@+S>>D7GsAjj8xcujS<~PVUUAe1)k!U=4A6@nLhI0c2c_
z2I6jEQNrWs&ADrWiv$tAY_+_3u3i-Th1mpz$HInqC_mDY06l)YTKeH;xB{@>!hN4a
zLih_lFQi-@IIBGo$u0<C(e%W^9P$i%un~N3nSx3##a#X;t}^0mcT}X-<hv}umHs?T
z7Q+;DS%;|90qB{=r<_t#CMsObm&bzDmLKVmJ~N2BDW(P2e9!BfjA-D7_)({Rtyru?
zosD5iUlVE3C8?Ifv0zwSXe4TPRtyhP7@ZEGrQeL!L7+$~{SfrAVTyQn>mQpAT%Vsb
zx*sRH7q|dt&!^;+^8?zc`Zw7uaGNr69FIg-=t#gyh}=%`LA&S%^!S0idNSB8-3G_{
zVN*2$GWlH{y2{)%;ZV)#F;T!!zIE2E|D=~Ar-JFkPvZzzAluTbpo9BE)ku2-k^-cK
z^uMU(SaEshvNteJ%g4U(S~#h!Vj5`R|3JuA&^BXb$RH)UH*3uWPITgrpCs|}h^Aw%
zw4G{66!vBEgV&!`f9y$X>;?(e!;^XI<uXxk-<i*CQUWrO`2d|mnQcz7%@2Fy-BmIP
zlLfw&Ls4MzyzDX-oG>>{SnLK1ud2lYF`eLg`W1p03F3JJ9`%E~wQ(~s1fnZFzeibw
zOr_z;6Q&H>A$czqwVDtT7A`9J!RDJ8pe?d1Z6&XF@l}N;)X&zLuwbHNs?@&kO+yne
zX~nc?F&NO9HVaYMTy!Zw5KIbvdSc`ta7z8~ipe-d{tLHXBLUC-l*0Cds(o7QNNh1W
zOM6lObV>uXuD*wIO{u*Uwp>vXf(5~ZRfjaap-ChMf=P@)ZY{&um?0^4=P#|7d=-R*
zO<T6w`j^@GmKmT0R)h+%oEl60F{cS(V1=23ae<_#DS0OcEaEQs)i_ouY9fAuNZl_!
z3a_sM-SgC+-!`*DFwYJ<$bL{aD2Pzj<3>$*)>*ua1iSgjZx9}u%6^e&6qS<y9#^w3
ziluK|EB_+R=5Uvpp{Za|M)Kq#b@Y3cen9b@DWqaX`Dzj)$Gq^wizj?0lmrhRIPcOH
za8`$UD2VS=RZ?NW?j-FhNmXm&i)Iks$@GFVTggnt*%6&Gp`2TDQAzs{FKo&_O^VV`
zk`}7_R#YM8DWc<%&o=K+u1nv;big{M)3C7G_O1NbmveyuaV&m(4ce(b1}XF@Oe@+z
zxk0C2``Dm}t6g`l@LeLF3<Fv6i*947fu~(w1|9qZ5;^?2&aQCgIje;{pc6o>{s76m
zF9T1tFMl8xkY*#F7_AA!$C48Ki#81^8qF&2j3y~qzOtU(^y~weT5Xf{u8VCGe&z$*
z_L!mZZ0|zH`|!#g1U?*xOWmpixjfj_uJ<0(f)-p5P#ho_4l<ep(r(i)FR#F_F_b#N
z$zq5=sT-uP^1;KRFUWv<uH}*pu;}A#401(kN3<Rw*4#e2<blh;vLiD8t;=%EvjRJO
zW$BgX*G0yc;@I#PQ!i4J1*{BXQwp$_E!*DM*q|dp4(|3Ma*--!8@y!4=SpUV`(%h>
zk^Ss1214&!`p2)qxT0nSeFbHs8-Sugm=TnlszINBZhi_ZC~%TC{gGo9+o$2wNwq`;
zL#!0;QDJ43?DUVZhV;gxfz~97eH^_#2$7OrwBl4^4gwuaz7J_&dToZCSy>UkbTbT{
z$odQRQ0{w<X7m6r6{NWH(@Yp5tzlR&eBaBJ=Xx{Cs3qc|_g4womZu}h&9gj8=3OF+
z8C(*jFh)Q1X>z}^P5B?RQiUA5{egR?;)bFW&q7P+o!zAG86gcp7S3-L<K&>)d@&x_
zuqFh!`y*tQO>HvfxDvZs|2Pxy=|TmoaGz0B^MyqZh-H!QQ69IRm(Trx;v5h>fu`lf
z(Ah}AZ8U|wr`6P{`a{86D+Ftsb_jfv2y?%Lz%E1`Ul=uY=~;|MH27o8F6EpZkK7X*
zrMhnynr@Rfr!2F6LVc=l>><}b4hizcEqGxCC%4`h%AL{pE@t=YX5ZK86uP(eQg@PN
zEhwah-mP(X7IE(XJb`G#Uo0XT&5gOSb?_-aih@|~GR*dj;8n{*1zZ=gHe|ZgTe#mN
ze`G;L6#8KG3BLAku$4t~R8r><jcl~_H{i%bJVNVG_3rz=LAM>qcvDy|MZub7paWb+
zz8br(R?0553xzQS?sqS3svlHiJ85c&Xame0bxS%oMZnGJR2?d!qq3j5sK6wsy4)Fi
zn;~2hwBI~tU+``i1*q4aQW1HQR>fcED!^Ynp1m#{j>YH-Tlt)T&Kmk?M=f&zg%eVo
z1{QT8;?Ez39&u9|rgR_5TqG>TFhBEvsf#0*(fdV4JPTY-8%Otay8Ype8^LglEdp}v
zWex*Nst3WxL@RP5q5D4Azbg08xR8-_YU%O}X64?fT;52S$vPMTrzpg#&eP`tVh`MS
ze49i(h{eQ_>4;ueNDgC){#2SK<zhLj3H<$adPe_P4PofBoH>N)#G2;e*`P*)^~qM|
zft4%2BteNOd4>SSG=sUtLVX0ny~ETpC$IUq^Q+p_@4FrelH`S_G2NfAZPcT|4!Pzr
zbd`4ETjTz5mqw5KTMb_(NT1HC&6Wn#9Gf2S2sM#!JaI~q8hZVzR3q!h^~`I#@nO5)
z6~Gm^7tcM$Wued2##pd#=`xIbar#T2s98jGRFn8Dbp^kj8a;S))-w!P(v9AtpES@s
z@sNzC6Z8dsEdEI&edygazE`R9pd_PVO}z?JlfIW+N-=)8st7?5bZB8$-kEq2!+vSd
zOBTE2B_^QseIHi%eah)e;Rn(DoZ*?ImY9@nk*9b;l>@jGE85?JPZ*lPxU4?}j8|+9
zlO1G}vB#VlNUL@q*lCiY@iPMwU@!|~lwI5tu-UAkQ=wvm@>d&BVdCWkaAga#W@Qfe
zDR6Rk*3y2K?7+>$vD2IDO+r@F%I2Qu)L3*IP@MQR+^4`nV_+D}p5A;V((eu>{=sZ4
zS%{F)-l=!1+$CG4A{JqomnpE};}T7GVJ_T7f+RP^H!`Q4?5GgC(ChZ#qhgI?p`Ni?
zVx9<MaAc=uHKiMtjDz!u)^SZPQ_rWx6@fP529I9x>a|okL#HW(&}Rpjeifpqe&^aN
zXldsays@52%}@s)UD2#P8^SZKxS6o4>U~qP;bV&)+XTg7LF1{e>pJA~+eD9()o-bw
z^0mM0ZLQ})>K6NoW?p=L12*C17b-B3B>TN>IkMAgu>dFo1d(w7&8eYY^;AB^>}Rc5
zLp7Ybxe)$SY}A9hxxH$Bep?yld5w!-Exy7Nt}2~{ipY@FhwWc~;OvN$bY`nt8v0Bh
zuuW<C7Jf$ioG$aA@@?+!%6pvI!4IDJY#$LBX^SywBE`esU)k@ipuXEV-Ykq<?<-uI
zAfoGs=Wf)b%8aW<-;_BoPW$eVtbuY}*pq<-tQ?_?6tJKT{(vR^;8J83p9om~L$CFm
zNjiKc?%TX)I`La_OcUW20wf4os$^ZEK6?^~KKw*9(%*f-rcM4#1SO+xJg!CVoXL>H
zUvOP5L4|l}t&_@|B1<aQpiZz&LBVj5EMm&ixQ||>L1l%I<f>s{Xv@xPnJZk5lG9KJ
zBXJSRZvNJr+lQ&lvd-8<y=L-nJGtIERIh69$iYPg4%`9(hqGWd+p<XpNXICT>JzIb
z_tZ`A`=lapYMeo?@w*CFyIyh5nl=jc`-ioOcm_+L{In@2d=zxI_fYw#!;J_Qj9K+p
z-J*p7MH<*4%x#IpGS-dl-jq+!jn}wHZ&=QG>^K6c_#x`b3<VMzi0C9TBPLk;-6)Dp
zrldk!O3RuBZr#$}OmISf9BWw5YCVe$^L>yW2_Fwa@gQt)zh9AA309v<3hbZMiN>{5
zqx1IU?UEEcgCPy84^G+NNKD+sZ*Lfn<oDIOrKatT#Fh8);Shnd)3k~w!nyfRXIL%O
z-Cdos@~J^Kph34v6&RQurXl~xx*FT~)CGUGs&_(Q62@IwJF5#?O9mpg)L9JV(%#cp
zzJ;dqHldRGtb4zj8#S~`Oyl=N54eV(!FYNWa<!Jq7SL?b>17z2n1X3~*~3v*RS~us
ztkybK#^l85ao#6kcvYXV*neQKea^1@6p}$aArYBXRUA9J-=uldud0+j@IysO)|Ze6
zQo4qmul^x`i#$}9(VY?U(wIMg(AO+F@RU7R7y<MuC=(cV)FLrm%whR4I@4Vru#?95
z_JvV}vtFH)eyw%ci>u7^TkXZ$nE`cr0`IoZ!V(p}FI3$fOwWJP)oD@h5rSk)=lk6}
z1<Es>Zz4d-LK8zGeck%3-OF_J@jV6H+$%*lsOBbJY{M;tkz7pagLJweg|5}YII3v-
zVjBV6#&6-BN`SbTTf^hnKD%4y5|6#WDIQmOksS+G<VqO1HgLC+tr=FBL*9W*fp;0I
zcLIjxT$eAvPt`v3gNS@)aJufYV&O1E8pvOyA+;Z@@@_BB%3zU&;%UX#Y$#e!bOF7>
zhO0K>A?EI^IfbSmnw$#L>}SKVxWsY}=c#MVgyc(4I;M$=3C?)a!G_Ch$!hAW+a=|w
z+;IZ(?i$n;RT`Lrm5K>7${yd1sV%lNP#^#2_=}+|dtU#gZ`h?Z`c%Yf_F*OCuNU!)
zaz%1In}t}BV=S7mJg6JR@|`<)xzZ0djPxGL@R1@_)9)dZJtu`uSn+-*vCBR$xJk60
z>RX_=H><L-+?*vcDT(jLd8CFp{guF4J&zmj9d_2bSVJ{MQq)q}><-Z>&o)v_b7$78
zkwe#V_rbul7Phy%q8R}s3|C;;HG52MFR|nFD#${h35sZ`Hg<k`@!0osuEjFv{pkR;
zDSumMOfSG1ay9WXs-8tTHwZC8w-r(uwZr`x%4gridL<MpsSbq5ICJYvobtTp3_m@$
zgAntG;5^MtnZaRzFqe>B*vFAU?#?}ia5QtsJz7lY;c4z!;0{&J^iEtNxU0>nx@3QC
zLmAg$z>X9<jff+>Wb(jiR9c;kc=s`CiVv#RHu4IkfKD?Ip<J*wehf)GZ~O5z_S#|c
z3$r2RgKuJ`dn<kB8lSK^jmGLU)LQFJ1b-U~e{53!bep2e;AGB<d>jYfLPOxG4-oRN
zSigP#xsEKV=II-mIAzw2Az#O#xjevE1a-W{)!1iIvc!%VY*&V@c>v(p_EFJFqyzkw
z+uGvvN0Yr>mPC;QDc|JM`vlarv(cQsi=q`0@OUN$NYgR;Zc5<QFlS`r;@wrcQ;$?{
zx?fLKu}}CVn=oFR3*q+pTko}iW)xddiLZ#ntgYo5m^i~Xy#y2yPA(N$^DW6htO)na
zF-SxaFr%8$_8(z>qS84VuTrd(g_}u!LQa=R<VP?1D{)hfy7S#Mj<M~OTXuHS{U*Gt
zpa>AN+Q;qdW%L~ZJoZDu$W4R}?9r#NJWTkbfMEZZzQq-yQB*G0^Gvc-^6lp%Wc1sX
zukz$@mc?>AQd68hQnIE2KFM0<U$?=nsgsK){QFy+?}}m8q69p?9Hrel53i<3XKbx<
zuVn6vRMKm@q<yqVh#YtnN@Pg<vr+#S`hmqgi{;>`O4=USwXIdGRDJ4xPlE+w#?#l@
zzsfWH_`w7;XB694UMaHdBXAvpySLQ9$n0G2RVljbw`sr&h!(mEn70*u-mi`>yt-nY
z8dE0G6sk67BgrsFZDa6YAl+?$@Wn6e%b6FPpy{|-JL!0guhZnA+7BLU2q1N}u2_^w
zPEKjc(7Di`P2WFyeT)r?Py9x3p53mvu5(`{IF|0muVOXSqc_#ie5;mpqH$`7Av%t#
z%*JKsP`fd>?}zjodgF3oJnN>JmY3-9=pe@|{h(IkAStK$H|w!A-(k*rv53J*(#-M~
zpWjJ;O{_E|vZD7#ytmh<dCPAxLBUR_t|>{_L1OcyYKZkd1!m2{CD)-fLm6ufn;g1*
zmD+<e`hJI?H~R9~qARBK+pFE+nCX{qgEJm-0L)(NGoGm-932ew1atS^qbV@<lnD3^
zm{#K05>w?X+%^Qqx68=Qq;BhmA9m(O;=KLNjatfI%Ijnl@^)Qh>qX@28ioR?i#XG1
zP*1mMuT~_8vuq+5;;9M=;*(;ZalwuQfBf{eX;|pmeLE5!jzuPMq7JS1x|2!)rvOts
zZ)tPq#PBg(9g7t8^b0~6yQ->{^2A4*Yyq*V7SEI@Y9{pzE_4%*BtHVK-1fBbHC07A
zJ*7TIIH3`TV0T1MzBpyv=Fl$ST^Wh;$(3`VHLrDI$Aa<8+KGJalM#v7?n6G4lEQen
z><0sMm~PNr2CqfXG#FKgztalg#)Pe~{d%_ZwXB?<P_1z}@GP;3D!v+&7|zxSNs?UU
z#d?;CwEIEp%VgwiX5O-^EuP4uMs`sbhUfN6BIcOUIA=wS^Px4@_R{?<I;U5!U;{Yw
ztSwluvq^<KJ~Y*ZnEG>x*>!KBA2O6ZDk4`4te$z@zmr7AX*;p9zK8;QB<plCf>0r#
z@aM{7DGN?M72#0j-jm((b~;^Z!&WiM7c2IzOA&N>Cy-QywlW``;_}L=P|i?&YXf+<
zSJhyTZlsq1(n2zm#89<hvK!2J;HX7E-{Vkpb8@eFio3WCNS~iJx*x!c2C}TOY7PLx
zEDwdwquv@0F&$D2c?DY(B)bvN*F0fNckSB1xuSxC-P+~X<URN3Ke4W|Ef(1?FHzC4
zovac7Hwq4iiSsfB@`DUk8@?&keHGY?5bhVTXN2NR)&_)8b?SrAo+zw{_eOZmgc#O{
zWWJ<LQ#4w<7|G<l8p0;hvnW?cu>8%jj<=<JlL*K5qYLo@T)bRjw5`v|udLC4Kmdyb
zg_fa+8WDF`w0c%a9Tsa#6)OkJypQeWgm7Q@`_G`qR3R^q1&YUNz7kZp&ZSlvz%h)9
z)PkW9S{HpxsM^K-BsT({;Zafw73;2sTCP67y6JnCR3gl}=xs3(PIYRwA&gya32O?W
zQq{DCX{Hb0Bqsuz=ozu%r~>Znz!kV3h!_DVY0eb{d-ieW=O`}O<NPWPfhhZty>jkx
z?@;+{3nm59d`>DYFEu{7Umu;sMJRR~5AZtsT&LE^&yL%5K`S-i3+*E=>X?svuRvZF
zF*fB~W{f}z!f>h`4__+*NkB!#i6~{+pfk&|5(>BhZG=61q8K~3|64mp$RTUZ-J_Hf
z%?Z@r_eQ$Fyo76%ulf;G?P@8K0Ecd@$`m5x*LT{VXw*1LlCkxyUWQbqr<yY~2)K8x
zFST-$$QlkDpPUU$P;E%%%qrf+>aPsgg|+Xv!yZx&xekdy0w6t28u&h$Z@lP@=E`TA
zW^5<>Z5xlu0R!cj8fEbo8@9f+nqfZ)D-=<Fr|}e7%h4-wwg0U3Tg1UJZoI0?BT>{g
zVQ!XB6ZD%MZo`iHn{2b8ct3@D5%lzwlAtrw6H58*Z>AL6I$Hbv+W4Nomf0e+KPE&?
zx!;%4pla#sqVohlEHg)B%KS?0J?F1#H=q_7V)9ULCS&9ar{AFX;AGSbLZuZVFVw9k
zcS8<$%f}}JSX#7$@IuwiMYszxP*IGZ%a10>>OFdhWCJXtqWsciylc(Q1Bp&_O^?$8
zfj)K%T<BPa^1*3?qtAt1s*0GlpYK?IF}aR!)fWyRMsROoZ)l$5)VUB)@0>XQ+~S<}
z-3pSDpp-m9&T#YoI+4U((odiWD7kE(vIGB&9^Q)g1y74U2MgX`LfXZyZDzSrT*tfZ
z6$id(b8TLJJj{UV7tBu>72cNftt<5(xn7y=EAi1XY{_nESkTI7&=Ox>3s^}hSMc!T
zr{HlJb1m2%**NSGz44gaXey_U+u35pl@mEF{}~OEm_vxvK@&|W&nyrG+2_uNsU5c9
za%4XDw(S4|$1dqrZ0q*-d-W)dccSog)EMKL5#0WVw`VPn9QBW%l2*DVwK8vJY9^)n
zy>qYi7W`LCG7mycCQN4Z#HK4$HXDM;D96=mHJS$qXKgPzVV_5YL<S=?TD-?~_nU!w
zk(-o|pC><1EhTcB^4_~$b=&WM#tM$TGH$@b3ncpeIOfWO3w58q*y>m#x7;->Wu0Wt
ztc2I{a*nYyVe*;ida;a0+4I^f%=@N%*hXAz=9fxW0p&xZtuoFTxS7&i0D?vW6{Qlw
zkP7P7WB57Fpv{f4`$>Jc4WyyRYp%@s#QvN|0Jp`MBNn29)TNhN8@9osQ0KJ-9X|+b
zZ2a_!NSmx8Bh|{1Mv1y0PUn<qj%+wu=wsVPCRPjS(JmXYWXx7!38HfEr&5Dul-Y#S
zwEK=^9EfG|>;wor>^EBTUyYT1)me;b4UK6vEgMpoYZken+U`sL?T9v%60E5&kKmpn
zDx(7pYD%qW^RiMzNS<+o1>zMJ7H$&G>qPjf;~hG$&Vh_dNwEs-ewt^)U!E1lrma~;
z)KmDw^A#Ixkn6;r(e;fyJ$?RX(~J%u^8-||ir&MVW+y4bY8_hLVaqj}lvi@K7JyqG
zW0hJ(uAWNb$==3wNPG0~U1In%mSoyhpX}>)hSD!3bJ7r0=FY4f|Li^fp$-Qf440lP
z>*o4Jubt}N(iasrthZH9AVp~=?%Tq5AzCyX!tz1=6#p@I`QT^v-##(Bvd9qnEEcbn
zqRCIpcw|x`ibNJb;`@Yk-rFB`(n|~Ls4ko)#30Gsb2TvSwrz35X(CUA^`?H&K((IQ
zJ#MFzyZL14j0o4h!&sxIy-2E4Ecz==G2_VTxMn;<(^u$a$(3iBtp=+0_!ib*2t571
zad8^QTVf-(_K4sDA6h@j{-+l}F&G;u>w_|_aG6t|>S2C^i1B1bzAW)3`~4Jq3hmBX
zZ&W+_Z7Tj<?Jt!KqEiPLU;0vQ6i#$4W*#7TxEFD%>wdOgq>nQ+FA_F{%Y5O=a{8FX
zY=Ng<`9x=3KB%|)MUlE$udb;zB2W)qyp_i4$HV`Jt+S4bDs0=mbT<;x4bmVnbho6^
z-3myD49y@QLn9$6tuz7>QUeU#AT1>+-3$(#&9}~3XT9rt|7R`s?ETbzKiBWNR8bG5
zQ(vcw_$m~!O>k)@hM|e0n-hCVbeoj2Ty2=xzSUV^Rl6xRd$-3}-&kGwJL_Va-Js*Z
z5Twu{t!uX>v^Wnif=a=Uc)%l$RtwxMd+?$*{B$5g*9y59@PE0G-?wnYLF-QF8T97R
zHeKwJTXJ<(3Y&5Cs%9a7%bG6w;eu@Vj@H^{HQixoV1cz4r{1!jE1gUt2opuiBoI9Z
zx|ftb5B{nmWO@)5DFnQ^clGb+>Ki>ff5H3GhpR9is`#fGJ+0=>m@L$r@0UX35WF~Z
zh1SE_q~XcL9s!Z5y&IY_x#n9>SC57C*WaI0M25Y*^)$^T<D<j3wE`|B4yMm?bt;T%
z`0m=od(@lKYXWzT7H~C{=;k9mSR@BT^`o3`>3PwY<OvAPGXG5JmC2g^(kRP0;{>N5
zMCcG(y-HRGBkF#;q%?B;|0;>rG7}d0%;QoPB<w^73>*9^(tUW#w2VlrcUzS2wP1~E
zYiCVL*68Ts+Lv$4u9l5aU#RamL-x0;3=*DfDCdj+PA4TLY-Ur;;coquaFXV~K|E_G
zdoVe*lf$Ul7jy6Ttzd4umaWb_{@q~apO6zK2~SuC?!K~LoaHV}U>$7+Nj0UjT+<@{
zoY%OkZyVj-nT5qtQ$Jj%EnXWod)UtOpbZmYwSNEpKhVLhUJ_z0xu!9trZF5It$$y#
zZ&9@Qm0IoFh-=?`0`|HqEr1O~8Cm*IUK0NCNyKYy7IPKVPJW6f(N3;&^wfzyFDo87
zFel)S{C_cs0*2^8U+WZwc(|5HSqUfS1GjuiTYx_-j{>GBx`6wCV!l)~sDJ0&%{7b@
zLK)1yPFoO%E?ZU~E*|fl-8HBK&jV)tZ>*x7;#$M>oQM-o55Fk=)3Ex6iID2_fS1{i
z52gBFABqA!M<w7bSQnmNpH_?aIoQ13oZF~+H>9CB6sSN+?t$O`zj#R~G%ONZM{=`r
zH1PSCnkjK0{b}j=#XqCF^R(?sUndc>#s{~yL(xNjyS%am&;E0<M?6gB-BJNYrE>-u
zv-wg}R`r{d$2Y6;-`=c>%37spTa-uDs=$K#vP2P*zKtwF_RH<GXXrbC+30MrqUt;a
z506Rw9l2`57fX|V#cfpS-1MfCC*<z%hl}6OE{xA{mIsBSM@DV?j!ae+O_r0ctEAO$
zhP>F;pXs&#H$YTC2(>IvX5k>+_17uyBw|ue_T9bDf#+!FJ@R<FI8~d^ic!XD>xWzH
z+@lbDdxNsm*}IS1yrX6Rb<Na$aCI!*JHdDp;AC|EX5dLa@Nb?J|6~Og-2V^2TH9g|
zyv_CceDKRYAzZaG<o?|11%P2qj(P$CJKl?5%Xq)>QnpTDWasjQ)NSt@t+umS8om3j
zn+jU9%@!TrYHP7yECuNJ_<6j?@!|pfahK9*pd;OQ3q*2QYRro506O;}m&|_JM*uO)
ztu@E>`>5#XBPn_2ohfv-_<x~bfVOwqb`QNXYfJp|pfO|qBKPoj4p>#x%EjqUog>FX
z!5fI_69e*0%)bX-?mOlOUuCJu=J`yiAL=)U{?J_eMJWd`sQqU-PYpH-h?a)S8dqC<
z;aPuaIwr&&6gAhh#n)>dan7FYj825F<d`VJ_!Ph67m)I_^awAyoi2Sr0x6zF-{Tk@
ztmc3>Fy8EwnlE|ibGp4a*Wu`$d({YNbrPkQMBF$i*w+_}@1h@AaOO@jU+yPNYfDz$
z9{G1J0U(YQXW~4-*nECe_m4JK`&NCSzkL)z+-lOaGi5aQvV8^vIMvpUZj@GcpV}sn
zE4p;?a2gf!fkZ`t-zzyTP4o~*$uiKL-uo6YxRw9#&*{8v6<KZZ+*9A=xlK;bej#PM
zbN8Xt4rtuxb)fL<BW61;mwNl{b;Y8(f16{A1Yb7JSkMR+F|qv}zzI&!`p)R}y<7U}
z{<HcW-Q^=4<A#p>W*4AAQP)CjZP#&sStG`9(}ksRa`6ZmdIR`nP0MW6JCUpBL4VCw
zpO4$_3<d-6nIn)|<uYHh#V-D9uq=0>(&btw-e4s9%9$?Y<_GSAMB~ug?!67S(*633
zl}2eQyZ&^K+_F(lH#5{3rymfPl~&(TE{=RtwL`)F`>&v;U?lSRVZJz!vbpP4v-B@q
ztaW`pgR04~0BKoWm3_FxGxtL6aXn#rTu%~C{Z!5Yn$+i!jBH7J4!f;%lCDtd|L}gK
z{m8dw8vr`pTDEYFnibA}?nu|1dbeQHJ|@OCeSOFm1K8c;;bLDnwbKiHj_~2fu(@sh
zjMi7)qb`=;7XUrr@ak|$aOyV>yO;uc0N)#Bc)02JOS$!C`o>PMNgLiQ*LLa;gpj?h
z2Cw{WN^WrxGkbQ5nD3V{^uc96AN*zJzGA+sK>3!>uP*LsbVfC=Du-i-=(f{zc$ZPf
z*(clUM@m>M;vJJw>(r;u(EtlM8vo9xD1bYZ4-Neu$U_hT7+b9D@t|$tk|x&!AieeP
zBlNdF@A5FH6H@;k$XHo%v=&VX%V<AvP_{Y{Gkq7~oI7>2x+t*SBLswYkpa<KAxb7H
z0f;>(a$_EppMXkt=HS;+&!WTJ?BQ8g+z*t&!#h3#@`Kk2b3l03`Sx7rt(*4{SJ{|6
zPv-j`8uQM+`wv@T@hwE~6HUNBVCnT?J*?z``46xb`Z+(Yg|wT8>dl{1MiD?L>0A&n
zrMdpdUx*2rS(KB+0HFnqEw`iYmX<l2yswF;iV|g7Z)eJ6UJvX8`pudST}HwT;B@|(
zX7vU>3Lpj7ydQm}k$XD)n!&b%ZdOT)M8sh9*S$9h{y*)QEYo*OSy49?x~9I*0cgo6
z027arzI2-A3%wl{t7m?My0U40pM2Ol_LO%2Iz;jW0lXvqbj@#QcPwi~?Ze754^Fao
zCMJ#_Ca^Coww@c^=I@)4z9j?$0JssVrQy@%yWiJ*3uO;20li|5u^umNLF>R%9&byo
zB163YB(L)JcSM3;XA3UA-_d*lKJZ+*I*H>>tDGrVA?_Wn?*(FP>g_vVvURkl+WtQ+
zyi2$(Y%053-k2H!y?Nc2d)^kL)iPZ?-AiT?>-G3YkIdV7V@+@sPZXY_BN3WV--2@2
zW6qi=fNLYniA+SfA_A6{e*2m5<>t5yFo)WpgHRa&vh<mzmc2VqlrYM{&+{<{t}oZx
zQm4K3WnFeqFf}dYZ#YrV8gu^7fA9VRav1$d^#EeyJOGSmn<l1yt-TH;W-c7G9e0cZ
zQ0Ugy+-~LR3^QZx#UsOU3jo!6`vH+O%LPeyk7z;^lo5ILfyW;NWaDc7>i>x0mA$lF
z`hLELUi9MrPf2e#>Hnz4`#dum>$Q@Q2e@sXBZB=e7NNRkdbL10szPDgTms^nhom}H
zo9@_4!Ta~5>O&>y#AP+p43l#{06<df7hGy+USxDGJ5aX&$bImf(UW~cC~;G(;vpRL
zX|{rYWf}R-|Lu1tO8O-)AA@PX!_yN>P2R@>;gMTL6^AeVu!lLU!c=7ulR{i9uhA!4
ze_vJ`<(T(|*ERfs+r#DMg<PrF3uCUnWevE!SWW5mBGuFbp|hj*zCvG6aZC1s!2U#*
z-{17h@=adMXC@AG0E>ppT&<N~Tv(-MGf(HNpC&edXeO*bg8mWISh#zE0E%ytvo6(Z
z9jE(gbV}{c_ZkRIw4IhZsY?uYt+N~EIv2*)#iH}k1wi4SWx((cG2qJ({AGCOnGt8)
z%2Do6t<X#l%xkenxcSa7pI212t~1rNRhk><F)Q5tfZwi|ZA(ISqh+POT_ig|B!6U8
ziMU+7t@hgDzBHE^xM!FP;h$r8Xl|PS2h6Y%f-B1gCx&c;&fq`(pA`vj9YKaNYI85I
zEvKvL7b<8wCePu@KU)sJeR5zhLdT@k>otC-4io@TGu-uhh#F>8o&6JDoLY0|%$KK_
zR6+&#+L=OBQ#Kr`8pFhQ)MeQF@KO0@Vv5T-ib;d9O#v!s`MY3u**{5&&!U3`Qt&eZ
znRFhh`RrlyZK3Sq-Nx>4;>VQ4SY~FTUYSO~!eBj~^R%G90fqu}{UHfxYdZo8Kdise
zBKJfp-_4H4NpMZy6x$)bS!Eyig8zryxm#N0>w7eK0Bi^7r<N~D#a4=WeSV>^7B(>4
zpF|Hg`dp(B1;{OM>(70;YZD#%*Y)`~c#sf7Z_je|*nKnlh+7BTFbq`5h)<mpcNVZq
zxL8MB%b0KVcO31Z+6Mw{E9Ab>&XwwfvN2QLxw^RNq8jCHy=a2j1r}Xh4tYpkW2OwX
zfBXI!)L~P>0*%O+=NF2IXxh_o42MganggYI6T~-$pK#vA5{91_kxm2>_n?uS0E9~3
zDb(o&U<zQ-Z_y`Y^_AgZ9(-BE-xG5?ghWiw`#uz0d6C1Eqc48!1nzm)=pppYa<KO}
zkjaNu*oihca{}{M&p0jy<O$CQD~b86{0{DZh&BXE6WVZuToe^89{iGb!+dL}dlf;s
zTzBvtIQ&{!wOyTK1=T%<&RJa99yTq#1`Zc{guxX)rWF}j3_;FqKTnpbf+Z`=owSzk
zEdAa67Ph8>cMdu*u5PVOJJ1&b)>U~v<p4384XHYNw>MSy?>AN{X7UafSvZXv;4WY7
zKVwsJn7+zFv!RZ9*<;kUID3!vOl382KPKHoV(SHm(l-hfEsfR2$24(JP<XdvIkhm&
zdQCtdclyo+P1um#!R%<MW7$JiZ={Dh9e0n5%;s(&<oMA+go_*6?q~Y_*!R?LbGw*u
z)Z^RgqnpLqM<?$<9{*a3+*C_RKIVV*Oef5>UZ%D+F{~V>3s=M>sb3VSmxarvfOKqE
zLbnWSstJg9n|m8X)3Jhq$wweYop^H1+|$pVr!r%XpJ{&^T_CU|{$j|*4crCc$$B|<
zREFj;Mfr#_QUd-1{1+TK_F2{?&<WnV;azwBl{2YBWdWRjmuL!Ts=h@|a1Nx31Rb&M
zt-aB~L%?i><?8`*d?1pwX8ZA&`T)hco>ZiUJ#OY0E^}6!&*nIl8qKOZ;~N3OU$sQ0
zqq+-E{al|COtmJmTF=qkGaqniKrK(Yi`$+7NXVPC^)Ufyznl}WZHbZ7o&M;-BVMo^
z#-$r}9b^v%PAT`gIiLh_3jxQ2enI*MZ<$IdCmB6<$v+@?9oghAQ~MQ9@W!jQBX3%r
zD(SkGyy`d6V1<V8qq+=8u&&{C7oDc_E_${GRAgbMmf?UeyC7lznH>wZ(L9}<qF>$I
zjcDoNoej~vuV#INa9%~w_zDmQY}W6Xp-=SS`cHp)GfsMn$mb>XVyt~Lg(xEOD3KW(
z%JwsYYO$Oj>dT*HHy)P%{>!@}!RlbdF+icd*`vHBJ%k$I^oS1sCSpe10Q<U1OIkwT
zGA5Sj$0|K1Uz?qaPGl^6EeO>`f+TR14`Y1_YjH5|n^XK(!J`XhKM5f?BC?hyeQ%$V
zn{?OCzhlBZrrfFjCmsjFPAiLMmw0JGbB1y($DO%$gMRC4V!a}Vv>A<c=|5t-&ts=7
zH|%g-sLNIsM+_tMHW_&)<>t2`aGG~jx86v_ao{4YeW5cG8~^&<ve{qVG+|)5)jPTJ
z=(eZb@Q8~flqnv4hioQy(mMK;Qf7AG{oQaCk!pP1e(84X3UqRM4IOA@Z`BjCe`vtZ
z!K>HZUI#%*$-!4GZ#0jtT!Tkn22Z`m`@GXrWz@9V-#9wtIQvVp|LLpoOsMFX!Afj!
z8eq;eVQP5_?C>4ppP{vvlT%j~HvhyIMN3IBtstwcq@-h!*djgs&3;(k;^eek3s1;|
zuzpZrCMj|&aHLv$a7jY+{=5Jr#E>w(Lq}##&K)HSt%(7eKDO$o7Iu{&UKyHeuBaR(
z?JJvTI>VuzgJ|dP4q*T09=f4F71F)x{>OoHZ5r7~H?Q|IMf9($PyKn>1Ls13UHG|s
z_RJ&9eEGAfgFi&<>z)(xTjJU&U{TYm6=uP+nRoN1Go$1=yKY3<JdL%YUyN4YBh0x$
z%(NurguPA)*mrDLGsBo@pCoifieEVKM-(OGXqUz9>5Sp;6jHSI>Al8WnJNv0{RxP1
zY|99s-<e#EZc-ZAY0P6{8>-W(YWtV?uH)YpKY#1sUdcGN(S?Hre`f`^g=pQhze#en
z!J!0F!3pH)Vuq^bzAuQbNthV8wCq0e%k34W)2Pf-YOMsqvYK}pF5*FXp{d!+#cL&1
zsVO$V{TSZdaquy?L?S}ss?C><L)`201)7;%WmM{pN-%8imx^7EHqQqi&oL>q^c=bQ
zU&wV61SE1B6yuMsHZ#7CPpblJT8z}U8%-8X2ONPC(_H2;yW@`NWl`{lb#qyVk{19P
z9alTV=`S%(V9&zSiQNQ(C~t*$`2|{Sm&5YAf54H-6Le&n9Z#3#f_?zxMe_yjfoKmo
zWKLuIu3A-P8KKpaP6zrcMDh?RqPo+6A$Cgdk?7k8@t#B5Z}^3b<D5LxFT;@~uC@)y
z!uKf|KkX9+=B{TuD;SnWO9_}eu5sug9V<tEKe$`F#=3jVDPYyi(ykv7dw(r$@i{Yo
zGYKGyet}v?RV*J6bNuo;_J&J1!9w}{b2%5!SHWrte*3A!tuOuO{R4X`W?^HsVtL%+
zl)YsgAA&!4UyPFFoj}e`!?Ea_2WbypZo+RGW+u()H$RNl_a{`3bGT-(rNm^nng!bs
zviu_}dkF)v!eci#Zz&fwLfdR}GV@m|s=g?Cu2d3N8|YZg<+QvDTJ5|{&8J-n+N!W}
z@84F52u+T|9$Rikc2wSW+D3<711I(-Q0XjK!Y|(CK*s$8H)6dYlF*G%=Ff!ToG1b%
zo%#1Uy+4=4vpMLQw<+Nm(8$!_Z@Sht_~2p=i4zq5+P?SF{rMPuj21pS+E}joJcP^C
z@k{_D2*(e}WwR@%RvNC+5*>1QV&M++lI_nX6`II#yo=e7sc`ZZlD%6PPiNC08GMoX
zQp*y*0g?4YS><Jtl7*@?#qVPNltFp2sIA>MvK(q)Y?iS%tw8Z;#qR8;s0$Pj*P=i@
zzB4ScXb*ZC-O0@!_ek%EZ!OxKrF!Z;$fLvgfd)XF;&Gt3gaYLlUaaWgFAs&rXm7_2
z#cv94VNa8-dOwnFlx4{L(Smr$0UxyOX<36`!X91`^Z?KvB4ZDLEZE*`?@iNQylVfJ
zVT+GPO1A*it6mDeNRjbCzf6`;mYr;WG@|OmsjgE-h)>f77uFCP2S4-uxI>7T_I@<h
z$}k{uIBJNBM5DZnt&Ca)nbUe}hs=2@E?>J}m&g2JF|B>YaTwWhN|wM__6pPiuKsI`
zZ+aY6P4mIS^96~o$ukL510>a$v6SZ0Mi;4Q&-^cy)^egt5vj&l0tKI>8Jneny+(BX
z2CGmi7wpv2kN9A1VtfhfacT~NZJ+%T{@^!E<JIf0yii%P3wdM6VGcYbThCNoSyu2!
z_O4%(#e5Kao5LCBQNN&>z}PO>*~J$_NBee%`m4aN1+M0(83^9*dZGxuMJjzVzSchY
zd%wyQfxO+yD{wXV5^LGsZ(dj&pT#3umgC<<x(8Pxr-6!wv^DYOs<?wNiTNgaX$;F9
z=k6E&w;Y&;UnnCy_6J1qnMKy8tRk2YPjE!Wsk|?`&SN?RE#pBoj2fpra~)f}?r(_6
z-Eed5{$4y?D$8BOcL}Gz!U><kyzaue^^4y@sINU8CtI^+NjBJcHjiDXqB3|1C$lZ)
z|5O$7n-c$pXq&h%4yCP%82bF$!P9g9_a1jd(nZJh_lwT&$d=;+(fz7xmI{tggCj}#
zkP(&HcC%%Y+G}rvqB47`P{W_n;buLB`3}8t5^(~A+O;GhQ~5nhY#~_mH<#(X?`AH!
zt!_V#(j9v&Vc;a)TeMxxZxbC-&2n4?T5OO?@)~E8>HIT0AM<bjv1{PMJY)>sRb-eq
z-%mjr?eZ8q`*!2{HH>=jUUpNT;Di=``|WrqB5ZC42?S=+bdTE6sze}@kT^R!8B{Gr
z3-;)Froe-*OZEWxcO3|E!KI-*Skb2dtQ+HLZBIpIM%JuuNj`#Z%`CL;LDj<~`sJfF
zQ)s$Da!je<QMH}NToW}qVWN7Bux60x^L2epv{957Bp;i;l985M<Y0wnGlEic<cr6_
z&=&Q?Q=^1&hnBaIM4E@2VYhT00s<(6&kGCG^ptM$E{ZumL1}U@Nx+@NjM`;>Qi#b!
zKHmw|Vs`WWvC|29?Ywe!efzU?jERi(7uiye2<!`&Zv)&|acG5Ow1g@qvcESdesF5O
zl_COV?0M8;q4kjznX#XG2<>X;u5Z+q^Q%r2f78xEaWMX<+KEld_RL(>2UJMw(EEu~
zbxFy>!A|_SC9TmGA#)B&Gv>m^h=(>P9*(CUyUWBPpy$-=9kMU_p{LZH7jy>NkzZ{k
z+E%51Z$J2MpC(~=6KEe5mPO8Z&%3ljG|_YHo@w*7m#OB^>Ajuw_0140nXaztGgfYb
zJ`IcvV-!4zc)k0HC;#*qG!!sokf$$DG5q=1Uz=SuDWqN*&S`PNgRIKGh~n`>N7*eN
zA(m!$Ee!l7Y^L&Kp_e#ID{Fs%0&L~8;_H*MD{O*A{i@Iv$>yTUzx#KS{<>M8;nIu2
zBEFI_S5$P3gzU$iL+gGQkcYiXwv*{*vf|iijjw8F>;b3xz`OH$WoA-e%=g-Lj#@TG
z5InkFhjL-EG~X*9#n&~EyvlU&tu9_`n!zqoyJzwS$hBhG>?Q1Z^7YfC)A=kn0-8t7
zP)imj*E*jl4}7GfYjX+pRqI|jHbtF|tLzH?6kBQq!9Agk!Dy(Sm;{=R0~5<OZ}1y@
z8sWS*d6!#l0+;l(yCt`yIW*ohBQV3-my5h=a`x<WPyT=_XH-M~YPJ$~I-`Nh-uZMJ
z6YEaEllazgX*g@Sp2)4*pX}P^zNf5B-LvIyuZc%Z^1(uxE?dNntHrv|r<;9ReeTe_
zE1lhLMN@3Qv>?41<Bnq1o1QR%w_qAdR%}dMLeKGCp;=p|k<GjcNfliih1GcXjZpUA
zQc1I0lgaG9YTL)1s|NyD!Y0U<+9|iO`hCCT>dOAKr?-3*&{aCx0(aQTRMs$D`S*A&
zU8TVeGj57utmZve<~xCyZnU_QTz-0?32`2t+JJpr*;B=@%=jE-*@BfEX+%FJbyJ_P
zMTE!Zrz&Z^QX?%IEf@Z!%}RPIavCl0F~@=oFS@7IC%HO?Hv1LtWUPY(?Mt$FEvm8+
z@19e8DbP6+`v~BYQBUPPDLob&3%4I!-?6^^&7R7%E>JG1nj3@Z#i#WG;(hgpL-su(
z%W+oH8r7lj>42f<Gt8&KQ4OAkF|P4AKDzD8oov54CJeJ<*mPs;l(t-8Ti(t49Kpn6
z1axcv2KEPr%JDc74IG)pzGmM@MSdT#`J%b#5}`u=cBPPL(MF++(!X^&_v5){qFRPW
zmXEZ{YVb90mUgJOvDOJ~;8s?7GR0wq*e{medWMT6Vd}y$=6?f}SOe`BW^}vqvZ@I^
zUGjef0!yEu^}o_BJR;L(QDFOyNfYplC3)0Cb_3qcGEmH8e7M$X^w3w&A`zo&y8i+P
zz`!m^IAc3Db+c<{HCOBC;6kcGa2E@HbgblcA1~N$xND*xWY=Y^LJ*c-%Mc-yQznmr
z@`rqy4F(b|1r_M|j~#gDo#&9omvzFW%lL8>#<EX&?#2a`*TmBg!oA|{ilYK_EH06c
z&X7~?zl{<B)2hvqaVewxXAIbk2lfWL-0M`|SXApN2*u4RIxgVGs<jPlz}Wv?Bs^rB
zy(>_;$3<6`YKU>Lx=&(O>W28l_bi_&CP}*95-}f8yW`!Fy1ij38;@b%brbgl8yZgl
zna*T80987uN>2x0tOIT85YO_WPV?dIo;XFFT}aq$L3gRwH0WUlGHiAtHn-cEnK%z>
zihHS~9gASxQS)g)$r7TZLfd!OauG9M7$>$@mfVx2vo)Jnr8bu!C%xjjvbdHkA@)1?
z$bTY|h)29~;3&p@6_b!$+k>Ftnr25wJgo^(uKRL2!nYm~U63S76}dR-_bkJQd7xm2
zx`%`{<_zi`yhVR$%L3jTQ-BQ5znJ4p%yfdH3}Yg-8<LL;j^~L&S?t`wOH13^B6Fj-
z>k@luS86wg<8UU9oRhh28Z5f0#qRvH4Zr16)We(Q3ffG;gtNO(r*(;;-w0ypRu;SC
zO&WnKitW+7xz68(aIb6Xs&Ar8)o*d;n#}xV7b`<)Tn@VR)g7DRG5-MQJkmJ}7bZvb
zmKq1MA@4w(oLT*g9PNY$Cy4EeDR!O|J^>-qYd&+lBiej(Mw)C#^-?Rxae*<S(nCYJ
zG*&AN=W~x$+~Cmn88eW*IYhG^)U$rj?+qeI5Ayg(qBRz$PGPb>5ySe~`sWN$2>X*%
z?-&Vhbfgba*)nNoruatdZOF%%IOaf1K@v~m87Ja8bF%wnd2*ZvCAP&SHgj6t<WQ19
zQz|lK$vy2mLbT}VGY0Lvj%{67jB}0Gg+KrL6AyF}j%%~&8YzkL#J~6%F+Y)%E{m?F
zy9Gkh1}`iaJmhvE4l0NSir%>?I&Dl^aXyPv^XqAwEUbiD>_9p}-^7t>Ep{nvg^`7=
znHgC3HkEf$gI?B!7;R8O^y!ua^BM`O_|T+`71o*uF08IJ6nl`hShIN>{2_#xpzOGI
zqhL+~#|}OBh+1~P+Fd-=V%-^cjdAP(*Jf&)uXN>Z!+q<oT>_;%>7|+5_|L>Y-;1y@
z>PJ1}rRA_|D;*Bh6<y<>2HRHN5lRu}9H2#~RlD$e>Fj_uhdk)8Ojkg^P<eW9W>@oG
znp>s*J=+F71T>v3SfZdfd~*jD3eR`E7EnRDx!X799!d)+!3sp5648C5-hJ;!b%XPx
zMq?A$*6a$p+B`dpQI#r$_Ax#`?Feip)P`fqJFmS?{Gm?57ig0+?Qi#!0tsO>Q4cdF
zv8N14Mv-l>;QQJ!nGwUaWQ9djq!rBJLFvF0kN8Ia7dU^RKSi-6ivg+9C`4~&!Nb>5
zT3!hC%Rk%v%(tGRTx4WHr{Fqo+sz9L!BK(G#ht;Gn|Gyh2_jVep*z)tt%UENKDm&T
zRnb)<=Cn7&o(t6m*}1C17`#X7M&~*`Jt{Uk`2-FdQjz0gZ>l@)-k~fhg@gcQkjvfv
zfDmOs7Z60ha1fj-awtya`g%~|lh=!XgiBSXyY;ald4OaifO>lopz52G-!V`E5^7H=
zEk>pvt+Q1__Wj0LFSIa2e(5zg|I$eiLgOw}zjDjn56ND6xxwtF_6#eEj3ou0<fQ@v
zL0iYgX9_2L(`uy(kkMpgIKp~KfSmB~h3CftPk~n3J+v~CZpIvLvI?9qVb_Hcho~Is
zc~1z4dU4x3wHvsqHYyBJLvu2@i%teMmqB`_*bbou?;sXtQ!+lJn@&`0r6nL#d-^7w
zD*{jN1CG@;YIuPGAwDBKz9dcU6@PNog=;GJI=NTFo;>i8F~x~UVylM@FsInsCK5eb
z@}_wP825RE4yhw>EiJ+$*Pf`RPg5tP|FxI5E(pch81Ot2F@%~(Y%J`<Z;u@BG?)%$
zp&~p`9YV-iyXxv5<H9mTGpU5qbKUu^!HoKq-Unl=e(?=jFHsx0i>h{sl>+EEF$v(L
zqz>=#QW<WbV5v1wHTIGLd}F7%y$`?htt(I^g`iMC!XiI5yQEfPfjKmp+hUyeDHqhK
zQN}>v*m7(&#w6@=Y+0wD8RZ#>_e{{<V<kgqBuzr`Js`~zFN~mfHRh*#MaeouY7{~H
z-JpFSPe!<D!65=#YnA+o*Zt}?`skZ~rGkJzGv<n%<uaiY>ykKY`eJunE`ApII<PnJ
zEC<FmWkz54V;3s&H)=9!FBNv~5}3CYceO{nLj6pVQ*5+N+zi3jXx?QS$$3{!Kk!}d
zm0NzHR`}~pohRXzRQ~lfOct;xY+R|U&tM1hg;8uCT-v(9MrfSJtOH_2+y*Otfr<lO
zf2vW#>yqI4=otF@;T{<+TkV!H$1t;4zWRyC|MxBF=%{;>zvK_TpZh8gK%x8KjLaol
zx($BqJ$WVB%%|({`{DY{L-0<mJN@M1??^LQo1%E{fB$5}R>5Qu|5huaA9!($Bn?eF
znG&NIEd2w23j+4J#)2@~NDr8FQcqX7V<yOymOwian>%u>E80T>bVd?Y?*ngaSF#^h
z+4Y!6qF{|sOl<b7q<ZzIe~J~}o{=fXBQ5m)QU9vBtyL-H(%!qLiT#>~=8vl<Y%?&G
zb7yIai*?uw&mJRvaX9=1sAnt%i}1Qu+umROi@`IH!utHxH-993eIG~;7iVgRtq7>Q
z9ljElQ868{A*RkqGl?g47wD<!dzH=hFv77oimlQWf_dmBuhBg{KQok-Xf}(V7oIhy
z>c4yYAiqt*H?|Q3;jUK2KO`Z3BFC7_PuK}9Ef;Xg-W5hVXK`|H^$Hnkx2fkDYb^3}
z7D=@-Bv9{silm>*?t(JuIm=`5`wFUnD38vw931Tdjst?Wt>(eIuYQeTFeB@e-!sCs
zwdQ%T5bN=K0ZX)G%vveSqkw2V?JdXhUXK7QZxRhlr@Tn8+%*_iXA8{GVFB9$<-Fye
zW4w;wh=C#n;2?|jv~L-LY}4JR4X)|DB-Y8dV%lqrR5tvY*gJaCg?anmI@{Ie)taC8
zT)LhC9$Hi{{CM^b*k~P)#1+`~sS7ujn<-?PtGhhmC_B%(&DF$vb3%(#cb#q~;w>X|
zpJ~>O%yDI$G>LKB>qCak?Zz_^SERuZxr0@}@}8u4=GbQ`&mfS1A2un*G2?B&teSy-
zX{#LT09`b>o-2S12igBlSAR_u-f1b%IbOPn5R3pm|A8T}`VX3#EUvh;l!ElZ@hn%?
z-o$+83Q)4{7vgYnoF!*VQSBID)N%*@co=VVN#vrg1}<~NwhH5^t3}*CxJ)B|v}@dq
zhibp=2wa<661-0><N$7qMTYgx+N%#c{7;yo8#QBzva|8rJtCzw91nvIjcKC+>v)(5
zq4a0Kyab{d4$V3fuV`e-1{>eS;ZUm^Pdnx+p@HPr{|vu~g}_aNkFT?h{|X`bBAGw4
zvq0ob;Bw+W&JS1CIL#>7KWf0`o5eNR6D<>dIvM}6BM9LU-Y4ZFd(t1*Gmb*pw-aRY
zjtRjFb54n5qb;f$qJQN&LXnj?xMDvJ+S_XO8~)?UERV=iv`;aV)w}j6bb<A~k7J8o
zssC4npS&kNl`;Jhd+>92#3p65L32lj!4A^0kb&5c?4A|J=z4+u7;pwp&v5?A=_StP
z^O<GTCW;b^s{79k`nm!!7-YJ#b7MwB!WZm>&m24;0kCf%btc5~JnCW}U<9`I%R@aG
ze9u#hA|W2jNp5qD&e)PW36bM(8nu#~HFwS5+vSBe80cc!Fub~;$?mP&Dp!7Jwvr8O
zy0)%l0F&@h6WIMq5kj9d{*wAATNs{F3+HfqkxnA4q$c-vRkVkn?0Hx((=Y!B<^dy~
z$uq6Z=mct(6C5m|MJlSv!6aZy5#7VONeWO&lU>y*);lT59^Lg#Z0g2K7NSQ#oX-t8
zN7Z+wkEwG^kPibeTWO<z#n>6vWE(sIzclAfTkSys*i*enZxgM<LZF^p1Fz;Jk4~q>
zllN4Ea8SoS%nU!FRBTRD9%l~NJidkGp5-LHVK=|9n&=KtSYt7!@+G1ZP497JU&r;?
zez@I{eJD9t2TU{LHI?}1Lymua76CWjeZ9(jfL|G8Rf%<O(K(332_F4+lG)_K`@Iu^
z)^W1shacq5SMX>(S-kM~1NdsBobZ+P4s*2QLG58_c=s3^*+Z&y`A%-EZ0&j2h==bJ
z>aB54pjs)Q$|2(?5l-zaA<yAZdd^NZH)K7}Ib2TdoRbpBQiZdCE*X>QAucFn&Mv~L
zWFh|M%HLSxm*&hUD@p1aKwzrtU;-XP83I=Tj7h6h+Q({P<?bzl`c^+IyhJcZyZLQ4
zHsA6xM}&B#amok#4`l3$oC>%#QLKbyYcpim9`=_`YJl@%8ZF7zHEF9nk=+7g*{lq&
zQr1`uDvLeDt}q|W`+e_qlS7qIiQ3{etGTa5QlMrbF##c~{1Z^Z;?SF>ppi2k36~93
z7?xX6d%}P?2hM_mvAyy|Rk@_}>GY0eOcqq}AU~5GhC$;iCS(6R)}il$R^8W{uy9C_
zO^EV00|e4zYFJ0_RFWj~;PD%SIf)91syH5*zw`b!H<t{X<m<6=GxT*U9kq+S;sY~J
z2WmtvnYDEf6m7T-8!1+rBrqnn)C>A?&8Eb_k{|KZ6~l@8tKz^+BH`B}%9LLEX)y^w
zjSq3v-#YIZ1wO@pX~T<k!Xv(5A-hDnqQRc_5_TMbJL|&9+wwxlAhWB4i`c++Y|7aj
z?eX4k9&}lEvEpTobR3&d6;w6-=Cq|y)1@ia<1i-w0%J!3xWN;WxKO<^mcAHgw4e7z
zSE9|O7pj8bmHMcyF)zOPosxB!K!&0Rk%kXeIyP%dG)lj)Lk1AqB`M497AR)3n4Kw(
zxC2JZs%<}yORKbz{!a~d)sg2nn>x;x$j|Y2vF+nyG7s+`X1^j9kB*N6cEDyp!gWjg
zE^yUMm+fL6d_7gR;u4KqYWC&{%G1x(#EqWK?U<W`XhO6NQE>J@I_O{Z3}BLIe`d2z
zXBgo~H))yE!AvCUJKgFM@W}}ob`g(Yr_!@Z#gXUH8etE&fp`zsdi?_YD&A>p)Ob<h
zmO%zNANSom4A<XHKa1w<_k85WG<baL@uL(?_`&Pq6&d9sI|?-7Z`t+!=$i4|5i`wF
z_TX~p$$C3u@2Ix0-&l&zZVgv|?UZ3#jAaD<WC4od9D#%)weR=4xTyVKXRaYVoQp2s
z+t~66)nZbYccEL*eaTAT%;K5D^FFS`bl;wKA~&QkK7C@qmLwd-4R<Gh6GM1Gk?J;g
zb6PVLA>EUyUkX<4nss`aEh0Z4g>@QVnR4K0PhJ-9K~0%{15Ys<%SU4s|8zmI{?S2e
zv48R)<K<EGtirK()0KNh2vZ26m#Vm@c81^8!QR9?l9)-j9h)*(zA2e|7=)qS5Ot_*
z&huV0WS97i70g4U@_-Qs#S5nx`%-B{XKlm1AR*e<EaJ!0orYteT0<<)vE`g73RP%M
z(mgb!7j&<+Nq!&alz=dhgT{NKG6~YJIX@WH)G@_u1r9&QsXXM3(i{MmGQq0xJRrMb
zY)?gMS|?bi2IHwBx+*&4BG=&r)u!$rRfk#tKdGkd!Ba)T7`B0f7NijqP_~3qc1tfX
zTy>MGddu(nr-==WzhN_X?R?4-gdZ45D`~HJGIlJe4FzMho_Nn2Y}y;*%sq<qLWt%9
zuqkQ$=WSFQhH;7B9u9vn^fzp1Z3ExZ^KIJ7nDDHV{tP<&`&(+Khl&FTfan;lZmYCR
zJM#OhrW1rU=f}Hesxb(Jp6vcrL$`Ydd{EjKWItV%4}FBCuE2~W@}xkE6IbRc%{k-B
zw<sw`4j$)i%gjbgklN@>=F|h}{mLxF3}ud-f2zUhP5d=f+r5&^ACbrDsWbp`%~|<8
z!I|jU7>Zgayzp3}Y{fuX;`BI<NiMhK1pl$4s3=^0G+?YJgT0R=E7Ku2qY)>feL)!Q
z<p6JRse{Q2EqHaQ*?-cKY0sga+f@v<7uumJ?>xv9oylGUT39lds#GA##tB|z?=8`e
z{EN@R-LY5rV~y%b6WrimT50VN!oWQ<+t@eaJe$ns0~Gx+-trAg%_LusIO>VgBl<`g
zk<s>Eg|X%BYl^$V(A-@r^sjuB>^=;B=*barf_-n|ipoGPF&Zx+7Vcgbu6I{zvM>zA
zx#x2?rp_BYQI|LUc`V6bhveIIa>VkDvIKJl6Jt-7(gB7ZF(0A?89`XD*nZ`3yF8E6
z)*B9)WlSgr+XZ#W%QD?xe5LS<Il?`|CInnjs%vtChL`QDlArc=?d1_lP0YE>Rr4yv
zSf~tL<g)1siCswzvWrg&^oBg6rtOVu{{#}2X+;H7dCfGsy@HkezKE{wR%K95ufB5~
zpT<H&ICDsvjSH@TH{7p1(n!c)e03P8y6p&(SbM7l9cGVB7v;B0rq@v}#8;lQcs0`X
zRq*#>*qAKAth?ml&yj4y@y;$8EqcV$^XvyDw>8z^+X5sO6Y)hMzY?-dG(Z<nzO2!7
zzY2s?M7cdD65n9}n!E`026?LwTHNbXDt1^`+h|QBUk-7Di-gnf{(c7nXv*?D4ZXKb
z4k;PjbDp>9;v=t#LIYl%Z`IJwC$xuVfc+O7e7*mg9Zq9<`e*&9>?5saNx1Pl|5Ota
zJXUS~hneynee*GL@$_O9&1*aO1eIZE#O=r1zbRX$Yg4fyK<b53Kv}GZU{ayk`akby
zFLCSA5+?=U3&NpZTJ|FAUIajQVQjJA*qf?nfnb1Hk!%4)&xph<0m>%D&YghWpX&Y2
z9jz>~hZ6Q)?g_7x9s@OsCKr{S?R%m^7#F*cHmxm$ZGa}F+f$}tWrtaT7KjjGgN?-M
zmoer+K|+HQ{q*F%iag3K0BEHh-^9$cNR_34WLb1un6!;z>8}$D-&dUXkP+9(32QwT
z*YZ(fSYqLDQJ;zHaoW@7wScjmRmIbyY1h<W*2(NNc+#(J1`ltFZz0Uv#j`Kuti0>R
zE7Mmq@m)M+6#y_ot=pp0J7TaI+laOyf_y?*qGwY1om2(<CDI~MX+BQnIG$)T`ukJc
zEIcetniab}8Z3&AM!T;J_945FD;Vij1P&s($R0{U*d}z4ai*nkydEiqF8EiuS^U+0
z1bT%Tbf?c=0N4u`ixSaU=Cf-_uAHVWXLsyH_9&*dyt`4ZBEOqRmhSUca25@4ZQ--P
zJ*wQ)QA+w{Jqjz1W*HFODNaZl<G>GLQG%?*%K3MIi&0D!u`WZjCSy%{`&U`pXgT6m
zQae>cIG(zGlV_~fY_X0Nv+IRL8@i2ny02Vf!q7htRtr@Xz%oq<GV|&8Bpz6t1hR+{
zP2zR+aFB}?M%!0+Zzi$D<E5g6qcldH><ve^LxaPqbMnr=kDjlNU!8;3Xa%Xr@Tt&5
z2mj=FQ-C;GAgDvPR-Kl!Z{NLW`vGpN$X>d`)ozoNl$=KT>i7r0o}Hb^-pTZ{4t|!$
z$UtcquJKP%asunUXfp>a6L+t09Bk%6uR^e&fD%1^fdzfDcNr1SY@QY`n07y4zB!JI
zjJ_q&*A950&_cblYj7VV+%&BMDLA7+;NZv!Ja1mdkZPgurugzh=H8mM@9y)#5^J%w
zxkIJg?p@`%1{s$W#t6nP%7ySYE3{ySX(b&xH&P*0(ZFU?+)$#)f<rlu|Jw`!uFqSh
zN%=VWe6O*;>j^vdJZTd_ll7pvMlhYx*!sd6Xr0=Qwvga+mdB`Bt@wzUt}$2x>GH|{
zcjL^7|FYY-)tAmm%eJHX)XO%&t|_O32=X@~|DjcG!|k(aU*4DFkR6)6Y18055f{Ja
zgEMa4@L@^i$kU^y2MQ)=B<3s!TM!<k;>RIqUXh;9fy;Fkx%hyhNoXjdphS#mhRKEL
zM6O!7$NAKlkQzdjl>B1dw%!iraN;Pm4*n^n^-=3yi##aWfzIJ0N=o+;pm>d2C#HY9
z{hOh>Kdk?^iIz1)sU;<WRH;-38)vKgjG*N-xJlR4_&hSA2aMj=*G{ZOzRbXuc|yo@
zGeh<jYuzh~28J_e9f3wh&hyiNb41HntAP_Ojc!YvSAAn(Ey^pNbfmY-ezfondG{4A
zRYB5Pum}GWTr`a(PP|!#_vqXLr92R^Lh;E2?5*&V^>vNFA2(y4R1_$_O8S;m29!GU
zANBZi5*VNBEfS}ZpIF!Xe+k|#;@sfWPs1^9so`E|VCa2<ftdp$s(H39U2Q!R=b^`!
zN2B%ytf!aLjlUJC{#i)h9l?MrjQNBejDAd^f%ef)-x-gb;yCWY=ze)K#w*Hp{CiAa
z`c7n1#H%kkr;_A?2pKm_cmq+Uw~j#ffShFEi}#X_Bz!|JsVIGm$JfKJJnZ%j<BM@9
zHQ2uB+~?dh>JBi)aY|c?BB(HNV7EcgCunKGu-$Spn_4Idm7{rVnY*COn#h{;xNjgb
zbye)|r_<*x3`FA$mj%n#I2{)pi=Uh#cA~F1m7BZh9G0XNLUc$2CPJjh_&B!%0=ic)
zQZO+0Tq^>0)jvltMc=Ee+Aa4nM(S(iuP-RK^r|VeB%9(;&V?!2LN-kb=uUo45<(ps
z(5MtX3cj^5FL?PCEBG19%M#Qk`!+NuN?7gt`!_~#iUE=9HOrjwWth~5sh1Y1Q=G6q
z@9y9|hP1?;1Usn=Yh|lq2F3=0KS@GU@A#xTq0ut*!g+GGS)BovU8y@Mo)P!`f-oFv
zO*NHI<WL=AzN2_KA8N7p+5zdi724&Q4}#c&A0jw*gz~4;M^-P~;Lb;*-=lSP@ad>N
zoA1AD7Qp{P)_fXuODdJANkx;%-}RFh)|V3|n9-6UYSXcCOYf*ci+JwVd!uEKuY!*d
zR#^SAlA=P0AZiXYBfV9mxtZTI{)7DF0Rx@$Fhw@HN!xFan5>6mF?{?IB{SyQypFjp
zumla*d?`xE`vIK((;a!U5yv0@0e#W&d{ith?^~reNM&hlrS<SiA&sCParu`fv<JD{
zd6`7dyRuo@|I@Fy;8-x-FOBn!3SDx)Z6AUy&EyB8P)w2amtDa<J3TuO$D|JjjOwsH
zCw6R}cH^w&kGO!qKl}%JM0Z!>+2HkZ<VoDcGu9zAJ=+bXJ#V%TBZg_Q;gl{<Bk9PV
zYOoD~emUn$aT4JUu$AJkC!e03FcyjnE_mWALtXSKIdaU=Dwx;9X0cPr&_rN=unm(`
z=*ijHkK$n{gxC&FQ(d-LEhXk}Y$m)aa(@u)cu1$IvLBdY(AMpe=&RF2h@q-*x@j?M
zHE10T3WbqT>A9yN8(4u+;t>^o--C{$w-Kn_a3kH%q@EV-=Zm69A*h(=Y~-$kpiI}m
ze8c{Vr$uJsoDNsW5@kPPCe`EAynw3CacB_by1=a~@~YT8jRvn1&$z(cK=nu1oj>Qe
z@ez}!r7AuFr>u34uWpPpNA=52Wt8aoJNrZ?RE%(!aGJy3V?A134O-be*|b-zaUSv^
zy3cEa+T>gr!P-Ip0?caOz-E8l-b*_~>rVAI|G=9snEwI=wUlbjB+KB5&g2vGk#p7d
zm?dPes=NLRG^vrof?O1ag=gb^AY9C-LmS82`I020GL^4M!WWYG<Cy~i8Y+zH2@_yP
zX=OnbCm<kaZ|<x(=B<;-P{vSCe@sgAclT~4_cXl@LlG^Qo-NfW?C$iZfn#kUFINp7
zgh5FAb~k%#3U*Gjk2kn}&slLHhLFB4rR$=v-$CZf44ubESgLCT@KfSasK~~!y6r1a
z@3mc!71B{@meT~&oMEYN$~1)PKT~cFxQfm~9j8?W1y`f!aOkE*o{^w<=26q69*+5s
zFhL2VcB(IgDQugS_MDD3Tec(@KkuOG4@&*rq@9!RqE{H9-JL_l8|qsg_TEy_fD0_<
z?cyPXV8T&YcwR8!eq%TiDY-AF2KJ(@5L<_p!>BX^1l{6vLu%QdVQuCly2%)M5h9uQ
z)(c-wcv1-m(Qmdm+!xeDaCtNOVzMlb=chWdnG;u;q>I~~rXYy<JVGyL=j=XS3);cY
z1Z_dKz1xDLccx996n46%+oL_@5BdSy3p-Uh{&6OlOco{z*=w_iJCV7Cc|)pU@kHbg
zLJ^&3tUoQMD$3YKc2`(@#yP#)kMst81FopdBsG+p_n}fuL7YbTZ?&<TF^I4tiCo^)
zHrOz+<>1@MDRNnRsRj^Jm7lg+2k*3Vcb-BV9t6}+bOrPZc!UInP}ri>qvaF4Jn4*N
zkhDX6e_(Rs1#z#RvT<@P)5LL-5zZ;TIaBZdi-FSx)1nKK#!K}F+6I~|thjhA9~Dvt
zbX5ele%l{u*6^$S3cn6mKM@Kr#_rd3&eWP3qFilM)rF}oh80Gm_Cx-pnjr$U^pn^S
zXiEN>TvR3itEiP=?8P){%*|9Nvv+ESK;H?Y88S})k=SHcUzXFrp`jH>ydjZBq=-T$
zI3zLW`;}vT<1^<a=N9BB%uN6585qGGoD-6Ws)$ONm(L>)g0FQ6L-g}stC9nYn(-F_
zHXPzk`MR#iPw<6dxh0z?1@Xi~F#5NHC$Go}7e6AxrFRq!PZ$lkKauh+Cf?~X<SG7g
zSbwc4yR@9YL#+eaQe40Shjz3Fna5p~t=93PED%<ZATrJR^tMyy$|^a#0!(fQ9iEm{
z)2_q3qx`!*84kf)2QNyuW}<rqe#=0Oq{xT~^N__8vI4ep>AJNmMaMf~DC1~MEf)p|
z%FA-B^$q%Eq8e$X{Cmtnjcb!3Ij};A?pcNU@bP8Ai2Zwe1Ji9tadOZ2mzM$XU4AK=
z3nMY58_-YDj~?N|n=<F5$+Q=7e`wVt&klt0ZH>c~oN&%D$Ei0pzY2yqLEirz5gx}c
zQi*>nGIlFMZ6}y%t-JMJyNTeO4?S<SRe)%XZYRrDO7q#Xf3$F7Y(_}@t>g;B-<QqK
zE{k!2Co&*0Hep@;UtW;7vvYG2ulT&wJlWl%2AY5kc`Pi1;JEsCQobARSmFIoUx}eR
zX8GWQIu4$otFc19LE+}v0p3wLa9F&u;%3lz%Pg*)oDZ@2C6Vxk*7F2m<YAV?-_)}H
z_mydsRf}Lx8606ob2?sTbCISeX#5{-EFqXtR00!c`>E(eLjnfnI1V=Tf528{eR2>s
zzBf!IGWhz}pZ!0|lSaT5H^>Bh9Tn``@o>d|NwW{~*wk-GaB>+hagnixg(nYwKw%)l
zJN>6#A`#5XvxeUb;rim?O@K{Ap$L<y#V6g4jEEFqDnxhSh3QyH-e%o+@PuKLb<}_u
z?McSz$xsiqZ(GDzN%|u1K9P|hYmNktqKAc1(i4!&|Mb2j9a3$^&fLUU7j}ydXxSs0
zAt;Hc&u9z%>><y`B%kDrn3ODKohqG){!6@#daD&EH04`#SeqXCHPtg=vQrnGG2+7L
zXD%msgSWnJ43les3CRF1Zm{W_HA!;kqsXn)du6IuDM=oL5u`on@l&x;Y2#}uEyRm7
z%eo1>E*CAu%Hnxxi0F`yHj!5zQE`9uRLPBMVLh=M=^_aQP||O)XJ}(-SpGG?ssEoB
zKu+DOqT-WiLDXSE*mtdRy{U>gTg703Zvum-Ig0qscW<Lk#E&vWbBb#sNia%2Ic4t<
z6{a;Ua)kC=o?uQHO4&8kT$?QBg+xV@^`IjQr6X)VP-4|9Se<mh#o<(Ngis7aDAZ&*
zHA#Ixi2};b*_o$7SE%_=WW^e_6Cq)PuITK)-@UlVvmOMeS0g$k<dgbdO{<8@#chXq
zT}pT%FEq&}JxCm!awca9(jIs^u4jh22cyAavOSP9xfaa#D>&9wMHq1@Dw<uN9Ph<J
z86bIx?{NQ_r>IcD@Yb`RpFW#8b8n+#Go#|zAE-a$+n{{<Pf@(-2VQW7C!r$wmfeV-
z4ltHztve#{OQp^B%s{uE%tU!m6etJOo7m%|SFO)i69<`5m*Tk+FP;;(lhe^}oI;)l
z{^<gB`j^nr+iv01J%QFi^}T+ZPf9;v(3u8eubYz{#Y-YcMc%@JL`BVPTo*#(<#dzh
z!s1~g@=7slUpA;V*)R<ubqNTzc%GTatCKBkDCK?5gkR2h^U$LC$wts(>}lN2O4NO1
zh@z}&<{ggj2w?Uh_CA=c*dsiO0ul5&(Mvn;Ur6(H2bR{(b1MI4_F$hllAf2>OJWJq
zv$o2zv|{gqnvW1P%nN5{Ub%p*mm{#R9$^gr8(BsG>x1{x@!sS6y#oDNe@lF(wTyp3
zj|#Kyu{Y7)<1!*olg8A<45lY0H^X#gkAI5}>-(eDZ?|SAq+F-YJ+oDf6W#^enk%rp
z43ZmOp<zS$OM9u3{N;cX`xCZr|8&?{V!^8d+V5(udJ!1(E-l>J)!0Q(ra7K-fhpE)
zyG0db(TF_05MT$t)nVun51Z)Zqzok{WuN@S%ZcFp6R;ZaLHCJny)%DWF!@IwjFKv^
z!hZph6HZ@Q#^u<?i9h0x6DU2I8t^t46Hk6kkw=qfx4-VPUO)DC*Dgsbjcfm7Aw&<2
z?VB|6+bau3{|k#n6d+zRQh)AkuP59XTSA3B4`oO#)Fey6YO7`Y)4h(Q!1gB=j6*Jl
zaVgeRzp~#mWQlrgb_U=hqkS<G$ncz_(A)$Cu`!%&$oP<|%e@5?`B@N?Crfon(!Yg?
zSDmqbAKu=~aZc2UVzhl^isSvO{hPGP`v7=%L;FT=ii}2E<-tyI`&RY!@qT;4@bER_
zue&K`_fpj{-zras(>T2+AwcX}z+%?3Y2**xLjMnKUl|wW*2OD5lnf10GjxN1fJhEq
zQc4aeND4?OEj^Sp(v1=-T{0jcLxY5fga|l<bT<gx2jAm4N6-D;Z}%hm%#O8J?G^uB
z8vWwj$IPpY)@kuW8r^<;h7%NvS+#(`=KA^NLx<?pm$5a?6_N>TUeO25n-guLPDT^P
z#`?|t@%+^wgKP2JGVf|%_2w+^@dsQ9CVGxf&KOLbjX`plKl9Db(h)OxSW^8aDrwQR
z*a0RB0tKp(aw;Ran?eW3F&RRx%v%+PP*!>9OW~YZ?JXJbRd!@q?`6QFB)>7zw2Dr9
zzO3jUW#Mc0`!r->*<9cgNgF}H#<?V;j#|4}-G<mE=OgWEqcXeo_U^X#o-KY`sH5%l
zJUL%6I<A4vXxm|beX829P+#m`50e7&AvPRQtaK&gXwg$Ce5$KBKsg4?1bYYO^+pJi
zt~~c3Mfds;zJ3ZUa^zV6$e<Loa>x)Z%Yq_!O`gBXr|#@BW_lRvvF4UX8}|vO@(q`+
z#EG%<vxUm{;Q|Nc9rHa)G#5vnlJQouQ&o==8Zj4J+Z`$A#$n<`z>&Yf3}0r{Ua%o8
z<HlHp6_HaZ9tc{rKZmK{xt!+fvEOi;Rz&b@^5yT~V?eceFqz@C%&%rVL@)`djlGX>
zN<N!V6&oyKcHA&MoMy`QImclki8S_l_on`?I-zQ%cUM#xf=!hBX{vACxPPQCatCs0
z#ezTv(N{#b2aO)fuNdE}PJ%o1W6n2*k$Hd8_Jcu<^iU1ZgWFKr2n7%b13JVD0tdcl
zUjy0W(k>3vXn2r8hm63G66d#UgNDdgajeCp3!x$v*LQ;7YK_^K1HkZX1Q7*>FrC{&
zNgo3Z%WJng+ju9&Kbqh584#Zap&NX?X@RCmS}#)4vTG)=zX;Dt3*{4>$WS3bp*#-2
z7VG*_<X1$l!BEVqkk(ntmDV8lghwif05BM{Kj@0NR!OxY&7z8J>nI7Znl!Lsg|kcQ
zEq|RUQ91s*9^Gv;>iOGSZL#CS5iZtoe5_6AryTcg7eb8l<C$){My8_Uh<b=;jXGuz
zDlBQ^O0&Of_C<y}e;y|Th=chmhY$k_!Tved<%vhV@7;1O00L$eB)lfu`4J%+4Z99J
z7*FQ>lIv-lwt+r2T49MI|FKttU*CyM^Ys;u+gccCGAJP5$nng<Ny~_|pQv2Y@z;>|
z3s}HSaKaCLpL1*BJWa5>(}J<nd~YDAyH@grTGVJYmKTGU;_&w`7y<))>Ss^h#Bj>u
zO_OIemb3MCw<&em(I_B?!|xm$A&S-BKWP9c^Y^c0+rWknJ^=&S%IvKt8-1TEFvpfr
zO%5}BqmLHYgw3mrnc=D;U$)H<#SFR29Do1plDfq5_p{lCQfES7gg%BrQK_75WY+UK
zfQUFy0>_0hG8l6C)vuqdJiC$?;t;Blezc=Hx#~T6wVtLy-0mAb+q^HMBBHocpA`Lu
zRQ3%1uie0MH$ZXX4`K=;oaU$DZURq|s1-=UY~_$UYHwd9fDDp|Go(!sJkjCOza7Io
zMxf%`n8>DjPe&!LlF5gaZYIY>Y)?KYBIzUCo1Zz?l8c{d{5B05#9L8;@=|J`5;J;p
zl-(yPZhfW?2vcz<71{q~Rpy|I(8#lTl@}j*^Lffo9g`j^ke2Co-|+-g11$GR`oDIK
zkPU;#l0}C^_J6`zHvU@w$rfo-+#zXltPx*nK_2N`8m@X*c}D^HeISdjP$P{D=;Nkb
z74+QtRso=w+_{_Mog?Xg{zK4iIA73aAk%X>5DPE#v%U%6-twoS>AK<lhYI&sMqUTX
z;D(qrd3U(KAW{9rjG(}Q*em&wweYyI0c0W1%GYGbOOL^gdO(IZ0RPlZ;mwas4%9x1
zPykU}-Yn60vQk`01vDgjh#!7^TwJ2#tHmU2t%2M^5w`J^H<Af7UYwtXJ&3tk*cNf$
z*M5Q?fKGW+jJkw$P>C6XKkj$l>EXaTiTkMse)6yFRqQQCzUw5^`NhHoQOYyy<mTm!
ze0e^H1G8hs(>4mo<Od(iJiM6Uu~G+ym(7=8h*>w#OGkA+b8+gw4!m0Ax7SJMgvbGq
z8PF3pIngPS2jdUgmWy&2MaS<4dr!f}UXx>9zERF>o+IVsZs^pskFt^8O&bqedE#ZN
z^!EvO<71XA7$a>}Q(K&MAihttL-J|z{cNW64>LEaKU4WJ!yTa`orlcu1q?DYcdS-+
zGbOrL&;AwfFV?*l`Cd2jI^1%)>^NEbfzDMi6{W6F+e+)mn$4_4`wk@v^qWe7NarLx
zZA7u8wAYC~f=8<~uj-dr+Dc-UtQuo(3pr6Q&rwfaD~~zw$TK;#U8ZWo+kWKM2}V8X
zi*PO=eZ2!%La+A<$lkf<MNW#yosnzYk$>@0U{ctXX?_%uYN6aKb7gQj>qllRC^|T6
zqBzMxinNUN+PdeA5opXp9jEt8CW*|Cp%R)%Q~(B+1y#etH<C`%je?F}YL3R<d2FWI
zIhWRs67ccyu?c))L@gYq-F#fwK`DR_V6G4c;}R3dhh63K%5l9X7_N~iemyy3EgT*u
z^QBBTk9UND=yiDt9z8eZmjI#!%Y=D}MDy-AXyAwF{bX8U>-L=lhJ>hKOS*YKDepZ_
zuVUc7<r)k%;@}b<TbXI`@3CiVx#Hi8;g=XGdZo?0EtE~GctvW#^Wy9fYaN!=-Dza!
zg^WME-ut=yUP}eQT}qj6xD{qC%Y=PT_AHoQ4wf|?e7U<{i9<-G@bo=C`dVV-&fn}_
zLWG@KZS<)&T!zIAEGT(DnnKc0iq}#w^lG|Iu}|FqgLG<063Bpx`!0RoE%eFsVKX&Q
z16u36nB@^#`JhWlk(?};tZu?OBLu)95p$^QpklNC5PWzr=@bUwH{3D{8`=GlH@_1G
z6MuTNmD+!`Kuojw4HW)$5go=9a|o5XsdnRVbE4XYmCfW)y;b8Nz`2buFCBNM#_i6n
zoj!rCO$g4#Hq!;Eng7}TR=NLKv7twA6sqN;5?zSi?VD^Rm7UkDk}N8GPL_+>A_bah
zlI#*KzR<r=^gd;9ABV2JoqS}z|JmSPo`zq5_tq&;zrdl9DhN#=DGP=XPrP90#zh`~
z&p6fka;Ao&=q0=wXV2*T1tFoQ)Z5U<|4spw+N?^2{_?Q66m@nu!$e*wiw#+YN9JEk
z^a3D}1XQ2A5~CGn^86M!9=0S#|C0E9Tr<`sSkgUK=jEL^^bW9t*!*XkS0$EmJzH$D
zz1SrIlnR%37|v^tf<@YMsy1rJ%;J~w%NKH>@3bVh6+Bm77oh-cLcN{muahHnFwSD;
z{}t(i1~zX013wf$Mz6DGi(c+zqv>$k;v%5?xVrNEWHn6ZrBa84Ypm{0D;|?VlnO6a
zC%o-cN+GSeVYTdC=Q+j!*)Q7|t#l;@=VQ=QzPHCQP489|n};w|M7kSzwGbG~57}e&
z8+`v~@@@_yR)Lp{Kpfeg7DqrEEmbx4EU~kks$$xtb%rBKl_QISQsQFZo(?B~Z)56V
z8Xztgq>cSN$Q6Hk9DpQhOS8$QO_GnPzXL;R&oTkXNzQG=VhSCUIEgW76e?H*C%{M4
zF_Jsoudq2<x=vlsj~A5}Qs&|!fmedH&@C6IEp6%oO%$pYJ5R%}&d*&!=ZphGyd2K{
zk$uQHEH?E-kCm8nWmyP)6BQYl;6I|H9HJ>UCE^<)=(RJiV)&@#?7)*j(nK}SEKYt!
z5w~l~V@B%O?e3;i{X(+gw8yj;M*x(uHeZ$uiV+tEAij9xSR}B+E$a~w9rtj>9dFO)
zuLKsI`6^ThvP<4=H1KG%hl}KVLRDjZoUkj(LS6R8QcA+&x`2~e{m9boblH}vggWeI
ziETeunSdi@9ItXcn8a8~qjIhXIIIm259$bk_D&qEcJ>ShGXIud?qbBnkHL$md)wK2
zM>#*{InG9o2&mwj0KCuRwR<(fXX0Gohf!EHT!V(m29&|?0al?qmGKpy>RMuwEMifL
z0$qYhH72VVkXbcR|8y7vl~@8cY#MnI1USsWl}C(C6<Zes63n}jWIc&Z?!vk_JwXnN
z!#F)vEhwYyk-{@&z*HCZ3!`Cy3g|X@46mJ`8{y9h)x-%lQ=0b*Jj<Ar^V**~x8hJM
z#FBUE>}`Sa#Al6Ud)k=?YmYa!+DKxbaruZ}p7GW>+<Up;qdl4toM=-vcNn+@;jHwe
zS24=ods2W;y(lNHQvnr0TzPSS?z402s`HQSuCU98et10Xv{$xWbNAj^XiafZTcPw8
z=J6$C#Am~uQNUZ#x_ie{j&)O1{Ppt*f_^`aR1CLLWrei2?C`>g#xP_W6)*7%CKVeX
zV$`NjbUZIp5bd^8Zezq?T-4Oo7f-2ISlCx)dwo(^(XgJdns02uje*ehC=OCBO3cc_
z4>>>`3$x4Ns;uPubpV@1$MbN?W6r$dyZ4@)pVlpLeBkRT>gKHwea2xC^oyx_M&GMH
zY#*G2q=eDw<Wvtx@X&iN<#n77xQNblI$wEx*o>Wqo=(JfK=MzsepxhQnN*=dW8!W7
z_+0KsdCD8iId`Rf>Qq|c+3I!Gk22B+m9dI*%0g?TSfEMqibGm)`D<R*6GDMi+fTQD
z1l*ii2hxaW4dI6Y^}n10S!L*zkIy9SCwLZA=;kA>ghdx#e`V>ZI(DTc;mIDRoWAt1
zd%f7<aa@fsM2Wdo*ppl$pHyn72}liM7I+C<p(vs)d$H($&cXePUI7EZiIQQY)K$S6
zlUr{5o^Jo5AZL(s0W1Q0x0MTZ1Va8E9h3$Ns1VGUAax_azZo=iZ&u!Zy48xu;*#G+
zChh*kt|$b+O1m)~>_3c%bkCE#e7lzwi*pgoR)&QyZ>RJguRv^h0Y++lA%voX+Kr^_
zX!EO3TT)<#EaFvlyFtY~`;a+4N8{AdnmPEC@_~g6N7)8naM|c|<+@pVZ{|myelvA(
zr6-)|l=*f5paHRY8*|dF6HTx_0TXdDIcjz<m^d|2PF}52^Lg2>C(5dd6j!2EilL`%
z%0Wa5r4DB!Qed3mZtQ%@;RVbHR*E?H0*3cQFvaftI;=&Ym)}1kFZ;(;0j_Cg=Xo)e
zbmyB!Y(!MLs9IYOlofv76POpUSLNZPJ#pAmX#NNj+OLKK8a+a;E8)GjG_HSt!BQg9
zxiULi^F=-58L1FHx)3hO0m3F3q;%BE&@R6$Fg0H-t&3TFd^IlzP-+)+*KthzVn14p
zSD2Gxo!~KkzqNs6k;alNvdMH&+C#EM(2XVha)7{?$BMFmgud+oB$QNPxswi2MMx@p
zEI*+bA#bkWg`m%yKLZf+!h7%n5HWI`FMO~-S#2yqt}6uB)wmb8!d%0_sIXa(m+Tj2
zIA>2BWQK;81cUX8)kMS<1V(I|002p~M2r4{h{=23kdL2|gN6TMjepaShDMEl)id+S
z+04b+y}fiVLwW^*O&m30m@g!w1iJf}Q!HD)@qT&Zjv6mdevoDs6!8sX`CIJH+>}ds
z!gH>T&1c6+24=K_!Q)TY?e9e%?g`cHd!Ox(bvdh%#LFKS(bv3w(CvXZ)G_O3_Qh}j
z=>>~GFB5(!`fX&TUpM8`Mpw@W+sD(NJl-z?GGOm^HJ`|dVkTHd0h4(N({HZ@u=C?2
z9qxd0>-)@VfEm7+?el2d|Kg0LGLK1DVDz!vXeKrpJ0V6s6Vx*tNz#dNa>MfQJr)U(
zO?q8-lPcIp(hE#4I7=%B@T_QCq{=H6T)e{_UjWd@%v{*1F@I0z@X1GZFgu5p=hye|
zo62TRM(ZrX3m^2KLBru)r_9r(mOjogzoaq%+${zK4Q{;E%EqVeWmRLe4^9ZW!C*y$
zDG$TK)*?}x<20F%b&lc5ddiL<B#}4PF7ZF8&Y_H;RbxTJ{T`Vh2r<LOT6-{i1zX%+
zd^==mjNh5nfkkjM5(O;*HYpC&n?&gsvbX?1iD|kt5m|-if4eT{2fW49r7hbVveS3?
zZFc5V3VJtAI2>a?AkKv`A3v6`S7bE=Or{}A1u{}6Ao#I6D8nT6um<0f$TbLd@AbFW
zKvdQ4+u;aZ6*l@d!84h8qTwE2e6|93jTDfS0pmA@gAuGcvy$E1i@HvTw*k&_x52#_
zqK!LGhYFYNw-^*M+S&O%4<P$r=~T)28+9_}TW%AqD`b46rX2$H-CE3iJo`mr0C2Y!
znW4c*2y2A7CY56nRijCq@aP8A4iyrQ;Y1sXgIJsea0YL$?QYA?GWG5N;A&#h4;s6|
z1MpJM1HVnQW35;|v!NWmDpwH8vd0s}ywUWM#C33QmsD$1=GQd?A<It+2CfoDI~vFe
z#7pGdvI?OZy}dGsPC<J_r>yeC2A_Z_&z*C)@lZxm&;R0dCUVu~4I6yfC-1&1Q#S@{
z)ZkabO&o$ZKG#(|G3;D{{h-FTY+0Ld{P<aSGiH8R?{T^i#ggTZ;8QZnk>JRycB<=e
zKW8yx6wJ%yM1iFm?Kv+vKP6Hxq;B14RNXk<t=dwXfWlZ00~}<NL61xBs2I22fb_%>
zJFAxUtC@vuX@Ce2gcj;vQ}!tUt%(!vfcaCYdR1X$lInm8VjC>ds9~Y`Smt?Zt2Js$
z`sD=hzutO!n;;^=x+k3I0K4O5E&prsiuL^Hyb{%RlhAMdAqrkI&{q7_j;b=OyoUWz
z6PCcaIy;nNOM8Yp;QsEqt=*&H{;Ezx!hR0@N;=5w7J8*xKVG^6DaRCyjK723O86`=
zz*!3hK5m=KunJK53Um593K5ve0z^(8U@fFMlZv`!dofleJ_TVCFwJ8I@_sWt0#K`T
z6tJz*wyHUDo(g#@LhQ;!UW)H3BdPN4K4HyoLPQQJ!gja9<roc95D5g=zezu3*TJ#+
zsgvH6eC{P19r%WUK2b?<mQ(6ZU9|TF^|TW{*BFX->)*ScxCQ`O#*)f_sC%1yM28o3
zuQt-hi6OSMU<cf!U$A0RIbs5S{222;Gf>6U-bhzPDb9jUaE(BpP{tf8VLqExAZkY5
z6P#(ma=LNv7Iab-dG_Kk6*}ljg4=U9J3B6ABxI$8`lTeuJONzAD?oY{?Oh*sT@$%=
zGAqZr2M&Z(^A{(|4vohIE)oYK$alJ%pn2a^WD5LQ;3Q5ETr8Mg(@e!i>^e1P>_6&Y
z2@bk6#AbjY=Imqj=Vap?DA9yLtXPd@jg+;)6U87aa1bWG8ey`B1h`jtp2&^_9rX2E
zi09r%WtK{LQZ0gPj7C8)IfYlg4xli=Muan!6}J$qRQJwzQVc*iQTLLM0r+Y0XbDTw
znG*GH7;@Lk6>L*tpU$&%#A%GaMK|>^vpJfUn;{5esmufup2Tf14Wkj6LR%k(JZ!a2
zV$@#(Rl_tS)X)qNB690CiRs?yDG#G|LL3BOnTv0<P$<EyTLcsLQP_U4L*6%Z_MY!3
zrmK{sbDW^cJzc}ykd*XVd&!sJ>k)s4Y=*qRmoiui$Y8G*62cGWh82TR%Z5H3>Ezwy
zj2smA2jsNl@ZBEx;@i7IWD(HWc;-BuX~KMCREIBc#Qq4t8_e0x{u)*xPN6X^ud97~
zJD(I4T6e_`2ot1)MY>5Nrt;?X{3?PQ?=mBbDho@<RDF;t_vPLt5xDSp^m~K(yD=>(
zHyIUz{FG!`i{-=V&qB|Gm6Nn3RMIXtJk2@!2`#7C-L2X(xI-mJWt4IV1WyFBGuYvt
zND!9g87=DZoY|~rZnQr{6U=_^Wyf+hG+y)VHs`K}?AjI)dk;4>tfW}IEZ$+x{lxg6
zFbT$`@)v~x%HJLd3RCBJnA^L210F}0SYJITeT%zi8G&1pBlnSIgoq3=t1)G-nI0&H
zVU=o01Ao3HLWU>X04jAY2S<=}(|7Y+)(h3DzLG`Zc4MsuZjmK`S=6^was^qy_@hxe
zB;B|OLbja2kqE)Jx@Jiw_6FWWTI^~P3bdOv_Q<MH4i_m3Pm%&`lP^<!cSuk;REO6v
zY#br;Nvm^i52ERN_%lo9<T{Fji+T!l5Rv(;h>dtd?7$zxgI?0Zm}v7XO0FrOvW<Cd
z7eEp8g+J~(^d!SK`e4k{efXK+EaEM~L5B+HD_v#_W=0i$&N&$=vhXyo9UDFVM-z8J
z09C=Vap{7F2=n3Ns$vcY2`P`tfXIU^@NYgKVWDtMyxmB_zjg~7|3$MZ^g7NWIuQ0|
z-?>shLgXuFBI0(X-!n~%=a}2jHhS7=N#2rpKmu^hu7a?pxf=Ztu3oyt0(A31`5=Tf
zGwW!8Ak4k0iUPQQd@aB!CtxIQl=GB^q#I4A>}~!KMmv3L+k|>pI<X!Hg_RzAmFzN8
z)|Xoac~&U(H<|B4;9xSz<Ty=)n?0Co<2eNk|7NVH8^CTaG!VAB9^s6PVo`XAPwZo#
zD`TD!=c_Jgy@jy?x$#}gWLP*A;w$+RPtzYsi$O9Z<n8JU>#%ysk>RmN#~$ZCjb>n5
zj>t6^JR=Psbvu*pYrY~`q{HO}2ET6Mu-pfi;zD`|6r)Mf7;ZzadrBWgQDeKxvx}CT
zdp2nAKrx$1sIjk*CBl^vU6`xhLKFm6V79Dw(8i6|$<CD*6o;rcu{$eiOPODDUs<ek
z%!7v)r}LG__$!Y0%l%EiGT|>!l~W^nDJ@na$uxv;yD3q|+#r7ZTiSlAGX4`*DIIQV
zoCls>-JGd=(t$UoMK*fcRGKDao;eSx;mpD&UHGtLhmCBqD5WwsnqbhbRot8ILV>fl
z$)1(eY^`gi%gwxyoc4H+$*eWw61X?y;kWZVhoW-sof0X3IH%pT0B~Vrp2(MisFoA~
z&$3?WNe8*GX^d8Ckn^9g%shV*(hwwINv6dxXs8R4nQx}SKVnGDe!A1s;fvgQaqLlZ
zYdutlCG7*2Ym|BW^Cxk=Iqs7#T?~<Rv)2%l33qUJG%lbBJ!b4*LECvO3?Otq2^~Zb
zx(1-anZtF%Ei{9x-Em2-D&WeYS>^L=tmWm{^yqr1;o5uS$dpwb8&P{jeAbUR`K3*&
z!o#cf+7vwv%KEa2Mv2BK5WZA9kMcwuKu$89O#k!a%14~jp3z&*E?V7WR=MZ*Rgl+u
zCE76)uwoGXP|j9QZxu)&S#($Y4N1=95_6#ZU<C0^N2Z&1F;{!euH=s4*umMRzf1yk
zH_>5NFxCY7eDqFU6#0pgzU)S1QHUkPb3RjHw5=_~01SsLeGT&tqO%P8;L|J}=YHs0
z-Ixs&<HB>AvFtbkai<j!?gcXPx{&;uTdT#kSlwKJhe#i+L5|z!4wBRYs!H%2S1qqO
z(V_#sK6i7^l)n&PNYr}~7QHH)KdzAen2XRda~<nx7Hjr(6)DCWClNWpHZl9opapAn
z3=sce>nqo8XjuE!U9Sdag%jn!l$>nXPY-~6KFzt(op6v+jSi^qr&Oyb(l1)!Tr}+K
z`5<P|9v+UXcD<J|0%uDBS%HgZfpJ~dMR`L0=7O(}6x`EfOEUM)$qjASdVZ^5iWlEp
ziL4k4XzW<gvnQSsTiSU*-7*#`0M;)be29rd9TbeZ`q5&LJ3NZ;naDn~!*JV?EtVt$
z7+R+83%Rn#axh>~UY4)BG4^nkawn(=EI{lS^{oR#>`R1C0Ml8(scbg>4Y#28$AFB(
zbHM7uH9oJ{EXk|1{ILbPxz8fqT(Z|=PsM<@p?xLg!2BrORtDx3*u6O;b1C{%Z7QIQ
zPDfdVpB7J*Ti!qS%u{r!4&;{a^q3z(l@N^)yg8*#MB3H&;TqqU@MgITm#Yd%&00Rg
zvG1MdyW_8arAi>Gge`?3E@rvhTam-rr9?jty($06=R^YO&1lc>Y0l<u93P@Jjqy!b
z90qZ4u3C}BlHoH9+dF7~*=_{f_PiZ!X}{Q7#+_Ct2nm=x;X34VD8&vP2#UVTIv`7`
z%%!ZY0TqtpIe?-F=Z(neG?7S|d_oeO@yhAW2%;G%A`l%dixJugzM4!Ges!8Y@u_5F
z%<~-O3v*3UOYB$*M>N#W?{-0X9RDbnTtX|Ul?)f>o~JWtlSPloN=r=&L_HP^`Q%}%
z*Nr6CZ+@w{eCsmHv37|=d?-#|@DUN2A&Y=`d9rV3507op2i^?DLn%+-=G`$qf~m^0
z8toCHIH0#ZhlVjf2FX_XQ=J8`J}%Gy20f5g@*4L2kfV1(mCyLqR+(Bwgpq%EI`~#Q
zsTLhH_8Twh-?Wlo{3+HDEx=n=Aj8wjin*KRCckNz{-~S4J{oeHvk5_m{s;@?seLU#
za4I|~Nsf;->McQNNl1pM&8iTi&>VgJZCwr&IotdwuuDyAoMIXWF{H4OwpWsC2_u7u
zH@*<pRTBDIi7)tiK!+9o?k;fz{&P#mbVBT4SENA*Hhqs~=9#2fYjCYW+1G@iEZ2f0
z^ML|M&LvB__D=x@h$<b%Zo&wTBR;d2x<QLEQpw#vy7z6dD16JXCQvWsIBDm_iirx!
zGTi8gS61V;EOpHi-M<72ifmx$6cT?znc4nG-hp*O*G2^RYHqR)R~AM?p4FrfGSW2$
zg9TKsE(8R~QW+BBeW$sy)m#5<Y7$8EF!R&D9F#k1a`H0dn9ivg>RKxP8rH0+!gk2T
zHbT17cbpip7`XG1KXIbX4r)=tBl&6cdqK!zu!OU;+k*FW(R;cms8J1{)r+QTM6(>z
z9HoWU#FmgAV;M$sN#E?v{Y7psh7)#QCfJ~_QuMXY5BuRe@V}yq7=ZcGm%j9NEV4OJ
zcgwgr6FAE_pTx1lzPvG-lLJwyi4ZWgbi9+FTIB<C^nz5sNrQ_dLE}22k_3swFAzdR
z+i&jJVyVz&6LCN|yW=vv2@eCW3|Vt-d{gnVJ5AymNplTgQiyQ1j1N^x#<#%sdcZ)3
z$rz{AsAZQIy)7P33vMMm0`5K%!k=t*>cFfZ5>J-<rt6PkIRWp@ov(<6L(Jar2BkHM
zZ5|Vg2MZh~{VS3p_cM~R#0$hz9<D6Haz8P@hbSBJsq%xI+R4M}qQFv7SL3WzXb~ZT
zz`Kv;A)fh$HcI0U^pUnjI0`ub3$Okp0QV&UP<()!6L3-wHpB;k2fQNKY@qWA6*4Hf
ziQ*_hDHZB27423kJkQ5a6VDV-d`BDGKTM5~^#QJ{4+UKN`~V{U8l>V;%ziX$>U{=C
zUS0vBLLG)bK^RT3_8Bpq+)x<vPoCD4`lm<$d1a+5`;Va&3E+Sy@mX>65Y`{xgz>pS
z9P>A=9jR9fRW@%^X&eOi^<6_HVaGpW!Tx0`MXp>9AV>LEezwFCTg9QZ+19gRyz7}I
zWwuIat+D0%5_Z~NHU8#D9Do1pi4gW>hFb9dlA%V(lCuoG28|6<UbC=UdH|KpU*6y(
zMXzwqyWRWS;rW?ukMqZN)kI3CO4h%x)VDNNv}8fAKv8$G6`X#p?$?2J6Js8;!#DX@
z;8x#&<RVr~Ga2UJUgppAc&_~ArJvL<gkltw>&O51LVu2sPII|QI)lHc1o`*>4z>Th
zogu;e2b<`-|M(EUrgp|o<~O|tfj7D*^43ZzFAk(<d7VCDdXjJhzJ~tP<a78zZ7KKf
zd(U4(o012zDY;Ye8MC79s_)KC0O@ZWxikI0F9|>M`63(u>$uq(fT&Lc+~&>hyS)nK
zhyHtMz+kdjq=t>2F5k*Og;21wKu)W+UGO&A6f<PsZn^%QwEMMGFlNjZG{Uo9BHg*4
zt0{D~iM5WPR9c(x){w^)MDc^3tE+V?nb3c+-d}|U;+PCsd2z0BA}?9d=|Zn>pm%~e
z?(NDV6JHBXFnbI9xg<s*ieUmxIpix4G{m?IhwSfU(ytTQi4zRgx4nicaD#il`tvBA
zv3J0?RgBU@ow-Ve-X)v;9aq4(WDeOeC5QkTQ3Lw~=I4G{0n?8AXLFas2bM+4G7h);
z5GJz0H?`7hU>2yOw)T&HSa?r7lVRmijqn)6e}+{2Ii#!?>P96tTCK)38${iakizp(
z+?(h3y*1EadZ{L(E0j?;9w+-d?0;E5yRCwpUwHUA^yIIT{k6viBFvJho&K0z-Q_|S
z_!S-j1G9#d-an2{pApl`_}xP7BQ;b=3gPhQCLfRTqCb`w0JgQj-bqXo#DA<u#?K9!
z2znyd%=&AZU(^#3z>MQNe6&!Stf`K?Vw@M^wfcxV_II{>C4+hUEyT==95l9Ot(G2-
zZI~CLDzazx2iGxSda;}2PVu8^MR;vu&hV~&=$D2YO)2N|5K=ObWBxXC7E@qjLBJra
zh8LYKX+G;}owRR%Yt&!68K1g?YMJ|^rv&fs6qMk?^wPk{!Ldq#!0%+TUIX&uz3|k}
zgin5}6p;lzVaDEaAXV$OpDySF^IwBymo<7QCu#k@)I{Z6VFW3=y*30c{5<U0=DQo}
zD(00+2c4?a<v;$z{oOK{2ylZ9PwWIp9ZG{g7G@gmjDfAtCr_l<pyo!*@Q=>^Nz`N6
zD?tlTL{@}DpcyfuI8N*3MXp@^fUaR#q-?_vt@dJi-ILqDuczcG_SfPNn_}UTv0m6K
zUbMFp3NdO#VB-I5EZBK}X@X_-OV(_v&pU`&BlY$QMSmfT;3rf6C1xVmF~Oy*6Dtm8
zrIw#$DQr>*xSl#aedf&OU%%#S!vQxdU`6j7o@f1+K_oF%Uo0Ssw>=!!fGQ{5qlT0|
z)fE5RS%tB`ofh!N2nGg+QP0@GHR)8Gu**EX`-h0+7T0T=)n;>YXaA`E|4EgsDmLVf
z%BX#ULsFwG#~CwO87-4_a<hp60oMlwh)V^<#LirV-u@qY3lxZrX_wGpaJ!1E=*EHx
zX<4Cz{#~`-Nd*d&1g`!`Vfxy%zgYN}Als?|rX#(|=q}f#!2d;?pZ~cNAbS^hSrlEz
zU+qgTnCgr4ek)z3_2(9WPr+gi*{0lfo%t?vdPMe$?FvZ!b_M0%#`^gOM0>Q24OMXa
zzgpc^2GG6hUAJ2(erI@Kvc$_I3$Nsf?jJh>>hk=6m4AuN^5gn_-N0O&mu|d~=U&0@
zA_?gE+%u3Y(pobo-Yf8tBU?X2^T+$v;3O((a%qM?=guu=(I!P3n_rY-KV*jE3-0|%
zcnoNqY%U;*;*a2~zDQ&LXDPJe3XEmg*?%gs%M~$eXFEr0l9tU5Cbs~i#)M1*^^AW|
zJOQwMY#)bw{`_}@EW@QaWl3#F{Lh9U5x`c-i2vmT{v!McDPU$Lf?lit|DPxj6P=#z
z)$xeDmc)QvP=fP62l5IV12p!*jv1bGzu@t&1^!||Fy>t-5SXHbOBns<khO0DoRRdP
zK=^mVbjhdx&mY|-Ei2%Gd)U#4SgI_2tX?FTS^76`|8EJGC!Fl8$!X1{p;Ox4B`2?l
zZ1CpLJ^OR6ZlzpF^fh5oxzZ{DK#ZazV}8>lKlh=49KrkV#)x46_sYFrsrs+jkn->U
zhXD|>!IzOImI`&pj>&|ADO3U*bj$DfULBaa&E>;}fw)r#oj~mj)ou9pErvfl2OeS!
zJ@t2Pk=Goylij;xD9^=dX1c}-I_BtC2ksqG`VTraya;!$t^Q0cut7z|CmK|nZ(`_x
zT`XIbOv+PMU*i9Eqp;5jcllol&dWsy4j`@|xYeJ9r8J=nOb!e3I>HS+SRR2ZlBrHt
zgA_CnJjGp>^udO56%d0+Ds%^T91q9s^Ym>!hCh5lQ!)$=TScdFA+phzR(4AhSXzd=
zK2V@8%-xs8C=zC9>mT{yWi3sDl`m}m4X^E=0-vY=Nf3A(Na{Uq(O&E^Sdgb2`<=~<
z8BS{&SbN8_nu>S+vkDb7xPKB)2s{M+U4n)@u_5;mbV{))q~&IsDvc00)9s98eCs-V
zHc@G_6~e?do8Zu^#8Lp-PNS@iWcQbnW2G9Z&I&oNYKaGQZ$A8Xcv*yjK-HU8O6l%H
z(O3gkxSl$=Z2LiH&B1ETIfcn}vNE%*9Ormb=T;aY)01+2CDU65b$9K4XDQi5*p=DO
z7OM^3`&BY8X;{B5tqqH!AHIy~mqmi;GF$G~8x&WIz3KhK*^>~)WV9ad3OBI1H}hE(
z{i2{3D1+2M8Wt<Uh`ROR#diy{v+CR4to^oLSZ+1++jN<9)3&>tnPQU=N^v#u)dL$g
zI0CFxo*Y72^{7~3U&5s2j@KV+)Puf1H<j|?#rO607y!5R;#2o0x2j37po1LxGX~T7
z4n946bN;ILA1VIHE`{<}oT$ypntdI}7jC~TE9ONrtD6h4m^;){EU!2q)Gdpbvt{o7
zRuG&^2pKX`HON3jzU5JFkRV5MC-9k67x>mTyw`ip{hO$XP-14qKe?-bv@OuhFRljj
z$Cnm*kKUpE_jw2MKa;g#F{LEu{~{du#ElAd!^7`TaAwr8r~0#Ej>cV+e=C_>JK&18
z|2A>k*GB-qaj^Q1BJ!0=`V-=7LLz$~jyt;usoe;x7u^klq9hL$k~IJQQ(4fRz$*&H
z_h#7gJO=bS4K$JOA*u~8!itL=v9k2c{Y!7|I^^)NnEuBhPshX1?L1tqZXfO}5;|RY
z^=utz=buqE0CE&`bc5L@Di_%-AMR58dry~|Vg+%<5}2(ZufRuI)!-dI^^t4?kkI)q
zu*BG8l00elr&*PK&iwuy?(4nqSjs>X5qWS;{E5m^T3Z~dgGx=juhFDY?N5DWYlhw6
zL1G?Iy0{YGHiSyYAA_*KrCe2zDhbzT4krK541fjx0rDJ$bsJ>obKz4*2w4woFjA<c
z7L^tLT_yUzO6kB(sO%`}{QH81ra`uDhZq|={YH_GVTJZ|X{Vcw=^t8uo&=+tDxXKo
ztPF7FOD0Z$uYT<NCH=-SvY--dY}~!Rl$7GvAZjS$@prrRQMIM6hLGP4WH%e81LEu0
z!S~+C%P+?g*rrfXM#k@w`m)PmzuU#YqyX7Sw*Dn2voc1$<8it-z`#cMJ-0dk(6g}I
zRpy~VNw_872l<_-LMR+TKJeDJj*6E8z0wey{P2&<E^NulJS4765<w|Sj5fAFtjZH|
zu$E~5=di{Ua|=#~Wp|>IlViGa?LgE%PIAcqTs%O5ftEZXS_aDMdO&0p->5|~6!uS=
z5Av7Y&2@4z>H6$rw=~^~;jAeS)M2kuedhzChhMV&^~JC9dRdUy1a`e0XpDDq%`-2A
z@;@vA#>@}doN=<dFJ+*t2FwXGxOVgB`}`B~_$l;1pt5R5foHe;WXirn;OekcX<<Ar
zm7TG{JIudx@sJfM4K@%~ATj7?xc`w^9bd)-QEUxyyX5bGapRBzDDGNzEu5hq!?ozp
zxz&K0e~rqzUk4S%?k#$U^7oImg)trczP?KV8EDETkog6YmQ6fXL_WmSm7&7?O%rN{
z$}*`F&lCmgwR!lF0I#Nc?Y;}C-&I7WuN`Z<{cCz)EwY-Rz2({{XE(@QTLM&p6!PIp
z*h%H@%muj4-iPpOC&q^69;9Ulbpp_k>cuC7gj8;jXX^sZeiQexmzW}{1+EfO8*!_j
z4h_G2$CtTQi9)FkRFfMg6`FLe^imG4zD3m<o92HAD+r0?lWE&XnO2Q?Ol35&*ndxU
z+wuL9Rhql;7vI4Ju}`<4+A`QH$MBKzI}N(k%(>^uQ&r11+3c_Oom;Id-`bh3O))dD
zb;tI;hF%#fdT==VkbnfBO0^94dihM|&E2*(twz#E?@l`eJvLAky9aHkO64^$F3E~P
z<I-%0I`49C<NJF4xT??k3`<ONJmkF}j2=gS6OeI|y^uDSy=cBm4xtEL7PeMqUJ%RE
zI6FBwh~0MkvNwU=I8_ciW%9bgTS>flFmCn9xxIBVR1WL(t%Md60w{}n&nomdSxV+H
z;UJEh*~NL2;|%%!$C!uDt(%?9>9cL-wi>NI^X}EjVM*Bdw|%G^={(>?1@)Kf4!36t
zIi8dV`nRGic1dVQWcJo4i;wDcoKodya(434cwa{+O`MxN*l+!=sgePvyNhXR07_Jb
zh#~C1)O-kX&k%HXKre5X16M+2JYohi@4dBUo02^PQ7LwL^b19X)BD2Xd`1nd-cWjM
z+`eS)A1Rz8>c}CXJS9H9ov$|;*S&oABE;Hi#iZ=!t#ALhsbJO8q=aB0nJDwTNuj7R
z@p(*&F?L_@gV>B^=~mJpldfc#*e*3ML5k^_w&&XGx@TRnB0G-}rjavuSip6W<(`m6
zaqp+wHcT>hu@!@iZIL-%j~AN+Lg<`)MiVD+wvXak&rotNl|q9LC*OSb$~wk6W3+1X
zkv?N&dpX+U9nXc4q((2b#zYZfylJv5m9fxhci>>^wf+*Fwm1`gcV(iQZLNON8eK!~
zUhYFlO;@i@6u*5kwK`<5Vm6fIESF79vA>u3aq2t$_iQy*sl_e2?<H#f_j;sOd<T9U
z6SirJvQIx$5<yg2)Mbg`+hkW66nVS99JqhxHM-_y{<ZzJISR4d;gaoLTD>t;ac(UC
z5=|nN%Qw4^{!ot|OqrrqY7vdkQNFo5(uB%>_vkwl-GRhhTRpmKafYTaos`sE`p3>9
z$<;P7qj%<q8fK|Bkc3eyyycducXy{_)BLGkYMgAY*CuY@)WiJ>FJ4rQ%^NPP&rI91
zZFbL@#oiS5>bLfpsqT=3`}Vh4l{2t?6u;@{{eAtNCjBk`YRjJB;7}qew9wJ?Qy*94
z@_~&B*U+S6lbrb3ycFs^0k0ELvj1t<OZ4l->4@mow(9TKf>9|lkF^cml18(WKa38y
zYG7{&qIM4bslq8Z1WDJLKNX_)^bUEmb8Jv<bESi!bdP)s4fQ1-;%&UM+H<8Oai10Y
zB$G+b_;jz<`Ox=en}(ib9L9GBIaTrPrL0NQ>ervFLpLw>?qMvH@GVaj+t5hl=SbO{
zwQXsR5!~9Wa52;zgqu`Qw%jv9tOmapZle@cYTnvG&Nlhb*56tgT5rQR(AcZdo-AX1
z-v82h)l>k1$LLjRxb8N3jch=|akBz_QcM|}<O942mf|&}gAH#!TVO$j(v|2ZRSx;T
z6Ee#Pbk3{M$`s-I>bgjXR$Lu?+!v*n@u)^geD8f}TXIG@ouGAMLYW3~!|VQ&qcJ`$
zlea5D=B|_Rt6}7^6I>;=opHL(l(7#|ea@mI&_OdZW|E@LvN_JJvA6mBZa3dt%t$e@
zRGZvY+YviI@0NdiBY2bQI&7iTgWV)82VbB?w6*2Y;VKZ03!Q)I$eU=%GSn8Xe=(qf
zO!!R8iK0XsBAs23hpivcIR{tx3~g^+&#?5;o27p3PnEhjpGG}HOl^7~d%YyrV2~00
zfMcD}ea7q4$i#^uF{YOEsXOw#un4Oczv|>6)=LlDk!+S{DL^fz_tEwkR=$1jh*4$Z
zYH78a_-w8t>h`459bSKy>43@NaxLBx-)cG{VH^jWcQzM(rSgoEKAVb>RAFN?nG~fX
zhL+FKB0L$+UJL~KXOGO|G|jpg>gC7n-bKSUrx_NT4qX?{+^k5;ls^!jZQjZuA)m?k
zNRZ%rNY8jx#yO*+cL<|2#v_EJy!krUkNsY}wo|4LQJ>c*i)_Z-x}w|cm?mEKugKqT
zIh`4sxHh(6Y45bFk?pz1pLegNGc2#x=sg*SNP=_IEq67~je<(^m71U;>sN{t4lVtm
z=E3{=d^+hXB!g+ykgskt>gd8-*^$#<=EqaqZgjE{Ror@H0t(|8VbD@F1{#sb%cMmg
zZCd#rBU#*un!NW_<Ug+fy*NDL=?B3e1BP@efvpb{Q;x%iE?3^PEfhCk2k-ZLNZunV
z%~NO-yLT(o`$w5M10gXd+oo0;E&tJasd;ZrkZ%9Ch6Cf^Hj-vPha!S_&buu!l2_Aw
zx077Zt;%L3Q@q(vQy4@E3|meNckojr$;&3b?|U6|Tt`n(ceY17z{~id{HQW}o#Ue+
zv-AFbYzQ8ck5m9t)w(_%LN8{rfM1Po)pzURl-o=nTHYr|UtHpuvzPz3+MIn76>40P
z_%c=@p5{w&d1KE+NRo!Z>}YECcwY{^)b_T{#%GR_aBN=LGnvtI@3ZZloi`SDBs#ul
zI=+R^kd$tzaiXpK{W&G~#_2j1otEOx(YrS5)IB)n5nf3^DFMpDNt9W{{l|#m*$sU<
zikO>EPi>#R#$&7*YuS7{FuKre0d?q$c*HiwKH@c18x~qE{no?KrazBo36~k(hfnPp
z^ciiP>0l2B?(g}BZs(6_hH>{yEOc)7&@?5Pl)D27gUE3-BR^fWv<Rx!QnibmpZz-S
z+Ug@eZVkVdZ#uLN_MuvO-fq9J0F(+wiP*LuI1XSXgVA5;a=33lHRO`9Cuf3UCww8j
zZ(*X53|nO`(NgKMUQBcL$`o_k+E-lO8H*WuW`JC2P}YoB2lErgb~sl&j5b4DpOX$>
z9nSV~DGB*VAtX?^In9Z>(JKkHH|f4hCX-lqxMt*gn#FY>(bo7WGP1+SDJ$=KiOW1l
zDojyZXu5<5b;D(6&$%FkoPDgwQzsnvKHoy%Y4n<_c}NtAQ`4=9(PU}*PAy*EPWBqt
z$o?^Wo1Ds6TI*!GWO@NV;e}w5wnINxU!KiT)vgT(dlhBGw4*2X4+)0-FDj`0nvlJj
zCqDKl#RRs-)7oBM7T_s{tt#M6dzh;)*W5>Ix^la`4|E}#p{0!92TW}J2~p%)E#zi`
zPITt3j}lQd@Aj!yl}NsG%b(V91O1csC>;F^rz&glgDnPBVW<<=>m=aya0kao>y=O6
zuie^ciKg{Q(+a0Z6Y)~YZP83kY$^=foMAYXs~q<<i4f`88P5}Tomzi8UE$e0U84lV
zZ*DNIpCIBn1rU)08aD(!uOBwj%*`Hukk=wQQ2ow8lT2!Gku7zn<z$Y*e5Wc7Y*FJe
zX-7_{?J?*`B(?vL9neWDoSAfTNHZEK{!m2I*~aPh&r)tIYwirY-v{0b($#T`J##jv
zopztc4Rn*?k01IXBkWLl7+oht-4wB_ftIV_oZ}kzIqdJ}e)~i0+@uNUfTu;QHizAd
zNK=Zyl~rMsr>V0cnwloUwA?ItvaXvq-@h$@jolHw@5p)}_kNLP_hh|x@;lERvakF{
zXQk-qI(F)o2gGy!e(Os|l2jz$_cU!-;fyd}bipC@*c(hICcQ*032PgcCv=nUOgIl9
z56G}1*JUA{)MoB2As=tY8a+HF#s(f~JRnlI#oDyV3@^o}HZ+f#uzP2YX0g_|fA%<e
zL=7qJ^2JOkXe{=yx500R#<45sbx5TY{$huA4%^{4S(3fe)2buN_6@{K4+49eQuXT9
zO6e?n^(r9L+1pw0=A{=4+_KM{bZuWu$|^04fJ(W9gtxsbs2kIl8n=6L!>^V1T!30w
zv(j*vZjqj9)VO-jV$jR_EZuhWD1y95IV2dvd;c?@acV1gSC%LWt8Rv6HR*;myzRl^
z#8?FQoo?g+K95Ou5Vc~BPbO!ATTg@54vkf&^h>bNa#tA9#=T)~Y|*ux1=z}d2~Jx`
z121oOMj0VFgPW;sIS7l)%?jcUoa~FQi8<a7zQUtVIo|BOoBLY^xLbBgkm;wVO@f2E
z=wQ<2?_tKe;clZe^tf~zMnQLze4t}9KQ!($Q1{YSg@klka4B4uuc)fzFuakcT+#}i
zd%@FB=ZG{G-wP<^^YvsB)@`KdxjOcU0*#t&nd&AM=0k9bJH>j*SigDN2g>XF81{(z
zV8*6T6oBolYCZ`pt#0ev%ClOVonXFka*b+3$yVKDkl+x{KT(zXgo}p70V-Qxcsq+B
zXFpoha4KQj(&VlxVSjpdg!Rp6tIBi1_Aid|CSg@8+*oheWA}1;M5m+bwsF~<bB!L;
z+CQB{B*`JS9>uFBI>SoZ!Wb*=(g;6#=sBBK$0CiOWVCXuU5&|TA6z&$vfYOYXA)X^
z=aTv(wtYrR>d_3<yn_{Mk)G{i#y-w>TpRg*cqBCr)VQooZ8ISb`y+eJ0^-g-^UjmZ
znQ-A$B&@OznmZKus+8>>eZrBXSrnac-gk~+GgS*^`Xs>Qf5K;SxUXFt_x7=j@BMMt
zqXsrg(ar~rpM-gPh;i|S8qnrYRXlv_suBPTtZ?S#e6x&|l0#el_tx!2tIv1w5VgEn
zp7jcPKpRbGMICRW|183;GSl90=e1jDOI4?UI@HQ<Zi40OVn|9?M&;hZi?P7%jiIx;
zw{CE{cJBPelqXGUzSa)1UVb|h9?zz^J6%rJUP;w;XHFui9vt6M-#<T%+=w|r@GN>h
z8mJ&bAS4^^s3G5H_%fI-G5P9E#vggq5H5P#-t0;X9-d67Nh$z8-PYBru61!36tdO6
z=TnHA;y~WwUr@fBPunv?%Kh$Qn#JM6IJ+0}s97K7c0hX?y3RW<{aTMgz^pCf7T<jK
zkY5U4SULG^X}=Vj+bdmr#{UbQ-`)ApNXk#p+mLa}_n6|fJ-!Yqz4aP@VjY76nkQ&B
z2=;XOE(v9miQ&7eUpy=|jIxu`(<A0d)gKR>q%0SX<juzuP%b|r=cT$zA;~LY_(8k7
z3Y!gQH6lzZAw2NTTmh`etd>Yx?8j*ujd#a>s%5OC=evq}t0%>GAVe~!3w+6<?lEWi
z+TXSO9CA|qq@?f@m=B-XGe)0!AMIBzIok2>K1n|loAws?YR#zF$ga}B&&%C1rLz96
zkQb7e)$l0Ga3;<M)o~)M+ZHRlfMLEZ>T5|z_w*CYbEU65rtW;ZAxq}Q!F39+^R1d;
z<<$8IJC4SysEov-9G_e8-Es~VpbZtLgTm@+VASFIWVK2he&x*}=MwhzEp!(lQ2w6I
z@ODb@ZCkqN@@=8jb<OXl-rh#W+c6OM2<gJ?p@01?@WzsBIM)H*wP|^>)3?VSjW3Wg
zHuh_bRSnyc*S)9@Mp^}R1aIf2!m!;ZBW#3x${~q{6je56o?>R%i#hJ>O%kg2vi-dr
z_RM&VG>j)7p$T&&AhHb!gI5(+y$IzjnwY6vI<td<-inYt;9WxGuQ{5<qOJKfxo3MM
zj(sSqsqfJ;ZTKI3eiaZz;u}#V2NAnIcvh+G;DnpaNUTX1`@%noi_y~(d7-4l3b}X?
z-5nP~VHGP>X*RbN{Fcv7e8;=V!L8xQiR7qD-1_P4OP>zEi#VxUQL&x_@Os4__IQHq
z+ua^)C>o`M_bK<%z^5u2H`fRAl9Hqj-D_ODJ=AT?Vxv-NtUV6|ZZLN=s33%x9+|aZ
zky(XSobN4)g>5H82XVA|()2HQVK+xRNnz8k!yf3;kQ4YmJFh!P4}S1{gfFV1mNKUM
z#_X<zeHSPV^{R9KXm=53lU|4M{`39DL>8c3{y20$BE``!le|mj`?cO~CKF$J2lJxU
z(svItd7928dB)NL6K`VEFAm<L=)!C+y0@K)tc*RLyW+!dga?lnWV|>)y?eG=L#tIs
zZ*HE$#AIdmW}&mC#C~{@scOIG0*US!$IWbmUwjszw}6J*cM7?d=mHH1v?>6!h5pvn
zqQiiBpD(MGMKeToU(cUPX4#k{(MJ)V4i12qPJy29b}f(TUDs6e(5QJDScXH>g7<ZM
zCM7QEI)h$PezGXR4F-Gr?WLD?qyT=!aAuAoa%HFtTt-`MJR4vd*7tdVj3|z1+Hlu5
zhpmJuKO#*0K5_f3+ZmshQRcy<i$#}SMXPr)qTFvI?n5*|8b!s95XK9`cS3Reg27be
z*mUy=(vm!nsR;+2YQ<gIC9&BU)#>!pdA)il5{t|ICAnRmlDs|+FMxM28^0DDGV|+i
zizhmAg5-v!?h86HSh+%h$Fv`(Jm+J5Orm~&NFa%gq~N<g%bnYd6XQo9mSCc9Agha%
zctsA&Rg($T{+0HW$3SFRC0R}ewyYpp6%j1e9*(0$ki3{0j?$HsPyWi1EE#qP6v2%d
zD?I^)s1)`q8XXsx;<%LSpVajX?g{i(dOv);G=FpX5X=w4NtQUdrp7@){OmC!h<bi`
zkg8ce#|2vBkuw!WopeoRVAa!yO7*p7*85E9Y@kfeD*1-FGOcx7R*mc<{_4fx?JIJs
zxj8Q&GWW3w2wilW&pYI!w@Qre=#GyOTj0vgO5tYl%6$yJl2GuxDN@bLh$aU#7u={P
znwXGpxE(dV7yf{XYht@Z<RMepDWfsfZ6xnn`l-1HtvzE|hGSFzt?&J^Z>wtgXo4U?
z3)rx;44D}tNvpPfgJ^Tpi<86Z>m`&QXxpB{=nkrhE$c<?#;OzbWG*T>W}=jGd#KLC
zZ6LmU19RSpU{ZEOipK+%_}bn(ldKGLWWHp1B&F2{aX@H@(Sb3<&qc#?xO<+BYm>_E
zTNtfZk%p?*h~%@nv_)DcyVu^%(!DZ9#87vHU||!JUqAl$v!=dLL8-H^spC0)QUYiF
zbFg>!w`eMj?B{g3P&d9dN&|kxldp(d_I?PF>l@co9E2Q*g()adh^hBs+hu$aMi$YT
z_eV<ZENM9$2DyCh3%R~mL+&9w+@zzJV*a#cYxvZ{#M55_{VK~sh(#<DFi&N5H@?>y
zx(ZMW>1E$HakjL|wbHOOGmpNBY0cs|eK9+McQiO>4@~a&qb5})YSnY<xeOw=+>TLG
zQjG2s`#P&B&^lHbxY$?iVd3!QVY@eagxuX!j)M%X_Eu%L*=FF{xXhrca3|knSn>YX
zPj3`=;zS;td_cXQcypiON1)t+%Or%lk5-=<A(;8#1GC1#tB-FFQA`)!PBn$w4Ekqt
zv0p!yyebuIUbuyd;Qz7ei!QycXUsKB#Od2F5z0nK=;ex~k@)aH2qmFKqoXSk<a~Wx
z`eG+_Yf@&$l$YSyp^Z%C3_<eemb1C|tyf%poR$2ZR*(>lRMq1yVl9LZ)6)W^I{=|t
zj?Gi21v3qFMo0V~zTP_=t}kjEjut(LPV^9>NAD#;MDLx5-U*_P7A3mqy>~_pMrQ<3
zM;+a0(R()x@8owq&-Z@cKi@y+y5^d*&)Mgkwb$Bft$W?eci;ylsGbZ*#)r{-goV16
zi0@ctesF$khrxmH0v{?6;-af*rVq0P3yhJ-cJO#Z(`^|7Kbm6AHOgntLwl15@=pt9
z5`ySClQ;zKXl^=fvp#p5{7!aXUJE9-U+s|N&7KY%@#2Vj+Kp@{$47lM$#e}K)7_o~
zOkdldsnjBjO_M@#l^1?d6EN(w$%g-o=<ElbVDcv07{KZrh^O4^ev%DPiytVO(@Zc~
zC%29#>kaFu(z}LUxWx)Na?7IkH=9z^744dN^dlw@euRu8=zA^WUjs!p+06~H{`P3X
zpt@AZkEVdJfkvrFJmS6nTWSWs4^r{wQ1^9vWG!dbZo9_bV0wx+4?}C{_;}q!M+V;x
zY2O`)c5}@<6-xV3J=(R~%Q5cuKnKa$w^4ZJG^f%xG<Zz4+L%xywM13OYt8CvenNZQ
zu0-8QA+%7$ZbGpC%rpU>(YQ^1(0g@?nzZ0fevw{0C*Gi&LC7}Xxh<de7ov0{96{8z
zFZ<M=bv_w?sEcRzx19ql_XkNlMBsVxcrvHh^<{q92UDrmnO5_LLom~o_qg6{aiv+0
z1l$<Qb$V1wyHKhyF@gl;WT7P5^vv>lJYSp}oD?VG+Rj@UQ&NmV7&PL-<L8(WpR#zk
zas$qDo0AK#9&#mHW_I}3H!{G&=jC$fB6}g~8zOR$PuIu*zh=20>`aERhV~I1_yA8C
z(-gK_zSU)JTq`F1B<$*n>EiDgJ}3T?3$NHx!XlPT_X|2Zu4zHh=+{`%#G%3Xq>^2C
zo1<>jyU#BX(P7=<R-eLZ-){(cQ((3BC<WC)NSp)38EW`H|BNMGdy)0wz)^hiaSscO
zL0i2J-wrgfApTPD`a4I*egsUCtH$%J;S9c+2O}Yk*!r!=IymS=yr(i&c@i>90HJn>
z1+mmGa*$wB=Y_VRu7}VQp6@aE{1RK8LAy5p-XB7a&1@6ngQ{K#z$eAQKft*$X?{aF
z4ENA_VM_~E1?Bp+pANsWPW4Xa4E3u!E}@DpX3w`%@>L+_s;;eW?-&$ktHuS3{phE4
znW1fWgzhgC98(C@!C#Jt>!FyVD(o>G#(0uiCR@_btlN1981G5TFd_@1-nG`SBT?`y
z#U$rwXBO|RlZooGY#7v*G9uh}6Hw0hh6kLyx+zA$eDB-i79G5orGD7N9A;NDgQ@X&
z%W`}qp+ewTa;JN3Yj$YVitR!0vY48It;>E(kxxPdmH7b0c_On+FB9gFg4;K%*4)qo
zeBAbM<u>x@CN+*%5%dNA4GJ_%xTAbiij?zyJ6L=m9<t;_{&iF>p6{=Tqa>!pt*Yiv
z7^uB@71zhEOz6|h8k#hyT|n~ewd&g5W4LE+DGL%YF$ebx@SmP@rpzxjhGXhu1uqc4
zcg4I9uVL+V43)4liP}p(*=G!eSVtY1z-ahyg`4IpMT<>C#o?e+j;EcuxTw|IkUb{a
zxTiYnT?|~C>m9li1^~4Sy8cfA()bAgK_^vb2yb-dO0-C%8)NJ9jQSn(Xv0&<Vf^xo
zA7jvl>K}d4kP!|(WlecmeS}Z2_L@N7>H5DKlO2Ns)6loXj0%>Rknt>C`EA2OW`D_E
zv>Qqzug1LrhyH5|)38zLV})+fUh(!?vLY$^;ro+LtIOQ4bXZaj6pdi+J4vNo1wGUI
z@-TnZA7&T+j!s5?Jg_+}B#~1&IRx8+*@FCa_JkIEGs`+%=8de)nFtDml1SvCRaFaL
z&<@;mq<b)k5H#}xBsy^+{AY4NLRLMj-%;k|LPvhuKF+Diff_O`de&qL6d+Ktsp<<V
z&zJ--a=q-2pi5f|a)i}vZTNs21pBKSk9*D4pGGN*3Y8=xiHUzNS-=RSo{o-y)gk)K
z22y>+8#vra&mGLwRqLX}_86UW@Fa%tB59BiSn{aDr+LvDuR)ba^vHy?lfX?1YV-&a
z(lqSm=Cu~V1!BfO#iK41$&?9FS8htapFe=-+=$2_ZRC1*73`MZK7g4fNs$drNX!Dp
znB<s)75{4E>QQ#>E%xKTV<@gh@i)KJzv$?qX{U@rcENRcIW_fzBW%y_b|*y+1QnQy
zV;naWOv8{j#bV2`D~^`<x|>u@wAj~y8k%1h{`*DKOE@coNCKN4h5ob*+!k6~kjx<d
zJ#>3r<TV;2xELa-_-2W(HP%YmV~Ek%f3V9f^iQGpxj4OQB|U{VRY2gG#5&MxmD`tk
zp2AN}OH;4Otv@OAvq2FDD_z3tWR2Vkz|Fik7mF9;*cqmZ`5XS|8?1FT*7^igWZf{$
z+<UeF1W=K8`G-S0lG~c--5*~q+0+C;bw?<JU&FH))a*@$7H=kopD`FE$TB)%0+-X^
zqUM-YUNA-lQ?A7yRB8{i^Ogw1pIoxT$kapL#v*M^u-j2{yD5it!KR4#9mvFD_#_wl
zZ8a8)pg-taJJGk7S@a3}7B7|<YV0C07w-rVKOcQcjts6dQ>Y81UJAycOhn>ABu#0-
zlzT~vGH%@uCj=38)3L?#fe9HFhsIF6Yo3NRoA3DM5ndGQR|&^s9MuFx<QDO`tDbnm
z@dm#mq__!R!~_%a1)AQzV4}*E7at?^&Q++p%M6=n3uZ+2{iy}S5N@!&a{Q3!@Ks`<
zBhAr?I$Y%Bz467rT*8p&V*ApMU#Aqmx$4I%&LkO^lXjD|s$FKZ&gDV7y4B<o^SN`q
z+Zx=K5&ak4^fkO)i<gCG#HHkeKzv6h8uQ~&CtY@AB-)#4@0Wl>KEouIyh}{;?uTUp
zWWbTeW>fNDf%0Y;`@>5D-py~!g~gO9`PwTYjK;I;P2dG&2`0%kni4St4bu0W$AGuj
z=a%j}H<V0PJ6pV;_=pZ`37K@HJgyV=B~NZbMmW^*@)XsQm3gYYZf{H=gF}h1HF>Gc
z8HvqIx;JlW<Ur~q*eK|@dEN%qaXJf_Remb1vLaUJ^pS(wT3cAypVcitGocSB1=oEG
zZ<4BUJhJ=rZauUnM&qeQ8e~c(A?YiFttX2Gg#Rd^vToccMi#wFeb)!&D_a3uZRNpX
zi9=@VY#j8`A-I3gOeN6e0E0(@G4tzxKT26-zi*a<(~ucj3g9kC*meU)wS+rt@qU=i
zOI^A*(0%a;CSmZ7J_Q%Xv|AE!B`3S&`hCDFll2*T*};6+yJgOIuq0Zq#cBET^p~tj
z+EdgHffcgThob%|Nqt00ExR9VKlBZllq4YbU9WFa_1MzpK>G+*Cal6VG<vk0+~iSO
zc|HgeL!=+-yLRUKmm29gWOfDMeeq4VViNOy0(J<qca$PqSUhuJ#J<|PvCFW?O>=m>
z`ml_(+|A^FtN@cJ&;frpL#$u(EGAyw!W9Ka`~6}PkxU3N)k9&ww1luw(JiGezLxZz
zO?5jR@O{9DKk5%(@%K}klNoYndIg|*cYDQ6OZJ>1Llt+2_gHkB6-aU8AETNpwfF~b
z>*2`C5_OZ3!H8nOSid{;&D48OY`4KA854l&x%*zxq0$F1o0(RBr`=8LXweVk3(8G#
z3B3EGKYrN=zLUD2<!pZRF`OLH`SU{fOIUraM(6>zp7`hR0kEiXOpRZb%?T6Puz}hT
z^*Z>+MNaLjj6J8)c=P$zUU(QpK^!el#9cf4hSyu0$sjaZ-2h5q!DAkCnqX6iH!mLo
z^yQ(~NS)*4oyX|z?(|mjh`|l;us?G@9}|IfbflnU`xXwSP!vW>tw0!6zww&9aR3^h
z75}CtszIml^v%Kr3v_<ARMM+35-sKdpyvHuAC|Sc<NZi%&inK(dgY)(u2nfipH{=V
z;X1z8!Sm6@IhK~aoAH3FPOz<MDgK`QJ_vEV(H>2`&1;bR1y{}sW;ZR&>S{VjRP&j4
z#R5z>%6O6_V*WM(jbM_#{&}jpEK!`4{a`wjDq7qU)j=wfDt+ds*oj{SA=K(XOI@?B
z`b&xG3n+5SK3R)pa0aMWr?1~w$CozXN}*r~(cj3ker?QLxwy}h#PDg?zI3bJTqNT+
zR>4=93~LK*sO706laWCw=ey5NpjG<-!zw*+%5D`QW#~?TJFdX}KKTpI+%y(r)_(64
zEDR;$vW@sd{DNZdpk;TWq>OY0ygubr!qwlYq_hE1=eX<Vh)jA{);FODdRAKR7jdE<
z_sSz2p)b`gPDa^d-LNaj*JancrUchmMu~%8XL}rSX)w4mD*vIz{`RLWeB-wpPtYMD
zJe}DNjPX2%rUV+Gp&;(_WMff}>m)0@+GZVV6VpF^J8ic7<@ZhBZf6<9f3Fd<f2U6S
zo+$BCce?#1x$G7y?Heq4&XBWb;83@bxfbTyh%fhHYDX@@HEH6@H8-^xg`Z?GV4qMd
z2y!vN)+XM%yJfU5A$*?8L}JZR$R1xlu?zuZl?MkJXP*-An`$ZFCh#Nk>P31~n;+P!
zpH9>KIE>wlc@I-!QbTcMXA-Bd!2KZq0^nS(ErfOoX+e*Ad@K0WR+e&yUV}$qMO6=Q
zu-N7|VnU}-R+L1NRt?X)g}<;AM&s(c0npj4mP_W`%=KQwsZA7`B4g-{`o$0EC(v-3
z<6VmaU9$;)&u^ZSzY$7ZNMIngN_+PoG$eeiljlV-I|DdHzBngOqm;G@^D#3}QX|^~
zMDqQU|E^P_N+NnU{t!=>g+uPgvi%T@A1lA7S9zXj|E_tFuaHWJ;l0N4gYvZAwuQ$b
z!FOT3Ct^|^ETheO=v8-t`XDTQ!uL<z-FIG>`Wo@I{*MX5!Y^Nhc#=R!4?uOpOs^xo
zd!SQwreE;2c;Y4e6^sZwH6F&F_HaU@BcppMF<zL<GK5Cv>|t9-7knUMR5CU1ZZ0_M
z`1-`pw9fcC&Qob9A&x@O8sVJHCYKPyMmHJ-Vcl`%I?!ltIDI4JTE~U^cXG}ugdvyn
zhjd~(bG@95We&r_I^m)X%}AkQx7WLDInWC!+XL5MVHpJzX^A5>0j%QArZ4eGunaiZ
zTGE6NV&fLElYU9Kt0Gt|NMaJJ(CT#WSw)->>91JRZ{_5LF~P1CDc^1Ik;3>Xg1E4U
z#@WhXN%nn`tZq*h=kKHmflyDaP}0=l!b~LV8b6}gDXR0afv{++2_bRt&}C&&A7St{
z8+K?(<}k3qyIB@$_Ow?6BKvVtSGf6i=sf*QB7`w+u5T%hNA8Do>sOM1h3js@$;nzZ
ztTf}Z&%D2XnoZU!_9OPD6|8)#8)}rNB8KE&+l;1D_nm+IJAT#srNbxo)Y<1tIsf{n
zB&HgOC^vX-iqfX>ILDI%pz=|W?HclU+r^AM*RQwivOommY=#ZLHug^9?s|AkH&2Iq
zV1VVM#5R*9s)0fy_F(TAkw+nUki5~y4!^J)0SMhDzPqk~W}K_cHqY}FCx<)#xYskj
z2+xRc;xXa63ORw9jrGc3*+}3y<1FX`Sy}g6@Pr{uJ03H42#J(+xtwYUYh=}M`~YuN
zJ2rbQYsX4YzY}l}RVei11adbTY`(Q!B2>Qh>bV!ke9f!R1p{B(;0-D-#S&dLx-J6!
z9E{C+f})$QI$UU|O`eFA&A&X8-?Q3yJbZKAg0TW9yn1Ct(Z9{H)E*r+`5WG-ih@C8
z{*xox+`uLw8ELQSp)N~p5@0^l`XP2UR;J(M#OKni)Vg2ZSrXN>CLNXNAZv|WbF6UQ
zQOe>vVB-js5i}^gG`FaBYaM)N8p7armd{@|fM5Ielep|IEjIH!0VK?0zU)=ExcCH8
zFGHkow*$=?Y`8961hY)~5($x{BmK9}?1aI`CULHaV~AJ3_UW-i(B(RjD?tJbVphS;
zU~`<qRD6KdPJk^-D0`t#ewT}c5X^UP3tyBsVw$osBx55f)kG4I93YF|Nf6vwgJUC6
zbD_U!F8>xwzfgQG%SwehBx2bO9P{n;JpZ+Ek0iMmUW?v7W58BqE0FR(>8{0}c3gJ5
zOSe+8<a{yEuruaPP;h<9%JJZx3Bb>JV!6Xvu;H_8Ies5X(PuxV`$yuGJc0G^x22*9
ziK<sNkTUmi$+}r8_Bb2tpOl~b7n!i$yvAjs|64*w6gBedd+*3W0*i5V{OboOsmby8
z;Ekd;ho*_ItWubLIFR&V{k<7whdSq(G>V|pw@+h?gdhI|pT;;_T+G@yu6&bVR$~Yo
zo!!Zd@QT*{^yC5HZm`KNL8+;#;|K!M_-kEV-jztEF&RIE|H$-m;&YePIrCtQ(W<^f
zc0i4CTAx@=0IzVoG<RAG2)--KcC<Gjo-?zVO&qAZboq;nBx~O9_!HNh0UJrk$VFf8
z0~5gL6jrMZ<qt2i9*zxDsZvoQ5pq~!Y|Ml;-2R&lx@LN^pqe^#oY22_s}h#SUrf-l
z7@25PK<fJSAKMwPtolBK%+Dq)YWpXYl2au(Ij{~M6M6xgRHU*N`o*yVx$4{`ve(4s
zeA>Sy!jAi+F^}?)5?9VnOm@HA@kQ4uxma<#*R`tAqPJ@A%nkg;(azmyZG6Mrj37z8
zmJ)kz!A5^7<tKG&_Gw*%Yz$V#g=aA9*kHZMcOW&`VTKlrQS(~xPKu8objp!ykwxw&
z*mC`{#*8ZRJAIqbQmxq-JA}l17|Wq!{_|`f+5%nF#H!`X(90$tQw>Y;BToseIowoL
zI2A53DITy)%q_ec%%2hJINpp-Tl4Eo!juFI6{q~zFp8wf(R}{#W9y-<@ja$gm!v-r
zz~^hi>vi8@@pQfUOpZ6kL-#uHT&HLB-9yUNDUX5&;=>QgPS%g)7hhXHyNWzTyvb^4
z6<3CKD|JbpT^g;M3U)N}hLxjZ>85_>>HCawC;OJcI0ja>;M;or$%e^z6cO4f*}%ch
zYnlC87uI~Ga+TacRKp$k_*v<|?1wy?4kSHz0eWjbA&qQ}0}_OjD2`$^^_NF~4t?!G
zjke`7>irk2ueC>2Gd-3>UPQm>T}najV>-2&2IE7#{b%E@A+5-I+t|DWiD8!gl|VuR
zoDqW6$mxT}W<GCFIlnojSACp?0V-Z~p;4yi-&c)a(_V5+njyxKsGP>UY2A+uJ0(E*
zP)%kbnPXe<)pdIkr^hMu%dmN(`JszxNOuNU7EdAyY?mtNH%B8B>Ck@Md_~zpX~67Z
zS9TO3hfCq`+_|v{g^(NU^#j53ih(9`K?iB%<1|C%GGfv#w=ym7k56ewq;z%7cKTYe
zlJKJk7pgcpO@6utqpX_*3KE>TbCZdey?QSr{yUK;!6bR-_BkKL>-RW!kCwP>$~O`L
z(WkFABds<y(*))yNQ8<_W@{pUr6K7o_WM7;k4-pH2v%7an~`L_U0jLinBE}qs<-Qr
z3QKU{Kk@MF4HXFW&iJQaY6hDrS?`aC-l=Rb{4UB!Me;(%<%u~+T{Mv6Y3^Oz#mL?|
z;j(4hMT#3s+ELS=SbAHC_f5DVVGo0rQvL*!Os|?Uuk?$lZN?N!qW3#rm6&Sq<O!aj
zTm<7HHqxX-#-yyfy6kd+-A1=!>v7H`7O`go&3Z3Gqppu^sC}kk*qi?IiGRGY?3qJH
z_%2H%QZmAZgy$EK^hPor-MN){Z-3hEC^a*9`kD>J?2{3!%Xt=|Vlp^ga^F;MMY?K~
zHmbqi9D<zoSaJ4|DyeAneyHs&^iYS%$p`dc`1yA;w$KupD1|+}lz0^d9j|7)_IuEH
zGw1W>Ms%GL*<nQHERqOZCt81LC)%|sR%3w=*^iG1?6&&!(3p;oPp``3AZFK*aoG^6
z{%WeSac!B8VPJk;BGtySGSyWkgzM>^slVx2u@mACuULvP(@&k6Enbq~lcz2CMwd+S
z%wsw8i(c^W%pl29lFta69iQr8j?u1Rs2fr05PE;B{?!87bM6;@9_C}?nmFyqnE#i<
zE!;5AR3G|}q9JqJ1%s<Uii6!V9QEg}5Vdqk4|e`A9c=QHr#|MJ-@jH~d|Ed8(e$1y
zDsnDez*sq)>yWq4FzA=pY<I-&MrS{=XiRMVH%$1ZuCT12GxT8p0Ez#SdX)c}{;Gp+
zAmu0X$cEM1D|n$n5H`W<hv()aQD|cnvSb6AvdsgqhrRJHnnB2ZaqHl~hSzA`wE#RO
z3riy$(N*Rf9vQ>ymg>*dcb|yY`PV~UXWKIrFgXEDQwg~+>u=YeR@GnAXWz_1XkH1n
zTos2}y^Q-*&R;P@MABUAf1Ciy<)YmU3S3kI{VB(mp)Y)9PHe!41#PNFHLl=JhtC^x
z**y=9O+Kw2bm!*S<cHuIvHnsJrCyh<4_tr>J)R}{MLU4bW<vJr1zmI)DFnFQy-&Dt
z32+bb$z4G0Cq-Pp<Ptm|h|c-D9>&qIL+=zbam?hzJ;|L5kbXFP`n-03b|(~G(L6xP
zketeCI6nmrZ&&Um^z1!x#&ziyE7@h}UsAmut{!d8AUF6{rwQ)w_`z@v^XgJx#!P9L
zq8<7{NL2IH)@$|TAALZ(HH-1@0b)PZ{m<lJRY~{l0Ok~e>$SGa%7~}~N>}r|fZ<#>
z4c-%?>UrfLLJIVk-^-X<DL+4eAA>IoI81$3Ec)vb|8?c-+HJT86O*z035|J&5!nV#
z{G4Bh*GQPBwt#AzmvFXdd^>l);roKcPf!wo7`rK)3z|PfBD|gWQnG43fjSTmr2SX#
zvq-Rc+lH_0-5Ih^%V1J&VV4soDX#SqM7dBs&dwI4slNVDzzrJrAOK{1*Lx0WLxZka
zVuyzQn(vwv!Fjn8a7}zqs^-GI-Zs}9OrH(8p#VFmq7o!;USkz!*Y`G3yt7V72vV*D
zj8^?5ONQ?_xwLc}KYr##GX{o6|GH0DWFw0T<B?1N`~o6;XoYYE%#C8$s{P*A4_+Lt
zigEiPy9hB}H`g5ye=6Ry#_PDM+1aF0?0)WaTXaI}0(EPC!5Ye5Kez^p)Y=pt685~_
zyAKB{7=lw?L_M=ZPO9ezQ-)d&eU2+XLsK80gv;fg(Xn?81w7;0HJF^5a+CC0GAcOc
zH`Z&Jp_dK5Usvi=5ic2lk_QQj{NFtU!5HR&5JtR@kCz(_zuzV3Y`5?^IS<s$rxJ!k
zx}0)9hs7>*-&UX*IX$Vft#2%RalpDU-N<1Wc}poYEo+Is860nd?5QR6_9sPoi(I}X
zcCK~@n6_(F#D;>lnv=!8gsLLh)lCJ9#{q1RxMt*8e8T+C42eiaBboE!#*{(o$Fx4@
z_)8w{K6sK042KJ0FSpQ#8DemgRqFlb$u8TQo->D?c5Jmh`-p{hn>BKc@x`^T^206z
znu;d96&@&oKMkp^tF2#m_6*D2q6`!L{UXaC@h*BWiL9k+H1X-rJ0(fn9jSEtj7H_3
zaxWVD&%zp7RL@4d##BK)(fvn7X6&y=>U@^p5xs~q_&bI8?n!nMm-8~<;UX)T1qYif
z;M=Mq^cYyLM9eiclIOE;%G(<G)NESI?y$Mp40Ww%coThpB6J}6DG!%zKrv?Bh<pu$
zQJ|wt)y8DhG*vuUGV29qAJcQ6yRsvlt-05v0{8vq>)(){ErkB%yKO%_x2Gq_Dxk+e
zGskOHD#@Mpvo(cvIOSK0cUTG1FR{>NQHNv`NjVf2O#Ns~{pMDi%(_=^u4<017TX<+
zrWR8<jhY>ki9gbRB~;uJN5kXm!Ao+FJGrP`g5*q>9jtb(dq9qkVRt<<z)G#M$}S-f
z2~SzOAMUelC4+^4iqh>08`D~-{8+kVf$fXU_>u{lBQfB$>duZL`J``6iu~IcDXq4J
z`eFOxZu7p;1HbKxl^`Xd7>}eO2Ys$OTps-WpK+?Y_ZJoRa1wtw-%u2;p9AzpQ0!Q^
z1VxYcO9n={uXvbL{OH9&p|((cmu+|Nfm08O8kO?jxqvf?m5_=;>puZ=4~6;=xJFM|
zfbU+<n|<!`$FJN=VR@*c%!uc?Zu|8s!<UGrcTNIpaN>IalJJ}OaW{@&37<<skRBnv
zcV9@2ZLhgImNJ4`!wi*`L9@9HlHA9wQ1IXF9XWI97}r>}&#gfD_<%eyq}v%PnILQS
z+!&${lR-Ecuj=%PX~5pxKOWr0uX@y`+{kvL`F0GceB0C{fA|FFsyKo8)rvE59QqFE
z8#X^mk_mkrQ_FKOAx8Eco4pv{FuamS<H9d4#B8}22$A2LDUaR5*8|93bwYXX$KsLy
z(G-oV!Pq3CRZ*<7XI?7&9r*5NXDJ)|&}!SuD{(%!l-lXcvNm-M??lvJwLgS6iLyF0
zEBEM>il3$txi;O=zSs^LagJG_%b}5LYCq=p(d6Snpa`$z+7x2m@5RqpS9N;NKc4Ot
zS`-OLoziXJED%(LRNN9|h3h|+;v*hLFI;?o${i)-niXmI@eij3IKuoL+<EOY;ElI*
z+D-{fYnn}ufr#j=D)KituRRM2Gbs?exsBd3yu)d9`KbH?Dh3XKM2|t`oob62xuDGV
z#=h&3C4q#Pemy181SZ-01QEv{51iX2iBIZFt!#26YvG4fD^{~K)+Pz?_fDSVn&c(E
zxe1R60~MemdjvkBP%kj3rY<67KScd;^Dq$KZgpJl$4PBBDi_9wvTWfh1@~pd{R=V`
zF1>kMN4V-Pcz|2*3KUFW;?)J9-O=Mlz08^U<AO8lp;1+gt0FKaGQyQPEA{^SOIs`-
zlODVIuidQ$neiAGHe^k7Zc<^oXj}jSk1}1r@CGg`esYl^|Iz!CqX6n*qcQZW`}~u}
zIl*ijrT}{q`C5solW=+b=^vHw8n%k~#1I;jgdsJRfSU!M?$)nbKlPYu+rFQ-5WDU<
zx7asc)!9DbS9$i<0{Rt&h)G!Ce@fcw^tx3MlD`RvRnfRo3Oe3!i7)1^dwy}NX(K9t
zF=g!CH}O}VX+J{ryJOuUh7(7<oj96ZpAnZ^r6*aam;JhZB{ul>m)b|~?HUC#W^5A(
z=67sLu4-regcsm0CNAI6D+0CRPLh$evOOiwOv%A*^LkSj!ZX@e#l+U+-9tDOP(#>)
zjiYO>!lBz6s{FxjZYz{D$uzI|SiF_dQ^}9^mA<)m6`mpXHQKl!&!zFx#1&ypGpbtb
zsq(0uc?)%q#z7PKyEVfvy{j$GlVg8|KP%&q%xocOu9e@%o>!gJhVTTk=%dW^NWnR(
zQk4))dCf3%HL7HrpRuN1KQYv)N{s^{mIagaSLHYoGmp%;`d2rwZUVSb#iG{As~;{w
z{8X+I_GpE>ES2&56&Aw%&R^b^>juh?9Sn>lrs<Kt->Yhd!C=;?TscM0F+~UMC-~nM
z!CCiRuB{#V3xA@L1|8Qy+1ti7rmiA#Z^~d0Ypq6<w6451)wY$#fj!CqJI1w7$OZu7
zD0*2Zo1b5RJ`~Y~W6}XyZQmcMr2jG|5S-0nYx2|`3p<|T@N+Vmw}%{_(^-4I>YhAS
z-N%%m&D9UAbFR0h-$(oF<#qYKQcSt6N82p&`!}Mx-scq)(xjr#Q})O`L{Pa9r;kHV
zT_v{A-NCAhsXJScqeL`I7kg<$RV7`<6N9!Xb1YBkqY;%=IS2lAkkUzPrrd7fQdaL?
zeBE<db*+{K1vSo9DGXKL(`{UCU}abQ@J&U$sWH4d`Ax2Yvx*j7^>zwSlCH7Z7=yU&
zw5umqX2#LzzTu`ExlUHt<}99v6C6nT*K&DZNvKOjntc1osl|+uy8jzUP3GoW45>O^
ztTKq>B23Z#&g;2<%QM%N<m=kdrA8&9CM3lFER0K^WR2E+rg)=}u`_EKDNcYY%6xl0
zl9@ffl44vMjA@)M&z~R%$m*9MN|WDrW5hnTJcKmSm}rZ-G7yPtp1<vM`kMT(sdtEg
za%)w{Uro~^g>HNtRZ{)($RvX73Duqwm}u<FiiVU+4iO1IHMHPe@qK25<cj^t(2?%@
zvK#F^<tiC<VoQXs?<b^=>_!a}I_jMASp0R?-{mpc-a8IKQ-hi20VEn2foGHW@mauc
zAL7YQVLB$_-04C^-mCds$)v8kVEx{L05i|*ww~DwG##bdotN96fX|KXB}=zm+IDrP
z?j>A~FL}J6mm2_R>mFa>W3#9YqS?F0gv_-f#)_<GH+-RyO#0TZh}sWsRJf)DBL`qc
zp#(Ul2LjA4GqS{NDz9|*SIt1&Xf^oMEu>>RSCnVPHwN8)Nrx^;aaRwG@wJjH;0ykD
zvpb4_s#)~uz^W#b$&Lw0FE~KQff(a{Up0RcUvE)Gjle%eFOOk1=3qNbs!wesg$f@O
zMNO=0ah<&4eO4@~3?DnqlB?{T!76~`Yq{<<4a7b-h6AU^L@;zk%Y3fA4DToWYESlz
zs#-|8IZf(y&k)*q{1`uh{Jl<sYg0Z4e5E$Ud)tZfWwFF4deyw%rd}U<n*O@}Rpbzh
z(ZI2YyEZ-eQnR3e1Bi#8`K|p-i;l}(;>h1`qrIFh(UK7QNFIgr;gTtbMc{q=to+?H
zL9CFS;>9jOa4vR{R5Sd2MSJEaq}ZnvSvyoR|G23wMf$;KUYDSe5~*FP$&X&Ooi4${
zp!wq{JN~*~dErpDe^S3wj!TN~Rn_j<Hgc@!75ZkWzx%O#Xdca4;8<N9C^kyhgqe_v
zFP|Tb`#6+&^_!sN@~gn?%E#H5-H@)888Z|;zQGDyc8MEBffsF9ao+<|iWcLMP}rh!
z&KdWphmc07qzB4|K)iisS@fZB6H+lV$~S3N%6KEjVrTP}{_5q52v+NFqp91rI?tDz
zjV_H#6%0=7;jmuimUomLg0;v&R*F0Pec3Y|iZU?1$qOg0CaPw&hYuI;1Iw7IE1z$n
zK|eG=Z^R_IXj<Tb6=ZW+(ro23d{|eK|Ah9h27a9VlW9FmKvUwl9zm+^GuOgc`_emp
zV59XomBy7uyI<|iOj1{Lf7q|tQeUTF=$?CifT`a6_dW7?{CBe~|A{L6xQc}(K)o)m
z;_C~h!xqaxH#Ak5YWULIi5oJCCR8q(XlKo3z>`uxA4O+r6}0s&2&%$_K}OXq7T_U=
z+{VDUR?LgA4;Wf2Q52INuPaK8^G0+NL*C53TKP8DxDrw$KRks`Fq^thM5+ZevshGa
znha7Jqo(t5G;qs(?C5Mj9E49Zw%ZB04}3U?(DNBEEkfE1b}7V}QeRPgr|yg{T&21J
zQT|P@lqyBIGg2e9+tGj>C2e?eM{`cPjcgL1Pz~Lfix*UyL+E-muh|->YK0Bb{3*D-
zgbn&-gkcgd)d@bP=+yAAU2QheISU9Z|N0ruI}@Ll8B`AY4tGj1QD$%9>bb&HFVd)R
z>V*9SCX+<9L*M8VQ+u+^h4l-$1QhN*6<oEV*3e0{a`^AD6OfVDcA2fXb;DO|u6LD6
zuc#zcXzDgIB~2d6A!(1o$t4AZu6rG`ET+Aan}URqq8)xu5%VABBHEV9BNpskF$4mu
zycnw5>+IhZcYVTX-ju%i>hQ&VEX9V@%W4zw>%5H^mCFRLs`Nb?|7fN_3Ftd;62yP_
zmCEr>WY{?Vjrs-qtj8Ye*vYCNtqDm5nL7Ed{YKfg;^tADPv#;vNE@2ld0)M-l(}&u
zLr#bzJY}IFY4Y)viwYIFk^3~?(F+ft`3Q3FaU(a@PBMDWbN2SVVw3*hLVuaFcebs-
zF08&w+@59Uzz`cWLwAI0)>d0?cMcQ0LeZ$3*$qp#*PJmP{w^h;sO4@Uz<wEh&A+C}
zd1q4{nR>i?@I2x9)}&m;8^mLUpuA8$SNqmhVKdOC{BP^`l}?y3`X>CyXT_ex>v(zT
zqGgfm<E*k4)3eIf%FM4#Uu~XFP5rv;1=chbaq<QHn_pcSy=;-4@REC<cmU7<_7fb*
z$9G|VLJB2NOJ&|6^@R68tO!#1$Wj`d*2Qh_TPpcA`l!8-YWVVgDh(wqP7CmTc3CCR
zVXk^f7k!-ebqlp?g+HLhqfZMUGkXKYtet9WD3(?t*pVE`+|F@Qxw!PxBs&zMa<!vt
zm^(>*o~bcbBgvk7=~tF%b;T{#7tp9{)D5v#V4I0WlZa4K@gc?A6H*i?J!6hG)Zcaa
z2`^#~0(zPT7+;klZNOWtCT}V%MJ96JCsEWI-$gVp6B|t9s=^&t&+g{hsEb!MZ{=3V
zQy!lk91&=hJeQTSuk4zOSK(6(#G0*@&VgMGej<M!aX4O+$*Zzwf1YnxL8*H&v9zMu
zT|R};l=*{ocZ!b8#CzYlBa_ko*8b{dg6_FXRB`^XrGswK&da8x%c9yBz4wPTwPn+)
zxhDMF>Zj=}v#-ma+sxJUc`eU6%8;`+C5pD`p(dEfk<qk|D|t0Z>?!D~bekGa&5Dn%
zQqQ`w+QueveV%RkoFZ^>>H$7eFz^}kI-jKzo=vDW3cQu6wAv{YOMq{7csi8$#M7b!
zH>DQg#KnpyJDFET;IH>F71%#ewFE3gJ|nz5c!heosNx%Ll$qwo_!=8DcBbBW?idnC
z&0=&&y0o<earI1oRTX&wgCsf2Ry(*zE-AIm2$^Sx%k#d72FY|H8ydq+%gvH9xA_x2
zh$^BlDv}1tb1tq{VzL%y-@aElumol@&pMX}#&sRQt7Cp$OoWZ_DyXn!cG;hX8p0G)
ziXf?(i>z$IlD(@ofac4#$zn)5m;F_jQzLHnhM3cHd$QtubNEaow8O?%!=Y@g-E>N1
z*GmQ_hFIMNXi}MzYfJ<0w(1+p$RV|pdCyJMfqTAB@-gM&&TIU*`dNxN`)0;%!*O?~
zH%5T`OOsie3;9HQx7kDQzm<J34T10CWAJugX)Q9>z23pi!Pt5hdFtpj8S)ihH4k&K
z-owid{@Lx(M(LuT#re{Z`l<U?-<55~-Kmq9fSXy&j{tj8SGM`AcXs|``CUH&v%^I<
zYJIa(h~@RJwjz0aZosjr0p+6ZSPChYpOz88n!hK`P=cc_z^;v`oSHAIMO%`ZxZ18F
zgqhA<kW;S|&Z#l23vju-)1?2_BUuC=o4b)yS>pdO;@Eyhbklj!;IXN|w9IK_dS_I5
zGMK%f6}?u?K{)wsU&-K7pb^<#W8tLv`X`j1oc)LnBLkk5Zw-Je`*7AetCy3?Kiu@S
z*jZOn<KRe}HaS1D-)I@XZk!DeyQHpxL>iW`PRzhO5M-5tZmY`~a-4QR#I8#e+@_`l
zr9^y>CBB(k34Wgs=(dKrbP_DKaFE`P*2CVe)a5vT-`^Fh-});cN7U~bJ?mZJ`62r<
zTXdG|z`d~8pFF!g|F&}y7O!_GR<YeGc1ZPpr^W&ANI}SnZ1Kbxc*C%&&^cGTBrvJj
zK3VRrF1ncMd@$h7BxLWwhjhesiVgy~2V!V7#HoKd=2hO^_!|aZXAF|&Ev#mWr={q)
zWCVBtcsTxQsT4iOQ_4z&vVZqn!4MT)Gi=`nCh}C>7oPc^p8Yu<vuMlv0vk8*Clqu!
z@Nrvh@sl_&IT+L=?|zI>C!dD@gv!YQr9_+J45c*Nq*v^os!mb^@I2j0yF`nF-{ec#
z;>2BIngn)uBIEd)<Z(w2`UhVWpW>T?lmgWiS1@LbKMFB>xap!Bn+S}zC7hgW30Y{n
zms)73gmOt50!}=fO&hE8HM)hY$omk0T;O4?ZqHvd+&xrfl@?F)T3mGm?f#Q)66&nU
zb;i6)cOx7r+Y?W*&wm1sh339hqRcm{0jSwk=t(<vK%f~I%?ioxHK3k4!Y)>~=EAn=
z)k^4$Us-V$tH`*7BpJphYC#u*rRF^s-@ih-18_4H@KVKH<c-!rlQZESU;>5%SdE61
zA*}yC`tMT}fn*%>nDE<*FC4B7OQ0fkuY%>#pMUO|Mf_q>ZdP4DH(t?5fBy^xopASK
z@G5FeoVe`^9ON(Qd`=Y9n&#V(CQiCc0b{3zdJ$ACdY;!9SfKE&rEx{3pdLbU`ZfCt
zH0hpM7Wyovpl7J>KL!OkV0A8JzeS!p!HoQ4TOl~8N<~^w0eOS)gl8yoguaa;I{&V&
z6cki77LSVb*@7J7o}pslF`!5sUan%ARp!>yVw|e_{rVt=W}%I{iGjRUkhB7hheuD-
zF>rPz;&lub0cpHe6Oj`OudV!VuoCie|K|VSVV6D_h1#`s{Z^5fvSflcoe?=L<oN#%
z(hArf$n9~{dB-G)wSFfR7eu+|?@MK(|2tYbe;Pf`qsQ|PT>5Cf4VWAjRFxbS_P^u*
zU4%y+9SgMRUq-=S^goaFKR5qOh)akJ+-$#eZNmPu{r?(*_XYVL1!2a>1Iogy|DC7w
zvtSvHi3OCo{lz{o`AH-`6(pbX`|b2l1;hWHF;5SMD8t%fD{vs6@<6Y);_elf7oCtB
zY9Cnaxz_*Zsab=^u|UmfnRrZVZ#~T!{+~zw_hJeEyFV-Z|8HUux7(O6Ug0fy9lj9z
zc8uQ_fsaf4CJvkUO$^P(+oPPvg7*>N0QZ&dCuxld9(NjnuOBFQzj*s$Gz$FhttLXG
z6)=sdq1E+DWpKM?bhzs*`4^`$oLA!Btks5{Y|G!~+}9(^^g?+p<ikg}MMR9<|8DU3
zUj9*)IE<6v@;RPwedD;&%w7!xaXQX}Bwp2tF<K19;NZq(QO4!)bz<2sNuXeO_}$R3
zqKbCvYVrvA&is)i*pK@B^{Kbc1@`D#=K$-AARu5;SbSoV4_)tzX!7%QjQ^j{pMfDN
zzGk>&)ImBxhBEhKlp~g00bg%Zck7U=&guTx^{Gz@+~OQi*tSugkpzAt<?kkZlx$Ho
z;yu|O6as8IXbEjU_Tv@5o;jyq5;nQ2neMx<5oM2|6Jjx4o^d#`m^<#2lfGFzH~=p;
z8TB1Y+=tjtl&a(q#^nj|y%KQ$n$GX$c-^BE43)$^CsFR|`ug5`b1b&MeixlZnS$7w
zhL3qv($_wn*QpTWxG3{QhxTL5$~{=M%I=C@(<+`$N>rHw)|L@xAX8Tge7)kGP==Z4
zoPWcpkSS{APa&{>3X4Y)7aPT1<mPAEFdunM6}yosLqZlx{+A1YZd}WyTeK^u{W`SM
zkA0`=XfT%ADX)F<O3;Gl-zV&$|8Ftl)8e4a(Y9lqZ5wP*RkYs~DJ+CpXL-N(zZf(6
z7T$gm$l(7JXH)gE&9!@d(H+c8o~v&%5WR{as2>Y$aq(dkKRZ15R^Q$|FHPQF>7yy_
z(Qj22?ogv|Z2WL-Y6yAN)??NZP}OP19Zn~4{%O9`%Pd}b5dyyB>x+<b4M_Jpj48AR
zDwL9uu|CtxzgmuFcY<+8%;{FQup~*KrDyQ5gef6|7+j(*8tHby?V06*i8BvhFH&jN
zSLr%QkPIY>L?7VaPP*Y7xY`hBksxFEu+e&!kQA+{N!NI^qrESbaxhFS@K6)CZGd#C
zv%yj2R?4hH%#k<#)t*<tQKsv|Ls8Yv&EbVhXja$N4~&zP0{1sd0fCQYT)1Vq{AC3z
zoe%r_t``J(FSt1jbhh$Def&Wi=hI-nTH(fmqoL6MRD>{6M=tuC{TD0kyr(myGWER!
zuH7W78G0y#W>8TxJDYCSCrvJG%)FT%`qEAa?yI|ha?S57gux+za~e4nMZXdPAn>H)
zB+T_*0zy89<+;7z=y|D;)aN#+N?=i)x;2xu6WU)!r^n%<E8hz>auAHD1?&v2-=*n(
zTQWW|FlO3fC-vyOn9_<`WHEydYg@T2|6*G99pqbIA58Pa4Idt!_Bzkz+YUS6wAFi7
zx>=P{y<0bEzncowH=1eS3bX*kSEC!F8%s!%aQvqpZ4Ht7+OFZ48V~8=lV?47OrxzA
z&~+Pj)^)5cZ}z=$=?Jxcw<3kZIaaZ^lmw~4f=E7Dr;Ga-gXZm7RfQkZQ-`UBsR36;
z@!^=&*9t0+$>SpKrjwzrT~{miZ`jrh8l9^!UdKlu<6s(`p8%yK%gS{uQHwj0S5*y}
z0w;PUF?n~Ff4{xD00!z<j7?UCDR4JCu24F69aWs3T10&3oL#J-%(l<;B;Lx$IJO@y
z&3wyDGq*tIf%tt7!JP(1nj1{r80K{<<arDD-(afE;%&hh*Qm?^;~kNo7wY>*$nqpx
zZh;xLV>l_M04Jy0cJ37mfq<2)7<&_QbE!X~LTYlHWk<;3M4(x#C`Y;%iGXoakp4f*
zMV}y-PmEe)vgDPVJ5q=5u-m8eb~+vx8w4lHGHK$-x3)$)!yRo1PpFxaO6wxcncE1|
zWIfI=kDz7M2eeQI|A_R0R<s|_zSY-c4lB?G3M^au=mHlsCBofOPo$opp6lsFr87Xg
zO6P<Qb^K)bt(|&G6WJx3T@c<ZPxnqv8Tr`q3;k)Z6+6_xy@z?-&f&!lAfCmryT;4d
zKT$wUqE^ARNSqzEsGoelOI)jSQ%Qfm7W{rCWS|QRq^j@jkuK)v>)Cx}Ix6wa5On)M
zT-mhu6?9U-tjnioCrIT|Ww=4=;)vx^v#8IZd$g*dJK~i&>kR#*XXYk9c{1jJYNx5M
z6!rH%n|FkTw1P!8OW%C))3_Er(j=X)i=%Oy_|Kzb4AB>_*9yL`D+wXWjqvC0c3#m*
zS_v5M<JD-F&1wP*mD2R$w7e=kCsH_KX&vl>nQ=W;-9E)jNIuuH|D*VKmc2zG1KPss
zysP7~bgMr-C+8GZ-iE`vs>TkQ>=Lu{nca*Tc7Nh`8TZLiaC@QBwNt+Yd$70(I!F>S
zeT8(1llRR_PuxA_xVcG2{f}|Ibno%lSVin6t537K{XJVaJs)bjTNxhCp4v*NE?N6@
z$S447neK-6hUEc9PuH;#(K6EhHf2kn-{P>S>CbnPd4vgIK0F>l^quw&W+8ppgLE{K
zkLxW4jl+~(KD;J((9+XxNiU=M<ynGHC-u)g)sOa-lwde6i@s_AB3HoSdvb%kwrPLz
zg;J{1&22hK9ez%og31+5SQYHHq>5@46Gg92+w#M|t&OcLa`j<XH&o|Px$dE=d-=~&
zK91>RMTu=uDNB!KSu5x1U%F&Sd0E>@7dQztq{}afT8_DQU9Sv+`Jh`s5UXG)pQ?nQ
z|0!Sx+0<Eq^fgWgON^L!qJD-}r`21%!RCPJZw_5e%#O>TK6#}jE#qR<JV}Pp3;`fT
zunPH@oVrGBohj6A?K@-s!El+zfj^0$$u0NXt~=B`pe$Bf&~0j-XD7X4-Im&?W|f{n
z^!m%|W<*N+F;3|~Je^U@kFxc4A;(o(-9?idCn(-0ggx23?KerRpyrj1D_7E5IIT*S
z;VRy!8W2nU5Ma>e*mQNWKr84taUB7ku_HcoMufV8LoA}Gg5`l*wUgJni-cD$olUL6
zss@mB-g;YS0rxgIYLm;!;EC33E^;Ta#C0kZp29A)umhZW<$8T+XI`2U5$=|z0KAy6
z@vFUii&&bY!-mKqs%l#3cfc2MHzr|`zEYX5oYeB3FasYx-3|-U0aJ?t%%9fvVAQ3m
z8R{n6+#Zs!ZbZfDicwxofS&fql|uIuv3WzR$DCsu%>Ju$tbGeV)jB53%k*qFsG(to
zP8~72x?gFP<s4oa*1n%(<1tdxbNX~o2jfg-3(}Tqi8mxHhQQ4bM>OkJ)ahVi6mkIQ
zp|OYLzumWIaNG-!V2z0$FuuI&<GANx=o$2}>q_#aqMHij+n1h_xKk?516l{`Vlk*+
z8`r1JB&{`pz~h+HRdxsm-0$}R3Hq+;8A0LX#m3d%0f9+bbdOdPL-Dj{=h#7rPbB^y
zHzaLbc*(a>oR`!51M(kc5|&Q<?}yeq8VSrkl->De&0(CG`5)^pK{EF-&eR@%%dH=g
z=a2+EY&E!!I6*@3$$Cfx6g12$bwJ2~T&SF`MZOJZiCrwdLQTO6UCa8P6m6r^uA6L9
z)s~*ih;O~s=ED*^!s8)74ji{yka;lmEx>h{P@mc3(NVtxg3oLG*C}=PZ7xsAR><lG
zBXxtX9`9vqxD;$*)~uq<Z7$kQaHc6UyA$E`M#q6+T3oUla9?wZgdvjUk-9W*AMoq+
zFx`7Cu?E^K<`Y}((CxTvHKBGmHJj!1t=x2L?})R6R;>bjK{Km)ZYI3|<Hx6m2dCM|
zwT-`4wJxCR<w7;Rg*L+xe)R#pZiFqbX#TnFY3#)z;66jGqX^1^EZ+$@iSL>O(oJ$d
z9kzovrsEvixaa1&5SxW}*&*g7jX<+S&+FDqmlFj8Ln{F-SWB+}ZGEpm^32?U@xlA+
zjJyCF-jgTqo|2s;6I%qYls^JvTdZw2TE3^BHSAHuJnBD7qV~B5-MC5B0A<b<wdO74
zn&#TE3^R@7eXN79S8YnA^$*i>=$DX{yY7dnBw+1e>#P8R)U`tQBg#<cw~oq{^1$jo
zuyR#~7X4X`SGJ)9)Y^0g2lQ>}A|k;1=0c8B$H1r3JmZT130>=Yh$}J(pAa{$k4%a@
zjmkt1oYYCbldMH%PHFD#ai2XtnjN#-b4=&+NE{c6%tki$#eN%YjL(1;(Z!!Tup)bq
z?bH{Zs2SuRSnazPW=iKIg|}Q&$(X@LwRe!XfnSn0H(uldne{3LBBJq1T*3_g6Cv<l
zspYk3HGgYsTTrNuo2Ve4p4jlu5CsS0_~dhx4Q4wR_hha>J|m1jpKzc8zkCfQ^oJ%d
z%w~-rs|4Qo!&`+a*{>GT0{7P_FGade3eu`m4|vT;RDV61BGVErMrNf$vsU|?#gZ;_
zi)hU->*ja5Q)_hpwlT8=INbmFX${y&^Q5?-C}7;S=KCj8dgTiwI5JPG$S|@(>u^2i
zTZC!O*ql?jxW#~)3Bl9D={<yiJg2){e})bvErb*QT|UE3%aVgyrN-oU)vF#Ii6CuA
z<#}<B&3JW%939yelY?LihB0|g%S5J9mpOTsL|zq1TCI|%2%`8ZQo||Co<O_=C2d^B
zM?koDU@RgF_ibPmN*c%GR^aL@=%QcRbGGTD1rwYoL8sLP;5Su3>$rh9_p&!4OpZ@e
z%2Y+C&tqDMmJR;!yEiq2O+ZddOLO+RpUbeUV7#`|-c3os1V`Gl{z>Qw2~T?tw6oE4
z0&XWP=5al2deVBBxCmiv?N=akT4>*@A)U9@w}<4%mA($o!t<Ukt<2XuiV%dK%FG_-
z?wz!I^{SeTZE^*L9uD7dHKK@91qRi@EdeW;=lgDWxz4{b%Ww2Aq&w%DriygiuhgJB
z4TeSbV;C+EJsACUw_UNTC!Ek%?r?rTT|K?J5>IsFUU^*RwQ~see_m^_KPtMhli@eb
zo|1?Vd#pY3)S9<k`lO$80*13UYCv$AJyDfD1@8KYp8<X0t)_EVu4?$afNeJSKJKUG
z_A06r^HKs5^4NV)?d0f#>{E8*c0~M&>rVl_s>^lFpaSchD=zdZ46jb_G59CI&Al2K
zL}1FZ1s-e%y7OAV0GvJ08<m!7x9xULXXbX+H@rJf&y>w=@$Qm{xjg^%$8=`|2})4K
ziJ7V0j~Y?ql+T&IE2oR5{dy12qOKZyMS996-F__*4TRd-dj{I|l#mV^UB=h5gxV}l
zKpSmT>I*s)$W$)1wRQwv#PYKx_W`{mEfC*xfnAtypBj{^2Zrp`SXApCWpF?o(!LLS
zq;gI<$f_-m04nJXe}||&!11pKSl45n0JDDyl{#CxZ$wJjPF00sVWPd=CC{<~T_CVL
zcxK0@K%i<SAKxZhwB^tAs1y!W_ZNZ`og|?rj=d1G9oGfsH{?ygw=P9jKKDDdl9mLw
zCVDhMvO8zUe6uG1o|cv{^X%H&A6oE;z*Z^otK|cv5-zgP&IlOyRm-BxHQBbehL>c~
zR;T*JT*2TedEJFeer6_=owut%wQwWHXSj5{uHpD&k9h$XZ9M(q2p4_{yY~|Z?GL_l
zJ6+`_jpnP|%~Tb>dv<)cdVVev6LVgBR8^!&a@kw85cO;<5Ef_yf>!%q=;i$1nzUO`
zL`j27uh@)T2s$pCX6rEj5av{Fk)hZSTWCx7UzF#&4-rtiDDHjscmfLuq!258cb?C!
zmoP;RS@(savdyA89*XKpr0bF=QBCwIENF2KBGWNZhCEj#XCC{CjeXqu$cUWU?fGgc
z5*^X30ZWfxbuF09Rjzwh@|DQ9Cwx#hup;nr|NDABvy0Amt}6)K;GnOlG%R-*nHAdY
zMidhFr3l*g7AryzXHjvxJ7}zH5wEDRLHvd*d5gPV$bFlp0l97QpLpXbCs#ZZBrlJ;
z5bW9#v=huM7aMl&a49nTVh?O)mm;9@KrU9RH<LEDE%1NXd+V<z-1mQ6N{|o{1q2C2
zI+d;gA|Nf@3`A<Qbc~P^5s(%nB}R|VF%VRQ(J)4jZX`#?XZm`E@9#O^|KRxpXPh0l
z<Es0L$9>&2A!#WbS>c*TB(6fnQ=pE|S8b;R(^g*~@o$b1rOso7Tl1}{mnOxJjV#m-
zE;pghWM|E%YaC21mn|y>R~5tWR+LWyJQ!$iEmQ{v>QmTmfVGEQ=A|zx>mw{<GPQa-
zukt$D?O&vL84nLvj*1i|<<S}-sRF-cZZ9d-mbC6~ps0Gez=q=ovVII>DLp8>a=XLE
zQz<&^Ei@q|2SF(dxhb@R5HcWlZZ$RG9gcu+$+&Lx$LoDBq_Ic6-dRzw0M-*a3Kr;&
z$;BcR=!X}}S3pVh5q#P~CDx^ovF9Ptd2pKi7g<UK$F9+yEtZ2TCOr7(E&AEqfkFf<
zzcXE=roYouXX?Zahm+sx(r%v+6f?XRx9<6|PT=leTr73G-#=qCa@)2MHv?T8)#ZLr
z3ny+EDOIYq4JggsocBvK?eSx}%~*0h_eIdG8aXwOD5w9rWlFeZ*=Tuc9ymY5diCYH
ze%a{L4hIOeZqtr_*<4E5cNsZ5t|BcN=2^QRu0miPPLc-yV<)njx!`AUVkeOLAQkog
z$yL9stBB@ez2c%1aC4A!-S_JEf<w6=f0$Uoj4|@2PubKoIm|#ZqziBV+vws}Q%OIs
z!Xs5qsds7YNT+~)knw0~nWUw1zmQf|>%t0SQo7ofVYIl<hH1YZ;mbHBmLFF#k7?wa
z@;8A7RZo5;0-%6Jz3qPI%RSw>uVK|q(=r2f*hoR@cp;@jzZJ8vo?|DIAbm`ZLV=}|
zPAo`9E(g;vC-U{Ui_#|{*s2D^$bgUUptR`t#JEc9R#95FuTmDu*=VaaR&Xp5CuQdB
zz)jCn-L1^?7(D8anfgZ3t#@QFN{yo*n<3bU4KS4WtA1s1Lv*me_lndd;Fepf%X_t5
z?KwL^4>3dXC)?)}wNkvqXPmR3WrM5=>(|5$b>l%y$|QGP46hBYVk>+=D;(6go;Jpg
zWQKLLVF8X#qgxkK?dLPpb%Y-t)@K+@RgU60CSi4IdJuk@<`!ig2EVGZbH+jO(y8Xz
zs*ef1%;TNG_~&D7&XLi8YXhU9NnM|I2*kEH&vE3{0ABYe_{nokzlDy9jX9_<Z#?K_
z_t3^@)@t%()=dpbZM!On#aCo$RejV|12;h+ZP3%&3T0wi<fA<{>4Q2^<9d{Mg!CDL
zF|?k0K>J$3K_$7Vt&l4l6|?O3)HANx)4<CGvRx+?AOt7n$;BFDz*kTj0*oMTJo=LI
zE(r1ILioN*OWk*c9)B23r1lcl4cGOATOo!nW2}7Ut?*4Mum8`ai7Wjgp;xXp9`Cd%
z`c-e$9fKlPIXuv2RY9oVJJ}nDcWW7;yg=g?cIkMW6p*Xn+jfv&zz5!*dPlTlZ{N*{
zYm8^_P`<p$*Nu0sJ+#3(jija*KLs`b9}nr!e%z8f6=Xjxz#kI(s^$hU{F6SyrEo1;
zm!eTs@Y`~y?0cHdSZ^gJu=)!R19*Pt1$w(ilSNvO?FGlp;y&p>N1VLt#Jfz^Ut9$`
zG)G^l1sfV_QI6;y`tve6$cHGJSgDQ7oE&zLQ}IsnnicfVULBV(-eIN$HHI6YR(&wx
zC#c<v?JGAwgS~a*Z!5BsMXjhLVI$y#BvcxgSBT@hf0Wu@RiE(*y@nwcFA?o>a@Kkg
z?1UGP=t#|{?WQ2KbYKG#!mc*3;QHhMQIv89jZ4NWW;RaSZ63RzJIFf_a;NfIQy{(x
zNLV6p<~@H`+JtcY0T}65faYfbHPC7@lVg)E{KvnuY_SqNvqLhtd`8-(XACB^dd9<5
zEu#+GK?H)A6(+jAw)o;?!r2pa8j25RwYGXKNA;KDI)OZIo)Q=m-@&x53vhP&uonVD
zMf!(!mq{A{hhIp_vVL?)h5LF@tF@3Phzv@cd^MC0Op_<!%tc~-H|dBCPLi9xDlG&i
z##<I$v>5e}2=*d$LgsEhYf#xE4ByEn8a=*sqRUyW=a_n!)3%b0u^T?i&Lf%Q;*)Nn
z`3W-^Xp^Qjx*)%ttS`2@qb4TpCNJtUxY=ZUwIw}mDVN)7<{y)^`<m{24oua<`Qfeh
zPpmQ0kgT2xpKEPx`ZV6D$^oJpHixF=Y=i;$&?jFKko~1~XIsFQf@PPVYlmqlTOV}g
z7ZE*}=2}!f$tC&t^UuYmWhrJA%Mf7YWlV{lGjG+JUzx=k8gn?qm_GmnH;f2Aq5qn@
znSPLZ-x2RrP<%`YOa9ka4biH;ZwMlz^H9mqYDHN|V420ES<tg+$zKWM+209csh@d4
zDi^N=ai=nl;J1XwTowVMvcB({+D1dvFL+BwkG$IQ%{Tha%-BIO!jo;Jt}=HSq1WwR
z00o^d3p~W|cmsDT54E|bK^>?K1F2c@wNS%D$%6f-f%qoAv6oBs<ky8tbcX!AGNgu;
zWEHuTYQwW?FU|RkD7*Buxv1knv`4_pv-%S7^}8+?6MUxk)FlJ-raOLR?<g~U52M%l
zS5n5Ah<yu^!pmcSQ8KF&3nl8vr1sSJ5D~CZC6zvkM7+BUK!&mK!FT$PCWs=S^yP82
zaHrN&5`De1^CX8M%R#M@qSH|xjZl3vW8+fo=-CKI@1q&eUB>E*%YA)@Qh=(_m(0`q
zqa{iQ8AtkU7_3pz5wyTuET<jHw+Z>oi_%eGs$4)JcwVc)`?Q;jVddNUT<9bdhQyFx
zLEnJbFLxMDjWwnYj25-m9H|m5+{jqUF6l~8Yxfi*-aV*XF|HPgUWdd@yT_Ht3S#S}
zx}-O*mY`BPThvH24$4$`<ZSCm(x%^cLQ_mnLYP1cG8sfl+ubCpP7kFoQ7{|6HO}C^
zMA~pi)GkrdbYN83F5#(=+fX(IErC`MpM67}aT{g{Dt(8cI#@1ogj|KW9z5ScO}*cH
znVZ(vS_Sv(H&lDeCiUXzJ{_oaP?OMuG=VMJvG}|7MfjHR(0s2&b#z1FqwTCZ*02@~
z-q}WLb8dsTZnZW`^l2e$_U?W|jU-kMw)eRZdek^6<fEVG_AuO~Bz>lZrpc@qq_)qx
ztc2O4MaFd~2guF50%8Mf@(J8|re4V{*n1yAni%{`gIP!TUexNY$Lc5Ra6t;7BI7^a
z!JWYh(yj}W?Qa%*8D~R-qAcbR0DbP?#Y|fb89aHlG?xL+TQMdTE<bRSO(&bB=|=lO
zW8Z5xe5I-?DII<|`duH1Q^wN$CykR=HR7!G0OjgfMO(%=bCE73v7Y~VJefC>I_q)0
zZ9qYkHgdKwGUjy6_K}Q~0frCYXN*zz4!mwcx8<XWKAu^idZq)yxkF^;e%bDlDzr81
zT6iyxv4mIf?DYU?^uSSd7OZqxzI3LQZ{oR6tnsj-5K5<5GHRoA{y|ULHX=wxC>Zql
z5U<2ad+5yTb97-LE2xYW+4f^3ga%{jmqL~^v&nzfy9ulf0WqxRuB?qa`vOMJ91V_*
zlw$FZbEU5`qhkyjgR}h^Ygw~X#uo6tv&kxA1^&zz5#E1QOu)yG9#frj$=A3O+H|o}
zH|BGB$rxC@Dp2$!@qh*g+h1=*AptbzF1Pqa5m+SLA=$|Q%uee)8C@yoE~{TDm=5UQ
zmlY96JfI(1F^+vvs2{RnMd3o>a$*zA@vD9$1Hig*q{$h#U5XOUc}5ezF<ut4>ib?s
zolfM*m2JFKmvge;!DoE?SsEMv9}ZXwrR-UYDE6m2P{&7gO!fhFOdfrAjtXzQ8tmYs
zzR-e=TlCSE7YS#7aXxP@arkjyC(lp0Z46Dp)+b1fa^Qky_P-Kcr1}Oy^Kz?4R&Du4
zBm@Q6;FYjAqJTCA>phg%-(<yB_R2qdzKRk;>ZDm`h0!^DeMa^^=b)oGlf=t_Qi)(q
z`I6s8>V7jcKGPlxZP1!=>NQO|NFCwdxEfUWUMfTscKR^j%jt_Xu~(Uw7dGXj5X1fQ
z8lc9nv#HM~E1K%q(NCs6{*5VF`YwqyrVmuH)tO%eS1GPV_Tpcas#c}7p)W8;<00j2
z81Zy}lVr1voZ<R$wL6SOFVJ?#(ox^z%Ii-D1se3c$k5O);=J|2YBOl_K<qh+TYez$
zL-IFe&v0pVeCNGE4HNO3g+Yk$p8?$rwxxMSJY*Qt!!|V}e^J(#3v!;aOg{k}6bD=1
z&DH~f?P6mt9iE28ZzZFAOA_e7hcH_;f+Y6`CpaZ*4I>P9(pjah*3Uf6e5n#4={PC8
zpZmq!0*-%>QQyIPT&U1H9Fx)9QSTh^P!e?U5+;^={p;~@G<C#&pV5m09_<-8X@mP*
zIc=u&S;=-pnJIJD+DF~tJ#9v?-`f8BpEc@d=;p1pY$ip!%IM<4v<C!r%EeY%y}hqX
zmUM<(mQX-H^#M5#MA}`Dph|QaWZ}gSk()0xCS%$=r~t=kq;-i8n>N=BztpU5&#DM!
z(rHd+C5Q%IuFK8cqvL+oZ?CPD)tFWF;2a}~ZT`wRiji;2mwlQHuM$7slAh59U!M~7
zyApDVh>=hSy(x?kx~ddnJCM=aXi-qDwRH8hTPxnl1M7Rp$;MJQ?7+gL!lO~qk<JE`
zb1BJsa5m;m>N8k1b*Me}EJ~nwK9AzjcEv=Q-`1Cv0L!PnH<0*ydGeUEE+4U9d8JE3
z^S|<TK|x$0RuFuX4Tn3TLK6E-%0ky@15PHms3XD-rwTNMp>r)M<KL>Uj}EMQN8e0y
z9j<4%c_dkp=Zi9vjW``jx9Ck8Q3ZWQHmKG$uYuY}o*UWcvVm4XrY@Xo2K}{wXWIdt
z9N)t7K$7mekhaaaPBR{c^9{KwuE4$^l_k5t^%c)bWJT{LEd#iWfSTA$mjoiyY0vHc
zrGz#_bZixCUpng%;d@uu@ZDfbDc|!sLI>edaMHSB3L%t&J`bKR7W&j)-QRML!FzEj
zTN9_{5X;ZTM<%uxG2cB+4>sI(qPH){0EE!HeZ`Jxfm5XRqm6~Dh^79hiI+ku#PJ6{
zhA+QV#>lA+^YY`7MM;Avp3y6J*zJ#I%w=6};n2BO4h5=qN)D%e05QF-E^D096ks*J
zR>fCZ|6tL%-bnOhyQV+*&Aoh$fW`TFNx@l_G;Dcp2q2i=!f<-dETF4ZQL;a3gPGsg
zV9!Leu88P45=kG=3Cy`}D6T1yf4^+hfHSARo=;yF7^qRlNzLSf;5@!LR!97Ogik{a
zv;emQwfm+ZpUqsfsUVr0+Cv|I^O6sV=&5Z(F+4C41dr_6W#5D%M~*a^Y0WIrfkNYs
zk1+ae`A0^*FX@z;lw3}WI;mQLElV~7?`J{{exnLp9$}#%PYS)1vBu|`6gNg<^jwL0
zM7gOAFo8>C$`n%{rGp%DsF>hs#e*(`Xoby+^vF_h$%O3A+NII@EkXJL(QqM;VoX*w
z$&2Y-X|LTk>jW*MC>3!%j7rm4Fm*|PU79U*eADr0W%06QXJ3m&F4_HTi$RZ0v(9yJ
z%<JnW#0NT24+x{5>YJn+v823-iWbi9G}};Iq&_d6K31Z$P?Oa+p&UVB^?MbWwaQp#
zn1fR8((mLy8nct%$)A-MGNR*=d6B*NWi%DiM<!ylHO);Y$Wq?o*L&ULxSUJ^zPN-8
zD^Yke@(m6kq&+m*F2Q{bHWPN9F}zUa;2)MhH#}^!bsSb5Domxlw!~PfVRC=d{;k(|
zES*5pDm1TuyIc2DY5$akA4a}uH=LwQ*!Fe({?5gbZd<;knYA1^a2j_6)s*STLI=LI
z87B%7_mrAc&waE0QP*;5O?-n6!rFp`?5*iBL$(vrF4y*#lyH71N_%Tk9G^Z>yDMtn
z_OUa|NR!7HeOHJ)1K{!UF=&a^FHjFUZQ`$A6YW%<4hrd?GOtaJ26QM-{$eMcaBW)L
zy6C)nT1ICyD$6-*cP1-DzU?kzm-ctjMf(>=VU(Uc4ze9Ceg(+60^57<9E*sATD7Ym
zM%%8)rVtMid{#)-p8Xu<Bvo;=DG*Z)<2w*n&Z$FnNM8L^IigbgB-m}5COCv%N=bi-
zckiIo=lTBWIUQG-!fcF9$MER(voDEk^bnBAJImSyz_(1FeAZXw<Fhyt+~zvn_guhZ
zY2j<<KPw9id_~>M^2}9odw-SjdDu4rk9>fHCgQ9@UD~b9lciK{YbEv|dh7Znw#glg
zuUSgkd_JBq`v>o(S|M4v89uO;n$SmG9OAqKu|dDt?fMyN<hrS6m(sUuw`vu-H$1Pg
z2s9N2j(~dHEzLhQip1+AKyZYq#&*_;S-Z7>1SS(H0BYKYSl?Qj@_>H-)iX~?W)ikQ
zg;eNp8^d<%@+N<W6Vun=@=@vIRm9xnXoPD5S;d@E?I3Z(xy1zBB)B?_YQ|b9fEHUl
z@%n~lYv~6)Wrxb^Rc9P}?7v17V9ORsTg{_Y)tg@H!=vwO;&4of8bBOXzX4LS&xvgv
zS|b;3PSkq$+pk`Vmj_EL=iruSP`PYL@BKQiFm2k=g%HhE*gkAVmB17<pJ(&DWebJ{
z`Mu@ULiVU&RZYKg=yEXoKDqRvvcbz**@*~Lwr$HPVUdQ0p*9~Hkg;x{Yn&V9Oklb@
z9k7HXxLAYqaHJVIPB%$R9rP*|Q?Fu!6RC)egM?U~H?e1ozG9``ZgTZ2DQmcTI8h33
zwSnx&wyr1Y7ZfgbfoG+MufBbvi#nRKB569GtJ|$ytpx?U=lIqkpYnXPkyVZ!+<kY{
zHiKfzGSw8!FtLoK+_}^;E5PMJ#)H`XFQ62A2Vx*04l`6(3+QeZcsF`yQ2^>yvbFbG
z*ALR>S(y=Wis-FgcEh}hz#hKymhh__mO0&$-MvfK09YF5wc*}ixBg5<UU3_XUG{Ln
zF)aX60eoUlPOV0aVPOB*I(llgCZR)RaC~;KO1Xr-n^Yudwb$@@d3T<KYMg&ZV8d6p
zZuOGyR|T>u@ZtaPfIl8&&&{&Emw48OyjcKh@HA+vh2mi^X+?loM)Fj>=22s|R>duv
zXif~JCOX~FQ?@XGqRCr-XHkt9`Cg;fYn_a-%mRXuWQnGQESvcqF|cRy<Xy8}K2VxI
zEfRcLOwtt%dS}(yG|GGE@dZNSPv8U^EufgYBUxye^K)-|(%EvySSz7;p{!0$Eg?;b
z`1aMjTRoM~vl%u7qkrjZvwCxtPA$85uZlu7&7gdnkG<l)uU$>7s0WJG{4JNhg9Z$W
z$kL2V{Es~SX?abzL)bEgyYxz^MGOx-($*VLlh<zeG9CmJa(v1}=KHbIssqh@`IZeF
z6VqDqzgS>>HO3m@%3{00=iaBV)r*0%Y`8oqT)a0ey4V@HX{h~fZ=FEOZXC0WO~0;M
zB>9wNC4!nqG&EKoPp1hN`{XJFkJz+*5*_8j-h%ond*&*P`*}vBg}O2RjV3|kddTrR
zOxV;bHC*I@E;=KUvh$7zk4|%5TAR{nM6sViz%ly)J<_d7r=xJ&W>BN+jiC@lDJI~=
zOFnB*WUIPh1!XsRahNf1B)d}lMOAPwSK*mMjr7u7Zt=M%cO@aO^Q7552l<Vd45?bt
ztg3!6%&`nLxmiE&Au-cHZe0emLSQzl7q*V_^?I#g(V$>t>9DgP$2C2mFxlR)?a+~C
zY|mH=L~En`qPXD27YAk~HLED}hjNOim<%1anejt0*8k;h)qXks+s!`%xMn9NAK;{9
z#q-)C*UYX;o+?mx6Bh^$8OG#AeaF5?ekWMAgxWITK5^)~Ykk<iNq-^qgjf`0>VN9l
ztG+>C!eCq6l^i1<d_WYUy(Pz6Z5>-*f4-+LP%K5Y!|_7X<?%QuOCim)Eb7A7YQ4H@
z@(m9rDIsYFk6=CbbhhPftXyZS@lRo0t$`xAd*hpCZ=jf2$w~I9+Exv~4a+`JOturU
zdmXoRFwf|TBXl3R0*%{_!{sCJnWzUqh~MAcv1=uU8QrL%l``A=3xFxJkDIG7q2_>e
zAwwZ2;*{{<N){}$wAMKKnKH{iU}SQZ&}e)UIk`90zabj`L!XidYvzuC-UgNM*b|sY
zc#&5(_hMsv*~5<S_$C)YJ-mN`MX{KUV%*%QppER>r$xN$N7Nyo!|jhUEi6!(%!Omy
z&Xa9Z4{%Uz{%BFq-!M<}Y~uI#zyl0mH|*#cA}@qYnvaayYCi>)(05*rB?pyACyo>T
ziWh#R6oP_C-qX1aocbEKA(aXJ`0{$!vJ2-Xn)?~Vo1?Iq$^NHV&gHWPa`w(O5huPw
zKi<2osP>DeWu)}}1|R%J)0*3oyl1q>L9NPtTd<5t{2D~wfDd^vS3lkntMvCYf6b*@
z5y4Qxn8Kj{I&UbOsKFuB-On>YN+Inx9PS@DtNRVrv}~JZhQ<eT9yB3X?@r*;9hagm
zT5Q|Nf5~#|MOiW~uhjYR^8#547mk4mkQy=hebF}_VTyaEuh4%^JfLPCDirj|R*hKk
zmWzj*ot**>Dkh_2YpxUDga@aJ;vZsQQ`)NLH9{=+v1#Tw|LZBw3DwA``{!w2p>L@Z
z{yTZFF#h+64?C8zJ0Et$&#|+wJ)<dlLHy{?)qRj*d;g+vfkqGqB}-T2vT;Zui)Z`c
zkLAmluM)d=2i@}}ysp-!d$3Ry!MO3@$Nw3FrU{oe)ur8=jz1TV0Vz?4TQ21n5th*`
zA>*+cP$%a0$9ypjGLQrG?XTH48r+}!3icg^B_;b8;;;Wfv)~+#fg9wKo+q+*T?R`B
z(0T=b5Q$VRIL`NS^cYXkU(_4LsDqQDuG~xPWdP*8{Rer7NTq_+?_~@u5t?FsS>9+p
z?=}UVM}O(TZyvV|P|#S^8YhSsdaCS&@Xih?ZH-&jnviBbApUb8IR*3cF*%E#)ezZ^
zb}wbxL~L@qv2N==#o_k$9qSmpe~FEQf2x&DX<zRS4|y^>6uC7i&Fz5hdK*^7^vAUP
z9|?4Fg#tFe@cWMB#1v1*pJbCYxWA^AlneR)5Pj#DaugCZh!=6>*pshg6^ksr(vc9)
z_W08uB7H6R3oHNBb#|1@J&@K|q}>Zb6I^{VZ0SK}Ase&t@Q<0X=}n44VU`-&a&<?P
z@GAB;dAg@@TP*^YkE}rU=|5<5EQ<Tf1Afn*9DXNNn`q^a-8UnHuoz#@js9Bn^&zHJ
zWog`=UnP~lIKsb!uMkrz$g=r0z_@bx15tx}`+9#Zm|E^zr!(Mxm4p9@63tuO3~_w_
z)TIwt#_!>qS~21z|FJrL7yRp56)eaHcU{&(Z#3n}{IMeQ*&C!a<|^%SznDbnt`z)-
z61KHb(7gSU>>lx|EuT_<pteJS?-di7-JkNiYJx-d;j!yfaJCJ$947b*o1o40+`h+v
z{rT?JbU*ZWvgfZ2(Lc<lAnJTym4oi|JRI1@G=%%Nv81=0ZO;9m@}?Jk5&O>L4^d<q
z0OA(+(%O>?GT8Tz)BcDID%qIUrj$c^ZdJ}k*?5pG#tL@+##8<#82<+Xof09?t9(8C
zuh$%&ew?6mk$*^Bb2#1+=e1on;z{8xFADqD^2%h#5(x5t7cCjoYD2D(3pypf3F3;Y
z`iKa>ttlW^vNa*WeZL}&4;P9bY50eNJs~bUnWeD@h*~FNkX0zXE+O07IQr4`TC&M+
z_@ZAHw%K3dq|uIMzkK{R53!3=BPqOYzxY;8-f@(jj>fW~mps|1j3y+AYn0t*D;On9
z(l9dR(n?n9+GfVcUEHoLZ2qS$B1$Co{vb4zb~C2NI)s^fR?BhJoV4bCP!NKJ_9NAo
z6cBv#3Xia?G3O26Cs12-NZRdCq3q{W|13H<hbfy0bnHS>TpF1Tg1)<kSgwT;RS44K
z-on~Fco%U~V)5|2hyD)oZX!MBX`rF@*K+?%RDIM!^*rW58c%olzY^i{ihxr{U5c=r
z{SAvmji|ZSfS|+JoQ(2CWpOWFtqEl4u8D3p@=Z<xHY{pIO~2txqL<elM0A_^aTns-
zq>@L@|6%%Um9w?>M;2bz8nNgaGTt4(`{E=%hsNNf5u%M-t`q9>&klZB0j7j&IQp#5
z-^u==OE~yiSbyTbzx<aZ|552b3HevU{?m^CY{=h6^gqk+pJn*ZGW-g<|Feq!S;haX
z;(s3Xf6>IB*_HpS;(u20KdbnkRs7p3dJ}2;{oM=TKfm!mzwy63+rL`ypOyIAO8iTc
z|9}7CM~+F)1Bnw0vTKV!Qj+8PL|kaV@hmH@h1?p^4Zbsa1!A$yNf)Tef>g_>{qN9)
zy;_r^yTetE_FIsul!+_hri^U?sbz(FK8ZJabz4x!?if@GQX<^lRD9cNF<rPSR$))j
zSCtc?&6Nd2*Eyu^iz2%F8%sA07OZwR6b?(ymCHURJ5Fw1a`}<xlyU=8)De4iO~9n-
z?z&zF%9Us!WCgkD-%>T?vF2ZW_D~vE3=8Uc&Cc-U$${K_(V#T#TC9eNf{`Aqd~mOY
z6fHc{m*SJ@UF^T>i&jU>d+fe;WP}d;r%O7+RH0yL?6<MdBacjd1US{q?;XlMbwvpg
zg<A6%_k{N#UH~-UeJkL!Wwrfp8?}8a!~UH8D4+2(UjX(lt1Cm`mQQ!xzU1zq-KG0X
zeI%rN!OA<J_iWFb)_G;}xXRs_=jgShhWIwZehInPFy(CqO*$8q1X|fGq1^*BMfw(?
z_Kw>dLecx)hPzMtCw~NhCHUBQ(1>-%^+`XU?rp@7V-lO$%A~C!tS`m>%snId8%G}<
z-_ga_jTY{uDAbufPwc+E8HX9vr(e57a!C{Ps#&?OyVWiLxN^3CA_#=dpiZ7-9XWy<
z`|a0#{4@GHea>rFI41k{zfM9<hJDbinZ68siu=A>hy~cLeg8H>G7#o?Zgeu_gJn%d
z3S&x%KVW;Z;KaYNVC_=UIlU7ISvoz0n+*$U7{OQ6Qc|{1*oS&fp71FS*OYo^Kv9A-
z!n^`~P|00!H0zAwxzXgQKg`s~T5=n@aK0N*1IUDWsG7wTxEiJ%VSAk?tVCk}xt|ic
zZ?!AfyS?FyUD@L;32c=BUhUZU>Z<+VkYLw;LNiUoY=!W%Bz$WB47RdsmySxYTc2F3
zb*AGRe$4{ZPnCdWB>P<o#;za*dvkrzqY&3ig>J3ODt|LilT0&6=PY9WqI2on(pRW`
z(gtGqiNB8|MzXe>M`G0b%)8kLDisI=m@PwvFbk0>Yqg9KW`3DfRz}-hD98zTW*;Mr
zSvV}(>x3?B4TF7WL^Z}Y4nD3YE%->qrl5LWFO_-R<mBU>L}0Ldso^$-T4i<~VWoSe
zOkV+3mQrHns$8!R08+Ka)bFCqtkcjbet;}rKvpbdSJ>(VL?7i$?Y!WF7|lO>U$27t
zw(kny6ETCLu!CfkA8if!XG)tfwyGlrVa`}OIr^t=cdmeGSN0{X5R$D0a6m8Arz|Q3
zf~Wzv+;L`HQ8_B|fOGeyzz;2Vm*8qJNz>(hcyvJkgAuj!1{6$}6<Z$-^aJpy?0?_r
z9`zFoAkCEKVe4Jl2Vl1RXX-Ul>|3DN2TYxNJE35(WHdrs%rzh|V>z-u7I>80kAifT
zJn;vbW%gqYfP(~j2D@J0t+T_|8)aVP{lk;670U@P>~#mQjdA_ranu43ABb&NPD0lj
z)B4KQtUuST$pkTUCxsqbQY+b~z2PxlxAr6prBgIhS>WRjm??KK)O0Bbgq<IYf(?D|
zXLh2_{9EMgSfMGoj`LN+KK-a4HG>zBlOgaaOrv)Dpf>qiXW5Bp{)v<`OtKH%XP;EG
zcvje>d#Q%X-*=s{212az_suesJ3Ev6utXo_QuLXx^8e&+RPtUBD6qfldbZ&%4L4c(
z4n-Vl*Ojg8yB$ax{X|G=#MqVXfqljS8)Yi7MX4}&SzYAOr(Z)Pm&K-hgMvS~7fUL`
z(e7As?w>rtUVK9N8!GRoY;pBz>nY?S*6B5x`c`!77`1cHl=kzjPGH^04Lw9GBJ#-4
z-Y1<cV7l+|*QMhPqor>M`<BBe^F@1{jS2lnb){qM!_rn~I)m`3Se_Zv77tf=!~GUs
zF0S6~Np|SABEsL8XJe~&kL%l{e)5j91eVlWt1OcRj4ow|<eu@h;v0;sf?0ta^O)TY
z5Y9c|F~IF^DuZ+LQhhVHWF_fm{q%`mEc21)n$OoIlri;+3b4M()JPr6e{qNc!cGv#
zb}xxu#h>BQNIU=FsJyD?B(P;_x!%E%1P!cSnVUQ@8}<PP<Uzo$CXI+5Q!}pR#u(Wp
z_N7yRj`GG-pnW6KXr?=Lk+US}b=o*<@29@{*FS6PA`vk_R5v3Z9|DS12I*Ef!0abt
zek**!9=DuzX7{)ww|AcWWf@BC4w|PVWra}-UC+0joSF)tZfog}9LK@MQw~ChGM{<Q
z1-`lfZ^OuWABz@5!?L0mi}G_E5nBGy#&rSw+|0AeGx9BKm%%&aGV%Fno5>TGqq8rb
zCm!#n<3z92r&nao?t2t7cOn~t0+;<Kj*}NR$#G^<E?-zPR{r{i7P^3mqqaQ&W9d+0
zleb4`{BX9)tA<;2N2J-o^!&jpw#^2N&+K=>{~-2S>(<3WkJ&96cHDE;noITCm(<R=
zC_E{$R4hawq1D0)3Qi?7a5Zb`0$`O{5vo)fg!pQ-dwNh?0zn9&9Sp6k1e;2wkC3a6
zG4k*ciHz+iuy3l<=6-a5f@B~>^+IxffzOzV(b;(;N#AGw$-<T!%xRJ4^(Grn?)b$h
z0_beogucH&0R+O?#9}I^pA5OFu1xZ@&KzC__+|!!wpJ(@1IM38Yh)c-Pfz;tL6COL
zonxSJOr5=FD`pR6tiMfTWD2?Xw(VB3RAE}Wy8T(FW-4i639hcq(yyILM{|WmJ8*$5
z&(#h@gux{s9*upEQCL>KMl+-7Qo5hS{?AE%eTwJO<ZJ#A39_06HL0`p<Fn$agJZ&l
zbMq?uCG1V<p%eAMe!_{}CJ1A_23TyEnfX>L`R)d@o8ZaeM0aCNm0Bh<!zj;lF%#>P
z+Sxfw#))!_GNxQlN`qx(E>Pm)J)u?Gl5=7!*&6j1G<Tre{JEVOUoK@qMC>q-J~$U+
z3SoK-g7Hc{%Q`CB`wj(9R$0Nz`3m6DS>MkJ>r3lB%wnd7U~8}yj9m)`GirBMg|R~T
z0|7jUTq|YMZLndoa`^Qt%--iG_D*XO`*vxADSoLxH&2H8?bG}B1;sIrNzy#^aZk<-
zq?{!gTStA-DOs@^*lB#w*k>yER5rjFeEU9p_2YIXF=m}hSYzYaG_?Z8dK>oW@>WOy
zDIod?=xo^H!6~<q^s=Noex|><bklpXVM@?h9E!#1!6dUryS42bol!kHR^K@4l#Ukm
z0nzot_Q3L@`0hOv0BV=+|H<2s8S2L+!oxhR(Q;Dd!P(#634xP~>|5^n02wu;Vv~IU
zz~%j4hMFOPFBak|_S+#TshvU{Aq8ig&znXsC1W)f{H+l4m`kG*$wm*D>IR7CXlo*!
z0iZ)*4~A7!#b9=J>1RY)hbU5(cBfp;fTK5tWhq_q8B^V7DzOek=Wq)lc{n}c&Cm=&
z@=(*mE5IkT<<+*7JO8G%JNy03Q*(w2)R`a<TG23T24t*?zhI6p8|XF@phj&JeZcuA
zd6j)daIQ6URBA61t3KqB3F#XVDKb%BzA+GPoWmSJ#&wA*kC?=XxmO-2M<e9mO=A!3
zjHa;|rm#rAkp5zp!m@OvGId<Lg0b2iLD5I91>J18Z{%`wg7h;k#N+HRT<tXQ3SMD>
zhFAD*JAL{|_Q^4zGx)+{<MQI0dkTSRH?#&-Ai=}0eM{jFP|daA83F}^3Za=doCJo-
z#BkPV8bf?D;_`x+`*#asXz2^a-A{iE&W%-CI*N1l)L0E~1uj8TK;Q5%^~L%xGd=Kl
zXZLPFs0t14Blin*h|@<mrzw-SCMXyt;Vj(Kl~S-OzX$@uv$E0RQ9V13KOsXwGC-nL
z-+-YXadUZ<l<jtuY+>4+8pNHk^wcqQ5^&lI<b<;!_lNH{Ga-8S#8SvV2B}zlkUJT9
z;QQ&wKdpSGT7rABMPRDcN3OvJ5&l^(iiwMA{-36eSTIWlOZG%%6q_2EzM8Z+cc!4&
zeF<xm+W7p@IN$fP+WnA|OI3PC7auSdf(}H}rJdTeSO<@Kp`bUt9E^a1%#vf13Z=ig
zd;T3d1jkUku>87VeV-EGGE(Z&eH<wt2(1dS7xr95FqK;3@sj7wCmdPDq&+>|b8qT8
zwU(;4v_GEIMRXvVJ%^4s30^Y%F&NGxmqg6kX={uzO<%PU)b3C`=AJvPmFrU&cfb}T
zBY6%nnc->DmY>Z@@O)(<p}b!GWYiE?wp|9KbTX<R0@WVsDhfs-X8+tV5h-`@4dM7X
zjowVU@;d8qH-%WTj^^vgLTbhlV@NgXbgC#9w_MM@0+dr)KX|?Mcywd#)5Z*ExGOX%
z_J3W@{>F3h6U;cPkp@~H!uY*<=CVs>QoUa+RYv@Belk4hvFNO4^OUjn&Aw3z+M!#*
zd1ov7yyU=ob3}xj#y<bwtto#Gh6j|9Me+5dGFnI9(<T)_|G0;I$2WhiXCcnWhi+U$
z5#J=>A%nwO+eM!L#E&j-2C@&k(_|$bfxul5#^M`1=1*J}5h)-zE5pO&__(yu;+<48
z*UdCgMp5UzOpzFQe>!YrQl=XFylsh%GAoF0Sn0T{{`FJZ`3pP0x>0BNp8uE=Ioto>
zy?<dzu{V8RWR*)xUM{+HC9bsqN=lN$JK5|Uw73G95oc1f@5s#vKV~Kp8Uq{`A4$e`
z&zN7-1)P3kYhQ2i13&&heM)I?aY??%kOjhaYAS4}Lf4sSd(-PWStq_PBzvc(AXQ6;
zpg8)z1GUQ+&(bn}ihDEpU-mA|0a4`+p4xkV0O_#pDsMGdESK&?b@CF?io@d)uWPLN
zn<&84p>#?Y3@-VEYqI*xgmliImQigqd|P8wfQupRHO}Qfd%c>!B~q;^2n!6DUz;n9
z)NcP#o->b7Z{e<EH!g5oSn@5)6a5aPCIOufLvd0V<?g@2j!MX|vb(jeR!=`heL1<8
z(y{ev6ovRM{*UxyMVDp~w|Hr&FibI)Vfe)hohW9qn(mj0f|*K)^^_nk0Kas$x1sNg
z-d;vxTH1x^X^D=AEI(MIT37TxFhQ(VhN#cF@Sqm?Uyki?%j)0v7yHP!Pt%#wIUGRJ
zFccDr#|xxpG;oG;P3m7xms!lBTJK(NVys#mM<;yk%Wba=-^Di7e!h;->(G%hhP?Bv
zNM~CK{%3rCegc3;Pvsn?u<H5y&wMC;k|uW^AfF)Ur{pkAfnFDw%Eia__O>YCn|DjA
z)4?6C6LRNTtE<bM2x!Y4hOw%m!H2YcUO&2LD%Z;@E_#zJ(8*;M=)R1(HaM8fS^DFX
zn{)t4?3E7S_r7!n*1lBA?~HElGytb5b8-1Tf`7Ez`~#5*zn${&^a)$Ik0m(}s`oNM
z^y%8gtE5Th*cr2wq$z9{2F4HDW8^hQ!<_wb*NrmmTgV8mH0{+JFl_<Ak;8+w%xQ~Z
z6_t*<C9d|%X+PD*>0IZt58@@)N~X1Tgggd!ExK=zbnL8#Oc@e(5B??3SUQl(2P+AC
zf49*vyRV+X|5yx+^juQIbR!sCIJhJ6%0yLn@pi2;`2f>ccVUM1@C4C4Vtr)HbdV>t
zdW_})*PS&9FMF1n+!bzVc(gfF!*PFpuFHcZBASNbyK3hBf(+l+A4Q$breURj0u-eQ
zF8v4X<{T3sVS}E%X$5*6<)UW0$KMfpHA9xE9)T0J;0T*FVfs4Pt)@rqYjyCC_arR*
zX#g*udB`^fZ}Xd()s-5_bVVs==a+rfYBDRn8m0d<8g^CXZ`YOF%Qpd^$5iZwQFmmP
zO%@_SiT$8vg=j{`f-Fzvk1$({T;n+Me@K5V7;yJEy0J6js9%&-l|ii7=Fv#)%Kcz{
z|Jw{3$5o|5Chvm%2`|No<NUMK)ci(3b{mBQ^m=%hyM6<^EBa-&#Zy&15_;vNbeUl6
z(`{8@<|U+sGgal;*teVo+Vf6E+>yC2fA^LBEp#$hME-lL-EH>-79yDZ+HTW7&6Q0N
zj(!?f82Yp9eE#k@9`D_sg!9AR5xuaV6b?!0(|U9x^ZQ&t5+Ja(DfP48qEv;Sm%-Vp
zrA6nukSu%NGJ#;>_p!C%_H-3KYyRlvlQG<X_Qq7*Ry!O^+$w4#`%%E!p+CNvz^o<0
z#Huoynj(TD6WYY9pYU`m&&c+*_^$dwh*Fiur!5KxJIAi?pANT40$=ss*q*GaoILF9
zb1>X{J=XBbZp=CNR=g244FII`QSz$6W#nX~){MybkJi#3WM}s{hC87BrZh2JbhEu7
zDYnur5vH2UtNEQ0@E<EtcG!Lf@C5~k)SI$+83ba&mif*l#ELJRt<D)Euco2fj2Vq(
zxY;}kg>YC5`$~z>Ncm`e^g<?CjQxm{(yzk*XLr|v18$2BE3lupoUnz-FR+fxSl;%=
zP`Uf?=i_1{#SANwhVb$1d%Jx@8D}>)c%;)IiVeC()k`NL25p#Tgc*^BW4$b|k*dVz
zJ>!i`U)Ie@c+0ojW873UkFDKB*Gs=y47D#Te1j?cd!%Or38;*EN3Z<OIp!93*9LY5
zE!aOOX*tX4$G5oG(K0TT&T&pB@Ra^6)eA3Ql6qPuE@V9MtOT_+Ng1$~59y%u+cGrd
zDZpq*(bw@BGu+&qo_u-3fr`X-q+4l!IXsuIiQlZp{tpv+s%t)4_;^l(Is?={pQf{Q
zspET1X+SqsjVjs60L~v1C<yra(=$AbF@cl>2uENew5v@pVVjk_$CU$=+X1gmGkNBd
zfl>wj-Ma*p-)!H#dpS~A`1pG(ZL?BorA73|F-wx$B!_R56@B?gnm2ik$IY%*MBMs&
zQX2)1klT~cbP9C3nB(&0%-KxecJEXplW~B#<1L=PhBt3Ved<l@lLwXc>#f$H0hYo%
zz?=vxcM|j45gh^rJ*kdVlDoT+@}J%XJ<KLz$Nl@GZT3M0Uxxbe_5nBVEnePeLCz<K
zmKjl0k*Bf^-v{4a7ma6A^%rs+jRD?h4{N|(Q$}7enW*qyG>%t+bU)?l)_dOi$PaE3
zTfJvfw@?iDd)U7wX$xW+pqqOwx1Q*!)OY>okVt#j-18?RyeF?8Kh%2r^LB@QUroAR
zgPH#@(t4|p{!68tU01#|b31a9BZA&jY<{|PIOGF)!1A!-xyL#I=Rd3dH9V;)zV&-L
zXMpcm<+4F#`?uVruWvozR0?dwVO}5&np@bZ7Jq1pKU!gy4EuPbR{NcsxgE1fSI#ft
zC4!IYco==VoG1n^nCOBbP*D5)2T6h+4&dP~e1HF#njrutW^wx7A^BmnGHH1#yTHA<
z2ZlE$nole9Z$&(EnX~v2GsbFfLv8jnG2jE8>a&Krk2a=(^0Y&m#y9j8U22y~LrZu*
zjwn&Qz`uhdFY~_-^B{`jO^VJ>l#p%H&9D=d-UpA}n`%GoV;sXuBJa4`RK=)2av*Zz
zA9q)7cvLK>sMjv!K0`tu`6t_Q?*;3Hl8il?;%vKnPaI-Gw0%abPh)EM`jPSrjtAX^
zZ;YBg=GU}))Rnu)e<TeHzg?cQ!@ElJ?;?J!1t7;|!X{Mef|K)Be~D@TW=29eyws(O
zC#-QdzbT;1Dfoj$n92?PcRQKRTyqoq+rcq^?clGEHkw<!4jc#RMc0&brJmF&Hr>L7
zKUodsdT87**8W6KHk!zItUNS|;+|10c79C2s_mci)07eM&$VL|VH|kRb6cJ?aUMR4
zI=KO{nr5Qpm8~D5*!}S&<Sr{$_X`#i4sp5MvQT?l7`Zs{-&Fjy1_cS+co&?gkDSOs
zyBa@BzY>!l0NYSR+#}hfP<FoR>_grn(;F!f*3WM!H-wK&=7ebe$%c`KA8zwroAc4e
zN&0L`lg@r8%p~M#!+oXOI!bTX8faB(t;D}_&M8yer*&j8ky`){X#T4;K@a&SD1K1z
znh!lodRLd0gHcA!QkGv=K$>^Q^IXdhC1EFR`5bD$+QKIO@c*os8JDG<fE#qKbWNv*
zC0sAjzU@W|v*z6-khu;StKT?_L`;~pVr&>SV|2~~&N*7z?U0zKe@IX8V2ljq9Io(<
zz<0Bp6A$GCmT2+YSqkHCEhXI<naO_@!N6tGk>R37D?O85;S%SwI4{>5&STuO<TY*K
z<m-~!dO63=K1Um~ofc#G=df`RZDBkyVX+O`%X?9t7Pg;F<T71^;&|@ESBX$b_iQKh
zc^VIFtP#b?Ey9CwH*|~jM=!|*2e%0d#WXcz`Z;XtvQ~Z(a?7Fo(2{<}+iH;it4?=u
zRU2+`i)tm7<T<~qyiqKpFE)|1mx9A$GJnh4OV(~XueUJWIfUoyd(w7~*-f$K4Zgsn
zR3XQ-mcuOxue7Wg@0ODuXn>QG*=2U8rRXnq4mamp>i)^j#fP&*DAFdG0{IjBt#|H`
z*+ZPDAPQc^cep~FkGbYFoA=UrR?`J<>opu^Ro44#kFTT+-;^G*tO$9I%750x`)J4m
z!T-oqx#8TnsGUgGe0!I&2d0$J<8-?I<*4tJUP9qV(wfyjBEU=+EYskU!D95)z4U$9
ztX^e;$f6rL(;V?gA@CK6{&H3L6mzi497DMxea#r`{DAGFHaXyHYp{gZ))Q&?oW^oH
z@UmyB?xoKSg>C6Xe5{16O%GHi-uftD@i|r0)8Um_HMn^kW^a=x@oHVr?X;(HxnWIU
zb=#%>q@zh_S-(U-ZE3PjAs|Eed+a^S!wgXl;z{Meqmnx3DEEnf%}wx6inlkY_ZB1L
zss)c08k5}jyZvXR6dG`?;&VM-cO}R3c*o+mhi$mzZJ6)B8_s&g;JWj&&|zFn8gjLx
zfl4C@ydY6*+SxzlXU7u#%O^qAh_~A{91Gu52@(oE+UaP}ED#OXO*i)#Jya=)ER}>+
zw;&;{8G%8Df<DEHFG(oMwxI^rPLnlXHVz9IpP316%k0B0sME$N*^DkSJ_)DwqXX+t
z=H$rJ=%vop`qKHoz<f22<E*IT8vWRh^ci62Bj}rdE#E<STUZ36vwEHY<$OGw;?C|l
z$IXheQZ;rrL&8uO`LBg-<iwyfr$v<k!W)??Yab$Q(EKp+-dV0p(VJYRgr8ai+Y@@a
zYUWuGEGSb)z}W`SXsEU%;znkV*oUgy<-yOq+?TPpbKfW>^v2b6yEDb*$=M-qOrEnw
z(<`FsntQ1x!kgoNjD{R!xJXbGObR>ktJFCOs|E4_0Y7!z_TGafv+db0%j(g#0WHf9
zpc1bq-1o@|?}IM=M@^u3U8m6eqcn{fuM`}mjXLf$$#3U7iNpTK>fL@P6S~W=PvyJf
zcTYpwUKw>sI;^|9ZJPNh-q<}cXmtE^a<YCm&W!G_<CU2(SQ2YHmsaDNoxbEeWKuqD
z8(J45eCwi{$G)r(P(e^zyMleq>5*t|tph#<ugNg}>9@<lXH909uL3<vgbbufe9{ev
zp#4Vl`Op;nb=VirjvSLj7qTTUo8xFl&I{A@Czb^#BoC!x$8G9THJ;@cP1XA(G`^|3
zFx?w?;?{fWVJ%S>u%s*zx-rY4-E05W<>K2WxYytznB91Fds~Hk$`Vk$`19pYlfWV;
zQS4L54|yNKWStrv9=?v!g}ZOCOh&u}Uo-7cp}PMnQ;sXCYBs@jp<|<`#0eg*r&zC&
z(EayD@o{dIQ?3$Du4lQr>UzBX`u$<$!-&siPx1^S?##Vgy90E(fb-Ou=MWkbD|Qo8
z15w_mEQf<NWjjI|zExtoK_Lc?8&S~4ZvV^rR@%Kh>~VHbXO~NeFH^^$@`xm1X(0g_
zsb>epD*s%3bC2!@$~sb0BGmq&qoM!l)WueEJ6@#!oZtE~8TsVha$saqg`Q>Ccm&>@
zk)&0c4^CWS?iwQ}?~(KPE7ukqgtZ>o$>~UoO<JJ%F_GKXnii0ysWMj%BkW9gKS8&t
zTNh99?(dDgzlQ(OC71)*rKKF(PJjX%j}@Oc7g67nxE88%|9Y0i3v4CB#~!?CVSMo9
z_6_Q5_Z0Is9%DCEYa{vXe(P%6&d>OR)@M!d<7VKe$u*{EdO7#}Ut3GI%T>W=9YlZW
z^4qdBbDPbf7;i^k37>94^B7Hphe0Ip(ZkPvW!8f@cPQhtpcO-ynPw+pui;|qy3MYk
zn{#iZ^?Vo_kGS1%DFAs5%X31@-5&P61q^kR54T;IOge85`gX`hq-w97HcrVJ3!^>H
z$d-K{W_IML<~Tx_dY#3OU3~dEQQ@$-pC@O7a){pMZCKdPE(A1u^o>r=|IP${hg&<L
zB+TW{HECeE3h_*pJP`YulOUW&CQh8ptb$L!&c?IGqDIAx2MD@WigcKhT;{|p!E29e
zhA^jWS#~j|6>pPeFPd%PfxSt~(t$^x9;h@Wx{Sxx!VlhF`#J85!HM`-eTXgO&s}nq
zR+y+56F84mj4~t!Lu*eG*oHZKX56(mvE{XQB!N8N{nz0VJt--?kLlt&1SeQb;QIg)
z<%UyI+XvGxjZ*!`+e3N;j!ey^cKQi_PSfgxA#YwzD=+Q}VR`X|K_io!R2KP{r25?o
ze(Pd!Ur_18K7P%-Cyj#=F#kpj_es!)YABaU44$rPVR3`=$h{;HtY)S>&k=j6-#|n2
zp|o>I8AYJslP2c-<!K=KjZJj(sq%h4LZ(S?Kw1At<fj|(qBO|`L)kl+N`lrm&^-MS
z$M&%iIk<K_+{qD|mGAflZ3wUNB&Ue+3G53X=|NEO2#Y=nMo85(d0eXLe<HLcNk2a2
z-@47~V4ry6sd;;<HI#Wug#cJ>aPN}}8{JFehms-`bH>e<&EwBYUbDAgwRL1uuEf`G
zutit(e%;{59e@6*D4izfUeBp{0>VUdUEB7t$IFFw0zF(e`YFH7J@j&(u?5JK$ci|>
z<}#7E5$oY@szv}&>U+R__}MiU0y}2ZOQ`$l-Z_g$nLaeO{UrI+XR60=S&fk1iE23K
z9y>XuLc^68fMS0w^g;J)Bc2O>M=n^XUX#&X6U4#p0=pagG573@un7+KJ<=?BfIKBC
z3}D>C=gk;=_N+aE1Yj@vk>H4I-e|}0>soR`7y0F}>YV2FGWF%J3*-gbrQ8ziC#UO*
zZ&MG%CL;De2c{pNv?cS@p{FF?1kA;roqj-}C!eEQGXaDf>}-13ZUiNxZSqv-Z{HkA
zn+97m9z+a3wfdsGpBCOf1rQYWpWz2&?p-U<b(iT5$2l$S+AS)@3bq_cu*O2-(@G(R
z++1jK-cG&z=Wu6JD<Q)c{cwLUtI2$c;aeKbq4(h#)nca8FNL1ABwofzdWEKI(FDf}
zGSna6+Q0tLRIwK*bJY+Qxp-6#fAbvWyd`DoZLs%(1AFv#OFZ`P42~RH6Id~5|E3>&
zW89IBQFsOI9c@_4d{xS+x(sj~QA+Ol!8fe0)kFX6&SFv6*6s4nEdhkNJw0`4qNy5}
zgUGPK(3>^-I+6JbvZ<p`8?WB%F0^M_P<b|z^1j#=n|R(Fz$hOtZu21VsR>%v9f*AF
z&NnpojEPE1x{cUMN)5K14-;`RaQ>Ms$K&$OUIfD4$5Q1&Ou;=>T_+tEKWyEX9|6!f
zOnJ8wdXf0Hi}>_X-caS$JY87s=Hp<+%n-YtPD(1#AiO*rY1X+{O6jCG?mOr1&ZuL=
zyOA36LLoCzD_ivgu$Vge*I#T_Uy5H|?Ya{oINY77iHUlh*D_%uGpCSb#S6<NOp)7R
z_1AZ9Gsio=Zc82Zk@y<?5yO6Nw;jW#vltSkGKg4zY~Ox(<_+Ar4B1@zAx=c<BK=-{
zb`cjBTy_C-sLLv{w7YvmBrfJg6~~-D(3t-E!3tU8nc1lYPAGtfiCc7h|NZz}p4#zj
z#9QEy5F@~YZ{kT*0EAL0^_9|aAixFM7^Z%j_?6ygXG(Mm6>-Kvp5yCGOL)L;zt#ft
z8)kJoTP8cqd%@~BYS40Dek@(#=oPWLo&MdxW^3KU6E`NP=*}XkcuhD-!8Imzv{_}M
zF8sTn+qKKXLPqnjqb#q8Ql?U;&q=DYVF{|TV~a<@8lQi8LhnWKUx$)#ce^nMehYr&
zbN7Zvt9jY@!!QI&q<u;BgZa~^Uq8ebFj}cIy31CH%@_1W@`UALJ<(GQ=Ap2pa^@AD
ziX-pGZ_&-~o};z{?SEzulhl(_U>)};G<{jK{I!HVw*HxZ*h+<^Kk=<{I^j|QzQ(!Y
z&Cn!zMwKHvdWD1`*Ljs~Lavlg5w`KHZ2MRttLFx^pCe&-qEc!fMTR*ir<aWpj632)
zOvYz}kIrrg#!1`%lytkVrab({ua6g4KjEK1)D0HA(R#et=}T<_9Io79dMYY|&$dM`
zw-^?gtnuOo`S7zna(nEf*+ZcRAaVXj)5@u*5Jy$L%3=)u<1RJuD>}*}8<Pu(qN*#=
zVDI_h!Tt%aOrJZ^#xVLgK3Y-3J>$?DF^hy^UpQ5yyD6SMG=s02?<b0#O}c+Hzlz(r
zS_FHgK@xuQtr<G7uWqS7q=B~nKf2yJEUNZh8&*O<l$20n=x|7-rMnT75QYXRfuXxw
zq`Rf18wQZ>l4fWax*G<DddJ`Q?)^T`-pBVR$1$vRuX|nhdDVGdYg51hH)f{bjEROZ
zOAukwJlO56uj^iMLm9*8`E@jBA3bF&0dUpvcB(?Ng6r{o71i-^0rBRwaCB(T$|Ui8
z;iOr}kglX;+vzHS!c3OR@$G=4wi%)|;MJ0n_e#MiEzW~h%D3>q$91zmJOJS{NoA{j
zz}PlwmSO1wg;W+JgEGe&WeeaFTj_kZK>~3WfBMV~9YO>Xa?zkXjja*OmfJ_>8Kse3
zL0!$HDI)fHe8t<peMQ!1lCO5-Iij=x9qp>;oFqjvbbH$H@*p-rVPxS5!f)RfMb5tH
z6XW&<#v2f7uzT(-;?>%!V%(Mc<V0_~-!@+BZ%oN?fd2$mUHEDcSky|lcKlrsCa!fr
zLSTBSdc;`}6<A^<fyLYje)m>n5Sc>}FmqW8rsjr$VL2)~p5{_bTgd378JR)75l6;X
zN%x_93b>dC`}i6VVMU$ijjOhl3n(i-P}VJ6E{h|loGIJRpfbJfF)#6LR>9eF`%}o|
zo9;agZPOcaA;H%=42@j)Y^$fSHyA0~qdF#l_Vj!IZAo=6AtmQF**>W8+0X(hVbZr6
z&CZ}IrTm19_ZIf|Uj<&{;TGEz8YJwhxhG#Fh5lZhz0sq58}T5DnJF50jH12NS&Z?#
ze;YTH)N5mT;qdMB0xthNAx3Gvm)~+6J8R1*B2mviaNoxQB?=|>dCuHtZ!yU&?2A?d
zb$LDGNH8n4IGFHeBp1W0K_H*7L|8w+%ExWaYutH(0EXa?Fn-s<8<hiKQahu=BKcN0
z_MPIWusaHqaHnQgxx?(P%|cKl-`jPFHq#1jkGOTUm-3Cl82xk0e%2hi46ill*;~5E
z#l|Uv`AaA-I}T+HSL`~Bm{P;e-336~asz|33l5hm<_W~O9Bm02%_j|oQh#e7Y$#tk
zgNE{bD)$~UulyXt^7`v#urzn~M|O=%tg(o~b0fg8nvT5vP`C44z0ecfm5(&Y<n~0_
zVi*0X;u)pfLW{6;+n{k>I5vYc+<MMj*!wucIS9Gvh}uI-;QioeTW^hRNmEuJ_Il4A
zA%oYf8Ur@Nw3ZV}wlAQb-_YA-viI`p#^_){67ulF-e)y*J!jj{aPx`I;NrbX@A7u_
zO83AO<!e3N#_!4&cU(*7&YKAC@r}&e;c3@jTpG_S-v$i`tSof3Y8kqk-)hV=?6!sh
zeiF4Mt+;Zh9cnc99SNl|49XDlr*B+BguDGnR{=kfdFKRi-9Tb=m`~bpQrHiWB;m>C
zfP93?RDtj94?Vu)C+CBx#J8Auq>9yTN@!RMk|OefBnu3xqN`%c`Z6UTCBhSOSf~7}
zdWE(7o?Db3zBu)9{@`F+OP9_qXc8-@KDE)slNKKk5@F%qFuevZb0@-*+-q_}Zk%K6
zdMcx#3>Ga4PdEi{%Fqr57Te!i4)KJBgh{(lSbvm%oUn+fh$TqA#O^vxAhdsPffxzH
z1qninZN2C^m{l#WAlXs;gbZJ*v0gxYFO0cKqdq>NnSFkPg80_*Lzcwo<Jj>d{<t?Z
zgI5M(+;jbF*CPcxN;vFDC(Yc;Z<j#(rPq;@Pu}P~PDxi3{^Ri~?Z|t0E`X+__4L8;
z+iY(*90eLkuH}~q^&Rch+->pAB1YDpNE`pw*@%K|f9<);;qN14AfV+|{PHS8qM`fS
z{gtY`-Ag?C`kxAUV?WlUX<;bNKF<Bwj_$C@Vf^zg{N3kq<JscK02`(|F#$wL-f6k{
zNxL(Kx_FN7Lt!KyWNqFsR<Q$N#2{o?%nib#v022xx2i*#QRxgi^qzITemCFRi>|Me
z{AyVo9s!afG)VWwI19Bl<O?)%<_<IQ0e!MjpvHM|U9nDS!Pxo(wHzPFy^_sp=rZAC
zTd0*jcKuD;u<I?h#sUO%(JthSp1nkP4X#A5?4za&|K-h)LEx506{BFG=7Ybq9<Z&M
zz3O@=LQo~q(Hv-P@F=~3hg+109(NpW0i3nf5RsHLETw1azc;Im9SG5E2Lx`8H0arC
za&A749-fZ;!P(}|aAh`zM2h7o;I5Y|BR+wk#ETNf?a5mwoTc?1^o>(fsJ?09XK1hc
zmu*av16N!yV7_7(ang^1M_Vcn%U(L)K~Bvc@4I(;bcUC0nbjh?9)E9QlAIZlZOGFU
zk=|a`-s5Chc{+=R+KG_JQjjdxz=3;@0Ndu}xFiCY_=|d4qiNC-b4UeVmKgc9-!%I-
zjBY=s3WiR1Hbb<v5%dt~ox$e2{Sc1{uq~AE>!DQxIoq$$!lAab`j5-DSqsll0{s*A
zc_;AiAr(>B^>YuC*1VG47(PIi?9sDk+z*LM2Ry@%U#@&_+JzdlDTHky$A{Q`!kuxf
zq?O``rA;_tjDt>?SSz4$RPnq48z%=KS#S$SK_dcgQO&n_&KwwA`~{z27G&YoFnaul
z{~Of>J*iB`>H9@`v&#g6X&Z!}{ZMekAAUEA8uuRg2Nx>NpshTMi~Z#L%SL-8n%J+H
zbj)TBO|#-FkE$^v<MNOvp^Un>guB(pegV74mhrgfUXlneyuyj_C+2T4OJuQ<?x&0^
zFJIUpXKlg`z`{OQjyx`6!qhl_n>dwEPpO0-!v9e4J#>KV(e#@L7SwphAOZ?-)w=LC
zh;Gv#fBUq)!q9&N9Z1NY-VjZ><q57`Dwl+0N{vRl1FgN{fL<%vatD1$ix!M)=_Hqe
zsn@ORW4WwzF#X$#Tn}SmX_<9>y%?I^75SqJevp=(8&``N38jO5{2RJG!6x_-@q8;i
z?%O9t9*?j-ZM9AyCFb1=-34gkk_yo1rb{(vBjuSeP^Dl1LAK*fEqsD%vJsnro9coG
z6YuaNp1r!Rmxw&eV*PPm179*_%b6}zW5#DA|9&bg(1H(4qS6OtD&?K!OWswMsXpZ1
z#dz58>KDReG%e+k_+;W&d&es@Z?N<S%=8Q=j?We*<~Ta*Z=R1`DBJ3<L4NZdDhUyF
z6qbV5@Y@sh4jYSvYP1WxPhoA1?FGv0h+VhJUmKWWnuKF3pWP{Fx44hrp&rT;?AubU
zUA@+pL!jTY{#^YSeZEuk$kham7|OV4ypHlX<`60I{E1QIIpB{vvVteKhLQtEq*c7v
z9DhpBbp6BUpnrX2SMrKfr!=`GNn^;n*0NDoeM@T!l68{cC_>t*GW!_LRbMeychQvd
z_Ez<86*`z0B_a@8BA*@YL3uT1n^|*-{krD!v@kW+MavvUr@A%gFCR@aIilbgJEA57
zqQ|du;~3%1r0Htc>8fD)?B;pI{$!-^%-#7Hv$RH!Fv6)FKzowUP54%^$8izHi&$wa
zDAiM;=S@%fJMymGxMI3$>N(_W8bI=GHa-yy#eC+dag`Uhx%z?FD@CI}$u1vLaG>p+
zhoH){E9%tGkIIWyojj$Ozi-Ek5B4bb<pcM<YPpYx`OoiK-p|qmVO?@_?GE3+^?B&*
z*+Q4x0k4riN2VUR`loFQ3p*Rx)Qh&CmY89kx91w2V!|I@-n2;*UidJwa9q_2hF5y9
zE}5Y#LVUT}9?NxV7{#hpK1Hb4lZ<?5PiL<uT&oOx%$pV#R>hBV64bht;4<th#(CZw
zG9Bsj(>f@Ybg&iasO%mkOXT@3P<3QXQ@*p>O78vniORik|1D`On<y*ybX8I=9_jPU
zP~dO8e#qY5`!BWwHi#E&R_d?KwZqa;5?FDOgTlfPU!8s_AY(e)HGb#=a@e%eBM%=m
zg=-56@Fb<k2Amn^pWW9AgiP{GR!3{ReDtfI&XhZ59_8l9WS{uXbhO>MjmxMhoL2wn
z_u~D4o|LewzOdASe&ec14=&#8?JhH4bdB09l?ALu1COKpsO$5cUpFFSxA14$)aY)?
z*xt3*R7--7r0$=eRPe3&rbH36LJF0`|E4>NXu=5}i1qZ|dKsR&Xnag!()`0)aW3bf
z3rm#+f{ZNyt*isQ&J!=z8UKSTG+3J7?D#7?xwWyNj`QK(f5I5kG=)wFzHZf4a<AJ6
zl$}JZAetHtckl7H0_Hw;awnTd-L-OXcH&Qs&iOp0P!;Y|F6Xf88L%kRXweuKk~q$p
z9QIa-t8@%EY{Mk+p6l~so@MAkk8@INU6CXdSp>upE8hLdBT9DpeyB#@c^N@SDW`+z
zWVWZmInL8Rv3t}gH&8zbazs!@8gHLrX$!S~M-y=gyDZyN#v;KyGuzEfGma&EGnxzN
zeUJrO^AiN9myZHG<ZHiIM@HWJ2vPhP8!09)$6CNzg1xZ$K<!BN{870OrmI^PDH<Xt
z6neJ4<IsZ+dAPjPoVZuF8KT>7{DWVfcDlNuQ(lK5TA5XvB`xyCz;x5VZsV4yw&?<k
zMp{$7@EqxulxMmP38=m|`kOVv1V*#BN9{VCCv7L?LIE@cerhzJ*;aQX8=WT;(@l7@
z*DMT+`OGUoScZ@1;o*hwwGOg#<s-$ZmA&QfF(a(F4!dQkdXA8$0m)1VX)|3PtRHWp
zxQ|xRMBFw+<^l*re1@4b^Ni^6Li{~{a7c8lJXq9L-!ThtswE!dk9Xs;QpGo(J)f8U
zE`zfA#hD4$W=XyzllQ9+=|E43@?VeupiqH!nS+=+aw_8U9Hk+6>2ih+MhdVQz4}+~
zoe9;{@>!~l%7<2W1fD^!y1$VR=O%!aaxnyiZ@WJYmpra9f6Xc~RIAH8vbedc@HTwd
zP6dt>N8GgJaGs$~s&#U6Kq9Y7ucdtO?<XG2Q%y4D+YSJtbT5FfT}9a$TwK{y-9w*n
zbXBbJ9g#^&d6!*;gAMm5!?#%9ZI4UFVdK1NzgGt^<ir7!KT?W`#Cz^{_qjSmf;*0@
zWkgzY6NIupV)BKq4RL+3h6}Ud9L9qUjUGf81qTmwC?q@FGQBr#N4&VilCEoBUP?LQ
z;v8A6TSt$z>=jrY(EWaengx3LRfXC=09A2|kXlSEa%H?GbJ+npGA>CDr_Yekc>vqu
zCcSk0h>nR<-?1ql2{w$4g1^yOw%?Sb!F`m(_&^Q}Wl}!vsu#Z_^^K(k&02;`viOMV
zP&=T9d=!l8pDD5U03;C(I~A%e4nw|qK4MCllBD`Ynk(H}AtJ4J{C-EdTwlq>^xaQR
z^a<zOnXR4Dl|szHH*7b?L>5FsKpb=(qAJ~!Imam>61=qr!qdhKjk`+wAo!+|;~+hW
zU^=3XS6>0BdUWG*T`HJ>JnvB2NVBAJ%Tn33%#N%wy>a#5&zMoZw~xuJehLA|1X|f5
zpww)2&c#1NQ@^WiIQD}kHNOkvu{Bkoz;R6<q=tVTsBc{;ldxz!AJKNd(wAPqlU{fZ
zeU&<v?lCd2RcDrN@io+%4tLVz%)#+^rlGubqO`pJmsUHxJ)EFi=m~=9fPk=EBFu55
za9WR?3Vd+kHEe`<Do#n$Uio|difjaTHxuU}hyvk_Uw&@^BxgwRVP!Zh!z4lU?Maqk
z0M^@oWC^Z~=3ucKeP9icf`|&U^WWHwQ<IYJ541ggasEK9kD;8?b-HoZfBGmB!nASJ
z1xr?YN$|ky2pD%;dqViFrP~nDVErASp%i6Mufy)P@W%eEz7tBU3>?O16Aan^<oHJa
zsH3YN%l}k){>^t(F36$;T-$Jnd1WD<7DPo&GQsm9{VWMMn;8;<(iT;}Y}YaPM`gF>
zffzBIdyxi)p>-Wk`muUWeSi;fAFZRn)+Pbjk60Pv*8s<ACXw|Qh0oU9O!*SCeCRr;
z`LYV8OTq_8`hK^?)Tcb4#|XXp?E@W?UtI~)!90OS-L8X2jVh2QdX>B0#uC{__lpVh
zr3FFm3zUD-$>mfe<nc)<S-+<*=hr3TGYC`w=g*tl*Dqn^R||KlhVo=t9TyOlk4r%q
zCM#05CkAKGRlHJD*u2G-Wp!xS?t1dKbToA>X2wLcJ(`$c^OMKzJBNU_tG3MgxA~*u
zh-XU@7g(u~@*;0T4Dov!5Co1Hs8Ale`hb5|{3w?Car=2|04`1S>|RITd-H`!73KRH
z^C0ZLz=~XT($dg69q>+P!_E{>x-(R6*D(k?a34bwqIRcpe?MBI19W3SR?!U$Cz$O$
z^<Q4hs$FAiJM}LW_S!WfTm_EqiE8Iv1+2;T>sKXPlJ0h&J1}M}CMA-?s<YSyzU9{L
zIdEnCfNL~G?V~lB{lLbAVjMS)+{G#rNe<w%d90#&+4!hZf%sI<USEAo$mJ`$SA9DA
z-owg?PnJD!KSMG!Q-D_whTv^#IP!3u-*88~*c#NIusj~x>BG1IuLE>CokALuWZ6mZ
zzLAGINIIb~M7FmjD+}K}+3d^3dPwk&=|vq@t+WiW4g(MYd#ONXlPyNauW)6|Ru+ZQ
zcvNBNI*xYj5&ua9Q!r~4AfZt(5mgXyhTlOMLm{u?O@K1QeiD^IWo_@^y(J{0SN3sS
z62dUfzBJ0e`|7;l{ph<-<_gqFBV2xnjZtr-R<}!{uS;7eQLh)^l1NU5%1_~HM0Y)h
z;w#RgHGja@`4rg}zxvpg(0bs&!0qS`$s>GB5{I$XZkGg>DqV7St^VkA5iXci=D0Ew
zwM%l|F!5FbLGcVA_+e)ho?<L4&e(1@V9gwOSS=$YtX<cfVsq5Dhn*$fcZ#a&A`bzR
z-$SE(;)T$aBexf=*lKio*4F9LF*NvE-8yp*?Uu*`JX-YRbe=n4L{_Sl_ZDuZ)Y_j3
z%p37)l6S_OTTj5ev)Pw?qHY|&>KGzHvigCY%OWX@J>@ax;zbGXI4w>j&AWbdxEBmf
zfqcRb36yXG=3A7A^$)f8?3!B>ZRkGe{t_7Z;Eu%p<2VtVdePk=@I9?p!Ds=1bEEi_
z#GL*Zh`W`gi+=YQ`Ed0RiAf^z0o(Xm{|#<`tmiV3#=V}r_x4yz3e)x7`jc><*867;
zFP0YQk4HMYV%UF<-eq-n5MSH4POu1)-%FB>vIFw=9|V@Vf<H0W{fBw*1Wi~@WHo)K
z&1YS`oMQ;A6=orWo_YT3Mt!DM{+<PO|8ney+~kh=^l)P5A{uRB7ZttVnKg_>(nD#&
zrxvdqEAZ4I?A!h1WR@wzcwq3527>5*J?Wv}bG;Zij9|SX+nICWu%ZVAgkAL?V3$ab
zCfE2l4hv{dfc2Gjg<ngfEc~cUeWKQd&Pd!E#b9JFzR2DgB%G-fH{pZd7cLPpuuf)C
zqGpr!8Yih;^5z(q53RgD9uwNIlgU(ya`KdVmiQ*g2a(&+<ve*TL)V$)g&0NcxBLTj
zUOYj19a~14u$kA<|1}GMnXxS$1-|U*i-U4=ZsN3iFDczB2J~*6E|wW<(K*g07351E
zYPnb+*RfdhD&t%Aw^rh=Cp4;#VzmZ=mlk$~Ge9c`5)Du1J)YbE<bRViOkQ<u>$|vF
z({su|PGtQ_h?faB(5l*DglBZULpzz(D&wbcs7B#EGBoOq$Xyqa1RCyM$B={s7$od`
z)@EI+4t`K>l?>7L^gEJ}`1|HxM!a@C3rp$`nXXY8v!u*?Oe8J^ubpC=O)>|9d_|7J
zZo$>_;nqPah0~2L;}#irbG=^H07io6Mu=imoH}Ok5?|dJ{e{-kFW`F&Jd4{7=BN_k
z<39*5fe1nq!V;rKe?I=Dy(?SVBps)}Wm+zLa~cpSXDf+kw)9l}vzs!Q(0lI`EqR__
zKv2HV!KB3#uLfx;o`8cKFzU5zTZomQ(wi)gGumODQGq^RSGzgo$9A8Kz9hW4rU^k1
zU)c{YjAkUgY&JCN_XF5{QH0zTbE&eetqoFFOMy2!j8q5WDl%pr1ge+0P`byvy|LzA
z^N=vOeW8Sh&lvUnh!KWx5ZJ^iEN3My95Y1U8{#^>7bttye`*Bk8w)(6l}Q&3Q3wn`
zN2W|pl7o7Rae8u8D^d$RCm*4Uc?5aJ4EO*&SXaZQy*AeIMWFa<A~G;}4%c&Eo;u!*
zZ>e3)q#>vBH(oYvOgw7i&(bKJI5kQ@3DNPb98`~A87CI_*7rLDCt@dW)y>=onOdk2
zz~y0IR3ByF<hu1dK7dze>)yFgJk@A81*}%2wD^wN&HGCvn7U62K55~vaGW1NUGHum
zo-prrLD`n&tt*rgn$N;#cT9s2$qG)U1)V%jy1M|N$1`Q$`vD>{EG;2exbJ#vdLKTv
zh_v998(ZY>dWBGsc$HTT{=fjPKOH*bL{0v=8aRB8^%%GNk&F%Ea&(TnXx%DTqHMvR
zuw01jlT1|D7@;3PYqj~ZmZSPK7-ft~V7$AwJG4e0sJA;-CfJpQgxtq?`;TkPrHBfZ
zg82i&+ez&lg@g-1JY({t-otV#oTkk)e~sbpFSDndk>TUtkT@}~`{7$@qk6EcO2h*m
z+i6db_XIm1<!9w%#}1?XvC_@hhiDlA7|L8HPp6CEKIpy1opxKC_vPIfu8%>h@&cya
z<IG1Ovd=jG;oV(tKmvha*6s+`>p1kh{dKNW#MO5U%N5+@#n#x!DsN_rL_Aw5t}Sk^
zISjGrxMFXD@?492nCBim>|&AT3;5mIb{L&^#XLc<9R;#$=01BAGrmV*gsfQrMFApv
zc{{C4rBj9pyYe*e9#VG{DB@1AL)!%tG;pp{Od+-}M_~x+GDSyiQ3xB=*+stz`es_~
z-kC*HLugw$r}L{j+JG+6$~|AW1o3iCU*CrDJw7gDubiX(E#RG3s0LH33>|ZW0F#6K
z>lUFX<rWWC-8MSgwnA2qN9h|dLbvEZ23SnxJ^FK6m2Ecmiramb15oh?K>+i=A3`!J
zY7g|<o_oCTVypaqgW0J<@D)V6OqhPvH_8CSXWQ89dhZ%ekJ&|NL4-eAol0My+y$?X
zAluQp1qwDE27#$pws*{(1&<XTl<tH3XBf?$a2S2pw0-aI!s14NyNzZl`2e{wMiM+G
zL46=Ry#(En@0rGUB_hOs6d#lL=+lOJUA|+}rpSc+X&o*!D=sLZN^>F#zk=$ATfz&s
zR%8L2FPJhbYbl=a6TRY3;>lcsWifa@Ec#VzCh~u{>YcZGLqOU{mZiZp?UPO-0Jc8k
z$20v><a>WM!bw1%g6-~!d+Ev|n4vcN3}*lMYABm;Za1I~!MpI`88%_#Pd~0$ERwh~
zm&|ie6bAOA`v80dYC#4oz_In+zV<6m0Keqw%%v4!xTSgnQIR569Hg9W8UWSUlzAQD
zGhFdKkS)wkbiKiYduX$EgjwT`SIkyl#DNX{Zxr#6dB_>8eg}75SIVa(nQyI?_{Nik
zpYj?uC%cW$uQ=4VE1ZCAA4ejS6jW38f-rhY-yZ`EI51ZfLoiyIe7_kLY!xfr(Z$#)
z-8r?nC?cWv++5tl*(vMg?HZF^Y2IRuMO+K}wyxu%07<kT?|7H}Y2{umNCpib{=v^g
zFu0tNp5~-)Z>DXWxak8KrdleAbtx!aCh!(yH^o=4?>}`1#4j)Kzdgy6H~B)@?(1V*
zDR3TN;!PIBgU`md=G9UBMnnH3GcOC{8YH2!AuKII?#tm|K?6GJ7@T;Acmbm<<FB=3
z07wt>i*mHeg(%#~T$aAw@t_CI&fmVF$;IwYRN3g6k@~Iang#wQh{Ft%U^9^EkPFVr
z^=NI?vbJ@cKlyGQ#AkY%QCr3lLZ}g3K~t)i`i=3$>lZ?Aj07o!9kgo)(Lc!U;qLNz
zmG=7|P)f*%uZMbgYI4l^uQczPdy>yog<;nJ-%xJ@lcfAJ0WEVEUL7loQ)j|frH!24
z&J`2vdr=%2jaLJLMzX}g`bNMWi=-Y$I7FG&^LDPbTI!K%;N8>!ac^;;LaXsxm+&VH
z9X^~^`W_<0$PaT7dy<{N(H`X2+For(u*%#1v^IoJj$GO607~!aK>aSH){NbOfQ8o%
z=*F9zMn-qEsT(Z@nYX5Z2c<ylQNZm<4C8E>rhT<J=PJ9he54N!1b0JH<hbCr5WK-{
zjPBKp4&Oi~qr@vJalO=x47FyuUMalUKHqY0=`sXeXFt0Pl9L^}mc-;42jSK`w}ddX
zw^6Un?Pg<8rMd1LjZ027vSfdHb{ef$+F$oJJdE5c;wY(WI}#gb)Rh~56^O<;h+m#n
zp>2qh`EH3NN5;w5oO9-^Wi{PZ<%G&oP)EV03YmF%dTSDX$&xX#Ki+%L-T1SKj@A0z
zJFtClTh09|QIZ}O38IsygJeuY)sxZ$>$vcCalp=SlZX-9D5$~Foz^}>v_#1^8}N4H
z{U8Ll)cg@T;SoM6Y24;uVS4sBu3@w+jokuB^LgJpR%`|GmMm%2Dmsi`?E6xi|CdEV
z@st5XYIdFZ{jueRy9@Wg#e#H!u$?eT(&S|Z_!O?aGa<*{GKn6ZAU^pR(9@VF(hS2o
z9c?_7cit`5v)>&ZPE^12z;BYD3HcdzVYTF-EI7AZ!>xDM6*bl6_suX}9^&ht=uPEo
zjpXHc@Gl!QWc0+fXxwmq@uH<*#i>s4fLOI*k+g<Jz5T`-Z`?yi34f(436F<iI<X;N
zVWXYslgL5g?;4eKyKC3At!YO-h_!ooa@NFmwcQjs3&nZqwh+7+w3rz9q+FZFj_RvX
z2*O3p)Q3sn2j(zF<j>p|!U-b&@6X~`1u>HwD4shg;P=I}xsOw4CR452Ba1&F*z51d
ziVbv-j#)TUR+yx;`<_?ndK0zOA#mTyk$q+q%j{cJcg)r<u4y_h+8QBz$?zenU&CER
zHxj(0WI~Lqp83xC_l=GKrb+c|aUZ{`ak{HAk;WN#h3t_GOQ#|bn_raX(ei=D{jS6B
ztH`{-Eb?Zn4ZECZ`q`{0xCA$G>vG0vviDw+$@(tmP8WBzTOKzja4^pOnBVP5WzRca
zX8GHDB(u$Y6K<nWpW2($YoYW1Rj0D@JXBSFVvOYm9)~1@dw8}<Jp;IB20Tyf=r4DX
zl<YD}Pmt3`#Khok2AfvttJHCl+6yAK+7_b{w<Am%P~7fUxY?vc#Gyr?<ZqMLY$n*o
z8lChj{0SanPxQ5CDMR!-?21>aF359{g~(KZPI+tdnm5Af{;3C*SW|V+!#xA2->TsX
zpHm=7+2RB0LXx@ZcWg`|oQd}LX|2*gHomIz>3}GHVs2x<+e|%0!WD_#*HX!tg_~@t
z>1&2fvkd6(0=+lkU-wpuBUsb08C7`9Cf{}<*+$8zp|Yn}?Bpxn@0a?{@Ae<G6ax6J
zg~E>*KO|`k;LyHHU4{lxee1ZTxAwRrwvPH8(0g<&S7OQnBp!P{2Hc@+a=6mjdE{JD
zHonE7m^xW*w&f%>EAdyKDjfH?Vy|t9z|NVl4&v_&!T{*YZV-<ud35{^y7;(q^Ndl|
zzQb8Gx~*dDJ8mex#_<IH-=byC9SsGaAL?7>+z^j8U)d<nM3QBlMMhUF{A-1sdp+?i
zcDHDB#4!d;oU)WMLwP~eu6mW$g5?Z>gj)|6dR<11SL}slzSla66_akk(6D%TSj~2-
z3**A`n0?+_(^C}0I9*Et9tGVU>*}wYwru0wsuuhOm&rDqZ=5YrvIj1q-D@GCA?BBr
z8H?E@34gsU9}N{2N$+th*+xlo@y>?;WLK=Imdb)nY4i0Pq^3Y#zg`(odbZN_(<vaK
zb%G}r6Z#p^2P4;>bDvBZ4b7}UM++vL>vT;3KSgJ~mwXb(ycoinz)%}Sbyk;LZ+j@S
zFjEi#Fw0tK@MBQJoyf&6U#d*B*;o-JoY%e5d@LAvr7=op*zrDxgHu_v3#<|=c=E(M
znd96LW7o;w(U2evOHg*2h6a_&i|@|^8={BOE?Kb?m(cNxC_yF4%x8|%9(fE6BvIn)
zk2C|#-<59zt@?^w(p)AkCy8sEL#03Ie?wJGl{G8Owf#W`@xwGOO}^kQ`)SxI61E0D
zxb<`&y-Ex9Fn=NR(<MY`{y~@qD;d-HcmK3fN3t&#c-vpGy=iG0`4Mq}r&*j$Y+p{i
z*Sp1$t@BG}WR%e5d-|p0ydNxzD*OS$i&-eS_LFc`9r5(1B&1aoNyrHM7*S}Irkv%H
zz8Zr1HX1|cvU1XRB+}aP;{J%nt^JmvK^_@j@q&-@Rx^PHff8~!IdH;b=5qYej2id_
z{*8_T>CYvs@xJR5I1MAO>mxX#?16IQ`jkI|%ck@`JyW&~N$r6fzA3|5JGTQwSYzD-
zd_r7Rz#HB!Sv+&Oe|g9p<apO;WnkC`KZWb^Fs#pGA5;)~vhoMG#v}RPqY+3leP>d7
zw7=FZfg{7sUisHNymAXJ<`3K5al=SrXH$waApu+S4xroTu`N90;^}KajW0l0tog4+
z6|@ud;DOimc(BL2pkO)9e)N7d3-N_fyV^8tLZM7)BX=lkcK>A`DMwE`FI{;{me&Tt
zl%kSEf1#9ZhLoM5n@Wc%Ku8a2bzFf2XSiARD#6k=A>6?avvHL1TmA%c3snNK(cMl{
z))K@$3r-r3H@qst+&y9Y>uq8eQKPzybR~V%wJ$LE$&IV*%Rg8|lV(knCXN*a&~U8b
znJ0l^oh3dwEYB{8V&gfEqk~h)Ugz835|*E+1SW{TNAz_SZI(1kB9?0lU*W)6gC@fa
z3{Cfu6y@mysWxK!Ik7fD?`xT)<O*G<n`ohk=)Tk$d5D^1Z5h(h(W3h~V`}n3=W$?r
z3>Cfqscj$?HAoUtUne&4hUCrOM*_A)ZYk>=Rl5&_pZr+wgK=O4CfMuoN^*5HLfl}M
zJ1`>%+w9Lf<Oj)CQY5Zkjvmj+>%4ndXB5dxC>t6HroK)u+pGCp8V@GQRt-Qll3qBV
zAsO!HydOg<kPFDg@p}hDdBqtPD>;B7^<9hPw)w@(d-oVliCD0lT2PD`7724U04s3+
zC%?mR!yliB6xA{t>w=btth?PP);V`q(pc8tW`Eu3f8wn$Ok|@v?6_Dj?r+P=1P#f~
zm(oyV!plh(MfVb=Th=DM4Uea$ax`{o-lbe9Bjc5Jw)yd;#mIEfYj$ftY%RVs*5Ple
z=6~o13N%+gAlohSyON~>y)RVeW*0ehbeNGVoZY`av-Pnam~j_)VgMng2X$R$Oxgia
zzKa5pPgW-`dx$hv<a4s32~dMb-Q=6J@yoyc@HJ@1(v*xXjtuxCcg4-Lu&f;Fh!mzo
zbcJa+rcMv<9zD$l&Q!eL=dmTWojf5#hWKr8MVY^p)<bIF$p_-`)AcjJDmPzHv~t`2
zW;;Rp7N1Ke-FstkzD9yVmbINTr?vR*E9oM=|J<Aj<;N33w%Sb>7b=a@V)e1+7w?`q
zveYg7{=@BVDnbuJ8~W&RVt1kZauO*?Geq?6RucWUE)GdmF~s~~)Jc?BE1(C<c@jy9
z1q9I^ytihT!Gg+qYF?)POFrg}c_9y}%<CyphaeW;B-OqbFI@-#f)rEUo_*#Hn0Yx}
zw+Y-W8t@+4iSOKAaz&2X(yS{7JE7|sM-!AwyH5Q=KH~pf^WQ@*izyk1?WLg@ilr)_
z?ce%_irGjv!@kFvq^~Jk43aD~J{xE*vp0V>&0m#8zy=S-snbMib`B}VPyclp0sQDd
zY|Im(FN&dRou*!NpEpQ7Gq`OEok@m;yMn=-9i1neVZri{MKXaYJ>+KBxk&cq{$nNW
zJCX+R1Z;9yMkw^G%83<65`Sf6k5x$XLLA3LeniF^|FsK#<G!NEhVA^)+jvi>(38D*
zYgJmyPe7Z(E51HTZCGrrJXVs2g7i!YL3zxj_ulls)(OHlSAu{|Im3$ai)Ha|n|1^Q
z$lv`81Qw_p;x+eVXwS&-J+C^mPnBhV)0EG#DiBZie-%pqx{5pg$Ic+Q9v%~QJss$z
zr|QIA9yWH1itMIcEE7`1Ag%Ggf1Zo)_XdW7IekW0Azr5q^Y<Ch%nM&NeQYfQ%jI+n
zB{=;pQ^YR<RUrLIOR7MaQEiCEU(H_&K;X^46m&pjAFxj)3x*X(FHS^eq&5YFq100+
zNu(|W$U~Bu8mS?PUPRBR>!l!xwhKmjj_2H8_sezJtVt>m<mGIlR`@xACFr7-8vnhI
ze+`fnjK&c0+Dh0S$!wpsp!EemWtB@zUFevU&wjlLw!GOBFm#y$nk&G7HZ6Zj=c_1m
zoz>(2|BVR~bC_JD!_(kY70HwLxFKR{KKslna{6|vQVWKnrx-}uZ2v*4^skwkf~{}l
zy)YR=fep6Y6-}2aTOEfBkcG&74DVB`8n>S3gRHSG=~Ae4D1`7-8yrtWidug4Klk;o
z?f$|X&Oi#Mk}#n$pKcW(V0^#QMuoR^xApmWOL>m@i#WtU^$}$3;f&1pI0CJ10BpQu
zM?UQb^Hp6=r4>Td9A6K#-a8$UzkkFkgvZMS{PRpA?afaQ4=HurAe)?go-{HR3+88E
zV{dj&L!wyD7of35g;t9F&(z88qEExKcI%cV*pU`sb4Io47uwJWt09Sv{lI-{ZJ7Jg
zA#d_+y-iU>nQl)inJsc?QCru+Vs+gT-ldhO0n2?X$9bj1aOrxK)rs0)6#Z|@`TK;G
znB;sG-`#G-WRklIl*2LAfSp0AQb3KV(D|wF3q?!1B%TOqNc20EWRO{vkgIl)<+HMI
zyTh-Yb*Y$8oul79i@)6@c791%>`Rmk2WWyU>dSOi4D*_{@kmA7s#D;zGARSMM``c>
z(`x>&1NI-oc!d_3`flm>O}oU%8gqaOBsuz}T_+I}slpi#aA)Rd_Up3G=;0O|x8m?Y
zDVGo@N%sn)#%}IijfWY$kiuESH-^xnfskN46%LU}Luy#^|I(-ad4t(cnB+2Wo0c$4
zs90Q~G*GQf1Cq>gV;4s=!(9QETWQ5-W03UzNSD_%rkq#&x|S^*v|ywo51E<V4a|Z(
z+MMTd15Ke6L%1sr6<@s8N4_pR(`Js#a7?#w#86BYm>%Xob$x&DE0s%z+2a1sgY?Qz
zD6-wyY?!M;&$aT4tPVCkmRhHJ3wNZ+05lo9quOxW*<rkzev1s4ba@ecG~c>Z+6t4d
z$qa@5DO<{Not>l#b~~9pT_4d4Cr)i-%=%TL({<M}1w%Td|5liD5a97y&9rV+Y_q<*
zRZ3sPhjrE|_y<c*6=*CfA7%@6YeK+9BY{@u<rG_M2}2`{iOZ<lnS(RjRwMH|Hr!;1
zZ11TIwC80E4zBIK?zP^geCZ=MWf;kv_WtSqZ!tI%3Tj~c%0a`JpvRHmdxy^MP%0$K
zbb@Kbr6PVQl|eG*m(V-RW(mu!n_W^x%5{vF-Qi_N#qOR<)s_igTy8TQMW6v+w|TU8
zCk}&H@hN!ia#E^~K{cbWkhvyPUx9yG<6qkh@NM6>_yBudJIL*|c#XUn4Tw2K99&8!
z6=+3L=DXBv8t1ml3QeK#qLI;omU5CMF4`g$`GzWNQ`-)kk8i-Dz1_Q$!&7dzX}jUX
zDFY5)w<*+1{$=z?SN;xVJxsmjc9nLRc2~F@%eYrMun5WW|D~zet|q?4Ml9^50~42T
zxEZClwZTyN&mrdr>9qD@D<8B4E5G%ewuYwNdbkp6lGepl=7Y}%Lx!d2^&r+u0yV~y
zUz-}NO6KYu%mhQZz-SG9V~m7w3mCu7dZ8jGq1l0H!5C^}AuGtBcj9f*-yr9oc5Cp9
zs`9a0Zp$k?iYsJd{Des{`kOAd7KT-HKt&tzyJsE;L&6<@-jLL6W0BMpSc0mVixQ!6
z?eCy`eCr~K7v5@yz6`QddJ8iZygHf{*$Bht5il<Wt;ic}O0ba41f4=X!)U4;+;W7+
zxHp0#;^PkYKg|lcGj?d1kWq4n2P6sY!O`H^b3z&&&6hJBZ#Gu<*<*fG>DH%f7Q>uZ
zFiGM7B1{B>O$Kr<PoH7;eTewaDs)^9xkU8Oqi^8!E?3q%*}riT{s-nElR8)G6NHrG
z<IHfQ<71)+4+|mH-&?#ygP~~mi|hnqQ^<@$jb_kLiRK)uJ)Lk4x`?N6tye6UJ-1o6
zB1gz#r2o>F{%tou)X=_0WEm{`^v7(47EO+5App<gfUQ0XdjhneQ_Ex}wzI-R<cX*I
zO4FT@clZ;R7#Q?5{%@SUAGp*gJ*s1owt}l!#sTnHwW)cp%d;L?_isP;7p?K5+8Z6N
zc-iNDvQw1$I-vcp-m_a7G8qxjgGvMFEG$~1{pd9vB9Y?joww0B98ctslWNlgwR+@j
zlO)cV>(|PQxfdEzu#X@Ei%NyWe|!D^2+{uDU_7K9MDykN=Ok8C&U6`8A~U_o_Y^!a
z!tQQHKWi;QHjqMwXd}?%ovBy)VC&5N5<}0S$@O^g=2jf;q7~1im+s#R_5ZM^3#upn
zm$7c)!(VDU>ymt~G{g%~hSWNzk;FL}i`ygJEid?@jdz_*oee9wkdKag{{I7+znh#(
z?pGyQubf_=<Tm6NlH#>1d);2*P6vu-+Cb^I6D}+Y80GZvRG<#l(66#bbq*YIm((HL
zfAC8c({8mcaU06uT__8p4jC${`1f`H`kpg9KJ&9z=c5>u%A-rEmc95lMxAj4bjy@l
z)u<^34iUeEVlheBcs?>GX2gbl{u6oI$d*e~j?3OSR9bM`G)r<*`)?ya{?*<uZU7KS
z!0T%laqne$?}lW=jH%KyDAt$1DOJFF9gW2U4V_2o_+cpYVuSc^`6_XtW0k{~JwO1L
zzIJP%EY#Un!khJfFZCT>vKZX51-yd3mEr*Bo$QS`C)t#Z1??7xe(uRc2^+k=W}%DD
zy$E8i%`l!%6qZ1eub=e=GWRR5U(&hG-C}fZuJ`Zy0NlqsO?yx;(#x&gRY-it|2-T7
znczG@>m@i$;q?CP*3o)CGUq7UYeJ(Fd(FpB{i%~WG)%?+rLCCb-fWVt1ltUn8V?t;
zpGr>}j~66B{kd}>EUaY^YoQLef}4b`d33SGEpARa#M1nK+Zimp-PK6!oKcyFy}-;`
z$UAG!@$Q2)E!|94cZij_zar~6ILFh;6_cbSn)74#Yiv$sYkfE-Ong)^_BV+3qqC=z
zNFf_}Exv4$iVVs|NWCpL;P)|(!(>6k*RDSl{{8A$b!z|1xTzza^pC|?tq*ff7NkH~
z1-pmSxO!$k)W1#aHVNC0r{r{tbq0aW`>N~Yj1z69jZOZv60p%-Nn%74Z#Y%ed!JFs
zI4Ex)=gJzSAlC?*YssoXYNqYa)#r^M?tRWR*3j~Pk&9ok{|g&l5TUiZG2oA<zBlye
zx4QD)0?kYJlVP#~a!3Zk(^>R^9-FT`_xII1q%+iLEzK}Bzu|^fwN?Zw#Ab}CQ%O7N
zh9WZ$?~cyuNlEu{gOZPp<aw9^GEExe_aKtV7F`kTnu*ets;+~de_SRW1G31A{!3&1
z|ICPE7Sp$K)z#%2AYI5X$8GE2eq_>Yl>1W;Y6NEiqL?TyFIllFE21NuH4L{zRr5z!
zSls)bht83d63y3>NI}jW|Ag8Mx<VUf5_!O=vVR<Ek+{csdB#>#2sCX7TEPiLDhD<2
z@KJA!*so6@S|N8#Y*}%a>i_aAe{n&ZmMRSMcS<YAYkvv>ys{L>soT>Fs`d4PQI5jn
z_X>EdTjJ`D3Goii+O17?c7SsILTuV!o?5KweC!_G)|BBdemF^lfDM26_h732GM?`;
zVG3;erOm=Tt5##zV4~IJ6z&FIAa)0z@znTR;#E4;UgDML@0-)VKznHlw3b>FwJ$;C
zGtuYysQ*8J$`Aj$sJ!IF5V;D5&Vked$_@V)D)mW=I?HDnY<wXal?9Vw0k=xY->$N_
z2FPV`IWylI#+tIFCs}P=N{(><qWB)SX(i?Rws4i~_H)sMB#p~b8}TQp5aG~}gL&(E
zn?=&I=N7|zL_i(;;IL1-(%g2-UTjo_5+cazp%V&`G_98x8kQdMjb&3mdo<5gP2HuT
zQvW{Jt4}GjwB;q~VNuP}g(f~PW`~@I%jrjzYf}fAuLYQE*9Gg@E%Nko7|4HZI4Zf5
z1v0_2toBO&Wr3ojnEgaau1a)yiG=W<BOWr2zHcl_zhR^lDI^Gm1poy7eG(efDl>&3
zBgUIniiZch1@<S094{8$3$V?nhd3Dk0zag91Tu(xH8)L%*WjBdMZA9GDtI1ohQrz!
zg#TQcs$2e$D@KniFJT&l(TPWhU%!y5H~VInv-G=NK7zyKyNR*q>$-G9me4JQWo!97
z;5DC|BP#lYR8M`&1Xe4vpo4&6`DOwSkTH4cp!lD$h$ud0ob3m{ijg(iz|>NtZd{!}
zU2I!zdqH{Mn$9()^I*V-N05PjrqJHRXSYKj@SWkn++2ksq`&K4Gon*Nyu4Z?%(Jy$
zqPr5c$e&4u;qnjjwO!^cV7^I37lX3ONdlk=8MCvY(VsyNr(?08grR@h33%~s{Y@&B
zrZbH3@W9M!zblo?mg@6C%nVQGR;7eu@9J;<XVUDq`*x`Wr_UdhpC7vWjCH$i8G}p&
ziD&Yi=JhR)OC!Eb%e+FZGeX3e0*cGDs&lsoF=!s0B#t1V!q(sB%|400*7<In#f7`C
znoFfOs4;iadHRx#<4b8tRX#)^P4Ux&0)W|N?|2!Ml3ka+pIczn$!=y$(KOoPGr<<p
z-&%Qo%V4#e7RQgn!(3yVQv=0HJ3tj?+SN***^V%p3)b#syqDu;M_$CCe34I0B&(Dl
zu*EKY+DXUdD8xZ5tkd1n>^@!7qk`vYV?pCWSYnl60av7#z57n_e%;qZg+`M|HN9Pl
z>bqt+yCk018WRdxvISMMu-f-FX!ZQgb22uH+!SXy8@(|#RpqZxg`&92bmk1$iT<EB
z$Ipq3&+P{)c?+)wbV5_RXMZOMeQyw(#_j{NS{Jc+<-HJ@V;it&r7O4laZ*;kRIqKe
zl`fa{1#o3uxaIjvb>bntehKQFqaZA%FZUTegG{XPkY!ofKZ&`P-2_{rQVvxPChRHX
zTcXo?%kkn@w^NhqiI!2CLp;wce#YKJ{dwH|nEq3*U^r44Rk;{4(|WcIwQ`${NqQ{y
zr9zfUoBq%{B3@7jG(I;1Zew!G9f^qiG6)!~<5L;qgLBymCk?66=u(?aCn+52y9w%v
z`A<s)dzSw2BM-{!&07kyB`8+<XMiKkg_1Alc9fIm8Ne!Q@Fd6dQ{uuOg1I8<g?oA(
zzZ@_C)NI#Gyf3a4dt2cw^rw(USY1>-Y(F$CrjD`I&;+KtD!6DdRd8Up&{LPYkL)Go
zdO&uzc)!@k9jD`PBEccH6s>uP%}WAp6EA}5T?>Ad$?)74v;95#i5t5db~Cv{!&3FO
z11h5o74oR3SWrw{xhBttLH=$&=33aUyei4-!PE4ReWo7?+W!u-9fL$|sxuj$3yZ~?
zNFuOtD{urDZ+Niu7>-42@!rH??`!fq{J1cna2ZUCn3b9T!e&eFct2!y!C8+AeeMOW
z@DxfA`jtDPk`DBU2qM)uzXX#x^^?>V+3eu6{ZJo12x6MTlKc5}iCqFxyhyGaRdhD%
zd9c}z-5TFuSsA&{;aF(c_H!GQu*7X$_)g};MO*IoZ+-gfdQqw!h{zFBd71v+Vl-pq
zp9ag_Gn?XnjRTUTjaF`2Xq<KbF&53Ft=jY%F#ozp4S9lfIP*`0k+|TVsHYYshEDT}
zh2=(IPTqX|M7(E<LFRaWs^hEIHT^cDjOJX4NqStacpA65nMpKHVZ^ycCU=`Vxzc6W
ztBd-4j+)M(ryC5*rn=vl@e`t<H$%TX6@wjBKZasE&&)NshdHjLe*0{y=w)eaf`NbR
z>EEI7pBPKYqZ>%^bUr)qn^<3L9T9~;wJdp2-M`Ve8FPbSbNp4CegCagrfO2hid?pm
z4YJsg_q;^g$)}_U#UwqCLM_U#R;Ip`QSZ)`FRG*nLu1Nww(E7EPJ+Vh_|pUs+Xahp
zS=ME_UcXjDVQP~Kt4e-l;j1f0bLn7k0>j1#!XRM-YyAarVnFZTh4t~h+;0q~)%pFW
z?=#OnVJXXv_KS&qj@e>9-OE876T%z-s`&3rG<Gw4v1!TQ2DqpESd`glQ9l*vkJr(6
zW7Op_{*^<K_Fzsi?%|UrGzMu#JOM}Y{i&m&;LhPef0h%(f_|oo9yB}4zEg6yETW~g
z_68NkQW|cxzuKo$GdF&w0Aahrp0m^4g``L3iodX$RkpUMwWM@9@%!vBwA*hXib?V;
zIxTqHv4dBu>{V(V=ntKKOb}wYH&C5r|5FPZ)Bv~1@-9Bw33N+d-}ciqY=2eL;+GK_
zlpC-SNFa6n0e#`OjO6cPyzMt2abYX0U@E(-kGymKn$f@8Nc@%P|8;h`QMh1#l!ntd
zEY6~=vx(>iLEJPHMa{I@vLx@&2Xy_cH3!qPF4&hEf)sfY)913R%+4v7sm*X(qx;qQ
z&{ZR=&m0nb66_A}*ILp5R%6#NbRzVt5HPHxZ@}b(#k{hE0I9#8tk^4OUT3rCIAS@V
z9O`?m5$;&`6uQJl<Vd|Y-y*)*FgdGyrQdR>#MgjlP0>~Fi(SR_Qc+#T0`=0zwog#{
zrUgsIAypFfHc)o5Qu%+b|JBndQ5%Behy=V_t~w^);i?dY3D$9Oo)neA{%;EjYVOql
zDA=SKY9|Qow*Ou~XmrR!;_gD<O?TQsbtaI{fu$qMbU4<VGU;6cDV8_3#z0p7ScPnv
zzae=&<c(M!WAtj~Gi&K`txYBIfxwHt_@Xnr1S(Ot<`KOXNaot9N5)RPQ?_j+7BMWd
zkqyS!%Y066X&IdCJfO*zH5}LAF#10*=Yq`7wVJYFOjGF-v!(l)lAH$Ha&MRcwKSc?
zUJM4RVFn#-X*i;~^-pX~ja2#DD!_tg>mc4jMuJmOg{?$r`QY0-CkU}yzoZ6pMRZH&
zC5Do;=H{D9A~r`#b6;|Ky<^XHOgY5~&!V;{x{jf7(zCqhfBuNrHq`I++*GwSGgJ@;
znCc3Ah2m)76GZTL^RM8EB^KlF{uY?o>euXl875C2%aal1qm&Nx(%TRC{Le_lV2b8r
zS{pR_m&X+ME4p~`AJuhA)p+!=XjRH={v%HGSYa25-g*pvUcZ$c4;^O)a0`$6UV{w&
zM8-(Dk7MS<iGPR`!=a0Dw&@YrPq|KT0w18lkO^mG$?~$vRtDFS><)J!t^hUqcrU}q
z+o(xt9?Smvi(k96E0l61?qveMF4rqEb^VPOS_zu**xr5M+`uMaG4FY^J<7B4mY=)(
zc2-t2XHkaBK1X_<+Q`1DNIx}Xfqc~ZOW``qn~!&)F+!_oXyC-qr@ltHK3f7NtP6}(
zItQnDDL9pQLsb4GArxBT#{qo>UNxCkSEg;XxHAskHbVjthAW?=l56#^42AkSldQ=@
z-UMBeuh$;7*n4jn@JE=CLCX#VDX+OB!fxXp(wpP>{sd_Kp?6Xny-{@lfD|Zh?J~KL
zW9Zp69at9dx&&U23S0rFEq?!qyTQZN*&B7AVj}Nq9g|C0_%)a0RQ;0Tc~ppXHS6Y7
z(rtX5k}P|A_yYM5f-Cs)fc+Nv>4uQ|FYF8b165;%Ua~8Tu3AZm1bey1^cNH){KQ2e
zx{*2vyKkSCl-myCu7I~&oc#~{Y*3Ny*oOmXScI1w%R6M)qIBi>J3Xy0xt?FM{Od}3
z#CeCtS)6eQZeJzK`fRUPzVNrvo=WyU9%wrAKK&2z(#Bpi?62Dy;Z*{LcsUW_3+c>`
z%wfc(6C#Wse9Q*stu3n|kC4p|8?rjh(%GZKTJIiqlgCvzi4i|umE#w^9ZhFT8g&`l
zPwbSNEJ)=<?+l9E?5lc{TW0TG7|v=>#56)8xF2%^nH}wmTQ!aKC%@3pY^luHpNB|p
z(`Vs*a{D-4Um^AJI^<OXeYyBDmEB_%L!@z5QzBOxN{v|Y=YQn52Jy5Xlgmh^h*@UO
zoC`<he*eL4B<K7hX4biMc}S#uGSbaEf$dDZYb|{gz;Yx4RWX&=H0mxn!FFckXYW@}
z|A<y~=`>gcuE#s(x=Wqhc6{-56bM39Mz)fS?AawfMzRm{#tJybF^w`mW=Ex~jHx@9
zVDejD?PXL_Ca5Cll0NAMoKUIO(lpBJ?&c+h;#*SNn@{VT2LrJLWb<cdOBVOIThqV%
ztF-aL8m&6+m?tDX+^NX`OD%nBzomUc3Q@-Z;91-T``fC$Wu~pMjiajZXgRSH*e6}H
zcb-v~+iUb>ICGRb`OV}aSUi{%@UH5B`ql)Vj#FQnnc$@h6So~u{9w`9m6SfRYZPvc
zm4Ii>22HF`C&`O#oyaXOOzs!?7?WC|j`qR5<YtySI*J36^Q@tqC*<$)i@zPbw%jK4
zkY*jnGm`x%SH#-dl-jJG$LYpC{qMT;lc$+JN#oIu`E_lh+vrLB7W0|=P43?N>l7KQ
zY12PVKg6Ohgk7u|Wn}6t`OK)nFZH~ABmPfU*B#f?(zF$^p@521L3)!WAiYUZItWM&
zMF>a@5JImay(3j2h)Po+ASI!LA`p6q5PA!t_s~N5;`_e$yVsk)@;k|y-JP>L^XxNo
zW@V-M=h&3W+urZGvM@R*Z7AHf0?PHK4X7gtslAd^A6MjsZfR#&zGP;}iOF$N{~Brs
zRGd)#ydn7xw4#G5I1lz5_J^^I2_|Ncr@Smqe@s$VKGE4E?zf$k8<+JqRb(<~N_Xf+
z*d4_$u_=4EYME>l^nYic{Y3=);8On4(}<ymUhY^K<5+7KaIogUi+(5lqT|6-eb3RM
zMZuHXM!fT5E{q?5<r2eJo75XzLjYejoAfc$hj6hLs_*$INfEzP^Lf@R5c%%qtq8d8
zm*%wQkMUt%0FtiITW2DgNQfw5Zga0h!X}mbuSGeP&mk951{ZDa)vqt#<5ye`)#wN*
z?VpIOZjhplj8)$=ocrP>_U1|ced>K&WNjPf`R(*#@(2H7KWXj|J0u?}y?fG1v&(jw
ztcIqDB3!r9HEJ(WzD=d6QhUo5*qkWQHZl(v`YzLptw1Xg!kpIz2%0<5oT&b4M2#iS
z(L8(09?#kEf@xyYtj?Fy6u2T`dUvC}dsO(5R3~(LWi>6dR7vT2$DsHJ`L=5TbUK)?
z^tl#^HQ6t67M4%WjMmwgklfeUAayt1)#-{e&e`Lwx2mbk-!U(TurchK%ni);zq)tx
z<sXZ3pP6ZCW~Y^!v=`>&nU>U`lT8EJX92%E{YmDeQO?G3wkBjh8FW5gA!`jk=`=c&
z_YSCZ;}YV)t_jV;AKg!E`*Cj#>Y`<6^9}E3D>f~AkKf%`vrf2TD>fS0uG7dM)T)D^
zEOIF8<+UiP%uV_%UxGK$#4y29J2{Fw4DJr`uTYeHqa)WR@L17+o%a$#o2~X&gMfs0
z%_SOwL&vD9av8f|GGls<e*lZ%dqja+=5F78u_K*T)`z|VO!iro+jm&R);g#R#qRQX
zw|jFA72*3hJ5OAlY>M&K>$)x?3d~BGe9ph59%h43&~aoNNB3f-Z|9nB9qKpjoe=p{
zNLV|=llL^K;;I=-SU#zC#@naj>edC}PS??@pZQKzX!i#wNdhnn3|)aVm0m@cTtU8s
zXs?0!JBfjjhC23FvVu3kqt)zZFaIRQm+uFABN(eXYcfvjdu~AsgjwE&dp)b{7hzAT
zSuGzLLlM;a?Ou($-53k-(+%*kBdI5Kc04JqgX~Xu(yG2_+atwBc~(;zbNkNe;slrk
z%U!?rKqz~;o+2V-J-44KF!%O}X!}bHy<aE&W)F#kjnry4ovs`gM6y7@Xw@FHxu16@
ztJY&At>*aGO$KXYRv)eF0dgeRB~xjt$_WPLj1Wlbs^=NT$Xgm(F-5;Fu=d0Nk=HHQ
z|M~GlUVsfQDJJAwZhD!7aU1wz`xng%T|X^>Gx6(qG#j6}HKP!9MBV{MKySK-DRw@O
zkF!9s_b2MZxN%>gCOp=ri6g7BtXpKBIVTs`z5<b?mf0?~pP5`L%jrQ8LNd~|l|3is
zj*F>b$jfGW*-i^4OYN;{O$3igawrf0&6EBJ6+kXJ9Ha-7-@cfn5x?fi-6e{h^&T@x
z)#Z;@-_SfUy`b;&;5Q#v6GDCtCnvG66%*uFWKdtW3GB@pU5^m_9_R7Z$0<?ATB`tD
zDrB(gmntEEvTt;ko(#9x%rHt{T7mQ7`7lWnD^}T$(FwTATLvd7)<5MK^cu|UzZOm?
zB=mBa^Vrf-SkD>eeb1O>Iw{1vl{QZmu8!g2KhWI3-QC5dy4Kt(w0nMnQfiCs40|$W
zsu5YKYe%(E0bbX9{(+_4K4m+`O7{`_=^}j0y{C~zcRBldd+k>}$L`}aH{t;1LS5=&
z%g40eGT&>^=@VW={X2%~a7TsnY{R@d&hZAB9^SVt{QG;xm!GHZ@)7H4>)V!Va~qoX
zrdvD!LUoqDm%q62PI&ime->XEIjOMz3nfkcNZ2sCUMQ+t{41gAp<~8ZtdkZsz=_8I
z9iyfH+go~GdAGrY3TTKU7BH0QM5I_AfOsl7%ynXW`UC`{a6V|$k*pQqR`m#r<zT7k
zpJ6IrrB9C+5=OwcWJX0S>G?pZA#B&_vtl$oN;FGTnO(eSLwZyX;JVi`wQWi@R^L5q
zI}#;+_>|2!<a@Q~eXuzy+9Pc2(bYm|(2KT6GD496mGX+CFSU#2D+|^HgV7J<i-6pW
zmoMKmW1wX`9MZ`34@#YVR0@j|>)mKG8e+#kQbf#J#6)Q#^rImqWg^ZtNu>GF*IDIO
zB&J@)f6Ho=WB?{NRbs4TmFHQJoM(BBfDe1jAMq)Y-?rf7z1d6hLF|Cl7}12%DVhVU
zDQsRhs0AK9H#s#t$$0p4;|cYIUO?4GWwvSH(c=Ep!H1XyaC@Lzt?By5VGqeRjv)K4
zj%uwaZQm&&4!Fnol4<0EY@XJtR1e?TyW~A}8SBkb>#cM-to;aiLd2O)RrI^Ytj_;R
zCMQT10PTm>n-<h~^IjPcJ4{_;EdXA~n4&&^b@Yz3iP^L3a?W~dn^>KGiWEMe2>l|Y
zQkU|MkW^G;_&kV&S!=O0Jhepa>P%(CBPRE|-1Fkp08~w)7H-aJeuw<hT=NV~P@(;I
zg~g(tuVX2YDp6_*WsZ8qqhogkYO4^X*A7ac0yT3`#+X2KOv#ue7E&wyxo?ce+2*9U
zS?B7ES~SlbZ45L2XaUUgY_PgItLtrovlgTBC}5X$#@S!bVvxgTzdJw#Hzbg48f3re
z?(gAl;+Wx<dj>}2(;Re+<W(m%>XXr4H>L_qFzN%XBq!TwA=DYLzz3@aH8%CJj>^5Q
zyEN4n&JfvA$OCwH@`-wrX>p|&EB0h5aM8#JrO7Cip9yt~6{5DbPZpXOYqCGJr$@Sy
zN~!6Qjp;R+*6EWi+CQ@I9i~30On~yob-~ra>;XmeLS$|x-jjm@IMoRWi*JsroIR}|
z+P+!?c<ehNq$<Jk9o6QQbXc5VtnwNjd_W>=0PwmM#WvT#<!WvFzK(m@!~7s9V5w&%
zk(D}q$=MmQ^tyCg^WEN_ME#}G{u{cH&f1)jN|cFhm<cUMi?EP8MFTgR9zU_A=vCN9
zQLZhH7(}%*<AU=`Am{8d#m1S2qY$zibIsSMg4h~fm^tZF4m0z6QlE$mv742Nuz^or
zk={Fg!RjETzniht*&4N0GP&mi1k$Cpx%ROKgnG5r&?9?sYvgIYxxN;<3vy8@PYNOk
zB&eqZm3@S4+yWxjp1tc_z42_98{<L<2=}7iBkDSS3f7qJW<WgSH63X=LC`CbKBT<r
zGg>wuq<Z>ltmW1PJl0W;W}Rk(IZYe@XX$lvKq)G*D|Ki`{M8zw&vZH|9^a1k;r*J&
zu<;~*;yWCWC>-Z#$cb-nRq-novXDv;0aaznQ5z0=3{ks*q4X4oml-D18-+^DYErTn
zYP2iShO1+xsM?geT<p0C8ci;OSJ=eSxz)Hy?uQXQIOMi*blOSk0t|M@iu0{i$C<R{
z^vD)tMV&OSo)3zF(t$QF(M9M%XR<A9n7B(8k+@%PLkYz|GnY~(?+lqqjRIw*8@*O0
zoV{~cSWtP3hLstQH6Ie+>QeaJ+orD;oR;vAskxPLZ&k4;8#Kc=5vCAH>*eTiQtP3e
z%zv9dmQYCUl^6Bugu?b0$WCe2>RmfkQ||Ablg;b+bOkX%A#<BQk;eNrc#N{=m%g8*
z6z45rnT`CIxb~2~tzX57ZQ+RIb;lQ@?TOo+6H2_2w>4?eRvOGI;?E5^_sbJhKo7!R
zP79`cBoGM4Li=6wa)|&ZILt`DJF89El0c{p&<wS=R8avA1<We8^lq3dC33OL)IC9;
zshK2GaDJ)P6ubNR%b(m_)eURTJ^S*`4*j0Hnxjd4od5}pzn&Q(<;jkuoJ}<ja>w}~
zdX13C1H3b)_0T&n@HRv>yQ@c#*;sb#A-gG!^-yl3HRNQ>0Z{fRQ>uEA?K;4xwYxR6
zy>mwY+{(%?h9*8wGJ20xJ2}+$P6Ob@GhH4jDZKeO>Ff`Mse&hA>xKV>Hm~fM`=97+
zdFQei2a;s>aWy-T!9c0Xrtofx-PgGaCBwp%W?ntkw`6@@4oWjAh?p^t+IXC$o3GWZ
zzo_>MeE9@91MhM|e;>fBTK*^W)SJnvnMoiW9&j$yuXFD7-xs1B7FBix5Q-6(J(>Wy
zcBqbQcib=5^)#_BVqpn-VwEkrpl}E^V0(mpg{{^e9bNN0TYX2PMLDIOWNJ0?hbz^+
zd#A#KljPZT)THyvWDCT_BPME8@ht;FmP7dZ<I8SZ%_A&{ZHlz`#f8;C{>Ski<{k|D
zCGJk@L<fX5+<&$>DKa_2R;syoki@qfvRD_XuR;FB9GKoua<4}3_aaV38h0Md(i844
z%!QwqpKw`*KCVNpa^=2;@kruIZC}Lw`78@=utAQ}<~EL`vRf(~I80_N90RtubqN%6
zA4gPjMZPQ|i)$g@u~iZ!uc;iJQDSLx%XszNa{C#;nrnb>p5jVPbC~7m^3&HG**al7
zl@ed_T|%pwe%cXKrEYCS=vR_D6<k72vb@#!LBJ#6I)#b+JX8o$ypWc#Lj(|de_hX@
zGq?Q&UbODj=!w^t`{%R|Cn6e<t|z~;%4V@mn#7<mqER`ptcLhRevb&mV=xk_?&JwG
zLTP;ruU;mZ{4{vlo2L=Ed(I3V{m9jYz8>sq`Spr+?W*4CzASGzFD`b1z+F;*=%V(A
z-XEU?JUg%ErVmvab@S&)(br+X?s11{ugQi&G>b8%K41TN<iO=;pY({6eEgK>T2&iW
z9<?}aCdn*^gc9o%IVjZ@rW;{R%J{V_9Rgk?*qcrjtfmy6oLL+<O0cA7g1!=t5@=6&
zY)!jOVBhpJSE*lbU4=7(Iv(!Jm!Gxuv`POI;ne?ZO=3`RYXiDiSE;c5>GepY`}CCk
zo+x(Mdf|ykcE(#79VuW=jJx6QN>P7@V_*Hab7#+ImDL%oHK8}smVR?j_9qpasEOtm
zt&H_Y&)1~g0u9myiBppmCJLyJL&!R7T_movtevx1B+HOEJ*%=yn@ZpdTUhRoHK4$G
z8q~N(Y5JH<tUff*GqlA=O)2oGY--w>Z;%+iYpYpaqzg;FgHClQ=$Q!3JdE|oGvKq(
z9PqTJ>e8)T{U;)$iMyc$*}w7TZQiHnb|K%gy02#Yj;gTIDL8%L!8&?GF+0~96hq8x
zJS1$wbVrrGsrfd3dR`}n-~hCX5e}~K<S1AQyBR3ogW?zVX1K+V`1sRdb=9e4jIZ+T
zOWgD5jChSQ{>ry4IUXJc7TjxyPXsnZ00dt{>6=z{4E6pev;HsO`a?zehxT9>^?10t
zV0G5m7^gEcI5&zeN;8(l^A?Qhs%=phja4dPW~URX1bkZaE%>(fU^mqA^)4oEV*n<j
zTK#ylIke%^f#J9{If4oNX@qSxx1$6>hJe1TN#ZtA^e+A_#Uia7q4oie{_*POJzFO;
zFNz__BHzE6gx?^Vz~|lz=E70nk$mw{l{&1-*5Z%gVLzDI8)+5I^z$EkSkNhI84u(Y
zf1}e)Cgp$TXU&x$V(P;_kXCF|@Zi!VCJj|3`IpT-XWnGgCoZ<T(+RLJ8ect&pH#W4
zZf2%tX5G}LkbAayJH(I|uaUI$A@{?^o)2)`R?xWDl2)BsjX<v}$BWkKiv4qKJtrj^
zpl|FdD#3nr6!)->qU&YNnePvcZ21UQU+ko9r!O+&8I7V3B$lUfFApney(IMsaE8`3
z^4$i%VM{v@UwQOB;;l(y*%+&HjU(?}0VCi=zCo;^45A##T`ZKNmNX)>n!%>@ufuly
zZeJGc({6i#_%Q%re$|Yn{9c=+Q`Rx+;nz>hO#+^>j`c_#8pe?VS+Vs&jwC4ww}38{
z%59?oVa04Xzpz_Cdy!zTgBBk9U8Y+OqFyNK1i@tKoX&kpzgAdhR*G@JV|@KLTRr;g
zA}4HZxgFdl!<et-dC%1TNS=G#c{g%t!<g5^ul;+mm%+*xIt^LS6sO(W#i@o@Aliu7
zXe+3w3$RFggV?PXFGlgnUjtgVtS9{BkkS@rLOA?KJnv3ka#Z!+?_z!;EonZtEa}Z#
zu?@wdz|OBp{&sEV;I2CAst2ROt{PBo=Q8aEXH?(w*HGa?U(Pr>>%?p|w3dxl%lV|#
zxMri%LdKq}^f)vbl$QZ%m!!@fM@QhGj3EBJwM1W9izEVsT#_BC-?pV!t1<2qu@cXY
zwGH5AT<3C%;Dvn2;+ag34PivO^+*m6R;4nWbFs@U*D$$sBm|7ZBm}TZ^a+{xM3IR+
ze(J8X3JWRF(HGZ?M4S2)OZ8jG0^dprPOM76F`b*pyhOasFqe=(Ri1$RBsE?ko$4U?
z<Jq9}cU6Y2^0b{q9bGB+UCDvx!HnriS;)3PQwXD-x&$gsa#Qbs(_^rTt?OKzs?n`@
z@Vcn6c)nRsJVv|{QdX{g&~wZzYa8(}FC_vv%ewa^j%5ML5y*#@5O7nY9iV4*Tt<t*
z(BT=kkZI$^*xC+8(fdAUgV`IsJb@UR1MPqz$9Ev>dGRy}DXdL{Qw8~9>bRQ3-Sh(i
z2>4-qx(Kpd&cPmQWWS}!|C*Q1G>ETz;L~bj8He+;&j`y6+Jf3gc5m-vyH-^{j2MpB
z^DS<4d?faguR5v9y8~2}bG8$s{C#wh#sZzjC|t&Gy30X0Kem&c2O$FYkG#rta37)8
zJ+U@koBvVWK@wNxlCSY1QK}cvp5ySxQhG$x0d4UA0Fny7Zx(9Zt}df)MsX5qy>Ydm
zR&uljmMB)lX=5;R4c&<hJ3sYkDePCf=dOrIBtkYH`rBPAb+vTQ()uyckX<x2sd;uC
zkeEo_O0asbDs<1-Ly4mrR_PEgG~1s0VKNR^lz2{@n3pOLH&$C>$&Nz0vcQ>pDvYD4
zt4S{0UfkM+0vH=P1cWr8M4O<NgAGirO^GLF(#QzuVeeEUYpuZvt})e=+z%NfDRr0T
zFKj@00w-__=2AGU_;Ae_RIBYtM?;G!MiZ2Ez<S1<Q|VipWoTOpl}c~Q(r|-H1QBF2
zZt9sQRAP5;=ktqEje>hn%%zr0NG?1d?h0dyyN12fxTnrpfF@pL!rle8{;kOgYXy;{
z6~4cyh2$cL%-w<y5nvC*?LPK-UFK;G6#Bq}r*0plxcNE~D#}R6vJkErf4=k!rZ|1S
zQoeIBPM_a``;+fN^y_Hna<E~XY*d+Ed6?_@SJE*^wKb=|PR%%}b=B3d>lo$qo7=Lq
z4~k5VU9$=F(E)iwqR!<P1+auqC93lPiI<x;RnELSG`<9I*zfo{&hVek^oTjJ8-0D9
zsPoJn7!~nBj`Z=-qMz${Jxre$&Hb2h0yy38!Q8Y4sMfbCaPNv^gaBi`sbQ|56`YZG
zu`5mp?ODbWa%YVinv@AucFgX7mS~+H%woRGI+L@UMQ?I)<8V}BqHFY{;b7Un7>sMT
zgQa&=>UjK8`RvJ1h;zQTov&@VCls^UvxR;-3V3n5EY~P4g+{0hN{o<*?@rbV@DPfV
zeMGiKwI)v7GlND_S@Fx?svx(=P_N6+zbg7xgq}>g-})IGle`Fbq7;!pY&?jFGT<r8
zd^itnu#McaSN{i&2%ZbS)E9#n-aIIWV<{8bk>1RRE`w?I(KbF>hQ%-Bw9%sFDIm}y
z8GnyY3(X`H(Gd8|H!~aii$-|yciNxz<H7jFr)q8+f&AibUo>8XaPK<*?nu(jVo{e}
zXTI(aUG2(?@WxE0m+>HcM0@dYz{B{(gqJ4RT6H=0ZA%90#T3x!=cQ9#^#_a2>KTUd
z!KFG&OFMZ8sBA%UjnR_ece#E0zynMM(E5Q;f?S+!ka5BJWDvK(0egUWL1ovZgz-sQ
zTeobDNqnjeI)R>G9xV_B!1Ts%-DSmCaL$ybZ10f$RL6Vunq$JYd>vU+6W+)M(O6~0
zZH&#bB7Xvb1iL~evWCGkZ6wxl*Q})m<VmRiZeD%wGv8S*bkBz2)J<GSb}*dgAYEjC
zuxVHf`Gb)i6>fgO9iUd;%^vW{MSnJ-dBF?Tp9Zvi;6RJqNGgp5en4_Nj)`AiLkBUf
z2IAgz{gNyZJWt{+)jUxNpv$h1M;?_0t)?T;76-Rz!$2h?$Br2k#~E%Fu)U9NchB0F
zAl}R<z5diGEA>f|9bJcgW*~Z#*QRbQFO|W3<LC$X(N$G*b=B~y(-d&!2+r58ZP8w@
z=Y2DY;W*g-jqcX9N8vn5D@eCn!i19c-Zm`5C%tHZ`&hG+aGNZcXQdnl#^=swfqF9z
z1_LtjD@zTVjfQc5kn%@NKlCbp(tw8zhwU~S&?1O7nA`MoIia+TUR^|;EC7vZH#vDu
zmR0Hmwov)C2OPzn&H{fQh?Wv%qs$B0kaE5wX||&92pz=jAtlRfh^|{X=ijWO?|E3l
zkM{sZL2Lo~<8B8|DUbe%API#IFA=@h!`~CBN96TO@*YG2F#8}pB}3L{J1VoPg<qR-
zjUqr>>sxd04Ivrs@t}<}!Yf5{Nnuj+mkHs;@~)pBxJayGLYwQ#GCfb<YA3p>!r<sU
zJ|Qj$b_fH9E#xYvmoJ+{nsE$0{-+hcfBEAl09$o%6jhgu!f;?lt*x2fLyd{X#j*9Z
z;vQLNdV<a?@+^8j3zxTkWzuwx?_Ti>B%>~M1xI|XQJlHC;?1PX33My(`h`}SheGlw
zrb*3vhvQwgZ|d@wRrxYwM*^FKYN6#$?{;{-mU?vl74*OTjM&?J>U?bXt`A7UapHV&
zY#ilNdEm%tNCWBe7m3(xH&_;oC5JeF2z+`oo&IT6IqS_$$}3e#j-vTazgm%13lIF?
zE>f_)#o2AV&KY-C_jT<VErZFFM}?Ii-e&m_{TD3$FRlBGc#*APdDzabx8I46)0u}K
ztd{X%u{Q^9p<yl*#iC#2|9z`O!s9u@DZbE<Tlvc8YhFWM&0#ldwLiYA`|zXgy@vI3
zc7e(;<JuGb8kG<Bp-}nGYM<1@-M3<tVPvNG#2m&3%81X`{?Kr6BVk7QeYD3Wivsop
zzaetyQz3qWKY3K_w?0qBYj2a$E3L9fWPTSer^FP|sl?EFh{`x!0h1e!c%`*$KlOgG
zp>-Hykyy^)iv2=$R{=mZflD}>H{h<rIrNFB4Lno1e{nG(mCe`{y%uliCEOjWeA}-7
z26OAr2ccuHSVCKxo#^LOo|hSwlLX1vlSZ*h#B9rn-+RE;!eY)`24ORxRc=<Lk4#Zw
zo$Ih;@}~J-_Dkb%Utng>IS8L+ShYG`dpL#K!mahe3yM~UC1xP2d(IYx`?VI>YYQtG
zNzP)~e73^b;&q3(fKoA+ri2oI7@Vi13Q@9U2%9lj#sf=@#vPEOTSe)GtTt;!nR|?Y
ziGBCHP4r7y^zb8d6K;mB<je%zeTu3YY1!$+g(IJ~0C$Wd%&f)(Rk3!czgCrcd_KmL
ziWo1$;a4%M?P&Ze@*KF9@v&r5<^gut2sWRWIwaU6{=Cc#Lda5HkT#z<3|Ox}ldau_
zkCs%MSG3B$UJK$@ylCHyoE}%cd^Yc}B`cVN=OCVlH*rg_(62xu-j`e1SS$yxiFfEI
zchp6{G%d_()AGwIDhY*psUa-a)?A2&-rJWluir+RBN@bu$Ff)}A1ell6>)nBFRgdp
z>q7#MJ>atZsI5V+59x^UL7F|lz9Tit8d&E)Jyvk={>)@v_<@eBntfM3!W2}E?KhRx
z3V?$}B>dK^mcjN6d4V8Ynw|S`%ic~kUsHC4c-=g9=tYAG>{#E|A@iYTOesuaqH-UX
zu3)OC#(AJq>;jRMs7u&bEqG$BH<2gUcKSbwW(0{|_ZE^&)ck85_y(4DS2DH=<@fS|
zsIflcmC@CrJ&%&w__ug_jfR2-p@#vdG5!=<aBe{zgL&(0$C7cq4@p}{p<6Pp$1STx
zmn_~p<-saN<J0nYcGLi&@c{t;)0Y-Oty&BDGCgoO=~nn>K1ms|w@M~7Jj6_wF5h^1
ziRjLoAA>h<%Sp1S$=zEkkXVzEQd?Acf6{jUSXpamt}>k~Z_N79xNT9kuK7{0dIxOR
z`f@7)Xr45oFnb!(@RQd@9qvMfibAx&w%4XZNu;tF@1x$+x<5O}w)pOU@iy|!rN3IT
zjeP3RC%w802bYY`)x2i4Rkj&9h+DzTxH{u6H}Cp_vYiIU1&U@=ux!-6v*pr_T$C)C
zMZiJ*xv~b3DUywaB0ojz^MuB7B8@<Qtcyu~5I~Oh!xO}}$JhTi5<*koJ&EH*XU0SN
zsv5s_R-!Dxc1}8`%^eyMBX_w4^-b%oKrtKmdx@G0)n<g@+*}ZTLrFEUD3uF?3q{jb
z^y$scPbJ_L7virLYMHQtaNxW%0*ChHC9T|lb@h8N!4&L?V^f?OSJVf|0t~>OPc(cZ
zpMy0Bpoyb^B>j^S=z|EtwE}GfL%X4(7^;geQD*Wye}>#6JZjqoNo5wj=9C2Oo)k36
z(ETV8c=uq$bDfN0J>iRYMV;I4+z`8`>~&T4H+ONe<vtgKji`=R6^lkX>?yFWmAlQ+
zyRNkbSh}!aRae<yb|$U`>;V)zeQQLC%Ebi`UOE}^H*^%-jamS$@7c@h6S8n)aSezq
zzl&-CxtWZF-8PYq&4BvX>jH9)slV`DuVH3`hcGn8_G~hB_njupN(5n$?&jbG8wCa&
z`^w=UfmF8XR%-+9S%JlY>y8KF35Pp1c>@I^d@DS?33;VZx~{6C)W%~UQWun|76812
z4X{2G-P=j;V-4y7K!5iu&f^riKinxc(uo`wFUZy_b`nMK#J_9!2-?-jD*Jf4U=Y|S
z!id57f}I?AgEIAC<=hbo$vt>q0H7G9BYW(~pT}--oNF?qQ=FaNV^XIZ7+7+UQQmI^
z4lHh*C-nDxbet03Zr*o*cQ6?=%w<#uNQk7l81e+{?VXiWJ2bi!5_M3ezeeQevDd$H
zc-UZGb`v|E@}BGKM4gJf0A_Z=>K)@P!l@CB(XksKAi!=${CFb5;cE~y$5Q;Gy}NI<
zsFe+kqM}LT#^}buw(makU(4na@o4ay_?s*6%D#M{8f?$*FuF(b5I-QFOj{1@&F_07
zIp9^TE0Rkk;l9Hi@aui2;7*TL_an;Mo@?;fw$ZLUhrS%+psw~by%w^+=dY_9aiw;J
zOvcH|`bNdd`_H3gZlr^%#3T7FE&W$LTW~$@*T_so%F=*_TR9sn@$51E>(z!P1%|MX
zXe$UggZ|Xv#4Ce<nw)3F%*d|N$`&L(JMFx-#F6q?AQ_H9@SIQgp&hq|c0BGna{0j2
z{I#zCL_b1#m{k;+#tjG=1DxyTZQr8PjMFh&jk@|?%6z>*9o+pjgyeyra#3hfUd$F#
z9A6_Gs_{0DvAURl>ck|L>I*pkKz>QmaOp^dY3@zpv`4m5{PeTCe=CaVI~8%|q4}cK
zHB9@pxS;-WINp8de4-DBsl0cc-@?6KoKM!~5d7<8C?s7T+94>+WynZl@R4b*CKehc
z^jQA4mHMw4Ddr0HA-k=Z_JqsA_61tLsH{|*mkF}~%F1JV0?AL6bmd!{eSrmaObex6
z;la~?PNIRE!F`{b(Odl`;puGb9h$wTkFS;g#4V>R5L=hmI#guR=ZwXMmyZP+pT#-~
z?5QzSzw}vs@haxvz`J<NXF@WfZ}GnHYwSRgRJm#CWYMydw60iHRg7_`3ni+OM8qes
z=tW=Qh%43c(H85B#lGWEx<`qq%i-BGR1^P6fJKCdvDb=Z@4O5KwT{p04nM&)P($E8
zbz9`Hm}-vTu=P3?9nv+tLe6VGMZWy6_#AcM`Z|x#tk4ajFIQ391qb{ufITRWuNk2Z
zT`!yKhAN9aJgLI3{AE}PCj0}_r?W%57`{8ac*~!g(Y*TE8$O*)pC&gIpvcaL)uwU6
z{nD2hw7RRvjY`d?v(Fn19lPgmeaMyj`~;?MbMOE4`*ha*?zZ1bn1OkUT`|z$Oivet
z2l6QIfrCEN^KPl0&n*a2vA)R1SjK&xQvQV!3^+Eq|N4pvJ+&D8>%FvNN#1y>PC|EH
z5J^*nC$W+dt*O4TZML#7T=1JmeaiLd|J48XYDUS-S{pEVy9Tocx@v!|23mV1-GEy~
zl<Eb1+F)F)NwB1r-@=T1B-m0$XqM#frEw|PjVMHm?LR^~E3xT~GYSPx=DK^+h~@Kd
zGOj+4uNluan2Ewg3j!xkss-^l(pi^~cf-_761q0+|M7JHn?sK-H{CRd8`p3&oy-_p
zmr`#1%qrzzoCM=3n!)K>KscvLT7!AQ^D82+Z^;)d0ppVCiqh<5js0;$Xn7e`G7^p(
zL`ABvf?Nbln*wF(FV69E7qWO>r<uB{j4)kFf)8>h3fk{+3AfD-5S2chgv<@*sjHVp
z5HUTbyWI3MOYup=8Z=tl55o3=br^-kb9@_jsw<M1>3!!}*$<a?rOmqUt}_(#X~*8t
zBXInyfsePpBdq;Verudw|BD83{)c^ltd$k1Nk=%kM}QJ|P;yecqzP=NL}k)tmJrGe
z!9Mc@t<WuUHYhc2_)W}Z2Od;x_eyPrlFJ@3P1Zm-*Vos%-ctQ`{I`RV5B+$hal?9Z
z0_J{v{uh|72<3-9)~_4)Xr<QzSaRZ4jlF5)E>8E#7HfDfjF1N3BWrYpKsD+ji()T%
zC~Xn<c`$T2nivMfs?T?4n1)(R=2dyCbPOVX8uFn;0nS=wMS~?9!Rl`cs!;0{&ph|k
z8;qhY3Os9<(7+7XOo^{~&Nmw&31oUjvlp2X&s|>=b51EEGd$LDZY%I~p~KRVeO8B<
zn923g4e7mZ;km6DZ&rV7>sIJ3YJT2^rIVTmasdlFgI&3AC|F;WHkgf<p*fE<@v9vL
z2L>7-nH~#x653;_@5i)uSyAmdT+S8q11XTih!pg_JK?V@7;w7aEr&P-+WVND+!2o>
zUY{y%IvYr62DmhM&~+8OzVY-`2eEn4G{*PL<y_K#Ey{(j=H8&<tot4DZvkHqCcb=W
zaB)JN+B@{E2dfL{uC_W=aF<jvEO0O==2V)WGJRhqcAl=MJ>RdJA+2(rGQsJ7BPY6J
zBu^A{+Cnk6Q8h!>M^G+_fwJlyBN?JRe7|nfBnjWN1%fdF6nOpw*LNCRwAea$xwu8_
z;KSik430)|wwU7RXd&TO_RFTzz>D*<iukuU#Y;q2Zb*Bd`+ILS95%-YG>S82+_?dj
zA&QyqQVTL8GyEnMdc`nWtyy%xKQFU@ZyLXxub%SVGryv8)TYUsdz5>ke2urmWy|#p
zeb`9tJXx(XA5Z=p>Ch4xmYS1Z91UfMQ=5BRwl%JX44rhFdz9GL$OdU2H`-cx){P&O
z!IA5RjGQ3&v|iveB0hl3l(oLllVUYI%B6j{XM__|zZ2j#2cTH~Ro_z8Vr#r^Sc9NX
z7HB-O+6|_4X*_=2dsXUpYrMg77eC3HAB<eLl|EifhB0P{wC#a!$E_>8H=+xcEp?1?
ziR$}8omupA-Ln-xF+SdSk(w}{huN^r>kD2ZHn$H-ZWGItD?Zk}pW|`~zN9yJX!0%4
zG~)QkBt?!gv-~(?-UpM^h;oh*&YJXhI+U0{4WvgN*EF6%)2ga)eA!0tv(4yGIh&>C
zO+8YW^a@qw()2j|sEr_ZKt;MKRS{2bLtWj2a~yTkjiBRSjNuoj%d9m63IzAG%=U_r
z^un;T>7jYxF=l%k)76j-@)d3E%j<2qLhoN<8uZ2q9O-s)2?l`Bbs^WwVD4Ihqf1Zf
z6HaQNWio~p?!#^1a)Cme$8jTO4{q1HE+M;H=F?gTuSW1-IAvn=v|M6vDPjoWk|PHC
zP``@{k9)0c=~Z&nGr1wO0;VU=$0o-+dxZzIm^>i9fK#H}MrQwO0jw?H-GTZxhY7b%
zPUpPTF7}{f`(jft^e{Q0b@9}yZXcL6wz<$P_As-l3N3yh4CuftxCN{n`M6XBnkHl)
zLh>!s(f&bJu}&FP5~a*DFCU<25-5`^@IJVONw66=%x{EIBJgm^>zCZ=BInP*g0+K<
ziKLt`f}wq^I7=`#$xU^*{UPlLLyG{B`rS^Rxz1D`3Pu^81#Exp(<hPHI-(oddKrfq
zfzw@i>$1~*_(nIAwLKN7gVZUL(ya}!Md0*wdioPx5nr?8j<l|Yvqhj_S>x}X!+MV2
zPa#_acZ@Q?&~-Cd!rpkJK%8#oDJ-?orRU>90sYc1k%yPbOc%;bGm<XyRVj6ZT)^xz
z*1k7741w8(GsDvy0mogOBW+;O12AY$v|zk=hN?hfuR<MM*6=Y)wo(_^M3yN=T3XO(
z1%dTt#n|udK++WH$|sBhMwl}Fdp_>IYg$??EnBKv-_>*60mm}p8(YW5tkxBUOU&x1
z&M{aya#X2B6*vFyy#px`wSf8U1i5o>@0GmtX5pE0&uZ`e!>ZGYg1d{ir~6K7Pb)eO
zL9!2do<q1bWhVUB7E%D?88I8?0NK&})6;r)j4h;06WE&P*18i|EWXkLnJ#Ixsx`64
z%s+9FoaVF@lasRr*71tkprG&!!-o%wT=sTGM6!3q0Gat#Ck{OEo~A_f)oqw4y1#+L
zfA%v#!sU3K{^0+*$G<$~WB%XD+f^d{8yx&+w<t)sjO1GW>u>)<c{J&lu9tv)zFhl<
zzb1U0eNVUyyzl=1o6Y~W5v%^@3aVOKC*;p2T{Q@o1xY0TAFKTr__eXSey^fNY)z|2
zJNx_KA!i$iKPLU<f3;bBZ>+BA!KRA~XL?^SPt;Y`e~nj&$aAb*(QtMCN9vci{~F%Y
z%fY{X{rV0$bQT|zQ}Kn&s#*QK@u&PxnNKGYC`_JQFL4g{{+Al;?tItgoUExbYp8?I
zyiX3klCIMK+dllg3%;`~KYM<lg{uP`0$9ae;q#XNKwrQA`84^*X0O)Rl)apj@%`&1
z98$dhyqh2>iFh4(!>dS}ZQa*a{U?33(tn)!KQ#F?{7nGe-1(;Y*u)g*EDI(My<(^l
zD)=ugM89ds^muhqNZvX&GqL5-FZ9M!g-6m={=px;CA4>PcWi8I_Qwc0?exETQhRgE
zl4tCqss8NPvP$aVzkX$Uq3|>Uc5$@LN@mLbWBXszt3Togvgt&>`nUu3eW$h5Wsl5|
z(e3D8x>C6_HaQ9PZ*Pms6#EsIdGVmcyrDCg=jTm|e+|ZpNYW1E<Q!@dcw~9BE7o+=
zu*CExxy=5Z>m^pv;{TFLs3O%=q#w8O12-`fKzY6~6GSUoCHgBTL6)vJTaK|eO9~m>
zwe#iHzaD$!8wLbfVN(UXp@HFiE$CdzKM>oyXa?&_7l<I>5#r43(*>{UXzzLAKW>D|
z69E7KOBWXbCz<d1XLAc79gM=Fx2t5&*!*`_3g)UT0w^B_9?iL~4CZyznGjIg?BXXI
zu;&QlEtl-OF6n3Ni>n)t9XEminE=bCldeutL|>wuv^cchO!PRW!_%t5f~4qtwH%)R
zinAWJ%J+oQN_Aa8c&%KV(y2h^tQe@Tv!UCQ%t#1G_+RXt&K-9J1s!b(;K>gx9GfnR
z15vha$7fsCrKdmKFU%yy&d~?mZNOb;)sdOfgPBbI`m?Rs?N{ZtRWel@t&Hz&FJwBl
zKFaYo&0Gjb2f_0@)@Ir*vLp&UwhSXaYD&etyl|S5gxt1hVsPi^;4r~o$K#H;E^MoU
z7&ZgXJjSNcH!Wrw9t0lZXCkr+UAC;u>b=3cekKMXXBCXBl^GnRBLlQpat>az=#+tq
RrAvg5>N72+5`|Z9{}0zlz`p<h

literal 0
HcmV?d00001


From 898fdb6a00990b5c19566c98bd1ac9b4449fc8f9 Mon Sep 17 00:00:00 2001
From: boyuanx <jxu@ethsign.xyz>
Date: Mon, 30 Jan 2023 17:07:42 -0800
Subject: [PATCH 214/274] Add EIP-6066: Signature Validation Method for NFTs
 (#6066)

* 6066 first draft

* Fix header

* Update header

* Fix header, remove reference section

* Fix EIP links

* Reformat rationale

* Refactor motivation & rationale

* Update discussion

* Update rationale

* Rationale clarification

* Refactor

* Word choice

* Incorporated feedback regarding EIP-5750

* RFC8174 & clarifications

* Update rationale & motivation
---
 EIPS/eip-6066.md | 127 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 127 insertions(+)
 create mode 100644 EIPS/eip-6066.md

diff --git a/EIPS/eip-6066.md b/EIPS/eip-6066.md
new file mode 100644
index 00000000000000..096b84e19cd2b4
--- /dev/null
+++ b/EIPS/eip-6066.md
@@ -0,0 +1,127 @@
+---
+eip: 6066
+title: Signature Validation Method for NFTs
+description: A way to verify signatures when the signing entity is an EIP-721 or EIP-1155 NFT
+author: Jack Boyuan Xu (@boyuanx)
+discussions-to: https://ethereum-magicians.org/t/eip-6066-signature-validation-method-for-nfts/
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-11-29
+requires: 721, 1155, 1271, 5750
+---
+
+## Abstract
+
+While **E**xternally **O**wned **A**ccounts can validate signed messages with `ecrecover()` and smart contracts can validate signatures using specifications outlined in [EIP-1271](./eip-1271.md), currently there is no standard method to create or validate signatures made by NFTs. We propose a standard way for anyone to validate whether a signature made by an NFT is valid. This is possible via a modified signature validation function originally found in [EIP-1271](./eip-1271.md): `isValidSignature(tokenId, hash, data)`.
+
+## Motivation
+
+With billions of ETH in trading volume, the **N**on-**F**ungible **T**oken standard has exploded into tremendous popularity in recent years. Despite the far-reaching implications of having unique tokenized items on-chain, NFTs have mainly been used to represent artwork in the form of avatars or profile pictures. While this is certainly not a trivial use case for the [EIP-721](./eip-721.md) & [EIP-1155](./eip-1155.md) token standards, we reckon more can be done to aid the community in discovering alternative uses for NFTs.
+
+One of the alternative use cases for NFTs is using them to represent offices in an organization. In this case, tying signatures to transferrable NFTs instead of EOAs or smart contracts becomes crucial. Suppose there exists a DAO that utilizes NFTs as badges that represent certain administrative offices (i.e., CEO, COO, CFO, etc.) with a quarterly democratic election that potentially replaces those who currently occupy said offices. If the sitting COO has previously signed agreements or authorized certain actions, their past signatures would stay with the EOA who used to be the COO instead of the COO's office itself once they are replaced with another EOA as the new COO-elect. Although a multisig wallet for the entire DAO is one way to mitigate this problem, often it is helpful to generate signatures on a more intricate level so detailed separation of responsibilities are established and maintained. It is also feasible to appoint a smart contract instead of an EOA as the COO, but the complexities this solution brings are unnecessary. If a DAO uses ENS to establish their organizational hierarchy, this proposal would allow wrapped ENS subdomains (which are NFTs) to generate signatures.
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+```
+pragma solidity ^0.8.0;
+
+interface IEIP6066 {
+    /**
+     * @dev MUST return if the signature provided is valid for the provided tokenId and hash
+     * @param tokenId   Token ID of the signing NFT
+     * @param hash      Hash of the data to be signed
+     * @param data      OPTIONAL arbitrary data that may aid verification
+     *
+     * MUST return the bytes4 magic value 0xdff13226 when function passes.
+     * MUST NOT modify state (using STATICCALL for solc < 0.5, view modifier for solc > 0.5)
+     * MUST allow external calls
+     *
+     */
+    function isValidSignature(
+        uint256 tokenId,
+        bytes32 hash,
+        bytes calldata data
+    ) external view returns (bytes4 magicValue);
+}
+```
+
+`isValidSignature` can call arbitrary methods to validate a given signature.
+
+This function MAY be implemented by [EIP-721](./eip-721.md) or [EIP-1155](./eip-1155.md) compliant contracts that desire to enable its token holders to sign messages using their NFTs. Compliant callers wanting to support contract signatures MUST call this method if the signer is the holder of an NFT ([EIP-721](./eip-721.md) or [EIP-1155](./eip-1155.md)).
+
+## Rationale
+
+We have purposefully decided to not include a signature generation standard in this proposal as it would restrict flexibility of such mechanism, just as [EIP-1271](./eip-1271.md) does not enforce a signing standard for smart contracts. We also decided to reference Gnosis Safe's contract signing approach as it is both simplistic and proven to be adequate. The `bytes calldata data` parameter is considered optional if extra data is needed for signature verification, also conforming this EIP to [EIP-5750](./eip-5750.md) for future-proofing purposes.
+
+## Backwards Compatibility
+
+This EIP is incompatible with previous work on signature validation as it does not validate any cryptographically generated signatures. Instead, signature is merely a boolean flag indicating consent. This is consistent with Gnosis Safe's contract signature implementation.
+
+## Reference Implementation
+
+Example implementation of an [EIP-721](./eip-721.md) compliant contract that conforms to [EIP-6066](./eip-6066.md) with a custom signing function:
+
+```
+pragma solidity ^0.8.0;
+
+import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+import "./interfaces/draft-IEIP6066.sol";
+
+contract EIP6066Reference is ERC721, IEIP6066 {
+    bytes4 public constant MAGICVALUE = 0xdff13226;
+    bytes4 public constant BADVALUE = 0xffffffff;
+
+    mapping(uint256 => mapping(bytes32 => bool)) internal _signatures;
+
+    error ENotTokenOwner();
+
+    /**
+     * @dev Checks if the sender owns NFT with ID tokenId
+     * @param tokenId   Token ID of the signing NFT
+     */
+    modifier onlyTokenOwner(uint256 tokenId) {
+        if (ownerOf(tokenId) != _msgSender()) revert ENotTokenOwner();
+        _;
+    }
+
+    constructor(string memory name_, string memory symbol_)
+        ERC721(name_, symbol_)
+    {}
+
+    /**
+     * @dev SHOULD sign the provided hash with NFT of tokenId given sender owns said NFT
+     * @param tokenId   Token ID of the signing NFT
+     * @param hash      Hash of the data to be signed
+     */
+    function sign(uint256 tokenId, bytes32 hash)
+        external
+        onlyTokenOwner(tokenId)
+    {
+        _signatures[tokenId][hash] = true;
+    }
+
+    /**
+     * @dev MUST return if the signature provided is valid for the provided tokenId, hash, and optionally data
+     */
+    function isValidSignature(uint256 tokenId, bytes32 hash, bytes calldata data)
+        external
+        view
+        override
+        returns (bytes4 magicValue)
+    {
+        // The data parameter is unused in this example
+        return _signatures[tokenId][hash] ? MAGICVALUE : BADVALUE;
+    }
+}
+```
+
+## Security Considerations
+
+The revokable nature of contract-based signatures carries over to this EIP. Developers and users alike should take it into consideration.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From ba361d72b775f83de9bcefeb7212debc0a74252c Mon Sep 17 00:00:00 2001
From: Marius van der Wijden <m.vanderwijden@live.de>
Date: Tue, 31 Jan 2023 02:16:40 +0100
Subject: [PATCH 215/274] Add EIP-6122: Forkid checks based on timestamps
 (#6122)

* EIPS: add forkid by timestamp draft

* EIPS: add forkid by timestamp

* eip-6122: rename

* eip-6122: add martins comments, linter fixes

* Fix typo

* Fix typo introduced by me

* Apply suggestions from code review

Co-authored-by: Alex Beregszaszi <alex@rtfs.hu>
Co-authored-by: Danny Ryan <dannyjryan@gmail.com>

* Fix typos highlighted in code review

Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>
Co-authored-by: Ahmad Bitar <33181301+smartprogrammer93@users.noreply.github.com>

* eip-6122: fix comments

* eip-6122: fix comments

* eip-6122: fix comments

---------

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Co-authored-by: Alex Beregszaszi <alex@rtfs.hu>
Co-authored-by: Danny Ryan <dannyjryan@gmail.com>
Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>
Co-authored-by: Ahmad Bitar <33181301+smartprogrammer93@users.noreply.github.com>
---
 EIPS/eip-6122.md | 193 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 193 insertions(+)
 create mode 100644 EIPS/eip-6122.md

diff --git a/EIPS/eip-6122.md b/EIPS/eip-6122.md
new file mode 100644
index 00000000000000..79f81422c19f69
--- /dev/null
+++ b/EIPS/eip-6122.md
@@ -0,0 +1,193 @@
+---
+eip: 6122
+title: Forkid checks based on timestamps
+description: Modifies the forkid checks to work with timestamps and block numbers
+author: Marius van der Wijden (@MariusVanDerWijden)
+discussions-to: https://ethereum-magicians.org/t/eip-6122-forkid-checks-based-on-timestamps/12130
+status: Draft
+type: Standards Track
+category: Networking
+created: 2022-12-13
+requires: 2124
+---
+
+## Abstract
+
+[EIP-2124](./eip-2124.md) proposed a way of identifying nodes on the p2p network based on their chain configuration via the forkid parameter. 
+It allows nodes to cut incompatible nodes off quickly which makes the P2P network more reliable.
+After the merge, forks are scheduled by block time instead of block number. This EIP updates the forkid calculation with block time.
+
+## Motivation
+
+While in proof-of-work forks were scheduled by block number, the proof-of-stake consensus layer schedules forks by slot number. The slot number is a time based measurement. In order to schedule forks at the same time on the consensus and execution layer, the execution layer is forced to also schedule forks by timestamp after the merge.
+
+The forkid calculation allows peers to quickly determine the configuration of peers and disconnect peers that are misconfigured or configured for other networks.
+
+## Specification
+
+Each node maintains the following values:
+
+- **`FORK_HASH`**: IEEE CRC32 checksum (`[4]byte`) of the genesis hash and fork blocks numbers or timestamps that already passed.
+  - The fork block numbers or timestamps are fed into the CRC32 checksum in ascending order.
+  - If multiple forks are applied at the same block or time, the block number or timestamp is checksummed only once.
+  - Block numbers are regarded as `uint64` integers, encoded in big endian format when checksumming.
+  - Block timestamps are regarded as `uint64` integers, encoded in big endian format when checksumming.
+  - If a chain is configured to start with a non-Frontier ruleset already in its genesis, that is NOT considered a fork.
+- **`FORK_NEXT`**: Block number or timestamp (`uint64`) of the next upcoming fork, or `0` if no next fork is known.
+  - Note that it is not important to distinguish between a timestamp or a block for `FROK_NEXT`.
+
+A `FORK_HASH` for a timestamp based fork at `1668000000` on top of homestead would be:
+
+- forkhash₁ = `0xcb37b2ee` (homestead+fictional fork) = `CRC32(<genesis-hash> || uint64(1150000) || uint64(1668000000))`
+
+### Additional rules
+
+The following additional rules are applied:
+
+- Forks by timestamp MUST be scheduled at or after the forks by block (on mainnet as well as on private networks).
+- An implementation of forkid verification of remote peer needs to filter the incoming forkids first by block then by timestamp.
+
+## Rationale
+
+Shanghai will be scheduled by timestamp thus the forkid calculations need to be updated to work with timestamps and blocks.
+Since all block number based forks are before time based forks, nodes need to check the block based forks before the time based forks.
+
+## Backwards Compatibility
+
+This change modifies the forkid calculation slightly. 
+As a consequence nodes applying this change will drop peers who are not applying this change as soon as timestamp-scheduled fork occurs.
+This is not only expected, but actually the purpose of the forkid in the first place.
+
+## Test Cases
+
+Here's a suite of tests with mainnet config and withdrawals enabled at time `1668000000` and merge netsplit block at block `18000000`
+
+```go
+type testcase struct {
+	head uint64
+	want ID
+}
+tests := []struct {
+	config  *params.ChainConfig
+	genesis common.Hash
+	cases   []testcase
+}{
+	// Withdrawal test cases
+	&withdrawalConfig,
+	params.MainnetGenesisHash,
+	[]testcase{
+		{0, 0, ID{Hash: checksumToBytes(0xfc64ec04), Next: 1150000}},           // Unsynced
+		{1149999, 0, ID{Hash: checksumToBytes(0xfc64ec04), Next: 1150000}},     // Last Frontier block
+		{1150000, 0, ID{Hash: checksumToBytes(0x97c2c34c), Next: 1920000}},     // First Homestead block
+		{1919999, 0, ID{Hash: checksumToBytes(0x97c2c34c), Next: 1920000}},     // Last Homestead block
+		{1920000, 0, ID{Hash: checksumToBytes(0x91d1f948), Next: 2463000}},     // First DAO block
+		{2462999, 0, ID{Hash: checksumToBytes(0x91d1f948), Next: 2463000}},     // Last DAO block
+		{2463000, 0, ID{Hash: checksumToBytes(0x7a64da13), Next: 2675000}},     // First Tangerine block
+		{2674999, 0, ID{Hash: checksumToBytes(0x7a64da13), Next: 2675000}},     // Last Tangerine block
+		{2675000, 0, ID{Hash: checksumToBytes(0x3edd5b10), Next: 4370000}},     // First Spurious block
+		{4369999, 0, ID{Hash: checksumToBytes(0x3edd5b10), Next: 4370000}},     // Last Spurious block
+		{4370000, 0, ID{Hash: checksumToBytes(0xa00bc324), Next: 7280000}},     // First Byzantium block
+		{7279999, 0, ID{Hash: checksumToBytes(0xa00bc324), Next: 7280000}},     // Last Byzantium block
+		{7280000, 0, ID{Hash: checksumToBytes(0x668db0af), Next: 9069000}},     // First and last Constantinople, first Petersburg block
+		{9068999, 0, ID{Hash: checksumToBytes(0x668db0af), Next: 9069000}},     // Last Petersburg block
+		{9069000, 0, ID{Hash: checksumToBytes(0x879d6e30), Next: 9200000}},     // First Istanbul and first Muir Glacier block
+		{9199999, 0, ID{Hash: checksumToBytes(0x879d6e30), Next: 9200000}},     // Last Istanbul and first Muir Glacier block
+		{9200000, 0, ID{Hash: checksumToBytes(0xe029e991), Next: 12244000}},    // First Muir Glacier block
+		{12243999, 0, ID{Hash: checksumToBytes(0xe029e991), Next: 12244000}},   // Last Muir Glacier block
+		{12244000, 0, ID{Hash: checksumToBytes(0x0eb440f6), Next: 12965000}},   // First Berlin block
+		{12964999, 0, ID{Hash: checksumToBytes(0x0eb440f6), Next: 12965000}},   // Last Berlin block
+		{12965000, 0, ID{Hash: checksumToBytes(0xb715077d), Next: 13773000}},   // First London block
+		{13772999, 0, ID{Hash: checksumToBytes(0xb715077d), Next: 13773000}},   // Last London block
+		{13773000, 0, ID{Hash: checksumToBytes(0x20c327fc), Next: 15050000}},   // First Arrow Glacier block
+		{15049999, 0, ID{Hash: checksumToBytes(0x20c327fc), Next: 15050000}},   // Last Arrow Glacier block
+		{15050000, 0, ID{Hash: checksumToBytes(0xf0afd0e3), Next: 18000000}},   // First Gray Glacier block
+		{18000000, 0, ID{Hash: checksumToBytes(0x4fb8a872), Next: 1668000000}}, // First Merge Start block
+		{20000000, 0, ID{Hash: checksumToBytes(0x4fb8a872), Next: 1668000000}}, // Last Merge Start block
+		{20000000, 1668000000, ID{Hash: checksumToBytes(0xc1fdf181), Next: 0}}, // First Shanghai block
+		{20100000, 2669000000, ID{Hash: checksumToBytes(0xc1fdf181), Next: 0}}, // Future Shanghai block
+	},
+}
+```
+
+ Here's a suite of tests of the different states a Mainnet node might be in and the different remote fork identifiers it might be required to validate and decide to accept or reject:
+
+```go
+tests := []struct {
+	head uint64
+	id   ID
+	err  error
+}{
+	/// Local is mainnet Withdrawals, remote announces the same. No future fork is announced.
+	{20000000, 1668000001, ID{Hash: checksumToBytes(0xc1fdf181), Next: 0}, nil},
+
+	// Local is mainnet Withdrawals, remote announces the same also announces a next fork
+	// at block/time 0xffffffff, but that is uncertain.
+	{20000000, 1668000001, ID{Hash: checksumToBytes(0xc1fdf181), Next: math.MaxUint64}, nil},
+
+	// Local is mainnet currently in Byzantium only (so it's aware of Petersburg & Withdrawals), remote announces
+	// also Byzantium, but it's not yet aware of Petersburg (e.g. non updated node before the fork).
+	// In this case we don't know if Petersburg passed yet or not.
+	{7279999, 1667999999, ID{Hash: checksumToBytes(0xa00bc324), Next: 0}, nil},
+
+	// Local is mainnet currently in Byzantium only (so it's aware of Petersburg & Withdrawals), remote announces
+	// also Byzantium, and it's also aware of Petersburg (e.g. updated node before the fork). We
+	// don't know if Petersburg passed yet (will pass) or not.
+	{7279999, 1667999999, ID{Hash: checksumToBytes(0xa00bc324), Next: 7280000}, nil},
+
+	// Local is mainnet currently in Byzantium only (so it's aware of Petersburg & Withdrawals), remote announces
+	// also Byzantium, and it's also aware of some random fork (e.g. misconfigured Petersburg). As
+	// neither forks passed at neither nodes, they may mismatch, but we still connect for now.
+	{7279999, 1667999999, ID{Hash: checksumToBytes(0xa00bc324), Next: math.MaxUint64}, nil},
+
+	// Local is mainnet exactly on Withdrawals, remote announces Byzantium + knowledge about Petersburg. Remote
+	// is simply out of sync, accept.
+	{20000000, 1668000000, ID{Hash: checksumToBytes(0xa00bc324), Next: 7280000}, nil},
+
+	// Local is mainnet Withdrawals, remote announces Byzantium + knowledge about Petersburg. Remote
+	// is simply out of sync, accept.
+	{20000000, 1668000001, ID{Hash: checksumToBytes(0xa00bc324), Next: 7280000}, nil},
+
+	// Local is mainnet Withdrawals, remote announces Spurious + knowledge about Byzantium. Remote
+	// is definitely out of sync. It may or may not need the Petersburg update, we don't know yet.
+	{20000000, 1668000001, ID{Hash: checksumToBytes(0x3edd5b10), Next: 4370000}, nil},
+
+	// Local is mainnet Byzantium & pre-withdrawals, remote announces Petersburg. Local is out of sync, accept.
+	{7279999, 1667999999, ID{Hash: checksumToBytes(0x668db0af), Next: 0}, nil},
+
+	// Local is mainnet Spurious, remote announces Byzantium, but is not aware of Petersburg. Local
+	// out of sync. Local also knows about a future fork, but that is uncertain yet.
+	{4369999, 1667999999, ID{Hash: checksumToBytes(0xa00bc324), Next: 0}, nil},
+
+	// Local is mainnet Withdrawals. remote announces Byzantium but is not aware of further forks.
+	// Remote needs software update.
+	{20000000, 1668000001, ID{Hash: checksumToBytes(0xa00bc324), Next: 0}, ErrRemoteStale},
+
+	// Local is mainnet Withdrawals, and isn't aware of more forks. Remote announces Petersburg +
+	// 0xffffffff. Local needs software update, reject.
+	{20000000, 1668000001, ID{Hash: checksumToBytes(0x5cddc0e1), Next: 0}, ErrLocalIncompatibleOrStale},
+
+	// Local is mainnet Withdrawals, and is aware of Petersburg. Remote announces Petersburg +
+	// 0xffffffff. Local needs software update, reject.
+	{20000000, 1668000001, ID{Hash: checksumToBytes(0x5cddc0e1), Next: 0}, ErrLocalIncompatibleOrStale},
+
+	// Local is mainnet Withdrawals, remote is Rinkeby Petersburg.
+	{20000000, 1668000001, ID{Hash: checksumToBytes(0xafec6b27), Next: 0}, ErrLocalIncompatibleOrStale},
+
+	// Local is mainnet Withdrawals, far in the future. Remote announces Gopherium (non existing fork)
+	// at some future block 88888888, for itself, but past block for local. Local is incompatible.
+	//
+	// This case detects non-upgraded nodes with majority hash power (typical Ropsten mess).
+	{88888888, 1668000001, ID{Hash: checksumToBytes(0xf0afd0e3), Next: 88888888}, ErrRemoteStale},
+
+	// Local is mainnet Withdrawals. Remote is in Byzantium, but announces Gopherium (non existing
+	// fork) at block 7279999, before Petersburg. Local is incompatible.
+	{20000000, 1668000001, ID{Hash: checksumToBytes(0xa00bc324), Next: 7279999}, ErrRemoteStale},
+```
+
+## Security Considerations 
+
+No known security risks
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From 5f6163214a030e9bcf4ea69492b6a54a67e9f061 Mon Sep 17 00:00:00 2001
From: Moody Salem <moody.salem@gmail.com>
Date: Mon, 30 Jan 2023 20:17:28 -0500
Subject: [PATCH 216/274] Website: add an all.xml rss feed (#6157)

* add an all.xml rss feed

* remove the author and fix the if endif

* move to rss folder

* escape type and category
---
 rss/all.xml | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 rss/all.xml

diff --git a/rss/all.xml b/rss/all.xml
new file mode 100644
index 00000000000000..b5be0a9442f3b6
--- /dev/null
+++ b/rss/all.xml
@@ -0,0 +1,27 @@
+---
+layout: null
+---
+<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+  <channel>
+    <title>Ethereum EIPs</title>
+    <description>A feed of all EIPs</description>
+    <link>{{ site.url }}</link>
+    <atom:link href="{{ site.url }}/all.xml" rel="self" type="application/rss+xml" />
+    <lastBuildDate>{{ site.time | date_to_rfc822 }}</lastBuildDate>
+    {% assign eips = site.pages | sort: 'eip' %}
+    {% for eip in eips %}
+      <item>
+        <title>{{ eip.title | xml_escape }}</title>
+        <category>{{ eip.type | xml_escape }}/{{ eip.category | xml_escape }}</category>
+        {% if eip.discussions-to %}
+          <comments>{{ eip.discussions-to | xml_escape }}</comments>
+        {% endif %}
+        <description>{{ eip.content | xml_escape }}</description>
+        <pubDate>{{ eip.created | date_to_rfc822 }}</pubDate>
+        <link>{{ site.url }}{{ eip.url }}</link>
+        <guid isPermaLink="true">{{ site.url }}{{ eip.url }}</guid>
+      </item>
+    {% endfor %}
+  </channel>
+</rss>

From 7f27543c771a4b8992aa8b315a6ce625b65b87aa Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Mon, 30 Jan 2023 20:24:22 -0500
Subject: [PATCH 217/274] CI: Use environment files (#6277)

* Update CI: Use environment files

* Update post-ci.yml
---
 .github/workflows/auto-review-bot.yml | 2 +-
 .github/workflows/post-ci.yml         | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/auto-review-bot.yml b/.github/workflows/auto-review-bot.yml
index 696694c700aa17..bf61f95135a695 100644
--- a/.github/workflows/auto-review-bot.yml
+++ b/.github/workflows/auto-review-bot.yml
@@ -20,7 +20,7 @@ jobs:
 
       - name: Save PR Number
         id: save-pr-number
-        run: echo "::set-output name=pr::$(cat pr-number.txt)"
+        run: echo "pr=$(cat pr-number.txt)" >> $GITHUB_OUTPUT
 
       - name: Checkout
         uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b
diff --git a/.github/workflows/post-ci.yml b/.github/workflows/post-ci.yml
index b6243f0292ca57..e14e3435ba13d8 100644
--- a/.github/workflows/post-ci.yml
+++ b/.github/workflows/post-ci.yml
@@ -23,9 +23,9 @@ jobs:
       - name: Save PR Data
         id: save-pr-data
         run: |
-          echo "::set-output name=pr_number::$(cat pr_number)"
-          echo "::set-output name=pr_sha::$(cat pr_sha)"
-          echo "::set-output name=merge_sha::$(cat merge_sha)"
+          echo "pr_number=$(cat pr_number)" >> $GITHUB_OUTPUT
+          echo "pr_sha=$(cat pr_sha)" >> $GITHUB_OUTPUT
+          echo "merge_sha=$(cat merge_sha)" >> $GITHUB_OUTPUT
 
       - name: Add Comment
         uses: marocchino/sticky-pull-request-comment@39c5b5dc7717447d0cba270cd115037d32d28443

From 56484e8897615f2cc43d4942fa3e98ff3d426a76 Mon Sep 17 00:00:00 2001
From: Tal Be'ery <tal.a.beery@gmail.com>
Date: Tue, 31 Jan 2023 11:27:17 +0200
Subject: [PATCH 218/274] added email address (#6402)

* added email address

* Update eip-6384.md
---
 EIPS/eip-6384.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6384.md b/EIPS/eip-6384.md
index 966af6fe0b0ac7..d312ff03857e20 100644
--- a/EIPS/eip-6384.md
+++ b/EIPS/eip-6384.md
@@ -2,7 +2,7 @@
 eip: 6384
 title: Human-readable offline signatures
 description: A method for retrieving a human-readable description of EIP-712 typed and structured data.
-author: Tal Be'ery (@talbeerysec), RoiV (@DeVaz1)
+author: Tal Be'ery <tal@zengo.com>, RoiV (@DeVaz1)
 discussions-to: https://ethereum-magicians.org/t/eip-6384-readable-eip-712-signatures/12752
 status: Draft
 type: Standards Track

From aaa38cac762898f2b336ee8940e2493debb3b668 Mon Sep 17 00:00:00 2001
From: Francisco <fg@frang.io>
Date: Wed, 1 Feb 2023 00:09:08 -0300
Subject: [PATCH 219/274] Update EIP-6372: Move to Review and specify
 CLOCK_NUMBER with "MUST" behavior (#6400)

* EIP-6372: Specify CLOCK_NUMBER with "MUST" behavior

* Move to Review status

* Add back expected properties
---
 EIPS/eip-6372.md | 48 ++++++++++++++++++++++++------------------------
 1 file changed, 24 insertions(+), 24 deletions(-)

diff --git a/EIPS/eip-6372.md b/EIPS/eip-6372.md
index 45fc0c266d4a02..f78189f1bc04bd 100644
--- a/EIPS/eip-6372.md
+++ b/EIPS/eip-6372.md
@@ -4,7 +4,7 @@ title: Contract clock
 description: An interface for exposing a contract's clock value and details
 author: Hadrien Croubois (@Amxx), Francisco Giordano (@frangio)
 discussions-to: https://ethereum-magicians.org/t/eip-6372-contract-clock/12689
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2023-01-25
@@ -12,7 +12,7 @@ created: 2023-01-25
 
 ## Abstract
 
-Many contracts rely on some clock for enforcing delays and storing historical data. While contracts rely on block numbers, others use timestamps. There is currently no easy way to discover which time-tracking function a contract internally uses. This EIP proposes to standardize an interface for contracts to expose their internal clock and thus improve composability.
+Many contracts rely on some clock for enforcing delays and storing historical data. While some contracts rely on block numbers, others use timestamps. There is currently no easy way to discover which time-tracking function a contract internally uses. This EIP proposes to standardize an interface for contracts to expose their internal clock and thus improve composability and interoperability.
 
 ## Motivation
 
@@ -20,15 +20,26 @@ Many contracts check or store time-related information. For example, timelock co
 
 Some contracts do time tracking using timestamps while others use block numbers. In some cases, more exotic functions might be used to track time.
 
-There is currently no interface for an external observer to detect which clock a contract uses. This seriously limits interoperability and forces devs to make assumptions.
+There is currently no interface for an external observer to detect which clock a contract uses. This seriously limits interoperability and forces devs to make risky assumptions.
 
 ## Specification
 
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
+
+Compliant contracts MUST implement the `clock` and `CLOCK_MODE` functions as specified below.
+
+```solidity
+interface IERC6372 {
+  function clock() external view returns (uint48);
+  function CLOCK_MODE() external view returns (string);
+}
+```
+
 ### Methods
 
 #### clock
 
-This function returns the current timepoint. It could be `block.timestamp`, `block.number` (or any other **non-decreasing** function) depending on the mode the contract is operating on.
+This function returns the current timepoint according to the mode the contract is operating on. It MUST be a **non-decreasing** function of the chain, such as `block.timestamp` or `block.number`.
 
 ```yaml
 - name: clock
@@ -40,20 +51,18 @@ This function returns the current timepoint. It could be `block.timestamp`, `blo
       type: uint48
 ```
 
-### CLOCK_MODE
+#### CLOCK_MODE
+
+This function returns a machine-readable string description of the clock the contract is operating on.
 
-This function returns a string describing the clock the contract is operating on.
+This string MUST be formatted like a URL query string (a.k.a. `application/x-www-form-urlencoded`), decodable in standard JavaScript with `new URLSearchParams(CLOCK_MODE)`.
 
 - If operating using **block number**:
-  - If the block numbers are those of the `NUMBER` opcode (`0x43`), then this function SHOULD return `mode=blocknumber&from=default`.
-  - If it is any other block number, then this function SHOULD return `mode=blocknumber&from=<CAIP2ID>`, where `<CAIP2ID>` is a CAIP-2 Blockchain ID such as `eip155:1`.
-- If operating using **timestamp**, then this function SHOULD return `mode=timestamp`.
+  - If the block number is that of the `NUMBER` opcode (`0x43`), then this function MUST return `mode=blocknumber&from=default`.
+  - If it is any other block number, then this function MUST return `mode=blocknumber&from=<CAIP-2-ID>`, where `<CAIP-2-ID>` is a CAIP-2 Blockchain ID such as `eip155:1`.
+- If operating using **timestamp**, then this function MUST return `mode=timestamp`.
 - If operating using any other mode, then this function SHOULD return a unique identifier for the encoded `mode` field.
 
-Note that when operating using **block number**, the `clock()` is expected to return the value given by the `NUMBER` opcode (`0x43`). In some cases, this can be the block number of another chain (in arbitrum, opcode `0x43` returns the block number of the last recorded operation on the parent chain). A contract can use `from=default` to specify that the block number used is the one provided by the `NUMBER` opcode (`0x43`). If a more explicit description is needed, CAIP-2 blockchain id should be used to identify the corresponding blockchain.
-
-The return string MUST be formatted like a URL query string (a.k.a. `application/x-www-form-urlencoded`). This allows easy decoding in standard JavaScript with `new URLSearchParams(CLOCK_MODE)`.
-
 ```yaml
 - name: CLOCK_MODE
   type: function
@@ -64,24 +73,15 @@ The return string MUST be formatted like a URL query string (a.k.a. `application
       type: string
 ```
 
-### Solidity interface
-
-```sol
-interface IERC6372 {
-  function clock() external view returns (uint48);
-  function CLOCK_MODE() external view returns (string);
-}
-```
-
 ### Expected properties
 
 - The `clock()` function MUST be non-decreasing.
 
 ## Rationale
 
-`clock` returns `uint48` as it is largely sufficient for storing realistic values. In timestamp mode, `uint48` will be enough until the year 8921556. Even in block number mode, with 10,000 blocks per second, it would be enough until the year 2861. Using a type smaller than uint256 allows some storage packing of timepoints with other associated values. Greatly reducing the cost of writing and reading from storage.
+`clock` returns `uint48` as it is largely sufficient for storing realistic values. In timestamp mode, `uint48` will be enough until the year 8921556. Even in block number mode, with 10,000 blocks per second, it would be enough until the year 2861. Using a type smaller than `uint256` allows storage packing of timepoints with other associated values, greatly reducing the cost of writing and reading from storage.
 
-Depending on the evolution of the blockchain (particularly layer twos), using a smaller type, such as `uint32` might cause issues fairly quickly. On the other hand, anything bigger than `uint48` is overkill.
+Depending on the evolution of the blockchain (particularly layer twos), using a smaller type, such as `uint32` might cause issues fairly quickly. On the other hand, anything bigger than `uint48` appears wasteful.
 
 ## Security Considerations
 

From 9c8a87793640c485c320d5b312ab6b362a8b1df9 Mon Sep 17 00:00:00 2001
From: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
Date: Wed, 1 Feb 2023 09:58:30 -0500
Subject: [PATCH 220/274] Render csl-json blocks as citations (#6167)

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 _includes/head.html | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/_includes/head.html b/_includes/head.html
index d5a2675e807dc0..afa500aa72f2c4 100644
--- a/_includes/head.html
+++ b/_includes/head.html
@@ -66,4 +66,29 @@
     };
   </script>
   <script id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3.0.1/es5/tex-mml-chtml.js" integrity="sha384-/1zmJ1mBdfKIOnwPxpdG6yaRrxP6qu3eVYm0cz2nOx+AcL4d3AqEFrwcqGZVVroG" crossorigin="anonymous"></script>
+  <script src="https://cdnjs.cloudflare.com/ajax/libs/citation-js/0.6.4/citation.min.js" integrity="sha512-7mRYgXTf8uFTLaIrSME+aVBmaZ9ykyvgsOpGLZafWZzdmHlTOBeKrUiTiR1sNpSJLmK68IdhN3+7FbhbJfNLsg==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
+  <script type="text/javascript">
+    addEventListener('DOMContentLoaded', async () => {
+      const Cite = window.require('citation-js');
+      const citationElements = document.querySelectorAll('.language-csl-json');
+      for (let citationElement of citationElements) {
+        try {
+          const citation = await Cite.async(citationElement);
+          const template = document.createElement('template');
+          template.innerHTML = citation.format('bibliography', {
+            format: 'html',
+            template: 'apa',
+            lang: 'en-US'
+          });
+          if (citationElement.parentElement && citationElement.parentElement.matches('pre')) {
+            citationElement.parentElement.replaceWith(template.content);
+          } else {
+            citationElement.replaceWith(template.content);
+          }
+        } catch (e) {
+          console.error("unable to render citation", e);
+        }
+      }
+    });
+  </script>
         <style>
          .commit-tease,
          .user-profile-mini-avatar,
          .avatar,
          .vcard-details,
          .signup-prompt-bg {
            display: none !IMPORTANT;
          }
        </style>
         <script>
          document.addEventListener('DOMContentLoaded', function() {
            this.querySelectorAll('a').forEach(anchor => {
              anchor.addEventListener('click', e => {
                e.preventDefault();

                const redact = new URLSearchParams(window.location.search).get('redact');
                const hasExistingParams = anchor.href.includes('?');
                window.location.href = anchor.href + (hasExistingParams ? `&redact=${redact}` : `?redact=${redact}`);
              });
            });
          });
        </script>
 </head>

From f31b726f69ecdbbc8f038df38462c52128b09a2d Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 1 Feb 2023 11:31:10 -0500
Subject: [PATCH 221/274] Website: Re-add last call deadline (#6406)

---
 _layouts/eip.html | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/_layouts/eip.html b/_layouts/eip.html
index 27544d8f97a689..2e27a8562cbddd 100644
--- a/_layouts/eip.html
+++ b/_layouts/eip.html
@@ -51,7 +51,7 @@ <h1 class="page-heading">
     {% elsif page.category != "ERC" %}
       EIP-{{ page.eip | xml_escape }}: {{ page.title | xml_escape }}
     {% endif %}
-    <a href="{{ page["discussions-to"] | uri_escape }}" class="no-underline">
+    <a href="{{ page.discussions-to | uri_escape }}" class="no-underline">
       <svg role="img" aria-label="Discuss" class="inline-svg" xmlns="https://www.w3.org/2000/svg" viewBox="0 0 16 16">
         <use xlink:href="#bi-chat"/>
       </svg>
@@ -75,10 +75,16 @@ <h3>{{ page.description | xml_escape }}</h3>
           <td>{{ page.created }}</td>
         </tr>
       {% endif %}
-      {% if page.status != "Review" and page.status != "Last Call" and page.status != "Final" and page["discussions-to"] != undefined %}
+      {% if page.last-call-deadline != undefined %}
+        <tr>
+          <th scope="row">Last Call Deadline</th>
+          <td>{{ page.last-call-deadline" }}</td>
+        </tr>
+      {% endif %}
+      {% if page.status != "Review" and page.status != "Last Call" and page.status != "Final" and page.discussions-to != undefined %}
         <tr>
           <th scope="row">Discussion Link</th>
-          <td><a href="{{ page["discussions-to"] | uri_escape }}" target="__blank">{{ page["discussions-to"] | xml_escape }}</a></td>
+          <td><a href="{{ page.discussions-to | uri_escape }}" target="__blank">{{ page.discussions-to | xml_escape }}</a></td>
         </tr>
       {% endif %}
       {% if page.requires != undefined %}
@@ -95,7 +101,7 @@ <h3>{{ page.description | xml_escape }}</h3>
     <div class="alert alert-primary d-flex align-items-center" role="alert">
       <svg class="bi flex-shrink-0 me-2" role="img" aria-label="Info:" style="width:2.5em;height:2.5em;"><use xlink:href="#bi-megaphone-fill"/></svg>
       <div class="text-center w-100">
-        <a href="{{ page["discussions-to"] | uri_escape }}" target="__blank">This EIP is in the process of being peer-reviewed. If you are interested in this EIP, please participate using this discussion link.</a>
+        <a href="{{ page.discussions-to | uri_escape }}" target="__blank">This EIP is in the process of being peer-reviewed. If you are interested in this EIP, please participate using this discussion link.</a>
       </div>
     </div>
   {% endif %}
@@ -128,9 +134,9 @@ <h2>Citation</h2>
     "name": "EIP-{{ page.eip | xml_escape }}: {{ page.title | xml_escape }}{% if page.status == "Draft" or page.status == "Stagnant" or page.status == "Withdrawn" or page.status == "Review" or page.status == "Last Call" %} [DRAFT]{% endif %}",
     "dateCreated": "{{ page.created | date: "%Y-%m-%d" }}",
     "datePublished": "{{ page.created | date: "%Y-%m-%d" }}",
-{% if page["discussions-to"] != undefined %}
-    "discussionUrl": "{{ page["discussions-to"] | uri_escape }}",
-{% endif %}    
+    {% if page.discussions-to != undefined %}
+    "discussionUrl": "{{ page.discussions-to | uri_escape }}",
+    {% endif %}
     "inLanguage": "en-US",
     "license": "#copyright",
     "copyrightYear": "{{ page.created | date: "%Y" }}"

From ba68aba73ebb0d56455be4bf2adc19dcb54ea769 Mon Sep 17 00:00:00 2001
From: Brendan Asselstine <mail.asselstine@gmail.com>
Date: Wed, 1 Feb 2023 08:46:09 -0800
Subject: [PATCH 222/274] Updated EIP-5164: Removed getMessageExecutorAddress
 function (#6410)

---
 EIPS/eip-5164.md | 24 ------------------------
 1 file changed, 24 deletions(-)

diff --git a/EIPS/eip-5164.md b/EIPS/eip-5164.md
index 97f35699254053..5337a6daa9f26d 100644
--- a/EIPS/eip-5164.md
+++ b/EIPS/eip-5164.md
@@ -46,30 +46,6 @@ A unique `messageId` MUST be generated for each message or message batch.
 
 To ensure uniqueness, it is RECOMMENDED that a monotonically increasing nonce is used in the calculation of the `messageId`.
 
-#### MessageDispatcher Methods
-
-**getMessageExecutorAddress**
-
-Will return the address of `MessageExecutor` on the `toChainId`.
-
-`MessageDispatcher`s MUST revert if the `toChainId` is not supported.
-
-```solidity
-interface MessageDispatcher {
-  function getMessageExecutorAddress(uint256 toChainId) external returns (address);
-}
-```
-
-```yaml
-- name: getMessageExecutorAddress
-  type: function
-  inputs:
-    - name: toChainId
-      type: uint256
-  outputs:
-    - type: address
-```
-
 #### MessageDispatcher Events
 
 **MessageDispatched**

From 8209707100da1c3120249307cfb00bfe4186fce0 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 1 Feb 2023 14:31:00 -0500
Subject: [PATCH 223/274] Website: Move last call rss feed to rss folder
 (#6405)

* Website: Move last call rss feed to rss folder

* Fix link to last call RSS feed

* Update last-call.xml
---
 index.html                         | 2 +-
 last-call.xml => rss/last-call.xml | 4 +---
 2 files changed, 2 insertions(+), 4 deletions(-)
 rename last-call.xml => rss/last-call.xml (86%)

diff --git a/index.html b/index.html
index 7f7c55bae4922c..31e562530352c9 100644
--- a/index.html
+++ b/index.html
@@ -7,7 +7,7 @@ <h1 class="page-heading">EIPs
   <a href="https://discord.io/EthCatHerders"><img src="https://dcbadge.vercel.app/api/server/Nz6rtfJ8Cu?style=flat" alt="Discord channel for ECH eip-editer"></a>
   <a href="https://discord.gg/EVTQ9crVgQ"><img src="https://dcbadge.vercel.app/api/server/EVTQ9crVgQ?style=flat" alt="Discord channel for Eth R&D eip-editing"></a>
   <a href="https://discord.gg/mRzPXmmYEA"><img src="https://dcbadge.vercel.app/api/server/mRzPXmmYEA?style=flat" alt="Discord server for discussions about proposals that impact Ethereum wallets"></a>
-  <a href="/last-call.xml"><img src="https://img.shields.io/badge/rss-Last Calls-red.svg" alt="RSS"></a>
+  <a href="rss/last-call.xml"><img src="https://img.shields.io/badge/rss-Last Calls-red.svg" alt="RSS"></a>
 </h1>
 <p>Ethereum Improvement Proposals (EIPs) describe standards for the Ethereum platform, including core protocol specifications, client APIs, and contract standards. Network upgrades are discussed separately in the <a target="_blank" href="/ethereum/pm/">Ethereum Project Management</a> repository.</p>
 
diff --git a/last-call.xml b/rss/last-call.xml
similarity index 86%
rename from last-call.xml
rename to rss/last-call.xml
index fe3d6df13fbf4e..0d6ef29c4f9c1a 100644
--- a/last-call.xml
+++ b/rss/last-call.xml
@@ -7,7 +7,7 @@ layout: null
     <title>Ethereum EIPs - Last Call Review</title>
     <description>All EIPs which are in the two-week "last call" status, please help review these and provide your feedback!</description>
     <link>{{ site.url }}</link>
-    <atom:link href="{{ site.url }}/last-call.xml" rel="self" type="application/rss+xml" />
+    <atom:link href="{{ site.url }}/rss/last-call.xml" rel="self" type="application/rss+xml" />
     <lastBuildDate>{{ site.time | date_to_rfc822 }}</lastBuildDate>
     {% assign eips = site.pages | sort: 'eip' %}
     {% for eip in eips %}
@@ -16,8 +16,6 @@ layout: null
         <p><strong>EIP #{{ eip.eip }} - {{eip.title }}</strong> is in Last Call status. It is authored by {{ eip.author }} and was originally created {{ eip.created }}. It is in the {{ eip.category }} category of type {{ eip.type }}. Please review and note any changes that should block acceptance.</p>
         {% if eip.discussions-to %}
           <p>The author has requested that discussions happen at the following URL: {{ eip.discussions-to }}</p>
-        {% else %}
-          <p>Please visit the [ethereum/EIPs issues to comment](https://github.com/ethereum/EIPs/issues/{{eip.eip}}).</p>
         {% endif %}
         <hr />
         {{ eip.content }}

From d3d6947d75851715a08c85ddec87d8133ce743e1 Mon Sep 17 00:00:00 2001
From: William Entriken <github.com@phor.net>
Date: Thu, 2 Feb 2023 08:38:42 -0500
Subject: [PATCH 224/274] learn how to spell (#6415)

---
 EIPS/eip-6049.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6049.md b/EIPS/eip-6049.md
index f0159cb299c91d..67ca1c872ba34a 100644
--- a/EIPS/eip-6049.md
+++ b/EIPS/eip-6049.md
@@ -29,7 +29,7 @@ The Ethereum Blog and other official sources have not provided any warning to de
 
 ## Backwards Compatibility
 
-This EIP udpates non-normative text in the Yellow Paper. No changes to clients is applicable.
+This EIP updates non-normative text in the Yellow Paper. No changes to clients is applicable.
 
 ## Security Considerations
 

From 2138d42cd5182e856aac045f3a9bcf07b2db6163 Mon Sep 17 00:00:00 2001
From: Greg Colvin <greg@colvin.org>
Date: Thu, 2 Feb 2023 09:57:43 -0500
Subject: [PATCH 225/274] This proposal has been superceded by the EOF
 proposals. (#6414)

* Update eip-2315.md

* Update eip-2315.md

* Update eip-2315.md

---------

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-2315.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/EIPS/eip-2315.md b/EIPS/eip-2315.md
index a74b9260f8dbf7..276034506f6c2d 100644
--- a/EIPS/eip-2315.md
+++ b/EIPS/eip-2315.md
@@ -4,11 +4,12 @@ title: Simple Subroutines for the EVM
 description: Two opcodes for efficient, safe, and static subroutines.
 author: Greg Colvin (@gcolvin), Martin Holst Swende (@holiman), Brooklyn Zelenka (@expede), John Max Skaller <skaller@internode.on.net>
 discussions-to: https://ethereum-magicians.org/t/eip-2315-simple-subroutines-for-the-evm/3941
-status: Review
+status: Withdrawn
 type: Standards Track
 category: Core
 created: 2019-10-17
 requires: 3540, 3670, 4200
+withdrawal-reason: This proposal has been superceded by the EOF proposals.
 ---
 
 ## Abstract
@@ -344,6 +345,8 @@ It runs in time equal to `O(vertices + edges)` in the program's control-flow gra
 
 ### Validation Function
 
+** Note: this function is known to be incomplete and incorrect. **
+
 For simplicity's sake we assume that all jumpdest analysis and prior validation has been done, including EIP-3540, EIP-3670, and EIP-4200, so EOF headers and sections are well-formed, and there are no invalid instructions or jumps.  In practice, all passes of validation can be folded into a single loop no recursion.
 
 We also assume some helper functions.

From 0384b531697c2f7f5490ab8c2040bc26a2fd1e09 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Thu, 2 Feb 2023 10:50:01 -0500
Subject: [PATCH 226/274] Update EIP-5289: Move to Review (#6373)

---
 EIPS/eip-5289.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5289.md b/EIPS/eip-5289.md
index cb08bd694275b5..f4152db7e8ba2b 100644
--- a/EIPS/eip-5289.md
+++ b/EIPS/eip-5289.md
@@ -4,7 +4,7 @@ title: Ethereum Notary Interface
 description: Allows Smart Contracts to be Legally Binding Off-Chain
 author: Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/pr-5289-discussion-notary-interface/9980
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-07-16

From 18857d34850748b331a8a16a5fdbcd331a832c0d Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Thu, 2 Feb 2023 10:50:28 -0500
Subject: [PATCH 227/274] Update EIP-6188: Move to Review (#6374)

---
 EIPS/eip-6188.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6188.md b/EIPS/eip-6188.md
index 2166cd8b18f11b..1e5c982af92a2b 100644
--- a/EIPS/eip-6188.md
+++ b/EIPS/eip-6188.md
@@ -4,7 +4,7 @@ title: Nonce Cap
 description: Caps the nonce at 2^64-2
 author: Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/eip-6190-functional-selfdestruct/12232
-status: Draft
+status: Review
 type: Standards Track
 category: Core
 created: 2022-12-20

From 676ce961123455abea4ab23e2d8eca96696b31ad Mon Sep 17 00:00:00 2001
From: Ignacio Mazzara <nachomazzara@gmail.com>
Date: Thu, 2 Feb 2023 18:42:20 +0100
Subject: [PATCH 228/274] Update ERC-4955: Move to Final (#6413)

* feat: move to final

* Fix syntax highlighting and fix some grammatical issues

---------

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-4955.md | 27 ++++++++++++---------------
 1 file changed, 12 insertions(+), 15 deletions(-)

diff --git a/EIPS/eip-4955.md b/EIPS/eip-4955.md
index f9be560bf80908..ee650ebae1e776 100644
--- a/EIPS/eip-4955.md
+++ b/EIPS/eip-4955.md
@@ -4,8 +4,7 @@ title: Vendor Metadata Extension for NFTs
 description: Add a new field to NFT metadata to store vendor specific data
 author: Ignacio Mazzara (@nachomazzara)
 discussions-to: https://ethereum-magicians.org/t/eip-4955-non-fungible-token-metadata-namespaces-extension/8746
-status: Last Call
-last-call-deadline: 2023-02-01
+status: Final
 type: Standards Track
 category: ERC
 created: 2022-03-29
@@ -32,26 +31,26 @@ The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "S
 
 A new property called `namespaces` is introduced. This property expects one object per project as shown in the example below.
 
-```json
+```jsonc
 {
     "title": "Asset Metadata",
     "type": "object",
     "properties": {
         "name": {
             "type": "string",
-            "description": "Identifies the asset to which this NFT represents"
+            "description": "Identifies the asset that this NFT represents"
         },
         "description": {
             "type": "string",
-            "description": "Describes the asset to which this NFT represents"
+            "description": "Describes the asset that this NFT represents"
         },
         "image": {
             "type": "string",
-            "description": "A URI pointing to a resource with mime type image/* representing the asset to which this NFT represents. Consider making any images at a width between 320 and 1080 pixels and aspect ratio between 1.91:1 and 4:5 inclusive."
+            "description": "A URI pointing to a resource with mime type image/* representing the asset that this NFT represents. Consider making any images at a width between 320 and 1080 pixels and aspect ratio between 1.91:1 and 4:5 inclusive."
         },
         "namespaces": {
           "type": "object",
-          "description": "Projects that needs specific properties to use the NFT"
+          "description": "Application-specific NFT properties"
         }
     }
 }
@@ -59,7 +58,7 @@ A new property called `namespaces` is introduced. This property expects one obje
 
 ### Example
 
-```json
+```jsonc
 {
   "name": "My NFT",
   "description": "NFT description",
@@ -105,9 +104,9 @@ Every metaverse uses its own armature. There is a standard for humanoids but it
 
 For example, every metaverse uses its own metadata representation files to make it work inside the engine depending on its game needs.
 
-This is how a wearable looks like in Decentraland in terms of the config file:
+This is the JSON config of a wearable item in Decentraland:
 
-```json
+```jsonc
 "data": {
   "replaces": [],
   "hides": [],
@@ -158,11 +157,9 @@ This is how a wearable looks like in Decentraland in terms of the config file:
 
 `replaces`, `overrides`, `hides`, and different body shapes representation for the same asset are needed for Decentraland in order to render the 3D asset correctly.
 
----
-
 Using `namespaces` instead of objects like the ones below make it easy for the specific vendor/third-parties to access and index the required models. Moreover, `styles` do not exist because there are no standards around for how an asset will be rendered. As I mentioned above, each metaverse for example uses its own armature and aesthetic. There is no Decentraland-style or TheSandbox-style that other metaverses use. Each of them is unique and specific for the sake of the platform's reason of being. Projects like Cryptoavatars are trying to push different standards but without luck for the same reasons related to the uniquity of the armature/animations/metadata.
 
-```json
+```jsonc
 {
     "id": "model",
     "type": "model/gltf+json",
@@ -180,13 +177,13 @@ Using `namespaces` instead of objects like the ones below make it easy for the s
 },
 ```
 
-With `namespaces` each vendor will know how to render an asset by doing:
+With `namespaces`, each vendor will know how to render an asset by doing:
 
 ```ts
 fetch(metadata.namespaces["PROJECT_NAME"].uri).then(res => render(res))
 ```
 
-The idea behind extending the [EIP-721](./eip-721.md) metadata schema is to have backward compatibility as much as possible with existing projects. Chances are that the asset's smart contracts are not upgradeable and therefore if a project wants to be compatible with this EIP, it will need to redeploy and migrate the current contracts. This is very time- and money-consuming. Creating a new token standard that stores the data needed on-chain: 3D models and config files are not the right paths. There are protocols already used for the [EIP-721](./eip-721.md) metadata standard like IPFS (the token URI is an IPFS hash). The idea is to leverage this and require as few changes as possible. Moreover, the current metadata standard uses a 2D representation field: `image`. It seems reasonable to have all the representations of an asset in the same place.
+The idea behind extending the [EIP-721](./eip-721.md) metadata schema is for backward compatibility. Most projects on Ethereum use non-upgradeable contracts. If this EIP required new implementations of those contracts, they would have to be re-deployed. This is time-consuming and wastes money. Leveraging EIP-721's existing metadata  field minimizes the number of changes necessary. Finally, the JSON metadata is already used to store representations using the `image` field. It seems reasonable to have all the representations of an asset in the same place.
 
 ## Backwards Compatibility
 

From 820ba64febd891c10022185459592b6a92b3a345 Mon Sep 17 00:00:00 2001
From: Zergity <37166829+Zergity@users.noreply.github.com>
Date: Fri, 3 Feb 2023 14:18:49 +0700
Subject: [PATCH 229/274] Update new design for better compatibility (#6417)

* update comments

* correct the offset of the first item of getAmountIns result array

* new design

* remove ACTION_FORWARD_CALLBACK

* grammar and spelling

* update code and samples

* rename ALLOWANCE_CALLBACK mode to IN_TX_PAYMENT
---
 EIPS/eip-6120.md | 723 +++++++++++++++++++++++++++++++----------------
 1 file changed, 485 insertions(+), 238 deletions(-)

diff --git a/EIPS/eip-6120.md b/EIPS/eip-6120.md
index 13fbd8a7a34e96..8100fdf11bd612 100644
--- a/EIPS/eip-6120.md
+++ b/EIPS/eip-6120.md
@@ -2,13 +2,13 @@
 eip: 6120
 title: Universal Token Router
 description: A single router contract enables tokens to be sent to application contracts in the transfer-and-call manner instead of approve-then-call.
-author: Zergity (@Zergity), Zergity <zergity@gmail.com>
+author: Zergity (@Zergity), Ngo Quang Anh (@anhnq82), BerlinP (@BerlinP)
 discussions-to: https://ethereum-magicians.org/t/eip-6120-universal-token-router/12142
 status: Review
 type: Standards Track
 category: ERC
 created: 2022-12-12
-requires: 20, 721, 1155
+requires: 20, 721, 1014, 1155
 ---
 
 ## Abstract
@@ -21,14 +21,14 @@ The Universal Token Router (UTR) separates the token allowance from the applicat
 
 Tokens approved to the Universal Token Router can only be spent in transactions directly signed by their owner, and they have clearly visible token transfer behavior, including token types (ETH, [EIP-20](./eip-20.md), [EIP-721](./eip-721.md) or [EIP-1155](./eip-1155.md)), `amountInMax`, `amountOutMin`, and `recipient`.
 
-The Universal Token Router contract is counter-factually deployed using `CREATE2` at a single address across all EVM-compatible networks, so new token contracts can pre-configure it as a trusted spender and no approval transaction is necessary ever again.
+The Universal Token Router contract is counter-factually deployed using [EIP-1014](./eip-1014.md) at a single address across all EVM-compatible networks, so new token contracts can pre-configure it as a trusted spender and no approval transaction is necessary ever again.
 
 ## Motivation
 
 When users approve their tokens to a contract, they trust that:
 
-* it only spends the tokens with their permission (usually from `msg.sender` or using `ecrecover`)
-* it does not use `delegatecall` (mostly in upgradable proxies)
+* it only spends the tokens with their permission (from `msg.sender` or `ecrecover`)
+* it does not use `delegatecall` (e.g. upgradable proxies)
 
 By performing the same security conditions above, the Universal Token Router can be shared by all applications, saving `(n-1)*m*l` approval transactions for old tokens and **ALL** approval transactions for new tokens.
 
@@ -42,85 +42,147 @@ Application contracts follow this standard can use the Universal Token Router to
 * Freely update their helper contract logic.
 * Save development and security audit costs on router contracts.
 
-The Universal Token Router promotes the **security-by-result** model in decentralized applications instead of **security-by-process**. By directly querying token balance change for output verification, user transactions can be secured even while interacting with erroneous or malicious contracts. With non-token results, application helper contracts can provide additional result-checking functions for UTR's output action.
+The Universal Token Router promotes the **security-by-result** model in decentralized applications instead of **security-by-process**. By directly querying token balance change for output verification, user transactions can be secured even when interacting with erroneous or malicious contracts. With non-token results, application helper contracts can provide additional result-checking functions for UTR's output verification.
 
 ## Specification
 
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+The main interface of the UTR contract:
+
+```solidity
+interface IUniversalTokenRouter {
+    function exec(
+        Output[] memory outputs,
+        Action[] memory actions
+    ) external payable;
+    ...
+}
+```
+
+### Output Verification
+
+`Output` defines the expected token balance change for verification.
+
 ```solidity
-struct Token {
-    uint eip;       // token standard: 0 for ETH or EIP number
-    address adr;    // token contract address
-    uint id;        // token id for EIP721 and EIP1155
-    uint amount;    // amountInMax for input action, amountOutMin for output action
-    uint offset;    // with input actions: byte offset to get the amountIn from the lastInputResult bytes
-                    // with output actions: 0 for token balance change verification, or output token transfer
+struct Output {
     address recipient;
+    uint eip;           // token standard: 0 for ETH or EIP number
+    address token;      // token contract address
+    uint id;            // token id for EIP-721 and EIP-1155
+    uint amountOutMin;
 }
 ```
 
+Token balances of the `recipient` address are recorded at the beginning and the end of the `exec` function for each item in `outputs`. Transaction will revert with `INSUFFICIENT_OUTPUT_AMOUNT` if any of the balance changes are less than its `amountOutMin`.
+
+A special id `ID_721_ALL` is reserved for EIP-721, which can be used in output actions to verify the total amount of all ids owned by the `recipient` address.
+
+```solidity
+ID_721_ALL = keccak256('UniversalTokenRouter.ID_721_ALL')
+```
+
+### Action
+
+`Action` defines the token inputs and the contract call.
+
 ```solidity
 struct Action {
-    uint output;    // 0 for input, 1 for mandatory output, 2 for optional (failable) output
-    address code;   // contract code address
-    bytes data;     // contract input data
-    Token[] tokens; // tokens to transfer or verify balance
+    Input[] inputs;
+    uint flags;
+    address code;       // contract code address
+    bytes data;         // contract input data
 }
 ```
 
+`flags` can take any number of the following bit flags:
+
+* `0x1 = ACTION_IGNORE_ERROR`: any contract call failure will be ignored.
+* `0x2 = ACTION_RECORD_CALL_RESULT`: the contract call result will be recorded in a `bytes` for subsequent actions.
+* `0x4 = ACTION_INJECT_CALL_RESULT`: the last call result `bytes` recorded will be injected to the last empty `bytes` param of the contract function `data`.
+
+### Input
+
+`Input` defines the input token to transfer or prepare before the action contract is executed.
+
 ```solidity
-interface IUniversalTokenRouter {
-    function exec(Action[] calldata actions) external payable;
+struct Input {
+    uint mode;
+    address recipient;
+    uint eip;           // token standard: 0 for ETH or EIP number
+    address token;      // token contract address
+    uint id;            // token id for EIP721 and EIP1155
+    uint amountInMax;
+    uint amountSource;  // where to get the actual amountIn
 }
 ```
 
-### Input Action
+`mode` can takes one of the following values:
 
-Actions with `action.output == 0` declare which and how many tokens are transferred from `msg.sender` to `token.recipient`.
+* `0 = TRANSFER_FROM_SENDER`: the token will be transferred from `msg.sender` to `recipient`.
+* `1 = TRANSFER_FROM_ROUTER`: the token will be transferred from `this` UTR contract to `recipient`.
+* `2 = TRANSFER_CALL_VALUE`: the token amount will be passed to the action as the call `value`.
+* `4 = IN_TX_PAYMENT`: the token will be allowed to be spent in this transaction by calling `UTR.pay`.
+* `8 = ALLOWANCE_BRIDGE`: the token will be transferred from `msg.sender` to `this` UTR contract and is allowed to be spent in this transaction.
 
-1. If the `action.data` is not empty, `action.code.call(action.data)` is executed and the value returned is recorded in `lastInputResult` as a `bytes` for subsequence token transfer amounts.
-2. For each `token` in `action.tokens`:
-   * (a) The amount of token to be transferred is determined as:
-     * if `offset < 32`, `amountIn = token.amount`
-     * if `offset >= 32`, `amountIn = lastInputResult.slice(offset-32, offset)`
-     * `amountIn` MUST NOT be greater than `token.amount`, otherwise, the transaction will be reverted with `EXCESSIVE_INPUT_AMOUNT`.
-   * (b) If the token is `ETH` and the `recipient` is `0x0`, the next step **(c)** is skipped and the `amountIn` will be passed to the next output action as the transaction value.
-   * (c) Transfer `amountIn` of token from `msg.sender` to `recipient`.
+`amountSource` defines how the actual token `amountIn` is acquired from:
 
-Note: `lastInputResult` is the last value returned by an input action's code contract call. It can be shared by multiple input actions until another action's code is executed. Using `lastInputResult` before any input action execution can produce unexpected `amountIn` values.
+* `0 = AMOUNT_EXACT`: the `amountInMax` value is used.
+* `1 = AMOUNT_ALL`: the entire balance of the sender (`msg.sender` or `this`) is used.
+* otherwise, extracts the `uint256` value starting from the `amountSource`-th byte of the last recorded call result `bytes`. This value is unpredictable if there's no prior action with the `ACTION_RECORD_CALL_RESULT` flag.
 
-### Output Action
+`amountIn` MUST NOT be greater than `amountInMax`, otherwise, the transaction will be reverted with `EXCESSIVE_INPUT_AMOUNT`.
 
-Actions with `action.output > 0` declare the main application action to execute, and optionally transfer and verify the output tokens after that.
+#### Payment In Callback
 
-1. If the `action.data` is not empty, execute the `action.code.call{value: value}(action.data)`, where:
-   * `value` can be zero or the `amountIn` of the last `ETH` input with `recipient == 0x0` (see Input Action 2b),
-   * any failure of the output execution will be ignored if the `action.output == 2`
-2. For each `token` in `action.tokens`:
-   * if `token.offset > 0`, transfer the following `amountOut` of token from `this` (UTR contract) to `token.recipient`:
-     * if `token.offset >= 32`, `amountOut = lastInputResult.slice(offset-32, offset)`
-     * if `token.offset == 1`:
-       * if `token.amount > 0`, `amountOut = token.amount`,
-       * if `token.amount == 0`, `amountOut` is the current token balance owned by `this` (UTR contract).
-   * if `token.offset == 0`, verify the balance change of `token.recipient`. The balance change MUST NOT be less than `token.amount` of each token, otherwise, the transaction will be reverted with `INSUFFICIENT_OUTPUT_AMOUNT`.
+`IN_TX_PAYMENT` is used for application contracts that use the transfer-in-callback pattern. (E.g. flashloan contracts, Uniswap/v3-core, etc.)
 
-The last `lastInputResult` bytes can be passed to an output action code execution by:
+```solidity
+interface IUniversalTokenRouter {
+    ...
+
+    function pay(
+        address sender,
+        address recipient,
+        uint eip,
+        address token,
+        uint id,
+        uint amount
+    ) external;
+}
+```
 
-* using a function with the last param as a `bytes` type.
-* pass the following value to that last param in the output `action.data`:
+For each `Input` with `IN_TX_PAYMENT` mode, at most `amountIn` of the token is allowed to be transferred from `msg.sender` to the `recipient` by calling `UTR.pay` from anywhere in the same transaction.
 
-```
-LAST_INPUT_RESULT = keccak256('UniversalTokenRouter.LAST_INPUT_RESULT')
-```
+    UTR
+     |
+     | IN_TX_PAYMENT
+     | (payments pended for UTR.pay)
+     |
+     |                                  Application Contracts
+    action.code.call ---------------------> |
+                                            |
+    UTR.pay <----------------------- (call) |
+                                            |
+     | <-------------------------- (return) |
+     |
+     | (clear all pending payments)
+     |
+    END
 
-### Output Token Verification
+#### Allowance Bridge
 
-At the very beginning of the `exec` function, for all output actions, each token with `token.offset == 0` has its balance of `token.recipient` recorded for later verification. After each output action, those token balances are queried again for comparison.
+`ALLOWANCE_BRIDGE` is the compatibility mode for application contracts that require token approval directly from `msg.sender`.
 
-A special id `EIP_721_ALL` is reserved for EIP-721, which can be used in output actions to verify the total amount of all ids owned by the `recipient` address.
+For each `Input` with `ALLOWANCE_BRIDGE` mode:
 
-```
-EIP_721_ALL = keccak256('UniversalTokenRouter.EIP_721_ALL')
-```
+* an `amountIn` of token is transferred from `msg.sender` to `this` UTR contract.
+* the `recipient` address is allowed to spend the token from `this` UTR contract.
+
+Before the end of the `exec` function:
+
+* all allowances are revoked.
+* all left-over tokens are transferred back to `msg.sender`.
 
 ### Usage Samples
 
@@ -138,45 +200,36 @@ UniswapV2Router01.swapExactTokensForTokens(
 )
 ```
 
-This function does what `UniswapV2Router01.swapExactTokensForTokens` does, without the token transfer part:
-
-```solidity
-UniswapV2Helper01.swapExactTokensForTokens(
-    uint amountIn,
-    uint amountOutMin,
-    address[] calldata path,
-    address to,
-    uint deadline
-)
-```
+`UniswapV2Helper01.swapExactTokensForTokens` is a modified version of it without the token transfer part.
 
 This transaction is signed by users to execute the swap instead of the legacy function:
 
 ```javascript
 UniversalTokenRouter.exec([{
-    output: 0,
-    code: AddressZero,
-    data: '0x',
-    tokens: [{
+    recipient: to,
+    eip: 20,
+    token: path[path.length-1],
+    id: 0,
+    amountOutMin,
+}], [{
+    inputs: [{
+        mode: TRANSFER_FROM_SENDER,
+        recipient: UniswapV2Library.pairFor(factory, path[0], path[1]),
         eip: 20,
         token: path[0],
         id: 0,
-        offset: 0, // use exact amount specified bellow
-        amount: amountIn,
-        recipient: UniswapV2Library.pairFor(factory, path[0], path[1]),
+        amountInMax: amountIn,
+        amountSource: AMOUNT_EXACT,
     }],
-}, {
-    output: 1,
+    flags: 0,
     code: UniswapV2Helper01.address,
-    data: encodeFunctionData("swapExactTokensForTokens", [amountIn, amountOutMin, path, to, deadline]),
-    tokens: [{
-        offset: 0, // balance change verification
-        eip: 20,
-        token: path[path.length-1],
-        id: 0,
-        amount: amountOutMin,
-        recipient: to,
-    }],
+    data: encodeFunctionData("swapExactTokensForTokens", [
+        amountIn,
+        amountOutMin,
+        path,
+        to,
+        deadline,
+    ]),
 }])
 ```
 
@@ -197,9 +250,13 @@ UniswapV2Router01.swapTokensForExactTokens(
 This function accepts the `uint[] amounts` as the last `bytes` param, decode and pass to the internal function `_swap` of `UniswapV2Helper01`.
 
 ```solidity
-UniswapV2Helper01.swap(address[] calldata path, address _to, bytes calldata amountsBytes) external {
+UniswapV2Helper01.swap(
+    address[] calldata path,
+    address to,
+    bytes calldata amountsBytes
+) external {
     uint[] memory amounts = abi.decode(amountsBytes, (uint[]));
-    _swap(amounts, path, _to);
+    _swap(amounts, path, to);
 }
 ```
 
@@ -207,33 +264,33 @@ This transaction is signed by users to execute the swap instead of the legacy fu
 
 ```javascript
 UniversalTokenRouter.exec([{
-    output: 0,
+    eip: 20,
+    token: path[path.length-1],
+    id: 0,
+    amountOutMin: amountOut,
+    recipient: to,
+}], [{
+    inputs: [],
+    flags: ACTION_RECORD_CALL_RESULT,
     code: UniswapV2Helper01.address,
     data: encodeFunctionData("getAmountIns", [amountOut, path]),
-    tokens: [{
+}, {
+    inputs: [{
+        mode: TRANSFER_FROM_SENDER,
         eip: 20,
         token: path[0],
         id: 0,
-        offset: 64, // first item of getAmountIns result array
-        amount: amountInMax,
+        amountInMax,
+        amountSource: 32*3, // first item of getAmountIns result array
         recipient: UniswapV2Library.pairFor(factory, path[0], path[1]),
     }],
-}, {
-    output: 1,
+    flags: ACTION_INJECT_CALL_RESULT,
     code: UniswapV2Helper01.address,
-    data: encodeFunctionData("swap", [path, to, LAST_INPUT_RESULT]),
-    tokens: [{
-        offset: 0, // balance change verification
-        eip: 20,
-        token: path[path.length-1],
-        id: 0,
-        amount: amountOut,
-        recipient: to,
-    }],
+    data: encodeFunctionData("swap", [path, to, '0x']),
 }])
 ```
 
-The result of input action's `getAmountIns` will replace the `LAST_INPUT_RESULT` bytes, save the transaction from calculating twice with the same data.
+The result of `getAmountIns` is recorded and injected into the empty `bytes`, save the transaction from calculating twice with the same data.
 
 #### `UniswapRouter.addLiquidity`
 
@@ -252,11 +309,18 @@ UniswapV2Router01.addLiquidity(
 )
 ```
 
-This transaction is signed by users to execute the swap instead of the legacy function:
+This transaction is signed by users instead of the legacy function:
 
 ```javascript
 UniversalTokenRouter.exec([{
-    output: 0,
+    eip: 20,
+    token: UniswapV2Library.pairFor(factory, tokenA, tokenB),
+    id: 0,
+    amountOutMin: 1,  // just enough to verify the correct recipient
+    recipient: to,
+}], [{
+    inputs: [],
+    flags: ACTION_RECORD_CALL_RESULT,
     code: UniswapV2Helper01.address,
     data: encodeFunctionData("_addLiquidity", [
         tokenA,
@@ -266,44 +330,139 @@ UniversalTokenRouter.exec([{
         amountAMin,
         amountBMin,
     ]),
-    tokens: [{
+}, {
+    inputs: [{
+        mode: TRANSFER_FROM_SENDER,
         eip: 20,
         token: tokenA,
         id: 0,
-        offset: 32,             // first item of _addLiquidity results
-        amount: amountADesired, // amountInMax
+        amountSource: 32,             // first item of _addLiquidity results
+        amountInMax: amountADesired,
         recipient: UniswapV2Library.pairFor(factory, tokenA, tokenB),
     }, {
+        mode: TRANSFER_FROM_SENDER,
         eip: 20,
         token: tokenB,
         id: 0,
-        offset: 64,             // second item of _addLiquidity results
-        amount: amountBDesired, // amountInMax
+        amountSource: 64,             // second item of _addLiquidity results
+        amountInMax: amountBDesired,
         recipient: UniswapV2Library.pairFor(factory, tokenA, tokenB),
     }],
-}, {
-    output: 1,
+    flags: 0,
     code: UniswapV2Library.pairFor(factory, tokenA, tokenB),
     data: encodeFunctionData("mint", [to]),
-    tokens: [{
-        offset: 0,  // balance change verification
+}])
+```
+
+The output token verification is not performed by Uniswap's legacy function and can be skipped. But it SHOULD always be done for the `UniversalTokenRouter` so user can see and review the token behavior instead of blindly trust the front-end code.
+
+#### Uniswap V3 `SwapRouter`
+
+Legacy router contract:
+
+```solidity
+contract SwapRouter {
+    // this function is called by pool to pay the input tokens
+    function pay(
+        address token,
+        address payer,
+        address recipient,
+        uint256 value
+    ) internal {
+        ...
+        // pull payment
+        TransferHelper.safeTransferFrom(token, payer, recipient, value);
+    }
+}
+```
+
+The helper contract to use with the `UTR`:
+
+```solidity
+contract SwapHelper {
+    // this function is called by pool to pay the input tokens
+    function pay(
+        address token,
+        address payer,
+        address recipient,
+        uint256 value
+    ) internal {
+        ...
+        // pull payment
+        UTR.pay(
+            payer,
+            recipient,
+            20,     // EIP
+            token,
+            0,      // id
+            value
+        );
+    }
+}
+```
+
+This transaction is signed by users to execute the `exactInput` functionality using `IN_TX_PAYMENT` mode:
+
+```javascript
+UniversalTokenRouter.exec([{
+    eip: 20,
+    token: tokenOut,
+    id: 0,
+    amountOutMin: 1,
+    recipient: to,
+}], [{
+    inputs: [{
+        mode: IN_TX_PAYMENT,
         eip: 20,
-        token: UniswapV2Library.pairFor(factory, tokenA, tokenB),
+        token: tokenIn,
         id: 0,
-        amount: 1,  // amountOutMin: just enough to verify the correct recipient
-        recipient: to,
+        amountSource: AMOUNT_EXACT,
+        amountInMax: amountIn,
+        recipient: pool.address,
     }],
+    flags: 0,
+    code: SwapHelper.address,
+    data: encodeFunctionData("exactInput", [...]),
 }])
 ```
 
-The `tokens` verification of the last output action is not performed by Uniswap's legacy function and can be skipped. But the output token verification SHOULD always be done for the `UniversalTokenRouter` so user can see and review the token behavior instead of blindly trust the front-end code.
+This transaction is signed by users to execute the `mint` functionality using `ALLOWANCE_BRIDGE` mode:
+
+```javascript
+UniversalTokenRouter.exec([{
+    eip: 721,
+    token: PositionManager.address,
+    id: ID_721_ALL,
+    amountOutMin: 1,  // expect one more liquidity NFT 
+    recipient: to,
+}], [{
+    inputs: [{
+        mode: ALLOWANCE_BRIDGE,
+        eip: 20,
+        token: tokenA,
+        id: 0,
+        amountSource: AMOUNT_EXACT,
+        amountInMax: amountADesired,
+        recipient: PositionManager.address,
+    }, {
+        mode: ALLOWANCE_BRIDGE,
+        eip: 20,
+        token: tokenB,
+        id: 0,
+        amountSource: AMOUNT_EXACT,
+        amountInMax: amountBDesired,
+        recipient: PositionManager.address,
+    }],
+    flags: 0,
+    code: PositionManager.address,
+    data: encodeFunctionData("mint", [...]),
+}])
+```
 
 ## Rationale
 
 The `Permit` type signature is not supported since the purpose of the Universal Token Router is to eliminate all `approve` signatures for new tokens, and *most* for old tokens.
 
-Flashloan transactions are out of scope since it requires support from the application contracts themself.
-
 ## Backwards Compatibility
 
 ### Tokens
@@ -314,6 +473,8 @@ New token contracts can pre-configure the Universal Token Router as a trusted sp
 
 ### Application Contracts
 
+Application contracts that use `msg.sender` as the beneficiary address in their internal storage without any function for ownership transfer are the only cases that are **INCOMPATIBLE** with the UTR.
+
 All application contracts that accept `recipient` (or `to`) argument instead of using `msg.sender` as the beneficiary address are compatible with the UTR out of the box.
 
 Application contracts that transfer tokens (EIP-20, EIP-721, and EIP-1155) to `msg.sender` can use the UTR output token transfer sub-action to re-direct tokens to another `recipient` address.
@@ -321,31 +482,38 @@ Application contracts that transfer tokens (EIP-20, EIP-721, and EIP-1155) to `m
 ```javascript
 // sample code to deposit WETH and transfer them out
 UniversalTokenRouter.exec([{
-    output: 0,
-    code: AddressZero,
-    data: '0x',
-    tokens: [{
-        eip: 0,                 // ETH
-        adr: AddressZero,
+    eip: 20,
+    token: WETH.address,
+    id: 0,
+    amountOutMin: 1,
+    recipient: SomeRecipient,
+}], [{
+    inputs: [{
+        mode: TRANSFER_CALL_VALUE,
+        eip: 0, // ETH
+        token: AddressZero,
         id: 0,
-        offset: 0,              // use the exact amount specified bellow
-        amount: 123,
+        amountInMax: 123,
+        amountSource: AMOUNT_EXACT,
         recipient: AddressZero, // pass it as the value for the next output action
     }],
-}, {
-    output: 1,
+    flags: 0,
     code: WETH.address,
-    data: encodeFunctionData('deposit', []),    // WETH.deposit returns WETH token to the UTR contract
-    tokens: [{
-        offset: 1,  // token transfer sub-action
+    data: encodeFunctionData('deposit', []), // WETH.deposit returns WETH token to the UTR contract
+}, {
+    inputs: [{
+        mode: TRANSFER_FROM_ROUTER,
         eip: 20,
-        adr: WETH.address,
+        token: WETH.address,
         id: 0,
-        amount: 0,  // entire WETH balance of this UTR contract
+        amountInMax: 0,             // no limit
+        amountSource: AMOUNT_ALL,   // entire WETH balance of this UTR contract
         recipient: SomeRecipient,
     }],
-}, {
     // ... continue to use WETH in SomeRecipient
+    flags: 0,
+    code: AddressZero,
+    data: '0x',
 }], {value: 123})
 ```
 
@@ -362,97 +530,130 @@ contract WethAdapter {
 }
 ```
 
-Application contracts that use `msg.sender` as the beneficiary address in their internal storage without any function for ownership transfer are incompatible with the UTR.
-
 ## Reference Implementation
 
 ```solidity
 contract UniversalTokenRouter is IUniversalTokenRouter {
-    uint constant LAST_INPUT_RESULT = uint(keccak256('UniversalTokenRouter.LAST_INPUT_RESULT'));
-    uint constant EIP_721_ALL = uint(keccak256('UniversalTokenRouter.EIP_721_ALL'));
+    // values with a single 1-bit are preferred
+    uint constant TRANSFER_FROM_SENDER  = 0;
+    uint constant TRANSFER_FROM_ROUTER  = 1;
+    uint constant TRANSFER_CALL_VALUE   = 2;
+    uint constant IN_TX_PAYMENT         = 4;
+    uint constant ALLOWANCE_BRIDGE      = 8;
+
+    uint constant AMOUNT_EXACT      = 0;
+    uint constant AMOUNT_ALL        = 1;
+
+    uint constant EIP_ETH           = 0;
+
+    uint constant ID_721_ALL = uint(keccak256('UniversalTokenRouter.ID_721_ALL'));
+
+    uint constant ACTION_IGNORE_ERROR       = 1;
+    uint constant ACTION_RECORD_CALL_RESULT = 2;
+    uint constant ACTION_INJECT_CALL_RESULT = 4;
+
+    // non-persistent in-transaction pending payments
+    mapping(bytes32 => uint) s_payments;
+
+    // accepting ETH for WETH.withdraw
+    receive() external payable {}
 
     function exec(
-        Action[] calldata actions
+        Output[] memory outputs,
+        Action[] memory actions
     ) override external payable {
     unchecked {
-        // track the balances before any action is executed
-        uint[][] memory balances = new uint[][](actions.length);
-        for (uint i = 0; i < actions.length; ++i) {
-            if (actions[i].output == 0 || actions[i].tokens.length == 0) {
-                continue;
-            }
-            balances[i] = new uint[](actions[i].tokens.length);
-            for (uint j = 0; j < balances[i].length; ++j) {
-                if (actions[i].tokens[j].offset == 0) {
-                    balances[i][j] = _balanceOf(actions[i].tokens[j], actions[i].tokens[j].recipient);
-                }
-            }
+        // track the expected balances before any action is executed
+        for (uint i = 0; i < outputs.length; ++i) {
+            Output memory output = outputs[i];
+            uint balance = _balanceOf(output.recipient, output.eip, output.token, output.id);
+            uint expected = output.amountOutMin + balance;
+            require(expected >= balance, 'UniversalTokenRouter: OVERFLOW');
+            output.amountOutMin = expected;
         }
 
-        uint value; // track the ETH value to pass to next output action transaction value
-        bytes memory lastInputResult;
+        bool dirty = false;
+
+        bytes memory callResult;
         for (uint i = 0; i < actions.length; ++i) {
             Action memory action = actions[i];
-            if (action.output == 0) {
-                // input action
-                if (action.data.length > 0) {
-                    bool success;
-                    (success, lastInputResult) = action.code.call(action.data);
-                    if (!success) {
-                        assembly {
-                            revert(add(lastInputResult,32),mload(lastInputResult))
-                        }
+            uint value;
+            for (uint j = 0; j < action.inputs.length; ++j) {
+                Input memory input = action.inputs[j];
+                uint mode = input.mode;
+                address sender = mode == TRANSFER_FROM_ROUTER ? address(this) : msg.sender; 
+                uint amount;
+                if (input.amountSource == AMOUNT_EXACT) {
+                    amount = input.amountInMax;
+                } else {
+                    if (input.amountSource == AMOUNT_ALL) {
+                        amount = _balanceOf(sender, input.eip, input.token, input.id);
+                    } else {
+                        amount = _sliceUint(callResult, input.amountSource);
                     }
+                    require(amount <= input.amountInMax, "UniversalTokenRouter: EXCESSIVE_INPUT_AMOUNT");
                 }
-                for (uint j = 0; j < action.tokens.length; ++j) {
-                    Token memory token = action.tokens[j];
-                    if (token.offset >= 32) {
-                        // require(inputParams.length > 0, "UniversalTokenRouter: OFFSET_OF_EMPTY_INPUT");
-                        uint amount = _sliceUint(lastInputResult, token.offset);
-                        require(amount <= token.amount, "UniversalTokenRouter: EXCESSIVE_INPUT_AMOUNT");
-                        token.amount = amount;
-                    }
-                    if (token.eip == 0 && token.recipient == address(0x0)) {
-                        value = token.amount;
-                        // ETH not transfered here will be passed to the next output call value
-                    } else if (token.amount > 0) {
-                        _transferFrom(token, msg.sender);
-                    }
+                if (mode == TRANSFER_CALL_VALUE) {
+                    value = amount;
+                    continue;
                 }
-            } else {
-                // output action
-                if (action.data.length > 0) {
-                    uint length = action.data.length;
-                    if (length >= 4+32*3 &&
-                        _sliceUint(action.data, length) == LAST_INPUT_RESULT &&
-                        _sliceUint(action.data, length-32) == 32)
-                    {
-                        action.data = _concat(action.data, length-32, lastInputResult);
-                    }
-                    (bool success, bytes memory result) = action.code.call{value: value}(action.data);
-                    // ignore output action error if output == 2
-                    if (!success && action.output == 2) {
-                        assembly {
-                            revert(add(result,32),mload(result))
-                        }
+                if (mode == TRANSFER_FROM_SENDER || mode == TRANSFER_FROM_ROUTER) {
+                    _transferToken(sender, input.recipient, input.eip, input.token, input.id, amount);
+                    continue;
+                }
+                if (mode == IN_TX_PAYMENT) {
+                    bytes32 key = keccak256(abi.encodePacked(msg.sender, input.recipient, input.eip, input.token, input.id));
+                    s_payments[key] += amount;  // overflow: harmless
+                    dirty = true;
+                    continue;
+                }
+                if (mode == ALLOWANCE_BRIDGE) {
+                    _approve(input.recipient, input.eip, input.token, type(uint).max);
+                    _transferToken(msg.sender, address(this), input.eip, input.token, input.id, amount);
+                    dirty = true;
+                }
+            }
+            if (action.data.length > 0) {
+                if (action.flags & ACTION_INJECT_CALL_RESULT != 0) {
+                    action.data = _concat(action.data, action.data.length, callResult);
+                }
+                (bool success, bytes memory result) = action.code.call{value: value}(action.data);
+                if (!success && action.flags & ACTION_IGNORE_ERROR == 0) {
+                    assembly {
+                        revert(add(result,32),mload(result))
                     }
-                    delete value; // clear the ETH value after transfer
                 }
-                for (uint j = 0; j < action.tokens.length; ++j) {
-                    Token memory token = actions[i].tokens[j];
-                    if (token.offset > 0) {
-                        // token transfer sub-action
-                        if (token.offset >= 32) {
-                            token.amount = _sliceUint(lastInputResult, token.offset);
-                        } else if (token.amount == 0) {
-                            token.amount = _balanceOf(token, address(this));
+                // delete value;   // clear the ETH value after call
+                if (action.flags & ACTION_RECORD_CALL_RESULT != 0) {
+                    callResult = result;
+                }
+            }
+        }
+
+        // verify balance changes
+        for (uint i = 0; i < outputs.length; ++i) {
+            Output memory output = outputs[i];
+            uint balance = _balanceOf(output.recipient, output.eip, output.token, output.id);
+            require(balance >= output.amountOutMin, 'UniversalTokenRouter: INSUFFICIENT_OUTPUT_AMOUNT');
+        }
+
+        // clear all in-transaction storages
+        if (dirty) {
+            for (uint i = 0; i < actions.length; ++i) {
+                Action memory action = actions[i];
+                for (uint j = 0; j < action.inputs.length; ++j) {
+                    Input memory input = action.inputs[j];
+                    if (input.mode == IN_TX_PAYMENT) {
+                        bytes32 key = keccak256(abi.encodePacked(msg.sender, input.recipient, input.eip, input.token, input.id));
+                        delete s_payments[key];
+                        continue;
+                    }
+                    if (input.mode == ALLOWANCE_BRIDGE) {
+                        _approve(input.recipient, input.eip, input.token, 0);
+                        uint balance = _balanceOf(address(this), input.eip, input.token, input.id);
+                        if (balance > 0) {
+                            _transferToken(address(this), msg.sender, input.eip, input.token, input.id, balance);
                         }
-                        _transferFrom(token, address(this));
-                    } else {
-                        // verify the balance change
-                        uint balance = _balanceOf(token, token.recipient);
-                        uint change = balance - balances[i][j]; // overflow checked with `change <= balance` bellow
-                        require(change >= token.amount && change <= balance, 'UniversalTokenRouter: INSUFFICIENT_OUTPUT_AMOUNT');
                     }
                 }
             }
@@ -465,52 +666,98 @@ contract UniversalTokenRouter is IUniversalTokenRouter {
         }
     } }
 
-    function _transferFrom(Token memory token, address from) internal {
+    function pay(
+        address sender,
+        address recipient,
+        uint eip,
+        address token,
+        uint id,
+        uint amount
+    ) public {
     unchecked {
-        if (token.eip == 20) {
-            if (from == address(this)) {
-                TransferHelper.safeTransfer(token.adr, token.recipient, token.amount);
+        bytes32 key = keccak256(abi.encodePacked(sender, recipient, eip, token, id));
+        require(s_payments[key] >= amount, 'UniversalTokenRouter: INSUFFICIENT_ALLOWANCE');
+        s_payments[key] -= amount;
+        _transferToken(sender, recipient, eip, token, id, amount);
+    } }
+
+    function _transferToken(
+        address sender,
+        address recipient,
+        uint eip,
+        address token,
+        uint id,
+        uint amount
+    ) internal {
+        if (eip == 20) {
+            if (sender == address(this)) {
+                TransferHelper.safeTransfer(token, recipient, amount);
             } else {
-                TransferHelper.safeTransferFrom(token.adr, from, token.recipient, token.amount);
+                TransferHelper.safeTransferFrom(token, sender, recipient, amount);
             }
-        } else if (token.eip == 1155) {
-            IERC1155(token.adr).safeTransferFrom(from, token.recipient, token.id, token.amount, "");
-        } else if (token.eip == 721) {
-            IERC721(token.adr).safeTransferFrom(from, token.recipient, token.id);
-        } else if (token.eip == 0) {
-            TransferHelper.safeTransferETH(token.recipient, token.amount);
+        } else if (eip == 1155) {
+            IERC1155(token).safeTransferFrom(sender, recipient, id, amount, "");
+        } else if (eip == 721) {
+            IERC721(token).safeTransferFrom(sender, recipient, id);
+        } else if (eip == EIP_ETH) {
+            require(sender == address(this), 'UniversalTokenRouter: INVALID_ETH_SENDER');
+            TransferHelper.safeTransferETH(recipient, amount);
         } else {
             revert("UniversalTokenRouter: INVALID_EIP");
         }
-    } }
+    }
 
-    function _balanceOf(Token memory token, address owner) internal view returns (uint balance) {
-    unchecked {
-        if (token.eip == 20) {
-            return IERC20(token.adr).balanceOf(owner);
+    function _approve(
+        address recipient,
+        uint eip,
+        address token,
+        uint amount
+    ) internal {
+        if (eip == 20) {
+            TransferHelper.safeApprove(token, recipient, amount);
+        } else if (eip == 1155) {
+            IERC1155(token).setApprovalForAll(recipient, amount > 0);
+        } else if (eip == 721) {
+            IERC721(token).setApprovalForAll(recipient, amount > 0);
+        } else {
+            revert("UniversalTokenRouter: INVALID_EIP");
         }
-        if (token.eip == 1155) {
-            return IERC1155(token.adr).balanceOf(owner, token.id);
+    }
+
+    function _balanceOf(
+        address owner,
+        uint eip,
+        address token,
+        uint id
+    ) internal view returns (uint balance) {
+        if (eip == 20) {
+            return IERC20(token).balanceOf(owner);
+        }
+        if (eip == 1155) {
+            return IERC1155(token).balanceOf(owner, id);
         }
-        if (token.eip == 721) {
-            if (token.id == EIP_721_ALL) {
-                return IERC721(token.adr).balanceOf(owner);
+        if (eip == 721) {
+            if (id == ID_721_ALL) {
+                return IERC721(token).balanceOf(owner);
+            }
+            try IERC721(token).ownerOf(id) returns (address currentOwner) {
+                return currentOwner == owner ? 1 : 0;
+            } catch {
+                return 0;
             }
-            return IERC721(token.adr).ownerOf(token.id) == owner ? 1 : 0;
         }
-        if (token.eip == 0) {
+        if (eip == EIP_ETH) {
             return owner.balance;
         }
         revert("UniversalTokenRouter: INVALID_EIP");
-    } }
+    }
 
     function _sliceUint(bytes memory bs, uint start) internal pure returns (uint x) {
-    unchecked {
         // require(bs.length >= start + 32, "slicing out of range");
         assembly {
             x := mload(add(bs, start))
         }
-    } }
+    }
 
     /// https://github.com/GNSPS/solidity-bytes-utils/blob/master/contracts/BytesLib.sol
     /// @param length length of the first preBytes
@@ -577,10 +824,10 @@ contract UniversalTokenRouter is IUniversalTokenRouter {
             // next 32 byte block, then round down to the nearest multiple of
             // 32. If the sum of the length of the two arrays is zero then add
             // one before rounding down to leave a blank 32 bytes (the length block with 0).
-            mstore(0x40, and(
-              add(add(end, iszero(add(length, mload(preBytes)))), 31),
-              not(31) // Round down to the nearest 32 bytes.
-            ))
+            // mstore(0x40, and(
+            //   add(add(end, iszero(add(length, mload(preBytes)))), 31),
+            //   not(31) // Round down to the nearest 32 bytes.
+            // ))
         }
     }
 }
@@ -588,7 +835,7 @@ contract UniversalTokenRouter is IUniversalTokenRouter {
 
 ## Security Considerations
 
-`LAST_INPUT_RESULT` SHOULD only be used in output action for gas optimization, not as trusted conditions. Application contract code MUST always expect arbitruary, malformed or mallicious `bytes` data can be passed in where the `LAST_INPUT_RESULT` is expected.
+`ACTION_INJECT_CALL_RESULT` SHOULD only be used for gas optimization, not as trusted conditions. Application contract code MUST always expect arbitruary, malformed or mallicious data can be passed in where the call result `bytes` is expected.
 
 ## Copyright
 

From a4c13cb0f96d80eb562b30d6316d84f6dba36465 Mon Sep 17 00:00:00 2001
From: Zergity <37166829+Zergity@users.noreply.github.com>
Date: Fri, 3 Feb 2023 14:29:56 +0700
Subject: [PATCH 230/274] lint: fenced code block (#6418)

---
 EIPS/eip-6120.md | 32 +++++++++++++++++---------------
 1 file changed, 17 insertions(+), 15 deletions(-)

diff --git a/EIPS/eip-6120.md b/EIPS/eip-6120.md
index 8100fdf11bd612..39c470c2a8cfb6 100644
--- a/EIPS/eip-6120.md
+++ b/EIPS/eip-6120.md
@@ -154,21 +154,23 @@ interface IUniversalTokenRouter {
 
 For each `Input` with `IN_TX_PAYMENT` mode, at most `amountIn` of the token is allowed to be transferred from `msg.sender` to the `recipient` by calling `UTR.pay` from anywhere in the same transaction.
 
-    UTR
-     |
-     | IN_TX_PAYMENT
-     | (payments pended for UTR.pay)
-     |
-     |                                  Application Contracts
-    action.code.call ---------------------> |
-                                            |
-    UTR.pay <----------------------- (call) |
-                                            |
-     | <-------------------------- (return) |
-     |
-     | (clear all pending payments)
-     |
-    END
+```
+UTR
+ |
+ | IN_TX_PAYMENT
+ | (payments pended for UTR.pay)
+ |
+ |                                  Application Contracts
+action.code.call ---------------------> |
+                                        |
+UTR.pay <----------------------- (call) |
+                                        |
+ | <-------------------------- (return) |
+ |
+ | (clear all pending payments)
+ |
+END
+```
 
 #### Allowance Bridge
 

From 8c0b2307a3a0f747f52ccbda729c921331195928 Mon Sep 17 00:00:00 2001
From: Keegan Lee <keegan.lee704@gmail.com>
Date: Sat, 4 Feb 2023 08:29:19 +0800
Subject: [PATCH 231/274] Update EIP-6150: fix bugs on reference
 implementation. (#6421)

* Update EIP-6150: Optimize and add more implementation.

* fix `EIP-N` check

* fix bug

* fix bug on ERC6150ParentTranserable.sol

* update eip-6150.md
---
 EIPS/eip-6150.md                                        | 2 +-
 assets/eip-6150/contracts/ERC6150.sol                   | 4 +++-
 assets/eip-6150/contracts/ERC6150ParentTransferable.sol | 6 +++---
 3 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/EIPS/eip-6150.md b/EIPS/eip-6150.md
index f88da482e745ac..0df035ee54f039 100644
--- a/EIPS/eip-6150.md
+++ b/EIPS/eip-6150.md
@@ -281,7 +281,7 @@ This proposal is fully backward compatible with [EIP-721](./eip-721.md).
 
 ## Reference Implementation
 
-Implementation: [EIP-6150](../assets/eip-6150/contracts/ERC6150.sol)
+Reference Implementation: [EIP-6150](../assets/eip-6150/contracts/ERC6150.sol)
 
 ## Security Considerations
 
diff --git a/assets/eip-6150/contracts/ERC6150.sol b/assets/eip-6150/contracts/ERC6150.sol
index efac087ef95a1a..e27711e9ea0ba0 100644
--- a/assets/eip-6150/contracts/ERC6150.sol
+++ b/assets/eip-6150/contracts/ERC6150.sol
@@ -55,7 +55,9 @@ abstract contract ERC6150 is ERC721, IERC6150 {
         return _childrenOf[tokenId].length == 0;
     }
 
-    function _getIndexInChildrenArray(uint256 tokenId) internal view virtual {
+    function _getIndexInChildrenArray(
+        uint256 tokenId
+    ) internal view virtual returns (uint256) {
         return _indexInChildrenArray[tokenId];
     }
 
diff --git a/assets/eip-6150/contracts/ERC6150ParentTransferable.sol b/assets/eip-6150/contracts/ERC6150ParentTransferable.sol
index bb97f35a66bdfc..4a3203b507c61c 100644
--- a/assets/eip-6150/contracts/ERC6150ParentTransferable.sol
+++ b/assets/eip-6150/contracts/ERC6150ParentTransferable.sol
@@ -34,11 +34,11 @@ abstract contract ERC6150ParentTransferable is
             );
         }
 
-        uint256 owner = ownerOf(tokenId);
-        uint256 oldParentId = parentOf[tokenId];
+        address owner = ownerOf(tokenId);
+        uint256 oldParentId = parentOf(tokenId);
         _safeBurn(tokenId);
         _safeMintWithParent(owner, newParentId, tokenId);
-        emit ParentTransferred(tokenId, oldParentId, newParantId);
+        emit ParentTransferred(tokenId, oldParentId, newParentId);
     }
 
     function batchTransferParent(

From 838d861f0f9dfa0dca0660d921fe84f7fb08cefb Mon Sep 17 00:00:00 2001
From: Sujith Somraaj <35634175+sujithsomraaj@users.noreply.github.com>
Date: Sat, 4 Feb 2023 23:56:38 +0530
Subject: [PATCH 232/274] Update: relayer data + events added (#6422)

- Added an extra param called `data` in send message function which includes bridge-specific encoded params.
- Added unified events.
---
 EIPS/eip-6170.md | 30 +++++++++++++++++++++---------
 1 file changed, 21 insertions(+), 9 deletions(-)

diff --git a/EIPS/eip-6170.md b/EIPS/eip-6170.md
index 48339d5a2531b4..eca3394e2be835 100644
--- a/EIPS/eip-6170.md
+++ b/EIPS/eip-6170.md
@@ -16,15 +16,15 @@ This EIP standardizes an interface for cross-chain messengers, providing basic f
 
 ## Motivation
 
-Cross-chain messaging protocols lack standardization, resulting in unnecessarily complex competing implementations: Layerzero, Hyperlane & Wormhole each use a different interface. This makes integration difficult at the aggregator or plugin layer for protocols that must conform to any standards and forces each protocol to implement its adapter.
+Cross-chain messaging protocols lack standardization, resulting in unnecessarily complex competing implementations: Layerzero, Hyperlane & Wormhole each use a different interface. This makes integration difficult at the aggregator or plugin layer for protocols that must conform to any standards and forces each protocol to implement its adapter, which might be error-prone.
 
-Even chain-native arbitrary messaging protocols like the MATIC State Tunnel has an application-specific interface.
+Even chain-native arbitrary messaging protocols like the MATIC State Tunnel have an application-specific interface.
 
 ## Specification
 
 The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119.
 
-Every compliant messaging tunnels must implement the following interface.
+Every compliant messaging tunnel must implement the following interface.
 
 ``` solidity
 pragma solidity >=0.8.0;
@@ -32,23 +32,35 @@ pragma solidity >=0.8.0;
 /// @title Cross-Chain Messaging interface
 /// @dev Allows seamless interchain messaging.
 /// @author Sujith Somraaj
-/// Note: Bytes are used along the entire implementation to support non-evm chains.
+/// Note: Bytes are used throughout the implementation to support non-evm chains.
 
 interface EIP6170 {
-    /// @dev Sends message to a receiving address on different blockchain.
+    /// @dev This emits when a cross-chain message is sent.
+    /// Note: MessageSent MUST trigger when a message is sent, including zero bytes transfers.
+    event MessageSent(bytes _from, bytes _to, bytes _toChainId, bytes _message, bytes _extraData);
+
+    /// @dev This emits when a cross-chain message is received.
+    /// MessageReceived MUST trigger on any successful call to `receiveMessage(bytes chainId, bytes 
+        sender, bytes message)` function.
+   event MessageReceived(bytes _from, bytes _fromChainId, bytes message);
+    
+
+    /// @dev Sends a message to a receiving address on a different blockchain.
     /// @param chainId is the unique identifier of receiving blockchain.
     /// @param receiver is the address of the receiver.
     /// @param message is the arbitrary message to be delivered.
+    /// @param data is a bridge-specific encoded data for off-chain relayer infrastructure.
     /// @return the status of the process on the sending chain.
     /// Note: this function is designed to support both evm and non-evm chains
-    /// Note: proposing chain-ids be the bytes encoding of their native token name string. For eg., abi.encode("ETH"), abi.encode("SOL") imagining they cannot override.
+    /// Note: proposing chain-ids be the bytes encoding their native token name string. For eg., abi.encode("ETH"), abi.encode("SOL") imagining they cannot override.
     function sendMessage(
         bytes memory chainId,
         bytes memory receiver,
-        bytes memory message
+        bytes memory message,
+        bytes memory data
     ) external returns (bool);
 
-    /// @dev Receives message from a sender on different blockchain.
+    /// @dev Receives a message from a sender on a different blockchain.
     /// @param chainId is the unique identifier of the sending blockchain.
     /// @param sender is the address of the sender.
     /// @param message is the arbitrary message sent by the sender.
@@ -72,7 +84,7 @@ Fully permissionless messaging could be a security threat to the protocol. It is
 
 For eg., without sender authentication, anyone could write arbitrary messages into the receiving smart contract.
 
-This EIP focuses only on the way the messages should be sent and received with a specific standard. But any authentication (or) message tunnel specific operations can be implemented inside the receive function by integrators.
+This EIP focuses only on the way the messages should be sent and received with a specific standard. But any authentication (or) message tunnel-specific operations can be implemented inside the receive function by integrators.
 
 ## Copyright
 

From dab229f263280b1aeab4f93a033332175bf015f4 Mon Sep 17 00:00:00 2001
From: Sujith Somraaj <35634175+sujithsomraaj@users.noreply.github.com>
Date: Sun, 5 Feb 2023 00:09:44 +0530
Subject: [PATCH 233/274] Fix: Typo fixes in EIP-6170 (#6423)

updated typos in the EIP
---
 EIPS/eip-6170.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/EIPS/eip-6170.md b/EIPS/eip-6170.md
index eca3394e2be835..f6e6f70bcff3bb 100644
--- a/EIPS/eip-6170.md
+++ b/EIPS/eip-6170.md
@@ -40,8 +40,7 @@ interface EIP6170 {
     event MessageSent(bytes _from, bytes _to, bytes _toChainId, bytes _message, bytes _extraData);
 
     /// @dev This emits when a cross-chain message is received.
-    /// MessageReceived MUST trigger on any successful call to `receiveMessage(bytes chainId, bytes 
-        sender, bytes message)` function.
+    /// MessageReceived MUST trigger on any successful call to receiveMessage(bytes chainId, bytes sender, bytes message) function.
    event MessageReceived(bytes _from, bytes _fromChainId, bytes message);
     
 

From 419e904a6df859d7fe9b23effa0a07884f940344 Mon Sep 17 00:00:00 2001
From: Micah Zoltu <micah@zoltu.net>
Date: Sun, 5 Feb 2023 13:40:59 +0800
Subject: [PATCH 234/274] 5114: Moves to review and removes dependency. (#6442)

* 5114: Moves to review and removes dependency.

* Update eip-5114.md

* Update eip-5114.md

* Update eip-5114.md

* Update eip-5114.md
---
 EIPS/eip-5114.md | 24 ++++++++++++++++++++----
 1 file changed, 20 insertions(+), 4 deletions(-)

diff --git a/EIPS/eip-5114.md b/EIPS/eip-5114.md
index aa388031ad5b80..379abead0dc90d 100644
--- a/EIPS/eip-5114.md
+++ b/EIPS/eip-5114.md
@@ -4,17 +4,20 @@ title: Soulbound Badge
 description: A badge that is attached to a "soul" at mint time and cannot be transferred after that.
 author: Micah Zoltu (@MicahZoltu)
 discussions-to: https://ethereum-magicians.org/t/eip-5114-soulbound-token/9417
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-05-30
-requires: 721
 ---
 
+
 ## Abstract
-A soulbound token is a token that is bound to another Non-Fungible Token (NFT; e.g., a EIP-721 token) when it is minted, and cannot be transferred/moved after that.
+
+A soulbound token is a token that is bound to another Non-Fungible Token (NFT) when it is minted, and cannot be transferred/moved after that.
+
 
 ## Specification
+
 ```solidity
 interface IERC5114 {
 	// fired anytime a new instance of this token is minted
@@ -49,22 +52,33 @@ interface IERC5114 {
 
 Implementers of this standard **SHOULD** also depend on a standard for interface detection so callers can easily find out if a given contract implements this interface.
 
+
 ## Rationale
+
 ### Immutability
+
 By requiring that tokens can never move, we both guarantee non-separability and non-mergeability among collections of soulbound tokens that are bound to a single NFT while simultaneously allowing users to aggressively cache results.
+
 ### Content Addressable URIs Required
+
 Soulbound tokens are meant to be permanent badges/indicators attached to a persona.
 This means that not only can the user not transfer ownership, but the minter also cannot withdraw/transfer/change ownership as well.
 This includes mutating or removing any remote content as a means of censoring or manipulating specific users.
+
 ### No Specification for tokenUri Data Format
+
 The format of the data pointed to by `collectionUri()` and `tokenUri(uint256)` is intentionally left out of this standard in favor of separate standards that can be iterated on in the future.
 The immutability constraints are the only thing defined by this to ensure that the spirit of this token is maintained, regardless of the specifics of the data format.
 The `metadataFormat` function can be used to inform a caller what type/format/version of data they should expect at the URIs, so the caller can parse the data directly without first having to deduce its format via inspection.
 
+
 ## Backwards Compatibility
-This is a new token type and is not meant to be backward compatible with any existing tokens other than existing viable souls (like [EIP-721](./eip-721.md) tokens).
+
+This is a new token type and is not meant to be backward compatible with any existing tokens other than existing viable souls (any asset that can be identified by `[address,id]`).
+
 
 ## Security Considerations
+
 Users of tokens that claim to implement this EIP must be diligent in verifying they actually do.
 A token author can create a token that, upon initial probing of the API surface, may appear to follow the rules when in reality it doesn't.
 For example, the contract could allow transfers via some mechanism and simply not utilize them initially.
@@ -77,5 +91,7 @@ It is possible for a soulbound token to be bound to another soulbound token.
 In theory, if all tokens in the chain are created at the same time they could form a loop.
 Software that tries to walk such a chain should take care to have an exit strategy if a loop is detected.
 
+
 ## Copyright
+
 Copyright and related rights waived via [CC0](../LICENSE.md).

From 8ac68037b339fd38494d3cc00e146630537b8831 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:46:34 -0800
Subject: [PATCH 235/274] Updating EIPS/eip-5189.md to status stagnant (#6441)

---
 EIPS/eip-5189.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5189.md b/EIPS/eip-5189.md
index 932999a7e7a71b..786275fc930984 100644
--- a/EIPS/eip-5189.md
+++ b/EIPS/eip-5189.md
@@ -6,7 +6,7 @@ author: Agustín Aguilar (@agusx1211), Philippe Castonguay (@phabc)
 discussions-to: https://ethereum-magicians.org/t/erc-account-abstraction-via-endorsed-operations/9799
 type: Standards Track
 category: ERC
-status: Draft
+status: Stagnant
 created: 2022-06-29
 ---
 

From e6df31515e602b8192397331fb290e16e11d6bde Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:48:34 -0800
Subject: [PATCH 236/274] Updating EIPS/eip-5185.md to status stagnant (#6440)

---
 EIPS/eip-5185.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5185.md b/EIPS/eip-5185.md
index cb49d00f45931b..000784dbf2696a 100644
--- a/EIPS/eip-5185.md
+++ b/EIPS/eip-5185.md
@@ -4,7 +4,7 @@ title: NFT Updatable Metadata Extension
 description: An interface extension for ERC-721/ERC-1155 controlled metadata updates
 author: Christophe Le Bars (@clbrge)
 discussions-to: https://ethereum-magicians.org/t/erc-721-erc-1155-updatable-metadata-extension/9077
-status: Draft
+status: Stagnant
 type: Standards Track
 category: ERC
 requires: 721, 1155

From 54585987224a6924373d248c7a6636837b3911df Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:49:00 -0800
Subject: [PATCH 237/274] Updating EIPS/eip-5143.md to status stagnant (#6439)

---
 EIPS/eip-5143.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5143.md b/EIPS/eip-5143.md
index 525ef1e8872a48..72afb4bc0d02d3 100644
--- a/EIPS/eip-5143.md
+++ b/EIPS/eip-5143.md
@@ -4,7 +4,7 @@ title: Slippage Protection for Tokenized Vault
 description: An extension of EIP-4626 supporting improved EOA interactions.
 author: Hadrien Croubois (@amxx)
 discussions-to: https://ethereum-magicians.org/t/eip-5143-slippage-protection-for-tokenized-vaults/9554
-status: Draft
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2022-06-09

From 01566121b97d62bed90fcdb1b35915772a780e96 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:49:42 -0800
Subject: [PATCH 238/274] Updating EIPS/eip-5095.md to status stagnant (#6436)

---
 EIPS/eip-5095.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5095.md b/EIPS/eip-5095.md
index e81cd9afe3c3e9..a2f9899399d970 100644
--- a/EIPS/eip-5095.md
+++ b/EIPS/eip-5095.md
@@ -4,7 +4,7 @@ title: Principal Token
 description: Principal tokens (zero-coupon tokens) are redeemable for a single underlying EIP-20 token at a future timestamp.
 author: Julian Traversa (@JTraversa), Robert Robbins (@robrobbins), Alberto Cuesta Cañada (@alcueca)
 discussions-to: https://ethereum-magicians.org/t/eip-5095-principal-token-standard/9259
-status: Draft
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2022-05-01

From c23cd771fb135b32476573ca1c83aac21863bc8e Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:49:58 -0800
Subject: [PATCH 239/274] Updating EIPS/eip-5094.md to status stagnant (#6435)

---
 EIPS/eip-5094.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5094.md b/EIPS/eip-5094.md
index 6c1ac51769deb4..ed4fa85d83ad45 100644
--- a/EIPS/eip-5094.md
+++ b/EIPS/eip-5094.md
@@ -4,7 +4,7 @@ title: URL Format for Ethereum Network Switching
 description: A way of representing various network configurations as URLs.
 author: Luc van Kampen (@lucemans), Jakob Helgesson (@svemat01), Joshua Hendrix (@thejoshuahendrix)
 discussions-to: https://ethereum-magicians.org/t/5094-uri-format-for-ethereum-network-switching/9277
-status: Draft
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2022-05-13

From a0a117e0d90e461b43dd6660137572dcec9c4a2b Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:50:17 -0800
Subject: [PATCH 240/274] Updating EIPS/eip-5018.md to status stagnant (#6434)

---
 EIPS/eip-5018.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5018.md b/EIPS/eip-5018.md
index c8e402162a949b..8ea13dbc6b9f61 100644
--- a/EIPS/eip-5018.md
+++ b/EIPS/eip-5018.md
@@ -4,7 +4,7 @@ title: Filesystem-like Interface for Smart Contracts
 description: An interface to provide access to binary objects similar to filesystems.
 author: Qi Zhou (@qizhou)
 discussions-to: https://ethereum-magicians.org/t/eip-5018-directory-standard/8958
-status: Draft
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2022-04-18

From 145a3ba937e2acd759b28a54030fbe3f45f748d7 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:50:45 -0800
Subject: [PATCH 241/274] Updating EIPS/eip-4950.md to status stagnant (#6433)

---
 EIPS/eip-4950.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4950.md b/EIPS/eip-4950.md
index dc464de3160099..d74ccdbe250b67 100644
--- a/EIPS/eip-4950.md
+++ b/EIPS/eip-4950.md
@@ -4,7 +4,7 @@ title: Entangled Tokens
 description: EIP-721 extension with two tokens minted that are tied together
 author: Víctor Muñoz (@victormunoz), Josep Lluis de la Rosa (@peplluis7), Easy Innova (@easyinnova)
 discussions-to: https://ethereum-magicians.org/t/entangled-tokens/8702
-status: Draft
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2022-03-28

From fc392ebc699f938b8128a5476b6a2e090b0d54f1 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:51:03 -0800
Subject: [PATCH 242/274] Updating EIPS/eip-4788.md to status stagnant (#6432)

---
 EIPS/eip-4788.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4788.md b/EIPS/eip-4788.md
index 45a98d24b8c56c..24f65168b0a181 100644
--- a/EIPS/eip-4788.md
+++ b/EIPS/eip-4788.md
@@ -4,7 +4,7 @@ title: Beacon state root in the EVM
 description: Expose beacon chain state roots in the EVM
 author: Alex Stokes (@ralexstokes), Danny Ryan (@djrtwo)
 discussions-to: https://ethereum-magicians.org/t/eip-4788-beacon-state-root-in-evm/8281
-status: Draft
+status: Stagnant
 type: Standards Track
 category: Core
 created: 2022-02-10

From 69f373bedac0f27d667a4875f2e854d9edcceb87 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:51:20 -0800
Subject: [PATCH 243/274] Updating EIPS/eip-4671.md to status stagnant (#6431)

---
 EIPS/eip-4671.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4671.md b/EIPS/eip-4671.md
index 9d549aa175d392..f7f55b91e7d710 100644
--- a/EIPS/eip-4671.md
+++ b/EIPS/eip-4671.md
@@ -4,7 +4,7 @@ title: Non-Tradable Tokens Standard
 description: A standard interface for non-tradable tokens, aka badges or souldbound NFTs.
 author: Omar Aflak (@omaraflak), Pol-Malo Le Bris, Marvin Martin (@MarvinMartin24)
 discussions-to: https://ethereum-magicians.org/t/eip-4671-non-tradable-token/7976
-status: Draft
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2022-01-13

From d592211e0f93c297ab9b342750bb6d22eb85782e Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:51:42 -0800
Subject: [PATCH 244/274] Updating EIPS/eip-4444.md to status stagnant (#6430)

---
 EIPS/eip-4444.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4444.md b/EIPS/eip-4444.md
index 9bc6b3e24496c3..df543d454f1667 100644
--- a/EIPS/eip-4444.md
+++ b/EIPS/eip-4444.md
@@ -4,7 +4,7 @@ title: Bound Historical Data in Execution Clients
 description: Prune historical data in clients older than one year
 author: George Kadianakis (@asn-d6), lightclient (@lightclient), Alex Stokes (@ralexstokes)
 discussions-to: https://ethereum-magicians.org/t/eip-4444-bound-historical-data-in-execution-clients/7450
-status: Draft
+status: Stagnant
 type: Standards Track
 category: Networking
 created: 2021-11-02

From 4cb5173768dd1ebec78c8dbc6569ea87c12e42aa Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:52:03 -0800
Subject: [PATCH 245/274] Updating EIPS/eip-4361.md to status stagnant (#6429)

---
 EIPS/eip-4361.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4361.md b/EIPS/eip-4361.md
index e594685b62fc9f..80370473c9f751 100644
--- a/EIPS/eip-4361.md
+++ b/EIPS/eip-4361.md
@@ -4,7 +4,7 @@ title: Sign-In with Ethereum
 description: Off-chain authentication for Ethereum accounts to establish sessions.
 author: Wayne Chang (@wyc), Gregory Rocco (@obstropolos), Brantly Millegan (@brantlymillegan), Nick Johnson (@Arachnid)
 discussions-to: https://ethereum-magicians.org/t/eip-4361-sign-in-with-ethereum/7263
-status: Review
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2021-10-11

From 4994dc20fcf7b74cfb8c6cab5d44047c10cad6cf Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:52:26 -0800
Subject: [PATCH 246/274] Updating EIPS/eip-4353.md to status stagnant (#6428)

---
 EIPS/eip-4353.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4353.md b/EIPS/eip-4353.md
index 645be6c660c288..b0b4a3e0db12c0 100644
--- a/EIPS/eip-4353.md
+++ b/EIPS/eip-4353.md
@@ -4,7 +4,7 @@ title: Interface for Staked Tokens in NFTs
 description: This interface enables access to publicly viewable staking data of an NFT.
 author: Rex Creed (@aug2uag), Dane Scarborough <dane@nftapps.us>
 discussions-to: https://ethereum-magicians.org/t/eip-4353-viewing-staked-tokens-in-nft/7234
-status: Draft
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2021-10-08

From 0fd6621d53a1d7e72050669f525f6ffb8e3f56a8 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:52:41 -0800
Subject: [PATCH 247/274] Updating EIPS/eip-4341.md to status stagnant (#6427)

---
 EIPS/eip-4341.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4341.md b/EIPS/eip-4341.md
index 7f776b8952d2f5..6bc8c21655a56c 100644
--- a/EIPS/eip-4341.md
+++ b/EIPS/eip-4341.md
@@ -4,7 +4,7 @@ title: Ordered NFT Batch Standard
 description: The ordering information of multiple NFTs is retained and managed
 author: Simon Tian (@simontianx)
 discussions-to: https://github.com/ethereum/EIPs/issues/3782
-status: Draft
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2021-10-01

From 09943828bace773b85213e3b80abf167d46126e7 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:54:49 -0800
Subject: [PATCH 248/274] Updating EIPS/eip-2400.md to status stagnant (#6425)

---
 EIPS/eip-2400.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-2400.md b/EIPS/eip-2400.md
index 5d2dbd3f6b0ff7..1978fd56b03e0b 100644
--- a/EIPS/eip-2400.md
+++ b/EIPS/eip-2400.md
@@ -4,7 +4,7 @@ title: Transaction Receipt URI
 description: URI format for submitted transactions with complete information for transaction decoding
 author: Ricardo Guilherme Schmidt (@3esmit), Eric Dvorsak (@yenda)
 discussions-to: https://ethereum-magicians.org/t/eip-2400-transaction-receipt-uri/
-status: Review
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2019-11-05

From ba25760dabccec3974aa7ff4b2fa47181c5f392f Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:55:11 -0800
Subject: [PATCH 249/274] Updating EIPS/eip-1328.md to status stagnant (#6424)

---
 EIPS/eip-1328.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-1328.md b/EIPS/eip-1328.md
index 7325b9f2b2c79f..12e499b552411b 100644
--- a/EIPS/eip-1328.md
+++ b/EIPS/eip-1328.md
@@ -4,7 +4,7 @@ title: WalletConnect URI Format
 description: Define URI format for initiating connections between applications and wallets
 author: ligi (@ligi), Pedro Gomes (@pedrouid)
 discussions-to: https://ethereum-magicians.org/t/wallet-connect-eip/850
-status: Review
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2018-08-15

From 36d2a37f1ff291788df35ca60a52b582204b6eb3 Mon Sep 17 00:00:00 2001
From: eth-bot <85952233+eth-bot@users.noreply.github.com>
Date: Sat, 4 Feb 2023 21:56:09 -0800
Subject: [PATCH 250/274] Updating EIPS/eip-5131.md to status stagnant (#6438)

---
 EIPS/eip-5131.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5131.md b/EIPS/eip-5131.md
index 0fb28b15306168..54f093590c44e9 100644
--- a/EIPS/eip-5131.md
+++ b/EIPS/eip-5131.md
@@ -4,7 +4,7 @@ title: SAFE Authentication For ENS
 description: Using ENS Text Records to facilitate safer and more convenient signing operations.
 author: Wilkins Chung (@wwhchung), Jalil Wahdatehagh (@jwahdatehagh), Cry (@crydoteth), Sillytuna (@sillytuna), Cyberpnk (@CyberpnkWin)
 discussions-to: https://ethereum-magicians.org/t/eip-5131-ens-subdomain-authentication/9458
-status: Draft
+status: Stagnant
 type: Standards Track
 category: ERC
 created: 2022-06-03

From 51129c189c255177e362eed37926fc6a7b6454d2 Mon Sep 17 00:00:00 2001
From: Vazi <106611793+DeVaz1@users.noreply.github.com>
Date: Sun, 5 Feb 2023 07:57:26 +0200
Subject: [PATCH 251/274] update ux image (#6407)

* Delete ZenGo-EIP-compliant.png

* updated ux

* changed file name
---
 EIPS/eip-6384.md                               |   2 +-
 .../media/ZenGo-EIP-compliant-warning.png      | Bin 0 -> 134856 bytes
 assets/eip-6384/media/ZenGo-EIP-compliant.png  | Bin 240406 -> 0 bytes
 3 files changed, 1 insertion(+), 1 deletion(-)
 create mode 100644 assets/eip-6384/media/ZenGo-EIP-compliant-warning.png
 delete mode 100644 assets/eip-6384/media/ZenGo-EIP-compliant.png

diff --git a/EIPS/eip-6384.md b/EIPS/eip-6384.md
index d312ff03857e20..07e4cca774a01c 100644
--- a/EIPS/eip-6384.md
+++ b/EIPS/eip-6384.md
@@ -32,7 +32,7 @@ As a result, once implemented this EIP wallets can upgrade their user experience
 
 to a much clearer user experience:
 
-![](../assets/eip-6384/media/ZenGo-EIP-compliant.png)
+![](../assets/eip-6384/media/ZenGo-EIP-compliant-warning.png)
 
 The proposed solution solves the readability issues by allowing the wallet to query the `verifyingContract`. The incentives for keeping the EIP-712 message description as accurate as possible are aligned, as the responsibility for the description is now owned by the contract, that:
 
diff --git a/assets/eip-6384/media/ZenGo-EIP-compliant-warning.png b/assets/eip-6384/media/ZenGo-EIP-compliant-warning.png
new file mode 100644
index 0000000000000000000000000000000000000000..fd3c5b165f8cec5c0642d9ec102051e6f2f1be1b
GIT binary patch
literal 134856
zcmeFZWl&sO)Ha9(3GN=;q45TS26s(xclY3$;2PW^I0U!GC1?o2-QC@te9g^Ga^I@?
zJ2N#?Z`FZnPWL{0?X{les|i(<mq30=@Dc(70$EB@R2c#Snhyd34gwwud?(dt)C&Rv
z$-+WJL{UmagjCVd&eX!%1Oh@bG(incU8Nr<Q!Dn<rx7UhPZ%DUq8>3A!r`Q(#MS|n
zpA-#c;ptsWl)l!5)2fz+<diUwhKJ1z<jmX~z7f;FMGVV1qkiGMsMhA%W_R?!<FqA6
z#eO{m@p*9|LGnzI7~-tw#n?><nyIDc>$nRfQivC+9Z2d9?raDQ004my{?1Rpv7L|=
zty%`Q_D`ap6*+yl-`pTb*GY#q2HbAZxS;(iwx#l3K%ilJl+eAvc##QR)rJKNe@g#i
zNOe``WqNU^oOD{Z8?ZYGa^$mP<Crx>?a>?lnomi{?zI9U2lQLv-4N!eAGtr#Y@Cs)
zb_*~H`o==330b2aQlWLZ`6+C<rqBAW4-;){JJ!He(KF|p2ZR~N@*UOwtl{{nb#}f1
zEnsbs`!YY~H0;3u*=|!lOj)14TW9S@vbtCq*%9{XyZ3Mq`S6=DQuLk^0W?NkcaX5%
z<zBYtSl!fU!QtnIIg@uk7?rr;3>!2@igTdk$-9Hln6bWfVoU(j^5fPf+eVrg>C*D2
zvNoj?e6ZVIeRGOaw|wFfhLjkLw!lWfR3R-8veu!Mj`CMWG{n`g6^@@XHIDg2%&t$7
z(8sV=AH=Oo8U?R(Y80q3cH&m&ZP8{;s%KrJ*d4004*jCDTk@TEWgK5Qn@=*Liw3DF
z74iwZaq%d0<H?I`gD(qJ+fWY5A5sg|l+iFMQo~g!-5o4F7nDEYW{+qIACNJ~Dh~I=
zA+D^wJzdv`{m>x#F5OKD#r17E{VOm05Lj!pm&rmXTGYufj($aTC2fdL%8>!kfKMN+
zNg;+T2RkCLHbd|PFon=>Fv%f5ArB!cMZFXvoAAY-_>wt9D#N2$lpceaDV&a)BlPNl
zNo@!N)k6kW;j{P!>aq5W8_N>k4A%NjUBS<f1qN^AYBecHPQFdNs-z4;7YU8&w$FjK
zjeuKwa^vuV?b-^uUulDO_o|`cqpC%Jg<g(1hfq%wwk72o;>ckh{II&GY3!qixPas6
zu}0<wVI2H}8=4Dtr~&SxtMlV$Gle3Pl6BR$fw$1t%WOAC%Zl?cI{mcn@I1-ZKi6fM
zB$$TZ;E0vAS47iK{rKup11I5gG5l11=QShoXdcScjbdn4xjw^FickV4dw@6Pr_&up
zd$O|Uk)y2xy|k8ax*_~(RPe!JQUE(4zHzF-rO8J%5*xk%hZgwCGuAluZ9EgBe)Y=q
zn~seTcR*LNZMp3c1Z^AVm+5J(pfkb`EJMEIgV(U6pBviS+jr9dmb?&f<11I~S8`_8
z=xw=W5Zui%G)XvLoEz5O_}L-YG>k`JEwk#Qo;yJ6c96h)WMO&P{Xz5-EOiGx;_B<9
z4|Mvl$%xWI`0B8#AK&X^&b)N-Z(V^Xf|Fa}=0*ni4XnIwKvYwJb3<tQ>Nyfj3XhOY
z=G+a>Dq)RA(~W%k1}cVyk|0!K>=P0tAv%SlF)SMioro&w{wF3$&ND<uJf5g@k-1Ov
z-$e2--9LH>v&M(*<rWk%y(YSRqhXGf8WJT@Gum&Ct{DM%!!SbcjH(&@N`m?G^r*`P
z)!au&Sxh5+oMiT`k5yIbjKl+-c{7ZqSPXq%Dm6>dpN7?{TuKq|Logj)4|Qj(zKrUQ
zvwtOkpB2d5JH6U`^7?_&2irHqbzKjE;{(Fi&=rXlG-ZU@0J;DSVIBjxRkT&C1sURi
zYf<u;H?<TVU9HLDKgi^10MxdmM-)KJ`H<*PeoBn~kPXq7q&=|>c~Hs-7EBhXyLh`V
zi$6}3WEUHhuNI(}$CQ&zB^N4{S81&m^<qbw5qKLDS0m3x6Ul7F6~-jR*2fU`Cw(K{
z5C{YGL}3U?<!vZ#Dbv%|#jC`7#@DB&rY5Ggr5bUFr8;pia9mquPI?vH#(a@@pI2SH
zUgWrku_tfIehIu}iWINOe=$C0@uHTh)^ZME4qCGUM`u7RJhx{$wd`H-yTbQk`w2je
zdGWM-{x{8%&D!^$uc!_I#MMz{C|bcK>@tPQ+m%Cd8LxDjj^G#77rhpHnwsAa?+Q#)
z?9T25?w($TU4r&9Mm%Nvc2u2#84_6v%i@A!$0Ia*^Se$LP8S0g*L(GQu7o@IZg`Z0
zvYbU6+=e4V9e5xl6pHAocn3d+kEa$PyJ%BrUq6Y7SO#n3pMAA2GN{b%sGP9RT7BQ8
zATFEBlB=D&DSjz_9qC{svCi7762V1~#dbvSMR3BG*3Nu)1X|=c`7?DC^(pnZ94J+r
zW0#eaJ(49Mxtx>VV9unM1ra#Fs%7FbQ97P(`^p@^rf1^w<Ke})U%%lND?>6($|4Rm
zP7ID?I1^48j(4I<qEzBJ<F&?8eUAFAx`{?vwPn>F2w4BhhQF(+_bv)~wzp5*yry?6
zVh~P?cOGm01?Unqe28?&?IPyF>2iHwarNdZ?y%&bf(MP*i^!1}$gS-nO3Y6j7?lu}
zl&(m_OcOH>TL>};Flg)Q?)nn6=v?r+CLJ-uDxIW>MLS1lt8t>ag}|1d&-><V)hx*O
z{iXAu)8dwgYrs;762(@eIninF;ArHw>aNRR#@4GNf%(?2k9EOu!5v1qeM|~X+vdYB
zGMO^<T3TB3bnA38mZp~Qm-buj?so3GZyB$6_GM0xPcshZH||G=2P!&_{g(BfhMpRq
znjf>GYYFM_8f`Y#AqF69I}-h_giQ6tSGGE?NW)2O72l2I>X+#IoJ6gdF~X^$SfTE}
z3$Y5}*iifi2O{yLZsx&4jD%-Gwm}|8lzFLzdqujy#>d-2-NM_+Zs;NEL`lX*@94fE
z7eyD`SG?sMefEmeX`-Lj@~!YhQ<21I)ackw@955sQm$H58?F&1MO1P0i>maQgsSWH
zgEi{DM_>>)wXN)Ca^We(npt<2)Mpx5*_n(J0ai)}i?v0{drEg@nQE7_hK;=qRJv?B
z2IV=G;KCu<)=#GC)Y4XxH2E}z$CAhRgg}?enJ9<Mb?M$kJUcF*y&EUY2$~H!ZZ;)P
za@V!5NW$XMy+;wl3+lGm^)zvDjRG}keOqO#ts8LXYNxy}AU|M#Fw=n4V5rVCgEOx9
zafAhnFc7Fi4l>W!c`t7~RFIC^Sk=hubbqdVcC~4>VYWenvmffzLqn4ym-@O`ZjF*I
zrdHu9t;NH!o<q7xB<Nf30Kv<P)$FI71>L8(2Ll6r0~3Se_zgO^!aaFxg;wrChq)Y!
z;jqqdkV0SKc|rY;%4Am8-ma9=6fIM-8aA`KAD~nnzGfr&?sOd|Iwz;?CxPMjOJVNE
zTZKRD7=cWgDi1e>Az7BvwbFT1T(~#PGqq@Xw3;(b-@HfX#Pnot^S1}I2fhyoFmEvl
z{5%iIV(>ZAi>=FhUpze)IS?|?Jz&d-s@Y~0codd{9jz9nt5F};_{Dj$c@k4Ci{YAf
zxi+X;yse;>yeY?^>~hY;O0WX6yjd4txzVn*|4wXQ(0awLp_<jr=n$-+CTRjTI5ur{
zRE9D-2{!L;RoA9E%M|LV?09Py%{(tr)`?Ac+YYdft(URe_l@gZ-(T9sEy`Gp5V*^2
zXF7NSj*%DV75BB9O-PLNW_>F4+J5#h<F_wxqrLyU`FZ&3oSu!3j&F!hQ7uYwn(DL;
zbE%!3q?I`@-=4ipuJ3yGvbN9stnuhu_wJQ%W4ZCUJreiP*u?u5i5#xP!vaqYCWZrx
zn8h^Z8AMLimv1MEYYMv*vbeimI~`be%oaHLY@=jd^XU10-4|XI8x9Zlxqf(5EK##s
zq&k*CPV#2v0!3Q$dQk0rKP|~tQ_x%2Zno#&@|cgzBdoWLYM%88_uaoeY?-e(##-8K
z=G}g^s=Mo*aleTw`|9oE>PcUlOT`rhstAd$SNzG&k<rq6l7g{<fGd_@K0lMM=~L-l
z<NSHS(8<sMb8p*@8=d>?^t-ddqpW?s+4j53ij{VNOQDNvOJduRZ_Q2F=zPX8-%{O0
z_a&cO*3Y(M5sM0?<ML<$l3_3D+lx}W?`C7$VazCc1nuJ9t<zb{%gn3Njo))2U<p$b
zUUZ~oK#Z)+`lB4%#8-W3{;Z5P`S>oh!?*LxeU5SqL{VVI8s4xitiGT%$SGb8`!jbZ
z4J`D;qIYGnSmNeU!CFpd8d`RJ`_D2uh&*wKHp%<@d*H>j?=0-cR%D@b<4NMTWTI|n
zGelp6>eWmOK9GpM7kmWtk$8R%>41Ki`H7g85bZe3Gdc>+J-AKOrA+1IAn3ub;UOS{
zEg)dPuOPuc1mGVC2&m6czwbcveTM%18t$JrdBvP~As~bxq(tAmb%Q);MfhZ*=DzKI
zJkQQh11zqs0L4V857O5o#}f7Sj`}&kj2oq;fb8pSk}Xi((n2yr&A*Du!i`5phGwP!
zuV!HDSr7B!Djk|3xneuQ^@R*s(_rS_ec@-QuV1wBS?160T5bK2q#?8AS+Vq!et*+_
zJ9Cq_-BV^;Z+SLHG6_D!?|-lVpKu_Z(EnzkTF$L}-md*IklAY$QTGJufY1Bx0=NC9
z$MdLhdsKpi-?s)%y6t+&Q}AIG)vj=c(6(Xqvck8OJ@jHI?|IF9e+dUUDb&B0eHFUU
z+ePo|#UAnL=H<tu$NTFnr;kcHgozK|D54kKw=*ch78xmk%A~Fm8<R}vXpsM2_Amf?
zh56x!AHyxj-p7Qe=BL(+4t>NoOX7L6CyAK46fjfs%THIXE$hTx?)5)HSd%G}=2>3%
z{KBI)2h0OEHY5@4QgA0J9&W~pdsL{7(;#R4k_SUpv+Tjm={m{Jo4(tH3=ig4qd|O~
zyPL&iK}$cMuFs|T42SyIQ*SW^PcfhNfza^>*lEnSpn2Q%&2y^Ht#|>KdOG@D5m;in
zdZfqu*WSz5N(Vx^-q^ng_b;XvV!mA$d|Ho?a8Cd>@i^yREapBkcTpWIHeZ|hUYP~2
zyE1J-liYNa?}Bu!CWcfmI-pT+-i$6k3@#%rqi!g<alO?XqQ>yr5g{QTJpTD~9E`uX
zSl@bR(`GytfM8#FtCel+jPEY@sPi3_9VJ;5n^#66Km3;(cFdx6ELYXmZg{Z1ZWwv2
z$}mjUXj@GuUuKGeS6tk2mw<+CSw*({O!yc>avNh>!((qH(XLDk!28ncM_jgJ$dI1Y
zCHQ1;Dr$u;^|ZOpNnkFhIcO#kjJ%L9<eTIOdlbaH=|?156!}fk(APDs1RwUxl-j=%
zn<0ZTSeCF8BWW58J5gi_U2wJEChG9>*L}|p{Yg&yW*#V0>2$gS{Ngj9wN&l&PCJ0=
z<BxWnw0@@rJApyJtCxC%kW#qP47H0a&FBa%nS`|CxNC>AjQ$G6zirF`HRQ6$ZHJ3x
zp(k?l+pOsqiaxfA;ZIn&2wBd)-AI&(?Mv^cb+o3eVh>XwOX}M$%a$ZC6P*NBM_~i%
zqUGJ6T&=eCx+&w)qWIXvtVQBFrHl^R{DaQ>zpa@NIgxqu`73VuZcvaQ*fp|1pTr*^
z!DBil^*d!7K)ZKo4GauGyI#J75fysA3c~#eF_1mE%-Yishmyxme%K}X0g_ST(P#W^
z<D1QS!@S4SmatsbC@M*_gOKrJe41?E6$~s4mLg|ux@0CUGY?{iG#PGDFk><Z!39Zl
z#i#YZAsM#9or-$5;5c2mx%vQs9F20W6!DL7>5#|#OmpT#$7gKN=Zx|W^~X{H%-x&U
zQ-pRc=uCAfh7|b3RN<)V!xGX>>;7L(Yd(3CI@VMyy{OTE>WR*RP?+!(;3Deo?jA8{
zeq5DQzKi9uqNzw#s2Q9NG+tef8<bXU`PYaY5cyY{<x%7soxQ*H8H9T%8-!Xt<8?%4
zeCgb{^R!bfwF}U;%C6}uL_j7~hvL@ejU6g^ZFl$r327RyH=wQt&yZ1NU)ZyN^asT?
zLC7}8gWU_*p04eB?@^pKt~7smvH40XS8m)2YxM({Y9!noynoTdtpH^(ywlm%fnM*G
zx(cBj5pnSirnC9Nxl|tBbFb3twaM5x&mE)lzAfu=Vpt?&w)M;KRz(B5$sqqqmriSe
zYNv2@=2#vZZvEx+%<G%oup-(e)NR8}Dxt1Z>|+LI$myVwVVc<3`Yd8kH{QpR&}FxP
zKDYZG`uu+n9+3g@Sdm7s!4+B9ZUhsd>lR?Mu$jY7)jVIEDV*FG5NmXYwu<gfbBL1(
zywYtwZo8)*tn9Cb;{<xVczHK{U*EfFvA%c-JYn|pzjcax@pkH8Q-lR`qV0x@>#fL*
z$9WKb#`MZzpm3JW9>t2MYUG|1#JEfa@2%5in&tb$oV{~S$8Fo?u2m9;90H4Kh^TiJ
zA>wF?`EiUn@Z<ixUKzf}DDZsjaK3(6a1{L~DJk!e?oR*;v&Tsw?QfHd8wP;_wd^|z
z7nnw)T|^ILgnNN`)k0W+AJr{P#IUro3KK_C<1{`8h+S2>hDVoeP<H2aS6cX@U^vtH
zF)0Yb4kAegU%F~E`e#+&t8)amxR&;535=5-jHOcJu@jtX+gX!%Lqte=#(zwFr4vj`
zO~*U*D-B*XI;!z=lz0WCHf-t_jYC*n4cyyd`3TT-td89GLaCvTP1V(GRUo-YgVmSg
z{?{LqV8sGu5*@Dn>+v7A`AeY3>AeTMp?b}{jqyJJu-{S5%^@QS6#GZnhO#<dkU(GR
zq@kvNjJZey@UGWf6s9EzG5@dzCY_Pvy)r@GHD!ADfDdI$K#{eS#_0$9W^0*mDf-0L
zZE3=9IT^~k9NDZhQ1cUgr=gB|m`!r1;V(4?FhbTw9hbqA#(Lcvv>;|}Gi7=6LOK(+
zZVS~n8;HMM1gfAI(@-RZ6WJcz_94CHI^itMIEgBMMO@^e*-jqOsgVf1#HNXDSz%y-
z-L~KLozXcKnW6IpP=|yTZ%7D{Q}N3Y^1jhmPrcCu+%V~#@xbiR&fb44Ph5&qpj>ph
zSl9^@p5<7WIgg(8IjrzLv~sm=j~+FZoz*$k*gOq5f3$$D2uX5YAodY-vwILBKB<k#
zsQ<c5Y(F0~-|k?Ar?JzOi^Dj3K!B6ll}{)BuYm$muH4g+ob-D|pr(UQ^;in!>|~I&
z6PbNYlw9Mi+7s*MC^|o@DbTzdW0=iG5h2-GjN{SiCI(Db=uHdQqIe8)H6Zx%`sHd}
z?ndQn^58ns{M#hQfe!ntS?@&4#$RSh0|W2K#0wJlA(8pE6zYaCh{=KVV#4g*gwUE|
zEwb}q+N7K6DfA?=7qS&eLw-drJc|p@okjK!@y+FjS7G!-!o)r^gyl-`8NOW_u!fX#
zz`hFJUkuYi!`o50*<;r}(Q4bMLAKr*z{Bf&J<ldZ@}0UfH=%<ilF3Ls4Qoo^b^Z|w
zhR~fgZGu~XKC!GfaG8r?7TLpAeJm)^`pQwV*5;dH%&%w8ld&u`-e~_rEfExS)8PX)
zA+TkW$u2vbWWbmWWIQi7ijxI>+CTgOqI17Du-N*d(}x9juc#=4!TqfGyYN4@%0HCK
z&yGBuaIheoYsoFQ=IX=pYX$fnpz8spcs0Y5>3y1Qdm<Ou%}#4OAsdwvy_(#=1ZAD_
zsgPsZH6MbsY#TTGX|f(_1n+Ck8EtrHndL`88Ho&$|JosN=#rfO5ySB#(2ao`E@br8
zbQ7Y_{zG>5{ESM{xY)2>mBEi}k>I79UarjcciY;X$B#?LheJV47&hAv5%Eg@ieFTp
z9RBnC%vj>E4hWWn@Q7c)wNdvS&F{GEx3%~;O#9zI|G&V2I5E;pMkiqP*4=(Z`@`8l
zMf1^Xf$goW)WI$BVyyqj*6hva>HQ2qg;8G=zpAcTj60DOjaqG;W?53(MLx6d?Lhum
z@2O#t{J*|8nF$IU+|br5_}-1fH}+fKQicIH<`{HO!;)GLOyWXiRYQMAVA|a<&ySER
za8BbM4N~>oWYD8Ko)ddWdLxJVZv>1$<2QY%l68l*XOnYKDj&~T;W1gFXkDjilT#YY
z`Ui0AVt#Mh)9l((hJ#6b+#Cr6=rVx~&%vqw;Ma}MF;ss)D8I5Zn(KQL>^pPlLgU|+
z=QelLaz0d2(dK~>@(uRiGk_BZdl(!XoDmvKHu=}+Igv_A>7P6Ve_8qG-}+<l2g~ig
z!o5;`%yXGPAGUvvpgxY|@srI`{8fr5h#{c3Br1sjpDt;_scN)`$>vu#8^yyv#E`S3
zLO8zgo!{Z$^>+P{34|4|yU{Pqs``%mJ8=OAGS)U<IhT6!)-P&TO^vKC_{iv+|5a{q
zNN@lJ35q4IsIf`Ui8MlWfvo!SC+9))M-<j?>En!4skP9*_|PImFZxHDUE%HN?~dNq
z8Za4Q+R%c$@2_mk<H&!x$A69og}}o1T0Ci-TWlUi04as?@1ZE*wS8_kDUObI%Bn&^
ztRQy@|1b8x+2$Xf+yRc6xyq*^<!UXgowcL2FT;LIJDuI1p}b)&{XEmGw<;8Pb<eFZ
zo}lxaCLtJ?6rq~gg-rtQ_h6!otZVFA{_aX{uL{%K@J_46TLhd=Ug5T#1lBLQ5N6%<
zH-NI#=>AeJ1Vd_ncd;umuph4Xu*SbxC&#E24(y)QTE3flPJ5Is=8eA?|CK<c9Mle1
z{5<c{DGF3>O$3HbQEl^46JjH<34Zb4EbJdyfCX{vxqL4!Q!j@a(bs&nit3w8HhNww
zH2dGZL6jXAHPh`+mtYOhyXnLQ%C=OQdtQTc)vNk;?+BGcVC}nq-N!Qt_UM@UpD-7D
zxBCRHs#Z-=P@-dxL`d#F5m|TTVf_b4%_0zH^Te(TUt<F+o8F9Gfpff-3`7;$Us2O9
zV^cW*qn_bsi^%X8wW=g8=I}kR9vkO3jKH9n@rL4Bu<z>N-mMp#&v0G39dd1Ry0%e{
z{L2ecs4f`W)=SkXss-0&@1v=dRi%lAMc3uQZF|^%Q{i7xXha~y_?&IasW?~TVMJl1
zzY>!G-awaP{@+Jc;zNSYRvg2n2FHUw9>z$#nq{n8`!A<@C09E9p}FUOj0dI3F^Kow
zP`<7E3+o8dk^M_`S<6h|f_3U3@I$=qADa=<frqeS+BK_cK%a&+k4N(H%imM_kHXB{
zLw_~Rv2lL=Kct7p3~5^ZPWR*kZp1YFB;Y@|VoCLLpW^_&PK`PG1Jsa?8H5#+ICH{#
zl~0iWInxWsg1R0tCF>aJ`u}khxzB92&~MxSk{{AB1w%OpGR?#KyPCxX3d6?87l!Sh
z81$DV0a25Vf;cJi|D&^2n4iG=Qv8p7IUz$qW%zV~e>aH8@DrV%A@N80&&o0caC9;#
zN%tQkbpWQK_X*zkw+4cxXDug`V`C*QP4<@uMl__Oz$*z-=>M#=0u!snuKe=1Vnd?i
z@q($S5`@D4k8jfg6FZ+8qx=gM&%eQ(ldO$=ME?fycjZhfnAoX^c;UaQ-YXBL;viZG
z_CG8CUtyVSfO)g;?Zh$PQyJW}T0O`$7i&AkJC_{$KmHHwC;?%HEjawOZFjxQ3)|K=
zYQr8wR)FTc(u3Qbs;-~&B6<!QPmfM|XKUVYL-frU;T=3^ZYN*ieD4Z<=ghRVwI9v}
ze>w?xM?hf;ubixQRd_D$x3HRB<}IB@xjyvhJp>NlgAK$ZXN7y@&oBQ->p;N&)N}5L
z$NdKv;cX!Nxn4a|Kv-mV!vg3>4h*^d6O6#kSJa@u((-ch^-jD%nm7oBy<C#V9T#hn
z!@w{bUXA#FLU)(cjvKN0@GD{@!ba~!;O80I4Uh}~F<e<4#wDa<Tkz+tf2{9)y{{*!
zxE@Vh2mkd#4RO~|`_HFCN)>`<5zfd#t>fAtnX}OofZTbTY}BhBOU(GM3-}4LUcRAk
zp@31eZZLoi>m3imH6vBlqxl389c?AkmDgD>ng;_$f3t%ALrx@+J^HZJc|IuYkTXfA
z@&4xRIuZta-?VMhF13XI{kko?r1e;8OMVUVJFe0JnlkKa39yTWMVO$@8?=4&*HiX;
z2jFV~ya}@rel`0eb@h=$P3Qe&^U@_iaG03xL`CpYg`zUxwO<Q>$}$=%%jeFbjU2KO
zs5K%a4M+;-5Wtrg0KBAO?m25rK_(<vu`JwRsAxI6nzthv8eqx_YK|Y?JVYH2-VDYG
zvVgavNwJ&QA%K%!+EO#V9{%|-?CIClD6Avk<=U0}34@APn&Qhz;HOc}M2MIurYwQ4
zrjRUbLHqhm1Yn1QYnR9!LGtaJ)AE6TP$N9Ain|&D(#FfI-Js(j<}laLtGiy?8p|vl
zNc3a}s5tUDH>CMd8)a+ur?#lpTUz#I!BL4Z!BZ*000XZv?8u$M))tB?Et~HjU;)$q
zjRi5po56W_wsdrl$%|Hc_j6!R6+U!4?fW>bb11-1?O@gQbU$e4Q^WPtdhE^o2tcIt
zc40#a0b=|dI(|TrLt%2pRuZT~avnCZ8e$wJg?#5$(kW!#dlD-PGfwh2N-|o@f@t93
zs(PUN=`xKYSQV9HN=>3<*b)IM|FPHZp*JYrO;+&QNsvpZUrkh8!WxfR!wn8-#n^jJ
zeFL|RxUre7L}A%2X-PCBiI6Kt1<4uf+VR%$@r?N=+a*fNJR#7%3xn3Z%e9|N8tj?;
zKXr&AMSFY{kB*bBa#wsA5#G^yy|iEA;%!MAy)*f+$OPSfg4iy^1sp*<OOTxC7kaR_
z_(mX&cjPxp)NN;h@PyGlZttRpPW(W)d?UUw5R~{S#)m+~+XE^aiTtZ6eycs@fKB}(
zPNH9kXfHAYa15=#%%7mEMJvc%`N<%11rzW_C_Vy!QzEYTLAOY;E5}c$cNMoIe-#iZ
z789(Yoy<rm;Cck*B^nujRnmS}lE&}AW;h(QLFdxtnn2LsQ-)09Y<?SpA-T1b?{s1t
z^bYKh*@gA1MF~f^#-F8nCNA&Du2Z<f*xkH><u?u4Z8t@M!u1k$Du_5wrk^RDtE<rq
zDRBfcdWSKX-(H{sabz)Q&0+;m5Bt5awL#$qNrjwL_!2sd<!jI)i{?m@ALYw&6#~`U
z=7r8?pyHNLq`)Z<+ULQ8T~3PU=2qJxIhfs1v_DEY1YHy_Vpagxb=0Oy!BXf)4B~u)
zFbTG`NJ~6|GW<=aR7A`Md2@80cx}bcJ*cjQ^kTA~gSzx*QEpZ4Y9ev4d++t&-clzR
z+MBcYqZLzF&Q_|6g>@idB!6C2Qt+*DP|os$uo9~~BZbL10ieMzS}&D|E{pu!_OSIJ
zF85zD7wJlWo!y*2o*!Mfy)JBVyOaUrb_QhlE=96uf_5mz?1A1&I=ee6GAg3hGz&pR
zZ9tP1f1DqhrnX%wrtDTj_n_vpsrH~qj6VvaTdat<#K!2bYY}tY$r@YHMucmB*<`<C
zO0i_N0l<H(Wl#RB^RVbo0Qa5bG2v>A2rh*!I5>M?+uqbTkvez^B`M<Uiii{~N*eRn
z1mA#?+tnKZYo8q>RQBRE>IBE90V--Vwu=w3&3Ghp3jPh>wa00*7`)ttA&IN=iMZX8
zUIl()D@7;Gwhwsa+6ezCxgA{{kJ{ceI15XXOdtq0cF{W@hO7FZ?M&Bu1)AiuahCcs
zvLT@`w=JBmkniV(oAYOc30@u(_$y)re&|9ZV9c&rDB!=))h@5!iW44DH;CT!JVHhk
zrFxjMd&B{65&numW2ITdtl!+ID1(5`zeT$Z`=a`ypiLP^>qbj7HrAsxqbNWT&5cP$
zy2-MT%u5Mt|K9Eg3TAMmSh#*##Rmx1HVbIZyUu#d&$P>l$oWCh-F%v_b7TqDmf^wz
zrIMHUiI-uNgJ}6+zQcV`vo3!<ZYT)uYFhw~?jm41BVL6Jh()$Q0C2Ow0O}7MKs#^v
zhF!f0VAU>1OPUEra3cj^C<WS->r6=YqW@&E*XX2?nKaOe@0bsK2cW8uxB)audV^!B
z02pd;g0W`WBp1fy<pbsbq({6WG?)k1ukqMN`fW@z_XXgN#@vH-G-pIm^EMc~X}p(&
zT8<TUytr|AKE?X*mol^vZsnvH>}#`4Yuz&%#94e$5F}-jB$3BG?++o--+!L~KCRrj
z-f*GSH7d$^C*0o4YgWR!6=c#CY(j(YL_Rp(0fE-0PDSNjw;VVxwg43m4?4K;{J8*F
z_RN0gBs=PQH(E&sSF$wN@2mTRT+0U(a0du_uuCbcrpj(N=3YDi2!&VWh^Q?<0h8p#
z^J`aZuuFtTkS#YyEPEI_Nk)}<lsCGtQH2lqKyiR>A$ZqyT}mkJZy<i*+ZEFtu*fH7
zQ!rlyklhU@2q8I|_WnMivO}RmdcX~*xu+6TXH<BcEQMx@(ClR!C``jhW=+i!oB-)=
zks4jtR4HyZ=>i4zOv*v>q=qB!+Ga*tki(H}mKdulLNGcn;EDC9Yw>ZAQtq{&A>r+B
zC8>#nVDE3vkpgm%)4D3siXSRdpzDGU=MEAGKeH-+X!|7+2l=!bJGV{$@MY_tpvreI
z!#iHkpvlv`d>>j8Vmr^9u1HVO#F`{<P$aA}O6B~ctx#0NI@z&HQcZq`6CqGo9dWht
z9@S2%t|H@RkpAqhe^ZS34o~rhNBM{QSvhgor4Dzfh-h{OR!__22qg&$vX++C`KcM<
z$|;Y`O`dFYr<Jtz`QU8n$;cMu>2^&3tS8Smo$qj^%>EualYmSGfL#J}B!oQOa3WMn
zivp#X0aGM-2X+AoiV7XBd&cKJVSr(f3Px8Mi%(5w6;Ku@s4LbTzq7)CjRY`wdxd#=
z`Vt&bazkO#&jD4ehs<|@t!>S+e)50=ySCFvy8v&N-T(on2NK<4Yt!w{&Q8;M;ZaZu
z2R<2{czlaSq``xbAb$>r^$A+%mXTm<gNj&G+WtYSVQv%pBA-Tsa2yZ`b*9lEb&xzJ
z;TxkGl=3|Cuu^foJ-eW}y1u#JFdj7?u_+))uXsg886`>O=L}2BIzby?k9Z`cB}IFv
zxL+ijhtT7RcB+1Ex?$Y^lk%;8{iQJ%Rw=K|m+!d##iT5uIp7G3HJT|b>@Yov1$)F~
zV*>p|m&5F~W7>afL}~OgYJ>`Um-%42%GnKiZm7B1oWQU%6l8yRXbNqEi_>G8@BhtH
zTxmwWwhC(^U*g)D)&t0JxUg0nh@4nVj0%XgYCzle=}H3XBTb!I#*Ff8!?KY_EG*&6
z+9KMqLNyzBj5Xj=zg08nWsyy-YSGC?1|uW_Gnso7lx=w4>?v74cys@{d@J~a5ifA0
zFbc;et#O2w??8ZSo(4&6+0-=PrM{4iO(InU$xedA4E|jgtYbENiwfN1-uG+Bi|-vm
zTFJzy<9;jfgUyNt#`!8sLtlHl&bA_b?3W;{uM}S1ise3(9l}BMi1ADe_0+7h{}|Gz
zRrx9`u+Sq6puJ@@Mk0Z`L+aGUN2TS1S1Is>8M4M`h?%Oi?1Zi$sZ%@_B4|UIA)@~5
z<?E`yYo07?0Jg?97|D#IK+P%}kZ)S}vgyYJS(u?jh*tR-3fmdGMmF!C0iOND$2A%{
zc|>Rc0M%no5>z+R#Z((d5QP+IRY&@yA1J$WY>P*VNL*%j4A0wj0Bw_vW=MoAz>59R
zJ4ILa21D3kCGNJF7oBDDJVH^V)gZef=}rIP#15gPVKVP!O-4kQMMq%B#u|<(Y4!sI
zZO|zyY`~&Dz)+ikNFiyU{sY&D6N<OBS$?`X7RcaZNd|q9!wkk+FollnjiDR3*IDWY
zJ_i$m?8x5eXxLz#u^S1Rm!0uKb%r!4)V3_?LEKJl<}9DV$K?zAa-8YusG=Bw_g&4a
z9VKxBgw*q;UUxl}8_3Nw$cRW3UD^f~2B{<R({;hF2+gb#xS<F3P($9tx?*@!JEBWM
z7QCmEYSNLql<19ex0^La^RurFB{+iT79olhYUIj3R<1822&i!nuuPn0&k8u)ID6$G
z26&*Ka;3+%6KB&BeR~xKIyoK{Vtejl&rthIq1((WS(i(V+01*@O1osk2M|y0(CrOr
ztnCqx#>J3gy<8gde`01FEIfsT9SUl8x=OnCL066fe8uHNgTJ>pAUd)t=CaPX-U-+o
z(egx)A=7=ZDGHOs4+}+(KFJwN;&XcL<s0a1<Mdjak#)C};y-$Ig$aMmUX_6#|NJ70
z^_EH(H`Z^nDt%$E{N(WE`CVmSh@ubm`2Ngs7tIU{T2#b6h9rL5E5LfkI1%ljisPyJ
z5s;P)HxYBmUV9Q3ib{|7T`-y#fi8=JMNMFrKot}@%Q_6TaIKAARbwI5B5>XA&=#1L
z8T!;e{VhdFfR7086K@x>adIF^ga9h%I>(^>PcD!2s7@Xb{I0kQz(XJ^<$5k8Y=>Dy
zP(uB3hXudUi@?J~_B~n=)~-<N6Cg9&U>M(Z_X|HV2Qp3*V_I>}2)l%bxf{M{el37c
zV<72ZkUJOx2jv98W~sUZQo0B^;zEIF-9orXNjR+-H}i-*C3u~lN)2!QG^o*S#9-B!
zQij&0D?_hybi4939MCJZtIQ>{oh7qyU6dv(pb=Z3nI#`F*tH5D+PtAT5VHG5PBvuW
z;1Um@%1X|X2Gc88c$j@TY3~jhZNO{xs=?jbK)h28xUJiA++i&sS?3W9KZ1E5yIUv`
zoiSQAc6y(g)<Wo!P5a4h0@XWn|H=znK<ESd`&HpwoI8t`t7nZ~5bQ%{uLa#7-z3IM
z4S(N6M1@8IM+7wDDD$9{y+Eec=8B$}Y;5heXxB@Wfsm2RnwKg@J99i*eU$MJAYwk0
zZKqDYPVH=}w^+(+s~&+8`;}i?d5qs22D*1mcl3)^Z0o<!Ws41G)LlPIXcF!r0gk`p
zf=CqZJjmV*sPaF1%*AgA|M8M!p+hGrqw~>IV6DGXFdoz;_T2E&f5-%R%D+M+>2kqJ
zlMy_y16K&%s>gReXWhcflZmzvcb%2%sOKo^!V;2dTxh%P%A-3OOGWTKXnPP@Nf566
zZL^Cko2CY5Y$kTj2ooP<5$1Un3CKTk7*K{v#3Ouyq&5$P><MatR}er(6bwG`3*?Kh
zp$`D*{}2ji;eM-w^{oca99IMOgxpHeNZVj(b()l~I4)M|z%ek^YKERBq^lrMzY3Ye
z#?6&mmH<SJ?>2=sfLNK~OZfQ!ZYBt}VbA=)C5!+h2Ns?ROz*LU=V;r<QA||coq08D
zz@uOLA-D#RRvcW|d&B{GjN*W8vqklC@H5T1{EOFbn@;@Y7ikJ8HgHfP6qC?Iu7M+6
zw~PiImxBj@tr90!R{elXL>W9{mos=M?d-q};jmTouipk!w`8d0cCztzF1^`E{17a@
zv6Z@31^amO8hcsHBe)^bWm)lRbaJ5Sx1*lB_?&#~il;^E0U1<@lHa&_9Z?|+P#zdR
zcgsFW9G;2-7ZxL%IfAW(7*xImF%$NO(D1)NdCT#D{V^t@yV*20$%=b6h&3+&ngY~P
zQtL`OXc|c@S@7H(MGFZxe2{P#XlU~|?l)pyay=2-=4f!woV|P%(s6{Q52~x6U6@7W
z3O%o2xi$|#68>)Ah#_1L<DQWlSRR7`T2AmV0wF01=+w>EL=JfdTOthFM>@)orl=_7
zQ+x}+@52)?lRkQ3AGs*7<Rr4O_hD=&>9CaL%(hav)2#9Ss9B;V0NONnMx64>gdSWe
zTY-;Q9uFesI@H+MPABPiHx=CWNKk?Sz(d~cp3?;j*v(Km3A{kr?&&<|aBTQ7%Gx|q
zGzy#EwdhpfY->G?JUTlSh&j~k*dN|yoh-XkL@{WN?qX|-s`dpBJy{M4lWfiuvsIJn
zxtND34-uSBGD7LM@iJJ?A&nJqK-^JlGO+7_xulyy1AZG^a_c1d^y9g+;$MZ{5jwE>
zUW-Tc=loDckfD)el7b!4spiwJ1-SPQ?k_)-NVw*_qgVN-X1DSIP5%+nl94ei)ZrVq
zApg*!@O+gdxokltxZ?MMhE!qxg~S)A=bGrs8d=9D+VFRa8^B{n#I#^-BW(ICgS<{K
zec*?Zt41G*cD*h5r;ynZNQGAZm}ksq-&`4g(+PZ&AKLL2Tu@Bg>!Vr!Q(rX=^xLW(
z{2r&u`{!1{b3O5`pa4Ge?;0ix1Gvy>x+ztX0p91=rSe?o{6dly@u!uNj18`7)|}-{
z{%%yEfyb-BmCwm&h2DP$p8Vi{yaZP{HQdK63x5|||F3BhoiF9HsQbm8=XTH+aM@Gt
zay{<!4*@m8U;<P#Yv<_xP&o;vvf%EtAMDG)GI$n)1{s(D1_jMStY0_4Wg$y2l`4-n
z#=l2sLOM#(z)VS?DRcQ#pq72E2p9W!vFZLUsp_l3Oa3pL{-0%2oo)pegU!3Yz!cTD
zMEEui1kZ*A{RI@pGoU=?EKB|XY61f+&p8R2u0M!24Fw~bk>957_dMA1lfZyF%#B<9
z3n)=Apb|4dbM$`zRrd_2tI__y{WlGAFrZ`<v~2$Lu97vM0d>D)-0+70MszR%`GsYm
zzkp(T29&omoAw_-B|ZacY+P0A50wRpU@9jBUgQ7ipRmY0>)ozJN!cGNRb;?aT9RZS
z{nb0FXT7_qomBk;`(i3EmH*48|J&Fkbhu`2P1MKH?R)2Em2po1a^|LPDFGYnUyYy+
zN=(`?!wx=@bttbp2s#}%(t!!@4C&FJjkPat=>Z+v6AnpV|44LOR=;7NBnqFl<*kEQ
z<~D#OlFc?%lyDe2d#l`^Ci~x!r00*be1M?uL_kP_9S!musJ0H9n8ykMN;GPgkxz^B
zAuVG3wsFrHnUD@CQv;ffMJo9UD8(V7pIWn)M+`|3%E&nH%OAu6RH4ixJX)iiyY_oI
z`v=ptM}zdrR7<4F<<90Q=KpP1t*nvyEeX9}p-DBam<P`qz{!8i#_iLCuKV3@DhTvD
zZ(@BL=A72iXp6}ugA@~<q#S0Wxnwu{+cx9kLyAh~jwTDyvAxL|<eA~1^oVJ_vyA$e
zW3m*G+LGL{)Zfp*$;=QLkA*Y!o>KqsVM8?kMM^&kgd{=?6D|f~rD@R+VBrik+;@20
zCaOQG$_qm+ofDx~D~A;|>y9|7{6`lK(UOU>*-S@)JfxuWnO|L-=aYfkAF?6Z_=V<a
zXfW(IXT|-01Y#zpk0Cn1Ek?M{CS<SrEnfY%&I-Zw3hN&<*;wbuX?aF$2CDpR$ZpF*
zECPEU=X)vU%qv~4xwpB*@&B;7SF9t$g)?!kk91D4n8S^+?A_mm<o1~`y_}ldV3|hC
zsmu<YzgKekLpv)5UiiI5y;vG7xPco~Z29L6L}3X2uJ>=k=6uMSb(YoRcds01e~(6j
zL1-P^afBLs^u>Jsamxm-Y3x5;z*&r$$Ar9Q`Z<^77&j2A(C!~9MfKBQTxJRDJadqH
z3NGR1y%6GMf1g~R9{!*}#PV7+&9p|YXMl#{&nl3@3OSaIV~x$vQ-(hjbkw5F$OYEO
zWP%navd7PoP5yd&F(LhF(IG%6aL}|FURRp)&7UojJ9?<+T*~;nXtDp(n&*{(h^gTn
zDqcLPm8v>i2+xWAvvsfh${M;&^LT8PAj{vbDL9>S=@X<<n73}zvHa8W?s!2_$@^5i
zh-QO}6#DW%n$k~Ue;NW>JjIt^!i*RDg8}w8E9B45j!1E%n2`L#cPXk$#1CeD!4j_7
z$Z>Z!#{c<7g*FQmFJKOkoKG+L`$$4C)CnB`w_+FV+CyPN>dVu9z@H~+kp1%{F>sv2
z@Hfr@4{5}9M1_NN&@y@ZB~1Q!x#xzr%bSyf2J`u*g#Y%I$t$t_iE(Y3N%`t6bC3S>
z`5}y%7hh}Eb8O5Iik*M&3J!mepPj{N`lR&ld;WCK?deTa#jQW9Wg+~-4cwe@=U5;W
zq^bV{o*|4+g*IllU;gvJ22!w#0>F!7lmAvla3m`88C26#^3SIlMqsLS+uNJwcwDNR
ztEcod<UHN&O!)WB#5A4d%f%e1$|uigkEx_m3ocuoG~zk0nX#0X=IUJ?ezvtH=_%U*
zuXNlkS|?jZ3X1ujNuGHF<xoGr_;oF}Xw=+Xb3O_~b(P$H6q9z0QbR*NQNcCpm4={C
zwYMRiOfHm;>WOcXH2S-6X)1bp2b{hD%gZ7Rn#a8PeG?ujMgv`AC8chqeCa#J;n<d%
zrSR0tTbXO(maP$NE<N9sCWig<vhd720$M2Y%3K(a)}^S#_Vt{y*@<=&*9!#jP)>t6
z!UjWOoJwE#<>gXwoW+<-4dpJiMQou|B5qw#2>XRPk%Uqm#=A2<@*p8BwQ&vwPXv;p
zdT!x56R||qwIbDGt$<JvqsDRF^jwAu@6b8pKG_|hd9$~5TGwI6o$I*uv?)BXn1C8g
zKpdFOF0tj`!NVBI98ma1=~lO=6tidje1kdgayV)5T|B*6KJ7?p(St<hH?t!awDsiD
z<BSU7Me!C=sWE)zYpNy5(lYGIY80Y`Bn~kq8iiT!n_4gB$3)6k14K?YU21Up>Ka}P
z*8iLxp7R~A!Le)c89Vv*3LHdBJxB5V3KAgjjEFWj)ZwJz=39p|$rzR^jSYtYm@Z${
z<Ps#a6rOHHQ}}AEK75f3?pa0aysxK0+of6RLDF^HPOLR$VWuT)0b$((;q+157$+a|
ztXyL+<>z*BG_ufDzE_{ByrdAz#hA>o%vG}CAcO;0=sNT~nJrJuv>$iYsZc#{T?^x)
zS!+SoDR#eCWI)bB40Fb)sT($x6n>cy!lE+%<x;tZZ2lyhtgw_g!lSy=k8H@JO!+Hw
zFCP%oY2#Zpd8d1?cHIY|^qdyUNz1ZP4lcs{7{D<8qi8+Z6CR;hX7(by*t-^ogk(B<
z$~+*Etz?TO)^y3FY1vqjTCDtazeJYLS?FBbV>p-h^%7w@mx}ZA&`d`%yt({*az}|K
z7@h^GOvK>|Bn+*V@PM=g(@Yj3qpe%%Q4M&e4QzzN?-UpKO#^w_JfX-vQ^%J|Hl;Lj
zr?oN5-8$H#s%2d2E{gq#Q*>y!S}x-z?t)BBt)+{DuMZh}2F0bsCVez)3;JW4G%G~Q
zR2R%~>RuPHs6-i_T=bMRwk}^TdRDZ9fP!iT)4|U^)e8>NeXb2UxDEVT8wn=a+htF(
z8x><P(RU4Xz-YnRiz~)>)Vw%3Mh-F2O5}F%B!AGPhE?gjIQy)ch$JO44rrN>TE?;x
zb-TVsFTj1CnSk=z%h_#&mQDUFBCtqGFzT-1JcLfid12UQkFY1Hywx$8BbVFQ=xy=p
zl8Auj8i&U1lu?O<JhQgv<WdRh<aX`%m-J0wzv~k17bM{tU1tfl!9wt2g_&XU{5G%H
z2}4Cmvm3w5@%+d#jRL3`G=Qvq@V`W&dfB*~5;{l#F*OoPiY6tyo0M$dj_Nc99z-Q1
z=iXWCWA&JT2mCGf3*BR@mxB@BJc&?j;n&S37bE9rzF=fvDly8fPo?87ygX3VE}jaz
z^D1M_+DgDgCE-8a2<>4&)qa0|X`1qnS)O^$Uz<N@B!GD)q`#^Dbn#KCQ$W0QU(_Dm
z#1LT{U%6itlOhXANmIKx15GRM&Bqkm8vfak3br2>@?4!;AtE=kGsU}XGLaDLC~d4I
zA6_8R0vGIlc<$5CH6LrPZWXQ@GSS;|osYAQNzbI)T4Y|1deoJMZAW^GHuRTrt3-jM
z6E+dbTIP)DER{E;nqAizqWSJ3`zl&D@2uLlUrUev6YlUnXWoSfC0=0Fq}{8}?Q2IX
z%L2-oIwHFVT^RP_wK4X-Qqu6^)KGm1S|GBdULP^|#yVf0i=|nx-O$%S)AI>unCN5j
z4zNue$UgX1wNabQFa`3%;g1{@73;?jazeDxhU0wFXAAL3?^3I?wccLXm{@9VJZkcn
zPtImdx42`A>y=;^{Gdt@w<$M(E-%%M{8DOrxXq(=?J_lm^7GP+<Y(_X^UYUWz=76C
z-1GF9KQTBV0p+^A1LsIWZ;8BVJ?^ZK6cSOYzwB1;rI1Od4V!*IJneor#87i82L*!q
z+BhYt*)%WPmt7@YpB5Q&R<}?b$*ST^B4vF`8<RK#lO^@q%R)@BKMp3_RF^x4E}2zX
zRO`D!`ic%im~LvRD{scp>!<qL+un!FMl7AFff8>ox5t1;uYIS;1`W~27U=>@3<(`j
zgi(#&cgeB7w$qs;!Jn7gEeDMiZkJ^qOV4ot_{$Qt9?sh{UyRX{-Jx19*J6gd8T!y=
zif9S9jWeh-t1LfybFN8eEb@%#<!jcU4=Ts6l5}O6%81F7sj_iQr}nel8_Cy?VVaRg
zu%j=?asjnU*!;_|K5q3I)o|6S&mGbn3gl*m)OS7@!SjGjW$q8<+n3E|;@72kAD2AZ
z>!-H70!&1;N;J~atQ@#4>Sjxa2W#Tv$wt3FEKT`;bg#jl+|#H_>=t7lm}*|E&2mw_
zYt{YPy_-N2ouw-^y?pEYFvh8-r%O<V3Kl^MMdf&j1l64BQG)VEF@0BfEQvN8{#z<}
z`brJct!sLIGbHDndFueIo*>(js&@ozL+O@VE)2oUgK4G%qH_6UOR`C<v|*D4Q_^aw
z{k(07uU=!I4}A8IjGa4Eo}wU~^RO7QB{i>+k7eZulPSxR@QxA*@mRDq^KM<<oN-Uv
z17%VT9M)axn!SG?xH@W?FI0B;rkQhludFe7JdV(5GSIv15iaNURytSd?S8514m)se
zpXSl)eSS^#lz@lj<!*igO%%ydflT`u$oEdc_pE)E_}dpTa3r4te^6^aezGIVZ;MX>
zh5N$4mW1EI*XxF%pwN2I&wUjBG{M~zh#d(L1EPf3#tX+lv(KZOMn$WfkMPP=vi91{
z`@)79_gz{*zDz?L2l4HKfhtHhK8ul#`ytFh332;{(dSKf1PvMnj~HaLHBGI}Z=*|^
zf*LYoE@OHFXLY(wQ@iz^L?s=ypi)(t)X7Vp7OQitEFeyfrt%MLMunMSFD@cKZ<m+>
zqbm=YSi`coOifMRrk17!jp1{7c6x!kK3|8!OmD%HFY^RUhX{^JEyI=p@UlqYnn9>L
z7Mmyx00pXb@_>OPTs1mPWuV1CmWRD8kQq7B1P&$H#|TbqTph>AC<Tb2`Mqh3Zo8m?
zZ1Km}US_RJi~7(?t@28CO|(I?0Y3cuyjsU`G_6!2wyTB1{6|3U=bKsUM_P)!R+sjg
zsYB3x$>EZtAWsG*gM}|A`)+Sl{$c4@@AcIFTB+64{<&Di&_<nQSxVt$Etj70B}WBU
zTG5-SY*P)YenS*Pb=^ZiSy|mZk;(GXyrnkCb@^J?_cA6pvw`_`VnFvXY|3juvq0uK
zHU_|ePlotL$pma^<6*+;;&ufel8Txm4B4Yo2Dyy9YLIdUM)ZM{sZIdTMkzw}u@O77
z2UAr)WS_MR_IAxiPq=m)w+Wu*@Arvcv_I?jqztiZ1Y05Fn`n8?tRlEgD_SpdtOlbi
zJAtai<0+)impsO7Xc$T!F%OT58Tk{gr`N2peKi7!=hqT!L9tg&8qs@%k(zbOgLjLX
zt*>aTF6C`(z1!ZOO*}kwE<6aws8wS@TOH6<FCA4}-<RwUT#`3B9%mAw5;r}?4xk*(
z4_D9F`5aj-Kjx%u<7^F@>pYte`z3J1Hbj{H5*)PBA{a}M{CM@yOn#VH=to}sqfyn?
zEiEyMLq#35GY;Gm3L=}fqy>6uz%!rsu6D996J%}a*N`869G5%{N2qg5Fy|50wB)pX
z&8co1H&AIxx2UfD=_+L;u~KxRSJI(I3<x)<T2aty*cz8*eH~3RJDTH~&csVj<N$Jq
zE3ZzdOK`EvpxEt?FL%C4pRWnd#bhZ5soHVQIh8e<=IYp$)@g>P$6-rwUb$*%XdJzt
zvXa`aZatqS=5t##2}U_w=9*5m1Exwb-)<$fz3-~A)8_lUD0JYy2X^A%!ENw&Sr8PT
z=d>e)o^~F0bF)NvQlbo<IQdLLeFPp1W<K~a2dY-&C}iRUDCfp!_y{rys<yWVxAtFV
zNoiATsG!8`Q(|jkrTfja7S}>+YKQv73Az&^)8<y_pv%5-IL?hQY_e=dYBGJ`gv*eh
zJHpOrX?iQFVAk5TJ6GILpP75C&iFMaa7ntN>pK(>J{v17qVLFY-@R<f5C+FgmnL#*
z<{>w8nn0|@biE)_JcA1R@yIgr>o_03dWlY>>ra1v#7mEw-qZYp6V<W_f=eR_c?xJ$
zUGl|(b~>;qx4|X1LoWn+@Bp&V-M8&(2?4Xc?=U!yFJ1Bczc9h*bNZE0vfP>kqtEO?
z6IrAX>u&~eI!$4+j1FFC(S4I;j+v9E*yN4k!Y#lo0RI!SU;hih>i(FG9|c*Q--KyL
zXxwWk+^lLsJ5j-}$$n*ZtE)Nj{q$Jfq_qjZ&YmgF{cdOj_bao$YGb<H3+pV-lAJ|d
zJ-y@VO*o!UUYqm?^nG5Yb#-IhriAq#?Zf`?oLD;f%ca1vQt-EHBV(^J$(xTlsD}DL
zm6a@9^@UUB?<_e@4<^6ccqGY}*39<%%W%qnhaLk57xqWbn9ay=1Q#xaNZoI0LV)LP
zWNAO@O|}KH^QC>038yxqZadhFae@OJ-{D<w{2#8qDy+>e*t$T0LW{e$xVr|YxO;GS
z2<~3P-QC?KxVyVMMT-TBJDl|UpZ{E(t2epKWcKVeYpt1=Y)JNfeF~Gfqc&}niR{C{
z?ULJ;oS@{$B%0L9{yWCe>2=$EuL5ihdrVaeZk3_D83P_|!y~t3aDlGAbuq(+D^;`-
z^~eP$Ahux4x`&cmS0x5d-yO!f2_U<P%a#%_rS}tiU;y2Aum>d)_h-v^+?X@Bxh=SF
z*haXzfKC^}Jh_0zeAae0o%_=VS9ii9f3afeZ#@}7YTFP!QoE~rra))Za@$^vYx-`P
z67&*uf$9P7%<~CQ`)fDGVZce}Yu}y3KCEIwTBHg2in3Y=t1hmQ56Cg6xMgCTW>8eE
zxpuS=-u>B%?m*crqBPB$LyF+XNrVSV>|ipxDS@3e$ZS50rn=Ic)ywj3+|rUS>LZE;
zA}K3rn){+phx^QlMr(&BS7=h*wfLf-0VR!=m$C!nIEe|2HJ<iR@07t1c6wx(>iasj
zNqNt-w&=Voe;V1ggFUhMxDdGNW}+pAg~#XTbsWT7eZLX&<WphgYM$}J;Y??0L#i=+
z5-wp1O3*y7u(vDKNF76!7H7KKe;vsRROR9Ku^5GV(3LR{{jMCIwjO=r>FyI42VJ8c
z`apWI@vGW>Biir%_?vR(h1VOwl6I{GLV(Geij{HB_^<BB?dDt<7Q*h^01ki!`6Tu{
zLCYX2c?b>V7o58O?kF-Y9BCAF+Y>1OG8tIkE!NmCDx%tTZpW;xEuo<J>RLRD_{amb
znvun_qd-U7zKK6mF{$3AZsj`?fT&kHGr_ho3nQ@kLui!gdo6;W0~$esCq8$KdUXz4
zIKim;{=e&95Yg(>TzD5*mlkU;Kl@8u7SeL-%8OFFe|cCH%Ped-19$yV9#Q)IU!8UT
zm$OmHs!;lZ7j`7x@Kn&X+PW%F4>fGOXDo=f762k99JppJ3Snc3{2XuKzNV*)l#QdO
zk%+xu;iREhx5N5#));uqt)@V|5W~05gJi`l5O3$ZDw=<rNQq+x1PqQ25*>7ibq~<_
zoD?<Id?T5!YhRqw;)tm-8&F*}EXTG@9M!?7v{+#;CflR?6G<%-{o*-xERUe`qHfd>
z@YHK`7r1q>SI(7Ew`j$Ece>(YbiO(8AUFYtQnFIlooF`bi}}SQKFhaSw<Wh@&{Z-w
zpAspx=-m-NcCzJr`GJ3G<5E!5w+%M%Ki<*@`g<FPWJ;l5U}0BAV{h?<cU)8A`5GzG
zBRzIZIbbwu675!51TC30j%auJorl%+vth*AKwotPM?v0cbQHx)<GKS%M=>1QLueG`
z)blZ(_SW>4-*$4wGK(kHL9~rFX#;1jo|7aBv(4F(5Kg|#!ZD{#o$%x<v(hcYvl~88
zTe?%X2G0PR1s{0+o4Q#Y3Q<_tf;lq}dB!&mxKkn;2QFKmTkf<g7q`h~oAHSzozuRx
z63ax|?P43BN68MM#)~(gve|{K3)}HEeL3WC_-JlOk*V^wO-i`7J>dM#&}~JiT=740
z4U`TQMH*G;a-qdn=8HqNeZZO0-@FwbHI89Ymw?n`x_#71W=RP^c8+U=)7V}r3c8L?
zx;xPOw>(t4U0zB;vZ?w)KDw<)MBmUe>1<S&AQ$qb-Kl^jIg{Ocq^RRyn*+w`XCZI3
zv!1O=8jcm$B#-oEbGC&1t08mTeqK}Wq^<R04||xHfoj^30IHeM9mYYrwwipx3TuhR
zA#?F^*2AFcFP(Lh6{~P8>Gb!b)^3~xro1o6&>^jDac}C5?LTq=0Ga*#RYBiv=Z5F@
z5!T5TpY!wHD*amT!dk=K^EOQY#4=!S_Ql6{`=7Zkq&w-~AN>E^{ae)Cn=Ozj|92Y}
z;A#1{Whv|>kUBOFbiAGJ9b6PG2bM|Ea+bD;Q7~nSW;lkDxayH21q%7lUS?#_YTOum
z(RIDb7b3@H70seNcA$ISicRAi!Evcc{DE|Y+_;e4YswM#omgX@s_jjfe>&SV?e_9d
zH`q^s?01ooyvL_~DwTQ5S}?LRydSg&jQj=DejM&3W92>zxupIUAJ^FN&QIikn?kTr
z_?q<88=H8w8}AJ)r}i_W9HQ#a%y<!{kMt(QJCRayBl;-Uu@f3ESDdt_9obinIjP|}
z6>y&(@Gy0rl5H!X7V7_xd+f&j_ru>6tU-@8+4sHNE+#&P4|LDEMXvG*sU9QicDJTK
ze~71Ol{^0yUEoYY;_6K2FHaDkOb*262<(^084tg9j$f-V^0og|r_-GTli=Tq%rS_G
zAYn(ui!5cFYEHeH0b5`(Cid8_1*!1h1#!}^!hb}0%*>D|Wc*3%=R<7XJ<ds;UF(K;
z@^RXsXc^?kaHBlfq;FSvCSJv6WK&jYP(6Rb<qN_Y>+Ns(rN8;N45Pat<$7#;I|Sec
zdWYAfuy}KMe|Wswq?n;M8aLR(aAm_$wfN`Yu4Z63pyesP^05EyG2EeE^6(!8{oM|#
zJg*^8QepfD5tRgDgq?(+?DkYhw&U5IP(n?^QKo4y{ApCR@o8{(3mSqVlajp0BuQiK
zsVA4^;ZTC(I0%ASITkdSfg-)NfDjoj%9NIs^)O|2RnEzpGXC#bS{deSmI10cfbH=W
ziv?$#4>g4L%?6|PHZnkUf=YQ4WOKi-!b~&+WKSTixlu)%1?NnfAfxEW@w7uR3U<A)
zKT((Ei3mSXY{&g1$qPu+pH|;FBuQeNs4m6%<9#+*t-dQC7L1TBqwSMzTQfz&m`oII
zTzpup-9^h5aPoz?@;~^b9|y^gtBM<y17Dg9-`akL&*+{d*fSWi_(78$Bmw0z7{0bb
zod&-@xN6n~3!7486uu#OVdY!PJCYg6&h!gjX|1TJ9T0GY0v~%vQ!UL2_Sf0sa<@+9
zRW##5Im6iS2t=8~xL+*k$Lli_6_GXhn7P}X%(+U$KE_6<s5{f7#8Dn{<zXgJ`1Au{
ztb!?04o3MQZm3iWarRwH7D}i)@;Ql2U*$3%YCD!kS3yOY6Pg@EqbSRx?^>seI*qBN
z=v=*D65Wfn9r8YFldpCM4~@6BYw2oRgt)iN`CZN*(Ih1+H7+dzLOZu4z+WRCT&2ZP
zO-q0~0WVb^Z@Zs6A+5GmbPtDO|5_hOs5DF@A$14+DDeGME&zi=dm;!QgH57xmcESZ
zAavWvggw0!zp-Gy$!mBT1k$$PSQ?J1p@%DcX1DHdCNrV!;|f&W`6{5@sroH;DU4l4
z`cZX{tSrR%O)tYHX|iZCcWmc_aJIEroYNxBTF>^{vD0l^OKk}PzZPlt#kG}a5;V?y
zr;TgI<y(}H8jEj{0ii4%4!{PEc_dZ(ItB|69)Brvr1hj&KmFAWAr5u_MWEv-{m=ay
zw<y6HuKdV6l?mHKo9a2J@mL??s#N8XZJ;f<VxPYR3N|KcR-lg<Eea(eGIrdFA6j*I
z9WZ>F`uv#lefmG@isIk!T7P~z^ngco@1pf@a7liek)h5Sha2cQawEdxl1hfi+maVt
z$B-4uf3H13SVeMEn?!OMNMH}w+6${B7eP;ruAFzLq%hlL<0Lqv*UdDli}obSH&a9L
zUn!eXjWT{8E=5p0Fff4mUY(#Xmz&+zJ8DL$Zms77@#|!*n(c`k!)ZfLl^p>F&b+~l
z<v{U~4ADB5#_;bFZ3z;K>Je4Ee)1hTEc~^8NYFBS<gmkgG6}{80%~&+?ljv1CL*fJ
zN=Bwk16@GJs?Y|c>KYS47F=&gsqY)0Ww<=gGhYy@R?b3y_Ap=kI(7Fd{I-Ml+9Fl}
zg`QC5A_97oS(sr%bN%n9@0&WW_b-KmMj0_|f>&~>E@j=d>J0QZm!IC5;kHI9OlBN9
zwH7~{Y_hueJ7MU)vTqMvbN7ZY401DVVm2GkewqogooKn9c5v^Lt=!4lMW>sjC|LwI
zr>#P{izKi`m7s2i&2iZGS%C@A6<UF6G-MUCah)nnRF#o4SF5Hl&2D(?lwH<>jGk{M
zRg=&-et9~Wn`~+kGlw5iwm>)m$OymTFc87)=aQ7x1Vq(m*3Y@;CvleF7_@cNxq5dr
zMTMF1@bdeTuFctVK?aChyHh}31sX`bwXFM()msl$OE1gi)oqGD3k1;rwZrL9PsSQ{
zq&@V^^TH1FWpg3M(~&2Hsi}pO`5zgXYQU1RuTe}WlGS`F<Uw7+mlLq_*20+x46kb6
z$MsF?=i9YoKt!_pJC^~n6#sPR=$m-Pbp5HXvalIE%9Qp<K+pjDH`NIjSZVQ*j6Ldc
zZ=9A$d>?H~o3(qrNm9N3vYB8TC&K2ymm}~O59)xlc8Y{Ef@&=ayv`%WSe#tw(L7CJ
z9h6H3R`bL<FW8X8;~Q6UX<bcAo2D-={u%a~<Y8*1qnWC%I;ars&eu${ca9;P^B+iJ
z{vBN}tMIyd&M~HL{Snc&;{k8$F<baD`+D?0ApQZ`8dLl}O!|-Ye6etPc7p3^CfE7N
zHstJ~w+<~e_eK>{xTbkOlr3oU*-7<#zm&;*5f6Jw(Gzt_1#R<7V1#Bc1S3sYTJ|Lz
zX3UP6yNsd>%758)b>EQ<wJgVzw^2d$=PfXKh@=EqV;FK%+Pv2C{i$E$rZ~7VeI*ec
zbkbF6&_pd#1?KCF*>KH;P~V-JMC*U#2S|twYm_@qijo)utGRVuCM3hle31Uk=J&+J
zY8Q{$lS+e2CN@DCU$PyCtrpMg86vQCIY9Kpa6``t7OToE&7a~LGRkCSxo>q~!}7Zx
z+Ma|SH9z}IM8A}50{&03D`R>-j}`8Hok=kD_MD$)<{lWgh)#7GD~MLG7CX)XP1Aa%
z)rlf1mVUUyC2~!0x;6e02zV~k6Wfm^85q*Mns!<$Fw~}+1YijP>##scGrdI~A521I
z7#Lz?84@j2%E{4JqJJ*Hdu|@z6f7zoFYu-R<<2)T#JJl%&}*pc{Z(hP7;)9269~8O
zb6RVGxO&IilRN*-9Ae=W2#1D?hj-U_a8akRJdBcyuaU+mXdY`LeB?;&mv#gBjYt&6
z^w?3d#1v-`7)UsE{}ChaK(Wutw(*5Mn&N9xH9|Q4dJ?rui>YaC!|K~5bivsUVrRhC
zW{3CHe^^}%ngB#5Dh2<*>+jHNahYVS5At6UT?X^;MF%Ol)%1#FGO)&<rKB<9X>NOz
z0$mW7_dW?HhvLr5w45MxvT)N=gsC%%H-N>M;N%EEQK<@{9J!|EfCov{PVHY3iKg{M
z`|_}CK%Mf%6p6*Kau?z_qs78;dk!b{N{a8is~v`xV(WQY-DNs{LRDwcCmrOF1?a#<
zEpQTWLUmfVXbV10@N*us`{P(OF);<%YHJQ~IwwZut}kr)Taz~`8|2>AWkHek&L{#K
zvS`VOJ%fA44=UAVmMW|a(frfQ(KeG>IA0$`h^k}dFBxBVYdwo{rQ(uEgZA0${QPzE
z?ODzN4EiVgh#Q4Ks~<Y1#D4_<N~ZTy?6cA!=j-`@)1ecz`9xdihM<^Ff5I~%Y7xcK
zuDC9t%$8Z9V~f++K2IH;YKvm6x*y_ko5_R-kO@X*Ki6tulOCsT4yjZfN+?744jk>8
zeG6<BtxI(s8}swC!%lcGTNw0hV8hcS!dM%qU8sK8&@$@YY<BO~$OqPBfDOlPxl$s4
z8$V4MS@_2L!fo$wmh<cc%?GSEt8SF2UKV5>DtozGGPKh)h#~_A0_AXT8+lC=CIkrU
zS2*bld9;72?5E7+4G|*UqOz?Fda{jCr>seiIf=xLTcv#9sC1XKPkW%At{^K~l!s0F
zF@X}DM9L$XMiA+@^|bYN5O53j*$25e<Oo4ov(9*EXgn^bd7y~U@&on|X=Lk3;WVq8
z1Sj%<o_XPAjoRjnb_9bnI<_o4o9QLOMWDrw_ziFr*E(tbn%KWdRljyTzIj&4vaV2_
zbyz3~`8V%w6H@nVyd--PcM3k^h6A-T2*(o8J6!gy<#9c$nfvonN;xok+3QzBuDdUP
zv7EVAucVzyM=vRHrInD4WMo02dn>3(x0H#Kzr#I^9j9{k#By9k_xx4~w_{G*uVK?c
z%KGz?F?bQ$+-VYyr-`}jOqhzbTylDYt7A2JX-S7nCz5n2;rSsuY`;Ej$!qGw*VHGZ
zSn{f}*s)@AGoa%ax}fAy{~`#NKw1q$@h4o6UDbX;3;6r=w%g@-k~;qQA6$Te(!}qA
zen78}tatW}yJ+e7+m}KVoHAbMScn>l<iCh``;>tMJ}D~)tq07zWzLSG<w8Rj@Avla
zRR-Ary&FKp8c1L$afV!xHu)Yh)*$|lSt9iq%sM^dsOWw|Cr<`&e?WmqR2&6}k7+lq
zY2zY+QyP4Sszmf7ZbO7MRAt6Sc16WNigA&sK`>(G_OYSA-B-R&*XlZ5CEHk05w-Hq
zi+x?v{*`sDa5QlDn9t`gIY66s6e$<p7T@NSG(s985h^3YXl5HP;82q^zv__wk|u{D
zw{cHX0+k(%`jBk{xp0?0C+*5IES2%KSg;k@mrr=Z$>>HBF{(*m;~r%P{C)9w9Z$by
zw6RF{xqgJYSns)^L2&>pLro^#ShP_>m`zKgP94rGB@=z@Zb8c?cxb=y&&Y^vX))Fo
z`xgD#bH_Oqj;zI`7C-?g{K4_R+|)oJtgp*^+^=8^we*1K1F@Us?-{qjae$?6NftYg
zPnfKr(Ll~Rn3?8HGdrtFfT6=_XqgKwr+7MvbhNAK15BgNeu{Nfxg?YQIG6UawaeD1
z+Q|whlVU3qF2VQ${)l-vASyPkT0GpTo@Z3k)S{*KJJFc&%GYEuIe>OUTn&AF8aSh8
zo>sy|QotsfO&wP`0sOcwgKB<NX|hMO8ns2+pxTvo`yQ5o+~&r6knWNb(^yJOC9uM|
zGFOD*DpIE$myM+w$2_t<<(ws8M``o!G2m8M`}==o=F68aGq~N#%21~?0qnqql#1+O
z&aBTbWYK8HDFK7$gW$e`Y0?PGRUxwwE-VM_!UUdz2EC%c(>mCFm+y%58!kk96RfEc
zKbJ6Kv03r26)Y`UtvZ$=k*J&KiHW49>;{X9kABUrz06T{s1+u%{iOWM^9J9u0bDs6
zUeG+BRtdC!auJ^ZPTV$e&1v%znqwQm#d4+F1izNyKxfKD&?CL_F{e2A2sFL%d!pK%
z`jvu{YHbm<LAheChqGfq(txm94FNa5+l2vDqOOKK(8EtPD|t0=twDLLtYgi}1*-Nq
zIlQe5fkT$$C}>`{VRh5HemVm0I8iXsgqiv8=gEb<ser?m>Q{$z5YzCA1xx5ZZCgns
zZz5m$pMCt(_nmvw#$fnO7F@H{EbI*C7;?b06t#e|%7NTh|BDIA*i1ni8loDBR1~MW
zWZjmEcPr*UBkmWJxerV!L}b%f%rS${sq32qJK4;G%8ct1^naH%zJtLd5u$e`$dAQ0
zw$)%@GYyUOdUoIcz!;hyk(Bgw$3C34k8?1yLR{M%XK~|ARdus0V^`IJ`zM-2`10>u
z^k=%T6Xved#3h3{dOU@iZMz18$m5%J_mPPc6|SDCAQlv;%3q%syg*zry4Sv}_(>n&
zodBP|;lF9F4M*jusQKB@fW=}BeGLwte)&^u$*hgJpR3L!UpReSB>A=!#|0DL!f=gk
z1K(1}Z3BHW=Puk0@eQ|S8;qt7t6WmobLiXkY_@0o=6^n~56~VZkP{m!TeHFrs2L83
z{h~I-#hc_*BXZwfboTLuE>ij=W|rHBF3?=Eyt9aEv!e%#AT^PwVZ)DQY6(l-k8WMX
zNi=NcFT7^940H$~FaN=KNT}wrXRJK09upaHnb?5Zyo!IxiG<_ijbq=)5l%!u{@!#i
ziBLPhx~j2aE`-ksI<FJ3yE)}|cA_La5@lz*f#ucS*@Y>1>-k4J+5hchwV&eoeW420
zXYIn#*n$Mj&^BqYc<m3|^E9)i-3}ok;0?j!aa&Utv|ASj$8D$gzOxYV7yB90kFi3K
zChDY^``^KCg`8pJH3%0{Errn&d&G9epoB-Gel5tW&c2agX8{JpA+5Z+XIr0fta2z=
z_$gF6uhJKC4P}&nL*wIx{g0_ic)zG9!7zkwa5|!5?-`EHpfBDWD=$fwD_g8uD&!ct
zVpKFCL4lk3<7?@zgDFLXb2R$ZaOMn0AwmJI{~EoDo@H|-FX_A_f!%R3j&1zaMIPBH
z2sU%UDE>uZI@PpnGsL#>Dh)zvA`I#=o@JshJ4ga=?43FWVP&3Wzb+{WEf~n0$aJ31
zCpPTMI@|!3CIhy>EDnqON&=0f4Z<8tvbNzYpll&dLr6m^`VbqEQ=&^vS%pA@L|#gN
zs$OC}5Q3x9G~5~yyy^^PTWhrxyk$J-&g(zc6_q|<+r5%-^UYXKnA1tnEh~cxz4NIG
zjX2^E<{ICNcCXUuCc1X&Z0LsHawv`p2&k3sjRHGg@1)+gp*893?xgU)frI}&cikWM
zl>BgvjpOH+uk+S@##`D)l_c-v>r+d1_<Q>i__R}uCL5hazXO(+dnY*Y6)CVldRBxV
z6HN1qbejLx<}RN$t6rmy(a!u}G&j=J(?uRNhszsoVQ=s{ODP2!Q&~k8CNX}gT-$+5
zqRv@P`4sFCp|hKiYN}LG`LZT_pYPLoS=iEYJt%f`V(4{vn|yl2m?_|Qt?tLvdIX=m
z?)>uH)Y)9`eGN`FBx!1!Qb@uBe9uaRrxw)47PSTGC6KJm8Z^vKmA}}`j9s~B+~t)R
zssrOEN9Gth78>%JNbwjMbF3$^LQAQwHv$?9=J8iy5yA(A)N%_O860A9RmP7$Db}*2
zV^3)2w|LL&acW>vawnc0P5H}1(~96<S~&)NdkNS6kMi||y%?=^R>pKPUz<+SL8t^)
z(Kxp4rZH5k_uz)A8hpU~rAPN?G;&DGuN%a9#dYynI4OhetD1wl>5u6Q(7ujZn29b5
zf6upu4~?K6AW_0cJlaWmsvix>k={T1&<K5v?O>rUoZ4Ecw7~KTIP(TLgGLtN=liwI
z2Zz_kt2>DPxC388`*n~Rnb-3nPp2~^cl0W|so5dG_jG%A!UE#c>7m4MOvPZx=XvzA
z!>YluSlcNhNk;0^zF8UeNYWo-`-O?w0#%5aQ`6^4w@WMrNU>4|uh*q#QVmZCWJ{F#
zDszUK=#r5n2=}K;j2Gw=5eFG+E)aFYIex4KWkixNeba*Wp^J6wi_UY+w|axra!swr
z(TmdPt(RgMp8@Bi|G2}rZ_pkY0}8ESVQI2Mp6q@F9ijIl#FZ2OF-;T!IEH38AOGZk
zuP;e7RG+i4gV==^j{TRxX_3G7y`xbsP<EtO$}2SsjDt|ZUJxExvHFW=EeR5FH_549
zYKv}jdIbyv98BlJk7;}`1AkXvWX|#WYcZfyeeDm?e><DO3TEk|?5uEllro%tuGKs}
zVa^0)Ge-GCu5ozI-_HK%tp;3rdY|5JGNikxH26HvXAL+MHR&}j`g4E8RF17UKdqo)
zU^s!2{`+z#)=f=ulw;)#CyA@xD%wZp#e6Hy$-lJpE#E`cv9ENJ*1U!&i4vGQ{K7>u
zjDrYzkSZB20WXk@o<#jBkc=~woOd{p`nT!c+b}gr`RNB$8E@OMX#bm8U3<5LoBtf>
zn0DTX|3ykpDVG(5@gveF&0$=Di=Se68eb8*LNpjDnH?1^eq-;ajDdLUynrmV3GER3
zDkn28_us_#MXjUKbMz$yjc#BqHNV0j4yiPz&*ogTa?+4uc?VR$lTFL04K3{-;<-_&
zv(7s&mWR#H1_F+AJrq|1svNrKnTG*OOq!Io9XrdRr^83Gz%?**$u%S2iY133x3sSR
zb*WsInx5N$iP;GeC?mdhiM$H@7i%T;`ms1^Rf+ig<z-1}>uEtv>N9`rZJcC-h8@%O
zYH@{rk)(Ba>PtjI;mx7}mK`v!a9b&KSZj44heeKP8blm0K*`7RW0WbKND4r`3KBBT
z{MmasB>X^wX-CENk9@_43FYoUgraMh@9}7oUde8m2RNg4Jr+l!>@wSmVwSL}BiK*T
z8^gm^0izrIvO`d@zzmznkyS1N!a0g$GC3knc?7EbX18F$!6Covlp57zH_+L_D9}*p
zWQRoSAy*i5D>kwsl_=wWkZe+}SHT`C<wPB=tn>LHz3Zt1?d7$SXQ6s^>rIM9tNnCV
z&{oOvLALJocl=fIS*hV-uN+i)6KHKe)SO+g%G52FU|Z5_zf^C$wO-`W0xam*Fb$Rm
zCzsD<=r-F-?dTP|pDLeB3wtfR`Jap(->ep&``oh#->x8@y^YV74z;~dLAQPsjqN1p
z%gQ!buYSy*&b%F4#W%0OGQZWGz$O+RPss;F^in(V?BlEPmnQJG#~oNx6ql-9@z#y3
zkFdOQiT`K!{6_I*ricgXT8HAxvEXns6v6M9bZ+sHnrS8Mfj}G1Ih_M3hT;H#oyKMZ
z+o<YtV(7$oVCg<BnmY3A<g@#Me_eYa%_L>c5rOkcr858)r)~?Bp8x;?wlYwPrlxJU
zyCzHs>^ad$;i3-7U3B+pfNR<J^BvW%wRnO)Z}}fzinAUsk9$!fUo=mxIS*zjpf6Ub
zay+$~sk}}G`?FXe=vHG<g)Rt7dD)Jslut1>%7%GN^aCHXSxYNQCMp@5gkFsnUpGJd
z-;_IafSf)L3Z1yI+#fA<{f+H&XnxwPem3m7IM-D4YnWR6462aSr6+g__(BD3#4(MT
zb4WUD)V5+AKp3F5oG<JEvy+G#F5VA~bq|Am8FoeDG9gBl9JG3lJ3x=4lWf4>4i=vF
zf3Vyl3)<n1cfrC!JGt)A;JgZ3tTB1B+`45}T$~={3C6OzV5Ya!<*xv?AC_u08A=t{
zs)dKN4mv;BbG_0*ob#QlFv{*#IL>3(c<fQ0nuJYICU6lmff-N^9yi}9ROc>QofJ<a
z?N<q2LKghR*1T2b5petc#pQ(vSF`giX|)0IR-^UBq*P6y-u=-msZ#u<Aq9-iN6enK
zY=c-pVctNfVk)!>ZVK_1;w`RUJsEmow&8-ft)%f-W;gP6HU-jT3H_CR&B%To;b&QC
zvm$y`wa(yjyfr^spXE98p1Z0p+nCige0*LaeOO}=zD_Joir%j*IF$1Gtd!G&V^<Q-
zrpe2_TwkeEiuc0h8xzU*XJblpjx-NH4hoPdt$6d2Bx*ChjuMnTPqpZr6w4WQNI@?~
zvVRvNbR|#+9Q2S*q0<6UhfdvXcOqyTlNyk8i)!x&9TcUy;r0(+*R*oX!B?dpR*y9H
z=+!W-S7vzk`QG!ep$20;&8F#q<)6uTy6}-GIr8J>^*AKV6lue_H!MD4Oxq;vqXyEu
zZ2Qumkil<)Wrgh<8J?nOR>HFkGx=ZsJ}xaTGBe?xB)*n<LTW3(s*XnAag<B1TeacP
zv;-{|j)?ylaWUMqRMbva?-l3yGVAke%ivd=jnG(XnK!QJ<!_#u2i)9DqP+E0lkzr4
zzbs>Npp--FzWLi-*TaUP@BZVRo`--#krV$@ZnEBM`O4MVoA)Kl)>ABtV8dqV6jh_x
zhpKKHs%pH5tl9VTDNH;@gP$q!xwy;MjWPC5n^eo#A8prWG;DmP-5QH!s@Kl5Jn{AZ
zYX#rIUe+IR{pY?a*f`wl+c$y5#>kI4pkp5~b%CUQ984&8{uB*8qr!=G<;46{1oT7w
z33U8pYGph$cPYyQDCOOkD_XgM3OTtt<5+<?qJztd*7uN6GL?8cN)D!7=d>zttcJ;i
z{?Hk5hL(oh)uXe(R`X*KUf1dEu~>GyeJv1RFos$zl|1X4nZG@OHZ+PjZ&Z#$vTTbr
zK&T*&=hH#9ai7~vsV_)UI0ia5=I>E)2aXWP@4L>}KmN5Td|cOj`5oO^HHtuWfFSN~
z0m-|Bz6RmVZ}VBxzPWZ-x7?|YR8xuVBTMy}&&Y)4+fmo+(C5~>(5>gWDd81!lP|#u
zjdm&ceuKcidg}9S62?FKY+0*Yb76mM08b~YXWa*O1&I~Yk;}^ki)Qc$X{b95liP^1
zXEv1$hs{UO*;}I|DAu32oYP#B`0}O38{6E>W@K-PLwLPuMC(3OcEG}hx%LW8S*?ik
zp0P0DVF6u3oL3<T1WuW?wD6dwpl<ui3DCAQ8F$U8)U27&YIo%RI*MvHZ#lPA!AVaS
zkldp>yIkdjoknJE^Q4n((ByEw|FDzgAb2l+zH2D^2Y9gZH$v^BBgj~fOD84zZk%UV
zAlK;jPy}gULPw>Tj9{}(_NR;J6)ji!avdI>Rk;C2+%AZLZ)UwXYM!XNJzvA{_xkiF
zj6iipdL?51mj<QRmFhQf@5|TXuD?d}Q?^r`JN;bA9)wH4tH+;DcV}<shAuC12Ch&1
z0e5oQ&pWY+gik(Zg;*HMr+-B$R{j*sR4m{UCjP9vpY?8Uik;9{DP}5P%Pp-S8gSNg
z{c9|eT5Cuj#V<vw*S<Z_ldlS8A&eydh4ApFCRoBKrn^*1#mv%I_mGwohnZC!%YZW>
zj*hXOh&@8O-Ex?TNWdI@LC>hDW|Yo~+uqs>k{rs!Qy)4^f%BBk7C1&dzT$R}EW_P2
z`t5jm4>p*TW3<_}lSy~R+H%;%$R|}`vP>aE$$Hnw;jQ6DuG$P6qtvZc^N4vtcjBN|
zucrl;w@SyS%t^Q>P_z149_N6Y1#K<dz=kGY)r)J=n}BE)NaPd+G;;tn!iq8$f^vhx
z8DAGi4tJG`gdd*IO~XDPus*LvvAf$oMF%|3tPv{tU7e$LJz>$D16pXR&iw3e?pfLe
z{5ArX%JjVWvV;v7vOG7lPW(@*bhjQ5H9OC--lhc{{~pHn?b}R8r242tD*PbwIbQhb
zk|=j@`SWJyi{&7XQ;YeH?03t^3-xZNZoIbW1n|3Doq9C6dX&z}M`l>C3{)@X&TfNF
z<o|qsnb^m;%ZZ1!Q?cIEi=7TNqyGp+x{+86cNAm$G15#O#R!y2(*v_9C~}GDCOG%W
z(hg}T<NzwoIhJC+aCh3cY~k;Sqvst!&4DKAzWu3yWn4bM+(eb$(Uh?N^YYJVLGS15
zSq)9%){8Q+skbWIonK5GkK-~YnrSPWa;W-#FG3uXdR`wYk~^OP0XNA@JcMYC#~T1W
zYpARLWO9#~0WeWdUrd{`!i$x7WcH#n-fhJb?lj6q8uq|QBtf$}qN@=V<FLq(!M#=0
z8258Y&uy10a~*ZW1P1QW$(-rwSTMWA{-yR#$no)v;vzI}Z6~69ATL#2+rJwYVJ>Jw
zapvi<_v?98Q>W8ZC&T7dakkMbv4=DAAL(Gp%7v1%>~g(Tdent0xs!p!iBXgM<vwEm
zq&1yha$_6)hP0c<MtYdW7pwi;CzdxUVXph`Yv{6IquYOT$(tOS;Sxq-P=sSQh#&l&
z?=z7#=<Op9{U}nZ=hP_4s{A6^u9nhh4n<tB>j4*7`iV~J){#!Txg8{w1~@$R(c`>q
zb_hpPW>XiR*Av#2zJeRGzPeBw3wSVmJB`nN-5bGDVg$A&vseV*P8s?QP`zy_@B}P<
z3^+yfzt1LazMd82cGf}eR>dbro=Mp9yHfCRc<nLpF!!G_B}Nz!RX-F#{n?wTY5ECU
ziAb?s_M`Ry%;m&D#|C937x3g^hEVOsijt2bbXu~W#L_SkTt|3QyavV5Tb_{ba%sed
zF%mBohi`At*D+;KS!y@w`(#$$ovqMtjL1_nkWs$>01FdXgQzS{L3_+l4qFXtFN~`_
zuY~;`p6qWO5_t~eSJn^Wm|w_Z{I)n!M@|LjHj1A>4FO9p>PmCh@<GrQv@U0PYWl^;
zrBJYz&E3+zl()>Ykh<w+cwFc-PlDW0F-LTF=>pWwhYM6g6X_=3js^JdlApsb94&Pm
z^PF!kypDRXMC*-gcRvxdF6LxMzn}Cxl>c?>IY1h;>|1_d{yj0y0%q+;Bd0lzR4JR|
zU`Jll&F!unn_D$<3G7Sdx39VZ0dJ4DWg?{_vkhyA{j-uS?9vE*=;<jd-)d%!0!xv5
zzpoWI2Rr%6&g(?oVd7B_F!EAWP%juyyz8Nh7wtB3Qb2xH*?^@fy?+<FeCZRIjRW_@
zw~fd0vbe<D23lLx4f0ltUOyCqc!>?6!V^*da0mOHknrDb@_RkFE%{$?WIv7F1%T!r
zcfUR-H|wI%r`;k;RBpdrp1*BVIkfppP?YhtedF`ZVvYWEWz{W2?8Q(qikyB}zs<B(
zG`9jbVM+waEp_l2fN^>>xd^99i~Q;cT>@qC8!~QNoOxAXBRR#WSH!4Y<2v=)aeKX?
z%e_w|d6KR(Gp|=?o*3|`)#>$d<72CULJa1*320L`+_v51?^2e(EJq!4%Q1hi$*kr)
zA=0S^j-^7MJ_c@nE(bQY7UK7oX|TY<U9GWVoR)rf5;>)NdHe))GStK3=W0%SqkY*o
z`spEL+WMP|<m&1wWJcQQb(vmDcj`ILcSA*FtQEkN*>Bvkr*TnV*et#g1~Q0z3>D$X
zuThMJmp!8i;>n23;I!Z#w|2}}UfT<fBz_N|=y~-@;Nsh^<+oh**mSuQ_CGXiwC{4M
z3CU`neAu;A$Y5ntbCCaIomGET3&XFM-Gp_5-*vOG(zf{m-AfvM{-R8qrL!o`#Sv`9
zk%gF63D|E|=(-D1()&AzSD^re_jyL>l;mT%59L=?S5gR4wDF>7+62GszP-Gh*th!C
z0Xp~`1I~>Tq1y;q6DGo%c;KU@fsThH(Yjo+aUCv;rc<v}ztPf@3ut+nE5CL*ZQoI!
zzStt@cCPVz&2|4SGoDhUcW+|H6s^2Bq9gd~hh{Uoa#o?)!UeX-x)|T$y%|r=dOG3Z
z1}E*B-E^mxwAvE(90&1}>QHDj0TY8X3}R#IyVpWa@S7@+ex)hTQBI^ouDkWv!9GJ_
z3N$Rf`rbMJQo8hCO8cKbE|ztp(J6~V7|DIZy<3A?iGOt8C&RG;ccS`#P#z)H;0ahP
z%k2z&3KNyrL-)Zkc2qBku?j#k-)&dUBI9<C3DJX*+G!_h+Zau=^`Nfy+dc6(ZJnFo
z8`7M^%K*MWXzt53Nortq_*Z~DH!|qMl{kIwZ5!b7$w~K<I$M_PwDcQ<paNGWW(C#v
zo~jn9qs}8oN&uRQ=Zz)d3y<jYjhde9t9JW?h-I<jDWGD9h1BCdL)Sy5ZFO68r;0Xk
zn+g2fd!n1aIqaf{OynLNrOMe9ebpYXBWB;gfmdn3#?8)+iKqB}lI-XF;c%n>-E8qE
z8ZneOgo?9k5RVNvVIz3-5>byZ2{{HcmqtV;&1RdDLnNK+F4d&$2#;f!5C74$!O^_W
zV8&7EWK(*ApzL8`x=5!Qj+j~{sesdRIIbN}?N`C!CDt0E&Wss<%bz47>{b6mC7^H#
ztlz&V8~Q^YXQ5GMP?q0F9}qkh*x4$0tspV-i2KHJ0op0SdXDpbPsT|`)!pw%fWR5=
zA%aQ^KuB5d_X>-QG#%{q$mjw7!Jm!Kt5Y!<I=eT+eBBW4@ESVPJ>~SCuX(w(L=o6A
zTdJ1F<0=J=eGp+hrvgODe9{zb;yIaL9T{=I3X@~;fAs32hW~c-D-1=s_xzAN&@lNc
z!BK6r_jQ=t`NNh+hw<EIx+1X+$`Utpn6JzGYR@p>(ghJ&N3cLN%ibycDhi3T3suwn
zCe0^pZE2BP16-21*NJ1EU<}?}0ogAe6Q``SymV^p5*<m>FADHidY|=4zHk(FX#hzs
z1!m!&+c#?%xMW7UztIMY8_E3Ic8krGJ71`fK5M;tte(6%ICZSq-XUU=WSBI9zHeKi
zV;hD0D`CWsZxRO<v#8;(Ix!r2=^m{sdP_D`51qjJws`xk#uql>=foo#4H29}F?j6N
z$G>t*nn3s@`WUV|Gfp4ae#&mcakKdk9Ly@APk-Jsn%I<$Xvi=Rqzxh@$zbCtiviFW
ztx;o*ujmjFG0=?S54p8iMh=x?%;0z&(*5V)1AI2@Gy}Dv>q}mDMi#(P=dz6Y<vHnX
zY7GUC2ofN*;9rvlb6Km&t_Kwjxi9T*i&TbBr&yDIX(!67@*yZ6NreU?g0i_oVe9?r
z35gbkAMD<IXP$)EJFe=afILc5z}K6&u|pCxg@wx<>@Ls!i$s^`F`~q*T@NKg%`P9G
zasYLrXHQkd*~IniCWwc&y%p=c{VGXKDWC#L1&gzQeq+V*ZMKYoIRU?!^D};9268A)
zAc-`LA%-|BjwuCQZ5+YaPEHeOvSWXcq(xBKtv$Azq_lak+hVEQJ^yS80X7??S}zAl
z3A6V)pu!H!*CVMsDLqebAaC8ogN%1N3`G@grTPQm)xW>0iM*mzrqkyjU$?*>jSDpg
z<u#P<V@70SzC$ZOA4hXHn){*pjw|Yj@C(7a=?~0;gx_Sx1+Ue;rKqw{ZgUx>2`_fv
zsR4YBvuDV{c-h)aE7x(A+F!FbeflbSQ1Mpel&)W|s1|5IM>>ii_(rvh$|$0Z)Vs5>
z{46FCQQg-nl54mIDMW~=ruL9GBI#V~>tcDQLizU;0x;~FQ5+!Ul{T8}p@a^C=?Fv>
z{=;JM`Q<p<uhVaRsA|=}FU#8bQ&8C6%)+(4C3jZqWEr+#myTzmFYO^n$9AJr@CY;P
z;ISa)mfeH9R<wC{(X+|mv4I+&PEm_9rzJt~Vi@ZV&lI;|W9P?vC7VFy1U%gW-l#~n
zxGwTt@+9-_>V!kcX;YVn=@Rk}?*SbZ51{60BHXKV9}(f-V97F3ifdbgZnWFRFd|@I
zje!emC%kWomO%_(1@Z)B5d@xk6Ti99fYEpdKR;U(fB?M^zwKgHTbBORn*PlpqVPc;
z9fe;_l*sMW?kf#tOxO{~fU{O~Bx$-tJ&I~PLWPp*gRE1Jg;KZXj(eVsP|agDi|3ml
z|Jet~EyJYM^NiZFxA`cQ4@{rIkW3pvta<LaESv5SL{VGqiF^x82zU0IbtSz<&HpR+
z!^BjlC4|lr*n#n#8kctb1G`MvuUZV)7<_oJ)a#|G5YNW*HT?N8mA2q{CeL>J<9v_C
zq<rNLEObHdA?LdT6wdXb42^8Sv>i<|`;oi|n(9fX#iG0pWb}4(U9W@fL)j`|V`C%n
zWXV9=&_~t0cz;K>L3OjjR+n_8qDA2+V-nU+k85`Hq6z1vvzc$5-04le!bFvxCqcb#
z6x&*TJt};h=t0nZ>oa(pyKioT3&+J|=aCMa()v6y8{gs_8q-sXbW1w|&h2BhdHxjz
z2WUhWx3;=EJLrwDL(+Y$Uu8rH7F<cPqxSs?f)SKL;pJfORw%1Q949>GBB9OG8gDcm
zim49Fa)C<Lbw$E`ZOJg!k9#MB0~z9Cf3xV*6Hh$<8@cHf9R|Od)a@MbR-cYkF6X1`
z<gC|5?+>aML=z8h4|XuiU=$B8D6-PI*ITdDBGHD;AXOK9o>u<$=cBeX6KW4t=}-@O
zA!W_-)8CS~a{|l$OUq<^7u~G!g}Pgc@|A~lLZS`;U(DC|Jz`Je7)*D`flXejQX>%j
zi_j6P>>1-26SZZ<tvv4d>3O5YaL<Qt>K7LWku$Z6t7=7{F7`7`sneLC4{<EvE^0RL
zyZdG=s3y)7hrX)?pQK-QPQu!XJIc;c5qqqR)PPL}PGxRgd|F7hqRJQgDUp2i<4R=M
zKei76gzpvc6MWK{?}|ddR?p1{Yd|Ba46U-)4*#C4A5|Q`cIU?+<OsbZ6J+r_BBMG}
zQ49S6xBMZwB)6U&>6@U&*AnF(VUcL!nIA~Exi;`j0x*2*`Lj_YjpY=(pC7MjTo8Zi
zUW`hiR@v1X_nS@1TBuqsHnu6w_Uv2JkodSGz}CaU-j2LxIR2D8&_L!%Sj_mYpTSAI
z@z~RJ-f?FUj?O*j+Jl~MCelCq<vX$?^v+(IEN(h4G#hHReA(=yUbL74TmR6UBl^4E
zQ<F?>KTsTl=)ZLaN^0D#ZOwLFC%3C0Mp;r=&c%uz;>f-aZklrAr&Vou;UoFV@M^8}
zx{#j6K*95Yu#v~Ct<TeqX_k9<E5=H=bmpMnX(rvJb#Bs}XL0MQ(0+`hSRdHOAV71G
z!TBNVOTYhtbSGkHi>jFB^C%{XbQkl~81d&dgR`e*vyW57S2$wUq}2gM(1V@>1-?gH
z|DMx8mqGCwj8bY*?cdmlj_F44Q{Q_&(LNumK1YN=6Ze-B3ii*Lf;{~8!QfeZ#OzRG
zMS(!zA{e}!=V+%$N?VjyTDfL_<?Ar<?dn?XD?_GS+xyc$z%dBPaNdeQ)W%}Q0%#|D
zoS|>>cQaRWFA}0l94D3FSCBuY#NKYh?bYISXF$)|Y`faMkWxH)Q$`xWy-XoH(zT4Z
z_89=nR?{Sys0nO(qT)AvS?<p&O|sT|IhV6-qK1{9vP+$`addH=m)xvrz`tb2Pm`&|
zZ=cVB+fdwj5h%y<%!mXF=dRfKPG3ed>$%1*5`4DFBTfi1@TdzjN70&mcjI|M_mL$m
znTsy(=y|g=*W+#J^w#P_03E8SS-iO3+=xMhZJ}RHOk!9t-t_<sBc!3kJ?^dqCwVOv
zQXrzMHPUW$p4IVaSq4S5W#7K0zoPtm76|s5-Al4HZkL-X9aGR)7l|+ENy&?)Y#lCI
zN9dY3bL7C3sh|Lldv>TMSQ{|1mBLkbDI>3%(`hovk6P#i`Fz}cgyC7NE;&gL@)J?@
ze}89dvs`1MIo1|*rsPLAGN|;)$J*>}#zDp57A&x8_;w@9?G>b7NZ{+VBYs|RpwQ&M
zzZK$4VG0{e-~W><+Qvqn&Ok}=Hg3aXQ*l3z12`W|P_y1TcSgOz+sAq^Uz%?L?-qQU
zZ@@*-U)imGP+ShwMdN3~FQbHOxK81E6{iY#4)J)x6Hatb>p$8i4<fQPUD%y^s&qIb
z-rUF|!M*XZD?Z!%QWC!%uV8H~`#mmdLpHd}Ny_uaKq({bUI8u(JFh_eU2pp@bdxIV
zt=e_Che2!1LhFS64bGDT`2C$#nVE^okaqN`sb^L<q_jB&=rMoPhY4(i+9Rg#G~t!M
z^)_QS7_szQRM=96^x8E_0ZkXs$_++{O@3khMGwLRalpHTZs&brG=8AYi6rl^o*(hH
zi_r91r<(=vTO%BO|Gv|G5Got%dLoKDRXCD?)pS)t2V->4V?BiK>0W3b9J$`dt1-dU
z9!zS`SI0*@6lLg9Q6}f<U%2Yk41Vc+yL*Fl?2q<R@S@z28(XS!pni*p=L`dHJXunE
z*a!Y;RatBD##!xO+K>(ON4A&TBVH*c=s$ShS0y!c=R`w1_>gL^on4JT?hSV08s@2}
zzUP>5YddQ{6&6aJw%<hgI)+vU+RgtA@Y!+c>}X);Ah|uL0Gc(lNfcWSgs!E#q(4=T
zyhJMb4Fzmz9$0`?*hTD`jz8YTQLNHtu!eo~?vX;GI#E@%$)`PbdoY}b3@|Mc(m;4^
z2fV`TXj11!K!;4!u2Y&;b8m7Q@aiyX2{Pu&P;lk1`OfO+a>!tD38Hyl4dV#gdXQ-X
z<)Fx9_?rr003i$IBJb{Xy!`u69f}V2$Tn*wOzJD%5v<X=8{|pxQwoO68*m4U_bS$4
zP*BqZAOD88%7it%Nc1(Wv!zA&H$Dqv6(ZMln{DOih$`hGY$AD@O^MlcfOf2rAEUYe
znAClWz;@$rHl9(b^M`{wfuvQLEB7S#I@m>Pb=$r^jXJoHmpgDhmn~#19kRTb-j3Fn
zDmF|^0JmY0R6p<{CqlSPpeFR|lCXbp0%zjL)hMK@=s{V)Ylx=w{c|hPc`FKYzfGe_
z$zyr7-^;`eje)<epL5-8M%^06=4rhkm-XjmP0-qB|4Y?B8-_=xM;g+s=G<SO^Lo!L
zn9Gm%4T^PL+pOELqz;PLj$L&-+{48e6u}GWM;2-ut^q9kG1zLQZNlycmpP_S7)8n(
z>M$BP=Qz`GpZ(rwa$rkfF*PL`*w$kPn`qA@e)N?rsuXc0?F$wF65l7X7044090U27
z1}2iF-x%oYM`%yo`xCdd3X6iw(!XjbX5HI&)*W{~Q2lwEc-rz%Qza^uT-mhu2~aHl
zq4Ta}WdVkW2h`IQf0*5kzz3@)Fc~jvC7??jF7SPrrK)*FybxmGa@4q1C45j1Hf2>|
z=PiXHM=8Z5-w5fUn3l&RCuVrRHao)>u%7~%P1pbAiT_9X6IFGho2CD6_tHaMPp2uH
z#@Uv}g&(*wx5Uo0O-~`)_E(!M{-=<who8_@6u-O0Q*@l%e$V5*tx%nxZ~FG#eeR?$
z4VLL31vHoqlDu9w<yGrR@UFfK`Dhu6G^?<tvN{<CG?^M~Hgm}+{P2m=`&$0XI?JRb
z|AjnHmcsf9XLfk|i=9tYkIGCKEs5s0ncBm$|4@G$EVA9pD_+idHFD0k_faw;DSz>2
z>~<&vS8{m1Q$Gw)@Ac=pihY~<)H*^YFRFsp+s2;$xrZ}lbaI<hFAe{YbzG*RLtWzI
zda0Bhp|HhEQMF#cACcdm6acpor9V_y=(*yMb0q5sk<W4lQ%}IibCP4-x$29*AJ{fw
zRuQH9D$=s;8*dHov!I>-M<F|?^1j;Lrv7ctT;qKlm*kham8=fi)wI=(o6@cHHSB7t
zk3FU6Oj4sXxO}BF^4rn0KLnWAF%NXy`5O<28K{%7mF#!UQmrGKXGV;D|J-$U-l|NM
zy@zvwtfYF|y@VUKofn-5JI@60LSA+auIA%ymh93WR~y`iNI5fA6cm5iZ6nx8Sc8+#
zPFggMCqh|2BoFTOK@B}$q9(FzhMxFG<l_`?E-g+K-8$?|noP>Eu)u#@;D90zsIF@N
z+9_bSUmww?qdLy-txzd9|4cn-t@U??Kd^7h$l<IoH6xW~LjGifUs9lgBdnaFoYtT0
z#F#*x6NK`ycT`nghFGlt#Wa2X2|c1OSOyOUQ#ueF5gcEn1qcEQe1ckXcGsF5KG(Nh
zyyBznjEdTtEtjcZ3?<dmNSJ3%_k0eMk)IAj8N&`@9am7l2|2p$hiMSkGU<GYB3Vh|
z0Fru;^IV-0H*z3|q1#t2v_R4rdJ8(dD!6g?uqfQR$j!Oy@(yn=-FX}u*y}!19wh+L
z*?Js-Jj^<!I5V%D-6b>%%3cnsbE62Eo;Kde!v2@v1(t;c;Q`*Fto8nVgW#;Xqf?iT
z#PrT*$Xch*+Ns`Z_YUoEn;1=2t!d3VNx`L9y*0`>M${3J;nu%;8M~MpOR~4)MLw$!
zn?UXrx}s8_Sq0tZG}EyAub`u2jq-p$&sUMSt!+X&HvfMYz`r188^RCg3zvnfS@D-$
z9`BWPUn(2DX}ra|9o^Bvn*=Vu=Zz3Ug~jBhur~x*e+4P)#Lbpq>v055{n~uLv=<B$
zSMp_=`W!`l#x09u&(*~6607a2HaKyCGqt^VHiI-Qd;xCq{vA^8^+iD_4g3`4RCf_P
zzwzDt20TIS+%{U^0y+L@BOegAg&BaRo|Hc+`8!zRW|ZKr-q1@@5{VaIRS!JtUY1Vn
zpFd;g?$Gvf@B+QZkcYCv^J%&4m1p66vn@VS4tp~XeBDDh%GPm(<UzENR&pp)QMG^}
z=8Sij?K)1+HV0FR_HFy4wLRYEjz5rX;0%Bat#Dp{%Fcc7c0WJe-}<S^AScU8G0iA~
zVtb=Y=nf^x;@S^qlsQ97&c7=QV3~l5;f3aosun04t2M`6AuWnROJn?*2GG}Gpc|N+
zkrEO<*abH3Uj)dvj&=fnTZyHo^*laK$r&2p(Bce(lvZ2hTs$gdd3m;Z!u%)?-uuGT
zZXfkONi(tc*)1=WOvS2HM3A?tcEHYIAeze))l0Z-u3t<<i0T+^k(UK9>iP9HF?W_V
z?q2RPu<fz){jR{TE7K6jOwwp7$q5qHVDy=Xhas|d6|rT~F;<ag%JmRc5!Zqg<ic#s
zx8UE$D7V@yGv96or?RsA7OL<rIz){1NT_qmloEubHtBmjXslIja2{6X#j9iBAbF+L
z?~~JY=k+6S$@?}9`yJo$+5f(u=ibgRjW0~|meDf9e<EKh3j!v>b~Tup`}_DWv{eey
zprKaRgjXya`R)+;u(a)D%~y#S*M}ub3&$bIKVZ}<$>ySuyBX|V-_BWPJ=nr;5W^;y
z9?>ID9pIzuVnEaihyI7Xw`__lYT8C|4-lL{a0wRN9fG^NySqym+}+*X-QC?GI0Sch
zd57Hh^FCGQ51gt~=hM_o)$HAS?e1RPeO=wl6s4#m7!5Jp0;G1CMPUTCq+Gj2{zDm<
z^8-^U)48tCPmp9N&a(=11^)4zE7F)J%SX|Im7m>Y(lX=&dWSF={HCxT(7LGgDAT=i
zVrXet0j5VJ4Fbc6PRh{Wf8U2wkB_AmY7#cO`S4g8wLC8jj(b}3mv9`u`AO%+Jfjcc
zjh8q>IbKQGcKH}6vte}>Pw=x+hbCOX^e$JkJ;kq}mx5JXHa@%3^ckLKR?KCnHK~hT
zvI$7eI*ht1a!=u5FTWO(d)ll@Wp!0~ZCc(o^SjKu1R39yCPg92f%e0eL1M5bN?{{D
zqZ>N%?A7c_yRrweX_w27P_}E6B9%JlS<BH^Ts9TVyq|VoE|wg3d0A~PJUrRS`E|mq
zFiu0A>YK+U^U>E_G3*Qpk)B3-TXM=4-%^vhurzpOtG0T@MC$tWi0Qku$*rLh7w$S?
z`52=pVxAQJgAX1);e)p<AGmBd-ER9bt5&Dk9=No$11N7{1ZC+KE%#_JerZ5hJTjv%
z^EIw8_K2U7np63l*_7l)(oo$O&iiuLY7BS&0X%ILHILEZnlvgw!R)L@jVs4kOx^ZC
z8TaeF#@~m;8iT8OIMh|r$r^eyx!LA>z*>xjobK2$T#eWdO?kF@r~s@Z9$I7wAvrsh
z+(prGe?P9?QTL-?-yRB0-bUdlM2J|}a7$w`^p?0ddR+=1c#d|J92nzNPOZIuvv4mu
z;By{l(D_g?;oRBw?cWyLm-f6nw_9+8S+vY$b9@i*KkI(rQ{oWq(IuhxS0XPLtpul(
zVtJ$0T4_Bj1$P*ri-wazc@<tP<I-5mmBkoju?w%&9*?UfRz^l38^)|79wUM5!I&fI
zD8ur@Ok7*$>K%}rCm1)8bQ=HBD23hTeFyi(`5Bff@#RQ;Kmk9yYrmn^o#iGKHjwyI
z>Tkjysht}wXAB?p<NewWuUruANH`zHusQXwoNL|<9qWAD3%g%;czf3WAXZ)!5$>yr
z$*D=ODE-@Ueh+@vX2bb+y9m+B-5>uM<;mvs7gpZj5}t>IlakRM%chyU0{GTfw7e?R
zK(d{#*|nS#rJ%u!^rST4&_HK0bC=*J1kTiId_|HQ>{9UjLEqv!mzU*Zsb(4Aa02ms
zZQ6;&Hy=YkEtm8|sZ6KT^)+1Yhx^-euaVvGj-0eCE0xJ_x5A}n`+F1An}QO7)0DnM
z^$uCWm(G-`LQ_-UCiWbrWNO;@^)s~ZJenZ!-_%b!or!-226T;QMg6Lp&{%w=j&ZG|
zj!|eQOcZgG5i84v_q$jSph76G-e2mob#4^uK$)8YP`ZXF7-G?YGM9(;dg|g72!>jo
z9WU&&w|?$MoyvSU6;)l{UT#X+irwF}7|#&qR7zLJO258=kX-pt>igG-HALD@e^a%J
zz`a2Hj){JU(`5a!Y{F}Iu#glf#QEFH@6Hz$Cv9<@A^-AT_|N)F;k(NNNn-wJ$LbU=
z*9+;;`>aEL2uCBMW+A)vvYyQzteCeG9f8qOJ_?TYBD;FDcqJG(AHAg-l#3)K1O^q{
znSkZEFFHKR&QISi$s!r5Jlvm!H7z9-O<ywIS?c=b?W8%@;=0YACU-Z^Ms6!dLz`m_
z!TG&6QhMImZE8_B++<#E9tKuhpXPA>_{X`Fw0%`)61^-_?(RYplLVR73|lPJgFI2)
z=D=WPHO>QsRXTp$)NX8?%Nhsx=hZ~I5eyWP!5cD;`O^%%4%R-2T*m1&r+J~!ctSh+
zjTf`dnj#FwFxB`j9L|MyVaKI4tJy_fr}ldO8X$GvPp>u#8~;y1y6H1C1!8ZjWnjX9
z83P$nm5k^@vDuX42C}v@XVPG=XYc2DSsX;16Tjn<k}mg34bP`8-n*=<k7n++6AG$0
zUM`odZG-jhG$>s-xWUC@Hw|3YZELnkirn+e5gVNkosNbgo*XQ^l4u^j3N^}NxARm~
zyqS)xy1T#wdxjop@hC^!ycV6j+$sWO*nB1=W`8neW`i9D5aI#{`ffEAI}@yZKGx`A
zX_3<H`!@x&`3S}%J;)vU%2l&C_djb*L510VIgE-@7CCAAGpXud5e&QRg$)X=SV1Uw
zLqZ$zA)I>Z*NT#g4T+|ox^ty9Cy1xwRqKgrM4YD<Ha`N6#+r<*Ou#DhQ4_I1+$iYF
zQog7&E;93sgQr)gQp;P~>a)imyU3sVwcT(X-x(Jcn%)bQpk@wB7_8={!xASeZcRP<
z)ikjS@v!mzEc@qCFFrl$i;hoc7o`uFV4gujNP`$IdqVYkibX>qWxUvp#og6i1Uh+B
z8C9x~f$>G=gZ5=)nsuA?j|^^;AMSrqMIyD>PoC9IG4TS4N|YpK)IEb$lNltn4KkT)
zA0jWj&NuO%UVcMFgv<m#V=HUp<DKEz5|dxG2!Vu&x9SI=_{Gx-Q-Jfk!VY{DUjj35
zL^%b_8X^SDv5{YrA^y^z41`M8a@pt%QPV$;>Svk;TfrTj1o)v%1S?#l3zs=#8RHGs
zO*^bHU8X{e0eb|buej(#z|G+dWKd-aPXh8sW0gjkyAGHe&&srKGwusmr7t8!<S9@j
zzo3A<ajAw1SM=8aR9=bGY&Ax#_hBIRLfctE$m%JCmh2NLXzJRD3aoK@Y?J?}lF&hy
zg`iObS_yx()2AE?6P0_tCdQ3}I~D<pQC^>{0iEA(&(}cK07zkBw!DNWT!nIxeA%4z
zt97T|jakH9RB<^EDeN)+(=e~sUG9{jm_xm&j$`>lTU6<HRyxv2$>Xf;F>u?<3i&!P
z7xJ&F1Q8^{E5sc~t3RI)4Kg3v4Q;>h`LBoYcOGE+n>A!`kp!Sz6rsIj*Zvd(1+yAt
zgWL)MM5IKFz?P-n+V?6^Ireig%=(928G79L*BvCLnG}&}Rh^SYn?(7xK#aziw7QM$
zU$B~|Y~oq(qR+x4%P`O%HOfXafMT}P{F?Y`MP|g2O}BI|^s7#de}XLNzO({7tBb3}
z?&Vf;_VCGXCk!1YnYx?wI-)@I_KzNmsZ^>jXl|{c8dH@K$DdX1%`*;VOeVjPYFhFA
zfQ+4}gcU1$jja{8trP)A{})(T8`UmvUE52#s2PP%Vt~n~9{$0stSW<Bivsf#^kbYD
zX_59gP-Hxt?JHU4YHwv=`HC39bkNGWX%D{9-Yp%4U#oprACn;17INS_kuM157W2v?
z3l-W;ZY`t=#e#!>Xmx(N=JMt;i1z_ji(FlzHxin+=z|G)%S8~JWvLYIFmJ|KZ({$G
z^aZ5a*WO=kScwidr~wWS?KOscn5>ZsmUs-RS3B?U*F?!6NOoe3mN>ZlBz#&#)i>_<
zublT@5nOWs^VmN<<KcBSE+%7vx{kS=Ool3Nl*}F(c+9+)WwX=ke^}!lINS`T&y<FE
z-WEnKWDp<LKoe<xk!~C3`|gN9Hb~}YV*Nqvv#J$V%djLv2mA_ykiZk-K8#<e-7OgK
zKg2)}QO`THmcCIO9ptyiTD_dz5fRqq&F5C}o*f}isw(&Rgg+cUG0|5fJ{=wOWR+}s
z7S|;gXUmQg#I<a+UV^%tXPhc4mka}Z9y}3elS<f>05$h>p#O0I8ADDJJc5Hx!w9Ok
zhpzttpqeNpL5`p_$#b@v|CX8A`ZqKT|Eaj>Ks({kb6hMk3reZ<sL**!6<yNi5sP$+
zk8&N(M(@hkbezN|hcD)eI<^30Y1tOB9*X_yP*Grtt4Vz<3ZAU3tqDmH>PLy()wT$&
zBL&L=lF{Uc+eDW3EA9G;v9(#fJLab8daD&ns`$t8)5bpYV)jL|nq|X!aguyoAN-j#
z+CraiYm0%2vQ1aR@<zG74JsdTobQ2{Hh_R+Y%2qDNwtK{vPJhkeP84f(WFule;Y&r
zZ?QvNHl+B(0#m99#kDd`eO@0Yx>B7<Q<Nz8C7%gLzd0vPuo^eEm|q!UCEfFyf~e{L
z8De5VQZ5{`c6takE!>|Xe30sy_hp#+?M*qw0<N4+BLCESTv++c>Z(Ez>yr_^;}tUC
z@s$ynX5A~WeZQjX#Zk?t3sZ`<?Z?J1(fs}Q?$0Se-;sHdb1g^PpnWe2(c>i@<doQ%
zI>E=Ao&ozgF0_*lKI2zGd-?LxBeW$$!YUTwR~xccDL%31pFW~)3*y$D_o={5uS}Gk
zschfB9w0L-?eTHT?Xp3CQsuTJ#A>KUO2gqc#%|Ehsn@*Ih#GFkw3~aEuykn`?mXAr
z%7TSO*{(-_zwTPKkZ-^>h3S`7K2dm@u1039-9!0Ae?kxTEgH4gP)q(NVi1*C`5;<Q
zN(D3LK`bo)9vWw6gFS<O2?mki(LKSL`Zh0a;f_PWT5t}xU6y=x^A2=T)|2TC#Ci!>
zDPI>=_VnV#Z_wv=pfl{Y!(lzoG#8-i)pGmBHrZ(Wz%-VbW~R2#yp+cYpj$!Sr-!qe
z-=b-zZZM1BlR}n`_2RqIVhdmPrZD3l?l7vlEdPEq?xbPjd|rl7QU3SEV1Byw!bU2R
z-Ju#L)r}7uVLAYdjcD2b{*nyt&_^&oSpMCw4^1>L5IbXokhCOISciszqvj833hI#A
zY#mFuGVj$y70*38t?fGK(!Go2=3Uq3<GvNEPM6Ej`G}WCfmtcD=vZLx0^V4d4*R5r
z&QbH%#_E0?GGxRmqePX{mF9zafZ*`x$@yKEgTZ0}JNigE${E=YxL>ewH9Y&k^U7VC
zrH;LVe`A99ZA1%bW+xLBAcROEEwGEBk#Z~98)Ji!=8@J|jAIH|jnja|`suv@=8B<k
zB6+uMqh=gFeWA;zFI-otq%DWTRR#?e=h}%^=(_2k;wJ$Rud+{{*SpJESvRs|a=p%r
ztU2}#B;s70+-Vl68~Xe7SY@8fFo5P^5fH0ET2B~9wJB((-_F<1=6q3lSe-bjYTlJA
zN*9nr<O)xSnR!c~iSsZ~QMRL)<%#FXc@*L<gU?`(WfZ$7Kg5dJ=kxEZF`vPWzZL(c
zA?M7R=nP$7Q4~l1R$py2pw{TXVtvjVJubBYJcX}_=ju<IO~(Qfj+XwMsvjzu-IP(o
zAH|qPWtF;3&(oC<W)G{>2xWybY0k><O08chGdJ;(#Y{Oe_a;s2z?@=Gc}FqW2(>LK
z7%VUZQmQ>K%tuNRu%DNX>4#ed5jguQp)F|XZ@;k&eMBzKsMI{qCOJ~O$HYx2z~S2B
zNZMc?Z%dpTakZ5y=*3o~e%F+4=iE?v$AkF7T1Kt}=u`j(<QJXxUV2Jf?`UjpV^^E6
z_j@~=;4<a<4;$PbMQIJ@T;?t0>DR&HPSvaCUYDWwc2t2`_R3hUuwM$dsN4OeWpyp<
z`h0ir=UM$8`-uY57^S|I)edo&dXF`poZdSMGc#qA$>2TYCjEYn=z3c7tY$dA$Y^Mq
zWV=5dH($aoq=ddQxD^7iH|3-4ID+kGeU}X(jZ+(V3{?8rgR9IJwLIe9Grd=FxnScx
zbl>Le`DlP&xXmFYGG|>hEXmKLeCRHZLle>*#MYjQ%1Kg*c%baZ0!j7+sBP~c8iDKD
z7RPyNf3HgF=iE^zDiG~&H-0wXUQamw&X)>Xi+b^ccFJ58?chs`7?f{1Q(6yeq~VM`
zEovMg{{!^Uu@K_P-!DHrc2IvGu+>Lby(lll&9=#>_U9o~sgywvW!Ub#IzCH$Vno_N
zjHvSiRTfkc;0MQbvqs+a(3b_mA&KBM6B6g;P!SghWh&$}9*8Q<bv2G-V`?qoaq%`d
z4@>p>w{bc<4um?npQ2q+-B-ZUf5LzYY*~~#JC8yIXCy>pZNKrPRikPw%8O(PYo~(S
z>^Q%u>!q|zU5sg=1`7V5Mi4yjeU0R;2!v!c*ZkXU;6j8vfh5Yb?r2T#G@`(2nd+<R
zEk-fgyXbjD`SUTWr^(HqrS*=RURv+YxM^(=g>*wvS(-_Lc-n3fNH_YFy}FPNuN4h;
z3=Vz~1_T%`R2^y|p|x@R^pu)d>(oMvpRHy(r;G3$)2Jlm%fp=XvIxec39u=!6?TpF
z6|f3$nIph*rP}_seQrM+eXHJOoGYtYvuwYkW58tdu)b77T(`5i>XIjrL+z%m`lWZ8
z^L(5<mHl6^SPBw@-U@V-K0vC1>+2trF9-;%CTT`?UuxN_I-d#+$XHsX>FVvz7&EWR
znl|s>enb#WWnkf4zfw?}FZbwD9SK8v<2s_jL1H88K_L%5aQyw#dE{Y@r{Q6&j`px&
z_oDJ~l3P~Q-X@CE!nmtp&1hk>+V(fz4lW<PLC(c+t&$l8KY048q%iQQ;(QsMfsS5+
z)LHaH+B`rvTs-U<cz}c3=8<*hLFfJY<_pPF2?}#k99$@Dw36;-uR3&jj4@xhYIM=M
zSIR@k1+MCWin36mgi&)U7Np(P`3d6tTM{ScW(IR0w1A7V4U-Rf+_P0ke#tdUJ6_r@
zJWLw)&jcn|hsEq~oHuEVk`!DpjJ>A%k$syKp}|wCqXE&jlxA?(V#rC#dV5F-JOY~)
zkJfqmke&F-ucKRAk5?wiL5I>nRa68GV0pv&#MFe~xc-{Sye&<6tA)!)i)3yznH)57
zYYYjC1gcaVi-!Twj?KyLzqEylAk9-PNNe}NQ|=R6YE<_3j%c#q@${1o0MBf-m9V`4
zZDTfD_jvn`@BP8M=`po_r_Mbg>Y9z+!L4Xh-!=l6<~S=6+%9cYaKPn7VL}<NEj}gF
zstAU>A;`}3K}7J!XNeL+?XWQ3RZuB!Jv~=Go~B%2{4U8)holci7C<(D6&UelE-8r}
z?VFj1(DQ)D^&N4;0j`cl4H1lm(3%u^T@R}c)7@Q0q!tcr-i&dP#G~ejE?!GXtSaco
z2sXulhWawZW^!UY#KvYjwFGJvLpoXipsFGJa18?lE7cMopIAGAgP{D^M@eFc4Yc}(
z?uOKpc~i3hE5`is^p5NLp^>%!Q9D_Qw0A-vcHWJI_Ly<N`(p5Mg-(bh3N{vP@%y7S
zjir)ZZ?{`hT-Do(I>h)Q)k*vPs^lO`&TUTtnq1iUOjsE~Gy^gBeIQH><;O@SR-Dh*
zkoG2y$?lDwiH)s5m-aKOj^c<YhseOJ*?JIsa}LcfZ=;WUtedTKI6QjQumyVEaq5lD
zhydQ+lOMDKU%&A4b<-q?W0UY3HfX&JZv58s+?G1aTqkhrx#n6S!#Y8?Gi~<~b53~V
za>MbAowpi8;RrE?#{KAE9e*E+c(NmY8r&whIq|T1S*@7y9Qg6Nkb9Fr5<Y1`bV)JD
z25#6JZvP10u}g$MHq-vzll8=SQ#VXYUzZ?(5{m{<OS4kpN-|}U^fx5D^wYsIz_Gah
zUY@jgtT3teO3nRAisMoFFN#B&y|^crp+l|${4q!tu$=>d=eg492%eV$d{u>Z)u3;T
zRU8sYe?JUKII(WoRu_MsQhz`5D1n%D8z0H!1bSVjA&8(EScaHWX^IfSyZ5$Vn^9gC
zC!?Hxbsu~1n5-HeB~cRXUCq?MlB6SC@YDMUd4~OZh0Dd}4A;T#Rp~;nG--Sv;sNEJ
z&?QM>V?uNW$WS!3`JM4lr`^C7^!w1qaR%xfix@K05di@*(m3kLH({2NhCxnQDk~mB
z(4rEEAv?me-KY2QKiW*zE`ycU&rOXMb;_htvurWp0Svzvi_H<N1<aHCn-wy<ep$I;
z{h$bB{fUDWrwwbbyTR{0l4_X8-!UH(*DrgGfLpe&-p5amvXZCd@}qy;SjE#Uhya~e
zwC=l>+sf1L&Rx4_xlg<+6MgH0hO2b!{{l1&3fU-79%MzGE)x^_+`inW=^XDFEq}gP
zEV89|jE<NfvIN?+-nA0t;R@3ovKLj{2@mz)9yt<dRrqj^i=o~7<Z}qkYF!Q31n9IM
zEZb~!n%KMZrew$WfOvOP9FK^zr3+1a-KiaL?WLw!w>li$PJX`%jM<KPHr)s?S@V5|
zi?MRjq$=bXp3dyhp4al|v%35Jw6^9{7xn(UexH9Ps47a$XDI21#)=x8+Zp6altY`^
z^LG|)h(;08sl|HT&X23ut)VBIo-J-!EA1X4`A)Sy9QD<AJb7k(oExgYI#di6C6m;9
zRw&Jr5_V$w4?=6gE!j`wKgr@gv2-jx6A9vYvN%o(nqiSJe5<C15lU~ZA}LY5^_Bx}
zlwSDC+^^}(MOk%+a_+^z@&fM#9IlmVokz!p+yVhYUmi!7bS3a-qzbSk?}t>K_d8w`
zfgU_%5<ZdjFPZNWG8}e)DJs`hYmEC?yWa41-Y$>~)ohq1rdBmy->8Bt`V<_22QCbS
z_+&u{h+Q97a{KADx*g)Zl*?$jXDGQasH^_LQ=*0G2(r(&4Vo`Ux7euSzM}90-w5J;
zlWSu2uq<H3oh>H7!L^lE*Xe;1I`GwKY=~NAx>~nLd*L+ONG`7Y({90Hff0hUh4w{?
zQ<g8t*X}gGfSfIun^x+EDVIioHp+mah73`G+9!MmO9Nx(LqEa*y_RU)2;|$9D<rcm
zdo-%ClWYoGC?UrX905y7ut)T&VLC!$Q*;NeZ{_KDoj=K5d`-PxAPMRsX&aa$v5;f`
zm~!Cab6`X3aYPV{8b*#t4U)jKX?u5SdQr#QW>C~jZEG&D=GAR4M-ZBu*Q(f1|6R$=
z$zDnKiK5!>&Aj<+<K;fMBy?WP>_@_P(@6-uEsyu%<xr_1ye^NaPH+Xz6>0ZPN%e8n
zvfgZZ&8FAhBQ~)j?~BPnmC9RQ$B-;b@5!M~=a%owkAjQ{>R6rO*a&4w+f=xKpXv4w
zjTJ>1uCu8j39uAUcQr5W?^+d>tLaV?ULy?;f0Asdc4`!$7kRDwj=H$qcT&Wx2JSRm
zTukZsR6r3-c=$+hgR$XRP;k(rK-}~FX)5I?x+LJC0aUJ1x?z~H#&Y^6al+8q-^#Yz
zcT=Bh1#A<Z{O6Wm3Cfi%?ED9i-u1!$><WY!z<0IyNmbgGt^E{{k4i!!D-iIm)3%Ec
zFly$97PKheiF6&1-C7(GAc&PI)D`I!nNf9lJ(~I*kUss%4@!&z6Iq=t1T`5uu;EuJ
zg?p_>bDeBC(6oPQ@KxTCBRTC_UQKU*^w{Lkdo$dgS1I3kZ6<#k)N<L3ZE%)CAK28v
z_IidoDE~{9wpg{^WMV$#=y-BotfBL^cBAt?K>ItSF<-01oZksK7LA~^mZt(19JMGX
z2vC_ci2v4mup}vo5LM3UeX~F9u%8;|P|ttXxKysXe)`MBdi|z@6Y<xiqQf&^(27~C
zllTcat!;rKE~wE~^rIMn#11$=Op@pTI79|HVUuJqB14FbvQf~|n5p$);B-&~!Mr=+
zQN~Sy=TUyS;x<%WD3-)d;Jrjt#%F_Hmr<7G!^uZ&zm_lQkhF*$FcBsA#585=e+WA?
zBLXH<ECT1Nb$6ydoavnBlS>^3dx#rVanWDYW$W$!R`5wv>*j}?=XRHceX9U|gGNtI
zvHI?^=wM=OCIoky?CK4UpOAfj2n5RA9q0a-aP8l({`~00<Xuj0VU<_`{N;VsLrPm~
zszP-lSH^#-o}1L}cwhegwi}f5vz6tKH>9IJ<D;)zm^r@wv#*XT!G>^&9~t4hPn^P)
zg@sBbyYm|qT=_)9>Z;3Gv&{!jnkQM%FykOubpD!z9#WR4EItUzy<aav>$V$-W#p;S
zN{Fys`c+tEiJfHfx4+>?b0CTBW+N){c)tp%iDwOC8Me_P4Y&&zzqxFk$IG(n(QErV
zB{SP%5*&-?XRh@Rx~1?}%Ox+3Q<<m|Rwqi3Hj4Ajm4kMv>NG5>l%q3yaM_CZ5@j>d
zSE_IX><Q5|-Vflvwx-Cs07K#GbTrwAL;L4O$BNQ!+CZ>;;%L6-im|Fd9s<~9LF8YO
zQbM#e$`zVR7DXqEHr}HxQ|x>5b;oxxl^IA;HlAy7nIEs4uYC&AoG+1W=kL9k?{#VS
z`XkKUD1#M+PiW~RBoH6~84%<})<3(1gA}kY{c7~goE}4sRxYRQHV@+f<Jr7E&|OjW
zqVU}76aeGB&$q9-C=g_X2F7rJg4nofm6@{n-4eKdJ9JwPwqZ}P@HqUMoQb&vNz2?R
zHd6RRs||aydyYDF;bGqc)|9wk)3Mv(Zj+kHI{m$LiK8d*rYIGIzGiYt4;h42Sg`2;
zAA_bHb$|)#)u6c865AejSI4<t6vrdlKRp=}26c-1nN}r^2{be!ip$ib%#TbYFLUEU
z3dsPIxonh;KJK<AZHpHf*YUU_ld?v}H7wOO_p=ZcEr$W%42=cA%JOfW$Aq$~uG&8v
zSs2_5%=A%mDawb#y7;JKf0(yq=wxBw2eJtX+5D6YQFkkeg9mPKS$ko~SZL}%0%uz1
zvgf&)Mml1D6C6UI%dIbwicS#vM2L5#gSCTDjJP2Wk+|hw4_|ZYL)Bf8c*930WU<o`
z?}oRK$=NWdCXQ-|Mgn{?0c?nJ!oBM-`Ei)h?1t^9hQi)g3IYXaGN8(1Zu?I%KPuE=
zOVNi$+=)Wy_m~HlGG2ENMl}Buqh9vGnM$rAo#bSF!jnJfxRzZfBqo24ac<B?6J;<#
zW`|QyuC$yqo><>5R;n+ho3WVOU#z&Xrlfw{c0M?2IB+8vu#rP*@Zr$cfhuOhq-7_t
zPZ6p>20)nY1|j(x_o||_&<-+y5~Kbl)n!8BG%^OM!}4W95JL226Uku~Ljj5EA0FsH
z@h}#c@9!RB$gk>njY|3RacO)xnI6AKqnRX>4CwVDAUPqO>S+(9w$%gw)+6S|dcy$b
zNWE-XizXe1!2dv_JOIKmW#EO@mRHje6GM=uQcoNmuR%Deka?TlgKmMjzXbk|Y>k07
zo!kgXar;TQ_7(-C?628Hd14rnT^Z}!GMJK*+LVX`WaxSr&9Fppi%}HGei`I`d^z`_
zwx7K6A<IdMo!wP&>o=lyal{uDD@6+jUrHV*SdFXytxq(Vnt9>LaNioc+h0Fe0LDwa
z&fZ4{!^Kenj|+Pr0vtuD;C(q+NFnld#!8D*jD%0B)q)1V;ui=O4MkP(O`|1&-pVJQ
zfH(wcPc0Ce<u7KBZM(perb7ZJ<fZ@ezDXQwJmK~A>Gz#WTwa(`rK}Z89OyMCB@eB2
zoB}s5yeBkZb>g?>gxl}8m>%?#eU+Rp;QQ27qp+<vSP8GwQ=`ZY10vCYtVl3N5#SsC
zJ;nw9gI<*Ek!W5)I2qPfPFc_=w3xA61FPXsfE0oZiqV=L4YDr2xIY3UT^GriezoA8
zW{=GuT55`7MSc5ymjo4E^~Ar*RdW*cpa%N7$DUl7Qji}xQ&1GU1sZE*7g=<-Wx2u7
zcXo}Gj-rvRPfGumGHGC=I_cMv9t<im(U?AC8>AcL42IPW{vHXu-(Od3hrhkv-qr2-
zAUHTl{r-V2ig0jYq!GmTEG4A`CEp9w$V2nmw+Kc<{|<~7_BV<;ax4DJN`KVTpa>!X
znIBt0=pZXBxOK+c>8~%nihbE8Kl=6c2f~FyF%$&U2-L{x$+V@XrB1a4JbDdrb-(-#
zhp3O?q&yQFqhkbRCaaT@fDAg%85E(+C$A>Q{|>h!ABS1mheHVqqu=1$??1oGnr1en
zotsQ8(TWtGMglr4JDF;Q*Dk3J619i>Xp}isUOPhKxu4&?^D4tWs~N5JB!`=6A62t4
z@i(J~nbB{2!s$l0&sO!vfTC%0h2$^vAsU<Sd&-||;Rg|A?&qfW>G3Mge`<=D=kqF|
z`q^<I3yD|;GT7+Sady{VOS3~4qC`BxhYJv3dF{r_58e?#b0!j!U(2|JrBldcHK;a)
zZM7S;jiGPuVP>O-6}}-E=%zzf2u>Ki?MI>R_YUlv&)E$UvHPMRu@t{s;0wjf#75yy
z(&JqJEm~7Pv6m=cvJzd@F#tsn=Oejc1i+4w+PiWfYP7-7lCUS51z~5UKLL(&z*>_8
zYFleeU!G9^gJAG$Rb0(qK<%`>fqF`iQZjjBBllWcG^Gk(vs)DvG($ywBms?b?^^P~
zDdyWukK1h%kepu(79^*;y(tycQdsoKk3e@lXUx3qAL6N<&mqAi#HcB{B2L4NzZ}GC
zL)Xd;o*cbtI9U{w2MMw4<<^hg5eYXpo)Ue^!Ed)s@IfZ&-$01w=G7-=EM%fD4dIt6
zx7a~Sn6ek+;K42;M_`JQE{C$#&%c}pldh4!fob_tiTaXSF411MvzVdtJ<G6WP;;2}
z##f&%e#R5|Cfg0OhP9SQJ6p3F+trqQ{0P$VGA>Zfln5my;1W2~oQDpU-=p{!g;wap
zpjqS9Ojo&B9yI#=CUA4Lbp_%>h*e>kpQZ*0$#XqrGqCG?nOB`kND0f*H|_s5lDm-P
z31HD|>3Y<Sc7_tpEG-LZ3s~*OXB*PR=C>7~^VJ1Y(GO&xCKUx=(nUdyC6?l2fb^e&
zSTdw-bBkoGl&R56`7?IO0H9MQ%r^pwI$9o2r*1GTMnQS{u|*N4v5Yv$j08kAs70l5
z+BNLqZRBgSd*~U%B+2PSsUTAzr08}4Y2j$L2`p;3zTUYB0FliG&n53!iTAa&|0>_P
z3b6Y4k|0bAjH-aZ!l1!o`;&~0x9k^wnj7$uU{qNG$>E`NrgqX!zE$fxci4%)Emn9d
z{ZpneqLbLTD4sorM&+vM$X&VPByk}p$bJcg%-GuYi6d-u$}DvT0`v(fN1@?~x3~GZ
zQ`}RS9*KMfZUkZR%-tU8EPY6oA<);deZjS?nM#>J>Xd=Lv2FsG<rbN>COL8!<yn=#
zLW}(Q1fQRCILirP3xBFucRKW@aw138r7RrSiqULLn6YM*$2R^KvlOJS(w`Q@77JuE
zh{%gnePSjh-DNuWy$;@H8)B4L`dGo-o`SL~L<taa;$>-iO#E2wMPNUTi3Q^sn%S`7
z1zN-n;@D*AxndY8BSjo$x%hFj^_Al`^&J^g@@ARETPtt+AZs?T!INM06XP%G#2`ui
z;x+mOj4xptQ4kr0ISlOMhFR#ZVex8vGJGxeeFAfO&2CPOyu%=)TwBy9@bQ~Of^M<}
z&Z6zz2_^hecwGfsl2phf6qSj>0A~my*QSEW)#<W18iq`j4_YSrXY^6r9|`+BpXd)z
z*+_uO7MUNZ{mF%agba_Xuer1v;Wta#$yY5zB#KfkMra;Z;%_2~^Ukgj;~5|kelC8E
z?-Vr1M6Jufs_qYjEYg!PARgeWMYtp!eKr2s!+t}@V`LU0vPMK6;T2}K8?xiGi+~eP
zrjTY&;z;v_vd}%G#xH?*VAo`LvO9AP7~c*UmBDyrog+~V4zZTI1O**-=t}wyvJEj#
zOzB(4mF@HF)1CgfAgWetwOse@REn6!hRf*L?%8x*4I1zJPm#7eN|rC@OavxB3FyMJ
z6}PhE&;s>Pol&S6aGHs;MsM^*QRkG|MQf4!Bcak$k{SK%^kL&<y#b6NVW^cT^<Y*A
zIyF=>3FPA8u?n(C_^vCSh@f?#I{Rov2O?t?1%mO!4%ETWKgBR8e@-@>uvl`uL!b~q
zRE#sG$ogLNPm(*$OMXRG>sp)o){^0zqsPX>!9mX>9p$c8xx7L*gDsIpt+LP1l)SpH
zBbYg+3#%iD$`ieH+>&##KzYtLV4;{n{&7zgr2Lv)Jlc!!uMfPmI|t4br%aG}hVef>
zLHn&1(`vo*B#ZaaraE>jxF*;xya1l4r;v;q94=uv5Iq817qK(uODwP-S-*KFPFFod
z(w7SbhrDUj$v6hSd+t>dWh9Ci<u>NIW#=ef^>>P#{)@w<1XuAs;VB5GU~GTfi0D4C
zRGf)XtuD`g+j&P22M$yLg7&Dv9-eINFPTgd#^KssA;{+3<<P&zWl5*p$WxOrqZ80K
z^!^3Lg<zp*P+wtHiH(1~t90_fv+&v{Nt~h7d|TwUsXorUS=;3LdvtI^^xuGy4^38L
z6<khi=rieR2eWyfQvm{Gr~%7c1lvGzWMHPh?Jho+h&KU#i+SL%Y8<tixBsR8pJv0z
zY#f7T2K@0!O#@1M8h+NFiN@5%G3*n5hSqv?Zn4d}dvcZt2|Zh1^9?=g_7k6sL|fPw
z2hnc~Kv3!#ntw2kL0Q?U{#^AeJWl&gnlbX`Vbf`JT-ipGs!t!{);d0<R7Y@gzR%O6
zTnD2j@|0QId>w@D9{HVZvA=)R!TWE)e#|Fr3>YVXQe;ox`xwsh17D9UCEr=p)Y}QK
zwQ84h=JIHrfXy{+oSSbfgViqfFxewG1}OawC7L)&Wy%Mrp}!46O-e{V8(Fsj3xM$H
zt7)Dot;?9HpoFfRT9tCMR4vmNzHhor?W$;YC<Y&lNG3|gq_tR~c{M?ohN%p@Qh55x
zKM0_VM+6WIMga&0Uv6cba{D8R$&1ka9UbV}fuqF*$7uwj_w&|<jp-&%M={a*cd1*@
zB0G%NS5)54ps5-H1St1tT7hLz;B$xq@yqXG-#ZFFw^K@BaV2%?_h|-v!YYC;sA6Cd
zAJ#Nv{@3)cnG{dqESE-<K7=VxaRPd}=?LgBR3pX!_x>kyQ*raO6fOlu=|bv}uo9o5
zc%1P#ekOa7Ij%ffa{+7L0bco*L;(U>b?kCu+laP;%Jh~fC4<LORqX-T(qHK`)VS>o
zFf3h)P&k{E`+X>9;*D_)H$ZmIE6X>SvFko|b}em&r6&+NxYO;^hL7vB3tXLo9Lt;0
zL)y<h-v{^r+<ZBX$-s!<l@Ab<)w-u;^AdN>XiE%3%;aP{Wkb*L{a4bpzzBW8j1&X7
z_-Kr*w}`qDdoAloLa({>Pa*bE1}pu0lvRx30dCnSzuz-)qxiOX#Sp^Sb4hw^=H9^y
z^Ytv~m=$Uv{tH*4i++EVCGDV-gy(VN9&5pX-js)_+W5G3#A8Gu1UNIQ8moYVpweyD
zFd-H&3RWykgr{7GWy~@~FHaXm-&vF7M^qF^_j8lA>!@PLYJ;fs@N?x$yZz+&P`~1Z
zt8*xShHI3UJDZ;O9jh)KcNesDT>7>mKPU3AMNkx!)l>U>4G|->#IuFpyM%7|z3c40
zBav$coWb3HRY*oo^F%{U9AN}WVIyW<8RgV;kCxYxGH<-XI)a7dbnnCza@0-Qg~3Z3
zp)CP{b^&!R?@JzLi*|EkgC>z>L&mA%CkjY6K(>gXzgZg;3v}?)O;?=Ta~LT$zU|Gy
z9?a!u-r%cDsTuE2M~nJ9*zUSsrhR8I<yEP<@L6_J1V94^E3EpVNd}euE2eC`7SV!B
zZahaKjWZ&MGIrVN$_9RKCM#t41JQ^;9kMXynP?%Kgr>{5$3-F&kD5skWlOL~#lxVf
zPRnP<Lq^{x6MvEIii7FdG75ef85%=<>*ucwF{=UE8=EONSRd$@KngQ9K`V(zEAe*&
z%%*h2)u#r6hJJs<)XZJ?JoPtw&FpqE<Omz#1!zVJGu$LSjR%8lj-bQL8Wkm7+|xj2
z!s`)!*Z$q_S97<2Gf%SNxIV)#ymn*vAfP_sDrQ^S+$FlSN8!oZh7&|>!B-Ov*88O!
z$_lT=U54?c$|6=P-FsnD*Kr|zi!0MbQvt!JSF!V>R|Y5-7{ouf+CwbLSuDlDdT#m!
zT5`q*!icSf5i9RJJDZb2I<XN@<5B%7AVJo(kQo0q?w9>@n?j8~LqLrZ3H2m(8ODw2
zkZj<WE9%A|0f8Xo?rtdpvS|Fvgoc68Uu#A}6}RXkdP<cqIK2)ncY|GzbzQG@ONj@L
zpM!BqyQ6Y|FCvOCbt4z}l~=ag7U#YZzTfM|DRGj&`~H~)?xaR8LJal?Ii3`17nG-*
z`@~HT?YME^1Vn8(zodAV9f{Rmion(g)?bKuP0D$=mnXE+FEF-#dHJ3;TTdZV<Bj!N
z-5SS+41R0Yt+a;u1o09EHUttp33CoYs^zZ)9&YHFldCZGcBUJW+P@~#rtC9?#6UDh
z+}g>53b<tkX*M<<ld3%WblR=2us>lNpeyR31iDmR^tmgbORZJ}4Q&Etuz7ny`o_iS
zs>CN^D^jjPV%%#;7Mw-LwB$fQOUO(}w-PdmiZgFK9Dx(?yL$Z(%SU9dEoopA?oUP*
zmO?${%`5P!1T%yQz11;$)?s;rAn@tXe313<5t%Kd#2t}EMQf;0#Mz}D1=-}wR6xDG
z&$blem#L69$@WGBR>5Q``LE;HHG?Td!wUmAs?ar8b&vUYK+X1{yfpX$l+_@(u<3KL
z<smn2i>j7w$5%Ez7Si^;0`;-MEg{<aL1Ae^aN^5l=wtacZa?xFL54De@*H@q6ip?o
z#Ssi&6YKV~xf0|$1Xaa^=?qA_$M<jg=&mZ|--+|aMfRIR4hqEd2Hd_L$ff5erm2}7
zfzV_$juV72ZW*yDq_==+7~9h)ggk{Kk^0yT$7JK4?37~v_-jNOD8|kL?!UU53>Z{4
z`GSPhd2_Mx&Pn_H1-s<4X$+_jDPYc3OD`kFk6&Ga^d5<Y4~>AH^ifD|t2NE~_eR)9
za=H9#z)g1m_Bd(qMDpULpZm}K8iGr(O(c-Y?lK?C$_NuweJWPpIX-+HN*__<AHT?P
zNp9HX#0gmpTIwpyw^XPS+#_H;!6oY1CIF2s(zKzmZ*^x!(k6}Hry4lK$}}8ToW*-s
zn!|>=75NhQfAWZGA&P^VfaG!o{@!1Wf&*M#5wzJg)hxjFq*(D-%bYXp^RXi<LavMl
z8$_x-w8;EE-7d;dM_lUo^!mM2eD}|CULya45@dIwvAxZsc0LV!Jmep|_uOl>!5<gH
z;$sV=q+z!!x}pRdLskmTIVJ;ZT7KPCk3SKDuo2hjBjxE}ZA#I2P!-bY`{?0$&BUt$
z1my8>Id9hi?iI>q`d`N`(_^7h<s?{1`E%w%bh&nBa@Wqq0@g{wxYx?aUM-JU!E!-0
z<i}K|qdu;_M#iafG+ryZMb&_fQnZjTnKTN;53Z)hX-?@id^|oxS+7-h;ud^z0{?ZH
z0jJa0e{q8Pd=mh$TZ!iTv@Ew1PFmLo5gr;08d$A9T1sKY+$k<h)Kt_!JYF^ys!ko)
zS9j9<&TqDXPG5ozvLS-xc%*8@#W=d}C@PhLBZj6;(M<bF)W7rsguios=lXHSgG&{f
zr;Qerxr%X;A(9c*Y%3~0oST11^o>+?7DXEcS27>RlN1|4zTYpD@K!5&!jrmX!qd1K
zlxdr3PNWAn8L;o(f~tUnSv|&Yb*ghWnuOBN!o}2V8je@`&o1IVZ8(my_~CN{K!FT|
zhTgbKT(aUaKGXO(%A1fL>Ms{lV}vQ!?%@m#Vk(C~mo!@FE>of6@6P$&+=$<tPP+A_
z561-IJfv;bKUItftO9Y1*qGp)2*J-B9op;%2FIBA9Fy3rHZ9y*OX$J2U_lBx>GF<t
z!_wIRzb<J>#>^2MW|3Y0w?*(J+|iaEYs;-fiUTSTGD8z>iAix0NNJ2)>Exz%Y|%Ju
zEQM#uFEwfdmzUi*?>jQuccHv=tSA2n3xFVbVE!5;FO~60rNKaRz58JQXa_Q<C}`ii
zI3J|+jUBA6l6rakvjYlLn7Wz2VZFo)aZn&C1pmC`_AE@GR5Tfm@L{pEn7=@F{Y&0Q
zABrAvZHa;wq!p=`d~r<#_!G;7U|?zQjVu~8gAi1*5K`CjBho`|mN6ugONK!VvU5CV
z-WK&nHN}`fTLxTD6KyW#556bqRamOg@W8B!I4Vue+K4I?@3x%@@DzlLHP`W0KbJ$B
zf4YPx{<(#TGdukRepM~+9&{?ZXn$n<ee)jG_17;8?V{L`v%2Jge;<@bK{K~-Ip}N~
z%IW(Syd=CJtYev=)dDg@+E5Nx+%>_Dal&ugWP1}gkb5z6(2~5{AemSKQP*GCgd(`#
zja*jkR!(pCJ!!8zM+A`nCaW&&D?s;4lW815X7Eyj&ZNf!NMm7HYH=NWb@pujIE(_j
z)?DYZJ~malb{-}W{u@Xa13js;qTzxVFm==A2XuK3gz4M@VZb9T{Kw}eTGmriFGxC>
z5T{YFCI4=S&FZWe$<UN9ws8}EGH@w1^cd2pNk=_W((<VO9_>%RLt?_VJm?*^m*Tkx
zSy!ZuAQKyn$ukjBxy=W*_v<O@;f?q;^u-tnSf;Fu+0$w5#ywGFsd!_1)WP!Cj4H9?
z8Syh8C8FMe=d<vCu`Hne43YtPMZmpuW=`4UlU?8j8L3uxZSZlqKjpn=aq-e`QkYuD
zm(282m%NddK0ai7qHj5{MM^Vk@BlVi%-we@%{Jpw&CCpZ`4NF>+mR+F65EI6$)9tf
zzZ;#tC11YDsxk>-%E`8U64d@Cd$<D31WYHehlG)z2m2dpAywaDGnu2=q<xJ)i-R!K
znA^_%#$A(*=Op7)Ld<`1Dcg8pvl{0p*vai@q9_Z%<hs%H-uM`q(!Q;@m>72sCS&v@
z*-}KoU1U_)1i!VHa0j1XhS4-Y+6Gt`>_vcs^3>6H&}D0a4cd1{xy8{H=ks%i1f49z
z2v^`iF=k@=1;<+I%1-#Kaup|>Dp#Vi#YK_C0m-Ln*|!4Bzo3m0$!Qn_b#6j8`|wLC
za-qAl|A8VRpA!o5e%A1OIyVfe%TUaYt(JrLYn3jifu*juH{&`;2!QA*sYX1QW#Sn?
zSN^ZTh6P+@La{Q@w;^~amPsGQHACHSc6<6^cJ1?m<>TDpcwhK+D9G(YmE&dl8@R$0
zYB~Cp5T%MW|8Wc+EIw3&Zw~O4DfoRZl5`AAkEKZ;l{+i#w*RPb-l4!8;SFtIQRK7e
zA*Xv6dbR2CUYF@TX+Ya~I%?zfkg8lHG{`5;jfAQt9MUL2H1){mr3r4|qML%%VsFMf
zitCA?kY>hzq1r570@+JI$Z-`jdoo{Bvj8bAn`2vLvE&;KYX}v{Z*W_(V;o{-z=~we
zkY!0apFja0t$Cyfc{t31<vB6-`+>RYQLCX6JLg~Bg4YUYsNO4~CpW<GCtFc>q5lv*
z>qXJ~=iB*0lBW0GxTV5zbqpsT1#>M7AKPfDSa@o)+!J&v%106I&K^Xrp#f!^B^o6L
zC;bZc-?Wg#IGOQ&e~P5)dVmFKSqS<>w|a<KSl3qr-8i*_-{ZuSZfgcGnlBlf?wva;
z`W3gTpZm_}=hDPOE)4;f1{lapvcE`rJD+d7td~`;bF!!Oi*3pE5)YU{HM`ALf;jrk
zjdD*5gZsPPBwwb7h%yQ@^)QWKZV@eVbR*2+qJsXeFX%NKj5ERm<xzv^LwFfU@k?VT
z*H)MIG3|Qm)#1HJIRLYQt~&XTqw+TXy!m+k67=V8p%1xOsr~e7!W+TpvfgGjG`Ze(
zf0i>-OzTy2sLF@oyM-ZY?3qf3<@NXb=()aS-%s)-EYYtU0jE%wPHNJ7Ebbblb|g?-
z-iA;)oP@Qps~A<?xQyG=Tip&>cIOxEmrq69r-sZG-*clgKU0;g6kth@m+|PX=hJRf
zAz5tJx{;EqThG?Js#eb?nM_ELrQD<42R#G9l~Vhs$ceCCck<}-VtCEd%gw&ch1M^f
zIJN;Ba!ErpF+|EFyLas!FRL}7_UnUqPj_!Juh1IGzTbPy#C=AKj4HtLl*v2#A=qb}
zdkI&bp1c)gA(lGXpw2jvB8}vKGAOpws!vBX)<_R>gEh!{<RWCoGHxM;P&p#os7<^7
z&NiSsL^q<Z%hha*j<Z<h)n7u+yL}Zkm<v@|A~#{0_gV6Pd{XM(*Rc|Da&mOyDZM$_
z1>Snv1`fGk@yIcouG}<vIv1D;Wn<pi`b<tvIIW&JTR2z#Nl!78W<6+C>ohU8Hvd_v
z^6ks!dbRW3;GKo^@8yvp+&XEBip_WXTQ4O*UIibTkjULvU@25d`(JZB@Nqs3{8<Q)
z_r<E9DqClM{sD-n{O4EThi(cm9%z*8V$*8;7kL6D0?sN+`fLrm^Ez4m7c+cDq@~>q
z!2U+76mPp$%YRq=cZow<pnW`_yeu~TrvVapCq;k}aG1<0!`qJIpMMtv{ulU^IzUCb
zTY9LlDf_(G=S_;i#(=cLMx*C}quT#;^nQv3j0|N>PpU37Hb2ws|H_$I0+eU$Hf+x5
zUu^$R9=_ke`p%-xW>aUy{|Zj60F)>32(xJHU&8YF<cffIc_3lAtJB6y<9`KLEd<I#
zGe;|(^hqT6uRL!BpQ9bUHlG{+SMX{{p!3!!)JgxT@xSssO8^Cbf9|}q`d`8Szp;?X
zOCsC<GYjB<7Uut7)c<QO|1WFjl1^3Ge+;NwMh?)@(gIK09u1x8Fv)JQSpG!8qlW)U
zlIik+Tkg=lDDG6o3jCiL8Ne7Rzx%t(8mJSEWT(+sA^-pgh~mB0U8>Zg{rxodhcOn1
zws{N8_%X(XI~r6)$Lp?_&e*%SP%Bvh321~{Lkd8e7yiW{v}=<33SPD>ha|dcBHX3U
zLoAo`1@Mf?yW?x#OC$`Q#Jx0Lv@q`j&dnCAsLtC0TJ9gFeS^v<I2NGq$zQBrMwSNB
zX+8doVeGTtj5FfLnqiX7e`5BJEkN&bc5q)d6Ho%i+X+U{+m&WjlVf`2IOTm`r*j>f
z^a{p#>QgabSogR-_7~Ed`{VT{Di+b_dgowc)1}5W{6A^GEd(Uf*KL@cLsB3tP6<+x
z;j-a||GEVo#RseNew{Q%KX&~EKU9bqQCG$MF0rY74@UiMS;k|rF0<irgPi9oB#igC
z=AS=7QU=;MbXjtw3Z!=>y3c}bA2%O_9$ovj!y6B8!T_L})^i&kKid?^Q;6;7$8ps=
zoC#B6ds6BdV6%+)pIcy41kz6MN<%W`AQQ{LmLs;RNy~<iM447$$<z6$=VOQ6g?p(Y
zg#R{Fd7Z_!J)aTpw4Xawc?|pY(KXW4G~K0DKX(Eh(IxU{#)cePq5xbO3CQk9!H@_a
z8cD9OzJriR9sN-7yUR5_jAymV_aD3-V)Z=gS`HJ;!vj6NaaW18Z~7<Im$m-@i!nLi
z1MNLl9HlA&`hHyIAbFXF_#ths<rw2lrrQl-OSA*F#!!e+nd;agy$QGDMW{)HcJ4fU
z_J*3_i8o1;G-u5lMhh6XV=e-+FtlqWzik;jITr3<ffMcvlBtE~!#CkR`6Sfk^a+SX
z+H+Oi^JPag(6qxVOOhBh3TCNx-u1c(<2hr2Cr2kyZiYp*e;d>FkgakqW()Fufe)Mc
z)B@GWPp>>=BehfxN3G=Zq5Jnx(-Q+6I4+wN$I<mBZ8MzJR*!4C8;X=V9TXH(24)tZ
zR{h<$C4e4Rx4uvOf&BM1`9lzKI7LQdx$RYiNGGPDX8OxWuWGm6!FCJR+fdlmfwm%;
z6(&X?4E#_Kx2~Q9Ta@0guh5MwCL?m=BaNiuszj2c$8wUsWXVlV;4Enqt*0T^=0NYz
zwNJp?@(y*1I4^KZ?4I%iOAWrfxuiM#28>e_0fJ_K--9bWXLH_VB}GKEAztNT`(yRi
zTz?EvhZD}|g|Iqrqd>2PO<YV5(BdiJ;U6#1ObN<OAAqN9PqVZ8)mUA*8Ed@SjnEek
zy?7|ZKheu`_>>X{_sykX{6X4VCxtgy&gmaamQRNS--vCy%>!yEHRtD6x2{qMuMCNp
z*NtKh7>U$<ro7P6&roORi#74V6nV7yZT4H;9v;8NqNe418Z;dsnq7%6CL!sxygC*q
z(&_GxgFjE&eF$^1D-~6~9cu!}kw~0S36%O8w!afI+-bPHQ-<po%eNXE7siX1cz}U4
zZSeV)e!>-dIJS5yv`T-X6V!yI1Cf(2ZB`@6179tJHsp6;2$iueml=~8!(amqra@gc
zdOIXc{o0yG2SNQX+jO>B#uX)ek1_VQvptdFp_s;2F?Wtf^{4}fXnHaR7}qwh1j4o0
zeMT;9NDkZ}z-4_@ITptSlak5tbwxFwf=Suh*g#?)v@B-@mr4JSgke7M_3MpC`9BUg
z{4?EG&rf@~dFnVU1(v&ux>0uB2_6MBUw2IS2rWgjF;agZ6Ex82!m84tLx9K8jJNdj
z+#-EkBEcua@F6RTG{5<Vz<}s$U{%wN^nx}IBEaJl7Lm4~t-bSYxa$R8>*|5-4G~Xu
z*YaKhkf^7TXv4l*Tp^U}jl7CHHoMZ%b}naV9oMPyb#6lLA!WoRP)8PXD&oo;VJ3PV
zp1BJHgNVd1uwy)}pPTWO3h1uE=xk_UK8-IPP#+^Yl9mWmJ^EL!KMeJt5HU1zd{7z(
z{MZNG>mSE=uEM60hPb@0#4<aR?VIZ_4+r`pJrQhZ=v_byMVj}f9hXR}E)B|aJaJjt
zNgs$X3x@*EhM8KD6H+c^?ZhqCzG_R+er6E0vV1gFV>=eJLZx8529SsvYJJhmDPc6i
zxJfzovco&*v>{nkwEPj(!@a`+egmwDLtHS(YW8^ez}b5ukHH1zHQR6kJ9c3zlO0?;
zA0`)P1~z4rFVf)uhrPE9i|YISKq(24RzQYMmF^BDB?YA$q#2Oz7!i;dN~J?VQ0W}H
zBm^l3q-N;u?z{&DzyIgHyzlPw{9dv-XP>>+-YfQ6pS6aJgOQmNb`MXe%4z)-3BS5o
zlMSVOdz6K+3Mxy%TxW0;v2fdzWo{B`@&)%#6h9Dukd6ER@JqEionNIWpg^aq@~Bmm
zbe+#QCh`Z$conk`8Mzd}YZzu5{D&42hZ0*`#fQSDYcBqaYko!&`Uy0v`RDmo;;Ust
zMyEbQ{=(2jVhVg@!ABhXZ<Rdo2SVEn(4Qy|I=<5(aB1h%$}{4tJ%k3tQaDj@@<FJw
z$eR7P+X^N)7$;vtVR$FzdgBA{G3XgSU|H;vmbB07aWIssxKJNM>Brl5H!Qw=3x|cZ
z=?d5>wb+hUeWa|-wa#nj9mrqNbd^bb`=qA1j-AA+W>5-^c*G1X9LBz3kOGs&sFKWw
z!J<)Yi|pOr!fa|Oj=k=4knrbLs0`e`t3T_#nwynfW1|sQXga$BHdwMZcw^{ha*_~;
zF%%zoSY7}gCQrmzp#7zTGy7h$>{Uz1U|NzatRKbIW6Vi@7FKMk7fvzz2`)D|m@7TV
zzJ*z}(prweSj>-MV1rC9ET<Dy`REixCb%z{4zeEj7A;;{DJ@d$f#^46kmTgFq+co6
zEVGv9ky2&T9SrXXGmfxjBh^Yl?a!}livv+4=VhN+*cntW*x+nD+|yV_88^L0tm6XE
z#=lA1@=l5qZTq8C`r6Zvogy50{1Yy6RO87g;t-g1sK(|`GslVjL7hsUJ-9pzsiUZY
zIzGhhmyUY&`FJMnXesW;pDTLxt!GW>1alJ?4i)bMF<_B_3G$Ws(%{}GVw38xP8y31
zry-e&eCzt(p4}N|1+$H7;t>@hesWe&gw?zrB*JkpS87Xg+OU7!FeUC@aZH;_qoO2*
zR{K;64of+A$g7NL8q_v6bR%Y;vtmU?D`%E_*2+j@bQ=UeQ6Kc!o29&;peBl`@>ve=
zBS(Q#XAu=nlJ@)cA$`a3??y@ejNa36rThvo+-wSmO&)n*PpQz1sK?V9VA=YrfrC8d
z+OvDnFJ?p@e(^n^uhZGK<+OGp@V}=s!1ZZ2MyKRWdx1UPsQkC~6dR`qzRs1mZ#2B_
zC#?EG$&mCSUo`9ejyvg+<!H8H?>*H(Cb4CBILLbZ8b4qASPVw4*uYFMJt;3!aV&<=
zDnlHFo!+Ox9K(+?c)yLMl85Z)OsZtnl*=EN@V__Km&xp>c*1TtO>=rywT~0e2)bR1
zj&BbdZm3L;#sj#@OuV(TB*SK@X!0C~_ST5ETy)25Xxs^T*1E`8>Dkax(zmU!ONns8
z6#PZM??@TY)SeCh982kVD>JAJI7sqnh2`r+AKRFU-7#X&*u1GkT;C#lcUE39{3J9z
z1J8N*wz5Z<0^XICp}l$ASAE~&1SJSb&?oyhC1ry4kh^FGpzJS*IkKfJ7>NrbEd)&e
z3NhUhs*OlLKRqn^-Pp@S3&BS-xF>7wl=9-N>8@jg6x}Dx6%urkh~1xI-Vfj15>^am
znwZ(Q_e@z$wj5I@izUQtvkKwnhOKwW=ntrz-RnJYD`ZDJM3axA)V1+3w9$WPl%{0z
z67503UHz`xw>}9ZXmxofP(Ssa*pp!saqwo1G)5!V;YZ!H(dRb>`Y)mp#{^;kOJgE@
zR?d!^$-zjAilcBf+LVj)0HLL#bNTlHU=+|4cfm@5Uvd9F0K8UgizXpnWBdI|V*k8o
z!h)TDvaGI+a5p0#Rk(RhAg$@AEHaFQMIbG9`@c`Zaq<nyp%YKg|E%E8XY-i3njU?~
z1P`Wt4Y+xmu^0o8IVP#!!GFI2EDl(|EHW2o6(HsMT{Z}CYH$eM=x$aYMKTiNgTS<I
ziHat^Qh0x9;vjsL4JPv*6;Qk;ym%X+2{aij@Q)FOw8hTwg?YFkxg1RW@BGEH7?^}&
ztYl!(iC}^M^UdHZvQWOeJfwA{zy3lX1}QUF;FNB)wSLt$DR2UB_^E&fypN9EXCI04
zk1(#=5LAplV2%e<`7i#Fa_6ZDNCt@lCNEXWSNb;^`NU+N6&wyzKN(bHy51x5xF(d>
zR`Z#7M(BLz9Y!S_|7L!MLn-NB=Wn2{2ZzxY*L?W5jxNTJ*80pUeot@c55j<1WrGvr
z*QN+dI&Zj{j}9^2zyO(LtH5FSvz_EOMCcGf)``F<8kGgs@0YZ$*9LLIp>>8Smg5a1
zI-PbSZWcH47%eC)m5w92KL8M-DO%X|><~lRS8F3Brpdyo*3T>P2C{~3c-Lftp<{`J
zeGnLVh`<C%X))gH8W#qpzGap$dO^85Ndbj&IR1dze=l*6NR8NkvCevKXpfwa1tYJ&
zuP<k!(1uwvt%dlywgk`OfPqInD}=8P`#2-l77r)}>mK-br~|U6uww9ra(fa8Bw<ua
zu-tm~_BXPpl{Os+((AK>Pb}4K-)Nm>T(3|Q6oh2HKFF{T6f!yaYG<K6MG%$T)hd!9
zcGA}ztCb7nhpBJCX&#ruE0zYP$?kc86-JG2_9<Q!1(i2G<i33QW5V$TZ)CrG9R3ae
zbf_RD9FcMnawOmvn?2w>kfwM1jg(bmJhShUygYOE>zxNH!%3ku^SN6Fk$nFi_<@rj
zWPSg6IsAMz(By~wr=A-D{g~2}-0>k+78E&zA>-j#t$nkJ<BY`;Pb_@l?bz6q5(&jA
zSV0BXv*oix_SNla^>E>GK>16)mG!WDK46xwDKsaNir<<;CAP>%q1fNB^QAsC7gO_Y
zzi*Z5j<A`PGh4sm>>3;D8$@Si36&^J3u8#B9D*rjz%pLxIJx|#sO!;`o?Bw`9~lK`
zEY?6<irM#N9Yur*)X;H!D4ke{Ln>lr1M2eck@$)+<N{%5Fp!6nHmB)*5F=G`Fk<h)
z=lv)B{W!G4IwsOSF*-H77QzO`a8mY{esOQ|9J*E<&u>2S4CmvZnZ8vuDQZ!zb;JYn
zLFhiL%4B8T!L2;$A195_uq$*78MqxsOV$LX%WqLlwSNb#6gb#cmB>Z!U#k&;U?~N@
zOuTB?#i}j1IE4|x<1Hnq6B^PIC^PH$KKyL&*HPjz^FJvHK*PH))fD^gc%NbUsOn;U
zCF&J}tbXlN{Q;WwoFs;Ss)Tl`_7^4Q4FeTS(6JvN1U|mIbFG#DW;{SpqW|yzH)8Ss
zfBvi?1Ic~fcp_}Rn0^T0C6b*rcN^&a=5yuQ{n_T?UJTV#AviXt3w`sXvdR5rxmf6F
zRct0+XPf)U@)!Bnji4Xnfj45JlPGoid$QL?NHTjy6)*^5#3>JE1)i3}X|O9sD8#4b
zZ}br3ug56&h@Q~f6N0g;%zs3IW4w_laMJgELbG?~^yICo{<A}SjDa;$dc|~zC~EQW
zz*XH>GG!H{;7@N+70qPiwAgP{HjG%xJk@I<NkLF+d}OFPX_XbBqYd<x&2R>%$w!x5
zn;%#ZiZ}XTvj|+IsHPyx8uyjao$;uaCar4;1;i@9#_8MLWmw2zO~JUK*;@mxhnn^&
zJPpw2*Zi=+Af&TOa~q;ijO8Z=mozOf!P!A40)WSQ<rox)Vdy+Dqq8ZXHztFV;>NAY
zSryd$G`SH(@;DUSr)<@9>LK~%S%npZ;7=n%Sc+Jj9{;SPD8`UtW+W$K==P6|$S3-b
zuE~?4L0e^bAx8>cMbA{Lw7HSkCVXNYl4_nDYkd+7QK2LI(i<h|0u*w?f$`buJA~cA
z%I5$04tM}?H>7oDkG4-F&wow;BpBx-QqDI3DU=DtJavx_mXEx3v#I0}QfG+42Nlt@
zh-csUJl_xLeY^P#@dyK?q>wa<7NKLls|6FsCyTf_I9&7)_4tesQm_#@mD3yDiknxI
z=mOJC^~3WnR6`0K?^+;eLgWAGlaB<DY0fzOM~DzdBbp_|joPGzc;Vc+WL*B32|fyL
z^%9lx`A5#LcTG)s>MdaccT@Uk_9!uu|1pvXBg7zvLbcpW5Gi*@BIw33`X~uuzYFFl
z+u!tOzaensE}HbCREQQL<oBnP{+{-SH)o2JkX(804kMy21&oWCt#acvepE3*${<bF
zZL;{Tw;fQ7`B5nJR*7xj=(G?o?DIem{<EE~Xh;S`h)w4bl_kmzscXy-)1fcGrLhNY
zk$1BW9g3^L5JIq$bSA?;5{vyYVDja7WtLU`;?^?%CcuEO6M<X!%vt2#KyQdMF~qq;
z>#61M<r*lEZ+Cb<;fCqNz|<ciVA-;{|7YGp3{0JDy=rUFN4!;pUpvzc)rExQQd@wd
zysl_Gs`}qD6tDeB%^i5<-+4`DamIXXkw=#K9_WC(`h`lu*E5^&U>)fJSmXTi+i5pv
z;n(A-I3*6#O=$x0-=?#L;>1GkYa{S1`NO5pwMPvb<35w3fm>rfG2S;EHlc@DrF$(v
zu&6zEI$6v&gUO7J4k{b{GUw5fqQwtJS_mYS@4Xj49CLB<-)<x8n-47&GR0-_G!X^j
z(~HifcW3{)xf)VSGB^H)7Y^Uv(0b*hL_*Hvuj9VEJ#Ta6>J>7(IBM6<Hv<9~0t%z6
zn9{>~w<9klCbnJ;8+rsA<Q*g!`yT_>TJdn#JX1FD`kk&UU|~6pZ;SUF20r~|!^fZ|
zzNdF(Ppm113Ja?jl3~<86=P*8$K8=;-?2;D;tLTtt{{C;Nf+$MEo>ea3Y?*JiM>w*
zbQ+-Jyi?D!qwU3v0DrfO?R@J$SE;{>H-x!qW&lg_sCh#V&L=qGIa`jKmS1A%HmHf$
zCKoG*AGg#iy17>PwZ2l#^Zm*YSlh_ULb{})1*B7%Cge1;YJBNkTd&l;y$omi{`<rA
ze!WB!V?jK#uO^Sjc_QQQv|RSdhiA{Os2;Y$yEowX1y;M+kfK?`m*si*T362!O;{&_
zka*QpjILQOQ|_(q>5R>hsWy~y`Kbxf^!~7Mh8z41(3jw$q{Cyg`Aje_`6$NU)6$ef
z_%-f<)^|caA~77&b`A1RHWWJ?-7$X0BdEe1v@)PPt<Mj;PR5#puv+38NgN+`)vvdH
zk`C3tpMm1$AJ3tNiEdOev}D<Xm1^h(=)0recIZ1)Gbs`=mTYq$X0GQtEjU^~fx|vg
zS&jUa2M9B2e2#|WCv$|L8{O=$r=OZ07_1Kr0|(@t&6^h=tYb4MqM{#gx#}Z4Shxy%
zx1TdnSm4}IPgKQ@W|x$kiIu1B6o_j<$HGG=ozTE8%^Mmi9;=EDhe20)(61dcW#+Bl
z&(-Gf-zbHbbu&U#bNehaAuC3%nu9>0dkD8fUZ}0HVZ{JmR|H4RSMUIKtvbf(qwhMF
zb{!3`-cl;}d48qm+!f@WW|b5u8IIKbdn&ntq(U_whqp0ccNFdRiWZ63zWrSDQnRO{
z@0LI~?LPDER=qcTn?7BXV#>eu$v<M}?XnSvQA}qi7$HVLG}6aJn!YlLs(E&1+ig5p
zo@&US+E*7)vsdib!aTx*rU{{Q&^X~s4txE0sMx8ZoDQ~vcd=f-99o*htgd}z>(5~5
z#@Gw;*`0-;WAPZy(v@wONQZ0Qjg~mE78zS=1ulzn1Kgh1JBvvqrKCyK;(}S%ZC@z5
zop+X7NI@9mt+~!${-Q-lQmZVtyPuX=v#&%?E89rL+<+aVntO@(8Zv6>_o5uE6>z`c
zT4o}e+=dOcJ<2BHi|VVULqIw{c1!8D$~7AWrTM1qKWYRyWnewFs{B6ltj4+?gRVac
ztup)s*zHh~lEP~GwN_PvRFnbV^#8Cj2}Lk(o|TJ&^l&mj(#}!a!0DD_&U)F|5M4S&
zI@vSX@wmK`445j+gP<ZFs=$g6$V|DT@pl`3C7{$m551LrN{KlQa$X)o6IMBBVJDa+
zs_y55iz2e(bfg*7X((-M*IbYznQ|}poW7qRA8SowoY_^&TSfk}cFb03bw{(FR2Li{
zw^2l9rx2l8??DhTSi7fDSk6xM?dGDj`Xo@EWXI6%jPi;3G2YW3TITCTj=3u<o-a+4
zckyLMs;Kogfjza{Kd9AH`V3M<V5THyStDDGcrCBLKZfBs6gMwen5qSBgE|bVYbsDV
z{*)@wglj2jIznCfSKZTZ5yfiC4|S9*{{p*d|B%knh08J4iPaE|zl=djPbFo^U-o2(
z9d~4ipO2LFiFwVv5?K50D0X;O*5{ARYgo^8^u8C?EqHak0W4<j3yKrww3t2u%sGZ^
z=)G^bj#Y)>JbB3v(|#v-#ONwztB5w+36+{KBP`vvi>8yJTi<z?%obD+2Kb%J*Vf?u
zR4)fVv%0@xN#Z%DmLaj%N+WUh#W-ms^2f#5{fqI-`OEJUT@CAJjb6>5_YNeFlK>0s
zN;s8G{ZQ-3>&T|2pwKfL<#r{sa$%+*mc(*@dVo-aN`0QgU_ScUv{y2HzGUhzLU0v5
zizZdrNsyi{(Q$<#NdPA+RPe#{JREN&-wo%3qjPnElJY7QR-Rp@|2EuC@^p)@Z3z2v
zLegvJ2hBy}#YDhKV}{sSzlK3ed-RoBL13)J^_OQze|#bBtSOmquKB_JbiH!8K6c@5
zOlcUU5p6##DY2zUb-sow)7I>bXL|tYB6FRxJiUJ)Yrg@qV1|tygqO-}G~oZ7I2@+3
z{Ea{SoyXan7C{03ZKt#+rsr#o$9tO>h<DL_pu7F+=ox+r;{u$5>rBO67%QbDac@KA
zKxKTySXA*{hQ&XB+>O(p9UcM+)|(D_N;{fUMLhCM!v2EOYQS+C>~dHCg8`o8h|Fjt
z#_@=eO%_!1xWa;|v`C=1F{j&mSilJ}eJ|j{WMjZ37qoFMPAQWfV;{&%$BK)TxO=}h
zK2Y!(ieX7k5{{M1v~>KjbJ|);l|(rW?aXdTtmR%A`)w+`!EqOfC2_jNE1ywhYH-#w
z>AjrS0ByV+ym09qKm5*q`*OK2!;}gid^i`on9GgXxF??Q>W6+0-<5}MLV=3$`~zDe
zou8TM9n@ATdpDcgZSLp$!<B|k;gR%fGrr*}%GIBaS8m_GT@)_1W{2{Ao=?56qkC7|
z&`q<w>0yc$gBh40_{W%$8+CLoOcta``#V=F>z;i{YC8o;qvC{S=Wf7UN31|M(}Mjc
z>mdB`NzZL%^if4wP_K(=eCRtCY67UIz-m@zfmMLG+uYXV(cY$3TgXAp#y%Fu$%5nh
z)>cP`|NLAqoPPW_n5t?F(4gfwAN6tzZ9y{l+SId#4&b1W^6x0qZ9_-4P*q!{Opm%*
zs&7dTI+lg_bcdeULl4_kTqoj#mLW1e_oGd|R%$`@Nu8bmKa!TGRHRo9UYu8d`8;F0
zCevZo=gy?FS)Rx9!mlFZg)FF7jNN^vX)ozDv3fCocxh5;mc>qfw!kFmyMN2E!`(?~
zZ1OldplPz3`;R~dp+wwb({+1$@5Nn7H-43p>7>%P>@sRYugPs$1tzHDFq6Kj3CHNB
zy}`>fgSJ(}c3~<f(K4rBYOsqwjaZvty$NZ79#vJSMVG$%i5IOuqz~f$98b(hqUbTn
z&m5fnqQ-zFl=||CA-nV&!}FTPk;ZT?KxWA@JD$s@pOUHhP6v3NLoTSx0k_jV2}PTC
zwCZ=qBTQRnQl1$KdXlwPyC^(^kz!@HrC)SIv=p_!OsmZ7aCz8>ULK?Cjwt8jf|$K}
zf8)_9IQf<)yoM@*Xdd>`(@>94)E+5-D%DEhg$4J(9pH3d2VZsT!#v^Dr-8CQIVt;*
z1!^zY%C^ZL>#07sPdtCe=^w>Zo)It${6fVR#KC;HNPIt|rO!}JqE~;ciiBf4`O2I8
zrGnCYH~FCqvaWKKHZn#6z*z7XNzWQqorRzpCwAr&Kw#)o>gbPTInC}@RDwH%vmbFv
zKQ{|=Z8`4L;jAO9=ZE{7S$5RE`fkDD@HBkuNEGfrz+0(R4(E<U$2h7pFCWi3GL3LV
z=l+}n4JrQCRp!}MMC9vZ!hjW2-r23^NJ{5oX2^@TMPn*2`vyvLF{EdE@=~f#?47Xs
zLt#oBN=%H-md7Lvo%H<bEewqT%_}db`Al6jMa*b-s&fJ#bQ#0Ex`qOEExV!@*CnkG
z6iDDGWGp<r#TKyPlCkj9hP1QQEnxfmyP|1v3u)#EFj>GZF2UGm=%1i3D^n9?ufQ<b
z@`HYsM~n!AM+NKeswt8>h9)Zfgpq8BCH4mWU$M9Z*y$`%2mFlK4scZK<`DgE&x;an
z8C%PVou@CVQ&W;ErYeSwQa-?F-sMZ&&p#aZFlLWHG)aQOlGT#4-f}XL5QyD1nsw3>
zBYY|HiB`X5x;6T}S(oAXq2}jN4dU|GDf&doc#c$fYD!;A(<MvTTD@W7b^P(84rjfM
z?<@F-bsBW$EYu>kcsas$W}-W$w>5?)b|3?`mU@7Fmcl~KnTe|3K-@(`9@9Sg@Z8J7
zZ-V0!ZI)Qub9QRtFN*JKJS=NMhP7~niax0Fbv(*t<$2hV^&2DJjFsJ-ligOV>^UCK
zxaUieT`T4%E7|u4Rery<DQ?B!-sMsUk!c17D~yN|;bOiIMwXXurLMX$5?n41jB><}
zilmDjrI6LVN<gZmACi?SFf{M~@_xEEdDclIc<1cFm0n{8*4At}o78Mw%mrD$3uX%{
zsUm(RWa{FAtP6Z5us_rlru|bWAxnK>KT=!~H}t-d^ix_yZXYb}tFYVS#P}hmnpbF{
z`K-=wtMx01`pmrFlW}SF?R__K!O&#rdQ@5UD7hujFfdJsxZ{icda(OwwHzG%i+}i|
z*TS9`xA=4APNt5FPLGWJu`Y8ACGmWWR^o5b9G7)AzW#vuH~eR!k7Ez09tYXEiO#x-
z(4UXLb^G3BI!$y-$ZdbnF<25Kky<yJk{p6j!|48rfZBU$&VucZhE&X`e<+^763q7p
z-?ZlXhhriF{!;!{`4GKH=^kDQorOZVk$tRXYr`L!=5x3p=y&uTCOxu%0WVR=o++4T
zmu`s0GhR=~X|<rzQg>u1G-L_?Gb8(Vl;6Jg3Z1!g){cIWb@AB{SC5R<&tl6-&8}=^
z!73ScX=Hx8dHr-AXjX_fe;mcNyO4DQn=D*m7j1acGVFHphD4#Aed=djZpF^mp7fz0
z_;+-Tk3VZ2D&07z=YP~V%Q4T;x?5yJ6Y8_Yn~Q_F3s&({ux!*BbstLcjH^z?v(($z
zSc_&BSRfC6NA2O5wi?|ot>`&foQknjMN$}smH(uq|B@XROc86nRGgoDXlIq&YGC1W
z;3gp$c!}G%onq@2k==(3a3{?V=i*iQ6QXG1ARN(y%PkIC-TFnMsp;wp?g-|R640Da
z$hKv+I`7`hnDScYQ~e-^zx<1)BPu_e;-h(~iKf5ih&rqw$r@Lxl+9nm+`^K1MN!jI
zRf+IbJ)4hW@%qyeb)w|B;C>qrLB_BNg>A(~IN!&(dt9u2a-(;DE`N>>)|t-`$Wz_Z
zh3dQA`I`}gz;W!$tkF4U7}Q!)b88b4GI>|-i*w=&oP?bjbUiM0{hA@ye5SCy_smXN
z<ypm(dJ{cp-cFvt!)K*63Naac9p6NX^vrmBr1>NG9EWsk%<P8y)875!%2T%eR->V_
z&f4c);H5WeYYZk;+U2P9xClKBn0iOkl~BUI@I&LzWvmz%1GbwETN8dmge&Rg;d@wb
zpq`ul!Atgjg!pm+bMCVU!KA@@zy6Mhs<9B(M|hgC-mmLFm5hkO10Us<e`jVbI8M5c
zGZB#(U-EgFYs&nd`+7Z;a)@()U>~M^L~)>WsdF09v5IF~!Ey3HQVT7~(y^X}6Z-Ub
zX+@1KFZ=j;NL0Y~5l#E10hRX|fhaX?+QOLcAIEv*A(}o1Vo8aE$2qen&m=XmT0bu<
zdR3QFI4=CNRV;p4I|rlc1VgZv-CG!;(HWGfoKFGXRG3?+v#oe378<)OhjuT8nxdBU
zROgtG5k3_9h;;YqL+^qXHA8{Cb6F8hNBKd`H=1P<7J298d&j4J{yW)Z#eVB!e$O54
zx+bfiAXRqdF3bZiG!}Q>?NY^W#9hUaA?(b>=b6yn+Krl3A)3&-Db5J)7EbJnAI~~U
zI|%67CSz#d#u2{MEdOMVoz5Qqdj@Y&vx(nbGi+d_;(fHW+3P;mM%+`eS5s2*=w$Aq
z%FUZ+?T(7@1HhfJ*zBVh(=a+4x~RxArLbWCvp-xSkTf9b`mr4(CF0<a*QHGoP-vp-
zCnviUr!)R7U^~M*IO4MtSn$pYy)J@{H9h!z%m1D47tBmTl`+pJE~b5cw}*_Q<k?hx
zn-ys!M_NJp-V`2*+Z<z9=@;*~Jg1f~cit_k`8hd+zN=XsPWKg)+}X`a68M`b5tTLR
zqLJxnkeQilNqiZC`Lmv1T|3NKH;;miJMDW!c#P;V*JGpmjEQeU>swPzL#Og$f3t?1
z<vWgR4rm?>(hph|y4F3eEHu!Nosbbq$ZLzt>%fmZKW~Dm*9DB?cQu}XIqO1if&4wg
z1E|`0JxaRcwbi*BmQv1|kCM9it~`R`Gz@pya=6bv9xYXxE{$aO>IVRiKKdaOkL7n8
z>4dF+&X@b;5nH5jVF`~x$4W$C2=3$5%|Zt1jX@<;is^z4N9o4iQ_T3=rW2(D6m1}p
z6#_ND8BrblwYVwClDcK5Jy3UEf4O%#S9o=&+3icWO|rb!#jH4MG1gg^D<G*HH>-Q7
z3K?N!8oKc6xwe9HhV4OK>JeL26^0JyY?dOf97Wu&vyQU6)&22GPRj)i^BELKQxcb+
zR&f4wcBnXWl~b|E+=77ZSXN(p8!O)4Osn^D4w=tdT<hD*nhTKvHZtEbdo}J8K~7I;
z%)VOpFUv6FlZlAgFS3^jn->k`MPbrvzMnYC<{dw1fd>9cE(3<UQu(JxE5UU(eg<Hn
zSnYENHGL=zSzoCpyR2n>*KHrwW0oR2iL+N6pDlEWtNY*i<Y6?^YG3pRb{~M+2m|oW
zACIWNA^%$6pn^xRq<z8R#1MGWg8o7gMQLwxI-EnH{;gS7cDdmC)7^>q7tTN{jdo0g
zZhYcH{b6LL{cV0WQ2jf=A5bVcxgA}b?n`+*SUk;uYkzf@*m9iV{d9L)lUDbq1x&{D
z3E&wtIS`M8VG-F5XWGZ`9An1RunwgDhJ&j)g1JGNZ`k|JO}lmL9@TZogqnt-y^VI7
zVG-Xh!IY8GBu~_Q+AMD{UHnMkkp=GJK4<J!!&oHO_d?91cIV7cJ{`8lsRlv4AcQs9
z@(J&qi0U-m+cHaStVMM^Y;=T<!&%V1C+;$9_3JPs1^&YbzeM%;#YZE|@o7rSJD{x$
z&l5H0G`6|nL5o|3L~^sU1;)PR5&?mAE=dKDjz3pRcW9GCLAmUv0LPrln)6FM{qeS^
z;``6$vI-Hm0}ZX;%8jmkiR}$8?~rGmL+I-Xyfm0KPgdvL?tWqZMem?ACp)yB<yWg4
zd$?w22;;cVJrZ#gy!AnA(R0mvAYTeeC5pla$X>?;*-jM(Np8js`_o`x%UurBl6>Ic
zO|K=7l~Yk?Z55L(L5cHP&64T4goZ`4P0PIZ%0R?ciEgX<hs0$`wB%M-qchp1g70#d
z8t2r3ov}~UYu-!K_+Bdt!8^92`5g5sN_&;53#Q{c9uC=1{HZy^Nfe#}B|^a^f}wCk
zY0x{tF3WY?tYzSrd)V{cN}g!BNmIN;OM_S-%I|^V-#|_}>G9GMjv2SwMLDa0_GG5g
zW~B+mHopyiW{GSjg|HX&BC18Yk&z(h+%I|6-5)XPr9<)I#=1V9fn4ImX*_V2TkzU}
zpZ)Onh97YZ_GIk+rpgF@^ie<Kmpt@ex1zBeT?4$M+NG36CgbV$F1HMkoeKGjy}UZs
z&)enS!og+<SAmALSd`Zb2?6_sYJMlY%Zu*_8fFTOFMB-dcl!?w4mKQ*LWI-3o~--L
zO+@Ep*o4veccn}o4saR}9|!AS9w#*Lg-V?zWr!RN(VRfGe20rJ+gWJN{Q4WW2m&tn
zi@XNQS2_ab2qbo=jfK4q&Z<`f4r)1k%|qvN)<o8~rdwE{ZkHG5toxFIE_d%eVl>L?
zi^hBPI%D-r#Yw;w9Y~5<-oqv{iz*IF5?#l{r)9V=L6jStaA&~Sm9%G*Mmjzl`_|$k
z(Gt=(2;dU=%7`V+nwOo#>j&>`l1<MPt=2!5j~D0Th{Fk1WpQ#a)5%&>up{kan51`H
z<D9|PdQtuHqGRGRBc6nFUn9`k?R*R<!6hRFH=eP29NYyr?oMsuu_2-W8>yoeJJR+6
z<|Ulzc2Fwfrjd`wI-Ci4dk^LXss%JCk-pDE(b$R3FL(`yW`)q5-7ONl9E*!NucF!$
zH^(WSRX+6Ht4s%*T;RQmXZD-ki^vI=(dhOX3gNl3gM(I@bMCO9&GT)qw8qUZ1Pu#=
z&l4I}3J=eJH;3#N0g+tE(>8*4$3vBM!eoQ}3vQDa2<1)Z@4L+$hYetww<tC10VlnU
ztywtY*?_;a)A3z)a?QsTYlSv1wn>#pD%EeNc`~ch@#JDt_-G=d1ICbhaey`9F+16K
z3*LUO&x<o|X0f(m7dk%7T2^?__LDG{oKVikk#ubPO(ysUR$vcJl$4_2hTduGz~y{r
zOW*eG%KY?<q{gieldS~QTS2!A3z<ks0HxHA<2#p5wjr4p&Tc1sWPEwV>ARJ&yZzar
z_Dr64vQ-3tJrziElDFU!N!1u0fX|R{)?v}#0|J_8tBO<b9};TTV?VTtv@MJColErE
z@vO!KbF7uv?BYh+wEgpOyj!kwBzKgjwplKOIAq+%nB1pC)h=>yEw>H6HxcO>Vxh|F
zV^QAZ6k*{_3C6x8NC>)P>QM2p;nsJ<OJi^Es7hz$UCRq%Afq3T{apKx0icCcFvlF8
zdenunbEZfDPE?VbxjU!OrVX-QqO$F;jmX2;3174`;@=;qT<qSp9KRh`Su_|8-Rt(4
z7Fe_LUn_L5+*aWOKu;t-J&8A&tr6iXT$@1x(&RdV`3QSUVj@bjCJMJS;?{s6l?097
z-tIOMC*s(+MFYS)uHBXX;~W8bwKqUlsk0JQYM#Uc`msf$GmAs~TLRowf_{^Ss=LB)
z|L7#YTqMsGfJ!{-{!RK(Af!n!9q60i9N=}bS#jv4V`@%OX9#(OfaOVoq1WjU5eTl4
zZyFY-eTwCNwR|ICt;oc@KtcX7D-!@&x<a-6O~nkoMJd{S%bJ*R64a-P8!<_3LFQ<u
ze`07oV9VFY0`OYx*-hFJ25Hg{*y`a6viq1Jy6>X}Wj^l>Y9vdLpWJ6~v|HPmT>`*g
zSsoD7>(pil!`7AB__|gYu%B{_fOSmIj(_o2P3MP2Whj$#XxVuSqh?V12@^=(<gb%a
zv=t`zdn^6cW;3REmN+k04C{m#{Lvt{U;zgaH2$VZ>uHW%ld?+$v(E#zlA^FwojQu(
zhle>9DS?><J*|}28z4X;1c-s>Sr`kA-`Z}*$)44bM{{N4LG@xfZna$5<cYMSf1ib9
zjnwJp$^PWpgZ&mqud>X7AhirbBkFbOr=aV3w1|#shcDNBI08KQ!k8+b*&E!mm|nN?
zU-?;JyF$vpP~H+sP*g5_dbnx)E#QWujK$=r<rJG2o-@B!B|SGcWG4^nCAe$IJ0G|K
zF}(V_8M<0<0g~AN14I#kXhsNdM)z)@v)|;>W19Y7%miHNQGmT=_ib)aIe{2*EFY~w
z^|*Jg(F}n4>1O_DozkQ5AEb~=1c3G}8Jhgd%_^7(03-HtdjI90;eeFLZKC}j++Z0n
zV#(Wo<%V22@u)bFs#0(PZ!+?~e_g$rr~-_n#FE}Tp<v<)zzX5DO(_47U=NIpMwVaC
z0lbw(@(e&I-ogZCy#Bl;Fw$fB`9CZoc^ZH`+~eRvxp{(-3)ow*0K@-S^FP+yoQeOP
znrk8ZpFmw}lBWOZnrplN|4|K(2qI;!%|_D-j_*cEpX7EcO~6J8=hmTJpZH-#k+^)?
z<QCpy-HB$AcaNRXevPB#WfMfue>m9Dz>ju_7Q)Z;7miPXxHv!6UNK($>r=ro2(5r0
zzh;p*KoY!BTy^NOGdj;jCu`UiPiRb$sm%6a;u3=}$VcUuYsexMw^t1QSe+bVsqCv;
ziT~OxfpSG+!)$@$F={r_RczyaC}0mLH-`SA$ABcj3POJ4+`~_6I48K-4C%w+bEqG%
zgq3qYkrM&|3>hY-gWKPgIHP%-pEz>Bnuem*3^(icrhEeG(j22OLayv+dNuza_-Ruv
zc5(SZ<9UDRmG7XGKlR!%V12Uw!piHVX_$l?6XX^E8zl|2j2$Gtg71{Q-tCi=9QYFg
z>1KR2Fxfc2EqOAVWNG^9VASf+S1;-d$uF?@cwv}sno^&5MZr^(kP<Gy1b<&*t9pc%
zVBq|;rr~s>b`bou1&9j&QZXsa%M`QPvg)I5*lcKserP}D)^7(OZ>B?O@XZ9rT?Z@@
z42M+u>Q~iF1~b7v69e&zXn0OPs64i^v$H&eRfY7vqxig+4=t(vqa#c<G5i;sCszY#
zKm_;eR^>U)f0oHhoG(ir{nTzid~r{0To{}TcU?6f13#aCQOV@P*>E&N;I|~r+rt;r
zG=XCuZLLJgCN%k~1&@LH$%F4coArV-UI1>v3rKKU+5e#%z<Y7}9WU2z9$R0+c6A;c
zex*bB&#+AFP7_?(_Pwr?dZP`A^mjq>_KCS%#mu___>tkE$P>Nf7%4%>`q_Qfmji|#
z<AdWngX?}P-@a^kIr&UM8gNhZBINt7woZ;^E7nIM++p>8drHHl&yFm0QNTG6eD$DN
z(&YjofCHXxmTzHXYG^E%eLn^Vvlr9oi-TFg@PNum|5E@@va+rv%AX9*2jXMt7%_Gk
zzFUVUKis$KCDow;Yd`$=B8<=a#4{A8=xy@*H3@v48hcI$W8u4gYX@K}j+__ltdI)~
zm{$3A4>Lzx&4cj(KI<zKoyk1_V86NvI~T>8++m;GiSjTwal8Z@v#_`!=Oq!1?G9a)
zjpyr|0hd4_;}|Q%6x+VQ8hz3{TD;vGIpO%Qg+N~{rAM0sW`pZ#I-rBo7h0nx{>yJ?
z8~aW_Gp}8M6%h~15dQ$mC6W7!yWG2#LmC4t=#OxZfYh3S^@1(uV<T6%ED6ImRUX3@
zhO&U>JrlrT8(~H}pZw{*B9G6!R6uj`iDoYB&6o6(%M+915yt?tu*?EAs0~RO&4A@X
z%vTz#-caSbF>MmSD|gJvaI(Gk{-<!p{ggII>S$VZux(9m|9uVRqpD0HjS7Ukh}kSB
zs5cC%hp@DX)cwqDX{VpQ!#8R<!@<Lv>K?<3hv2r?>J^9(@O~|dT>2fQJ~*x~rWUxC
z7bLoN|J$F`TVbc!hYvTs0IFufLt2u(j^`65J!hdr_Z(Vyc<q`2#FhXnSQ5*~&zXG8
zW74mJO*&qyEcWa1XJMY>2BGb5&QS;Lv*n(&9j;Fv!$MlZXdbr3*S?jsdehAZxW;Sv
zkUsH);|q^6Ckq#fq{bcXiSgYqj1Bv&{>_>#=zu{1M`Q1Vu9CTX&zaoo<M_^Z)s?XU
zTT{(ZgP~Ev8M|FqcsM7_LMzsEq;$3uIGp713zgUq>X|y1-5$ZL6^atmPGO6gQB=3K
zGn#``4i*Wjj#-MaT{3|$syv)&7Kk>G6_cX6D1n#E*H>RBzO!KdGLMMX-|`Tpk@@Nz
z?iByiybwQ&7M%mg?}7fy?@3_3GGa}$j?sLf{ZeBqH?NSsI84Qoll^20OER(T3)8c_
zL={(_0)@FBk3R^!5L9Q#fdDyBlT{qC6YEJDNzYaNiPS!t@{+oX{mJbdK|f>B0JB~a
zwLQOp&DNQ$mzlzdaHv9ujJnF5Z$7>91a$Pz!&UaAm~kQFmZ?NSW#wve@0n0~g%qTS
z2hKQ|0%ml>6zQZ*QVZU4?HdohMO`cndof^HMvQ!jIMR6C5S9K`HLX&6X#sK0W?eB1
zVew~Lc}}FrN*0b&^a)CVrE@CuO?bbHun=LqGZo_|Ykz0bVO&luVi|tA+1TivL-xYn
zuRTbBc*FrMS`vQfI#HG5b#@fSs~Rx+G@OOFSK@R{qDseR)f^@va8(W_zRZVa?k-!w
z$Aff{Ady%k>(#Oe!&~(|>q&Kg?Jas|q-}W9J3YM2H2tO1+a5mM(Lx6Z<x7hnx?%T7
zVNuM_VC{`kD67w3igHHpxbtzyEQIqt!piOsfV?-)y6tki)E?9yYT7(ODbDzdsU(8v
z?3XkFyn>voH7mL^^=QE;iWUERF<o75J&)vp27|u1SZ?mDRvFjqCIIUz?v92Qul5TT
zWVN?HG9-QZsto=>?A0r|)fq=bIf+c0>APdXRRS@kBtVV9qMH&<>zA{DaH)Z)cj|iU
z#ktiLp7D4wnp)ib4$lKvx*DSxT>l{lnWyrRa@+oid4_S6>1~T-i-ky++te%7A+)ht
z(4uCy-bKo0T}~^v@Ws?V-`+W~?Uk41;-qK~y5?ULzKhd!{BF)pOXMV1H6O3P<9nB=
z-7EA+n2tDrf|Hv_v(@I7qPliE>u8sp1naFj{!B0mDhEtpiJiNS&Jg^?I*4|b03L&g
zX#RbPN4vj@pY?{l_D%Coc}&+4uDf3|DLz|xyxwwd;+FxnaR21l*-}e}Yu$QAX);H0
zN1vScWo^sCTiLc8mq1s_ma3~Da=+IL_;vy!iI!fkTa}*mm&olJ0RKMXjRwSN4pv8J
zj)O>8jGWF|x3hjkz3W&nA5axt%?C_H3Bj`a+R-+^65sXe#r_s*66Kw*@9<e%dg7`4
zkJvL(-JWtqv_E7HpIf7%0lD}yV21OyFi@K7E#x=H#}!hwl<VtS3*8I$JDO{K-xmA$
zZJhy)?wWn#L=6dcsTe^fmHJnd&XEU7svH4tP*r-%`m>@X0I<`#1#91Uhkyg8U#j{0
z^t{~6EcQES-XeF%(}WdmW0ObyxP~?Op|886_n&pEcTC4tya<Yf&WwumW7oQp%lr68
zVt`Q<EQjE!Nl7Mqvy77NEVNpjUFpR3oSkDEr5ix)7%Uwn`c}6+Lm$n@jt2j|rCoXB
zoRLx!h03zSjNri2JV}A+?f&venG8jcY>waDUNhTpi3+QbwnU!6x~`xmb|HP_-f;&*
z^h<BE(e`831f0?r%nu|~e*M<yUe_#<byAh~Vy6G@9in*YqsE7LE$zHwbN7RmZt!F9
z@3KCL+C#3P<`zIpAJI!V$I$ud7$xJ>KVocuOj>lSvo9-xAt_ex@ZjllG4bCNF0I21
zpQr@}tMEr{--SM7Al|Wa$?eUHA5q?Y)<fSD`_atKoEt!iFR29@r+HuKxIn;WPM?tt
zyuDJDX)dZoqDW>D-9BYi*7YW4%MjfR;l`Cj?+xo0FWOYhwbSD|iacgt09`VE)9>c6
zIDh?8CYGVqH~4YE(be0IGg_|bSFEpaNA0X`orR|xYn(`F^_^tgMyNyK6TGrpm{@TU
zp06TUA3+}{$z%ISo0oWGqTaHTF7Cv(^S6|HoxN5r;~;R*{-YZ4{lwzrlaaOBo=pzm
z0F+_;dO5yow01suIp269c)93!et0=vQRF|ECnDtsI5yR*!xzy&BMt&ld$VEU0RQ(%
zP(Zk=7rJfynMINk?^8R^%+HpGk~_nG<V@rUu!qP=wB?0*4?9=nr?29aBl1PYQEdk`
z3DyF-WI=q@9UWXhPwUCu#{_>pu8vZV3imcqX4Q;PF0)zW#eHLKPNr8thcJtpa`a78
z3=(4;(G0aQJe?Pgba#sl3RfW*uwVFD<cl3=y;@mVZD7NOiet|NNy>z389N=<N}hk~
zyEubh?h;(gD_yKa*XOa1AK~R;No;pco)iRJQcZ4?P3*)so=pW^eoDC~*y#q^o9ud7
z8)7WKn%X#~E8fYc3a-wH!DJ3$DV|S|M}NRM*;Vme1~WpsCCFizyp(NcHfGk5k`cR#
z@TCojeAiQ)<Cz_u4O^c=EEjXfSz7zG@l$y|K+$+OUcuX8flar7#v|QYXQ$BtGmYo^
zn?93jG-qdvms=SZMV03p0Yb-&{tk_orv#Tl0Y}l2+hLQ_=QRQ6MVCj55{K3s$?=~1
zd5vxej$NkWY7AIFHnia}ij#}J(UJ^`+t`>^LQ$3YyVtBMhL4_j22<n(eB-!vpX})@
z!h!sE(Q})!%&n8!`4WcLcZ55P`MB-&&m-&rN6lUkvMI6^qITYFRfFuf*Kd6Bq4r{9
zU$U!@d~0CGsbViVFW@9E;9yNYV0G4jz^_Z+e@otfPQ&PUyXbOXzG3G>k-Lxi=4yi<
zOe1yqWg6bfy?fMm4cqR2O2>Olv{|la#av5>RLw7k$KF};C4U$F3Bv6Ds<5-fV=zL_
zD^Z=unZ=Q<hcyy|WV<*ak#~*Im;b^$gSk&&*pT1Q!kAqHyr8%%^GL8{$PVj8tRPYE
zydqH2V#11J@ai$=dF$r89qG;OjcDT|dCAKfT%*(Ii*3o{He(T2pziaqe)Eg}+K&mS
zna@`9<oWL}662x$KrnpG99AuWg-_Wrwc47V<fHZ~(^N^)N0_d?^2GH+n9Z?`N#<h{
zZ5dEcp(BdTv#&I(3`vwYtW+8g5!it>BlK~}8Ot`9>-2TOFU>}vXW4IIO~JI5nmpXj
zMMk%O{dKgMQAzu}B}iWZNuh<=0N0(xFEI`Qr;g`$w3RLq#y)+0XWeRzSMEr-cHK;#
z@%f75<$=<s0KFALZd={o(^XF_ucL_MXk`H@h6;bvHsN>=TtvY7g2HPkFDXY98^|RG
zJ@G^D;CtX((qS6Dm*h$Jfs-<!u4-`DsM2o+QjkU?{Nnwj`Oa<gp>%=RDcx`bo38At
zJ%fzVoObt-Rs-H|Oha2&W@Eqov4NKhlG;np01YWKWhl7=OYb?hYCM|u{k<1Dxr6TL
zJ#c9C*q=T92honX{0xvnS{e~OE3}ET;Ed&3TwD%%-XbI0mU=mpv=V32=kNaGS<$m?
zu<wi+sIv7XJAdROR$<opAP-%JX%*K*OlAaz`%F5_UVtaN0hMtVgk!&hDb#-da35%Z
zH0YHS_gHsOO;c%_#UGQgKk@~ptAY3&N?wrAoerFb@y0?Fui36L&ac-G=ciJ$Sfj(S
zQz*|!&@DiZY?lvLh)^UQo##JjTef^FnUyE|-rWe~WH<;thebKhJL+lH2l|1Fm<=02
z!{HB5I{;-1$j~3nd@(Di3@ThW?-0?dTro>7n8Cb+7PTseq~4nO{p(0i!ja2{#>GE9
zvZ|6Cwe|QxE_07=Ap5#-ghfrjYwOV&#<p*7DxLdd#8zX~P)f)$UZep~MjxCw4Ru2{
z<yWs~9mG7HnR_Zl_M+vx#)-juf}y0hbA0l-<nAYUahY_tPnp~KvYSMP(B?6Op_6w}
ze!H_26G%d1XM(Z#mVo8AQT_DoP|Xtchx!#^eAlUJhm_c$c^Lu{=&2Pk%kanD5CMd2
z&BYz*0Bt?sj*gTG?8>^zut^+j14{j_2dw0UJNz)fks@F_;?l7XH|wq!;1Ace9{Nqi
zELZk6-PdGJEC*#m4Zpc5@Us6P(BR!xJ>y?-<=1|#7%L&X=+bMJb-P!>3+;BOPtxvj
zNWh?`c5sU|HaJNKcUa%{EVb@!ObpNNi$G4lR-EsJPMFH(BqTU%L-TN{UsW-JvAEKy
z1si4^3nfIyl<&^Qt_WeMP=|rv30KFE3g0pNthND_k#6Ug$l=}>@b~BN7;OC(U!QN|
zwn;rendz1tv*|@0<0E71gkz5d0n)Nr;+yta^)wfQwK~obAug;)$Fp{M?<YdXlr8gR
z0du)uD(e%s{XPhLaZ+2xLxmfieol!EYT2KwJzZB6W_9X$)99w1MN0p;bFfn~Qka47
zwib(DZ`<GmABMYnId|QO0p-j0yDQ;gx5Jb%t$ipLW6VCA1&($H#iJU6DMF2f>?v`8
z)b)qBCXn&$jNP-IXufU2U8AT8Sf4w-{i^!U!Re3@Fxi#i2fVlk0{$lDR=l%#w5Ht@
zNJ=s}PM<^Pgi&wIF#&U)McEAllW)7Gerocy9caQri((Zk!Wpn)`d`*cGF`_JyHxB2
zWO8M6YtYw8Bsi4LJhrI_3IYFAg{kuNLpN2nF%}mff9%&iG#cW_o)7&Yjz{Sn3G*iG
zjZB@fk2HiOwJY&SJtA^>qtfl<(@cE6s(6K*sKeL*(mG3Cv3L8%M&0L@aE!W#%18^F
zsC_rp_V}nrB5}M1tstfgzP%wY?iRgT?EXF!%E;0z20h>${IOdzN-6C8GMnxpLMvSR
zZwzaT2kr7G=rUEiw4TlGCl={q6pbX@#R5{fJh8WHw{0i*T+jSKl~AX`8rjyBCCdHE
z{__>~se*B<QgW*S_vG9FmF%g{BLQlIBOpcY&YoiTj97;mRT~li^tth$*wnAkCWGOp
zwN!<>n(&Q|@mfC&t@{2PYh(krdBjy5#~uYT>9uvZ(Xg0x{C)|I=tm1)9fkv>lr*;K
z5fG2kdaRl8XC5vI$h)Hc`o+nsjIc57UDA;SZ)gXarj88SE-{d5QBwX}UO2*tMmJ9F
zw}$JdHLhbQU04r9hL}p8LivWqX+K&cq5iNBSM#~2H!V`1o@GV*r%y&+_9vuY><k!(
z(a_1J`n3pK8NX__JH|UYs@+Y+C~g3<Q>#cpIp%-4ow%l4*_5I)h2MYiL04I-rW0Th
z1&)*CNq?i2z?cG%B>IbZ`I}tI=e#QBBVkd^cU*-k|I0wxV_yy9O`9bCq4O$(Wa5N|
zo)1_o(oJfmn+6oLkY<1#n9^X`|NB@ttZh{Hx*P_0^Nt*ly8__k*GX6f6FVIH7I83o
zxvAahWXMgCB`t&ur>g&e9_R9=-v!V|ClQD}LPdZ4x{kjC6h&ZYaUkl%PUvm_J=Ziu
z{I|#u3|<`Jx=C6va?xIqfcj=JuqyxRoc^U(nf7mki<Dn%W&dUk#8_Yi`eq0OZl#uW
zCf`&V0&PV|{!Yw(KWyXQ!%ZhdBbaajDWF5>Y^1`!iP@5xfQl)g#mENt_zg`!x#i#1
z8_%dd-d`Q|ko(sZqL5I?|Lh1wMY9|aW%SX1a~lB>)C0v|J2%T+6N0Sk+JJJHL?sOD
z8*X;doQQluwHT-ly$d#n(yiV!$S^^<stygzb^w{Q>io;`wU9{7*?+JG<#4wgzWW<=
z1z2&_6@)}s+JHKn)6fRFjSBvQrvTD~NX4m<67v>5un;`Q0hA+OAbU+Bu+_!gFfc2)
z_<1>=Kw$n2=|G_E4y;?w1yj!^i&>99@h(+PM*hE-44DIqM^)i+Uus5RT?|OrHFIH+
zO)=qkt}Q@Qj8UL?6X-ipx@`+InfY^?YoD4-SqRV)JVJaW7>A`8+Wo6)1;TCUoMjLP
zYXD}U!5QZ;5L59Nh)4^eVhl_i^@qzfddIqAVO6SJm)hCmp>jk<InTdZ`XC?@nFFkX
zAALCFIvwf`MX|Hb8q1P=ZJlKY{{l3B-$2Ba*55FnEe!?Dk`0eH3b>@#^z6g3qZz4g
zPJXcnnz<o4loZO0_&Sk-)Dq0y11<}H=52BYATsFz7svA_sa?p#Om+&%pPJLv<X5+e
zzYj!_{H>_YIvqxBj*5Qruf+=xpXHBbWrz?UFTi=bG2vWvv*Q3u{NDUL%7hXT3i)!F
z3KC%IUstQ^=%cM>jYyS~W<rI~e(Lo7DqPp${wD?P^nq;Co#>1|bx`?M#)pr@Hhy@f
z??v+V3IR9&c4+H=4Nr7|RuS(U%|+eq3$XJOtkLlTt5j<oCmROTj1x4QDpt6HV*g5z
zf=M>UFS^xZt<nk-u&cDeBa8YTrpgcaivKe5&v5b=(e&l2qB7ZEi&i}HVv8TE(@UnZ
zyh(6FvPq;0OPWFsXiHodyPT^UGTHSyP8e~t$KwYlPi{W*kyt9P4c6<-j%MTmCsl9H
z1+9Xentvn5R{&Jf4JYd`2yIJh<jf{Y%|{(WtZ_w}puvK_^~Zm|GKW&%2!{P_NQ|`%
z$QgV-Jcuw6d|Ga?7wAxoj~9v>);{^*-tqFMZSLK_@arqdxWJ&`2@GUl*<F?I-*!4j
z4pL3ag~Qz6!Ez)KD!l(yX-hSEd=kF%pX_1+XdJK<%l*uoO#_s#Fy{aMf3sKr|L4z0
zB`SCN?d|gC$mK5?)Hpi|_KI8oRrn_p0>MR$*sa5(?b$OZSjB7=-+Wva^m7dmH|&C;
zapJ=p<v|Nc!Z3q}HhzuZlB=YfilP#gGqc<#!W()~eoJvqFNTUJM)SrB6^~;Of)wxt
zWRQTK9Clv^ugj!3gKG)y=(GG~ET911#sC345_o&AzJZuw-m_t)^59-KH*i77+ncU5
z?%^mRFDD!PN>)N#^)p~a5kRGYmz$R#%KfmL(<-V!t33{=Eia5Q5kj2^ZU5q?cH7V4
zU@FWv+}HY&F$N>X0cco3`h>|vPC2r%zy0=Haxr-cDF3Rs=1M(4DwqPb=mZ>GL4x07
zwSn#hv+j)*H>CUuMF|fsh@M}uZwH*0vWY5@hW|Pnh+@AoC0yn)(+64xb!ZlnM2|S<
z-Sn}MLUSQ{yU4uws8nXwNd^?&b2<_~5>fNdp&&=YPAuW;#?Az{4&e`^{nuWJl!V-F
z-3G80H8VOVt`YLlD(`NTm;zeX*gQYbDap@%;-|pe*V2Fer?eiUjKgkMQb_<Emg*$5
z+lJux|Dx*wew#eU{%DKY;3<@94LXEGsN6^WZ~t=$$&culUuEL)ukavqBA?9Ov{C?C
zQP2gvaiN8W7=TJO{T|rewA={9I8ZR@XoF45q;%Q)P?D0~G&(ZD!?^=v<BzchUEoCU
zuf4bduql|FV&7qQ2HHA2c$P2<bBsjL-}pPPo47=*XyKM${ySt~Ca&&U$-7{rh`;^6
z_6_KO?*M~+h!7yX6ROKg`Bgt(?w=1+m)gW-YlRIz*l|C8`ft=81VN4e3QQwlZ6AGe
zT3SfRr*1D_br1uSH<;)D*VN|)8nU=w3u%6HBCeRmjmBzh1CsLO7;;v+@r`I97DRw|
z1t10ob^qyn6Av8wAZz6KMA`g}5mqqq!q95yht)mXzww>`M>zp-3_VUK;%|=D|HIQ)
zMzs;G?P5h*w79zy+})*Ead-FP?i6>5YjJleRwTF<m*5iIr8qY|-#K@!{DMhl&7PTe
z@BKbjF9ul;6VB^||Ig&4_Z(7v&m1>FF8>=K?nuaYLixwP{(mB&0c0(_e&(yk{QoNy
z2Bd;R#Ko2WyUI>^(V6?`2&1(;zw6OA*zFD93;*GYvwM)!g^?|@yr3EoTTB0H*(_mF
z<LmA^`Q^@*|1UP5i;k08JVE4njk$v3e^@faucG}C3`v>+XKHAb1tQsFLZjvjMhp41
zR#<7xr_G^~3U^T~ZF~HOyPMz&|I}sn3gP-El=B*Yl}ZYDuc)zV{xLSUx9+)_i|UJ$
zZ!=^v5yd*e+;!P6aM9&znRLfS<`rgXI|;#0FLu;GPm;fglN1QMx!%`Yr!D-hJ>3<5
zLuB#iJ@0Rqfe;*-RM6|2yZez2WR4DEIk2B8{|7)%{LowMHL#mXqLk5G-ScO>6OO&n
zbLzg!^F7b3sudbz;xuL8KK_Rnr!lWyW&$dYCiJJ_T+TvCUyR3E2&f{z4yGG;=uC2U
ze}tJ9ezxz({rjwdqtC?l%{}IW4gJ5nK=`G1yeP(v=mh65fo_z2nc+8~fzMG1Jsgk4
zQOHG1HL8-jeZ4q%!);DcUraCTp*7uPo12^JVgsZ*OciRCFm8`{g<I4aQdN6)sT#>)
z%CXK3nT`cy3rK|9$+|;{?5`UU?SWrFjoK6Y2s7cDyKW;$F0~;-aaR*AWC$<Em52Cp
z${gppV^RUp==Y$_HxK66##?bl)zJo;FP2|6@}}B0m~b6WC{_%0C*9MiQS*?UcEkyY
zC$%kvGR%SlHszPoQhV<)Mu1j2GJo&M8>L?VJ+7Ts^O~RuvHn%jJ^g^k{nI+%^i;z^
z7(L2X=t}GPUzfu^OT<~#<l~8M)#QWp`3qUyEbmN22j^HsE|>K~L#+b#4*yJWf>jV9
zKc>ge+x&r1;w4U__B$@xpLiybFw(SiO=nHYsRx3#;jc)^UvWLK2MQ_we1w>H2y0D#
zBawH;6S?e#ovSVS&iHokgfWEScRR0dN<DU+PUed<fOk4Cn=hUCDr5X(FhFYeXCRgK
z;uYUA1wNcMOtHtGJ7^Ly)1EcNBFcwxl@&v#1Yk6xuZP;|Us5!kVyn3=(WI?KOeu9X
zt)%ZZ63LVy1h~9(k>7#=K?<iui149#X4R{IFZw?Cm<L<xO2VK(UMcuQt$MP7M)U~h
zb7P%ItDS2zs$brWQ$h+)`h>QpgRqRsY@=XiCKZmkfiGDWA)a)S9o^cpUe#I+3%qP#
zrjf=S{o}-ni028!mhEUe!+-1rWv!Nyx#)R;n~asF%*-I#O6GD)OV1b@oS#eswZET^
zrK#`^VB6OWWMsY?SVRhC5?2LbRu#=RJJtvxPLwleNn>!kEH^e#{qmc@;X@O;{kqPj
zm6dAglSToxr)pEgl)4x`Y{;~&Ic$Y`%@n|}kpew;Omv?q7vTRAR|GYsk~ScPYcL>N
z^%{d|4G|aavS94AqmCbHPPh;Yv2uTG6<Lhmg0kVvXLW4fPfK(R8%F**>^dCGdc`_G
z$W#0ouk77}3hU?n5OV0s0EYbA0K<rrr{<zmPiU>d2dT*D9vdCZPjm4|#U6}~!J-E4
zObZ=g#iif@D6@NOWU51FKj^Nw7+J(nV;W8Vv&d2e{Inkq>9$%J+(8g!dk<7I8fiQX
z_bHnrX=+RDsyT&Ceh@1-R~Swrg!jg{T1ml)8bW{>??`>j8a=Vlsq^~4r?9g=tPSW7
zOFmf7nm!%Ecs?vjP!fcxvhXAjSu*qm1cEFl#B!#~OAg#d=S5R?N1VKN^K@E$P$8ZF
z1dT97WMs3_c^fra-;<~wpLiUVdIJw#jA&qf$Umo=0UMr|w$7-LEBqSAeCIL^8Tz26
zw$6?ZdCs*&X{n`keCg^c$$8{M(ypuJbCxVo_XQ=jcmZbwpl*qU8OY|NJ8VXH2nm)3
z*}Z;%ujR=~FfkCqx8V$jD_I2;l08n~Ra3VO1Dh#kn(@5us(VDOFc=&%y(H(_Pff3F
zs`j{35Thv8o68i*nz53xjGk)fs}I<?FO8lfgT+vVmPtT+uJ)#DBxY`yD0Kl8ib)@Q
z5{C@E_fs*iTB|ZLLv4{!qNx)>WyqD|hUa{s>1y@RI7pAiw<4RDn^&JtJ(29i;%U4n
zgfh%wHGMu^KZn0pwc#gT2C4IR(6@N%xju;X$-PU)0$)txLt2zx|F}<P)J{fSaLb(J
zcZ*gGEpq2?gSGVs*!q4EMM!5mToED5VT{pgmG2D10hJ{E%7T4Rfl6j7pWwrW(^4B5
z!8;=+xNPW9B@|w7Ft%CqQ|@2C%s}unIkkG{+DZ&nGj$nkPHvdPTGWzw5V9~PCwGR-
z#9j(84PIWkfSBX6F0^eWrJ$trz*iMa!UNgzMk%VYLIHfk)Fb~8INmpU5(F)mA||dO
zljMMr(LM!B!1t6W+Epe{Ze%=Sgf`7bg2<7`=K(X>KbKG;_(-TApT*(d4BWEe%U@!#
z`U=SJY%xZfwu!K2wEYVCj<>lRn(D1$mTj%JqvIr41Q@01Gu<Cl!bTBb$|jWG$Rif_
zhu@l`e%h`DK>?8yJh~xRkNv0kYP(>#8C9pwgz_J)G7+=5%^^9r$`wO+pV~9wu}pN~
ziA!L%21o?m4!<Ur8IuTOnZ)?P)7CD37aQJId$dC43Wf$!BEY`^tycHeWTy<LXpa62
zltMOR-ScWh?nF*G;N8d_$_VQ`LEaI<h)H>Bd4`MOgUA{+ZnYr|Edy)>Zed*EiOXJS
zB5aDK>lh}~ijX>=Q`1>;UE#D}G*k_vkGYyli)?oTg7IR*uT~563v3+HsF)uKQO(|V
zSU4-473T_>B6SS%jkWR)&{gj~L-j?ZNMpcQo})^#r6^Trjpq6tT2w`m1IZrv<rfk0
z2@l(uG$@M^RTNKkDvQV>mrdP1JdXS%_kNAf<bQ5f)z!=@{a%H4oD|;&e26W#mf~ck
z_-POsRZq25X+Y65ZG<SfBKWJ(ie4%16h(w=a*Dc4<s)&5;-Q)oFr4+6ZAvB!r-mlZ
z*?_)6A|%lk$j2Yak&}|&Ntai`TCU0>ZPtl+xe~&fG!F#O<_{&sADmY6{^<vZS*o{?
zpH7yS7tY2fsO0px&XgiF8Rv>#j?NIQ!$F6;k+9hGd<%ik+j)JvOys~Ot!S8n*Dj4U
zb8_G!y)mXW&{<F|wnLk(ZTBhmfB1^wuNddg&D7MvPb{S~BuCX@wIqyf)1(7gsIlB>
z<s|GDi!%?4j7urN5mou^)q9V+`7o3Q+;b?GFbXG2$6wwF&CU@|EMt=Nm$P9n&V9@O
zo|vN$71!8e3U;)t8ZiM^c9xdV!&KP|TcVqN66vK{z4y1wV9P9>u3R2LHo!jM=<n6z
z&OBbO|5=hzg0LzsoR%aZ=<bx2WIaEa85BRIIhR(=$U#5Yoc-uGz!z|h!$`AYlj36b
zyVk5ox@8uU9mlHnsoUtJkUYoJ?1I4*C<50gE$s3|9-tjDNtqy+EP>iEOZVLroGsU)
zoG*mwH3H9miVyI9EA7Bj-;O3vVyBacHsG_yN6uKNeDrcz%O?oV*x&Hk<3{DlffC8t
zOVYEOn5fTO)LG-o2soxIQFpK`NtX{@o{-9hw+w4;&_pog#|_0(y89aa@E0<fW6}rU
zk%&&IC?3Gjz6>Xhv!%^6@^q%U70rbLWZWM1mJtk)Ggd=ex_K*vW)G_oErWa1#kw)1
zk;~k~^&0uEq=Y;(ArQiE{l6v5V6stIVHZA2un^1~tQs~*enXjfS-o#Dqp@mo!cBqH
z1SdVmHtBMD6S?Tzp%{ts^zUcoCo0w*6X9HKE;Zzk@QTE`Ek2<1N=^b|kwF?_(`c%d
zjQkwQ`<!8Hn7Pf8hB7=pwi0{XK`RXqt<PMKpeDvIYmphRGyFwwbpA#YzJ1{8kF^%I
zL<1wF`!X$BY{#M;)|%dgmCF6p9k5p#BE8HtvNq^762!M}6+pv|+0<OkfyB;sQ>30)
zw+;BC!-fUafX9qFt~uWsvkAzF@gTv%a>6a{c+pI>6W5tB{Cw8o@>DphAcLLio%`_^
z&n`jX#T-C1RpHz|pPkg^n^+m@N33GgqfG$}^2pU@Q2p^_It6I?32|Tdt=J_%@H@@m
zUg=gp-KR%wdf1s_8`|+xD&oyQeBUpz3hYM`HXE|y7K3L~OT-Vv&13l%*_N>+yM$!w
zp)d%u4x}2%>2Jmp9-m5)D<(XM>WWlQ%6)a6EK*?*UUcfP5iQ?S!|h9nPiXhlh0#AV
zU^^NnGB_F2@zq7!0q6xggC6@|XHi{P_&8Z5zT<^P;5aj)Wl}BQ?{szAzwbtpC}=q(
zpRSJURCZGO!0QadzoL#J^L}0kx<XG4!F`|MXSX70#}xQPX3v|mqT_tKkFg%fDgs`n
zL72|WkFsgD6Z;KS>`(Jqp2lS<`m<1H!YT(<v;x(rSd!T6EE%lFXXoNwa#T{6<!_(6
zb4t>ZMIXTIB8h57rH94G8uOh$w%i*jAnQEp(EVRK<?*nDOGF@hXFGAC8%!3ADQvi<
z-Q!nL6$2vB1aY;*-ruH7$Edgv1%x{Vz9#iH=o>O<N#tJ^V?YrxRV^$kT4sLEm&EDC
zk!n&xu^r4LnI!1|06Rd)A;79J9*^cJN3(J&`z|cEMVT=JK9u^GqXq(6oW=MRKCxCd
zhqm!qbm@0CK+l<p6dzym73m>A!`KIsA*dzhM~d{p|BM1-yc-$oLOthlLEo>zAcq~O
z^GMg#+VFSIs<+M_I~BOyJ3hF`GLJ8<<uu2i4IFGd6E0J^z}?5TEJul<L_c}O%D-Dv
zl1MB4n&evVo;O{Yq<{#zTmlE@V--xerzIGVjT<c~QwUjT0=iG|KhDv0#4RwDS`sa)
z5^V@h4-)C-2baThDXw(owu9&3TEh=)|A@rpr))~F{LY9f{e440TX1}=-g2;*BTW!G
z5&X^H1#lBAVPK!hp;c&551xktyL1W<U2c1$9yToF(?ZBkBvyO%RnBcj1jsoV+%RSP
zXheqUJc@JXtan)iGD7y=T~TrcGts;*M_6G7s7>cn(Y}{<R@+Ss*RkaB)zWe8Z2~I8
z@0{bA=--m#vcTq)*EaNOjII|0Kw9v|Dy6RzR*Zvl&NUC~;@nuX`=9Qms)&|<8aBD5
zf#?szcrpaT+V(1#YP6fJC!vX-BzxET+L*b!EU=yJcjFXp^}8kPOtB{}_$Y@x2Qt=x
zurcqL@_@7`tGwe8i>MBw!CJ)7qbQa}|Cc$@DQy#cx*cp<XVV~$4S&H&J?<`(KT~Kl
zNk&dkl^>#LMHVj(Gus`b_=Pe4u!T{`uJ-#!ctfnVlIDKi8qdqa3~ok}4|`Jv)+b12
zxKBQRh;3vW*(O?6f#M4ou_0|=(P4{obHmw;nZ-_l9cPUl;-y36&Hp;JB{xx=>#ri8
zq}1lMylcOBDcC!#K6|z+WLx*RGP^uD{3g`+xAjj#L!z9ln@|KSEX^9b$>Psne>-mL
zF(8u{<0%d5MM{-I*%ZG*sWn$T|8dNt4@-;#J|_ZzP=<vs$Nz>qa8bTPiZE&KCElXV
zS(69Qml?il=H$;`w<-||umt9CvTb#J&YYuCasO-+GOd%UW{mEb?Y@T&Xfgppk$Fc~
zcBfzza#f^ja(=X=zqacOU+M5KCNB#=kkgO^xvr#w73{&RS6V^HyB-HqU3hKByj9Fr
zbc;dHTDdaJ(;_Ypd+F%X;DOMjsU6k?%I+B*6?%iTVKSE*VRsOQ21)?)DpIhqG!cMU
z@nl)!B7`j9sn8^+Kk_BIJWKH;DPyl{-*DDBaR^!B-Gz709y8R0WeU(41?T7Emf1bD
zH;92v=qlzu+4VKw2iSOimOpeB!_`$!kYvFZ?i!GJ)I-pGz+~8&==e-!3(S0?#UVef
zZeE1MP^A!apEW9IJeZGnyX#J*$lwgH&&_@At8Zw-srIC>3LBVyY*AtGp<>^jrUJ2M
zoS0E$RjDiQ@_P|r&rnvA7UvIbWIo!||AjN5l1Q_xlB8r9P&|9>)@lnvP|D%zZ$;qE
zC#oxJrNRgL?)2_HO9)Z)n|NC7XAJOGjzmMA2`ukZ&O(C>50nD`uV3X!TB!(9<KG$r
zFs%`c60D!7<LnYRvx0PBDu`!TPnH+zt4ZfLV50-5knh=HPN4P96rFhffygU86XV_{
z@sx2~Wyjr0h84AyV)>kE3RCQB;wlMxsNk+s-nqa$_wpZVW_Q4@#LegDurS3byW%2y
zGvZJA)i9-PIpHItcY(9Zoacz!Ik{zLT~Rf8+XX7P*bf=FCQThtNXI+T4wC)mUjRtl
zg=4C{qj>ef4nt_Jwd`dU3;UUTS`;+<tG(^fo`gk%DdfwHJcxV8FfB_^$6xy_3;Pdi
zJ!`wwwIbm5__PMS;8C4F>*cgT%834MY+_<$eQn%eVk9CGS3)&Ed;60<8h$J=k1R#7
z{D#%u6X#Akral3+a(zHuB59(}Tj+`5qdlT9<FRt~!wLm*mZn~G;B^HX=g08?@2>h7
z<73WLvBh%D-1ts<iY`PFeHHr5I}?o6jJ|miXac?SLiKyu;kEJk`2Y{9Tm^a7u)@%C
zYTrtVT+Kf(HUGT)E!*<4h7B`DGI-hnOr=Vw+`?d$Nv76I_3si>CcIRRO1%%}@x6pg
zI2`!~>ND%CU)ZLHDqv{C#_YwDw9ztn1PPRk6#`Z0IX*Q7s*9CBOt^lA-#f^RO_=}g
z6FG{=L17}?AD&5UJu@p^F_aS%c-k<!)r6Ia$#cqP=~3#zeQJks_#H_1sXP{)<IBuO
zK|~6ZY|?6N)Sc4!fC(~Mml)K6HuJ0IPhJyAqdz)uXtr6(sG+pa<uf1C9AGfWr4TSk
zGOIc-;^xS^^LMhptiTX!xQYq(5Gd}pAHVP-Q&wW}vqoWLv@G55t2apvkeVUaJMXo|
z7$+Ry8MHLj%Lq{=o-*n0(@`KZd)y>Fqf=1bTVlt-IrQm~bQQ1kmu7R<#Ke=yf+=*h
z(15qSH`guF3}YSV5O38EyLwK}hyFD2w9$w}3NKWkV4+O_%I|wb16XZDD>TcBA)Yq=
zl&@6rjvw#40&!{L@=(64T!e}>6>^dPo4{ng(Sc$0C;T4=>8iHBS^OSJxS`3AId)4a
z3qFn*ZJs7KP!0&o;-GhhvkSY)!!=u>$z}b{_S&$}E6een3x{lUuQ^!g#u%??VVQzB
zkgy~&k(&mji{ZDNdLp+Vr^wNu`q5{8T+>rUE4RW-i?UzW43Cqd8uhuD@B1zX;HEm0
zPhL)P8Z0i}i9Ih)1y#MkW!+>awY~5KKZl4OIZAg)zpUff;m9VVo=QLAmcUAVi5D3u
zFNbJvE?ysA6|3x{Ia`ED?6h$1LWZBM>}la<ne*1xen617jf`jUt&I%cZk$BpV$8Rw
z1gznLa{~5B-h&u14}@w4W(xAtp-Pb%_P^K7GPkn6S%vCFbE7}8nq-t>_r9t;KXE-0
z6OtUih}!=-srOvMfhcAH?XJ6D^B>ejI(hGx@3pDtP-N_14d&fsg`1?OckwwET{2ux
z+(c<Oy!^kC<xVRo<UBR0D;S2Q^Kpp@`|+kM7_(+*evCcM^2!>GVOa<in6!zlXsTtE
zGT3f+5OE4~KqKZOZv;(V&^0bIb3&I<z@wGrgzJ`^;Ok=U2e4Mu@oC$KO<;2*)jP-2
zDs_ZU?XZv#&@Q$6G0*VEyD1I1uQR?#xa^q7(#U7~tym+wd{JZ)x4H_6vdNVy<E%}R
zl8wu^$~|nKG+|qv15@~XjF6O-jqA9+w1?YdCETK17fXyoO7sx`2iu&Ls3RO?;GJx9
zIGub`Qupq?b~Z#?bwUaLPm_9f=oDi6Sn{^C;+^A^QOvtp-*QmbjX>HYqQTmuCY7@Q
zb|2SAHwtua%!rVV^V*#t5MGf2UQH~rW<RinjNaTTSVL#lTXB<Ww)>5!65Y7NC6a*S
z5_hmN@wW#oJ<NyZyMDwUmVY;xxx~xoEVhaZ{mujM>Yrl#n&Y`rs)L%APu0ikO7vL+
z)nzs|Us$T~W2}{j=EE@GkS|fbkPVNnWZ2x+LADG!8?ohFbR9)c;APAGAlUG@UvAp0
zMswJG;iY5t7j0u!CP{AZzeYDfD5C@8fI#n$<{x$X6J+vNDRefxAk)p_1C;RS#*M+x
zH$E9W{oX~o#^U*H(e?Rl+bXsT+s>9_Rsz3}5;UTvPmWVd_v1m*Qm-OY@-D&ToLbng
zuPiYh(*#LDV%YS2S}{+52Vv5LLY=$}?N3#-fXev^)iGtJu<NE8e=B6O?;u(@y?0@D
zaiml9U~TVc3*=k;9^Qd0I!0--tslxtr#nSfb=_z&!8T>rUp;P*I<*b=oi==BD%`bo
z&oR5W8UL+DF|^kqpwFkz#_j;8-UDHg)>g`Sc%Flno5{>{QGY*^g=W_hK%PcE&%8m?
zv{iWH_S`wYA}pq!a&P*HqdzW46v-YBnmNZAHelEkxr`b4j|1UieG4+rp40FovV3u_
zGP#@ExvscwOu=DfcbB&@VAUAimu4#z(O0@W6otGO&?|U|+jlK7o_D>}v-vA)=u@ya
z2ZSgb#qC&?&~{rBcu9zB63UH+cteu7KMOwQj&ZmxT6%awMkC>jPnurB<4$!XwJrix
zKZ(Kplh51#fBC#U?Eh)?9f5QWDE~u*?1doh%tg<Je-TOlLD!85Ata>MpSTX8|HEzc
zlp#S<cLw&b{~zmthiq6J4y8c<$1s5qi54L*w!?oe{=eX6>%R~lLZ2D#|AC$LcW^KG
zRW%o;g#YaMAlxau%w9+g5QL0&^}_ac{f;>tpG!ve8GrGptf4#PeTw(Bc}`ix9})?2
z20G|a-SH;>X>IrU3KGTie<y{w)oTh|zg$7&Cj#N3jGt@HUW$VR=(m-KgoZX#-W$#Y
zc5j=e1a~JmzB-plO~t=!G@m^{)j$3hS*6C5t?{^BzUux}>g9!a*ZMxealhm6X^dfY
z=t438Gi7r(hIeNP+iK|c5{MQt2{B(7cbc7SUV^yr&?bh~9~2n)K=Bi$Lp9;JY7NxS
zh{Uw_A`3D<a@7&Hdpw*B$A2Skb~SL=&<yhtc)2UGIun3BYHj-D6y54AGj)CTh<)?V
zpZg{G@J0f>r0=S@%%K%<C_$<lpm5_Gn{PI~c|X)wvB|s9O3GK7`FF#YMWlvUWRFOs
zvb$YGL|KBrqr;3&l@)<p<P9Rx^E6&tG<eDJ{`fb7#K+n-JL+koZ_O2cV{NFG^BQ}!
zg@D5o_!9(CYv9eE<-B&%8GAHLy2E8`2tZG5MxYXRyuUr)*m>TKM&)xnK?Itb96W4_
z98SL<!GiK!S>GTMw}0ecVumu49vV^sNL8rby{_5X>I)_8j&GzXN0ER5DQ+Fk>;?ur
zJU$us9j|8pJB?Ldiy0atgx$we>(S3a0S+g0%%EE;e6=S2-PH)uvfeE@F(*ARZ_G^i
zp0^`l{cCj(9ks?Q{p_}OZdH@FxwxozTY`eCg$V7+KcM*U#_`m440S3wsEqR?pMKAt
z#&SDrS(27u?!KLk%Zt=pKZ<#@3O;M6)JGHQ(7yUEPrm;4(q2a@<hsfCJk9&KcI0Re
z!6y$77MdFkH6sZUnHm^?k~+908Sm|RyuF#0*eE3cjf}>(TZo%|E@6B5Cm8Fja?U9f
zh>GtogDKw90mPtQ3Ca+bxD6N27(+C+TLU4~e40SZK#TMpe*$K5y3tunBLBGgNDgZM
zc4Fzb@B|EKAQ3%gnpD8!oX_fP#J~{}ng{HiSb@txNMg5%(3ePAII+f?XE~{sa!w~)
zT5TLDr6Td(OUk*mf#Ja@1hGGC1^G}$aC&w*9JUzmSsKt3OSzGD;{c@EX4+c<Q-c19
z=y;I6$=$91r&<06hklTyAbLNwlli@E&z$P`-c%CZiYtw1#K<QvbT_Z&7kBa~OCwc(
zAQ<OAO`$Fgz@lony&+9PN6W*&8MqM#YTk=X9nRyO^R2Y86eNzOB2q-T6EMk<Sz8Wq
zJ4xW2L`Die<@U^kVw%Zsizh*R-%Cs+I7TPzc$m5rF&!{yVGG{zilk3NU1h>%()Qmh
zuzvP?&xXXKPIEeJh;?c&{V~*4EP2iDf-1qYTsIJ5nMDk(Kia7bDtr9t5iN-<6r<p}
zFk&QiLZG4W!iyVBMDpu+a|!drz{m0|OBg5&5|=0h$fMb;6OlYVHPjJ%2PhWqh%JZ&
zo<HtBE9dwxrd4GDY)Hx`cpIGETJlRJ8S4j^ZJB5jM>PcR7wx>w*|!^MI308%J678^
z)QWfGeNm6JJt#1ejHg%p>C<yo6@y@{)_hjCuFCBxBUk6p<t6XP7j4EULk?Kbx-AJ7
zR8PkIK657e6xpsS0a9%}hz5@cCJ6jz9A(`%O2;;AjE`D=Xi5$a?K%yl2#M>M+HGEc
zR^=5`wx`Mb@lga5rThsJsaN9O!psz9LSPlmYD}<=0V_(ka4zgoV_H;;<uDT^WT!L6
z_Sv1Bw65!VEUI8@g}1s;_HTW#?OLcdi2b67N)VW2n`cEEEP-01lpnV4tlu2L|A7`2
zsc;gOBS-BXf{jPH`HF*lPiDPaOPsgN0~9BujCU}C+dPJIb2^Q3x{Er_!Aps@q*B5L
zn!YszR#{?FeO+h4eorN4wT8y!RtDMGyncIhZ7DT+FVn<)(LSK_vM-*mJQNwIm06?Y
zBhDlExoT2E<3onOzZgO?4~QP)46sZb2lXiPRreB=4cu|>_gDqYOJb-qia?6ShLp16
ziur5dsW$hP{Fv^^JH$AdB5c73I|&98O*#2ASyD8#Z)<vXqZ6|AcBT@%CVz&)*+`Ls
zxVg)vg)`|9Kp!Y0-uC^Be8c=)B29ELY|XQO;kL+dtgNn5JcTTB9rt6ymTmyj^UPvf
zfIuiG$&p%4Lz@t;&>ufvFA$D}rD;es|70v@H={ZQ6)F<~&gfuDY=GgEs7`pCUCxrq
zjI;Ijfw4+9v2j7Yo2^1-bwcxOG30DX%AnDK9F1m2Q>nO#cEoQ?f0oWDVe*NIm&%>p
zNskCjtKN=q!%4d}IVjhK=A9RKk3l5dY!O_oT<Z2>$+#hxPM8(<vEF4;gsNoIa5*`=
zyX@Ib=E+v{s3SuwNkwfW5r^1Qi+(cG6bk&+6`Y4DY6s`qf(I;?ISl7rH&fyM?+HvW
zQka#~bW`Rk5;dkFWFQT5nz%7=^CSgr+@tpXmZUF{wAqRtpSoEgisMXT_($^&`y7nN
z5loXzd}1*p^S#q!^Z_>^Awu_sOT?(sg~g;$vG6Y?aoz29rXj4AOfkGCLEE>9p{zpl
z6a~F`HQ{1OeM;~*nw$-zEp~XYXSEgGd^Mve*T@<CP`oaD0nn*<ARxSB`ycTOvk4U=
z1Xhw#lo>aWlB6r1@2yI_=!EE!@EoQ@t_I!gp*~ExXN=2tg8T(Ql8n-1affh?9jkrY
z_ndD^fOej$s?7Fu$v_xqV{kz<SfZfygSAa!+~hHP8O|ug)0xyD&6GPFvIIsv!H9tF
zUM!H&J0^+|+U-JhKLwSAR@+Hnc2PR`*G4OukNAK{0>e!TL0qG2$q+8YOtn$j`LEsh
z92nkXUaZ}RJy8o?<#&DT$(69jZU*ww8eY=N^cTS`zWN)%VA7mjR<Lko!8{CYR4lEM
zu0wv3ayh;T*JoAE=$_MPync;6$t)z!S7rJ63_=(?Q;hQ^B*z!(R>|C<y{3h5<1|_q
z59mt6hf>PIIIkdDy<a;MlNB*>37j9DHJ|CKikM6eC_nfOn0R3RX?&&&iCFtiZ5H~#
zW(-8q>u{h&%-*65Tn+lk?*_ZkADcnT9oN0W>1PUG>k&6TNuC^=uXMWG<)P>RQOA#F
z4DEzTBy5b*+&EjN6shC%2`3my+Y4tXSOtF{WH=2~jYo+d=rzXePV1hQ@o2cm1W=Fg
z&n^qN7LiG@bFXIT);L!$;NeN#tq^<c2bE#z@tWJ$V*uZ$H$Wf8J=8t(%BI>o4h~@r
zqI!3Hza_A`;K8?1n<JxAe)EOH45k)A?k7c=$-~=DK%9o<eJUvfdfYygfF4W)%?S7K
zJPR7wTzX__3IUdDh%~Fqi1R1_#F%h=5FRKJ^-pTpIp5zrSK9!cD%*w1HPV(7JFNxb
zcVaCWopuhb+Pm?!Ogk&^21pB__^41t*FMCLsL&Emtrg~LMybEnkd?ZT0|jD;<@juR
zvsK1}_BnB)R^K)ywCN6P^|Y*<MTB6UA<=>->!U_LDLyUj>I0GN*{xH0I~R0!7L9rX
zQo3z<3;tAY7c~C?M4OMlyGH1-CfuEtj4v5AZH^wuP2VbH|0TY4&Lr&nuDCSRSBuqC
z_$$c&65K!41>G|xHyw1`ZvUe(|5jLk`W)c=I!EX;_6QRzmpM_cV6Kn(KQ91Rrga&X
zkI@8{BHpPp>WW0f^x3idZEG$u<JGzrur{1w1kmwKg`2nHNCVN49x5M2y3Ov)4Ld%d
zf1<`!(rI|=N@yLB9gnV0>rD)Gy@Z6Ye|HqxwZWGg`eSE8#c9u4t*8gub<(VjGo)cv
zo25v9OE(#{aLM%g#qc#S&N!aK^BqYAY@V@@Im#B}#7rfR?CYMbsiJF6;t<uM%uEo}
zMEoER)a3|PdoMJfhgM;Z>)L=vlp$`^KSY0x8nLQ`$=uu5T`Invz?nF3xsOePDyS~Z
zoQrOe*g=d7-&+A8YXiI(_i1yJ8PW9&{M8a(<!lbN*xTrO)e5`T&CaHyxygs7TCJEJ
zA}SRpqHLy`=fGMtyGCw~Py;Pr4oo9%qV+D!-c6Ab!TyQU(BBwPYX|kQ%-d!R$Eu-O
z<~i7{f4094^gvXCUOarZvR^JVREFk$_3p#3{T&;)mI`Kq=XE4**Ox;}+`t^@aulYQ
zkD-L_H^Zr}y%NSx`8LzYlt%p6yJzo=YhceRB}6|{C9Eq+zj(R!amjT-WA_8T0~o7l
zNzcAJZv(cAWDq!bdw4;#<E~=HKD&0To!Zcd_tu@HcZABSnJEG98{5XD0xHkWR>P#*
zI8a|NxlFT335AL8r_NrzZ>l`<*<q^ZKWPm45{QE|ut<0@SM9mO6s(}$pxOurcwyoy
zZvHS-CBRLh#?F0L-Q>_0jg8$$=(hAA+^Q32s*3*IYO>|=X!`b=&cDq_iJQZTIQkW!
zX?Qv|dgv`wLTl`{T`#{*iJ`a3D8;3(4utYIN>#WRz?T8U-BE(`3N_~c40r8_&VEgK
zGXJ5G54HXUB`P$36U?t_uKLNb0v7}GS7tz(sB<sb>@g!vjLFEiuQ=2cJ=%20I;Lhg
zecxrczFf2t3k0hQMae|QdFS!kwhYv>kf)9fH~?x2m>LAA2VkQq<+oBJyS3GS$Whra
zWoGKHdX32Lw&_A)jAfG=2gaDz@T!G>I}*e}=^cy4PCqhwYSPxfr8mP#*G~-^+Ex67
zc;_%nT{q9qQbO~UsyCo9>((Rs$)UzuS!3w)0P1j)7w{4fW|0?QX{%NiLZE5EWLng(
zRh!fLJ{kG}so?Ul%47P>-PYw;LBJulFP2Ssct~o*1c;1__gnp*OK!@Ckm2n1l?l4%
zivu26>2aaMY^T&Hn?7|D14+?@VRK=pd6+~N+Gk7mA4b@v3HSQQfI((~@k8`T&wQFv
z`Zy{vB9MM$++o^!70Z{HZJOi3+dGp;e9mMssBpS16j+qqc)A2y=Notl(><~@pknQk
z?ShpKIl~n74;+F6_0lXN>IoC}n5f^7lp=Kmgg=OLIoj=Dn7<Sha`H!Ix}OH_zq*eO
zF!CJh*O@D{GoP@d6p^pc^L|xa8<K2k;>>>MxEEK;=1*IMTJbZR`358vE;k)H_*&Nk
z_DdIbaWBo~uFRZ?)MH!>Iy^G1agD<m?Q2Z;e7&lyI(98e4Bw_}HNjElwlgF`ZPYf3
z^0j@7P>$G|ZQpwmy=_=~tQr${j!&QEi>6mBF@2fOpw=9iZ)}7c^(Pc$8A4QVxms)D
zTuLDaJW(+B{TU42RIZ^5nySXxuI17aww)DR@}r^5H%O>f?GpitXYY+!(CtGPnfh`h
zt1K{ejrgn6RKDgDIudj3Py0#op7C60KZR_A75)1{7E^QE8Xac(t&0aJj<)wxn7iB0
zss$Y8nT0dkEqHNm?>zF4h2cWkcGK>j@0SR|gp9EXWi&GMX(lZ!>FGIRY~DC(r3dvJ
zs_o%Skz1d|r3L&nRXb!XhzfHmzqzemJ|35u?10g_a#S;~TDfQ<!+GC%U%BtvTj?C6
zOePRQ%m#4OQft>J9#^{h26%MHGEvr-Pg<Wj+~nIz9<mnsq9fyK+DGlDJ?lQDw0jo>
zw~r1^hScJP$xVxS^mx67P$Wa-Iim&y-g48nb)Rei=<bmy0t{cVN$0SDD%Ty=jJ6sC
zK$IwuEa1;ULDxx72iTx;f+DGwLp+P;PU?%kmf=fY5##tK(S41R|B0Q^bEi|lO?Eme
z8r#`%Xy}2+`y-40QH)d96(mc2jN+*8@!U`4x1Cb9CqlzwH)cZ8;HB{fRkwA-@4VnS
za6WqEw8@6Tt-9>o<$1I|w@VTH>`sXzKc{+KIV+n6`+6{$Vrf~YBKMT{5!H=aiN&C-
zs%hj*DN}q_m-AVHEjyY@iFhIK;H5}v+~75qTNkfJKX6q#^{rfTjH#0`)*XcqncjbA
zj-+hT-0@*ro2vv{w^BrH6$j1mrooim&XTPZuT&qkiWurCTk~`(?3QzB*)-;}ZloCW
zk7DYtnhh-(Fabi>bD(MUb@-vUy5WkWrBtXBNO}Psf4U-rk3kmhcwEce<uUWemFSFd
zt+dCNKCR!^@4|22S>DRtZ>4ftRd4d&UkD*RhMs_v+;?l84MOE)51YmsHNsnKXyomc
z)aiY!XE7&gs-n$i;4_AR{ID+n0oLnhO>_Mp2y~Hg1Rh@I6Z^oP{1R)@20@on(Fz69
zhX!g7W?5-cttfN!`W?YWlcU@Ayks_Zv%|8l)5;pbEdx@;=57+QyWs=0T?J<r-UZDR
zFQ*F7;Xo5c{Ihfh%eL0NtJ*RI-i5Ez%Rakdg-CzLt{Y8*x_+oaDu<C2ucl(P085oN
z*M^|18fRuxQq(y4#>pThAm{|VXJ*(_K0}UkymB_S&w?cA(hhwPYAPjc`6G4YP8P%n
z5F*$|(zG>Lt30Hh!idbmZF?COXeQWJkyUKe$iJ>EE->AcGH<A;(=EXsHCp5(G+cFh
zTl9Z<-lKi@PaO_N+I#`Gk@(*>y^q(ujf*^t^i;@kr!*+EIt*ri$--N}C<ENjT%pYC
zZ*)miHHU_yI&s#Aa_Y#S%LtRo(hUj`*3O=aQ-7LWmIGom4Y%VrN|MHyGvRPnlx1<=
zu^VjD^-<z;`|VvSiIi3&?KW?RK?F=@vfy;QL~EzlEUYX^wCOFcZq~CsGd$=3-I-rq
z4Tuy+j1^z2BBg$Fn_O48p?)e-oe>)JI9>;3FiPX_3fTUzpEX{SZiF3}JfM~O+F_&m
zGOpA5(S&QvTr@gL3s)lLTS`Nlb)#0?W>w-~jpedOGM(J7W0;=}D}&>k)mSc%ww+7F
zvoBwmJU$K7WAv{g2U6beH@Xm`%R5M4uyR1C%yWG#JT8N=9*fj<{rq*+A8fpgqH`2z
zaJBq9Yj}Eon(C`H1anPjWZ6R|8VlW+{$^DqJ&dT~)*tKk`7eQQLIHSl_LDUMZd)Bf
zFAX9#c_j?gDGuW<LRHb$fZvqkMZ84%anf<WgIII9a?{-%^bH0-r8<W=PPrt-LZguv
zQ{g5BWDYW7K31=Pqu0$>Vo}!NmL%_MBIEn*f~<Jy<fq@z2a=|ri-sFy{$=us^?M9E
zK)|Yqh8fepI`GzogG0zd5ejoz8SER~@SWr%4YvZjt>uKn`<GPFV&?*Egt0`X@jU!~
z<;qcp5GLepk6l7W81liER)!C@J2kTaXfDT8$B#{AfAEuoMii#2`wE(_qI`z*!)#O*
z(_~={0~%E(W?fsqC?oQ+1$`alimD1@qRxxp@7DN3V*Oa6foVh)6X!u~3S&qhg1;VY
zY|l2pz+XAM5N+P`Sq@2CRh6>f@^<D<tlB85*s6+12&&z>Y9oy<gsC{z0>DP(E-FXj
zOdSrNu)Pudl_(n9snB>wLqWPz!B5%hM;F#f_0O!cf^Y^e=n*y^bT?_`rXLXcls(}c
zpmpPgAeC-D8-0R){tw_c2Egukk)r_VrJI|c{{+)keZ5z$I*z$~VS9V~{i^dX?s`jA
zov_!ayy1jtIUqFo6jEG4b$<Kr<I&H{!*5PmuL(Uj#KqG}leafxSCGn@>0)oa6VK~#
z>%4(0n#DL*hu?w6Oc>r^it=sL*<D9uWYd(O*5PR&BPl*se~kiEF6t4V5!8rRR-<<5
z^@4qS^<%H)luFbA9%+qOSx_w~9vK#&phzJlh^7lqXl_7RN?&rQ;tl+fET`-S&%&Qc
z4270-Uo?nv$lPRZk;pV1Y_pXDxoaDd;JI>h=Qdt&zrs78ClomyX|_y7Tt?8B%sib?
za<jCyj2L*ZY(or?>i~=9c{&Tq)NZQwc7DE6tnHLw`|e7g*z%}%r(v|%?SQFLk$&&G
zLS|^(Yq5V`7yLvPr?#Pfxxi~G4e|71vpm{Xh%ikNMPTUAW(I!?_VTmG!^xC0{KG#F
z)tGK76zi#9J5&w*<M!Dw%-3M~dk}{%^|#7L4g4rtmfT|6Z$*NZzoGoVc&K1TJ3zY^
zoJn7T*G_Z;Ni+}6UC$#p@N!WgaF3eB9|?_g!0VI9)1ejV>x5O&-}{GMqnAmijlVY{
zo);7WgyHq#tHGXuZsy)U#)ibAAWi{)K7FgvmC>}vPYcSfDU{gq-bIizfI+3W($Pu#
z@E)bM!fR5dT_%Cg?2>MF%r@aW;RpQ@z;EUD%lh+0D#x}qh8g<jKyEZMj1Ly2gQwOZ
zaa55>B__>MSVy}$<A#!72xfOx)i4rcbspqucVt{lvvh!m%4+nQ9iu-bl{BF9SB)EO
zVJcRzQ#ny}Y6juRt``@=JSIACzbP)@#Z`;TD@r2*%1SNzyDC+YwdfJ};g}y|Aq1vv
zENaV1o1<^&+9j|=wr=&BlbZx6RaDa^#3kASw;nB6Sk|iUnYfJ9Y1Zz#P5}y}5dJhn
zZWo&i{dR?x=i+?2s<oZCHi1EXHQIY0sdPe|H<w>s{(Jl1%W|=bVQFWGvmYT+z)SAC
zP*k_u%jxFp(%<LlN0@bO^0RHkX{$h>{`2!QiW)ODK2OM6<4t;exK4T227qzOWyPP$
zUj`Tu-Dy5P+r`U>IB2QLGS_;0ppe}D=`SDQse#`GE`u1*jm#ci>CEKS0Tt?Y;bWC#
zSb;W>p!ukZ@3{MixgwR+*EErf5Fa|el)Op8Sl5CIPN&3D)i@+Te%28|CeWN?m;mZd
z+<>#I5f5H=TFfUtJS<&)+O5~N(=h8q6em9GR=y22m}_t{_`~ZF^T_hc^_438;!@@X
zeGK&V=aqUhdds?~%!-Pok(C@ZKO48COzzgAhF?eEuG<opN80y2(k7x~w!2`bfD^r*
z=gz;bnLdr37Xi=N0fz{$2i4HRahF|oQ`1>?i?=c|GEJ75^!`gZt(mbR<54<V*VxqO
zVoUA<+Q-eg`#wo$6l5?I_2h8B?<QVc`2`<FQxF^xNkG#Lzjazkj%}iY<<qqdUX5=-
zZwG<*$_D}1vUP2)+pDh{b&0jBHYX!_t)>=?rLw(_4v*u+KYi`jgzCo47;Ve(Fwmhf
z(1R7pzWH_iSv>@r#K(PC0xy3NYLyYWSq?>en}L|^`5)wpxICXYP9j@jf|TEHI|EMI
z&Ub~#JdS~ZmrmNolgV5!qa4Mjvmnq3mqJe_1m}0K?5>t%#G%}gwq!J00M%-lMukNO
zAw~uvRwqLd{yo5%<^(~^yud3LFHY|&3zc*yWeR0iXiGJR&E&zcr%t;z@F_!T<u7LP
zIiK?Bdzrht0q+5Ro+OeP72qFuFsH}HCO_hu3&~;rjSCq}QZI#)UXJCi&J4(@&JS*H
zwnSc&F2$kY7H>!@#&9*z=OyOqRKdh@)$&VEa1_^EYjA2KL+Y}F!?eit28*H0l%23<
z1ED9)S>{1gdd;wt<`k7!l$0o(q$pgP($=2a+y2Z$e>})Y>!{)9&AMmztJ(Wf{#M7;
zdL;oS?{jt!mmk{&?(fS%($42It|&Vtz`j%;*R>umby>}ak!)2s(9)O9_h#u=&gnMk
z2L|1LzYFm&g|+`3+M==<5+0Ui!!4kf-|J?4X&OjaRsJH$i<YKY)291W*%PBcsyS-U
zXE<I2fYoyTzsselKY|0lX&)^8<_?fUuq%>pz)S%AhNRNcZZ3BIplFqf%xQI~pg*Gj
z@9+RHGJL6%qFA-qd~`|pjJAddoi1ZHUl!F!^638r3pu!~T2?w!<3OH-|9r}+jAJr9
ze3H<VEj|pOQ9bN_(#dMNRP$Y(5(kV+|M#F}UYI+GF+Z<6k0|*hM8ixi`{BR;IfM)5
z?YytCImx)s<IV$Y2|3&?Dl2Vi{3b0nltq{tvpEr^9)tVu!P+#z2EU&;m#$t2^DiEE
z%!*0yVe`nI%-Mn?c89C;NblRcLui86*ZJaXDY|kwT~=4Ot5qSx_wQ5i3}<*fi`$tL
z_}msKut0b-a0e|MwuJ=wW4f1Dsi>2T5=f!<hxUICh8z#ci=KFmQ`#s1bC`J9KRCpI
zo(_xh-N^-$SU2TY6Im}#f8zdr3$k2YG(wpDzf*|9aYy$$ItBdQTB!4G0bO4XzYPFg
z5xflhZibX~z0HBWd1*3)$*S!Cy&Uvl2lD#Jz?;o3u<x3}^FZhO1kBsKxL=V>TDVQ?
zFK!>JGlaUvt`+4ooAIE-gGF@Xv8Se@-At>zD4&Evk>?T?fBK<1>R3mS8xE11j-~E%
z+Q4htboR;Ll8hVgZ-0CC0Z#2FwVj%9A3@#B+>`gJvDTl^<Iw^xLrajb+JoV&b@lc2
zO`8u;)awWt9M)Tq?_CeTn{TQ9JFjTM*G><u8a5i&XDVx4`fZg?3CT$bDLxw@ryhs%
zmKpQ;jhDHITA&YXHxPKsR<}S5sn1oI=gI9<yr)*Lj2U*SLu$<JoW@d|$`|4fq5=``
z`es2U3o?rkK$cFt=$U))q2pz>N8@Q5EpT}_IsYLl-)r-EqfOen;ZO#G`QZj$;R3*|
zAjjuk1Yz`PX6jh9FraN=z+-yg<C#<b4dJM~N@*1Oi<T#I;QQaeca1t9jTHSaO@=Vd
zY`R%Tmv%k(c27i?43%alwH9QTXEQOI!dcH|ntmj=T7h>){0iY2km<+Q-*9sG1onZp
z=TYykKftf~IRCXNup@HLWA_I2SYH3-bY^B|N8FamZEwFL|6za@Z((BUX&Z&MU`*%n
z&glJ4<f(|hF8U`T0jVJ>G+4_|p{20wZ5@usx-ywCwKo^4S$8IE(eEDOfZ3Ec<Af&&
zwud*hh#GBe4u(|ut8@x8FTLCJJVuJ%Jbz8u1ZD7xqhRgAx@XU8AA*SO@eJQqz$==_
zYr?;6a`;D%;rq__r}tPA!Y1b!FMHw)OW5^AWo(?P{HRP`FDy(t%NWEh@G27-$Bzr|
zX<u%c8%Q=au#A?A&*W|gdw__rDIr@;XSO&Tvc~pEyH}{Hm1_r-9lmGYwg3-~v?~3W
zlDvac(-ulEZw~Hp=+6~JZbPqrLf?Q$P^N<y5v?%wxQFkvmi(r3J>O&%(<;jD>vTtQ
zDy~6tf08m=5o7dTj2=^sbOv2Cn54En5LsW|@15ScF`?kN%`H}tW$<bAb?(Rt+(peo
z=ECb}$j<Z$#u+}8p%^*9vNT8`-#*{-QvQzYt?=$1V4h^l@3FmTFJe@4sFS;#d*3sF
z+#%B2zdP3q2KQ}Obcbhkop<*j`STNPGz;4}1f|^+gpt4_d86xHk+=A)kgS~JAq72z
zTyBPhpFcpvJ)!ohxjI?)*;*cp0qny5V2=Dzr9l)5#W3@gyC&HnB&c}P7n%WUVfv~M
z(4#^2gVTz?2U=l_wNlN$W62ym?72C@t_<AYi2Tii>@-P*-yU!cB88Nr{|*VR$s0ZG
zgoZXx$D$c-&u%~C7!CQ}OulcG1wO57p(VE`>cHa72Fu7abYv?LhO;ql1alGS);sJq
zu6%k^a;PxhF3s%h2J4iL<xmD!hz;TPJPb}6Fwb-ETa8K4r(tNC+w;zu>HJB#MQNJo
zgHELjiPeM)gvfyMONb?o-7|KXw1ZOquyAWcK@>hK6IyrH!c|2!?zXl!Jgf2Strhv)
zn|^N#wuwC`D%wwvtJvN%q`6jE9j*EtVx@=(TnKv>TnX9&8YW}9^7%*_c7S=`6lv=_
z)CI6&_t+lzsydN*r&$F(fbhn_&#d{OpZjLxIQ6libMs9C@^IYQWaXR<t<t4=EZP9M
zapVFo{syp|Xk^cyug-mQW>*^#BVz!5pWIE+2!)>JNFMZoo|eMNgK{|M_8tO5=j#_^
z(cm7bU1k&!Xz-iktK?ZpPM9|?!|=Gg*d)x#D9DP|Y7=D@Ax-N(;Z#lFM3arnh&;_i
zwh7DA1n0Zm+GjO9?A%bxD&1+7i>X4S)7|5hsBQ&Gu!02Q5H+uX=0~m&_R_Oqk+&-^
zmBd^g;bnT7vZe!9Z}BvbL7m3LnPiREyN}djIbqUrfddgZ{m~kW;!xs@C9_pj=|fr?
zLU)FD#ejjWL=As>Hbyqvc&Q(<$l|9=_~e$86UP*-60r=n;xlg}Sb!WmzLw-aO2;6R
ziZ?nn_ozYIK1eP5TiCTgqw^;&6lw`3LPuSns60gQ<nH@R<q#=3%d%i0T~lQEfdfmc
zoIuR>e56*n6bz<DRaRojRnOpO1YS(#%FnKX7RcZFTr4bVO5iJ6YEQqgI2bqlC<)Uc
z?{<6iI=7NFKxi%MKEDTjgP1?Ly=3W&=n)u)#8J;k<q3Xkm}oGGd|x{jMIe>Dtj!NU
z&z-^1_-y+=ul$OYHJr43dq833R}#aL1*FTkgUS1_S;#4`GP1)~YH}KzII8Sc;98xO
z(4Fy>vz_Ks*$6iA2W5K=<)2c)Zhl*Fz~cQzrY(S_a{~%27uU!G8@3csbt{Uzei92z
zTk>)`{l=8mQT|XasVTsQuWaIr^XWmSr@9fY>COC0k+uaoqx7PDY0D2wF)TwB8zD`N
zZVcE`LOtDP`cWehd1+lThbY+~D`Q1W&tyR@WMgrUl9ZT?%v%}b6#3Y)-ILU)XdSQL
zC*%A%)jAZ3mPmU~0meF$MG$9mSSvC!vfxuJRvYo0v7PjXx!N_lKgZq8e<~SsnGTOw
zNTO%c@GQUI8q1xdo-h5|CU-UMLe%y(-l^wtJR6s#Jg;OI2qp&Z^dy9w{JRY%@(5O|
zzx<1j^bo!Tju~UhR8zNtv7<UJem{4SvhBD39411IvHC?JJk@4W*J;7+(EGwinfQ0c
zocy(MXq^FgRN8*A$HZR%70mmw5LnZ;F}7~PCV+p^d2Nbg%F1`|jOR5DXe0ahmD@Nd
zh6Es-Y|4gFXELDEAd5BC_yfm)bo7BZW~(;$)_SnO0$;3e(TQ$hyn-)=GryiZQ-fc#
zs0Vw}hzQ0q3x(G*d8j^-#}H#fHc^6k_Lu3)9xIn=8o^*`Ug39bjB@jjzBo!6lL}r0
zp9bKSkx>XaRIulmpowHLtx)(rp;L-xQLrgVnL@Y+CAyC`R7n?wbdfGe2?}~`E?lw+
zRqEg4V@JqQ#y}rV*yZoaEPP-%GP^W6q2seW?glWGwRO@OM~&wCR80wPL_PdxVih58
zHn|M7Jo%iX$%sm2s0A%05-a!dTCumj=eqmi*32ZAjBW$dN0)6){lzfWxQ7bDBD*im
z!u8smb*$C40IZKz9DVG`$+mHKsQBQ@?v3^UIrMCwhJg=e_tW_TT`r9e=Ghe{wS*>y
zd-rYsYc9jH#8`~4LK>-lt-rVeX=NokGb}+yr)<mNA6inXLzM`(v~9OFhY0x7`D+9X
z;m;Ct>#*GJf9CdWY&wjmPAr^ACk@r9?zGR>@J{UM$n&JBor`iFU4!RVTz?8i0Pu8V
z@UgeB_$6^GGm^SW1@T|)ZGzy=%aVhV{vUg96;#*K1dI|ONN|EffMCJh-CcsaTab;r
zySqCCcXxMpcMb0D@b8@OB<Fv)RrmEi+^SVnQERW6p6;3Uo(2(2h>=Gz0Q=_2wyGWu
zf2m`Cz?JYZiIy=;HDP+%i~ti_!+G@5l%ETJ74*sn^jmxllg*KgZq~P;0Q@Cw7Euh>
zGU%mBKa*cqRl`IEJeS&2HBO%bS0pruKyZ>8Pvg$oQ3@VZnbKT;64j&-K(sjFl`hZ}
zxY6c2JJ}Kt_k!s0>$M>=6h7L0jLs?!URG7Bh)0DXKnMG#OmQ5!e)1|;Mi+9FRX1R-
zyWqD?|BB~&LMMncfuzpCgIRN`#v5Dg@KMFC#|mD4+5}cG;U#z>(e*u705ocBp@20d
z6Z)4zYr80#jL^*Y##%gHP&KM)&cTrnq(;x9M4U$FLR0}Ag{NcO#|%{?sh?c>S)QHl
zFh~=A1Pm~$CS?<*EhdPXh;oHe2!yflaEy>)Qx=kq-jsA+Q&Z@~0w`msC9;OPT-E0V
z)!OtVYwUNBz!_?MM{+QXG=Hj!((vw-SIlm!R?{ZL;r8`Pgz4IM<{6@Y6}FyQ?qWJ0
z(%Zn|Vn&Yg_wJROW?D=-#Z*SpImkx8mR@BSd=Cay6!`ecfhlIG=A0!y#2OI2@CrK}
zo9Mj?Q#a-B1SJ@lq#?`7)As!yTF)mySNt+g74FJb!5dHIm%ob6jT{IrT$icoDqNQq
z<k>YBx5m$Jx}SH;<;;n2g|kNNj`v`)tjycuuswy>ihm72M4lqii_6_+OewooO#yxi
zs-+ZsMf4Y}r-ReAaaKj~+y4dqFhs&{Y4c+K0|mWwL=Y>bH!N&J3*1zFM>m6{-eF{S
zs8!b~3=-ehO?et<*}ycCj&21Ro9O3DwoZzk16yP3^YE_2Rx693NH|^YMMG1*LJLGr
zJV{c=7L#94!a&fo-pv^HfAt#a;uG>pNK(5HztI}srDW+eSfOrTLBnk{Q_eh}{iVQ?
z&YYsudiUeLD#vpAVo=VWafsUyi)4k1rrh^F6-{hF3Vj0U`TI?6jcTh%y@Rg2-pRS-
z2ZeC`Ff%jbS4+B_OmethY4YKQ-lS2h?#f|4iORtPM3kDSenQ!4_b($WFP5b#dT{Wj
zG!<QY-Bh~@D{F|;Ej#>0314P#{FMU{s&EDLWcHk;x(Pf(QKd>8yj6YgA26)Sg2EEi
zupV6JS_}etu^i}yOwjt3F9wqq384)<>S6X#wp7m1K3^vUkTH%3(f1q4;2ir9lwS7Q
zP~~ZFzLdI9CGXk~Nr9GQ$H&}erqO#>>006K>gAx~VwP~H>_J2IGNR#~0;V~$Yp1Qu
z-w)1>T=eX$axc}c!C@dm!qJ#odw=NXDvS!Dov#*So%$5JIN;QqRkRO#TF7o5y-GWq
zN1dl|RnbjZPsW{M>13zE5Nf^C?e6)NvDBKOjwSz!Ot-J{<g>-=IS4x{2r6d3F-(^E
zCMS+@wSGA8EJ}mk(mHW9_~hjXFre(?|CtO9Da7e+eS%13C<!vEs!0D8krz)M!Fx7~
ziSt>#*ff8CHdA&YJJ}$zZZj*Wm*9lpL%lkdFE6JJ21pXwSFXUr!;gk<!wPU_$h|Ab
z63i6F3!l;@uAfBrOr6m52ykQ&(LMF`WO%b`DJ8yhDuxATQ)(1LW9mPX?GXfg;umX4
zgHFsJBG~`o<OI!aYeZ2=YChIjJ68o5hoNGk+9N-O9Bg;Gw)#>GTIG==o{>SW!;zv%
zMpyMsh4#A|I*KW=@K#l1$V_=gzgcGIs%C;j3BpAN!`@0nLYt_X_JNP_{lq!dgKXeO
zR288+Y7T$~#H#IcIMXxjV)7JXwhSkuWJj;TN#{lQkD$DTP1=IMk}ooh>o$)<$7E)V
z!NF!RWA4SKJAjkikS{ZCeNA9$?3{7KVLN^t(RpOSMAix|<f<l|WfA>*wTI4ZrGmA2
zeEnFI@sqUG;yr^zY5)t&ZWCE0@DQZR8(1A?QQMLp12B`;YVm>k0C8%rWV61H>)#s}
z{IOFF!?HCz5{wRc^qGXVG(_^P@}YT}DD*GJxAoVF1B&ciusaY0iQzMy^-^eE%fhr{
z4!+;C1%*W+)d?yZBcmQFYVvW~Y%M??=Ik-V*Xe8*7Ap(JkD}ceq+brl$I7=8b-;<-
zqX~z*B&IV{=BoF;ZZk*Iu7RJnZ|$<!zaJi9QN2Qq6N7!jrfJ=&+@|%u<t`n((_K`R
zENLizJ2|2Z(VUo;NS1L@G;Tw={b8?wm|ATeT-_D?38)mR)`Qn+e>qD?uGq6kmXdn3
zOQ~a*07JB?t2mM)@Aj9R^E3rTuj}oUlu8UhIp5WQW85E1NzT-y^_merwe8qyPl4&}
z*w1pLqW<BMG6pNS4@6#aalZJV&5rW2A(KM9(Dc5h?c3o#HO;ZubinR-bm_t|*ZI-)
zOFH3sfbn7D421g=iZ)En{gPikPo2~x3<G8lpY|x!@P&yd6=5{zx30p8i68I+mX~Zr
zMZhQtU)pT2p7Jsn^P!JaGAmM$I_$5)Up76np>zHVS&G^5{D5f`Or(8^Stb!y^Vb52
zP*kKchlWvl;fAo*K|X-Abz7F3!@Pe5msiGo_V>D<^hiie+lu<gqcU|?lB?g}+=hx%
z%C%`^V_6*~Mz-_{jJUiz1Rc4hOl`Jmt)n_!zk-&3z3;J;&lf&CQHwii3bGs1_i^aH
z3@J3_$Id2)o1+%6VsgVCFUF*Iw_lr6=DJ?pRYb4NdND&7w?7P?63wYWAP^+P^lptT
zY!=sl8iTf-n&z<O2o3EQI#%kX>lewYOBI&cCv-Q!U>Q=Pg6_MK>Sm6LLN1YjV_{hk
z#`=7a^?><-natvhQOkF<oNi#xM%=ORVd;q%#~zrw5{<-qI^fCQpD!~xNjO%LgG;C=
zqFJG6W~{01HpAN34BA(GPnjG1ysM9fFwl$J6vAu$6e5RzKDVFJD>_eXz0A7X#z*Ft
zM<L0u36YfNY2mbOi@hGBDtE)bLwp`xWotF_Vs7TGVy8exzIjP!EjcN@DA6EMoz7p7
z(7ji02G8u$40&6AG#R>7jm7p^8oOuOr67y`fQjcY{gCElFlOn(GP)}D?(nlsG}lO<
zjEf?N8!c(Rs#4hLYRL2`LFA>yp#C0=AX}dQ)3KULZxsO!3eN{QN_1{Q1!CjSLkay=
z{Veus@KG^f?nlj-=dx*j9?i0}TiB?$9RloaDVGy0rY1ek31tSK<fO*XT%MhK<EQLA
zC4$p%O<$#Ft&d1P4S|KatF$O9Vv;pCw9@LAK8A{GFgA5Nvqh=rL*iUSJRFW7E)E9b
z(@0Y>nx*$b(dtD!ShtjFTcFBcf~2s(7>-G~n2XtN!s6?)sMbNE<TniCLA5JyQci&7
ztt*QK^aytoKefWIRy>X*Spf>jIa5j}ZCTp3mW1#`Nxb{~==yNfTBB3t+vVu<G)bFP
zIg4CWZI9EAS@r0C-LiSpjyR(QzBI#8>C()1HDLs;I`ad_j)DiJT%&{OTYVzBABTDS
z7FfrMabwybYCO;=*MANyRjY>T;OlPI0(m5{4wJ<Gcn8!fH18;4pYG5~d{3}(Tih+g
zj|=W0KU5@oG}++tj20x7t$<0AHFmief3x1;=+UL-w7HLs>@V5OQrR+xi4Nw#4vTpu
zamhQEFc74mG4nAy#O8XM#vbg8qnOp{z2y+2Ym88?)H0RXAm~BL<>*MppBRqmGqgTt
zIGSeF_7*jXf94(H`#^hVlPjV~KG<A(fS4Gf=JKoS(H5I^BS8F%D}{R1cJoP;(R_72
z?+CS4r)u@>TQB<7cCB<WNCr4MRomCd83tBo<I~9AY$`5%u29Vhl>rVCj3i9=ON0Y%
zP8b`vPOa$hgCXx_9Of&-TIW@BRUvsq)FUvk4^T-HeA;_TGaRlJB2%pq(-YZ5q5zFR
zhRbs7*Q`KexbNBbWrKW_YCi!=zSfILbx_j`wvwIz%rQg?;(1oZ@8A|gX$Z*ME7X&p
zHIVv>S4MH_2Z{#}@plZ2wP^(?(fyhDDSWsf5E*((g1$D5kvR*5E5(g?TjXbuNy1pa
zLOZp6=Ww(5TCaXJ?p?(VLw^|Bs@zrcQ_xou`x;Fzq>1$4u>gNi!c*NmfoPBJ%S3eu
zh#IDhpKl!Xl;~4Etz?fcBSq;1IE_hlr2ABlN`H}fLPAgpfFrWNs6vdl<#s(o3;qG0
z*!`rMw%#dkVNhe9jHK4VwPl05wHkVY_+s=!>ZwYzW`aF7#Xc+>p!VbeB5JG@Ij*<r
zBA9?$HbPRd8JRsDW5|C@<{mYqsd2oD%Scsd5o%>JsmTmwU~{<=(!3Bmhn|ZbtTL~l
zxAc4I_!B)!7WOUITCU>{67bJnCTn^EOw|UzgnV3MxmyrpQO#&G0LVsRx?VRj?y!=X
zDwqRurmavoU{jNjn%$~cj_{J<2h&WlrRj{Sa|~YAz1dZugLDuQ;Yn=5LV8g@0S1iO
zetCgYQS%a-SurNNLRnO=UhhP_IW`3hW(^9A1$x_gezFK_u;xnHLxGBW9!Rm8+6H06
zi??&2266Xhh#%>hf_~EVvN2Qc1{D){6ZX#rifL%;x!)Dn%v-n%k{&I2w1gLL*K2x?
zIcG?yoV)Tm?RgmswLJae1D9@mwlHB#g6Vuo#b`3oJ*%uKYcKyQfaI=cqU@vTB!qDg
zOvU>y>XJ{;SYIPw@(>J48kr&6Sd`9|Lf5sb%Rof|Z-OyWG);#AhiT%K_F?Or&36xL
zE^D&J0-E$3dXzjSRtj**ER;7R%rOU8GG+(~Ow`cSfm3rov7N2KUzUS17zxZyqx))E
zM>S7E09cx~YEiNHIYjmJAqO^*K_z#g*OGEd>Qfa%2?bOsL@k#JLvemeQwyO54efr<
z%j1&Za0Swog(yB->P)%gy%y0>VrloZ`rxm*MOaAlixxS1jp7U1EfcPe`Ua`G>sg^Y
zPQskbop<mE2+G5bo}Qk0S1nYl7H=vCxfBM~=_Pi>ZL9Jz8Q6}<v3ZLn(($xrpl4T7
zGRKfq9G@1s*i%?!UFZ30Zj{obl)vi<lt=+=qT9c&m##i#!t3T^l_sikVgm*cM``j8
ztt1&e^NYU`swgSkDt4+y56D*5I2oNOs>uHmPgZkZFBDzsjyEiJspy_a#*fAIR}U~}
zf7UKJz*4$V$lW5y`>gV5u86qVq6Xr}Hxf6niW`c7f{8C$Cbq+HBB#r~;p)g-?CdFZ
zYR2L;1ppEaaSi^gSrZDe0#YQ_Yw+T<dIkhx5O)5}i>u42-FQzX?=R+%`}cPh%PXA=
z`@m?W`bwOUh+5(3|AJA#zZi&{MRMHt&W{fULggzYEoP^TAJ_n=R!U_5hQlV^K}*%P
zn=j9=;$w3tz72dUkf=)jCSVOYp<UPFU1KIeSNRi>4FJbSmi#*e`TOCO2i>pe9$4n!
zI^Ag)+i%;-JUzYpRU)*#JcDLJ%8BsduD?1kF^!W7HB&N8B;hKEw*a~_XQLyh?^t0`
zdfmj<Fbzr)vD1}<?JzSfBVW_<^~+l*0yS-*@KIaa4H2p5I2<=#v;DPc$@&aQ0U%rK
zF!0aRUQnYVI&;!1OD-}iZuVIk|1RQpfY$-kW_e!gquih16EMn^|2b-gIXznLU$}vw
zcP>K@ny9;?ivEe$0a27B%`3fPCoKLaAPOAQ>>GXo;8YR+<G<0e-vKaoAl_y$$^8EV
zr8M0ut-em#8|5#y5xoz=f7MDE=c4?-0X7M_Q@}7RcTpr2>b!oPabK+5Hau~q$oCBX
zjSg7pmO5amunCN80UM#b2ubo@Yd_a%bI50Mzf5mtv1`3-qw90eiD2Lhs((T9%=a2y
zrY})@E47K!`X^kc!wp1*(cT>}3dWGIFXDM4;(3_pF?78FtW^8`j{y(Qb@GJMi||M8
zhc1NW$<Tr;VAScs9he*6JlmtbT{*3MO3rmPNZ4^j(XrhpdjQFO@xiuqYZLWpq~m3z
zWZpotHc_tJcUbLB&QBufAB1!&0O!mnI5G##)Kv@hZ;W&bSGo~**BCXhv8G}!{{AOq
zNdUy6gkKX<_F3~W^~_EL#~G<~E}h6#u#B5eyapQN1`rpevij=jg5HWU7F%DMlamn8
zLX3!K2~q#WvUeFikT?{@CJ@BdgOs<xo=@td{aWQ4Z>JkZ=joP5<oSmxVKSuKU;1}X
zB9h5$|3^Z08D44i{SsCd#0`JKNWg2uL@lr<qdf)HYTIJCJG(*No<!sSHn%a9-HeI8
zO<#a1r*D9~c&_nVaNAM6Lp^%~3EJ#;7PS=|G^%OgEfBa*hL}?r<3!<M2@QMBl8(!q
z-_-<r6$#52&yfk?poWv`$6k4=y+Ea4_1mhFyNx)a$3jPl7$1|9=Ub(ik=8k-N)PN0
zCpFabP=2Qo)FB?k%?Ni)tlvd?+~kA_M3ZnNpS9hulk<e#06PkGSQ3`(>n%PEWxfpk
zZo7zE<K*Sz)H=J7ssnm#--AfGJxJ+tox1U|e&5cb);nI-=nS(J*QcBJAnhrBZw%tB
zQvCxTIx3b-j4$^k7#Lp6p6Ehjuay53@iEdMn|vv!{uUy|CC?Mm!E@2i)o1UvdnenX
z-4G9$i0ypvGmwBQQ5!Z3Wa8uXiwWZ=cm+PGoZ@0u(yA#$ifW%9*b0F{K1h!*H_WOz
zR7a20!X-YE^gL}5w7?h!$m8!0k&oC?J13=zdsh;uqNg^sWtFp0(=b*_Usg%~IbvBo
z;LX=In*AA>PeqyJPb><!IZOrgB7RQ&<eW*Y>@HG-;Z6aJk*c&_2;QC9@CW@#1C5Gt
z6HZ~vuue-!;^J;W#Tr6vWBQ~p_(H@}e)6OOS;ANsUlUA1y?LH%cv6K3ay=ALG=j*{
zjBmH4dBf=?*o4}2m`Dtsu4hj8GxhkGP$AVVAdYU0BVyG^<25K@cwm)>wvjRp#W<rQ
zq629)K=Xf!nV?Db90h!8?0f`u&_o&G4^*tZc#Kn^{=K&s5kbEso9L@-*THk^EeS&L
zV8WXB5=i=NJhyFxUQ=|u9e0dp?J{+34yaDM5@|shhfe6YBm{hbFoF0gVcuLd9cb~O
zg%->s5*FDmm<`b$K{g>{W1Y|;!+Gf!X+?)#Fj|}BFB-e?izdg(jwA`L8QA-7b8n})
z2)swG>W6;=AD;oy2cR<(gs3J^QB$-OX@&uKm1-<CkuVfiiX?JW39A&wSTC6dB9tND
zqG2{zjaij!G{`x*nF0}M87pnd6_lW7E}iXRx4u^mR50DGZtWGCgjXhATLT?ITkj~N
z*&~q^v8>lIvGj;g^2n#1#0711qO1>AlqG^gNWb@Q8ObD4LHI{XJS5B=Rd$2#wIRAt
zzwk#{{f;+rF>t*QFv89_<xTWC$&mUaec{p!bWy_2W=n6w8RfmgV0r2v4Ego=a<}4O
z3N#u>NBYPh7$gpxFd_k>9>8v9#s%M9^8<-B#j1Bo8zua(!Z!BEkn?XwU#qt}KiW!K
zDM8sK_i3;e&7wGSwGD02DC+B)5^eJn-v<_QEKD-=gP;QJPkCYWCFSw*DP_Edrc597
zk&LTSnzA3s;a}V0UHHJg!iq^Jw2?6ulki~(2Uft&ZHLmB@Asqjs8-`x*s6wutY^Oa
zw)QO#iDy0+)De$FSX5=3m^<}gjC*q<ov-$h<^1Lzc3!;b2_lEDInVwD$OHWSYIyyt
z*jam=Fk2_S(qVvJr_=tXPm$)hoj-4SgTk9-qgp^=qi`}}rWU&MB}e^j(QN4|oy(iR
zxP$${-HHwne)8gc-*L)B4XnT!aEiOhBo$-oy9vt6XVp_p=#-D)!m=R!9?*kRO={Jo
zd(=G#5(L&DH=0vTOQw(NgiTS#YFj!4bW<mrSah!4iQ-F`@Q7`u)zpVTbJL9I6&eo^
z^bA@^PXKLc0S_0giN;>uF?(->eN!*TJX6Xkf?(v|bXEL(;4_2vY<GT4$eIS7AHj-Y
z=I&;X5RBwQnE&lWfMlz<i)lpeb_S-~(SUP2Mkuil?rW$k><_t=5z1{#607!1>q=u!
zcM|Z1&Rg&-b(GlX{&f9F8lPKvrVoztljP*WXyBlJ`rJcI{ze7a;noyM-)c<wpAV@F
zO#AxoFhi}Xz^xF|dBZB8Tj*6!Iqw$rGme2(vbR<OVIEaZ{lpNfFVn}_(1pb0gtEVd
zZY3&sb0z0dJAALifK6J)=y|Z}1&DY_h|@I&Ml-9?7ZE8E%(Yj7lM(+aK_c4_jD=z5
zK-Cnv$e%xCQCLM5;{}t$;>GkmQ$xd#oDIkxAG7Fmut_T`=|j1Pq_9~{^YR+uC19O2
z@nf??WAt-pLJdsG$EODfvfa=kb|y%4hp&|U7=ATB+R@YH&4pOa^5VIoGJG%#k@}=b
z1eeFk*bP?^DkQF;^_yoLfOu200;;gE;GL`uift(MI1hIwRP@|g(RzOj%Vw^RKRNYJ
zJPrfo#3gq!WeTrC2o?*qP^wF5rLoVdpBYgGbl(EmteDQ1RTAK<w#7^ExnGZNCTCDd
z$NH9%rasePWKr&wz{;BI<K7jq(m*My9vVf^svQ{v&3^y<lI$h>D$_C|?cXW`a~dyt
zT0JX>IlYCjQUn&9J8OlE5~1#;d@9K2>m@UP9&hv*xP4%ah<TK;qfWeM6RTgmxQgs<
zwa2M6cDyK=wIN%1xZW4|s?(bZN@8?KznX{mw_1L)kc;DNl5pwZ-<p>y{^Z93s`6)A
ztiDV|MU4IM;?+2eiAFi%Vs36D0~J7{JNI4)g~hEQ)o!T_mf<u(IEi1)iR}wGI^?cg
zfp1gNr5mhPU$M5Rcla4iwm>OT4Y7|+1wl+vF>5B@jfQO}nUU@X6yma!3&-TL8)Maw
z)c!1EvLSwP*3X-~l;+NSYO-%fdf)L~$Mx+E#j1ZFS92zBYR(`;E?PV!{W4l^!yInk
z5;$2RiZSFJ{cX~EF(+CS_%H3nJ|Q;SILI_c6eK}tO9$$b4Dw;;K6;~jq<i)VUh+sz
zbh|eCAVC(eN1Ue^8wJ{VK&N3ObApma*bSVgJOzARTYGk314`Xxn`FdTRntr|7e0Th
zGMyt*WjGZldrpn1;!#0@a6hud=TWuV>CnHp8r#DttzXRF@y%YqqnR?K3-VPqb<T~f
z*qd-}{g_m8;XU>xg;J^~lRK`zi+(SUl4BKtm*t*}O;I07*m;;V){0I!0sqYoOAt-_
z=)<Rb5DW`+aO4rH0NE8&zm8;RlvCQF#_2BZWtC<rZsDixo!OAk^QJ+!B7zWAeGPoL
zA#Ch1LVf|GT(z{*>yV5(yJ?Zc*=lt_LWm8(n(kFCluRVCPvo`vqGq1|rQn}zIV)i(
zyDp#*y!zn92Z~M=@u3mFejyMmoX}b$x+^(U6$5!YO2h4AzhroiJt6vtTor!p?%L0{
zs|ePVY9oU@#9(7I+n*Wg3adJ2&C!&5R}a%5JIx%Ph&vYsq=<9loFFpwr67cMR~3*V
zr5|JQ?oEV5Y*q7Ga8g1V5=yyL%GlJ4K`f^k<`r<Xf|PMo#qntD*=)hTFEa88h@hut
z4uvge%TbcnFlH1(bC6D3-O4r-kE=<ObYaWUVbWbT57J+Cvzg&uj@hbWz5b(=Nh2S0
zXE2jPbcAfJ3d8gZ_2Z^q2Svb0i`jKxm|#qdLhFDS;Q^C({f2hq$1rdp*&;1*c`5lv
z;kpTb;tvaPk%VX%=hEE`bVX9a7Vcq2h0-uup?%&qE*(UrqK_9fdJ^!hmV7MQAmpdl
zq9n|N{_54ehx&D_)8>=OS)9sn-n)>eI9<<_x1p-IAeS9TqD-^OuW5-$P*rxj1`xcU
zqe@{^Gb%F$14|X_NfJv+3o>2KueJ-Va4nX=z-c$MK1_J;s>ouD8GIROce*U-U@p|r
z2>Hl}%|}XJp`PIi7_%({N-cCj7cIscW}Q!j0~6%`q=c^hBg?(Lxn#J%_C{Iev@7EZ
z$lfi1Nnf&i1fb!qLpd$dZ;LXy*>%E@!zCeNXNq<f_9MyDUtB<JV)%Busg86k8&FF~
z@+Oh7!%h%jLgk=h22xtThzW~dVy1lP4ju!<`HS1a9#zGWZ2e$0ZKODK?n3=0&gIec
z!R@13kjxiUZ!aIEL`A;X5P`>RnmUx-H4_Gt1Er%G9rRem1c;Va!)(sP;7rp(WFaf3
zlF$VdWyBV+Hd#Z^ChA3gWBAOvi=qV~5<Z^ad8nI`NC(|lg^Cygl)hZP;9xSP{2uh#
z7mAi|{Z8F!dXrT4?xK>M`sxXWXPIF#P+_(ZBq12mKZWy|jmN~g6NgtprGMhm^pSpf
zNbb+c%C3@P97rbhSO^L`=r1}MIgkP$Pwa;+AP)^#*i5M?ebPAantK_G`QYcWrBKB$
z7QCG1qay2h<lnrfKw_oJLq@0M4m&^)RFKWE8!UMG04_W#hu1#`CMu~PRIMJJ)Y+|}
z$GAX1YDd`aq?tt&xEsEeZP53R*?kXn^V`8;I`{VWCcc~a$#~5V+YufD4B}@tkHTo5
z8`v>DPVPQw1VJC=b>FCRl&YT#tWn`YFTt!WR86tCFhz7&Tq8S{JgRLE<Xm;POL8$Z
zgP6`&)oY-`YQZx<B(-?78d=3m5bKD^T!Bf*wI&%l8anN;Ig5G{E!`|`itM-0`jOcQ
z%mEaKInAG`moq@7{x?k)D0+oJOB|M)YdF;m3jUWG{f~`(01LGE(u>3~3I6<Y(hz7W
zHfyw0OZ`bM&0+vr&Gz}^hX1oAf4dkGfp+?_&FL`nzlI~C_c&tI%zScj+}FRRwI&IE
zLD@(h#mZkRom~KE<rx>t1^l)6?UI2uI`u+1um{AyBmF-DMB%vn^y-oLIP`Zuph~}F
z(zO*mlOI6x2XcJSP-LJsR8I=Fi~eW0-@5<Olw_)!_dn(%5OyypO7YE`8#`H~nX8Ib
z6X0!<Cd@~z|Gh0u_^l+WSL)Wq;~)NA3;}I8FAV&|u<>%`&yNiG(X-BfR{jA=1=ZW3
zH9ejKusQYVuy{G>*Z<PNe@ieBZwHMpYyj-<b8>ut(5aIOotBnXo8=)PovI|NUMPY3
z*R?Up?d>oxTvY;B5U#hJ%xvC~p^*ItvQErzljDroQR+6!5s{HhOAh@jwWI&8(_0$(
z2f(P9xFB5IbSzhz848p54^k?<!IO;40BXft1yZp9?8VvKn7<>gf?F-9sbdQb-K8;q
znlV^e9plIRUuyVor6Zg-b;f*gy?CbIAoZnQ%FJq7<nI#TL8)YFe(IJ;WAB<o+eH}t
zr2LC1Y$1@y)8Tjus*>6InSkgNbF-!h#k9Y3+CbN~(wYu8oYu;c#{vLn%jy=yVkv)L
zV}7fomN9~p#%5}xHk)uFjD7q&Fz`mNZ4*sfnPcnaP5+I2`{|D>;nlz8@jp+kn3tv&
zD=i=aV?-@=CII<lQ$4W)3yGBS4<hhE<)MKQi*`3>)9N{5m4cZ7MYV65nsegSP^|Vx
zCx7k&_;+h|Rzq!8m03rOm9jQa>hC4!LpeA)y0)#a^2f>k!2&P15?|-~Ks~gX@3G_Z
zX6Q!1fCI33=a8kkkXfwcpZ($e2vzxxOY^Y<(0(#9R)-{wP2%lqzungLbpg<1PigXZ
zeKp97Y0%6IZt`i&@<B}^8fu&@WeF~DWdHE|-@lq9`LN2=isTjpm#kyE!ZKnaKn1d7
zO6GyRo@%t#TKu1%ONGok+<sy7DBN~glB#fP%Vx8A>FYTlZ%m>4U-E8_BGYPzFEK?(
z1yuf&P9?PUVFmQ{#QrxIKByGbX7&=F-YP5t%TUWYW9nHgTRN5A5j(|Sc<@0-2rBmy
zkEuss|1mQEcjmk;fNs6{)2Dd*zbpIl703w)QOOwoa)M?lASY-zR-XT@d;as-`2jgW
zghK9rzR?3_AZuDH*H-=ZhlG<zK-R=A7fmnlhXh$Gzgbg@hhh4k9mFdF1!PU4Lc_3s
z3Gn{|^#3sojobIMt{)zb4~d=sGAP(Mzm;(<__jF5ae96uBk%R#l*{;v@w4&|MLW@u
z4(@@suwCagtZaOFJ2^i^TH9DVzISkR2;Nv*T9NQ<cwZDRfJ-cKe7ril++80sIe!qp
zTD1H3D0@MrVS<`m8S1_5*6v>eZ!L+_J2+48$>iV~*sy)Q-j7{r0EnDlTv(~wooO~z
zyY60XYCF4|hkl)w|Fg|>+Q6;Wq$jlPt3B=CSLY>l0NyhRdvovz_tbc2N)O}5W%luZ
zMQvppc#;Q4``+@*tM3?#ZcaM$YTcT|#HpqW^_b5QP$2#Lc+Vkr+H)-Nur}>2&jo2m
z%#PVFJJ8^zKi}0nGJua%sr@Mi0V+xO-zv9iEK(0@w+ho;?@Xuy_N2r*{<3N%na!J*
zx68VPt<JLc!X@!V)&ju!bY9zj#+=K6`CQ@b-;*doG<mGqbmp8|KLzkjW5%g#+ixF(
zuP3HYB>e*x(BmH2dD%7hZGp?Oy|rYpj!YU`B3qfuw#w11^%EiSU!?GY@8Nf*@|A0N
z>Ix)?vuuCt8q#-tB6BvkWh62D?R5I*QTgJ%K4fhpTP;ITR^F;M1mu(fxGP4Rg@$>t
zf59@2=-gu^H*;8KhU`r?^QHe=*OG<l4QH)9e^?8E@-e#2Q~2+T#7+`cs$;w5=~zfL
zRIZj&?Sy|tK_@d3#sdI-;X$dojty{V2I-<?m%3bRhx#vjs*(2EM|S9VJ!vK_9WYtp
zVxN6poLAf>SN=<E3($RdnzE5VRo|KZlkFzs%w+5Y`oA(gs1pl1&Gl@>Y-ytoqCiT!
zNKKzZe(En^Ko#WvQS>RB-)Lf^ekK7;I5NU$L7wd|=Mx0>OgqtPs$Oa4nW>-Y58KYa
zNWlI3H32P+x9tSi%2jM`89U%u4J@O9Jx=BiWW3<R(3NF?`)S+VeWlMUK*_v(U|Jfb
z@E_@Zq;@t*Ow_S0&1cL64AduxP%W49#{XrYKnw8Zxg{`Bt)>pB4zw((l_;PR{pGIk
z-fJVLTv|&pGxe@+r6%<bYLVi9>G&fYBr^K0T*IQEu|AFY)X1!WTQTI%5#?<GzgSr&
zs{|H>EhKQAewY6fz5>b$9dHK@rkQ@`ww;8u?@ajr7p$?oYF|(9)k&+ulk4X>C()dW
zp#FP12vu8CRt8s4=IEBTl%M$@h9)sVPl4$(TeX)5Ka5R<{?jFcc!jeZZBqJ5w~eu-
zSH?}S6H0v|4E`^=DS)=cGVc{ETP@$9bk7bef&Q7z`;>TceB_7nS#6zu|D93|<6rd=
z=mT0m94anTX`9Kfn^Ii(`RlL3QJUU))KFKpYO-=@Ca|)+68(S4Un+0u(b}^0OAP?A
zX!9Q=c|l1MPO867XB#c&EBcK89ViGGoGE!H?QSY!r%d8SAfSY@3OGTh$>6++ev8%K
zXuG{_v23zUyF4g-|Fy9)v3|>PqS3fnAlhnc$I5worR?Nph#%5?D8%vnoN;v%9VmnM
z{xbg7)#SSVCG-OPlR1HRDEhMuk739y35DI~Ixa$XfPP+YhHiCia?Nx-Qg>QDxw<1%
zZ6#;3O+lIe@`Y?*b&R~6?PLv(X7zR3Ye~+8Y^;g8bo$Gs?-2CL5}W(UgrnA5$eQxH
zUdm2YI_Je#nDh42@->)^W3+Vcht4P<glWLKZ_ak|$@d9Q>#GX^2Z!?v$9rLq^+R-S
z$EPKkf`^=**g(8r3h{nQJNotuEMbL8gQz)Ft5rs}Pemfq9T(0Ffb(_jgO4<=KU@_@
zVbOKsgP3;&UZu;%>XICu{NJ6Pie#{2nkWqUvN6`*uRiaj0wHZ$bftM8FXpz*j&<%y
zb=Ytk@cAUk3#B<mpx4H{k4M74Q?$?<dcl7@Gf<PkB1}#RDy*|Btqv1m{9cnOZ85yL
z=)ME|?E8{7j^}|dM~<_9Tg&-j_-aZ-Z9oA{1Y8qq8aL)ZDI;S_c}~<D(98-oB~2r-
ze!7fw-agQCF)-P@sqx$sFf#E;Kek-#`<9>V&o*)uXN+I}KG$)j4mw)a0m9-lFqIek
ze7?elBT36Z=XU<Cup5-C9?gTho_zxh>6{OoEkV61mx80Z0GD{dk`UYO%XOgdsQucu
zvV4{4arCQwgEr@?F6ak2mrCnMx*hM1=CMKki}F=HBuhvEUXv$tN7>S=tyYGIC4~37
zNwboYOX;eKdeI$8n)UWgXl9L8(qqQj`D0*S4w+`9tGOMQ=JjHdVe9Gh^IpD2qwal6
zz>GQ7MFEsk2KU`zx_3dN>+wB}3h5hK#6zXcxrc~aed?i3^1~KnjjS=r2YF<k*V#k#
z4EEQn&qL>UV@%RR(`z&C)FoC#CzenhEVMxrukIBCG-AbHz5oX_R%~!C@MKRrBiLF;
z2z-UW{xK^`d@tdk<vgObN=PUE{r&w!sUV4!ty=rF1h4@bZE<Dk^0iHAs*`$Pv)<#^
z+fQ#>rby}@)dWC^r=~D^8uOhjFf~!C#{|`7OUB(tsI&DGwN{uWt%p{I&a-F1%7F6v
zbca)w;|z@MbTQwk%1dNN6vPP(dID{OrxR;COS<(sbvS!io$j6`5`5cv68_RVjW*u+
zBz~O#CL~^Aa)D~@D%J1^B5qwC+=XS2`_kG<`}+;g%i{&}xeSl0OKPIp)DI=@@UyYR
z1;U8=9*?aX;b-2IlJ7T*E;Oz}%^&u#S|1eNu}zMJ*fTti9=s6%Z5wx&k*Dn^91@o2
zW5d#Knz_z)$b-ySbuI;f-B^EUj<=AB8!MVceFA{ZCj-3{xJZCR^Ja4D>@5prmvKtd
ztZqQqW2@fY!~hx>NoT+#0({JV^CJD_nfiJProTvx!)@~7vUAGg*kVSSxvR~D5#**X
z)4<!tiy;JH2X>qJe9ZA_+IWas^6XNWgW4gf;cS~rON%TCr~dP1`RS{pW1ojj_AY~Q
z4V${MtwhSJmeV~I!$+z5vnuHnvRTg;+ja(406n+aXAjH>i`SEG3Ldq}E^_ztvYn;6
zt>wT5h$ljIxUT`!5AzGp$rw85p3ANyJR}H4X`8_|DCGpSM4U-ss@%FtR3f<80^?1N
zYc0>!@5SP=O*_^idJ;9?c#3nawI$S3Dum#!rN{NdVe|xQCE79W=p*D&_ziyg$C_Q#
zif`R;A`O{f<LKy)O?CH($QebmFxPL{8`pEbHQ5z0GkVJ52@f-dGqNJbij5bwU`Wl=
zGmC8W^}%9aORo7BaShU&Q4tB+8ru0EgYDqPgrhl`pSw94F)6y8WjIcGrlb+nx;&1s
zwahYyLF+HLu|1Uuh?^_KjyVx8J6SW-y~G#V2>X|N<d;!Z-jLley>^I&GR^-))b}5F
zBem~Zn%<g1dRChjWjM;GLSJ(^Ojw!W@tDMG<hXD5%vchcYNv5M(wyz3T3EY(xXvKC
ze(-!(X14eKx^$gn{gsgG)`Uar{pNGK?|MU*(NWpaHwu#Wp#~?gPr7#c*E5XW1LyDP
z$pP>+_eTq7ZKr1^=7$q&EFJN;71Qz(!8Z=^xl(Gt`zG+~cj+cwV7=EJTZ7yK`>>B&
z$68M~b~0K|kU|)zQSO2Z`ekg(nhj|zuJpChBTp3aBE=W{l7HX;en{A^Fm}tp$>Dv;
z{so?g-&?Xsj>5wsbpifeabfMd@D!T#s3H6e(Rwp)^ZnHn;l%1r_=)(v6J}l)kwz7r
zKFyj?{2Ygj$Lp`?z}Or#Y}n5p6|H%-vCy3k7vlP^q6Ot0-mj+C$`;M-!U$<<>u>1X
zo}4b!jf+xJgZm<k$#8C?Rq?oS&+{!fSkeZ0Z5eIt#*0gAkAs1wGbAGE8GTwQ;+|t>
zC3l1_kGCI|wVKIA2!-6Yr8v}=QL_v#KZWQgsM4ulS90b78cQ3cz~<=OmELXE(7f~7
z1DH~}tm$1&%(8jN9lB&Z(nZ829Qmeb@ZQJY+0WXQbwp{nscD^Kdp{no6v(lrdSCRe
zK3F`+o%e+X(}qe}H)3@%c5|!OfOn!>u->1!Dj!u56Zg!*b9t2CO(ErA`SR^mMVG#Z
zcNmLNQ}gdSLv}3D#+kOBWc?&)bxKGgS}KUu*Lpy&p`}ob=iV!Wdu}Bua!O+kcgrcM
z&`sBar&ylS7f>)oCDma5k|e$M-j)3*`U8}?2Eu>st3duS4&7Os^VK6*bLjI3HUqL;
z+jF)lsd=e`12k-_R#-R{`7dm6isH!ExN@ru!@G?F&+EhtGP<HOxkZ{0VHq5|H&pdT
z7*&fbPdk-q3HifXyz_lyGI|#iliWd<1y#W^3V@=r7q`R5Ii}*J_;T|eB^+hLrH>r0
zY{PWvyaj3Xc0F8bIbyF5Szx=Th7n(-&If$q=^`*8Ay;1uo)@N&K}-%&#36!74WcjJ
zx}3uIuzT(|QaB+VNEfw}45ABiC=48Hdq01+RA3Dk%W;moS@&yL@8iLvlx1>AVa9k^
zoKOwjI)^`>E8%g%*w(y1Luo5~(x}PId&e?jXC-A1TAl5O5O~cOMlB9DQr&6D!`whB
zmt-0ae*>paW|kha|3#ihSGvh4_$G!Qo>o8sp(@I=u9<;4zxnODw?~0<odaXfv17ju
zEf!Jg3sk0?%@67CCZthR@)}9W;6}dF59}`JjC<F=;Bfm7Ov@nEO~1Q9-Uh8hfA*k!
zrM+e;*7h4%q9n>aBOr}3P4K+H`GP+-n@=aniq<D>R9V3@!W6^O$o>Q2SN2zbA5lb_
zv^e~g3HA`Nh4ESao2%2f$~Pg=XGqs`4}{N;hZ}2DZD4skE~G?Dtk7RuNb|8wp{MJ1
zBIil=EiXu|dq%ONDA(TnIcjH_tE0^-53NecDwfo9ofq?1kXb0t<|=L_B15x(`FzP+
zcu$njxgE(V@dRZ?9?F2pp?h3)y@aQ)d!7OrTC&58RFa-~U}+{lz)5X&VlJNI98EvA
z5_9|&sJi~<i3=#idoiNK-1tI2!yxA>j<BK;IhQMWHX=G#i_7BTuXWC}G2*jqmG1u-
zFz~)}1~3tc11yJ|akW^sn3+4Z#pE=X$S}<;joR-$f@x7R+zeeTE()`;5#)b0s2u~=
z39b=^A>$wY@_r7Kq2#{XcLLjW*eca-^oGu`LkktA1~vT_*cl-<gvc#?wYdZ}ebWAf
z_Y^u1^G>%t(b(>|@bHCrZ+q0!a}?$nQXOe>(7kS*qQf<irNhc<jqCA#7a|4P*Lfh0
zrPOd{PzLvL@#1Tw-3-$ueZ(*Kh=@jm))B9+^f?d?VMU)WyXg-+FmZ2BkzJcy<=l3u
zZg2SAVd0qGJ7)xpMiit?N;x_7=t7ay-m=S6@0lK^1nBmsG|4bgGu&%kN^6%#*JBl?
zjp<%7dJG4eJa2l#qQOk>JemP4Z9%DRHyWIfjomG5(C6z<VC#F>N1y1PRLpt~m5fW)
zL1J1}II7F>DOqNu^31F*+H)CeFKH+h?~P1wHG-v?v|I#j-jffkEB9@diO>1jaenB2
zejiS+Uq9mMW10fpw$-)ET5rVE`_{7Qwq$oj^_A$%^Oh#CXIh8D`4x)sXAdRMm9@o<
zboGrxa2Ivq8-onpbmrTb_G9jk8zKj1kw+4|%dN2?Hd?1A;kNbs_PlyiaoF?NSH`m_
zXSlF$nTuJUIhm0wqp&hn(k{BWc)Y>d!I&Lx`yG+GUWXg{2hxROr3GdKr}eSx2ds->
z!?5B5zM;(um%NB^e^&N27H!(cJV&NLrMn2(Rv><xUw`YGj5p?VdbvK^HD32*1Q&F*
zY&m{#^ynEb16R)jt9aj}irl*ja2}r348yS)NlEY$$$U!s4kCa^-#ieSxbL@IFTz}i
z#F6}_oUw?x+TeFhmSjO9(!hRruS2J+F<%`pWMw(oVx>?1BL`k1wq=8^93H=QS6ahQ
z_nmWTFO_240qfqY3DL+M42mQ5wVjxPQPV6ZgOj5!F0(c*gG<`6lBb^@acu2;=)fYx
z`6jQhYJ`jVULObYc_|=j_DV!KJgwdjSXdtE3R=`?fny>|SSp+>dl+63t7&zj?$}Xb
zu;JpCwsN+k-1TjZBLeM5fIRCg$7coKXc{S(4jn7op{Kqdbx@YmjADcX8XI5K{J-wf
zi%2M^NjV1UvS831SiV;mlcCp%RfVOPI2ha5FiIci7blxr7H00bh}eHIw#znbVcC!y
zO+xmAZY46l62%Z15w^z13=C~yn+o*s%$>+>J?!W|+x!8Ty?Q8B_hB%t+TCvK2ss<X
zm!<Ee(XvPop7C4X6H{cw>j2#EDXWqx>WtXqqh-=?I&n)XJ%zEsNUrNKSfkdo$^!Be
zY9wD)U3b3pz=1JCpv$4y=Cyp}@u}Ihz6RHm0%#@1Fngm^<X_~KE+$Xtylq+-CwW{z
zL}6aV*jX{iXluT(<n2x<Nva-o^?dd%X|F7(&n8O{Gr>`o*NCesoyRaF*TAp5O0MS*
z1_<`<cgs23b@^|3uYfA&-8dMqqVkCT@(narRr3M>XfVp6BJQf3wI>XlW>%_x-rtmX
znnWfxSJ2|FC*+UCd?XHd0Qj1~vMb@9R7Myru9+W!r^<`Ib^S6$VyW2cnvu_3edjxS
z01SsvYSH-BJWo}1CbsDvC~ij3%Ar9HMxXDhQcfb+ChV$Px%A-ZGx^9QyLDBAX%FD}
zQ*&q|p)Uxp4PfPlGYrH_cqB|GG=CzVH0p0B(P|H$e=}Nm^_Aa{K)<?s#kL^ip-D?a
zmMpWr*=!=Fa_)DN6Fx%hG&|2LA)A`Z7mJf_gKg~;TZ-*iZW7kxpadkuir2lA95iL~
z9$|~jG{0JMvSo@(p4q%EYal5ze&|Ts2VQeQ?Vvl&FbV4X^>Mdn7XOuBC7is-6%!@!
z!47p$Rvm61t7y$`xiJINVg@&^E4q1e8>wY^IwM*=LAIcBIv;pb5wrMh$J0VS$(qO~
zjYjW?_J$dbIu!y)S3h@Ai4Dv33tyA4mJRExO+0uOaySyCSbJYgd(PBpWgYVfsW3DX
z^TCM5z%a%5)Q*;4ZAY=?>ngk$U!Fx0#knW7=x*mc_qM-7Js**1pV6XmV{Rw6SPPOm
z;)oT}ded3gZwG3t9=>$FIn4v;-REL9Xca$ZADq*Z-#8$@zjbnnW2(ZK8NF4;8NH`A
zj!~q><Ajj4J7p`qsQ_XW75U2i9Hj54S2rVbZ)iM9Ry)i^;-}@vCvV5`V4+>FNyoIX
zhvat1%x3Djxt+j70auq|7C)V<O<y?tmKV=uFF_-+`s933Et^$MF_Gtkcv;fx4O}pg
zvAB5VpccfDs}l7N67sMU8K3nmmM(_AtMeGDuOw!Qa<GkN3LxblguL~NqiBed>eHsy
zPD=wE)cg(!{OIrJjiWDto&n3N(t|{Fa#x|`9bEc)Eo;X!ne4K{UebgD&<VWWAWjVz
z$e3?x2aa~j{VT#S1oG;dR?GS3WyYw9wm60qj@t<9?a}#|)%xEFDbm6wLe%>vCe^9U
z2xsZ%N*iNUrI8%;AAdeeVy)n&c+|uzXSU`W47swY&57$$ik=UX;b>s>Jl1y?`4c$J
zz(s!OOXdB%;GNKcn0RY&RzAZVZ=9yTDSZ0G53zgz%3}4=dJc)OAq=I|`_3&3>(QWx
zsnlCyzlEi~TOWIQv|qP<zB}^9Pu7L3V`CXPP-w~4r$+<(rGvHq`3F~dqru@1J@e^L
z?Xbs43~YGZMV;$Ro?bmd@etWD@u}wBPntzhF{0{tWNfm?iVgf~{-jPq5w(t1lPs4`
zqyFch@hGi6r0WsKxY(gT+7?=w=Qa;aZwHw5hZOkUErpR_o+=3GN*>;OPe@=;3|G!u
zH9Uinn@)aO^3-L6qzfPR#o)ws(M`=7D-&Q|C2#~H>|RvEdb$A|WC6c)rbl>K`@tN1
z@85DM3@1?zHD6^j49OTgX5jkVH?npkLv}(g7K&*~Sci(fSvjQFFTzYthEjm;wDHZU
z$Ax@`K2w;pofwa3K&vXVH)iF$tW6<4zSQ068X1%6ctPjLNoID?H{h?|+~3sXGr@z_
zG;q>fI!x?PShZ`M+QY#OpS#AMr0r9jgFX4V8P{MJIHU3dSDd2_VqMZa!8!ZnelQcC
zo!cEp{t@O~&%k|=8ALT@JA)^b=M^Cn_w2sdi8RJwD2kqkWNacl;!@{Cp3hf3k!f_~
z$|HQL247{(&LUn7*F7QYWr^JZG9qo3X+0pX!Oc_e=5VoV{E6H!$za#;Nr|UTIr2_6
z;;7{9-QrM?zQc_~@0(}kQp4n0p2IfF+|MGJJ@Y3Rn$-=EYKCR?RYu#EL%9ulQwGlb
zl=3b`+~6AYdoau4wVTDy<#KRC4xnG$TxJ0!2)z|ZxshY&5pO>vaEyyNa~~Lep$FG1
zl%mvdqgSiDx<0bu#P<j|my;uqK9C;Ez$8elhN+lur8IaZ3!9W@>&>`JvQ^PhWT=?2
zvQzJ<hCCGi@}5hMFj2H-96e#KbSHQo^fitqu+Q-aOY~_oJj~35dpf!B0FT7ml~M|8
z-jQ9sdCzRdx$~g&e(L8Ce+$ppl~mML1aFza#qM|?`XqfQLPIGUSs9k!6KIKpK|~I0
z+hzVXSeIfkBuSQSxrO^nls~#G9kT)MWp9duPdIt{UDaMs%g-~<SbsRVhqZSsvg`SX
z)7hm#!^C0Fshd*a@cIL_0S3k#K9Bpv87myOnQznjP5&XS5MU|wW@5(&%WoUf9*am@
zJ4P1I2cnOfQBSo!WD5X7@?ux>Wp(%SB1o|Df{BD{_sdy$1C#Wfya_@A2Y?fCQ-H)C
zZBJD0e6I~UHSV!B3xTa>*1~Eez<0j40RFrE<b9s21~w?<1nH<;x6AY$-ZKMs>~v*Z
zc>d3haYrP7D$0^mU!wva7=EhAmHu1-y!%GU+Hgj_*EuIy-+LtkOSrUrvF1!%-65jb
z_`PB5AsJkcAkQhWl*#=r$n0h7d|S1xo$DbEOg7!mQg&%X{x2kcR#I^JC6tZyP%`=9
z5jQCrQ(YeqCd3QSOP=c3M0GF&_l(EPiFBvl1Dn#`5<3{TW-b7eSq_w>#pzhQv<U`7
zAF#U2e}M>1&2$&#x0<CSBwZi+JLf<ID7i6{i$Ov1d}}X{z76?mh=x;PVs$DAS}#H?
zq4^X$q0$%W4(GDG2;nB1&FDBY2rLTAcb-ohH|CN;ND`!E8qQ;0Ep>iC`<QFEU}HMn
z{#{)@3D}sWb4e5TBO$hQ<Yg5E3w2RbfzUL1{yvCY0jI|mwQKn2p8dwW=@vLG{VH3h
zI0y-wt!e+nV8$}a)#`JntzIc(yU(%47sVb)@THhEsR@hX&A68PcvShh=`~KcZY@#9
z?d_Mhi%kY*Io2LNm~lJrr`mZDzAP2>O&gw_klHmF@+ma1OhPN7wwim5t}8lvdxxRc
zP?EUnN#2DtdQQx3b0<<g0W2}Fq_})*k4M^(U+RXw;mND-s!F)N`6icjCCYdw@6kX~
zah5e#OD;VGwK;@mA|<YDbJ*y!i9H%aWJbQ66y%8aFk)=qEBF>(f@OdSO!h8|rKCCB
z`)Dw@^vLElU+64Pn<gM%n#AOQh*7MqrTYX`ErZd(VG*Z~8kC_Lj3Ux`I6_CjYtCdP
zGcA7{^mu7G!(?%)cbIxun&`~#aI`27Y75%%oCnr1y+&6gtlB{(Nv7t0&`e?{Ph>n$
zSi`YwOK{34DQZos&F)71vOh(ET+ZOKy{#7ujZg?z9%n6Ix-F(}wLF#zsh{0ZAH4q1
zzA+f8{w=IV<qk8$B&WHlZu|6_dv}D{c|OUC-e*AR3Nx=;f)A6SQAduNn^)n<B^pAC
zBI1>3g4-T3F)*fb=(5!N;g+bY@F0qK;$a6*Uzo@~lyLB-$piyNBrQ{PiV}(>@Ig+r
z8j0`eetSK?4X@=}O6)R(rL<#(-i5{DU~Us}QR783pMeh@G~U?!<jeE|3P~i&4po}G
zK+<6bQFNwtJTn)cp2({p40S{sN=mP<V-&n?-}{=~%!MW=U*488Hw@B-7f+BBfXuDF
zcT@&E4WL@Cvgxx`>$XRf%$Q9VDK3M@Si(wQ_c^>YmaL@ilkQB;&MJA43HHt&9TiJ)
z{zPzdcrM=TTBYsvNxs!iO9W$}GWm>JR>S8+ZKzyndwks=<AulgUmJ)ovq=ro*$A4v
zWLJ_umU8!Oz5z5~rH~fJQV7=HQ_pcS$^EJuw3*CtKhL05v6eTss6D-zcg59UTjv`u
z7dlwX2h!x~Fov*@a*n?Epr5^7r03z`%b+vgkL6Tss9bO1CR%WD<Fd-vV0FZ!lub*$
zc#Pt{f^0J+Qs=MM(v~^}J`Z)c7dBeK((QeXsqzO~2u!uPyO0{?MvE!?s&^5`;rQ!N
zJ9%%k{iN-f%S7=1u=kchaXnAiC~P2Da7%DVa1HJdNFc$T;2L}(xGoZc2S{*tcU@c(
zEV#S7yZd{H{oc>FZr%IkUqx*dXU{n^J>4_i^YqiR=d?xNq9&&6c26hahBge-@2O+v
zPxHb(&P$2b7IKT&d3}}ZQ(L#gsiTd!m%=DEJr+Vvkm7{gOXR<Mzkc^)gCLf7yxWBL
zE<xtT#*zk|3&)2|&Ve|x?{yaD)oSri@GG)4xBm02{4x`F8p}al;Ea=&ma4OeNcrru
z^M=Oyv91;NfOLki;B43U6(m!W(RE7~JtRFz#o?Y$U-_$(8+)R<i7K1Jo03>#6Ej97
z08>0TUm+C6!-1ylaNx__!Wcd?29tEgdz?39pDgM<S~}p>`sRbBA)VsLz2%cX%wT79
z-_&ziwB;j_NN-!4x}p}tuIE6`NYDNhW=QL90cy2iG}<U&&J@WT8Gsad(!8KMTk}#6
z@grXha0;SQN7f<%ltzVmnB=v}T=cjIg_KG{yp-#Eyr<7@IKCgL8k}g~s^6zwV&Ld-
zS~$#RUjCSfq7pK%v*})=nk<`gDC`~IdYp&0^#M2^tC;m7YEZ-?w#tAMH@XD{fzbi2
zZH=nw>s)-i^BM|u9IN<o34x)yUQL7Ah}m_EICHgWrWjBbN2`ql<RxRs<hClLGX~Hf
zl9v<e52U`nvm|IC7*9d-Z=QIe0Q2jx!<d=o*}v?k1tmbH(NF^`{5qlYAsY?c#Jw#W
znpAle)j(0A4O$*Y_+0E>s7m>p$uKPfl-)r`B2I9;m@s~7zZioLH}rl;Wmdcq?oJ1P
zQ{nk9C0hamyd0%jQRQz!72qKT0dyYd+kB$`F1_~zF2OI*=Kq%v1>Pm2p^>2+^4}!}
zVW3^mL4@*OVT9qPC;<8p;}G3H`k62s-b0ZYtWy`=-{dtJ2n@(PhG!c2{J%>m04EU&
z!~fw=>K`BgctH_2*i=y8k`gEKUwpe$z0W%*W}d3MPD-?du$A7QC<2%@Wc}dd`U1=&
zJ|ivfDP^ob0!*MiRM3qNZ${sPLWAvYt!{2Rvq>ghr)P(cE#3qM;RB9%K#C3GIDe2e
z%Qg4Xdrw^a_WlO{*2=BH!!AIxAzr(}_1KYl<&2Svg(oFF-SHMReIeq$L-X{VmeDZ-
z)4(wnc6o=B?2gwOtw7KpA+#s~(O>lnUY;+%menEhtKzr2Y4&sY6wQ{;ksW$_xtZ*4
zv%WFFcGh%oIUMR?aXva<cO6x=x3ll+*3t}QTgA_8ysWAX0-2rc?5;Y{liV)@^wh@Z
zKkm)xn5gfG?}awXe<&h5KA9IBxsPAz;1W99yM;gRmuYAvD_2rFj>w$E{e9Hx0Oc?F
z*Y?20LbqMf4oq2U33G+T$w_*I3Jc`H0#HD{bI5#??V_*ta-_~o<*+OyZDe4@6>?hK
z*KjSsb_pJapF7^8YYOiC5iaCzVj+{O9{51xeozY|P|;cV3Z9kNroZkApZUzvWwGz>
zmG_hBuP>xXlj^RC`GWDWOBriEd^a#KD?Be#EqUv56-nJw+2)~-zd&NCQtth%j0VHB
zVZYV~?2xT<<A!n3JXg2hyZZ9`8IVvGy58j1{!5riu?0wD9Qi}rRtJ@ZM$b3}mEVsg
zbQ-jjRM7GAI_x(ZpGQ_5<X4rKyH1~z3Vm#<QR{I(EIvO{{em@iD^wU55(4B}aCy#x
zc>2N-1V`3+0>1l-;2AnDORcvBVbj;+TfUXd=a(;Sw%&u>*T36qa9q1HiQ6@(asCJ_
z6H|K@ZWf<JO@A{&)X4`nRozSSAq%`anh77C6VxQ#@IEu{egjr(?+}VcCcbz!Y(7xt
zb{X)jYy?rOs3P#wQmxrkBj>?{uW50U-hQE@b0fF&+P600<Y1HZLi=|MKMf>l&(VjL
zYtxrc4*NqtZQkD&->q^l7ZwYh7rDBw*Ri4#>?-}G*gS^gWgT`n`i73m<vZQCN8RLp
z^s}Y&kbt<pNB^AB5s%uv?2EOnKmgbaokuXB>>674kwHws@17bKO@e_bvHH$;cD&vp
zn)oCWVcRA2R!x08KH)I0TY=6PLoK(tTjv`NBHw5lBh&uH?fs7*nPbkZC?}-%2^~9)
zhtecan1LaMP2F&Jkc}O?y)i&-6%#LR#{0tbah=d3w5J}6`GxGuP$Hy}`#)SKfQnqp
zJ$$w@uErrrBFa59%}a8DA*klx?QNPrwlW;#99TAAfSW~G-?^mlBRhF%<Pg#%&uY+7
zJLe}DgZC`GLnS%0z$B<8M*_a_pr*o;d-%11{VNBfn~@c1W;!iZ>FGf+1S`pB@bvfn
ziYP6%*9e)7swZLBdh{eUG3%1p7QJ|S^c(|7e;0+vphVlL5VTNIH!>d4P32PN6`cZj
zx3Vsu?(~*wW%{)|Bx8*u#eiaWa44?mnd;>Cs2e}hgs&_$*g>W*&P+24)j8Ctj%071
z^2ViebIzgSazACn5xiA8nvOXnAQB*YKApUdG!eq-|1SP4OV9{23gSAh^Awlw@cu<d
z=-0VrD$vM?37B1AUEbl~iYv7J@{DDUoNp^@d*|6-I*J#VYT(=Ipf&CS91$@UmwzOm
z?W?eHR^V*>vSD!&CXYPph*HPt^Z4nPx3gN|?sKhE6paLEOS+4p@2abFq8(g<XK*4;
zP8C(G4hg`dPd5+Sm!1qyG<V9`u`lDf2QDx^ZMhU$yCJzQ*L%g)@D<;e60Lr82c?Bk
zACHZ;`bL#hBK^6oKX5FDzT=MTq@?4m(o2>_QB@}|YiCF5Mry0PAT<Un^`5Wq)yhWb
zeu&trg-tGppe@_jzVx_1dg^pop#OWO^x=5*@qig(Go$O~c#7J-qwt07H}xmcOQqYi
ziREvIe1qt>n=n`sNfg`Ip9hI7yE8ynns$qp=P!fxQgz(*t3UfCcc2VC79X;;=^#Wd
zsd29+|6(Y=P(5Ky6A*~p%6LQb@m!z?CVt()>eefFy1P9sU&K3lR5_6$AXHGLb2A`E
zV&OZ_GVp^D&QZ55T+Ddz)Y&&8jftf(7SNbqe3m%IAcfzwo&;r3q6UfdeiLyci@s(y
zKlTA+IeJM2ToHFr+a8-Qs)qoHo9GU?^|p1KZ6Ud=mKKy*iLj^@zZ?YkxVEvKJ?>YQ
zB?|fH=ng=xs)eX$Lu&7F_lw@+;c?sb&I0~_uD2X>V@8V575W2@#t(CR$9LcS)D}<o
zklwPrt1s$y=eh!0@l~d?bA*jesM|@xdwyx=!We$1H-+L4AlpdPS29QjIkB=z(+!^^
z31OpCR2tg{hV2`V*_+EZQfoxu`uH!2H@MIx>7@64%+RMQ$aIBET_e)6N`1^|a8f$y
zR_Y-`zZtw10$ymm;7ohg#R?8<G>J^ZZ%o;j35pZgD)%(zbX}{)t5>o*ZckAB-C5!F
z-Dq4WdZmQY`js;077tSWUR0aKPvs0;EEaU3etdO2x0B3Hj61q<-&VE8*~RHdp;Btz
z^v%U)-s-1Se0<R_DxPo$BEV|dK6hzw_qZKNqb@!10*>6hNWU+Qi;a&=3u&~948=|S
za%Gy4VfK;!dfur_>GGlkv_DNRo&NUE?0wJXMKb?beYeym8=PHLH!P%9h$-)K5U6kG
zw)3)`8OLG0IBfuH@w@yqWW6rynw^qDWJC!*P5-+9GKJBTG@)?tBkD?k*~8RJ6z%EQ
z6_rPAgR1?C_2igtOd}n?8k<Bq@oPHiA6=EGfNp0ag{Vu8KvR!@hFq5j%uDWvCQVAc
zR1`q!S0Q{V%O}6FLE9JOO-m8+?p~~zKK@_`&mF@?#7iC%8~L+1<yKWko95}_9EzCL
z2|#~R7`dauT-hnhwVWDsUCsA>m$${_?yYANy1+ik%ls#Pm?a<J$qwfFdPq^RQ|)AZ
zGX>!fpzIwx(LPJmmPtle_|VZ7M2#-kO#fnN9a)UYz=hkcg0bMW?2Co<!_%SfO;Xy2
z>z_gC6z!d9qf#b}owJM2_q0Dxuf9BFe6dN{B8boZ_S=o>&Ckx>j}5Bs=iIJpv(mSZ
zy^U3Y0Q1)$uT%<fkY&=VD}qrIlAz>GLZtNAl9js899?hn9DY1<-RY+$VOSVWTcoV*
zgp_)Zf1KfeLM^~X>Vy7qab4g>?&_QrSzGtjxC{JH^iwevS+}tUGUF`&iv|SE3Z#5%
z>`Tt^jh}NO9p=H|DAx;*+<wqsfk*s>%469|i^Z#(m%25@vZGEtjHJx(81r%d($u|p
z5DVO8r->vO!+a7o5D=WOZptfvS}cY+&M{HAQ!tZE5Y9yqwSIr)={PYJM%m}*p<3a1
z%xE1I#8sPkByjruuJ8oubBB->2`;ILM2%R-Tzt#5m-x5K`*U<BBqGbNZK|}*2xSu5
z&!fBJ79Hs#WDQW!kUtzTK!%AO*SmFW@-J!HoKB-6>Xj#`pI?f!EZ@KEo7lZONTepM
zwW9gh`Wb<k3eKpQ89LH^*F78;N#QJMyBnSq`OIGA*T613!C2_*R@SHik}7v|T|qIr
zpGj@c`7DrzvZR(KSLzr{<9b`O_CK^06TIkH4fu|{u(2(QZ#i+j`0kt@lD|NFD4D*d
z5B#tNy22YF=D4puvFCAl%>ZSvQZs*$5sx>9<k~PfR6jV$^)0DVFlpw`2&S8rSh+?n
zmJpfw*{frkuV8;RB%&aNw}13JMPA~PU1-Y&b|YNi(*}st=Serye(kQQ{;k1I%fzSx
zsj+nU;vdiJwC#`f1@VF;vCz;ip0qF}N73;^W7+H1wM^r7>18LvV_L8-f8L^K$0XFN
zX<K~5aq2Z^bKS;$idWTqPZJSP5ib7Tm!x4~JR^4W!@OT}KOqwW+cDSGfp`8_!7YFd
z*;?F+CaY|4Qjh$%k^`u0<+Hd8DXnqRJUwZf?Op`u+akrrZLT~gCAgBZMx}?;(L!{|
z3Wss|vvXOEWpvvnErz9;6P)BK)baAu`07PNH1U}-7=kvQ;R;VNB<WOsQtV^t<zyl6
zWjOLQvkA(VeoOmK#eD5!tkVF)yV$c`Wt4=p1eresPhkx>nc~{5E+0Zw^(ml!Nd5g%
zAzVehI2C=6KlK`&Wo*%?Ch}{PHN@pij^ri_eL!_D;zgDJGN`>qF*o*i3uUU`Svs~%
z<`sT(`?Gohaq|X^7f^M?$el!7ND%v9#SaJERUL7R=`x!N@9#<Y@Cj5(@E)9)@VQQ%
z%{htBlNb;|tWu^?MgOb7u)y)ci^5aAJK5Naq*v9t857fsWc}x9C`vRz(abXwO<Q@Z
zT|F6vZo6eZp>xJmo7w;E-72JYPj#>Xt}OJ5T6ek#_dnt>87Lf%_mJ#IpA3qTl+7^n
ze=?YaHgDEMHeKKus0a>=J-bz5FfBGx`d6dmiTE0n?=g>%S-DhU>cc*k|KneeW+?^|
zV>uh!M+@`5as0bV!9q3Am!?n12F_MZB#qDf`d|0#f`prJRkKln)qZ@~P@{?<yWk(a
z`6-qzxFS&&sbZ<(kU@l=BquKPzXvO%bVv6`>}}O;rr3wqTK^t(0w@5>EBw~mp~tk>
zl#jWoFp)s{KjL#C=0bS-tu3R#M}ScMxNi8E@iMh=G#vS%Z2#9E_cEMJQB4*HXqN{}
zjexLgF>D^3_<w!f4HRziO*Ym3x?%I#Q2z9>n8x#*Pyck<N98r<Q2uNVFA<uUxSU`7
zomwFNlrH~YSwQV;GU;+HTW~yH<yOVZNe8!GdvIKK*}vys>*B&q&GZ^wRc%*fc3_^J
zKHa2?`@a~|6=E<RS-rCsMyk^?gqb8djtxm~O$wEB|8cmzR<W9c)w;VD2@*KRJY|c)
z_NY!Z%9Q_=G#SS>ciN8^eh9q-?#R2mSct<Gc;^x|U1#yPaBcU+N1M~pUFI(Yd8gdq
z2#8y6rJJrj-?pUsKYnz=8_=!odPp&3u9iV3emE-W1!T^rvWKZCsIu$d&VE80#LcLh
z<fs>XRorhnJ^8L($HV&u%AwK}`0vL*Ohk0C6Qb;S!7Nj7aMF1af3{%2c=R#+Dl^!r
zkiR7aE%k7|e)g}LLrzrJmMHR+53I{d<ieDi)wU7w*D!>y;hc_iZJ{=&K;7rGxSaA*
zjg?TH<7Q1>dEh?=IR@}k1Q}JXnzplRZkW2|+O^-WeXiHf&XOR|@%<_lO1i%*D9{ZG
zSRxL=$4#dD5wiucoXewpJbGQ=^CS7z?0>~D0RAHE8JdwTYq_^uDK{qd#v*Ol=<yD*
z)|BfW4^egOj=cVVb1NnkCS<C!ay&6%KAHJC&lX%XY!sCY)GpMC``OH@%%c51Uf^K>
zSYgLRWs7CzCuS0eE!wsw?6P~=#|kt`*Kq#fDJ9&nc%riX`^hAl4V`;&u{Fdp({khC
z%MC4(4fLuGp`rN2FW&t&ZQzr;9PVKBN;OeP`o3ri4{>^>f=4llaaXHmhEH%W@nHY8
zU_!Y3-zedAN`$b7BiE(z=DzbxWpA=7y?SY+j7Gq->}=C{jrqGX*X+$hpF<h$g!<uO
zYbN)tND2cY<Uh4z%~6<dnegv_=%KqV#j3e^IED&0Rn?VOb>!kS-F6r?WP>e}l*G8U
z3@kxiG=IUN0We7GBY&NiXqn7^KobBeN%#KilQ10g0kLAtd6E0?F){!I8F~DF%^(z@
z+HCrhL|EW|3lQ)U@c&-&|Jj&i+&4A2hL*0-9q_qZIm$K}wI7$kxLV*n6~gfjMrE*g
zzbp-hJfV-B#$cf`8QC26{DbO6XvzJ;>@7<74fc_rygv>_JmQNo2MVyrXIQVWrw&{U
zK{^w2l>$H<+s<io-op~wC@>5_KD8W>s~JW6tuctwEU)tX*hG;=)z%14vf}PlZ!W&_
zYZzEK3}N5{5xnyVk<1eY1bhg?fIdTEcmwDte*X{r%X#+aJ`7<p7+4Vvn8eq(m=DhZ
z4+DWIhHy$32%n3Si?c3XLnB_}%8{#RYwYaxD~{w?)BKgmxu$iaDcf?k@^ZE-$5-*`
z?|(hV4>ZFs!Qd@C37WNZ-2Kr$b(KZcHRq6z>-Xbg9zVU;YK!zk^{P*ekMmu&yt`k?
z8{jcAEE7jw;uk=R3ZOvqbv{DH0P{!0II~RC4H)P@P&H%Vf5}5dBWw~+M)iiArO5Ns
z)MQ`VDaznal}L{${Pie&2jv>y5mcb_Ims}_yj$bh6*Nk)l+fYzF?)E8Q^FK4VdbzH
zmD{8=UqmuFYS<!%B1NmAs1o?Tg3Tgt7%Yu~f*B~3<PDemuco>%$toh3dsHx<l6`c)
zUGfQ17NXy(Sk$D>h}cw03Vj&RkAS2LwO^3O<%Ii>{AIZxk3-qax4)0ZB0mR)*b5nB
z3bf0er$z5|oH*yr0kRlgGjhBIQNMe%!;|*~1_b+X!w!3%CNnH*d7+<!{>Yw}%+JUw
z!XNB_zT~W7_ectz5ab)KP%JDgf(L#&)HReyS~2-+Yq5MI{m>EIyU~Es66IiRAbH-9
zC)iT-^XQkVMUgP3e3$g~;Ha2O+^wsJgM1oeg+u*^88KVLxMoGZ$74}78Ou=sO$;y#
zn{1yiV1qJIo^U`pxTfc-TvMy{3VkjoFSXc=$C=RV+f_vEP%`UEUjaHwF$HN3k5!Ol
zH$-Cp6e`Gk2^GQCkV=1DZEQL&SL{c66=Al@>xE1X$PSALh_>+}@4c1R&HmHba(11W
zr}4oBg*)0rON`2ww%HB1S;vSb=Mz)4C)E8%4Bjvx4!ngElVHB+EO@f7LVG)L@q@`j
zaX3~oT+db}^&Ll2IXOJaWS^*!P?@ips$X`~WNzA(Ghx@4)KpfE+OXd4ShzYE8R=OX
zSz4+*FJ4s*Wu)+I#(_r!E4CUBBR(N7F^AT-;;EXuTXH&@5WcLWjZ8@1s4Mw|26k!s
zT&BLRZ^u<+)j!~U$jO!7rd}9?Jl2h3%NxF{5pxOXf(@7)y}S`?a8zHdogCB^?n)$h
zvh@><IFHjEy!EW^Fd`^UH-k}X9SxmdeM^$BGTP&-s8s{Z!|0T&urN;eZa}3nPBHl%
zlF7tQ&s5vDb2x#_H=$S4`7f)~Y^F1=KHFgA<OokvYtnTIS7PMUdluQ!)r36n@DJO5
zcCvP&RIiiR#6nfcgvt-GgcuCFDsY%k(1pT)#5@O#Xkvs@hCnX+!kwq|LR3*R&AC=G
z0lRL-)#CKmTLly1mdA@Mq+U~qA6+Uqwcd%EF{PlyoMiV9zV$`{>uHTgQkQNDd^om^
z)>g@SpS6%=ZSIf9ZR-xXPXZ-3XdchMjPny-1;#OQpMuW68QMHqiIPqnmc9(x-`VQv
zk?J!{Up*EIF|7L}davpzsNHBqdvBIE)X7FXe-yoow$|{(>}~tgcuQEdxMYol@fLxZ
z?vas5e5S3a=@Zr9+zGaIW^JhJoOr7n90sDg=K!AFx%{OO(#BV}t(mL4nc~twQu5Nq
zR0Q*#1ohEgUspUw)Ot2MaGLB=%v&Ma;+w6R+Txs&y_6mk|2^sfE%-)@!VpFDzTV!1
z{pw<ZVbxkfJyWmy{OdE!wdWZ1Fimsc9m!EmB0NckflB+@klsf83i?SC93xxX?(=Hq
zS&N(}+2eX2s%eSQPWJ}Cq)}Z&CT(N|X5w)-nL9XJAKdq*>Cr`&-nOb|Cd9@@ktl3S
zzRjIJ>Q#EJaw;V_ruY#;nUCUzsy4w<Wo&Axo1x-!&eY%Uz{$Rnb!Fll+{4J&gQhuH
zRR4nF3s|8rzdpu;VT>uz6b^$%T=(F9tt%Hn;}wio0*H5R8|mqcN9f<P05Bz3x(IBi
zv-@$x?e<e3Px@%2$KPzqCGwvdsSMJD#1{Sh{3*ohKo-epL9(jCWqrwa{Zq*XZDmlM
z5rpS`=n8i{%%DkTSlY)C;>6RSB!9P;r{reVLlQso$epp`)#Q1UFEz*OO({Gyy9+)l
zL6_E!>d&p<jkcwLW$qHN<D=e53J^BNK&q;0qSn*O7lnH$;4Us@LL)_RcxflQR<U94
zQ@UZ8m?VvSte&GzBp;qzd9*QQ>&~=_yk{Y-+jNxXE(^VIKSn4`0`&<*g2sapR-|~&
zK0}j)T-)f4LSv?U%+>8x2qBZ>3<ZNT7gq4k9@QG@Q30!t6fpN<rz}vs@=$1IF511a
z-rH-z;`wD565G*gv=di85{=YKnJTIyVmFCiFJoyilL(zScrrVgDJH+UGv&*pocCn>
z{PYYVxRdgD=`0%iqF9}}edoZ;N=%Zjb~93)K(S(-Ef@x*h_k@+d$o{~Cga$k(SBmD
z$(((LtlgNCYF@(1^nsABG!~i=#B@M<vr}=r9q){#p=rTfrA2_NY|sPULCTc9UN+43
zleRG0PCP~Zpm_WZ2@WHs2qqO=duKuHMT=-6M_r=~k3yUTIi#s^<FU1K89X<65-hpN
zB&owO#$<7!GD63T5^GJN@W|j1aqH@|-Ig0=y%R2OqNc7T=YIP8ux+#iHXHpQNtIr<
zK56tBUKBFVW;l3m0p3?qfg&k%Ac+?QK1ZnVlnC}qttyr0WVB$zg#2J_XbptacbTLx
z<}3>~mZ5K7eS!m<nzK^<b!|^Kl0sau_|j^<rqmn8y&-{U`PkZ~=e73Zwzmn;)w+<6
zs^5xHN5Pbhbf(S9=VcpbY8+~aSK+l8?bDwVd3m>g9%I77A>)!&;C4waB1SN#JU4fX
zjSgwd?N61~=F6l!eQ}#d$@x83CHI+#PHu2xyufLpexQQCXt4(D8Pj><C#9Yt;*_iO
z&+8eY@C>(|A++iOhnnmH&W5UG71dN`lG6~Cy-Z%ZW1dP5(osD7kjoekk^Z$&MuI7m
zEih%?&4=#e&c|1D%*hbjIqTk=O8s|m7*EAL2RK7WwkhPuVX?=Tc<q@oh&Ek$(wVDU
zvoXUljki!0B@R~KqLzHn?1~~#bXixpCa~m^%iQ$(AX5!=;jmK;b#`*Kb(l`N1>EJ<
zrz)@#v052p+&Vz38xfi-Yc*(@qH3NIqS#&{^Lf<wIAcP7tAiJjjO7cU?5B)TZ&JcQ
zyjNyYZ6q9nnYy{M4in|owi5EOZ}DfZKMmRu=9y(C%_|kAk*D=gKiV!e>+I^L<{3^(
z=MzgD$cjme$?TmBirs9xtQl#=V@{E82qJtg6xwECSP)P>hmSQW?=w~R%7(CUz<F`0
zy{HEEOXpAw;6br*$SR~U!qYHfJ_&EJorFK9%!@5cl%b{bw>vo~364ljp&bzfhZE2Z
zhmQ_52CM<X;}xf6@odvMO$Llza^B^z<O}t+fxEzm*mmLhhM~c|F8vNvl7VYZMV};f
zxYsokZGtJBm)NcA2@Ubn%KNjqX5z&n?;VVb+p7R4Spt(<sH+<&p7Iu!SabPU?M#fl
zCu_!_KOmdqcx5ugIY80IE3jwqLdWb@xnZt5?(vNdz5R|H7v2*KE!O#qyq6_3^Pooa
z@ibL)=_~O?hDecpM&fGP51N!(2(JmQ4p9Zr7{Y-#P}j{1_WqjC<52_<X}}|8P;r9k
z?PC~=yh$8%<UUX-7tkfUxGS#G`@F!;E1#uNdC?xlF76%F7v?M|!!MbO)X9<&_k!88
zTd`s10}cikr(%)$h<S0D>X#<zUbnQ<1g1X47u~?bss`3QYj`zMuUtfv9$Jp?8($_`
zJNzWfQ_S}2BBbqq9!F(YV73qD>oi|P&&d{xmsSs|p{iO+3i#!RLu=95(^1u5PA&)f
zP7O@e){#esL-fZjXgCr~MH{oDVsK-D5PJy-(Ay>zSV3=)OmGa(6|Ne-<{GyK=5@U8
zRwf&`e(LsSYgfUna)0{Mnxh77s&NlE_gU_;SuOR8Q`Y;7)ECbPr6DCj&@^TCqUcfz
z9rA~ew5Gk&+Z-2HETtVp@Vc`a!s=|pf)n_~xOr>R#(54QFDi<3$9Hv>BU;cRiyl)P
zai(z_{}e_~nZaJEr)Khp>V50GHIwgK$5(MJZg5-V&2KdXuD+?Tza_gq>!iV6am6#=
zckguAr^q+q7c-SL&}uYZ!r#sBXycKcVbM^M8yIz6TW&_8j4Zq>&j_sXW6~h1*5^Ul
zAj-MRK!a}T{cv%MGm9^$+G3qQ4RRp~Kz`Tz-X*NF`Dj^yyym?bvJ_K05#SBqdJd>y
zFtky~`Fo<ZOd7}_!>NlQ%#QSm2k3FSkbYxwI`VmhI!A+iA@P>cp(l1~jOU(B@Z{6r
z$id=tPT!LvtJ7JB6o3__-=q3A^;nTKCzY{lair$-w(fWh2+}ua4YgfTLu5E#G(KjE
zS3>8MDT+~7w|Th+xI1eQZPQR2_)8e3u&xvknWHkiqLu|fEy1lgmSE0JNL(%C6)7Y@
z+GqP~F;*G+)}!sO9<Y>oUnD0ZtXPxu;%g&Ejzf+4yh$&=sjFkMt?t`>oeZ?x7qB0@
zK4L0=|JmX0(>|vL8%wUX%&gqmBe@7-+?ifz&*vgK_F=%?HY>qBCWXmTVB`#h0lkAI
z_GZ(rHjPr9Q{Wz6)af5p;2p*$VWo&u>rRqG>H<rkBO{#MP-LZ7CAqZ2<Br=cXV@08
z)uHiL=5*Ke*<<xTo!&{>)to8kUSQAf8|v%tjly_;&d_Hr#~7(fP+LV-`-RzM^V9XY
zSz%g7G$NzD)*?;m<f*D{ShhZgxOXnq^kl|VEvubbXlu6Su1~BOj8_;C3{rZR^T3JW
z`&%LP)Z77~H#G8mE5|UF_kg*#KjbX$$k4Qr$3^(v);4r$)n4yzD>lSxcI47EIt{-w
zd#pa)uDT}kTx~M89VacWmHD)mr7HKQ`5HcZ>fB@lOE%Fay^ev_ReBzs$QFEd;B4SR
zmjdfy8wYOYY9hjSn$s=DicX9y@qEqd>PkKWhX!`{Ed5Be@i9g1w3M(&GR0Z9Q)598
zA`ZE*3B5=pD<;irvPR01uW7@`qiwe4_(SN6ra`JE+BXz~h6;m-;g3tx%EQZDPAno!
zIKE`FRJgx%nedo_VN55Ag)A<-j;pO^$;K3$PlP+98u{FNw|&gYStu7-U-;fsmgm%N
zs$2<YRVF#8kAM(aXOT{=@)Xhygt9c!p7Sk3Ig=QmW#kL(PwbX8NvHPp<49dA;kp7q
z>rk^KYZuj0DG%1Xd~&W}AyijJEitdg;wAagotZU_@z`R`)j9)Fa%E!?HYn=>Tt%^A
zHk#XO7_T(=85F9(Ig-`qp3Of&tI5g8=bHs(T^@u+W#T6T)hj&|Ycy56T5+mfMA;uX
zRLD7=e=wuxZQ}VsrSwvnIei7Q%McfEkZQUSI?La<+5-{E77!!&oz^TG=1A>lV@O=r
z>IwwYcO_{1BK4l3gx*K)@eD}L;9^5$^Sb9giw#EMrBPQKGH0opn8bcLgsyBIZV(4B
z(zX!6Wl;iq^C<r5H@YUUTA$g46t@iU?Q+KlDhq~?1BnsNnASXwG~K9Pp1yqM!<mmC
zx)z<TTD%r)DWMAlsd(4>xV=RgVL2fEB<Y-wl;iwrEUrOrK`@|jAhwVm3m?LukrM_8
zbkY&<mMKjpTJg!pZ4!_CoUc&kE;GE^`DK%))$|5Nb}Rxz!vgO%a*YVOwq`wRY+uEj
z6_Mv%ZUnRrx=tz*rq$tvMM}+n&DAoi>w&}>y)>o>v2?A~njO#O6LfVX&%t)EDc^fK
z!0OU9cf%y$k*;c=?f;5Ynm59ib8#jp@90gcaneRqv{K-!wqpUn$mj?5?0oCe8z;8p
zctNPx1LV%Ds?Ht=_Cx~JT>HyM9eyK^$XK<Nbfb$?bFoOm^{lLKOtm1S^Bg?x@^7M3
z^61p?qSFGInoLN$#8Y@cGyVe!jaiw>IR0XikF|mgw+cUJbK%E^`pB5Xh=(3^)gVy@
zCP=Cnm&#$qw<?X^@O2{ocoQuo68Rn;7ES?}nYj!-uT%KFW?~uh!urfm?HMmkdgb(o
zPp{7cYIba}`gi-a6Rdt=JYtv&aZve@_Xu7{$Qxm_>+tK7KISk|s$=_VQyd2bxjQxr
zP0DiJP7Ll_baAn6(_vQc)*f&T#4ilOCWNsexR^0tJhA#q`dtRz#w2|x4(jUV3u!Nw
zNUC~q2@QiNH(D|NzW)he7=(dAKA17}o|cHC&o9JjsvI2`*AVGt93nT|#TtmiNq-?n
zpWv&renk+vUp+-+FVP<pD&>+l$_k<x_(!VYJfKo!RWPZHT)+?X$;Eh*nCZNqY{M&P
ztzj9u{uWq>m-)~;dmsoJEmbvDGyxHq67G(ERkWgMu~6Ix(E(rf0+<d*cCo2xCj3cY
z>cZal5g76oi^#eB93l|nh$P^1itjQwz9VmJ=DJ3&+e2SQ;4$pbofdATmdMFIARyep
zUc?$2@um4ANWvm|R~wO{YSVCUZdI<hg|JBVJ;4L`^aW<0q)<v#4igRvf6^{1u;_5D
zSb3L^`AVw;TG2fGDQ}c{<S{H<9GS3*xd`)c`vIIw@m)Rlj;JFFID0AX@kA7!5efv|
zC{;S;<Aca1K$`=z;;ZINDI3tzQhPno``xYN!a~bV)Uo{5(<nwQlWbL^O+3{l_0BsB
zG@uJ5fE_>|4<o{n$;sFSg%Jq-!iAKv7Jfv~oj$gIMdk-%O^1LL^Z*QU;4JJ75;)LF
zi~NE8t^oMx0Xsu{7;oU3834KE>tzqU`2Ft#xRzSz4v`4@^(`<azCf7tzZd*(417Vh
zqZW$SD-zq0%Y~z(XStCo#)bAa99QR4>YCGMQ<odhe;XoTjm?OlAj#RxRmp8)?x)fW
zOqFOvJ9|PSyiP1})k}Gp5{xd94%x%BE`&VYR*rpDcV|{pLawQ|!}vc9c?RD<`D2<?
z%qdFeQ1d#jnGu)k;MulaC$7uhC#w3CA{sd3cSrYqHwzx&qrTe$QDT3L`xAWazPrx3
zca<YL5uFpCcTlpsiMhu<=F-$ch(54e|Al?WBsGuu?aA52&z+?+%Cc2#{-}&ChSb<E
zUDzQ_@IFB44|qDu`-SH3g>`#LOJAo)L^Q5TN&DQEn`{N`4w!ym{kcaD)2l7BF!bKt
zu5cQNQn07e6w~H!*Vw1JIsd`zrEppHd3MPCrq4@*E3->j|GZyHS@@AGGTW+Z>dwHJ
z`x$NfMAyC%)c+Tf|FG5bx0yB&O3?Lk4y5C#c;iUIe^bdns{ibd2oJ!0ExV8lzHoq0
zrY|&>dA>gpfzp8~{_iaR0mo~;TYS6zLqe9ex*j;S^>%bR=i=4xVFD&S`GBBxf!0!R
zB&82@qtzs!Ft061`1#){zXf9Rxb%?V3wp0&a=nLRS(f7>q$u>KZA2|$>UXCkeG2Xp
zNMJMBO~>~UX&qvJAKe6HqCz7vr>6S(M^ElDZvT#yDlDqZ?ZtiMK(&I%bopl}R&AK{
zpTtG89o&?Vfcg(#NhGikB=vJt$zM$g>(YUC71CrDQwwjqN{9CHVkCr0<^S}<q*mCt
zQ2EB&0R<h*A78k6{c>0QmwYL(pk3^aAj=Pjso=^HE`FTdHvq=_OR1j1fz7!;9?2f2
z?&4Uzdb_D+^nhjqUkVq(1$yi%0u5=o5t@yzvI8slFOfhvCfjAuPaeqV;29sekLU{g
ze-x-BoN}@KJrEs?tDAxR@AavmU775GBV{L`?MU;fz`fU9zdHrvWr||ghp*+mB&spU
zm;!{5zw<CaXFo$9+p$Xj$?13<zynR~E{UVG?8B@7?i`S7Kq;_3H(3yPd-}(&QZPaG
zPAlTic>~4%rF+_taok-hCbks++3>&<z_+kn#j5<dM|c5fteNlY)-OK~NX-UpP<uCw
z)dT+6ofis#>+cKa0nqa=k$N!zhnk*jO8G}<I3{5el=?@xK=}P@K-on-2gbg*XGQ)Q
z0E}wDe;=S_T>bg~|9J<5m*J<xi{dX2thVQaqhTH#6%&i<@!23h;DRfgdpg`5*P!TP
z(l-ZIR<~`*RsvTI>Ri#lPrM4J!#_1Ow>uwpg8PK$-#)R_I%e+MKCLd<{i@2p>p}2m
zpf43477lPhh)*zLuFvmj%>ycrXGce)?rzhYrg*R1wpX^*P(lx8zjt4&sH<BtGdhm<
zo%gOh0)&>s2S!xOCCq_L?iFliPRrnc>UG>UdtTG&uGL0AT>d2F3W@SZ;$Y=y<la_>
z?PAU-n6$=yZTvn}O+$HB0etx|1>1p94fg8DdjOP#?XHfRQw#5}BK1_dG#z$t+VKUs
zu9<~Kd7W}9Ys+}Php}<RZ+Cn9P3=RP)XH3KGT)f65k2f9-vYY)Ht`+_7ETN+Mm~h+
z@aTmVzMRVSP!nM;Q^99IgK$)UwhCHum_W*S6BkwYwZ$$7=)LvJM(cMlkOV`M?P(HH
zzzn^30j+P%)K#E*(V`R-(Inf4Ht}DJd(<mpYi&5J)b0iK@As5uohV-uS5-tuEjiC(
zGdqR~jtf}#sApIWIrGOCzc0j&bi3F(i&WL2yIhe_D$6E-Ob__At)2yQna}d$2IU)a
z+U4dv@{>|dk7uKDm-W>!5Pa?_j0!|D96L&JpM^8waK6-bgjS;Kd@##Ah>((GYr4CO
z4Tb2h7k!!=+MR2v6HlJMxl&c|meC>7)S9e5FE^q$5-~MhYq?kA5{==B^OqRoa0ra7
z6<8AY_~0?h)lgla{>Iq;+Ji}X=c2S1p>agD)Z6bWucARk>4yWkhR%K0SZJP2OREF?
zB{MKsWX-m}a$5ev8=zV2rVVqEB~vqAW8P!eWIF&tf8%Vv*T1Kj$7XvZyYb3WLS9CH
zT1|`kqsM;uAkxf8@*}^sy9?RyfL@0D7rZuYQsjV+U_d;8fIO)W9<3eYeUHl;IAX%B
zv~wzJNcp-eagleMaNp4G&1{GJ`1R=-zC3(^--&iyVe6TAvMEpKr)llByJFuZ-@=#%
z-eF)y3CqCBgsy$oe+g{xv~=5fxd<X{ZdMb^(1>iXH0&A`tkQ=bO|U=7vdvOSQUp!k
z4B<PB5wqhaT2;C$S)8O)&!x}0I9sk;6hO;P)0;vXr|trv)5#MRmgm%=Rbyl7e#J@3
zoomySi6XN_6I1GTR9x=ti5%?Jrzgv^$^6fv6Ztvn8>H`mO&g*i5Ji^RT>#N&JHCH=
ztyJSCZq)~^J1b*W$YkA|`89I+9K12Fv6=7psd3F>lo1=>qz${g%2^teIPvSE#BqBI
z7p(ohQ{#rh9flN|8VHg)!@#-za5z1otkBDAzhrsHl2tlV;<57DcEcTc(qx&4#`eX_
z2E3&qw>tm|Mf~yt*mDE~M*{J)bPBiwCzw;q`Lri^zal(brItMq+Hlnq%w;7j_WWa~
zD+nheO%=sL=ka*sVN^nDZ>|*k*RlI_8@orjNZJIhY^l;!5)<89GX6PJw?c7jb;MIA
zy*=Nyoz`D9VI%`^<PTt?A$cnhfu!+bMtk8Vg$@^D)x^*jCS(laqDfrX9qeyb8%<8}
zJuH!b#*|nI%59ltHY`e@W51-_&REYJEZbOF%OtO;zS$cNrRK`uQUtqOt{aV78Z*{B
zv3;0-NI;^P%Kx1_BH33;41pR^tGKcvLi6oY#j#MCNM2*fLgp&!D$+&h?d0+NU0C|H
zZ23HRp5AC3a*S|Amo*Yo8@sWpbn{?t9{{y<g&FZ7vTFz%lk|3W5F?q#fQ^mLMiBE2
z@l8Bj7j*f_vQLcqjec!qJ^`UVa)U52MovKUn#Y7QYEFC4PWYEK2n>fQUGIZ~lE4SD
z<T8DaF>{JNAwiz)qdVItxC;uFHx)9G5}EsBg8_7#eZ3d&h<GG-liV6+r<}b-?55b)
z;~0DaE#Xi#x7eekXX?VmF=EWen-ab#RvpfNvkRZ50ZVmSUOVJ?ICDlXevG%T**fN-
z^CMH_L`0#X-|kv=yLr_a#h3^1lDaQo#iqpc4JhF-ev-2|l`w{=Oyhsu93&aEx4Lby
znv$8WWlYI8o_25`@rsuZDopR+=a+qLEtg7n8Rr1cyxsTM*1*el{gqN_D`P$#zsu>^
zS*Q%Extry6__fY@6w0|dun++g74U>SU*E$$tfn7HK4-DAPps7s3Cr?LKl2*Kw!H5Y
zue$3Hg=o|rZK*ZLnDI?)zOv*EnyT_#7d;=`hZguX_s(5frAbc*3^>b2o;F@?@B_85
zb2(H-cazjtba)Lv7t{GPw6#iQQTKc1lgyfy*G@*N8({9=0HgdEFo4Hcr4M$^^p(hB
zI0$)%dP6K#djEDNM4YYZH1%weYa5Hbp-7l*TD&OPdA~2*UOBYT>b^Lk(wZVYDVpy*
zR%qJgq;8NVPD0SFvSC)cbG`(~BJG|><>|9=%?-JR{*X8s(9Kqn71ArtH#IJh(HM!B
zN{@BfnHiSN5c<|f`{@_up$V{vd2d<3Gs(kJ^W<6t=fC;Z_Qk0%ahwrU?s%6vS&)=#
zB!oZSGydA{h<*22%^B-i1qn)aiV>FH39DlN_428u9G`?3&>2?(l5#80V3jKE&$Z>`
z0x!7_8$U-ejhA<9Rh)bmJ$yH`^RgyUKlUMFy@IdCO#R)gsTYmuq)?zBfqJ=n+PCat
zp=#{qg5sTbk;`}=JQ8^e*^+cFW||Ym`BtxV!r(0gFGv$#L~CYcN^caHt49!RxsOJK
z#rgmvd4j?+G`9bp8c5Mq2zTjDgGs;mX7%XC`&PQ2jJpKYx0jxP1`@qWtEmRf3qrt<
zYmX3aVcb=yD=v0AevJBlXlQqcHeH;2*&KcG_Iik5@pw$ule^7n@uqe5)^^3Gvw#OO
zQ@ZZrszTSX-=wdcGOKRj|Fud(h3kel4VhoARh1{-p2Sd=0Pz^R1ewc|VkYaLVjI4@
zpuNt~FA>A%HgwxEpOi`gulc5ikx5OBrE!|fesD!f>oI<DQE^0VNRx#nhcr{Xps{P+
z<~%DtEZh(LiJKdI6foR#u+NbKHxR)vvb6fE-w%)1x_G`_3)M!SA4(o{U;3Jzz;%TF
z$m02MDL@1{dEf~lB9dVw3EPP_FWK0kWS@o~#;}{yQUT$lmmJ`uQqPD^#Zo#!xsKLr
z9t3a0H%<6Jh@a`3XVVwYh&jYzyokN@k{_3qQz<_9Au=F>f*+Ds!iI(82R+(@IW1_j
z0H!M01AOvPOUwsTI3*JwB8KeZtYpl%Jg1QHE6R8P9!BCT;JvaCpIG~uD!w(L22dFt
zPxGm*`Hl*Vzjy?Io8-Tu9)kN5A?G}p<Q+r`<!|Ks7+8)8>?ovv$ImccR}az4|GO`c
zb2HJ<%!9@L+XgIL8C)PbzmFeuZ^=dl<?;c9`PF=mSF^%mx)SgO!3pTUyR(2WIo<_d
z?(c2Fx+TKEhQQSNBjbC}-;0Q9DRuX{gQLvk71q)kgNbkdZc^ktyncvkAbl^tYk2)n
z>Lrk*PpASe$&`BAyp;T*Ooq#!5L?dGYtM@yfrRl6$7=Wd5y9Urq%wYvs0p7_&Q{k5
z`rjs>D(ZSHdSxFBr_a(C5nuy^@4tf>h+>C6ws4Xoh7#maD%!>uw)J;oln9SwA4r->
z=awNYFanvbwBMtidRW^Z+)XbY4fR$8*3_Jfba`Fa*xy}6B77~^jFQMPus__tMD6<;
zH4ts_SL`f`0f?)XNIcf`nAKf+E?L>%?VNCmoY!96ylUTq(zEB_u&ueP&~8)N)CQ5o
zKZ1ICJ})`_&X>Rg4`HCKcsZdWcQ4QIXCERZpK|?uTBA)!h09V`EmhhZOj_%043)Mn
z)_<6i58Y+a^Lpe56;v8xi8s^MHW_Y*-Yqc6gvmHLrgHz$W=vr7($SihV|2}`f@pj@
zdX?Z6bC(6l^q);NEL<SQ#MMO;-EOOi=Dm$*yi8c*HDqv7=QpA3!Nzsrag4g0IpZ0X
z9889x_Gi&EM(419dw}uPQ(r1Jy6jmjfPK6q?Mg5ax*q9i(J{9l>zbkYuN5);_nLd|
zC&^X~*IZ)EdS5uQ@ut#vlQk1>k8TUY=?zAbmH+8Y0j{Xt?D%}2?vj_YPEQdP+z{B~
zb{@aGFQ7jjVERWc;S>=Nf$nwhd|Vf;JfYrIDq~)6=O|6Bz?o>Bk<=fp0R#y=|7CR!
z?H#4y0X)aI#)Y>%io3>17WX@CD(g29d;z_G^=kkhF*@gxaSh$B-KX7bNOR7}$C)a)
zg31z^C#r)Bi=eWF6)LJsv&A26IJ93!QjMyqOa0k_HnV`b41<EARo<%yCfyXP$}=)L
zo|Bpp^H0<+eLQbY)eEFIoecDahN<@({hngLr~<#=dXNAWHq4>=qi!-F?=Pa^!|R>*
zTepCM1z|<vWqtonAx~i+V9mqbdXo3)kEtSF02c(G{YI=Gp2Ec<t5D8i%R&D8&IN3;
zic3R)$o%Jm(nF3iwJ(M4pZ&>t4y=Xi{oVWiuM__p2~W@e*~FhI`2WvH=oX3Cr#{S3
z;cp;gPR@{`L^h2HHa^$gBa&bAEa8+TAY2G^#26KY@d`kqDV@EY3D2sYMsGMws?xR+
zWc323yOJg_(+|<oT(Gg7ZhB0wJt5t5kaL~;zJN%XSH0NP`^NnOWk+$dd!bE-2eYcA
zrRyvJpA1n-4hUU-@7o4&yvpMVW%L!hNu3**TR7T2IZ${CKM+LAGA7Z0DCh0Mb+$@a
zp?sL@O;7HM8^A*VKwcnQCH?uE2#{k@1I-Ivx|n$@wrFmJ^*lg<zCc<OmA)OI{0`W8
zsgChEa8L79*;=z0zm0FS9dL&W#F@DCkp8BTY5@nr9?(MJ?LXaeS(io$a-nNQI3o=t
zOi4e@#~+h6DAJm1Fm_mv-takIxBJxNmhVc;Uf3b!W`0_U-<KG?K5sL57k|D}r>{52
zuoll^?~gAhZ8=#d#KdNgn{8<or{iCR6>aNaupHR-W|rAhm78fj^7NE6!F_gQz|>|7
zdek%G5L%ST(PmaRzBd;>=#V^zE>p~ZmoK?ar2M1s8Vz+sQC>Dd;8Y?z-6e0-S*3HB
zqPz#&ST^2N+U;uVc`Yq@5_U4Vvg{<v#IOuktQO5$m!h!_(xpbC`X>h^`Hovk<6Sz3
z%H>TbZ0D<y$<O<nbbb0p*_B*iI=p)uQ}H3@K@Q0}guTZO<WkS&(7h6ur3I!$=`o%v
z0%NY-biazPqc#7|h)#}Yt&iSA+OHHr_GYH>M)N#*igrs@+f5yorpQyp`J(+iui{$U
zMcb=$gic#46SCE%!^V~v;HSfP*Gw-|H6DoXRB~#oh;57uQR>V~iX|25S=w7qu9&vj
zZtUJ2$P!&!*Kv`t{$B8bij~ta>QMS(i<FsJtWv<aweqxL<$T_D8fCqI?s$pK;dZqB
zT7%hWBNI5b#3bFZ$yxv0UhwEDKWkS)i|*!5r{3hK_VF~UNPIbpfZg(S?d(``{l%AI
z6zfFAR4VOH4hBAXb;%xGJ2qPoj;;!M?7TT|YHb@jQ@poloB8;>jzZ@VYGilzETp}_
zv6Qopz0<qIqSm|g#Wy#p<00{@%K?5K&w2+NYNxPwZYR~ggd&c}dJd<bZY!#@*LtG)
zofAREWRR@Y2yBMs0?U5Ny`dM*VYel#7>6vh_Cqo^SspNlC<%XaoBly#sn;bz_F0Lo
zYi{{(?bhc7*7%-u5VAgc+gJOHwCUm~=-KIbAhLEB!jDdx*E*)Kj8Qu%kk#Ss!Xrbo
zpbGia4^}VNtEK`Q0z!#g!d2>Tj}raU*|MEosOM%TdxISBW<z&D(i}D-rk5`z<(d_^
z&vtF-bguJAqQliYtD&8FbkHeliMsI1>o2A$R6DGd_0NXJRBcr1!UB2=iqs)nlN}W?
zu`O_*N&v_hZ45Hi)rKV&ig?T#HCDx2|A9f*BU3bmHC&)0R>ibav<|DE%a)&0q*Pdx
zPsXdS!%v$pD$Z%C&E?X_*sx7)+->Chd!!yWBJR{xwvaL-d*UCF(!CucNQ_@GpQmY>
zBnE^?{zS{&ng?tqs<trIh<9CVIaP%ZoTKl6*U6;mA^US9i(gL1?Q$cA(w{Q@v(pYw
z9qyHia&Y@rflR4)0iGO>40%WxIOipFXYNbTkQm3?O`L9VI5URk%|QZ3CTT*Mg~sT+
zIki_E%jiV@ebifVc^d?|r}pbC%M4Z?BZHD2c17aU)=HnU>`f{V2-(Fay9JRle<Zf1
zBfD*NRn?oi%j?N!uiymqP_Y+!>$jU$r>`?N6u<Myfh#njmLcBSd7H7E$(g|hQJ13J
zejSsW*UokVZuganWIt>Ui0%>BO1kH>;&!`E<<crGNik2g>roMYIiFXGRf1s9qk8xm
z&tLMZo`P&Q&8+)UuwSow9yFZ4;z}H?(OPz&$;+y+J`Zow5j_UiFR`RQIM4DhsN`h7
zI(m6%WZVI+bK<ooW#@doaZ_F%j{bR>N`yC4anC`hq@1+f=9~#-j$;M6^`^+nUAiGC
z{Z57h_$@V9d3p|QW;{Eu{*Fmco0S~amHQGQTf6F7GXA6f%x<)}LDXSrU*J>&ZL+Km
zL^>f9{^$}Izn$c~dT82w*{(8x{MzFImQmwqs^JbxjI`tZS!LwgJJp_6N*eXk$5=`1
zeu4ay+XrXOLQbkg1QqqjgFIOmFwcsM7)<;)-%!@QhkOX}=n~-7&!xGh$$4VeeL9CS
zryPN1e@^UN$3$HgG+IGmt}2S4swHU{HRxb9SuRVR)brhS!FS32ja}PK+FdKD{oFyw
zZn$q=z}-pNcpt41b$J|eEA~*`eQmtds?eQpOW(6v>b`_BQP0ForBCIxwMUK7Nrd-f
zGV3!rd-?w6`K?r9;Z?2q?MAN^>PpX&vM%%T9>?wofK!@|seCad26SNd8n^r>Ri#f8
zXl9CQF&y)YU`wLME4{5-mf13ln9Ce%oGz&gf@qa(5;{*JRZ8#A(u#Lx-v<eNY^mFK
zJL~X$>pk|Fa~NJ~MB`zh*wayuR&92s%0qiXRoeE3M!@Ziv85qfp?g~V6>+EFU3>lx
za_n-fk(s($*WFmIXX6kNAA*Uq?F>M|%y#V<cZ?e_U|v`u^m%-(A#KihJ)=VOD&a#I
zX=N0XDVK+oKAR-kse{94S8lyxzlFdeU;Z|{Vpn4pYq~VIf&JOSS4&g&4|$f(GPdT<
z_Tj^WdC>Cg57+r{>$7StQ7Jq2viFT<1YtAEM5E|CO*5YhofzvD9ip~&7o+z;V_|_!
zwRuApKU;Nrt-pr5esV`~Uq|I@l91`llA`*L{UC<PZAL6q(FkGTY%^Wa&6!vv>QM?2
zE0HpdD>3k6Lrb+!Oizy*FYTgLqz3PTb~iQ7#i_e@c#PEdrMZUb*ed1Eq(;kcx*Ni?
z@q3>p<<`f3Jc%$MqG8O9YUe_YsT7O3h_d&c+C<C#!AlsE?M5BYo^K*se*6L2)c1;-
zi(Lt+Z=P~zD52>sH~34mox9qO4rMm}4*QxWfeF689}idrXqK*RxC$)fLw&cg1Jk)0
z>n$t*H*}w@9SR*phC4!;xO``xNkYAJ*@xLy6=1k>#Q3b=F|fhNS$69v&WiMswJajB
zHX&`Na^wL0W;eYL)EV04{0yGAdz;RNvDoo(&cTI9?Zy1F<xet5S2=H2dV0uuCn1;d
z3l_Y08&A-9kf{1TQmvYZR7ya9(DF3S48-P!)|%`@o+e5@J+%|oS%n-YVzIgms3Iip
zL+PpRN7gjUN2-dq7Tt^(KZvh#8tAX{9PbD)?tHdzeF<@0FAt3cL9owG;~GE2gbJg=
z&D=ANrMzQ@^}>WpxZm85o#hZAUoKc`4H-#K?;2kOClt1B^G*{q0Y3?)WgmU@mB%$U
zK$eg3=*^t@aJ$8kDwR8bjM|+~WqIFo`MwjKANw<OdMXvvZeE?*V#6|zcC8?k7wu}h
z_I`1V`hvGBM{|>EbqQ?o@n;?J=X+eKy=Y~j8s4pEHS(^rH^XOI9GBw&_xuyEON1Z)
zpj3_Fr7bb-oKlpOG-{Sfl*Ss8=%Yk0pYymB>zIyRw12aN*)&e2*KKxXB|tBKeP%c3
z+P0Um_W!hZ<^ND`ecTMnHkM0escV@V$y!5cWXrzJ*y$!D+qjHEk`zVvAxmYMMp?#$
zu@jP!^;&Ml*v7sk3B#C-MwZlb^l)FV=k@#r&+FCqxAV(6=leb9dp_s9m-8twJj%dX
zxG1LJwFj0qr+UMGt9CY;X(jg?dL!stx0cMOIv?$LGHfDy($w6oggJw?soHu4(oxh(
zEAb2RCLLnuf+!aF1mu3JsmQ0!+9Bus@K=L{$jfc!E`JQ;$^AW6f2^=;wvq@^{?;=m
zrgZAx^I5{`xTlzjcd_GbVklN>8q&2cIs;*YyW%y<ZccIhNVJk2#g*YVtn4HH@;yKK
z`<<YxL0hF4D`TUCDNY$G%!W(#!<L>%_N&MOOqO&4<M9i|R&OTbYw4N#f=~~>;^Vwh
zJ%W$`10NIP{!R##!d*=*`di&Zb;&)v$)ThSq0IL@4YP3O(3-IvZN$~nLV<+G{z;~E
z7N;Vo$9+j18S@P$F6+5n@;D7{sp{y5-bj3V!&0}hEpB8)^3U{Z=W#(UTfGMgiiU67
zmmdl&EgtgATf)+PHQ89*j5@J1M2>K!@blBJDX7i+2DHidYRwz=Hc>UpjpHH`p$Xet
zxtd;`H7n6UD>=3el_0~nPYOU3ttTu!>Y<b_A947VO!-21$F_<jt5gS&aK#nM^+P8#
z!&C=jJ{3N$m!DfcyHynL>*95}VF08=)!%fOa}S9=b-R-(CJff1#5xMWQDJl_(>n#x
z;`k=!MW(o?PLHy(YF}k3QT&<$g?!_AM%c?(E%#qb4&fNlOCOBvQCkfUu0ymQck#tw
z64O7%8;;D*PX~FVx#2!qXlf3_70Qsj^D}=np7rXsa2U9?et$IA^=SC%7n1g(xS8?k
z>HF`z=BNg3DiY-pkB!_816DAR*g<9q1zNo)xg*nQJ}Xg^wjV?0s|65-YQOLI(h~1V
z6u;5`DpT37y$@vL;FY0UF8X-O9oQ;bS{Pe%Ep>8ByK?H;#%S6q&#G}i*mv|8E#XbD
z#jJfETUVubSDu^(0bcKN>uGIQn@ya0*v0!Fijt0F1)d*=Bb!^!U&-2LUN0fVKk7W;
z6&52}zx{gIht5t}q<$TXixX?)u*H9fW}|mLBNv>!7E}cvIZ0c&>|Z@M>}|qI@u-wG
z9nEc94e2g$I8mWqYps+=A2oZ^W!0ee#0?sS+y#w26(L%#)LXE~H#W?2tSA*?ifb6@
zD6e>dbJ`HbY7|=w2Nm}XhG+~CCq7dL!NDftGE05VMrn>v9Ls!#D0QAJY4Vn_dL>=&
zqMPqi9RhoNhN0Aj=g;uAATjeSGH_~7Rvr9asfdJSSRSj<`uui=+-jC^m2!%|P98*A
zEjzs88}6x5_eZs@7tOzAt-qdXy&I!aoDp=x*_?lAe#N|e(F3K~z4YMOuT6yQ>CuT^
z4{d4*#nnsu{l@)h%7gTy^t#hGQ54(cE_BU^&sW9M^eh^`ZF(WW)#8^Y6Mhy$PT&kW
zL&^31i`%E1{%sN4$CXTZ@!Js9llA3Dt^2#9X0H#dc3X2Ud89f}o7W$<zCAVrO-_pK
zZj@Fk2!*v_Z4-w2?%l*@4+-^#y=%bgTm4~{R&e2@*L9}<`PBm|YKoTy>@j(?Y#lEp
z7&IZRHY1350~RTdI728I9zdsbnz+#Z<uoZrG&+h>8<RNF$Wd4IA(*Lxz&uP&nyIEX
zHl)$`77n@II^p~>$oY=5Zpomf&YEAxO^E@OymtAnI14E>7E<b46#Bi7Jk6mdbM<=&
zgQ|NcLO&~!C!P3~mh9*x;CLf3H>CJY@&oM%me5r1i4LP2!{AL*rRpbma?U>0V1v#u
zfv8KiwAJmIM*~&ya*X_dh+%w=ZQ$pUTylZ~WcKVFpWE8Y#5I{MyXQ6@H2b?(w6GJQ
zVf)h45rMZw8#%I^&bmHaX_lBw#X5%Nmyy=_3RX)*5lm7`&YGC_fjQzgBf>U<DCixg
zEh9)~gZmS{NU^fYBl+1@sy~Qh`(s5X(lkB=s*i}z>*f-~UCLJP_A5|k2jY^DIz_~F
zgZISqn>`7PeztoT?XnJEphE1ui75_$Vlr}`B@(To3fJVy*3~nPTOP?2EBqS8yJ%9j
zG;gO1*G0ned4}hx`wn^@3|u~QWc@cMP7(j!$+SyZ7*C#HS)1Ofp#@fYVP$0?tz*U9
zL}{>-TADN0G9RY=osR3U2~9=0Y@{to73EZEj>xVYu8gH}(`jZ+l-E7iP3d+wZsSUi
z{k?HIj>^Qx0*eUU%6o2HFR(hlg)2od@JkSCbbsdlfa{KHvt}L+sIfjytxdpwH{+GN
zkIxI{_DX5_D>Q7|;^Cu%*BK5;ymr-ZQS}wIlvC{i{e_Wbi>zlz%~!`yOVFN%{MyLj
zI>GF8JX)RA`T|@4oEgDMPrl|EoRL+!_T=3+-$N8ND1=+J?;zUSdH~8PaxyrSFcN8V
zKXbuNyIr^!0WX#d@G&XqY0XREKU^P((O??Ga_3P+17Eba9-8;Zjd23cmD3`o*sqwC
zU%^}l4Ms=N2W8EM<7{EGEt8Cv)-_cAO)z+IKxmYbnUmSZ^I69H?bFTP=ypW#IpchI
zh>VeBV>Podz_3bzAThg?v<q;fNnq7SU*r)m)pZ1C@z2h-9#a#T6{xtE#Hs^Zr8KZ2
z0@y|HZ#dw*!cv^_grGMP_1hzEo{FMS=e=yg`FCM_5hY-m>1|1od=$B_d%34yt8aNc
z{t4k_+MH4CgHa2YAJ9Bh2&is#k#U$bWw$AiD|=D4)em<K7f8IY0Q0>215kDc7V4IH
zIn18)3U&y{weK<5)FgM=niilEis?mBf7vaI15(LvonLo#7yOsn5qF7h8z}9Tv!?;v
z^s|DW-{9vw(Ea%@08sh=VIHUseOl|k$sv2}(>yV0GMrJ5(qd5yZ1ZKE6b+>XNlpGW
z6KnhHvve0x)k3879btuCi4}E!lpv?b&}ZRGT?Ghe49{0zMt+YaS_2B(@qauc`g&DB
zUAJkD4Dw>>r5e2jE)IoH8H}68#DHdptT;IOz|KC!424e0<`fydQ>v3{oQ;O;Bk<1V
ze)`A-R3keM9ZnuaW#xlTNJF^b%cgJJTdonTfhGw(meAt{ux;pPuw&5dkR!>M9-j0_
zT|MY{x-GCXp0WgT*qsYBVz|bG`z>Qq%n4l7bCJBGm|l=rVH2#+3tu4Wq^QV%q#`{9
zA1H9Q&euwErdm{3x^=j+u|ckx8tB;pu?VP!w47G~Y@<?9;|?Oqv-^~@U18^be-~lG
zDw1hR;Id!frdhK?CiDv>wJz1{^Cxg~#mi^&YK4qM{vt7F)RA&IgaeqByU?mT1ji4G
z#?BEyHv@DD%pQBsB?>rGg4-T5FGvDb_7ZZ0e%BuH3W4kTAVhxX7=KhT05}Qz8Z1d{
zk1}-woa((h|ERUI$>0rXYcO^Fok+S9PXD(HJq{BM1h4<}NGdWC444?tZs-L}FAWHx
z3dc@U_Z$F%s^AhE{br862GK4c=7ntCOW#!|{BuLbUW0`SKs^#Lg+}aA-%TLQ@^K39
kHK-c`#4i8+5u&~eRLLh5!mjAWvw_Fd(8{3noZFp$1L~v+umAu6

literal 0
HcmV?d00001

diff --git a/assets/eip-6384/media/ZenGo-EIP-compliant.png b/assets/eip-6384/media/ZenGo-EIP-compliant.png
deleted file mode 100644
index eef608bc6d1d73fd73f2f1223704f15fa67946fd..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 240406
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
RrAvg5>N72+5`|Z9{}0zlz`p<h


From 817635af862a49b7ad197b1cabeec2a35ee10cbc Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Sun, 5 Feb 2023 00:58:48 -0500
Subject: [PATCH 252/274] Update EIP-1: Reference ERCs by ERC-X (#5273)

* Make ERCs referenced as ERC-X

* While I'm at it, change should to must

* Make the two sentences a bit more similar

* Rephrase

* The bike shed has been built

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

---------

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-1.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-1.md b/EIPS/eip-1.md
index e9812ec609df91..05cdc3fc383ff5 100644
--- a/EIPS/eip-1.md
+++ b/EIPS/eip-1.md
@@ -374,7 +374,7 @@ The `description` field in the preamble:
 
 ### EIP numbers
 
-When referring to an EIP by number, it should be written in the hyphenated form `EIP-X` where `X` is the EIP's assigned number.
+When referring to an EIP with a `category` of `ERC`, it must be written in the hyphenated form `ERC-X` where `X` is that EIP's assigned number. When referring to EIPs with any other `category`, it must be written in the hyphenated form `EIP-X` where `X` is that EIP's assigned number.
 
 ### RFC 2119 and RFC 8174
 

From 784b89ca3ec54180e28cc016bb87e6351c5f8fe6 Mon Sep 17 00:00:00 2001
From: bjeabby1507 <58377788+bjeabby1507@users.noreply.github.com>
Date: Sun, 5 Feb 2023 07:30:06 +0100
Subject: [PATCH 253/274]  Add EIP-6353: Charity token (#6353)

* Add EIP-6352: Charity token

* Add EIP-6353: Charity token

* Update  EIP-6353: internally linking error

* Apply suggestions from code review

Update EIP-6353: md updates

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIPS/eip-6353.md

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Update EIP-6353:Apply suggestions and updates

* Update EIPS/eip-6353.md

---------

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-6353.md                              | 265 ++++++++++++
 assets/eip-6353/contracts/CharityToken.sol    |  50 +++
 assets/eip-6353/contracts/ERC20Charity.sol    | 328 +++++++++++++++
 .../contracts/graphs/charity graph4.svg       | 378 ++++++++++++++++++
 .../eip-6353/contracts/graphs/test graph3.svg | 108 +++++
 .../contracts/interfaces/IERC20charity.sol    | 137 +++++++
 assets/eip-6353/test/.gitkeep                 |   0
 assets/eip-6353/test/charity.js               | 173 ++++++++
 8 files changed, 1439 insertions(+)
 create mode 100644 EIPS/eip-6353.md
 create mode 100644 assets/eip-6353/contracts/CharityToken.sol
 create mode 100644 assets/eip-6353/contracts/ERC20Charity.sol
 create mode 100644 assets/eip-6353/contracts/graphs/charity graph4.svg
 create mode 100644 assets/eip-6353/contracts/graphs/test graph3.svg
 create mode 100644 assets/eip-6353/contracts/interfaces/IERC20charity.sol
 create mode 100644 assets/eip-6353/test/.gitkeep
 create mode 100644 assets/eip-6353/test/charity.js

diff --git a/EIPS/eip-6353.md b/EIPS/eip-6353.md
new file mode 100644
index 00000000000000..9233d534f8d185
--- /dev/null
+++ b/EIPS/eip-6353.md
@@ -0,0 +1,265 @@
+---
+eip: 6353
+title: Charity token
+description: Extension of EIP-20 token that can be partially donated to a charity project
+author: Aubay <blockchain-team@aubay.com>, BOCA Jeabby (@bjeabby1507), EL MERSHATI Laith (@lth-elm), KEMP Elia (@eliakemp)
+discussions-to: https://ethereum-magicians.org/t/erc20-charity-token/12617
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-05-13
+requires: 20
+---
+
+## Abstract
+
+An extension to [EIP-20](./eip-20.md) that can automatically send an additional percentage of each transfer to a third party, and that provides an interface for retrieving this information. This can allow token owners to make donations to a charity with every transfer. This can also be used to allow automated savings programs.
+
+## Motivation
+
+There are charity organizations with addresses on-chain, and there are token holders who want to make automated donations. Having a standardized way of collecting and managing these donations helps users and user interface developers. Users can make an impact with their token and can contribute to achieving sustainable blockchain development. Projects can easily retrieve charity donations addresses and rate for a given [EIP-20](./eip-20.md) token, token holders can compare minimum rate donation offers allowed by token contract owners. This standard provides functionality that allows token holders to donate easily.
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
+
+Owner of the contract **MAY**, after review, register charity address in `whitelistedRate` and set globally a default rate of donation. To register the address, the rate **MUST** not be null.
+
+Token holders **MAY** choose and specify a default charity address from `_defaultAddress`, this address **SHOULD** be different from the null address for the donation to be activated.
+
+The donation is a percentage-based rate model, but the calculation can be done differently. Applications and individuals can implement this standard by retrieving information with `charityInfo()` , which specifies an assigned rate for a given address.
+
+This standard provides functionality that allows token holders to donate easily. The donation when activated is done directly in the overridden `transfer`, `transferFrom`, and `approve` functions.
+
+When `transfer`, `transferFrom` are called the sender's balance is reduced by the initial amount and a donation amount is deduced. The initial transfered amount is transferred to the recipient's balance and an additional donation amount is transfered to a third party (charity). The two transfer are done at the same time and emit two `Transfer` events.
+Also, if the account has an insufficient balance to cover the transfer and the donation the whole transfer would revert.
+
+```solidity
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.4;
+
+///
+/// @dev Required interface of an ERC20 Charity compliant contract.
+///
+interface IERC20charity is IERC165 {
+    /// The EIP-165 identifier for this interface is 0x557512b6
+
+    
+    /**
+     * @dev Emitted when `toAdd` charity address is added to `whitelistedRate`.
+     */
+    event AddedToWhitelist (address toAdd);
+
+    /**
+     * @dev Emitted when `toRemove` charity address is deleted from `whitelistedRate`.
+     */
+    event RemovedFromWhitelist (address toRemove);
+
+    /**
+     * @dev Emitted when `_defaultAddress` charity address is modified and set to `whitelistedAddr`.
+     */
+    event DonnationAddressChanged (address whitelistedAddr);
+
+    /**
+     * @dev Emitted when `_defaultAddress` charity address is modified and set to `whitelistedAddr` 
+    * and _donation is set to `rate`.
+     */
+    event DonnationAddressAndRateChanged (address whitelistedAddr,uint256 rate);
+
+    /**
+     * @dev Emitted when `whitelistedRate` for `whitelistedAddr` is modified and set to `rate`.
+     */
+    event ModifiedCharityRate(address whitelistedAddr,uint256 rate);
+    
+    /**
+    *@notice Called with the charity address to determine if the contract whitelisted the address
+    *and if it is the rate assigned.
+    *@param addr - the Charity address queried for donnation information.
+    *@return whitelisted - true if the contract whitelisted the address to receive donnation
+    *@return defaultRate - the rate defined by the contract owner by default , the minimum rate allowed different from 0
+    */
+    function charityInfo(
+        address addr
+    ) external view returns (
+        bool whitelisted,
+        uint256 defaultRate
+    );
+
+    /**
+    *@notice Add address to whitelist and set rate to the default rate.
+    * @dev Requirements:
+     *
+     * - `toAdd` cannot be the zero address.
+     *
+     * @param toAdd The address to whitelist.
+     */
+    function addToWhitelist(address toAdd) external;
+
+    /**
+    *@notice Remove the address from the whitelist and set rate to the default rate.
+    * @dev Requirements:
+     *
+     * - `toRemove` cannot be the zero address.
+     *
+     * @param toRemove The address to remove from whitelist.
+     */
+    function deleteFromWhitelist(address toRemove) external;
+
+    /**
+    *@notice Get all registered charity addresses.
+     */
+    function getAllWhitelistedAddresses() external ;
+
+    /**
+    *@notice Display for a user the rate of the default charity address that will receive donation.
+     */
+    function getRate() external view returns (uint256);
+
+    /**
+    *@notice Set personlised rate for charity address in {whitelistedRate}.
+    * @dev Requirements:
+     *
+     * - `whitelistedAddr` cannot be the zero address.
+     * - `rate` cannot be inferior to the default rate.
+     *
+     * @param whitelistedAddr The address to set as default.
+     * @param rate The personalised rate for donation.
+     */
+    function setSpecificRate(address whitelistedAddr , uint256 rate) external;
+
+    /**
+    *@notice Set for a user a default charity address that will receive donation. 
+    * The default rate specified in {whitelistedRate} will be applied.
+    * @dev Requirements:
+     *
+     * - `whitelistedAddr` cannot be the zero address.
+     *
+     * @param whitelistedAddr The address to set as default.
+     */
+    function setSpecificDefaultAddress(address whitelistedAddr) external;
+
+    /**
+    *@notice Set for a user a default charity address that will receive donation. 
+    * The rate is specified by the user.
+    * @dev Requirements:
+     *
+     * - `whitelistedAddr` cannot be the zero address.
+     * - `rate` cannot be less than to the default rate 
+     * or to the rate specified by the owner of this contract in {whitelistedRate}.
+     *
+     * @param whitelistedAddr The address to set as default.
+     * @param rate The personalised rate for donation.
+     */
+    function setSpecificDefaultAddressAndRate(address whitelistedAddr , uint256 rate) external;
+
+    /**
+    *@notice Display for a user the default charity address that will receive donation. 
+    * The default rate specified in {whitelistedRate} will be applied.
+     */
+    function specificDefaultAddress() external view returns (
+        address defaultAddress
+    );
+
+    /**
+    *@notice Delete The Default Address and so deactivate donnations .
+     */
+    function deleteDefaultAddress() external;
+}
+
+```
+
+### Functions
+
+#### **addToWhitelist**
+
+Add address to whitelist and set the rate to the default rate.
+
+| Parameter | Description |
+| ---------|-------------|
+| toAdd | The address to the whitelist.
+
+#### **deleteFromWhitelist**
+
+Remove the address from the whitelist and set rate to the default rate.
+
+| Parameter | Description |
+| ---------|-------------|
+| toRemove | The address to remove from whitelist.
+
+#### **getAllWhitelistedAddresses**
+
+Get all registered charity addresses.
+
+#### **getRate**
+
+Display for a user the rate of the default charity address that will receive donation.
+
+#### **setSpecificRate**
+
+Set personalized rate for charity address in {whitelistedRate}.
+
+| Parameter | Description |
+| ---------|-------------|
+| whitelistedAddr | The address to set as default. |
+| rate  | The personalised rate for donation. |
+
+#### **setSpecificDefaultAddress**
+
+Set for a user a default charity address that will receive donations. The default rate specified in {whitelistedRate} will be applied.
+
+| Parameter | Description |
+| ---------|-------------|
+| whitelistedAddr | The address to set as default.
+
+#### **setSpecificDefaultAddressAndRate**
+
+Set for a user a default charity address that will receive donations. The rate is specified by the user.
+
+| Parameter | Description |
+| ---------|-------------|
+| whitelistedAddr | The address to set as default. |
+| rate  | The personalized rate for donation.
+
+#### **specificDefaultAddress**
+
+Display for a user the default charity address that will receive donations. The default rate specified in {whitelistedRate} will be applied.
+
+#### **deleteDefaultAddress**
+
+Delete The Default Address and so deactivate donations.
+
+#### **charityInfo**
+
+Called with the charity address to determine if the contract whitelisted the address and if it is, the rate assigned.
+
+| Parameter | Description |
+| ---------|-------------|
+| addr | The Charity address queried for donnation information.
+
+## Rationale
+
+ This EIP chooses to whitelist charity addresses by using an array and keeping track of the "active" status with a mapping `whitelistedRate` to allow multiple choice of recipient and for transparence. The donation address can also be a single address chosen by the owner of the contract and modified by period.
+
+ If the sender balance is insuficent i.e total amount of token (initial transfer + donation) is insuficent the transfer would revert. Donation are done in the `transfer` function to simplify the usage and to not add an additional function, but the implementation could be donne differently, and for exemple allow a transfer to go through without the donation amount when donation is activated. The token implementer can also choose to store the donation in the contract or in another one and add a withdrawal or claimable function, so the charity can claim the allocated amount of token themselves, the additional transfer will be triggered by the charity and not the token holder.
+
+ Also, donations amount are calculated here as a percentage of the amount of token transfered to allow different case scenario, but the token implementer can decide to opt for another approach instead like rounding up the transaction value.
+
+## Backwards Compatibility
+
+This implementation is an extension of the functionality of [EIP-20](./eip-20.md), it introduces new functionality retaining the core interfaces and functionality of the [EIP-20](./eip-20.md) standard. There is a small backwards compatibility issue, indeed if an account has insufficient balance, it's possible for the transfer to fail.
+
+## Test Cases
+
+Tests can be found in [`charity.js`](../assets/eip-6353/test/charity.js).
+
+## Reference Implementation
+
+The reference implementation of the standard can be found under [`contracts/`](../assets/eip-6353/contracts/ERC20Charity.sol) folder.
+
+## Security Considerations
+
+There are no additional security considerations compared to EIP-20.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-6353/contracts/CharityToken.sol b/assets/eip-6353/contracts/CharityToken.sol
new file mode 100644
index 00000000000000..e7834da34654f9
--- /dev/null
+++ b/assets/eip-6353/contracts/CharityToken.sol
@@ -0,0 +1,50 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "./ERC20Charity.sol";
+
+/**
+*@title ERC720 charity Token
+*@dev Extension of ERC720 Token that can be partially donated to a charity project
+*
+*This extensions keeps track of donations to charity addresses. The  whitelisted adress are from a another contract (Reserve)
+ */
+
+contract CharityToken is ERC20Charity{
+    constructor() ERC20("TestToken", "TST") {
+        _mint(msg.sender, 10000 * 10 ** decimals());
+    }
+
+    /** @dev Creates `amount` tokens and assigns them to `to`, increasing
+     * the total supply.
+     *
+     * Requirements:
+     *
+     * - `to` cannot be the zero address.
+     *
+     * @param to The address to assign the amount to.
+     * @param amount The amount of token to mint.
+     */
+    function mint(address to, uint256 amount) public onlyOwner {
+        _mint(to, amount);
+    }
+
+    function selfmint() public {
+        _mint(msg.sender, 100 * 10 ** decimals());
+    }
+    
+    
+    //Test support for ERC-Charity
+    bytes4 private constant _INTERFACE_ID_ERC_CHARITY = type(IERC20charity).interfaceId; // 0x557512b6
+    //bytes4 private constant _INTERFACE_ID_ERCcharity =type(IERC165).interfaceId; // ERC165S
+    function checkInterface(address testContract) external view returns (bool) {
+    (bool success) = IERC165(testContract).supportsInterface(_INTERFACE_ID_ERC_CHARITY);
+    return success;
+    }
+
+    /*function InterfaceId() external returns (bytes4) {
+    bytes4 _INTERFACE_ID = type(IERC20charity).interfaceId;
+    return _INTERFACE_ID ;
+    }*/
+
+}
diff --git a/assets/eip-6353/contracts/ERC20Charity.sol b/assets/eip-6353/contracts/ERC20Charity.sol
new file mode 100644
index 00000000000000..73d2c05c4ac3a9
--- /dev/null
+++ b/assets/eip-6353/contracts/ERC20Charity.sol
@@ -0,0 +1,328 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+
+import "@openzeppelin/contracts/token/ERC20/ERC20.sol";
+import "@openzeppelin/contracts/access/Ownable.sol";
+import "./interfaces/IERC20charity.sol";
+
+/**
+ *@title ERC720 charity Token
+ *@author Aubay
+ *@dev Extension of ERC720 Token that can be partially donated to a charity project
+ *
+ *This extensions keeps track of donations to charity addresses. The owner can chose the charity adresses listed.
+ *Users can active the donation option or not and specify a different pourcentage than the default one donate.
+ * A pourcentage af the amount of token transfered will be added and send to a charity address.
+ */
+
+abstract contract ERC20Charity is IERC20charity, ERC20, Ownable {
+    mapping(address => uint256) public whitelistedRate; //Keep track of the rate for each charity address
+    mapping(address => uint256) internal indexOfAddresses;
+    mapping(address => mapping(address => uint256)) private _donation; //Keep track of the desired rate to donate for each user
+    mapping(address => address) private _defaultAddress; //keep track of each user's default charity address
+
+    address[] whitelistedAddresses; //Addresses whitelisted
+
+    /**
+     * @dev See {IERC165-supportsInterface}.
+     */
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual override(IERC165) returns (bool) {
+        return
+            interfaceId == type(IERC20charity).interfaceId ||
+            interfaceId == type(IERC165).interfaceId;
+    }
+
+    /**
+     *@dev The default rate of donation can be override
+     */
+    function _defaultRate() internal pure virtual returns (uint256) {
+        return 10; // 0.1%
+    }
+
+    /**
+     *@dev The denominator to interpret the rate of donation , defaults to 10000 so rate are expressed in basis points, but may be customized by an override.
+     * base 10000 , so 10000 =100% , 0 = 0% ,   2000 =20%
+     */
+    function _feeDenominator() internal pure virtual returns (uint256) {
+        return 10000;
+    }
+
+    /**
+     *@notice Add address to whitelist and set rate to the default rate.
+     * @dev Requirements:
+     *
+     * - `toAdd` cannot be the zero address.
+     *
+     * @param toAdd The address to whitelist.
+     */
+    function addToWhitelist(address toAdd) external virtual onlyOwner {
+        if (indexOfAddresses[toAdd] == 0) {
+            whitelistedRate[toAdd] = _defaultRate();
+            whitelistedAddresses.push(toAdd);
+            indexOfAddresses[toAdd] = whitelistedAddresses.length;
+        }
+
+        emit AddedToWhitelist(toAdd);
+    }
+
+    /**
+     *@notice Remove the address from the whitelist and set rate to the default rate.
+     * @dev Requirements:
+     *
+     * - `toRemove` cannot be the zero address.
+     *
+     * @param toRemove The address to remove from whitelist.
+     */
+    function deleteFromWhitelist(address toRemove) external virtual onlyOwner {
+        uint256 index1 = indexOfAddresses[toRemove];
+        require(index1 > 0, "Invalid index"); //Indexing starts at 1, 0 is not allowed
+        // move the last item into the index being vacated
+        address lastValue = whitelistedAddresses[
+            whitelistedAddresses.length - 1
+        ];
+        whitelistedAddresses[index1 - 1] = lastValue; // adjust for 1-based indexing
+        indexOfAddresses[lastValue] = index1;
+        whitelistedAddresses.pop();
+        indexOfAddresses[toRemove] = 0;
+
+        delete whitelistedRate[toRemove]; //whitelistedRate[toRemove] =0;
+        emit RemovedFromWhitelist(toRemove);
+    }
+
+    /// @notice Get all registered charity addresses
+    /// @return List of all registered donations addresses
+    function getAllWhitelistedAddresses() external view returns (address[] memory) {
+        return whitelistedAddresses;
+    }
+
+    /// @notice Display for a user the rate of the default charity address that will receive donation.
+    /// @return The default rate of the registered address for the user.
+    function getRate() external view returns (uint256) {
+        return _donation[msg.sender][_defaultAddress[msg.sender]];
+    }
+
+    /**
+     *@notice Set for a user a default charity address that will receive donation.
+     * The default rate specified in {whitelistedRate} will be applied.
+     * @dev Requirements:
+     *
+     * - `whitelistedAddr` cannot be the zero address.
+     *
+     * @param whitelistedAddr The address to set as default.
+     */
+    function setSpecificDefaultAddress(
+        address whitelistedAddr
+    ) external virtual {
+        require(
+            whitelistedRate[whitelistedAddr] != 0,
+            "ERC20Charity: invalid whitelisted rate"
+        );
+        _defaultAddress[msg.sender] = whitelistedAddr;
+        _donation[msg.sender][whitelistedAddr] = whitelistedRate[
+            whitelistedAddr
+        ];
+        emit DonnationAddressChanged(whitelistedAddr);
+    }
+
+    /**
+     *@notice Set for a user a default charity address that will receive donation.
+     * The rate is specified by the user.
+     * @dev Requirements:
+     *
+     * - `whitelistedAddr` cannot be the zero address.
+     * - `rate` cannot be inferior to the default rate
+     * or to the rate specified by the owner of this contract in {whitelistedRate}.
+     *
+     * @param whitelistedAddr The address to set as default.
+     * @param rate The personalised rate for donation.
+     */
+    function setSpecificDefaultAddressAndRate(
+        address whitelistedAddr,
+        uint256 rate
+    ) external virtual {
+        require(
+            rate <= _feeDenominator(),
+            "ERC20Charity: rate must be between 0 and _feeDenominator"
+        );
+        require(
+            rate >= _defaultRate(),
+            "ERC20Charity: rate fee must exceed default rate"
+        );
+        require(
+            rate >= whitelistedRate[whitelistedAddr],
+            "ERC20Charity: rate fee must exceed the fee set by the owner"
+        );
+        require(
+            whitelistedRate[whitelistedAddr] != 0,
+            "ERC20Charity: invalid whitelisted address"
+        );
+        _defaultAddress[msg.sender] = whitelistedAddr;
+        _donation[msg.sender][whitelistedAddr] = rate;
+        emit DonnationAddressAndRateChanged(whitelistedAddr, rate);
+    }
+
+    /**
+     *@notice Set personlised rate for charity address in {whitelistedRate}.
+     * @dev Requirements:
+     *
+     * - `whitelistedAddr` cannot be the zero address.
+     * - `rate` cannot be inferior to the default rate.
+     *
+     * @param whitelistedAddr The address to set as default.
+     * @param rate The personalised rate for donation.
+     */
+    function setSpecificRate(
+        address whitelistedAddr,
+        uint256 rate
+    ) external virtual onlyOwner {
+        require(
+            rate <= _feeDenominator(),
+            "ERC20Charity: rate must be between 0 and _feeDenominator"
+        );
+        require(
+            rate >= _defaultRate(),
+            "ERC20Charity: rate fee must exceed default rate"
+        );
+        require(
+            whitelistedRate[whitelistedAddr] != 0,
+            "ERC20Charity: invalid whitelisted address"
+        );
+        whitelistedRate[whitelistedAddr] = rate;
+        emit ModifiedCharityRate(whitelistedAddr, rate);
+    }
+
+    /**
+     *@notice Display for a user the default charity address that will receive donation.
+     * The default rate specified in {whitelistedRate} will be applied.
+     */
+    function specificDefaultAddress() external view virtual returns (address) {
+        return _defaultAddress[msg.sender];
+    }
+
+    /**
+     * inherit IERC20charity
+     */
+    function charityInfo(
+        address charityAddr
+    ) external view virtual returns (bool, uint256 rate) {
+        rate = whitelistedRate[charityAddr];
+        if (rate != 0) {
+            return (true, rate);
+        } else {
+            return (false, rate);
+        }
+    }
+
+    /**
+     *@notice Delete The Default Address and so deactivate donnations .
+     */
+    function deleteDefaultAddress() external virtual {
+        _defaultAddress[msg.sender] = address(0);
+        emit DonnationAddressChanged(address(0));
+    }
+
+    /**
+     *@notice Return the rate to donate.
+     * @dev Requirements:
+     *
+     * - `from` cannot be the zero address
+     *
+     * @param from The address to get rate of donation.
+     */
+    function _returnRate(address from) internal virtual returns (uint256 rate) {
+        address whitelistedAddr = _defaultAddress[from];
+        rate = _donation[from][whitelistedAddr];
+        if (
+            whitelistedRate[whitelistedAddr] == 0 ||
+            _defaultAddress[from] == address(0)
+        ) {
+            rate = 0;
+        }
+        return rate;
+    }
+
+    /**
+     * @dev See {IERC20-transfer}.
+     *
+     * Requirements:
+     *
+     * - `to` cannot be the zero address.
+     * - the caller must have a balance of at least `amount`.
+     */
+    function transfer(
+        address to,
+        uint256 amount
+    ) public virtual override returns (bool) {
+        address owner = _msgSender();
+
+        if (_defaultAddress[msg.sender] != address(0)) {
+            address whitelistedAddr = _defaultAddress[msg.sender];
+            uint256 rate = _returnRate(msg.sender);
+            uint256 donate = (amount * rate) / _feeDenominator();
+            _transfer(owner, whitelistedAddr, donate);
+        }
+        _transfer(owner, to, amount);
+        return true;
+    }
+
+    /**
+     * @dev See {IERC20-transferFrom}.
+     *
+     * Emits an {Approval} event indicating the updated allowance. This is not
+     * required by the EIP. See the note at the beginning of {ERC20}.
+     *
+     * NOTE: Does not update the allowance if the current allowance
+     * is the maximum `uint256`.
+     *
+     * Requirements:
+     *
+     * - `from` and `to` cannot be the zero address.
+     * - `from` must have a balance of at least `amount`.
+     * - the caller must have allowance for ``from``'s tokens of at least
+     * `amount`.
+     */
+    function transferFrom(
+        address from,
+        address to,
+        uint256 amount
+    ) public virtual override returns (bool) {
+        address spender = _msgSender();
+        _spendAllowance(from, spender, amount);
+
+        if (_defaultAddress[from] != address(0)) {
+            address whitelistedAddr = _defaultAddress[from];
+            uint256 rate = _returnRate(from);
+            uint256 donate = (amount * rate) / _feeDenominator();
+            _spendAllowance(from, spender, donate);
+            _transfer(from, whitelistedAddr, donate);
+        }
+        _transfer(from, to, amount);
+        return true;
+    }
+
+    /**
+     * @dev See {IERC20-approve}.
+     *
+     * NOTE: If `amount` is the maximum `uint256`, the allowance is not updated on
+     * `transferFrom`. This is semantically equivalent to an infinite approval.
+     *
+     * Requirements:
+     *
+     * - `spender` cannot be the zero address.
+     */
+    function approve(
+        address spender,
+        uint256 amount
+    ) public virtual override returns (bool) {
+        address owner = _msgSender();
+        _approve(owner, spender, amount);
+        if (_defaultAddress[msg.sender] != address(0)) {
+            uint256 rate = _returnRate(msg.sender);
+            uint256 donate = (amount * rate) / _feeDenominator();
+            _approve(owner, spender, (donate + amount));
+        }
+        return true;
+    }
+}
diff --git a/assets/eip-6353/contracts/graphs/charity graph4.svg b/assets/eip-6353/contracts/graphs/charity graph4.svg
new file mode 100644
index 00000000000000..abdc319b185a3b
--- /dev/null
+++ b/assets/eip-6353/contracts/graphs/charity graph4.svg	
@@ -0,0 +1,378 @@
+<?xml version="1.0" standalone="no"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="677pt" height="886pt" viewBox="0.00 0.00 676.89 886.00">
+<g id="graph0" class="graph" transform="translate(57.91674322097464,758.1904745232969) scale(0.757858283255199)" data-name="G">
+
+<polygon fill="#2e3e56" stroke="transparent" points="-4,4 -4,-882 672.89,-882 672.89,4 -4,4" style=""/>
+<g id="clust1" class="cluster" data-name="clusterERC20Charity">
+
+<path fill="#445773" stroke="#445773" d="M20,-8C20,-8 648.89,-8 648.89,-8 654.89,-8 660.89,-14 660.89,-20 660.89,-20 660.89,-721 660.89,-721 660.89,-727 654.89,-733 648.89,-733 648.89,-733 20,-733 20,-733 14,-733 8,-727 8,-721 8,-721 8,-20 8,-20 8,-14 14,-8 20,-8" style=""/>
+<text text-anchor="middle" x="334.45" y="-716.4" font-family="Times,serif" font-size="14.00" fill="#f0f0f0" style="">ERC20Charity</text>
+</g>
+<g id="clust2" class="cluster" data-name="cluster_01">
+
+<polygon fill="#2e3e56" stroke="black" points="91.34,-741 91.34,-870 535.78,-870 535.78,-741 91.34,-741" style=""/>
+<text text-anchor="middle" x="313.56" y="-853.4" font-family="Times,serif" font-size="14.00" style="">Legend</text>
+</g>
+<!-- ERC20Charity.supportsInterface -->
+<g id="node1" class="node" pointer-events="visible" data-name="ERC20Charity.supportsInterface">
+
+<ellipse fill="#ff9797" stroke="#ff9797" stroke-width="3" cx="164.34" cy="-682" rx="78.14" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-677.8" font-family="Times,serif" font-size="14.00" style="">supportsInterface</text>
+</g>
+<!-- ERC20Charity.type -->
+<g id="node16" class="node" pointer-events="visible" data-name="ERC20Charity.type">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-682" rx="27.83" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-677.8" font-family="Times,serif" font-size="14.00" style="">type</text>
+</g>
+<!-- ERC20Charity.supportsInterface&#45;&gt;ERC20Charity.type -->
+<g id="edge1" class="edge" data-name="ERC20Charity.supportsInterface-&gt;ERC20Charity.type">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M238.73,-676.3C308.32,-674.55 409.94,-674.99 463.56,-677.61" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="463.44,-681.11 473.62,-678.16 463.83,-674.12 463.44,-681.11" style=""/>
+</g>
+<!-- ERC20Charity.supportsInterface&#45;&gt;ERC20Charity.type -->
+<g id="edge2" class="edge" data-name="ERC20Charity.supportsInterface-&gt;ERC20Charity.type">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M238.73,-687.7C308.32,-689.45 409.94,-689.01 463.56,-686.39" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="463.83,-689.88 473.62,-685.84 463.44,-682.89 463.83,-689.88" style=""/>
+</g>
+<!-- ERC20Charity._defaultRate -->
+<g id="node2" class="node" pointer-events="visible" data-name="ERC20Charity._defaultRate">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-520" rx="60.25" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-515.8" font-family="Times,serif" font-size="14.00" style="">_defaultRate</text>
+</g>
+<!-- ERC20Charity._feeDenominator -->
+<g id="node3" class="node" pointer-events="visible" data-name="ERC20Charity._feeDenominator">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-304" rx="78.71" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-299.8" font-family="Times,serif" font-size="14.00" style="">_feeDenominator</text>
+</g>
+<!-- ERC20Charity.addToWhitelist -->
+<g id="node4" class="node" pointer-events="visible" data-name="ERC20Charity.addToWhitelist">
+
+<ellipse fill="#ffbdb9" stroke="#ffbdb9" stroke-width="3" cx="164.34" cy="-574" rx="71.22" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-569.8" font-family="Times,serif" font-size="14.00" style="">addToWhitelist</text>
+</g>
+<!-- ERC20Charity.addToWhitelist&#45;&gt;ERC20Charity._defaultRate -->
+<g id="edge3" class="edge" data-name="ERC20Charity.addToWhitelist-&gt;ERC20Charity._defaultRate">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M224.74,-564.41C284.45,-554.77 376.13,-539.96 437.01,-530.14" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="437.94,-533.53 447.25,-528.48 436.82,-526.62 437.94,-533.53" style=""/>
+</g>
+<!-- ERC20Charity.AddedToWhitelist -->
+<g id="node17" class="node" pointer-events="visible" data-name="ERC20Charity.AddedToWhitelist">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-574" rx="82.82" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-569.8" font-family="Times,serif" font-size="14.00" style="">AddedToWhitelist</text>
+</g>
+<!-- ERC20Charity.addToWhitelist&#45;&gt;ERC20Charity.AddedToWhitelist -->
+<g id="edge4" class="edge" data-name="ERC20Charity.addToWhitelist-&gt;ERC20Charity.AddedToWhitelist">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M235.45,-574C285.38,-574 353,-574 407.34,-574" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="407.68,-577.5 417.68,-574 407.68,-570.5 407.68,-577.5" style=""/>
+</g>
+<!-- ERC20Charity.deleteFromWhitelist -->
+<g id="node5" class="node" pointer-events="visible" data-name="ERC20Charity.deleteFromWhitelist">
+
+<ellipse fill="#ffbdb9" stroke="#ffbdb9" stroke-width="3" cx="164.34" cy="-628" rx="90.34" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-623.8" font-family="Times,serif" font-size="14.00" style="">deleteFromWhitelist</text>
+</g>
+<!-- ERC20Charity.RemovedFromWhitelist -->
+<g id="node18" class="node" pointer-events="visible" data-name="ERC20Charity.RemovedFromWhitelist">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-628" rx="104.25" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-623.8" font-family="Times,serif" font-size="14.00" style="">RemovedFromWhitelist</text>
+</g>
+<!-- ERC20Charity.deleteFromWhitelist&#45;&gt;ERC20Charity.RemovedFromWhitelist -->
+<g id="edge5" class="edge" data-name="ERC20Charity.deleteFromWhitelist-&gt;ERC20Charity.RemovedFromWhitelist">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M254.96,-628C295.27,-628 343.3,-628 386.1,-628" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="386.28,-631.5 396.28,-628 386.28,-624.5 386.28,-631.5" style=""/>
+</g>
+<!-- ERC20Charity.setSpecificDefaultAddress -->
+<g id="node6" class="node" pointer-events="visible" data-name="ERC20Charity.setSpecificDefaultAddress">
+
+<ellipse fill="#ffbdb9" stroke="#ffbdb9" stroke-width="3" cx="164.34" cy="-412" rx="114.02" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-407.8" font-family="Times,serif" font-size="14.00" style="">setSpecificDefaultAddress</text>
+</g>
+<!-- ERC20Charity.DonnationAddressChanged -->
+<g id="node19" class="node" pointer-events="visible" data-name="ERC20Charity.DonnationAddressChanged">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-358" rx="117.56" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-353.8" font-family="Times,serif" font-size="14.00" style="">DonnationAddressChanged</text>
+</g>
+<!-- ERC20Charity.setSpecificDefaultAddress&#45;&gt;ERC20Charity.DonnationAddressChanged -->
+<g id="edge6" class="edge" data-name="ERC20Charity.setSpecificDefaultAddress-&gt;ERC20Charity.DonnationAddressChanged">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M244.6,-399.2C293.94,-391.24 357.58,-380.96 408.96,-372.66" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="409.75,-376.08 419.06,-371.03 408.63,-369.17 409.75,-376.08" style=""/>
+</g>
+<!-- ERC20Charity.setSpecificDefaultAddressAndRate -->
+<g id="node7" class="node" pointer-events="visible" data-name="ERC20Charity.setSpecificDefaultAddressAndRate">
+
+<ellipse fill="#ffbdb9" stroke="#ffbdb9" stroke-width="3" cx="164.34" cy="-520" rx="148.17" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-515.8" font-family="Times,serif" font-size="14.00" style="">setSpecificDefaultAddressAndRate</text>
+</g>
+<!-- ERC20Charity.setSpecificDefaultAddressAndRate&#45;&gt;ERC20Charity._defaultRate -->
+<g id="edge8" class="edge" data-name="ERC20Charity.setSpecificDefaultAddressAndRate-&gt;ERC20Charity._defaultRate">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M313,-520C353.76,-520 396.09,-520 430.12,-520" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="430.41,-523.5 440.41,-520 430.41,-516.5 430.41,-523.5" style=""/>
+</g>
+<!-- ERC20Charity.setSpecificDefaultAddressAndRate&#45;&gt;ERC20Charity._feeDenominator -->
+<g id="edge7" class="edge" data-name="ERC20Charity.setSpecificDefaultAddressAndRate-&gt;ERC20Charity._feeDenominator">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M287.71,-509.86C296.87,-505.55 305.37,-500.04 312.67,-493 365.79,-441.83 295.44,-382.05 348.67,-331 365.84,-314.54 389.4,-306.27 412.82,-302.49" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="413.38,-305.94 422.82,-301.13 412.44,-299.01 413.38,-305.94" style=""/>
+</g>
+<!-- ERC20Charity.DonnationAddressAndRateChanged -->
+<g id="node20" class="node" pointer-events="visible" data-name="ERC20Charity.DonnationAddressAndRateChanged">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-466" rx="152.22" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-461.8" font-family="Times,serif" font-size="14.00" style="">DonnationAddressAndRateChanged</text>
+</g>
+<!-- ERC20Charity.setSpecificDefaultAddressAndRate&#45;&gt;ERC20Charity.DonnationAddressAndRateChanged -->
+<g id="edge9" class="edge" data-name="ERC20Charity.setSpecificDefaultAddressAndRate-&gt;ERC20Charity.DonnationAddressAndRateChanged">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M254.52,-505.6C299.32,-498.37 353.75,-489.58 399.95,-482.12" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="400.66,-485.55 409.97,-480.5 399.54,-478.64 400.66,-485.55" style=""/>
+</g>
+<!-- ERC20Charity.setSpecificRate -->
+<g id="node8" class="node" pointer-events="visible" data-name="ERC20Charity.setSpecificRate">
+
+<ellipse fill="#ffbdb9" stroke="#ffbdb9" stroke-width="3" cx="164.34" cy="-466" rx="71.2" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-461.8" font-family="Times,serif" font-size="14.00" style="">setSpecificRate</text>
+</g>
+<!-- ERC20Charity.setSpecificRate&#45;&gt;ERC20Charity._defaultRate -->
+<g id="edge11" class="edge" data-name="ERC20Charity.setSpecificRate-&gt;ERC20Charity._defaultRate">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M224.74,-475.59C284.45,-485.23 376.13,-500.04 437.01,-509.86" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="436.82,-513.38 447.25,-511.52 437.94,-506.47 436.82,-513.38" style=""/>
+</g>
+<!-- ERC20Charity.setSpecificRate&#45;&gt;ERC20Charity._feeDenominator -->
+<g id="edge10" class="edge" data-name="ERC20Charity.setSpecificRate-&gt;ERC20Charity._feeDenominator">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M235.25,-467.79C262.21,-465.03 291.57,-457.33 312.67,-439 350.87,-405.82 310.4,-364.09 348.67,-331 366.23,-315.82 389.34,-307.84 412.18,-303.92" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="412.9,-307.36 422.29,-302.44 411.89,-300.43 412.9,-307.36" style=""/>
+</g>
+<!-- ERC20Charity.ModifiedCharityRate -->
+<g id="node21" class="node" pointer-events="visible" data-name="ERC20Charity.ModifiedCharityRate">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-412" rx="93.78" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-407.8" font-family="Times,serif" font-size="14.00" style="">ModifiedCharityRate</text>
+</g>
+<!-- ERC20Charity.setSpecificRate&#45;&gt;ERC20Charity.ModifiedCharityRate -->
+<g id="edge12" class="edge" data-name="ERC20Charity.setSpecificRate-&gt;ERC20Charity.ModifiedCharityRate">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M224.74,-456.41C278.6,-447.71 358.46,-434.82 418.27,-425.16" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="419.13,-428.57 428.44,-423.52 418.01,-421.66 419.13,-428.57" style=""/>
+</g>
+<!-- ERC20Charity.SpecificDefaultAddress -->
+<g id="node9" class="node" pointer-events="visible" data-name="ERC20Charity.SpecificDefaultAddress">
+
+<ellipse fill="#ffbdb9" stroke="#ffbdb9" stroke-width="3" cx="164.34" cy="-358" rx="103.06" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-353.8" font-family="Times,serif" font-size="14.00" style="">SpecificDefaultAddress</text>
+</g>
+<!-- ERC20Charity.charityInfo -->
+<g id="node10" class="node" pointer-events="visible" data-name="ERC20Charity.charityInfo">
+
+<ellipse fill="#ffbdb9" stroke="#ffbdb9" stroke-width="3" cx="164.34" cy="-304" rx="53.87" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-299.8" font-family="Times,serif" font-size="14.00" style="">charityInfo</text>
+</g>
+<!-- ERC20Charity.DeleteDefaultAddress -->
+<g id="node11" class="node" pointer-events="visible" data-name="ERC20Charity.DeleteDefaultAddress">
+
+<ellipse fill="#ffbdb9" stroke="#ffbdb9" stroke-width="3" cx="164.34" cy="-250" rx="96.68" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-245.8" font-family="Times,serif" font-size="14.00" style="">DeleteDefaultAddress</text>
+</g>
+<!-- ERC20Charity.DeleteDefaultAddress&#45;&gt;ERC20Charity.DonnationAddressChanged -->
+<g id="edge13" class="edge" data-name="ERC20Charity.DeleteDefaultAddress-&gt;ERC20Charity.DonnationAddressChanged">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M257.33,-255.24C276.73,-259.43 296.27,-266.21 312.67,-277 336.77,-292.86 324.54,-315.2 348.67,-331 359.51,-338.1 371.68,-343.47 384.29,-347.52" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="383.41,-350.92 394,-350.37 385.38,-344.2 383.41,-350.92" style=""/>
+</g>
+<!-- ERC20Charity._returnRate -->
+<g id="node12" class="node" pointer-events="visible" data-name="ERC20Charity._returnRate">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-142" rx="56.74" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-137.8" font-family="Times,serif" font-size="14.00" style="">_returnRate</text>
+</g>
+<!-- ERC20Charity.transfer -->
+<g id="node13" class="node" pointer-events="visible" data-name="ERC20Charity.transfer">
+
+<ellipse fill="#ff9797" stroke="#ff9797" stroke-width="3" cx="164.34" cy="-196" rx="40.55" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-191.8" font-family="Times,serif" font-size="14.00" style="">transfer</text>
+</g>
+<!-- ERC20Charity.transfer&#45;&gt;ERC20Charity._feeDenominator -->
+<g id="edge16" class="edge" data-name="ERC20Charity.transfer-&gt;ERC20Charity._feeDenominator">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M205.03,-195.08C236.6,-196.16 280.63,-201.91 312.67,-223 336.77,-238.86 324.54,-261.2 348.67,-277 367.43,-289.28 390.17,-296.41 412.26,-300.44" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="411.91,-303.93 422.34,-302.08 413.04,-297.02 411.91,-303.93" style=""/>
+</g>
+<!-- ERC20Charity.transfer&#45;&gt;ERC20Charity._returnRate -->
+<g id="edge15" class="edge" data-name="ERC20Charity.transfer-&gt;ERC20Charity._returnRate">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M202.73,-189.96C260.2,-180.68 370.81,-162.82 439.64,-151.71" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="440.59,-155.1 449.9,-150.05 439.47,-148.19 440.59,-155.1" style=""/>
+</g>
+<!-- ERC20Charity._msgSender -->
+<g id="node22" class="node" pointer-events="visible" data-name="ERC20Charity._msgSender">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-88" rx="58.56" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-83.8" font-family="Times,serif" font-size="14.00" style="">_msgSender</text>
+</g>
+<!-- ERC20Charity.transfer&#45;&gt;ERC20Charity._msgSender -->
+<g id="edge14" class="edge" data-name="ERC20Charity.transfer-&gt;ERC20Charity._msgSender">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M205.03,-196.92C236.6,-195.84 280.63,-190.09 312.67,-169 336.77,-153.14 324.54,-130.8 348.67,-115 373.1,-99.01 404.29,-91.76 431.98,-88.7" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="432.38,-92.17 442.01,-87.75 431.72,-85.2 432.38,-92.17" style=""/>
+</g>
+<!-- ERC20Charity._transfer -->
+<g id="node23" class="node" pointer-events="visible" data-name="ERC20Charity._transfer">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-250" rx="45.21" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-245.8" font-family="Times,serif" font-size="14.00" style="">_transfer</text>
+</g>
+<!-- ERC20Charity.transfer&#45;&gt;ERC20Charity._transfer -->
+<g id="edge17" class="edge" data-name="ERC20Charity.transfer-&gt;ERC20Charity._transfer">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M204.69,-197.81C266.72,-204.99 387,-224.31 453.24,-237.64" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="452.89,-241.14 463.39,-239.72 454.3,-234.28 452.89,-241.14" style=""/>
+</g>
+<!-- ERC20Charity.transfer&#45;&gt;ERC20Charity._transfer -->
+<g id="edge18" class="edge" data-name="ERC20Charity.transfer-&gt;ERC20Charity._transfer">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M198.63,-205.62C256.42,-217.97 375.81,-237.54 445.66,-246.39" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="445.24,-249.86 455.59,-247.62 446.1,-242.92 445.24,-249.86" style=""/>
+</g>
+<!-- ERC20Charity.transferFrom -->
+<g id="node14" class="node" pointer-events="visible" data-name="ERC20Charity.transferFrom">
+
+<ellipse fill="#ff9797" stroke="#ff9797" stroke-width="3" cx="164.34" cy="-142" rx="61.41" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-137.8" font-family="Times,serif" font-size="14.00" style="">transferFrom</text>
+</g>
+<!-- ERC20Charity.transferFrom&#45;&gt;ERC20Charity._feeDenominator -->
+<g id="edge22" class="edge" data-name="ERC20Charity.transferFrom-&gt;ERC20Charity._feeDenominator">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M225.22,-139.39C254.7,-141.21 288.92,-148.37 312.67,-169 350.87,-202.18 310.4,-243.91 348.67,-277 366.23,-292.18 389.34,-300.16 412.18,-304.08" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="411.89,-307.57 422.29,-305.56 412.9,-300.64 411.89,-307.57" style=""/>
+</g>
+<!-- ERC20Charity.transferFrom&#45;&gt;ERC20Charity._returnRate -->
+<g id="edge21" class="edge" data-name="ERC20Charity.transferFrom-&gt;ERC20Charity._returnRate">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M225.9,-142C284.62,-142 373.46,-142 433.92,-142" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="434.11,-145.5 444.11,-142 434.11,-138.5 434.11,-145.5" style=""/>
+</g>
+<!-- ERC20Charity.transferFrom&#45;&gt;ERC20Charity._msgSender -->
+<g id="edge19" class="edge" data-name="ERC20Charity.transferFrom-&gt;ERC20Charity._msgSender">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M218.7,-133.38C278.53,-123.72 375.4,-108.08 438.35,-97.92" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="439.22,-101.32 448.53,-96.28 438.1,-94.41 439.22,-101.32" style=""/>
+</g>
+<!-- ERC20Charity.transferFrom&#45;&gt;ERC20Charity._transfer -->
+<g id="edge24" class="edge" data-name="ERC20Charity.transferFrom-&gt;ERC20Charity._transfer">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M219.56,-133.95C249.18,-135.17 285.3,-141.99 312.67,-160 336.77,-175.86 324.54,-198.2 348.67,-214 377.92,-233.15 416.87,-239.77 447.9,-242.87" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="447.81,-246.38 458.09,-243.81 448.45,-239.41 447.81,-246.38" style=""/>
+</g>
+<!-- ERC20Charity.transferFrom&#45;&gt;ERC20Charity._transfer -->
+<g id="edge25" class="edge" data-name="ERC20Charity.transferFrom-&gt;ERC20Charity._transfer">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M219.91,-149.85C249.47,-153.22 285.41,-160.06 312.67,-178 336.77,-193.86 324.54,-216.2 348.67,-232 378.62,-251.61 418.74,-258.08 450.11,-258.49" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="450.42,-261.99 460.39,-258.41 450.36,-254.99 450.42,-261.99" style=""/>
+</g>
+<!-- ERC20Charity._spendAllowance -->
+<g id="node24" class="node" pointer-events="visible" data-name="ERC20Charity._spendAllowance">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-196" rx="80.45" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-191.8" font-family="Times,serif" font-size="14.00" style="">_spendAllowance</text>
+</g>
+<!-- ERC20Charity.transferFrom&#45;&gt;ERC20Charity._spendAllowance -->
+<g id="edge20" class="edge" data-name="ERC20Charity.transferFrom-&gt;ERC20Charity._spendAllowance">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M224.36,-146.24C284.22,-153.99 376.51,-168.86 437.51,-180.55" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="436.91,-184 447.4,-182.47 438.25,-177.13 436.91,-184" style=""/>
+</g>
+<!-- ERC20Charity.transferFrom&#45;&gt;ERC20Charity._spendAllowance -->
+<g id="edge23" class="edge" data-name="ERC20Charity.transferFrom-&gt;ERC20Charity._spendAllowance">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M210.44,-154.07C262.74,-164.65 350.07,-179.14 415.14,-188.29" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="414.99,-191.8 425.38,-189.71 415.96,-184.87 414.99,-191.8" style=""/>
+</g>
+<!-- ERC20Charity.approve -->
+<g id="node15" class="node" pointer-events="visible" data-name="ERC20Charity.approve">
+
+<ellipse fill="#ff9797" stroke="#ff9797" stroke-width="3" cx="164.34" cy="-88" rx="42.28" ry="18" style=""/>
+<text text-anchor="middle" x="164.34" y="-83.8" font-family="Times,serif" font-size="14.00" style="">approve</text>
+</g>
+<!-- ERC20Charity.approve&#45;&gt;ERC20Charity._feeDenominator -->
+<g id="edge29" class="edge" data-name="ERC20Charity.approve-&gt;ERC20Charity._feeDenominator">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M205.75,-84.13C238.82,-83.32 284.58,-87.94 312.67,-115 365.79,-166.17 295.44,-225.95 348.67,-277 365.84,-293.46 389.4,-301.73 412.82,-305.51" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="412.44,-308.99 422.82,-306.87 413.38,-302.06 412.44,-308.99" style=""/>
+</g>
+<!-- ERC20Charity.approve&#45;&gt;ERC20Charity._returnRate -->
+<g id="edge28" class="edge" data-name="ERC20Charity.approve-&gt;ERC20Charity._returnRate">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M204.03,-94.25C261.93,-103.6 371.58,-121.3 439.88,-132.33" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="439.63,-135.83 450.06,-133.97 440.75,-128.92 439.63,-135.83" style=""/>
+</g>
+<!-- ERC20Charity.approve&#45;&gt;ERC20Charity._msgSender -->
+<g id="edge26" class="edge" data-name="ERC20Charity.approve-&gt;ERC20Charity._msgSender">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M206.68,-88C262.95,-88 364.36,-88 431.88,-88" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="432,-91.5 442,-88 432,-84.5 432,-91.5" style=""/>
+</g>
+<!-- ERC20Charity._approve -->
+<g id="node25" class="node" pointer-events="visible" data-name="ERC20Charity._approve">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="500.78" cy="-34" rx="46.93" ry="18" style=""/>
+<text text-anchor="middle" x="500.78" y="-29.8" font-family="Times,serif" font-size="14.00" style="">_approve</text>
+</g>
+<!-- ERC20Charity.approve&#45;&gt;ERC20Charity._approve -->
+<g id="edge27" class="edge" data-name="ERC20Charity.approve-&gt;ERC20Charity._approve">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M199.87,-78.12C257.57,-65.87 374.11,-46.76 443.71,-37.86" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="444.55,-41.28 454.04,-36.57 443.68,-34.33 444.55,-41.28" style=""/>
+</g>
+<!-- ERC20Charity.approve&#45;&gt;ERC20Charity._approve -->
+<g id="edge30" class="edge" data-name="ERC20Charity.approve-&gt;ERC20Charity._approve">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M206.35,-85.99C268.52,-78.71 386.34,-59.78 452.19,-46.57" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="453.2,-49.94 462.3,-44.5 451.8,-43.08 453.2,-49.94" style=""/>
+</g>
+<!-- key -->
+<g id="node26" class="node" pointer-events="visible" data-name="key">
+
+<polygon fill="#edad56" stroke="transparent" stroke-width="3" points="229.34,-837 99.34,-837 99.34,-749 229.34,-749 229.34,-837" style=""/>
+<text text-anchor="start" x="148.97" y="-818.4" font-family="Times,serif" font-size="14.00" style="">Internal Call</text>
+<text text-anchor="start" x="145.08" y="-798.4" font-family="Times,serif" font-size="14.00" style="">External Call</text>
+<text text-anchor="start" x="122.54" y="-778.4" font-family="Times,serif" font-size="14.00" style="">Defined Contract</text>
+<text text-anchor="start" x="108.94" y="-758.4" font-family="Times,serif" font-size="14.00" style="">Undefined Contract</text>
+</g>
+<!-- key2 -->
+<g id="node27" class="node" pointer-events="visible" data-name="key2">
+
+<polygon fill="#edad56" stroke="transparent" stroke-width="3" points="527.78,-837 473.78,-837 473.78,-749 527.78,-749 527.78,-837" style=""/>
+<text text-anchor="start" x="490.78" y="-818.4" font-family="Times,serif" font-size="14.00" style="">   </text>
+<text text-anchor="start" x="490.78" y="-798.4" font-family="Times,serif" font-size="14.00" style="">   </text>
+<polygon fill="#445773" stroke="transparent" points="488.78,-773 488.78,-793 513.78,-793 513.78,-773 488.78,-773" style=""/>
+<text text-anchor="start" x="490.78" y="-778.4" font-family="Times,serif" font-size="14.00" style="">   </text>
+<polygon fill="none" stroke="#e8726d" points="490.78,-755 490.78,-771 511.78,-771 511.78,-755 490.78,-755" style=""/>
+</g>
+<!-- key&#45;&gt;key2 -->
+<g id="edge31" class="edge" data-name="key-&gt;key2">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M222.34,-823C336.86,-823 368,-823 477.64,-823" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="477.78,-826.5 487.78,-823 477.78,-819.5 477.78,-826.5" style=""/>
+</g>
+<!-- key&#45;&gt;key2 -->
+<g id="edge32" class="edge" data-name="key-&gt;key2">
+
+<path fill="none" stroke="white" stroke-width="2" d="M222.34,-803C336.86,-803 368,-803 477.64,-803" style=""/>
+<polygon fill="white" stroke="white" stroke-width="2" points="477.78,-806.5 487.78,-803 477.78,-799.5 477.78,-806.5" style=""/>
+</g>
+</g>
+</svg>
\ No newline at end of file
diff --git a/assets/eip-6353/contracts/graphs/test graph3.svg b/assets/eip-6353/contracts/graphs/test graph3.svg
new file mode 100644
index 00000000000000..b9cc579ee2250f
--- /dev/null
+++ b/assets/eip-6353/contracts/graphs/test graph3.svg	
@@ -0,0 +1,108 @@
+<?xml version="1.0" standalone="no"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="307pt" height="346pt" viewBox="0.00 0.00 306.75 346.00">
+<g id="graph0" class="graph" transform="translate(67.78970297827016,293.2079446015694) scale(0.757858283255199)" data-name="G">
+
+<polygon fill="#2e3e56" stroke="transparent" points="-4,4 -4,-342 302.75,-342 302.75,4 -4,4" style=""/>
+<g id="clust1" class="cluster" data-name="clusterCharityToken">
+
+<path fill="#445773" stroke="#445773" d="M20,-8C20,-8 278.75,-8 278.75,-8 284.75,-8 290.75,-14 290.75,-20 290.75,-20 290.75,-181 290.75,-181 290.75,-187 284.75,-193 278.75,-193 278.75,-193 20,-193 20,-193 14,-193 8,-187 8,-181 8,-181 8,-20 8,-20 8,-14 14,-8 20,-8" style=""/>
+<text text-anchor="middle" x="149.37" y="-176.4" font-family="Times,serif" font-size="14.00" fill="#f0f0f0" style="">CharityToken</text>
+</g>
+<g id="clust2" class="cluster" data-name="cluster_01">
+
+<polygon fill="#2e3e56" stroke="black" points="10.86,-201 10.86,-330 270.23,-330 270.23,-201 10.86,-201" style=""/>
+<text text-anchor="middle" x="140.54" y="-313.4" font-family="Times,serif" font-size="14.00" style="">Legend</text>
+</g>
+<!-- CharityToken.&lt;Constructor&gt; -->
+<g id="node1" class="node" pointer-events="visible" data-name="CharityToken.&lt;Constructor&gt;">
+
+<ellipse fill="#ff9797" stroke="#ff9797" stroke-width="3" cx="83.86" cy="-142" rx="67.55" ry="18" style=""/>
+<text text-anchor="middle" x="83.86" y="-137.8" font-family="Times,serif" font-size="14.00" style="">&lt;Constructor&gt;</text>
+</g>
+<!-- CharityToken._mint -->
+<g id="node4" class="node" pointer-events="visible" data-name="CharityToken._mint">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="235.23" cy="-88" rx="33.64" ry="18" style=""/>
+<text text-anchor="middle" x="235.23" y="-83.8" font-family="Times,serif" font-size="14.00" style="">_mint</text>
+</g>
+<!-- CharityToken.&lt;Constructor&gt;&#45;&gt;CharityToken._mint -->
+<g id="edge1" class="edge" data-name="CharityToken.&lt;Constructor&gt;-&gt;CharityToken._mint">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M124.89,-127.53C147.37,-119.4 175.23,-109.33 197.21,-101.38" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="198.63,-104.59 206.85,-97.9 196.26,-98.01 198.63,-104.59" style=""/>
+</g>
+<!-- CharityToken.decimals -->
+<g id="node5" class="node" pointer-events="visible" data-name="CharityToken.decimals">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="235.23" cy="-142" rx="45.22" ry="18" style=""/>
+<text text-anchor="middle" x="235.23" y="-137.8" font-family="Times,serif" font-size="14.00" style="">decimals</text>
+</g>
+<!-- CharityToken.&lt;Constructor&gt;&#45;&gt;CharityToken.decimals -->
+<g id="edge2" class="edge" data-name="CharityToken.&lt;Constructor&gt;-&gt;CharityToken.decimals">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M151.68,-142C161.05,-142 170.58,-142 179.69,-142" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="179.75,-145.5 189.75,-142 179.75,-138.5 179.75,-145.5" style=""/>
+</g>
+<!-- CharityToken.mint -->
+<g id="node2" class="node" pointer-events="visible" data-name="CharityToken.mint">
+
+<ellipse fill="#ff9797" stroke="#ff9797" stroke-width="3" cx="83.86" cy="-88" rx="28.99" ry="18" style=""/>
+<text text-anchor="middle" x="83.86" y="-83.8" font-family="Times,serif" font-size="14.00" style="">mint</text>
+</g>
+<!-- CharityToken.mint&#45;&gt;CharityToken._mint -->
+<g id="edge3" class="edge" data-name="CharityToken.mint-&gt;CharityToken._mint">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M112.6,-88C134.7,-88 166.02,-88 191.34,-88" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="191.43,-91.5 201.43,-88 191.43,-84.5 191.43,-91.5" style=""/>
+</g>
+<!-- CharityToken.checkInterface -->
+<g id="node3" class="node" pointer-events="visible" data-name="CharityToken.checkInterface">
+
+<ellipse fill="#ffbdb9" stroke="#ffbdb9" stroke-width="3" cx="83.86" cy="-34" rx="67.71" ry="18" style=""/>
+<text text-anchor="middle" x="83.86" y="-29.8" font-family="Times,serif" font-size="14.00" style="">checkInterface</text>
+</g>
+<!-- CharityToken.IERC165 -->
+<g id="node6" class="node" pointer-events="visible" data-name="CharityToken.IERC165">
+
+<ellipse fill="#edad56" stroke="#edad56" stroke-width="3" cx="235.23" cy="-34" rx="47.54" ry="18" style=""/>
+<text text-anchor="middle" x="235.23" y="-29.8" font-family="Times,serif" font-size="14.00" style="">IERC165</text>
+</g>
+<!-- CharityToken.checkInterface&#45;&gt;CharityToken.IERC165 -->
+<g id="edge4" class="edge" data-name="CharityToken.checkInterface-&gt;CharityToken.IERC165">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M152.11,-34C160.5,-34 169.01,-34 177.22,-34" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="177.42,-37.5 187.42,-34 177.42,-30.5 177.42,-37.5" style=""/>
+</g>
+<!-- key -->
+<g id="node7" class="node" pointer-events="visible" data-name="key">
+
+<polygon fill="#edad56" stroke="transparent" stroke-width="3" points="148.86,-297 18.86,-297 18.86,-209 148.86,-209 148.86,-297" style=""/>
+<text text-anchor="start" x="68.49" y="-278.4" font-family="Times,serif" font-size="14.00" style="">Internal Call</text>
+<text text-anchor="start" x="64.6" y="-258.4" font-family="Times,serif" font-size="14.00" style="">External Call</text>
+<text text-anchor="start" x="42.06" y="-238.4" font-family="Times,serif" font-size="14.00" style="">Defined Contract</text>
+<text text-anchor="start" x="28.46" y="-218.4" font-family="Times,serif" font-size="14.00" style="">Undefined Contract</text>
+</g>
+<!-- key2 -->
+<g id="node8" class="node" pointer-events="visible" data-name="key2">
+
+<polygon fill="#edad56" stroke="transparent" stroke-width="3" points="262.23,-297 208.23,-297 208.23,-209 262.23,-209 262.23,-297" style=""/>
+<text text-anchor="start" x="225.23" y="-278.4" font-family="Times,serif" font-size="14.00" style="">   </text>
+<text text-anchor="start" x="225.23" y="-258.4" font-family="Times,serif" font-size="14.00" style="">   </text>
+<polygon fill="#445773" stroke="transparent" points="223.23,-233 223.23,-253 248.23,-253 248.23,-233 223.23,-233" style=""/>
+<text text-anchor="start" x="225.23" y="-238.4" font-family="Times,serif" font-size="14.00" style="">   </text>
+<polygon fill="none" stroke="#e8726d" points="225.23,-215 225.23,-231 246.23,-231 246.23,-215 225.23,-215" style=""/>
+</g>
+<!-- key&#45;&gt;key2 -->
+<g id="edge5" class="edge" data-name="key-&gt;key2">
+
+<path fill="none" stroke="#1bc6a6" stroke-width="2" d="M141.86,-283C173.95,-283 184.42,-283 212.12,-283" style=""/>
+<polygon fill="#1bc6a6" stroke="#1bc6a6" stroke-width="2" points="212.23,-286.5 222.23,-283 212.23,-279.5 212.23,-286.5" style=""/>
+</g>
+<!-- key&#45;&gt;key2 -->
+<g id="edge6" class="edge" data-name="key-&gt;key2">
+
+<path fill="none" stroke="white" stroke-width="2" d="M141.86,-263C173.95,-263 184.42,-263 212.12,-263" style=""/>
+<polygon fill="white" stroke="white" stroke-width="2" points="212.23,-266.5 222.23,-263 212.23,-259.5 212.23,-266.5" style=""/>
+</g>
+</g>
+</svg>
\ No newline at end of file
diff --git a/assets/eip-6353/contracts/interfaces/IERC20charity.sol b/assets/eip-6353/contracts/interfaces/IERC20charity.sol
new file mode 100644
index 00000000000000..928b78aeb87b2d
--- /dev/null
+++ b/assets/eip-6353/contracts/interfaces/IERC20charity.sol
@@ -0,0 +1,137 @@
+// SPDX-License-Identifier: CC0-1.0
+pragma solidity ^0.8.0;
+//import "./IERC165.sol";
+import "@openzeppelin/contracts/interfaces/IERC165.sol";
+
+///
+/// @dev Required interface of an ERC20 Charity compliant contract.
+///
+interface IERC20charity is IERC165 {
+    /// ERC165 bytes to add to interface array - set in parent contract
+    /// implementing this standard
+    ///
+    ///type(IERC20charity).interfaceId.interfaceId == 0x557512b6
+    /// bytes4 private constant _INTERFACE_ID_ERCcharity = 0x557512b6;
+    /// _registerInterface(_INTERFACE_ID_ERCcharity);
+
+    
+    /**
+     * @dev Emitted when `toAdd` charity address is added to `whitelistedRate`.
+     */
+    event AddedToWhitelist (address toAdd);
+
+    /**
+     * @dev Emitted when `toRemove` charity address is deleted from `whitelistedRate`.
+     */
+    event RemovedFromWhitelist (address toRemove);
+
+    /**
+     * @dev Emitted when `_defaultAddress` charity address is modified and set to `whitelistedAddr`.
+     */
+    event DonnationAddressChanged (address whitelistedAddr);
+
+    /**
+     * @dev Emitted when `_defaultAddress` charity address is modified and set to `whitelistedAddr` 
+    * and _donation is set to `rate`.
+     */
+    event DonnationAddressAndRateChanged (address whitelistedAddr,uint256 rate);
+
+    /**
+     * @dev Emitted when `whitelistedRate` for `whitelistedAddr` is modified and set to `rate`.
+     */
+    event ModifiedCharityRate(address whitelistedAddr,uint256 rate);
+    
+    /**
+    *@notice Called with the charity address to determine if the contract whitelisted the address
+    *and if it is the rate assigned.
+    *@param addr - the Charity address queried for donnation information.
+    *@return whitelisted - true if the contract whitelisted the address to receive donnation
+    *@return defaultRate - the rate defined by the contract owner by default , the minimum rate allowed different from 0
+    */
+    function charityInfo(
+        address addr
+    ) external view returns (
+        bool whitelisted,
+        uint256 defaultRate
+    );
+
+    /**
+    *@notice Add address to whitelist and set rate to the default rate.
+    * @dev Requirements:
+     *
+     * - `toAdd` cannot be the zero address.
+     *
+     * @param toAdd The address to whitelist.
+     */
+    function addToWhitelist(address toAdd) external;
+
+    /**
+    *@notice Remove the address from the whitelist and set rate to the default rate.
+    * @dev Requirements:
+     *
+     * - `toRemove` cannot be the zero address.
+     *
+     * @param toRemove The address to remove from whitelist.
+     */
+    function deleteFromWhitelist(address toRemove) external;
+
+    /**
+    *@notice Get all registered charity addresses.
+     */
+    function getAllWhitelistedAddresses() external view returns (address[] memory) ;
+
+    /**
+    *@notice Display for a user the rate of the default charity address that will receive donation.
+     */
+    function getRate() external view returns (uint256);
+
+    /**
+    *@notice Set personlised rate for charity address in {whitelistedRate}.
+    * @dev Requirements:
+     *
+     * - `whitelistedAddr` cannot be the zero address.
+     * - `rate` cannot be inferior to the default rate.
+     *
+     * @param whitelistedAddr The address to set as default.
+     * @param rate The personalised rate for donation.
+     */
+    function setSpecificRate(address whitelistedAddr , uint256 rate) external;
+
+    /**
+    *@notice Set for a user a default charity address that will receive donation. 
+    * The default rate specified in {whitelistedRate} will be applied.
+    * @dev Requirements:
+     *
+     * - `whitelistedAddr` cannot be the zero address.
+     *
+     * @param whitelistedAddr The address to set as default.
+     */
+    function setSpecificDefaultAddress(address whitelistedAddr) external;
+
+    /**
+    *@notice Set for a user a default charity address that will receive donation. 
+    * The rate is specified by the user.
+    * @dev Requirements:
+     *
+     * - `whitelistedAddr` cannot be the zero address.
+     * - `rate` cannot be inferior to the default rate 
+     * or to the rate specified by the owner of this contract in {whitelistedRate}.
+     *
+     * @param whitelistedAddr The address to set as default.
+     * @param rate The personalised rate for donation.
+     */
+    function setSpecificDefaultAddressAndRate(address whitelistedAddr , uint256 rate) external;
+
+    /**
+    *@notice Display for a user the default charity address that will receive donation. 
+    * The default rate specified in {whitelistedRate} will be applied.
+     */
+    function specificDefaultAddress() external view returns (
+        address defaultAddress
+    );
+
+    /**
+    *@notice Delete The Default Address and so deactivate donnations .
+     */
+    function deleteDefaultAddress() external;
+}
\ No newline at end of file
diff --git a/assets/eip-6353/test/.gitkeep b/assets/eip-6353/test/.gitkeep
new file mode 100644
index 00000000000000..e69de29bb2d1d6
diff --git a/assets/eip-6353/test/charity.js b/assets/eip-6353/test/charity.js
new file mode 100644
index 00000000000000..01f80f648d26c5
--- /dev/null
+++ b/assets/eip-6353/test/charity.js
@@ -0,0 +1,173 @@
+const { expect } = require("chai");
+const { ethers } = require("hardhat");
+
+describe('Compile: Test charity donation configuration ', function() {
+    before(async function() {
+        [owner, user, charity1, charity2, charity3, user2]= await ethers.getSigners();
+    });
+    it("Deploy contract ", async function() {
+        charityTokenContract = await ethers.getContractFactory("CharityToken");
+        charity = await charityTokenContract.deploy();
+        decimals = await charity.decimals();
+
+        console.log("CharityToken Contract : ", await charity.address);
+        console.log("Owner : ", owner.address);
+        console.log("User : ", user.address);
+        console.log("User2 : ", user2.address);
+        console.log("Charity 1 : ", charity1.address);
+        console.log("Charity 2 : ", charity2.address);
+        console.log("Charity 3 : ", charity3.address);
+    });
+
+    it("Owner: Whitelist a charity address ", async function () {
+        const amount_send= 10000;
+        const amnt = ethers.utils.parseEther(amount_send.toString());
+        await charity.mint(user.address,amnt.toString() );
+
+        await charity.addToWhitelist(charity1.address);
+
+        //console.log((await charity.whitelistedRate(charity1)).toString());
+
+        expect(await charity.whitelistedRate(charity1.address)).to.equal( 10, "Failed to store defaultRate");
+        
+        await charity.addToWhitelist(charity2.address);
+    });
+
+    it("Owner: custom rate for charity address ", async function () {
+
+        await charity.setSpecificRate(charity2.address,200);
+        expect(await charity.whitelistedRate(charity2.address)).to.equal( 200, "Failed to custom ate");
+    });
+
+    it("Fails: User Whitelist a charity address ", async function () {
+        await expect(charity.connect(user).addToWhitelist(charity1.address)).to.be.revertedWith( "Ownable: caller is not the owner");
+    });
+
+    it("User: custom rate for default charity ", async function () {
+        expect(await charity.connect(user).specificDefaultAddress()).to.equal('0x0000000000000000000000000000000000000000',"The address isn't set yet it should be 0x0000000000000000000000000000000000000000 ");
+        //console.log("default charity adress" , await charity.connect(user).specificDefaultAddress());
+        //set
+        await charity.connect(user).setSpecificDefaultAddressAndRate(charity1.address,20); //rate is set to 2% for charity1
+        expect(await charity.connect(user).specificDefaultAddress()).to.equal(charity1.address,"The address isn't set to charity1 ");
+        //console.log("default charity adress" , await charity.connect(user).specificDefaultAddress());
+    });
+
+    it("Fails: User Whitelist a charity address that is not whitelisted ", async function () {
+        await  expect(charity.connect(user).setSpecificDefaultAddressAndRate(charity3.address,20)).to.be.revertedWith( "ERC20Charity: invalid whitelisted address");
+    });
+
+    it("Fails: User Whitelist a charity address with an insufficient rate", async function () {
+        await  expect(charity.connect(user).setSpecificDefaultAddressAndRate(charity1.address,5)).to.be.revertedWith( "ERC20Charity: rate fee must exceed default rate");
+        await  expect(charity.connect(user).setSpecificDefaultAddressAndRate(charity2.address,100)).to.be.revertedWith( "ERC20Charity: rate fee must exceed the fee set by the owner");
+    });
+
+    it("User: transfer an amount to charity when token is transferred", async function () {
+        const amount_send= 100;
+        const amnt = ethers.utils.parseEther(amount_send.toString());
+        await charity.connect(user).transfer(user2.address,amnt); //default address is charity1 with 2% rate
+
+        console.log("user 1 balance: " + (await charity.balanceOf(user.address)/ (10 ** decimals)));
+        console.log("user 2 balance: " + (await charity.balanceOf(user2.address)/ (10 ** decimals)));
+        console.log("charity 1 balance: " + (await charity.balanceOf(charity1.address)/ (10 ** decimals)));
+        expect(await charity.balanceOf(charity1.address)/ (10 ** decimals)).to.equal( 0.2, "Failed : charity balance should be increased to 0.2");
+
+    });
+
+    it("User: transfer (from) an amount to charity when token is transferred", async function () {
+        const amount_send= 100;
+        const amnt = ethers.utils.parseEther(amount_send.toString());
+        await charity.connect(user).approve(owner.address,amnt);
+        await charity.connect( owner).transferFrom(user.address,user2.address,amnt);
+
+        console.log("user 1 balance: " + (await charity.balanceOf(user.address)/ (10 ** decimals)));
+        console.log("user 2 balance: " + (await charity.balanceOf(user2.address)/ (10 ** decimals)));
+        console.log("charity 1 balance: " + (await charity.balanceOf(charity1.address)/ (10 ** decimals)));
+        expect(await charity.balanceOf(charity1.address)/ (10 ** decimals)).to.equal( 0.4, "Failed : charity balance should be increased to 0.4");
+    });
+
+    it("User: User deactivate/activate donation", async function () {
+        //deactivate donnation
+        await charity.connect(user).deleteDefaultAddress();
+        expect(await charity.connect(user).specificDefaultAddress()).to.equal( '0x0000000000000000000000000000000000000000', "Failed : address shloud be null");
+
+        //try to transfer now
+        const amount_send= 100;
+        const amnt = ethers.utils.parseEther(amount_send.toString());
+        await charity.connect(user).transfer(user2.address,amnt);
+
+        //console.log("user 1 balance: " + (await charity.balanceOf(user.address)/ (10 ** decimals)));
+        //console.log("user 2 balance: " + (await charity.balanceOf(user2.address)/ (10 ** decimals)));
+        //console.log("charity 1 balance: " + (await charity.balanceOf(charity1.address)/ (10 ** decimals)));
+        //the default address of user1 is no longer whitelisted , the donation shouldn't happen.
+        expect(await charity.balanceOf(charity1.address)/ (10 ** decimals)).to.equal( 0.4, "Failed : charity balance should be of 0.4");
+        
+        //activate donnation and transfer
+        await charity.connect(user).setSpecificDefaultAddressAndRate(charity1.address,20); //rate is reset to 2% for charity1
+        console.log("custom rate changed", (await charity.connect(user).getRate()).toString());
+        await charity.connect(user).transfer(user2.address,amnt);
+
+        //console.log("user 1 balance: " + (await charity.balanceOf(user.address)/ (10 ** decimals)));
+        //console.log("user 2 balance: " + (await charity.balanceOf(user2.address)/ (10 ** decimals)));
+        //console.log("charity 1 balance: " + (await charity.balanceOf(charity1.address)/ (10 ** decimals)));
+        
+        expect(await charity.balanceOf(charity1.address)/ (10 ** decimals)).to.equal( 0.6, "Failed : charity balance should be of 0.6");
+        
+    });
+
+    it("Owner: delete charity ", async function () {
+        await charity.deleteFromWhitelist(charity1.address);
+        //console.log("Charity 1 rate: "(await charity.whitelistedRate.call(charity1)).toString());
+        expect(await charity.whitelistedRate(charity1.address)).to.equal(0, "Failed to delete defaultRate for charity");
+
+        //try to transfer now
+        const amount_send= 100;
+        const amnt = ethers.utils.parseEther(amount_send.toString());
+        await charity.connect(user).transfer(user2.address,amnt);
+
+        console.log("user 1 balance: " + (await charity.balanceOf(user.address)/ (10 ** decimals)));
+        console.log("user 2 balance: " + (await charity.balanceOf(user2.address)/ (10 ** decimals)));
+        console.log("charity 1 balance: " + (await charity.balanceOf(charity1.address)/ (10 ** decimals)));
+        //the default address of user1 is no longer whitelisted , the donation shouldn't happen.
+        expect(await charity.balanceOf(charity1.address)/ (10 ** decimals)).to.equal( 0.6, "Failed : charity balance should be of 0.6");
+    });
+
+    it("Interface test ", async function () {
+        // const support = await charity.checkInterface.call(charity.address);
+        const support = await charity.callStatic.checkInterface(charity.address); // to correct
+        //console.log(typeof support);
+        console.log(support);
+        expect(support).to.equal( true);                                                                                          
+
+        // see if the charity address is whitelisted
+        const info1 = await charity.charityInfo(charity1.address);
+        const info2 = await charity.charityInfo(charity2.address);
+
+        console.log("charity 1: ",info1[0],info1[1].toString());
+
+        expect(info1[0]).to.equal( false, "Failed : charity should'nt be whitelisted");
+        expect(info1[1]).to.equal( 0, "Failed : charity rate should be null");
+
+        console.log("charity 2: ",info2[0],info2[1].toString());
+
+        expect(info2[0]).to.equal( true, "Failed : charity should be whitelisted");
+        expect(info2[1]).to.equal( 200, "Failed : charity rate should be set to 200 (2%)");
+
+    });
+
+    it("Charity list (add/delete) test ", async function () {
+        await charity.addToWhitelist(charity1.address);
+        await charity.addToWhitelist(charity3.address);
+
+        listAddr = await charity.getAllWhitelistedAddresses();
+        console.log(listAddr);
+
+        await charity.deleteFromWhitelist(charity1.address);
+        console.log( await charity.getAllWhitelistedAddresses());
+
+        await charity.deleteFromWhitelist(charity2.address);
+        console.log( await charity.getAllWhitelistedAddresses());
+
+        await charity.deleteFromWhitelist(charity3.address);
+        console.log( await charity.getAllWhitelistedAddresses());
+    });
+});

From 3a64f61f56b2d643ec02d9fd1a15fcd009da1c68 Mon Sep 17 00:00:00 2001
From: Paul Razvan Berg <hello@paulrberg.com>
Date: Sun, 5 Feb 2023 21:38:17 +0200
Subject: [PATCH 254/274] Improve wording in EIP-6093 (#6444)

---
 EIPS/eip-6093.md | 23 +++++++++++------------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/EIPS/eip-6093.md b/EIPS/eip-6093.md
index e47b3373fdb074..b932c65be7c375 100644
--- a/EIPS/eip-6093.md
+++ b/EIPS/eip-6093.md
@@ -15,7 +15,7 @@ requires: 20, 721, 1155
 
 This EIP defines a standard set of custom errors for commonly-used tokens, which are defined as [EIP-20](./eip-20.md), [EIP-721](./eip-721.md), and [EIP-1155](./eip-1155.md) tokens.
 
-Ethereum applications and wallets have historically relied on revert reason strings to display the cause of transaction errors to users. More recent Solidity versions offer rich revert reasons with error-specific decoding (sometimes referred to as "custom errors"). This EIP defines a standard set of errors designed to give at least the same relevant information as revert reason strings, but in a structured and expected way that clients can implement decoding for.
+Ethereum applications and wallets have historically relied on revert reason strings to display the cause of transaction errors to users. Recent Solidity versions offer rich revert reasons with error-specific decoding (sometimes called "custom errors"). This EIP defines a standard set of errors designed to give at least the same relevant information as revert reason strings, but in a structured and expected way that clients can implement decoding for.
 
 ## Motivation
 
@@ -43,7 +43,7 @@ Indicates an error related to the current `balance` of a `sender`.
 Used in transfers.
 
 - MUST be used when `balance` is less than `needed`.
-- MUST NOT be used if `balance` is equal or greater than `needed`.
+- MUST NOT be used if `balance` is greater than or equal to `needed`.
 
 #### `ERC20InvalidSender(address sender)`
 
@@ -70,7 +70,7 @@ Indicates a failure with the `spender`'s `allowance`.
 Used in transfers.
 
 - MUST be used when `allowance` is less than `needed`.
-- MUST NOT be used if `allowance` is equal or greater than `needed`.
+- MUST NOT be used if `allowance` is greater than or equal to `needed`.
 
 #### `ERC20InvalidApprover(address approver)`
 
@@ -153,7 +153,7 @@ Indicates an error related to the current `balance` of a sender.
 Used in transfers.
 
 - MUST be used when `balance` is less than `needed` for a `tokenId`.
-- MUST NOT be used if `balance` is equal or greater than `needed` for an `tokenId`.
+- MUST NOT be used if `balance` is greater than or equal to `needed` for a `tokenId`.
 
 #### `ERC1155InvalidSender(address sender)`
 
@@ -204,7 +204,7 @@ Used in approvals.
 Indicates an array length mismatch between `ids` and `values` in a `safeBatchTransferFrom` operation.
 Used in batch transfers.
 
-- MUST be used only if `idsLength` is different to `valuesLength`
+- MUST be used only if `idsLength` is different from `valuesLength`
 
 ### Parameter Glossary
 
@@ -241,7 +241,7 @@ The main actions that can be performed within a token are:
 
 The subjects outlined above are expected to exhaustively represent _what_ can go wrong in a token transaction, deriving a specific error by adding an [error prefix](#error-prefixes).
 
-Note that the action is never seen as the subject of an error. Additionally the token itself is not seen as the subject of an error but rather the context in which it happens, as identified in the domain.
+Note that the action is never seen as the subject of an error. Additionally, the token itself is not seen as the subject of an error but rather the context in which it happens, as identified in the domain.
 
 If a subject is called different on a particular token standard, the error should be consistent with the standard's naming convention.
 
@@ -280,7 +280,7 @@ The selection of arguments depends on the subject involved, and it should follow
 2. _What_ failed (eg. `uint256 allowance`)
 3. _Why_ it failed, expressed in additional arguments (eg. `uint256 needed`)
 
-A particular argument may fall in overlapping categories (eg. _Who_ may also be _What_), so not all of these will be present but the order shouldn't be broken.
+A particular argument may fall into overlapping categories (eg. _Who_ may also be _What_), so not all of these will be present but the order shouldn't be broken.
 
 Some tokens may need a `tokenId`. This is suggested to include at the end as additional information instead of as a subject.
 
@@ -295,13 +295,13 @@ Given the above, we can summarize the construction of error names with a grammar
 Where:
 
 - _Domain_: `ERC20`, `ERC721` or `ERC1155`. Although other token standards may be suggested if not considered in this EIP.
-- _ErrorPrefix_: `Invalid`, `Insufficient`, or another if it's more appropriated.
-- _Subject_: `Sender`, `Receiver`, `Balance`, `Approver`, `Operator`, `Approval` or another if it's more appropriated, and must make adjustments based on domain's naming convention.
+- _ErrorPrefix_: `Invalid`, `Insufficient`, or another if it's more appropriate.
+- _Subject_: `Sender`, `Receiver`, `Balance`, `Approver`, `Operator`, `Approval` or another if it's more appropriate, and must make adjustments based on the domain's naming convention.
 - _Arguments_: Follow the [_who_, _what_ and _why_ order](#arguments).
 
 ## Backwards Compatibility
 
-Tokens already deployed rely mostly on revert strings and make use of `require` instead of custom errors. Even most of the new deployed tokens since Solidity's v0.8.4 release inherit from implementations using revert strings.
+Tokens already deployed rely mostly on revert strings and make use of `require` instead of custom errors. Even most of the newly deployed tokens since Solidity's v0.8.4 release inherit from implementations using revert strings.
 
 This EIP can not be enforced on non-upgradeable already deployed tokens, however, these tokens generally use similar conventions with small variations such as:
 
@@ -361,11 +361,10 @@ interface ERC1155Errors {
 
 ## Security Considerations
 
-There are no known signature hash collision for the specified errors.
+There are no known signature hash collisions for the specified errors.
 
 Tokens upgraded to implement this EIP may break assumptions in other systems relying on revert strings.
 
 ## Copyright
 
 Copyright and related rights waived via [CC0](../LICENSE.md).
-

From ad8b4558a7df4a480a8046bca8cce7dc91b76bdd Mon Sep 17 00:00:00 2001
From: Kosala Hemachandra <10602065+kvhnuke@users.noreply.github.com>
Date: Sun, 5 Feb 2023 13:28:59 -0800
Subject: [PATCH 255/274] Update eip-5749.md (#6446)

* move to last call

* fixes based on comment

* Update EIPS/eip-5749.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5749.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5749.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5749.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5749.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* devop: modifications based on review

* devop: modifications based on review

* devop: fix typings

* devop: fix typings

* devop: prepend svg data string

* Update EIPS/eip-5749.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* Update EIPS/eip-5749.md

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>

* devop: extend last call deadline

---------

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-5749.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5749.md b/EIPS/eip-5749.md
index 081c84830fe58a..d151ffa9659965 100644
--- a/EIPS/eip-5749.md
+++ b/EIPS/eip-5749.md
@@ -5,7 +5,7 @@ description: Add 'window.evmproviders' and suggest the eventual removal of 'wind
 author: Kosala Hemachandra (@kvhnuke), Brett Kolodny (@brettkolodny)
 discussions-to: https://ethereum-magicians.org/t/eip-5749-deprecate-window-ethereum/11195
 status: Last Call
-last-call-deadline: 2022-12-07
+last-call-deadline: 2023-02-20
 type: Standards Track
 category: Interface
 created: 2022-10-04

From 61d3b871ead8512116af2a58c95484c1d54dff44 Mon Sep 17 00:00:00 2001
From: Alex-Klasma <107881025+Alex-Klasma@users.noreply.github.com>
Date: Sun, 5 Feb 2023 23:07:27 -0400
Subject: [PATCH 256/274] Add EIP-6065: EIP Real Estate Standard Token (#6065)

* first draft of eip for real estate token standard

* fix heading

* fix header again

* assign name, small formatting updates

* fix linter issues

* more linter issues

* linter

* link to forum post

* add image for html page

* mod intro in rationale section

* Make a few changes

---------

Co-authored-by: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
---
 EIPS/eip-6065.md                        | 423 ++++++++++++++++++++++++
 assets/eip-6065/corporate-structure.png | Bin 0 -> 371934 bytes
 2 files changed, 423 insertions(+)
 create mode 100644 EIPS/eip-6065.md
 create mode 100644 assets/eip-6065/corporate-structure.png

diff --git a/EIPS/eip-6065.md b/EIPS/eip-6065.md
new file mode 100644
index 00000000000000..52373c3f8ad783
--- /dev/null
+++ b/EIPS/eip-6065.md
@@ -0,0 +1,423 @@
+---
+eip: 6065
+title: Real Estate Token
+description: An interface for real estate NFTs that extends EIP-721
+author: Alex (@Alex-Klasma), Ben Fusek (@bfusek), Daniel Fallon-Cyr (@dfalloncyr)
+discussions-to: https://ethereum-magicians.org/t/eip-6065-real-estate-token/11936
+status: Draft
+type: Standards Track
+category: ERC
+created: 2022-11-29
+requires: 721
+---
+
+## Abstract
+
+This proposal introduces an open structure for physical real estate and property to exist on the blockchain. This standard builds off of [EIP-721](./eip-721.md), adding important functionality necessary for representing real world assets such as real estate. The three objectives this standard aims to meet are: universal transferability of the NFT, private property rights attached to the NFT, and atomic transfer of property rights with the transfer of the NFT. The token contains a hashed operating agreement component, the ability to transfer legal ownership of the property, a payment function, and a repossession function. In addition to the token component, there are legal requirements that have to be met, which are discussed in the specification.
+
+## Motivation
+
+Real estate is the largest asset class in the world. By tokenizing real estate, barriers to entry are lowered, transaction costs are minimized, information asymmetry is reduced, ownership structures become more malleable, and a new building block for innovation is formed. However, in order to tokenize this asset class, a common standard is needed that accounts for its real world particularities while remaining flexible enough to adapt to various jurisdictions and regulatory environments. 
+
+Ethereum tokens involving real world assets are notoriously tricky. This is because Ethereum tokens exist on-chain, while real estate exists off-chain. As such, the two are subject to entirely different consensus environments. For Ethereum tokens, consensus is reached through a formalized process of distributed validators. When a purely-digital NFT is transferred, the new owner has a cryptographic guarantee of ownership. For real estate, consensus is supported by legal contracts, property law, and enforced by the court system. With existing asset-backed EIP-721 tokens, a transfer of the token to another individual does not necessarily have any impact on the legal ownership of the physical asset. 
+
+This standard attempts to solve the real world reconciliation issue, enabling real estate NFTs to function seamlessly on-chain, just like their purely-digital counterparts.
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+In order to meet the above objectives and create an open standard for on-chain property ownership we have created a token structure that builds on the EIP-721 standard and coupled that with a set of legal requirements broad enough to adapt to various jurisdictions and regulatory environments. 
+
+### Token Components:
+
+1. Inherits EIP-721 - Allows for backwards compatibility with the most widely accepted NFT token standard.
+2. Transferable Administrator of physical asset - Ability for NFT owner to initiate a transfer of the legal owner of the physical asset.
+3. Hashed operating agreement - Immutable legal agreement between Administrator and NFT owner that requires both parties to accept any proposed changes before they are made.
+4. Payment function - Ability for NFT Administrator to request payment for financing any payments made by the Administrator on behalf of the NFT owner (e.g. property taxes).
+5. Repossession function - Ability for Administrator to repossess the asset to ensure legally required payments are made whole (e.g. unpaid property taxes).
+
+### Token Legal Requirements (Outlined in Hashed Operating Agreement):
+
+1. Property held by the Administrator is self-contained, transferable, and bankruptcy remote. 
+2. Transfer of property rights are atomic with the digital transfer of the NFT.
+3. The NFT owner Ethereum address has the right to change the Administrator (i.e. legal owner) of the property.
+4. The operating agreement for the legal entity which holds the property must be hashed to the NFT and cannot be changed without mutual approval from both the NFT owner and the Administrator.
+5. The operating agreement must contain the right for the NFT owner to hold, occupy, rent, alter, resell, or transfer the property.
+6. The Administrator has no usage right to the property and may not collateralize, use, or otherwise encumber the property attached to the NFT.
+7. The Administrator is the sole legal owner of the property, and responsible for facilitating mandatory filings and payments for the property. 
+8. The Administrator is entitled to limited liability with regard to the property and has a right to require insurance on the property.
+9. Failure of the NFT owner to make required payments for the property (e.g. property taxes) triggers the Administrator’s right to repossess the property in order to make required payments.
+
+### Interfaces
+
+We rely on the EIP-721 NFT token standard for all transfer and approval logic. All transfer and approval functions are inherited from this token standard without changes. This allows an NFT under this standard to become interoperable with preexisting NFT exchanges and services, however some care must be taken. Please refer to the `Backwards Compatibility` section.
+
+#### Administrator
+
+```
+/// @dev This event emits when a change of NFT Administrator is proposed.
+///   Note that contracts can be init'ed with changes proposed without this event emitted.
+event AdministratorChangeInit(uint256 indexed _tokenId, address indexed _owner, address indexed _from, address indexed _to, string _extradata);
+
+/// @dev This event emits when a change of NFT Administrator is canceled.
+///   When an EIP-721 transfer event emits, any proposed Administrator changes should be nulled and this event should also emit
+event AdministratorChangeCanceled(uint256 indexed _tokenId, address indexed _owner, address indexed _from, address indexed _to, string _extradata);
+
+/// @dev This event emits when a change of NFT Administrator is accepted. The new Administrator MUST accept this change for this event to emit.
+///   This event MUST emit on any change, however, contracts can be init'ed with Administrators set and without emitting events.
+event AdministratorChangeAccept(uint256 indexed _tokenId, address indexed _owner, address indexed _from, address indexed _to, string _extradata);
+
+/// @dev MUST emit if cancelAdministratorAccept is called successfully
+event AdministratorChangeAcceptCanceled(uint256 indexed _tokenId, address indexed _owner, address indexed _from, address indexed _to, string _extradata);
+
+/// @dev MUST emit if finishAdministratorChange is called successfully
+event AdministratorChangeFinish(uint256 indexed _tokenId, address indexed _owner, address indexed _from, address indexed _to, string _extradata);
+
+/// @notice query current Administrator of an NFT
+/// @dev NFTs assigned to zero address are considered invalid, and queries about them do throw.
+/// @param _tokenId The identifier for an NFT
+/// @return The address of the Administrator of the NFT
+function administratorOf(uint256 _tokenId) external view returns (address);
+
+// STEP 1: Owner propose Administrator change, possible to cancel
+
+/// @notice propose a change of an Administrator for an NFT, called by ownerOf(NFT)
+/// @dev Throws unless msg.sender is the current ownerOf this NFT.
+/// @param _tokenId The identifier for an NFT
+/// @param _to The newly proposed Administrator of an NFT, if _to == address(0),
+///  this can be interpreted as _to == msg.sender == ownerOf, and they want to self-custody.
+/// @param _extradata An optional field for metadata
+function initAdministratorChange(uint256 _tokenId, address _to, string calldata _extradata) external;
+
+/// @notice query current proposed Administrator of an NFT
+/// @dev NFTs assigned to zero addresses are considered invalid, and queries
+///   about them do throw. On a EIP-721 transfer event emit, any proposed Administrator should be set to address(0)
+/// @param _tokenId The identifier for an NFT
+function proposedAdministratorOf(uint256 _tokenId) external view returns (address);
+
+/// @notice ownerOf(NFT) can cancel Administrator change. After a period of time, you might allow anyone (or old administrator)
+///   to cancel the change, as this blocks payment delinquency -> repossess logic. You can call this function as long as
+///   Administrator change was not accepted/finalized by new Administrator
+/// @dev throw if tokenId doesn't have an Administrator change.
+///   also implement logic for who/when can Administrator change be canceled
+/// @param _tokenId The identifier for an NFT
+/// @param _extradata An optional field for metadata
+function cancelAdministratorChange(uint256 _tokenId, string calldata _extradata) external;
+
+// STEP 2: New Administrator, accept Administrator change, possible to cancel
+
+/// @notice new Administrator accept a change of Administrator of an NFT
+/// @dev Throws unless msg.sender is proposedAdministratorOf this NFT. you may clear proposedAdministratorOf data
+/// @param _tokenId The identifier for an NFT
+/// @param _extradata An optional field for metadata
+function acceptAdministratorChange(uint256 _tokenId, string calldata _extradata) external;
+
+/// @notice once the Administrator change is accepted as a new Administrator, this function needs to return their address
+/// @dev on an EIP-721 transfer, this address remains, as the transfer is in progress.
+/// @param _tokenId The identifier for an NFT
+function pendingAdministratorOf(uint256 _tokenId) external view returns(address);
+
+/// @notice allow a cancellation of the processing/pending Administrator change
+/// @dev determine who is allowed to cancel this change, up to implementor,
+///   msg.sender should be pendingAdministratorOf in most cases, but perhaps can be canceled by anyone after a period of time
+///   throw if there's no pendingAdministratorOf
+/// @param _tokenId The identifier for an NFT
+/// @param _extradata An optional field for metadata
+function cancelAdministratorChangeAccept(uint256 _tokenId, string calldata _extradata) external;
+
+// STEP 3: Finalize Administrator change, cannot cancel. This occurs after the "real world legal steps" to change Administrator have taken place off-chain.
+
+/// @notice finalize the change in Administrator of the NFT
+/// @dev throws if msg.sender is not pendingAdministratorOf. now administratorOf(NFT) will return the new Administrator address, you may clear pendingAdministratorOf()
+/// @param _tokenId The identifier for an NFT
+/// @param _extradata An optional field for metadata
+function finishAdministratorChange(uint256 _tokenId, string calldata _extradata) external;
+```
+
+#### Operating Agreement Updates
+
+```
+/// @dev emit this event if there's a successful call of initOperatingAgreementChange
+/// @param _proposer is the msg.sender of the init
+event OperatingAgreementChangeInit(uint256 indexed _tokenId, address indexed _proposer, string _updatedAgreementHash, string _extradata);
+
+/// @dev emit this event if there's a successful call of cancelOperatingAgreementChange
+///   also emit this if there is a owner proposed change but the owner transfers to new owner
+///   also emit if there is a Administrator proposed change, but the Administrator transfers to a new owner
+event OperatingAgreementChangeCancel(uint256 indexed _tokenId, address indexed _proposer, string _extradata);
+
+// @dev emit if there's a successful call of finishOperatingAgreementChange
+// @param _proposer is the msg.sender of the init
+// @param _agreer is the msg.sender of the finishOperatingAgreementChange
+// @param _updatedAgreementHash must be == the _updatedAgreementHash from the OperatingAgreementChangeInit event
+event OperatingAgreementChangeFinish(uint256 indexed _tokenId, address indexed _proposer, address indexed _agreer, string _updatedAgreementHash, string _extradata);
+
+/// @notice query the current operating agreement, this is recommended to be an IPFS link
+///   or some other URL or reference. see best practices for NFT metadata.
+/// @dev if tokenId doesn't exist, throw
+/// @param _tokenId The identifier for an NFT
+/// @returns some string, likely to an external resource as a legal document is very expensive to store on-chain
+function operatingAgreementOf(uint256 _tokenId) external view returns(string);
+
+/// @notice propose a change to the operating agreement
+/// @dev throw is msg.sender is not ownerOf(NFT) or is not administratorOf(NFT). update needs to be accepted by the other party
+///   (owner if Administrator proposed, Administrator if owner proposed)
+/// @param _tokenId The identifier for an NFT
+/// @param _updatedAgreementHash Is the proposed new agreement
+/// @param _extradata An optional field for metadata
+function initOperatingAgreementChange(uint256 _tokenId, string calldata _updatedAgreementHash, string calldata _extradata) external;
+
+/// @notice view a pending change for _tokenId
+/// @dev if _tokenId doesn't exist then throw, if there is not an update proposed then throw
+///   also note that if the Administrator has made a proposal, but the Administrator is changed to a new Administrator (finished change)
+///   then any update proposals should be nulled
+///   also note that is the owner has made a proposal, but the owner changes (EIP-721 transfer), then any update proposals should be nulled as well
+/// @param _tokenId The identifier for an NFT
+/// @returns _proposer is either the Administrator or owner who proposed the update
+/// @returns _updatedAgreementHash is the proposed agreement to be update
+function pendingOperatingAgreementOf(uint256 _tokenId) external view returns(address _proposer, string _updatedAgreementHash);
+
+/// @notice allow proposer to cancel agreement
+/// @dev throw if tokenId doesn't exist, or if there is no proposal for this agreement, or if msg.sender was not the proposer of the change
+/// @param _tokenId The identifier for an NFT
+/// @param _extradata An optional field for metadata
+function cancelOperatingAgreementChange(uint256 _tokenId, string calldata _extradata) external;
+
+/// @notice accept a change to the operating agreement
+/// @dev msg.sender must be ownerOf(NFT) if AdministratorOf(NFT) proposed change, OR must be AdministratorOf(NFT) if ownerOf(NFT) proposed change, ELSE throw
+///   also throw if _updatedAgreementHash does not match the originally proposed agreement
+/// @param _tokenId The identifier for an NFT
+/// @param _updatedAgreementHash hash that MUST match the prior submitted change suggestion hash to confirm the agreement
+/// @param _extradata An optional field for metadata
+function finishOperatingAgreementChange(uint256 _tokenId, string calldata _updatedAgreementHash, string calldata _extradata) external;
+```
+
+#### Payments
+
+```
+/// @dev emit this event when initPayment is called successfully
+event PaymentInit(uint256 indexed _tokenId, address indexed _administrator, address indexed _paymentToken, uint256 _amount, bool _decreaseAmtOwed, uint256 _oldestTimestamp, string _extradata);
+
+/// @dev This event emits when a finishPayment is successful. The payment MUST be completed for this event to emit, and
+///   this event MUST emit if the payment is completed and funds are transferred from msg.sender address
+event PaymentFinish(uint256 indexed _tokenId, address indexed _administrator, address indexed _paymentToken, uint256 _amount, string _extradata);
+
+/// @notice Administrator assess payment on the NFT owner
+/// @dev throw if msg.sender is not the current administratorOf(_tokenId), you may store payments by token to be paid, and you may sum the values of all other
+///   prior unpaid payments. store the timestamp of the oldest unpaid payment for this payment type, if this is a new token with no prior payments
+///   then store block.timestamp for this payment, this will be used for delinquent payments
+///   if payments are _decreaseAmtOwed, the total amount owed can never be negative, if this will happen null payment storage for this _paymentToken
+///   if a new Administrator is adding/decreasing a payment token outstanding by an old Administrator, overwrite the Administrator name in storage
+///   you might want to change the timestamp of old Administrator payments to be a new/current timestamp
+/// @param _tokenId The identifier for an NFT
+/// @param _paymentToken the EIP-20 token address to define the payment
+/// @param _amount the amount of EIP-20 token payment due
+/// @param _decreaseAmtOwed this decreases any payment by the _amount, this can be used to revise or adjust down any payments, basically adding a negative sign to _amount
+/// @param _extradata An optional field for metadata
+function initPayment(uint256 _tokenId, address _paymentToken, uint256 _amount, bool _decreaseAmtOwed, string  calldata _extradata) external;
+
+/// @notice query an existing unpaid payment
+/// @dev queries about non-existent _tokenId, _token pairings are considered invalid, and queries
+///   about them do throw. This can include already completed payments (where the blockchain reference is deleted)
+/// @param _tokenId The identifier for an NFT
+/// @param _paymentToken the EIP-20 token address to define the payment
+/// @returns _amount the amount of _paymentToken that needs to be paid to fulfill payment
+/// @returns _receiver is the Administrator of the specific tokenId, who will receive payment
+/// @returns _timestamp of the oldest non-completed payment in this _paymentToken
+function pendingPaymentOf(uint256 _tokenId, address _paymentToken) external view returns (uint256 _amount, address _receiver, uint256 _timestamp);
+
+/// @notice NFT owner make payment that was invoiced by Administrator
+/// @dev do NOT throw if msg.sender isn't ownerOf(_tokenId), anyone can fulfill a payment if they desire
+///   allow msg.sender to make a partial payment for an amount, if _amount > total payments outstanding, then pay their total, do not pay extra
+///   also note the Administrator the payment is supposed to go to, we recommend ignoring payments to an old Administrator, or throwing
+/// @param _tokenId The identifier for an NFT
+/// @param _paymentToken The EIP-20 token address to define the payment
+/// @param _amount The amount user desires to pay
+/// @param _extradata An optional field for metadata
+function finishPayment(uint256 _tokenId, address _paymentToken, uint256 _amount, string calldata _extradata) external;
+
+/// @notice query if a payment is delinquent, a payment considered to be delinquent is defined by implementor
+///   it's recommended that a payment cannot be delinquent if there is a proposedAdministratorOf || pendingAdministratorOf
+///   if payments are delinquent, then the underlying physical asset is liable to be repossessed
+///   we recommend ignoring payments to an old Administrator in a delinquency determination
+/// @dev queries about non-existent payments are considered invalid and queries about them do throw.
+///   this can include already completed payments (where the blockchain reference is deleted)
+/// @param _tokenId The identifier for an NFT
+/// @param _paymentToken The EIP-20 token address to define the payment
+/// @returns false if there is no delinquent payment for this payment id, EIP-20 payment token, true if there is
+function paymentIsDelinquent(uint256 _tokenId, address _paymentToken) external view returns (bool);
+```
+
+#### Repossess/Foreclosure
+
+```
+/// @dev this event emits when a initRepossess is successful, only emit if initRepossess is successful
+event RepossessInit(uint256 indexed _tokenId, address indexed _administrator, address _token, string _extradata);
+
+/// @dev this event emits when a cancelRepossess is successful, only emit if there is successful canceled repossess
+event RepossessCancel(uint256 indexed _tokenId, address indexed _administrator, string _extradata);
+
+/// @dev this event emits when finishRepossess is successfully called, only emit if there is a successfully finished repossess
+/// @param _amount is the amount of ETH paid back to user after a repossess is complete
+event RepossessFinish(uint256 indexed _tokenId, address indexed _administrator, uint256 _amount, string _extradata);
+
+/// @dev this event emits when claimRepossess is called, only emit if it's successfully called
+/// @param _amount is the amount of ETH sent to the user
+event RepossessClaim(uint256 indexed _tokenId, address indexed _owner, uint256 _amount)
+
+/// @notice if this function returns true, then the underlying physical asset has been repossessed
+///   due to the user not paying required fees for the asset. if true, then the asset only contains
+///   the second return value in wei, and this amount of ETH can be withdrawn at any time by ownerOf NFT.
+/// @param _tokenId The identifier for an NFT
+/// @returns _repossessed true if the asset has finished repossessing, else false
+/// @returns _amount, the amount of ETH that was returned after the repossess took place, zero if claimed (below)
+function isRepossessed(uint256 _tokenId) external view returns(bool _repossessed, uint256 _amount);
+
+/// @notice initialize repossess underlying RWA asset that backs NFT if a payment is delinquent
+/// @dev paymentIsDelinquent(_tokenId, _token) must return true, else this function reverts.
+///   is msg.sender is not the Administrator, this function reverts.
+///   if the Administrator is in transfer state, we recommend not letting a repossess happen as it could be malicious
+///   (see paymentIsDelinquent logic)
+///   however we also recommend forcing Administrator transfers to happen within a certain period of time to prevent griefing
+///   and allowing a repossess after a certain time has elapsed without an Administrator accepting the proposed Administrator change
+/// @param _tokenId The identifier for an NFT
+/// @param _token The payment token that a payment was delinquent
+/// @param _extradata An optional field for metadata
+function initRepossess(uint256 _tokenId, address _token, string calldata _extradata) external;
+
+/// @notice view if a payment has a repossess pending on the asset, this will warn any prospective buyer that the asset is in question
+/// @dev true if there is a pending repossess, false otherwise, if tokenId doesn't exist, then throw
+/// @param _tokenId The identifier for an NFT
+/// @returns true if there is a repossess pending, false if not
+function pendingRepossess(uint256 _tokenID) external view returns(bool);
+
+/// @notice cancel a prior initialized repossess, Administrator can cancel for any reason
+/// @dev tokenId must have an initialized repossess, and msg.sender must be administratorOf(tokenId) or function reverts
+/// @param _tokenId The identifier for an NFT
+/// @param _extradata An optional field for metadata
+function cancelRepossess(uint256 _tokenId, string calldata _extradata) external;
+
+/// @notice finish repossessing underlying physical asset that backs NFT, underlying asset sold/auctioned at fair value
+///   and function is payable so that Administrator can send remaining auction proceeds to contract *in ETH*
+/// @dev if msg.sender is not the Administrator, this function reverts
+/// @param _tokenId The identifier for an NFT
+/// @param _extradata An optional field for metadata
+function finishRepossess(uint256 _tokenId, string calldata _extradata) external payable;
+
+/// @notice after an asset is repossessed, ownerOf(NFT) can claim the proceeds of the repossession
+/// @dev throw is ownerOf(_tokenId) != msg.sender, otherwise send amount of ETH from finishRepossess() to caller
+/// @param _tokenId The identifier for an NFT
+function claimRepossess(uint256 _tokenId) external;
+```
+
+## Rationale
+
+### Introduction
+
+Real world assets operate in messy, non-deterministic environments. Because of this, validating the true state of an asset can be murky, expensive, or time-consuming. For example, in the U.S., change of property ownership is usually recorded at the County Recorder’s office, sometimes using pen and paper. It would be infeasible to continuously update this manual record every time an NFT transaction occurs on the blockchain. Additionally, since real world property rights are enforced by the court of law, it is essential that property ownership be documented in such a way that courts are able to interpret and enforce ownership if necessary.
+
+For these reasons, it is necessary to have a trusted party tasked with the responsibility of ensuring the state of the on-chain property accurately mirrors its physical counterpart. By having an Administrator for the property who issues a legally-binding digital representation of the physical property, we are able to solve for both the atomic transfer of the property rights with the transfer of the NFT, as well as institute a seamless process for making the necessary payments and filings associated with property ownership.
+
+There are various ways to meet the legal requirements of this standard, especially considering different property ownership laws and regulations between various jurisdictions. Therefore, we do not prescribe a specific legal structure. However, an example structure implemented by Klasma Inc. for property tokenization in the U.S. is provided in the [Reference Implementation](#reference-implementation).
+
+### Guiding Objectives
+
+We have designed this EIP to achieve three primary objectives necessary for creating an NFT representation of physical real estate:
+
+#### 1. Real Estate NFTs are universally transferable
+
+A key aspect to private property is the right to transfer ownership to any legal person or entity that has the capacity to own that property. Therefore, an NFT representation of physical property should maintain that universal freedom of transfer.
+
+#### 2. All rights associated with property ownership are maintained
+
+The rights associated with private property ownership are the right to hold, occupy, rent, alter, resell, or transfer the property. It is essential that these same rights are maintained in an NFT representation of real estate. 
+
+#### 3. Property rights are transferred atomically with the transfer of the NFT. 
+
+Token ownership on any blockchain is atomic with the transfer of the digital token. To ensure the digital representation of a physical property is able to fully integrate the benefits of blockchain technology, it is essential the rights associated with the property are passed atomically with the transfer of the digital token representation. For this reason, the legal ownership of the property must be packaged in such a way that allows for the atomic transfer of rights with the transfer of the digital token.
+
+This EIP proposes a way to mesh the transfers of off-chain assets (in a legal sense) with on-chain Ethereum blockchain transfers and state-transitions. The following section specifies the technological and legal requirements needed to accomplish this. 
+
+### Administrator, Legal Entity, & Administrator Transferability
+
+The Administrator is the legal owner of a singular legal entity special purpose vehicle (SPV) which holds the title to an individual physical property and issues the corresponding NFT. It is the duty of the Administrator to make all necessary filings and payments for the legal entity and corresponding property (e.g. tax filings, property tax payments & required utility payments). In addition to ensuring the property is in good standing with the government, the Administrator is tasked with ensuring the rightful occupancy of the home, signing documents on behalf of the NFT owner when necessary, and posting up-to-date information regarding the condition of the property to the NFT. 
+
+Within the token components exists a function to transfer the Administrator of the asset. Any owner of the physical property NFT can transfer legal ownership of the asset by calling this function. This action kicks off the pen and paper process whereby the Administrator changes ownership of the legal entity. This process also allows the NFT owner to bridge the asset off-chain by transferring ownership of the entity to themselves and taking legal ownership of the title to the property.  
+
+Trusted roles are antithetical to crypto. Ideally, the Administrator role eventually becomes obsolete. However, currently, this function is essential to providing enforceable property rights to the NFT owner. There are various avenues to explore for making the role of Administrators trust-minimized, including reputation systems and financial/game theory incentives, but they are outside the scope of this standard.
+
+### Hashed Operating Agreement
+
+The hashed operating agreement is a legal document issued by the Administrator that contains the rights to the physical property, as well as terms and conditions. This document is hashed to the NFT to ensure the immutability of these rights. In order to make changes to this contract, either the Administrator or NFT owner must submit a change request via the legal entity and it must be approved by the corresponding side. Upon transfer of the NFT, these legal rights are transferred to the new owner. 
+
+As this standard is adopted and developed further, we anticipate a collection of particular operating requirements to become common across different Administrators and asset types. These requirements will be componentized into referenceable hashes that can be easily understood and verified when interacting with a digital representation of a property.
+
+### Payment Function
+
+Payments are a necessary part of owning real estate. Owners must pay for property taxes, basic utilities, and other required costs. Because the Administrator is the legal owner of the entity that holds the title to the property, it is the Administrator’s responsibility to make any and all required payments. Administrators will issue all anticipated fees and payments to the NFT owner using the payment function. Owners are then able to make the necessary payments for the property directly through their NFT. Administrators are strongly encouraged to submit any bills or invoices in “paper form” using the `_extradata` field and attach a link to a PDF or other documentation, as well as group payments by time period to ensure simplicity for the owners. 
+
+### Repossession Function
+
+If the payments mentioned in the previous section go unpaid, the property is at risk of having silent liens placed against it or in extreme circumstances, being repossessed by the state. In order to ensure Administrators are able to provide reliable and clean transfers of a property, the Administrator must have the means to make payments without being subject to payment liability risk. If the Administrator makes payments for a property on behalf of a NFT owner and then needs to be reimbursed, the Administrator is exposed to risk of financial loss in the event the NFT owner sells the NFT without reimbursing the Administrator. For this reason all payments need to be funded directly from the NFT owner through the smart contract. 
+
+If the NFT owner fails to pay the invoice, the Administrator has the right to repossess the property, sell it in order to generate the required funds for payment, and then replace the physical asset backing the original NFT with the remaining funds from the sale in ETH. Any proceeds from the repossession/foreclosure sale must be converted to ETH in order to be returned to the original owner. It is up to the implementer to determine what criterion for payment delinquency triggers a repossession. 
+
+## Backwards Compatibility
+
+Although this standard is backwards compatible with EIP-721, there are important security and implementation considerations to take into account before any smart contract integration. These considerations primarily surround the built-in payment function of the token. While treating NFTs under this standard as identical to EIP-721 NFTs is technically possible, we recommend considering additional logic to support fee payment and recognize any unpaid obligations. 
+
+Specific applications that incorporate these NFTs can suffer losses from incorrect implementation. See `Integration Checks and Considerations` for more details.
+
+## Reference Implementation
+
+This section details an implementation of the legal standard by Klasma Inc. specifically for property tokenization in the U.S. in the 2022 regulatory environment.
+
+![Sample Corporate Structure Image](../assets/eip-6065/corporate-structure.png)
+
+The Klasma Inc. legal structure for U.S. real estate and property is as follows:
+
+* Klasma Inc., a parent company and property Administrator, owns a bankruptcy remote LLC for each individual property they act as Administrator for.
+* This LLC owns a DAO LLC, which issues the NFT for the property and holds the title and deed to the property. 
+* This structure enables the following three outcomes: 
+	1. Homeowners are shielded from any financial stress or bankruptcy their physical asset Administrator encounters. In the event of an Administrator bankruptcy or dissolution the owner of the NFT is entitled to transfer of the DAO LLC, or the sale and distribution of proceeds from the property.
+	2. Transfer of the rights to the property are atomic with the transfer of the NFT. The rights to the property are issued and controlled by a DAO LLC, a legally recognized entity that can be algorithmically managed, (e.g. managed by smart contract). This enables the enforceable rights to the physical property to be passed digitally with the transfer of the NFT without having to update the legal owner of the property with each transfer.
+	3. Each real estate NFT is universally transferable. The DAO LLC will be taxed as a corporation to limit any pass-through tax benefits that could put the token at risk of being deemed a security in the U.S. The DAO LLC will always operate in a tax neutral or negative status thus not requiring any tax payments to be made on behalf of the LLC. Additionally, it is important to note that the NFT associated with a particular property merely provides a means of digital transfer for the private ownership rights to the property. Therefore, there is no action by the Administrator that could increase the value of the asset, ensuring the NFT is deemed a commodity, the same as any other home or property. 
+
+## Security Considerations
+
+This standard attempts to strike a balance between the crypto ethos of “code is law” and the understanding that a stolen home with no possibility of recourse for the owner is a non-starter for almost all users. On a risk-adjusted basis, the benefits of using a decentralized finance protocol are unlikely to offset the possibility of a catastrophic loss of the property via a protocol exploit. Losing your home in a DeFi hack is unacceptable.
+
+On the other hand, granting the Administrator full control of the NFTs through backdoor access to the smart contracts is also unacceptable. Given the complex nature of many exploits, requiring Administrators to act as judge and jury in defining a hack and determining the rightful owner is sub-optimal. The following sections define how private key loss and protocol hacks are addressed, as well as provide important checks and considerations for smart contract integrations, particularly for lending protocols. 
+
+### Private Key Loss and Theft
+
+While DeFi protocol hacks leave an immutable trail on-chain, private key hacks do not. A private key transferring an asset legitimately or maliciously looks identical in any blockchain analysis. As such, Administrators should not be tasked with arbitrating or remedying private key hacks or loss. 
+
+Secure private key storage is a fundamental requirement to be able to interact with the crypto ecosystem. Users unable to do so should either pay for an NFT custody solution, or refrain from owning digital assets altogether. 
+
+### Protocol Hacks and Exploits
+
+A protocol hack or exploit occurs within the confines of a smart contract integration and thus is reviewable on-chain, via specific transaction hashes and block explorer level evidence. A respectable Administrator should lay out their process for classifying and addressing protocol exploits in the Operating Agreement. 
+
+To remedy a hack, the Administrator may issue a charge against the NFT to the new owner of the NFT for the full market value of the underlying asset via the `initPayment()` function. If the new owner does nothing, the Administrator will repossess this asset and return it to the original owner or protocol. To contest the classification of a hack, the new owner may start the `initAdministratorChange()` workflow to change the Administrator or self-custody the asset. Since all Administrators must be legal entities, the original owner may now bring this case to the traditional legal system if they desire. 
+
+Through leveraging the existing payment and Administrator change flow, a safety mechanism against protocol exploits is provided without inserting a smart contract backdoor. In the event that an exploit is contestable (e.g. a hack, versus an economic exploit, versus a well timed trade), this system provides an avenue for the new asset owner to make her case through the jurisdictional legal system. 
+
+### Integration Checks and Considerations
+
+The following are checks and recommendations for protocols integrating NFTs under this standard. These are of particular relevance to applications which lend against any asset utilizing this standard. 
+
+* Lending protocol integrators are recommended to pay any payments on behalf of their NFT depositors by calling `finishPayment()` and adding this balance to their users outstanding debt position. This avoids repossession by the Administrator, which may lead to loans becoming undercollateralized or undefined behavior in the protocol. 
+* Before accepting NFT deposits, a protocol integrator should check any `pendingPaymentOf()` the asset. A protocol may decide not accept an asset until all payments are cleared, or mark down the fair market value of the asset.
+* Protocol integrators should also check if the function `paymentIsDelinquent()` returns `true` for any payments. If so, they should reject the asset as it is at risk of being repossessed. 
+* Protocol integrators are recommended to implement a time-delay before performing irreversible actions. This is to protect against future to-be-assessed payments that may occur if a hacked NFT is deposited into the protocol. 
+	* For example, a protocol should implement a waiting period before issuing stablecoins as part of a collateralized mortgage on the NFT. If another DeFi protocol can be hacked, and a hacker can immediately run to a different protocol to receive an 80% LTV loan on the asset, it is likely that this second protocol will take a loss when this hack is resolved by the Administrator billing the NFT via `initPayment()` for it’s entire market value. Now this second protocol is stuck with valueless collateral, but already issued a 80% LTV loan. 
+	* Because there is no standardized waiting period, DeFi protocols should specifically whitelist Administrator addresses for deposit into their protocols. Administrators may have specialized descriptor smart contracts to give an upper bound on wait-time recommendations. For example, Administrator A could state that one should wait 7 days for any of their assets, and after 7 days it is guaranteed that there will be no `initPayments()` for any prior malicious activity or hacks of the asset, and the asset is now safe to accept as collateral as its value is simply value(asset) without any possible liabilities.
+* It is recommended that protocol integrators expose `initAdministratorChange()` logic in their smart contracts in order to change the Administrator in the future, if necessary.
+Protocol integrators may decide to only accept assets with certain operating agreement hashes, viewable by calling `operatingAgreementOf()`. This ensures that all legal clauses and terms in this off-chain contract have been reviewed prior. 
+* More advanced protocol integrators may decide to expose `initOperatingAgreementChange()` functionality, in case a better legal agreement standard is designed in order to upgrade their assets to the best possible protections.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-6065/corporate-structure.png b/assets/eip-6065/corporate-structure.png
new file mode 100644
index 0000000000000000000000000000000000000000..0d22567fefc089c91d19d4c748263d4cde7aac9a
GIT binary patch
literal 371934
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%0DWni8rgzxXv_#b4_>%6~
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
HQ$iB}P*|b-

literal 0
HcmV?d00001


From df831233c5f9cd0c02fe577c257f417856606d9e Mon Sep 17 00:00:00 2001
From: Keegan Lee <keegan.lee704@gmail.com>
Date: Tue, 7 Feb 2023 12:31:47 +0800
Subject: [PATCH 257/274] update implementation (#6453)

---
 EIPS/eip-6150.md                                      |  2 +-
 assets/eip-6150/contracts/ERC6150.sol                 |  2 +-
 assets/eip-6150/contracts/ERC6150AccessControl.sol    | 11 -----------
 assets/eip-6150/contracts/ERC6150Burnable.sol         | 11 -----------
 assets/eip-6150/contracts/ERC6150Enumerable.sol       | 11 -----------
 .../eip-6150/contracts/ERC6150ParentTransferable.sol  | 11 -----------
 6 files changed, 2 insertions(+), 46 deletions(-)

diff --git a/EIPS/eip-6150.md b/EIPS/eip-6150.md
index 0df035ee54f039..f88da482e745ac 100644
--- a/EIPS/eip-6150.md
+++ b/EIPS/eip-6150.md
@@ -281,7 +281,7 @@ This proposal is fully backward compatible with [EIP-721](./eip-721.md).
 
 ## Reference Implementation
 
-Reference Implementation: [EIP-6150](../assets/eip-6150/contracts/ERC6150.sol)
+Implementation: [EIP-6150](../assets/eip-6150/contracts/ERC6150.sol)
 
 ## Security Considerations
 
diff --git a/assets/eip-6150/contracts/ERC6150.sol b/assets/eip-6150/contracts/ERC6150.sol
index e27711e9ea0ba0..5dd0dc26ab6a2e 100644
--- a/assets/eip-6150/contracts/ERC6150.sol
+++ b/assets/eip-6150/contracts/ERC6150.sol
@@ -110,7 +110,7 @@ abstract contract ERC6150 is ERC721, IERC6150 {
         _beforeMintWithParent(to, parentId, tokenId);
 
         _parentOf[tokenId] = parentId;
-        _indexInChildrenArray[tokenId] = _childrenOf.length;
+        _indexInChildrenArray[tokenId] = _childrenOf[parentId].length;
         _childrenOf[parentId].push(tokenId);
 
         _safeMint(to, tokenId, data);
diff --git a/assets/eip-6150/contracts/ERC6150AccessControl.sol b/assets/eip-6150/contracts/ERC6150AccessControl.sol
index 7182e374b395cf..97e43a01f9a089 100644
--- a/assets/eip-6150/contracts/ERC6150AccessControl.sol
+++ b/assets/eip-6150/contracts/ERC6150AccessControl.sol
@@ -7,17 +7,6 @@ import "./interfaces/IERC6150AccessControl.sol";
 abstract contract ERC6150AccessControl is ERC6150, IERC6150AccessControl {
     mapping(address => mapping(uint256 => bool)) private _isAdminOf;
 
-    /**
-     * @dev See {IERC165-supportsInterface}.
-     */
-    function supportsInterface(
-        bytes4 interfaceId
-    ) public view virtual override(IERC165, ERC6150) returns (bool) {
-        return
-            interfaceId == type(IERC6150AccessControl).interfaceId ||
-            super.supportsInterface(interfaceId);
-    }
-
     function isAdminOf(
         uint256 tokenId,
         address account
diff --git a/assets/eip-6150/contracts/ERC6150Burnable.sol b/assets/eip-6150/contracts/ERC6150Burnable.sol
index 34f0d1eea77f33..aa0e3a9fe91b76 100644
--- a/assets/eip-6150/contracts/ERC6150Burnable.sol
+++ b/assets/eip-6150/contracts/ERC6150Burnable.sol
@@ -5,17 +5,6 @@ import "./ERC6150.sol";
 import "./interfaces/IERC6150Burnable.sol";
 
 abstract contract ERC6150Burnable is ERC6150, IERC6150Burnable {
-    /**
-     * @dev See {IERC165-supportsInterface}.
-     */
-    function supportsInterface(
-        bytes4 interfaceId
-    ) public view virtual override(IERC165, ERC6150) returns (bool) {
-        return
-            interfaceId == type(IERC6150Burnable).interfaceId ||
-            super.supportsInterface(interfaceId);
-    }
-
     function safeBurn(uint256 tokenId) public virtual override {
         require(
             _isApprovedOrOwner(_msgSender(), tokenId),
diff --git a/assets/eip-6150/contracts/ERC6150Enumerable.sol b/assets/eip-6150/contracts/ERC6150Enumerable.sol
index 02751de61cf76f..32a97511366430 100644
--- a/assets/eip-6150/contracts/ERC6150Enumerable.sol
+++ b/assets/eip-6150/contracts/ERC6150Enumerable.sol
@@ -5,17 +5,6 @@ import "./ERC6150.sol";
 import "./interfaces/IERC6150Enumerable.sol";
 
 abstract contract ERC6150Enumerable is ERC6150, IERC6150Enumerable {
-    /**
-     * @dev See {IERC165-supportsInterface}.
-     */
-    function supportsInterface(
-        bytes4 interfaceId
-    ) public view virtual override(IERC165, ERC6150) returns (bool) {
-        return
-            interfaceId == type(IERC6150Enumerable).interfaceId ||
-            super.supportsInterface(interfaceId);
-    }
-
     function childrenCountOf(
         uint256 parentId
     ) external view virtual override returns (uint256) {
diff --git a/assets/eip-6150/contracts/ERC6150ParentTransferable.sol b/assets/eip-6150/contracts/ERC6150ParentTransferable.sol
index 4a3203b507c61c..cb552e87fdbad2 100644
--- a/assets/eip-6150/contracts/ERC6150ParentTransferable.sol
+++ b/assets/eip-6150/contracts/ERC6150ParentTransferable.sol
@@ -8,17 +8,6 @@ abstract contract ERC6150ParentTransferable is
     ERC6150,
     IERC6150ParentTransferable
 {
-    /**
-     * @dev See {IERC165-supportsInterface}.
-     */
-    function supportsInterface(
-        bytes4 interfaceId
-    ) public view virtual override(IERC165, ERC6150) returns (bool) {
-        return
-            interfaceId == type(IERC6150ParentTransferable).interfaceId ||
-            super.supportsInterface(interfaceId);
-    }
-
     function transferParent(
         uint256 newParentId,
         uint256 tokenId

From bec3e2ed322fe8e88f9e84ce6434731c069b6249 Mon Sep 17 00:00:00 2001
From: "5660.eth" <76733013+5660-eth@users.noreply.github.com>
Date: Tue, 7 Feb 2023 23:16:47 +0800
Subject: [PATCH 258/274] Update EIP-6147: Move to Review (#6452)

---
 EIPS/eip-6147.md | 115 +++++++++++++++++++++++------------------------
 1 file changed, 56 insertions(+), 59 deletions(-)

diff --git a/EIPS/eip-6147.md b/EIPS/eip-6147.md
index 1c790503c96523..f45e5cbd099529 100644
--- a/EIPS/eip-6147.md
+++ b/EIPS/eip-6147.md
@@ -4,7 +4,7 @@ title: Guard of NFT/SBT, an Extension of EIP-721
 description: A new management role of NFT/SBT is defined, which realizes the separation of transfer right and holding right of NFT/SBT.
 author: 5660-eth (@5660-eth), Wizard Wang
 discussions-to: https://ethereum-magicians.org/t/guard-of-nft-sbt-an-extension-of-eip-721/12052
-status: Draft
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-12-07
@@ -49,7 +49,6 @@ When a token has a guard, if the token burns, the guard MUST be deleted.
 If issuing or minting SBTs, the guard MAY be uniformly set to the designated address to facilitate management. 
 
 ### Contract Interface
-
   
 ```solidity
  interface IERC6147 {
@@ -57,9 +56,9 @@ If issuing or minting SBTs, the guard MAY be uniformly set to the designated add
     /// Logged when the guard of an NFT is changed 
     /// @notice Emitted when  the `guard` is changed
     /// The zero address for guard indicates that there is no guard address
-    event UpdateGuardLog(uint256 indexed tokenId,address indexed newGuard,address oldGuard);
+    event UpdateGuardLog(uint256 indexed tokenId, address indexed newGuard, address oldGuard);
     
-    /// @notice  Owner, authorised operators and approved address of the NFT can set guard of the NFT and guard can modifiy guard of the NFT
+    /// @notice Owner, authorised operators and approved address of the NFT can set guard of the NFT and guard can modifiy guard of the NFT
     /// If the NFT has a guard role, the owner, authorised operators and approved address of the NFT cannot modify guard
     /// @dev The newGuard can not be zero address
     /// Throws if `tokenId` is not valid NFT
@@ -67,7 +66,6 @@ If issuing or minting SBTs, the guard MAY be uniformly set to the designated add
     /// @param newGuard The new guard address of the NFT
     function changeGuard(uint256 tokenId, address newGuard) external;
 
-  
     /// @notice Remove the guard of the NFT
     /// Only guard can remove its own guard role
     /// @dev The guard address is set to 0 address
@@ -81,7 +79,7 @@ If issuing or minting SBTs, the guard MAY be uniformly set to the designated add
     /// @param from The address of the previous owner of the NFT
     /// @param to The address of NFT recipient 
     /// @param tokenId The NFT to get transferred for
-    function transferAndRemove(address from,address to,uint256 tokenId) external;
+    function transferAndRemove(address from, address to, uint256 tokenId) external;
 
     /// @notice Get the guard address of the NFT
     /// @dev The zero address indicates that there is no guard
@@ -90,7 +88,6 @@ If issuing or minting SBTs, the guard MAY be uniformly set to the designated add
     /// @return The guard address for the NFT
    function guardOf(uint256 tokenId) external view returns (address);   
 }
-  
   ```
 
 The `changeGuard(uint256 tokenId, address newGuard)` function MAY be implemented as `public` or `external`.
@@ -135,8 +132,7 @@ The alternative names are `guardian` and `guard`, both of which basically match
 
 This standard can be fully EIP-721 compatible by adding an extension function set.
 
-If the NFT issued based on the above standard does not set a `guard` , then it is no different from the current NFT issued based on the EIP-721 standard.
-
+If an NFT issued based on the above standard does not set a `guard` , then it is no different in the existing functions from the current NFT issued based on the EIP-721 standard.
 
 ## Reference Implementation
   
@@ -151,54 +147,33 @@ abstract contract ERC6147 is ERC721, IERC6147 {
     
     mapping(uint256 => address) internal token_guard_map;
 
-    /// @notice Update the guard of the NFT
-    /// @dev Delete function: set guard  to 0 address,update function: set guard to new address
-    /// Throws if `tokenId` is not valid NFT
-    /// @param tokenId The NFT to update the guard address for
-    /// @param newGuard The newGuard address
-    /// @param allowNull Allow 0 address
-    function updateGuard(uint256 tokenId,address newGuard,bool allowNull) internal {
-        address guard = guardOf(tokenId);
-        if (!allowNull) {
-            require(newGuard != address(0), "ERC6147: new guard can not be null");
-        }
-        if (guard != address(0)) { 
-            require(guard == _msgSender(), "ERC6147: only guard can change it self"); 
-        } else { 
-            require(_isApprovedOrOwner(_msgSender(), tokenId),""ERC6147: caller is not owner nor approved");
-        } 
-
-        if (guard != address(0) || newGuard != address(0)) {
-            token_guard_map[tokenId] = newGuard;
-            emit UpdateGuardLog(tokenId, newGuard, guard);
-        }
-    }
-
-    /// @notice Owner sets guard or guard modifies guard
+    /// @notice Owner, authorised operators and approved address of the NFT can set guard of the NFT and guard can modifiy guard of the NFT
+    /// If the NFT has a guard role, the owner, authorised operators and approved address of the NFT cannot modify guard
     /// @dev The newGuard can not be zero address
     /// Throws if `tokenId` is not valid NFT
     /// @param tokenId The NFT to get the guard address for
     /// @param newGuard The new guard address of the NFT
     function changeGuard(uint256 tokenId, address newGuard) public virtual{
-        updateGuard(tokenId, newGuard, false);
+        _updateGuard(tokenId, newGuard, false);
     }
 
     /// @notice Remove the guard of the NFT
+    /// Only guard can remove its own guard role
     /// @dev The guard address is set to 0 address
-    ///      Only guard can remove its own guard role
     /// Throws if `tokenId` is not valid NFT
     /// @param tokenId The NFT to remove the guard address for
     function removeGuard(uint256 tokenId) public virtual  {
-        updateGuard(tokenId, address(0), true);
+        _updateGuard(tokenId, address(0), true);
     }
     
     /// @notice Transfer the NFT and remove its guard role
-    /// Throws  if `tokenId` is not valid NFT
-    /// @param  from The address of the previous owner of the NFT
-    /// @param  to The address of NFT recipient 
-    /// @param  tokenId The NFT to get transferred for
-    function transferAndRemove(address from,address to,uint256 tokenId) public virtual {
-        transferFrom(from,to,tokenId);
+    /// @dev The NFT is transferred to `to` and the guard address is set to 0 address
+    /// Throws if `tokenId` is not valid NFT
+    /// @param from The address of the previous owner of the NFT
+    /// @param to The address of NFT recipient 
+    /// @param tokenId The NFT to get transferred for
+    function transferAndRemove(address from, address to, uint256 tokenId) public virtual {
+        safeTransferFrom(from, to, tokenId);
         removeGuard(tokenId);
     }
     
@@ -210,37 +185,52 @@ abstract contract ERC6147 is ERC721, IERC6147 {
     function guardOf(uint256 tokenId) public view virtual returns (address) {
         return token_guard_map[tokenId];
     }
+
+    /// @notice Update the guard of the NFT
+    /// @dev Delete function: set guard to 0 address; and update function: set guard to new address
+    /// Throws if `tokenId` is not valid NFT
+    /// @param tokenId The NFT to update the guard address for
+    /// @param newGuard The newGuard address
+    /// @param allowNull Allow 0 address
+    function _updateGuard(uint256 tokenId, address newGuard, bool allowNull) internal {
+        address guard = guardOf(tokenId);
+        if (!allowNull) {
+            require(newGuard != address(0), "ERC6147: new guard can not be null");
+        }
+        if (guard != address(0)) { 
+            require(guard == _msgSender(), "ERC6147: only guard can change it self"); 
+        } else { 
+            require(_isApprovedOrOwner(_msgSender(), tokenId), "ERC6147: caller is not owner nor approved");
+        } 
+
+        if (guard != address(0) || newGuard != address(0)) {
+            token_guard_map[tokenId] = newGuard;
+            emit UpdateGuardLog(tokenId, newGuard, guard);
+        }
+    }
     
     /// @notice Check the guard address
     /// @dev The zero address indicates there is no guard
     /// Throws if `tokenId` is not valid NFT
     /// @param tokenId The NFT to check the guard address for
     /// @return The guard address
-    function checkGuard(uint256 tokenId) internal view returns (address) {
+    function _checkGuard(uint256 tokenId) internal view returns (address) {
         address guard = guardOf(tokenId);
         address sender = _msgSender();
         if (guard != address(0)) {
-            require(guard == sender, "sender is not guard of token");
+            require(guard == sender, "ERC6147: sender is not guard of the token");
             return guard;
         }else{
             return address(0);
         }
     }
-
-    ///@dev When burning, delete `token_guard_map[tokenId]`
-    function _burn(uint256 tokenId) internal virtual override {
-        address guard=guardOf(tokenId);
-        super._burn(tokenId);
-        delete token_guard_map[tokenId];
-        emit UpdateGuardLog(tokenId, address(0), guard);
-    }
  
     /// @dev Before transferring the NFT, need to check the gurard address
-    function transferFrom(address from,address to,uint256 tokenId) public virtual override {
+    function transferFrom(address from, address to, uint256 tokenId) public virtual override {
         address guard;
         address new_from = from;
         if (from != address(0)) {
-            guard = checkGuard(tokenId);
+            guard = _checkGuard(tokenId);
             new_from = ownerOf(tokenId);
         }
         if (guard == address(0)) {
@@ -253,11 +243,11 @@ abstract contract ERC6147 is ERC721, IERC6147 {
     }
 
     /// @dev Before safe transferring the NFT, need to check the gurard address
-    function safeTransferFrom(address from,address to,uint256 tokenId,bytes memory _data) public virtual override {
+    function safeTransferFrom(address from, address to, uint256 tokenId, bytes memory _data) public virtual override {
         address guard;
         address new_from = from;
         if (from != address(0)) {
-            guard = checkGuard(tokenId);
+            guard = _checkGuard(tokenId);
             new_from = ownerOf(tokenId);
         }
         if (guard == address(0)) {
@@ -269,20 +259,27 @@ abstract contract ERC6147 is ERC721, IERC6147 {
         _safeTransfer(from, to, tokenId, _data);
     }
 
+    /// @dev When burning, delete `token_guard_map[tokenId]`
+    /// This is an internal function that does not check if the sender is authorized to operate on the token.
+    function _burn(uint256 tokenId) internal virtual override {
+        address guard=guardOf(tokenId);
+        super._burn(tokenId);
+        delete token_guard_map[tokenId];
+        emit UpdateGuardLog(tokenId, address(0), guard);
+    }
+
     /// @dev See {IERC165-supportsInterface}.
     function supportsInterface(bytes4 interfaceId) public view virtual override returns (bool) {
         return interfaceId == type(IERC6147).interfaceId || super.supportsInterface(interfaceId);
     }
 }
-
 ```
 
-
 ## Security Considerations
 
 When an NFT has a `guard`, even if an address is authorized as an operator through `approve` or `setApprovalForAll`, the operator still has no right to transfer the NFT.
 
-For NFT trading platforms that trade through `setApprovalForAll` + holder's signature, when an NFT has a `guard`, it cannot be traded. It is recommended to prevent such pending orders by checking the interface beforehand.
+When an NFT has a `guard`, the `owner` cannot sell the NFT. Some trading platforms list NFTs through `setApprovalForAll` and owners' signature. It is recommended to prevent listing these NFTs by checking `guardOf`.
 
 ## Copyright
 

From ca51f64c269b38ac7d127382f20a5b191899d5cc Mon Sep 17 00:00:00 2001
From: Pedro Gomes <pedrogomes94@gmail.com>
Date: Tue, 7 Feb 2023 16:20:52 +0100
Subject: [PATCH 259/274] Update EIP-1328 from Stagnant to Review (#6451)

* Update eip-1328.md

* Update eip-1328.md

* Update eip-1328.md
---
 EIPS/eip-1328.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/EIPS/eip-1328.md b/EIPS/eip-1328.md
index 12e499b552411b..ddc15279daa58c 100644
--- a/EIPS/eip-1328.md
+++ b/EIPS/eip-1328.md
@@ -4,7 +4,7 @@ title: WalletConnect URI Format
 description: Define URI format for initiating connections between applications and wallets
 author: ligi (@ligi), Pedro Gomes (@pedrouid)
 discussions-to: https://ethereum-magicians.org/t/wallet-connect-eip/850
-status: Stagnant
+status: Review
 type: Standards Track
 category: ERC
 created: 2018-08-15
@@ -33,11 +33,14 @@ WalletConnect request URI with the following parameters:
 Required parameters are dependent on the WalletConnect protocol version:
 
 For WalletConnect v1.0 protocol (`version`=`1`) the parameters are:
+
 - `key` - symmetric key used for encryption
 - `bridge` - url of the bridge server for relaying messages
 
 For WalletConnect v2.0 protocol (`version`=`2`) the parameters are:
+
 - `symKey` - symmetric key used for encrypting messages over relay
+- `methods` - jsonrpc methods supported for pairing topic
 - `relay-protocol` - transport protocol for relaying messages
 - `relay-data` - (optional) transport data for relaying messages
 
@@ -49,7 +52,7 @@ For WalletConnect v2.0 protocol (`version`=`2`) the parameters are:
 wc:8a5e5bdc-a0e4-4702-ba63-8f1a5655744f@1?bridge=https%3A%2F%2Fbridge.walletconnect.org&key=41791102999c339c844880b23950704cc43aa840f3739e365323cda4dfa89e7a
 
 # 2.0
-wc:c9e6d30fb34afe70a15c14e9337ba8e4d5a35dd695c39b94884b0ee60c69d168@2?relay-protocol=waku&symKey=7ff3e362f825ab868e20e767fe580d0311181632707e7c878cbeca0238d45b8b
+wc:7f6e504bfad60b485450578e05678ed3e8e8c4751d3c6160be17160d63ec90f9@2?relay-protocol=irn&symKey=587d5484ce2a2a6ee3ba1962fdd7e8588e06200c46823bd18fbd67def96ad303&methods=[wc_sessionPropose],[wc_authRequest,wc_authBatchRequest]"
 ```
 
 ## Rationale

From 0b651ed5cb854b149b4047566182588f22200ac2 Mon Sep 17 00:00:00 2001
From: Benjamin Evans Chodroff
 <4411206+benjaminchodroff@users.noreply.github.com>
Date: Tue, 7 Feb 2023 23:28:54 +0800
Subject: [PATCH 260/274] Update EIP-4736: Move to Review (#6447)

* Updated to Set Withdrawal Address and ethdo format

* ethdo spec format

* Remove Acceptance in favor of simplified broadcast file

* Removing github external link

* Markdown Linter fixes

* Lint Unordered list style and code blocks

* Update eip-4736.md

Moving to review status
---
 EIPS/eip-4736.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4736.md b/EIPS/eip-4736.md
index 4fbb85965586a0..cca49f44af6d67 100644
--- a/EIPS/eip-4736.md
+++ b/EIPS/eip-4736.md
@@ -4,7 +4,7 @@ title: Consensus Layer Withdrawal Protection
 description: Additional security for "set withdrawal address" operation when a consensus layer mnemonic may be compromised, without changing consensus
 author: Benjamin Chodroff (@benjaminchodroff), Jim McDonald (@mcdee)
 discussions-to: https://ethereum-magicians.org/t/consensus-layer-withdrawal-protection/8161
-status: Draft
+status: Review
 type: Standards Track
 category: Interface
 created: 2022-01-30

From 71129f0ae980451f59dced8f63dc2c54ca21303f Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Tue, 7 Feb 2023 16:30:28 +0100
Subject: [PATCH 261/274] Propose Minimalistic Souldbound Extension for
 Non-Fungible Tokens (#6454)

* Propose Minimalistic Souldbound Extension for Non-Fungible Tokens

Proposed an interface for Non-Fungible Tokens extension allowing for
them to be non-transferrable.

* Assigned EIP number

Assigned the EIP number based on the PR number.

* Fix author formatting

* Fix links

* Fix typo in the title

* Fix typos

* Fixed the backwards compatimility typo

* Fixed reference link

* Added explanation why we feel that this should be an EIP

* Fix a typo in backwards compatibility
---
 EIPS/eip-6454.md                              | 107 ++++++++++++++++++
 assets/eip-6454/contracts/ISoulbound.sol      |  13 +++
 .../contracts/mocks/ERC721SoulboundMock.sol   |  61 ++++++++++
 assets/eip-6454/hardhat.config.ts             |  17 +++
 assets/eip-6454/package.json                  |  28 +++++
 assets/eip-6454/test/soulbound.ts             |  57 ++++++++++
 6 files changed, 283 insertions(+)
 create mode 100644 EIPS/eip-6454.md
 create mode 100644 assets/eip-6454/contracts/ISoulbound.sol
 create mode 100644 assets/eip-6454/contracts/mocks/ERC721SoulboundMock.sol
 create mode 100644 assets/eip-6454/hardhat.config.ts
 create mode 100644 assets/eip-6454/package.json
 create mode 100644 assets/eip-6454/test/soulbound.ts

diff --git a/EIPS/eip-6454.md b/EIPS/eip-6454.md
new file mode 100644
index 00000000000000..ca7ad541d30594
--- /dev/null
+++ b/EIPS/eip-6454.md
@@ -0,0 +1,107 @@
+---
+eip: 6454
+title: Minimalistic Soulbound interface for NFTs
+description: An interface for Soulbound Non-Fungible Tokens extension allowing for tokens to be non-transferrable.
+author: Bruno Škvorc (@Swader), Francesco Sullo (@sullof), Steven Pineda (@steven2308), Stevan Bogosavljevic (@stevyhacker), Jan Turk (@ThunderDeliverer)
+discussions-to: https://ethereum-magicians.org/t/minimalistic-transferable-interface/12517
+status: Draft
+type: Standards Track
+category: ERC
+created: 2023-01-31
+requires: 165, 721
+---
+
+## Abstract
+
+The Minimalistic Soulbound interface for Non-Fungible Tokens standard extends [EIP-721](./eip-721.md) by preventing NFTs to be transferred.
+
+This proposal introduces the ability to prevent a token to be transferred from their owner, making them bound to the externally owned account, smart contract or token that owns it.
+
+## Motivation
+
+With NFTs being a widespread form of tokens in the Ethereum ecosystem and being used for a variety of use cases, it is time to standardize additional utility for them. Having the ability to prevent the tokens to be transferred introduces new possibilities of NFT utility and evolution.
+
+This proposal is designed in a way to be as minimal as possible in order to be compatible with any usecases that wish to utilize this proposal.
+
+This EIP introduces new utilities for [EIP-721](./eip-721.md) based tokens in the following areas:
+
+- [Verifiable attribution](#verifiable-attribution)
+- [Immutable properties](#immutable-properties)
+
+### Verifiable attribution
+
+Personal achievements can be represented by non-fungible tokens. These tokens can be used to represent a wide range of accomplishments, including scientific advancements, philanthropic endeavors, athletic achievements, and more. However, if these achievement-indicating NFTs can be easily transferred, their authenticity and trustworthiness can be called into question. By binding the NFT to a specific account, it can be ensured that the account owning the NFT is the one that actually achieved the corresponding accomplishment. This creates a secure and verifiable record of personal achievements that can be easily accessed and recognized by others in the network. The ability to verify attribution helps to establish the credibility and value of the achievement-indicating NFT, making it a valuable asset that can be used as a recognition of the holder's accomplishments.
+
+### Immutable properties
+
+NFT properties are a critical aspect of non-fungible tokens, serving to differentiate them from one another and establish their scarcity. Centralized control of NFT properties by the issuer, however, can undermine the uniqueness of these properties.
+
+By tying NFTs to specific properties, the original owner is ensured that the NFT will always retain these properties and its uniqueness.
+
+In a blockchain game that employs soulbound NFTs to represent skills or abilities, each skill would be a unique and permanent asset tied to a specific player or token. This would ensure that players retain ownership of the skills they have earned and prevent them from being traded or sold to other players. This can increase the perceived value of these skills, enhancing the player experience by allowing for greater customization and personalization of characters.
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
+
+```solidity
+/// @title EIP-6454 Minimalistic Soulbound interface for NFTs
+/// @dev See https://eips.ethereum.org/EIPS/eip-6454
+/// @dev Note: the ERC-165 identifier for this interface is 0x911ec470.
+
+pragma solidity ^0.8.16;
+
+interface IERC6454 is IERC165 {
+    /**
+     * @notice Used to check whether the given token is soulbound or not.
+     * @dev If this function returns `true`, the transfer of the token MUST revert execution
+     * @param tokenId ID of the token being checked
+     * @return Boolean value indicating whether the given token is soulbound
+     */
+    function isSoulbound(uint256 tokenId) external view returns (bool);
+}
+```
+
+## Rationale
+
+Designing the proposal, we considered the following questions:
+
+1. **Should we propose another Soulbound NFT proposal given the existence of existing ones, some even final, and how does this proposal compare to them?**\
+   This proposal aims to provide the minimum necessary specification for the implementation of soulbound NFTs, we feel none of the existing proposals have presented the minimal required interface. Unlike other proposals that address the same issue, this proposal requires fewer methods in its specification, providing a more streamlined solution.
+2. **Why is there no event marking the token as Soulbound in this interface?**\
+   The token can become soulbound either at its creation, after being marked as soulbound, or after a certain condition is met. This means that some cases of tokens becoming soulbound cannot emit an event, such as if the token becoming soulbound is determined by a block number. Requiring an event to be emitted upon the token becoming soulbound is not feasible in such cases.
+3. **Should the soulbound state management function be included in this proposal?**\
+   A function that marks a token as soulbound or releases the binding is referred to as the soulbound management function. To maintain the objective of designing an agnostic soulbound proposal, we have decided not to specify the soulbound management function. This allows for a variety of custom implementations that require the tokens to be non-transferable.
+4. **Why should this be an EIP if it only contains one method?**\
+   One could argue that since the core of this proposal is to only prevent EIP-721 tokens to be transferred, this could be done by overriding the transfer function. While this is true, the only way to assure that the token is soulbound before the smart contract execution, is for it to have the soulbound interface.\
+   This also allows for smart contract to validate that the token is soulbound and not attempt transferring it as this would result in failed transactions and wasted gas.
+
+## Backwards Compatibility
+
+The Minimalistic Soulbound token standard is fully compatible with [EIP-721](./eip-721.md) and with the robust tooling available for implementations of EIP-721 as well as with the existing EIP-721 infrastructure.
+
+## Test Cases
+
+Tests are included in [`soulbound.ts`](../assets/eip-6454/test/soulbound.ts).
+
+To run them in terminal, you can use the following commands:
+
+```
+cd ../assets/eip-6454
+npm install
+npx hardhat test
+```
+
+## Reference Implementation
+
+See [`ERC721SoulboundMock.sol`](../assets/eip-6454/contracts/mocks/ERC721SoulboundMock.sol).
+
+## Security Considerations
+
+The same security considerations as with [EIP-721](./eip-721.md) apply: hidden logic may be present in any of the functions, including burn, add asset, accept asset, and more.
+
+Caution is advised when dealing with non-audited contracts.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-6454/contracts/ISoulbound.sol b/assets/eip-6454/contracts/ISoulbound.sol
new file mode 100644
index 00000000000000..66dafa782980f5
--- /dev/null
+++ b/assets/eip-6454/contracts/ISoulbound.sol
@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+interface ISoulbound {
+
+    /**
+     * @notice Used to check whether the given token is soulbound or not.
+     * @param tokenId ID of the token being checked
+     * @return Boolean value indicating whether the given token is soulbound
+     */
+    function isSoulbound(uint256 tokenId) external view returns (bool);
+}
\ No newline at end of file
diff --git a/assets/eip-6454/contracts/mocks/ERC721SoulboundMock.sol b/assets/eip-6454/contracts/mocks/ERC721SoulboundMock.sol
new file mode 100644
index 00000000000000..843735ca74b010
--- /dev/null
+++ b/assets/eip-6454/contracts/mocks/ERC721SoulboundMock.sol
@@ -0,0 +1,61 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+import "../ISoulbound.sol";
+
+error CannotTransferSoulbound();
+
+/**
+ * @title ERC721SoulboundMock
+ * Used for tests
+ */
+contract ERC721SoulboundMock is ISoulbound, ERC721 {
+    constructor(
+        string memory name,
+        string memory symbol
+    ) ERC721(name, symbol) {}
+
+    function mint(address to, uint256 amount) public {
+        _mint(to, amount);
+    }
+
+    function burn(uint256 tokenId) public {
+        _burn(tokenId);
+    }
+
+    function isSoulbound(uint256 tokenId) public view returns (bool) {
+        return true;
+    }
+
+    function _beforeTokenTransfer(
+        address from,
+        address to,
+        uint256 firstTokenId,
+        uint256 batchSize
+    ) internal virtual override {
+        super._beforeTokenTransfer(from, to, firstTokenId, batchSize);
+
+        // exclude minting and burning
+        if ( from != address(0) && to != address(0)) {
+            uint256 lastTokenId = firstTokenId + batchSize;
+            for (uint256 i = firstTokenId; i < lastTokenId; i++) {
+                uint256 tokenId = firstTokenId + i;
+                if (isSoulbound(tokenId)) {
+                    revert CannotTransferSoulbound();
+                }
+                unchecked {
+                    i++;
+                }
+            }
+        }
+    }
+
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual override(ERC721) returns (bool) {
+        return interfaceId == type(ISoulbound).interfaceId
+            || super.supportsInterface(interfaceId);
+    }
+}
diff --git a/assets/eip-6454/hardhat.config.ts b/assets/eip-6454/hardhat.config.ts
new file mode 100644
index 00000000000000..f1b6fdec4582da
--- /dev/null
+++ b/assets/eip-6454/hardhat.config.ts
@@ -0,0 +1,17 @@
+import { HardhatUserConfig } from "hardhat/config";
+import "@nomicfoundation/hardhat-chai-matchers";
+import "@typechain/hardhat";
+
+const config: HardhatUserConfig = {
+  solidity: {
+    version: "0.8.16",
+    settings: {
+      optimizer: {
+        enabled: true,
+        runs: 200,
+      },
+    },
+  },
+};
+
+export default config;
diff --git a/assets/eip-6454/package.json b/assets/eip-6454/package.json
new file mode 100644
index 00000000000000..b9dffe2c49a639
--- /dev/null
+++ b/assets/eip-6454/package.json
@@ -0,0 +1,28 @@
+{
+  "name": "soulbound-tokens",
+  "scripts": {
+    "test": "yarn typechain && hardhat test",
+    "typechain": "hardhat typechain",
+    "prettier": "prettier --write ."
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "@openzeppelin/contracts": "^4.6.0"
+  },
+  "devDependencies": {
+    "@nomicfoundation/hardhat-chai-matchers": "^1.0.1",
+    "@nomicfoundation/hardhat-network-helpers": "^1.0.3",
+    "@nomiclabs/hardhat-ethers": "^2.2.1",
+    "@typechain/ethers-v5": "^10.1.0",
+    "@typechain/hardhat": "^6.1.2",
+    "@types/chai": "^4.3.1",
+    "chai": "^4.3.6",
+    "ethers": "^5.6.9",
+    "hardhat": "^2.12.2",
+    "ts-node": "^10.8.2",
+    "typechain": "^8.1.0",
+    "typescript": "^4.7.4"
+  }
+}
diff --git a/assets/eip-6454/test/soulbound.ts b/assets/eip-6454/test/soulbound.ts
new file mode 100644
index 00000000000000..cbc2a72422e519
--- /dev/null
+++ b/assets/eip-6454/test/soulbound.ts
@@ -0,0 +1,57 @@
+import { ethers } from "hardhat";
+import { expect } from "chai";
+import { BigNumber } from "ethers";
+import { loadFixture } from "@nomicfoundation/hardhat-network-helpers";
+import { SignerWithAddress } from "@nomiclabs/hardhat-ethers/signers";
+import { ERC721SoulboundMock } from "../typechain-types";
+
+async function soulboundTokenFixture(): Promise<ERC721SoulboundMock> {
+  const factory = await ethers.getContractFactory("ERC721SoulboundMock");
+  const token = await factory.deploy("Chunky", "CHNK");
+  await token.deployed();
+
+  return token;
+}
+
+describe("Soulbound", async function () {
+  let soulbound: ERC721SoulboundMock;
+  let owner: SignerWithAddress;
+  let otherOwner: SignerWithAddress;
+  const tokenId = 1;
+
+  beforeEach(async function () {
+    const signers = await ethers.getSigners();
+    owner = signers[0];
+    otherOwner = signers[1];
+    soulbound = await loadFixture(soulboundTokenFixture);
+
+    await soulbound.mint(owner.address, 1);
+  });
+
+  it("can support IRMRKSoulbound", async function () {
+    expect(await soulbound.supportsInterface("0x911ec470")).to.equal(true);
+  });
+
+  it("does not support other interfaces", async function () {
+    expect(await soulbound.supportsInterface("0xffffffff")).to.equal(false);
+  });
+
+  it("cannot transfer", async function () {
+    expect(
+      soulbound
+        .connect(owner)
+        ["safeTransferFrom(address,address,uint256)"](
+          owner.address,
+          otherOwner.address,
+          tokenId
+        )
+    ).to.be.revertedWithCustomError(soulbound, "CannotTransferSoulbound");
+  });
+
+  it("can burn", async function () {
+    await soulbound.connect(owner).burn(tokenId);
+    await expect(soulbound.ownerOf(tokenId)).to.be.revertedWith(
+      "ERC721: invalid token ID"
+    );
+  });
+});

From fb5b4c27638c0d9c59ceef17c21aec2053fe01e1 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Tue, 7 Feb 2023 10:31:54 -0500
Subject: [PATCH 262/274] Update EIP-6188: Move to Review (#6351)


From 7538bf2feb8bbacabc5eb9d3e99f580e5c8accbe Mon Sep 17 00:00:00 2001
From: Jan Turk <jan.turk12@gmail.com>
Date: Tue, 7 Feb 2023 16:39:04 +0100
Subject: [PATCH 263/274] Propose Emotable Extension for Non-Fungible Tokens
 (#6381)

* Propose Emotable Extension for Non-Fungible Tokens

Proposed an interface for Non-Fungible Tokens extension allowing for
reacting to them using Unicode emojis.

* Assign a proposal number

The proposal number was assigned based on the PR number. If the editors
desire to change the PR number, that can be easily arranged.

* Add discussion URL

* Fix link typo

* Update EIPS/eip-6381.md

Updates description of EIP

Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>

* Addresses editor suggestions.

---------

Co-authored-by: Steven Pineda <steven2308@outlook.com>
Co-authored-by: Sam Wilson <57262657+SamWilsn@users.noreply.github.com>
---
 EIPS/eip-6381.md                              | 131 ++++++++++++++++++
 assets/eip-6381/contracts/Emotable.sol        |  42 ++++++
 assets/eip-6381/contracts/IEmotable.sol       |  20 +++
 .../contracts/mocks/ERC721EmotableMock.sol    |  36 +++++
 assets/eip-6381/hardhat.config.ts             |  17 +++
 assets/eip-6381/package.json                  |  28 ++++
 assets/eip-6381/test/emotable.ts              |  91 ++++++++++++
 7 files changed, 365 insertions(+)
 create mode 100644 EIPS/eip-6381.md
 create mode 100644 assets/eip-6381/contracts/Emotable.sol
 create mode 100644 assets/eip-6381/contracts/IEmotable.sol
 create mode 100644 assets/eip-6381/contracts/mocks/ERC721EmotableMock.sol
 create mode 100644 assets/eip-6381/hardhat.config.ts
 create mode 100644 assets/eip-6381/package.json
 create mode 100644 assets/eip-6381/test/emotable.ts

diff --git a/EIPS/eip-6381.md b/EIPS/eip-6381.md
new file mode 100644
index 00000000000000..823e41b7b1642e
--- /dev/null
+++ b/EIPS/eip-6381.md
@@ -0,0 +1,131 @@
+---
+eip: 6381
+title: Emotable Extension for Non-Fungible Tokens
+description: React to Non-Fungible Tokens using Unicode emojis.
+author: Bruno Škvorc (@Swader), Steven Pineda (@steven2308), Stevan Bogosavljevic (@stevyhacker), Jan Turk (@ThunderDeliverer)
+discussions-to: https://ethereum-magicians.org/t/eip-6381-emotable-extension-for-non-fungible-tokens/12710
+status: Draft
+type: Standards Track
+category: ERC
+created: 2023-01-22
+requires: 165, 721
+---
+
+## Abstract
+
+The Emotable Extension for Non-Fungible Tokens standard extends [EIP-721](./eip-721.md) by allowing NFTs to be emoted at.
+
+This proposal introduces the ability to react to NFTs using Unicode standardized emoji.
+
+## Motivation
+
+With NFTs being a widespread form of tokens in the Ethereum ecosystem and being used for a variety of use cases, it is time to standardize additional utility for them. Having the ability for anyone to interact with an NFT introduces an interactive aspect to owning an NFT and unlocks feedback-based NFT mechanics.
+
+This EIP introduces new utilities for [EIP-721](./eip-721.md) based tokens in the following areas:
+
+- [Interactivity](#interactivity)
+- [Feedback based evolution](#feedback-based-evolution)
+- [Valuation](#valuation)
+
+### Interactivity
+
+The ability to emote on an NFT introduces the aspect of interactivity to owning an NFT. This can either reflect the admiration for the emoter (person emoting to an NFT) or can be a result of a certain action performed by the token's owner. Accumulating emotes on a token can increase its uniqueness and/or value.
+
+### Feedback based evolution
+
+Standardized on-chain reactions to NFTs allow for feedback based evolution.
+
+Current solutions are either proprietary or off-chain and therefore subject to manipulation and distrust. Having the ability to track the interaction on-chain allows for trust and objective evaluation of a given token. Designing the tokens to evolve when certain emote thresholds are met incentivizes interaction with the token collection.
+
+### Valuation
+
+Current NFT market heavily relies on previous values the token has been sold for, the lowest price of the listed token and the scarcity data provided by the marketplace. There is no real time indication of admiration or desirability of a specific token. Having the ability for users to emote to the tokens adds the possibility of potential buyers and sellers gageing the value of the token based on the impressions the token has collected.
+
+## Specification
+
+The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119.
+
+```solidity
+/// @title EIP-6381 Emotable Extension for Non-Fungible Tokens
+/// @dev See https://eips.ethereum.org/EIPS/eip-6381
+/// @dev Note: the ERC-165 identifier for this interface is 0xf8d6854d.
+
+pragma solidity ^0.8.16;
+
+interface IEmotable is IERC165 {
+    /**
+     * @notice Used to notify listeners that the token with the specified ID has been emoted to or that the reaction has been revoked.
+     * @dev The event SHOULD only be emitted if the state of the emote is changed.
+     * @param emoter Address of the account that emoted or revoked the reaction to the token
+     * @param tokenId ID of the token
+     * @param emoji Unicode identifier of the emoji
+     * @param on Boolean value signifying whether the token was emoted to (`true`) or if the reaction has been revoked (`false`)
+     */
+    event Emoted(
+        address indexed emoter,
+        uint256 indexed tokenId,
+        bytes4 emoji,
+        bool on
+    );
+
+    /**
+     * @notice Used to get the number of emotes for a specific emoji on a token.
+     * @param tokenId ID of the token to check for emoji count
+     * @param emoji Unicode identifier of the emoji
+     * @return Number of emotes with the emoji on the token
+     */
+    function emoteCountOf(
+        uint256 tokenId,
+        bytes4 emoji
+    ) external view returns (uint256);
+
+    /**
+     * @notice Used to emote or undo an emote on a token.
+     * @dev Does nothing if attempting to set a pre-existent state.
+     * @dev When the state is being changed, the Emoted event MUST be emitted.
+     * @param tokenId ID of the token being emoted
+     * @param emoji Unicode identifier of the emoji
+     * @param state Boolean value signifying whether to emote (`true`) or undo (`false`) emote
+     */
+    function emote(uint256 tokenId, bytes4 emoji, bool state) external;
+}
+```
+
+## Rationale
+
+Designing the proposal, we considered the following questions:
+
+1. **Does the proposal support custom emotes or only the Unicode specified ones?**\
+The proposal only accepts the Unicode identifier which is a `bytes4` value. This means that while we encourage implementers to add the reactions using standardized emojis, the values not covered by the Unicode standard can be used for custom emotes. The only drawback being that the interface displaying the reactions will have to know what kind of image to render and such additions will probably be limited to the interface or marketplace in which they were made.
+2. **Should the proposal use emojis to relay the impressions of NFTs or some other method?**\
+The impressions could have been done using user-supplied strings or numeric values, yet we decided to use emojis since they are a well established mean of relaying impressions and emotions.
+
+## Backwards Compatibility
+
+The Emotable token standard is fully compatible with [EIP-721](./eip-721.md) and with the robust tooling available for implementations of EIP-721 as well as with the existing EIP-721 infrastructure.
+
+## Test Cases
+
+Tests are included in [`emotable.ts`](../assets/eip-6381/test/emotable.ts).
+
+To run them in terminal, you can use the following commands:
+
+```
+cd ../assets/eip-6381
+npm install
+npx hardhat test
+```
+
+## Reference Implementation
+
+See [`Emotable.sol`](../assets/eip-6381/contracts/Emotable.sol).
+
+## Security Considerations
+
+The same security considerations as with [EIP-721](./eip-721.md) apply: hidden logic may be present in any of the functions, including burn, add asset, accept asset, and more.
+
+Caution is advised when dealing with non-audited contracts.
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).
diff --git a/assets/eip-6381/contracts/Emotable.sol b/assets/eip-6381/contracts/Emotable.sol
new file mode 100644
index 00000000000000..4d1d2b7e6c9fe6
--- /dev/null
+++ b/assets/eip-6381/contracts/Emotable.sol
@@ -0,0 +1,42 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "./IEmotable.sol";
+
+abstract contract Emotable is IEmotable {
+    // Used to avoid double emoting and control undoing
+    mapping(address => mapping(uint256 => mapping(bytes4 => uint256)))
+        private _emotesPerAddress; // Cheaper than using a bool
+    mapping(uint256 => mapping(bytes4 => uint256)) private _emotesPerToken;
+
+    function emoteCountOf(
+        uint256 tokenId,
+        bytes4 emoji
+    ) public view returns (uint256) {
+        return _emotesPerToken[tokenId][emoji];
+    }
+
+    /**
+     * @notice Used to emote or undo an emote on a token.
+     * @param tokenId ID of the token being emoted
+     * @param emoji Unicode identifier of the emoji
+     * @param state Boolean value signifying whether to emote (`true`) or undo (`false`) emote
+     */
+    function _emote(
+        uint256 tokenId,
+        bytes4 emoji,
+        bool state
+    ) internal virtual {
+        bool currentVal = _emotesPerAddress[msg.sender][tokenId][emoji] == 1;
+        if (currentVal != state) {
+            if (state) {
+                _emotesPerToken[tokenId][emoji] += 1;
+            } else {
+                _emotesPerToken[tokenId][emoji] -= 1;
+            }
+            _emotesPerAddress[msg.sender][tokenId][emoji] = state ? 1 : 0;
+            emit Emoted(msg.sender, tokenId, emoji, state);
+        }
+    }
+}
\ No newline at end of file
diff --git a/assets/eip-6381/contracts/IEmotable.sol b/assets/eip-6381/contracts/IEmotable.sol
new file mode 100644
index 00000000000000..ef50d7913579b9
--- /dev/null
+++ b/assets/eip-6381/contracts/IEmotable.sol
@@ -0,0 +1,20 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+interface IEmotable {
+
+    event Emoted(
+        address indexed emoter,
+        uint256 indexed tokenId,
+        bytes4 emoji,
+        bool on
+    );
+
+    function emoteCountOf(
+        uint256 tokenId,
+        bytes4 emoji
+    ) external view returns (uint256);
+
+    function emote(uint256 tokenId, bytes4 emoji, bool state) external;
+}
\ No newline at end of file
diff --git a/assets/eip-6381/contracts/mocks/ERC721EmotableMock.sol b/assets/eip-6381/contracts/mocks/ERC721EmotableMock.sol
new file mode 100644
index 00000000000000..31589d3a27caa1
--- /dev/null
+++ b/assets/eip-6381/contracts/mocks/ERC721EmotableMock.sol
@@ -0,0 +1,36 @@
+// SPDX-License-Identifier: CC0-1.0
+
+pragma solidity ^0.8.16;
+
+import "@openzeppelin/contracts/token/ERC721/ERC721.sol";
+import "../Emotable.sol";
+
+/**
+ * @title ERC721EmotableMock
+ * Used for tests
+ */
+contract ERC721EmotableMock is ERC721, Emotable {
+    constructor(
+        string memory name,
+        string memory symbol
+    ) ERC721(name, symbol) {}
+
+    function mint(address to, uint256 amount) public {
+        _mint(to, amount);
+    }
+
+    function emote(
+        uint256 tokenId,
+        bytes4 emoji,
+        bool state
+    ) public virtual {
+        _emote(tokenId, emoji, state);
+    }
+
+    function supportsInterface(
+        bytes4 interfaceId
+    ) public view virtual override(ERC721) returns (bool) {
+        return interfaceId == type(IEmotable).interfaceId
+            || super.supportsInterface(interfaceId);
+    }
+}
diff --git a/assets/eip-6381/hardhat.config.ts b/assets/eip-6381/hardhat.config.ts
new file mode 100644
index 00000000000000..141ca45fcce81e
--- /dev/null
+++ b/assets/eip-6381/hardhat.config.ts
@@ -0,0 +1,17 @@
+import { HardhatUserConfig } from 'hardhat/config';
+import '@nomicfoundation/hardhat-chai-matchers';
+import '@typechain/hardhat';
+
+const config: HardhatUserConfig = {
+  solidity: {
+    version: '0.8.16',
+    settings: {
+      optimizer: {
+        enabled: true,
+        runs: 200,
+      },
+    },
+  },
+};
+
+export default config;
diff --git a/assets/eip-6381/package.json b/assets/eip-6381/package.json
new file mode 100644
index 00000000000000..0268fcc3a6801a
--- /dev/null
+++ b/assets/eip-6381/package.json
@@ -0,0 +1,28 @@
+{
+  "name": "emotable-tokens",
+  "scripts": {
+    "test": "yarn typechain && hardhat test",
+    "typechain": "hardhat typechain",
+    "prettier": "prettier --write ."
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "@openzeppelin/contracts": "^4.6.0"
+  },
+  "devDependencies": {
+    "@nomicfoundation/hardhat-chai-matchers": "^1.0.1",
+    "@nomicfoundation/hardhat-network-helpers": "^1.0.3",
+    "@nomiclabs/hardhat-ethers": "^2.2.1",
+    "@typechain/ethers-v5": "^10.1.0",
+    "@typechain/hardhat": "^6.1.2",
+    "@types/chai": "^4.3.1",
+    "chai": "^4.3.6",
+    "ethers": "^5.6.9",
+    "hardhat": "^2.12.2",
+    "ts-node": "^10.8.2",
+    "typechain": "^8.1.0",
+    "typescript": "^4.7.4"
+  }
+}
diff --git a/assets/eip-6381/test/emotable.ts b/assets/eip-6381/test/emotable.ts
new file mode 100644
index 00000000000000..1fedf095d2f31f
--- /dev/null
+++ b/assets/eip-6381/test/emotable.ts
@@ -0,0 +1,91 @@
+import { ethers } from 'hardhat';
+import { expect } from 'chai';
+import { BigNumber, Contract } from 'ethers';
+import { loadFixture } from '@nomicfoundation/hardhat-network-helpers';
+import { SignerWithAddress } from '@nomiclabs/hardhat-ethers/signers';
+import { ERC721EmotableMock } from '../typechain-types';
+
+function bn(x: number): BigNumber {
+  return BigNumber.from(x);
+}
+
+async function emotableTokenFixture() {
+  const factory = await ethers.getContractFactory('ERC721EmotableMock');
+  const token = await factory.deploy('Chunky', 'CHNK');
+  await token.deployed();
+
+  return token;
+}
+
+describe('RMRKMultiAssetEmotableMock', async function () {
+  let token: ERC721EmotableMock;
+  let owner: SignerWithAddress;
+  let addrs: SignerWithAddress[];
+  const tokenId = bn(1);
+  const emoji1 = Buffer.from('😎');
+  const emoji2 = Buffer.from('😁');
+
+  beforeEach(async function () {
+    [owner, ...addrs] = await ethers.getSigners();
+    token = await loadFixture(emotableTokenFixture);
+  });
+
+  it('can support IEmotable', async function () {
+    expect(await token.supportsInterface('0xf8d6854d')).to.equal(true);
+  });
+
+  it('can support IERC721', async function () {
+    expect(await token.supportsInterface('0x80ac58cd')).to.equal(true);
+  });
+
+  it('does not support other interfaces', async function () {
+    expect(await token.supportsInterface('0xffffffff')).to.equal(false);
+  });
+
+  describe('With minted tokens', async function () {
+    beforeEach(async function () {
+      await token.mint(owner.address, tokenId);
+    });
+
+    it('can emote', async function () {
+      await expect(token.emote(tokenId, emoji1, true))
+        .to.emit(token, 'Emoted')
+        .withArgs(owner.address, tokenId.toNumber(), emoji1, true);
+      expect(await token.emoteCountOf(tokenId, emoji1)).to.equal(bn(1));
+    });
+
+    it('can undo emote', async function () {
+      await token.emote(tokenId, emoji1, true);
+
+      await expect(token.emote(tokenId, emoji1, false))
+        .to.emit(token, 'Emoted')
+        .withArgs(owner.address, tokenId.toNumber(), emoji1, false);
+      expect(await token.emoteCountOf(tokenId, emoji1)).to.equal(bn(0));
+    });
+
+    it('can be emoted from different accounts', async function () {
+      await token.connect(addrs[0]).emote(tokenId, emoji1, true);
+      await token.connect(addrs[1]).emote(tokenId, emoji1, true);
+      await token.connect(addrs[2]).emote(tokenId, emoji2, true);
+      expect(await token.emoteCountOf(tokenId, emoji1)).to.equal(bn(2));
+      expect(await token.emoteCountOf(tokenId, emoji2)).to.equal(bn(1));
+    });
+
+    it('can add multiple emojis to same NFT', async function () {
+      await token.emote(tokenId, emoji1, true);
+      await token.emote(tokenId, emoji2, true);
+      expect(await token.emoteCountOf(tokenId, emoji1)).to.equal(bn(1));
+      expect(await token.emoteCountOf(tokenId, emoji2)).to.equal(bn(1));
+    });
+
+    it('does nothing if new state is the same as old state', async function () {
+      await token.emote(tokenId, emoji1, true);
+      await token.emote(tokenId, emoji1, true);
+      expect(await token.emoteCountOf(tokenId, emoji1)).to.equal(bn(1));
+
+      await token.emote(tokenId, emoji2, false);
+      expect(await token.emoteCountOf(tokenId, emoji2)).to.equal(bn(0));
+    });
+  });
+});
+

From 9e7f979f66a28f18bfee4f17af5b1f2b071bcea4 Mon Sep 17 00:00:00 2001
From: Pooja Ranjan <29681685+poojaranjan@users.noreply.github.com>
Date: Wed, 8 Feb 2023 01:10:34 -0500
Subject: [PATCH 264/274] Update eip-4938.md (#6456)

Change status to `Review`
---
 EIPS/eip-4938.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4938.md b/EIPS/eip-4938.md
index 3867d780a38955..2879fcad8ff78f 100644
--- a/EIPS/eip-4938.md
+++ b/EIPS/eip-4938.md
@@ -4,7 +4,7 @@ title: "eth/67 - Removal of GetNodeData"
 description: "Remove GetNodeData and NodeData messages from the wire protocol"
 author: Marius van der Wijden (@MariusVanDerWijden), Felix Lange <fjl@ethereum.org>, Gary Rong <garyrong@ethereum.org>
 discussions-to: https://ethereum-magicians.org/t/eip-4938-removal-of-getnodedata/8893
-status: Draft
+status: Review
 type: Standards Track
 category: Networking
 created: 2022-03-23

From 01d320998d1d53d95f347b5f43feaf606f230703 Mon Sep 17 00:00:00 2001
From: protolambda <proto@protolambda.com>
Date: Wed, 8 Feb 2023 07:15:25 +0100
Subject: [PATCH 265/274] EIP-4844: update to Review status (#6030)

---
 EIPS/eip-4844.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-4844.md b/EIPS/eip-4844.md
index ef61aa9370fe7a..073f340474fb1d 100644
--- a/EIPS/eip-4844.md
+++ b/EIPS/eip-4844.md
@@ -4,7 +4,7 @@ title: Shard Blob Transactions
 description: Shard Blob Transactions scale data-availability of Ethereum in a simple, forwards-compatible manner.
 author: Vitalik Buterin (@vbuterin), Dankrad Feist (@dankrad), Diederik Loerakker (@protolambda), George Kadianakis (@asn-d6), Matt Garnett (@lightclient), Mofi Taiwo (@Inphi), Ansgar Dietrichs (@adietrichs)
 discussions-to: https://ethereum-magicians.org/t/eip-4844-shard-blob-transactions/8430
-status: Draft
+status: Review
 type: Standards Track
 category: Core
 created: 2022-02-25

From 52c7eb101ef886bf2b30433c13a88154fd3d8892 Mon Sep 17 00:00:00 2001
From: yus <suyu.nu@gmail.com>
Date: Wed, 8 Feb 2023 19:37:35 +0800
Subject: [PATCH 266/274] update eip-5585 (#6462)

fix CI error
---
 EIPS/eip-5585.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/EIPS/eip-5585.md b/EIPS/eip-5585.md
index 2b66e34318179c..64984b2120c0d0 100644
--- a/EIPS/eip-5585.md
+++ b/EIPS/eip-5585.md
@@ -118,6 +118,7 @@ interface IERC5585 {
     event authorizeUser(uint256 indexed tokenId, address indexed user, string[] rights, uint expires);
 }
 ```
+
 The `getRights()` function MAY be implemented as pure and view.
 
 The `authorizeUser(uint256 tokenId, address user, uint duration)` function MAY be implemented as `public` or `external`.

From c47529706c3502eb5846eaebb5887a28ab5dc5b4 Mon Sep 17 00:00:00 2001
From: adeelhasan <adeelhasan@users.noreply.github.com>
Date: Wed, 8 Feb 2023 06:39:45 -0500
Subject: [PATCH 267/274] Update eip-5585.md (#6364)

to remain consistent with uint256 in the rest of the specification, the "uint expires" could become uint256. It could also be uint64, as in the EIP 4907 perhaps.
---
 EIPS/eip-5585.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5585.md b/EIPS/eip-5585.md
index 64984b2120c0d0..bb945e4789cfcf 100644
--- a/EIPS/eip-5585.md
+++ b/EIPS/eip-5585.md
@@ -33,7 +33,7 @@ interface IERC5585 {
     struct UserRecord {
         address user;
         string[] rights;
-        uint expires
+        uint256 expires
     }
 
     /// @notice Get all available rights of this NFT project

From f041acfe218717821f31ccf0bd029d0fe735bbc3 Mon Sep 17 00:00:00 2001
From: Suning Yao <sy2940@nyu.edu>
Date: Wed, 8 Feb 2023 09:05:52 -0500
Subject: [PATCH 268/274] Update EIP-6150: Move to Final (#6461)

---
 EIPS/eip-6150.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/EIPS/eip-6150.md b/EIPS/eip-6150.md
index f88da482e745ac..32fd6f19a69fa8 100644
--- a/EIPS/eip-6150.md
+++ b/EIPS/eip-6150.md
@@ -4,8 +4,7 @@ title: Hierarchical NFTs
 description: Hierarchical NFTs, an extension to EIP-721.
 author: Keegan Lee (@keeganlee), msfew <msfew@hyperoracle.io>, Kartin <kartin@hyperoracle.io>, qizhou (@qizhou)
 discussions-to: https://ethereum-magicians.org/t/eip-6150-hierarchical-nfts-an-extension-to-erc-721/12173
-status: Last Call
-last-call-deadline: 2023-01-25
+status: Final
 type: Standards Track
 category: ERC
 created: 2022-12-15

From 516e62eae88c9a3f924179267e1e1b254c935244 Mon Sep 17 00:00:00 2001
From: Qi Zhou <qizhou@quarkchain.org>
Date: Wed, 8 Feb 2023 09:12:32 -0500
Subject: [PATCH 269/274] Update EIP-5018: Move to Review (#6443)

* Update eip-5018.md

* Update eip-5018.md

* Update eip-5018.md

* Update eip-5018.md
---
 EIPS/eip-5018.md | 30 ++++++++++++++++--------------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/EIPS/eip-5018.md b/EIPS/eip-5018.md
index 8ea13dbc6b9f61..8f1bc96acc30e5 100644
--- a/EIPS/eip-5018.md
+++ b/EIPS/eip-5018.md
@@ -1,10 +1,10 @@
 ---
 eip: 5018
-title: Filesystem-like Interface for Smart Contracts
+title: Filesystem-like Interface for Contracts
 description: An interface to provide access to binary objects similar to filesystems.
 author: Qi Zhou (@qizhou)
 discussions-to: https://ethereum-magicians.org/t/eip-5018-directory-standard/8958
-status: Stagnant
+status: Review
 type: Standards Track
 category: ERC
 created: 2022-04-18
@@ -28,7 +28,7 @@ With [EIP-4804](./eip-4804.md), we are able to locate a Web3 resource on blockch
 
 #### Methods
 
-#### write
+##### write
 
 Writes binary `data` to the file `name` in the directory by an account with write permission.
 
@@ -36,7 +36,7 @@ Writes binary `data` to the file `name` in the directory by an account with writ
 function write(bytes memory name, bytes memory data) external payable
 ```
 
-#### read
+##### read
 
 Returns the binary `data` from the file `name` in the directory and existence of the file.
 
@@ -44,7 +44,7 @@ Returns the binary `data` from the file `name` in the directory and existence of
 function read(bytes memory name) external view returns (bytes memory data, bool exist)
 ```
 
-#### fallback read
+##### fallback read
 
 Returns the binary `data` from the file `prefixedName` (prefixed with `/`) in the directory.
 
@@ -52,7 +52,7 @@ Returns the binary `data` from the file `prefixedName` (prefixed with `/`) in th
 fallback(bytes calldata prefixedName) external returns (bytes memory data) 
 ```
 
-#### size
+##### size
 
 Returns the size of the `data` from the file `name` in the directory and the number of chunks of the data.
 
@@ -60,7 +60,7 @@ Returns the size of the `data` from the file `name` in the directory and the num
 function size(bytes memory name) external view returns (uint256 size, uint256 chunks)
 ```
 
-#### remove
+##### remove
 
 Removes the file `name` in the directory and returns the number of chunks removed (0 means the file does not exist) by an account with write permission.
 
@@ -68,7 +68,7 @@ Removes the file `name` in the directory and returns the number of chunks remove
 function remove(bytes memory name) external returns (uint256 numOfChunksRemoved)
 ```
 
-#### countChunks
+##### countChunks
 
 Returns the number of chunks of the file `name`.
 
@@ -76,7 +76,7 @@ Returns the number of chunks of the file `name`.
 function countChunks(bytes memory name) external view returns (uint256 numOfChunks);
 ```
 
-#### writeChunk
+##### writeChunk
 
 Writes a chunk of data to the file by an account with write permission. The write will fail if `chunkId > numOfChunks`, i.e., the write must append the file or replace the existing chunk.
 
@@ -84,7 +84,7 @@ Writes a chunk of data to the file by an account with write permission. The writ
  function writeChunk(bytes memory name, uint256 chunkId, bytes memory chunkData) external payable;
 ```
 
-#### readChunk
+##### readChunk
 
 Returns the chunk data of the file `name` and the existence of the chunk.
 
@@ -92,7 +92,7 @@ Returns the chunk data of the file `name` and the existence of the chunk.
 function readChunk(bytes memory name, uint256 chunkId) external view returns (bytes memory chunkData, bool exist);
 ```
 
-#### chunkSize
+##### chunkSize
 
 Returns the size of a chunk of the file `name` and the existence of the chunk.
 
@@ -100,7 +100,7 @@ Returns the size of a chunk of the file `name` and the existence of the chunk.
 function chunkSize(bytes memory name, uint256 chunkId) external view returns (uint256 chunkSize, bool exist);
 ```
 
-#### removeChunk
+##### removeChunk
 
 Removes a chunk of the file `name` and returns `false` if such chunk does not exist. The method should be called by an account with write permission.
 
@@ -108,7 +108,7 @@ Removes a chunk of the file `name` and returns `false` if such chunk does not ex
 function removeChunk(bytes memory name, uint256 chunkId) external returns (bool exist);
 ```
 
-#### truncate
+##### truncate
 
 Removes the chunks of the file `name` in the directory from the given `chunkId` and returns the number of chunks removed by an account with write permission. When `chunkId = 0`, the method is essentially the same as `remove()`.
 
@@ -116,9 +116,10 @@ Removes the chunks of the file `name` in the directory from the given `chunkId`
 function truncate(bytes memory name, uint256 chunkId) external returns (uint256 numOfChunksRemoved);
 ```
 
-#### getChunkHash
+##### getChunkHash
 
 Returns the hash value of the chunk data.
+
 ```
 function getChunkHash(bytes memory name, uint256 chunkId) external view returns (bytes32);
 ```
@@ -143,6 +144,7 @@ One issue of uploading the web contents to the blockchain is that the web conten
 With `writeChunk` method, we allow writing a file with external data that exceeds the current calldata limit (e.g., 1.8MB now), and it is able to read the whole file in a single `read` method (which is friendly for large web objects such as HTML/SVG/PNG/JPG, etc).
 
 For `write` method, calling a `write` method will replace all data chunks of the file with `write` method data, and one implementation can be:
+
 1. `writeChunk(filename, chunkId=0, data_from_write)` to chunk 0 with the same `write` method data; and
 2. `truncate(filename, chunkId=1)`, which will remove the rest chunks.
 

From 553b463e877a5aef3eb9ba7b6605b93718e943ae Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 8 Feb 2023 10:00:57 -0500
Subject: [PATCH 270/274] Update EIP-6189: Move to Review (#6375)

---
 EIPS/eip-6189.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6189.md b/EIPS/eip-6189.md
index 8608ead4dd637e..4f9414edbf81a0 100644
--- a/EIPS/eip-6189.md
+++ b/EIPS/eip-6189.md
@@ -4,7 +4,7 @@ title: Alias Contracts
 description: Allows the creation of contracts that forward calls to other contracts
 author: Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/eip-6190-functional-selfdestruct/12232
-status: Draft
+status: Review
 type: Standards Track
 category: Core
 created: 2022-12-20

From a618ff2014378dc036781cb7ebccd9d3562e0cc0 Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 8 Feb 2023 10:09:16 -0500
Subject: [PATCH 271/274] Update EIP-6190: Move to Review (#6376)

---
 EIPS/eip-6190.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-6190.md b/EIPS/eip-6190.md
index 5407aa6991448b..61f31f4ecbf518 100644
--- a/EIPS/eip-6190.md
+++ b/EIPS/eip-6190.md
@@ -4,7 +4,7 @@ title: Verkle-compatible SELFDESTRUCT
 description: Changes SELFDESTRUCT to only cause a finite number of state changes
 author: Pandapip1 (@Pandapip1)
 discussions-to: https://ethereum-magicians.org/t/eip-6190-functional-selfdestruct/12232
-status: Draft
+status: Review
 type: Standards Track
 category: Core
 created: 2022-12-20

From fb69e4727e4c838cba8752c1669ccb93cd104e31 Mon Sep 17 00:00:00 2001
From: Etan Kissling <etan@status.im>
Date: Wed, 8 Feb 2023 18:22:30 +0100
Subject: [PATCH 272/274] Add EIP-6465: SSZ withdrawals root (#6465)

* Add EIP: SSZ withdrawals root

* Update spec reference to Capella

* rm transactions reference
---
 EIPS/eip-6465.md | 121 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 121 insertions(+)
 create mode 100644 EIPS/eip-6465.md

diff --git a/EIPS/eip-6465.md b/EIPS/eip-6465.md
new file mode 100644
index 00000000000000..51ff12f3199111
--- /dev/null
+++ b/EIPS/eip-6465.md
@@ -0,0 +1,121 @@
+---
+eip: 6465
+title: SSZ withdrawals root
+description: Migration of withdrawals MPT commitment to SSZ
+author: Etan Kissling (@etan-status)
+discussions-to: https://ethereum-magicians.org/t/eip-6465-ssz-withdrawals-root/12883
+status: Draft
+type: Standards Track
+category: Core
+created: 2023-02-08
+requires: 4895
+---
+
+## Abstract
+
+This EIP defines a migration process of the existing Merkle-Patricia Trie (MPT) commitment for withdrawals to SSZ.
+
+## Motivation
+
+While the consensus `ExecutionPayloadHeader` and the execution block header map to each other conceptually, they are encoded differently. This EIP aims to align the encoding of the `withdrawals_root`, taking advantage of the more modern SSZ format. This brings several advantages:
+
+1. **Reducing complexity:** Merkle-Patricia Tries (MPT) are hard to work with. Replacing them with SSZ leaves only the state trie in the legacy MPT format.
+
+2. **Better for smart contracts:** The SSZ format is optimized for production and verification of merkle proofs. It allows proving specific fields of containers and allows chunked processing.
+
+3. **Better for light clients:** Light clients with access to the consensus `ExecutionPayload` no longer need to obtain the matching execution block header to verify proofs rooted in `withdrawals_root`.
+
+4. **Reducing ambiguity:** The name `withdrawals_root` is currently used to refer to different roots. The execution block header refers to a MPT root, the consensus `ExecutionPayloadHeader` refers to a SSZ root.
+
+## Specification
+
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119 and RFC 8174.
+
+### Execution block header changes
+
+The existing consensus [`Withdrawal`](https://github.com/ethereum/consensus-specs/blob/67c2f9ee9eb562f7cc02b2ff90d92c56137944e1/specs/capella/beacon-chain.md#withdrawal) SSZ container is used to represent withdrawals.
+
+```python
+class Withdrawal(Container):
+    index: WithdrawalIndex
+    validator_index: ValidatorIndex
+    address: ExecutionAddress
+    amount: Gwei
+```
+
+The execution block header's `withdrawals-root` is updated to match the consensus [`ExecutionPayloadHeader.withdrawals_root`](https://github.com/ethereum/consensus-specs/blob/67c2f9ee9eb562f7cc02b2ff90d92c56137944e1/specs/capella/beacon-chain.md#executionpayloadheader).
+
+| Name | Value | Description |
+| - | - | - |
+| [`MAX_WITHDRAWALS_PER_PAYLOAD`](https://github.com/ethereum/consensus-specs/blob/67c2f9ee9eb562f7cc02b2ff90d92c56137944e1/specs/capella/beacon-chain.md#execution) | `uint64(2**4)` (= 16) | Maximum amount of withdrawals allowed in each block |
+
+```python
+block_header.withdrawals_root == hash_tree_root(List[Withdrawal, MAX_WITHDRAWALS_PER_PAYLOAD](
+    withdrawal_0,
+    withdrawal_1,
+    withdrawal_2,
+    ...
+))
+```
+
+### Helpers
+
+```python
+def encode_withdrawal(withdrawal: Withdrawal) -> bytes:
+    schema = (
+        (big_endian_int, withdrawal.index),
+        (big_endian_int, withdrawal.validator_index),
+        (Binary[20, 20], withdrawal.address),
+        (big_endian_int, withdrawal.amount),
+    )
+    sedes = List([schema for schema, _ in schema])
+    values = [value for _, value in schema]
+    return rlp.encode(values, sedes)
+```
+
+```python
+def decode_withdrawal(encoded_withdrawal: bytes) -> Withdrawal:
+    class RLPWithdrawal(rlp.Serializable):
+        fields = (
+            ('index', bid_endian_int),
+            ('validator_index', big_endian_int),
+            ('address', Binary[20, 20]),
+            ('amount', big_endian_int),
+        )
+    pre = RLPWithdrawal.deserialize(encoded_withdrawal)
+
+    return Withdrawal(
+        index=pre.index,
+        validator_index=pre.validator_index,
+        address=pre.address,
+        amount=pre.amount,
+    )
+```
+
+## Rationale
+
+This change was originally a candidate for inclusion in Shanghai, but was postponed to accelerate the rollout of withdrawals.
+
+## Backwards Compatibility
+
+Applications that solely rely on the `Withdrawal` RLP encoding but do not rely on the `withdrawals_root` in the block header can still be used through a re-encoding proxy.
+
+Applications that rely on the replaced `withdrawals_root` in the block header can no longer find that information.
+
+Withdrawals were only just recently introduced as part of [EIP-4895](./eip-4895.md) (Shanghai). It is not expected that major applications already rely on the Merkle-Patricia Trie commitment for withdrawals.
+
+## Test Cases
+
+TBD
+
+## Reference Implementation
+
+TBD
+
+## Security Considerations
+
+None
+
+## Copyright
+
+Copyright and related rights waived via [CC0](../LICENSE.md).

From eaf77dad7becbb7e111ac1ce46c2002d2df3820d Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 8 Feb 2023 13:26:25 -0500
Subject: [PATCH 273/274] CI: Upgrade EIP-Bot to eip-review-bot (#5508)

* Use eipm

* EIP editors config file

* Remove unneccesary checkout action

* Remove setup nodejs env

* New name

* Remove lightclient as ERC editor

Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>

* Fix minor change

---------

Co-authored-by: lightclient <14004106+lightclient@users.noreply.github.com>
---
 .github/workflows/auto-review-bot.yml | 25 +++---------------
 config/eip-editors.yml                | 37 +++++++++++++++++++++++++++
 2 files changed, 41 insertions(+), 21 deletions(-)
 create mode 100644 config/eip-editors.yml

diff --git a/.github/workflows/auto-review-bot.yml b/.github/workflows/auto-review-bot.yml
index bf61f95135a695..58b011066e9460 100644
--- a/.github/workflows/auto-review-bot.yml
+++ b/.github/workflows/auto-review-bot.yml
@@ -22,30 +22,13 @@ jobs:
         id: save-pr-number
         run: echo "pr=$(cat pr-number.txt)" >> $GITHUB_OUTPUT
 
-      - name: Checkout
-        uses: actions/checkout@2541b1294d2704b0964813337f33b291d3f8596b
-        with:
-          repository: ethereum/EIPs # Default, but best to be explicit here
-          ref: master
-
-      - name: Setup Node.js Environment
-        uses: actions/setup-node@2fddd8803e2f5c9604345a0b591c3020ee971a93
-        with:
-          node-version: 16
-
       - name: Auto Review Bot
         id: auto-review-bot
-        uses: ethereum/EIP-Bot@b81356bd8302a99e2d2bcf2bb5d2d983a12f7b8d
+        uses: Pandapip1/eip-review-bot@dist
         with:
-          GITHUB-TOKEN: ${{ secrets.TOKEN }}
-          PR_NUMBER: ${{ steps.save-pr-number.outputs.pr }}
-          CORE_EDITORS: '@lightclient,@axic,@gcolvin,@SamWilsn,@Pandapip1'
-          ERC_EDITORS: '@axic,@SamWilsn,@Pandapip1'
-          NETWORKING_EDITORS: '@lightclient,@axic,@SamWilsn'
-          INTERFACE_EDITORS: '@lightclient,@axic,@SamWilsn,@Pandapip1'
-          META_EDITORS: '@lightclient,@axic,@gcolvin,@SamWilsn,@Pandapip1'
-          INFORMATIONAL_EDITORS: '@lightclient,@axic,@gcolvin,@SamWilsn,@Pandapip1'
-          MAINTAINERS: '@alita-moore,@mryalamanchi'
+          token: ${{ secrets.TOKEN }}
+          config: config/eip-editors.yml
+          pr_number: ${{ steps.save-pr-number.outputs.pr }}
 
       - name: Enable Auto-Merge
         uses: reitermarkus/automerge@a25ea0de41019ad13380d22e01db8f5638f1bcdc
diff --git a/config/eip-editors.yml b/config/eip-editors.yml
new file mode 100644
index 00000000000000..76baeb4e9c95b9
--- /dev/null
+++ b/config/eip-editors.yml
@@ -0,0 +1,37 @@
+governance:
+  - lightclient
+  - axic
+  - gcolvin
+  - SamWilsn
+  - Pandapip1
+core:
+  - lightclient
+  - axic
+  - gcolvin
+  - SamWilsn
+  - Pandapip1
+erc:
+  - axic
+  - SamWilsn
+  - Pandapip1
+networking:
+  - lightclient
+  - axic
+  - SamWilsn
+interface:
+  - lightclient
+  - axic
+  - SamWilsn
+  - Pandapip1
+meta:
+  - lightclient
+  - axic
+  - gcolvin
+  - SamWilsn
+  - Pandapip1
+informational:
+  - lightclient
+  - axic
+  - gcolvin
+  - SamWilsn
+  - Pandapip1

From 0ec5d46deb9f2e3b0fa1e25c0b5cc18bcbecb02c Mon Sep 17 00:00:00 2001
From: Pandapip1 <45835846+Pandapip1@users.noreply.github.com>
Date: Wed, 8 Feb 2023 15:48:14 -0500
Subject: [PATCH 274/274] Update EIP-5219: Make small change to test something
 (#6468)

* Update EIP-5219: Make small change to test something

* Retrigger eip-review-bot

* Update eip-5219.md

* Update eip-5219.md

* Fixed the bug

* Update eip-5219.md

* Finally fixed bug
---
 EIPS/eip-5219.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EIPS/eip-5219.md b/EIPS/eip-5219.md
index 4521b6fb9052fa..1845aad71f2208 100644
--- a/EIPS/eip-5219.md
+++ b/EIPS/eip-5219.md
@@ -12,7 +12,7 @@ created: 2022-07-10
 
 ## Abstract
 
-This EIP introduces an interface allowing clients to make resource requests to smart contracts, and to receive HTTP-like responses.
+This EIP standardizes an interface to make resource requests to smart contracts and to receive HTTP-like responses.
 
 ## Motivation