queryHTLC

Queries HTLCs with flexible filtering options.

Method Signature

async queryHTLC({
  paymentHashes,
  status,
  transferIds,
  matchRole,
  limit,
  offset,
}: {
  paymentHashes?: string[];
  status?: PreimageRequestStatus;
  transferIds?: string[];
  matchRole?: PreimageRequestRole;
  limit?: number;
  offset?: number;
}): Promise<QueryHtlcResponse>

Parameters

string[]

Array of payment hashes to filter by

PreimageRequestStatus

Filter by HTLC status

string[]

Array of transfer IDs to filter by

PreimageRequestRole

Filter by role (default: PREIMAGE_REQUEST_ROLE_RECEIVER)

number

Maximum results to return (1-100, default: 100). Values outside this range throw SparkValidationError.

number

Pagination offset (default: 0). Must be non-negative.

Returns

QueryHtlcResponse

required

HTLC query results

Example

const htlcs = await wallet.queryHTLC({
  limit: 50,
  offset: 0
});
console.log("HTLCs:", htlcs);

Introduction

Wallets

Wallet Viewer

Utilities

Issuance

Method Signature

Parameters

Returns

Example