【Ethereum】以太坊ERC20 Token标准完整说明

最新推荐文章于 2024-09-08 09:38:59 发布
最新推荐文章于 2024-09-08 09:38:59 发布
阅读量1.3k 收藏
点赞数

什么是ERC20 token

市面上出现了大量的用ETH做的代币，他们都遵守REC20协议，那么我们需要知道什么是REC20协议。

概述

token代表数字资产，具有价值，但是并不是都符合特定的规范。

基于ERC20的货币更容易互换，并且能够在Dapps上相同的工作。

新的标准可以让token更兼容，允许其他功能，包括投票标记化。操作更像一个投票操作

Token的持有人可以完全控制资产，遵守ERC20的token可以跟踪任何人在任何时间拥有多少token.基于eth合约的子货币，所以容易实施。只能自己去转让。

标准化非常有利，也就意味着这些资产可以用于不同的平台和项目，否则只能用在特定的场合。

ERC20 Token标准(Github)

序言

EIP: 20 
Title: ERC-20 Token Standard 
Author: Fabian Vogelsteller fabian@ethereum.org, Vitalik Buterin vitalik.buterin@ethereum.org 
Type: Standard 
Category: ERC 
Status: Accepted 
Created: 2015-11-19

总结

token的接口标准

抽象

以下标准允许在智能合约中实施标记的标记API。 该标准提供了转移token的基本功能，并允许token被批准，以便他们可以由另一个在线第三方使用。

动机

标准接口可以让Ethereum上的任何令牌被其他应用程序重新使用：从钱包到分散式交换。

规则

Token

方法

注意：调用者必须处理返回false的returns (bool success).调用者绝对不能假设返回false的情况不存在。

name

返回这个令牌的名字，比如"MyToken".

可选 - 这种方法可以用来提高可用性，但接口和其他契约不能指望这些值存在。

function name() constant returns (string name)
  • 1

symbol

返回令牌的符号，比如HIX.

可选 - 这种方法可以用来提高可用性，但接口和其他契约不能指望这些值存在。

function symbol() constant returns (string symbol)
  • 1

decimals

返回token使用的小数点后几位， 比如 8,表示分配token数量为100000000

可选 - 这种方法可以用来提高可用性，但接口和其他契约不能指望这些值存在。

function decimals() constant returns (uint8 decimals)
  • 1

totalSupply

返回token的总供应量。

function totalSupply() constant returns (uint256 totalSupply)
  • 1

balanceOf

返回地址是_owner的账户的账户余额。

function balanceOf(address _owner) constant returns (uint256 balance)
  • 1

transfer

转移_value的token数量到的地址_to，并且必须触发Transfer事件。 如果_from帐户余额没有足够的令牌来支出，该函数应该被throw。

创建新令牌的令牌合同应该在创建令牌时将_from地址设置为0x0触发传输事件。

注意 0值的传输必须被视为正常传输并触发传输事件。

function transfer(address _to, uint256 _value) returns (bool success)
  • 1

transferFrom

从地址_from发送数量为_value的token到地址_to,必须触发Transfer事件。

transferFrom方法用于提取工作流，允许合同代您转移token。这可以用于例如允许合约代您转让代币和/或以子货币收取费用。除了_from帐户已经通过某种机制故意地授权消息的发送者之外，该函数**应该**throw。

注意 0值的传输必须被视为正常传输并触发传输事件。

function transferFrom(address _from, address _to, uint256 _value) returns (bool success)
  • 1

approve

允许_spender多次取回您的帐户，最高达_value金额。 如果再次调用此函数，它将以_value覆盖当前的余量。

注意：为了阻止向量攻击，客户端需要确认以这样的方式创建用户接口，即将它们设置为0，然后将其设置为同一个花费者的另一个值。虽然合同本身不应该强制执行，允许向后兼容以前部署的合同兼容性

function approve(address _spender, uint256 _value) returns (bool success)
  • 1

allowance

返回_spender仍然被允许从_owner提取的金额。

function allowance(address _owner, address _spender) constant returns (uint256 remaining)
  • 1

Events

Transfer

当token被转移(包括0值)，必须被触发。

event Transfer(address indexed _from, address indexed _to, uint256 _value)
  • 1

Approval

当任何成功调用approve(address _spender, uint256 _value)后，必须被触发。

event Approval(address indexed _owner, address indexed _spender, uint256 _value)
  • 1

实施

在Ethereum网络上部署了大量符合ERC20标准的令牌。 具有不同权衡的各种团队已经编写了不同的实施方案：从节省gas到提高安全性。

示例实现可在

在调用之前添加力0的实施“批准”了

ERC20 Token标准接口

以下是一个接口合同，声明所需的功能和事件以符合ERC20标准：

// https://github.com/ethereum/EIPs/issues/20
  contract ERC20 {
      function totalSupply() constant returns (uint totalSupply);
      function balanceOf(address _owner) constant returns (uint balance);
      function transfer(address _to, uint _value) returns (bool success);
      function transferFrom(address _from, address _to, uint _value) returns (bool success);
      function approve(address _spender, uint _value) returns (bool success);
      function allowance(address _owner, address _spender) constant returns (uint remaining);
      event Transfer(address indexed _from, address indexed _to, uint _value);
      event Approval(address indexed _owner, address indexed _spender, uint _value);
    }

大部分Ethereum主要标记符合ERC20标准。

一些令牌包括描述令牌合同的进一步信息：

string public constant name = "Token Name";
string public constant symbol = "SYM";
uint8 public constant decimals = 18;  // 大部分都是18

如何工作？

以下是令牌合约的一个片段，用于演示令牌合约如何维护Ethereum帐户的令牌余额

contract TokenContractFragment {

     // Balances 保存地址的余额
     mapping(address => uint256) balances;

     // 帐户的所有者批准将金额转入另一个帐户
     mapping(address => mapping (address => uint256)) allowed;

      // 特定帐户的余额是多少？
      function balanceOf(address _owner) constant returns (uint256 balance) {
          return balances[_owner]; //从数组中取值
      }

      // 将余额从所有者帐户转移到另一个帐户
      function transfer(address _to, uint256 _amount) returns (bool success) {
          //判断条件 发送者余额>=要发送的值  发送的值>0  接收者余额+发送的值>接收者的余额
          if (balances[msg.sender] >= _amount 
              && _amount > 0
              && balances[_to] + _amount > balances[_to]) {
              balances[msg.sender] -= _amount;   //发送者的余额减少
              balances[_to] += _amount;         //接收者的余额增加
              return true;
         } else {
              return false;
          }
      }

      // 发送 _value 数量的token从地址 _from 到 地址 _to
      // transferFrom方法用于提取工作流程，允许合同以您的名义发送令牌，例如“存入”到合同地址和/或以子货币收取费用; 该命令应该失败，除非_from帐户通过某种机制故意地授权消息的发送者; 我们提出这些标准化的API来批准：
      function transferFrom(
          address _from,
          address _to,
          uint256 _amount
     ) returns (bool success) {
          //和上面一样的校验规则
          if (balances[_from] >= _amount
              && allowed[_from][msg.sender] >= _amount
              && _amount > 0
              && balances[_to] + _amount > balances[_to]) {
              balances[_from] -= _amount;
              allowed[_from][msg.sender] -= _amount; //减少发送者的批准量
              balances[_to] += _amount;
              return true;
         } else {
             return false;
          }
      }

      // 允许_spender多次退出您的帐户，直到_value金额。 如果再次调用此函数，它将以_value覆盖当前的余量。
      function approve(address _spender, uint256 _amount) returns (bool success) {
          allowed[msg.sender][_spender] = _amount; //覆盖当前余量
          return true;
      }
  }

token余额

假设token合约内有两个持有者

  • 0x1111111111111111111111111111111111111111有100个单位
  • 0x2222222222222222222222222222222222222222有200个单位

那么这个合约的balances结构就会存储下面的内容

balances[0x1111111111111111111111111111111111111111] = 100
balances[0x2222222222222222222222222222222222222222] = 200
  • 1
  • 2

那么，balanceOf(...)就会返回下面的结果

tokenContract.balanceOf(0x1111111111111111111111111111111111111111) 将会返回 100
tokenContract.balanceOf(0x2222222222222222222222222222222222222222) 将会返回 200
  • 1
  • 2

转移token的余额

如果0x1111111111111111111111111111111111111111想要转移10个单位给0x2222222222222222222222222222222222222222,那么0x1111111111111111111111111111111111111111会执行下面的函数

tokenContract.transfer(0x2222222222222222222222222222222222222222, 10)
  • 1

token合约的transfer(...)方法将会改变balances结构中的信息

balances[0x1111111111111111111111111111111111111111] = 90
balances[0x2222222222222222222222222222222222222222] = 210
  • 1
  • 2

balanceOf(...)调用就会返回下面的信息

tokenContract.balanceOf(0x1111111111111111111111111111111111111111) 将会返回 90
tokenContract.balanceOf(0x2222222222222222222222222222222222222222) 将会返回 210

从token余额批准和转移

如果0x1111111111111111111111111111111111111111想要批准0x2222222222222222222222222222222222222222传输一些token到0x2222222222222222222222222222222222222222,那么0x1111111111111111111111111111111111111111会执行下面的函数

tokenContract.approve(0x2222222222222222222222222222222222222222, 30)

然后allowed(这里官方文档写的是approve，很明显是错的)结构就会存储下面的内容

tokenContract.allowed[0x1111111111111111111111111111111111111111][0x2222222222222222222222222222222222222222] = 30

如果0x2222222222222222222222222222222222222222想要晚点转移token从0x1111111111111111111111111111111111111111到他自己，0x2222222222222222222222222222222222222222将要执行transferFrom(...)函数

tokenContract.transferFrom(0x1111111111111111111111111111111111111111, 20)

balances的信息就会变成下面的

tokenContract.balances[0x1111111111111111111111111111111111111111] = 70
tokenContract.balances[0x2222222222222222222222222222222222222222] = 230

然后allowed就会变成下面的内容

tokenContract.allowed[0x1111111111111111111111111111111111111111][0x2222222222222222222222222222222222222222] = 10
  • 1

0x2222222222222222222222222222222222222222仍然可以从0x1111111111111111111111111111111111111111转移10个单位。

tokenContract.balanceOf(0x1111111111111111111111111111111111111111) will return 70
tokenContract.balanceOf(0x2222222222222222222222222222222222222222) will return 230

简单修复的token合约

以下是一个样本令牌合同，固定供应量为1000000单位，最初分配给合同所有者：

pragma solidity ^0.4.8;

  // ----------------------------------------------------------------------------------------------
  // Sample fixed supply token contract
  // Enjoy. (c) BokkyPooBah 2017. The MIT Licence.
  // ----------------------------------------------------------------------------------------------

   // ERC Token Standard #20 Interface
  // https://github.com/ethereum/EIPs/issues/20
  contract ERC20Interface {
      // 获取总的支持量
      function totalSupply() constant returns (uint256 totalSupply);

      // 获取其他地址的余额
      function balanceOf(address _owner) constant returns (uint256 balance);

      // 向其他地址发送token
      function transfer(address _to, uint256 _value) returns (bool success);

      // 从一个地址想另一个地址发送余额
      function transferFrom(address _from, address _to, uint256 _value) returns (bool success);

      //允许_spender从你的账户转出_value的余额，调用多次会覆盖可用量。某些DEX功能需要此功能
      function approve(address _spender, uint256 _value) returns (bool success);

      // 返回_spender仍然允许从_owner退出的余额数量
      function allowance(address _owner, address _spender) constant returns (uint256 remaining);

      // token转移完成后出发
      event Transfer(address indexed _from, address indexed _to, uint256 _value);

      // approve(address _spender, uint256 _value)调用后触发
      event Approval(address indexed _owner, address indexed _spender, uint256 _value);
  }

   //继承接口后的实例
   contract FixedSupplyToken is ERC20Interface {
      string public constant symbol = "FIXED"; //单位
      string public constant name = "Example Fixed Supply Token"; //名称
      uint8 public constant decimals = 18; //小数点后的位数
      uint256 _totalSupply = 1000000; //发行总量

      // 智能合约的所有者
      address public owner;

      // 每个账户的余额
      mapping(address => uint256) balances;

      // 帐户的所有者批准将金额转入另一个帐户。从上面的说明我们可以得知allowed[被转移的账户][转移钱的账户]
      mapping(address => mapping (address => uint256)) allowed;

      // 只能通过智能合约的所有者才能调用的方法
      modifier onlyOwner() {
          if (msg.sender != owner) {
              throw;
          }
          _;
      }

      // 构造函数
      function FixedSupplyToken() {
          owner = msg.sender;
          balances[owner] = _totalSupply;
      }

      function totalSupply() constant returns (uint256 totalSupply) {
          totalSupply = _totalSupply;
      }

      // 特定账户的余额
      function balanceOf(address _owner) constant returns (uint256 balance) {
          return balances[_owner];
      }

      // 转移余额到其他账户
      function transfer(address _to, uint256 _amount) returns (bool success) {
          if (balances[msg.sender] >= _amount 
              && _amount > 0
              && balances[_to] + _amount > balances[_to]) {
              balances[msg.sender] -= _amount;
              balances[_to] += _amount;
              Transfer(msg.sender, _to, _amount);
              return true;
          } else {
              return false;
          }
      }

      //从一个账户转移到另一个账户，前提是需要有允许转移的余额
      function transferFrom(
          address _from,
          address _to,
          uint256 _amount
      ) returns (bool success) {
          if (balances[_from] >= _amount
              && allowed[_from][msg.sender] >= _amount
              && _amount > 0
              && balances[_to] + _amount > balances[_to]) {
              balances[_from] -= _amount;
              allowed[_from][msg.sender] -= _amount;
              balances[_to] += _amount;
              Transfer(_from, _to, _amount);
              return true;
          } else {
              return false;
          }
      }

      //允许账户从当前用户转移余额到那个账户，多次调用会覆盖
      function approve(address _spender, uint256 _amount) returns (bool success) {
          allowed[msg.sender][_spender] = _amount;
          Approval(msg.sender, _spender, _amount);
          return true;
      }

      //返回被允许转移的余额数量
      function allowance(address _owner, address _spender) constant returns (uint256 remaining) {
          return allowed[_owner][_spender];
      }
  }

注意的是，最后的例子中allowed限定的第二维的参数是调用者的转移数量，而开始的例子是接收者的数量。

参考资料

bjzhaoxiao
关注
以太坊ERC20接口使用
J_Lee
05-09 198
文章目录一、获取ETH指定代币的余额1.1 请求参数详情及解释1.2 请求响应详情及解释1.3 命令行请求实例二、ETH代币转账2.1 请求参数详情及解释2.2 请求响应详情及解释2.3 命令行请求实例三、ETH交易哈希查询3.1 请求参数详情及解释3.2 请求响应详情及解释3.3 命令行请求实例四、ETH检查智能合约交易4.1 请求参数详情及解释4.2 请求响应详情及解释4.3 命令行请求实例五、eth_call以及eth_sendTransaction区别5.1 eth_call以及eth_sendTr
【Ethereum】ERC20 Token标准完整说明
热门推荐
Code Metaverse
09-25 7万+
什么是ERC20 token市面上出现了大量的用ETH做的代币，他们都遵守REC20协议，那么我们需要知道什么是REC20协议。概述token代表数字资产，具有价值，但是并不是都符合特定的规范。基于ERC20的货币更容易互换，并且能够在Dapps上相同的工作。新的标准可以让token更兼容，允许其他功能，包括投票标记化。操作更像一个投票操作Token的持有人可以完全控制资产，遵守ERC20的toke
以太坊教程-自己动手发布 ERC20 Token
weixin_42088434的博客
11-22 1679
ERC20是以太坊网络上发行代币（Token）的一个标准协议接口，协议的github具体描述位于https://github.com/ethereum/EIPs/blob/master/EIPS/eip-20-token-standard.md。一个标准的协议促使了代币可以在不同的应用中得到使用，如钱包和去中心化交易所。目前有很多实现该标准协议的Token Examples，我们将使用https:...
Ethereum API 开源项目教程
最新发布
gitblog_00986的博客
09-08 385
Ethereum API 开源项目教程 ethereum-apiProvable API for Ethereum smart contracts项目地址:https://gitcode.com/gh_mirrors/et/ethereum-api 1. 项目的目录结构及介绍 ethereum-api/ ├── contracts/ │ ├── ProvableI.sol │ ├── u...
智能合约代码LCS
智能合约代码
04-11 750
/** *Submitted for verification at Etherscan.io on 2019-07-25 */ pragma solidity ^0.4.24; interface tokenRecipient { function receiveApproval(address _from, uint256 _value, address _token, bytes _e...
【我的区块链之路】- 在Ethereum上发布自己的token
qq_25870633的博客
07-19 1028
【转载请标明出处】：https://blog.csdn.net/qq_25870633/article/details/80761410 废话不多说。基于以太坊ERC20标准发行token我们需要先做几步准备工作；首先，需要安装chrome的插件metamask，如下图所示：（具体安装插件，这里不做赘述）                                             ...
Solidity 基础（二）语言描述-类型
chinusyan的专栏
12-20 1478
Solidity 基础（二）语言描述-类型
【Ethereum】以太坊ERC20与ERC233的区别
Code Metaverse
09-26 1万+
什么是ERC223ERC223是继ERC20后推出的新标准，解决了ERC20中的一些问题相关说明ERC223开发的主要目标1.合约中意外丢失token: 有两种不同的方式来转移ERC20 token: 1) 合约地址 2) 钱包地址 ，你需要调用transfer发送给钱包地址 或者 调用approve在token合约然后调用transferFrom在接收的合约来发送到合约。意外地，对合同地址调用
erc20_tokens:获取以太坊网络上可用的所有ERC20令牌的API及其详细信息
04-27
以太坊上ERC20代币的标准列表： 在找到npm模块。 在https://ethfaction.github.io/erc20_tokens/<network>/<data>上执行GET请求，以GET以太坊网络上所有ERC20令牌的合并json数据。 发出/拉动请求以添加任何丢失的...
otn-token：以太坊ERC20 OTN令牌智能合约
02-05
公开交易网络令牌 开放交易网络（OTN）–第一个提供跨链技术的平台，以团结所有区块链网络和市场参与者，并确保他们的最大利益。
智能合约-Solidity官方文档（1）
weixin_34013044的博客
03-22 506
写在前面：HiBlock区块链社区成立了翻译小组（以太坊中文社区），翻译区块链相关的技术文档及资料，本文为solidity官方文档翻译的第一部分《智能合约概述》，特发布出来邀请solidity爱好者、开发者做公开的审校，您可以添加微信baobaotalk_com，验证输入“solidity”，然后将您的意见和建议发送给我们，也可以在文末“留言”区留言，有效的建议我们会采纳及合并进下一版本，同时将...
技术：Node.js库，用于通过HTTP以Ether和ERC20令牌进行微支付
02-05
莫诺里莫莫诺雷波 Machinomy Lerna Monorepo存储库。 可用子项目： 是一个Node.js库，用于通过HTTP进行以太中的小额支付。 它使您可以立即发送和接收少量资金。 是由使用的管理的以太坊合同的TypeScript接口。 是机例子。 包含代码 是Machinomy命令行界面。 是Machinomy Logger。 在浏览器和Node中工作。 是松露合约的Machinomy包装器。 网站： 。 Twitter： 。 支持/讨论： 。 常见问题解答： 。 安装 必须使用和Node.js v9 （请勿使用npm！ ） $ yarn add mach
BNB代码解读
weixin_43977647的博客
05-14 5729
1.BNB代码 我们先来看下BNB的代码，没错就是这短短100多行代码，市值可是好多好多亿呢哈哈哈哈。 /** *Submitted for verification at Etherscan.io on 2017-07-06 */ pragma solidity ^0.4.8; /** * Math operations with safety checks */ contract SafeMath { function safeMul(uint256 a, uint256 b) inte
ERC20合约标准详解分析
大IT职男日志
06-24 2680
contract ERC20 { //**********9个函数******* //1.代币的名字，如："黑马币" function name() constant public returns (string name); //2.代币的简称，例如：HMB function symbol() public constant returns (string symbol); //3.代币的最小分割量 token使用的小数点后几位。比如如果设置为3，就是支持0.001表示 function d...
ERC20协议API接口规范
J_Lee
06-09 1003
ERC20协议API接口规范
获取ETH指定代币的余额
心境
08-02 1万+
引言 之前的文章介绍了获取eth余额的方法和离线签名的方法（指定代币的离线签名），今天就来介绍一下如何获取满足ERC20协议的代币余额的。 要想获取代币的余额，要通过rpc接口得到接口为：eth_call 参数 1.object字段： from: 钱包地址 to: 代币地址（智能合约地址） data：0x70a08231000000000000000000000000b60e8dd61...
PHP实现ETH ERC20签名交易
路漫漫其修远兮 吾将上下而求索
02-27 3078
PHP实现ETH ERC20签名交易
以太坊根据ERC20标准开发代币
rejames的博客
05-18 2224
以太坊ERC20代币开发首先需要对以太坊,代币,ERC20,智能合约等以太坊代币开发中的基本概念有了解。根据我们的示例代码就可以发行自己的以太坊代币。 什么是ERC20 可以把ERC20简单理解成以太坊上的一个代币协议，所有基于以太坊开发的代币合约都遵守这个协议。遵守这些协议的代币我们可以认为是标准化的代币，而标准化带来的好处是兼容性好。这些标准化的代币可以被各种以太坊钱包支持，用于不同的平台...
ETH发token的原理步骤！
weixin_43343144的博客
12-25 2344
                   
智能合约审计必备：Solidity审核清单要点解析
"ethereum", "smart-contracts", "blockchain", "audit", "solidity", "awesome-list", "token", "erc20", "crowdsale", "tokensale"，体现了这个清单的重要性，它不仅是Solidity智能合约的最佳实践和安全审核参考，...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值