afp-sdk 0.2.1__tar.gz → 0.2.2__tar.gz

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/.env.template

@@ -4,3 +4,4 @@
 # AFP_MARGIN_ACCOUNT_REGISTRY_ADDRESS=
 # AFP_ORACLE_PROVIDER_ADDRESS=
 # AFP_PRODUCT_REGISTRY_ADDRESS=
+# AFP_SYSTEM_VIEWER_ADDRESS=

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [v0.2.2] - 2025-09-03
+
+### Added
+
+- Add public facade for SystemViewer contract binding ([#16](https://github.com/autonity/afp-sdk/pull/16))
+
+### Fixed
+
+- Remove duplicates of ports of Solidity data structures ([#16](https://github.com/autonity/afp-sdk/pull/16))
+
 ## [v0.2.1] - 2025-09-02
 
 ### Added
@@ -35,6 +45,7 @@
 
 _First release._
 
+[v0.2.2]: https://github.com/autonity/afp-sdk/releases/tag/v0.2.2
 [v0.2.1]: https://github.com/autonity/afp-sdk/releases/tag/v0.2.1
 [v0.2.0]: https://github.com/autonity/afp-sdk/releases/tag/v0.2.0
 [v0.1.2]: https://github.com/autonity/afp-sdk/releases/tag/v0.1.2

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: afp-sdk
-Version: 0.2.1
+Version: 0.2.2
 Summary: Autonomous Futures Protocol Python SDK
 Keywords: autonity,web3,trading,crypto,prediction,forecast,markets
 License-Expression: MIT

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/afp/bindings/__init__.py

@@ -8,6 +8,7 @@ from .facade import (
     MarginAccountRegistry,
     OracleProvider,
     ProductRegistry,
+    SystemViewer,
 )
 from .margin_account import MarginAccount, PositionData, Settlement
 from .product_registry import (
@@ -16,6 +17,7 @@ from .product_registry import (
     ProductMetadata,
     ProductState,
 )
+from .system_viewer import UserMarginAccountData
 from .trading_protocol import TradingProtocol
 
 __all__ = (
@@ -25,6 +27,7 @@ __all__ = (
     "MarginAccountRegistry",
     "OracleProvider",
     "ProductRegistry",
+    "SystemViewer",
     "TradingProtocol",
     # Structures
     "AuctionConfig",
@@ -42,6 +45,7 @@ __all__ = (
     "ProductMetadata",
     "Settlement",
     "Trade",
+    "UserMarginAccountData",
     # Enumerations
     "ProductState",
     "Side",

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/afp/bindings/auctioneer_facet.py

@@ -2,7 +2,6 @@
 
 # This module has been generated using pyabigen v0.2.16
 
-import enum
 import typing
 from dataclasses import dataclass
 
@@ -11,12 +10,7 @@ import hexbytes
 import web3
 from web3.contract import contract
 
-
-class Side(enum.IntEnum):
-    """Port of `enum Side` on the AuctioneerFacet contract."""
-
-    BID = 0
-    ASK = 1
+from .clearing_facet import Side
 
 
 @dataclass

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/afp/bindings/clearing_facet.py

@@ -11,6 +11,9 @@ import hexbytes
 import web3
 from web3.contract import contract
 
+if typing.TYPE_CHECKING:
+    from .auctioneer_facet import AuctionConfig
+
 
 class Side(enum.IntEnum):
     """Port of `enum Side` on the ClearingFacet contract."""
@@ -19,14 +22,6 @@ class Side(enum.IntEnum):
     ASK = 1
 
 
-@dataclass
-class AuctionConfig:
-    """Port of `struct AuctionConfig` on the IAuctioneer contract."""
-
-    restoration_buffer: int
-    liquidation_duration: int
-
-
 @dataclass
 class ClearingConfig:
     """Port of `struct ClearingConfig` on the IClearing contract."""
@@ -38,7 +33,7 @@ class ClearingConfig:
 class Config:
     """Port of `struct Config` on the IClearing contract."""
 
-    auction_config: AuctionConfig
+    auction_config: "AuctionConfig"
     clearing_config: ClearingConfig
 
 

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/afp/bindings/facade.py

@@ -12,6 +12,7 @@ from . import (
     mark_price_tracker_facet,
     oracle_provider,
     product_registry,
+    system_viewer,
 )
 
 # In order to include a facet in the ClearingDiamond facade:
@@ -85,3 +86,15 @@ class ProductRegistry(product_registry.ProductRegistry):
 
     def __init__(self, w3: Web3):
         super().__init__(w3, config.PRODUCT_REGISTRY_ADDRESS)
+
+
+class SystemViewer(system_viewer.SystemViewer):
+    """SystemViewer contract binding.
+
+    Parameters
+    ----------
+    w3 : web3.Web3
+    """
+
+    def __init__(self, w3: Web3):
+        super().__init__(w3, config.SYSTEM_VIEWER_ADDRESS)

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/afp/bindings/system_viewer.py

@@ -2,7 +2,6 @@
 
 # This module has been generated using pyabigen v0.2.16
 
-import enum
 import typing
 from dataclasses import dataclass
 
@@ -11,76 +10,13 @@ import hexbytes
 import web3
 from web3.contract import contract
 
-
-class ProductState(enum.IntEnum):
-    """Port of `enum ProductState` on the SystemViewer contract."""
-
-    NOT_EXIST = 0
-    PENDING = 1
-    LIVE = 2
-    TRADEOUT = 3
-    FINAL_SETTLEMENT = 4
-    EXPIRED = 5
-
-
-@dataclass
-class Settlement:
-    """Port of `struct Settlement` on the IMarginAccount contract."""
-
-    position_id: hexbytes.HexBytes
-    quantity: int
-    price: int
-
-
-@dataclass
-class PositionData:
-    """Port of `struct PositionData` on the IMarginAccount contract."""
-
-    position_id: hexbytes.HexBytes
-    quantity: int
-    cost_basis: int
-    maintenance_margin: int
-    pnl: int
-
-
-@dataclass
-class ProductMetadata:
-    """Port of `struct ProductMetadata` on the IProductRegistry contract."""
-
-    builder: eth_typing.ChecksumAddress
-    symbol: str
-    description: str
-
-
-@dataclass
-class OracleSpecification:
-    """Port of `struct OracleSpecification` on the IProductRegistry contract."""
-
-    oracle_address: eth_typing.ChecksumAddress
-    fsv_decimals: int
-    fsp_alpha: int
-    fsp_beta: int
-    fsv_calldata: hexbytes.HexBytes
-
-
-@dataclass
-class Product:
-    """Port of `struct Product` on the IProductRegistry contract."""
-
-    metadata: ProductMetadata
-    oracle_spec: OracleSpecification
-    price_quotation: str
-    collateral_asset: eth_typing.ChecksumAddress
-    start_time: int
-    earliest_fsp_submission_time: int
-    unit_value: int
-    initial_margin_requirement: int
-    maintenance_margin_requirement: int
-    offer_price_buffer: int
-    auction_bounty: int
-    tradeout_interval: int
-    tick_size: int
-    extended_metadata: str
+from .margin_account import Settlement, PositionData
+from .product_registry import (
+    OracleSpecification,
+    Product,
+    ProductMetadata,
+    ProductState,
+)
 
 
 @dataclass

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/afp/bindings/trading_protocol.py

@@ -2,61 +2,14 @@
 
 # This module has been generated using pyabigen v0.2.16
 
-import enum
 import typing
-from dataclasses import dataclass
 
 import eth_typing
 import hexbytes
 import web3
 from web3.contract import contract
 
-
-class Side(enum.IntEnum):
-    """Port of `enum Side` on the TradingProtocol contract."""
-
-    BID = 0
-    ASK = 1
-
-
-@dataclass
-class IntentData:
-    """Port of `struct IntentData` on the IClearing contract."""
-
-    nonce: int
-    trading_protocol_id: eth_typing.ChecksumAddress
-    product_id: hexbytes.HexBytes
-    limit_price: int
-    quantity: int
-    max_trading_fee_rate: int
-    good_until: int
-    side: Side
-
-
-@dataclass
-class Intent:
-    """Port of `struct Intent` on the IClearing contract."""
-
-    margin_account_id: eth_typing.ChecksumAddress
-    intent_account_id: eth_typing.ChecksumAddress
-    hash: hexbytes.HexBytes
-    data: IntentData
-    signature: hexbytes.HexBytes
-
-
-@dataclass
-class Trade:
-    """Port of `struct Trade` on the IClearing contract."""
-
-    product_id: hexbytes.HexBytes
-    protocol_id: eth_typing.ChecksumAddress
-    trade_id: int
-    price: int
-    timestamp: int
-    accounts: typing.List[eth_typing.ChecksumAddress]
-    quantities: typing.List[int]
-    fee_rates: typing.List[int]
-    intents: typing.List[Intent]
+from .clearing_facet import Trade
 
 
 class TradingProtocol:

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/afp/config.py

@@ -36,3 +36,6 @@ PRODUCT_REGISTRY_ADDRESS = Web3.to_checksum_address(
         "AFP_PRODUCT_REGISTRY_ADDRESS", "0x9b92EAC112c996a513e515Cf8c3BDd83619F730D"
     )
 )
+SYSTEM_VIEWER_ADDRESS = Web3.to_checksum_address(
+    os.getenv("AFP_SYSTEM_VIEWER_ADDRESS", "0xcB3F71Db710544283a1FfB38FE1bEC554d0634A5")
+)

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "uv_build"
 
 [project]
 name = "afp-sdk"
-version = "0.2.1"
+version = "0.2.2"
 description = "Autonomous Futures Protocol Python SDK"
 readme = "README.md"
 license = "MIT"

{afp_sdk-0.2.1 → afp_sdk-0.2.2}/uv.lock

@@ -13,7 +13,7 @@ wheels = [
 
 [[package]]
 name = "afp-sdk"
-version = "0.2.1"
+version = "0.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "decorator" },