@upcoming/bee-js 11.1.0 → 12.0.0

package/dist/cjs/bee.js

@@ -1757,6 +1757,22 @@ class Bee {
         const amount = (0, stamps_1.getAmountForDuration)(duration, chainState.currentPrice, this.network === 'gnosis' ? 5 : 15);
         return (0, stamps_1.getStampCost)(batch.depth, amount);
     }
+    /**
+     * Calculates the `amount` and expected duration extension for topping up a postage batch with a given BZZ value.
+     *
+     * @param postageBatchId
+     * @param bzz The amount of BZZ to spend on the top-up.
+     * @param requestOptions Options for making requests, such as timeouts, custom HTTP agents, headers, etc.
+     * @returns An object with `amount` (to pass to {@link topUpBatch}) and `duration` (the expected TTL extension).
+     */
+    async calculateTopUpForBzz(postageBatchId, bzz, requestOptions) {
+        const batch = await this.getPostageBatch(postageBatchId, requestOptions);
+        const chainState = await this.getChainState(requestOptions);
+        const blockTime = this.network === 'gnosis' ? 5 : 15;
+        const amount = bzz.toPLURBigInt() / 2n ** BigInt(batch.depth);
+        const duration = (0, stamps_1.getStampDuration)(amount, chainState.currentPrice, blockTime);
+        return { amount, duration };
+    }
     /**
      * Increases the duration of a postage batch by increasing its amount.
      *