Wormhole Connect is a customizable React widget for cross-chain asset transfers powered by Wormhole.
Wormhole Connect is deployed live in several production apps. Here are a few:
If you're using React, you can import the <WormholeConnect />
component directly into your JSX:
npm i @wormhole-foundation/wormhole-connect
import WormholeConnect from '@wormhole-foundation/wormhole-connect';
function App() {
return (
<WormholeConnect />
);
}
If you're not using React, you can still embed Connect on your website by using the hosted version. Simply copy and paste the following code into your HTML body:
<!-- Mounting point. Include in <body> -->
<div id="wormhole-connect"></div>
<!-- Dependencies -->
<script type="module" src="https://www.unpkg.com/@wormhole-foundation/wormhole-connect@0.3.0/dist/main.js" defer></script>
<link rel="https://www.unpkg.com/@wormhole-foundation/wormhole-connect@0.3.0/dist/main.css" />
Note that the #wormhole-connect
element has to be present before the scripts are loaded.
You can customize and integrate Connect via our no-code solution: https://connect-in-style.wormhole.com/
Wormhole Connect is highly customizable via two props: config
and theme
. Here is an example which
limits it to two chains and customizes the background color:
import WormholeConnect, {
WormholeConnectConfig, WormholeConnectPartialTheme
} from '@wormhole-foundation/wormhole-connect';
const config: WormholeConnectConfig = {
networks: ['ethereum', 'solana']
};
const theme: WormholeConnectPartialTheme = {
background: {
default: '#212b4a'
}
};
function App() {
return (
<WormholeConnect config={config} theme={theme} />
)
}
If using the hosted version, provide config
and theme
as JSON-serialized strings on the mount point:
<div id="wormhole-connect" data-config="{...}" data-theme="{...}"></div>
Below are some of the more commonly used config options. See the full Connect docs for more complete documentation and examples of the different config options.
Connect renders in mainnet mode by default, but you can switch it to testnet by setting env
to testnet
.
const config: WormholeConnectConfig = {
env: 'testnet'
}
We strongly recommend that you configure your own custom RPC endpoints for each network your application needs. The default public RPCs may be throttled or rate limited.
const config: WormholeConnectConfig = {
rpcs: {
solana: 'https://mainnet.helius-rpc.com/?api-key=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
ethereum: 'https://rpc.ankr.com/eth/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx'
}
}
You can add arbitrary tokens to the Connect tokens menu by providing a tokensConfig
key.
const config: WormholeConnectConfig = {
tokensConfig: {
...
}
}
See the "Arbitrary Token" example in the config docs.
Please note you have to register a token with the token bridge before you can use it in Connect.
To configure custom NTT groups, include an nttGroups
key in your configuration.
const config: WormholeConnectConfig = {
nttGroups: {
// Your custom NTT groups go here
}
}
For a practical example of how to structure your custom NTT groups, refer to the nttGroups.ts file.
Please note that the tokenKey
specified in your custom NTT group must correspond to an existing entry in the tokensConfig, whether it's a built-in or a custom token.
You can also customize Connect's color scheme by providing a WormholeConnectTheme
as the theme
prop.
By default, Connect renders using the dark
theme.
import WormholeConnect, {
dark,
WormholeConnectTheme,
} from "@wormhole-foundation/wormhole-connect";
// alters the `dark` theme
const customized: WormholeConnectTheme = dark;
customized.success = '#212b4a';
customized.background.default = "navy";
customized.button.action = "#81c784";
customized.button.actionText = "#000000";
export default function App() {
return <WormholeConnect theme={customized} />;
}
You can change the theme
prop to dynamically change Connect's colors, for example when your application
switches from light to dark mode.
See the definitions of WormholeConnectTheme
and dark
in theme.ts for type definitions.
You can provide a whitelist of networks to limit which ones Connect offers.
const config: WormholeConnectConfig = {
networks: ['ethereum', 'solana']
}
By default, it offers its full built-in list for both mainnet
and testnet
:
mainnet |
testnet |
---|---|
ethereum | goerli, sepolia |
polygon | mumbai |
bsc | bsc |
avalanche | fuji |
celo | avalanche |
moonbeam | moonbasealpha |
solana | solana |
sui | sui |
aptos | aptos |
base | basegoerli, base_sepolia |
osmosis | osmosis |
evmos | evmos |
kujira | kujira |
injective | injective |
klaytn | klaytn |
arbitrum | arbitrumgoerli, arbitrum_sepolia |
optimism | optimismgoerli, optimism_sepolia |
scroll | scroll |
blast | blast |
Osmosis support is in beta, reach out to a Wormhole contributor for early access.
Please read the full Connect documentation to see what else is possible!
We welcome contributions and bug fixes. Please see CONTRIBUTING.md
This SDK is an open source software SDK that leverages the Wormhole protocol, a cross chain messaging protocol. The SDK does not process payments. THIS SDK AND THE WORMHOLE PROTOCOL ARE PROVIDED "AS IS", AT YOUR OWN RISK, AND WITHOUT WARRANTIES OF ANY KIND. By using or accessing this SDK or Wormhole, you agree that no developer or entity involved in creating, deploying, maintaining, operating this SDK or Wormhole, or causing or supporting any of the foregoing, will be liable in any manner for any claims or damages whatsoever associated with your use, inability to use, or your interaction with other users of, this SDK or Wormhole, or this SDK or Wormhole themselves, including any direct, indirect, incidental, special, exemplary, punitive or consequential damages, or loss of profits, cryptocurrencies, tokens, or anything else of value. By using or accessing this SDK, you represent that you are not subject to sanctions or otherwise designated on any list of prohibited or restricted parties or excluded or denied persons, including but not limited to the lists maintained by the United States' Department of Treasury's Office of Foreign Assets Control, the United Nations Security Council, the European Union or its Member States, or any other government authority.
Wormhole Connect is an NPM package that interacts with the Wormhole protocol. You assume all risks associated with using the SDK, the Wormhole Connect NPM package, the Wormhole protocol, and digital assets and decentralized systems generally, including but not limited to, that: (a) digital assets are highly volatile; (b) using digital assets is inherently risky due to both features of such assets and the potential unauthorized acts of third parties; (c) you may not have ready access to assets; and (d) you may lose some or all of your tokens or other assets. You agree that you will have no recourse against anyone else for any losses due to the use of the SDK or Wormhole. For example, these losses may arise from or relate to: (i) incorrect information; (ii) software or network failures; (iii) corrupted cryptocurrency wallet files; (iv) unauthorized access; (v) errors, mistakes, or inaccuracies; or (vi) third-party activities.