Bitcoin Core 22.99.0
P2P Digital Currency
i2p.cpp
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#include <chainparams.h>
6#include <compat.h>
7#include <compat/endian.h>
8#include <crypto/sha256.h>
9#include <fs.h>
10#include <i2p.h>
11#include <logging.h>
12#include <netaddress.h>
13#include <netbase.h>
14#include <random.h>
15#include <util/strencodings.h>
16#include <tinyformat.h>
17#include <util/readwritefile.h>
18#include <util/sock.h>
19#include <util/spanparsing.h>
20#include <util/system.h>
21
22#include <chrono>
23#include <memory>
24#include <stdexcept>
25#include <string>
26
27namespace i2p {
28
37static std::string SwapBase64(const std::string& from)
38{
39 std::string to;
40 to.resize(from.size());
41 for (size_t i = 0; i < from.size(); ++i) {
42 switch (from[i]) {
43 case '-':
44 to[i] = '+';
45 break;
46 case '~':
47 to[i] = '/';
48 break;
49 case '+':
50 to[i] = '-';
51 break;
52 case '/':
53 to[i] = '~';
54 break;
55 default:
56 to[i] = from[i];
57 break;
58 }
59 }
60 return to;
61}
62
69static Binary DecodeI2PBase64(const std::string& i2p_b64)
70{
71 const std::string& std_b64 = SwapBase64(i2p_b64);
72 bool invalid;
73 Binary decoded = DecodeBase64(std_b64.c_str(), &invalid);
74 if (invalid) {
75 throw std::runtime_error(strprintf("Cannot decode Base64: \"%s\"", i2p_b64));
76 }
77 return decoded;
78}
79
86static CNetAddr DestBinToAddr(const Binary& dest)
87{
88 CSHA256 hasher;
89 hasher.Write(dest.data(), dest.size());
90 unsigned char hash[CSHA256::OUTPUT_SIZE];
91 hasher.Finalize(hash);
92
93 CNetAddr addr;
94 const std::string addr_str = EncodeBase32(hash, false) + ".b32.i2p";
95 if (!addr.SetSpecial(addr_str)) {
96 throw std::runtime_error(strprintf("Cannot parse I2P address: \"%s\"", addr_str));
97 }
98
99 return addr;
100}
101
108static CNetAddr DestB64ToAddr(const std::string& dest)
109{
110 const Binary& decoded = DecodeI2PBase64(dest);
111 return DestBinToAddr(decoded);
112}
113
114namespace sam {
115
116Session::Session(const fs::path& private_key_file,
117 const CService& control_host,
118 CThreadInterrupt* interrupt)
119 : m_private_key_file(private_key_file), m_control_host(control_host), m_interrupt(interrupt),
120 m_control_sock(std::make_unique<Sock>(INVALID_SOCKET))
121{
122}
123
125{
126 LOCK(m_mutex);
127 Disconnect();
128}
129
131{
132 try {
133 LOCK(m_mutex);
135 conn.me = m_my_addr;
136 conn.sock = StreamAccept();
137 return true;
138 } catch (const std::runtime_error& e) {
139 Log("Error listening: %s", e.what());
141 }
142 return false;
143}
144
146{
147 try {
148 while (!*m_interrupt) {
149 Sock::Event occurred;
150 if (!conn.sock->Wait(MAX_WAIT_FOR_IO, Sock::RECV, &occurred)) {
151 throw std::runtime_error("wait on socket failed");
152 }
153
154 if ((occurred & Sock::RECV) == 0) {
155 // Timeout, no incoming connections within MAX_WAIT_FOR_IO.
156 continue;
157 }
158
159 const std::string& peer_dest =
160 conn.sock->RecvUntilTerminator('\n', MAX_WAIT_FOR_IO, *m_interrupt, MAX_MSG_SIZE);
161
162 conn.peer = CService(DestB64ToAddr(peer_dest), I2P_SAM31_PORT);
163
164 return true;
165 }
166 } catch (const std::runtime_error& e) {
167 Log("Error accepting: %s", e.what());
169 }
170 return false;
171}
172
173bool Session::Connect(const CService& to, Connection& conn, bool& proxy_error)
174{
175 // Refuse connecting to arbitrary ports. We don't specify any destination port to the SAM proxy
176 // when connecting (SAM 3.1 does not use ports) and it forces/defaults it to I2P_SAM31_PORT.
177 if (to.GetPort() != I2P_SAM31_PORT) {
178 proxy_error = false;
179 return false;
180 }
181
182 proxy_error = true;
183
184 std::string session_id;
185 std::unique_ptr<Sock> sock;
186 conn.peer = to;
187
188 try {
189 {
190 LOCK(m_mutex);
192 session_id = m_session_id;
193 conn.me = m_my_addr;
194 sock = Hello();
195 }
196
197 const Reply& lookup_reply =
198 SendRequestAndGetReply(*sock, strprintf("NAMING LOOKUP NAME=%s", to.ToStringIP()));
199
200 const std::string& dest = lookup_reply.Get("VALUE");
201
202 const Reply& connect_reply = SendRequestAndGetReply(
203 *sock, strprintf("STREAM CONNECT ID=%s DESTINATION=%s SILENT=false", session_id, dest),
204 false);
205
206 const std::string& result = connect_reply.Get("RESULT");
207
208 if (result == "OK") {
209 conn.sock = std::move(sock);
210 return true;
211 }
212
213 if (result == "INVALID_ID") {
214 LOCK(m_mutex);
215 Disconnect();
216 throw std::runtime_error("Invalid session id");
217 }
218
219 if (result == "CANT_REACH_PEER" || result == "TIMEOUT") {
220 proxy_error = false;
221 }
222
223 throw std::runtime_error(strprintf("\"%s\"", connect_reply.full));
224 } catch (const std::runtime_error& e) {
225 Log("Error connecting to %s: %s", to.ToString(), e.what());
227 return false;
228 }
229}
230
231// Private methods
232
233std::string Session::Reply::Get(const std::string& key) const
234{
235 const auto& pos = keys.find(key);
236 if (pos == keys.end() || !pos->second.has_value()) {
237 throw std::runtime_error(
238 strprintf("Missing %s= in the reply to \"%s\": \"%s\"", key, request, full));
239 }
240 return pos->second.value();
241}
242
243template <typename... Args>
244void Session::Log(const std::string& fmt, const Args&... args) const
245{
246 LogPrint(BCLog::I2P, "I2P: %s\n", tfm::format(fmt, args...));
247}
248
250 const std::string& request,
251 bool check_result_ok) const
252{
253 sock.SendComplete(request + "\n", MAX_WAIT_FOR_IO, *m_interrupt);
254
255 Reply reply;
256
257 // Don't log the full "SESSION CREATE ..." because it contains our private key.
258 reply.request = request.substr(0, 14) == "SESSION CREATE" ? "SESSION CREATE ..." : request;
259
260 // It could take a few minutes for the I2P router to reply as it is querying the I2P network
261 // (when doing name lookup, for example). Notice: `RecvUntilTerminator()` is checking
262 // `m_interrupt` more often, so we would not be stuck here for long if `m_interrupt` is
263 // signaled.
264 static constexpr auto recv_timeout = 3min;
265
266 reply.full = sock.RecvUntilTerminator('\n', recv_timeout, *m_interrupt, MAX_MSG_SIZE);
267
268 for (const auto& kv : spanparsing::Split(reply.full, ' ')) {
269 const auto& pos = std::find(kv.begin(), kv.end(), '=');
270 if (pos != kv.end()) {
271 reply.keys.emplace(std::string{kv.begin(), pos}, std::string{pos + 1, kv.end()});
272 } else {
273 reply.keys.emplace(std::string{kv.begin(), kv.end()}, std::nullopt);
274 }
275 }
276
277 if (check_result_ok && reply.Get("RESULT") != "OK") {
278 throw std::runtime_error(
279 strprintf("Unexpected reply to \"%s\": \"%s\"", request, reply.full));
280 }
281
282 return reply;
283}
284
285std::unique_ptr<Sock> Session::Hello() const
286{
287 auto sock = CreateSock(m_control_host);
288
289 if (!sock) {
290 throw std::runtime_error("Cannot create socket");
291 }
292
294 throw std::runtime_error(strprintf("Cannot connect to %s", m_control_host.ToString()));
295 }
296
297 SendRequestAndGetReply(*sock, "HELLO VERSION MIN=3.1 MAX=3.1");
298
299 return sock;
300}
301
303{
304 LOCK(m_mutex);
305
306 std::string errmsg;
307 if (!m_control_sock->IsConnected(errmsg)) {
308 Log("Control socket error: %s", errmsg);
309 Disconnect();
310 }
311}
312
314{
315 // https://geti2p.net/spec/common-structures#key-certificates
316 // "7" or "EdDSA_SHA512_Ed25519" - "Recent Router Identities and Destinations".
317 // Use "7" because i2pd <2.24.0 does not recognize the textual form.
318 const Reply& reply = SendRequestAndGetReply(sock, "DEST GENERATE SIGNATURE_TYPE=7", false);
319
320 m_private_key = DecodeI2PBase64(reply.Get("PRIV"));
321}
322
324{
325 DestGenerate(sock);
326
327 // umask is set to 077 in init.cpp, which is ok (unless -sysperms is given)
329 std::string(m_private_key.begin(), m_private_key.end()))) {
330 throw std::runtime_error(
331 strprintf("Cannot save I2P private key to %s", fs::quoted(fs::PathToString(m_private_key_file))));
332 }
333}
334
336{
337 // From https://geti2p.net/spec/common-structures#destination:
338 // "They are 387 bytes plus the certificate length specified at bytes 385-386, which may be
339 // non-zero"
340 static constexpr size_t DEST_LEN_BASE = 387;
341 static constexpr size_t CERT_LEN_POS = 385;
342
343 uint16_t cert_len;
344 memcpy(&cert_len, &m_private_key.at(CERT_LEN_POS), sizeof(cert_len));
345 cert_len = be16toh(cert_len);
346
347 const size_t dest_len = DEST_LEN_BASE + cert_len;
348
349 return Binary{m_private_key.begin(), m_private_key.begin() + dest_len};
350}
351
353{
354 std::string errmsg;
355 if (m_control_sock->IsConnected(errmsg)) {
356 return;
357 }
358
359 Log("Creating SAM session with %s", m_control_host.ToString());
360
361 auto sock = Hello();
362
363 const auto& [read_ok, data] = ReadBinaryFile(m_private_key_file);
364 if (read_ok) {
365 m_private_key.assign(data.begin(), data.end());
366 } else {
368 }
369
370 const std::string& session_id = GetRandHash().GetHex().substr(0, 10); // full is an overkill, too verbose in the logs
371 const std::string& private_key_b64 = SwapBase64(EncodeBase64(m_private_key));
372
373 SendRequestAndGetReply(*sock, strprintf("SESSION CREATE STYLE=STREAM ID=%s DESTINATION=%s",
374 session_id, private_key_b64));
375
377 m_session_id = session_id;
378 m_control_sock = std::move(sock);
379
380 LogPrintf("I2P: SAM session created: session id=%s, my address=%s\n", m_session_id,
381 m_my_addr.ToString());
382}
383
384std::unique_ptr<Sock> Session::StreamAccept()
385{
386 auto sock = Hello();
387
388 const Reply& reply = SendRequestAndGetReply(
389 *sock, strprintf("STREAM ACCEPT ID=%s SILENT=false", m_session_id), false);
390
391 const std::string& result = reply.Get("RESULT");
392
393 if (result == "OK") {
394 return sock;
395 }
396
397 if (result == "INVALID_ID") {
398 // If our session id is invalid, then force session re-creation on next usage.
399 Disconnect();
400 }
401
402 throw std::runtime_error(strprintf("\"%s\"", reply.full));
403}
404
406{
407 if (m_control_sock->Get() != INVALID_SOCKET) {
408 if (m_session_id.empty()) {
409 Log("Destroying incomplete session");
410 } else {
411 Log("Destroying session %s", m_session_id);
412 }
413 }
414 m_control_sock->Reset();
415 m_session_id.clear();
416}
417} // namespace sam
418} // namespace i2p
Network address.
Definition: netaddress.h:119
std::string ToStringIP() const
Definition: netaddress.cpp:608
bool SetSpecial(const std::string &addr)
Parse a Tor or I2P address and set this object to it.
Definition: netaddress.cpp:212
A hasher class for SHA-256.
Definition: sha256.h:14
static const size_t OUTPUT_SIZE
Definition: sha256.h:21
void Finalize(unsigned char hash[OUTPUT_SIZE])
Definition: sha256.cpp:663
CSHA256 & Write(const unsigned char *data, size_t len)
Definition: sha256.cpp:637
A combination of a network address (CNetAddr) and a (TCP) port.
Definition: netaddress.h:523
std::string ToString() const
uint16_t GetPort() const
Definition: netaddress.cpp:966
RAII helper class that manages a socket.
Definition: sock.h:26
virtual void SendComplete(const std::string &data, std::chrono::milliseconds timeout, CThreadInterrupt &interrupt) const
Send the given data, retrying on transient errors.
Definition: sock.cpp:147
uint8_t Event
Definition: sock.h:109
static constexpr Event RECV
If passed to Wait(), then it will wait for readiness to read from the socket.
Definition: sock.h:114
virtual std::string RecvUntilTerminator(uint8_t terminator, std::chrono::milliseconds timeout, CThreadInterrupt &interrupt, size_t max_data) const
Read from socket until a terminator character is encountered.
Definition: sock.cpp:188
std::string GetHex() const
Definition: uint256.cpp:20
Path class wrapper to prepare application code for transition from boost::filesystem library to std::...
Definition: fs.h:34
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:222
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:249
bool Accept(Connection &conn)
Wait for and accept a new incoming connection.
Definition: i2p.cpp:145
void CreateIfNotCreatedAlready() EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Create the session if not already created.
Definition: i2p.cpp:352
void Disconnect() EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Destroy the session, closing the internally used sockets.
Definition: i2p.cpp:405
const CService m_control_host
The host and port of the SAM control service.
Definition: i2p.h:227
Session(const fs::path &private_key_file, const CService &control_host, CThreadInterrupt *interrupt)
Construct a session.
Definition: i2p.cpp:116
std::unique_ptr< Sock > Hello() const EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Open a new connection to the SAM proxy.
Definition: i2p.cpp:285
void CheckControlSock()
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:384
bool Listen(Connection &conn)
Start listening for an incoming connection.
Definition: i2p.cpp:130
Binary MyDestination() const EXCLUSIVE_LOCKS_REQUIRED(m_mutex)
Derive own destination from m_private_key.
Definition: i2p.cpp:335
~Session()
Destroy the session, closing the internally used sockets.
Definition: i2p.cpp:124
bool Connect(const CService &to, Connection &conn, bool &proxy_error)
Connect to an I2P peer.
Definition: i2p.cpp:173
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
void Log(const std::string &fmt, const Args &... args) const
Log a message in the BCLog::I2P category.
Definition: i2p.cpp:244
CThreadInterrupt *const m_interrupt
Cease network activity when this is signaled.
Definition: i2p.h:232
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:313
Mutex m_mutex
Mutex protecting the members that can be concurrently accessed.
Definition: i2p.h:237
#define INVALID_SOCKET
Definition: compat.h:53
uint16_t be16toh(uint16_t big_endian_16bits)
Definition: endian.h:170
#define LogPrint(category,...)
Definition: logging.h:191
#define LogPrintf(...)
Definition: logging.h:187
@ I2P
Definition: logging.h:60
static auto quoted(const std::string &s)
Definition: fs.h:83
static std::string PathToString(const path &path)
Convert path object to byte string.
Definition: fs.h:120
static constexpr size_t MAX_MSG_SIZE
The maximum size of an incoming message from the I2P SAM proxy (in bytes).
Definition: i2p.h:50
Definition: i2p.cpp:27
static CNetAddr DestB64ToAddr(const std::string &dest)
Derive the .b32.i2p address of an I2P destination (I2P-style Base64).
Definition: i2p.cpp:108
static std::string SwapBase64(const std::string &from)
Swap Standard Base64 <-> I2P Base64.
Definition: i2p.cpp:37
static CNetAddr DestBinToAddr(const Binary &dest)
Derive the .b32.i2p address of an I2P destination (binary).
Definition: i2p.cpp:86
std::vector< uint8_t > Binary
Binary data.
Definition: i2p.h:26
static Binary DecodeI2PBase64(const std::string &i2p_b64)
Decode an I2P-style Base64 string.
Definition: i2p.cpp:69
std::vector< Span< const char > > Split(const Span< const char > &sp, char sep)
Split a string on every instance of sep, returning a vector.
Definition: spanparsing.cpp:51
void format(std::ostream &out, const char *fmt, const Args &... args)
Format list of arguments to the stream according to given format string.
Definition: tinyformat.h:1062
static constexpr uint16_t I2P_SAM31_PORT
SAM 3.1 and earlier do not support specifying ports and force the port to 0.
Definition: netaddress.h:113
std::function< std::unique_ptr< Sock >(const CService &)> CreateSock
Socket factory.
Definition: netbase.cpp:529
bool ConnectSocketDirectly(const CService &addrConnect, const Sock &sock, int nTimeout, bool manual_connection)
Try to connect to the specified service on the specified socket.
Definition: netbase.cpp:541
int nConnectTimeout
Definition: netbase.cpp:36
uint256 GetRandHash() noexcept
Definition: random.cpp:601
bool WriteBinaryFile(const fs::path &filename, const std::string &data)
Write contents of std::string to a file.
std::pair< bool, std::string > ReadBinaryFile(const fs::path &filename, size_t maxsize=std::numeric_limits< size_t >::max())
Read full contents of a file and return them in a std::string.
static constexpr auto MAX_WAIT_FOR_IO
Maximum time to wait for I/O readiness.
Definition: sock.h:19
std::vector< unsigned char > DecodeBase64(const char *p, bool *pf_invalid)
std::string EncodeBase64(Span< const unsigned char > input)
std::string EncodeBase32(Span< const unsigned char > input, bool pad)
Base32 encode.
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:112
std::string Get(const std::string &key) const
Get the value of a given key.
Definition: i2p.cpp:233
std::string full
Full, unparsed reply.
Definition: i2p.h:116
std::unordered_map< std::string, std::optional< std::string > > keys
A map of keywords from the parsed reply.
Definition: i2p.h:130
std::string request
Request, used for detailed error reporting.
Definition: i2p.h:121
#define LOCK(cs)
Definition: sync.h:226
#define strprintf
Format arguments and return the string or write to given std::ostream (see tinyformat::format doc for...
Definition: tinyformat.h:1164