@ocap/client 1.25.4 → 1.25.6

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

@@ -0,0 +1,167 @@
+# 権限の委任
+
+権限の委任は、あるアカウント（委任者）が別のアカウント（被委任者）に、自身に代わって特定の種類のトランザクションを送信することを許可する強力な機能です。これは、ユーザーの主要な秘密鍵に直接アクセスすることなく、ユーザーのためにアクションを実行する必要があるアプリケーションにとって特に便利です。例えば、特定の資産を転送したり、スマートコントラクトと対話したりする権限をアプリケーション固有のキーに委任することで、キーの権限範囲を制限し、セキュリティを向上させることができます。
+
+このガイドでは、委任の付与、使用、取り消しの手順を説明します。
+
+## 委任の付与
+
+別のアカウントを認可するには、`delegate` メソッドを使用します。誰に委任するのか、そして彼らが送信を許可される特定のトランザクションタイプを指定する必要があります。各権限には、どのトークンや資産が関与できるかなどの制限を設けることもできます。
+
+### パラメータ
+
+<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 data-name="privileges" data-type="Array<object>" data-required="true">
+    <x-field-desc markdown>付与する権限オブジェクトの配列。各オブジェクトは特定の認可を定義します。</x-field-desc>
+    <x-field data-name="typeUrl" data-type="string" data-required="true">
+      <x-field-desc markdown>許可されるトランザクションのタイプ URL（例：`fg:t:transfer_v2`）。</x-field-desc>
+    </x-field>
+    <x-field data-name="limit" data-type="object" data-required="false">
+      <x-field-desc markdown>権限に対するオプションの制限。特定のトークンや資産に制限するなど。</x-field-desc>
+      <x-field data-name="tokens" data-type="Array<string>" data-required="false" data-desc="この権限が適用されるトークンアドレスの配列。"></x-field>
+      <x-field data-name="assets" data-type="Array<string>" data-required="false" data-desc="この権限が適用される資産アドレスの配列。"></x-field>
+    </x-field>
+  </x-field>
+</x-field-group>
+
+### 戻り値
+
+<x-field data-name="result" data-type="Promise<[string, string]>" data-desc="トランザクションハッシュと新しく作成された委任アドレスを含む配列に解決される Promise。"></x-field>
+
+### 例
+
+あるアカウントから別のアカウントに `transfer` 権限を委任する方法は次のとおりです。
+
+```javascript 転送権限の付与 icon=logos:javascript
+import Client from '@ocap/client';
+import { fromRandom } from '@ocap/wallet';
+import { typeUrls } from '@ocap/proto';
+
+const client = new Client('https://beta.abtnetwork.io/api');
+
+// 権限を付与するアカウント
+const delegatorWallet = fromRandom();
+
+// 権限を受け取るアカウント
+const delegateeWallet = fromRandom();
+
+async function grantPermission() {
+  try {
+    // まず、委任者アカウントに資金があることを確認します。
+    // 実際のアプリケーションでは、faucet や別のアカウントから
+    // delegatorWallet.address に資金を送金します。
+    console.log(`Delegator address: ${delegatorWallet.address}`);
+    console.log(`Delegatee address: ${delegateeWallet.address}`);
+    console.log('Please fund the delegator account before proceeding.');
+
+    const privileges = [
+      {
+        typeUrl: typeUrls.TransferV2Tx,
+        // 制限は指定されておらず、任意のトークン/資産の転送を許可します
+        limit: { tokens: [], assets: [] },
+      },
+    ];
+
+    const [hash, delegateAddress] = await client.delegate({
+      from: delegatorWallet,
+      to: delegateeWallet,
+      privileges: privileges,
+    });
+
+    console.log('Delegation successful!');
+    console.log('Transaction Hash:', hash);
+    console.log('Delegate Address:', delegateAddress);
+  } catch (error) {
+    console.error('Error delegating permissions:', error);
+  }
+}
+
+grantPermission();
+```
+
+## 被委任者としてトランザクションを送信する
+
+委任されると、被委任者のウォレットは、トランザクションパラメータで `delegator` のアドレスを指定することにより、認可されたトランザクションを送信できます。トランザクションは被委任者によって署名されますが、委任者に代わって実行され、トランザクション手数料は委任者のアカウントから支払われます。
+
+### 例
+
+```javascript 被委任者として転送を送信する icon=logos:javascript
+// 前の例の grantPermission() 関数が成功したと仮定します
+
+// 転送の受信者
+const recipientWallet = fromRandom();
+
+async function sendDelegatedTransaction() {
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      token: 1, // チェーンのネイティブトークンを1転送
+      wallet: delegateeWallet, // 被委任者によって署名
+      delegator: delegatorWallet.address, // 委任者に代わって実行
+    });
+
+    console.log('Delegated transfer successful!');
+    console.log('Transaction Hash:', hash);
+    console.log(`Check transaction at: https://beta.abtnetwork.io/explorer/txs/${hash}`);
+  } catch (error) {
+    console.error('Error sending delegated transaction:', error);
+  }
+}
+
+// 委任がオンチェーンで確認された後にこれを呼び出すようにしてください。
+// sendDelegatedTransaction();
+```
+
+## 委任の取り消し
+
+委任者は、`revokeDelegate` メソッドを使用して、いつでも付与された権限を取り消すことができます。特定の被委任者に対してどのトランザクションタイプを取り消すかを指定する必要があります。
+
+### パラメータ
+
+<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 data-name="privileges" data-type="Array<string>" data-required="true">
+    <x-field-desc markdown>取り消すトランザクションの `typeUrl` 文字列の配列。</x-field-desc>
+  </x-field>
+</x-field-group>
+
+### 戻り値
+
+<x-field data-name="hash" data-type="Promise<string>" data-desc="取り消しのトランザクションハッシュに解決される Promise。"></x-field>
+
+### 例
+
+```javascript 転送権限の取り消し icon=logos:javascript
+// 前の例と同じ delegatorWallet と delegateeWallet を使用すると仮定します
+
+async function revokePermission() {
+  try {
+    const hash = await client.revokeDelegate({
+      from: delegatorWallet,
+      to: delegateeWallet,
+      privileges: [typeUrls.TransferV2Tx], // 取り消す権限のリスト
+    });
+
+    console.log('Revocation successful!');
+    console.log('Transaction Hash:', hash);
+    console.log(`Check transaction at: https://beta.abtnetwork.io/explorer/txs/${hash}`);
+  } catch (error) {
+    console.error('Error revoking delegation:', error);
+  }
+}
+
+// revokePermission();
+```
+
+このトランザクションが確認されると、`delegateeWallet` は `delegatorWallet` に代わって `transfer` トランザクションを送信できなくなります。

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

@@ -0,0 +1,167 @@
+# 委派權限
+
+委派權限是一項強大的功能，它允許一個帳戶（委派人）授權另一個帳戶（受派人）代表其發送特定類型的交易。這對於需要為使用者執行操作但又不想直接存取使用者主私鑰的應用程式特別有用。例如，您可以將權限委派給特定於應用程式的金鑰，以轉移某些資產或與智慧合約互動，透過限制金鑰的權限範圍來增強安全性。
+
+本指南將引導您完成授予、使用和撤銷委派的過程。
+
+## 授予委派
+
+要授權另一個帳戶，您可以使用 `delegate` 方法。您必須指定要委派給誰以及他們被允許發送哪些特定的交易類型。每項權限還可以有其限制，例如可以涉及哪些代幣或資產。
+
+### 參數
+
+<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 data-name="privileges" data-type="Array<object>" data-required="true">
+    <x-field-desc markdown>要授予的權限物件陣列。每個物件定義一個特定的授權。</x-field-desc>
+    <x-field data-name="typeUrl" data-type="string" data-required="true">
+      <x-field-desc markdown>被允許的交易的類型 URL（例如 `fg:t:transfer_v2`）。</x-field-desc>
+    </x-field>
+    <x-field data-name="limit" data-type="object" data-required="false">
+      <x-field-desc markdown>對權限的可選限制，例如將其限制為特定的代幣或資產。</x-field-desc>
+      <x-field data-name="tokens" data-type="Array<string>" data-required="false" data-desc="此權限適用的代幣地址陣列。"></x-field>
+      <x-field data-name="assets" data-type="Array<string>" data-required="false" data-desc="此權限適用的資產地址陣列。"></x-field>
+    </x-field>
+  </x-field>
+</x-field-group>
+
+### 返回值
+
+<x-field data-name="result" data-type="Promise<[string, string]>" data-desc="一個解析為包含交易雜湊和新建立的委派地址的陣列的 Promise。"></x-field>
+
+### 範例
+
+以下是如何將 `transfer` 權限從一個帳戶委派給另一個帳戶的方法。
+
+```javascript Granting transfer permission icon=logos:javascript
+import Client from '@ocap/client';
+import { fromRandom } from '@ocap/wallet';
+import { typeUrls } from '@ocap/proto';
+
+const client = new Client('https://beta.abtnetwork.io/api');
+
+// 授予權限的帳戶
+const delegatorWallet = fromRandom();
+
+// 接收權限的帳戶
+const delegateeWallet = fromRandom();
+
+async function grantPermission() {
+  try {
+    // 首先，確保委派人帳戶有資金。
+    // 在實際應用中，您需要將資金從水龍頭或其他帳戶轉入 delegatorWallet.address
+    // from a faucet or another account.
+    console.log(`Delegator address: ${delegatorWallet.address}`);
+    console.log(`Delegatee address: ${delegateeWallet.address}`);
+    console.log('Please fund the delegator account before proceeding.');
+
+    const privileges = [
+      {
+        typeUrl: typeUrls.TransferV2Tx,
+        // 未指定限制，允許轉移任何代幣/資產
+        limit: { tokens: [], assets: [] },
+      },
+    ];
+
+    const [hash, delegateAddress] = await client.delegate({
+      from: delegatorWallet,
+      to: delegateeWallet,
+      privileges: privileges,
+    });
+
+    console.log('Delegation successful!');
+    console.log('Transaction Hash:', hash);
+    console.log('Delegate Address:', delegateAddress);
+  } catch (error) {
+    console.error('Error delegating permissions:', error);
+  }
+}
+
+grantPermission();
+```
+
+## 作為受派人發送交易
+
+一旦被委派，受派人錢包可以通過在交易參數中指定 `delegator` 的地址來發送已授權的交易。該交易由受派人簽名，但代表委派人執行，交易費用從委派人的帳戶中支付。
+
+### 範例
+
+```javascript Sending a transfer as a delegatee icon=logos:javascript
+// 假設前一個範例中的 grantPermission() 函數已成功執行
+
+// 轉帳的接收者
+const recipientWallet = fromRandom();
+
+async function sendDelegatedTransaction() {
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      token: 1, // 轉移 1 單位的鏈原生代幣
+      wallet: delegateeWallet, // 由受派人簽名
+      delegator: delegatorWallet.address, // 代表委派人執行
+    });
+
+    console.log('Delegated transfer successful!');
+    console.log('Transaction Hash:', hash);
+    console.log(`Check transaction at: https://beta.abtnetwork.io/explorer/txs/${hash}`);
+  } catch (error) {
+    console.error('Error sending delegated transaction:', error);
+  }
+}
+
+// 確保在鏈上確認委派後再調用此函數。
+// sendDelegatedTransaction();
+```
+
+## 撤銷委派
+
+委派人可以隨時使用 `revokeDelegate` 方法撤銷任何已授予的權限。您需要為指定的受派人指定要撤銷哪些交易類型。
+
+### 參數
+
+<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 data-name="privileges" data-type="Array<string>" data-required="true">
+    <x-field-desc markdown>要撤銷的交易 `typeUrl` 字串陣列。</x-field-desc>
+  </x-field>
+</x-field-group>
+
+### 返回值
+
+<x-field data-name="hash" data-type="Promise<string>" data-desc="一個解析為撤銷交易雜湊的 Promise。"></x-field>
+
+### 範例
+
+```javascript Revoking transfer permission icon=logos:javascript
+// 假設使用與前述範例相同的 delegatorWallet 和 delegateeWallet
+
+async function revokePermission() {
+  try {
+    const hash = await client.revokeDelegate({
+      from: delegatorWallet,
+      to: delegateeWallet,
+      privileges: [typeUrls.TransferV2Tx], // 要撤銷的權限列表
+    });
+
+    console.log('Revocation successful!');
+    console.log('Transaction Hash:', hash);
+    console.log(`Check transaction at: https://beta.abtnetwork.io/explorer/txs/${hash}`);
+  } catch (error) {
+    console.error('Error revoking delegation:', error);
+  }
+}
+
+// revokePermission();
+```
+
+此交易確認後，`delegateeWallet` 將無法再代表 `delegatorWallet` 發送 `transfer` 交易。

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

@@ -1,12 +1,12 @@
 # 委托权限
 
-委托权限是一项强大的功能，它允许一个账户（委托人）授权另一个账户（受托人）代表其发送特定类型的交易。这对于需要为用户执行操作但又不想直接访问用户主私钥的应用程序特别有用。例如，您可以将权限委托给特定于应用程序的密钥，以转移某些资产或与智能合约进行交互，通过限制密钥的权限范围来增强安全性。
+委托权限是一项强大的功能，它允许一个账户（委托人）授权另一个账户（被委托人）代表其发送特定类型的交易。这对于需要为用户执行操作但又不想直接访问用户主私钥的应用程序尤其有用。例如，您可以将权限委托给特定于应用程序的密钥，以转移某些资产或与智能合约交互，通过限制该密钥的权限范围来增强安全性。
 
-本指南将引导您完成授予、使用和撤销委托的全过程。
+本指南将引导您完成授予、使用和撤销委托权限的过程。
 
 ## 授予委托
 
-要授权另一个账户，您需要使用 `delegate` 方法。您必须指定要委托给谁以及他们被允许发送哪些特定的交易类型。每项权限还可以设置限制，例如可以涉及哪些代币或资产。
+要授权另一个账户，您可以使用 `delegate` 方法。您必须指定要委托给谁以及他们被允许发送哪些特定的交易类型。每个权限还可以有限制，例如可以涉及哪些代币或资产。
 
 ### 参数
 
@@ -15,15 +15,15 @@
     <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 data-name="privileges" data-type="Array<object>" data-required="true">
     <x-field-desc markdown>要授予的权限对象数组。每个对象定义一个特定的授权。</x-field-desc>
     <x-field data-name="typeUrl" data-type="string" data-required="true">
-      <x-field-desc markdown>被许可交易的类型 URL（例如，`fg:t:transfer_v2`）。</x-field-desc>
+      <x-field-desc markdown>被许可的交易的类型 URL（例如，`fg:t:transfer_v2`）。</x-field-desc>
     </x-field>
     <x-field data-name="limit" data-type="object" data-required="false">
-      <x-field-desc markdown>对权限的可选限制，例如将其限制为特定的代币或资产。</x-field-desc>
+      <x-field-desc markdown>对权限的可选限制，例如限制于特定的代币或资产。</x-field-desc>
       <x-field data-name="tokens" data-type="Array<string>" data-required="false" data-desc="此权限适用的代币地址数组。"></x-field>
       <x-field data-name="assets" data-type="Array<string>" data-required="false" data-desc="此权限适用的资产地址数组。"></x-field>
     </x-field>
@@ -32,7 +32,7 @@
 
 ### 返回值
 
-<x-field data-name="result" data-type="Promise<[string, string]>" data-desc="一个 promise，解析后返回一个包含交易哈希和新创建的委托地址的数组。"></x-field>
+<x-field data-name="result" data-type="Promise<[string, string]>" data-desc="一个 Promise，它解析为一个包含交易哈希和新创建的委托地址的数组。"></x-field>
 
 ### 示例
 
@@ -54,11 +54,10 @@ const delegateeWallet = fromRandom();
 async function grantPermission() {
   try {
     // 首先，确保委托人账户有资金。
-    // 在实际应用中，您需要向 delegatorWallet.address 转账
-    // 资金可以来自水龙头或另一个账户。
+    // 在实际应用中，您需要从水龙头或其他账户向 delegatorWallet.address 转账。
     console.log(`Delegator address: ${delegatorWallet.address}`);
     console.log(`Delegatee address: ${delegateeWallet.address}`);
-    console.log('请在继续操作前为委托人账户注资。');
+    console.log('Please fund the delegator account before proceeding.');
 
     const privileges = [
       {
@@ -74,20 +73,20 @@ async function grantPermission() {
       privileges: privileges,
     });
 
-    console.log('委托成功！');
-    console.log('交易哈希:', hash);
-    console.log('委托地址:', delegateAddress);
+    console.log('Delegation successful!');
+    console.log('Transaction Hash:', hash);
+    console.log('Delegate Address:', delegateAddress);
   } catch (error) {
-    console.error('委托权限时出错:', error);
+    console.error('Error delegating permissions:', error);
   }
 }
 
 grantPermission();
 ```
 
-## 作为受托人发送交易
+## 作为被委托人发送交易
 
-一旦获得委托，受托人钱包就可以通过在交易参数中指定 `delegator` 的地址来发送已授权的交易。该交易由受托人签名，但代表委托人执行，交易费用从委托人的账户中支付。
+一旦被委托，被委托人钱包可以通过在交易参数中指定 `delegator` 的地址来发送已授权的交易。该交易由被委托人签名，但代表委托人执行，并且交易费用从委托人的账户中支付。
 
 ### 示例
 
@@ -102,15 +101,15 @@ async function sendDelegatedTransaction() {
     const hash = await client.transfer({
       to: recipientWallet.address,
       token: 1, // 转移 1 个链的原生代币
-      wallet: delegateeWallet, // 由受托人签名
+      wallet: delegateeWallet, // 由被委托人签名
       delegator: delegatorWallet.address, // 代表委托人执行
     });
 
-    console.log('委托转账成功！');
-    console.log('交易哈希:', hash);
+    console.log('Delegated transfer successful!');
+    console.log('Transaction Hash:', hash);
     console.log(`Check transaction at: https://beta.abtnetwork.io/explorer/txs/${hash}`);
   } catch (error) {
-    console.error('发送委托交易时出错:', error);
+    console.error('Error sending delegated transaction:', error);
   }
 }
 
@@ -120,7 +119,7 @@ async function sendDelegatedTransaction() {
 
 ## 撤销委托
 
-委托人可以随时使用 `revokeDelegate` 方法撤销任何已授予的权限。您需要指定要为给定受托人撤销哪些交易类型。
+委托人可以随时使用 `revokeDelegate` 方法撤销任何已授予的权限。您需要为给定的被委托人指定要撤销的交易类型。
 
 ### 参数
 
@@ -129,7 +128,7 @@ async function sendDelegatedTransaction() {
     <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 data-name="privileges" data-type="Array<string>" data-required="true">
     <x-field-desc markdown>要撤销的交易 `typeUrl` 字符串数组。</x-field-desc>
@@ -138,12 +137,12 @@ async function sendDelegatedTransaction() {
 
 ### 返回值
 
-<x-field data-name="hash" data-type="Promise<string>" data-desc="一个 promise，解析后返回撤销操作的交易哈希。"></x-field>
+<x-field data-name="hash" data-type="Promise<string>" data-desc="一个 Promise，它解析为撤销操作的交易哈希。"></x-field>
 
 ### 示例
 
 ```javascript Revoking transfer permission icon=logos:javascript
-// 假设使用与前面示例中相同的 delegatorWallet 和 delegateeWallet
+// 假设使用与前面示例相同的 delegatorWallet 和 delegateeWallet
 
 async function revokePermission() {
   try {
@@ -153,15 +152,15 @@ async function revokePermission() {
       privileges: [typeUrls.TransferV2Tx], // 要撤销的权限列表
     });
 
-    console.log('撤销成功！');
-    console.log('交易哈希:', hash);
+    console.log('Revocation successful!');
+    console.log('Transaction Hash:', hash);
     console.log(`Check transaction at: https://beta.abtnetwork.io/explorer/txs/${hash}`);
   } catch (error) {
-    console.error('撤销委托时出错:', error);
+    console.error('Error revoking delegation:', error);
   }
 }
 
 // revokePermission();
 ```
 
-此交易确认后，`delegateeWallet` 将不再能够代表 `delegatorWallet` 发送 `transfer` 交易。
+此交易确认后，`delegateeWallet` 将无法再代表 `delegatorWallet` 发送 `transfer` 交易。

package/docs/how-to-guides-manage-accounts.ja.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 を返します。
+
+### 例
+
+古いウォレットから新しいウォレットにアカウントを移行する方法を次に示します。
+
+```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-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) 指南。