【以太坊通证标准】ERC20系列,ERC721系列,ERC865
有个胖子他姓杨
发表于 2022-11-30 20:15:57
168
0
0
【本文目标】- n# |1 U: L; ]. w! ^
通过本文学习,了解ERC定义及知名ERC协议标准,如ERC20以及ERC223、ERC621,ERC777,ERC827,ERC1410协议; ERC721以及 ERC875,ERC1155,ERC998协议,ERC 865等描述和定义。) S: }, I1 H6 m
#2,ERC的定义及标准列表7 E5 {4 b) |. O5 J% O6 ^: F
ERC代表“Etuereum Request for Comment",这是Ethereum版的意见征求稿 (RFC),RFC是由互联网工程任务组制定的一个概念。 RFC中的备忘录包含技术和组织注意事项。 对于ERC,意见征求稿中包括一些关于以太坊网络建设的技术指导。
ERC是Ethereum开发者为以太坊社区编写的。 因此,ERC的创建流程中包括开发人员。 为了创建一个以太坊平台的标准,开发人员应当提交了一个以太坊改进方案(EIP), 改进方案中包括协议规范和合约标准。 一旦EIP被委员会批准并最终确定,它就成为ERC。 EIP的完整列表可以在GITHUB网址找到。4 g! N& R' P( Q0 u- ?& t8 R1 r' ~
EIP有4种状态:
草稿(Draft) - 处于打开状态,便于考察讨论;- _. _) {( d3 H, @/ ~( O
接受(Accepted) - 即将被接受,例如将包含在下一个硬分叉中;
定稿(Final)- 在上一个硬分叉中被接受,已定稿;0 P& b5 u3 K6 |
延期(Deferred)- 不会马上被接受,但也许在将来的硬分叉版本会考虑。
最终确定的EIP为以太坊开发者提供了一套可实施的标准。 这使得智能合约可以遵循这些通用的接口标准来构建。4 w3 M: I3 u; A; Y5 `4 X
ERC-20是整个加密社区中最为人熟知的标准,在Ethereum平台之上发布的大多数通证(token)都使用它。
#3,ERC20系列 - ERC20、ERC223、ERC621, ERC777,ERC827,ERC1400) H" y P3 {5 l: l P
##3.1 ERC20标准8 p0 u9 I+ G6 c- [# q* H- H. Q* f
状态:3 z+ d8 L3 s0 F6 T) {& _; `; `( L( l
定稿(Final)提交记录:
https://github.com/ethereum/EIPs/issues/20标准说明:. L# j) R/ a1 v; _# \' I) ]
https://github.com/ethereum/EIPs/blob/master/EIPS/eip-20.md推荐样例:% Y) t& i, o" E# _7 P/ J
https://github.com/OpenZeppelin/openzeppelin-solidity/tree/master/contracts/token/ERC20: O5 H+ D. [* n% Y# D3 N U4 ?
ERC-20标准中定义了以下函数接口:4 t) `. n) z8 ]" Q, L2 |$ _
totalSupply():4 B! c% }* L" `5 i9 G$ l
返回代币供给总量balanceOf(address _owner):. q7 M' ^$ K$ d
返回_owner的帐户余额transfer(address _to,uint256 _value):8 C8 W6 |1 H2 }" w& L7 q
并将数量为_value的代币转入地址_to并触发transfer事件transferFrom(address _from,address _to,uint256_value):
将地址_from中的_value数量的代币转入地址_to ,并触发transfer事件approve(address _spender,uint256 _value):
允许_spender提取限额_value的代币allowance(address _owner,address _spender):& s' ~; q @6 m! N4 W% H9 u/ x6 Y
返回_spender可从_owner提款的代币数量上限4 c* Q3 M$ Q n5 z! k" A6 E
ERC-20于2015年提出并于2017年9月正式实施。这是代币标准化的一个很好的起点。 然而,开发者社区 已经注意到它存在一些缺陷和漏洞,此外,还有一些场景它不能很好的满足。因此陆续提出了其他的ERC标准。
##3.2 ERC2237 N& U8 E- h$ ]6 L# o1 e7 w( F/ {
状态: c/ ]2 C5 v6 a9 e# Y
草稿(Draft)提交记录:
https://github.com/ethereum/EIPs/issues/223标准说明:
https://github.com/Dexaran/ERC223-token-standard推荐样例:4 C! t# u) a! N6 g9 X
https://github.com/Dexaran/ERC223-token-standard/tree/Recommended5 X, {% }) x) s9 h5 W
: {2 R9 ]- k T& H+ v! D1 M0 l
开发人员Dexaran在一篇文章中详细描述了ERC20不适合的两种场景:
“在ERC20中执行交易有两种方式:transfer函数,approve + transferFrom机制,通证余额只是通证合约中的一个变量。
通证的交易是合约内部变量的变化。 转出账户的余额将减少,转入账户的余额将增加。
交易发生时, transfer()函数不会通知转入账户。 因此转入账户将无法识别传入的交易! 我写了一个例子,可以展示这一导致未处理的交易和资金损失的过程 。% }- I6 S5 A( x/ X) u; p1 B
因此,如果接收账户是合约账户,那么必须使用approve + transferFrom机制来发送通证。
如果接受账户是外部帐户,则必须通过transfer函数发送通证。 如果选择了错误的机制,通证将卡在合约内(合约将不会识别交易),没有办法来提取这些卡壳的通证。“
他对这个问题提出的解决方案包含在ERC-223中 。 它与ERC-20标准非常相似,但解决了上述问题。当通证转移到智能合约账户时,该合约的特殊函数tokenFallback() 允许接收方合约拒绝令牌或触发进一步的操作。 大多数情况下,这可以用来代替approve()函数。* z8 v/ [/ K0 F$ u3 S$ X
函数接口:
transfer(address _to, uint _value):
会区分代币是发往外部账户地址还是发往智能合约地址。0 ?: e' D% y4 t, J$ K/ k
transfer(address _to, uint _value, bytes _data):
会区分代币是发往外部账户地址还是发往智能合约地址,还可以传送数据。
1、如果_to是合约,则此函数必须传输令牌并调_to中的函数tokenFallback(address,uint256,bytes)。2、如果_to(接收方合同)中没有实现tokenFallback函数,则事务必须失败,并且不会发生令牌的传输。3、如果_to是外部拥有的地址,则必须发送事务,而不尝试在_to中执行tokenFallback。4、_data可以附加到这个令牌交易中,它将永远保持在块状(需要更多的gas)。 _data可以是空的。
1 ^ y% f) P- K) N' f$ B
注意:检查_to是合约还是地址的推荐方法是组装_to的代码。 如果_to中没有代码,那么这是一个外部拥有的地址,否则就是一个合约。2 M& U% h4 C$ B- l5 K W
//assemble the given address bytecode. If bytecode exists then the _addr is a contract.% U; T+ h0 u1 j4 r/ W% A
function isContract(address _addr) private view returns (bool is_contract) {
uint length;, J1 Z" |! T/ A" l, w0 D3 y
assembly {) e0 X2 t4 ]- E9 S
//retrieve the size of the code on target address, this needs assembly
length := extcodesize(_addr)6 |) j# k" ~1 ] u6 b' O6 b Q
}
return (length>0);
}1 M9 L- c# m- F! V
function tokenFallback(address _from, uint _value, bytes _data), c+ r, w( I, @+ s4 g" S9 m3 A( q4 i
_from是令牌发送者,_value是传入令牌的数量,_data是附加的数据,类似于Ether事务中的数据。 适用于以太交易的回退功能,并且不返回任何内容。4 f* T _; F( L5 W; [4 j
tokenFallback – 令牌持有者发送令牌时处理从令牌合同所调用的令牌传输的功能3 |6 G7 C' q" v1 H& h$ Z: B7 ?
注意:msg.sender将是tokenFallback函数内的令牌合同。 过滤哪些令牌(通过令牌契约地址)发送可能很重要。 令牌发送者(谁发起了代币交易的人)在_from thetokenFallback函数内。: V3 u7 P0 C9 l6 b9 h% G- z
示例代码:
ERC223_Interface.sol
pragma solidity ^0.4.9;0 \! z' t) v/ x: E6 z+ t
/* 新的 ERC23 contract 接口文件 */
contract ERC223 {6 h, C& I# J3 M1 z1 S( b8 M
uint public totalSupply;& v: O) W; ?% o( F X
function balanceOf(address who) constant returns (uint);1 j! ] d1 _; w$ _4 H2 a5 ^
function name() constant returns (string _name);4 [8 F5 r2 [5 l
function symbol() constant returns (string _symbol);
function decimals() constant returns (uint8 _decimals);' b6 Z$ {" h% ^# \, h7 g
function totalSupply() constant returns (uint256 _supply);7 U9 `; p! a6 K
function transfer(address to, uint value) returns (bool ok);
function transfer(address to, uint value, bytes data) returns (bool ok);1 A" V7 i/ a" ]/ L$ a; n2 B( _
function transfer(address to, uint value, bytes data, string custom_fallback) returns (bool ok);
event Transfer(address indexed from, address indexed to, uint value, bytes indexed data);5 ~- E7 B" E4 [' ?) ~3 {
}. m/ \" j& e/ d; P2 u Y/ x7 Z
Receiver_Interface.sol
pragma solidity ^0.4.9;
/*! j. L! N4 h' P6 i8 {0 q
* Contract that is working with ERC223 tokens
*/
contract ContractReceiver {8 ?: p, T# J. d* W$ e
struct TKN {" \- M% @4 u1 s+ p: u
address sender; //调用合约的人
uint value;
bytes data;
bytes4 sig; //签名
}
function tokenFallback(address _from, uint _value, bytes _data){
TKN memory tkn;
tkn.sender = _from;
tkn.value = _value;& x$ a3 l7 G6 a6 H8 g7 t
tkn.data = _data;
uint32 u = uint32(_data[3]) + (uint32(_data[2]) 7 I: |, X+ K5 U0 b; G. n
ERC223_Token.sol
pragma solidity ^0.4.9; ?4 q" X$ {. f8 y: I6 ?% m9 t0 ^
import "./Receiver_Interface.sol";
import "./ERC223_Interface.sol";
/**) W" R- H$ q7 |/ B3 L
* ERC23 token by Dexaran$ L& ~& B5 W5 Z/ L4 M$ f3 _
*2 M$ b: K( W8 N, X! i. b' B
* https://github.com/Dexaran/ERC23-tokens
* https://github.com/LykkeCity/EthereumApiDotNetCore/blob/master/src/ContractBuilder/contracts/token/SafeMath.sol
*/
contract SafeMath {/ F: }3 }$ l2 ^! Y: L* Y/ q0 d
uint256 constant public MAX_UINT256 = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF;9 a% S& z5 \' u# N$ b, c- K
function safeAdd(uint256 x, uint256 y) constant internal returns (uint256 z) {
if (x > MAX_UINT256 - y) throw;. }& |7 |. f& {2 U! N) S
return x + y;. _4 J% ?, O: W! b# R2 Q# I5 ]' Q
}9 O* Y3 f* e1 q4 ]! @
function safeSub(uint256 x, uint256 y) constant internal returns (uint256 z) {- i( U2 y" I- Z- |' ^8 P, x
if (x MAX_UINT256 / y) throw;
return x * y;
}: W0 I3 J# w% Y. c' g
}- P" |8 e$ q4 C4 h6 g
//示例的智能合约代码
contract ERC223Token is ERC223, SafeMath {3 x; A# \/ t/ \/ L8 Z! f3 M
mapping(address => uint) balances;
string public name;
string public symbol;
uint8 public decimals;
uint256 public totalSupply;
// 获取token的名称, R9 @4 p' o8 B, j& Z6 f
function name() constant returns (string _name) {* _5 I! D4 i2 k! l0 v( B
return name;+ ^/ [ r8 R. J* ?+ h+ V; Y/ x
}
// 获取token的符号
function symbol() constant returns (string _symbol) {' U1 N6 b$ F; M
return symbol;
}
// 获取token精确到小数点后的位数7 m: L* _( h! c( K9 }
function decimals() constant returns (uint8 _decimals) {; [0 H, q% Y& e7 O! v" {
return decimals;
}0 d2 g) y1 L$ s5 f$ Z6 k9 F
// 获取token的发布总量
function totalSupply() constant returns (uint256 _totalSupply) {( [6 y7 a- m1 O# g, ^1 r4 c
return totalSupply;
}; G" i9 Q+ m' ?7 U
// 当用户或其他合同想要转移资金时调用的功能。( `, v, f& e* c+ J9 H
function transfer(address _to, uint _value, bytes _data, string _custom_fallback) returns (bool success) {9 b& y5 f& U6 N5 d: t+ h: H
//如果to是合约/ A' D) I& D0 W& v" L' c$ A
if(isContract(_to)) {# K( |' H% m7 W
if (balanceOf(msg.sender) 0);$ u( r( z1 W- ?0 B5 U
}
//当传递目标是一个地址时调用函数
function transferToAddress(address _to, uint _value, bytes _data) private returns (bool success) {+ @) v- w+ K, u
if (balanceOf(msg.sender) * I" Q: A0 d. N9 r! {
##3.3 ERC621
" {, U2 E& c, r& Z* ^+ m- n" J
状态:
草稿(Draft)
# u8 F9 W6 d' E7 h8 Y
提交记录: }% z" F2 P4 \# W6 Y
https://github.com/ethereum/EIPs/issues/621) [3 @+ M: H# t, ?* I/ q p
标准说明:3 A6 r& f+ l) s) `3 `( m" u6 @
推荐样例:# Z! ~3 c: P y# [0 p" X2 ~& S v
https://github.com/skmgoldin/EIP621Token/blob/master/contracts/EIP621Token.sol# P- ?5 P7 r. e0 m" x3 E9 K
6 D% w6 k3 b) B! ?
ERC-621是ERC-20标准的扩展。 它增加了两个额外的功能, increaseSupply和decreaseSupply 。这可以增加和减少流通中的令牌供应。 ERC-20只允许单一的通证发放事件。 这将供应量限制在一个固定的不可改变的数目。 ERC-621建议totalSupply应当是可修改的。5 _0 ^! a+ x8 k
接口函数说明:
increaseSupply(uint value, address to):
可以给特定账户to增加value值的供应量,代币总供应量totalSupply也同步增加;; o' Z+ Z0 k6 ~- ]7 p
decreaseSupply(uint value, address from):
可以给特定账户to减少value值的账户余额,代币总供应余额totalSupply也同步减少;" F, ?7 K/ R% k! f- g
##3.4 ERC777
2 ^* L$ W* d. W9 R' S
状态:3 A1 r L! a, [* l; Z
草稿(Draft)
提交记录:% y5 q+ M0 n. }8 T
https://github.com/ethereum/EIPs/issues/777
0 z0 k% {8 ~3 Q0 v' {4 F6 f
标准说明:2 w. ^8 ?+ X. @! K! p0 F) G, I
https://eips.ethereum.org/EIPS/eip-7778 p+ r+ c/ x- z/ n B: _# z8 |
- ~- I) R7 b9 |: f
推荐样例:
https://github.com/jacquesd/ERC777/tree/devel/contracts
功能描述
本标准用于提升ERC20标准的使用范围。这个标准的主要优点有:! V2 I* E- A6 }" S- }
可以同使用Ether一样的原理使用ERC777通证,通证发送采用函数send(dest, value, data)的。不管是合约还是常规的地址都可以控制和拒绝那些通过注册tokensToSend 钩函数发送的通证(通过在钩函数内部执行reverting回滚函数触发拒绝。)不管是合约还是常规的地址都可以控制和拒绝那些通过注册tokensToSend 钩函数接收的通证(通过在钩函数内部执行reverting回滚函数触发拒绝。)tokensReceived 勾函数运行发送通证给一个合约,并在一次交易中通知完成,不像ERC20需要2次通知(approve/transferFrom) 才能达到相同效果。通证持有者可以“授权”和“撤销”可以代表他们发送通证的操作员。这些操作员用于验证合约,如交易所,支票处理器或自动收费系统。每次通证交易都包含一个“data”字节字段和一个类似的“operatorData”,可以自由地用于将数据传递给接收方。通过部署实现钱包的“tokensReceived”钩子的代理合约,它与不包含“tokensReceived”钩子功能的钱包向后兼容。6 }7 P% M R6 O
协议代码2 [+ `' H0 |8 l0 m& C3 s' C
interface ERC777Token {% K0 w. J3 f0 z% q" _. g
function name() public view returns (string);+ G1 S/ Z8 C0 t( U
function symbol() public view returns (string);
function totalSupply() public view returns (uint256);
function balanceOf(address owner) public view returns (uint256);3 C! I; S" X; q+ m8 [
function granularity() public view returns (uint256);* L' c; }7 h: X
function defaultOperators() public view returns (address[]);
function authorizeOperator(address operator) public;
function revokeOperator(address operator) public;) Y9 i. e$ {4 d7 y% @
function isOperatorFor(address operator, address tokenHolder) public view returns (bool); B$ S+ L6 ^. ~
function send(address to, uint256 amount, bytes data) public;
function operatorSend(address from, address to, uint256 amount, bytes data, bytes operatorData) public;" d. }$ T x8 l7 r% r
function burn(uint256 amount, bytes data) public;! v3 Q/ M* Z' g h$ {" K3 [
function operatorBurn(address from, uint256 amount, bytes data, bytes operatorData) public;
event Sent(
address indexed operator,) [, a, z0 q1 Y
address indexed from,
address indexed to,% p' h2 z# B) B4 U' r' b
uint256 amount,
bytes data,# ?, ]2 D$ Y" t4 W6 H- ]
bytes operatorData2 _; z" @, y8 J; m; j
);
event Minted(address indexed operator, address indexed to, uint256 amount, bytes data, bytes operatorData);
event Burned(address indexed operator, address indexed from, uint256 amount, bytes operatorData);
event AuthorizedOperator(address indexed operator, address indexed tokenHolder);9 p& D6 W7 w2 a! r! y# e
event RevokedOperator(address indexed operator, address indexed tokenHolder);
}
##3.5 ERC827
$ g% \$ V* R% f$ J
状态:: B' I7 q3 _5 N+ |+ [ D
草稿(Draft)
提交记录:
https://github.com/ethereum/EIPs/issues/827
标准说明:
2 y9 O$ f$ d M! q
推荐样例:" i" [3 o& I6 e" {, X" F
https://github.com/windingtree/erc827/blob/master/contracts/ERC827/ERC827Token.sol( z( e8 }! o% N, U p/ B4 H5 _
+ Y: }, J, S2 ]/ C7 g7 U( `2 A
它允许转让通证并允许持有人允许第三方使用通证。 以太坊上的通证可以被其他应用程序重复使用,这其中也包括钱包和交易所。 当需要支持第三方动态消费限额调整时这一点非常有用。
该标准目前处于草稿状态,并被证明有使用安全风险,建议暂不使用。$ {; X* s1 `0 r' g7 H4 l) f
##3.6 ERC1400(ERC1410,ERC1411)6 a1 ?1 ?! e/ ]) i1 Z5 Y. `
状态:+ J7 z; k8 V7 f2 r
草稿(Draft)7 _& c8 d- w: C& u
提交记录:0 {+ M8 @( ~" g$ c) _6 u) E
1)ERC 1410: Partially Fungible Token Standard:
https://github.com/ethereum/EIPs/issues/14101 K2 R5 m i3 C5 J- d) ]+ p" d
2)ERC 1400: Security Token Standard #1411' `6 k2 c7 \% ?8 H3 I7 F9 E! r. A
https://github.com/ethereum/EIPs/issues/1411
标准说明" h; v7 W9 X1 S* ^
$ \$ {6 D/ _, Q5 G5 }8 l
推荐样例:# }2 K% V0 r% F' `$ W8 H- g. `
https://blog.neufund.org/good-protocols-how-to-properly-standardize-security-tokens-95ff83c81c4a
标准说明0 `1 D9 d8 n! o [
无论是 ERC20 还是 ERC777,每个单位的 Token 都是相同的,并无附加属性,属于 fungible token(同质化代币/可互换 Token)。ERC721标准的 Token,每个 Token 均有不同的ID,不同ID可以有不同的解释,属于 no-fungible token(非同质化 Token,不可互换 Token)。7 c, E" \1 d) H3 z
ERC1410标准的 Token 属于Partially-Fungible Token (部分可互换 Token ),将 ERC20/ERC777 中不存在解释属性的余额,附加额外的信息,从而划分成不同的部分,就可以做一些操作上的限制(例如:某些操作只限定于指定 tranche 的 Token,某些操作优先消耗指定tranche的 Token)。9 P7 q5 m2 s4 h
ERC1400 则是继承 ERC1410 标准,增加了证券相关业务会使用到的函数:证券增发,相关法律文件存储等。- s- a7 t4 R6 [# ?+ r- Z
先前一些证券型 Token 的合约大多是在 ERC20 标准的基础上,通过维护一个或多个以太坊地址集合,对这部分地址做出了划分:是否通过kyc,是否处于锁定期等,来进行转账上的限制。这些都是在地址层面做出不同的解释。而 ERC1400 对 Token 本身做了不同解释,以适用于更复杂的证券相关业务场景。3 F2 b8 z+ f! e0 R
关于ERC20,以及其它ERC成员的关系,可见下图:( f5 M6 n& x1 T# m
函数接口说明
/// @title ERC-1410 Partially Fungible Token Standard
/// @dev See https://github.com/SecurityTokenStandard/EIP-Spec' ~- W( \+ v8 u% q! b) @
interface IERC1410 is IERC777 {& r7 Z* I3 m w
// Token Information
function balanceOfByTranche(bytes32 _tranche, address _tokenHolder) external view returns (uint256);0 N5 P8 h* G9 ]# F6 D
function tranchesOf(address _tokenHolder) external view returns (bytes32[]);$ v, V' u; o l% Z1 L. a2 a0 l
// Token Transfers
function sendByTranche(bytes32 _tranche, address _to, uint256 _amount, bytes _data) external returns (bytes32);
function sendByTranches(bytes32[] _tranches, address _to, uint256[] _amounts, bytes _data) external returns (bytes32[]);
function operatorSendByTranche(bytes32 _tranche, address _from, address _to, uint256 _amount, bytes _data, bytes _operatorData) external returns (bytes32);
function operatorSendByTranches(bytes32[] _tranches, address _from, address _to, uint256[] _amounts, bytes _data, bytes _operatorData) external returns (bytes32[]);; i0 |$ B* H4 ~! W* N; q' h
// Default Tranche Management- _2 c1 b, h5 h ]9 L- l9 F
function getDefaultTranches(address _tokenHolder) external view returns (bytes32[]);+ f+ U7 \9 }6 L e" B* w* T
function setDefaultTranche(bytes32[] _tranches) external;
// Operators' M4 ^6 M2 |( b/ B
function defaultOperatorsByTranche(bytes32 _tranche) external view returns (address[]);
function authorizeOperatorByTranche(bytes32 _tranche, address _operator) external;8 S! B$ i+ F2 m9 G4 P! t
function revokeOperatorByTranche(bytes32 _tranche, address _operator) external;
function isOperatorForTranche(bytes32 _tranche, address _operator, address _tokenHolder) external view returns (bool);+ t9 |) s2 g3 {; R- u5 S7 Z" s
// Transfer Events
event SentByTranche(
bytes32 indexed fromTranche,
address operator,; b; u5 U1 n# N$ Q
address indexed from,
address indexed to,
uint256 amount,) P( Y- L; I+ u, h
bytes data,
bytes operatorData2 x% j" v6 m0 l
);' f \( A, m, ^8 p
event ChangedTranche(+ |: ]. r+ \8 g5 p+ b2 q3 ~) T9 S
bytes32 indexed fromTranche, F3 }. x" H$ m. m. J
bytes32 indexed toTranche,& g- n1 ~" L5 ` g" I
uint256 amount,) j+ M2 j P2 e6 x( t! _5 P
);. w- n/ U. x w
// Operator Events
event AuthorizedOperator(address indexed operator, address indexed tokenHolder);4 Q5 U& A; q- k. |. ~
event RevokedOperator(address indexed operator, address indexed tokenHolder);
event AuthorizedOperatorByTranche(bytes32 indexed tranche, address indexed operator, address indexed tokenHolder);% [$ x1 T5 I" E8 }: g! j3 N: \
event RevokedOperatorByTranche(bytes32 indexed tranche, address indexed operator, address indexed tokenHolder);3 G& g5 E; W' ^' `2 c
} v" u0 U/ S v- n
/// @title IERCST Security Token Standard (EIP 1400)$ ?; l/ K. {* U: J0 W W
/// @dev See https://github.com/SecurityTokenStandard/EIP-Spec/ c. N8 W0 v# q2 q$ d0 K
interface IERCST is IERCPFT {
// Document Management
function getDocument(bytes32 _name) external view returns (string, bytes32);) h) N1 }) l2 t! T6 M* J
function setDocument(bytes32 _name, string _uri, bytes32 _documentHash) external;
// Controller Operation
function isControllable() external view returns (bool);
// Token Issuance: p! y$ V, i' }& L# Y
function isIssuable() external view returns (bool);
function issueByTranche(bytes32 _tranche, address _tokenHolder, uint256 _amount, bytes _data) external;
event IssuedByTranche(bytes32 indexed tranche, address indexed operator, address indexed to, uint256 amount, bytes data, bytes operatorData);
// Token Redemption5 k+ R: L) C9 f
function redeemByTranche(bytes32 _tranche, uint256 _amount, bytes _data) external; l) Y5 W5 a8 x+ U: J2 \6 P& c1 ^
function operatorRedeemByTranche(bytes32 _tranche, address _tokenHolder, uint256 _amount, bytes _operatorData) external;: i& u0 ~: l( A1 V. W2 H
event RedeemedByTranche(bytes32 indexed tranche, address indexed operator, address indexed from, uint256 amount, bytes operatorData);
// Transfer Validity
function canSend(address _from, address _to, bytes32 _tranche, uint256 _amount, bytes _data) external view returns (byte, bytes32, bytes32);; o7 J" A2 E7 _( u
}
#4,ERC721系列. j1 C, p5 D2 V2 _5 k5 G/ {, j
#4.1 ERC721
状态:
定稿(Final)提交记录:
https://github.com/ethereum/EIPs/issues/721标准说明:
https://github.com/ethereum/EIPs/blob/master/EIPS/eip-721.md推荐样例: G- g! @% w, i# B( R2 d
1)https://www.cryptokitties.co/
2)https://github.com/OpenZeppelin/openzeppelin-solidity/tree/master/contracts/token/ERC721
ERC-721与ERC-20和ERC-223都大不相同。 它描述了一个不可互换的通证,官方简要解释是Non-Fungible Tokens,简写为NFTs,多翻译为非同质代币。 这意味着每个通证是完全不同的,并且每个通证对不同的用户都有不同的价值。 理解这种通证的一个方法就是回忆CryptoKittes。 每一个数字猫都是独立的,其价值取决于其稀缺性和用户的购买欲。: s4 B A( y3 i
ERC-721令牌可用于任何交易所,但通证价值是“每个通证的唯一性和稀缺性所决定的结果”。标准中规定的接口函数包括name、symbol、totalSupply、balanceOf、ownerOf、approve、takeOwnership 、 transfer 、tokenOfOwnerByIndex和tokenMetadata 。 它还定义了两个事件: Transfer和Approval 。 Gerald Nash的 这篇文章很好地解释了可互换性的概念。% V. h9 h8 ~2 C7 x5 ]
函数接口说明:
balanceOf(address _owner):
返回由_owner 持有的NFTs的数量。ownerOf(uint256 _tokenId):
返回tokenId代币持有者的地址。exists(uint256 _tokenId):9 U: i6 ~& _9 f; \# E% y0 G
tokenId代币是否存在,返回BOOL值;approve(address _to, uint256 _tokenId):$ ]; m4 V8 m! z( h) N* M
授予地址_to具有_tokenId的控制权,方法成功后需触发Approval 事件。getApproved(uint256 _tokenId):: Z6 M$ D# L: x' j/ l
获得_tokenId授权的地址;setApprovalForAll(address _operator, bool _approved):
授予地址_operator具有所有NFTs的控制权,成功后需触发ApprovalForAll事件。isApprovedForAll(address _owner, address _operator):
用来查询授权。transferFrom(address _from, address _to, uint256 _tokenId)8 H: c2 n- F* X" B3 G
不建议使用本函数,建议使用safeTransferFrom函数。safeTransferFrom(address _from, address _to, uint256 _tokenId):
把_tokenId代币从_from账户安全转移到_to账户,安全是指如果目标地址为合约地址,则执行onERC721Received进行资产转移,否则的话交易会回滚;如果目标地址为外部账号地址,则正常转移。7 i G% w6 r! S2 u# O9 X
* G; Z4 {5 B* e
更深度分析的文章参考《【基于ERC721的区块链游戏】迷恋猫从玩耍到开发》。+ l: K$ c0 I: T6 y' U
#4.2 ERC875
. o; @4 t" _5 v, X4 E
状态:9 l' }7 t6 x! d1 J, L
还处于pull request下(issue)
% D6 g8 f! {2 d: U: x- N, u1 y
提交记录:
https://github.com/ethereum/EIPs/issues/8752 b+ q' h! o& D6 j
标准说明:
推荐样例:7 e/ X- i$ t) k( x! ?- f) ^9 O
https://github.com/alpha-wallet/ERC875-Example
+ I/ n- N, w! L x
6 B$ R( o# c: F1 ]" Q
AlphaWallet自主开发了ERC875协议族。该协议不仅会让数字资产变得具有收藏价值,同时也能帮助现实世界中不可拆分替代、具有物权唯一性的资产上链,这就能为线下服务的链上操作提供了可能性。# J2 _$ q5 W5 @5 a( Y8 O) T2 \
虽然另一种协议ERC721也能实现token的不可置换性,但其存在需要交易双方支付gas费用、无法简单实现原子化交易等一些不易于用户使用的问题。" y6 }# y! o. M7 j
ERC875内置了两个密码学协议, 一方面能够简单实现原子化交易(atomic swap)——直接搭建去中心化市场、降低普通用户使用门槛,卖家无需持有以太币,买家支付一次gas即能完成;另外一方面可以简单打包处理大量交易。
拿基于ERC721的加密猫来说,换用ERC875协议的话,能够实现。用户在商家网站法币购猫,通过MagicLink免费把猫导入用户的钱包,之后用户还可以在不需要持有以太币的情况下,通过MagicLink把猫售出或者免费转让,全部过程都是无中心的原子化交易。另外商家可以一次批发100只猫给分销商。, `' a- D# H+ G/ `
接口函数或者变量说明/ S: Z( N8 d4 r; }- P
totalTickets:inventory:ticketIndex:expiryTimeStamp:owner:admin:transferFee:numOfTransfers:name:symbol:decimals:Token(uint256[] numberOfTokens, string evName,uint expiry, string eventSymbol, address adminAddr):/ V; D- b/ M$ S+ ^% a6 w: u2 e
构建函数,样例如example: [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15], “MJ comeback”, 1603152000, “MJC”, “0x007bEe82BDd9e866b2bd114780a47f2261C684E3”]getDecimals():
返回代币的小数点后位数值;trade(uint256 expiry,uint256[] tokenIndices,uint8 v,bytes32 r,bytes32 s): n* o3 L! L. J, l: `% k
交易函数,例如:0, [3, 4], 27, “0x2C011885E2D8FF02F813A4CB83EC51E1BFD5A7848B3B3400AE746FB08ADCFBFB”, “0x21E80BAD65535DA1D692B4CEE3E740CD3282CCDC0174D4CF1E2F70483A6F4EB2”encodeMessage(bytes12 prefix, uint value,uint expiry, uint256[] tokenIndices):name():7 }8 {/ o9 k/ U7 J" T9 k6 b- r
返回代币名称;symbol():
返回代币表示;getAmountTransferred():
返回已传输的数量;isContractExpired():
合约是否过期;balanceOf(address _owner):& I$ v# V! q% q' v/ W$ D
返回账户余额;myBalance():transfer(address _to, uint256[] tokenIndices): r" ?) e H" B1 R
资产转账;transferFrom(address _from, address _to, uint256[] tokenIndices):endContract():. y. M% m: l: f& P
结束合约;getContractAddress(): i1 m8 u" Q& C) ]8 u$ Y
获取合约地址;
#4.3 ERC998' F/ u# Q4 h5 T- N& u8 j
状态:
草稿(Draft)( A, b9 B& @( A
提交记录:
https://github.com/ethereum/EIPs/issues/9980 m) D6 t& B* n, T# y( q8 D
标准说明:! l* U, X9 S1 Q! m8 u
https://github.com/ethereum/EIPs/blob/master/EIPS/eip-998.md M; A6 N7 n, n4 h' d
推荐样例:
https://github.com/mattlockyer/composables-998( O7 d- S' U1 `1 E) |
1 t' S' U0 y7 k6 J5 M
4 o" B! f* z* E( {6 R8 k
不同的ERC代币可以被兼容的ERC-998代币既代表一组相似资产(ERC-20代币),一种独特资产的分类(ERC-721代币),或者内嵌于单比交易的混合体。' b# o9 A- n; R8 J
这个协议是以不可以替代代币为基础的全新复杂型数字资产。一个ERC-998代币可以作为一个数字资产投资组合。
中心资产和辅助资产的结合' o" [2 @' ]. _1 o2 [$ v
第一个使用案例是可以和不同数字资产和零件结合外加附加增值功能的中心NFT币。增值可以通过个人花费时间和精力,或者购买来实现。
在奢侈品行业里,这些可以作为应用于不同时尚品牌的“外表”和“包装”。 比如说,中心的不可替代货币是外表,可以辅助鞋子和钱包,每一个都代表了他们自己的NFT。这一整个套装都作为一部分组合到ERC-998代币里面。
单一资产的几个组成部分0 k/ C* @# M+ W0 K) _! o
作为附加债券的一部分,单一的数字资产可以被ERC-998代币群组所代表。因为每一个部分都是由自己的NFT被独特的体现出来的,NFT代币组合可以保证货品的绝对真实性。然而,除非依附于实际商品的形式,每一个NFT都没有自己的价值。这是一个可以附加在类似手表,珠宝这样价值商品上的非常强势的防伪手段。6 @+ [. Q& \' O; z
& r6 S0 v0 x5 a6 i
上图所示为劳力士的三个组件,每个组件都有一个单独的序列号 - 表壳、表面和指针。单独来看,这些部件几乎没有任何价值,但它们一起构成了一个真正的劳力士手表,由一个ERC-998代币所代表。! N( @2 p0 N6 d% e# L5 h
分组集合) d% I, d0 N6 K$ n4 ]5 B, r
通常被认为是组合的任何东西,例如一副牌,一本历史邮票或罕见的硬币收集等,可以在一个组合型代币下结合在一起。因此,完整的组合可以由单个数字资产表示。$ J5 S: |2 |5 p' a9 K. Y6 W
大多数奢侈品牌都有很大众的产品,每年都会使用重新设计的型号,这些产品往往成为收藏品。在奢侈品战略下,消费者购买经典和品牌,这些都是通过多年来产品的演变出来的。作为上图中的示例,该品牌在三年内发布了其第一、二、三代模型,这些模型被分组为一个组合代币。4 [! f' m/ J8 { X5 H3 {/ |9 \( Z
同时,这也更为品牌加强与老客户的联系。例如,如果用户可以通过Smart-Links这样可组合的代币,显示他们对某个品牌的所有收藏品,那么该品牌将能够通过独家邀请和优惠来奖励这位客户。1 h. ]9 \! G$ M7 u
#4.4 ERC1155
状态:
草稿(Draft)
提交记录:
https://github.com/ethereum/EIPs/issues/1155
% z* m& N7 ]0 j% l6 `0 A' X
标准说明:
https://github.com/ethereum/EIPs/blob/master/EIPS/eip-1155.md
推荐样例:' N% y# B% C6 o" A3 o; j+ ~
" D& u( S6 c' m2 H5 z: `
https://enjincoin.io/
ERC-1155是一种定义token的新标准,1155是这种方法的编号。1155标准定义了一种解决上述问题的新方法。现在『物品』(可能包含ERC20的token或ERC721的token或两者都有)可以被单一的一个合约(打包处理)来定义了。合约里包含区别token们所需的最小量的数据。合约的状态包含了每个token ID的配置信息和管理收集的所有行为。ERC-1155的灵活性更强,它使得开发者可以自行选择是批量生成某一种特定的token,还是构建不可被复制的惟一元数据。, N1 ~, h8 j$ O7 d7 Z3 \
ERC-1155支持原子交换,“原子交换”是指不通过中介物而将一种token换成为另外一种token。- i7 G1 ^/ }7 ^! U F
ERC-1155的最大进步就是可以融合不同token(可能是“可替换”的代币与“不可替换”的代币的混合体)进行“打包处理”。: ]# e9 y- b0 b6 @" l
函数接口说明:3 F7 v, x9 x% A8 R, u
name(uint256 _itemId):
symbol(uint256 _itemId):! |+ F0 J% n: h1 g: w# u% B3 D0 b
; U, l2 Z# Q5 x; q% R
decimals(uint256 _itemId):
totalSupply(uint256 _itemId):: ^" B3 x, F6 q/ }# W
balanceOf(uint256 _itemId, address _owner):
allowance(uint256 _itemId, address _owner, address _spender):
transfer(uint256[] _itemId, address[] _to, uint256[] _value):2 r$ t* h7 r& _0 g: L$ J
! E3 u3 @# Y2 X1 C$ c# C- u
transferFrom(uint256[] _itemId, address[] _from, address[] _to, uint256[] _value):
approve(uint256[] _itemId, address[] _spender, uint256[] _value):" n6 h( q! P8 F" n6 N( z! b+ H2 O+ \5 f
$ D# Q; q3 @9 f& o
increaseApproval(uint256[] _itemId, address[] _spender, uint256[] _addedValue):
decreaseApproval(uint256[] _itemId, address[] _spender, uint256[] _subtractedValue):9 A/ V& B) Z, w( i2 ?
ownerOf(uint256 _itemId):; C$ N ^ v2 }( `2 y1 d5 b
itemURI(uint256 _itemId):
itemByIndex(uint256 _itemId, uint256 _index):
' {- M e% A2 O: e9 u: G2 B% r
itemOfOwnerByIndex(uint256 _itemId, address _owner, uint256 _index):5 {$ @$ A. d4 A9 V- J2 u: u
2 d% b% b' \. }! u
#4.5,ERC1190
状态:; \1 P# k2 Q! G$ S6 p: W/ ]
还处于pull request下(issue)提交记录:& [' k7 u; l! N3 x/ X7 C2 \. p" I
https://github.com/ethereum/EIPs/issues/1190标准说明:推荐样例:6 c1 V/ {+ b, m# _( g( j8 d8 u" {
ERC1190的token将使每个数字对象的创建者(如艺术品或游戏中的物品)在每次使用该对象时会自动受益,无论是下一秒还是几年之后。
每位ERC1190 token的持证者都可以单独持有“创造权”或“所有权”,当然也可以同时持有两个权利。% \" R5 A) c- l' U/ m6 }+ B3 Z
ERC1190的三种获益方式:
1.销售“所有权”;
2.销售“创造权”;
3.在固定时间内出租“所有权”。2 F8 a) G' S' M1 e4 a* j
一个数字产品的“所有权”持有者和“创造权”持有者通过以上三种方式都会自动获得一定收益。( m9 B' ` r. d
1. 创造者将拥有“创造权”和“所有权”0 y' x( J) Q4 W: v- [
我们以网络游戏中的“装备”为例。4 R; I: d# `( |: ?! P
物品的创建者可以将物品及其所有权信息嵌入到一个ERC1190 token中。" m4 \- w. y/ t
简单来说,我在游戏里制造了一把剑并把他命名为“裂魂之剑”。1 x0 F. N: {- G; }. x; s5 q
身为创造者的我就会拥有他的“创造权”和“所有权”。
如果我想销售我的“裂魂之剑”那么它的“所有权”将会被转交给一个第三方参与者(此处我们将他定为玩家A),但是我还会保留它的“创造权”。
在这次销售中,我一次性获得了“所有权”带来的收益,并会在将来的某个时刻获得一定比例的“所有权”收益。. E" N7 R6 P# E1 F. ], R
2. 如果“所有权”持有者再次发生转换,创造者将会获得收益
拥有“裂魂之剑”“所有权”的玩家可以永久持有该装备,在游戏里如果这件装备得到了更好的优化或者其他玩家因为某种原因喜欢上了这件装备,那么它的价格也必定会有所提高。
当玩家A决定销售“裂魂之剑”的“所有权”给玩家B时,他会从中获得高比例的收益,而拥有“创造权”的我将会获得低比例的收益。
如:10%。(这个比例会在一开始设计该token的时候写在协议上)每一次“所有权”的转换,“创造权”持有者都会自动获得售价10%的收益。
3. 如果“所有权”持有者出租了“装备”,那么创造者也可以获得一定比例的租金( K# {; m4 R1 O- j5 f$ z: _
如果玩家B暂时不需要使用“裂魂之剑”。/ f& b: l6 p0 M8 l+ T
他便有权将“装备”出租给玩家C。按照规定,做为创造者的我将会获得租金里的10%,而这个过程也是可以无限循环的(任何一次有关“装备”权益的转换都需要支付给创造者一定比例的费用)。- B9 D" M# ?* [1 H* s. v! c8 z
其实不单单是在游戏领域,在其它的的虚拟领域都可以进行这一活动,如影音,艺术等。人们不用再担心复杂的交易流程和版权费问题了。
规则被写入了智能合约,基于区块链技术,双方的任何行为都会自动触发后续动作。; V; U+ \8 }; P5 g# A8 i' l
4. 创造者销售“创造权”/ M$ l9 ?+ E' V
身为创造者的我有权出售“裂魂之剑”的“创造权”,并且我将会一次性的拿到所有收益,这其中的收益比销售“所有权”所带来的收益要高得多。
之后,新的“创造权”持有者在未来的“权益”转换过程中会重复上面的步骤,只要他不出售自己的“创造权”,他将继续重复获得租金或“所有权”转换所带来的收益。
3 A" O0 A" q: v) P. l6 J( E9 S& v
用一个现实世界的例子“房屋”来解释,你拥有它的房产证并且拥有它的出租权,使用权。6 B; D+ q) E! i& ^7 O$ M2 R
你作为房产证的拥有者可以将房子的使用权出售给客人A,而客人A可以选择将他的使用权卖给客人B或者将使用权出租给客人B。
而你依旧可以获得一定比例的房租收益或售卖分红,且最终房屋还是归你所有。
当你卖掉了房产证之后才会从这个利益关系中彻底退出,之后任何的“权益”转换也就和你没有半毛钱关系!9 ]2 H2 o* ]6 L# \. N9 J( O
函数接口:; E/ F$ a# v& Y- H
' E- r$ g+ Z- |; x" |
function approve(address[] owners, uint royaltyForOwnershipTransfer, uint royaltyForRental) returns uint256;$ c+ p. ]. [( F# V
说明:Function to initialize token and set the owner(s) and the royalty rates. Returns the unique token ID for the digital asset.
7 v) D1 }; J. }) _
function transferCreativeLicense(address[] creativeLicenseHolders, address[] newOwners, uint256 tokenId);# g0 I2 x2 U. j* z4 h
说明: Function to transfer creative license of token。
function transferOwnershipLicense(address[] creativeLicenseHolders, address[] ownershipLicenseHolders, address newOwners[], uint256 tokenId);# u n& ~- q/ z, k+ q2 f- d% ~5 X9 l
说明:Function to transfer ownership license of token m3 X8 Z# O9 n- |' d( m# O
) l* n' ^4 j( Q% B/ I
function rentAsset(address[] creativeLicenseHolders, address[] ownershipLicenseHolders, address[] renters, uint256 tokenId);
说明:Function to rent asset
#5,ERC865! i. }+ T5 Q! g, k
状态:
还处于pull request下(issue)
提交记录:6 x! g5 a* N, ^
https://github.com/ethereum/EIPs/issues/865: x3 W' n3 _0 P1 D
1 l! p# `$ Z- R/ }/ s! K, x3 V+ r
标准说明:1 t8 B: X9 x- P8 [. {
1 }- k0 r8 S7 c% ]7 L* q9 h0 ]
推荐样例:
https://github.com/lavawallet/lava-wallet6 l! b" R8 q, D& _% K6 u; `; b
+ K$ i8 a; p; L4 o( U
以太坊开发者Bhaskar Sharma在Medium网站上发表了一篇文章,提出了一个在以太坊中使用对用户更友好的代币的提案,这一提案将允许用户来采用去中心化应用程序(DApps)时使用代币(tokens)来支付交易费用,而不是用以太币ETH来支付。/ M. m [2 u; J" o: R
他认为,以太坊区块链中的费用支付问题为新手带来了麻烦,这些费用用于支付矿工将交易打包到区块并确保区块链的安全。用户必须认识以太坊的工作原理,这样才能理解燃料(gas)价格和成本。用户还需要获得必要的以太币来支付这两种费用。
函数接口说明:
+ X5 _3 E6 J) w& U$ U
transferPreSigned(bytes _signature, address _to, uint256 _value, uint256 _gasPrice, uint256 _nonce):& ?7 [ m6 ^5 w* k8 [; C4 E
approvePreSigned(bytes _signature, address _spender, uint256 _value, uint256 _gasPrice, uint256 _nonce):
**approveAndCallPreSigned(bytes _signature, address _spender, uint256 _value, bytes _extraData, uint256 _gasPrice, uint256 _nonce) **:7 { j: F- Q9 n$ d* A& U" Z0 [
& u, S% L! h, |0 V( \, f
increaseApprovalPreSigned(bytes _signature, address _to, uint256 _amount, uint256 _gasPrice, uint256 _nonce):3 F5 c8 z" @6 D% B7 ~6 p1 {3 c
9 M* v4 V+ Q. M+ E. J
decreaseApprovalPreSigned(bytes _signature, address _to, uint256 _amount, uint256 _gasPrice, uint256 _nonce):6 b- E5 }. v2 ~
revokeSignature(bytes _signature):
2 _- y3 g+ C3 R* b& z) Z. l
#6. 其他ERC协议0 K1 G" `" d1 X
#6.1 ERC165; r1 `# n$ u1 B3 F
状态:: f; n' @8 g5 F
已定稿(Final)提交记录:
https://github.com/ethereum/EIPs/issues/165标准说明:
https://github.com/ethereum/EIPs/blob/master/EIPS/eip-165.md
ERC165定义以下功能:4 O% J+ q/ ^7 U: T. o% p
1) 如何识别接口;
2) 一个智能合约如何发布它执行的接口;/ b5 K v6 z, O5 C6 R
3) 如何检测一个智能合约是否执行了ERC-165协议;. ]: z2 C7 U% t# K
4) 如何检测一个智能合约是否执行了一个给定的接口;
#7,参考
(1)以太坊官网ERC列表
(2)以太坊官网EIP提出列表
成为第一个吐槽的人