首先,選擇一個秘密來保護你的API。然後前往 http://127.0.0.1:9053/swagger#/utils/hashBlake2b 然後呼叫API來計算你秘密的雜湊值。參考下圖。
複製含有雜湊值的回覆以便下一步使用(參見下圖)。在我們的例子中,秘密是是 hello 誰的雜湊值對應324dcf027dd4a30a932c441f365a25e86b173defa4b8e58948253471b81b72cf.
重要提示:你必須使用不同且比較複雜的秘密.
利用API關鍵雜湊值來更新配置檔案
編輯配置檔案ergo.conf然後貼上前步所複製的雜湊值。檔案內容應當看似如下:
ergo {
directory = ${ergo.directory}"/.ergo"
node {
mining = false
}
wallet.secretStorage.secretDir = ${ergo.directory}"/wallet/keystore"
}
scorex {
restApi {
# Hex-encoded Blake2b256 hash of an API key.
# Should be 64-chars long Base16 string.
# below is the hash of the string 'hello'
# replace with your actual hash
apiKeyHash = "324dcf027dd4a30a932c441f365a25e86b173defa4b8e58948253471b81b72cf"
}
}
初始化錢包
重啟節點並且前往http://127.0.0.1:9053/panel 以訪問面板。然後設定上一步的API主要秘密。注意你需要設定秘密,而非配置檔案的雜湊值。在我們的舉例中,這是字串hello.
最後,點選“初始化錢包”:
在彈開視窗中,您必須輸入錢包密碼。助記符密碼是或選項。點選傳送後,錢包會返回一個助記句,如下圖所示。
你必須把這個句子抄下來,並把它儲存在一個安全的地方。如果你要在其他計算機恢復你的錢包,就需要這個句子。
獲得錢包的地址
這是一個可以確保你正確設定節點的測試。它將返回錢包中的當前地址。 在http://127.0.0.1:9053/panel 的面板上,點選左側的Wallet 條,然後點選 Get all wallet addresses 以瀏覽錢包目前所儲存的地址。如果節點設定正確,那麼至少應該返回一個地址。
使用Swagger UI
你可以在http://127.0.0.1:9053/swagger找到Swagger UI。你還可以使用該UI對面板上(尚不)能用的高階操作進行API呼叫。你之前已經用其來計算你秘密的雜湊值。你還可以使用這個UI來為面板中(尚未)提供的高階操作進行API呼叫。部分舉例如下:
利用暫存器和上下文變數來建立非標準交易。
建立發出令牌的交易。
建立使用某些框作為輸入值的交易。
未來的文章將逐一詳細介紹這些操作。
請注意API中的大部分方法都受到保護,你需要使用你(之前)的秘密來獲得這些方法。接下來的圖片將展示在Swagger UI中設定該秘密的流程。
在頁面頂端,點選“授權”鍵。在彈出框中輸入您的秘密,如下圖所示。
輸入密碼後,點選“授權”,將跳出以下介面:
現在轉到http://127.0.0.1:9053/swagger#/wallet/walletAddresses ,然後點選“試一試”。你會看到你之前從面板上看到過的相同的地址列表。