@ocap/client 1.25.6 → 1.26.1

package/docs/core-concepts-event-subscriptions.ja.md

@@ -1,27 +1,27 @@
 # イベントサブスクリプション
 
-OCAP Clientは、アプリケーションがオンチェーンのアクティビティをリアルタイムでリッスンできる、強力なイベントサブスクリプションシステムを提供します。この機能はWebSocket上に構築されており、ブロックチェーンノードへの永続的な接続を提供することで、更新をチェックするための継続的なポーリングを不要にします。
+OCAP Clientは、アプリケーションがオンチェーンアクティビティをリアルタイムでリッスンできるようにする、強力なリアルタイムイベントサブスクリプションシステムを提供します。この機能はWebSocket上に構築されており、ブロックチェーンノードへの永続的な接続を提供し、更新をチェックするための継続的なポーリングの必要性をなくします。
 
-特定のイベントトピックをサブスクライブすることで、新しいトランザクションの作成、アセットの転送、トークンの交換など、幅広いオンチェーンイベントの即時通知を受け取ることができます。これは、ブロックチェーンの状態変化にリアルタイムで反応する、レスポンシブでインタラクティブなアプリケーションを構築するために不可欠です。これらのイベントが何によってトリガーされるかをより深く理解するには、[トランザクションライフサイクル](./core-concepts-transaction-lifecycle.md)を参照することをお勧めします。
+特定のイベントトピックをサブスクライブすることで、新しいトランザクションが作成されたとき、アセットが転送されたとき、またはトークンが交換されたときなど、さまざまなオンチェーンイベントの即時通知を受け取ることができます。これは、ブロックチェーンの状態変化にリアルタイムで反応する、レスポンシブでインタラクティブなアプリケーションを構築するために不可欠です。これらのイベントが何によってトリガーされるかをより深く理解するには、[トランザクションライフサイクル](./core-concepts-transaction-lifecycle.md)を確認することをお勧めします。
 
 ## 仕組み
 
-内部的には、イベントを初めてサブスクライブすると、OCAP Clientはブロックチェーンノードの指定されたエンドポイントへのWebSocket接続を自動的に確立します。この接続は維持され、イベントが発生するとすぐにノードがクライアントに直接イベントデータをプッシュできるようになります。
+内部では、イベントを最初にサブスクライブすると、OCAP Clientは自動的にブロックチェーンノードの指定されたエンドポイントへのWebSocket接続を確立します。この接続は維持され、イベントが発生するとすぐにノードがクライアントにイベントデータを直接プッシュできるようになります。
 
-クライアントがWebSocket接続のライフサイクルを管理します。初期接続の処理、接続をアクティブに保つためのハートビートメッセージの送信、接続が切断された場合の再接続試行などを行います。これにより、最小限の設定で安定した信頼性の高いイベントストリームが保証されます。
+クライアントはWebSocket接続のライフサイクルを管理します。初回接続を処理し、接続をアクティブに保つためにハートビートメッセージを送信し、接続が切断された場合に再接続を試みます。これにより、最小限の設定で安定した信頼性の高いイベントストリームが保証されます。
 
 ## イベントのサブスクライブ
 
-イベントのリッスンを開始するには、`subscribe`メソッドを使用します。イベントを識別する文字列であるイベントトピックと、そのイベントが受信されるたびに実行されるコールバック関数を提供します。
+イベントのリッスンを開始するには、`subscribe` メソッドを使用します。イベントトピック（イベントを識別する文字列）と、そのイベントが受信されるたびに実行されるコールバック関数を提供します。
 
 ```javascript OCAP Client icon=logos:javascript
 const client = new GraphQLClient('https://beta.abtnetwork.io/api/v2/gql');
 
 const handleNewTransaction = (eventData) => {
-  console.log('A new transaction was created on-chain:', eventData);
+  console.log('新しいトランザクションがオンチェーンで作成されました:', eventData);
 };
 
-// 'tx.create'トピックをサブスクライブする
+// 'tx.create' トピックをサブスクライブ
 client.subscribe('tx.create', handleNewTransaction);
 ```
 
@@ -30,24 +30,24 @@ client.subscribe('tx.create', handleNewTransaction);
 **`subscribe(topic, callback)`**
 
 <x-field-group>
-  <x-field data-name="topic" data-type="string" data-required="true" data-desc="サブスクライブするイベントトピックの名前。例：'tx.create'。"></x-field>
+  <x-field data-name="topic" data-type="string" data-required="true" data-desc="サブスクライブするイベントトピックの名前。例: 'tx.create'。"></x-field>
   <x-field data-name="callback" data-type="Function" data-required="true" data-desc="イベントが受信されたときに実行される関数。イベントデータは最初の引数として渡されます。"></x-field>
 </x-field-group>
 
 ### 一般的なイベントトピック
 
-イベントトピックは通常、`tx.<transaction_type>`のパターンに従います。以下に一般的な例をいくつか示します：
+イベントトピックは通常、`tx.<transaction_type>` のパターンに従います。以下にいくつかの一般的な例を示します。
 
-| Topic | Description |
+| トピック | 説明 |
 |---|---|
 | `tx.create` | 新しいトランザクションが正常に処理され、ブロックに追加されたときに発行されます。 |
-| `tx.transfer_v2` | `transferV2`トランザクションが発生したときに特に発行されます。 |
-| `tx.exchange_v2` | `exchangeV2`（アトミックスワップ）トランザクションが完了したときに発行されます。 |
-| `tx.create_asset` | 新しいアセット（NFT）が作成されたときに発行されます。 |
+| `tx.transfer_v2` | 特に `transferV2` トランザクションが発生したときに発行されます。 |
+| `tx.exchange_v2` | `exchangeV2` (アトミックスワップ) トランザクションが完了したときに発行されます。 |
+| `tx.create_asset` | 新しいアセット (NFT) が作成されたときに発行されます。 |
 
 ## イベントのサブスクライブ解除
 
-サブスクリプションが不要になった場合は、クリーンアップすることをお勧めします。特に、コンポーネントがマウントおよびアンマウントされるシングルページアプリケーションでは重要です。これにより、メモリリークや不要な処理を防ぐことができます。サブスクリプションは`unsubscribe`メソッドを使用して削除できます。
+特にコンポーネントがマウントおよびアンマウントされるシングルページアプリケーションでは、不要になったサブスクリプションをクリーンアップすることをお勧めします。これにより、メモリリークや不要な処理を防ぐことができます。`unsubscribe` メソッドを使用してサブスクリプションを削除できます。
 
 ```javascript OCAP Client icon=logos:javascript
 // 特定のリスナーを削除するには、同じコールバック関数の参照を渡します
@@ -63,12 +63,12 @@ client.unsubscribe('tx.create');
 
 <x-field-group>
   <x-field data-name="topic" data-type="string" data-required="true" data-desc="サブスクライブを解除するイベントトピックの名前。"></x-field>
-  <x-field data-name="callback" data-type="Function" data-required="false" data-desc="任意。削除する特定のコールバック関数。省略した場合、指定されたトピックのすべてのリスナーが削除されます。"></x-field>
+  <x-field data-name="callback" data-type="Function" data-required="false" data-desc="オプション。削除する特定のコールバック関数。省略した場合、指定されたトピックのすべてのリスナーが削除されます。"></x-field>
 </x-field-group>
 
 ## 完全な例
 
-以下は、イベントのサブスクライブ、トリガー、そしてサブスクライブ解除をデモンストレーションする完全な例です。
+イベントのサブスクライブ、トリガー、そしてサブスクライブ解除を実演する完全な例を以下に示します。
 
 ```javascript Event Subscription Lifecycle icon=logos:javascript
 import GraphQLClient from '@ocap/client';
@@ -82,35 +82,35 @@ const main = async () => {
   client.subscribe('tx.create', () => (events.txCreate += 1));
   client.subscribe('tx.transfer_v2', () => (events.txTransfer += 1));
 
-  console.log('Subscribed to tx.create and tx.transfer_v2 events...');
+  console.log('tx.create および tx.transfer_v2 イベントをサブスクライブしました...');
 
   // 短時間待機するためのヘルパー
   const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
-  await sleep(100); // サブスクリプションが登録されるまで少し待つ
+  await sleep(100); // サブスクリプションが登録されるまで少し待機
 
   // 2. イベントをトリガーするアクションを実行
-  // 注：これには資金のあるウォレットが必要です。テストトークンは https://faucet.abtnetwork.io/ から入手できます
+  // 注: これには資金のあるウォレットが必要です。テストトークンは https://faucet.abtnetwork.io/ から入手できます。
   const sender = fromRandom(); // 実際のアプリでは、資金のあるウォレットをロードします
-  // この例では、アクションが成功すると仮定します。
-  console.log('A transfer transaction would trigger the event handlers.');
+  // この例では、アクションが成功することを前提とします。
+  console.log('転送トランザクションはイベントハンドラをトリガーします。');
   
-  // 実際のシナリオでは、転送が成功した後：
+  // 実際のシナリオでは、転送が成功した後:
   // await client.transfer({ to: 'z1...', token: 1, wallet: sender });
 
-  // トランザクション成功後にイベントカウンターがインクリメントされることをシミュレートしましょう
+  // 成功したトランザクションの後にイベントカウンターが増加するのをシミュレートしてみましょう
   events.txCreate = 1;
   events.txTransfer = 1;
 
-  await sleep(100); // イベントが処理されるのを待つ
+  await sleep(100); // イベントが処理されるのを待機
 
   // 3. イベントハンドラが呼び出されたことを確認
-  console.log(`tx.create was called ${events.txCreate} time(s).`);
-  console.log(`tx.transfer_v2 was called ${events.txTransfer} time(s).`);
+  console.log(`tx.create は ${events.txCreate} 回呼び出されました。`);
+  console.log(`tx.transfer_v2 は ${events.txTransfer} 回呼び出されました。`);
 
   // 4. クリーンアップのためにサブスクライブを解除
   client.unsubscribe('tx.create');
   client.unsubscribe('tx.transfer_v2');
-  console.log('Unsubscribed from events.');
+  console.log('イベントのサブスクライブを解除しました。');
 };
 
 main().catch(console.error);
@@ -118,6 +118,6 @@ main().catch(console.error);
 
 ## まとめ
 
-イベントサブスクリプションは、OCAP Clientを使用して動的なdAppsを構築するためのコア機能です。信頼性の高いWebSocket接続を使用して、オンチェーンイベントにリアルタイムで反応するためのシンプルかつ強力なAPIを提供します。`subscribe`および`unsubscribe`メソッドを使用することで、アプリケーション内のリアルタイムデータフローを効率的に管理できます。
+イベントサブスクリプションは、OCAP Clientを使用して動的なdAppを構築するためのコア機能です。信頼性の高いWebSocket接続を使用してオンチェーンイベントにリアルタイムで反応するための、シンプルかつ強力なAPIを提供します。`subscribe` および `unsubscribe` メソッドを使用することで、アプリケーション内のリアルタイムデータフローを効率的に管理できます。
 
-これらのイベントを生成するトランザクションの構築と送信方法の詳細については、[トランザクションライフサイクル](./core-concepts-transaction-lifecycle.md)のドキュメントを参照してください。イベントリスナーと組み合わせると便利な、ユーザーのトランザクション手数料をスポンサーする方法については、[ガス支払い](./core-concepts-gas-payment.md)をお読みください。
+トランザクションがどのように構築・送信され、それがこれらのイベントを生成するかの詳細については、[トランザクションライフサイクル](./core-concepts-transaction-lifecycle.md)のドキュメントを参照してください。イベントリスナーと組み合わせると便利な、ユーザーのトランザクション手数料をスポンサーする方法については、[ガス支払い](./core-concepts-gas-payment.md)をお読みください。

package/docs/core-concepts-event-subscriptions.zh-TW.md

@@ -1,18 +1,18 @@
 # 事件訂閱
 
-OCAP Client 提供了一個功能強大的即時事件訂閱系統，讓您的應用程式能夠在鏈上活動發生時即時監聽。此功能基於 WebSockets 建立，提供與區塊鏈節點的持久連接，無需透過持續輪詢來檢查更新。
+OCAP Client 提供一個功能強大、即時的事件訂閱系統，讓您的應用程式能夠即時監聽鏈上活動。此功能基於 WebSockets 建立，提供與區塊鏈節點的持久連線，無需透過持續輪詢來檢查更新。
 
-透過訂閱特定的事件主題，您可以即時收到各種鏈上事件的通知，例如新交易的建立、資產的轉移或代幣的交換。這對於建立能即時回應區塊鏈狀態變化的響應式和互動式應用程式至關重要。若想更深入了解觸發這些事件的原因，您可以參閱 [交易生命週期](./core-concepts-transaction-lifecycle.md)。
+透過訂閱特定的事件主題，您可以接收到各種鏈上事件的即時通知，例如新交易建立、資產轉移或代幣交換。這對於建構能即時回應區塊鏈狀態變化的互動式應用程式至關重要。若想深入了解觸發這些事件的原因，您可以參閱 [交易生命週期](./core-concepts-transaction-lifecycle.md)。
 
-## 運作原理
+## 運作方式
 
-在底層，當您首次訂閱事件時，OCAP Client 會自動與區塊鏈節點的指定端點建立 WebSocket 連接。此連接會保持活動狀態，讓節點能在事件發生時立即將事件資料推送到您的客戶端。
+在底層，當您首次訂閱事件時，OCAP Client 會自動與區塊鏈節點的指定端點建立 WebSocket 連線。此連線會保持活動狀態，讓節點能在事件發生時立即將事件資料推送至您的客戶端。
 
-客戶端會為您管理 WebSocket 的連接生命週期，包括處理初始連接、發送心跳訊息以維持連接，以及在連接中斷時嘗試重新連接。這確保了您只需進行最少的設定，就能獲得穩定可靠的事件流。
+客戶端會為您管理 WebSocket 連線的生命週期。它會處理初始連線、發送心跳訊息以維持連線，並在連線中斷時嘗試重新連線。這確保了穩定可靠的事件流，而您只需進行最少的設定。
 
 ## 訂閱事件
 
-若要開始監聽事件，請使用 `subscribe` 方法。您需要提供一個事件主題（用來識別事件的字串）和一個回呼函式，每當收到該事件時，此函式便會執行。
+若要開始監聽事件，請使用 `subscribe` 方法。您需要提供一個事件主題（用於識別事件的字串）和一個回呼函式，該函式將在每次收到事件時執行。
 
 ```javascript OCAP Client icon=logos:javascript
 const client = new GraphQLClient('https://beta.abtnetwork.io/api/v2/gql');
@@ -21,33 +21,33 @@ const handleNewTransaction = (eventData) => {
   console.log('A new transaction was created on-chain:', eventData);
 };
 
-// Subscribe to the 'tx.create' topic
+// 訂閱 'tx.create' 主題
 client.subscribe('tx.create', handleNewTransaction);
 ```
 
-### 方法簽名
+### 方法簽章
 
 **`subscribe(topic, callback)`**
 
 <x-field-group>
   <x-field data-name="topic" data-type="string" data-required="true" data-desc="要訂閱的事件主題名稱。例如：'tx.create'。"></x-field>
-  <x-field data-name="callback" data-type="Function" data-required="true" data-desc="收到事件時要執行的函式。事件資料會作為第一個參數傳入。"></x-field>
+  <x-field data-name="callback" data-type="Function" data-required="true" data-desc="接收到事件時要執行的函式。事件資料會作為第一個參數傳入。"></x-field>
 </x-field-group>
 
 ### 常見事件主題
 
-事件主題通常遵循 `tx.<transaction_type>` 的格式。以下是一些常見範例：
+事件主題通常遵循 `tx.<transaction_type>` 的模式。以下是一些常見範例：
 
 | Topic | Description |
 |---|---|
-| `tx.create` | 當任何新交易成功處理並加入區塊時觸發。 |
-| `tx.transfer_v2` | 當 `transferV2` 交易發生時觸發。 |
+| `tx.create` | 任何新交易成功處理並加入區塊時觸發。 |
+| `tx.transfer_v2` | 當 `transferV2` 交易發生時特別觸發。 |
 | `tx.exchange_v2` | 當 `exchangeV2`（原子交換）交易完成時觸發。 |
 | `tx.create_asset` | 當新資產（NFT）被建立時觸發。 |
 
 ## 取消訂閱事件
 
-當不再需要訂閱時，最好將其清除，尤其是在元件會掛載和卸載的單頁應用程式中。這樣可以防止記憶體洩漏和不必要的處理。您可以使用 `unsubscribe` 方法來移除訂閱。
+當不再需要訂閱時，最好進行清理，特別是在元件會掛載和卸載的單頁應用程式中。這可以防止記憶體洩漏和不必要的處理。您可以使用 `unsubscribe` 方法來移除訂閱。
 
 ```javascript OCAP Client icon=logos:javascript
 // 若要移除特定的監聽器，請傳入相同的回呼函式參考
@@ -57,18 +57,18 @@ client.unsubscribe('tx.create', handleNewTransaction);
 client.unsubscribe('tx.create');
 ```
 
-### 方法簽名
+### 方法簽章
 
 **`unsubscribe(topic, [callback])`**
 
 <x-field-group>
   <x-field data-name="topic" data-type="string" data-required="true" data-desc="要取消訂閱的事件主題名稱。"></x-field>
-  <x-field data-name="callback" data-type="Function" data-required="false" data-desc="選填。要移除的特定回呼函式。如果省略，該主題的所有監聽器都將被移除。"></x-field>
+  <x-field data-name="callback" data-type="Function" data-required="false" data-desc="選用。要移除的特定回呼函式。如果省略，將移除該主題的所有監聽器。"></x-field>
 </x-field-group>
 
 ## 完整範例
 
-以下是一個完整範例，示範了如何訂閱事件、觸發事件，然後取消訂閱。
+以下是一個完整範例，示範了訂閱事件、觸發事件，然後取消訂閱的過程。
 
 ```javascript Event Subscription Lifecycle icon=logos:javascript
 import GraphQLClient from '@ocap/client';
@@ -86,24 +86,24 @@ const main = async () => {
 
   // 輔助函式，用於等待一小段時間
   const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
-  await sleep(100); // 稍待片刻，讓訂閱註冊成功
+  await sleep(100); // 稍待片刻，以便訂閱註冊成功
 
   // 2. 執行一個會觸發事件的動作
-  // 注意：這需要一個有資金的錢包。您可以從 https://faucet.abtnetwork.io/ 獲取測試代幣
+  // 注意：這需要一個有資金的錢包。您可以從 https://faucet.abtnetwork.io/ 獲取測試代幣。
   const sender = fromRandom(); // 在實際應用中，請載入一個有資金的錢包
   // 在此範例中，我們假設該動作會成功。
   console.log('A transfer transaction would trigger the event handlers.');
   
-  // 在真實情境中，成功轉帳後：
+  // 在實際情境中，成功轉帳後：
   // await client.transfer({ to: 'z1...', token: 1, wallet: sender });
 
-  // 讓我們模擬成功交易後事件計數器增加的情況
+  // 讓我們模擬在成功交易後事件計數器增加的情況
   events.txCreate = 1;
   events.txTransfer = 1;
 
   await sleep(100); // 等待事件處理完成
 
-  // 3. 驗證事件處理器是否被呼叫
+  // 3. 驗證事件處理函式是否被呼叫
   console.log(`tx.create was called ${events.txCreate} time(s).`);
   console.log(`tx.transfer_v2 was called ${events.txTransfer} time(s).`);
 
@@ -118,6 +118,6 @@ main().catch(console.error);
 
 ## 總結
 
-事件訂閱是使用 OCAP Client 建立動態 dApp 的核心功能。它提供了一個簡單而強大的 API，可透過可靠的 WebSocket 連接即時回應鏈上事件。透過使用 `subscribe` 和 `unsubscribe` 方法，您可以有效管理應用程式中的即時資料流。
+事件訂閱是使用 OCAP Client 建構動態 dApp 的核心功能。它們提供了一個簡單而強大的 API，可透過可靠的 WebSocket 連線即時回應鏈上事件。透過使用 `subscribe` 和 `unsubscribe` 方法，您可以有效率地管理應用程式中的即時資料流。
 
-關於如何建構和發送交易（進而產生這些事件）的更多詳細資訊，請參閱 [交易生命週期](./core-concepts-transaction-lifecycle.md) 文件。若要了解如何為使用者贊助交易費用（這在與事件監聽器結合使用時非常有用），請閱讀關於 [Gas 支付](./core-concepts-gas-payment.md) 的內容。
+有關如何建構和發送交易（進而產生這些事件）的更多詳細資訊，請參閱 [交易生命週期](./core-concepts-transaction-lifecycle.md) 文件。若要探索如何為您的使用者贊助交易費用（這在與事件監聽器結合使用時非常有用），請閱讀有關 [Gas 費用支付](./core-concepts-gas-payment.md) 的內容。

package/docs/core-concepts-event-subscriptions.zh.md

@@ -1,18 +1,18 @@
 # 事件订阅
 
-OCAP Client 提供了一个强大的实时事件订阅系统，允许您的应用程序在链上活动发生时进行监听。该功能基于 WebSocket 构建，提供与区块链节点的持久连接，无需通过持续轮询来检查更新。
+OCAP Client 提供了一个强大的实时事件订阅系统，允许您的应用程序实时监听链上活动。该功能基于 WebSocket 构建，提供与区块链节点的持久连接，无需通过持续轮询来检查更新。
 
-通过订阅特定的事件主题，您可以接收各种链上事件的即时通知，例如当新交易创建、资产转移或代币交换时。这对于构建能够实时响应区块链状态变化的响应式和交互式应用程序至关重要。要更深入地了解触发这些事件的原因，您可能需要查阅[交易生命周期](./core-concepts-transaction-lifecycle.md)。
+通过订阅特定的事件主题，您可以收到各种链上事件的即时通知，例如新交易创建、资产转移或代币交换。这对于构建能够实时响应区块链状态变化的响应式和交互式应用程序至关重要。要更深入地了解触发这些事件的原因，您可能需要查看[交易生命周期](./core-concepts-transaction-lifecycle.md)。
 
 ## 工作原理
 
-在底层，当您首次订阅事件时，OCAP Client 会自动与区块链节点的指定端点建立 WebSocket 连接。此连接将保持活动状态，允许节点在事件发生时立即将事件数据推送至您的客户端。
+在底层，当您首次订阅事件时，OCAP Client 会自动与区块链节点的指定端点建立 WebSocket 连接。该连接会保持活动状态，允许节点在事件发生时立即将事件数据推送到您的客户端。
 
-客户端为您管理 WebSocket 连接的生命周期。它处理初始连接，发送心跳消息以保持连接活跃，并在连接断开时尝试重新连接。这确保了事件流的稳定和可靠，而您只需进行最少的配置。
+客户端会为您管理 WebSocket 连接的生命周期。它会处理初始连接、发送心跳消息以保持连接活跃，并在连接断开时尝试重新连接。这确保了事件流的稳定可靠，而您只需进行最少的配置。
 
 ## 订阅事件
 
-要开始监听事件，您可以使用 `subscribe` 方法。您需要提供一个事件主题（标识事件的字符串）和一个回调函数，该函数将在收到事件时执行。
+要开始监听事件，您可以使用 `subscribe` 方法。您需要提供一个事件主题（用于标识事件的字符串）和一个回调函数，该函数会在收到事件时执行。
 
 ```javascript OCAP Client icon=logos:javascript
 const client = new GraphQLClient('https://beta.abtnetwork.io/api/v2/gql');
@@ -30,8 +30,8 @@ client.subscribe('tx.create', handleNewTransaction);
 **`subscribe(topic, callback)`**
 
 <x-field-group>
-  <x-field data-name="topic" data-type="string" data-required="true" data-desc="要订阅的事件主题的名称。例如，'tx.create'。"></x-field>
-  <x-field data-name="callback" data-type="Function" data-required="true" data-desc="接收到事件时要执行的函数。事件数据作为第一个参数传递。"></x-field>
+  <x-field data-name="topic" data-type="string" data-required="true" data-desc="要订阅的事件主题名称。例如 'tx.create'。"></x-field>
+  <x-field data-name="callback" data-type="Function" data-required="true" data-desc="收到事件时要执行的函数。事件数据作为第一个参数传入。"></x-field>
 </x-field-group>
 
 ### 常见事件主题
@@ -40,17 +40,17 @@ client.subscribe('tx.create', handleNewTransaction);
 
 | Topic | Description |
 |---|---|
-| `tx.create` | 当任何新交易成功处理并被添加到区块中时触发。 |
+| `tx.create` | 任何新交易成功处理并添加到区块时触发。 |
 | `tx.transfer_v2` | 当 `transferV2` 交易发生时专门触发。 |
 | `tx.exchange_v2` | 当 `exchangeV2`（原子交换）交易完成时触发。 |
-| `tx.create_asset` | 当新资产（NFT）被创建时触发。 |
+| `tx.create_asset` | 当新资产（NFT）创建时触发。 |
 
 ## 取消订阅事件
 
-在不再需要订阅时进行清理是一个好习惯，特别是在组件会挂载和卸载的单页应用程序中。这可以防止内存泄漏和不必要的处理。您可以使用 `unsubscribe` 方法来移除订阅。
+在不再需要订阅时进行清理是一种良好实践，尤其是在组件会挂载和卸载的单页应用程序中。这样可以防止内存泄漏和不必要的处理。您可以使用 `unsubscribe` 方法移除订阅。
 
 ```javascript OCAP Client icon=logos:javascript
-// 要移除特定的监听器，请传递相同的回调函数引用
+// 要移除特定的监听器，请传入相同的回调函数引用
 client.unsubscribe('tx.create', handleNewTransaction);
 
 // 要移除特定主题的所有监听器
@@ -62,13 +62,13 @@ client.unsubscribe('tx.create');
 **`unsubscribe(topic, [callback])`**
 
 <x-field-group>
-  <x-field data-name="topic" data-type="string" data-required="true" data-desc="要取消订阅的事件主题的名称。"></x-field>
-  <x-field data-name="callback" data-type="Function" data-required="false" data-desc="可选。要移除的特定回调函数。如果省略，将移除该主题的所有监听器。"></x-field>
+  <x-field data-name="topic" data-type="string" data-required="true" data-desc="要取消订阅的事件主题名称。"></x-field>
+  <x-field data-name="callback" data-type="Function" data-required="false" data-desc="可选。要移除的特定回调函数。如果省略，该主题的所有监听器都将被移除。"></x-field>
 </x-field-group>
 
 ## 完整示例
 
-以下是一个完整的示例，演示了订阅事件、触发事件然后取消订阅的过程。
+以下是一个完整的示例，演示了订阅事件、触发事件，然后取消订阅的整个过程。
 
 ```javascript Event Subscription Lifecycle icon=logos:javascript
 import GraphQLClient from '@ocap/client';
@@ -82,35 +82,35 @@ const main = async () => {
   client.subscribe('tx.create', () => (events.txCreate += 1));
   client.subscribe('tx.transfer_v2', () => (events.txTransfer += 1));
 
-  console.log('已订阅 tx.create 和 tx.transfer_v2 事件...');
+  console.log('Subscribed to tx.create and tx.transfer_v2 events...');
 
   // 等待一小段时间的辅助函数
   const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
-  await sleep(100); // 等待片刻以注册订阅
+  await sleep(100); // 稍等片刻，以便订阅注册成功
 
-  // 2. 执行触发事件的操作
-  // 注意：这需要一个有资金的钱包。您可以从 https://faucet.abtnetwork.io/ 获取测试代币。
-  const sender = fromRandom(); // 在真实应用中，加载一个有资金的钱包
-  // 在此示例中，我们假设操作会成功。
-  console.log('一笔转账交易将触发事件处理程序。');
+  // 2. 执行一个触发事件的操作
+  // 注意：这需要一个有资金的钱包。您可以从 https://faucet.abtnetwork.io/ 获取测试代币
+  const sender = fromRandom(); // 在实际应用中，加载一个有资金的钱包
+  // 在本示例中，我们假设操作会成功。
+  console.log('A transfer transaction would trigger the event handlers.');
   
-  // 在真实场景中，成功转账后：
+  // 在实际场景中，成功转账后：
   // await client.transfer({ to: 'z1...', token: 1, wallet: sender });
 
-  // 让我们模拟在成功交易后事件计数器递增
+  // 让我们模拟成功交易后事件计数器递增的情况
   events.txCreate = 1;
   events.txTransfer = 1;
 
   await sleep(100); // 等待事件处理
 
-  // 3. 验证事件处理程序是否被调用
-  console.log(`tx.create 被调用了 ${events.txCreate} 次。`);
-  console.log(`tx.transfer_v2 被调用了 ${events.txTransfer} 次。`);
+  // 3. 验证事件处理函数是否被调用
+  console.log(`tx.create was called ${events.txCreate} time(s).`);
+  console.log(`tx.transfer_v2 was called ${events.txTransfer} time(s).`);
 
   // 4. 取消订阅以进行清理
   client.unsubscribe('tx.create');
   client.unsubscribe('tx.transfer_v2');
-  console.log('已取消事件订阅。');
+  console.log('Unsubscribed from events.');
 };
 
 main().catch(console.error);
@@ -118,6 +118,6 @@ main().catch(console.error);
 
 ## 总结
 
-事件订阅是使用 OCAP Client 构建动态 dApp 的核心功能。它们提供了一个简单而强大的 API，通过可靠的 WebSocket 连接实时响应链上事件。通过使用 `subscribe` 和 `unsubscribe` 方法，您可以有效地管理应用程序中的实时数据流。
+事件订阅是使用 OCAP Client 构建动态 dApp 的核心功能。它们提供了一个简单而强大的 API，通过可靠的 WebSocket 连接实时响应链上事件。通过使用 `subscribe` 和 `unsubscribe` 方法，您可以高效地管理应用程序中的实时数据流。
 
-有关如何构建和发送交易（这些交易会生成这些事件）的更多详细信息，请参阅[交易生命周期](./core-concepts-transaction-lifecycle.md)文档。要了解如何为您的用户赞助交易费用（这在与事件监听器结合使用时非常有用），请阅读[燃料费支付](./core-concepts-gas-payment.md)。
+有关如何构造和发送交易（这些交易会生成这些事件）的更多详细信息，请参阅[交易生命周期](./core-concepts-transaction-lifecycle.md)文档。要了解如何为您的用户代付交易费用（这在与事件监听器结合使用时非常有用），请阅读[燃料费支付](./core-concepts-gas-payment.md)。

package/docs/core-concepts-gas-payment.ja.md

@@ -1,28 +1,28 @@
-# Gas支払い
+# ガス代行支払い
 
-ほとんどのブロックチェーンシステムでは、すべてのトランザクションには、一般的に「ガス」として知られる手数料が必要であり、これは発信者が支払う必要があります。これは、これらの手数料を支払うためのネイティブ通貨を持っていない新規ユーザーにとっては、大きな障壁となり得ます。OCAP Clientは、アプリケーション開発者がこれらの手数料をスポンサーできるGas支払い機能を導入し、ユーザーにシームレスな「ガスレス」体験を提供します。
+ほとんどのブロックチェーンシステムでは、すべてのトランザクションにおいて、開始者が「ガス」として一般的に知られる手数料を支払う必要があります。これは、これらの手数料を支払うためのネイティブ通貨を持っていない可能性のある新規ユーザーにとって、大きな障壁となり得ます。OCAP Clientは、アプリケーション開発者がこれらの手数料を負担できるようにするガス代行支払い機能を導入し、ユーザーにシームレスな「ガスレス」体験を提供します。
 
 この強力な機能により、dAppsはガスの複雑さを抽象化し、ユーザーのオンボーディングとアプリケーション全体のユーザビリティを向上させることができます。
 
 ## 仕組み
 
-ガス支払いメカニズムは、標準のHTTPヘッダーを介して実装されます。クライアントインスタンスにガス支払いウォレットを設定すると、クライアントはブロックチェーンノードに送信するすべての `sendTx` ミューテーションに、2つの特別なヘッダーを自動的に添付します：
+ガス代行支払いの仕組みは、標準的なHTTPヘッダーを通じて実装されます。クライアントインスタンスにガス支払い者ウォレットを設定すると、クライアントはブロックチェーンノードに送信するすべての`sendTx`ミューテーションに、自動的に2つの特別なヘッダーを添付します：
 
 - `x-gas-payer-pk`: ガス料金を支払うウォレットの公開鍵。
-- `x-gas-payer-sig`: ガス支払い者の秘密鍵で署名されたJSON Web Token (JWT)。このトークンにはトランザクションのハッシュが含まれており、その特定のトランザクションの手数料を支払うためのスポンサーからの検証可能な承認として機能します。
+- `x-gas-payer-sig`: ガス支払い者の秘密鍵で署名されたJSON Web Token (JWT)。このトークンにはトランザクションのハッシュが含まれており、その特定のトランザクションの手数料を支払うというスポンサーからの検証可能な承認として機能します。
 
 ブロックチェーンノードがトランザクションを受信すると、2つの重要な検証を実行します：
 
-1. トランザクション自体のユーザーの署名を検証します。
+1. トランザクション自体に対するユーザーの署名を検証します。
 2. ヘッダー内のガス支払い者の署名をトランザクションハッシュと照合して検証します。
 
 両方の署名が有効な場合、トランザクションはユーザーの権限で実行されますが、対応するガス料金はガス支払い者のアカウント残高から差し引かれます。
 
 ### ワークフロー図
 
-以下の図は、トランザクションの開始から実行までのガス支払いフロー全体を示しています：
+以下の図は、トランザクションの開始から実行までのガス代行支払いの全フローを示しています：
 
-```d2 ガス支払いのワークフロー icon=mdi:gas-station
+```d2 ガス代行支払いのワークフロー icon=mdi:gas-station
 direction: down
 
 User-App: {
@@ -31,7 +31,7 @@ User-App: {
 }
 
 Gas-Payer-Wallet: {
-  label: "ガス支払いウォレット\n(アプリバックエンドのウォレット)"
+  label: "ガス支払い者ウォレット\n（アプリバックエンドのウォレット）"
   shape: cylinder
 }
 
@@ -46,8 +46,8 @@ Blockchain-Node: {
 
 User-App -> OCAP-Client: "1. ユーザーがトランザクションを開始"
 OCAP-Client -> OCAP-Client: "2. ユーザーのウォレットで\nTxを準備・署名"
-Gas-Payer-Wallet -> OCAP-Client: "3. ガスのためにTxハッシュに署名"
-OCAP-Client -> Blockchain-Node: "4. Tx + ガス支払いヘッダーを送信"
+Gas-Payer-Wallet -> OCAP-Client: "3. ガス代行支払いのためTxハッシュに署名"
+OCAP-Client -> Blockchain-Node: "4. Tx + ガス支払い者ヘッダーを送信"
 Blockchain-Node -> Blockchain-Node: "5. 両方の署名を検証"
 Blockchain-Node: "6. トランザクションを実行"
 Blockchain-Node -> Gas-Payer-Wallet: "7. ガス料金を差し引く"
@@ -55,37 +55,37 @@ Blockchain-Node -> Gas-Payer-Wallet: "7. ガス料金を差し引く"
 
 ## 使用例
 
-ガスレストランザクションを有効にするには、スポンサーアカウント用のウォレットインスタンスを作成し、`setGasPayer` メソッドを使用してクライアントに設定するだけです。
+ガスレストランザクションを有効にするには、スポンサーアカウント用のウォレットインスタンスを作成し、`setGasPayer`メソッドを使用してクライアントに設定するだけです。
 
-```javascript Gas Payer Setup and Usage icon=logos:javascript
+```javascript ガス支払い者の設定と使用法 icon=logos:javascript
 import Client from '@ocap/client';
 import Wallet, { fromRandom } from '@ocap/wallet';
 
-// 1. Betaチェーンに接続するためにクライアントを初期化します
+// 1. Betaチェーンに接続するためにクライアントを初期化
 const client = new Client('https://beta.abtnetwork.io/api');
 
-// 2. ガス支払い者（アプリケーションのウォレット）用のウォレットを作成します
-// このウォレットには、トランザクション手数料をカバーするのに十分なネイティブトークン（TBA）が必要です。
-// テストトークンはフォーセットから入手できます： https://faucet.abtnetwork.io/
+// 2. ガス支払い者（アプリケーションのウォレット）用のウォレットを作成
+// このウォレットには、トランザクション手数料を賄うのに十分なネイティブトークン（TBA）が必要です。
+// テストトークンはフォーセットから入手できます: https://faucet.abtnetwork.io/
 const gasPayerWallet = Wallet.fromJSON({
   sk: '...your_sponsor_secret_key...',
   pk: '...your_sponsor_public_key...',
   address: '...your_sponsor_address...',
 });
 
-// 3. クライアントインスタンスにガス支払い者を設定します
+// 3. クライアントインスタンスにガス支払い者を設定
 client.setGasPayer(gasPayerWallet);
 
-// 4. エンドユーザー用のウォレットを作成します。
+// 4. エンドユーザー用のウォレットを作成。
 const userWallet = fromRandom();
 
-// 5. ユーザーのウォレットを使用してトランザクションを送信します。
+// 5. ユーザーのウォレットを使用してトランザクションを送信。
 // トランザクションはユーザーによって署名されますが、ガス料金はgasPayerWalletによって支払われます。
 async function performGaslessTransaction() {
   try {
-    // 注：新しいアカウントは最初の受信トランザクションでオンチェーンに作成されますが、
-    // トランザクションを *送信* する前にオンチェーンに存在している必要があります。
-    // フォーセットから少量のトークンを送信することで初期化できます。
+    // 注：新規アカウントは最初の受信トランザクションでオンチェーンに作成されますが、
+    // トランザクションを*送信*する前にオンチェーンに存在している必要があります。
+    // フォーセットから少額のトークンを送信することで初期化できます。
 
     const receiverAddress = 'z1...'; // 有効な受信者アドレス
     const hash = await client.transfer({
@@ -94,18 +94,18 @@ async function performGaslessTransaction() {
       wallet: userWallet,
     });
 
-    console.log('ガスレストランザクション成功。ハッシュ:', hash);
-    console.log(`エクスプローラーで確認: https://beta.abtnetwork.io/explorer/txs/${hash}`);
+    console.log('Gasless transaction successful. Hash:', hash);
+    console.log(`Review on explorer: https://beta.abtnetwork.io/explorer/txs/${hash}`);
   } catch (error) {
-    console.error('トランザクション失敗:', error);
+    console.error('Transaction failed:', error);
   }
 }
 
 performGaslessTransaction();
 ```
 
-この例では、`gasPayerWallet`がコストを負担するため、`userWallet`はネイティブトークンの残高がゼロであってもトランザクションを正常に送信できます。これにより、特にアプリケーションに参加する新規ユーザーにとって、摩擦のない体験が生まれます。
+この例では、`gasPayerWallet`がコストを負担するため、`userWallet`はネイティブトークンの残高がゼロであってもトランザクションを正常に送信できます。これにより、特にアプリケーションに新たに参加するユーザーにとって、摩擦のない体験が実現します。
 
 ---
 
-トランザクションの作成から確定までの全行程を理解するには、[トランザクションライフサイクル](./core-concepts-transaction-lifecycle.md)のドキュメントを参照してください。
+トランザクションの作成から確定までの全行程を理解するには、[トランザクションのライフサイクル](./core-concepts-transaction-lifecycle.md)のドキュメントを参照してください。