Deprecation notice
The documentation for the Sky Mavis Account service will be deprecated soon. For new integrations, refer to the Ronin Waypoint service.
Sky Mavis Account is an OAuth 2.0 service that lets users sign in to your game or app with a passwordless flow, similar to other social login methods, for a seamless onboarding experience. It provides a single account for all games and apps in the Ronin ecosystem.
Features
- One account for all games and apps: while removing the burden of managing too many accounts, Sky Mavis Account lets your users connect other entities, such as Ronin Wallet or Axie Infinity Marketplace.
- Improved onboarding experience: Sky Mavis Account brings users to your apps faster by providing common social sign-in methods without having to go through complicated Web3 concepts at the early stage.
- Trusted sign-in provider: Sky Mavis Account is already implemented as a sign-in provider in dApps and games within the Sky Mavis ecosystem, such as Axie Infinity Origins, Axie Infinity Marketplace, or Mavis Hub.
Sign-in with Sky Mavis Account
Sky Mavis Account allows users to sign in to your app conveniently witha passwordless flow, similar to other social login methods.
If you're a game studio that wants to publish a game on Mavis Hub, then you need tointegrate with Sky Mavis Account so that users can access your gameon their desktop devices. If your game supports multiple platforms like iOSand Android, then the Sky Mavis Account service provides you with the same user IDthat the user used to play on Mavis Hub.
It might be the case that your game or app doesn't solely distribute onthe Sky Mavis publishing platform. With a Sky Mavis Account, your user cansign in with the same account to inherit the same in-game progress,using the same user ID and information across different platforms and devices.
The following sections describe some scenarios where you can implementSky Mavis Account as a sign-in method for your users.
Sign-in on Mavis Hub
If you want to onboard your game to Mavis Hub, you must implementSky Mavis Account to allow your users to access the game on their desktopdevices.
When your game is available on Mavis Hub, it receives a token from Mavis Hub.Using the token, the game can make a request to the Sky Mavis Account serverdirectly, and exclusively for this game. To access the game, the user onlyneeds to sign in to Mavis Hub once.
If your game supports multiple operating systems such as iOS and Android,Sky Mavis Account provides you with the same user ID that theplayer used to interact with the game on Mavis Hub.
Sign-in on the web or mobile
If your game is published as a standalone app or on mobile app stores, or,you can integrate Sky Mavis Account as a sign-in method and authenticateusers via an OpenID Connect (OIDC) flow.
Link user's Sky Mavis Account with your own account system
If the user already has an account in your game, Sky Mavis Account providesyou with a flow to link the user's Sky Mavis Accountwith their account in your game.
This use case offers two implementation scenarios described inthe following sections.
Link through Mavis Hub
Your app can retrieve a user ID when the user has signed in to your game.This ID represents the unique user ID of the Sky Mavis Account.The third-party backend account system can automatically and implicitly createa user account without needing the user to sign in with any other method.
Link in-game
Sky Mavis Account supports the OpenID 2.0 specification so that games canallow users to safely sign in to their account from within the game andretrieve their user ID by opening a web browser.
The following diagram illustrates the flow of linking a user's Sky Mavis Account:
Next steps
Follow the steps in the Get started guide to prepare your game or dApp for Sky Mavis Account integration.
