src/script/standard.h

   1 // Copyright (c) 2009-2010 Satoshi Nakamoto
   2 // Copyright (c) 2009-2014 The Bitcoin 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(0) {}
  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_STRICTENC |
  49                                                          SCRIPT_VERIFY_MINIMALDATA |
  50                                                          SCRIPT_VERIFY_NULLDUMMY |
  51                                                          SCRIPT_VERIFY_DISCOURAGE_UPGRADABLE_NOPS;
  52
  53 /** For convenience, standard but not mandatory verify flags. */
  54 static const unsigned int STANDARD_NOT_MANDATORY_VERIFY_FLAGS = STANDARD_SCRIPT_VERIFY_FLAGS & ~MANDATORY_SCRIPT_VERIFY_FLAGS;
  55
  56 enum txnouttype
  57 {
  58     TX_NONSTANDARD,
  59     // 'standard' transaction types:
  60     TX_PUBKEY,
  61     TX_PUBKEYHASH,
  62     TX_SCRIPTHASH,
  63     TX_MULTISIG,
  64     TX_NULL_DATA,
  65 };
  66
  67 class CNoDestination {
  68 public:
  69     friend bool operator==(const CNoDestination &a, const CNoDestination &b) { return true; }
  70     friend bool operator<(const CNoDestination &a, const CNoDestination &b) { return true; }
  71 };
  72
  73 /**
  74  * A txout script template with a specific destination. It is either:
  75  *  * CNoDestination: no destination set
  76  *  * CKeyID: TX_PUBKEYHASH destination
  77  *  * CScriptID: TX_SCRIPTHASH destination
  78  *  A CTxDestination is the internal data type encoded in a CBitcoinAddress
  79  */
  80 typedef boost::variant<CNoDestination, CKeyID, CScriptID> CTxDestination;
  81
  82 const char* GetTxnOutputType(txnouttype t);
  83
  84 bool Solver(const CScript& scriptPubKey, txnouttype& typeRet, std::vector<std::vector<unsigned char> >& vSolutionsRet);
  85 int ScriptSigArgsExpected(txnouttype t, const std::vector<std::vector<unsigned char> >& vSolutions);
  86 bool IsStandard(const CScript& scriptPubKey, txnouttype& whichType);
  87 bool ExtractDestination(const CScript& scriptPubKey, CTxDestination& addressRet);
  88 bool ExtractDestinations(const CScript& scriptPubKey, txnouttype& typeRet, std::vector<CTxDestination>& addressRet, int& nRequiredRet);
  89
  90 CScript GetScriptForDestination(const CTxDestination& dest);
  91 CScript GetScriptForMultisig(int nRequired, const std::vector<CPubKey>& keys);
  92
  93 #endif // BITCOIN_SCRIPT_STANDARD_H