theprotocol-sdk 0.7.0__tar.gz → 0.7.3__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/PKG-INFO +9 -2
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/README.md +8 -1
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/pyproject.toml +4 -2
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/__init__.py +1 -1
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/exchange/client.py +69 -18
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/mtls.py +9 -0
- theprotocol_sdk-0.7.3/tests/test_exchange_launch.py +84 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_mtls_enroll.py +40 -0
- theprotocol_sdk-0.7.0/.gitignore +0 -95
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/LICENSE +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/examples/simple_agent.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/agent/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/agent/base.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/agent/decorators.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/agent/router.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/agent/task_store.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/agent/well_known.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/auth/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/auth/did_jwt.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/auth/jws_card.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/auth/jwt_verifier.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/authz.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/bridges/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/bridges/acp.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/bridges/anp/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/bridges/anp/auth.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/bridges/anp/bridge.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/bridges/anp/did_wba.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/bridges/anp/translation.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/bridges/base.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/bridges/google_a2a.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/bridges/mcp.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/client/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/client/a2a_client.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/client/credentials.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/exceptions.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/exchange/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/forge.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/guild.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/messenger.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/models/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/models/a2a_protocol.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/models/agent_card.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/models/v1_compat.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/payment/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/payment/authenticator.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/payment/client.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/payment/mtls_client.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/payment/verifier.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/registry/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/registry/card_verify.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/registry/cost_composition.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/transfer/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/transfer/client.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/registry/__init__.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/registry/test_card_verify.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/registry/test_cost_composition.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_agent.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_artifact_roundtrip.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_auth.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_authz.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_bridge_acp.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_bridge_anp.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_bridge_google_a2a.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_bridge_mcp.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_credentials.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_did_jwt.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_forge.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_guild.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_jws_card.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_messenger.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_models.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_transfer.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_v1_compat.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_verifier_reuse.py +0 -0
- {theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/tests/test_well_known.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: theprotocol-sdk
|
|
3
|
-
Version: 0.7.
|
|
3
|
+
Version: 0.7.3
|
|
4
4
|
Summary: Build sovereign AI agents with DID identity on TheProtocol. Speaks the A2A protocol (v1.0) natively, with bridges for Google A2A, ANP, and MCP. Works with Vertex AI, AWS AgentCore, LangGraph, CrewAI.
|
|
5
5
|
Project-URL: Homepage, https://theprotocol.cloud
|
|
6
6
|
Project-URL: Documentation, https://docs.theprotocol.cloud
|
|
@@ -183,6 +183,13 @@ The private key is written `0600` into a `0700` directory, via a temp file and r
|
|
|
183
183
|
|
|
184
184
|
## Changelog
|
|
185
185
|
|
|
186
|
+
**0.7.3** (2026-09-22)
|
|
187
|
+
- `ExchangeClient` speaks the documented `/api/v1/agora` paths. Before its first call it asks the registry once whether it serves them; a registry older than V0419 (it does not know the route) is spoken to under `/api/v1/exchange` for the life of the client, so the client works against every registry, and keeps working after a later release drops the old paths. `launch_buy` posts to `launch/buy` (an older registry is sent its `ipo/buy`). `ExchangeClient.base` holds the resolved path.
|
|
188
|
+
- The build backend is pinned (`hatchling==1.27.0`), so every release carries the same package metadata version.
|
|
189
|
+
|
|
190
|
+
**0.7.2** (2026-09-22)
|
|
191
|
+
- AGORA words: `ExchangeClient.launch_buy` buys points at launch; `ipo_buy` still works and raises a `DeprecationWarning`. The client keeps calling the long-standing `/api/v1/exchange` paths, which every registry serves; registries from V0419 also answer the documented `/api/v1/agora` names.
|
|
192
|
+
|
|
186
193
|
**0.6.2** (2026-08-09)
|
|
187
194
|
- NEW `theprotocol.mtls.IronhandClient` — enroll for mTLS from anywhere: writes `svid.pem`/`key.pem`/`bundle.pem` (key `0600`, atomic replace) when the registry delivers inline, reports the on-host case without touching disk, and rotates via `ensure_fresh()` or a `start_auto_rotate()` background task. A settled refusal (`IronhandUnavailableError`, `IronhandPermissionError`) stops the rotation loop; transient errors are retried.
|
|
188
195
|
|
|
@@ -243,7 +250,7 @@ result = await client.call(target_url, payload)
|
|
|
243
250
|
|
|
244
251
|
## MCP Tools
|
|
245
252
|
|
|
246
|
-
For governance, staking, transfers, and discovery, connect any MCP client (Claude Desktop, Claude Code, ...) to the registry's [MCP server](https://api.theprotocol.cloud/mcp/sse). The public tool surface spans discovery, wallet, staking, governance, the Guild, and the AGORA
|
|
253
|
+
For governance, staking, transfers, and discovery, connect any MCP client (Claude Desktop, Claude Code, ...) to the registry's [MCP server](https://api.theprotocol.cloud/mcp/sse). The public tool surface spans discovery, wallet, staking, governance, the Guild, and the AGORA market; append `?mode=gateway` to browse it on demand instead of loading the full catalog.
|
|
247
254
|
|
|
248
255
|
## License
|
|
249
256
|
|
|
@@ -142,6 +142,13 @@ The private key is written `0600` into a `0700` directory, via a temp file and r
|
|
|
142
142
|
|
|
143
143
|
## Changelog
|
|
144
144
|
|
|
145
|
+
**0.7.3** (2026-09-22)
|
|
146
|
+
- `ExchangeClient` speaks the documented `/api/v1/agora` paths. Before its first call it asks the registry once whether it serves them; a registry older than V0419 (it does not know the route) is spoken to under `/api/v1/exchange` for the life of the client, so the client works against every registry, and keeps working after a later release drops the old paths. `launch_buy` posts to `launch/buy` (an older registry is sent its `ipo/buy`). `ExchangeClient.base` holds the resolved path.
|
|
147
|
+
- The build backend is pinned (`hatchling==1.27.0`), so every release carries the same package metadata version.
|
|
148
|
+
|
|
149
|
+
**0.7.2** (2026-09-22)
|
|
150
|
+
- AGORA words: `ExchangeClient.launch_buy` buys points at launch; `ipo_buy` still works and raises a `DeprecationWarning`. The client keeps calling the long-standing `/api/v1/exchange` paths, which every registry serves; registries from V0419 also answer the documented `/api/v1/agora` names.
|
|
151
|
+
|
|
145
152
|
**0.6.2** (2026-08-09)
|
|
146
153
|
- NEW `theprotocol.mtls.IronhandClient` — enroll for mTLS from anywhere: writes `svid.pem`/`key.pem`/`bundle.pem` (key `0600`, atomic replace) when the registry delivers inline, reports the on-host case without touching disk, and rotates via `ensure_fresh()` or a `start_auto_rotate()` background task. A settled refusal (`IronhandUnavailableError`, `IronhandPermissionError`) stops the rotation loop; transient errors are retried.
|
|
147
154
|
|
|
@@ -202,7 +209,7 @@ result = await client.call(target_url, payload)
|
|
|
202
209
|
|
|
203
210
|
## MCP Tools
|
|
204
211
|
|
|
205
|
-
For governance, staking, transfers, and discovery, connect any MCP client (Claude Desktop, Claude Code, ...) to the registry's [MCP server](https://api.theprotocol.cloud/mcp/sse). The public tool surface spans discovery, wallet, staking, governance, the Guild, and the AGORA
|
|
212
|
+
For governance, staking, transfers, and discovery, connect any MCP client (Claude Desktop, Claude Code, ...) to the registry's [MCP server](https://api.theprotocol.cloud/mcp/sse). The public tool surface spans discovery, wallet, staking, governance, the Guild, and the AGORA market; append `?mode=gateway` to browse it on demand instead of loading the full catalog.
|
|
206
213
|
|
|
207
214
|
## License
|
|
208
215
|
|
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
[build-system]
|
|
2
|
-
|
|
2
|
+
# Pinned (2026-09-22): hatchling 1.28+ writes Metadata-Version 2.5, which twine 6.2.0 refuses to upload
|
|
3
|
+
# ("'2.5' is not a valid metadata version"); 1.27.0 writes 2.4, the version every published release carries.
|
|
4
|
+
requires = ["hatchling==1.27.0"]
|
|
3
5
|
build-backend = "hatchling.build"
|
|
4
6
|
|
|
5
7
|
[project]
|
|
6
8
|
name = "theprotocol-sdk"
|
|
7
|
-
version = "0.7.
|
|
9
|
+
version = "0.7.3"
|
|
8
10
|
description = "Build sovereign AI agents with DID identity on TheProtocol. Speaks the A2A protocol (v1.0) natively, with bridges for Google A2A, ANP, and MCP. Works with Vertex AI, AWS AgentCore, LangGraph, CrewAI."
|
|
9
11
|
readme = "README.md"
|
|
10
12
|
license = {text = "Apache-2.0"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
"""
|
|
2
|
-
AGORA
|
|
2
|
+
AGORA Client: trade organization points on the AGORA market from agent code.
|
|
3
3
|
|
|
4
4
|
Market data is public; order/portfolio calls take the agent's JWT.
|
|
5
5
|
|
|
@@ -8,13 +8,14 @@ Market data is public; order/portfolio calls take the agent's JWT.
|
|
|
8
8
|
res = await ex.place_order(agent_jwt, "BL1F", "buy", qty=5, price="4.20")
|
|
9
9
|
await ex.cancel_order(agent_jwt, res["order_id"])
|
|
10
10
|
|
|
11
|
-
Money model (why you can trust it):
|
|
11
|
+
Money model (why you can trust it): points are registry-ledger entries; every
|
|
12
12
|
money leg settles through the venue escrow on TEG rails — buy escrow is taken
|
|
13
13
|
on placement, refunds/proceeds drain via the settlement worker. Fees come from
|
|
14
14
|
SELLER proceeds (a buy never pays more than its escrow). Supply Δ=0 by
|
|
15
|
-
construction; the venue self-checks via GET /
|
|
15
|
+
construction; the venue self-checks via GET /api/v1/agora/admin/invariant.
|
|
16
16
|
"""
|
|
17
17
|
import logging
|
|
18
|
+
import warnings
|
|
18
19
|
from typing import Any, Dict, List, Optional
|
|
19
20
|
|
|
20
21
|
import httpx
|
|
@@ -22,14 +23,53 @@ import httpx
|
|
|
22
23
|
logger = logging.getLogger(__name__)
|
|
23
24
|
|
|
24
25
|
|
|
26
|
+
AGORA_PREFIX = "/api/v1/agora"
|
|
27
|
+
LEGACY_PREFIX = "/api/v1/exchange"
|
|
28
|
+
|
|
29
|
+
|
|
30
|
+
def _route_missing(r: httpx.Response) -> bool:
|
|
31
|
+
"""A 404 whose registry did not know the ROUTE (detail exactly "Not Found"), as opposed to an answer like an
|
|
32
|
+
unknown listing, whose detail names the listing."""
|
|
33
|
+
if r.status_code != 404:
|
|
34
|
+
return False
|
|
35
|
+
try:
|
|
36
|
+
body = r.json()
|
|
37
|
+
except ValueError:
|
|
38
|
+
return True
|
|
39
|
+
detail = body.get("detail") if isinstance(body, dict) else None
|
|
40
|
+
return detail in (None, "Not Found")
|
|
41
|
+
|
|
42
|
+
|
|
25
43
|
class ExchangeClient:
|
|
26
|
-
"""Client for an AGORA
|
|
44
|
+
"""Client for an AGORA market (one registry hosting an order book).
|
|
45
|
+
|
|
46
|
+
0.7.3: the documented base path /api/v1/agora (every registry since V0419). Before its first call a client asks
|
|
47
|
+
the registry once whether it serves that path; a registry that does not know the route at all (an older one)
|
|
48
|
+
is spoken to under /api/v1/exchange for the life of the client, and `launch_buy` uses that registry's older
|
|
49
|
+
`ipo/buy` path. `base` holds the resolved path."""
|
|
27
50
|
|
|
28
51
|
def __init__(self, registry_url: str, timeout: float = 15.0):
|
|
29
|
-
self.
|
|
52
|
+
self._root = registry_url.rstrip("/")
|
|
53
|
+
self.base = self._root + AGORA_PREFIX
|
|
54
|
+
self._resolved = False
|
|
30
55
|
self._client: Optional[httpx.AsyncClient] = None
|
|
31
56
|
self._timeout = timeout
|
|
32
57
|
|
|
58
|
+
async def _resolve(self) -> None:
|
|
59
|
+
"""Ask once: GET <registry>/api/v1/agora/listings (public). A route-missing 404 means an older registry."""
|
|
60
|
+
try:
|
|
61
|
+
r = await self._c().get(self._root + AGORA_PREFIX + "/listings")
|
|
62
|
+
if _route_missing(r):
|
|
63
|
+
self.base = self._root + LEGACY_PREFIX
|
|
64
|
+
except httpx.HTTPError:
|
|
65
|
+
pass # keep the documented path: the real call raises with its own error
|
|
66
|
+
self._resolved = True
|
|
67
|
+
|
|
68
|
+
async def _url(self, path: str) -> str:
|
|
69
|
+
if not self._resolved:
|
|
70
|
+
await self._resolve()
|
|
71
|
+
return f"{self.base}{path}"
|
|
72
|
+
|
|
33
73
|
def _c(self) -> httpx.AsyncClient:
|
|
34
74
|
if self._client is None or self._client.is_closed:
|
|
35
75
|
self._client = httpx.AsyncClient(
|
|
@@ -48,33 +88,33 @@ class ExchangeClient:
|
|
|
48
88
|
|
|
49
89
|
# ── market data (public) ──────────────────────────────────────────
|
|
50
90
|
async def listings(self) -> List[Dict[str, Any]]:
|
|
51
|
-
r = await self._c().get(f"
|
|
91
|
+
r = await self._c().get(await self._url(f"/listings"))
|
|
52
92
|
r.raise_for_status()
|
|
53
93
|
return r.json().get("listings", [])
|
|
54
94
|
|
|
55
95
|
async def listing(self, ref: str) -> Dict[str, Any]:
|
|
56
|
-
r = await self._c().get(f"
|
|
96
|
+
r = await self._c().get(await self._url(f"/listings/{ref}"))
|
|
57
97
|
r.raise_for_status()
|
|
58
98
|
return r.json()
|
|
59
99
|
|
|
60
100
|
async def book(self, ref: str, depth: int = 12) -> Dict[str, Any]:
|
|
61
|
-
r = await self._c().get(f"
|
|
101
|
+
r = await self._c().get(await self._url(f"/listings/{ref}/book"), params={"depth": depth})
|
|
62
102
|
r.raise_for_status()
|
|
63
103
|
return r.json()
|
|
64
104
|
|
|
65
105
|
async def trades(self, ref: str, limit: int = 50) -> List[Dict[str, Any]]:
|
|
66
|
-
r = await self._c().get(f"
|
|
106
|
+
r = await self._c().get(await self._url(f"/listings/{ref}/trades"), params={"limit": limit})
|
|
67
107
|
r.raise_for_status()
|
|
68
108
|
return r.json().get("trades", [])
|
|
69
109
|
|
|
70
110
|
async def candles(self, ref: str, tf: str = "1h", limit: int = 120) -> List[Dict[str, Any]]:
|
|
71
|
-
r = await self._c().get(f"
|
|
111
|
+
r = await self._c().get(await self._url(f"/listings/{ref}/candles"), params={"tf": tf, "limit": limit})
|
|
72
112
|
r.raise_for_status()
|
|
73
113
|
return r.json().get("candles", [])
|
|
74
114
|
|
|
75
115
|
async def federation_tickers(self) -> List[Dict[str, Any]]:
|
|
76
116
|
"""Every live venue this registry can see (server-side aggregate)."""
|
|
77
|
-
r = await self._c().get(f"
|
|
117
|
+
r = await self._c().get(await self._url(f"/federation-tickers"))
|
|
78
118
|
r.raise_for_status()
|
|
79
119
|
return r.json().get("venues", [])
|
|
80
120
|
|
|
@@ -96,29 +136,40 @@ class ExchangeClient:
|
|
|
96
136
|
body["client_order_id"] = client_order_id
|
|
97
137
|
if ttl_seconds:
|
|
98
138
|
body["ttl_seconds"] = ttl_seconds
|
|
99
|
-
r = await self._c().post(f"
|
|
139
|
+
r = await self._c().post(await self._url(f"/orders"), json=body, headers=self._auth(agent_jwt))
|
|
100
140
|
r.raise_for_status()
|
|
101
141
|
return r.json()
|
|
102
142
|
|
|
103
143
|
async def cancel_order(self, agent_jwt: str, order_id: str) -> Dict[str, Any]:
|
|
104
|
-
r = await self._c().delete(f"
|
|
144
|
+
r = await self._c().delete(await self._url(f"/orders/{order_id}"), headers=self._auth(agent_jwt))
|
|
105
145
|
r.raise_for_status()
|
|
106
146
|
return r.json()
|
|
107
147
|
|
|
108
148
|
async def my_orders(self, agent_jwt: str, listing: Optional[str] = None) -> List[Dict[str, Any]]:
|
|
109
|
-
r = await self._c().get(f"
|
|
149
|
+
r = await self._c().get(await self._url(f"/orders/mine"),
|
|
110
150
|
params={"listing": listing} if listing else {},
|
|
111
151
|
headers=self._auth(agent_jwt))
|
|
112
152
|
r.raise_for_status()
|
|
113
153
|
return r.json().get("orders", [])
|
|
114
154
|
|
|
115
155
|
async def portfolio(self, agent_jwt: str) -> Dict[str, Any]:
|
|
116
|
-
r = await self._c().get(f"
|
|
156
|
+
r = await self._c().get(await self._url(f"/portfolio"), headers=self._auth(agent_jwt))
|
|
117
157
|
r.raise_for_status()
|
|
118
158
|
return r.json()
|
|
119
159
|
|
|
120
|
-
async def
|
|
121
|
-
|
|
122
|
-
|
|
160
|
+
async def launch_buy(self, agent_jwt: str, ref: str, qty: int) -> Dict[str, Any]:
|
|
161
|
+
"""Buy points at launch: from a listing's launch allocation, at the fixed launch price.
|
|
162
|
+
|
|
163
|
+
`/api/v1/agora/listings/{ref}/launch/buy`; an older registry (spoken to under /api/v1/exchange) is sent its
|
|
164
|
+
own `/listings/{ref}/ipo/buy`."""
|
|
165
|
+
url = await self._url(f"/listings/{ref}/")
|
|
166
|
+
url += "launch/buy" if self.base.endswith(AGORA_PREFIX) else "ipo/buy"
|
|
167
|
+
r = await self._c().post(url, json={"qty": qty}, headers=self._auth(agent_jwt))
|
|
123
168
|
r.raise_for_status()
|
|
124
169
|
return r.json()
|
|
170
|
+
|
|
171
|
+
async def ipo_buy(self, agent_jwt: str, ref: str, qty: int) -> Dict[str, Any]:
|
|
172
|
+
"""Deprecated: the earlier name of `launch_buy`. It keeps working and warns once per call site."""
|
|
173
|
+
warnings.warn("ExchangeClient.ipo_buy is deprecated; use ExchangeClient.launch_buy",
|
|
174
|
+
DeprecationWarning, stacklevel=2)
|
|
175
|
+
return await self.launch_buy(agent_jwt, ref, qty)
|
|
@@ -195,6 +195,15 @@ class IronhandClient:
|
|
|
195
195
|
detail = resp.text
|
|
196
196
|
if resp.status_code == 403 and "identity.mtls" in str(detail):
|
|
197
197
|
raise IronhandPermissionError(resp.status_code, detail)
|
|
198
|
+
# findings row 198 — a registry that CANNOT issue now says so with a 503 and a
|
|
199
|
+
# reason, instead of the 200 "enrolled" it used to answer while creating a SPIRE
|
|
200
|
+
# entry no agent could ever attest. That is the same condition `unavailable`
|
|
201
|
+
# describes (nothing was enrolled, nothing claims an identity), so it gets the same
|
|
202
|
+
# exception type rather than the generic one — a caller already branching on
|
|
203
|
+
# IronhandUnavailableError should not have to learn a second shape for it. The
|
|
204
|
+
# detail is passed through WHOLE: it names the cause, the fix and the doc link.
|
|
205
|
+
if resp.status_code == 503:
|
|
206
|
+
raise IronhandUnavailableError("unavailable", str(detail))
|
|
198
207
|
raise IronhandError(resp.status_code, detail)
|
|
199
208
|
|
|
200
209
|
body = resp.json()
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
"""§AGORAWORDS (0.7.2): ExchangeClient.launch_buy is the name; ipo_buy still works and warns. Hermetic via MockTransport."""
|
|
2
|
+
import json
|
|
3
|
+
|
|
4
|
+
import httpx
|
|
5
|
+
import pytest
|
|
6
|
+
|
|
7
|
+
from theprotocol.exchange.client import ExchangeClient
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
def _client(handler):
|
|
11
|
+
c = ExchangeClient("https://reg.example")
|
|
12
|
+
c._client = httpx.AsyncClient(transport=httpx.MockTransport(handler))
|
|
13
|
+
return c
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
@pytest.mark.asyncio
|
|
17
|
+
async def test_launch_buy_posts_the_documented_path_on_a_current_registry():
|
|
18
|
+
"""0.7.3: /api/v1/agora (the probe answers 200), and the launch purchase under its own name."""
|
|
19
|
+
seen = {}
|
|
20
|
+
|
|
21
|
+
def handler(request: httpx.Request) -> httpx.Response:
|
|
22
|
+
if request.method == "GET":
|
|
23
|
+
return httpx.Response(200, json={"listings": []})
|
|
24
|
+
seen["url"], seen["auth"], seen["body"] = str(request.url), request.headers.get("authorization"), json.loads(request.content)
|
|
25
|
+
return httpx.Response(200, json={"purchase_id": 7, "status": "pending", "qty": 5, "amount": "5"})
|
|
26
|
+
|
|
27
|
+
c = _client(handler)
|
|
28
|
+
out = await c.launch_buy("jwt-a", "ALFW", 5)
|
|
29
|
+
await c.aclose()
|
|
30
|
+
assert seen["url"] == "https://reg.example/api/v1/agora/listings/ALFW/launch/buy"
|
|
31
|
+
assert seen["auth"] == "Bearer jwt-a" and seen["body"] == {"qty": 5}
|
|
32
|
+
assert out["purchase_id"] == 7
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
@pytest.mark.asyncio
|
|
36
|
+
async def test_an_older_registry_is_spoken_to_under_the_old_path():
|
|
37
|
+
"""A registry before V0419 answers /api/v1/agora with a bare 404 "Not Found": the client keeps /api/v1/exchange
|
|
38
|
+
for its life, and the launch purchase goes to that registry's ipo/buy."""
|
|
39
|
+
seen = []
|
|
40
|
+
|
|
41
|
+
def handler(request: httpx.Request) -> httpx.Response:
|
|
42
|
+
seen.append((request.method, str(request.url)))
|
|
43
|
+
if "/api/v1/agora/" in str(request.url):
|
|
44
|
+
return httpx.Response(404, json={"detail": "Not Found"})
|
|
45
|
+
if request.method == "GET":
|
|
46
|
+
return httpx.Response(200, json={"listings": [{"symbol": "ALFW"}]})
|
|
47
|
+
return httpx.Response(200, json={"purchase_id": 9, "status": "pending", "qty": 1, "amount": "1"})
|
|
48
|
+
|
|
49
|
+
c = _client(handler)
|
|
50
|
+
rows = await c.listings()
|
|
51
|
+
out = await c.launch_buy("jwt-a", "ALFW", 1)
|
|
52
|
+
await c.aclose()
|
|
53
|
+
assert c.base == "https://reg.example/api/v1/exchange"
|
|
54
|
+
assert rows == [{"symbol": "ALFW"}] and out["purchase_id"] == 9
|
|
55
|
+
assert seen == [("GET", "https://reg.example/api/v1/agora/listings"),
|
|
56
|
+
("GET", "https://reg.example/api/v1/exchange/listings"),
|
|
57
|
+
("POST", "https://reg.example/api/v1/exchange/listings/ALFW/ipo/buy")]
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
@pytest.mark.asyncio
|
|
61
|
+
async def test_an_unknown_listing_is_an_answer_not_an_older_registry():
|
|
62
|
+
"""A business 404 (the listing is unknown) keeps the documented path; the caller sees the 404."""
|
|
63
|
+
def handler(request: httpx.Request) -> httpx.Response:
|
|
64
|
+
if str(request.url).endswith("/api/v1/agora/listings"):
|
|
65
|
+
return httpx.Response(200, json={"listings": []})
|
|
66
|
+
return httpx.Response(404, json={"detail": "listing 'NOPE' not found"})
|
|
67
|
+
|
|
68
|
+
c = _client(handler)
|
|
69
|
+
with pytest.raises(httpx.HTTPStatusError):
|
|
70
|
+
await c.listing("NOPE")
|
|
71
|
+
await c.aclose()
|
|
72
|
+
assert c.base == "https://reg.example/api/v1/agora"
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
@pytest.mark.asyncio
|
|
76
|
+
async def test_ipo_buy_is_a_deprecated_alias_with_the_same_result():
|
|
77
|
+
def handler(request: httpx.Request) -> httpx.Response:
|
|
78
|
+
return httpx.Response(200, json={"purchase_id": 8, "status": "pending", "qty": 2, "amount": "2"})
|
|
79
|
+
|
|
80
|
+
c = _client(handler)
|
|
81
|
+
with pytest.warns(DeprecationWarning, match="launch_buy"):
|
|
82
|
+
out = await c.ipo_buy("jwt-a", "ALFW", 2)
|
|
83
|
+
await c.aclose()
|
|
84
|
+
assert out["purchase_id"] == 8
|
|
@@ -268,3 +268,43 @@ async def test_paths_match_what_mtls_agent_client_reads(tmp_path):
|
|
|
268
268
|
|
|
269
269
|
def test_seconds_remaining_handles_absent_expiry():
|
|
270
270
|
assert Enrollment(delivery="inline", status="enrolled").seconds_remaining() is None
|
|
271
|
+
|
|
272
|
+
|
|
273
|
+
# ── findings row 198 — a registry that cannot issue says so, and the SDK classifies it ──
|
|
274
|
+
|
|
275
|
+
@pytest.mark.asyncio
|
|
276
|
+
async def test_a_503_refusal_is_an_unavailable_not_a_generic_error():
|
|
277
|
+
"""The registry used to answer 200 "enrolled" while creating a SPIRE entry no agent could
|
|
278
|
+
ever attest. It now refuses with 503 and a reason. That is the same CONDITION `unavailable`
|
|
279
|
+
already described — nothing enrolled, nothing claiming an identity — so a caller already
|
|
280
|
+
branching on IronhandUnavailableError must not have to learn a second shape for it."""
|
|
281
|
+
detail = ("The SPIRE agent node chosen to parent this identity (4605f286…) is not one of "
|
|
282
|
+
"this frame's 3 live agent node(s) ... How mTLS identities are issued: "
|
|
283
|
+
"https://docs.theprotocol.cloud/learn/security")
|
|
284
|
+
|
|
285
|
+
def handler(request: httpx.Request) -> httpx.Response:
|
|
286
|
+
return httpx.Response(503, json={"detail": detail})
|
|
287
|
+
|
|
288
|
+
client = IronhandClient(registry_url="https://eu.example",
|
|
289
|
+
transport=httpx.MockTransport(handler))
|
|
290
|
+
with pytest.raises(IronhandUnavailableError) as e:
|
|
291
|
+
await client.enroll("agent-jwt")
|
|
292
|
+
assert e.value.delivery == "unavailable"
|
|
293
|
+
# the reason and the link must survive WHOLE — a truncated refusal is how the caller ends
|
|
294
|
+
# up guessing, which is the entire failure this row is about
|
|
295
|
+
assert "live agent node" in str(e.value)
|
|
296
|
+
assert "docs.theprotocol.cloud/learn/security" in str(e.value)
|
|
297
|
+
|
|
298
|
+
|
|
299
|
+
@pytest.mark.asyncio
|
|
300
|
+
async def test_other_non_2xx_are_still_generic_errors():
|
|
301
|
+
"""The control: only 503 changes shape. A 500 must stay an IronhandError, or this mapping
|
|
302
|
+
would be swallowing failures it does not understand."""
|
|
303
|
+
def handler(request: httpx.Request) -> httpx.Response:
|
|
304
|
+
return httpx.Response(500, json={"detail": "boom"})
|
|
305
|
+
|
|
306
|
+
client = IronhandClient(registry_url="https://eu.example",
|
|
307
|
+
transport=httpx.MockTransport(handler))
|
|
308
|
+
with pytest.raises(IronhandError) as e:
|
|
309
|
+
await client.enroll("agent-jwt")
|
|
310
|
+
assert not isinstance(e.value, IronhandUnavailableError)
|
theprotocol_sdk-0.7.0/.gitignore
DELETED
|
@@ -1,95 +0,0 @@
|
|
|
1
|
-
# TheProtocol — Root .gitignore
|
|
2
|
-
# Created: 2026-03-09 (§4.1 Credentials Rotation)
|
|
3
|
-
|
|
4
|
-
# !! NEVER COMMIT SECRETS / LOCAL CONFIG !!
|
|
5
|
-
# All env files except *.example templates. Covers .env, .env.production,
|
|
6
|
-
# .env.frame-b, .env.frame-c, .env.operator, .env.docker, and nested
|
|
7
|
-
# AgentVault/.../.env — while keeping the committed *.env.example templates.
|
|
8
|
-
.env
|
|
9
|
-
.env.*
|
|
10
|
-
!.env.example
|
|
11
|
-
# Local agent / MCP config — these carry live API keys
|
|
12
|
-
.mcp.json
|
|
13
|
-
.claude/
|
|
14
|
-
|
|
15
|
-
# Session logs (operational, not source)
|
|
16
|
-
sessionlogs2026/
|
|
17
|
-
|
|
18
|
-
# Debug/runtime artifacts
|
|
19
|
-
logs/
|
|
20
|
-
*.log
|
|
21
|
-
APEX_PREDATOR_JOBS.log
|
|
22
|
-
|
|
23
|
-
# Node
|
|
24
|
-
node_modules/
|
|
25
|
-
|
|
26
|
-
# Python
|
|
27
|
-
__pycache__/
|
|
28
|
-
*.pyc
|
|
29
|
-
*.pyo
|
|
30
|
-
*.pyd
|
|
31
|
-
.venv/
|
|
32
|
-
*.egg-info/
|
|
33
|
-
dist/
|
|
34
|
-
build/
|
|
35
|
-
|
|
36
|
-
# OS
|
|
37
|
-
.DS_Store
|
|
38
|
-
Thumbs.db
|
|
39
|
-
|
|
40
|
-
# Backups / snapshots — carry stale secrets + bloat
|
|
41
|
-
# (e.g. *.bak-pre-*, PRODUCTION_DOCS.bak-*, CLAUDE.md.bak-*, main.py.bak-*)
|
|
42
|
-
*.bak*
|
|
43
|
-
*.pre-*
|
|
44
|
-
|
|
45
|
-
# §2026-06-29 OSS secrets scrub (#153) — internal AI-operational docs + credential
|
|
46
|
-
# references that carry live secrets and MUST NOT ship to a public repo. These are
|
|
47
|
-
# operator/agent briefings, not platform source.
|
|
48
|
-
CLAUDE.md
|
|
49
|
-
CLAUDE_ADMIN.md
|
|
50
|
-
MY_APEX_PREDATOR_TOOLING.md
|
|
51
|
-
PRODUCTION_DOCS/CREDENTIALS_REFERENCE.md
|
|
52
|
-
# Sim/dev credential blobs
|
|
53
|
-
scripts/sim_credentials.json
|
|
54
|
-
**/*credentials*.json
|
|
55
|
-
|
|
56
|
-
# Throwaway FE screenshot/diag scripts (scratch, carry prod creds)
|
|
57
|
-
AgentVault/agentvault_registry/src/agentvault_registry/static/new_registry_frontend/shot_*.mjs
|
|
58
|
-
AgentVault/agentvault_registry/src/agentvault_registry/static/new_registry_frontend/diag_*.mjs
|
|
59
|
-
AgentVault/agentvault_registry/src/agentvault_registry/static/new_registry_frontend/gate_*.mjs
|
|
60
|
-
|
|
61
|
-
# --- 2026-08-05 §FORGEJO migration: runtime data, generated artifacts, secret carriers ---
|
|
62
|
-
# Live bind-mounted container state (TheAuditor/data alone is 4.7G)
|
|
63
|
-
Agents/*/data/
|
|
64
|
-
Agents/*/logs/
|
|
65
|
-
Agents/*/circuits/
|
|
66
|
-
bundle-storage*/
|
|
67
|
-
# Generated release artifacts (operator-cli tarballs) + build output
|
|
68
|
-
dist/
|
|
69
|
-
docs-site/.vitepress/cache/
|
|
70
|
-
docs-site/.vitepress/dist/
|
|
71
|
-
# Backups carry copies of env files = secrets
|
|
72
|
-
backups/
|
|
73
|
-
*.bak*
|
|
74
|
-
# Secret carriers
|
|
75
|
-
docker-certs/
|
|
76
|
-
private/
|
|
77
|
-
*credentials*.json
|
|
78
|
-
*.secret.txt
|
|
79
|
-
*.secret.env
|
|
80
|
-
*.secret.json
|
|
81
|
-
|
|
82
|
-
# --- 2026-08-05 §FORGEJO hygiene pass 2: key material + credential notes never enter git ---
|
|
83
|
-
*.key
|
|
84
|
-
*.pem
|
|
85
|
-
*htpasswd*
|
|
86
|
-
*[Cc]redentials.md
|
|
87
|
-
scripts/sim_credentials.md
|
|
88
|
-
# MCP bridge JS with embedded per-registry API keys (operational config, not source)
|
|
89
|
-
mcp-theprotocol-b-bridge.js
|
|
90
|
-
mcp-theprotocol-admin-b-bridge.js
|
|
91
|
-
|
|
92
|
-
# Generated review pages: base64-inlines every frame, so each republish adds
|
|
93
|
-
# multiple MB of blob for something three committed inputs reproduce exactly
|
|
94
|
-
# (the source .txt, the builder .py, and the frames in the FE's public/blog).
|
|
95
|
-
scratchpad/post*_preview.html
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{theprotocol_sdk-0.7.0 → theprotocol_sdk-0.7.3}/src/theprotocol/registry/cost_composition.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|