Multisignature Transaction Guide for beempysteemCreated with Sketch.

in steem •  3 months ago

This guide will describe how to broadcast a multisignature transactions to the steem blockchain using beempy. It is my submission to this bounty.

beempy is the command line tool provided by the python library beem. It is installed when the beem library is installed.


There are three different ways to install beem/beempy:

Install beem through pip / pip3

Assuming that python and pip is already installed, beem can be installed by

pip install beem

This does not work on windows.

Install beem through conda

When anaconda is used, beempy can be installed by

conda install beem

This works also on windows

Unzip beempy provided by pyinstaller for windows

Download the newest beempy zip file from the release site and unpack it.

A more detailed installation guide can be found in the readme file.

This guide is only valid for beempy version 0.20.16 or higher. The version can be checked by:

beempy --version

The guide will not work for versions below 0.20.16!

Setting up multisignature authority for the active authority - Part 1

In order to change the active authority permissions, the active key of the account that should be changed, must be stored in the key wallet.
It can be checked if there is already a wallet by:

 beempy  walletinfo

When there is no, it can be created by:

beempy createwallet

Now we can add the active key:

beempy addkey

There will be two prompts, the first will ask for the wallet master password and the second will ask for the active key.

At first we should check if the account which should be set up, already has more than one permission.

beempy permissions <account_name>

If there is more than one Key listed and all accounts that were given active authority permission should be removed, it can be done by:

beempy disallow --permission active -a <account_name> <account_with_active_permission>

Now, active permissions can be granted to other accounts by using the allow command. Lets assume we want to allow N accounts / keys for active permission.
when adding the first N-1 accounts/keys we must not define the treshold T:

beempy allow --permission active -a <account_name> --weight W_1 <pubkey_or_accountname_1>
beempy allow --permission active -a <account_name> --weight W_2 <pubkey_or_accountname_2>
beempy allow --permission active -a <account_name> --weight W_n-1 <pubkey_or_accountname_n-1>

Now we can set the threshold T for the last account/key:

beempy allow --permission active -a <account_name> --weight W_n --threshold T <pubkey_or_accountname_n>

Posting authority

When permissions to the posting authority should be changed,

--permission active

must be replaced by

--permission posting


We want to setup the active authority with 7 keys:

A user wants to have their active authority setup with seven keys. Keys one and two each have a weight of 25%. Keys three, four, five, six, and seven each have a weight of 10%. In order for a transaction to be valid, it must have at least 40% weighted signatures.

beempy allow --permission active -a testholger --weight 25 STM6bVMCVr4FcLmbcckEgaHcHmcfytzoanTW1FrnTQ6rL5NWuBeGA  

beempy allow --permission active -a testholger --weight 25 STM8RsufKpLfEeirs6WYDJm93UT1U5ntQqkSZrumWhv9Tw8B1NWTx

beempy allow --permission active -a testholger --weight 10 STM58dtFYRZviGgbm4nhnELczhGDK78R3Vi7M1VCdkNS2vZG8pkbJ 

beempy allow --permission active -a testholger --weight 10 STM8A2zgE2wouhMfd6ycAvpboB6m2PKwa31pih49yZTsbD5jGMT3t 

beempy allow --permission active -a testholger --weight 10 STM5qoHyJrKCsW4FFhrrbWPuS52N2FUjQTFiHJVHfuBykEVvENrvS 

beempy allow --permission active -a testholger --weight 10 STM8LaqooL399EZXUacyBVFCXJiGRnQsyw6YYGEN7UqQksdH5oAta  

beempy allow --permission active -a testholger --weight 10 --threshold 40 STM8Y8aYJC7EbFRZ34imY2sJ7b78WprTMWiQAp4hbYcg2JCr4EcT9  

Let's check if everything has worked out:

 beempy permissions testholger
| Permission | Threshold |                                                Key/Account |
|      owner |         1 |  STM8k9awBgjduUdkoTyP1DFSLYNrtqgnCeeETFFWHeox4BKybT71n (1) |
|     active |        40 | STM58dtFYRZviGgbm4nhnELczhGDK78R3Vi7M1VCdkNS2vZG8pkbJ (10) |
|            |           | STM5qoHyJrKCsW4FFhrrbWPuS52N2FUjQTFiHJVHfuBykEVvENrvS (10) |
|            |           | STM6bVMCVr4FcLmbcckEgaHcHmcfytzoanTW1FrnTQ6rL5NWuBeGA (25) |
|            |           | STM8A2zgE2wouhMfd6ycAvpboB6m2PKwa31pih49yZTsbD5jGMT3t (10) |
|            |           | STM8LaqooL399EZXUacyBVFCXJiGRnQsyw6YYGEN7UqQksdH5oAta (10) |
|            |           | STM8RsufKpLfEeirs6WYDJm93UT1U5ntQqkSZrumWhv9Tw8B1NWTx (25) |
|            |           | STM8Y8aYJC7EbFRZ34imY2sJ7b78WprTMWiQAp4hbYcg2JCr4EcT9 (10) |
|            |           |  STM8YQFkpJrj74SdR8JWRv12DHVRn3eKoAaEcwrj1QmLGArZY39o8 (1) |
|    posting |         1 |  STM52tq9RWwdYJ3gzxz2fzhcg9HCBfouqcHBYVU439tLdk73Ed7SM (1) |

Setting up multisignature authority for the active authority - Part 2

When an account has more than one key assigned to the active permission, broadcasting is successfully when at least the weight sum of all signed keys is at least the threshold T.

At first we need to create a unsigned transaction. We can do this with beempy by:

beempy -xd -e 3600 <command> <options> > unsigned_transaction.json

The parameter x and d prevent that the transaction is signed and broadcasted. -e 3600 increases the expiration time to the maximum time of 1 hour. This means that all participants have 1 hour to sign and finally to broadcast.

We need the key that should sign in the wallet:

beempy addkey

Signing can than be done by

beempy sign --file unsigned_transaction.json -o signed_1_transaction.json

The next signer with has the next key in its wallet can sign with:

beempy sign --file signed_1_transaction.json -o signed_2_transaction.json

This is repeated until the weight sum of signer exceed the threshold.

Broadcasting can then be done by:

beempy broadcast --file signed_2_transaction.json


Let's continue our example and transfer some STEEM:

One of the key holders of the account wants to transfer 5.0 STEEM tokens to another user. The transaction should be signed with keys one, four, and five (which would exceed the 40% threshold).

We need to create the unsigned transaction first:

 beempy -xd -e 3600 transfer -a testholger holger80 5.000 STEEM > unsigned_transaction.json

Then the first signer will sign. The first key must be stored in the wallet

beempy addkey

and we can sign:

beempy sign --file unsigned_transaction.json -o signed_1_transaction.json

Now we delete the key with:

beempy delkey STM6bVMCVr4FcLmbcckEgaHcHmcfytzoanTW1FrnTQ6rL5NWuBeGA  

Now the forth key should sign and we add this key to the wallet

beempy addkey

and we can sign:

beempy sign --file signed_1_transaction.json -o signed_2_transaction.json

Now we delete the key with:

beempy delkey STM8A2zgE2wouhMfd6ycAvpboB6m2PKwa31pih49yZTsbD5jGMT3t 

Now the fifth key will sign. We will add it first:

beempy addkey

and we can sign:

beempy sign --file signed_2_transaction.json -o signed_3_transaction.json

We have enough signer and we can now broadcast the transaction by:

beempy broadcast --file signed_3_transaction.json

Let's see if it has worked:

There are the three signatures, so everything worked out!

Authors get paid when people like you upvote their post.
If you enjoyed what you read here, create your account today and start earning FREE STEEM!
Sort Order:  

Congrats @holger80, you are one of the finalists for the Multisig bounty, BuildTeam will be sponsoring a Steemvoter Guild vote in addition to any other bounty you may receive. Incoming shortly.


Thanks a lot for the votes.

@buildteam and @steemvoter are proud to award you a Steemvoter Guild vote for your efforts in contributing to the multisig bounty.

This post has been just added as new item to timeline of beem on Steem Projects.

If you want to be notified about new updates from this project, register on Steem Projects and add beem to your favorite projects.

To listen to the audio version of this article click on the play image.

Brought to you by @tts. If you find it useful please consider upvoting this reply.

Thank you so much for participating the Partiko Delegation Plan Round 1! We really appreciate your support! As part of the delegation benefits, we just gave you a 3.00% upvote! Together, let’s change the world!

Awesome tutorial for setting up multi-signature payment for Steem!

Hi, @holger80!

You just got a 2.49% upvote from SteemPlus!
To get higher upvotes, earn more SteemPlus Points (SPP). On your Steemit wallet, check your SPP balance and click on "How to earn SPP?" to find out all the ways to earn.
If you're not using SteemPlus yet, please check our last posts in here to see the many ways in which SteemPlus can improve your Steem experience on Steemit and Busy.

Hi @holger80!

Your post was upvoted by @steem-ua, new Steem dApp, using UserAuthority for algorithmic post curation!
Your UA account score is currently 7.291 which ranks you at #64 across all Steem accounts.
Your rank has not changed in the last three days.

In our last Algorithmic Curation Round, consisting of 207 contributions, your post is ranked at #4.

Evaluation of your UA score:
  • Your follower network is great!
  • The readers appreciate your great work!
  • Good user engagement!

Feel free to join our @steem-ua Discord server

This post has been included in today's SOS Daily News - a digest of all you need to know about the State of Steem.