Eos-DexChain

社区(Contact)

    项目网站:https://github.com/DexChain
    币乎:https://bihu.com/people/224762
    电报:https://t.me/dexchain
    公众号:区块链斜杠青年
    欢迎交流技术及合作，有任何问题请加我微信:itleaks

简介

    Eos-DexChain是DexChain在EOS生态下的一种试验性实现。更多信息请查看【黄皮书】
    为了更好的理解Eos-DexChain,我们再次重述一下区块链4.0的标准。

1）零成本发token
2) 零成本上交易所流通
3）去中心化交易所
    去中心化交易所会借助市场机制完成通证token的价格形成及价值交换
4）高TPS
5）高安全性
6）信用体系
7）可只支持结算层
8) 高兼容及扩展性，可接入已有主流公链

高TPS,高安全性

    EOS本身具备高TPS和一定的高安全性，因而在EOS上创建一个智能合约来实现EOS生态的DexChain是最简单最直接的方式了。

零成本发币

    Eos-DexChain实现一个�类似eosio.token的智能合约，能够比较便捷的实现该功能。
    Eos-DexChain的币分为两种

场内币（create）

    这种币是给那些大量尾部需求的发币人准备的。通过Eos-DexChain发行场内币，只需消耗很少量的RAM（<1k）即可实现，不再�需要部署发币合约而消耗大量的金钱，真正实现了零成本发币。且Eos-DexChain内置推广功能，比如主动领取�空投，转账领取空投。同时场内币的交易很简单，非常容易实现流动性，更多信息将在交易一节讲解。

抵押币 (createbystake)

    抵押币是为了给那些已经发行的币准备的，已经发行的币要在DexChain交易流通，必须先通过抵押方式转换为抵押币，场外币和��Eos-DexChain的抵押币按1:1的比例发行。抵押一个场外比，Eos-DexChain发行一个抵押币。通过1：1抵押的方法实现了场外币和抵押�币的价值绑定，且这个抵押发行过程是完全代码控制的，安全且可靠。

零成本上交易所，去中心化交易所（createdex)

    Eos-DexChain是一个去中心化链，一个币币交易对你可以看成是一个去中心化交易所。

创建交易对

    Eos-DexChain内采用Bancor机制来实现币币交易，Bancor实时交易是目前最好的去中心化交易所的模型。任何用户可以通过抵押交易币对的方式免费自由创建币(场内币,抵押币)交易对。

币币交易对初始�价格

    交易对的初始价格由抵押的量的比例决定。比如用户通过抵押1000EETH，10EOS来创建一个交易对EETH/EOS，那么初始的EETH价格是0.01EOS，后续价格由交易对的买卖交易市场形成。由于创建交易对需要抵押，因而是有成本的，如果定价不合理，创建者会损失资产。比如如果EETH抵押价格过高，就会有EETH持有者卖掉EETH获取EOS, 从而创建者的抵押的EOS变少了，总价值也减少了。因而该机制会促使创建者定一个他觉得合理的价格。

代币价格�形成机制

    cw=0.5的Bancor交易所初始�价格变化比较平缓，后面比较剧烈，�一开始的50%的交易量只会导致价格上涨一倍或者下跌一倍左右，因而市场价格形成不够迅速，因此开始可采取少量抵押量的方式先让市场先形成价格。价格形成后，可能会进入�曲线的快速变动段，因而少量交易就会导致价格大波动，该阶段比较容易进入投机阶段，即大量买进导致价格飞涨（具体可参考RAM暴涨�期）。由于价格急剧飞涨，交易对创建者也有巨额收入，�他也应该乐于坐享其成，真相难道真会是这样的吗？非也，不像RAM市场是由BM,BP一小撮人控制的，且变动前必须�提前通知，因而不够市场化。Eos-DexChain市场内，交易对是可以任意创建的，且相同的交易对也可以创建多个。如果前面的价格飞涨是因为�老的交易所内的�容量不够导致的，且超出了合理价格，那么其他人就�会重开一个容量更大的相同的�交易对来增加�交易量，进而抑制了价格的继续上涨。新的交易所对老交易所的竞争会促使老交易所增加�bancor的交易容量，进而减少波动。同时为了减少价格波动和抑制老交易所杀熟投机，老交易所必须按照当前价增加容量

币币交易对常见�创建者

• 1）代币的发行人或者大户
  交易才能产生价值，才能形成价格，因而代币的发行人是最有动力去做这个事情的。也只有他们最有动力愿意�冒着损失一部分抵押币的风险来创建。
• 2）交易所老手
  交易对价格稳定后，就会有成熟的交易所老手开建相同的交易对以更好的服务赚取手续费。

代币(Token通证)的真正价值

    交易形成价格，投机交易也�可能导致不合理价格，但是核心的还是代币的�真正价值。具体到Eos-DexChain，场内币的价值由该代币所能绑定的实际价值决定。比如小超市的购物券币，就由该购物券所能使用的超市数量，用户量决定。抵押币通过代码1:1绑定后，抵押币的价值就完全和抵押的币的�价值一致。比如XEOS�(Eos-DexChain抵押币)就和EOS的价值一样。

Eos-DexChain交易的各种安全保障

• 抵押币的安全。
  抵押币发行时会有对应量的场外币�进入Eos-DexChain合约的抵押账号，因而抵押币是肯定可以提现的。比如1XEOS是肯定可以兑换成1EOS的。由于用作抵押的币的资金操作必须要赋值智能合约eosio.code权限，从而导致用户的场外币长时间可被智能合约操作。EOS-DexChain的抵押币设计了Stake,Unstake操作，只有执行这两个action时才需要eosio.code权限，其他抵押币交易阶段不需要eosio.code权限，大大降低了eosio.code权限的暴露时间。同时对于支持require_receipt的token,可以通过监听transfer事件直接stake而不需要eosio.code权限。
• 交易所的安全
  交易所管理账号的资金都是受合约监管的。EOS-DexChain新建了approve机制，交易所账号的所有资金都approve给了合约，这些资金只有智能合约能够管理。只有在交易所关闭时，才能提取这些资金，且关闭交易所会有延时，从而有足够时间让交易所的用户做出合理的响应，比如及时买卖。
• 合约的安全
  DexChain合约推荐使用该文【固化EOS智能合约，监管升级权限，净化EOS DAPP生态】的建议，经过测试周期后，固化移交升级权限，实现合约自身的安全

Eos-DexChain API

create(创建场内币)

介绍

void create( account_name issuer, asset  maximum_supply)

• issuer
  场内币发行人，任何账号都可调用该接口创建场内币
• maximum_supply
  最大发行量

示例

cleos push action dexchaincode create '["useruseridx1", "100000000.0000 XTEST"]' -p useruseridx1

上图就创建了一个XTEST场内币，然后你就可以直接使用这个币宣传运营了 useruseridx1

createbystake(创建抵押币)

介绍

void createbystake(asset           maximum_supply,
                    asset           stake,
                    account_name    stake_contract);

和场内币创建不一样，抵押币没有发行账号�issuer，抵押一个就发行一个.且只能是抵押的场外币的合约拥有者才可调用

• stake
  抵押的场外币的资金量
• stake_contract
  抵押的场外币的智能合约账号
• maximum_supply
  最大发行量

示例

cleos push action dexchaincode createbystake '["1000000.0000 XEETH", "0.0000 EETH", "eosfavorcomm", "create new token XEETH by stake EETH"]' -p eosfavorcomm

上图就创建了一个XEETH抵押币，然后任何EETH的持有人都可以通过stake将EETH转化为XEETH抵押币并进行交易

stake(抵押获得抵押币)

介绍

void stake(account_name player, account_name receiver,
            symbol_type token_symbol, asset stake,
            account_name stake_contract,
            string memo )

• player
  抵押的场外币的消耗账号
• receiver
  抵押币的�接收��账号
• token_symbol
  要获取的抵押币的符号信息
• stake
  抵押的场外币的资金量
• stake_contract
  抵押的场外币的智能合约账号

示例

cleos push action dexchaincode stake '["useruseridx2", "useruseridx3", "4,XEETH", "8000.1000 EETH", "eosfavorcomm", "stake EETH to get XEETH"]' -p useruseridx2

useruseridx3会接收到8000.1000 XEETH

unstake(取消抵押赎回已抵押的场外币)

介绍

void unstake(account_name player, account_name receiver,
            asset quantity, symbol_type stake_symbol,
            account_name stake_contract,
            string memo )

• player
  抵押的场外币的消耗账号
• receiver
  抵押币的�接收��账号
• quantity
  抵押币的数量
• stake_symbol
  要获取的场外币的符号信息
• stake_contract
  抵押的场外币的智能合约账号

示例

cleos push action dexchaincode unstake '["useruseridx3", "useruseridx2", "1.1000 XEETH", "4,EETH", "eosfavorcomm", "unstake XEETH to get EETH"]' -p useruseridx3

useruseridx2会接收到8000.1000 EETH

createdex(创建交易对交易所)

介绍

void createdex(account_name creator, account_name dex_account,
    asset base, asset quote, uint32_t fee_amount);

• creator
  交易对的创建者，也是抵押币的消耗者
• dex_account
  交易所管理账号
• base
  bancor交易所的base币
• quote
  bancor交易所的quote币
• fee_amount
  交易费，= 1/fee_amount, �比如200就是0.5%的手续费

示例

cleos push action dexchaincode createdex '["useruseridx3", "onefamousdex", "1000.0000 XTEST", "10.0000 XEOS", 200]' -p useruseridx3

创建一个交易所对，管理账号时onefamousdex, 交易对是XTEST/XEOS, XTEST的初始价格是10/1000=0.01 XEOS

buytoken(买base币)

介绍

void buytoken(account_name owner, account_name receiver, account_name       dex_account, asset quat);

• owner
  交易者
• receiver
  币的接收账号
• dex_account
  交易对管理账号
• quat
  用来购买base币的quote币量

示例

cleos push action dexchaincode buytoken '["useruseridx3", "useruseridx5", "onefamousdex", "0.1000 XEOS"]' -p useruseridx3

useruseridx5将获得XTEST币

selltoken(卖base币)

介绍

void selltoken(account_name owner, account_name receiver, account_name dex_account, asset quant);

• owner
  交易者
• receiver
  币的接收账号
• dex_account
  交易对管理账号
• quat
  卖掉的base币的量

示例

cleos push action dexchaincode selltoken '["useruseridx3", "useruseridx5", "onefamousdex", "0.1000 XTEST"]' -p useruseridx3

useruseridx5将获得XEOS币

closedex(关闭交易所)

介绍

void closedex(account_name dex_account)

• dex_account
  交易对管理账号

示例

cleos push action dexchaincode closedex '["onefamousdex"]' -p onefamousdex

onefamousdex账号对应的交易对�关闭

获取交易所信息

> cleos get table dexchaincode dexchaincode dexmarkets
{
  "rows": [{
      "supply": "100000000000000 DEXCORE",
      "base": {
        "balance": "980.5879 XTEST",
        "weight": "0.50000000000000000"
      },
      "quote": {
        "balance": "10.1980 XEOS",
        "weight": "0.50000000000000000"
      },
      "dex_account": "onefamousdex",
      "fee_rate": 200
    }
  ],
  "more": false
}

获取代币信息

> cleos get table dexchaincode XEOS stat
{
  "rows": [{
      "supply": "0.0000 XEOS",
      "max_supply": "10000000000.0000 XEOS",
      "issuer": "dexchaincode",
      "stake_symbol": "4,EOS",
      "stake_contract": "eosio.token"
    }
  ],
  "more": false
}

获取代币持有

> cleos get currency balance dexchaincode useruseridx3
7989.0000 XEOS
4000.1000 XTEST

汇总

    上面的EOS可以是任意其他已经发行的场外币，XTEST可以是Eos-DexChain合约里的任意币(场内币和抵押币)

编译部署

cd dexchain
eosiocpp -o dexchain.wast exchange_state.cpp dexchain.cpp
cleos set contract your_account ./dexchain/ -p your_account

License

    该项目是一个区块链4.0通证经济去中心化链的试验性探索链，遵循MIT License, 任何企业或个体可在MIT规范下使用本项目的源码。
    由于该项目是一个试验性探索项目，目前该项目已经上线jungle测试网络，智能合约账号dexchaincode, 方便大家�测试实践。

Contact

    项目网站:https://github.com/DexChain
    币乎:https://bihu.com/people/224762
    电报:https://t.me/dexchain
    公众号:区块链斜杠青年
    欢迎交流技术及合作，有任何问题请加我微信:itleaks