Rustスマートコントラクトアップグレード実践：NEARエコシステムにおける3つの方法と安全性の考慮

2025-07-23 11:55:36

Rust スマートコントラクト開発シリーズ:コントラクトアップグレード方法

スマートコントラクトはプログラムコードとして、欠陥や改善の必要があることは避けられません。大量のテストや監査を経ても、契約には脆弱性が存在する可能性があります。一度脆弱性が攻撃者に利用されると、ユーザーの資産損失など深刻な結果を招くことがあります。そのため、契約のアップグレード可能性は非常に重要です。脆弱性を修正するためにも、新しい機能を追加するためにも利用できます。本記事では、Rustスマートコントラクトのいくつかのアップグレード方法について紹介します。

NEAR コントラクトアップグレード方法

StatusMessageプロジェクトを例に挙げて、NEARスマートコントラクトの一般的なアップグレード方法について説明します。

StatusMessage スマートコントラクトコード例:

さび #[near_bindgen] #[derive(BorshDeserialize、BorshSerialize)] pub struct ステータスメッセージ { レコード: LookupMap<string, string="">, }

StatusMessage { の impl デフォルト fn default() -> 自己 { セルフ { レコード: LookupMap::new(b'r'.to_vec()), } } }

#[near_bindgen] ステータスメッセージ{ pub fn set_status(&mut self, メッセージ: String) { account_id = env::signer_account_id(); self.records.insert(&account_id, &message); }

pub fn get_status( self, account_id: String) -> オプション<string> {
    self.records.get(&account_id)を返します。
}

}

1. 合約データ構造未修正のアップグレード

契約のロジックを変更するだけで、データ構造の変更が関与しない場合は、直接 near deploy コマンドを使用して新しいコードを再デプロイできます。

例えば、新しい関数を追加する:

さび pub fn set_get_status(&mut self, message: String) -> Option { account_id = env::signer_account_id(); self.records.insert(&account_id, &message); self.records.get(&account_id)を返します。 }

再デプロイ後、元のデータは正常に読み取ることができます。

2. 合約データ構造の変更アップグレード

契約のデータ構造を変更した場合、直接再デプロイすると状態の逆シリアル化に失敗します。

例えばデータ構造を変更する:

錆 pub struct ステータスメッセージ { タグライン: LookupMap<string, string="">, bios: LookupMap<string, string="">, }

この場合、Migrate メソッドを使用してアップグレードする必要があります。

3. Migrate メソッドを使用してアップグレード

新しいコントラクトに migrate メソッドを追加:

さび #[private] #[init(ignore_state)] pub fn migrate() -> セルフ { old_stateさせてください: OldStatusMessage = env::state_read().expect('failed'); セルフ { タグライン: old_state.records, bios: LookupMap::new(b'b'.to_vec()), } }

デプロイ時に同時に migrate メソッドを呼び出す:

近くにデプロイ \ --wasmファイルターゲット/wasm32-unknown-unknown/release/status_message.wasm
--initFunction 'migrate'
--initArgs '{}'
--accountId statusmessage.blocksec_upgrade.testnet

これにより、古いデータを新しいデータ構造に正常に移行できます。