@ocap/client 1.25.5 → 1.26.0

package/docs/api-reference.ja.md

@@ -1,23 +1,23 @@
 # APIリファレンス
 
-OCAPクライアントAPIリファレンスへようこそ。このセクションでは、利用可能なすべてのクラス、メソッド、データ型に関する包括的で検索可能なリファレンスを提供します。GraphQLメソッドの詳細、トランザクションヘルパーのパラメータ、または応答オブジェクトの構造を探している場合でも、ここで必要な詳細情報を見つけることができます。
+OCAPクライアントAPIリファレンスへようこそ。このセクションでは、利用可能なすべてのクラス、メソッド、およびデータ型に関する包括的で検索可能なリファレンスを提供します。GraphQLメソッドの詳細、トランザクションヘルパーのパラメータ、またはレスポンスオブジェクトの構造を探している場合でも、必要な詳細情報がここで見つかります。
 
-クライアントの機能をさらに詳しく知るには、次のセクションをご覧ください：
+クライアントの機能をより深く理解するために、以下のセクションをご覧ください。
 
 <x-cards data-columns="2">
   <x-card data-title="ヘルパーメソッド" data-icon="lucide:function-square" data-href="/api-reference/client-methods">
     `getType`、`decodeTx`、`fromUnitToToken` などのコアクライアントヘルパーメソッドに関する詳細なドキュメント。
   </x-card>
   <x-card data-title="クエリ＆ミューテーションメソッド" data-icon="lucide:database-zap" data-href="/api-reference/query-mutation-methods">
-    チェーンからの読み取りと書き込みのための、利用可能なすべてのGraphQLクエリおよびミューテーションメソッドの完全なリスト。
+    チェーンからの読み取りおよび書き込みのための、利用可能なすべての GraphQL クエリおよびミューテーションメソッドの完全なリスト。
   </x-card>
   <x-card data-title="高レベルAPI" data-icon="lucide:zap" data-href="/api-reference/transaction-helpers">
-    トークンの転送や資産の管理などの一般的なワークフローを簡素化する高レベル関数のリファレンス。
+    トークンの転送やアセットの管理などの一般的なワークフローを簡素化する高レベル関数のリファレンス。
   </x-card>
   <x-card data-title="低レベルAPI" data-icon="lucide:cpu" data-href="/api-reference/low-level-api">
-    トランザクションのライフサイクルを完全に制御するために、トランザクションを手動で構築、署名、送信する方法を学びます。
+    トランザクションライフサイクルを完全に制御するために、トランザクションを手動で構築、署名、送信する方法を学びます。
   </x-card>
   <x-card data-title="データ型" data-icon="lucide:box" data-href="/api-reference/data-types">
-    クライアントAPI全体で使用されるすべてのカスタムデータ構造、入力パラメータ、および応答オブジェクトを定義します。
+    クライアントAPI全体で使用されるすべてのカスタムデータ構造、入力パラメータ、およびレスポンスオブジェクトを定義します。
   </x-card>
 </x-cards>

package/docs/api-reference.zh-TW.md

@@ -1,23 +1,23 @@
 # API 參考
 
-歡迎來到 OCAP Client API 參考。本節提供所有可用類別、方法和資料類型的全面且可搜尋的參考。無論您是在尋找 GraphQL 方法的細節、交易輔助工具的參數，還是回應物件的結構，您都可以在這裡找到所需的詳細資訊。
+歡迎來到 OCAP Client API 參考文件。本節為所有可用的類別、方法和資料類型，提供了一份全面且可搜尋的參考資料。無論您是在尋找 GraphQL 方法的具體細節、交易輔助工具的參數，還是回應物件的結構，都可以在這裡找到您需要的詳細資訊。
 
-探索以下部分，深入了解客戶端的功能：
+探索以下各節，以深入了解此客戶端的功能：
 
 <x-cards data-columns="2">
   <x-card data-title="輔助方法" data-icon="lucide:function-square" data-href="/api-reference/client-methods">
     核心客戶端輔助方法的詳細文件，例如 `getType`、`decodeTx` 和 `fromUnitToToken`。
   </x-card>
   <x-card data-title="查詢與變更方法" data-icon="lucide:database-zap" data-href="/api-reference/query-mutation-methods">
-    所有可用的 GraphQL 查詢和變更方法的完整列表，用於讀取和寫入鏈上資料。
+    所有可用於讀取和寫入鏈上資料的 GraphQL 查詢與變更方法之完整清單。
   </x-card>
   <x-card data-title="高階 API" data-icon="lucide:zap" data-href="/api-reference/transaction-helpers">
-    高階函數的參考，可簡化如轉移代幣和管理資產等常見工作流程。
+    高階函式的參考文件，這些函式可簡化如代幣轉移和資產管理等常見工作流程。
   </x-card>
   <x-card data-title="低階 API" data-icon="lucide:cpu" data-href="/api-reference/low-level-api">
     學習如何手動建構、簽署和發送交易，以完全控制交易的生命週期。
   </x-card>
   <x-card data-title="資料類型" data-icon="lucide:box" data-href="/api-reference/data-types">
-    定義整個客戶端 API 中使用的所有自訂資料結構、輸入參數和回應物件。
+    定義了整個客戶端 API 中使用的所有自訂資料結構、輸入參數和回應物件。
   </x-card>
 </x-cards>

package/docs/api-reference.zh.md

@@ -1,21 +1,21 @@
 # API 参考
 
-欢迎来到 OCAP Client API 参考。本节为所有可用的类、方法和数据类型提供了全面且可搜索的参考。无论您是想了解 GraphQL 方法的细节、交易辅助工具的参数，还是响应对象的结构，都可以在这里找到所需的详细信息。
+欢迎来到 OCAP Client API 参考。本节为所有可用的类、方法和数据类型提供了一个全面且可搜索的参考。无论您是在寻找 GraphQL 方法的细节、交易辅助函数的参数，还是响应对象的结构，您都可以在这里找到所需的详细信息。
 
-探索以下部分，深入了解客户端的功能：
+探索以下部分，以深入了解客户端的功能：
 
 <x-cards data-columns="2">
   <x-card data-title="辅助方法" data-icon="lucide:function-square" data-href="/api-reference/client-methods">
-    核心客户端辅助方法（如 `getType`、`decodeTx` 和 `fromUnitToToken`）的详细文档。
+    核心客户端辅助方法的详细文档，例如 `getType`、`decodeTx` 和 `fromUnitToToken`。
   </x-card>
   <x-card data-title="查询与变更方法" data-icon="lucide:database-zap" data-href="/api-reference/query-mutation-methods">
-    所有可用的 GraphQL 查询和变更方法的完整列表，用于读取和写入链上数据。
+    所有可用于从链上读取和写入数据的 GraphQL 查询和变更方法的完整列表。
   </x-card>
-  <x-card data-title="高阶 API" data-icon="lucide:zap" data-href="/api-reference/transaction-helpers">
-    用于简化代币转账和资产管理等常见工作流程的高阶函数参考。
+  <x-card data-title="高级 API" data-icon="lucide:zap" data-href="/api-reference/transaction-helpers">
+    简化常见工作流程（如转移代币和管理资产）的高级函数参考。
   </x-card>
-  <x-card data-title="低阶 API" data-icon="lucide:cpu" data-href="/api-reference/low-level-api">
-    了解如何手动构建、签署和发送交易，以完全控制交易生命周期。
+  <x-card data-title="底层 API" data-icon="lucide:cpu" data-href="/api-reference/low-level-api">
+    学习如何手动构建、签名和发送交易，以完全控制交易生命周期。
   </x-card>
   <x-card data-title="数据类型" data-icon="lucide:box" data-href="/api-reference/data-types">
     定义了整个客户端 API 中使用的所有自定义数据结构、输入参数和响应对象。

package/docs/core-concepts-client-architecture.ja.md

@@ -1,12 +1,12 @@
 # クライアントアーキテクチャ
 
-OCAP クライアントは、さまざまな JavaScript 環境や特定のユースケースに対応できるよう、モジュラーアーキテクチャで設計されています。画一的なライブラリではなく、Node.js バックエンドやバンドルサイズが重視されるウェブアプリケーションなど、特定のコンテキストに最適化された複数のクライアント実装を提供します。このアプローチにより、ニーズに最も効率的なクライアントを選択でき、必要に応じてパフォーマンスの向上とフットプリントの削減が実現します。
+OCAP Client は、さまざまな JavaScript 環境や特定のユースケースに対応するため、モジュラーアーキテクチャで設計されています。画一的なライブラリではなく、Node.js バックエンドやバンドルサイズに敏感なウェブアプリケーションなど、特定のコンテキストに最適化された複数のクライアント実装を提供しています。このアプローチにより、ニーズに最も効率的なクライアントを選択でき、必要に応じてパフォーマンスの向上とフットプリントの削減が保証されます。
 
-すべてのクライアントのバリエーションは、共通の基盤である `GraphQLClientBase` 上に構築されており、ブロックチェーンの GraphQL API と対話するためのコア機能を提供します。
+すべてのクライアントバリエーションは、共通のベースである `GraphQLClientBase` 上に構築されており、ブロックチェーンの GraphQL API と対話するためのコア機能を提供します。
 
 ### 継承図
 
-次の図は、さまざまなクライアント実装間の関係を示しています。
+以下の図は、異なるクライアント実装間の関係を示しています。
 
 ```d2
 direction: down
@@ -22,81 +22,81 @@ GraphQLClient: {
 }
 
 GraphqlClientLite: {
-  label: "GraphqlClientLite\n(ブラウザ向けに最適化)"
+  label: "GraphqlClientLite\n(ブラウザ向け最適化)"
   shape: rectangle
 }
 
 NativeGraphqlClient: {
-  label: "NativeGraphqlClient\n(Node.js向けに最適化)"
+  label: "NativeGraphqlClient\n(Node.js向け最適化)"
   shape: rectangle
 }
 
-GraphQLClientBase -> GraphQLClient: "Extends"
-GraphQLClientBase -> GraphqlClientLite: "Extends"
-GraphQLClient -> NativeGraphqlClient: "Extends"
+GraphQLClientBase -> GraphQLClient: "継承"
+GraphQLClientBase -> GraphqlClientLite: "継承"
+GraphQLClient -> NativeGraphqlClient: "継承"
 ```
 
 ## クライアント実装
 
-ここでは、利用可能な各クライアントと、その想定されるユースケースについて説明します。
+以下に、利用可能な各クライアントとその想定されるユースケースの内訳を示します。
 
 ### `GraphQLClientBase` (コア)
 
-これは、他のすべてのクライアントが拡張する、基盤となる軽量なクライアントです。ブロックチェーンと通信するための基本的な機能を提供します。
+これは、他のすべてのクライアントが拡張する、基礎となる軽量なクライアントです。ブロックチェーンとの通信に不可欠な機能を提供します。
 
 - GraphQL のクエリとミューテーションの送信。
 - リアルタイムのイベントサブスクリプションのための WebSocket 接続の確立。
 - スポンサー付きトランザクションのためのガス支払いヘッダーの処理。
-- 環境に依存しませんが、サブスクリプションを使用する場合は、WebSocket と EventEmitter に互換性のある実装を提供する必要があります。
+- 環境に依存しませんが、サブスクリプションを使用する場合は、WebSocket と EventEmitter の互換性のある実装を提供する必要があります。
 
 このクライアントは、基本的な読み取り専用機能のみが必要で、依存関係を最小限に抑えたい場合に最適です。
 
 ### `GraphQLClient` (フルクライアント)
 
-これは標準的な汎用クライアントであり、最も頻繁に使用されるものです。`GraphQLClientBase` を拡張し、一般的なオンチェーン操作を簡素化する豊富な高レベルヘルパーメソッド群を追加します。これらのヘルパーは、アセットの作成、トークンの転送、ステークの管理などのタスクをカバーし、生の GraphQL ミューテーションの複雑さを抽象化します。
+これは標準的な汎用クライアントであり、最も頻繁に使用される可能性が高いものです。`GraphQLClientBase` を拡張し、一般的なオンチェーン操作を簡素化する豊富な高レベルヘルパーメソッドのセットを追加します。これらのヘルパーは、アセットの作成、トークンの転送、ステークの管理などのタスクをカバーし、生の GraphQL ミューテーションの複雑さを抽象化します。
 
-デフォルトでは、インスタンス化の際にコンテキストを自動的に初期化するため、すぐに使用できます。
+デフォルトでは、インスタンス化時にコンテキストを自動的に初期化するため、すぐに使用できます。
 
 ### `NativeGraphqlClient` (Node.js向け)
 
-このクライアントは Node.js ランタイムに特化して最適化されています。フル機能の `GraphQLClient` を拡張し、イベント処理に Node.js のネイティブ `events` モジュールを使用するように設定します。これにより、サーバー上で実行されるあらゆるバックエンドアプリケーション、コマンドラインツール、またはスクリプトにとって、最もパフォーマンスが高く信頼性の高い選択肢となります。
+このクライアントは、Node.js ランタイムに特化して最適化されています。フル機能の `GraphQLClient` を拡張し、イベント処理に Node.js のネイティブな `events` モジュールを使用するように設定します。これにより、バックエンドアプリケーション、コマンドラインツール、またはサーバー上で実行されるスクリプトにとって、最もパフォーマンスが高く信頼性の高い選択肢となります。
 
 ### `GraphqlClientLite` (ブラウザ向け)
 
-フロントエンドのウェブアプリケーション向けに設計された `GraphqlClientLite` は `GraphQLClientBase` を拡張し、バンドルサイズが最小になるように最適化されています。Node.js 固有の依存関係を `wolfy87-eventemitter` のようなブラウザ互換の代替ライブラリに置き換えています。パフォーマンスと読み込み時間が重要なウェブアプリケーションを構築している場合、このクライアントは、フル機能のヘルパーメソッド群による余分な負荷なしで、OCAP のコア機能を提供します。
+フロントエンドのウェブアプリケーション向けに設計された `GraphqlClientLite` は `GraphQLClientBase` を拡張し、最小限のバンドルサイズに最適化されています。Node.js 固有の依存関係を `wolfy87-eventemitter` のようなブラウザ互換の代替品に置き換えます。パフォーマンスと読み込み時間が重要なウェブアプリケーションを構築している場合、このクライアントは、フル機能のヘルパーメソッドスイートの余分な重みなしに、OCAP のコア機能を提供します。
 
 ## どのクライアントを使用すべきか？
 
-どのクライアントを選択すればよいか判断しやすいように、各シナリオで推奨されるクライアントの概要を以下に示します。
+どのクライアントを選択すべきかを判断するために、各シナリオで推奨されるクライアントの概要を以下に示します。
 
 | 環境 | ユースケース | 推奨クライアント | インポートパス |
 | :---------- | :------------------------------------------- | :----------------------- | :---------------------- |
 | Node.js | バックエンドサービス、スクリプト、CLI ツール | `NativeGraphqlClient` | `@ocap/client/node` |
-| ブラウザ | 一般的なウェブアプリケーション (例: React, Vue) | `GraphQLClient` | `@ocap/client` |
-| ブラウザ | バンドルサイズが重視されるアプリケーション | `GraphqlClientLite` | `@ocap/client/lite` |
-| すべて | 読み取り専用、最小限の機能が必要 | `GraphQLClientBase` | `@ocap/client/base` |
+| ブラウザ | 一般的なウェブアプリケーション（例：React, Vue） | `GraphQLClient` | `@ocap/client` |
+| ブラウザ | バンドルサイズに敏感なアプリケーション | `GraphqlClientLite` | `@ocap/client/lite` |
+| 任意 | 読み取り専用、最小限の機能が必要 | `GraphQLClientBase` | `@ocap/client/base` |
 
-### インポート例
+### インポートの例
 
-以下に、コード内で各クライアントをインポートする方法を示します。
+以下に、各クライアントをコードにインポートする方法を示します。
 
-```javascript Node.js クライアント icon=logos:nodejs-icon
+```javascript Node.js Client icon=logos:nodejs-icon
 const NativeGraphqlClient = require('@ocap/client/node');
 const client = new NativeGraphqlClient('https://beta.abtnetwork.io/api');
 ```
 
-```javascript フルブラウザクライアント icon=logos:javascript
+```javascript Full Browser Client icon=logos:javascript
 const GraphQLClient = require('@ocap/client');
 const client = new GraphQLClient('https://beta.abtnetwork.io/api');
 ```
 
-```javascript Lite ブラウザクライアント icon=logos:javascript
+```javascript Lite Browser Client icon=logos:javascript
 const GraphqlClientLite = require('@ocap/client/lite');
 const client = new GraphqlClientLite('https://beta.abtnetwork.io/api');
 ```
 
 ## まとめ
 
-さまざまなクライアント実装を理解することで、アプリケーションの環境と要件に最も適した、情報に基づいた選択ができます。適切なクライアントを選択することで、パフォーマンス、バンドルサイズ、使いやすさを最適化できます。
+さまざまなクライアント実装を理解することで、アプリケーションの環境と要件に最も適した情報に基づいた選択ができます。適切なクライアントを選択することで、パフォーマンス、バンドルサイズ、使いやすさを最適化できます。
 
-これでクライアントアーキテクチャを理解できたので、次はトランザクションがどのように構築され、処理されるかをさらに深く掘り下げてみましょう。[トランザクションライフサイクル](./core-concepts-transaction-lifecycle.md) ガイドで詳しく学んでください。
+クライアントアーキテクチャを理解したところで、トランザクションがどのように構築され、処理されるかについてさらに深く掘り下げることができます。詳細は [トランザクションのライフサイクル](./core-concepts-transaction-lifecycle.md) ガイドをご覧ください。

package/docs/core-concepts-client-architecture.zh-TW.md

@@ -1,12 +1,12 @@
-# 客戶端架構
+# 用戶端架構
 
-OCAP 客戶端採用模組化架構設計，以滿足不同的 JavaScript 環境和特定使用情境。它並非提供一個一體適用的函式庫，而是提供多種客戶端實作，每種實作都針對特定情境進行了優化，例如 Node.js 後端或對程式碼包大小敏感的 Web 應用程式。這種方法讓您可以根據需求選擇最高效的客戶端，從而在必要時確保更佳的效能和更小的體積。
+OCAP 用戶端採用模組化架構設計，以滿足不同 JavaScript 環境和特定使用情境的需求。它並非提供一個一體適用的函式庫，而是提供多個用戶端實作，每個實作都針對特定情境進行了最佳化，例如 Node.js 後端或對套件大小敏感的網頁應用程式。這種方法讓您可以根據需求選擇最高效的用戶端，從而在必要時確保更佳的效能和更小的體積。
 
-所有客戶端變體都建立在一個共同的基礎 `GraphQLClientBase` 之上，它提供了與區塊鏈的 GraphQL API 互動的核心功能。
+所有用戶端變體都建立在一個共同的基礎 `GraphQLClientBase` 之上，該基礎提供了與區塊鏈 GraphQL API 互動的核心功能。
 
 ### 繼承關係圖
 
-下圖說明了不同客戶端實作之間的關係：
+下圖說明了不同用戶端實作之間的關係：
 
 ```d2
 direction: down
@@ -17,86 +17,86 @@ GraphQLClientBase: {
 }
 
 GraphQLClient: {
-  label: "GraphQLClient\n(完整客戶端 + 輔助工具)"
+  label: "GraphQLClient\n(完整用戶端 + 輔助工具)"
   shape: rectangle
 }
 
 GraphqlClientLite: {
-  label: "GraphqlClientLite\n(瀏覽器優化)"
+  label: "GraphqlClientLite\n(瀏覽器最佳化)"
   shape: rectangle
 }
 
 NativeGraphqlClient: {
-  label: "NativeGraphqlClient\n(Node.js 優化)"
+  label: "NativeGraphqlClient\n(Node.js 最佳化)"
   shape: rectangle
 }
 
-GraphQLClientBase -> GraphQLClient: "擴展"
-GraphQLClientBase -> GraphqlClientLite: "擴展"
-GraphQLClient -> NativeGraphqlClient: "擴展"
+GraphQLClientBase -> GraphQLClient: "擴充"
+GraphQLClientBase -> GraphqlClientLite: "擴充"
+GraphQLClient -> NativeGraphqlClient: "擴充"
 ```
 
-## 客戶端實作
+## 用戶端實作
 
-以下是每種可用客戶端及其預期使用情境的詳細說明。
+以下是每種可用用戶端及其預期使用情境的詳細說明。
 
 ### `GraphQLClientBase` (核心)
 
-這是所有其他客戶端擴展的基礎、輕量級客戶端。它提供了與區塊鏈通訊的基本功能：
+這是所有其他用戶端擴充的基礎輕量級用戶端。它提供了與區塊鏈通訊的基本功能：
 
-- 發送 GraphQL 查詢和變更。
+- 傳送 GraphQL 查詢和變更。
 - 建立 WebSocket 連線以進行即時事件訂閱。
-- 處理贊助交易的 gas 支付標頭。
+- 處理贊助交易的 Gas 支付標頭。
 - 它與環境無關，但如果您使用訂閱功能，則需要為 WebSocket 和 EventEmitter 提供相容的實作。
 
-如果您只需要基本的唯讀功能並希望最小化依賴性，這個客戶端是理想的選擇。
+如果您只需要基本的唯讀功能並希望最小化依賴性，那麼此用戶端是理想的選擇。
 
-### `GraphQLClient` (完整客戶端)
+### `GraphQLClient` (完整用戶端)
 
-這是標準的、通用的客戶端，也是您最可能經常使用的客戶端。它擴展了 `GraphQLClientBase`，並增加了一套豐富的高階輔助方法，以簡化常見的鏈上操作。這些輔助工具涵蓋了創建資產、轉移代幣和管理質押等任務，將原始 GraphQL 變更的複雜性抽象化。
+這是標準的通用用戶端，也是您最可能經常使用的用戶端。它擴充了 `GraphQLClientBase`，並增加了一套豐富的高階輔助方法，以簡化常見的鏈上操作。這些輔助工具涵蓋了建立資產、轉移代幣和管理質押等任務，將原始 GraphQL 變更的複雜性抽象化。
 
 預設情況下，它在實例化時也會自動初始化其上下文，使其可以立即使用。
 
 ### `NativeGraphqlClient` (適用於 Node.js)
 
-這個客戶端專為 Node.js 執行環境進行了優化。它擴展了完整的 `GraphQLClient`，並將其配置為使用 Node.js 的原生 `events` 模組進行事件處理。這使其成為任何後端應用程式、命令列工具或在伺服器上執行的腳本中最具效能和最可靠的選擇。
+此用戶端專為 Node.js 執行環境進行了最佳化。它擴充了完整的 `GraphQLClient`，並將其設定為使用 Node.js 的原生 `events` 模組進行事件處理。這使其成為任何在伺服器上執行的後端應用程式、命令列工具或指令碼的最高效能和最可靠的選擇。
 
 ### `GraphqlClientLite` (適用於瀏覽器)
 
-`GraphqlClientLite` 專為前端 Web 應用程式設計，擴展了 `GraphQLClientBase`，並針對最小化程式碼包大小進行了優化。它將 Node.js 特有的依賴性換成了與瀏覽器相容的替代品，例如 `wolfy87-eventemitter`。如果您正在建構一個對效能和載入時間至關重要的 Web 應用程式，這個客戶端提供了 OCAP 的核心功能，而沒有完整輔助方法套件的額外負擔。
+專為前端網頁應用程式設計，`GraphqlClientLite` 擴充了 `GraphQLClientBase`，並針對最小化套件大小進行了最佳化。它將 Node.js 特有的依賴項替換為瀏覽器相容的替代方案，例如 `wolfy87-eventemitter`。如果您正在建構一個對效能和載入時間至關重要的網頁應用程式，此用戶端可以在不增加完整輔助方法套件額外負擔的情況下，提供核心的 OCAP 功能。
 
-## 我應該使用哪個客戶端？
+## 我該使用哪個用戶端？
 
-為了幫助您決定，以下是針對每種情境推薦的客戶端摘要：
+為幫助您決定，以下是針對各種情境的建議用戶端摘要：
 
-| 環境 | 使用情境 | 推薦的客戶端 | 導入路徑 |
+| 環境 | 使用情境 | 建議的用戶端 | 匯入路徑 |
 | :---------- | :------------------------------------------- | :----------------------- | :---------------------- |
-| Node.js | 後端服務、腳本、CLI 工具 | `NativeGraphqlClient` | `@ocap/client/node` |
-| 瀏覽器 | 一般 Web 應用程式（例如 React、Vue） | `GraphQLClient` | `@ocap/client` |
-| 瀏覽器 | 對程式碼包大小敏感的應用程式 | `GraphqlClientLite` | `@ocap/client/lite` |
-| 任何環境 | 唯讀，需要最少功能 | `GraphQLClientBase` | `@ocap/client/base` |
+| Node.js     | 後端服務、指令碼、CLI 工具         | `NativeGraphqlClient`    | `@ocap/client/node`     |
+| 瀏覽器     | 一般網頁應用程式 (例如 React、Vue)  | `GraphQLClient`          | `@ocap/client`          |
+| 瀏覽器     | 對套件大小敏感的應用程式           | `GraphqlClientLite`      | `@ocap/client/lite`     |
+| 任何環境         | 唯讀、需要最少功能    | `GraphQLClientBase`      | `@ocap/client/base`     |
 
-### 導入範例
+### 匯入範例
 
-以下是在您的程式碼中導入每個客戶端的方式：
+以下是在您的程式碼中匯入各個用戶端的方法：
 
-```javascript Node.js Client icon=logos:nodejs-icon
+```javascript Node.js 用戶端 icon=logos:nodejs-icon
 const NativeGraphqlClient = require('@ocap/client/node');
 const client = new NativeGraphqlClient('https://beta.abtnetwork.io/api');
 ```
 
-```javascript Full Browser Client icon=logos:javascript
+```javascript 完整瀏覽器用戶端 icon=logos:javascript
 const GraphQLClient = require('@ocap/client');
 const client = new GraphQLClient('https://beta.abtnetwork.io/api');
 ```
 
-```javascript Lite Browser Client icon=logos:javascript
+```javascript 輕量瀏覽器用戶端 icon=logos:javascript
 const GraphqlClientLite = require('@ocap/client/lite');
 const client = new GraphqlClientLite('https://beta.abtnetwork.io/api');
 ```
 
 ## 總結
 
-了解不同的客戶端實作可以讓您做出最適合您應用程式環境和需求的明智選擇。透過選擇適當的客戶端，您可以優化效能、程式碼包大小和易用性。
+了解不同的用戶端實作，能讓您根據應用程式的環境和需求做出明智的選擇。透過選擇適當的用戶端，您可以針對效能、套件大小和易用性進行最佳化。
 
-現在您已經了解了客戶端架構，可以更深入地了解交易是如何建構和處理的。在 [交易生命週期](./core-concepts-transaction-lifecycle.md) 指南中了解更多資訊。
+現在您已經了解了用戶端架構，可以更深入地研究交易是如何建構和處理的。請在 [交易生命週期](./core-concepts-transaction-lifecycle.md) 指南中了解更多資訊。

package/docs/core-concepts-client-architecture.zh.md

@@ -1,33 +1,33 @@
 # 客户端架构
 
-OCAP 客户端采用模块化架构设计，以适应不同的 JavaScript 环境和特定用例。它不提供一个通用的库，而是提供了多个客户端实现，每个实现都针对特定上下文进行了优化，例如 Node.js 后端或对包大小敏感的 Web 应用。这种方法允许您根据需要选择最高效的客户端，从而在必要时确保更好的性能和更小的体积。
+OCAP 客户端采用模块化架构设计，以满足不同 JavaScript 环境和特定用例的需求。它并非提供一个“一刀切”的库，而是提供了多种客户端实现，每种实现都针对特定上下文进行了优化，例如 Node.js 后端或对包大小敏感的 Web 应用程序。这种方法让您可以根据需要选择最高效的客户端，从而在必要时确保更好的性能和更小的占用空间。
 
-所有客户端变体都构建在一个通用的基础 `GraphQLClientBase` 之上，该基础提供了与区块链的 GraphQL API 交互的核心功能。
+所有客户端变体都构建于一个通用基础 `GraphQLClientBase` 之上，该基础提供了与区块链的 GraphQL API 交互的核心功能。
 
 ### 继承关系图
 
-下图展示了不同客户端实现之间的关系：
+下图说明了不同客户端实现之间的关系：
 
 ```d2
 direction: down
 
 GraphQLClientBase: {
-  label: "GraphQLClientBase\n(核心功能)"
+  label: "GraphQLClientBase\n（核心功能）"
   shape: rectangle
 }
 
 GraphQLClient: {
-  label: "GraphQLClient\n(完整客户端 + 辅助方法)"
+  label: "GraphQLClient\n（完整客户端 + 辅助方法）"
   shape: rectangle
 }
 
 GraphqlClientLite: {
-  label: "GraphqlClientLite\n(浏览器优化)"
+  label: "GraphqlClientLite\n（浏览器优化）"
   shape: rectangle
 }
 
 NativeGraphqlClient: {
-  label: "NativeGraphqlClient\n(Node.js 优化)"
+  label: "NativeGraphqlClient\n（Node.js 优化）"
   shape: rectangle
 }
 
@@ -40,41 +40,41 @@ GraphQLClient -> NativeGraphqlClient: "扩展"
 
 以下是每种可用客户端及其预期用例的详细说明。
 
-### `GraphQLClientBase` (核心)
+### `GraphQLClientBase`（核心）
 
-这是所有其他客户端扩展的基础轻量级客户端。它提供了与区块链通信的基本功能：
+这是所有其他客户端都扩展的基础、轻量级客户端。它提供了与区块链通信的基本功能：
 
 - 发送 GraphQL 查询和变更。
-- 建立 WebSocket 连接以进行实时事件订阅。
-- 处理赞助交易的 gas 支付头。
-- 它是环境无关的，但如果您使用订阅功能，则需要为 WebSocket 和 EventEmitter 提供兼容的实现。
+- 建立用于实时事件订阅的 WebSocket 连接。
+- 处理用于代付交易的 gas 支付头。
+- 它与环境无关，但如果您使用订阅功能，则需要为 WebSocket 和 EventEmitter 提供兼容的实现。
 
 如果您只需要基本的只读功能并希望最小化依赖项，那么这个客户端是理想的选择。
 
-### `GraphQLClient` (完整客户端)
+### `GraphQLClient`（完整客户端）
 
-这是标准的通用客户端，也是您最可能经常使用的客户端。它扩展了 `GraphQLClientBase` 并添加了一套丰富的高级辅助方法，以简化常见的链上操作。这些辅助方法涵盖了创建资产、转移通证和管理质押等任务，抽象了原始 GraphQL 变更的复杂性。
+这是标准的、通用的客户端，也是您最可能经常使用的客户端。它扩展了 `GraphQLClientBase`，并添加了一组丰富的高级辅助方法，以简化常见的链上操作。这些辅助方法涵盖了创建资产、转移通证和管理质押等任务，将原始 GraphQL 变更的复杂性抽象出来。
 
-默认情况下，它在实例化时也会自动初始化其上下文，使其可以立即使用。
+默认情况下，它还在实例化时自动初始化其上下文，使其可以立即使用。
 
-### `NativeGraphqlClient` (适用于 Node.js)
+### `NativeGraphqlClient`（用于 Node.js）
 
-该客户端专门为 Node.js 运行时进行了优化。它扩展了完整的 `GraphQLClient`，并将其配置为使用 Node.js 的原生 `events` 模块进行事件处理。这使其成为任何后端应用、命令行工具或在服务器上运行的脚本的最高性能和最可靠的选择。
+该客户端专门为 Node.js 运行时进行了优化。它扩展了完整的 `GraphQLClient`，并将其配置为使用 Node.js 的原生 `events` 模块进行事件处理。这使其成为任何在服务器上运行的后端应用程序、命令行工具或脚本的性能最高、最可靠的选择。
 
-### `GraphqlClientLite` (适用于浏览器)
+### `GraphqlClientLite`（用于浏览器）
 
-专为前端 Web 应用设计的 `GraphqlClientLite` 扩展了 `GraphQLClientBase`，并针对最小化包大小进行了优化。它将 Node.js 特定的依赖项替换为浏览器兼容的替代方案，如 `wolfy87-eventemitter`。如果您正在构建一个对性能和加载时间至关重要的 Web 应用，此客户端可在不增加完整辅助方法套件额外负担的情况下，提供 OCAP 的核心功能。
+`GraphqlClientLite` 专为前端 Web 应用程序设计，它扩展了 `GraphQLClientBase` 并为最小化包体积进行了优化。它将 Node.js 特定的依赖项替换为浏览器兼容的替代品，如 `wolfy87-eventemitter`。如果您正在构建一个性能和加载时间至关重要的 Web 应用程序，该客户端可以在不增加完整辅助方法套件额外负担的情况下提供核心 OCAP 功能。
 
 ## 我应该使用哪个客户端？
 
-为了帮助您决定，以下是针对每种场景推荐的客户端摘要：
+为了帮助您做出决定，以下是针对每种场景推荐的客户端摘要：
 
-| 环境 | 用例 | 推荐客户端 | 导入路径 |
+| 环境 | 使用场景 | 推荐客户端 | 导入路径 |
 | :---------- | :------------------------------------------- | :----------------------- | :---------------------- |
 | Node.js | 后端服务、脚本、CLI 工具 | `NativeGraphqlClient` | `@ocap/client/node` |
 | 浏览器 | 通用 Web 应用（例如 React、Vue） | `GraphQLClient` | `@ocap/client` |
-| 浏览器 | 对包大小敏感的应用 | `GraphqlClientLite` | `@ocap/client/lite` |
-| 任何 | 只读，需要最少的功能 | `GraphQLClientBase` | `@ocap/client/base` |
+| 浏览器 | 对包体积敏感的应用 | `GraphqlClientLite` | `@ocap/client/lite` |
+| 任何环境 | 只读，仅需最少功能 | `GraphQLClientBase` | `@ocap/client/base` |
 
 ### 导入示例
 
@@ -90,13 +90,13 @@ const GraphQLClient = require('@ocap/client');
 const client = new GraphQLClient('https://beta.abtnetwork.io/api');
 ```
 
-```javascript 轻量浏览器客户端 icon=logos:javascript
+```javascript Lite 浏览器客户端 icon=logos:javascript
 const GraphqlClientLite = require('@ocap/client/lite');
 const client = new GraphqlClientLite('https://beta.abtnetwork.io/api');
 ```
 
 ## 总结
 
-了解不同的客户端实现可以让您做出最适合您应用环境和需求的明智选择。通过选择合适的客户端，您可以优化性能、包大小和易用性。
+了解不同的客户端实现，可以帮助您根据应用程序的环境和需求做出明智的选择。通过选择合适的客户端，您可以优化性能、包体积和易用性。
 
-现在您已经了解了客户端架构，可以更深入地研究交易是如何构建和处理的。请在[交易生命周期](./core-concepts-transaction-lifecycle.md)指南中了解更多信息。
+现在您已经了解了客户端架构，可以更深入地了解交易是如何构建和处理的。请在[交易生命周期](./core-concepts-transaction-lifecycle.md)指南中了解更多信息。