Skip to main content

About gas sponsorship

Overview​

This page explains the concepts of sponsored transactions and gas sponsorship in Ronin Waypoint. A sponsored transaction is one where a Ronin address (the payer) pays the gas fees for a transaction that another Ronin address (the user) initiates. You can use sponsored transactions to cover the fees for users in your game, which removes an obstacle for new users who would otherwise need to purchase tokens to send a transaction on-chain.

Gas sponsorship programs​

Ronin Waypoint supports two types of gas sponsorship programs: global gas sponsorship and local studio gas sponsorship. The global gas sponsorship program is funded by Sky Mavis, while the local studio gas sponsorship program is funded by the studio and Sky Mavis in a joint effort.

Global gas sponsorship​

  • Each new Ronin Waypoint user is eligible for a number free gas transactions. A new user is defined as a user who registers Ronin Waypoint service from the date defined by Sky Mavis.
  • The five free gas transactions can be used in all games/dApps that integrated and use Ronin Waypoint.
  • The funds for global gas sponsorship are provided by Sky Mavis.
  • The rules, eligibility criteria, and expiration date of the global gas sponsorship program are determined by Sky Mavis.
  • The payer wallet and the private key are controlled by Sky Mavis.

Local studio gas sponsorship​

  • The funds are jointly provided by Sky Mavis and the studio. For example, Sky Mavis provides 50% of the funds, and the studio provides the other 50%. Or the studio can sponsor 100% of the funds.
  • The program applies to all the users who interact with the allowlisted smart contract address and specific functions in the game.
  • The rules, eligibility criteria, and expiration date of the local gas sponsorship program are determined by the studio, using a template provided by Sky Mavis.
  • The payer wallet and the private key are controlled either by Sky Mavis or the studio, subject to the agreement between the two parties.

For a step-by-step guide on how to apply for gas sponsorship, see Use gas sponsorship.

Gas sponsorship flow​

  1. User initiates a transaction with Ronin Waypoint. The transaction type is 0x64.
  2. Using the user's access token, Ronin Waypoint requests the user's sponsored transaction quota from the sponsoring service.
  3. Ronin Waypoint verifies the user's eligibility for a sponsored transaction with the sponsoring service. Outcomes include:
    • Local sponsorship: the user interacts with an allowlisted contract, wherein Ronin Waypoint applies sponsorship automatically for uninterrupted user experience.
    • Global sponsorship: the user has a number of sponsored gas vouchers, which they can choose to apply to transactions.
    • Neither: the user is not elibigle for a sponsored transactions and must bear the gas fees.
  4. The user signs the transaction with senderSignature and submits it to the sponsoring service.
  5. Sponsoring service requests the payer to sign the transaction with payerSignature.
  6. Payer signs the transaction with payerSignature, indicating its agreement to sponsor the gas fees.
  7. The transaction, signed by both the user and the payer, is submitted to the Ronin chain for processing.

Gas sponsorship priority​

When a user submits a transaction, Ronin Waypoint checks the user's eligibility for gas sponsorship. The priority of check is as follows:

  1. Local studio gas sponsorship. The system checks whether the user meets the eligibility criteria defined by the studio, and if yes, automatically applies the gas discount. Note: if the payer wallet balance is less than 0.02 RON, the system switches to global gas sponsorship.
  2. Global gas sponsorship. The system checks whether the user is eligible for global gas sponsorship based on the following criteria:
    • Age of the user account
    • Remaining free gas transactions
    If the user meets the criteria, the system automatically applies the gas discount.
  3. No gas sponsorship. If the user does not meet the criteria for local or global gas sponsorship, the system does not apply any gas discount and the user must bear the gas fees.

User experience​

If a user is eligible for gas sponsorship, Ronin Waypoint automatically applies the gas voucher in the transaction pop-up.

Refer to a video demonstration of transaction signing and subsequent view of the transaction in the explorer.