如何計算EOS代碼和ABI的哈希

如何計算EOS代碼和ABI的哈希，針對這個問題，這篇文章詳細介紹了相對應的分析和解答，希望可以幫助更多想解決這個問題的小伙伴找到更簡單易行的方法。

如果你想知道在EOS上部署了什么版本的智能合約，你需要查看代碼哈希。我們將看到如何計算代碼和ABI哈希，并編寫一個函數，通過比較它們的哈希來查看本地WASM文件是否與正在運行的協議相匹配。

EOS代碼的哈希

當通過eosio setcode操作設置或更新合約時，檢查合約代碼是否已經在運行。因此，通過查看setcode實現，我們可以從WASM文件看到如何計算哈希值。

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文件并將其與區塊鏈上代碼的哈希值進行比較來輕松實現這一點。

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插件，我們可以看到它是為每個請求動態計算的：

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的操作：

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必須包含一組特定的字段，如version、types、structs、actions、tables，即版本、類型、結構、操作、表等，然后將這些字段序列化為更大的有效表示形式。

計算ABI哈希并用鏈上的值檢查它是很簡單的：

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代碼和ABI的哈希問題的解答就分享到這里了，希望以上內容可以對大家有一定的幫助，如果你還有很多疑惑沒有解開，可以關注億速云行業資訊頻道了解更多相關知識。