GitHub

Learn

Glossary

Every PATH term, defined once, plus the terms that were retired and what replaced them.

Core

PATH — the protocol. Not a company, a network, or a product.

Network — an operator of a directory, which admits members, publishes a rulebook and arbitrates disputes. There can be many. A network is not the protocol.

Member — an institution admitted to a network: a fintech, a bank, an electronic money institution.

Operator — whoever runs an implementation. A member is an operator; not every operator is a member.

Subject — the person or legal entity a PATH identity refers to. Carries no personal data in the protocol itself.

Ring 1 / Ring 2 / Ring 3 — open formats / the network's directory and what depends on it / the operator's private data. See Networks and members.

The pillars

PATH ID — who are you. Subject identifiers, verified identifiers, attestations, revocation.

PATH ADDRESS — where to send, and the standing terms of receiving. Opaque addresses, receive targets, standing intent.

PATH REQUEST — what is owed. Payment requests and checkout sessions. The only pillar that starts from the receiver.

PATH CONNECT — who may act. Connection requests, delegation, mandates, scopes, counters, revocation.

PATH SETTLEMENT — how it is proven. Signed receipts, lifecycle, reconciliation.

PATH LIQUIDITYRESERVED. Routing is out of scope for v0.1; the route field is declared and never populated.

Reachability

PATH FINDER — the reachability layer. One question — can I reach this, and with what? — in two steps.

PATH SONAR — step 1. Which member holds this key? Answered by the network. Ring 2.

PATH RESOLVER — step 2. What does this destination accept? Answered by the holding member, peer to peer. Ring 1.

Key — what a lookup takes: an identifier hash, or an opaque address.

Holder confirmation — the holding member co-signing a directory answer.

Reciprocity budget — a search allowance proportional to what a member contributes to the index, rather than a per-second cap.

Constant-shape answer — an unknown key and a key that is known but not visible produce identical responses, so the route cannot be used as an oracle.

Coverage — what a member declares it may hold: countries, prefixes, identifier types. Used to narrow a broadcast. Not an index.

Addressing

Opaque addresspath:4a91c2f7e8d3. Carries no member, network or country. Portable by design; requires SONAR to be reachable by a stranger.

Directory profile — addressing that relies on a network's index. Requires membership.

Relationship profile — addressing between parties who already know each other. Requires no network at all. The proof that ring 1 is genuinely open.

Standing intent — an address's permanent terms of receipt: what it accepts, within what limits. Versioned, never overwritten.

Receive target — what an address actually points at within the member: a wallet, a deposit account, an external destination.

Discoverabilityprivate, network or public, set per entry rather than per network.

Identifiers

Identifier — a phone number, an email address, a bank account, an LEI, a registry number, a tax number.

Normalisation — the canonical form of an identifier before hashing. Part of the protocol: two implementations that normalise differently split the directory in half without noticing.

Pepper — the network-held secret mixed into identifier hashing. Never distributed to members.

Oblivious hashing — a construction where the member obtains the hash without learning the pepper, and the network never sees the identifier. Roadmap; trigger is the second member of a network.

LEI — Legal Entity Identifier (ISO 17442). The global identifier for a legal entity, and the default for a company.

reg: / tax: — local registry and tax identifiers. The registry is always named, never inferred from the country — one country holds several registers.

Interop and settlement

PATH INTEROP — one URI across QR codes, deeplinks and in-app handoffs.

Kind — what a URI points at: pay, request, checkout, subscribe, connect, fconnect, mandate, claim, present, receipt.

Envelope / object — INTEROP carries the envelope; the pillar owns the object.

Receipt — a signed statement that value moved, in one format across every rail.

Commitment — a digest over a resolver answer, published separately so a payer can detect a resolver that changed its story.

Governance

Discovery document/.well-known/path-configuration. What an operator speaks, claims and how its directory behaves. Unauthenticated by design.

Conformance profile — a named, testable subset, e.g. PATH-REQ.Link. An implementation declares profiles, never "PATH compliance".

Rulebook — a network's rules: admission, obligations, liability, disputes. Published and versioned.

Retired terms

Kept here because they appear in earlier material.

RetiredUse instead
"Routing index", "index feed"PATH SONAR
"Lookup", unqualifiedName the step: SONAR or RESOLVER
"PATH REACH"PATH FINDER — the layer was renamed
"PATH FINDER" meaning step 1PATH SONAR — the name moved up a level
"Reverse lookup" for hash → memberPATH SONAR. The term remains correct for on-chain reverse resolution (address → name), which is a genuinely inverse operation and unrelated
"Zero knowledge" for identifier hashingNot accurate in the current configuration. See Privacy

On this page