Astronime
Back to home

Protocol documentation · v0.3 · living document

The Astronime protocol manual.

Astronime is a decentralized lending and borrowing protocol built exclusively for Robinhood Chain. Deposit tokenized stocks, RWA assets, and meme assets as collateral, borrow against your holdings, and unlock liquidity without selling, permissionless, non-custodial, and without intermediaries.

Chain
Robinhood Chain
Chain id
4663
Collateral classes
4
Market model
Isolated

Part I

Protocol

1.1

Overview

Astronime is a decentralized lending and borrowing protocol built exclusively for Robinhood Chain. Deposit tokenized stocks, RWA assets, and meme assets as collateral, borrow against your holdings, and unlock liquidity without selling, permissionless, non-custodial, and without intermediaries.

The protocol is a set of isolated lending markets. Each market pairs exactly one collateral asset with one borrowable asset and carries its own oracle, LTV ceiling, liquidation threshold and interest curve. Nothing is pooled across markets, so a failure in a meme asset market cannot socialise losses onto a tokenized equity market.

  • Non-custodial: every state change is signed by your own key, the protocol never takes custody.
  • Permissionless: no onboarding, no whitelist, no credit assessment, no intermediary.
  • Isolated by construction: risk is contained inside the market that created it.
  • Verifiable: collateral, debt, utilization, rates and oracle state are readable on-chain at any block.
LayerResponsibility
Market coreAccounting of collateral, debt shares, interest accrual, solvency checks.
Oracle layerSigned price feeds with staleness and deviation guards per collateral class.
Liquidation enginePermissionless partial repayment with a bounded collateral incentive.
InterfaceRead-only projections, guardrails, transaction assembly. Never an authority.

1.2

Collateral classes

Astronime supports four collateral classes today. Each class receives its own parameter profile because their volatility, liquidity depth and oracle characteristics differ substantially.

ClassExamplesMax LTV bandOracle profile
Tokenized stocksEquity representations on Robinhood Chain60 to 75 percentVenue price, session aware, deviation capped
RWA assetsTreasuries, credit, commodity backed55 to 70 percentAttested NAV with slow update tolerance
Meme assetsHigh volatility community tokens20 to 35 percentTWAP with wide deviation guard
$ASTProtocol token40 to 50 percentTWAP plus liquidity floor check

Parameter bands are governance ranges, not live values. The app always reads the exact active parameter from the market contract before quoting borrowing power.

  • Depositing collateral never sells it, you keep full price exposure while the position is open.
  • Collateral is withdrawable at any time as long as the resulting health factor stays above 1.0.
  • Each collateral class can be paused independently without affecting the others.

1.3

$AST

$AST is the protocol asset. It is usable as collateral in its own isolated market and is the coordination asset for market listing and risk parameter changes.

PropertyValue
Ticker$AST
ChainRobinhood Chain, chain id 4663
StandardERC-20, 18 decimals
RoleCollateral asset, risk parameter coordination, protocol fee routing

Verify the $AST contract address against official Astronime channels before approving any transaction. Lookalike tokens are the most common attack on new markets.

Part II

Using Astronime

2.1

Quickstart

  1. 1Open the app and press Connect Wallet, then approve the request in your wallet.
  2. 2Switch to Robinhood Chain when prompted, the app detects the wrong network and offers a one click switch.
  3. 3Fund the wallet with native gas, plus the collateral asset you intend to deposit.
  4. 4Wrap ETH into WETH from the app when you need WETH to supply liquidity or repay debt.
  5. 5Open Markets, inspect the market parameters, then deposit collateral and draw your first loan.
NetworkChain idEndpoint
Robinhood Chain mainnet4663rpc.mainnet.chain.robinhood.com
Robinhood Chain testnet46630faucet.testnet.chain.robinhood.com

2.2

Borrowing

Borrowing draws the loan asset from lender liquidity against your deposited collateral. Your ceiling is the lower of the market LTV limit and the liquidity currently unborrowed.

maxDebt = collateralValue x maxLTV

Borrowing power at the moment of the transaction, priced by the market oracle.
  1. 1Deposit collateral with an exact amount ERC-20 approval, the spender is shown before you sign.
  2. 2Enter the loan amount and review the projected LTV and health factor.
  3. 3Confirm, the loan asset arrives in your wallet in the same transaction.
  4. 4Repay partially or fully at any time, interest stops accruing on the repaid portion immediately.

Borrowing at the LTV ceiling leaves no buffer. A single adverse price tick can make the position liquidatable in the next block.

2.3

Lending and yield

Lenders supply the loan asset into a specific market and earn the interest paid by borrowers of that market only.

supplyAPR = borrowAPR x utilization x (1 - protocolFee)

Lender yield is a function of utilization, it is variable and never guaranteed.
  • Withdrawals are served from unborrowed liquidity, high utilization can delay a full exit.
  • Lenders in a market bear the bad debt risk of that market alone.
  • Supplying into several markets diversifies exposure without cross-collateralising it.

Part III

Risk engine

3.1

Risk parameters

ParameterControls
Max LTVHighest debt to collateral ratio allowed when opening or increasing a loan.
Liquidation thresholdRatio at which a position becomes liquidatable, always above max LTV.
Liquidation penaltyBounded bonus paid to liquidators, it shields lenders from bad debt.
Supply capMaximum collateral the market accepts, it bounds oracle and exit-liquidity risk.
UtilizationBorrowed over supplied, it drives both the borrow and the supply rate.
Reserve factorShare of interest routed to the protocol reserve.

healthFactor = (collateralValue x liquidationThreshold) / debt

Above 1.0 the position is solvent. At or below 1.0 anyone may liquidate it.
  • Target 1.5 or higher on tokenized equity and RWA collateral.
  • Target 2.0 or higher on meme asset collateral, where intraday drawdowns are routine.
  • Interest accrual alone lowers the health factor over time, even with a flat price.

3.2

Oracle design

Every market reads collateral value through a guarded oracle. If the guard trips, the market degrades safely instead of pricing on bad data.

GuardTriggerEffect
StalenessLast update older than the market heartbeatBorrowing and withdrawals blocked, repayment stays open
DeviationUpdate deviates beyond the class bandUpdate rejected, previous valid price retained
Liquidity floorVenue depth below the market floorNew borrowing disabled for that collateral

Repayment and collateral deposit are never blocked by an oracle guard. Risk-reducing actions always remain available.

3.3

Liquidation engine

Liquidation is permissionless and partial by default. A liquidator repays part of the debt and receives the corresponding collateral plus the liquidation penalty, pushing the position back above the threshold rather than closing it entirely.

  1. 1Health factor drops to 1.0 or below at the oracle price of the current block.
  2. 2Any address may call liquidate with a repayment amount within the market close factor.
  3. 3Debt and collateral are reduced atomically, the penalty is paid out of the seized collateral.
  4. 4If seized collateral cannot cover the debt, the shortfall is absorbed by that market reserve first.

There is no grace period and no notification. Add collateral, repay, or reduce exposure before the buffer disappears.

Part IV

Integration

4.1

Architecture

The interface never talks to contracts directly. Components call hooks, hooks call the active lending adapter, and the adapter is selected once from configuration.

component  ->  hook  ->  lending adapter  ->  market contract
                                   |
                                   +->  oracle guard
                                   +->  interest accrual
ModeBehaviour
DemoDeterministic sample data, simulated flows, no approvals, no transactions.
LiveReal reads and writes against the configured on-chain market.
UnconfiguredValues render unavailable and every write is disabled, never fabricated data.

4.2

Action reference

ActionApprovalSolvency check
supplyCollateralExact amount on the collateral tokenNot required
withdrawCollateralNonePost-state health factor above 1.0
borrowNonePost-state LTV at or below max LTV
repayExact amount on the loan tokenNot required
supplyLiquidityExact amount on the loan tokenNot required
withdrawLiquidityNoneBounded by unborrowed liquidity
const { data } = useAccountPosition()

// all amounts are WAD-scaled bigints end to end
const canBorrow = data.healthFactor > 10n ** 18n

4.3

Security practices

  • Astronime never asks for a seed phrase and never submits a transaction without an explicit wallet confirmation.
  • Approvals are exact amount and the spender is always the configured market contract.
  • Interface guardrails are UX only, the contracts are the sole enforcement layer.
  • All amounts are integers end to end, rounding happens only at the display boundary.
  • Success is reported only after the transaction receipt confirms success.

4.4

Troubleshooting

SymptomResolution
Wallet does not openOpen the app in a full browser tab, extensions are often blocked inside embedded previews.
Wrong network warningUse the switch network button, or add Robinhood Chain manually with chain id 4663.
Deposit revertsConfirm the approval landed and covers the deposit amount.
Balance shows zeroConfirm the network and that the token address matches the official one.
Actions disabledThe market is unconfigured or an oracle guard is active.

4.5

Glossary

TermDefinition
Isolated marketOne collateral asset, one loan asset, its own parameters and its own risk.
Close factorMaximum share of a debt position a single liquidation may repay.
Health factorNormalized solvency score, at or below 1.0 a position is liquidatable.
LTVLoan to value, debt divided by oracle-priced collateral value.
UtilizationBorrowed liquidity divided by supplied liquidity.
WETHWrapped ETH, the ERC-20 representation of native ETH.

Ready to unlock liquidity?

Open the app to inspect live market parameters, or read the whitepaper for the design rationale behind isolated markets and the oracle guard set.