@ocap/client 1.25.2 → 1.25.4

package/docs/how-to-guides-manage-accounts.zh.md

@@ -0,0 +1,73 @@
+# 管理账户
+
+在由 OCAP 驱动的区块链上，账户本质上是与一个地址关联的状态，由一对加密密钥（公钥和私钥）控制。一个需要理解的关键概念是，账户是隐式创建的。一旦账户收到第一笔入账交易（例如代币或资产转移），它就正式在链上存在了。没有显式的 `createAccount` 交易。
+
+本指南专注于一个关键的账户管理操作：将账户迁移到一组新的密钥。这是一项重要的安全功能，允许您在不更改账户地址、余额或资产的情况下，更改账户的所有权。
+
+## 将账户迁移至新密钥
+
+`migrateAccount` 函数允许您将一个现有的账户地址与一个新的公钥关联起来。这在以下几种场景中非常有用：
+
+- **密钥泄露**：如果您怀疑自己的私钥已被泄露，可以将账户迁移到一个新的、安全的密钥对，以防止未经授权的访问。
+- **升级安全性**：您可能希望从旧的密钥类型迁移到更新、更安全的密钥类型。
+
+此操作有效地转移了账户的控制权，同时保留了其在区块链上的历史和状态。
+
+### 参数
+
+<x-field-group>
+  <x-field data-name="from" data-type="WalletObject" data-required="true">
+    <x-field-desc markdown>代表正在被迁移的当前账户的钱包对象。该钱包必须签署交易以证明所有权。</x-field-desc>
+  </x-field>
+  <x-field data-name="to" data-type="WalletObject" data-required="true">
+    <x-field-desc markdown>控制权将转移至的新钱包对象。来自此钱包的公钥将成为该账户地址的新权限所有者。</x-field-desc>
+  </x-field>
+</x-field-group>
+
+### 返回值
+
+`migrateAccount` 方法返回一个 Promise，该 Promise 会解析为交易哈希字符串。
+
+### 示例
+
+以下是如何将账户从一个旧钱包迁移到一个新钱包的示例。
+
+```javascript Migrating an Account icon=logos:javascript
+import Client from '@ocap/client';
+import { fromRandom } from '@ocap/wallet';
+
+const client = new Client('https://beta.abtnetwork.io/api');
+
+// 假设 oldWallet 是当前账户授权的钱包
+const oldWallet = fromRandom(); 
+
+// 创建一个带有新密钥集的新钱包
+const newWallet = fromRandom();
+
+async function migrate() {
+  try {
+    // 在迁移之前，您通常需要为 oldWallet 的地址充值。
+    // 在本示例中，我们假设它有足够的资金来支付交易费用。
+    // 您可以从 https://faucet.abtnetwork.io/ 获取测试代币
+    console.log(`正在将账户从 ${oldWallet.address} 迁移到与 ${newWallet.address} 关联的新密钥`);
+
+    const hash = await client.migrateAccount({
+      from: oldWallet,
+      to: newWallet,
+    });
+
+    console.log('账户迁移交易已成功发送！');
+    console.log('交易哈希:', hash);
+    console.log(`在 https://beta.abtnetwork.io/explorer/txs/${hash} 查看交易`);
+
+  } catch (err) {
+    console.error('迁移账户时出错:', err);
+  }
+}
+
+migrate();
+```
+
+---
+
+现在您已经了解了如何通过迁移密钥来保护您的账户，您可能想学习如何在不共享主密钥的情况下，向其他账户授予有限的权限。更多详情请参阅[委托权限](./how-to-guides-delegate-permissions.md)指南。

package/docs/how-to-guides-manage-assets.md

@@ -0,0 +1,255 @@
+# Manage Assets (NFTs)
+
+This guide provides a comprehensive walkthrough of managing the entire lifecycle of Non-Fungible Tokens (NFTs), also known as assets, using the OCAP Client. You will learn how to create new assets from scratch, update their properties, establish an asset factory for standardized minting, and acquire new assets from that factory.
+
+## Create a New Asset
+
+You can create a unique, standalone asset on the blockchain using the `createAsset` method. Each asset is assigned a unique on-chain address derived from its initial properties.
+
+```javascript icon=logos:javascript
+const { wallet } = getWallet(); // User's wallet object
+
+async function createNewAsset() {
+  try {
+    const [hash, address] = await client.createAsset({
+      moniker: 'My Unique Digital Artwork',
+      data: {
+        typeUrl: 'json',
+        value: { 
+          description: 'A one-of-a-kind piece created by Artist X.',
+          imageUrl: 'https://example.com/path/to/image.png',
+        },
+      },
+      readonly: true,
+      transferrable: true,
+      wallet: wallet,
+    });
+
+    console.log(`Asset creation transaction sent: ${hash}`);
+    console.log(`New asset address: ${address}`);
+    return address;
+  } catch (error) {
+    console.error('Error creating asset:', error);
+  }
+}
+
+createNewAsset();
+```
+
+### Parameters
+
+<x-field-group>
+  <x-field data-name="moniker" data-type="string" data-required="true" data-desc="The name of the asset."></x-field>
+  <x-field data-name="parent" data-type="string" data-default="''" data-required="false" data-desc="The address of a parent asset, if any."></x-field>
+  <x-field data-name="data" data-type="object" data-required="true" data-desc="The data payload for the asset, which must include a typeUrl and value."></x-field>
+  <x-field data-name="readonly" data-type="boolean" data-default="false" data-required="false" data-desc="If true, the asset cannot be updated after creation."></x-field>
+  <x-field data-name="transferrable" data-type="boolean" data-default="true" data-required="false" data-desc="If true, the asset can be transferred to another account."></x-field>
+  <x-field data-name="ttl" data-type="number" data-default="0" data-required="false" data-desc="Time-to-live in seconds after the asset's first consumption."></x-field>
+  <x-field data-name="display" data-type="object" data-required="false" data-desc="Object containing display information for the asset."></x-field>
+  <x-field data-name="endpoint" data-type="object" data-required="false" data-desc="Object containing endpoint details for the asset."></x-field>
+  <x-field data-name="tags" data-type="string[]" data-default="[]" data-required="false" data-desc="An array of strings to categorize the asset."></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="The wallet object of the asset's initial owner."></x-field>
+  <x-field data-name="delegator" data-type="string" data-default="''" data-required="false" data-desc="The address of the account that authorized this transaction via delegation."></x-field>
+</x-field-group>
+
+### Returns
+
+A `Promise` that resolves to an array containing the transaction hash and the new asset's on-chain address.
+
+<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[transactionHash, assetAddress]"></x-field>
+
+---
+
+## Update an Existing Asset
+
+If an asset was created with `readonly: false`, you can modify its `moniker` and `data` fields using the `updateAsset` method. The asset is identified by its unique address.
+
+```javascript icon=logos:javascript
+const { wallet } = getWallet(); // User's wallet object
+const assetAddress = 'z362...'; // Address of the asset to update
+
+async function updateExistingAsset() {
+  try {
+    const hash = await client.updateAsset({
+      address: assetAddress,
+      moniker: 'My Updated Digital Artwork',
+      data: {
+        typeUrl: 'json',
+        value: { 
+          description: 'An updated description for my unique piece.',
+          imageUrl: 'https://example.com/path/to/new_image.png',
+        },
+      },
+      wallet: wallet,
+    });
+
+    console.log(`Asset update transaction sent: ${hash}`);
+  } catch (error) {
+    console.error('Error updating asset:', error);
+  }
+}
+
+updateExistingAsset();
+```
+
+### Parameters
+
+<x-field-group>
+  <x-field data-name="address" data-type="string" data-required="true" data-desc="The on-chain address of the asset to update."></x-field>
+  <x-field data-name="moniker" data-type="string" data-required="true" data-desc="The new name for the asset."></x-field>
+  <x-field data-name="data" data-type="object" data-required="true" data-desc="The updated data payload for the asset."></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="The wallet object of the current asset owner."></x-field>
+</x-field-group>
+
+### Returns
+
+A `Promise` that resolves to the transaction hash.
+
+<x-field data-name="response" data-type="Promise<string>" data-desc="transactionHash"></x-field>
+
+---
+
+## Create an Asset Factory
+
+An Asset Factory is a template for creating multiple, similar assets. It defines the structure, rules, and logic for minting new assets, which is more efficient than creating each one individually. This is ideal for use cases like issuing event tickets, certificates, or collectibles.
+
+```javascript icon=logos:javascript
+const { wallet } = getWallet(); // Factory owner's wallet
+
+const factoryDefinition = {
+  name: 'Conference Ticket Factory',
+  description: 'Mints tickets for the 2024 Tech Conference.',
+  limit: 1000, // Max 1000 tickets can be minted
+  input: {
+    // Defines what data is required to mint an asset
+    type: 'object',
+    properties: {
+      attendeeName: { type: 'string' },
+      ticketType: { type: 'string', enum: ['General', 'VIP'] },
+    },
+  },
+  output: {
+    // Defines the structure of the minted asset
+    moniker: 'Ticket for {{attendeeName}}',
+    description: '{{ticketType}} admission for the 2024 Tech Conference.',
+    transferrable: false, // Tickets are non-transferrable
+  },
+  hooks: [],
+};
+
+async function createFactory() {
+  try {
+    const [hash, factoryAddress] = await client.createAssetFactory({
+      factory: factoryDefinition,
+      wallet: wallet,
+    });
+
+    console.log(`Factory creation transaction sent: ${hash}`);
+    console.log(`New factory address: ${factoryAddress}`);
+  } catch (error) {
+    console.error('Error creating asset factory:', error);
+  }
+}
+
+createFactory();
+```
+
+### Parameters
+
+<x-field-group>
+  <x-field data-name="factory" data-type="object" data-required="true" data-desc="An object defining the factory's properties and minting logic.">
+    <x-field data-name="name" data-type="string" data-required="true" data-desc="Name of the factory."></x-field>
+    <x-field data-name="description" data-type="string" data-required="true" data-desc="Description of the factory's purpose."></x-field>
+    <x-field data-name="limit" data-type="number" data-default="0" data-required="false" data-desc="The maximum number of assets that can be minted from this factory. 0 means unlimited."></x-field>
+    <x-field data-name="trustedIssuers" data-type="string[]" data-required="false" data-desc="A list of account addresses authorized to mint from this factory."></x-field>
+    <x-field data-name="input" data-type="object" data-required="true" data-desc="Defines the required input data for minting an asset."></x-field>
+    <x-field data-name="output" data-type="object" data-required="true" data-desc="Defines the structure and properties of the asset that will be minted."></x-field>
+    <x-field data-name="hooks" data-type="object[]" data-required="false" data-desc="A list of hooks to execute during the minting process."></x-field>
+    <x-field data-name="data" data-type="object" data-required="false" data-desc="Additional arbitrary data to store with the factory."></x-field>
+  </x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="The wallet object of the factory's owner."></x-field>
+</x-field-group>
+
+
+### Returns
+
+A `Promise` that resolves to an array containing the transaction hash and the new factory's on-chain address.
+
+<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[transactionHash, factoryAddress]"></x-field>
+
+---
+
+## Acquire an Asset from a Factory
+
+Acquiring an asset from a factory is a two-step process. First, you prepare the minting data, which allows you to preview the asset that will be created. Second, you submit the transaction to the blockchain to officially acquire the asset.
+
+This separation is useful because it allows an application to show a user what they are about to receive before they sign and submit the final transaction.
+
+### Step 1: Prepare the Asset Data
+
+The `preMintAsset` method takes the factory address and user-provided inputs to generate the final asset data. This happens off-chain and does not require a transaction.
+
+```javascript icon=logos:javascript
+const factoryAddress = 'z2...'; // Address of the factory created previously
+const { wallet: issuerWallet } = getIssuerWallet(); // The factory owner or a trusted issuer
+const { wallet: userWallet } = getUserWallet(); // The user who will own the new asset
+
+async function prepareAssetForMinting() {
+  try {
+    const mintingData = await client.preMintAsset({
+      factory: factoryAddress,
+      inputs: {
+        attendeeName: 'John Doe',
+        ticketType: 'VIP',
+      },
+      owner: userWallet.address,
+      wallet: issuerWallet,
+    });
+
+    console.log('Prepared asset data for minting:', mintingData);
+    return mintingData;
+  } catch (error) {
+    console.error('Error preparing asset:', error);
+  }
+}
+```
+
+### Step 2: Send the Transaction
+
+Once the minting data is prepared, the user (the future asset owner) signs and sends the `acquireAsset` transaction. The `itx` object from `preMintAsset` is used as the payload.
+
+```javascript icon=logos:javascript
+async function acquireNewAsset() {
+  // First, get the minting data from Step 1
+  const itx = await prepareAssetForMinting();
+  if (!itx) return;
+
+  try {
+    const hash = await client.acquireAsset({
+      itx: itx,
+      wallet: userWallet, // The user's wallet signs the transaction
+    });
+
+    console.log(`Asset acquisition transaction sent: ${hash}`);
+    console.log(`New asset will be available at address: ${itx.address}`);
+  } catch (error) {
+    console.error('Error acquiring asset:', error);
+  }
+}
+
+acquireNewAsset();
+```
+
+### Parameters for `acquireAsset`
+
+<x-field-group>
+  <x-field data-name="itx" data-type="object" data-required="true" data-desc="The inner transaction object returned from the `preMintAsset` method."></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="The wallet of the user who is acquiring the asset."></x-field>
+  <x-field data-name="delegator" data-type="string" data-default="''" data-required="false" data-desc="The address of the account that authorized this transaction via delegation."></x-field>
+</x-field-group>
+
+### Returns
+
+A `Promise` that resolves to the transaction hash for the `acquireAsset` operation.
+
+<x-field data-name="response" data-type="Promise<string>" data-desc="transactionHash"></x-field>

package/docs/how-to-guides-manage-assets.zh.md

@@ -0,0 +1,255 @@
+# 管理资产 (NFT)
+
+本指南将全面介绍如何使用 OCAP Client 管理非同质化代币（NFT），也称资产的整个生命周期。你将学习如何从头开始创建新资产、更新其属性、建立用于标准化铸造的资产工厂，以及从该工厂获取新资产。
+
+## 创建新资产
+
+你可以使用 `createAsset` 方法在区块链上创建一个独特的、独立的资产。每个资产都会被分配一个唯一的链上地址，该地址由其初始属性派生。
+
+```javascript icon=logos:javascript
+const { wallet } = getWallet(); // 用户的钱包对象
+
+async function createNewAsset() {
+  try {
+    const [hash, address] = await client.createAsset({
+      moniker: '我的独特数字艺术品',
+      data: {
+        typeUrl: 'json',
+        value: { 
+          description: '由艺术家 X 创作的独一无二的作品。',
+          imageUrl: 'https://example.com/path/to/image.png',
+        },
+      },
+      readonly: true,
+      transferrable: true,
+      wallet: wallet,
+    });
+
+    console.log(`资产创建交易已发送：${hash}`);
+    console.log(`新资产地址：${address}`);
+    return address;
+  } catch (error) {
+    console.error('创建资产时出错：', error);
+  }
+}
+
+createNewAsset();
+```
+
+### 参数
+
+<x-field-group>
+  <x-field data-name="moniker" data-type="string" data-required="true" data-desc="资产的名称。"></x-field>
+  <x-field data-name="parent" data-type="string" data-default="''" data-required="false" data-desc="父资产的地址（如有）。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="true" data-desc="资产的数据负载，必须包含 typeUrl 和 value。"></x-field>
+  <x-field data-name="readonly" data-type="boolean" data-default="false" data-required="false" data-desc="若为 true，则资产在创建后无法更新。"></x-field>
+  <x-field data-name="transferrable" data-type="boolean" data-default="true" data-required="false" data-desc="若为 true，则资产可以转移到另一个账户。"></x-field>
+  <x-field data-name="ttl" data-type="number" data-default="0" data-required="false" data-desc="资产首次消费后的存活时间（秒）。"></x-field>
+  <x-field data-name="display" data-type="object" data-required="false" data-desc="包含资产显示信息的对象。"></x-field>
+  <x-field data-name="endpoint" data-type="object" data-required="false" data-desc="包含资产端点详细信息的对象。"></x-field>
+  <x-field data-name="tags" data-type="string[]" data-default="[]" data-required="false" data-desc="用于对资产进行分类的字符串数组。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="资产初始所有者的钱包对象。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-default="''" data-required="false" data-desc="通过委托授权此交易的账户地址。"></x-field>
+</x-field-group>
+
+### 返回值
+
+一个 `Promise`，它会解析为一个包含交易哈希和新资产链上地址的数组。
+
+<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[交易哈希, 资产地址]"></x-field>
+
+---
+
+## 更新现有资产
+
+如果资产创建时设置了 `readonly: false`，你可以使用 `updateAsset` 方法修改其 `moniker` 和 `data` 字段。资产通过其唯一地址进行识别。
+
+```javascript icon=logos:javascript
+const { wallet } = getWallet(); // 用户的钱包对象
+const assetAddress = 'z362...'; // 要更新的资产地址
+
+async function updateExistingAsset() {
+  try {
+    const hash = await client.updateAsset({
+      address: assetAddress,
+      moniker: '我更新后的数字艺术品',
+      data: {
+        typeUrl: 'json',
+        value: { 
+          description: '我这件独特作品的更新描述。',
+          imageUrl: 'https://example.com/path/to/new_image.png',
+        },
+      },
+      wallet: wallet,
+    });
+
+    console.log(`资产更新交易已发送：${hash}`);
+  } catch (error) {
+    console.error('更新资产时出错：', error);
+  }
+}
+
+updateExistingAsset();
+```
+
+### 参数
+
+<x-field-group>
+  <x-field data-name="address" data-type="string" data-required="true" data-desc="要更新资产的链上地址。"></x-field>
+  <x-field data-name="moniker" data-type="string" data-required="true" data-desc="资产的新名称。"></x-field>
+  <x-field data-name="data" data-type="object" data-required="true" data-desc="资产更新后的数据负载。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="当前资产所有者的钱包对象。"></x-field>
+</x-field-group>
+
+### 返回值
+
+一个 `Promise`，它会解析为交易哈希。
+
+<x-field data-name="response" data-type="Promise<string>" data-desc="交易哈希"></x-field>
+
+---
+
+## 创建资产工厂
+
+资产工厂是用于创建多个相似资产的模板。它定义了铸造新资产的结构、规则和逻辑，比单独创建每个资产更高效。这非常适合发行活动门票、证书或收藏品等用例。
+
+```javascript icon=logos:javascript
+const { wallet } = getWallet(); // 工厂所有者的钱包
+
+const factoryDefinition = {
+  name: '会议门票工厂',
+  description: '铸造 2024 年科技大会的门票。',
+  limit: 1000, // 最多可铸造 1000 张门票
+  input: {
+    // 定义铸造资产所需的数据
+    type: 'object',
+    properties: {
+      attendeeName: { type: 'string' },
+      ticketType: { type: 'string', enum: ['General', 'VIP'] },
+    },
+  },
+  output: {
+    // 定义铸造资产的结构
+    moniker: '{{attendeeName}} 的门票',
+    description: '2024 年科技大会的 {{ticketType}} 门票。',
+    transferrable: false, // 门票不可转让
+  },
+  hooks: [],
+};
+
+async function createFactory() {
+  try {
+    const [hash, factoryAddress] = await client.createAssetFactory({
+      factory: factoryDefinition,
+      wallet: wallet,
+    });
+
+    console.log(`工厂创建交易已发送：${hash}`);
+    console.log(`新工厂地址：${factoryAddress}`);
+  } catch (error) {
+    console.error('创建资产工厂时出错：', error);
+  }
+}
+
+createFactory();
+```
+
+### 参数
+
+<x-field-group>
+  <x-field data-name="factory" data-type="object" data-required="true" data-desc="定义工厂属性和铸造逻辑的对象。">
+    <x-field data-name="name" data-type="string" data-required="true" data-desc="工厂的名称。"></x-field>
+    <x-field data-name="description" data-type="string" data-required="true" data-desc="工厂用途的描述。"></x-field>
+    <x-field data-name="limit" data-type="number" data-default="0" data-required="false" data-desc="可从此工厂铸造的最大资产数量。0 表示无限制。"></x-field>
+    <x-field data-name="trustedIssuers" data-type="string[]" data-required="false" data-desc="有权从此工厂铸造的账户地址列表。"></x-field>
+    <x-field data-name="input" data-type="object" data-required="true" data-desc="定义铸造资产所需的输入数据。"></x-field>
+    <x-field data-name="output" data-type="object" data-required="true" data-desc="定义将要铸造的资产的结构和属性。"></x-field>
+    <x-field data-name="hooks" data-type="object[]" data-required="false" data-desc="在铸造过程中执行的钩子列表。"></x-field>
+    <x-field data-name="data" data-type="object" data-required="false" data-desc="与工厂一起存储的额外任意数据。"></x-field>
+  </x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="工厂所有者的钱包对象。"></x-field>
+</x-field-group>
+
+
+### 返回值
+
+一个 `Promise`，它会解析为一个包含交易哈希和新工厂链上地址的数组。
+
+<x-field data-name="response" data-type="Promise<[string, string]>" data-desc="[交易哈希, 工厂地址]"></x-field>
+
+---
+
+## 从工厂获取资产
+
+从工厂获取资产是一个两步过程。首先，准备铸造数据，这可以让你预览将要创建的资产。其次，将交易提交到区块链以正式获取资产。
+
+这种分离很有用，因为它允许应用程序在用户签署并提交最终交易之前，向用户展示他们将要收到的内容。
+
+### 步骤 1：准备资产数据
+
+`preMintAsset` 方法接收工厂地址和用户提供的输入，以生成最终的资产数据。此过程在链下进行，无需交易。
+
+```javascript icon=logos:javascript
+const factoryAddress = 'z2...'; // 先前创建的工厂地址
+const { wallet: issuerWallet } = getIssuerWallet(); // 工厂所有者或受信任的发行者
+const { wallet: userWallet } = getUserWallet(); // 将拥有新资产的用户
+
+async function prepareAssetForMinting() {
+  try {
+    const mintingData = await client.preMintAsset({
+      factory: factoryAddress,
+      inputs: {
+        attendeeName: 'John Doe',
+        ticketType: 'VIP',
+      },
+      owner: userWallet.address,
+      wallet: issuerWallet,
+    });
+
+    console.log('准备好用于铸造的资产数据：', mintingData);
+    return mintingData;
+  } catch (error) {
+    console.error('准备资产时出错：', error);
+  }
+}
+```
+
+### 步骤 2：发送交易
+
+铸造数据准备好后，用户（即未来的资产所有者）签署并发送 `acquireAsset` 交易。`preMintAsset` 返回的 `itx` 对象将用作有效载荷。
+
+```javascript icon=logos:javascript
+async function acquireNewAsset() {
+  // 首先，从步骤 1 获取铸造数据
+  const itx = await prepareAssetForMinting();
+  if (!itx) return;
+
+  try {
+    const hash = await client.acquireAsset({
+      itx: itx,
+      wallet: userWallet, // 用户的钱包签署交易
+    });
+
+    console.log(`资产获取交易已发送：${hash}`);
+    console.log(`新资产将在以下地址可用：${itx.address}`);
+  } catch (error) {
+    console.error('获取资产时出错：', error);
+  }
+}
+
+acquireNewAsset();
+```
+
+### `acquireAsset` 的参数
+
+<x-field-group>
+  <x-field data-name="itx" data-type="object" data-required="true" data-desc="从 `preMintAsset` 方法返回的内部交易对象。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="正在获取资产的用户的钱包。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-default="''" data-required="false" data-desc="通过委托授权此交易的账户地址。"></x-field>
+</x-field-group>
+
+### 返回值
+
+一个 `Promise`，它会解析为 `acquireAsset` 操作的交易哈希。
+
+<x-field data-name="response" data-type="Promise<string>" data-desc="交易哈希"></x-field>