ERC的新成员ERC1400提案中文版
真无牙泛
发表于 2022-11-30 18:44:03
130
0
0
目前,ERC1400还处于起草阶段,未来是否会获得社区通过并投入使用还尚未可知。! g# Q% g& T. k) Y& j
8 o9 K' N3 |8 ]) P: `7 O
临界(Hashgard)团队对ERC1400的提案进行了翻译,为所有的开发和技术人员,提供更多支持和助力!9 ~* L: v5 |. e' j
; @5 F& J: u# B& l
-01-
! o1 W' d' ^, b- S4 r
关于ERC1400
"ERC1400"是新提案的证券型代币的标准,新标准主要是把Token的互换性(fungible)结合证券相关的业务场景,设计了一套通用接口。
标准制定了Token持有人的余额分离成多个分片(tranche)的能力。tranche是一种以债务为基础的投资结构。这些证券将具有不同期限的,投资风险或高或低的tranche组合成一个整体,以达到降低投资者的风险,提供长期投资的目的。例如,你可能有一笔贷款转付证券,其中包括5到30年期的高风险和低风险的转付证券,基于ERC1400标准的Token将支持这种投资方式。
* G! t* K% r: _8 s# q
我们先了解ERC777标准,ERC777是ERC20的加强版,旨在加强用户的控制权限,具体有:8 C' Q m0 s# B# J2 o. J
随交易发送可以附带描述数据,以供某些业务场景使用3 U: V o& L2 \
/ L/ s& O" `. r
设置一些转账限制,如黑名单
支持一些高级交易+ ]& R8 }( d) y# G/ M O1 K4 \) y; c
4 V& Q+ ^ z# N- ` N( y
无论是ERC20还是ERC777,每个单位的Token都是相同的,并无附加属性,属于fungibletoken(同质化代币/可互换Token)。ERC721标准的Token,每个Token均有不同的ID,不同ID可以有不同的解释,属于no-fungibletoken(非同质化Token,不可互换Token)
% w% }: }6 E; C
ERC1410标准的Token属于Partially-FungibleToken(部分可互换Token),将ERC20/ERC777中不存在解释属性的余额,附加额外的信息,从而划分成不同的部分,就可以做一些操作上的限制(例如:某些操作只限定于指定tranche的Token,某些操作优先消耗指定tranche的Token)
0 U$ r' ^) i* g" y, a" K
ERC1400则是继承ERC1410标准,增加了证券相关业务会使用到的函数:证券增发,相关法律文件存储等。7 k2 P; U3 ?, O7 w5 j
先前一些证券型Token的合约大多是在ERC20标准的基础上,通过维护一个或多个以太坊地址集合,对这部分地址做出了划分:是否通过kyc,是否处于锁定期等,来进行转账上的限制。这些都是在地址层面做出不同的解释。而ERC1400对Token本身做了不同解释,以适用于更复杂的证券相关业务场景。6 ]) Z9 P3 o9 L7 p T' Y1 |
关于ERC20,以及其它ERC成员的关系,可见下图:
, S0 I2 z) k; [ _. k
1.webp(1), @: K# Q6 I/ Z3 A7 z3 ?
-02-
ERC1400提案翻译
7 j) A8 {7 j/ y9 r$ @
SecurityTokenStandard
eip:ERC1400& i1 d, `$ m$ R6 ~" m! v- u
2 m0 B. a9 }5 W3 q2 W$ h/ g: j
标题:StandardforSecurityTokens
作者:AdamDossa(@adamdossa),PabloRuiz(@pabloruiz55),FabianVogelsteller(@frozeman),StephaneGosselin(@thegostep)5 n' x9 z z$ e% b6 o+ Z
: t1 D# x* Y8 i9 Q1 Q+ [- D
译者:Jason(来自临界Hashgard团队)' S4 @. I: p0 l- y" I
状态:Draft
' B8 b \: D$ E
类型:StandardsTrack5 N! h. u3 b- O9 H8 V. }1 y9 X' i
范畴:ERC
创建于:2018-09-09& P% t& G( s) c0 |# D
需要:ERC-777,ERC-1066
Motivation2 A0 @6 ~: X) p6 y
; o$ ?# C" E _0 ^9 R
通过指定一套标准的接口,加速发行和管理以太坊上的证券,通过该接口所有相关方可以查询和操作证券型代币。8 A1 T+ e% v5 s3 q: H* H/ u/ v Y' u7 d) _
; }- I. N6 g0 _7 e0 c
证券型代币与其他代币用例存在重大差异,链上与链下参与者的交互更加复杂,有着相当严格的监管审查。
证券型代币应该能够对标任何资产类别,在任何司法管辖区内发型和管理,并遵守相关的监管限制。7 \- @. A" G8 h3 Q" v$ B/ S& e
Requirements1 u* Y2 v8 Z* S7 d
将证券的发行,交易和生命周期事件迁移到公共账本上需要采用标准的方式对证券,其所有权及其在链上的属性进行建模。' S2 w& M5 J) D- p, R
经证券型代币生态中各方讨论后,编写了如下的要求:
- s( t& z: v3 _' ] S& s
必须有一个标准的接口来查询一笔转账交易是否成功,失败的话则返回原因。3 P2 ^. \2 [) X) z9 J
. w0 W* g! I) B4 }/ p: b
必须能够强制转账以应对法律诉讼或资金回收。& l5 E8 b7 f$ h k
8 H* D3 m; M, I2 D/ p
必须发布用于发行和赎回的标准事件。7 N. ^4 o' J/ j t4 M3 V
/ H K% _ u/ k% G' W0 h
必须能将一些数据附加到代币持有者余额的子集上,例如特殊股东权利或是转账限制的数据。
必须能根据离线数据,链上数据和转账的参数在转账时修改元数据。; l3 r: q6 f7 F# A
可能需要将签名数据传递到转账交易中,以便于在链上验证。
& h7 p5 @- Q0 y5 Y# d
不应该限制可以代表司法管辖区内的资产类别范围。
: a# m$ m2 O- j5 F% L! a" w
应该兼容ERC20和ERC777标准。
+ s/ O" Q/ d6 y( _2 U V/ \
Structure& I( N1 _/ r2 Y
ERC-1400:SecurityTokenStandardERC-w:Semi-FungibleTokenERC-w-1:TranchemetadataschemaERC-x:PermissionedTokenTransfers(canSend()andstatuscodes)ERC-y:TokenMetadata(set/getDocument)ERC-z:OptionalSecurityTokenfeaturesForcedtransfersPermanentendtoIssuanceTradingHaltsBatchedtransfers
! f0 j; |: j- v* Y+ ]
Semi-FungibleToken5 \/ m- d% {) I" A
–#1410Partially-FungibleToken(部分可互换代币)
- L6 o" j* i5 W) @
–PermissionedTokenTransfers; U9 r. c' C1 j1 z X
0 i# B4 ? w6 T( i
–#1400SecurityTokenStandard(证券型代币标准)( C( D% W2 o1 J% z7 z7 s& a
# t/ j, B1 O( [* N8 |2 W
–#1404SimpleRestrictedTokenStandard(简单的受限代币标准)3 f# \3 s0 G8 q8 N# M1 X: s' {
Abstract
/ s4 k3 ^- m+ h/ R% R* R( v9 Y
有许多类型的证券虽然代表相同的标的资产,但需要有与之相关的差异化数据。
这些额外的元数据隐含地使这些证券不可置换,但实际上这些数据通常应用于证券的一个子集而不是单个证券。将令牌持有者的余额划分为各个部分的能力,每个部分具有单独的元数据,在Partially-FungibleToken部分中进行了说明。
7 W/ f% A+ \+ d3 z
例如,代币持有人的余额可以分为两部分:在首次发行期间发行的代币和通过二级市场交易得到的代币。
证券代币合同可以引用该元数据去应用额外的逻辑来决定转账是否有效,并确定一旦转账到接收方账户中,这些代币所关联的原数据。
3 n5 i6 O# Q; @
这些条件可能与正在转账的证券代币关联的元数据有关(即它们是否受制于锁定期),证券发送方和接收方的身份(即他们是否通过了KYC流程,是否是经认可的,或是发行方的附属公司)或者是与具体转账无关的原因,而是设定在代币的级别上(即代币合同强制执行投资人数量的上限,或任何单一投资人持有的百分比上限)。
0 I& ]" z& I7 `; R9 m1 z
对于ERC20/ERC777代币而言,balanceOf和allowance方法提供了一个在执行转账之前检查转账是否可能成功的方法,转账在链上或是链下都可以执行。+ p0 E5 z4 ~% W! G& o, [) h
M' b. P1 v x$ Z! U! j
对于标的证券的代币而言,这个标准引入了一个函数canSend,当失败的原因更加复杂的时候,它提供了一种更通用的方法来实现这一目的。还引入了一个用于整个转账行为的函数(即包括同转账一起发送的任意数据和证券的接收方)
为了提供同true或false相比更加丰富的信息,会返回一个字节返回码。这使得我们能够说明转账失败的原因,或者至少是失败原因的类别。查询文档的能力和对转账成功的预期会包含在SecurityToken部分中说明。
#1410-Partially-FungibleToken
一个Partially-FungibleToken允许将元数据关联到代币持有者余额当中的一部分上面。这些部分的余额称为tranches(tranche,实际上是一个法语单词意为“切片”或“部分”。在投资界,用来描述可以被分割成并卖给投资者的小额证券。),并由bytes32_tranche键来建立索引,该键可以同链上或链下的元数据相关联。4 ~% t n# ]/ w. v8 H1 z3 d" Q
**( i2 H! u& G, U$ a; Z6 p; B& G/ G" a
SendingTokens**
4 m# N7 A1 u9 I& Y7 w
代币转账始终具有关联的源tranche和目标tranche,以及通常的转账数量和发送方/接收方的地址。
getDefaultTranches Q J4 t- @6 B3 y# G. \$ k2 Z- w
% S' V/ g4 J" X m' e
为了提供对ERC777的兼容性,实现需要决定在执行ERC777发送函数时要使用哪一个tranche。
; E! [' i* U/ i: n& ~2 Z9 M% V+ p- N
这个函数返回在此情况下使用的tranches。例如,一个证券型代币可以返回byte32(“unrestricted”)tranche,或者使用一小组可能的tranches的简单实现,可以返回与代币持有者相关联的所有tranches。3 p; u' n7 ]3 ^' H7 i
( ]' q; P5 k/ Y& u3 v
返回值可以为空,这意味着没有默认的tranche(因此ERC777的发送函数将抛出错误),或者返回多个tranches,在这种情况下,ERC777的发送函数应该按照顺序循环遍历这些tranches,直到指定数量的代币已经成功转账。3 B. K5 j0 T e8 T
2 b# A! l6 m p. e% n3 }$ n. R! u6 I4 M
functiongetDefaultTranches(address_tokenHolder)externalviewreturns(bytes32[]); K! c( }1 E# i
! z7 `+ T: Y" s, O* e* y1 l
setDefaultTranches1 B( U5 V" @) F9 \' p
允许为指定的地址设置默认的tranches,将会在ERC777的发送函数执行时使用到这些设置。8 Z. [6 O3 {/ R- B& f/ A8 V$ X, I
) Q7 D) o' _( n5 v
这个函数可以供所有代币持有人自行调用,或仅限于那些实现了某些必要行为的持有人。
functionsetDefaultTranche(bytes32[]_tranches)external;
: b- F* z! Z* p
balanceOfByTranche
3 \) r/ Q$ M% R0 ~" d, B
除了有查询所有tranches下总的代币余额的balanceOf,也要有查询某个特定tranche下代币余额的函数。
6 T( E5 V8 S; Q1 d3 J
functionbalanceOfByTranche(bytes32_tranche,address_tokenHolder)externalviewreturns(uint256);
sendByTranche6 x2 h5 Z3 s5 q0 \& }7 J9 V, Z
通过拓展ERC777标准并提供一个默认的tranche(通过getDefaultTranches函数获取),就可以发送代币了(从默认的tranches)。要从一个特定的tranche来发送代币的话,可以使用sendByTranche函数。$ o. \6 r4 m. f1 z0 |( H" H) a
8 p$ h, b) k' V6 h0 p$ F3 F6 T
例如,一个有权限的代币可以使用tranche元数据来强制执行如下的转账限制:! |. J$ F- ^- b! ?' @5 ^
$ c5 f& Y$ S# A `4 D0 I( a8 D0 W
_tranche值
" @$ j" q/ t/ v$ U( W
与_tranche值相关联的任何额外数据(例如,可能与_tranche关联的锁定时间戳)
/ c5 k ]3 h. T' i" s( Q( p, c
与代币的发送方或接收方相关联的任何细节(例如,他们的身份信息已经创建)
转账的代币数量(比如,它是否遵守任意按天或者基于其他时间周期的转账数量限制)/ q8 c& O) M7 `3 n1 w- n
B3 \/ K& l. C3 [! F# m- L
_data参数允许调用者提供与转账相关的任何附加的授权或详细信息(例如,来自一个被允许对转账行为进行授权的授权实体的签名数据)# f {: c! m" N; ~5 D# T
其它的用例包括通过把先前的持有者与目标tranches关联起来,跟踪代币的出处。
5 X# w( t0 B, Q) _! D! M/ ^) n
如果转账代币因某种原因失败,这个函数必须抛出错误。9 Y3 I7 `, X& y' m0 j
6 E7 ]% t" ?8 J# M& p
当从特定的tranche上转账代币时,了解这些代币的链上的(即不仅是通过一个响应的事件)目标tranche是有用的。目标tranche将会由这个函数的实施来决定,并依据用例而有所不同。' Y# j. c$ l9 E; p: l- u
这个函数在转账成功时必须触发一个SentByTranche事件。7 S5 _/ w( u& \6 ]9 g. o
functionsendByTranche(bytes32_tranche,address_to,uint256_amount,bytes_data)externalreturns(bytes32);functionsendByTranches(bytes32[]_tranches,address[]_tos,uint256[]_amounts,bytes_data)externalreturns(bytes32);6 f2 T- p A: v q; b
redeemByTranche
9 M m$ g" _0 O v
允许代币持有者赎回(销毁)代币。, n$ v7 v8 b3 w9 ^( Z: z
- S3 U$ b+ t+ u7 H
必须从代币总量和代币持有人账户里扣除已销毁或已赎回的代币。销毁代币应该像发送代币一样,受到相同条件的限制。每次此函数被调用时,必须触发RedeemedByTranche事件。
. R# h. ~8 v O/ t
functionredeemByTranche(bytes32_tranche,uint256_amount,bytes_data)external;
5 w0 i S. v1 b/ G: u3 E: E+ _
tranchesOf) S+ z* ]4 R8 G8 w6 B' J
代币持有者可以把他们的余额拆分成多个部分(tranches)——此函数将返回与特定代币持有者地址关联的所有tranches。
7 N/ e4 o1 S8 _1 U" {8 m# `
functiontranchesOf(address_tokenHolder)externalviewreturns(bytes32[]);& t+ S0 i3 K% @& |9 U3 Z
Operators
操作者可以获得以下授权:
所有的代币持有人和tranches(defaultOperators继承自ERC777标准)
6 a# F/ Z* x" R8 G
一个特定tranche的所有代币持有人(defaultOperatorsByTranche)
w* r% q/ u O9 ]" h
一个特定代币持有人(isOperatorFor继承自ERC777标准)的所有tranches(当前的和以后的) r) P4 G1 g( C
% {( _/ p( o: B0 @$ H! C
一个特定代币持有人的特定的一个tranche(isOperatorForTranche)" ~1 q! Z U1 D$ j7 X; d9 z
defaultOperatorsByTranche8 f2 F. J' Q, F9 i6 A2 W
此函数返回默认的由所有代币持有人和一个特定tranche授权的操作者集合。. w! b/ A% [$ j8 _- _1 U$ I, T
functiondefaultOperatorsByTranche(bytes32_tranche)externalviewreturns(address[]);4 n% G& k5 R. O1 q4 s& R* E1 ^
authorizeOperatorByTranche
允许一个代币持有人去为他的某个指定tranche的代币设置一个操作人。1 }0 W# M4 V; O/ T. V4 D; o
1 B* _2 Q! j2 I. ~/ c% _4 H
每次调用此函数时,必须触发AuthorizedOperatorByTranche事件
6 C/ t: K9 F/ K7 o- D# V: a
functionauthorizeOperatorByTranche(bytes32_tranche,address_operator)external;1 w2 v/ m" E: @
/ e% _9 A% |* B" h
revokeOperatorByTranche' S0 l, e2 S/ @- j, q1 w; I
/ W. m h% \& R
允许一个代币持有人撤销其某个特定tranche的代币的操作人。
注意——操作人可能会通过defaultOperatorsByTranche或defaultOperators保留对该代币持有人和tranche的授权。
9 a. b+ W* H; k! V
每次调用此函数时,必须触发RevokedOperatorByTranche事件。
functionrevokeOperatorByTranche(bytes32_tranche,address_operator)external;
isOperatorForTranche
返回某个特定地址是否是给定代币持有人和tranche的操作人。% C. `4 o' O( m" L5 p! _
& S9 h6 |4 Y" g" u
如果地址是上述任何类别下的操作人,则应该返回TRUE。5 Q# C8 s! _6 q( P! M/ w* x9 u
8 ?% M3 t% W; @( Y9 ?% ~
functionisOperatorForTranche(bytes32_tranche,address_operator,address_tokenHolder)externalviewreturns(bool);2 \" ]' s) h: U2 L/ _& V9 V& T. C
operatorSendByTranche* U: h8 ?! \6 K
3 p0 z0 w' a* i2 v& ~$ O
允许操作人代表代币持有人发送证券型代币。# K1 P- Z: q) N* g& O
此函数应该返回接收方的bytes32_tranche。8 m: @2 y" b; F; U" A0 |
7 p. R8 V, W( J6 v* Z' i( X
如果是在链下生成的话,接收方的bytes32_tranche可以在bytes_data中定义。
9 g( `5 E3 a" F. p5 o
如果此函数被一个缺少由isOperatorForTranche定义的合适授权的地址调用的情况下,必须回退。+ f& P" C$ R* S
) C/ j- z J. g0 Y; e
此函数在成功发送代币后必须触发一个SentByTranche事件。
/ b' d) m4 ^+ }3 A, R n8 J( \/ t5 i
functionoperatorSendByTranche(bytes32_tranche,address_from,address_to,uint256_amount,bytes_data,bytes_operatorData)externalreturns(bytes32);functionoperatorSendByTranches(bytes32[]_tranches,address[]_froms,address[]_tos,uint256[]_amounts,bytes_data,bytes_operatorData)externalreturns(bytes32[]);
' c( W% M( V# h8 L4 T) p9 E! ^# c
operatorRedeemByTranche8 T& x0 H9 J/ I- _8 v
允许一个操作人代表代币持有人销毁或赎回代币。4 c( w8 Z4 ?8 l% }7 |% I
0 Q. _9 e* D8 u- E; e9 k
必须从代币供应总量和代币持有人账户中扣除被销毁或赎回的数量。销毁代币应该同发送代币一样,收到相同的条件限制。每次调用此函数时必须触发RedeemedByTranche事件。
functionoperatorRedeemByTranche(bytes32_tranche,address_tokenHolder,uint256_amount,bytes_operatorData)external;
' t. G q. O9 K' l* h/ v
Interface
6 ^( i1 H% m. Q: P4 I8 O
///@titleERC-PFTFungibleTokenMetadataStandard///@devSeehttps://github.com/SecurityTokenStandard/EIP-Spec$ R% P5 F5 w0 F6 F
& K5 D2 Q& I) {2 O/ N+ e+ j
interfaceIERCPFTisIERC777{8 j! h" Y- M$ ]* j6 f: d
- c; B/ b' [, d. F
functiongetDefaultTranches(address_tokenHolder)externalviewreturns(bytes32[]);functionsetDefaultTranche(bytes32[]_tranches)external;functionbalanceOfByTranche(bytes32_tranche,address_tokenHolder)externalviewreturns(uint256);functionsendByTranche(bytes32_tranche,address_to,uint256_amount,bytes_data)externalreturns(bytes32);functionsendByTranches(bytes32[]_tranches,address[]_tos,uint256[]_amounts,bytes_data)externalreturns(bytes32[]);functionoperatorSendByTranche(bytes32_tranche,address_from,address_to,uint256_amount,bytes_data,bytes_operatorData)externalreturns(bytes32);functionoperatorSendByTranches(bytes32[]_tranches,address[]_froms,address[]_tos,uint256[]_amounts,bytes_data,bytes_operatorData)externalreturns(bytes32[]);functiontranchesOf(address_tokenHolder)externalviewreturns(bytes32[]);functiondefaultOperatorsByTranche(bytes32_tranche)externalviewreturns(address[]);functionauthorizeOperatorByTranche(bytes32_tranche,address_operator)external;functionrevokeOperatorByTranche(bytes32_tranche,address_operator)external;functionisOperatorForTranche(bytes32_tranche,address_operator,address_tokenHolder)externalviewreturns(bool);functionredeemByTranche(bytes32_tranche,uint256_amount,bytes_data)external;functionoperatorRedeemByTranche(bytes32_tranche,address_tokenHolder,uint256_amount,bytes_operatorData)external;& M7 v G# u( O. m8 d" O
eventSentByTranche(bytes32indexedfromTranche,bytes32toTranche,addressindexedoperator,addressindexedfrom,addressindexedto,uint256amount,bytesdata,bytesoperatorData);eventAuthorizedOperatorByTranche(bytes32indexedtranche,addressindexedoperator,addressindexedtokenHolder);eventRevokedOperatorByTranche(bytes32indexedtranche,addressindexedoperator,addressindexedtokenHolder);eventRedeemedByTranche(bytes32indexedtranche,addressindexedoperator,addressindexedfrom,uint256amount,bytesdata,bytesoperatorData);eventIssuedByTranche(bytes32indexedtranche,addressindexedoperator,addressindexedto,uint256amount,bytesdata,bytesoperatorData);}( w7 ^* @& @' Q9 O
Notes+ L; u" M' ~# o
ERC20/ERC777BackwardsCompatibility(向后兼容ERC20/ERC777标准)
1 Y5 S8 ?5 O$ L8 j' g* L6 Q* l
为了保持向后兼容ERC20/ERC777(以及其它可互换代币标准),必须去定义在执行一个transfer/send操作时(即未指定tranche时),应该使用哪一个或者哪几个tranche。
) X2 _8 `/ @/ M7 p7 D. d, f; e
如果函数实现保证每个代币持有人尽可能的tranches的数量,则迭代代币持有人的所有tranches(通过tranchesOf)是合理的。
- h3 j) L* |& g8 X, o3 m
代币创建者必须为所有的代币持有人指定一个或多个默认的供ERC20/ERC777标准下函数使用的tranche。每个代币持有人或者其所有tranches的代币余额的操作者,可以更改代币持有人的默认tranche。代币持有人去更改他们的默认tranche的能力允许他们更改显示在还未兼容ERC_PFT的ERC20/ERC777钱包中的tranche。' [) _9 e( B7 {) I& |' |
3 i% h+ r2 y1 @5 [3 U% A
以下是对ERC777标准函数的实现描述:
: e O5 K! O" R0 k" ~2 H7 s) X5 T
send()必须使用getDefaultTranche()来获取默认的tranche。( q& r6 r( ^3 ~+ Z
9 E2 k- {5 K& t3 B7 c
opratorSend()必须使用getDefaultTranche()获取默认的tranche。
2 u9 f( p5 A; j3 ?6 H* I, u
REDEEM()必须使用getDefaultTranche()来获取默认的tranche。
opratorRedeem()必须使用getDefaultTranche()获取默认的tranche。9 z, D# ^( t4 B
2 M0 p( T1 L( R& n+ E% D
balanceOf()必须计算指定代币持有人的所有tranche的余额总量。: a7 { w9 p& L- C; @
) y1 g5 a8 x' J }, m
totalSupply()必须返回被该合约跟踪的所有代币总量。, U2 c* p6 c) a8 J1 J
defaultOperators()必须查询可以操作所有地址和tranches的操作人列表。
authorizeOperator()必须对msg.sender的所有tranches授权一个操作人。0 k6 h7 d# A7 l! y; k
0 }9 j- O. {/ e4 a' d; X8 K
revokeOperator()必须撤销先前对msg.sender的所有tranches授权的操作人。
isOperatorFor()必须查询_operator是否是_tokenHolder所有tranches的一个操作人。/ i" J! q' p( t& N$ V4 H. D, k
事件Minted()和IssuedByTranche()必须在代币供应总量有任何增长时触发。, Y @2 F K. [; u: r
事件Burned()和RedeemedByTranche()必须在代币供应总量有任何减少时触发。
事件AuthorizedOperator()必须由authorizeOperator()触发。
事件RevokedOperator()必须由revokeOperator()触发。& r- p1 [' i. l! I1 D) ^
. A, C. |$ J" z1 q* {- E
–#1400-SecurityToken! N) Q% u2 ~2 H' I6 J0 n
Methods! G+ k: W8 v8 e: `8 N$ d
getDocument/setDocument1 m. A+ z" |; |+ b, U1 L0 l5 B2 l
( u/ _6 ^2 N; o- s) c9 [' h: G5 O
这些函数用于管理与代币关联的一个文档库。这些文件可以是法律文件或者是其他参考资料。
. `% h% j: ]) q* ^, x- z6 \
文档与短名称(表示为一个bytes32)相关联,并且可以选择有一个同其链上相关联的文档内容的哈希值。; ~7 f" T z4 p% I
functiongetDocument(bytes32_name)externalviewreturns(string,bytes32);functionsetDocument(bytes32_name,string_uri,bytes32_documentHash)external;% b+ Z3 X" e& L M" W
canSend1 @8 U% W! q+ R& I, Z5 |: Q
证券转让可能由于多种原因失败,例如:
, N2 o* z1 m7 b+ ]! |% x
代币发送方或接收方的身份信息。
对转账的特定代币的限制(即与转让代币相关tranche的限制)6 \1 j. ~% n0 _2 Q8 E8 t5 W; n r0 r
对代币总体状态相关的限制(即投资人总数)3 _! y& s% ?" \. N( @% f, r
该标准提供了一个链上函数,用于决定转账是否能成功,并返回指示转账失败原因的详细原因。
; d* F, H( K1 G; G0 C
这些规则可以由智能合约还有链上数据来定义,或者依赖可以表示对转账进行授权的sendByTranche函数(例如,声明转账有效性的转账代理的签名信息)返回的部分_data。/ c' w% l+ E q! }' z
d& O- o ]# f
此函数将会返一个遵循ERC-1066标准的ESC(EthereumStatusCode,以太坊状态码),还有一个可以用于定义程序指定原因码及额外详细信息(例如,执行发送操作的转账限制无效)的bytes32参数
9 [7 }4 @2 v; b! C- V+ ]
此函数也会以与sendByTranche类似的方式返回所转账代币的目标tranche
functioncanSend(address_from,address_to,bytes32_tranche,uint256_amount,bytes_data)externalviewreturns(byte,bytes32,bytes32);
issuable
一个证券型代币发行人可以指定此代币的发行已结束(即,不能铸造或发行新的代币): k! L* N t( N Z9 x# x+ d# T" k
如果代币在issuable()返回的是false,今后只能返回false。: j q$ \* v4 M* X. p7 r
functionissuable()externalviewreturns(bool);
Q: R4 R8 [+ N" U$ v1 B) y
issueByTranche: x- o; F, @; ~8 N" M4 ~- Q
! ^9 R( }) Y" ?1 K
此函数在增长代币供应总量时必须被调用。
在调用时,此函数必须触发IssuedByTranche事件。2 m+ S9 \: { _4 i
functionissueByTranche(bytes32_tranche,address_tokenHolder,uint256_amount,bytes_data)external;9 \$ }* Q& ^1 j" D; }" \
Interface3 r0 j! x: K3 V0 A5 h2 V
' [7 h0 V* Y, `" v/ n- j# g- j: d/ R* D
///@titleERC-STFungibleTokenMetadataStandard///@devSeehttps://github.com/SecurityTokenStandard/EIP-Spec
/ E8 U2 I: Z$ \6 z | `% j
interfaceIERCSTisIERCPFT{functiongetDocument(bytes32_name)externalviewreturns(string,bytes32);functionsetDocument(bytes32_name,string_uri,bytes32_documentHash)external;functionissuable()externalviewreturns(bool);functioncanSend(address_from,address_to,bytes32_tranche,uint256_amount,bytes_data)externalviewreturns(byte,bytes32,bytes32);functionissueByTranche(bytes32_tranche,address_tokenHolder,uint256_amount,bytes_data)external;}9 n8 C# e* a, Q* u
2 e1 X; x7 p2 N) Q r
Notes6 _* k5 z& Y m; [' ]. Z b
ForcedTransfers
) S& Q5 r. `! N0 _' F
可能是法规要求发行人或受信任的第三方保留代表投资人转账代币的权利。因此,ERC-ST规范取代ERC-PFT,因为不得允许代币持有人撤销默认的操作人。
RestrictedTransfers
相比实用型代币,证券型代币的转账可能因为多种原因而失败,而实用型代币通常仅要求发送方有足够的余额。
# s% k2 w/ h1 F w
这些条件可能与被转账的证券型代币的元数据有关(即它们是否受制于锁定周期),代币发送方和接收方的身份及资格(即他们是否已经通过了KYC,是否是可信任的或是发行方的附属机构),或者出于与特定转账无关的原因,而是出于监管下证券层面的原因(即证券强制执行投资者的最大数量和单一投资者持有百分比的最高上限)。6 g$ O- Q \7 s# J; w$ v
- a5 F( x; W2 ^. E; v/ C/ }% @
对于实用型代币(ERC20/ERC777标准的),balanceOf和allowance函数提供了一种方式用以在执行转账操作前检查转账是否可能成功,可以在链上或链下执行。! G7 M+ P: I1 Z0 y7 V+ S
$ j9 d$ [- ^" P; E
该标准引入了一个函数canSend,它提供了一种更通用的方法来查询发送代币能否成功。它接收一组参数,参数可能包括签名数据,并返回关于交易成功或失败的原因字节码。
$ [1 h" h& a7 O7 L; O8 u
注意——调用canSend的结果可能会根据链上状态(包括区块高度或时间戳)和链下预言机发生改变。因此,在作为不修改任何状态的视图函数被调用之后,它不能保证将来的转账一定会成功。
Identity3 ^0 y3 G# h4 A
7 p* a6 L$ X( l0 u& E! |6 D
在许多司法管辖区,一方能否接收和发送证券型代币依赖于该方身份的特征。例如,在一方有资格购买或出售特定的证券之前,绝大多数的司法管辖区都要求具有某种程度的KYC/AML流程。另外,一方可能被分类到投资人资格类别(比如,合格的投资人和购买者),并且他们的公民身份也可以告知与其证券相关联的限制。
多种身份标准(比如ERC725,Civic,uPort)可用于捕获某一方的身份数据,以及集中管理的其他方法(例如,维护一个经KYC批准的地址白名单)。这些身份标准的共同之处是以太坊地址(可以是一方的钱包地址或者身份合同),因此canSend函数可以使用证券型代币的发送方和接收方的地址作为确定是否符合资格要求身份的代理。; m5 F/ d: I3 v/ } z b% x
除此之外,该标准并未强制要求任何特定的身份识别方法。
9 C% `: x" g- X+ X
ReasonCodes3 ~) S* N# e4 H6 v+ j8 p! m- a
为了改善代币持有人的体验,canSend必须依据下面指定的ERC-1066标准应用程序特定状态代码返回成功或失败的原因字节码。具体的实现还可以将任意数据以bytes32的形式返回,以提供原因码以外的额外的信息( U: l( R: i5 A) {
Code
Reason
: ]0 @: o0 [; Q3 W4 v
0xA0TransferVerified-Unrestricted& K5 M6 _- T+ s2 i
0xA1TransferVerified-On-Chainapprovalforrestrictedtoken, [8 w( m0 u! t! m) O+ T
0xA2TransferVerified-Off-Chainapprovalforrestrictedtoken! `$ M& W4 m# Q) x1 j4 V4 W2 n
0xA3TransferBlocked-Senderlockupperiodnotended
4 d) C5 \2 R. F/ H
0xA4TransferBlocked-Senderbalanceinsufficient
m* {& E' i) |# A3 _% n1 S
0xA5TransferBlocked-Sendernoteligible
$ ~% K8 I8 x) h4 h/ \0 K) ~
0xA6TransferBlocked-Receivernoteligible% u! p* O$ q# C* E/ v j2 A. }
5 F+ m6 \6 u6 y" I/ U/ m' E
0xA7TransferBlocked-Identityrestriction
0xA8TransferBlocked-Tokenrestriction
* [% |; n3 e1 w: o9 z6 M8 ~) m
0xA9TransferBlocked-Tokengranularity
! F# l. h$ O2 f2 ^
On-chainvs.Off-chainTransferRestrictions, G0 D8 C" X P9 D6 ?$ E
2 p9 l+ Z- g0 G
确定一个证券型代币能否被发送的规则是可以自动执行的(例如,对证券投资人的最大数量限制),或者需要一些链下的输入(比如,经纪人对交易的明确批准)。为了方便线下的情况,sendByTranche和canSend函数接收一个额外的_data参数,该参数可以由批准方签名并用于验证传输。" E- S# }* C4 k4 N& t3 n( O
& _+ U+ {* o1 h* e7 r/ p _) K
此规范超出了本标准的范围,具体的实现也是特定的。
成为第一个吐槽的人