afp-sdk 0.4.0__py3-none-any.whl → 0.5.1__py3-none-any.whl

afp/api/{builder.py → product.py}

@@ -1,44 +1,40 @@
+import warnings
 from datetime import datetime
 from decimal import Decimal
-from typing import cast
+from typing import Any, cast
 
 from eth_typing.evm import ChecksumAddress
 from hexbytes import HexBytes
 from web3 import Web3
 
-from .. import config, signing, validators
+from .. import constants, hashing, validators
 from ..bindings import (
+    ClearingDiamond,
     OracleSpecification,
-    Product,
+    Product as OnChainProduct,
     ProductMetadata,
     ProductRegistry,
 )
 from ..bindings.erc20 import ERC20
+from ..bindings.facade import CLEARING_DIAMOND_ABI
 from ..bindings.product_registry import ABI as PRODUCT_REGISTRY_ABI
 from ..decorators import convert_web3_error
 from ..exceptions import NotFoundError
-from ..schemas import ProductSpecification
+from ..schemas import ProductSpecification, Transaction
 from .base import ClearingSystemAPI
 
 
-class Builder(ClearingSystemAPI):
-    """API for building and submitting new products.
+class Product(ClearingSystemAPI):
+    """API for managing products."""
 
-    Parameters
-    ----------
-    private_key : str
-        The private key of the blockchain account that submits the product.
-    autonity_rpc_url : str
-        The URL of a JSON-RPC provider for Autonity. (HTTPS only.)
-    """
+    ### Factories ###
 
     @convert_web3_error()
-    def create_product(
+    def create(
         self,
         *,
         symbol: str,
         description: str,
-        oracle_address: str,
         fsv_decimals: int,
         fsp_alpha: Decimal,
         fsp_beta: Decimal,
@@ -53,6 +49,7 @@ class Builder(ClearingSystemAPI):
         auction_bounty: Decimal,
         tradeout_interval: int,
         extended_metadata: str,
+        oracle_address: str | None = None,
     ) -> ProductSpecification:
         """Creates a product specification with the given product data.
 
@@ -63,7 +60,6 @@ class Builder(ClearingSystemAPI):
         ----------
         symbol : str
         description : str
-        oracle_address: str
         fsv_decimals: int
         fsp_alpha: Decimal
         fsp_beta: int
@@ -78,25 +74,30 @@ class Builder(ClearingSystemAPI):
         auction_bounty : Decimal
         tradeout_interval : int
         extended_metadata : str
+        oracle_address: str, optional
 
         Returns
         -------
         afp.schemas.ProductSpecification
         """
-        product_id = Web3.to_hex(signing.generate_product_id(self._account, symbol))
+        if oracle_address is None:
+            oracle_address = self._config.oracle_provider_address
 
-        erc20_contract = ERC20(self._w3, Web3.to_checksum_address(collateral_asset))
-        price_quotation = erc20_contract.symbol()
-
-        if not price_quotation:
+        if len(self._w3.eth.get_code(Web3.to_checksum_address(collateral_asset))) == 0:
             raise NotFoundError(f"No ERC20 token found at address {collateral_asset}")
-
         if len(self._w3.eth.get_code(Web3.to_checksum_address(oracle_address))) == 0:
             raise NotFoundError(f"No contract found at oracle address {oracle_address}")
 
+        erc20_contract = ERC20(self._w3, Web3.to_checksum_address(collateral_asset))
+        price_quotation = erc20_contract.symbol()
+
+        product_id = Web3.to_hex(
+            hashing.generate_product_id(self._authenticator.address, symbol)
+        )
+
         return ProductSpecification(
             id=product_id,
-            builder_id=self._account.address,
+            builder_id=self._authenticator.address,
             symbol=symbol,
             description=description,
             oracle_address=oracle_address,
@@ -117,33 +118,89 @@ class Builder(ClearingSystemAPI):
             extended_metadata=extended_metadata,
         )
 
+    def create_product(self, **kwargs: Any) -> ProductSpecification:
+        """Deprecated alias of `Product.create`."""
+        warnings.warn(
+            "Product.create_product() is deprecated. Use Product.create() instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.create(**kwargs)
+
+    ### Transactions ###
+
     @convert_web3_error(PRODUCT_REGISTRY_ABI)
-    def register_product(self, product: ProductSpecification) -> str:
+    def register(self, product_specification: ProductSpecification) -> Transaction:
         """Submits a product specification to the clearing system.
 
         Parameters
         ----------
-        product : afp.schemas.ProductSpecification
+        product_specification : afp.schemas.ProductSpecification
 
         Returns
         -------
-        str
-            The hash of the transaction.
+        afp.schemas.Transaction
+            Transaction parameters.
         """
         erc20_contract = ERC20(
-            self._w3, cast(ChecksumAddress, product.collateral_asset)
+            self._w3, cast(ChecksumAddress, product_specification.collateral_asset)
         )
         decimals = erc20_contract.decimals()
 
-        product_registry_contract = ProductRegistry(self._w3)
-        tx_hash = product_registry_contract.register(
-            self._convert_product_specification(product, decimals)
-        ).transact()
-        self._w3.eth.wait_for_transaction_receipt(tx_hash)
-        return Web3.to_hex(tx_hash)
+        product_registry_contract = ProductRegistry(
+            self._w3, self._config.product_registry_address
+        )
+        return self._transact(
+            product_registry_contract.register(
+                self._convert_product_specification(product_specification, decimals)
+            )
+        )
+
+    def register_product(self, product: ProductSpecification) -> Transaction:
+        """Deprecated alias of `Product.register`."""
+        warnings.warn(
+            "Product.register_product() is deprecated. Use Product.register() instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.register(product)
+
+    @convert_web3_error(CLEARING_DIAMOND_ABI)
+    def initiate_final_settlement(
+        self, product_id: str, accounts: list[str]
+    ) -> Transaction:
+        """Initiate final settlement (closeout) process for the specified accounts.
+
+        The product must be in Final Settlement state. The accounts must hold non-zero
+        positions in the product that offset each other (i.e. the sum of their position
+        sizes is 0.)
+
+        Parameters
+        ----------
+        product_id : str
+            The ID of the product.
+        accounts : list of str
+            List of margin account IDs to initiate settlement for.
+
+        Returns
+        -------
+        afp.schemas.Transaction
+            Transaction parameters.
+        """
+        product_id = validators.validate_hexstr32(product_id)
+        addresses = [validators.validate_address(account) for account in accounts]
+
+        clearing_contract = ClearingDiamond(
+            self._w3, self._config.clearing_diamond_address
+        )
+        return self._transact(
+            clearing_contract.initiate_final_settlement(HexBytes(product_id), addresses)
+        )
+
+    ### Views ###
 
     @convert_web3_error(PRODUCT_REGISTRY_ABI)
-    def product_state(self, product_id: str) -> str:
+    def state(self, product_id: str) -> str:
         """Returns the current state of a product.
 
         Parameters
@@ -156,15 +213,52 @@ class Builder(ClearingSystemAPI):
         str
         """
         product_id = validators.validate_hexstr32(product_id)
-        product_registry_contract = ProductRegistry(self._w3)
+        product_registry_contract = ProductRegistry(
+            self._w3, self._config.product_registry_address
+        )
         state = product_registry_contract.state(HexBytes(product_id))
         return state.name
 
+    def product_state(self, product_id: str) -> str:
+        """Deprecated alias of `Product.state`."""
+        warnings.warn(
+            "Product.product_state() is deprecated. Use Product.state() instead.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        return self.state(product_id)
+
+    @convert_web3_error(PRODUCT_REGISTRY_ABI)
+    def collateral_asset(self, product_id: str) -> str:
+        """Returns the collateral asset of a product.
+
+        Parameters
+        ----------
+        product_id : str
+            The ID of the product.
+
+        Returns
+        -------
+        str
+        """
+        product_id = validators.validate_hexstr32(product_id)
+        product_registry_contract = ProductRegistry(
+            self._w3, self._config.product_registry_address
+        )
+        collateral_asset = product_registry_contract.collateral_asset(
+            HexBytes(product_id)
+        )
+        if Web3.to_int(hexstr=collateral_asset) == 0:
+            raise NotFoundError("Product not found in the product registry")
+        return collateral_asset
+
+    ### Internal helpers ###
+
     @staticmethod
     def _convert_product_specification(
         product: ProductSpecification, decimals: int
-    ) -> Product:
-        return Product(
+    ) -> OnChainProduct:
+        return OnChainProduct(
             metadata=ProductMetadata(
                 builder=cast(ChecksumAddress, product.builder_id),
                 symbol=product.symbol,
@@ -173,7 +267,7 @@ class Builder(ClearingSystemAPI):
             oracle_spec=OracleSpecification(
                 oracle_address=cast(ChecksumAddress, product.oracle_address),
                 fsv_decimals=product.fsv_decimals,
-                fsp_alpha=int(product.fsp_alpha * config.FULL_PRECISION_MULTIPLIER),
+                fsp_alpha=int(product.fsp_alpha * constants.FULL_PRECISION_MULTIPLIER),
                 fsp_beta=int(product.fsp_beta * 10**product.fsv_decimals),
                 fsv_calldata=HexBytes(product.fsv_calldata),
             ),
@@ -186,12 +280,12 @@ class Builder(ClearingSystemAPI):
             tick_size=product.tick_size,
             unit_value=int(product.unit_value * 10**decimals),
             initial_margin_requirement=int(
-                product.initial_margin_requirement * config.RATE_MULTIPLIER
+                product.initial_margin_requirement * constants.RATE_MULTIPLIER
             ),
             maintenance_margin_requirement=int(
-                product.maintenance_margin_requirement * config.RATE_MULTIPLIER
+                product.maintenance_margin_requirement * constants.RATE_MULTIPLIER
             ),
-            auction_bounty=int(product.auction_bounty * config.RATE_MULTIPLIER),
+            auction_bounty=int(product.auction_bounty * constants.RATE_MULTIPLIER),
             tradeout_interval=product.tradeout_interval,
             extended_metadata=product.extended_metadata,
         )

afp/api/trading.py

@@ -5,7 +5,7 @@ from typing import Generator
 
 from web3 import Web3
 
-from .. import signing, validators
+from .. import hashing, validators
 from ..decorators import refresh_token_on_expiry
 from ..enums import OrderType
 from ..schemas import (
@@ -25,20 +25,7 @@ from .base import ExchangeAPI
 
 
 class Trading(ExchangeAPI):
-    """API for trading in the AutEx exchange.
-
-    Authenticates with the exchange on creation.
-
-    Parameters
-    ----------
-    private_key : str
-        The private key of the account that submits intents to the exchange.
-
-    Raises
-    ------
-    afp.exceptions.AuthenticationError
-        If the exchange rejects the login attempt.
-    """
+    """API for trading in the AutEx exchange."""
 
     @staticmethod
     def _generate_nonce() -> int:
@@ -89,7 +76,7 @@ class Trading(ExchangeAPI):
         margin_account_id = (
             validators.validate_address(margin_account_id)
             if margin_account_id is not None
-            else self._account.address
+            else self._authenticator.address
         )
 
         intent_data = IntentData(
@@ -104,17 +91,17 @@ class Trading(ExchangeAPI):
             good_until_time=good_until_time,
             nonce=self._generate_nonce(),
         )
-        intent_hash = signing.generate_intent_hash(
+        intent_hash = hashing.generate_intent_hash(
             intent_data=intent_data,
             margin_account_id=margin_account_id,
-            intent_account_id=self._account.address,
+            intent_account_id=self._authenticator.address,
             tick_size=product.tick_size,
         )
-        signature = signing.sign_message(self._account, intent_hash)
+        signature = self._authenticator.sign_message(intent_hash)
         return Intent(
             hash=Web3.to_hex(intent_hash),
             margin_account_id=margin_account_id,
-            intent_account_id=self._account.address,
+            intent_account_id=self._authenticator.address,
             signature=Web3.to_hex(signature),
             data=intent_data,
         )
@@ -160,12 +147,12 @@ class Trading(ExchangeAPI):
             If the exchange rejects the cancellation.
         """
         nonce = self._generate_nonce()
-        cancellation_hash = signing.generate_order_cancellation_hash(nonce, intent_hash)
-        signature = signing.sign_message(self._account, cancellation_hash)
+        cancellation_hash = hashing.generate_order_cancellation_hash(nonce, intent_hash)
+        signature = self._authenticator.sign_message(cancellation_hash)
         cancellation_data = OrderCancellationData(
             intent_hash=intent_hash,
             nonce=nonce,
-            intent_account_id=self._account.address,
+            intent_account_id=self._authenticator.address,
             signature=Web3.to_hex(signature),
         )
         submission = OrderSubmission(
@@ -174,7 +161,6 @@ class Trading(ExchangeAPI):
         )
         return self._exchange.submit_order(submission)
 
-    @refresh_token_on_expiry
     def products(self) -> list[ExchangeProduct]:
         """Retrieves the products approved for trading on the exchange.
 
@@ -184,7 +170,6 @@ class Trading(ExchangeAPI):
         """
         return self._exchange.get_approved_products()
 
-    @refresh_token_on_expiry
     def product(self, product_id: str) -> ExchangeProduct:
         """Retrieves a product for trading by its ID.
 
@@ -266,7 +251,7 @@ class Trading(ExchangeAPI):
         list of afp.schemas.OrderFill
         """
         filter = OrderFillFilter(
-            intent_account_id=self._account.address,
+            intent_account_id=self._authenticator.address,
             product_id=product_id,
             margin_account_id=margin_account_id,
             intent_hash=intent_hash,
@@ -302,7 +287,7 @@ class Trading(ExchangeAPI):
         afp.schemas.OrderFill
         """
         filter = OrderFillFilter(
-            intent_account_id=self._account.address,
+            intent_account_id=self._authenticator.address,
             product_id=product_id,
             margin_account_id=margin_account_id,
             intent_hash=intent_hash,
@@ -312,7 +297,6 @@ class Trading(ExchangeAPI):
         )
         yield from self._exchange.iter_order_fills(filter)
 
-    @refresh_token_on_expiry
     def market_depth(self, product_id: str) -> MarketDepthData:
         """Retrieves the depth of market for the given product.
 
@@ -332,7 +316,6 @@ class Trading(ExchangeAPI):
         value = validators.validate_hexstr32(product_id)
         return self._exchange.get_market_depth_data(value)
 
-    @refresh_token_on_expiry
     def iter_market_depth(
         self, product_id: str
     ) -> Generator[MarketDepthData, None, None]:

afp/auth.py

@@ -0,0 +1,66 @@
+import json
+import os
+from typing import Protocol, cast
+
+from eth_account.account import Account
+from eth_account.datastructures import SignedTransaction
+from eth_account.messages import encode_defunct
+from eth_account.signers.local import LocalAccount
+from eth_account.types import TransactionDictType
+from eth_typing.evm import ChecksumAddress
+from hexbytes import HexBytes
+from web3.types import TxParams
+
+
+class Authenticator(Protocol):
+    address: ChecksumAddress
+
+    def sign_message(self, message: bytes) -> HexBytes: ...
+
+    def sign_transaction(self, params: TxParams) -> SignedTransaction: ...
+
+
+class PrivateKeyAuthenticator(Authenticator):
+    """Authenticates with a private key specified in a constructor argument.
+
+    Parameters
+    ----------
+    private_key: str
+        The private key of a blockchain account.
+    """
+
+    _account: LocalAccount
+
+    def __init__(self, private_key: str) -> None:
+        self._account = Account.from_key(private_key)
+        self.address = self._account.address
+
+    def sign_message(self, message: bytes) -> HexBytes:
+        eip191_message = encode_defunct(message)
+        signed_message = self._account.sign_message(eip191_message)
+        return signed_message.signature
+
+    def sign_transaction(self, params: TxParams) -> SignedTransaction:
+        return self._account.sign_transaction(cast(TransactionDictType, params))
+
+    def __repr__(self):
+        return f"{self.__class__.__name__}(address='{self.address}')"
+
+
+class KeyfileAuthenticator(PrivateKeyAuthenticator):
+    """Authenticates with a private key read from an encrypted keyfile.
+
+    Parameters
+    ----------
+    key_file : str
+        The path to the keyfile.
+    password : str
+        The password for decrypting the keyfile.
+    """
+
+    def __init__(self, key_file: str, password: str) -> None:
+        with open(os.path.expanduser(key_file), encoding="utf8") as f:
+            key_data = json.load(f)
+
+        private_key = Account.decrypt(key_data, password=password)
+        super().__init__(private_key.to_0x_hex())

afp/bindings/facade.py

@@ -1,8 +1,9 @@
 from itertools import chain
 
+from eth_typing.evm import ChecksumAddress
+
 from web3 import Web3
 
-from .. import config
 from . import (
     auctioneer_facet,
     bankruptcy_facet,
@@ -14,6 +15,7 @@ from . import (
     product_registry,
     system_viewer,
 )
+from ..constants import defaults
 
 # In order to include a facet in the ClearingDiamond facade:
 # 1. Add its ABI to CLEARING_DIAMOND_ABI
@@ -46,10 +48,10 @@ class ClearingDiamond(
     w3 : web3.Web3
     """
 
-    def __init__(self, w3: Web3):
-        self._contract = w3.eth.contract(
-            address=config.CLEARING_DIAMOND_ADDRESS, abi=CLEARING_DIAMOND_ABI
-        )
+    def __init__(
+        self, w3: Web3, address: ChecksumAddress = defaults.CLEARING_DIAMOND_ADDRESS
+    ):
+        self._contract = w3.eth.contract(address=address, abi=CLEARING_DIAMOND_ABI)
 
 
 class MarginAccountRegistry(margin_account_registry.MarginAccountRegistry):
@@ -60,8 +62,12 @@ class MarginAccountRegistry(margin_account_registry.MarginAccountRegistry):
     w3 : web3.Web3
     """
 
-    def __init__(self, w3: Web3):
-        super().__init__(w3, config.MARGIN_ACCOUNT_REGISTRY_ADDRESS)
+    def __init__(
+        self,
+        w3: Web3,
+        address: ChecksumAddress = defaults.MARGIN_ACCOUNT_REGISTRY_ADDRESS,
+    ):
+        super().__init__(w3, address)
 
 
 class OracleProvider(oracle_provider.OracleProvider):
@@ -72,8 +78,10 @@ class OracleProvider(oracle_provider.OracleProvider):
     w3 : web3.Web3
     """
 
-    def __init__(self, w3: Web3):
-        super().__init__(w3, config.ORACLE_PROVIDER_ADDRESS)
+    def __init__(
+        self, w3: Web3, address: ChecksumAddress = defaults.ORACLE_PROVIDER_ADDRESS
+    ):
+        super().__init__(w3, address)
 
 
 class ProductRegistry(product_registry.ProductRegistry):
@@ -84,8 +92,10 @@ class ProductRegistry(product_registry.ProductRegistry):
     w3 : web3.Web3
     """
 
-    def __init__(self, w3: Web3):
-        super().__init__(w3, config.PRODUCT_REGISTRY_ADDRESS)
+    def __init__(
+        self, w3: Web3, address: ChecksumAddress = defaults.PRODUCT_REGISTRY_ADDRESS
+    ):
+        super().__init__(w3, address)
 
 
 class SystemViewer(system_viewer.SystemViewer):
@@ -96,5 +106,7 @@ class SystemViewer(system_viewer.SystemViewer):
     w3 : web3.Web3
     """
 
-    def __init__(self, w3: Web3):
-        super().__init__(w3, config.SYSTEM_VIEWER_ADDRESS)
+    def __init__(
+        self, w3: Web3, address: ChecksumAddress = defaults.SYSTEM_VIEWER_ADDRESS
+    ):
+        super().__init__(w3, address)

afp/config.py

@@ -1,42 +1,28 @@
-import os
+from dataclasses import dataclass
 
-from web3 import Web3
+from eth_typing.evm import ChecksumAddress
 
+from .auth import Authenticator
 
-# Constants from clearing/contracts/lib/constants.sol
-RATE_MULTIPLIER = 10**4
-FEE_RATE_MULTIPLIER = 10**6
-FULL_PRECISION_MULTIPLIER = 10**18
 
-USER_AGENT = "afp-sdk"
-DEFAULT_EXCHANGE_API_VERSION = 1
-EXCHANGE_URL = os.getenv(
-    "AFP_EXCHANGE_URL", "https://afp-exchange-stable.up.railway.app"
-)
+@dataclass(frozen=True)
+class Config:
+    authenticator: Authenticator | None
 
-CHAIN_ID = int(os.getenv("AFP_CHAIN_ID", 65000000))
+    # Venue parameters
+    exchange_url: str
 
-CLEARING_DIAMOND_ADDRESS = Web3.to_checksum_address(
-    os.getenv(
-        "AFP_CLEARING_DIAMOND_ADDRESS", "0x5B5411F1548254d25360d71FE40cFc1cC983B2A2"
-    )
-)
-MARGIN_ACCOUNT_REGISTRY_ADDRESS = Web3.to_checksum_address(
-    os.getenv(
-        "AFP_MARGIN_ACCOUNT_REGISTRY_ADDRESS",
-        "0x99f4FA9Cdce7AD227eB84907936a8FeF2095D846",
-    )
-)
-ORACLE_PROVIDER_ADDRESS = Web3.to_checksum_address(
-    os.getenv(
-        "AFP_ORACLE_PROVIDER_ADDRESS", "0xF2A2A27da33D30B4BF38D7e186E7B0b1e964e55c"
-    )
-)
-PRODUCT_REGISTRY_ADDRESS = Web3.to_checksum_address(
-    os.getenv(
-        "AFP_PRODUCT_REGISTRY_ADDRESS", "0x86B3829471929B115367DA0958f56A6AB844b08e"
-    )
-)
-SYSTEM_VIEWER_ADDRESS = Web3.to_checksum_address(
-    os.getenv("AFP_SYSTEM_VIEWER_ADDRESS", "0xfF2DFcC44a95cce96E03EfC33C65c8Be671Bae5B")
-)
+    # Blockchain parameters
+    rpc_url: str | None
+    chain_id: int
+    gas_limit: int | None
+    max_fee_per_gas: int | None
+    max_priority_fee_per_gas: int | None
+    timeout_seconds: int
+
+    # Clearing System parameters
+    clearing_diamond_address: ChecksumAddress
+    margin_account_registry_address: ChecksumAddress
+    oracle_provider_address: ChecksumAddress
+    product_registry_address: ChecksumAddress
+    system_viewer_address: ChecksumAddress

afp/constants.py

@@ -0,0 +1,52 @@
+import os
+from types import SimpleNamespace
+
+
+def _int_or_none(value: str | None) -> int | None:
+    return int(value) if value is not None else None
+
+
+USER_AGENT = "afp-sdk"
+DEFAULT_EXCHANGE_API_VERSION = 1
+
+# Constants from clearing/contracts/lib/constants.sol
+RATE_MULTIPLIER = 10**4
+FEE_RATE_MULTIPLIER = 10**6
+FULL_PRECISION_MULTIPLIER = 10**18
+
+defaults = SimpleNamespace(
+    # Authentication parameters
+    KEYFILE=os.getenv("AFP_KEYFILE", None),
+    KEYFILE_PASSWORD=os.getenv("AFP_KEYFILE_PASSWORD", ""),
+    PRIVATE_KEY=os.getenv("AFP_PRIVATE_KEY", None),
+    # Venue parameters
+    EXCHANGE_URL=os.getenv(
+        "AFP_EXCHANGE_URL", "https://afp-exchange-stable.up.railway.app"
+    ),
+    # Blockchain parameters
+    RPC_URL=os.getenv("AFP_RPC_URL", None),
+    CHAIN_ID=int(os.getenv("AFP_CHAIN_ID", 65000000)),
+    GAS_LIMIT=_int_or_none(os.getenv("AFP_GAS_LIMIT", None)),
+    MAX_FEE_PER_GAS=_int_or_none(os.getenv("AFP_MAX_FEE_PER_GAS", None)),
+    MAX_PRIORITY_FEE_PER_GAS=_int_or_none(
+        os.getenv("AFP_MAX_PRIORITY_FEE_PER_GAS", None)
+    ),
+    TIMEOUT_SECONDS=int(os.getenv("AFP_TIMEOUT_SECONDS", 10)),
+    # Clearing System parameters
+    CLEARING_DIAMOND_ADDRESS=os.getenv(
+        "AFP_CLEARING_DIAMOND_ADDRESS", "0x5B5411F1548254d25360d71FE40cFc1cC983B2A2"
+    ),
+    MARGIN_ACCOUNT_REGISTRY_ADDRESS=os.getenv(
+        "AFP_MARGIN_ACCOUNT_REGISTRY_ADDRESS",
+        "0x99f4FA9Cdce7AD227eB84907936a8FeF2095D846",
+    ),
+    ORACLE_PROVIDER_ADDRESS=os.getenv(
+        "AFP_ORACLE_PROVIDER_ADDRESS", "0xF2A2A27da33D30B4BF38D7e186E7B0b1e964e55c"
+    ),
+    PRODUCT_REGISTRY_ADDRESS=os.getenv(
+        "AFP_PRODUCT_REGISTRY_ADDRESS", "0x86B3829471929B115367DA0958f56A6AB844b08e"
+    ),
+    SYSTEM_VIEWER_ADDRESS=os.getenv(
+        "AFP_SYSTEM_VIEWER_ADDRESS", "0xfF2DFcC44a95cce96E03EfC33C65c8Be671Bae5B"
+    ),
+)