voidly-pay 2.0.0__tar.gz → 2.0.2__tar.gz

{voidly_pay-2.0.0 → voidly_pay-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voidly-pay
-Version: 2.0.0
+Version: 2.0.2
 Summary: Voidly Pay SDK — open marketplace for AI-agent payments. claim() + request_with_pay() handle x402 end-to-end. USDC-backed Sourcify-verified vault on Base mainnet.
 Author-email: Voidly <team@voidly.ai>
 License: MIT
@@ -20,7 +20,7 @@ Requires-Dist: responses>=0.23; extra == "dev"
 
 [![PyPI version](https://img.shields.io/pypi/v/voidly-pay)](https://pypi.org/project/voidly-pay/)
 [![x402](https://img.shields.io/badge/x402-canonical%20v2-blue)](https://www.x402.org)
-[![vault](https://img.shields.io/badge/vault-Sourcify%20verified-emerald)](https://repo.sourcify.dev/contracts/full_match/8453/0xb592512932a7b354969bb48039c2dc7ad6ad1c12/)
+[![vault](https://img.shields.io/badge/vault-Sourcify%20verified-emerald)](https://repo.sourcify.dev/contracts/full_match/8453/0xd25d3c6f32886b65356cc5c700382a8a02d84df5/)
 
 ```bash
 pip install voidly-pay
@@ -188,7 +188,7 @@ ok = verify_webhook_signature(
 
 ## Honest disclosure
 
-The Voidly Pay vault on Base mainnet (`0xb592512932a7b354969bb48039c2dc7ad6ad1c12`, [Sourcify-verified](https://repo.sourcify.dev/contracts/full_match/8453/0xb592512932a7b354969bb48039c2dc7ad6ad1c12/)) currently holds **$4 USDC**. We have approximately zero sustained external paying users yet. Live reserves at [voidly.ai/pay/proof](https://voidly.ai/pay/proof).
+The Voidly Pay vault on Base mainnet (`0xd25d3c6f32886b65356cc5c700382a8a02d84df5`, [Sourcify-verified](https://repo.sourcify.dev/contracts/full_match/8453/0xd25d3c6f32886b65356cc5c700382a8a02d84df5/)) currently holds **$4 USDC**. We have approximately zero sustained external paying users yet. Live reserves at [voidly.ai/pay/proof](https://voidly.ai/pay/proof).
 
 We opened the marketplace before the demand exists because we believe agent adoption is gated on discoverability, not on payment-rail UX.
 

{voidly_pay-2.0.0 → voidly_pay-2.0.2}/README.md

@@ -4,7 +4,7 @@
 
 [![PyPI version](https://img.shields.io/pypi/v/voidly-pay)](https://pypi.org/project/voidly-pay/)
 [![x402](https://img.shields.io/badge/x402-canonical%20v2-blue)](https://www.x402.org)
-[![vault](https://img.shields.io/badge/vault-Sourcify%20verified-emerald)](https://repo.sourcify.dev/contracts/full_match/8453/0xb592512932a7b354969bb48039c2dc7ad6ad1c12/)
+[![vault](https://img.shields.io/badge/vault-Sourcify%20verified-emerald)](https://repo.sourcify.dev/contracts/full_match/8453/0xd25d3c6f32886b65356cc5c700382a8a02d84df5/)
 
 ```bash
 pip install voidly-pay
@@ -172,7 +172,7 @@ ok = verify_webhook_signature(
 
 ## Honest disclosure
 
-The Voidly Pay vault on Base mainnet (`0xb592512932a7b354969bb48039c2dc7ad6ad1c12`, [Sourcify-verified](https://repo.sourcify.dev/contracts/full_match/8453/0xb592512932a7b354969bb48039c2dc7ad6ad1c12/)) currently holds **$4 USDC**. We have approximately zero sustained external paying users yet. Live reserves at [voidly.ai/pay/proof](https://voidly.ai/pay/proof).
+The Voidly Pay vault on Base mainnet (`0xd25d3c6f32886b65356cc5c700382a8a02d84df5`, [Sourcify-verified](https://repo.sourcify.dev/contracts/full_match/8453/0xd25d3c6f32886b65356cc5c700382a8a02d84df5/)) currently holds **$4 USDC**. We have approximately zero sustained external paying users yet. Live reserves at [voidly.ai/pay/proof](https://voidly.ai/pay/proof).
 
 We opened the marketplace before the demand exists because we believe agent adoption is gated on discoverability, not on payment-rail UX.
 

{voidly_pay-2.0.0 → voidly_pay-2.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "voidly-pay"
-version = "2.0.0"
+version = "2.0.2"
 description = "Voidly Pay SDK — open marketplace for AI-agent payments. claim() + request_with_pay() handle x402 end-to-end. USDC-backed Sourcify-verified vault on Base mainnet."
 readme = "README.md"
 requires-python = ">=3.10"

{voidly_pay-2.0.0 → voidly_pay-2.0.2}/voidly_pay/__init__.py

@@ -500,6 +500,176 @@ class VoidlyPay:
     def trust(self, did: str | None = None) -> dict:
         return self._req("GET", f"/v1/pay/trust/{did or self.did}")
 
+    # ─── Capability marketplace + hire (1.0.x compat surface) ──────────────
+    # These methods are kept for framework-adapter packages
+    # (voidly-pay-langchain, -crewai, -pydantic-ai, -autogen, -llamaindex)
+    # which were built against the 1.0.x API. New code should prefer
+    # /v1/pay/listings + the marketplace endpoint instead.
+
+    def capability_list(
+        self,
+        capability: str,
+        name: str,
+        description: str = "",
+        price_credits: float = 0.001,
+        unit: str = "call",
+        sla_deadline_hours: int = 24,
+        tags: list | None = None,
+    ) -> dict:
+        """Provider-signed capability listing. UPSERT on (provider DID, capability slug)."""
+        env = {
+            "schema": "voidly-capability-list/v1",
+            "did": self.did,
+            "capability": capability,
+            "name": name,
+            "description": description,
+            "price_micro": round(price_credits * MICRO_PER_CREDIT),
+            "unit": unit,
+            "sla_deadline_hours": sla_deadline_hours,
+            "tags": tags,
+            "nonce": uuid.uuid4().hex,
+            "issued_at": self._now_iso(),
+            "expires_at": self._expires(),
+        }
+        return self._req("POST", "/v1/pay/capability/list", {"envelope": env, "signature": self._sign(env)})
+
+    def capability_search(
+        self,
+        q: str | None = None,
+        capability: str | None = None,
+        max_price_credits: float | None = None,
+        provider_did: str | None = None,
+        limit: int = 50,
+    ) -> dict:
+        params = []
+        if q: params.append(f"q={requests.utils.quote(q)}")
+        if capability: params.append(f"capability={requests.utils.quote(capability)}")
+        if max_price_credits is not None: params.append(f"max_price_micro={round(max_price_credits * MICRO_PER_CREDIT)}")
+        if provider_did: params.append(f"provider_did={provider_did}")
+        params.append(f"limit={limit}")
+        qs = "?" + "&".join(params) if params else ""
+        return self._req("GET", f"/v1/pay/capability/search{qs}")
+
+    # alias used by some framework adapters
+    def capability(self, *args, **kwargs):
+        return self.capability_list(*args, **kwargs)
+
+    def hire(
+        self,
+        capability_id: str,
+        input: Any = None,
+        task_id: str | None = None,
+        delivery_deadline_hours: int = 24,
+    ) -> dict:
+        """Atomic hire — opens escrow + records hire in one call. Server-pinned price."""
+        env = {
+            "schema": "voidly-hire-request/v1",
+            "did": self.did,
+            "capability_id": capability_id,
+            "input": input,
+            "task_id": task_id or uuid.uuid4().hex,
+            "delivery_deadline_hours": delivery_deadline_hours,
+            "nonce": uuid.uuid4().hex,
+            "issued_at": self._now_iso(),
+            "expires_at": self._expires(),
+        }
+        return self._req("POST", "/v1/pay/hire", {"envelope": env, "signature": self._sign(env)})
+
+    def hire_get(self, hire_id: str) -> dict:
+        return self._req("GET", f"/v1/pay/hire/{hire_id}")
+
+    def hires_incoming(self, did: str | None = None, state: str | None = None, limit: int = 50) -> dict:
+        target = did or self.did
+        qs = f"?limit={limit}" + (f"&state={requests.utils.quote(state)}" if state else "")
+        return self._req("GET", f"/v1/pay/hire/incoming/{target}{qs}")
+
+    def hires_outgoing(self, did: str | None = None, state: str | None = None, limit: int = 50) -> dict:
+        target = did or self.did
+        qs = f"?limit={limit}" + (f"&state={requests.utils.quote(state)}" if state else "")
+        return self._req("GET", f"/v1/pay/hire/outgoing/{target}{qs}")
+
+    def hire_and_wait(
+        self,
+        capability_id: str,
+        input: Any = None,
+        task_id: str | None = None,
+        delivery_deadline_hours: int = 24,
+        poll_interval_s: float = 1.0,
+        timeout_s: float = 30.0,
+    ) -> dict:
+        """Hire + poll until completion. Returns the final hire state."""
+        import time
+        h = self.hire(capability_id, input=input, task_id=task_id, delivery_deadline_hours=delivery_deadline_hours)
+        hire_id = h.get("hire_id") or h.get("id")
+        if not hire_id:
+            return h
+        deadline = time.time() + timeout_s
+        while time.time() < deadline:
+            state = self.hire_get(hire_id)
+            if state.get("hire", {}).get("state") in ("completed", "disputed", "expired"):
+                return state
+            time.sleep(poll_interval_s)
+        return state  # whatever the last poll showed
+
+    # alias for adapters that use `escrow` as a single namespace
+    def escrow(self, op: str, **kwargs):
+        if op == "open": return self.open_escrow(**kwargs)
+        if op == "release": return self.release_escrow(**kwargs)
+        if op == "refund": return self.refund_escrow(**kwargs)
+        raise VoidlyPayError(code="bad_escrow_op", message=f"unknown escrow op: {op}", status=400)
+
+    # Marketplace listings (Round 31 surface — also kept for 1.0 compat)
+    def list_endpoint(
+        self,
+        name: str,
+        tagline: str,
+        url: str,
+        amount_usdc: float,
+        description: str | None = None,
+        category: str | None = None,
+        method: str = "GET",
+        receiver_did: str | None = None,
+        free_tier_url: str | None = None,
+        free_tier_description: str | None = None,
+        try_url: str | None = None,
+        info_url: str | None = None,
+        tags: list | None = None,
+        why_unique: str | None = None,
+        examples: list | None = None,
+    ) -> dict:
+        env = {
+            "schema": "voidly-pay-listing-create/v1",
+            "did": self.did,
+            "name": name,
+            "tagline": tagline,
+            "url": url,
+            "method": method,
+            "pricing": {"amount_micro": round(amount_usdc * MICRO_PER_CREDIT), "currency": "voidly-credit", "model": "per-call"},
+            "nonce": uuid.uuid4().hex,
+            "issued_at": self._now_iso(),
+            "expires_at": self._expires(),
+        }
+        if description: env["description"] = description
+        if category: env["category"] = category
+        if receiver_did: env["receiver_did"] = receiver_did
+        if free_tier_url: env["free_tier_url"] = free_tier_url
+        if free_tier_description: env["free_tier_description"] = free_tier_description
+        if try_url: env["try_url"] = try_url
+        if info_url: env["info_url"] = info_url
+        if tags: env["tags"] = tags
+        if why_unique: env["why_unique"] = why_unique
+        if examples: env["examples"] = examples
+        return self._req("POST", "/v1/pay/listings", {"envelope": env, "signature": self._sign(env)})
+
+    def marketplace(self) -> dict:
+        return self._req("GET", "/v1/pay/marketplace")
+
+    def listings(self, limit: int = 50, offset: int = 0, tag: str | None = None, category: str | None = None) -> dict:
+        params = [f"limit={limit}", f"offset={offset}"]
+        if tag: params.append(f"tag={requests.utils.quote(tag)}")
+        if category: params.append(f"category={requests.utils.quote(category)}")
+        return self._req("GET", f"/v1/pay/listings?" + "&".join(params))
+
 
 # ─── Webhook signature verification ──────────────────────────────────────
 

{voidly_pay-2.0.0 → voidly_pay-2.0.2}/voidly_pay.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voidly-pay
-Version: 2.0.0
+Version: 2.0.2
 Summary: Voidly Pay SDK — open marketplace for AI-agent payments. claim() + request_with_pay() handle x402 end-to-end. USDC-backed Sourcify-verified vault on Base mainnet.
 Author-email: Voidly <team@voidly.ai>
 License: MIT
@@ -20,7 +20,7 @@ Requires-Dist: responses>=0.23; extra == "dev"
 
 [![PyPI version](https://img.shields.io/pypi/v/voidly-pay)](https://pypi.org/project/voidly-pay/)
 [![x402](https://img.shields.io/badge/x402-canonical%20v2-blue)](https://www.x402.org)
-[![vault](https://img.shields.io/badge/vault-Sourcify%20verified-emerald)](https://repo.sourcify.dev/contracts/full_match/8453/0xb592512932a7b354969bb48039c2dc7ad6ad1c12/)
+[![vault](https://img.shields.io/badge/vault-Sourcify%20verified-emerald)](https://repo.sourcify.dev/contracts/full_match/8453/0xd25d3c6f32886b65356cc5c700382a8a02d84df5/)
 
 ```bash
 pip install voidly-pay
@@ -188,7 +188,7 @@ ok = verify_webhook_signature(
 
 ## Honest disclosure
 
-The Voidly Pay vault on Base mainnet (`0xb592512932a7b354969bb48039c2dc7ad6ad1c12`, [Sourcify-verified](https://repo.sourcify.dev/contracts/full_match/8453/0xb592512932a7b354969bb48039c2dc7ad6ad1c12/)) currently holds **$4 USDC**. We have approximately zero sustained external paying users yet. Live reserves at [voidly.ai/pay/proof](https://voidly.ai/pay/proof).
+The Voidly Pay vault on Base mainnet (`0xd25d3c6f32886b65356cc5c700382a8a02d84df5`, [Sourcify-verified](https://repo.sourcify.dev/contracts/full_match/8453/0xd25d3c6f32886b65356cc5c700382a8a02d84df5/)) currently holds **$4 USDC**. We have approximately zero sustained external paying users yet. Live reserves at [voidly.ai/pay/proof](https://voidly.ai/pay/proof).
 
 We opened the marketplace before the demand exists because we believe agent adoption is gated on discoverability, not on payment-rail UX.