L25~L27-conflictsSolved-reviewTest

Draft/25_ERC20/README.md

@@ -1,53 +1,58 @@
 # Vyper 入门: 25. ERC20
+
 `ERC20` 是一种代币标准，用于以太坊网络上的智能合约，以实现代币的发行和管理。它定义了一些基本的功能，如获取代币总供应量、转账、以及查看账户余额等，确保了不同代币间的互操作性。
 
 本节中我们将简单介绍一下 `ERC20` 代币标准并部署一个测试代币
 
-
 ## 理解 `ERC20` 标准
+
 `ERC20` 标准定义了一组最小的公共接口，一个 `ERC20` 代币合约必须实现这些接口和事件，包括：
 
 ### 函数接口
 
 - `totalSupply()`: 返回代币的总供应量
+
 ```
 totalSupply: public(uint256)
 ```
 
-- `balanceOf(address)`: 返回特定地址的账户余额
+- `balanceOf(address)`: 返回账户余额
+
 ```
 balanceOf: public(HashMap[address, uint256])
 ```
 
-- `transfer(address, uint256)`: 从调用者地址向另一个地址转移代币
+- `transfer(address, uint256)`: 转账, 从调用者地址向另一个地址转移代币
+
 ```
 @external
 def transfer(_to: address, _value: uint256) -> bool:
-    return empty(bool)
 ```
 
-- `transferFrom(address, address, uint256)`: 允许一个地址代表另一个地址转移代币
+- `transferFrom(address, address, uint256)`: 授权转账, 允许一个地址代表另一个地址转移代币
+
 ```
 @external
 def transferFrom(_from: address, _to: address, _value: uint256) -> bool:
-    return empty(bool)
 ```
 
-- `approve(address, uint256)`: 允许一个地址（受托人）代表另一个地址提取代币
+- `approve(address, uint256)`: 授权, 允许一个地址（受托人）代表另一个地址提取代币
+
 ```
 @external
 def approve(_spender: address, _value: uint256) -> bool:
-    return empty(bool)
 ```
 
-- `allowance(address, address)`: 返回一个地址（受托人）被允许从另一个地址提取的代币数量
+- `allowance(address, address)`: 返回授权额度, 即一个地址（受托人）被允许从另一个地址提取的代币数量
+
 ```
-allowance: pulic(HashMap[address, HashMap[address, uint256]])
+allowance: public(HashMap[address, HashMap[address, uint256]])
 ```
 
 ### 事件接口
 
 - `Transfer(address, address, uint256)`: 记录代币转移事件
+
 ```
 event Transfer:
     sender: indexed(address)
@@ -56,49 +61,52 @@ event Transfer:
 ```
 
 - `Approval(address, address, uint256)`: 记录代币授权事件
+
 ```
 event Approval:
     owner: indexed(address)
     spender: indexed(address)
     value: uint256
 ```
 
-
 ## 实现 `ERC20`
+
 现在实现一个简单 `ERC20` 代币
 
 ### 状态变量
+
 在 `Vyper` 中，状态变量是存储在区块链上的值，代表合约的状态。对于 `ERC20` 代币，我们需要以下状态变量：
 
 ```
 totalSupply: public(uint256)
 balanceOf: public(HashMap[address, uint256])
 allowance: public(HashMap[address, HashMap[address, uint256]])
 
-name: public(immutable(String[32]))
-symbol: public(immutable(String[32]))
-decimals: public(immutable(uint8))
+name: public(String[32])
+symbol: public(String[32])
+decimals: public(uint8)
 ```
 
 其中 `totalSupply`, `balanceOf` 和 `allowance` 是 `ERC20` 标准接口；`name`, `symbol` 和 `decimals` 代表代币的名称、代号和小数点
 
-
 ### 构造函数
+
 构造函数是部署合约时自动调用的特殊函数。在 `ERC20` 代币合约中，我们通常在构造函数中设置总供应量、名称、代号、小数点，并将所有代币的初始余额分配给合约的部署者。
 
 ```
 @payable
 @external
 def __init__(_name: String[32], _symbol: String[32], _decimals: uint8, _total_supply: uint256):
-    name = _name
-    symbol = _symbol
-    decimals = _decimals
+    self.name = _name
+    self.symbol = _symbol
+    self.decimals = _decimals
     self.totalSupply = _total_supply
 ```
 
-
 ### `transfer()` 函数
+
 `ERC20` 标准必须的函数，实现代币转移逻辑：调用方扣除转移的代币数量，接收方增加数量。如果需要实现更复杂的转账逻辑，比如销毁、分红、税收等都是在这个函数中增加
+
 ```
 @external
 def transfer(_to: address, _value: uint256) -> bool:
@@ -109,7 +117,9 @@ def transfer(_to: address, _value: uint256) -> bool:
 ```
 
 ### `transferFrom()` 函数
+
 `ERC20` 标准必须的函数，实现授权转移逻辑：授权一个地址代表另一个地址转移代币
+
 ```
 @external
 def transferFrom(_from: address, _to: address, _value: uint256) -> bool:
@@ -121,7 +131,9 @@ def transferFrom(_from: address, _to: address, _value: uint256) -> bool:
 ```
 
 ### `approve()` 函数
+
 `ERC20` 标准必须的函数，实现授权逻辑，允许一个地址（受托人）代表另一个地址提取代币，受托人可以是 `EOA` 地址，也可以是合约地址
+
 ```
 @external
 def approve(_spender: address, _value: uint256) -> bool:
@@ -131,7 +143,9 @@ def approve(_spender: address, _value: uint256) -> bool:
 ```
 
 ### `mint()` 函数
+
 实现代币铸造函数，铸造函数并不是 `ERC20` 标准函数
+
 ```
 @external
 def mint(_value: uint256) -> bool:
@@ -142,7 +156,9 @@ def mint(_value: uint256) -> bool:
 ```
 
 ### `burn()` 函数
+
 实现代币销毁函数，也不是 `ERC20` 标准函数
+
 ```
 @external
 def burn(_value: uint256) -> bool:
@@ -152,8 +168,8 @@ def burn(_value: uint256) -> bool:
     return True
 ```
 
-
 ## 部署 `ERC20`
+
 了解 `ERC20` 的概念后，现在部署我们的第一个代币
 
 编译好合约后，我们输入 `name`, `symbol` 和 `totalSupply`，然后部署
@@ -175,6 +191,6 @@ def burn(_value: uint256) -> bool:
 - 接收地址 `0x567a768d1656b2b024b9922f75624aE7Ad0F64D0`
 - 数量 `100`
 
-
 ## 总结
-本节中，我们介绍了 `ERC20` 代币标准并部署了一个代币。需要注意教程中使用的示例代码，仅作教学使用，不适用于生产
+
+本节中，我们介绍了 `ERC20` 代币标准并部署了一个代币。需要注意教程中使用的示例代码，仅作教学使用，不适用于生产

Draft/25_ERC20/example.vy → Draft/25_ERC20/erc20.vy

@@ -1,4 +1,4 @@
-# pragma version 0.3.10
+#pragma version 0.3.10
 
 from vyper.interfaces import ERC20
 from vyper.interfaces import ERC20Detailed
@@ -22,17 +22,17 @@ totalSupply: public(uint256)
 balanceOf: public(HashMap[address, uint256])
 allowance: public(HashMap[address, HashMap[address, uint256]])
 
-name: public(immutable(String[32]))
-symbol: public(immutable(String[32]))
-decimals: public(immutable(uint8))
+name: public(String[32])
+symbol: public(String[32])
+decimals: public(uint8)
 
 
 @payable
 @external
 def __init__(_name: String[32], _symbol: String[32], _decimals: uint8, _total_supply: uint256):
-    name = _name
-    symbol = _symbol
-    decimals = _decimals
+    self.name = _name
+    self.symbol = _symbol
+    self.decimals = _decimals
     self.totalSupply = _total_supply