From 4f51d4f3f5b72d31fab2494641c16dba7293d314 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Piotr=20W=C5=82odarek?= Date: Tue, 2 Jan 2018 16:22:23 +0100 Subject: [PATCH] Add "Interacting" --- docs/directory/overview.md | 19 ---------- docs/{directory => interacting}/monerod.md | 3 ++ docs/interacting/overview.md | 42 ++++++++++++++++++++++ docs/tx.md | 4 +++ mkdocs.yml | 12 +++---- 5 files changed, 55 insertions(+), 25 deletions(-) delete mode 100644 docs/directory/overview.md rename docs/{directory => interacting}/monerod.md (72%) create mode 100644 docs/interacting/overview.md create mode 100644 docs/tx.md diff --git a/docs/directory/overview.md b/docs/directory/overview.md deleted file mode 100644 index 59eeabe..0000000 --- a/docs/directory/overview.md +++ /dev/null @@ -1,19 +0,0 @@ -# Monero directory overview - -This considers the released version of Monero software. Once unpacked, directory structure looks like: - -![Monero Directory](/images/monero-dir.png "Logo Title Text 1") - -## Separation of node and wallet - -Monero project nicely decouples node logic `monerod` from wallet logic `monero-wallet-*`. -Wallet logic is offered through three independent user interfaces - the GUI, the CLI, and the HTTP API. - -| Executable | Description -| -------------------------- |:----------------------------------------------------------------------------------------------------------------------------------- -| `monerod` | The full node daemon. Does not require a wallet. -| `monero-wallet-gui` | Wallet logic and graphical user interface. Requires `monerod` running. -| `monero-wallet-cli` | Wallet logic and commandline user interface. Requires `monerod` running. -| `monero-wallet-rpc` | Wallet logic and HTTP API (JSON-RPC protocol). Requires `monerod` running. -| `monero-blockchain-export` | Tool to export synchronized blockchain to `blockchain.raw` file. -| `monero-blockchain-import` | Tool to import [blockchain.raw](https://downloads.getmonero.org/blockchain.raw) - ideally your own trusted copy. diff --git a/docs/directory/monerod.md b/docs/interacting/monerod.md similarity index 72% rename from docs/directory/monerod.md rename to docs/interacting/monerod.md index 8f7af4f..7c3360a 100644 --- a/docs/directory/monerod.md +++ b/docs/interacting/monerod.md @@ -2,4 +2,7 @@ https://www.reddit.com/r/Monero/comments/3jhyqc/0mq_help_share_this_exciting_news/ +https://monero.stackexchange.com/questions/1482/how-much-information-is-passed-from-the-daemon-to-simplewallet-when-scanning-for?rq=1 +https://monero.stackexchange.com/questions/1134/is-it-safe-to-share-a-daemon-with-a-roommate?noredirect=1&lq=1 + The Monero daemon is the piece of software that keeps you synced up with the Monero network. That's all it does, it doesn't know about "you" or "your funds" or "your transactions". If you want to do anything on the Monero network, and thus on the Monero blockchain, you have to talk to this daemon that will then talk to the network as a whole by rebroadcasting transactions you initiate. Similarly, if you want to get history from the blockchain, or the current memory pool of transactions, or outputs to mix with, you can ask the daemon for that information. diff --git a/docs/interacting/overview.md b/docs/interacting/overview.md new file mode 100644 index 0000000..266cb18 --- /dev/null +++ b/docs/interacting/overview.md @@ -0,0 +1,42 @@ +# Interacting with Monero + +You can interact with Monero via desktop GUI, commandline interface, and programming API. + +On top of that, Monero nodes interact with each other in a peer-to-peer network. + +## Installation directory overview + +This considers the released version of Monero software. Once unpacked, you will notice six executable files: + +![Monero Directory](/images/monero-dir.png "Logo Title Text 1") + +## Separation of node and wallet + +Monero project nicely decouples node logic `monerod` from wallet logic `monero-wallet-*`. +Wallet logic is offered through three independent user interfaces - the GUI, the CLI, and the HTTP API. + +| Executable | Description +| -------------------------- |:----------------------------------------------------------------------------------------------------------------------------------- +| `monerod` | The full node daemon. Does not require a wallet. +| `monero-wallet-gui` | Wallet logic and __graphical__ user interface. Requires `monerod` running. +| `monero-wallet-cli` | Wallet logic and __commandline__ user interface. Requires `monerod` running. +| `monero-wallet-rpc` | Wallet logic and __HTTP API__ (JSON-RPC protocol). Requires `monerod` running. +| `monero-blockchain-export` | Tool to export blockchain to `blockchain.raw` file. +| `monero-blockchain-import` | Tool to import [blockchain.raw](https://downloads.getmonero.org/blockchain.raw) - ideally your own trusted copy. + +## Interacting + +There are quite a few ways you can interact with Monero software. +Perhaps the most surprising for newcomers is that `monerod` daemon accepts interactive keyboard commands while it is running. + +Also, please note that HTTP API is split across `monerod` and `monero-wallet-rpc`. You need to run and call both daemons to explore the full API. +This follows the node-logic vs wallet-logic split mentioned earlier. + +All wallet implementations depend on the `monerod` running. + +| Executable | p2p network | node commands via keyboard | node HTTP API | wallet commands via keyboard | wallet HTTP API | wallet via GUI +| -------------------------- | ------------------- | -------------------------- | ------------- | ---------------------------- | --------------- | -------------- +| `monerod` | ✔ | ✔ | ✔ | | | +| `monero-wallet-cli` | | | | ✔ | | +| `monero-wallet-rpc` | | | | | ✔ | +| `monero-wallet-gui` | | | | | | ✔ diff --git a/docs/tx.md b/docs/tx.md new file mode 100644 index 0000000..da54b50 --- /dev/null +++ b/docs/tx.md @@ -0,0 +1,4 @@ +# Monero transaction + +https://monero.stackexchange.com/questions/2136/understanding-the-structure-of-a-monero-transaction?noredirect=1&lq=1 +https://monero.stackexchange.com/questions/6736/how-does-input-reference-the-output-of-some-transaction?noredirect=1&lq=1 diff --git a/mkdocs.yml b/mkdocs.yml index c12a233..5ba55f9 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -6,15 +6,15 @@ site_url: 'https://monerodocs.org/' pages: - Home: 'index.md' +- Interacting: 'interacting/overview.md' - Technical Specs: 'technical-specs.md' - Primitives: - - 'Base58': 'primitives/base58.md' + - Base58: 'primitives/base58.md' - Address: - - 'Standard': 'public-address/standard-address.md' - - 'Integrated': 'public-address/integrated-address.md' - - 'Subaddress': 'public-address/subaddress.md' -- 'Multisignature': 'multisignature.md' -- 'Directory': 'directory/overview.md' + - Standard: 'public-address/standard-address.md' + - Integrated: 'public-address/integrated-address.md' + - Subaddress: 'public-address/subaddress.md' +- Multisignature: 'multisignature.md' theme: name: 'material' # 'material'