Sui TypeScript SDK中UID参数传递的正确方式

在Sui区块链应用开发过程中，TypeScript SDK与Move智能合约的交互是一个常见场景。本文将深入探讨如何正确传递UID参数这一技术细节。

问题背景

当开发者需要在TypeScript中调用Move合约时，经常会遇到参数类型匹配的问题。特别是对于Move中的object::UID类型，在TypeScript SDK中有其特定的处理方式。

核心问题分析

在Move合约中定义的函数：

public fun authorize(adminCap: &AdminCap, app_id: &mut object::UID)

这个函数接收两个参数：

1. 一个AdminCap的引用
2. 一个可变的对象UID引用

常见错误做法

开发者通常会尝试使用tx.pure.id()方法来传递UID参数：

tx.pure.id('0x72f070c5f126447f6d51497d5e66204fcbd2f9b700d1f6d8e84d61d6eff874e7')

这将导致错误：

CommandArgumentError { arg_idx: 1, kind: InvalidUsageOfPureArg }

错误的原因是tx.pure.id()并不适用于UID参数的传递。

正确解决方案

正确的做法是使用tx.object()方法：

tx.object('0x72f070c5f126447f6d51497d5e66204fcbd2f9b700d1f6d8e84d61d6eff874e7')

技术原理

在Sui的TypeScript SDK中：

• tx.object()用于传递对象引用
• tx.pure()用于传递原始值(primitive values)
• UID在Sui中本质上是一个对象引用，而非原始值

完整示例代码

tx.moveCall({
    target: '0x3006...a78::admin::authorize',
    arguments: [
        tx.object('0x2a61...bb4'),  // AdminCap
        tx.object('0x72f0...4e7')   // UID参数
    ],
})

最佳实践建议

1. 始终检查Move函数签名中的参数类型
2. 对于对象引用(包括UID)，使用tx.object()
3. 对于原始值(如u64, bool等)，使用tx.pure()
4. 在开发过程中充分利用TypeScript的类型提示

理解这些底层原理将帮助开发者更高效地与Sui区块链进行交互，避免常见的参数传递错误。