reconify-python 2.0.0__py3-none-any.whl → 2.2.0__py3-none-any.whl

reconify/__init__.py

@@ -1,6 +1,6 @@
 """Typed clients for the Reconify Public API."""
 
-__version__ = "1.0.0"
+__version__ = "2.2.0"
 
 from .client import AsyncReconify, Reconify
 from .errors import (

reconify/client.py

@@ -17,11 +17,13 @@ from .resources import (
     AsyncIngestion,
     AsyncIssues,
     AsyncMetadata,
+    AsyncOnchain,
     AsyncOrganization,
     Events,
     Ingestion,
     Issues,
     Metadata,
+    Onchain,
     Organization,
 )
 from .transport import AsyncTransport, RetryConfig, SyncTransport
@@ -51,6 +53,7 @@ class Reconify:
     ingestion: Ingestion
     issues: Issues
     organization: Organization
+    onchain: Onchain
 
     def __init__(
         self,
@@ -108,6 +111,7 @@ class AsyncReconify:
     ingestion: AsyncIngestion
     issues: AsyncIssues
     organization: AsyncOrganization
+    onchain: AsyncOnchain
 
     def __init__(
         self,

reconify/models.py

@@ -36,6 +36,7 @@ class Flow(TolerantStrEnum):
     PAYMENT_TO_ORDER = "payment_to_order"
     WALLET_TO_WALLET = "wallet_to_wallet"
     WALLET_TO_PAYOUT = "wallet_to_payout"
+    PROVIDER_TO_SETTLEMENT_ACCOUNT = "provider_to_settlement_account"
 
 
 class EventType(TolerantStrEnum):
@@ -49,6 +50,13 @@ class EventType(TolerantStrEnum):
     WALLET_CREDITED = "wallet.credited"
     WALLET_DEBITED = "wallet.debited"
     WALLET_REFUNDED = "wallet.refunded"
+    SETTLEMENT_ALLOCATIONS_RECORDED = "settlement.allocations_recorded"
+    SETTLEMENT_CREATED = "settlement.created"
+    SETTLEMENT_DISBURSED = "settlement.disbursed"
+    SETTLEMENT_FAILED = "settlement.failed"
+    SETTLEMENT_FINALIZED = "settlement.finalized"
+    SETTLEMENT_RECEIVED = "settlement.received"
+    SETTLEMENT_REVISED = "settlement.revised"
 
 
 class EntityType(TolerantStrEnum):
@@ -102,6 +110,44 @@ class MonitoringErrorCode(TolerantStrEnum):
     MALFORMED_REQUEST = "malformed_request"
 
 
+class OnchainSourceKind(TolerantStrEnum):
+    PROVIDER_PAYMENT = "provider_payment"
+    TRANSACTION = "transaction"
+    ADDRESS_REFERENCE = "address_reference"
+
+
+class OnchainNetwork(TolerantStrEnum):
+    ETHEREUM_MAINNET = "ethereum-mainnet"
+    ETHEREUM_SEPOLIA = "ethereum-sepolia"
+    SOLANA_MAINNET = "solana-mainnet"
+    SOLANA_DEVNET = "solana-devnet"
+
+
+class OnchainSourceStatus(TolerantStrEnum):
+    QUEUED = "queued"
+
+
+class FinancialComponentKind(TolerantStrEnum):
+    FEE = "fee"
+    COMMISSION = "commission"
+    TAX = "tax"
+    RESERVE = "reserve"
+    ADJUSTMENT = "adjustment"
+    OTHER = "other"
+
+
+class FinancialComponentEffect(TolerantStrEnum):
+    ADD = "add"
+    DEDUCT = "deduct"
+    INCLUDED = "included"
+
+
+class SettlementAllocationType(TolerantStrEnum):
+    PAYMENT = "payment"
+    REFUND = "refund"
+    CHARGEBACK = "chargeback"
+
+
 class APIInfo(ResponseModel):
     name: str
     version: str
@@ -113,6 +159,31 @@ class Health(ResponseModel):
     status: str
 
 
+class FinancialComponent(RequestModel):
+    amount: str
+    kind: FinancialComponentKind
+    effect: FinancialComponentEffect
+    description: str | None = None
+    provider_type: str | None = None
+    reference: str | None = None
+    metadata: dict[str, str | int | float | bool] | None = None
+
+
+class FinancialBreakdown(RequestModel):
+    gross: str
+    net: str
+    components: list[FinancialComponent] = Field(max_length=100)
+
+
+class SettlementAllocation(RequestModel):
+    allocation_id: str
+    allocation_type: SettlementAllocationType
+    flow: str
+    reference: str
+    amount: str
+    event_id: str | None = None
+
+
 class MonitoringEventData(RequestModel):
     provider: str | None = None
     integration_ref: str | None = None
@@ -121,6 +192,8 @@ class MonitoringEventData(RequestModel):
     failure_code: str | None = None
     failure_message: str | None = None
     retryable: bool | None = None
+    revises_event_id: str | None = None
+    allocations: list[SettlementAllocation] | None = Field(default=None, max_length=500)
 
 
 class MonitoringEvent(RequestModel):
@@ -131,8 +204,11 @@ class MonitoringEvent(RequestModel):
     entity_id: str
     occurred_at: datetime | None = None
     amount: str | None = None
+    correlation_id: str | None = None
+    causation_id: str | None = None
     currency: str | None = None
     data: MonitoringEventData | None = None
+    financial_breakdown: FinancialBreakdown | None = None
     metadata: dict[str, str | int | float | bool] | None = None
 
 
@@ -171,8 +247,17 @@ class Event(ResponseModel):
     received_at: datetime
     amount: str | None = None
     currency: str | None = None
+    causation_id: str | None = None
+    correlation_id: str | None = None
+    revises_event_id: str | None = None
     provider: str | None = None
     status: ReceiptStatus
+    gross: str | None = None
+    net: str | None = None
+    component_count: int | None = None
+    allocation_count: int | None = None
+    financial_breakdown: FinancialBreakdown | None = None
+    allocations: list[SettlementAllocation] | None = None
 
 
 class ListEventsResponse(ResponseModel):
@@ -243,5 +328,31 @@ class Error(ResponseModel):
     detail: str | None = None
 
 
+class OnchainSourceLocator(RequestModel):
+    integration_ref: str | None = None
+    network: OnchainNetwork | None = None
+    protocol_reference: str | None = None
+    provider_reference: str | None = None
+    provider_transaction_id: str | None = None
+    receiving_address: str | None = None
+    transaction_reference: str | None = None
+    window_end: datetime | None = None
+    window_start: datetime | None = None
+
+
+class OnchainSourceRequest(RequestModel):
+    flow: str
+    operation_reference: str = Field(min_length=1, max_length=256)
+    source_event_id: str = Field(min_length=1, max_length=256)
+    kind: OnchainSourceKind
+    locator: OnchainSourceLocator
+
+
+class OnchainSourceResponse(ResponseModel):
+    id: str
+    status: OnchainSourceStatus
+    duplicate: bool
+
+
 def model_dump(model: BaseModel) -> dict[str, Any]:
     return model.model_dump(mode="json", by_alias=True, exclude_none=True, exclude_unset=True)

reconify/resources/__init__.py

@@ -4,6 +4,7 @@ from .events import AsyncEvents, Events
 from .ingestion import AsyncIngestion, Ingestion
 from .issues import AsyncIssues, Issues
 from .metadata import AsyncMetadata, Metadata
+from .onchain import AsyncOnchain, Onchain
 from .organization import AsyncOrganization, Organization
 
 SYNC_RESOURCE_CLASSES = {
@@ -12,6 +13,7 @@ SYNC_RESOURCE_CLASSES = {
     "ingestion": Ingestion,
     "issues": Issues,
     "organization": Organization,
+    "onchain": Onchain,
 }
 ASYNC_RESOURCE_CLASSES = {
     "metadata": AsyncMetadata,
@@ -19,6 +21,7 @@ ASYNC_RESOURCE_CLASSES = {
     "ingestion": AsyncIngestion,
     "issues": AsyncIssues,
     "organization": AsyncOrganization,
+    "onchain": AsyncOnchain,
 }
 
 OPERATION_SPECS = {
@@ -35,6 +38,7 @@ OPERATION_SPECS = {
     "issues_add_note": ("issues", "POST", "/issues/{issue_id}/notes"),
     "organization_get": ("organization", "GET", "/organization"),
     "organization_list_members": ("organization", "GET", "/organization/members"),
+    "register-onchain-source": ("onchain", "POST", "/onchain-sources"),
 }
 
 OPERATION_METHODS = {
@@ -51,6 +55,7 @@ OPERATION_METHODS = {
     "issues_add_note": "add_issue_note",
     "organization_get": "get_organization",
     "organization_list_members": "list_organization_members",
+    "register-onchain-source": "register_onchain_source",
 }
 
 __all__ = [
@@ -59,11 +64,13 @@ __all__ = [
     "AsyncIssues",
     "AsyncMetadata",
     "AsyncOrganization",
+    "AsyncOnchain",
     "Events",
     "Ingestion",
     "Issues",
     "Metadata",
     "Organization",
+    "Onchain",
     "ASYNC_RESOURCE_CLASSES",
     "OPERATION_SPECS",
     "OPERATION_METHODS",

reconify/resources/ingestion.py

@@ -4,13 +4,16 @@ from __future__ import annotations
 
 from typing import Any
 
-from ..models import MonitoringBatchRequest, MonitoringBatchResponse
+from ..models import MonitoringBatchRequest, MonitoringBatchResponse, MonitoringEvent
 from .base import AsyncResource, SyncResource
 
 
 class Ingestion(SyncResource):
     def ingest_monitoring_events(
-        self, body: MonitoringBatchRequest, raw: bool = False, **query: Any
+        self,
+        body: MonitoringEvent | list[MonitoringEvent] | MonitoringBatchRequest,
+        raw: bool = False,
+        **query: Any,
     ) -> Any:
         return self._request(
             "POST",
@@ -24,7 +27,10 @@ class Ingestion(SyncResource):
 
 class AsyncIngestion(AsyncResource):
     async def ingest_monitoring_events(
-        self, body: MonitoringBatchRequest, raw: bool = False, **query: Any
+        self,
+        body: MonitoringEvent | list[MonitoringEvent] | MonitoringBatchRequest,
+        raw: bool = False,
+        **query: Any,
     ) -> Any:
         return await self._request(
             "POST",

reconify/resources/onchain.py

@@ -0,0 +1,57 @@
+"""On-chain evidence source registration resource client."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from ..errors import ReconifyValidationError
+from ..models import OnchainSourceRequest, OnchainSourceResponse
+from .base import AsyncResource, SyncResource
+
+
+class Onchain(SyncResource):
+    def register_onchain_source(
+        self,
+        body: OnchainSourceRequest,
+        *,
+        idempotency_key: str,
+        raw: bool = False,
+        **query: Any,
+    ) -> Any:
+        if not idempotency_key or len(idempotency_key) > 200:
+            raise ReconifyValidationError("idempotency_key must be between 1 and 200 characters")
+        return self._request(
+            "POST",
+            "/onchain-sources",
+            params=query,
+            body=body,
+            response_model=OnchainSourceResponse,
+            raw=raw,
+            headers={"Idempotency-Key": idempotency_key},
+        )
+
+    register_source = register_onchain_source
+
+
+class AsyncOnchain(AsyncResource):
+    async def register_onchain_source(
+        self,
+        body: OnchainSourceRequest,
+        *,
+        idempotency_key: str,
+        raw: bool = False,
+        **query: Any,
+    ) -> Any:
+        if not idempotency_key or len(idempotency_key) > 200:
+            raise ReconifyValidationError("idempotency_key must be between 1 and 200 characters")
+        return await self._request(
+            "POST",
+            "/onchain-sources",
+            params=query,
+            body=body,
+            response_model=OnchainSourceResponse,
+            raw=raw,
+            headers={"Idempotency-Key": idempotency_key},
+        )
+
+    register_source = register_onchain_source

reconify/transport.py

@@ -88,6 +88,8 @@ def _validate_request_body(body: Any) -> Any:
             return model_dump(body)
         except ValidationError as exc:
             raise ReconifyValidationError(str(exc)) from exc
+    if isinstance(body, list):
+        return [_validate_request_body(item) for item in body]
     return body
 
 

{reconify_python-2.0.0.dist-info → reconify_python-2.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: reconify-python
-Version: 2.0.0
+Version: 2.2.0
 Summary: Typed Python client for the Reconify Public API
 License: MIT
 License-File: LICENSE
@@ -41,8 +41,9 @@ staging or self-hosted endpoint, and URLs with or without `/v2` are accepted.
 
 ## Public resources
 
-The client exposes metadata, events, ingestion, issues, and organization. The
-current public contract contains exactly 13 operations. Python methods use
+The client exposes metadata, events, ingestion, issues, organization, and
+on-chain evidence registration. The current public contract contains exactly
+14 operations. Python methods use
 `snake_case` names and typed Pydantic v2 models from `reconify.models`.
 
 Sync and async clients provide cursor iterators:
@@ -81,6 +82,9 @@ Generated operation IDs use stable `resource_action` identifiers while the
 Python resource methods retain their snake_case names. See
 [UPGRADING.md](UPGRADING.md).
 
+Version `2.2.0` adds settlement event fields, flexible ingestion payloads, and
+on-chain evidence source registration. See [UPGRADING.md](UPGRADING.md).
+
 ## Build and release
 
 ```sh

reconify_python-2.2.0.dist-info/RECORD

@@ -0,0 +1,19 @@
+reconify/__init__.py,sha256=jIlFYfoxffKjIh3p7xQ3yO0NridVpBDGqKuLv9MG1eA,878
+reconify/client.py,sha256=nN9PssyQxQ1NnkDe1HGRouOyctMYYgaOMQjmecWXY_o,4859
+reconify/errors.py,sha256=Dt9UVBSt34jL09AnYWRDKk0UEu70UpmDhQI_MyOzrkM,4185
+reconify/models.py,sha256=vwt476o8S6uMFF1my4K8pyFflUXP4qqoR2ZkBiIlUbk,9281
+reconify/pagination.py,sha256=pub9BQojyGVCfn5jIGJsP2JjCtONZF2LtmWnFg-Tpfw,3487
+reconify/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+reconify/transport.py,sha256=lfwwXvrxtAkXVAxRyt7qm6bIsXVKJLXuXXI98R5tkzs,10762
+reconify/resources/__init__.py,sha256=TRfdgO7cscWJZ1gl9gRL8DVdIO5ROP-pvcqpZEKJwUI,2585
+reconify/resources/base.py,sha256=qHZm6LuIPJmLTKAjj221QaWuUi0aorIa8GWeWB4qtDs,3279
+reconify/resources/events.py,sha256=Xf-udDFMHF2wPYUkK4HZcq10OTpEb5i831sG5RcP9VY,1858
+reconify/resources/ingestion.py,sha256=5UeRCnXRBkSVBGkxc7y3DUG-NHsKGw85NEEo__tQIxc,1119
+reconify/resources/issues.py,sha256=xljattrDPojWac8MGhk7fF3JAJoitwqAo6-OLABvNBo,3774
+reconify/resources/metadata.py,sha256=lhCcERUaGtCbKc6d9I3U3iClNu9oHEhxnDeqUSkRri4,904
+reconify/resources/onchain.py,sha256=GQZEPmqkBXNCYDF9a_apFK6cNl_tYbOBnSaQD1NTg9Q,1686
+reconify/resources/organization.py,sha256=dQy8Ekd51ldep6IDP1_suz64GE1WX_7dhmQUhsvgsJ0,1295
+reconify_python-2.2.0.dist-info/METADATA,sha256=N8ajFpGzQU9ISrsx45Qni1hzEwO5BXlCaCb9eKJzgWc,3220
+reconify_python-2.2.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+reconify_python-2.2.0.dist-info/licenses/LICENSE,sha256=q4Eqlx9sTPEY6DaOMuTjXAtVA7uEjxZkcvaJzcuYaIw,1065
+reconify_python-2.2.0.dist-info/RECORD,,

reconify_python-2.0.0.dist-info/RECORD

@@ -1,18 +0,0 @@
-reconify/__init__.py,sha256=JN3srG4copTiM5yf6o8npvUSMYSgWysmzAPc75XBloQ,878
-reconify/client.py,sha256=HAqFxIbDSWHu5GNOJHENlI-gV28lNjwwOO6lrMzKrFI,4781
-reconify/errors.py,sha256=Dt9UVBSt34jL09AnYWRDKk0UEu70UpmDhQI_MyOzrkM,4185
-reconify/models.py,sha256=XInYd-wUbdW2eyXnRpqLuEKKeu57ZS_bm3_bphAf9T4,5965
-reconify/pagination.py,sha256=pub9BQojyGVCfn5jIGJsP2JjCtONZF2LtmWnFg-Tpfw,3487
-reconify/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-reconify/transport.py,sha256=lU0nTvDqBhQw2YS1Y9Zusxxpagfdz87zOfaTrRrxcS4,10668
-reconify/resources/__init__.py,sha256=HXq7cpK7z074xpaBq_a63gQpCKN8OYQ8Sy45b2rYK7s,2324
-reconify/resources/base.py,sha256=qHZm6LuIPJmLTKAjj221QaWuUi0aorIa8GWeWB4qtDs,3279
-reconify/resources/events.py,sha256=Xf-udDFMHF2wPYUkK4HZcq10OTpEb5i831sG5RcP9VY,1858
-reconify/resources/ingestion.py,sha256=Azbfhq2yUb_CsCuedDRfs5U_0MSyzfrmrB1n3U2NJ6U,968
-reconify/resources/issues.py,sha256=xljattrDPojWac8MGhk7fF3JAJoitwqAo6-OLABvNBo,3774
-reconify/resources/metadata.py,sha256=lhCcERUaGtCbKc6d9I3U3iClNu9oHEhxnDeqUSkRri4,904
-reconify/resources/organization.py,sha256=dQy8Ekd51ldep6IDP1_suz64GE1WX_7dhmQUhsvgsJ0,1295
-reconify_python-2.0.0.dist-info/METADATA,sha256=kNn2bPH4L9esnRKuhXslDQyrBHjwUP2mVDw3ifLmqWw,3035
-reconify_python-2.0.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
-reconify_python-2.0.0.dist-info/licenses/LICENSE,sha256=q4Eqlx9sTPEY6DaOMuTjXAtVA7uEjxZkcvaJzcuYaIw,1065
-reconify_python-2.0.0.dist-info/RECORD,,