axis-synome 0.1.0.dev68__tar.gz → 0.1.0.dev69__tar.gz

{axis_synome-0.1.0.dev68/src/axis_synome.egg-info → axis_synome-0.1.0.dev69}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: axis-synome
-Version: 0.1.0.dev68
+Version: 0.1.0.dev69
 Summary: Axis specification modules (entities, formulas, validators)
 Author-email: Archon Tech <hello@archontech.ai>
 License: MIT

{axis_synome-0.1.0.dev68 → axis_synome-0.1.0.dev69}/src/axis_synome/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.1.0.dev68'
-__version_tuple__ = version_tuple = (0, 1, 0, 'dev68')
+__version__ = version = '0.1.0.dev69'
+__version_tuple__ = version_tuple = (0, 1, 0, 'dev69')
 
 __commit_id__ = commit_id = None

{axis_synome-0.1.0.dev68 → axis_synome-0.1.0.dev69}/src/axis_synome/export_entities.py

@@ -25,7 +25,9 @@ from axis_synome.spec.asc.entities.protocol_sets import (
     L1_PSM_PROTOCOLS,
     L2_PSM_PROTOCOLS,
     UNISWAP_STYLE_PROTOCOLS,
+    AllocationType,
     Protocol,
+    TokenType,
 )
 
 # Proxy roles. "alm" is the canonical ALM Proxy holding operational allocation
@@ -60,8 +62,8 @@ class TokenEntryModel(BaseModel):
     star: str
     chain: str
     protocol: str
-    allocation_type: str
-    token_type: str
+    allocation_type: AllocationType
+    token_type: TokenType
 
 
 class AssetsByPrimeContainer(BaseModel):
@@ -120,39 +122,39 @@ def _prime_to_star(prime: PrimeName | str) -> str:
     return text.lower().replace(" ", "-")
 
 
-def _token_type(protocol: Protocol, chain: str, token_name: str) -> str:
+def _token_type(protocol: Protocol, chain: str, token_name: str) -> TokenType:
     if protocol in ATOKEN_PROTOCOLS:
-        return "atoken"
+        return TokenType.ATOKEN
 
     if protocol in ERC4626_PROTOCOLS:
-        return "erc4626"
+        return TokenType.ERC4626
 
     if protocol == Protocol.CURVE:
-        return "curve"
+        return TokenType.CURVE
 
     if protocol in UNISWAP_STYLE_PROTOCOLS:
         if "LP" in token_name.upper():
-            return "uni_v3_lp"
-        return "uni_v3_pool"
+            return TokenType.UNI_V3_LP
+        return TokenType.UNI_V3_POOL
 
     if protocol == Protocol.CENTRIFUGE:
         if chain == "plume":
-            return "centrifuge_feeder"
-        return "centrifuge"
+            return TokenType.CENTRIFUGE_FEEDER
+        return TokenType.CENTRIFUGE
 
     if protocol == Protocol.ANCHORAGE:
-        return "anchorage"
+        return TokenType.ANCHORAGE
 
     if protocol in L1_PSM_PROTOCOLS | L2_PSM_PROTOCOLS:
-        return "psm3"
+        return TokenType.PSM3
 
-    return "erc20"
+    return TokenType.ERC20
 
 
-def _allocation_type(protocol: Protocol) -> str:
+def _allocation_type(protocol: Protocol) -> AllocationType:
     if protocol in L1_PSM_PROTOCOLS | L2_PSM_PROTOCOLS:
-        return "psm3"
-    return "allocation"
+        return AllocationType.PSM3
+    return AllocationType.ALLOCATION
 
 
 def _version_from_package_metadata() -> str:
@@ -297,7 +299,7 @@ def build_axis_synome_contract(
                 ),
                 "star": star,
                 "chain": chain,
-                "protocol": missing.protocol,
+                "protocol": _slug(missing.protocol.value) if missing.protocol is not None else "",
                 "allocation_type": missing.allocation_type,
                 "token_type": missing.token_type,
             })

{axis_synome-0.1.0.dev68 → axis_synome-0.1.0.dev69}/src/axis_synome/spec/asc/entities/alm_proxies.py

@@ -209,18 +209,19 @@ class AlmProxy(Enum):
     GROVE_MONAD = GROVE_MONAD_ALM_PROXY
 
 
-# Additional ALM-controlled wallets that are NOT the canonical ALM Proxy but
-# must still be tracked by downstream consumers. The canonical ALM Proxy holds
-# the operational allocation positions; these SubProxy ("risk capital" /
-# treasury) wallets hold capital separately and are exported alongside the ALM
-# Proxy for the same (Prime, Network) rather than replacing it.
-STL_ADDITIONAL_PROXIES: Final[dict[tuple[PrimeAgent, Network], list[str]]] = {
-    # Spark SubProxy — Atlas A.6.1.1.1.2.1.1.3.1.1.2.
+STL_ADDITIONAL_PROXIES: Final[dict[tuple[PrimeAgent, Network], list[EvmAddress]]] = {
     (PrimeAgent.SPARK, Network.ETHEREUM_MAINNET): [
-        "0x3300f198988e4c9c63f75df86de36421f06af8c4",
+        EvmAddress("0x3300f198988e4C9C63F75dF86De36421f06af8c4"),
     ],
-    # Grove SubProxy — Atlas A.6.1.1.2.2.1.1.3.1.1.2.
     (PrimeAgent.GROVE, Network.ETHEREUM_MAINNET): [
-        "0x1369f7b2b38c76b6478c0f0e66d94923421891ba",
+        EvmAddress("0x1369f7b2b38c76B6478c0f0E66D94923421891Ba"),
     ],
 }
+"""Additional ALM-controlled wallets that are NOT the canonical ALM Proxy but
+must still be tracked by downstream consumers. The canonical ALM Proxy holds the
+operational allocation positions; these SubProxy ("risk capital" / treasury)
+wallets hold capital separately and are exported alongside the ALM Proxy for the
+same (Prime, Network) rather than replacing it.
+
+Atlas references: the Spark SubProxy is A.6.1.1.1.2.1.1.3.1.1.2 and the Grove
+SubProxy is A.6.1.1.2.2.1.1.3.1.1.2."""

{axis_synome-0.1.0.dev68 → axis_synome-0.1.0.dev69}/src/axis_synome/spec/asc/entities/assets_by_prime.py

@@ -1,4 +1,5 @@
 from enum import StrEnum
+from typing import Final
 
 from axis_synome.spec.asc.entities.asset_categories import AssetCategory
 from axis_synome.spec.asc.entities.assets import Asset
@@ -19,6 +20,43 @@ class PrimeName(StrEnum):
     SPARK = "Spark"
 
 
+# Grove positions whose non-obvious provenance is captured in a docstring. They
+# are referenced from ASSETS_BY_PRIME below; a "#" comment on a list element is
+# not machine-readable, so these are named constants instead.
+GROVE_GACLO_1: Final[Asset] = Asset(
+    token=Token.GACLO_1,
+    network=Network.AVALANCHE,
+    protocol=Protocol.GALAXY,
+    address=EvmAddress("0x2C0aDFF8e114f3cA106051144353aC703D24B901"),
+    source="A.6.1.1.2.2.6.1.3.1.9.1.2.2.1",
+    underlying_asset=Token.USDC,
+    underlying_asset_address=EvmAddress("0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"),
+    underlying_asset_source="A.6.1.1.2.2.6.1.3.1.9.1.2.2.3",
+    categories={AssetCategory.REAL_WORLD_ASSET},
+)
+"""Galaxy Arch CLOs. The GACLO-1 token is on Avalanche while deposits are made on
+Ethereum Mainnet, so the Atlas-recorded Underlying Asset Address is mainnet USDC
+(0xA0b8…) per the Instance Configuration Document. Network is Avalanche to match
+the token deployment chain."""
+
+
+GROVE_MONAD_UNISWAP_AUSD_USDC: Final[Asset] = Asset(
+    token=Token.UNISWAP_AUSD_USDC_POOL,
+    network=Network.MONAD,
+    protocol=Protocol.UNISWAP,
+    address=EvmAddress("0x6B405DCA74897c9442d369DcF6c0EC230f7E1c7C"),
+    source="A.6.1.1.2.2.6.1.3.1.12.1.2.2.1",
+    underlying_asset=Token.USDC,
+    underlying_asset_address=EvmAddress("0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"),
+    underlying_asset_source="A.6.1.1.2.2.6.1.3.1.12.1.2.2.2",
+    categories={AssetCategory.CASH_STABLECOIN},
+)
+"""Monad Uniswap AUSD/USDC pool. The Atlas Underlying Asset Address node records
+USDC (0xA0b8…), which is the asset supplied by the Grove Liquidity Layer; the
+token name carries no "LP" marker so the export derives token_type
+"uni_v3_pool"."""
+
+
 ASSETS_BY_PRIME: dict[PrimeName, list[Asset]] = {
     PrimeName.GROVE: [
         Asset(
@@ -263,21 +301,7 @@ ASSETS_BY_PRIME: dict[PrimeName, list[Asset]] = {
             underlying_asset_source="A.6.1.1.2.2.6.1.3.4.1.1.2.2.2",
             categories={AssetCategory.LENDING_MARKET},
         ),
-        # Galaxy Arch CLOs. The GACLO-1 token is on Avalanche while deposits are
-        # made on Ethereum Mainnet, so the Atlas-recorded Underlying Asset
-        # Address is mainnet USDC (0xA0b8…) per the Instance Configuration
-        # Document. Network is Avalanche to match the token deployment chain.
-        Asset(
-            token=Token.GACLO_1,
-            network=Network.AVALANCHE,
-            protocol=Protocol.GALAXY,
-            address=EvmAddress("0x2C0aDFF8e114f3cA106051144353aC703D24B901"),
-            source="A.6.1.1.2.2.6.1.3.1.9.1.2.2.1",
-            underlying_asset=Token.USDC,
-            underlying_asset_address=EvmAddress("0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"),
-            underlying_asset_source="A.6.1.1.2.2.6.1.3.1.9.1.2.2.3",
-            categories={AssetCategory.REAL_WORLD_ASSET},
-        ),
+        GROVE_GACLO_1,
         Asset(
             token=Token.ACRDX,
             network=Network.PLUME,
@@ -289,21 +313,7 @@ ASSETS_BY_PRIME: dict[PrimeName, list[Asset]] = {
             underlying_asset_source="A.6.1.1.2.2.6.1.3.5.1.1.2.2.2",
             categories={AssetCategory.REAL_WORLD_ASSET},
         ),
-        # Monad Uniswap AUSD/USDC pool. The Atlas Underlying Asset Address node
-        # records USDC (0xA0b8…), which is the asset supplied by the Grove
-        # Liquidity Layer; the token name carries no "LP" marker so the export
-        # derives token_type "uni_v3_pool".
-        Asset(
-            token=Token.UNISWAP_AUSD_USDC_POOL,
-            network=Network.MONAD,
-            protocol=Protocol.UNISWAP,
-            address=EvmAddress("0x6B405DCA74897c9442d369DcF6c0EC230f7E1c7C"),
-            source="A.6.1.1.2.2.6.1.3.1.12.1.2.2.1",
-            underlying_asset=Token.USDC,
-            underlying_asset_address=EvmAddress("0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"),
-            underlying_asset_source="A.6.1.1.2.2.6.1.3.1.12.1.2.2.2",
-            categories={AssetCategory.CASH_STABLECOIN},
-        ),
+        GROVE_MONAD_UNISWAP_AUSD_USDC,
     ],
     PrimeName.OBEX: [
         Asset(