#ifndef __NETWORK_OPS__ #define __NETWORK_OPS__ #include #include #include #include "AccountState.h" #include "LedgerMaster.h" #include "NicknameState.h" #include "RippleState.h" #include "SerializedValidation.h" #include "LedgerAcquire.h" #include "LedgerProposal.h" #include "JobQueue.h" // Operations that clients may wish to perform against the network // Master operational handler, server sequencer, network tracker class Peer; class LedgerConsensus; DEFINE_INSTANCE(InfoSub); class RPCSub; class InfoSub : public IS_INSTANCE(InfoSub) { protected: boost::unordered_set mSubAccountInfo; boost::unordered_set mSubAccountTransaction; boost::mutex mLockInfo; public: virtual ~InfoSub(); virtual void send(const Json::Value& jvObj) = 0; void onSendEmpty(); void insertSubAccountInfo(RippleAddress addr, uint32 uLedgerIndex) { boost::mutex::scoped_lock sl(mLockInfo); mSubAccountInfo.insert(addr); } }; class NetworkOPs { public: enum Fault { // exceptions these functions can throw IO_ERROR = 1, NO_NETWORK = 2, }; enum OperatingMode { // how we process transactions or account balance requests omDISCONNECTED = 0, // not ready to process requests omCONNECTED = 1, // convinced we are talking to the network omTRACKING = 2, // convinced we agree with the network omFULL = 3 // we have the ledger and can even validate }; protected: typedef boost::unordered_map > subInfoMapType; typedef boost::unordered_map >::value_type subInfoMapValue; typedef boost::unordered_map >::iterator subInfoMapIterator; typedef boost::unordered_map > subSubmitMapType; typedef boost::unordered_map subRpcMapType; OperatingMode mMode; bool mNeedNetworkLedger; boost::posix_time::ptime mConnectTime; boost::asio::deadline_timer mNetTimer; boost::shared_ptr mConsensus; boost::unordered_map > mStoredProposals; LedgerMaster* mLedgerMaster; LedgerAcquire::pointer mAcquiringLedger; int mCloseTimeOffset; // last ledger close int mLastCloseProposers, mLastCloseConvergeTime; uint256 mLastCloseHash; uint32 mLastCloseTime; uint32 mLastValidationTime; SerializedValidation::pointer mLastValidation; // Recent positions taken std::map > mRecentPositions; // XXX Split into more locks. boost::recursive_mutex mMonitorLock; subInfoMapType mSubAccount; subInfoMapType mSubRTAccount; subSubmitMapType mSubmitMap; // TODO: probably dump this subRpcMapType mRpcSubMap; boost::unordered_set mSubLedger; // accepted ledgers boost::unordered_set mSubServer; // when server changes connectivity state boost::unordered_set mSubTransactions; // all accepted transactions boost::unordered_set mSubRTTransactions; // all proposed and accepted transactions boost::recursive_mutex mWantedHashLock; boost::unordered_set mWantedHashes; void setMode(OperatingMode); Json::Value transJson(const SerializedTransaction& stTxn, TER terResult, bool bAccepted, Ledger::ref lpCurrent, const std::string& strType); bool haveConsensusObject(); Json::Value pubBootstrapAccountInfo(Ledger::ref lpAccepted, const RippleAddress& naAccountID); void pubAcceptedTransaction(Ledger::ref lpCurrent, const SerializedTransaction& stTxn, TER terResult,TransactionMetaSet::pointer& meta); void pubAccountTransaction(Ledger::ref lpCurrent, const SerializedTransaction& stTxn, TER terResult,bool accepted,TransactionMetaSet::pointer& meta); std::map getAffectedAccounts(const SerializedTransaction& stTxn); void pubServer(); public: NetworkOPs(boost::asio::io_service& io_service, LedgerMaster* pLedgerMaster); // network information uint32 getNetworkTimeNC(); // Our best estimate of wall time in seconds from 1/1/2000 uint32 getCloseTimeNC(); // Our best estimate of current ledger close time uint32 getValidationTimeNC(); // Use *only* to timestamp our own validation void closeTimeOffset(int); boost::posix_time::ptime getNetworkTimePT(); uint32 getLedgerID(const uint256& hash); uint32 getCurrentLedgerID(); OperatingMode getOperatingMode() { return mMode; } std::string strOperatingMode(); Ledger::ref getClosedLedger() { return mLedgerMaster->getClosedLedger(); } Ledger::ref getCurrentLedger() { return mLedgerMaster->getCurrentLedger(); } Ledger::pointer getLedgerByHash(const uint256& hash) { return mLedgerMaster->getLedgerByHash(hash); } Ledger::pointer getLedgerBySeq(const uint32 seq) { return mLedgerMaster->getLedgerBySeq(seq); } uint256 getClosedLedgerHash() { return mLedgerMaster->getClosedLedger()->getHash(); } // Do we have this inclusive range of ledgers in our database bool haveLedgerRange(uint32 from, uint32 to); SerializedValidation::ref getLastValidation() { return mLastValidation; } void setLastValidation(SerializedValidation::ref v) { mLastValidation = v; } SLE::pointer getSLE(Ledger::pointer lpLedger, const uint256& uHash) { return lpLedger->getSLE(uHash); } // // Transaction operations // typedef boost::function stCallback; // must complete immediately void submitTransaction(Job&, SerializedTransaction::pointer, stCallback callback = stCallback()); Transaction::pointer submitTransactionSync(const Transaction::pointer& tpTrans); void runTransactionQueue(); Transaction::pointer processTransaction(Transaction::pointer, stCallback); Transaction::pointer processTransaction(Transaction::pointer transaction) { return processTransaction(transaction, stCallback()); } Transaction::pointer findTransactionByID(const uint256& transactionID); #if 0 int findTransactionsBySource(const uint256& uLedger, std::list&, const RippleAddress& sourceAccount, uint32 minSeq, uint32 maxSeq); #endif int findTransactionsByDestination(std::list&, const RippleAddress& destinationAccount, uint32 startLedgerSeq, uint32 endLedgerSeq, int maxTransactions); // // Account functions // AccountState::pointer getAccountState(Ledger::ref lrLedger, const RippleAddress& accountID); SLE::pointer getGenerator(Ledger::ref lrLedger, const uint160& uGeneratorID); // // Directory functions // STVector256 getDirNodeInfo(Ledger::ref lrLedger, const uint256& uRootIndex, uint64& uNodePrevious, uint64& uNodeNext); #if 0 // // Nickname functions // NicknameState::pointer getNicknameState(const uint256& uLedger, const std::string& strNickname); #endif // // Owner functions // Json::Value getOwnerInfo(Ledger::pointer lpLedger, const RippleAddress& naAccount); // raw object operations bool findRawLedger(const uint256& ledgerHash, std::vector& rawLedger); bool findRawTransaction(const uint256& transactionHash, std::vector& rawTransaction); bool findAccountNode(const uint256& nodeHash, std::vector& rawAccountNode); bool findTransactionNode(const uint256& nodeHash, std::vector& rawTransactionNode); // tree synchronization operations bool getTransactionTreeNodes(uint32 ledgerSeq, const uint256& myNodeID, const std::vector& myNode, std::list< std::vector >& newNodes); bool getAccountStateNodes(uint32 ledgerSeq, const uint256& myNodeId, const std::vector& myNode, std::list< std::vector >& newNodes); // ledger proposal/close functions void processTrustedProposal(LedgerProposal::pointer proposal, boost::shared_ptr set, RippleAddress nodePublic, uint256 checkLedger, bool sigGood); SMAddNode gotTXData(const boost::shared_ptr& peer, const uint256& hash, const std::list& nodeIDs, const std::list< std::vector >& nodeData); bool recvValidation(const SerializedValidation::pointer& val); void takePosition(int seq, SHAMap::ref position); SHAMap::pointer getTXMap(const uint256& hash); bool hasTXSet(const boost::shared_ptr& peer, const uint256& set, ripple::TxSetStatus status); void mapComplete(const uint256& hash, SHAMap::ref map); // network state machine void checkState(const boost::system::error_code& result); void switchLastClosedLedger(Ledger::pointer newLedger, bool duringConsensus); // Used for the "jump" case bool checkLastClosedLedger(const std::vector&, uint256& networkClosed); int beginConsensus(const uint256& networkClosed, Ledger::ref closingLedger); void endConsensus(bool correctLCL); void setStandAlone() { setMode(omFULL); } void setStateTimer(); void newLCL(int proposers, int convergeTime, const uint256& ledgerHash); void needNetworkLedger() { mNeedNetworkLedger = true; } void clearNeedNetworkLedger() { mNeedNetworkLedger = false; } bool isNeedNetworkLedger() { return mNeedNetworkLedger; } void consensusViewChange(); int getPreviousProposers() { return mLastCloseProposers; } int getPreviousConvergeTime() { return mLastCloseConvergeTime; } uint32 getLastCloseTime() { return mLastCloseTime; } void setLastCloseTime(uint32 t) { mLastCloseTime = t; } Json::Value getServerInfo(); uint32 acceptLedger(); boost::unordered_map >& peekStoredProposals() { return mStoredProposals; } void storeProposal(const LedgerProposal::pointer& proposal, const RippleAddress& peerPublic); uint256 getConsensusLCL(); bool addWantedHash(const uint256& h); bool isWantedHash(const uint256& h, bool remove); // client information retrieval functions std::vector< std::pair > getAccountTxs(const RippleAddress& account, uint32 minLedger, uint32 maxLedger); std::vector getLedgerAffectedAccounts(uint32 ledgerSeq); std::vector getLedgerTransactions(uint32 ledgerSeq); // // Monitoring: publisher side // void pubLedger(Ledger::ref lpAccepted); void pubProposedTransaction(Ledger::ref lpCurrent, const SerializedTransaction& stTxn, TER terResult); // // Monitoring: subscriber side // void subAccount(InfoSub* ispListener, const boost::unordered_set& vnaAccountIDs, uint32 uLedgerIndex, bool rt); void unsubAccount(InfoSub* ispListener, const boost::unordered_set& vnaAccountIDs, bool rt); bool subLedger(InfoSub* ispListener, Json::Value& jvResult); bool unsubLedger(InfoSub* ispListener); bool subServer(InfoSub* ispListener, Json::Value& jvResult); bool unsubServer(InfoSub* ispListener); bool subTransactions(InfoSub* ispListener); bool unsubTransactions(InfoSub* ispListener); bool subRTTransactions(InfoSub* ispListener); bool unsubRTTransactions(InfoSub* ispListener); RPCSub* findRpcSub(const std::string& strUrl); RPCSub* addRpcSub(const std::string& strUrl, RPCSub* rspEntry); }; #endif // vim:ts=4