基于EOS的去中心化交易平台

ET开放式去中心化交易平台白皮书

telegram：https://t.me/etex_official
微信：tao709308469

一. 合约接口说明:

1. 创建代币bancor池:
   void create(account_name payer, account_name exchange_account, asset eos_supply, account_name token_contract, asset token_supply);
   payer: 支付账号,从这个账号转出代币和EOS到bancor池账号
   exchange_account: bancor池账号,TEST代币和EOS代币都在此账号名下:如:etbexchange1
   eos_supply: 初始化EOS数量:如: 100000.0000 EOS
   token_contract: 代币属于哪个合约,如:issuemytoken部署创建了TEST代币
   token_supply: 初始化代币数量:如:1000000.0000 TEST代币

2. 买代币
   void buytoken( account_name payer, asset eos_quant,account_name token_contract, symbol_type token_symbol, account_name fee_account,int64_t fee_rate);
   payer: 买币账号
   eos_quant: 用quant个EOS购买代币
   token_contract: 代币属于哪个合约,如TEST代币是issuemytoken部署创建的
   token_symbol: 想要购买的代币符号:如TEST
   fee_account: 收取手续费的账号
   fee_rate: 手续费率:[0,10000),如:50等同于万分之50; 0等同于无手续费

3. 卖代币
   void selltoken( account_name receiver, account_name token_contract, asset quant ,account_name fee_account,int64_t fee_rate);
   receiver: 卖币账号,接收EOS
   token_contract: 代币属于哪个合约,如TEST代币是issuemytoken部署创建的
   quant: 想要卖出的quant个代币
   fee_account: 收取手续费的账号
   fee_rate: 手续费率:[0,10000),如:50等同于万分之50; 0等同于无手续费

4. 增加bancor池的代币量
   void exchange::addtoken( account_name account,asset quant, account_name token_contract,symbol_type token_symbol )
   account: 支付账号,从这个账号转出当前市场价格的代币和EOS到bancor池账号中
   quant: 新增的EOS量
   token_contract: 代币属于哪个合约,如TEST代币是issuemytoken部署创建的
   token_symbol: 新增的代币符号 例如:当前市场1EOS可以买到10个TEST,那么增加1000个EOS时,会从account转出1000个EOS和10000个TEST到bancor池中

5. 减少bancor池的代币量
   void exchange::subtoken( account_name account, asset quant, account_name token_contract,symbol_type token_symbol )
   account: 支付账号,向这个账号转入当前市场价格的代币和EOS
   quant: 减少的EOS量
   token_contract: 代币属于哪个合约,如TEST代币是issuemytoken部署创建的
   token_symbol: 减少的代币符号
   例如:当前市场1EOS可以买到10个TEST,那么减少1000个EOS时,会从bancor池中转出1000个EOS和10000个TEST到account中

二. 交易所操作步骤:合约账号:etbexchanger,用于创建交易所;(可在主网上查看)

1.编译合约
eosiocpp -o /eos/contracts/etbexchange/etbexchange.wast /eos/contracts/etbexchange/etbexchange.cpp /eos/contracts/etbexchange/exchange_state.cpp
eosiocpp -g /eos/contracts/etbexchange/etbexchange.api /eos/contracts/etbexchange/etbexchange.cpp

2. 部署交易所合约
   eg: cleos set contract etbexchanger /eos/contracts/etbexchange -p etbexchanger

3. 创建TEST代币bancor池:

先授权给合约:
cleos set account permission etbexchanger active '{"threshold": 1,"keys": [{"key": "EOS6mBLtJQv5Adv36dDkvWtPP7bqUNArwWXiZCT8711CUBPBTbdnR","weight": 1}],"accounts": [{"permission":{"actor":"etbexchanger","permission":"eosio.code"},"weight":1}]}' owner -p etbexchanger

从etbexchanger中转出4个EOS和100000000个TEST币到bancor池etbexchange1中:
cleos push action etbexchanger create '["etbexchanger","etbexchange1", "4.0000 EOS","issuemytoken","100000000.0000 TEST"]' -p etbexchanger

撤销授权:
cleos set account permission etbexchanger active '{"threshold": 1,"keys": [{"key": "EOS6mBLtJQv5Adv36dDkvWtPP7bqUNArwWXiZCT8711CUBPBTbdnR","weight": 1}],"accounts": []}' owner -p etbexchanger

4. 查看交易所的币交易情况:
   cleos get table etbexchanger etbexchanger markets
   {
   "rows": [{
   "id": 0,
   "idxkey": "0x04544553540000003015a4d94ba53176",
   "supply": "100000000000000 ETBCORE",
   "base": {
   "contract": "issuemytoken", //TEST币的合约账号,可查看该币的发币情况:get currency stats issuemytoken TEST
   "balance": "104265457.2018 TEST", //目前该资金池有 104265457.2018 TEST
   "weight": "0.50000000000000000"
   },
   "quote": {
   "contract": "eosio.token", //EOS币的合约账号,可查看该币的发币情况:get currency stats eosio.token EOS
   "balance": "3.8364 EOS", //目前该资金池有 3.8364 EOS
   "weight": "0.50000000000000000"
   },
   "exchange_account": "etbexchange1" //资金池账号:etbexchange1,上面的TEST和EOS都在这个账号下
   }],
   "more": false
   }

三. 用户交易步骤:
用户1:user11111111, 用户2:user22222222,

1. 买币(买币前授权eosio.code给合约账号etbexchange1,买币后撤销权限)

授权: cleos set account permission user11111111 active '{"threshold": 1,"keys": [{"key": "EOS5EwrHc3V4aFjL2ADV9X246yoZgyFdpKj4spKxq3GJBhETndJum","weight": 1}],"accounts": [{"permission":{"actor":"etbexchanger","permission":"eosio.code"},"weight":1}]}' owner -p user11111111

买TEST币: cleos push action etbexchanger buytoken '["user11111111", "0.1000 EOS", "issuemytoken","4,TEST", "user11111111", "0"]' -p user11111111

撤销授权: cleos set account permission user11111111 active '{"threshold": 1,"keys": [{"key": "EOS5EwrHc3V4aFjL2ADV9X246yoZgyFdpKj4spKxq3GJBhETndJum","weight": 1}],"accounts": []}' owner -p user11111111

2. 卖币

授权: cleos set account permission user11111111 active '{"threshold": 1,"keys": [{"key": "EOS5EwrHc3V4aFjL2ADV9X246yoZgyFdpKj4spKxq3GJBhETndJum","weight": 1}],"accounts": [{"permission":{"actor":"etbexchanger","permission":"eosio.code"},"weight":1}]}' owner -p user11111111

卖TEST币: cleos push action etbexchanger selltoken '["user11111111", "issuemytoken","12439024.3889 TEST", "user11111111", "0" ]' -p user11111111

撤销授权: cleos set account permission user11111111 active '{"threshold": 1,"keys": [{"key": "EOS5EwrHc3V4aFjL2ADV9X246yoZgyFdpKj4spKxq3GJBhETndJum","weight": 1}],"accounts": []}' owner -p user11111111