测试例子

https://github.com/dfuse-io/docs/tree/master/quickstarts

@ dfuse/client使用例子

global.fetch = require('node-fetch');
global.WebSocket = require('ws');

// CODE:BEGIN:quickstarts_javascript_node_eos_section1
const { createDfuseClient } = require('@dfuse/client');

const client = createDfuseClient({
  network: '39.106.103.152:8080',
  authentication: false,
  secure: false,
});
// CODE:END:quickstarts_javascript_node_eos_section1
// CODE:BEGIN:quickstarts_javascript_node_eos_section2
// You must use a `$cursor` variable so stream starts back at last marked cursor on reconnect!
const operation = `subscription($cursor: String!) {
  searchTransactionsForward(query:"receiver:eosio.token action:transfer -data.quantity:'0.0001 EOS'", cursor: $cursor) {
    undo cursor
    trace { id matchingActions { json } }
  }
}`;
// CODE:END:quickstarts_javascript_node_eos_section2
// CODE:BEGIN:quickstarts_javascript_node_eos_section3
async function main() {
  const stream = await client.graphql(operation, message => {
    if (message.type === 'data') {
      const {
        undo,
        cursor,
        trace: { id, matchingActions }
      } = message.data.searchTransactionsForward;
      matchingActions.forEach(({ json: { from, to, quantity } }) => {
        console.log(
          `Transfer ${from} -> ${to} [${quantity}]${undo ? ' REVERTED' : ''}`
        );
      });

      // Mark stream at cursor location, on re-connect, we will start back at cursor
      stream.mark({ cursor });
    }

    if (message.type === 'error') {
      console.log('An error occurred', message.errors, message.terminal);
    }

    if (message.type === 'complete') {
      console.log('Completed');
    }
  });

  // Waits until the stream completes, or forever
  await stream.join();
  await client.release();
}
// CODE:END:quickstarts_javascript_node_eos_section3
// CODE:BEGIN:quickstarts_javascript_node_eos_section4
main().catch(error => console.log('Unexpected error', error));
// CODE:END:quickstarts_javascript_node_eos_section4

接口文档

https://docs.dfuse.io/eosio/public-apis/reference/graphql-api/

常用接口整理

稍后补充

GraphQL 与 REST 相比的优势和短板

https://zhuanlan.zhihu.com/p/95521039

如何在我自己构建和运行的@dfuse/client中配置apiKey
由于dfuse官方权限这块并没有开源，可以先把权限相关关闭
可以只用测试例子演示

const client = createDfuseClient({
  network: '39.106.103.152:8080',
  authentication: false,
  secure: false,
});

参考

https://github.com/dfuse-io/dfuse-eosio/issues/206

https://github.com/dfuse-io/client-js/blob/e86735957d348ced88f141720979dec8516db5ef/examples/basic/dfuse-for-eosio.ts#L13

由于部署的服务器一般为server版，没有UI界面，所以目前dfuse-eosio默认的本地访问地址很不方便，为了外部访问，编译前，需要修改下配置，

要修改的配置在https://github.com/dfuse-io/dlauncher 项目中，当编译dfuse-eosio时，./scripts/build.sh会自动在当前目录的上层目录下，获取dlauncher源码。

当dlauncher代码获取完，再将dlauncher\dashboard\client\src\.env中的 http://localhost:8080修改成对应的地址

REACT_APP_DASHBOARD_GRPC_WEB_URL=http://localhost:8080/api

比如修改成

REACT_APP_DASHBOARD_GRPC_WEB_URL=http://39.106.103.152:8080/api

然后重新编译即可。

当然我们只是为了测试演示，生产环境中，并不会直接暴露在外网，因为此后台并没有权限验证，一般是外层再加层防护，比如VPN

测试环境

目前在http://39.106.103.152:8080 搭建了一个测试服务，我们基于测试服务做接口测试

REST API

1. 查询交易

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-search-transactions/

测试查询

http://39.106.103.152:8080/v0/search/transactions?start_block=0&block_count=100000&limit=10&sort=desc&q=receiver:eosio.token+action:transfer+data.to:xihzz2blorkc

这个查询交易相当的灵活，不但能根据区块区间，还能根据查询action相应参数做查询

2. 根据时间查询区块

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-block_id-by_time/

测试查询

http://39.106.103.152:8080/v0/block_id/by_time?time=2021-01-27T10:36:14.5Z&comparator=gte

comparator参数

• gt 大于
• gte 大于等于
• lt 小于
• lte 小于等于
• eq 相等

3. 任意块高度获取给定合同帐户的ABI

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-state-abi/

测试查询

http://39.106.103.152:8080/v0/state/abi?account=eosio&block_num=10000&json=true

4. 任意块高度获取由给定公钥控制的帐户

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-state-key_accounts/

测试查询

http://39.106.103.152:8080/v0/state/key_accounts?public_key=EOS8G6gjXRpMHdaQhZr2DU1myKKf7RgsT5MXaggBYxtqfaTnNgazf

5. 在任何块高度上，获取区块链上任何帐户的链接授权的快照

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-state-permission_links/

测试查询

我们先在测试网上设置好测试数据

cleos -u http://47.94.225.179:2222 set account permission xihzz2blorkc claimer '{"threshold":1, "keys":[], "accounts":[{"permission":{"actor":"bcskillsurou","permission":"active"},"weight":1}],"waits":[]}' active -p xihzz2blorkc
cleos -u http://47.94.225.179:2222 set action permission xihzz2blorkc eosio claimrewards claimer

测试查询

http://39.106.103.152:8080/v0/state/permission_links?account=xihzz2blorkc&block_num=327722

6. 在任何块高度获取任何表的状态

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-state-table/

测试查询

http://39.106.103.152:8080/v0/state/table?account=eosio.token&scope=xihzz2blorkc&table=accounts&block_num=327722&json=true

7. 从任何表的状态以任何块高度获取单行

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-state-table-row/

测试查询

http://39.106.103.152:8080/v0/state/table/row?account=eosio.token&scope=xihzz2blorkc&table=accounts&primary_key=RES&key_type=symbol_code&block_num=327722&json=true

8. 以任意块高度获取合同帐户上给定表的合并范围列表

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-state-table_scopes/

测试用例

http://39.106.103.152:8080/v0/state/table_scopes?account=eosio.token&table=accounts

9. 从任何块高度的合同帐户组中获取一张表

比较常见的用途就是，从多个代币合约中查询某个账户各个代币余额

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-state-tables-accounts/

测试查询

测试前先再发一个代币

cleos -u http://47.94.225.179:2222 set contract xihzz2blorkc contracts/eosio.token 
cleos -u http://47.94.225.179:2222 push action xihzz2blorkc create '{"issuer":"xihzz2blorkc", "maximum_supply": "10000000000.00000000 BCS"}' -p xihzz2blorkc 
cleos -u http://47.94.225.179:2222 push action xihzz2blorkc issue '{"to":"xihzz2blorkc","quantity":"1000000000.00000000 BCS","memo":"issue"}' -p xihzz2blorkc 
cleos -u http://47.94.225.179:2222 transfer xihzz2blorkc bcskillsurou "0.00000001 BCS" "transfer" -p xihzz2blorkc -c xihzz2blorkc

测试查询
查询bcskillsurou在eosio.token和xihzz2blorkc两个代币合约中的代币余额

http://39.106.103.152:8080/v0/state/tables/accounts?accounts=eosio.token|xihzz2blorkc&scope=bcskillsurou&table=accounts&block_num=336806&json=true

10. 在任意块高度处，为一组范围的给定协定获取表中的所有行

比较常见的用途就是，从单个代币合约中查询多个账户余额

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-state-tables-scopes/

测试查询

http://39.106.103.152:8080/v0/state/tables/scopes?account=eosio.token&scopes=xihzz2blorkc|bcskillsurou&table=accounts&block_num=327722&json=true

11. 获取与提供的参数关联的事务生命周期:id

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/get-transactions/

测试查询

http://39.106.103.152:8080/v0/transactions/53e4f9b831b347a33c43807777552029fc73d176905d757d93be97acb7b2e24e

12. 在任何块高度，根据给定合约帐户的ABI解码给定表的二进制行（以十六进制字符串）

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/post-state-abi-bin_to_json/

测试查询

curl -X POST -d '{"account":"eosio.token","table":"accounts","block_num":327722,"hex_rows":["aa2c0b010000000004454f5300000000"]}' "http://39.106.103.152:8080/v0/state/abi/bin_to_json"

13. 用于将事务提交到网络的直接替换，但是可以选择阻止请求，直到事务处于一个块或不可逆的块中

官方文档

https://docs.dfuse.io/eosio/public-apis/reference/rest/post-chain-push_transaction/
https://docs.dfuse.io/eosio/public-apis/tutorials/writing-on-chain/

测试查询

cleos --header "X-Eos-Push-Guarantee: in-block" push transaction mytx.json
cleos --header "X-Eos-Push-Guarantee: handoffs:2" push transaction mytx.json

将交易推送到区块链，并可能要求其他担保：

• 使用HTTP Header：时X-Eos-Push-Guarantee: in-block，调用将一直阻塞，直到事务将其变为有效块为止
• 使用HTTP标头：时X-Eos-Push-Guarantee: handoff:1，调用一直处于阻塞状态，直到事务将其变成一个块之后，该块仍在块生产移交给另一个BP 1、2或3次（使用handoffs:2和handoffs:3）之后仍处于最长链中
• 使用HTTP Header：时X-Eos-Push-Guarantee: irreversible，调用将一直阻塞，直到插入事务的块不可逆为止。

请求和响应的内容与常规“ push_transaction”端点相同，除了：

• 响应将包含这些额外的字段：block_id并 block_num通知您包含该事务的实际块。
• 返回的跟踪（在之下processed）来自块的实际执行，而不是边缘节点的推测性跟踪（通常如此）

错误码

所述dfuse API使用下面的HTTP错误代码

错误格式

REST API和WebSocket API的每个错误消息结构在我们所有的API调用中都已完全标准化。

{
    "code": "a_unique_error_code_for_this_specific_error",
    "trace_id": "unique_id_identifying_your_request",
    "message": "A descriptive error message about the problem.",
    "details": {
        "key": "contextual key/values pairs specific to each error"
    }
}

官方文档：https://docs.dfuse.io/eosio/public-apis/reference/rest/errors/

隐私问题是目前区块链技术所要解决的其中一重要问题，隐私保护不仅在区块链领域成为了重点研究内容之一，而且近几年不断出现的数据隐私泄露问题，也让公众对隐私保护有日益深入的认知。

PlatON基于安全多方计算密码学算法实现一种隐私合约的解决方案，主要思想是将隐私计算算法通过合约进行发布，并由隐私保护需求的数据提供方和计算节点配合执行MPC协议，以实现数据的协同计算。

安全多方计算介绍

安全多方计算，英文全称为Secure Multi-Party Computation，简称MPC。它指的是用户在无需进行数据归集的情况下，完成数据协同计算，同时保护数据所有方的原始数据隐私。具体来说，有n个计算参与方，分别持有私有数据 共同计算既定函数

计算完成，得到正确计算结果y，且参与各方除了自己的输入数据和输出结果外，无法获知任何额外有效信息。
MPC协议满足的基本性质是：

• 输入隐私性： 协议执行过程中的中间数据不会泄露双方原始数据的相关信息；
• 健壮性： 协议执行过程中，参与方不会输出不正确的结果。

构建通用MPC协议的典型范式之一是基于姚期智提出的针对两方计算的加密电路方法，并由Beaver、Micali 和Rogaway 进一步扩展到多方计算。目前MPC相关的协议或算法有Garbled Circuit、Oblivious Transfer、Secret Sharing、BGW、GMW、BMR等，同时工程实现上也有如SPDZ、LEGO、Sharemind、Fairplay等不同的安全多方计算框架出来。典型的安全两方计算所使用的协议为加密电路（Garbled Circuit, GC）和不经意传输（Oblivious Transfer, OT）。

Garbled Circuit

关于Garbled Circuit原理，可进一步参考此页面所做的解释。

目前已经有很多对加密电路进行优化的方案。包括Free-XOR 技术，这意味着XOR 门几乎无需加密，row reduction 和half gate技术，将每个AND门所需要的密文从4个降为2个。最近使用认证加密电路的研究结果实现了针对两方和多方恶意敌手模型下非常有效的协议。

若有兴趣对Garbled Circuit的理论知识作更深入的了解，可参考此论文。

Oblivious Transfer

Oblivious Transfer，中文称为不经意传输，通常简写为OT，它指的是发送者从一个值集合中向接收者发送单个值的问题，这里发送者无法知道发送的是哪一个值，而且接收者也不能获知除了接收值之外的其它任何值。形式化描述为：发送者有由N个值组成的集合，接收者有索引协议执行完成，接收者只知道不知道，这里并且发送者不知道i，这称为1-out-of-N Oblivious Transfer。

对于N=2，即为1-out-of-2 Oblivious Transfer，接收者在计算加密电路之前，首先根据自己的输入数据获得与之对应的标签，由于标签是发送者定义的，因此接收者与发送者之间执行此OT协议。接收者按照其输入的每个比特，以σ=0/1为输入，发送者以标签m0、m1为输入。协议执行完成，接收者获得标签mσ。图7为1-out-of-2 OT的示意图。协议执行的过程中，满足以下性质：

• 发送者不可获知接收者选择的是哪个标签；
• 接收者无法知道另一个标签

两方安全计算的工作原理

两方计算的实现过程为：

两个计算参与方Alice和Bob，想共同计算
这里s为Alice所拥有的数据，t为Bob所拥有的数据，f为计算逻辑。首先，Alice将f转换为相应的布尔电路C，其中C的每个门都有一个真值表表示门的输入输出。然后，Alice对真值表进行加密处理，得到加密电路同时，Alice也对其输入进行加密，然后将加密后的输入与加密电路一同发送给Bob。那么此时Bob就拥有了和Alice的加密输入（对应于Alice输入的标签），但却未被告知Alice的加密过程，因此Bob就无法获知该如何使用自己的输入。这时，Bob通过与Alice之间执行1-out-of-2 Oblivious Transfer协议来获得加密输入（对应于自己输入的标签）。之后，Bob使用两方的加密输入对加密电路逐个门进行解密，获得电路计算结果。

总体分为如下五个步骤，其详细过程解释如下：

1. 布尔电路生成

假设是需要安全计算的函数，将此函数转换为布尔电路满足对任意理论上任意函数均可表示成布尔电路。布尔电路的格式如图1所示：

图2: 函数转换为布尔电路

2. 加密电路生成

Alice将函数转换为布尔电路后，将电路的每个门表示成如图2所示的真值表，接着通过加密这些真值表将转化为加密电路

图3: 将电路中的每个门表示成真值表
略

PlatON中的安全多方计算

安全多方计算为PlatON实现隐私数据的协同计算提供了根本性的技术手段，在PlatON中结合MPC实现隐私合约，为具有多方参与数据作为输入的应用提供隐私保护，实现真正的隐私计算。

PlatON的两方安全计算架构如下：

PlatON的隐私合约同样支持高级语言编程，但不是编译成庞大的布尔电路文件，而是编译成更高效的LLVM IR字节码，并部署到PlatON网络上，在MPC计算节点内置的MPC虚拟机中以JIT方式执行。隐私合约的输入数据保存在数据节点本地，由数据节点在链下以安全多方计算方式进行隐私计算，并提交计算结果到链上。

PlatON会持续优化当前已实现版本的MPC性能，并实现更先进的MPC协议，在以下几个方面进行改进：

• 结合同态加密（HE）来降低MPC的通信复杂度
• 从两方安全计算实现到三方以上的多方计算，以满足更加复杂多样化的应用场景

转载自 https://devdocs.platon.network/docs/zh-CN/Secure_Multi_Party_Computation/

开源代码：https://github.com/PlatONnetwork