feat: replacement addresses added to BLR

.changeset/eighty-signs-help.md

@@ -0,0 +1,5 @@
+---
+"@hashgraph/asset-tokenization-contracts": major
+---
+
+emegency replacement table added to BLR and resolveResolverProxyCall updated. Proxy storage also updated to fit configuraiton into a single bytes data type. V1 of Proxy Resolver and previous resolverResolverProxyCall method kept for retrocompatibility reasons

docs/ats/api/contracts/domain/orchestrator/ClearingProtectedOps.md

@@ -26,6 +26,20 @@ _The caller must provide and validate deadlines before accepting the signed oper
 | -------- | ------- | ----------------------------------------------- |
 | deadline | uint256 | Expired deadline carried by the signed payload. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/domain/orchestrator/HoldOps.md

@@ -291,6 +291,20 @@ _Replaces assertions for defensive handling of logically impossible states._
 | --------- | ------ | -------------------------------------------------- |
 | \_errorId | bytes4 | Identifier of the unexpected validation condition. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WrongNonce
 
 ```solidity

docs/ats/api/contracts/domain/orchestrator/TokenCoreOps.md

@@ -291,6 +291,20 @@ _Replaces assertions for defensive handling of logically impossible states._
 | --------- | ------ | -------------------------------------------------- |
 | \_errorId | bytes4 | Identifier of the unexpected validation condition. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WrongNonce
 
 ```solidity

docs/ats/api/contracts/facets/IAsset.md

@@ -2139,18 +2139,20 @@ Gets the ids of the clearings for a token holder by partition and clearing opera
 ### getConfigInfo
 
 ```solidity
-function getConfigInfo() external view returns (address resolver_, bytes32 configurationId_, uint256 version_)
+function getConfigInfo() external view returns (address resolver_, bytes8 proxyVersion_, bytes32 configurationId_, uint256 configurationVersion_, bool replacementEnabled_)
 ```
 
 Returns the active resolver address, configuration identifier, and version.
 
 #### Returns
 
-| Name              | Type    | Description                                     |
-| ----------------- | ------- | ----------------------------------------------- |
-| resolver\_        | address | Address of the current Business Logic Resolver. |
-| configurationId\_ | bytes32 | Identifier of the active configuration.         |
-| version\_         | uint256 | Version number of the active configuration.     |
+| Name                   | Type    | Description                                     |
+| ---------------------- | ------- | ----------------------------------------------- |
+| resolver\_             | address | Address of the current Business Logic Resolver. |
+| proxyVersion\_         | bytes8  | proxy version.                                  |
+| configurationId\_      | bytes32 | Identifier of the active configuration.         |
+| configurationVersion\_ | uint256 | Version number of the active configuration.     |
+| replacementEnabled\_   | bool    | Whether replacement is enabled.                 |
 
 ### getControlListCount
 
@@ -8733,21 +8735,36 @@ Updates the arbitrary data stored for an existing proceed recipient.
 | \_proceedRecipient | address | Address of the recipient whose data should be updated. |
 | \_data             | bytes   | New arbitrary data to store for the recipient.         |
 
+### updateReplacementEnabled
+
+```solidity
+function updateReplacementEnabled(bool _newReplacementEnabled) external nonpayable
+```
+
+For the current BLR update its configuration
+
+#### Parameters
+
+| Name                    | Type | Description                           |
+| ----------------------- | ---- | ------------------------------------- |
+| \_newReplacementEnabled | bool | The replacement enabled flag to set\* |
+
 ### updateResolver
 
 ```solidity
-function updateResolver(contract IBusinessLogicResolver _newResolver, bytes32 _newConfigurationId, uint256 _newVersion) external nonpayable
+function updateResolver(contract IBusinessLogicResolver _newResolver, bytes32 _newConfigurationId, uint256 _newVersion, bool _newReplacementEnabled) external nonpayable
 ```
 
 Replaces the Business Logic Resolver with a new one, setting configuration and version.
 
 #### Parameters
 
-| Name                 | Type                            | Description                                                   |
-| -------------------- | ------------------------------- | ------------------------------------------------------------- |
-| \_newResolver        | contract IBusinessLogicResolver | The new BLR contract address to wire into the proxy.          |
-| \_newConfigurationId | bytes32                         | The configuration identifier to activate on the new resolver. |
-| \_newVersion         | uint256                         | The version number associated with the new configuration.     |
+| Name                    | Type                            | Description                                                   |
+| ----------------------- | ------------------------------- | ------------------------------------------------------------- |
+| \_newResolver           | contract IBusinessLogicResolver | The new BLR contract address to wire into the proxy.          |
+| \_newConfigurationId    | bytes32                         | The configuration identifier to activate on the new resolver. |
+| \_newVersion            | uint256                         | The version number associated with the new configuration.     |
+| \_newReplacementEnabled | bool                            | The replacement enabled flag to set.                          |
 
 ### version
 

docs/ats/api/contracts/facets/accessControl/AccessControl.md

@@ -425,6 +425,20 @@ Thrown when the `roles` and `actives` arrays passed to `applyRoles` differ in le
 | rolesLength   | uint256 | Length of the roles array.   |
 | activesLength | uint256 | Length of the actives array. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/accessControl/AccessControlFacet.md

@@ -482,6 +482,20 @@ Thrown when the `roles` and `actives` arrays passed to `applyRoles` differ in le
 | rolesLength   | uint256 | Length of the roles array.   |
 | activesLength | uint256 | Length of the actives array. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/accessControl/AccessControlOperational.md

@@ -440,6 +440,20 @@ Thrown when the `roles` and `actives` arrays passed to `applyRoles` differ in le
 | rolesLength   | uint256 | Length of the roles array.   |
 | activesLength | uint256 | Length of the actives array. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/adjustBalances/AdjustBalances.md

@@ -184,6 +184,20 @@ error TotalSupplyOverflow()
 
 Reverts when the proposed factor would overflow the projected total supply.
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/adjustBalances/AdjustBalancesFacet.md

@@ -226,6 +226,20 @@ error TotalSupplyOverflow()
 
 Reverts when the proposed factor would overflow the projected total supply.
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/allowance/Allowance.md

@@ -238,6 +238,20 @@ error SpenderWithZeroAddress()
 
 Reverts when the zero address is supplied as `spender` in an allowance update.
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/allowance/AllowanceFacet.md

@@ -278,6 +278,20 @@ error SpenderWithZeroAddress()
 
 Reverts when the zero address is supplied as `spender` in an allowance update.
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/amortization/Amortization.md

@@ -726,6 +726,20 @@ _Replaces assertions for defensive handling of logically impossible states._
 | --------- | ------ | -------------------------------------------------- |
 | \_errorId | bytes4 | Identifier of the unexpected validation condition. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/amortization/AmortizationFacet.md

@@ -768,6 +768,20 @@ _Replaces assertions for defensive handling of logically impossible states._
 | --------- | ------ | -------------------------------------------------- |
 | \_errorId | bytes4 | Identifier of the unexpected validation condition. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/balanceTracker/BalanceTracker.md

@@ -124,6 +124,20 @@ Raised when an initialiser tries to register a facet that already has a non-zero
 | facetId     | bytes32 | Identifier of the offending facet.                             |
 | lastVersion | uint256 | Last version recorded for that facet at the time of the check. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/balanceTracker/BalanceTrackerFacet.md

@@ -166,6 +166,20 @@ Raised when an initialiser tries to register a facet that already has a non-zero
 | facetId     | bytes32 | Identifier of the offending facet.                             |
 | lastVersion | uint256 | Last version recorded for that facet at the time of the check. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity

docs/ats/api/contracts/facets/balanceTrackerAdjusted/BalanceTrackerAdjusted.md

@@ -85,6 +85,20 @@ Raised when an initialiser tries to register a facet that already has a non-zero
 | facetId     | bytes32 | Identifier of the offending facet.                             |
 | lastVersion | uint256 | Last version recorded for that facet at the time of the check. |
 
+### UnrecognizedResolverProxyVersion
+
+```solidity
+error UnrecognizedResolverProxyVersion(bytes8 _resolverProxyVersion)
+```
+
+Thrown when the provided proxy version does not match any BLR compatible standard.
+
+#### Parameters
+
+| Name                   | Type   | Description                                        |
+| ---------------------- | ------ | -------------------------------------------------- |
+| \_resolverProxyVersion | bytes8 | proxy version that is not compatible with the BLR. |
+
 ### WalletRecovered
 
 ```solidity