@ocap/client 1.25.3 → 1.25.5

package/docs/how-to-guides-manage-accounts.zh-TW.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-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.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.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>