From d2247103cf82639fb50adb2c2d9780e9cb3cddfc Mon Sep 17 00:00:00 2001 From: anonimal Date: Tue, 18 Oct 2016 10:13:55 +0000 Subject: [PATCH] Moneropedia: update/finish initial Kovri entry Also: - adjust the case for all applicable terms - minor clarification in canonically-unique-host - add @encryption for several references to encryption Referencing: - monero-project/kovri#256 - monero-project/monero-site#155 --- knowledge-base/moneropedia/address-book.md | 2 +- knowledge-base/moneropedia/base32-address.md | 2 +- knowledge-base/moneropedia/base64-address.md | 2 +- .../moneropedia/canonically-unique-host.md | 8 +- knowledge-base/moneropedia/clearnet.md | 2 +- knowledge-base/moneropedia/data-directory.md | 2 +- knowledge-base/moneropedia/destination.md | 2 +- knowledge-base/moneropedia/eepsite.md | 2 +- knowledge-base/moneropedia/floodfill.md | 2 +- knowledge-base/moneropedia/garlic-routing.md | 6 +- knowledge-base/moneropedia/i2np.md | 2 +- knowledge-base/moneropedia/i2pcontrol.md | 2 +- knowledge-base/moneropedia/in-net.md | 2 +- knowledge-base/moneropedia/jump-service.md | 2 +- knowledge-base/moneropedia/kovri.md | 94 ++++++++----------- .../moneropedia/layered-encryption.md | 2 +- knowledge-base/moneropedia/lease.md | 2 +- .../moneropedia/locally-unique-host.md | 2 +- .../moneropedia/network-database.md | 2 +- knowledge-base/moneropedia/reseed.md | 2 +- knowledge-base/moneropedia/router-info.md | 2 +- knowledge-base/moneropedia/subscription.md | 2 +- knowledge-base/moneropedia/transports.md | 2 +- knowledge-base/moneropedia/tunnel.md | 2 +- 24 files changed, 68 insertions(+), 82 deletions(-) diff --git a/knowledge-base/moneropedia/address-book.md b/knowledge-base/moneropedia/address-book.md index 3c03a160..b614bea7 100644 --- a/knowledge-base/moneropedia/address-book.md +++ b/knowledge-base/moneropedia/address-book.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Address Book" tags: ["kovri"] -terms: ["address-book"] +terms: ["Address-Book"] summary: "Allows you to visit I2P websites/services that have the .i2p domain" --- diff --git a/knowledge-base/moneropedia/base32-address.md b/knowledge-base/moneropedia/base32-address.md index b2482982..10284db5 100644 --- a/knowledge-base/moneropedia/base32-address.md +++ b/knowledge-base/moneropedia/base32-address.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Base32 address" tags: ["kovri"] -terms: ["base32-address", "base32-addresses"] +terms: ["Base32-address", "Base32-addresses"] summary: "Base32 encoded hash of a Base64 address" --- diff --git a/knowledge-base/moneropedia/base64-address.md b/knowledge-base/moneropedia/base64-address.md index 9bd1e7bc..99b85727 100644 --- a/knowledge-base/moneropedia/base64-address.md +++ b/knowledge-base/moneropedia/base64-address.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Base64 address" tags: ["kovri"] -terms: ["base64-address", "base64-addresses"] +terms: ["Base64-address", "Base64-addresses"] summary: "Base64 encoded I2P destination" --- diff --git a/knowledge-base/moneropedia/canonically-unique-host.md b/knowledge-base/moneropedia/canonically-unique-host.md index a2335d12..dfb606a6 100644 --- a/knowledge-base/moneropedia/canonically-unique-host.md +++ b/knowledge-base/moneropedia/canonically-unique-host.md @@ -2,17 +2,17 @@ layout: moneropedia entry: "Canonically-unique host" tags: ["kovri"] -terms: ["canonically-unique-host"] +terms: ["Canonically-unique-host"] summary: "A host that is canonically resolved to an address or set of addresses" --- ### The Basics -A canonically-unique host is a [FQDN](https://en.wikipedia.org/wiki/FQDN) that will canonically resolve to a designated address or set of addresses. Not to be confused with a @locally-unique-host. +A Canonically-unique host is a [FQDN](https://en.wikipedia.org/wiki/FQDN) that will canonically resolve to a designated address or set of addresses. Not to be confused with a @locally-unique-host. ### In-depth information -A canonically-unique host is defined by remote authoritative sources; usually through [DNS](https://en.wikipedia.org/wiki/DNS). When resolving a peer's hostname, you will most likely use an external source for resolution unless have the following implemented: +A Canonically-unique host is defined by remote authoritative sources; usually through [DNS](https://en.wikipedia.org/wiki/DNS). When resolving a peer's hostname, you will most likely use an external source for resolution unless have the following implemented: - a database file similar to a [hosts file](https://en.wikipedia.org/wiki/etc/hosts) - an internal-network resolver (which eventually pulls from external sources) @@ -20,4 +20,4 @@ A canonically-unique host is defined by remote authoritative sources; usually th ### Notes - Monero primarily uses @canonically-unique-host resolution while @I2P only uses @locally-unique-host resolution. -- @I2P's and @Kovri's assigned top-level domain is currently `.i2p` and @Kovri intends to only process/use the `.i2p` [top-level domain](https://en.wikipedia.org/wiki/Top_level_domain) +- @I2P's and @Kovri's self-assigned top-level domain is currently `.i2p` and @Kovri intends to only process/use the `.i2p` [top-level domain](https://en.wikipedia.org/wiki/Top_level_domain) diff --git a/knowledge-base/moneropedia/clearnet.md b/knowledge-base/moneropedia/clearnet.md index b36b0a0b..85678268 100644 --- a/knowledge-base/moneropedia/clearnet.md +++ b/knowledge-base/moneropedia/clearnet.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Clearnet" tags: ["kovri"] -terms: ["clearnet"] +terms: ["Clearnet"] summary: "The internet in which anonymous overlay networks are built upon" --- diff --git a/knowledge-base/moneropedia/data-directory.md b/knowledge-base/moneropedia/data-directory.md index 4aff4444..e66f6959 100644 --- a/knowledge-base/moneropedia/data-directory.md +++ b/knowledge-base/moneropedia/data-directory.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Data Directory" tags: ["kovri"] -terms: ["data-directory"] +terms: ["Data-Directory"] summary: "Where essential kovri data for runtime is stored" --- diff --git a/knowledge-base/moneropedia/destination.md b/knowledge-base/moneropedia/destination.md index b93324f3..91237681 100644 --- a/knowledge-base/moneropedia/destination.md +++ b/knowledge-base/moneropedia/destination.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Destination" tags: ["kovri"] -terms: ["destination"] +terms: ["Destination"] summary: "A in-net address that serves as a final endpoint" --- diff --git a/knowledge-base/moneropedia/eepsite.md b/knowledge-base/moneropedia/eepsite.md index ddfd3dee..5fbb9545 100644 --- a/knowledge-base/moneropedia/eepsite.md +++ b/knowledge-base/moneropedia/eepsite.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Eepsite" tags: ["kovri"] -terms: ["eepsite", "hidden-service", "garlic-site", "garlic-service"] +terms: ["Eepsite", "Hidden-Service", "Garlic-Site", "Garlic-Service"] summary: "A website or service hosted within the I2P network" --- diff --git a/knowledge-base/moneropedia/floodfill.md b/knowledge-base/moneropedia/floodfill.md index ca3164b4..e3fbf54f 100644 --- a/knowledge-base/moneropedia/floodfill.md +++ b/knowledge-base/moneropedia/floodfill.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Floodfill" tags: ["kovri"] -terms: ["floodfill"] +terms: ["Floodfill"] summary: "An I2P router which maintains a distributed network-database" --- diff --git a/knowledge-base/moneropedia/garlic-routing.md b/knowledge-base/moneropedia/garlic-routing.md index 8bea7607..13596f59 100644 --- a/knowledge-base/moneropedia/garlic-routing.md +++ b/knowledge-base/moneropedia/garlic-routing.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Garlic Routing" tags: ["kovri"] -terms: ["garlic-routing"] +terms: ["Garlic-Routing"] summary: "Routing technology as implemented in Kovri" --- @@ -31,9 +31,9 @@ Note: permission to use the aforementioned quotes were granted by Nick Mathewson In technical terms, for @Kovri and @I2P, *Garlic Routing* translates to any/all of the following: -- Layered Encryption (like Onion Routing) +- @Layered-Encryption (like Onion Routing) - Bundling multiple @messages together (garlic cloves) -- ElGamal/AES Encryption +- ElGamal/AES @encryption Note: though [Tor](https://torproject.org/) uses layered @encryption, Tor does not use ElGamal and is not message-based. diff --git a/knowledge-base/moneropedia/i2np.md b/knowledge-base/moneropedia/i2np.md index 59dd721d..e63effb3 100644 --- a/knowledge-base/moneropedia/i2np.md +++ b/knowledge-base/moneropedia/i2np.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "I2NP" tags: ["kovri"] -terms: ["I2NP", "message", "messages"] +terms: ["I2NP", "Message", "Messages"] summary: "TODO(anonimal): finish" --- diff --git a/knowledge-base/moneropedia/i2pcontrol.md b/knowledge-base/moneropedia/i2pcontrol.md index 79505fd6..9ccbaee0 100644 --- a/knowledge-base/moneropedia/i2pcontrol.md +++ b/knowledge-base/moneropedia/i2pcontrol.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "I2PControl" tags: ["kovri"] -terms: ["i2pcontrol", "I2PControl"] +terms: ["I2PControl"] summary: "TODO(anonimal): finish" --- diff --git a/knowledge-base/moneropedia/in-net.md b/knowledge-base/moneropedia/in-net.md index d2177652..92404f08 100644 --- a/knowledge-base/moneropedia/in-net.md +++ b/knowledge-base/moneropedia/in-net.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "In-net" tags: ["kovri"] -terms: ["in-net"] +terms: ["In-net"] summary: "Within the I2P network" --- diff --git a/knowledge-base/moneropedia/jump-service.md b/knowledge-base/moneropedia/jump-service.md index 286ad44a..aa8e72ac 100644 --- a/knowledge-base/moneropedia/jump-service.md +++ b/knowledge-base/moneropedia/jump-service.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Jump Service" tags: ["kovri"] -terms: ["jump-service"] +terms: ["Jump-Service"] summary: "An I2P website service that adds addresses to your address book" --- diff --git a/knowledge-base/moneropedia/kovri.md b/knowledge-base/moneropedia/kovri.md index fe89dd05..b8840052 100644 --- a/knowledge-base/moneropedia/kovri.md +++ b/knowledge-base/moneropedia/kovri.md @@ -8,68 +8,54 @@ summary: "Monero's C++ router implementation of the I2P network" ### The Basics -TODO(anonimal): finish +[Kovri](https://github.com/monero-project/kovri/) is a C++ implementation of the @I2P network. @Kovri is currently in heavy, active development and not yet integrated with Monero. When Kovri is integrated into your Monero @node, your transactions will be more secure than ever before. ### In-depth information -TODO(anonimal): finish +Kovri will protect you and Monero from: -@address-book +- @Node partitioning attacks +- Associations between a particular txid and your IP address +- Mining and/or running a node in highly adversarial environments +- Metadata leakage (e.g., @OpenAlias lookups) -@base32-address +...and much more. -@base64-address +Read [anonimal's FFS proposal](https://forum.getmonero.org/9/work-in-progress/86967/anonimal-s-kovri-full-time-development-funding-thread) for more details and for reasoning behind the project. Also read the FAQ and User Guide in the [Kovri repository](https://github.com/monero-project/kovri/). -@canonically-unique-host +### @Kovri / @I2P Terminology -@clearnet +#### Client + API -@data-directory +- @Address-Book +- @Base32-address +- @Base64-address +- @Canonically-unique-host +- @Eepsite (@Hidden-Service, @Garlic-Site, @Garlic-Service) +- @I2PControl +- @Jump-Service +- @Locally-unique-host +- @Reseed +- @Subscription -@destination +#### Core + Router -@eepsite (@hidden-service, @garlic-site, @garlic-service) - -@encryption - -@floodfill - -@garlic-routing - -@I2PControl - -@i2np - -@i2p - -@in-net - -@java-i2p - -@jump-service - -@kovri - -@lease - -@leaseset - -@locally-unique-host - -@message @messages - -@network-database - -@NTCP - -@reseed - -@router-info - -@SSU - -@subscription - -@transports - -@tunnel +- @Clearnet +- @Data-Directory +- @Destination +- @Encryption +- @Floodfill +- @Garlic-routing +- @I2NP +- @In-net +- @Java-I2P +- @Layered-Encryption +- @Lease +- @LeaseSet +- @Message @Messages +- @NTCP +- @Network-Database +- @Router-Info +- @SSU +- @Transports +- @Tunnel diff --git a/knowledge-base/moneropedia/layered-encryption.md b/knowledge-base/moneropedia/layered-encryption.md index d01241ec..37344c97 100644 --- a/knowledge-base/moneropedia/layered-encryption.md +++ b/knowledge-base/moneropedia/layered-encryption.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Layered Encryption" tags: ["kovri"] -terms: ["layered-encryption"] +terms: ["Layered-Encryption"] summary: "TODO(anonimal): finish" --- diff --git a/knowledge-base/moneropedia/lease.md b/knowledge-base/moneropedia/lease.md index f3234d8c..d3cdc545 100644 --- a/knowledge-base/moneropedia/lease.md +++ b/knowledge-base/moneropedia/lease.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Lease" tags: ["kovri"] -terms: ["lease", "leases"] +terms: ["Lease", "Leases"] summary: "Authorizes an I2P tunnel to receive messages targeting a destination" --- diff --git a/knowledge-base/moneropedia/locally-unique-host.md b/knowledge-base/moneropedia/locally-unique-host.md index d979e2d3..3ce7f860 100644 --- a/knowledge-base/moneropedia/locally-unique-host.md +++ b/knowledge-base/moneropedia/locally-unique-host.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Locally-unique host" tags: ["kovri"] -terms: ["locally-unique-host"] +terms: ["Locally-unique-host"] summary: "A host defined by you and resolved only by you" --- diff --git a/knowledge-base/moneropedia/network-database.md b/knowledge-base/moneropedia/network-database.md index 6aea989e..64f74b5d 100644 --- a/knowledge-base/moneropedia/network-database.md +++ b/knowledge-base/moneropedia/network-database.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Network Database" tags: ["kovri"] -terms: ["network-database"] +terms: ["Network-Database"] summary: "TODO(anonimal): finish" --- diff --git a/knowledge-base/moneropedia/reseed.md b/knowledge-base/moneropedia/reseed.md index 35611f4d..932c3be2 100644 --- a/knowledge-base/moneropedia/reseed.md +++ b/knowledge-base/moneropedia/reseed.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Reseed" tags: ["kovri"] -terms: ["reseed"] +terms: ["Reseed"] summary: "The method of which Kovri uses to bootstrap into the I2P network" --- diff --git a/knowledge-base/moneropedia/router-info.md b/knowledge-base/moneropedia/router-info.md index 97455e46..ce229517 100644 --- a/knowledge-base/moneropedia/router-info.md +++ b/knowledge-base/moneropedia/router-info.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Router-Info" tags: ["kovri"] -terms: ["router-info"] +terms: ["Router-Info"] summary: "A data structure or file which contains an I2P peer's needed network information" --- diff --git a/knowledge-base/moneropedia/subscription.md b/knowledge-base/moneropedia/subscription.md index 3848b541..3c88e15d 100644 --- a/knowledge-base/moneropedia/subscription.md +++ b/knowledge-base/moneropedia/subscription.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Subscription" tags: ["kovri"] -terms: ["subscription"] +terms: ["Subscription"] summary: "A file used by address book which contains I2P hosts paired with I2P destinations" --- diff --git a/knowledge-base/moneropedia/transports.md b/knowledge-base/moneropedia/transports.md index 71105c7f..4cc6268b 100644 --- a/knowledge-base/moneropedia/transports.md +++ b/knowledge-base/moneropedia/transports.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Transports" tags: ["kovri"] -terms: ["transports", "transport"] +terms: ["Transports", "Transport"] summary: "The two encrypted transport layers for Kovri" --- diff --git a/knowledge-base/moneropedia/tunnel.md b/knowledge-base/moneropedia/tunnel.md index b0891cec..eaa154e4 100644 --- a/knowledge-base/moneropedia/tunnel.md +++ b/knowledge-base/moneropedia/tunnel.md @@ -2,7 +2,7 @@ layout: moneropedia entry: "Tunnel" tags: ["kovri"] -terms: ["tunnel", "tunnels"] +terms: ["Tunnel", "Tunnels"] summary: "TODO(anonimal): finish" ---