ERC-20 계약 살펴보기

1// SPDX-License-Identifier: MIT
복사

1pragma solidity >=0.6.0 <0.8.0;
복사

1/**
2 * @dev EIP에 정의된 ERC20 표준의 인터페이스입니다.
3 */
복사

1interface IERC20 {
복사

1    /**
2     * @dev 존재하는 토큰의 양을 반환합니다.
3     */
4    function totalSupply() external view returns (uint256);
복사

1    /**
2     * @dev `account`가 소유한 토큰의 양을 반환합니다.
3     */
4    function balanceOf(address account) external view returns (uint256);
복사

1    /**
2     * @dev 호출자 계정에서 `recipient`로 `amount` 만큼의 토큰을 이동시킵니다.
3     *
4     * 작업 성공 여부를 나타내는 불리언 값을 반환합니다.
5     *
6     * {Transfer} 이벤트를 발생시킵니다.
7     */
8    function transfer(address recipient, uint256 amount) external returns (bool);
복사

1    /**
2     * @dev {transferFrom}을 통해 `spender`가 `owner`를 대신하여 사용할 수 있도록 허용된 나머지 토큰 수를 반환합니다. 기본값은 0입니다.
3     *
4     * {approve} 또는 {transferFrom}이 호출되면 이 값이 변경됩니다.
5     */
6    function allowance(address owner, address spender) external view returns (uint256);
복사

1    /**
2     * @dev 호출자의 토큰에 대한 `spender`의 허용량으로 `amount`를 설정합니다.
3     *
4     * 작업 성공 여부를 나타내는 불리언 값을 반환합니다.
5     *
6     * 중요: 이 방법으로 허용량을 변경하면 불행한
7     * 트랜잭션 순서로 인해 누군가 이전 허용량과 새 허용량을 모두 사용할 수 있는 위험이 따릅니다. 이 경쟁
8     * 조건을 완화하기 위한 한 가지 가능한 해결책은 먼저 지출자의 허용량을 0으로 줄이고 그 후에
9     * 원하는 값을 설정하는 것입니다:
10     * https://github.com/ethereum/EIPs/issues/20#issuecomment-263524729
11     *
12     * {Approval} 이벤트를 발생시킵니다.
13     */
14    function approve(address spender, uint256 amount) external returns (bool);
모두 보기
복사

1    /**
2     * @dev 허용량 메커니즘을 사용하여 `sender`에서 `recipient`로 `amount` 토큰을 이동합니다. 그러면 호출자의
3     * 허용량에서 `amount`가 차감됩니다.
4     *
5     * 작업 성공 여부를 나타내는 불리언 값을 반환합니다.
6     *
7     * {Transfer} 이벤트를 발생시킵니다.
8     */
9    function transferFrom(address sender, address recipient, uint256 amount) external returns (bool);
모두 보기
복사

1
2    /**
3     * @dev `value` 토큰이 한 계정(`from`)에서
4     * 다른 계정(`to`)으로 이동할 때 발생합니다.
5     *
6     * `value`는 0일 수 있다는 점에 유의하세요.
7     */
8    event Transfer(address indexed from, address indexed to, uint256 value);
9
10    /**
11     * @dev {approve}를 호출하여 `owner`의 `spender`에 대한 허용 한도를
12     * 설정할 때 발생합니다. `value`는 새로운 허용 한도입니다.
13     */
14    event Approval(address indexed owner, address indexed spender, uint256 value);
15}
모두 보기
복사

1// SPDX-License-Identifier: MIT
2pragma solidity >=0.6.0 <0.8.0;
복사

1
2import "../../GSN/Context.sol";
3import "./IERC20.sol";
4import "../../math/SafeMath.sol";
복사

1/**
2 * @dev {IERC20} 인터페이스의 구현입니다.
3 *
4 * 이 구현은 토큰 생성 방식과 무관합니다. 즉, {_mint}를 사용하여
5 * 파생된 컨트랙트에 공급 메커니즘을 추가해야 함을 의미합니다.
6 * 일반적인 메커니즘은 {ERC20PresetMinterPauser}를 참조하세요.
7 *
8 * 팁: 자세한 내용은 가이드
9 * https://forum.zeppelin.solutions/t/how-to-implement-erc20-supply-mechanisms/226[공급 메커니즘 구현 방법]을 참조하세요.
10 *
11 * 일반적인 OpenZeppelin 가이드라인을 따랐습니다. 함수는 실패 시 `false`를 반환하는 대신
12 * 되돌려집니다. 이 동작은 관례적이며 ERC20 애플리케이션의
13 * 기대와 충돌하지 않습니다.
14 *
15 * 또한 {transferFrom}을 호출하면 {Approval} 이벤트가 발생합니다.
16 * 이를 통해 애플리케이션은 해당 이벤트를 수신하는 것만으로 모든 계정의 허용량을
17 * 재구성할 수 있습니다. EIP의 다른 구현에서는 사양에 요구되지 않으므로
18 * 이러한 이벤트를 발생시키지 않을 수 있습니다.
19 *
20 * 마지막으로, 허용량 설정과 관련된 잘 알려진 문제를 완화하기 위해
21 * 비표준 {decreaseAllowance} 및 {increaseAllowance}
22 * 함수가 추가되었습니다. {IERC20-approve}를 참조하세요.
23 */
24
모두 보기
복사

1contract ERC20 is Context, IERC20 {
복사

1
2    using SafeMath for uint256;
3
복사

1    mapping (address => uint256) private _balances;
복사

1    mapping (address => mapping (address => uint256)) private _allowances;
복사

1    uint256 private _totalSupply;
복사

1    string private _name;
2    string private _symbol;
3    uint8 private _decimals;
복사

1    /**
2     * @dev {name} 및 {symbol} 값을 설정하고, {decimals}를
3     * 기본값 18로 초기화합니다.
4     *
5     * {decimals}에 다른 값을 선택하려면 {_setupDecimals}를 사용하세요.
6     *
7     * 이 세 값은 모두 불변입니다. 즉, 생성 중에
8     * 한 번만 설정할 수 있습니다.
9     */
10    constructor (string memory name_, string memory symbol_) public {
11        // 솔리디티 ≥0.7.0에서는 'public'이 암시적이므로 생략할 수 있습니다.
12
13        _name = name_;
14        _symbol = symbol_;
15        _decimals = 18;
16    }
모두 보기
복사

1    /**
2     * @dev 토큰의 이름을 반환합니다.
3     */
4    function name() public view returns (string memory) {
5        return _name;
6    }
7
8    /**
9     * @dev 토큰의 심볼을 반환하며, 일반적으로 이름의
10     * 축약 버전입니다.
11     */
12    function symbol() public view returns (string memory) {
13        return _symbol;
14    }
15
16    /**
17     * @dev 사용자 표현을 얻는 데 사용되는 소수점 자릿수를 반환합니다.
18     * 예를 들어, `decimals`가 `2`이면, `505` 토큰의 잔액은
19     * 사용자에게 `5,05`(`505 / 10 ** 2`)로 표시되어야 합니다.
20     *
21     * 토큰은 보통 이더와 wei 간의 관계를 모방하여 18이라는 값을
22     * 선택합니다. 이는 {_setupDecimals}가 호출되지 않는 한 {ERC20}이 사용하는
23     * 값입니다.
24     *
25     * 참고: 이 정보는 _표시_ 목적으로만 사용되며, 
26     * {IERC20-balanceOf} 및 {IERC20-transfer}를 포함한 컨트랙트의 어떠한
27     * 산술 연산에도 영향을 미치지 않습니다.
28     */
29    function decimals() public view returns (uint8) {
30        return _decimals;
31    }
모두 보기
복사

1    /**
2     * @dev {IERC20-totalSupply}를 참조하세요.
3     */
4    function totalSupply() public view override returns (uint256) {
5        return _totalSupply;
6    }
복사

1    /**
2     * @dev {IERC20-balanceOf}를 참조하세요.
3     */
4    function balanceOf(address account) public view override returns (uint256) {
5        return _balances[account];
6    }
복사

1    /**
2     * @dev {IERC20-transfer}를 참조하세요.
3     *
4     * 요구 사항:
5     *
6     * - `수신자`는 0 주소일 수 없습니다.
7     * - 호출자는 최소 `금액`의 잔액을 가지고 있어야 합니다.
8     */
9    function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
모두 보기
복사

1        _transfer(_msgSender(), recipient, amount);
2        return true;
3    }
복사

1    /**
2     * @dev {IERC20-allowance}를 참조하세요.
3     */
4    function allowance(address owner, address spender) public view virtual override returns (uint256) {
5        return _allowances[owner][spender];
6    }
복사

1    /**
2     * @dev {IERC20-approve}를 참조하세요.
3     *
4     * 요구 사항:
5     *
6     * - `spender`는 0 주소일 수 없습니다.
7     */
8    function approve(address spender, uint256 amount) public virtual override returns (bool) {
복사

1        _approve(_msgSender(), spender, amount);
2        return true;
3    }
복사

1    /**
2     * @dev {IERC20-transferFrom}를 참조하세요.
3     *
4     * 업데이트된 허용량을 나타내는 {Approval} 이벤트를 발생시킵니다. 이는
5     * EIP에서 요구하지 않습니다. {ERC20}의 시작 부분에 있는 참고 사항을 참조하세요.
6     *
7     * 요구 사항:
8     *
9     * - `sender` 및 `recipient`는 0 주소일 수 없습니다.
10     * - `sender`는 최소 `amount`의 잔액을 가지고 있어야 합니다.
11     * - 호출자는 ``sender``의 토큰에 대해 최소
12     * `amount`의 허용량을 가지고 있어야 합니다.
13     */
14    function transferFrom(address sender, address recipient, uint256 amount) public virtual
15                                                override returns (bool) {
16        _transfer(sender, recipient, amount);
모두 보기
복사

1        _approve(sender, _msgSender(), _allowances[sender][_msgSender()].sub(amount,
2             "ERC20: 전송 금액이 허용량을 초과합니다"));
3        return true;
4    }
복사

1    /**
2     * @dev 호출자에 의해 `spender`에게 부여된 허용량을 원자적으로 증가시킵니다.
3     *
4     * 이것은 {IERC20-approve}에 설명된 문제에 대한 완화책으로 사용할 수 있는 {approve}의 대안입니다.
5     *
6     * 업데이트된 허용량을 나타내는 {Approval} 이벤트를 발생시킵니다.
7     *
8     * 요구 사항:
9     *
10     * - `spender`는 0 주소일 수 없습니다.
11     */
12    function increaseAllowance(address spender, uint256 addedValue) public virtual returns (bool) {
13        _approve(_msgSender(), spender, _allowances[_msgSender()][spender].add(addedValue));
14        return true;
15    }
모두 보기
복사

1    mapping (address => uint256) private _balances;
복사

1    mapping (address => mapping (address => uint256)) private _allowances;
복사

1    uint256 private _totalSupply;
복사

1처음 두 개는 자명하지만 `_decimals`는 그렇지 않습니다.
복사

1이더의 경우 ETH에 대해 10^18 wei로 정의되지만, 토큰에 대해서는 다른 값을 선택할 수 있습니다.
복사

1    /**
2     * @dev {name}과 {symbol}의 값을 설정하고, {decimals}를 기본값인 18로 초기화합니다.
3     *
4     * {decimals}에 대해 다른 값을 선택하려면 {_setupDecimals}를 사용하세요.
5     *
6     * 이 세 가지 값은 모두 불변입니다: 생성 중에 한 번만 설정할 수 있습니다.
7     */
8    constructor (string memory name_, string memory symbol_) public {
9        // 솔리디티 ≥0.7.0에서는 'public'이 암시적이므로 생략할 수 있습니다.
10        _name = name_;
11        _symbol = symbol_;
12        _decimals = 18;
13    }
모두 보기
복사

1관례적으로 함수 매개변수는 `<something>_`로 명명됩니다.
복사

1    /**
2     * @dev 토큰의 이름을 반환합니다.
3     */
4    function name() public view returns (string memory) {
5        return _name;
6    }
복사

1    /**
2     * @dev 토큰의 기호를 반환하며, 보통 이름의 짧은 버전입니다.
3     */
4    function symbol() public view returns (string memory) {
5        return _symbol;
6    }
복사

1    /**
2     * @dev 사용자 표현을 얻는 데 사용되는 소수점 자릿수를 반환합니다.
3     * 예를 들어, `decimals`가 `2`이면, `505` 토큰의 잔액은
4     * 사용자에게 `5,05`(`505 / 10 ** 2`)로 표시되어야 합니다.
5     *
6     * 토큰은 보통 18의 값을 선택하며, 이는 이더와 wei의 관계를 모방한 것입니다. 이는 {_setupDecimals}가 호출되지 않는 한
7     * {ERC20}이 사용하는 값입니다.
8     *
9     * 참고: 이 정보는 _표시_ 목적으로만 사용됩니다: 계약의 어떤
10     * 산술에도 영향을 미치지 않으며, {IERC20-balanceOf} 및 {IERC20-transfer}를 포함합니다.
11     */
12    function decimals() public view returns (uint8) {
13        return _decimals;
14    }
모두 보기
복사

1함수 호출
복사

1읽기 전용
복사

1    /**
2     * @dev {IERC20-balanceOf}를 참조하세요.
3     */
4    function balanceOf(address account) public view override returns (uint256) {
5        return _balances[account];
6    }
복사

1    /**
2     * @dev {IERC20-transfer}를 참조하세요.
3     *
4     * 요구 사항:
5     *
6     * - `recipient`는 0 주소일 수 없습니다.
7     * - 호출자는 최소 `amount`의 잔액을 가지고 있어야 합니다.
8     */
9    function transfer(address recipient, uint256 amount) public virtual override returns (bool) {
모두 보기
복사

1        _transfer(_msgSender(), recipient, amount);
2        return true;
3    }
복사

1    /**
2     * @dev {IERC20-allowance}를 참조하세요.
3     */
4    function allowance(address owner, address spender) public view virtual override returns (uint256) {
5        return _allowances[owner][spender];
6    }
복사

1    /**
2     * @dev {IERC20-approve}를 참조하세요.
3     *
4     * 요구 사항:
5     *
6     * - `spender`는 0 주소일 수 없습니다.
7     */
8    function approve(address spender, uint256 amount) public virtual override returns (bool) {
복사