You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
107 lines
4.4 KiB
107 lines
4.4 KiB
/*
|
|
This file is part of cpp-ethereum.
|
|
|
|
cpp-ethereum is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
cpp-ethereum is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with cpp-ethereum. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
/** @file ICAP.h
|
|
* @author Gav Wood <i@gavwood.com>
|
|
* @date 2014
|
|
*
|
|
* Ethereum-specific data structures & algorithms.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <string>
|
|
#include <functional>
|
|
#include <boost/algorithm/string/case_conv.hpp>
|
|
#include <libdevcore/Common.h>
|
|
#include <libdevcore/Exceptions.h>
|
|
#include <libdevcore/FixedHash.h>
|
|
#include "Common.h"
|
|
|
|
namespace dev
|
|
{
|
|
namespace eth
|
|
{
|
|
|
|
struct InvalidICAP: virtual public dev::Exception {};
|
|
|
|
static const std::string EmptyString;
|
|
|
|
/**
|
|
* @brief Encapsulation of an ICAP address.
|
|
* Can be encoded, decoded, looked-up and inspected.
|
|
*/
|
|
class ICAP
|
|
{
|
|
public:
|
|
/// Construct null ICAP object.
|
|
ICAP() = default;
|
|
/// Construct a direct ICAP object for given target address. Must have a zero first byte.
|
|
ICAP(Address const& _target): m_type(Direct), m_direct(_target) {}
|
|
/// Construct an indirect ICAP object for given target name.
|
|
ICAP(std::string const& _target): m_type(Indirect), m_client(boost::algorithm::to_upper_copy(_target)), m_asset("ETH") {}
|
|
/// Construct an indirect ICAP object for given client and institution names.
|
|
ICAP(std::string const& _client, std::string const& _inst): m_type(Indirect), m_client(boost::algorithm::to_upper_copy(_client)), m_institution(boost::algorithm::to_upper_copy(_inst)), m_asset("XET") {}
|
|
/// Construct an indirect ICAP object for given client, institution and asset names. You generally don't want to use this.
|
|
ICAP(std::string const& _c, std::string const& _i, std::string const& _a): m_type(Indirect), m_client(boost::algorithm::to_upper_copy(_c)), m_institution(boost::algorithm::to_upper_copy(_i)), m_asset(boost::algorithm::to_upper_copy(_a)) {}
|
|
|
|
/// Type of ICAP address.
|
|
enum Type
|
|
{
|
|
Invalid,
|
|
Direct,
|
|
Indirect
|
|
};
|
|
|
|
/// @returns IBAN encoding of client and data.
|
|
static std::string iban(std::string _c, std::string _d);
|
|
/// @returns Client and data from given IBAN address.
|
|
static std::pair<std::string, std::string> fromIBAN(std::string _iban);
|
|
|
|
/// @returns the ICAP object for the ICAP address given.
|
|
static ICAP decoded(std::string const& _encoded);
|
|
|
|
/// @returns the encoded ICAP address.
|
|
std::string encoded() const;
|
|
/// @returns type of ICAP.
|
|
Type type() const { return m_type; }
|
|
/// @returns target address. Only valid when type() == Direct.
|
|
Address const& direct() const { return m_type == Direct ? m_direct : ZeroAddress; }
|
|
/// @returns asset. Only valid when type() == Indirect.
|
|
std::string const& asset() const { return m_type == Indirect ? m_asset : EmptyString; }
|
|
/// @returns target name. Only valid when type() == Indirect and asset() == "ETH".
|
|
std::string const& target() const { return m_type == Indirect && m_asset == "ETH" ? m_client : EmptyString; }
|
|
/// @returns institution name. Only valid when type() == Indirect and asset() == "XET".
|
|
std::string const& institution() const { return m_type == Indirect && m_asset == "XET" ? m_institution : EmptyString; }
|
|
/// @returns client name. Only valid when type() == Indirect and asset() == "XET".
|
|
std::string const& client() const { return m_type == Indirect && m_asset == "XET" ? m_client : EmptyString; }
|
|
/// @returns target address. Always valid, but requires the Registry address and a function to make calls.
|
|
std::pair<Address, bytes> address(std::function<bytes(Address, bytes)> const& _call, Address const& _reg) const { return m_type == Direct ? make_pair(direct(), bytes()) : m_type == Indirect ? lookup(_call, _reg) : make_pair(Address(), bytes()); }
|
|
|
|
/// @returns target address. Looks up through the given Registry and call function. Only valid when type() == Indirect.
|
|
std::pair<Address, bytes> lookup(std::function<bytes(Address, bytes)> const& _call, Address const& _reg) const;
|
|
|
|
private:
|
|
Type m_type = Invalid;
|
|
Address m_direct;
|
|
std::string m_client;
|
|
std::string m_institution;
|
|
std::string m_asset;
|
|
};
|
|
|
|
|
|
}
|
|
}
|
|
|