方法#

1. インラインアップグレード

最もシンプルで、既存のコントラクトを変更せずに新しいfunctionを追加できます。
ただし、既存のfunctionを変更することはできません。
バージョン管理が難しく、複雑なアップグレードには適していません。

2. プロキシアップグレード

新しいコントラクトをデプロイし、既存のコントラクトへのプロキシとして設定します。
既存のfunctionを変更することもできます。
バージョン管理が容易で、複雑なアップグレードにも適しています。
いくつかの種類があり、それぞれに利点と欠点があります。

3. ダイヤモンドアップグレード

プロキシアップグレードの一種で、より高度な機能を提供します。
複数のファセットと呼ばれるコントラクトを組み合わせることで、機能を拡張できます。
最も柔軟で拡張性の高いアップグレード方法ですが、複雑な実装が必要です。

4. トランスファーアップグレード

新しいコントラクトにデータを移行するアップグレード方法です。
既存のfunctionを変更することはできません。
データ移行が必要な場合に適しています。

具体例#

1. インラインアップグレード

例:

1
contract MyContract {
2
  function add(uint256 a, uint256 b) public pure returns (uint256) {
3
    return a + b;
4
  }
5

6
  // 新しいfunctionを追加
7
  function subtract(uint256 a, uint256 b) public pure returns (uint256) {
8
    return a - b;
9
  }
10
}

解説:

既存のコントラクトを変更せずに、新しいfunction subtract を追加しています。
既存のfunction add は変更されていません。

2. プロキシアップグレード

例:

1
contract MyContract {
2
  function add(uint256 a, uint256 b) public pure returns (uint256) {
3
    return a + b;
4
  }
5
}
6

7
contract MyProxy {
8
  MyContract public implementation;
9

10
  constructor(MyContract _implementation) {
11
    implementation = _implementation;
12
  }
13

14
  function add(uint256 a, uint256 b) public payable returns (uint256) {
15
    return implementation.add(a, b);
16
  }
17
}

解説:

新しいコントラクト MyProxy をデプロイし、既存のコントラクト MyContract へのプロキシとして設定します。
MyProxy の add function は、MyContract の add function を呼び出します。
将来、MyContract を新しいバージョンにアップグレードすることで、MyProxy の機能を拡張することができます。

3. ダイヤモンドアップグレード

例:

1
contract MyFacet {
2
  function add(uint256 a, uint256 b) public pure returns (uint256) {
3
    return a + b;
4
  }
5
}
6

7
contract MyDiamond {
8
  // ファセットのアドレスを格納するマッピング
9
  mapping(bytes4 => address) public facets;
10

11
  constructor() {
12
    // ファセットを追加
13
    facets[bytes4(keccak256("add(uint256,uint256)"))] = address(new MyFacet());
14
  }
15

16
  // ファセットのfunctionを呼び出す
17
  function add(uint256 a, uint256 b) public payable returns (uint256) {
18
    return MyFacet(facets[bytes4(keccak256("add(uint256,uint256)"))]).add(a, b);
19
  }
20
}

解説:

ダイヤモンドアップグレードは、プロキシアップグレードの一種で、より高度な機能を提供します。
複数のファセットと呼ばれるコントラクトを組み合わせることで、機能を拡張できます。
上記の例では、MyFacet というファセットが add function を提供しています。
MyDiamond コントラクトは、MyFacet ファセットの add function を呼び出すことができます。
将来、新しいファセットを追加することで、MyDiamond コントラクトの機能を拡張することができます。

4. トランスファーアップグレード

例:

1
contract MyOldContract {
2
  uint256 public balance;
3

4
  function withdraw(uint256 amount) public {
5
    balance -= amount;
6
    msg.sender.transfer(amount);
7
  }
8
}
9

10
contract MyNewContract {
11
  uint256 public balance;
12

13
  constructor(MyOldContract oldContract) {
14
    // 既存のコントラクトからデータを移行
15
    balance = oldContract.balance();
16
  }
17

18
  function withdraw(uint256 amount) public {
19
    balance -= amount;
20
    msg.sender.transfer(amount);
21
  }
22
}