europatech 1.0.0__tar.gz

europatech-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Europa Tech Enterprise S.R.L.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

europatech-1.0.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: europatech
+Version: 1.0.0
+Summary: Official Python SDK for the Europa Tech real estate tokenization API
+Project-URL: Homepage, https://europa-tech.org/docs/api
+Project-URL: Repository, https://github.com/europa-tech-srl/europatech-sdk-python
+Project-URL: Documentation, https://europa-tech.org/docs/api
+Author-email: "Europa Tech Enterprise S.R.L." <admin@europa-tech.org>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,europa-tech,europatech,mica,real-estate,rwa,sdk,tokenization
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# europatech
+
+Official Python SDK for the [Europa Tech](https://europa-tech.org) real estate tokenization API.
+
+## Installation
+
+```bash
+pip install europatech
+```
+
+## Quick Start
+
+```python
+from europatech import EuropaTech
+
+client = EuropaTech(api_key="your-api-key")
+
+# List available properties
+objects = client.list_objects()
+for obj in objects:
+    print(f"{obj.name}: {obj.available_shares} shares available")
+
+# Get your portfolio
+portfolio = client.get_portfolio()
+print(f"Total value: EUR {portfolio.total_value}")
+
+# Get room prices
+rooms = client.list_rooms("obj-001")
+for room in rooms:
+    print(f"{room.name}: EUR {room.share_price}/share")
+```
+
+## API Reference
+
+### Objects
+
+```python
+client.list_objects()                      # List all properties
+client.get_object("obj-001")               # Get property details
+client.list_rooms("obj-001")               # Get rooms with share prices
+```
+
+### Portfolio
+
+```python
+client.get_portfolio()                     # Your holdings
+client.list_transactions(page=1, limit=20) # Transaction history
+```
+
+### P2P Marketplace
+
+```python
+client.list_p2p()                          # Active listings
+client.create_p2p_listing(                 # Sell shares
+    object_id="obj-001",
+    room_id="room-101",
+    shares=5,
+    price_per_share=70.0,
+)
+client.cancel_p2p_listing("listing-id")    # Cancel listing
+```
+
+### Investment
+
+```python
+client.invest(                             # Buy shares
+    object_id="obj-001",
+    room_id="room-101",
+    shares=10,
+    payment_method="CARD",
+)
+```
+
+### Market & Fund
+
+```python
+client.get_market_rates()                  # EUR/USD, BTC, ETH rates
+client.get_fund()                          # AUM, distributions
+```
+
+### Compliance
+
+```python
+client.get_compliance_status()             # KYC/AML status
+```
+
+## Webhooks
+
+```python
+from europatech.webhooks import verify_webhook, parse_webhook_event
+
+# Verify signature
+is_valid = verify_webhook(request.body, request.headers["X-EuropaTech-Signature"], secret)
+
+# Parse event
+event = parse_webhook_event(request.body)
+print(event.type)  # "investment.completed"
+```
+
+## Context Manager
+
+```python
+with EuropaTech(api_key="your-key") as client:
+    objects = client.list_objects()
+```
+
+## License
+
+MIT — Europa Tech Enterprise S.R.L.

europatech-1.0.0/README.md

@@ -0,0 +1,109 @@
+# europatech
+
+Official Python SDK for the [Europa Tech](https://europa-tech.org) real estate tokenization API.
+
+## Installation
+
+```bash
+pip install europatech
+```
+
+## Quick Start
+
+```python
+from europatech import EuropaTech
+
+client = EuropaTech(api_key="your-api-key")
+
+# List available properties
+objects = client.list_objects()
+for obj in objects:
+    print(f"{obj.name}: {obj.available_shares} shares available")
+
+# Get your portfolio
+portfolio = client.get_portfolio()
+print(f"Total value: EUR {portfolio.total_value}")
+
+# Get room prices
+rooms = client.list_rooms("obj-001")
+for room in rooms:
+    print(f"{room.name}: EUR {room.share_price}/share")
+```
+
+## API Reference
+
+### Objects
+
+```python
+client.list_objects()                      # List all properties
+client.get_object("obj-001")               # Get property details
+client.list_rooms("obj-001")               # Get rooms with share prices
+```
+
+### Portfolio
+
+```python
+client.get_portfolio()                     # Your holdings
+client.list_transactions(page=1, limit=20) # Transaction history
+```
+
+### P2P Marketplace
+
+```python
+client.list_p2p()                          # Active listings
+client.create_p2p_listing(                 # Sell shares
+    object_id="obj-001",
+    room_id="room-101",
+    shares=5,
+    price_per_share=70.0,
+)
+client.cancel_p2p_listing("listing-id")    # Cancel listing
+```
+
+### Investment
+
+```python
+client.invest(                             # Buy shares
+    object_id="obj-001",
+    room_id="room-101",
+    shares=10,
+    payment_method="CARD",
+)
+```
+
+### Market & Fund
+
+```python
+client.get_market_rates()                  # EUR/USD, BTC, ETH rates
+client.get_fund()                          # AUM, distributions
+```
+
+### Compliance
+
+```python
+client.get_compliance_status()             # KYC/AML status
+```
+
+## Webhooks
+
+```python
+from europatech.webhooks import verify_webhook, parse_webhook_event
+
+# Verify signature
+is_valid = verify_webhook(request.body, request.headers["X-EuropaTech-Signature"], secret)
+
+# Parse event
+event = parse_webhook_event(request.body)
+print(event.type)  # "investment.completed"
+```
+
+## Context Manager
+
+```python
+with EuropaTech(api_key="your-key") as client:
+    objects = client.list_objects()
+```
+
+## License
+
+MIT — Europa Tech Enterprise S.R.L.

europatech-1.0.0/europatech/__init__.py

@@ -0,0 +1,34 @@
+"""Official Python SDK for the Europa Tech real estate tokenization API."""
+
+from europatech.client import EuropaTech
+from europatech.types import (
+    RealEstateObject,
+    Room,
+    Portfolio,
+    Holding,
+    Transaction,
+    P2PListing,
+    MarketRates,
+    InvestResult,
+    Fund,
+    Distribution,
+    ComplianceStatus,
+    ApiError,
+)
+
+__version__ = "1.0.0"
+__all__ = [
+    "EuropaTech",
+    "RealEstateObject",
+    "Room",
+    "Portfolio",
+    "Holding",
+    "Transaction",
+    "P2PListing",
+    "MarketRates",
+    "InvestResult",
+    "Fund",
+    "Distribution",
+    "ComplianceStatus",
+    "ApiError",
+]

europatech-1.0.0/europatech/client.py

@@ -0,0 +1,201 @@
+"""Europa Tech API client."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import httpx
+
+from europatech.types import (
+    ApiError,
+    ComplianceStatus,
+    Distribution,
+    Fund,
+    Holding,
+    InvestResult,
+    MarketRates,
+    P2PListing,
+    Portfolio,
+    RealEstateObject,
+    Room,
+    Transaction,
+)
+
+DEFAULT_BASE_URL = "https://api.europa-tech.org"
+
+
+def _to_snake(name: str) -> str:
+    """Convert camelCase to snake_case."""
+    result: list[str] = []
+    for c in name:
+        if c.isupper() and result:
+            result.append("_")
+        result.append(c.lower())
+    return "".join(result)
+
+
+def _snake_keys(data: Any) -> Any:
+    """Recursively convert dict keys from camelCase to snake_case."""
+    if isinstance(data, dict):
+        return {_to_snake(k): _snake_keys(v) for k, v in data.items()}
+    if isinstance(data, list):
+        return [_snake_keys(item) for item in data]
+    return data
+
+
+class EuropaTech:
+    """Official Europa Tech API client.
+
+    Usage::
+
+        from europatech import EuropaTech
+
+        client = EuropaTech(api_key="your-api-key")
+        objects = client.list_objects()
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = DEFAULT_BASE_URL,
+        timeout: float = 30.0,
+    ) -> None:
+        if not api_key:
+            raise ValueError("api_key is required")
+        self._client = httpx.Client(
+            base_url=base_url.rstrip("/"),
+            headers={
+                "Authorization": f"Bearer {api_key}",
+                "Content-Type": "application/json",
+                "X-SDK-Version": "python/1.0.0",
+            },
+            timeout=timeout,
+        )
+
+    def close(self) -> None:
+        """Close the HTTP client."""
+        self._client.close()
+
+    def __enter__(self) -> "EuropaTech":
+        return self
+
+    def __exit__(self, *_: Any) -> None:
+        self.close()
+
+    def _request(self, method: str, path: str, json: Any = None) -> Any:
+        resp = self._client.request(method, path, json=json)
+        if resp.status_code >= 400:
+            try:
+                body = resp.json()
+                msg = body.get("error", resp.reason_phrase)
+                code = body.get("code", "UNKNOWN_ERROR")
+            except Exception:
+                msg = resp.reason_phrase
+                code = "UNKNOWN_ERROR"
+            raise ApiError(resp.status_code, msg, code)
+        return resp.json()
+
+    # ─── Objects ──────────────────────────────────────────
+
+    def list_objects(self) -> list[RealEstateObject]:
+        """List all real estate objects."""
+        data = self._request("GET", "/api/v1/objects")["data"]
+        return [RealEstateObject(**_snake_keys(o)) for o in data]
+
+    def get_object(self, object_id: str) -> RealEstateObject:
+        """Get a single object by ID."""
+        data = self._request("GET", f"/api/v1/objects/{object_id}")["data"]
+        return RealEstateObject(**_snake_keys(data))
+
+    def list_rooms(self, object_id: str) -> list[Room]:
+        """Get rooms for an object."""
+        data = self._request("GET", f"/api/v1/objects/{object_id}/rooms")["data"]
+        return [Room(**_snake_keys(r)) for r in data]
+
+    # ─── Portfolio ────────────────────────────────────────
+
+    def get_portfolio(self) -> Portfolio:
+        """Get current user's portfolio."""
+        raw = _snake_keys(self._request("GET", "/api/v1/portfolio")["data"])
+        raw["holdings"] = [Holding(**h) for h in raw.get("holdings", [])]
+        return Portfolio(**raw)
+
+    def list_transactions(
+        self,
+        page: int = 1,
+        limit: int = 20,
+        type: Optional[str] = None,
+    ) -> list[Transaction]:
+        """List portfolio transactions."""
+        params = f"?page={page}&limit={limit}"
+        if type:
+            params += f"&type={type}"
+        data = self._request("GET", f"/api/v1/portfolio/transactions{params}")["data"]
+        return [Transaction(**_snake_keys(t)) for t in data]
+
+    # ─── P2P Marketplace ──────────────────────────────────
+
+    def list_p2p(self) -> list[P2PListing]:
+        """List P2P listings."""
+        data = self._request("GET", "/api/v1/p2p")["data"]
+        return [P2PListing(**_snake_keys(l)) for l in data]
+
+    def create_p2p_listing(
+        self,
+        object_id: str,
+        room_id: str,
+        shares: int,
+        price_per_share: float,
+    ) -> P2PListing:
+        """Create a P2P sell listing."""
+        data = self._request("POST", "/api/v1/p2p", json={
+            "objectId": object_id,
+            "roomId": room_id,
+            "shares": shares,
+            "pricePerShare": price_per_share,
+        })["data"]
+        return P2PListing(**_snake_keys(data))
+
+    def cancel_p2p_listing(self, listing_id: str) -> None:
+        """Cancel a P2P listing."""
+        self._request("DELETE", f"/api/v1/p2p/{listing_id}")
+
+    # ─── Market ───────────────────────────────────────────
+
+    def get_market_rates(self) -> MarketRates:
+        """Get current market rates."""
+        data = self._request("GET", "/api/v1/market/rates")["data"]
+        return MarketRates(**_snake_keys(data))
+
+    # ─── Investment ───────────────────────────────────────
+
+    def invest(
+        self,
+        object_id: str,
+        room_id: str,
+        shares: int,
+        payment_method: str = "CARD",
+    ) -> InvestResult:
+        """Execute a share purchase."""
+        data = self._request("POST", "/api/v1/invest", json={
+            "objectId": object_id,
+            "roomId": room_id,
+            "shares": shares,
+            "paymentMethod": payment_method,
+        })["data"]
+        return InvestResult(**_snake_keys(data))
+
+    # ─── Fund ─────────────────────────────────────────────
+
+    def get_fund(self) -> Fund:
+        """Get fund overview."""
+        raw = _snake_keys(self._request("GET", "/api/v1/fund")["data"])
+        raw["distributions"] = [Distribution(**d) for d in raw.get("distributions", [])]
+        return Fund(**raw)
+
+    # ─── Compliance ───────────────────────────────────────
+
+    def get_compliance_status(self) -> ComplianceStatus:
+        """Get current user's KYC/AML compliance status."""
+        data = self._request("GET", "/api/v1/compliance/status")["data"]
+        return ComplianceStatus(**_snake_keys(data))

europatech-1.0.0/europatech/types.py

@@ -0,0 +1,127 @@
+"""Type definitions for Europa Tech API responses."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from typing import Optional
+
+
+class ApiError(Exception):
+    """API error with status code and error code."""
+
+    def __init__(self, status: int, message: str, code: str = "UNKNOWN_ERROR") -> None:
+        super().__init__(message)
+        self.status = status
+        self.code = code
+
+
+@dataclass(frozen=True)
+class Room:
+    id: str
+    name: str
+    number: int
+    share_price: float
+    total_shares: int
+    available_shares: int
+    status: str
+
+
+@dataclass(frozen=True)
+class RealEstateObject:
+    id: str
+    name: str
+    location: str
+    image_url: str
+    status: str
+    total_shares: int
+    available_shares: int
+    rooms: list[Room] = field(default_factory=list)
+
+
+@dataclass(frozen=True)
+class Holding:
+    object_id: str
+    object_name: str
+    room_id: str
+    room_name: str
+    shares: int
+    share_price: float
+    value: float
+    purchased_at: str
+
+
+@dataclass(frozen=True)
+class Portfolio:
+    total_value: float
+    total_shares: int
+    total_invested: float
+    holdings: list[Holding] = field(default_factory=list)
+
+
+@dataclass(frozen=True)
+class Transaction:
+    id: str
+    type: str
+    object_id: str
+    room_id: str
+    shares: int
+    price_per_share: float
+    total_amount: float
+    status: str
+    created_at: str
+
+
+@dataclass(frozen=True)
+class P2PListing:
+    id: str
+    object_id: str
+    room_id: str
+    seller_id: str
+    shares: int
+    price_per_share: float
+    status: str
+    created_at: str
+
+
+@dataclass(frozen=True)
+class MarketRates:
+    eur_usd: float
+    btc_eur: float
+    eth_eur: float
+    updated_at: str
+
+
+@dataclass(frozen=True)
+class InvestResult:
+    transaction_id: str
+    status: str
+    total_amount: float
+    currency: str
+
+
+@dataclass(frozen=True)
+class Distribution:
+    month: str
+    revenue: float
+    expenses: float
+    net_profit: float
+    distributed_per_share: float
+    status: str
+
+
+@dataclass(frozen=True)
+class Fund:
+    total_aum: float
+    total_investors: int
+    total_properties: int
+    total_rooms: int
+    distributions: list[Distribution] = field(default_factory=list)
+
+
+@dataclass(frozen=True)
+class ComplianceStatus:
+    kyc_status: str
+    kyc_level: int
+    aml_status: str
+    investment_limit: float
+    invested_amount: float

europatech-1.0.0/europatech/webhooks/__init__.py

@@ -0,0 +1,77 @@
+"""Webhook verification for Europa Tech."""
+
+from __future__ import annotations
+
+import hashlib
+import hmac
+import json
+from dataclasses import dataclass
+from typing import Any, Literal
+
+
+def verify_webhook(payload: str | bytes, signature: str, secret: str) -> bool:
+    """Verify an incoming Europa Tech webhook signature (HMAC-SHA256).
+
+    Args:
+        payload: Raw request body.
+        signature: Value of the X-EuropaTech-Signature header.
+        secret: Your webhook secret from the dashboard.
+
+    Returns:
+        True if the signature is valid.
+
+    Example::
+
+        from europatech.webhooks import verify_webhook
+
+        @app.post("/webhook")
+        def handle_webhook(request):
+            sig = request.headers["X-EuropaTech-Signature"]
+            if not verify_webhook(request.body, sig, WEBHOOK_SECRET):
+                return {"error": "Invalid signature"}, 401
+            event = parse_webhook_event(request.body)
+            ...
+    """
+    if not payload or not signature or not secret:
+        return False
+
+    if isinstance(payload, str):
+        payload = payload.encode()
+
+    expected = hmac.new(secret.encode(), payload, hashlib.sha256).hexdigest()
+    sig = signature.removeprefix("sha256=")
+
+    return hmac.compare_digest(expected, sig)
+
+
+WebhookEventType = Literal[
+    "investment.completed",
+    "investment.failed",
+    "p2p.listing.created",
+    "p2p.listing.sold",
+    "p2p.listing.cancelled",
+    "distribution.published",
+    "kyc.approved",
+    "kyc.rejected",
+    "transfer.completed",
+]
+
+
+@dataclass(frozen=True)
+class WebhookEvent:
+    id: str
+    type: WebhookEventType
+    created_at: str
+    data: dict[str, Any]
+
+
+def parse_webhook_event(payload: str | bytes) -> WebhookEvent:
+    """Parse a webhook payload into a typed event object."""
+    raw = payload if isinstance(payload, str) else payload.decode()
+    d = json.loads(raw)
+    return WebhookEvent(
+        id=d["id"],
+        type=d["type"],
+        created_at=d.get("createdAt", ""),
+        data=d.get("data", {}),
+    )

europatech-1.0.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "europatech"
+version = "1.0.0"
+description = "Official Python SDK for the Europa Tech real estate tokenization API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.9"
+authors = [{ name = "Europa Tech Enterprise S.R.L.", email = "admin@europa-tech.org" }]
+keywords = ["europatech", "europa-tech", "real-estate", "tokenization", "rwa", "api", "sdk", "mica"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Typing :: Typed",
+]
+dependencies = ["httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://europa-tech.org/docs/api"
+Repository = "https://github.com/europa-tech-srl/europatech-sdk-python"
+Documentation = "https://europa-tech.org/docs/api"