← Protocols
Ronin
NFT / Marketplace·Ronin

Ronin

01Description

Sky Mavis's gaming-focused EVM L1, originally built for Axie Infinity and now home to Pixels, Wild Forest, Lumiterra and others. Ronin Waypoint is the official identity + keyless wallet SDK (web, React Native, iOS, Android, Unity), and the Ronin Marketplace + Mavis APIs cover NFT trading and on-chain data.

02Best for
  • 01web3 games (especially mobile)
  • 02Ronin Waypoint social login + keyless wallet
  • 03RON / AXS / SLP token UX
  • 04Ronin NFT marketplace integrations
  • 05Axie / Pixels / Wild Forest game data
03Install
  • pnpm add @sky-mavis/waypoint viem
04Environment variables
VariableScopeDescription
NEXT_PUBLIC_RONIN_WAYPOINT_CLIENT_IDClientWaypoint OAuth client ID from the Mavis developer console.
MAVIS_API_KEYServerAPI key for Mavis Market / Marketplace APIs (server-side).
05Prompt snippet
Use `@sky-mavis/waypoint` to add Ronin Waypoint login: `const waypoint = new RoninWaypoint({ clientId, redirectUri })`, call `waypoint.authorize()` to get an ID token + Ronin address, then `waypoint.sendTransaction()` / `waypoint.personalSign()` for in-app txs against the keyless wallet. For pure on-chain reads/writes use viem with `chain: ronin` (chainId 2020) against the Ronin RPC. Mobile apps should integrate the React Native, iOS, Android, or Unity Waypoint SDK so the keyless flow lives outside a webview.
06Gotchas
  • Ronin is a permissioned PoS chain with a small validator set — assume Sky Mavis can pause bridge or chain in incidents (the 2022 bridge hack response is the canonical example).
  • Royalties on the Ronin marketplace are enforced at the marketplace level (not at the token); third-party venues or peer-to-peer transfers won't pay creators.
  • Waypoint accounts are custodial keyless wallets managed by Sky Mavis MPC infrastructure — losing access to the OAuth identity (email/social) means losing the wallet, with no seed-phrase fallback by default.
  • Bridging assets in/out of Ronin uses the Ronin Bridge, which has variable confirmation windows and has historically been paused; design game economies to tolerate hours-long bridge delays.
  • Mavis Market API rate limits are tight without a key, and its schema differs from generic Reservoir/SimpleHash — don't assume cross-marketplace SDKs will work out of the box.
  • RNS (Ronin Name Service) names look like ENS but resolve through a separate registry; do not feed Ronin addresses to ENS resolvers.
07Alternatives