src/script/standard.h

   1 // Copyright (c) 2009-2010 Satoshi Nakamoto
   2 // Copyright (c) 2009-2014 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
   6 #ifndef BITCOIN_SCRIPT_STANDARD_H
   7 #define BITCOIN_SCRIPT_STANDARD_H
   8
   9 #include "script/interpreter.h"
  10 #include "uint256.h"
  11
  12 #include <boost/variant.hpp>
  13
  14 #include <stdint.h>
  15
  16 class CKeyID;
  17 class CScript;
  18
  19 /** A reference to a CScript: the Hash160 of its serialization (see script.h) */
  20 class CScriptID : public uint160
  21 {
  22 public:
  23     CScriptID() : uint160() {}
  24     CScriptID(const CScript& in);
  25     CScriptID(const uint160& in) : uint160(in) {}
  26 };
  27
  28 static const unsigned int MAX_OP_RETURN_RELAY = 40;      //! bytes
  29 extern unsigned nMaxDatacarrierBytes;
  30
  31 /**
  32  * Mandatory script verification flags that all new blocks must comply with for
  33  * them to be valid. (but old blocks may not comply with) Currently just P2SH,
  34  * but in the future other flags may be added, such as a soft-fork to enforce
  35  * strict DER encoding.
  36  *
  37  * Failing one of these tests may trigger a DoS ban - see CheckInputs() for
  38  * details.
  39  */
  40 static const unsigned int MANDATORY_SCRIPT_VERIFY_FLAGS = SCRIPT_VERIFY_P2SH;
  41
  42 /**
  43  * Standard script verification flags that standard transactions will comply
  44  * with. However scripts violating these flags may still be present in valid
  45  * blocks and we must accept those blocks.
  46  */
  47 static const unsigned int STANDARD_SCRIPT_VERIFY_FLAGS = MANDATORY_SCRIPT_VERIFY_FLAGS |
  48                                                          SCRIPT_VERIFY_DERSIG |
  49                                                          SCRIPT_VERIFY_STRICTENC |
  50                                                          SCRIPT_VERIFY_MINIMALDATA |
  51                                                          SCRIPT_VERIFY_NULLDUMMY |
  52                                                          SCRIPT_VERIFY_DISCOURAGE_UPGRADABLE_NOPS |
  53                                                          SCRIPT_VERIFY_CLEANSTACK;
  54
  55 /** For convenience, standard but not mandatory verify flags. */
  56 static const unsigned int STANDARD_NOT_MANDATORY_VERIFY_FLAGS = STANDARD_SCRIPT_VERIFY_FLAGS & ~MANDATORY_SCRIPT_VERIFY_FLAGS;
  57
  58 enum txnouttype
  59 {
  60     TX_NONSTANDARD,
  61     // 'standard' transaction types:
  62     TX_PUBKEY,
  63     TX_PUBKEYHASH,
  64     TX_SCRIPTHASH,
  65     TX_MULTISIG,
  66     TX_NULL_DATA,
  67 };
  68
  69 class CNoDestination {
  70 public:
  71     friend bool operator==(const CNoDestination &a, const CNoDestination &b) { return true; }
  72     friend bool operator<(const CNoDestination &a, const CNoDestination &b) { return true; }
  73 };
  74
  75 /**
  76  * A txout script template with a specific destination. It is either:
  77  *  * CNoDestination: no destination set
  78  *  * CKeyID: TX_PUBKEYHASH destination
  79  *  * CScriptID: TX_SCRIPTHASH destination
  80  *  A CTxDestination is the internal data type encoded in a CBitcoinAddress
  81  */
  82 typedef boost::variant<CNoDestination, CKeyID, CScriptID> CTxDestination;
  83
  84 const char* GetTxnOutputType(txnouttype t);
  85
  86 bool Solver(const CScript& scriptPubKey, txnouttype& typeRet, std::vector<std::vector<unsigned char> >& vSolutionsRet);
  87 int ScriptSigArgsExpected(txnouttype t, const std::vector<std::vector<unsigned char> >& vSolutions);
  88 bool IsStandard(const CScript& scriptPubKey, txnouttype& whichType);
  89 bool ExtractDestination(const CScript& scriptPubKey, CTxDestination& addressRet);
  90 bool ExtractDestinations(const CScript& scriptPubKey, txnouttype& typeRet, std::vector<CTxDestination>& addressRet, int& nRequiredRet);
  91
  92 CScript GetScriptForDestination(const CTxDestination& dest);
  93 CScript GetScriptForMultisig(int nRequired, const std::vector<CPubKey>& keys);
  94
  95 #endif // BITCOIN_SCRIPT_STANDARD_H