Merge pull request #774 from PolymetisOutis/WTF_ja_101_15_LAST

Wtf Solidity japanese 101 Lesson 15 (Last Lesson)

Languages/ja/05_DataStorage_ja/readme.md

@@ -1,4 +1,5 @@
-# WTF Solidity 超シンプル入門: 5. Data Storage and Scope（データ保存とスコープ）
+# WTF Solidity 超シンプル入門: 5. Data Storage and Scope
+# <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>（データ保存とスコープ）
 
 最近、Solidity の学習を再開し、詳細を確認しながら「Solidity 超シンプル入門」を作っています。これは初心者向けのガイドで、プログラミングの達人向けの教材ではありません。毎週 1〜3 レッスンのペースで更新していきます。
 

Languages/ja/06_ArrayAndStruct_ja/readme.md

@@ -132,7 +132,7 @@ Solidityにおいて、`struct`というフォーマットによって新しい
 ```
 
 
-## Summary
+## まとめ
 
 このレクチャーでは、Solidityにおける`array`と`struct`のベーシックな使用方法を紹介しました。次のレクチャーでは、Solidityのハッシュテーブルを紹介します。- `mapping`
 

Languages/ja/07_Mapping_ja/readme.md

@@ -73,6 +73,6 @@
 
 
 
-## Summary
+## まとめ
 
 この章では、Solidityの`mapping`型を紹介しました。ここまでで、一般的な変数型の全ての種類について学んできましたよ。

Languages/ja/08_InitialValue_ja/readme.md

@@ -90,6 +90,6 @@ Solidityにおいて、宣言されているが代入されていない変数に
 
     ![](./img/8-2_ja.png)
 
-## Summary
+## まとめ
 
 この章では、Solidityにおける変数の初期値を紹介しました。変数が宣言されたにも拘らず代入されていない場合には、その値はデフォルトで初期値に設定されており、そしてそれはその型で表される`0`に等しくなります。`delete`演算子は変数の値を初期値にリセット出来ます。

Languages/ja/09_Constant_ja/readme.md

@@ -1,4 +1,5 @@
-# WTF Solidity 超シンプル入門: 9. Constant and Immutable （定数と不変）
+# WTF Solidity 超シンプル入門: 9. Constant and Immutable
+# <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>（定数と不変）
 
 最近、Solidity の学習を再開し、詳細を確認しながら「Solidity 超シンプル入門」を作っています。これは初心者向けのガイドで、プログラミングの達人向けの教材ではありません。毎週 1〜3 レッスンのペースで更新していきます。
 
@@ -74,7 +75,7 @@
 
    ![9-3.png](./img/9-3.png)
 
-## Summary
+## まとめ
 
 この章では、Solidityにおいてその状態を編集することを制限する２つのキーワードを紹介しました: `constant`と`immutable`です。それらは変更されるべきではない変数を不変のままに維持します。コントラクトのセキュリティーを改善する一方で、`gas`を節約することに役立つでしょう。
 

Languages/ja/10_InsertionSort_ja/readme.md

@@ -170,6 +170,6 @@ Result:
 
    !["Input [2,5,3,1] Output[1,2,3,5]"](https://images.mirror-media.xyz/publication-images/S-i6rwCMeXoi8eNJ0fRdB.png?height=300&width=554)
 
-## Summary
+## まとめ
 
 このレクチャーでは、Solidityにおける制御フローを紹介し、シンプルでありながらバグが発生しやすいソートアルゴリズムを書きました。Solidityはシンプルに見えますが、沢山の罠を抱えています。毎月、スマートコントラクトにある小さなバグが故に、プロジェクトはハッキングされて、何百万ドルもの損失を生んでしまいます。安全なコントラクトを書く為には、Solidityの基礎をマスターし、訓練し続ける必要があるのです。

Languages/ja/11_Modifier_ja/readme.md

@@ -8,7 +8,8 @@ tags:
   - modifier
 ---
 
-# WTF Solidity 超シンプル入門: 11. Constructor & Modifier（コンストラクターと修飾子）
+# WTF Solidity 超シンプル入門: 11. Constructor & Modifier
+# <code>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</code>（コンストラクターと修飾子）
 
 最近、Solidity の学習を再開し、詳細を確認しながら「Solidity 超シンプル入門」を作っています。これは初心者向けのガイドで、プログラミングの達人向けの教材ではありません。毎週 1〜3 レッスンのペースで更新していきます。
 
@@ -84,5 +85,5 @@ contract Parents {
     ![](img/11-4_ja.png)
 
 
-## Summary
+## まとめ
 このレクチャーでは、Solidityの`constructor`と`modifier`を紹介し、スマートコントラクトへのアクセスを制御する`Ownable`スマートコントラクトを書きました。

Languages/ja/12_Event_ja/Event.sol

@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.21;
+contract Events {
+    // define _balances mapping variable to record number of tokens held at each address
+    //（各アドレスで保有されているトークン数を記録するmapping変数として_balanceを定義します）
+    mapping(address => uint256) public _balances;
+
+    // define Transfer event to record transfer address, receiving address and transfer number of a transfer transfaction
+    //（転送を行うトランザクションの送信元アドレスや受信アドレス、転送数を記録する為のTransferイベントを定義します）
+    event Transfer(address indexed from, address indexed to, uint256 value);
+
+
+    // define _transfer function，execute transfer logic
+    //（_transfer関数を定義して、転送ロジックを実行する）
+    function _transfer(
+        address from,
+        address to,
+        uint256 amount
+    ) external {
+
+        _balances[from] = 10000000; // give some initial tokens to transfer address（送信元アドレスにいくつかの初期トークンを付与します）
+
+        _balances[from] -=  amount; // "from" address minus the number of transfer（"from"アドレスから転送数を減算します）
+        _balances[to] += amount; // "to" address adds the number of transfer（"to"アドレスに転送数を加算します）
+
+        // emit event
+        emit Transfer(from, to, amount);
+    }
+}

Languages/ja/12_Event_ja/readme.md

@@ -0,0 +1,106 @@
+---
+title: 12. Events（イベント）
+tags:
+  - solidity
+  - basic
+  - wtfacademy
+  - event
+---
+
+# WTF Solidity 超シンプル入門: 12. Events（イベント）
+
+最近、Solidity の学習を再開し、詳細を確認しながら「Solidity 超シンプル入門」を作っています。これは初心者向けのガイドで、プログラミングの達人向けの教材ではありません。毎週 1〜3 レッスンのペースで更新していきます。
+
+僕のツイッター：[@0xAA_Science](https://twitter.com/0xAA_Science)｜[@WTFAcademy\_](https://twitter.com/WTFAcademy_)
+
+コミュニティ：[Discord](https://discord.gg/5akcruXrsk)｜[Wechat](https://docs.google.com/forms/d/e/1FAIpQLSe4KGT8Sh6sJ7hedQRuIYirOoZK_85miz3dw7vA1-YjodgJ-A/viewform?usp=sf_link)｜[公式サイト wtf.academy](https://wtf.academy)
+
+すべてのソースコードやレッスンは github にて公開: [github.com/AmazingAng/WTFSolidity](https://github.com/AmazingAng/WTFSolidity)
+
+-----
+
+この章では、ERC20のトークンを例として使い、Solidityにおける`event`を紹介します。
+
+## Events（イベント）
+`solidity`におけるイベントは`EVM`(Ethereum Virtual Machine)に格納されるトランザクションログです。それらは関数が呼び出される際に発生し、コントラクトアドレスでアクセスできます。イベントは2つの性質を持っています :
+
+- 即応性がある: アプリケーション（例えば[`ether.js`](https://learnblockchain.cn/docs/ethers.js/api-contract.html#id18)）は`RPC`インターフェースを通して、購読し（検知）し監視（追跡）することができ、フロントエンドで応答することができる。
+- 経済的である: イベントにデータを格納するのは安く、大体一度に2,000`gas`位掛かります。それに比べて、オンチェーンに新しい変数を格納するのは少なくとも20,000`gas`かかります。
+
+### Declare events（イベントを宣言する）
+イベントは`event`キーワードで宣言され、イベントの名前、そして記録されるそれぞれのパラメーターの型と名前が続きます。例として`ERC20`トークンのコントラクトから`Transfer`イベントを取り上げてみましょう。
+```solidity
+event Transfer(address indexed from, address indexed to, uint256 value);
+```
+`Transfer`イベントは３つのパラメーターを記録します: `from`と`to`、そして`value`です。それぞれ、それらはトークンが送信される元のアドレス、受信アドレス、そして送金されるトークンの数に相当しています。パラメーターの`from`と`to`は`indexed`キーワードで印が付けられており、`topics`として知られている特別なデータ構造に格納され、プログラムによって容易に照会されます。
+
+### Emit events（イベントを発生させる）
+
+関数の中でイベントを発生させることが出来ます。次に続く例において、`_transfer()`関数が呼び出される度に、`Transfer`イベントは発生させられ、対応するパラメーターが記録されます。
+```solidity
+    // define _transfer function， execute transfer logic（_transfer関数を定義し、転送ロジックを実行する）
+    function _transfer(
+        address from,
+        address to,
+        uint256 amount
+    ) external {
+
+        _balances[from] = 10000000; // give some initial tokens to transfer address（転送元アドレスに幾らかの初期トークンを付与する）
+
+        _balances[from] -=  amount; // "from" address minus the number of transfer（"from"アドレスは転送させる数を減算する）
+        _balances[to] += amount; // "to" address adds the number of transfer（"to"アドレスは転送させる数を加算する）
+
+        // emit event（イベントを発生させる）
+        emit Transfer(from, to, amount);
+    }
+```
+
+## EVM Log
+
+EVMはSolidityのイベントを保管する為に`Log`を使用します。各ログは2つの部品を含んでいます: `topics`と`data`です。
+
+![](img/12-3.png)
+
+### `Topics`
+
+`Topics`はイベントを記述する為に使用されます。各イベントは最大で4つのtopicsを含めることが可能です。典型的に、最初の`topic`はイベントハッシュです: イベントシグネチャのハッシュです。`Transfer`イベントのイベントハッシュは次のように計算されます:
+
+```solidity
+keccak256("Transfer(addrses,address,uint256)")
+
+//0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef
+```
+
+イベントハッシュに加えて、`topics`は最大で3つのindex`indexed`パラメーターを含めることが可能です。例えば、`Transfer`イベントにおける`from`と`to`パラメーターのようなものです。匿名イベント（イベントの記述に"anonymous"を付与）は特別です: イベント名を持ちませんし、最大で4つの`indexed`パラメーターを持つことが出来ます。
+
+`indexed`パラメーターはイベントの索引付けされた"key"として理解することが出来ます。そしてそれは容易にプログラムによって照会されることが出来ます。各`indexed`パラメーターのサイズは32バイトです。`array`や`string`のような32バイトよりも大きなパラメーターに関しては、基礎となるデータのハッシュが格納されます。（非基本型（例：配列や構造体）の場合、そのデータ自体ではなく、そのデータのKeccak-256ハッシュが格納される）
+
+### `Data`
+
+索引付けされていないパラメーターはログの`data`セクションに格納されます。それらはイベントの"value"として解釈され、直接取得することは出来ません。しかしそれらはより大きいサイズのデータを格納することが出来ます。それゆえに、`data`セクションは、`array`や`string`と言った複雑なデータ構造を格納する為に使用されます。これらのデータは256ビットを超えるため、イベントのtopics部分に格納される場合でも、ハッシュ化された形で保存されます。その上、`data`は`topic`に較べてより少ないガスを消費します。
+
+## Remix Demo
+`Event.sol`コントラクトを例として見てみましょう。
+
+1. `Event`コントラクトをデプロイします。
+
+2. `Transfer`イベントを発生させる為に、`_transfer`関数を呼び出します。
+
+![](./img/12-1_ja.png)
+
+3. 発生させられたイベントをチェックする為に、トランザクションの詳細情報を確認します。
+
+![](./img/12-2_ja.png)
+
+### Etherscanでイベントを照会する
+
+イーサスキャン（Etherscan）はイーサリアムのブロックチェーン上にあるトランザクションやスマートコントラクト、それ以上のことを見ることが出来るブロックエクスプローラーです。先ず、私はRinkebyやGoerliなどのイーサリアムテストネットにコントラクトをデプロイしました。次に、私は100トークン送金する為に`_transfer`関数を呼び出しました。その後で、トランザクションの詳細情報を`etherscan`で確認することが出来ます：[URL](https://rinkeby.etherscan.io/tx/0x8cf87215b23055896d93004112bbd8ab754f081b4491cb48c37592ca8f8a36c7)
+
+イベントの詳細情報を確認する為に`Logs`ボタンをクリックします：  
+
+![details of event](./img/12-3_ja.png)
+
+`Topics`には3つの要素があります: `[0]`はイベントのハッシュであり、`[1]`と`[2]`は`Transfer`イベントで定義されている`indexed`パラメーターです（即ち、`from`と`to`です）。`Data`にある要素は索引付けされていないパラメーター`amount`です。
+
+## まとめ
+このレクチャーでは、`Solidity`におけるイベントを使用し、照会する方法について紹介しました。`Dune Analytics`のような、多くのオンチェーンの分析ツールは、solidityのイベントに基いています。

Languages/ja/13_Inheritance_ja/DiamondInheritance.sol

@@ -0,0 +1,54 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.13;
+
+/* Inheritance tree（継承ツリー）：
+  God
+ /  \
+Adam Eve
+ \  /
+people
+*/
+
+contract God {
+    event Log(string message);
+
+    function foo() public virtual {
+        emit Log("God.foo called");
+    }
+
+    function bar() public virtual {
+        emit Log("God.bar called");
+    }
+}
+
+contract Adam is God {
+    function foo() public virtual override {
+        emit Log("Adam.foo called");
+    }
+
+    function bar() public virtual override {
+        emit Log("Adam.bar called");
+        super.bar();
+    }
+}
+
+contract Eve is God {
+    function foo() public virtual override {
+        emit Log("Eve.foo called");
+    }
+
+    function bar() public virtual override {
+        emit Log("Eve.bar called");
+        super.bar();
+    }
+}
+
+contract people is Adam, Eve {
+    function foo() public override(Adam, Eve) {
+        super.foo();
+    }
+
+    function bar() public override(Adam, Eve) {
+        super.bar();
+    }
+}

Languages/ja/13_Inheritance_ja/Inheritance.sol

@@ -0,0 +1,74 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.21;
+
+// Inheritance contract（継承コントラクト）
+contract Grandfather {
+    event Log(string msg);
+
+    // Apply inheritance to the following 3 functions: hip(), pop(), Grandfather()，then log "Grandfather".
+    //（継承を次の3つの関数に対して適用します: hip()、pop()、Grandfather()、そしてログは"Grandfather"です。）
+    function hip() public virtual{
+        emit Log("Grandfather");
+    }
+
+    function pop() public virtual{
+        emit Log("Grandfather");
+    }
+
+    function grandfather() public virtual {
+        emit Log("Grandfather");
+    }
+}
+
+contract Father is Grandfather{
+    // Apply inheritance to the following 2 functions: hip() and pop()， then change the log value to "Father".
+    //（継承を次の2つの関数に対して適用します: hip()、pop()、そしてログの値を"Father"に変更します。）
+    function hip() public virtual override{
+        emit Log("Father");
+    }
+
+    function pop() public virtual override{
+        emit Log("Father");
+    }
+
+    function father() public virtual{
+        emit Log("Father");
+    }
+}
+
+contract Son is Grandfather, Father{
+    // Apply inheritance to the following 2 functions: hip() and pop()， then change the log value to "Son".
+    //（継承を次の2つの関数に対して適用します: hip()、pop()、そしてログの値を"Son"に変更します。）
+    function hip() public virtual override(Grandfather, Father){
+        emit Log("Son");
+    }
+
+    function pop() public virtual override(Grandfather, Father) {
+        emit Log("Son");
+    }
+
+    function callParent() public{
+        Grandfather.pop();
+    }
+
+    function callParentSuper() public{
+        super.pop();
+    }
+}
+
+// Applying inheritance to the constructor functions
+//（コンストラクター関数に対して継承を適用します）
+abstract contract A {
+    uint public a;
+
+    constructor(uint _a) {
+        a = _a;
+    }
+}
+
+contract B is A(1) {
+}
+
+contract C is A {
+    constructor(uint _c) A(_c * _c) {}
+}

Languages/ja/13_Inheritance_ja/ModifierInheritance.sol

@@ -0,0 +1,37 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.21;
+
+contract Base1 {
+    modifier exactDividedBy2And3(uint _a) virtual {
+        require(_a % 2 == 0 && _a % 3 == 0);
+        _;
+    }
+}
+
+contract Identifier is Base1 {
+
+    // Calculate the value of a number divided by 2 and divided by 3, respectively, but the parameters passed in must be multiples of 2 and 3
+    //（2で除算された数値と3で除算された数値をそれぞれ計算しますが、渡される引数は2と3の倍数でなければなりません）
+    function getExactDividedBy2And3(uint _dividend) public exactDividedBy2And3(_dividend) pure returns(uint, uint) {
+        return getExactDividedBy2And3WithoutModifier(_dividend);
+    }
+
+    // Calculate the value of a number divided by 2 and divided by 3, respectively
+    //（2で除算された数値と3で除算された数値をそれぞれ計算します）
+    function getExactDividedBy2And3WithoutModifier(uint _dividend) public pure returns(uint, uint){
+        uint div2 = _dividend / 2;
+        uint div3 = _dividend / 3;
+        return (div2, div3);
+    }
+
+
+    // Rewrite the modifier: when not rewriting, enter 9 to call getExactDividedBy2And3, it will be reverted because it cannot pass the check
+    // Delete the following three lines of comments and rewrite the modifier function. At this time, enter 9 to call getExactDividedBy2And3, and the call will be successful.
+    //（修飾子を書き換える: 書き換えない時には、getExactDividedBy2And3を呼び指す際に9を入れます。そうすればチェックを通らないので、リバーとされます。）
+    //（次の3行のコメントを消して、修飾子関数を書き換えてください。この時にはgetExactDividedBy2And3に9を代入すれば、呼び出しは成功するでしょう。）
+
+    // modifier exactDividedBy2And3(uint _a) override {
+    //     _;
+    // }
+}
+