Credits

What Credits are, what they are not, and why the endpoint currently returns zeros on purpose.

#Current state: nothing is counting अभी जुड़ा नहीं

GET /v1/operator/me/credits is live and returns 200. It also returns this:

{
  "operator_did": "did:svrp:o:<your-operator-id>",
  "unit": "test-credit",
  "settled":   { "amount": 0, "meaning": "已入账：由 Evidence 验证与结算系统确认" },
  "pending":   { "amount": 0, "meaning": "待验证：Evidence 已提交，尚未完成验证或结算" },
  "estimated": { "amount": 0, "meaning": "模拟估算：内测模型估算，不代表承诺或未来价值" },
  "source": "not_yet_wired"
}

"source": "not_yet_wired" is the field that matters. It means no credits ledger is connected to this endpoint. Every amount is a placeholder, not a measurement.

#How the SDKs enforce that

Rather than trusting every caller to remember, the SDKs make the honest path the easy one and the dishonest path impossible:

// Raises rather than hand you a misleading zero.
await ln.operator.settledCredits();
// → NotYetWiredError [NOT_YET_WIRED]: GET /v1/operator/me/credits is not_yet_wired:
//   the endpoint is live but no credits ledger is connected, so the returned 0 is a
//   placeholder rather than a balance.
//   → https://docs.libertynet.ai/status

// The honest read — envelope and `source` intact, for you to display with its caveat.
const balance = await ln.operator.creditsRaw();
if (balance.source === "not_yet_wired") {
  render("Not connected yet");
} else {
  render(balance.settled.amount);
}

# Raises rather than hand you a misleading zero.
ln.operator.settled_credits()
# → NotYetWiredError: [NOT_YET_WIRED] GET /v1/operator/me/credits is not_yet_wired: ...

# The honest read — envelope and `source` intact.
balance = ln.operator.credits_raw()
render("Not connected yet" if not balance.is_wired else balance.settled["amount"])

settledCredits() starts working, with no code change on your side, the moment source becomes "ledger".

#The three buckets

When a ledger is connected, Credits will be reported in three separate states — and they are deliberately not summed into one number, because summing them would blur exactly the distinctions that matter.

A UI that adds these together and shows one figure is misrepresenting all three.

#Evidence

Credits, when they are counted, will be derived from Evidence — signed, verifiable records of contribution — rather than from self-reported activity. That is what makes the number checkable rather than claimed.

GET /v1/operator/me/evidence is also live and also unwired: count: 0, "source": "not_yet_wired". अभी जुड़ा नहीं

The on-chain side of evidence anchoring exists as tested contracts (libertynet-oracle/, 23/23 passing) but is not deployed to any public network. परीक्षण में

#What Credits will never be, here

There is no endpoint in this API that moves value. No wallet, no transfer, no swap, no staking, no trading — see capability status for the current list.

If a future version adds any of that, it will arrive with its own documentation, its own badge, and its own review. It will not arrive quietly inside a page about test units.