Dogecoin Core  1.14.2
P2P Digital Currency
base58.h
Go to the documentation of this file.
1 // Copyright (c) 2009-2010 Satoshi Nakamoto
2 // Copyright (c) 2009-2015 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 
14 #ifndef BITCOIN_BASE58_H
15 #define BITCOIN_BASE58_H
16 
17 #include "chainparams.h"
18 #include "key.h"
19 #include "pubkey.h"
20 #include "script/script.h"
21 #include "script/standard.h"
23 
24 #include <string>
25 #include <vector>
26 
31 std::string EncodeBase58(const unsigned char* pbegin, const unsigned char* pend);
32 
36 std::string EncodeBase58(const std::vector<unsigned char>& vch);
37 
43 bool DecodeBase58(const char* psz, std::vector<unsigned char>& vchRet);
44 
49 bool DecodeBase58(const std::string& str, std::vector<unsigned char>& vchRet);
50 
54 std::string EncodeBase58Check(const std::vector<unsigned char>& vchIn);
55 
60 inline bool DecodeBase58Check(const char* psz, std::vector<unsigned char>& vchRet);
61 
66 inline bool DecodeBase58Check(const std::string& str, std::vector<unsigned char>& vchRet);
67 
72 {
73 protected:
75  std::vector<unsigned char> vchVersion;
76 
78  typedef std::vector<unsigned char, zero_after_free_allocator<unsigned char> > vector_uchar;
80 
81  CBase58Data();
82  void SetData(const std::vector<unsigned char> &vchVersionIn, const void* pdata, size_t nSize);
83  void SetData(const std::vector<unsigned char> &vchVersionIn, const unsigned char *pbegin, const unsigned char *pend);
84 
85 public:
86  bool SetString(const char* psz, unsigned int nVersionBytes = 1);
87  bool SetString(const std::string& str);
88  std::string ToString() const;
89  int CompareTo(const CBase58Data& b58) const;
90 
91  bool operator==(const CBase58Data& b58) const { return CompareTo(b58) == 0; }
92  bool operator<=(const CBase58Data& b58) const { return CompareTo(b58) <= 0; }
93  bool operator>=(const CBase58Data& b58) const { return CompareTo(b58) >= 0; }
94  bool operator< (const CBase58Data& b58) const { return CompareTo(b58) < 0; }
95  bool operator> (const CBase58Data& b58) const { return CompareTo(b58) > 0; }
96 };
97 
104 class CBitcoinAddress : public CBase58Data {
105 public:
106  bool Set(const CKeyID &id);
107  bool Set(const CScriptID &id);
108  bool Set(const CTxDestination &dest);
109  bool IsValid() const;
110  bool IsValid(const CChainParams &params) const;
111 
113  CBitcoinAddress(const CTxDestination &dest) { Set(dest); }
114  CBitcoinAddress(const std::string& strAddress) { SetString(strAddress); }
115  CBitcoinAddress(const char* pszAddress) { SetString(pszAddress); }
116 
117  CTxDestination Get() const;
118  bool GetKeyID(CKeyID &keyID) const;
119  bool IsScript() const;
120 };
121 
126 {
127 public:
128  void SetKey(const CKey& vchSecret);
129  CKey GetKey();
130  bool IsValid() const;
131  bool SetString(const char* pszSecret);
132  bool SetString(const std::string& strSecret);
133 
134  CBitcoinSecret(const CKey& vchSecret) { SetKey(vchSecret); }
136 };
137 
138 template<typename K, int Size, CChainParams::Base58Type Type> class CBitcoinExtKeyBase : public CBase58Data
139 {
140 public:
141  void SetKey(const K &key) {
142  unsigned char vch[Size];
143  key.Encode(vch);
144  SetData(Params().Base58Prefix(Type), vch, vch+Size);
145  }
146 
147  K GetKey() {
148  K ret;
149  if (vchData.size() == Size) {
150  // If base58 encoded data does not hold an ext key, return a !IsValid() key
151  ret.Decode(&vchData[0]);
152  }
153  return ret;
154  }
155 
156  CBitcoinExtKeyBase(const K &key) {
157  SetKey(key);
158  }
159 
160  CBitcoinExtKeyBase(const std::string& strBase58c) {
161  SetString(strBase58c.c_str(), Params().Base58Prefix(Type).size());
162  }
163 
165 };
166 
169 
170 #endif // BITCOIN_BASE58_H
bool DecodeBase58(const char *psz, std::vector< unsigned char > &vchRet)
Decode a base58-encoded string (psz) into a byte vector (vchRet).
Definition: base58.cpp:21
CBitcoinExtKeyBase< CExtPubKey, BIP32_EXTKEY_SIZE, CChainParams::EXT_PUBLIC_KEY > CBitcoinExtPubKey
Definition: base58.h:168
std::string EncodeBase58(const unsigned char *pbegin, const unsigned char *pend)
Why base-58 instead of standard base-64 encoding?
Definition: base58.cpp:71
std::string EncodeBase58Check(const std::vector< unsigned char > &vchIn)
Encode a byte vector into a base58-encoded string, including checksum.
Definition: base58.cpp:121
bool DecodeBase58Check(const char *psz, std::vector< unsigned char > &vchRet)
Decode a base58-encoded string (psz) that includes a checksum into a byte vector (vchRet),...
Definition: base58.cpp:130
CBitcoinExtKeyBase< CExtKey, BIP32_EXTKEY_SIZE, CChainParams::EXT_SECRET_KEY > CBitcoinExtKey
Definition: base58.h:167
const CChainParams & Params()
Return the currently selected parameters.
Base class for all base58-encoded data.
Definition: base58.h:72
bool operator>=(const CBase58Data &b58) const
Definition: base58.h:93
std::vector< unsigned char > vchVersion
the version byte(s)
Definition: base58.h:75
std::vector< unsigned char, zero_after_free_allocator< unsigned char > > vector_uchar
the actually encoded data
Definition: base58.h:78
bool operator<=(const CBase58Data &b58) const
Definition: base58.h:92
bool SetString(const char *psz, unsigned int nVersionBytes=1)
Definition: base58.cpp:171
bool operator==(const CBase58Data &b58) const
Definition: base58.h:91
bool operator<(const CBase58Data &b58) const
Definition: base58.h:94
bool operator>(const CBase58Data &b58) const
Definition: base58.h:95
std::string ToString() const
Definition: base58.cpp:193
int CompareTo(const CBase58Data &b58) const
Definition: base58.cpp:200
vector_uchar vchData
Definition: base58.h:79
void SetData(const std::vector< unsigned char > &vchVersionIn, const void *pdata, size_t nSize)
Definition: base58.cpp:158
base58-encoded Bitcoin addresses.
Definition: base58.h:104
CTxDestination Get() const
Definition: base58.cpp:260
CBitcoinAddress(const std::string &strAddress)
Definition: base58.h:114
CBitcoinAddress(const CTxDestination &dest)
Definition: base58.h:113
bool IsScript() const
Definition: base58.cpp:284
bool IsValid() const
Definition: base58.cpp:247
bool Set(const CKeyID &id)
Definition: base58.cpp:230
CBitcoinAddress(const char *pszAddress)
Definition: base58.h:115
bool GetKeyID(CKeyID &keyID) const
Definition: base58.cpp:274
CBitcoinExtKeyBase(const K &key)
Definition: base58.h:156
void SetKey(const K &key)
Definition: base58.h:141
CBitcoinExtKeyBase(const std::string &strBase58c)
Definition: base58.h:160
A base58-encoded secret key.
Definition: base58.h:126
CBitcoinSecret(const CKey &vchSecret)
Definition: base58.h:134
bool IsValid() const
Definition: base58.cpp:305
void SetKey(const CKey &vchSecret)
Definition: base58.cpp:289
CBitcoinSecret()
Definition: base58.h:135
CKey GetKey()
Definition: base58.cpp:297
bool SetString(const char *pszSecret)
Definition: base58.cpp:312
CChainParams defines various tweakable parameters of a given instance of the Bitcoin system.
Definition: chainparams.h:47
An encapsulated private key.
Definition: key.h:36
A reference to a CKey: the Hash160 of its serialized public key.
Definition: pubkey.h:30
A reference to a CScript: the Hash160 of its serialization (see script.h)
Definition: standard.h:23
boost::variant< CNoDestination, CKeyID, CScriptID > CTxDestination
A txout script template with a specific destination.
Definition: standard.h:71