paycensus 0.2.0__tar.gz

paycensus-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PayCensus Labs
+
+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.

paycensus-0.2.0/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: paycensus
+Version: 0.2.0
+Summary: Read-only client for the PayCensus machine-payment census (x402 + MPP, protocol-agnostic entity layer)
+Author: PayCensus Labs
+License: MIT
+Project-URL: Homepage, https://paycensus.com
+Project-URL: Source, https://github.com/OneLight1688/paycensus
+Keywords: x402,mpp,machine-payments,census,analytics,ai-agents
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# paycensus
+
+Read-only Python client for the [PayCensus](https://paycensus.com) machine-payment
+census data layer — *"The census of the machine economy."*
+
+PayCensus indexes **who pays whom** across machine-payment protocols — **x402**
+(EIP-3009 settlements on Base, facilitator programs on Solana) and **MPP**
+(Machine Payments Protocol; Tempo chain sampled hourly, offer graph parsed from
+sellers' 402 challenges) — per entity, not per protocol. The ingest layer records
+the protocol source; the entity layer does not care. A daily calendar is never
+backfilled, and a chained digest of every day's snapshot is anchored to Bitcoin
+via [OpenTimestamps](https://opentimestamps.org) — publicly verifiable, zero cost.
+
+## Install
+
+No PyPI release yet — install from source:
+
+```bash
+pip install git+https://github.com/OneLight1688/paycensus.git
+```
+
+## Usage
+
+Zero dependencies (stdlib only).
+
+```python
+from paycensus import PayCensus
+
+pc = PayCensus()
+
+pc.stats()                          # census totals + tempo_mpp sampled estimate
+pc.calendar()                       # daily calendar (never backfilled)
+pc.anchoring()                      # Bitcoin-anchored daily digests (verify with ots)
+pc.audit()                          # collection lineage + methodology
+
+pc.edges(limit=20, min_volume=10)   # top buyer x seller relationship edges
+pc.seller("0x…")                    # who pays this seller, daily series
+pc.buyer("0x…")                     # what this buyer pays for
+
+pc.mpp()                            # MPP/Tempo monitor: chain samples, offer graph,
+                                    # seller-side protocol census (x402/mpp/dual)
+```
+
+## Protocol coverage
+
+| Protocol | Settlement rail | Observation |
+|---|---|---|
+| x402 (EIP-3009) | Base USDC (counted), Solana facilitators (counted) | enumerated on-chain |
+| MPP | Tempo chain (sampled estimate), Stripe fiat rails (not observable) | hourly 50-block samples + 402-challenge offer graph |
+
+Sampled estimates are never merged into counted totals. When a new payment
+protocol with real adoption emerges, it is added at the ingest layer — the
+entity graph does not change.
+
+## Data boundaries
+
+- On-chain facts (addresses, amounts, timing) are public data.
+- Seller entities (domain/title/description) and 402-challenge quotes are the
+  seller's own public storefront info.
+- **Contact information is never collected into the public layer and never published.**
+- Any seller can be removed from the entity layer within 24h (opt-out).
+- Anchoring preserves *integrity*, not *correctness* — correctness comes from the
+  public methodology in `/data/audit.json`, which anyone can independently re-run.
+
+## License
+
+MIT

paycensus-0.2.0/README.md

@@ -0,0 +1,67 @@
+# paycensus
+
+Read-only Python client for the [PayCensus](https://paycensus.com) machine-payment
+census data layer — *"The census of the machine economy."*
+
+PayCensus indexes **who pays whom** across machine-payment protocols — **x402**
+(EIP-3009 settlements on Base, facilitator programs on Solana) and **MPP**
+(Machine Payments Protocol; Tempo chain sampled hourly, offer graph parsed from
+sellers' 402 challenges) — per entity, not per protocol. The ingest layer records
+the protocol source; the entity layer does not care. A daily calendar is never
+backfilled, and a chained digest of every day's snapshot is anchored to Bitcoin
+via [OpenTimestamps](https://opentimestamps.org) — publicly verifiable, zero cost.
+
+## Install
+
+No PyPI release yet — install from source:
+
+```bash
+pip install git+https://github.com/OneLight1688/paycensus.git
+```
+
+## Usage
+
+Zero dependencies (stdlib only).
+
+```python
+from paycensus import PayCensus
+
+pc = PayCensus()
+
+pc.stats()                          # census totals + tempo_mpp sampled estimate
+pc.calendar()                       # daily calendar (never backfilled)
+pc.anchoring()                      # Bitcoin-anchored daily digests (verify with ots)
+pc.audit()                          # collection lineage + methodology
+
+pc.edges(limit=20, min_volume=10)   # top buyer x seller relationship edges
+pc.seller("0x…")                    # who pays this seller, daily series
+pc.buyer("0x…")                     # what this buyer pays for
+
+pc.mpp()                            # MPP/Tempo monitor: chain samples, offer graph,
+                                    # seller-side protocol census (x402/mpp/dual)
+```
+
+## Protocol coverage
+
+| Protocol | Settlement rail | Observation |
+|---|---|---|
+| x402 (EIP-3009) | Base USDC (counted), Solana facilitators (counted) | enumerated on-chain |
+| MPP | Tempo chain (sampled estimate), Stripe fiat rails (not observable) | hourly 50-block samples + 402-challenge offer graph |
+
+Sampled estimates are never merged into counted totals. When a new payment
+protocol with real adoption emerges, it is added at the ingest layer — the
+entity graph does not change.
+
+## Data boundaries
+
+- On-chain facts (addresses, amounts, timing) are public data.
+- Seller entities (domain/title/description) and 402-challenge quotes are the
+  seller's own public storefront info.
+- **Contact information is never collected into the public layer and never published.**
+- Any seller can be removed from the entity layer within 24h (opt-out).
+- Anchoring preserves *integrity*, not *correctness* — correctness comes from the
+  public methodology in `/data/audit.json`, which anyone can independently re-run.
+
+## License
+
+MIT

paycensus-0.2.0/paycensus/__init__.py

@@ -0,0 +1,7 @@
+# -*- coding: utf-8 -*-
+"""paycensus: read-only client for the PayCensus machine-payment census data layer
+(x402 + MPP and successors — protocol-agnostic entity layer)."""
+from .client import PayCensus
+
+__version__ = "0.2.0"
+__all__ = ["PayCensus"]

paycensus-0.2.0/paycensus/client.py

@@ -0,0 +1,81 @@
+# -*- coding: utf-8 -*-
+"""stdlib-only client — zero dependencies, zero cost, read-only.
+
+All data comes from public endpoints of https://paycensus.com:
+  /data/stats.json      aggregate machine-payment census (x402 + MPP; tempo_mpp is a sampled estimate)
+  /data/calendar.json   daily calendar (self-contained records, never backfilled)
+  /data/audit.json      collection lineage + methodology
+  /data/anchoring.json  daily Bitcoin anchoring (OpenTimestamps receipts)
+  /data/entities.json   payTo -> domain/title/description (sellers only)
+  /data/leads.json      tier + protocol counters (counts only; contact emails are never published)
+  /data/mpp.json        MPP/Tempo monitor: chain samples, offer graph, seller-side protocol census
+  /api/seller /api/buyer /api/edges   processed commercial info (who pays whom)
+
+The entity layer is protocol-agnostic: protocol source is recorded at the ingest
+layer only; buyers, sellers and edges do not care which protocol carried the payment.
+"""
+import json
+from urllib.parse import urlencode
+from urllib.request import Request, urlopen
+
+DEFAULT_BASE = "https://paycensus.com"
+
+
+class PayCensus:
+    def __init__(self, base: str = DEFAULT_BASE, timeout: int = 15, user_agent: str = "paycensus/0.2"):
+        self.base = base.rstrip("/")
+        self.timeout = timeout
+        self.headers = {"User-Agent": user_agent, "Accept": "application/json"}
+
+    def _get(self, path: str, **params):
+        url = self.base + path
+        if params:
+            url += "?" + urlencode(params)
+        req = Request(url, headers=self.headers)
+        with urlopen(req, timeout=self.timeout) as r:
+            return json.loads(r.read().decode("utf-8"))
+
+    # ---- aggregate / trust layer -------------------------------------------------
+    def stats(self) -> dict:
+        """Aggregate census: txs, volume, unique buyers/sellers/edges (per chain),
+        plus tempo_mpp — the sampled MPP/Tempo estimate (never merged into counts)."""
+        return self._get("/data/stats.json")
+
+    def calendar(self) -> dict:
+        """Daily calendar — each day is a self-contained record and is never backfilled."""
+        return self._get("/data/calendar.json")
+
+    def audit(self) -> dict:
+        """Collection lineage: collectors, last runs, methodology, error counts."""
+        return self._get("/data/audit.json")
+
+    def anchoring(self) -> dict:
+        """Proof-of-Integrity: chained digests + OpenTimestamps Bitcoin receipts."""
+        return self._get("/data/anchoring.json")
+
+    # ---- enriched layers ----------------------------------------------------------
+    def entities(self) -> dict:
+        """payTo -> domain/title/description for on-chain matched sellers only."""
+        return self._get("/data/entities.json")
+
+    def leads(self) -> dict:
+        """Tier + protocol census counters (counts only). Emails are never published."""
+        return self._get("/data/leads.json")
+
+    def mpp(self) -> dict:
+        """MPP/Tempo monitor: hourly chain samples, offer graph parsed from
+        sellers' 402 challenges, seller-side protocol census (x402/mpp/dual)."""
+        return self._get("/data/mpp.json")
+
+    # ---- query API -----------------------------------------------------------------
+    def seller(self, addr: str) -> dict:
+        """Seller view: totals, daily series, buyers (where money comes from)."""
+        return self._get("/api/seller", addr=addr)
+
+    def buyer(self, addr: str) -> dict:
+        """Buyer view: totals, sellers paid (where money goes)."""
+        return self._get("/api/buyer", addr=addr)
+
+    def edges(self, limit: int = 50, min_volume: float = 0.0) -> dict:
+        """Top buyer x seller relationship edges."""
+        return self._get("/api/edges", limit=limit, min_volume=min_volume)

paycensus-0.2.0/paycensus.egg-info/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: paycensus
+Version: 0.2.0
+Summary: Read-only client for the PayCensus machine-payment census (x402 + MPP, protocol-agnostic entity layer)
+Author: PayCensus Labs
+License: MIT
+Project-URL: Homepage, https://paycensus.com
+Project-URL: Source, https://github.com/OneLight1688/paycensus
+Keywords: x402,mpp,machine-payments,census,analytics,ai-agents
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business :: Financial
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# paycensus
+
+Read-only Python client for the [PayCensus](https://paycensus.com) machine-payment
+census data layer — *"The census of the machine economy."*
+
+PayCensus indexes **who pays whom** across machine-payment protocols — **x402**
+(EIP-3009 settlements on Base, facilitator programs on Solana) and **MPP**
+(Machine Payments Protocol; Tempo chain sampled hourly, offer graph parsed from
+sellers' 402 challenges) — per entity, not per protocol. The ingest layer records
+the protocol source; the entity layer does not care. A daily calendar is never
+backfilled, and a chained digest of every day's snapshot is anchored to Bitcoin
+via [OpenTimestamps](https://opentimestamps.org) — publicly verifiable, zero cost.
+
+## Install
+
+No PyPI release yet — install from source:
+
+```bash
+pip install git+https://github.com/OneLight1688/paycensus.git
+```
+
+## Usage
+
+Zero dependencies (stdlib only).
+
+```python
+from paycensus import PayCensus
+
+pc = PayCensus()
+
+pc.stats()                          # census totals + tempo_mpp sampled estimate
+pc.calendar()                       # daily calendar (never backfilled)
+pc.anchoring()                      # Bitcoin-anchored daily digests (verify with ots)
+pc.audit()                          # collection lineage + methodology
+
+pc.edges(limit=20, min_volume=10)   # top buyer x seller relationship edges
+pc.seller("0x…")                    # who pays this seller, daily series
+pc.buyer("0x…")                     # what this buyer pays for
+
+pc.mpp()                            # MPP/Tempo monitor: chain samples, offer graph,
+                                    # seller-side protocol census (x402/mpp/dual)
+```
+
+## Protocol coverage
+
+| Protocol | Settlement rail | Observation |
+|---|---|---|
+| x402 (EIP-3009) | Base USDC (counted), Solana facilitators (counted) | enumerated on-chain |
+| MPP | Tempo chain (sampled estimate), Stripe fiat rails (not observable) | hourly 50-block samples + 402-challenge offer graph |
+
+Sampled estimates are never merged into counted totals. When a new payment
+protocol with real adoption emerges, it is added at the ingest layer — the
+entity graph does not change.
+
+## Data boundaries
+
+- On-chain facts (addresses, amounts, timing) are public data.
+- Seller entities (domain/title/description) and 402-challenge quotes are the
+  seller's own public storefront info.
+- **Contact information is never collected into the public layer and never published.**
+- Any seller can be removed from the entity layer within 24h (opt-out).
+- Anchoring preserves *integrity*, not *correctness* — correctness comes from the
+  public methodology in `/data/audit.json`, which anyone can independently re-run.
+
+## License
+
+MIT

paycensus-0.2.0/paycensus.egg-info/SOURCES.txt

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

paycensus-0.2.0/paycensus.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

paycensus-0.2.0/paycensus.egg-info/top_level.txt

@@ -0,0 +1 @@
+paycensus

paycensus-0.2.0/pyproject.toml

@@ -0,0 +1,24 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "paycensus"
+version = "0.2.0"
+description = "Read-only client for the PayCensus machine-payment census (x402 + MPP, protocol-agnostic entity layer)"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "PayCensus Labs" }]
+keywords = ["x402", "mpp", "machine-payments", "census", "analytics", "ai-agents"]
+classifiers = [
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Office/Business :: Financial",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://paycensus.com"
+Source = "https://github.com/OneLight1688/paycensus"

paycensus-0.2.0/setup.cfg

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