rns_core/
constants.rs

1// =============================================================================
2// Reticulum protocol constants
3// Ported from Python RNS source
4// =============================================================================
5
6// --- From Reticulum.py ---
7
8/// Maximum transmission unit in bytes
9pub const MTU: usize = 500;
10
11/// Truncated hash length in bits
12pub const TRUNCATED_HASHLENGTH: usize = 128;
13
14/// Minimum header size: 2 (flags + hops) + 1 (context) + 16 (dest hash)
15pub const HEADER_MINSIZE: usize = 2 + 1 + (TRUNCATED_HASHLENGTH / 8);
16
17/// Maximum header size: 2 (flags + hops) + 1 (context) + 32 (transport_id + dest hash)
18pub const HEADER_MAXSIZE: usize = 2 + 1 + (TRUNCATED_HASHLENGTH / 8) * 2;
19
20/// Minimum IFAC size
21pub const IFAC_MIN_SIZE: usize = 1;
22
23/// Maximum data unit: MTU - HEADER_MAXSIZE - IFAC_MIN_SIZE
24pub const MDU: usize = MTU - HEADER_MAXSIZE - IFAC_MIN_SIZE;
25
26// --- From Identity.py ---
27
28/// Full key size in bits (256 X25519 + 256 Ed25519)
29pub const KEYSIZE: usize = 512;
30
31/// Ratchet key size in bits
32pub const RATCHETSIZE: usize = 256;
33
34/// Received ratchet expiry in seconds (30 days)
35pub const RATCHET_EXPIRY: u64 = 60 * 60 * 24 * 30;
36
37/// Token overhead in bytes (16 IV + 32 HMAC)
38pub const TOKEN_OVERHEAD: usize = 48;
39
40/// AES-128 block size in bytes
41pub const AES128_BLOCKSIZE: usize = 16;
42
43/// Full hash length in bits (SHA-256)
44pub const HASHLENGTH: usize = 256;
45
46/// Signature length in bits (Ed25519)
47pub const SIGLENGTH: usize = KEYSIZE;
48
49/// Name hash length in bits
50pub const NAME_HASH_LENGTH: usize = 80;
51
52/// Derived key length in bytes
53pub const DERIVED_KEY_LENGTH: usize = 64;
54
55// --- From Packet.py ---
56
57/// Packet types
58pub const PACKET_TYPE_DATA: u8 = 0x00;
59pub const PACKET_TYPE_ANNOUNCE: u8 = 0x01;
60pub const PACKET_TYPE_LINKREQUEST: u8 = 0x02;
61pub const PACKET_TYPE_PROOF: u8 = 0x03;
62
63/// Header types
64pub const HEADER_1: u8 = 0x00;
65pub const HEADER_2: u8 = 0x01;
66
67/// Packet context types
68pub const CONTEXT_NONE: u8 = 0x00;
69pub const CONTEXT_RESOURCE: u8 = 0x01;
70pub const CONTEXT_RESOURCE_ADV: u8 = 0x02;
71pub const CONTEXT_RESOURCE_REQ: u8 = 0x03;
72pub const CONTEXT_RESOURCE_HMU: u8 = 0x04;
73pub const CONTEXT_RESOURCE_PRF: u8 = 0x05;
74pub const CONTEXT_RESOURCE_ICL: u8 = 0x06;
75pub const CONTEXT_RESOURCE_RCL: u8 = 0x07;
76pub const CONTEXT_CACHE_REQUEST: u8 = 0x08;
77pub const CONTEXT_REQUEST: u8 = 0x09;
78pub const CONTEXT_RESPONSE: u8 = 0x0A;
79pub const CONTEXT_PATH_RESPONSE: u8 = 0x0B;
80pub const CONTEXT_COMMAND: u8 = 0x0C;
81pub const CONTEXT_COMMAND_STATUS: u8 = 0x0D;
82pub const CONTEXT_CHANNEL: u8 = 0x0E;
83pub const CONTEXT_KEEPALIVE: u8 = 0xFA;
84pub const CONTEXT_LINKIDENTIFY: u8 = 0xFB;
85pub const CONTEXT_LINKCLOSE: u8 = 0xFC;
86pub const CONTEXT_LINKPROOF: u8 = 0xFD;
87pub const CONTEXT_LRRTT: u8 = 0xFE;
88pub const CONTEXT_LRPROOF: u8 = 0xFF;
89
90/// Context flag values
91pub const FLAG_SET: u8 = 0x01;
92pub const FLAG_UNSET: u8 = 0x00;
93
94/// Encrypted MDU: floor((MDU - TOKEN_OVERHEAD - KEYSIZE/16) / AES128_BLOCKSIZE) * AES128_BLOCKSIZE - 1
95pub const ENCRYPTED_MDU: usize = {
96    let numerator = MDU - TOKEN_OVERHEAD - KEYSIZE / 16;
97    (numerator / AES128_BLOCKSIZE) * AES128_BLOCKSIZE - 1
98};
99
100/// Plain MDU (same as MDU)
101pub const PLAIN_MDU: usize = MDU;
102
103/// Explicit proof length: HASHLENGTH/8 + SIGLENGTH/8 = 32 + 64 = 96
104pub const EXPL_LENGTH: usize = HASHLENGTH / 8 + SIGLENGTH / 8;
105
106/// Implicit proof length: SIGLENGTH/8 = 64
107pub const IMPL_LENGTH: usize = SIGLENGTH / 8;
108
109/// Receipt status constants
110pub const RECEIPT_FAILED: u8 = 0x00;
111pub const RECEIPT_SENT: u8 = 0x01;
112pub const RECEIPT_DELIVERED: u8 = 0x02;
113pub const RECEIPT_CULLED: u8 = 0xFF;
114
115// --- From Destination.py ---
116
117/// Destination types
118pub const DESTINATION_SINGLE: u8 = 0x00;
119pub const DESTINATION_GROUP: u8 = 0x01;
120pub const DESTINATION_PLAIN: u8 = 0x02;
121pub const DESTINATION_LINK: u8 = 0x03;
122
123/// Destination directions
124pub const DESTINATION_IN: u8 = 0x11;
125pub const DESTINATION_OUT: u8 = 0x12;
126
127// --- From Transport.py ---
128
129/// Transport types
130pub const TRANSPORT_BROADCAST: u8 = 0x00;
131pub const TRANSPORT_TRANSPORT: u8 = 0x01;
132pub const TRANSPORT_RELAY: u8 = 0x02;
133pub const TRANSPORT_TUNNEL: u8 = 0x03;
134
135/// Maximum hops
136pub const PATHFINDER_M: u8 = 128;
137
138// --- PATHFINDER algorithm ---
139
140/// Retransmit retries (total sends = PATHFINDER_R + 1)
141pub const PATHFINDER_R: u8 = 1;
142
143/// Grace period between retries (seconds)
144pub const PATHFINDER_G: f64 = 5.0;
145
146/// Random window for announce rebroadcast (seconds)
147pub const PATHFINDER_RW: f64 = 0.5;
148
149/// Path expiry = 7 days (seconds)
150pub const PATHFINDER_E: f64 = 604800.0;
151
152// --- Path expiry by interface mode ---
153
154/// Access Point path expiry = 1 day
155pub const AP_PATH_TIME: f64 = 86400.0;
156
157/// Roaming path expiry = 6 hours
158pub const ROAMING_PATH_TIME: f64 = 21600.0;
159
160// --- Announce bandwidth cap ---
161
162/// Default announce bandwidth cap (2% of interface bandwidth)
163pub const ANNOUNCE_CAP: f64 = 0.02;
164
165/// Maximum queued announces per interface
166pub const MAX_QUEUED_ANNOUNCES: usize = 16384;
167
168/// Queued announce lifetime (24 hours)
169pub const QUEUED_ANNOUNCE_LIFE: f64 = 86400.0;
170
171/// Retention TTL for announce retransmission state (seconds)
172pub const ANNOUNCE_TABLE_TTL: f64 = 30.0;
173
174/// Maximum retained bytes for announce retransmission state
175pub const ANNOUNCE_TABLE_MAX_BYTES: usize = 4 * 1024 * 1024;
176
177// --- Table limits ---
178
179/// How many local rebroadcasts of an announce is allowed
180pub const LOCAL_REBROADCASTS_MAX: u8 = 2;
181
182/// Maximum number of random blobs per destination to keep in memory
183pub const MAX_RANDOM_BLOBS: usize = 64;
184
185/// Maximum number of announce timestamps to keep per destination
186pub const MAX_RATE_TIMESTAMPS: usize = 16;
187
188/// Maximum packet hashlist size before rotation
189pub const HASHLIST_MAXSIZE: usize = 250_000;
190
191/// Maximum announce signature cache entries (dedup verified signatures)
192pub const ANNOUNCE_SIG_CACHE_MAXSIZE: usize = 2_000;
193
194/// TTL for announce signature cache entries (seconds)
195pub const ANNOUNCE_SIG_CACHE_TTL: f64 = 600.0;
196
197// --- Timeouts ---
198
199/// Reverse table entry timeout (8 minutes)
200pub const REVERSE_TIMEOUT: f64 = 480.0;
201
202/// Destination table entry timeout (7 days)
203pub const DESTINATION_TIMEOUT: f64 = 604800.0;
204
205/// Tunnel table entry timeout (8 hours)
206pub const TUNNEL_TIMEOUT: f64 = 28800.0;
207
208/// Tunnel path retention timeout (8 hours)
209pub const TUNNEL_PATH_TIMEOUT: f64 = 28800.0;
210
211/// Link stale time = 2 * KEEPALIVE(360) = 720 seconds
212pub const LINK_STALE_TIME: f64 = 720.0;
213
214/// Link timeout = STALE_TIME * 1.25 = 900 seconds
215pub const LINK_TIMEOUT: f64 = 900.0;
216
217/// Link establishment timeout per hop (seconds)
218pub const LINK_ESTABLISHMENT_TIMEOUT_PER_HOP: f64 = 6.0;
219
220// --- Path request ---
221
222/// Default timeout for path requests (seconds)
223pub const PATH_REQUEST_TIMEOUT: f64 = 15.0;
224
225/// Grace time before a path announcement is made (seconds)
226pub const PATH_REQUEST_GRACE: f64 = 0.4;
227
228/// Extra grace time for roaming-mode interfaces (seconds)
229pub const PATH_REQUEST_RG: f64 = 1.5;
230
231/// Minimum interval for automated path requests (seconds)
232pub const PATH_REQUEST_MI: f64 = 20.0;
233
234/// Maximum amount of unique path request tags to remember
235pub const MAX_PR_TAGS: usize = 32000;
236
237// --- Job intervals ---
238
239/// Announce check interval (seconds)
240pub const ANNOUNCES_CHECK_INTERVAL: f64 = 1.0;
241
242/// Table culling interval (seconds)
243pub const TABLES_CULL_INTERVAL: f64 = 5.0;
244
245/// Link check interval (seconds)
246pub const LINKS_CHECK_INTERVAL: f64 = 1.0;
247
248// --- Ingress Control (from Interface.py) ---
249
250/// Interface "new" period in seconds (2 hours).
251pub const IC_NEW_TIME: f64 = 7200.0;
252/// Announce frequency threshold for new interfaces (announces/sec).
253pub const IC_BURST_FREQ_NEW: f64 = 3.0;
254/// Announce frequency threshold for mature interfaces (announces/sec).
255pub const IC_BURST_FREQ: f64 = 10.0;
256/// Path request frequency threshold for new interfaces (requests/sec).
257pub const IC_PR_BURST_FREQ_NEW: f64 = 3.0;
258/// Path request frequency threshold for mature interfaces (requests/sec).
259pub const IC_PR_BURST_FREQ: f64 = 8.0;
260/// Minimum burst active duration in seconds.
261pub const IC_BURST_HOLD: f64 = 15.0;
262/// Penalty delay before releasing held announces (seconds).
263pub const IC_BURST_PENALTY: f64 = 15.0;
264/// Interval between individual held announce releases (seconds).
265pub const IC_HELD_RELEASE_INTERVAL: f64 = 5.0;
266/// Minimum path request samples before burst deactivation/egress limiting.
267pub const IC_BURST_MIN_SAMPLES: usize = 6;
268/// Default egress path request limit (requests/sec).
269pub const EC_PR_FREQ: f64 = 5.0;
270/// Maximum held announces per interface.
271pub const IC_MAX_HELD_ANNOUNCES: usize = 256;
272
273// --- Interface modes (from Interface.py) ---
274
275pub const MODE_FULL: u8 = 0x01;
276pub const MODE_POINT_TO_POINT: u8 = 0x02;
277pub const MODE_ACCESS_POINT: u8 = 0x03;
278pub const MODE_ROAMING: u8 = 0x04;
279pub const MODE_BOUNDARY: u8 = 0x05;
280pub const MODE_GATEWAY: u8 = 0x06;
281
282/// Interface modes that forward path requests for unknown destinations.
283/// Python: Interface.DISCOVER_PATHS_FOR = [MODE_ACCESS_POINT, MODE_GATEWAY, MODE_ROAMING]
284pub const DISCOVER_PATHS_FOR: [u8; 3] = [MODE_ACCESS_POINT, MODE_GATEWAY, MODE_ROAMING];
285
286/// Discovery path request expiry (seconds) — requests older than this are culled.
287pub const DISCOVERY_PATH_REQUEST_TIMEOUT: f64 = 15.0;
288
289// --- Path states ---
290
291pub const STATE_UNKNOWN: u8 = 0x00;
292pub const STATE_UNRESPONSIVE: u8 = 0x01;
293pub const STATE_RESPONSIVE: u8 = 0x02;
294
295// --- From Link.py ---
296
297/// Link ephemeral public key size: 32 (X25519) + 32 (Ed25519)
298pub const LINK_ECPUBSIZE: usize = 64;
299
300/// Link key size in bytes
301pub const LINK_KEYSIZE: usize = 32;
302
303/// Link MTU signalling bytes size
304pub const LINK_MTU_SIZE: usize = 3;
305
306/// Maximum keepalive interval in seconds
307pub const LINK_KEEPALIVE_MAX: f64 = 360.0;
308
309/// Minimum keepalive interval in seconds
310pub const LINK_KEEPALIVE_MIN: f64 = 5.0;
311
312/// Maximum RTT used for keepalive scaling
313pub const LINK_KEEPALIVE_MAX_RTT: f64 = 1.75;
314
315/// RTT timeout factor for stale→close transition
316pub const LINK_KEEPALIVE_TIMEOUT_FACTOR: f64 = 4.0;
317
318/// Grace period for stale→close transition
319pub const LINK_STALE_GRACE: f64 = 5.0;
320
321/// Factor to compute stale_time from keepalive
322pub const LINK_STALE_FACTOR: f64 = 2.0;
323
324/// Traffic timeout factor
325pub const LINK_TRAFFIC_TIMEOUT_FACTOR: f64 = 6.0;
326
327/// Link MDU: floor((MTU - IFAC_MIN_SIZE - HEADER_MINSIZE - TOKEN_OVERHEAD) / AES128_BLOCKSIZE) * AES128_BLOCKSIZE - 1
328pub const LINK_MDU: usize = {
329    let numerator = MTU - IFAC_MIN_SIZE - HEADER_MINSIZE - TOKEN_OVERHEAD;
330    (numerator / AES128_BLOCKSIZE) * AES128_BLOCKSIZE - 1
331};
332
333/// Link MTU bytemask (21-bit MTU field)
334pub const LINK_MTU_BYTEMASK: u32 = 0x1FFFFF;
335
336/// Link mode bytemask (3-bit mode field in upper byte)
337pub const LINK_MODE_BYTEMASK: u8 = 0xE0;
338
339// --- From Channel.py ---
340
341/// Initial window size at channel setup
342pub const CHANNEL_WINDOW: u16 = 2;
343
344/// Absolute minimum window size
345pub const CHANNEL_WINDOW_MIN: u16 = 2;
346
347/// Minimum window limit for slow links
348pub const CHANNEL_WINDOW_MIN_LIMIT_SLOW: u16 = 2;
349
350/// Minimum window limit for medium-speed links
351pub const CHANNEL_WINDOW_MIN_LIMIT_MEDIUM: u16 = 5;
352
353/// Minimum window limit for fast links
354pub const CHANNEL_WINDOW_MIN_LIMIT_FAST: u16 = 16;
355
356/// Maximum window size for slow links
357pub const CHANNEL_WINDOW_MAX_SLOW: u16 = 5;
358
359/// Maximum window size for medium-speed links
360pub const CHANNEL_WINDOW_MAX_MEDIUM: u16 = 12;
361
362/// Maximum window size for fast links
363pub const CHANNEL_WINDOW_MAX_FAST: u16 = 48;
364
365/// Minimum flexibility between window_max and window_min
366pub const CHANNEL_WINDOW_FLEXIBILITY: u16 = 4;
367
368/// Maximum sequence number
369pub const CHANNEL_SEQ_MAX: u16 = 0xFFFF;
370
371/// Sequence number modulus
372pub const CHANNEL_SEQ_MODULUS: u32 = 0x10000;
373
374/// Maximum number of send tries per envelope
375pub const CHANNEL_MAX_TRIES: u8 = 5;
376
377/// RTT threshold for fast links
378pub const CHANNEL_RTT_FAST: f64 = 0.18;
379
380/// RTT threshold for medium links
381pub const CHANNEL_RTT_MEDIUM: f64 = 0.75;
382
383/// RTT threshold for slow links
384pub const CHANNEL_RTT_SLOW: f64 = 1.45;
385
386/// Number of consecutive fast rounds to upgrade window
387pub const CHANNEL_FAST_RATE_THRESHOLD: u16 = 10;
388
389/// Channel envelope overhead: msgtype(2) + seq(2) + len(2)
390pub const CHANNEL_ENVELOPE_OVERHEAD: usize = 6;
391
392// --- From Buffer.py ---
393
394/// System message type for stream data
395pub const STREAM_DATA_MSGTYPE: u16 = 0xFF00;
396
397/// Maximum stream ID (14 bits)
398pub const STREAM_ID_MAX: u16 = 0x3FFF;
399
400/// Stream data overhead: 2 (stream header) + 6 (channel envelope)
401pub const STREAM_DATA_OVERHEAD: usize = 2 + CHANNEL_ENVELOPE_OVERHEAD;
402
403// --- From Resource.py ---
404
405/// Initial window size at beginning of transfer
406pub const RESOURCE_WINDOW: usize = 4;
407
408/// Absolute minimum window size during transfer
409pub const RESOURCE_WINDOW_MIN: usize = 2;
410
411/// Maximum window size for slow links
412pub const RESOURCE_WINDOW_MAX_SLOW: usize = 10;
413
414/// Maximum window size for very slow links
415pub const RESOURCE_WINDOW_MAX_VERY_SLOW: usize = 4;
416
417/// Maximum window size for fast links
418pub const RESOURCE_WINDOW_MAX_FAST: usize = 75;
419
420/// Global maximum window (for calculations)
421pub const RESOURCE_WINDOW_MAX: usize = RESOURCE_WINDOW_MAX_FAST;
422
423/// Minimum flexibility between window_max and window_min
424pub const RESOURCE_WINDOW_FLEXIBILITY: usize = 4;
425
426/// Sustained fast-rate rounds before enabling fast window
427/// = WINDOW_MAX_SLOW - WINDOW - 2 = 10 - 4 - 2 = 4
428pub const RESOURCE_FAST_RATE_THRESHOLD: usize = RESOURCE_WINDOW_MAX_SLOW - RESOURCE_WINDOW - 2;
429
430/// Sustained very-slow-rate rounds before capping to very slow
431pub const RESOURCE_VERY_SLOW_RATE_THRESHOLD: usize = 2;
432
433/// Fast rate threshold: 50 Kbps in bytes/sec = 50000 / 8 = 6250.0
434pub const RESOURCE_RATE_FAST: f64 = (50 * 1000) as f64 / 8.0;
435
436/// Very slow rate threshold: 2 Kbps in bytes/sec = 2000 / 8 = 250.0
437pub const RESOURCE_RATE_VERY_SLOW: f64 = (2 * 1000) as f64 / 8.0;
438
439/// Number of bytes in a map hash
440pub const RESOURCE_MAPHASH_LEN: usize = 4;
441
442/// Resource SDU = Packet.MDU (NOT ENCRYPTED_MDU)
443pub const RESOURCE_SDU: usize = MDU;
444
445/// Random hash size prepended to resource data
446pub const RESOURCE_RANDOM_HASH_SIZE: usize = 4;
447
448/// Maximum efficient resource size (1 MB - 1)
449pub const RESOURCE_MAX_EFFICIENT_SIZE: usize = 1024 * 1024 - 1;
450
451/// Maximum metadata size (16 MB - 1)
452pub const RESOURCE_METADATA_MAX_SIZE: usize = 16 * 1024 * 1024 - 1;
453
454/// Maximum auto-compress size (64 MB)
455pub const RESOURCE_AUTO_COMPRESS_MAX_SIZE: usize = 64 * 1024 * 1024;
456
457/// Part timeout factor (before RTT measured)
458pub const RESOURCE_PART_TIMEOUT_FACTOR: f64 = 4.0;
459
460/// Part timeout factor (after first RTT measured)
461pub const RESOURCE_PART_TIMEOUT_FACTOR_AFTER_RTT: f64 = 2.0;
462
463/// Proof timeout factor (reduced when awaiting proof)
464pub const RESOURCE_PROOF_TIMEOUT_FACTOR: f64 = 3.0;
465
466/// Additional wait allowance, in SDU-sized transfer units, while waiting for HMU data.
467pub const RESOURCE_HMU_WAIT_FACTOR: f64 = 3.5;
468
469/// Maximum retries for part transfers
470pub const RESOURCE_MAX_RETRIES: usize = 16;
471
472/// Maximum retries for advertisement
473pub const RESOURCE_MAX_ADV_RETRIES: usize = 4;
474
475/// Sender grace time (seconds)
476pub const RESOURCE_SENDER_GRACE_TIME: f64 = 10.0;
477
478/// Processing grace for advertisement response (seconds)
479pub const RESOURCE_PROCESSING_GRACE: f64 = 1.0;
480
481/// Retry grace time (seconds)
482pub const RESOURCE_RETRY_GRACE_TIME: f64 = 0.25;
483
484/// Per-retry delay (seconds)
485pub const RESOURCE_PER_RETRY_DELAY: f64 = 0.5;
486
487/// Maximum watchdog sleep interval (seconds)
488pub const RESOURCE_WATCHDOG_MAX_SLEEP: f64 = 1.0;
489
490/// Response max grace time (seconds)
491pub const RESOURCE_RESPONSE_MAX_GRACE_TIME: f64 = 10.0;
492
493/// Advertisement overhead in bytes (fixed msgpack overhead)
494pub const RESOURCE_ADVERTISEMENT_OVERHEAD: usize = 134;
495
496/// Maximum hashmap entries per advertisement segment
497/// = floor((LINK_MDU - ADVERTISEMENT_OVERHEAD) / MAPHASH_LEN)
498pub const RESOURCE_HASHMAP_MAX_LEN: usize =
499    (LINK_MDU - RESOURCE_ADVERTISEMENT_OVERHEAD) / RESOURCE_MAPHASH_LEN;
500
501/// Collision guard size = 2 * WINDOW_MAX + HASHMAP_MAX_LEN
502pub const RESOURCE_COLLISION_GUARD_SIZE: usize = 2 * RESOURCE_WINDOW_MAX + RESOURCE_HASHMAP_MAX_LEN;
503
504/// Hashmap not exhausted flag
505pub const RESOURCE_HASHMAP_IS_NOT_EXHAUSTED: u8 = 0x00;
506
507/// Hashmap exhausted flag
508pub const RESOURCE_HASHMAP_IS_EXHAUSTED: u8 = 0xFF;
509
510#[cfg(test)]
511mod tests {
512    use super::*;
513
514    #[test]
515    fn test_derived_constants() {
516        // MTU = 500
517        assert_eq!(MTU, 500);
518
519        // HEADER_MINSIZE = 2 + 1 + 16 = 19
520        assert_eq!(HEADER_MINSIZE, 19);
521
522        // HEADER_MAXSIZE = 2 + 1 + 32 = 35
523        assert_eq!(HEADER_MAXSIZE, 35);
524
525        // MDU = 500 - 35 - 1 = 464
526        assert_eq!(MDU, 464);
527
528        // ENCRYPTED_MDU = floor((464 - 48 - 32) / 16) * 16 - 1 = floor(384/16)*16 - 1 = 24*16 - 1 = 383
529        assert_eq!(ENCRYPTED_MDU, 383);
530
531        // PLAIN_MDU = MDU = 464
532        assert_eq!(PLAIN_MDU, 464);
533
534        // EXPL_LENGTH = 32 + 64 = 96
535        assert_eq!(EXPL_LENGTH, 96);
536
537        // IMPL_LENGTH = 64
538        assert_eq!(IMPL_LENGTH, 64);
539
540        // NAME_HASH_LENGTH = 80 bits = 10 bytes
541        assert_eq!(NAME_HASH_LENGTH / 8, 10);
542
543        // KEYSIZE = 512 bits = 64 bytes
544        assert_eq!(KEYSIZE / 8, 64);
545
546        // SIGLENGTH = 512 bits = 64 bytes
547        assert_eq!(SIGLENGTH / 8, 64);
548
549        // TRUNCATED_HASHLENGTH = 128 bits = 16 bytes
550        assert_eq!(TRUNCATED_HASHLENGTH / 8, 16);
551    }
552
553    #[test]
554    fn test_link_constants() {
555        assert_eq!(LINK_ECPUBSIZE, 64);
556        assert_eq!(LINK_MTU_SIZE, 3);
557        // LINK_MDU = floor((500 - 1 - 19 - 48) / 16) * 16 - 1 = floor(432/16)*16 - 1 = 27*16 - 1 = 431
558        assert_eq!(LINK_MDU, 431);
559        assert_eq!(CHANNEL_ENVELOPE_OVERHEAD, 6);
560        assert_eq!(STREAM_DATA_OVERHEAD, 8);
561        assert_eq!(STREAM_ID_MAX, 0x3FFF);
562    }
563
564    #[test]
565    fn test_transport_constants() {
566        // PATHFINDER_E = 7 days in seconds
567        assert_eq!(PATHFINDER_E, 60.0 * 60.0 * 24.0 * 7.0);
568
569        // AP_PATH_TIME = 1 day
570        assert_eq!(AP_PATH_TIME, 60.0 * 60.0 * 24.0);
571
572        // ROAMING_PATH_TIME = 6 hours
573        assert_eq!(ROAMING_PATH_TIME, 60.0 * 60.0 * 6.0);
574
575        // LINK_STALE_TIME = 2 * 360
576        assert_eq!(LINK_STALE_TIME, 720.0);
577
578        // LINK_TIMEOUT = STALE_TIME * 1.25
579        assert_eq!(LINK_TIMEOUT, LINK_STALE_TIME * 1.25);
580
581        // REVERSE_TIMEOUT = 8 minutes
582        assert_eq!(REVERSE_TIMEOUT, 8.0 * 60.0);
583
584        // DESTINATION_TIMEOUT = 7 days
585        assert_eq!(DESTINATION_TIMEOUT, 60.0 * 60.0 * 24.0 * 7.0);
586    }
587
588    #[test]
589    fn test_resource_constants() {
590        // SDU = MDU = 464 (NOT ENCRYPTED_MDU)
591        assert_eq!(RESOURCE_SDU, 464);
592        assert_eq!(RESOURCE_SDU, MDU);
593
594        // FAST_RATE_THRESHOLD = WINDOW_MAX_SLOW - WINDOW - 2 = 10 - 4 - 2 = 4
595        assert_eq!(RESOURCE_FAST_RATE_THRESHOLD, 4);
596
597        // RATE_FAST = 50000 / 8 = 6250.0
598        assert_eq!(RESOURCE_RATE_FAST, 6250.0);
599
600        // RATE_VERY_SLOW = 2000 / 8 = 250.0
601        assert_eq!(RESOURCE_RATE_VERY_SLOW, 250.0);
602
603        // HASHMAP_MAX_LEN = floor((431 - 134) / 4) = floor(297/4) = 74
604        assert_eq!(RESOURCE_HASHMAP_MAX_LEN, 74);
605
606        // COLLISION_GUARD_SIZE = 2 * 75 + 74 = 224
607        assert_eq!(RESOURCE_COLLISION_GUARD_SIZE, 224);
608
609        // Window constants
610        assert_eq!(RESOURCE_WINDOW, 4);
611        assert_eq!(RESOURCE_WINDOW_MIN, 2);
612        assert_eq!(RESOURCE_WINDOW_MAX_SLOW, 10);
613        assert_eq!(RESOURCE_WINDOW_MAX_VERY_SLOW, 4);
614        assert_eq!(RESOURCE_WINDOW_MAX_FAST, 75);
615        assert_eq!(RESOURCE_WINDOW_MAX, 75);
616        assert_eq!(RESOURCE_WINDOW_FLEXIBILITY, 4);
617    }
618}
rns_core/constants.rs

rns_core/
constants.rs
