首页
/ Fuel TypeScript SDK v0.101.0 版本发布:强化谓词与交易功能

Fuel TypeScript SDK v0.101.0 版本发布:强化谓词与交易功能

2025-05-31 07:39:04作者:咎岭娴Homer

Fuel TypeScript SDK 是一个为 Fuel 区块链生态系统提供 TypeScript 支持的开发工具包。它简化了与 Fuel 区块链交互的过程,使开发者能够轻松构建去中心化应用。本次发布的 v0.101.0 版本主要围绕谓词(Predicate)功能和交易处理进行了多项重要改进。

谓词功能的重大增强

谓词是 Fuel 区块链中的一种特殊智能合约,用于定义资金使用的条件。本次更新对谓词功能进行了两项关键改进:

  1. 强制谓词数据验证
    现在,当谓词定义了输入参数时,SDK 会强制要求开发者提供相应的数据。这一改变确保了类型安全,防止开发者意外创建无效的谓词实例。例如,对于一个需要 PIN 码参数的谓词,现在必须显式提供数据:

    // 旧版本(允许但不正确)
    const predicateNoData = new PredicatePin({ provider }) // 不再允许
    
    // 新版本(正确方式)
    const predicate = new PredicatePin({ provider, data: [100] }) // 必须提供数据
    
  2. 新增 setData 方法
    为谓词类新增了 setData 方法,使开发者能够更灵活地更新谓词实例的数据:

    const predicate = new PredicatePin({ provider, data: [100] })
    predicate.setData([200]) // 动态更新谓词数据
    

交易处理的优化

本次更新对交易处理流程进行了多项改进:

  1. 交易请求动态修改
    现在支持在 InvocationScope 使用过程中对 TransactionRequest 进行实时修改,为开发者提供了更大的灵活性:

    const scope = contract.functions.some_method()
    scope.transactionRequest.gasLimit = 5000 // 动态调整gas限制
    
  2. gasLimit 自动计算优化
    provider.assembleTx() 方法现在会考虑 reserveGas 参数来设置交易的 gasLimit,确保交易有足够的 gas 执行。

  3. 交易状态订阅优化
    当用户只等待预确认(Preconfirmation)状态时,SDK 会自动关闭订阅连接,避免资源浪费。

移除废弃API

移除了 BaseInvocationScope.getTransactionId() 方法,开发者现在需要通过更明确的方式获取交易ID:

// 新方式
const request = contract.functions.get_counter().fundWithRequiredCoins()
const chainId = await provider.getChainId()
const txId = request.getTransactionId(chainId)

升级建议

对于正在使用 Fuel TypeScript SDK 的开发者,建议:

  1. 检查项目中是否使用了无数据的谓词实例,确保为所有需要参数的谓词提供数据
  2. getTransactionId() 的调用替换为新方式
  3. 利用新的交易修改功能优化交易构建流程

这些改进使 SDK 更加健壮和易用,同时为开发者提供了更强大的功能来控制区块链交互的各个方面。

登录后查看全文
热门项目推荐