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

{cryptochief_crypto_processing_python-0.4.0 → cryptochief_crypto_processing_python-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: cryptochief-crypto-processing-python
-Version: 0.4.0
+Version: 0.5.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
@@ -200,6 +200,14 @@ decimal strings round-trip exactly. Discover an asset's decimals with
 
 ## Contract calls without hand-encoding
 
+> **This snippet shows the encoder, not a complete swap.** Uniswap's router
+> moves your input token with `transferFrom`, so it needs an ERC-20
+> `approve(address,uint256)` on that token first, confirmed before the swap is
+> signed — without it the swap reverts and burns the gas. And an `amountOutMin`
+> of `0` accepts whatever the pool returns, which on a public mempool hands the
+> trade to the first sandwich bot that sees it. The runnable version, with both,
+> is in `examples/`.
+
 ```python
 from cryptochief import EvmCallRequest, Erc20TransferRequest, Chain, human_to_base
 

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

@@ -161,6 +161,14 @@ decimal strings round-trip exactly. Discover an asset's decimals with
 
 ## Contract calls without hand-encoding
 
+> **This snippet shows the encoder, not a complete swap.** Uniswap's router
+> moves your input token with `transferFrom`, so it needs an ERC-20
+> `approve(address,uint256)` on that token first, confirmed before the swap is
+> signed — without it the swap reverts and burns the gas. And an `amountOutMin`
+> of `0` accepts whatever the pool returns, which on a public mempool hands the
+> trade to the first sandwich bot that sees it. The runnable version, with both,
+> is in `examples/`.
+
 ```python
 from cryptochief import EvmCallRequest, Erc20TransferRequest, Chain, human_to_base
 

{cryptochief_crypto_processing_python-0.4.0 → cryptochief_crypto_processing_python-0.5.0}/pyproject.toml

@@ -110,5 +110,5 @@ target-version = "py310"
 
 [tool.mypy]
 python_version = "3.10"
+mypy_path = "src"
 warn_unused_ignores = true
-ignore_missing_imports = true

{cryptochief_crypto_processing_python-0.4.0 → cryptochief_crypto_processing_python-0.5.0}/src/cryptochief/__init__.py

@@ -170,6 +170,8 @@ from .webhook import (
     PayInWebhookEvent,
     PayoutWebhookEvent,
     StaticDepositWebhookEvent,
+    SweepWebhookEvent,
+    SWEEP_EVENT_CONFIRMED,
     TransactionWebhookEvent,
     WebhookSignatureError,
     coerce_webhook_event,
@@ -230,6 +232,8 @@ __all__ = [
     "TransactionWebhookEvent",
     "PayInWebhookEvent",
     "StaticDepositWebhookEvent",
+    "SweepWebhookEvent",
+    "SWEEP_EVENT_CONFIRMED",
     # Services
     "PayoutsService",
     "TransactionsService",

{cryptochief_crypto_processing_python-0.4.0 → cryptochief_crypto_processing_python-0.5.0}/src/cryptochief/_version.py

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

{cryptochief_crypto_processing_python-0.4.0 → cryptochief_crypto_processing_python-0.5.0}/src/cryptochief/webhook.py

@@ -175,11 +175,75 @@ class StaticDepositWebhookEvent:
     paid_at: Optional[str] = None
 
 
+#: The only sweep event the platform emits. There is deliberately no
+#: ``sweep.broadcasted``: "we sent it" is not something you can act on, and an
+#: event that means "maybe" is one more thing to reconcile.
+SWEEP_EVENT_CONFIRMED = "sweep.confirmed"
+
+
+@dataclass(kw_only=True)
+class SweepWebhookEvent:
+    """Funds swept off a deposit wallet, confirmed on chain.
+
+    A ``static_deposit.paid`` tells you a customer paid you. This tells you the
+    money has finished moving into your own custody - until it fires, the
+    balance still sits on the deposit address. Reconciliation, treasury
+    reporting and "funds available to pay out" all key off this event, not off
+    the deposit.
+
+    Sweeps run on static deposit wallets *and* on the transit wallets issued per
+    pay-in order; both deliver here, to the callback URL configured for the
+    wallet the funds left.
+    """
+
+    event: str = ""
+    #: The sweeper task. One sweep settles once - use it as your idempotency key.
+    task_id: str = ""
+    #: Always ``"completed"``. A sweep reaches you in no other state.
+    status: str = ""
+
+    #: The wallet the funds left - the address your customer paid into.
+    wallet_address: str = ""
+    #: The master wallet they landed on.
+    to_address: Optional[str] = None
+
+    network: str = ""
+    chain_family: Optional[str] = None
+    asset_symbol: str = ""
+    asset_contract: Optional[str] = None
+    #: ``"native"`` or ``"token"``.
+    asset_type: Optional[str] = None
+    amount_raw: Optional[str] = None
+    amount_human: Optional[str] = None
+
+    sweep_tx_hash: str = ""
+    #: Set when the platform had to fund gas on the wallet before it could sweep.
+    gas_pump_tx_hash: Optional[str] = None
+
+    #: What makes this event true rather than hopeful, and never zero. It
+    #: travels with the event rather than being implied by it: "confirmed" is
+    #: not the same number on every chain, so if you run your own finality
+    #: policy you need the count to apply it.
+    sweep_confirmations: int = 0
+
+    #: When the chain was observed to hold the sweep. NOT the task's completion
+    #: timestamp, which is stamped on every terminal outcome - failures
+    #: included - and so says nothing about settlement.
+    confirmed_at: Optional[str] = None
+
+    #: What triggered it: ``"momentum"``, ``"threshold"`` or ``"force"``.
+    type_work: Optional[str] = None
+    #: What the sweep cost: network fee plus any gas or energy the platform
+    #: fronted to make it possible.
+    total_fee_usd: Optional[str] = None
+
+
 WebhookEvent = Union[
     PayoutWebhookEvent,
     TransactionWebhookEvent,
     PayInWebhookEvent,
     StaticDepositWebhookEvent,
+    SweepWebhookEvent,
     Dict[str, Any],
 ]
 
@@ -188,4 +252,5 @@ _EVENT_BY_PREFIX = {
     "transaction": TransactionWebhookEvent,
     "invoice": PayInWebhookEvent,
     "static_deposit": StaticDepositWebhookEvent,
+    "sweep": SweepWebhookEvent,
 }