blockapi 2.5.6__tar.gz → 2.6.0__tar.gz

{blockapi-2.5.6 → blockapi-2.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blockapi
-Version: 2.5.6
+Version: 2.6.0
 Summary: BlockAPI library
 Home-page: https://github.com/crypkit/blockapi
 Author: Devmons s.r.o.

blockapi-2.6.0/blockapi/test/v2/api/test_bitaps_ltc.py

@@ -0,0 +1,39 @@
+from decimal import Decimal
+
+import pytest
+
+from blockapi.test.v2.api.conftest import read_file
+from blockapi.test.v2.test_data import ltc_test_address
+from blockapi.v2.api.bitaps import BitapsLitecoinApi
+from blockapi.v2.models import FetchResult
+
+
+def test_fetch_balances(requests_mock, bitaps_ltc_balance_response):
+    requests_mock.get(
+        f'https://api.bitaps.com/ltc/v1/blockchain/address/state/{ltc_test_address}',
+        text=bitaps_ltc_balance_response,
+    )
+
+    api = BitapsLitecoinApi()
+    balances = api.get_balance(ltc_test_address)
+    assert len(balances) == 1
+    assert balances[0].balance == Decimal('0.00075763')
+
+
+def test_parse_zero_balance():
+    api = BitapsLitecoinApi()
+    fetch_result = FetchResult(data={'data': {'balance': 0}})
+    result = api.parse_balances(fetch_result)
+    assert result.data is None
+
+
+def test_parse_empty_response():
+    api = BitapsLitecoinApi()
+    fetch_result = FetchResult(data=None)
+    result = api.parse_balances(fetch_result)
+    assert result.data is None
+
+
+@pytest.fixture
+def bitaps_ltc_balance_response():
+    return read_file('data/bitaps_ltc_balance_response.json')

blockapi-2.6.0/blockapi/test/v2/api/test_litecoinspace.py

@@ -0,0 +1,46 @@
+from decimal import Decimal
+
+import pytest
+
+from blockapi.test.v2.api.conftest import read_file
+from blockapi.test.v2.test_data import ltc_test_address
+from blockapi.v2.api.litecoinspace import LitecoinSpaceApi
+from blockapi.v2.models import FetchResult
+
+
+def test_fetch_balances(requests_mock, litecoinspace_balance_response):
+    requests_mock.get(
+        f'https://litecoinspace.org/api/address/{ltc_test_address}',
+        text=litecoinspace_balance_response,
+    )
+
+    api = LitecoinSpaceApi()
+    balances = api.get_balance(ltc_test_address)
+    assert len(balances) == 1
+    assert balances[0].balance == Decimal('0.00075763')
+
+
+def test_parse_zero_balance():
+    api = LitecoinSpaceApi()
+    fetch_result = FetchResult(
+        data={
+            'chain_stats': {
+                'funded_txo_sum': 100,
+                'spent_txo_sum': 100,
+            }
+        }
+    )
+    result = api.parse_balances(fetch_result)
+    assert result.data is None
+
+
+def test_parse_empty_response():
+    api = LitecoinSpaceApi()
+    fetch_result = FetchResult(data=None)
+    result = api.parse_balances(fetch_result)
+    assert result.data is None
+
+
+@pytest.fixture
+def litecoinspace_balance_response():
+    return read_file('data/litecoinspace_balance_response.json')

{blockapi-2.5.6 → blockapi-2.6.0}/blockapi/v2/api/__init__.py

@@ -1,3 +1,4 @@
+from blockapi.v2.api.bitaps import BitapsLitecoinApi
 from blockapi.v2.api.blockchain_info import BlockchainInfoApi
 from blockapi.v2.api.blockchainos import BlockchainosApi
 from blockapi.v2.api.blockchair import (
@@ -9,6 +10,7 @@ from blockapi.v2.api.blockchair import (
 from blockapi.v2.api.debank import DebankApi, DebankApp, DebankPrediction
 from blockapi.v2.api.ethplorer import EthplorerApi
 from blockapi.v2.api.haskoin import HaskoinApi
+from blockapi.v2.api.litecoinspace import LitecoinSpaceApi
 from blockapi.v2.api.optimistic_etherscan import OptimismEtherscanApi
 from blockapi.v2.api.perpetual import PerpetualApi, perp_contract_address
 from blockapi.v2.api.solana import SolanaApi, SolscanApi

blockapi-2.6.0/blockapi/v2/api/bitaps.py

@@ -0,0 +1,53 @@
+from blockapi.v2.base import BalanceMixin, BlockchainApi
+from blockapi.v2.coins import COIN_LTC
+from blockapi.v2.models import (
+    ApiOptions,
+    AssetType,
+    BalanceItem,
+    Blockchain,
+    FetchResult,
+    ParseResult,
+)
+
+
+class BitapsLitecoinApi(BlockchainApi, BalanceMixin):
+    """
+    Coin: Litecoin
+    API docs: https://developer.bitaps.com/
+    Explorer: https://ltc.bitaps.com
+    """
+
+    coin = COIN_LTC
+    api_options = ApiOptions(
+        blockchain=Blockchain.LITECOIN,
+        base_url='https://api.bitaps.com/ltc/v1/',
+        rate_limit=0.1,
+    )
+
+    supported_requests = {
+        'get_balance': 'blockchain/address/state/{address}',
+    }
+
+    def fetch_balances(self, address: str) -> FetchResult:
+        return self.get_data('get_balance', address=address)
+
+    def parse_balances(self, fetch_result: FetchResult) -> ParseResult:
+        if not fetch_result.data:
+            return ParseResult()
+
+        data = fetch_result.data.get('data', {})
+        balance_raw = data.get('balance')
+
+        if not balance_raw:
+            return ParseResult()
+
+        return ParseResult(
+            data=[
+                BalanceItem.from_api(
+                    balance_raw=balance_raw,
+                    coin=self.coin,
+                    asset_type=AssetType.AVAILABLE,
+                    raw=fetch_result.data,
+                )
+            ]
+        )

{blockapi-2.5.6 → blockapi-2.6.0}/blockapi/v2/api/debank.py

@@ -36,6 +36,7 @@ from blockapi.v2.models import (
     DebankApp,
     DebankModelApp,
     DebankModelAppPortfolioItem,
+    DebankModelAppStats,
     DebankModelPredictionDetail,
     DebankPrediction,
     FetchResult,
@@ -70,6 +71,7 @@ class DebankModelPoolItemDetail(BaseModel):
     description: Optional[str] = None
     health_rate: Optional[float] = None
     unlock_at: Optional[float] = None
+    debt_ratio: Optional[float] = None
     token_list: Optional[list[dict]] = None
     supply_token_list: Optional[list[dict]] = None
     borrow_token_list: Optional[list[dict]] = None
@@ -90,6 +92,9 @@ class DebankModelPortfolioItem(BaseModel):
     pool_id: Optional[str] = None
     pool: Optional[DebankModelPoolItem] = None
     position_index: Optional[str] = None
+    stats: DebankModelAppStats
+    detail_types: list[str]
+    update_at: float
 
     @validator('pool')
     def require_pool_or_pool_id(cls, v, values, **kwargs):
@@ -481,6 +486,12 @@ class DebankPortfolioParser:
                 locked_until=locked_until,
                 health_rate=health_rate,
                 items=[],
+                detail_types=item.detail_types,
+                asset_usd_value=item.stats.asset_usd_value,
+                debt_usd_value=item.stats.debt_usd_value,
+                net_usd_value=item.stats.net_usd_value,
+                debt_ratio=detail.debt_ratio,
+                update_at=item.update_at,
             )
 
         items = list(self._parse_balances(detail, item, pool.pool_info))

blockapi-2.6.0/blockapi/v2/api/litecoinspace.py

@@ -0,0 +1,55 @@
+from blockapi.v2.base import BalanceMixin, BlockchainApi
+from blockapi.v2.coins import COIN_LTC
+from blockapi.v2.models import (
+    ApiOptions,
+    AssetType,
+    BalanceItem,
+    Blockchain,
+    FetchResult,
+    ParseResult,
+)
+
+
+class LitecoinSpaceApi(BlockchainApi, BalanceMixin):
+    """
+    Coin: Litecoin
+    API docs: https://litecoinspace.org/docs/api/rest
+    Explorer: https://litecoinspace.org
+    """
+
+    coin = COIN_LTC
+    api_options = ApiOptions(
+        blockchain=Blockchain.LITECOIN,
+        base_url='https://litecoinspace.org',
+        rate_limit=0.2,
+    )
+
+    supported_requests = {
+        'get_balance': '/api/address/{address}',
+    }
+
+    def fetch_balances(self, address: str) -> FetchResult:
+        return self.get_data('get_balance', address=address)
+
+    def parse_balances(self, fetch_result: FetchResult) -> ParseResult:
+        if not fetch_result.data:
+            return ParseResult()
+
+        chain_stats = fetch_result.data.get('chain_stats', {})
+        funded = chain_stats.get('funded_txo_sum', 0)
+        spent = chain_stats.get('spent_txo_sum', 0)
+        balance_raw = funded - spent
+
+        if not balance_raw:
+            return ParseResult()
+
+        return ParseResult(
+            data=[
+                BalanceItem.from_api(
+                    balance_raw=balance_raw,
+                    coin=self.coin,
+                    asset_type=AssetType.AVAILABLE,
+                    raw=fetch_result.data,
+                )
+            ]
+        )

{blockapi-2.5.6 → blockapi-2.6.0}/blockapi/v2/models.py

@@ -1163,6 +1163,19 @@ class TransactionItem:
         )
 
 
+# uint256.max / 1e18 — Aave's sentinel for "no debt / infinite health factor"
+_HEALTH_RATE_SENTINEL_THRESHOLD = Decimal('1e18')
+
+
+def _normalize_health_rate(value) -> Optional[Decimal]:
+    if value is None:
+        return None
+    d = to_decimal(value)
+    if d >= _HEALTH_RATE_SENTINEL_THRESHOLD:
+        return None
+    return d
+
+
 @attr.s(auto_attribs=True, slots=True, frozen=True)
 class Pool:
     pool_info: PoolInfo
@@ -1170,6 +1183,12 @@ class Pool:
     items: List[BalanceItem]
     locked_until: Optional[datetime] = attr.ib(default=None)
     health_rate: Optional[Decimal] = attr.ib(default=None)
+    detail_types: List[str] = attr.ib(factory=list)
+    asset_usd_value: Decimal = attr.ib(default=Decimal('0'))
+    debt_usd_value: Decimal = attr.ib(default=Decimal('0'))
+    net_usd_value: Decimal = attr.ib(default=Decimal('0'))
+    debt_ratio: Optional[Decimal] = attr.ib(default=None)
+    update_at: Optional[datetime] = attr.ib(default=None)
 
     @classmethod
     def from_api(
@@ -1180,13 +1199,25 @@ class Pool:
         locked_until: Optional[Union[int, str, float]] = None,
         health_rate: Optional[Union[float, str]] = None,
         items: List[BalanceItem],
+        detail_types: Optional[List[str]] = None,
+        asset_usd_value: Union[float, str] = 0,
+        debt_usd_value: Union[float, str] = 0,
+        net_usd_value: Union[float, str] = 0,
+        debt_ratio: Optional[Union[float, str]] = None,
+        update_at: Optional[Union[int, str, float]] = None,
     ) -> 'Pool':
         return cls(
             pool_info=pool_info,
             protocol=protocol,
             items=items,
             locked_until=(parse_dt(locked_until) if locked_until is not None else None),
-            health_rate=to_decimal(health_rate) if health_rate is not None else None,
+            health_rate=_normalize_health_rate(health_rate),
+            detail_types=detail_types or [],
+            asset_usd_value=to_decimal(asset_usd_value),
+            debt_usd_value=to_decimal(debt_usd_value),
+            net_usd_value=to_decimal(net_usd_value),
+            debt_ratio=to_decimal(debt_ratio) if debt_ratio is not None else None,
+            update_at=(parse_dt(update_at) if update_at is not None else None),
         )
 
     def append_items(self, items: List[BalanceItem]) -> None:

{blockapi-2.5.6 → blockapi-2.6.0}/blockapi.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: blockapi
-Version: 2.5.6
+Version: 2.6.0
 Summary: BlockAPI library
 Home-page: https://github.com/crypkit/blockapi
 Author: Devmons s.r.o.

{blockapi-2.5.6 → blockapi-2.6.0}/blockapi.egg-info/SOURCES.txt

@@ -26,6 +26,7 @@ blockapi/test/v2/test_models.py
 blockapi/test/v2/api/__init__.py
 blockapi/test/v2/api/conftest.py
 blockapi/test/v2/api/fake_sleep_provider.py
+blockapi/test/v2/api/test_bitaps_ltc.py
 blockapi/test/v2/api/test_blockchain_info.py
 blockapi/test/v2/api/test_blockchainos.py
 blockapi/test/v2/api/test_blockchair_btc.py
@@ -34,6 +35,7 @@ blockapi/test/v2/api/test_blockchair_ltc.py
 blockapi/test/v2/api/test_cosmos.py
 blockapi/test/v2/api/test_ethplorer.py
 blockapi/test/v2/api/test_haskoin.py
+blockapi/test/v2/api/test_litecoinspace.py
 blockapi/test/v2/api/test_multisources.py
 blockapi/test/v2/api/test_optimistic_etherscan.py
 blockapi/test/v2/api/test_solana.py
@@ -65,6 +67,7 @@ blockapi/v2/coin_mapping.py
 blockapi/v2/coins.py
 blockapi/v2/models.py
 blockapi/v2/api/__init__.py
+blockapi/v2/api/bitaps.py
 blockapi/v2/api/blockchain_info.py
 blockapi/v2/api/blockchainos.py
 blockapi/v2/api/blockchair.py
@@ -73,6 +76,7 @@ blockapi/v2/api/debank.py
 blockapi/v2/api/debank_maps.py
 blockapi/v2/api/ethplorer.py
 blockapi/v2/api/haskoin.py
+blockapi/v2/api/litecoinspace.py
 blockapi/v2/api/optimistic_etherscan.py
 blockapi/v2/api/solana.py
 blockapi/v2/api/subscan.py

{blockapi-2.5.6 → blockapi-2.6.0}/setup.py

@@ -6,7 +6,7 @@ with open("README.md", "r") as f:
 
 PACKAGES = find_packages(where='.')
 
-__version__ = "2.5.6"
+__version__ = "2.6.0"
 
 setuptools.setup(
     name='blockapi',