mirror of
https://github.com/vacp2p/rfc-index.git
synced 2026-01-09 22:08:07 -05:00
561 lines
49 KiB
HTML
561 lines
49 KiB
HTML
<!DOCTYPE HTML>
|
|
<html lang="en" class="ayu" dir="ltr">
|
|
<head>
|
|
<!-- Book generated using mdBook -->
|
|
<meta charset="UTF-8">
|
|
<title>P2P NAT Solution - Vac RFC</title>
|
|
|
|
|
|
<!-- Custom HTML head -->
|
|
|
|
<meta name="description" content="">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<meta name="theme-color" content="#ffffff">
|
|
|
|
<link rel="icon" href="../../favicon.svg">
|
|
<link rel="shortcut icon" href="../../favicon.png">
|
|
<link rel="stylesheet" href="../../css/variables.css">
|
|
<link rel="stylesheet" href="../../css/general.css">
|
|
<link rel="stylesheet" href="../../css/chrome.css">
|
|
<link rel="stylesheet" href="../../css/print.css" media="print">
|
|
|
|
<!-- Fonts -->
|
|
<link rel="stylesheet" href="../../FontAwesome/css/font-awesome.css">
|
|
<link rel="stylesheet" href="../../fonts/fonts.css">
|
|
|
|
<!-- Highlight.js Stylesheets -->
|
|
<link rel="stylesheet" href="../../highlight.css">
|
|
<link rel="stylesheet" href="../../tomorrow-night.css">
|
|
<link rel="stylesheet" href="../../ayu-highlight.css">
|
|
|
|
<!-- Custom theme stylesheets -->
|
|
<link rel="stylesheet" href="../../custom.css">
|
|
|
|
</head>
|
|
<body class="sidebar-visible no-js">
|
|
<div id="body-container">
|
|
<!-- Provide site root to javascript -->
|
|
<script>
|
|
var path_to_root = "../../";
|
|
var default_theme = window.matchMedia("(prefers-color-scheme: dark)").matches ? "navy" : "ayu";
|
|
</script>
|
|
|
|
<!-- Work around some values being stored in localStorage wrapped in quotes -->
|
|
<script>
|
|
try {
|
|
var theme = localStorage.getItem('mdbook-theme');
|
|
var sidebar = localStorage.getItem('mdbook-sidebar');
|
|
|
|
if (theme.startsWith('"') && theme.endsWith('"')) {
|
|
localStorage.setItem('mdbook-theme', theme.slice(1, theme.length - 1));
|
|
}
|
|
|
|
if (sidebar.startsWith('"') && sidebar.endsWith('"')) {
|
|
localStorage.setItem('mdbook-sidebar', sidebar.slice(1, sidebar.length - 1));
|
|
}
|
|
} catch (e) { }
|
|
</script>
|
|
|
|
<!-- Set the theme before any content is loaded, prevents flash -->
|
|
<script>
|
|
var theme;
|
|
try { theme = localStorage.getItem('mdbook-theme'); } catch(e) { }
|
|
if (theme === null || theme === undefined) { theme = default_theme; }
|
|
var html = document.querySelector('html');
|
|
html.classList.remove('ayu')
|
|
html.classList.add(theme);
|
|
var body = document.querySelector('body');
|
|
body.classList.remove('no-js')
|
|
body.classList.add('js');
|
|
</script>
|
|
|
|
<input type="checkbox" id="sidebar-toggle-anchor" class="hidden">
|
|
|
|
<!-- Hide / unhide sidebar before it is displayed -->
|
|
<script>
|
|
var body = document.querySelector('body');
|
|
var sidebar = null;
|
|
var sidebar_toggle = document.getElementById("sidebar-toggle-anchor");
|
|
if (document.body.clientWidth >= 1080) {
|
|
try { sidebar = localStorage.getItem('mdbook-sidebar'); } catch(e) { }
|
|
sidebar = sidebar || 'visible';
|
|
} else {
|
|
sidebar = 'hidden';
|
|
}
|
|
sidebar_toggle.checked = sidebar === 'visible';
|
|
body.classList.remove('sidebar-visible');
|
|
body.classList.add("sidebar-" + sidebar);
|
|
</script>
|
|
|
|
<nav id="sidebar" class="sidebar" aria-label="Table of contents">
|
|
<div class="sidebar-scrollbox">
|
|
<ol class="chapter"><li class="chapter-item expanded affix "><a href="../../index.html">Introduction</a></li><li class="chapter-item expanded "><a href="../../vac/index.html"><strong aria-hidden="true">1.</strong> Vac</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../vac/1/coss.html"><strong aria-hidden="true">1.1.</strong> 1/COSS</a></li><li class="chapter-item expanded "><a href="../../vac/2/mvds.html"><strong aria-hidden="true">1.2.</strong> 2/MVDS</a></li><li class="chapter-item expanded "><a href="../../vac/3/remote-log.html"><strong aria-hidden="true">1.3.</strong> 3/Remote Log</a></li><li class="chapter-item expanded "><a href="../../vac/4/mvds-meta.html"><strong aria-hidden="true">1.4.</strong> 4/MVDS Meta</a></li><li class="chapter-item expanded "><a href="../../vac/25/libp2p-dns-discovery.html"><strong aria-hidden="true">1.5.</strong> 25/Libp2p DNS Discovery</a></li><li class="chapter-item expanded "><a href="../../vac/32/rln-v1.html"><strong aria-hidden="true">1.6.</strong> 32/RLN-V1</a></li><li class="chapter-item expanded "><a href="../../vac/raw/index.html"><strong aria-hidden="true">1.7.</strong> Raw</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../vac/raw/consensus-hashgraphlike.html"><strong aria-hidden="true">1.7.1.</strong> Consensus Hashgraphlike</a></li><li class="chapter-item expanded "><a href="../../vac/raw/decentralized-messaging-ethereum.html"><strong aria-hidden="true">1.7.2.</strong> Decentralized Messaging Ethereum</a></li><li class="chapter-item expanded "><a href="../../vac/raw/eth-mls-offchain.html"><strong aria-hidden="true">1.7.3.</strong> ETH MLS Offchain</a></li><li class="chapter-item expanded "><a href="../../vac/raw/eth-mls-onchain.html"><strong aria-hidden="true">1.7.4.</strong> ETH MLS Onchain</a></li><li class="chapter-item expanded "><a href="../../vac/raw/deleted/eth-secpm.html"><strong aria-hidden="true">1.7.5.</strong> ETH SecPM</a></li><li class="chapter-item expanded "><a href="../../vac/raw/gossipsub-tor-push.html"><strong aria-hidden="true">1.7.6.</strong> Gossipsub Tor Push</a></li><li class="chapter-item expanded "><a href="../../vac/raw/logos-capability-discovery.html"><strong aria-hidden="true">1.7.7.</strong> Logos Capability Discovery</a></li><li class="chapter-item expanded "><a href="../../vac/raw/mix.html"><strong aria-hidden="true">1.7.8.</strong> Mix</a></li><li class="chapter-item expanded "><a href="../../vac/raw/noise-x3dh-double-ratchet.html"><strong aria-hidden="true">1.7.9.</strong> Noise X3DH Double Ratchet</a></li><li class="chapter-item expanded "><a href="../../vac/raw/rln-interep-spec.html"><strong aria-hidden="true">1.7.10.</strong> RLN Interep Spec</a></li><li class="chapter-item expanded "><a href="../../vac/raw/rln-stealth-commitments.html"><strong aria-hidden="true">1.7.11.</strong> RLN Stealth Commitments</a></li><li class="chapter-item expanded "><a href="../../vac/raw/rln-v2.html"><strong aria-hidden="true">1.7.12.</strong> RLN-V2</a></li><li class="chapter-item expanded "><a href="../../vac/raw/sds.html"><strong aria-hidden="true">1.7.13.</strong> SDS</a></li></ol></li><li class="chapter-item expanded "><a href="../../vac/template.html"><strong aria-hidden="true">1.8.</strong> Template</a></li></ol></li><li class="chapter-item expanded "><a href="../../waku/index.html"><strong aria-hidden="true">2.</strong> Waku</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../waku/standards/core/index.html"><strong aria-hidden="true">2.1.</strong> Standards - Core</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../waku/standards/core/10/waku2.html"><strong aria-hidden="true">2.1.1.</strong> 10/Waku2</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/11/relay.html"><strong aria-hidden="true">2.1.2.</strong> 11/Relay</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/12/filter.html"><strong aria-hidden="true">2.1.3.</strong> 12/Filter</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/13/store.html"><strong aria-hidden="true">2.1.4.</strong> 13/Store</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/14/message.html"><strong aria-hidden="true">2.1.5.</strong> 14/Message</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/15/bridge.html"><strong aria-hidden="true">2.1.6.</strong> 15/Bridge</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/17/rln-relay.html"><strong aria-hidden="true">2.1.7.</strong> 17/RLN Relay</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/19/lightpush.html"><strong aria-hidden="true">2.1.8.</strong> 19/Lightpush</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/31/enr.html"><strong aria-hidden="true">2.1.9.</strong> 31/ENR</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/33/discv5.html"><strong aria-hidden="true">2.1.10.</strong> 33/Discv5</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/34/peer-exchange.html"><strong aria-hidden="true">2.1.11.</strong> 34/Peer Exchange</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/36/bindings-api.html"><strong aria-hidden="true">2.1.12.</strong> 36/Bindings API</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/64/network.html"><strong aria-hidden="true">2.1.13.</strong> 64/Network</a></li><li class="chapter-item expanded "><a href="../../waku/standards/core/66/metadata.html"><strong aria-hidden="true">2.1.14.</strong> 66/Metadata</a></li></ol></li><li class="chapter-item expanded "><a href="../../waku/standards/application/index.html"><strong aria-hidden="true">2.2.</strong> Standards - Application</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../waku/standards/application/20/toy-eth-pm.html"><strong aria-hidden="true">2.2.1.</strong> 20/Toy ETH PM</a></li><li class="chapter-item expanded "><a href="../../waku/standards/application/26/payload.html"><strong aria-hidden="true">2.2.2.</strong> 26/Payload</a></li><li class="chapter-item expanded "><a href="../../waku/standards/application/53/x3dh.html"><strong aria-hidden="true">2.2.3.</strong> 53/X3DH</a></li><li class="chapter-item expanded "><a href="../../waku/standards/application/54/x3dh-sessions.html"><strong aria-hidden="true">2.2.4.</strong> 54/X3DH Sessions</a></li></ol></li><li class="chapter-item expanded "><a href="../../waku/standards/legacy/index.html"><strong aria-hidden="true">2.3.</strong> Standards - Legacy</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../waku/standards/legacy/6/waku1.html"><strong aria-hidden="true">2.3.1.</strong> 6/Waku1</a></li><li class="chapter-item expanded "><a href="../../waku/standards/legacy/7/data.html"><strong aria-hidden="true">2.3.2.</strong> 7/Data</a></li><li class="chapter-item expanded "><a href="../../waku/standards/legacy/8/mail.html"><strong aria-hidden="true">2.3.3.</strong> 8/Mail</a></li><li class="chapter-item expanded "><a href="../../waku/standards/legacy/9/rpc.html"><strong aria-hidden="true">2.3.4.</strong> 9/RPC</a></li></ol></li><li class="chapter-item expanded "><a href="../../waku/informational/index.html"><strong aria-hidden="true">2.4.</strong> Informational</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../waku/informational/22/toy-chat.html"><strong aria-hidden="true">2.4.1.</strong> 22/Toy Chat</a></li><li class="chapter-item expanded "><a href="../../waku/informational/23/topics.html"><strong aria-hidden="true">2.4.2.</strong> 23/Topics</a></li><li class="chapter-item expanded "><a href="../../waku/informational/27/peers.html"><strong aria-hidden="true">2.4.3.</strong> 27/Peers</a></li><li class="chapter-item expanded "><a href="../../waku/informational/29/config.html"><strong aria-hidden="true">2.4.4.</strong> 29/Config</a></li><li class="chapter-item expanded "><a href="../../waku/informational/30/adaptive-nodes.html"><strong aria-hidden="true">2.4.5.</strong> 30/Adaptive Nodes</a></li></ol></li><li class="chapter-item expanded "><a href="../../waku/deprecated/index.html"><strong aria-hidden="true">2.5.</strong> Deprecated</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../waku/deprecated/5/waku0.html"><strong aria-hidden="true">2.5.1.</strong> 5/Waku0</a></li><li class="chapter-item expanded "><a href="../../waku/deprecated/16/rpc.html"><strong aria-hidden="true">2.5.2.</strong> 16/RPC</a></li><li class="chapter-item expanded "><a href="../../waku/deprecated/18/swap.html"><strong aria-hidden="true">2.5.3.</strong> 18/Swap</a></li><li class="chapter-item expanded "><a href="../../waku/deprecated/fault-tolerant-store.html"><strong aria-hidden="true">2.5.4.</strong> Fault Tolerant Store</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="../../nomos/index.html"><strong aria-hidden="true">3.</strong> Nomos</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../nomos/raw/index.html"><strong aria-hidden="true">3.1.</strong> Raw</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../nomos/raw/nomosda-encoding.html"><strong aria-hidden="true">3.1.1.</strong> NomosDA Encoding</a></li><li class="chapter-item expanded "><a href="../../nomos/raw/nomosda-network.html"><strong aria-hidden="true">3.1.2.</strong> NomosDA Network</a></li><li class="chapter-item expanded "><a href="../../nomos/raw/p2p-hardware-requirements.html"><strong aria-hidden="true">3.1.3.</strong> P2P Hardware Requirements</a></li><li class="chapter-item expanded "><a href="../../nomos/raw/p2p-nat-solution.html" class="active"><strong aria-hidden="true">3.1.4.</strong> P2P NAT Solution</a></li><li class="chapter-item expanded "><a href="../../nomos/raw/p2p-network-bootstrapping.html"><strong aria-hidden="true">3.1.5.</strong> P2P Network Bootstrapping</a></li><li class="chapter-item expanded "><a href="../../nomos/raw/p2p-network.html"><strong aria-hidden="true">3.1.6.</strong> P2P Network</a></li><li class="chapter-item expanded "><a href="../../nomos/raw/sdp.html"><strong aria-hidden="true">3.1.7.</strong> SDP</a></li></ol></li><li class="chapter-item expanded "><a href="../../nomos/deprecated/index.html"><strong aria-hidden="true">3.2.</strong> Deprecated</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../nomos/deprecated/claro.html"><strong aria-hidden="true">3.2.1.</strong> Claro</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="../../codex/index.html"><strong aria-hidden="true">4.</strong> Codex</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../codex/raw/index.html"><strong aria-hidden="true">4.1.</strong> Raw</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../codex/raw/codex-block-exchange.html"><strong aria-hidden="true">4.1.1.</strong> Block Exchange</a></li><li class="chapter-item expanded "><a href="../../codex/raw/codex-marketplace.html"><strong aria-hidden="true">4.1.2.</strong> Marketplace</a></li></ol></li></ol></li><li class="chapter-item expanded "><a href="../../status/index.html"><strong aria-hidden="true">5.</strong> Status</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../status/24/curation.html"><strong aria-hidden="true">5.1.</strong> 24/Curation</a></li><li class="chapter-item expanded "><a href="../../status/28/featuring.html"><strong aria-hidden="true">5.2.</strong> 28/Featuring</a></li><li class="chapter-item expanded "><a href="../../status/55/1to1-chat.html"><strong aria-hidden="true">5.3.</strong> 55/1-to-1 Chat</a></li><li class="chapter-item expanded "><a href="../../status/56/communities.html"><strong aria-hidden="true">5.4.</strong> 56/Communities</a></li><li class="chapter-item expanded "><a href="../../status/61/community-history-service.html"><strong aria-hidden="true">5.5.</strong> 61/Community History Service</a></li><li class="chapter-item expanded "><a href="../../status/62/payloads.html"><strong aria-hidden="true">5.6.</strong> 62/Payloads</a></li><li class="chapter-item expanded "><a href="../../status/63/keycard-usage.html"><strong aria-hidden="true">5.7.</strong> 63/Keycard Usage</a></li><li class="chapter-item expanded "><a href="../../status/65/account-address.html"><strong aria-hidden="true">5.8.</strong> 65/Account Address</a></li><li class="chapter-item expanded "><a href="../../status/71/push-notification-server.html"><strong aria-hidden="true">5.9.</strong> 71/Push Notification Server</a></li><li class="chapter-item expanded "><a href="../../status/raw/index.html"><strong aria-hidden="true">5.10.</strong> Raw</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../status/raw/simple-scaling.html"><strong aria-hidden="true">5.10.1.</strong> Simple Scaling</a></li><li class="chapter-item expanded "><a href="../../status/raw/status-app-protocols.html"><strong aria-hidden="true">5.10.2.</strong> Status App Protocols</a></li><li class="chapter-item expanded "><a href="../../status/raw/status-mvds.html"><strong aria-hidden="true">5.10.3.</strong> Status MVDS</a></li><li class="chapter-item expanded "><a href="../../status/raw/url-data.html"><strong aria-hidden="true">5.10.4.</strong> URL Data</a></li><li class="chapter-item expanded "><a href="../../status/raw/url-scheme.html"><strong aria-hidden="true">5.10.5.</strong> URL Scheme</a></li></ol></li><li class="chapter-item expanded "><a href="../../status/deprecated/index.html"><strong aria-hidden="true">5.11.</strong> Deprecated</a></li><li><ol class="section"><li class="chapter-item expanded "><a href="../../status/deprecated/3rd-party.html"><strong aria-hidden="true">5.11.1.</strong> 3rd Party</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/account.html"><strong aria-hidden="true">5.11.2.</strong> Account</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/client.html"><strong aria-hidden="true">5.11.3.</strong> Client</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/dapp-browser-API-usage.html"><strong aria-hidden="true">5.11.4.</strong> Dapp Browser API Usage</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/eips.html"><strong aria-hidden="true">5.11.5.</strong> EIPs</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/ethereum-usage.html"><strong aria-hidden="true">5.11.6.</strong> Ethereum Usage</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/group-chat.html"><strong aria-hidden="true">5.11.7.</strong> Group Chat</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/IPFS-gateway-for-sticker-Pack.html"><strong aria-hidden="true">5.11.8.</strong> IPFS Gateway for Sticker Pack</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/keycard-usage-for-wallet-and-chat-keys.html"><strong aria-hidden="true">5.11.9.</strong> Keycard Usage for Wallet and Chat Keys</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/notifications.html"><strong aria-hidden="true">5.11.10.</strong> Notifications</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/payloads.html"><strong aria-hidden="true">5.11.11.</strong> Payloads</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/push-notification-server.html"><strong aria-hidden="true">5.11.12.</strong> Push Notification Server</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/secure-transport.html"><strong aria-hidden="true">5.11.13.</strong> Secure Transport</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/waku-mailserver.html"><strong aria-hidden="true">5.11.14.</strong> Waku Mailserver</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/waku-usage.html"><strong aria-hidden="true">5.11.15.</strong> Waku Usage</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/whisper-mailserver.html"><strong aria-hidden="true">5.11.16.</strong> Whisper Mailserver</a></li><li class="chapter-item expanded "><a href="../../status/deprecated/whisper-usage.html"><strong aria-hidden="true">5.11.17.</strong> Whisper Usage</a></li></ol></li></ol></li></ol>
|
|
</div>
|
|
<div id="sidebar-resize-handle" class="sidebar-resize-handle">
|
|
<div class="sidebar-resize-indicator"></div>
|
|
</div>
|
|
</nav>
|
|
|
|
<!-- Track and set sidebar scroll position -->
|
|
<script>
|
|
var sidebarScrollbox = document.querySelector('#sidebar .sidebar-scrollbox');
|
|
sidebarScrollbox.addEventListener('click', function(e) {
|
|
if (e.target.tagName === 'A') {
|
|
sessionStorage.setItem('sidebar-scroll', sidebarScrollbox.scrollTop);
|
|
}
|
|
}, { passive: true });
|
|
var sidebarScrollTop = sessionStorage.getItem('sidebar-scroll');
|
|
sessionStorage.removeItem('sidebar-scroll');
|
|
if (sidebarScrollTop) {
|
|
// preserve sidebar scroll position when navigating via links within sidebar
|
|
sidebarScrollbox.scrollTop = sidebarScrollTop;
|
|
} else {
|
|
// scroll sidebar to current active section when navigating via "next/previous chapter" buttons
|
|
var activeSection = document.querySelector('#sidebar .active');
|
|
if (activeSection) {
|
|
activeSection.scrollIntoView({ block: 'center' });
|
|
}
|
|
}
|
|
</script>
|
|
|
|
<div id="page-wrapper" class="page-wrapper">
|
|
|
|
<div class="page">
|
|
<div id="menu-bar-hover-placeholder"></div>
|
|
<div id="menu-bar" class="menu-bar sticky">
|
|
<div class="left-buttons">
|
|
<label id="sidebar-toggle" class="icon-button" for="sidebar-toggle-anchor" title="Toggle Table of Contents" aria-label="Toggle Table of Contents" aria-controls="sidebar">
|
|
<i class="fa fa-bars"></i>
|
|
</label>
|
|
<button id="theme-toggle" class="icon-button" type="button" title="Change theme" aria-label="Change theme" aria-haspopup="true" aria-expanded="false" aria-controls="theme-list">
|
|
<i class="fa fa-paint-brush"></i>
|
|
</button>
|
|
<ul id="theme-list" class="theme-popup" aria-label="Themes" role="menu">
|
|
<li role="none"><button role="menuitem" class="theme" id="light">Light</button></li>
|
|
<li role="none"><button role="menuitem" class="theme" id="rust">Rust</button></li>
|
|
<li role="none"><button role="menuitem" class="theme" id="coal">Coal</button></li>
|
|
<li role="none"><button role="menuitem" class="theme" id="navy">Navy</button></li>
|
|
<li role="none"><button role="menuitem" class="theme" id="ayu">Ayu</button></li>
|
|
</ul>
|
|
<button id="search-toggle" class="icon-button" type="button" title="Search. (Shortkey: s)" aria-label="Toggle Searchbar" aria-expanded="false" aria-keyshortcuts="S" aria-controls="searchbar">
|
|
<i class="fa fa-search"></i>
|
|
</button>
|
|
</div>
|
|
|
|
<h1 class="menu-title">Vac RFC</h1>
|
|
|
|
<div class="right-buttons">
|
|
<a href="../../print.html" title="Print this book" aria-label="Print this book">
|
|
<i id="print-button" class="fa fa-print"></i>
|
|
</a>
|
|
<a href="https://github.com/vacp2p/rfc-index" title="Git repository" aria-label="Git repository">
|
|
<i id="git-repository-button" class="fa fa-github"></i>
|
|
</a>
|
|
|
|
</div>
|
|
</div>
|
|
|
|
<div id="search-wrapper" class="hidden">
|
|
<form id="searchbar-outer" class="searchbar-outer">
|
|
<input type="search" id="searchbar" name="searchbar" placeholder="Search this book ..." aria-controls="searchresults-outer" aria-describedby="searchresults-header">
|
|
</form>
|
|
<div id="searchresults-outer" class="searchresults-outer hidden">
|
|
<div id="searchresults-header" class="searchresults-header"></div>
|
|
<ul id="searchresults">
|
|
</ul>
|
|
</div>
|
|
</div>
|
|
|
|
<!-- Apply ARIA attributes after the sidebar and the sidebar toggle button are added to the DOM -->
|
|
<script>
|
|
document.getElementById('sidebar-toggle').setAttribute('aria-expanded', sidebar === 'visible');
|
|
document.getElementById('sidebar').setAttribute('aria-hidden', sidebar !== 'visible');
|
|
Array.from(document.querySelectorAll('#sidebar a')).forEach(function(link) {
|
|
link.setAttribute('tabIndex', sidebar === 'visible' ? 0 : -1);
|
|
});
|
|
</script>
|
|
|
|
<div id="content" class="content">
|
|
<main>
|
|
<h1 id="p2p-nat-solution"><a class="header" href="#p2p-nat-solution">P2P-NAT-SOLUTION</a></h1>
|
|
<div class="rfc-meta">
|
|
<table>
|
|
<tr><th>Name</th><td>Nomos P2P Network NAT Solution Specification</td></tr>
|
|
<tr><th>Status</th><td>raw</td></tr>
|
|
<tr><th>Category</th><td>networking</td></tr>
|
|
<tr><th>Editor</th><td>Antonio Antonino <antonio@status.im></td></tr>
|
|
<tr><th>Contributors</th><td>Álvaro Castro-Castilla <alvaro@status.im><br>Daniel Sanchez-Quiros <danielsq@status.im><br>Petar Radovic <petar@status.im><br>Gusto Bacvinka <augustinas@status.im><br>Youngjoon Lee <youngjoon@status.im><br>Filip Dimitrijevic <filip@status.im></td></tr>
|
|
</table>
|
|
</div>
|
|
<!-- timeline:start -->
|
|
<h2 id="timeline"><a class="header" href="#timeline">Timeline</a></h2>
|
|
<ul>
|
|
<li><strong>2025-12-22</strong> — <a href="https://github.com/vacp2p/rfc-index/blob/b1a578393edf8487ccc97a5f25b25af9bf41efb3/docs/nomos/raw/p2p-nat-solution.md"><code>b1a5783</code></a> — Chore/mdbook updates (#237)</li>
|
|
<li><strong>2025-12-18</strong> — <a href="https://github.com/vacp2p/rfc-index/blob/d03e699084774ebecef9c6d4662498907c5e2080/docs/nomos/raw/p2p-nat-solution.md"><code>d03e699</code></a> — ci: add mdBook configuration (#233)</li>
|
|
<li><strong>2025-09-25</strong> — <a href="https://github.com/vacp2p/rfc-index/blob/cfb3b78c71ed75f7859299c38704b809f3e33613/nomos/raw/p2p-nat-solution.md"><code>cfb3b78</code></a> — Created nomos/raw/p2p-nat-solution.md draft (#174)</li>
|
|
</ul>
|
|
<!-- timeline:end -->
|
|
<h2 id="abstract"><a class="header" href="#abstract">Abstract</a></h2>
|
|
<p>This specification defines a comprehensive NAT (Network Address Translation) traversal solution for the Nomos P2P network. The solution enables nodes to automatically determine their NAT status and establish both outbound and inbound connections regardless of network configuration. The strategy combines <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a>, dynamic port mapping protocols, and continuous verification to maximize public reachability while maintaining decentralized operation.</p>
|
|
<h2 id="motivation"><a class="header" href="#motivation">Motivation</a></h2>
|
|
<p>Network Address Translation presents a critical challenge for Nomos participants, particularly those operating on consumer hardware without technical expertise. The Nomos network requires a NAT traversal solution that:</p>
|
|
<ol>
|
|
<li><strong>Automatic Operation</strong>: Works out-of-the-box without user configuration</li>
|
|
<li><strong>Inclusive Participation</strong>: Enables nodes on consumer hardware to participate effectively</li>
|
|
<li><strong>Decentralized Approach</strong>: Leverages the existing Nomos P2P network rather than centralized services</li>
|
|
<li><strong>Progressive Fallback</strong>: Escalates through increasingly complex protocols as needed</li>
|
|
<li><strong>Dynamic Adaptation</strong>: Handles changing network environments and configurations</li>
|
|
</ol>
|
|
<p>The solution must ensure that nodes can both establish outbound connections and accept inbound connections from other peers, maintaining network connectivity across diverse NAT configurations.</p>
|
|
<h2 id="specification"><a class="header" href="#specification">Specification</a></h2>
|
|
<h3 id="terminology"><a class="header" href="#terminology">Terminology</a></h3>
|
|
<ul>
|
|
<li><strong>Public Node</strong>: A node that is publicly reachable via a public IP address or valid port mapping</li>
|
|
<li><strong>Private Node</strong>: A node that is not publicly reachable due to NAT/firewall restrictions</li>
|
|
<li><strong>Dialing</strong>: The process of establishing a connection using the <a href="https://docs.libp2p.io/">libp2p protocol</a> stack</li>
|
|
<li><strong>NAT Status</strong>: Whether a node is publicly reachable or hidden behind NAT</li>
|
|
</ul>
|
|
<h3 id="key-design-principles"><a class="header" href="#key-design-principles">Key Design Principles</a></h3>
|
|
<h4 id="optional-configuration"><a class="header" href="#optional-configuration">Optional Configuration</a></h4>
|
|
<p>The NAT traversal strategy must work out-of-the-box whenever possible. Users who do not want to engage in configuration should only need to install the node software package. However, users requiring full control must be able to configure every aspect of the strategy.</p>
|
|
<h4 id="decentralized-operation"><a class="header" href="#decentralized-operation">Decentralized Operation</a></h4>
|
|
<p>The solution leverages the existing Nomos P2P network for coordination rather than relying on centralized third-party services. This maintains the decentralized nature of the network while providing necessary NAT traversal capabilities.</p>
|
|
<h4 id="progressive-fallback"><a class="header" href="#progressive-fallback">Progressive Fallback</a></h4>
|
|
<p>The protocol begins with lightweight checks and escalates through more complex and resource-intensive protocols. Failure at any step moves the protocol to the next stage in the strategy, ensuring maximum compatibility across network configurations.</p>
|
|
<h4 id="dynamic-network-environment"><a class="header" href="#dynamic-network-environment">Dynamic Network Environment</a></h4>
|
|
<p>Unless explicitly configured for static addresses, each node's public or private status is assumed to be dynamic. A once publicly-reachable node can become unreachable and vice versa, requiring continuous monitoring and adaptation.</p>
|
|
<h3 id="node-discovery-considerations"><a class="header" href="#node-discovery-considerations">Node Discovery Considerations</a></h3>
|
|
<p>The Nomos public network encourages participation from a large number of nodes, many deployed through simple installation procedures. Some nodes will not achieve Public status, but the discovery protocol must track these peers and allow other nodes to discover them. This prevents network partitioning and ensures Private nodes remain accessible to other participants.</p>
|
|
<h3 id="nat-traversal-protocol"><a class="header" href="#nat-traversal-protocol">NAT Traversal Protocol</a></h3>
|
|
<h4 id="protocol-requirements"><a class="header" href="#protocol-requirements">Protocol Requirements</a></h4>
|
|
<p><strong>Each node MUST:</strong></p>
|
|
<ul>
|
|
<li>Run an <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> client, except for nodes statically configured as Public</li>
|
|
<li>Use the <a href="https://github.com/libp2p/specs/blob/master/identify/README.md">Identify protocol</a> to advertise support for:
|
|
<ul>
|
|
<li><code>/nomos/autonat/2/dial-request</code> for main network</li>
|
|
<li><code>/nomos-testnet/autonat/2/dial-request</code> for public testnet</li>
|
|
<li><code>/nomos/autonat/2/dial-back</code> and <code>/nomos-testnet/autonat/2/dial-back</code> respectively</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
<h4 id="nat-state-machine"><a class="header" href="#nat-state-machine">NAT State Machine</a></h4>
|
|
<p>The NAT traversal process follows a multi-phase state machine:</p>
|
|
<pre><code class="language-mermaid">graph TD
|
|
Start@{shape: circle, label: "Start"} -->|Preconfigured public IP or port mapping| StaticPublic[Statically configured as<br/>**Public**]
|
|
subgraph Phase0 [Phase 0]
|
|
Start -->|Default configuration| Boot
|
|
end
|
|
subgraph Phase1 [Phase 1]
|
|
Boot[Bootstrap and discover AutoNAT servers]--> Inspect
|
|
Inspect[Inspect own IP addresses]-->|At least 1 IP address in the public range| ConfirmPublic[AutoNAT]
|
|
end
|
|
subgraph Phase2 [Phase 2]
|
|
Inspect -->|No IP addresses in the public range| MapPorts[Port Mapping Client<br/>UPnP/NAT-PMP/PCP]
|
|
MapPorts -->|Successful port map| ConfirmMapPorts[AutoNAT]
|
|
end
|
|
ConfirmPublic -->|Node's IP address reachable by AutoNAT server| Public[**Public** Node]
|
|
ConfirmPublic -->|Node's IP address not reachable by AutoNAT server or Timeout| MapPorts
|
|
ConfirmMapPorts -->|Mapped IP address and port reachable by AutoNAT server| Public
|
|
ConfirmMapPorts -->|Mapped IP address and port not reachable by AutoNAT server or Timeout| Private
|
|
MapPorts -->|Failure or Timeout| Private[**Private** Node]
|
|
subgraph Phase3 [Phase 3]
|
|
Public -->Monitor
|
|
Private --> Monitor
|
|
end
|
|
Monitor[Network Monitoring] -->|Restart| Inspect
|
|
</code></pre>
|
|
<h3 id="phase-implementation"><a class="header" href="#phase-implementation">Phase Implementation</a></h3>
|
|
<h4 id="phase-0-bootstrapping-and-identifying-public-nodes"><a class="header" href="#phase-0-bootstrapping-and-identifying-public-nodes">Phase 0: Bootstrapping and Identifying Public Nodes</a></h4>
|
|
<p>If the node is statically configured by the operator to be Public, the procedure stops here.</p>
|
|
<p>The node utilizes bootstrapping and discovery mechanisms to find other Public nodes. The <a href="https://github.com/libp2p/specs/blob/master/identify/README.md">Identify protocol</a> confirms which detected Public nodes support <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT v2</a>.</p>
|
|
<h4 id="phase-1-nat-detection"><a class="header" href="#phase-1-nat-detection">Phase 1: NAT Detection</a></h4>
|
|
<p>The node starts an <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> client and inspects its own addresses. For each public IP address, the node verifies public reachability via <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a>. If any public IP addresses are confirmed, the node assumes Public status and moves to Phase 3. Otherwise, it continues to Phase 2.</p>
|
|
<h4 id="phase-2-automated-port-mapping"><a class="header" href="#phase-2-automated-port-mapping">Phase 2: Automated Port Mapping</a></h4>
|
|
<p>The node attempts to secure port mapping on the default gateway using:</p>
|
|
<ul>
|
|
<li><strong><a href="https://datatracker.ietf.org/doc/html/rfc6887">PCP</a></strong> (Port Control Protocol) - Most reliable</li>
|
|
<li><strong><a href="https://datatracker.ietf.org/doc/html/rfc6886">NAT-PMP</a></strong> (NAT Port Mapping Protocol) - Second most reliable</li>
|
|
<li><strong><a href="https://datatracker.ietf.org/doc/html/rfc6970">UPnP-IGD</a></strong> (Universal Plug and Play Internet Gateway Device) - Most widely deployed</li>
|
|
</ul>
|
|
<p><strong>Port Mapping Algorithm:</strong></p>
|
|
<pre><code class="language-python">def try_port_mapping():
|
|
# Step 1: Get the local IPv4 address
|
|
local_ip = get_local_ipv4_address()
|
|
|
|
# Step 2: Get the default gateway IPv4 address
|
|
gateway_ip = get_default_gateway_address()
|
|
|
|
# Step 3: Abort if local or gateway IP could not be determined
|
|
if not local_ip or not gateway_ip:
|
|
return "Mapping failed: Unable to get local or gateway IPv4"
|
|
|
|
# Step 4: Probe the gateway for protocol support
|
|
supports_pcp = probe_pcp(gateway_ip)
|
|
supports_nat_pmp = probe_nat_pmp(gateway_ip)
|
|
supports_upnp = probe_upnp(gateway_ip) # Optional for logging
|
|
|
|
# Step 5-9: Try protocols in order of reliability
|
|
# PCP (most reliable) -> NAT-PMP -> UPnP -> fallback attempts
|
|
|
|
protocols = [
|
|
(supports_pcp, try_pcp_mapping),
|
|
(supports_nat_pmp, try_nat_pmp_mapping),
|
|
(True, try_upnp_mapping), # Always try UPnP
|
|
(not supports_pcp, try_pcp_mapping), # Fallback
|
|
(not supports_nat_pmp, try_nat_pmp_mapping) # Last resort
|
|
]
|
|
|
|
for supported, mapping_func in protocols:
|
|
if supported:
|
|
mapping = mapping_func(local_ip, gateway_ip)
|
|
if mapping:
|
|
return mapping
|
|
|
|
return "Mapping failed: No protocol succeeded"
|
|
</code></pre>
|
|
<p>If mapping succeeds, the node uses <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> to confirm public reachability. Upon confirmation, the node assumes Public status. Otherwise, it assumes Private status.</p>
|
|
<p><strong>Port Mapping Sequence:</strong></p>
|
|
<pre><code class="language-mermaid">sequenceDiagram
|
|
box Node
|
|
participant AutoNAT Client
|
|
participant NAT State Machine
|
|
participant Port Mapping Client
|
|
end
|
|
participant Router
|
|
|
|
alt Mapping is successful
|
|
Note left of AutoNAT Client: Phase 2
|
|
Port Mapping Client ->> +Router: Requests new mapping
|
|
Router ->> Port Mapping Client: Confirms new mapping
|
|
Port Mapping Client ->> NAT State Machine: Mapping secured
|
|
NAT State Machine ->> AutoNAT Client: Requests confirmation<br/>that mapped address<br/>is publicly reachable
|
|
|
|
alt Node asserts Public status
|
|
AutoNAT Client ->> NAT State Machine: Mapped address<br/>is publicly reachable
|
|
Note left of AutoNAT Client: Phase 3<br/>Network Monitoring
|
|
else Node asserts Private status
|
|
AutoNAT Client ->> NAT State Machine: Mapped address<br/>is not publicly reachable
|
|
Note left of AutoNAT Client: Phase 3<br/>Network Monitoring
|
|
end
|
|
else Mapping fails, node asserts Private status
|
|
Note left of AutoNAT Client: Phase 2
|
|
Port Mapping Client ->> Router: Requests new mapping
|
|
Router ->> Port Mapping Client: Refuses new mapping or Timeout
|
|
Port Mapping Client ->> NAT State Machine: Mapping failed
|
|
Note left of AutoNAT Client: Phase 3<br/>Network Monitoring
|
|
end
|
|
</code></pre>
|
|
<h4 id="phase-3-network-monitoring"><a class="header" href="#phase-3-network-monitoring">Phase 3: Network Monitoring</a></h4>
|
|
<p>Unless explicitly configured, nodes must monitor their network status and restart from Phase 1 when changes are detected.</p>
|
|
<p><strong>Public Node Monitoring:</strong></p>
|
|
<p>A Public node must restart when:</p>
|
|
<ul>
|
|
<li><a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> client no longer confirms public reachability</li>
|
|
<li>A previously successful port mapping is lost or refresh fails</li>
|
|
</ul>
|
|
<p><strong>Private Node Monitoring:</strong></p>
|
|
<p>A Private node must restart when:</p>
|
|
<ul>
|
|
<li>It gains a new public IP address</li>
|
|
<li>Port mapping is likely to succeed (gateway change, sufficient time passed)</li>
|
|
</ul>
|
|
<p><strong>Network Monitoring Sequence:</strong></p>
|
|
<pre><code class="language-mermaid">sequenceDiagram
|
|
participant AutoNAT Server
|
|
box Node
|
|
participant AutoNAT Client
|
|
participant NAT State Machine
|
|
participant Port Mapping Client
|
|
end
|
|
participant Router
|
|
|
|
Note left of AutoNAT Server: Phase 3<br/>Network Monitoring
|
|
par Refresh mapping and monitor changes
|
|
loop periodically refreshes mapping
|
|
Port Mapping Client ->> Router: Requests refresh
|
|
Router ->> Port Mapping Client: Confirms mapping refresh
|
|
end
|
|
break Mapping is lost, the node loses Public status
|
|
Router ->> Port Mapping Client: Refresh failed or mapping dropped
|
|
Port Mapping Client ->> NAT State Machine: Mapping lost
|
|
NAT State Machine ->> NAT State Machine: Restart
|
|
end
|
|
and Monitor public reachability of mapped addresses
|
|
loop periodically checks public reachability
|
|
AutoNAT Client ->> AutoNAT Server: Requests dialback
|
|
AutoNAT Server ->> AutoNAT Client: Dialback successful
|
|
end
|
|
break
|
|
AutoNAT Server ->> AutoNAT Client: Dialback failed or Timeout
|
|
AutoNAT Client ->> NAT State Machine: Public reachability lost
|
|
NAT State Machine ->> NAT State Machine: Restart
|
|
end
|
|
end
|
|
Note left of AutoNAT Server: Phase 1
|
|
</code></pre>
|
|
<h3 id="public-node-responsibilities"><a class="header" href="#public-node-responsibilities">Public Node Responsibilities</a></h3>
|
|
<p><strong>A Public node MUST:</strong></p>
|
|
<ul>
|
|
<li>
|
|
<p>Run an <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> server</p>
|
|
</li>
|
|
<li>
|
|
<p>Listen on and advertise via <a href="https://github.com/libp2p/specs/blob/master/identify/README.md">Identify protocol</a> its publicly reachable <a href="https://github.com/libp2p/specs/blob/master/addressing/README.md">multiaddresses</a>:</p>
|
|
<p><code>/{public_peer_ip}/udp/{port}/quic-v1/p2p/{public_peer_id}</code></p>
|
|
</li>
|
|
<li>
|
|
<p>Periodically renew port mappings according to protocol recommendations</p>
|
|
</li>
|
|
<li>
|
|
<p>Maintain high availability for <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> services</p>
|
|
</li>
|
|
</ul>
|
|
<h3 id="peer-dialing"><a class="header" href="#peer-dialing">Peer Dialing</a></h3>
|
|
<p>Other peers can always dial a Public peer using its publicly reachable <a href="https://github.com/libp2p/specs/blob/master/addressing/README.md">multiaddresses</a>:</p>
|
|
<p><code>/{public_peer_ip}/udp/{port}/quic-v1/p2p/{public_peer_id}</code></p>
|
|
<h2 id="implementation-requirements"><a class="header" href="#implementation-requirements">Implementation Requirements</a></h2>
|
|
<h3 id="mandatory-components"><a class="header" href="#mandatory-components">Mandatory Components</a></h3>
|
|
<p>All Nomos nodes MUST implement:</p>
|
|
<ol>
|
|
<li><strong><a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> client</strong> for NAT status detection</li>
|
|
<li><strong>Port mapping clients</strong> for <a href="https://datatracker.ietf.org/doc/html/rfc6887">PCP</a>, <a href="https://datatracker.ietf.org/doc/html/rfc6886">NAT-PMP</a>, and <a href="https://datatracker.ietf.org/doc/html/rfc6970">UPnP-IGD</a></li>
|
|
<li><strong><a href="https://github.com/libp2p/specs/blob/master/identify/README.md">Identify protocol</a></strong> for capability advertisement</li>
|
|
<li><strong>Network monitoring</strong> for status change detection</li>
|
|
</ol>
|
|
<h3 id="optional-enhancements"><a class="header" href="#optional-enhancements">Optional Enhancements</a></h3>
|
|
<p>Nodes MAY implement:</p>
|
|
<ul>
|
|
<li>Custom port mapping retry strategies</li>
|
|
<li>Enhanced network change detection</li>
|
|
<li>Advanced <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> server load balancing</li>
|
|
<li>Backup connectivity mechanisms</li>
|
|
</ul>
|
|
<h3 id="configuration-parameters"><a class="header" href="#configuration-parameters">Configuration Parameters</a></h3>
|
|
<h4 id="autonat-configuration"><a class="header" href="#autonat-configuration"><a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> Configuration</a></h4>
|
|
<pre><code class="language-yaml">autonat:
|
|
client:
|
|
dial_timeout: 15s
|
|
max_peer_addresses: 16
|
|
throttle_global_limit: 30
|
|
throttle_peer_limit: 3
|
|
server:
|
|
dial_timeout: 30s
|
|
max_peer_addresses: 16
|
|
throttle_global_limit: 30
|
|
throttle_peer_limit: 3
|
|
</code></pre>
|
|
<h4 id="port-mapping-configuration"><a class="header" href="#port-mapping-configuration">Port Mapping Configuration</a></h4>
|
|
<pre><code class="language-yaml">port_mapping:
|
|
pcp:
|
|
timeout: 30s
|
|
lifetime: 7200s # 2 hours
|
|
retry_interval: 300s
|
|
nat_pmp:
|
|
timeout: 30s
|
|
lifetime: 7200s
|
|
retry_interval: 300s
|
|
upnp:
|
|
timeout: 30s
|
|
lease_duration: 7200s
|
|
retry_interval: 300s
|
|
</code></pre>
|
|
<h2 id="security-considerations"><a class="header" href="#security-considerations">Security Considerations</a></h2>
|
|
<h3 id="nat-traversal-security"><a class="header" href="#nat-traversal-security">NAT Traversal Security</a></h3>
|
|
<ol>
|
|
<li><strong>Port Mapping Validation</strong>: Verify that requested port mappings are actually created</li>
|
|
<li><strong><a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> Server Trust</strong>: Implement peer reputation for <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> servers</li>
|
|
<li><strong>Gateway Communication</strong>: Secure communication with NAT devices</li>
|
|
<li><strong>Address Validation</strong>: Validate public addresses before advertisement</li>
|
|
</ol>
|
|
<h3 id="privacy-considerations"><a class="header" href="#privacy-considerations">Privacy Considerations</a></h3>
|
|
<ol>
|
|
<li><strong>IP Address Exposure</strong>: Public nodes necessarily expose IP addresses</li>
|
|
<li><strong>Traffic Analysis</strong>: Monitor for patterns that could reveal node behavior</li>
|
|
<li><strong>Gateway Information</strong>: Minimize exposure of internal network topology</li>
|
|
</ol>
|
|
<h3 id="denial-of-service-protection"><a class="header" href="#denial-of-service-protection">Denial of Service Protection</a></h3>
|
|
<ol>
|
|
<li><strong><a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> Rate Limiting</strong>: Implement request throttling for <a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> services</li>
|
|
<li><strong>Port Mapping Abuse</strong>: Prevent excessive port mapping requests</li>
|
|
<li><strong>Resource Exhaustion</strong>: Limit concurrent NAT traversal attempts</li>
|
|
</ol>
|
|
<h2 id="performance-characteristics"><a class="header" href="#performance-characteristics">Performance Characteristics</a></h2>
|
|
<h3 id="scalability"><a class="header" href="#scalability">Scalability</a></h3>
|
|
<ul>
|
|
<li><strong><a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT</a> Server Load</strong>: Distributed across Public nodes</li>
|
|
<li><strong>Port Mapping Overhead</strong>: Minimal ongoing resource usage</li>
|
|
<li><strong>Network Monitoring</strong>: Efficient periodic checks</li>
|
|
</ul>
|
|
<h3 id="reliability"><a class="header" href="#reliability">Reliability</a></h3>
|
|
<ul>
|
|
<li><strong>Fallback Mechanisms</strong>: Multiple protocols ensure high success rates</li>
|
|
<li><strong>Continuous Monitoring</strong>: Automatic recovery from connectivity loss</li>
|
|
<li><strong>Protocol Redundancy</strong>: Multiple port mapping protocols increase reliability</li>
|
|
</ul>
|
|
<h2 id="references"><a class="header" href="#references">References</a></h2>
|
|
<ol>
|
|
<li><a href="https://github.com/libp2p/specs/blob/master/addressing/README.md">Multiaddress spec</a></li>
|
|
<li><a href="https://github.com/libp2p/specs/blob/master/identify/README.md">Identify protocol spec</a></li>
|
|
<li><a href="https://github.com/libp2p/specs/blob/master/autonat/autonat-v2.md">AutoNAT v2 protocol spec</a></li>
|
|
<li><a href="https://github.com/libp2p/specs/blob/master/relay/circuit-v2.md">Circuit Relay v2 protocol spec</a></li>
|
|
<li><a href="https://datatracker.ietf.org/doc/html/rfc6887">PCP - RFC 6887</a></li>
|
|
<li><a href="https://datatracker.ietf.org/doc/html/rfc6886">NAT-PMP - RFC 6886</a></li>
|
|
<li><a href="https://datatracker.ietf.org/doc/html/rfc6970">UPnP IGD - RFC 6970</a></li>
|
|
</ol>
|
|
<h2 id="copyright"><a class="header" href="#copyright">Copyright</a></h2>
|
|
<p>Copyright and related rights waived via <a href="https://creativecommons.org/publicdomain/zero/1.0/">CC0</a>.</p>
|
|
|
|
</main>
|
|
|
|
<nav class="nav-wrapper" aria-label="Page navigation">
|
|
<!-- Mobile navigation buttons -->
|
|
<a rel="prev" href="../../nomos/raw/p2p-hardware-requirements.html" class="mobile-nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
|
<i class="fa fa-angle-left"></i>
|
|
</a>
|
|
|
|
<a rel="next prefetch" href="../../nomos/raw/p2p-network-bootstrapping.html" class="mobile-nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
|
<i class="fa fa-angle-right"></i>
|
|
</a>
|
|
|
|
<div style="clear: both"></div>
|
|
</nav>
|
|
</div>
|
|
</div>
|
|
|
|
<nav class="nav-wide-wrapper" aria-label="Page navigation">
|
|
<a rel="prev" href="../../nomos/raw/p2p-hardware-requirements.html" class="nav-chapters previous" title="Previous chapter" aria-label="Previous chapter" aria-keyshortcuts="Left">
|
|
<i class="fa fa-angle-left"></i>
|
|
</a>
|
|
|
|
<a rel="next prefetch" href="../../nomos/raw/p2p-network-bootstrapping.html" class="nav-chapters next" title="Next chapter" aria-label="Next chapter" aria-keyshortcuts="Right">
|
|
<i class="fa fa-angle-right"></i>
|
|
</a>
|
|
</nav>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<script>
|
|
window.playground_copyable = true;
|
|
</script>
|
|
|
|
|
|
<script src="../../elasticlunr.min.js"></script>
|
|
<script src="../../mark.min.js"></script>
|
|
<script src="../../searcher.js"></script>
|
|
|
|
<script src="../../clipboard.min.js"></script>
|
|
<script src="../../highlight.js"></script>
|
|
<script src="../../book.js"></script>
|
|
|
|
<!-- Custom JS scripts -->
|
|
<script src="../../scripts/rfc-index.js"></script>
|
|
|
|
|
|
</div>
|
|
</body>
|
|
</html>
|