Frontend integration

​​​​

​Mooni is the off-ramping solution for the DeFi ecosystem, which can enable users of your dApp to cash out the cryptocurrencies they earn directly into their bank account.

Our widget SDK is a super simple solution to integrate Mooni into your already existing application. The widget can either appear as a modal on top of an app, or included inside an HTML element. If the hosting app already has a connected user with web3, this wallet can be forwarded to the widget.

📺 Example integration

Check our live integration example (code)

🎁 Quick start

Install

yarn add @mooni/widget

Start widget

// Import package 
import MooniWidget from '@mooni/widget';
​
// Instanciate the widget 
const mooni = new MooniWidget(); 
​
// Open the widget as a modal when you want it 
mooni.open();

That’s it 🥂 !

🎛 API Reference

MooniWidget

constructor(opts: MooniWidgetOptions)  

Methods

Open widget

open(): void  

Opens Mooni as a widget.

Set Ethereum provider

setEthereum(ethereum?: EthereumProvider): void  

Set an Ethereum provider. Call this method when your users log in with their wallet. They will become automatically logged in Mooni.

MooniWidgetOptions

containerElement?: HTMLElement  

Include Mooni inside of an HTML element on your website if you don’t want to use modal mode.

ethereum?: EthereumProvider  

A standard JSON-RPC provider. This is useful if the hosting app already authenticated the web3 wallet of the user, so he doesn’t have to login again on Mooni.

token?: string  

Automatically select a token to sell in Mooni. Must be an ERC20 contract address. Default is ETH.

referralId?: string  

Sets a referral account. All orders passed with this referral ID through the widget will share profit. You can find your referral ID on your Account page.

Additional information

Import on different module systems

• ES6

import MooniWidget from '@mooni/widget';

• CommonJS

const MooniWidget = require('@mooni/widget');

• UMD

  /* available as MooniWidget */  
</script> ```   
## 💻 Development  
  
``` # Install dependencies yarn    
 # Build package yarn build    
 # Publish package npm publish ```

​