Spark Wallets

Dynamic offers full Spark wallet support through the @dynamic-labs/spark package, enabling seamless integration with Spark network wallets including Magic Eden and other Bitcoin-based wallets.

Installation

First, install the Spark wallet connector package:

npm install @dynamic-labs/spark

Supported Wallets

Magic Eden

The package includes full support for Magic Eden’s Spark wallet implementation, which provides:

• Connection Management - Seamless wallet connection and disconnection
• Address Retrieval - Get current wallet address
• Message Signing - Sign messages for authentication with optional Taproot support
• Bitcoin Transfers - Send Bitcoin to other Spark addresses
• Token Transfers - Transfer tokens between Spark addresses

Supported Networks

Network	Chain ID	Description	Block Explorer
Mainnet	301	Production network	mempool.space

Note: Currently only mainnet is supported. Testnet, signet, and regtest support may be added in future versions.

Basic Integration

To use Spark wallets in your app, add the Spark wallet connectors to your Dynamic configuration:

import { DynamicContextProvider } from '@dynamic-labs/sdk-react-core';
import { SparkWalletConnectors } from '@dynamic-labs/spark';

function App() {
  return (
    <DynamicContextProvider
      settings={{
        environmentId: 'your-environment-id',
        walletConnectors: [SparkWalletConnectors()],
      }}
    >
      {/* Your app content */}
    </DynamicContextProvider>
  );
}

Check if a wallet is a Spark wallet

The first thing you should do is check if the wallet is a Spark wallet. You can use the isSparkWallet helper method for that. That way, TypeScript will know which methods etc. are available to you.

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

const { wallet } = useDynamicContext();

if (!isSparkWallet(wallet)) {
  throw new Error('This wallet is not a Spark wallet');
}

Fetch the wallet address

You can get the wallet address using the wallet.address property:

const { primaryWallet } = useDynamicContext();

const sparkAddress = primaryWallet.address;

Send Bitcoin

To send Bitcoin to another Spark address, use the sendBalance or transferBitcoin method:

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

const { primaryWallet } = useDynamicContext();

const handleSendBitcoin = async () => {
  if (isSparkWallet(primaryWallet)) {
    // Send Bitcoin using sendBalance (alias for transferBitcoin)
    const txHash = await primaryWallet.sendBalance({
      amount: '100000', // 100,000 satoshis
      toAddress: 'sp1recipient123456789abcdef',
      isTaproot: false,
    });

    // Or use the direct transferBitcoin method
    const txHash2 = await primaryWallet.transferBitcoin({
      amount: '50000',
      toAddress: 'sp1recipient123456789abcdef',
      isTaproot: true,
    });
  }
};

Send Tokens

To send tokens to another Spark address, use the transferTokens method:

const handleSendTokens = async () => {
  if (isSparkWallet(primaryWallet)) {
    const txHash = await primaryWallet.transferTokens({
      tokenPublicKey: 'token123',
      receiverSparkAddress: 'sp1recipient123456789abcdef',
      tokenAmount: 1000,
      isTaproot: false,
    });
  }
};

Sign Messages

Spark wallets support message signing for authentication:

const handleSignMessage = async () => {
  if (isSparkWallet(primaryWallet)) {
    // Sign a regular message
    const signature = await primaryWallet.signMessage('Hello, Spark!');
    
    // Sign with Taproot support
    const taprootSignature = await primaryWallet.signMessageWithTaproot('Hello, Spark!');
  }
};

Custom Connector Implementation

To add support for a new Spark wallet, extend the SparkWalletConnector class:

import { SparkWalletConnector } from '@dynamic-labs/spark';

export class YourSparkConnector extends SparkWalletConnector {
  override name = 'Your Spark Wallet';
  override overrideKey = 'yourspark';

  public override getProvider(): ISparkProvider | undefined {
    return window.yourProvider;
  }
}

API Reference

Core Methods

• sendBalance(params) - Send Bitcoin (alias for transferBitcoin)
• transferBitcoin(params) - Send Bitcoin to a Spark address
• transferTokens(params) - Send tokens to a Spark address
• signMessage(message) - Sign a message for authentication
• signMessageWithTaproot(message) - Sign a message with Taproot support

Type Definitions

• SparkConnectionResult - Result from wallet connection
• SparkAddressResult - Result from address retrieval
• SparkSignMessageRequest - Message signing request options
• SparkSignatureResult - Result from message signing