/root/bitcoin/src/common/messages.cpp

Source
// Copyright (c) 2009-2010 Satoshi Nakamoto
// Copyright (c) 2009-2022 The Bitcoin Core developers
// Distributed under the MIT software license, see the accompanying
// file COPYING or http://www.opensource.org/licenses/mit-license.php.

#include <common/messages.h>

#include <common/types.h>
#include <policy/fees.h>
#include <node/types.h>
#include <tinyformat.h>
#include <util/strencodings.h>
#include <util/string.h>
#include <util/translation.h>

#include <cassert>
#include <map>
#include <string>
#include <utility>
#include <vector>

using node::TransactionError;
using util::Join;

namespace common {
std::string StringForFeeReason(FeeReason reason)
{
    static const std::map<FeeReason, std::string> fee_reason_strings = {
        {FeeReason::NONE, "None"},
        {FeeReason::HALF_ESTIMATE, "Half Target 60% Threshold"},
        {FeeReason::FULL_ESTIMATE, "Target 85% Threshold"},
        {FeeReason::DOUBLE_ESTIMATE, "Double Target 95% Threshold"},
        {FeeReason::CONSERVATIVE, "Conservative Double Target longer horizon"},
        {FeeReason::MEMPOOL_MIN, "Mempool Min Fee"},
        {FeeReason::PAYTXFEE, "PayTxFee set"},
        {FeeReason::FALLBACK, "Fallback fee"},
        {FeeReason::REQUIRED, "Minimum Required Fee"},
    };
    auto reason_string = fee_reason_strings.find(reason);

    if (reason_string == fee_reason_strings.end()) return "Unknown";

    return reason_string->second;
}

const std::vector<std::pair<std::string, FeeEstimateMode>>& FeeModeMap()
{
    static const std::vector<std::pair<std::string, FeeEstimateMode>> FEE_MODES = {
        {"unset", FeeEstimateMode::UNSET},
        {"economical", FeeEstimateMode::ECONOMICAL},
        {"conservative", FeeEstimateMode::CONSERVATIVE},
    };
    return FEE_MODES;
}

std::string FeeModeInfo(const std::pair<std::string, FeeEstimateMode>& mode, std::string& default_info)
{
    switch (mode.second) {
        case FeeEstimateMode::UNSET:
            return strprintf("%s means no mode set (%s). \n", mode.first, default_info);
        case FeeEstimateMode::ECONOMICAL:
            return strprintf("%s estimates use a shorter time horizon, making them more\n"
                   "responsive to short-term drops in the prevailing fee market. This mode\n"
                   "potentially returns a lower fee rate estimate.\n", mode.first);
        case FeeEstimateMode::CONSERVATIVE:
            return strprintf("%s estimates use a longer time horizon, making them\n"
                   "less responsive to short-term drops in the prevailing fee market. This mode\n"
                   "potentially returns a higher fee rate estimate.\n", mode.first);
        default:
            // Other modes apart from the ones handled are fee rate units; they should not be clarified.
            assert(false);
    }
}

std::string FeeModesDetail(std::string default_info)
{
    std::string info;
    for (const auto& fee_mode : FeeModeMap()) {
        info += FeeModeInfo(fee_mode, default_info);
    }
    return strprintf("%s \n%s", FeeModes(", "), info);
}

std::string FeeModes(const std::string& delimiter)
{
    return Join(FeeModeMap(), delimiter, [&](const std::pair<std::string, FeeEstimateMode>& i) { return i.first; });
}

std::string InvalidEstimateModeErrorMessage()
{
    return "Invalid estimate_mode parameter, must be one of: \"" + FeeModes("\", \"") + "\"";
}

bool FeeModeFromString(const std::string& mode_string, FeeEstimateMode& fee_estimate_mode)
{
    auto searchkey = ToUpper(mode_string);
    for (const auto& pair : FeeModeMap()) {
        if (ToUpper(pair.first) == searchkey) {
            fee_estimate_mode = pair.second;
            return true;
        }
    }
    return false;
}

bilingual_str PSBTErrorString(PSBTError err)
{
    switch (err) {
        case PSBTError::MISSING_INPUTS:
            return Untranslated("Inputs missing or spent");
        case PSBTError::SIGHASH_MISMATCH:
            return Untranslated("Specified sighash value does not match value stored in PSBT");
        case PSBTError::EXTERNAL_SIGNER_NOT_FOUND:
            return Untranslated("External signer not found");
        case PSBTError::EXTERNAL_SIGNER_FAILED:
            return Untranslated("External signer failed to sign");
        case PSBTError::UNSUPPORTED:
            return Untranslated("Signer does not support PSBT");
        case PSBTError::INCOMPLETE:
            return Untranslated("Input needs additional signatures or other data");
        case PSBTError::OK:
            return Untranslated("No errors");
        // no default case, so the compiler can warn about missing cases
    }
    assert(false);
}

bilingual_str TransactionErrorString(const TransactionError err)
{
    switch (err) {
        case TransactionError::OK:
            return Untranslated("No error");
        case TransactionError::MISSING_INPUTS:
            return Untranslated("Inputs missing or spent");
        case TransactionError::ALREADY_IN_UTXO_SET:
            return Untranslated("Transaction outputs already in utxo set");
        case TransactionError::MEMPOOL_REJECTED:
            return Untranslated("Transaction rejected by mempool");
        case TransactionError::MEMPOOL_ERROR:
            return Untranslated("Mempool internal error");
        case TransactionError::MAX_FEE_EXCEEDED:
            return Untranslated("Fee exceeds maximum configured by user (e.g. -maxtxfee, maxfeerate)");
        case TransactionError::MAX_BURN_EXCEEDED:
            return Untranslated("Unspendable output exceeds maximum configured by user (maxburnamount)");
        case TransactionError::INVALID_PACKAGE:
            return Untranslated("Transaction rejected due to invalid package");
        // no default case, so the compiler can warn about missing cases
    }
    assert(false);
}

bilingual_str ResolveErrMsg(const std::string& optname, const std::string& strBind)
{
    return strprintf(_("Cannot resolve -%s address: '%s'"), optname, strBind);
}

bilingual_str InvalidPortErrMsg(const std::string& optname, const std::string& invalid_value)
{
    return strprintf(_("Invalid port specified in %s: '%s'"), optname, invalid_value);
}

bilingual_str AmountHighWarn(const std::string& optname)
{
    return strprintf(_("%s is set very high!"), optname);
}

bilingual_str AmountErrMsg(const std::string& optname, const std::string& strValue)
{
    return strprintf(_("Invalid amount for -%s=<amount>: '%s'"), optname, strValue);
}
} // namespace common

Line	Count	Source
1		// Copyright (c) 2009-2010 Satoshi Nakamoto
2		// Copyright (c) 2009-2022 The Bitcoin Core developers
3		// Distributed under the MIT software license, see the accompanying
4		// file COPYING or http://www.opensource.org/licenses/mit-license.php.
5
6		#include <common/messages.h>
7
8		#include <common/types.h>
9		#include <policy/fees.h>
10		#include <node/types.h>
11		#include <tinyformat.h>
12		#include <util/strencodings.h>
13		#include <util/string.h>
14		#include <util/translation.h>
15
16		#include <cassert>
17		#include <map>
18		#include <string>
19		#include <utility>
20		#include <vector>
21
22		using node::TransactionError;
23		using util::Join;
24
25		namespace common {
26		std::string StringForFeeReason(FeeReason reason)
27	103	{
28	103	static const std::map<FeeReason, std::string> fee_reason_strings = {
29	103	{FeeReason::NONE, "None"},
30	103	{FeeReason::HALF_ESTIMATE, "Half Target 60% Threshold"},
31	103	{FeeReason::FULL_ESTIMATE, "Target 85% Threshold"},
32	103	{FeeReason::DOUBLE_ESTIMATE, "Double Target 95% Threshold"},
33	103	{FeeReason::CONSERVATIVE, "Conservative Double Target longer horizon"},
34	103	{FeeReason::MEMPOOL_MIN, "Mempool Min Fee"},
35	103	{FeeReason::PAYTXFEE, "PayTxFee set"},
36	103	{FeeReason::FALLBACK, "Fallback fee"},
37	103	{FeeReason::REQUIRED, "Minimum Required Fee"},
38	103	};
39	103	auto reason_string = fee_reason_strings.find(reason);
40
41	103	if (reason_string == fee_reason_strings.end()) return "Unknown";
42
43	103	return reason_string->second;
44	103	}
45
46		const std::vector<std::pair<std::string, FeeEstimateMode>>& FeeModeMap()
47	650	{
48	650	static const std::vector<std::pair<std::string, FeeEstimateMode>> FEE_MODES = {
49	650	{"unset", FeeEstimateMode::UNSET},
50	650	{"economical", FeeEstimateMode::ECONOMICAL},
51	650	{"conservative", FeeEstimateMode::CONSERVATIVE},
52	650	};
53	650	return FEE_MODES;
54	650	}
55
56		std::string FeeModeInfo(const std::pair<std::string, FeeEstimateMode>& mode, std::string& default_info)
57	30	{
58	30	switch (mode.second) {
59	10	case FeeEstimateMode::UNSET:
60	10	return strprintf("%s means no mode set (%s). \n", mode.first, default_info);
61	10	case FeeEstimateMode::ECONOMICAL:
62	10	return strprintf("%s estimates use a shorter time horizon, making them more\n"
63	10	"responsive to short-term drops in the prevailing fee market. This mode\n"
64	10	"potentially returns a lower fee rate estimate.\n", mode.first);
65	10	case FeeEstimateMode::CONSERVATIVE:
66	10	return strprintf("%s estimates use a longer time horizon, making them\n"
67	10	"less responsive to short-term drops in the prevailing fee market. This mode\n"
68	10	"potentially returns a higher fee rate estimate.\n", mode.first);
69	0	default:
70		// Other modes apart from the ones handled are fee rate units; they should not be clarified.
71	0	assert(false);
72	30	}
73	30	}
74
75		std::string FeeModesDetail(std::string default_info)
76	10	{
77	10	std::string info;
78	30	for (const auto& fee_mode : FeeModeMap()) {
79	30	info += FeeModeInfo(fee_mode, default_info);
80	30	}
81	10	return strprintf("%s \n%s", FeeModes(", "), info);
82	10	}
83
84		std::string FeeModes(const std::string& delimiter)
85	10	{
86	30	return Join(FeeModeMap(), delimiter, [&](const std::pair<std::string, FeeEstimateMode>& i) { return i.first; });
87	10	}
88
89		std::string InvalidEstimateModeErrorMessage()
90	0	{
91	0	return "Invalid estimate_mode parameter, must be one of: \"" + FeeModes("\", \"") + "\"";
92	0	}
93
94		bool FeeModeFromString(const std::string& mode_string, FeeEstimateMode& fee_estimate_mode)
95	630	{
96	630	auto searchkey = ToUpper(mode_string);
97	1.88k	for (const auto& pair : FeeModeMap()) {
98	1.88k	if (ToUpper(pair.first) == searchkey) {
99	3	fee_estimate_mode = pair.second;
100	3	return true;
101	3	}
102	1.88k	}
103	627	return false;
104	630	}
105
106		bilingual_str PSBTErrorString(PSBTError err)
107	6	{
108	6	switch (err) {
109	0	case PSBTError::MISSING_INPUTS:
110	0	return Untranslated("Inputs missing or spent");
111	6	case PSBTError::SIGHASH_MISMATCH:
112	6	return Untranslated("Specified sighash value does not match value stored in PSBT");
113	0	case PSBTError::EXTERNAL_SIGNER_NOT_FOUND:
114	0	return Untranslated("External signer not found");
115	0	case PSBTError::EXTERNAL_SIGNER_FAILED:
116	0	return Untranslated("External signer failed to sign");
117	0	case PSBTError::UNSUPPORTED:
118	0	return Untranslated("Signer does not support PSBT");
119	0	case PSBTError::INCOMPLETE:
120	0	return Untranslated("Input needs additional signatures or other data");
121	0	case PSBTError::OK:
122	0	return Untranslated("No errors");
123		// no default case, so the compiler can warn about missing cases
124	6	}
125	6	assert(false);
126	0	}
127
128		bilingual_str TransactionErrorString(const TransactionError err)
129	79	{
130	79	switch (err) {
131	0	case TransactionError::OK:
132	0	return Untranslated("No error");
133	16	case TransactionError::MISSING_INPUTS:
134	16	return Untranslated("Inputs missing or spent");
135	14	case TransactionError::ALREADY_IN_UTXO_SET:
136	14	return Untranslated("Transaction outputs already in utxo set");
137	12	case TransactionError::MEMPOOL_REJECTED:
138	12	return Untranslated("Transaction rejected by mempool");
139	14	case TransactionError::MEMPOOL_ERROR:
140	14	return Untranslated("Mempool internal error");
141	10	case TransactionError::MAX_FEE_EXCEEDED:
142	10	return Untranslated("Fee exceeds maximum configured by user (e.g. -maxtxfee, maxfeerate)");
143	13	case TransactionError::MAX_BURN_EXCEEDED:
144	13	return Untranslated("Unspendable output exceeds maximum configured by user (maxburnamount)");
145	0	case TransactionError::INVALID_PACKAGE:
146	0	return Untranslated("Transaction rejected due to invalid package");
147		// no default case, so the compiler can warn about missing cases
148	79	}
149	79	assert(false);
150	0	}
151
152		bilingual_str ResolveErrMsg(const std::string& optname, const std::string& strBind)
153	837	{
154	837	return strprintf(_("Cannot resolve -%s address: '%s'"), optname, strBind);
155	837	}
156
157		bilingual_str InvalidPortErrMsg(const std::string& optname, const std::string& invalid_value)
158	0	{
159	0	return strprintf(_("Invalid port specified in %s: '%s'"), optname, invalid_value);
160	0	}
161
162		bilingual_str AmountHighWarn(const std::string& optname)
163	630	{
164	630	return strprintf(_("%s is set very high!"), optname);
165	630	}
166
167		bilingual_str AmountErrMsg(const std::string& optname, const std::string& strValue)
168	630	{
169	630	return strprintf(_("Invalid amount for -%s=<amount>: '%s'"), optname, strValue);
170	630	}
171		} // namespace common

Coverage Report

Created: 2025-09-08 17:06