@ocap/client 1.25.4 → 1.25.5

package/docs/api-reference-low-level-api.ja.md

@@ -0,0 +1,228 @@
+# 低レベルAPI
+
+低レベルAPIは、トランザクションのライフサイクル全体にわたって詳細な制御を提供します。[高レベルAPI](./api-reference-transaction-helpers.md)が詳細を抽象化するのとは異なり、これらのメソッドを使用すると、手動でトランザクションを構築、エンコード、署名、送信できます。これは、トランザクションがブロードキャストされる前に複数の当事者が署名する必要があるマルチシグネチャワークフローなど、高度なシナリオに最適です。
+
+このAPIは、トランザクションライフサイクルの各段階に対応する4つの主要なメソッドグループに分かれています。
+
+1.  **エンコード**: トランザクションを準備し、バイナリバッファにシリアライズします。
+2.  **署名**: エンコードされたトランザクションにデジタル署名を追加します。
+3.  **マルチシグ**: トランザクションに複数のデジタル署名を追加します。
+4.  **送信**: 署名されたトランザクションをブロックチェーンにブロードキャストします。
+
+## トランザクションのエンコード
+
+エンコードは、トランザクションを作成する最初のステップです。`encode[Type]Tx`メソッドは、コアトランザクションデータ（`itx`）を標準のトランザクション構造でラップし、`chainId`や`nonce`などの必要な詳細を追加します。結果として、人間が読める形式のトランザクションオブジェクトと、署名可能なバイナリバッファが生成されます。
+
+チェーンでサポートされているすべてのトランザクションタイプに対応する`encode`メソッドが存在します。`client.getTxEncodeMethods()`を呼び出すことで、全リストを取得できます。
+
+### `encode[Type]Tx(payload)`
+
+トランザクションに署名せずにエンコードします。
+
+**パラメーター**
+
+<x-field-group>
+  <x-field data-name="tx" data-type="object" data-required="true">
+    <x-field-desc markdown>トランザクションデータオブジェクト。</x-field-desc>
+    <x-field data-name="itx" data-type="object" data-required="true" data-desc="トランザクションタイプに固有の内部トランザクションオブジェクト。"></x-field>
+    <x-field data-name="from" data-type="string" data-required="false" data-desc="送信者のアドレス。指定しない場合、ウォレットから派生します。"></x-field>
+    <x-field data-name="nonce" data-type="number" data-required="false" data-desc="トランザクションのnonce。設定されていない場合、デフォルトは`Date.now()`です。"></x-field>
+    <x-field data-name="chainId" data-type="string" data-required="false" data-desc="チェーンID。指定しない場合、接続されたノードから取得されます。"></x-field>
+  </x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="送信者のアドレスと公開鍵を派生させるために使用されるウォレットオブジェクト。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="該当する場合、権限を委任するアカウントのアドレス。"></x-field>
+</x-field-group>
+
+**戻り値**
+
+<x-field data-name="Promise<object>" data-type="Promise<object>" data-desc="エンコードされたトランザクションを含むオブジェクトに解決されるPromise。">
+  <x-field data-name="object" data-type="object" data-desc="人間が読める形式のトランザクションオブジェクト。"></x-field>
+  <x-field data-name="buffer" data-type="Buffer" data-desc="署名可能な、シリアライズされたトランザクションのバイナリバッファ。"></x-field>
+</x-field>
+
+**例**
+
+```javascript TransferV2Tx icon=logos:javascript
+const { encodeTransferV2Tx } = client;
+const senderWallet = fromRandom();
+const receiverAddress = 'z1...';
+
+const { object, buffer } = await encodeTransferV2Tx({
+  tx: {
+    itx: {
+      to: receiverAddress,
+      value: await client.fromTokenToUnit(10), // 10 ネイティブトークンを転送
+    },
+  },
+  wallet: senderWallet,
+});
+
+console.log('エンコードされたTXオブジェクト:', object);
+console.log('署名するバッファ:', buffer.toString('hex'));
+```
+
+## トランザクションの署名
+
+`sign[Type]Tx`メソッドは、エンコードのステップにデジタル署名の追加を加えて構築されます。これらのメソッドはトランザクションをエンコードし、提供されたウォレットを使用して生成されたバイナリバッファに署名します。
+
+`client.getTxSignMethods()`を呼び出すことで、利用可能な署名メソッドの全リストを取得できます。
+
+### `sign[Type]Tx(payload)`
+
+トランザクションをエンコードし、署名します。
+
+**パラメーター**
+
+<x-field-group>
+  <x-field data-name="tx" data-type="object" data-required="true" data-desc="トランザクションデータオブジェクト。エンコード用と同じです。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="トランザクションの署名に使用されるウォレット。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="該当する場合、デリゲータのアドレス。"></x-field>
+  <x-field data-name="encoding" data-type="string" data-required="false" data-desc="出力のオプションのエンコーディング（'base16'、'hex'、'base58'、'base64'）。省略した場合、トランザクションオブジェクトを返します。"></x-field>
+</x-field-group>
+
+**戻り値**
+
+<x-field data-name="Promise<object|string>" data-type="Promise<object|string>" data-desc="署名されたトランザクションオブジェクト、または`encoding`が指定されている場合はエンコードされた文字列に解決されるPromise。"></x-field>
+
+**例**
+
+```javascript TransferV2Tx icon=logos:javascript
+const { signTransferV2Tx } = client;
+const senderWallet = fromRandom();
+const receiverAddress = 'z1...';
+
+const signedTx = await signTransferV2Tx({
+  tx: {
+    itx: {
+      to: receiverAddress,
+      value: await client.fromTokenToUnit(10),
+    },
+  },
+  wallet: senderWallet,
+});
+
+console.log('署名済みTX:', signedTx);
+```
+
+## トランザクションの送信
+
+`send[Type]Tx`メソッドは、トランザクションをブロックチェーンにブロードキャストする役割を担います。これらのメソッドは、署名されていないトランザクションとウォレットが提供された場合に暗黙的に署名を行うか、すでに署名済みのトランザクションを送信することができます。
+
+`client.getTxSendMethods()`を介して送信メソッドの全リストが利用可能です。
+
+### `send[Type]Tx(payload)`
+
+トランザクションに署名し（必要な場合）、チェーンに送信します。
+
+**パラメーター**
+
+<x-field-group>
+  <x-field data-name="tx" data-type="object" data-required="true" data-desc="トランザクションオブジェクト。署名済みでも未署名でもかまいません。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="トランザクションに署名するためのウォレット。トランザクションが事前に署名されていても、送信者を特定するために必要です。"></x-field>
+  <x-field data-name="signature" data-type="string" data-required="false" data-desc="トランザクションの事前計算された署名。提供された場合、ウォレットは再度署名に使用されません。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="該当する場合、デリゲータのアドレス。"></x-field>
+  <x-field data-name="commit" data-type="boolean" data-default="false" data-required="false" data-desc="解決する前に、トランザクションがブロックにコミットされるのを待つかどうか。"></x-field>
+</x-field-group>
+
+**戻り値**
+
+<x-field data-name="Promise<string>" data-type="Promise<string>" data-desc="トランザクションハッシュに解決されるPromise。"></x-field>
+
+**例：自動署名**
+
+```javascript TransferV2Tx icon=logos:javascript
+const { sendTransferV2Tx } = client;
+const senderWallet = fromRandom();
+const receiverAddress = 'z1...';
+
+// クライアントは送信前にsenderWalletを使用してこのトランザクションに署名します。
+const txHash = await sendTransferV2Tx({
+  tx: {
+    itx: {
+      to: receiverAddress,
+      value: await client.fromTokenToUnit(10),
+    },
+  },
+  wallet: senderWallet,
+});
+
+console.log('トランザクションがハッシュで送信されました:', txHash);
+```
+
+**例：事前署名済みトランザクションの送信**
+
+```javascript TransferV2Tx icon=logos:javascript
+// signedTxはsign[Type]Txの例からのものと仮定します
+const { sendTransferV2Tx } = client;
+
+const txHash = await sendTransferV2Tx({
+  tx: signedTx, // 署名済みのトランザクションオブジェクト全体を渡します
+  wallet: senderWallet,
+});
+
+console.log('事前署名されたトランザクションがハッシュで送信されました:', txHash);
+```
+
+## マルチシグネチャトランザクション
+
+複数の署名が必要なワークフロー（アトミックスワップなど）では、`multiSign[Type]Tx`メソッドを使用します。このプロセスでは、まず一方の当事者が（標準の`sign[Type]Tx`メソッドを使用して）トランザクションに署名し、続いて他の当事者が対応する`multiSign[Type]Tx`メソッドを使用して署名を追加します。
+
+`client.getTxMultiSignMethods()`を介して、複数の署名をサポートするトランザクションのリストを取得できます。
+
+### `multiSign[Type]Tx(payload)`
+
+すでに1つ以上の署名があるトランザクションに署名を追加します。
+
+**パラメーター**
+
+<x-field-group>
+  <x-field data-name="tx" data-type="object" data-required="true" data-desc="トランザクションオブジェクト。すでに少なくとも1つの署名が含まれている必要があります。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="現在の署名者のウォレット。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="該当する場合、現在の署名者のデリゲータのアドレス。"></x-field>
+  <x-field data-name="data" data-type="any" data-required="false" data-desc="署名に含めるオプションのデータ。"></x-field>
+  <x-field data-name="encoding" data-type="string" data-required="false" data-desc="出力のオプションのエンコーディング（'base16'、'hex'、'base58'、'base64'）。"></x-field>
+</x-field-group>
+
+**戻り値**
+
+<x-field data-name="Promise<object|string>" data-type="Promise<object|string>" data-desc="新しい署名が追加されたトランザクションオブジェクトに解決されるPromise。"></x-field>
+
+**例：アトミックスワップ (`ExchangeV2Tx`)**
+
+```javascript ExchangeV2Tx icon=logos:javascript
+// 2つの当事者のウォレット
+const aliceWallet = fromRandom();
+const bobWallet = fromRandom();
+
+// 1. Aliceが最初の交換トランザクションを準備し、署名します
+const exchangeTx = {
+  itx: {
+    to: bobWallet.address,
+    sender: {
+      value: await client.fromTokenToUnit(10), // Aliceは10トークンを提供します
+    },
+    receiver: {
+      value: await client.fromTokenToUnit(5), // Aliceは5トークンを要求します
+    },
+  },
+};
+
+const signedByAlice = await client.signExchangeV2Tx({
+  tx: exchangeTx,
+  wallet: aliceWallet,
+});
+
+// 2. Aliceは`signedByAlice`をBobに送信します。Bobは自分の署名を追加します。
+const signedByBoth = await client.multiSignExchangeV2Tx({
+  tx: signedByAlice,
+  wallet: bobWallet,
+});
+
+// 3. Bobは`signedByBoth`をAliceに送り返します。Aliceが最終的なトランザクションを送信します。
+const txHash = await client.sendExchangeV2Tx({
+  tx: signedByBoth,
+  wallet: aliceWallet, // 送信者のウォレットが送信に使用されます
+});
+
+console.log('アトミックスワップトランザクションが送信されました:', txHash);
+```

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

@@ -0,0 +1,228 @@
+# 低階 API
+
+The Low-level API 提供了對整個交易生命週期的精細控制。與將細節抽象化的 [高階 API](./api-reference-transaction-helpers.md) 不同，這些方法允許您手動建構、編碼、簽署和發送交易。這對於進階場景非常理想，例如多重簽名工作流程，其中不同方需要在廣播交易之前簽署交易。
+
+此 API 分為四個主要的方法群組，每個群組對應交易生命週期中的一個階段：
+
+1.  **編碼**：準備一筆交易並將其序列化為二進位緩衝區。
+2.  **簽署**：為已編碼的交易新增數位簽章。
+3.  **多重簽署**：為一筆交易新增多個數位簽章。
+4.  **發送**：將已簽署的交易廣播到區塊鏈。
+
+## 編碼交易
+
+編碼是建立交易的第一步。`encode[Type]Tx` 方法會接收核心交易資料（`itx`）並將其包裝在標準交易結構中，新增必要的細節，如 `chainId` 和 `nonce`。結果是一個可讀的交易物件和一個準備好簽署的二進位緩衝區。
+
+鏈支援的每種交易類型都有一個 `encode` 方法。您可以透過呼叫 `client.getTxEncodeMethods()` 來取得完整列表。
+
+### `encode[Type]Tx(payload)`
+
+編碼一筆交易而不進行簽署。
+
+**參數**
+
+<x-field-group>
+  <x-field data-name="tx" data-type="object" data-required="true">
+    <x-field-desc markdown>交易資料物件。</x-field-desc>
+    <x-field data-name="itx" data-type="object" data-required="true" data-desc="特定於交易類型的內部交易物件。"></x-field>
+    <x-field data-name="from" data-type="string" data-required="false" data-desc="發送者地址。如果未提供，則從錢包中衍生。"></x-field>
+    <x-field data-name="nonce" data-type="number" data-required="false" data-desc="交易 nonce。如果未設定，預設為 `Date.now()`。"></x-field>
+    <x-field data-name="chainId" data-type="string" data-required="false" data-desc="鏈 ID。如果未提供，則從連接的節點中獲取。"></x-field>
+  </x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="用於衍生發送者地址和公鑰的錢包物件。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="委託權限的帳戶地址（如適用）。"></x-field>
+</x-field-group>
+
+**回傳值**
+
+<x-field data-name="Promise<object>" data-type="Promise<object>" data-desc="一個解析為包含已編碼交易物件的 promise。">
+  <x-field data-name="object" data-type="object" data-desc="可讀的交易物件。"></x-field>
+  <x-field data-name="buffer" data-type="Buffer" data-desc="已序列化的交易二進位緩衝區，準備好進行簽署。"></x-field>
+</x-field>
+
+**範例**
+
+```javascript TransferV2Tx icon=logos:javascript
+const { encodeTransferV2Tx } = client;
+const senderWallet = fromRandom();
+const receiverAddress = 'z1...';
+
+const { object, buffer } = await encodeTransferV2Tx({
+  tx: {
+    itx: {
+      to: receiverAddress,
+      value: await client.fromTokenToUnit(10), // 轉移 10 個原生代幣
+    },
+  },
+  wallet: senderWallet,
+});
+
+console.log('已編碼的交易物件：', object);
+console.log('待簽署的緩衝區：', buffer.toString('hex'));
+```
+
+## 簽署交易
+
+The `sign[Type]Tx` 方法建立在編碼步驟之上，透過新增數位簽章。這些方法會編碼交易，然後使用提供的錢包來簽署產生的二進位緩衝區。
+
+您可以透過呼叫 `client.getTxSignMethods()` 來取得所有可用的簽署方法列表。
+
+### `sign[Type]Tx(payload)`
+
+編碼並簽署一筆交易。
+
+**參數**
+
+<x-field-group>
+  <x-field data-name="tx" data-type="object" data-required="true" data-desc="交易資料物件，與編碼時相同。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="用於簽署交易的錢包。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="委託人地址（如適用）。"></x-field>
+  <x-field data-name="encoding" data-type="string" data-required="false" data-desc="輸出的可選編碼（'base16'、'hex'、'base58'、'base64'）。如果省略，則回傳交易物件。"></x-field>
+</x-field-group>
+
+**回傳值**
+
+<x-field data-name="Promise<object|string>" data-type="Promise<object|string>" data-desc="一個解析為已簽署交易物件的 promise，如果指定了 `encoding`，則為編碼後的字串。"></x-field>
+
+**範例**
+
+```javascript TransferV2Tx icon=logos:javascript
+const { signTransferV2Tx } = client;
+const senderWallet = fromRandom();
+const receiverAddress = 'z1...';
+
+const signedTx = await signTransferV2Tx({
+  tx: {
+    itx: {
+      to: receiverAddress,
+      value: await client.fromTokenToUnit(10),
+    },
+  },
+  wallet: senderWallet,
+});
+
+console.log('已簽署的交易：', signedTx);
+```
+
+## 發送交易
+
+The `send[Type]Tx` 方法負責將交易廣播到區塊鏈。如果提供了未簽署的交易和錢包，這些方法可以隱式地執行簽署步驟，或者它們可以發送已經簽署的交易。
+
+可透過 `client.getTxSendMethods()` 取得完整的發送方法列表。
+
+### `send[Type]Tx(payload)`
+
+簽署（如果需要）並將交易發送到鏈上。
+
+**參數**
+
+<x-field-group>
+  <x-field data-name="tx" data-type="object" data-required="true" data-desc="交易物件。可以是已簽署或未簽署的。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="用於簽署交易的錢包。即使交易已預先簽署，仍需要此錢包來識別發送者。"></x-field>
+  <x-field data-name="signature" data-type="string" data-required="false" data-desc="交易的預先計算簽章。如果提供此項，錢包將不會再次用於簽署。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="委託人地址（如適用）。"></x-field>
+  <x-field data-name="commit" data-type="boolean" data-default="false" data-required="false" data-desc="是否在解析前回傳，等待交易被提交到區塊中。"></x-field>
+</x-field-group>
+
+**回傳值**
+
+<x-field data-name="Promise<string>" data-type="Promise<string>" data-desc="一個解析為交易雜湊值的 promise。"></x-field>
+
+**範例：自動簽署**
+
+```javascript TransferV2Tx icon=logos:javascript
+const { sendTransferV2Tx } = client;
+const senderWallet = fromRandom();
+const receiverAddress = 'z1...';
+
+// 客戶端將在發送前使用 senderWallet 簽署此交易。
+const txHash = await sendTransferV2Tx({
+  tx: {
+    itx: {
+      to: receiverAddress,
+      value: await client.fromTokenToUnit(10),
+    },
+  },
+  wallet: senderWallet,
+});
+
+console.log('已發送交易，雜湊值為：', txHash);
+```
+
+**範例：發送預先簽署的交易**
+
+```javascript TransferV2Tx icon=logos:javascript
+// 假設 signedTx 來自 sign[Type]Tx 範例
+const { sendTransferV2Tx } = client;
+
+const txHash = await sendTransferV2Tx({
+  tx: signedTx, // 傳入整個已簽署的交易物件
+  wallet: senderWallet,
+});
+
+console.log('已發送預先簽署的交易，雜湊值為：', txHash);
+```
+
+## 多重簽章交易
+
+對於需要多個簽章的工作流程（例如原子交換），會使用 `multiSign[Type]Tx` 方法。該過程涉及一方首先簽署交易（使用標準的 `sign[Type]Tx` 方法），然後後續各方使用相應的 `multiSign[Type]Tx` 方法新增其簽章。
+
+您可以透過 `client.getTxMultiSignMethods()` 取得支援多重簽章的交易列表。
+
+### `multiSign[Type]Tx(payload)`
+
+為一個已有一或多個簽章的交易新增一個簽章。
+
+**參數**
+
+<x-field-group>
+  <x-field data-name="tx" data-type="object" data-required="true" data-desc="交易物件，應已包含至少一個簽章。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="目前簽署者的錢包。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="目前簽署者的委託人地址（如適用）。"></x-field>
+  <x-field data-name="data" data-type="any" data-required="false" data-desc="可選資料，與簽章一起包含。"></x-field>
+  <x-field data-name="encoding" data-type="string" data-required="false" data-desc="輸出的可選編碼（'base16'、'hex'、'base58'、'base64'）。"></x-field>
+</x-field-group>
+
+**回傳值**
+
+<x-field data-name="Promise<object|string>" data-type="Promise<object|string>" data-desc="一個解析為新增了新簽章的交易物件的 promise。"></x-field>
+
+**範例：原子交換 (`ExchangeV2Tx`)**
+
+```javascript ExchangeV2Tx icon=logos:javascript
+// 兩方的錢包
+const aliceWallet = fromRandom();
+const bobWallet = fromRandom();
+
+// 1. Alice 準備並簽署初始交換交易
+const exchangeTx = {
+  itx: {
+    to: bobWallet.address,
+    sender: {
+      value: await client.fromTokenToUnit(10), // Alice 提供 10 個代幣
+    },
+    receiver: {
+      value: await client.fromTokenToUnit(5), // Alice 要求 5 個代幣
+    },
+  },
+};
+
+const signedByAlice = await client.signExchangeV2Tx({
+  tx: exchangeTx,
+  wallet: aliceWallet,
+});
+
+// 2. Alice 將 `signedByAlice` 發送給 Bob。Bob 新增他的簽章。
+const signedByBoth = await client.multiSignExchangeV2Tx({
+  tx: signedByAlice,
+  wallet: bobWallet,
+});
+
+// 3. Bob 將 `signedByBoth` 發回給 Alice。Alice 發送最終交易。
+const txHash = await client.sendExchangeV2Tx({
+  tx: signedByBoth,
+  wallet: aliceWallet, // 使用發送者錢包提交
+});
+
+console.log('原子交換交易已發送：', txHash);
+```

package/docs/api-reference-low-level-api.zh.md

@@ -1,25 +1,25 @@
-# 底层 API
+# 低级 API
 
-底层 API 提供了对整个交易生命周期的精细控制。与抽象掉细节的 [高级 API](./api-reference-transaction-helpers.md) 不同，这些方法允许您手动构建、编码、签名和发送交易。这对于高级场景非常理想，例如多重签名工作流，其中不同方需要在广播交易前对其进行签名。
+低级 API 提供了对整个交易生命周期的精细控制。与抽象掉细节的 [高级 API](./api-reference-transaction-helpers.md) 不同，这些方法允许你手动构建、编码、签名和发送交易。这对于高级场景非常理想，例如多重签名工作流，其中不同方需要在交易广播前对其进行签名。
 
-此 API 分为四个主要方法组，每个方法组对应交易生命周期的一个阶段：
+该 API 分为四个主要的方法组，每个方法组对应交易生命周期的一个阶段：
 
-1.  **编码**：准备一个交易并将其序列化为二进制缓冲区。
+1.  **编码**：准备一笔交易并将其序列化为二进制缓冲区。
 2.  **签名**：向已编码的交易添加数字签名。
-3.  **多重签名**：向交易添加多个数字签名。
+3.  **多签**：向一笔交易添加多个数字签名。
 4.  **发送**：将已签名的交易广播到区块链。
 
 ## 编码交易
 
-编码是创建交易的第一步。`encode[Type]Tx` 方法接收核心交易数据 (`itx`) 并将其包装在标准交易结构中，添加 `chainId` 和 `nonce` 等必要细节。结果是一个人类可读的交易对象和一个可供签名的二进制缓冲区。
+编码是创建交易的第一步。`encode[Type]Tx` 方法接收核心交易数据 (`itx`)，并将其包装在标准交易结构中，添加 `chainId` 和 `nonce` 等必要信息。结果是一个人类可读的交易对象和一个可供签名的二进制缓冲区。
 
-链支持的每种交易类型都有一个 `encode` 方法。您可以通过调用 `client.getTxEncodeMethods()` 获取完整列表。
+链支持的每种交易类型都有一个 `encode` 方法。你可以通过调用 `client.getTxEncodeMethods()` 获取完整列表。
 
 ### `encode[Type]Tx(payload)`
 
-编码一个交易，但不进行签名。
+编码一笔交易，但不进行签名。
 
-**参数**
+**Parameters**
 
 <x-field-group>
   <x-field data-name="tx" data-type="object" data-required="true">
@@ -30,12 +30,12 @@
     <x-field data-name="chainId" data-type="string" data-required="false" data-desc="链 ID。如果未提供，则从连接的节点获取。"></x-field>
   </x-field>
   <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="用于派生发送方地址和公钥的钱包对象。"></x-field>
-  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="如果适用，委托权限的账户地址。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="委托权限的账户地址（如果适用）。"></x-field>
 </x-field-group>
 
-**返回值**
+**Returns**
 
-<x-field data-name="Promise<object>" data-type="Promise<object>" data-desc="一个解析为包含已编码交易的对象的 Promise。">
+<x-field data-name="Promise<object>" data-type="Promise<object>" data-desc="一个 promise，解析为一个包含已编码交易的对象。">
   <x-field data-name="object" data-type="object" data-desc="人类可读的交易对象。"></x-field>
   <x-field data-name="buffer" data-type="Buffer" data-desc="序列化后的交易二进制缓冲区，可供签名。"></x-field>
 </x-field>
@@ -65,24 +65,24 @@ console.log('待签名的缓冲区:', buffer.toString('hex'));
 
 `sign[Type]Tx` 方法在编码步骤的基础上添加了数字签名。这些方法会对交易进行编码，然后使用提供的钱包对生成的二进制缓冲区进行签名。
 
-您可以通过调用 `client.getTxSignMethods()` 获取所有可用的签名方法列表。
+你可以通过调用 `client.getTxSignMethods()` 获取所有可用的签名方法列表。
 
 ### `sign[Type]Tx(payload)`
 
-对交易进行编码和签名。
+编码并签名一笔交易。
 
-**参数**
+**Parameters**
 
 <x-field-group>
   <x-field data-name="tx" data-type="object" data-required="true" data-desc="交易数据对象，与编码时相同。"></x-field>
-  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="用于签署交易的钱包。"></x-field>
-  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="如果适用，委托人的地址。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="用于签名交易的钱包。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="委托人地址（如果适用）。"></x-field>
   <x-field data-name="encoding" data-type="string" data-required="false" data-desc="输出的可选编码（'base16'、'hex'、'base58'、'base64'）。如果省略，则返回交易对象。"></x-field>
 </x-field-group>
 
-**返回值**
+**Returns**
 
-<x-field data-name="Promise<object|string>" data-type="Promise<object|string>" data-desc="一个解析为已签名交易对象或编码字符串（如果指定了 `encoding`）的 Promise。"></x-field>
+<x-field data-name="Promise<object|string>" data-type="Promise<object|string>" data-desc="一个 promise，解析为已签名的交易对象，如果指定了 `encoding`，则解析为编码后的字符串。"></x-field>
 
 **示例**
 
@@ -106,27 +106,27 @@ console.log('已签名的交易:', signedTx);
 
 ## 发送交易
 
-`send[Type]Tx` 方法负责将交易广播到区块链。如果提供了未签名的交易和钱包，这些方法可以隐式执行签名步骤，也可以发送已经签名的交易。
+`send[Type]Tx` 方法负责将交易广播到区块链。如果提供了未签名的交易和钱包，这些方法可以隐式执行签名步骤，或者它们也可以发送已经签名的交易。
 
-通过 `client.getTxSendMethods()` 可以获取完整的发送方法列表。
+可以通过 `client.getTxSendMethods()` 获取完整的发送方法列表。
 
 ### `send[Type]Tx(payload)`
 
 签名（如果需要）并将交易发送到链上。
 
-**参数**
+**Parameters**
 
 <x-field-group>
   <x-field data-name="tx" data-type="object" data-required="true" data-desc="交易对象。可以是已签名或未签名的。"></x-field>
-  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="用于签署交易的钱包。即使交易已预先签名，仍然需要此钱包来识别发送方。"></x-field>
+  <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="用于签名交易的钱包。即使交易已预签名，仍需此钱包来识别发送方。"></x-field>
   <x-field data-name="signature" data-type="string" data-required="false" data-desc="交易的预计算签名。如果提供，将不会再使用钱包进行签名。"></x-field>
-  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="如果适用，委托人的地址。"></x-field>
-  <x-field data-name="commit" data-type="boolean" data-default="false" data-required="false" data-desc="在解析前是否等待交易被提交到区块。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="委托人地址（如果适用）。"></x-field>
+  <x-field data-name="commit" data-type="boolean" data-default="false" data-required="false" data-desc="是否在解析前等待交易被提交到区块。"></x-field>
 </x-field-group>
 
-**返回值**
+**Returns**
 
-<x-field data-name="Promise<string>" data-type="Promise<string>" data-desc="一个解析为交易哈希的 Promise。"></x-field>
+<x-field data-name="Promise<string>" data-type="Promise<string>" data-desc="一个 promise，解析为交易哈希。"></x-field>
 
 **示例：自动签名**
 
@@ -135,7 +135,7 @@ const { sendTransferV2Tx } = client;
 const senderWallet = fromRandom();
 const receiverAddress = 'z1...';
 
-// 客户端将在发送前使用 senderWallet 签署此交易。
+// 客户端将在发送前使用 senderWallet 签名此交易。
 const txHash = await sendTransferV2Tx({
   tx: {
     itx: {
@@ -156,7 +156,7 @@ console.log('交易已发送，哈希值为:', txHash);
 const { sendTransferV2Tx } = client;
 
 const txHash = await sendTransferV2Tx({
-  tx: signedTx, // 传递整个已签名的交易对象
+  tx: signedTx, // 传入整个已签名的交易对象
   wallet: senderWallet,
 });
 
@@ -165,32 +165,32 @@ console.log('预签名交易已发送，哈希值为:', txHash);
 
 ## 多重签名交易
 
-对于需要多个签名（如原子交换）的工作流，使用 `multiSign[Type]Tx` 方法。该过程涉及一方首先签署交易（使用标准的 `sign[Type]Tx` 方法），然后后续各方使用相应的 `multiSign[Type]Tx` 方法添加他们的签名。
+对于需要多个签名（如原子交换）的工作流，使用 `multiSign[Type]Tx` 方法。该过程涉及一方首先签名交易（使用标准的 `sign[Type]Tx` 方法），然后后续各方使用相应的 `multiSign[Type]Tx` 方法添加他们的签名。
 
-您可以通过 `client.getTxMultiSignMethods()` 获取支持多重签名的交易列表。
+你可以通过 `client.getTxMultiSignMethods()` 获取支持多重签名的交易列表。
 
 ### `multiSign[Type]Tx(payload)`
 
-向已经有一个或多个签名的交易添加签名。
+向已有一个或多个签名的交易添加一个签名。
 
-**参数**
+**Parameters**
 
 <x-field-group>
   <x-field data-name="tx" data-type="object" data-required="true" data-desc="交易对象，应已包含至少一个签名。"></x-field>
   <x-field data-name="wallet" data-type="WalletObject" data-required="true" data-desc="当前签名者的钱包。"></x-field>
-  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="如果适用，当前签名者的委托人地址。"></x-field>
+  <x-field data-name="delegator" data-type="string" data-required="false" data-desc="当前签名者的委托人地址（如果适用）。"></x-field>
   <x-field data-name="data" data-type="any" data-required="false" data-desc="签名中包含的可选数据。"></x-field>
   <x-field data-name="encoding" data-type="string" data-required="false" data-desc="输出的可选编码（'base16'、'hex'、'base58'、'base64'）。"></x-field>
 </x-field-group>
 
-**返回值**
+**Returns**
 
-<x-field data-name="Promise<object|string>" data-type="Promise<object|string>" data-desc="一个解析为已添加新签名的交易对象的 Promise。"></x-field>
+<x-field data-name="Promise<object|string>" data-type="Promise<object|string>" data-desc="一个 promise，解析为添加了新签名的交易对象。"></x-field>
 
-**示例：原子交换（`ExchangeV2Tx`）**
+**示例：原子交换 (`ExchangeV2Tx`)**
 
 ```javascript ExchangeV2Tx icon=logos:javascript
-// 两方的钱包
+// 双方的钱包
 const aliceWallet = fromRandom();
 const bobWallet = fromRandom();
 
@@ -221,7 +221,7 @@ const signedByBoth = await client.multiSignExchangeV2Tx({
 // 3. Bob 将 `signedByBoth` 发回给 Alice。Alice 发送最终交易。
 const txHash = await client.sendExchangeV2Tx({
   tx: signedByBoth,
-  wallet: aliceWallet, // 发送方钱包用于提交
+  wallet: aliceWallet, // 使用发送方钱包提交
 });
 
 console.log('原子交换交易已发送:', txHash);