From 6112cf20d43b0be34fe0edce2ac3e6b27cae1bbe Mon Sep 17 00:00:00 2001 From: Jon Atack Date: Tue, 10 Nov 2020 19:32:50 +0100 Subject: wallet: add CFeeRate ctor doxygen documentation as requested by reviewers --- src/policy/feerate.h | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) (limited to 'src/policy') diff --git a/src/policy/feerate.h b/src/policy/feerate.h index 883940f73c..0f2bff1909 100644 --- a/src/policy/feerate.h +++ b/src/policy/feerate.h @@ -39,7 +39,16 @@ public: // We've previously had bugs creep in from silent double->int conversion... static_assert(std::is_integral::value, "CFeeRate should be used without floats"); } - /** Constructor for a fee rate in satoshis per kB. The size in bytes must not exceed (2^63 - 1)*/ + /** Constructor for a fee rate in satoshis per kvB (sat/kvB). The size in bytes must not exceed (2^63 - 1). + * + * Passing an nBytes value of COIN (1e8) returns a fee rate in satoshis per vB (sat/vB), + * e.g. (nFeePaid * 1e8 / 1e3) == (nFeePaid / 1e5), + * where 1e5 is the ratio to convert from BTC/kvB to sat/vB. + * + * @param[in] nFeePaid CAmount fee rate to construct with + * @param[in] nBytes size_t bytes (units) to construct with + * @returns fee rate + */ CFeeRate(const CAmount& nFeePaid, size_t nBytes); /** * Return the fee in satoshis for the given size in bytes. -- cgit v1.2.3