@ocap/client 1.25.4 → 1.25.6

package/docs/how-to-guides-stake-tokens-and-assets.zh.md

@@ -1,12 +1,12 @@
 # 质押通证和资产
 
-质押是将通证或资产 (NFT) 锁定到特定接收者的过程，通常是为了保护网络、参与治理或赚取奖励。本指南使用 OCAP Client 提供了整个质押生命周期的分步演练，包括创建质押、撤销质押、领回资产以及因惩罚性原因罚没质押。
+质押是将通证或资产 (NFT) 锁定到特定接收者的过程，通常是为了保护网络、参与治理或赚取奖励。本指南使用 OCAP Client 提供了整个质押生命周期的分步演练，包括创建质押、撤销质押、领回资产以及因惩罚原因而削减质押。
 
 此过程涉及几个关键方法：
-- `stake()`：创建一个新的质押。
-- `revokeStake()`：启动撤回已质押物品的过程。
-- `claimStake()`：完成撤回并将物品返还到您的账户。
-- `slashStake()`：允许授权方惩罚质押者。
+- `stake()`: 创建新的质押。
+- `revokeStake()`: 启动撤回已质押物品的过程。
+- `claimStake()`: 完成撤回并将物品返还到您的账户。
+- `slashStake()`: 允许授权方惩罚质押者。
 
 ## 如何质押
 
@@ -23,7 +23,7 @@
   </x-field>
   <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="质押者的钱包对象。"></x-field>
   <x-field data-name="locked" data-type="boolean" data-default="false" data-required="false" data-desc="一个布尔值，指示质押在创建时是否被锁定。"></x-field>
-  <x-field data-name="slashers" data-type="string[]" data-required="false" data-desc="允许罚没此质押的 DID 地址数组。如果未提供，则默认为接收者地址。"></x-field>
+  <x-field data-name="slashers" data-type="string[]" data-required="false" data-desc="允许惩罚此质押的 DID 地址数组。如果未提供，则默认为接收者的地址。"></x-field>
   <x-field data-name="message" data-type="string" data-required="false" data-desc="质押的可选备注或消息。"></x-field>
   <x-field data-name="nonce" data-type="string" data-required="false" data-desc="一个可选的 nonce，以确保质押地址是唯一的。"></x-field>
 </x-field-group>
@@ -32,7 +32,7 @@
 
 ```javascript 质押通证和资产 icon=logos:javascript
 // 假设 'client' 是一个已初始化的 GraphQLClient 实例
-// 并且 'stakerWallet' 是一个有效的钱包对象。
+// 且 'stakerWallet' 是一个有效的钱包对象。
 const receiverAddress = 'z29d5852576b8a8b6f3a8b4b74a3f4a3e2e1d'; // 质押接收者的地址
 
 async function createStake() {
@@ -43,35 +43,35 @@ async function createStake() {
         address: 'z35n6aTUTK8h5nAF43h21A1g84g3C3D7B5E', // 要质押的通证地址
         value: 100, // 要质押的通证数量
       }],
-      assets: ['zNKtA1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6'], // 要质押的资产/NFT 地址
+      assets: ['zNKtA1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6'], // 要质押的资产/NFT 的地址
       message: '为验证者奖励而质押',
       wallet: stakerWallet,
     });
 
-    console.log('质押交易已发送:', txHash);
-    console.log('新的质押地址已创建:', stakeAddress);
+    console.log('质押交易已发送：', txHash);
+    console.log('新质押地址已创建：', stakeAddress);
     return stakeAddress;
   } catch (error) {
-    console.error('创建质押时出错:', error);
+    console.error('创建质押时出错：', error);
   }
 }
 ```
 
 ### 返回值
 
-`stake` 方法返回一个包含交易哈希和新创建的 `stakeAddress` 的元组。此地址对于未来与此特定质押的所有交互（例如撤销或罚没）都至关重要。
+`stake` 方法返回一个包含交易哈希和新创建的 `stakeAddress` 的元组。此地址对于未来与此特定质押的所有交互（例如撤销或惩罚）至关重要。
 
 ---
 
 ## 如何撤销质押
 
-撤销质押是质押者为取回其锁定的通证和资产而发起的过程。此交易不会立即返还资金；相反，它会将资金标记为可领取，但需遵守任何链上锁定期。
+撤销质押是质押者为取回其锁定的通证和资产而发起的过程。此交易不会立即返还资金；相反，它会将它们标记为可申领，并受任何链上锁定期限制。
 
 ### 参数
 
 <x-field-group>
   <x-field data-name="from" data-type="string" data-required="true" data-desc="要撤销的质押地址（从 'stake' 调用中获取）。"></x-field>
-  <x-field data-name="assets" data-type="string[]" data-required="false" data-desc="要从质押中撤销的资产地址数组。"></x-field>
+  <x-field data-name="assets" data-type="string[]" data-required="false" data-desc="从质押中撤销的资产地址数组。"></x-field>
   <x-field data-name="tokens" data-type="object[]" data-required="false" data-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>
@@ -83,7 +83,7 @@ async function createStake() {
 
 ```javascript 撤销质押 icon=logos:javascript
 // 假设 'stakeAddress' 是上一步返回的地址
-// 并且 'stakerWallet' 是用于创建质押的同一个钱包。
+// 且 'stakerWallet' 是用于创建质押的同一个钱包。
 
 async function revokeExistingStake(stakeAddress) {
   try {
@@ -97,38 +97,38 @@ async function revokeExistingStake(stakeAddress) {
       wallet: stakerWallet,
     });
 
-    console.log('撤销质押交易已发送:', revokeTxHash);
-    console.log('重要提示：请保存此哈希值，以便稍后领取您的质押。');
+    console.log('撤销质押交易已发送：', revokeTxHash);
+    console.log('重要提示：请保存此哈希以便稍后申领您的质押。');
     return revokeTxHash;
   } catch (error) {
-    console.error('撤销质押时出错:', error);
+    console.error('撤销质押时出错：', error);
   }
 }
 ```
 
 ### 返回值
 
-此函数返回撤销操作的交易哈希。此哈希作为证据，并且是领取质押的最后一步所**必需**的。
+此函数返回撤销操作的交易哈希。此哈希作为凭证，并且是申领质押的最后一步所**必需**的。
 
 ---
 
-## 如何领取已撤销的质押
+## 如何申领已撤销的质押
 
-在质押成功撤销后，质押者必须发送一个 `claimStake` 交易，才能将通证和资产移回其账户。这标志着撤回过程的最终完成。
+成功撤销质押后，质押者必须发送一个 `claimStake` 交易，将通证和资产移回其账户。这会完成提款过程。
 
 ### 参数
 
 <x-field-group>
   <x-field data-name="from" data-type="string" data-required="true" data-desc="质押的地址。"></x-field>
-  <x-field data-name="evidence" data-type="string" data-required="true" data-desc="来自 'revokeStake' 调用的交易哈希，用作撤销证明。"></x-field>
+  <x-field data-name="evidence" data-type="string" data-required="true" data-desc="来自 'revokeStake' 调用的交易哈希，作为撤销的证明。"></x-field>
   <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="质押者的钱包对象。"></x-field>
 </x-field-group>
 
 ### 示例
 
-```javascript 领取已质押的物品 icon=logos:javascript
+```javascript 申领已质押的物品 icon=logos:javascript
 // 假设 'stakeAddress' 和 'revokeTxHash' 来自之前的步骤，
-// 并且 'stakerWallet' 是质押者的钱包。
+// 且 'stakerWallet' 是质押者的钱包。
 
 async function claimRevokedStake(stakeAddress, revokeTxHash) {
   try {
@@ -138,42 +138,42 @@ async function claimRevokedStake(stakeAddress, revokeTxHash) {
       wallet: stakerWallet,
     });
 
-    console.log('领取质押交易已发送:', claimTxHash);
+    console.log('申领质押交易已发送：', claimTxHash);
     console.log('您的通证和资产已返回到您的账户。');
   } catch (error) {
-    console.error('领取质押时出错:', error);
+    console.error('申领质押时出错：', error);
   }
 }
 ```
 
 ### 返回值
 
-该方法返回最终的交易哈希。一旦该交易在链上得到确认，质押的物品将返还到 `wallet` 的地址。
+该方法返回最终的交易哈希。一旦此交易在链上确认，质押的物品将返回到 `wallet` 的地址。
 
 ---
 
-## 如何罚没质押
+## 如何惩罚质押
 
-罚没是一种惩罚性操作，可由指定的 `slasher`（通常是质押接收者）对质押者采取。这通常发生在质押者违反某些规则的情况下。被罚没的通证或资产将从质押中移除，并发送到指定的保险库。
+惩罚（Slashing）是一种惩罚性行为，可由指定的 `slasher`（通常是质押接收者）对质押者采取。这通常发生在质押者违反某些规则的情况下。被惩罚的通证或资产将从质押中移除并发送到指定的金库。
 
 ### 参数
 
 <x-field-group>
-  <x-field data-name="from" data-type="string" data-required="true" data-desc="要被罚没的质押地址。"></x-field>
-  <x-field data-name="reason" data-type="string" data-required="true" data-desc="一条强制性消息，解释罚没发生的原因。"></x-field>
-  <x-field data-name="assets" data-type="string[]" data-required="false" data-desc="要从质押中罚没的资产地址数组。"></x-field>
-  <x-field data-name="tokens" data-type="object[]" data-required="false" data-desc="要罚没的通证对象数组。">
+  <x-field data-name="from" data-type="string" data-required="true" data-desc="要惩罚的质押地址。"></x-field>
+  <x-field data-name="reason" data-type="string" data-required="true" data-desc="一条强制性消息，解释发生惩罚的原因。"></x-field>
+  <x-field data-name="assets" data-type="string[]" data-required="false" data-desc="从质押中惩罚的资产地址数组。"></x-field>
+  <x-field data-name="tokens" data-type="object[]" data-required="false" data-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 data-name="value" data-type="number" data-required="true" data-desc="要惩罚的通证数量。"></x-field>
   </x-field>
-  <x-field data-name="wallet" data-type="WalletObject" 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>
 
 ### 示例
 
-```javascript 罚没质押 icon=logos:javascript
-// 假设 'stakeAddress' 是要被罚没的质押地址，
-// 并且 'slasherWallet' 是授权罚没者的钱包。
+```javascript 惩罚质押 icon=logos:javascript
+// 假设 'stakeAddress' 是要惩罚的质押地址，
+// 且 'slasherWallet' 是授权惩罚者的钱包。
 
 async function slashExistingStake(stakeAddress) {
   try {
@@ -182,24 +182,24 @@ async function slashExistingStake(stakeAddress) {
       reason: '验证者连续错过 10 个区块的签名。',
       tokens: [{
         address: 'z35n6aTUTK8h5nAF43h21A1g84g3C3D7B5E',
-        value: 10, // 罚没 10 个通证作为惩罚
+        value: 10, // 惩罚 10 个通证作为罚款
       }],
       wallet: slasherWallet,
     });
 
-    console.log('罚没质押交易已发送:', slashTxHash);
+    console.log('惩罚质押交易已发送：', slashTxHash);
   } catch (error) {
-    console.error('罚没质押时出错:', error);
+    console.error('惩罚质押时出错：', error);
   }
 }
 ```
 
 ### 返回值
 
-此方法返回罚没操作的交易哈希。
+此方法返回惩罚操作的交易哈希。
 
 ## 总结
 
-现在您已经学习了在 OCAP 区块链上质押的完整生命周期：使用 `stake` 创建质押，使用 `revokeStake` 和 `claimStake` 取回资金，以及使用 `slashStake` 惩罚不良行为者。这个强大的机制是许多去中心化应用的基础。
+您现在已经学习了在 OCAP 区块链上进行质押的完整生命周期：使用 `stake` 创建质押，使用 `revokeStake` 和 `claimStake` 取回资金，以及使用 `slashStake` 惩罚不良行为者。这个强大的机制是许多去中心化应用的基础。
 
-要了解更多关于您可以质押的物品的信息，请参阅[管理通证](./how-to-guides-manage-tokens.md)和[管理资产 (NFT)](./how-to-guides-manage-assets.md)指南。
+要了解有关可以质押的物品的更多信息，请参阅 [管理通证](./how-to-guides-manage-tokens.md) 和 [管理资产 (NFT)](./how-to-guides-manage-assets.md) 指南。

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

@@ -0,0 +1,179 @@
+# トークンとNFTの転送
+
+このガイドでは、OCAP Clientを使用して、アカウント間でファンジブルトークン（ネイティブおよびカスタムの両方）とノンファンジブルトークン（NFTまたは資産）を転送する手順を段階的に説明します。すべての転送の主要なメソッドは `client.transfer()` です。
+
+覚えておくべき重要な特徴の1つは、新しいアカウントが最初の受信トランザクションを受け取ると、自動的にオンチェーンで作成されることです。これは、受信者の事前設定なしで、全く新しいアドレスにトークンや資産を転送できることを意味します。
+
+## `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` が別のアカウントの代理として機能している場合、これは委任元アカウントのアドレスである必要があります。詳細については、[Delegate Permissions](./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}`);
+
+// この例のために送信者のウォレットに資金を入金するには、faucetを使用してください:
+// 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('ネイティブトークンの転送に成功しました。Txハッシュ:', 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の転送に成功しました。Txハッシュ:', 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('カスタムトークンの転送に成功しました。Txハッシュ:', 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], // 2つのNFTの配列
+      tokens: [
+        { address: customTokenAddress, value: 50 } // 50単位のカスタムトークン
+      ],
+      memo: 'トークンとNFTのミックスを送ります。'
+    });
+    console.log('組み合わせた転送に成功しました。Txハッシュ:', 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-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)