FACTA

master.listing

Version
0.1.0
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

Changelog
VersionDateChange
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/assets), read every 6 hours by 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-sync hashes the live file every 6 hours; a different hash sets reviewNeeded. It never adds a token by itself. A fetch that fails changes nothing: the SHA-256 and the time of the last read stay, and reviewNeeded still 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() and decimals(), in one batch at one block.
  • Each issuer's naming pattern, packages/master/data/patterns.json: Robinhood names a token <stock> • Robinhood Token with the ticker as its symbol; Ondo names it <stock> (Ondo Tokenized) with the ticker and on as its symbol.

The rule

Decided in this order. The first rule that applies gives the term.

  1. Unknown when the address has no code, or does not answer symbol(), name() and decimals() as a token.
  2. Issuer-listed when the address is in an issuer's list as of the last successful read of that list.
  3. Not issuer-listed when the comparison key of its symbol() equals the key of a listed token's symbol (matchedOn: symbol), or its name() follows an issuer's naming pattern for a stock that issuer lists (matchedOn: name). But Unknown, 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.
  4. Not a stock token for 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.registry names 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, and master.multiplier compares 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.registry carries 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 as Not issuer-listed or Not 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:

  1. normalises the text to Unicode compatibility form (NFKC), so full-width letters, ligatures and mathematical letters become plain ones;
  2. 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;
  3. removes every character that is not a Latin letter, a digit or a dot: spaces, punctuation, zero-width characters and direction marks;
  4. upper-cases the rest.

So tsla, TS​LA 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:

  1. 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.
  2. 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.ondo keeps 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

Thresholds
ThresholdDefaultWhere
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

Terms
TermObserved
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

  • listing of an issuer-listed Robinhood token: the registry response, by URL, fetch time and SHA-256 of the body.
  • listing of an Ondo token: the reviewed file packages/master/data/ondo.json, with Ondo's addresses page as its source and its review date.
  • listing of any other address: the calls symbol(), name() and decimals() 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_mismatch notice 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 call symbol() 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

Ways to game it, and what the method does
WayWhat 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 token until 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. held counts 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.