Update docs
This commit is contained in:
parent
d9c68a86c6
commit
c51e3672a6
|
@ -67,6 +67,20 @@ We may use a subaddress too:
|
|||
These two classes, ``Address`` and ``SubAddress`` have similar functionality
|
||||
but one significant difference. Only the former may form *integrated address*.
|
||||
|
||||
Generating subaddresses
|
||||
-----------------------
|
||||
|
||||
It is possible to get subaddresses in two ways:
|
||||
|
||||
1. Creating them in the wallet file by calling ``.new_address()`` on ``Account`` or ``Wallet``
|
||||
instance. In properly synced wallet this will return an address that is guaranteed to be fresh
|
||||
and unused. It is the right way if you plan to use one-time addresses to identify payments or
|
||||
to improve your privacy by avoiding address reuse.
|
||||
2. Requesting arbitrary subaddress by calling ``Wallet.get_address(major, minor)`` where ``major``
|
||||
is the account index and ``minor`` is the index of the address within an account. Addresses
|
||||
obtained this way are not guaranteed to be fresh and **will not be saved as already generated
|
||||
within the wallet file**. (Watch out for unintentional address reuse!)
|
||||
|
||||
Payment IDs and integrated addresses
|
||||
------------------------------------
|
||||
|
||||
|
|
|
@ -2,8 +2,10 @@ Backends
|
|||
========
|
||||
|
||||
Backends are the protocols and methods used to communicate with the Monero daemon and interact with
|
||||
the wallet. As of the time of this writing, the only backend available in this library is for the
|
||||
HTTP based RPC server.
|
||||
the wallet. As of the time of this writing, the only backends available in this library are:
|
||||
|
||||
* ``jsonrpc`` for the HTTP based RPC server,
|
||||
* ``offline`` for running the wallet without Internet connection and even without the wallet file.
|
||||
|
||||
JSON RPC
|
||||
----------------
|
||||
|
@ -20,9 +22,22 @@ the official `Wallet RPC`_ documentation.
|
|||
|
||||
.. _`Wallet RPC`: https://getmonero.org/resources/developer-guides/wallet-rpc.html
|
||||
|
||||
|
||||
API reference
|
||||
-------------
|
||||
|
||||
.. automodule:: monero.backends.jsonrpc
|
||||
:members:
|
||||
|
||||
Offline
|
||||
----------------
|
||||
|
||||
This backend allows creating a `Wallet` instance without network connection or even without the
|
||||
wallet itself. In version 0.5 the only practical use is to cold-generate
|
||||
:doc:`subaddresses <address>` like in the example below:
|
||||
|
||||
.. code-block:: python
|
||||
|
||||
In [8]: w = Wallet(OfflineWallet('47ewoP19TN7JEEnFKUJHAYhGxkeTRH82sf36giEp9AcNfDBfkAtRLX7A6rZz18bbNHPNV7ex6WYbMN3aKisFRJZ8Ebsmgef', view_key='6d9056aa2c096bfcd2f272759555e5764ba204dd362604a983fa3e0aafd35901'))
|
||||
|
||||
In [9]: w.get_address(100,37847)
|
||||
Out[9]: 883Gcsq65iqh4UL3fJTWLxY45skXyFVNQJZ4bdw4TJcqd8vafvtpX4p6HNmawqFMQ6TwJP7adzyLT1fbU6z1n9dqB9bJrfn
|
||||
|
||||
.. automodule:: monero.backends.offline
|
||||
:members:
|
||||
|
|
|
@ -15,7 +15,7 @@ planned as well.
|
|||
Project homepage: https://github.com/emesik/monero-python
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 1
|
||||
:maxdepth: 2
|
||||
:caption: Contents:
|
||||
|
||||
quickstart
|
||||
|
|
Loading…
Reference in New Issue