@hashgraph/sdk
Version:
239 lines (213 loc) • 6.23 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", {
value: true
});
exports.default = void 0;
var EntityIdHelper = _interopRequireWildcard(require("../EntityIdHelper.cjs"));
var HieroProto = _interopRequireWildcard(require("@hiero-ledger/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 _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
// 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);