`8b9e255fd2b8`

2 files changed

modifiedtests/src/eth/collectionAdmin.test.tsdiff before after both

--- a/tests/src/eth/collectionAdmin.test.ts
+++ b/tests/src/eth/collectionAdmin.test.ts
@@ -14,7 +14,8 @@
 // along with Unique Network. If not, see <http://www.gnu.org/licenses/>.
 
 import {IKeyringPair} from '@polkadot/types/types';
-import {usingEthPlaygrounds, itEth, expect, EthUniqueHelper} from './util';
+import {IEthCrossAccountId} from '../util/playgrounds/types';
+import {usingEthPlaygrounds, itEth, expect, EthUniqueHelper} from './util/playgrounds';
 
 async function recordEthFee(helper: EthUniqueHelper, userAddress: string, call: () => Promise<any>) {
   const before = await helper.balance.getSubstrate(helper.address.ethToSubstrate(userAddress));
@@ -93,25 +94,25 @@
     await collectionEvm.methods.addCollectionAdmin(newAdmin).send();
     expect(await collectionEvm.methods.isOwnerOrAdmin(newAdmin).call()).to.be.true;
   });
-
-  // itEth.skip('Check adminlist', async ({helper, privateKey}) => {
-  //   const owner = await helper.eth.createAccountWithBalance(donor);
+  
+  itEth('Check adminlist', async ({helper, privateKey}) => {
+    const owner = await helper.eth.createAccountWithBalance(donor);
         
-  //   const {collectionAddress, collectionId} = await helper.eth.createNFTCollection(owner, 'A', 'B', 'C');
-  //   const collectionEvm = helper.ethNativeContract.collection(collectionAddress, 'nft', owner);
+    const {collectionAddress, collectionId} = await helper.eth.createNonfungibleCollection(owner, 'A', 'B', 'C');
+    const collectionEvm = helper.ethNativeContract.collection(collectionAddress, 'nft', owner);
 
-  //   const admin1 = helper.eth.createAccount();
-  //   const admin2 = await privateKey('admin');
-  //   await collectionEvm.methods.addCollectionAdmin(admin1).send();
-  //   await collectionEvm.methods.addCollectionAdminSubstrate(admin2.addressRaw).send();
+    const admin1 = helper.eth.createAccount();
+    const admin2 = privateKey('admin');
+    await collectionEvm.methods.addCollectionAdmin(admin1).send();
+    await collectionEvm.methods.addCollectionAdminSubstrate(admin2.addressRaw).send();
 
-  //   const adminListRpc = await helper.collection.getAdmins(collectionId);
-  //   let adminListEth = await collectionEvm.methods.collectionAdmins().call();
-  //   adminListEth = adminListEth.map((element: IEthCrossAccountId) => {
-  //     return helper.address.convertCrossAccountFromEthCrossAcoount(element);
-  //   });
-  //   expect(adminListRpc).to.be.like(adminListEth);
-  // });
+    const adminListRpc = await helper.collection.getAdmins(collectionId);
+    let adminListEth = await collectionEvm.methods.collectionAdmins().call();
+    adminListEth = adminListEth.map((element: IEthCrossAccountId) => {
+      return helper.address.convertCrossAccountFromEthCrossAcoount(element);
+    });
+    expect(adminListRpc).to.be.like(adminListEth);
+  });  
     
   itEth('(!negative tests!) Add admin by ADMIN is not allowed', async ({helper}) => {
     const owner = await helper.eth.createAccountWithBalance(donor);

modifiedtests/src/util/playgrounds/unique.tsdiff before after both

1// Copyright 2019-2022 Unique Network (Gibraltar) Ltd.2// SPDX-License-Identifier: Apache-2.034/* eslint-disable @typescript-eslint/no-var-requires */5/* eslint-disable function-call-argument-newline */6/* eslint-disable no-prototype-builtins */78import {ApiPromise, WsProvider, Keyring} from '@polkadot/api';9import {ApiInterfaceEvents, SignerOptions} from '@polkadot/api/types';10import {encodeAddress, decodeAddress, keccakAsHex, evmToAddress, addressToEvm} from '@polkadot/util-crypto';11import {IKeyringPair} from '@polkadot/types/types';12import {13  IApiListeners,14  IBlock,15  IEvent,16  IChainProperties,17  ICollectionCreationOptions,18  ICollectionLimits,19  ICollectionPermissions,20  ICrossAccountId,21  ICrossAccountIdLower,22  ILogger,23  INestingPermissions,24  IProperty,25  IStakingInfo,26  ISchedulerOptions,27  ISubstrateBalance,28  IToken,29  ITokenPropertyPermission,30  ITransactionResult,31  IUniqueHelperLog,32  TApiAllowedListeners,33  TEthereumAccount,34  TSigner,35  TSubstrateAccount,36  TNetworks,37  IForeignAssetMetadata,38  AcalaAssetMetadata,39  MoonbeamAssetInfo,40  DemocracyStandardAccountVote,41} from './types';42import {RuntimeDispatchInfo} from '@polkadot/types/interfaces';4344export class CrossAccountId implements ICrossAccountId {45  Substrate?: TSubstrateAccount;46  Ethereum?: TEthereumAccount;4748  constructor(account: ICrossAccountId) {49    if (account.Substrate) this.Substrate = account.Substrate;50    if (account.Ethereum) this.Ethereum = account.Ethereum;51  }5253  static fromKeyring(account: IKeyringPair, domain: 'Substrate' | 'Ethereum' = 'Substrate') {54    switch (domain) {55      case 'Substrate': return new CrossAccountId({Substrate: account.address});56      case 'Ethereum': return new CrossAccountId({Substrate: account.address}).toEthereum();57    }58  }5960  static fromLowerCaseKeys(address: ICrossAccountIdLower): CrossAccountId {61    return new CrossAccountId({Substrate: address.substrate, Ethereum: address.ethereum});62  }6364  static normalizeSubstrateAddress(address: TSubstrateAccount, ss58Format = 42): TSubstrateAccount {65    return encodeAddress(decodeAddress(address), ss58Format);66  }6768  static withNormalizedSubstrate(address: TSubstrateAccount, ss58Format = 42): CrossAccountId {69    return new CrossAccountId({Substrate: CrossAccountId.normalizeSubstrateAddress(address, ss58Format)});70  }7172  withNormalizedSubstrate(ss58Format = 42): CrossAccountId {73    if (this.Substrate) return CrossAccountId.withNormalizedSubstrate(this.Substrate, ss58Format);74    return this;75  }7677  static translateSubToEth(address: TSubstrateAccount): TEthereumAccount {78    return nesting.toChecksumAddress('0x' + Array.from(addressToEvm(address), i => i.toString(16).padStart(2, '0')).join(''));79  }8081  toEthereum(): CrossAccountId {82    if (this.Substrate) return new CrossAccountId({Ethereum: CrossAccountId.translateSubToEth(this.Substrate)});83    return this;84  }8586  static translateEthToSub(address: TEthereumAccount, ss58Format?: number): TSubstrateAccount {87    return evmToAddress(address, ss58Format);88  }8990  toSubstrate(ss58Format?: number): CrossAccountId {91    if (this.Ethereum) return new CrossAccountId({Substrate: CrossAccountId.translateEthToSub(this.Ethereum, ss58Format)});92    return this;93  }9495  toLowerCase(): CrossAccountId {96    if (this.Substrate) this.Substrate = this.Substrate.toLowerCase();97    if (this.Ethereum) this.Ethereum = this.Ethereum.toLowerCase();98    return this;99  }100}101102const nesting = {103  toChecksumAddress(address: string): string {104    if (typeof address === 'undefined') return '';105106    if(!/^(0x)?[0-9a-f]{40}$/i.test(address)) throw new Error(`Given address "${address}" is not a valid Ethereum address.`);107108    address = address.toLowerCase().replace(/^0x/i,'');109    const addressHash = keccakAsHex(address).replace(/^0x/i,'');110    const checksumAddress = ['0x'];111112    for (let i = 0; i < address.length; i++) {113      // If ith character is 8 to f then make it uppercase114      if (parseInt(addressHash[i], 16) > 7) {115        checksumAddress.push(address[i].toUpperCase());116      } else {117        checksumAddress.push(address[i]);118      }119    }120    return checksumAddress.join('');121  },122  tokenIdToAddress(collectionId: number, tokenId: number) {123    return this.toChecksumAddress(`0xf8238ccfff8ed887463fd5e0${collectionId.toString(16).padStart(8, '0')}${tokenId.toString(16).padStart(8, '0')}`);124  },125};126127class UniqueUtil {128  static transactionStatus = {129    NOT_READY: 'NotReady',130    FAIL: 'Fail',131    SUCCESS: 'Success',132  };133134  static chainLogType = {135    EXTRINSIC: 'extrinsic',136    RPC: 'rpc',137  };138139  static getTokenAccount(token: IToken): CrossAccountId {140    return new CrossAccountId({Ethereum: this.getTokenAddress(token)});141  }142143  static getTokenAddress(token: IToken): string {144    return nesting.tokenIdToAddress(token.collectionId, token.tokenId);145  }146147  static getDefaultLogger(): ILogger {148    return {149      log(msg: any, level = 'INFO') {150        console[level.toLocaleLowerCase() === 'error' ? 'error' : 'log'](...(Array.isArray(msg) ? msg : [msg]));151      },152      level: {153        ERROR: 'ERROR',154        WARNING: 'WARNING',155        INFO: 'INFO',156      },157    };158  }159160  static vec2str(arr: string[] | number[]) {161    return arr.map(x => String.fromCharCode(parseInt(x.toString()))).join('');162  }163164  static str2vec(string: string) {165    if (typeof string !== 'string') return string;166    return Array.from(string).map(x => x.charCodeAt(0));167  }168169  static fromSeed(seed: string, ss58Format = 42) {170    const keyring = new Keyring({type: 'sr25519', ss58Format});171    return keyring.addFromUri(seed);172  }173174  static extractCollectionIdFromCreationResult(creationResult: ITransactionResult): number {175    if (creationResult.status !== this.transactionStatus.SUCCESS) {176      throw Error('Unable to create collection!');177    }178179    let collectionId = null;180    creationResult.result.events.forEach(({event: {data, method, section}}) => {181      if ((section === 'common') && (method === 'CollectionCreated')) {182        collectionId = parseInt(data[0].toString(), 10);183      }184    });185186    if (collectionId === null) {187      throw Error('No CollectionCreated event was found!');188    }189190    return collectionId;191  }192193  static extractTokensFromCreationResult(creationResult: ITransactionResult): {194    success: boolean,195    tokens: {collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint}[],196  } {197    if (creationResult.status !== this.transactionStatus.SUCCESS) {198      throw Error('Unable to create tokens!');199    }200    let success = false;201    const tokens = [] as {collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint}[];202    creationResult.result.events.forEach(({event: {data, method, section}}) => {203      if (method === 'ExtrinsicSuccess') {204        success = true;205      } else if ((section === 'common') && (method === 'ItemCreated')) {206        tokens.push({207          collectionId: parseInt(data[0].toString(), 10),208          tokenId: parseInt(data[1].toString(), 10),209          owner: data[2].toHuman(),210          amount: data[3].toBigInt(),211        });212      }213    });214    return {success, tokens};215  }216217  static extractTokensFromBurnResult(burnResult: ITransactionResult): {218    success: boolean,219    tokens: {collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint}[],220  } {221    if (burnResult.status !== this.transactionStatus.SUCCESS) {222      throw Error('Unable to burn tokens!');223    }224    let success = false;225    const tokens = [] as {collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint}[];226    burnResult.result.events.forEach(({event: {data, method, section}}) => {227      if (method === 'ExtrinsicSuccess') {228        success = true;229      } else if ((section === 'common') && (method === 'ItemDestroyed')) {230        tokens.push({231          collectionId: parseInt(data[0].toString(), 10),232          tokenId: parseInt(data[1].toString(), 10),233          owner: data[2].toHuman(),234          amount: data[3].toBigInt(),235        });236      }237    });238    return {success, tokens};239  }240241  static findCollectionInEvents(events: {event: IEvent}[], collectionId: number, expectedSection: string, expectedMethod: string): boolean {242    let eventId = null;243    events.forEach(({event: {data, method, section}}) => {244      if ((section === expectedSection) && (method === expectedMethod)) {245        eventId = parseInt(data[0].toString(), 10);246      }247    });248249    if (eventId === null) {250      throw Error(`No ${expectedMethod} event was found!`);251    }252    return eventId === collectionId;253  }254255  static isTokenTransferSuccess(events: {event: IEvent}[], collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n) {256    const normalizeAddress = (address: string | ICrossAccountId) => {257      if(typeof address === 'string') return address;258      const obj = {} as any;259      Object.keys(address).forEach(k => {260        obj[k.toLocaleLowerCase()] = address[k as 'Substrate' | 'Ethereum'];261      });262      if(obj.substrate) return CrossAccountId.withNormalizedSubstrate(obj.substrate);263      if(obj.ethereum) return CrossAccountId.fromLowerCaseKeys(obj).toLowerCase();264      return address;265    };266    let transfer = {collectionId: null, tokenId: null, from: null, to: null, amount: 1} as any;267    events.forEach(({event: {data, method, section}}) => {268      if ((section === 'common') && (method === 'Transfer')) {269        const hData = (data as any).toJSON();270        transfer = {271          collectionId: hData[0],272          tokenId: hData[1],273          from: normalizeAddress(hData[2]),274          to: normalizeAddress(hData[3]),275          amount: BigInt(hData[4]),276        };277      }278    });279    let isSuccess = parseInt(collectionId.toString()) === transfer.collectionId && parseInt(tokenId.toString()) === transfer.tokenId;280    isSuccess = isSuccess && JSON.stringify(normalizeAddress(fromAddressObj)) === JSON.stringify(transfer.from);281    isSuccess = isSuccess && JSON.stringify(normalizeAddress(toAddressObj)) === JSON.stringify(transfer.to);282    isSuccess = isSuccess && amount === transfer.amount;283    return isSuccess;284  }285286  static bigIntToDecimals(number: bigint, decimals = 18) {287    const numberStr = number.toString();288    const dotPos = numberStr.length - decimals;289290    if (dotPos <= 0) {291      return '0.' + '0'.repeat(Math.abs(dotPos)) + numberStr;292    } else {293      const intPart = numberStr.substring(0, dotPos);294      const fractPart = numberStr.substring(dotPos);295      return intPart + '.' + fractPart;296    }297  }298}299300class UniqueEventHelper {301  private static extractIndex(index: any): [number, number] | string {302    if(index.toRawType() === '[u8;2]') return [index[0], index[1]];303    return index.toJSON();304  }305306  private static extractSub(data: any, subTypes: any): {[key: string]: any} {307    let obj: any = {};308    let index = 0;309310    if (data.entries) {311      for(const [key, value] of data.entries()) {312        obj[key] = this.extractData(value, subTypes[index]);313        index++;314      }315    } else obj = data.toJSON();316317    return obj;318  }319320  private static extractData(data: any, type: any): any {321    if(!type) return data.toHuman();322    if (['u16', 'u32'].indexOf(type.type) > -1) return data.toNumber();323    if (['u64', 'u128', 'u256'].indexOf(type.type) > -1) return data.toBigInt();324    if(type.hasOwnProperty('sub')) return this.extractSub(data, type.sub);325    return data.toHuman();326  }327328  public static extractEvents(events: {event: any, phase: any}[]): IEvent[] {329    const parsedEvents: IEvent[] = [];330331    events.forEach((record) => {332      const {event, phase} = record;333      const types = event.typeDef;334335      const eventData: IEvent = {336        section: event.section.toString(),337        method: event.method.toString(),338        index: this.extractIndex(event.index),339        data: [],340        phase: phase.toJSON(),341      };342343      event.data.forEach((val: any, index: number) => {344        eventData.data.push(this.extractData(val, types[index]));345      });346347      parsedEvents.push(eventData);348    });349350    return parsedEvents;351  }352}353354export class ChainHelperBase {355  helperBase: any;356357  transactionStatus = UniqueUtil.transactionStatus;358  chainLogType = UniqueUtil.chainLogType;359  util: typeof UniqueUtil;360  eventHelper: typeof UniqueEventHelper;361  logger: ILogger;362  api: ApiPromise | null;363  forcedNetwork: TNetworks | null;364  network: TNetworks | null;365  chainLog: IUniqueHelperLog[];366  children: ChainHelperBase[];367  address: AddressGroup;368  chain: ChainGroup;369370  constructor(logger?: ILogger, helperBase?: any) {371    this.helperBase = helperBase;372373    this.util = UniqueUtil;374    this.eventHelper = UniqueEventHelper;375    if (typeof logger == 'undefined') logger = this.util.getDefaultLogger();376    this.logger = logger;377    this.api = null;378    this.forcedNetwork = null;379    this.network = null;380    this.chainLog = [];381    this.children = [];382    this.address = new AddressGroup(this);383    this.chain = new ChainGroup(this);384  }385386  clone(helperCls: ChainHelperBaseConstructor, options: {[key: string]: any} = {}) {387    Object.setPrototypeOf(helperCls.prototype, this);388    const newHelper = new helperCls(this.logger, options);389390    newHelper.api = this.api;391    newHelper.network = this.network;392    newHelper.forceNetwork = this.forceNetwork;393394    this.children.push(newHelper);395396    return newHelper;397  }398399  getApi(): ApiPromise {400    if(this.api === null) throw Error('API not initialized');401    return this.api;402  }403404  clearChainLog(): void {405    this.chainLog = [];406  }407408  forceNetwork(value: TNetworks): void {409    this.forcedNetwork = value;410  }411412  async connect(wsEndpoint: string, listeners?: IApiListeners) {413    if (this.api !== null) throw Error('Already connected');414    const {api, network} = await ChainHelperBase.createConnection(wsEndpoint, listeners, this.forcedNetwork);415    this.api = api;416    this.network = network;417  }418419  async disconnect() {420    for (const child of this.children) {421      child.clearApi();422    }423424    if (this.api === null) return;425    await this.api.disconnect();426    this.clearApi();427  }428429  clearApi() {430    this.api = null;431    this.network = null;432  }433434  static async detectNetwork(api: ApiPromise): Promise<TNetworks> {435    const spec = (await api.query.system.lastRuntimeUpgrade()).toJSON() as any;436    const xcmChains = ['rococo', 'westend', 'westmint', 'acala', 'karura', 'moonbeam', 'moonriver'];437438    if(xcmChains.indexOf(spec.specName) > -1) return spec.specName;439440    if(['quartz', 'unique'].indexOf(spec.specName) > -1) return spec.specName;441    return 'opal';442  }443444  static async detectNetworkByWsEndpoint(wsEndpoint: string): Promise<TNetworks> {445    const api = new ApiPromise({provider: new WsProvider(wsEndpoint)});446    await api.isReady;447448    const network = await this.detectNetwork(api);449450    await api.disconnect();451452    return network;453  }454455  static async createConnection(wsEndpoint: string, listeners?: IApiListeners, network?: TNetworks | null): Promise<{456    api: ApiPromise;457    network: TNetworks;458  }> {459    if(typeof network === 'undefined' || network === null) network = 'opal';460    const supportedRPC = {461      opal: {462        unique: require('@unique-nft/opal-testnet-types/definitions').unique.rpc,463      },464      quartz: {465        unique: require('@unique-nft/quartz-mainnet-types/definitions').unique.rpc,466      },467      unique: {468        unique: require('@unique-nft/unique-mainnet-types/definitions').unique.rpc,469      },470      rococo: {},471      westend: {},472      moonbeam: {},473      moonriver: {},474      acala: {},475      karura: {},476      westmint: {},477    };478    if(!supportedRPC.hasOwnProperty(network)) network = await this.detectNetworkByWsEndpoint(wsEndpoint);479    const rpc = supportedRPC[network];480481    // TODO: investigate how to replace rpc in runtime482    // api._rpcCore.addUserInterfaces(rpc);483484    const api = new ApiPromise({provider: new WsProvider(wsEndpoint), rpc});485486    await api.isReadyOrError;487488    if (typeof listeners === 'undefined') listeners = {};489    for (const event of ['connected', 'disconnected', 'error', 'ready', 'decorated']) {490      if (!listeners.hasOwnProperty(event) || typeof listeners[event as TApiAllowedListeners] === 'undefined') continue;491      api.on(event as ApiInterfaceEvents, listeners[event as TApiAllowedListeners] as (...args: any[]) => any);492    }493494    return {api, network};495  }496497  getTransactionStatus(data: {events: {event: IEvent}[], status: any}) {498    const {events, status} = data;499    if (status.isReady) {500      return this.transactionStatus.NOT_READY;501    }502    if (status.isBroadcast) {503      return this.transactionStatus.NOT_READY;504    }505    if (status.isInBlock || status.isFinalized) {506      const errors = events.filter(e => e.event.method === 'ExtrinsicFailed');507      if (errors.length > 0) {508        return this.transactionStatus.FAIL;509      }510      if (events.filter(e => e.event.method === 'ExtrinsicSuccess').length > 0) {511        return this.transactionStatus.SUCCESS;512      }513    }514515    return this.transactionStatus.FAIL;516  }517518  signTransaction(sender: TSigner, transaction: any, options: Partial<SignerOptions> | null = null, label = 'transaction') {519    const sign = (callback: any) => {520      if(options !== null) return transaction.signAndSend(sender, options, callback);521      return transaction.signAndSend(sender, callback);522    };523    // eslint-disable-next-line no-async-promise-executor524    return new Promise(async (resolve, reject) => {525      try {526        const unsub = await sign((result: any) => {527          const status = this.getTransactionStatus(result);528529          if (status === this.transactionStatus.SUCCESS) {530            this.logger.log(`${label} successful`);531            unsub();532            resolve({result, status});533          } else if (status === this.transactionStatus.FAIL) {534            let moduleError = null;535536            if (result.hasOwnProperty('dispatchError')) {537              const dispatchError = result['dispatchError'];538539              if (dispatchError) {540                if (dispatchError.isModule) {541                  const modErr = dispatchError.asModule;542                  const errorMeta = dispatchError.registry.findMetaError(modErr);543544                  moduleError = `${errorMeta.section}.${errorMeta.name}`;545                } else {546                  moduleError = dispatchError.toHuman();547                }548              } else {549                this.logger.log(result, this.logger.level.ERROR);550              }551            }552553            this.logger.log(`Something went wrong with ${label}. Status: ${status}`, this.logger.level.ERROR);554            unsub();555            reject({status, moduleError, result});556          }557        });558      } catch (e) {559        this.logger.log(e, this.logger.level.ERROR);560        reject(e);561      }562    });563  }564565  async getPaymentInfo(signer: TSigner, tx: any, len: number | null) {566    const api = this.getApi();567    const signingInfo = await api.derive.tx.signingInfo(signer.address);568569    // We need to sign the tx because570    // unsigned transactions does not have an inclusion fee571    tx.sign(signer, {572      blockHash: api.genesisHash,573      genesisHash: api.genesisHash,574      runtimeVersion: api.runtimeVersion,575      nonce: signingInfo.nonce,576    });577578    if (len === null) {579      return (await this.callRpc('api.rpc.payment.queryInfo', [tx.toHex()])) as RuntimeDispatchInfo;580    } else {581      return (await api.call.transactionPaymentApi.queryInfo(tx, len)) as RuntimeDispatchInfo;582    }583  }584585  constructApiCall(apiCall: string, params: any[]) {586    if(!apiCall.startsWith('api.')) throw Error(`Invalid api call: ${apiCall}`);587    let call = this.getApi() as any;588    for(const part of apiCall.slice(4).split('.')) {589      call = call[part];590    }591    return call(...params);592  }593594  async executeExtrinsic(sender: TSigner, extrinsic: string, params: any[], expectSuccess=true, options: Partial<SignerOptions>|null = null/*, failureMessage='expected success'*/) {595    if(this.api === null) throw Error('API not initialized');596    if(!extrinsic.startsWith('api.tx.')) throw Error(`${extrinsic} is not transaction`);597598    const startTime = (new Date()).getTime();599    let result: ITransactionResult;600    let events: IEvent[] = [];601    try {602      result = await this.signTransaction(sender, this.constructApiCall(extrinsic, params), options, extrinsic) as ITransactionResult;603      events = this.eventHelper.extractEvents(result.result.events);604    }605    catch(e) {606      if(!(e as object).hasOwnProperty('status')) throw e;607      result = e as ITransactionResult;608    }609610    const endTime = (new Date()).getTime();611612    const log = {613      executedAt: endTime,614      executionTime: endTime - startTime,615      type: this.chainLogType.EXTRINSIC,616      status: result.status,617      call: extrinsic,618      signer: this.getSignerAddress(sender),619      params,620    } as IUniqueHelperLog;621622    if(result.status !== this.transactionStatus.SUCCESS) {623      if (result.moduleError) log.moduleError = result.moduleError;624      else if (result.result.dispatchError) log.dispatchError = result.result.dispatchError;625    }626    if(events.length > 0) log.events = events;627628    this.chainLog.push(log);629630    if(expectSuccess && result.status !== this.transactionStatus.SUCCESS) {631      if (result.moduleError) throw Error(`${result.moduleError}`);632      else if (result.result.dispatchError) throw Error(JSON.stringify(result.result.dispatchError));633    }634    return result;635  }636637  async callRpc(rpc: string, params?: any[]) {638    if(typeof params === 'undefined') params = [];639    if(this.api === null) throw Error('API not initialized');640    if(!rpc.startsWith('api.rpc.') && !rpc.startsWith('api.query.')) throw Error(`${rpc} is not RPC call`);641642    const startTime = (new Date()).getTime();643    let result;644    let error = null;645    const log = {646      type: this.chainLogType.RPC,647      call: rpc,648      params,649    } as IUniqueHelperLog;650651    try {652      result = await this.constructApiCall(rpc, params);653    }654    catch(e) {655      error = e;656    }657658    const endTime = (new Date()).getTime();659660    log.executedAt = endTime;661    log.status = (error === null ? this.transactionStatus.SUCCESS : this.transactionStatus.FAIL) as 'Fail' | 'Success';662    log.executionTime = endTime - startTime;663664    this.chainLog.push(log);665666    if(error !== null) throw error;667668    return result;669  }670671  getSignerAddress(signer: IKeyringPair | string): string {672    if(typeof signer === 'string') return signer;673    return signer.address;674  }675676  fetchAllPalletNames(): string[] {677    if(this.api === null) throw Error('API not initialized');678    return this.api.runtimeMetadata.asLatest.pallets.map(m => m.name.toString().toLowerCase());679  }680681  fetchMissingPalletNames(requiredPallets: string[]): string[] {682    const palletNames = this.fetchAllPalletNames();683    return requiredPallets.filter(p => !palletNames.includes(p));684  }685}686687688class HelperGroup<T extends ChainHelperBase> {689  helper: T;690691  constructor(uniqueHelper: T) {692    this.helper = uniqueHelper;693  }694}695696697class CollectionGroup extends HelperGroup<UniqueHelper> {698  /**699 * Get number of blocks when sponsored transaction is available.700 *701 * @param collectionId ID of collection702 * @param tokenId ID of token703 * @param addressObj address for which the sponsorship is checked704 * @example await getTokenNextSponsored(1, 2, {Substrate: '5DfhbVfww7ThF8q6f3...'});705 * @returns number of blocks or null if sponsorship hasn't been set706 */707  async getTokenNextSponsored(collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<number | null> {708    return (await this.helper.callRpc('api.rpc.unique.nextSponsored', [collectionId, addressObj, tokenId])).toJSON();709  }710711  /**712   * Get the number of created collections.713   *714   * @returns number of created collections715   */716  async getTotalCount(): Promise<number> {717    return (await this.helper.callRpc('api.rpc.unique.collectionStats')).created.toNumber();718  }719720  /**721   * Get information about the collection with additional data,722   * including the number of tokens it contains, its administrators,723   * the normalized address of the collection's owner, and decoded name and description.724   *725   * @param collectionId ID of collection726   * @example await getData(2)727   * @returns collection information object728   */729  async getData(collectionId: number): Promise<{730    id: number;731    name: string;732    description: string;733    tokensCount: number;734    admins: CrossAccountId[];735    normalizedOwner: TSubstrateAccount;736    raw: any737  } | null> {738    const collection = await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId]);739    const humanCollection = collection.toHuman(), collectionData = {740      id: collectionId, name: null, description: null, tokensCount: 0, admins: [],741      raw: humanCollection,742    } as any, jsonCollection = collection.toJSON();743    if (humanCollection === null) return null;744    collectionData.raw.limits = jsonCollection.limits;745    collectionData.raw.permissions = jsonCollection.permissions;746    collectionData.normalizedOwner = this.helper.address.normalizeSubstrate(collectionData.raw.owner);747    for (const key of ['name', 'description']) {748      collectionData[key] = this.helper.util.vec2str(humanCollection[key]);749    }750751    collectionData.tokensCount = (['RFT', 'NFT'].includes(humanCollection.mode))752      ? await this.helper[humanCollection.mode.toLocaleLowerCase() as 'nft' | 'rft'].getLastTokenId(collectionId)753      : 0;754    collectionData.admins = await this.getAdmins(collectionId);755756    return collectionData;757  }758759  /**760   * Get the addresses of the collection's administrators, optionally normalized.761   *762   * @param collectionId ID of collection763   * @param normalize whether to normalize the addresses to the default ss58 format764   * @example await getAdmins(1)765   * @returns array of administrators766   */767  async getAdmins(collectionId: number, normalize = false): Promise<CrossAccountId[]> {768    const admins = (await this.helper.callRpc('api.rpc.unique.adminlist', [collectionId])).toHuman();769770    return normalize771      ? admins.map((address: CrossAccountId) => address.withNormalizedSubstrate())772      : admins;773  }774775  /**776   * Get the addresses added to the collection allow-list, optionally normalized.777   * @param collectionId ID of collection778   * @param normalize whether to normalize the addresses to the default ss58 format779   * @example await getAllowList(1)780   * @returns array of allow-listed addresses781   */782  async getAllowList(collectionId: number, normalize = false): Promise<CrossAccountId[]> {783    const allowListed = (await this.helper.callRpc('api.rpc.unique.allowlist', [collectionId])).toHuman();784    return normalize785      ? allowListed.map((address: CrossAccountId) => address.withNormalizedSubstrate())786      : allowListed;787  }788789  /**790   * Get the effective limits of the collection instead of null for default values791   *792   * @param collectionId ID of collection793   * @example await getEffectiveLimits(2)794   * @returns object of collection limits795   */796  async getEffectiveLimits(collectionId: number): Promise<ICollectionLimits> {797    return (await this.helper.callRpc('api.rpc.unique.effectiveCollectionLimits', [collectionId])).toJSON();798  }799800  /**801   * Burns the collection if the signer has sufficient permissions and collection is empty.802   *803   * @param signer keyring of signer804   * @param collectionId ID of collection805   * @example await helper.collection.burn(aliceKeyring, 3);806   * @returns ```true``` if extrinsic success, otherwise ```false```807   */808  async burn(signer: TSigner, collectionId: number): Promise<boolean> {809    const result = await this.helper.executeExtrinsic(810      signer,811      'api.tx.unique.destroyCollection', [collectionId],812      true,813    );814815    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionDestroyed');816  }817818  /**819   * Sets the sponsor for the collection (Requires the Substrate address). Needs confirmation by the sponsor.820   *821   * @param signer keyring of signer822   * @param collectionId ID of collection823   * @param sponsorAddress Sponsor substrate address824   * @example setSponsor(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...")825   * @returns ```true``` if extrinsic success, otherwise ```false```826   */827  async setSponsor(signer: TSigner, collectionId: number, sponsorAddress: TSubstrateAccount): Promise<boolean> {828    const result = await this.helper.executeExtrinsic(829      signer,830      'api.tx.unique.setCollectionSponsor', [collectionId, sponsorAddress],831      true,832    );833834    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionSponsorSet');835  }836837  /**838   * Confirms consent to sponsor the collection on behalf of the signer.839   *840   * @param signer keyring of signer841   * @param collectionId ID of collection842   * @example confirmSponsorship(aliceKeyring, 10)843   * @returns ```true``` if extrinsic success, otherwise ```false```844   */845  async confirmSponsorship(signer: TSigner, collectionId: number): Promise<boolean> {846    const result = await this.helper.executeExtrinsic(847      signer,848      'api.tx.unique.confirmSponsorship', [collectionId],849      true,850    );851852    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'SponsorshipConfirmed');853  }854855  /**856   * Removes the sponsor of a collection, regardless if it consented or not.857   *858   * @param signer keyring of signer859   * @param collectionId ID of collection860   * @example removeSponsor(aliceKeyring, 10)861   * @returns ```true``` if extrinsic success, otherwise ```false```862   */863  async removeSponsor(signer: TSigner, collectionId: number): Promise<boolean> {864    const result = await this.helper.executeExtrinsic(865      signer,866      'api.tx.unique.removeCollectionSponsor', [collectionId],867      true,868    );869870    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionSponsorRemoved');871  }872873  /**874   * Sets the limits of the collection. At least one limit must be specified for a correct call.875   *876   * @param signer keyring of signer877   * @param collectionId ID of collection878   * @param limits collection limits object879   * @example880   * await setLimits(881   *   aliceKeyring,882   *   10,883   *   {884   *     sponsorTransferTimeout: 0,885   *     ownerCanDestroy: false886   *   }887   * )888   * @returns ```true``` if extrinsic success, otherwise ```false```889   */890  async setLimits(signer: TSigner, collectionId: number, limits: ICollectionLimits): Promise<boolean> {891    const result = await this.helper.executeExtrinsic(892      signer,893      'api.tx.unique.setCollectionLimits', [collectionId, limits],894      true,895    );896897    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionLimitSet');898  }899900  /**901   * Changes the owner of the collection to the new Substrate address.902   *903   * @param signer keyring of signer904   * @param collectionId ID of collection905   * @param ownerAddress substrate address of new owner906   * @example changeOwner(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...")907   * @returns ```true``` if extrinsic success, otherwise ```false```908   */909  async changeOwner(signer: TSigner, collectionId: number, ownerAddress: TSubstrateAccount): Promise<boolean> {910    const result = await this.helper.executeExtrinsic(911      signer,912      'api.tx.unique.changeCollectionOwner', [collectionId, ownerAddress],913      true,914    );915916    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionOwnedChanged');917  }918919  /**920   * Adds a collection administrator.921   *922   * @param signer keyring of signer923   * @param collectionId ID of collection924   * @param adminAddressObj Administrator address (substrate or ethereum)925   * @example addAdmin(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."})926   * @returns ```true``` if extrinsic success, otherwise ```false```927   */928  async addAdmin(signer: TSigner, collectionId: number, adminAddressObj: ICrossAccountId): Promise<boolean> {929    const result = await this.helper.executeExtrinsic(930      signer,931      'api.tx.unique.addCollectionAdmin', [collectionId, adminAddressObj],932      true,933    );934935    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionAdminAdded');936  }937938  /**939   * Removes a collection administrator.940   *941   * @param signer keyring of signer942   * @param collectionId ID of collection943   * @param adminAddressObj Administrator address (substrate or ethereum)944   * @example removeAdmin(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."})945   * @returns ```true``` if extrinsic success, otherwise ```false```946   */947  async removeAdmin(signer: TSigner, collectionId: number, adminAddressObj: ICrossAccountId): Promise<boolean> {948    const result = await this.helper.executeExtrinsic(949      signer,950      'api.tx.unique.removeCollectionAdmin', [collectionId, adminAddressObj],951      true,952    );953954    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionAdminRemoved');955  }956957  /**958   * Check if user is in allow list.959   *960   * @param collectionId ID of collection961   * @param user Account to check962   * @example await getAdmins(1)963   * @returns is user in allow list964   */965  async allowed(collectionId: number, user: ICrossAccountId): Promise<boolean> {966    return (await this.helper.callRpc('api.rpc.unique.allowed', [collectionId, user])).toJSON();967  }968969  /**970   * Adds an address to allow list971   * @param signer keyring of signer972   * @param collectionId ID of collection973   * @param addressObj address to add to the allow list974   * @returns ```true``` if extrinsic success, otherwise ```false```975   */976  async addToAllowList(signer: TSigner, collectionId: number, addressObj: ICrossAccountId): Promise<boolean> {977    const result = await this.helper.executeExtrinsic(978      signer,979      'api.tx.unique.addToAllowList', [collectionId, addressObj],980      true,981    );982983    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'AllowListAddressAdded');984  }985986  /**987   * Removes an address from allow list988   *989   * @param signer keyring of signer990   * @param collectionId ID of collection991   * @param addressObj address to remove from the allow list992   * @returns ```true``` if extrinsic success, otherwise ```false```993   */994  async removeFromAllowList(signer: TSigner, collectionId: number, addressObj: ICrossAccountId): Promise<boolean> {995    const result = await this.helper.executeExtrinsic(996      signer,997      'api.tx.unique.removeFromAllowList', [collectionId, addressObj],998      true,999    );10001001    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'AllowListAddressRemoved');1002  }10031004  /**1005   * Sets onchain permissions for selected collection.1006   *1007   * @param signer keyring of signer1008   * @param collectionId ID of collection1009   * @param permissions collection permissions object1010   * @example setPermissions(aliceKeyring, 10, {access:'AllowList', mintMode: true, nesting: {collectionAdmin: true, tokenOwner: true}});1011   * @returns ```true``` if extrinsic success, otherwise ```false```1012   */1013  async setPermissions(signer: TSigner, collectionId: number, permissions: ICollectionPermissions): Promise<boolean> {1014    const result = await this.helper.executeExtrinsic(1015      signer,1016      'api.tx.unique.setCollectionPermissions', [collectionId, permissions],1017      true,1018    );10191020    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionPermissionSet');1021  }10221023  /**1024   * Enables nesting for selected collection. If `restricted` set, you can nest only tokens from specified collections.1025   *1026   * @param signer keyring of signer1027   * @param collectionId ID of collection1028   * @param permissions nesting permissions object1029   * @example enableNesting(aliceKeyring, 10, {collectionAdmin: true, tokenOwner: true});1030   * @returns ```true``` if extrinsic success, otherwise ```false```1031   */1032  async enableNesting(signer: TSigner, collectionId: number, permissions: INestingPermissions): Promise<boolean> {1033    return await this.setPermissions(signer, collectionId, {nesting: permissions});1034  }10351036  /**1037   * Disables nesting for selected collection.1038   *1039   * @param signer keyring of signer1040   * @param collectionId ID of collection1041   * @example disableNesting(aliceKeyring, 10);1042   * @returns ```true``` if extrinsic success, otherwise ```false```1043   */1044  async disableNesting(signer: TSigner, collectionId: number): Promise<boolean> {1045    return await this.setPermissions(signer, collectionId, {nesting: {tokenOwner: false, collectionAdmin: false}});1046  }10471048  /**1049   * Sets onchain properties to the collection.1050   *1051   * @param signer keyring of signer1052   * @param collectionId ID of collection1053   * @param properties array of property objects1054   * @example setProperties(aliceKeyring, 10, [{key: "gender", value: "male"}]);1055   * @returns ```true``` if extrinsic success, otherwise ```false```1056   */1057  async setProperties(signer: TSigner, collectionId: number, properties: IProperty[]): Promise<boolean> {1058    const result = await this.helper.executeExtrinsic(1059      signer,1060      'api.tx.unique.setCollectionProperties', [collectionId, properties],1061      true,1062    );10631064    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionPropertySet');1065  }10661067  /**1068   * Get collection properties.1069   *1070   * @param collectionId ID of collection1071   * @param propertyKeys optionally filter the returned properties to only these keys1072   * @example getProperties(1219, ['location', 'date', 'time', 'isParadise']);1073   * @returns array of key-value pairs1074   */1075  async getProperties(collectionId: number, propertyKeys?: string[] | null): Promise<IProperty[]> {1076    return (await this.helper.callRpc('api.rpc.unique.collectionProperties', [collectionId, propertyKeys])).toHuman();1077  }10781079  async getCollectionOptions(collectionId: number) {1080    return (await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId])).toHuman();1081  }10821083  /**1084   * Deletes onchain properties from the collection.1085   *1086   * @param signer keyring of signer1087   * @param collectionId ID of collection1088   * @param propertyKeys array of property keys to delete1089   * @example deleteProperties(aliceKeyring, 10, ["gender", "age"]);1090   * @returns ```true``` if extrinsic success, otherwise ```false```1091   */1092  async deleteProperties(signer: TSigner, collectionId: number, propertyKeys: string[]): Promise<boolean> {1093    const result = await this.helper.executeExtrinsic(1094      signer,1095      'api.tx.unique.deleteCollectionProperties', [collectionId, propertyKeys],1096      true,1097    );10981099    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionPropertyDeleted');1100  }11011102  /**1103   * Changes the owner of the token.1104   *1105   * @param signer keyring of signer1106   * @param collectionId ID of collection1107   * @param tokenId ID of token1108   * @param addressObj address of a new owner1109   * @param amount amount of tokens to be transfered. For NFT must be set to 1n1110   * @example transferToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1111   * @returns true if the token success, otherwise false1112   */1113  async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId, amount=1n): Promise<boolean> {1114    const result = await this.helper.executeExtrinsic(1115      signer,1116      'api.tx.unique.transfer', [addressObj, collectionId, tokenId, amount],1117      true, // `Unable to transfer token #${tokenId} from collection #${collectionId}`,1118    );11191120    return this.helper.util.isTokenTransferSuccess(result.result.events, collectionId, tokenId, {Substrate: typeof signer === 'string' ? signer : signer.address}, addressObj, amount);1121  }11221123  /**1124   *1125   * Change ownership of a token(s) on behalf of the owner.1126   *1127   * @param signer keyring of signer1128   * @param collectionId ID of collection1129   * @param tokenId ID of token1130   * @param fromAddressObj address on behalf of which the token will be sent1131   * @param toAddressObj new token owner1132   * @param amount amount of tokens to be transfered. For NFT must be set to 1n1133   * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg"}, {Ethereum: "0x9F0583DbB85..."})1134   * @returns true if the token success, otherwise false1135   */1136  async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n): Promise<boolean> {1137    const result = await this.helper.executeExtrinsic(1138      signer,1139      'api.tx.unique.transferFrom', [fromAddressObj, toAddressObj, collectionId, tokenId, amount],1140      true, // `Unable to transfer token #${tokenId} from collection #${collectionId}`,1141    );1142    return this.helper.util.isTokenTransferSuccess(result.result.events, collectionId, tokenId, fromAddressObj, toAddressObj, amount);1143  }11441145  /**1146   *1147   * Destroys a concrete instance of NFT/RFT or burns a specified amount of fungible tokens.1148   *1149   * @param signer keyring of signer1150   * @param collectionId ID of collection1151   * @param tokenId ID of token1152   * @param amount amount of tokens to be burned. For NFT must be set to 1n1153   * @example burnToken(aliceKeyring, 10, 5);1154   * @returns ```true``` if the extrinsic is successful, otherwise ```false```1155   */1156  async burnToken(signer: TSigner, collectionId: number, tokenId: number, amount=1n): Promise<boolean> {1157    const burnResult = await this.helper.executeExtrinsic(1158      signer,1159      'api.tx.unique.burnItem', [collectionId, tokenId, amount],1160      true, // `Unable to burn token for ${label}`,1161    );1162    const burnedTokens = this.helper.util.extractTokensFromBurnResult(burnResult);1163    if (burnedTokens.tokens.length > 1) throw Error('Burned multiple tokens');1164    return burnedTokens.success;1165  }11661167  /**1168   * Destroys a concrete instance of NFT on behalf of the owner1169   *1170   * @param signer keyring of signer1171   * @param collectionId ID of collection1172   * @param tokenId ID of token1173   * @param fromAddressObj address on behalf of which the token will be burnt1174   * @param amount amount of tokens to be burned. For NFT must be set to 1n1175   * @example burnTokenFrom(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."}, 5, {Ethereum: "0x9F0583DbB85..."})1176   * @returns ```true``` if extrinsic success, otherwise ```false```1177   */1178  async burnTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, amount=1n): Promise<boolean> {1179    const burnResult = await this.helper.executeExtrinsic(1180      signer,1181      'api.tx.unique.burnFrom', [collectionId, fromAddressObj, tokenId, amount],1182      true, // `Unable to burn token from for ${label}`,1183    );1184    const burnedTokens = this.helper.util.extractTokensFromBurnResult(burnResult);1185    return burnedTokens.success && burnedTokens.tokens.length > 0;1186  }11871188  /**1189   * Set, change, or remove approved address to transfer the ownership of the NFT.1190   *1191   * @param signer keyring of signer1192   * @param collectionId ID of collection1193   * @param tokenId ID of token1194   * @param toAddressObj Substrate or Ethereum address which gets approved use of the signer's tokens1195   * @param amount amount of token to be approved. For NFT must be set to 1n1196   * @returns ```true``` if extrinsic success, otherwise ```false```1197   */1198  async approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount=1n) {1199    const approveResult = await this.helper.executeExtrinsic(1200      signer,1201      'api.tx.unique.approve', [toAddressObj, collectionId, tokenId, amount],1202      true, // `Unable to approve token for ${label}`,1203    );12041205    return this.helper.util.findCollectionInEvents(approveResult.result.events, collectionId, 'common', 'Approved');1206  }12071208  /**1209   * Get the amount of token pieces approved to transfer or burn. Normally 0.1210   *1211   * @param collectionId ID of collection1212   * @param tokenId ID of token1213   * @param toAccountObj address which is approved to use token pieces1214   * @param fromAccountObj address which may have allowed the use of its owned tokens1215   * @example getTokenApprovedPieces(10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Substrate: "5ERZNF88Mm7UGfPP3mdG..."})1216   * @returns number of approved to transfer pieces1217   */1218  async getTokenApprovedPieces(collectionId: number, tokenId: number, toAccountObj: ICrossAccountId, fromAccountObj: ICrossAccountId): Promise<bigint> {1219    return (await this.helper.callRpc('api.rpc.unique.allowance', [collectionId, fromAccountObj, toAccountObj, tokenId])).toBigInt();1220  }12211222  /**1223   * Get the last created token ID in a collection1224   *1225   * @param collectionId ID of collection1226   * @example getLastTokenId(10);1227   * @returns id of the last created token1228   */1229  async getLastTokenId(collectionId: number): Promise<number> {1230    return (await this.helper.callRpc('api.rpc.unique.lastTokenId', [collectionId])).toNumber();1231  }12321233  /**1234   * Check if token exists1235   *1236   * @param collectionId ID of collection1237   * @param tokenId ID of token1238   * @example doesTokenExist(10, 20);1239   * @returns true if the token exists, otherwise false1240   */1241  async doesTokenExist(collectionId: number, tokenId: number): Promise<boolean> {1242    return (await this.helper.callRpc('api.rpc.unique.tokenExists', [collectionId, tokenId])).toJSON();1243  }1244}12451246class NFTnRFT extends CollectionGroup {1247  /**1248   * Get tokens owned by account1249   *1250   * @param collectionId ID of collection1251   * @param addressObj tokens owner1252   * @example getTokensByAddress(10, {Substrate: "5DyN4Y92vZCjv38fg..."})1253   * @returns array of token ids owned by account1254   */1255  async getTokensByAddress(collectionId: number, addressObj: ICrossAccountId): Promise<number[]> {1256    return (await this.helper.callRpc('api.rpc.unique.accountTokens', [collectionId, addressObj])).toJSON();1257  }12581259  /**1260   * Get token data1261   *1262   * @param collectionId ID of collection1263   * @param tokenId ID of token1264   * @param propertyKeys optionally filter the token properties to only these keys1265   * @param blockHashAt optionally query the data at some block with this hash1266   * @example getToken(10, 5);1267   * @returns human readable token data1268   */1269  async getToken(collectionId: number, tokenId: number, propertyKeys: string[] = [], blockHashAt?: string): Promise<{1270    properties: IProperty[];1271    owner: CrossAccountId;1272    normalizedOwner: CrossAccountId;1273  }| null> {1274    let tokenData;1275    if(typeof blockHashAt === 'undefined') {1276      tokenData = await this.helper.callRpc('api.rpc.unique.tokenData', [collectionId, tokenId]);1277    }1278    else {1279      if(propertyKeys.length == 0) {1280        const collection = (await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId])).toHuman();1281        if(!collection) return null;1282        propertyKeys = collection.tokenPropertyPermissions.map((x: ITokenPropertyPermission) => x.key);1283      }1284      tokenData = await this.helper.callRpc('api.rpc.unique.tokenData', [collectionId, tokenId, propertyKeys, blockHashAt]);1285    }1286    tokenData = tokenData.toHuman();1287    if (tokenData === null || tokenData.owner === null) return null;1288    const owner = {} as any;1289    for (const key of Object.keys(tokenData.owner)) {1290      owner[key.toLocaleLowerCase()] = key.toLocaleLowerCase() == 'substrate'1291        ? CrossAccountId.normalizeSubstrateAddress(tokenData.owner[key])1292        : tokenData.owner[key];1293    }1294    tokenData.normalizedOwner = CrossAccountId.fromLowerCaseKeys(owner);1295    return tokenData;1296  }12971298  /**1299   * Set permissions to change token properties1300   *1301   * @param signer keyring of signer1302   * @param collectionId ID of collection1303   * @param permissions permissions to change a property by the collection admin or token owner1304   * @example setTokenPropertyPermissions(1305   *   aliceKeyring, 10, [{key: "gender", permission: {tokenOwner: true, mutable: true, collectionAdmin: true}}]1306   * )1307   * @returns true if extrinsic success otherwise false1308   */1309  async setTokenPropertyPermissions(signer: TSigner, collectionId: number, permissions: ITokenPropertyPermission[]): Promise<boolean> {1310    const result = await this.helper.executeExtrinsic(1311      signer,1312      'api.tx.unique.setTokenPropertyPermissions', [collectionId, permissions],1313      true,1314    );13151316    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'PropertyPermissionSet');1317  }13181319  /**1320   * Get token property permissions.1321   *1322   * @param collectionId ID of collection1323   * @param propertyKeys optionally filter the returned property permissions to only these keys1324   * @example getPropertyPermissions(1219, ['location', 'date', 'time', 'isParadise']);1325   * @returns array of key-permission pairs1326   */1327  async getPropertyPermissions(collectionId: number, propertyKeys: string[] | null = null): Promise<ITokenPropertyPermission[]> {1328    return (await this.helper.callRpc('api.rpc.unique.propertyPermissions', [collectionId, ...(propertyKeys === null ? [] : [propertyKeys])])).toHuman();1329  }13301331  /**1332   * Set token properties1333   *1334   * @param signer keyring of signer1335   * @param collectionId ID of collection1336   * @param tokenId ID of token1337   * @param properties key-value pairs of metadata which to add to a token. Keys must be permitted in the collection1338   * @example setTokenProperties(aliceKeyring, 10, 5, [{key: "gender", value: "female"}, {key: "age", value: "23"}])1339   * @returns ```true``` if extrinsic success, otherwise ```false```1340   */1341  async setTokenProperties(signer: TSigner, collectionId: number, tokenId: number, properties: IProperty[]): Promise<boolean> {1342    const result = await this.helper.executeExtrinsic(1343      signer,1344      'api.tx.unique.setTokenProperties', [collectionId, tokenId, properties],1345      true,1346    );13471348    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'TokenPropertySet');1349  }13501351  /**1352   * Get properties, metadata assigned to a token.1353   *1354   * @param collectionId ID of collection1355   * @param tokenId ID of token1356   * @param propertyKeys optionally filter the returned properties to only these keys1357   * @example getTokenProperties(1219, ['location', 'date', 'time', 'isParadise']);1358   * @returns array of key-value pairs1359   */1360  async getTokenProperties(collectionId: number, tokenId: number, propertyKeys?: string[] | null): Promise<IProperty[]> {1361    return (await this.helper.callRpc('api.rpc.unique.tokenProperties', [collectionId, tokenId, propertyKeys])).toHuman();1362  }13631364  /**1365   * Delete the provided properties of a token1366   * @param signer keyring of signer1367   * @param collectionId ID of collection1368   * @param tokenId ID of token1369   * @param propertyKeys property keys to be deleted1370   * @example deleteTokenProperties(aliceKeyring, 10, 5, ["gender", "age"])1371   * @returns ```true``` if extrinsic success, otherwise ```false```1372   */1373  async deleteTokenProperties(signer: TSigner, collectionId: number, tokenId: number, propertyKeys: string[]): Promise<boolean> {1374    const result = await this.helper.executeExtrinsic(1375      signer,1376      'api.tx.unique.deleteTokenProperties', [collectionId, tokenId, propertyKeys],1377      true,1378    );13791380    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'TokenPropertyDeleted');1381  }13821383  /**1384   * Mint new collection1385   *1386   * @param signer keyring of signer1387   * @param collectionOptions basic collection options and properties1388   * @param mode NFT or RFT type of a collection1389   * @example mintCollection(aliceKeyring, {name: 'New', description: "New collection", tokenPrefix: "NEW"}, "NFT")1390   * @returns object of the created collection1391   */1392  async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions, mode: 'NFT' | 'RFT'): Promise<UniqueBaseCollection> {1393    collectionOptions = JSON.parse(JSON.stringify(collectionOptions)) as ICollectionCreationOptions; // Clone object1394    collectionOptions.mode = (mode === 'NFT') ? {nft: null} : {refungible: null};1395    for (const key of ['name', 'description', 'tokenPrefix']) {1396      if (typeof collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] === 'string') collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] = this.helper.util.str2vec(collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] as string);1397    }1398    const creationResult = await this.helper.executeExtrinsic(1399      signer,1400      'api.tx.unique.createCollectionEx', [collectionOptions],1401      true, // errorLabel,1402    );1403    return this.getCollectionObject(this.helper.util.extractCollectionIdFromCreationResult(creationResult));1404  }14051406  getCollectionObject(_collectionId: number): any {1407    return null;1408  }14091410  getTokenObject(_collectionId: number, _tokenId: number): any {1411    return null;1412  }1413}141414151416class NFTGroup extends NFTnRFT {1417  /**1418   * Get collection object1419   * @param collectionId ID of collection1420   * @example getCollectionObject(2);1421   * @returns instance of UniqueNFTCollection1422   */1423  getCollectionObject(collectionId: number): UniqueNFTCollection {1424    return new UniqueNFTCollection(collectionId, this.helper);1425  }14261427  /**1428   * Get token object1429   * @param collectionId ID of collection1430   * @param tokenId ID of token1431   * @example getTokenObject(10, 5);1432   * @returns instance of UniqueNFTToken1433   */1434  getTokenObject(collectionId: number, tokenId: number): UniqueNFToken {1435    return new UniqueNFToken(tokenId, this.getCollectionObject(collectionId));1436  }14371438  /**1439   * Get token's owner1440   * @param collectionId ID of collection1441   * @param tokenId ID of token1442   * @param blockHashAt optionally query the data at the block with this hash1443   * @example getTokenOwner(10, 5);1444   * @returns Address in CrossAccountId format, e.g. {Substrate: "5DnSF6RRjwteE3BrCj..."}1445   */1446  async getTokenOwner(collectionId: number, tokenId: number, blockHashAt?: string): Promise<CrossAccountId> {1447    let owner;1448    if (typeof blockHashAt === 'undefined') {1449      owner = await this.helper.callRpc('api.rpc.unique.tokenOwner', [collectionId, tokenId]);1450    } else {1451      owner = await this.helper.callRpc('api.rpc.unique.tokenOwner', [collectionId, tokenId, blockHashAt]);1452    }1453    return CrossAccountId.fromLowerCaseKeys(owner.toJSON());1454  }14551456  /**1457   * Is token approved to transfer1458   * @param collectionId ID of collection1459   * @param tokenId ID of token1460   * @param toAccountObj address to be approved1461   * @returns ```true``` if extrinsic success, otherwise ```false```1462   */1463  async isTokenApproved(collectionId: number, tokenId: number, toAccountObj: ICrossAccountId): Promise<boolean> {1464    return (await this.getTokenApprovedPieces(collectionId, tokenId, toAccountObj, await this.getTokenOwner(collectionId, tokenId))) === 1n;1465  }14661467  /**1468   * Changes the owner of the token.1469   *1470   * @param signer keyring of signer1471   * @param collectionId ID of collection1472   * @param tokenId ID of token1473   * @param addressObj address of a new owner1474   * @example transferToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1475   * @returns ```true``` if extrinsic success, otherwise ```false```1476   */1477  async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<boolean> {1478    return await super.transferToken(signer, collectionId, tokenId, addressObj, 1n);1479  }14801481  /**1482   *1483   * Change ownership of a NFT on behalf of the owner.1484   *1485   * @param signer keyring of signer1486   * @param collectionId ID of collection1487   * @param tokenId ID of token1488   * @param fromAddressObj address on behalf of which the token will be sent1489   * @param toAddressObj new token owner1490   * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Ethereum: "0x9F0583DbB85..."})1491   * @returns ```true``` if extrinsic success, otherwise ```false```1492   */1493  async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId): Promise<boolean> {1494    return await super.transferTokenFrom(signer, collectionId, tokenId, fromAddressObj, toAddressObj, 1n);1495  }14961497  /**1498   * Recursively find the address that owns the token1499   * @param collectionId ID of collection1500   * @param tokenId ID of token1501   * @param blockHashAt1502   * @example getTokenTopmostOwner(10, 5);1503   * @returns address in CrossAccountId format, e.g. {Substrate: "5DyN4Y92vZCjv38fg..."}1504   */1505  async getTokenTopmostOwner(collectionId: number, tokenId: number, blockHashAt?: string): Promise<CrossAccountId | null> {1506    let owner;1507    if (typeof blockHashAt === 'undefined') {1508      owner = await this.helper.callRpc('api.rpc.unique.topmostTokenOwner', [collectionId, tokenId]);1509    } else {1510      owner = await this.helper.callRpc('api.rpc.unique.topmostTokenOwner', [collectionId, tokenId, blockHashAt]);1511    }15121513    if (owner === null) return null;15141515    return owner.toHuman();1516  }15171518  /**1519   * Get tokens nested in the provided token1520   * @param collectionId ID of collection1521   * @param tokenId ID of token1522   * @param blockHashAt optionally query the data at the block with this hash1523   * @example getTokenChildren(10, 5);1524   * @returns tokens whose depth of nesting is <= 51525   */1526  async getTokenChildren(collectionId: number, tokenId: number, blockHashAt?: string): Promise<IToken[]> {1527    let children;1528    if(typeof blockHashAt === 'undefined') {1529      children = await this.helper.callRpc('api.rpc.unique.tokenChildren', [collectionId, tokenId]);1530    } else {1531      children = await this.helper.callRpc('api.rpc.unique.tokenChildren', [collectionId, tokenId, blockHashAt]);1532    }15331534    return children.toJSON().map((x: any) => {1535      return {collectionId: x.collection, tokenId: x.token};1536    });1537  }15381539  /**1540   * Nest one token into another1541   * @param signer keyring of signer1542   * @param tokenObj token to be nested1543   * @param rootTokenObj token to be parent1544   * @example nestToken(aliceKeyring, {collectionId: 10, tokenId: 5}, {collectionId: 10, tokenId: 4});1545   * @returns ```true``` if extrinsic success, otherwise ```false```1546   */1547  async nestToken(signer: TSigner, tokenObj: IToken, rootTokenObj: IToken): Promise<boolean> {1548    const rootTokenAddress = this.helper.util.getTokenAccount(rootTokenObj);1549    const result = await this.transferToken(signer, tokenObj.collectionId, tokenObj.tokenId, rootTokenAddress);1550    if(!result) {1551      throw Error('Unable to nest token!');1552    }1553    return result;1554  }15551556  /**1557   * Remove token from nested state1558   * @param signer keyring of signer1559   * @param tokenObj token to unnest1560   * @param rootTokenObj parent of a token1561   * @param toAddressObj address of a new token owner1562   * @example unnestToken(aliceKeyring, {collectionId: 10, tokenId: 5}, {collectionId: 10, tokenId: 4}, {Substrate: "5DyN4Y92vZCjv38fg..."});1563   * @returns ```true``` if extrinsic success, otherwise ```false```1564   */1565  async unnestToken(signer: TSigner, tokenObj: IToken, rootTokenObj: IToken, toAddressObj: ICrossAccountId): Promise<boolean> {1566    const rootTokenAddress = this.helper.util.getTokenAccount(rootTokenObj);1567    const result = await this.transferTokenFrom(signer, tokenObj.collectionId, tokenObj.tokenId, rootTokenAddress, toAddressObj);1568    if(!result) {1569      throw Error('Unable to unnest token!');1570    }1571    return result;1572  }15731574  /**1575   * Mint new collection1576   * @param signer keyring of signer1577   * @param collectionOptions Collection options1578   * @example1579   * mintCollection(aliceKeyring, {1580   *   name: 'New',1581   *   description: 'New collection',1582   *   tokenPrefix: 'NEW',1583   * })1584   * @returns object of the created collection1585   */1586  async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}): Promise<UniqueNFTCollection> {1587    return await super.mintCollection(signer, collectionOptions, 'NFT') as UniqueNFTCollection;1588  }15891590  /**1591   * Mint new token1592   * @param signer keyring of signer1593   * @param data token data1594   * @returns created token object1595   */1596  async mintToken(signer: TSigner, data: { collectionId: number; owner: ICrossAccountId | string; properties?: IProperty[]; }): Promise<UniqueNFToken> {1597    const creationResult = await this.helper.executeExtrinsic(1598      signer,1599      'api.tx.unique.createItem', [data.collectionId, (typeof data.owner === 'string') ? {Substrate: data.owner} : data.owner, {1600        nft: {1601          properties: data.properties,1602        },1603      }],1604      true,1605    );1606    const createdTokens = this.helper.util.extractTokensFromCreationResult(creationResult);1607    if (createdTokens.tokens.length > 1) throw Error('Minted multiple tokens');1608    if (createdTokens.tokens.length < 1) throw Error('No tokens minted');1609    return this.getTokenObject(data.collectionId, createdTokens.tokens[0].tokenId);1610  }16111612  /**1613   * Mint multiple NFT tokens1614   * @param signer keyring of signer1615   * @param collectionId ID of collection1616   * @param tokens array of tokens with owner and properties1617   * @example1618   * mintMultipleTokens(aliceKeyring, 10, [{1619   *     owner: {Substrate: "5DyN4Y92vZCjv38fg..."},1620   *     properties: [{key: "gender", value: "male"},{key: "age", value: "45"}],1621   *   },{1622   *     owner: {Ethereum: "0x9F0583DbB855d..."},1623   *     properties: [{key: "gender", value: "female"},{key: "age", value: "22"}],1624   * }]);1625   * @returns ```true``` if extrinsic success, otherwise ```false```1626   */1627  async mintMultipleTokens(signer: TSigner, collectionId: number, tokens: {owner: ICrossAccountId, properties?: IProperty[]}[]): Promise<UniqueNFToken[]> {1628    const creationResult = await this.helper.executeExtrinsic(1629      signer,1630      'api.tx.unique.createMultipleItemsEx', [collectionId, {NFT: tokens}],1631      true,1632    );1633    const collection = this.getCollectionObject(collectionId);1634    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1635  }16361637  /**1638   * Mint multiple NFT tokens with one owner1639   * @param signer keyring of signer1640   * @param collectionId ID of collection1641   * @param owner tokens owner1642   * @param tokens array of tokens with owner and properties1643   * @example1644   * mintMultipleTokensWithOneOwner(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...", [{1645   *   properties: [{1646   *   key: "gender",1647   *   value: "female",1648   *  },{1649   *   key: "age",1650   *   value: "33",1651   *  }],1652   * }]);1653   * @returns array of newly created tokens1654   */1655  async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, owner: ICrossAccountId, tokens: {properties?: IProperty[]}[]): Promise<UniqueNFToken[]> {1656    const rawTokens = [];1657    for (const token of tokens) {1658      const raw = {NFT: {properties: token.properties}};1659      rawTokens.push(raw);1660    }1661    const creationResult = await this.helper.executeExtrinsic(1662      signer,1663      'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],1664      true,1665    );1666    const collection = this.getCollectionObject(collectionId);1667    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1668  }16691670  /**1671   * Set, change, or remove approved address to transfer the ownership of the NFT.1672   *1673   * @param signer keyring of signer1674   * @param collectionId ID of collection1675   * @param tokenId ID of token1676   * @param toAddressObj address to approve1677   * @example approveToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1678   * @returns ```true``` if extrinsic success, otherwise ```false```1679   */1680  async approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId) {1681    return super.approveToken(signer, collectionId, tokenId, toAddressObj, 1n);1682  }1683}168416851686class RFTGroup extends NFTnRFT {1687  /**1688   * Get collection object1689   * @param collectionId ID of collection1690   * @example getCollectionObject(2);1691   * @returns instance of UniqueRFTCollection1692   */1693  getCollectionObject(collectionId: number): UniqueRFTCollection {1694    return new UniqueRFTCollection(collectionId, this.helper);1695  }16961697  /**1698   * Get token object1699   * @param collectionId ID of collection1700   * @param tokenId ID of token1701   * @example getTokenObject(10, 5);1702   * @returns instance of UniqueNFTToken1703   */1704  getTokenObject(collectionId: number, tokenId: number): UniqueRFToken {1705    return new UniqueRFToken(tokenId, this.getCollectionObject(collectionId));1706  }17071708  /**1709   * Get top 10 token owners with the largest number of pieces1710   * @param collectionId ID of collection1711   * @param tokenId ID of token1712   * @example getTokenTop10Owners(10, 5);1713   * @returns array of top 10 owners1714   */1715  async getTokenTop10Owners(collectionId: number, tokenId: number): Promise<CrossAccountId[]> {1716    return (await this.helper.callRpc('api.rpc.unique.tokenOwners', [collectionId, tokenId])).toJSON().map(CrossAccountId.fromLowerCaseKeys);1717  }17181719  /**1720   * Get number of pieces owned by address1721   * @param collectionId ID of collection1722   * @param tokenId ID of token1723   * @param addressObj address token owner1724   * @example getTokenBalance(10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."});1725   * @returns number of pieces ownerd by address1726   */1727  async getTokenBalance(collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<bigint> {1728    return (await this.helper.callRpc('api.rpc.unique.balance', [collectionId, addressObj, tokenId])).toBigInt();1729  }17301731  /**1732   * Transfer pieces of token to another address1733   * @param signer keyring of signer1734   * @param collectionId ID of collection1735   * @param tokenId ID of token1736   * @param addressObj address of a new owner1737   * @param amount number of pieces to be transfered1738   * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, 2000n)1739   * @returns ```true``` if extrinsic success, otherwise ```false```1740   */1741  async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId, amount=1n): Promise<boolean> {1742    return await super.transferToken(signer, collectionId, tokenId, addressObj, amount);1743  }17441745  /**1746   * Change ownership of some pieces of RFT on behalf of the owner.1747   * @param signer keyring of signer1748   * @param collectionId ID of collection1749   * @param tokenId ID of token1750   * @param fromAddressObj address on behalf of which the token will be sent1751   * @param toAddressObj new token owner1752   * @param amount number of pieces to be transfered1753   * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Substrate: "5DfhbVfww7ThF8q6f3i..."}, 2000n)1754   * @returns ```true``` if extrinsic success, otherwise ```false```1755   */1756  async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n): Promise<boolean> {1757    return await super.transferTokenFrom(signer, collectionId, tokenId, fromAddressObj, toAddressObj, amount);1758  }17591760  /**1761   * Mint new collection1762   * @param signer keyring of signer1763   * @param collectionOptions Collection options1764   * @example1765   * mintCollection(aliceKeyring, {1766   *   name: 'New',1767   *   description: 'New collection',1768   *   tokenPrefix: 'NEW',1769   * })1770   * @returns object of the created collection1771   */1772  async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}): Promise<UniqueRFTCollection> {1773    return await super.mintCollection(signer, collectionOptions, 'RFT') as UniqueRFTCollection;1774  }17751776  /**1777   * Mint new token1778   * @param signer keyring of signer1779   * @param data token data1780   * @example mintToken(aliceKeyring, {collectionId: 10, owner: {Substrate: '5GHoZe9c73RYbVzq...'}, pieces: 10000n});1781   * @returns created token object1782   */1783  async mintToken(signer: TSigner, data: { collectionId: number; owner: ICrossAccountId | string; pieces: bigint; properties?: IProperty[]; }): Promise<UniqueRFToken> {1784    const creationResult = await this.helper.executeExtrinsic(1785      signer,1786      'api.tx.unique.createItem', [data.collectionId, (typeof data.owner === 'string') ? {Substrate: data.owner} : data.owner, {1787        refungible: {1788          pieces: data.pieces,1789          properties: data.properties,1790        },1791      }],1792      true,1793    );1794    const createdTokens = this.helper.util.extractTokensFromCreationResult(creationResult);1795    if (createdTokens.tokens.length > 1) throw Error('Minted multiple tokens');1796    if (createdTokens.tokens.length < 1) throw Error('No tokens minted');1797    return this.getTokenObject(data.collectionId, createdTokens.tokens[0].tokenId);1798  }17991800  async mintMultipleTokens(signer: TSigner, collectionId: number, tokens: {owner: ICrossAccountId, pieces: bigint, properties?: IProperty[]}[]): Promise<UniqueRFToken[]> {1801    throw Error('Not implemented');1802    const creationResult = await this.helper.executeExtrinsic(1803      signer,1804      'api.tx.unique.createMultipleItemsEx', [collectionId, {RefungibleMultipleOwners: tokens}],1805      true, // `Unable to mint RFT tokens for ${label}`,1806    );1807    const collection = this.getCollectionObject(collectionId);1808    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1809  }18101811  /**1812   * Mint multiple RFT tokens with one owner1813   * @param signer keyring of signer1814   * @param collectionId ID of collection1815   * @param owner tokens owner1816   * @param tokens array of tokens with properties and pieces1817   * @example mintMultipleTokensWithOneOwner(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, [{pieces: 100000n, properties: [{key: "gender", value: "male"}]}]);1818   * @returns array of newly created RFT tokens1819   */1820  async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, owner: ICrossAccountId, tokens: {pieces: bigint, properties?: IProperty[]}[]): Promise<UniqueRFToken[]> {1821    const rawTokens = [];1822    for (const token of tokens) {1823      const raw = {ReFungible: {pieces: token.pieces, properties: token.properties}};1824      rawTokens.push(raw);1825    }1826    const creationResult = await this.helper.executeExtrinsic(1827      signer,1828      'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],1829      true,1830    );1831    const collection = this.getCollectionObject(collectionId);1832    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1833  }18341835  /**1836   * Destroys a concrete instance of RFT.1837   * @param signer keyring of signer1838   * @param collectionId ID of collection1839   * @param tokenId ID of token1840   * @param amount number of pieces to be burnt1841   * @example burnToken(aliceKeyring, 10, 5);1842   * @returns ```true``` if the extrinsic is successful, otherwise ```false```1843   */1844  async burnToken(signer: IKeyringPair, collectionId: number, tokenId: number, amount=1n): Promise<boolean> {1845    return await super.burnToken(signer, collectionId, tokenId, amount);1846  }18471848  /**1849   * Destroys a concrete instance of RFT on behalf of the owner.1850   * @param signer keyring of signer1851   * @param collectionId ID of collection1852   * @param tokenId ID of token1853   * @param fromAddressObj address on behalf of which the token will be burnt1854   * @param amount number of pieces to be burnt1855   * @example burnTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, 2n)1856   * @returns ```true``` if extrinsic success, otherwise ```false```1857   */1858  async burnTokenFrom(signer: IKeyringPair, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, amount=1n): Promise<boolean> {1859    return await super.burnTokenFrom(signer, collectionId, tokenId, fromAddressObj, amount);1860  }18611862  /**1863   * Set, change, or remove approved address to transfer the ownership of the RFT.1864   *1865   * @param signer keyring of signer1866   * @param collectionId ID of collection1867   * @param tokenId ID of token1868   * @param toAddressObj address to approve1869   * @param amount number of pieces to be approved1870   * @example approveToken(aliceKeyring, 10, 5, {Substrate: "5GHoZe9c73RYbVzq..."}, "", 10000n);1871   * @returns true if the token success, otherwise false1872   */1873  async approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount=1n) {1874    return super.approveToken(signer, collectionId, tokenId, toAddressObj, amount);1875  }18761877  /**1878   * Get total number of pieces1879   * @param collectionId ID of collection1880   * @param tokenId ID of token1881   * @example getTokenTotalPieces(10, 5);1882   * @returns number of pieces1883   */1884  async getTokenTotalPieces(collectionId: number, tokenId: number): Promise<bigint> {1885    return (await this.helper.callRpc('api.rpc.unique.totalPieces', [collectionId, tokenId])).unwrap().toBigInt();1886  }18871888  /**1889   * Change number of token pieces. Signer must be the owner of all token pieces.1890   * @param signer keyring of signer1891   * @param collectionId ID of collection1892   * @param tokenId ID of token1893   * @param amount new number of pieces1894   * @example repartitionToken(aliceKeyring, 10, 5, 12345n);1895   * @returns true if the repartion was success, otherwise false1896   */1897  async repartitionToken(signer: TSigner, collectionId: number, tokenId: number, amount: bigint): Promise<boolean> {1898    const currentAmount = await this.getTokenTotalPieces(collectionId, tokenId);1899    const repartitionResult = await this.helper.executeExtrinsic(1900      signer,1901      'api.tx.unique.repartition', [collectionId, tokenId, amount],1902      true,1903    );1904    if(currentAmount < amount) return this.helper.util.findCollectionInEvents(repartitionResult.result.events, collectionId, 'common', 'ItemCreated');1905    return this.helper.util.findCollectionInEvents(repartitionResult.result.events, collectionId, 'common', 'ItemDestroyed');1906  }1907}190819091910class FTGroup extends CollectionGroup {1911  /**1912   * Get collection object1913   * @param collectionId ID of collection1914   * @example getCollectionObject(2);1915   * @returns instance of UniqueFTCollection1916   */1917  getCollectionObject(collectionId: number): UniqueFTCollection {1918    return new UniqueFTCollection(collectionId, this.helper);1919  }19201921  /**1922   * Mint new fungible collection1923   * @param signer keyring of signer1924   * @param collectionOptions Collection options1925   * @param decimalPoints number of token decimals1926   * @example1927   * mintCollection(aliceKeyring, {1928   *   name: 'New',1929   *   description: 'New collection',1930   *   tokenPrefix: 'NEW',1931   * }, 18)1932   * @returns newly created fungible collection1933   */1934  async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}, decimalPoints = 0): Promise<UniqueFTCollection> {1935    collectionOptions = JSON.parse(JSON.stringify(collectionOptions)) as ICollectionCreationOptions; // Clone object1936    if(collectionOptions.tokenPropertyPermissions) throw Error('Fungible collections has no tokenPropertyPermissions');1937    collectionOptions.mode = {fungible: decimalPoints};1938    for (const key of ['name', 'description', 'tokenPrefix']) {1939      if (typeof collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] === 'string') collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] = this.helper.util.str2vec(collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] as string);1940    }1941    const creationResult = await this.helper.executeExtrinsic(1942      signer,1943      'api.tx.unique.createCollectionEx', [collectionOptions],1944      true,1945    );1946    return this.getCollectionObject(this.helper.util.extractCollectionIdFromCreationResult(creationResult));1947  }19481949  /**1950   * Mint tokens1951   * @param signer keyring of signer1952   * @param collectionId ID of collection1953   * @param owner address owner of new tokens1954   * @param amount amount of tokens to be meanted1955   * @example mintTokens(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq"}, 1000n);1956   * @returns ```true``` if extrinsic success, otherwise ```false```1957   */1958  async mintTokens(signer: TSigner, collectionId: number, amount: bigint, owner: ICrossAccountId | string): Promise<boolean> {1959    const creationResult = await this.helper.executeExtrinsic(1960      signer,1961      'api.tx.unique.createItem', [collectionId, (typeof owner === 'string') ? {Substrate: owner} : owner, {1962        fungible: {1963          value: amount,1964        },1965      }],1966      true, // `Unable to mint fungible tokens for ${label}`,1967    );1968    return this.helper.util.findCollectionInEvents(creationResult.result.events, collectionId, 'common', 'ItemCreated');1969  }19701971  /**1972   * Mint multiple Fungible tokens with one owner1973   * @param signer keyring of signer1974   * @param collectionId ID of collection1975   * @param owner tokens owner1976   * @param tokens array of tokens with properties and pieces1977   * @returns ```true``` if extrinsic success, otherwise ```false```1978   */1979  async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, tokens: {value: bigint}[], owner: ICrossAccountId): Promise<boolean> {1980    const rawTokens = [];1981    for (const token of tokens) {1982      const raw = {Fungible: {Value: token.value}};1983      rawTokens.push(raw);1984    }1985    const creationResult = await this.helper.executeExtrinsic(1986      signer,1987      'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],1988      true,1989    );1990    return this.helper.util.findCollectionInEvents(creationResult.result.events, collectionId, 'common', 'ItemCreated');1991  }19921993  /**1994   * Get the top 10 owners with the largest balance for the Fungible collection1995   * @param collectionId ID of collection1996   * @example getTop10Owners(10);1997   * @returns array of ```ICrossAccountId```1998   */1999  async getTop10Owners(collectionId: number): Promise<CrossAccountId[]> {2000    return (await this.helper.callRpc('api.rpc.unique.tokenOwners', [collectionId, 0])).toJSON().map(CrossAccountId.fromLowerCaseKeys);2001  }20022003  /**2004   * Get account balance2005   * @param collectionId ID of collection2006   * @param addressObj address of owner2007   * @example getBalance(10, {Substrate: "5GHoZe9c73RYbVzq..."})2008   * @returns amount of fungible tokens owned by address2009   */2010  async getBalance(collectionId: number, addressObj: ICrossAccountId): Promise<bigint> {2011    return (await this.helper.callRpc('api.rpc.unique.balance', [collectionId, addressObj, 0])).toBigInt();2012  }20132014  /**2015   * Transfer tokens to address2016   * @param signer keyring of signer2017   * @param collectionId ID of collection2018   * @param toAddressObj address recipient2019   * @param amount amount of tokens to be sent2020   * @example transfer(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n);2021   * @returns ```true``` if extrinsic success, otherwise ```false```2022   */2023  async transfer(signer: TSigner, collectionId: number, toAddressObj: ICrossAccountId, amount=1n) {2024    return await super.transferToken(signer, collectionId, 0, toAddressObj, amount);2025  }20262027  /**2028   * Transfer some tokens on behalf of the owner.2029   * @param signer keyring of signer2030   * @param collectionId ID of collection2031   * @param fromAddressObj address on behalf of which tokens will be sent2032   * @param toAddressObj address where token to be sent2033   * @param amount number of tokens to be sent2034   * @example transferFrom(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, {Substrate: "5DfhbVfww7ThF8q6f3ij..."}, 10000n);2035   * @returns ```true``` if extrinsic success, otherwise ```false```2036   */2037  async transferFrom(signer: TSigner, collectionId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n) {2038    return await super.transferTokenFrom(signer, collectionId, 0, fromAddressObj, toAddressObj, amount);2039  }20402041  /**2042   * Destroy some amount of tokens2043   * @param signer keyring of signer2044   * @param collectionId ID of collection2045   * @param amount amount of tokens to be destroyed2046   * @example burnTokens(aliceKeyring, 10, 1000n);2047   * @returns ```true``` if extrinsic success, otherwise ```false```2048   */2049  async burnTokens(signer: IKeyringPair, collectionId: number, amount=1n): Promise<boolean> {2050    return await super.burnToken(signer, collectionId, 0, amount);2051  }20522053  /**2054   * Burn some tokens on behalf of the owner.2055   * @param signer keyring of signer2056   * @param collectionId ID of collection2057   * @param fromAddressObj address on behalf of which tokens will be burnt2058   * @param amount amount of tokens to be burnt2059   * @example burnTokensFrom(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n);2060   * @returns ```true``` if extrinsic success, otherwise ```false```2061   */2062  async burnTokensFrom(signer: IKeyringPair, collectionId: number, fromAddressObj: ICrossAccountId, amount=1n): Promise<boolean> {2063    return await super.burnTokenFrom(signer, collectionId, 0, fromAddressObj, amount);2064  }20652066  /**2067   * Get total collection supply2068   * @param collectionId2069   * @returns2070   */2071  async getTotalPieces(collectionId: number): Promise<bigint> {2072    return (await this.helper.callRpc('api.rpc.unique.totalPieces', [collectionId, 0])).unwrap().toBigInt();2073  }20742075  /**2076   * Set, change, or remove approved address to transfer tokens.2077   *2078   * @param signer keyring of signer2079   * @param collectionId ID of collection2080   * @param toAddressObj address to be approved2081   * @param amount amount of tokens to be approved2082   * @example approveTokens(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n)2083   * @returns ```true``` if extrinsic success, otherwise ```false```2084   */2085  async approveTokens(signer: IKeyringPair, collectionId: number, toAddressObj: ICrossAccountId, amount=1n) {2086    return super.approveToken(signer, collectionId, 0, toAddressObj, amount);2087  }20882089  /**2090   * Get amount of fungible tokens approved to transfer2091   * @param collectionId ID of collection2092   * @param fromAddressObj owner of tokens2093   * @param toAddressObj the address approved for the transfer of tokens on behalf of the owner2094   * @returns number of tokens approved for the transfer2095   */2096  async getApprovedTokens(collectionId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {2097    return super.getTokenApprovedPieces(collectionId, 0, toAddressObj, fromAddressObj);2098  }2099}210021012102class ChainGroup extends HelperGroup<ChainHelperBase> {2103  /**2104   * Get system properties of a chain2105   * @example getChainProperties();2106   * @returns ss58Format, token decimals, and token symbol2107   */2108  getChainProperties(): IChainProperties {2109    const properties = (this.helper.getApi() as any).registry.getChainProperties().toJSON();2110    return {2111      ss58Format: properties.ss58Format.toJSON(),2112      tokenDecimals: properties.tokenDecimals.toJSON(),2113      tokenSymbol: properties.tokenSymbol.toJSON(),2114    };2115  }21162117  /**2118   * Get chain header2119   * @example getLatestBlockNumber();2120   * @returns the number of the last block2121   */2122  async getLatestBlockNumber(): Promise<number> {2123    return (await this.helper.callRpc('api.rpc.chain.getHeader')).number.toNumber();2124  }21252126  /**2127   * Get block hash by block number2128   * @param blockNumber number of block2129   * @example getBlockHashByNumber(12345);2130   * @returns hash of a block2131   */2132  async getBlockHashByNumber(blockNumber: number): Promise<string | null> {2133    const blockHash = (await this.helper.callRpc('api.rpc.chain.getBlockHash', [blockNumber])).toJSON();2134    if(blockHash === '0x0000000000000000000000000000000000000000000000000000000000000000') return null;2135    return blockHash;2136  }21372138  // TODO add docs2139  async getBlock(blockHashOrNumber: string | number): Promise<IBlock | null> {2140    const blockHash = typeof blockHashOrNumber === 'string' ? blockHashOrNumber : await this.getBlockHashByNumber(blockHashOrNumber);2141    if (!blockHash) return null;2142    return (await this.helper.callRpc('api.rpc.chain.getBlock', [blockHash])).toHuman().block;2143  }21442145  /**2146   * Get account nonce2147   * @param address substrate address2148   * @example getNonce("5GrwvaEF5zXb26Fz...");2149   * @returns number, account's nonce2150   */2151  async getNonce(address: TSubstrateAccount): Promise<number> {2152    return (await this.helper.callRpc('api.query.system.account', [address])).nonce.toNumber();2153  }2154}21552156class SubstrateBalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2157  /**2158 * Get substrate address balance2159 * @param address substrate address2160 * @example getSubstrate("5GrwvaEF5zXb26Fz...")2161 * @returns amount of tokens on address2162 */2163  async getSubstrate(address: TSubstrateAccount): Promise<bigint> {2164    return (await this.helper.callRpc('api.query.system.account', [address])).data.free.toBigInt();2165  }21662167  /**2168   * Transfer tokens to substrate address2169   * @param signer keyring of signer2170   * @param address substrate address of a recipient2171   * @param amount amount of tokens to be transfered2172   * @example transferToSubstrate(aliceKeyring, "5GrwvaEF5zXb26Fz...", 100_000_000_000n);2173   * @returns ```true``` if extrinsic success, otherwise ```false```2174   */2175  async transferToSubstrate(signer: TSigner, address: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2176    const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.transfer', [address, amount], true/*, `Unable to transfer balance from ${this.helper.getSignerAddress(signer)} to ${address}`*/);21772178    let transfer = {from: null, to: null, amount: 0n} as any;2179    result.result.events.forEach(({event: {data, method, section}}) => {2180      if ((section === 'balances') && (method === 'Transfer')) {2181        transfer = {2182          from: this.helper.address.normalizeSubstrate(data[0]),2183          to: this.helper.address.normalizeSubstrate(data[1]),2184          amount: BigInt(data[2]),2185        };2186      }2187    });2188    const isSuccess = this.helper.address.normalizeSubstrate(typeof signer === 'string' ? signer : signer.address) === transfer.from2189      && this.helper.address.normalizeSubstrate(address) === transfer.to2190      && BigInt(amount) === transfer.amount;2191    return isSuccess;2192  }21932194  /**2195   * Get full substrate balance including free, miscFrozen, feeFrozen, and reserved2196   * @param address substrate address2197   * @returns2198   */2199  async getSubstrateFull(address: TSubstrateAccount): Promise<ISubstrateBalance> {2200    const accountInfo = (await this.helper.callRpc('api.query.system.account', [address])).data;2201    return {free: accountInfo.free.toBigInt(), miscFrozen: accountInfo.miscFrozen.toBigInt(), feeFrozen: accountInfo.feeFrozen.toBigInt(), reserved: accountInfo.reserved.toBigInt()};2202  }2203}22042205class EthereumBalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2206  /**2207   * Get ethereum address balance2208   * @param address ethereum address2209   * @example getEthereum("0x9F0583DbB855d...")2210   * @returns amount of tokens on address2211   */2212  async getEthereum(address: TEthereumAccount): Promise<bigint> {2213    return (await this.helper.callRpc('api.rpc.eth.getBalance', [address])).toBigInt();2214  }22152216  /**2217   * Transfer tokens to address2218   * @param signer keyring of signer2219   * @param address Ethereum address of a recipient2220   * @param amount amount of tokens to be transfered2221   * @example transferToEthereum(alithKeyring, "0x9F0583DbB855d...", 100_000_000_000n);2222   * @returns ```true``` if extrinsic success, otherwise ```false```2223   */2224  async transferToEthereum(signer: TSigner, address: TEthereumAccount, amount: bigint | string): Promise<boolean> {2225    const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.transfer', [address, amount], true);22262227    let transfer = {from: null, to: null, amount: 0n} as any;2228    result.result.events.forEach(({event: {data, method, section}}) => {2229      if ((section === 'balances') && (method === 'Transfer')) {2230        transfer = {2231          from: data[0].toString(),2232          to: data[1].toString(),2233          amount: BigInt(data[2]),2234        };2235      }2236    });2237    const isSuccess = (typeof signer === 'string' ? signer : signer.address) === transfer.from2238      && address === transfer.to2239      && BigInt(amount) === transfer.amount;2240    return isSuccess;2241  }2242}22432244class BalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2245  subBalanceGroup: SubstrateBalanceGroup<T>;2246  ethBalanceGroup: EthereumBalanceGroup<T>;22472248  constructor(helper: T) {2249    super(helper);2250    this.subBalanceGroup = new SubstrateBalanceGroup(helper);2251    this.ethBalanceGroup = new EthereumBalanceGroup(helper);2252  }22532254  getCollectionCreationPrice(): bigint {2255    return 2n * this.getOneTokenNominal();2256  }2257  /**2258   * Representation of the native token in the smallest unit - one OPAL (OPL), QUARTZ (QTZ), or UNIQUE (UNQ).2259   * @example getOneTokenNominal()2260   * @returns ```BigInt``` representation of the native token in the smallest unit, e.g. ```1_000_000_000_000_000_000n``` for QTZ.2261   */2262  getOneTokenNominal(): bigint {2263    const chainProperties = this.helper.chain.getChainProperties();2264    return 10n ** BigInt((chainProperties.tokenDecimals || [18])[0]);2265  }22662267  /**2268   * Get substrate address balance2269   * @param address substrate address2270   * @example getSubstrate("5GrwvaEF5zXb26Fz...")2271   * @returns amount of tokens on address2272   */2273  async getSubstrate(address: TSubstrateAccount): Promise<bigint> {2274    return this.subBalanceGroup.getSubstrate(address);2275  }22762277  /**2278   * Get full substrate balance including free, miscFrozen, feeFrozen, and reserved2279   * @param address substrate address2280   * @returns2281   */2282  async getSubstrateFull(address: TSubstrateAccount): Promise<ISubstrateBalance> {2283    return this.subBalanceGroup.getSubstrateFull(address);2284  }22852286  /**2287   * Get ethereum address balance2288   * @param address ethereum address2289   * @example getEthereum("0x9F0583DbB855d...")2290   * @returns amount of tokens on address2291   */2292  async getEthereum(address: TEthereumAccount): Promise<bigint> {2293    return this.ethBalanceGroup.getEthereum(address);2294  }22952296  /**2297   * Transfer tokens to substrate address2298   * @param signer keyring of signer2299   * @param address substrate address of a recipient2300   * @param amount amount of tokens to be transfered2301   * @example transferToSubstrate(aliceKeyring, "5GrwvaEF5zXb26Fz...", 100_000_000_000n);2302   * @returns ```true``` if extrinsic success, otherwise ```false```2303   */2304  async transferToSubstrate(signer: TSigner, address: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2305    return this.subBalanceGroup.transferToSubstrate(signer, address, amount);2306  }23072308  async forceTransferToSubstrate(signer: TSigner, from: TSubstrateAccount, to: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2309    const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.forceTransfer', [from, to, amount], true);23102311    let transfer = {from: null, to: null, amount: 0n} as any;2312    result.result.events.forEach(({event: {data, method, section}}) => {2313      if ((section === 'balances') && (method === 'Transfer')) {2314        transfer = {2315          from: this.helper.address.normalizeSubstrate(data[0]),2316          to: this.helper.address.normalizeSubstrate(data[1]),2317          amount: BigInt(data[2]),2318        };2319      }2320    });2321    let isSuccess = this.helper.address.normalizeSubstrate(from) === transfer.from;2322    isSuccess = isSuccess && this.helper.address.normalizeSubstrate(to) === transfer.to;2323    isSuccess = isSuccess && BigInt(amount) === transfer.amount;2324    return isSuccess;2325  }2326}23272328class AddressGroup extends HelperGroup<ChainHelperBase> {2329  /**2330   * Normalizes the address to the specified ss58 format, by default ```42```.2331   * @param address substrate address2332   * @param ss58Format format for address conversion, by default ```42```2333   * @example normalizeSubstrate("unjKJQJrRd238pkUZZvzDQrfKuM39zBSnQ5zjAGAGcdRhaJTx") // returns 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY2334   * @returns substrate address converted to normalized (i.e., starting with 5) or specified explicitly representation2335   */2336  normalizeSubstrate(address: TSubstrateAccount, ss58Format = 42): TSubstrateAccount {2337    return CrossAccountId.normalizeSubstrateAddress(address, ss58Format);2338  }23392340  /**2341   * Get address in the connected chain format2342   * @param address substrate address2343   * @example normalizeSubstrateToChainFormat("5GrwvaEF5zXb26Fz...") // returns unjKJQJrRd238pkUZZ... for Unique Network2344   * @returns address in chain format2345   */2346  normalizeSubstrateToChainFormat(address: TSubstrateAccount): TSubstrateAccount {2347    return this.normalizeSubstrate(address, this.helper.chain.getChainProperties().ss58Format);2348  }23492350  /**2351   * Get substrate mirror of an ethereum address2352   * @param ethAddress ethereum address2353   * @param toChainFormat false for normalized account2354   * @example ethToSubstrate('0x9F0583DbB855d...')2355   * @returns substrate mirror of a provided ethereum address2356   */2357  ethToSubstrate(ethAddress: TEthereumAccount, toChainFormat=false): TSubstrateAccount {2358    return CrossAccountId.translateEthToSub(ethAddress, toChainFormat ? this.helper.chain.getChainProperties().ss58Format : undefined);2359  }23602361  /**2362   * Get ethereum mirror of a substrate address2363   * @param subAddress substrate account2364   * @example substrateToEth("5DnSF6RRjwteE3BrC...")2365   * @returns ethereum mirror of a provided substrate address2366   */2367  substrateToEth(subAddress: TSubstrateAccount): TEthereumAccount {2368    return CrossAccountId.translateSubToEth(subAddress);2369  }23702371  paraSiblingSovereignAccount(paraid: number) {2372    // We are getting a *sibling* parachain sovereign account,2373    // so we need a sibling prefix: encoded(b"sibl") == 0x7369626c2374    const siblingPrefix = '0x7369626c';23752376    const encodedParaId = this.helper.getApi().createType('u32', paraid).toHex(true).substring(2);2377    const suffix = '000000000000000000000000000000000000000000000000';23782379    return siblingPrefix + encodedParaId + suffix;2380  }2381}23822383class StakingGroup extends HelperGroup<UniqueHelper> {2384  /**2385   * Stake tokens for App Promotion2386   * @param signer keyring of signer2387   * @param amountToStake amount of tokens to stake2388   * @param label extra label for log2389   * @returns2390   */2391  async stake(signer: TSigner, amountToStake: bigint, label?: string): Promise<boolean> {2392    if(typeof label === 'undefined') label = `${signer.address} amount: ${amountToStake}`;2393    const _stakeResult = await this.helper.executeExtrinsic(2394      signer, 'api.tx.appPromotion.stake',2395      [amountToStake], true,2396    );2397    // TODO extract info from stakeResult2398    return true;2399  }24002401  /**2402   * Unstake tokens for App Promotion2403   * @param signer keyring of signer2404   * @param amountToUnstake amount of tokens to unstake2405   * @param label extra label for log2406   * @returns block number where balances will be unlocked2407   */2408  async unstake(signer: TSigner, label?: string): Promise<number> {2409    if(typeof label === 'undefined') label = `${signer.address}`;2410    const _unstakeResult = await this.helper.executeExtrinsic(2411      signer, 'api.tx.appPromotion.unstake',2412      [], true,2413    );2414    // TODO extract block number fron events2415    return 1;2416  }24172418  /**2419   * Get total staked amount for address2420   * @param address substrate or ethereum address2421   * @returns total staked amount2422   */2423  async getTotalStaked(address?: ICrossAccountId): Promise<bigint> {2424    if (address) return (await this.helper.callRpc('api.rpc.appPromotion.totalStaked', [address])).toBigInt();2425    return (await this.helper.callRpc('api.rpc.appPromotion.totalStaked')).toBigInt();2426  }24272428  /**2429   * Get total staked per block2430   * @param address substrate or ethereum address2431   * @returns array of stakes. `block` – the number of the block in which the stake was made. `amount` - the number of tokens staked in the block2432   */2433  async getTotalStakedPerBlock(address: ICrossAccountId): Promise<IStakingInfo[]> {2434    const rawTotalStakerdPerBlock = await this.helper.callRpc('api.rpc.appPromotion.totalStakedPerBlock', [address]);2435    return rawTotalStakerdPerBlock.map(([block, amount]: any[]) => {2436      return {2437        block: block.toBigInt(),2438        amount: amount.toBigInt(),2439      };2440    });2441  }24422443  /**2444   * Get total pending unstake amount for address2445   * @param address substrate or ethereum address2446   * @returns total pending unstake amount2447   */2448  async getPendingUnstake(address: ICrossAccountId): Promise<bigint> {2449    return (await this.helper.callRpc('api.rpc.appPromotion.pendingUnstake', [address])).toBigInt();2450  }24512452  /**2453   * Get pending unstake amount per block for address2454   * @param address substrate or ethereum address2455   * @returns array of pending stakes. `block` – the number of the block in which the unstake was made. `amount` - the number of tokens unstaked in the block2456   */2457  async getPendingUnstakePerBlock(address: ICrossAccountId): Promise<IStakingInfo[]> {2458    const rawUnstakedPerBlock = await this.helper.callRpc('api.rpc.appPromotion.pendingUnstakePerBlock', [address]);2459    const result = rawUnstakedPerBlock.map(([block, amount]: any[]) => {2460      return {2461        block: block.toBigInt(),2462        amount: amount.toBigInt(),2463      };2464    });2465    return result;2466  }2467}24682469class SchedulerGroup extends HelperGroup<UniqueHelper> {2470  constructor(helper: UniqueHelper) {2471    super(helper);2472  }24732474  async cancelScheduled(signer: TSigner, scheduledId: string) {2475    return this.helper.executeExtrinsic(2476      signer,2477      'api.tx.scheduler.cancelNamed',2478      [scheduledId],2479      true,2480    );2481  }24822483  async changePriority(signer: TSigner, scheduledId: string, priority: number) {2484    return this.helper.executeExtrinsic(2485      signer,2486      'api.tx.scheduler.changeNamedPriority',2487      [scheduledId, priority],2488      true,2489    );2490  }24912492  scheduleAt<T extends UniqueHelper>(2493    scheduledId: string,2494    executionBlockNumber: number,2495    options: ISchedulerOptions = {},2496  ) {2497    return this.schedule<T>('scheduleNamed', scheduledId, executionBlockNumber, options);2498  }24992500  scheduleAfter<T extends UniqueHelper>(2501    scheduledId: string,2502    blocksBeforeExecution: number,2503    options: ISchedulerOptions = {},2504  ) {2505    return this.schedule<T>('scheduleNamedAfter', scheduledId, blocksBeforeExecution, options);2506  }25072508  schedule<T extends UniqueHelper>(2509    scheduleFn: 'scheduleNamed' | 'scheduleNamedAfter',2510    scheduledId: string,2511    blocksNum: number,2512    options: ISchedulerOptions = {},2513  ) {2514    // eslint-disable-next-line @typescript-eslint/naming-convention2515    const ScheduledHelperType = ScheduledUniqueHelper(this.helper.helperBase);2516    return this.helper.clone(ScheduledHelperType, {2517      scheduleFn,2518      scheduledId,2519      blocksNum,2520      options,2521    }) as T;2522  }2523}25242525class ForeignAssetsGroup extends HelperGroup<UniqueHelper> {2526  async register(signer: TSigner, ownerAddress: TSubstrateAccount, location: any, metadata: IForeignAssetMetadata) {2527    await this.helper.executeExtrinsic(2528      signer,2529      'api.tx.foreignAssets.registerForeignAsset',2530      [ownerAddress, location, metadata],2531      true,2532    );2533  }25342535  async update(signer: TSigner, foreignAssetId: number, location: any, metadata: IForeignAssetMetadata) {2536    await this.helper.executeExtrinsic(2537      signer,2538      'api.tx.foreignAssets.updateForeignAsset',2539      [foreignAssetId, location, metadata],2540      true,2541    );2542  }2543}25442545class XcmGroup<T extends ChainHelperBase> extends HelperGroup<T> {2546  palletName: string;25472548  constructor(helper: T, palletName: string) {2549    super(helper);25502551    this.palletName = palletName;2552  }25532554  async limitedReserveTransferAssets(signer: TSigner, destination: any, beneficiary: any, assets: any, feeAssetItem: number, weightLimit: number) {2555    await this.helper.executeExtrinsic(signer, `api.tx.${this.palletName}.limitedReserveTransferAssets`, [destination, beneficiary, assets, feeAssetItem, {Limited: weightLimit}], true);2556  }2557}25582559class XTokensGroup<T extends ChainHelperBase> extends HelperGroup<T> {2560  async transfer(signer: TSigner, currencyId: any, amount: bigint, destination: any, destWeight: number) {2561    await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transfer', [currencyId, amount, destination, destWeight], true);2562  }25632564  async transferMultiasset(signer: TSigner, asset: any, destination: any, destWeight: number) {2565    await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transferMultiasset', [asset, destination, destWeight], true);2566  }25672568  async transferMulticurrencies(signer: TSigner, currencies: any[], feeItem: number, destLocation: any, destWeight: number) {2569    await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transferMulticurrencies', [currencies, feeItem, destLocation, destWeight], true);2570  }2571}25722573class TokensGroup<T extends ChainHelperBase> extends HelperGroup<T> {2574  async accounts(address: string, currencyId: any) {2575    const {free} = (await this.helper.callRpc('api.query.tokens.accounts', [address, currencyId])).toJSON() as any;2576    return BigInt(free);2577  }2578}25792580class AssetsGroup<T extends ChainHelperBase> extends HelperGroup<T> {2581  async create(signer: TSigner, assetId: number, admin: string, minimalBalance: bigint) {2582    await this.helper.executeExtrinsic(signer, 'api.tx.assets.create', [assetId, admin, minimalBalance], true);2583  }25842585  async setMetadata(signer: TSigner, assetId: number, name: string, symbol: string, decimals: number) {2586    await this.helper.executeExtrinsic(signer, 'api.tx.assets.setMetadata', [assetId, name, symbol, decimals], true);2587  }25882589  async mint(signer: TSigner, assetId: number, beneficiary: string, amount: bigint) {2590    await this.helper.executeExtrinsic(signer, 'api.tx.assets.mint', [assetId, beneficiary, amount], true);2591  }25922593  async account(assetId: string | number, address: string) {2594    const accountAsset = (2595      await this.helper.callRpc('api.query.assets.account', [assetId, address])2596    ).toJSON()! as any;25972598    if (accountAsset !== null) {2599      return BigInt(accountAsset['balance']);2600    } else {2601      return null;2602    }2603  }2604}26052606class AcalaAssetRegistryGroup extends HelperGroup<AcalaHelper> {2607  async registerForeignAsset(signer: TSigner, destination: any, metadata: AcalaAssetMetadata) {2608    await this.helper.executeExtrinsic(signer, 'api.tx.assetRegistry.registerForeignAsset', [destination, metadata], true);2609  }2610}26112612class MoonbeamAssetManagerGroup extends HelperGroup<MoonbeamHelper> {2613  makeRegisterForeignAssetProposal(assetInfo: MoonbeamAssetInfo) {2614    const apiPrefix = 'api.tx.assetManager.';26152616    const registerTx = this.helper.constructApiCall(2617      apiPrefix + 'registerForeignAsset',2618      [assetInfo.location, assetInfo.metadata, assetInfo.existentialDeposit, assetInfo.isSufficient],2619    );26202621    const setUnitsTx = this.helper.constructApiCall(2622      apiPrefix + 'setAssetUnitsPerSecond',2623      [assetInfo.location, assetInfo.unitsPerSecond, assetInfo.numAssetsWeightHint],2624    );26252626    const batchCall = this.helper.getApi().tx.utility.batchAll([registerTx, setUnitsTx]);2627    const encodedProposal = batchCall?.method.toHex() || '';2628    return encodedProposal;2629  }26302631  async assetTypeId(location: any) {2632    return await this.helper.callRpc('api.query.assetManager.assetTypeId', [location]);2633  }2634}26352636class MoonbeamDemocracyGroup extends HelperGroup<MoonbeamHelper> {2637  async notePreimage(signer: TSigner, encodedProposal: string) {2638    await this.helper.executeExtrinsic(signer, 'api.tx.democracy.notePreimage', [encodedProposal], true);2639  }26402641  externalProposeMajority(proposalHash: string) {2642    return this.helper.constructApiCall('api.tx.democracy.externalProposeMajority', [proposalHash]);2643  }26442645  fastTrack(proposalHash: string, votingPeriod: number, delayPeriod: number) {2646    return this.helper.constructApiCall('api.tx.democracy.fastTrack', [proposalHash, votingPeriod, delayPeriod]);2647  }26482649  async referendumVote(signer: TSigner, referendumIndex: number, accountVote: DemocracyStandardAccountVote) {2650    await this.helper.executeExtrinsic(signer, 'api.tx.democracy.vote', [referendumIndex, {Standard: accountVote}], true);2651  }2652}26532654class MoonbeamCollectiveGroup extends HelperGroup<MoonbeamHelper> {2655  collective: string;26562657  constructor(helper: MoonbeamHelper, collective: string) {2658    super(helper);26592660    this.collective = collective;2661  }26622663  async propose(signer: TSigner, threshold: number, proposalHash: string, lengthBound: number) {2664    await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.propose`, [threshold, proposalHash, lengthBound], true);2665  }26662667  async vote(signer: TSigner, proposalHash: string, proposalIndex: number, approve: boolean) {2668    await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.vote`, [proposalHash, proposalIndex, approve], true);2669  }26702671  async close(signer: TSigner, proposalHash: string, proposalIndex: number, weightBound: number, lengthBound: number) {2672    await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.close`, [proposalHash, proposalIndex, weightBound, lengthBound], true);2673  }26742675  async proposalCount() {2676    return Number(await this.helper.callRpc(`api.query.${this.collective}.proposalCount`, []));2677  }2678}26792680export type ChainHelperBaseConstructor = new(...args: any[]) => ChainHelperBase;2681export type UniqueHelperConstructor = new(...args: any[]) => UniqueHelper;26822683export class UniqueHelper extends ChainHelperBase {2684  balance: BalanceGroup<UniqueHelper>;2685  collection: CollectionGroup;2686  nft: NFTGroup;2687  rft: RFTGroup;2688  ft: FTGroup;2689  staking: StakingGroup;2690  scheduler: SchedulerGroup;2691  foreignAssets: ForeignAssetsGroup;2692  xcm: XcmGroup<UniqueHelper>;2693  xTokens: XTokensGroup<UniqueHelper>;2694  tokens: TokensGroup<UniqueHelper>;26952696  constructor(logger?: ILogger, options: {[key: string]: any} = {}) {2697    super(logger, options.helperBase ?? UniqueHelper);26982699    this.balance = new BalanceGroup(this);2700    this.collection = new CollectionGroup(this);2701    this.nft = new NFTGroup(this);2702    this.rft = new RFTGroup(this);2703    this.ft = new FTGroup(this);2704    this.staking = new StakingGroup(this);2705    this.scheduler = new SchedulerGroup(this);2706    this.foreignAssets = new ForeignAssetsGroup(this);2707    this.xcm = new XcmGroup(this, 'polkadotXcm');2708    this.xTokens = new XTokensGroup(this);2709    this.tokens = new TokensGroup(this);2710  }27112712  getSudo<T extends UniqueHelper>() {2713    // eslint-disable-next-line @typescript-eslint/naming-convention2714    const SudoHelperType = SudoHelper(this.helperBase);2715    return this.clone(SudoHelperType) as T;2716  }2717}27182719export class XcmChainHelper extends ChainHelperBase {2720  async connect(wsEndpoint: string, _listeners?: any): Promise<void> {2721    const wsProvider = new WsProvider(wsEndpoint);2722    this.api = new ApiPromise({2723      provider: wsProvider,2724    });2725    await this.api.isReadyOrError;2726    this.network = await UniqueHelper.detectNetwork(this.api);2727  }2728}27292730export class RelayHelper extends XcmChainHelper {2731  xcm: XcmGroup<RelayHelper>;27322733  constructor(logger?: ILogger, options: {[key: string]: any} = {}) {2734    super(logger, options.helperBase ?? RelayHelper);27352736    this.xcm = new XcmGroup(this, 'xcmPallet');2737  }2738}27392740export class WestmintHelper extends XcmChainHelper {2741  balance: SubstrateBalanceGroup<WestmintHelper>;2742  xcm: XcmGroup<WestmintHelper>;2743  assets: AssetsGroup<WestmintHelper>;2744  xTokens: XTokensGroup<WestmintHelper>;27452746  constructor(logger?: ILogger, options: {[key: string]: any} = {}) {2747    super(logger, options.helperBase ?? WestmintHelper);27482749    this.balance = new SubstrateBalanceGroup(this);2750    this.xcm = new XcmGroup(this, 'polkadotXcm');2751    this.assets = new AssetsGroup(this);2752    this.xTokens = new XTokensGroup(this);2753  }2754}27552756export class MoonbeamHelper extends XcmChainHelper {2757  balance: EthereumBalanceGroup<MoonbeamHelper>;2758  assetManager: MoonbeamAssetManagerGroup;2759  assets: AssetsGroup<MoonbeamHelper>;2760  xTokens: XTokensGroup<MoonbeamHelper>;2761  democracy: MoonbeamDemocracyGroup;2762  collective: {2763    council: MoonbeamCollectiveGroup,2764    techCommittee: MoonbeamCollectiveGroup,2765  };27662767  constructor(logger?: ILogger, options: {[key: string]: any} = {}) {2768    super(logger, options.helperBase ?? MoonbeamHelper);27692770    this.balance = new EthereumBalanceGroup(this);2771    this.assetManager = new MoonbeamAssetManagerGroup(this);2772    this.assets = new AssetsGroup(this);2773    this.xTokens = new XTokensGroup(this);2774    this.democracy = new MoonbeamDemocracyGroup(this);2775    this.collective = {2776      council: new MoonbeamCollectiveGroup(this, 'councilCollective'),2777      techCommittee: new MoonbeamCollectiveGroup(this, 'techCommitteeCollective'),2778    };2779  }2780}27812782export class AcalaHelper extends XcmChainHelper {2783  balance: SubstrateBalanceGroup<AcalaHelper>;2784  assetRegistry: AcalaAssetRegistryGroup;2785  xTokens: XTokensGroup<AcalaHelper>;2786  tokens: TokensGroup<AcalaHelper>;27872788  constructor(logger?: ILogger, options: {[key: string]: any} = {}) {2789    super(logger, options.helperBase ?? AcalaHelper);27902791    this.balance = new SubstrateBalanceGroup(this);2792    this.assetRegistry = new AcalaAssetRegistryGroup(this);2793    this.xTokens = new XTokensGroup(this);2794    this.tokens = new TokensGroup(this);2795  }27962797  getSudo<T extends AcalaHelper>() {2798    // eslint-disable-next-line @typescript-eslint/naming-convention2799    const SudoHelperType = SudoHelper(this.helperBase);2800    return this.clone(SudoHelperType) as T;2801  }2802}28032804// eslint-disable-next-line @typescript-eslint/naming-convention2805function ScheduledUniqueHelper<T extends UniqueHelperConstructor>(Base: T) {2806  return class extends Base {2807    scheduleFn: 'scheduleNamed' | 'scheduleNamedAfter';2808    scheduledId: string;2809    blocksNum: number;2810    options: ISchedulerOptions;28112812    constructor(...args: any[]) {2813      const logger = args[0] as ILogger;2814      const options = args[1] as {2815        scheduleFn: 'scheduleNamed' | 'scheduleNamedAfter',2816        scheduledId: string,2817        blocksNum: number,2818        options: ISchedulerOptions2819      };28202821      super(logger);28222823      this.scheduleFn = options.scheduleFn;2824      this.scheduledId = options.scheduledId;2825      this.blocksNum = options.blocksNum;2826      this.options = options.options;2827    }28282829    executeExtrinsic(sender: IKeyringPair, scheduledExtrinsic: string, scheduledParams: any[], expectSuccess?: boolean): Promise<ITransactionResult> {2830      const scheduledTx = this.constructApiCall(scheduledExtrinsic, scheduledParams);2831      const extrinsic = 'api.tx.scheduler.' +  this.scheduleFn;28322833      return super.executeExtrinsic(2834        sender,2835        extrinsic,2836        [2837          this.scheduledId,2838          this.blocksNum,2839          this.options.periodic ? [this.options.periodic.period, this.options.periodic.repetitions] : null,2840          this.options.priority ?? null,2841          scheduledTx,2842        ],2843        expectSuccess,2844      );2845    }2846  };2847}28482849// eslint-disable-next-line @typescript-eslint/naming-convention2850function SudoHelper<T extends ChainHelperBaseConstructor>(Base: T) {2851  return class extends Base {2852    constructor(...args: any[]) {2853      super(...args);2854    }28552856    executeExtrinsic (2857      sender: IKeyringPair,2858      extrinsic: string,2859      params: any[],2860      expectSuccess?: boolean,2861    ): Promise<ITransactionResult> {2862      const call = this.constructApiCall(extrinsic, params);2863      return super.executeExtrinsic(2864        sender,2865        'api.tx.sudo.sudo',2866        [call],2867        expectSuccess,2868      );2869    }2870  };2871}28722873export class UniqueBaseCollection {2874  helper: UniqueHelper;2875  collectionId: number;28762877  constructor(collectionId: number, uniqueHelper: UniqueHelper) {2878    this.collectionId = collectionId;2879    this.helper = uniqueHelper;2880  }28812882  async getData() {2883    return await this.helper.collection.getData(this.collectionId);2884  }28852886  async getLastTokenId() {2887    return await this.helper.collection.getLastTokenId(this.collectionId);2888  }28892890  async doesTokenExist(tokenId: number) {2891    return await this.helper.collection.doesTokenExist(this.collectionId, tokenId);2892  }28932894  async getAdmins() {2895    return await this.helper.collection.getAdmins(this.collectionId);2896  }28972898  async getAllowList() {2899    return await this.helper.collection.getAllowList(this.collectionId);2900  }29012902  async getEffectiveLimits() {2903    return await this.helper.collection.getEffectiveLimits(this.collectionId);2904  }29052906  async getProperties(propertyKeys?: string[] | null) {2907    return await this.helper.collection.getProperties(this.collectionId, propertyKeys);2908  }29092910  async getTokenNextSponsored(tokenId: number, addressObj: ICrossAccountId) {2911    return await this.helper.collection.getTokenNextSponsored(this.collectionId, tokenId, addressObj);2912  }29132914  async getOptions() {2915    return await this.helper.collection.getCollectionOptions(this.collectionId);2916  }29172918  async setSponsor(signer: TSigner, sponsorAddress: TSubstrateAccount) {2919    return await this.helper.collection.setSponsor(signer, this.collectionId, sponsorAddress);2920  }29212922  async confirmSponsorship(signer: TSigner) {2923    return await this.helper.collection.confirmSponsorship(signer, this.collectionId);2924  }29252926  async removeSponsor(signer: TSigner) {2927    return await this.helper.collection.removeSponsor(signer, this.collectionId);2928  }29292930  async setLimits(signer: TSigner, limits: ICollectionLimits) {2931    return await this.helper.collection.setLimits(signer, this.collectionId, limits);2932  }29332934  async changeOwner(signer: TSigner, ownerAddress: TSubstrateAccount) {2935    return await this.helper.collection.changeOwner(signer, this.collectionId, ownerAddress);2936  }29372938  async addAdmin(signer: TSigner, adminAddressObj: ICrossAccountId) {2939    return await this.helper.collection.addAdmin(signer, this.collectionId, adminAddressObj);2940  }29412942  async addToAllowList(signer: TSigner, addressObj: ICrossAccountId) {2943    return await this.helper.collection.addToAllowList(signer, this.collectionId, addressObj);2944  }29452946  async removeFromAllowList(signer: TSigner, addressObj: ICrossAccountId) {2947    return await this.helper.collection.removeFromAllowList(signer, this.collectionId, addressObj);2948  }29492950  async removeAdmin(signer: TSigner, adminAddressObj: ICrossAccountId) {2951    return await this.helper.collection.removeAdmin(signer, this.collectionId, adminAddressObj);2952  }29532954  async setProperties(signer: TSigner, properties: IProperty[]) {2955    return await this.helper.collection.setProperties(signer, this.collectionId, properties);2956  }29572958  async deleteProperties(signer: TSigner, propertyKeys: string[]) {2959    return await this.helper.collection.deleteProperties(signer, this.collectionId, propertyKeys);2960  }29612962  async setPermissions(signer: TSigner, permissions: ICollectionPermissions) {2963    return await this.helper.collection.setPermissions(signer, this.collectionId, permissions);2964  }29652966  async enableNesting(signer: TSigner, permissions: INestingPermissions) {2967    return await this.helper.collection.enableNesting(signer, this.collectionId, permissions);2968  }29692970  async disableNesting(signer: TSigner) {2971    return await this.helper.collection.disableNesting(signer, this.collectionId);2972  }29732974  async burn(signer: TSigner) {2975    return await this.helper.collection.burn(signer, this.collectionId);2976  }29772978  scheduleAt<T extends UniqueHelper>(2979    scheduledId: string,2980    executionBlockNumber: number,2981    options: ISchedulerOptions = {},2982  ) {2983    const scheduledHelper = this.helper.scheduler.scheduleAt<T>(scheduledId, executionBlockNumber, options);2984    return new UniqueBaseCollection(this.collectionId, scheduledHelper);2985  }29862987  scheduleAfter<T extends UniqueHelper>(2988    scheduledId: string,2989    blocksBeforeExecution: number,2990    options: ISchedulerOptions = {},2991  ) {2992    const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);2993    return new UniqueBaseCollection(this.collectionId, scheduledHelper);2994  }29952996  getSudo<T extends UniqueHelper>() {2997    return new UniqueBaseCollection(this.collectionId, this.helper.getSudo<T>());2998  }2999}300030013002export class UniqueNFTCollection extends UniqueBaseCollection {3003  getTokenObject(tokenId: number) {3004    return new UniqueNFToken(tokenId, this);3005  }30063007  async getTokensByAddress(addressObj: ICrossAccountId) {3008    return await this.helper.nft.getTokensByAddress(this.collectionId, addressObj);3009  }30103011  async getToken(tokenId: number, blockHashAt?: string) {3012    return await this.helper.nft.getToken(this.collectionId, tokenId, [], blockHashAt);3013  }30143015  async getTokenOwner(tokenId: number, blockHashAt?: string) {3016    return await this.helper.nft.getTokenOwner(this.collectionId, tokenId, blockHashAt);3017  }30183019  async getTokenTopmostOwner(tokenId: number, blockHashAt?: string) {3020    return await this.helper.nft.getTokenTopmostOwner(this.collectionId, tokenId, blockHashAt);3021  }30223023  async getTokenChildren(tokenId: number, blockHashAt?: string) {3024    return await this.helper.nft.getTokenChildren(this.collectionId, tokenId, blockHashAt);3025  }30263027  async getPropertyPermissions(propertyKeys: string[] | null = null) {3028    return await this.helper.nft.getPropertyPermissions(this.collectionId, propertyKeys);3029  }30303031  async getTokenProperties(tokenId: number, propertyKeys?: string[] | null) {3032    return await this.helper.nft.getTokenProperties(this.collectionId, tokenId, propertyKeys);3033  }30343035  async transferToken(signer: TSigner, tokenId: number, addressObj: ICrossAccountId) {3036    return await this.helper.nft.transferToken(signer, this.collectionId, tokenId, addressObj);3037  }30383039  async transferTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3040    return await this.helper.nft.transferTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, toAddressObj);3041  }30423043  async approveToken(signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId) {3044    return await this.helper.nft.approveToken(signer, this.collectionId, tokenId, toAddressObj);3045  }30463047  async isTokenApproved(tokenId: number, toAddressObj: ICrossAccountId) {3048    return await this.helper.nft.isTokenApproved(this.collectionId, tokenId, toAddressObj);3049  }30503051  async mintToken(signer: TSigner, owner: ICrossAccountId = {Substrate: signer.address}, properties?: IProperty[]) {3052    return await this.helper.nft.mintToken(signer, {collectionId: this.collectionId, owner, properties});3053  }30543055  async mintMultipleTokens(signer: TSigner, tokens: {owner: ICrossAccountId, properties?: IProperty[]}[]) {3056    return await this.helper.nft.mintMultipleTokens(signer, this.collectionId, tokens);3057  }30583059  async burnToken(signer: TSigner, tokenId: number) {3060    return await this.helper.nft.burnToken(signer, this.collectionId, tokenId);3061  }30623063  async burnTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId) {3064    return await this.helper.nft.burnTokenFrom(signer, this.collectionId, tokenId, fromAddressObj);3065  }30663067  async setTokenProperties(signer: TSigner, tokenId: number, properties: IProperty[]) {3068    return await this.helper.nft.setTokenProperties(signer, this.collectionId, tokenId, properties);3069  }30703071  async deleteTokenProperties(signer: TSigner, tokenId: number, propertyKeys: string[]) {3072    return await this.helper.nft.deleteTokenProperties(signer, this.collectionId, tokenId, propertyKeys);3073  }30743075  async setTokenPropertyPermissions(signer: TSigner, permissions: ITokenPropertyPermission[]) {3076    return await this.helper.nft.setTokenPropertyPermissions(signer, this.collectionId, permissions);3077  }30783079  async nestToken(signer: TSigner, tokenId: number, toTokenObj: IToken) {3080    return await this.helper.nft.nestToken(signer, {collectionId: this.collectionId, tokenId}, toTokenObj);3081  }30823083  async unnestToken(signer: TSigner, tokenId: number, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {3084    return await this.helper.nft.unnestToken(signer, {collectionId: this.collectionId, tokenId}, fromTokenObj, toAddressObj);3085  }30863087  scheduleAt<T extends UniqueHelper>(3088    scheduledId: string,3089    executionBlockNumber: number,3090    options: ISchedulerOptions = {},3091  ) {3092    const scheduledHelper = this.helper.scheduler.scheduleAt<T>(scheduledId, executionBlockNumber, options);3093    return new UniqueNFTCollection(this.collectionId, scheduledHelper);3094  }30953096  scheduleAfter<T extends UniqueHelper>(3097    scheduledId: string,3098    blocksBeforeExecution: number,3099    options: ISchedulerOptions = {},3100  ) {3101    const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3102    return new UniqueNFTCollection(this.collectionId, scheduledHelper);3103  }31043105  getSudo<T extends UniqueHelper>() {3106    return new UniqueNFTCollection(this.collectionId, this.helper.getSudo<T>());3107  }3108}310931103111export class UniqueRFTCollection extends UniqueBaseCollection {3112  getTokenObject(tokenId: number) {3113    return new UniqueRFToken(tokenId, this);3114  }31153116  async getToken(tokenId: number, blockHashAt?: string) {3117    return await this.helper.rft.getToken(this.collectionId, tokenId, [], blockHashAt);3118  }31193120  async getTokensByAddress(addressObj: ICrossAccountId) {3121    return await this.helper.rft.getTokensByAddress(this.collectionId, addressObj);3122  }31233124  async getTop10TokenOwners(tokenId: number) {3125    return await this.helper.rft.getTokenTop10Owners(this.collectionId, tokenId);3126  }31273128  async getTokenBalance(tokenId: number, addressObj: ICrossAccountId) {3129    return await this.helper.rft.getTokenBalance(this.collectionId, tokenId, addressObj);3130  }31313132  async getTokenTotalPieces(tokenId: number) {3133    return await this.helper.rft.getTokenTotalPieces(this.collectionId, tokenId);3134  }31353136  async getTokenApprovedPieces(tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3137    return await this.helper.rft.getTokenApprovedPieces(this.collectionId, tokenId, toAddressObj, fromAddressObj);3138  }31393140  async getPropertyPermissions(propertyKeys: string[] | null = null) {3141    return await this.helper.rft.getPropertyPermissions(this.collectionId, propertyKeys);3142  }31433144  async getTokenProperties(tokenId: number, propertyKeys?: string[] | null) {3145    return await this.helper.rft.getTokenProperties(this.collectionId, tokenId, propertyKeys);3146  }31473148  async transferToken(signer: TSigner, tokenId: number, addressObj: ICrossAccountId, amount=1n) {3149    return await this.helper.rft.transferToken(signer, this.collectionId, tokenId, addressObj, amount);3150  }31513152  async transferTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n) {3153    return await this.helper.rft.transferTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, toAddressObj, amount);3154  }31553156  async approveToken(signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId, amount=1n) {3157    return await this.helper.rft.approveToken(signer, this.collectionId, tokenId, toAddressObj, amount);3158  }31593160  async repartitionToken(signer: TSigner, tokenId: number, amount: bigint) {3161    return await this.helper.rft.repartitionToken(signer, this.collectionId, tokenId, amount);3162  }31633164  async mintToken(signer: TSigner, pieces=1n, owner: ICrossAccountId = {Substrate: signer.address}, properties?: IProperty[]) {3165    return await this.helper.rft.mintToken(signer, {collectionId: this.collectionId, owner, pieces, properties});3166  }31673168  async mintMultipleTokens(signer: TSigner, tokens: {pieces: bigint, owner: ICrossAccountId, properties?: IProperty[]}[]) {3169    return await this.helper.rft.mintMultipleTokens(signer, this.collectionId, tokens);3170  }31713172  async burnToken(signer: TSigner, tokenId: number, amount=1n) {3173    return await this.helper.rft.burnToken(signer, this.collectionId, tokenId, amount);3174  }31753176  async burnTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId,  amount=1n) {3177    return await this.helper.rft.burnTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, amount);3178  }31793180  async setTokenProperties(signer: TSigner, tokenId: number, properties: IProperty[]) {3181    return await this.helper.rft.setTokenProperties(signer, this.collectionId, tokenId, properties);3182  }31833184  async deleteTokenProperties(signer: TSigner, tokenId: number, propertyKeys: string[]) {3185    return await this.helper.rft.deleteTokenProperties(signer, this.collectionId, tokenId, propertyKeys);3186  }31873188  async setTokenPropertyPermissions(signer: TSigner, permissions: ITokenPropertyPermission[]) {3189    return await this.helper.rft.setTokenPropertyPermissions(signer, this.collectionId, permissions);3190  }31913192  scheduleAt<T extends UniqueHelper>(3193    scheduledId: string,3194    executionBlockNumber: number,3195    options: ISchedulerOptions = {},3196  ) {3197    const scheduledHelper = this.helper.scheduler.scheduleAt<T>(scheduledId, executionBlockNumber, options);3198    return new UniqueRFTCollection(this.collectionId, scheduledHelper);3199  }32003201  scheduleAfter<T extends UniqueHelper>(3202    scheduledId: string,3203    blocksBeforeExecution: number,3204    options: ISchedulerOptions = {},3205  ) {3206    const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3207    return new UniqueRFTCollection(this.collectionId, scheduledHelper);3208  }32093210  getSudo<T extends UniqueHelper>() {3211    return new UniqueRFTCollection(this.collectionId, this.helper.getSudo<T>());3212  }3213}321432153216export class UniqueFTCollection extends UniqueBaseCollection {3217  async getBalance(addressObj: ICrossAccountId) {3218    return await this.helper.ft.getBalance(this.collectionId, addressObj);3219  }32203221  async getTotalPieces() {3222    return await this.helper.ft.getTotalPieces(this.collectionId);3223  }32243225  async getApprovedTokens(fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3226    return await this.helper.ft.getApprovedTokens(this.collectionId, fromAddressObj, toAddressObj);3227  }32283229  async getTop10Owners() {3230    return await this.helper.ft.getTop10Owners(this.collectionId);3231  }32323233  async mint(signer: TSigner, amount=1n, owner: ICrossAccountId = {Substrate: signer.address}) {3234    return await this.helper.ft.mintTokens(signer, this.collectionId, amount, owner);3235  }32363237  async mintWithOneOwner(signer: TSigner, tokens: {value: bigint}[], owner: ICrossAccountId = {Substrate: signer.address}) {3238    return await this.helper.ft.mintMultipleTokensWithOneOwner(signer, this.collectionId, tokens, owner);3239  }32403241  async transfer(signer: TSigner, toAddressObj: ICrossAccountId, amount=1n) {3242    return await this.helper.ft.transfer(signer, this.collectionId, toAddressObj, amount);3243  }32443245  async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n) {3246    return await this.helper.ft.transferFrom(signer, this.collectionId, fromAddressObj, toAddressObj, amount);3247  }32483249  async burnTokens(signer: TSigner, amount=1n) {3250    return await this.helper.ft.burnTokens(signer, this.collectionId, amount);3251  }32523253  async burnTokensFrom(signer: TSigner, fromAddressObj: ICrossAccountId, amount=1n) {3254    return await this.helper.ft.burnTokensFrom(signer, this.collectionId, fromAddressObj, amount);3255  }32563257  async approveTokens(signer: TSigner, toAddressObj: ICrossAccountId, amount=1n) {3258    return await this.helper.ft.approveTokens(signer, this.collectionId, toAddressObj, amount);3259  }32603261  scheduleAt<T extends UniqueHelper>(3262    scheduledId: string,3263    executionBlockNumber: number,3264    options: ISchedulerOptions = {},3265  ) {3266    const scheduledHelper = this.helper.scheduler.scheduleAt<T>(scheduledId, executionBlockNumber, options);3267    return new UniqueFTCollection(this.collectionId, scheduledHelper);3268  }32693270  scheduleAfter<T extends UniqueHelper>(3271    scheduledId: string,3272    blocksBeforeExecution: number,3273    options: ISchedulerOptions = {},3274  ) {3275    const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3276    return new UniqueFTCollection(this.collectionId, scheduledHelper);3277  }32783279  getSudo<T extends UniqueHelper>() {3280    return new UniqueFTCollection(this.collectionId, this.helper.getSudo<T>());3281  }3282}328332843285export class UniqueBaseToken {3286  collection: UniqueNFTCollection | UniqueRFTCollection;3287  collectionId: number;3288  tokenId: number;32893290  constructor(tokenId: number, collection: UniqueNFTCollection | UniqueRFTCollection) {3291    this.collection = collection;3292    this.collectionId = collection.collectionId;3293    this.tokenId = tokenId;3294  }32953296  async getNextSponsored(addressObj: ICrossAccountId) {3297    return await this.collection.getTokenNextSponsored(this.tokenId, addressObj);3298  }32993300  async getProperties(propertyKeys?: string[] | null) {3301    return await this.collection.getTokenProperties(this.tokenId, propertyKeys);3302  }33033304  async setProperties(signer: TSigner, properties: IProperty[]) {3305    return await this.collection.setTokenProperties(signer, this.tokenId, properties);3306  }33073308  async deleteProperties(signer: TSigner, propertyKeys: string[]) {3309    return await this.collection.deleteTokenProperties(signer, this.tokenId, propertyKeys);3310  }33113312  async doesExist() {3313    return await this.collection.doesTokenExist(this.tokenId);3314  }33153316  nestingAccount() {3317    return this.collection.helper.util.getTokenAccount(this);3318  }33193320  scheduleAt<T extends UniqueHelper>(3321    scheduledId: string,3322    executionBlockNumber: number,3323    options: ISchedulerOptions = {},3324  ) {3325    const scheduledCollection = this.collection.scheduleAt<T>(scheduledId, executionBlockNumber, options);3326    return new UniqueBaseToken(this.tokenId, scheduledCollection);3327  }33283329  scheduleAfter<T extends UniqueHelper>(3330    scheduledId: string,3331    blocksBeforeExecution: number,3332    options: ISchedulerOptions = {},3333  ) {3334    const scheduledCollection = this.collection.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3335    return new UniqueBaseToken(this.tokenId, scheduledCollection);3336  }33373338  getSudo<T extends UniqueHelper>() {3339    return new UniqueBaseToken(this.tokenId, this.collection.getSudo<T>());3340  }3341}334233433344export class UniqueNFToken extends UniqueBaseToken {3345  collection: UniqueNFTCollection;33463347  constructor(tokenId: number, collection: UniqueNFTCollection) {3348    super(tokenId, collection);3349    this.collection = collection;3350  }33513352  async getData(blockHashAt?: string) {3353    return await this.collection.getToken(this.tokenId, blockHashAt);3354  }33553356  async getOwner(blockHashAt?: string) {3357    return await this.collection.getTokenOwner(this.tokenId, blockHashAt);3358  }33593360  async getTopmostOwner(blockHashAt?: string) {3361    return await this.collection.getTokenTopmostOwner(this.tokenId, blockHashAt);3362  }33633364  async getChildren(blockHashAt?: string) {3365    return await this.collection.getTokenChildren(this.tokenId, blockHashAt);3366  }33673368  async nest(signer: TSigner, toTokenObj: IToken) {3369    return await this.collection.nestToken(signer, this.tokenId, toTokenObj);3370  }33713372  async unnest(signer: TSigner, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {3373    return await this.collection.unnestToken(signer, this.tokenId, fromTokenObj, toAddressObj);3374  }33753376  async transfer(signer: TSigner, addressObj: ICrossAccountId) {3377    return await this.collection.transferToken(signer, this.tokenId, addressObj);3378  }33793380  async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3381    return await this.collection.transferTokenFrom(signer, this.tokenId, fromAddressObj, toAddressObj);3382  }33833384  async approve(signer: TSigner, toAddressObj: ICrossAccountId) {3385    return await this.collection.approveToken(signer, this.tokenId, toAddressObj);3386  }33873388  async isApproved(toAddressObj: ICrossAccountId) {3389    return await this.collection.isTokenApproved(this.tokenId, toAddressObj);3390  }33913392  async burn(signer: TSigner) {3393    return await this.collection.burnToken(signer, this.tokenId);3394  }33953396  async burnFrom(signer: TSigner, fromAddressObj: ICrossAccountId) {3397    return await this.collection.burnTokenFrom(signer, this.tokenId, fromAddressObj);3398  }33993400  scheduleAt<T extends UniqueHelper>(3401    scheduledId: string,3402    executionBlockNumber: number,3403    options: ISchedulerOptions = {},3404  ) {3405    const scheduledCollection = this.collection.scheduleAt<T>(scheduledId, executionBlockNumber, options);3406    return new UniqueNFToken(this.tokenId, scheduledCollection);3407  }34083409  scheduleAfter<T extends UniqueHelper>(3410    scheduledId: string,3411    blocksBeforeExecution: number,3412    options: ISchedulerOptions = {},3413  ) {3414    const scheduledCollection = this.collection.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3415    return new UniqueNFToken(this.tokenId, scheduledCollection);3416  }34173418  getSudo<T extends UniqueHelper>() {3419    return new UniqueNFToken(this.tokenId, this.collection.getSudo<T>());3420  }3421}34223423export class UniqueRFToken extends UniqueBaseToken {3424  collection: UniqueRFTCollection;34253426  constructor(tokenId: number, collection: UniqueRFTCollection) {3427    super(tokenId, collection);3428    this.collection = collection;3429  }34303431  async getData(blockHashAt?: string) {3432    return await this.collection.getToken(this.tokenId, blockHashAt);3433  }34343435  async getTop10Owners() {3436    return await this.collection.getTop10TokenOwners(this.tokenId);3437  }34383439  async getBalance(addressObj: ICrossAccountId) {3440    return await this.collection.getTokenBalance(this.tokenId, addressObj);3441  }34423443  async getTotalPieces() {3444    return await this.collection.getTokenTotalPieces(this.tokenId);3445  }34463447  async getApprovedPieces(fromAddressObj: ICrossAccountId, toAccountObj: ICrossAccountId) {3448    return await this.collection.getTokenApprovedPieces(this.tokenId, fromAddressObj, toAccountObj);3449  }34503451  async transfer(signer: TSigner, addressObj: ICrossAccountId, amount=1n) {3452    return await this.collection.transferToken(signer, this.tokenId, addressObj, amount);3453  }34543455  async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n) {3456    return await this.collection.transferTokenFrom(signer, this.tokenId, fromAddressObj, toAddressObj, amount);3457  }34583459  async approve(signer: TSigner, toAddressObj: ICrossAccountId, amount=1n) {3460    return await this.collection.approveToken(signer, this.tokenId, toAddressObj, amount);3461  }34623463  async repartition(signer: TSigner, amount: bigint) {3464    return await this.collection.repartitionToken(signer, this.tokenId, amount);3465  }34663467  async burn(signer: TSigner, amount=1n) {3468    return await this.collection.burnToken(signer, this.tokenId, amount);3469  }34703471  async burnFrom(signer: TSigner, fromAddressObj: ICrossAccountId, amount=1n) {3472    return await this.collection.burnTokenFrom(signer, this.tokenId, fromAddressObj, amount);3473  }34743475  scheduleAt<T extends UniqueHelper>(3476    scheduledId: string,3477    executionBlockNumber: number,3478    options: ISchedulerOptions = {},3479  ) {3480    const scheduledCollection = this.collection.scheduleAt<T>(scheduledId, executionBlockNumber, options);3481    return new UniqueRFToken(this.tokenId, scheduledCollection);3482  }34833484  scheduleAfter<T extends UniqueHelper>(3485    scheduledId: string,3486    blocksBeforeExecution: number,3487    options: ISchedulerOptions = {},3488  ) {3489    const scheduledCollection = this.collection.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3490    return new UniqueRFToken(this.tokenId, scheduledCollection);3491  }34923493  getSudo<T extends UniqueHelper>() {3494    return new UniqueRFToken(this.tokenId, this.collection.getSudo<T>());3495  }3496}

1// Copyright 2019-2022 Unique Network (Gibraltar) Ltd.2// SPDX-License-Identifier: Apache-2.034/* eslint-disable @typescript-eslint/no-var-requires */5/* eslint-disable function-call-argument-newline */6/* eslint-disable no-prototype-builtins */78import {ApiPromise, WsProvider, Keyring} from '@polkadot/api';9import {ApiInterfaceEvents, SignerOptions} from '@polkadot/api/types';10import {encodeAddress, decodeAddress, keccakAsHex, evmToAddress, addressToEvm, base58Encode, blake2AsU8a} from '@polkadot/util-crypto';11import {IKeyringPair} from '@polkadot/types/types';12import {hexToU8a} from '@polkadot/util/hex';13import {u8aConcat} from '@polkadot/util/u8a';14import {15  IApiListeners,16  IBlock,17  IEvent,18  IChainProperties,19  ICollectionCreationOptions,20  ICollectionLimits,21  ICollectionPermissions,22  ICrossAccountId,23  ICrossAccountIdLower,24  ILogger,25  INestingPermissions,26  IProperty,27  IStakingInfo,28  ISchedulerOptions,29  ISubstrateBalance,30  IToken,31  ITokenPropertyPermission,32  ITransactionResult,33  IUniqueHelperLog,34  TApiAllowedListeners,35  TEthereumAccount,36  TSigner,37  TSubstrateAccount,38  TNetworks,39  IForeignAssetMetadata,40  AcalaAssetMetadata,41  MoonbeamAssetInfo,42  DemocracyStandardAccountVote,43} from './types';44import {RuntimeDispatchInfo} from '@polkadot/types/interfaces';4546export class CrossAccountId implements ICrossAccountId {47  Substrate?: TSubstrateAccount;48  Ethereum?: TEthereumAccount;4950  constructor(account: ICrossAccountId) {51    if (account.Substrate) this.Substrate = account.Substrate;52    if (account.Ethereum) this.Ethereum = account.Ethereum;53  }5455  static fromKeyring(account: IKeyringPair, domain: 'Substrate' | 'Ethereum' = 'Substrate') {56    switch (domain) {57      case 'Substrate': return new CrossAccountId({Substrate: account.address});58      case 'Ethereum': return new CrossAccountId({Substrate: account.address}).toEthereum();59    }60  }6162  static fromLowerCaseKeys(address: ICrossAccountIdLower): CrossAccountId {63    return new CrossAccountId({Substrate: address.substrate, Ethereum: address.ethereum});64  }6566  static normalizeSubstrateAddress(address: TSubstrateAccount, ss58Format = 42): TSubstrateAccount {67    return encodeAddress(decodeAddress(address), ss58Format);68  }6970  static withNormalizedSubstrate(address: TSubstrateAccount, ss58Format = 42): CrossAccountId {71    return new CrossAccountId({Substrate: CrossAccountId.normalizeSubstrateAddress(address, ss58Format)});72  }7374  withNormalizedSubstrate(ss58Format = 42): CrossAccountId {75    if (this.Substrate) return CrossAccountId.withNormalizedSubstrate(this.Substrate, ss58Format);76    return this;77  }7879  static translateSubToEth(address: TSubstrateAccount): TEthereumAccount {80    return nesting.toChecksumAddress('0x' + Array.from(addressToEvm(address), i => i.toString(16).padStart(2, '0')).join(''));81  }8283  toEthereum(): CrossAccountId {84    if (this.Substrate) return new CrossAccountId({Ethereum: CrossAccountId.translateSubToEth(this.Substrate)});85    return this;86  }8788  static translateEthToSub(address: TEthereumAccount, ss58Format?: number): TSubstrateAccount {89    return evmToAddress(address, ss58Format);90  }9192  toSubstrate(ss58Format?: number): CrossAccountId {93    if (this.Ethereum) return new CrossAccountId({Substrate: CrossAccountId.translateEthToSub(this.Ethereum, ss58Format)});94    return this;95  }9697  toLowerCase(): CrossAccountId {98    if (this.Substrate) this.Substrate = this.Substrate.toLowerCase();99    if (this.Ethereum) this.Ethereum = this.Ethereum.toLowerCase();100    return this;101  }102}103104const nesting = {105  toChecksumAddress(address: string): string {106    if (typeof address === 'undefined') return '';107108    if(!/^(0x)?[0-9a-f]{40}$/i.test(address)) throw new Error(`Given address "${address}" is not a valid Ethereum address.`);109110    address = address.toLowerCase().replace(/^0x/i,'');111    const addressHash = keccakAsHex(address).replace(/^0x/i,'');112    const checksumAddress = ['0x'];113114    for (let i = 0; i < address.length; i++) {115      // If ith character is 8 to f then make it uppercase116      if (parseInt(addressHash[i], 16) > 7) {117        checksumAddress.push(address[i].toUpperCase());118      } else {119        checksumAddress.push(address[i]);120      }121    }122    return checksumAddress.join('');123  },124  tokenIdToAddress(collectionId: number, tokenId: number) {125    return this.toChecksumAddress(`0xf8238ccfff8ed887463fd5e0${collectionId.toString(16).padStart(8, '0')}${tokenId.toString(16).padStart(8, '0')}`);126  },127};128129class UniqueUtil {130  static transactionStatus = {131    NOT_READY: 'NotReady',132    FAIL: 'Fail',133    SUCCESS: 'Success',134  };135136  static chainLogType = {137    EXTRINSIC: 'extrinsic',138    RPC: 'rpc',139  };140141  static getTokenAccount(token: IToken): CrossAccountId {142    return new CrossAccountId({Ethereum: this.getTokenAddress(token)});143  }144145  static getTokenAddress(token: IToken): string {146    return nesting.tokenIdToAddress(token.collectionId, token.tokenId);147  }148149  static getDefaultLogger(): ILogger {150    return {151      log(msg: any, level = 'INFO') {152        console[level.toLocaleLowerCase() === 'error' ? 'error' : 'log'](...(Array.isArray(msg) ? msg : [msg]));153      },154      level: {155        ERROR: 'ERROR',156        WARNING: 'WARNING',157        INFO: 'INFO',158      },159    };160  }161162  static vec2str(arr: string[] | number[]) {163    return arr.map(x => String.fromCharCode(parseInt(x.toString()))).join('');164  }165166  static str2vec(string: string) {167    if (typeof string !== 'string') return string;168    return Array.from(string).map(x => x.charCodeAt(0));169  }170171  static fromSeed(seed: string, ss58Format = 42) {172    const keyring = new Keyring({type: 'sr25519', ss58Format});173    return keyring.addFromUri(seed);174  }175176  static extractCollectionIdFromCreationResult(creationResult: ITransactionResult): number {177    if (creationResult.status !== this.transactionStatus.SUCCESS) {178      throw Error('Unable to create collection!');179    }180181    let collectionId = null;182    creationResult.result.events.forEach(({event: {data, method, section}}) => {183      if ((section === 'common') && (method === 'CollectionCreated')) {184        collectionId = parseInt(data[0].toString(), 10);185      }186    });187188    if (collectionId === null) {189      throw Error('No CollectionCreated event was found!');190    }191192    return collectionId;193  }194195  static extractTokensFromCreationResult(creationResult: ITransactionResult): {196    success: boolean,197    tokens: {collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint}[],198  } {199    if (creationResult.status !== this.transactionStatus.SUCCESS) {200      throw Error('Unable to create tokens!');201    }202    let success = false;203    const tokens = [] as {collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint}[];204    creationResult.result.events.forEach(({event: {data, method, section}}) => {205      if (method === 'ExtrinsicSuccess') {206        success = true;207      } else if ((section === 'common') && (method === 'ItemCreated')) {208        tokens.push({209          collectionId: parseInt(data[0].toString(), 10),210          tokenId: parseInt(data[1].toString(), 10),211          owner: data[2].toHuman(),212          amount: data[3].toBigInt(),213        });214      }215    });216    return {success, tokens};217  }218219  static extractTokensFromBurnResult(burnResult: ITransactionResult): {220    success: boolean,221    tokens: {collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint}[],222  } {223    if (burnResult.status !== this.transactionStatus.SUCCESS) {224      throw Error('Unable to burn tokens!');225    }226    let success = false;227    const tokens = [] as {collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint}[];228    burnResult.result.events.forEach(({event: {data, method, section}}) => {229      if (method === 'ExtrinsicSuccess') {230        success = true;231      } else if ((section === 'common') && (method === 'ItemDestroyed')) {232        tokens.push({233          collectionId: parseInt(data[0].toString(), 10),234          tokenId: parseInt(data[1].toString(), 10),235          owner: data[2].toHuman(),236          amount: data[3].toBigInt(),237        });238      }239    });240    return {success, tokens};241  }242243  static findCollectionInEvents(events: {event: IEvent}[], collectionId: number, expectedSection: string, expectedMethod: string): boolean {244    let eventId = null;245    events.forEach(({event: {data, method, section}}) => {246      if ((section === expectedSection) && (method === expectedMethod)) {247        eventId = parseInt(data[0].toString(), 10);248      }249    });250251    if (eventId === null) {252      throw Error(`No ${expectedMethod} event was found!`);253    }254    return eventId === collectionId;255  }256257  static isTokenTransferSuccess(events: {event: IEvent}[], collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n) {258    const normalizeAddress = (address: string | ICrossAccountId) => {259      if(typeof address === 'string') return address;260      const obj = {} as any;261      Object.keys(address).forEach(k => {262        obj[k.toLocaleLowerCase()] = address[k as 'Substrate' | 'Ethereum'];263      });264      if(obj.substrate) return CrossAccountId.withNormalizedSubstrate(obj.substrate);265      if(obj.ethereum) return CrossAccountId.fromLowerCaseKeys(obj).toLowerCase();266      return address;267    };268    let transfer = {collectionId: null, tokenId: null, from: null, to: null, amount: 1} as any;269    events.forEach(({event: {data, method, section}}) => {270      if ((section === 'common') && (method === 'Transfer')) {271        const hData = (data as any).toJSON();272        transfer = {273          collectionId: hData[0],274          tokenId: hData[1],275          from: normalizeAddress(hData[2]),276          to: normalizeAddress(hData[3]),277          amount: BigInt(hData[4]),278        };279      }280    });281    let isSuccess = parseInt(collectionId.toString()) === transfer.collectionId && parseInt(tokenId.toString()) === transfer.tokenId;282    isSuccess = isSuccess && JSON.stringify(normalizeAddress(fromAddressObj)) === JSON.stringify(transfer.from);283    isSuccess = isSuccess && JSON.stringify(normalizeAddress(toAddressObj)) === JSON.stringify(transfer.to);284    isSuccess = isSuccess && amount === transfer.amount;285    return isSuccess;286  }287288  static bigIntToDecimals(number: bigint, decimals = 18) {289    const numberStr = number.toString();290    const dotPos = numberStr.length - decimals;291292    if (dotPos <= 0) {293      return '0.' + '0'.repeat(Math.abs(dotPos)) + numberStr;294    } else {295      const intPart = numberStr.substring(0, dotPos);296      const fractPart = numberStr.substring(dotPos);297      return intPart + '.' + fractPart;298    }299  }300}301302class UniqueEventHelper {303  private static extractIndex(index: any): [number, number] | string {304    if(index.toRawType() === '[u8;2]') return [index[0], index[1]];305    return index.toJSON();306  }307308  private static extractSub(data: any, subTypes: any): {[key: string]: any} {309    let obj: any = {};310    let index = 0;311312    if (data.entries) {313      for(const [key, value] of data.entries()) {314        obj[key] = this.extractData(value, subTypes[index]);315        index++;316      }317    } else obj = data.toJSON();318319    return obj;320  }321322  private static extractData(data: any, type: any): any {323    if(!type) return data.toHuman();324    if (['u16', 'u32'].indexOf(type.type) > -1) return data.toNumber();325    if (['u64', 'u128', 'u256'].indexOf(type.type) > -1) return data.toBigInt();326    if(type.hasOwnProperty('sub')) return this.extractSub(data, type.sub);327    return data.toHuman();328  }329330  public static extractEvents(events: {event: any, phase: any}[]): IEvent[] {331    const parsedEvents: IEvent[] = [];332333    events.forEach((record) => {334      const {event, phase} = record;335      const types = event.typeDef;336337      const eventData: IEvent = {338        section: event.section.toString(),339        method: event.method.toString(),340        index: this.extractIndex(event.index),341        data: [],342        phase: phase.toJSON(),343      };344345      event.data.forEach((val: any, index: number) => {346        eventData.data.push(this.extractData(val, types[index]));347      });348349      parsedEvents.push(eventData);350    });351352    return parsedEvents;353  }354}355356export class ChainHelperBase {357  helperBase: any;358359  transactionStatus = UniqueUtil.transactionStatus;360  chainLogType = UniqueUtil.chainLogType;361  util: typeof UniqueUtil;362  eventHelper: typeof UniqueEventHelper;363  logger: ILogger;364  api: ApiPromise | null;365  forcedNetwork: TNetworks | null;366  network: TNetworks | null;367  chainLog: IUniqueHelperLog[];368  children: ChainHelperBase[];369  address: AddressGroup;370  chain: ChainGroup;371372  constructor(logger?: ILogger, helperBase?: any) {373    this.helperBase = helperBase;374375    this.util = UniqueUtil;376    this.eventHelper = UniqueEventHelper;377    if (typeof logger == 'undefined') logger = this.util.getDefaultLogger();378    this.logger = logger;379    this.api = null;380    this.forcedNetwork = null;381    this.network = null;382    this.chainLog = [];383    this.children = [];384    this.address = new AddressGroup(this);385    this.chain = new ChainGroup(this);386  }387388  clone(helperCls: ChainHelperBaseConstructor, options: {[key: string]: any} = {}) {389    Object.setPrototypeOf(helperCls.prototype, this);390    const newHelper = new helperCls(this.logger, options);391392    newHelper.api = this.api;393    newHelper.network = this.network;394    newHelper.forceNetwork = this.forceNetwork;395396    this.children.push(newHelper);397398    return newHelper;399  }400401  getApi(): ApiPromise {402    if(this.api === null) throw Error('API not initialized');403    return this.api;404  }405406  clearChainLog(): void {407    this.chainLog = [];408  }409410  forceNetwork(value: TNetworks): void {411    this.forcedNetwork = value;412  }413414  async connect(wsEndpoint: string, listeners?: IApiListeners) {415    if (this.api !== null) throw Error('Already connected');416    const {api, network} = await ChainHelperBase.createConnection(wsEndpoint, listeners, this.forcedNetwork);417    this.api = api;418    this.network = network;419  }420421  async disconnect() {422    for (const child of this.children) {423      child.clearApi();424    }425426    if (this.api === null) return;427    await this.api.disconnect();428    this.clearApi();429  }430431  clearApi() {432    this.api = null;433    this.network = null;434  }435436  static async detectNetwork(api: ApiPromise): Promise<TNetworks> {437    const spec = (await api.query.system.lastRuntimeUpgrade()).toJSON() as any;438    const xcmChains = ['rococo', 'westend', 'westmint', 'acala', 'karura', 'moonbeam', 'moonriver'];439440    if(xcmChains.indexOf(spec.specName) > -1) return spec.specName;441442    if(['quartz', 'unique'].indexOf(spec.specName) > -1) return spec.specName;443    return 'opal';444  }445446  static async detectNetworkByWsEndpoint(wsEndpoint: string): Promise<TNetworks> {447    const api = new ApiPromise({provider: new WsProvider(wsEndpoint)});448    await api.isReady;449450    const network = await this.detectNetwork(api);451452    await api.disconnect();453454    return network;455  }456457  static async createConnection(wsEndpoint: string, listeners?: IApiListeners, network?: TNetworks | null): Promise<{458    api: ApiPromise;459    network: TNetworks;460  }> {461    if(typeof network === 'undefined' || network === null) network = 'opal';462    const supportedRPC = {463      opal: {464        unique: require('@unique-nft/opal-testnet-types/definitions').unique.rpc,465      },466      quartz: {467        unique: require('@unique-nft/quartz-mainnet-types/definitions').unique.rpc,468      },469      unique: {470        unique: require('@unique-nft/unique-mainnet-types/definitions').unique.rpc,471      },472      rococo: {},473      westend: {},474      moonbeam: {},475      moonriver: {},476      acala: {},477      karura: {},478      westmint: {},479    };480    if(!supportedRPC.hasOwnProperty(network)) network = await this.detectNetworkByWsEndpoint(wsEndpoint);481    const rpc = supportedRPC[network];482483    // TODO: investigate how to replace rpc in runtime484    // api._rpcCore.addUserInterfaces(rpc);485486    const api = new ApiPromise({provider: new WsProvider(wsEndpoint), rpc});487488    await api.isReadyOrError;489490    if (typeof listeners === 'undefined') listeners = {};491    for (const event of ['connected', 'disconnected', 'error', 'ready', 'decorated']) {492      if (!listeners.hasOwnProperty(event) || typeof listeners[event as TApiAllowedListeners] === 'undefined') continue;493      api.on(event as ApiInterfaceEvents, listeners[event as TApiAllowedListeners] as (...args: any[]) => any);494    }495496    return {api, network};497  }498499  getTransactionStatus(data: {events: {event: IEvent}[], status: any}) {500    const {events, status} = data;501    if (status.isReady) {502      return this.transactionStatus.NOT_READY;503    }504    if (status.isBroadcast) {505      return this.transactionStatus.NOT_READY;506    }507    if (status.isInBlock || status.isFinalized) {508      const errors = events.filter(e => e.event.method === 'ExtrinsicFailed');509      if (errors.length > 0) {510        return this.transactionStatus.FAIL;511      }512      if (events.filter(e => e.event.method === 'ExtrinsicSuccess').length > 0) {513        return this.transactionStatus.SUCCESS;514      }515    }516517    return this.transactionStatus.FAIL;518  }519520  signTransaction(sender: TSigner, transaction: any, options: Partial<SignerOptions> | null = null, label = 'transaction') {521    const sign = (callback: any) => {522      if(options !== null) return transaction.signAndSend(sender, options, callback);523      return transaction.signAndSend(sender, callback);524    };525    // eslint-disable-next-line no-async-promise-executor526    return new Promise(async (resolve, reject) => {527      try {528        const unsub = await sign((result: any) => {529          const status = this.getTransactionStatus(result);530531          if (status === this.transactionStatus.SUCCESS) {532            this.logger.log(`${label} successful`);533            unsub();534            resolve({result, status});535          } else if (status === this.transactionStatus.FAIL) {536            let moduleError = null;537538            if (result.hasOwnProperty('dispatchError')) {539              const dispatchError = result['dispatchError'];540541              if (dispatchError) {542                if (dispatchError.isModule) {543                  const modErr = dispatchError.asModule;544                  const errorMeta = dispatchError.registry.findMetaError(modErr);545546                  moduleError = `${errorMeta.section}.${errorMeta.name}`;547                } else {548                  moduleError = dispatchError.toHuman();549                }550              } else {551                this.logger.log(result, this.logger.level.ERROR);552              }553            }554555            this.logger.log(`Something went wrong with ${label}. Status: ${status}`, this.logger.level.ERROR);556            unsub();557            reject({status, moduleError, result});558          }559        });560      } catch (e) {561        this.logger.log(e, this.logger.level.ERROR);562        reject(e);563      }564    });565  }566567  async getPaymentInfo(signer: TSigner, tx: any, len: number | null) {568    const api = this.getApi();569    const signingInfo = await api.derive.tx.signingInfo(signer.address);570571    // We need to sign the tx because572    // unsigned transactions does not have an inclusion fee573    tx.sign(signer, {574      blockHash: api.genesisHash,575      genesisHash: api.genesisHash,576      runtimeVersion: api.runtimeVersion,577      nonce: signingInfo.nonce,578    });579580    if (len === null) {581      return (await this.callRpc('api.rpc.payment.queryInfo', [tx.toHex()])) as RuntimeDispatchInfo;582    } else {583      return (await api.call.transactionPaymentApi.queryInfo(tx, len)) as RuntimeDispatchInfo;584    }585  }586587  constructApiCall(apiCall: string, params: any[]) {588    if(!apiCall.startsWith('api.')) throw Error(`Invalid api call: ${apiCall}`);589    let call = this.getApi() as any;590    for(const part of apiCall.slice(4).split('.')) {591      call = call[part];592    }593    return call(...params);594  }595596  async executeExtrinsic(sender: TSigner, extrinsic: string, params: any[], expectSuccess=true, options: Partial<SignerOptions>|null = null/*, failureMessage='expected success'*/) {597    if(this.api === null) throw Error('API not initialized');598    if(!extrinsic.startsWith('api.tx.')) throw Error(`${extrinsic} is not transaction`);599600    const startTime = (new Date()).getTime();601    let result: ITransactionResult;602    let events: IEvent[] = [];603    try {604      result = await this.signTransaction(sender, this.constructApiCall(extrinsic, params), options, extrinsic) as ITransactionResult;605      events = this.eventHelper.extractEvents(result.result.events);606    }607    catch(e) {608      if(!(e as object).hasOwnProperty('status')) throw e;609      result = e as ITransactionResult;610    }611612    const endTime = (new Date()).getTime();613614    const log = {615      executedAt: endTime,616      executionTime: endTime - startTime,617      type: this.chainLogType.EXTRINSIC,618      status: result.status,619      call: extrinsic,620      signer: this.getSignerAddress(sender),621      params,622    } as IUniqueHelperLog;623624    if(result.status !== this.transactionStatus.SUCCESS) {625      if (result.moduleError) log.moduleError = result.moduleError;626      else if (result.result.dispatchError) log.dispatchError = result.result.dispatchError;627    }628    if(events.length > 0) log.events = events;629630    this.chainLog.push(log);631632    if(expectSuccess && result.status !== this.transactionStatus.SUCCESS) {633      if (result.moduleError) throw Error(`${result.moduleError}`);634      else if (result.result.dispatchError) throw Error(JSON.stringify(result.result.dispatchError));635    }636    return result;637  }638639  async callRpc(rpc: string, params?: any[]) {640    if(typeof params === 'undefined') params = [];641    if(this.api === null) throw Error('API not initialized');642    if(!rpc.startsWith('api.rpc.') && !rpc.startsWith('api.query.')) throw Error(`${rpc} is not RPC call`);643644    const startTime = (new Date()).getTime();645    let result;646    let error = null;647    const log = {648      type: this.chainLogType.RPC,649      call: rpc,650      params,651    } as IUniqueHelperLog;652653    try {654      result = await this.constructApiCall(rpc, params);655    }656    catch(e) {657      error = e;658    }659660    const endTime = (new Date()).getTime();661662    log.executedAt = endTime;663    log.status = (error === null ? this.transactionStatus.SUCCESS : this.transactionStatus.FAIL) as 'Fail' | 'Success';664    log.executionTime = endTime - startTime;665666    this.chainLog.push(log);667668    if(error !== null) throw error;669670    return result;671  }672673  getSignerAddress(signer: IKeyringPair | string): string {674    if(typeof signer === 'string') return signer;675    return signer.address;676  }677678  fetchAllPalletNames(): string[] {679    if(this.api === null) throw Error('API not initialized');680    return this.api.runtimeMetadata.asLatest.pallets.map(m => m.name.toString().toLowerCase());681  }682683  fetchMissingPalletNames(requiredPallets: string[]): string[] {684    const palletNames = this.fetchAllPalletNames();685    return requiredPallets.filter(p => !palletNames.includes(p));686  }687}688689690class HelperGroup<T extends ChainHelperBase> {691  helper: T;692693  constructor(uniqueHelper: T) {694    this.helper = uniqueHelper;695  }696}697698699class CollectionGroup extends HelperGroup<UniqueHelper> {700  /**701 * Get number of blocks when sponsored transaction is available.702 *703 * @param collectionId ID of collection704 * @param tokenId ID of token705 * @param addressObj address for which the sponsorship is checked706 * @example await getTokenNextSponsored(1, 2, {Substrate: '5DfhbVfww7ThF8q6f3...'});707 * @returns number of blocks or null if sponsorship hasn't been set708 */709  async getTokenNextSponsored(collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<number | null> {710    return (await this.helper.callRpc('api.rpc.unique.nextSponsored', [collectionId, addressObj, tokenId])).toJSON();711  }712713  /**714   * Get the number of created collections.715   *716   * @returns number of created collections717   */718  async getTotalCount(): Promise<number> {719    return (await this.helper.callRpc('api.rpc.unique.collectionStats')).created.toNumber();720  }721722  /**723   * Get information about the collection with additional data,724   * including the number of tokens it contains, its administrators,725   * the normalized address of the collection's owner, and decoded name and description.726   *727   * @param collectionId ID of collection728   * @example await getData(2)729   * @returns collection information object730   */731  async getData(collectionId: number): Promise<{732    id: number;733    name: string;734    description: string;735    tokensCount: number;736    admins: CrossAccountId[];737    normalizedOwner: TSubstrateAccount;738    raw: any739  } | null> {740    const collection = await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId]);741    const humanCollection = collection.toHuman(), collectionData = {742      id: collectionId, name: null, description: null, tokensCount: 0, admins: [],743      raw: humanCollection,744    } as any, jsonCollection = collection.toJSON();745    if (humanCollection === null) return null;746    collectionData.raw.limits = jsonCollection.limits;747    collectionData.raw.permissions = jsonCollection.permissions;748    collectionData.normalizedOwner = this.helper.address.normalizeSubstrate(collectionData.raw.owner);749    for (const key of ['name', 'description']) {750      collectionData[key] = this.helper.util.vec2str(humanCollection[key]);751    }752753    collectionData.tokensCount = (['RFT', 'NFT'].includes(humanCollection.mode))754      ? await this.helper[humanCollection.mode.toLocaleLowerCase() as 'nft' | 'rft'].getLastTokenId(collectionId)755      : 0;756    collectionData.admins = await this.getAdmins(collectionId);757758    return collectionData;759  }760761  /**762   * Get the addresses of the collection's administrators, optionally normalized.763   *764   * @param collectionId ID of collection765   * @param normalize whether to normalize the addresses to the default ss58 format766   * @example await getAdmins(1)767   * @returns array of administrators768   */769  async getAdmins(collectionId: number, normalize = false): Promise<CrossAccountId[]> {770    const admins = (await this.helper.callRpc('api.rpc.unique.adminlist', [collectionId])).toHuman();771772    return normalize773      ? admins.map((address: CrossAccountId) => address.withNormalizedSubstrate())774      : admins;775  }776777  /**778   * Get the addresses added to the collection allow-list, optionally normalized.779   * @param collectionId ID of collection780   * @param normalize whether to normalize the addresses to the default ss58 format781   * @example await getAllowList(1)782   * @returns array of allow-listed addresses783   */784  async getAllowList(collectionId: number, normalize = false): Promise<CrossAccountId[]> {785    const allowListed = (await this.helper.callRpc('api.rpc.unique.allowlist', [collectionId])).toHuman();786    return normalize787      ? allowListed.map((address: CrossAccountId) => address.withNormalizedSubstrate())788      : allowListed;789  }790791  /**792   * Get the effective limits of the collection instead of null for default values793   *794   * @param collectionId ID of collection795   * @example await getEffectiveLimits(2)796   * @returns object of collection limits797   */798  async getEffectiveLimits(collectionId: number): Promise<ICollectionLimits> {799    return (await this.helper.callRpc('api.rpc.unique.effectiveCollectionLimits', [collectionId])).toJSON();800  }801802  /**803   * Burns the collection if the signer has sufficient permissions and collection is empty.804   *805   * @param signer keyring of signer806   * @param collectionId ID of collection807   * @example await helper.collection.burn(aliceKeyring, 3);808   * @returns ```true``` if extrinsic success, otherwise ```false```809   */810  async burn(signer: TSigner, collectionId: number): Promise<boolean> {811    const result = await this.helper.executeExtrinsic(812      signer,813      'api.tx.unique.destroyCollection', [collectionId],814      true,815    );816817    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionDestroyed');818  }819820  /**821   * Sets the sponsor for the collection (Requires the Substrate address). Needs confirmation by the sponsor.822   *823   * @param signer keyring of signer824   * @param collectionId ID of collection825   * @param sponsorAddress Sponsor substrate address826   * @example setSponsor(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...")827   * @returns ```true``` if extrinsic success, otherwise ```false```828   */829  async setSponsor(signer: TSigner, collectionId: number, sponsorAddress: TSubstrateAccount): Promise<boolean> {830    const result = await this.helper.executeExtrinsic(831      signer,832      'api.tx.unique.setCollectionSponsor', [collectionId, sponsorAddress],833      true,834    );835836    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionSponsorSet');837  }838839  /**840   * Confirms consent to sponsor the collection on behalf of the signer.841   *842   * @param signer keyring of signer843   * @param collectionId ID of collection844   * @example confirmSponsorship(aliceKeyring, 10)845   * @returns ```true``` if extrinsic success, otherwise ```false```846   */847  async confirmSponsorship(signer: TSigner, collectionId: number): Promise<boolean> {848    const result = await this.helper.executeExtrinsic(849      signer,850      'api.tx.unique.confirmSponsorship', [collectionId],851      true,852    );853854    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'SponsorshipConfirmed');855  }856857  /**858   * Removes the sponsor of a collection, regardless if it consented or not.859   *860   * @param signer keyring of signer861   * @param collectionId ID of collection862   * @example removeSponsor(aliceKeyring, 10)863   * @returns ```true``` if extrinsic success, otherwise ```false```864   */865  async removeSponsor(signer: TSigner, collectionId: number): Promise<boolean> {866    const result = await this.helper.executeExtrinsic(867      signer,868      'api.tx.unique.removeCollectionSponsor', [collectionId],869      true,870    );871872    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionSponsorRemoved');873  }874875  /**876   * Sets the limits of the collection. At least one limit must be specified for a correct call.877   *878   * @param signer keyring of signer879   * @param collectionId ID of collection880   * @param limits collection limits object881   * @example882   * await setLimits(883   *   aliceKeyring,884   *   10,885   *   {886   *     sponsorTransferTimeout: 0,887   *     ownerCanDestroy: false888   *   }889   * )890   * @returns ```true``` if extrinsic success, otherwise ```false```891   */892  async setLimits(signer: TSigner, collectionId: number, limits: ICollectionLimits): Promise<boolean> {893    const result = await this.helper.executeExtrinsic(894      signer,895      'api.tx.unique.setCollectionLimits', [collectionId, limits],896      true,897    );898899    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionLimitSet');900  }901902  /**903   * Changes the owner of the collection to the new Substrate address.904   *905   * @param signer keyring of signer906   * @param collectionId ID of collection907   * @param ownerAddress substrate address of new owner908   * @example changeOwner(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...")909   * @returns ```true``` if extrinsic success, otherwise ```false```910   */911  async changeOwner(signer: TSigner, collectionId: number, ownerAddress: TSubstrateAccount): Promise<boolean> {912    const result = await this.helper.executeExtrinsic(913      signer,914      'api.tx.unique.changeCollectionOwner', [collectionId, ownerAddress],915      true,916    );917918    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionOwnedChanged');919  }920921  /**922   * Adds a collection administrator.923   *924   * @param signer keyring of signer925   * @param collectionId ID of collection926   * @param adminAddressObj Administrator address (substrate or ethereum)927   * @example addAdmin(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."})928   * @returns ```true``` if extrinsic success, otherwise ```false```929   */930  async addAdmin(signer: TSigner, collectionId: number, adminAddressObj: ICrossAccountId): Promise<boolean> {931    const result = await this.helper.executeExtrinsic(932      signer,933      'api.tx.unique.addCollectionAdmin', [collectionId, adminAddressObj],934      true,935    );936937    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionAdminAdded');938  }939940  /**941   * Removes a collection administrator.942   *943   * @param signer keyring of signer944   * @param collectionId ID of collection945   * @param adminAddressObj Administrator address (substrate or ethereum)946   * @example removeAdmin(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."})947   * @returns ```true``` if extrinsic success, otherwise ```false```948   */949  async removeAdmin(signer: TSigner, collectionId: number, adminAddressObj: ICrossAccountId): Promise<boolean> {950    const result = await this.helper.executeExtrinsic(951      signer,952      'api.tx.unique.removeCollectionAdmin', [collectionId, adminAddressObj],953      true,954    );955956    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionAdminRemoved');957  }958959  /**960   * Check if user is in allow list.961   *962   * @param collectionId ID of collection963   * @param user Account to check964   * @example await getAdmins(1)965   * @returns is user in allow list966   */967  async allowed(collectionId: number, user: ICrossAccountId): Promise<boolean> {968    return (await this.helper.callRpc('api.rpc.unique.allowed', [collectionId, user])).toJSON();969  }970971  /**972   * Adds an address to allow list973   * @param signer keyring of signer974   * @param collectionId ID of collection975   * @param addressObj address to add to the allow list976   * @returns ```true``` if extrinsic success, otherwise ```false```977   */978  async addToAllowList(signer: TSigner, collectionId: number, addressObj: ICrossAccountId): Promise<boolean> {979    const result = await this.helper.executeExtrinsic(980      signer,981      'api.tx.unique.addToAllowList', [collectionId, addressObj],982      true,983    );984985    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'AllowListAddressAdded');986  }987988  /**989   * Removes an address from allow list990   *991   * @param signer keyring of signer992   * @param collectionId ID of collection993   * @param addressObj address to remove from the allow list994   * @returns ```true``` if extrinsic success, otherwise ```false```995   */996  async removeFromAllowList(signer: TSigner, collectionId: number, addressObj: ICrossAccountId): Promise<boolean> {997    const result = await this.helper.executeExtrinsic(998      signer,999      'api.tx.unique.removeFromAllowList', [collectionId, addressObj],1000      true,1001    );10021003    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'AllowListAddressRemoved');1004  }10051006  /**1007   * Sets onchain permissions for selected collection.1008   *1009   * @param signer keyring of signer1010   * @param collectionId ID of collection1011   * @param permissions collection permissions object1012   * @example setPermissions(aliceKeyring, 10, {access:'AllowList', mintMode: true, nesting: {collectionAdmin: true, tokenOwner: true}});1013   * @returns ```true``` if extrinsic success, otherwise ```false```1014   */1015  async setPermissions(signer: TSigner, collectionId: number, permissions: ICollectionPermissions): Promise<boolean> {1016    const result = await this.helper.executeExtrinsic(1017      signer,1018      'api.tx.unique.setCollectionPermissions', [collectionId, permissions],1019      true,1020    );10211022    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'unique', 'CollectionPermissionSet');1023  }10241025  /**1026   * Enables nesting for selected collection. If `restricted` set, you can nest only tokens from specified collections.1027   *1028   * @param signer keyring of signer1029   * @param collectionId ID of collection1030   * @param permissions nesting permissions object1031   * @example enableNesting(aliceKeyring, 10, {collectionAdmin: true, tokenOwner: true});1032   * @returns ```true``` if extrinsic success, otherwise ```false```1033   */1034  async enableNesting(signer: TSigner, collectionId: number, permissions: INestingPermissions): Promise<boolean> {1035    return await this.setPermissions(signer, collectionId, {nesting: permissions});1036  }10371038  /**1039   * Disables nesting for selected collection.1040   *1041   * @param signer keyring of signer1042   * @param collectionId ID of collection1043   * @example disableNesting(aliceKeyring, 10);1044   * @returns ```true``` if extrinsic success, otherwise ```false```1045   */1046  async disableNesting(signer: TSigner, collectionId: number): Promise<boolean> {1047    return await this.setPermissions(signer, collectionId, {nesting: {tokenOwner: false, collectionAdmin: false}});1048  }10491050  /**1051   * Sets onchain properties to the collection.1052   *1053   * @param signer keyring of signer1054   * @param collectionId ID of collection1055   * @param properties array of property objects1056   * @example setProperties(aliceKeyring, 10, [{key: "gender", value: "male"}]);1057   * @returns ```true``` if extrinsic success, otherwise ```false```1058   */1059  async setProperties(signer: TSigner, collectionId: number, properties: IProperty[]): Promise<boolean> {1060    const result = await this.helper.executeExtrinsic(1061      signer,1062      'api.tx.unique.setCollectionProperties', [collectionId, properties],1063      true,1064    );10651066    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionPropertySet');1067  }10681069  /**1070   * Get collection properties.1071   *1072   * @param collectionId ID of collection1073   * @param propertyKeys optionally filter the returned properties to only these keys1074   * @example getProperties(1219, ['location', 'date', 'time', 'isParadise']);1075   * @returns array of key-value pairs1076   */1077  async getProperties(collectionId: number, propertyKeys?: string[] | null): Promise<IProperty[]> {1078    return (await this.helper.callRpc('api.rpc.unique.collectionProperties', [collectionId, propertyKeys])).toHuman();1079  }10801081  async getCollectionOptions(collectionId: number) {1082    return (await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId])).toHuman();1083  }10841085  /**1086   * Deletes onchain properties from the collection.1087   *1088   * @param signer keyring of signer1089   * @param collectionId ID of collection1090   * @param propertyKeys array of property keys to delete1091   * @example deleteProperties(aliceKeyring, 10, ["gender", "age"]);1092   * @returns ```true``` if extrinsic success, otherwise ```false```1093   */1094  async deleteProperties(signer: TSigner, collectionId: number, propertyKeys: string[]): Promise<boolean> {1095    const result = await this.helper.executeExtrinsic(1096      signer,1097      'api.tx.unique.deleteCollectionProperties', [collectionId, propertyKeys],1098      true,1099    );11001101    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionPropertyDeleted');1102  }11031104  /**1105   * Changes the owner of the token.1106   *1107   * @param signer keyring of signer1108   * @param collectionId ID of collection1109   * @param tokenId ID of token1110   * @param addressObj address of a new owner1111   * @param amount amount of tokens to be transfered. For NFT must be set to 1n1112   * @example transferToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1113   * @returns true if the token success, otherwise false1114   */1115  async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId, amount=1n): Promise<boolean> {1116    const result = await this.helper.executeExtrinsic(1117      signer,1118      'api.tx.unique.transfer', [addressObj, collectionId, tokenId, amount],1119      true, // `Unable to transfer token #${tokenId} from collection #${collectionId}`,1120    );11211122    return this.helper.util.isTokenTransferSuccess(result.result.events, collectionId, tokenId, {Substrate: typeof signer === 'string' ? signer : signer.address}, addressObj, amount);1123  }11241125  /**1126   *1127   * Change ownership of a token(s) on behalf of the owner.1128   *1129   * @param signer keyring of signer1130   * @param collectionId ID of collection1131   * @param tokenId ID of token1132   * @param fromAddressObj address on behalf of which the token will be sent1133   * @param toAddressObj new token owner1134   * @param amount amount of tokens to be transfered. For NFT must be set to 1n1135   * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg"}, {Ethereum: "0x9F0583DbB85..."})1136   * @returns true if the token success, otherwise false1137   */1138  async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n): Promise<boolean> {1139    const result = await this.helper.executeExtrinsic(1140      signer,1141      'api.tx.unique.transferFrom', [fromAddressObj, toAddressObj, collectionId, tokenId, amount],1142      true, // `Unable to transfer token #${tokenId} from collection #${collectionId}`,1143    );1144    return this.helper.util.isTokenTransferSuccess(result.result.events, collectionId, tokenId, fromAddressObj, toAddressObj, amount);1145  }11461147  /**1148   *1149   * Destroys a concrete instance of NFT/RFT or burns a specified amount of fungible tokens.1150   *1151   * @param signer keyring of signer1152   * @param collectionId ID of collection1153   * @param tokenId ID of token1154   * @param amount amount of tokens to be burned. For NFT must be set to 1n1155   * @example burnToken(aliceKeyring, 10, 5);1156   * @returns ```true``` if the extrinsic is successful, otherwise ```false```1157   */1158  async burnToken(signer: TSigner, collectionId: number, tokenId: number, amount=1n): Promise<boolean> {1159    const burnResult = await this.helper.executeExtrinsic(1160      signer,1161      'api.tx.unique.burnItem', [collectionId, tokenId, amount],1162      true, // `Unable to burn token for ${label}`,1163    );1164    const burnedTokens = this.helper.util.extractTokensFromBurnResult(burnResult);1165    if (burnedTokens.tokens.length > 1) throw Error('Burned multiple tokens');1166    return burnedTokens.success;1167  }11681169  /**1170   * Destroys a concrete instance of NFT on behalf of the owner1171   *1172   * @param signer keyring of signer1173   * @param collectionId ID of collection1174   * @param tokenId ID of token1175   * @param fromAddressObj address on behalf of which the token will be burnt1176   * @param amount amount of tokens to be burned. For NFT must be set to 1n1177   * @example burnTokenFrom(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."}, 5, {Ethereum: "0x9F0583DbB85..."})1178   * @returns ```true``` if extrinsic success, otherwise ```false```1179   */1180  async burnTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, amount=1n): Promise<boolean> {1181    const burnResult = await this.helper.executeExtrinsic(1182      signer,1183      'api.tx.unique.burnFrom', [collectionId, fromAddressObj, tokenId, amount],1184      true, // `Unable to burn token from for ${label}`,1185    );1186    const burnedTokens = this.helper.util.extractTokensFromBurnResult(burnResult);1187    return burnedTokens.success && burnedTokens.tokens.length > 0;1188  }11891190  /**1191   * Set, change, or remove approved address to transfer the ownership of the NFT.1192   *1193   * @param signer keyring of signer1194   * @param collectionId ID of collection1195   * @param tokenId ID of token1196   * @param toAddressObj Substrate or Ethereum address which gets approved use of the signer's tokens1197   * @param amount amount of token to be approved. For NFT must be set to 1n1198   * @returns ```true``` if extrinsic success, otherwise ```false```1199   */1200  async approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount=1n) {1201    const approveResult = await this.helper.executeExtrinsic(1202      signer,1203      'api.tx.unique.approve', [toAddressObj, collectionId, tokenId, amount],1204      true, // `Unable to approve token for ${label}`,1205    );12061207    return this.helper.util.findCollectionInEvents(approveResult.result.events, collectionId, 'common', 'Approved');1208  }12091210  /**1211   * Get the amount of token pieces approved to transfer or burn. Normally 0.1212   *1213   * @param collectionId ID of collection1214   * @param tokenId ID of token1215   * @param toAccountObj address which is approved to use token pieces1216   * @param fromAccountObj address which may have allowed the use of its owned tokens1217   * @example getTokenApprovedPieces(10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Substrate: "5ERZNF88Mm7UGfPP3mdG..."})1218   * @returns number of approved to transfer pieces1219   */1220  async getTokenApprovedPieces(collectionId: number, tokenId: number, toAccountObj: ICrossAccountId, fromAccountObj: ICrossAccountId): Promise<bigint> {1221    return (await this.helper.callRpc('api.rpc.unique.allowance', [collectionId, fromAccountObj, toAccountObj, tokenId])).toBigInt();1222  }12231224  /**1225   * Get the last created token ID in a collection1226   *1227   * @param collectionId ID of collection1228   * @example getLastTokenId(10);1229   * @returns id of the last created token1230   */1231  async getLastTokenId(collectionId: number): Promise<number> {1232    return (await this.helper.callRpc('api.rpc.unique.lastTokenId', [collectionId])).toNumber();1233  }12341235  /**1236   * Check if token exists1237   *1238   * @param collectionId ID of collection1239   * @param tokenId ID of token1240   * @example doesTokenExist(10, 20);1241   * @returns true if the token exists, otherwise false1242   */1243  async doesTokenExist(collectionId: number, tokenId: number): Promise<boolean> {1244    return (await this.helper.callRpc('api.rpc.unique.tokenExists', [collectionId, tokenId])).toJSON();1245  }1246}12471248class NFTnRFT extends CollectionGroup {1249  /**1250   * Get tokens owned by account1251   *1252   * @param collectionId ID of collection1253   * @param addressObj tokens owner1254   * @example getTokensByAddress(10, {Substrate: "5DyN4Y92vZCjv38fg..."})1255   * @returns array of token ids owned by account1256   */1257  async getTokensByAddress(collectionId: number, addressObj: ICrossAccountId): Promise<number[]> {1258    return (await this.helper.callRpc('api.rpc.unique.accountTokens', [collectionId, addressObj])).toJSON();1259  }12601261  /**1262   * Get token data1263   *1264   * @param collectionId ID of collection1265   * @param tokenId ID of token1266   * @param propertyKeys optionally filter the token properties to only these keys1267   * @param blockHashAt optionally query the data at some block with this hash1268   * @example getToken(10, 5);1269   * @returns human readable token data1270   */1271  async getToken(collectionId: number, tokenId: number, propertyKeys: string[] = [], blockHashAt?: string): Promise<{1272    properties: IProperty[];1273    owner: CrossAccountId;1274    normalizedOwner: CrossAccountId;1275  }| null> {1276    let tokenData;1277    if(typeof blockHashAt === 'undefined') {1278      tokenData = await this.helper.callRpc('api.rpc.unique.tokenData', [collectionId, tokenId]);1279    }1280    else {1281      if(propertyKeys.length == 0) {1282        const collection = (await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId])).toHuman();1283        if(!collection) return null;1284        propertyKeys = collection.tokenPropertyPermissions.map((x: ITokenPropertyPermission) => x.key);1285      }1286      tokenData = await this.helper.callRpc('api.rpc.unique.tokenData', [collectionId, tokenId, propertyKeys, blockHashAt]);1287    }1288    tokenData = tokenData.toHuman();1289    if (tokenData === null || tokenData.owner === null) return null;1290    const owner = {} as any;1291    for (const key of Object.keys(tokenData.owner)) {1292      owner[key.toLocaleLowerCase()] = key.toLocaleLowerCase() == 'substrate'1293        ? CrossAccountId.normalizeSubstrateAddress(tokenData.owner[key])1294        : tokenData.owner[key];1295    }1296    tokenData.normalizedOwner = CrossAccountId.fromLowerCaseKeys(owner);1297    return tokenData;1298  }12991300  /**1301   * Set permissions to change token properties1302   *1303   * @param signer keyring of signer1304   * @param collectionId ID of collection1305   * @param permissions permissions to change a property by the collection admin or token owner1306   * @example setTokenPropertyPermissions(1307   *   aliceKeyring, 10, [{key: "gender", permission: {tokenOwner: true, mutable: true, collectionAdmin: true}}]1308   * )1309   * @returns true if extrinsic success otherwise false1310   */1311  async setTokenPropertyPermissions(signer: TSigner, collectionId: number, permissions: ITokenPropertyPermission[]): Promise<boolean> {1312    const result = await this.helper.executeExtrinsic(1313      signer,1314      'api.tx.unique.setTokenPropertyPermissions', [collectionId, permissions],1315      true,1316    );13171318    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'PropertyPermissionSet');1319  }13201321  /**1322   * Get token property permissions.1323   *1324   * @param collectionId ID of collection1325   * @param propertyKeys optionally filter the returned property permissions to only these keys1326   * @example getPropertyPermissions(1219, ['location', 'date', 'time', 'isParadise']);1327   * @returns array of key-permission pairs1328   */1329  async getPropertyPermissions(collectionId: number, propertyKeys: string[] | null = null): Promise<ITokenPropertyPermission[]> {1330    return (await this.helper.callRpc('api.rpc.unique.propertyPermissions', [collectionId, ...(propertyKeys === null ? [] : [propertyKeys])])).toHuman();1331  }13321333  /**1334   * Set token properties1335   *1336   * @param signer keyring of signer1337   * @param collectionId ID of collection1338   * @param tokenId ID of token1339   * @param properties key-value pairs of metadata which to add to a token. Keys must be permitted in the collection1340   * @example setTokenProperties(aliceKeyring, 10, 5, [{key: "gender", value: "female"}, {key: "age", value: "23"}])1341   * @returns ```true``` if extrinsic success, otherwise ```false```1342   */1343  async setTokenProperties(signer: TSigner, collectionId: number, tokenId: number, properties: IProperty[]): Promise<boolean> {1344    const result = await this.helper.executeExtrinsic(1345      signer,1346      'api.tx.unique.setTokenProperties', [collectionId, tokenId, properties],1347      true,1348    );13491350    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'TokenPropertySet');1351  }13521353  /**1354   * Get properties, metadata assigned to a token.1355   *1356   * @param collectionId ID of collection1357   * @param tokenId ID of token1358   * @param propertyKeys optionally filter the returned properties to only these keys1359   * @example getTokenProperties(1219, ['location', 'date', 'time', 'isParadise']);1360   * @returns array of key-value pairs1361   */1362  async getTokenProperties(collectionId: number, tokenId: number, propertyKeys?: string[] | null): Promise<IProperty[]> {1363    return (await this.helper.callRpc('api.rpc.unique.tokenProperties', [collectionId, tokenId, propertyKeys])).toHuman();1364  }13651366  /**1367   * Delete the provided properties of a token1368   * @param signer keyring of signer1369   * @param collectionId ID of collection1370   * @param tokenId ID of token1371   * @param propertyKeys property keys to be deleted1372   * @example deleteTokenProperties(aliceKeyring, 10, 5, ["gender", "age"])1373   * @returns ```true``` if extrinsic success, otherwise ```false```1374   */1375  async deleteTokenProperties(signer: TSigner, collectionId: number, tokenId: number, propertyKeys: string[]): Promise<boolean> {1376    const result = await this.helper.executeExtrinsic(1377      signer,1378      'api.tx.unique.deleteTokenProperties', [collectionId, tokenId, propertyKeys],1379      true,1380    );13811382    return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'TokenPropertyDeleted');1383  }13841385  /**1386   * Mint new collection1387   *1388   * @param signer keyring of signer1389   * @param collectionOptions basic collection options and properties1390   * @param mode NFT or RFT type of a collection1391   * @example mintCollection(aliceKeyring, {name: 'New', description: "New collection", tokenPrefix: "NEW"}, "NFT")1392   * @returns object of the created collection1393   */1394  async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions, mode: 'NFT' | 'RFT'): Promise<UniqueBaseCollection> {1395    collectionOptions = JSON.parse(JSON.stringify(collectionOptions)) as ICollectionCreationOptions; // Clone object1396    collectionOptions.mode = (mode === 'NFT') ? {nft: null} : {refungible: null};1397    for (const key of ['name', 'description', 'tokenPrefix']) {1398      if (typeof collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] === 'string') collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] = this.helper.util.str2vec(collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] as string);1399    }1400    const creationResult = await this.helper.executeExtrinsic(1401      signer,1402      'api.tx.unique.createCollectionEx', [collectionOptions],1403      true, // errorLabel,1404    );1405    return this.getCollectionObject(this.helper.util.extractCollectionIdFromCreationResult(creationResult));1406  }14071408  getCollectionObject(_collectionId: number): any {1409    return null;1410  }14111412  getTokenObject(_collectionId: number, _tokenId: number): any {1413    return null;1414  }1415}141614171418class NFTGroup extends NFTnRFT {1419  /**1420   * Get collection object1421   * @param collectionId ID of collection1422   * @example getCollectionObject(2);1423   * @returns instance of UniqueNFTCollection1424   */1425  getCollectionObject(collectionId: number): UniqueNFTCollection {1426    return new UniqueNFTCollection(collectionId, this.helper);1427  }14281429  /**1430   * Get token object1431   * @param collectionId ID of collection1432   * @param tokenId ID of token1433   * @example getTokenObject(10, 5);1434   * @returns instance of UniqueNFTToken1435   */1436  getTokenObject(collectionId: number, tokenId: number): UniqueNFToken {1437    return new UniqueNFToken(tokenId, this.getCollectionObject(collectionId));1438  }14391440  /**1441   * Get token's owner1442   * @param collectionId ID of collection1443   * @param tokenId ID of token1444   * @param blockHashAt optionally query the data at the block with this hash1445   * @example getTokenOwner(10, 5);1446   * @returns Address in CrossAccountId format, e.g. {Substrate: "5DnSF6RRjwteE3BrCj..."}1447   */1448  async getTokenOwner(collectionId: number, tokenId: number, blockHashAt?: string): Promise<CrossAccountId> {1449    let owner;1450    if (typeof blockHashAt === 'undefined') {1451      owner = await this.helper.callRpc('api.rpc.unique.tokenOwner', [collectionId, tokenId]);1452    } else {1453      owner = await this.helper.callRpc('api.rpc.unique.tokenOwner', [collectionId, tokenId, blockHashAt]);1454    }1455    return CrossAccountId.fromLowerCaseKeys(owner.toJSON());1456  }14571458  /**1459   * Is token approved to transfer1460   * @param collectionId ID of collection1461   * @param tokenId ID of token1462   * @param toAccountObj address to be approved1463   * @returns ```true``` if extrinsic success, otherwise ```false```1464   */1465  async isTokenApproved(collectionId: number, tokenId: number, toAccountObj: ICrossAccountId): Promise<boolean> {1466    return (await this.getTokenApprovedPieces(collectionId, tokenId, toAccountObj, await this.getTokenOwner(collectionId, tokenId))) === 1n;1467  }14681469  /**1470   * Changes the owner of the token.1471   *1472   * @param signer keyring of signer1473   * @param collectionId ID of collection1474   * @param tokenId ID of token1475   * @param addressObj address of a new owner1476   * @example transferToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1477   * @returns ```true``` if extrinsic success, otherwise ```false```1478   */1479  async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<boolean> {1480    return await super.transferToken(signer, collectionId, tokenId, addressObj, 1n);1481  }14821483  /**1484   *1485   * Change ownership of a NFT on behalf of the owner.1486   *1487   * @param signer keyring of signer1488   * @param collectionId ID of collection1489   * @param tokenId ID of token1490   * @param fromAddressObj address on behalf of which the token will be sent1491   * @param toAddressObj new token owner1492   * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Ethereum: "0x9F0583DbB85..."})1493   * @returns ```true``` if extrinsic success, otherwise ```false```1494   */1495  async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId): Promise<boolean> {1496    return await super.transferTokenFrom(signer, collectionId, tokenId, fromAddressObj, toAddressObj, 1n);1497  }14981499  /**1500   * Recursively find the address that owns the token1501   * @param collectionId ID of collection1502   * @param tokenId ID of token1503   * @param blockHashAt1504   * @example getTokenTopmostOwner(10, 5);1505   * @returns address in CrossAccountId format, e.g. {Substrate: "5DyN4Y92vZCjv38fg..."}1506   */1507  async getTokenTopmostOwner(collectionId: number, tokenId: number, blockHashAt?: string): Promise<CrossAccountId | null> {1508    let owner;1509    if (typeof blockHashAt === 'undefined') {1510      owner = await this.helper.callRpc('api.rpc.unique.topmostTokenOwner', [collectionId, tokenId]);1511    } else {1512      owner = await this.helper.callRpc('api.rpc.unique.topmostTokenOwner', [collectionId, tokenId, blockHashAt]);1513    }15141515    if (owner === null) return null;15161517    return owner.toHuman();1518  }15191520  /**1521   * Get tokens nested in the provided token1522   * @param collectionId ID of collection1523   * @param tokenId ID of token1524   * @param blockHashAt optionally query the data at the block with this hash1525   * @example getTokenChildren(10, 5);1526   * @returns tokens whose depth of nesting is <= 51527   */1528  async getTokenChildren(collectionId: number, tokenId: number, blockHashAt?: string): Promise<IToken[]> {1529    let children;1530    if(typeof blockHashAt === 'undefined') {1531      children = await this.helper.callRpc('api.rpc.unique.tokenChildren', [collectionId, tokenId]);1532    } else {1533      children = await this.helper.callRpc('api.rpc.unique.tokenChildren', [collectionId, tokenId, blockHashAt]);1534    }15351536    return children.toJSON().map((x: any) => {1537      return {collectionId: x.collection, tokenId: x.token};1538    });1539  }15401541  /**1542   * Nest one token into another1543   * @param signer keyring of signer1544   * @param tokenObj token to be nested1545   * @param rootTokenObj token to be parent1546   * @example nestToken(aliceKeyring, {collectionId: 10, tokenId: 5}, {collectionId: 10, tokenId: 4});1547   * @returns ```true``` if extrinsic success, otherwise ```false```1548   */1549  async nestToken(signer: TSigner, tokenObj: IToken, rootTokenObj: IToken): Promise<boolean> {1550    const rootTokenAddress = this.helper.util.getTokenAccount(rootTokenObj);1551    const result = await this.transferToken(signer, tokenObj.collectionId, tokenObj.tokenId, rootTokenAddress);1552    if(!result) {1553      throw Error('Unable to nest token!');1554    }1555    return result;1556  }15571558  /**1559   * Remove token from nested state1560   * @param signer keyring of signer1561   * @param tokenObj token to unnest1562   * @param rootTokenObj parent of a token1563   * @param toAddressObj address of a new token owner1564   * @example unnestToken(aliceKeyring, {collectionId: 10, tokenId: 5}, {collectionId: 10, tokenId: 4}, {Substrate: "5DyN4Y92vZCjv38fg..."});1565   * @returns ```true``` if extrinsic success, otherwise ```false```1566   */1567  async unnestToken(signer: TSigner, tokenObj: IToken, rootTokenObj: IToken, toAddressObj: ICrossAccountId): Promise<boolean> {1568    const rootTokenAddress = this.helper.util.getTokenAccount(rootTokenObj);1569    const result = await this.transferTokenFrom(signer, tokenObj.collectionId, tokenObj.tokenId, rootTokenAddress, toAddressObj);1570    if(!result) {1571      throw Error('Unable to unnest token!');1572    }1573    return result;1574  }15751576  /**1577   * Mint new collection1578   * @param signer keyring of signer1579   * @param collectionOptions Collection options1580   * @example1581   * mintCollection(aliceKeyring, {1582   *   name: 'New',1583   *   description: 'New collection',1584   *   tokenPrefix: 'NEW',1585   * })1586   * @returns object of the created collection1587   */1588  async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}): Promise<UniqueNFTCollection> {1589    return await super.mintCollection(signer, collectionOptions, 'NFT') as UniqueNFTCollection;1590  }15911592  /**1593   * Mint new token1594   * @param signer keyring of signer1595   * @param data token data1596   * @returns created token object1597   */1598  async mintToken(signer: TSigner, data: { collectionId: number; owner: ICrossAccountId | string; properties?: IProperty[]; }): Promise<UniqueNFToken> {1599    const creationResult = await this.helper.executeExtrinsic(1600      signer,1601      'api.tx.unique.createItem', [data.collectionId, (typeof data.owner === 'string') ? {Substrate: data.owner} : data.owner, {1602        nft: {1603          properties: data.properties,1604        },1605      }],1606      true,1607    );1608    const createdTokens = this.helper.util.extractTokensFromCreationResult(creationResult);1609    if (createdTokens.tokens.length > 1) throw Error('Minted multiple tokens');1610    if (createdTokens.tokens.length < 1) throw Error('No tokens minted');1611    return this.getTokenObject(data.collectionId, createdTokens.tokens[0].tokenId);1612  }16131614  /**1615   * Mint multiple NFT tokens1616   * @param signer keyring of signer1617   * @param collectionId ID of collection1618   * @param tokens array of tokens with owner and properties1619   * @example1620   * mintMultipleTokens(aliceKeyring, 10, [{1621   *     owner: {Substrate: "5DyN4Y92vZCjv38fg..."},1622   *     properties: [{key: "gender", value: "male"},{key: "age", value: "45"}],1623   *   },{1624   *     owner: {Ethereum: "0x9F0583DbB855d..."},1625   *     properties: [{key: "gender", value: "female"},{key: "age", value: "22"}],1626   * }]);1627   * @returns ```true``` if extrinsic success, otherwise ```false```1628   */1629  async mintMultipleTokens(signer: TSigner, collectionId: number, tokens: {owner: ICrossAccountId, properties?: IProperty[]}[]): Promise<UniqueNFToken[]> {1630    const creationResult = await this.helper.executeExtrinsic(1631      signer,1632      'api.tx.unique.createMultipleItemsEx', [collectionId, {NFT: tokens}],1633      true,1634    );1635    const collection = this.getCollectionObject(collectionId);1636    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1637  }16381639  /**1640   * Mint multiple NFT tokens with one owner1641   * @param signer keyring of signer1642   * @param collectionId ID of collection1643   * @param owner tokens owner1644   * @param tokens array of tokens with owner and properties1645   * @example1646   * mintMultipleTokensWithOneOwner(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...", [{1647   *   properties: [{1648   *   key: "gender",1649   *   value: "female",1650   *  },{1651   *   key: "age",1652   *   value: "33",1653   *  }],1654   * }]);1655   * @returns array of newly created tokens1656   */1657  async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, owner: ICrossAccountId, tokens: {properties?: IProperty[]}[]): Promise<UniqueNFToken[]> {1658    const rawTokens = [];1659    for (const token of tokens) {1660      const raw = {NFT: {properties: token.properties}};1661      rawTokens.push(raw);1662    }1663    const creationResult = await this.helper.executeExtrinsic(1664      signer,1665      'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],1666      true,1667    );1668    const collection = this.getCollectionObject(collectionId);1669    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1670  }16711672  /**1673   * Set, change, or remove approved address to transfer the ownership of the NFT.1674   *1675   * @param signer keyring of signer1676   * @param collectionId ID of collection1677   * @param tokenId ID of token1678   * @param toAddressObj address to approve1679   * @example approveToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1680   * @returns ```true``` if extrinsic success, otherwise ```false```1681   */1682  async approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId) {1683    return super.approveToken(signer, collectionId, tokenId, toAddressObj, 1n);1684  }1685}168616871688class RFTGroup extends NFTnRFT {1689  /**1690   * Get collection object1691   * @param collectionId ID of collection1692   * @example getCollectionObject(2);1693   * @returns instance of UniqueRFTCollection1694   */1695  getCollectionObject(collectionId: number): UniqueRFTCollection {1696    return new UniqueRFTCollection(collectionId, this.helper);1697  }16981699  /**1700   * Get token object1701   * @param collectionId ID of collection1702   * @param tokenId ID of token1703   * @example getTokenObject(10, 5);1704   * @returns instance of UniqueNFTToken1705   */1706  getTokenObject(collectionId: number, tokenId: number): UniqueRFToken {1707    return new UniqueRFToken(tokenId, this.getCollectionObject(collectionId));1708  }17091710  /**1711   * Get top 10 token owners with the largest number of pieces1712   * @param collectionId ID of collection1713   * @param tokenId ID of token1714   * @example getTokenTop10Owners(10, 5);1715   * @returns array of top 10 owners1716   */1717  async getTokenTop10Owners(collectionId: number, tokenId: number): Promise<CrossAccountId[]> {1718    return (await this.helper.callRpc('api.rpc.unique.tokenOwners', [collectionId, tokenId])).toJSON().map(CrossAccountId.fromLowerCaseKeys);1719  }17201721  /**1722   * Get number of pieces owned by address1723   * @param collectionId ID of collection1724   * @param tokenId ID of token1725   * @param addressObj address token owner1726   * @example getTokenBalance(10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."});1727   * @returns number of pieces ownerd by address1728   */1729  async getTokenBalance(collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<bigint> {1730    return (await this.helper.callRpc('api.rpc.unique.balance', [collectionId, addressObj, tokenId])).toBigInt();1731  }17321733  /**1734   * Transfer pieces of token to another address1735   * @param signer keyring of signer1736   * @param collectionId ID of collection1737   * @param tokenId ID of token1738   * @param addressObj address of a new owner1739   * @param amount number of pieces to be transfered1740   * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, 2000n)1741   * @returns ```true``` if extrinsic success, otherwise ```false```1742   */1743  async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId, amount=1n): Promise<boolean> {1744    return await super.transferToken(signer, collectionId, tokenId, addressObj, amount);1745  }17461747  /**1748   * Change ownership of some pieces of RFT on behalf of the owner.1749   * @param signer keyring of signer1750   * @param collectionId ID of collection1751   * @param tokenId ID of token1752   * @param fromAddressObj address on behalf of which the token will be sent1753   * @param toAddressObj new token owner1754   * @param amount number of pieces to be transfered1755   * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Substrate: "5DfhbVfww7ThF8q6f3i..."}, 2000n)1756   * @returns ```true``` if extrinsic success, otherwise ```false```1757   */1758  async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n): Promise<boolean> {1759    return await super.transferTokenFrom(signer, collectionId, tokenId, fromAddressObj, toAddressObj, amount);1760  }17611762  /**1763   * Mint new collection1764   * @param signer keyring of signer1765   * @param collectionOptions Collection options1766   * @example1767   * mintCollection(aliceKeyring, {1768   *   name: 'New',1769   *   description: 'New collection',1770   *   tokenPrefix: 'NEW',1771   * })1772   * @returns object of the created collection1773   */1774  async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}): Promise<UniqueRFTCollection> {1775    return await super.mintCollection(signer, collectionOptions, 'RFT') as UniqueRFTCollection;1776  }17771778  /**1779   * Mint new token1780   * @param signer keyring of signer1781   * @param data token data1782   * @example mintToken(aliceKeyring, {collectionId: 10, owner: {Substrate: '5GHoZe9c73RYbVzq...'}, pieces: 10000n});1783   * @returns created token object1784   */1785  async mintToken(signer: TSigner, data: { collectionId: number; owner: ICrossAccountId | string; pieces: bigint; properties?: IProperty[]; }): Promise<UniqueRFToken> {1786    const creationResult = await this.helper.executeExtrinsic(1787      signer,1788      'api.tx.unique.createItem', [data.collectionId, (typeof data.owner === 'string') ? {Substrate: data.owner} : data.owner, {1789        refungible: {1790          pieces: data.pieces,1791          properties: data.properties,1792        },1793      }],1794      true,1795    );1796    const createdTokens = this.helper.util.extractTokensFromCreationResult(creationResult);1797    if (createdTokens.tokens.length > 1) throw Error('Minted multiple tokens');1798    if (createdTokens.tokens.length < 1) throw Error('No tokens minted');1799    return this.getTokenObject(data.collectionId, createdTokens.tokens[0].tokenId);1800  }18011802  async mintMultipleTokens(signer: TSigner, collectionId: number, tokens: {owner: ICrossAccountId, pieces: bigint, properties?: IProperty[]}[]): Promise<UniqueRFToken[]> {1803    throw Error('Not implemented');1804    const creationResult = await this.helper.executeExtrinsic(1805      signer,1806      'api.tx.unique.createMultipleItemsEx', [collectionId, {RefungibleMultipleOwners: tokens}],1807      true, // `Unable to mint RFT tokens for ${label}`,1808    );1809    const collection = this.getCollectionObject(collectionId);1810    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1811  }18121813  /**1814   * Mint multiple RFT tokens with one owner1815   * @param signer keyring of signer1816   * @param collectionId ID of collection1817   * @param owner tokens owner1818   * @param tokens array of tokens with properties and pieces1819   * @example mintMultipleTokensWithOneOwner(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, [{pieces: 100000n, properties: [{key: "gender", value: "male"}]}]);1820   * @returns array of newly created RFT tokens1821   */1822  async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, owner: ICrossAccountId, tokens: {pieces: bigint, properties?: IProperty[]}[]): Promise<UniqueRFToken[]> {1823    const rawTokens = [];1824    for (const token of tokens) {1825      const raw = {ReFungible: {pieces: token.pieces, properties: token.properties}};1826      rawTokens.push(raw);1827    }1828    const creationResult = await this.helper.executeExtrinsic(1829      signer,1830      'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],1831      true,1832    );1833    const collection = this.getCollectionObject(collectionId);1834    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1835  }18361837  /**1838   * Destroys a concrete instance of RFT.1839   * @param signer keyring of signer1840   * @param collectionId ID of collection1841   * @param tokenId ID of token1842   * @param amount number of pieces to be burnt1843   * @example burnToken(aliceKeyring, 10, 5);1844   * @returns ```true``` if the extrinsic is successful, otherwise ```false```1845   */1846  async burnToken(signer: IKeyringPair, collectionId: number, tokenId: number, amount=1n): Promise<boolean> {1847    return await super.burnToken(signer, collectionId, tokenId, amount);1848  }18491850  /**1851   * Destroys a concrete instance of RFT on behalf of the owner.1852   * @param signer keyring of signer1853   * @param collectionId ID of collection1854   * @param tokenId ID of token1855   * @param fromAddressObj address on behalf of which the token will be burnt1856   * @param amount number of pieces to be burnt1857   * @example burnTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, 2n)1858   * @returns ```true``` if extrinsic success, otherwise ```false```1859   */1860  async burnTokenFrom(signer: IKeyringPair, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, amount=1n): Promise<boolean> {1861    return await super.burnTokenFrom(signer, collectionId, tokenId, fromAddressObj, amount);1862  }18631864  /**1865   * Set, change, or remove approved address to transfer the ownership of the RFT.1866   *1867   * @param signer keyring of signer1868   * @param collectionId ID of collection1869   * @param tokenId ID of token1870   * @param toAddressObj address to approve1871   * @param amount number of pieces to be approved1872   * @example approveToken(aliceKeyring, 10, 5, {Substrate: "5GHoZe9c73RYbVzq..."}, "", 10000n);1873   * @returns true if the token success, otherwise false1874   */1875  async approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount=1n) {1876    return super.approveToken(signer, collectionId, tokenId, toAddressObj, amount);1877  }18781879  /**1880   * Get total number of pieces1881   * @param collectionId ID of collection1882   * @param tokenId ID of token1883   * @example getTokenTotalPieces(10, 5);1884   * @returns number of pieces1885   */1886  async getTokenTotalPieces(collectionId: number, tokenId: number): Promise<bigint> {1887    return (await this.helper.callRpc('api.rpc.unique.totalPieces', [collectionId, tokenId])).unwrap().toBigInt();1888  }18891890  /**1891   * Change number of token pieces. Signer must be the owner of all token pieces.1892   * @param signer keyring of signer1893   * @param collectionId ID of collection1894   * @param tokenId ID of token1895   * @param amount new number of pieces1896   * @example repartitionToken(aliceKeyring, 10, 5, 12345n);1897   * @returns true if the repartion was success, otherwise false1898   */1899  async repartitionToken(signer: TSigner, collectionId: number, tokenId: number, amount: bigint): Promise<boolean> {1900    const currentAmount = await this.getTokenTotalPieces(collectionId, tokenId);1901    const repartitionResult = await this.helper.executeExtrinsic(1902      signer,1903      'api.tx.unique.repartition', [collectionId, tokenId, amount],1904      true,1905    );1906    if(currentAmount < amount) return this.helper.util.findCollectionInEvents(repartitionResult.result.events, collectionId, 'common', 'ItemCreated');1907    return this.helper.util.findCollectionInEvents(repartitionResult.result.events, collectionId, 'common', 'ItemDestroyed');1908  }1909}191019111912class FTGroup extends CollectionGroup {1913  /**1914   * Get collection object1915   * @param collectionId ID of collection1916   * @example getCollectionObject(2);1917   * @returns instance of UniqueFTCollection1918   */1919  getCollectionObject(collectionId: number): UniqueFTCollection {1920    return new UniqueFTCollection(collectionId, this.helper);1921  }19221923  /**1924   * Mint new fungible collection1925   * @param signer keyring of signer1926   * @param collectionOptions Collection options1927   * @param decimalPoints number of token decimals1928   * @example1929   * mintCollection(aliceKeyring, {1930   *   name: 'New',1931   *   description: 'New collection',1932   *   tokenPrefix: 'NEW',1933   * }, 18)1934   * @returns newly created fungible collection1935   */1936  async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}, decimalPoints = 0): Promise<UniqueFTCollection> {1937    collectionOptions = JSON.parse(JSON.stringify(collectionOptions)) as ICollectionCreationOptions; // Clone object1938    if(collectionOptions.tokenPropertyPermissions) throw Error('Fungible collections has no tokenPropertyPermissions');1939    collectionOptions.mode = {fungible: decimalPoints};1940    for (const key of ['name', 'description', 'tokenPrefix']) {1941      if (typeof collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] === 'string') collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] = this.helper.util.str2vec(collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] as string);1942    }1943    const creationResult = await this.helper.executeExtrinsic(1944      signer,1945      'api.tx.unique.createCollectionEx', [collectionOptions],1946      true,1947    );1948    return this.getCollectionObject(this.helper.util.extractCollectionIdFromCreationResult(creationResult));1949  }19501951  /**1952   * Mint tokens1953   * @param signer keyring of signer1954   * @param collectionId ID of collection1955   * @param owner address owner of new tokens1956   * @param amount amount of tokens to be meanted1957   * @example mintTokens(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq"}, 1000n);1958   * @returns ```true``` if extrinsic success, otherwise ```false```1959   */1960  async mintTokens(signer: TSigner, collectionId: number, amount: bigint, owner: ICrossAccountId | string): Promise<boolean> {1961    const creationResult = await this.helper.executeExtrinsic(1962      signer,1963      'api.tx.unique.createItem', [collectionId, (typeof owner === 'string') ? {Substrate: owner} : owner, {1964        fungible: {1965          value: amount,1966        },1967      }],1968      true, // `Unable to mint fungible tokens for ${label}`,1969    );1970    return this.helper.util.findCollectionInEvents(creationResult.result.events, collectionId, 'common', 'ItemCreated');1971  }19721973  /**1974   * Mint multiple Fungible tokens with one owner1975   * @param signer keyring of signer1976   * @param collectionId ID of collection1977   * @param owner tokens owner1978   * @param tokens array of tokens with properties and pieces1979   * @returns ```true``` if extrinsic success, otherwise ```false```1980   */1981  async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, tokens: {value: bigint}[], owner: ICrossAccountId): Promise<boolean> {1982    const rawTokens = [];1983    for (const token of tokens) {1984      const raw = {Fungible: {Value: token.value}};1985      rawTokens.push(raw);1986    }1987    const creationResult = await this.helper.executeExtrinsic(1988      signer,1989      'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],1990      true,1991    );1992    return this.helper.util.findCollectionInEvents(creationResult.result.events, collectionId, 'common', 'ItemCreated');1993  }19941995  /**1996   * Get the top 10 owners with the largest balance for the Fungible collection1997   * @param collectionId ID of collection1998   * @example getTop10Owners(10);1999   * @returns array of ```ICrossAccountId```2000   */2001  async getTop10Owners(collectionId: number): Promise<CrossAccountId[]> {2002    return (await this.helper.callRpc('api.rpc.unique.tokenOwners', [collectionId, 0])).toJSON().map(CrossAccountId.fromLowerCaseKeys);2003  }20042005  /**2006   * Get account balance2007   * @param collectionId ID of collection2008   * @param addressObj address of owner2009   * @example getBalance(10, {Substrate: "5GHoZe9c73RYbVzq..."})2010   * @returns amount of fungible tokens owned by address2011   */2012  async getBalance(collectionId: number, addressObj: ICrossAccountId): Promise<bigint> {2013    return (await this.helper.callRpc('api.rpc.unique.balance', [collectionId, addressObj, 0])).toBigInt();2014  }20152016  /**2017   * Transfer tokens to address2018   * @param signer keyring of signer2019   * @param collectionId ID of collection2020   * @param toAddressObj address recipient2021   * @param amount amount of tokens to be sent2022   * @example transfer(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n);2023   * @returns ```true``` if extrinsic success, otherwise ```false```2024   */2025  async transfer(signer: TSigner, collectionId: number, toAddressObj: ICrossAccountId, amount=1n) {2026    return await super.transferToken(signer, collectionId, 0, toAddressObj, amount);2027  }20282029  /**2030   * Transfer some tokens on behalf of the owner.2031   * @param signer keyring of signer2032   * @param collectionId ID of collection2033   * @param fromAddressObj address on behalf of which tokens will be sent2034   * @param toAddressObj address where token to be sent2035   * @param amount number of tokens to be sent2036   * @example transferFrom(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, {Substrate: "5DfhbVfww7ThF8q6f3ij..."}, 10000n);2037   * @returns ```true``` if extrinsic success, otherwise ```false```2038   */2039  async transferFrom(signer: TSigner, collectionId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n) {2040    return await super.transferTokenFrom(signer, collectionId, 0, fromAddressObj, toAddressObj, amount);2041  }20422043  /**2044   * Destroy some amount of tokens2045   * @param signer keyring of signer2046   * @param collectionId ID of collection2047   * @param amount amount of tokens to be destroyed2048   * @example burnTokens(aliceKeyring, 10, 1000n);2049   * @returns ```true``` if extrinsic success, otherwise ```false```2050   */2051  async burnTokens(signer: IKeyringPair, collectionId: number, amount=1n): Promise<boolean> {2052    return await super.burnToken(signer, collectionId, 0, amount);2053  }20542055  /**2056   * Burn some tokens on behalf of the owner.2057   * @param signer keyring of signer2058   * @param collectionId ID of collection2059   * @param fromAddressObj address on behalf of which tokens will be burnt2060   * @param amount amount of tokens to be burnt2061   * @example burnTokensFrom(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n);2062   * @returns ```true``` if extrinsic success, otherwise ```false```2063   */2064  async burnTokensFrom(signer: IKeyringPair, collectionId: number, fromAddressObj: ICrossAccountId, amount=1n): Promise<boolean> {2065    return await super.burnTokenFrom(signer, collectionId, 0, fromAddressObj, amount);2066  }20672068  /**2069   * Get total collection supply2070   * @param collectionId2071   * @returns2072   */2073  async getTotalPieces(collectionId: number): Promise<bigint> {2074    return (await this.helper.callRpc('api.rpc.unique.totalPieces', [collectionId, 0])).unwrap().toBigInt();2075  }20762077  /**2078   * Set, change, or remove approved address to transfer tokens.2079   *2080   * @param signer keyring of signer2081   * @param collectionId ID of collection2082   * @param toAddressObj address to be approved2083   * @param amount amount of tokens to be approved2084   * @example approveTokens(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n)2085   * @returns ```true``` if extrinsic success, otherwise ```false```2086   */2087  async approveTokens(signer: IKeyringPair, collectionId: number, toAddressObj: ICrossAccountId, amount=1n) {2088    return super.approveToken(signer, collectionId, 0, toAddressObj, amount);2089  }20902091  /**2092   * Get amount of fungible tokens approved to transfer2093   * @param collectionId ID of collection2094   * @param fromAddressObj owner of tokens2095   * @param toAddressObj the address approved for the transfer of tokens on behalf of the owner2096   * @returns number of tokens approved for the transfer2097   */2098  async getApprovedTokens(collectionId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {2099    return super.getTokenApprovedPieces(collectionId, 0, toAddressObj, fromAddressObj);2100  }2101}210221032104class ChainGroup extends HelperGroup<ChainHelperBase> {2105  /**2106   * Get system properties of a chain2107   * @example getChainProperties();2108   * @returns ss58Format, token decimals, and token symbol2109   */2110  getChainProperties(): IChainProperties {2111    const properties = (this.helper.getApi() as any).registry.getChainProperties().toJSON();2112    return {2113      ss58Format: properties.ss58Format.toJSON(),2114      tokenDecimals: properties.tokenDecimals.toJSON(),2115      tokenSymbol: properties.tokenSymbol.toJSON(),2116    };2117  }21182119  /**2120   * Get chain header2121   * @example getLatestBlockNumber();2122   * @returns the number of the last block2123   */2124  async getLatestBlockNumber(): Promise<number> {2125    return (await this.helper.callRpc('api.rpc.chain.getHeader')).number.toNumber();2126  }21272128  /**2129   * Get block hash by block number2130   * @param blockNumber number of block2131   * @example getBlockHashByNumber(12345);2132   * @returns hash of a block2133   */2134  async getBlockHashByNumber(blockNumber: number): Promise<string | null> {2135    const blockHash = (await this.helper.callRpc('api.rpc.chain.getBlockHash', [blockNumber])).toJSON();2136    if(blockHash === '0x0000000000000000000000000000000000000000000000000000000000000000') return null;2137    return blockHash;2138  }21392140  // TODO add docs2141  async getBlock(blockHashOrNumber: string | number): Promise<IBlock | null> {2142    const blockHash = typeof blockHashOrNumber === 'string' ? blockHashOrNumber : await this.getBlockHashByNumber(blockHashOrNumber);2143    if (!blockHash) return null;2144    return (await this.helper.callRpc('api.rpc.chain.getBlock', [blockHash])).toHuman().block;2145  }21462147  /**2148   * Get account nonce2149   * @param address substrate address2150   * @example getNonce("5GrwvaEF5zXb26Fz...");2151   * @returns number, account's nonce2152   */2153  async getNonce(address: TSubstrateAccount): Promise<number> {2154    return (await this.helper.callRpc('api.query.system.account', [address])).nonce.toNumber();2155  }2156}21572158class SubstrateBalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2159  /**2160 * Get substrate address balance2161 * @param address substrate address2162 * @example getSubstrate("5GrwvaEF5zXb26Fz...")2163 * @returns amount of tokens on address2164 */2165  async getSubstrate(address: TSubstrateAccount): Promise<bigint> {2166    return (await this.helper.callRpc('api.query.system.account', [address])).data.free.toBigInt();2167  }21682169  /**2170   * Transfer tokens to substrate address2171   * @param signer keyring of signer2172   * @param address substrate address of a recipient2173   * @param amount amount of tokens to be transfered2174   * @example transferToSubstrate(aliceKeyring, "5GrwvaEF5zXb26Fz...", 100_000_000_000n);2175   * @returns ```true``` if extrinsic success, otherwise ```false```2176   */2177  async transferToSubstrate(signer: TSigner, address: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2178    const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.transfer', [address, amount], true/*, `Unable to transfer balance from ${this.helper.getSignerAddress(signer)} to ${address}`*/);21792180    let transfer = {from: null, to: null, amount: 0n} as any;2181    result.result.events.forEach(({event: {data, method, section}}) => {2182      if ((section === 'balances') && (method === 'Transfer')) {2183        transfer = {2184          from: this.helper.address.normalizeSubstrate(data[0]),2185          to: this.helper.address.normalizeSubstrate(data[1]),2186          amount: BigInt(data[2]),2187        };2188      }2189    });2190    const isSuccess = this.helper.address.normalizeSubstrate(typeof signer === 'string' ? signer : signer.address) === transfer.from2191      && this.helper.address.normalizeSubstrate(address) === transfer.to2192      && BigInt(amount) === transfer.amount;2193    return isSuccess;2194  }21952196  /**2197   * Get full substrate balance including free, miscFrozen, feeFrozen, and reserved2198   * @param address substrate address2199   * @returns2200   */2201  async getSubstrateFull(address: TSubstrateAccount): Promise<ISubstrateBalance> {2202    const accountInfo = (await this.helper.callRpc('api.query.system.account', [address])).data;2203    return {free: accountInfo.free.toBigInt(), miscFrozen: accountInfo.miscFrozen.toBigInt(), feeFrozen: accountInfo.feeFrozen.toBigInt(), reserved: accountInfo.reserved.toBigInt()};2204  }2205}22062207class EthereumBalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2208  /**2209   * Get ethereum address balance2210   * @param address ethereum address2211   * @example getEthereum("0x9F0583DbB855d...")2212   * @returns amount of tokens on address2213   */2214  async getEthereum(address: TEthereumAccount): Promise<bigint> {2215    return (await this.helper.callRpc('api.rpc.eth.getBalance', [address])).toBigInt();2216  }22172218  /**2219   * Transfer tokens to address2220   * @param signer keyring of signer2221   * @param address Ethereum address of a recipient2222   * @param amount amount of tokens to be transfered2223   * @example transferToEthereum(alithKeyring, "0x9F0583DbB855d...", 100_000_000_000n);2224   * @returns ```true``` if extrinsic success, otherwise ```false```2225   */2226  async transferToEthereum(signer: TSigner, address: TEthereumAccount, amount: bigint | string): Promise<boolean> {2227    const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.transfer', [address, amount], true);22282229    let transfer = {from: null, to: null, amount: 0n} as any;2230    result.result.events.forEach(({event: {data, method, section}}) => {2231      if ((section === 'balances') && (method === 'Transfer')) {2232        transfer = {2233          from: data[0].toString(),2234          to: data[1].toString(),2235          amount: BigInt(data[2]),2236        };2237      }2238    });2239    const isSuccess = (typeof signer === 'string' ? signer : signer.address) === transfer.from2240      && address === transfer.to2241      && BigInt(amount) === transfer.amount;2242    return isSuccess;2243  }2244}22452246class BalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2247  subBalanceGroup: SubstrateBalanceGroup<T>;2248  ethBalanceGroup: EthereumBalanceGroup<T>;22492250  constructor(helper: T) {2251    super(helper);2252    this.subBalanceGroup = new SubstrateBalanceGroup(helper);2253    this.ethBalanceGroup = new EthereumBalanceGroup(helper);2254  }22552256  getCollectionCreationPrice(): bigint {2257    return 2n * this.getOneTokenNominal();2258  }2259  /**2260   * Representation of the native token in the smallest unit - one OPAL (OPL), QUARTZ (QTZ), or UNIQUE (UNQ).2261   * @example getOneTokenNominal()2262   * @returns ```BigInt``` representation of the native token in the smallest unit, e.g. ```1_000_000_000_000_000_000n``` for QTZ.2263   */2264  getOneTokenNominal(): bigint {2265    const chainProperties = this.helper.chain.getChainProperties();2266    return 10n ** BigInt((chainProperties.tokenDecimals || [18])[0]);2267  }22682269  /**2270   * Get substrate address balance2271   * @param address substrate address2272   * @example getSubstrate("5GrwvaEF5zXb26Fz...")2273   * @returns amount of tokens on address2274   */2275  async getSubstrate(address: TSubstrateAccount): Promise<bigint> {2276    return this.subBalanceGroup.getSubstrate(address);2277  }22782279  /**2280   * Get full substrate balance including free, miscFrozen, feeFrozen, and reserved2281   * @param address substrate address2282   * @returns2283   */2284  async getSubstrateFull(address: TSubstrateAccount): Promise<ISubstrateBalance> {2285    return this.subBalanceGroup.getSubstrateFull(address);2286  }22872288  /**2289   * Get ethereum address balance2290   * @param address ethereum address2291   * @example getEthereum("0x9F0583DbB855d...")2292   * @returns amount of tokens on address2293   */2294  async getEthereum(address: TEthereumAccount): Promise<bigint> {2295    return this.ethBalanceGroup.getEthereum(address);2296  }22972298  /**2299   * Transfer tokens to substrate address2300   * @param signer keyring of signer2301   * @param address substrate address of a recipient2302   * @param amount amount of tokens to be transfered2303   * @example transferToSubstrate(aliceKeyring, "5GrwvaEF5zXb26Fz...", 100_000_000_000n);2304   * @returns ```true``` if extrinsic success, otherwise ```false```2305   */2306  async transferToSubstrate(signer: TSigner, address: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2307    return this.subBalanceGroup.transferToSubstrate(signer, address, amount);2308  }23092310  async forceTransferToSubstrate(signer: TSigner, from: TSubstrateAccount, to: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2311    const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.forceTransfer', [from, to, amount], true);23122313    let transfer = {from: null, to: null, amount: 0n} as any;2314    result.result.events.forEach(({event: {data, method, section}}) => {2315      if ((section === 'balances') && (method === 'Transfer')) {2316        transfer = {2317          from: this.helper.address.normalizeSubstrate(data[0]),2318          to: this.helper.address.normalizeSubstrate(data[1]),2319          amount: BigInt(data[2]),2320        };2321      }2322    });2323    let isSuccess = this.helper.address.normalizeSubstrate(from) === transfer.from;2324    isSuccess = isSuccess && this.helper.address.normalizeSubstrate(to) === transfer.to;2325    isSuccess = isSuccess && BigInt(amount) === transfer.amount;2326    return isSuccess;2327  }2328}23292330class AddressGroup extends HelperGroup<ChainHelperBase> {2331  /**2332   * Normalizes the address to the specified ss58 format, by default ```42```.2333   * @param address substrate address2334   * @param ss58Format format for address conversion, by default ```42```2335   * @example normalizeSubstrate("unjKJQJrRd238pkUZZvzDQrfKuM39zBSnQ5zjAGAGcdRhaJTx") // returns 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY2336   * @returns substrate address converted to normalized (i.e., starting with 5) or specified explicitly representation2337   */2338  normalizeSubstrate(address: TSubstrateAccount, ss58Format = 42): TSubstrateAccount {2339    return CrossAccountId.normalizeSubstrateAddress(address, ss58Format);2340  }23412342  /**2343   * Get address in the connected chain format2344   * @param address substrate address2345   * @example normalizeSubstrateToChainFormat("5GrwvaEF5zXb26Fz...") // returns unjKJQJrRd238pkUZZ... for Unique Network2346   * @returns address in chain format2347   */2348  normalizeSubstrateToChainFormat(address: TSubstrateAccount): TSubstrateAccount {2349    return this.normalizeSubstrate(address, this.helper.chain.getChainProperties().ss58Format);2350  }23512352  /**2353   * Get substrate mirror of an ethereum address2354   * @param ethAddress ethereum address2355   * @param toChainFormat false for normalized account2356   * @example ethToSubstrate('0x9F0583DbB855d...')2357   * @returns substrate mirror of a provided ethereum address2358   */2359  ethToSubstrate(ethAddress: TEthereumAccount, toChainFormat=false): TSubstrateAccount {2360    return CrossAccountId.translateEthToSub(ethAddress, toChainFormat ? this.helper.chain.getChainProperties().ss58Format : undefined);2361  }23622363  /**2364   * Get ethereum mirror of a substrate address2365   * @param subAddress substrate account2366   * @example substrateToEth("5DnSF6RRjwteE3BrC...")2367   * @returns ethereum mirror of a provided substrate address2368   */2369  substrateToEth(subAddress: TSubstrateAccount): TEthereumAccount {2370    return CrossAccountId.translateSubToEth(subAddress);2371  }23722373  /**2374   * Encode key to substrate address2375   * @param key key for encoding address2376   * @param ss58Format prefix for encoding to the address of the corresponding network2377   * @returns encoded substrate address2378   */2379  encodeSubstrateAddress (key: Uint8Array | string | bigint, ss58Format = 42): string {2380    const u8a :Uint8Array = typeof key === 'string'2381      ? hexToU8a(key)2382      : typeof key === 'bigint'2383        ? hexToU8a(key.toString(16))2384        : key;2385  2386    if (ss58Format < 0 || ss58Format > 16383 || [46, 47].includes(ss58Format)) {2387      throw new Error(`ss58Format is not valid, received ${typeof ss58Format} "${ss58Format}"`);2388    }2389  2390    const allowedDecodedLengths = [1, 2, 4, 8, 32, 33];2391    if (!allowedDecodedLengths.includes(u8a.length)) {2392      throw new Error(`key length is not valid, received ${u8a.length}, valid values are ${allowedDecodedLengths.join(', ')}`);2393    }2394  2395    const u8aPrefix = ss58Format < 642396      ? new Uint8Array([ss58Format])2397      : new Uint8Array([2398        ((ss58Format & 0xfc) >> 2) | 0x40,2399        (ss58Format >> 8) | ((ss58Format & 0x03) << 6),2400      ]);24012402    const input = u8aConcat(u8aPrefix, u8a);2403  2404    return base58Encode(u8aConcat(2405      input,2406      blake2AsU8a(input).subarray(0, [32, 33].includes(u8a.length) ? 2 : 1),2407    ));2408  }24092410  /**2411   * Restore substrate address from bigint representation2412   * @param number decimal representation of substrate address2413   * @returns substrate address2414   */2415  restoreCrossAccountFromBigInt(number: bigint): TSubstrateAccount {2416    if (this.helper.api === null) {2417      throw 'Not connected';2418    }2419    const res = this.helper.api.registry.createType('AccountId', '0x' + number.toString(16).padStart(64, '0')).toJSON();2420    if (res === undefined || res === null) {2421      throw 'Restore address error';2422    }2423    return res.toString();2424  }24252426  /**2427   * Convert etherium cross account id to substrate cross account id2428   * @param ethCrossAccount etherium cross account2429   * @returns substrate cross account id2430   */2431  convertCrossAccountFromEthCrossAcoount(ethCrossAccount: IEthCrossAccountId): ICrossAccountId {2432    if (ethCrossAccount.field_1 === '0') {2433      return {Ethereum: ethCrossAccount.field_0.toLocaleLowerCase()};2434    }2435    2436    const ss58 = this.restoreCrossAccountFromBigInt(BigInt(ethCrossAccount.field_1));2437    return {Substrate: ss58};2438  }24392440  paraSiblingSovereignAccount(paraid: number) {2441    // We are getting a *sibling* parachain sovereign account,2442    // so we need a sibling prefix: encoded(b"sibl") == 0x7369626c2443    const siblingPrefix = '0x7369626c';24442445    const encodedParaId = this.helper.getApi().createType('u32', paraid).toHex(true).substring(2);2446    const suffix = '000000000000000000000000000000000000000000000000';24472448    return siblingPrefix + encodedParaId + suffix;2449  }2450}24512452class StakingGroup extends HelperGroup<UniqueHelper> {2453  /**2454   * Stake tokens for App Promotion2455   * @param signer keyring of signer2456   * @param amountToStake amount of tokens to stake2457   * @param label extra label for log2458   * @returns2459   */2460  async stake(signer: TSigner, amountToStake: bigint, label?: string): Promise<boolean> {2461    if(typeof label === 'undefined') label = `${signer.address} amount: ${amountToStake}`;2462    const _stakeResult = await this.helper.executeExtrinsic(2463      signer, 'api.tx.appPromotion.stake',2464      [amountToStake], true,2465    );2466    // TODO extract info from stakeResult2467    return true;2468  }24692470  /**2471   * Unstake tokens for App Promotion2472   * @param signer keyring of signer2473   * @param amountToUnstake amount of tokens to unstake2474   * @param label extra label for log2475   * @returns block number where balances will be unlocked2476   */2477  async unstake(signer: TSigner, label?: string): Promise<number> {2478    if(typeof label === 'undefined') label = `${signer.address}`;2479    const _unstakeResult = await this.helper.executeExtrinsic(2480      signer, 'api.tx.appPromotion.unstake',2481      [], true,2482    );2483    // TODO extract block number fron events2484    return 1;2485  }24862487  /**2488   * Get total staked amount for address2489   * @param address substrate or ethereum address2490   * @returns total staked amount2491   */2492  async getTotalStaked(address?: ICrossAccountId): Promise<bigint> {2493    if (address) return (await this.helper.callRpc('api.rpc.appPromotion.totalStaked', [address])).toBigInt();2494    return (await this.helper.callRpc('api.rpc.appPromotion.totalStaked')).toBigInt();2495  }24962497  /**2498   * Get total staked per block2499   * @param address substrate or ethereum address2500   * @returns array of stakes. `block` – the number of the block in which the stake was made. `amount` - the number of tokens staked in the block2501   */2502  async getTotalStakedPerBlock(address: ICrossAccountId): Promise<IStakingInfo[]> {2503    const rawTotalStakerdPerBlock = await this.helper.callRpc('api.rpc.appPromotion.totalStakedPerBlock', [address]);2504    return rawTotalStakerdPerBlock.map(([block, amount]: any[]) => {2505      return {2506        block: block.toBigInt(),2507        amount: amount.toBigInt(),2508      };2509    });2510  }25112512  /**2513   * Get total pending unstake amount for address2514   * @param address substrate or ethereum address2515   * @returns total pending unstake amount2516   */2517  async getPendingUnstake(address: ICrossAccountId): Promise<bigint> {2518    return (await this.helper.callRpc('api.rpc.appPromotion.pendingUnstake', [address])).toBigInt();2519  }25202521  /**2522   * Get pending unstake amount per block for address2523   * @param address substrate or ethereum address2524   * @returns array of pending stakes. `block` – the number of the block in which the unstake was made. `amount` - the number of tokens unstaked in the block2525   */2526  async getPendingUnstakePerBlock(address: ICrossAccountId): Promise<IStakingInfo[]> {2527    const rawUnstakedPerBlock = await this.helper.callRpc('api.rpc.appPromotion.pendingUnstakePerBlock', [address]);2528    const result = rawUnstakedPerBlock.map(([block, amount]: any[]) => {2529      return {2530        block: block.toBigInt(),2531        amount: amount.toBigInt(),2532      };2533    });2534    return result;2535  }2536}25372538class SchedulerGroup extends HelperGroup<UniqueHelper> {2539  constructor(helper: UniqueHelper) {2540    super(helper);2541  }25422543  async cancelScheduled(signer: TSigner, scheduledId: string) {2544    return this.helper.executeExtrinsic(2545      signer,2546      'api.tx.scheduler.cancelNamed',2547      [scheduledId],2548      true,2549    );2550  }25512552  async changePriority(signer: TSigner, scheduledId: string, priority: number) {2553    return this.helper.executeExtrinsic(2554      signer,2555      'api.tx.scheduler.changeNamedPriority',2556      [scheduledId, priority],2557      true,2558    );2559  }25602561  scheduleAt<T extends UniqueHelper>(2562    scheduledId: string,2563    executionBlockNumber: number,2564    options: ISchedulerOptions = {},2565  ) {2566    return this.schedule<T>('scheduleNamed', scheduledId, executionBlockNumber, options);2567  }25682569  scheduleAfter<T extends UniqueHelper>(2570    scheduledId: string,2571    blocksBeforeExecution: number,2572    options: ISchedulerOptions = {},2573  ) {2574    return this.schedule<T>('scheduleNamedAfter', scheduledId, blocksBeforeExecution, options);2575  }25762577  schedule<T extends UniqueHelper>(2578    scheduleFn: 'scheduleNamed' | 'scheduleNamedAfter',2579    scheduledId: string,2580    blocksNum: number,2581    options: ISchedulerOptions = {},2582  ) {2583    // eslint-disable-next-line @typescript-eslint/naming-convention2584    const ScheduledHelperType = ScheduledUniqueHelper(this.helper.helperBase);2585    return this.helper.clone(ScheduledHelperType, {2586      scheduleFn,2587      scheduledId,2588      blocksNum,2589      options,2590    }) as T;2591  }2592}25932594class ForeignAssetsGroup extends HelperGroup<UniqueHelper> {2595  async register(signer: TSigner, ownerAddress: TSubstrateAccount, location: any, metadata: IForeignAssetMetadata) {2596    await this.helper.executeExtrinsic(2597      signer,2598      'api.tx.foreignAssets.registerForeignAsset',2599      [ownerAddress, location, metadata],2600      true,2601    );2602  }26032604  async update(signer: TSigner, foreignAssetId: number, location: any, metadata: IForeignAssetMetadata) {2605    await this.helper.executeExtrinsic(2606      signer,2607      'api.tx.foreignAssets.updateForeignAsset',2608      [foreignAssetId, location, metadata],2609      true,2610    );2611  }2612}26132614class XcmGroup<T extends ChainHelperBase> extends HelperGroup<T> {2615  palletName: string;26162617  constructor(helper: T, palletName: string) {2618    super(helper);26192620    this.palletName = palletName;2621  }26222623  async limitedReserveTransferAssets(signer: TSigner, destination: any, beneficiary: any, assets: any, feeAssetItem: number, weightLimit: number) {2624    await this.helper.executeExtrinsic(signer, `api.tx.${this.palletName}.limitedReserveTransferAssets`, [destination, beneficiary, assets, feeAssetItem, {Limited: weightLimit}], true);2625  }2626}26272628class XTokensGroup<T extends ChainHelperBase> extends HelperGroup<T> {2629  async transfer(signer: TSigner, currencyId: any, amount: bigint, destination: any, destWeight: number) {2630    await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transfer', [currencyId, amount, destination, destWeight], true);2631  }26322633  async transferMultiasset(signer: TSigner, asset: any, destination: any, destWeight: number) {2634    await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transferMultiasset', [asset, destination, destWeight], true);2635  }26362637  async transferMulticurrencies(signer: TSigner, currencies: any[], feeItem: number, destLocation: any, destWeight: number) {2638    await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transferMulticurrencies', [currencies, feeItem, destLocation, destWeight], true);2639  }2640}26412642class TokensGroup<T extends ChainHelperBase> extends HelperGroup<T> {2643  async accounts(address: string, currencyId: any) {2644    const {free} = (await this.helper.callRpc('api.query.tokens.accounts', [address, currencyId])).toJSON() as any;2645    return BigInt(free);2646  }2647}26482649class AssetsGroup<T extends ChainHelperBase> extends HelperGroup<T> {2650  async create(signer: TSigner, assetId: number, admin: string, minimalBalance: bigint) {2651    await this.helper.executeExtrinsic(signer, 'api.tx.assets.create', [assetId, admin, minimalBalance], true);2652  }26532654  async setMetadata(signer: TSigner, assetId: number, name: string, symbol: string, decimals: number) {2655    await this.helper.executeExtrinsic(signer, 'api.tx.assets.setMetadata', [assetId, name, symbol, decimals], true);2656  }26572658  async mint(signer: TSigner, assetId: number, beneficiary: string, amount: bigint) {2659    await this.helper.executeExtrinsic(signer, 'api.tx.assets.mint', [assetId, beneficiary, amount], true);2660  }26612662  async account(assetId: string | number, address: string) {2663    const accountAsset = (2664      await this.helper.callRpc('api.query.assets.account', [assetId, address])2665    ).toJSON()! as any;26662667    if (accountAsset !== null) {2668      return BigInt(accountAsset['balance']);2669    } else {2670      return null;2671    }2672  }2673}26742675class AcalaAssetRegistryGroup extends HelperGroup<AcalaHelper> {2676  async registerForeignAsset(signer: TSigner, destination: any, metadata: AcalaAssetMetadata) {2677    await this.helper.executeExtrinsic(signer, 'api.tx.assetRegistry.registerForeignAsset', [destination, metadata], true);2678  }2679}26802681class MoonbeamAssetManagerGroup extends HelperGroup<MoonbeamHelper> {2682  makeRegisterForeignAssetProposal(assetInfo: MoonbeamAssetInfo) {2683    const apiPrefix = 'api.tx.assetManager.';26842685    const registerTx = this.helper.constructApiCall(2686      apiPrefix + 'registerForeignAsset',2687      [assetInfo.location, assetInfo.metadata, assetInfo.existentialDeposit, assetInfo.isSufficient],2688    );26892690    const setUnitsTx = this.helper.constructApiCall(2691      apiPrefix + 'setAssetUnitsPerSecond',2692      [assetInfo.location, assetInfo.unitsPerSecond, assetInfo.numAssetsWeightHint],2693    );26942695    const batchCall = this.helper.getApi().tx.utility.batchAll([registerTx, setUnitsTx]);2696    const encodedProposal = batchCall?.method.toHex() || '';2697    return encodedProposal;2698  }26992700  async assetTypeId(location: any) {2701    return await this.helper.callRpc('api.query.assetManager.assetTypeId', [location]);2702  }2703}27042705class MoonbeamDemocracyGroup extends HelperGroup<MoonbeamHelper> {2706  async notePreimage(signer: TSigner, encodedProposal: string) {2707    await this.helper.executeExtrinsic(signer, 'api.tx.democracy.notePreimage', [encodedProposal], true);2708  }27092710  externalProposeMajority(proposalHash: string) {2711    return this.helper.constructApiCall('api.tx.democracy.externalProposeMajority', [proposalHash]);2712  }27132714  fastTrack(proposalHash: string, votingPeriod: number, delayPeriod: number) {2715    return this.helper.constructApiCall('api.tx.democracy.fastTrack', [proposalHash, votingPeriod, delayPeriod]);2716  }27172718  async referendumVote(signer: TSigner, referendumIndex: number, accountVote: DemocracyStandardAccountVote) {2719    await this.helper.executeExtrinsic(signer, 'api.tx.democracy.vote', [referendumIndex, {Standard: accountVote}], true);2720  }2721}27222723class MoonbeamCollectiveGroup extends HelperGroup<MoonbeamHelper> {2724  collective: string;27252726  constructor(helper: MoonbeamHelper, collective: string) {2727    super(helper);27282729    this.collective = collective;2730  }27312732  async propose(signer: TSigner, threshold: number, proposalHash: string, lengthBound: number) {2733    await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.propose`, [threshold, proposalHash, lengthBound], true);2734  }27352736  async vote(signer: TSigner, proposalHash: string, proposalIndex: number, approve: boolean) {2737    await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.vote`, [proposalHash, proposalIndex, approve], true);2738  }27392740  async close(signer: TSigner, proposalHash: string, proposalIndex: number, weightBound: number, lengthBound: number) {2741    await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.close`, [proposalHash, proposalIndex, weightBound, lengthBound], true);2742  }27432744  async proposalCount() {2745    return Number(await this.helper.callRpc(`api.query.${this.collective}.proposalCount`, []));2746  }2747}27482749export type ChainHelperBaseConstructor = new(...args: any[]) => ChainHelperBase;2750export type UniqueHelperConstructor = new(...args: any[]) => UniqueHelper;27512752export class UniqueHelper extends ChainHelperBase {2753  balance: BalanceGroup<UniqueHelper>;2754  collection: CollectionGroup;2755  nft: NFTGroup;2756  rft: RFTGroup;2757  ft: FTGroup;2758  staking: StakingGroup;2759  scheduler: SchedulerGroup;2760  foreignAssets: ForeignAssetsGroup;2761  xcm: XcmGroup<UniqueHelper>;2762  xTokens: XTokensGroup<UniqueHelper>;2763  tokens: TokensGroup<UniqueHelper>;27642765  constructor(logger?: ILogger, options: {[key: string]: any} = {}) {2766    super(logger, options.helperBase ?? UniqueHelper);27672768    this.balance = new BalanceGroup(this);2769    this.collection = new CollectionGroup(this);2770    this.nft = new NFTGroup(this);2771    this.rft = new RFTGroup(this);2772    this.ft = new FTGroup(this);2773    this.staking = new StakingGroup(this);2774    this.scheduler = new SchedulerGroup(this);2775    this.foreignAssets = new ForeignAssetsGroup(this);2776    this.xcm = new XcmGroup(this, 'polkadotXcm');2777    this.xTokens = new XTokensGroup(this);2778    this.tokens = new TokensGroup(this);2779  }27802781  getSudo<T extends UniqueHelper>() {2782    // eslint-disable-next-line @typescript-eslint/naming-convention2783    const SudoHelperType = SudoHelper(this.helperBase);2784    return this.clone(SudoHelperType) as T;2785  }2786}27872788export class XcmChainHelper extends ChainHelperBase {2789  async connect(wsEndpoint: string, _listeners?: any): Promise<void> {2790    const wsProvider = new WsProvider(wsEndpoint);2791    this.api = new ApiPromise({2792      provider: wsProvider,2793    });2794    await this.api.isReadyOrError;2795    this.network = await UniqueHelper.detectNetwork(this.api);2796  }2797}27982799export class RelayHelper extends XcmChainHelper {2800  xcm: XcmGroup<RelayHelper>;28012802  constructor(logger?: ILogger, options: {[key: string]: any} = {}) {2803    super(logger, options.helperBase ?? RelayHelper);28042805    this.xcm = new XcmGroup(this, 'xcmPallet');2806  }2807}28082809export class WestmintHelper extends XcmChainHelper {2810  balance: SubstrateBalanceGroup<WestmintHelper>;2811  xcm: XcmGroup<WestmintHelper>;2812  assets: AssetsGroup<WestmintHelper>;2813  xTokens: XTokensGroup<WestmintHelper>;28142815  constructor(logger?: ILogger, options: {[key: string]: any} = {}) {2816    super(logger, options.helperBase ?? WestmintHelper);28172818    this.balance = new SubstrateBalanceGroup(this);2819    this.xcm = new XcmGroup(this, 'polkadotXcm');2820    this.assets = new AssetsGroup(this);2821    this.xTokens = new XTokensGroup(this);2822  }2823}28242825export class MoonbeamHelper extends XcmChainHelper {2826  balance: EthereumBalanceGroup<MoonbeamHelper>;2827  assetManager: MoonbeamAssetManagerGroup;2828  assets: AssetsGroup<MoonbeamHelper>;2829  xTokens: XTokensGroup<MoonbeamHelper>;2830  democracy: MoonbeamDemocracyGroup;2831  collective: {2832    council: MoonbeamCollectiveGroup,2833    techCommittee: MoonbeamCollectiveGroup,2834  };28352836  constructor(logger?: ILogger, options: {[key: string]: any} = {}) {2837    super(logger, options.helperBase ?? MoonbeamHelper);28382839    this.balance = new EthereumBalanceGroup(this);2840    this.assetManager = new MoonbeamAssetManagerGroup(this);2841    this.assets = new AssetsGroup(this);2842    this.xTokens = new XTokensGroup(this);2843    this.democracy = new MoonbeamDemocracyGroup(this);2844    this.collective = {2845      council: new MoonbeamCollectiveGroup(this, 'councilCollective'),2846      techCommittee: new MoonbeamCollectiveGroup(this, 'techCommitteeCollective'),2847    };2848  }2849}28502851export class AcalaHelper extends XcmChainHelper {2852  balance: SubstrateBalanceGroup<AcalaHelper>;2853  assetRegistry: AcalaAssetRegistryGroup;2854  xTokens: XTokensGroup<AcalaHelper>;2855  tokens: TokensGroup<AcalaHelper>;28562857  constructor(logger?: ILogger, options: {[key: string]: any} = {}) {2858    super(logger, options.helperBase ?? AcalaHelper);28592860    this.balance = new SubstrateBalanceGroup(this);2861    this.assetRegistry = new AcalaAssetRegistryGroup(this);2862    this.xTokens = new XTokensGroup(this);2863    this.tokens = new TokensGroup(this);2864  }28652866  getSudo<T extends AcalaHelper>() {2867    // eslint-disable-next-line @typescript-eslint/naming-convention2868    const SudoHelperType = SudoHelper(this.helperBase);2869    return this.clone(SudoHelperType) as T;2870  }2871}28722873// eslint-disable-next-line @typescript-eslint/naming-convention2874function ScheduledUniqueHelper<T extends UniqueHelperConstructor>(Base: T) {2875  return class extends Base {2876    scheduleFn: 'scheduleNamed' | 'scheduleNamedAfter';2877    scheduledId: string;2878    blocksNum: number;2879    options: ISchedulerOptions;28802881    constructor(...args: any[]) {2882      const logger = args[0] as ILogger;2883      const options = args[1] as {2884        scheduleFn: 'scheduleNamed' | 'scheduleNamedAfter',2885        scheduledId: string,2886        blocksNum: number,2887        options: ISchedulerOptions2888      };28892890      super(logger);28912892      this.scheduleFn = options.scheduleFn;2893      this.scheduledId = options.scheduledId;2894      this.blocksNum = options.blocksNum;2895      this.options = options.options;2896    }28972898    executeExtrinsic(sender: IKeyringPair, scheduledExtrinsic: string, scheduledParams: any[], expectSuccess?: boolean): Promise<ITransactionResult> {2899      const scheduledTx = this.constructApiCall(scheduledExtrinsic, scheduledParams);2900      const extrinsic = 'api.tx.scheduler.' +  this.scheduleFn;29012902      return super.executeExtrinsic(2903        sender,2904        extrinsic,2905        [2906          this.scheduledId,2907          this.blocksNum,2908          this.options.periodic ? [this.options.periodic.period, this.options.periodic.repetitions] : null,2909          this.options.priority ?? null,2910          scheduledTx,2911        ],2912        expectSuccess,2913      );2914    }2915  };2916}29172918// eslint-disable-next-line @typescript-eslint/naming-convention2919function SudoHelper<T extends ChainHelperBaseConstructor>(Base: T) {2920  return class extends Base {2921    constructor(...args: any[]) {2922      super(...args);2923    }29242925    executeExtrinsic (2926      sender: IKeyringPair,2927      extrinsic: string,2928      params: any[],2929      expectSuccess?: boolean,2930    ): Promise<ITransactionResult> {2931      const call = this.constructApiCall(extrinsic, params);2932      return super.executeExtrinsic(2933        sender,2934        'api.tx.sudo.sudo',2935        [call],2936        expectSuccess,2937      );2938    }2939  };2940}29412942export class UniqueBaseCollection {2943  helper: UniqueHelper;2944  collectionId: number;29452946  constructor(collectionId: number, uniqueHelper: UniqueHelper) {2947    this.collectionId = collectionId;2948    this.helper = uniqueHelper;2949  }29502951  async getData() {2952    return await this.helper.collection.getData(this.collectionId);2953  }29542955  async getLastTokenId() {2956    return await this.helper.collection.getLastTokenId(this.collectionId);2957  }29582959  async doesTokenExist(tokenId: number) {2960    return await this.helper.collection.doesTokenExist(this.collectionId, tokenId);2961  }29622963  async getAdmins() {2964    return await this.helper.collection.getAdmins(this.collectionId);2965  }29662967  async getAllowList() {2968    return await this.helper.collection.getAllowList(this.collectionId);2969  }29702971  async getEffectiveLimits() {2972    return await this.helper.collection.getEffectiveLimits(this.collectionId);2973  }29742975  async getProperties(propertyKeys?: string[] | null) {2976    return await this.helper.collection.getProperties(this.collectionId, propertyKeys);2977  }29782979  async getTokenNextSponsored(tokenId: number, addressObj: ICrossAccountId) {2980    return await this.helper.collection.getTokenNextSponsored(this.collectionId, tokenId, addressObj);2981  }29822983  async getOptions() {2984    return await this.helper.collection.getCollectionOptions(this.collectionId);2985  }29862987  async setSponsor(signer: TSigner, sponsorAddress: TSubstrateAccount) {2988    return await this.helper.collection.setSponsor(signer, this.collectionId, sponsorAddress);2989  }29902991  async confirmSponsorship(signer: TSigner) {2992    return await this.helper.collection.confirmSponsorship(signer, this.collectionId);2993  }29942995  async removeSponsor(signer: TSigner) {2996    return await this.helper.collection.removeSponsor(signer, this.collectionId);2997  }29982999  async setLimits(signer: TSigner, limits: ICollectionLimits) {3000    return await this.helper.collection.setLimits(signer, this.collectionId, limits);3001  }30023003  async changeOwner(signer: TSigner, ownerAddress: TSubstrateAccount) {3004    return await this.helper.collection.changeOwner(signer, this.collectionId, ownerAddress);3005  }30063007  async addAdmin(signer: TSigner, adminAddressObj: ICrossAccountId) {3008    return await this.helper.collection.addAdmin(signer, this.collectionId, adminAddressObj);3009  }30103011  async addToAllowList(signer: TSigner, addressObj: ICrossAccountId) {3012    return await this.helper.collection.addToAllowList(signer, this.collectionId, addressObj);3013  }30143015  async removeFromAllowList(signer: TSigner, addressObj: ICrossAccountId) {3016    return await this.helper.collection.removeFromAllowList(signer, this.collectionId, addressObj);3017  }30183019  async removeAdmin(signer: TSigner, adminAddressObj: ICrossAccountId) {3020    return await this.helper.collection.removeAdmin(signer, this.collectionId, adminAddressObj);3021  }30223023  async setProperties(signer: TSigner, properties: IProperty[]) {3024    return await this.helper.collection.setProperties(signer, this.collectionId, properties);3025  }30263027  async deleteProperties(signer: TSigner, propertyKeys: string[]) {3028    return await this.helper.collection.deleteProperties(signer, this.collectionId, propertyKeys);3029  }30303031  async setPermissions(signer: TSigner, permissions: ICollectionPermissions) {3032    return await this.helper.collection.setPermissions(signer, this.collectionId, permissions);3033  }30343035  async enableNesting(signer: TSigner, permissions: INestingPermissions) {3036    return await this.helper.collection.enableNesting(signer, this.collectionId, permissions);3037  }30383039  async disableNesting(signer: TSigner) {3040    return await this.helper.collection.disableNesting(signer, this.collectionId);3041  }30423043  async burn(signer: TSigner) {3044    return await this.helper.collection.burn(signer, this.collectionId);3045  }30463047  scheduleAt<T extends UniqueHelper>(3048    scheduledId: string,3049    executionBlockNumber: number,3050    options: ISchedulerOptions = {},3051  ) {3052    const scheduledHelper = this.helper.scheduler.scheduleAt<T>(scheduledId, executionBlockNumber, options);3053    return new UniqueBaseCollection(this.collectionId, scheduledHelper);3054  }30553056  scheduleAfter<T extends UniqueHelper>(3057    scheduledId: string,3058    blocksBeforeExecution: number,3059    options: ISchedulerOptions = {},3060  ) {3061    const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3062    return new UniqueBaseCollection(this.collectionId, scheduledHelper);3063  }30643065  getSudo<T extends UniqueHelper>() {3066    return new UniqueBaseCollection(this.collectionId, this.helper.getSudo<T>());3067  }3068}306930703071export class UniqueNFTCollection extends UniqueBaseCollection {3072  getTokenObject(tokenId: number) {3073    return new UniqueNFToken(tokenId, this);3074  }30753076  async getTokensByAddress(addressObj: ICrossAccountId) {3077    return await this.helper.nft.getTokensByAddress(this.collectionId, addressObj);3078  }30793080  async getToken(tokenId: number, blockHashAt?: string) {3081    return await this.helper.nft.getToken(this.collectionId, tokenId, [], blockHashAt);3082  }30833084  async getTokenOwner(tokenId: number, blockHashAt?: string) {3085    return await this.helper.nft.getTokenOwner(this.collectionId, tokenId, blockHashAt);3086  }30873088  async getTokenTopmostOwner(tokenId: number, blockHashAt?: string) {3089    return await this.helper.nft.getTokenTopmostOwner(this.collectionId, tokenId, blockHashAt);3090  }30913092  async getTokenChildren(tokenId: number, blockHashAt?: string) {3093    return await this.helper.nft.getTokenChildren(this.collectionId, tokenId, blockHashAt);3094  }30953096  async getPropertyPermissions(propertyKeys: string[] | null = null) {3097    return await this.helper.nft.getPropertyPermissions(this.collectionId, propertyKeys);3098  }30993100  async getTokenProperties(tokenId: number, propertyKeys?: string[] | null) {3101    return await this.helper.nft.getTokenProperties(this.collectionId, tokenId, propertyKeys);3102  }31033104  async transferToken(signer: TSigner, tokenId: number, addressObj: ICrossAccountId) {3105    return await this.helper.nft.transferToken(signer, this.collectionId, tokenId, addressObj);3106  }31073108  async transferTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3109    return await this.helper.nft.transferTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, toAddressObj);3110  }31113112  async approveToken(signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId) {3113    return await this.helper.nft.approveToken(signer, this.collectionId, tokenId, toAddressObj);3114  }31153116  async isTokenApproved(tokenId: number, toAddressObj: ICrossAccountId) {3117    return await this.helper.nft.isTokenApproved(this.collectionId, tokenId, toAddressObj);3118  }31193120  async mintToken(signer: TSigner, owner: ICrossAccountId = {Substrate: signer.address}, properties?: IProperty[]) {3121    return await this.helper.nft.mintToken(signer, {collectionId: this.collectionId, owner, properties});3122  }31233124  async mintMultipleTokens(signer: TSigner, tokens: {owner: ICrossAccountId, properties?: IProperty[]}[]) {3125    return await this.helper.nft.mintMultipleTokens(signer, this.collectionId, tokens);3126  }31273128  async burnToken(signer: TSigner, tokenId: number) {3129    return await this.helper.nft.burnToken(signer, this.collectionId, tokenId);3130  }31313132  async burnTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId) {3133    return await this.helper.nft.burnTokenFrom(signer, this.collectionId, tokenId, fromAddressObj);3134  }31353136  async setTokenProperties(signer: TSigner, tokenId: number, properties: IProperty[]) {3137    return await this.helper.nft.setTokenProperties(signer, this.collectionId, tokenId, properties);3138  }31393140  async deleteTokenProperties(signer: TSigner, tokenId: number, propertyKeys: string[]) {3141    return await this.helper.nft.deleteTokenProperties(signer, this.collectionId, tokenId, propertyKeys);3142  }31433144  async setTokenPropertyPermissions(signer: TSigner, permissions: ITokenPropertyPermission[]) {3145    return await this.helper.nft.setTokenPropertyPermissions(signer, this.collectionId, permissions);3146  }31473148  async nestToken(signer: TSigner, tokenId: number, toTokenObj: IToken) {3149    return await this.helper.nft.nestToken(signer, {collectionId: this.collectionId, tokenId}, toTokenObj);3150  }31513152  async unnestToken(signer: TSigner, tokenId: number, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {3153    return await this.helper.nft.unnestToken(signer, {collectionId: this.collectionId, tokenId}, fromTokenObj, toAddressObj);3154  }31553156  scheduleAt<T extends UniqueHelper>(3157    scheduledId: string,3158    executionBlockNumber: number,3159    options: ISchedulerOptions = {},3160  ) {3161    const scheduledHelper = this.helper.scheduler.scheduleAt<T>(scheduledId, executionBlockNumber, options);3162    return new UniqueNFTCollection(this.collectionId, scheduledHelper);3163  }31643165  scheduleAfter<T extends UniqueHelper>(3166    scheduledId: string,3167    blocksBeforeExecution: number,3168    options: ISchedulerOptions = {},3169  ) {3170    const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3171    return new UniqueNFTCollection(this.collectionId, scheduledHelper);3172  }31733174  getSudo<T extends UniqueHelper>() {3175    return new UniqueNFTCollection(this.collectionId, this.helper.getSudo<T>());3176  }3177}317831793180export class UniqueRFTCollection extends UniqueBaseCollection {3181  getTokenObject(tokenId: number) {3182    return new UniqueRFToken(tokenId, this);3183  }31843185  async getToken(tokenId: number, blockHashAt?: string) {3186    return await this.helper.rft.getToken(this.collectionId, tokenId, [], blockHashAt);3187  }31883189  async getTokensByAddress(addressObj: ICrossAccountId) {3190    return await this.helper.rft.getTokensByAddress(this.collectionId, addressObj);3191  }31923193  async getTop10TokenOwners(tokenId: number) {3194    return await this.helper.rft.getTokenTop10Owners(this.collectionId, tokenId);3195  }31963197  async getTokenBalance(tokenId: number, addressObj: ICrossAccountId) {3198    return await this.helper.rft.getTokenBalance(this.collectionId, tokenId, addressObj);3199  }32003201  async getTokenTotalPieces(tokenId: number) {3202    return await this.helper.rft.getTokenTotalPieces(this.collectionId, tokenId);3203  }32043205  async getTokenApprovedPieces(tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3206    return await this.helper.rft.getTokenApprovedPieces(this.collectionId, tokenId, toAddressObj, fromAddressObj);3207  }32083209  async getPropertyPermissions(propertyKeys: string[] | null = null) {3210    return await this.helper.rft.getPropertyPermissions(this.collectionId, propertyKeys);3211  }32123213  async getTokenProperties(tokenId: number, propertyKeys?: string[] | null) {3214    return await this.helper.rft.getTokenProperties(this.collectionId, tokenId, propertyKeys);3215  }32163217  async transferToken(signer: TSigner, tokenId: number, addressObj: ICrossAccountId, amount=1n) {3218    return await this.helper.rft.transferToken(signer, this.collectionId, tokenId, addressObj, amount);3219  }32203221  async transferTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n) {3222    return await this.helper.rft.transferTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, toAddressObj, amount);3223  }32243225  async approveToken(signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId, amount=1n) {3226    return await this.helper.rft.approveToken(signer, this.collectionId, tokenId, toAddressObj, amount);3227  }32283229  async repartitionToken(signer: TSigner, tokenId: number, amount: bigint) {3230    return await this.helper.rft.repartitionToken(signer, this.collectionId, tokenId, amount);3231  }32323233  async mintToken(signer: TSigner, pieces=1n, owner: ICrossAccountId = {Substrate: signer.address}, properties?: IProperty[]) {3234    return await this.helper.rft.mintToken(signer, {collectionId: this.collectionId, owner, pieces, properties});3235  }32363237  async mintMultipleTokens(signer: TSigner, tokens: {pieces: bigint, owner: ICrossAccountId, properties?: IProperty[]}[]) {3238    return await this.helper.rft.mintMultipleTokens(signer, this.collectionId, tokens);3239  }32403241  async burnToken(signer: TSigner, tokenId: number, amount=1n) {3242    return await this.helper.rft.burnToken(signer, this.collectionId, tokenId, amount);3243  }32443245  async burnTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId,  amount=1n) {3246    return await this.helper.rft.burnTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, amount);3247  }32483249  async setTokenProperties(signer: TSigner, tokenId: number, properties: IProperty[]) {3250    return await this.helper.rft.setTokenProperties(signer, this.collectionId, tokenId, properties);3251  }32523253  async deleteTokenProperties(signer: TSigner, tokenId: number, propertyKeys: string[]) {3254    return await this.helper.rft.deleteTokenProperties(signer, this.collectionId, tokenId, propertyKeys);3255  }32563257  async setTokenPropertyPermissions(signer: TSigner, permissions: ITokenPropertyPermission[]) {3258    return await this.helper.rft.setTokenPropertyPermissions(signer, this.collectionId, permissions);3259  }32603261  scheduleAt<T extends UniqueHelper>(3262    scheduledId: string,3263    executionBlockNumber: number,3264    options: ISchedulerOptions = {},3265  ) {3266    const scheduledHelper = this.helper.scheduler.scheduleAt<T>(scheduledId, executionBlockNumber, options);3267    return new UniqueRFTCollection(this.collectionId, scheduledHelper);3268  }32693270  scheduleAfter<T extends UniqueHelper>(3271    scheduledId: string,3272    blocksBeforeExecution: number,3273    options: ISchedulerOptions = {},3274  ) {3275    const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3276    return new UniqueRFTCollection(this.collectionId, scheduledHelper);3277  }32783279  getSudo<T extends UniqueHelper>() {3280    return new UniqueRFTCollection(this.collectionId, this.helper.getSudo<T>());3281  }3282}328332843285export class UniqueFTCollection extends UniqueBaseCollection {3286  async getBalance(addressObj: ICrossAccountId) {3287    return await this.helper.ft.getBalance(this.collectionId, addressObj);3288  }32893290  async getTotalPieces() {3291    return await this.helper.ft.getTotalPieces(this.collectionId);3292  }32933294  async getApprovedTokens(fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3295    return await this.helper.ft.getApprovedTokens(this.collectionId, fromAddressObj, toAddressObj);3296  }32973298  async getTop10Owners() {3299    return await this.helper.ft.getTop10Owners(this.collectionId);3300  }33013302  async mint(signer: TSigner, amount=1n, owner: ICrossAccountId = {Substrate: signer.address}) {3303    return await this.helper.ft.mintTokens(signer, this.collectionId, amount, owner);3304  }33053306  async mintWithOneOwner(signer: TSigner, tokens: {value: bigint}[], owner: ICrossAccountId = {Substrate: signer.address}) {3307    return await this.helper.ft.mintMultipleTokensWithOneOwner(signer, this.collectionId, tokens, owner);3308  }33093310  async transfer(signer: TSigner, toAddressObj: ICrossAccountId, amount=1n) {3311    return await this.helper.ft.transfer(signer, this.collectionId, toAddressObj, amount);3312  }33133314  async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n) {3315    return await this.helper.ft.transferFrom(signer, this.collectionId, fromAddressObj, toAddressObj, amount);3316  }33173318  async burnTokens(signer: TSigner, amount=1n) {3319    return await this.helper.ft.burnTokens(signer, this.collectionId, amount);3320  }33213322  async burnTokensFrom(signer: TSigner, fromAddressObj: ICrossAccountId, amount=1n) {3323    return await this.helper.ft.burnTokensFrom(signer, this.collectionId, fromAddressObj, amount);3324  }33253326  async approveTokens(signer: TSigner, toAddressObj: ICrossAccountId, amount=1n) {3327    return await this.helper.ft.approveTokens(signer, this.collectionId, toAddressObj, amount);3328  }33293330  scheduleAt<T extends UniqueHelper>(3331    scheduledId: string,3332    executionBlockNumber: number,3333    options: ISchedulerOptions = {},3334  ) {3335    const scheduledHelper = this.helper.scheduler.scheduleAt<T>(scheduledId, executionBlockNumber, options);3336    return new UniqueFTCollection(this.collectionId, scheduledHelper);3337  }33383339  scheduleAfter<T extends UniqueHelper>(3340    scheduledId: string,3341    blocksBeforeExecution: number,3342    options: ISchedulerOptions = {},3343  ) {3344    const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3345    return new UniqueFTCollection(this.collectionId, scheduledHelper);3346  }33473348  getSudo<T extends UniqueHelper>() {3349    return new UniqueFTCollection(this.collectionId, this.helper.getSudo<T>());3350  }3351}335233533354export class UniqueBaseToken {3355  collection: UniqueNFTCollection | UniqueRFTCollection;3356  collectionId: number;3357  tokenId: number;33583359  constructor(tokenId: number, collection: UniqueNFTCollection | UniqueRFTCollection) {3360    this.collection = collection;3361    this.collectionId = collection.collectionId;3362    this.tokenId = tokenId;3363  }33643365  async getNextSponsored(addressObj: ICrossAccountId) {3366    return await this.collection.getTokenNextSponsored(this.tokenId, addressObj);3367  }33683369  async getProperties(propertyKeys?: string[] | null) {3370    return await this.collection.getTokenProperties(this.tokenId, propertyKeys);3371  }33723373  async setProperties(signer: TSigner, properties: IProperty[]) {3374    return await this.collection.setTokenProperties(signer, this.tokenId, properties);3375  }33763377  async deleteProperties(signer: TSigner, propertyKeys: string[]) {3378    return await this.collection.deleteTokenProperties(signer, this.tokenId, propertyKeys);3379  }33803381  async doesExist() {3382    return await this.collection.doesTokenExist(this.tokenId);3383  }33843385  nestingAccount() {3386    return this.collection.helper.util.getTokenAccount(this);3387  }33883389  scheduleAt<T extends UniqueHelper>(3390    scheduledId: string,3391    executionBlockNumber: number,3392    options: ISchedulerOptions = {},3393  ) {3394    const scheduledCollection = this.collection.scheduleAt<T>(scheduledId, executionBlockNumber, options);3395    return new UniqueBaseToken(this.tokenId, scheduledCollection);3396  }33973398  scheduleAfter<T extends UniqueHelper>(3399    scheduledId: string,3400    blocksBeforeExecution: number,3401    options: ISchedulerOptions = {},3402  ) {3403    const scheduledCollection = this.collection.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3404    return new UniqueBaseToken(this.tokenId, scheduledCollection);3405  }34063407  getSudo<T extends UniqueHelper>() {3408    return new UniqueBaseToken(this.tokenId, this.collection.getSudo<T>());3409  }3410}341134123413export class UniqueNFToken extends UniqueBaseToken {3414  collection: UniqueNFTCollection;34153416  constructor(tokenId: number, collection: UniqueNFTCollection) {3417    super(tokenId, collection);3418    this.collection = collection;3419  }34203421  async getData(blockHashAt?: string) {3422    return await this.collection.getToken(this.tokenId, blockHashAt);3423  }34243425  async getOwner(blockHashAt?: string) {3426    return await this.collection.getTokenOwner(this.tokenId, blockHashAt);3427  }34283429  async getTopmostOwner(blockHashAt?: string) {3430    return await this.collection.getTokenTopmostOwner(this.tokenId, blockHashAt);3431  }34323433  async getChildren(blockHashAt?: string) {3434    return await this.collection.getTokenChildren(this.tokenId, blockHashAt);3435  }34363437  async nest(signer: TSigner, toTokenObj: IToken) {3438    return await this.collection.nestToken(signer, this.tokenId, toTokenObj);3439  }34403441  async unnest(signer: TSigner, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {3442    return await this.collection.unnestToken(signer, this.tokenId, fromTokenObj, toAddressObj);3443  }34443445  async transfer(signer: TSigner, addressObj: ICrossAccountId) {3446    return await this.collection.transferToken(signer, this.tokenId, addressObj);3447  }34483449  async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3450    return await this.collection.transferTokenFrom(signer, this.tokenId, fromAddressObj, toAddressObj);3451  }34523453  async approve(signer: TSigner, toAddressObj: ICrossAccountId) {3454    return await this.collection.approveToken(signer, this.tokenId, toAddressObj);3455  }34563457  async isApproved(toAddressObj: ICrossAccountId) {3458    return await this.collection.isTokenApproved(this.tokenId, toAddressObj);3459  }34603461  async burn(signer: TSigner) {3462    return await this.collection.burnToken(signer, this.tokenId);3463  }34643465  async burnFrom(signer: TSigner, fromAddressObj: ICrossAccountId) {3466    return await this.collection.burnTokenFrom(signer, this.tokenId, fromAddressObj);3467  }34683469  scheduleAt<T extends UniqueHelper>(3470    scheduledId: string,3471    executionBlockNumber: number,3472    options: ISchedulerOptions = {},3473  ) {3474    const scheduledCollection = this.collection.scheduleAt<T>(scheduledId, executionBlockNumber, options);3475    return new UniqueNFToken(this.tokenId, scheduledCollection);3476  }34773478  scheduleAfter<T extends UniqueHelper>(3479    scheduledId: string,3480    blocksBeforeExecution: number,3481    options: ISchedulerOptions = {},3482  ) {3483    const scheduledCollection = this.collection.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3484    return new UniqueNFToken(this.tokenId, scheduledCollection);3485  }34863487  getSudo<T extends UniqueHelper>() {3488    return new UniqueNFToken(this.tokenId, this.collection.getSudo<T>());3489  }3490}34913492export class UniqueRFToken extends UniqueBaseToken {3493  collection: UniqueRFTCollection;34943495  constructor(tokenId: number, collection: UniqueRFTCollection) {3496    super(tokenId, collection);3497    this.collection = collection;3498  }34993500  async getData(blockHashAt?: string) {3501    return await this.collection.getToken(this.tokenId, blockHashAt);3502  }35033504  async getTop10Owners() {3505    return await this.collection.getTop10TokenOwners(this.tokenId);3506  }35073508  async getBalance(addressObj: ICrossAccountId) {3509    return await this.collection.getTokenBalance(this.tokenId, addressObj);3510  }35113512  async getTotalPieces() {3513    return await this.collection.getTokenTotalPieces(this.tokenId);3514  }35153516  async getApprovedPieces(fromAddressObj: ICrossAccountId, toAccountObj: ICrossAccountId) {3517    return await this.collection.getTokenApprovedPieces(this.tokenId, fromAddressObj, toAccountObj);3518  }35193520  async transfer(signer: TSigner, addressObj: ICrossAccountId, amount=1n) {3521    return await this.collection.transferToken(signer, this.tokenId, addressObj, amount);3522  }35233524  async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount=1n) {3525    return await this.collection.transferTokenFrom(signer, this.tokenId, fromAddressObj, toAddressObj, amount);3526  }35273528  async approve(signer: TSigner, toAddressObj: ICrossAccountId, amount=1n) {3529    return await this.collection.approveToken(signer, this.tokenId, toAddressObj, amount);3530  }35313532  async repartition(signer: TSigner, amount: bigint) {3533    return await this.collection.repartitionToken(signer, this.tokenId, amount);3534  }35353536  async burn(signer: TSigner, amount=1n) {3537    return await this.collection.burnToken(signer, this.tokenId, amount);3538  }35393540  async burnFrom(signer: TSigner, fromAddressObj: ICrossAccountId, amount=1n) {3541    return await this.collection.burnTokenFrom(signer, this.tokenId, fromAddressObj, amount);3542  }35433544  scheduleAt<T extends UniqueHelper>(3545    scheduledId: string,3546    executionBlockNumber: number,3547    options: ISchedulerOptions = {},3548  ) {3549    const scheduledCollection = this.collection.scheduleAt<T>(scheduledId, executionBlockNumber, options);3550    return new UniqueRFToken(this.tokenId, scheduledCollection);3551  }35523553  scheduleAfter<T extends UniqueHelper>(3554    scheduledId: string,3555    blocksBeforeExecution: number,3556    options: ISchedulerOptions = {},3557  ) {3558    const scheduledCollection = this.collection.scheduleAfter<T>(scheduledId, blocksBeforeExecution, options);3559    return new UniqueRFToken(this.tokenId, scheduledCollection);3560  }35613562  getSudo<T extends UniqueHelper>() {3563    return new UniqueRFToken(this.tokenId, this.collection.getSudo<T>());3564  }3565}