Method
How a transfer gets its answer.
Three contracts on Robinhood Chain, written to be read: who is trusted, what a proof contains, which rule runs in which order, and what each answer means.
01
Trust, stated
A product is a namespace in EligraClaimRegistry with one admin (handed over in two steps). The admin names issuers and, for each, the claim types it may attest. An issuer attests a wallet; nobody else can. Eligra itself trusts no one and checks no identity.
Removing an issuer, or narrowing its claim types, invalidates its claims at once. Each time an issuer is re-added it starts a new epoch, so old claims never come back by accident.
02
A proof, field by field
issuer (address) · claimType (0–255) · issuedAt · expiresAt (at most 1,095 days ahead) · country (0–999, 0 = not disclosed) · revoked · evidenceHash.
Suggested claim types used by this app: 1 Identity verified · 2 Eligible investor · 3 Residence (carries a country code) · 4 Wallet approved by the issuer · 5 Sanctions screening passed. A product may give any number its own meaning.
Signed attestations: an issuer can sign an attestation off chain (EIP-712, with its next nonce and a deadline) and the holder submits it and pays the gas. The signature works once, only for those exact fields, and only while the issuer is still trusted.
03
Eight rules, in order
- 0Product not paused
- 1Sender on the allowlist
- 2Receiver on the allowlist
- 3Sender holds the required claims
- 4Receiver holds the required claims
- 5Country allowed
- 6Lock-up over
- 7Balance and holder caps
canTransfer returns the first rule that applies and fails; explain returns all eight. Mints skip the sender rules and the lock-up. Burns are never checked, so a holder can always leave. The holder cap counts the sender leaving when it sends its whole balance.
04
Eighteen reason codes
| Code | Name | Meaning |
|---|---|---|
| 0 | OK | Accepted. |
| 1 | PAUSED | The product admin paused every transfer of this product. |
| 2 | TOKEN_NOT_BOUND | This token is not bound to an Eligra product, so the engine has no rules for it. |
| 3 | NO_RULES | The product has no rules set yet. |
| 4 | SENDER_NOT_ALLOWLISTED | The sender is not on the product's allowlist. |
| 5 | RECEIVER_NOT_ALLOWLISTED | The receiver is not on the product's allowlist. |
| 6 | SENDER_CLAIM_MISSING | The sender lacks a required claim. |
| 7 | SENDER_CLAIM_EXPIRED | A required claim of the sender has expired. |
| 8 | SENDER_CLAIM_REVOKED | A required claim of the sender was revoked. |
| 9 | SENDER_CLAIM_ISSUER_REMOVED | A required claim of the sender came from an issuer the product no longer trusts. |
| 10 | RECEIVER_CLAIM_MISSING | The receiver lacks a required claim. |
| 11 | RECEIVER_CLAIM_EXPIRED | A required claim of the receiver has expired. |
| 12 | RECEIVER_CLAIM_REVOKED | A required claim of the receiver was revoked. |
| 13 | RECEIVER_CLAIM_ISSUER_REMOVED | A required claim of the receiver came from an issuer the product no longer trusts. |
| 14 | COUNTRY_NOT_ALLOWED | The country on the residence claim is not on the product's list (or the claim is not valid). |
| 15 | LOCKUP_ACTIVE | Transfers between holders are locked until the lock-up date. Mints are not affected. |
| 16 | MAX_BALANCE_EXCEEDED | The receiver's balance would go above the per-wallet cap. |
| 17 | HOLDER_CAP_REACHED | This would add a holder beyond the product's holder cap. |
| 18 | ZERO_RECEIVER | A transfer needs a receiver (burns are not checked). |
05
The sample token and its powers
EligraPermissionedToken is an ERC-20 that asks the engine before every transfer and mint. Its issuer can mint, only to wallets the rules accept. It has no forced transfer, no seizure, no blocklist of its own and no upgrade. The product admin can pause the product or tighten its rules, which can stop transfers; burning always works. It is a demonstration, not a claim on any real-world asset.
06
Cost, measured
On a fork of Robinhood Chain: deploy registry 1,412,703 gas, engine 2,031,259, sample token 687,370. An attestation 85,164, a mint with the rule check 114,274, a transfer with the check 49,145, a logged decision 26,984. Checks themselves are reads: no gas.
07
The reference on this chain
Robinhood's stock tokens run a permission system of their own: one shared registry with a block list, minter and burner roles and a pause. Eligra reads it live (54 tokens, each proven on chain on 2026-11-16 by its proxy code hash, beacon slot and a supply above zero; a ticker proves nothing). It is shown for comparison only. Eligra is not affiliated with Robinhood.
08
Planned, not built
- Adapters so existing permissioned-token standards (ERC-3643-style) can ask the same rule engine.
- Hosted verification partners: issuers that verify people off chain and publish attestations.
- Email or push alerts when a claim is about to expire.
- $ELIGRA for issuer quotas on those hosted services.
None of these exist today. They are listed so nobody mistakes them for features.
09
Questions
- What does Eligra do?
- It answers one question before a transfer of a permissioned asset on Robinhood Chain: may this wallet hold it, today, and if not, why not. Issuers publish proofs (claim type, issuer, expiry) and rules (claims required, allowlist, countries, lock-up, caps); anyone can check a wallet or test a transfer against them.
- Does passing a check mean I can invest?
- No. A product decides who may hold it. It may require identity verification, investor eligibility and wallet approval by the issuer, and it redeems according to its own terms, which are not instant by default. A passed check only says the product's on-chain rules would accept a transfer at that moment.
- Does Eligra verify identities or keep documents?
- No. Eligra performs no identity checks and stores no personal data. An issuer the product trusts does the verification off chain and publishes only an attestation: a claim type, its own key, an expiry date, an optional country code and a hash of the evidence it keeps.
- Who decides which issuers count?
- The product's admin, on chain, per claim type. Removing an issuer instantly invalidates every claim it issued for that product; re-adding it later does not bring them back. That trust is stated on every product page.
- What is live today?
- The reference panel reads Robinhood's own stock-token permission registry on Robinhood Chain live (block list, pauses, role changes). EligraClaimRegistry and EligraRuleEngine are live on Robinhood Chain with their source verified on Blockscout. No product has been created on them yet, so until an issuer creates one the eligibility check and dashboard have nothing to list, and rule tests run in Simulation mode with the claim statuses you pick.
- Do I need $ELIGRA?
- No. Checks, rule tests and the dashboard work without it. Using $ELIGRA for issuer quotas is planned and unproven. It is a memecoin with no promise of value.
- What are the risks?
- The contracts are new and have had no independent security review. They hold no funds, but a product admin can pause transfers, tighten rules or remove issuers, which can stop holders from moving tokens (burning stays possible). Read a product's admin and issuers before relying on it.