opensolvency 0.1.1__tar.gz

opensolvency-0.1.1/.gitignore

@@ -0,0 +1,15 @@
+node_modules/
+dist/
+*.log
+.env
+.DS_Store
+opensolvency.db
+opensolvency.db-*
+clients/rust/target/
+clients/rust/Cargo.lock
+clients/c/example
+clients/c/example.exe
+__pycache__/
+*.pyc
+clients/python/dist/
+*.egg-info/

opensolvency-0.1.1/PKG-INFO

@@ -0,0 +1,33 @@
+Metadata-Version: 2.4
+Name: opensolvency
+Version: 0.1.1
+Summary: Python client for the OpenSolvency governance gate (REST over the HTTP ingress)
+Author: General Liquidity
+License: MIT
+Keywords: agentic-payments,governance,opensolvency
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# opensolvency (Python client)
+
+A thin REST client for the [OpenSolvency](https://github.com/general-liquidity/opensolvency)
+governance gate. Point it at a running `opensolvency serve`; every payment it submits
+runs through the same gate (auto-execute inside a mandate, park for operator approval,
+or block). A `blocked` outcome is a normal result, not an error. Standard library
+only - no dependencies.
+
+```python
+from opensolvency import OpenSolvencyClient
+
+os = OpenSolvencyClient("http://127.0.0.1:8787", token="...")
+res = os.pay(payee="tesco", payee_class="groceries", amount=8000,  # minor-units
+             rationale="the weekly grocery shop")
+print(res["outcome"])   # settled | pending | blocked | failed
+print(os.status(), os.ready())
+```
+
+Idempotency keys are generated per `pay()` (override with `idempotency_key=`). The
+full-feature surface is the TypeScript SDK (`@general-liquidity/opensolvency`); this
+is for Python hosts that talk to a running ingress.
+
+License: MIT.

opensolvency-0.1.1/README.md

@@ -0,0 +1,23 @@
+# opensolvency (Python client)
+
+A thin REST client for the [OpenSolvency](https://github.com/general-liquidity/opensolvency)
+governance gate. Point it at a running `opensolvency serve`; every payment it submits
+runs through the same gate (auto-execute inside a mandate, park for operator approval,
+or block). A `blocked` outcome is a normal result, not an error. Standard library
+only - no dependencies.
+
+```python
+from opensolvency import OpenSolvencyClient
+
+os = OpenSolvencyClient("http://127.0.0.1:8787", token="...")
+res = os.pay(payee="tesco", payee_class="groceries", amount=8000,  # minor-units
+             rationale="the weekly grocery shop")
+print(res["outcome"])   # settled | pending | blocked | failed
+print(os.status(), os.ready())
+```
+
+Idempotency keys are generated per `pay()` (override with `idempotency_key=`). The
+full-feature surface is the TypeScript SDK (`@general-liquidity/opensolvency`); this
+is for Python hosts that talk to a running ingress.
+
+License: MIT.

opensolvency-0.1.1/opensolvency.py

@@ -0,0 +1,92 @@
+"""OpenSolvency Python client — a thin REST client over the HTTP ingress.
+
+The ingress runs the SAME gate as everything else, so this client adds no
+authority: a payment it submits is auto-executed inside a mandate, parked for
+operator approval, or blocked. Standard-library only (no dependencies).
+
+    from opensolvency import OpenSolvencyClient
+
+    os = OpenSolvencyClient("http://127.0.0.1:8787", token="...")
+    result = os.pay(payee="tesco", payee_class="groceries", amount=8000,
+                    rationale="the weekly grocery shop")
+    print(result["outcome"])   # "settled" | "pending" | "blocked" | "failed"
+"""
+
+from __future__ import annotations
+
+import json
+import uuid
+import urllib.error
+import urllib.request
+from typing import Any, Optional
+
+__all__ = ["OpenSolvencyClient", "OpenSolvencyError"]
+
+
+class OpenSolvencyError(Exception):
+    """Raised on a transport error (not on a gate 'blocked' — that's a normal result)."""
+
+
+class OpenSolvencyClient:
+    def __init__(self, base_url: str = "http://127.0.0.1:8787", token: Optional[str] = None):
+        self.base_url = base_url.rstrip("/")
+        self.token = token
+
+    def _request(self, method: str, path: str, body: Any = None, headers: Optional[dict] = None):
+        data = json.dumps(body).encode() if body is not None else None
+        h = {"content-type": "application/json"}
+        if self.token:
+            h["authorization"] = f"Bearer {self.token}"
+        if headers:
+            h.update(headers)
+        req = urllib.request.Request(self.base_url + path, data=data, method=method, headers=h)
+        try:
+            with urllib.request.urlopen(req) as resp:
+                payload = resp.read()
+                return resp.status, (json.loads(payload) if payload else None)
+        except urllib.error.HTTPError as e:
+            payload = e.read()
+            # 403/401/413/429 carry a JSON body too — return it, don't raise.
+            return e.code, (json.loads(payload) if payload else None)
+        except urllib.error.URLError as e:
+            raise OpenSolvencyError(f"transport error: {e}") from e
+
+    def pay(
+        self,
+        payee: str,
+        payee_class: str,
+        amount: int,
+        currency: str = "GBP",
+        rail: str = "card",
+        rationale: str = "",
+        idempotency_key: Optional[str] = None,
+    ) -> dict:
+        """Submit a payment intent. Returns the gate result
+        {intentId, outcome, reasons, receiptId, verified}. `amount` is minor-units."""
+        headers = {"idempotency-key": idempotency_key or str(uuid.uuid4())}
+        _, body = self._request(
+            "POST",
+            "/payment-intent",
+            {
+                "payee": payee,
+                "payeeClass": payee_class,
+                "amount": amount,
+                "currency": currency,
+                "rail": rail,
+                "rationale": rationale,
+            },
+            headers,
+        )
+        return body or {}
+
+    def status(self) -> dict:
+        """Kill-switch / circuit-breaker state."""
+        return self._request("GET", "/status")[1] or {}
+
+    def ready(self) -> dict:
+        """Readiness probe."""
+        return self._request("GET", "/ready")[1] or {}
+
+    def openapi(self) -> dict:
+        """The served OpenAPI 3.1 document."""
+        return self._request("GET", "/openapi.json")[1] or {}

opensolvency-0.1.1/pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "opensolvency"
+version = "0.1.1"
+description = "Python client for the OpenSolvency governance gate (REST over the HTTP ingress)"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "General Liquidity" }]
+keywords = ["agentic-payments", "governance", "opensolvency"]
+dependencies = []
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+only-include = ["opensolvency.py"]