@ocap/client 1.25.4 → 1.25.5

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

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

package/docs/how-to-guides-manage-assets.ja.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: '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();
+```
+
+### パラメータ
+
+<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: '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();
+```
+
+### パラメータ
+
+<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: 'Conference Ticket Factory',
+  description: 'Mints tickets for the 2024 Tech Conference.',
+  limit: 1000, // 最大1000枚のチケットがミント可能
+  input: {
+    // 資産をミントするために必要なデータを定義
+    type: 'object',
+    properties: {
+      attendeeName: { type: 'string' },
+      ticketType: { type: 'string', enum: ['General', 'VIP'] },
+    },
+  },
+  output: {
+    // ミントされる資産の構造を定義
+    moniker: 'Ticket for {{attendeeName}}',
+    description: '{{ticketType}} admission for the 2024 Tech Conference.',
+    transferrable: false, // チケットは譲渡不可
+  },
+  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();
+```
+
+### パラメータ
+
+<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>
+
+---
+
+## ファクトリーからの資産の取得
+
+ファクトリーから資産を取得するのは2段階のプロセスです。まず、ミントデータを準備し、これにより作成される資産をプレビューできます。次に、トランザクションをブロックチェーンに送信して、公式に資産を取得します。
+
+この分離は、ユーザーが最終的なトランザクションに署名して送信する前に、受け取るものをアプリケーションが表示できるため便利です。
+
+### ステップ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('Prepared asset data for minting:', mintingData);
+    return mintingData;
+  } catch (error) {
+    console.error('Error preparing asset:', 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(`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();
+```
+
+### `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>
+
+### 戻り値
+
+`acquireAsset` 操作のトランザクションハッシュに解決される `Promise`。
+
+<x-field data-name="response" data-type="Promise<string>" data-desc="トランザクションハッシュ"></x-field>

package/docs/how-to-guides-manage-assets.zh-TW.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="[transactionHash, assetAddress]"></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="transactionHash"></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="在鑄造過程中要執行的一系列掛鉤 (hooks)。"></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="[transactionHash, factoryAddress]"></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="transactionHash"></x-field>