mirror of
https://github.com/Xahau/xahaud.git
synced 2025-12-06 17:27:52 +00:00
d4a56f223a
Payment channels permit off-ledger checkpoints of XRP payments flowing in a single direction. A channel sequesters the owner's XRP in its own ledger entry. The owner can authorize the recipient to claim up to a give balance by giving the receiver a signed message (off-ledger). The recipient can use this signed message to claim any unpaid balance while the channel remains open. The owner can top off the line as needed. If the channel has not paid out all its funds, the owner must wait out a delay to close the channel to give the recipient a chance to supply any claims. The recipient can close the channel at any time. Any transaction that touches the channel after the expiration time will close the channel. The total amount paid increases monotonically as newer claims are issued. When the channel is closed any remaining balance is returned to the owner. Channels are intended to permit intermittent off-ledger settlement of ILP trust lines as balances get substantial. For bidirectional channels, a payment channel can be used in each direction.
192 lines
9.4 KiB
C++
192 lines
9.4 KiB
C++
//------------------------------------------------------------------------------
|
|
/*
|
|
This file is part of rippled: https://github.com/ripple/rippled
|
|
Copyright (c) 2012, 2013 Ripple Labs Inc.
|
|
|
|
Permission to use, copy, modify, and/or distribute this software for any
|
|
purpose with or without fee is hereby granted, provided that the above
|
|
copyright notice and this permission notice appear in all copies.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
|
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
|
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
|
|
ANY SPECIAL , DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
|
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
|
|
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
|
|
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
|
*/
|
|
//==============================================================================
|
|
|
|
#include <BeastConfig.h>
|
|
#include <ripple/basics/contract.h>
|
|
#include <ripple/protocol/ErrorCodes.h>
|
|
#include <cassert>
|
|
#include <unordered_map>
|
|
#include <utility>
|
|
|
|
namespace std {
|
|
|
|
template <>
|
|
struct hash <ripple::error_code_i>
|
|
{
|
|
std::size_t operator() (ripple::error_code_i value) const
|
|
{
|
|
return value;
|
|
}
|
|
};
|
|
|
|
}
|
|
namespace ripple {
|
|
namespace RPC {
|
|
|
|
namespace detail {
|
|
|
|
class ErrorCategory
|
|
{
|
|
public:
|
|
using Map = std::unordered_map <error_code_i, ErrorInfo>;
|
|
|
|
ErrorCategory ()
|
|
: m_unknown (rpcUNKNOWN, "unknown", "An unknown error code.")
|
|
{
|
|
add (rpcACT_BITCOIN, "actBitcoin", "Account is bitcoin address.");
|
|
add (rpcACT_EXISTS, "actExists", "Account already exists.");
|
|
add (rpcACT_MALFORMED, "actMalformed", "Account malformed.");
|
|
add (rpcACT_NOT_FOUND, "actNotFound", "Account not found.");
|
|
add (rpcATX_DEPRECATED, "deprecated", "Use the new API or specify a ledger range.");
|
|
add (rpcBAD_BLOB, "badBlob", "Blob must be a non-empty hex string.");
|
|
add (rpcBAD_FEATURE, "badFeature", "Feature unknown or invalid.");
|
|
add (rpcBAD_ISSUER, "badIssuer", "Issuer account malformed.");
|
|
add (rpcBAD_MARKET, "badMarket", "No such market.");
|
|
add (rpcBAD_SECRET, "badSecret", "Secret does not match account.");
|
|
add (rpcBAD_SEED, "badSeed", "Disallowed seed.");
|
|
add (rpcBAD_SYNTAX, "badSyntax", "Syntax error.");
|
|
add (rpcCHANNEL_MALFORMED, "channelMalformed", "Payment channel is malformed.");
|
|
add (rpcCHANNEL_AMT_MALFORMED, "channelAmtMalformed","Payment channel amount is malformed.");
|
|
add (rpcCOMMAND_MISSING, "commandMissing", "Missing command entry.");
|
|
add (rpcDST_ACT_MALFORMED, "dstActMalformed", "Destination account is malformed.");
|
|
add (rpcDST_ACT_MISSING, "dstActMissing", "Destination account does not exist.");
|
|
add (rpcDST_AMT_MALFORMED, "dstAmtMalformed", "Destination amount/currency/issuer is malformed.");
|
|
add (rpcDST_ISR_MALFORMED, "dstIsrMalformed", "Destination issuer is malformed.");
|
|
add (rpcFORBIDDEN, "forbidden", "Bad credentials.");
|
|
add (rpcGENERAL, "general", "Generic error reason.");
|
|
add (rpcGETS_ACT_MALFORMED, "getsActMalformed", "Gets account malformed.");
|
|
add (rpcGETS_AMT_MALFORMED, "getsAmtMalformed", "Gets amount malformed.");
|
|
add (rpcHIGH_FEE, "highFee", "Current transaction fee exceeds your limit.");
|
|
add (rpcHOST_IP_MALFORMED, "hostIpMalformed", "Host IP is malformed.");
|
|
add (rpcINSUF_FUNDS, "insufFunds", "Insufficient funds.");
|
|
add (rpcINTERNAL, "internal", "Internal error.");
|
|
add (rpcINVALID_PARAMS, "invalidParams", "Invalid parameters.");
|
|
add (rpcJSON_RPC, "json_rpc", "JSON-RPC transport error.");
|
|
add (rpcLGR_IDXS_INVALID, "lgrIdxsInvalid", "Ledger indexes invalid.");
|
|
add (rpcLGR_IDX_MALFORMED, "lgrIdxMalformed", "Ledger index malformed.");
|
|
add (rpcLGR_NOT_FOUND, "lgrNotFound", "Ledger not found.");
|
|
add (rpcLGR_NOT_VALIDATED, "lgrNotValidated", "Ledger not validated.");
|
|
add (rpcLOAD_FAILED, "loadFailed", "Load failed");
|
|
add (rpcMASTER_DISABLED, "masterDisabled", "Master key is disabled.");
|
|
add (rpcNOT_ENABLED, "notEnabled", "Not enabled in configuration.");
|
|
add (rpcNOT_IMPL, "notImpl", "Not implemented.");
|
|
add (rpcNOT_READY, "notReady", "Not ready to handle this request.");
|
|
add (rpcNOT_STANDALONE, "notStandAlone", "Operation valid in debug mode only.");
|
|
add (rpcNOT_SUPPORTED, "notSupported", "Operation not supported.");
|
|
add (rpcNO_ACCOUNT, "noAccount", "No such account.");
|
|
add (rpcNO_CLOSED, "noClosed", "Closed ledger is unavailable.");
|
|
add (rpcNO_CURRENT, "noCurrent", "Current ledger is unavailable.");
|
|
add (rpcNO_EVENTS, "noEvents", "Current transport does not support events.");
|
|
add (rpcNO_NETWORK, "noNetwork", "Not synced to Ripple network.");
|
|
add (rpcNO_PATH, "noPath", "Unable to find a ripple path.");
|
|
add (rpcNO_PERMISSION, "noPermission", "You don't have permission for this command.");
|
|
add (rpcNO_PF_REQUEST, "noPathRequest", "No pathfinding request in progress.");
|
|
add (rpcPASSWD_CHANGED, "passwdChanged", "Wrong key, password changed.");
|
|
add (rpcPAYS_ACT_MALFORMED, "paysActMalformed", "Pays account malformed.");
|
|
add (rpcPAYS_AMT_MALFORMED, "paysAmtMalformed", "Pays amount malformed.");
|
|
add (rpcPORT_MALFORMED, "portMalformed", "Port is malformed.");
|
|
add (rpcPUBLIC_MALFORMED, "publicMalformed", "Public key is malformed.");
|
|
add (rpcQUALITY_MALFORMED, "qualityMalformed", "Quality malformed.");
|
|
add (rpcSIGN_FOR_MALFORMED, "signForMalformed", "Signing for account is malformed.");
|
|
add (rpcSLOW_DOWN, "slowDown", "You are placing too much load on the server.");
|
|
add (rpcSRC_ACT_MALFORMED, "srcActMalformed", "Source account is malformed.");
|
|
add (rpcSRC_ACT_MISSING, "srcActMissing", "Source account not provided.");
|
|
add (rpcSRC_ACT_NOT_FOUND, "srcActNotFound", "Source account not found.");
|
|
add (rpcSRC_AMT_MALFORMED, "srcAmtMalformed", "Source amount/currency/issuer is malformed.");
|
|
add (rpcSRC_CUR_MALFORMED, "srcCurMalformed", "Source currency is malformed.");
|
|
add (rpcSRC_ISR_MALFORMED, "srcIsrMalformed", "Source issuer is malformed.");
|
|
add (rpcSRC_MISSING, "srcMissing", "Source is missing.");
|
|
add (rpcSRC_UNCLAIMED, "srcUnclaimed", "Source account is not claimed.");
|
|
add (rpcSTREAM_MALFORMED, "malformedStream", "Stream malformed.");
|
|
add (rpcTOO_BUSY, "tooBusy", "The server is too busy to help you now.");
|
|
add (rpcTXN_NOT_FOUND, "txnNotFound", "Transaction not found.");
|
|
add (rpcUNKNOWN_COMMAND, "unknownCmd", "Unknown method.");
|
|
add (rpcWRONG_SEED, "wrongSeed", "The regular key does not point as the master key.");
|
|
add (rpcSENDMAX_MALFORMED, "sendMaxMalformed", "SendMax amount malformed.");
|
|
}
|
|
|
|
ErrorInfo const& get (error_code_i code) const
|
|
{
|
|
Map::const_iterator const iter (m_map.find (code));
|
|
assert (iter != m_map.end());
|
|
if (iter != m_map.end())
|
|
return iter->second;
|
|
return m_unknown;
|
|
}
|
|
|
|
private:
|
|
void add (error_code_i code, std::string const& token,
|
|
std::string const& message)
|
|
{
|
|
std::pair <Map::iterator, bool> result (
|
|
m_map.emplace (std::piecewise_construct,
|
|
std::forward_as_tuple (code), std::forward_as_tuple (
|
|
code, token, message)));
|
|
if (! result.second)
|
|
Throw<std::invalid_argument> ("duplicate error code");
|
|
}
|
|
|
|
private:
|
|
Map m_map;
|
|
ErrorInfo m_unknown;
|
|
};
|
|
|
|
}
|
|
|
|
//------------------------------------------------------------------------------
|
|
|
|
ErrorInfo const& get_error_info (error_code_i code)
|
|
{
|
|
static detail::ErrorCategory category;
|
|
return category.get (code);
|
|
}
|
|
|
|
Json::Value make_error (error_code_i code)
|
|
{
|
|
Json::Value json;
|
|
inject_error (code, json);
|
|
return json;
|
|
}
|
|
|
|
Json::Value make_error (error_code_i code, std::string const& message)
|
|
{
|
|
Json::Value json;
|
|
inject_error (code, message, json);
|
|
return json;
|
|
}
|
|
|
|
bool contains_error (Json::Value const& json)
|
|
{
|
|
if (json.isObject() && json.isMember (jss::error))
|
|
return true;
|
|
return false;
|
|
}
|
|
|
|
} // RPC
|
|
|
|
std::string rpcErrorString(Json::Value const& jv)
|
|
{
|
|
assert(RPC::contains_error(jv));
|
|
return jv[jss::error].asString() +
|
|
jv[jss::error_message].asString();
|
|
}
|
|
|
|
} // ripple
|
|
|