开发指南

uniswap

uniswap 交易

在 uniswap 的所有接口中，tokenx 与 tokeny 的顺序并不影响执行结果。例如，FO@eosio - EOS@eosio和EOS@eosio - FO@eosio属于同一个市场。

加仓

整个兑换过程是在 FIBOS 主网执行，所以执行过程中使用的是 FIBOS 主网的私钥以及账户信息。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
var FIBOS = require('fibos.js');
var config = {
    chainId: '68cee14f598d88d340b50940b6ddfba28c444b46cd5f33201ace82c78896793a',
    priKey: '你的 FIBOS 主网私钥',
    httpEndpoint: 'http://api.testnet.fo',
    verbose: false,
}
var fibos_client = FIBOS({
    chainId: config.chainId,
    keyProvider: config.priKey,
    httpEndpoint: config.httpEndpoint,
    verbose: false,
    logger: {
        log: null,
        error: null
    }
})

调用方法:

1
2
let ctx = fibos_client.contractSync('eosio.token');
let result = ctx.addreservesSync(owner, tokenx, tokeny);

方法说明:

使用 addreservesSync() 方法，可以为 uniswap 市场进行加仓，特殊的，如果没有该市场，则会创建该市场。

参数说明:

参数 含义
owner 操作账户
tokenx x 通证
tokeny y 通证

限制：

以下所有的限制均不包含常规限制，例如权限不对，精度不对等。本文提到的限制都是特定的限制。

该行为会对 X-Y 的 uniswap 通证市场进行加仓，如果该市场不存在，则会创建该市场。

1
2
3
4
5
6
7
8
9
//初始化 FIBOS 客户端
...
let ctx = fibos_client.contractSync('eosio.token');
let result = ctx.addreservesSync(
    "fibos", 
    "20.0000 FO@eosio", 
    "10.0000 EOS@eosio", {
    authorization: "fibos"
});

在上面的例子中，我们为FO@eosio-EOS@eosio的 uniswap 市场进行加仓，数额分别是20.0000 FO@eosio和10.0000 EOS@eosio。同样的，如果没有该市场，则会创建FO@eosio-EOS@eosio的 uniswap 市场。

市场份额表查询：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
fibos.getTableRowsSync(true, "eosio.token", "eosio.token", "swapmarket")
// output:
{
  "rows": [
    {
      "primary": 0,
      "tokenx": {
        "quantity": "140.0000 FO",
        "contract": "eosio"
      },
      "tokeny": {
        "quantity": "10030.0000 EOS",
        "contract": "eosio"
      },
      "total_weights": "11849.89451429842847574"
    }
  ],
  "more": false
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
fibos.getTableRowsSync(true, "eosio.token", 0, "swappool") // 此处的"0"对应的对应币币对的 primary
// output:
{
  "rows": [
    {
      "owner": "fibos",
      "weights": "11356.56329871202615323"
    },
    {
      "owner": "user1",
      "weights": "493.33121558640181092"
    }
  ],
  "more": false
}

上例的情况是，EOS@eosio-FO@eosio的uniswap的市场中，EOS@eosio的总额为10030.0000 EOS，FO@eosio的总额为140.0000 FO，所有持仓者总权重为11849.89451429842847574。

在该市场中，有两个持仓者，分别为fibos和user1。他们在总市场中的权重分别为11356.56329871202615323和493.33121558640181092。

提仓

调用方法:

1
2
let ctx = fibos_client.contractSync('eosio.token');
let result = ctx.outreservesSync(owner, symbolx, symboly, rate);

方法说明:

使用 outreservesSync() 方法，可以在特定的 uniswap 市场中进行提仓，提出我们在该 uniswap 市场中的份额。

参数说明:

参数 含义
owner 操作账户
symbolx x 通证
symboly y 通证
rate 提取比例

限制：

该行为会对 X-Y 的 uniswap 通证市场进行提仓，通过rate比例提出我们自己的通证份额。

1
2
3
4
5
6
7
8
9
10
//初始化 FIBOS 客户端
...
let ctx = fibos_client.contractSync('eosio.token');
let result = ctx.outreservesSync(
    name, 
    "0.0000 FO@eosio", 
    "0.0000 EOS@eosio", 
    0.1, { 
    authorization: name
});

在上面的例子中，我们在FO@eosio-EOS@eosio的 uniswap 市场进行提仓，比例为0.1。操作过后，我们会按个人权重/总权重 * rate的比例等比得提取该市场中FO@eosio通证数量和EOS@eosio通证数量。

公式说明：

在 uniswap市场中，用户所拥有的token份额以权重的形式展示。在减仓的时候不能设置提取某一个数额的token出来，只能设置提取的比例，按照对应的比例获得对应的币币对。详细公式见下：

a×b=S填仓:anew×bnew=Snew计算权重：Snew−SS×weights减仓比例：r=weigehts个人weights全部×rate传入值减仓提取：(anew×r)(bnew×r)

市价交易\限价交易

uniswap 的市价交易、限价交易和 Bancor 共用exchange接口。
| 参数 | 含义 |
| ——– | —————- |
| owner | 操作账户 |
| quantity | 兑换通证数量 |
| to | 兑换通证目标数量 |
| price | 价格(仅在 uniswap 限价交易中填值) |
| id | 渠道商 id (仅在 uniswap 交易中使用) |
| memo | 兑换备注信息 |

限制

市价交易：

1
2
3
4
5
6
7
8
9
10
11
12
//初始化 FIBOS 客户端
...
let ctx = fibos_client.contractSync('eosio.token');
ctx.exchangeSync(
    "fibos", 
    "200.0000 EOS@eosio", 
    "0.0000 FO@eosio", 
    0,
    'fibos',
    "test", {
    authorization: "fibos"
});

上面的例子中，用户fibos想用200.0000 EOS@eosio兑换FO@eosio，不论价格是多少，兑换完200.0000 EOS@eosio为止。

限价交易：

1
2
3
4
5
6
7
8
9
10
11
12
//初始化 FIBOS 客户端
...
let ctx = fibos_client.contractSync('eosio.token');
ctx.exchangeSync(
    "fibos", 
    "0.0000 EOS@eosio", 
    "100.0000 FO@eosio", 
    1.2, 
    "fibos", 
    "uniswap ", {
   authorization: "fibos"
});

上面的例子中，用户fibos需要以不高于1.2的价格兑换出100.0000 FO@eosio。对于高于1.2的价格，仍未兑换完的部分，则会挂单。

挂单表查询示例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
fibos.getTableRowsSync(true, "eosio.token", 0, "swaporder")

// output:
{
  "rows": [
    {
      "primary": 0,
      "owner": "fibos",
      "price": "4294967296", 
      "quantity": {
        "quantity": "100.0000 EOS",
        "contract": "eosio"
      }
    }
  ],
  "more": false
}

撤单

调用方法:

1
2
let ctx = fibos_client.contractSync('eosio.token');
let result = ctx.withdrawSync(name, symbolx, symboly, bid_id);

方法说明:

使用 withdrawSync() 方法，可以在 uniswap 市场撤销自己的挂单。

参数说明:

参数 含义
owner 撤单账号
symbolx x 通证
symboly y 通证
bid_id 撤单id 
1
2
3
4
5
6
7
8
9
10
//初始化 FIBOS 客户端
...
let ctx = fibos_client.contractSync('eosio.token');
let result = ctx.withdrawSync(
    "fibos",
    "0.0000 FO@eosio", 
    "0.0000 EOS@eosio", 
    bid_id, {
	authorization: "fibos"
});

撤单会撤销用户的此 ID 的挂单，挂单金额打回账户