@ocap/client 1.25.3 → 1.25.5

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

@@ -0,0 +1,205 @@
+# 質押代幣與資產
+
+質押是將代幣或資產 (NFTs) 鎖定給特定接收者的過程，通常是為了保護網路、參與治理或賺取獎勵。本指南使用 OCAP Client，提供整個質押生命週期的逐步演練，包括創建質押、撤銷質押、領回資產，以及因懲罰性原因削減質押。
+
+此過程涉及幾個關鍵方法：
+- `stake()`: 用於創建一個新的質押。
+- `revokeStake()`: 用於啟動撤回您已質押物品的過程。
+- `claimStake()`: 用於完成撤回並將物品返還至您的帳戶。
+- `slashStake()`: 用於允許授權方懲罰質押者。
+
+## 如何質押
+
+首先，您使用 `stake` 方法來鎖定您的代幣或資產。此操作會在鏈上創建一個新的、唯一的質押地址，該地址持有您質押的物品及管理它們的規則。
+
+### 參數
+
+<x-field-group>
+  <x-field data-name="to" data-type="string" data-required="true" data-desc="將接收質押的帳戶的 DID 地址。"></x-field>
+  <x-field data-name="assets" data-type="string[]" data-required="false" data-desc="要質押的資產地址 (NFTs) 陣列。"></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>
+  <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="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>
+
+### 範例
+
+```javascript 質押代幣與資產 icon=logos:javascript
+// 假設 'client' 是一個已初始化的 GraphQLClient 實例
+// 且 'stakerWallet' 是一個有效的錢包物件。
+const receiverAddress = 'z29d5852576b8a8b6f3a8b4b74a3f4a3e2e1d'; // 質押接收者的地址
+
+async function createStake() {
+  try {
+    const [txHash, stakeAddress] = await client.stake({
+      to: receiverAddress,
+      tokens: [{
+        address: 'z35n6aTUTK8h5nAF43h21A1g84g3C3D7B5E', // 要質押的代幣地址
+        value: 100, // 要質押的代幣數量
+      }],
+      assets: ['zNKtA1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6'], // 要質押的資產/NFT 地址
+      message: '為驗證者獎勵而質押',
+      wallet: stakerWallet,
+    });
+
+    console.log('質押交易已發送：', txHash);
+    console.log('已創建新的質押地址：', stakeAddress);
+    return stakeAddress;
+  } catch (error) {
+    console.error('創建質押時發生錯誤：', error);
+  }
+}
+```
+
+### 返回值
+
+`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="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>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="質押者的錢包物件，必須是質押的原始創建者。"></x-field>
+</x-field-group>
+
+### 範例
+
+```javascript 撤銷質押 icon=logos:javascript
+// 假設 'stakeAddress' 是上一步返回的地址
+// 且 'stakerWallet' 是用於創建質押的同一個錢包。
+
+async function revokeExistingStake(stakeAddress) {
+  try {
+    const revokeTxHash = await client.revokeStake({
+      from: stakeAddress,
+      tokens: [{
+        address: 'z35n6aTUTK8h5nAF43h21A1g84g3C3D7B5E',
+        value: 100,
+      }],
+      assets: ['zNKtA1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6'],
+      wallet: stakerWallet,
+    });
+
+    console.log('撤銷質押交易已發送：', revokeTxHash);
+    console.log('重要：請保存此雜湊值，以便稍後領取您的質押。');
+    return revokeTxHash;
+  } catch (error) {
+    console.error('撤銷質押時發生錯誤：', error);
+  }
+}
+```
+
+### 返回值
+
+此函數會返回撤銷操作的交易雜湊值。此雜湊值可作為證據，並且是領取質押最終步驟的**必要**條件。
+
+---
+
+## 如何領取已撤銷的質押
+
+質押成功撤銷後，質押者必須發送一筆 `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="wallet" data-type="WalletObject" data-required="true" data-desc="質押者的錢包物件。"></x-field>
+</x-field-group>
+
+### 範例
+
+```javascript 領取已質押的物品 icon=logos:javascript
+// 假設 'stakeAddress' 和 'revokeTxHash' 來自之前的步驟，
+// 且 'stakerWallet' 是質押者的錢包。
+
+async function claimRevokedStake(stakeAddress, revokeTxHash) {
+  try {
+    const claimTxHash = await client.claimStake({
+      from: stakeAddress,
+      evidence: revokeTxHash,
+      wallet: stakerWallet,
+    });
+
+    console.log('領取質押交易已發送：', claimTxHash);
+    console.log('您的代幣和資產已返還至您的帳戶。');
+  } catch (error) {
+    console.error('領取質押時發生錯誤：', error);
+  }
+}
+```
+
+### 返回值
+
+此方法會返回最終的交易雜湊值。一旦此交易在鏈上得到確認，質押的物品就會返還至 `wallet` 的地址。
+
+---
+
+## 如何削減質押
+
+削減是由指定的 `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="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="wallet" data-type="WalletObject" data-required="true" data-desc="授權削減者的錢包物件。"></x-field>
+</x-field-group>
+
+### 範例
+
+```javascript 削減質押 icon=logos:javascript
+// 假設 'stakeAddress' 是要削減的質押地址，
+// 且 'slasherWallet' 是一個授權削減者的錢包。
+
+async function slashExistingStake(stakeAddress) {
+  try {
+    const slashTxHash = await client.slashStake({
+      from: stakeAddress,
+      reason: '驗證者錯過了連續 10 個區塊的簽署。',
+      tokens: [{
+        address: 'z35n6aTUTK8h5nAF43h21A1g84g3C3D7B5E',
+        value: 10, // 作為懲罰削減 10 個代幣
+      }],
+      wallet: slasherWallet,
+    });
+
+    console.log('削減質押交易已發送：', slashTxHash);
+  } catch (error) {
+    console.error('削減質押時發生錯誤：', error);
+  }
+}
+```
+
+### 返回值
+
+此方法會返回削減操作的交易雜湊值。
+
+## 總結
+
+您現在已經學會了在 OCAP 區塊鏈上質押的完整生命週期：使用 `stake` 創建質押，使用 `revokeStake` 和 `claimStake` 取回資金，以及使用 `slashStake` 懲罰不良行為者。這個強大的機制是許多去中心化應用的基礎。
+
+要了解更多關於您可以質押的物品，請參閱 [管理代幣](./how-to-guides-manage-tokens.md) 和 [管理資產 (NFTs)](./how-to-guides-manage-assets.md) 指南。

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

@@ -0,0 +1,205 @@
+# 质押通证和资产
+
+质押是将通证或资产 (NFT) 锁定到特定接收者的过程，通常是为了保护网络、参与治理或赚取奖励。本指南使用 OCAP Client 提供了整个质押生命周期的分步演练，包括创建质押、撤销质押、领回资产以及因惩罚原因而削减质押。
+
+此过程涉及几个关键方法：
+- `stake()`: 创建新的质押。
+- `revokeStake()`: 启动撤回已质押物品的过程。
+- `claimStake()`: 完成撤回并将物品返还到您的账户。
+- `slashStake()`: 允许授权方惩罚质押者。
+
+## 如何质押
+
+首先，您使用 `stake` 方法来锁定您的通证或资产。此操作会在链上创建一个新的、唯一的质押地址，该地址持有您质押的物品及管理它们的规则。
+
+### 参数
+
+<x-field-group>
+  <x-field data-name="to" data-type="string" data-required="true" data-desc="将接收质押的账户的 DID 地址。"></x-field>
+  <x-field data-name="assets" data-type="string[]" data-required="false" data-desc="要质押的资产地址 (NFT) 数组。"></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>
+  <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="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>
+
+### 示例
+
+```javascript 质押通证和资产 icon=logos:javascript
+// 假设 'client' 是一个已初始化的 GraphQLClient 实例
+// 且 'stakerWallet' 是一个有效的钱包对象。
+const receiverAddress = 'z29d5852576b8a8b6f3a8b4b74a3f4a3e2e1d'; // 质押接收者的地址
+
+async function createStake() {
+  try {
+    const [txHash, stakeAddress] = await client.stake({
+      to: receiverAddress,
+      tokens: [{
+        address: 'z35n6aTUTK8h5nAF43h21A1g84g3C3D7B5E', // 要质押的通证地址
+        value: 100, // 要质押的通证数量
+      }],
+      assets: ['zNKtA1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6'], // 要质押的资产/NFT 的地址
+      message: '为验证者奖励而质押',
+      wallet: stakerWallet,
+    });
+
+    console.log('质押交易已发送：', txHash);
+    console.log('新质押地址已创建：', stakeAddress);
+    return stakeAddress;
+  } catch (error) {
+    console.error('创建质押时出错：', error);
+  }
+}
+```
+
+### 返回值
+
+`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="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>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="质押者的钱包对象，必须是质押的原始创建者。"></x-field>
+</x-field-group>
+
+### 示例
+
+```javascript 撤销质押 icon=logos:javascript
+// 假设 'stakeAddress' 是上一步返回的地址
+// 且 'stakerWallet' 是用于创建质押的同一个钱包。
+
+async function revokeExistingStake(stakeAddress) {
+  try {
+    const revokeTxHash = await client.revokeStake({
+      from: stakeAddress,
+      tokens: [{
+        address: 'z35n6aTUTK8h5nAF43h21A1g84g3C3D7B5E',
+        value: 100,
+      }],
+      assets: ['zNKtA1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6'],
+      wallet: stakerWallet,
+    });
+
+    console.log('撤销质押交易已发送：', revokeTxHash);
+    console.log('重要提示：请保存此哈希以便稍后申领您的质押。');
+    return revokeTxHash;
+  } catch (error) {
+    console.error('撤销质押时出错：', error);
+  }
+}
+```
+
+### 返回值
+
+此函数返回撤销操作的交易哈希。此哈希作为凭证，并且是申领质押的最后一步所**必需**的。
+
+---
+
+## 如何申领已撤销的质押
+
+成功撤销质押后，质押者必须发送一个 `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="wallet" data-type="WalletObject" data-required="true" data-desc="质押者的钱包对象。"></x-field>
+</x-field-group>
+
+### 示例
+
+```javascript 申领已质押的物品 icon=logos:javascript
+// 假设 'stakeAddress' 和 'revokeTxHash' 来自之前的步骤，
+// 且 'stakerWallet' 是质押者的钱包。
+
+async function claimRevokedStake(stakeAddress, revokeTxHash) {
+  try {
+    const claimTxHash = await client.claimStake({
+      from: stakeAddress,
+      evidence: revokeTxHash,
+      wallet: stakerWallet,
+    });
+
+    console.log('申领质押交易已发送：', claimTxHash);
+    console.log('您的通证和资产已返回到您的账户。');
+  } catch (error) {
+    console.error('申领质押时出错：', error);
+  }
+}
+```
+
+### 返回值
+
+该方法返回最终的交易哈希。一旦此交易在链上确认，质押的物品将返回到 `wallet` 的地址。
+
+---
+
+## 如何惩罚质押
+
+惩罚（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="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="wallet" data-type="WalletObject" data-required="true" data-desc="授权惩罚者的钱包对象。"></x-field>
+</x-field-group>
+
+### 示例
+
+```javascript 惩罚质押 icon=logos:javascript
+// 假设 'stakeAddress' 是要惩罚的质押地址，
+// 且 'slasherWallet' 是授权惩罚者的钱包。
+
+async function slashExistingStake(stakeAddress) {
+  try {
+    const slashTxHash = await client.slashStake({
+      from: stakeAddress,
+      reason: '验证者连续错过 10 个区块的签名。',
+      tokens: [{
+        address: 'z35n6aTUTK8h5nAF43h21A1g84g3C3D7B5E',
+        value: 10, // 惩罚 10 个通证作为罚款
+      }],
+      wallet: slasherWallet,
+    });
+
+    console.log('惩罚质押交易已发送：', slashTxHash);
+  } catch (error) {
+    console.error('惩罚质押时出错：', error);
+  }
+}
+```
+
+### 返回值
+
+此方法返回惩罚操作的交易哈希。
+
+## 总结
+
+您现在已经学习了在 OCAP 区块链上进行质押的完整生命周期：使用 `stake` 创建质押，使用 `revokeStake` 和 `claimStake` 取回资金，以及使用 `slashStake` 惩罚不良行为者。这个强大的机制是许多去中心化应用的基础。
+
+要了解有关可以质押的物品的更多信息，请参阅 [管理通证](./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)