@ocap/client 1.25.3 → 1.25.4

package/docs/getting-started-basic-usage.zh.md

@@ -0,0 +1,87 @@
+# 基本用法
+
+本指南将引导您完成 OCAP 客户端入门的基本步骤。您将学习如何初始化客户端、连接到 ArcBlock 测试链，并执行基本查询以确保一切设置正确。
+
+遵循本指南，您将在几分钟内拥有一个可与区块链交互的客户端实例。
+
+## 1. 初始化客户端
+
+首先，您需要导入 `@ocap/client` 包并创建 `GraphQLClient` 的实例。构造函数接受您要连接的区块链节点的 GraphQL 端点。在本指南中，我们将使用 ArcBlock 测试链的公共端点。
+
+```javascript Initialize Client icon=logos:javascript
+const GraphQLClient = require('@ocap/client');
+
+// 连接到测试链
+const client = new GraphQLClient('https://beta.abtnetwork.io/api');
+
+console.log('OCAP 客户端已初始化！');
+```
+
+这将创建一个客户端实例，该实例已预先配置了查询链、发送交易等方法。
+
+## 2. 查询区块链
+
+客户端初始化后，您可以执行一个简单的只读操作来验证连接。`getChainInfo` 方法非常适合此目的，因为它会获取有关所连接区块链的基本信息，且无需任何身份验证。
+
+```javascript Query Chain Info icon=logos:javascript
+(async () => {
+  try {
+    const { info } = await client.getChainInfo();
+    console.log('链信息：', info);
+  } catch (error) {
+    console.error('获取链信息失败：', error);
+  }
+})();
+```
+
+如果请求成功，`info` 对象将被打印到控制台，其中包含有关链的详细信息，例如其 ID、网络和支持的交易类型。这确认了您的客户端已成功与区块链节点通信。
+
+## 3. 准备账户
+
+要发送交易（写操作），您需要一个钱包。您可以在本地生成一个新钱包。此钱包代表您在链上的账户身份。
+
+```javascript Create a Wallet icon=logos:javascript
+const { fromRandom } = require('@ocap/wallet');
+
+// 创建一个新的随机钱包
+const wallet = fromRandom();
+
+console.log('新钱包已创建：');
+console.log('地址：', wallet.address);
+console.log('公钥：', wallet.publicKey);
+console.log('私钥：', wallet.secretKey);
+```
+
+**重要提示：** 新生成的钱包只是一个密钥对。它尚未存在于区块链上。当其地址收到第一笔传入交易时，链上会自动创建一个账户。
+
+要激活您的新账户，您需要为其充值一些测试通证。您可以从官方水龙头获取用于测试链的免费测试通证（`TBA`）：
+
+<x-card data-title="ArcBlock 水龙头" data-icon="lucide:droplet" data-href="https://faucet.abtnetwork.io/" data-cta="获取测试通证">
+  访问水龙头并将一些 TBA 发送到您新生成的地址以激活它。
+</x-card>
+
+## 4. 查询账户状态
+
+使用水龙头为您的新账户充值后，您可以查询其状态以验证余额。
+
+```javascript Query Account State icon=logos:javascript
+(async () => {
+  try {
+    // 替换为您从水龙头充值的地址
+    const address = wallet.address;
+
+    const { state } = await client.getAccountState({ address });
+    console.log('账户状态：', state);
+  } catch (error) {
+    console.error('获取账户状态失败：', error);
+  }
+})();
+```
+
+响应中的 `state` 对象将包含您账户的地址、余额、nonce（已发送交易的数量）以及其他详细信息。看到非零余额即确认您的账户已从水龙头收到通证，并已在区块链上激活。
+
+## 后续步骤
+
+您已成功设置 OCAP 客户端、连接到区块链并验证了您的账户。现在，您可以开始探索更高级的操作。
+
+请查阅 [操作指南](./how-to-guides.md) 以了解如何执行常见任务，例如转账、管理资产等。

package/docs/getting-started-installation.md

@@ -0,0 +1,60 @@
+# Installation
+
+The OCAP Client is a JavaScript library that connects your application to an OCAP blockchain. It works in both Node.js and browser environments. This guide will walk you through installing the client using a package manager.
+
+## Prerequisites
+
+Before you begin, ensure you have the following installed:
+
+- [Node.js](https://nodejs.org/) (which includes the npm package manager)
+- [pnpm](https://pnpm.io/) (optional, but recommended)
+
+## Install the Package
+
+You can install the `@ocap/client` package from the npm registry using either `npm` or `pnpm`.
+
+### Using npm
+
+Run the following command in your project's terminal:
+
+```shell npm icon=logos:npm
+npm install @ocap/client
+```
+
+### Using pnpm
+
+If you prefer using `pnpm`, run this command:
+
+```shell pnpm icon=logos:pnpm
+pnpm install @ocap/client
+```
+
+This command will download the package and add it to your project's dependencies.
+
+## Verify Installation
+
+After the installation is complete, you can verify that the package is correctly installed by importing it into a JavaScript file. Create a file named `test-client.js` and add the following code:
+
+```javascript Verify Installation icon=logos:javascript
+const OCapClient = require('@ocap/client');
+
+if (OCapClient) {
+  console.log('Successfully installed and imported @ocap/client!');
+} else {
+  console.error('Failed to import @ocap/client.');
+}
+```
+
+Run the file from your terminal:
+
+```shell
+node test-client.js
+```
+
+You should see the success message printed to the console, confirming that the client is ready to use.
+
+## Next Steps
+
+Now that you have the client installed, you're ready to connect to the blockchain and start making requests. Continue to the next section to learn the basics.
+
+- **[Basic Usage](./getting-started-basic-usage.md)**: Learn how to initialize the client and make your first query.

package/docs/getting-started-installation.zh.md

@@ -0,0 +1,60 @@
+# 安装
+
+OCAP Client 是一个 JavaScript 库，可将您的应用程序连接到 OCAP 区块链。它同时适用于 Node.js 和浏览器环境。本指南将引导您使用包管理器安装该客户端。
+
+## 前提条件
+
+在开始之前，请确保您已安装以下内容：
+
+- [Node.js](https://nodejs.org/)（包含 npm 包管理器）
+- [pnpm](https://pnpm.io/)（可选，但推荐使用）
+
+## 安装包
+
+您可以使用 `npm` 或 `pnpm` 从 npm 注册表安装 `@ocap/client` 包。
+
+### 使用 npm
+
+在您的项目终端中运行以下命令：
+
+```shell npm icon=logos:npm
+npm install @ocap/client
+```
+
+### 使用 pnpm
+
+如果您更喜欢使用 `pnpm`，请运行此命令：
+
+```shell pnpm icon=logos:pnpm
+pnpm install @ocap/client
+```
+
+此命令将下载该包并将其添加到您项目的依赖项中。
+
+## 验证安装
+
+安装完成后，您可以通过将其导入 JavaScript 文件来验证包是否已正确安装。创建一个名为 `test-client.js` 的文件并添加以下代码：
+
+```javascript Verify Installation icon=logos:javascript
+const OCapClient = require('@ocap/client');
+
+if (OCapClient) {
+  console.log('Successfully installed and imported @ocap/client!');
+} else {
+  console.error('Failed to import @ocap/client.');
+}
+```
+
+从您的终端运行该文件：
+
+```shell
+node test-client.js
+```
+
+您应该会看到成功消息打印到控制台，确认客户端已准备就绪。
+
+## 后续步骤
+
+现在您已经安装了客户端，可以连接到区块链并开始发出请求了。请继续阅读下一部分以了解基础知识。
+
+- **[基本用法](./getting-started-basic-usage.md)**：学习如何初始化客户端并进行您的第一次查询。

package/docs/getting-started.md

@@ -0,0 +1,16 @@
+# Getting Started
+
+Welcome! This guide will get you up and running with the OCAP Client in under 30 minutes. You'll learn how to install the client, connect your application to an OCAP-compatible blockchain, and make your first API call to verify your setup.
+
+Follow these simple steps to begin interacting with the network.
+
+<x-cards data-columns="2">
+  <x-card data-title="Installation" data-href="/getting-started/installation" data-icon="lucide:download">
+    Learn how to add the OCAP Client package to your project using npm or pnpm.
+  </x-card>
+  <x-card data-title="Basic Usage" data-href="/getting-started/basic-usage" data-icon="lucide:play-circle">
+    Initialize the client, connect to the Beta chain, and make your first API call to verify your setup.
+  </x-card>
+</x-cards>
+
+Once you've completed these initial steps, you'll be ready to explore more advanced features. For practical, task-oriented examples, be sure to check out the [How-to Guides](./how-to-guides.md).

package/docs/getting-started.zh.md

@@ -0,0 +1,16 @@
+# 入门指南
+
+欢迎！本指南将帮助您在 30 分钟内启动并运行 OCAP Client。您将学习如何安装客户端，将您的应用程序连接到与 OCAP 兼容的区块链，并进行您的第一次 API 调用以验证您的设置。
+
+请按照以下简单步骤开始与网络交互。
+
+<x-cards data-columns="2">
+  <x-card data-title="安装" data-href="/getting-started/installation" data-icon="lucide:download">
+    学习如何使用 npm 或 pnpm 将 OCAP Client 包添加到您的项目中。
+  </x-card>
+  <x-card data-title="基本用法" data-href="/getting-started/basic-usage" data-icon="lucide:play-circle">
+    初始化客户端，连接到 Beta 链，并进行您的第一次 API 调用以验证您的设置。
+  </x-card>
+</x-cards>
+
+完成这些初始步骤后，您就可以探索更高级的功能了。有关以任务为导向的实用示例，请务必查看[操作指南](./how-to-guides.md)。

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

@@ -0,0 +1,167 @@
+# Delegate Permissions
+
+Delegating permissions is a powerful feature that allows one account (the delegator) to authorize another account (the delegatee) to send specific types of transactions on its behalf. This is particularly useful for applications that need to perform actions for a user without having direct access to the user's primary private key. For example, you could delegate permission to an application-specific key to transfer certain assets or interact with a smart contract, enhancing security by limiting the scope of the key's authority.
+
+This guide will walk you through granting, using, and revoking delegations.
+
+## Granting Delegation
+
+To authorize another account, you use the `delegate` method. You must specify who you are delegating to and which specific transaction types they are allowed to send. Each permission can also have limits, such as which tokens or assets can be involved.
+
+### Parameters
+
+<x-field-group>
+  <x-field data-name="from" data-type="WalletObject" data-required="true">
+    <x-field-desc markdown>The wallet object of the delegator (the account granting permissions).</x-field-desc>
+  </x-field>
+  <x-field data-name="to" data-type="WalletObject" data-required="true">
+    <x-field-desc markdown>The wallet object of the delegatee (the account receiving permissions).</x-field-desc>
+  </x-field>
+  <x-field data-name="privileges" data-type="Array<object>" data-required="true">
+    <x-field-desc markdown>An array of permission objects to grant. Each object defines a specific authorization.</x-field-desc>
+    <x-field data-name="typeUrl" data-type="string" data-required="true">
+      <x-field-desc markdown>The type URL of the transaction being permitted (e.g., `fg:t:transfer_v2`).</x-field-desc>
+    </x-field>
+    <x-field data-name="limit" data-type="object" data-required="false">
+      <x-field-desc markdown>Optional limits on the permission, such as restricting it to specific tokens or assets.</x-field-desc>
+      <x-field data-name="tokens" data-type="Array<string>" data-required="false" data-desc="An array of token addresses that this permission applies to."></x-field>
+      <x-field data-name="assets" data-type="Array<string>" data-required="false" data-desc="An array of asset addresses that this permission applies to."></x-field>
+    </x-field>
+  </x-field>
+</x-field-group>
+
+### Returns
+
+<x-field data-name="result" data-type="Promise<[string, string]>" data-desc="A promise that resolves to an array containing the transaction hash and the newly created delegate address."></x-field>
+
+### Example
+
+Here’s how to delegate the `transfer` permission from one account to another.
+
+```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');
+
+// The account granting permission
+const delegatorWallet = fromRandom();
+
+// The account receiving permission
+const delegateeWallet = fromRandom();
+
+async function grantPermission() {
+  try {
+    // First, ensure the delegator account has funds.
+    // In a real application, you would transfer funds to 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,
+        // No limits specified, allowing transfer of any token/asset
+        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();
+```
+
+## Sending a Transaction as a Delegatee
+
+Once delegated, the delegatee wallet can send the authorized transaction by specifying the `delegator`'s address in the transaction parameters. The transaction is signed by the delegatee, but executed on behalf of the delegator, and the transaction fees are paid from the delegator's account.
+
+### Example
+
+```javascript Sending a transfer as a delegatee icon=logos:javascript
+// Assuming the grantPermission() function from the previous example was successful
+
+// The recipient of the transfer
+const recipientWallet = fromRandom();
+
+async function sendDelegatedTransaction() {
+  try {
+    const hash = await client.transfer({
+      to: recipientWallet.address,
+      token: 1, // Transfer 1 of the chain's native token
+      wallet: delegateeWallet, // Signed by the delegatee
+      delegator: delegatorWallet.address, // Executed on behalf of the delegator
+    });
+
+    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);
+  }
+}
+
+// Make sure to call this after the delegation is confirmed on-chain.
+// sendDelegatedTransaction();
+```
+
+## Revoking Delegation
+
+The delegator can revoke any granted permissions at any time using the `revokeDelegate` method. You need to specify which transaction types to revoke for a given delegatee.
+
+### Parameters
+
+<x-field-group>
+  <x-field data-name="from" data-type="WalletObject" data-required="true">
+    <x-field-desc markdown>The wallet object of the delegator who originally granted the permissions.</x-field-desc>
+  </x-field>
+  <x-field data-name="to" data-type="WalletObject" data-required="true">
+    <x-field-desc markdown>The wallet object of the delegatee whose permissions are being revoked.</x-field-desc>
+  </x-field>
+  <x-field data-name="privileges" data-type="Array<string>" data-required="true">
+    <x-field-desc markdown>An array of transaction `typeUrl` strings to revoke.</x-field-desc>
+  </x-field>
+</x-field-group>
+
+### Returns
+
+<x-field data-name="hash" data-type="Promise<string>" data-desc="A promise that resolves to the transaction hash for the revocation."></x-field>
+
+### Example
+
+```javascript Revoking transfer permission icon=logos:javascript
+// Assuming the same delegatorWallet and delegateeWallet from previous examples
+
+async function revokePermission() {
+  try {
+    const hash = await client.revokeDelegate({
+      from: delegatorWallet,
+      to: delegateeWallet,
+      privileges: [typeUrls.TransferV2Tx], // The list of permissions to revoke
+    });
+
+    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();
+```
+
+After this transaction is confirmed, the `delegateeWallet` will no longer be able to send `transfer` transactions on behalf of the `delegatorWallet`.

package/docs/how-to-guides-delegate-permissions.zh.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 转账
+    // 资金可以来自水龙头或另一个账户。
+    console.log(`Delegator address: ${delegatorWallet.address}`);
+    console.log(`Delegatee address: ${delegateeWallet.address}`);
+    console.log('请在继续操作前为委托人账户注资。');
+
+    const privileges = [
+      {
+        typeUrl: typeUrls.TransferV2Tx,
+        // 未指定限制，允许转移任何代币/资产
+        limit: { tokens: [], assets: [] },
+      },
+    ];
+
+    const [hash, delegateAddress] = await client.delegate({
+      from: delegatorWallet,
+      to: delegateeWallet,
+      privileges: privileges,
+    });
+
+    console.log('委托成功！');
+    console.log('交易哈希:', hash);
+    console.log('委托地址:', delegateAddress);
+  } catch (error) {
+    console.error('委托权限时出错:', 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('委托转账成功！');
+    console.log('交易哈希:', hash);
+    console.log(`Check transaction at: https://beta.abtnetwork.io/explorer/txs/${hash}`);
+  } catch (error) {
+    console.error('发送委托交易时出错:', 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('撤销成功！');
+    console.log('交易哈希:', hash);
+    console.log(`Check transaction at: https://beta.abtnetwork.io/explorer/txs/${hash}`);
+  } catch (error) {
+    console.error('撤销委托时出错:', error);
+  }
+}
+
+// revokePermission();
+```
+
+此交易确认后，`delegateeWallet` 将不再能够代表 `delegatorWallet` 发送 `transfer` 交易。

package/docs/how-to-guides-manage-accounts.md

@@ -0,0 +1,73 @@
+# Manage Accounts
+
+On an OCAP-powered blockchain, an account is fundamentally a state associated with an address, controlled by a pair of cryptographic keys (a public key and a private key). A key concept to understand is that accounts are created implicitly. An account officially exists on-chain as soon as it receives its first incoming transaction, such as a token or asset transfer. There is no explicit `createAccount` transaction.
+
+This guide focuses on a critical account management operation: migrating an account to a new set of keys. This is an essential security feature that allows you to change the ownership of an account without altering its address, balance, or assets.
+
+## Migrate an Account to New Keys
+
+The `migrateAccount` function allows you to associate an existing account address with a new public key. This is useful in several scenarios, such as:
+
+- **Key Compromise**: If you suspect your private key has been exposed, you can migrate the account to a new, secure key pair to prevent unauthorized access.
+- **Upgrading Security**: You might want to migrate from an older key type to a newer, more secure one.
+
+This operation effectively transfers control of the account while preserving its history and state on the blockchain.
+
+### Parameters
+
+<x-field-group>
+  <x-field data-name="from" data-type="WalletObject" data-required="true">
+    <x-field-desc markdown>The wallet object representing the current account that is being migrated. This wallet must sign the transaction to prove ownership.</x-field-desc>
+  </x-field>
+  <x-field data-name="to" data-type="WalletObject" data-required="true">
+    <x-field-desc markdown>The new wallet object to which control will be transferred. The public key from this wallet will become the new authority for the account address.</x-field-desc>
+  </x-field>
+</x-field-group>
+
+### Returns
+
+The `migrateAccount` method returns a Promise that resolves to the transaction hash as a string.
+
+### Example
+
+Here's how to migrate an account from an old wallet to a new one.
+
+```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');
+
+// Assume oldWallet is the currently authorized wallet for the account
+const oldWallet = fromRandom(); 
+
+// Create a new wallet with a new set of keys
+const newWallet = fromRandom();
+
+async function migrate() {
+  try {
+    // Before migrating, you would typically fund the oldWallet's address.
+    // For this example, we'll assume it has enough funds to pay for the transaction fee.
+    // You can get test tokens from https://faucet.abtnetwork.io/
+    console.log(`Migrating account from ${oldWallet.address} to new keys associated with ${newWallet.address}`);
+
+    const hash = await client.migrateAccount({
+      from: oldWallet,
+      to: newWallet,
+    });
+
+    console.log('Account migration transaction sent successfully!');
+    console.log('Transaction Hash:', hash);
+    console.log(`View transaction at: https://beta.abtnetwork.io/explorer/txs/${hash}`);
+
+  } catch (err) {
+    console.error('Error migrating account:', err);
+  }
+}
+
+migrate();
+```
+
+---
+
+Now that you know how to secure your account by migrating keys, you might want to learn how to grant limited permissions to other accounts without sharing your primary keys. See the [Delegate Permissions](./how-to-guides-delegate-permissions.md) guide for more details.