git.delta.rocks / unique-network / refs/commits / 415e2e02d914

difftreelog

tests(nesting+properties): collection and token interfaces + make lower case not default for token addresses + more consts from old helpers included

Fahrrader2022-09-27parent: #b0b1d40.patch.diff
in: master

8 files changed

modifiedtests/src/fungible.test.tsdiffbeforeafterboth
--- a/tests/src/fungible.test.ts
+++ b/tests/src/fungible.test.ts
@@ -15,9 +15,7 @@
 // along with Unique Network. If not, see <http://www.gnu.org/licenses/>.
 
 import {IKeyringPair} from '@polkadot/types/types';
-import {itSub, usingPlaygrounds, expect} from './util/playgrounds';
-
-const U128_MAX = (1n << 128n) - 1n;
+import {itSub, usingPlaygrounds, expect, U128_MAX} from './util/playgrounds';
 
 describe('integration test: Fungible functionality:', () => {
   let alice: IKeyringPair;
modifiedtests/src/nesting/graphs.test.tsdiffbeforeafterboth
--- a/tests/src/nesting/graphs.test.ts
+++ b/tests/src/nesting/graphs.test.ts
@@ -16,7 +16,8 @@
 
 import {IKeyringPair} from '@polkadot/types/types';
 import {expect, itSub, usingPlaygrounds} from '../util/playgrounds';
-import {UniqueHelper, UniqueNFTToken} from '../util/playgrounds/unique';
+import {ITokenNonfungible} from '../util/playgrounds/types';
+import {UniqueHelper} from '../util/playgrounds/unique';
 
 /**
  * ```dot
@@ -25,7 +26,7 @@
  * 8 -> 5
  * ```
  */
-async function buildComplexObjectGraph(helper: UniqueHelper, sender: IKeyringPair): Promise<UniqueNFTToken[]> {
+async function buildComplexObjectGraph(helper: UniqueHelper, sender: IKeyringPair): Promise<ITokenNonfungible[]> {
   const collection = await helper.nft.mintCollection(sender, {permissions: {nesting: {tokenOwner: true}}});
   const tokens = await collection.mintMultipleTokens(sender, Array(8).fill({owner: {Substrate: sender.address}}));
 
modifiedtests/src/nesting/nest.test.tsdiffbeforeafterboth
before · tests/src/nesting/nest.test.ts
1// Copyright 2019-2022 Unique Network (Gibraltar) Ltd.2// This file is part of Unique Network.34// Unique Network is free software: you can redistribute it and/or modify5// it under the terms of the GNU General Public License as published by6// the Free Software Foundation, either version 3 of the License, or7// (at your option) any later version.89// Unique Network is distributed in the hope that it will be useful,10// but WITHOUT ANY WARRANTY; without even the implied warranty of11// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the12// GNU General Public License for more details.1314// You should have received a copy of the GNU General Public License15// along with Unique Network. If not, see <http://www.gnu.org/licenses/>.1617import {IKeyringPair} from '@polkadot/types/types';18import {expect, itSub, Pallets, usingPlaygrounds} from '../util/playgrounds';1920describe('Integration Test: Composite nesting tests', () => {21  let alice: IKeyringPair;22  let bob: IKeyringPair;2324  before(async () => {25    await usingPlaygrounds(async (helper, privateKey) => {26      const donor = privateKey('//Alice');27      [alice, bob] = await helper.arrange.createAccounts([50n, 10n], donor);28    });29  });3031  itSub('Performs the full suite: bundles a token, transfers, and unnests', async ({helper}) => {32    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true}}});33    const targetToken = await collection.mintToken(alice);3435    // Create an immediately nested token36    const nestedToken = await collection.mintToken(alice, targetToken.nestingAccount());37    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: alice.address});38    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());39    40    // Create a token to be nested41    const newToken = await collection.mintToken(alice);4243    // Nest44    await newToken.nest(alice, targetToken);45    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: alice.address});46    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());4748    // Move bundle to different user49    await targetToken.transfer(alice, {Substrate: bob.address});50    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: bob.address});51    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());52    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: bob.address});53    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());5455    // Unnest56    await newToken.unnest(bob, targetToken, {Substrate: bob.address});57    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: bob.address});58    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: bob.address});59  });6061  itSub('Transfers an already bundled token', async ({helper}) => {62    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true}}});63    const tokenA = await collection.mintToken(alice);64    const tokenB = await collection.mintToken(alice);6566    // Create a nested token67    const tokenC = await collection.mintToken(alice, tokenA.nestingAccount());68    expect(await tokenC.getOwner()).to.be.deep.equal(tokenA.nestingAccount());69    70    // Transfer the nested token to another token71    await expect(tokenC.transferFrom(alice, tokenA.nestingAccount(), tokenB.nestingAccount())).to.be.fulfilled;72    expect(await tokenC.getTopmostOwner()).to.be.deep.equal({Substrate: alice.address});73    expect(await tokenC.getOwner()).to.be.deep.equal(tokenB.nestingAccount());74  });7576  itSub('Checks token children', async ({helper}) => {77    const collectionA = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true}}});78    const collectionB = await helper.ft.mintCollection(alice);79    80    const targetToken = await collectionA.mintToken(alice);81    expect((await targetToken.getChildren()).length).to.be.equal(0, 'Children length check at creation');8283    // Create a nested NFT token84    const tokenA = await collectionA.mintToken(alice, targetToken.nestingAccount());85    expect(await targetToken.getChildren()).to.have.deep.members([86      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},87    ], 'Children contents check at nesting #1').and.be.length(1, 'Children length check at nesting #1');8889    // Create then nest90    const tokenB = await collectionA.mintToken(alice);91    await tokenB.nest(alice, targetToken);92    expect(await targetToken.getChildren()).to.have.deep.members([93      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},94      {tokenId: tokenB.tokenId, collectionId: collectionA.collectionId},95    ], 'Children contents check at nesting #2').and.be.length(2, 'Children length check at nesting #2');9697    // Move token B to a different user outside the nesting tree98    await tokenB.unnest(alice, targetToken, {Substrate: bob.address});99    expect(await targetToken.getChildren()).to.be.have.deep.members([100      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},101    ], 'Children contents check at nesting #3 (unnesting)').and.be.length(1, 'Children length check at nesting #3 (unnesting)');102103    // Create a fungible token in another collection and then nest104    await collectionB.mint(alice, 10n);105    await collectionB.transfer(alice, targetToken.nestingAccount(), 2n);106    expect(await targetToken.getChildren()).to.be.have.deep.members([107      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},108      {tokenId: 0, collectionId: collectionB.collectionId},109    ], 'Children contents check at nesting #4 (from another collection)')110      .and.be.length(2, 'Children length check at nesting #4 (from another collection)');111    112    // Move part of the fungible token inside token A deeper in the nesting tree113    await collectionB.transferFrom(alice, targetToken.nestingAccount(), tokenA.nestingAccount(), 1n);114    expect(await targetToken.getChildren()).to.be.have.deep.members([115      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},116      {tokenId: 0, collectionId: collectionB.collectionId},117    ], 'Children contents check at nesting #5 (deeper)').and.be.length(2, 'Children length check at nesting #5 (deeper)');118    expect(await tokenA.getChildren()).to.be.have.deep.members([119      {tokenId: 0, collectionId: collectionB.collectionId},120    ], 'Children contents check at nesting #5.5 (deeper)').and.be.length(1, 'Children length check at nesting #5.5 (deeper)');121122    // Move the remaining part of the fungible token inside token A deeper in the nesting tree123    await collectionB.transferFrom(alice, targetToken.nestingAccount(), tokenA.nestingAccount(), 1n);124    expect(await targetToken.getChildren()).to.be.have.deep.members([125      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},126    ], 'Children contents check at nesting #6 (deeper)').and.be.length(1, 'Children length check at nesting #6 (deeper)');127    expect(await tokenA.getChildren()).to.be.have.deep.members([128      {tokenId: 0, collectionId: collectionB.collectionId},129    ], 'Children contents check at nesting #6.5 (deeper)').and.be.length(1, 'Children length check at nesting #6.5 (deeper)');130  });131});132133describe('Integration Test: Various token type nesting', () => {134  let alice: IKeyringPair;135  let bob: IKeyringPair;136  let charlie: IKeyringPair;137138  before(async () => {139    await usingPlaygrounds(async (helper, privateKey) => {140      const donor = privateKey('//Alice');141      [alice, bob, charlie] = await helper.arrange.createAccounts([50n, 10n, 10n], donor);142    });143  });144145  itSub('Admin (NFT): allows an Admin to nest a token', async ({helper}) => {146    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {collectionAdmin: true}}});147    await collection.addAdmin(alice, {Substrate: bob.address});148    const targetToken = await collection.mintToken(alice, {Substrate: charlie.address});149150    // Create an immediately nested token151    const nestedToken = await collection.mintToken(bob, targetToken.nestingAccount());152    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});153    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());154155    // Create a token to be nested and nest156    const newToken = await collection.mintToken(bob);157    await newToken.nest(bob, targetToken);158    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});159    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());160  });161162  itSub('Admin (NFT): Admin and Token Owner can operate together', async ({helper}) => {163    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {collectionAdmin: true, tokenOwner: true}}});164    await collection.addAdmin(alice, {Substrate: bob.address});165    const targetToken = await collection.mintToken(alice, {Substrate: charlie.address});166167    // Create an immediately nested token by an administrator168    const nestedToken = await collection.mintToken(bob, targetToken.nestingAccount());169    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});170    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());171172    // Create a token to be nested and nest173    const newToken = await collection.mintToken(alice, {Substrate: charlie.address});174    await newToken.nest(charlie, targetToken);175    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});176    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());177  });178179  itSub('Admin (NFT): allows an Admin to nest a token (Restricted nesting)', async ({helper}) => {180    const collectionA = await helper.nft.mintCollection(alice);181    await collectionA.addAdmin(alice, {Substrate: bob.address});182    const collectionB = await helper.nft.mintCollection(alice);183    await collectionB.addAdmin(alice, {Substrate: bob.address});184    await collectionA.setPermissions(alice, {nesting: {collectionAdmin: true, restricted:[collectionB.collectionId]}});185    const targetToken = await collectionA.mintToken(alice, {Substrate: charlie.address});186187    // Create an immediately nested token188    const nestedToken = await collectionB.mintToken(bob, targetToken.nestingAccount());189    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});190    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());191192    // Create a token to be nested and nest193    const newToken = await collectionB.mintToken(bob);194    await newToken.nest(bob, targetToken);195    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});196    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());197  });198199  // ---------- Non-Fungible ----------200201  itSub('NFT: allows an Owner to nest/unnest their token', async ({helper}) => {202    const collection = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}}});203    await collection.addToAllowList(alice, {Substrate: charlie.address});204    const targetToken = await collection.mintToken(charlie);205    await collection.addToAllowList(alice, targetToken.nestingAccount());206207    // Create an immediately nested token208    const nestedToken = await collection.mintToken(charlie, targetToken.nestingAccount());209    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});210    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());211212    // Create a token to be nested and nest213    const newToken = await collection.mintToken(charlie);214    await newToken.nest(charlie, targetToken);215    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});216    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());217  });218219  itSub('NFT: allows an Owner to nest/unnest their token (Restricted nesting)', async ({helper}) => {220    const collectionA = await helper.nft.mintCollection(alice);221    const collectionB = await helper.nft.mintCollection(alice);222    //await collectionB.addAdmin(alice, {Substrate: bob.address});223    const targetToken = await collectionA.mintToken(alice, {Substrate: charlie.address});224225    await collectionA.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true, restricted:[collectionB.collectionId]}});226    await collectionA.addToAllowList(alice, {Substrate: charlie.address});227    await collectionA.addToAllowList(alice, targetToken.nestingAccount());228229    await collectionB.setPermissions(alice, {access: 'AllowList', mintMode: true});230    await collectionB.addToAllowList(alice, {Substrate: charlie.address});231    await collectionB.addToAllowList(alice, targetToken.nestingAccount());232233    // Create an immediately nested token234    const nestedToken = await collectionB.mintToken(charlie, targetToken.nestingAccount());235    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});236    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());237238    // Create a token to be nested and nest239    const newToken = await collectionB.mintToken(charlie);240    await newToken.nest(charlie, targetToken);241    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});242    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());243  });244245  // ---------- Fungible ----------246247  itSub('Fungible: allows an Owner to nest/unnest their token', async ({helper}) => {248    const collectionNFT = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}}});249    const collectionFT = await helper.ft.mintCollection(alice);250    const targetToken = await collectionNFT.mintToken(alice, {Substrate: charlie.address});251252    await collectionNFT.addToAllowList(alice, {Substrate: charlie.address});253    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());254255    await collectionFT.setPermissions(alice, {access: 'AllowList', mintMode: true});256    await collectionFT.addToAllowList(alice, {Substrate: charlie.address});257    await collectionFT.addToAllowList(alice, targetToken.nestingAccount());258259    // Create an immediately nested token260    await collectionFT.mint(charlie, 5n, targetToken.nestingAccount());261    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(5n);262263    // Create a token to be nested and nest264    await collectionFT.mint(charlie, 5n);265    await collectionFT.transfer(charlie, targetToken.nestingAccount(), 2n);266    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(7n);267  });268269  itSub('Fungible: allows an Owner to nest/unnest their token (Restricted nesting)', async ({helper}) => {270    const collectionNFT = await helper.nft.mintCollection(alice);271    const collectionFT = await helper.ft.mintCollection(alice);272    const targetToken = await collectionNFT.mintToken(alice, {Substrate: charlie.address});273274    await collectionNFT.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true, restricted:[collectionFT.collectionId]}});275    await collectionNFT.addToAllowList(alice, {Substrate: charlie.address});276    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());277278    await collectionFT.setPermissions(alice, {access: 'AllowList', mintMode: true});279    await collectionFT.addToAllowList(alice, {Substrate: charlie.address});280    await collectionFT.addToAllowList(alice, targetToken.nestingAccount());281282    // Create an immediately nested token283    await collectionFT.mint(charlie, 5n, targetToken.nestingAccount());284    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(5n);285286    // Create a token to be nested and nest287    await collectionFT.mint(charlie, 5n);288    await collectionFT.transfer(charlie, targetToken.nestingAccount(), 2n);289    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(7n);290  });291292  // ---------- Re-Fungible ----------293294  itSub.ifWithPallets('ReFungible: allows an Owner to nest/unnest their token', [Pallets.ReFungible], async ({helper}) => {295    const collectionNFT = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}}});296    const collectionRFT = await helper.rft.mintCollection(alice);297    const targetToken = await collectionNFT.mintToken(alice, {Substrate: charlie.address});298299    await collectionNFT.addToAllowList(alice, {Substrate: charlie.address});300    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());301302    await collectionRFT.setPermissions(alice, {access: 'AllowList', mintMode: true});303    await collectionRFT.addToAllowList(alice, {Substrate: charlie.address});304    await collectionRFT.addToAllowList(alice, targetToken.nestingAccount());305306    // Create an immediately nested token307    const nestedToken = await collectionRFT.mintToken(charlie, 5n, targetToken.nestingAccount());308    expect(await nestedToken.getBalance(targetToken.nestingAccount())).to.be.equal(5n);309310    // Create a token to be nested and nest311    const newToken = await collectionRFT.mintToken(charlie, 5n);312    await newToken.transfer(charlie, targetToken.nestingAccount(), 2n);313    expect(await newToken.getBalance(targetToken.nestingAccount())).to.be.equal(2n);314  });315316  itSub.ifWithPallets('ReFungible: allows an Owner to nest/unnest their token (Restricted nesting)', [Pallets.ReFungible], async ({helper}) => {317    const collectionNFT = await helper.nft.mintCollection(alice);318    const collectionRFT = await helper.rft.mintCollection(alice);319    const targetToken = await collectionNFT.mintToken(alice, {Substrate: charlie.address});320321    await collectionNFT.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true, restricted:[collectionRFT.collectionId]}});322    await collectionNFT.addToAllowList(alice, {Substrate: charlie.address});323    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());324325    await collectionRFT.setPermissions(alice, {access: 'AllowList', mintMode: true});326    await collectionRFT.addToAllowList(alice, {Substrate: charlie.address});327    await collectionRFT.addToAllowList(alice, targetToken.nestingAccount());328329    // Create an immediately nested token330    const nestedToken = await collectionRFT.mintToken(charlie, 5n, targetToken.nestingAccount());331    expect(await nestedToken.getBalance(targetToken.nestingAccount())).to.be.equal(5n);332333    // Create a token to be nested and nest334    const newToken = await collectionRFT.mintToken(charlie, 5n);335    await newToken.transfer(charlie, targetToken.nestingAccount(), 2n);336    expect(await newToken.getBalance(targetToken.nestingAccount())).to.be.equal(2n);337  });338});339340describe('Negative Test: Nesting', () => {341  let alice: IKeyringPair;342  let bob: IKeyringPair;343344  before(async () => {345    await usingPlaygrounds(async (helper, privateKey) => {346      const donor = privateKey('//Alice');347      [alice, bob] = await helper.arrange.createAccounts([100n, 50n], donor);348    });349  });350351  itSub('Disallows excessive token nesting', async ({helper}) => {352    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true}}});353    let token = await collection.mintToken(alice);354355    const maxNestingLevel = 5;356357    // Create a nested-token matryoshka358    for (let i = 0; i < maxNestingLevel; i++) {359      token = await collection.mintToken(alice, token.nestingAccount());360    }361362    // The nesting depth is limited by `maxNestingLevel`363    await expect(collection.mintToken(alice, token.nestingAccount()))364      .to.be.rejectedWith(/structure\.DepthLimit/);365    expect(await token.getTopmostOwner()).to.be.deep.equal({Substrate: alice.address});366    expect(await token.getChildren()).to.be.length(0);367  });368369  // ---------- Admin ------------370371  itSub('Admin (NFT): disallows an Admin to operate nesting when only TokenOwner is allowed', async ({helper}) => {372    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true}}});373    await collection.addAdmin(alice, {Substrate: bob.address});374    const targetToken = await collection.mintToken(alice);375376    // Try to create an immediately nested token as collection admin when it's disallowed377    await expect(collection.mintToken(bob, targetToken.nestingAccount()))378      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);379380    // Try to create a token to be nested and nest381    const newToken = await collection.mintToken(bob);382    await expect(newToken.nest(bob, targetToken))383      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);384385    expect(await targetToken.getChildren()).to.be.length(0);386    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: bob.address});387  });388389  itSub('Admin (NFT): disallows a Token Owner to operate nesting when only Admin is allowed', async ({helper}) => {390    const collection = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true, nesting: {collectionAdmin: true}}});391    const targetToken = await collection.mintToken(alice, {Substrate: bob.address});392    await collection.addToAllowList(alice, {Substrate: bob.address});393    await collection.addToAllowList(alice, targetToken.nestingAccount());394395    // Try to create a nested token as token owner when it's disallowed396    await expect(collection.mintToken(bob, targetToken.nestingAccount()))397      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);398399    // Try to create a token to be nested and nest400    const newToken = await collection.mintToken(bob);401    await expect(newToken.nest(bob, targetToken))402      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);403404    expect(await targetToken.getChildren()).to.be.length(0);405    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: bob.address});406  });407408  itSub('Admin (NFT): disallows an Admin to unnest someone else\'s token', async ({helper}) => {409    const collection = await helper.nft.mintCollection(alice, {limits: {ownerCanTransfer: true}, permissions: {access: 'AllowList', mintMode: true, nesting: {collectionAdmin: true}}});410    //await collection.addAdmin(alice, {Substrate: bob.address});411    const targetToken = await collection.mintToken(alice, {Substrate: bob.address});412    await collection.addToAllowList(alice, {Substrate: bob.address});413    await collection.addToAllowList(alice, targetToken.nestingAccount());414415    // Try to nest somebody else's token416    const newToken = await collection.mintToken(bob);417    await expect(newToken.nest(alice, targetToken))418      .to.be.rejectedWith(/common\.NoPermission/);419420    // Try to unnest a token belonging to someone else as collection admin421    const nestedToken = await collection.mintToken(alice, targetToken.nestingAccount());422    await expect(nestedToken.unnest(alice, targetToken, {Substrate: bob.address}))423      .to.be.rejectedWith(/common\.AddressNotInAllowlist/);424425    expect(await targetToken.getChildren()).to.be.length(1);426    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: bob.address});427    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());428  });429430  itSub('Admin (NFT): disallows an Admin to nest a token from an unlisted collection (Restricted nesting)', async ({helper}) => {431    const collectionA = await helper.nft.mintCollection(alice);432    const collectionB = await helper.nft.mintCollection(alice);433    await collectionA.setPermissions(alice, {nesting: {collectionAdmin: true, restricted: [collectionA.collectionId]}});434    const targetToken = await collectionA.mintToken(alice);435436    // Try to create a nested token from another collection437    await expect(collectionB.mintToken(alice, targetToken.nestingAccount()))438      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);439440    // Create a token in another collection yet to be nested and try to nest441    const newToken = await collectionB.mintToken(alice);442    await expect(newToken.nest(alice, targetToken))443      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);444445    expect(await targetToken.getChildren()).to.be.length(0);446    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: alice.address});447  });448449  // ---------- Non-Fungible ----------450451  itSub('NFT: disallows to nest token if nesting is disabled', async ({helper}) => {452    // Collection is implicitly not allowed nesting at creation453    const collection = await helper.nft.mintCollection(alice);454    const targetToken = await collection.mintToken(alice);455456    // Try to create a nested token as token owner when it's disallowed457    await expect(collection.mintToken(alice, targetToken.nestingAccount()))458      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);459460    // Try to create a token to be nested and nest461    const newToken = await collection.mintToken(alice);462    await expect(newToken.nest(alice, targetToken))463      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);464465    expect(await targetToken.getChildren()).to.be.length(0);466    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: alice.address});467  });468469  itSub('NFT: disallows a non-Owner to nest someone else\'s token', async ({helper}) => {470    const collection = await helper.nft.mintCollection(alice);471    const targetToken = await collection.mintToken(alice);472473    await collection.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}});474    await collection.addToAllowList(alice, {Substrate: bob.address});475    await collection.addToAllowList(alice, targetToken.nestingAccount());476477    // Try to create a token to be nested and nest478    const newToken = await collection.mintToken(alice);479    await expect(newToken.nest(bob, targetToken)).to.be.rejectedWith(/common\.NoPermission/);480481    expect(await targetToken.getChildren()).to.be.length(0);482    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: alice.address});483  });484485  itSub('NFT: disallows a non-Owner to nest someone else\'s token (Restricted nesting)', async ({helper}) => {486    const collection = await helper.nft.mintCollection(alice);487    const targetToken = await collection.mintToken(alice);488489    await collection.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}});490    await collection.addToAllowList(alice, {Substrate: bob.address});491    await collection.addToAllowList(alice, targetToken.nestingAccount());492493    const collectionB = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true}});494    await collectionB.addToAllowList(alice, {Substrate: bob.address});495    await collectionB.addToAllowList(alice, targetToken.nestingAccount());496497    // Try to create a token to be nested and nest498    const newToken = await collectionB.mintToken(alice);499    await expect(newToken.nest(bob, targetToken)).to.be.rejectedWith(/common\.NoPermission/);500501    expect(await targetToken.getChildren()).to.be.length(0);502    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: alice.address});503  });504505  itSub('NFT: disallows to nest token in an unlisted collection', async ({helper}) => {506    // Create collection with restricted nesting -- even self is not allowed507    const collection = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true, restricted: []}}});508    const targetToken = await collection.mintToken(alice, {Substrate: bob.address});509510    await collection.addToAllowList(alice, {Substrate: bob.address});511    await collection.addToAllowList(alice, targetToken.nestingAccount());512513    // Try to mint in own collection after allowlisting the accounts514    await expect(collection.mintToken(bob, targetToken.nestingAccount()))515      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);516  });517518  // ---------- Fungible ----------519520  itSub('Fungible: disallows to nest token if nesting is disabled', async ({helper}) => {521    const collectionNFT = await helper.nft.mintCollection(alice);522    const collectionFT = await helper.ft.mintCollection(alice);523    const targetToken = await collectionNFT.mintToken(alice);524525    // Try to create an immediately nested token526    await expect(collectionFT.mint(alice, 5n, targetToken.nestingAccount()))527      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);528529    // Try to create a token to be nested and nest530    await collectionFT.mint(alice, 5n);531    await expect(collectionFT.transfer(alice, targetToken.nestingAccount(), 2n))532      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);533    expect(await collectionFT.getBalance({Substrate: alice.address})).to.be.equal(5n);534  });535536  itSub('Fungible: disallows a non-Owner to unnest someone else\'s token', async ({helper}) => {537    const collectionNFT = await helper.nft.mintCollection(alice, {permissions: {nesting: {collectionAdmin: true, tokenOwner: true}}});538    const collectionFT = await helper.ft.mintCollection(alice);539    const targetToken = await collectionNFT.mintToken(alice, {Substrate: bob.address});540541    // Nest some tokens as Alice into Bob's token542    await collectionFT.mint(alice, 5n, targetToken.nestingAccount());543544    // Try to pull it out545    await expect(collectionFT.transferFrom(alice, targetToken.nestingAccount(), {Substrate: bob.address}, 1n))546      .to.be.rejectedWith(/common\.ApprovedValueTooLow/);547    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(5n);548  });549550  itSub('Fungible: disallows a non-Owner to unnest someone else\'s token (Restricted nesting)', async ({helper}) => {551    const collectionNFT = await helper.nft.mintCollection(alice);552    const collectionFT = await helper.ft.mintCollection(alice);553    const targetToken = await collectionNFT.mintToken(alice, {Substrate: bob.address});554555    await collectionNFT.setPermissions(alice, {nesting: {collectionAdmin: true, tokenOwner: true, restricted: [collectionFT.collectionId]}});556557    // Nest some tokens as Alice into Bob's token558    await collectionFT.mint(alice, 5n, targetToken.nestingAccount());559560    // Try to pull it out as Alice still561    await expect(collectionFT.transferFrom(alice, targetToken.nestingAccount(), {Substrate: bob.address}, 1n))562      .to.be.rejectedWith(/common\.ApprovedValueTooLow/);563    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(5n);564  });565566  itSub('Fungible: disallows to nest token in an unlisted collection', async ({helper}) => {567    const collectionNFT = await helper.nft.mintCollection(alice, {permissions: {nesting: {collectionAdmin: true, tokenOwner: true, restricted: []}}});568    const collectionFT = await helper.ft.mintCollection(alice);569    const targetToken = await collectionNFT.mintToken(alice);570571    // Try to mint an immediately nested token572    await expect(collectionFT.mint(alice, 5n, targetToken.nestingAccount()))573      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);574575    // Mint a token and try to nest it576    await collectionFT.mint(alice, 5n);577    await expect(collectionFT.transfer(alice, targetToken.nestingAccount(), 1n))578      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);579580    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(0n);581    expect(await collectionFT.getBalance({Substrate: alice.address})).to.be.equal(5n);582  });583584  // ---------- Re-Fungible ----------585586  itSub.ifWithPallets('ReFungible: disallows to nest token if nesting is disabled', [Pallets.ReFungible], async ({helper}) => {587    const collectionNFT = await helper.nft.mintCollection(alice);588    const collectionRFT = await helper.rft.mintCollection(alice);589    const targetToken = await collectionNFT.mintToken(alice);590591    // Try to create an immediately nested token592    await expect(collectionRFT.mintToken(alice, 5n, targetToken.nestingAccount()))593      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);594595    // Try to create a token to be nested and nest596    const token = await collectionRFT.mintToken(alice, 5n);597    await expect(token.transfer(alice, targetToken.nestingAccount(), 2n))598      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);599    expect(await token.getBalance({Substrate: alice.address})).to.be.equal(5n);600  });601602  itSub.ifWithPallets('ReFungible: disallows a non-Owner to nest someone else\'s token', [Pallets.ReFungible], async ({helper}) => {603    const collectionNFT = await helper.nft.mintCollection(alice);604    const collectionRFT = await helper.rft.mintCollection(alice);605    const targetToken = await collectionNFT.mintToken(alice);606607    await collectionNFT.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}});608    await collectionNFT.addToAllowList(alice, {Substrate: bob.address});609    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());610611    // Try to create a token to be nested and nest612    const newToken = await collectionRFT.mintToken(alice);613    await expect(newToken.transfer(bob, targetToken.nestingAccount())).to.be.rejectedWith(/common\.TokenValueTooLow/);614615    expect(await targetToken.getChildren()).to.be.length(0);616    expect(await newToken.getBalance({Substrate: alice.address})).to.be.equal(1n);617618    // Nest some tokens as Alice into Bob's token619    await newToken.transfer(alice, targetToken.nestingAccount());620621    // Try to pull it out622    await expect(newToken.transferFrom(bob, targetToken.nestingAccount(), {Substrate: alice.address}, 1n))623      .to.be.rejectedWith(/common\.ApprovedValueTooLow/);624    expect(await newToken.getBalance(targetToken.nestingAccount())).to.be.equal(1n);625  });626627  itSub.ifWithPallets('ReFungible: disallows a non-Owner to nest someone else\'s token (Restricted nesting)', [Pallets.ReFungible], async ({helper}) => {628    const collectionNFT = await helper.nft.mintCollection(alice);629    const collectionRFT = await helper.rft.mintCollection(alice);630    const targetToken = await collectionNFT.mintToken(alice);631632    await collectionNFT.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true, restricted: [collectionRFT.collectionId]}});633    await collectionNFT.addToAllowList(alice, {Substrate: bob.address});634    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());635636    // Try to create a token to be nested and nest637    const newToken = await collectionRFT.mintToken(alice);638    await expect(newToken.transfer(bob, targetToken.nestingAccount())).to.be.rejectedWith(/common\.TokenValueTooLow/);639640    expect(await targetToken.getChildren()).to.be.length(0);641    expect(await newToken.getBalance({Substrate: alice.address})).to.be.equal(1n);642643    // Nest some tokens as Alice into Bob's token644    await newToken.transfer(alice, targetToken.nestingAccount());645646    // Try to pull it out647    await expect(newToken.transferFrom(bob, targetToken.nestingAccount(), {Substrate: alice.address}, 1n))648      .to.be.rejectedWith(/common\.ApprovedValueTooLow/);649    expect(await newToken.getBalance(targetToken.nestingAccount())).to.be.equal(1n);650  });651652  itSub.ifWithPallets('ReFungible: disallows to nest token to an unlisted collection', [Pallets.ReFungible], async ({helper}) => {653    const collectionNFT = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true, restricted: []}}});654    const collectionRFT = await helper.rft.mintCollection(alice);655    const targetToken = await collectionNFT.mintToken(alice);656657    // Try to create an immediately nested token658    await expect(collectionRFT.mintToken(alice, 5n, targetToken.nestingAccount()))659      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);660661    // Try to create a token to be nested and nest662    const token = await collectionRFT.mintToken(alice, 5n);663    await expect(token.transfer(alice, targetToken.nestingAccount(), 2n))664      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);665    expect(await token.getBalance({Substrate: alice.address})).to.be.equal(5n);666  });667});
after · tests/src/nesting/nest.test.ts
1// Copyright 2019-2022 Unique Network (Gibraltar) Ltd.2// This file is part of Unique Network.34// Unique Network is free software: you can redistribute it and/or modify5// it under the terms of the GNU General Public License as published by6// the Free Software Foundation, either version 3 of the License, or7// (at your option) any later version.89// Unique Network is distributed in the hope that it will be useful,10// but WITHOUT ANY WARRANTY; without even the implied warranty of11// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the12// GNU General Public License for more details.1314// You should have received a copy of the GNU General Public License15// along with Unique Network. If not, see <http://www.gnu.org/licenses/>.1617import {IKeyringPair} from '@polkadot/types/types';18import {expect, itSub, Pallets, usingPlaygrounds} from '../util/playgrounds';1920describe('Integration Test: Composite nesting tests', () => {21  let alice: IKeyringPair;22  let bob: IKeyringPair;2324  before(async () => {25    await usingPlaygrounds(async (helper, privateKey) => {26      const donor = privateKey('//Alice');27      [alice, bob] = await helper.arrange.createAccounts([50n, 10n], donor);28    });29  });3031  itSub('Performs the full suite: bundles a token, transfers, and unnests', async ({helper}) => {32    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true}}});33    const targetToken = await collection.mintToken(alice);3435    // Create an immediately nested token36    const nestedToken = await collection.mintToken(alice, targetToken.nestingAccount());37    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: alice.address});38    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());39    40    // Create a token to be nested41    const newToken = await collection.mintToken(alice);4243    // Nest44    await newToken.nest(alice, targetToken);45    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: alice.address});46    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());4748    // Move bundle to different user49    await targetToken.transfer(alice, {Substrate: bob.address});50    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: bob.address});51    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());52    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: bob.address});53    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());5455    // Unnest56    await newToken.unnest(bob, targetToken, {Substrate: bob.address});57    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: bob.address});58    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: bob.address});59  });6061  itSub('Transfers an already bundled token', async ({helper}) => {62    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true}}});63    const tokenA = await collection.mintToken(alice);64    const tokenB = await collection.mintToken(alice);6566    // Create a nested token67    const tokenC = await collection.mintToken(alice, tokenA.nestingAccount());68    expect(await tokenC.getOwner()).to.be.deep.equal(tokenA.nestingAccountInLowerCase());69    70    // Transfer the nested token to another token71    await expect(tokenC.transferFrom(alice, tokenA.nestingAccount(), tokenB.nestingAccount())).to.be.fulfilled;72    expect(await tokenC.getTopmostOwner()).to.be.deep.equal({Substrate: alice.address});73    expect(await tokenC.getOwner()).to.be.deep.equal(tokenB.nestingAccountInLowerCase());74  });7576  itSub('Checks token children', async ({helper}) => {77    const collectionA = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true}}});78    const collectionB = await helper.ft.mintCollection(alice);79    80    const targetToken = await collectionA.mintToken(alice);81    expect((await targetToken.getChildren()).length).to.be.equal(0, 'Children length check at creation');8283    // Create a nested NFT token84    const tokenA = await collectionA.mintToken(alice, targetToken.nestingAccount());85    expect(await targetToken.getChildren()).to.have.deep.members([86      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},87    ], 'Children contents check at nesting #1').and.be.length(1, 'Children length check at nesting #1');8889    // Create then nest90    const tokenB = await collectionA.mintToken(alice);91    await tokenB.nest(alice, targetToken);92    expect(await targetToken.getChildren()).to.have.deep.members([93      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},94      {tokenId: tokenB.tokenId, collectionId: collectionA.collectionId},95    ], 'Children contents check at nesting #2').and.be.length(2, 'Children length check at nesting #2');9697    // Move token B to a different user outside the nesting tree98    await tokenB.unnest(alice, targetToken, {Substrate: bob.address});99    expect(await targetToken.getChildren()).to.be.have.deep.members([100      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},101    ], 'Children contents check at nesting #3 (unnesting)').and.be.length(1, 'Children length check at nesting #3 (unnesting)');102103    // Create a fungible token in another collection and then nest104    await collectionB.mint(alice, 10n);105    await collectionB.transfer(alice, targetToken.nestingAccount(), 2n);106    expect(await targetToken.getChildren()).to.be.have.deep.members([107      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},108      {tokenId: 0, collectionId: collectionB.collectionId},109    ], 'Children contents check at nesting #4 (from another collection)')110      .and.be.length(2, 'Children length check at nesting #4 (from another collection)');111    112    // Move part of the fungible token inside token A deeper in the nesting tree113    await collectionB.transferFrom(alice, targetToken.nestingAccount(), tokenA.nestingAccount(), 1n);114    expect(await targetToken.getChildren()).to.be.have.deep.members([115      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},116      {tokenId: 0, collectionId: collectionB.collectionId},117    ], 'Children contents check at nesting #5 (deeper)').and.be.length(2, 'Children length check at nesting #5 (deeper)');118    expect(await tokenA.getChildren()).to.be.have.deep.members([119      {tokenId: 0, collectionId: collectionB.collectionId},120    ], 'Children contents check at nesting #5.5 (deeper)').and.be.length(1, 'Children length check at nesting #5.5 (deeper)');121122    // Move the remaining part of the fungible token inside token A deeper in the nesting tree123    await collectionB.transferFrom(alice, targetToken.nestingAccount(), tokenA.nestingAccount(), 1n);124    expect(await targetToken.getChildren()).to.be.have.deep.members([125      {tokenId: tokenA.tokenId, collectionId: collectionA.collectionId},126    ], 'Children contents check at nesting #6 (deeper)').and.be.length(1, 'Children length check at nesting #6 (deeper)');127    expect(await tokenA.getChildren()).to.be.have.deep.members([128      {tokenId: 0, collectionId: collectionB.collectionId},129    ], 'Children contents check at nesting #6.5 (deeper)').and.be.length(1, 'Children length check at nesting #6.5 (deeper)');130  });131});132133describe('Integration Test: Various token type nesting', () => {134  let alice: IKeyringPair;135  let bob: IKeyringPair;136  let charlie: IKeyringPair;137138  before(async () => {139    await usingPlaygrounds(async (helper, privateKey) => {140      const donor = privateKey('//Alice');141      [alice, bob, charlie] = await helper.arrange.createAccounts([50n, 10n, 10n], donor);142    });143  });144145  itSub('Admin (NFT): allows an Admin to nest a token', async ({helper}) => {146    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {collectionAdmin: true}}});147    await collection.addAdmin(alice, {Substrate: bob.address});148    const targetToken = await collection.mintToken(alice, {Substrate: charlie.address});149150    // Create an immediately nested token151    const nestedToken = await collection.mintToken(bob, targetToken.nestingAccount());152    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});153    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());154155    // Create a token to be nested and nest156    const newToken = await collection.mintToken(bob);157    await newToken.nest(bob, targetToken);158    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});159    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());160  });161162  itSub('Admin (NFT): Admin and Token Owner can operate together', async ({helper}) => {163    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {collectionAdmin: true, tokenOwner: true}}});164    await collection.addAdmin(alice, {Substrate: bob.address});165    const targetToken = await collection.mintToken(alice, {Substrate: charlie.address});166167    // Create an immediately nested token by an administrator168    const nestedToken = await collection.mintToken(bob, targetToken.nestingAccount());169    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});170    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());171172    // Create a token to be nested and nest173    const newToken = await collection.mintToken(alice, {Substrate: charlie.address});174    await newToken.nest(charlie, targetToken);175    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});176    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());177  });178179  itSub('Admin (NFT): allows an Admin to nest a token (Restricted nesting)', async ({helper}) => {180    const collectionA = await helper.nft.mintCollection(alice);181    await collectionA.addAdmin(alice, {Substrate: bob.address});182    const collectionB = await helper.nft.mintCollection(alice);183    await collectionB.addAdmin(alice, {Substrate: bob.address});184    await collectionA.setPermissions(alice, {nesting: {collectionAdmin: true, restricted:[collectionB.collectionId]}});185    const targetToken = await collectionA.mintToken(alice, {Substrate: charlie.address});186187    // Create an immediately nested token188    const nestedToken = await collectionB.mintToken(bob, targetToken.nestingAccount());189    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});190    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());191192    // Create a token to be nested and nest193    const newToken = await collectionB.mintToken(bob);194    await newToken.nest(bob, targetToken);195    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});196    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());197  });198199  // ---------- Non-Fungible ----------200201  itSub('NFT: allows an Owner to nest/unnest their token', async ({helper}) => {202    const collection = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}}});203    await collection.addToAllowList(alice, {Substrate: charlie.address});204    const targetToken = await collection.mintToken(charlie);205    await collection.addToAllowList(alice, targetToken.nestingAccount());206207    // Create an immediately nested token208    const nestedToken = await collection.mintToken(charlie, targetToken.nestingAccount());209    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});210    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());211212    // Create a token to be nested and nest213    const newToken = await collection.mintToken(charlie);214    await newToken.nest(charlie, targetToken);215    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});216    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());217  });218219  itSub('NFT: allows an Owner to nest/unnest their token (Restricted nesting)', async ({helper}) => {220    const collectionA = await helper.nft.mintCollection(alice);221    const collectionB = await helper.nft.mintCollection(alice);222    //await collectionB.addAdmin(alice, {Substrate: bob.address});223    const targetToken = await collectionA.mintToken(alice, {Substrate: charlie.address});224225    await collectionA.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true, restricted:[collectionB.collectionId]}});226    await collectionA.addToAllowList(alice, {Substrate: charlie.address});227    await collectionA.addToAllowList(alice, targetToken.nestingAccount());228229    await collectionB.setPermissions(alice, {access: 'AllowList', mintMode: true});230    await collectionB.addToAllowList(alice, {Substrate: charlie.address});231    await collectionB.addToAllowList(alice, targetToken.nestingAccount());232233    // Create an immediately nested token234    const nestedToken = await collectionB.mintToken(charlie, targetToken.nestingAccount());235    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});236    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());237238    // Create a token to be nested and nest239    const newToken = await collectionB.mintToken(charlie);240    await newToken.nest(charlie, targetToken);241    expect(await newToken.getTopmostOwner()).to.be.deep.equal({Substrate: charlie.address});242    expect(await newToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());243  });244245  // ---------- Fungible ----------246247  itSub('Fungible: allows an Owner to nest/unnest their token', async ({helper}) => {248    const collectionNFT = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}}});249    const collectionFT = await helper.ft.mintCollection(alice);250    const targetToken = await collectionNFT.mintToken(alice, {Substrate: charlie.address});251252    await collectionNFT.addToAllowList(alice, {Substrate: charlie.address});253    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());254255    await collectionFT.setPermissions(alice, {access: 'AllowList', mintMode: true});256    await collectionFT.addToAllowList(alice, {Substrate: charlie.address});257    await collectionFT.addToAllowList(alice, targetToken.nestingAccount());258259    // Create an immediately nested token260    await collectionFT.mint(charlie, 5n, targetToken.nestingAccount());261    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(5n);262263    // Create a token to be nested and nest264    await collectionFT.mint(charlie, 5n);265    await collectionFT.transfer(charlie, targetToken.nestingAccount(), 2n);266    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(7n);267  });268269  itSub('Fungible: allows an Owner to nest/unnest their token (Restricted nesting)', async ({helper}) => {270    const collectionNFT = await helper.nft.mintCollection(alice);271    const collectionFT = await helper.ft.mintCollection(alice);272    const targetToken = await collectionNFT.mintToken(alice, {Substrate: charlie.address});273274    await collectionNFT.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true, restricted:[collectionFT.collectionId]}});275    await collectionNFT.addToAllowList(alice, {Substrate: charlie.address});276    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());277278    await collectionFT.setPermissions(alice, {access: 'AllowList', mintMode: true});279    await collectionFT.addToAllowList(alice, {Substrate: charlie.address});280    await collectionFT.addToAllowList(alice, targetToken.nestingAccount());281282    // Create an immediately nested token283    await collectionFT.mint(charlie, 5n, targetToken.nestingAccount());284    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(5n);285286    // Create a token to be nested and nest287    await collectionFT.mint(charlie, 5n);288    await collectionFT.transfer(charlie, targetToken.nestingAccount(), 2n);289    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(7n);290  });291292  // ---------- Re-Fungible ----------293294  itSub.ifWithPallets('ReFungible: allows an Owner to nest/unnest their token', [Pallets.ReFungible], async ({helper}) => {295    const collectionNFT = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}}});296    const collectionRFT = await helper.rft.mintCollection(alice);297    const targetToken = await collectionNFT.mintToken(alice, {Substrate: charlie.address});298299    await collectionNFT.addToAllowList(alice, {Substrate: charlie.address});300    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());301302    await collectionRFT.setPermissions(alice, {access: 'AllowList', mintMode: true});303    await collectionRFT.addToAllowList(alice, {Substrate: charlie.address});304    await collectionRFT.addToAllowList(alice, targetToken.nestingAccount());305306    // Create an immediately nested token307    const nestedToken = await collectionRFT.mintToken(charlie, 5n, targetToken.nestingAccount());308    expect(await nestedToken.getBalance(targetToken.nestingAccount())).to.be.equal(5n);309310    // Create a token to be nested and nest311    const newToken = await collectionRFT.mintToken(charlie, 5n);312    await newToken.transfer(charlie, targetToken.nestingAccount(), 2n);313    expect(await newToken.getBalance(targetToken.nestingAccount())).to.be.equal(2n);314  });315316  itSub.ifWithPallets('ReFungible: allows an Owner to nest/unnest their token (Restricted nesting)', [Pallets.ReFungible], async ({helper}) => {317    const collectionNFT = await helper.nft.mintCollection(alice);318    const collectionRFT = await helper.rft.mintCollection(alice);319    const targetToken = await collectionNFT.mintToken(alice, {Substrate: charlie.address});320321    await collectionNFT.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true, restricted:[collectionRFT.collectionId]}});322    await collectionNFT.addToAllowList(alice, {Substrate: charlie.address});323    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());324325    await collectionRFT.setPermissions(alice, {access: 'AllowList', mintMode: true});326    await collectionRFT.addToAllowList(alice, {Substrate: charlie.address});327    await collectionRFT.addToAllowList(alice, targetToken.nestingAccount());328329    // Create an immediately nested token330    const nestedToken = await collectionRFT.mintToken(charlie, 5n, targetToken.nestingAccount());331    expect(await nestedToken.getBalance(targetToken.nestingAccount())).to.be.equal(5n);332333    // Create a token to be nested and nest334    const newToken = await collectionRFT.mintToken(charlie, 5n);335    await newToken.transfer(charlie, targetToken.nestingAccount(), 2n);336    expect(await newToken.getBalance(targetToken.nestingAccount())).to.be.equal(2n);337  });338});339340describe('Negative Test: Nesting', () => {341  let alice: IKeyringPair;342  let bob: IKeyringPair;343344  before(async () => {345    await usingPlaygrounds(async (helper, privateKey) => {346      const donor = privateKey('//Alice');347      [alice, bob] = await helper.arrange.createAccounts([100n, 50n], donor);348    });349  });350351  itSub('Disallows excessive token nesting', async ({helper}) => {352    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true}}});353    let token = await collection.mintToken(alice);354355    const maxNestingLevel = 5;356357    // Create a nested-token matryoshka358    for (let i = 0; i < maxNestingLevel; i++) {359      token = await collection.mintToken(alice, token.nestingAccount());360    }361362    // The nesting depth is limited by `maxNestingLevel`363    await expect(collection.mintToken(alice, token.nestingAccount()))364      .to.be.rejectedWith(/structure\.DepthLimit/);365    expect(await token.getTopmostOwner()).to.be.deep.equal({Substrate: alice.address});366    expect(await token.getChildren()).to.be.length(0);367  });368369  // ---------- Admin ------------370371  itSub('Admin (NFT): disallows an Admin to operate nesting when only TokenOwner is allowed', async ({helper}) => {372    const collection = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true}}});373    await collection.addAdmin(alice, {Substrate: bob.address});374    const targetToken = await collection.mintToken(alice);375376    // Try to create an immediately nested token as collection admin when it's disallowed377    await expect(collection.mintToken(bob, targetToken.nestingAccount()))378      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);379380    // Try to create a token to be nested and nest381    const newToken = await collection.mintToken(bob);382    await expect(newToken.nest(bob, targetToken))383      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);384385    expect(await targetToken.getChildren()).to.be.length(0);386    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: bob.address});387  });388389  itSub('Admin (NFT): disallows a Token Owner to operate nesting when only Admin is allowed', async ({helper}) => {390    const collection = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true, nesting: {collectionAdmin: true}}});391    const targetToken = await collection.mintToken(alice, {Substrate: bob.address});392    await collection.addToAllowList(alice, {Substrate: bob.address});393    await collection.addToAllowList(alice, targetToken.nestingAccount());394395    // Try to create a nested token as token owner when it's disallowed396    await expect(collection.mintToken(bob, targetToken.nestingAccount()))397      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);398399    // Try to create a token to be nested and nest400    const newToken = await collection.mintToken(bob);401    await expect(newToken.nest(bob, targetToken))402      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);403404    expect(await targetToken.getChildren()).to.be.length(0);405    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: bob.address});406  });407408  itSub('Admin (NFT): disallows an Admin to unnest someone else\'s token', async ({helper}) => {409    const collection = await helper.nft.mintCollection(alice, {limits: {ownerCanTransfer: true}, permissions: {access: 'AllowList', mintMode: true, nesting: {collectionAdmin: true}}});410    //await collection.addAdmin(alice, {Substrate: bob.address});411    const targetToken = await collection.mintToken(alice, {Substrate: bob.address});412    await collection.addToAllowList(alice, {Substrate: bob.address});413    await collection.addToAllowList(alice, targetToken.nestingAccount());414415    // Try to nest somebody else's token416    const newToken = await collection.mintToken(bob);417    await expect(newToken.nest(alice, targetToken))418      .to.be.rejectedWith(/common\.NoPermission/);419420    // Try to unnest a token belonging to someone else as collection admin421    const nestedToken = await collection.mintToken(alice, targetToken.nestingAccount());422    await expect(nestedToken.unnest(alice, targetToken, {Substrate: bob.address}))423      .to.be.rejectedWith(/common\.AddressNotInAllowlist/);424425    expect(await targetToken.getChildren()).to.be.length(1);426    expect(await nestedToken.getTopmostOwner()).to.be.deep.equal({Substrate: bob.address});427    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());428  });429430  itSub('Admin (NFT): disallows an Admin to nest a token from an unlisted collection (Restricted nesting)', async ({helper}) => {431    const collectionA = await helper.nft.mintCollection(alice);432    const collectionB = await helper.nft.mintCollection(alice);433    await collectionA.setPermissions(alice, {nesting: {collectionAdmin: true, restricted: [collectionA.collectionId]}});434    const targetToken = await collectionA.mintToken(alice);435436    // Try to create a nested token from another collection437    await expect(collectionB.mintToken(alice, targetToken.nestingAccount()))438      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);439440    // Create a token in another collection yet to be nested and try to nest441    const newToken = await collectionB.mintToken(alice);442    await expect(newToken.nest(alice, targetToken))443      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);444445    expect(await targetToken.getChildren()).to.be.length(0);446    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: alice.address});447  });448449  // ---------- Non-Fungible ----------450451  itSub('NFT: disallows to nest token if nesting is disabled', async ({helper}) => {452    // Collection is implicitly not allowed nesting at creation453    const collection = await helper.nft.mintCollection(alice);454    const targetToken = await collection.mintToken(alice);455456    // Try to create a nested token as token owner when it's disallowed457    await expect(collection.mintToken(alice, targetToken.nestingAccount()))458      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);459460    // Try to create a token to be nested and nest461    const newToken = await collection.mintToken(alice);462    await expect(newToken.nest(alice, targetToken))463      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);464465    expect(await targetToken.getChildren()).to.be.length(0);466    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: alice.address});467  });468469  itSub('NFT: disallows a non-Owner to nest someone else\'s token', async ({helper}) => {470    const collection = await helper.nft.mintCollection(alice);471    const targetToken = await collection.mintToken(alice);472473    await collection.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}});474    await collection.addToAllowList(alice, {Substrate: bob.address});475    await collection.addToAllowList(alice, targetToken.nestingAccount());476477    // Try to create a token to be nested and nest478    const newToken = await collection.mintToken(alice);479    await expect(newToken.nest(bob, targetToken)).to.be.rejectedWith(/common\.NoPermission/);480481    expect(await targetToken.getChildren()).to.be.length(0);482    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: alice.address});483  });484485  itSub('NFT: disallows a non-Owner to nest someone else\'s token (Restricted nesting)', async ({helper}) => {486    const collection = await helper.nft.mintCollection(alice);487    const targetToken = await collection.mintToken(alice);488489    await collection.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}});490    await collection.addToAllowList(alice, {Substrate: bob.address});491    await collection.addToAllowList(alice, targetToken.nestingAccount());492493    const collectionB = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true}});494    await collectionB.addToAllowList(alice, {Substrate: bob.address});495    await collectionB.addToAllowList(alice, targetToken.nestingAccount());496497    // Try to create a token to be nested and nest498    const newToken = await collectionB.mintToken(alice);499    await expect(newToken.nest(bob, targetToken)).to.be.rejectedWith(/common\.NoPermission/);500501    expect(await targetToken.getChildren()).to.be.length(0);502    expect(await newToken.getOwner()).to.be.deep.equal({Substrate: alice.address});503  });504505  itSub('NFT: disallows to nest token in an unlisted collection', async ({helper}) => {506    // Create collection with restricted nesting -- even self is not allowed507    const collection = await helper.nft.mintCollection(alice, {permissions: {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true, restricted: []}}});508    const targetToken = await collection.mintToken(alice, {Substrate: bob.address});509510    await collection.addToAllowList(alice, {Substrate: bob.address});511    await collection.addToAllowList(alice, targetToken.nestingAccount());512513    // Try to mint in own collection after allowlisting the accounts514    await expect(collection.mintToken(bob, targetToken.nestingAccount()))515      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);516  });517518  // ---------- Fungible ----------519520  itSub('Fungible: disallows to nest token if nesting is disabled', async ({helper}) => {521    const collectionNFT = await helper.nft.mintCollection(alice);522    const collectionFT = await helper.ft.mintCollection(alice);523    const targetToken = await collectionNFT.mintToken(alice);524525    // Try to create an immediately nested token526    await expect(collectionFT.mint(alice, 5n, targetToken.nestingAccount()))527      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);528529    // Try to create a token to be nested and nest530    await collectionFT.mint(alice, 5n);531    await expect(collectionFT.transfer(alice, targetToken.nestingAccount(), 2n))532      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);533    expect(await collectionFT.getBalance({Substrate: alice.address})).to.be.equal(5n);534  });535536  itSub('Fungible: disallows a non-Owner to unnest someone else\'s token', async ({helper}) => {537    const collectionNFT = await helper.nft.mintCollection(alice, {permissions: {nesting: {collectionAdmin: true, tokenOwner: true}}});538    const collectionFT = await helper.ft.mintCollection(alice);539    const targetToken = await collectionNFT.mintToken(alice, {Substrate: bob.address});540541    // Nest some tokens as Alice into Bob's token542    await collectionFT.mint(alice, 5n, targetToken.nestingAccount());543544    // Try to pull it out545    await expect(collectionFT.transferFrom(alice, targetToken.nestingAccount(), {Substrate: bob.address}, 1n))546      .to.be.rejectedWith(/common\.ApprovedValueTooLow/);547    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(5n);548  });549550  itSub('Fungible: disallows a non-Owner to unnest someone else\'s token (Restricted nesting)', async ({helper}) => {551    const collectionNFT = await helper.nft.mintCollection(alice);552    const collectionFT = await helper.ft.mintCollection(alice);553    const targetToken = await collectionNFT.mintToken(alice, {Substrate: bob.address});554555    await collectionNFT.setPermissions(alice, {nesting: {collectionAdmin: true, tokenOwner: true, restricted: [collectionFT.collectionId]}});556557    // Nest some tokens as Alice into Bob's token558    await collectionFT.mint(alice, 5n, targetToken.nestingAccount());559560    // Try to pull it out as Alice still561    await expect(collectionFT.transferFrom(alice, targetToken.nestingAccount(), {Substrate: bob.address}, 1n))562      .to.be.rejectedWith(/common\.ApprovedValueTooLow/);563    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(5n);564  });565566  itSub('Fungible: disallows to nest token in an unlisted collection', async ({helper}) => {567    const collectionNFT = await helper.nft.mintCollection(alice, {permissions: {nesting: {collectionAdmin: true, tokenOwner: true, restricted: []}}});568    const collectionFT = await helper.ft.mintCollection(alice);569    const targetToken = await collectionNFT.mintToken(alice);570571    // Try to mint an immediately nested token572    await expect(collectionFT.mint(alice, 5n, targetToken.nestingAccount()))573      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);574575    // Mint a token and try to nest it576    await collectionFT.mint(alice, 5n);577    await expect(collectionFT.transfer(alice, targetToken.nestingAccount(), 1n))578      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);579580    expect(await collectionFT.getBalance(targetToken.nestingAccount())).to.be.equal(0n);581    expect(await collectionFT.getBalance({Substrate: alice.address})).to.be.equal(5n);582  });583584  // ---------- Re-Fungible ----------585586  itSub.ifWithPallets('ReFungible: disallows to nest token if nesting is disabled', [Pallets.ReFungible], async ({helper}) => {587    const collectionNFT = await helper.nft.mintCollection(alice);588    const collectionRFT = await helper.rft.mintCollection(alice);589    const targetToken = await collectionNFT.mintToken(alice);590591    // Try to create an immediately nested token592    await expect(collectionRFT.mintToken(alice, 5n, targetToken.nestingAccount()))593      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);594595    // Try to create a token to be nested and nest596    const token = await collectionRFT.mintToken(alice, 5n);597    await expect(token.transfer(alice, targetToken.nestingAccount(), 2n))598      .to.be.rejectedWith(/common\.UserIsNotAllowedToNest/);599    expect(await token.getBalance({Substrate: alice.address})).to.be.equal(5n);600  });601602  itSub.ifWithPallets('ReFungible: disallows a non-Owner to nest someone else\'s token', [Pallets.ReFungible], async ({helper}) => {603    const collectionNFT = await helper.nft.mintCollection(alice);604    const collectionRFT = await helper.rft.mintCollection(alice);605    const targetToken = await collectionNFT.mintToken(alice);606607    await collectionNFT.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true}});608    await collectionNFT.addToAllowList(alice, {Substrate: bob.address});609    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());610611    // Try to create a token to be nested and nest612    const newToken = await collectionRFT.mintToken(alice);613    await expect(newToken.transfer(bob, targetToken.nestingAccount())).to.be.rejectedWith(/common\.TokenValueTooLow/);614615    expect(await targetToken.getChildren()).to.be.length(0);616    expect(await newToken.getBalance({Substrate: alice.address})).to.be.equal(1n);617618    // Nest some tokens as Alice into Bob's token619    await newToken.transfer(alice, targetToken.nestingAccount());620621    // Try to pull it out622    await expect(newToken.transferFrom(bob, targetToken.nestingAccount(), {Substrate: alice.address}, 1n))623      .to.be.rejectedWith(/common\.ApprovedValueTooLow/);624    expect(await newToken.getBalance(targetToken.nestingAccount())).to.be.equal(1n);625  });626627  itSub.ifWithPallets('ReFungible: disallows a non-Owner to nest someone else\'s token (Restricted nesting)', [Pallets.ReFungible], async ({helper}) => {628    const collectionNFT = await helper.nft.mintCollection(alice);629    const collectionRFT = await helper.rft.mintCollection(alice);630    const targetToken = await collectionNFT.mintToken(alice);631632    await collectionNFT.setPermissions(alice, {access: 'AllowList', mintMode: true, nesting: {tokenOwner: true, restricted: [collectionRFT.collectionId]}});633    await collectionNFT.addToAllowList(alice, {Substrate: bob.address});634    await collectionNFT.addToAllowList(alice, targetToken.nestingAccount());635636    // Try to create a token to be nested and nest637    const newToken = await collectionRFT.mintToken(alice);638    await expect(newToken.transfer(bob, targetToken.nestingAccount())).to.be.rejectedWith(/common\.TokenValueTooLow/);639640    expect(await targetToken.getChildren()).to.be.length(0);641    expect(await newToken.getBalance({Substrate: alice.address})).to.be.equal(1n);642643    // Nest some tokens as Alice into Bob's token644    await newToken.transfer(alice, targetToken.nestingAccount());645646    // Try to pull it out647    await expect(newToken.transferFrom(bob, targetToken.nestingAccount(), {Substrate: alice.address}, 1n))648      .to.be.rejectedWith(/common\.ApprovedValueTooLow/);649    expect(await newToken.getBalance(targetToken.nestingAccount())).to.be.equal(1n);650  });651652  itSub.ifWithPallets('ReFungible: disallows to nest token to an unlisted collection', [Pallets.ReFungible], async ({helper}) => {653    const collectionNFT = await helper.nft.mintCollection(alice, {permissions: {nesting: {tokenOwner: true, restricted: []}}});654    const collectionRFT = await helper.rft.mintCollection(alice);655    const targetToken = await collectionNFT.mintToken(alice);656657    // Try to create an immediately nested token658    await expect(collectionRFT.mintToken(alice, 5n, targetToken.nestingAccount()))659      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);660661    // Try to create a token to be nested and nest662    const token = await collectionRFT.mintToken(alice, 5n);663    await expect(token.transfer(alice, targetToken.nestingAccount(), 2n))664      .to.be.rejectedWith(/common\.SourceCollectionIsNotAllowedToNest/);665    expect(await token.getBalance({Substrate: alice.address})).to.be.equal(5n);666  });667});
modifiedtests/src/nesting/properties.test.tsdiffbeforeafterboth
--- a/tests/src/nesting/properties.test.ts
+++ b/tests/src/nesting/properties.test.ts
@@ -14,19 +14,10 @@
 // You should have received a copy of the GNU General Public License
 // along with Unique Network. If not, see <http://www.gnu.org/licenses/>.
 
-/*import usingApi, {executeTransaction} from '../substrate/substrate-api';
-import {
-  addCollectionAdminExpectSuccess,
-  CollectionMode,
-  createCollectionExpectSuccess,
-  setCollectionPermissionsExpectSuccess,
-  createItemExpectSuccess,
-  getCreateCollectionResult,
-  transferExpectSuccess,
-} from '../util/helpers';*/
 import {IKeyringPair} from '@polkadot/types/types';
 import {itSub, Pallets, requirePalletsOrSkip, usingPlaygrounds, expect} from '../util/playgrounds';
-import {UniqueCollectionBase, UniqueHelper, UniqueNFTCollection, UniqueNFTToken, UniqueRFTCollection, UniqueRFTToken} from '../util/playgrounds/unique';
+import {ICollectionBase, ICollectionNFT, ITokenNonfungible, ICollectionRFT, ITokenRefungible} from '../util/playgrounds/types';
+import {UniqueHelper} from '../util/playgrounds/unique';
 
 // ---------- COLLECTION PROPERTIES
 
@@ -46,7 +37,7 @@
     expect(await collection.getProperties()).to.be.empty;
   });
 
-  async function testSetsPropertiesForCollection(collection: UniqueCollectionBase) {
+  async function testSetsPropertiesForCollection(collection: ICollectionBase) {
     // As owner
     await expect(collection.setProperties(alice, [{key: 'electron', value: 'come bond'}])).to.be.fulfilled;
 
@@ -70,7 +61,7 @@
     await testSetsPropertiesForCollection(await helper.rft.mintCollection(alice));
   });
 
-  async function testCheckValidNames(collection: UniqueCollectionBase) {
+  async function testCheckValidNames(collection: ICollectionBase) {
     // alpha symbols
     await expect(collection.setProperties(alice, [{key: 'answer'}])).to.be.fulfilled;
 
@@ -104,7 +95,7 @@
     await testCheckValidNames(await helper.rft.mintCollection(alice));
   });
 
-  async function testChangesProperties(collection: UniqueCollectionBase) {
+  async function testChangesProperties(collection: ICollectionBase) {
     await expect(collection.setProperties(alice, [{key: 'electron', value: 'come bond'}, {key: 'black_hole', value: ''}])).to.be.fulfilled;
 
     // Mutate the properties
@@ -125,7 +116,7 @@
     await testChangesProperties(await helper.rft.mintCollection(alice));
   });
 
-  async function testDeleteProperties(collection: UniqueCollectionBase) {
+  async function testDeleteProperties(collection: ICollectionBase) {
     await expect(collection.setProperties(alice, [{key: 'electron', value: 'come bond'}, {key: 'black_hole', value: 'LIGO'}])).to.be.fulfilled;
 
     await expect(collection.deleteProperties(alice, ['electron'])).to.be.fulfilled;
@@ -156,7 +147,7 @@
     });
   });
   
-  async function testFailsSetPropertiesIfNotOwnerOrAdmin(collection: UniqueCollectionBase) {  
+  async function testFailsSetPropertiesIfNotOwnerOrAdmin(collection: ICollectionBase) {  
     await expect(collection.setProperties(bob, [{key: 'electron', value: 'come bond'}, {key: 'black_hole', value: 'LIGO'}]))
       .to.be.rejectedWith(/common\.NoPermission/);
 
@@ -171,7 +162,7 @@
     await testFailsSetPropertiesIfNotOwnerOrAdmin(await helper.rft.mintCollection(alice));
   });
   
-  async function testFailsSetPropertiesThatExeedLimits(collection: UniqueCollectionBase) {
+  async function testFailsSetPropertiesThatExeedLimits(collection: ICollectionBase) {
     const spaceLimit = (await (collection.helper!.api! as any).query.common.collectionProperties(collection.collectionId)).spaceLimit.toNumber();
   
     // Mute the general tx parsing error, too many bytes to process
@@ -200,7 +191,7 @@
     await testFailsSetPropertiesThatExeedLimits(await helper.rft.mintCollection(alice));
   });
   
-  async function testFailsSetMorePropertiesThanAllowed(collection: UniqueCollectionBase) {
+  async function testFailsSetMorePropertiesThanAllowed(collection: ICollectionBase) {
     const propertiesToBeSet = [];
     for (let i = 0; i < 65; i++) {
       propertiesToBeSet.push({
@@ -223,7 +214,7 @@
     await testFailsSetMorePropertiesThanAllowed(await helper.rft.mintCollection(alice));
   });
   
-  async function testFailsSetPropertiesWithInvalidNames(collection: UniqueCollectionBase) {
+  async function testFailsSetPropertiesWithInvalidNames(collection: ICollectionBase) {
     const invalidProperties = [
       [{key: 'electron', value: 'negative'}, {key: 'string theory', value: 'understandable'}],
       [{key: 'Mr/Sandman', value: 'Bring me a gene'}],
@@ -290,7 +281,7 @@
     expect(propertyRights).to.be.empty;
   });
   
-  async function testSetsAccessRightsToProperties(collection: UniqueNFTCollection | UniqueRFTCollection) {  
+  async function testSetsAccessRightsToProperties(collection: ICollectionNFT | ICollectionRFT) {  
     await expect(collection.setTokenPropertyPermissions(alice, [{key: 'skullduggery', permission: {mutable: true}}]))
       .to.be.fulfilled;
 
@@ -314,7 +305,7 @@
     await testSetsAccessRightsToProperties(await helper.rft.mintCollection(alice));
   });
   
-  async function testChangesAccessRightsToProperty(collection: UniqueNFTCollection | UniqueRFTCollection) {
+  async function testChangesAccessRightsToProperty(collection: ICollectionNFT | ICollectionRFT) {
     await expect(collection.setTokenPropertyPermissions(alice, [{key: 'skullduggery', permission: {mutable: true, collectionAdmin: true}}]))
       .to.be.fulfilled;
 
@@ -347,7 +338,7 @@
     });
   });
 
-  async function testPreventsFromSettingAccessRightsNotAdminOrOwner(collection: UniqueNFTCollection | UniqueRFTCollection) {
+  async function testPreventsFromSettingAccessRightsNotAdminOrOwner(collection: ICollectionNFT | ICollectionRFT) {
     await expect(collection.setTokenPropertyPermissions(bob, [{key: 'skullduggery', permission: {mutable: true, tokenOwner: true}}]))
       .to.be.rejectedWith(/common\.NoPermission/);
 
@@ -363,7 +354,7 @@
     await testPreventsFromSettingAccessRightsNotAdminOrOwner(await helper.rft.mintCollection(alice));
   });
 
-  async function testPreventFromAddingTooManyPossibleProperties(collection: UniqueNFTCollection | UniqueRFTCollection) {  
+  async function testPreventFromAddingTooManyPossibleProperties(collection: ICollectionNFT | ICollectionRFT) {  
     const constitution = [];
     for (let i = 0; i < 65; i++) {
       constitution.push({
@@ -387,7 +378,7 @@
     await testPreventFromAddingTooManyPossibleProperties(await helper.rft.mintCollection(alice));
   });
 
-  async function testPreventAccessRightsModifiedIfConstant(collection: UniqueNFTCollection | UniqueRFTCollection) {
+  async function testPreventAccessRightsModifiedIfConstant(collection: ICollectionNFT | ICollectionRFT) {
     await expect(collection.setTokenPropertyPermissions(alice, [{key: 'skullduggery', permission: {mutable: false, tokenOwner: true}}]))
       .to.be.fulfilled;
 
@@ -408,7 +399,7 @@
     await testPreventAccessRightsModifiedIfConstant(await helper.rft.mintCollection(alice));
   });
 
-  async function testPreventsAddingPropertiesWithInvalidNames(collection: UniqueNFTCollection | UniqueRFTCollection) {
+  async function testPreventsAddingPropertiesWithInvalidNames(collection: ICollectionNFT | ICollectionRFT) {
     const invalidProperties = [
       [{key: 'skullduggery', permission: {tokenOwner: true}}, {key: 'im possible', permission: {collectionAdmin: true}}],
       [{key: 'G#4', permission: {tokenOwner: true}}],
@@ -478,7 +469,7 @@
     ];
   });
   
-  async function testReadsYetEmptyProperties(token: UniqueNFTToken | UniqueRFTToken) {
+  async function testReadsYetEmptyProperties(token: ITokenNonfungible | ITokenRefungible) {
     const properties = await token.getProperties();
     expect(properties).to.be.empty;
 
@@ -498,7 +489,7 @@
     await testReadsYetEmptyProperties(token);
   });
 
-  async function testAssignPropertiesAccordingToPermissions(token: UniqueNFTToken | UniqueRFTToken, pieces: bigint) {
+  async function testAssignPropertiesAccordingToPermissions(token: ITokenNonfungible | ITokenRefungible, pieces: bigint) {
     await token.collection.addAdmin(alice, {Substrate: bob.address});
     await token.transfer(alice, {Substrate: charlie.address}, pieces);
 
@@ -544,7 +535,7 @@
     await testAssignPropertiesAccordingToPermissions(token, 100n);
   });
 
-  async function testChangesPropertiesAccordingPermission(token: UniqueNFTToken | UniqueRFTToken, pieces: bigint) {
+  async function testChangesPropertiesAccordingPermission(token: ITokenNonfungible | ITokenRefungible, pieces: bigint) {
     await token.collection.addAdmin(alice, {Substrate: bob.address});
     await token.transfer(alice, {Substrate: charlie.address}, pieces);
 
@@ -597,7 +588,7 @@
     await testChangesPropertiesAccordingPermission(token, 100n);
   });
 
-  async function testDeletePropertiesAccordingPermission(token: UniqueNFTToken | UniqueRFTToken, pieces: bigint) {
+  async function testDeletePropertiesAccordingPermission(token: ITokenNonfungible | ITokenRefungible, pieces: bigint) {
     await token.collection.addAdmin(alice, {Substrate: bob.address});
     await token.transfer(alice, {Substrate: charlie.address}, pieces);
 
@@ -808,7 +799,7 @@
     return (await (mode == 'NFT' ? api.query.nonfungible : api.query.refungible).tokenProperties(collectionId, tokenId)).toJSON().consumedSpace;
   }
 
-  async function prepare(token: UniqueNFTToken | UniqueRFTToken, pieces: bigint): Promise<number> {
+  async function prepare(token: ITokenNonfungible | ITokenRefungible, pieces: bigint): Promise<number> {
     await token.collection.addAdmin(alice, {Substrate: bob.address});
     await token.transfer(alice, {Substrate: charlie.address}, pieces);
 
@@ -832,7 +823,7 @@
     return originalSpace;
   }
 
-  async function testForbidsChangingDeletingPropertiesUserOutsideOfPermissions(token: UniqueNFTToken | UniqueRFTToken, pieces: bigint) {
+  async function testForbidsChangingDeletingPropertiesUserOutsideOfPermissions(token: ITokenNonfungible | ITokenRefungible, pieces: bigint) {
     const originalSpace = await prepare(token, pieces);
 
     let i = 0;
@@ -867,7 +858,7 @@
     await testForbidsChangingDeletingPropertiesUserOutsideOfPermissions(token, 100n);
   });
 
-  async function testForbidsChangingDeletingPropertiesIfPropertyImmutable(token: UniqueNFTToken | UniqueRFTToken, pieces: bigint) {
+  async function testForbidsChangingDeletingPropertiesIfPropertyImmutable(token: ITokenNonfungible | ITokenRefungible, pieces: bigint) {
     const originalSpace = await prepare(token, pieces);
 
     let i = 0;
@@ -902,7 +893,7 @@
     await testForbidsChangingDeletingPropertiesIfPropertyImmutable(token, 100n);
   });
 
-  async function testForbidsAddingPropertiesIfPropertyNotDeclared(token: UniqueNFTToken | UniqueRFTToken, pieces: bigint) {
+  async function testForbidsAddingPropertiesIfPropertyNotDeclared(token: ITokenNonfungible | ITokenRefungible, pieces: bigint) {
     const originalSpace = await prepare(token, pieces);
 
     await expect(
@@ -938,7 +929,7 @@
     await testForbidsAddingPropertiesIfPropertyNotDeclared(token, 100n);
   });
 
-  async function testForbidsAddingTooManyProperties(token: UniqueNFTToken | UniqueRFTToken, pieces: bigint) {
+  async function testForbidsAddingTooManyProperties(token: ITokenNonfungible | ITokenRefungible, pieces: bigint) {
     const originalSpace = await prepare(token, pieces);
 
     await expect(
@@ -993,7 +984,7 @@
     });
   });
 
-  async function prepare(helper: UniqueHelper): Promise<UniqueRFTToken> {
+  async function prepare(helper: UniqueHelper): Promise<ITokenRefungible> {
     const collection = await helper.rft.mintCollection(alice);
     const token = await collection.mintToken(alice, 100n);
     
modifiedtests/src/nesting/unnest.test.tsdiffbeforeafterboth
--- a/tests/src/nesting/unnest.test.ts
+++ b/tests/src/nesting/unnest.test.ts
@@ -105,11 +105,11 @@
 
     // Try to unnest
     await expect(nestedToken.unnest(bob, targetToken, {Substrate: alice.address})).to.be.rejectedWith(/common\.ApprovedValueTooLow/);
-    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());
+    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());
 
     // Try to burn
     await expect(nestedToken.burnFrom(bob, targetToken.nestingAccount())).to.be.rejectedWith(/common\.ApprovedValueTooLow/);
-    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccount());
+    expect(await nestedToken.getOwner()).to.be.deep.equal(targetToken.nestingAccountInLowerCase());
   });
 
   // todo another test for creating excessive depth matryoshka with Ethereum?
modifiedtests/src/util/playgrounds/index.tsdiffbeforeafterboth
--- a/tests/src/util/playgrounds/index.ts
+++ b/tests/src/util/playgrounds/index.ts
@@ -9,10 +9,16 @@
 import '../../interfaces/augment-api-events';
 import {DevUniqueHelper, SilentLogger, SilentConsole} from './unique.dev';
 
-
 chai.use(chaiAsPromised);
 export const expect = chai.expect;
 
+export const U128_MAX = (1n << 128n) - 1n;
+
+const MICROUNIQUE = 1_000_000_000_000n;
+const MILLIUNIQUE = 1_000n * MICROUNIQUE;
+const CENTIUNIQUE = 10n * MILLIUNIQUE;
+export const UNIQUE = 100n * CENTIUNIQUE;
+
 export const usingPlaygrounds = async (code: (helper: DevUniqueHelper, privateKey: (seed: string) => IKeyringPair) => Promise<void>, url: string = config.substrateUrl) => {
   const silentConsole = new SilentConsole();
   silentConsole.enable();
modifiedtests/src/util/playgrounds/types.tsdiffbeforeafterboth
--- a/tests/src/util/playgrounds/types.ts
+++ b/tests/src/util/playgrounds/types.ts
@@ -2,6 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import {IKeyringPair} from '@polkadot/types/types';
+import {UniqueHelper} from './unique';
 
 export interface IEvent {
   section: string;
@@ -106,7 +107,7 @@
   }
 }
 
-export interface IToken {
+export interface ITokenAddress {
   collectionId: number;
   tokenId: number;
 }
@@ -167,3 +168,169 @@
 export type TApiAllowedListeners = 'connected' | 'disconnected' | 'error' | 'ready' | 'decorated';
 export type TUniqueNetworks = 'opal' | 'quartz' | 'unique';
 export type TSigner = IKeyringPair; // | 'string'
+
+export interface ICollectionBase {
+  helper: UniqueHelper;
+  collectionId: number;
+  getData: () => Promise<{
+    id: number;
+    name: string;
+    description: string;
+    tokensCount: number;
+    admins: ICrossAccountId[];
+    normalizedOwner: TSubstrateAccount;
+    raw: any
+  } | null>;
+  getLastTokenId: () => Promise<number>;
+  isTokenExists: (tokenId: number) => Promise<boolean>;
+  getAdmins: () => Promise<ICrossAccountId[]>;
+  getAllowList: () => Promise<ICrossAccountId[]>;
+  getEffectiveLimits: () => Promise<ICollectionLimits>;
+  getProperties: (propertyKeys?: string[]) => Promise<IProperty[]>;
+  getTokenNextSponsored: (tokenId: number, addressObj: ICrossAccountId) => Promise<number | null>;
+  setSponsor: (signer: TSigner, sponsorAddress: TSubstrateAccount) => Promise<boolean>;
+  confirmSponsorship: (signer: TSigner) => Promise<boolean>;
+  removeSponsor: (signer: TSigner) => Promise<boolean>;
+  setLimits: (signer: TSigner, limits: ICollectionLimits) => Promise<boolean>;
+  changeOwner: (signer: TSigner, ownerAddress: TSubstrateAccount) => Promise<boolean>;
+  addAdmin: (signer: TSigner, adminAddressObj: ICrossAccountId) => Promise<boolean>;
+  addToAllowList: (signer: TSigner, addressObj: ICrossAccountId) => Promise<boolean>;
+  removeFromAllowList: (signer: TSigner, addressObj: ICrossAccountId) => Promise<boolean>;
+  removeAdmin: (signer: TSigner, adminAddressObj: ICrossAccountId) => Promise<boolean>;
+  setProperties: (signer: TSigner, properties: IProperty[]) => Promise<boolean>;
+  deleteProperties: (signer: TSigner, propertyKeys: string[]) => Promise<boolean>;
+  setPermissions: (signer: TSigner, permissions: ICollectionPermissions) => Promise<boolean>;
+  enableNesting: (signer: TSigner, permissions: INestingPermissions) => Promise<boolean>;
+  disableNesting: (signer: TSigner) => Promise<boolean>;
+  burn: (signer: TSigner) => Promise<boolean>;
+}
+
+export interface ICollectionNFT extends ICollectionBase {
+  getTokenObject: (tokenId: number) => ITokenNonfungible; // todo:playgrounds
+  getTokensByAddress: (addressObj: ICrossAccountId) => Promise<number[]>;
+  getToken: (tokenId: number, blockHashAt?: string) => Promise<{
+    properties: IProperty[];
+    owner: ICrossAccountId;
+    normalizedOwner: ICrossAccountId;
+  }| null>;
+  getTokenOwner: (tokenId: number, blockHashAt?: string) => Promise<ICrossAccountId>;
+  getTokenTopmostOwner: (tokenId: number, blockHashAt?: string) => Promise<ICrossAccountId | null>;
+  getTokenChildren: (tokenId: number, blockHashAt?: string) => Promise<ITokenAddress[]>; // todo:playgrounds
+  getPropertyPermissions: (propertyKeys?: string[]) => Promise<ITokenPropertyPermission[]>;
+  getTokenProperties: (tokenId: number, propertyKeys?: string[]) => Promise<IProperty[]>;
+  transferToken: (signer: TSigner, tokenId: number, addressObj: ICrossAccountId) => Promise<boolean>;
+  transferTokenFrom: (signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) => Promise<boolean>;
+  approveToken: (signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId) => Promise<boolean>;
+  isTokenApproved: (tokenId: number, toAddressObj: ICrossAccountId) => Promise<boolean>;
+  mintToken: (signer: TSigner, owner: ICrossAccountId, properties?: IProperty[]) => Promise<ITokenNonfungible>;// todo:playgrounds
+  mintMultipleTokens: (signer: TSigner, tokens: {owner: ICrossAccountId, properties?: IProperty[]}[]) => Promise<ITokenNonfungible[]>;// todo:playgrounds
+  burnToken: (signer: TSigner, tokenId: number) => Promise<{
+    success: boolean,
+    token: number | null
+  }>;
+  burnTokenFrom: (signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId) => Promise<boolean>;
+  setTokenProperties: (signer: TSigner, tokenId: number, properties: IProperty[]) => Promise<boolean>;
+  deleteTokenProperties: (signer: TSigner, tokenId: number, propertyKeys: string[]) => Promise<boolean>;
+  setTokenPropertyPermissions: (signer: TSigner, permissions: ITokenPropertyPermission[]) => Promise<boolean>;
+  nestToken: (signer: TSigner, tokenId: number, toTokenObj: ITokenAddress) => Promise<boolean>;
+  unnestToken: (signer: TSigner, tokenId: number, fromTokenObj: ITokenAddress, toAddressObj: ICrossAccountId) => Promise<boolean>;
+}
+
+export interface ICollectionRFT extends ICollectionBase {
+  getTokenObject: (tokenId: number) => ITokenRefungible;
+  getToken: (tokenId: number, blockHashAt?: string) => Promise<{
+    properties: IProperty[];
+    owner: ICrossAccountId;
+    normalizedOwner: ICrossAccountId;
+  }| null>;
+  getTokensByAddress: (addressObj: ICrossAccountId) => Promise<number[]>;
+  getTop10TokenOwners: (tokenId: number) => Promise<ICrossAccountId[]>;
+  getTokenBalance: (tokenId: number, addressObj: ICrossAccountId) => Promise<bigint>;
+  getTokenTotalPieces: (tokenId: number) => Promise<bigint>;
+  getTokenApprovedPieces: (tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) => Promise<bigint>;
+  getPropertyPermissions: (propertyKeys?: string[] | null) => Promise<ITokenPropertyPermission[]>;
+  getTokenProperties: (tokenId: number, propertyKeys?: string[]) => Promise<IProperty[]>;
+  transferToken: (signer: TSigner, tokenId: number, addressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+  transferTokenFrom: (signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+  approveToken: (signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+  repartitionToken: (signer: TSigner, tokenId: number, amount: bigint) => Promise<boolean>;
+  mintToken: (signer: TSigner, pieces: bigint, owner: ICrossAccountId, properties?: IProperty[]) => Promise<ITokenRefungible>;
+  mintMultipleTokens: (signer: TSigner, tokens: {pieces: bigint, owner: ICrossAccountId, properties?: IProperty[]}[]) => Promise<ITokenRefungible[]>; // todo:playgrounds
+  burnToken: (signer: TSigner, tokenId: number, amount: bigint) => Promise<{
+    success: boolean,
+    token: number | null
+  }>;
+  burnTokenFrom: (signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId,  amount: bigint) => Promise<boolean>;
+  setTokenProperties: (signer: TSigner, tokenId: number, properties: IProperty[]) => Promise<boolean>;
+  deleteTokenProperties: (signer: TSigner, tokenId: number, propertyKeys: string[]) => Promise<boolean>;
+  setTokenPropertyPermissions: (signer: TSigner, permissions: ITokenPropertyPermission[]) => Promise<boolean>;
+}
+
+export interface ICollectionFT extends ICollectionBase {
+  getBalance: (addressObj: ICrossAccountId) => Promise<bigint>;
+  getTotalPieces: () => Promise<bigint>;
+  getApprovedTokens: (fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) => Promise<bigint>;
+  getTop10Owners: () => Promise<ICrossAccountId[]>;
+  mint: (signer: TSigner, amount: bigint, owner: ICrossAccountId) => Promise<boolean>;
+  mintWithOneOwner: (signer: TSigner, tokens: {value: bigint}[], owner: ICrossAccountId) => Promise<boolean>;
+  transfer: (signer: TSigner, toAddressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+  transferFrom: (signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+  burnTokens: (signer: TSigner, amount: bigint) => Promise<boolean>;
+  burnTokensFrom: (signer: TSigner, fromAddressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+  approveTokens: (signer: TSigner, toAddressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+}
+
+export interface ITokenBase extends ITokenAddress {
+  collection: ICollectionNFT | ICollectionRFT;
+  getNextSponsored: (addressObj: ICrossAccountId) => Promise<number|null>;
+  getProperties: (propertyKeys?: string[]) => Promise<IProperty[]>;
+  setProperties: (signer: TSigner, properties: IProperty[]) => Promise<boolean>;
+  deleteProperties: (signer: TSigner, propertyKeys: string[]) => Promise<boolean>;
+  nestingAccount: () => ICrossAccountId;
+  nestingAccountInLowerCase: () => ICrossAccountId;
+}
+
+export interface ITokenNonfungible extends ITokenBase {
+  collection: ICollectionNFT;
+  getData: (blockHashAt?: string) => Promise<{
+    properties: IProperty[];
+    owner: ICrossAccountId;
+    normalizedOwner: ICrossAccountId;
+  }| null>;
+  getOwner: (blockHashAt?: string) => Promise<ICrossAccountId>;
+  getTopmostOwner: (blockHashAt?: string) => Promise<ICrossAccountId | null>;
+  getChildren: (blockHashAt?: string) => Promise<ITokenAddress[]>; // todo:playgrounds
+  nest: (signer: TSigner, toTokenObj: ITokenAddress) => Promise<boolean>;
+  unnest: (signer: TSigner, fromTokenObj: ITokenAddress, toAddressObj: ICrossAccountId) => Promise<boolean>;
+  transfer: (signer: TSigner, addressObj: ICrossAccountId) => Promise<boolean>;
+  transferFrom: (signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) => Promise<boolean>;
+  approve: (signer: TSigner, toAddressObj: ICrossAccountId) => Promise<boolean>;
+  isApproved: (toAddressObj: ICrossAccountId) => Promise<boolean>;
+  burn: (signer: TSigner) => Promise<{
+    success: boolean,
+    token: number | null
+  }>;
+  burnFrom: (signer: TSigner, fromAddressObj: ICrossAccountId) => Promise<boolean>;
+}
+
+export interface ITokenRefungible extends ITokenBase {
+  collection: ICollectionRFT;
+  getData: (blockHashAt?: string) => Promise<{
+    properties: IProperty[];
+    owner: ICrossAccountId;
+    normalizedOwner: ICrossAccountId;
+  }| null>;
+  getTop10Owners: () => Promise<ICrossAccountId[]>;
+  getBalance: (addressObj: ICrossAccountId) => Promise<bigint>;
+  getTotalPieces: () => Promise<bigint>;
+  getApprovedPieces: (fromAddressObj: ICrossAccountId, toAccountObj: ICrossAccountId) => Promise<bigint>;
+  transfer: (signer: TSigner, addressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+  transferFrom: (signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+  approve: (signer: TSigner, toAddressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+  repartition: (signer: TSigner, amount: bigint) => Promise<boolean>;
+  burn: (signer: TSigner, amount: bigint) => Promise<{
+    success: boolean,
+    token: number | null
+  }>;
+  burnFrom: (signer: TSigner, fromAddressObj: ICrossAccountId, amount: bigint) => Promise<boolean>;
+}
modifiedtests/src/util/playgrounds/unique.tsdiffbeforeafterboth
--- a/tests/src/util/playgrounds/unique.ts
+++ b/tests/src/util/playgrounds/unique.ts
@@ -9,7 +9,7 @@
 import {ApiInterfaceEvents, SignerOptions} from '@polkadot/api/types';
 import {encodeAddress, decodeAddress, keccakAsHex, evmToAddress, addressToEvm} from '@polkadot/util-crypto';
 import {IKeyringPair} from '@polkadot/types/types';
-import {IApiListeners, IBlock, IEvent, IChainProperties, ICollectionCreationOptions, ICollectionLimits, ICollectionPermissions, ICrossAccountId, ICrossAccountIdLower, ILogger, INestingPermissions, IProperty, IStakingInfo, ISubstrateBalance, IToken, ITokenPropertyPermission, ITransactionResult, IUniqueHelperLog, TApiAllowedListeners, TEthereumAccount, TSigner, TSubstrateAccount, TUniqueNetworks} from './types';
+import {IApiListeners, IBlock, IEvent, IChainProperties, ICollectionCreationOptions, ICollectionLimits, ICollectionPermissions, ICrossAccountId, ICrossAccountIdLower, ILogger, INestingPermissions, IProperty, IStakingInfo, ISubstrateBalance, ITokenAddress, ITokenPropertyPermission, ITransactionResult, IUniqueHelperLog, TApiAllowedListeners, TEthereumAccount, TSigner, TSubstrateAccount, TUniqueNetworks, ICollectionBase, ICollectionNFT, ICollectionRFT, ITokenBase, ITokenNonfungible, ITokenRefungible, ICollectionFT} from './types';
 
 export const crossAccountIdFromLower = (lowerAddress: ICrossAccountIdLower): ICrossAccountId => {
   const address = {} as ICrossAccountId;
@@ -55,11 +55,15 @@
     RPC: 'rpc',
   };
 
-  static getTokenAccount(token: IToken) {
+  static getTokenAccount(token: ITokenAddress): ICrossAccountId {
+    return {Ethereum: this.getTokenAddress(token)};
+  }
+
+  static getTokenAccountInLowerCase(token: ITokenAddress): ICrossAccountId {
     return {Ethereum: this.getTokenAddress(token).toLowerCase()};
   }
 
-  static getTokenAddress(token: IToken) {
+  static getTokenAddress(token: ITokenAddress): string {
     return nesting.tokenIdToAddress(token.collectionId, token.tokenId);
   }
 
@@ -1348,7 +1352,7 @@
    * @example getTokenChildren(10, 5);
    * @returns tokens whose depth of nesting is <= 5
    */
-  async getTokenChildren(collectionId: number, tokenId: number, blockHashAt?: string): Promise<IToken[]> {
+  async getTokenChildren(collectionId: number, tokenId: number, blockHashAt?: string): Promise<ITokenAddress[]> {
     let children;
     if(typeof blockHashAt === 'undefined') {
       children = await this.helper.callRpc('api.rpc.unique.tokenChildren', [collectionId, tokenId]);
@@ -1369,7 +1373,7 @@
    * @example nestToken(aliceKeyring, {collectionId: 10, tokenId: 5}, {collectionId: 10, tokenId: 4});
    * @returns ```true``` if extrinsic success, otherwise ```false```
    */
-  async nestToken(signer: TSigner, tokenObj: IToken, rootTokenObj: IToken): Promise<boolean> {
+  async nestToken(signer: TSigner, tokenObj: ITokenAddress, rootTokenObj: ITokenAddress): Promise<boolean> {
     const rootTokenAddress = this.helper.util.getTokenAccount(rootTokenObj);
     const result = await this.transferToken(signer, tokenObj.collectionId, tokenObj.tokenId, rootTokenAddress);
     if(!result) {
@@ -1387,7 +1391,7 @@
    * @example unnestToken(aliceKeyring, {collectionId: 10, tokenId: 5}, {collectionId: 10, tokenId: 4}, {Substrate: "5DyN4Y92vZCjv38fg..."});
    * @returns ```true``` if extrinsic success, otherwise ```false```
    */
-  async unnestToken(signer: TSigner, tokenObj: IToken, rootTokenObj: IToken, toAddressObj: ICrossAccountId): Promise<boolean> {
+  async unnestToken(signer: TSigner, tokenObj: ITokenAddress, rootTokenObj: ITokenAddress, toAddressObj: ICrossAccountId): Promise<boolean> {
     const rootTokenAddress = this.helper.util.getTokenAccount(rootTokenObj);
     const result = await this.transferTokenFrom(signer, tokenObj.collectionId, tokenObj.tokenId, rootTokenAddress, toAddressObj);
     if(!result) {
@@ -1456,7 +1460,7 @@
       true,
     );
     const collection = this.getCollectionObject(collectionId);
-    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));
+    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: ITokenAddress) => collection.getTokenObject(x.tokenId));
   }
 
   /**
@@ -1489,7 +1493,7 @@
       true,
     );
     const collection = this.getCollectionObject(collectionId);
-    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));
+    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: ITokenAddress) => collection.getTokenObject(x.tokenId));
   }
 
   /**
@@ -1630,7 +1634,7 @@
       true, // `Unable to mint RFT tokens for ${label}`,
     );
     const collection = this.getCollectionObject(collectionId);
-    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));
+    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: ITokenAddress) => collection.getTokenObject(x.tokenId));
   }
 
   /**
@@ -1654,7 +1658,7 @@
       true,
     );
     const collection = this.getCollectionObject(collectionId);
-    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));
+    return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: ITokenAddress) => collection.getTokenObject(x.tokenId));
   }
 
   /**
@@ -2219,7 +2223,7 @@
 }
 
 
-export class UniqueCollectionBase {
+class UniqueCollectionBase implements ICollectionBase {
   helper: UniqueHelper;
   collectionId: number;
 
@@ -2256,6 +2260,10 @@
     return await this.helper.collection.getProperties(this.collectionId, propertyKeys);
   }
 
+  async getTokenNextSponsored(tokenId: number, addressObj: ICrossAccountId) {
+    return await this.helper.collection.getTokenNextSponsored(this.collectionId, tokenId, addressObj);
+  }
+
   async setSponsor(signer: TSigner, sponsorAddress: TSubstrateAccount) {
     return await this.helper.collection.setSponsor(signer, this.collectionId, sponsorAddress);
   }
@@ -2300,10 +2308,6 @@
     return await this.helper.collection.deleteProperties(signer, this.collectionId, propertyKeys);
   }
 
-  async getTokenNextSponsored(tokenId: number, addressObj: ICrossAccountId) {
-    return await this.helper.collection.getTokenNextSponsored(this.collectionId, tokenId, addressObj);
-  }
-
   async setPermissions(signer: TSigner, permissions: ICollectionPermissions) {
     return await this.helper.collection.setPermissions(signer, this.collectionId, permissions);
   }
@@ -2322,7 +2326,7 @@
 }
 
 
-export class UniqueNFTCollection extends UniqueCollectionBase {
+class UniqueNFTCollection extends UniqueCollectionBase implements ICollectionNFT {
   getTokenObject(tokenId: number) {
     return new UniqueNFTToken(tokenId, this);
   }
@@ -2399,17 +2403,17 @@
     return await this.helper.nft.setTokenPropertyPermissions(signer, this.collectionId, permissions);
   }
 
-  async nestToken(signer: TSigner, tokenId: number, toTokenObj: IToken) {
+  async nestToken(signer: TSigner, tokenId: number, toTokenObj: ITokenAddress) {
     return await this.helper.nft.nestToken(signer, {collectionId: this.collectionId, tokenId}, toTokenObj);
   }
 
-  async unnestToken(signer: TSigner, tokenId: number, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {
+  async unnestToken(signer: TSigner, tokenId: number, fromTokenObj: ITokenAddress, toAddressObj: ICrossAccountId) {
     return await this.helper.nft.unnestToken(signer, {collectionId: this.collectionId, tokenId}, fromTokenObj, toAddressObj);
   }
 }
 
 
-export class UniqueRFTCollection extends UniqueCollectionBase {
+class UniqueRFTCollection extends UniqueCollectionBase implements ICollectionRFT {
   getTokenObject(tokenId: number) {
     return new UniqueRFTToken(tokenId, this);
   }
@@ -2434,6 +2438,10 @@
     return await this.helper.rft.getTokenTotalPieces(this.collectionId, tokenId);
   }
 
+  async getTokenApprovedPieces(tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {
+    return await this.helper.rft.getTokenApprovedPieces(this.collectionId, tokenId, toAddressObj, fromAddressObj);
+  }
+
   async getPropertyPermissions(propertyKeys: string[] | null = null) {
     return await this.helper.rft.getPropertyPermissions(this.collectionId, propertyKeys);
   }
@@ -2452,10 +2460,6 @@
 
   async approveToken(signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId, amount=1n) {
     return await this.helper.rft.approveToken(signer, this.collectionId, tokenId, toAddressObj, amount);
-  }
-
-  async getTokenApprovedPieces(tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {
-    return await this.helper.rft.getTokenApprovedPieces(this.collectionId, tokenId, toAddressObj, fromAddressObj);
   }
 
   async repartitionToken(signer: TSigner, tokenId: number, amount: bigint) {
@@ -2492,23 +2496,31 @@
 }
 
 
-export class UniqueFTCollection extends UniqueCollectionBase {
-  async mint(signer: TSigner, amount=1n, owner: ICrossAccountId = {Substrate: signer.address}) {
-    return await this.helper.ft.mintTokens(signer, this.collectionId, amount, owner);
+class UniqueFTCollection extends UniqueCollectionBase implements ICollectionFT {
+  async getBalance(addressObj: ICrossAccountId) {
+    return await this.helper.ft.getBalance(this.collectionId, addressObj);
   }
 
-  async mintWithOneOwner(signer: TSigner, tokens: {value: bigint}[], owner: ICrossAccountId = {Substrate: signer.address}) {
-    return await this.helper.ft.mintMultipleTokensWithOneOwner(signer, this.collectionId, tokens, owner);
+  async getTotalPieces() {
+    return await this.helper.ft.getTotalPieces(this.collectionId);
   }
 
-  async getBalance(addressObj: ICrossAccountId) {
-    return await this.helper.ft.getBalance(this.collectionId, addressObj);
+  async getApprovedTokens(fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {
+    return await this.helper.ft.getApprovedTokens(this.collectionId, fromAddressObj, toAddressObj);
   }
 
   async getTop10Owners() {
     return await this.helper.ft.getTop10Owners(this.collectionId);
   }
 
+  async mint(signer: TSigner, amount=1n, owner: ICrossAccountId = {Substrate: signer.address}) {
+    return await this.helper.ft.mintTokens(signer, this.collectionId, amount, owner);
+  }
+
+  async mintWithOneOwner(signer: TSigner, tokens: {value: bigint}[], owner: ICrossAccountId = {Substrate: signer.address}) {
+    return await this.helper.ft.mintMultipleTokensWithOneOwner(signer, this.collectionId, tokens, owner);
+  }
+
   async transfer(signer: TSigner, toAddressObj: ICrossAccountId, amount=1n) {
     return await this.helper.ft.transfer(signer, this.collectionId, toAddressObj, amount);
   }
@@ -2523,23 +2535,15 @@
 
   async burnTokensFrom(signer: TSigner, fromAddressObj: ICrossAccountId, amount=1n) {
     return await this.helper.ft.burnTokensFrom(signer, this.collectionId, fromAddressObj, amount);
-  }
-
-  async getTotalPieces() {
-    return await this.helper.ft.getTotalPieces(this.collectionId);
   }
 
   async approveTokens(signer: TSigner, toAddressObj: ICrossAccountId, amount=1n) {
     return await this.helper.ft.approveTokens(signer, this.collectionId, toAddressObj, amount);
   }
-
-  async getApprovedTokens(fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {
-    return await this.helper.ft.getApprovedTokens(this.collectionId, fromAddressObj, toAddressObj);
-  }
 }
 
 
-export class UniqueTokenBase implements IToken {
+class UniqueTokenBase implements ITokenBase {
   collection: UniqueNFTCollection | UniqueRFTCollection;
   collectionId: number;
   tokenId: number;
@@ -2569,10 +2573,14 @@
   nestingAccount() {
     return this.collection.helper.util.getTokenAccount(this);
   }
+
+  nestingAccountInLowerCase() {
+    return this.collection.helper.util.getTokenAccountInLowerCase(this);
+  }
 }
 
 
-export class UniqueNFTToken extends UniqueTokenBase {
+class UniqueNFTToken extends UniqueTokenBase implements ITokenNonfungible {
   collection: UniqueNFTCollection;
 
   constructor(tokenId: number, collection: UniqueNFTCollection) {
@@ -2596,11 +2604,11 @@
     return await this.collection.getTokenChildren(this.tokenId, blockHashAt);
   }
 
-  async nest(signer: TSigner, toTokenObj: IToken) {
+  async nest(signer: TSigner, toTokenObj: ITokenAddress) {
     return await this.collection.nestToken(signer, this.tokenId, toTokenObj);
   }
 
-  async unnest(signer: TSigner, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {
+  async unnest(signer: TSigner, fromTokenObj: ITokenAddress, toAddressObj: ICrossAccountId) {
     return await this.collection.unnestToken(signer, this.tokenId, fromTokenObj, toAddressObj);
   }
 
@@ -2629,7 +2637,7 @@
   }
 }
 
-export class UniqueRFTToken extends UniqueTokenBase {
+class UniqueRFTToken extends UniqueTokenBase implements ITokenRefungible {
   collection: UniqueRFTCollection;
 
   constructor(tokenId: number, collection: UniqueRFTCollection) {
@@ -2653,6 +2661,10 @@
     return await this.collection.getTokenTotalPieces(this.tokenId);
   }
 
+  async getApprovedPieces(fromAddressObj: ICrossAccountId, toAccountObj: ICrossAccountId) {
+    return await this.collection.getTokenApprovedPieces(this.tokenId, fromAddressObj, toAccountObj);
+  }
+
   async transfer(signer: TSigner, addressObj: ICrossAccountId, amount=1n) {
     return await this.collection.transferToken(signer, this.tokenId, addressObj, amount);
   }
@@ -2663,10 +2675,6 @@
 
   async approve(signer: TSigner, toAddressObj: ICrossAccountId, amount=1n) {
     return await this.collection.approveToken(signer, this.tokenId, toAddressObj, amount);
-  }
-
-  async getApprovedPieces(fromAddressObj: ICrossAccountId, toAccountObj: ICrossAccountId) {
-    return await this.collection.getTokenApprovedPieces(this.tokenId, fromAddressObj, toAccountObj);
   }
 
   async repartition(signer: TSigner, amount: bigint) {