Module 19: FAQ

Conversational Q&A covering the most common questions about BASIS. If you landed here looking for something, find your category below, get a quick answer, and follow the "→ See Module X" pointer for the full picture.

Prerequisites

None: this is a lookup module, read any section in any order
Pair with Module 18: SDK Reference for method signatures

Getting Started

What is BASIS? BASIS is a DeFi platform where you can trade elastic-supply tokens, take loans with no price liquidation, stake for yield, create prediction markets, and launch your own tokens. It is designed for both humans and AI agents. → See Module 01 for the full platform overview.

Is my money at risk? Yes. BASIS runs on Robinhood Chain with real money, and the default main's pair asset is USDG. Prices can fall, loans expire on time, a bet can lose everything, and smart contracts can have bugs. Only put in what you can afford to lose. → See Module 16.

What is the roadmap? In order, with dates as targets: testing, the angel, seed and private rounds, audits and legal, the community campaign (airdrop phase 2), the presale rounds, the launch on Robinhood Chain (real money in USDG, the 0.60% base fee, podium markets live), the trading campaign (airdrop phase 3), then TGE (BASIS minted and delivered, launch liquidity live, buyback and burn start). After launch come exact-order markets, parlays and survivor pools. → See Module 16.

Do I need ETH for gas? Yes. Every transaction pays gas in ETH. Your own wallet pays it, so keep a small balance.

Can anyone participate? Human or agent. The protocol is permissionless and there is no KYC to use the contracts. Connect a wallet and you are in.

What blockchain does BASIS run on? Robinhood Chain (chain id 4663). The network of a deployment is published at /contracts.json (chain, chainId): read it rather than hardcoding a chain id.

Have the smart contracts been audited? Reviewed by two leading AI models, run independently (the latest Claude Opus and GPT), plus 1,450+ tests. A Hashlock audit is engaged, and its report will be published when complete. Bug bounty open: report a bug with POST /api/v1/bugs/reports. → See Module 16.

Trading

How do I buy a token? Call client.trading.buy(tokenAddress, amountIn) with the amount of the token's pair asset you want to spend (USDG on the default main). The curve mints the tokens you buy, so there is no order book and no waiting for a seller (a Yolo token, reversed at multiplier 100, has a fixed supply: nothing is minted or burned). → See Module 04 for the full trading workflow.

How do I sell a token? Call client.trading.sell(tokenAddress, tokenAmount) with the token amount. The curve burns the tokens you sell (except on a Yolo token, reversed at multiplier 100). → See Module 04.

What are the six token families? All six are set by the hybridMultiplier (any value from 1 to 100) and the reversed flag. Stable+ (multiplier 100, not reversed): the price can only go up, measured in the token's main and in that main's pair asset; in USD that holds only when the pair asset is a USD stable. Utility+ (50 to 99, not reversed) and Floor+ (1 to 49, not reversed): the price moves both ways above a floor that is never below the launch price; Utility+ puts more of the price growth into its floor. Meme+ (1 to 50), Yolo+ (51 to 99) and Yolo (100) are reversed() tokens: the price can fall, and the floor is never below the launch price; Yolo is a plain memecoin with a fixed supply. → See Module 11 for the full mechanics.

How does leverage work on BASIS? Leverage is a trading action. SWAP opens and closes leverage positions, and each position is recorded on its main (leverages(wallet, id) on the main); the loan hub is a separate system for hub loans and cannot reach a leverage position. Call client.trading.leverageBuy() to open a position in one transaction. A main is valued at its price and a factory token at its floor (for a Stable+ token the floor is its price). There is no price-based liquidation: price cannot liquidate you; expiry, fees, a fall above the floor and contract risk remain. Leverage reaches up to about 37x; the position must be more than 2x (Under 2x), so read the real figure from client.leverageSimulator.simulateLeverageLocked() (a main) or simulateLeverageFactoryLocked() (a factory token). Positions are per main: client.trading.getLeverageCount(wallet, main), then loop from 1 to count with getLeveragePosition(wallet, index, main) (index 0 is always empty). To sell down or close: client.trading.partialLoanSellFor(main, positionId, percentage, true, minOut) (10 to 100 in steps of 10; 100 closes it, and the exit pays 3% of the proceeds above the initial buy). You can also extend (extendLeverage) and repay (repayLeverage) a position on its main. After liquidationTime a keeper liquidates the position. Assume it can happen in the first block after the deadline. Until that transaction lands a repay or a paid extension still goes through; do not plan on the gap. After a liquidation, 10% of what is left after the debt is the liquidation fee and you claim the rest with claimLeverageLiquidation. Claim within 365 days of the liquidation; after that the leftover may no longer be claimable. Hub-loan ids and leverage ids are separate counters: the client.loans methods take hub ids and do not reach a leverage position. → See Module 04 §3c–3d for leverage. For hub loans, → See Module 05.

What slippage protection is there? Pass minOut when buying or selling. If the trade would give you less than that amount, the transaction reverts. Always quote first with client.trading.quoteCross(path, amount, wallet), which includes your tax, and set minOut from it. → See Module 04.

Can I see what a trade will cost before I execute? Yes. client.trading.quoteCross(path, amount, wallet) returns what the trade pays after your tax, without sending a transaction (SWAP.quoteCross by eth_call). getAmountsOut(amount, path) is the quote before tax: on a token with the highest creator and rewards fees it is up to 11.6% above what a trade pays on each side. For a token in an auto-vest presale quoteCross reverts (autovest presale): apply client.taxes.getTaxRate(token, wallet) to getAmountsOut yourself. For leverage, use client.leverageSimulator.simulateLeverageLocked(). → See Module 04.

Lending & Staking

How do loans work? Pledge a BASIS token as collateral and borrow the pair asset of its main against it (USDG on the default main). Loans are made by the BASIS protocol, not by other users or outside liquidity providers. A main is valued at its price and a factory token at its floor; for Stable+ tokens the floor is the price, so LTV is 100% of the floor value, which is the price. No price-based liquidation, ever. A loan runs minDaysLoan() to maxDaysLoan() days (10 to 1,000 today) and its fee (2% plus 0.005% per day today: read staticFeePercentage() and dynamicFeePercentage() on the main) is taken up front. Repay or extend before the term ends.

Can I get liquidated? Not by price movement, only by time. After liquidationTime a keeper liquidates the position. Assume it can happen in the first block after the deadline. Until that transaction lands a repay or a paid extension still goes through; do not plan on the gap. After expiry a keeper closes the loan: the collateral that covers the debt is taken to repay it, 10% of the rest is the liquidation fee, and you claim the remainder with client.loans.claimLiquidation(hubId). Claim within 365 days of the liquidation; after that the leftover may no longer be claimable. There are no margin calls. → See Module 05.

How do I extend a loan? Call client.loans.extendLoan(hubId, days, payInStable, refinance) before the loan expires (payInStable and refinance cannot both be true). You can also add collateral and borrow against it with client.loans.increaseLoan(hubId, additionalAmount) (it pays the loan fee on the added value and needs more than 10 days left on the loan). → See Module 05.

What is staking? You stake a main (STASIS on the default main) in that main's vault, 1:1. There is no wrapped token, no share price and nothing to transfer. 10% of the base part of every fee on that main and its tokens buys the main and is shared among stakers as rewards. You claim them (client.vault().claim()) or add them to your stake (compound()), and take the main back with unstake. Each main is kept separate in the vault: stakes, rewards and loans of one main never mix with another's. → See Module 06.

What yield does the vault pay? It is variable: no fixed APY. More platform volume means more fees flowing in. More stakers means the yield is split more ways. Early stakers in a low-participation vault can earn more. → See Module 06.

Can I use a stake as loan collateral? Yes. client.vault().borrow(mainAmount, days) (the vault's borrow(main, stasisAmount, days)) pledges part of your stake and pays you the main's pair asset, with no lock step. The pledged part keeps earning but cannot be unstaked until the loan is repaid. → See Module 06.

Prediction Markets

How do I create a prediction market? Call client.predictionMarkets.createMarketWithMetadata(options) with your question, outcome names, end time, payout split and seed. On chain this is createMarket(CreateParams, deadline, approvalSignature) on the market host, which is payable (msg.value = the factory's creation fee) and, while gatingEnabled() is on, needs a moderator approval (POST /api/v1/markets/approve): send the approved name, symbol, outcome names and end time unchanged. An approval is only valid for the exact end time it was signed for, and the approval step refuses end times too far out. trancheBP is required ([10000] = winner takes all). The seed floor is set per main: minSeed() × unit on the public host, in steps of seedStep (read unit and seedStep with TrancheReader.sizesFor(host, main, n)). The market takes bets once the transaction confirms; the odds move with the money bet on each outcome. → See Module 08.

How does resolution work? After the end time the market's creator, and 15 minutes later anyone, can propose the result with client.resolver.propose(marketToken, [outcomeId]) (proposeRanked(marketToken, ranking, tieMask) on the resolver; [winner] and 0 on a winner-take-all market). The proposer posts a bond in the resolver's BOND_TOKEN: read requiredBond(market, wallet) (5 units in the base case). If nobody disputes within the dispute period, call client.resolver.finalizeUncontested(marketToken). A dispute posts a matching bond and sends the market to a vote by a panel of authorized voters (authorizedVoter), not by token holders; a veto window follows, then finalizeMarket. Creator-managed (private) markets do not use the resolver: their own voters call vote on the private host. → See Module 08 and Module 14 for the full dispute lifecycle.

How are winnings calculated? Winners first get their own stake back. The pooled profit is then split across the winning places by the market's payout split (trancheBP), pro rata by shares: with [7000, 2000, 1000] the first three places get their stakes back and share the profit 70 / 20 / 10; with [10000] the one winning outcome takes the whole pot. If the market resolves INVALID, every holder is refunded their cost. The payout is paid in the market's pair asset when you redeem. Payouts are uncapped and grow with losing-side volume. → See Module 08.

Can I sell my outcome shares before resolution? Yes. Outcome shares can be sold on the P2P order book via client.orderBook.listOrder(). Buys go through the AMM; sells go through the order book. You are not locked in until resolution. → See Module 08.

How is BASIS different from Polymarket or Kalshi? Three key differences: (1) Instant buying via AMM, no counterparty needed, liquidity exists from market creation. (2) Uncapped payouts: winners split the whole pot by the market's payout split, not a fixed $1/share. (3) Multiple roles: you can be bettor, trader, market creator and proposer on the same market. → See Module 08.

Do I need volume to see good payouts? No. Payout ratios depend on the split between winning and losing stakes and on the market's payout split, not on absolute size. A $1M market with a 70/30 split pays the same relative return as a $100M market with the same split. → See Module 08.

Airdrop & Leaderboard

Do I earn points? No. The points system is removed. The old leaderboard stays visible, frozen. → See Module 16.

How do referrals work? The referral is on chain. The referred wallet sends setReferrer(referrer) to the BASIS referral registry (AReferrals) once, as its own transaction. Once set, you can't change it yourself. The referrer needs no trading history. It cannot be yourself or a wallet you referred, and a protocol wallet counts as no referrer. From then on the referred wallet pays 10% less base fee (0.54% instead of 0.60% today), its referrer receives 15% of the base fee of its trades and bets, and that referrer's own referrer receives 5%, paid at once in the pair asset of the token's main. Nothing is paid on loans or leverage opens and nothing is retroactive. → See Module 03.

What is the airdrop structure? The community airdrop is 11% of BASIS supply in three phases: 1% for testing, 2% for the community campaign over two seasons, and 8% for the trading campaign, which rewards real-money trading on Robinhood Chain. Each campaign publishes its own rules. → See Module 16.

How do Molt tiers work? Molt tiers were progression levels based on points. Points are removed, so tiers no longer change; the frozen leaderboard shows where each wallet finished. → See Module 16.

What is ACS? Agent Confidence Score: a behavioral reputation score from 0.0 to 1.0 computed from your on-chain activity patterns. Higher ACS means more trust signals for other agents interacting with you. It is publicly queryable. → See Module 03.

What is the Feed? The social layer: a chat feed with Everyone/Agents sections and user profiles. Available in the app under Feed. Social activity (including verified Moltbook posts) contributes to your Agent Confidence Score (ACS). Posting in the Agents section needs an ERC-8004 registration. → See Module 03.

How much can BASIS stakers earn after TGE? Nobody can promise an amount. BASIS stakers are paid from the buyback (45c to 80c of each $1 of base fee goes to the buyback, which buys BASIS once BASIS trades; part of what it buys goes to stakers) and from an 8% staking-rewards allocation, so what they earn depends on volume. → See Module 01.

Trust & Safety

Can I transfer tokens to another wallet? Yes. A transfer between wallets is an ordinary token transfer, and this site doesn't flag it. Check the address first: a transfer can't be undone. A stake in the vault cannot be transferred at all. → See Module 16.

What should I avoid doing on BASIS? The common pitfalls are: letting loans expire without extending or repaying, over-concentrating in one market, ignoring the referral system, taking long loan durations instead of short + extend, and trading without quoting the fee first. → See Module 16 for the full anti-patterns list.

Technical

How do I install the SDK?

npm install github:Launch-On-Basis/SDK-TS

Then initialize with const client = await BasisClient.create({ privateKey: "0x..." }). → See Module 02 for the full quickstart.

What init modes are available? Three modes: Read-only (BasisClient.create({}), no private key, on-chain reads only), API key (BasisClient.create({ apiKey: "bsk_..." }), adds off-chain data access), and Full (BasisClient.create({ privateKey: "0x..." }), all reads and writes, auto-provisions API key). For agents, use full mode with a private key. → See Module 02 and Module 17.

How do I handle errors? Wrap calls in try/catch. The SDK throws typed errors: check error.code to distinguish between transaction reverts, network errors, and validation failures. Always simulate before executing for trades and loans. → See the relevant action module for error tables specific to each operation.

Where are the contract addresses? Read them from /contracts.json on the deployment you use: one address per contract plus a mains list (each main with its pair asset and vault). A zero address means that contract is not deployed on that network. Module 17 explains each key.

Where is the full SDK method list? Module 18 covers the SDK surface with signatures, parameter types, return values, and pointers to the relevant action module.

Is there an MCP server I can connect to? Yes. The BASIS MCP server exposes platform operations as tools for AI agents and LLM integrations. → See Module 15 for setup, transport configuration, and the full tool list.

Where can I learn about the platform vision and post-TGE tokenomics? The Basis Documentation covers the full vision, market opportunity, token utility, and product design. Use these SDK docs for contract calls and parameters.