Skip to content
Metaplex

Documentation

How the workspace works.

What each part reads, how figures are computed, what happens before you sign, and what can go wrong.

About

Metaplex brings tokenized asset discovery, portfolio visibility, and supported DeFi routes into a single interface on Robinhood Chain. Its AI assistant explains available data, fees, and risks, while you stay in control of every transaction.

It is built around three things you can do and observe today: explore supported assets, understand your holdings, and review and sign supported actions. Features that are not available are shown as unavailable; nothing planned is described as existing.

Independence. Metaplex is an independent project. It is not affiliated with, endorsed by, or operated by Robinhood Markets, Inc. or its affiliates, and it has no connection to the Solana project of the same name, its token, contracts, or documentation. This project has no token. Any token using this name is unrelated to this application.

Getting started

  1. Open the workspace. Assets, markets and status are readable without a wallet.
  2. Connect a browser wallet. Connecting shares your address only; no signature is requested to connect or to view balances.
  3. If your wallet is on another network the workspace keeps reading and offers a switch to Robinhood Chain (chain 4663). The switch is confirmed in your wallet; it never happens silently.
  4. ETH pays network fees. Funds reach the network through the bridges described in the chain documentation (opens in a new tab); bridging is not part of this application.

The site never asks for a seed phrase or private key. If a page that looks like this one does, it is not this application.

Assets

The registry lists 18 assets: ETH, the canonical WETH and USDG contracts from the chain's token-contracts page (opens in a new tab), and a selection of Robinhood Stock Tokens. Each entry records its contract address, chain id, decimals, issuer where verified, category, sources and price-feed configuration.

Identity

An asset is identified by chain id and contract address. Many unrelated contracts reuse well-known names and tickers, so a matching symbol is never treated as the same asset. Pasting an address that is not in the registry opens an inspection page that reports what the contract says about itself and labels it unverified.

Stock Tokens

Per the issuer's documentation (opens in a new tab), Stock Tokens are tokenised debt securities issued by Robinhood Assets (Jersey) Limited. They provide economic exposure to underlying securities but do not grant legal or beneficial rights in, or against the issuer of, those securities. They are not shares.

They are not registered under U.S. securities laws and may not be offered or sold in the United States or to U.S. persons; restrictions apply in other jurisdictions too. See the issuer's restricted jurisdictions (opens in a new tab). This application performs no eligibility check.

Dividends and splits change an onchain multiplier rather than your balance, so one token can represent more or less than one share. Asset pages show the multiplier, whether transfers or the oracle are paused, and whether the contract sits behind the issuer's beacon.

Portfolio

The portfolio reads the connected account's native balance and the balance of every registry token with public network calls, in one multicall. It refreshes every 30 seconds, on demand, and after a transaction sent from the workspace confirms. Results are cached per account and network.

  • Coverage. Only the curated registry is scanned. Other tokens in the wallet are not read and are not part of any figure.
  • Known value. The sum of holdings that have a usable price. If any held asset has no price, the total is labelled partial and that asset is listed with its quantity only.
  • Not shown. Cost basis, profit and loss, historical balances and performance. No reliable historical source is integrated, so none is estimated.
  • Export. The CSV contains the same rows, with the block number and read time.

Methodology

Amounts

Token amounts are integers in base units from input to calldata. Decimal text is parsed exactly, with no floating point, and rejected if it has more decimals than the token. Displayed amounts are truncated, never rounded up.

Value

Value in USD is balance × price, computed in integers at eight decimals. Prices are Chainlink feed answers read with the feed's own decimals. For Stock Tokens the feed already prices one token, so no multiplier is applied again.

Freshness

A price is Live within 26 hours of its last round, Stale after that, Unavailable when the read or the answer is invalid, and Unsupported when no verified feed exists. Missing prices are never turned into zero.

Allocation and concentration

Allocation is each priced holding's share of known value. Concentration reports the largest holding, the top three, and the Herfindahl–Hirschman index (sum of squared shares, 0 to 10,000). The labels are fixed thresholds: 60% or more in one holding is called concentrated, 35% or more moderate.

Lending rates

Supply APY is the borrow APY implied by the rate model's current per-second rate, multiplied by utilization and by one minus the protocol fee. It is a snapshot of a variable rate, not a forecast.

Swap

Quotes come from two verified routes: the KyberSwap aggregator and a direct Uniswap v3 pool. If neither can route a pair and size, the page says so; nothing is routed through another network.

  1. The network and the amount are validated.
  2. A fresh quote is fetched, bound to your account, the network, the pair and the amount. It expires after 45 seconds.
  3. The provider's response is validated; the router must be the verified one.
  4. Your allowance is read. If it is short, you approve exactly the amount being swapped.
  5. The transaction is built, decoded and compared with the quote: destination, tokens, amount, minimum output, recipient. Fee lines or permits the application did not ask for block signing.
  6. The transaction is simulated from your account.
  7. You see the final review, then sign in your wallet.
  8. The receipt is awaited. Success is reported only from a successful receipt; a revert is reported as a revert.
  9. Affected balances refresh.

Minimum received is the quoted output less your slippage tolerance; the router enforces it or the transaction reverts. No platform fee is added.

Earn

Earn lists Morpho Blue markets in which a registry asset can be supplied. A market appears only when its parameters match the reviewed configuration, both of its assets are in the registry, its rate model is the one in Morpho's address list (opens in a new tab), and its oracle is confirmed by the official oracle factory and reads the registry's Chainlink feeds. The checks are repeated on every load.

  • Where the yield comes from. Interest paid by borrowers in that market. With no borrowers the rate is zero.
  • Withdrawals. Limited to the market's idle liquidity. At high utilization part of a deposit can be unavailable until borrowers repay or others deposit.
  • What is signed. An exact approval if needed, then a supply or withdraw call to the Morpho Blue contract, decoded, checked and simulated first.

Borrowing is not offered. No yield contract was written or deployed for this page.

Assistant

The assistant is a language model with read-only tools. It answers from data the application reads for it and shows, under each answer, which tools ran and when.

  • get_workspace_status: Which integrations are active, unavailable or not configured in this deployment, the network, the freshness policy, the fee policy and the audit status. Use for questions about what the workspace can do.
  • list_assets: The curated asset registry with each asset's id, symbol, category and current reference price state (Live, Stale, Unavailable or Unsupported) and age. Use it to find asset ids and to answer how fresh prices are.
  • get_asset: Details for one registry asset: description, issuer, contract, price source and current price state, available integrations, and (for Stock Tokens) the issuer's documented restrictions. Input: an asset id from list_assets or a contract address.
  • get_portfolio: The shared wallet's holdings in the curated registry: quantities, known value, allocation, concentration and price freshness, already computed. Only available when the user switched on wallet-context sharing; otherwise it reports that no wallet context was shared.
  • get_swap_quote: Fetch fresh indicative swap quotes from the verified adapters for a pair and amount, with expected output, minimum received at 0.5% slippage, route, fees and expiry. Indicative only: nothing is prepared or sent. Inputs are registry asset ids or contract addresses and a decimal amount of the asset being sold.
  • list_earn_markets: The verified lending markets with deposit asset, collateral, variable supply APY and its source, utilization, available liquidity, withdrawal constraint and risks, as read from the chain now.
  • explain_topic: Documented mechanics, quoted from the application's sourced notes. Topics: stock-tokens (What Robinhood Stock Tokens are); multiplier-and-prices (Stock Token multiplier and price feeds); price-freshness (How this application labels price freshness); portfolio-coverage (What the portfolio view covers); swap-review (How a swap is quoted and reviewed); earn-markets (How the Earn markets work); approvals-and-signing (Approvals, simulation and signing).

Arithmetic is done by application code; the model is given finished figures. Text inside tool results is treated as data, not instructions. There is no tool that prepares, signs or sends a transaction.

Wallet context. Your address and holdings are sent to the model provider only while “Share wallet context” is switched on, and only for the questions you ask during that time.

Configuration. The operator sets AI_PROVIDER, AI_API_KEY and AI_MODEL on the server. Without them the assistant shows a not-configured state and the workspace offers a deterministic summary written by code, clearly labelled as such.

Activity

Activity records transactions you start in this application: chain id, account, hash, action, submission time and receipt status. Records live in this browser's storage, scoped by account and network, and are reconciled with real receipts while the workspace is open.

It is application activity, not a wallet history. No indexer is integrated, so anything done elsewhere does not appear. Use the block explorer for a complete record.

Risk information

  • No advice. Nothing in this application is investment, legal or tax advice.
  • Irreversibility. Confirmed transactions cannot be undone. Read the review before signing.
  • Smart contracts. The application calls third-party contracts (KyberSwap, Uniswap, Morpho Blue). They can contain bugs or behave unexpectedly. The application itself has not been audited.
  • Prices. Reference prices come from oracles, can be stale or wrong, and are not what a trade will execute at.
  • Swaps. Prices move between quote and inclusion. A swap can revert, costing the network fee, or fill at the minimum you accepted.
  • Lending. Rates are variable and can be zero. Withdrawals depend on liquidity. Lenders share losses from bad debt. Stock Token collateral is priced by feeds that pause outside market hours.
  • Stock Tokens. The issuer states they carry a high level of risk and may result in the loss of some or all of an investment. The issuer can pause or restrict transfers. Read the issuer's documents (opens in a new tab).
  • Assistant. A language model can be wrong or misread a question. Check its figures against the data it lists.
  • Availability. Public endpoints are rate limited and can fail. When a source fails, the affected figure is shown as unavailable.

More detail on sources, contracts and limits is on the Transparency page.