voidnote 0.2.0__tar.gz → 0.3.0__tar.gz

{voidnote-0.2.0 → voidnote-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voidnote
-Version: 0.2.0
+Version: 0.3.0
 Summary: Official SDK for VoidNote — zero-knowledge self-destructing notes and live encrypted streams
 Project-URL: Homepage, https://voidnote.net
 Project-URL: Repository, https://github.com/quantum-encoding/voidnote-python

{voidnote-0.2.0 → voidnote-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "voidnote"
-version = "0.2.0"
+version = "0.3.0"
 description = "Official SDK for VoidNote — zero-knowledge self-destructing notes and live encrypted streams"
 readme = "README.md"
 license = "MIT"

{voidnote-0.2.0 → voidnote-0.3.0}/voidnote/__init__.py

@@ -113,17 +113,21 @@ def create(
     api_key: str,
     title: Optional[str] = None,
     max_views: int = 1,
+    expires_in: int = 24,
+    note_type: Literal["secure", "pipe"] = "secure",
     base: str = DEFAULT_BASE,
 ) -> CreateResult:
     """
     Create a VoidNote. Encrypts content client-side — the server never sees plaintext.
 
     Args:
-        content:   The secret text to encrypt and store
-        api_key:   Your API key from dashboard (vn_...)
-        title:     Optional plaintext title (keep non-sensitive)
-        max_views: How many times the note can be read (1–100)
-        base:      Override base URL (default: https://voidnote.net)
+        content:    The secret text to encrypt and store
+        api_key:    Your API key from dashboard (vn_...)
+        title:      Optional plaintext title (keep non-sensitive)
+        max_views:  How many times the note can be read (1–100)
+        expires_in: Lifetime in hours — one of: 1, 6, 24, 72, 168, 720
+        note_type:  "secure" (default) or "pipe"
+        base:       Override base URL (default: https://voidnote.net)
 
     Returns:
         CreateResult with .url (shareable link) and .expires_at
@@ -134,6 +138,8 @@ def create(
     """
     if not 1 <= max_views <= 100:
         raise ValueError("max_views must be between 1 and 100")
+    if expires_in not in (1, 6, 24, 72, 168, 720):
+        raise ValueError("expires_in must be one of: 1, 6, 24, 72, 168, 720")
 
     full_token, token_id, secret = _generate_token()
     encrypted_content, iv = _encrypt(content, secret)
@@ -143,6 +149,8 @@ def create(
         "encryptedContent": encrypted_content,
         "iv": iv,
         "maxViews": max_views,
+        "expiresIn": expires_in,
+        "noteType": note_type,
     }
     if title:
         payload["title"] = title
@@ -351,7 +359,103 @@ def _decrypt_stream_msg(enc_hex: str, iv_hex: str, key: bytes) -> str:
     return plaintext.decode("utf-8")
 
 
+# ---------------------------------------------------------------------------
+# Buy / Credits API
+# ---------------------------------------------------------------------------
+
+@dataclass
+class CryptoOrder:
+    order_id: str
+    to_address: str
+    chain: str
+    token: str
+    amount: str        # human-readable, e.g. "5.000000"
+    amount_usd: float
+    credits: int
+    expires_at: str
+
+
+@dataclass
+class SubmitPaymentResult:
+    credits: int
+    credits_added: int
+
+
+def create_crypto_order(
+    *,
+    api_key: str,
+    bundle_id: Literal["test", "starter", "standard", "pro"],
+    chain: Literal["polygon", "base", "arbitrum", "ethereum", "bitcoin", "tron"],
+    token: Literal["USDT", "USDC", "ETH", "BTC", "TRX"],
+    base: str = DEFAULT_BASE,
+) -> CryptoOrder:
+    """
+    Create a crypto payment order for credits.
+    Returns an address and exact amount to send — valid for 1 hour.
+
+    Args:
+        api_key:   Your API key (vn_...) from the dashboard
+        bundle_id: "test" ($1/20), "starter" ($5/100), "standard" ($20/500), "pro" ($35/1000)
+        chain:     Payment network
+        token:     Token to send
+        base:      Override base URL
+
+    Example:
+        order = voidnote.create_crypto_order(
+            api_key="vn_...", bundle_id="starter", chain="polygon", token="USDT"
+        )
+        print(f"Send {order.amount} {order.token} to {order.to_address}")
+    """
+    body = json.dumps({"bundleId": bundle_id, "chain": chain, "token": token}).encode()
+    headers = {"Content-Type": "application/json", "Authorization": f"Bearer {api_key}"}
+    data, status = _fetch(f"{base}/api/buy/crypto/create-order", method="POST", headers=headers, body=body)
+    if status >= 400:
+        raise RuntimeError(data.get("error", f"HTTP {status}"))
+    return CryptoOrder(
+        order_id=data["orderId"],
+        to_address=data["toAddress"],
+        chain=data["chain"],
+        token=data["token"],
+        amount=data["amount"],
+        amount_usd=data["amountUsd"],
+        credits=data["credits"],
+        expires_at=data["expiresAt"],
+    )
+
+
+def submit_crypto_payment(
+    *,
+    api_key: str,
+    order_id: str,
+    tx_hash: str,
+    base: str = DEFAULT_BASE,
+) -> SubmitPaymentResult:
+    """
+    Submit a transaction hash to confirm a crypto payment.
+    Verifies on-chain and credits your account instantly.
+
+    Args:
+        api_key:  Your API key (vn_...) from the dashboard
+        order_id: Order ID from create_crypto_order()
+        tx_hash:  Transaction hash from your wallet
+        base:     Override base URL
+
+    Example:
+        result = voidnote.submit_crypto_payment(
+            api_key="vn_...", order_id=order.order_id, tx_hash="0x..."
+        )
+        print(f"New balance: {result.credits} credits")
+    """
+    body = json.dumps({"orderId": order_id, "txHash": tx_hash}).encode()
+    headers = {"Content-Type": "application/json", "Authorization": f"Bearer {api_key}"}
+    data, status = _fetch(f"{base}/api/buy/crypto/submit-tx", method="POST", headers=headers, body=body)
+    if status >= 400:
+        raise RuntimeError(data.get("error", f"HTTP {status}"))
+    return SubmitPaymentResult(credits=data["credits"], credits_added=data["creditsAdded"])
+
+
 __all__ = [
     "read", "create", "ReadResult", "CreateResult",
     "create_stream", "watch", "StreamHandle",
+    "CryptoOrder", "SubmitPaymentResult", "create_crypto_order", "submit_crypto_payment",
 ]