START HERE · NO PRIOR KNOWLEDGE ASSUMED

What all of this actually means

If you have never used the XRP Ledger, none of the words on the front page mean anything yet. This page fixes that. No jargon that is not explained, and nothing here requires you to own any crypto.

1 · What the XRP Ledger is

The XRP Ledger is a shared public record of who holds what. Around every four seconds it agrees on a new version of that record — a ledger — and once agreed, it never changes. Anyone can read it. Nobody needs permission.

PUT ANOTHER WAY

Think of a bank statement that the whole world can read, that updates every four seconds, and that no single bank controls. That is roughly it.

The live numbers on our front page are read straight from that record, over a public connection, at the moment you load the page. Nothing is cached or invented.

2 · Who really owns a token

XRP itself is the ledger's own currency and belongs to whoever holds it. But most things on the ledger are not XRP — they are issued currencies: a dollar, a euro, or a token that some company has put onto the ledger.

An issued token is closer to an IOU than to cash. A company called the issuer promises it is worth something, and the ledger records who holds how much of that promise.

WHY THIS MATTERS

Cash in your pocket is yours. A gift card is a promise from a shop — and the shop has more say over it than you do. Most tokens are gift cards, not cash.

3 · Freeze rights — the part almost nobody checks

The issuer of a token can usually freeze it. That is a real, built-in power of the ledger, not a loophole. When an issuer freezes, the holder can no longer send or redeem what they hold. The balance still shows in the wallet. It just cannot move.

There is a stronger version, called deep freeze, which also stops the holder receiving. The difference matters: an ordinary freeze aimed at a sanctioned address still lets that address keep accepting money.

Some issuers permanently give up this power. That is published on the ledger too, as a flag called lsfNoFreeze, and once set it can never be undone. An issuer that has set it can never freeze you.

WHAT NOSHASHI READS

For every token you hold, we read the issuer's flags and tell you plainly: can this issuer freeze you, have they already, have they given up the right, and do they charge a fee every time the token moves. Most wallets show you a balance and nothing else.

4 · Why "it's worth $X" can be false

The ledger has a built-in marketplace. People post offers — "I will buy 500 of this at this price" — and the collection of those offers is the order book.

A price is only real if somebody will actually trade at it. If the best offer is for five dollars' worth, then the "price" describes five dollars, not your whole holding. Selling more means walking down to worse and worse offers.

A CONCRETE EXAMPLE, MEASURED ON THE REAL LEDGER

One book appeared to hold 12.7 million dollars of buyers. Once we excluded offers priced so far from the market that nobody would ever fill them, the genuinely reachable amount was 13,894 dollars — about 913 times less.

That gap is not fraud. It is just what a raw order book looks like when nobody filters it. But if you valued a position on the first number, you would be badly wrong.

5 · What an amendment is

The XRP Ledger changes slowly and in public. A proposed change is written up as a numbered document — you will see these as XLS-70, XLS-80 and so on — and then it has to be voted in by the servers that run the network.

A feature therefore exists in three different states, and they are easy to confuse:

State
SpecifiedSomebody has written the document. Nothing works yet.
ImplementedThe server software understands it. Still nothing works on the live network.
ActivatedEnough of the network voted it in. Now it works.

Software that checks only the second state will happily offer you a feature that every server on the network will reject. NOSHASHI checks the third — it asks the live ledger which amendments are actually switched on, and hides anything that is not.

ACTIVATED TODAY, AND USED BY NOSHASHI

XLS-70Credentials — a verifiable statement about an account, issued by somebody else.
XLS-80Permissioned domains — a walled garden where only accounts holding the right credentials may trade.
XLS-81Permissioned order books — a members-only marketplace.
XLS-77Deep freeze — blocks sending and receiving.
XLS-85Token escrow — hold any token in escrow, not just XRP.

Some things people expect — on-ledger lending and confidential transfers — are written and built but not yet voted in. We do not offer them, and we say so.

6 · What NOSHASHI actually does

Before you move anything, NOSHASHI answers two questions at once, from the same four-second-old copy of the ledger:

  • Am I allowed to move this? Checked against the rules of wherever it is going.
  • Could I actually get out of it? Checked against the real order book and pool.

It answers with one of three words, and always tells you which rule decided it:

GOEvery rule you configured passed.
HOLDSomething advisory failed. A person should look before continuing.
NO-GOA blocking rule failed. The settlement is refused.

Nothing is signed and nothing is sent. It is a check you run before a transaction exists, which is exactly why it can be run at all — it costs no fee and risks nothing.

Every answer comes with a receipt: a fingerprint of the check, computed the same way every time. Two people running the same check get the same fingerprint, which is what makes it worth handing to an auditor.

7 · If you are not an institution

Most of the above is aimed at desks and companies. There is one part built for everybody, and it is free: check an address before you pay it.

Paste any XRP Ledger address — a shop, a token, a person you are trading with — and read what the ledger already publishes about it. Can they freeze what they issue? What do they charge? How long have they been active? Who have they actually dealt with?

WHAT IT DELIBERATELY WILL NOT DO

It will not tell you somebody is trustworthy, and it does not keep a secret list of bad actors — because we do not have one. Inventing a score people would act on is the single most harmful thing a tool like this could do. It reports published facts and stops there.

8 · Word list

LedgerOne agreed version of the record. A new one about every four seconds.
ValidatedAgreed and permanent. Never changes.
IssuerWhoever put a token on the ledger and stands behind it.
Trust lineYour permission to hold a particular issuer's token.
FreezeAn issuer stopping a holder from moving their balance.
Deep freezeStronger — also stops them receiving.
ClawbackAn issuer taking an issued balance back.
Order bookAll the standing buy and sell offers for a pair.
DepthHow much could actually trade near the current price.
SlippageHow much worse your price gets because your own order moved the market.
AMMA pool you trade against instead of another person.
AmendmentA change to the network's rules, voted in by its servers.
CredentialA statement about an account, issued and signed by somebody else.
ReserveA small amount of XRP the ledger requires you to keep, so accounts are not free to spam.