*********
Tutorials
*********

Bundle Many Operations
----------------------

With PeerPlays, you can bundle multiple operations into a single
transactions. This can be used to do a multi-send (one sender, multiple
receivers), but it also allows to use any other kind of operation. The
advantage here is that the user can be sure that the operations are
executed in the same order as they are added to the transaction.

.. code-block:: python

  from pprint import pprint
  from peerplays import PeerPlays

  testnet = PeerPlays(
      "wss://node.testnet.peerplays.eu",
      nobroadcast=True,
      bundle=True,
  )

  testnet.wallet.unlock("supersecret")

  testnet.transfer("init0", 1, "TEST", account="xeroc")
  testnet.transfer("init1", 1, "TEST", account="xeroc")
  testnet.transfer("init2", 1, "TEST", account="xeroc")
  testnet.transfer("init3", 1, "TEST", account="xeroc")

  pprint(testnet.broadcast())


Proposing a Transaction
-----------------------

In PeerPlays, you can propose a transactions to any account. This is
used to facilitate on-chain multisig transactions. With
python-peerplays, you can do this simply by using the ``proposer``
attribute:

.. code-block:: python

  from pprint import pprint
  from peerplays import PeerPlays

  testnet = PeerPlays(
      "wss://node.testnet.peerplays.eu",
      proposer="xeroc"
  )
  testnet.wallet.unlock("supersecret")
  pprint(testnet.transfer("init0", 1, "TEST", account="xeroc"))

Simple Sell Script
------------------

.. code-block:: python

    from peerplays import PeerPlays
    from peerplays.market import Market
    from peerplays.price import Price
    from peerplays.amount import Amount

    #
    # Instanciate PeerPlays (pick network via API node)
    #
    peerplays = PeerPlays(
        "wss://node.testnet.peerplays.eu",
        nobroadcast=True   # <<--- set this to False when you want to fire!
    )

    #
    # Unlock the Wallet
    #
    peerplays.wallet.unlock("<supersecret>")

    #
    # This defines the market we are looking at.
    # The first asset in the first argument is the *quote*
    # Sell and buy calls always refer to the *quote*
    #
    market = Market(
        "GOLD:USD",
        peerplays_instance=peerplays
    )

    #
    # Sell an asset for a price with amount (quote)
    #
    print(market.sell(
        Price(100.0, "USD/GOLD"),
        Amount("0.01 GOLD")
    ))


Sell at a timely rate
---------------------

.. code-block:: python

    import threading
    from peerplays import PeerPlays
    from peerplays.market import Market
    from peerplays.price import Price
    from peerplays.amount import Amount


    def sell():
        """ Sell an asset for a price with amount (quote)
        """
        print(market.sell(
            Price(100.0, "USD/GOLD"),
            Amount("0.01 GOLD")
        ))

        threading.Timer(60, sell).start()


    if __name__ == "__main__":
        #
        # Instanciate PeerPlays (pick network via API node)
        #
        peerplays = PeerPlays(
            "wss://node.testnet.peerplays.eu",
            nobroadcast=True   # <<--- set this to False when you want to fire!
        )

        #
        # Unlock the Wallet
        #
        peerplays.wallet.unlock("<supersecret>")

        #
        # This defines the market we are looking at.
        # The first asset in the first argument is the *quote*
        # Sell and buy calls always refer to the *quote*
        #
        market = Market(
            "GOLD:USD",
            peerplays_instance=peerplays
        )

        sell()