cryptonly-x402 0.1.0__py3-none-any.whl

cryptonly_x402/__init__.py

@@ -0,0 +1,16 @@
+"""Cryptonly facilitator client for the x402 payment protocol."""
+
+from .client import CryptonlyFacilitatorClient, CryptonlyFacilitatorClientSync
+from .constants import (
+    MERCHANT_API_BASE_URL,
+    MERCHANT_API_KEY_HEADER,
+    SANDBOX_MERCHANT_API_BASE_URL,
+)
+
+__all__ = [
+    "CryptonlyFacilitatorClient",
+    "CryptonlyFacilitatorClientSync",
+    "MERCHANT_API_BASE_URL",
+    "MERCHANT_API_KEY_HEADER",
+    "SANDBOX_MERCHANT_API_BASE_URL",
+]

cryptonly_x402/client.py

@@ -0,0 +1,70 @@
+"""Cryptonly facilitator clients for the x402 protocol."""
+
+from __future__ import annotations
+
+from x402.http import (
+    FacilitatorConfig,
+    HTTPFacilitatorClient,
+    HTTPFacilitatorClientSync,
+)
+from x402.http.facilitator_client_base import AuthHeaders
+
+from .constants import (
+    MERCHANT_API_BASE_URL,
+    MERCHANT_API_KEY_HEADER,
+    SANDBOX_MERCHANT_API_BASE_URL,
+)
+
+
+class _ApiKeyAuth:
+    """Sends the Cryptonly API key on verify, settle, and supported."""
+
+    def __init__(self, api_key: str) -> None:
+        self._headers = {MERCHANT_API_KEY_HEADER: api_key}
+
+    def get_auth_headers(self) -> AuthHeaders:
+        headers = dict(self._headers)
+        return AuthHeaders(verify=headers, settle=dict(headers), supported=dict(headers))
+
+
+def _resolve_facilitator_url(sandbox: bool) -> str:
+    origin = SANDBOX_MERCHANT_API_BASE_URL if sandbox else MERCHANT_API_BASE_URL
+    return f"{origin}/x402"
+
+
+def _require_api_key(api_key: str, client_name: str) -> str:
+    if not api_key:
+        raise TypeError(f"{client_name}: api_key is required")
+    return api_key
+
+
+class CryptonlyFacilitatorClient(HTTPFacilitatorClient):
+    """Async Cryptonly facilitator client.
+
+    Pass it to ``x402ResourceServer`` for FastAPI and other async servers.
+    """
+
+    def __init__(self, api_key: str, *, sandbox: bool = False) -> None:
+        key = _require_api_key(api_key, "CryptonlyFacilitatorClient")
+        super().__init__(
+            FacilitatorConfig(
+                url=_resolve_facilitator_url(sandbox),
+                auth_provider=_ApiKeyAuth(key),
+            )
+        )
+
+
+class CryptonlyFacilitatorClientSync(HTTPFacilitatorClientSync):
+    """Sync Cryptonly facilitator client.
+
+    Pass it to ``x402ResourceServerSync`` for Flask and other sync servers.
+    """
+
+    def __init__(self, api_key: str, *, sandbox: bool = False) -> None:
+        key = _require_api_key(api_key, "CryptonlyFacilitatorClientSync")
+        super().__init__(
+            FacilitatorConfig(
+                url=_resolve_facilitator_url(sandbox),
+                auth_provider=_ApiKeyAuth(key),
+            )
+        )

cryptonly_x402/constants.py

@@ -0,0 +1,5 @@
+"""Cryptonly merchant API origins and the tenant API key header."""
+
+MERCHANT_API_BASE_URL = "https://api-merchant.cryptonly.net"
+SANDBOX_MERCHANT_API_BASE_URL = "https://sandbox-api-merchant.cryptonly.net"
+MERCHANT_API_KEY_HEADER = "x-tenant-api-key"

cryptonly_x402-0.1.0.dist-info/METADATA

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: cryptonly-x402
+Version: 0.1.0
+Summary: Cryptonly facilitator client for the x402 payment protocol.
+Author-email: Cryptonly <noreply@cryptonly.net>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/cryptonly-net/x402/tree/main/python
+Project-URL: Documentation, https://cryptonly.gitbook.io/docs
+Project-URL: Repository, https://github.com/cryptonly-net/x402
+Project-URL: Issues, https://github.com/cryptonly-net/x402/issues
+Keywords: cryptonly,x402,facilitator,payments,client,python
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: x402>=2
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+
+<img src="https://raw.githubusercontent.com/cryptonly-net/.github/main/profile/assets/header-banner.svg" alt="Cryptonly" width="100%" />
+
+<div align="center">
+
+# Cryptonly — x402 facilitator
+
+Facilitator client for x402 payments.
+
+[Website](https://cryptonly.net) · [Documentation](https://cryptonly.gitbook.io/docs) · [Contact](https://cryptonly.net/contact/)
+
+</div>
+
+---
+
+Pass the async client to `x402ResourceServer` for FastAPI. Pass the sync client to `x402ResourceServerSync` for Flask.
+
+```bash
+pip install cryptonly-x402 "x402[fastapi,evm]"
+```
+
+`x402` >=2 is a dependency. Install the extra for the framework and chain you use, such as `x402[fastapi,evm]` or `x402[flask,evm]`.
+
+```python
+import os
+
+from cryptonly_x402 import CryptonlyFacilitatorClient
+from x402.mechanisms.evm.exact import ExactEvmServerScheme
+from x402.server import x402ResourceServer
+
+facilitator = CryptonlyFacilitatorClient(os.environ["CRYPTONLY_API_KEY"])
+
+server = x402ResourceServer(facilitator)
+server.register("eip155:8453", ExactEvmServerScheme())
+```
+
+`api_key` is your Cryptonly API key. It is sent as `x-tenant-api-key` on verify, settle, and supported.
+
+```python
+facilitator = CryptonlyFacilitatorClient(os.environ["CRYPTONLY_API_KEY"])
+```
+
+Flask uses the sync client:
+
+```python
+from cryptonly_x402 import CryptonlyFacilitatorClientSync
+from x402.mechanisms.evm.exact import ExactEvmServerScheme
+from x402.server import x402ResourceServerSync
+
+facilitator = CryptonlyFacilitatorClientSync(os.environ["CRYPTONLY_API_KEY"])
+
+server = x402ResourceServerSync(facilitator)
+server.register("eip155:8453", ExactEvmServerScheme())
+```
+
+Set `sandbox=True` to use the sandbox facilitator with testnest.

cryptonly_x402-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+cryptonly_x402/__init__.py,sha256=VzNJwK-L4NDxNxpIR0gjxS8eS3NA_nWaqmLj362UcgA,448
+cryptonly_x402/client.py,sha256=N2tQ-_eG4pV5zbhMiVqUphX8aSdcWJXxqnx_xAW12dc,2121
+cryptonly_x402/constants.py,sha256=7Sjodlb6detKP3oJUuclskJsxKhiozYbW5tw3AOV4gA,252
+cryptonly_x402/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+cryptonly_x402-0.1.0.dist-info/METADATA,sha256=TfcXKHnpYNovuQUr5zRDHKZ0XjAHerbW99s0p2ylGY0,2466
+cryptonly_x402-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+cryptonly_x402-0.1.0.dist-info/top_level.txt,sha256=U-QFI-b_1IEJNbnEBRjUlCutfkeB43AnJc2trK3exUU,15
+cryptonly_x402-0.1.0.dist-info/RECORD,,

cryptonly_x402-0.1.0.dist-info/WHEEL

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

cryptonly_x402-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+cryptonly_x402