バージョン: 3.3.2

コントラクトの更新

機能

コントラクトをブロックチェーンにデプロイした後、バグをフィックスしたり、バージョンアップするために開発者はコントラクトを更新する必要があります。

トランザクションを送信することにより、容易にスマートコントラクトを更新するメカニズムを提供します。さらに重要なのは、任意の権限の要求に対して、非常に柔軟な更新権限制御を提供します。

スマートコントラクトを更新するには、スマートコントラクト内に次のように実装する必要があります。

can_update(data) {
}

コントラクトを更新するリクエストを受け取ったら、システムは最初にコントラクトのcan_update(data)関数を呼び出します。dataはオプションで、string型の入力パラメータです。関数がtrueを返したならば、コントラクトの更新が実行されます。そうでなければ、Update Refusedエラーが返ります。

この関数を適切に書くことにより、任意の権限制御の要求を実装することができます。たとえば、２人が同時に承認しないといけない、または誰がコントラクトを更新するかを投票するなどです。

コントラクト内に関数が実装されていない場合は、コントラクトはデフォルトでは更新は許可されません。

Hello BlockChain

コントラクトの更新プロセスを示すために、単純なスマートコントラクトを例に挙げます。

コントラクトファイルhelloContract.jsを次のように作成します。

class helloContract
{
    init() {
    }
    hello() {
        return "hello world";
    }
    can_update(data) {
        return blockchain.requireAuth(blockchain.contractOwner(), "active");
    }
};
module.exports = helloContract;

コントラクトファイル内のcan_update()関数実装を見てください。adminIDアカウント認証があるときだけ、コントラクトが更新できるようになっています。

コントラクトのパブリッシュ

コントラクトのパブリッシュを参照してください。

$ export IOST_ACCOUNT=admin # replace with your own account name here
$ iwallet compile hello.js
$ iwallet --account $IOST_ACCOUNT publish hello.js hello.js.abi
...
The contract id is: ContractEg5zFjJrSPdgCR5mYXQLfHXripq64q17MuJoaWKTaaax

最初のコントラクトの呼び出し

これで、アップロードしたコントラクト内のhello関数を呼び出すことができます。結果として、'hello world'が返ってきます。

$ iwallet --account $IOST_ACCOUNT -v call ContractEg5zFjJrSPdgCR5mYXQLfHXripq64q17MuJoaWKTaaax hello "[]"
...
    "statusCode": "SUCCESS",
    "message": "",
    "returns": [
        "[\"hello world\"]"
    ],
    "receipts": [
    ]
}