mersui

MerSui

Simple "Buy Me a Coffee" React button with payments in SUI.
No intermediaries, you receive donations directly to your Sui address.

Demo

mersui.xyz

Installation

pnpm add mersui || yarn add mersui || npm install mersui

Usage

First, wrap your main app component into the MerSuiProvider component.

import { MerSuiProvider } from "mersui";

function App() {
  return (
    <MerSuiProvider network="mainnet">
      <YourApp />
    </MerSuiProvider>
  );
}

MerSuiProvider Props (IMerSuiProvider)

Prop	Type	Default	Description
network	"localnet", "devnet", "testnet", "mainnet"	"mainnet"	Network type

Then, use the MerSuiWidget component to render the button.

import { MerSuiWidget } from "mersui";

function App() {
  return (
    <div>
      <MerSuiWidget recipientAddress="0x..." />
    </div>
  );
}

MerSuiWidget Props (IMerSuiWidget)

Prop	Type	Default	Description
recipientAddress	string	-	Sui address of the recipient
amount	number	3	Optional amount in USD
buttonLabel	string	"MerSui"	Optional button label
containerClassName	string	-	Optional class name for the button container
buttonClassName	string	-	Optional class name for the button
statusClassName	string	-	Optional class name for the status message. The status-success and status-error classes are automatically added for your convenience.

That's it! Enjoy!

Pyth integration

MerSui uses Pyth's Sponsored Feed for SUI/USD to properly calculate the transaction amount in SUI. See lib/MerSuiWidget.tsx/fetchSuiPrice.

Known issues

• Next.js: Global CSS cannot be imported from within node_modules https://github.com/vercel/next.js/issues/19936

Development

The lib folder contains the source code of the library.

The src folder contains a demo app that you can use to play with the library locally.

But before that, you need to set up the environment variables:

# .env.local
VITE_RECIPIENT_ADDRESS=0x...

Then, run the development server:

pnpm dev

Build the library

pnpm build

License & copyright

Copyright (c) 2024 Konstantin Komelin

Licensed under the MIT License.