Capability status
Exactly what is built, what is live, and what is not. Every endpoint, with how each claim was checked.
This page is the reason you can trust the rest of the documentation. Everything a LibertyNet API can do carries one of four labels, and no page anywhere is allowed to describe a capability as more finished than this table says it is.
| Implemented | Live on a public endpoint. Call it today. |
| Not yet wired | The endpoint is live and returns 200, but its data source is not connected. It returns zeros and says so. |
| Testing | Code exists and its tests pass, but nothing public serves it yet. |
| Planned | Designed, not built. There is nothing behind it. |
Where these come from. The table below is derived from dev-portal/api-spec/status.json, the single machine-readable source that also drives the SDKs and the OpenAPI spec. A drift checker fails the build if a badge in the docs disagrees with it, so these cannot rot independently.
Last verified by direct endpoint probe: 2026-07-31.
Node discovery Implemented
Public. No key, no signup, no rate limit to apply for.
| Endpoint | Status | Notes |
|---|---|---|
GET /health | Implemented | Liveness + registered node count. |
GET /nodes | Implemented | The full node table. |
GET /peers | Implemented | Plain text, one peer per line, for shell tooling. |
GET /api/v1/peers | Implemented | JSON envelope form. |
POST /api/v1/register | Implemented | A node announces itself. Signature checking is in grace mode. |
POST /api/v1/heartbeat | Implemented | Refreshes last_seen. |
Operator identity Implemented
Signature-based login. There is no password in this system.
| Endpoint | Status | Notes |
|---|---|---|
POST /v1/auth/challenge | Implemented | Single-use, 300s TTL. |
POST /v1/auth/device-login | Implemented | Returns a 1-hour bearer session. |
GET /v1/operator/me/nodes | Implemented | Your bound nodes, with a computed online flag. |
Node ↔ operator binding Implemented
The full double-signature handshake, with all four signatures re-verified atomically before a binding becomes ACTIVE.
| Endpoint | Status |
|---|---|
POST /v1/bindings/initiate | Implemented |
POST /v1/bindings/resolve | Implemented |
POST /v1/bindings/authorize | Implemented |
GET /v1/bindings/{id}/status | Implemented |
POST /v1/bindings/{id}/cancel | Implemented |
POST /v1/node/bindings/pending | Implemented |
POST /v1/node/bindings/{id}/accept | Implemented |
POST /v1/node/bindings/{id}/reject | Implemented |
Credits and evidence Not yet wired
These endpoints are live and return 200, but nothing is behind them.
GET /v1/operator/me/credits returns settled, pending and estimated all equal to 0, together with "source": "not_yet_wired". That zero is a placeholder, not a measurement — it does not mean you earned nothing, it means nothing is counting yet.
If you render these numbers, render the caveat. The SDKs enforce this: settledCredits() raises rather than hand you a zero that could be displayed as a balance. Use creditsRaw() when you want the envelope and its source field.
| Endpoint | Status | Behaviour today |
|---|---|---|
GET /v1/operator/me/credits | Not yet wired | 200, all amounts 0, source: "not_yet_wired". |
GET /v1/operator/me/evidence | Not yet wired | 200, count: 0, source: "not_yet_wired". |
Credits are a test unit. Not cash. Not redeemable. Not a claim on future value. This sentence appears next to every Credits number in this documentation and in the Dashboard, and it is not decoration.
Oracle Testing
Genuinely different from "planned": the contracts exist and their suite passes. What is missing is a deployment.
| Component | Status | Notes |
|---|---|---|
EvidenceOracle | Testing | Solidity, 23/23 tests pass (libertynet-oracle/). Not deployed to any public network. |
PythPriceAdapter | Testing | Pull-mode adapter with freshness guard. Not deployed. |
GET /v1/oracle/price | Planned | No HTTP read surface exists. |
POST /v1/oracle/report | Planned | No HTTP submission surface exists. |
"Tests pass" and "deployed" are different claims, and merging them is one of the easiest ways for documentation to become false. There is no contract address to call, so oracle.price() in the SDKs raises with level: "testing" rather than "planned" — the distinction is real and worth preserving.
Not built Planned
No code, no endpoint, nothing to call. Listed so you can see the intended shape of the network, not so you can build against it.
| Area | Status | Why it is listed |
|---|---|---|
Agent wallet (create / session-key / transfer) | Planned | Value transfer is outside the current scope. |
Intent trading (intent / quote / solve / pools) | Planned | No endpoint, no matching engine. |
$LNT balance | Planned | No token surface exists. |
There is no endpoint in this API that moves value. No wallet, no swap, no staking, no token transfer, no trading. That is a deliberate scope decision. If you find a page that suggests otherwise, it is a bug — please report it.
How to check this yourself
You do not have to take this page's word for it.
# Live, right now, no auth:
curl -s https://registry.libertynet.ai/health
curl -s https://registry.libertynet.ai/nodes | head -c 300
# The honesty marker on an unwired endpoint:
curl -s https://registry.libertynet.ai/v1/operator/me/credits
# → {"code": "NO_SESSION", "error": "missing bearer token"}
# (authenticate and you will get 200 with "source": "not_yet_wired")The SDK ships a live test that asserts this page is still true:
cd dev-portal/sdk/typescript && npm run test:liveIt fails if any identity on the live registry stops verifying — which would mean either the network or this documentation is wrong, and either is worth knowing immediately.
When a status changes
A capability's badge changes in the same commit that changes its behaviour, never before. Concretely, shipping something means: implement it, flip it in status.json, and let the drift checker confirm every page agrees. Announcing first and shipping later is how "Planned" quietly becomes "Active" in a reader's memory, and this project does not do it.
If an endpoint behaves differently from what this page claims, that is a bug worth reporting — the fix is the code or the badge, never the wording.