@did-btcr2/method 0.37.0 → 0.38.0

package/dist/browser.js

@@ -93172,6 +93172,7 @@ a=end-of-candidates
     BeaconUtils: () => BeaconUtils,
     CASBeacon: () => CASBeacon,
     CASBeaconError: () => CASBeaconError,
+    CHANGE_OUTPUT_VBYTES: () => CHANGE_OUTPUT_VBYTES,
     COHORT_ADVERT: () => COHORT_ADVERT,
     COHORT_OPT_IN: () => COHORT_OPT_IN,
     COHORT_OPT_IN_ACCEPT: () => COHORT_OPT_IN_ACCEPT,
@@ -93180,6 +93181,7 @@ a=end-of-candidates
     DEFAULT_ADVERT_REPEAT_INTERVAL_MS: () => DEFAULT_ADVERT_REPEAT_INTERVAL_MS,
     DEFAULT_BROADCAST_LOOKBACK_MS: () => DEFAULT_BROADCAST_LOOKBACK_MS,
     DEFAULT_CLOCK_SKEW_SEC: () => DEFAULT_CLOCK_SKEW_SEC,
+    DEFAULT_FEE_ESTIMATOR: () => DEFAULT_FEE_ESTIMATOR,
     DEFAULT_FUNDING_MODEL: () => DEFAULT_FUNDING_MODEL,
     DEFAULT_MAX_UPDATE_SIZE_BYTES: () => DEFAULT_MAX_UPDATE_SIZE_BYTES,
     DEFAULT_NONCE_LEN_BYTES: () => DEFAULT_NONCE_LEN_BYTES,
@@ -93187,6 +93189,7 @@ a=end-of-candidates
     DEFAULT_RECOVERY_SEQUENCE: () => DEFAULT_RECOVERY_SEQUENCE,
     DID_REGEX: () => DID_REGEX,
     DISTRIBUTE_AGGREGATED_DATA: () => DISTRIBUTE_AGGREGATED_DATA,
+    DUST_LIMIT_SATS: () => DUST_LIMIT_SATS2,
     DidBtcr2: () => DidBtcr2,
     DidCommTransport: () => DidCommTransport,
     DidDocument: () => DidDocument,
@@ -93243,6 +93246,7 @@ a=end-of-candidates
     TypedEventEmitter: () => TypedEventEmitter,
     Updater: () => Updater,
     VALIDATION_ACK: () => VALIDATION_ACK,
+    beaconTxVsize: () => beaconTxVsize,
     buildAggregationBeaconTx: () => buildAggregationBeaconTx,
     buildFallbackLeaf: () => buildFallbackLeaf,
     buildFallbackSpend: () => buildFallbackSpend,
@@ -93294,6 +93298,7 @@ a=end-of-candidates
     parseRequestAuth: () => parseRequestAuth,
     parseSseStream: () => parseSseStream,
     registerBeaconStrategy: () => registerBeaconStrategy,
+    resolveChangeAddress: () => resolveChangeAddress,
     resolveFallbackThreshold: () => resolveFallbackThreshold,
     reviveFromWire: () => reviveFromWire,
     signEnvelope: () => signEnvelope,
@@ -112455,6 +112460,30 @@ ${value2}`;
 
   // src/core/aggregation/runner/service-runner.ts
   init_shim();
+
+  // src/core/beacon/fee-estimator.ts
+  init_shim();
+  var StaticFeeEstimator = class {
+    satsPerVbyte;
+    /**
+     * @param satsPerVbyte Fee rate in satoshis per virtual byte. Default: 5 sat/vB.
+     */
+    constructor(satsPerVbyte = 5) {
+      if (satsPerVbyte < 0 || !Number.isFinite(satsPerVbyte)) {
+        throw new Error(`Invalid satsPerVbyte: ${satsPerVbyte}`);
+      }
+      this.satsPerVbyte = satsPerVbyte;
+    }
+    async estimateFee(vsize) {
+      if (vsize < 0 || !Number.isFinite(vsize)) {
+        throw new Error(`Invalid vsize: ${vsize}`);
+      }
+      return BigInt(Math.ceil(vsize * this.satsPerVbyte));
+    }
+  };
+  var DEFAULT_FEE_ESTIMATOR = new StaticFeeEstimator(5);
+
+  // src/core/aggregation/runner/service-runner.ts
   var DEFAULT_ADVERT_REPEAT_INTERVAL_MS = 6e4;
   var AggregationServiceRunner = class _AggregationServiceRunner extends TypedEventEmitter {
     /** Direct access to the underlying state machine for advanced use. */
@@ -112465,6 +112494,7 @@ ${value2}`;
     #onOptInReceived;
     #onReadyToFinalize;
     #onProvideTxData;
+    #feeEstimator;
     #cohortTtlMs;
     #phaseTimeoutMs;
     #advertRepeatIntervalMs;
@@ -112489,6 +112519,7 @@ ${value2}`;
         finalize: acceptedCount >= minRequired
       }));
       this.#onProvideTxData = options2.onProvideTxData;
+      this.#feeEstimator = options2.feeEstimator ?? DEFAULT_FEE_ESTIMATOR;
       this.#cohortTtlMs = options2.cohortTtlMs;
       this.#phaseTimeoutMs = options2.phaseTimeoutMs;
       this.#advertRepeatIntervalMs = options2.advertRepeatIntervalMs ?? DEFAULT_ADVERT_REPEAT_INTERVAL_MS;
@@ -112919,7 +112950,8 @@ ${value2}`;
           const txData = await this.#onProvideTxData({
             cohortId: ctx.cohortId,
             beaconAddress: cohort.beaconAddress,
-            signalBytes: cohort.signalBytes
+            signalBytes: cohort.signalBytes,
+            feeEstimator: this.#feeEstimator
           });
           const authMsgs = this.session.startSigning(ctx.cohortId, txData);
           const sessionId = this.session.getSigningSessionId(ctx.cohortId) ?? "";
@@ -113375,6 +113407,7 @@ ${value2}`;
         keys: options2.service.keys,
         config: { minParticipants: 1, network: options2.config.network, beaconType: options2.config.beaconType, recoveryKey, recoverySequence, fundingModel: DEFAULT_FUNDING_MODEL },
         onProvideTxData: options2.onProvideTxData,
+        feeEstimator: options2.feeEstimator,
         cohortTtlMs: options2.cohortTtlMs,
         phaseTimeoutMs: options2.phaseTimeoutMs,
         // In-process bus with the participant already listening: a single advert
@@ -113430,29 +113463,7 @@ ${value2}`;
     }
   };
 
-  // src/core/beacon/fee-estimator.ts
-  init_shim();
-  var StaticFeeEstimator = class {
-    satsPerVbyte;
-    /**
-     * @param satsPerVbyte Fee rate in satoshis per virtual byte. Default: 5 sat/vB.
-     */
-    constructor(satsPerVbyte = 5) {
-      if (satsPerVbyte < 0 || !Number.isFinite(satsPerVbyte)) {
-        throw new Error(`Invalid satsPerVbyte: ${satsPerVbyte}`);
-      }
-      this.satsPerVbyte = satsPerVbyte;
-    }
-    async estimateFee(vsize) {
-      if (vsize < 0 || !Number.isFinite(vsize)) {
-        throw new Error(`Invalid vsize: ${vsize}`);
-      }
-      return BigInt(Math.ceil(vsize * this.satsPerVbyte));
-    }
-  };
-
   // src/core/beacon/beacon.ts
-  var DEFAULT_FEE_ESTIMATOR = new StaticFeeEstimator(5);
   var P2TR_BEACON_TX_VSIZE = 160;
   var P2WPKH_BEACON_TX_VSIZE = 155;
   var P2PKH_BEACON_TX_VSIZE = 240;
@@ -113461,6 +113472,20 @@ ${value2}`;
     p2wpkh: P2WPKH_BEACON_TX_VSIZE,
     p2tr: P2TR_BEACON_TX_VSIZE
   };
+  var CHANGE_OUTPUT_VBYTES = {
+    p2pkh: 34,
+    p2wpkh: 31,
+    p2tr: 43
+  };
+  var DUST_LIMIT_SATS2 = {
+    p2pkh: 546,
+    p2wpkh: 294,
+    p2tr: 330
+  };
+  function beaconTxVsize(beaconKind, changeKind) {
+    const base5 = SINGLETON_BEACON_TX_VSIZE[beaconKind] - CHANGE_OUTPUT_VBYTES[beaconKind];
+    return base5 + CHANGE_OUTPUT_VBYTES[changeKind];
+  }
   function detectSingletonScriptKind(bitcoinAddress, network) {
     const decoded = Address(network).decode(bitcoinAddress);
     if (decoded.type === "pkh") return "p2pkh";
@@ -113477,6 +113502,26 @@ ${value2}`;
     if (kind === "p2wpkh") return p2wpkh(pubkey, network).address;
     return p2tr(pubkey.slice(1, 33), void 0, network).address;
   }
+  function resolveChangeAddress(beaconAddress, network, changeAddress) {
+    if (!changeAddress || changeAddress === beaconAddress) return beaconAddress;
+    try {
+      Address(network).decode(changeAddress);
+    } catch {
+      throw new BeaconError(
+        `Invalid change address "${changeAddress}" for network "${network}".`,
+        "INVALID_CHANGE_ADDRESS",
+        { changeAddress, network }
+      );
+    }
+    return changeAddress;
+  }
+  function changeOutputKind(changeAddress, network) {
+    try {
+      return detectSingletonScriptKind(changeAddress, network);
+    } catch {
+      return "p2tr";
+    }
+  }
   function opReturnScript(signalBytes) {
     return Script.encode(["RETURN", signalBytes]);
   }
@@ -113503,8 +113548,10 @@ ${value2}`;
   async function buildAggregationBeaconTx(opts) {
     const feeEstimator = opts.feeEstimator ?? DEFAULT_FEE_ESTIMATOR;
     const { utxo, prevTxBytes } = await fetchSpendableUtxo(opts.beaconAddress, opts.bitcoin);
+    const changeAddress = resolveChangeAddress(opts.beaconAddress, opts.network, opts.changeAddress);
     const witnessScript = OutScript.encode(Address(opts.network).decode(opts.beaconAddress));
-    const feeSats = await feeEstimator.estimateFee(P2TR_BEACON_TX_VSIZE);
+    const changeKind = changeOutputKind(changeAddress, opts.network);
+    const feeSats = await feeEstimator.estimateFee(beaconTxVsize("p2tr", changeKind));
     if (BigInt(utxo.value) <= feeSats) {
       throw new BeaconError(
         `UTXO value (${utxo.value}) insufficient to cover fee (${feeSats}).`,
@@ -113520,13 +113567,17 @@ ${value2}`;
       witnessUtxo: { amount: BigInt(utxo.value), script: witnessScript },
       tapInternalKey: opts.internalPubkey
     });
-    tx.addOutputAddress(opts.beaconAddress, BigInt(utxo.value) - feeSats, opts.network);
+    const changeValue = BigInt(utxo.value) - feeSats;
+    if (changeValue >= BigInt(DUST_LIMIT_SATS2[changeKind])) {
+      tx.addOutputAddress(changeAddress, changeValue, opts.network);
+    }
     tx.addOutput({ script: opReturnScript(opts.signalBytes), amount: 0n });
     return {
       tx,
       prevOutScripts: [witnessScript],
       prevOutValues: [BigInt(utxo.value)],
       beaconAddress: opts.beaconAddress,
+      changeAddress,
       utxo,
       feeSats,
       scriptKind: "p2tr"
@@ -113604,7 +113655,8 @@ ${value2}`;
         prevTxBytes,
         signer,
         bitcoin,
-        feeEstimator
+        feeEstimator,
+        changeAddress: options2?.changeAddress
       });
       const signedHex = await this.signSinglePartyTx(plan, signer);
       return this.broadcastRawTx(bitcoin, signedHex);
@@ -113616,13 +113668,15 @@ ${value2}`;
      * the input accordingly. Validates that the signer's pubkey produces the beacon
      * address under that script kind: without this check, a misconfigured caller
      * would burn a real UTXO on a tx that fails at broadcast. Fees are computed from
-     * the per-kind {@link SINGLETON_BEACON_TX_VSIZE} constant, avoiding any probe-sign
-     * round-trip.
+     * the per-kind {@link SINGLETON_BEACON_TX_VSIZE} constant (via {@link beaconTxVsize}),
+     * avoiding any probe-sign round-trip; a change address of a different kind re-sizes
+     * the fee by the change output's size delta so it stays a valid upper bound.
      */
     async buildSinglePartyTx(opts) {
       const network = opts.bitcoin.data;
       const pubkey = opts.signer.publicKey;
       const kind = detectSingletonScriptKind(opts.beaconAddress, network);
+      const changeAddress = resolveChangeAddress(opts.beaconAddress, network, opts.changeAddress);
       const derivedAddress = deriveSingletonAddress(kind, pubkey, network);
       if (derivedAddress !== opts.beaconAddress) {
         throw new BeaconError(
@@ -113631,7 +113685,8 @@ ${value2}`;
           { kind, address: opts.beaconAddress, derivedAddress }
         );
       }
-      const feeSats = await opts.feeEstimator.estimateFee(SINGLETON_BEACON_TX_VSIZE[kind]);
+      const changeKind = changeOutputKind(changeAddress, network);
+      const feeSats = await opts.feeEstimator.estimateFee(beaconTxVsize(kind, changeKind));
       const amount = BigInt(opts.utxo.value);
       if (amount <= feeSats) {
         throw new BeaconError(
@@ -113668,13 +113723,17 @@ ${value2}`;
           tapInternalKey: internalKey
         });
       }
-      tx.addOutputAddress(opts.beaconAddress, amount - feeSats, network);
+      const changeValue = amount - feeSats;
+      if (changeValue >= BigInt(DUST_LIMIT_SATS2[changeKind])) {
+        tx.addOutputAddress(changeAddress, changeValue, network);
+      }
       tx.addOutput({ script: opReturnScript(opts.signalBytes), amount: 0n });
       return {
         tx,
         prevOutScripts: [prevOutScript],
         prevOutValues: [amount],
         beaconAddress: opts.beaconAddress,
+        changeAddress,
         utxo: opts.utxo,
         feeSats,
         scriptKind: kind

package/dist/browser.mjs

@@ -112295,6 +112295,30 @@ init_shim();
 
 // src/core/aggregation/runner/service-runner.ts
 init_shim();
+
+// src/core/beacon/fee-estimator.ts
+init_shim();
+var StaticFeeEstimator = class {
+  satsPerVbyte;
+  /**
+   * @param satsPerVbyte Fee rate in satoshis per virtual byte. Default: 5 sat/vB.
+   */
+  constructor(satsPerVbyte = 5) {
+    if (satsPerVbyte < 0 || !Number.isFinite(satsPerVbyte)) {
+      throw new Error(`Invalid satsPerVbyte: ${satsPerVbyte}`);
+    }
+    this.satsPerVbyte = satsPerVbyte;
+  }
+  async estimateFee(vsize) {
+    if (vsize < 0 || !Number.isFinite(vsize)) {
+      throw new Error(`Invalid vsize: ${vsize}`);
+    }
+    return BigInt(Math.ceil(vsize * this.satsPerVbyte));
+  }
+};
+var DEFAULT_FEE_ESTIMATOR = new StaticFeeEstimator(5);
+
+// src/core/aggregation/runner/service-runner.ts
 var DEFAULT_ADVERT_REPEAT_INTERVAL_MS = 6e4;
 var AggregationServiceRunner = class _AggregationServiceRunner extends TypedEventEmitter {
   /** Direct access to the underlying state machine for advanced use. */
@@ -112305,6 +112329,7 @@ var AggregationServiceRunner = class _AggregationServiceRunner extends TypedEven
   #onOptInReceived;
   #onReadyToFinalize;
   #onProvideTxData;
+  #feeEstimator;
   #cohortTtlMs;
   #phaseTimeoutMs;
   #advertRepeatIntervalMs;
@@ -112329,6 +112354,7 @@ var AggregationServiceRunner = class _AggregationServiceRunner extends TypedEven
       finalize: acceptedCount >= minRequired
     }));
     this.#onProvideTxData = options2.onProvideTxData;
+    this.#feeEstimator = options2.feeEstimator ?? DEFAULT_FEE_ESTIMATOR;
     this.#cohortTtlMs = options2.cohortTtlMs;
     this.#phaseTimeoutMs = options2.phaseTimeoutMs;
     this.#advertRepeatIntervalMs = options2.advertRepeatIntervalMs ?? DEFAULT_ADVERT_REPEAT_INTERVAL_MS;
@@ -112759,7 +112785,8 @@ var AggregationServiceRunner = class _AggregationServiceRunner extends TypedEven
         const txData = await this.#onProvideTxData({
           cohortId: ctx.cohortId,
           beaconAddress: cohort.beaconAddress,
-          signalBytes: cohort.signalBytes
+          signalBytes: cohort.signalBytes,
+          feeEstimator: this.#feeEstimator
         });
         const authMsgs = this.session.startSigning(ctx.cohortId, txData);
         const sessionId = this.session.getSigningSessionId(ctx.cohortId) ?? "";
@@ -113215,6 +113242,7 @@ var AggregationRunner = class {
       keys: options2.service.keys,
       config: { minParticipants: 1, network: options2.config.network, beaconType: options2.config.beaconType, recoveryKey, recoverySequence, fundingModel: DEFAULT_FUNDING_MODEL },
       onProvideTxData: options2.onProvideTxData,
+      feeEstimator: options2.feeEstimator,
       cohortTtlMs: options2.cohortTtlMs,
       phaseTimeoutMs: options2.phaseTimeoutMs,
       // In-process bus with the participant already listening: a single advert
@@ -113270,29 +113298,7 @@ var SMTBeaconError = class extends MethodError {
   }
 };
 
-// src/core/beacon/fee-estimator.ts
-init_shim();
-var StaticFeeEstimator = class {
-  satsPerVbyte;
-  /**
-   * @param satsPerVbyte Fee rate in satoshis per virtual byte. Default: 5 sat/vB.
-   */
-  constructor(satsPerVbyte = 5) {
-    if (satsPerVbyte < 0 || !Number.isFinite(satsPerVbyte)) {
-      throw new Error(`Invalid satsPerVbyte: ${satsPerVbyte}`);
-    }
-    this.satsPerVbyte = satsPerVbyte;
-  }
-  async estimateFee(vsize) {
-    if (vsize < 0 || !Number.isFinite(vsize)) {
-      throw new Error(`Invalid vsize: ${vsize}`);
-    }
-    return BigInt(Math.ceil(vsize * this.satsPerVbyte));
-  }
-};
-
 // src/core/beacon/beacon.ts
-var DEFAULT_FEE_ESTIMATOR = new StaticFeeEstimator(5);
 var P2TR_BEACON_TX_VSIZE = 160;
 var P2WPKH_BEACON_TX_VSIZE = 155;
 var P2PKH_BEACON_TX_VSIZE = 240;
@@ -113301,6 +113307,20 @@ var SINGLETON_BEACON_TX_VSIZE = {
   p2wpkh: P2WPKH_BEACON_TX_VSIZE,
   p2tr: P2TR_BEACON_TX_VSIZE
 };
+var CHANGE_OUTPUT_VBYTES = {
+  p2pkh: 34,
+  p2wpkh: 31,
+  p2tr: 43
+};
+var DUST_LIMIT_SATS2 = {
+  p2pkh: 546,
+  p2wpkh: 294,
+  p2tr: 330
+};
+function beaconTxVsize(beaconKind, changeKind) {
+  const base5 = SINGLETON_BEACON_TX_VSIZE[beaconKind] - CHANGE_OUTPUT_VBYTES[beaconKind];
+  return base5 + CHANGE_OUTPUT_VBYTES[changeKind];
+}
 function detectSingletonScriptKind(bitcoinAddress, network) {
   const decoded = Address(network).decode(bitcoinAddress);
   if (decoded.type === "pkh") return "p2pkh";
@@ -113317,6 +113337,26 @@ function deriveSingletonAddress(kind, pubkey, network) {
   if (kind === "p2wpkh") return p2wpkh(pubkey, network).address;
   return p2tr(pubkey.slice(1, 33), void 0, network).address;
 }
+function resolveChangeAddress(beaconAddress, network, changeAddress) {
+  if (!changeAddress || changeAddress === beaconAddress) return beaconAddress;
+  try {
+    Address(network).decode(changeAddress);
+  } catch {
+    throw new BeaconError(
+      `Invalid change address "${changeAddress}" for network "${network}".`,
+      "INVALID_CHANGE_ADDRESS",
+      { changeAddress, network }
+    );
+  }
+  return changeAddress;
+}
+function changeOutputKind(changeAddress, network) {
+  try {
+    return detectSingletonScriptKind(changeAddress, network);
+  } catch {
+    return "p2tr";
+  }
+}
 function opReturnScript(signalBytes) {
   return Script.encode(["RETURN", signalBytes]);
 }
@@ -113343,8 +113383,10 @@ async function fetchSpendableUtxo(bitcoinAddress, bitcoin) {
 async function buildAggregationBeaconTx(opts) {
   const feeEstimator = opts.feeEstimator ?? DEFAULT_FEE_ESTIMATOR;
   const { utxo, prevTxBytes } = await fetchSpendableUtxo(opts.beaconAddress, opts.bitcoin);
+  const changeAddress = resolveChangeAddress(opts.beaconAddress, opts.network, opts.changeAddress);
   const witnessScript = OutScript.encode(Address(opts.network).decode(opts.beaconAddress));
-  const feeSats = await feeEstimator.estimateFee(P2TR_BEACON_TX_VSIZE);
+  const changeKind = changeOutputKind(changeAddress, opts.network);
+  const feeSats = await feeEstimator.estimateFee(beaconTxVsize("p2tr", changeKind));
   if (BigInt(utxo.value) <= feeSats) {
     throw new BeaconError(
       `UTXO value (${utxo.value}) insufficient to cover fee (${feeSats}).`,
@@ -113360,13 +113402,17 @@ async function buildAggregationBeaconTx(opts) {
     witnessUtxo: { amount: BigInt(utxo.value), script: witnessScript },
     tapInternalKey: opts.internalPubkey
   });
-  tx.addOutputAddress(opts.beaconAddress, BigInt(utxo.value) - feeSats, opts.network);
+  const changeValue = BigInt(utxo.value) - feeSats;
+  if (changeValue >= BigInt(DUST_LIMIT_SATS2[changeKind])) {
+    tx.addOutputAddress(changeAddress, changeValue, opts.network);
+  }
   tx.addOutput({ script: opReturnScript(opts.signalBytes), amount: 0n });
   return {
     tx,
     prevOutScripts: [witnessScript],
     prevOutValues: [BigInt(utxo.value)],
     beaconAddress: opts.beaconAddress,
+    changeAddress,
     utxo,
     feeSats,
     scriptKind: "p2tr"
@@ -113444,7 +113490,8 @@ var SinglePartyBeacon = class {
       prevTxBytes,
       signer,
       bitcoin,
-      feeEstimator
+      feeEstimator,
+      changeAddress: options2?.changeAddress
     });
     const signedHex = await this.signSinglePartyTx(plan, signer);
     return this.broadcastRawTx(bitcoin, signedHex);
@@ -113456,13 +113503,15 @@ var SinglePartyBeacon = class {
    * the input accordingly. Validates that the signer's pubkey produces the beacon
    * address under that script kind: without this check, a misconfigured caller
    * would burn a real UTXO on a tx that fails at broadcast. Fees are computed from
-   * the per-kind {@link SINGLETON_BEACON_TX_VSIZE} constant, avoiding any probe-sign
-   * round-trip.
+   * the per-kind {@link SINGLETON_BEACON_TX_VSIZE} constant (via {@link beaconTxVsize}),
+   * avoiding any probe-sign round-trip; a change address of a different kind re-sizes
+   * the fee by the change output's size delta so it stays a valid upper bound.
    */
   async buildSinglePartyTx(opts) {
     const network = opts.bitcoin.data;
     const pubkey = opts.signer.publicKey;
     const kind = detectSingletonScriptKind(opts.beaconAddress, network);
+    const changeAddress = resolveChangeAddress(opts.beaconAddress, network, opts.changeAddress);
     const derivedAddress = deriveSingletonAddress(kind, pubkey, network);
     if (derivedAddress !== opts.beaconAddress) {
       throw new BeaconError(
@@ -113471,7 +113520,8 @@ var SinglePartyBeacon = class {
         { kind, address: opts.beaconAddress, derivedAddress }
       );
     }
-    const feeSats = await opts.feeEstimator.estimateFee(SINGLETON_BEACON_TX_VSIZE[kind]);
+    const changeKind = changeOutputKind(changeAddress, network);
+    const feeSats = await opts.feeEstimator.estimateFee(beaconTxVsize(kind, changeKind));
     const amount = BigInt(opts.utxo.value);
     if (amount <= feeSats) {
       throw new BeaconError(
@@ -113508,13 +113558,17 @@ var SinglePartyBeacon = class {
         tapInternalKey: internalKey
       });
     }
-    tx.addOutputAddress(opts.beaconAddress, amount - feeSats, network);
+    const changeValue = amount - feeSats;
+    if (changeValue >= BigInt(DUST_LIMIT_SATS2[changeKind])) {
+      tx.addOutputAddress(changeAddress, changeValue, network);
+    }
     tx.addOutput({ script: opReturnScript(opts.signalBytes), amount: 0n });
     return {
       tx,
       prevOutScripts: [prevOutScript],
       prevOutValues: [amount],
       beaconAddress: opts.beaconAddress,
+      changeAddress,
       utxo: opts.utxo,
       feeSats,
       scriptKind: kind
@@ -130247,6 +130301,7 @@ export {
   BeaconUtils,
   CASBeacon,
   CASBeaconError,
+  CHANGE_OUTPUT_VBYTES,
   COHORT_ADVERT,
   COHORT_OPT_IN,
   COHORT_OPT_IN_ACCEPT,
@@ -130255,6 +130310,7 @@ export {
   DEFAULT_ADVERT_REPEAT_INTERVAL_MS,
   DEFAULT_BROADCAST_LOOKBACK_MS,
   DEFAULT_CLOCK_SKEW_SEC,
+  DEFAULT_FEE_ESTIMATOR,
   DEFAULT_FUNDING_MODEL,
   DEFAULT_MAX_UPDATE_SIZE_BYTES,
   DEFAULT_NONCE_LEN_BYTES,
@@ -130262,6 +130318,7 @@ export {
   DEFAULT_RECOVERY_SEQUENCE,
   DID_REGEX,
   DISTRIBUTE_AGGREGATED_DATA,
+  DUST_LIMIT_SATS2 as DUST_LIMIT_SATS,
   DidBtcr2,
   DidCommTransport,
   DidDocument,
@@ -130318,6 +130375,7 @@ export {
   TypedEventEmitter,
   Updater,
   VALIDATION_ACK,
+  beaconTxVsize,
   buildAggregationBeaconTx,
   buildFallbackLeaf,
   buildFallbackSpend,
@@ -130369,6 +130427,7 @@ export {
   parseRequestAuth,
   parseSseStream,
   registerBeaconStrategy,
+  resolveChangeAddress,
   resolveFallbackThreshold,
   reviveFromWire,
   signEnvelope,