Wormhole Connect is a project to facilitate integration with the Wormhole protocol. It is thus far comprised of 3 components: wormhole-connect, sdk and builder.
Below is a brief introduction on each, see the corresponding READMEs for more information.
Wormhole Connect
An app that brings all the functionality and utility of the Wormhole token bridge right into your application and removes all of the complexity. It is built to be embedded within any application, simply copy a script tag or install the npm package.
Optionally, configure a number of parameters such as supported chains/tokens and theme.
Read more here
Customizer
Customize and integrate via our no-code solution
SDK
The beginning of a refactor of the existing sdk. It is written in Typescript and is built with ease-of-use in mind. It is organized into different context
classes (i.e. evm, solana, terra, etc) which each implement the same methods with standardized parameters.
Read more here
Builder
Initially this serves as a way to test integrating wormhole-connect.
In the future, this will become a playground where developers can come to customize their integration by selecting the chain and tokens they would like to support as well as edit theme variables to make it blend seamlessly within their application.
Read more here
Integration
Include the wormhole connect
<!-- include in <head> -->
<script type="module" src="https://www.unpkg.com/@wormhole-foundation/wormhole-connect@0.2.0/dist/main.js" defer></script>
<link rel="https://www.unpkg.com/@wormhole-foundation/wormhole-connect@0.2.0/dist/main.css" />
<!-- include in <body> -->
<div id="wormhole-connect"></div>
OR
import WormholeBridge from '@wormhole-foundation/wormhole-connect';
function App() {
return (
<WormholeBridge />
);
}
Contributing
Contributions are welcome! To work on wormhole-connect locally you’ll want to use npm link
to make the changes to the SDK immediately available.
Setup
- Link the sdk
cd ./sdk
npm i
npm run build
npm link
cd ../wormhole-connect
npm link @wormhole-foundation/wormhole-connect-sdk
- Install
Run npm i
at the root of the repo
- Start
Start wormhole-connect UI and view in browser at localhost:3000
# in /wormhole-connect
npm run start # testnet
Start builder UI and view in browser at localhost:3000
# in /builder
npm run start