mirror of
https://github.com/Xahau/xahaud.git
synced 2026-06-04 01:06:37 +00:00
6de5de02cb
A bridge connects two blockchains: a locking chain and an issuing chain (also called a mainchain and a sidechain). Both are independent ledgers, with their own validators and potentially their own custom transactions. Importantly, there is a way to move assets from the locking chain to the issuing chain and a way to return those assets from the issuing chain back to the locking chain: the bridge. This key operation is called a cross-chain transfer. A cross-chain transfer is not a single transaction. It happens on two chains, requires multiple transactions, and involves an additional server type called a "witness". A bridge does not exchange assets between two ledgers. Instead, it locks assets on one ledger (the "locking chain") and represents those assets with wrapped assets on another chain (the "issuing chain"). A good model to keep in mind is a box with an infinite supply of wrapped assets. Putting an asset from the locking chain into the box will release a wrapped asset onto the issuing chain. Putting a wrapped asset from the issuing chain back into the box will release one of the existing locking chain assets back onto the locking chain. There is no other way to get assets into or out of the box. Note that there is no way for the box to "run out of" wrapped assets - it has an infinite supply. Co-authored-by: Gregory Popovitch <greg7mdp@gmail.com>
132 lines
3.3 KiB
C++
132 lines
3.3 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 <ripple/protocol/Issue.h>
|
|
|
|
#include <ripple/json/json_errors.h>
|
|
#include <ripple/protocol/AccountID.h>
|
|
#include <ripple/protocol/UintTypes.h>
|
|
#include <ripple/protocol/jss.h>
|
|
|
|
namespace ripple {
|
|
|
|
std::string
|
|
Issue::getText() const
|
|
{
|
|
std::string ret;
|
|
|
|
ret.reserve(64);
|
|
ret = to_string(currency);
|
|
|
|
if (!isXRP(currency))
|
|
{
|
|
ret += "/";
|
|
|
|
if (isXRP(account))
|
|
ret += "0";
|
|
else if (account == noAccount())
|
|
ret += "1";
|
|
else
|
|
ret += to_string(account);
|
|
}
|
|
|
|
return ret;
|
|
}
|
|
|
|
bool
|
|
isConsistent(Issue const& ac)
|
|
{
|
|
return isXRP(ac.currency) == isXRP(ac.account);
|
|
}
|
|
|
|
std::string
|
|
to_string(Issue const& ac)
|
|
{
|
|
if (isXRP(ac.account))
|
|
return to_string(ac.currency);
|
|
|
|
return to_string(ac.account) + "/" + to_string(ac.currency);
|
|
}
|
|
|
|
Json::Value
|
|
to_json(Issue const& is)
|
|
{
|
|
Json::Value jv;
|
|
jv[jss::currency] = to_string(is.currency);
|
|
if (!isXRP(is.currency))
|
|
jv[jss::issuer] = toBase58(is.account);
|
|
return jv;
|
|
}
|
|
|
|
Issue
|
|
issueFromJson(Json::Value const& v)
|
|
{
|
|
if (!v.isObject())
|
|
{
|
|
Throw<std::runtime_error>(
|
|
"issueFromJson can only be specified with an 'object' Json value");
|
|
}
|
|
|
|
Json::Value const curStr = v[jss::currency];
|
|
Json::Value const issStr = v[jss::issuer];
|
|
|
|
if (!curStr.isString())
|
|
{
|
|
Throw<Json::error>(
|
|
"issueFromJson currency must be a string Json value");
|
|
}
|
|
|
|
auto const currency = to_currency(curStr.asString());
|
|
if (currency == badCurrency() || currency == noCurrency())
|
|
{
|
|
Throw<Json::error>("issueFromJson currency must be a valid currency");
|
|
}
|
|
|
|
if (isXRP(currency))
|
|
{
|
|
if (!issStr.isNull())
|
|
{
|
|
Throw<Json::error>("Issue, XRP should not have issuer");
|
|
}
|
|
return xrpIssue();
|
|
}
|
|
|
|
if (!issStr.isString())
|
|
{
|
|
Throw<Json::error>("issueFromJson issuer must be a string Json value");
|
|
}
|
|
auto const issuer = parseBase58<AccountID>(issStr.asString());
|
|
|
|
if (!issuer)
|
|
{
|
|
Throw<Json::error>("issueFromJson issuer must be a valid account");
|
|
}
|
|
|
|
return Issue{currency, *issuer};
|
|
}
|
|
|
|
std::ostream&
|
|
operator<<(std::ostream& os, Issue const& x)
|
|
{
|
|
os << to_string(x);
|
|
return os;
|
|
}
|
|
|
|
} // namespace ripple
|