Docs
How MagcitoFi works
Short, factual notes on connecting, comparing routes, approvals and gas, the errors you may see, and what is and is not supported.
Connecting a wallet
Press Connect wallet. Every wallet extension installed in your browser is listed (EIP-6963 discovery); in-app wallet browsers work the same way. Connecting shares your public address only. MagcitoFi never asks for a seed phrase or private key, and never can: signing and broadcasting happen inside your wallet.
The app runs on Robinhood Chain (chain id 4663). If your wallet is on another network the header shows it and the Swap button becomes Switch wallet; if the network is missing from the wallet, the switch request adds it from the official RPC and explorer URLs.
Disconnecting, rejecting a connection or changing accounts is handled without reloading; quotes are keyed to the wallet and refetched.
How route comparison works
For one input amount, every supported source is asked at the same time and independently: Uniswap V3 (QuoterV2), Uniswap V2 (Router02), Uniswap V4 (V4Quoter over pools discovered on-chain) and the KyberSwap aggregator. Each answer is normalised into the same shape — provider and route id, chain, tokens, input, expected output, minimum received, fee breakdown, gas estimate and its source, price impact when calculable, route legs, timestamp and expiry, and what the transaction needs.
Only quotes for the same chain, pair and amount are comparable; expired ones are excluded. The list is ranked by expected output, or net of gas when every route can be valued in USD through a Chainlink feed pinned by address. The label “Best among available quotes” appears only when at least two valid routes exist; a single route is called exactly that. No global best-price guarantee is made.
Fees already inside a venue’s output (pool, hook, aggregator) are shown but never subtracted again. Gas is shown separately when it cannot be converted, and the page says the ranking excludes it.
Split routing is shown only when KyberSwap returns an executable route that splits the order across several paths; its router settles all paths in one transaction and enforces one minimum for the total. MagcitoFi does not divide an order visually or run sequential swaps and call them atomic.
Approvals and gas
Selling an ERC-20 requires an allowance to the venue’s verified contract (Router02, SwapRouter02, or KyberSwap’s router). By default MagcitoFi requests an exact-amount approval; an unlimited approval is available in settings and stated in the review. Uniswap V4 routes pull tokens through Permit2, which needs two steps: a token approval to Permit2, then a 30-minute exact-amount grant from Permit2 to the Universal Router.
After an approval confirms, the flow stops on purpose: the 30-second quote is stale by then, so a fresh quote is fetched and you confirm the swap against the current price.
Gas is paid in ETH. The estimate shown comes from the quoter’s meter, the provider, or a labelled typical figure; your wallet estimates the real value at signing. Gas paid on the Activity page is gasUsed × effectiveGasPrice from the receipt.
Before your wallet opens, the app refreshes the selected quote, re-checks the terms, checks balance and allowance, decodes the calldata (target, recipient, tokens, amount, minimum) and simulates the transaction from your account. Nothing is sent if any step fails.
Common transaction errors
- You rejected the request in your wallet
- Nothing was sent. Press Review swap again when ready.
- Insufficient balance / not enough ETH for gas
- The sell amount plus gas must fit your balance. “Max” on ETH keeps a gas reserve for this reason.
- The price moved beyond your slippage limit
- The router refused the trade because the output fell below the minimum. Refresh the quote, or raise the tolerance for illiquid pairs.
- The transaction deadline passed
- Quotes carry a 20-minute deadline; a transaction stuck longer than that reverts. Refresh and try again.
- The router could not pull your tokens
- The approval is missing or too small, or the token restricts transfers (pause, blocklist). Re-run the approval step.
- Simulation failed — nothing was sent
- The call reverted from your account at the latest block. The reason is shown; common causes are a pool that changed, a hook that refuses the trade, or a paused token.
- Terms changed — review again
- The refreshed quote differs materially from the one you reviewed (lower output or minimum, different route or target). Load the refreshed quote and read it again.
- Status unknown / no receipt
- The RPC did not answer in time or the hash is no longer known. The transaction may still confirm; follow the explorer link or press Re-check on the Activity page. It is never marked as a success or a failure without a receipt.
- Replaced
- Your wallet re-sent the same nonce (speed-up or cancel). The replacing hash is recorded and its receipt decides the outcome.
Supported capabilities
Supported: exact-input swaps between native ETH and ERC-20s, or between ERC-20s, on Robinhood Chain; quote comparison across Uniswap V2 / V3 / V4 and KyberSwap; atomic split routes through KyberSwap; exact or unlimited approvals; Permit2 for Uniswap V4; pre-sign simulation; receipt tracking with pending / confirmed / reverted / replaced / unknown states; token import by contract address with on-chain metadata and Sourcify status.
Not supported: exact-output swaps; limit orders; cross-chain swaps; fee-on-transfer and rebasing tokens; ETH ↔ WETH wrapping (use the WETH contract); the testnet (46630) beyond RPC reads; 0x, LI.FI and Relay until their contracts are verified and their calldata is decoded here. The full, live registry is on the Transparency page.
External documentation
- Robinhood Chain — connecting (chain ids, RPC, explorer)
- Robinhood Chain — contracts (WETH, USDG)
- Robinhood Chain — oracles and price feeds
- Robinhood Stock Token APIs (issuer registry)
- Uniswap deployment registry (deployments.json)
- KyberSwap Aggregator API — EVM swaps
- Sourcify — contract verification
- EIP-6963 — multi-injected-provider discovery
Official channels
- Websitewww.magcitofi.xyz
- X@MagcitoDeFi
These are the only channels MagcitoFi publishes on. A contract address, airdrop or announcement that does not appear on this site or on @MagcitoDeFi is not ours.