[DA series - Learn Python with Steem #12] Steem 小工具DIY #4 投票幫手

[DA series - Learn Python with Steem] 是DA(@deanliu & @antonsteemit)關於「從Python程式語言實做Steem區塊鏈的入門」的系列,歡迎趕緊入列學習!

前情提要:[DA series - Learn Python with Steem #11] Steem 小工具DIY #3 - 我的文章列表(二)

第#12堂課,嗨,繼續Python學習之旅,今天繼續「Steem 小工具」系列吧!

前言

最近好久沒有更新steem-python系列文了,真是對不起各位好學生啊(掩面)~到今天之前,我們所做的小工具都只有對於Steem區塊鏈的「觀察」,也就是像是讀取資料庫一樣。今天我們要稍微進階一點,來進行對區塊鏈的「寫入」,就從最基本的upvote著手吧!

在區塊鏈中,寫入也就意味著製造transaction,簽署交易,並且被區塊所驗證。在這過程中我們需要透過自己的private key來進行簽章,也就意味著我們必須在程式碼當中使用的我們的私鑰,所以大家要小心不要不小心暴露啦!

Keys on STEEM

在這之前我們要先對steem的私鑰管理系統有多一點的理解。在Steem的設計中,把一個用戶的權限一共分在了三把私鑰上,每個人可以依據使用情境不同決定只用某一把私鑰登入,以保障帳號安全。這三把私鑰分別為:

  1. Posting Key:授權貼文、投票、轉貼、回覆等等基本操作
  2. Active Key:授權與資產相關的轉帳、Powerup等等
  3. Memo Key:授權讀取加密的轉帳memo

當然,還有一把Master Key作為掌管一切的主密碼。不過在我們接下來要實作的例子中,由於只是要進行投票,所以只會用到posting key的權限,也建議大家在執行程式時只要導入自己的posting key就好,免得意外發生造成損失。

取得Posting Key的方法:

  1. 進入Steemit Wallet頁面
  2. 點選Permission頁籤
  3. 點選Posting Key旁的show private key按鈕顯示私鑰,並存下來等著待會用。

Upvote 小工具

今天我們來寫一個可以upvote特定使用者最新文章的腳本。其實Steem-python函式庫已經把整個簽章投票過程變得超級無敵簡單,我們只要在一開始呼叫Steem類別時「代入我們的Posting Key」,並且找到我們目標upvote文章的identifier,剩下的事情就可以交給Steem-python函式庫去處理。

如同我們剛剛說到的,在程式碼中寫死自己的posting key雖然比較方便,但也比較容易不小心暴露出去,所以在這裡也建議大家使用如同之前的argv[]的寫法來讀取執行時寫入的私鑰。這裡一共設計了四個參數要在執行腳本時傳入,分別是target_user,account_username,account_posting_key以及upvote_weight。因此腳本執行時輸入如下:

python upvote_username.py eosasia antonsteemit 5JMYPOSTINGKEY000000BLAHBLAHBLAH 50

代表我們想要使用帳號@antonsteemit,給@eosasia最新的文章投票,voting_weight 為 50%。因此在此一腳本中,分別將這些傳入的三數存入四個變數中如下:(此篇教學的程式碼可以參考upvote_username.py

from steem import Steem
import sys

def upvote(account_name ,post, weight):

target_username = sys.argv[1]
account_name = sys.argv[2]
account_postkey = sys.argv[3]
vote_weight = sys.argv[4]

s = Steem("https://api.steemit.com", keys=[account_postkey])

其中最後一行,宣告Steem 類別時,我們要將posting key放入 keys=[]這個參數中傳入,來建立這個可以動用我們posting key的類別。到這裡,其實稍有不同的部分就做完了,後面我們只要透過類似之前尋找發文紀錄的機器人的做法,找到target_username最新的文章,接著就可以利用內建的mothod: Steem.commit.vote()來投票了。

我們可以直接看主要程式部分的程式碼:

target_post = {}
history = s.get_account_history(target_username, index_from=-1, limit=1000)
for operation in reversed(history):
    op = operation[1]['op']
    if op[0] == 'comment':
        if op[1]['parent_author'] == '':
            _permlink = op[1]['permlink']

            # Check if the Post has already been upvoted by my account
            if account_name in [v["voter"] for v in s.get_active_votes(target_username, _permlink)]:
                print("Already voted on this. Skipping... {}".format(op[1]['title']))
                continue
            
            # Save target vote in a dictionary structure
            target_post["permlink"] = _permlink
            target_post["title"] = op[1]['title']
            target_post["identifier"] = '@{}/{}'.format(target_username, target_post["permlink"])
            print('Target Post: {}'.format(target_post["identifier"]))
            upvote(account_name, target_post, 5)
            break

重複投票檢驗

前半段迴圈的架構跟之前的程式是相同的,可以直接複製過來使用。其中略微不同的點在於,每當我們找到該做找最新文章,我們要先確認我們有沒有upvote過這篇文章。檢驗的方法是透過s.get_active_votes(author, permlink)這個呼叫來看看,他會回傳一個list of dictionary,我們只要檢查每個dictionary中的 ["voter"] 都不是我們的帳號,就可以確定沒有投過此文章,確保投票會成功。

Identifier

再來是關於目標文章,我們使用target_post這樣一個字典來儲存,然後再一起丟到upvote()這個函式裡。其中存了一個叫做的target_post["identifier"]的變數,他就是一個形式為"@username/permlink"字串。為這麼做是因為在steem-python投票的這個method當中,就是要我們輸入這樣格式的identifier來辨認這篇文章。

最後來介紹這個簡單自製的upvote function。其實大家也沒有必要一定要單獨寫一個函式,因為在裡面做的事情也只是去呼叫steem.commit.vote()罷了。

def upvote(account_name ,post, weight):
    try:
        s.commit.vote(post["identifier"], weight, account=account_name)
        print("Casted vote({}%) on: {}.".format(weight,post["identifier"]))
    except Exception as error:
        print("Error : {}".format(error))

可以看到這個小函式中,只是把s.commit.vote()包在一個try - except的架構裡。這樣可以防範如果投票失敗,並不會終止程式,而只會印出錯誤代碼。這種try - except的語法被稱作Error Handler,在編寫比較大,或是需要長期運作的程式時可以透過它來避免小bug直接造成程式停止。就這麼簡單!我們的小小跟班程式就完成啦!以後可以透過這個程式每天upvote自己的好朋友囉~

更多功能

為了防止有人覺得太簡單沒有挑戰性,大家可以回去練習實作自己的「篩選機制」。例如:還記得get_account()可以用來獲取帳戶訊息嗎?可以設計成只有在自己voting_power大於某個值時才進行投票,或是依照其他因素選擇upvote_weight。就讓大家自己發揮創意囉~

class-377117_1280.jpg
image - pixabay

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:  
Loading...

恭喜你!您的这篇文章入选 @justyy 今日 (2018-09-07) 榜单 【优秀的文章】, 回复本条评论24小时内领赏,点赞本评论将支持 @dailychina 并增加将来您的奖赏。

Congratulations! This post has been selected by @justyy as today's (2018-09-07) 【Good Posts】, Steem On! Reply to this message in 24 hours to get rewards. Upvote this comment to support the @dailychina and increase your future rewards! ^_^

image.png
偷懒用total_payout_value来判断帖子是否已经结算,会有点小瑕疵!
7天前的那个文章调用commit.vote会返回错误的样子。其他都还好~
image.png

我第一次知道Memo Key是干嘛用的,一直以为没用的。呵呵呵~

Memo Key:授權讀取加密的轉帳memo

·

還沒升初中,不怪你~~ ^_^

·
·

为了可以装嫩!

這就像自己在寫curation tail嗎?👏👏👏