Documentation

OPEN SOURCE · MIT

🚀 What is KRIPTO NR.1?

KRIPTO NR.1 is an open-source, non-custodial crypto terminal. The platform never holds your funds and has no accounts, deposits or withdrawals of its own — every action is a transaction signed by your wallet and executed by the underlying protocol. The full source code is public on GitHub.

🔁 Swap & Bridge

The Swap tab is powered by the LI.FI aggregation protocol. It compares routes across every major DEX and bridge on 30+ chains and executes the best one. Token approvals and swaps run through LI.FI's audited contracts — the same infrastructure used by jumper.exchange.

📈 Perps

The Perps tab is a trading terminal for Hyperliquid, a fully on-chain perpetuals exchange. The terminal trades your own Hyperliquid account: deposit USDC at app.hyperliquid.xyz (Arbitrum), connect the same wallet here, and every order is signed locally by your wallet. On your first trade Hyperliquid asks for a one-time approval signature that routes orders through this interface.

🏦 Earn (DeFi)

The Earn tab lets you deposit USDC into blue-chip yield sources on Base for passive APY: Morpho (Gauntlet USDC Prime vault) and Aave v3 lending. Deposits go directly into each protocol's audited contracts — non-custodial, withdraw anytime. Rates are live and variable; there is no KRIPTO NR.1 fee on Earn (the platform earns when you fund via swap or buy crypto).

💳 Buy Crypto

The Buy Crypto button on the home page opens a fiat card on-ramp (via Privy + MoonPay/Coinbase) that delivers USDC or ETH straight to your connected wallet on Base — so you can fund the platform with a bank card without an exchange. KRIPTO NR.1 never holds your funds.

🔮 Predictions

The Predict tab shows live odds and volumes from Polymarket prediction markets. The "Trade" button opens the KRIPTO Predict terminal (open source) where you can trade with just an email login — a gasless smart wallet is created for you automatically; orders execute on Polymarket's order book.

🎰 Rocket Lottery

The original KRIPTO NR.1 game: a provably-fair on-chain crash game on Base with multipliers up to X10 (min bet 0.0001 ETH, max 0.001 ETH, house edge ≈ 2%). Outcomes use commit-reveal over a future blockhash — the contract source and design notes are in the contracts folder. It lives at its own URL, /lottery, and runs as a Base App Mini App.

✨ Points & rewards

Every swap, bridge, perp fill, Earn deposit and rocket launch earns KRIPTO points, scored on the USD volume that actually settled. Nothing is self-reported: the server re-reads each action from its own source of truth (the LI.FI status API, a Base receipt, or Hyperliquid's fill history) before a single point is minted, and every action counts exactly once.

Referrals pay 10% of everything your invitees earn and 3% from the people they invite — minted on top, never subtracted from them. Trading on consecutive days adds a streak multiplier up to ×1.5. Points convert into weekly token reward pools, free rocket launches, fee rebates and access to the private group; the live rulebook, tiers and leaderboard are on /points.

The private group is a 30-day subscription costing 100,000 points — about $10,000 of swap volume routed through the terminal. The round number sits above a derived floor: a period may never be worth less than the ~$20/month the group costs to run. Renewing early extends from the current expiry, so no day is lost. Because spending shouldn't demote a paying member, the leaderboard and tiers rank points earned over your lifetime, while the spendable balance is what remains after redemptions and rocket losses.

Points are also playable: the rocket has an ETH/points switch, and in points mode the same odds table (65% X0 · 22% X2 · 8% X3 · 4% X5 · 1% X10) settles against a points pool instead of the ETH bankroll. A round is committed against a Base block that does not exist yet and revealed from that block's hash, so every spin can be recomputed from public data — the round shows its block, hash and roll. Spinning earns no new points; only trading does. And when a real ETH launch wins you choose: claim the ETH, or take +25% of its value in points instead — no transaction, no gas, because taking points simply means not claiming.

One honest caveat: the points ledger is operated by this app, not by a contract. Points are a loyalty balance — the randomness behind a spin is on-chain and checkable, the balance itself is not an on-chain asset.

💸 Fees — full transparency

KRIPTO NR.1 is funded by small interface fees on top of the underlying protocol costs. There are no hidden markups beyond this table, and all values are visible in the open-source config (lib/monetize.ts):

ProductInterface feeHow it's charged
Swap & Bridge0.30% of the send amountIncluded in the quoted route (integrator kripto-nr1) — what you see quoted is what you get.
Perps0.025% of order notionalHyperliquid builder fee, added to the exchange fee on fills. You approve the exact maximum once, in your wallet, before your first trade.
Predictionsnone on this siteTrades execute on Polymarket under Polymarket's fees.
Lottery≈ 2% house edgeBuilt into the multiplier odds, enforced on-chain.

🔐 Security model

🛠 Self-hosting

Clone the repository, npm install, copy .env.example to .env.local and npm run dev. Every integration (chains, fees, contract addresses) is configured through environment variables — see the README for the full table.

🔗 Links