Send Bitcoin

Transfer BTC using the high-level sendBitcoin method in the Dynamic Flutter SDK.

DynamicSDK.instance.bitcoin.sendBitcoin builds, signs, and broadcasts a Bitcoin transfer in a single call. Use it when you don’t need to inspect or modify the PSBT before broadcast — see Build a PSBT and Sign a PSBT for the manual flow.

Example

import 'package:dynamic_sdk/dynamic_sdk.dart';

final sdk = DynamicSDK.instance;
final wallet = sdk.wallets.userWallets.firstWhere(
  (w) => w.chain == 'BTC',
);

final txId = await sdk.bitcoin.sendBitcoin(
  walletId: wallet.id,
  recipientAddress: 'bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh',
  amount: '50000',          // 50_000 sats = 0.0005 BTC
  feePriority: 'medium',    // optional: 'high', 'medium', or 'low'
);
print('Broadcasted: $txId');

Parameters

Parameter	Type	Description
walletId	String	The id of a wallet whose chain == 'BTC'.
recipientAddress	String	Destination address.
amount	String	Amount in satoshis, encoded as a string to preserve precision.
feePriority	String?	Fee tier: 'high', 'medium', or 'low'. Defaults are connector-specific.

Returns

Future<String> — the broadcasted transaction id (txid).

Converting BTC to satoshis

amount is always a satoshi string. 1 BTC = 100,000,000 satoshis. Convert from a user-supplied BTC value before calling:

String btcToSats(double btc) =>
    BigInt.from((btc * 100000000).round()).toString();

final txId = await sdk.bitcoin.sendBitcoin(
  walletId: wallet.id,
  recipientAddress: 'bc1q...',
  amount: btcToSats(0.001), // '100000'
);