Skip to main content

​
Using Our UI

Dynamic provides a simple and easy-to-use interface for users to send tokens to any address on EVM and Solana This allows your users to easily move funds from their wallets without leaving the dapp, while removing the burden of creating send flows and gas calculations across all EVM networks and Solana for you as a developer. Note that for Solana, we also include a priority fee to improve success rates in case of congestion on the network. You have two options to surface this UI to your end users: the first is within the Dynamic Widget, and the second is programmatically opening the UI from your own site. We cover both options here.

​
Within Dynamic Widget/Embedded Widget

Once logged in, on the Wallets screen of the widget, you will notice a “Send” button. Clicking on this button will take you to the Send Token UI.
You can then choose from any available token in your wallet, add an amount and recipient address, then preview the transaction before confirming.

​
Standalone UI

You can use our useSendBalance hook to trigger the Send Balance UI component without the widget and optionally, prepopulate the form for the user.

​
How it works

The useSendBalance hook depends on the DynamicContextProvider, so it has to be used as a child of the Dynamic context. When you use the hook, you will get a function named open. That method accepts the follow options:
ParameterTypeDescription
recipientAddressStringThe initial recipient address
valueethers.BigNumberThe initial transaction amount
The open function will return a promise; If successful, the promise will be resolved with the transaction; if not successful, the promise will be rejected accompanied by the error collected from the provider. Here is an example of a custom Send button
React
import { useSendBalance } from "@dynamic-labs/sdk-react-core";

const MySendButton = () => {
  const { open } = useSendBalance();

  return <button onClick={() => open()}>Send</button>;
};
From this example, when the user clicks the button, they will be prompted to fill the amount and recipient fields, review the transaction, and they will see a confirmation at the end of the flow. For the second example, we will pre-populate the recipient and amount fields for the user.
React
import { useSendBalance } from "@dynamic-labs/sdk-react-core";
import { ethers } from "ethers";

const MySendButton = () => {
  const { open } = useSendBalance();

  const onClickSend = async () => {
    try {
      const tx = await open({
        recipientAddress: "<address>",
        value: ethers.utils.parseEther("1"),
      });
    } catch (err) {
      // Handle the promise rejection
    }
  };

  return <button onClick={onClickSend}>Send</button>;
};
Here, when the user clicks the button, they will be prompted with the same UI, but now it will be pre-populated with the recipient address and amount.

​
Using Your UI

​
We support native token sending for EVM, Solana, Bitcoin, Flow, Starknet and SUI

​
We support non-native token sending for EVM, Solana, and SUI

Wallets come with a sendBalance method that you can use.
  • We support native token sending for EVM, Solana, Bitcoin, Flow, Starknet and SUI
  • We support non-native token sending for EVM, Solana, and SUI

​
Examples for EVM and Solana

import { useDynamicContext } from '@dynamic-labs/sdk-react-core'
import { isEthereumWallet } from '@dynamic-labs/ethereum'

const { primaryWallet } = useDynamicContext()

if(primaryWallet && isEthereumWallet(primaryWallet)) {
  await primaryWallet.sendBalance()
}

​
Examples for Native and Non-Native token balance sending

  import { useDynamicContext } from '@dynamic-labs/sdk-react-core';

  export function SendNative() {
    const { primaryWallet } = useDynamicContext();

    const send = async () => {
      if (!primaryWallet) return;
      const txHash = await primaryWallet.sendBalance({
        amount: '0.01',          // string
        toAddress: '0xReceiverAddressHere',
      });
      console.log('tx:', txHash);
    };

    return <button onClick={send}>Send 0.01 ETH</button>;
}