lightning/lnd_methods/onchain/send_to_chain_addresses.d.ts

Lightning Network client library

import * as ws from 'ws';
import {
  AuthenticatedLightningArgs,
  AuthenticatedLightningMethod,
  LightningError,
  UtxoSelection,
} from '../../typescript';
import {MergeExclusive} from 'type-fest';

type ExpectedLogForChainSendWebSocketAnnouncement = MergeExclusive<
  {
    /** Web Socket Servers */
    wss: ws.Server[];
    /** Log */
    log: (err: LightningError) => void;
  },
  {wss?: never; log?: never}
>;

export type SendToChainAddressesArgs = AuthenticatedLightningArgs<
  {
    /** Transaction Label */
    description?: string;
    /** Chain Fee Tokens Per Virtual Byte */
    fee_tokens_per_vbyte?: number;
    send_to: {
      /** Address */
      address: string;
      /** Tokens */
      tokens: number;
    }[];
    /** Confirmations To Wait */
    target_confirmations?: number;
    /** Minimum Confirmations for UTXO Selection */
    utxo_confirmations?: number;
    /** Select UTXOs Using Method String */
    utxo_selection?: UtxoSelection;
  } & ExpectedLogForChainSendWebSocketAnnouncement
>;

export type SendToChainAddressesResult = {
  /** Total Confirmations */
  confirmation_count: number;
  /** Transaction Id Hex */
  id: string;
  /** Transaction Is Confirmed */
  is_confirmed: boolean;
  /** Transaction Is Outgoing */
  is_outgoing: boolean;
  /** Transaction Tokens */
  tokens: number;
};

/**
 * Send tokens to multiple destinations in a blockchain transaction.
 *
 * Requires `onchain:write` permission
 *
 * `utxo_confirmations` is not supported on LND 0.11.1 or below
 *
 * `utxo_selection` is not supported in LND 0.17.5 and below
 */
export const sendToChainAddresses: AuthenticatedLightningMethod<
  SendToChainAddressesArgs,
  SendToChainAddressesResult
>;