数据访问

Function 可以在计算过程中读取已有数据。表查询使用 BlockDB SDK，链上余额和合约调用使用 Leafage。将导入写在函数体内，查询结果通过 return 交给调用方。

读取 Chaintable 表

下面的函数读取以太坊价格表中原生 ETH 的最新记录。在自己的 Space 创建 Function，填入代码并点击 Run，无需设置参数。

def _():
    from blockdb import TimeTable

    return TimeTable('price.price.eth').get(
        '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'
    )

记录包含 id、time_at 和 value，分别表示代币 ID、价格时间和价格。根据表类型选择 SDK 类：

表类型	读取入口
普通表	`NormalTable(table_id).get(id)`
区块事件表	`EventTable(table_id, block_id).get(id)`
区块状态表	`StateTable(table_id, block_id).get(id)`
时间表	`TimeTable(table_id, time_at).get(id)`

省略区块或时间参数时读取的是最新值，不会退回共识高度；各类表的默认读取行为见工作原理。 在区块处理函数中，应传入当前处理的区块 ID，读取该区块的数据。服务端会检查表的共识高度是否已覆盖该区块。查不到记录时，get() 返回 None。在访问 row['value'] 等字段前，根据业务需要处理缺失记录。完整参数和批量读取见 blockdb-py。

查询链上余额

Leafage 用 Chaintable 链 ID 和区块 ID 定位链上状态。以太坊的 Chaintable 链 ID 为 eth。

def _(address):
    from leafage import ChainState

    block = ChainState.get_latest_block('eth')
    chain = ChainState('eth', block['id'])
    return {
        'block': block,
        'balance_wei': str(chain.get_address_balance(address)),
    }

设置 address 参数为 ADDRESS，使用地址 0xd8da6bf26964af9d7eed9e03e53415d37aa96045 测试。余额单位为 wei；返回字符串可以保留整数精度。

调用合约

下面读取指定历史区块的 Uniswap V2 USDC–ETH 池储备：

def _():
    from leafage import ChainState

    block = ChainState.get_block_by_height('eth', 25939934)
    chain = ChainState('eth', block['id'])
    usdc, weth, timestamp = chain.call(
        '0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc',
        'getReserves()(uint112,uint112,uint32)',
        [],
    )
    return {
        'reserve_usdc': str(usdc),
        'reserve_weth': str(weth),
        'timestamp': timestamp,
    }

方法签名同时写出输入类型和返回类型。getReserves() 没有输入参数，因此传入空列表；它返回两项储备和合约记录的更新时间。

概览

快速开始

使用指南

参考

读取 Chaintable 表

查询链上余额

调用合约

​读取 Chaintable 表

​查询链上余额

​调用合约

读取 Chaintable 表

查询链上余额

调用合约