@ocap/client 1.25.4 → 1.25.6

package/docs/core-concepts.zh.md

@@ -1,22 +1,22 @@
 # 核心概念
 
-本节深入探讨了构成 OCAP Client 库的基本原则和架构决策。理解这些核心概念将帮助您充分利用该库的全部潜力，编写更高效的代码，并更有效地解决问题。
+本节深入探讨了构成 OCAP Client 库的基本原则和架构决策。理解这些核心概念将帮助您充分发挥该库的潜力，编写更高效的代码，并更有效地解决问题。
 
-[操作指南](./how-to-guides.md) 提供了特定任务的分步说明，而本节则解释了“如何做”背后的“为什么”。我们将探讨客户端的结构、交易从开始到结束的处理过程、如何监听实时事件以及如何创建无 Gas 费用的用户体验。
+虽然[操作指南](./how-to-guides.md)为特定任务提供了分步说明，但本节解释了“如何做”背后的“为什么”。我们将探讨客户端的结构、交易从开始到结束的处理过程、如何监听实时事件以及如何创建无 Gas 费用的用户体验。
 
 <x-cards data-columns="2">
   <x-card data-title="客户端架构" data-icon="lucide:architecture" data-href="/core-concepts/client-architecture">
     了解不同的客户端实现（Node、Browser、Lite），以及如何为您的环境选择合适的实现以优化性能和包大小。
   </x-card>
   <x-card data-title="交易生命周期" data-icon="lucide:refresh-cw" data-href="/core-concepts/transaction-lifecycle">
-    追踪一笔交易从一个简单的 JavaScript 对象到链上确认区块的全过程，涵盖创建、编码、签名和广播。
+    追踪一笔交易从简单的 JavaScript 对象到链上确认块的全过程，包括创建、编码、签名和广播。
   </x-card>
   <x-card data-title="事件订阅" data-icon="lucide:radio-tower" data-href="/core-concepts/event-subscriptions">
-    了解如何使用基于 WebSocket 的订阅功能来监听实时链上事件，从而实现动态和响应迅速的应用程序。
+    了解如何使用基于 WebSocket 的订阅功能来监听链上实时事件，从而实现动态和响应迅速的应用程序。
   </x-card>
   <x-card data-title="Gas 费支付" data-icon="lucide:gas-pump" data-href="/core-concepts/gas-payment">
-    探索强大的 Gas 费支付功能，该功能允许指定钱包为用户代付交易费用，从而创造无缝、无 Gas 费用的体验。
+    探索强大的 Gas 费支付功能，该功能允许指定钱包为用户代付交易费用，从而创造无缝、无需 Gas 费的体验。
   </x-card>
 </x-cards>
 
-通过掌握这些基础主题，您将能够使用 OCAP Client 构建强大、可扩展且用户友好的应用程序。
+通过掌握这些基础主题，您将能够使用 OCAP Client 构建稳健、可扩展且用户友好的应用程序。

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

@@ -0,0 +1,87 @@
+# 基本的な使い方
+
+このガイドでは、OCAP Clientを使い始めるための基本的な手順を説明します。クライアントの初期化、ArcBlock Beta Chainへの接続、そしてすべてが正しく設定されていることを確認するための基本的なクエリの実行方法を学びます。
+
+このガイドに従うことで、わずか数分でブロックチェーンと対話する準備が整ったクライアントインスタンスを稼働させることができます。
+
+## 1. クライアントの初期化
+
+まず、`@ocap/client` パッケージをインポートし、`GraphQLClient` のインスタンスを作成する必要があります。コンストラクタには、接続したいブロックチェーンノードのGraphQLエンドポイントを渡します。このガイドでは、ArcBlock Beta Chainの公開エンドポイントを使用します。
+
+```javascript Initialize Client icon=logos:javascript
+const GraphQLClient = require('@ocap/client');
+
+// Beta Chainに接続
+const client = new GraphQLClient('https://beta.abtnetwork.io/api');
+
+console.log('OCAP Clientが初期化されました！');
+```
+
+これにより、チェーンのクエリ、トランザクションの送信などのメソッドが事前設定されたクライアントインスタンスが作成されます。
+
+## 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. アカウントの準備
+
+トランザクション（書き込み操作）を送信するには、ウォレットが必要です。ローカルで新しいウォレットを生成できます。このウォレットは、オンチェーンでのアカウントIDを表します。
+
+```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);
+```
+
+**重要:** 新しく生成されたウォレットは単なるキーペアであり、まだブロックチェーン上には存在しません。アカウントは、そのアドレスが最初の受信トランザクションを受け取ったときに、オンチェーンで自動的に作成されます。
+
+新しいアカウントを有効にするには、テストトークンで資金を供給する必要があります。公式フォーセットからBeta Chain用の無料テストトークン（`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` オブジェクトには、アカウントのアドレス、残高、ナンス（送信されたトランザクション数）、その他の詳細が含まれます。残高がゼロでないことを確認できれば、アカウントがフォーセットからトークンを受け取り、ブロックチェーン上で有効になったことが確定します。
+
+## 次のステップ
+
+これでOCAP Clientのセットアップ、ブロックチェーンへの接続、アカウントの確認が正常に完了しました。より高度な操作に進む準備が整いました。
+
+トークンの転送、アセットの管理などの一般的なタスクを実行する方法については、[ハウツーガイド](./how-to-guides.md)をご覧ください。

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

@@ -0,0 +1,87 @@
+# 基本用法
+
+本指南將引導您完成開始使用 OCAP Client 的基本步驟。您將學習如何初始化客戶端、連接到 ArcBlock Beta Chain，並執行基本查詢以確保一切設定正確。
+
+遵循本指南，您應可在幾分鐘內擁有一個可運作的客戶端實例，準備好與區塊鏈進行互動。
+
+## 1. 初始化客戶端
+
+首先，您需要匯入 `@ocap/client` 套件並建立一個 `GraphQLClient` 的實例。建構函式需要傳入您想連接的區塊鏈節點的 GraphQL 端點。在本指南中，我們將使用 ArcBlock Beta Chain 的公共端點。
+
+```javascript Initialize Client icon=logos:javascript
+const GraphQLClient = require('@ocap/client');
+
+// 連接到 Beta Chain
+const client = new GraphQLClient('https://beta.abtnetwork.io/api');
+
+console.log('OCAP Client 初始化完成！');
+```
+
+這會建立一個客戶端實例，該實例已預先配置了查詢鏈、發送交易等方法。
+
+## 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);
+```
+
+**重要事項：** 新生成的錢包只是一個金鑰對。它尚未存在於區塊鏈上。當其地址收到第一筆傳入交易時，帳戶將在鏈上自動建立。
+
+要啟用您的新帳戶，您需要為其注資一些測試代幣。您可以從官方水龍頭獲取 Beta Chain 的免費測試代幣（`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 Client、連接到區塊鏈並驗證了您的帳戶。現在您已準備好探索更進階的操作。
+
+查看 [操作指南](./how-to-guides.md) 以學習如何執行常見任務，例如轉移代幣、管理資產等。

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

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

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

@@ -0,0 +1,60 @@
+# インストール
+
+OCAP Clientは、アプリケーションをOCAPブロックチェーンに接続するためのJavaScriptライブラリです。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('@ocap/clientのインストールとインポートに成功しました！');
+} else {
+  console.error('@ocap/clientのインポートに失敗しました。');
+}
+```
+
+ターミナルからファイルを実行してください。
+
+```shell
+node test-client.js
+```
+
+コンソールに成功メッセージが出力され、クライアントが使用準備完了であることが確認できます。
+
+## 次のステップ
+
+クライアントがインストールされたので、ブロックチェーンに接続してリクエストを開始する準備が整いました。次のセクションに進み、基本的な使い方を学びましょう。
+
+- **[基本操作](./getting-started-basic-usage.md)**: クライアントを初期化し、最初のクエリを実行する方法を学びます。

package/docs/getting-started-installation.zh-TW.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-installation.zh.md

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

package/docs/getting-started.ja.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">
+    クライアントを初期化し、ベータチェーンに接続し、最初のAPIコールを行ってセットアップを検証します。
+  </x-card>
+</x-cards>
+
+これらの初期ステップを完了したら、より高度な機能を探求する準備が整います。実践的でタスク指向の例については、必ず[ハウツーガイド](./how-to-guides.md)を確認してください。

package/docs/getting-started.zh-TW.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/getting-started.zh.md

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