Hyperion History API解决方案

History API可以说是EOS主网上几个月来最紧迫的问题。DApps，块浏览器和钱包必须查阅历史信息才能正常工作，而在EOS主网上运行完整的历史记录变得昂贵，复杂且耗时。

V1 History API已被弃用，少数BP坚持不断为整个网络提供完整的公共历史节点，（特别感谢Sw / eden，CryptoLions，EOS Tribe，Greymass，EOS Canada，EOS Asia和Oracle Chain！），而其他许多人也都为解决这个问题付出了巨大努力。

有些人认为这不是一个大问题，认为DApp可以找到一种商业模式来专门支付于他们交易的部分历史节点，而块浏览器和钱包可以使用光历史。然而，EOS社区普遍认为，提供历史链数据可能会妨碍EOS满足可扩展性预期的能力，而这种预测常常会自己实现。

在撰写本文时（2019年3月7日），EOS Blockchain包含大约4600万个块，因此对于新手开始提供服务，节点必须摄取所有这些块以及每秒附加到块链中的另外两个块。目前来看，是一个需要数周的过程。同步后，当前的v1 History Plugin需要超过5 Tb的存储空间才能运行。查询此数据库需要大量处理能力和网络带宽。因此，运行完整的历史记录可能会花费超过15,000美元/月。
一个新视角

几个月前，EOS Rio团队开始就此问题的可能性解决方案进行头脑风暴。我们决定从头开始，而不是专注于感知瓶颈以增加数据摄取，存储和查询功能。第一步是分析可以采取哪些措施来优化数据库大小本身。我们了解到History API v1存储了大量冗余信息。

原始的history_plugin与eosio捆绑在一起，提供了v1 API，存储了嵌套在根操作中的内联动作跟踪。每当用户请求给定帐户的操作历史时，将导致存储和传输过量数据。此外，内联操作通常用作“事件”机制，以通知交易方，并且存储它几乎没有价值。

Hyperion History实现了一种新的数据结构和存储方法：

• 动作以展平格式存储。
• 将父字段添加到内联操作以指向父全局序列。
• 如果内联操作数据与父操作数据相同，则将其视为通知，从而从数据库中删除。
• 没有存储块或事务数据，可以从动作重建所有信息。
• 没有存储交易验证信息，因为可以使用Chain API在块信息上验证所有信息，DApp不使用历史记录。
• 通过这些更改，API格式专注于缩短响应时间，降低带宽开销，并使UI / UX开发人员更易于使用。

数据结构存储如下：

小但强大
更改格式和减少数据冗余可将数据库大小减少约85％，从近5 Tb减少到约650 Gb。为了进一步提高性能，我们设计了一个多线程索引器，它从状态历史插件中提取数据，并且可以在大约72小时内通过适当的硬件优化来摄取完整的EOS区块链，而当前的解决方案可能需要数周时间。

我们还引入了“ABI历史缓存层”组件，以防止在ABI修改上并行处理历史数据时出现反序列化失败。
对于数据库，我们部署了一个Elasticsearch集群，该集群在位于巴西里约热内卢的一级基础架构上并置的两个定制组装裸机服务器上运行。
优化的数据结构倾向于减少CPU和带宽消耗，使基础架构更具可扩展性。运行完. 整历史API的其他BP已经在测试Hyperion并帮助其发展。

我们非常感谢来自EOS Cafe的Syed Jafri为Hyperion HTTP API创建了一个javascript库，并且已经在 bloks.i上集成了Hyperion History（v2 API）。还有Sw / eden团队在cleos上添加v2兼容性。非常感谢eosDAC，CryptoLions和BlockMatrix的贡献。

新history API标准的建议

• 对于开发人员来说，提供扁平的结果优于今天的history API标准。当前的eosio历史插件不必要地使用冗余信息来扩充数据库（用于最终用户历史记录）。过滤内联操作的可能性允许减少API带宽消耗和编码复杂性。
• 为适应这些变化，EOS Rio和其他开发历史解决方案的BP们正在倡导history API V2标准，也终将被EOS 社区采用。
• 请您用一点儿宝贵时间对其进行评估并向我们发送反馈信息。

一个开源项目

EOS Rio已经在 https://eos.hyperion.eosrio.io/v2/docs/index.html上使用Hyperion提供History API。
项目代码和初步设置说明可在 https://github.com/eosrio/Hyperion-History-API获，我们将根据开源许可证发布此用于非商业用途。

我们可以帮助任何想要运行Hyperion History的人，我们期待您的反馈信息。
下一步
下一步是为操作流实现WebSocket API。这就是我们现在正在做的事情。
完成后，下一个功能将实现Hyperion Analytics，这是Hyperion History API上的一个高级层，可提供详细的EOS统计信息。
相关链接
文档链接：https://eos.hyperion.eosrio.io/v2/docs/index.html
源代码链接：https://github.com/eosrio/Hyperion-History-API
Javascript库链接：https://github.com/eoscafe/hyperion-api

转载自：https://medium.com/@eosriobrazil/presenting-hyperion-history-api-solution-f8a8fda5865b
参考： https://www.boswps.io/#/poll_detail?proposal=hyperion.api

问题描述

本想在transfer“回调”函数里处理相关业务前做多签检查，

require_auth2(合约账户, 多签权限);

由于transfer权限问题，并没有将代币发行合约对应的transfer执行权限设置{set action permission}给合约的多签权限，但由于对于每笔交易，我们都需要至少有一名签名者为网络和cpu收费，但此自定义权限并没有相应的权限，所以报此错误。

解决方法

将合约多签权限linkauth给单独账户，并在此处检查此多签账户的active权限。

require_auth2(多签账户, active权限);

参考

https://github.com/EOSIO/eos/issues/4617

安装go环境

下载并安装go

https://golang.org/dl/

wget https://dl.google.com/go/go1.12.7.linux-amd64.tar.gz // 下载
tar -C $HOME -xzf go$VERSION.$OS-$ARCH.tar.gz // 解压到home/go

配置环境变量

mkdir -p $HOME/go/bin
echo "export GOPATH=$HOME/go" >> ~/.bash_profile
echo "export GOBIN=$GOPATH/bin" >> ~/.bash_profile
echo "export PATH=$PATH:$GOBIN" >> ~/.bash_profile
source ~/.bash_profile

安装cosmos

先解决墙内问题

一键解决 go get golang.org/x 包失败

https://shockerli.net/post/go-get-golang-org-x-solution/

export GO111MODULE=on
export GOPROXY=https://goproxy.io
// Go version >= 1.11

下载代码并编译

mkdir -p $GOPATH/src/github.com/cosmos
cd $GOPATH/src/github.com/cosmos
git clone https://github.com/cosmos/cosmos-sdk
cd cosmos-sdk && git checkout v0.35.0
make tools install

那将安装gaiad和gaiacli二进制文件。验证一切正常：

gaiad version --long
gaiacli version --long

安装jq

sudo apt-get install jq

开始配置

设置新节点

gaiad init <your_custom_moniker> // 注意Monikers只能包含ASCII字符。使用Unicode字符将使您的节点无法访问。

您可以moniker稍后在~/.gaiad/config/config.toml文件中进行编辑：

# A custom human readable name for this node
moniker = "<your_custom_moniker>"

您可以编辑该~/.gaiad/config/gaiad.toml文件以启用反垃圾邮件机制并拒绝低于最低汽油价格的传入交易：

# This is a TOML config file.
# For more information, see https://github.com/toml-lang/toml

##### main base config options #####

# The minimum gas prices a validator is willing to accept for processing a
# transaction. A transaction's fees must meet the minimum of any denomination
# specified in this config (e.g. 10uatom).

minimum-gas-prices = ""

您的完整节点已初始化！

创建Genesis文件并启动网络

# You can run all of these commands from your home directory
cd $HOME

# Initialize the genesis.json file that will help you to bootstrap the network
gaiad init --chain-id=testing testing

# Create a key to hold your validator account
gaiacli keys add validator

# Add that key into the genesis.app_state.accounts array in the genesis file
# NOTE: this command lets you set the number of coins. Make sure this account has some coins
# with the genesis.app_state.staking.params.bond_denom denom, the default is staking
gaiad add-genesis-account $(gaiacli keys show validator -a) 1000000000stake,1000000000validatortoken

# Generate the transaction that creates your validator
gaiad gentx --name validator

# Add the generated bonding transaction to the genesis file
gaiad collect-gentxs

# Now its safe to start `gaiad`
gaiad start

此设置将所有数据gaiad放入~/.gaiad。您可以检查您创建的创世纪文件~/.gaiad/config/genesis.json。使用此配置gaiacli也可以使用并且具有令牌帐户（包括放样和自定义）。

参考

https://www.jianshu.com/p/38736bdc08d8
https://cosmos.network/docs/cosmos-hub/installation.html#install-gaia
https://github.com/cosmos/cosmos-sdk/issues/4634

需求

根据交易id（transaction_id）获取交易预计到达不可逆的时间。

方案

当push_transaction 无异常后，会得到 trx_id，以及status状态为executed （状态讲解），以及必须校验此状态，防止（hard_fail 状态攻击）。

"receipt": {
      "status": "executed",
      "cpu_usage_us": 1260,
      "net_usage_words": 18
    },

先通过get_info 获取返回参数中的last_irreversible_block，
再请求接口 POST /v1/history/get_transaction 查询当前的transaction_id（如果此时未能查到，则表示交易被丢弃，交易失败），获取返回参数中 block_num。
用block_num 减去last_irreversible_block获得差值，并用差值乘以0.5s(单出块时间)，即可预计（忽略get_info和get_transaction的请求时间差）计算出当前交易预计达到不可逆的时间。

备注

最好在交易发起6s+后获取计算的差值，因为超过6s（BP交替出块）后交易被回滚的几率会很小，当然如果长时间停留在等待页面，期间最好在再做定时时间刷新计算，避免交易已回滚，不必要的等待。

https://github.com/EOSIO/eosjs/blob/849c03992e6ce3cb4b6a11bf18ab17b62136e5c9/src/tests/web.html#L144

     const transactWithoutBroadcast = async () => await api.transact({
            actions: [{
                    account: 'eosio.token',
                    name: 'transfer',
                    authorization: [{
                        actor: 'bob',
                        permission: 'active',
                    }],
                    data: {
                        from: 'bob',
                        to: 'alice',
                        quantity: '0.0001 SYS',
                        memo: '',
                    },
                }]
            }, {
                broadcast: false,
                blocksBehind: 3,
                expireSeconds: 30,
            });


            const testTransactWithoutBroadcast = async (e) => {
                resultsLabel = e.target;
                resultsLabel.innerText = EXECUTING;

                try {
                    transactionSignatures = await transactWithoutBroadcast();
                } catch (error) {
                    resultsLabel.className = 'failed';
                    resultsLabel.innerText = FAILED;
                    console.error('Transact without Broadcast Test Failure: ', error.message);
                    return false;
                }

                if(transactionSignatures.signatures && transactionSignatures.serializedTransaction) {
                    resultsLabel.className = "success";
                    resultsLabel.innerText = SUCCESS;
                    return true;
                }
                resultsLabel.className = 'failed';
                resultsLabel.innerText = FAILED;
                return false;
            };