@hiero-ledger/sdk
Version:
303 lines (268 loc) • 9.03 kB
JavaScript
// SPDX-License-Identifier: Apache-2.0
import Client from "./Client.js";
import WebChannel from "../channel/WebChannel.js";
import LedgerId from "../LedgerId.js";
import {
MAINNET,
WEB_TESTNET,
WEB_PREVIEWNET,
MirrorNetwork,
} from "../constants/ClientConstants.js";
import AddressBookQuery from "../network/AddressBookQueryWeb.js";
import FileId from "../file/FileId.js";
/**
* @typedef {import("./Client.js").ClientConfiguration} ClientConfiguration
* @typedef {import("../account/AccountId.js").default} AccountId
*/
export const Network = {
/**
* @param {string} name
* @returns {{[key: string]: (string | AccountId)}}
*/
fromName(name) {
switch (name) {
case "mainnet":
return Network.MAINNET;
case "testnet":
return Network.TESTNET;
case "previewnet":
return Network.PREVIEWNET;
default:
throw new Error(`unknown network name: ${name}`);
}
},
MAINNET: MAINNET,
TESTNET: WEB_TESTNET,
PREVIEWNET: WEB_PREVIEWNET,
};
/**
* Represents a client for interacting with the Hedera network over the web.
* The `WebClient` class extends the base `Client` class and provides methods
* for configuring and managing connections to the Hedera network, including
* setting the network type (mainnet, testnet, previewnet) and handling
* transactions and queries.
* @augments {Client<WebChannel, *>}
*/
export default class WebClient extends Client {
/**
* @param {ClientConfiguration} [props]
*/
constructor(props) {
super(props);
if (props != null) {
if (typeof props.network === "string") {
switch (props.network) {
case "mainnet":
this.setNetwork(Network.MAINNET);
this.setMirrorNetwork(MirrorNetwork.MAINNET);
this.setLedgerId(LedgerId.MAINNET);
break;
case "testnet":
this.setNetwork(Network.TESTNET);
this.setLedgerId(LedgerId.TESTNET);
this.setMirrorNetwork(MirrorNetwork.TESTNET);
break;
case "previewnet":
this.setNetwork(Network.PREVIEWNET);
this.setLedgerId(LedgerId.PREVIEWNET);
this.setMirrorNetwork(MirrorNetwork.PREVIEWNET);
break;
default:
throw new Error(
// eslint-disable-next-line @typescript-eslint/restrict-template-expressions
`unknown network: ${props.network}`,
);
}
} else if (props.network != null) {
Client._validateNetworkConsistency(props.network);
const { shard, realm } = Client._extractShardRealm(
props.network,
);
// Shard and realm are inferred from the network, so we need to set them here
// to ensure that the client is properly configured.
this._shard = shard;
this._realm = realm;
this.setNetwork(props.network);
}
}
}
/**
* @param {string | ClientConfiguration} data
* @returns {WebClient}
*/
static fromConfig(data) {
return new WebClient(
typeof data === "string"
? /** @type {ClientConfiguration | undefined} */ (
JSON.parse(data)
)
: data,
);
}
/**
* Construct a client for a specific network.
*
* It is the responsibility of the caller to ensure that all nodes in the map are part of the
* same Hedera network. Failure to do so will result in undefined behavior.
*
* The client will load balance all requests to Hedera using a simple round-robin scheme to
* chose nodes to send transactions to. For one transaction, at most 1/3 of the nodes will be
* tried.
*
* @param {{[key: string]: (string | AccountId)} | string} network
* @returns {WebClient}
*/
static forNetwork(network) {
return new WebClient({ network });
}
/**
* @param {string} network
* @returns {WebClient}
*/
static forName(network) {
return new WebClient({ network });
}
/**
* Construct a Hedera client pre-configured for Mainnet access.
*
* @returns {WebClient}
*/
static forMainnet() {
return new WebClient({
network: "mainnet",
});
}
/**
* Construct a Hedera client pre-configured for Testnet access.
*
* @returns {WebClient}
*/
static forTestnet() {
return new WebClient({
network: "testnet",
});
}
/**
* Construct a Hedera client pre-configured for Previewnet access.
*
* @returns {WebClient}
*/
static forPreviewnet() {
return new WebClient({
network: "previewnet",
});
}
/**
* Construct a client configured to use mirror nodes.
* This will query the address book to get the network nodes.
*
* @param {string[] | string} mirrorNetwork
* @returns {Promise<WebClient>}
*/
static async forMirrorNetwork(mirrorNetwork) {
const client = new WebClient();
client.setMirrorNetwork(mirrorNetwork);
await client.updateNetwork();
return client;
}
/**
* @param {{[key: string]: (string | AccountId)} | string} network
* @returns {void}
*/
setNetwork(network) {
if (typeof network === "string") {
switch (network) {
case "previewnet":
this._network.setNetwork(Network.PREVIEWNET);
break;
case "testnet":
this._network.setNetwork(Network.TESTNET);
break;
case "mainnet":
this._network.setNetwork(Network.MAINNET);
}
} else {
this._network.setNetwork(network);
}
}
/**
* @param {string[] | string} mirrorNetwork
* @returns {this}
*/
setMirrorNetwork(mirrorNetwork) {
if (typeof mirrorNetwork === "string") {
switch (mirrorNetwork) {
case "local-node":
this._mirrorNetwork.setNetwork(MirrorNetwork.LOCAL_NODE);
break;
case "previewnet":
this._mirrorNetwork.setNetwork(MirrorNetwork.PREVIEWNET);
break;
case "testnet":
this._mirrorNetwork.setNetwork(MirrorNetwork.TESTNET);
break;
case "mainnet":
this._mirrorNetwork.setNetwork(MirrorNetwork.MAINNET);
break;
default:
this._mirrorNetwork.setNetwork([mirrorNetwork]);
}
} else {
this._mirrorNetwork.setNetwork(mirrorNetwork);
}
return this;
}
/**
* @override
* @returns {Promise<void>}
*/
async updateNetwork() {
if (this._isUpdatingNetwork) {
return;
}
this._isUpdatingNetwork = true;
try {
const addressBook = await new AddressBookQuery()
.setFileId(
FileId.getAddressBookFileIdFor(this.shard, this.realm),
)
.execute(this);
/** @type {Record<string, AccountId>} */
const network = {};
for (const nodeAddress of addressBook.nodeAddresses) {
for (const endpoint of nodeAddress.addresses) {
if (nodeAddress.accountId != null) {
network[endpoint.toString()] = nodeAddress.accountId;
}
}
}
this.setNetwork(network);
} catch (/** @type {unknown} */ error) {
if (this._logger) {
const errorMessage =
error instanceof Error ? error.message : String(error);
this._logger.trace(
`failed to update client address book: ${errorMessage}`,
);
}
} finally {
this._isUpdatingNetwork = false;
}
}
/**
* @override
* @returns {(address: string) => WebChannel}
*/
_createNetworkChannel() {
return (address) => new WebChannel(address);
}
/**
* @override
* @returns {(address: string) => *}
*/
_createMirrorNetworkChannel() {
return () => {
throw new Error("mirror support is not supported in browsers");
};
}
}