1 // Copyright (c) 2009-2010 Satoshi Nakamoto
2 // Copyright (c) 2009-2012 The Bitcoin developers
3 // Distributed under the MIT/X11 software license, see the accompanying
4 // file COPYING or http://www.opensource.org/licenses/mit-license.php.
5 #ifndef BITCOIN_KEYSTORE_H
6 #define BITCOIN_KEYSTORE_H
10 #include <boost/signals2/signal.hpp>
11 #include <boost/variant.hpp>
15 class CNoDestination {
17 friend bool operator==(const CNoDestination &a, const CNoDestination &b) { return true; }
18 friend bool operator<(const CNoDestination &a, const CNoDestination &b) { return true; }
21 /** A txout script template with a specific destination. It is either:
22 * CNoDestination: no destination set
23 * CKeyID: TX_PUBKEYHASH destination
24 * CScriptID: TX_SCRIPTHASH destination
26 * A CTxDestination is the internal data type encoded in a CBitcoinAddress.
28 typedef boost::variant<CNoDestination, CKeyID, CScriptID> CTxDestination;
30 /** A virtual base class for key stores */
34 mutable CCriticalSection cs_KeyStore;
37 virtual ~CKeyStore() {}
39 // Add a key to the store.
40 virtual bool AddKey(const CKey& key) =0;
42 // Add a malleable key to store.
43 virtual bool AddMalleableKey(const CMalleableKey& mKey) =0;
44 virtual bool GetMalleableKey(const CMalleableKeyView &keyView, CMalleableKey &mKey) const =0;
46 // Check whether a key corresponding to a given address is present in the store.
47 virtual bool HaveKey(const CKeyID &address) const =0;
48 virtual bool GetKey(const CKeyID &address, CKey& keyOut) const =0;
49 virtual void GetKeys(std::set<CKeyID> &setAddress) const =0;
50 virtual bool GetPubKey(const CKeyID &address, CPubKey& vchPubKeyOut) const;
52 // Support for BIP 0013 : see https://en.bitcoin.it/wiki/BIP_0013
53 virtual bool AddCScript(const CScript& redeemScript) =0;
54 virtual bool HaveCScript(const CScriptID &hash) const =0;
55 virtual bool GetCScript(const CScriptID &hash, CScript& redeemScriptOut) const =0;
57 // Support for Watch-only addresses
58 virtual bool AddWatchOnly(const CScript &dest) =0;
59 virtual bool RemoveWatchOnly(const CScript &dest) =0;
60 virtual bool HaveWatchOnly(const CScript &dest) const =0;
61 virtual bool HaveWatchOnly() const =0;
63 virtual bool GetSecret(const CKeyID &address, CSecret& vchSecret, bool &fCompressed) const
66 if (!GetKey(address, key))
68 vchSecret = key.GetSecret(fCompressed);
72 virtual bool CheckOwnership(const CPubKey &pubKeyVariant, const CPubKey &R) const =0;
73 virtual bool CreatePrivKey(const CPubKey &pubKeyVariant, const CPubKey &R, CKey &privKey) const =0;
74 virtual void ListMalleableViews(std::list<CMalleableKeyView> &malleableViewList) const =0;
77 typedef std::map<CKeyID, std::pair<CSecret, bool> > KeyMap;
78 typedef std::map<CScriptID, CScript > ScriptMap;
79 typedef std::set<CScript> WatchOnlySet;
80 typedef std::map<CMalleableKeyView, CMalleableKey> MalleableKeyMap;
82 /** Basic key store, that keeps keys in an address->secret map */
83 class CBasicKeyStore : public CKeyStore
87 MalleableKeyMap mapMalleableKeys;
90 WatchOnlySet setWatchOnly;
93 bool AddKey(const CKey& key);
94 bool AddMalleableKey(const CMalleableKey& mKey);
95 bool GetMalleableKey(const CMalleableKeyView &keyView, CMalleableKey &mKey) const
99 MalleableKeyMap::const_iterator mi = mapMalleableKeys.find(keyView);
100 if (mi != mapMalleableKeys.end())
109 bool HaveKey(const CKeyID &address) const
114 result = (mapKeys.count(address) > 0);
118 void GetKeys(std::set<CKeyID> &setAddress) const
123 KeyMap::const_iterator mi = mapKeys.begin();
124 while (mi != mapKeys.end())
126 setAddress.insert((*mi).first);
131 bool GetKey(const CKeyID &address, CKey &keyOut) const
135 KeyMap::const_iterator mi = mapKeys.find(address);
136 if (mi != mapKeys.end())
139 keyOut.SetSecret((*mi).second.first, (*mi).second.second);
145 virtual bool AddCScript(const CScript& redeemScript);
146 virtual bool HaveCScript(const CScriptID &hash) const;
147 virtual bool GetCScript(const CScriptID &hash, CScript& redeemScriptOut) const;
149 virtual bool AddWatchOnly(const CScript &dest);
150 virtual bool RemoveWatchOnly(const CScript &dest);
151 virtual bool HaveWatchOnly(const CScript &dest) const;
152 virtual bool HaveWatchOnly() const;
154 bool CheckOwnership(const CPubKey &pubKeyVariant, const CPubKey &R) const
158 for (MalleableKeyMap::const_iterator mi = mapMalleableKeys.begin(); mi != mapMalleableKeys.end(); mi++)
160 if (mi->first.CheckKeyVariant(R, pubKeyVariant))
167 bool CreatePrivKey(const CPubKey &pubKeyVariant, const CPubKey &R, CKey &privKey) const
171 for (MalleableKeyMap::const_iterator mi = mapMalleableKeys.begin(); mi != mapMalleableKeys.end(); mi++)
173 if (mi->second.CheckKeyVariant(R, pubKeyVariant, privKey))
180 void ListMalleableViews(std::list<CMalleableKeyView> &malleableViewList) const
182 malleableViewList.clear();
186 for (MalleableKeyMap::const_iterator mi = mapMalleableKeys.begin(); mi != mapMalleableKeys.end(); mi++)
187 malleableViewList.push_back(CMalleableKeyView(mi->first));
192 typedef std::map<CKeyID, std::pair<CPubKey, std::vector<unsigned char> > > CryptedKeyMap;
194 /** Keystore which keeps the private keys encrypted.
195 * It derives from the basic key store, which is used if no encryption is active.
197 class CCryptoKeyStore : public CBasicKeyStore
200 CryptedKeyMap mapCryptedKeys;
202 CKeyingMaterial vMasterKey;
204 // if fUseCrypto is true, mapKeys must be empty
205 // if fUseCrypto is false, vMasterKey must be empty
211 // will encrypt previously unencrypted keys
212 bool EncryptKeys(CKeyingMaterial& vMasterKeyIn);
213 bool DecryptKeys(const CKeyingMaterial& vMasterKeyIn);
215 bool Unlock(const CKeyingMaterial& vMasterKeyIn);
218 CCryptoKeyStore() : fUseCrypto(false) { }
220 bool IsCrypted() const
225 bool IsLocked() const
232 result = vMasterKey.empty();
239 virtual bool AddCryptedKey(const CPubKey &vchPubKey, const std::vector<unsigned char> &vchCryptedSecret);
240 bool AddKey(const CKey& key);
241 bool HaveKey(const CKeyID &address) const
246 return CBasicKeyStore::HaveKey(address);
247 return mapCryptedKeys.count(address) > 0;
250 bool GetKey(const CKeyID &address, CKey& keyOut) const;
251 bool GetPubKey(const CKeyID &address, CPubKey& vchPubKeyOut) const;
252 void GetKeys(std::set<CKeyID> &setAddress) const
256 CBasicKeyStore::GetKeys(setAddress);
260 CryptedKeyMap::const_iterator mi = mapCryptedKeys.begin();
261 while (mi != mapCryptedKeys.end())
263 setAddress.insert((*mi).first);
268 /* Wallet status (encrypted, locked) changed.
269 * Note: Called without locks held.
271 boost::signals2::signal<void (CCryptoKeyStore* wallet)> NotifyStatusChanged;