chia-agent 17.0.0 → 19.0.0

package/CHANGELOG.md

@@ -1,5 +1,73 @@
 # Changelog
 
+## [19.0.0]
+Support for [`chia-blockchain@2.6.1`](https://github.com/Chia-Network/chia-blockchain/releases/tag/2.6.1)
+
+### Breaking change
+- `ProofOfSpace` type was updated for v2 proof-of-space (follows `chia_rs@0.38.2`)
+  - Added `version`, `plot_index`, `meta_group` and `strength` fields (between `plot_public_key` and `size`)
+  - `size` now only carries the v1 k-size (0 for v2 proofs)
+  - This affects every RPC response embedding a `ProofOfSpace` (e.g. block records)
+- `PartialProof`: `proof_fragments` was renamed to `fragments` (now 16 entries; follows `chia_rs@0.38.2`)
+
+### Added
+- Structured RPC errors (added in chia-blockchain 2.6.1)
+  - RPC error responses now always include `structuredError: {code, message, data}`
+    (and `traceback` on the HTTP RPC path)
+  - `RpcError` now exposes a `structuredError` property
+  - Added `TStructuredError` and `TRpcErrorCode` types
+- `create_signed_transaction`: new optional request parameters
+  `extra_delta`, `tail_reveal`, `tail_solution` (must be specified together) and `puzzle_decorator`
+- [Harvester Protocol](./src/api/chia/protocols/harvester_protocol.ts)
+  - `PartialProofsData`: added `plot_index` and `meta_group`
+
+### Changed
+- Synchronized `chia_rs` type definitions with `chia_rs@0.38.2`
+- `nft_mint_nft`: upstream reverted the `royalty_amount` rename back to `royalty_percentage`
+  (chia-agent already used `royalty_percentage`; no type change)
+- `take_offer`: the `sign` request parameter is now ignored by the wallet (signing is handled internally)
+- `did_find_lost_did`: `latest_coin_id` now echoes the requested coin id
+
+## [18.0.0]
+Support for [`chia-blockchain@2.6.0`](https://github.com/Chia-Network/chia-blockchain/releases/tag/2.6.0)
+
+### Breaking change
+- `create_new_wallet`
+  - The response `type` is now the `WalletType` name string (`"CAT"`, `"DECENTRALIZED_ID"`, `"NFT"`, `"POOLING_WALLET"`)
+    instead of the integer enum value
+  - Pool wallet `mode: "recovery"` was removed
+  - Pool wallet response now includes `type`
+  - `asset_id`, `coin_name`, `newpuzhash`, `pubkey`, `launcher_id` and `p2_singleton_puzzle_hash` in responses
+    are now `0x`-prefixed hex
+  - The `{success: false, error: "invalid request"}` success-path variant was removed
+    (invalid requests now produce a standard RPC error response)
+- `get_offer_summary`
+  - `summary.offered` / `summary.requested` amounts are now JSON strings (were numbers)
+  - `additions` / `removals` are now `0x`-prefixed hex
+  - DataLayer offer summaries are now typed as `TDataLayerOfferSummary`
+- `create_signed_transaction` / `send_transaction_multi`
+  - Per-announcement `morph_bytes` was removed; only the top-level `morph_bytes` is applied
+- All transaction endpoints now require a fully synced wallet
+  (may fail with `"Wallet needs to be fully synced before making transactions."`)
+- `split_coins` with `number_of_coins == 0` and `combine_coins` with `number_of_coins < 2` now error
+
+### Added
+- [Harvester Protocol](./src/api/chia/protocols/harvester_protocol.ts)
+  - `PartialProofsData`: `partial_proofs` is now `PartialProof[]`; added `strength` and `plot_id`
+  - `Plot`: added `compression_level`; for v2 plots `size` now encodes `0x80 | strength`
+- [Solver Protocol](./src/api/chia/protocols/solver_protocol.ts)
+  - `SolverInfo` is now `{partial_proof: PartialProof, plot_id, strength, size}`
+  - `SolverResponse.partial_proof` is now `PartialProof`
+- Added `PartialProof` type (mirrors `chia_rs`)
+
+### Changed
+- Synchronized `chia_rs` type definitions with `chia_rs@0.35.2`
+  - `SubEpochSummary`: added `challenge_merkle_root`
+  - `RewardChainBlock`: added `header_mmr_root`
+- `create_offer_for_ids`: `offer` dictionary values are canonically strings now (`Record<str, str | int>`)
+- `get_transactions`: `start` / `end` widened to `uint32`
+- `get_all_offers`: `start` / `end` are now bounded to `uint16`
+
 ## [17.0.0]
 Support for [`chia-blockchain@2.5.7`](https://github.com/Chia-Network/chia-blockchain/releases/tag/2.5.7)
 
@@ -2002,6 +2070,8 @@ daemon.sendMessage(destination, get_block_record_by_height_command, data);
 Initial release.
 
 <!-- [Unreleased]: https://github.com/Chia-Mine/chia-agent/compare/v0.0.1...v0.0.2 -->
+[19.0.0]: https://github.com/Chia-Mine/chia-agent/compare/v18.0.0...v19.0.0
+[18.0.0]: https://github.com/Chia-Mine/chia-agent/compare/v17.0.0...v18.0.0
 [17.0.0]: https://github.com/Chia-Mine/chia-agent/compare/v16.1.6...v17.0.0
 [16.1.6]: https://github.com/Chia-Mine/chia-agent/compare/v16.1.5...v16.1.6
 [16.1.5]: https://github.com/Chia-Mine/chia-agent/compare/v16.1.4...v16.1.5

package/README.md

@@ -2,7 +2,7 @@
 [![npm version](https://badge.fury.io/js/chia-agent.svg)](https://badge.fury.io/js/chia-agent) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 chia rpc/websocket client library for NodeJS.  
-Supports all RPC/Websocket API available at `2.5.7` of [`chia-blockchain`](https://github.com/Chia-Network/chia-blockchain/).  
+Supports all RPC/Websocket API available at `2.6.1` of [`chia-blockchain`](https://github.com/Chia-Network/chia-blockchain/).  
 \(If you need previous version, search for the corresponding release [here](https://github.com/Chia-Mine/chia-agent/releases)\)
 
 you can develop your own nodejs script with `chia-agent` to:
@@ -22,10 +22,10 @@ yarn add chia-agent
 
 ## Compatibility
 This code is compatible with:  
-- [`54bdf378c7a2a60b45b8d8523dd7b10920f029b8`](https://github.com/Chia-Network/chia-blockchain/tree/54bdf378c7a2a60b45b8d8523dd7b10920f029b8) of [chia-blockchain 2.5.7](https://github.com/Chia-Network/chia-blockchain)  
-  - [Diff to the main branch of chia-blockchain](https://github.com/Chia-Network/chia-blockchain/compare/54bdf378c7a2a60b45b8d8523dd7b10920f029b8...main)
-- [`aea3188b55305aed9ecea7b09a77d063f9f0ace7`](https://github.com/Chia-Network/chia_rs/tree/aea3188b55305aed9ecea7b09a77d063f9f0ace7) of [chia_rs 0.30.0](https://github.com/Chia-Network/chia_rs)
-  - [Diff to the main branch of chia_rs](https://github.com/Chia-Network/chia_rs/compare/aea3188b55305aed9ecea7b09a77d063f9f0ace7...main)
+- [`204fe59bd82984ec7c70794891a669a949e3edc3`](https://github.com/Chia-Network/chia-blockchain/tree/204fe59bd82984ec7c70794891a669a949e3edc3) of [chia-blockchain 2.6.1](https://github.com/Chia-Network/chia-blockchain)  
+  - [Diff to the main branch of chia-blockchain](https://github.com/Chia-Network/chia-blockchain/compare/204fe59bd82984ec7c70794891a669a949e3edc3...main)
+- [`da47ae281f1f8801542a743263db84fff3612de1`](https://github.com/Chia-Network/chia_rs/tree/da47ae281f1f8801542a743263db84fff3612de1) of [chia_rs 0.38.2](https://github.com/Chia-Network/chia_rs)
+  - [Diff to the main branch of chia_rs](https://github.com/Chia-Network/chia_rs/compare/da47ae281f1f8801542a743263db84fff3612de1...main)
 - [`ef49150171cc243b09c0e5d5cb27f2249ffa3793`](https://github.com/Chia-Network/pool-reference/tree/ef49150171cc243b09c0e5d5cb27f2249ffa3793) of [pool-reference](https://github.com/Chia-Network/pool-reference)  
   - [Diff to the main branch of pool-reference](https://github.com/Chia-Network/pool-reference/compare/ef49150171cc243b09c0e5d5cb27f2249ffa3793...main)
 

package/api/chia/protocols/harvester_protocol.d.ts

@@ -1,14 +1,19 @@
-import { bytes, Optional, str } from "../types/_python_types_";
+import { Optional, str } from "../types/_python_types_";
 import { G1Element } from "../../chia_rs/chia-bls/lib";
-import { uint64, uint8 } from "../../chia_rs/wheel/python/sized_ints";
+import { uint16, uint64, uint8 } from "../../chia_rs/wheel/python/sized_ints";
 import { bytes32 } from "../../chia_rs/wheel/python/sized_bytes";
+import { PartialProof } from "../../chia_rs/chia-protocol/partial_proof";
 export type PartialProofsData = {
     challenge_hash: bytes32;
     sp_hash: bytes32;
     plot_identifier: str;
-    partial_proofs: bytes[];
+    partial_proofs: PartialProof[];
     signage_point_index: uint8;
     plot_size: uint8;
+    plot_index: uint16;
+    meta_group: uint8;
+    strength: uint8;
+    plot_id: bytes32;
     pool_public_key: Optional<G1Element>;
     pool_contract_puzzle_hash: Optional<bytes32>;
     plot_public_key: G1Element;
@@ -22,4 +27,5 @@ export type Plot = {
     plot_public_key: G1Element;
     file_size: uint64;
     time_modified: uint64;
+    compression_level: Optional<uint8>;
 };

package/api/chia/protocols/solver_protocol.d.ts

@@ -1,8 +1,14 @@
 import { bytes } from "../types/_python_types_";
+import { uint8 } from "../../chia_rs/wheel/python/sized_ints";
+import { bytes32 } from "../../chia_rs/wheel/python/sized_bytes";
+import { PartialProof } from "../../chia_rs/chia-protocol/partial_proof";
 export type SolverInfo = {
-    partial_proof: bytes;
+    partial_proof: PartialProof;
+    plot_id: bytes32;
+    strength: uint8;
+    size: uint8;
 };
 export type SolverResponse = {
-    partial_proof: bytes;
+    partial_proof: PartialProof;
     proof: bytes;
 };

package/api/chia_rs/chia-protocol/partial_proof.d.ts

@@ -0,0 +1,4 @@
+import { uint64 } from "../wheel/python/sized_ints";
+export type PartialProof = {
+    fragments: uint64[];
+};

package/api/chia_rs/chia-protocol/partial_proof.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/api/chia_rs/chia-protocol/proof_of_space.d.ts

@@ -1,12 +1,16 @@
 import { bytes32 } from "../wheel/python/sized_bytes";
 import { bytes, Optional } from "../../chia/types/_python_types_";
 import { G1Element } from "../chia-bls/lib";
-import { uint8 } from "../wheel/python/sized_ints";
+import { uint16, uint8 } from "../wheel/python/sized_ints";
 export type ProofOfSpace = {
     challenge: bytes32;
     pool_public_key: Optional<G1Element>;
     pool_contract_puzzle_hash: Optional<bytes32>;
     plot_public_key: G1Element;
+    version: uint8;
+    plot_index: uint16;
+    meta_group: uint8;
+    strength: uint8;
     size: uint8;
     proof: bytes;
 };

package/api/chia_rs/chia-protocol/reward_chain_block.d.ts

@@ -28,5 +28,6 @@ export type RewardChainBlock = {
     reward_chain_sp_signature: G2Element;
     reward_chain_ip_vdf: VDFInfo;
     infused_challenge_chain_ip_vdf: Optional<VDFInfo>;
+    header_mmr_root: Optional<bytes32>;
     is_transaction_block: bool;
 };

package/api/chia_rs/chia-protocol/sub_epoch_summary.d.ts

@@ -7,4 +7,5 @@ export type SubEpochSummary = {
     num_blocks_overflow: uint8;
     new_difficulty: Optional<uint64>;
     new_sub_slot_iters: Optional<uint64>;
+    challenge_merkle_root: Optional<bytes32>;
 };

package/api/rpc/wallet/index.d.ts

@@ -1,7 +1,7 @@
 import { WalletInfo } from "../../chia/wallet/wallet_info";
 import { Coin } from "../../chia/types/blockchain_format/coin";
 import { bool, bytes, False, None, Optional, str, True } from "../../chia/types/_python_types_";
-import { int, uint16, uint32, uint64, uint8 } from "../../chia_rs/wheel/python/sized_ints";
+import { int, uint16, uint32, uint64 } from "../../chia_rs/wheel/python/sized_ints";
 import { bytes32 } from "../../chia_rs/wheel/python/sized_bytes";
 import { TransactionRecord, TransactionRecordConvenience, TransactionRecordConvenienceWithMetadata } from "../../chia/wallet/transaction_record";
 import { TRPCAgent } from "../../../rpc";
@@ -169,7 +169,7 @@ export type TCreate_New_CAT_WalletRequest = {
     asset_id: str;
 };
 export type TCreate_New_CAT_WalletResponse = {
-    type: uint8;
+    type: "CAT";
     asset_id: str;
     wallet_id: uint32;
     transactions: TransactionRecordConvenience[];
@@ -192,13 +192,15 @@ export type TCreateNewDidWalletRequestRecovery = {
 export type TCreate_New_DID_WalletRequest = TCreateNewDidWalletRequestNew | TCreateNewDidWalletRequestRecovery;
 export type TCreateNewDidWalletResponseNew = {
     success: True;
-    type: uint8;
+    type: "DECENTRALIZED_ID";
     my_did: str;
     wallet_id: uint32;
+    transactions: TransactionRecordConvenience[];
+    signing_responses?: str[];
 };
 export type TCreateNewDidWalletResponseRecovery = {
     success: True;
-    type: uint8;
+    type: "DECENTRALIZED_ID";
     my_did: str;
     wallet_id: uint32;
     coin_name: str;
@@ -217,7 +219,7 @@ export type TCreate_New_NFT_WalletRequest = {
 };
 export type TCreate_New_NFT_WalletResponse = {
     success: True;
-    type: uint8;
+    type: "NFT";
     wallet_id: uint32;
 };
 export type TCreate_New_Pool_WalletRequest = {
@@ -234,12 +236,9 @@ export type TCreate_New_Pool_WalletRequest = {
     };
     p2_singleton_delayed_ph?: str;
     p2_singleton_delay_time?: uint64;
-} | {
-    fee?: uint64;
-    wallet_type: "pool_wallet";
-    mode: "recovery";
 };
 export type TCreate_New_Pool_WalletResponse = {
+    type: "POOLING_WALLET";
     total_fee: uint64;
     transaction: TransactionRecord;
     transactions: TransactionRecordConvenience[];
@@ -247,16 +246,12 @@ export type TCreate_New_Pool_WalletResponse = {
     launcher_id: str;
     p2_singleton_puzzle_hash: str;
 };
-export type TCreateWalletErrorResponse = {
-    success: False;
-    error: str;
-};
 export declare const create_new_wallet_command = "create_new_wallet";
 export type create_new_wallet_command = typeof create_new_wallet_command;
 export type TCreateNewWalletRequestWithTx = TCreate_New_CAT_WalletRequest | TCreate_New_Pool_WalletRequest;
 export type TCreateNewWalletRequestWithoutTx = TCreate_New_DID_WalletRequest | TCreate_New_NFT_WalletRequest;
 export type TCreateNewWalletRequest = (TCreateNewWalletRequestWithTx | TCreateNewWalletRequestWithoutTx) & TXEndpointRequest;
-export type TCreateNewWalletResponse = TCreate_New_CAT_WalletResponse | TCreate_New_DID_WalletResponse | TCreate_New_NFT_WalletResponse | TCreate_New_Pool_WalletResponse | TCreateWalletErrorResponse;
+export type TCreateNewWalletResponse = TCreate_New_CAT_WalletResponse | TCreate_New_DID_WalletResponse | TCreate_New_NFT_WalletResponse | TCreate_New_Pool_WalletResponse;
 export type GetCreateNewWalletResponse<REQ extends TCreateNewWalletRequest> = REQ extends TCreate_New_CAT_WalletRequest ? TCreate_New_CAT_WalletResponse : REQ extends TCreate_New_DID_WalletRequest ? REQ extends TCreateNewDidWalletRequestNew ? TCreateNewDidWalletResponseNew : TCreateNewDidWalletResponseRecovery : REQ extends TCreate_New_NFT_WalletRequest ? TCreate_New_NFT_WalletResponse : TCreate_New_Pool_WalletResponse;
 export type WsCreateNewWalletMessage<R> = GetMessageType<chia_wallet_service, create_new_wallet_command, R>;
 export declare function create_new_wallet<T extends TRPCAgent | TDaemon, D extends TCreateNewWalletRequest>(agent: T, data: D): Promise<ResType<T, D extends TCreateNewWalletRequestWithTx ? TxeResp<D, GetCreateNewWalletResponse<D>> : GetCreateNewWalletResponse<D>, WsCreateNewWalletMessage<D extends TCreateNewWalletRequestWithTx ? TxeResp<D, GetCreateNewWalletResponse<D>> : GetCreateNewWalletResponse<D>>>>;
@@ -302,8 +297,8 @@ export declare const get_transactions_command = "get_transactions";
 export type get_transactions_command = typeof get_transactions_command;
 export type TGetTransactionsRequest = {
     wallet_id: int;
-    start?: uint16;
-    end?: uint16;
+    start?: uint32;
+    end?: uint32;
     sort_key?: str;
     reverse?: bool;
     to_address?: str;
@@ -424,12 +419,10 @@ export type TAdditions = {
 export type TCoinAnnouncement = {
     coin_id: str;
     message: str;
-    morph_bytes?: str;
 };
 export type TPuzzleAnnouncement = {
     puzzle_hash: str;
     message: str;
-    morph_bytes?: str;
 };
 export declare const create_signed_transaction_command = "create_signed_transaction";
 export type create_signed_transaction_command = typeof create_signed_transaction_command;
@@ -440,7 +433,11 @@ export type TCreateSignedTransactionRequest = {
     coins?: Coin[];
     coin_announcements?: TCoinAnnouncement[];
     puzzle_announcements?: TPuzzleAnnouncement[];
-    morph_bytes?: True;
+    morph_bytes?: str;
+    extra_delta?: str;
+    tail_reveal?: str;
+    tail_solution?: str;
+    puzzle_decorator?: ClawbackPuzzleDecoratorOverride[];
 } & TXEndpointRequest;
 export type TCreateSignedTransactionResponse = {
     signed_txs: TransactionRecordConvenience[];
@@ -723,7 +720,7 @@ export declare function cat_get_asset_id<T extends TRPCAgent | TDaemon>(agent: T
 export declare const create_offer_for_ids_command = "create_offer_for_ids";
 export type create_offer_for_ids_command = typeof create_offer_for_ids_command;
 export type TCreateOfferForIdsRequest = {
-    offer: Record<int, int>;
+    offer: Record<str, str | int>;
     fee?: uint64;
     validate_only?: bool;
     driver_dict?: TDriverDict;
@@ -743,16 +740,27 @@ export type TGetOfferSummaryRequest = {
     offer: str;
     advanced?: bool;
 };
+export type TOfferSummary = {
+    offered: Record<str, str>;
+    requested: Record<str, str>;
+    fees: int;
+    infos: TDriverDict;
+    additions: str[];
+    removals: str[];
+    valid_times: Omit<ConditionValidTimes, "max_secs_after_created" | "min_secs_since_created" | "max_blocks_after_created" | "min_blocks_since_created">;
+};
+export type TDataLayerOfferSummary = {
+    offered: Array<{
+        launcher_id: str;
+        new_root: str;
+        dependencies: Array<{
+            launcher_id: str;
+            values_to_prove: str[];
+        }>;
+    }>;
+};
 export type TGetOfferSummaryResponse = {
-    summary: {
-        offered: Record<str, int>;
-        requested: Record<str, int>;
-        fees: int;
-        infos: TDriverDict;
-        additions: str[];
-        removals: str[];
-        valid_times: Omit<ConditionValidTimes, "max_secs_after_created" | "min_secs_since_created" | "max_blocks_after_created" | "min_blocks_since_created">;
-    };
+    summary: TOfferSummary | TDataLayerOfferSummary;
     id: bytes32;
 };
 export type WsGetOfferSummaryMessage = GetMessageType<chia_wallet_service, get_offer_summary_command, TGetOfferSummaryResponse>;
@@ -798,8 +806,8 @@ export declare function get_offer<T extends TRPCAgent | TDaemon>(agent: T, data:
 export declare const get_all_offers_command = "get_all_offers";
 export type get_all_offers_command = typeof get_all_offers_command;
 export type TGetAllOffersRequest = {
-    start?: int;
-    end?: int;
+    start?: uint16;
+    end?: uint16;
     exclude_my_offers?: bool;
     exclude_taken_offers?: bool;
     include_completed?: bool;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chia-agent",
-  "version": "17.0.0",
+  "version": "19.0.0",
   "author": "ChiaMineJP <admin@chiamine.jp>",
   "description": "chia rpc/websocket client library",
   "license": "MIT",

package/rpc/index.d.ts

@@ -2,8 +2,15 @@ import { Agent as HttpsAgent } from "https";
 import { Agent as HttpAgent } from "http";
 import { TConfig } from "../config/index";
 import { APIAgent } from "../agent/index";
+export type TRpcErrorCode = "API_ERROR" | "BLOCK_DOES_NOT_EXIST" | "BLOCK_HASH_NOT_FOUND" | "BLOCK_HEIGHT_NOT_FOUND" | "BLOCK_IN_FORK" | "BLOCK_NOT_FOUND" | "COIN_RECORD_NOT_FOUND" | "CONSENSUS_ERROR" | "EOS_NOT_IN_CACHE" | "HEADER_HASH_NOT_IN_REQUEST" | "HEIGHT_NOT_IN_BLOCKCHAIN" | "HINT_NOT_IN_REQUEST" | "INTERNAL_ERROR" | "INVALID_BLOCK_OR_GENERATOR" | "INVALID_COST" | "INVALID_HEIGHT_FOR_COIN" | "INVALID_NETWORK_SPACE_REQUEST" | "NAME_NOT_IN_REQUEST" | "NAMES_NOT_IN_REQUEST" | "NEW_AND_OLD_MUST_DIFFER" | "NEWER_BLOCK_NOT_FOUND" | "NO_BLOCKS_IN_CHAIN" | "NO_COIN_NAME_IN_REQUEST" | "NO_END_IN_REQUEST" | "NO_HEADER_HASH_IN_REQUEST" | "NO_HEIGHT_IN_REQUEST" | "NO_START_IN_REQUEST" | "NO_TX_ID_IN_REQUEST" | "OLDER_BLOCK_NOT_FOUND" | "PARENT_IDS_NOT_IN_REQUEST" | "PEAK_IS_NONE" | "PROTOCOL_ERROR" | "PUZZLE_HASH_NOT_IN_REQUEST" | "PUZZLE_HASHES_NOT_IN_REQUEST" | "PUZZLE_SOLUTION_FAILED" | "REQUEST_MUST_CONTAIN_EXACTLY_ONE" | "SP_NOT_IN_CACHE" | "SPEND_BUNDLE_NOT_IN_REQUEST" | "TARGET_TIMES_NON_NEGATIVE" | "TARGET_TIMES_REQUIRED" | "TIMESTAMP_ERROR" | "TRANSACTION_FAILED" | "TX_NOT_IN_MEMPOOL" | "UNKNOWN" | "VALIDATION_ERROR";
+export type TStructuredError = {
+    code: TRpcErrorCode | string;
+    message: string;
+    data: Record<string, unknown>;
+};
 export declare class RpcError extends Error {
     response: unknown;
+    structuredError?: TStructuredError;
     constructor(message: string, response: unknown);
 }
 type TDestination = "farmer" | "harvester" | "full_node" | "wallet" | "data_layer" | "solver" | "daemon" | "pool";

package/rpc/index.js

@@ -19,6 +19,11 @@ class RpcError extends Error {
         super(message);
         this.name = "RpcError";
         this.response = response;
+        if (response &&
+            typeof response === "object" &&
+            "structuredError" in response) {
+            this.structuredError = response.structuredError;
+        }
     }
 }
 exports.RpcError = RpcError;