lightning/lnd_methods/offchain/pay_via_payment_details.d.ts

Lightning Network client library

import {
  AuthenticatedLightningArgs,
  AuthenticatedLightningMethod,
} from '../../typescript';

export type PayViaPaymentDetailsArgs = AuthenticatedLightningArgs<{
  /** Final CLTV Delta */
  cltv_delta?: number;
  /** Destination Public Key */
  destination: string;
  features?: {
    /** Feature Bit */
    bit: number;
  }[];
  /** Payment Request Hash Hex */
  id?: string;
  /** Pay Through Specific Final Hop Public Key Hex */
  incoming_peer?: string;
  /** Maximum Fee Tokens To Pay */
  max_fee?: number;
  /** Maximum Fee Millitokens to Pay */
  max_fee_mtokens?: string;
  /** Maximum Millitokens For A Multi-Path Path */
  max_path_mtokens?: string;
  /** Maximum Simultaneous Paths */
  max_paths?: number;
  /** Maximum Expiration CLTV Timeout Height */
  max_timeout_height?: number;
  messages?: {
    /** Message Type number */
    type: string;
    /** Message Raw Value Hex Encoded */
    value: string;
  }[];
  /** Millitokens to Pay */
  mtokens?: string;
  /** Pay Out of Outgoing Channel Id */
  outgoing_channel?: string;
  /** Pay Out of Outgoing Channel Ids */
  outgoing_channels?: string[];
  /** Time to Spend Finding a Route Milliseconds */
  pathfinding_timeout?: number;
  /** Payment Identifier Hex String */
  payment?: string;
  routes?: {
    /** Base Routing Fee In Millitokens */
    base_fee_mtokens?: string;
    /** Standard Format Channel Id */
    channel?: string;
    /** CLTV Blocks Delta */
    cltv_delta?: number;
    /** Fee Rate In Millitokens Per Million */
    fee_rate?: number;
    /** Forward Edge Public Key Hex */
    public_key: string;
  }[][];
  /** Tokens To Pay */
  tokens?: number;
}>;

export type PayViaPaymentDetailsResult = {
  /** Confirmed at ISO-8601 Date */
  confirmed_at: string;
  /** Total Fee Tokens Paid Rounded Down */
  fee: number;
  /** Total Fee Millitokens Paid */
  fee_mtokens: string;
  hops: {
    /** First Route Standard Format Channel Id */
    channel: string;
    /** First Route Channel Capacity Tokens */
    channel_capacity: number;
    /** First Route Fee Tokens Rounded Down */
    fee: number;
    /** First Route Fee Millitokens */
    fee_mtokens: string;
    /** First Route Forward Millitokens */
    forward_mtokens: string;
    /** First Route Public Key Hex */
    public_key: string;
    /** First Route Timeout Block Height */
    timeout: number;
  }[];
  /** Payment Hash Hex */
  id: string;
  /** Total Millitokens Paid */
  mtokens: string;
  paths: {
    /** Total Fee Millitokens Paid */
    fee_mtokens: string;
    hops: {
      /** First Route Standard Format Channel Id */
      channel: string;
      /** First Route Channel Capacity Tokens */
      channel_capacity: number;
      /** First Route Fee Tokens Rounded Down */
      fee: number;
      /** First Route Fee Millitokens */
      fee_mtokens: string;
      /** First Route Forward Millitokens */
      forward_mtokens: string;
      /** First Route Public Key Hex */
      public_key: string;
      /** First Route Timeout Block Height */
      timeout: number;
    }[];
    /** Total Millitokens Paid */
    mtokens: string;
  }[];
  /** Total Fee Tokens Paid Rounded Up */
  safe_fee: number;
  /** Total Tokens Paid, Rounded Up */
  safe_tokens: number;
  /** Payment Preimage Hex */
  secret: string;
  /** Expiration Block Height */
  timeout: number;
  /** Total Tokens Paid Rounded Down */
  tokens: number;
};

/**
 * Pay via payment details
 *
 * If no id is specified, a random id will be used.
 *
 * Requires `offchain:write` permission
 *
 * `payment` is not supported on LND 0.11.1 and below
 *
 * `max_path_mtokens` is not supported in LND 0.12.0 or below
 *
 */
export const payViaPaymentDetails: AuthenticatedLightningMethod<
  PayViaPaymentDetailsArgs,
  PayViaPaymentDetailsResult
>;