agentpay-python 0.1.0__py3-none-any.whl

agentpay/__init__.py

@@ -0,0 +1,23 @@
+"""AgentPay Python SDK — AI agent ödeme altyapısı."""
+
+from .client import AgentPayClient
+from .models import (
+    ClientInfo,
+    BalanceInfo,
+    PaywallResponse,
+    SpendResult,
+    TopupResponse,
+    RegisterResponse,
+    ForecastResult,
+)
+
+__all__ = [
+    "AgentPayClient",
+    "ClientInfo",
+    "BalanceInfo",
+    "PaywallResponse",
+    "SpendResult",
+    "TopupResponse",
+    "RegisterResponse",
+    "ForecastResult",
+]

agentpay/client.py

@@ -0,0 +1,231 @@
+"""AgentPay Python SDK istemci sınıfı."""
+
+import hashlib
+import hmac
+import time
+from typing import Optional
+from urllib.parse import urljoin
+
+import httpx
+
+from .models import (
+    BalanceInfo,
+    ClientInfo,
+    ForecastResult,
+    PaywallResponse,
+    RegisterResponse,
+    SpendResult,
+    TopupResponse,
+)
+
+
+class AgentPayClient:
+    """AgentPay API istemcisi.
+
+    Kullanım:
+        client = AgentPayClient(api_key="sg_...", base_url="https://api.aipp.dev")
+        bal = client.get_balance()
+        result = client.spend(amount=5.0, description="AI call #42")
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://api.aipp.dev",
+        timeout: float = 30.0,
+        admin_token: Optional[str] = None,
+    ):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.admin_token = admin_token
+        self._client = httpx.Client(
+            base_url=self.base_url,
+            timeout=httpx.Timeout(timeout),
+            headers={"X-API-Key": api_key},
+        )
+
+    # ────────────────────────────────
+    # Auth / Kayıt
+    # ────────────────────────────────
+
+    def register(self, idempotency_key: Optional[str] = None) -> RegisterResponse:
+        """Yeni API key + kredi al (auth gerekmez)."""
+        headers = {}
+        if idempotency_key:
+            headers["Idempotency-Key"] = idempotency_key
+        resp = self._client.post("/v1/auth/register", headers=headers)
+        resp.raise_for_status()
+        data = resp.json()
+        return RegisterResponse(
+            api_key=data["api_key"],
+            credits=data["credits"],
+            client_id=data["client_id"],
+        )
+
+    # ────────────────────────────────
+    # Bakiye
+    # ────────────────────────────────
+
+    def get_balance(self) -> BalanceInfo:
+        """Mevcut bakiyeyi sorgula."""
+        resp = self._client.get("/v1/balance")
+        resp.raise_for_status()
+        data = resp.json()
+        return BalanceInfo(
+            balance=data["balance"],
+            credits_used=data["credits_used"],
+            credits_remaining=data["credits_remaining"],
+        )
+
+    def forecast(
+        self, estimated_cost_per_call: float = 0.01
+    ) -> ForecastResult:
+        """Bakiye yetecek mi tahmini."""
+        bal = self.get_balance()
+        will_exhaust = estimated_cost_per_call > 0 and (
+            bal.credits_remaining / estimated_cost_per_call < 100
+        )
+        return ForecastResult(
+            current_balance=bal.credits_remaining,
+            estimated_cost_per_call=estimated_cost_per_call,
+            estimated_calls_remaining=(
+                int(bal.credits_remaining / estimated_cost_per_call)
+                if estimated_cost_per_call > 0
+                else 0
+            ),
+            will_exhaust=will_exhaust,
+            total_spent_all_time=bal.credits_used,
+        )
+
+    # ────────────────────────────────
+    # Harcama
+    # ────────────────────────────────
+
+    def spend(
+        self,
+        amount: float,
+        description: str = "",
+        idempotency_key: Optional[str] = None,
+    ) -> SpendResult:
+        """Kredi harca (idempotent)."""
+        payload: dict = {
+            "amount": amount,
+            "description": description or f"spend-{int(time.time())}",
+        }
+        headers = {}
+        if idempotency_key:
+            headers["Idempotency-Key"] = idempotency_key
+        resp = self._client.post(
+            "/v1/spend", json=payload, headers=headers
+        )
+        resp.raise_for_status()
+        data = resp.json()
+        return SpendResult(
+            success=data.get("success", True),
+            credits_used=data.get("credits_used", amount),
+            credits_remaining=data.get("credits_remaining", 0),
+            message=data.get("message", ""),
+        )
+
+    # ────────────────────────────────
+    # Paywall (L402)
+    # ────────────────────────────────
+
+    def generate_paywall(
+        self,
+        amount: float,
+        description: str = "",
+        metadata: Optional[dict] = None,
+    ) -> PaywallResponse:
+        """LN faturası oluştur — müşteri ödeyince token alır."""
+        payload = {
+            "amount": amount,
+            "description": description or "AgentPay paywall",
+        }
+        if metadata:
+            payload["metadata"] = metadata
+        resp = self._client.post("/v1/paywall", json=payload)
+        resp.raise_for_status()
+        data = resp.json()
+        return PaywallResponse(
+            token=data["token"],
+            cost=data["cost"],
+            invoice=data["invoice"],
+            paid=False,
+        )
+
+    def verify_paywall(self, token: str) -> PaywallResponse:
+        """Ödeme durumunu kontrol et."""
+        resp = self._client.get(f"/v1/paywall/{token}")
+        resp.raise_for_status()
+        data = resp.json()
+        return PaywallResponse(
+            token=token,
+            cost=data.get("cost", 0),
+            invoice=data.get("invoice", ""),
+            paid=data.get("paid", False),
+        )
+
+    # ────────────────────────────────
+    # Bakiye Yükleme
+    # ────────────────────────────────
+
+    def topup(self, usd_amount: float = 5.0) -> TopupResponse:
+        """LN faturası ile kredi yükle."""
+        resp = self._client.post(
+            "/v1/topup", json={"usd_amount": usd_amount}
+        )
+        resp.raise_for_status()
+        data = resp.json()
+        return TopupResponse(
+            success=data.get("success", True),
+            invoice=data["invoice"],
+            credits=data.get("credits", usd_amount * 100),
+            usd_amount=usd_amount,
+        )
+
+    # ────────────────────────────────
+    # Admin (admin_token gerekli)
+    # ────────────────────────────────
+
+    def list_clients(self) -> list[ClientInfo]:
+        """Tüm müşterileri listele (admin)."""
+        if not self.admin_token:
+            raise ValueError("admin_token required for list_clients")
+        resp = self._client.get(
+            "/v1/admin/clients",
+            headers={"Authorization": f"Bearer {self.admin_token}"},
+        )
+        resp.raise_for_status()
+        return [
+            ClientInfo(
+                id=c["id"],
+                api_key=c.get("api_key", ""),
+                credits_used=c.get("credits_used", 0),
+                is_admin=c.get("is_admin", False),
+            )
+            for c in resp.json()
+        ]
+
+    def get_client(self, client_id: str) -> ClientInfo:
+        """Müşteri detayı (admin)."""
+        if not self.admin_token:
+            raise ValueError("admin_token required for get_client")
+        resp = self._client.get(
+            f"/v1/admin/clients/{client_id}",
+            headers={"Authorization": f"Bearer {self.admin_token}"},
+        )
+        resp.raise_for_status()
+        c = resp.json()
+        return ClientInfo(
+            id=c["id"],
+            api_key=c.get("api_key", ""),
+            credits_used=c.get("credits_used", 0),
+            is_admin=c.get("is_admin", False),
+        )
+
+    def health(self) -> dict:
+        """API sağlık kontrolü."""
+        resp = self._client.get("/health")
+        resp.raise_for_status()
+        return resp.json()

agentpay/models.py

@@ -0,0 +1,64 @@
+from dataclasses import dataclass, field
+from typing import Optional
+
+
+@dataclass
+class ClientInfo:
+    """Müşteri bilgisi."""
+    id: str
+    api_key: str
+    credits_used: float = 0.0
+    is_admin: bool = False
+
+
+@dataclass
+class BalanceInfo:
+    """Bakiye bilgisi."""
+    balance: float
+    credits_used: float
+    credits_remaining: float
+
+
+@dataclass
+class PaywallResponse:
+    """L402 paywall yanıtı."""
+    token: str
+    cost: float
+    invoice: str  # Lightning fatura
+    paid: bool = False
+
+
+@dataclass
+class SpendResult:
+    """Harcama sonucu."""
+    success: bool
+    credits_used: float
+    credits_remaining: float
+    message: str = ""
+
+
+@dataclass
+class TopupResponse:
+    """Bakiye yükleme yanıtı."""
+    success: bool
+    invoice: str
+    credits: float
+    usd_amount: float
+
+
+@dataclass
+class RegisterResponse:
+    """Kayıt yanıtı."""
+    api_key: str
+    credits: float
+    client_id: str
+
+
+@dataclass
+class ForecastResult:
+    """Bakiye tahmini."""
+    current_balance: float
+    estimated_cost_per_call: float
+    estimated_calls_remaining: int
+    will_exhaust: bool
+    total_spent_all_time: float = 0.0

agentpay_python-0.1.0.dist-info/METADATA

@@ -0,0 +1,65 @@
+Metadata-Version: 2.4
+Name: agentpay-python
+Version: 0.1.0
+Summary: AgentPay Python SDK — AI agent ödeme altyapısı
+Author-email: AIPP <aippcore@gmail.com>
+License: MIT
+Project-URL: Homepage, https://api.aipp.dev
+Project-URL: Source, https://github.com/aippdev/agentpay-python
+Project-URL: Documentation, https://api.aipp.dev/docs
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25.0
+
+# AgentPay Python SDK
+
+AI agent'lar için Lightning Network tabanlı ödeme altyapısı.
+
+## Kurulum
+
+```bash
+pip install agentpay-sdk
+```
+
+## Kullanım
+
+```python
+from agentpay import AgentPayClient
+
+# Yeni API key al (50 ücretsiz kredi ile)
+client = AgentPayClient(api_key="sg_...")
+bal = client.get_balance()
+print(f"Bakiye: {bal.credits_remaining} kredi")
+
+# Kredi harca (idempotent)
+result = client.spend(amount=5.0, description="AI çağrısı")
+print(f"Harcandı: {result.credits_used}, Kalan: {result.credits_remaining}")
+
+# Bakiye tahmini
+forecast = client.forecast(estimated_cost_per_call=0.05)
+if forecast.will_exhaust:
+    print("Bakiye azalıyor!")
+print(f"Tahmini çağrı: {forecast.estimated_calls_remaining}")
+
+# Paywall (L402) — LN faturası ile ödeme
+pw = client.generate_paywall(amount=10.0, description="Premium içerik")
+print(f"Fatura: {pw.invoice}")
+
+# Topup — kredi yükle
+top = client.topup(usd_amount=5.0)
+print(f"Yükleme faturası: {top.invoice}")
+```
+
+## API Referansı
+
+Tüm metodlar ve modeller için: [api.aipp.dev/docs](https://api.aipp.dev/docs)

agentpay_python-0.1.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+agentpay/__init__.py,sha256=iEEAvrvocGGW9BCh5oN89zbHvRA8Ftd7Rd2_FNTsIqY,434
+agentpay/client.py,sha256=6-DuXhDn5JJk81dacXHNSAQimFDPkBNCryiT27kmP9g,7955
+agentpay/models.py,sha256=lCvwx_NRhDNR5ywrsU4L33zSONzv9sXynvpjHMSQhjs,1140
+agentpay_python-0.1.0.dist-info/METADATA,sha256=6ue-5GHLgFBT4AolE7jo7mnd00MxNVDXfiKB3shmBdk,2019
+agentpay_python-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+agentpay_python-0.1.0.dist-info/top_level.txt,sha256=-ZKxHLESIWgQ31Vn1cP5LAtq7d3iqrmzjYCw6E7zrz0,9
+agentpay_python-0.1.0.dist-info/RECORD,,

agentpay_python-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

agentpay_python-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+agentpay