1 // Copyright (c) 2009-2010 Satoshi Nakamoto
2 // Copyright (c) 2009-2012 The Bitcoin Developers
3 // Copyright (c) 2011-2012 The PPCoin developers
4 // Distributed under the MIT/X11 software license, see the accompanying
5 // file COPYING or http://www.opensource.org/licenses/mit-license.php.
9 // Why base-58 instead of standard base-64 encoding?
10 // - Don't want 0OIl characters that look the same in some fonts and
11 // could be used to create visually identical looking account numbers.
12 // - A string with non-alphanumeric characters is not as easily accepted as an account number.
13 // - E-mail usually won't line-break if there's no punctuation to break at.
14 // - Doubleclicking selects the whole number as one word if it's all alphanumeric.
16 #ifndef BITCOIN_BASE58_H
17 #define BITCOIN_BASE58_H
24 static const char* pszBase58 = "123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz";
26 // Encode a byte sequence as a base58-encoded string
27 inline std::string EncodeBase58(const unsigned char* pbegin, const unsigned char* pend)
33 // Convert big endian data to little endian
34 // Extra zero at the end make sure bignum will interpret as a positive number
35 std::vector<unsigned char> vchTmp(pend-pbegin+1, 0);
36 reverse_copy(pbegin, pend, vchTmp.begin());
38 // Convert little endian data to bignum
42 // Convert bignum to std::string
44 // Expected size increase from base58 conversion is approximately 137%
45 // use 138% to be safe
46 str.reserve((pend - pbegin) * 138 / 100 + 1);
51 if (!BN_div(&dv, &rem, &bn, &bn58, pctx))
52 throw bignum_error("EncodeBase58 : BN_div failed");
54 unsigned int c = rem.getulong();
58 // Leading zeroes encoded as base58 zeros
59 for (const unsigned char* p = pbegin; p < pend && *p == 0; p++)
62 // Convert little endian std::string to big endian
63 reverse(str.begin(), str.end());
67 // Encode a byte vector as a base58-encoded string
68 inline std::string EncodeBase58(const std::vector<unsigned char>& vch)
70 return EncodeBase58(&vch[0], &vch[0] + vch.size());
73 // Decode a base58-encoded string psz into byte vector vchRet
74 // returns true if decoding is succesful
75 inline bool DecodeBase58(const char* psz, std::vector<unsigned char>& vchRet)
85 // Convert big endian string to bignum
86 for (const char* p = psz; *p; p++)
88 const char* p1 = strchr(pszBase58, *p);
97 bnChar.setulong(p1 - pszBase58);
98 if (!BN_mul(&bn, &bn, &bn58, pctx))
99 throw bignum_error("DecodeBase58 : BN_mul failed");
103 // Get bignum as little endian data
104 std::vector<unsigned char> vchTmp = bn.getvch();
106 // Trim off sign byte if present
107 if (vchTmp.size() >= 2 && vchTmp.end()[-1] == 0 && vchTmp.end()[-2] >= 0x80)
108 vchTmp.erase(vchTmp.end()-1);
110 // Restore leading zeros
111 int nLeadingZeros = 0;
112 for (const char* p = psz; *p == pszBase58[0]; p++)
114 vchRet.assign(nLeadingZeros + vchTmp.size(), 0);
116 // Convert little endian data to big endian
117 reverse_copy(vchTmp.begin(), vchTmp.end(), vchRet.end() - vchTmp.size());
121 // Decode a base58-encoded string str into byte vector vchRet
122 // returns true if decoding is succesful
123 inline bool DecodeBase58(const std::string& str, std::vector<unsigned char>& vchRet)
125 return DecodeBase58(str.c_str(), vchRet);
131 // Encode a byte vector to a base58-encoded string, including checksum
132 inline std::string EncodeBase58Check(const std::vector<unsigned char>& vchIn)
134 // add 4-byte hash check to the end
135 std::vector<unsigned char> vch(vchIn);
136 uint256 hash = Hash(vch.begin(), vch.end());
137 vch.insert(vch.end(), (unsigned char*)&hash, (unsigned char*)&hash + 4);
138 return EncodeBase58(vch);
141 // Decode a base58-encoded string psz that includes a checksum, into byte vector vchRet
142 // returns true if decoding is succesful
143 inline bool DecodeBase58Check(const char* psz, std::vector<unsigned char>& vchRet)
145 if (!DecodeBase58(psz, vchRet))
147 if (vchRet.size() < 4)
152 uint256 hash = Hash(vchRet.begin(), vchRet.end()-4);
153 if (memcmp(&hash, &vchRet.end()[-4], 4) != 0)
158 vchRet.resize(vchRet.size()-4);
162 // Decode a base58-encoded string str that includes a checksum, into byte vector vchRet
163 // returns true if decoding is succesful
164 inline bool DecodeBase58Check(const std::string& str, std::vector<unsigned char>& vchRet)
166 return DecodeBase58Check(str.c_str(), vchRet);
173 /** Base class for all base58-encoded data */
178 unsigned char nVersion;
180 // the actually encoded data
181 std::vector<unsigned char> vchData;
191 // zero the memory, as it may contain sensitive data
192 if (!vchData.empty())
193 memset(&vchData[0], 0, vchData.size());
196 void SetData(int nVersionIn, const void* pdata, size_t nSize)
198 nVersion = nVersionIn;
199 vchData.resize(nSize);
200 if (!vchData.empty())
201 memcpy(&vchData[0], pdata, nSize);
204 void SetData(int nVersionIn, const unsigned char *pbegin, const unsigned char *pend)
206 SetData(nVersionIn, (void*)pbegin, pend - pbegin);
210 bool SetString(const char* psz)
212 std::vector<unsigned char> vchTemp;
213 DecodeBase58Check(psz, vchTemp);
220 nVersion = vchTemp[0];
221 vchData.resize(vchTemp.size() - 1);
222 if (!vchData.empty())
223 memcpy(&vchData[0], &vchTemp[1], vchData.size());
224 memset(&vchTemp[0], 0, vchTemp.size());
228 bool SetString(const std::string& str)
230 return SetString(str.c_str());
233 std::string ToString() const
235 std::vector<unsigned char> vch(1, nVersion);
236 vch.insert(vch.end(), vchData.begin(), vchData.end());
237 return EncodeBase58Check(vch);
240 int CompareTo(const CBase58Data& b58) const
242 if (nVersion < b58.nVersion) return -1;
243 if (nVersion > b58.nVersion) return 1;
244 if (vchData < b58.vchData) return -1;
245 if (vchData > b58.vchData) return 1;
249 bool operator==(const CBase58Data& b58) const { return CompareTo(b58) == 0; }
250 bool operator<=(const CBase58Data& b58) const { return CompareTo(b58) <= 0; }
251 bool operator>=(const CBase58Data& b58) const { return CompareTo(b58) >= 0; }
252 bool operator< (const CBase58Data& b58) const { return CompareTo(b58) < 0; }
253 bool operator> (const CBase58Data& b58) const { return CompareTo(b58) > 0; }
256 /** base58-encoded bitcoin addresses.
257 * Public-key-hash-addresses have version 55 (or 111 testnet).
258 * The data vector contains RIPEMD160(SHA256(pubkey)), where pubkey is the serialized public key.
259 * Script-hash-addresses have version 57 (or 196 testnet).
260 * The data vector contains RIPEMD160(SHA256(cscript)), where cscript is the serialized redemption script.
262 class CBitcoinAddress : public CBase58Data
267 PUBKEY_ADDRESS = 55, // ppcoin: addresses begin with 'P'
268 SCRIPT_ADDRESS = 57, // ppcoin: addresses begin with 'Q'
269 PUBKEY_ADDRESS_TEST = 111,
270 SCRIPT_ADDRESS_TEST = 196,
273 bool SetHash160(const uint160& hash160)
275 SetData(fTestNet ? PUBKEY_ADDRESS_TEST : PUBKEY_ADDRESS, &hash160, 20);
279 void SetPubKey(const std::vector<unsigned char>& vchPubKey)
281 SetHash160(Hash160(vchPubKey));
284 bool SetScriptHash160(const uint160& hash160)
286 SetData(fTestNet ? SCRIPT_ADDRESS_TEST : SCRIPT_ADDRESS, &hash160, 20);
292 unsigned int nExpectedSize = 20;
293 bool fExpectTestNet = false;
297 nExpectedSize = 20; // Hash of public key
298 fExpectTestNet = false;
301 nExpectedSize = 20; // Hash of CScript
302 fExpectTestNet = false;
305 case PUBKEY_ADDRESS_TEST:
307 fExpectTestNet = true;
309 case SCRIPT_ADDRESS_TEST:
311 fExpectTestNet = true;
317 return fExpectTestNet == fTestNet && vchData.size() == nExpectedSize;
319 bool IsScript() const
324 return nVersion == SCRIPT_ADDRESS_TEST;
325 return nVersion == SCRIPT_ADDRESS;
332 CBitcoinAddress(uint160 hash160In)
334 SetHash160(hash160In);
337 CBitcoinAddress(const std::vector<unsigned char>& vchPubKey)
339 SetPubKey(vchPubKey);
342 CBitcoinAddress(const std::string& strAddress)
344 SetString(strAddress);
347 CBitcoinAddress(const char* pszAddress)
349 SetString(pszAddress);
352 uint160 GetHash160() const
354 assert(vchData.size() == 20);
356 memcpy(&hash160, &vchData[0], 20);
361 /** A base58-encoded secret key */
362 class CBitcoinSecret : public CBase58Data
365 void SetSecret(const CSecret& vchSecret, bool fCompressed)
367 assert(vchSecret.size() == 32);
368 SetData(fTestNet ? 239 : 128, &vchSecret[0], vchSecret.size());
370 vchData.push_back(1);
373 CSecret GetSecret(bool &fCompressedOut)
376 vchSecret.resize(32);
377 memcpy(&vchSecret[0], &vchData[0], 32);
378 fCompressedOut = vchData.size() == 33;
384 bool fExpectTestNet = false;
391 fExpectTestNet = true;
397 return fExpectTestNet == fTestNet && (vchData.size() == 32 || (vchData.size() == 33 && vchData[32] == 1));
400 bool SetString(const char* pszSecret)
402 return CBase58Data::SetString(pszSecret) && IsValid();
405 bool SetString(const std::string& strSecret)
407 return SetString(strSecret.c_str());
410 CBitcoinSecret(const CSecret& vchSecret, bool fCompressed)
412 SetSecret(vchSecret, fCompressed);