如何计算EOS代码和ABI的哈希

如果你想知道在EOS上部署了什么版本的智能合约,你需要查看代码哈希。我们将看到如何计算代码和ABI哈希,并编写一个函数,通过比较它们的哈希来查看本地WASM文件是否与正在运行的协议相匹配。

EOS代码的哈希

当通过eosio setcode操作设置或更新合约时,检查合约代码是否已经在运行。因此,通过查看setcode实现,我们可以从WASM文件看到如何计算哈希值。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
void apply_eosio_setcode(apply_context& context) {
// some setup code

fc::sha256 code_id; /// default ID == 0

if( act.code.size() > 0 ) {
code_id = fc::sha256::hash( act.code.data(), (uint32_t)act.code.size() );
wasm_interface::validate(context.control, act.code);
}

const auto& account = db.get<account_object,by_name>(act.account);

int64_t code_size = (int64_t)act.code.size();
int64_t old_size = (int64_t)account.code.size() * config::setcode_ram_bytes_multiplier;
int64_t new_size = code_size * config::setcode_ram_bytes_multiplier;

EOS_ASSERT( account.code_version != code_id, set_exact_code, "contract is already running this version of code" );

// ...
}

这只是一个简单的WASM字节表示的sha256哈希值。(第二个参数只是字节数组的长度,哈希函数需要它来知道要对多少字节进行哈希处理。)

在node.js中,我们可以通过哈希一个WASM文件并将其与区块链上代码的哈希值进行比较来轻松实现这一点。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
const fs = require(`fs`)
const crypto = require(`crypto`)

const loadFileContents = file => {
if (!fs.existsSync(file)) {
throw new Error(`Code file "${file}" does not exist.`)
}

// no encoding => read as Buffer
return fs.readFileSync(file)
}

const createHash = contents => {
const hash = crypto.createHash(`sha256`)
hash.update(contents)
const digest = hash.digest(`hex`)

return digest
}

// fetch code contract from blockchain
const { code_hash: onChainCodeHash, abi_hash } = await api.rpc.fetch(`/v1/chain/get_raw_abi`, {
account_name: `hello`,
})
const contents = loadFileContents(`contracts/hello.wasm`)
const codeHash = createHash(contents)

if (codeHash === onChainCodeHash) {
console.log(`Code is up-to-date.`)
}

get-raw-abi函数是一个很好的API端点,可以通过一个查询同时获取帐户的代码和abi哈希。

注意,WASM文件和代码哈希依赖于编译期间使用的eosio cpp版本和-o优化参数。来自同一个C++代码,代码哈希可能是不同的。

EOS ABI 的哈希

我们可以尝试同样的方法来计算ABI哈希,但是,由于某种原因,eosio setabi操作不检查ABI哈希,因此允许使用相同的哈希进行更新。

但是get-raw-abi-api端点返回一个abi哈希,因此必须从某个地方获取它。通过检查nodeos-chain插件,我们可以看到它是为每个请求动态计算的:

1
2
3
4
5
6
7
8
9
10
11
12
13
read_only::get_raw_abi_results read_only::get_raw_abi( const get_raw_abi_params& params )const {
get_raw_abi_results result;
result.account_name = params.account_name;

const auto& d = db.db();
const auto& accnt = d.get<account_object,by_name>(params.account_name);
result.abi_hash = fc::sha256::hash( accnt.abi.data(), accnt.abi.size() );
result.code_hash = accnt.code_version;
if( !params.abi_hash || *params.abi_hash != result.abi_hash )
result.abi = blob{{accnt.abi.begin(), accnt.abi.end()}};

return result;
}

计算结果与ABI字节表示的代码哈希 - SHA256 完全相同。然而,实际存储ABI的方式有一个很大的区别。它不是作为熟悉的JSON文件存储的,而是作为EOS称之为原始ABI的打包方式存储的。

从raw abi转换为json很容易使用eosjs,但是从json转换为raw abi需要一些nb的操作:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
const {Serialize, Api} = require(`eosjs`)
const {TextEncoder, TextDecoder} = require(`util`) // node only; native TextEncoder/Decoder

const jsonToRawAbi = json => {
const tmpApi = new Api({
textDecoder: new TextDecoder(),
textEncoder: new TextEncoder(),
})
const buffer = new Serialize.SerialBuffer({
textEncoder: tmpApi.textEncoder,
textDecoder: tmpApi.textDecoder,
})

const abiDefinition = tmpApi.abiTypes.get(`abi_def`)
// need to make sure abi has every field in abiDefinition.fields
// otherwise serialize throws
const jsonExtended = abiDefinition.fields.reduce(
(acc, {name: fieldName}) => Object.assign(acc, {[fieldName]: acc[fieldName] || []}),
json,
)
abiDefinition.serialize(buffer, jsonExtended)

if (!Serialize.supportedAbiVersion(buffer.getString())) {
throw new Error(`Unsupported abi version`)
}
buffer.restartRead()

// convert to node buffer
return Buffer.from(buffer.asUint8Array())
}

每个ABI必须包含一组特定的字段,如versiontypesstructsactionstables,即版本、类型、结构、操作、表等,然后将这些字段序列化为更大的有效表示形式。

计算ABI哈希并用链上的值检查它是很简单的:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
const contents = loadFileContents(`contracts/hello.abi`)

const abi = JSON.parse(contents.toString(`utf8`))
const serializedAbi = jsonToRawAbi(abi)

const abiHash = createHash(serializedAbi)

// fetch abi hash from blockchain
const { code_hash, abi_hash: onChainAbiHash } = await api.rpc.fetch(`/v1/chain/get_raw_abi`, {
account_name: `hello`,
})

if (abiHash === onChainAbiHash) {
console.log(`ABI is up-to-date.`)

return null
}

======================================================================

分享一些比特币、以太坊、EOS等区块链相关的交互式在线编程实战教程:

  • EOS入门教程,本课程帮助你快速入门EOS区块链去中心化应用的开发,内容涵盖EOS工具链、账户与钱包、发行代币、智能合约开发与部署、使用代码与智能合约交互等核心知识点,最后综合运用各知识点完成一个便签DApp的开发。
  • 深入浅出玩转EOS钱包开发,本课程以手机EOS钱包的完整开发过程为主线,深入学习EOS区块链应用开发,课程内容即涵盖账户、计算资源、智能合约、动作与交易等EOS区块链的核心概念,同时也讲解如何使用eosjs和eosjs-ecc开发包访问EOS区块链,以及如何在React前端应用中集成对EOS区块链的支持。课程内容深入浅出,非常适合前端工程师深入学习EOS区块链应用开发。
  • java比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Java代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Java工程师不可多得的比特币开发学习课程。
  • php比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在Php代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是Php工程师不可多得的比特币开发学习课程。
  • c#比特币开发教程,本课程面向初学者,内容即涵盖比特币的核心概念,例如区块链存储、去中心化共识机制、密钥与脚本、交易与UTXO等,同时也详细讲解如何在C#代码中集成比特币支持功能,例如创建地址、管理钱包、构造裸交易等,是C#工程师不可多得的比特币开发学习课程。
  • java以太坊开发教程,主要是针对java和android程序员进行区块链以太坊开发的web3j详解。
  • python以太坊,主要是针对python工程师使用web3.py进行区块链以太坊开发的详解。
  • php以太坊,主要是介绍使用php进行智能合约开发交互,进行账号创建、交易、转账、代币开发以及过滤器和交易等内容。
  • 以太坊入门教程,主要介绍智能合约与dapp应用开发,适合入门。
  • 以太坊开发进阶教程,主要是介绍使用node.js、mongodb、区块链、ipfs实现去中心化电商DApp实战,适合进阶。
  • ERC721以太坊通证实战,课程以一个数字艺术品创作与分享DApp的实战开发为主线,深入讲解以太坊非同质化通证的概念、标准与开发方案。内容包含ERC-721标准的自主实现,讲解OpenZeppelin合约代码库二次开发,实战项目采用Truffle,IPFS,实现了通证以及去中心化的通证交易所。
  • C#以太坊,主要讲解如何使用C#开发基于.Net的以太坊应用,包括账户管理、状态与交易、智能合约开发与交互、过滤器和交易等。
  • Hyperledger Fabric 区块链开发详解,本课程面向初学者,内容即包含Hyperledger Fabric的身份证书与MSP服务、权限策略、通道配置与启动、链码通信接口等核心概念,也包含Fabric网络设计、nodejs链码与应用开发的操作实践,是Nodejs工程师学习Fabric区块链开发的最佳选择。
  • Hyperledger Fabric java 区块链开发详解,课程面向初学者,内容即包含Hyperledger Fabric的身份证书与MSP服务、权限策略、频道配置与启动、链码通信接口等核心概念,也包含Fabric网络设计、java链码与应用开发的操作实践,是java工程师学习Fabric区块链开发的最佳选择。
  • tendermint区块链开发详解,本课程适合希望使用tendermint进行区块链开发的工程师,课程内容即包括tendermint应用开发模型中的核心概念,例如ABCI接口、默克尔树、多版本状态库等,也包括代币发行等丰富的实操代码,是go语言工程师快速入门区块链开发的最佳选择。

汇智网原创翻译,转载请标明出处。这里是如何计算EOS代码和ABI的哈希