@mooni/widget
v2.4.0
Published
Mooni Widget SDK
Downloads
26
Readme
🌚 Mooni Widget
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 ```