Deposit SDK (Web)

Overview

The Deposit SDK provides a simple way to integrate the Onramp service into your games/dapps. Allow users to purchase cryptocurrencies directly using fiat currencies via different payment methods such as card, bank transfer and other local payment methods through the Ronin Waypoint service.

Prerequisites

Permission to use the Ronin Waypoint Account Service. For more information, see Setup and configuration.

Installation

To install the SDK, use the following command:

npm

npm install @sky-mavis/waypoint

Yarn

yarn add @sky-mavis/waypoint

pnpm

pnpm add @sky-mavis/waypoint

Usage

Initialize

import { Deposit } from "@sky-mavis/waypoint/deposit";

const deposit = new Deposit({
  clientId: "<client_id>",
});

Parameters for the Deposit class include:

Field	Required?	Description
clientId	Required	The client ID from the Ronin Developer Console. For more information, see Ronin Waypoint settings.
redirectUri	Optional	Equivalent to the REDIRECT URI configured in Ronin Waypoint settings. Default is window.location.origin.
theme	Optional	The theme of the deposit modal. Available values are light and dark.

Open the deposit pop-up

deposit.start();

The start method also accepts an object with the following parameters to pre-fill the user's information:

Field	Required?	Description
walletAddress	Optional	The Ronin wallet address of the customer.
fiatAmount	Optional	The initial amount of fiat currency you want the customer to buy cryptocurrency.
fiatCurrency	Optional	The code of the fiat currency you want the customer to buy cryptocurrency, e.g. USD, EUR, VND etc.
cryptoCurrency	Optional	The code of the cryptocurrency you want the customer to buy, e.g RON, SLP, AXS etc.
email	Optional	The email that will be used to identify your customer and their order.

warning

In the Ramp provider, when a user enters their wallet address manually, the address must include the ronin: prefix. For example, ronin:1234567890abcdef1234567890abcdef12345678.

The start method returns a Promise that resolves with an object containing the transaction details.

Field	Description
provider	The provider used for the transaction.
transactionHash	The hash of the transaction.
fiatCurrency	The fiat currency used in the transaction.
cryptoCurrency	The cryptocurrency used in the transaction.
fiatAmount	The amount of fiat currency involved in the transaction.
cryptoAmount	The amount of cryptocurrency involved in the transaction.

If the transaction is failed or cancelled, the Promise will reject with an object containing the error details.

Field	Description
code	The error code indicating the type of error.
message	The reason for the error or cancellation.

The deposit error codes are as follows:

Code	Description
4001	The user has closed the deposit pop-up.
-32603	The deposit transaction has failed.

Sample code

Here is an example of how to implement Onramp service in your application:

Step 1: Initialize an instance from the Deposit class

import {Deposit} from '@sky-mavis/waypoint/deposit';

export const deposit = new Deposit({
  clientId: '4d24b378-aa36-4952-8faa-bda63c9a4932',
});

Step 2: Open the deposit pop-up

Live Editor

function StartDeposit() {
  const [result, setResult] = useState(null);

  const handleDeposit = async () => {
    try {
      const result = await deposit.start({
        fiatCurrency: 'USD',
        cryptoCurrency: 'RON',
        fiatAmount: 100,
      });
      setResult(result);
    } catch (error) {
      alert(error);
    }
  };

  return (
    <LayoutBox>
      <Button label="Deposit with Ronin Waypoint" onClick={handleDeposit} />
      {result && (
        <span>{`You have deposited ${result.cryptoAmount} ${result.cryptoCurrency} to your Wallet`}</span>
      )}
    </LayoutBox>
  );
}

Result

Loading...

Additional Information

Supported crypto currencies

Details

Cryptocurrency	Code
Ronin	RON
Axie Infinity Shard	AXS
Smooth Love Potion	SLP
USD Coin	USDC
Ronin Wrapped Ether	WETH
PIXEL	PIXEL
BANANA	BANANA
Apeiros	APRS

Supported fiat currencies

Details

Currency Name	Currency Code
US Dollar	USD
British Pound	GBP
Indian Rupee	INR
Euro	EUR
Swiss Franc	CHF
Swedish Krona	SEK
Polish Zloty	PLN
Norwegian Krone	NOK
Danish Krone	DKK
New Zealand Dollar	NZD
Mexican Peso	MXN
Canadian Dollar	CAD
Australian Dollar	AUD
Argentine Peso	ARS
Brazilian Real	BRL
Chilean Peso	CLP
Costa Rican Colon	CRC
Dominican Peso	DOP
Indonesian Rupiah	IDR
Israeli Shekel	ILS
Japanese Yen	JPY
South Korean Won	KRW
Malaysian Ringgit	MYR
Paraguayan Guarani	PYG
Peruvian Sol	PEN
Philippine Peso	PHP
Singapore Dollar	SGD
Fiji Dollar	FJD
Forint	HUF
Kenyan Shilling	KES
Moldovan Leu	MDL
Bermudian Dollar	BMD
Falkland Islands Pound	FKP
Czech Koruna	CZK
Iceland Krona	ISK
Romanian Leu	RON
Kwanza	AOA
Belize Dollar	BZD
Brunei Dollar	BND
Comoro Franc	KMF
Djibouti Franc	DJF
East Caribbean Dollar	XCD
Lari	GEL
Quetzal	GTQ
Lempira	HNL
Hong Kong Dollar	HKD
Tenge	KZT
Som	KGS
Malagasy Ariary	MGA
Kwacha	MWK
Ouguiya	MRU
Rial Omani	OMR
Kina	PGK
Rwanda Franc	RWF
Dobra	STN
Seychelles Rupee	SCR
Solomon Islands Dollar	SBD
Surinam Dollar	SRD
Lilangeni	SZL
Somoni	TJS
Pa’anga	TOP
Turkmenistan New Manat	TMT
Peso Uruguayo	UYU
Colombian Peso	COP
Taiwanese Dollar	TWD
Ghanaian Cedi	GHS
UAE Dirham	AED
Cambodian Riel	KHR
Serbian Dinar	RSD
Bahraini Dinar	BHD
Macedonian Denar	MKD
Kuwaiti Dinar	KWD
Armenian Dram	AMD
Netherlands Antilles Guilder	ANG
Azerbaijani Manat	AZN
Bahamian Dollar	BSD
Cayman Islands Dollar	KYD
Cape Verdean Escudo	CVE
BH Convertible Mark	BAM
Jordanian Dinar	JOD
Trinidad & Tobago Dollar	TTD
Panamanian Balboa	PAB
Algerian Dinar	DZD
Bulgarian Lev	BGN
Egyptian Pound	EGP
Sri Lankan Rupee	LKR
Nigerian Naira	NGN
Thai Baht	THB
Turkish Lira	TRY
Vietnamese Dong	VND
South African Rand	ZAR
Botswana Pula	BWP
Mozambican Metical	MZN
Lao Kip	LAK