Skip to main content

Set up and configure Ronin Waypoint

Overview

This guide walks you through the setup and configuration steps for integrating Ronin Waypoint into your game. You'll set up your app in the Ronin Developer Console, configure the Ronin Waypoint settings, and register smart contracts for transaction policy.

Prerequisites

Steps

Step 1. Sign up for Ronin Account

Register for a Ronin Account to access our Ronin Developer Console:

  1. Go to the Ronin Developer Console.
  2. Create an account using an email and password or social login.

Your Ronin Account is ready to use.

Step 2. Create an app in Ronin Developer Console

Next, create an app in the Ronin Developer Console:

  1. Log in to the Ronin Developer Console with your Ronin Account.

  2. Click New Project.

  3. Enter your app's name and project's type, then click Create.

  4. Select the app you created, then click Edit, and then on the Information tab, fill in the Website URL, and App Logo fields.

  5. Click Save.

Step 3. Configure Ronin Waypoint settings

Required parameters

Redirect URI, Origin URI, and Client ID are required to initialize the Ronin Waypoint SDK. Failure to provide these parameters will result in errors during the integration process.

Complete the setup steps to configure Ronin Waypoint for your app:

  1. In the Ronin Developer Console, select your app, then App Permission > Waypoint Account Service > Request Access.

  2. When your request is approved, you see Waypoint Account Service under Ronin Services.

  3. Click Waypoint Account Service, then click Edit.

  4. Configure your app for Ronin Waypoint:

    • In Token Expire Duration, define the expiration period for the ID token that is returned after user authorization with Ronin Waypoint. The recommended duration is 1 hour and at least 5 minutes. After expiration, you need to re-authorize Ronin Waypoint to issue a new ID token with the set duration.

    • In Redirect URI (required), define the URIs to which Ronin Waypoint navigates back after an authorization or transaction operation is completed. For mobile platforms, the redirect URI is your mobile app's deep link (for example, mydapp://callback).

      Make sure to allowlist your redirect URIs

      Share your redirect URIs with your Sky Mavis point of contact to allowlist them for your app.

    • In Origin URI (required), define your app's origin URI. This is the URI that's authorized to access the Ronin Waypoint service. The origin URI must have either the http or https scheme.

    • Click Save.

    You have now configured the settings for your app, and are ready to integrate Ronin Waypoint.

  5. Copy the value from the CLIENT ID (PROJECT ID) field. You will need this value for the next step.

Next steps

After the setup is complete, you can integrate Ronin Waypoint into your game using the SDK that best fits your platform: