在以太坊生态系统中，智能合约的部署是核心环节之一，为了确保合约部署的确定性和可复现性，特别是在测试网络、私有链以及需要精确控制初始状态的场景下，开发者们常常会利用一种特定的数据格式来预先分配合约代码和状态，这种格式就是alloc格式，本文将深入探讨以太坊alloc格式是什么，它如何工作,以及它在实际开发中的应用。

什么是alloc格式

alloc格式是一种JSON（JavaScript Object Notation）结构，用于在以太坊区块链创世（genesis）或特定部署阶段，预先定义一系列账户的初始状态,这些状态主要包括：

  1. 合约代码：指定某个账户地址应该包含的以太坊虚拟机（EVM）字节码,即智能合约的编译后代码。
  2. 账户余额：指定账户在创世时拥有的以太币（ETH）数量。
  3. 存储值：为合约账户的特定存储槽（storage slots）预先设置初始值。

这种格式通常与创世块文件（genesis.json）紧密相关，尤其是在启动私有链或测试链时，通过alloc可以精确配置每个预分配账户的初始状态,无需通过交易逐个部署和初始化。

alloc格式的基本结构

alloc格式是一个JSON对象，其顶层键是账户地址（通常是以太坊地址的十六进制字符串，不带"0x"前缀，或者有时也会保留"0x"前缀，具体取决于工具和实现），每个账户地址对应的值又是一个JSON对象,可以包含以下字段：

  • code (可选)：字符串类型，表示该账户的EVM字节码，这是部署智能合约的核心字段,字节码通常是Solidity等高级语言编译后的结果。
  • balance (可选)：字符串类型，表示该账户的初始ETH余额，为了精确性，通常以"wei"为单位（1 ETH = 10^18 wei）,并以十进制字符串表示。
  • storage (可选)：对象类型，用于预先设置合约账户的存储状态，其键是存储槽的索引（通常为十六进制字符串），值是该存储槽的初始值（同样为十六进制字符串，表示字节序）。

示例：

以下是一个简单的alloc格式示例,其中包含一个预部署了简单存储合约的账户和一个拥有初始余额的普通账户：

{
  "alloc": {
    "0x627306090abab3a6e1400e9345bc60c78a8bef57": {
      "balance": "1000000000000000000"
    },
    "0xaabbccddee1234567890abcdef1234567890abcd": {
      "code": "608060405234801561001057600080fd5b5061013f80620000216000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c806360fe47b1146100465780636d4ce63c14610064575b600080fd5b61004e610088565b60405161005b91906100d6565b60405180910390f35b61007e6004803603810190610079919061011d565b610092565b005b60008054905090565b60008135905061009a8161013a565b92915050565b6000602082840312156100b6576100b5610135565b5b60006100c48482850161008b565b91505092915050565b6100d681610125565b82525050565b60006020820190506100f160008301846100cd565b9291505056fea2646970667358221220a5a8a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a5a564736f6c63430008070033",
      "storage": {
        "0x0": "0x0000000000000000000000000000000000000000000000000000000000000001"
      }
    }
  },
  "coinbase": "0x0000000000000000000000000000000000000000",
  "difficulty": "0x20000",
  "extraData": "0x",
  "gasLimit": "0x2fefd8",
  "nonce": "0x0000000000000042",
  "mixhash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "timestamp": "0x00"
}

在这个例子中：

  • 地址 0x627306090abab3a6e1400e9345bc60c78a8bef57 拥有 1 ETH 的初始余额。
  • 地址 0xaabbccddee1234567890abcdef1234567890abcd随机配图