@mooni/widget
TypeScript icon, indicating that this package has built-in type declarations

2.4.0 • Public • Published

🌚 Mooni Widget

npm (scoped)

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 ```

Readme

Keywords

none

Package Sidebar

Install

npm i @mooni/widget

Weekly Downloads

2

Version

2.4.0

License

GPL-3.0

Unpacked Size

34.8 kB

Total Files

10

Last publish

Collaborators

  • ngfar