cryptochief-crypto-processing-python 0.1.0__tar.gz → 0.2.0__tar.gz

{cryptochief_crypto_processing_python-0.1.0 → cryptochief_crypto_processing_python-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: cryptochief-crypto-processing-python
-Version: 0.1.0
+Version: 0.2.0
 Summary: Official async Python SDK for the Crypto Chief crypto payment gateway and crypto processing API. Accept crypto payments, send single and mass crypto payouts, sign on-chain transactions and smart-contract calls, manage wallets, convert fiat to crypto, and verify webhooks across Ethereum, BNB Smart Chain, Polygon, Tron, TON, Solana, Bitcoin, XRP and 20+ blockchains. USDT and USDC stablecoin support with int-precise amounts and asyncio/httpx.
 Project-URL: Homepage, https://crypto-chief.com/processing/
 Project-URL: Documentation, https://docs-sdk.crypto-chief.com/processing/python
@@ -34,7 +34,7 @@ Provides-Extra: dev
 Requires-Dist: mypy>=1.8; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
 Requires-Dist: pytest>=8; extra == 'dev'
-Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: ruff<0.16,>=0.4; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # Crypto Chief Python SDK - Crypto Processing API Client
@@ -126,6 +126,7 @@ Both credentials come from the Dashboard -> Project.
 | Static-deposit history | `client.static_deposits` | `info`, `history` |
 | On-chain queries | `client.blockchain` | `contracts_available`, `wallet_balance`, `transaction_status` |
 | Fiat <-> crypto rate quote | `client.currencies` | `fiat_to_crypto`, `crypto_to_fiat` |
+| Credits (billing) balance check and top-up - free of charge | `client.credits` | `balance`, `topup` |
 
 ## Accept a crypto payment (pay-in)
 

{cryptochief_crypto_processing_python-0.1.0 → cryptochief_crypto_processing_python-0.2.0}/README.md

@@ -87,6 +87,7 @@ Both credentials come from the Dashboard -> Project.
 | Static-deposit history | `client.static_deposits` | `info`, `history` |
 | On-chain queries | `client.blockchain` | `contracts_available`, `wallet_balance`, `transaction_status` |
 | Fiat <-> crypto rate quote | `client.currencies` | `fiat_to_crypto`, `crypto_to_fiat` |
+| Credits (billing) balance check and top-up - free of charge | `client.credits` | `balance`, `topup` |
 
 ## Accept a crypto payment (pay-in)
 

{cryptochief_crypto_processing_python-0.1.0 → cryptochief_crypto_processing_python-0.2.0}/pyproject.toml

@@ -82,7 +82,7 @@ dev = [
     "pytest>=8",
     "pytest-asyncio>=0.23",
     "mypy>=1.8",
-    "ruff>=0.4",
+    "ruff>=0.4,<0.16",
 ]
 
 [project.urls]

{cryptochief_crypto_processing_python-0.1.0 → cryptochief_crypto_processing_python-0.2.0}/src/cryptochief/__init__.py

@@ -75,6 +75,7 @@ from .services.blockchain import (
     TxStatusRow,
     WalletBalanceRow,
 )
+from .services.credits import CreditsBalance, CreditsService, CreditsTopup
 from .services.currencies import ConvertRequest, ConvertResponse, CurrenciesService
 from .services.payins import (
     CoinOption,
@@ -227,6 +228,7 @@ __all__ = [
     "StaticDepositsService",
     "BlockchainService",
     "CurrenciesService",
+    "CreditsService",
     # Payout types
     "EstimatePayoutRequest",
     "ExecutePayoutRequest",
@@ -296,6 +298,9 @@ __all__ = [
     # Currency types
     "ConvertRequest",
     "ConvertResponse",
+    # Credits types
+    "CreditsBalance",
+    "CreditsTopup",
     # Contract encoders
     "encode_evm_call",
     "encode_evm_call_hex",

{cryptochief_crypto_processing_python-0.1.0 → cryptochief_crypto_processing_python-0.2.0}/src/cryptochief/_version.py

@@ -1,3 +1,3 @@
 """Single source of truth for the package version."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"

{cryptochief_crypto_processing_python-0.1.0 → cryptochief_crypto_processing_python-0.2.0}/src/cryptochief/client.py

@@ -12,6 +12,7 @@ from ._version import __version__
 from .errors import CryptoChiefError, is_retryable
 from .rsa import RsaKeyNotConfiguredError, decrypt_rsa_oaep, load_rsa_private_key_pem
 from .services.blockchain import BlockchainService
+from .services.credits import CreditsService
 from .services.currencies import CurrenciesService
 from .services.payins import PayInsService
 from .services.payouts import PayoutsService
@@ -96,6 +97,7 @@ class CryptoChiefClient:
         self.static_deposits = StaticDepositsService(self)
         self.blockchain = BlockchainService(self)
         self.currencies = CurrenciesService(self)
+        self.credits = CreditsService(self)
 
     async def request(self, path: str, body: Any = None) -> Any:
         """Low-level signed POST against an API path (e.g. ``/v1/payout/estimate``).

cryptochief_crypto_processing_python-0.2.0/src/cryptochief/services/credits.py

@@ -0,0 +1,70 @@
+"""Merchant credits (billing): balance check and top-up.
+
+Both calls are billing-exempt (free of charge) - integrations can poll the
+balance or open a top-up invoice without spending a paid call. Rate-limited to
+60 req/min per project; the balance answers even at zero or negative balance.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+from .._models import from_dict
+from .base import BaseService
+
+
+@dataclass(kw_only=True)
+class CreditsBalance:
+    #: Current balance in credits (10_000_000 credits = 1 USD).
+    credits_balance: int = 0
+    #: Pre-formatted USD with 2 decimals - can be negative, e.g. ``"-1.52"``.
+    usd_balance: str = ""
+    is_postpaid: bool = False
+    #: Effective debt limit in credits (postpaid only, 0 for prepaid).
+    debt_limit_credits: int = 0
+    #: Whether gas-paying ops (``/v1/transaction/execute`` etc.) would pass the gate.
+    can_execute_gas_operations: bool = False
+    #: Minimum credits required for gas-paying operations.
+    gas_ops_min_credits: int = 0
+    timestamp: str = ""  # RFC3339
+
+
+@dataclass(kw_only=True)
+class CreditsTopup:
+    #: Billing invoice id.
+    invoice_id: int = 0
+    #: Hosted payment page (QR code, network selection, live status).
+    payment_link: str = ""
+    amount: str = ""
+    currency: str = ""
+    status: str = ""  # "pending" on creation
+    order_uuid: str = ""
+    #: Unix seconds; 0 when the server does not set an expiry.
+    expired_at: int = 0
+
+
+class CreditsService(BaseService):
+    async def balance(self) -> CreditsBalance:
+        """Current credits balance - free of charge, safe to poll before paid calls."""
+        return from_dict(CreditsBalance, await self._post("/v1/credits/balance", {}))
+
+    async def topup(
+        self,
+        *,
+        amount: str,
+        currency: str,
+        url_success: str | None = None,
+        url_error: str | None = None,
+    ) -> CreditsTopup:
+        """Open a credits top-up invoice - free of charge.
+
+        ``amount`` is a positive decimal up to 100000 (USD-pegged), ``currency``
+        is ``"USDT"`` or ``"USDC"``. Send the payer to ``payment_link``; the
+        optional urls are absolute http(s) redirects after payment.
+        """
+        body: dict[str, str] = {"amount": amount, "currency": currency}
+        if url_success is not None:
+            body["url_success"] = url_success
+        if url_error is not None:
+            body["url_error"] = url_error
+        return from_dict(CreditsTopup, await self._post("/v1/credits/topup", body))