Handle wallets in a user's Ronin Waypoint account
Overview
This guide walks you through the ways to handle the different wallets associated with a user's Ronin Waypoint account. A Ronin Waypoint account can have up to two wallets: a keyless wallet and an optional EOA (externally owned account) Ronin Wallet. You can use this information to personalize the user experience, such as displaying the user's profile name or managing their wallet addresses.
Steps
Step 1. Understand user wallets
The user's Ronin Waypoint account includes the following details:
{
"account.wallet.identity":"0x123...",
"account.wallet.secondary":"0x456...",
"profile.name":"Lunacian"
}
| Key | Description | Use case |
|---|---|---|
account.wallet.identity | A keyless wallet that the user set up during the Ronin Waypoint onboarding process, or by using the keyless wallet option in the Ronin Wallet mobile app or browser extension. For more details, see Ways to set up a keyless wallet. | Treat this wallet as the user's spending account for in-game transactions and purchases, enabling the user to purchase, swap, and mint assets across Ronin games. It also supports actions like collecting daily check-ins and sending tokens or NFTs to other users. |
account.wallet.secondary | An optional EOA Ronin Wallet address. This address is present in the account if the user linked it manually. | Treat this wallet as the user's savings account for staking tokens or NFTs for rewards and governance, and storing valuable assets. |
profile.name | The user's display name that appears in games such as Axie Infinity. | Use this name to personalize the user experience. |
Ways to set up a keyless wallet
If the user doesn't have a keyless account.wallet.identity wallet, they can set it up in one of the following ways:
- By going through the Ronin Waypoint onboarding process on the waypoint.roninchain.com page. You can read more about this process on the About user journey page.
- By going through the onboarding process in a game or dApp that supports Ronin Waypoint. For example, Axie Classic or the Ronin Wallet mobile app or browser extension. For information on using the Ronin Wallet, see Creating Wallet with Email Address or Social Account.
Ways to link an EOA wallet
The user can link an account.wallet.secondary address to their Ronin Waypoint account by connecting it on the account management page. After linking, the user can't disconnect the wallet for the next 30 days. Similarly, if a user recently disconnected a Ronin Wallet address from their account, they can't reconnect the wallet to another account for the next 30 days. The user can, however, reconnect it to the old account immediately, as long as the account isn't linked to a different wallet yet.
Step 2. Retrieve account details
To retrieve user information and wallet addresses, send a GET request to the user profile endpoint with the user ID of the account you want to retrieve information for. Make sure to send the request server-side to protect your API key from being exposed and misused.
https://api-gateway.skymavis.com/account/v2/rpc/get-user-profile/{user_id}
For more information, see Retrieve user details.
Step 3. Handle wallet addresses
Depending on the number of wallet addresses associated with a Ronin Waypoint account, you can choose one of the following implementations:
| Number of wallet addresses | Suggested implementation |
|---|---|
| One address | Query this wallet for all transactions and authentication needs. |
| Two addresses | Choose one of the following:
|