`f00271a42d7d`

source

tests/src/util/helpers.ts23.3 KiBsource history
1//2// This file is subject to the terms and conditions defined in3// file 'LICENSE', which is part of this source code package.4//56import { ApiPromise, Keyring } from '@polkadot/api';7import { Enum, Struct } from '@polkadot/types/codec';8import type { AccountId, EventRecord } from '@polkadot/types/interfaces';9import { u128 } from '@polkadot/types/primitive';10import { IKeyringPair } from '@polkadot/types/types';11import { BigNumber } from 'bignumber.js';12import BN from 'bn.js';13import chai from 'chai';14import chaiAsPromised from 'chai-as-promised';15import { alicesPublicKey, nullPublicKey } from '../accounts';16import privateKey from '../substrate/privateKey';17import { default as usingApi, submitTransactionAsync, submitTransactionExpectFailAsync } from '../substrate/substrate-api';18import { ICollectionInterface } from '../types';19import { hexToStr, strToUTF16, utf16ToStr } from './util';2021chai.use(chaiAsPromised);22const expect = chai.expect;2324type GenericResult = {25  success: boolean,26};2728interface CreateCollectionResult {29  success: boolean;30  collectionId: number;31}3233interface CreateItemResult {34  success: boolean;35  collectionId: number;36  itemId: number;37}3839interface IReFungibleOwner {40  Fraction: BN;41  Owner: number[];42}4344interface ITokenDataType {45  Owner: number[];46  ConstData: number[];47  VariableData: number[];48}4950interface IFungibleTokenDataType {51  Value: BN;52}5354interface IReFungibleTokenDataType {55  Owner: IReFungibleOwner[];56  ConstData: number[];57  VariableData: number[];58}5960export function getGenericResult(events: EventRecord[]): GenericResult {61  const result: GenericResult = {62    success: false,63  };64  events.forEach(({ phase, event: { data, method, section } }) => {65    // console.log(`    ${phase}: ${section}.${method}:: ${data}`);66    if (method === 'ExtrinsicSuccess') {67      result.success = true;68    }69  });70  return result;71}7273export function getCreateCollectionResult(events: EventRecord[]): CreateCollectionResult {74  let success = false;75  let collectionId: number = 0;76  events.forEach(({ phase, event: { data, method, section } }) => {77    // console.log(`    ${phase}: ${section}.${method}:: ${data}`);78    if (method == 'ExtrinsicSuccess') {79      success = true;80    } else if ((section == 'nft') && (method == 'Created')) {81      collectionId = parseInt(data[0].toString());82    }83  });84  const result: CreateCollectionResult = {85    success,86    collectionId,87  };88  return result;89}9091export function getCreateItemResult(events: EventRecord[]): CreateItemResult {92  let success = false;93  let collectionId: number = 0;94  let itemId: number = 0;95  events.forEach(({ phase, event: { data, method, section } }) => {96    // console.log(`    ${phase}: ${section}.${method}:: ${data}`);97    if (method == 'ExtrinsicSuccess') {98      success = true;99    } else if ((section == 'nft') && (method == 'ItemCreated')) {100      collectionId = parseInt(data[0].toString());101      itemId = parseInt(data[1].toString());102    }103  });104  const result: CreateItemResult = {105    success,106    collectionId,107    itemId,108  };109  return result;110}111112interface Invalid {113  type: 'Invalid';114}115116interface Nft {117  type: 'NFT';118}119120interface Fungible {121  type: 'Fungible';122  decimalPoints: number;123}124125interface ReFungible {126  type: 'ReFungible';127  decimalPoints: number;128}129130interface Nft {131  type: 'NFT'132}133134interface Fungible {135  type: 'Fungible',136  decimalPoints: number137}138139interface ReFungible {140  type: 'ReFungible',141  decimalPoints: number142}143144type CollectionMode = Nft | Fungible | ReFungible | Invalid;145146export type CreateCollectionParams = {147  mode: CollectionMode,148  name: string,149  description: string,150  tokenPrefix: string,151};152153const defaultCreateCollectionParams: CreateCollectionParams = {154  description: 'description',155  mode: { type: 'NFT' },156  name: 'name',157  tokenPrefix: 'prefix',158}159160export async function createCollectionExpectSuccess(params: Partial<CreateCollectionParams> = {}): Promise<number> {161  const {name, description, mode, tokenPrefix } = {...defaultCreateCollectionParams, ...params};162163  let collectionId: number = 0;164  await usingApi(async (api) => {165    // Get number of collections before the transaction166    const AcollectionCount = parseInt((await api.query.nft.createdCollectionCount()).toString(), 10);167168    // Run the CreateCollection transaction169    const alicePrivateKey = privateKey('//Alice');170171    let modeprm = {};172    if (mode.type === 'NFT') {173      modeprm = {nft: null};174    } else if (mode.type === 'Fungible') {175      modeprm = {fungible: mode.decimalPoints};176    } else if (mode.type === 'ReFungible') {177      modeprm = {refungible: mode.decimalPoints};178    } else if (mode.type === 'Invalid') {179      modeprm = {invalid: null};180    }181182    const tx = api.tx.nft.createCollection(strToUTF16(name), strToUTF16(description), strToUTF16(tokenPrefix), modeprm);183    const events = await submitTransactionAsync(alicePrivateKey, tx);184    const result = getCreateCollectionResult(events);185186    // Get number of collections after the transaction187    const BcollectionCount = parseInt((await api.query.nft.createdCollectionCount()).toString(), 10);188189    // Get the collection190    const collection: any = (await api.query.nft.collection(result.collectionId)).toJSON();191192    // What to expect193    // tslint:disable-next-line:no-unused-expression194    expect(result.success).to.be.true;195    expect(result.collectionId).to.be.equal(BcollectionCount);196    // tslint:disable-next-line:no-unused-expression197    expect(collection).to.be.not.null;198    expect(BcollectionCount).to.be.equal(AcollectionCount + 1, 'Error: NFT collection NOT created.');199    expect(collection.Owner).to.be.equal(alicesPublicKey);200    expect(utf16ToStr(collection.Name)).to.be.equal(name);201    expect(utf16ToStr(collection.Description)).to.be.equal(description);202    expect(hexToStr(collection.TokenPrefix)).to.be.equal(tokenPrefix);203204    collectionId = result.collectionId;205  });206207  return collectionId;208}209210export async function createCollectionExpectFailure(params: Partial<CreateCollectionParams> = {}) {211  const {name, description, mode, tokenPrefix } = {...defaultCreateCollectionParams, ...params};212213  let modeprm = {};214  if (mode.type === 'NFT') {215    modeprm = {nft: null};216  } else if (mode.type === 'Fungible') {217    modeprm = {fungible: mode.decimalPoints};218  } else if (mode.type === 'ReFungible') {219    modeprm = {refungible: mode.decimalPoints};220  } else if (mode.type === 'Invalid') {221    modeprm = {invalid: null};222  }223224  await usingApi(async (api) => {225    // Get number of collections before the transaction226    const AcollectionCount = parseInt((await api.query.nft.createdCollectionCount()).toString());227228    // Run the CreateCollection transaction229    const alicePrivateKey = privateKey('//Alice');230    const tx = api.tx.nft.createCollection(strToUTF16(name), strToUTF16(description), strToUTF16(tokenPrefix), modeprm);231    const events = await expect(submitTransactionExpectFailAsync(alicePrivateKey, tx)).to.be.rejected;232    const result = getCreateCollectionResult(events);233234    // Get number of collections after the transaction235    const BcollectionCount = parseInt((await api.query.nft.createdCollectionCount()).toString());236237    // What to expect238    // tslint:disable-next-line:no-unused-expression239    expect(result.success).to.be.false;240    expect(BcollectionCount).to.be.equal(AcollectionCount, 'Error: Collection with incorrect data created.');241  });242}243244export async function findUnusedAddress(api: ApiPromise): Promise<IKeyringPair> {245  let bal = new BigNumber(0);246  let unused;247  do {248    const randomSeed = 'seed' +  Math.floor(Math.random() * Math.floor(10000));249    const keyring = new Keyring({ type: 'sr25519' });250    unused = keyring.addFromUri(`//${randomSeed}`);251    bal = new BigNumber((await api.query.system.account(unused.address)).data.free.toString());252  } while (bal.toFixed() != '0');253  return unused;254}255256function getDestroyResult(events: EventRecord[]): boolean {257  let success: boolean = false;258  events.forEach(({ phase, event: { data, method, section } }) => {259    // console.log(`    ${phase}: ${section}.${method}:: ${data}`);260    if (method == 'ExtrinsicSuccess') {261      success = true;262    }263  });264  return success;265}266267export async function destroyCollectionExpectFailure(collectionId: number, senderSeed: string = '//Alice') {268  await usingApi(async (api) => {269    // Run the DestroyCollection transaction270    const alicePrivateKey = privateKey(senderSeed);271    const tx = api.tx.nft.destroyCollection(collectionId);272    await expect(submitTransactionExpectFailAsync(alicePrivateKey, tx)).to.be.rejected;273  });274}275276export async function destroyCollectionExpectSuccess(collectionId: number, senderSeed: string = '//Alice') {277  await usingApi(async (api) => {278    // Run the DestroyCollection transaction279    const alicePrivateKey = privateKey(senderSeed);280    const tx = api.tx.nft.destroyCollection(collectionId);281    const events = await submitTransactionAsync(alicePrivateKey, tx);282    const result = getDestroyResult(events);283284    // Get the collection285    const collection: any = (await api.query.nft.collection(collectionId)).toJSON();286287    // What to expect288    expect(result).to.be.true;289    expect(collection).to.be.not.null;290    expect(collection.Owner).to.be.equal(nullPublicKey);291  });292}293294export async function setCollectionSponsorExpectSuccess(collectionId: number, sponsor: string) {295  await usingApi(async (api) => {296297    // Run the transaction298    const alicePrivateKey = privateKey('//Alice');299    const tx = api.tx.nft.setCollectionSponsor(collectionId, sponsor);300    const events = await submitTransactionAsync(alicePrivateKey, tx);301    const result = getGenericResult(events);302303    // Get the collection304    const collection: any = (await api.query.nft.collection(collectionId)).toJSON();305306    // What to expect307    expect(result.success).to.be.true;308    expect(collection.Sponsor.toString()).to.be.equal(sponsor.toString());309    expect(collection.SponsorConfirmed).to.be.false;310  });311}312313export async function removeCollectionSponsorExpectSuccess(collectionId: number) {314  await usingApi(async (api) => {315316    // Run the transaction317    const alicePrivateKey = privateKey('//Alice');318    const tx = api.tx.nft.removeCollectionSponsor(collectionId);319    const events = await submitTransactionAsync(alicePrivateKey, tx);320    const result = getGenericResult(events);321322    // Get the collection323    const collection: any = (await api.query.nft.collection(collectionId)).toJSON();324325    // What to expect326    expect(result.success).to.be.true;327    expect(collection.Sponsor).to.be.equal(nullPublicKey);328    expect(collection.SponsorConfirmed).to.be.false;329  });330}331332export async function removeCollectionSponsorExpectFailure(collectionId: number) {333  await usingApi(async (api) => {334335    // Run the transaction336    const alicePrivateKey = privateKey('//Alice');337    const tx = api.tx.nft.removeCollectionSponsor(collectionId);338    await expect(submitTransactionExpectFailAsync(alicePrivateKey, tx)).to.be.rejected;339  });340}341342export async function setCollectionSponsorExpectFailure(collectionId: number, sponsor: string, senderSeed: string = '//Alice') {343  await usingApi(async (api) => {344345    // Run the transaction346    const alicePrivateKey = privateKey(senderSeed);347    const tx = api.tx.nft.setCollectionSponsor(collectionId, sponsor);348    await expect(submitTransactionExpectFailAsync(alicePrivateKey, tx)).to.be.rejected;349  });350}351352export async function confirmSponsorshipExpectSuccess(collectionId: number, senderSeed: string = '//Alice') {353  await usingApi(async (api) => {354355    // Run the transaction356    const sender = privateKey(senderSeed);357    const tx = api.tx.nft.confirmSponsorship(collectionId);358    const events = await submitTransactionAsync(sender, tx);359    const result = getGenericResult(events);360361    // Get the collection362    const collection: any = (await api.query.nft.collection(collectionId)).toJSON();363364    // What to expect365    expect(result.success).to.be.true;366    expect(collection.Sponsor).to.be.equal(sender.address);367    expect(collection.SponsorConfirmed).to.be.true;368  });369}370371export async function confirmSponsorshipExpectFailure(collectionId: number, senderSeed: string = '//Alice') {372  await usingApi(async (api) => {373374    // Run the transaction375    const sender = privateKey(senderSeed);376    const tx = api.tx.nft.confirmSponsorship(collectionId);377    await expect(submitTransactionExpectFailAsync(sender, tx)).to.be.rejected;378  });379}380381export interface CreateFungibleData extends Struct {382  readonly value: u128;383}384385export interface CreateReFungibleData extends Struct {}386export interface CreateNftData extends Struct {}387388export interface CreateItemData extends Enum {389  NFT: CreateNftData;390  Fungible: CreateFungibleData;391  ReFungible: CreateReFungibleData;392}393394export async function burnItemExpectSuccess(owner: IKeyringPair, collectionId: number, tokenId: number, value = 0) {395  await usingApi(async (api) => {396    const tx = api.tx.nft.burnItem(collectionId, tokenId, value);397    const events = await submitTransactionAsync(owner, tx);398    const result = getGenericResult(events);399    // Get the item400    const item: any = (await api.query.nft.nftItemList(collectionId, tokenId)).toJSON();401    // What to expect402    // tslint:disable-next-line:no-unused-expression403    expect(result.success).to.be.true;404    // tslint:disable-next-line:no-unused-expression405    expect(item).to.be.not.null;406    expect(item.Owner).to.be.equal(nullPublicKey);407  });408}409410export async function411approveExpectSuccess(collectionId: number,412                     tokenId: number, owner: IKeyringPair, approved: IKeyringPair, amount: number = 1) {413  await usingApi(async (api: ApiPromise) => {414    const allowanceBefore =415      await api.query.nft.allowances(collectionId, [tokenId, owner.address, approved.address]) as unknown as BN;416    const approveNftTx = await api.tx.nft.approve(approved.address, collectionId, tokenId, amount);417    const events = await submitTransactionAsync(owner, approveNftTx);418    const result = getCreateItemResult(events);419    // tslint:disable-next-line:no-unused-expression420    expect(result.success).to.be.true;421    const allowanceAfter =422      await api.query.nft.allowances(collectionId, [tokenId, owner.address, approved.address]) as unknown as BN;423    expect(allowanceAfter.toNumber() - allowanceBefore.toNumber()).to.be.equal(amount);424  });425}426427export async function428transferFromExpectSuccess(collectionId: number,429                          tokenId: number,430                          accountApproved: IKeyringPair,431                          accountFrom: IKeyringPair,432                          accountTo: IKeyringPair,433                          value: number = 1,434                          type: string = 'NFT') {435  await usingApi(async (api: ApiPromise) => {436    let balanceBefore = new BN(0);437    if (type === 'Fungible') {438      balanceBefore = await api.query.nft.balance(collectionId, accountTo.address) as unknown as BN;439    }440    const transferFromTx = await api.tx.nft.transferFrom(441      accountFrom.address, accountTo.address, collectionId, tokenId, value);442    const events = await submitTransactionAsync(accountFrom, transferFromTx);443    const result = getCreateItemResult(events);444    // tslint:disable-next-line:no-unused-expression445    expect(result.success).to.be.true;446    if (type === 'NFT') {447      const nftItemData = await api.query.nft.nftItemList(collectionId, tokenId) as unknown as ITokenDataType;448      expect(nftItemData.Owner.toString()).to.be.equal(accountTo.address);449    }450    if (type === 'Fungible') {451      const balanceAfter = await api.query.nft.balance(collectionId, accountTo.address) as unknown as BN;452      expect(balanceAfter.sub(balanceBefore).toNumber()).to.be.equal(value);453    }454    if (type === 'ReFungible') {455      const nftItemData =456        await api.query.nft.reFungibleItemList(collectionId, tokenId) as unknown as IReFungibleTokenDataType;457      expect(nftItemData.Owner[0].Owner.toString()).to.be.equal(accountTo.address);458      expect(nftItemData.Owner[0].Fraction.toNumber()).to.be.equal(value);459    }460  });461}462463export async function464transferFromExpectFail(collectionId: number,465                       tokenId: number,466                       accountApproved: IKeyringPair,467                       accountFrom: IKeyringPair,468                       accountTo: IKeyringPair,469                       value: number = 1) {470  await usingApi(async (api: ApiPromise) => {471    const transferFromTx = await api.tx.nft.transferFrom(472      accountFrom.address, accountTo.address, collectionId, tokenId, value);473    const events = await expect(submitTransactionExpectFailAsync(accountApproved, transferFromTx)).to.be.rejected;474    const result = getCreateCollectionResult(events);475    // tslint:disable-next-line:no-unused-expression476    expect(result.success).to.be.false;477  });478}479480export async function481transferExpectSuccess(collectionId: number,482                      tokenId: number,483                      sender: IKeyringPair,484                      recipient: IKeyringPair,485                      value: number = 1,486                      type: string = 'NFT') {487  await usingApi(async (api: ApiPromise) => {488    let balanceBefore = new BN(0);489    if (type === 'Fungible') {490      balanceBefore = await api.query.nft.balance(collectionId, recipient.address) as unknown as BN;491    }492    const transferTx = await api.tx.nft.transfer(recipient.address, collectionId, tokenId, value);493    const events = await submitTransactionAsync(sender, transferTx);494    const result = getCreateItemResult(events);495    // tslint:disable-next-line:no-unused-expression496    expect(result.success).to.be.true;497    if (type === 'NFT') {498      const nftItemData = await api.query.nft.nftItemList(collectionId, tokenId) as unknown as ITokenDataType;499      expect(nftItemData.Owner.toString()).to.be.equal(recipient.address);500    }501    if (type === 'Fungible') {502      const balanceAfter = await api.query.nft.balance(collectionId, recipient.address) as unknown as BN;503      expect(balanceAfter.sub(balanceBefore).toNumber()).to.be.equal(value);504    }505    if (type === 'ReFungible') {506      const nftItemData =507        await api.query.nft.reFungibleItemList(collectionId, tokenId) as unknown as IReFungibleTokenDataType;508      expect(nftItemData.Owner[0].Owner.toString()).to.be.equal(recipient.address);509      expect(nftItemData.Owner[0].Fraction.toNumber()).to.be.equal(value);510    }511  });512}513514export async function515transferExpectFail(collectionId: number,516                   tokenId: number,517                   sender: IKeyringPair,518                   recipient: IKeyringPair,519                   value: number = 1,520                   type: string = 'NFT') {521  await usingApi(async (api: ApiPromise) => {522    const transferTx = await api.tx.nft.transfer(recipient.address, collectionId, tokenId, value);523    const events = await expect(submitTransactionExpectFailAsync(sender, transferTx)).to.be.rejected;524    if (events && Array.isArray(events)) {525      const result = getCreateCollectionResult(events);526      // tslint:disable-next-line:no-unused-expression527      expect(result.success).to.be.false;528    }529  });530}531532export async function533approveExpectFail(collectionId: number,534                  tokenId: number, owner: IKeyringPair, approved: IKeyringPair, amount: number = 1) {535  await usingApi(async (api: ApiPromise) => {536    const approveNftTx = await api.tx.nft.approve(approved.address, collectionId, tokenId, amount);537    const events = await expect(submitTransactionExpectFailAsync(owner, approveNftTx)).to.be.rejected;538    const result = getCreateCollectionResult(events);539    // tslint:disable-next-line:no-unused-expression540    expect(result.success).to.be.false;541  });542}543544export async function createItemExpectSuccess(545  sender: IKeyringPair, collectionId: number, createMode: string, owner: string = '') {546  let newItemId: number = 0;547  await usingApi(async (api) => {548    const AItemCount = parseInt((await api.query.nft.itemListIndex(collectionId)).toString(), 10);549    const Aitem: any = (await api.query.nft.fungibleItemList(collectionId, owner)).toJSON();550    const AItemBalance = new BigNumber(Aitem.Value);551552    if (owner === '') {553      owner = sender.address;554    }555556    let tx;557    if (createMode === 'Fungible') {558      const createData = {fungible: {value: 10}};559      tx = api.tx.nft.createItem(collectionId, owner, createData);560    } else {561      tx = api.tx.nft.createItem(collectionId, owner, createMode);562    }563    const events = await submitTransactionAsync(sender, tx);564    const result = getCreateItemResult(events);565566    const BItemCount = parseInt((await api.query.nft.itemListIndex(collectionId)).toString(), 10);567    const Bitem: any = (await api.query.nft.fungibleItemList(collectionId, owner)).toJSON();568    const BItemBalance = new BigNumber(Bitem.Value);569570    // What to expect571    // tslint:disable-next-line:no-unused-expression572    expect(result.success).to.be.true;573    if (createMode === 'Fungible') {574      expect(BItemBalance.minus(AItemBalance).toNumber()).to.be.equal(10);575    } else {576      expect(BItemCount).to.be.equal(AItemCount + 1);577    }578    expect(collectionId).to.be.equal(result.collectionId);579    expect(BItemCount).to.be.equal(result.itemId);580    newItemId = result.itemId;581  });582  return newItemId;583}584585export async function enableWhiteListExpectSuccess(sender: IKeyringPair, collectionId: number) {586  await usingApi(async (api) => {587588    // Run the transaction589    const tx = api.tx.nft.setPublicAccessMode(collectionId, 'WhiteList');590    const events = await submitTransactionAsync(sender, tx);591    const result = getGenericResult(events);592593    // Get the collection594    const collection: any = (await api.query.nft.collection(collectionId)).toJSON();595596    // What to expect597    // tslint:disable-next-line:no-unused-expression598    expect(result.success).to.be.true;599    expect(collection.Access).to.be.equal('WhiteList');600  });601}602603export async function enablePublicMintingExpectSuccess(sender: IKeyringPair, collectionId: number) {604  await usingApi(async (api) => {605606    // Run the transaction607    const tx = api.tx.nft.setMintPermission(collectionId, true);608    const events = await submitTransactionAsync(sender, tx);609    const result = getGenericResult(events);610611    // Get the collection612    const collection: any = (await api.query.nft.collection(collectionId)).toJSON();613614    // What to expect615    expect(result.success).to.be.true;616    expect(collection.MintMode).to.be.equal(true);617  });618}619620export async function addToWhiteListExpectSuccess(sender: IKeyringPair, collectionId: number, address: string) {621  await usingApi(async (api) => {622623    const whiteListedBefore = (await api.query.nft.whiteList(collectionId, address)).toJSON();624625    // Run the transaction626    const tx = api.tx.nft.addToWhiteList(collectionId, address);627    const events = await submitTransactionAsync(sender, tx);628    const result = getGenericResult(events);629630    const whiteListedAfter = (await api.query.nft.whiteList(collectionId, address)).toJSON();631632    // What to expect633    // tslint:disable-next-line:no-unused-expression634    expect(result.success).to.be.true;635    // tslint:disable-next-line: no-unused-expression636    expect(whiteListedBefore).to.be.false;637    // tslint:disable-next-line: no-unused-expression638    expect(whiteListedAfter).to.be.true;639  });640}641642export const getDetailedCollectionInfo = async (api: ApiPromise, collectionId: number)643  : Promise<ICollectionInterface | null> => {644  return await api.query.nft.collection(collectionId) as unknown as ICollectionInterface;645};646647export const getCreatedCollectionCount = async (api: ApiPromise): Promise<number> => {648  // set global object - collectionsCount649  return (await api.query.nft.createdCollectionCount() as unknown as BN).toNumber();650};