1234567891011121314151617import {IKeyringPair} from '@polkadot/types/types';18import {ApiPromise} from '@polkadot/api';19import {expect, itSched, itSub, Pallets, requirePalletsOrSkip, usingPlaygrounds} from './util';20import {itEth} from './eth/util';21import {UniqueHelper} from './util/playgrounds/unique';2223async function maintenanceEnabled(api: ApiPromise): Promise<boolean> {24 return (await api.query.maintenance.enabled()).toJSON() as boolean;25}2627describe('Integration Test: Maintenance Functionality', () => {28 let superuser: IKeyringPair;29 let donor: IKeyringPair;30 let bob: IKeyringPair;3132 before(async function() {33 await usingPlaygrounds(async (helper, privateKey) => {34 requirePalletsOrSkip(this, helper, [Pallets.Maintenance]);35 superuser = await privateKey('//Alice');36 donor = await privateKey({url: import.meta.url});37 [bob] = await helper.arrange.createAccounts([10000n], donor);3839 });40 });4142 describe('Maintenance Mode', () => {43 before(async function() {44 await usingPlaygrounds(async (helper) => {45 if (await maintenanceEnabled(helper.getApi())) {46 console.warn('\tMaintenance mode was left enabled BEFORE the test suite! Disabling it now.');47 await expect(helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', [])).to.be.fulfilled;48 }49 });50 });5152 itSub('Allows superuser to enable and disable maintenance mode - and disallows anyone else', async ({helper}) => {53 54 await expect(helper.executeExtrinsic(superuser, 'api.tx.maintenance.enable', []), 'on commoner enabling MM')55 .to.be.rejectedWith(/BadOrigin/);5657 58 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.enable', []);59 expect(await maintenanceEnabled(helper.getApi()), 'MM is OFF when it should be ON').to.be.true;6061 62 await expect(helper.executeExtrinsic(bob, 'api.tx.maintenance.disable', []), 'on commoner disabling MM')63 .to.be.rejectedWith(/BadOrigin/);6465 66 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', []);67 expect(await maintenanceEnabled(helper.getApi()), 'MM is ON when it should be OFF').to.be.false;68 });6970 itSub('MM blocks unique pallet calls', async ({helper}) => {71 72 const nftCollection = await helper.nft.mintCollection(bob, {73 tokenPropertyPermissions: [{key: 'test', permission: {74 collectionAdmin: true,75 tokenOwner: true,76 mutable: true,77 }}],78 });7980 81 const nft = await nftCollection.mintToken(bob);8283 84 const ftCollection = await helper.ft.mintCollection(superuser);8586 87 await expect(ftCollection.mint(superuser)).to.be.fulfilled;8889 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.enable', []);90 expect(await maintenanceEnabled(helper.getApi()), 'MM is OFF when it should be ON').to.be.true;9192 93 await expect(helper.nft.mintCollection(superuser), 'cudo forbidden stuff')94 .to.be.rejectedWith(/Invalid Transaction: Transaction call is not expected/);9596 97 await expect(nft.setProperties(98 bob,99 [{key: 'test', value: 'test-val'}],100 )).to.be.rejectedWith(/Invalid Transaction: Transaction call is not expected/);101102 103 await expect(nftCollection.mintToken(superuser))104 .to.be.rejectedWith(/Invalid Transaction: Transaction call is not expected/);105106 107 await expect(ftCollection.mint(superuser))108 .to.be.rejectedWith(/Invalid Transaction: Transaction call is not expected/);109110 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', []);111 expect(await maintenanceEnabled(helper.getApi()), 'MM is ON when it should be OFF').to.be.false;112113 114 await expect(helper.nft.mintCollection(bob), 'MM is disabled, the collection should be created').to.be.fulfilled;115116 117 await nft.setProperties(bob, [{key: 'test', value: 'test-val'}]);118119 120 await nftCollection.mintToken(bob);121122 123 await ftCollection.mint(superuser);124 });125126 itSub.ifWithPallets('MM blocks unique pallet calls (Re-Fungible)', [Pallets.ReFungible], async ({helper}) => {127 128 const rftCollection = await helper.rft.mintCollection(superuser);129130 131 await expect(rftCollection.mintToken(superuser)).to.be.fulfilled;132133 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.enable', []);134 expect(await maintenanceEnabled(helper.getApi()), 'MM is OFF when it should be ON').to.be.true;135136 137 await expect(rftCollection.mintToken(superuser))138 .to.be.rejectedWith(/Invalid Transaction: Transaction call is not expected/);139140 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', []);141 expect(await maintenanceEnabled(helper.getApi()), 'MM is ON when it should be OFF').to.be.false;142143 144 await rftCollection.mintToken(superuser);145 });146147 itSub('MM allows native token transfers and RPC calls', async ({helper}) => {148 149 const totalCount = await helper.collection.getTotalCount();150151 152 await expect(helper.balance.transferToSubstrate(superuser, bob.address, 2n)).to.be.fulfilled;153154 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.enable', []);155 expect(await maintenanceEnabled(helper.getApi()), 'MM is OFF when it should be ON').to.be.true;156157 158 expect(await helper.collection.getTotalCount()).to.be.deep.equal(totalCount);159160 161 await expect(helper.balance.transferToSubstrate(bob, superuser.address, 1n)).to.be.fulfilled;162163 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', []);164 expect(await maintenanceEnabled(helper.getApi()), 'MM is ON when it should be OFF').to.be.false;165166 167 expect(await helper.collection.getTotalCount()).to.be.deep.equal(totalCount);168169 170 await expect(helper.balance.transferToSubstrate(bob, superuser.address, 1n)).to.be.fulfilled;171 });172173 itSched.ifWithPallets('MM blocks scheduled calls and the scheduler itself', [Pallets.Scheduler], async (scheduleKind, {helper}) => {174 const collection = await helper.nft.mintCollection(bob);175176 const nftBeforeMM = await collection.mintToken(bob);177 const nftDuringMM = await collection.mintToken(bob);178 const nftAfterMM = await collection.mintToken(bob);179180 const [181 scheduledIdBeforeMM,182 scheduledIdDuringMM,183 scheduledIdBunkerThroughMM,184 scheduledIdAttemptDuringMM,185 scheduledIdAfterMM,186 ] = scheduleKind == 'named'187 ? helper.arrange.makeScheduledIds(5)188 : new Array(5);189190 const blocksToWait = 6;191192 193 await nftBeforeMM.scheduleAfter(blocksToWait, {scheduledId: scheduledIdBeforeMM})194 .transfer(bob, {Substrate: superuser.address});195196 await helper.wait.newBlocks(blocksToWait + 1);197 expect(await nftBeforeMM.getOwner()).to.be.deep.equal({Substrate: superuser.address});198199 200 await nftDuringMM.scheduleAfter(blocksToWait, {scheduledId: scheduledIdDuringMM})201 .transfer(bob, {Substrate: superuser.address});202203 204 await nftDuringMM.scheduleAfter(blocksToWait * 2, {scheduledId: scheduledIdBunkerThroughMM})205 .transfer(bob, {Substrate: superuser.address});206207 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.enable', []);208 expect(await maintenanceEnabled(helper.getApi()), 'MM is OFF when it should be ON').to.be.true;209210 await helper.wait.newBlocks(blocksToWait + 1);211 212 expect(await nftDuringMM.getOwner()).to.be.deep.equal({Substrate: bob.address});213214 215 await expect(nftDuringMM.scheduleAfter(blocksToWait, {scheduledId: scheduledIdAttemptDuringMM})216 .transfer(bob, {Substrate: superuser.address}))217 .to.be.rejectedWith(/Invalid Transaction: Transaction call is not expected/);218219 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', []);220 expect(await maintenanceEnabled(helper.getApi()), 'MM is ON when it should be OFF').to.be.false;221222 223 await nftAfterMM.scheduleAfter(blocksToWait, {scheduledId: scheduledIdAfterMM})224 .transfer(bob, {Substrate: superuser.address});225226 await helper.wait.newBlocks(blocksToWait + 1);227228 expect(await nftAfterMM.getOwner()).to.be.deep.equal({Substrate: superuser.address});229 230 expect(await nftDuringMM.getOwner()).to.be.deep.equal({Substrate: superuser.address});231 });232233 itEth('Disallows Ethereum transactions to execute while in maintenance', async ({helper}) => {234 const owner = await helper.eth.createAccountWithBalance(donor);235 const receiver = helper.eth.createAccount();236237 const {collectionAddress} = await helper.eth.createERC721MetadataCompatibleNFTCollection(owner, 'A', 'B', 'C', '');238239 240 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.enable', []);241 expect(await maintenanceEnabled(helper.getApi()), 'MM is OFF when it should be ON').to.be.true;242243 const contract = await helper.ethNativeContract.collection(collectionAddress, 'nft', owner);244 const tokenId = await contract.methods.nextTokenId().call();245 expect(tokenId).to.be.equal('1');246247 await expect(contract.methods.mintWithTokenURI(receiver, 'Test URI').send())248 .to.be.rejectedWith(/Returned error: unknown error/);249250 await expect(contract.methods.ownerOf(tokenId).call()).rejectedWith(/token not found/);251252 253 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', []);254 expect(await maintenanceEnabled(helper.getApi()), 'MM is ON when it should be OFF').to.be.false;255 });256257 itSub('Allows to enable and disable MM repeatedly', async ({helper}) => {258 259 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.enable', []);260 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.enable', []);261 expect(await maintenanceEnabled(helper.getApi()), 'MM is OFF when it should be ON').to.be.true;262263 264 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', []);265 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', []);266 expect(await maintenanceEnabled(helper.getApi()), 'MM is ON when it should be OFF').to.be.false;267 });268269 afterEach(async () => {270 await usingPlaygrounds(async helper => {271 if (helper.fetchMissingPalletNames([Pallets.Maintenance]).length != 0) return;272 if (await maintenanceEnabled(helper.getApi())) {273 console.warn('\tMaintenance mode was left enabled AFTER a test has finished! Be careful. Disabling it now.');274 await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', []);275 }276 expect(await maintenanceEnabled(helper.getApi()), 'Disastrous! Exited the test suite with maintenance mode on.').to.be.false;277 });278 });279 });280281 describe('Preimage Execution', () => {282 const preimageHashes: string[] = [];283284 async function notePreimage(helper: UniqueHelper, preimage: any): Promise<string> {285 const result = await helper.preimage.notePreimage(bob, preimage);286 const events = result.result.events.filter(x => x.event.method === 'Noted' && x.event.section === 'preimage');287 const preimageHash = events[0].event.data[0].toHuman();288 return preimageHash;289 }290291 before(async function() {292 await usingPlaygrounds(async (helper) => {293 requirePalletsOrSkip(this, helper, [Pallets.Preimage, Pallets.Maintenance]);294295 296 const randomAccounts = await helper.arrange.createCrowd(10, 0n, superuser);297 const randomIdentities = randomAccounts.map((acc, i) => [298 acc.address, {299 deposit: 0n,300 judgements: [],301 info: {302 display: {303 raw: `Random Account #${i}`,304 },305 },306 },307 ]);308 const preimage = helper.constructApiCall('api.tx.identity.forceInsertIdentities', [randomIdentities]).method.toHex();309 preimageHashes.push(await notePreimage(helper, preimage));310 });311 });312313 itSub('Successfully executes call in a preimage', async ({helper}) => {314 const result = await expect(helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.executePreimage', [315 preimageHashes[0], {refTime: 10000000000, proofSize: 10000},316 ])).to.be.fulfilled;317318 319 const events = result.result.events.filter((x: any) => x.event.method === 'IdentitiesInserted' && x.event.section === 'identity');320 expect(events.length).to.be.equal(1);321322 323 expect(await helper.preimage.getPreimageInfo(preimageHashes[0])).to.have.property('unrequested');324 });325326 itSub('Does not allow execution of a preimage that would fail', async ({helper}) => {327 const [zeroAccount] = await helper.arrange.createAccounts([0n], superuser);328329 const preimage = helper.constructApiCall('api.tx.balances.forceTransfer', [330 {Id: zeroAccount.address}, {Id: superuser.address}, 1000n,331 ]).method.toHex();332 const preimageHash = await notePreimage(helper, preimage);333 preimageHashes.push(preimageHash);334335 await expect(helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.executePreimage', [336 preimageHash, {refTime: 10000000000, proofSize: 10000},337 ])).to.be.rejectedWith(/balances\.InsufficientBalance/);338 });339340 itSub('Does not allow preimage execution with non-root', async ({helper}) => {341 await expect(helper.executeExtrinsic(bob, 'api.tx.maintenance.executePreimage', [342 preimageHashes[0], {refTime: 10000000000, proofSize: 10000},343 ])).to.be.rejectedWith(/BadOrigin/);344 });345346 itSub('Does not allow execution of non-existent preimages', async ({helper}) => {347 await expect(helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.executePreimage', [348 '0x1010101010101010101010101010101010101010101010101010101010101010', {refTime: 10000000000, proofSize: 10000},349 ])).to.be.rejectedWith(/Unavailable/);350 });351352 itSub('Does not allow preimage execution with less than minimum weights', async ({helper}) => {353 await expect(helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.executePreimage', [354 preimageHashes[0], {refTime: 1000, proofSize: 100},355 ])).to.be.rejectedWith(/Exhausted/);356 });357358 after(async function() {359 await usingPlaygrounds(async (helper) => {360 if (helper.fetchMissingPalletNames([Pallets.Preimage, Pallets.Maintenance]).length != 0) return;361362 for (const hash of preimageHashes) {363 await helper.preimage.unnotePreimage(bob, hash);364 }365 });366 });367 });368});