基于以太坊的交易所BANCOR算法实现-转换算法框架
V刘晨曦
发表于 2022-11-26 14:54:17
2343
1
0
若利用智能合约的强大而灵活的“资金流转控制”能力,在通证合约中控制着一定量的储备金,让通证与储备金之间拥有一定的兑换能力,那么Token的价值就可以储备金为锚定物,而不完全依赖于项目方。通证持有者也就不用承担项目失败或者项目方可能诈骗跑路的风险。
% ^ E% \5 V- [
若通证与锚定物之间的兑换算法采用了Bancor算法,又符合ERC20标准,则被称为智能通证(Smart-Token) 。为了简单起见,以下的论述以ETH作为锚定物举例说明。购买与售卖Token的过程如下:
“购买者”发送一定量的ETH到Token合约地址,触发了合约代码自动执行"购买功能代码",获得对应数量的Token;“售卖者”发送一定量的Token到Token合约地址,触发了合约代码自动执行“售卖功能代码”,获得对应数量的ETH。+ Q' b4 i$ A* @% A
若AToken与BToken都是以ETH为锚定物的智能通证,那么Token持有者无需通过交易所,仅仅凭借智能合约提供的买卖与兑换功能,就能实现AToken与BToken的自由兑换,比如AToken–>ETH–>BToken,多种智能通证之间通过共同的锚定物串接起来,就形成了一个价值网络(Bancor Network)。2 k9 ?& B1 Q9 s4 R
4 J8 N4 C/ ^( K* p) M. Q" g
【核心智能合约简单描述】& X1 p1 X- v4 T; K( X* V
1,contract BancorConverter% M8 J# t8 c7 x4 i/ a8 n4 E% y, P4 _
功能说明:代币转换器,允许一个智能代币和其他代币之间的转换,ERC20连接器的余额可以是虚拟的,从而不需要依赖于真实的余额,这有助于避免在一个协约中有大量金额的风险。转换器可以升级。
2,ITokenConverter
功能说明:BancorConverter的父类接口之一,EIP228 Token Converter接口,用于智能代币的买卖和数量计算接口。
3,SmartTokenController
功能说明:BancorConverter的父类接口之一,智能代币管理器。智能代币管理器是一个可以升级的模块,从而允许更多功能和问题修复。当它接受了代币的所有权,它会成为代币的唯一管理器,执行各个功能。- g5 q" F: w& o1 ^( D
4,Managed4 e! t+ C, v* V' V& n; w- V
功能说明: BancorConverter的父类之一,提供协议管理的支持。
5,IBancorConverterExtensions# S, b5 \* C; v) F
功能说明:BancorConverter的公开变量类,bancor converter extensions 协议。能返回formula,gasPriceLimit,quickConverter等3类接口合约。! b4 g2 `$ l: k4 {& q a) W
#4,核心函数分析8 c& _* r: I1 v5 b0 v
##4.1 convert(…)函数' G# N% ?( s+ C1 S7 w6 E
convert(IERC20Token _fromToken, IERC20Token _toToken, uint256 _amount, uint256 _minReturn) public returns (uint256)功能: 将一定数量的_fromToken 转换为 _toToken;源码:6 T! C2 W* C4 V3 ^9 F# D' E2 B
% m/ g7 E' c* O" h( @
/**
@dev 将一定数量的_fromToken 转换为 _toToken8 H7 g H6 Q5 d: w1 ]
@param _fromToken 用来转换ERC20代币6 \, Q Y# q' R
@param _toToken 被转换到的ERC20代币. |9 ^1 ?0 R/ r) A
@param _amount 转换的数量,基于fromToken5 {: m4 S2 O3 C& ]( D
@param _minReturn 限制转换的结果需要高于minReturn,否则取消
@return conversion 返回数量- l4 `" q( L4 B9 h1 A: D1 a
*/
function convert(IERC20Token _fromToken, IERC20Token _toToken, uint256 _amount, uint256 _minReturn) public returns (uint256) {
convertPath = [_fromToken, token, _toToken];. w/ r0 O* A! o7 [0 f. M1 Q% k4 e3 f
return quickConvert(convertPath, _amount, _minReturn);. ]' s' l9 `; Q9 x
}
/**
@dev 通过之前定义的转换路径来转换代币, q, N- y, \# U: M
注意:当从ERC20代币进行转换,需要提前设置补贴! k/ k S8 }* a/ W% L
@param _path 转换路径3 ^7 `7 X! g# a
@param _amount 转换的数量
@param _minReturn 限制转换的结果需要高于minReturn,否则取消
@return 返回数量
*/
quickConvertfunction quickConvert(IERC20Token[] _path, uint256 _amount, uint256 _minReturn)% z" ?- P- \# i3 n/ D
public
payable
validConversionPath(_path)" l0 j/ R9 P8 F, U9 l$ q; S) p$ c8 U
returns (uint256)) z5 c/ {8 a8 r! R9 C
{
return quickConvertPrioritized(_path, _amount, _minReturn, 0x0, 0x0, 0x0, 0x0, 0x0);
}1 x r- c8 M/ x ]
/**
@dev 通过之前定义的转换路径来转换代币
注意:当从ERC20代币进行转换,需要提前设置补贴
@param _path 转换路径" x# Q1 ?1 ^8 N/ \8 m9 Q
@param _amount 转换的数量
@param _minReturn 限制转换的结果需要高于minReturn,否则取消
@param _block 如果当前的区块超过了参数,则取消
@param _nonce 发送者地址的nonce- n' V/ j8 S+ [# [
@param _v 通过交易签名提取, \# u" T0 Q/ z8 I# ?, i
@param _r 通过交易签名提取! E- j, U7 N) G$ U) m C( D1 A
@param _s 通过交易签名提取7 T( i- y3 l I; T Y: _
@return 返回数量7 m3 H1 r g; N; Z7 I8 }# n; h
*/
function quickConvertPrioritized(IERC20Token[] _path, uint256 _amount, uint256 _minReturn, uint256 _block, uint256 _nonce, uint8 _v, bytes32 _r, bytes32 _s)3 z; f% {* L- a4 v3 S
public
payable; a, i( [: P! R! ~
validConversionPath(_path)
returns (uint256)6 I' h( C6 r( a3 @7 D
{+ l* l( {. Y) b9 W' n
IERC20Token fromToken = _path[0];
IBancorQuickConverter quickConverter = extensions.quickConverter();
// 我们需要从调用者向快速转换着把源代币转化
// 因此他能基于调用者进行转换" f8 z5 s" l& ~6 C
if (msg.value == 0) {
// 如果不是ETH,把源代币发给快速调用者9 _8 { f* W [
// 如果是智能代币,不需要补贴 —— 销毁代币,然后发给快速转换者" \: v1 i1 K: `% u/ D4 `# ?8 [
if (fromToken == token) {
token.destroy(msg.sender, _amount); // 销毁调用者的_amount代币
token.issue(quickConverter, _amount); // 把_amount的新代币发给快速转换者
} else {
// 否则,我们假设有了补贴,发给快速转换者! d: K' g9 M5 U' c8 X# s% T
assert(fromToken.transferFrom(msg.sender, quickConverter, _amount)); p2 [8 I0 O& U& l$ [6 C
}
}
// 执行转换,把ETH转回( t3 Y+ W \5 W. y, a! z
return quickConverter.convertForPrioritized.value(msg.value)(_path, _amount, _minReturn, msg.sender, _block, _nonce, _v, _r, _s);
}' E. E1 H0 c- q+ E" a
##4.2 change(…)函数
** function change**(IERC20Token _fromToken, IERC20Token _toToken, uint256 _amount, uint256 _minReturn) public returns (uint256)功能: 将一定数量的_fromToken 转换为 _toToken。弃用了,向后兼容。设计思路和源码结构挺好的代码:
既然是过期代码,源代码就不放了。
##4.3 getReturn(…)函数- T* [& a7 g- T/ R- ~* Q+ t. Y
6 [, u, J6 ?, a0 T
function getReturn(IERC20Token _fromToken, IERC20Token _toToken, uint256 _amount) public view returns (uint256)( S. v1 [( b2 ]- @( \* }# R% H
功能:
返回从一个代币转换为另一个代币的预期数源码:/ Q5 X4 z1 Q0 W2 F7 `& ]8 S" S ]
9 x& |2 t+ a6 l1 d' H, v' ^
/**1 b- Z2 g8 t' S1 c- O/ j
@dev 返回从一个代币转换为另一个代币的预期数量* p0 a' x) w3 z. x n
@param _fromToken ERC20 被转换的代币3 d8 Q7 E# W( T* D F& Y5 \
@param _toToken ERC20 转换成的代币
@param _amount 转换的数量2 @; `- K: t& f. ^/ O0 B0 g( S' g8 p
@return 与其转换的数量
*/
function getReturn(IERC20Token _fromToken, IERC20Token _toToken, uint256 _amount) public view returns (uint256) {1 q+ N0 K8 ~( {( c
require(_fromToken != _toToken); // 验证输入
// 基于当前代币转换
if (_toToken == token)
return getPurchaseReturn(_fromToken, _amount);
else if (_fromToken == token)) X% u7 ~/ v0 p6 d# {. _# W
return getSaleReturn(_toToken, _amount);# [. y" R+ U$ n0 p' [3 V ]5 l1 R
// 在两个连接器之间转换
uint256 purchaseReturnAmount = getPurchaseReturn(_fromToken, _amount);
return getSaleReturn(_toToken, purchaseReturnAmount, safeAdd(token.totalSupply(), purchaseReturnAmount));
}
/**% w5 a8 c' r$ u2 O5 r/ H* H
@dev 返回通过一个连接器代币购买代币的预期结果0 \, v1 u( f/ W7 D4 x3 K- ~% I3 f
@param _connectorToken 连接器代币协约地址2 O. q% C5 k& i9 L( W' S$ \
@param _depositAmount 买入的数量! j+ k3 z$ |) e. q
@return 预期的数量
*/6 ?6 U4 w+ f5 h( ^- u4 _
function getPurchaseReturn(IERC20Token _connectorToken, uint256 _depositAmount)! _, j8 Z2 d; O4 F9 g5 { j1 ^
public' O6 W* F% l+ ?0 A1 }
view
active: j9 h8 i& u. H' N7 `+ ~ ~
validConnector(_connectorToken)
returns (uint256); u# n4 h6 v8 s
{& h! G; Q: x; p
Connector storage connector = connectors[_connectorToken];
require(connector.isPurchaseEnabled); // validate input/ M0 q" Q: h* v' @$ f( {* I; C+ O T3 R, C
uint256 tokenSupply = token.totalSupply();; u2 S# F# ^- g3 E& O1 x
uint256 connectorBalance = getConnectorBalance(_connectorToken);
uint256 amount = extensions.formula().calculatePurchaseReturn(tokenSupply, connectorBalance, connector.weight, _depositAmount);
// 扣除费用9 @ R/ J) s; q1 a+ V1 k
uint256 feeAmount = getConversionFeeAmount(amount);
return safeSub(amount, feeAmount);0 {2 m' ^- Z) i4 e- j: u* O0 J
}
/**
@dev 返回通过一个连接器代币卖出代币的预期结果
@param _connectorToken 连接器代币协约地址3 I# z4 ~2 I& y; l6 Z6 u0 b
@param _sellAmount 卖出的数量
@return 预期得到的数量& K! S3 N' G" p7 Q9 i
*/! B* \- q2 X+ \# q
function getSaleReturn(IERC20Token _connectorToken, uint256 _sellAmount) public view returns (uint256) {: S! R# L8 I0 J: {' M
return getSaleReturn(_connectorToken, _sellAmount, token.totalSupply());( n* B' {3 p7 M5 L9 y- s) { `
}: w) Y" b) z5 M& T
/**2 L# A2 L1 W7 B, `/ Q( _9 T, E
@dev 工具,基于一个总供应量,返回基于一个连接器代币来卖掉代币的期待返回, Z7 X8 c' l- f5 W& u. M
@param _connectorToken 连接器代币协议地址: d [; P1 ^ D, U* s
@param _sellAmount 销售的数量, T( F8 O' a9 G' ~! u
@param _totalSupply 设置总供应量6 F0 h3 M4 c L+ ~6 O7 F; g; S. u
@return 返回的数量
*// L! P! }; C x+ M: q: C" }
function getSaleReturn(IERC20Token _connectorToken, uint256 _sellAmount, uint256 _totalSupply)$ G% }5 P$ ]3 ~ T
private
view, G# }+ P! x# c+ x5 `6 E- r
active
validConnector(_connectorToken)
greaterThanZero(_totalSupply)# y1 Z) s2 V% D8 R
returns (uint256)+ K" T0 G% m' m' X+ }
{
Connector storage connector = connectors[_connectorToken];
uint256 connectorBalance = getConnectorBalance(_connectorToken);! z' M7 ^5 W4 B
uint256 amount = extensions.formula().calculateSaleReturn(_totalSupply, connectorBalance, connector.weight, _sellAmount);
// 从返回的数量中剪掉费用
uint256 feeAmount = getConversionFeeAmount(amount);5 |: K- a5 c: t
return safeSub(amount, feeAmount);, J P2 K9 o) b7 {; N+ G A
}
BitMere.com 比特池塘系信息发布平台,比特池塘仅提供信息存储空间服务。
声明:该文观点仅代表作者本人,本文不代表比特池塘立场,且不构成建议,请谨慎对待。
声明:该文观点仅代表作者本人,本文不代表比特池塘立场,且不构成建议,请谨慎对待。
成为第一个吐槽的人