基于以太坊的交易所BANCOR算法实现-转换算法框架
V刘晨曦
发表于 2022-11-26 14:54:17
2346
1
0
若利用智能合约的强大而灵活的“资金流转控制”能力,在通证合约中控制着一定量的储备金,让通证与储备金之间拥有一定的兑换能力,那么Token的价值就可以储备金为锚定物,而不完全依赖于项目方。通证持有者也就不用承担项目失败或者项目方可能诈骗跑路的风险。 r; N" }7 ]( e
若通证与锚定物之间的兑换算法采用了Bancor算法,又符合ERC20标准,则被称为智能通证(Smart-Token) 。为了简单起见,以下的论述以ETH作为锚定物举例说明。购买与售卖Token的过程如下:8 u0 ^( s" y9 E# h. K, E) I7 N3 j* i
“购买者”发送一定量的ETH到Token合约地址,触发了合约代码自动执行"购买功能代码",获得对应数量的Token;“售卖者”发送一定量的Token到Token合约地址,触发了合约代码自动执行“售卖功能代码”,获得对应数量的ETH。" E- N& V! [. z2 H5 Q& H
若AToken与BToken都是以ETH为锚定物的智能通证,那么Token持有者无需通过交易所,仅仅凭借智能合约提供的买卖与兑换功能,就能实现AToken与BToken的自由兑换,比如AToken–>ETH–>BToken,多种智能通证之间通过共同的锚定物串接起来,就形成了一个价值网络(Bancor Network)。+ @+ ^2 X3 |, }
4 H# ]& q5 l+ i1 Z' B. M0 S7 X: X
【核心智能合约简单描述】5 _0 K: ^" ], r; H6 r* ?
1,contract BancorConverter
功能说明:代币转换器,允许一个智能代币和其他代币之间的转换,ERC20连接器的余额可以是虚拟的,从而不需要依赖于真实的余额,这有助于避免在一个协约中有大量金额的风险。转换器可以升级。
2,ITokenConverter" y; J% o* y$ W
功能说明:BancorConverter的父类接口之一,EIP228 Token Converter接口,用于智能代币的买卖和数量计算接口。
3,SmartTokenController$ R; @! ?' f0 k$ g9 ^0 ~% r8 ^' p
功能说明:BancorConverter的父类接口之一,智能代币管理器。智能代币管理器是一个可以升级的模块,从而允许更多功能和问题修复。当它接受了代币的所有权,它会成为代币的唯一管理器,执行各个功能。
4,Managed
功能说明: BancorConverter的父类之一,提供协议管理的支持。1 y, [5 t/ G" e; f% @5 J; p1 ~5 E6 l
5,IBancorConverterExtensions3 W$ e6 D( a- f' r, M7 @
功能说明:BancorConverter的公开变量类,bancor converter extensions 协议。能返回formula,gasPriceLimit,quickConverter等3类接口合约。
#4,核心函数分析
##4.1 convert(…)函数
convert(IERC20Token _fromToken, IERC20Token _toToken, uint256 _amount, uint256 _minReturn) public returns (uint256)功能: 将一定数量的_fromToken 转换为 _toToken;源码:9 O* v K: c7 X: G, s' r. m
/**6 H& }6 k1 D2 [& r4 c
@dev 将一定数量的_fromToken 转换为 _toToken) `0 C7 j# c7 V0 y
@param _fromToken 用来转换ERC20代币
@param _toToken 被转换到的ERC20代币; |! h4 }- Y2 d- a4 i6 _# k( a1 a4 u
@param _amount 转换的数量,基于fromToken
@param _minReturn 限制转换的结果需要高于minReturn,否则取消
@return conversion 返回数量, P1 F O" u. p6 t3 K1 {: k6 w& r2 W
*/
function convert(IERC20Token _fromToken, IERC20Token _toToken, uint256 _amount, uint256 _minReturn) public returns (uint256) {! [0 K6 Q. J H0 z$ K5 ]
convertPath = [_fromToken, token, _toToken];
return quickConvert(convertPath, _amount, _minReturn);5 R+ e2 w- v/ S
}# G3 u& O; M4 q8 P
/**) {: n9 ]4 J7 \
@dev 通过之前定义的转换路径来转换代币3 w7 b& r% E% l9 E
注意:当从ERC20代币进行转换,需要提前设置补贴
@param _path 转换路径# R& T4 ]; ~, J) m# U8 l. g- j4 m
@param _amount 转换的数量7 ~* E- |) q0 K |" Y
@param _minReturn 限制转换的结果需要高于minReturn,否则取消2 F1 I# r& c; F5 \ h H: X/ U
@return 返回数量
*/2 e! W) b& {. n3 m( f( z* W4 o
quickConvertfunction quickConvert(IERC20Token[] _path, uint256 _amount, uint256 _minReturn)# I. I2 O4 e% G% d( X
public" y# w0 T0 ^, e5 ]& o
payable* U" ]3 _: l5 [3 i
validConversionPath(_path)) o$ W# o% M' Z0 l9 q5 s! I
returns (uint256)8 U# f( l& W) c/ d
{
return quickConvertPrioritized(_path, _amount, _minReturn, 0x0, 0x0, 0x0, 0x0, 0x0);3 y/ {0 P! A0 i0 v6 }6 ~6 q
} P1 N2 N O8 C: v* H# L9 G
/**
@dev 通过之前定义的转换路径来转换代币: {2 W* C+ K6 |7 J) _5 Y
注意:当从ERC20代币进行转换,需要提前设置补贴
@param _path 转换路径
@param _amount 转换的数量% @$ k# E% K* ] I: x, w! Y
@param _minReturn 限制转换的结果需要高于minReturn,否则取消
@param _block 如果当前的区块超过了参数,则取消
@param _nonce 发送者地址的nonce8 h* n& z' |4 \
@param _v 通过交易签名提取/ G. h3 L+ s, e% C R
@param _r 通过交易签名提取% ^% c/ s* |, l+ K- Z* |9 a+ O7 h, E
@param _s 通过交易签名提取
@return 返回数量$ u% S p0 ^$ J9 N0 b
*/
function quickConvertPrioritized(IERC20Token[] _path, uint256 _amount, uint256 _minReturn, uint256 _block, uint256 _nonce, uint8 _v, bytes32 _r, bytes32 _s)
public
payable# z/ [8 B- e8 `2 Z. q+ e
validConversionPath(_path)6 x& Y$ Z+ i- K9 m8 r; G% U. Q7 g
returns (uint256)
{/ Z! W5 P/ U" g4 A
IERC20Token fromToken = _path[0];% F7 `+ F! |5 R/ a: H2 h$ G! Y
IBancorQuickConverter quickConverter = extensions.quickConverter(); {) S5 R- I& y `
// 我们需要从调用者向快速转换着把源代币转化9 m; Y" E# F1 ~' i7 m6 G0 g
// 因此他能基于调用者进行转换9 Z( B4 R/ Y, h$ S" v: p
if (msg.value == 0) {; }7 L+ g1 b9 v: i5 @& X; Q( B, P
// 如果不是ETH,把源代币发给快速调用者
// 如果是智能代币,不需要补贴 —— 销毁代币,然后发给快速转换者
if (fromToken == token) {
token.destroy(msg.sender, _amount); // 销毁调用者的_amount代币
token.issue(quickConverter, _amount); // 把_amount的新代币发给快速转换者! L: A. ^) U+ V- _! A W4 k
} else {
// 否则,我们假设有了补贴,发给快速转换者& @& Q7 i' m0 V
assert(fromToken.transferFrom(msg.sender, quickConverter, _amount));- Y: m0 W: c5 _5 f' s5 b9 Z9 b9 D
}
}$ }! j; L" q, @: b, [$ G
// 执行转换,把ETH转回, e$ H6 m( v9 h( @7 ]
return quickConverter.convertForPrioritized.value(msg.value)(_path, _amount, _minReturn, msg.sender, _block, _nonce, _v, _r, _s);
}* z& L+ g3 u' P- T4 z& j
##4.2 change(…)函数
** function change**(IERC20Token _fromToken, IERC20Token _toToken, uint256 _amount, uint256 _minReturn) public returns (uint256)功能: 将一定数量的_fromToken 转换为 _toToken。弃用了,向后兼容。设计思路和源码结构挺好的代码:
既然是过期代码,源代码就不放了。
##4.3 getReturn(…)函数
function getReturn(IERC20Token _fromToken, IERC20Token _toToken, uint256 _amount) public view returns (uint256)1 `" g7 \5 R# [: W0 E# D" |, _ _7 D
. T3 }4 h% \/ w5 m' T
功能:
返回从一个代币转换为另一个代币的预期数源码:
+ o( k3 j( W. \2 v! [
/**
@dev 返回从一个代币转换为另一个代币的预期数量8 p, i7 Z& [6 y( v5 G" w2 t4 ^
@param _fromToken ERC20 被转换的代币, C6 ?! }9 I' {- ]. W
@param _toToken ERC20 转换成的代币
@param _amount 转换的数量! e$ ?4 @7 D1 k, _' l: I
@return 与其转换的数量
*/
function getReturn(IERC20Token _fromToken, IERC20Token _toToken, uint256 _amount) public view returns (uint256) {
require(_fromToken != _toToken); // 验证输入. W, h* n: K& k! X. |
// 基于当前代币转换2 M% ?* E( _, e) J
if (_toToken == token)- S2 ? {; Q, [* p2 c, s* {
return getPurchaseReturn(_fromToken, _amount);! m% Q. H" G# n- r
else if (_fromToken == token)
return getSaleReturn(_toToken, _amount);
// 在两个连接器之间转换 w3 U) `' A% q O7 P
uint256 purchaseReturnAmount = getPurchaseReturn(_fromToken, _amount);/ @6 b S4 J2 S6 t
return getSaleReturn(_toToken, purchaseReturnAmount, safeAdd(token.totalSupply(), purchaseReturnAmount));: w# A) |$ c3 c& m0 L8 B& {/ l
}$ F8 `4 q& B9 N+ u
/**; D2 C7 H3 ^! c" R4 X
@dev 返回通过一个连接器代币购买代币的预期结果/ a/ R% c" Y( l2 `% m9 Y. F* D/ _
@param _connectorToken 连接器代币协约地址/ V5 I% |; ?# F2 z3 D' X
@param _depositAmount 买入的数量4 f$ N, y# v" _3 }/ L
@return 预期的数量
*/" E$ ?7 G& U( f3 W# }3 i7 {
function getPurchaseReturn(IERC20Token _connectorToken, uint256 _depositAmount)
public( u. c# F8 a3 c* M- J: ^
view: ~+ O; A: |2 f! V8 T( {
active
validConnector(_connectorToken)
returns (uint256)8 \. S, [" V1 u1 ?% Y2 d9 |0 M
{2 J* a" n$ x" Y
Connector storage connector = connectors[_connectorToken];( r- q: ?$ g& ?4 c( c
require(connector.isPurchaseEnabled); // validate input' k% a3 }+ ]0 M2 l
uint256 tokenSupply = token.totalSupply();
uint256 connectorBalance = getConnectorBalance(_connectorToken);! O V# d7 N. x
uint256 amount = extensions.formula().calculatePurchaseReturn(tokenSupply, connectorBalance, connector.weight, _depositAmount);
// 扣除费用( y- N* O0 ~, Z
uint256 feeAmount = getConversionFeeAmount(amount);
return safeSub(amount, feeAmount);% C: `' N# J: P3 d( @! U
}
/**
@dev 返回通过一个连接器代币卖出代币的预期结果
@param _connectorToken 连接器代币协约地址' _ P5 V4 C8 a1 u" l
@param _sellAmount 卖出的数量
@return 预期得到的数量* Z# p- J2 S, N* d" ^/ M
*/
function getSaleReturn(IERC20Token _connectorToken, uint256 _sellAmount) public view returns (uint256) {
return getSaleReturn(_connectorToken, _sellAmount, token.totalSupply());
}# S$ O0 B! S* j
/**, N& z& \' V3 M# o
@dev 工具,基于一个总供应量,返回基于一个连接器代币来卖掉代币的期待返回0 \8 ?6 I" Z' k2 S4 ?4 ^" @1 C
@param _connectorToken 连接器代币协议地址9 H3 Z; o; u O: c4 y* Z6 V6 ?. Y9 G
@param _sellAmount 销售的数量
@param _totalSupply 设置总供应量# Q9 F# A/ h. {/ x$ }+ s; d: z1 f
@return 返回的数量) e, f# z( ]3 @6 I
*/% D+ ]/ A) B( p7 T
function getSaleReturn(IERC20Token _connectorToken, uint256 _sellAmount, uint256 _totalSupply)2 p; O, T0 a; z) _" E2 r
private3 j. g% p& W* }' P9 ^+ `
view, G% U3 f, i0 @- [: N9 z. `( r
active y# q' f* K3 O# W
validConnector(_connectorToken)
greaterThanZero(_totalSupply)
returns (uint256)
{% p& q! ?) ^# x
Connector storage connector = connectors[_connectorToken];
uint256 connectorBalance = getConnectorBalance(_connectorToken);
uint256 amount = extensions.formula().calculateSaleReturn(_totalSupply, connectorBalance, connector.weight, _sellAmount);
// 从返回的数量中剪掉费用5 S4 w N: u9 d7 i
uint256 feeAmount = getConversionFeeAmount(amount);
return safeSub(amount, feeAmount);
}
BitMere.com 比特池塘系信息发布平台,比特池塘仅提供信息存储空间服务。
声明:该文观点仅代表作者本人,本文不代表比特池塘立场,且不构成建议,请谨慎对待。
声明:该文观点仅代表作者本人,本文不代表比特池塘立场,且不构成建议,请谨慎对待。
成为第一个吐槽的人