Skip to content

pontem-network/liquidswap-widget

Repository files navigation

npm GitHub forks GitHub Repo stars GitHub contributors

Liquidswap Widget

A web component custom element which can be embedded to any frontend application or even plain html / js / css. Using full strength of @pontem/liquidswap-sdk widget can provide swap operations with multiple wallets.

Installation

yarn add @pontem/liquidswap-widget

or

npm install @pontem/liquidswap-widget

Usage

Function loadWidget accepts widgets HTML tag name. It can be custom name but should be in kebab case. We recommend to use 'liquidswap-widget' name. Passed name should be exactly the same as tag name.

React
import React, { useLayoutEffect } from 'react';
import { loadWidget } from '@pontem/liquidswap-widget';

export const Widget = () => {
  useLayoutEffect(() => {
    loadWidget('liquidswap-widget');
  }, []);
  return (
    <div className="'Your Wrapper className'">
      <liquidswap-widget/>
    </div>
  );
};
Vue
<template>
  <div class="'Your Wrapper class name'">
    <liquidswap-widget>
  </div>
</template>

<script setup lang="ts">
  import { loadWidget } from '@pontem/liquidswap-widget';
  
  loadWidget('liquidswap-widget');
</script> 
Any other framework / lib
  1. Make sure you added html tag liquidswap-widget into app.
<liquidswap-widget></liquidswap-widget>
  1. Import loadWidget function from npm and run with passing html tag name in kebab case;
import { loadWidget } from '@pontem/liquidswap-widget';
  
loadWidget('liquidswap-widget');

(back to top)

Roadmap

  • Integrate widget to Pontem Wallet.
  • Add theme support.
  • Add example with plain JS.
  • Expand token list.
  • Add MSafe wallet support.

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)