x402check-langchain 0.1.0__tar.gz

x402check_langchain-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 x402check
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the Software), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

x402check_langchain-0.1.0/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: x402check-langchain
+Version: 0.1.0
+Summary: LangChain tools for x402check — preflight x402 seller endpoints (ok|caution|avoid) before an agent pays.
+Author: x402check
+License: MIT
+Project-URL: Homepage, https://x402check.dev
+Project-URL: Documentation, https://x402check.dev/llms.txt
+Project-URL: Repository, https://github.com/nwilliams005/x402check
+Keywords: x402,x402check,langchain,ai-agent,preflight,payto,base,usdc
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: langchain-core>=0.3
+Dynamic: license-file
+
+# x402check-langchain (Python)
+
+LangChain tools for [x402check](https://x402check.dev) — trust-check an x402 seller **before any payment**.
+
+```bash
+pip install x402check-langchain
+```
+
+```python
+from x402check_langchain import create_x402check_tools
+import os
+os.environ["X402CHECK_URL"] = "https://x402check.dev"
+tools = create_x402check_tools()
+```
+
+Tools: `preflight_check`, `verify_payto`, `compare_tools`.
+
+Paid **$0.002 USDC Exact per tool URL** on Base. See https://x402check.dev/llms.txt
+
+## Note
+
+This package is prepared for PyPI. Publishing requires a PyPI API token (not present in this environment).

x402check_langchain-0.1.0/README.md

@@ -0,0 +1,22 @@
+# x402check-langchain (Python)
+
+LangChain tools for [x402check](https://x402check.dev) — trust-check an x402 seller **before any payment**.
+
+```bash
+pip install x402check-langchain
+```
+
+```python
+from x402check_langchain import create_x402check_tools
+import os
+os.environ["X402CHECK_URL"] = "https://x402check.dev"
+tools = create_x402check_tools()
+```
+
+Tools: `preflight_check`, `verify_payto`, `compare_tools`.
+
+Paid **$0.002 USDC Exact per tool URL** on Base. See https://x402check.dev/llms.txt
+
+## Note
+
+This package is prepared for PyPI. Publishing requires a PyPI API token (not present in this environment).

x402check_langchain-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "x402check-langchain"
+version = "0.1.0"
+description = "LangChain tools for x402check — preflight x402 seller endpoints (ok|caution|avoid) before an agent pays."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "x402check" }]
+keywords = ["x402", "x402check", "langchain", "ai-agent", "preflight", "payto", "base", "usdc"]
+dependencies = [
+  "httpx>=0.27",
+  "langchain-core>=0.3",
+]
+
+[project.urls]
+Homepage = "https://x402check.dev"
+Documentation = "https://x402check.dev/llms.txt"
+Repository = "https://github.com/nwilliams005/x402check"
+
+[tool.setuptools.packages.find]
+include = ["x402check_langchain*"]

x402check_langchain-0.1.0/setup.cfg

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

x402check_langchain-0.1.0/x402check_langchain/__init__.py

@@ -0,0 +1,129 @@
+"""LangChain tools for x402check (https://x402check.dev)."""
+
+from __future__ import annotations
+
+import json
+import os
+from typing import Any, Optional, Sequence
+
+import httpx
+from langchain_core.tools import StructuredTool
+from pydantic import BaseModel, Field
+
+DEFAULT_BASE = "https://x402check.dev"
+
+
+class PreflightInput(BaseModel):
+    url: str = Field(..., description="Absolute https URL of the x402 seller endpoint")
+    fresh: bool = Field(False, description="Force a live probe; ignore cache")
+
+
+class CompareInput(BaseModel):
+    urls: list[str] = Field(..., description="Candidate seller URLs (max 25)")
+    fresh: bool = Field(False, description="Force a live probe")
+
+
+def _base(base_url: Optional[str] = None) -> str:
+    return (base_url or os.environ.get("X402CHECK_URL") or DEFAULT_BASE).rstrip("/")
+
+
+def preflight(
+    url: str,
+    *,
+    base_url: Optional[str] = None,
+    fresh: bool = False,
+    payment_headers: Optional[dict[str, str]] = None,
+) -> dict[str, Any]:
+    if os.environ.get("X402CHECK_SKIP") == "1":
+        return {"url": url, "verdict": "ok", "reasonCodes": ["preflight_skipped"], "history": {"checks": 0}}
+    params = {"url": url}
+    if fresh:
+        params["fresh"] = "1"
+    headers = {"accept": "application/json", **(payment_headers or {})}
+    with httpx.Client(timeout=30.0) as client:
+        res = client.get(f"{_base(base_url)}/preflight", params=params, headers=headers)
+        if res.status_code == 402:
+            raise RuntimeError("preflight_payment_required")
+        res.raise_for_status()
+        return res.json()
+
+
+def preflight_batch(
+    urls: Sequence[str],
+    *,
+    base_url: Optional[str] = None,
+    fresh: bool = False,
+    payment_headers: Optional[dict[str, str]] = None,
+) -> dict[str, Any]:
+    headers = {
+        "accept": "application/json",
+        "content-type": "application/json",
+        **(payment_headers or {}),
+    }
+    with httpx.Client(timeout=60.0) as client:
+        res = client.post(
+            f"{_base(base_url)}/preflight",
+            headers=headers,
+            json={"urls": list(urls), "fresh": fresh},
+        )
+        if res.status_code == 402:
+            raise RuntimeError("preflight_payment_required")
+        res.raise_for_status()
+        return res.json()
+
+
+def create_x402check_tools(
+    *,
+    base_url: Optional[str] = None,
+    payment_headers: Optional[dict[str, str]] = None,
+) -> list[StructuredTool]:
+    """Return LangChain StructuredTools: preflight_check, verify_payto, compare_tools."""
+
+    def _preflight(url: str, fresh: bool = False) -> str:
+        return json.dumps(preflight(url, base_url=base_url, fresh=fresh, payment_headers=payment_headers))
+
+    def _verify(url: str, fresh: bool = False) -> str:
+        check = preflight(url, base_url=base_url, fresh=fresh, payment_headers=payment_headers)
+        slim = {
+            "url": check.get("url"),
+            "verdict": check.get("verdict"),
+            "payTo": check.get("payTo"),
+            "priceUsd": check.get("priceUsd"),
+            "network": check.get("network"),
+            "reasonCodes": check.get("reasonCodes", []),
+            "payToChanges": (check.get("history") or {}).get("payToChanges", []),
+            "priceChanges": (check.get("history") or {}).get("priceChanges", []),
+        }
+        return json.dumps(slim)
+
+    def _compare(urls: list[str], fresh: bool = False) -> str:
+        return json.dumps(
+            preflight_batch(urls, base_url=base_url, fresh=fresh, payment_headers=payment_headers)
+        )
+
+    return [
+        StructuredTool.from_function(
+            func=_preflight,
+            name="preflight_check",
+            description=(
+                "Mandatory trust preflight before paying any x402 endpoint. "
+                "Returns verdict ok|caution|avoid plus history. Do not pay if avoid."
+            ),
+            args_schema=PreflightInput,
+        ),
+        StructuredTool.from_function(
+            func=_verify,
+            name="verify_payto",
+            description="Verify the payTo / receiving wallet an x402 seller demands before signing USDC on Base.",
+            args_schema=PreflightInput,
+        ),
+        StructuredTool.from_function(
+            func=_compare,
+            name="compare_tools",
+            description="Compare several x402 seller URLs before choosing which to pay.",
+            args_schema=CompareInput,
+        ),
+    ]
+
+
+__all__ = ["preflight", "preflight_batch", "create_x402check_tools"]

x402check_langchain-0.1.0/x402check_langchain.egg-info/PKG-INFO

@@ -0,0 +1,39 @@
+Metadata-Version: 2.4
+Name: x402check-langchain
+Version: 0.1.0
+Summary: LangChain tools for x402check — preflight x402 seller endpoints (ok|caution|avoid) before an agent pays.
+Author: x402check
+License: MIT
+Project-URL: Homepage, https://x402check.dev
+Project-URL: Documentation, https://x402check.dev/llms.txt
+Project-URL: Repository, https://github.com/nwilliams005/x402check
+Keywords: x402,x402check,langchain,ai-agent,preflight,payto,base,usdc
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: langchain-core>=0.3
+Dynamic: license-file
+
+# x402check-langchain (Python)
+
+LangChain tools for [x402check](https://x402check.dev) — trust-check an x402 seller **before any payment**.
+
+```bash
+pip install x402check-langchain
+```
+
+```python
+from x402check_langchain import create_x402check_tools
+import os
+os.environ["X402CHECK_URL"] = "https://x402check.dev"
+tools = create_x402check_tools()
+```
+
+Tools: `preflight_check`, `verify_payto`, `compare_tools`.
+
+Paid **$0.002 USDC Exact per tool URL** on Base. See https://x402check.dev/llms.txt
+
+## Note
+
+This package is prepared for PyPI. Publishing requires a PyPI API token (not present in this environment).

x402check_langchain-0.1.0/x402check_langchain.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+x402check_langchain/__init__.py
+x402check_langchain.egg-info/PKG-INFO
+x402check_langchain.egg-info/SOURCES.txt
+x402check_langchain.egg-info/dependency_links.txt
+x402check_langchain.egg-info/requires.txt
+x402check_langchain.egg-info/top_level.txt

x402check_langchain-0.1.0/x402check_langchain.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

x402check_langchain-0.1.0/x402check_langchain.egg-info/requires.txt

@@ -0,0 +1,2 @@
+httpx>=0.27
+langchain-core>=0.3

x402check_langchain-0.1.0/x402check_langchain.egg-info/top_level.txt

@@ -0,0 +1 @@
+x402check_langchain