{
  "configurations": [
    {
      "macaroon": "<hex-encoded-macaroon>",
      "cert": "<optional-tls-cert>",
      "uri": "https://your-node.com:8080"
    }
  ]
}

// Fetch node information from /v1/getinfo endpoint
const response = await fetch(`${config.url}/v1/getinfo`, {
  headers: {
    'Grpc-Metadata-macaroon': config.macaroon,
    'Content-Type': 'application/json'
  }
})

type LNDNodeInfo = {
  version: string                // LND version
  commit_hash: string            // Git commit hash
  identity_pubkey: string        // Node public key
  alias: string                  // Node alias
  num_active_channels: number    // Active channel count
  num_peers: number              // Connected peers
  block_height: number           // Current block height
  block_hash: string             // Latest block hash
  best_header_timestamp: string  // Latest block timestamp
  synced_to_chain: boolean       // Sync status
  chains: string[]               // Connected chains
  uris: string[]                 // Node URIs
}

type LNDChannel = {
  active: boolean                // Channel active status
  remote_pubkey: string          // Peer public key
  channel_point: string          // Funding transaction
  chan_id: string                // Channel ID
  capacity: number               // Total capacity (sats)
  local_balance: number          // Your balance (sats)
  remote_balance: number         // Peer balance (sats)
  commit_fee: number             // Commitment fee
  unsettled_balance: number      // Pending HTLCs
  total_satoshis_sent: number    // Lifetime sent
  total_satoshis_received: number // Lifetime received
  num_updates: number            // State updates
  private: boolean               // Private channel
  initiator: boolean             // You opened channel
  lifetime: number               // Channel age (seconds)
  uptime: number                 // Uptime (seconds)
}

// Create invoice via /v1/invoices endpoint
const invoice = await createInvoice(
  amount,      // Amount in satoshis
  description  // Invoice memo
)

type LNDecodedInvoice = {
  payment_request: string   // Original invoice
  value: string            // Amount (sats)
  description: string      // Payment memo
  timestamp: string        // Creation time
  expiry: string          // Expiration
  payment_hash: string    // Payment identifier
  payment_addr: string    // Payment address
  num_satoshis: string    // Amount in satoshis
  num_msat: string        // Amount in millisats
  payment_secret: string  // Payment secret
  min_final_cltv_expiry: string // CLTV delta
}

const payment = await payInvoice(paymentRequest)

// Poll /v1/payments/{payment_hash} until status is SUCCEEDED or FAILED
while (attempts < maxAttempts) {
  const status = await checkPaymentStatus(payment_hash)
  if (status === 'SUCCEEDED') break
  if (status === 'FAILED') throw new Error('Payment failed')
  await sleep(1000) // Wait 1 second
}

type LNDPaymentResponse = {
  payment_hash: string      // Payment identifier
  payment_preimage: string  // Proof of payment
  status: string           // SUCCEEDED | FAILED | IN_FLIGHT
}

type LNDConfig = {
  macaroon: string  // Hex-encoded macaroon
  cert: string      // TLS certificate
  url: string       // REST API endpoint
}

Grpc-Metadata-macaroon: <hex-encoded-macaroon>

const makeRequest = async <T>(
  endpoint: string,
  options?: LNDRequestOptions
) => Promise<T>

// Get pending channels
const pending = await makeRequest('/v1/channels/pending')

// Close channel
await makeRequest('/v1/channels/${channelPoint}', {
  method: 'DELETE',
  body: { force: false }
})