@ocap/client 1.25.3 → 1.25.5

package/docs/how-to-guides-transfer-tokens-and-nfts.md

@@ -0,0 +1,179 @@
+# Transfer Tokens and NFTs
+
+This guide provides a step-by-step walkthrough for transferring fungible tokens (both native and custom) and non-fungible tokens (NFTs or assets) between accounts using the OCAP Client. The primary method for all transfers is `client.transfer()`.
+
+One key feature to remember is that a new account is automatically created on-chain when it receives its first incoming transaction. This means you can transfer tokens or assets to a brand new address without any prior setup for the recipient.
+
+## The `transfer` Method
+
+The `client.transfer()` method is a versatile helper function that simplifies the process of sending assets and tokens. It constructs, signs, and sends the appropriate transaction (`transferV2Tx`) to the blockchain in a single call.
+
+### Parameters
+
+<x-field-group>
+  <x-field data-name="to" data-type="string" data-required="true">
+    <x-field-desc markdown>The recipient's account address. This must be a valid DID address.</x-field-desc>
+  </x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="The sender's wallet object used to sign the transaction."></x-field>
+  <x-field data-name="token" data-type="number" data-default="0">
+    <x-field-desc markdown>The amount of the chain's native token to transfer. The client handles the conversion to the correct decimal units automatically.</x-field-desc>
+  </x-field>
+  <x-field data-name="assets" data-type="string[]" data-default="[]" data-desc="An array of asset addresses (NFTs) to transfer."></x-field>
+  <x-field data-name="tokens" data-type="object[]" data-default="[]">
+    <x-field-desc markdown>An array of custom fungible token objects to transfer.</x-field-desc>
+    <x-field data-name="address" data-type="string" data-required="true" data-desc="The address of the custom token contract."></x-field>
+    <x-field data-name="value" data-type="number" data-required="true" data-desc="The amount of the custom token to transfer."></x-field>
+  </x-field>
+  <x-field data-name="memo" data-type="string" data-required="false" data-desc="An optional message or note to include with the transaction."></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false">
+    <x-field-desc markdown>If the `wallet` is acting on behalf of another account, this should be the address of the delegating account. See the [Delegate Permissions](./how-to-guides-delegate-permissions.md) guide for more details.</x-field-desc>
+  </x-field>
+</x-field-group>
+
+### Returns
+
+<x-field data-name="Promise<string>" data-type="Promise">
+  <x-field-desc markdown>A Promise that resolves to the transaction hash upon successful submission to the blockchain.</x-field-desc>
+</x-field>
+
+## Step-by-Step Examples
+
+### Prerequisites
+
+Before you start, make sure you have:
+
+1.  An initialized `GraphQLClient` connected to a chain host like `https://beta.abtnetwork.io`.
+2.  A sender's wallet object (`senderWallet`) that is funded with enough tokens to cover the transfer and transaction fees.
+3.  A recipient's wallet object (`recipientWallet`) to get their address. The recipient's account does not need to exist on-chain yet.
+
+```javascript Basic Setup icon=logos:javascript
+import GraphQLClient from '@ocap/client';
+import { fromRandom } from '@ocap/wallet';
+
+// 1. Initialize the client
+const client = new GraphQLClient({ endpoint: 'https://beta.abtnetwork.io/api' });
+
+// 2. Create wallets for sender and recipient
+// In a real application, the sender's wallet would be loaded, not created randomly.
+const senderWallet = fromRandom(); // Assume this wallet is funded
+const recipientWallet = fromRandom();
+
+console.log(`Sender Address: ${senderWallet.address}`);
+console.log(`Recipient Address: ${recipientWallet.address}`);
+
+// To fund the sender's wallet for this example, use the faucet:
+// https://faucet.abtnetwork.io/
+```
+
+### Example 1: Transferring Native Tokens
+
+This example shows how to send 10 native tokens from the sender to the recipient.
+
+```javascript Transfer Native Tokens icon=logos:javascript
+async function transferNativeTokens() {
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      token: 10, // The amount of native tokens to send
+      wallet: senderWallet,
+      memo: 'Sending you 10 native tokens!'
+    });
+    console.log('Native token transfer successful. Tx Hash:', hash);
+  } catch (err) {
+    console.error('Error transferring tokens:', err);
+  }
+}
+
+transferNativeTokens();
+```
+
+### Example 2: Transferring an NFT (Asset)
+
+To transfer an NFT, you need its unique asset address. First, you would create or acquire an asset (see [Manage Assets (NFTs)](./how-to-guides-manage-assets.md)). For this example, let's assume `senderWallet` already owns an NFT with the address `zNKj...`.
+
+```javascript Transfer an NFT icon=logos:javascript
+async function transferNFT() {
+  // Assume this is the address of an NFT owned by senderWallet
+  const nftAddress = 'zNKjL4wTmxQPk5nN2ADDPCd58286b2de3f3e';
+
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      assets: [nftAddress], // An array of asset addresses
+      wallet: senderWallet,
+      memo: 'Here is the NFT you wanted.'
+    });
+    console.log('NFT transfer successful. Tx Hash:', hash);
+  } catch (err) {
+    console.error('Error transferring NFT:', err);
+  }
+}
+
+transferNFT();
+```
+
+### Example 3: Transferring Custom Tokens
+
+This example demonstrates how to transfer a custom fungible token. You need the token's contract address. See the [Manage Tokens](./how-to-guides-manage-tokens.md) guide for information on creating custom tokens.
+
+```javascript Transfer Custom Tokens icon=logos:javascript
+async function transferCustomToken() {
+  // Assume this is the address of a custom token owned by senderWallet
+  const customTokenAddress = 'z37bA4x...'; 
+
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      wallet: senderWallet,
+      tokens: [
+        { address: customTokenAddress, value: 50 } // 50 units of a custom token
+      ],
+      memo: 'Sending 50 custom tokens.'
+    });
+    console.log('Custom token transfer successful. Tx Hash:', hash);
+  } catch (err) {
+    console.error('Error transferring custom token:', err);
+  }
+}
+
+transferCustomToken();
+```
+
+### Example 4: A Combined Transfer
+
+You can send native tokens, custom tokens, and multiple NFTs all in a single, atomic transaction. This is highly efficient.
+
+```javascript Combined Transfer icon=logos:javascript
+async function combinedTransfer() {
+  // Assume these are addresses of assets and tokens owned by senderWallet
+  const nftAddress1 = 'zNKjL4wTmxQPk5nN2ADDPCd58286b2de3f3e';
+  const nftAddress2 = 'zNKiabcdeQPk5nN2ADDPCd58286b2defghj';
+  const customTokenAddress = 'z37bA4x...'; // Address of a custom fungible token
+
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      wallet: senderWallet,
+      token: 5, // 5 native tokens
+      assets: [nftAddress1, nftAddress2], // An array of two NFTs
+      tokens: [
+        { address: customTokenAddress, value: 50 } // 50 units of a custom token
+      ],
+      memo: 'Sending a mix of tokens and NFTs.'
+    });
+    console.log('Combined transfer successful. Tx Hash:', hash);
+  } catch (err) {
+    console.error('Error with combined transfer:', err);
+  }
+}
+
+combinedTransfer();
+```
+
+By following these examples, you can easily implement token and NFT transfers in your application. For more details on creating the items you wish to transfer, please see the related guides.
+
+### Further Reading
+
+- [How to Manage Assets (NFTs)](./how-to-guides-manage-assets.md)
+- [How to Manage Tokens](./how-to-guides-manage-tokens.md)
+- [High-level API](./api-reference-transaction-helpers.md)

package/docs/how-to-guides-transfer-tokens-and-nfts.zh-TW.md

@@ -0,0 +1,179 @@
+# 轉移代幣和 NFT
+
+本指南提供了使用 OCAP Client 在帳戶之間轉移可替代代幣（包括原生和自訂代幣）和不可替代代幣（NFT 或資產）的逐步演練。所有轉移的主要方法是 `client.transfer()`。
+
+一個需要記住的關鍵功能是，當新帳戶收到第一筆傳入交易時，它會自動在鏈上創建。這意味著您可以將代幣或資產轉移到一個全新的地址，而無需為接收者進行任何預先設定。
+
+## `transfer` 方法
+
+`client.transfer()` 方法是一個多功能的輔助函數，可簡化發送資產和代幣的過程。它在單次呼叫中建構、簽署並將適當的交易（`transferV2Tx`）發送到區塊鏈。
+
+### 參數
+
+<x-field-group>
+  <x-field data-name="to" data-type="string" data-required="true">
+    <x-field-desc markdown>接收者的帳戶地址。這必須是一個有效的 DID 地址。</x-field-desc>
+  </x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="用於簽署交易的發送者錢包物件。"></x-field>
+  <x-field data-name="token" data-type="number" data-default="0">
+    <x-field-desc markdown>要轉移的鏈原生代幣數量。客戶端會自動處理轉換為正確的小數位數。</x-field-desc>
+  </x-field>
+  <x-field data-name="assets" data-type="string[]" data-default="[]" data-desc="要轉移的資產地址（NFT）陣列。"></x-field>
+  <x-field data-name="tokens" data-type="object[]" data-default="[]">
+    <x-field-desc markdown>要轉移的自訂可替代代幣物件陣列。</x-field-desc>
+    <x-field data-name="address" data-type="string" data-required="true" data-desc="自訂代幣合約的地址。"></x-field>
+    <x-field data-name="value" data-type="number" data-required="true" data-desc="要轉移的自訂代幣數量。"></x-field>
+  </x-field>
+  <x-field data-name="memo" data-type="string" data-required="false" data-desc="可隨交易包含的選用訊息或備註。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false">
+    <x-field-desc markdown>如果 `wallet` 代表另一個帳戶行事，這應該是委託帳戶的地址。更多詳細資訊請參閱 [委派權限](./how-to-guides-delegate-permissions.md) 指南。</x-field-desc>
+  </x-field>
+</x-field-group>
+
+### 返回值
+
+<x-field data-name="Promise<string>" data-type="Promise">
+  <x-field-desc markdown>一個 Promise，在成功提交到區塊鏈後，會解析為交易雜湊值。</x-field-desc>
+</x-field>
+
+## 逐步範例
+
+### 先決條件
+
+在開始之前，請確保您具備：
+
+1.  一個已初始化並連接到鏈主機（如 `https://beta.abtnetwork.io`）的 `GraphQLClient`。
+2.  一個發送者的錢包物件（`senderWallet`），其中有足夠的代幣來支付轉帳和交易費用。
+3.  一個接收者的錢包物件（`recipientWallet`）以獲取其地址。接收者的帳戶尚無需存在於鏈上。
+
+```javascript Basic Setup icon=logos:javascript
+import GraphQLClient from '@ocap/client';
+import { fromRandom } from '@ocap/wallet';
+
+// 1. 初始化客戶端
+const client = new GraphQLClient({ endpoint: 'https://beta.abtnetwork.io/api' });
+
+// 2. 為發送者和接收者創建錢包
+// 在實際應用中，發送者的錢包將被載入，而不是隨機創建。
+const senderWallet = fromRandom(); // 假設此錢包已有資金
+const recipientWallet = fromRandom();
+
+console.log(`Sender Address: ${senderWallet.address}`);
+console.log(`Recipient Address: ${recipientWallet.address}`);
+
+// 要為此範例的發送者錢包注資，請使用水龍頭：
+// https://faucet.abtnetwork.io/
+```
+
+### 範例 1：轉移原生代幣
+
+此範例展示了如何從發送者向接收者發送 10 個原生代幣。
+
+```javascript Transfer Native Tokens icon=logos:javascript
+async function transferNativeTokens() {
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      token: 10, // 要發送的原生代幣數量
+      wallet: senderWallet,
+      memo: '發送 10 個原生代幣給您！'
+    });
+    console.log('原生代幣轉移成功。交易雜湊值：', hash);
+  } catch (err) {
+    console.error('轉移代幣時出錯：', err);
+  }
+}
+
+transferNativeTokens();
+```
+
+### 範例 2：轉移 NFT（資產）
+
+要轉移 NFT，您需要其唯一的資產地址。首先，您需要創建或獲取一個資產（請參閱 [管理資產 (NFT)](./how-to-guides-manage-assets.md)）。在此範例中，我們假設 `senderWallet` 已經擁有一個地址為 `zNKj...` 的 NFT。
+
+```javascript Transfer an NFT icon=logos:javascript
+async function transferNFT() {
+  // 假設這是 senderWallet 擁有的 NFT 地址
+  const nftAddress = 'zNKjL4wTmxQPk5nN2ADDPCd58286b2de3f3e';
+
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      assets: [nftAddress], // 資產地址的陣列
+      wallet: senderWallet,
+      memo: '這是您想要的 NFT。'
+    });
+    console.log('NFT 轉移成功。交易雜湊值：', hash);
+  } catch (err) {
+    console.error('轉移 NFT 時出錯：', err);
+  }
+}
+
+transferNFT();
+```
+
+### 範例 3：轉移自訂代幣
+
+此範例演示了如何轉移自訂的可替代代幣。您需要該代幣的合約地址。有關創建自訂代幣的資訊，請參閱 [管理代幣](./how-to-guides-manage-tokens.md) 指南。
+
+```javascript Transfer Custom Tokens icon=logos:javascript
+async function transferCustomToken() {
+  // 假設這是 senderWallet 擁有的自訂代幣地址
+  const customTokenAddress = 'z37bA4x...'; 
+
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      wallet: senderWallet,
+      tokens: [
+        { address: customTokenAddress, value: 50 } // 50 單位的自訂代幣
+      ],
+      memo: '發送 50 個自訂代幣。'
+    });
+    console.log('自訂代幣轉移成功。交易雜湊值：', hash);
+  } catch (err) {
+    console.error('轉移自訂代幣時出錯：', err);
+  }
+}
+
+transferCustomToken();
+```
+
+### 範例 4：組合轉移
+
+您可以在單一的原子交易中發送原生代幣、自訂代幣和多個 NFT。這是非常高效的。
+
+```javascript Combined Transfer icon=logos:javascript
+async function combinedTransfer() {
+  // 假設這些是 senderWallet 擁有的資產和代幣地址
+  const nftAddress1 = 'zNKjL4wTmxQPk5nN2ADDPCd58286b2de3f3e';
+  const nftAddress2 = 'zNKiabcdeQPk5nN2ADDPCd58286b2defghj';
+  const customTokenAddress = 'z37bA4x...'; // 自訂可替代代幣的地址
+
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      wallet: senderWallet,
+      token: 5, // 5 個原生代幣
+      assets: [nftAddress1, nftAddress2], // 包含兩個 NFT 的陣列
+      tokens: [
+        { address: customTokenAddress, value: 50 } // 50 單位的自訂代幣
+      ],
+      memo: '發送混合的代幣和 NFT。'
+    });
+    console.log('組合轉移成功。交易雜湊值：', hash);
+  } catch (err) {
+    console.error('組合轉移時出錯：', err);
+  }
+}
+
+combinedTransfer();
+```
+
+通過遵循這些範例，您可以輕鬆地在您的應用程式中實現代幣和 NFT 的轉移。有關創建您希望轉移的項目的更多詳細資訊，請參閱相關指南。
+
+### 延伸閱讀
+
+- [如何管理資產 (NFT)](./how-to-guides-manage-assets.md)
+- [如何管理代幣](./how-to-guides-manage-tokens.md)
+- [高階 API](./api-reference-transaction-helpers.md)

package/docs/how-to-guides-transfer-tokens-and-nfts.zh.md

@@ -0,0 +1,179 @@
+# 转移通证和 NFT
+
+本指南提供了使用 OCAP Client 在账户之间转移可替代通证（包括原生和自定义通证）和非可替代通证（NFT 或资产）的详细步骤。所有转移操作的主要方法是 `client.transfer()`。
+
+需要记住的一个关键特性是，当一个新账户首次接收到交易时，它会自动在链上创建。这意味着你可以将通证或资产转移到一个全新的地址，而无需接收方进行任何预先设置。
+
+## `transfer` 方法
+
+`client.transfer()` 方法是一个多功能的辅助函数，它简化了发送资产和通证的过程。它通过一次调用即可构建、签名并将相应的交易（`transferV2Tx`）发送到区块链。
+
+### 参数
+
+<x-field-group>
+  <x-field data-name="to" data-type="string" data-required="true">
+    <x-field-desc markdown>接收方的账户地址。这必须是一个有效的 DID 地址。</x-field-desc>
+  </x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="用于签署交易的发送方钱包对象。"></x-field>
+  <x-field data-name="token" data-type="number" data-default="0">
+    <x-field-desc markdown>要转移的链上原生通证的数量。客户端会自动处理到正确小数单位的转换。</x-field-desc>
+  </x-field>
+  <x-field data-name="assets" data-type="string[]" data-default="[]" data-desc="要转移的资产地址（NFT）数组。"></x-field>
+  <x-field data-name="tokens" data-type="object[]" data-default="[]">
+    <x-field-desc markdown>要转移的自定义可替代通证对象数组。</x-field-desc>
+    <x-field data-name="address" data-type="string" data-required="true" data-desc="自定义通证合约的地址。"></x-field>
+    <x-field data-name="value" data-type="number" data-required="true" data-desc="要转移的自定义通证的数量。"></x-field>
+  </x-field>
+  <x-field data-name="memo" data-type="string" data-required="false" data-desc="交易中包含的可选消息或备注。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false">
+    <x-field-desc markdown>如果 `wallet` 代表另一个账户操作，则此项应为委托账户的地址。更多详情请参阅 [委托权限](./how-to-guides-delegate-permissions.md) 指南。</x-field-desc>
+  </x-field>
+</x-field-group>
+
+### 返回值
+
+<x-field data-name="Promise<string>" data-type="Promise">
+  <x-field-desc markdown>一个 Promise，在成功提交到区块链后解析为交易哈希值。</x-field-desc>
+</x-field>
+
+## 分步示例
+
+### 先决条件
+
+在开始之前，请确保你已具备：
+
+1.  一个已初始化并连接到链主机（如 `https://beta.abtnetwork.io`）的 `GraphQLClient`。
+2.  一个发送方的钱包对象（`senderWallet`），其中有足够的通证用于支付转账和交易费用。
+3.  一个接收方的钱包对象（`recipientWallet`），用于获取其地址。接收方的账户无需事先在链上存在。
+
+```javascript Basic Setup icon=logos:javascript
+import GraphQLClient from '@ocap/client';
+import { fromRandom } from '@ocap/wallet';
+
+// 1. 初始化客户端
+const client = new GraphQLClient({ endpoint: 'https://beta.abtnetwork.io/api' });
+
+// 2. 为发送方和接收方创建钱包
+// 在实际应用中，发送方的钱包应是加载而来，而不是随机创建的。
+const senderWallet = fromRandom(); // 假设此钱包已有资金
+const recipientWallet = fromRandom();
+
+console.log(`发送方地址: ${senderWallet.address}`);
+console.log(`接收方地址: ${recipientWallet.address}`);
+
+// 要为此示例的发送方钱包充值，请使用水龙头：
+// https://faucet.abtnetwork.io/
+```
+
+### 示例 1：转移原生通证
+
+此示例展示了如何从发送方向接收方发送 10 个原生通证。
+
+```javascript Transfer Native Tokens icon=logos:javascript
+async function transferNativeTokens() {
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      token: 10, // 要发送的原生通证数量
+      wallet: senderWallet,
+      memo: '发送给你 10 个原生通证！'
+    });
+    console.log('原生通证转移成功。交易哈希:', hash);
+  } catch (err) {
+    console.error('转移通证时出错:', err);
+  }
+}
+
+transferNativeTokens();
+```
+
+### 示例 2：转移 NFT（资产）
+
+要转移一个 NFT，你需要其唯一的资产地址。首先，你需要创建或获取一个资产（参见 [管理资产 (NFTs)](./how-to-guides-manage-assets.md)）。在本例中，我们假设 `senderWallet` 已经拥有一个地址为 `zNKj...` 的 NFT。
+
+```javascript Transfer an NFT icon=logos:javascript
+async function transferNFT() {
+  // 假设这是 senderWallet 拥有的一个 NFT 的地址
+  const nftAddress = 'zNKjL4wTmxQPk5nN2ADDPCd58286b2de3f3e';
+
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      assets: [nftAddress], // 一个资产地址数组
+      wallet: senderWallet,
+      memo: '这是你想要的 NFT。'
+    });
+    console.log('NFT 转移成功。交易哈希:', hash);
+  } catch (err) {
+    console.error('转移 NFT 时出错:', err);
+  }
+}
+
+transferNFT();
+```
+
+### 示例 3：转移自定义通证
+
+此示例演示了如何转移自定义可替代通证。你需要该通证的合约地址。有关创建自定义通证的信息，请参阅 [管理通证](./how-to-guides-manage-tokens.md) 指南。
+
+```javascript Transfer Custom Tokens icon=logos:javascript
+async function transferCustomToken() {
+  // 假设这是 senderWallet 拥有的一个自定义通证的地址
+  const customTokenAddress = 'z37bA4x...'; 
+
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      wallet: senderWallet,
+      tokens: [
+        { address: customTokenAddress, value: 50 } // 50 个单位的自定义通证
+      ],
+      memo: '发送 50 个自定义通证。'
+    });
+    console.log('自定义通证转移成功。交易哈希:', hash);
+  } catch (err) {
+    console.error('转移自定义通证时出错:', err);
+  }
+}
+
+transferCustomToken();
+```
+
+### 示例 4：组合转移
+
+你可以在一个单一的原子交易中同时发送原生通证、自定义通证和多个 NFT。这是非常高效的。
+
+```javascript Combined Transfer icon=logos:javascript
+async function combinedTransfer() {
+  // 假设这些是 senderWallet 拥有的资产和通证的地址
+  const nftAddress1 = 'zNKjL4wTmxQPk5nN2ADDPCd58286b2de3f3e';
+  const nftAddress2 = 'zNKiabcdeQPk5nN2ADDPCd58286b2defghj';
+  const customTokenAddress = 'z37bA4x...'; // 自定义可替代通证的地址
+
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      wallet: senderWallet,
+      token: 5, // 5 个原生通证
+      assets: [nftAddress1, nftAddress2], // 包含两个 NFT 的数组
+      tokens: [
+        { address: customTokenAddress, value: 50 } // 50 个单位的自定义通证
+      ],
+      memo: '发送混合的通证和 NFT。'
+    });
+    console.log('组合转移成功。交易哈希:', hash);
+  } catch (err) {
+    console.error('组合转移时出错:', err);
+  }
+}
+
+combinedTransfer();
+```
+
+通过遵循这些示例，你可以轻松地在你的应用程序中实现通证和 NFT 的转移。有关创建你希望转移的项目的更多详细信息，请参阅相关指南。
+
+### 拓展阅读
+
+- [如何管理资产 (NFTs)](./how-to-guides-manage-assets.md)
+- [如何管理通证](./how-to-guides-manage-tokens.md)
+- [高级 API](./api-reference-transaction-helpers.md)

package/docs/how-to-guides.ja.md

@@ -0,0 +1,27 @@
+# ハウツーガイド
+
+このセクションでは、OCAP Clientを使用して一般的なタスクを完了するための実践的でステップバイステップの手順を説明します。各ガイドは、アカウントの管理から複雑なアトミックスワップの実行まで、特定の目標を達成するのに役立つ自己完結型のレシピとして設計されています。
+
+<x-cards data-columns="2">
+  <x-card data-title="アカウントの管理" data-href="/how-to-guides/manage-accounts" data-icon="lucide:user-cog">
+    アカウントを新しいキーに移行するなど、アカウント関連の操作について説明します。
+  </x-card>
+  <x-card data-title="権限の委任" data-href="/how-to-guides/delegate-permissions" data-icon="lucide:key-round">
+    あなたに代わってトランザクションを送信するために別のアカウントを承認する方法を示し、許可されるアクションを指定します。
+  </x-card>
+  <x-card data-title="トークンとNFTの転送" data-href="/how-to-guides/transfer-tokens-and-nfts" data-icon="lucide:arrow-right-left">
+    ファンジブルトークンとノンファンジブルトークン(アセット)をアカウント間で転送するためのステップバイステップガイドを提供します。
+  </x-card>
+  <x-card data-title="アセット(NFT)の管理" data-href="/how-to-guides/manage-assets" data-icon="lucide:gem">
+    ファクトリーからのアセットの作成、更新、取得など、ノンファンジブルトークンの完全なライフサイクルを解説します。
+  </x-card>
+  <x-card data-title="トークンの管理" data-href="/how-to-guides/manage-tokens" data-icon="lucide:coins">
+    トークンファクトリーからトークンをミントおよびバーンするなどのファンジブルトークン操作の実行方法を説明します。
+  </x-card>
+  <x-card data-title="トークンとアセットのステーク" data-href="/how-to-guides/stake-tokens-and-assets" data-icon="lucide:piggy-bank">
+    トークンやアセットをレシーバーにステークする方法、ステークの取り消しや請求を含むステップバイステップガイドです。
+  </x-card>
+  <x-card data-title="アトミックスワップの実行" data-href="/how-to-guides/perform-atomic-swaps" data-icon="lucide:repeat">
+    マルチシグネチャトランザクションを使用して、2つの当事者間でトークンとアセットを安全に交換する方法に関するガイドです。
+  </x-card>
+</x-cards>

package/docs/how-to-guides.md

@@ -0,0 +1,27 @@
+# How-to Guides
+
+This section provides practical, step-by-step instructions for completing common tasks with the OCAP Client. Each guide is designed as a self-contained recipe to help you accomplish a specific goal, from managing accounts to performing complex atomic swaps.
+
+<x-cards data-columns="2">
+  <x-card data-title="Manage Accounts" data-href="/how-to-guides/manage-accounts" data-icon="lucide:user-cog">
+    Covers account-related operations such as migrating an account to new keys.
+  </x-card>
+  <x-card data-title="Delegate Permissions" data-href="/how-to-guides/delegate-permissions" data-icon="lucide:key-round">
+    Shows how to authorize another account to send transactions on your behalf, specifying which actions are permitted.
+  </x-card>
+  <x-card data-title="Transfer Tokens and NFTs" data-href="/how-to-guides/transfer-tokens-and-nfts" data-icon="lucide:arrow-right-left">
+    Provides a step-by-step guide on transferring fungible tokens and non-fungible tokens (assets) between accounts.
+  </x-card>
+  <x-card data-title="Manage Assets (NFTs)" data-href="/how-to-guides/manage-assets" data-icon="lucide:gem">
+    Walks through the complete lifecycle of Non-Fungible Tokens, including creation, updating, and acquiring assets from a factory.
+  </x-card>
+  <x-card data-title="Manage Tokens" data-href="/how-to-guides/manage-tokens" data-icon="lucide:coins">
+    Explains how to perform fungible token operations like minting and burning tokens from a token factory.
+  </x-card>
+  <x-card data-title="Stake Tokens and Assets" data-href="/how-to-guides/stake-tokens-and-assets" data-icon="lucide:piggy-bank">
+    A step-by-step guide on how to stake tokens or assets to a receiver, including revoking and claiming stakes.
+  </x-card>
+  <x-card data-title="Perform Atomic Swaps" data-href="/how-to-guides/perform-atomic-swaps" data-icon="lucide:repeat">
+    A guide on how to securely exchange tokens and assets between two parties using a multi-signature transaction.
+  </x-card>
+</x-cards>

package/docs/how-to-guides.zh-TW.md

@@ -0,0 +1,27 @@
+# 操作指南
+
+本節提供使用 OCAP 用戶端完成常見任務的實用、逐步說明。每個指南都設計成一個獨立的方案，幫助您完成特定目標，從管理帳戶到執行複雜的原子交換。
+
+<x-cards data-columns="2">
+  <x-card data-title="管理帳戶" data-href="/how-to-guides/manage-accounts" data-icon="lucide:user-cog">
+    涵蓋與帳戶相關的操作，例如將帳戶遷移到新的金鑰。
+  </x-card>
+  <x-card data-title="委派權限" data-href="/how-to-guides/delegate-permissions" data-icon="lucide:key-round">
+    展示如何授權另一個帳戶代表您發送交易，並指定允許的操作。
+  </x-card>
+  <x-card data-title="轉移代幣和 NFT" data-href="/how-to-guides/transfer-tokens-and-nfts" data-icon="lucide:arrow-right-left">
+    提供在帳戶之間轉移同質化代幣和非同質化代幣（資產）的逐步指南。
+  </x-card>
+  <x-card data-title="管理資產（NFT）" data-href="/how-to-guides/manage-assets" data-icon="lucide:gem">
+    詳細介紹非同質化代幣的完整生命週期，包括從工廠創建、更新和獲取資產。
+  </x-card>
+  <x-card data-title="管理代幣" data-href="/how-to-guides/manage-tokens" data-icon="lucide:coins">
+    解釋如何執行同質化代幣操作，例如從代幣工廠鑄造和銷毀代幣。
+  </x-card>
+  <x-card data-title="質押代幣和資產" data-href="/how-to-guides/stake-tokens-and-assets" data-icon="lucide:piggy-bank">
+    關於如何將代幣或資產質押給接收者的逐步指南，包括撤銷和領取質押。
+  </x-card>
+  <x-card data-title="執行原子交換" data-href="/how-to-guides/perform-atomic-swaps" data-icon="lucide:repeat">
+    關於如何使用多重簽名交易在兩方之間安全交換代幣和資產的指南。
+  </x-card>
+</x-cards>

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

@@ -0,0 +1,27 @@
+# 操作指南
+
+本节提供了使用 OCAP Client 完成常见任务的实用、分步说明。每个指南都设计成一个独立的方案，帮助您完成特定目标，从管理账户到执行复杂的原子交换。
+
+<x-cards data-columns="2">
+  <x-card data-title="管理账户" data-href="/how-to-guides/manage-accounts" data-icon="lucide:user-cog">
+    涵盖与账户相关的操作，例如将账户迁移到新密钥。
+  </x-card>
+  <x-card data-title="委托权限" data-href="/how-to-guides/delegate-permissions" data-icon="lucide:key-round">
+    展示了如何授权另一个账户代表您发送交易，并指定允许的操作。
+  </x-card>
+  <x-card data-title="转移通证和 NFT" data-href="/how-to-guides/transfer-tokens-and-nfts" data-icon="lucide:arrow-right-left">
+    提供了在账户之间转移同质化通证和非同质化通证（资产）的分步指南。
+  </x-card>
+  <x-card data-title="管理资产 (NFT)" data-href="/how-to-guides/manage-assets" data-icon="lucide:gem">
+    逐步介绍非同质化通证的完整生命周期，包括创建、更新以及从工厂获取资产。
+  </x-card>
+  <x-card data-title="管理通证" data-href="/how-to-guides/manage-tokens" data-icon="lucide:coins">
+    解释了如何执行同质化通证操作，例如从通证工厂铸造和销毁通证。
+  </x-card>
+  <x-card data-title="质押通证和资产" data-href="/how-to-guides/stake-tokens-and-assets" data-icon="lucide:piggy-bank">
+    关于如何将通证或资产质押给接收者的分步指南，包括撤销和领取质押。
+  </x-card>
+  <x-card data-title="执行原子交换" data-href="/how-to-guides/perform-atomic-swaps" data-icon="lucide:repeat">
+    关于如何使用多重签名交易在两方之间安全交换通证和资产的指南。
+  </x-card>
+</x-cards>