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

{cryptochief_crypto_processing_python-0.1.0 → cryptochief_crypto_processing_python-0.4.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.4.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
@@ -121,11 +121,12 @@ Both credentials come from the Dashboard -> Project.
 | TON contract calls (Jetton / NFT / text) | `client.transactions` | `jetton_transfer`, `nft_transfer`, `send_ton_comment`, `sign_ton_call` |
 | Accept incoming payments | `client.pay_ins` | `create`, `select_asset`, `reset_asset`, `cancel`, `info`, `history`, `wait_for` |
 | Wallet management + RSA decrypt | `client.wallets` | `generate`, `list`, `info`, `freeze`, `decrypt_private_key` |
-| Treasury sweeps | `client.sweeps` | `force`, `history`, `wallet_history` |
+| Treasury sweeps | `client.sweeps` | `force`, `history`, `wallet_history`, `settings`, `update_settings` |
 | Withdrawals (read-only) | `client.withdrawals` | `info`, `history` |
 | 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)
 
@@ -334,6 +335,39 @@ priv = client.wallets.decrypt_private_key(wallet.private_key_encrypted)
 - **How do I do a crypto swap?** A swap is a payout with `auto_convert=True`.
 - **How do I call a smart contract?** `client.transactions.sign_evm_call` /
   `sign_anchor_call` / `jetton_transfer`, then `transactions.execute`.
+- **How do I control when a deposit wallet is swept?**
+  `client.sweeps.settings(...)` reads the policy in force for one wallet and
+  `client.sweeps.update_settings(...)` changes it - sweep on arrival
+  (`SweepPolicyMode.MOMENTUM`), sweep once the balance reaches an amount
+  (`SweepPolicyMode.THRESHOLD` plus `threshold_amount_usd`), or never on its own
+  (`SweepPolicyMode.OFF`, force still works). The read comes back in three
+  layers - what will happen, what this wallet overrides, and what it inherits
+  from the project - so a value of your own is distinguishable from an inherited
+  one:
+
+  ```python
+  s = await client.sweeps.update_settings(
+      deposit_address,
+      type_work=SweepPolicyMode.THRESHOLD,
+      threshold_amount_usd="250",
+  )
+  # s.effective is the resolved policy; s.effective.source names the layer it came from.
+  ```
+
+  Inheritance is per field: overriding the mode leaves the fee mode inherited.
+  To stop overriding a field, pass `CLEAR` - `None` already means "leave this
+  field alone", so it cannot also mean "reset it".
+- **How do I know a sweep actually settled?** Check `status`.
+  `SweepStatus.BROADCASTED` means the transaction is out and not yet confirmed;
+  `SweepStatus.COMPLETED` means confirmed, with `sweep_confirmations` and
+  `completed_at` filled in. Earlier platform versions reported `completed` at
+  broadcast, so a sweep could read as settled while its transaction was still
+  unconfirmed.
+- **How do I keep test payments off real chains?** Set `environment` on
+  `CreatePayInRequest` to `Environment.TESTNET` or `Environment.MAINNET`. It
+  constrains the asset the platform picks when you have not named a concrete
+  network - fiat mode and `ANY` - so an unconstrained pick cannot put a real
+  payment on a test chain. Omit it to use the project's default.
 
 ## Documentation
 

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

@@ -82,11 +82,12 @@ Both credentials come from the Dashboard -> Project.
 | TON contract calls (Jetton / NFT / text) | `client.transactions` | `jetton_transfer`, `nft_transfer`, `send_ton_comment`, `sign_ton_call` |
 | Accept incoming payments | `client.pay_ins` | `create`, `select_asset`, `reset_asset`, `cancel`, `info`, `history`, `wait_for` |
 | Wallet management + RSA decrypt | `client.wallets` | `generate`, `list`, `info`, `freeze`, `decrypt_private_key` |
-| Treasury sweeps | `client.sweeps` | `force`, `history`, `wallet_history` |
+| Treasury sweeps | `client.sweeps` | `force`, `history`, `wallet_history`, `settings`, `update_settings` |
 | Withdrawals (read-only) | `client.withdrawals` | `info`, `history` |
 | 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)
 
@@ -295,6 +296,39 @@ priv = client.wallets.decrypt_private_key(wallet.private_key_encrypted)
 - **How do I do a crypto swap?** A swap is a payout with `auto_convert=True`.
 - **How do I call a smart contract?** `client.transactions.sign_evm_call` /
   `sign_anchor_call` / `jetton_transfer`, then `transactions.execute`.
+- **How do I control when a deposit wallet is swept?**
+  `client.sweeps.settings(...)` reads the policy in force for one wallet and
+  `client.sweeps.update_settings(...)` changes it - sweep on arrival
+  (`SweepPolicyMode.MOMENTUM`), sweep once the balance reaches an amount
+  (`SweepPolicyMode.THRESHOLD` plus `threshold_amount_usd`), or never on its own
+  (`SweepPolicyMode.OFF`, force still works). The read comes back in three
+  layers - what will happen, what this wallet overrides, and what it inherits
+  from the project - so a value of your own is distinguishable from an inherited
+  one:
+
+  ```python
+  s = await client.sweeps.update_settings(
+      deposit_address,
+      type_work=SweepPolicyMode.THRESHOLD,
+      threshold_amount_usd="250",
+  )
+  # s.effective is the resolved policy; s.effective.source names the layer it came from.
+  ```
+
+  Inheritance is per field: overriding the mode leaves the fee mode inherited.
+  To stop overriding a field, pass `CLEAR` - `None` already means "leave this
+  field alone", so it cannot also mean "reset it".
+- **How do I know a sweep actually settled?** Check `status`.
+  `SweepStatus.BROADCASTED` means the transaction is out and not yet confirmed;
+  `SweepStatus.COMPLETED` means confirmed, with `sweep_confirmations` and
+  `completed_at` filled in. Earlier platform versions reported `completed` at
+  broadcast, so a sweep could read as settled while its transaction was still
+  unconfirmed.
+- **How do I keep test payments off real chains?** Set `environment` on
+  `CreatePayInRequest` to `Environment.TESTNET` or `Environment.MAINNET`. It
+  constrains the asset the platform picks when you have not named a concrete
+  network - fiat mode and `ANY` - so an unconstrained pick cannot put a real
+  payment on a test chain. Omit it to use the project's default.
 
 ## Documentation
 

{cryptochief_crypto_processing_python-0.1.0 → cryptochief_crypto_processing_python-0.4.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.4.0}/src/cryptochief/__init__.py

@@ -75,10 +75,12 @@ 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,
     CreatePayInRequest,
+    Environment,
     PayIn,
     PayInHistoryResponse,
     PayInMode,
@@ -109,13 +111,20 @@ from .services.static_deposits import (
     StaticDepositsService,
     StaticDepositStatus,
 )
+from .sentinels import CLEAR, Clear
 from .services.sweeps import (
     ForceSweepResponse,
     Sweep,
+    SweepFeeMode,
     SweepHistoryQuery,
     SweepHistoryResponse,
     SweepMode,
+    SweepOverride,
+    SweepPolicy,
+    SweepPolicyMode,
+    SweepSettings,
     SweepsService,
+    SweepStatus,
 )
 from .services.transactions import (
     AnchorCallRequest,
@@ -170,6 +179,10 @@ from .webhook import (
 
 __all__ = [
     "__version__",
+    # Sentinels
+    "CLEAR",
+    "Clear",
+    "Environment",
     # Client
     "CryptoChiefClient",
     "VERSION",
@@ -227,6 +240,7 @@ __all__ = [
     "StaticDepositsService",
     "BlockchainService",
     "CurrenciesService",
+    "CreditsService",
     # Payout types
     "EstimatePayoutRequest",
     "ExecutePayoutRequest",
@@ -276,10 +290,16 @@ __all__ = [
     "WalletType",
     # Sweep types
     "Sweep",
+    "SweepFeeMode",
     "SweepHistoryQuery",
     "SweepHistoryResponse",
     "ForceSweepResponse",
     "SweepMode",
+    "SweepOverride",
+    "SweepPolicy",
+    "SweepPolicyMode",
+    "SweepSettings",
+    "SweepStatus",
     # Withdrawal types
     "Withdrawal",
     "WithdrawalHistoryResponse",
@@ -296,6 +316,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.4.0}/src/cryptochief/_version.py

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

{cryptochief_crypto_processing_python-0.1.0 → cryptochief_crypto_processing_python-0.4.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.4.0/src/cryptochief/sentinels.py

@@ -0,0 +1,38 @@
+"""Sentinels for values that ``None`` cannot express.
+
+Python has one "absent" value and some APIs need two. Where an argument
+distinguishes "not supplied" from "supplied as nothing", ``None`` takes the
+first meaning and a sentinel from this module takes the second.
+"""
+
+from __future__ import annotations
+
+
+class Clear:
+    """Stop overriding a field and go back to inheriting it.
+
+    Used with :meth:`cryptochief.SweepsService.update_settings`, where the API
+    expresses "inherit this again" by naming a field and sending no value for
+    it. ``None`` already means "leave this field alone", so it cannot also mean
+    "reset it".
+
+    Use the :data:`CLEAR` singleton rather than constructing this.
+    """
+
+    _instance: "Clear | None" = None
+
+    def __new__(cls) -> "Clear":
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+        return cls._instance
+
+    def __repr__(self) -> str:
+        return "CLEAR"
+
+    def __bool__(self) -> bool:
+        # Truthy: `if value:` on a CLEAR must not read as "nothing was passed".
+        return True
+
+
+#: The singleton :class:`Clear`.
+CLEAR = Clear()

cryptochief_crypto_processing_python-0.4.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))

{cryptochief_crypto_processing_python-0.1.0 → cryptochief_crypto_processing_python-0.4.0}/src/cryptochief/services/payins.py

@@ -38,12 +38,40 @@ def is_payin_terminal(status: str) -> bool:
     return status in _PAYIN_TERMINAL
 
 
+class Environment(str, Enum):
+    """The two environments an order can belong to.
+
+    A project may be allowed one or both; asking for testnet on a project that
+    does not permit it is refused with ``TESTNET_NOT_ALLOWED`` rather than
+    quietly served on mainnet, and a value that is neither is
+    ``ENVIRONMENT_INVALID`` rather than a silent fallback.
+    """
+
+    MAINNET = "mainnet"
+    TESTNET = "testnet"
+
+
 @dataclass(kw_only=True)
 class CreatePayInRequest:
     order_id: str
     user_id: str
     mode: str
     to_address: Optional[str] = None
+    #: Pin the transit deposit wallet of THIS order to the given master wallet of
+    #: the project - the address the funds are swept to. The order's
+    #: asset/network chain family must match the master wallet's; a foreign or
+    #: mismatched address is rejected with 400. Omit for the project-default
+    #: behaviour.
+    master_wallet_address: Optional[str] = None
+    #: Constrain the asset the platform PICKS for this order to the real chains
+    #: or the test ones - ``Environment.MAINNET`` or ``Environment.TESTNET``.
+    #: Omit to use the project's own default.
+    #:
+    #: It changes nothing when ``asset`` names a concrete network - that is the
+    #: caller's choice. It matters in fiat mode and when the network is ``ANY``,
+    #: where the platform selects the asset and an unconstrained pick could put
+    #: a real payment on a test network.
+    environment: Optional[str] = None
     lifetime_sec: Optional[int] = None
     url_callback: Optional[str] = None
     url_success: Optional[str] = None
@@ -105,6 +133,10 @@ class SelectAssetRequest:
     uuid: str
     coin: str
     network: str
+    #: Pin the order's transit deposit wallet to the given project master
+    #: wallet; see :class:`CreatePayInRequest`. A value here overrides one
+    #: supplied at order create.
+    master_wallet_address: Optional[str] = None
 
 
 class PayInsService(BaseService):

cryptochief_crypto_processing_python-0.4.0/src/cryptochief/services/sweeps.py

@@ -0,0 +1,282 @@
+"""Treasury sweeps (transit -> master)."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from enum import Enum
+from typing import Any, List, Optional, Union
+
+from .._models import from_dict
+from ..sentinels import Clear
+from ..pagination import HistoryMeta
+from .base import BaseService
+
+
+class SweepMode(str, Enum):
+    AUTO = "auto"
+    FORCE = "force"
+
+
+@dataclass(kw_only=True)
+class SweepHistoryQuery:
+    mode: Optional[str] = None
+    page: Optional[int] = None
+    page_size: Optional[int] = None
+
+
+class SweepStatus(str, Enum):
+    """A sweep is broadcast first and confirmed after.
+
+    ``BROADCASTED`` means the transaction is out and not yet confirmed;
+    ``COMPLETED`` means the chain confirmed it. The platform used to report
+    ``completed`` at broadcast, so a sweep could read as settled while its
+    transaction was still unconfirmed or had been dropped.
+
+    ``SKIPPED`` is a sweep the platform decided against - almost always a
+    balance below the wallet's threshold. A normal outcome, not a failure.
+    """
+
+    PENDING = "pending"
+    WAITING_GAS = "waiting_gas"
+    BROADCASTED = "broadcasted"
+    COMPLETED = "completed"
+    FAILED = "failed"
+    SKIPPED = "skipped"
+
+
+class SweepPolicyMode(str, Enum):
+    """Auto-sweep modes.
+
+    ``OFF`` is never swept on its own (:meth:`SweepsService.force` still works),
+    ``MOMENTUM`` sweeps as soon as funds arrive, and ``THRESHOLD`` sweeps once
+    the balance reaches ``threshold_amount_usd``. A held balance is re-checked
+    periodically, so a wallet that crosses the threshold through price movement
+    alone is still swept.
+    """
+
+    OFF = "turned_off"
+    MOMENTUM = "momentum"
+    THRESHOLD = "threshold"
+
+
+class SweepFeeMode(str, Enum):
+    """Who pays the gas for a sweep.
+
+    ``CLIENT`` takes it from the swept wallet, ``SERVICE`` from the platform's
+    service wallet, and ``MIX`` funds the gas from the service wallet and
+    reclaims the cost from the sweep.
+    """
+
+    CLIENT = "client"
+    SERVICE = "service"
+    MIX = "mix"
+
+
+@dataclass(kw_only=True)
+class Sweep:
+    task_id: str = ""
+    status: str = ""
+    sweep_tx_hash: Optional[str] = None
+    gas_pump_tx_hash: Optional[str] = None
+    wallet_address: Optional[str] = None
+    chain: Optional[str] = None
+    chain_family: Optional[str] = None
+    asset_symbol: Optional[str] = None
+    asset_type: Optional[str] = None
+    amount_human: Optional[str] = None
+    #: What triggered this sweep: momentum, threshold or force.
+    type_work: Optional[str] = None
+
+    #: Confirmations seen on the sweep transaction, and when it reached the
+    #: network's confirmation target. Read them with ``status``:
+    #: ``completed_at`` is absent while the sweep is still in flight.
+    sweep_confirmations: Optional[int] = None
+    completed_at: Optional[str] = None
+
+    #: Fees. ``total_fee_usd`` is the whole cost of the sweep; the gas-pump half
+    #: is the funding transfer that pays for it on chains needing one. The
+    #: ``real_*`` figures are what the chain actually charged, filled in once the
+    #: transaction settles; the others are the estimate made up front.
+    total_fee_usd: Optional[str] = None
+    gas_pump_source: Optional[str] = None
+    gas_pump_fee_human: Optional[str] = None
+    gas_pump_fee_usd: Optional[str] = None
+    sweep_fee_human: Optional[str] = None
+    sweep_fee_usd: Optional[str] = None
+    real_gas_pump_fee_human: Optional[str] = None
+    real_gas_pump_fee_usd: Optional[str] = None
+    real_sweep_fee_human: Optional[str] = None
+    real_sweep_fee_usd: Optional[str] = None
+
+    created_at: Optional[str] = None
+
+    #: Deprecated: never populated. The API reports fees under the names above;
+    #: these were guesses at a shape it does not send.
+    gas_fee_human: Optional[str] = None
+    gas_fee_fiat: Optional[str] = None
+    service_fee_fiat: Optional[str] = None
+    #: Deprecated: never populated - sweeps carry ``created_at`` and
+    #: ``completed_at``.
+    updated_at: Optional[str] = None
+
+
+@dataclass(kw_only=True)
+class SweepPolicy:
+    """A resolved set of sweep rules."""
+
+    type_work: str = ""
+    #: Meaningful only when ``type_work`` is ``threshold``.
+    threshold_amount_usd: Optional[str] = None
+    fee_mode: str = ""
+    #: Which layer the mode came from: ``wallet_network``, ``wallet``,
+    #: ``project`` or ``default``. Present on the effective policy, where the
+    #: question arises.
+    source: Optional[str] = None
+
+
+@dataclass(kw_only=True)
+class SweepOverride:
+    """What one wallet decides for itself.
+
+    A field of ``None`` is not overridden - it is inherited, which no ordinary
+    value can express.
+    """
+
+    #: Empty covers the address on every network it exists on; set, it covers
+    #: that one network and takes precedence over the address-wide override.
+    network_code: Optional[str] = None
+    type_work: Optional[str] = None
+    threshold_amount_usd: Optional[str] = None
+    fee_mode: Optional[str] = None
+    #: Who wrote it: ``merchant`` or ``operator``.
+    source: Optional[str] = None
+    #: An operator pinned this policy. While it is set, a merchant write answers
+    #: ``SWEEP_SETTINGS_LOCKED`` and changes nothing.
+    locked: bool = False
+
+
+@dataclass(kw_only=True)
+class SweepSettings:
+    """Three layers, on purpose.
+
+    ``effective`` is what will actually happen, ``override`` is what this wallet
+    decides for itself (``None`` if it decides nothing), and ``project_default``
+    is what it falls back to. Only the three together answer "is this value mine
+    or inherited" - the difference between changing it here and changing it on
+    the project. Inheritance is per field: a wallet can override the mode and
+    keep inheriting the fee mode.
+    """
+
+    wallet_address: Optional[str] = None
+    network_code: Optional[str] = None
+    effective: Optional[SweepPolicy] = None
+    override: Optional[SweepOverride] = None
+    project_default: Optional[SweepPolicy] = None
+
+
+@dataclass(kw_only=True)
+class SweepHistoryResponse:
+    items: Optional[List[Sweep]] = None
+    meta: Optional[HistoryMeta] = None
+
+
+@dataclass(kw_only=True)
+class ForceSweepResponse:
+    status: str = ""
+
+
+class SweepsService(BaseService):
+    async def force(self, address: str, network: str) -> ForceSweepResponse:
+        """Trigger an immediate transit->master sweep for one address.
+
+        The status acknowledges acceptance; the resulting :class:`Sweep` record
+        appears via :meth:`wallet_history` once the on-chain tx is built.
+        """
+        return from_dict(
+            ForceSweepResponse,
+            await self._post("/v1/sweeps/force", {"address": address, "network_code": network}),
+        )
+
+    async def history(self, query: Optional[SweepHistoryQuery] = None) -> SweepHistoryResponse:
+        """Recent sweeps across the whole project."""
+        return from_dict(
+            SweepHistoryResponse, await self._post("/v1/sweeps/history", query or SweepHistoryQuery())
+        )
+
+    async def wallet_history(
+        self, address: str, query: Optional[SweepHistoryQuery] = None
+    ) -> SweepHistoryResponse:
+        """Recent sweeps scoped to one wallet."""
+        body: dict[str, Any] = {"address": address}
+        if query is not None:
+            if query.mode is not None:
+                body["mode"] = query.mode
+            if query.page is not None:
+                body["page"] = query.page
+            if query.page_size is not None:
+                body["page_size"] = query.page_size
+        return from_dict(SweepHistoryResponse, await self._post("/v1/sweeps/wallet/history", body))
+
+    async def settings(
+        self, address: Optional[str] = None, network_code: Optional[str] = None
+    ) -> SweepSettings:
+        """The auto-sweep policy in force for one wallet.
+
+        Returns what will happen, what the wallet overrides, and what it
+        inherits. Omitting ``address`` asks for the project's own default rather
+        than any wallet's policy.
+
+        Scoped to the caller's own wallets: an address that is not the project's
+        answers ``WALLET_NOT_FOUND``.
+        """
+        body: dict[str, Any] = {}
+        if address:
+            body["address"] = address
+        if network_code:
+            body["network_code"] = network_code
+        return from_dict(SweepSettings, await self._post("/v1/sweeps/settings", body))
+
+    async def update_settings(
+        self,
+        address: str,
+        *,
+        network_code: Optional[str] = None,
+        type_work: Union[str, Clear, None] = None,
+        threshold_amount_usd: Union[str, Clear, None] = None,
+        fee_mode: Union[str, Clear, None] = None,
+    ) -> SweepSettings:
+        """Write a wallet's auto-sweep policy.
+
+        Returns the settings as they stand afterwards, so the caller sees what
+        the write resolved to without asking again.
+
+        ``None`` leaves a field alone. :data:`~cryptochief.CLEAR` stops
+        overriding it and goes back to inheriting - the only way to drop one
+        field while keeping the others. The API expresses that by naming the
+        field with no value, which ``None`` cannot say in Python because it
+        already means "not supplied".
+
+        Refusals are named: ``TYPE_WORK_INVALID``, ``FEE_MODE_INVALID``,
+        ``THRESHOLD_INVALID``, ``THRESHOLD_MUST_BE_POSITIVE``,
+        ``THRESHOLD_REQUIRED_FOR_THRESHOLD_MODE``, and
+        ``SWEEP_SETTINGS_LOCKED`` when an operator has pinned the policy.
+        """
+        body: dict[str, Any] = {"address": address}
+        if network_code:
+            body["network_code"] = network_code
+
+        fields: List[str] = []
+        for name, value in (
+            ("type_work", type_work),
+            ("threshold_amount_usd", threshold_amount_usd),
+            ("fee_mode", fee_mode),
+        ):
+            if value is None:
+                continue
+            fields.append(name)
+            if not isinstance(value, Clear):
+                body[name] = value.value if isinstance(value, Enum) else value
+        if fields:
+            body["fields"] = fields
+
+        return from_dict(SweepSettings, await self._post("/v1/sweeps/settings/update", body))

cryptochief_crypto_processing_python-0.1.0/src/cryptochief/services/sweeps.py

@@ -1,85 +0,0 @@
-"""Treasury sweeps (transit -> master)."""
-
-from __future__ import annotations
-
-from dataclasses import dataclass
-from enum import Enum
-from typing import Any, List, Optional
-
-from .._models import from_dict
-from ..pagination import HistoryMeta
-from .base import BaseService
-
-
-class SweepMode(str, Enum):
-    AUTO = "auto"
-    FORCE = "force"
-
-
-@dataclass(kw_only=True)
-class SweepHistoryQuery:
-    mode: Optional[str] = None
-    page: Optional[int] = None
-    page_size: Optional[int] = None
-
-
-@dataclass(kw_only=True)
-class Sweep:
-    task_id: str = ""
-    status: str = ""
-    sweep_tx_hash: Optional[str] = None
-    wallet_address: Optional[str] = None
-    chain: Optional[str] = None
-    chain_family: Optional[str] = None
-    asset_symbol: Optional[str] = None
-    asset_type: Optional[str] = None
-    amount_human: Optional[str] = None
-    gas_fee_human: Optional[str] = None
-    gas_fee_fiat: Optional[str] = None
-    service_fee_fiat: Optional[str] = None
-    created_at: Optional[str] = None
-    updated_at: Optional[str] = None
-
-
-@dataclass(kw_only=True)
-class SweepHistoryResponse:
-    items: Optional[List[Sweep]] = None
-    meta: Optional[HistoryMeta] = None
-
-
-@dataclass(kw_only=True)
-class ForceSweepResponse:
-    status: str = ""
-
-
-class SweepsService(BaseService):
-    async def force(self, address: str, network: str) -> ForceSweepResponse:
-        """Trigger an immediate transit->master sweep for one address.
-
-        The status acknowledges acceptance; the resulting :class:`Sweep` record
-        appears via :meth:`wallet_history` once the on-chain tx is built.
-        """
-        return from_dict(
-            ForceSweepResponse,
-            await self._post("/v1/sweeps/force", {"address": address, "network_code": network}),
-        )
-
-    async def history(self, query: Optional[SweepHistoryQuery] = None) -> SweepHistoryResponse:
-        """Recent sweeps across the whole project."""
-        return from_dict(
-            SweepHistoryResponse, await self._post("/v1/sweeps/history", query or SweepHistoryQuery())
-        )
-
-    async def wallet_history(
-        self, address: str, query: Optional[SweepHistoryQuery] = None
-    ) -> SweepHistoryResponse:
-        """Recent sweeps scoped to one wallet."""
-        body: dict[str, Any] = {"address": address}
-        if query is not None:
-            if query.mode is not None:
-                body["mode"] = query.mode
-            if query.page is not None:
-                body["page"] = query.page
-            if query.page_size is not None:
-                body["page_size"] = query.page_size
-        return from_dict(SweepHistoryResponse, await self._post("/v1/sweeps/wallet/history", body))