Class OutputData

constructor

• new OutputData(
      blindedMessage: SerializedBlindedMessage,
      blindingFactor: bigint,
      secret: Uint8Array,
      ephemeralE?: string,
  ): OutputData

  Parameters

  • blindedMessage: SerializedBlindedMessage
  • blindingFactor: bigint
  • secret: Uint8Array
  • OptionalephemeralE: string

  Returns OutputData

blindedMessage

blindingFactor

OptionalephemeralE

secret

toProof

• toProof(sig: SerializedBlindedSignature, keyset: HasKeysetKeys): Proof

  Parameters

  • sig: SerializedBlindedSignature
  • keyset: HasKeysetKeys

  Returns Proof

StaticcreateDeterministicData

• createDeterministicData(
      amount: AmountLike,
      seed: Uint8Array,
      counter: number,
      keyset: HasKeysetKeys,
      customSplit?: AmountLike[],
  ): OutputData[]

  Parameters

  • amount: AmountLike
  • seed: Uint8Array
  • counter: number
  • keyset: HasKeysetKeys
  • OptionalcustomSplit: AmountLike[]

  Returns OutputData[]

StaticcreateP2PKData

• createP2PKData(
      p2pk: P2PKOptions,
      amount: AmountLike,
      keyset: HasKeysetKeys,
      customSplit?: AmountLike[],
  ): OutputData[]

  Parameters

  • p2pk: P2PKOptions
  • amount: AmountLike
  • keyset: HasKeysetKeys
  • OptionalcustomSplit: AmountLike[]

  Returns OutputData[]

StaticcreateRandomData

• createRandomData(
      amount: AmountLike,
      keyset: HasKeysetKeys,
      customSplit?: AmountLike[],
  ): OutputData[]

  Parameters

  • amount: AmountLike
  • keyset: HasKeysetKeys
  • OptionalcustomSplit: AmountLike[]

  Returns OutputData[]

StaticcreateSingleDeterministicData

• createSingleDeterministicData(
      amount: AmountLike,
      seed: Uint8Array,
      counter: number,
      keysetId: string,
  ): OutputData

  Parameters

  • amount: AmountLike
  • seed: Uint8Array
  • counter: number
  • keysetId: string

  Returns OutputData

  Throws

  May throw if blinding factor is out of range. Caller should catch, increment counter, and retry per BIP32-style derivation.

StaticcreateSingleP2PKData

• createSingleP2PKData(
      p2pk: P2PKOptions,
      amount: AmountLike,
      keysetId: string,
      eBytes?: Uint8Array<ArrayBufferLike>,
  ): OutputData

  Parameters

  • p2pk: P2PKOptions
  • amount: AmountLike
  • keysetId: string
  • OptionaleBytes: Uint8Array<ArrayBufferLike>

    Optional fixed P2BK ephemeral key; batch callers pass one shared key for SIG_ALL. Omit for a fresh random key.

  Returns OutputData

StaticcreateSingleRandomData

• createSingleRandomData(amount: AmountLike, keysetId: string): OutputData

  Parameters

  • amount: AmountLike
  • keysetId: string

  Returns OutputData

Staticdeserialize

• deserialize(serialized: SerializedOutputData): OutputData

  Reconstructs concrete OutputData from its JSON-safe representation.

  Parameters

  • serialized: SerializedOutputData

  Returns OutputData

  Throws

  CTSError If any field fails validation: non-canonical or zero blindingFactor, malformed hex secret/ephemeralE, a secret that is not valid UTF-8, a B_ that does not match the secret and blindingFactor, or an Amount that cannot be parsed.

  See

  OutputData.serialize for the persist/restore lifecycle example.

Staticserialize

• serialize(output: OutputDataLike): SerializedOutputData

  Converts output data to a JSON-safe representation.

  Parameters

  • output: OutputDataLike

  Returns SerializedOutputData

  Remarks

  Pair with OutputData.deserialize to persist prepared melt change outputs (e.g. across a NUT-06 async melt's pending window) and reconstruct spendable change proofs via wallet.createMeltChangeProofs once the quote is paid.

  Example

  // Save while async melt is pending:
  const preview = await wallet.prepareMelt('bolt11', meltQuote, proofs);
  const stored = JSON.stringify(preview.outputData.map((o) => OutputData.serialize(o)));
  await wallet.completeMelt(preview, undefined, { preferAsync: true });
  
  // ... time passes, quote pays ...
  const restored = (JSON.parse(stored) as SerializedOutputData[]).map((s) =>
    OutputData.deserialize(s),
  );
  // zero-value entries carry no ecash (NUT-08); Amount.from also covers a quote rehydrated from JSON
  const sigs = (paidQuote.change ?? []).filter((s) => !Amount.from(s.amount).isZero());
  await wallet.ensureOperableKeysets(sigs.map((s) => s.id)); // change may be on a rotated-in keyset
  const change = wallet.createMeltChangeProofs(restored, sigs);
  Copy

StaticsumOutputAmounts

• sumOutputAmounts(outputs: OutputDataLike[]): Amount

  Calculates the sum of amounts in an array of OutputDataLike objects.

  Parameters

  • outputs: OutputDataLike[]

    Array of OutputDataLike objects.

  Returns Amount

  The total sum of amounts.