@hashgraph/sdk
Version:
240 lines (214 loc) • 6.39 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.default = void 0;
var EntityIdHelper = _interopRequireWildcard(require("../EntityIdHelper.cjs"));
var HieroProto = _interopRequireWildcard(require("@hashgraph/proto"));
var _long = _interopRequireDefault(require("long"));
var _EvmAddress = _interopRequireDefault(require("../EvmAddress.cjs"));
var util = _interopRequireWildcard(require("../util.cjs"));
function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
// SPDX-License-Identifier: Apache-2.0
/**
* @typedef {import("../client/Client.js").default<*, *>} Client
*/
/**
* The ID for a crypto-currency file on Hedera.
*/
class FileId {
/**
* @param {number | Long | import("../EntityIdHelper").IEntityId} props
* @param {(number | Long)=} realm
* @param {(number | Long)=} num
*/
constructor(props, realm, num) {
const result = EntityIdHelper.constructor(props, realm, num);
this.shard = result.shard;
this.realm = result.realm;
this.num = result.num;
/**
* @type {string | null}
*/
this._checksum = null;
}
/**
* @param {number} shard
* @param {number} realm
* @returns {FileId}
*/
static getAddressBookFileIdFor(shard = 0, realm = 0) {
return new FileId({
num: 102,
shard,
realm
});
}
/**
* @param {number} shard
* @param {number} realm
* @returns {FileId}
*/
static getFeeScheduleFileIdFor(shard = 0, realm = 0) {
return new FileId({
num: 111,
shard,
realm
});
}
/**
* @param {number} shard
* @param {number} realm
* @returns {FileId}
*/
static getExchangeRatesFileIdFor(shard = 0, realm = 0) {
return new FileId({
num: 112,
shard,
realm
});
}
/**
* @param {string} text
* @returns {FileId}
*/
static fromString(text) {
const result = EntityIdHelper.fromString(text);
const id = new FileId(result);
id._checksum = result.checksum;
return id;
}
/**
* @internal
* @param {HieroProto.proto.IFileID} id
* @returns {FileId}
*/
static _fromProtobuf(id) {
const fileId = new FileId(id.shardNum != null ? _long.default.fromString(id.shardNum.toString()) : 0, id.realmNum != null ? _long.default.fromString(id.realmNum.toString()) : 0, id.fileNum != null ? _long.default.fromString(id.fileNum.toString()) : 0);
return fileId;
}
/**
* @returns {string | null}
*/
get checksum() {
return this._checksum;
}
/**
* @deprecated - Use `validateChecksum` instead
* @param {Client} client
*/
validate(client) {
console.warn("Deprecated: Use `validateChecksum` instead");
this.validateChecksum(client);
}
/**
* @param {Client} client
*/
validateChecksum(client) {
EntityIdHelper.validateChecksum(this.shard, this.realm, this.num, this._checksum, client);
}
/**
* @param {Uint8Array} bytes
* @returns {FileId}
*/
static fromBytes(bytes) {
return FileId._fromProtobuf(HieroProto.proto.FileID.decode(bytes));
}
/**
* @param {string} address
* @deprecated - Use `fromEvmAddress` instead
* @returns {FileId}
*/
static fromSolidityAddress(address) {
const [shard, realm, file] = EntityIdHelper.fromSolidityAddress(address);
return new FileId(shard, realm, file);
}
/**
* @param {number} shard
* @param {number} realm
* @param {string} address
* @returns {FileId}
*/
static fromEvmAddress(shard, realm, address) {
const addressBytes = _EvmAddress.default.fromString(address).toBytes();
const isLongZero = util.isLongZeroAddress(addressBytes);
if (!isLongZero) {
throw new Error("FileId.fromEvmAddress does not support non-long-zero addresses");
}
const [shardLong, realmLong, fileLong] = EntityIdHelper.fromEvmAddress(shard, realm, address);
return new FileId(shardLong, realmLong, fileLong);
}
/**
* @deprecated - Use `toEvmAddress` instead
* @returns {string} solidity address
*/
toSolidityAddress() {
return EntityIdHelper.toSolidityAddress([this.shard, this.realm, this.num]);
}
/**
* @returns {string} EVM-compatible address representation of the entity
*/
toEvmAddress() {
return EntityIdHelper.toEvmAddress(this.num);
}
/**
* @internal
* @returns {HieroProto.proto.IFileID}
*/
_toProtobuf() {
return {
fileNum: this.num,
shardNum: this.shard,
realmNum: this.realm
};
}
/**
* @returns {string}
*/
toString() {
return `${this.shard.toString()}.${this.realm.toString()}.${this.num.toString()}`;
}
/**
* @param {Client} client
* @returns {string}
*/
toStringWithChecksum(client) {
return EntityIdHelper.toStringWithChecksum(this.toString(), client);
}
/**
* @returns {Uint8Array}
*/
toBytes() {
return HieroProto.proto.FileID.encode(this._toProtobuf()).finish();
}
/**
* @returns {FileId}
*/
clone() {
const id = new FileId(this);
id._checksum = this._checksum;
return id;
}
/**
* @param {FileId} other
* @returns {number}
*/
compare(other) {
return EntityIdHelper.compare([this.shard, this.realm, this.num], [other.shard, other.realm, other.num]);
}
}
/**
* The public node address book for the current network.
*/
exports.default = FileId;
FileId.ADDRESS_BOOK = new FileId(102);
/**
* The current fee schedule for the network.
*/
FileId.FEE_SCHEDULE = new FileId(111);
/**
* The current exchange rate of HBAR to USD.
*/
FileId.EXCHANGE_RATES = new FileId(112);