Bitcoin ABC 0.26.3
P2P Digital Currency
Loading...
Searching...
No Matches
i2p.h
Go to the documentation of this file.
1// Copyright (c) 2020-2020 The Bitcoin Core developers
2// Distributed under the MIT software license, see the accompanying
3// file COPYING or http://www.opensource.org/licenses/mit-license.php.
4
5#ifndef BITCOIN_I2P_H
6#define BITCOIN_I2P_H
7
8#include <compat.h>
9#include <netaddress.h>
10#include <sync.h>
11#include <threadinterrupt.h>
12#include <util/fs.h>
13#include <util/sock.h>
14
15#include <memory>
16#include <optional>
17#include <string>
18#include <unordered_map>
19#include <vector>
20
21namespace i2p {
22
26using Binary = std::vector<uint8_t>;
27
31struct Connection {
33 std::unique_ptr<Sock> sock;
34
37
40};
41
42namespace sam {
43
52 static constexpr size_t MAX_MSG_SIZE{65536};
53
57 class Session {
58 public:
74
82 ~Session();
83
91
100
112 bool Connect(const CService &to, Connection &conn, bool &proxy_error)
114
115 private:
119 struct Reply {
123 std::string full;
124
128 std::string request;
129
137 std::unordered_map<std::string, std::optional<std::string>> keys;
138
150 std::string Get(const std::string &key) const;
151 };
152
158 template <typename... Args>
159 void Log(const std::string &fmt, const Args &...args) const;
160
172 const std::string &request,
173 bool check_result_ok = true) const;
174
180 std::unique_ptr<Sock> Hello() const EXCLUSIVE_LOCKS_REQUIRED(m_mutex);
181
186
194
201 void GenerateAndSavePrivateKey(const Sock &sock)
203
210
217
225
230
236
241
246
251
258
268
274
279 };
280
281} // namespace sam
282} // namespace i2p
283
284#endif // BITCOIN_I2P_H
A combination of a network address (CNetAddr) and a (TCP) port.
Definition netaddress.h:545
A helper class for interruptible sleeps.
RAII helper class that manages a socket.
Definition sock.h:28
Path class wrapper to block calls to the fs::path(std::string) implicit constructor and the fs::path:...
Definition fs.h:30
I2P SAM session.
Definition i2p.h:57
const fs::path m_private_key_file
The name of the file where this peer's private key is stored (in binary).
Definition i2p.h:235
Reply SendRequestAndGetReply(const Sock &sock, const std::string &request, bool check_result_ok=true) const
Send request and get a reply from the SAM proxy.
Definition i2p.cpp:243
bool Listen(Connection &conn) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Start listening for an incoming connection.
Definition i2p.cpp:125
void CreateIfNotCreatedAlready() EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Create the session if not already created.
Definition i2p.cpp:353
void Disconnect() EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Destroy the session, closing the internally used sockets.
Definition i2p.cpp:409
const CService m_control_host
The host and port of the SAM control service.
Definition i2p.h:240
std::unique_ptr< Sock > Hello() const EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Open a new connection to the SAM proxy.
Definition i2p.cpp:284
void CheckControlSock() EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Check the control socket for errors and possibly disconnect.
Definition i2p.cpp:302
std::unique_ptr< Sock > StreamAccept() EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Open a new connection to the SAM proxy and issue "STREAM ACCEPT" request using the existing session i...
Definition i2p.cpp:387
Binary MyDestination() const EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Derive own destination from m_private_key.
Definition i2p.cpp:337
~Session()
Destroy the session, closing the internally used sockets.
Definition i2p.cpp:120
void GenerateAndSavePrivateKey(const Sock &sock) EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Generate a new destination with the SAM proxy, set m_private_key to it and save it on disk to m_priva...
Definition i2p.cpp:323
bool Connect(const CService &to, Connection &conn, bool &proxy_error) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Connect to an I2P peer.
Definition i2p.cpp:165
CThreadInterrupt *const m_interrupt
Cease network activity when this is signaled.
Definition i2p.h:245
void DestGenerate(const Sock &sock) EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Generate a new destination with the SAM proxy and set m_private_key to it.
Definition i2p.cpp:312
void Log(const std::string &fmt, const Args &...args) const
Log a message in the BCLog::I2P category.
Definition i2p.cpp:239
Mutex m_mutex
Mutex protecting the members that can be concurrently accessed.
Definition i2p.h:250
bool Accept(Connection &conn) EXCLUSIVE_LOCKS_REQUIRED(!m_mutex)
Wait for and accept a new incoming connection.
Definition i2p.cpp:139
Filesystem operations and types.
Definition fs.h:20
static constexpr size_t MAX_MSG_SIZE
The maximum size of an incoming message from the I2P SAM proxy (in bytes).
Definition i2p.h:52
Definition i2p.cpp:28
std::vector< uint8_t > Binary
Binary data.
Definition i2p.h:26
Implement std::hash so RCUPtr can be used as a key for maps or sets.
Definition rcu.h:259
T GetRand(T nMax=std::numeric_limits< T >::max()) noexcept
Generate a uniform random integer of type T in the range [0..nMax) nMax defaults to std::numeric_limi...
Definition random.h:85
An established connection with another peer.
Definition i2p.h:31
std::unique_ptr< Sock > sock
Connected socket.
Definition i2p.h:33
CService me
Our I2P address.
Definition i2p.h:36
CService peer
The peer's I2P address.
Definition i2p.h:39
A reply from the SAM proxy.
Definition i2p.h:119
std::string Get(const std::string &key) const
Get the value of a given key.
Definition i2p.cpp:228
std::string full
Full, unparsed reply.
Definition i2p.h:123
std::unordered_map< std::string, std::optional< std::string > > keys
A map of keywords from the parsed reply.
Definition i2p.h:137
std::string request
Request, used for detailed error reporting.
Definition i2p.h:128
#define EXCLUSIVE_LOCKS_REQUIRED(...)
#define GUARDED_BY(x)