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.
| Layer | Responsibility |
|---|---|
| Market core | Accounting of collateral, debt shares, interest accrual, solvency checks. |
| Oracle layer | Signed price feeds with staleness and deviation guards per collateral class. |
| Liquidation engine | Permissionless partial repayment with a bounded collateral incentive. |
| Interface | Read-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.
| Class | Examples | Max LTV band | Oracle profile |
|---|---|---|---|
| Tokenized stocks | Equity representations on Robinhood Chain | 60 to 75 percent | Venue price, session aware, deviation capped |
| RWA assets | Treasuries, credit, commodity backed | 55 to 70 percent | Attested NAV with slow update tolerance |
| Meme assets | High volatility community tokens | 20 to 35 percent | TWAP with wide deviation guard |
| $AST | Protocol token | 40 to 50 percent | TWAP 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.
| Property | Value |
|---|---|
| Ticker | $AST |
| Chain | Robinhood Chain, chain id 4663 |
| Standard | ERC-20, 18 decimals |
| Role | Collateral 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
- 1Open the app and press Connect Wallet, then approve the request in your wallet.
- 2Switch to Robinhood Chain when prompted, the app detects the wrong network and offers a one click switch.
- 3Fund the wallet with native gas, plus the collateral asset you intend to deposit.
- 4Wrap ETH into WETH from the app when you need WETH to supply liquidity or repay debt.
- 5Open Markets, inspect the market parameters, then deposit collateral and draw your first loan.
| Network | Chain id | Endpoint |
|---|---|---|
| Robinhood Chain mainnet | 4663 | rpc.mainnet.chain.robinhood.com |
| Robinhood Chain testnet | 46630 | faucet.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
- 1Deposit collateral with an exact amount ERC-20 approval, the spender is shown before you sign.
- 2Enter the loan amount and review the projected LTV and health factor.
- 3Confirm, the loan asset arrives in your wallet in the same transaction.
- 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)
- 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
| Parameter | Controls |
|---|---|
| Max LTV | Highest debt to collateral ratio allowed when opening or increasing a loan. |
| Liquidation threshold | Ratio at which a position becomes liquidatable, always above max LTV. |
| Liquidation penalty | Bounded bonus paid to liquidators, it shields lenders from bad debt. |
| Supply cap | Maximum collateral the market accepts, it bounds oracle and exit-liquidity risk. |
| Utilization | Borrowed over supplied, it drives both the borrow and the supply rate. |
| Reserve factor | Share of interest routed to the protocol reserve. |
healthFactor = (collateralValue x liquidationThreshold) / debt
- 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.
| Guard | Trigger | Effect |
|---|---|---|
| Staleness | Last update older than the market heartbeat | Borrowing and withdrawals blocked, repayment stays open |
| Deviation | Update deviates beyond the class band | Update rejected, previous valid price retained |
| Liquidity floor | Venue depth below the market floor | New 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.
- 1Health factor drops to 1.0 or below at the oracle price of the current block.
- 2Any address may call liquidate with a repayment amount within the market close factor.
- 3Debt and collateral are reduced atomically, the penalty is paid out of the seized collateral.
- 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| Mode | Behaviour |
|---|---|
| Demo | Deterministic sample data, simulated flows, no approvals, no transactions. |
| Live | Real reads and writes against the configured on-chain market. |
| Unconfigured | Values render unavailable and every write is disabled, never fabricated data. |
4.2
Action reference
| Action | Approval | Solvency check |
|---|---|---|
| supplyCollateral | Exact amount on the collateral token | Not required |
| withdrawCollateral | None | Post-state health factor above 1.0 |
| borrow | None | Post-state LTV at or below max LTV |
| repay | Exact amount on the loan token | Not required |
| supplyLiquidity | Exact amount on the loan token | Not required |
| withdrawLiquidity | None | Bounded by unborrowed liquidity |
const { data } = useAccountPosition()
// all amounts are WAD-scaled bigints end to end
const canBorrow = data.healthFactor > 10n ** 18n4.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
| Symptom | Resolution |
|---|---|
| Wallet does not open | Open the app in a full browser tab, extensions are often blocked inside embedded previews. |
| Wrong network warning | Use the switch network button, or add Robinhood Chain manually with chain id 4663. |
| Deposit reverts | Confirm the approval landed and covers the deposit amount. |
| Balance shows zero | Confirm the network and that the token address matches the official one. |
| Actions disabled | The market is unconfigured or an oracle guard is active. |
4.5
Glossary
| Term | Definition |
|---|---|
| Isolated market | One collateral asset, one loan asset, its own parameters and its own risk. |
| Close factor | Maximum share of a debt position a single liquidation may repay. |
| Health factor | Normalized solvency score, at or below 1.0 a position is liquidatable. |
| LTV | Loan to value, debt divided by oracle-priced collateral value. |
| Utilization | Borrowed liquidity divided by supplied liquidity. |
| WETH | Wrapped 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.