text: // Copyright (c) 2010 Satoshi Nakamoto
  // Copyright (c) 2009-2012 The Bitcoin developers
  // Copyright (c) 2011-2012 Plutuscoin Developers
  // Distributed under the MIT/X11 software license, see the accompanying
  // file COPYING or http://www.opensource.org/licenses/mit-license.php.
  
  #ifndef _BITCOINRPC_H_
  #define _BITCOINRPC_H_ 1
  
  #include <string>
  #include <list>
  #include <map>
  
  #include "json/json_spirit_reader_template.h"
  #include "json/json_spirit_writer_template.h"
  #include "json/json_spirit_utils.h"
  
  json_spirit::Object JSONRPCError(int code, const std::string& message);
  
  void ThreadRPCServer(void* parg);
  int CommandLineRPC(int argc, char *argv[]);
  
  /** Convert parameter values for RPC call from strings to command-specific JSON objects. */
  json_spirit::Array RPCConvertValues(const std::string &strMethod, const std::vector<std::string> &strParams);
  
  /*
    Type-check arguments; throws JSONRPCError if wrong type given. Does not check that
    the right number of arguments are passed, just that any passed are the correct type.
    Use like:  RPCTypeCheck(params, boost::assign::list_of(str_type)(int_type)(obj_type));
  */
  void RPCTypeCheck(const json_spirit::Array& params,
                    const std::list<json_spirit::Value_type>& typesExpected);
  /*
    Check for expected keys/value types in an Object.
    Use like: RPCTypeCheck(object, boost::assign::map_list_of("name", str_type)("value", int_type));
  */
  void RPCTypeCheck(const json_spirit::Object& o,
                    const std::map<std::string, json_spirit::Value_type>& typesExpected);
  
  typedef json_spirit::Value(*rpcfn_type)(const json_spirit::Array& params, bool fHelp);
  
  class CRPCCommand
  {
  public:
      std::string name;
      rpcfn_type actor;
      bool okSafeMode;
  };
  
  /**
   * Bitcoin RPC command dispatcher.
   */
  class CRPCTable
  {
  private:
      std::map<std::string, const CRPCCommand*> mapCommands;
  public:
      CRPCTable();
      const CRPCCommand* operator[](std::string name) const;
      std::string help(std::string name) const;
  
      /**
       * Execute a method.
       * @param method   Method to execute
       * @param params   Array of arguments (JSON objects)
       * @returns Result of the call.
       * @throws an exception (json_spirit::Value) when an error happens.
       */
      json_spirit::Value execute(const std::string &method, const json_spirit::Array &params) const;
  };
  
  extern const CRPCTable tableRPC;
  
  #endif
  