#ifndef RETROSHARE_IDENTITY_GUI_INTERFACE_H #define RETROSHARE_IDENTITY_GUI_INTERFACE_H /* * libretroshare/src/retroshare: rsidentity.h * * RetroShare C++ Interface. * * Copyright 2012-2012 by Robert Fernie. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License Version 2.1 as published by the Free Software Foundation. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 * USA. * * Please report all bugs and problems to "retroshare@lunamutt.com". * */ #include #include #include #include "gxs/rstokenservice.h" #include "gxs/rsgxsifaceimpl.h" /* The Main Interface Class - for information about your Peers */ class RsIdentity; extern RsIdentity *rsIdentity; // GroupFlags: Only one so far: #define RSGXSID_GROUPFLAG_REALID 0x0001 // THESE ARE FLAGS FOR INTERFACE. #define RSID_TYPE_MASK 0xff00 #define RSID_RELATION_MASK 0x00ff #define RSID_TYPE_REALID 0x0100 #define RSID_TYPE_PSEUDONYM 0x0200 #define RSID_RELATION_YOURSELF 0x0001 #define RSID_RELATION_FRIEND 0x0002 #define RSID_RELATION_FOF 0x0004 #define RSID_RELATION_OTHER 0x0008 #define RSID_RELATION_UNKNOWN 0x0010 std::string rsIdTypeToString(uint32_t idtype); class RsGxsIdGroup { public: RsGxsIdGroup():mPgpKnown(false) { return; } RsGroupMetaData mMeta; // In GroupMetaData. //std::string mNickname; (mGroupName) //std::string mKeyId; (mGroupId) //uint32_t mIdType; (mGroupFlags) // SHA(KeyId + Gpg Fingerprint) -> can only be IDed if GPG known. // The length of the input must be long enough to make brute force search implausible. // Easy to do 1e9 SHA-1 hash computations per second on a GPU. // We will need a minimum of 256 bits, ideally 1024 bits or 2048 bits. // Actually PgpIdHash is SHA1(.mMeta.mGroupId + PGPHandler->GpgFingerprint(ownId)) // ??? 160 bits. std::string mPgpIdHash; std::string mPgpIdSign; // Need a signature as proof - otherwise anyone could add others Hashes. // Not Serialised - for GUI's benefit. bool mPgpKnown; std::string mPgpId; }; class RsGxsIdOpinion { public: RsMsgMetaData mMeta; // In MsgMetaData. //std::string mKeyId; (mGroupId) //std::string mPeerId; (mAuthorId) ??? uint32_t mOpinion; // NOT SERIALISED YET! double mReputation; //int mRating; //int mPeersRating; //std::string mComment; }; // This will probably be dropped. class RsGxsIdComment { public: RsMsgMetaData mMeta; std::string mComment; }; std::ostream &operator<<(std::ostream &out, const RsGxsIdGroup &group); std::ostream &operator<<(std::ostream &out, const RsGxsIdOpinion &msg); #if 0 class RsIdReputation { public: std::string mKeyId; int mYourRating; int mPeersRating; int mFofRating; int mTotalRating; std::string mComment; }; class RsIdOpinion { public: std::string mKeyId; std::string mPeerId; int mRating; int mPeersRating; std::string mComment; }; #endif // DATA TYPE FOR EXTERNAL INTERFACE. typedef std::string RsGxsId; // TMP. => class RsIdentityDetails { public: RsIdentityDetails() :mIsOwnId(false), mPgpLinked(false), mPgpKnown(false), mOpinion(0), mReputation(0) { return; } RsGxsId mId; // identity details. std::string mNickname; bool mIsOwnId; // PGP Stuff. bool mPgpLinked; bool mPgpKnown; std::string mPgpId; // reputation details. double mOpinion; double mReputation; }; class RsIdOpinion { public: RsGxsId id; int rating; }; class RsIdentityParameters { public: RsIdentityParameters(): isPgpLinked(false) { return; } bool isPgpLinked; std::string nickname; }; class RsIdentity: public RsGxsIfaceImpl { public: RsIdentity(RsGenExchange *gxs): RsGxsIfaceImpl(gxs) { return; } virtual ~RsIdentity() { return; } /********************************************************************************************/ /********************************************************************************************/ // For Other Services.... // It should be impossible for them to get a message which we don't have the identity. // Its a major error if we don't have the identity. // We cache all identities, and provide alternative (instantaneous) // functions to extract info, rather than the standard Token system. //virtual bool getNickname(const RsGxsId &id, std::string &nickname) = 0; virtual bool getIdDetails(const RsGxsId &id, RsIdentityDetails &details) = 0; virtual bool getOwnIds(std::list &ownIds) = 0; // virtual bool submitOpinion(uint32_t& token, RsIdOpinion &opinion) = 0; virtual bool createIdentity(uint32_t& token, RsIdentityParameters ¶ms) = 0; // Specific RsIdentity Functions.... /* Specific Service Data */ /* We expose these initially for testing / GUI purposes. */ virtual bool getGroupData(const uint32_t &token, std::vector &groups) = 0; }; #endif // RETROSHARE_IDENTITY_GUI_INTERFACE_H