Ganache-CLI以太坊私网JSON-RPC接口大全:从入门到精通 - 指南

1. 账户相关接口

eth_accounts - 获取账户列表

{
    "jsonrpc": "2.0",
    "method": "eth_accounts",
    "params": [],
    "id": 1
}

输出示例:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": [
        "0x90F8bf6A479f320ead074411a4B0e7944Ea8c9C1",
        "0xFFcf8FDEE72ac11b5c542428B35EEF5769C409f0"
    ]
}

字段解释:

  • jsonrpc: JSON-RPC 版本号
  • id: 请求标识符
  • result: 账户地址数组,每个地址都是20字节的十六进制字符串

eth_getBalance - 查询余额

{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": ["0xC29056169F9A933cfAF02d1d997356e3D6656584", "latest"],
    "id": 1
}

输出示例:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x56bc75e2d63100000"
}

字段解释:

  • result: 余额值,以wei为单位的十六进制数
  • wei转换: 1 ETH = 10^18 wei
  • 示例值: 0x56bc75e2d63100000 = 100 ETH

eth_getTransactionCount - 获取交易数量

{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionCount",
    "params": ["0xC29056169F9A933cfAF02d1d997356e3D6656584", "latest"],
    "id": 1
}

输出示例:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x5"
}

字段解释:

  • result: 账户发出的交易总数(nonce值)
  • 用途: 防止重放攻击,每笔交易必须有唯一的nonce

2. 交易相关接口

eth_sendTransaction - 发送交易

{
    "jsonrpc": "2.0",
    "method": "eth_sendTransaction",
    "params": [{
        "from": "0xC29056169F9A933cfAF02d1d997356e3D6656584",
        "to": "0xefBFb91d702DBDa726d2d0949d0cafA3a56F2f98",
        "value": "0x8ac7230489e80000",
        "gas": "0x5208",
        "gasPrice": "0x4a817c800",
        "data": "0x"
    }],
    "id": 1
}

输出示例:

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": "0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"
}

字段解释:

  • result: 交易哈希,32字节的十六进制字符串
  • 交易参数:
    • from: 发送方地址
    • to: 接收方地址
    • value: 转账金额(wei)
    • gas: Gas限制
    • gasPrice: Gas价格(wei)
    • data: 合约调用数据

eth_getTransactionByHash - 根据哈希查询交易

{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionByHash",
    "params": ["0x88df016429689c079f3b2f6ad39fa052532c56795b733da78a91ebe6a713944b"],
    "id": 1
}

输出示例:

{
posted on 2025-12-09 19:12  ljbguanli  阅读(1)  评论(0)    收藏  举报