![](http://piston.readthedocs.io/en/stable/_images/ico-piston-typo.svg)

Pist has now been release in version 0.3.1. Quite some changes have been made that improve the use of piston as a command line tool and as a library.

New:

 - [piston] Support for UTF-8 bodies

   Piston now supports UTF8 encoded bodies (e.g. text). Note that
   permlink does not yet Support UTF-8 such that either

   * the title should be latin encoded, or
   * a latin encoded permlink needs to be provided manually

 - [piston, steem] Allow to decrypt memos and show them in the history

   This call works like this:
   ```
   piston history --types transfer --memos <account>
   ```
   You will be asked to provide the passphrase for your wallet to obtain
   the memo private key (which needs to be added to piston)

 - [piston, steem] add call for convertion of SBD

   This method allows to convert SteemDollar to STEEM using the internal convertion
   rate after 1 week. Note, that when you convert, you will obtain the
   corresponding amount of STEEM only after waiting 1 week. ::

   ```
   piston convert --account <account>
   ```

 - [piston] show account permissions

   Any account permission can be inspected using::

   ```
   piston permissions [<account>]
   ```

   The take the following form::

       +------------+-----------+-----------------------------------------------------------+
       | Permission | Threshold |                                               Key/Account |
       +------------+-----------+-----------------------------------------------------------+
       |      owner |         2 |                                                fabian (1) |
       |            |           | STM7mgtsF5XPU9tokFpEz2zN9sQ89oAcRfcaSkZLsiqfWMtRDNKkc (1) |
       +------------+-----------+-----------------------------------------------------------+
       |     active |         1 | STM6quoHiVnmiDEXyz4fAsrNd28G6q7qBCitWbZGo4pTfQn8SwkzD (1) |
       +------------+-----------+-----------------------------------------------------------+
       |    posting |         1 |                                             streemian (1) |
       |            |           | STM6xpuUdyoRkRJ1GQmrHeNiVC3KGadjrBayo25HaTyBxBCQNwG3j (1) |
       |            |           | STM8aJtoKdTsrRrWg3PB9XsbsCgZbVeDhQS3VUM1jkcXfVSjbv4T8 (1) |
       +------------+-----------+-----------------------------------------------------------+

   The permissions are either **owner** (full control over the account),
   **active** (full control, except for changing the owner), and
   **posting** (for posting and voting). The keys can either be a public
   key or another account name while the number behind shows the weight of
   the entry. If the weight is smaller than the threshold, a single
   signature will not suffice to validate a transaction

 - [piston,steem] allow, disallow access to your account by other accounts (#54)

   Permissions can be changed using:::

    ```
    piston allow --account <account> --weight 1 <foreign_account>
    piston disallow --permission <foreign_account>
    ```

   More details and the default parameters can be found via:::

    ```
    piston allow --help
    piston disallow --help
    ```

 - [piston] allow --tags when 'post'ing using the cli

   You can use this feature like this:

   piston post --file "post.md" --author xeroc --permlink "my-title" --category spam --title "My Title" --tags tag1 tag2 tag3

 - [wallet] allow more advanced key overwrite possibilities for Piston/Steem/Wallet

   Three wallet operation modes are possible:

   * **Wallet Database**: Here, piston loads the keys from the locally stored wallet SQLite database (see ``storage.py``).  To use this mode, simply call ``Steem()`` without the ``keys`` parameter
   * **Providing Keys**: Here, you can provide the keys for your accounts manually. All you need to do is add the wif keys for the accounts you want to use as a simple array using the ``keys`` parameter to ``Steem()``.
   * **Force keys**: This more is for advanced users and requires that you know what you are doing. Here, the ``keys`` parameter is a dictionary that overwrite the ``active``, ``owner``, ``posting`` or ``memo`` keys for any account. This mode is only used for *foreign* signatures!

 - [wallet] no longer support empty passphrases, use UNLOCK environmental variable instead #53

   This can be used like this:
   ```
   UNLOCK="sup3rs3cre7" piston post
   ```

Fixes:

 - [Makefile] Add Tags to changelog post
 - [docs] Added more subcommands to the docs
 - [fix] Why were owner and posting keys mixed up?
 - [fix] addPrivateKey to detect type properly
 - [makefile] No more editing of old posts
 - [makefile] correct release note from tag
 - [piston,steem] do not allow voting on archived posts (waste of throughput)
 - [piston] Add --nowallet call to prevent piston from loading/creating a new wallet
 - [piston] allow @-prefix when setting variable #44
 - [piston] delkey requires confirmation
 - [piston] more easily readable interest payment date
 - [robustness] don't fail if things go wrong on total_payout_value
 - [setup] remove steem/graphene from additional requirements
 - [steem,piston] move account_history into python-steem and correct parameter name
 - [steem] allow to provide multiple tags instead of just a category
 - [steem] clarify _connect() only for internal use #47
 - [steem] ensure debug and nobroadcast from parameters
 - [steem] fix #41
 - [steem] fix loop_account_history and define rational defaults
 - [steem] move WebSteem to piston.steem.SteemConnector
 - [ui]: Allow to list custom columns.
 - [wallet] properly compare keys from graphene and steem
 - [web] add missing browser-none.html file
 - [web] allow multiple tags for new posts, remove tags from reply post

## Howto Update

Via pip:

    pip3 install steem-piston --upgrade   [--user]

or via git:

    git fetch origin
    git checkout 0.3.1
    make install-user