Skip to main content

Core Concepts

PTERI is one primitive repeated everywhere: sign, then verify.

A wallet signs a statement of intent. A verifier checks the signature and answers yes or no. That is the whole system. Login, step-up approval, a payment, an AI agent doing work — none of them are separate mechanisms. They are the same two steps with different payloads. Read the five words below and the rest of this site stops being jargon.

The vocabulary

The one flow you will see everywhere

┌──────────┐ ┌───────────┐ ┌──────────────┐ ┌───────────┐
│ Wallet │ ───▶ │ Signature │ ───▶ │ Verification │ ───▶ │ Outcome │
└──────────┘ └───────────┘ └──────────────┘ └───────────┘
holds the signs one checks the the action
private key exact action, signature — proceeds, or
on-device; with a short- valid or not it does not
servers never lived challenge valid, nothing
custody it so it cannot in between
be replayed

Every page in these docs is a variation on that line. Four concrete ones:

ScenarioWhat gets signedWhat the outcome isWalkthrough
LoginA single-use challenge from the backend — random nonce, short expiryThe backend verifies the signature, then issues its own session or JWTPasswordless SaaS login
Step-up approvalA fresh challenge for the one sensitive action being requestedThe role change, payout, or deletion executes only after that new signatureStep-up authentication
PaymentThe exact payment parameters — amount, destination, networkThe transaction settles on Litecoin, where anyone can verify itPayments and payouts
Agent actionThe specific task the agent has been given authority to performThe agent's action is attributable to its own cryptographic identityAI agents and workflows

The backend's job is the same in all four rows: issue a challenge, verify a signature, observe blockchain state. It never holds a key, signs for you, or recovers an identity.

Words we deliberately do not use

These are absent by design, not on a roadmap. Each one was left out because it would add trust assumptions without strengthening the proof.

  • Password — a shared secret both sides know can be phished, reused, or leaked from a database; a signature is never shared.
  • OTP secret — no seed to sync and no code to intercept, because freshness comes from a single-use challenge instead.
  • Static API key as proof of authority — a long-lived key grants ambient authority and cannot prove who approved what; authority is scoped per signed request instead.
  • Token — nothing in identity, authority, intent, verification, or settlement requires issuing one.
  • NFT / RWA — representational assets add attack surface and incentive misalignment without making any proof stronger.
  • OmniLite — an extra asset layer on top of Litecoin that the trust model has no use for.
  • Smart contract — there is no contract logic to audit or exploit; verification is a signature check.
  • IPFS — nothing is pinned off-chain, because identity lives in the wallet rather than in a stored file.

The full reasoning is in What PTERI Is NOT.

How these docs are labelled

Not everything on this site is equally nailed down. Three inline pills tell you which kind of statement you are reading.

LabelWhat it means
ConfirmedVerified against the published OpenAPI spec or against production behaviour. Build on it.
Product conceptArchitecture-level explanation. The implementation detail is intentionally omitted, so do not expect a route or a schema.
Needs verificationDescribed in the docs, but the exact route, schema, or limit has not been confirmed yet. Check before you depend on it.

A page can carry more than one. Pills appear next to the specific claim they cover, not only at the top of a page.

Next