x402-trinity 0.1.0__tar.gz

x402_trinity-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: x402-trinity
+Version: 0.1.0
+Summary: Zero-dependency, Python standard-library-only execution core for machine-to-machine x402 payment handshakes.
+Author: devmster
+Maintainer: devmster
+License: MIT
+Project-URL: Homepage, https://github.com/devmster/x402-trinity
+Project-URL: Repository, https://github.com/devmster/x402-trinity
+Project-URL: Issues, https://github.com/devmster/x402-trinity/issues
+Keywords: x402,http-402,ai-agent,robotics-commerce,embedded-crypto,stdlib-only,gasless-transfer,eip-3009,constant-time-signing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Security :: Cryptography
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# x402-trinity
+
+**Let a Python process pay for things by itself — with hard spending limits, no hosted wallet
+service, and no changes to the code doing the fetching.**
+
+Standard library only. No dependencies, at all.
+
+```bash
+pip install x402-trinity
+```
+
+## Why
+
+When a script hits a paid resource it gets `402 Payment Required`. Without something to handle
+that, the request simply fails.
+
+x402-trinity handles it: reads the challenge, checks it against limits you set, signs, retries.
+All of it locally — no hosted wallet service, no third-party API, and the key never leaves your
+process.
+
+Gas exists but the payer doesn't pay it — under EIP-3009 the facilitator submits the transfer,
+so the wallet only ever needs USDC.
+
+## Use
+
+```python
+import os
+from x402_trinity import X402Client, Policy
+
+client = X402Client(
+    private_key=os.environ["X402_PRIVATE_KEY"],
+    policy=Policy(
+        max_amount_per_request=5000,      # 0.005 USDC per call   (REQUIRED)
+        total_budget=1_000_000,           # 1.00 USDC lifetime    (REQUIRED)
+        allow_hosts=["api.example.com"],
+    ),
+)
+
+body = client.urlopen("https://api.example.com/data").read()
+```
+
+Or as a decorator, so payment-unaware code just works:
+
+```python
+from x402_trinity import x402_telemetry, Policy
+
+@x402_telemetry(private_key=KEY, policy=Policy(max_amount_per_request=5000,
+                                               total_budget=1_000_000))
+def harvest():
+    return urllib.request.urlopen("https://sensor.local/v1/lidar").read()
+```
+
+Inside the decorated function `urllib.request.urlopen` pays 402s automatically. Existing code
+is untouched.
+
+## Scope
+
+**Buyer only.** To charge for a resource, use the TypeScript seller in the same project.
+
+**Base mainnet + USDC.** Other EVM chains work by passing `custom_chains` to `X402Client`.
+Check any entry against the deployed contract first: call `DOMAIN_SEPARATOR()` and confirm it
+equals what this library computes. A wrong `name` or `version` produces a signature that looks
+valid and the contract rejects.
+
+## Limits are not optional
+
+`max_amount_per_request` and `total_budget` are required arguments. An auto-payer without caps
+is a money leak controlled by whoever runs the server on the other end. Set `allow_hosts` and
+nothing else can be paid, however convincing the challenge looks.
+
+## Before you use it with real money
+
+This software signs payment authorizations. You are responsible for the funds in any wallet you
+configure it with, for the limits you set, and for the behaviour of any autonomous process you
+connect to it. Use a dedicated wallet holding only what you would accept losing.
+
+## Links
+
+- Source: https://github.com/devmster/x402-trinity
+- TypeScript package (buyer, seller, MCP server): `npm install x402-trinity`
+
+MIT

x402_trinity-0.1.0/README.md

@@ -0,0 +1,82 @@
+# x402-trinity
+
+**Let a Python process pay for things by itself — with hard spending limits, no hosted wallet
+service, and no changes to the code doing the fetching.**
+
+Standard library only. No dependencies, at all.
+
+```bash
+pip install x402-trinity
+```
+
+## Why
+
+When a script hits a paid resource it gets `402 Payment Required`. Without something to handle
+that, the request simply fails.
+
+x402-trinity handles it: reads the challenge, checks it against limits you set, signs, retries.
+All of it locally — no hosted wallet service, no third-party API, and the key never leaves your
+process.
+
+Gas exists but the payer doesn't pay it — under EIP-3009 the facilitator submits the transfer,
+so the wallet only ever needs USDC.
+
+## Use
+
+```python
+import os
+from x402_trinity import X402Client, Policy
+
+client = X402Client(
+    private_key=os.environ["X402_PRIVATE_KEY"],
+    policy=Policy(
+        max_amount_per_request=5000,      # 0.005 USDC per call   (REQUIRED)
+        total_budget=1_000_000,           # 1.00 USDC lifetime    (REQUIRED)
+        allow_hosts=["api.example.com"],
+    ),
+)
+
+body = client.urlopen("https://api.example.com/data").read()
+```
+
+Or as a decorator, so payment-unaware code just works:
+
+```python
+from x402_trinity import x402_telemetry, Policy
+
+@x402_telemetry(private_key=KEY, policy=Policy(max_amount_per_request=5000,
+                                               total_budget=1_000_000))
+def harvest():
+    return urllib.request.urlopen("https://sensor.local/v1/lidar").read()
+```
+
+Inside the decorated function `urllib.request.urlopen` pays 402s automatically. Existing code
+is untouched.
+
+## Scope
+
+**Buyer only.** To charge for a resource, use the TypeScript seller in the same project.
+
+**Base mainnet + USDC.** Other EVM chains work by passing `custom_chains` to `X402Client`.
+Check any entry against the deployed contract first: call `DOMAIN_SEPARATOR()` and confirm it
+equals what this library computes. A wrong `name` or `version` produces a signature that looks
+valid and the contract rejects.
+
+## Limits are not optional
+
+`max_amount_per_request` and `total_budget` are required arguments. An auto-payer without caps
+is a money leak controlled by whoever runs the server on the other end. Set `allow_hosts` and
+nothing else can be paid, however convincing the challenge looks.
+
+## Before you use it with real money
+
+This software signs payment authorizations. You are responsible for the funds in any wallet you
+configure it with, for the limits you set, and for the behaviour of any autonomous process you
+connect to it. Use a dedicated wallet holding only what you would accept losing.
+
+## Links
+
+- Source: https://github.com/devmster/x402-trinity
+- TypeScript package (buyer, seller, MCP server): `npm install x402-trinity`
+
+MIT

x402_trinity-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "x402-trinity"
+version = "0.1.0"
+description = "Zero-dependency, Python standard-library-only execution core for machine-to-machine x402 payment handshakes."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "devmster" }]
+maintainers = [{ name = "devmster" }]
+keywords = [
+    "x402",
+    "http-402",
+    "ai-agent",
+    "robotics-commerce",
+    "embedded-crypto",
+    "stdlib-only",
+    "gasless-transfer",
+    "eip-3009",
+    "constant-time-signing",
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: Security :: Cryptography",
+]
+dependencies = []          # stdlib only, by design
+
+[project.urls]
+Homepage = "https://github.com/devmster/x402-trinity"
+Repository = "https://github.com/devmster/x402-trinity"
+Issues = "https://github.com/devmster/x402-trinity/issues"
+
+[tool.setuptools]
+packages = ["x402_trinity"]

x402_trinity-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+