/* * This file is part of the Flowee project * Copyright (C) 2009-2010 Satoshi Nakamoto * Copyright (C) 2009-2015 The Bitcoin Core developers * Copyright (C) 2019-2021 Tom Zander * * This program 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. * * This program 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 this program. If not, see . */ /** * Why base-58 instead of standard base-64 encoding? * - Don't want 0OIl characters that look the same in some fonts and * could be used to create visually identical looking data. * - A string with non-alphanumeric characters is not as easily accepted as input. * - E-mail usually won't line-break if there's no punctuation to break at. * - Double-clicking selects the whole string as one word if it's all alphanumeric. */ #ifndef FLOWEE_BASE58_H #define FLOWEE_BASE58_H #include #include class uint160; class CKey; /** * Encode a byte sequence as a base58-encoded string. * pbegin and pend cannot be NULL, unless both are. */ std::string EncodeBase58(const unsigned char* pbegin, const unsigned char* pend); /** * Encode a byte vector as a base58-encoded string */ std::string EncodeBase58(const std::vector& vch); /** * Decode a base58-encoded string (psz) into a byte vector (vchRet). * return true if decoding is successful. * psz cannot be NULL. */ bool DecodeBase58(const char* psz, std::vector& vchRet); /** * Decode a base58-encoded string (str) into a byte vector (vchRet). * return true if decoding is successful. */ bool DecodeBase58(const std::string& str, std::vector& vchRet); /** * Encode a byte vector into a base58-encoded string, including checksum */ std::string EncodeBase58Check(const std::vector& vchIn); /** * Decode a base58-encoded string (psz) that includes a checksum into a byte * vector (vchRet), return true if decoding is successful */ bool DecodeBase58Check(const char* psz, std::vector& vchRet); /** * Decode a base58-encoded string (str) that includes a checksum into a byte * vector (vchRet), return true if decoding is successful */ bool DecodeBase58Check(const std::string& str, std::vector& vchRet); /** * Base class for all base58-encoded data */ class CBase58Data { public: CBase58Data(); bool SetString(const char* psz, unsigned int nVersionBytes = 1); bool SetString(const std::string& str); std::string ToString() const; int CompareTo(const CBase58Data& b58) const; bool operator==(const CBase58Data& b58) const { return CompareTo(b58) == 0; } bool operator<=(const CBase58Data& b58) const { return CompareTo(b58) <= 0; } bool operator>=(const CBase58Data& b58) const { return CompareTo(b58) >= 0; } bool operator< (const CBase58Data& b58) const { return CompareTo(b58) < 0; } bool operator> (const CBase58Data& b58) const { return CompareTo(b58) > 0; } bool isMainnetPkh() const; bool isMainnetSh() const; bool isMainnetPrivKey() const; /** * Returns true if this is testnet public-key-hash encoded data. * Notice that this is all of the following networks: * testnet3, testnet4, scalenet and regtest. */ bool isTestnetPkh() const; /** * Returns true if this is testnet p2sh encoded data. * Notice that this is all of the following networks: * testnet3, testnet4, scalenet and regtest. */ bool isTestnetSh() const; /** * Returns true if this is a testnet private key. * Notice that this is all of the following networks: * testnet3, testnet4, scalenet and regtest. */ bool isTestnetPrivKey() const; inline const std::vector &data() const { return vchData; } /// \deprecated use setData() instead void SetData(const std::vector &vchVersionIn, const void* pdata, size_t nSize); enum KeyType { PubkeyType, ScriptType }; enum Chain { Mainnet, Testnet ///< Various testnets and scalenet are eligable here. }; /// Set an address to be encoded. void setData(const uint160 &key, KeyType type, Chain chain); #ifndef NPRIVKEY /// Set a private key to be encoded. void setData(const CKey &key, Chain chain); #endif protected: //! the version byte(s) std::vector vchVersion; //! the actually encoded data std::vector vchData; void SetData(const std::vector &vchVersionIn, const unsigned char *pbegin, const unsigned char *pend); }; #endif