master.listing
- Version
- 0.1.0
- Desk
- Terms named on this page
Whether an address is a token an issuer lists for a stock, a token that only looks like one, or neither. It answers for any address, and it never says more than was observed.
Changelog
| Version | Date | Change |
|---|---|---|
0.1.0 | 2026-11-11 | First version. |
What it measures
The listing term of one address, from two issuers' lists of tokens on Robinhood Chain (chain 4663): Robinhood's Stock Token registry and Ondo's token file. It does not measure whether a token is worth anything, whether it can be traded, or who controls it.
Inputs
- Robinhood's Stock Token registry (
GET /rhj/), read every 6 hours byassets master.registry-sync. Each asset gives its ID, symbol, name, decimals, ISIN, status, multiplier and its deployment on chain 4663. - Ondo's token file, a CSV linked from Ondo's addresses page (
https://docs.ondo.finance/addresses). Master stores exactly the 15 Robinhood Chain rows of a reviewed copy,packages/master/data/ondo.json.master.ondo-synchashes the live file every 6 hours; a different hash setsreviewNeeded. It never adds a token by itself. A fetch that fails changes nothing: the SHA-256 and the time of the last read stay, andreviewNeededstill compares that read with the reviewed copy. - The address's own answers, read live on every check of an address no issuer lists:
symbol(),name()anddecimals(), in one batch at one block. - Each issuer's naming pattern,
packages/master/data/patterns.json: Robinhood names a token<stock> • Robinhood Tokenwith the ticker as its symbol; Ondo names it<stock> (Ondo Tokenized)with the ticker andonas its symbol.
The rule
Decided in this order. The first rule that applies gives the term.
Unknownwhen the address has no code, or does not answersymbol(),name()anddecimals()as a token.Issuer-listedwhen the address is in an issuer's list as of the last successful read of that list.Not issuer-listedwhen the comparison key of itssymbol()equals the key of a listed token's symbol (matchedOn: symbol), or itsname()follows an issuer's naming pattern for a stock that issuer lists (matchedOn: name). ButUnknown, with a stale entry, when the list of the issuer it matches is older than its limit, or is Ondo's while its live file awaits review: an old copy of a list cannot show that an address is missing from it.Not a stock tokenfor every other token.
A match on the name is reported before a match on the symbol. The answer names the listed token it matched (listedMatch).
When a list has never been read, no address that is missing from it can be placed: every address no issuer lists is then Unknown, with a stale entry.
An entry that cannot be read
The registry lists an asset on this chain by its deployment's address. An entry with such an address is read only when it also states a valid ID, a symbol that makes an instrument key, a name, and tokenDecimals as a whole number from 0 to 36. Nothing is assumed in place of a missing value, the decimals included. An entry that cannot be read is a failed read, which is never a value and never a change:
- nothing is written from it, and the job's state
master.registrynames its address (unread) and counts it; - a token stored from an earlier response is neither rewritten nor removed. It stays
Issuer-listed, with a stale entry that says its values are from an earlier sync, andmaster.multipliercompares nothing for it until its entry can be read again; - the stale entry's time is the last read of the registry whose response could read the token's entry: the last fetch of that response the job's state recorded, which
master.registrycarries for each entry that cannot be read (entryLastGood) for as long as it cannot. It is never the time the token's row last changed, since a sync that reads the same values writes nothing to the row. A page prints the time as the registry's last read, before the note, so the note names the later sync: "A later sync could not read its entry for the Robinhood token, so the token's values shown are from the read at that time." When that time is not kept, no time is printed, and the note is "The registry lists the Robinhood token, but its entry could not be read at the last sync, so the token's values shown are from an earlier sync." It is not kept when the state that processed the response did not record it, and when a version no run finished writing may have written the token's row (mixed): that row may then hold that version's values; - an address that was never stored is
Unknown, with a stale entry dated at the last sync: "The registry lists this address, but its entry could not be read at the last sync, so nothing is stored for it." It is on the issuer's list, so it is never answered asNot issuer-listedorNot a stock token.
An asset with no deployment on this chain is not listed here at all: it is skipped and counted.
The comparison key
Two symbols, or two names, are compared through one function, symbolKey, and nothing else. It:
- normalises the text to Unicode compatibility form (NFKC), so full-width letters, ligatures and mathematical letters become plain ones;
- folds letters of other scripts that are drawn like a Latin capital to that capital:
- Cyrillic capitals А В Е К М Н О Р С Т Х У І Ј Ѕ, to A B E K M H O P C T X Y I J S;
- Cyrillic small letters а е о р с х у і ј ѕ, to A E O P C X Y I J S;
- Greek capitals Α Β Ε Ζ Η Ι Κ Μ Ν Ο Ρ Τ Υ Χ, to A B E Z H I K M N O P T Y X, and the small omicron ο to O;
- removes every character that is not a Latin letter, a digit or a dot: spaces, punctuation, zero-width characters and direction marks;
- upper-cases the rest.
So tsla, TSLA with a zero-width space, ТSLA with a Cyrillic Т and full-width TSLA all have the key TSLA.
Other look-alike letters exist and are not folded, for example Cyrillic small т, к, м, н and в, Greek small letters other than omicron, Armenian, Cherokee and Latin letters with marks such as Š. A letter that is neither folded nor plain Latin is removed, so TŠLA has the key TLA and is not matched to TSLA. Such a token is Not a stock token unless its name follows a pattern; its own symbol is shown as written, under "Declared by the subject, not checked".
The symbol of an Ondo token
Every 6 hours master.ondo-sync reads symbol() of each Ondo token and compares its key with the key of the token's symbol in the reviewed file. A disagreement is a statement about a named issuer: its notice, registry_chain_mismatch with the field symbol, quotes the reviewed file as what Ondo's list states. So it is published only when both of these hold in the same run:
- A second read of
symbol()at the same block, from an endpoint run by another operator, gives the same answer. When that read fails or answers otherwise, nothing is written, and the next run reads the token again. - The run's own fetch of Ondo's live file shows that the reviewed file is still Ondo's current file: an answer 200 whose body has the reviewed SHA-256, or an answer 304 to the ETag of a body the job hashed to the reviewed SHA-256, which in practice is the ETag recorded in the reviewed file. A weak ETag is never sent, because a 304 to it does not show that the bytes are the same.
A symbol() the run's first read did not read at all is not compared in that run. The fifteen tokens' calls travel as one call, and an endpoint can refuse to read one item of it again: that says nothing about the symbol, so it is neither a disagreement nor a word such as reverted. The rest of the call is used as read, the job's state master.ondo counts the tokens not read (chainNotRead), and the next run reads them again.
A disagreement the second read confirms is otherwise held: no notice, counted as held in the job's state master.ondo, and the next run reads the symbol, the second endpoint and the live file again. It is held when:
- the live file differs from the reviewed copy, also when a 304 shows that the differing file has not changed since. Ondo may have corrected the symbol in the newer file, so the reviewed copy is no longer known to be what Ondo states, and a review comes first;
- the fetch failed: no answer, a timeout, a body over its cap, or a status other than 200 and 304. A failed fetch is never a value and never a change.
master.ondokeeps the SHA-256, ETag and time of the last read, and the rest of the run goes on, because no other value of the run comes from the file; - the symbol the chain returned is itself one of the fixed words below, or
no answer, the word notices written before them hold, in any letter case and with any spacing. A notice prints those words as FACTA's own observation, so it would say that a call reverted when the call answered the text "reverted".
The chain's side of the notice is stored cleaned. Ondo can upgrade its token, so what symbol() returns is a stranger's text like any other token's. Before it is stored it is cleaned of invisible and control characters and cut to 32 characters, as every symbol is, so that a symbol cannot carry a sentence or a hidden character into a notice. When the call gave no symbol, the chain's side is one of three fixed words, and no other: reverted for a call that reverted or halted; no data for a call that succeeded and returned nothing; unreadable answer for bytes that are not text, text longer than 128 bytes, text with a control character, or text with nothing left once it is cleaned.
Thresholds
| Threshold | Default | Where |
|---|---|---|
A list is stale after | 43,200 seconds (12 hours: two missed reads) | FRESHNESS.registrySeconds |
A symbol longer than this is refused before it is decoded | 128 bytes | LISTING_RULES.symbolMaxBytes |
A name longer than this is refused before it is decoded | 512 bytes | LISTING_RULES.nameMaxBytes |
The live read of an address no issuer lists is refused above | 65,536 bytes | LISTING_RULES.readMaxBytes |
A symbol and a name are cut to, once cleaned | 32 and 128 characters | TEXT_LIMITS |
Terms
| Term | Observed |
|---|---|
Issuer-listed | The address is in an issuer's list as of its last successful read. |
Not issuer-listed | The address is in no issuer's list, and its symbol has the key of a listed token's symbol, or its name follows an issuer's pattern for a listed stock. |
Not a stock token | The address answers as a token and matches no listed token. |
Unknown | The address has no code or does not answer as a token, or the list it would be compared with is stale, awaits review or was never read. |
Two sentences go with Not issuer-listed, by what was observed. For a match on the name: "Not issuer-listed: this address is not in the registry of the issuer it names." For a match on the symbol alone: "Not issuer-listed: this address has a symbol that reads as X, the symbol of an issuer-listed token, and it is not in that issuer's registry." Both are followed by the listed address. A symbol that reads as a listed ticker names no issuer, and its key may equal the ticker's only once look-alike letters are folded, so the second sentence says that it reads as the ticker, not that it is the same.
Evidence
listingof an issuer-listed Robinhood token: the registry response, by URL, fetch time and SHA-256 of the body.listingof an Ondo token: the reviewed filepackages/master/data/ondo.json, with Ondo's addresses page as its source and its review date.listingof any other address: the callssymbol(),name()anddecimals()at the block they were read at, and the two lists it was compared with (the registry response by SHA-256, the reviewed Ondo file).- A
registry_chain_mismatchnotice on an Ondo token's symbol: the reviewed file, with its source and review date; the fetch of Ondo's live file that showed it current, by URL, fetch time and SHA-256 (for a 304, the SHA-256 of the body the confirmed ETag came with); and the callsymbol()at its block.
Recomputation
pnpm tool packages/master/recompute.ts --envelope answer.json --rpc <endpoint> re-reads the three calls of every listing figure and checks that the address still answers the same symbol, name and decimals. An address that does not answer all three as a token, a wallet address for example, is Unknown by rule 1 again, and the script compares that term with the one published. Comparing the lists again needs the registry response, which the figure names by its SHA-256. No free endpoint serves past state, so without an archive endpoint the script re-reads at the head block and says so on its first line.
Ways to game it, and what the method does
| Way | What the method does |
|---|---|
A ticker with an invisible character, other case, or a letter of another script | symbolKey normalises, removes and folds them before comparing. |
A look-alike letter symbolKey does not fold | The letter is removed, the token is not matched on its symbol, and its name is still compared with the patterns. This page lists what is folded. |
A name that copies an issuer's pattern | Matched on the name, with the sentence that says the address is not in the registry of the issuer it names. |
A token that changes its name or symbol after being checked | Nothing about an address no issuer lists is stored: every check reads it again. |
A very long name meant to stall a check | Refused above its byte limit before it is decoded. |
A real token checked while a list is out of date | Unknown, with the age of the list, never Not issuer-listed. |
A token added to Ondo's live file only | Not listed until the reviewed file lists it; meanwhile a match against Ondo answers Unknown. |
A throttled or lying endpoint answers another symbol for an Ondo token | No notice without the same answer from a second operator's endpoint at the same block. |
An endpoint that refuses to read one Ondo token's symbol() | The symbol is not compared in that run, and is never quoted as a word such as reverted: nothing is said of a read that was not made. The job's state counts the token, and the next run reads it again. |
A symbol Ondo corrected after the review, which would make the reviewed copy disagree with the chain | No notice while the live file differs from the reviewed copy or could not be read: a notice never quotes a copy that Ondo may have replaced. |
A token whose symbol() returns a sentence, a hidden character or one of a notice's fixed words, to make a notice say something else | The chain's symbol is cleaned and cut to the length of a symbol before it is stored, and one that is a fixed word is held. |
Limits
- Two issuers only: Robinhood and Ondo. A third issuer's tokens are
Not a stock tokenuntil the method adds its list. - A name that names an issuer for a stock that issuer does not list does not match: such a token is
Not a stock token. - Any change anywhere in Ondo's file, for any chain, sets
reviewNeeded: the file is hashed whole, because parsing 662 KB does not fit a step. - Until the reviewed file is brought up to date with such a change, no symbol disagreement of an Ondo token is published, however long the review takes.
heldcounts them. - Look-alikes are found lazily, when someone checks an address. The chain is never scanned for tokens.
What overlaps elsewhere
Explorers and token lists label well-known tokens. This method applies one published comparison to any address on request, with the reads behind it.