difftreelog
test reformat code
in: master
48 files changed
tests/src/addCollectionAdmin.test.tsdiffbeforeafterboth--- a/tests/src/addCollectionAdmin.test.ts
+++ b/tests/src/addCollectionAdmin.test.ts
@@ -109,7 +109,7 @@
const chainAdminLimit = (helper.getApi().consts.common.collectionAdminsLimit as any).toNumber();
expect(chainAdminLimit).to.be.equal(5);
- for (let i = 0; i < chainAdminLimit; i++) {
+ for(let i = 0; i < chainAdminLimit; i++) {
await collection.addAdmin(alice, {Substrate: accounts[i].address});
const adminListAfterAddAdmin = await collection.getAdmins();
expect(adminListAfterAddAdmin).to.be.deep.contains({Substrate: accounts[i].address});
tests/src/allowLists.test.tsdiffbeforeafterboth--- a/tests/src/allowLists.test.ts
+++ b/tests/src/allowLists.test.ts
@@ -315,7 +315,7 @@
await collection.setPermissions(alice, permissions);
await collection.addToAllowList(alice, {Substrate: bob.address});
- if (allowlistedMintingShouldFail)
+ if(allowlistedMintingShouldFail)
await expect(collection.mintToken(bob, {Substrate: bob.address})).to.be.rejectedWith(appropriateRejectionMessage);
else
await expect(collection.mintToken(bob, {Substrate: bob.address})).to.not.be.rejected;
@@ -338,7 +338,7 @@
await expect(collection.mintToken(bob, {Substrate: bob.address})).to.not.be.rejected;
});
- if (!allowlistedMintingShouldFail) allowlistedMintingTest();
+ if(!allowlistedMintingShouldFail) allowlistedMintingTest();
});
describe('Negative', () => {
@@ -349,12 +349,12 @@
.to.be.rejectedWith(appropriateRejectionMessage);
});
- if (allowlistedMintingShouldFail) allowlistedMintingTest();
+ if(allowlistedMintingShouldFail) allowlistedMintingTest();
});
});
};
- for (const permissions of permissionSet) {
+ for(const permissions of permissionSet) {
testPermissionSuite(permissions);
}
});
tests/src/benchmarks/mintFee/index.tsdiffbeforeafterboth--- a/tests/src/benchmarks/mintFee/index.ts
+++ b/tests/src/benchmarks/mintFee/index.ts
@@ -88,7 +88,7 @@
const result: IBenchmarkResultForProp[] = [];
const csvResult: IBenchmarkResultForProp[] = [];
- for (let i = 1; i <= 20; i++) {
+ for(let i = 1; i <= 20; i++) {
const benchResult = await benchMintWithProperties(helper, privateKey, contract, {
propertiesNumber: i,
}) as any;
@@ -254,7 +254,7 @@
'0',
);
- for (const val of PROPERTIES.slice(0, setup.propertiesNumber)) {
+ for(const val of PROPERTIES.slice(0, setup.propertiesNumber)) {
encodedCall = await evmContract.methods
.setProperty(subTokenId, val.key, Buffer.from(val.value))
.encodeABI();
tests/src/benchmarks/utils/common.tsdiffbeforeafterboth--- a/tests/src/benchmarks/utils/common.ts
+++ b/tests/src/benchmarks/utils/common.ts
@@ -77,11 +77,11 @@
Ethereum: helper.address.substrateToEth(donor.address),
});
- if (proxyContract) {
+ if(proxyContract) {
await collection.addToAllowList(donor, {Ethereum: proxyContract});
await collection.addAdmin(donor, {Ethereum: proxyContract});
}
- if (collection instanceof UniqueNFTCollection || collection instanceof UniqueRFTCollection)
+ if(collection instanceof UniqueNFTCollection || collection instanceof UniqueRFTCollection)
await collection.setTokenPropertyPermissions(donor, permissions);
return collection;
tests/src/benchmarks/utils/types.tsdiffbeforeafterboth--- a/tests/src/benchmarks/utils/types.ts
+++ b/tests/src/benchmarks/utils/types.ts
@@ -45,13 +45,13 @@
Object.keys(model).forEach(key => {
res[key] = {};
- if (model[key].fee && model[key].gas) {
+ if(model[key].fee && model[key].gas) {
res[key].ethFee = model[key].fee;
res[key].ethGas = model[key].gas;
}
- if (model[key].substrate)
+ if(model[key].substrate)
res[key].substrate = model[key].substrate;
- if (model[key].zeppelin) {
+ if(model[key].zeppelin) {
res[key].zeppelinFee = model[key].zeppelin?.fee;
res[key].zeppelinGas = model[key].zeppelin?.gas;
}
tests/src/calibrate.tsdiffbeforeafterboth--- a/tests/src/calibrate.ts
+++ b/tests/src/calibrate.ts
@@ -4,8 +4,8 @@
class Fract {
static ZERO = new Fract(0n);
constructor(public readonly a: bigint, public readonly b: bigint = 1n) {
- if (b === 0n) throw new Error('division by zero');
- if (b < 0n) throw new Error('missing normalization');
+ if(b === 0n) throw new Error('division by zero');
+ if(b < 0n) throw new Error('missing normalization');
}
mul(other: Fract) {
@@ -17,7 +17,7 @@
}
plus(other: Fract) {
- if (this.b === other.b) {
+ if(this.b === other.b) {
return new Fract(this.a + other.a, this.b);
}
return new Fract(this.a * other.b + other.a * this.b, this.b * other.b).optimize();
@@ -31,7 +31,7 @@
return new Fract(-this.a, this.b);
}
inv() {
- if (this.a < 0) {
+ if(this.a < 0) {
return new Fract(-this.b, -this.a);
} else {
return new Fract(this.b, this.a);
@@ -40,9 +40,9 @@
optimize() {
function gcd(x: bigint, y: bigint) {
- if (x < 0n)
+ if(x < 0n)
x = -x;
- if (y < 0n)
+ if(y < 0n)
y = -y;
while(y) {
const t = y;
@@ -75,17 +75,17 @@
}
sqrt() {
- if (this.a < 0n) {
+ if(this.a < 0n) {
throw new Error('square root of negative numbers is not supported');
}
- if (this.lt(new Fract(2n))) {
+ if(this.lt(new Fract(2n))) {
return this;
}
function newtonIteration(n: Fract, x0: Fract): Fract {
const x1 = rpn(n, x0, '/', x0, '+', new Fract(2n), '/');
- if (x0.eq(x1) || x0.eq(x1.minus(new Fract(1n)))) {
+ if(x0.eq(x1) || x0.eq(x1.minus(new Fract(1n)))) {
return x0;
}
return newtonIteration(n, x1);
@@ -98,46 +98,46 @@
type Op = Fract | '+' | '-' | '*' | '/' | 'dup' | Op[];
function rpn(...ops: (Op)[]) {
const stack: Fract[] = [];
- for (const op of ops) {
- if (op instanceof Fract) {
+ for(const op of ops) {
+ if(op instanceof Fract) {
stack.push(op);
- } else if (op === '+') {
- if (stack.length < 2)
+ } else if(op === '+') {
+ if(stack.length < 2)
throw new Error('stack underflow');
const b = stack.pop()!;
const a = stack.pop()!;
stack.push(a.plus(b));
- } else if (op === '*') {
- if (stack.length < 2)
+ } else if(op === '*') {
+ if(stack.length < 2)
throw new Error('stack underflow');
const b = stack.pop()!;
const a = stack.pop()!;
stack.push(a.mul(b));
- } else if (op === '-') {
- if (stack.length < 2)
+ } else if(op === '-') {
+ if(stack.length < 2)
throw new Error('stack underflow');
const b = stack.pop()!;
const a = stack.pop()!;
stack.push(a.minus(b));
- } else if (op === '/') {
- if (stack.length < 2)
+ } else if(op === '/') {
+ if(stack.length < 2)
throw new Error('stack underflow');
const b = stack.pop()!;
const a = stack.pop()!;
stack.push(a.div(b));
- } else if (op === 'dup') {
- if (stack.length < 1)
+ } else if(op === 'dup') {
+ if(stack.length < 1)
throw new Error('stack underflow');
const a = stack.pop()!;
stack.push(a);
stack.push(a);
- } else if (Array.isArray(op)) {
+ } else if(Array.isArray(op)) {
stack.push(rpn(...op));
} else {
throw new Error(`unknown operand: ${op}`);
}
}
- if (stack.length != 1)
+ if(stack.length != 1)
throw new Error('one element should be left on stack');
return stack[0]!;
}
@@ -148,7 +148,7 @@
let sumy = Fract.ZERO;
let sumx2 = Fract.ZERO;
const n = points.length;
- for (let i = 0; i < n; i++) {
+ for(let i = 0; i < n; i++) {
const p = points[i];
sumxy = rpn(p.x, p.y, '*', sumxy, '+');
sumx = sumx.plus(p.x);
@@ -200,7 +200,7 @@
const api = helper.getApi();
const base = (await api.query.configuration.weightToFeeCoefficientOverride() as any).toBigInt();
- for (let i = -5; i < 5; i++) {
+ for(let i = -5; i < 5; i++) {
await helper.signTransaction(alice, api.tx.sudo.sudo(api.tx.configuration.setWeightToFeeCoefficientOverride(base + base / 1000n * BigInt(i))));
const coefficient = new Fract((await api.query.configuration.weightToFeeCoefficientOverride() as any).toBigInt());
@@ -256,7 +256,7 @@
const api = helper.getApi();
// const defaultCoeff = (api.consts.configuration.defaultMinGasPrice as any).toBigInt();
const base = (await api.query.configuration.minGasPriceOverride() as any).toBigInt();
- for (let i = -8; i < 8; i++) {
+ for(let i = -8; i < 8; i++) {
const gasPrice = base + base / 100000n * BigInt(i);
const gasPriceStr = '0x' + gasPrice.toString(16);
await helper.signTransaction(alice, api.tx.sudo.sudo(api.tx.configuration.setMinGasPriceOverride(gasPrice)));
@@ -303,14 +303,14 @@
const iterations = 3;
console.log('[Calibrate WeightToFee]');
- for (let i = 0; i < iterations; i++) {
+ for(let i = 0; i < iterations; i++) {
await calibrateWeightToFee(helper, privateKey);
}
console.log();
console.log('[Calibrate MinGasPrice]');
- for (let i = 0; i < iterations; i++) {
+ for(let i = 0; i < iterations; i++) {
await calibrateMinGasPrice(helper, privateKey);
}
});
tests/src/calibrateApply.tsdiffbeforeafterboth--- a/tests/src/calibrateApply.ts
+++ b/tests/src/calibrateApply.ts
@@ -22,7 +22,7 @@
weight2feeFound = true;
return p+formatNumber(weightToFeeCoefficientOverride)+s;
});
- if (!weight2feeFound) {
+ if(!weight2feeFound) {
throw new Error('failed to find weight2fee marker in source code');
}
@@ -31,7 +31,7 @@
minGasPriceFound = true;
return p+formatNumber(minGasPriceOverride)+s;
});
- if (!minGasPriceFound) {
+ if(!minGasPriceFound) {
throw new Error('failed to find mingasprice marker in source code');
}
tests/src/collator-selection/collatorSelection.seqtest.tsdiffbeforeafterboth--- a/tests/src/collator-selection/collatorSelection.seqtest.ts
+++ b/tests/src/collator-selection/collatorSelection.seqtest.ts
@@ -23,13 +23,13 @@
const alice = await privateKey('//Alice');
const bob = await privateKey('//Bob');
const invulnerables = await helper.collatorSelection.getInvulnerables();
- if (!invulnerables.includes(alice.address) || !invulnerables.includes(bob.address) || invulnerables.length != 2) {
+ if(!invulnerables.includes(alice.address) || !invulnerables.includes(bob.address) || invulnerables.length != 2) {
console.warn('Alice and Bob are not the invulnerables! Reinstating them back. '
+ 'Current invulnerables\' size: ' + invulnerables.length);
let nonce = await helper.chain.getNonce(alice.address);
// In case there are too many invulnerables already, remove some of them, leaving space for Alice and Bob.
- if (invulnerables.length + 2 >= helper.collatorSelection.maxCollators()) {
+ if(invulnerables.length + 2 >= helper.collatorSelection.maxCollators()) {
await Promise.all([
helper.getSudo().executeExtrinsic(superuser, 'api.tx.collatorSelection.removeInvulnerable', [invulnerables.pop()!], true, {nonce: nonce++}),
helper.getSudo().executeExtrinsic(superuser, 'api.tx.collatorSelection.removeInvulnerable', [invulnerables.pop()!], true, {nonce: nonce++}),
@@ -44,7 +44,7 @@
nonce = await helper.chain.getNonce(alice.address);
await Promise.all(invulnerables.map((invulnerable: any) => {
- if (invulnerable == alice.address || invulnerable == bob.address) return new Promise<void>(res => res());
+ if(invulnerable == alice.address || invulnerable == bob.address) return new Promise<void>(res => res());
return helper.getSudo().executeExtrinsic(superuser, 'api.tx.collatorSelection.removeInvulnerable', [invulnerable], true, {nonce: nonce++});
}));
}
@@ -58,7 +58,7 @@
let licenseBond = 0n;
before(async function() {
- if (!process.env.RUN_COLLATOR_TESTS) this.skip();
+ if(!process.env.RUN_COLLATOR_TESTS) this.skip();
await usingPlaygrounds(async (helper, privateKey) => {
requirePalletsOrSkip(this, helper, [Pallets.CollatorSelection]);
@@ -82,7 +82,7 @@
await usingPlaygrounds(async (helper, privateKey) => {
// todo:collator see again if blocks start to be finalized in dev mode
// Skip the collator block production in dev mode, since the blocks are sealed automatically.
- if (await helper.arrange.isDevNode()) this.skip();
+ if(await helper.arrange.isDevNode()) this.skip();
alice = await privateKey('//Alice');
bob = await privateKey('//Bob');
@@ -95,7 +95,7 @@
.status.toLowerCase()).to.be.equal('success');
const invulnerables = await helper.collatorSelection.getInvulnerables();
- if (!invulnerables.includes(alice.address) || !invulnerables.includes(bob.address) || invulnerables.length != 2) {
+ if(!invulnerables.includes(alice.address) || !invulnerables.includes(bob.address) || invulnerables.length != 2) {
console.warn('Alice and Bob are not the invulnerables! Reinstating them back. '
+ 'Current invulnerables\' size: ' + invulnerables.length);
@@ -107,7 +107,7 @@
nonce = await helper.chain.getNonce(superuser.address);
await Promise.all(invulnerables.map((invulnerable: any) => {
- if (invulnerable == alice.address || invulnerable == bob.address) return new Promise((res) => res);
+ if(invulnerable == alice.address || invulnerable == bob.address) return new Promise((res) => res);
return helper.getSudo().executeExtrinsic(superuser, 'api.tx.collatorSelection.removeInvulnerable', [invulnerable], true, {nonce: nonce++});
}));
}
@@ -144,7 +144,7 @@
after(async () => {
await usingPlaygrounds(async (helper) => {
- if (await helper.arrange.isDevNode()) return;
+ if(await helper.arrange.isDevNode()) return;
let nonce = await helper.chain.getNonce(superuser.address);
await Promise.all([
@@ -452,10 +452,10 @@
});
after(async function() {
- if (!process.env.RUN_COLLATOR_TESTS) return;
+ if(!process.env.RUN_COLLATOR_TESTS) return;
await usingPlaygrounds(async (helper) => {
- if (helper.fetchMissingPalletNames([Pallets.CollatorSelection]).length != 0) return;
+ if(helper.fetchMissingPalletNames([Pallets.CollatorSelection]).length != 0) return;
await helper.getSudo().collatorSelection.setLicenseBond(superuser, previousLicenseBond);
tests/src/collator-selection/identity.seqtest.tsdiffbeforeafterboth--- a/tests/src/collator-selection/identity.seqtest.ts
+++ b/tests/src/collator-selection/identity.seqtest.ts
@@ -41,7 +41,7 @@
let superuser: IKeyringPair;
before(async function() {
- if (!process.env.RUN_COLLATOR_TESTS) this.skip();
+ if(!process.env.RUN_COLLATOR_TESTS) this.skip();
await usingPlaygrounds(async (helper, privateKey) => {
requirePalletsOrSkip(this, helper, [Pallets.Identity]);
@@ -126,7 +126,7 @@
]);
await helper.getSudo().executeExtrinsic(superuser, 'api.tx.identity.forceSetSubs', [subsInfo] as any);
- for (let i = 0; i < supers.length; i++) {
+ for(let i = 0; i < supers.length; i++) {
// check deposit
expect(((await helper.getApi().query.identity.subsOf(supers[i].address)).toJSON() as any)[0]).to.be.equal(1000001 + i);
@@ -134,7 +134,7 @@
// check sub-identities as account ids
expect(subsAccounts).to.include.members(subs[i].map(x => x.address));
- for (let j = 0; j < subsAccounts.length; j++) {
+ for(let j = 0; j < subsAccounts.length; j++) {
// check sub-identities' names
expect((await getSubIdentityName(helper, subsAccounts[j]))[1]).to.be.deep.equal({Raw: `accounter #${j}`});
}
@@ -179,7 +179,7 @@
await helper.getSudo().executeExtrinsic(superuser, 'api.tx.identity.forceSetSubs', [subsInfo2] as any);
// make sure everything else is the same
- for (let i = 0; i < supers.length - 1; i++) {
+ for(let i = 0; i < supers.length - 1; i++) {
// check deposit
expect(((await helper.getApi().query.identity.subsOf(supers[i].address)).toJSON() as any)[0]).to.be.equal(1000001 + i);
@@ -187,7 +187,7 @@
// check sub-identities as account ids
expect(subsAccounts).to.include.members(subs[i].map(x => x.address));
- for (let j = 0; j < subsAccounts; j++) {
+ for(let j = 0; j < subsAccounts; j++) {
// check sub-identities' names
expect((await getSubIdentityName(helper, subsAccounts[j]))[1]).to.be.deep.equal({Raw: `accounter #${j}`});
}
@@ -200,7 +200,7 @@
// check sub-identities as account ids
expect(subsAccounts).to.include.members(subs[2].map(x => x.address));
- for (let j = 0; j < subsAccounts.length; j++) {
+ for(let j = 0; j < subsAccounts.length; j++) {
// check sub-identities' names
expect((await getSubIdentityName(helper, subsAccounts[j]))[1]).to.be.deep.equal({Raw: `discounter #${j}`});
}
@@ -233,7 +233,7 @@
// check deposit
expect((await helper.getApi().query.identity.subsOf(sup.address)).toHuman()).to.be.deep.equal(['0', []]);
- for (let j = 0; j < crowd.length; j++) {
+ for(let j = 0; j < crowd.length; j++) {
// check sub-identities' names
expect((await getSubIdentityName(helper, crowd[j].address))).to.be.null;
}
@@ -264,7 +264,7 @@
// check that sub-identities are deleted
expect((await helper.getApi().query.identity.subsOf(sup.address)).toHuman()).to.be.deep.equal(['0', []]);
- for (let j = 0; j < crowd.length; j++) {
+ for(let j = 0; j < crowd.length; j++) {
// check sub-identities' names
expect((await getSubIdentityName(helper, crowd[j].address))).to.be.null;
}
@@ -272,10 +272,10 @@
});
after(async function() {
- if (!process.env.RUN_COLLATOR_TESTS) return;
+ if(!process.env.RUN_COLLATOR_TESTS) return;
await usingPlaygrounds(async helper => {
- if (helper.fetchMissingPalletNames([Pallets.Identity]).length != 0) return;
+ if(helper.fetchMissingPalletNames([Pallets.Identity]).length != 0) return;
const identitiesToRemove: string[] = await getIdentityAccounts(helper);
await helper.getSudo().executeExtrinsic(superuser, 'api.tx.identity.forceRemoveIdentities', [identitiesToRemove]);
tests/src/createCollection.test.tsdiffbeforeafterboth--- a/tests/src/createCollection.test.ts
+++ b/tests/src/createCollection.test.ts
@@ -21,9 +21,9 @@
async function mintCollectionHelper(helper: UniqueHelper, signer: IKeyringPair, options: ICollectionCreationOptions, type?: 'nft' | 'fungible' | 'refungible') {
let collection;
- if (type === 'nft') {
+ if(type === 'nft') {
collection = await helper.nft.mintCollection(signer, options);
- } else if (type === 'fungible') {
+ } else if(type === 'fungible') {
collection = await helper.ft.mintCollection(signer, options, 0);
} else {
collection = await helper.rft.mintCollection(signer, options);
@@ -33,11 +33,11 @@
expect(data?.name).to.be.equal(options.name);
expect(data?.description).to.be.equal(options.description);
expect(data?.raw.tokenPrefix).to.be.equal(options.tokenPrefix);
- if (options.properties) {
+ if(options.properties) {
expect(data?.raw.properties).to.be.deep.equal(options.properties);
}
- if (options.tokenPropertyPermissions) {
+ if(options.tokenPropertyPermissions) {
expect(data?.raw.tokenPropertyPermissions).to.be.deep.equal(options.tokenPropertyPermissions);
}
@@ -136,7 +136,7 @@
itSub('(!negative test!) create collection with incorrect property limit (64 elements)', async ({helper}) => {
const props: IProperty[] = [];
- for (let i = 0; i < 65; i++) {
+ for(let i = 0; i < 65; i++) {
props.push({key: `key${i}`, value: `value${i}`});
}
const mintCollectionTx = () => helper.nft.mintCollection(alice, {name: 'name', description: 'descr', tokenPrefix: 'COL', properties: props});
@@ -146,7 +146,7 @@
itSub('(!negative test!) create collection with incorrect property limit (40 kb)', async ({helper}) => {
const props: IProperty[] = [];
- for (let i = 0; i < 32; i++) {
+ for(let i = 0; i < 32; i++) {
props.push({key: `key${i}`.repeat(80), value: `value${i}`.repeat(80)});
}
tests/src/createItem.test.tsdiffbeforeafterboth--- a/tests/src/createItem.test.ts
+++ b/tests/src/createItem.test.ts
@@ -23,9 +23,9 @@
let token;
const itemCountBefore = await helper.collection.getLastTokenId(collection.collectionId);
const itemBalanceBefore = (await helper.callRpc('api.rpc.unique.balance', [collection.collectionId, owner, 0])).toBigInt();
- if (type === 'nft') {
+ if(type === 'nft') {
token = await collection.mintToken(signer, owner, properties);
- } else if (type === 'fungible') {
+ } else if(type === 'fungible') {
await collection.mint(signer, 10n, owner);
} else {
token = await collection.mintToken(signer, 100n, owner, properties);
@@ -34,7 +34,7 @@
const itemCountAfter = await helper.collection.getLastTokenId(collection.collectionId);
const itemBalanceAfter = (await helper.callRpc('api.rpc.unique.balance', [collection.collectionId, owner, 0])).toBigInt();
- if (type === 'fungible') {
+ if(type === 'fungible') {
expect(itemBalanceAfter - itemBalanceBefore).to.be.equal(10n);
} else {
expect(itemCountAfter).to.be.equal(itemCountBefore + 1);
@@ -225,7 +225,7 @@
itSub('Adding more than 64 prps', async ({helper}) => {
const props: IProperty[] = [];
- for (let i = 0; i < 65; i++) {
+ for(let i = 0; i < 65; i++) {
props.push({key: `key${i}`, value: `value${i}`});
}
tests/src/createMultipleItems.test.tsdiffbeforeafterboth--- a/tests/src/createMultipleItems.test.ts
+++ b/tests/src/createMultipleItems.test.ts
@@ -42,7 +42,7 @@
{properties: [{key: 'data', value: '3'}]},
];
const tokens = await helper.nft.mintMultipleTokensWithOneOwner(alice, collection.collectionId, {Substrate: alice.address}, args);
- for (const [i, token] of tokens.entries()) {
+ for(const [i, token] of tokens.entries()) {
const tokenData = await token.getData();
expect(tokenData?.normalizedOwner.Substrate).to.be.deep.equal(helper.address.normalizeSubstrate(alice.address));
expect(tokenData?.properties[0].value).to.be.equal(args[i].properties[0].value);
@@ -77,7 +77,7 @@
];
const tokens = await helper.rft.mintMultipleTokensWithOneOwner(alice, collection.collectionId, {Substrate: alice.address}, args);
- for (const [i, token] of tokens.entries()) {
+ for(const [i, token] of tokens.entries()) {
expect(await token.getBalance({Substrate: alice.address})).to.be.equal(BigInt(i + 1));
}
});
@@ -110,7 +110,7 @@
{properties: [{key: 'data', value: '3'}]},
];
const tokens = await helper.nft.mintMultipleTokensWithOneOwner(alice, collection.collectionId, {Substrate: alice.address}, args);
- for (const [i, token] of tokens.entries()) {
+ for(const [i, token] of tokens.entries()) {
const tokenData = await token.getData();
expect(tokenData?.normalizedOwner.Substrate).to.be.deep.equal(helper.address.normalizeSubstrate(alice.address));
expect(tokenData?.properties[0].value).to.be.equal(args[i].properties[0].value);
@@ -132,7 +132,7 @@
{properties: [{key: 'data', value: '3'}]},
];
const tokens = await helper.nft.mintMultipleTokensWithOneOwner(alice, collection.collectionId, {Substrate: alice.address}, args);
- for (const [i, token] of tokens.entries()) {
+ for(const [i, token] of tokens.entries()) {
const tokenData = await token.getData();
expect(tokenData?.normalizedOwner.Substrate).to.be.deep.equal(helper.address.normalizeSubstrate(alice.address));
expect(tokenData?.properties[0].value).to.be.equal(args[i].properties[0].value);
@@ -154,7 +154,7 @@
{properties: [{key: 'data', value: '3'}]},
];
const tokens = await helper.nft.mintMultipleTokensWithOneOwner(alice, collection.collectionId, {Substrate: alice.address}, args);
- for (const [i, token] of tokens.entries()) {
+ for(const [i, token] of tokens.entries()) {
const tokenData = await token.getData();
expect(tokenData?.normalizedOwner.Substrate).to.be.equal(helper.address.normalizeSubstrate(alice.address));
expect(tokenData?.properties[0].value).to.be.equal(args[i].properties[0].value);
@@ -358,7 +358,7 @@
});
const prps = [];
- for (let i = 0; i < 65; i++) {
+ for(let i = 0; i < 65; i++) {
prps.push({key: `key${i}`, value: `value${i}`});
}
tests/src/createMultipleItemsEx.test.tsdiffbeforeafterboth--- a/tests/src/createMultipleItemsEx.test.ts
+++ b/tests/src/createMultipleItemsEx.test.ts
@@ -49,7 +49,7 @@
];
const tokens = await collection.mintMultipleTokens(alice, args);
- for (const [i, token] of tokens.entries()) {
+ for(const [i, token] of tokens.entries()) {
expect(await token.getOwner()).to.be.deep.equal(args[i].owner);
}
});
@@ -87,7 +87,7 @@
];
const tokens = await collection.mintMultipleTokens(alice, args);
- for (const [i, token] of tokens.entries()) {
+ for(const [i, token] of tokens.entries()) {
expect(await token.getOwner()).to.be.deep.equal(args[i].owner);
expect(await token.getData()).to.not.be.empty;
}
@@ -126,7 +126,7 @@
];
const tokens = await collection.mintMultipleTokens(alice, args);
- for (const [i, token] of tokens.entries()) {
+ for(const [i, token] of tokens.entries()) {
expect(await token.getOwner()).to.be.deep.equal(args[i].owner);
expect(await token.getData()).to.not.be.empty;
}
@@ -165,7 +165,7 @@
];
const tokens = await collection.mintMultipleTokens(alice, args);
- for (const [i, token] of tokens.entries()) {
+ for(const [i, token] of tokens.entries()) {
expect(await token.getOwner()).to.be.deep.equal(args[i].owner);
expect(await token.getData()).to.not.be.empty;
}
@@ -383,7 +383,7 @@
const properties: IProperty[] = [];
- for (let i = 0; i < 65; i++) {
+ for(let i = 0; i < 65; i++) {
properties.push({key: `k${i}`, value: `v${i}`});
}
tests/src/creditFeesToTreasury.seqtest.tsdiffbeforeafterboth--- a/tests/src/creditFeesToTreasury.seqtest.ts
+++ b/tests/src/creditFeesToTreasury.seqtest.ts
@@ -32,7 +32,7 @@
const blockInterval = api.consts.inflation.inflationBlockInterval.toNumber();
const unsubscribe = await api.rpc.chain.subscribeNewHeads(head => {
const currentBlock = head.number.toNumber();
- if (currentBlock % blockInterval < blockInterval - 10) {
+ if(currentBlock % blockInterval < blockInterval - 10) {
unsubscribe();
resolve();
} else {
tests/src/eth/allowlist.test.tsdiffbeforeafterboth--- a/tests/src/eth/allowlist.test.ts
+++ b/tests/src/eth/allowlist.test.ts
@@ -130,7 +130,7 @@
await collectionEvm.methods.transfer(owner, 1).send({from: userEth});
await collectionEvm.methods.transferCross(userCrossSub, 2).send({from: userEth});
- if (testCase.mode === 'ft') {
+ if(testCase.mode === 'ft') {
expect(await helper.ft.getBalance(collectionId, {Ethereum: owner})).to.eq(1n);
expect(await helper.ft.getBalance(collectionId, {Substrate: userSub.address})).to.eq(2n);
} else {
@@ -188,14 +188,14 @@
// 1.1 plain ethereum or cross address:
await expect(collectionEvm.methods[addToAllowList](testCase.cross ? userCrossEth : userEth).call({from: notOwner})).to.be.rejectedWith('NoPermission');
// 1.2 cross-substrate address:
- if (testCase.cross)
+ if(testCase.cross)
await expect(collectionEvm.methods[addToAllowList](userCrossSub).call({from: notOwner})).to.be.rejectedWith('NoPermission');
// 2. owner can add to allow list:
// 2.1 plain ethereum or cross address:
await collectionEvm.methods[addToAllowList](testCase.cross ? userCrossEth : userEth).send({from: owner});
// 2.2 cross-substrate address:
- if (testCase.cross) {
+ if(testCase.cross) {
await collectionEvm.methods[addToAllowList](userCrossSub).send({from: owner});
expect(await helper.collection.allowed(collectionId, {Substrate: userSub.address})).to.be.true;
}
@@ -205,7 +205,7 @@
// 3.1 plain ethereum or cross address:
await expect(collectionEvm.methods[removeFromAllowList](testCase.cross ? userCrossEth : userEth).call({from: notOwner})).to.be.rejectedWith('NoPermission');
// 3.2 cross-substrate address:
- if (testCase.cross)
+ if(testCase.cross)
await expect(collectionEvm.methods[removeFromAllowList](userCrossSub).call({from: notOwner})).to.be.rejectedWith('NoPermission');
}));
});
tests/src/eth/contractSponsoring.test.tsdiffbeforeafterboth--- a/tests/src/eth/contractSponsoring.test.ts
+++ b/tests/src/eth/contractSponsoring.test.ts
@@ -447,7 +447,7 @@
let testContract: CompiledContract;
async function compileTestContract(helper: EthUniqueHelper) {
- if (!testContract) {
+ if(!testContract) {
testContract = await helper.ethContract.compile(
'TestContract',
`
tests/src/eth/events.test.tsdiffbeforeafterboth--- a/tests/src/eth/events.test.ts
+++ b/tests/src/eth/events.test.ts
@@ -30,7 +30,7 @@
});
function clearEvents(ethEvents: NormalizedEvent[] | null, subEvents: IEvent[]) {
- if (ethEvents !== null) {
+ if(ethEvents !== null) {
ethEvents.splice(0);
}
subEvents.splice(0);
tests/src/eth/fungible.test.tsdiffbeforeafterboth--- a/tests/src/eth/fungible.test.ts
+++ b/tests/src/eth/fungible.test.ts
@@ -58,8 +58,8 @@
// 3. Get balance depending on the test case:
let balance;
- if (testCase === 'ethereum') balance = await collection.getBalance({Ethereum: receiverEth});
- else if (testCase === 'substrate') balance = await collection.getBalance({Substrate: receiverSub.address});
+ if(testCase === 'ethereum') balance = await collection.getBalance({Ethereum: receiverEth});
+ else if(testCase === 'substrate') balance = await collection.getBalance({Substrate: receiverSub.address});
// 3.1 Check balance:
expect(balance).to.eq(100n);
});
@@ -79,7 +79,7 @@
[receivers[i], (i + 1) * 10]
))).send();
const events = result.events.Transfer.sort((a: any, b: any) => +a.returnValues.value - b.returnValues.value);
- for (let i = 0; i < bulkSize; i++) {
+ for(let i = 0; i < bulkSize; i++) {
const event = events[i];
expect(event.address).to.equal(collectionAddress);
expect(event.returnValues.from).to.equal('0x0000000000000000000000000000000000000000');
@@ -535,7 +535,7 @@
});
await collection.approveTokens(alice, {Ethereum: receiver}, 100n);
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.event).to.be.equal('Approval');
@@ -561,7 +561,7 @@
});
await collection.transferFrom(bob, {Substrate: alice.address}, {Ethereum: receiver}, 51n);
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
let event = events[0];
expect(event.event).to.be.equal('Transfer');
@@ -592,7 +592,7 @@
});
await collection.transfer(alice, {Ethereum:receiver}, 51n);
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.event).to.be.equal('Transfer');
tests/src/eth/migration.seqtest.tsdiffbeforeafterboth--- a/tests/src/eth/migration.seqtest.ts
+++ b/tests/src/eth/migration.seqtest.ts
@@ -121,7 +121,7 @@
], ADDRESS, {from: caller, gas: helper.eth.DEFAULT_GAS});
expect(await contract.methods.counterValue().call()).to.be.equal('10');
- for (let i = 1; i <= 4; i++) {
+ for(let i = 1; i <= 4; i++) {
expect(await contract.methods.get(i).call()).to.be.equal(i.toString());
}
});
@@ -196,7 +196,7 @@
await helper.executeExtrinsic(superuser, 'api.tx.sudo.sudo', [txInsertEthLogs]);
}
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.address).to.be.equal(collectionAddress);
tests/src/eth/nesting/nest.test.tsdiffbeforeafterboth--- a/tests/src/eth/nesting/nest.test.ts
+++ b/tests/src/eth/nesting/nest.test.ts
@@ -190,7 +190,7 @@
describe('Fungible', () => {
async function createFungibleCollection(helper: EthUniqueHelper, owner: string, mode: 'ft' | 'native ft') {
- if (mode === 'ft') {
+ if(mode === 'ft') {
const {collectionAddress} = await helper.eth.createFungibleCollection(owner, '', 18, '', '');
const contract = await helper.ethNativeContract.collection(collectionAddress, 'ft', owner);
await contract.methods.mint(owner, 100n).send({from: owner});
@@ -259,7 +259,7 @@
const targetTokenId = mintingTargetTokenIdResult.events.Transfer.returnValues.tokenId;
const targetTokenAddress = helper.ethAddress.fromTokenId(targetCollectionId, targetTokenId);
- if (testCase.mode === 'ft') {
+ if(testCase.mode === 'ft') {
await expect(ftContract.methods.transfer(targetTokenAddress, 10n).call({from: owner})).to.be.rejectedWith('UserIsNotAllowedToNest');
} else {
await expect(ftContract.methods.transfer(targetTokenAddress, 10n).call({from: owner})).to.be.not.rejected;
tests/src/eth/nonFungible.test.tsdiffbeforeafterboth--- a/tests/src/eth/nonFungible.test.ts
+++ b/tests/src/eth/nonFungible.test.ts
@@ -39,7 +39,7 @@
const tokenId = result.events.Transfer.returnValues.tokenId;
expect(tokenId).to.be.equal('1');
- if (propertyKey && propertyValue) {
+ if(propertyKey && propertyValue) {
// Set URL or suffix
await contract.methods.setProperties(tokenId, [{key: propertyKey, value: Buffer.from(propertyValue)}]).send();
}
@@ -185,7 +185,7 @@
).send({from: caller});
const events = result.events.Transfer.sort((a: any, b: any) => +a.returnValues.tokenId - b.returnValues.tokenId);
- for (let i = 0; i < bulkSize; i++) {
+ for(let i = 0; i < bulkSize; i++) {
const event = events[i];
expect(event.address).to.equal(collectionAddress);
expect(event.returnValues.from).to.equal('0x0000000000000000000000000000000000000000');
@@ -669,7 +669,7 @@
expect(await collectionEvm.methods.balanceOfCross(owner).call({from: owner.eth})).to.be.eq('0');
- for (let i = 1; i < 10; i++) {
+ for(let i = 1; i < 10; i++) {
await collection.mintToken(minter, {Ethereum: owner.eth});
expect(await collectionEvm.methods.balanceOfCross(owner).call({from: owner.eth})).to.be.eq(i.toString());
}
@@ -682,7 +682,7 @@
const collectionEvm = await helper.ethNativeContract.collection(collectionAddress, 'nft', owner.eth);
const {tokenId} = await collection.mintToken(minter, {Ethereum: owner.eth});
- for (let i = 1n; i < 10n; i++) {
+ for(let i = 1n; i < 10n; i++) {
const ownerCross = await collectionEvm.methods.ownerOfCross(tokenId).call({from: owner.eth});
expect(ownerCross.eth).to.be.eq(owner.eth);
expect(ownerCross.sub).to.be.eq(owner.sub);
@@ -805,7 +805,7 @@
});
const {tokenId} = await collection.mintToken(alice);
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.event).to.be.equal('Transfer');
@@ -828,7 +828,7 @@
});
await token.burn(alice);
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.event).to.be.equal('Transfer');
@@ -853,7 +853,7 @@
});
await token.approve(alice, {Ethereum: receiver});
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.event).to.be.equal('Approval');
@@ -881,7 +881,7 @@
await token.transferFrom(bob, {Substrate: alice.address}, {Ethereum: receiver});
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.address).to.be.equal(collectionAddress);
@@ -906,7 +906,7 @@
await token.transfer(alice, {Ethereum: receiver});
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.address).to.be.equal(collectionAddress);
tests/src/eth/reFungible.test.tsdiffbeforeafterboth--- a/tests/src/eth/reFungible.test.ts
+++ b/tests/src/eth/reFungible.test.ts
@@ -111,7 +111,7 @@
).send();
const events = result.events.Transfer;
- for (let i = 0; i < 2; i++) {
+ for(let i = 0; i < 2; i++) {
const event = events[i];
expect(event.address).to.equal(collectionAddress);
expect(event.returnValues.from).to.equal('0x0000000000000000000000000000000000000000');
@@ -300,7 +300,7 @@
tokenEvents.push(event);
});
const result = await contract.methods.transferFrom(caller, receiver, tokenId).send();
- if (tokenEvents.length == 0) await helper.wait.newBlocks(1);
+ if(tokenEvents.length == 0) await helper.wait.newBlocks(1);
let event = result.events.Transfer;
expect(event.address).to.equal(collectionAddress);
@@ -547,7 +547,7 @@
});
await tokenContract.methods.transfer(receiver, 1).send();
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.address).to.equal(collectionAddress);
@@ -575,7 +575,7 @@
});
await tokenContract.methods.transfer(receiver, 1).send();
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.address).to.equal(collectionAddress);
@@ -592,7 +592,7 @@
expect(await collectionEvm.methods.balanceOfCross(owner).call({from: owner.eth})).to.be.eq('0');
- for (let i = 1n; i < 10n; i++) {
+ for(let i = 1n; i < 10n; i++) {
await collection.mintToken(minter, 100n, {Ethereum: owner.eth});
expect(await collectionEvm.methods.balanceOfCross(owner).call({from: owner.eth})).to.be.eq(i.toString());
}
@@ -605,7 +605,7 @@
const collectionEvm = await helper.ethNativeContract.collection(collectionAddress, 'nft', owner.eth);
const {tokenId} = await collection.mintToken(minter, 100n,{Ethereum: owner.eth});
- for (let i = 1n; i < 10n; i++) {
+ for(let i = 1n; i < 10n; i++) {
const ownerCross = await collectionEvm.methods.ownerOfCross(tokenId).call({from: owner.eth});
expect(ownerCross.eth).to.be.eq(owner.eth);
expect(ownerCross.sub).to.be.eq(owner.sub);
tests/src/eth/reFungibleToken.test.tsdiffbeforeafterboth--- a/tests/src/eth/reFungibleToken.test.ts
+++ b/tests/src/eth/reFungibleToken.test.ts
@@ -47,7 +47,7 @@
expect(event.returnValues.from).to.be.equal('0x0000000000000000000000000000000000000000');
expect(event.returnValues.to).to.be.equal(receiver);
- if (propertyKey && propertyValue) {
+ if(propertyKey && propertyValue) {
// Set URL or suffix
await contract.methods.setProperties(tokenId, [{key: propertyKey, value: Buffer.from(propertyValue)}]).send();
@@ -229,7 +229,7 @@
}
// 1.2 Cross substrate address:
- if (testCase === 'transferFromCross') {
+ if(testCase === 'transferFromCross') {
const result = await contract.methods.transferFromCross(ownerCross, receiverCrossSub, 51).send({from: spender});
// Check events:
const transferEvent = result.events.Transfer;
@@ -424,7 +424,7 @@
});
await tokenContract.methods.burnFrom(caller, 1).send();
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.address).to.be.equal(collectionAddress);
expect(event.returnValues.from).to.be.equal('0xFFfFfFffFFfffFFfFFfFFFFFffFFFffffFfFFFfF');
@@ -579,7 +579,7 @@
});
expect(await token.approve(alice, {Ethereum: receiver}, 100n)).to.be.true;
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.event).to.be.equal('Approval');
@@ -605,7 +605,7 @@
});
expect(await token.transferFrom(bob, {Substrate: alice.address}, {Ethereum: receiver}, 51n)).to.be.true;
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
let event = events[0];
expect(event.event).to.be.equal('Transfer');
@@ -636,7 +636,7 @@
});
expect(await token.transfer(alice, {Ethereum: receiver}, 51n)).to.be.true;
- if (events.length == 0) await helper.wait.newBlocks(1);
+ if(events.length == 0) await helper.wait.newBlocks(1);
const event = events[0];
expect(event.event).to.be.equal('Transfer');
tests/src/eth/tokens/callMethodsERC20.test.tsdiffbeforeafterboth--- a/tests/src/eth/tokens/callMethodsERC20.test.ts
+++ b/tests/src/eth/tokens/callMethodsERC20.test.ts
@@ -37,7 +37,7 @@
const mintingParams = testCase.mode === 'ft' ? [caller, 200n] : [caller];
const {collection, collectionId} = await helper.eth.createCollection(testCase.mode, caller, 'TotalSupply', '6', '6');
- if (testCase.mode === 'rft') await collection.methods.mint(caller).send({from: caller});
+ if(testCase.mode === 'rft') await collection.methods.mint(caller).send({from: caller});
// Use collection contract for FT or token contract for RFT:
const contract = testCase.mode === 'ft'
@@ -58,7 +58,7 @@
const mintingParams = testCase.mode === 'ft' ? [caller, 200n] : [caller];
const {collection, collectionId} = await helper.eth.createCollection(testCase.mode, caller, 'BalanceOf', 'Descroption', 'Prefix');
- if (testCase.mode === 'rft') await collection.methods.mint(caller).send({from: caller});
+ if(testCase.mode === 'rft') await collection.methods.mint(caller).send({from: caller});
// Use collection contract for FT or token contract for RFT:
const contract = testCase.mode === 'ft'
@@ -77,7 +77,7 @@
itEth('decimals', async ({helper}) => {
const caller = await helper.eth.createAccountWithBalance(donor);
const {collection, collectionId} = await helper.eth.createCollection(testCase.mode, caller, 'BalanceOf', 'Descroption', 'Prefix');
- if (testCase.mode === 'rft') await collection.methods.mint(caller).send({from: caller});
+ if(testCase.mode === 'rft') await collection.methods.mint(caller).send({from: caller});
// Use collection contract for FT or token contract for RFT:
const contract = testCase.mode === 'ft'
tests/src/eth/tokens/minting.test.tsdiffbeforeafterboth--- a/tests/src/eth/tokens/minting.test.ts
+++ b/tests/src/eth/tokens/minting.test.ts
@@ -53,7 +53,7 @@
expect(event.address).to.equal(collectionAddress);
expect(event.returnValues.from).to.equal('0x0000000000000000000000000000000000000000');
expect(event.returnValues.to).to.equal(receiver);
- if (testCase.mode === 'ft')
+ if(testCase.mode === 'ft')
expect(event.returnValues.value).to.equal('100');
// Check token exist:
@@ -87,7 +87,7 @@
expect(event.address).to.equal(collectionAddress);
expect(event.returnValues.from).to.equal('0x0000000000000000000000000000000000000000');
expect(event.returnValues.to).to.equal(receiver);
- if (testCase.mode === 'ft')
+ if(testCase.mode === 'ft')
expect(event.returnValues.value).to.equal('100');
// Check token exist:
@@ -121,7 +121,7 @@
expect(event.address).to.equal(collectionAddress);
expect(event.returnValues.from).to.equal('0x0000000000000000000000000000000000000000');
expect(event.returnValues.to).to.equal(receiver);
- if (testCase.mode === 'ft')
+ if(testCase.mode === 'ft')
expect(event.returnValues.value).to.equal('100');
// Check token exist:
tests/src/eth/util/index.tsdiffbeforeafterboth--- a/tests/src/eth/util/index.ts
+++ b/tests/src/eth/util/index.ts
@@ -40,20 +40,20 @@
await helper.connectWeb3(config.substrateUrl);
const ss58Format = helper.chain.getChainProperties().ss58Format;
const privateKey: PrivateKeyFn = async (seed) => {
- if (typeof seed === 'string') {
+ if(typeof seed === 'string') {
return helper.util.fromSeed(seed, ss58Format);
}
- if (seed.url) {
+ if(seed.url) {
const {filename} = makeNames(seed.url);
seed.filename = filename;
- } else if (seed.filename) {
+ } else if(seed.filename) {
// Pass
} else {
throw new Error('no url nor filename set');
}
const actualSeed = getTestSeed(seed.filename);
let account = helper.util.fromSeed(actualSeed, ss58Format);
- if (await helper.balance.getSubstrate(account.address) < MINIMUM_DONOR_FUND) {
+ if(await helper.balance.getSubstrate(account.address) < MINIMUM_DONOR_FUND) {
console.warn(`${path.basename(seed.filename)}: Not enough funds present on the filename account. Using the default one as the donor instead.`);
account = helper.util.fromSeed('//Alice', ss58Format);
}
@@ -71,7 +71,7 @@
(opts.only ? it.only :
opts.skip ? it.skip : it)(name, async function() {
await usingEthPlaygrounds(async (helper, privateKey) => {
- if (opts.requiredPallets) {
+ if(opts.requiredPallets) {
requirePalletsOrSkip(this, helper, opts.requiredPallets);
}
tests/src/eth/util/playgrounds/unique.dev.tsdiffbeforeafterboth--- a/tests/src/eth/util/playgrounds/unique.dev.ts
+++ b/tests/src/eth/util/playgrounds/unique.dev.ts
@@ -43,7 +43,7 @@
this.helper = helper;
}
async getGasPrice() {
- if (this.gasPrice)
+ if(this.gasPrice)
return this.gasPrice;
this.gasPrice = await this.helper.getWeb3().eth.getGasPrice();
return this.gasPrice;
@@ -53,17 +53,17 @@
class ContractGroup extends EthGroupBase {
async findImports(imports?: ContractImports[]) {
- if (!imports) return function(path: string) {
+ if(!imports) return function(path: string) {
return {error: `File not found: ${path}`};
};
const knownImports = {} as { [key: string]: string };
- for (const imp of imports) {
+ for(const imp of imports) {
knownImports[imp.solPath] = (await readFile(imp.fsPath)).toString();
}
return function(path: string) {
- if (path in knownImports) return {contents: knownImports[path]};
+ if(path in knownImports) return {contents: knownImports[path]};
return {error: `File not found: ${path}`};
};
}
@@ -91,7 +91,7 @@
return err.severity == 'error';
});
- if (hasErrors) {
+ if(hasErrors) {
throw compiled.errors;
}
const out = compiled.contracts[`${name}.sol`][name];
@@ -139,7 +139,7 @@
collection(address: string, mode: TCollectionMode, caller?: string, mergeDeprecated = false) {
let abi;
- if (address === this.helper.ethAddress.fromCollectionId(0)) {
+ if(address === this.helper.ethAddress.fromCollectionId(0)) {
abi = nativeFungibleAbi;
} else {
abi ={
@@ -148,7 +148,7 @@
'ft': fungibleAbi,
}[mode];
}
- if (mergeDeprecated) {
+ if(mergeDeprecated) {
const deprecated = {
'nft': nonFungibleDeprecatedAbi,
'rft': refungibleDeprecatedAbi,
@@ -209,7 +209,7 @@
}
async sendEVM(signer: IKeyringPair, contractAddress: string, abi: string, value: string, gasLimit?: number) {
- if (!gasLimit) gasLimit = this.DEFAULT_GAS;
+ if(!gasLimit) gasLimit = this.DEFAULT_GAS;
const web3 = this.helper.getWeb3();
// FIXME: can't send legacy transaction using tx.evm.call
const gasPrice = await web3.eth.getGasPrice();
@@ -341,10 +341,10 @@
normalizeEvents(events: any): NormalizedEvent[] {
const output = [];
- for (const key of Object.keys(events)) {
- if (key.match(/^[0-9]+$/)) {
+ for(const key of Object.keys(events)) {
+ if(key.match(/^[0-9]+$/)) {
output.push(events[key]);
- } else if (Array.isArray(events[key])) {
+ } else if(Array.isArray(events[key])) {
output.push(...events[key]);
} else {
output.push(events[key]);
@@ -353,8 +353,8 @@
output.sort((a, b) => a.logIndex - b.logIndex);
return output.map(({address, event, returnValues}) => {
const args: { [key: string]: string } = {};
- for (const key of Object.keys(returnValues)) {
- if (!key.match(/^[0-9]+$/)) {
+ for(const key of Object.keys(returnValues)) {
+ if(!key.match(/^[0-9]+$/)) {
args[key] = returnValues[key];
}
}
@@ -378,19 +378,19 @@
class EthAddressGroup extends EthGroupBase {
extractCollectionId(address: string): number {
- if (!(address.length === 42 || address.length === 40)) throw new Error('address wrong format');
+ if(!(address.length === 42 || address.length === 40)) throw new Error('address wrong format');
return parseInt(address.slice(address.length - 8), 16);
}
fromCollectionId(collectionId: number): string {
- if (collectionId >= 0xffffffff || collectionId < 0) throw new Error('collectionId overflow');
+ if(collectionId >= 0xffffffff || collectionId < 0) throw new Error('collectionId overflow');
return Web3.utils.toChecksumAddress(`0x17c4e6453cc49aaaaeaca894e6d9683e${collectionId.toString(16).padStart(8, '0')}`);
}
extractTokenId(address: string): { collectionId: number, tokenId: number } {
- if (!address.startsWith('0x'))
+ if(!address.startsWith('0x'))
throw 'address not starts with "0x"';
- if (address.length > 42)
+ if(address.length > 42)
throw 'address length is more than 20 bytes';
return {
collectionId: Number('0x' + address.substring(address.length - 16, address.length - 8)),
@@ -501,18 +501,18 @@
}
getWeb3(): Web3 {
- if (this.web3 === null) throw Error('Web3 not connected');
+ if(this.web3 === null) throw Error('Web3 not connected');
return this.web3;
}
connectWeb3(wsEndpoint: string) {
- if (this.web3 !== null) return;
+ if(this.web3 !== null) return;
this.web3Provider = new Web3.providers.WebsocketProvider(wsEndpoint);
this.web3 = new Web3(this.web3Provider);
}
async disconnect() {
- if (this.web3 === null) return;
+ if(this.web3 === null) return;
this.web3Provider?.connection.close();
await super.disconnect();
tests/src/fungible.test.tsdiffbeforeafterboth--- a/tests/src/fungible.test.ts
+++ b/tests/src/fungible.test.ts
@@ -55,7 +55,7 @@
await collection.transfer(alice, {Substrate: bob.address}, 1000n);
await collection.transfer(alice, ethAcc, 900n);
- for (let i = 0; i < 7; i++) {
+ for(let i = 0; i < 7; i++) {
await collection.transfer(alice, facelessCrowd[i], 1n);
}
tests/src/generateEnv.tsdiffbeforeafterboth--- a/tests/src/generateEnv.ts
+++ b/tests/src/generateEnv.ts
@@ -18,21 +18,21 @@
found = true;
return `${key}=${value}\n`;
});
- if (!found) throw new Error(`env key "${key}" is not found`);
+ if(!found) throw new Error(`env key "${key}" is not found`);
return newEnv;
}
// Fetch and format version string
async function ff(url: string, regex: RegExp, rep: string | ((substring: string, ...params:any[]) => string)): Promise<string> {
const ver = await fetchVersion(url);
- if (ver.match(regex) === null)
+ if(ver.match(regex) === null)
throw new Error(`bad regex for ${url}`);
return ver.replace(regex, rep as any);
}
function fixupUnique(version: string): string {
- if (version === 'release-v930033')
+ if(version === 'release-v930033')
return 'release-v930033-fix-gas-price';
- if (version === 'release-v930034')
+ if(version === 'release-v930034')
return 'release-v930034-fix-gas-price';
return version;
}
tests/src/maintenance.seqtest.tsdiffbeforeafterboth--- a/tests/src/maintenance.seqtest.ts
+++ b/tests/src/maintenance.seqtest.ts
@@ -42,7 +42,7 @@
describe('Maintenance Mode', () => {
before(async function() {
await usingPlaygrounds(async (helper) => {
- if (await maintenanceEnabled(helper.getApi())) {
+ if(await maintenanceEnabled(helper.getApi())) {
console.warn('\tMaintenance mode was left enabled BEFORE the test suite! Disabling it now.');
await expect(helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', [])).to.be.fulfilled;
}
@@ -270,8 +270,8 @@
afterEach(async () => {
await usingPlaygrounds(async helper => {
- if (helper.fetchMissingPalletNames([Pallets.Maintenance]).length != 0) return;
- if (await maintenanceEnabled(helper.getApi())) {
+ if(helper.fetchMissingPalletNames([Pallets.Maintenance]).length != 0) return;
+ if(await maintenanceEnabled(helper.getApi())) {
console.warn('\tMaintenance mode was left enabled AFTER a test has finished! Be careful. Disabling it now.');
await helper.getSudo().executeExtrinsic(superuser, 'api.tx.maintenance.disable', []);
}
@@ -359,9 +359,9 @@
after(async function() {
await usingPlaygrounds(async (helper) => {
- if (helper.fetchMissingPalletNames([Pallets.Preimage, Pallets.Maintenance]).length != 0) return;
+ if(helper.fetchMissingPalletNames([Pallets.Preimage, Pallets.Maintenance]).length != 0) return;
- for (const hash of preimageHashes) {
+ for(const hash of preimageHashes) {
await helper.preimage.unnotePreimage(bob, hash);
}
});
tests/src/nesting/collectionProperties.test.tsdiffbeforeafterboth--- a/tests/src/nesting/collectionProperties.test.ts
+++ b/tests/src/nesting/collectionProperties.test.ts
@@ -143,7 +143,7 @@
// It is possible to modify a property as many times as needed.
// It will not consume any additional space.
- for (let i = 0; i < sameSizePropertiesPossibleNum + 1; i++) {
+ for(let i = 0; i < sameSizePropertiesPossibleNum + 1; i++) {
await collection.setProperties(alice, [{key: propKey, value: makeNewPropData()}]);
const consumedSpace = await collection.getPropertiesConsumedSpace();
expect(consumedSpace).to.be.equal(originalSpace);
@@ -259,7 +259,7 @@
const collection = await helper[testSuite.mode].mintCollection(alice);
const propertiesToBeSet = [];
- for (let i = 0; i < 65; i++) {
+ for(let i = 0; i < 65; i++) {
propertiesToBeSet.push({
key: 'electron_' + i,
value: Math.random() > 0.5 ? 'high' : 'low',
@@ -281,7 +281,7 @@
[{key: 'déjà vu', value: 'hmm...'}],
];
- for (let i = 0; i < invalidProperties.length; i++) {
+ for(let i = 0; i < invalidProperties.length; i++) {
await expect(
collection.setProperties(alice, invalidProperties[i]),
`on rejecting the new badly-named property #${i}`,
@@ -305,7 +305,7 @@
{key: 'CRISPR-Cas9', value: 'rewriting nature!'},
]);
- for (let i = 0; i < invalidProperties.length; i++) {
+ for(let i = 0; i < invalidProperties.length; i++) {
await expect(
collection.deleteProperties(alice, invalidProperties[i].map(propertySet => propertySet.key)),
`on trying to delete the non-existent badly-named property #${i}`,
tests/src/nesting/propertyPermissions.test.tsdiffbeforeafterboth--- a/tests/src/nesting/propertyPermissions.test.ts
+++ b/tests/src/nesting/propertyPermissions.test.ts
@@ -110,7 +110,7 @@
async function testPreventFromAddingTooManyPossibleProperties(collection: UniqueNFTCollection | UniqueRFTCollection) {
const constitution = [];
- for (let i = 0; i < 65; i++) {
+ for(let i = 0; i < 65; i++) {
constitution.push({
key: 'property_' + i,
permission: Math.random() > 0.5 ? {mutable: true, collectionAdmin: true, tokenOwner: true} : {},
@@ -160,7 +160,7 @@
[{key: 'HÆMILTON', permission: {mutable: false, collectionAdmin: true, tokenOwner: true}}],
];
- for (let i = 0; i < invalidProperties.length; i++) {
+ for(let i = 0; i < invalidProperties.length; i++) {
await expect(
collection.setTokenPropertyPermissions(alice, invalidProperties[i]),
`on setting the new badly-named property #${i}`,
tests/src/nesting/tokenProperties.test.tsdiffbeforeafterboth--- a/tests/src/nesting/tokenProperties.test.ts
+++ b/tests/src/nesting/tokenProperties.test.ts
@@ -75,10 +75,10 @@
const propertyKeys: string[] = [];
let i = 0;
- for (const permission of permissions) {
+ for(const permission of permissions) {
i++;
let j = 0;
- for (const signer of permission.signers) {
+ for(const signer of permission.signers) {
j++;
const key = i + '_' + signer.address;
propertyKeys.push(key);
@@ -92,7 +92,7 @@
const properties = await token.getProperties(propertyKeys);
const tokenData = await token.getData();
- for (let i = 0; i < properties.length; i++) {
+ for(let i = 0; i < properties.length; i++) {
expect(properties[i].value).to.be.equal('Serotonin increase');
expect(tokenData!.properties[i].value).to.be.equal('Serotonin increase');
}
@@ -114,12 +114,12 @@
const propertyKeys: string[] = [];
let i = 0;
- for (const permission of permissions) {
+ for(const permission of permissions) {
i++;
- if (!permission.permission.mutable) continue;
+ if(!permission.permission.mutable) continue;
let j = 0;
- for (const signer of permission.signers) {
+ for(const signer of permission.signers) {
j++;
const key = i + '_' + signer.address;
propertyKeys.push(key);
@@ -138,7 +138,7 @@
const properties = await token.getProperties(propertyKeys);
const tokenData = await token.getData();
- for (let i = 0; i < properties.length; i++) {
+ for(let i = 0; i < properties.length; i++) {
expect(properties[i].value).to.be.equal('Serotonin stable');
expect(tokenData!.properties[i].value).to.be.equal('Serotonin stable');
}
@@ -161,12 +161,12 @@
const propertyKeys: string[] = [];
let i = 0;
- for (const permission of permissions) {
+ for(const permission of permissions) {
i++;
- if (!permission.permission.mutable) continue;
+ if(!permission.permission.mutable) continue;
let j = 0;
- for (const signer of permission.signers) {
+ for(const signer of permission.signers) {
j++;
const key = i + '_' + signer.address;
propertyKeys.push(key);
@@ -211,10 +211,10 @@
const propertyKeys: string[] = [];
let i = 0;
- for (const permission of permissions) {
+ for(const permission of permissions) {
i++;
let j = 0;
- for (const signer of permission.signers) {
+ for(const signer of permission.signers) {
j++;
const key = i + '_' + signer.address;
propertyKeys.push(key);
@@ -228,7 +228,7 @@
const properties = await nestedToken.getProperties(propertyKeys);
const tokenData = await nestedToken.getData();
- for (let i = 0; i < properties.length; i++) {
+ for(let i = 0; i < properties.length; i++) {
expect(properties[i].value).to.be.equal('Serotonin increase');
expect(tokenData!.properties[i].value).to.be.equal('Serotonin increase');
}
@@ -249,12 +249,12 @@
const propertyKeys: string[] = [];
let i = 0;
- for (const permission of permissions) {
+ for(const permission of permissions) {
i++;
- if (!permission.permission.mutable) continue;
+ if(!permission.permission.mutable) continue;
let j = 0;
- for (const signer of permission.signers) {
+ for(const signer of permission.signers) {
j++;
const key = i + '_' + signer.address;
propertyKeys.push(key);
@@ -273,7 +273,7 @@
const properties = await nestedToken.getProperties(propertyKeys);
const tokenData = await nestedToken.getData();
- for (let i = 0; i < properties.length; i++) {
+ for(let i = 0; i < properties.length; i++) {
expect(properties[i].value).to.be.equal('Serotonin stable');
expect(tokenData!.properties[i].value).to.be.equal('Serotonin stable');
}
@@ -294,12 +294,12 @@
const propertyKeys: string[] = [];
let i = 0;
- for (const permission of permissions) {
+ for(const permission of permissions) {
i++;
- if (!permission.permission.mutable) continue;
+ if(!permission.permission.mutable) continue;
let j = 0;
- for (const signer of permission.signers) {
+ for(const signer of permission.signers) {
j++;
const key = i + '_' + signer.address;
propertyKeys.push(key);
@@ -362,7 +362,7 @@
// It is possible to modify a property as many times as needed.
// It will not consume any additional space.
- for (let i = 0; i < sameSizePropertiesPossibleNum + 1; i++) {
+ for(let i = 0; i < sameSizePropertiesPossibleNum + 1; i++) {
await token.setProperties(alice, [{key: propKey, value: makeNewPropData()}]);
const consumedSpace = await token.getTokenPropertiesConsumedSpace();
expect(consumedSpace).to.be.equal(originalSpace);
@@ -491,7 +491,7 @@
await token.transfer(alice, {Substrate: charlie.address}, pieces);
let i = 0;
- for (const passage of constitution) {
+ for(const passage of constitution) {
i++;
const signer = passage.signers[0];
await expect(
@@ -508,9 +508,9 @@
const originalSpace = await prepare(token, pieces);
let i = 0;
- for (const forbiddance of constitution) {
+ for(const forbiddance of constitution) {
i++;
- if (!forbiddance.permission.mutable) continue;
+ if(!forbiddance.permission.mutable) continue;
await expect(
token.setProperties(forbiddance.sinner, [{key: `${i}`, value: 'Serotonin down'}]),
@@ -541,9 +541,9 @@
const originalSpace = await prepare(token, pieces);
let i = 0;
- for (const permission of constitution) {
+ for(const permission of constitution) {
i++;
- if (permission.permission.mutable) continue;
+ if(permission.permission.mutable) continue;
await expect(
token.setProperties(permission.signers[0], [{key: `${i}`, value: 'Serotonin down'}]),
@@ -650,7 +650,7 @@
const collection = await helper[testCase.mode].mintCollection(alice);
const maxPropertiesPerItem = 64;
- for (let i = 0; i < maxPropertiesPerItem; i++) {
+ for(let i = 0; i < maxPropertiesPerItem; i++) {
await collection.setTokenPropertyPermissions(alice, [{
key: `${i+1}`,
permission: {mutable: true, tokenOwner: true, collectionAdmin: true},
tests/src/nesting/unnest.test.tsdiffbeforeafterboth--- a/tests/src/nesting/unnest.test.ts
+++ b/tests/src/nesting/unnest.test.ts
@@ -117,7 +117,7 @@
const children = await targetNft.getChildren();
- if (childrenShouldPresent) {
+ if(childrenShouldPresent) {
expect(children[0]).to.be.deep.equal({
collectionId: nested.collectionId,
tokenId: (nested instanceof UniqueFTCollection) ? 0 : nested.tokenId,
@@ -137,13 +137,13 @@
const ops = ['transfer', 'burn'];
const cases = [];
- for (const mode of modes) {
+ for(const mode of modes) {
const requiredPallets = (mode === 'rft')
? [Pallets.ReFungible]
: [];
- for (const sender of senders) {
- for (const op of ops) {
+ for(const sender of senders) {
+ for(const op of ops) {
cases.push({
mode: mode as 'ft' | 'nft' | 'rft',
sender,
@@ -183,7 +183,7 @@
const firstUnnestAmount = 2n;
const restUnnestAmount = totalAmount - firstUnnestAmount;
- if (collectionNested instanceof UniqueFTCollection) {
+ if(collectionNested instanceof UniqueFTCollection) {
await collectionNested.mint(owner, totalAmount, {Substrate: charlie.address});
nested = collectionNested;
} else {
@@ -200,13 +200,13 @@
}) => {
const nestedBalanceBeforeOp = await nested.getBalance(targetNft.nestingAccount());
- if (testCase.op === 'transfer') {
+ if(testCase.op === 'transfer') {
const bobBalanceBeforeOp = await nested.getBalance({Substrate: bob.address});
await nested.transferFrom(unnester, targetNft.nestingAccount(), {Substrate: bob.address}, amount);
expect(await nested.getBalance({Substrate: bob.address})).to.be.equal(bobBalanceBeforeOp + amount);
} else {
- if (nested instanceof UniqueFTCollection) {
+ if(nested instanceof UniqueFTCollection) {
await nested.burnTokensFrom(unnester, targetNft.nestingAccount(), amount);
} else {
await nested.burnFrom(unnester, targetNft.nestingAccount(), amount);
@@ -274,7 +274,7 @@
tokenId: nested.tokenId,
}]);
- if (testCase.op === 'transfer') {
+ if(testCase.op === 'transfer') {
await nested.transferFrom(unnester, targetNft.nestingAccount(), {Substrate: bob.address});
} else {
await nested.burnFrom(unnester, targetNft.nestingAccount());
tests/src/pallet-presence.test.tsdiffbeforeafterboth--- a/tests/src/pallet-presence.test.ts
+++ b/tests/src/pallet-presence.test.ts
@@ -70,7 +70,7 @@
const preimage = ['preimage'];
const testUtils = 'testutils';
- if (chain.eq('OPAL by UNIQUE')) {
+ if(chain.eq('OPAL by UNIQUE')) {
requiredPallets.push(
refungible,
foreignAssets,
@@ -79,7 +79,7 @@
...collatorSelection,
...preimage,
);
- } else if (chain.eq('QUARTZ by UNIQUE') || chain.eq('SAPPHIRE by UNIQUE')) {
+ } else if(chain.eq('QUARTZ by UNIQUE') || chain.eq('SAPPHIRE by UNIQUE')) {
requiredPallets.push(
refungible,
appPromotion,
@@ -87,7 +87,7 @@
...collatorSelection,
...preimage,
);
- } else if (chain.eq('UNIQUE')) {
+ } else if(chain.eq('UNIQUE')) {
// Insert Unique additional pallets here
requiredPallets.push(
refungible,
tests/src/refungible.test.tsdiffbeforeafterboth--- a/tests/src/refungible.test.ts
+++ b/tests/src/refungible.test.ts
@@ -73,7 +73,7 @@
await token.transfer(alice, {Substrate: bob.address}, 1000n);
await token.transfer(alice, ethAcc, 900n);
- for (let i = 0; i < 7; i++) {
+ for(let i = 0; i < 7; i++) {
await token.transfer(alice, facelessCrowd[i], 50n * BigInt(i + 1));
}
tests/src/rpc.test.tsdiffbeforeafterboth--- a/tests/src/rpc.test.ts
+++ b/tests/src/rpc.test.ts
@@ -49,7 +49,7 @@
await collection.transfer(alice, {Substrate: bob.address}, 1000n);
await collection.transfer(alice, ethAcc, 900n);
- for (let i = 0; i < facelessCrowd.length; i++) {
+ for(let i = 0; i < facelessCrowd.length; i++) {
await collection.transfer(alice, facelessCrowd[i], 1n);
}
// Set-up over
tests/src/scheduler.seqtest.tsdiffbeforeafterboth--- a/tests/src/scheduler.seqtest.ts
+++ b/tests/src/scheduler.seqtest.ts
@@ -157,7 +157,7 @@
let fillScheduledIds = new Array(maxScheduledPerBlock);
let extraScheduledId = undefined;
- if (scheduleKind == 'named') {
+ if(scheduleKind == 'named') {
const scheduledIds = helper.arrange.makeScheduledIds(maxScheduledPerBlock + 1);
fillScheduledIds = scheduledIds.slice(0, maxScheduledPerBlock);
extraScheduledId = scheduledIds[maxScheduledPerBlock];
@@ -178,7 +178,7 @@
const balanceBefore = await helper.balance.getSubstrate(bob.address);
// Fill the target block
- for (let i = 0; i < maxScheduledPerBlock; i++) {
+ for(let i = 0; i < maxScheduledPerBlock; i++) {
await helper.scheduler.scheduleAt(executionBlock, {scheduledId: fillScheduledIds[i]})
.balance.transferToSubstrate(superuser, bob.address, amount);
}
@@ -313,7 +313,7 @@
expect(await helper.testUtils.testValue())
.to.be.equal(finalTestVal);
- for (let i = 1; i < periodic.repetitions; i++) {
+ for(let i = 1; i < periodic.repetitions; i++) {
await helper.wait.forParachainBlockNumber(firstExecutionBlockNumber + periodic.period * (i + 1));
expect(await helper.testUtils.testValue())
.to.be.equal(finalTestVal);
@@ -505,8 +505,8 @@
// Fill `numFilledBlocks` blocks beginning from the block in which the second execution should occur
const txs = [];
- for (let offset = 0; offset < numFilledBlocks; offset ++) {
- for (let i = 0; i < maxScheduledPerBlock; i++) {
+ for(let offset = 0; offset < numFilledBlocks; offset ++) {
+ for(let i = 0; i < maxScheduledPerBlock; i++) {
const scheduledTx = helper.constructApiCall('api.tx.balances.transfer', [bob.address, 1n]);
@@ -534,7 +534,7 @@
await helper.wait.forParachainBlockNumber(firstExecutionBlockNumber + period + numFilledBlocks);
// The periodic operation should be postponed by `numFilledBlocks`
- for (let i = 0; i < numFilledBlocks; i++) {
+ for(let i = 0; i < numFilledBlocks; i++) {
expect(await helper.testUtils.testValue(firstExecutionBlockNumber + period + i)).to.be.equal(firstExecTestVal);
}
tests/src/sub/appPromotion/appPromotion.seqtest.tsdiffbeforeafterboth--- a/tests/src/sub/appPromotion/appPromotion.seqtest.ts
+++ b/tests/src/sub/appPromotion/appPromotion.seqtest.ts
@@ -36,7 +36,7 @@
after(async function () {
await usingPlaygrounds(async (helper) => {
- if (helper.fetchMissingPalletNames([Pallets.AppPromotion]).length != 0) return;
+ if(helper.fetchMissingPalletNames([Pallets.AppPromotion]).length != 0) return;
const api = helper.getApi();
await helper.signTransaction(superuser, api.tx.sudo.sudo(api.tx.appPromotion.setAdminAddress({Substrate: palletAdmin.address})));
});
tests/src/sub/appPromotion/appPromotion.test.tsdiffbeforeafterboth--- a/tests/src/sub/appPromotion/appPromotion.test.ts
+++ b/tests/src/sub/appPromotion/appPromotion.test.ts
@@ -30,7 +30,7 @@
async function getAccounts(accountsNumber: number, balance?: bigint) {
let accs: IKeyringPair[] = [];
- if (balance) {
+ if(balance) {
await usingPlaygrounds(async (helper) => {
accs = await helper.arrange.createAccounts(new Array(accountsNumber).fill(balance), donor);
});
@@ -61,8 +61,8 @@
afterEach(async () => {
await usingPlaygrounds(async (helper) => {
let unstakeTxs = [];
- for (const account of usedAccounts) {
- if (unstakeTxs.length === 3) {
+ for(const account of usedAccounts) {
+ if(unstakeTxs.length === 3) {
await Promise.all(unstakeTxs);
unstakeTxs = [];
}
@@ -112,7 +112,7 @@
itSub(`[${testCase.unstake}] should allow to create maximum 10 stakes for account`, async ({helper}) => {
const [staker] = await getAccounts(1, 2000n);
const ONE_STAKE = 100n * nominal;
- for (let i = 0; i < 10; i++) {
+ for(let i = 0; i < 10; i++) {
await helper.staking.stake(staker, ONE_STAKE);
}
@@ -125,7 +125,7 @@
// After unstake can stake again
// CASE 1: unstakeAll
- if (testCase.unstake === 'unstakeAll') {
+ if(testCase.unstake === 'unstakeAll') {
await helper.staking.unstakeAll(staker);
expect(await helper.staking.getStakesNumber({Substrate: staker.address})).to.eq(0);
await helper.staking.stake(staker, 100n * nominal);
@@ -312,7 +312,7 @@
// can't unstake if there are only pendingUnstakes
await helper.staking.stake(staker, 100n * nominal);
- if (testCase.method === 'unstakeAll') {
+ if(testCase.method === 'unstakeAll') {
await helper.staking.unstakeAll(staker);
await helper.staking.unstakeAll(staker);
} else {
@@ -369,7 +369,7 @@
});
itSub('should not be possible for more than 3 accounts in one block', async ({helper}) => {
- if (!await helper.arrange.isDevNode()) {
+ if(!await helper.arrange.isDevNode()) {
const stakers = await getAccounts(10);
await Promise.all(stakers.map(staker => helper.staking.stake(staker, 100n * nominal)));
@@ -894,8 +894,8 @@
await Promise.all(stakers.map(staker => helper.staking.stake(staker, 100n * nominal)));
let unstakingTxs = [];
- for (const staker of stakers) {
- if (unstakingTxs.length == 3) {
+ for(const staker of stakers) {
+ if(unstakingTxs.length == 3) {
await Promise.all(unstakingTxs);
unstakingTxs = [];
}
@@ -910,7 +910,7 @@
let payouts;
do {
payouts = await helper.admin.payoutStakers(palletAdmin, 20);
- } while (payouts.length !== 0);
+ } while(payouts.length !== 0);
});
});
@@ -972,10 +972,10 @@
// Sometimes is is required to make a cycle in order for the payment to be calculated for a specific account
async function payUntilRewardFor(account: string, helper: DevUniqueHelper) {
- for (let i = 0; i < 3; i++) {
+ for(let i = 0; i < 3; i++) {
const payouts = await helper.admin.payoutStakers(palletAdmin, 100);
const accountPayout = payouts.find(p => p.staker === account);
- if (accountPayout) return accountPayout;
+ if(accountPayout) return accountPayout;
}
throw Error(`Cannot find payout for ${account}`);
}
@@ -986,13 +986,13 @@
// 5n / 10_000n = 0.05% p/day
const income = base + base * (ACCURACY * (calcPeriod * 5n) / (10_000n * DAY)) / ACCURACY ;
- if (iter > 1) {
+ if(iter > 1) {
return calculateIncome(income, iter - 1, calcPeriod);
} else return income;
}
function rewardAvailableInBlock(stakedInBlock: bigint) {
- if (stakedInBlock % LOCKING_PERIOD === 0n) return stakedInBlock + LOCKING_PERIOD;
+ if(stakedInBlock % LOCKING_PERIOD === 0n) return stakedInBlock + LOCKING_PERIOD;
return (stakedInBlock - stakedInBlock % LOCKING_PERIOD) + (LOCKING_PERIOD * 2n);
}
@@ -1002,7 +1002,7 @@
const relayBlockNumber = (await helper.callRpc('api.query.parachainSystem.validationData', [])).value.relayParentNumber.toNumber(); // await helper.chain.getLatestBlockNumber();
const currentPeriodBlock = BigInt(relayBlockNumber) % LOCKING_PERIOD;
- if (currentPeriodBlock > waitBlockLessThan) {
+ if(currentPeriodBlock > waitBlockLessThan) {
await helper.wait.forRelayBlockNumber(BigInt(relayBlockNumber) + LOCKING_PERIOD - currentPeriodBlock);
}
}
tests/src/sub/nesting/nesting.negative.test.tsdiffbeforeafterboth--- a/tests/src/sub/nesting/nesting.negative.test.ts
+++ b/tests/src/sub/nesting/nesting.negative.test.ts
@@ -66,18 +66,18 @@
const collectionForNesting = testCase.mode === 'ft' ? await helper.ft.mintCollection(alice) : helper.ft.getCollectionObject(0);
// Alice cannot create immediately nested tokens:
- if (testCase.mode === 'ft') {
+ if(testCase.mode === 'ft') {
await expect(collectionForNesting.mint(alice, 100n, targetToken.nestingAccount())).to.be.rejectedWith('common.UserIsNotAllowedToNest');
} else {
await expect(collectionForNesting.transfer(alice, targetToken.nestingAccount(), 100n)).to.be.not.rejected;
}
// Alice can't mint and nest tokens:
- if (testCase.mode === 'ft') {
+ if(testCase.mode === 'ft') {
await collectionForNesting.mint(alice, 100n);
}
- if (testCase.mode === 'ft') {
+ if(testCase.mode === 'ft') {
await expect(collectionForNesting.transfer(alice, targetToken.nestingAccount(), 50n)).to.be.rejectedWith('common.UserIsNotAllowedToNest');
} else {
await expect(collectionForNesting.transfer(alice, targetToken.nestingAccount(), 50n)).to.be.not.rejected;
@@ -271,7 +271,7 @@
const maxNestingLevel = 5;
// Create a nested-token matryoshka
- for (let i = 0; i < maxNestingLevel; i++) {
+ for(let i = 0; i < maxNestingLevel; i++) {
token = await collection.mintToken(alice, token.nestingAccount());
}
tests/src/transfer.nload.tsdiffbeforeafterboth--- a/tests/src/transfer.nload.ts
+++ b/tests/src/transfer.nload.ts
@@ -29,7 +29,7 @@
const randomSeed = 'seed' + Math.floor(Math.random() * Math.floor(10000)) + seedAddition;
unused = await privateKey(`//${randomSeed}`);
bal = await helper.balance.getSubstrate(unused.address);
- } while (bal !== 0n);
+ } while(bal !== 0n);
return unused;
}
@@ -42,13 +42,13 @@
let counters: { [key: string]: number } = {};
function increaseCounter(name: string, amount: number) {
- if (!counters[name]) {
+ if(!counters[name]) {
counters[name] = 0;
}
counters[name] += amount;
}
function flushCounterToMaster() {
- if (Object.keys(counters).length === 0) {
+ if(Object.keys(counters).length === 0) {
return;
}
process.send!(counters);
@@ -65,12 +65,12 @@
// findUnusedAddresses produces at least 1 request per user
increaseCounter('requests', finalUserAmount);
- for (let stage = 0; stage < stages; stage++) {
+ for(let stage = 0; stage < stages; stage++) {
const usersWithBalance = 2 ** stage;
const amount = totalAmount / (2n ** BigInt(stage)) - FEE * BigInt(stage);
// console.log(`Stage ${stage}/${stages}, ${usersWithBalance} => ${usersWithBalance * 2} = ${amount}`);
const txs: Promise<boolean | void>[] = [];
- for (let i = 0; i < usersWithBalance; i++) {
+ for(let i = 0; i < usersWithBalance; i++) {
const newUser = accounts[i + usersWithBalance];
// console.log(`${accounts[i].address} => ${newUser.address} = ${amountToSplit}`);
const tx = helper.balance.transferToSubstrate(accounts[i], newUser.address, amount);
@@ -83,19 +83,19 @@
await Promise.all(txs);
}
- for (const account of failedAccounts.reverse()) {
+ for(const account of failedAccounts.reverse()) {
accounts.splice(account, 1);
}
return accounts;
}
-if (cluster.isMaster) {
+if(cluster.isMaster) {
let testDone = false;
usingPlaygrounds(async (helper) => {
const prevCounters: { [key: string]: number } = {};
- while (!testDone) {
- for (const name in counters) {
- if (!(name in prevCounters)) {
+ while(!testDone) {
+ for(const name in counters) {
+ if(!(name in prevCounters)) {
prevCounters[name] = 0;
}
if(counters[name] === prevCounters[name]) {
@@ -111,7 +111,7 @@
console.log(`Starting ${os.cpus().length} workers`);
usingPlaygrounds(async (helper, privateKey) => {
const alice = await privateKey('//Alice');
- for (const id in os.cpus()) {
+ for(const id in os.cpus()) {
const WORKER_NAME = `//LoadWorker${id}_${Date.now()}`;
const workerAccount = await privateKey(WORKER_NAME);
await helper.balance.transferToSubstrate(alice, workerAccount.address, 400n * 10n ** 23n);
@@ -121,7 +121,7 @@
STAGES: id + 2,
});
worker.on('message', msg => {
- for (const key in msg) {
+ for(const key in msg) {
increaseCounter(key, msg[key]);
}
});
tests/src/util/globalSetup.tsdiffbeforeafterboth--- a/tests/src/util/globalSetup.ts
+++ b/tests/src/util/globalSetup.ts
@@ -19,12 +19,12 @@
// 2. Create donors for test files
await fundFilenamesWithRetries(3)
.then((result) => {
- if (!result) throw Error('Some problems with fundFilenamesWithRetries');
+ if(!result) throw Error('Some problems with fundFilenamesWithRetries');
});
// 3. Configure App Promotion
const missingPallets = helper.fetchMissingPalletNames([Pallets.AppPromotion]);
- if (missingPallets.length === 0) {
+ if(missingPallets.length === 0) {
const superuser = await privateKey('//Alice');
const palletAddress = helper.arrange.calculatePalletAddress('appstake');
const palletAdmin = await privateKey('//PromotionAdmin');
@@ -48,9 +48,9 @@
async function getFiles(rootPath: string): Promise<string[]> {
const files = await fs.readdir(rootPath, {withFileTypes: true});
const filenames: string[] = [];
- for (const entry of files) {
+ for(const entry of files) {
const res = path.resolve(rootPath, entry.name);
- if (entry.isDirectory()) {
+ if(entry.isDirectory()) {
filenames.push(...await getFiles(res));
} else {
filenames.push(res);
@@ -69,16 +69,16 @@
// batching is actually undesireable, it takes away the time while all the transactions actually succeed
const batchSize = 300;
let balanceGrantedCounter = 0;
- for (let b = 0; b < filenames.length; b += batchSize) {
+ for(let b = 0; b < filenames.length; b += batchSize) {
const tx = [];
let batchBalanceGrantedCounter = 0;
- for (let i = 0; batchBalanceGrantedCounter < batchSize && b + i < filenames.length; i++) {
+ for(let i = 0; batchBalanceGrantedCounter < batchSize && b + i < filenames.length; i++) {
const f = filenames[b + i];
- if (!f.endsWith('.test.ts') && !f.endsWith('seqtest.ts') || f.includes('.outdated')) continue;
+ if(!f.endsWith('.test.ts') && !f.endsWith('seqtest.ts') || f.includes('.outdated')) continue;
const account = await privateKey({filename: f, ignoreFundsPresence: true});
const aliceBalance = await helper.balance.getSubstrate(account.address);
- if (aliceBalance < MINIMUM_DONOR_FUND * oneToken) {
+ if(aliceBalance < MINIMUM_DONOR_FUND * oneToken) {
tx.push(helper.executeExtrinsic(
alice,
'api.tx.balances.transfer',
@@ -93,16 +93,16 @@
if(tx.length > 0) {
console.log(`Granting funds to ${batchBalanceGrantedCounter} filename accounts.`);
const result = await Promise.all(tx);
- if (result && result.lastIndexOf(false) > -1) throw new Error('The transactions actually probably succeeded, should check the balances.');
+ if(result && result.lastIndexOf(false) > -1) throw new Error('The transactions actually probably succeeded, should check the balances.');
}
}
- if (balanceGrantedCounter == 0) console.log('No account needs additional funding.');
+ if(balanceGrantedCounter == 0) console.log('No account needs additional funding.');
});
};
const fundFilenamesWithRetries = (retriesLeft: number): Promise<boolean> => {
- if (retriesLeft <= 0) return Promise.resolve(false);
+ if(retriesLeft <= 0) return Promise.resolve(false);
return fundFilenames()
.then(() => Promise.resolve(true))
.catch(e => {
tests/src/util/identitySetter.tsdiffbeforeafterboth--- a/tests/src/util/identitySetter.ts
+++ b/tests/src/util/identitySetter.ts
@@ -35,8 +35,8 @@
const identities: [string, any][] = [];
for(const [key, v] of await helper.getApi().query.identity.identityOf.entries()) {
const value = v as any;
- if (value.isNone) {
- if (noneCasePredicate) noneCasePredicate(key, value);
+ if(value.isNone) {
+ if(noneCasePredicate) noneCasePredicate(key, value);
continue;
}
identities.push(extractIdentity(key, value));
@@ -46,9 +46,9 @@
// whether the existing chain data is more important than the coming
function isCurrentChainDataPriority(helper: ChainHelperBase, currentChainId: number | undefined, relayChainId: number) {
- if (!currentChainId) return false;
+ if(!currentChainId) return false;
// information has come from local chain, and is automatically superior
- if (currentChainId == helper.chain.getChainProperties().ss58Format) return true;
+ if(currentChainId == helper.chain.getChainProperties().ss58Format) return true;
// the lower the id, the more important it is (Polkadot has ss58 prefix = 0, Kusama has ss58 prefix = 2)
return currentChainId < relayChainId;
}
@@ -64,7 +64,7 @@
deposit,
subIdentities.map((sub: string): [string, object] | null => {
const sup = supers.find((sup: any) => sup[0] === sub);
- if (!sup) {
+ if(!sup) {
console.error(`Error: Could not find info on super for \nsub-identity account\t${sub} of \nsuper account \t\t${identityAccount}, skipping.`);
return null;
}
@@ -85,8 +85,8 @@
async function uploadPreimage(helper: ChainHelperBase, preimageMaker: IKeyringPair, preimage: string) {
try {
await helper.executeExtrinsic(preimageMaker, 'api.tx.preimage.notePreimage', [preimage]);
- } catch(e: any) {
- if (e.message.includes('AlreadyNoted')) {
+ } catch (e: any) {
+ if(e.message.includes('AlreadyNoted')) {
console.warn('Warning: The same preimage already exists on the chain. Nothing was uploaded.');
} else {
console.error(e);
@@ -107,11 +107,11 @@
for(const [key, value] of await getIdentities(helper, (key, _value) => identitiesToRemove.push((key as any).toHuman()[0]))) {
// if any of the judgements resulted in a good confirmed outcome, keep this identity
let knownGood = false, reasonable = false;
- for (const [_id, judgement] of value.judgements) {
- if (judgement == 'KnownGood') knownGood = true;
- if (judgement == 'Reasonable') reasonable = true;
+ for(const [_id, judgement] of value.judgements) {
+ if(judgement == 'KnownGood') knownGood = true;
+ if(judgement == 'Reasonable') reasonable = true;
}
- if (!(reasonable || knownGood)) continue;
+ if(!(reasonable || knownGood)) continue;
// replace the registrator id with the relay chain's ss58 format
value.judgements = [[helper.chain.getChainProperties().ss58Format, knownGood ? 'KnownGood' : 'Reasonable']];
identitiesOnRelay.push([key, value]);
@@ -124,7 +124,7 @@
for(const [key, value] of await getSubs(helper)) {
// only get subs of the identities interesting to us
const identityIndex = sublessIdentities.findIndex((x: any) => x[0] == key);
- if (identityIndex == -1) continue;
+ if(identityIndex == -1) continue;
sublessIdentities.splice(identityIndex, 1);
subsOnRelay.push(constructSubInfo(key, value, supersOfSubs));
}
@@ -140,8 +140,8 @@
}, relayUrl);
await usingPlaygrounds(async (helper, privateKey) => {
- if (helper.fetchMissingPalletNames([Pallets.Identity]).length != 0) console.error('pallet-identity is not included in parachain.');
- if (helper.fetchMissingPalletNames([Pallets.Preimage]).length != 0) console.error('pallet-preimage is not included in parachain.');
+ if(helper.fetchMissingPalletNames([Pallets.Identity]).length != 0) console.error('pallet-identity is not included in parachain.');
+ if(helper.fetchMissingPalletNames([Pallets.Preimage]).length != 0) console.error('pallet-preimage is not included in parachain.');
try {
const preimageMaker = await privateKey(key);
@@ -151,15 +151,15 @@
const paraAccountsRegistrators: {[name: string]: number} = {};
// cross-reference every account for changes
- for (const [key, value] of identitiesOnRelay) {
+ for(const [key, value] of identitiesOnRelay) {
const encodedKey = encodeAddress(key, ss58Format);
// only update if the identity info does not exist or is changed
const identity = paraIdentities.find(i => i[0] === encodedKey);
- if (identity) {
+ if(identity) {
const registratorId = identity[1].judgements[0][0];
paraAccountsRegistrators[encodedKey] = registratorId;
- if (isCurrentChainDataPriority(helper, registratorId, value.judgements[0][0])
+ if(isCurrentChainDataPriority(helper, registratorId, value.judgements[0][0])
|| JSON.stringify(value.info) === JSON.stringify(identity[1].info)) {
continue;
}
@@ -172,13 +172,13 @@
// identitiesToRemove.push((key as any).toHuman()[0]);
}
- if (identitiesToRemove.length != 0)
+ if(identitiesToRemove.length != 0)
await uploadPreimage(
helper,
preimageMaker,
helper.constructApiCall('api.tx.identity.forceRemoveIdentities', [identitiesToRemove]).method.toHex(),
);
- if (identitiesToAdd.length != 0)
+ if(identitiesToAdd.length != 0)
await uploadPreimage(
helper,
preimageMaker,
@@ -194,22 +194,22 @@
const supersOfSubs = await getSupers(helper);
const subsToUpdate: any[] = [];
- for (const [key, value] of subsOnRelay) {
+ for(const [key, value] of subsOnRelay) {
const encodedKey = encodeAddress(key, ss58Format);
const sub = paraSubs.find(i => i[0] === encodedKey);
- if (sub) {
+ if(sub) {
// only update if the sub-identity info does not exist or is changed
- if (isCurrentChainDataPriority(helper, paraAccountsRegistrators[encodedKey], relaySS58Prefix)
+ if(isCurrentChainDataPriority(helper, paraAccountsRegistrators[encodedKey], relaySS58Prefix)
|| JSON.stringify(value) === JSON.stringify(constructSubInfo(sub[0], sub[1], supersOfSubs)[1])) {
continue;
}
- } else if (value[1].length == 0)
+ } else if(value[1].length == 0)
continue;
subsToUpdate.push([key, value]);
}
- if (subsToUpdate.length != 0)
+ if(subsToUpdate.length != 0)
await uploadPreimage(
helper,
preimageMaker,
@@ -225,5 +225,5 @@
}, paraUrl);
};
-if (process.argv[1] === module.filename)
+if(process.argv[1] === module.filename)
forceInsertIdentities().catch(() => process.exit(1));
tests/src/util/index.tsdiffbeforeafterboth--- a/tests/src/util/index.ts
+++ b/tests/src/util/index.ts
@@ -33,13 +33,13 @@
await helper.connect(url);
const ss58Format = helper.chain.getChainProperties().ss58Format;
const privateKey = async (seed: string | {filename?: string, url?: string, ignoreFundsPresence?: boolean}) => {
- if (typeof seed === 'string') {
+ if(typeof seed === 'string') {
return helper.util.fromSeed(seed, ss58Format);
}
- if (seed.url) {
+ if(seed.url) {
const {filename} = makeNames(seed.url);
seed.filename = filename;
- } else if (seed.filename) {
+ } else if(seed.filename) {
// Pass
} else {
throw new Error('no url nor filename set');
@@ -47,7 +47,7 @@
const actualSeed = getTestSeed(seed.filename);
let account = helper.util.fromSeed(actualSeed, ss58Format);
// here's to hoping that no
- if (!seed.ignoreFundsPresence && ((helper as any)['balance'] == undefined || await (helper as any).balance.getSubstrate(account.address) < MINIMUM_DONOR_FUND)) {
+ if(!seed.ignoreFundsPresence && ((helper as any)['balance'] == undefined || await (helper as any).balance.getSubstrate(account.address) < MINIMUM_DONOR_FUND)) {
console.warn(`${path.basename(seed.filename)}: Not enough funds present on the filename account. Using the default one as the donor instead.`);
account = helper.util.fromSeed('//Alice', ss58Format);
}
@@ -112,7 +112,7 @@
export function requirePalletsOrSkip(test: Context, helper: DevUniqueHelper, requiredPallets: readonly string[]) {
const missingPallets = helper.fetchMissingPalletNames(requiredPallets);
- if (missingPallets.length > 0) {
+ if(missingPallets.length > 0) {
const skipMsg = `\tSkipping test '${test.test?.title}'.\n\tThe following pallets are missing:\n\t- ${missingPallets.join('\n\t- ')}`;
console.warn('\x1b[38:5:208m%s\x1b[0m', skipMsg);
test.skip();
@@ -123,7 +123,7 @@
(opts.only ? it.only :
opts.skip ? it.skip : it)(name, async function () {
await usingPlaygrounds(async (helper, privateKey) => {
- if (opts.requiredPallets) {
+ if(opts.requiredPallets) {
requirePalletsOrSkip(this, helper, opts.requiredPallets);
}
@@ -168,12 +168,12 @@
describeXCM.skip = (name: string, fn: (this: Mocha.Suite) => void) => describeXCM(name, fn, {skip: true});
export function sizeOfInt(i: number) {
- if (i < 0 || i > 0xffffffff) throw new Error('out of range');
+ if(i < 0 || i > 0xffffffff) throw new Error('out of range');
if(i < 0b11_1111) {
return 1;
- } else if (i < 0b11_1111_1111_1111) {
+ } else if(i < 0b11_1111_1111_1111) {
return 2;
- } else if (i < 0b11_1111_1111_1111_1111_1111_1111_1111) {
+ } else if(i < 0b11_1111_1111_1111_1111_1111_1111_1111) {
return 4;
} else {
return 5;
tests/src/util/playgrounds/unique.dev.tsdiffbeforeafterboth--- a/tests/src/util/playgrounds/unique.dev.ts
+++ b/tests/src/util/playgrounds/unique.dev.ts
@@ -38,10 +38,10 @@
enable() {
const outFn = (printer: any) => (...args: any[]) => {
- for (const arg of args) {
- if (typeof arg !== 'string')
+ for(const arg of args) {
+ if(typeof arg !== 'string')
continue;
- if (arg.includes('1000:: Normal connection closure') || arg.includes('Not decorating unknown runtime apis:') || arg.includes('RPC methods not decorated:') || arg === 'Normal connection closure')
+ if(arg.includes('1000:: Normal connection closure') || arg.includes('Not decorating unknown runtime apis:') || arg.includes('RPC methods not decorated:') || arg === 'Normal connection closure')
return;
}
printer(...args);
@@ -357,10 +357,10 @@
const tokenNominal = this.helper.balance.getOneTokenNominal();
const transactions = [];
const accounts: IKeyringPair[] = [];
- for (const balance of balances) {
+ for(const balance of balances) {
const recipient = this.helper.util.fromSeed(mnemonicGenerate(), ss58Format);
accounts.push(recipient);
- if (balance !== 0n) {
+ if(balance !== 0n) {
const tx = this.helper.constructApiCall('api.tx.balances.transfer', [{Id: recipient.address}, balance * tokenNominal]);
transactions.push(this.helper.signTransaction(donor, tx, {nonce, era: 0}, 'account generation'));
nonce++;
@@ -372,9 +372,9 @@
//#region TODO remove this region, when nonce problem will be solved
const checkBalances = async () => {
let isSuccess = true;
- for (let i = 0; i < balances.length; i++) {
+ for(let i = 0; i < balances.length; i++) {
const balance = await this.helper.balance.getSubstrate(accounts[i].address);
- if (balance !== balances[i] * tokenNominal) {
+ if(balance !== balances[i] * tokenNominal) {
isSuccess = false;
break;
}
@@ -385,13 +385,13 @@
let accountsCreated = false;
const maxBlocksChecked = await this.helper.arrange.isDevNode() ? 50 : 5;
// checkBalances retry up to 5-50 blocks
- for (let index = 0; index < maxBlocksChecked; index++) {
+ for(let index = 0; index < maxBlocksChecked; index++) {
accountsCreated = await checkBalances();
if(accountsCreated) break;
await wait.newBlocks(1);
}
- if (!accountsCreated) throw Error('Accounts generation failed');
+ if(!accountsCreated) throw Error('Accounts generation failed');
//#endregion
return accounts;
@@ -405,15 +405,15 @@
let nonce = await this.helper.chain.getNonce(donor.address);
const tokenNominal = this.helper.balance.getOneTokenNominal();
const ss58Format = this.helper.chain.getChainProperties().ss58Format;
- for (let i = 0; i < accountsToCreate; i++) {
- if (i === 500) { // if there are too many accounts to create
+ for(let i = 0; i < accountsToCreate; i++) {
+ if(i === 500) { // if there are too many accounts to create
await Promise.allSettled(transactions); // wait while first 500 (should be 100 for devnode) tx will be settled
transactions = []; //
nonce = await this.helper.chain.getNonce(donor.address); // update nonce
}
const recipient = this.helper.util.fromSeed(mnemonicGenerate(), ss58Format);
accounts.push(recipient);
- if (withBalance !== 0n) {
+ if(withBalance !== 0n) {
const tx = this.helper.constructApiCall('api.tx.balances.transfer', [{Id: recipient.address}, withBalance * tokenNominal]);
transactions.push(this.helper.signTransaction(donor, tx, {nonce}, 'account generation'));
nonce++;
@@ -422,9 +422,9 @@
const fullfilledAccounts = [];
await Promise.allSettled(transactions);
- for (const account of accounts) {
+ for(const account of accounts) {
const accountBalance = await this.helper.balance.getSubstrate(account.address);
- if (accountBalance === withBalance * tokenNominal) {
+ if(accountBalance === withBalance * tokenNominal) {
fullfilledAccounts.push(account);
}
}
@@ -434,20 +434,20 @@
const crowd: IKeyringPair[] = [];
// do up to 5 retries
- for (let index = 0; index < 5 && accountsToCreate !== 0; index++) {
+ for(let index = 0; index < 5 && accountsToCreate !== 0; index++) {
const asManyAsCan = await createAsManyAsCan();
crowd.push(...asManyAsCan);
accountsToCreate -= asManyAsCan.length;
}
- if (accountsToCreate !== 0) throw Error(`Crowd generation failed: ${accountsToCreate} accounts left`);
+ if(accountsToCreate !== 0) throw Error(`Crowd generation failed: ${accountsToCreate} accounts left`);
return crowd;
};
isDevNode = async () => {
let blockNumber = (await this.helper.callRpc('api.query.system.number')).toJSON();
- if (blockNumber == 0) {
+ if(blockNumber == 0) {
await this.helper.wait.newBlocks(1);
blockNumber = (await this.helper.callRpc('api.query.system.number')).toJSON();
}
@@ -484,7 +484,7 @@
const kvJson: {[key: string]: string} = {};
- for (const kv of rawPovInfo.keyValues) {
+ for(const kv of rawPovInfo.keyValues) {
kvJson[kv.key.toHex()] = kv.value.toHex();
}
@@ -498,7 +498,7 @@
],
);
- if (!chainql.stdout) {
+ if(!chainql.stdout) {
throw Error('unable to get an output from the `chainql`');
}
@@ -528,7 +528,7 @@
}
const ids = [];
- for (let i = 0; i < num; i++) {
+ for(let i = 0; i < num; i++) {
ids.push(makeId(this.scheduledIdSlider));
this.scheduledIdSlider += 1;
}
@@ -834,7 +834,7 @@
// eslint-disable-next-line no-async-promise-executor
const promise = new Promise<void>(async (resolve) => {
const unsubscribe = await this.helper.getApi().rpc.chain.subscribeNewHeads(() => {
- if (blocksCount > 0) {
+ if(blocksCount > 0) {
blocksCount--;
} else {
unsubscribe();
@@ -860,7 +860,7 @@
const expectedSessionIndex = await (this.helper as DevUniqueHelper).session.getIndex() + sessionCount;
let currentSessionIndex = -1;
- while (currentSessionIndex < expectedSessionIndex) {
+ while(currentSessionIndex < expectedSessionIndex) {
// eslint-disable-next-line no-async-promise-executor
currentSessionIndex = await this.withTimeout(new Promise(async (resolve) => {
await this.newBlocks(1);
@@ -875,7 +875,7 @@
// eslint-disable-next-line no-async-promise-executor
const promise = new Promise<void>(async (resolve) => {
const unsubscribe = await this.helper.getApi().rpc.chain.subscribeNewHeads((data: any) => {
- if (data.number.toNumber() >= blockNumber) {
+ if(data.number.toNumber() >= blockNumber) {
unsubscribe();
resolve();
}
@@ -890,7 +890,7 @@
// eslint-disable-next-line no-async-promise-executor
const promise = new Promise<void>(async (resolve) => {
const unsubscribe = await this.helper.getApi().query.parachainSystem.validationData((data: any) => {
- if (data.value.relayParentNumber.toNumber() >= blockNumber) {
+ if(data.value.relayParentNumber.toNumber() >= blockNumber) {
// @ts-ignore
unsubscribe();
resolve();
@@ -939,7 +939,7 @@
const eventRecords = (await apiAt.query.system.events()) as any;
const neededEvent = eventRecords.toArray().find((r: FrameSystemEventRecord) => {
- if (
+ if(
r.event.section == eventHelper.section()
&& r.event.method == eventHelper.method()
) {
@@ -950,10 +950,10 @@
}
});
- if (neededEvent) {
+ if(neededEvent) {
unsubscribe();
resolve(eventHelper);
- } else if (maxBlocksToWait > 0) {
+ } else if(maxBlocksToWait > 0) {
maxBlocksToWait--;
} else {
this.helper.logger.log(`Eligible event \`${eventIdStr}\` is NOT found`);
@@ -971,7 +971,7 @@
filter: (e: T) => boolean = () => true,
) {
const e = await this.event(maxBlocksToWait, eventHelperType, filter);
- if (e == null) {
+ if(e == null) {
const eventHelper = new eventHelperType();
throw Error(`The event '${eventHelper.section()}.${eventHelper.method()}' is expected`);
} else {
@@ -1018,7 +1018,7 @@
}
async enable() {
- if (this.helper.fetchMissingPalletNames([Pallets.TestUtils]).length != 0) {
+ if(this.helper.fetchMissingPalletNames([Pallets.TestUtils]).length != 0) {
return;
}
@@ -1082,7 +1082,7 @@
}
stopCapture() {
- if (this.unsubscribe !== null) {
+ if(this.unsubscribe !== null) {
this.unsubscribe();
}
}
tests/src/util/playgrounds/unique.tsdiffbeforeafterboth1// Copyright 2019-2022 Unique Network (Gibraltar) Ltd.2// SPDX-License-Identifier: Apache-2.034/* eslint-disable @typescript-eslint/no-var-requires */5/* eslint-disable function-call-argument-newline */6/* eslint-disable no-prototype-builtins */78import {ApiPromise, WsProvider, Keyring} from '@polkadot/api';9import {SignerOptions} from '@polkadot/api/types/submittable';10import '../../interfaces/augment-api';11import {AugmentedSubmittables} from '@polkadot/api-base/types/submittable';12import {ApiInterfaceEvents} from '@polkadot/api/types';13import {encodeAddress, decodeAddress, keccakAsHex, evmToAddress, addressToEvm, base58Encode, blake2AsU8a} from '@polkadot/util-crypto';14import {IKeyringPair} from '@polkadot/types/types';15import {hexToU8a} from '@polkadot/util/hex';16import {u8aConcat} from '@polkadot/util/u8a';17import {18 IApiListeners,19 IBlock,20 IEvent,21 IChainProperties,22 ICollectionCreationOptions,23 ICollectionLimits,24 ICollectionPermissions,25 ICrossAccountId,26 ICrossAccountIdLower,27 ILogger,28 INestingPermissions,29 IProperty,30 IStakingInfo,31 ISchedulerOptions,32 ISubstrateBalance,33 IToken,34 ITokenPropertyPermission,35 ITransactionResult,36 IUniqueHelperLog,37 TApiAllowedListeners,38 TEthereumAccount,39 TSigner,40 TSubstrateAccount,41 TNetworks,42 IForeignAssetMetadata,43 AcalaAssetMetadata,44 MoonbeamAssetInfo,45 DemocracyStandardAccountVote,46 IEthCrossAccountId,47} from './types';48import {RuntimeDispatchInfo} from '@polkadot/types/interfaces';49import type {Vec} from '@polkadot/types-codec';50import {FrameSystemEventRecord, PalletBalancesIdAmount} from '@polkadot/types/lookup';5152export class CrossAccountId {53 Substrate!: TSubstrateAccount;54 Ethereum!: TEthereumAccount;5556 constructor(account: ICrossAccountId) {57 if ('Substrate' in account) this.Substrate = account.Substrate;58 else this.Ethereum = account.Ethereum;59 }6061 static fromKeyring(account: IKeyringPair, domain: 'Substrate' | 'Ethereum' = 'Substrate') {62 switch (domain) {63 case 'Substrate': return new CrossAccountId({Substrate: account.address});64 case 'Ethereum': return new CrossAccountId({Substrate: account.address}).toEthereum();65 }66 }6768 static fromLowerCaseKeys(address: ICrossAccountIdLower): CrossAccountId {69 if ('substrate' in address) return new CrossAccountId({Substrate: address.substrate});70 else return new CrossAccountId({Ethereum: address.ethereum});71 }7273 static normalizeSubstrateAddress(address: TSubstrateAccount, ss58Format = 42): TSubstrateAccount {74 return encodeAddress(decodeAddress(address), ss58Format);75 }7677 static withNormalizedSubstrate(address: TSubstrateAccount, ss58Format = 42): CrossAccountId {78 return new CrossAccountId({Substrate: CrossAccountId.normalizeSubstrateAddress(address, ss58Format)});79 }8081 withNormalizedSubstrate(ss58Format = 42): CrossAccountId {82 if (this.Substrate) return CrossAccountId.withNormalizedSubstrate(this.Substrate, ss58Format);83 return this;84 }8586 static translateSubToEth(address: TSubstrateAccount): TEthereumAccount {87 return nesting.toChecksumAddress('0x' + Array.from(addressToEvm(address), i => i.toString(16).padStart(2, '0')).join(''));88 }8990 toEthereum(): CrossAccountId {91 if (this.Substrate) return new CrossAccountId({Ethereum: CrossAccountId.translateSubToEth(this.Substrate)});92 return this;93 }9495 static translateEthToSub(address: TEthereumAccount, ss58Format?: number): TSubstrateAccount {96 return evmToAddress(address, ss58Format);97 }9899 toSubstrate(ss58Format?: number): CrossAccountId {100 if (this.Ethereum) return new CrossAccountId({Substrate: CrossAccountId.translateEthToSub(this.Ethereum, ss58Format)});101 return this;102 }103104 toLowerCase(): CrossAccountId {105 if (this.Substrate) this.Substrate = this.Substrate.toLowerCase();106 if (this.Ethereum) this.Ethereum = this.Ethereum.toLowerCase();107 return this;108 }109}110111const nesting = {112 toChecksumAddress(address: string): string {113 if (typeof address === 'undefined') return '';114115 if (!/^(0x)?[0-9a-f]{40}$/i.test(address)) throw new Error(`Given address "${address}" is not a valid Ethereum address.`);116117 address = address.toLowerCase().replace(/^0x/i, '');118 const addressHash = keccakAsHex(address).replace(/^0x/i, '');119 const checksumAddress = ['0x'];120121 for (let i = 0; i < address.length; i++) {122 // If ith character is 8 to f then make it uppercase123 if (parseInt(addressHash[i], 16) > 7) {124 checksumAddress.push(address[i].toUpperCase());125 } else {126 checksumAddress.push(address[i]);127 }128 }129 return checksumAddress.join('');130 },131 tokenIdToAddress(collectionId: number, tokenId: number) {132 return this.toChecksumAddress(`0xf8238ccfff8ed887463fd5e0${collectionId.toString(16).padStart(8,'0')}${tokenId.toString(16).padStart(8,'0')}`);133 },134};135136class UniqueUtil {137 static transactionStatus = {138 NOT_READY: 'NotReady',139 FAIL: 'Fail',140 SUCCESS: 'Success',141 };142143 static chainLogType = {144 EXTRINSIC: 'extrinsic',145 RPC: 'rpc',146 };147148 static getTokenAccount(token: IToken): CrossAccountId {149 return new CrossAccountId({Ethereum: this.getTokenAddress(token)});150 }151152 static getTokenAddress(token: IToken): string {153 return nesting.tokenIdToAddress(token.collectionId, token.tokenId);154 }155156 static getDefaultLogger(): ILogger {157 return {158 log(msg: any, level = 'INFO') {159 console[level.toLocaleLowerCase() === 'error' ? 'error' : 'log'](...(Array.isArray(msg) ? msg : [msg]));160 },161 level: {162 ERROR: 'ERROR',163 WARNING: 'WARNING',164 INFO: 'INFO',165 },166 };167 }168169 static vec2str(arr: string[] | number[]) {170 return arr.map(x => String.fromCharCode(parseInt(x.toString()))).join('');171 }172173 static str2vec(string: string) {174 if (typeof string !== 'string') return string;175 return Array.from(string).map(x => x.charCodeAt(0));176 }177178 static fromSeed(seed: string, ss58Format = 42) {179 const keyring = new Keyring({type: 'sr25519', ss58Format});180 return keyring.addFromUri(seed);181 }182183 static extractCollectionIdFromCreationResult(creationResult: ITransactionResult): number {184 if (creationResult.status !== this.transactionStatus.SUCCESS) {185 throw Error('Unable to create collection!');186 }187188 let collectionId = null;189 creationResult.result.events.forEach(({event: {data, method, section}}) => {190 if ((section === 'common') && (method === 'CollectionCreated')) {191 collectionId = parseInt(data[0].toString(), 10);192 }193 });194195 if (collectionId === null) {196 throw Error('No CollectionCreated event was found!');197 }198199 return collectionId;200 }201202 static extractTokensFromCreationResult(creationResult: ITransactionResult): {203 success: boolean,204 tokens: { collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint }[],205 } {206 if (creationResult.status !== this.transactionStatus.SUCCESS) {207 throw Error('Unable to create tokens!');208 }209 let success = false;210 const tokens = [] as { collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint }[];211 creationResult.result.events.forEach(({event: {data, method, section}}) => {212 if (method === 'ExtrinsicSuccess') {213 success = true;214 } else if ((section === 'common') && (method === 'ItemCreated')) {215 tokens.push({216 collectionId: parseInt(data[0].toString(), 10),217 tokenId: parseInt(data[1].toString(), 10),218 owner: data[2].toHuman(),219 amount: data[3].toBigInt(),220 });221 }222 });223 return {success, tokens};224 }225226 static extractTokensFromBurnResult(burnResult: ITransactionResult): {227 success: boolean,228 tokens: { collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint }[],229 } {230 if (burnResult.status !== this.transactionStatus.SUCCESS) {231 throw Error('Unable to burn tokens!');232 }233 let success = false;234 const tokens = [] as { collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint }[];235 burnResult.result.events.forEach(({event: {data, method, section}}) => {236 if (method === 'ExtrinsicSuccess') {237 success = true;238 } else if ((section === 'common') && (method === 'ItemDestroyed')) {239 tokens.push({240 collectionId: parseInt(data[0].toString(), 10),241 tokenId: parseInt(data[1].toString(), 10),242 owner: data[2].toHuman(),243 amount: data[3].toBigInt(),244 });245 }246 });247 return {success, tokens};248 }249250 static findCollectionInEvents(events: { event: IEvent }[], collectionId: number, expectedSection: string, expectedMethod: string): boolean {251 let eventId = null;252 events.forEach(({event: {data, method, section}}) => {253 if ((section === expectedSection) && (method === expectedMethod)) {254 eventId = parseInt(data[0].toString(), 10);255 }256 });257258 if (eventId === null) {259 throw Error(`No ${expectedMethod} event was found!`);260 }261 return eventId === collectionId;262 }263264 static isTokenTransferSuccess(events: { event: IEvent }[], collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {265 const normalizeAddress = (address: string | ICrossAccountId) => {266 if (typeof address === 'string') return address;267 const obj = {} as any;268 Object.keys(address).forEach(k => {269 obj[k.toLocaleLowerCase()] = (address as any)[k];270 });271 if (obj.substrate) return CrossAccountId.withNormalizedSubstrate(obj.substrate);272 if (obj.ethereum) return CrossAccountId.fromLowerCaseKeys(obj).toLowerCase();273 return address;274 };275 let transfer = {collectionId: null, tokenId: null, from: null, to: null, amount: 1} as any;276 events.forEach(({event: {data, method, section}}) => {277 if ((section === 'common') && (method === 'Transfer')) {278 const hData = (data as any).toJSON();279 transfer = {280 collectionId: hData[0],281 tokenId: hData[1],282 from: normalizeAddress(hData[2]),283 to: normalizeAddress(hData[3]),284 amount: BigInt(hData[4]),285 };286 }287 });288 let isSuccess = parseInt(collectionId.toString()) === transfer.collectionId && parseInt(tokenId.toString()) === transfer.tokenId;289 isSuccess = isSuccess && JSON.stringify(normalizeAddress(fromAddressObj)) === JSON.stringify(transfer.from);290 isSuccess = isSuccess && JSON.stringify(normalizeAddress(toAddressObj)) === JSON.stringify(transfer.to);291 isSuccess = isSuccess && amount === transfer.amount;292 return isSuccess;293 }294295 static bigIntToDecimals(number: bigint, decimals = 18) {296 const numberStr = number.toString();297 const dotPos = numberStr.length - decimals;298299 if (dotPos <= 0) {300 return '0.' + '0'.repeat(Math.abs(dotPos)) + numberStr;301 } else {302 const intPart = numberStr.substring(0, dotPos);303 const fractPart = numberStr.substring(dotPos);304 return intPart + '.' + fractPart;305 }306 }307}308309class UniqueEventHelper {310 private static extractIndex(index: any): [number, number] | string {311 if (index.toRawType() === '[u8;2]') return [index[0], index[1]];312 return index.toJSON();313 }314315 private static extractSub(data: any, subTypes: any): { [key: string]: any } {316 let obj: any = {};317 let index = 0;318319 if (data.entries) {320 for (const [key, value] of data.entries()) {321 obj[key] = this.extractData(value, subTypes[index]);322 index++;323 }324 } else obj = data.toJSON();325326 return obj;327 }328329 private static toHuman(data: any) {330 return data && data.toHuman ? data.toHuman() : `${data}`;331 }332333 private static extractData(data: any, type: any): any {334 if (!type) return this.toHuman(data);335 if (['u16', 'u32'].indexOf(type.type) > -1) return data.toNumber();336 if (['u64', 'u128', 'u256'].indexOf(type.type) > -1) return data.toBigInt();337 if (type.hasOwnProperty('sub')) return this.extractSub(data, type.sub);338 return this.toHuman(data);339 }340341 public static extractEvents(events: { event: any, phase: any }[]): IEvent[] {342 const parsedEvents: IEvent[] = [];343344 events.forEach((record) => {345 const {event, phase} = record;346 const types = event.typeDef;347348 const eventData: IEvent = {349 section: event.section.toString(),350 method: event.method.toString(),351 index: this.extractIndex(event.index),352 data: [],353 phase: phase.toJSON(),354 };355356 event.data.forEach((val: any, index: number) => {357 eventData.data.push(this.extractData(val, types[index]));358 });359360 parsedEvents.push(eventData);361 });362363 return parsedEvents;364 }365}366const InvalidTypeSymbol = Symbol('Invalid type');367// eslint-disable-next-line @typescript-eslint/no-unused-vars368export type Invalid<ErrorMessage> =369 | ((370 invalidType: typeof InvalidTypeSymbol,371 ..._: typeof InvalidTypeSymbol[]372 ) => typeof InvalidTypeSymbol)373 | null374 | undefined;375// Has slightly better error messages than Get376type Get2<T, P extends string, E> =377 P extends `${infer Key}.${infer Key2}` ? Key extends keyof T ? Key2 extends keyof T[Key] ? T[Key][Key2] : E : E : E;378type ForceFunction<T> = T extends (...args: any) => any ? T : (...args: any) => Invalid<'not a function'>;379380export class ChainHelperBase {381 helperBase: any;382383 transactionStatus = UniqueUtil.transactionStatus;384 chainLogType = UniqueUtil.chainLogType;385 util: typeof UniqueUtil;386 eventHelper: typeof UniqueEventHelper;387 logger: ILogger;388 api: ApiPromise | null;389 forcedNetwork: TNetworks | null;390 network: TNetworks | null;391 wsEndpoint: string | null;392 chainLog: IUniqueHelperLog[];393 children: ChainHelperBase[];394 address: AddressGroup;395 chain: ChainGroup;396397 constructor(logger?: ILogger, helperBase?: any) {398 this.helperBase = helperBase;399400 this.util = UniqueUtil;401 this.eventHelper = UniqueEventHelper;402 if (typeof logger == 'undefined') logger = this.util.getDefaultLogger();403 this.logger = logger;404 this.api = null;405 this.forcedNetwork = null;406 this.network = null;407 this.wsEndpoint = null;408 this.chainLog = [];409 this.children = [];410 this.address = new AddressGroup(this);411 this.chain = new ChainGroup(this);412 }413414 clone(helperCls: ChainHelperBaseConstructor, options: { [key: string]: any } = {}) {415 Object.setPrototypeOf(helperCls.prototype, this);416 const newHelper = new helperCls(this.logger, options);417418 newHelper.api = this.api;419 newHelper.network = this.network;420 newHelper.forceNetwork = this.forceNetwork;421422 this.children.push(newHelper);423424 return newHelper;425 }426427 getEndpoint(): string {428 if (this.wsEndpoint === null) throw Error('No connection was established');429 return this.wsEndpoint;430 }431432 getApi(): ApiPromise {433 if (this.api === null) throw Error('API not initialized');434 return this.api;435 }436437 async subscribeEvents(expectedEvents: { section: string, names: string[] }[]) {438 const collectedEvents: IEvent[] = [];439 const unsubscribe = await this.getApi().query.system.events((events: Vec<FrameSystemEventRecord>) => {440 const ievents = this.eventHelper.extractEvents(events);441 ievents.forEach((event) => {442 expectedEvents.forEach((e => {443 if (event.section === e.section && e.names.includes(event.method)) {444 collectedEvents.push(event);445 }446 }));447 });448 });449 return {unsubscribe: unsubscribe as any, collectedEvents};450 }451452 clearChainLog(): void {453 this.chainLog = [];454 }455456 forceNetwork(value: TNetworks): void {457 this.forcedNetwork = value;458 }459460 async connect(wsEndpoint: string, listeners?: IApiListeners) {461 if (this.api !== null) throw Error('Already connected');462 const {api, network} = await ChainHelperBase.createConnection(wsEndpoint, listeners, this.forcedNetwork);463 this.wsEndpoint = wsEndpoint;464 this.api = api;465 this.network = network;466 }467468 async disconnect() {469 for (const child of this.children) {470 child.clearApi();471 }472473 if (this.api === null) return;474 await this.api.disconnect();475 this.clearApi();476 }477478 clearApi() {479 this.api = null;480 this.network = null;481 }482483 static async detectNetwork(api: ApiPromise): Promise<TNetworks> {484 const spec = (await api.query.system.lastRuntimeUpgrade()).toJSON() as any;485 const xcmChains = ['rococo', 'westend', 'westmint', 'acala', 'karura', 'moonbeam', 'moonriver'];486487 if (xcmChains.indexOf(spec.specName) > -1) return spec.specName;488489 if (['quartz', 'unique', 'sapphire'].indexOf(spec.specName) > -1) return spec.specName;490 return 'opal';491 }492493 static async detectNetworkByWsEndpoint(wsEndpoint: string): Promise<TNetworks> {494 const api = new ApiPromise({provider: new WsProvider(wsEndpoint)});495 await api.isReady;496497 const network = await this.detectNetwork(api);498499 await api.disconnect();500501 return network;502 }503504 static async createConnection(wsEndpoint: string, listeners?: IApiListeners, network?: TNetworks | null): Promise<{505 api: ApiPromise;506 network: TNetworks;507 }> {508 if (typeof network === 'undefined' || network === null) network = 'opal';509 const supportedRPC = {510 opal: {511 unique: require('@unique-nft/opal-testnet-types/definitions').unique.rpc,512 },513 quartz: {514 unique: require('@unique-nft/quartz-mainnet-types/definitions').unique.rpc,515 },516 unique: {517 unique: require('@unique-nft/unique-mainnet-types/definitions').unique.rpc,518 },519 rococo: {},520 westend: {},521 moonbeam: {},522 moonriver: {},523 acala: {},524 karura: {},525 westmint: {},526 };527 if (!supportedRPC.hasOwnProperty(network)) network = await this.detectNetworkByWsEndpoint(wsEndpoint);528 const rpc = supportedRPC[network];529530 // TODO: investigate how to replace rpc in runtime531 // api._rpcCore.addUserInterfaces(rpc);532533 const api = new ApiPromise({provider: new WsProvider(wsEndpoint), rpc});534535 await api.isReadyOrError;536537 if (typeof listeners === 'undefined') listeners = {};538 for (const event of ['connected', 'disconnected', 'error', 'ready', 'decorated']) {539 if (!listeners.hasOwnProperty(event) || typeof listeners[event as TApiAllowedListeners] === 'undefined') continue;540 api.on(event as ApiInterfaceEvents, listeners[event as TApiAllowedListeners] as (...args: any[]) => any);541 }542543 return {api, network};544 }545546 getTransactionStatus(data: { events: { event: IEvent }[], status: any }) {547 const {events, status} = data;548 if (status.isReady) {549 return this.transactionStatus.NOT_READY;550 }551 if (status.isBroadcast) {552 return this.transactionStatus.NOT_READY;553 }554 if (status.isInBlock || status.isFinalized) {555 const errors = events.filter(e => e.event.method === 'ExtrinsicFailed');556 if (errors.length > 0) {557 return this.transactionStatus.FAIL;558 }559 if (events.filter(e => e.event.method === 'ExtrinsicSuccess').length > 0) {560 return this.transactionStatus.SUCCESS;561 }562 }563564 return this.transactionStatus.FAIL;565 }566567 signTransaction(sender: TSigner, transaction: any, options: Partial<SignerOptions> | null = null, label = 'transaction') {568 const sign = (callback: any) => {569 if (options !== null) return transaction.signAndSend(sender, options, callback);570 return transaction.signAndSend(sender, callback);571 };572 // eslint-disable-next-line no-async-promise-executor573 return new Promise(async (resolve, reject) => {574 try {575 const unsub = await sign((result: any) => {576 const status = this.getTransactionStatus(result);577578 if (status === this.transactionStatus.SUCCESS) {579 this.logger.log(`${label} successful`);580 unsub();581 resolve({result, status, blockHash: result.status.asInBlock.toHuman()});582 } else if (status === this.transactionStatus.FAIL) {583 let moduleError = null;584585 if (result.hasOwnProperty('dispatchError')) {586 const dispatchError = result['dispatchError'];587588 if (dispatchError) {589 if (dispatchError.isModule) {590 const modErr = dispatchError.asModule;591 const errorMeta = dispatchError.registry.findMetaError(modErr);592593 moduleError = `${errorMeta.section}.${errorMeta.name}`;594 } else if (dispatchError.isToken) {595 moduleError = `Token: ${dispatchError.asToken}`;596 } else {597 // May be [object Object] in case of unhandled non-unit enum598 moduleError = `Misc: ${dispatchError.toHuman()}`;599 }600 } else {601 this.logger.log(result, this.logger.level.ERROR);602 }603 }604605 this.logger.log(`Something went wrong with ${label}. Status: ${status}`, this.logger.level.ERROR);606 unsub();607 reject({status, moduleError, result});608 }609 });610 } catch (e) {611 this.logger.log(e, this.logger.level.ERROR);612 reject(e);613 }614 });615 }616617 async signTransactionWithoutSending(signer: TSigner, tx: any) {618 const api = this.getApi();619 const signingInfo = await api.derive.tx.signingInfo(signer.address);620621 tx.sign(signer, {622 blockHash: api.genesisHash,623 genesisHash: api.genesisHash,624 runtimeVersion: api.runtimeVersion,625 nonce: signingInfo.nonce,626 });627628 return tx.toHex();629 }630631 async getPaymentInfo(signer: TSigner, tx: any, len: number | null) {632 const api = this.getApi();633 const signingInfo = await api.derive.tx.signingInfo(signer.address);634635 // We need to sign the tx because636 // unsigned transactions does not have an inclusion fee637 tx.sign(signer, {638 blockHash: api.genesisHash,639 genesisHash: api.genesisHash,640 runtimeVersion: api.runtimeVersion,641 nonce: signingInfo.nonce,642 });643644 if (len === null) {645 return (await this.callRpc('api.rpc.payment.queryInfo', [tx.toHex()])) as RuntimeDispatchInfo;646 } else {647 return (await api.call.transactionPaymentApi.queryInfo(tx, len)) as RuntimeDispatchInfo;648 }649 }650651 constructApiCall(apiCall: string, params: any[]) {652 if (!apiCall.startsWith('api.')) throw Error(`Invalid api call: ${apiCall}`);653 let call = this.getApi() as any;654 for (const part of apiCall.slice(4).split('.')) {655 call = call[part];656 if (!call) {657 const advice = part.includes('_') ? ' Looks like it needs to be converted to camel case.' : '';658 throw Error(`Function ${part} of api call ${apiCall} not found.${advice}`);659 }660 }661 return call(...params);662 }663664 encodeApiCall(apiCall: string, params: any[]) {665 return this.constructApiCall(apiCall, params).method.toHex();666 }667668 async executeExtrinsic<669 E extends string,670 V extends (671 ...args: any) => any = ForceFunction<672 Get2<673 AugmentedSubmittables<'promise'>,674 E, (...args: any) => Invalid<'not found'>675 >676 >677 >(678 sender: TSigner,679 extrinsic: `api.tx.${E}`,680 params: Parameters<V>,681 expectSuccess = true,682 options: Partial<SignerOptions> | null = null,/*, failureMessage='expected success'*/683 ): Promise<ITransactionResult> {684 if (this.api === null) throw Error('API not initialized');685 if (!extrinsic.startsWith('api.tx.')) throw Error(`${extrinsic} is not transaction`);686687 const startTime = (new Date()).getTime();688 let result: ITransactionResult;689 let events: IEvent[] = [];690 try {691 result = await this.signTransaction(sender, this.constructApiCall(extrinsic, params), options, extrinsic) as ITransactionResult;692 events = this.eventHelper.extractEvents(result.result.events);693 const errorEvent = events.find((event) => event.method == 'ExecutedFailed' || event.method == 'CreatedFailed');694 if (errorEvent)695 throw Error(errorEvent.method + ': ' + extrinsic);696 }697 catch (e) {698 if (!(e as object).hasOwnProperty('status')) throw e;699 result = e as ITransactionResult;700 }701702 const endTime = (new Date()).getTime();703704 const log = {705 executedAt: endTime,706 executionTime: endTime - startTime,707 type: this.chainLogType.EXTRINSIC,708 status: result.status,709 call: extrinsic,710 signer: this.getSignerAddress(sender),711 params,712 } as IUniqueHelperLog;713714 let errorMessage = '';715716 if (result.status !== this.transactionStatus.SUCCESS) {717 if (result.moduleError) {718 errorMessage = typeof result.moduleError === 'string'719 ? result.moduleError720 : `${Object.keys(result.moduleError)[0]}: ${Object.values(result.moduleError)[0]}`;721 log.moduleError = errorMessage;722 }723 else if (result.result.dispatchError) log.dispatchError = result.result.dispatchError;724 }725 if (events.length > 0) log.events = events;726727 this.chainLog.push(log);728729 if (expectSuccess && result.status !== this.transactionStatus.SUCCESS) {730 if (result.moduleError) throw Error(`${errorMessage}`);731 else if (result.result.dispatchError) throw Error(JSON.stringify(result.result.dispatchError));732 }733 return result as any;734 }735736 async callRpc737 // <738 // K extends 'rpc' | 'query',739 // E extends string,740 // V extends (...args: any) => any = ForceFunction<741 // Get2<742 // K extends 'rpc' ? DecoratedRpc<'promise', RpcInterface> : QueryableStorage<'promise'>,743 // E, (...args: any) => Invalid<'not found'>744 // >745 // >,746 // P = Parameters<V>,747 // >748 (rpc: string, params?: any[]): Promise<any> {749750 if (typeof params === 'undefined') params = [] as any;751 if (this.api === null) throw Error('API not initialized');752 if (!rpc.startsWith('api.rpc.') && !rpc.startsWith('api.query.')) throw Error(`${rpc} is not RPC call`);753754 const startTime = (new Date()).getTime();755 let result;756 let error = null;757 const log = {758 type: this.chainLogType.RPC,759 call: rpc,760 params,761 } as any as IUniqueHelperLog;762763 try {764 result = await this.constructApiCall(rpc, params as any);765 }766 catch (e) {767 error = e;768 }769770 const endTime = (new Date()).getTime();771772 log.executedAt = endTime;773 log.status = (error === null ? this.transactionStatus.SUCCESS : this.transactionStatus.FAIL) as 'Fail' | 'Success';774 log.executionTime = endTime - startTime;775776 this.chainLog.push(log);777778 if (error !== null) throw error;779780 return result;781 }782783 getSignerAddress(signer: IKeyringPair | string): string {784 if (typeof signer === 'string') return signer;785 return signer.address;786 }787788 fetchAllPalletNames(): string[] {789 if (this.api === null) throw Error('API not initialized');790 return this.api.runtimeMetadata.asLatest.pallets.map(m => m.name.toString().toLowerCase()).sort();791 }792793 fetchMissingPalletNames(requiredPallets: readonly string[]): string[] {794 const palletNames = this.fetchAllPalletNames();795 return requiredPallets.filter(p => !palletNames.includes(p));796 }797}798799800class HelperGroup<T extends ChainHelperBase> {801 helper: T;802803 constructor(uniqueHelper: T) {804 this.helper = uniqueHelper;805 }806}807808809class CollectionGroup extends HelperGroup<UniqueHelper> {810 /**811 * Get number of blocks when sponsored transaction is available.812 *813 * @param collectionId ID of collection814 * @param tokenId ID of token815 * @param addressObj address for which the sponsorship is checked816 * @example await getTokenNextSponsored(1, 2, {Substrate: '5DfhbVfww7ThF8q6f3...'});817 * @returns number of blocks or null if sponsorship hasn't been set818 */819 async getTokenNextSponsored(collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<number | null> {820 return (await this.helper.callRpc('api.rpc.unique.nextSponsored', [collectionId, addressObj, tokenId])).toJSON();821 }822823 /**824 * Get the number of created collections.825 *826 * @returns number of created collections827 */828 async getTotalCount(): Promise<number> {829 return (await this.helper.callRpc('api.rpc.unique.collectionStats')).created.toNumber();830 }831832 /**833 * Get information about the collection with additional data,834 * including the number of tokens it contains, its administrators,835 * the normalized address of the collection's owner, and decoded name and description.836 *837 * @param collectionId ID of collection838 * @example await getData(2)839 * @returns collection information object840 */841 async getData(collectionId: number): Promise<{842 id: number;843 name: string;844 description: string;845 tokensCount: number;846 admins: CrossAccountId[];847 normalizedOwner: TSubstrateAccount;848 raw: any849 } | null> {850 const collection = await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId]);851 const humanCollection = collection.toHuman(), collectionData = {852 id: collectionId, name: null, description: null, tokensCount: 0, admins: [],853 raw: humanCollection,854 } as any, jsonCollection = collection.toJSON();855 if (humanCollection === null) return null;856 collectionData.raw.limits = jsonCollection.limits;857 collectionData.raw.permissions = jsonCollection.permissions;858 collectionData.normalizedOwner = this.helper.address.normalizeSubstrate(collectionData.raw.owner);859 for (const key of ['name', 'description']) {860 collectionData[key] = this.helper.util.vec2str(humanCollection[key]);861 }862863 collectionData.tokensCount = (['RFT', 'NFT'].includes(humanCollection.mode))864 ? await this.helper[humanCollection.mode.toLocaleLowerCase() as 'nft' | 'rft'].getLastTokenId(collectionId)865 : 0;866 collectionData.admins = await this.getAdmins(collectionId);867868 return collectionData;869 }870871 /**872 * Get the addresses of the collection's administrators, optionally normalized.873 *874 * @param collectionId ID of collection875 * @param normalize whether to normalize the addresses to the default ss58 format876 * @example await getAdmins(1)877 * @returns array of administrators878 */879 async getAdmins(collectionId: number, normalize = false): Promise<CrossAccountId[]> {880 const admins = (await this.helper.callRpc('api.rpc.unique.adminlist', [collectionId])).toHuman();881882 return normalize883 ? admins.map((address: CrossAccountId) => address.withNormalizedSubstrate())884 : admins;885 }886887 /**888 * Get the addresses added to the collection allow-list, optionally normalized.889 * @param collectionId ID of collection890 * @param normalize whether to normalize the addresses to the default ss58 format891 * @example await getAllowList(1)892 * @returns array of allow-listed addresses893 */894 async getAllowList(collectionId: number, normalize = false): Promise<CrossAccountId[]> {895 const allowListed = (await this.helper.callRpc('api.rpc.unique.allowlist', [collectionId])).toHuman();896 return normalize897 ? allowListed.map((address: CrossAccountId) => address.withNormalizedSubstrate())898 : allowListed;899 }900901 /**902 * Get the effective limits of the collection instead of null for default values903 *904 * @param collectionId ID of collection905 * @example await getEffectiveLimits(2)906 * @returns object of collection limits907 */908 async getEffectiveLimits(collectionId: number): Promise<ICollectionLimits> {909 return (await this.helper.callRpc('api.rpc.unique.effectiveCollectionLimits', [collectionId])).toJSON();910 }911912 /**913 * Burns the collection if the signer has sufficient permissions and collection is empty.914 *915 * @param signer keyring of signer916 * @param collectionId ID of collection917 * @example await helper.collection.burn(aliceKeyring, 3);918 * @returns ```true``` if extrinsic success, otherwise ```false```919 */920 async burn(signer: TSigner, collectionId: number): Promise<boolean> {921 const result = await this.helper.executeExtrinsic(922 signer,923 'api.tx.unique.destroyCollection', [collectionId],924 true,925 );926927 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionDestroyed');928 }929930 /**931 * Sets the sponsor for the collection (Requires the Substrate address). Needs confirmation by the sponsor.932 *933 * @param signer keyring of signer934 * @param collectionId ID of collection935 * @param sponsorAddress Sponsor substrate address936 * @example setSponsor(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...")937 * @returns ```true``` if extrinsic success, otherwise ```false```938 */939 async setSponsor(signer: TSigner, collectionId: number, sponsorAddress: TSubstrateAccount): Promise<boolean> {940 const result = await this.helper.executeExtrinsic(941 signer,942 'api.tx.unique.setCollectionSponsor', [collectionId, sponsorAddress],943 true,944 );945946 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionSponsorSet');947 }948949 /**950 * Confirms consent to sponsor the collection on behalf of the signer.951 *952 * @param signer keyring of signer953 * @param collectionId ID of collection954 * @example confirmSponsorship(aliceKeyring, 10)955 * @returns ```true``` if extrinsic success, otherwise ```false```956 */957 async confirmSponsorship(signer: TSigner, collectionId: number): Promise<boolean> {958 const result = await this.helper.executeExtrinsic(959 signer,960 'api.tx.unique.confirmSponsorship', [collectionId],961 true,962 );963964 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'SponsorshipConfirmed');965 }966967 /**968 * Removes the sponsor of a collection, regardless if it consented or not.969 *970 * @param signer keyring of signer971 * @param collectionId ID of collection972 * @example removeSponsor(aliceKeyring, 10)973 * @returns ```true``` if extrinsic success, otherwise ```false```974 */975 async removeSponsor(signer: TSigner, collectionId: number): Promise<boolean> {976 const result = await this.helper.executeExtrinsic(977 signer,978 'api.tx.unique.removeCollectionSponsor', [collectionId],979 true,980 );981982 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionSponsorRemoved');983 }984985 /**986 * Sets the limits of the collection. At least one limit must be specified for a correct call.987 *988 * @param signer keyring of signer989 * @param collectionId ID of collection990 * @param limits collection limits object991 * @example992 * await setLimits(993 * aliceKeyring,994 * 10,995 * {996 * sponsorTransferTimeout: 0,997 * ownerCanDestroy: false998 * }999 * )1000 * @returns ```true``` if extrinsic success, otherwise ```false```1001 */1002 async setLimits(signer: TSigner, collectionId: number, limits: ICollectionLimits): Promise<boolean> {1003 const result = await this.helper.executeExtrinsic(1004 signer,1005 'api.tx.unique.setCollectionLimits', [collectionId, limits],1006 true,1007 );10081009 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionLimitSet');1010 }10111012 /**1013 * Changes the owner of the collection to the new Substrate address.1014 *1015 * @param signer keyring of signer1016 * @param collectionId ID of collection1017 * @param ownerAddress substrate address of new owner1018 * @example changeOwner(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...")1019 * @returns ```true``` if extrinsic success, otherwise ```false```1020 */1021 async changeOwner(signer: TSigner, collectionId: number, ownerAddress: TSubstrateAccount): Promise<boolean> {1022 const result = await this.helper.executeExtrinsic(1023 signer,1024 'api.tx.unique.changeCollectionOwner', [collectionId, ownerAddress],1025 true,1026 );10271028 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionOwnerChanged');1029 }10301031 /**1032 * Adds a collection administrator.1033 *1034 * @param signer keyring of signer1035 * @param collectionId ID of collection1036 * @param adminAddressObj Administrator address (substrate or ethereum)1037 * @example addAdmin(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."})1038 * @returns ```true``` if extrinsic success, otherwise ```false```1039 */1040 async addAdmin(signer: TSigner, collectionId: number, adminAddressObj: ICrossAccountId): Promise<boolean> {1041 const result = await this.helper.executeExtrinsic(1042 signer,1043 'api.tx.unique.addCollectionAdmin', [collectionId, adminAddressObj],1044 true,1045 );10461047 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionAdminAdded');1048 }10491050 /**1051 * Removes a collection administrator.1052 *1053 * @param signer keyring of signer1054 * @param collectionId ID of collection1055 * @param adminAddressObj Administrator address (substrate or ethereum)1056 * @example removeAdmin(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."})1057 * @returns ```true``` if extrinsic success, otherwise ```false```1058 */1059 async removeAdmin(signer: TSigner, collectionId: number, adminAddressObj: ICrossAccountId): Promise<boolean> {1060 const result = await this.helper.executeExtrinsic(1061 signer,1062 'api.tx.unique.removeCollectionAdmin', [collectionId, adminAddressObj],1063 true,1064 );10651066 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionAdminRemoved');1067 }10681069 /**1070 * Check if user is in allow list.1071 *1072 * @param collectionId ID of collection1073 * @param user Account to check1074 * @example await getAdmins(1)1075 * @returns is user in allow list1076 */1077 async allowed(collectionId: number, user: ICrossAccountId): Promise<boolean> {1078 return (await this.helper.callRpc('api.rpc.unique.allowed', [collectionId, user])).toJSON();1079 }10801081 /**1082 * Adds an address to allow list1083 * @param signer keyring of signer1084 * @param collectionId ID of collection1085 * @param addressObj address to add to the allow list1086 * @returns ```true``` if extrinsic success, otherwise ```false```1087 */1088 async addToAllowList(signer: TSigner, collectionId: number, addressObj: ICrossAccountId): Promise<boolean> {1089 const result = await this.helper.executeExtrinsic(1090 signer,1091 'api.tx.unique.addToAllowList', [collectionId, addressObj],1092 true,1093 );10941095 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'AllowListAddressAdded');1096 }10971098 /**1099 * Removes an address from allow list1100 *1101 * @param signer keyring of signer1102 * @param collectionId ID of collection1103 * @param addressObj address to remove from the allow list1104 * @returns ```true``` if extrinsic success, otherwise ```false```1105 */1106 async removeFromAllowList(signer: TSigner, collectionId: number, addressObj: ICrossAccountId): Promise<boolean> {1107 const result = await this.helper.executeExtrinsic(1108 signer,1109 'api.tx.unique.removeFromAllowList', [collectionId, addressObj],1110 true,1111 );11121113 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'AllowListAddressRemoved');1114 }11151116 /**1117 * Sets onchain permissions for selected collection.1118 *1119 * @param signer keyring of signer1120 * @param collectionId ID of collection1121 * @param permissions collection permissions object1122 * @example setPermissions(aliceKeyring, 10, {access:'AllowList', mintMode: true, nesting: {collectionAdmin: true, tokenOwner: true}});1123 * @returns ```true``` if extrinsic success, otherwise ```false```1124 */1125 async setPermissions(signer: TSigner, collectionId: number, permissions: ICollectionPermissions): Promise<boolean> {1126 const result = await this.helper.executeExtrinsic(1127 signer,1128 'api.tx.unique.setCollectionPermissions', [collectionId, permissions],1129 true,1130 );11311132 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionPermissionSet');1133 }11341135 /**1136 * Enables nesting for selected collection. If `restricted` set, you can nest only tokens from specified collections.1137 *1138 * @param signer keyring of signer1139 * @param collectionId ID of collection1140 * @param permissions nesting permissions object1141 * @example enableNesting(aliceKeyring, 10, {collectionAdmin: true, tokenOwner: true});1142 * @returns ```true``` if extrinsic success, otherwise ```false```1143 */1144 async enableNesting(signer: TSigner, collectionId: number, permissions: INestingPermissions): Promise<boolean> {1145 return await this.setPermissions(signer, collectionId, {nesting: permissions});1146 }11471148 /**1149 * Disables nesting for selected collection.1150 *1151 * @param signer keyring of signer1152 * @param collectionId ID of collection1153 * @example disableNesting(aliceKeyring, 10);1154 * @returns ```true``` if extrinsic success, otherwise ```false```1155 */1156 async disableNesting(signer: TSigner, collectionId: number): Promise<boolean> {1157 return await this.setPermissions(signer, collectionId, {nesting: {tokenOwner: false, collectionAdmin: false}});1158 }11591160 /**1161 * Sets onchain properties to the collection.1162 *1163 * @param signer keyring of signer1164 * @param collectionId ID of collection1165 * @param properties array of property objects1166 * @example setProperties(aliceKeyring, 10, [{key: "gender", value: "male"}]);1167 * @returns ```true``` if extrinsic success, otherwise ```false```1168 */1169 async setProperties(signer: TSigner, collectionId: number, properties: IProperty[]): Promise<boolean> {1170 const result = await this.helper.executeExtrinsic(1171 signer,1172 'api.tx.unique.setCollectionProperties', [collectionId, properties],1173 true,1174 );11751176 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionPropertySet');1177 }11781179 /**1180 * Get collection properties.1181 *1182 * @param collectionId ID of collection1183 * @param propertyKeys optionally filter the returned properties to only these keys1184 * @example getProperties(1219, ['location', 'date', 'time', 'isParadise']);1185 * @returns array of key-value pairs1186 */1187 async getProperties(collectionId: number, propertyKeys?: string[] | null): Promise<IProperty[]> {1188 return (await this.helper.callRpc('api.rpc.unique.collectionProperties', [collectionId, propertyKeys])).toHuman();1189 }11901191 async getPropertiesConsumedSpace(collectionId: number): Promise<number> {1192 const api = this.helper.getApi();1193 const props = (await api.query.common.collectionProperties(collectionId)).toJSON();11941195 return (props! as any).consumedSpace;1196 }11971198 async getCollectionOptions(collectionId: number) {1199 return (await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId])).toHuman();1200 }12011202 /**1203 * Deletes onchain properties from the collection.1204 *1205 * @param signer keyring of signer1206 * @param collectionId ID of collection1207 * @param propertyKeys array of property keys to delete1208 * @example deleteProperties(aliceKeyring, 10, ["gender", "age"]);1209 * @returns ```true``` if extrinsic success, otherwise ```false```1210 */1211 async deleteProperties(signer: TSigner, collectionId: number, propertyKeys: string[]): Promise<boolean> {1212 const result = await this.helper.executeExtrinsic(1213 signer,1214 'api.tx.unique.deleteCollectionProperties', [collectionId, propertyKeys],1215 true,1216 );12171218 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionPropertyDeleted');1219 }12201221 /**1222 * Changes the owner of the token.1223 *1224 * @param signer keyring of signer1225 * @param collectionId ID of collection1226 * @param tokenId ID of token1227 * @param addressObj address of a new owner1228 * @param amount amount of tokens to be transfered. For NFT must be set to 1n1229 * @example transferToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1230 * @returns true if the token success, otherwise false1231 */1232 async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId, amount = 1n): Promise<boolean> {1233 const result = await this.helper.executeExtrinsic(1234 signer,1235 'api.tx.unique.transfer', [addressObj, collectionId, tokenId, amount],1236 true, // `Unable to transfer token #${tokenId} from collection #${collectionId}`,1237 );12381239 return this.helper.util.isTokenTransferSuccess(result.result.events, collectionId, tokenId, {Substrate: typeof signer === 'string' ? signer : signer.address}, addressObj, amount);1240 }12411242 /**1243 *1244 * Change ownership of a token(s) on behalf of the owner.1245 *1246 * @param signer keyring of signer1247 * @param collectionId ID of collection1248 * @param tokenId ID of token1249 * @param fromAddressObj address on behalf of which the token will be sent1250 * @param toAddressObj new token owner1251 * @param amount amount of tokens to be transfered. For NFT must be set to 1n1252 * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg"}, {Ethereum: "0x9F0583DbB85..."})1253 * @returns true if the token success, otherwise false1254 */1255 async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n): Promise<boolean> {1256 const result = await this.helper.executeExtrinsic(1257 signer,1258 'api.tx.unique.transferFrom', [fromAddressObj, toAddressObj, collectionId, tokenId, amount],1259 true, // `Unable to transfer token #${tokenId} from collection #${collectionId}`,1260 );1261 return this.helper.util.isTokenTransferSuccess(result.result.events, collectionId, tokenId, fromAddressObj, toAddressObj, amount);1262 }12631264 /**1265 *1266 * Destroys a concrete instance of NFT/RFT or burns a specified amount of fungible tokens.1267 *1268 * @param signer keyring of signer1269 * @param collectionId ID of collection1270 * @param tokenId ID of token1271 * @param amount amount of tokens to be burned. For NFT must be set to 1n1272 * @example burnToken(aliceKeyring, 10, 5);1273 * @returns ```true``` if the extrinsic is successful, otherwise ```false```1274 */1275 async burnToken(signer: TSigner, collectionId: number, tokenId: number, amount = 1n): Promise<boolean> {1276 const burnResult = await this.helper.executeExtrinsic(1277 signer,1278 'api.tx.unique.burnItem', [collectionId, tokenId, amount],1279 true, // `Unable to burn token for ${label}`,1280 );1281 const burnedTokens = this.helper.util.extractTokensFromBurnResult(burnResult);1282 if (burnedTokens.tokens.length > 1) throw Error('Burned multiple tokens');1283 return burnedTokens.success;1284 }12851286 /**1287 * Destroys a concrete instance of NFT on behalf of the owner1288 *1289 * @param signer keyring of signer1290 * @param collectionId ID of collection1291 * @param tokenId ID of token1292 * @param fromAddressObj address on behalf of which the token will be burnt1293 * @param amount amount of tokens to be burned. For NFT must be set to 1n1294 * @example burnTokenFrom(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."}, 5, {Ethereum: "0x9F0583DbB85..."})1295 * @returns ```true``` if extrinsic success, otherwise ```false```1296 */1297 async burnTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, amount = 1n): Promise<boolean> {1298 const burnResult = await this.helper.executeExtrinsic(1299 signer,1300 'api.tx.unique.burnFrom', [collectionId, fromAddressObj, tokenId, amount],1301 true, // `Unable to burn token from for ${label}`,1302 );1303 const burnedTokens = this.helper.util.extractTokensFromBurnResult(burnResult);1304 return burnedTokens.success && burnedTokens.tokens.length > 0;1305 }13061307 /**1308 * Set, change, or remove approved address to transfer the ownership of the NFT.1309 *1310 * @param signer keyring of signer1311 * @param collectionId ID of collection1312 * @param tokenId ID of token1313 * @param toAddressObj Substrate or Ethereum address which gets approved use of the signer's tokens1314 * @param amount amount of token to be approved. For NFT must be set to 1n1315 * @returns ```true``` if extrinsic success, otherwise ```false```1316 */1317 async approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount = 1n) {1318 const approveResult = await this.helper.executeExtrinsic(1319 signer,1320 'api.tx.unique.approve', [toAddressObj, collectionId, tokenId, amount],1321 true, // `Unable to approve token for ${label}`,1322 );13231324 return this.helper.util.findCollectionInEvents(approveResult.result.events, collectionId, 'common', 'Approved');1325 }13261327 /**1328 * Set, change, or remove approved address to transfer the ownership of the NFT from eth mirror.1329 *1330 * @param signer keyring of signer1331 * @param collectionId ID of collection1332 * @param tokenId ID of token1333 * @param fromAddressObj Signer's Ethereum address containing her tokens1334 * @param toAddressObj Substrate or Ethereum address which gets approved use of the signer's tokens1335 * @param amount amount of token to be approved. For NFT must be set to 1n1336 * @returns ```true``` if extrinsic success, otherwise ```false```1337 */1338 async approveTokenFrom(signer: IKeyringPair, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {1339 const approveResult = await this.helper.executeExtrinsic(1340 signer,1341 'api.tx.unique.approveFrom', [fromAddressObj, toAddressObj, collectionId, tokenId, amount],1342 true, // `Unable to approve token for ${label}`,1343 );13441345 return this.helper.util.findCollectionInEvents(approveResult.result.events, collectionId, 'common', 'Approved');1346 }13471348 /**1349 * Set, change, or remove approved address to transfer the ownership of the NFT from eth mirror.1350 *1351 * @param signer keyring of signer1352 * @param collectionId ID of collection1353 * @param tokenId ID of token1354 * @param toAddressObj Substrate or Ethereum address which gets approved use of the signer's tokens1355 * @param amount amount of token to be approved. For NFT must be set to 1n1356 * @returns ```true``` if extrinsic success, otherwise ```false```1357 */1358 async approveTokenFromEth(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount = 1n) {1359 const ethMirror = CrossAccountId.fromKeyring(signer).toEthereum();1360 return await this.approveTokenFrom(signer, collectionId, tokenId, ethMirror, toAddressObj, amount);1361 }13621363 /**1364 * Get the amount of token pieces approved to transfer or burn. Normally 0.1365 *1366 * @param collectionId ID of collection1367 * @param tokenId ID of token1368 * @param toAccountObj address which is approved to use token pieces1369 * @param fromAccountObj address which may have allowed the use of its owned tokens1370 * @example getTokenApprovedPieces(10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Substrate: "5ERZNF88Mm7UGfPP3mdG..."})1371 * @returns number of approved to transfer pieces1372 */1373 async getTokenApprovedPieces(collectionId: number, tokenId: number, toAccountObj: ICrossAccountId, fromAccountObj: ICrossAccountId): Promise<bigint> {1374 return (await this.helper.callRpc('api.rpc.unique.allowance', [collectionId, fromAccountObj, toAccountObj, tokenId])).toBigInt();1375 }13761377 /**1378 * Get the last created token ID in a collection1379 *1380 * @param collectionId ID of collection1381 * @example getLastTokenId(10);1382 * @returns id of the last created token1383 */1384 async getLastTokenId(collectionId: number): Promise<number> {1385 return (await this.helper.callRpc('api.rpc.unique.lastTokenId', [collectionId])).toNumber();1386 }13871388 /**1389 * Check if token exists1390 *1391 * @param collectionId ID of collection1392 * @param tokenId ID of token1393 * @example doesTokenExist(10, 20);1394 * @returns true if the token exists, otherwise false1395 */1396 async doesTokenExist(collectionId: number, tokenId: number): Promise<boolean> {1397 return (await this.helper.callRpc('api.rpc.unique.tokenExists', [collectionId, tokenId])).toJSON();1398 }1399}14001401class NFTnRFT extends CollectionGroup {1402 /**1403 * Get tokens owned by account1404 *1405 * @param collectionId ID of collection1406 * @param addressObj tokens owner1407 * @example getTokensByAddress(10, {Substrate: "5DyN4Y92vZCjv38fg..."})1408 * @returns array of token ids owned by account1409 */1410 async getTokensByAddress(collectionId: number, addressObj: ICrossAccountId): Promise<number[]> {1411 return (await this.helper.callRpc('api.rpc.unique.accountTokens', [collectionId, addressObj])).toJSON();1412 }14131414 /**1415 * Get token data1416 *1417 * @param collectionId ID of collection1418 * @param tokenId ID of token1419 * @param propertyKeys optionally filter the token properties to only these keys1420 * @param blockHashAt optionally query the data at some block with this hash1421 * @example getToken(10, 5);1422 * @returns human readable token data1423 */1424 async getToken(collectionId: number, tokenId: number, propertyKeys: string[] = [], blockHashAt?: string): Promise<{1425 properties: IProperty[];1426 owner: CrossAccountId;1427 normalizedOwner: CrossAccountId;1428 } | null> {1429 let tokenData;1430 if (typeof blockHashAt === 'undefined') {1431 tokenData = await this.helper.callRpc('api.rpc.unique.tokenData', [collectionId, tokenId]);1432 }1433 else {1434 if (propertyKeys.length == 0) {1435 const collection = (await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId])).toHuman();1436 if (!collection) return null;1437 propertyKeys = collection.tokenPropertyPermissions.map((x: ITokenPropertyPermission) => x.key);1438 }1439 tokenData = await this.helper.callRpc('api.rpc.unique.tokenData', [collectionId, tokenId, propertyKeys, blockHashAt]);1440 }1441 tokenData = tokenData.toHuman();1442 if (tokenData === null || tokenData.owner === null) return null;1443 const owner = {} as any;1444 for (const key of Object.keys(tokenData.owner)) {1445 owner[key.toLocaleLowerCase()] = key.toLocaleLowerCase() == 'substrate'1446 ? CrossAccountId.normalizeSubstrateAddress(tokenData.owner[key])1447 : tokenData.owner[key];1448 }1449 tokenData.normalizedOwner = CrossAccountId.fromLowerCaseKeys(owner);1450 return tokenData;1451 }14521453 /**1454 * Get token's owner1455 * @param collectionId ID of collection1456 * @param tokenId ID of token1457 * @param blockHashAt optionally query the data at the block with this hash1458 * @example getTokenOwner(10, 5);1459 * @returns Address in CrossAccountId format, e.g. {Substrate: "5DnSF6RRjwteE3BrCj..."}1460 */1461 async getTokenOwner(collectionId: number, tokenId: number, blockHashAt?: string): Promise<CrossAccountId> {1462 let owner;1463 if (typeof blockHashAt === 'undefined') {1464 owner = await this.helper.callRpc('api.rpc.unique.tokenOwner', [collectionId, tokenId]);1465 } else {1466 owner = await this.helper.callRpc('api.rpc.unique.tokenOwner', [collectionId, tokenId, blockHashAt]);1467 }1468 return CrossAccountId.fromLowerCaseKeys(owner.toJSON());1469 }14701471 /**1472 * Recursively find the address that owns the token1473 * @param collectionId ID of collection1474 * @param tokenId ID of token1475 * @param blockHashAt1476 * @example getTokenTopmostOwner(10, 5);1477 * @returns address in CrossAccountId format, e.g. {Substrate: "5DyN4Y92vZCjv38fg..."}1478 */1479 async getTokenTopmostOwner(collectionId: number, tokenId: number, blockHashAt?: string): Promise<CrossAccountId | null> {1480 let owner;1481 if (typeof blockHashAt === 'undefined') {1482 owner = await this.helper.callRpc('api.rpc.unique.topmostTokenOwner', [collectionId, tokenId]);1483 } else {1484 owner = await this.helper.callRpc('api.rpc.unique.topmostTokenOwner', [collectionId, tokenId, blockHashAt]);1485 }14861487 if (owner === null) return null;14881489 return owner.toHuman();1490 }14911492 /**1493 * Nest one token into another1494 * @param signer keyring of signer1495 * @param tokenObj token to be nested1496 * @param rootTokenObj token to be parent1497 * @example nestToken(aliceKeyring, {collectionId: 10, tokenId: 5}, {collectionId: 10, tokenId: 4});1498 * @returns ```true``` if extrinsic success, otherwise ```false```1499 */1500 async nestToken(signer: TSigner, tokenObj: IToken, rootTokenObj: IToken): Promise<boolean> {1501 const rootTokenAddress = this.helper.util.getTokenAccount(rootTokenObj);1502 const result = await this.transferToken(signer, tokenObj.collectionId, tokenObj.tokenId, rootTokenAddress);1503 if (!result) {1504 throw Error('Unable to nest token!');1505 }1506 return result;1507 }15081509 /**1510 * Remove token from nested state1511 * @param signer keyring of signer1512 * @param tokenObj token to unnest1513 * @param rootTokenObj parent of a token1514 * @param toAddressObj address of a new token owner1515 * @example unnestToken(aliceKeyring, {collectionId: 10, tokenId: 5}, {collectionId: 10, tokenId: 4}, {Substrate: "5DyN4Y92vZCjv38fg..."});1516 * @returns ```true``` if extrinsic success, otherwise ```false```1517 */1518 async unnestToken(signer: TSigner, tokenObj: IToken, rootTokenObj: IToken, toAddressObj: ICrossAccountId): Promise<boolean> {1519 const rootTokenAddress = this.helper.util.getTokenAccount(rootTokenObj);1520 const result = await this.transferTokenFrom(signer, tokenObj.collectionId, tokenObj.tokenId, rootTokenAddress, toAddressObj);1521 if (!result) {1522 throw Error('Unable to unnest token!');1523 }1524 return result;1525 }15261527 /**1528 * Set permissions to change token properties1529 *1530 * @param signer keyring of signer1531 * @param collectionId ID of collection1532 * @param permissions permissions to change a property by the collection admin or token owner1533 * @example setTokenPropertyPermissions(1534 * aliceKeyring, 10, [{key: "gender", permission: {tokenOwner: true, mutable: true, collectionAdmin: true}}]1535 * )1536 * @returns true if extrinsic success otherwise false1537 */1538 async setTokenPropertyPermissions(signer: TSigner, collectionId: number, permissions: ITokenPropertyPermission[]): Promise<boolean> {1539 const result = await this.helper.executeExtrinsic(1540 signer,1541 'api.tx.unique.setTokenPropertyPermissions', [collectionId, permissions],1542 true,1543 );15441545 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'PropertyPermissionSet');1546 }15471548 /**1549 * Get token property permissions.1550 *1551 * @param collectionId ID of collection1552 * @param propertyKeys optionally filter the returned property permissions to only these keys1553 * @example getPropertyPermissions(1219, ['location', 'date', 'time', 'isParadise']);1554 * @returns array of key-permission pairs1555 */1556 async getPropertyPermissions(collectionId: number, propertyKeys: string[] | null = null): Promise<ITokenPropertyPermission[]> {1557 return (await this.helper.callRpc('api.rpc.unique.propertyPermissions', [collectionId, ...(propertyKeys === null ? [] : [propertyKeys])])).toHuman();1558 }15591560 /**1561 * Set token properties1562 *1563 * @param signer keyring of signer1564 * @param collectionId ID of collection1565 * @param tokenId ID of token1566 * @param properties key-value pairs of metadata which to add to a token. Keys must be permitted in the collection1567 * @example setTokenProperties(aliceKeyring, 10, 5, [{key: "gender", value: "female"}, {key: "age", value: "23"}])1568 * @returns ```true``` if extrinsic success, otherwise ```false```1569 */1570 async setTokenProperties(signer: TSigner, collectionId: number, tokenId: number, properties: IProperty[]): Promise<boolean> {1571 const result = await this.helper.executeExtrinsic(1572 signer,1573 'api.tx.unique.setTokenProperties', [collectionId, tokenId, properties],1574 true,1575 );15761577 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'TokenPropertySet');1578 }15791580 /**1581 * Get properties, metadata assigned to a token.1582 *1583 * @param collectionId ID of collection1584 * @param tokenId ID of token1585 * @param propertyKeys optionally filter the returned properties to only these keys1586 * @example getTokenProperties(1219, ['location', 'date', 'time', 'isParadise']);1587 * @returns array of key-value pairs1588 */1589 async getTokenProperties(collectionId: number, tokenId: number, propertyKeys?: string[] | null): Promise<IProperty[]> {1590 return (await this.helper.callRpc('api.rpc.unique.tokenProperties', [collectionId, tokenId, propertyKeys])).toHuman();1591 }15921593 /**1594 * Delete the provided properties of a token1595 * @param signer keyring of signer1596 * @param collectionId ID of collection1597 * @param tokenId ID of token1598 * @param propertyKeys property keys to be deleted1599 * @example deleteTokenProperties(aliceKeyring, 10, 5, ["gender", "age"])1600 * @returns ```true``` if extrinsic success, otherwise ```false```1601 */1602 async deleteTokenProperties(signer: TSigner, collectionId: number, tokenId: number, propertyKeys: string[]): Promise<boolean> {1603 const result = await this.helper.executeExtrinsic(1604 signer,1605 'api.tx.unique.deleteTokenProperties', [collectionId, tokenId, propertyKeys],1606 true,1607 );16081609 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'TokenPropertyDeleted');1610 }16111612 /**1613 * Mint new collection1614 *1615 * @param signer keyring of signer1616 * @param collectionOptions basic collection options and properties1617 * @param mode NFT or RFT type of a collection1618 * @example mintCollection(aliceKeyring, {name: 'New', description: "New collection", tokenPrefix: "NEW"}, "NFT")1619 * @returns object of the created collection1620 */1621 async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions, mode: 'NFT' | 'RFT'): Promise<UniqueBaseCollection> {1622 collectionOptions = JSON.parse(JSON.stringify(collectionOptions)) as ICollectionCreationOptions; // Clone object1623 collectionOptions.mode = (mode === 'NFT') ? {nft: null} : {refungible: null};1624 for (const key of ['name', 'description', 'tokenPrefix']) {1625 if (typeof collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] === 'string') collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] = this.helper.util.str2vec(collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] as string);1626 }1627 const creationResult = await this.helper.executeExtrinsic(1628 signer,1629 'api.tx.unique.createCollectionEx', [collectionOptions],1630 true, // errorLabel,1631 );1632 return this.getCollectionObject(this.helper.util.extractCollectionIdFromCreationResult(creationResult));1633 }16341635 getCollectionObject(_collectionId: number): any {1636 return null;1637 }16381639 getTokenObject(_collectionId: number, _tokenId: number): any {1640 return null;1641 }16421643 /**1644 * Tells whether the given `owner` approves the `operator`.1645 * @param collectionId ID of collection1646 * @param owner owner address1647 * @param operator operator addrees1648 * @returns true if operator is enabled1649 */1650 async allowanceForAll(collectionId: number, owner: ICrossAccountId, operator: ICrossAccountId): Promise<boolean> {1651 return (await this.helper.callRpc('api.rpc.unique.allowanceForAll', [collectionId, owner, operator])).toJSON();1652 }16531654 /** Sets or unsets the approval of a given operator.1655 * The `operator` is allowed to transfer all tokens of the `caller` on their behalf.1656 * @param operator Operator1657 * @param approved Should operator status be granted or revoked?1658 * @returns ```true``` if extrinsic success, otherwise ```false```1659 */1660 async setAllowanceForAll(signer: TSigner, collectionId: number, operator: ICrossAccountId, approved: boolean): Promise<boolean> {1661 const result = await this.helper.executeExtrinsic(1662 signer,1663 'api.tx.unique.setAllowanceForAll', [collectionId, operator, approved],1664 true,1665 );1666 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'ApprovedForAll');1667 }1668}166916701671class NFTGroup extends NFTnRFT {1672 /**1673 * Get collection object1674 * @param collectionId ID of collection1675 * @example getCollectionObject(2);1676 * @returns instance of UniqueNFTCollection1677 */1678 getCollectionObject(collectionId: number): UniqueNFTCollection {1679 return new UniqueNFTCollection(collectionId, this.helper);1680 }16811682 /**1683 * Get token object1684 * @param collectionId ID of collection1685 * @param tokenId ID of token1686 * @example getTokenObject(10, 5);1687 * @returns instance of UniqueNFTToken1688 */1689 getTokenObject(collectionId: number, tokenId: number): UniqueNFToken {1690 return new UniqueNFToken(tokenId, this.getCollectionObject(collectionId));1691 }16921693 /**1694 * Is token approved to transfer1695 * @param collectionId ID of collection1696 * @param tokenId ID of token1697 * @param toAccountObj address to be approved1698 * @returns ```true``` if extrinsic success, otherwise ```false```1699 */1700 async isTokenApproved(collectionId: number, tokenId: number, toAccountObj: ICrossAccountId): Promise<boolean> {1701 return (await this.getTokenApprovedPieces(collectionId, tokenId, toAccountObj, await this.getTokenOwner(collectionId, tokenId))) === 1n;1702 }17031704 /**1705 * Changes the owner of the token.1706 *1707 * @param signer keyring of signer1708 * @param collectionId ID of collection1709 * @param tokenId ID of token1710 * @param addressObj address of a new owner1711 * @example transferToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1712 * @returns ```true``` if extrinsic success, otherwise ```false```1713 */1714 async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<boolean> {1715 return await super.transferToken(signer, collectionId, tokenId, addressObj, 1n);1716 }17171718 /**1719 *1720 * Change ownership of a NFT on behalf of the owner.1721 *1722 * @param signer keyring of signer1723 * @param collectionId ID of collection1724 * @param tokenId ID of token1725 * @param fromAddressObj address on behalf of which the token will be sent1726 * @param toAddressObj new token owner1727 * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Ethereum: "0x9F0583DbB85..."})1728 * @returns ```true``` if extrinsic success, otherwise ```false```1729 */1730 async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId): Promise<boolean> {1731 return await super.transferTokenFrom(signer, collectionId, tokenId, fromAddressObj, toAddressObj, 1n);1732 }17331734 /**1735 * Get tokens nested in the provided token1736 * @param collectionId ID of collection1737 * @param tokenId ID of token1738 * @param blockHashAt optionally query the data at the block with this hash1739 * @example getTokenChildren(10, 5);1740 * @returns tokens whose depth of nesting is <= 51741 */1742 async getTokenChildren(collectionId: number, tokenId: number, blockHashAt?: string): Promise<IToken[]> {1743 let children;1744 if (typeof blockHashAt === 'undefined') {1745 children = await this.helper.callRpc('api.rpc.unique.tokenChildren', [collectionId, tokenId]);1746 } else {1747 children = await this.helper.callRpc('api.rpc.unique.tokenChildren', [collectionId, tokenId, blockHashAt]);1748 }17491750 return children.toJSON().map((x: any) => ({collectionId: x.collection, tokenId: x.token}));1751 }17521753 /**1754 * Mint new collection1755 * @param signer keyring of signer1756 * @param collectionOptions Collection options1757 * @example1758 * mintCollection(aliceKeyring, {1759 * name: 'New',1760 * description: 'New collection',1761 * tokenPrefix: 'NEW',1762 * })1763 * @returns object of the created collection1764 */1765 async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}): Promise<UniqueNFTCollection> {1766 return await super.mintCollection(signer, collectionOptions, 'NFT') as UniqueNFTCollection;1767 }17681769 /**1770 * Mint new token1771 * @param signer keyring of signer1772 * @param data token data1773 * @returns created token object1774 */1775 async mintToken(signer: TSigner, data: { collectionId: number; owner: ICrossAccountId | string; properties?: IProperty[]; }): Promise<UniqueNFToken> {1776 const creationResult = await this.helper.executeExtrinsic(1777 signer,1778 'api.tx.unique.createItem', [data.collectionId, (typeof data.owner === 'string') ? {Substrate: data.owner} : data.owner, {1779 NFT: {1780 properties: data.properties,1781 },1782 }],1783 true,1784 );1785 const createdTokens = this.helper.util.extractTokensFromCreationResult(creationResult);1786 if (createdTokens.tokens.length > 1) throw Error('Minted multiple tokens');1787 if (createdTokens.tokens.length < 1) throw Error('No tokens minted');1788 return this.getTokenObject(data.collectionId, createdTokens.tokens[0].tokenId);1789 }17901791 /**1792 * Mint multiple NFT tokens1793 * @param signer keyring of signer1794 * @param collectionId ID of collection1795 * @param tokens array of tokens with owner and properties1796 * @example1797 * mintMultipleTokens(aliceKeyring, 10, [{1798 * owner: {Substrate: "5DyN4Y92vZCjv38fg..."},1799 * properties: [{key: "gender", value: "male"},{key: "age", value: "45"}],1800 * },{1801 * owner: {Ethereum: "0x9F0583DbB855d..."},1802 * properties: [{key: "gender", value: "female"},{key: "age", value: "22"}],1803 * }]);1804 * @returns ```true``` if extrinsic success, otherwise ```false```1805 */1806 async mintMultipleTokens(signer: TSigner, collectionId: number, tokens: { owner: ICrossAccountId, properties?: IProperty[] }[]): Promise<UniqueNFToken[]> {1807 const creationResult = await this.helper.executeExtrinsic(1808 signer,1809 'api.tx.unique.createMultipleItemsEx', [collectionId, {NFT: tokens}],1810 true,1811 );1812 const collection = this.getCollectionObject(collectionId);1813 return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1814 }18151816 /**1817 * Mint multiple NFT tokens with one owner1818 * @param signer keyring of signer1819 * @param collectionId ID of collection1820 * @param owner tokens owner1821 * @param tokens array of tokens with owner and properties1822 * @example1823 * mintMultipleTokensWithOneOwner(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...", [{1824 * properties: [{1825 * key: "gender",1826 * value: "female",1827 * },{1828 * key: "age",1829 * value: "33",1830 * }],1831 * }]);1832 * @returns array of newly created tokens1833 */1834 async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, owner: ICrossAccountId, tokens: { properties?: IProperty[] }[]): Promise<UniqueNFToken[]> {1835 const rawTokens = [];1836 for (const token of tokens) {1837 const raw = {NFT: {properties: token.properties}};1838 rawTokens.push(raw);1839 }1840 const creationResult = await this.helper.executeExtrinsic(1841 signer,1842 'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],1843 true,1844 );1845 const collection = this.getCollectionObject(collectionId);1846 return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1847 }18481849 /**1850 * Set, change, or remove approved address to transfer the ownership of the NFT.1851 *1852 * @param signer keyring of signer1853 * @param collectionId ID of collection1854 * @param tokenId ID of token1855 * @param toAddressObj address to approve1856 * @example approveToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1857 * @returns ```true``` if extrinsic success, otherwise ```false```1858 */1859 approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount = 1n) {1860 return super.approveToken(signer, collectionId, tokenId, toAddressObj, amount);1861 }1862}186318641865class RFTGroup extends NFTnRFT {1866 /**1867 * Get collection object1868 * @param collectionId ID of collection1869 * @example getCollectionObject(2);1870 * @returns instance of UniqueRFTCollection1871 */1872 getCollectionObject(collectionId: number): UniqueRFTCollection {1873 return new UniqueRFTCollection(collectionId, this.helper);1874 }18751876 /**1877 * Get token object1878 * @param collectionId ID of collection1879 * @param tokenId ID of token1880 * @example getTokenObject(10, 5);1881 * @returns instance of UniqueNFTToken1882 */1883 getTokenObject(collectionId: number, tokenId: number): UniqueRFToken {1884 return new UniqueRFToken(tokenId, this.getCollectionObject(collectionId));1885 }18861887 /**1888 * Get top 10 token owners with the largest number of pieces1889 * @param collectionId ID of collection1890 * @param tokenId ID of token1891 * @example getTokenTop10Owners(10, 5);1892 * @returns array of top 10 owners1893 */1894 async getTokenTop10Owners(collectionId: number, tokenId: number): Promise<CrossAccountId[]> {1895 return (await this.helper.callRpc('api.rpc.unique.tokenOwners', [collectionId, tokenId])).toJSON().map(CrossAccountId.fromLowerCaseKeys);1896 }18971898 /**1899 * Get number of pieces owned by address1900 * @param collectionId ID of collection1901 * @param tokenId ID of token1902 * @param addressObj address token owner1903 * @example getTokenBalance(10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."});1904 * @returns number of pieces ownerd by address1905 */1906 async getTokenBalance(collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<bigint> {1907 return (await this.helper.callRpc('api.rpc.unique.balance', [collectionId, addressObj, tokenId])).toBigInt();1908 }19091910 /**1911 * Transfer pieces of token to another address1912 * @param signer keyring of signer1913 * @param collectionId ID of collection1914 * @param tokenId ID of token1915 * @param addressObj address of a new owner1916 * @param amount number of pieces to be transfered1917 * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, 2000n)1918 * @returns ```true``` if extrinsic success, otherwise ```false```1919 */1920 async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId, amount = 1n): Promise<boolean> {1921 return await super.transferToken(signer, collectionId, tokenId, addressObj, amount);1922 }19231924 /**1925 * Change ownership of some pieces of RFT on behalf of the owner.1926 * @param signer keyring of signer1927 * @param collectionId ID of collection1928 * @param tokenId ID of token1929 * @param fromAddressObj address on behalf of which the token will be sent1930 * @param toAddressObj new token owner1931 * @param amount number of pieces to be transfered1932 * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Substrate: "5DfhbVfww7ThF8q6f3i..."}, 2000n)1933 * @returns ```true``` if extrinsic success, otherwise ```false```1934 */1935 async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n): Promise<boolean> {1936 return await super.transferTokenFrom(signer, collectionId, tokenId, fromAddressObj, toAddressObj, amount);1937 }19381939 /**1940 * Mint new collection1941 * @param signer keyring of signer1942 * @param collectionOptions Collection options1943 * @example1944 * mintCollection(aliceKeyring, {1945 * name: 'New',1946 * description: 'New collection',1947 * tokenPrefix: 'NEW',1948 * })1949 * @returns object of the created collection1950 */1951 async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}): Promise<UniqueRFTCollection> {1952 return await super.mintCollection(signer, collectionOptions, 'RFT') as UniqueRFTCollection;1953 }19541955 /**1956 * Mint new token1957 * @param signer keyring of signer1958 * @param data token data1959 * @example mintToken(aliceKeyring, {collectionId: 10, owner: {Substrate: '5GHoZe9c73RYbVzq...'}, pieces: 10000n});1960 * @returns created token object1961 */1962 async mintToken(signer: TSigner, data: { collectionId: number; owner: ICrossAccountId | string; pieces: bigint; properties?: IProperty[]; }): Promise<UniqueRFToken> {1963 const creationResult = await this.helper.executeExtrinsic(1964 signer,1965 'api.tx.unique.createItem', [data.collectionId, (typeof data.owner === 'string') ? {Substrate: data.owner} : data.owner, {1966 ReFungible: {1967 pieces: data.pieces,1968 properties: data.properties,1969 },1970 }],1971 true,1972 );1973 const createdTokens = this.helper.util.extractTokensFromCreationResult(creationResult);1974 if (createdTokens.tokens.length > 1) throw Error('Minted multiple tokens');1975 if (createdTokens.tokens.length < 1) throw Error('No tokens minted');1976 return this.getTokenObject(data.collectionId, createdTokens.tokens[0].tokenId);1977 }19781979 async mintMultipleTokens(signer: TSigner, collectionId: number, tokens: { owner: ICrossAccountId, pieces: bigint, properties?: IProperty[] }[]): Promise<UniqueRFToken[]> {1980 throw Error('Not implemented');1981 const creationResult = await this.helper.executeExtrinsic(1982 signer,1983 'api.tx.unique.createMultipleItemsEx', [collectionId, {RefungibleMultipleOwners: tokens}],1984 true, // `Unable to mint RFT tokens for ${label}`,1985 );1986 const collection = this.getCollectionObject(collectionId);1987 return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1988 }19891990 /**1991 * Mint multiple RFT tokens with one owner1992 * @param signer keyring of signer1993 * @param collectionId ID of collection1994 * @param owner tokens owner1995 * @param tokens array of tokens with properties and pieces1996 * @example mintMultipleTokensWithOneOwner(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, [{pieces: 100000n, properties: [{key: "gender", value: "male"}]}]);1997 * @returns array of newly created RFT tokens1998 */1999 async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, owner: ICrossAccountId, tokens: { pieces: bigint, properties?: IProperty[] }[]): Promise<UniqueRFToken[]> {2000 const rawTokens = [];2001 for (const token of tokens) {2002 const raw = {ReFungible: {pieces: token.pieces, properties: token.properties}};2003 rawTokens.push(raw);2004 }2005 const creationResult = await this.helper.executeExtrinsic(2006 signer,2007 'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],2008 true,2009 );2010 const collection = this.getCollectionObject(collectionId);2011 return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));2012 }20132014 /**2015 * Destroys a concrete instance of RFT.2016 * @param signer keyring of signer2017 * @param collectionId ID of collection2018 * @param tokenId ID of token2019 * @param amount number of pieces to be burnt2020 * @example burnToken(aliceKeyring, 10, 5);2021 * @returns ```true``` if the extrinsic is successful, otherwise ```false```2022 */2023 async burnToken(signer: IKeyringPair, collectionId: number, tokenId: number, amount = 1n): Promise<boolean> {2024 return await super.burnToken(signer, collectionId, tokenId, amount);2025 }20262027 /**2028 * Destroys a concrete instance of RFT on behalf of the owner.2029 * @param signer keyring of signer2030 * @param collectionId ID of collection2031 * @param tokenId ID of token2032 * @param fromAddressObj address on behalf of which the token will be burnt2033 * @param amount number of pieces to be burnt2034 * @example burnTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, 2n)2035 * @returns ```true``` if extrinsic success, otherwise ```false```2036 */2037 async burnTokenFrom(signer: IKeyringPair, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, amount = 1n): Promise<boolean> {2038 return await super.burnTokenFrom(signer, collectionId, tokenId, fromAddressObj, amount);2039 }20402041 /**2042 * Set, change, or remove approved address to transfer the ownership of the RFT.2043 *2044 * @param signer keyring of signer2045 * @param collectionId ID of collection2046 * @param tokenId ID of token2047 * @param toAddressObj address to approve2048 * @param amount number of pieces to be approved2049 * @example approveToken(aliceKeyring, 10, 5, {Substrate: "5GHoZe9c73RYbVzq..."}, "", 10000n);2050 * @returns true if the token success, otherwise false2051 */2052 approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount = 1n) {2053 return super.approveToken(signer, collectionId, tokenId, toAddressObj, amount);2054 }20552056 /**2057 * Get total number of pieces2058 * @param collectionId ID of collection2059 * @param tokenId ID of token2060 * @example getTokenTotalPieces(10, 5);2061 * @returns number of pieces2062 */2063 async getTokenTotalPieces(collectionId: number, tokenId: number): Promise<bigint> {2064 return (await this.helper.callRpc('api.rpc.unique.totalPieces', [collectionId, tokenId])).unwrap().toBigInt();2065 }20662067 /**2068 * Change number of token pieces. Signer must be the owner of all token pieces.2069 * @param signer keyring of signer2070 * @param collectionId ID of collection2071 * @param tokenId ID of token2072 * @param amount new number of pieces2073 * @example repartitionToken(aliceKeyring, 10, 5, 12345n);2074 * @returns true if the repartion was success, otherwise false2075 */2076 async repartitionToken(signer: TSigner, collectionId: number, tokenId: number, amount: bigint): Promise<boolean> {2077 const currentAmount = await this.getTokenTotalPieces(collectionId, tokenId);2078 const repartitionResult = await this.helper.executeExtrinsic(2079 signer,2080 'api.tx.unique.repartition', [collectionId, tokenId, amount],2081 true,2082 );2083 if (currentAmount < amount) return this.helper.util.findCollectionInEvents(repartitionResult.result.events, collectionId, 'common', 'ItemCreated');2084 return this.helper.util.findCollectionInEvents(repartitionResult.result.events, collectionId, 'common', 'ItemDestroyed');2085 }2086}208720882089class FTGroup extends CollectionGroup {2090 /**2091 * Get collection object2092 * @param collectionId ID of collection2093 * @example getCollectionObject(2);2094 * @returns instance of UniqueFTCollection2095 */2096 getCollectionObject(collectionId: number): UniqueFTCollection {2097 return new UniqueFTCollection(collectionId, this.helper);2098 }20992100 /**2101 * Mint new fungible collection2102 * @param signer keyring of signer2103 * @param collectionOptions Collection options2104 * @param decimalPoints number of token decimals2105 * @example2106 * mintCollection(aliceKeyring, {2107 * name: 'New',2108 * description: 'New collection',2109 * tokenPrefix: 'NEW',2110 * }, 18)2111 * @returns newly created fungible collection2112 */2113 async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}, decimalPoints = 0): Promise<UniqueFTCollection> {2114 collectionOptions = JSON.parse(JSON.stringify(collectionOptions)) as ICollectionCreationOptions; // Clone object2115 if (collectionOptions.tokenPropertyPermissions) throw Error('Fungible collections has no tokenPropertyPermissions');2116 collectionOptions.mode = {fungible: decimalPoints};2117 for (const key of ['name', 'description', 'tokenPrefix']) {2118 if (typeof collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] === 'string') collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] = this.helper.util.str2vec(collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] as string);2119 }2120 const creationResult = await this.helper.executeExtrinsic(2121 signer,2122 'api.tx.unique.createCollectionEx', [collectionOptions],2123 true,2124 );2125 return this.getCollectionObject(this.helper.util.extractCollectionIdFromCreationResult(creationResult));2126 }21272128 /**2129 * Mint tokens2130 * @param signer keyring of signer2131 * @param collectionId ID of collection2132 * @param owner address owner of new tokens2133 * @param amount amount of tokens to be meanted2134 * @example mintTokens(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq"}, 1000n);2135 * @returns ```true``` if extrinsic success, otherwise ```false```2136 */2137 async mintTokens(signer: TSigner, collectionId: number, amount: bigint, owner: ICrossAccountId | string): Promise<boolean> {2138 const creationResult = await this.helper.executeExtrinsic(2139 signer,2140 'api.tx.unique.createItem', [collectionId, (typeof owner === 'string') ? {Substrate: owner} : owner, {2141 Fungible: {2142 value: amount,2143 },2144 }],2145 true, // `Unable to mint fungible tokens for ${label}`,2146 );2147 return this.helper.util.findCollectionInEvents(creationResult.result.events, collectionId, 'common', 'ItemCreated');2148 }21492150 /**2151 * Mint multiple Fungible tokens with one owner2152 * @param signer keyring of signer2153 * @param collectionId ID of collection2154 * @param owner tokens owner2155 * @param tokens array of tokens with properties and pieces2156 * @returns ```true``` if extrinsic success, otherwise ```false```2157 */2158 async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, tokens: { value: bigint }[], owner: ICrossAccountId): Promise<boolean> {2159 const rawTokens = [];2160 for (const token of tokens) {2161 const raw = {Fungible: {Value: token.value}};2162 rawTokens.push(raw);2163 }2164 const creationResult = await this.helper.executeExtrinsic(2165 signer,2166 'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],2167 true,2168 );2169 return this.helper.util.findCollectionInEvents(creationResult.result.events, collectionId, 'common', 'ItemCreated');2170 }21712172 /**2173 * Get the top 10 owners with the largest balance for the Fungible collection2174 * @param collectionId ID of collection2175 * @example getTop10Owners(10);2176 * @returns array of ```ICrossAccountId```2177 */2178 async getTop10Owners(collectionId: number): Promise<CrossAccountId[]> {2179 return (await this.helper.callRpc('api.rpc.unique.tokenOwners', [collectionId, 0])).toJSON().map(CrossAccountId.fromLowerCaseKeys);2180 }21812182 /**2183 * Get account balance2184 * @param collectionId ID of collection2185 * @param addressObj address of owner2186 * @example getBalance(10, {Substrate: "5GHoZe9c73RYbVzq..."})2187 * @returns amount of fungible tokens owned by address2188 */2189 async getBalance(collectionId: number, addressObj: ICrossAccountId): Promise<bigint> {2190 return (await this.helper.callRpc('api.rpc.unique.balance', [collectionId, addressObj, 0])).toBigInt();2191 }21922193 /**2194 * Transfer tokens to address2195 * @param signer keyring of signer2196 * @param collectionId ID of collection2197 * @param toAddressObj address recipient2198 * @param amount amount of tokens to be sent2199 * @example transfer(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n);2200 * @returns ```true``` if extrinsic success, otherwise ```false```2201 */2202 async transfer(signer: TSigner, collectionId: number, toAddressObj: ICrossAccountId, amount = 1n) {2203 return await super.transferToken(signer, collectionId, 0, toAddressObj, amount);2204 }22052206 /**2207 * Transfer some tokens on behalf of the owner.2208 * @param signer keyring of signer2209 * @param collectionId ID of collection2210 * @param fromAddressObj address on behalf of which tokens will be sent2211 * @param toAddressObj address where token to be sent2212 * @param amount number of tokens to be sent2213 * @example transferFrom(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, {Substrate: "5DfhbVfww7ThF8q6f3ij..."}, 10000n);2214 * @returns ```true``` if extrinsic success, otherwise ```false```2215 */2216 async transferFrom(signer: TSigner, collectionId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {2217 return await super.transferTokenFrom(signer, collectionId, 0, fromAddressObj, toAddressObj, amount);2218 }22192220 /**2221 * Destroy some amount of tokens2222 * @param signer keyring of signer2223 * @param collectionId ID of collection2224 * @param amount amount of tokens to be destroyed2225 * @example burnTokens(aliceKeyring, 10, 1000n);2226 * @returns ```true``` if extrinsic success, otherwise ```false```2227 */2228 async burnTokens(signer: IKeyringPair, collectionId: number, amount = 1n): Promise<boolean> {2229 return await super.burnToken(signer, collectionId, 0, amount);2230 }22312232 /**2233 * Burn some tokens on behalf of the owner.2234 * @param signer keyring of signer2235 * @param collectionId ID of collection2236 * @param fromAddressObj address on behalf of which tokens will be burnt2237 * @param amount amount of tokens to be burnt2238 * @example burnTokensFrom(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n);2239 * @returns ```true``` if extrinsic success, otherwise ```false```2240 */2241 async burnTokensFrom(signer: IKeyringPair, collectionId: number, fromAddressObj: ICrossAccountId, amount = 1n): Promise<boolean> {2242 return await super.burnTokenFrom(signer, collectionId, 0, fromAddressObj, amount);2243 }22442245 /**2246 * Get total collection supply2247 * @param collectionId2248 * @returns2249 */2250 async getTotalPieces(collectionId: number): Promise<bigint> {2251 return (await this.helper.callRpc('api.rpc.unique.totalPieces', [collectionId, 0])).unwrap().toBigInt();2252 }22532254 /**2255 * Set, change, or remove approved address to transfer tokens.2256 *2257 * @param signer keyring of signer2258 * @param collectionId ID of collection2259 * @param toAddressObj address to be approved2260 * @param amount amount of tokens to be approved2261 * @example approveTokens(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n)2262 * @returns ```true``` if extrinsic success, otherwise ```false```2263 */2264 approveTokens(signer: IKeyringPair, collectionId: number, toAddressObj: ICrossAccountId, amount = 1n) {2265 return super.approveToken(signer, collectionId, 0, toAddressObj, amount);2266 }22672268 /**2269 * Get amount of fungible tokens approved to transfer2270 * @param collectionId ID of collection2271 * @param fromAddressObj owner of tokens2272 * @param toAddressObj the address approved for the transfer of tokens on behalf of the owner2273 * @returns number of tokens approved for the transfer2274 */2275 getApprovedTokens(collectionId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {2276 return super.getTokenApprovedPieces(collectionId, 0, toAddressObj, fromAddressObj);2277 }2278}227922802281class ChainGroup extends HelperGroup<ChainHelperBase> {2282 /**2283 * Get system properties of a chain2284 * @example getChainProperties();2285 * @returns ss58Format, token decimals, and token symbol2286 */2287 getChainProperties(): IChainProperties {2288 const properties = (this.helper.getApi() as any).registry.getChainProperties().toJSON();2289 return {2290 ss58Format: properties.ss58Format.toJSON(),2291 tokenDecimals: properties.tokenDecimals.toJSON(),2292 tokenSymbol: properties.tokenSymbol.toJSON(),2293 };2294 }22952296 /**2297 * Get chain header2298 * @example getLatestBlockNumber();2299 * @returns the number of the last block2300 */2301 async getLatestBlockNumber(): Promise<number> {2302 return (await this.helper.callRpc('api.rpc.chain.getHeader')).number.toNumber();2303 }23042305 /**2306 * Get block hash by block number2307 * @param blockNumber number of block2308 * @example getBlockHashByNumber(12345);2309 * @returns hash of a block2310 */2311 async getBlockHashByNumber(blockNumber: number): Promise<string | null> {2312 const blockHash = (await this.helper.callRpc('api.rpc.chain.getBlockHash', [blockNumber])).toJSON();2313 if (blockHash === '0x0000000000000000000000000000000000000000000000000000000000000000') return null;2314 return blockHash;2315 }23162317 // TODO add docs2318 async getBlock(blockHashOrNumber: string | number): Promise<IBlock | null> {2319 const blockHash = typeof blockHashOrNumber === 'string' ? blockHashOrNumber : await this.getBlockHashByNumber(blockHashOrNumber);2320 if (!blockHash) return null;2321 return (await this.helper.callRpc('api.rpc.chain.getBlock', [blockHash])).toHuman().block;2322 }23232324 /**2325 * Get latest relay block2326 * @returns {number} relay block2327 */2328 async getRelayBlockNumber(): Promise<bigint> {2329 const blockNumber = (await this.helper.callRpc('api.query.parachainSystem.validationData')).toJSON().relayParentNumber;2330 return BigInt(blockNumber);2331 }23322333 /**2334 * Get account nonce2335 * @param address substrate address2336 * @example getNonce("5GrwvaEF5zXb26Fz...");2337 * @returns number, account's nonce2338 */2339 async getNonce(address: TSubstrateAccount): Promise<number> {2340 return (await this.helper.callRpc('api.query.system.account', [address])).nonce.toNumber();2341 }2342}23432344class SubstrateBalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2345 /**2346 * Get substrate address balance2347 * @param address substrate address2348 * @example getSubstrate("5GrwvaEF5zXb26Fz...")2349 * @returns amount of tokens on address2350 */2351 async getSubstrate(address: TSubstrateAccount): Promise<bigint> {2352 return (await this.helper.callRpc('api.query.system.account', [address])).data.free.toBigInt();2353 }23542355 /**2356 * Transfer tokens to substrate address2357 * @param signer keyring of signer2358 * @param address substrate address of a recipient2359 * @param amount amount of tokens to be transfered2360 * @example transferToSubstrate(aliceKeyring, "5GrwvaEF5zXb26Fz...", 100_000_000_000n);2361 * @returns ```true``` if extrinsic success, otherwise ```false```2362 */2363 async transferToSubstrate(signer: TSigner, address: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2364 const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.transfer', [address, amount], true/*, `Unable to transfer balance from ${this.helper.getSignerAddress(signer)} to ${address}`*/);23652366 let transfer = {from: null, to: null, amount: 0n} as any;2367 result.result.events.forEach(({event: {data, method, section}}) => {2368 if ((section === 'balances') && (method === 'Transfer')) {2369 transfer = {2370 from: this.helper.address.normalizeSubstrate(data[0]),2371 to: this.helper.address.normalizeSubstrate(data[1]),2372 amount: BigInt(data[2]),2373 };2374 }2375 });2376 const isSuccess = this.helper.address.normalizeSubstrate(typeof signer === 'string' ? signer : signer.address) === transfer.from2377 && this.helper.address.normalizeSubstrate(address) === transfer.to2378 && BigInt(amount) === transfer.amount;2379 return isSuccess;2380 }23812382 /**2383 * Get full substrate balance including free, frozen, and reserved2384 * @param address substrate address2385 * @returns2386 */2387 async getSubstrateFull(address: TSubstrateAccount): Promise<ISubstrateBalance> {2388 const accountInfo = (await this.helper.callRpc('api.query.system.account', [address])).data;2389 return {free: accountInfo.free.toBigInt(), frozen: accountInfo.frozen.toBigInt(), reserved: accountInfo.reserved.toBigInt()};2390 }23912392 /**2393 * Get total issuance2394 * @returns2395 */2396 async getTotalIssuance(): Promise<bigint> {2397 const total = (await this.helper.callRpc('api.query.balances.totalIssuance', []));2398 return total.toBigInt();2399 }24002401 async getLocked(address: TSubstrateAccount): Promise<{ id: string, amount: bigint, reason: string }[]> {2402 const locks = (await this.helper.callRpc('api.query.balances.locks', [address])).toHuman();2403 return locks.map((lock: any) => ({id: lock.id, amount: BigInt(lock.amount.replace(/,/g, '')), reasons: lock.reasons}));2404 }2405 async getFrozen(address: TSubstrateAccount): Promise<{ id: string, amount: bigint }[]> {2406 const locks = await this.helper.api!.query.balances.freezes(address);2407 return locks.map(lock => ({id: lock.id.toUtf8(), amount: lock.amount.toBigInt()}));2408 }2409}24102411class EthereumBalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2412 /**2413 * Get ethereum address balance2414 * @param address ethereum address2415 * @example getEthereum("0x9F0583DbB855d...")2416 * @returns amount of tokens on address2417 */2418 async getEthereum(address: TEthereumAccount): Promise<bigint> {2419 return (await this.helper.callRpc('api.rpc.eth.getBalance', [address])).toBigInt();2420 }24212422 /**2423 * Transfer tokens to address2424 * @param signer keyring of signer2425 * @param address Ethereum address of a recipient2426 * @param amount amount of tokens to be transfered2427 * @example transferToEthereum(alithKeyring, "0x9F0583DbB855d...", 100_000_000_000n);2428 * @returns ```true``` if extrinsic success, otherwise ```false```2429 */2430 async transferToEthereum(signer: TSigner, address: TEthereumAccount, amount: bigint | string): Promise<boolean> {2431 const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.transfer', [address, amount], true);24322433 let transfer = {from: null, to: null, amount: 0n} as any;2434 result.result.events.forEach(({event: {data, method, section}}) => {2435 if ((section === 'balances') && (method === 'Transfer')) {2436 transfer = {2437 from: data[0].toString(),2438 to: data[1].toString(),2439 amount: BigInt(data[2]),2440 };2441 }2442 });2443 const isSuccess = (typeof signer === 'string' ? signer : signer.address) === transfer.from2444 && address === transfer.to2445 && BigInt(amount) === transfer.amount;2446 return isSuccess;2447 }2448}24492450class BalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2451 subBalanceGroup: SubstrateBalanceGroup<T>;2452 ethBalanceGroup: EthereumBalanceGroup<T>;24532454 constructor(helper: T) {2455 super(helper);2456 this.subBalanceGroup = new SubstrateBalanceGroup(helper);2457 this.ethBalanceGroup = new EthereumBalanceGroup(helper);2458 }24592460 getCollectionCreationPrice(): bigint {2461 return 2n * this.getOneTokenNominal();2462 }2463 /**2464 * Representation of the native token in the smallest unit - one OPAL (OPL), QUARTZ (QTZ), or UNIQUE (UNQ).2465 * @example getOneTokenNominal()2466 * @returns ```BigInt``` representation of the native token in the smallest unit, e.g. ```1_000_000_000_000_000_000n``` for QTZ.2467 */2468 getOneTokenNominal(): bigint {2469 const chainProperties = this.helper.chain.getChainProperties();2470 return 10n ** BigInt((chainProperties.tokenDecimals || [18])[0]);2471 }24722473 /**2474 * Get substrate address balance2475 * @param address substrate address2476 * @example getSubstrate("5GrwvaEF5zXb26Fz...")2477 * @returns amount of tokens on address2478 */2479 getSubstrate(address: TSubstrateAccount): Promise<bigint> {2480 return this.subBalanceGroup.getSubstrate(address);2481 }24822483 /**2484 * Get full substrate balance including free, miscFrozen, feeFrozen, and reserved2485 * @param address substrate address2486 * @returns2487 */2488 getSubstrateFull(address: TSubstrateAccount): Promise<ISubstrateBalance> {2489 return this.subBalanceGroup.getSubstrateFull(address);2490 }24912492 /**2493 * Get total issuance2494 * @returns2495 */2496 getTotalIssuance(): Promise<bigint> {2497 return this.subBalanceGroup.getTotalIssuance();2498 }24992500 /**2501 * Get locked balances2502 * @param address substrate address2503 * @returns locked balances with reason via api.query.balances.locks2504 * @deprecated all the methods should switch to getFrozen2505 */2506 getLocked(address: TSubstrateAccount) {2507 return this.subBalanceGroup.getLocked(address);2508 }25092510 /**2511 * Get frozen balances2512 * @param address substrate address2513 * @returns frozen balances with id via api.query.balances.freezes2514 */2515 getFrozen(address: TSubstrateAccount) {2516 return this.subBalanceGroup.getFrozen(address);2517 }25182519 /**2520 * Get ethereum address balance2521 * @param address ethereum address2522 * @example getEthereum("0x9F0583DbB855d...")2523 * @returns amount of tokens on address2524 */2525 getEthereum(address: TEthereumAccount): Promise<bigint> {2526 return this.ethBalanceGroup.getEthereum(address);2527 }25282529 async setBalanceSubstrate(signer: TSigner, address: TSubstrateAccount, amount: bigint) {2530 await this.helper.executeExtrinsic(signer, 'api.tx.balances.forceSetBalance', [address, amount], true);2531 }25322533 /**2534 * Transfer tokens to substrate address2535 * @param signer keyring of signer2536 * @param address substrate address of a recipient2537 * @param amount amount of tokens to be transfered2538 * @example transferToSubstrate(aliceKeyring, "5GrwvaEF5zXb26Fz...", 100_000_000_000n);2539 * @returns ```true``` if extrinsic success, otherwise ```false```2540 */2541 transferToSubstrate(signer: TSigner, address: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2542 return this.subBalanceGroup.transferToSubstrate(signer, address, amount);2543 }25442545 async forceTransferToSubstrate(signer: TSigner, from: TSubstrateAccount, to: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2546 const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.forceTransfer', [from, to, amount], true);25472548 let transfer = {from: null, to: null, amount: 0n} as any;2549 result.result.events.forEach(({event: {data, method, section}}) => {2550 if ((section === 'balances') && (method === 'Transfer')) {2551 transfer = {2552 from: this.helper.address.normalizeSubstrate(data[0]),2553 to: this.helper.address.normalizeSubstrate(data[1]),2554 amount: BigInt(data[2]),2555 };2556 }2557 });2558 let isSuccess = this.helper.address.normalizeSubstrate(from) === transfer.from;2559 isSuccess = isSuccess && this.helper.address.normalizeSubstrate(to) === transfer.to;2560 isSuccess = isSuccess && BigInt(amount) === transfer.amount;2561 return isSuccess;2562 }25632564 /**2565 * Transfer tokens with the unlock period2566 * @param signer signers Keyring2567 * @param address Substrate address of recipient2568 * @param schedule Schedule params2569 * @example vestedTransfer(signer, recepient.address, 20000, 100, 10, 50 * nominal); // total amount of vested tokens will be 100 * 50 = 50002570 */2571 async vestedTransfer(signer: TSigner, address: TSubstrateAccount, schedule: { start: bigint, period: bigint, periodCount: bigint, perPeriod: bigint }): Promise<void> {2572 const result = await this.helper.executeExtrinsic(signer, 'api.tx.vesting.vestedTransfer', [address, schedule]);2573 const event = result.result.events2574 .find(e => e.event.section === 'vesting' &&2575 e.event.method === 'VestingScheduleAdded' &&2576 e.event.data[0].toHuman() === signer.address);2577 if (!event) throw Error('Cannot find transfer in events');2578 }25792580 /**2581 * Get schedule for recepient of vested transfer2582 * @param address Substrate address of recipient2583 * @returns2584 */2585 async getVestingSchedules(address: TSubstrateAccount): Promise<{ start: bigint, period: bigint, periodCount: bigint, perPeriod: bigint }[]> {2586 const schedule = (await this.helper.callRpc('api.query.vesting.vestingSchedules', [address])).toJSON();2587 return schedule.map((schedule: any) => ({2588 start: BigInt(schedule.start),2589 period: BigInt(schedule.period),2590 periodCount: BigInt(schedule.periodCount),2591 perPeriod: BigInt(schedule.perPeriod),2592 }));2593 }25942595 /**2596 * Claim vested tokens2597 * @param signer signers Keyring2598 */2599 async claim(signer: TSigner) {2600 const result = await this.helper.executeExtrinsic(signer, 'api.tx.vesting.claim', []);2601 const event = result.result.events2602 .find(e => e.event.section === 'vesting' &&2603 e.event.method === 'Claimed' &&2604 e.event.data[0].toHuman() === signer.address);2605 if (!event) throw Error('Cannot find claim in events');2606 }2607}26082609class AddressGroup extends HelperGroup<ChainHelperBase> {2610 /**2611 * Normalizes the address to the specified ss58 format, by default ```42```.2612 * @param address substrate address2613 * @param ss58Format format for address conversion, by default ```42```2614 * @example normalizeSubstrate("unjKJQJrRd238pkUZZvzDQrfKuM39zBSnQ5zjAGAGcdRhaJTx") // returns 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY2615 * @returns substrate address converted to normalized (i.e., starting with 5) or specified explicitly representation2616 */2617 normalizeSubstrate(address: TSubstrateAccount, ss58Format = 42): TSubstrateAccount {2618 return CrossAccountId.normalizeSubstrateAddress(address, ss58Format);2619 }26202621 /**2622 * Get address in the connected chain format2623 * @param address substrate address2624 * @example normalizeSubstrateToChainFormat("5GrwvaEF5zXb26Fz...") // returns unjKJQJrRd238pkUZZ... for Unique Network2625 * @returns address in chain format2626 */2627 normalizeSubstrateToChainFormat(address: TSubstrateAccount): TSubstrateAccount {2628 return this.normalizeSubstrate(address, this.helper.chain.getChainProperties().ss58Format);2629 }26302631 /**2632 * Get substrate mirror of an ethereum address2633 * @param ethAddress ethereum address2634 * @param toChainFormat false for normalized account2635 * @example ethToSubstrate('0x9F0583DbB855d...')2636 * @returns substrate mirror of a provided ethereum address2637 */2638 ethToSubstrate(ethAddress: TEthereumAccount, toChainFormat = false): TSubstrateAccount {2639 return CrossAccountId.translateEthToSub(ethAddress, toChainFormat ? this.helper.chain.getChainProperties().ss58Format : undefined);2640 }26412642 /**2643 * Get ethereum mirror of a substrate address2644 * @param subAddress substrate account2645 * @example substrateToEth("5DnSF6RRjwteE3BrC...")2646 * @returns ethereum mirror of a provided substrate address2647 */2648 substrateToEth(subAddress: TSubstrateAccount): TEthereumAccount {2649 return CrossAccountId.translateSubToEth(subAddress);2650 }26512652 /**2653 * Encode key to substrate address2654 * @param key key for encoding address2655 * @param ss58Format prefix for encoding to the address of the corresponding network2656 * @returns encoded substrate address2657 */2658 encodeSubstrateAddress(key: Uint8Array | string | bigint, ss58Format = 42): string {2659 const u8a: Uint8Array = typeof key === 'string'2660 ? hexToU8a(key)2661 : typeof key === 'bigint'2662 ? hexToU8a(key.toString(16))2663 : key;26642665 if (ss58Format < 0 || ss58Format > 16383 || [46, 47].includes(ss58Format)) {2666 throw new Error(`ss58Format is not valid, received ${typeofss58Format} "${ss58Format}"`);2667 }26682669 const allowedDecodedLengths = [1, 2, 4, 8, 32, 33];2670 if (!allowedDecodedLengths.includes(u8a.length)) {2671 throw new Error(`key length is not valid, received ${u8a.length}, valid values are ${allowedDecodedLengths.join(', ')}`);2672 }26732674 const u8aPrefix = ss58Format < 642675 ? new Uint8Array([ss58Format])2676 : new Uint8Array([2677 ((ss58Format & 0xfc) >> 2) | 0x40,2678 (ss58Format >> 8) | ((ss58Format & 0x03) << 6),2679 ]);26802681 const input = u8aConcat(u8aPrefix, u8a);26822683 return base58Encode(u8aConcat(2684 input,2685 blake2AsU8a(input).subarray(0, [32, 33].includes(u8a.length) ? 2 : 1),2686 ));2687 }26882689 /**2690 * Restore substrate address from bigint representation2691 * @param number decimal representation of substrate address2692 * @returns substrate address2693 */2694 restoreCrossAccountFromBigInt(number: bigint): TSubstrateAccount {2695 if (this.helper.api === null) {2696 throw 'Not connected';2697 }2698 const res = this.helper.api.registry.createType('AccountId', '0x' + number.toString(16).padStart(64, '0')).toJSON();2699 if (res === undefined || res === null) {2700 throw 'Restore address error';2701 }2702 return res.toString();2703 }27042705 /**2706 * Convert etherium cross account id to substrate cross account id2707 * @param ethCrossAccount etherium cross account2708 * @returns substrate cross account id2709 */2710 convertCrossAccountFromEthCrossAccount(ethCrossAccount: IEthCrossAccountId): ICrossAccountId {2711 if (ethCrossAccount.sub === '0') {2712 return {Ethereum: ethCrossAccount.eth.toLocaleLowerCase()};2713 }27142715 const ss58 = this.restoreCrossAccountFromBigInt(BigInt(ethCrossAccount.sub));2716 return {Substrate: ss58};2717 }27182719 paraSiblingSovereignAccount(paraid: number) {2720 // We are getting a *sibling* parachain sovereign account,2721 // so we need a sibling prefix: encoded(b"sibl") == 0x7369626c2722 const siblingPrefix = '0x7369626c';27232724 const encodedParaId = this.helper.getApi().createType('u32', paraid).toHex(true).substring(2);2725 const suffix = '000000000000000000000000000000000000000000000000';27262727 return siblingPrefix + encodedParaId + suffix;2728 }2729}27302731class StakingGroup extends HelperGroup<UniqueHelper> {2732 /**2733 * Stake tokens for App Promotion2734 * @param signer keyring of signer2735 * @param amountToStake amount of tokens to stake2736 * @param label extra label for log2737 * @returns2738 */2739 async stake(signer: TSigner, amountToStake: bigint, label?: string): Promise<boolean> {2740 if (typeof label === 'undefined') label = `${signer.address} amount: ${amountToStake}`;2741 const _stakeResult = await this.helper.executeExtrinsic(2742 signer, 'api.tx.appPromotion.stake',2743 [amountToStake], true,2744 );2745 // TODO extract info from stakeResult2746 return true;2747 }27482749 /**2750 * Unstake all staked tokens2751 * @param signer keyring of signer2752 * @param amountToUnstake amount of tokens to unstake2753 * @param label extra label for log2754 * @returns block hash where unstake happened2755 */2756 async unstakeAll(signer: TSigner, label?: string): Promise<string> {2757 if (typeof label === 'undefined') label = `${signer.address}`;2758 const unstakeResult = await this.helper.executeExtrinsic(2759 signer, 'api.tx.appPromotion.unstakeAll',2760 [], true,2761 );2762 return unstakeResult.blockHash;2763 }27642765 /**2766 * Unstake the part of a staked tokens2767 * @param signer keyring of signer2768 * @param amount amount of tokens to unstake2769 * @param label extra label for log2770 * @returns block hash where unstake happened2771 */2772 async unstakePartial(signer: TSigner, amount: bigint, label?: string): Promise<string> {2773 if (typeof label === 'undefined') label = `${signer.address}`;2774 const unstakeResult = await this.helper.executeExtrinsic(2775 signer, 'api.tx.appPromotion.unstakePartial',2776 [amount], true,2777 );2778 return unstakeResult.blockHash;2779 }27802781 /**2782 * Get total number of active stakes2783 * @param address substrate address2784 * @returns {number}2785 */2786 async getStakesNumber(address: ICrossAccountId): Promise<number> {2787 if ('Ethereum' in address) throw Error('only substrate address');2788 return (await this.helper.callRpc('api.query.appPromotion.stakesPerAccount', [address.Substrate])).toNumber();2789 }27902791 /**2792 * Get total staked amount for address2793 * @param address substrate or ethereum address2794 * @returns total staked amount2795 */2796 async getTotalStaked(address?: ICrossAccountId): Promise<bigint> {2797 if (address) return (await this.helper.callRpc('api.rpc.appPromotion.totalStaked', [address])).toBigInt();2798 return (await this.helper.callRpc('api.rpc.appPromotion.totalStaked')).toBigInt();2799 }28002801 /**2802 * Get total staked per block2803 * @param address substrate or ethereum address2804 * @returns array of stakes. `block` – the number of the block in which the stake was made. `amount` - the number of tokens staked in the block2805 */2806 async getTotalStakedPerBlock(address: ICrossAccountId): Promise<IStakingInfo[]> {2807 const rawTotalStakerdPerBlock = await this.helper.callRpc('api.rpc.appPromotion.totalStakedPerBlock', [address]);2808 return rawTotalStakerdPerBlock.map(([block, amount]: any[]) => ({2809 block: block.toBigInt(),2810 amount: amount.toBigInt(),2811 }));2812 }28132814 /**2815 * Get total pending unstake amount for address2816 * @param address substrate or ethereum address2817 * @returns total pending unstake amount2818 */2819 async getPendingUnstake(address: ICrossAccountId): Promise<bigint> {2820 return (await this.helper.callRpc('api.rpc.appPromotion.pendingUnstake', [address])).toBigInt();2821 }28222823 /**2824 * Get pending unstake amount per block for address2825 * @param address substrate or ethereum address2826 * @returns array of pending stakes. `block` – the number of the block in which the unstake was made. `amount` - the number of tokens unstaked in the block2827 */2828 async getPendingUnstakePerBlock(address: ICrossAccountId): Promise<IStakingInfo[]> {2829 const rawUnstakedPerBlock = await this.helper.callRpc('api.rpc.appPromotion.pendingUnstakePerBlock', [address]);2830 const result = rawUnstakedPerBlock.map(([block, amount]: any[]) => ({2831 block: block.toBigInt(),2832 amount: amount.toBigInt(),2833 }));2834 return result;2835 }2836}28372838class SchedulerGroup extends HelperGroup<UniqueHelper> {2839 constructor(helper: UniqueHelper) {2840 super(helper);2841 }28422843 cancelScheduled(signer: TSigner, scheduledId: string) {2844 return this.helper.executeExtrinsic(2845 signer,2846 'api.tx.scheduler.cancelNamed',2847 [scheduledId],2848 true,2849 );2850 }28512852 changePriority(signer: TSigner, scheduledId: string, priority: number) {2853 return this.helper.executeExtrinsic(2854 signer,2855 'api.tx.scheduler.changeNamedPriority',2856 [scheduledId, priority],2857 true,2858 );2859 }28602861 scheduleAt<T extends UniqueHelper>(2862 executionBlockNumber: number,2863 options: ISchedulerOptions = {},2864 ) {2865 return this.schedule<T>('schedule', executionBlockNumber, options);2866 }28672868 scheduleAfter<T extends UniqueHelper>(2869 blocksBeforeExecution: number,2870 options: ISchedulerOptions = {},2871 ) {2872 return this.schedule<T>('scheduleAfter', blocksBeforeExecution, options);2873 }28742875 schedule<T extends UniqueHelper>(2876 scheduleFn: 'schedule' | 'scheduleAfter',2877 blocksNum: number,2878 options: ISchedulerOptions = {},2879 ) {2880 // eslint-disable-next-line @typescript-eslint/naming-convention2881 const ScheduledHelperType = ScheduledUniqueHelper(this.helper.helperBase);2882 return this.helper.clone(ScheduledHelperType, {2883 scheduleFn,2884 blocksNum,2885 options,2886 }) as T;2887 }2888}28892890class CollatorSelectionGroup extends HelperGroup<UniqueHelper> {2891 //todo:collator documentation2892 addInvulnerable(signer: TSigner, address: string) {2893 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.addInvulnerable', [address]);2894 }28952896 removeInvulnerable(signer: TSigner, address: string) {2897 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.removeInvulnerable', [address]);2898 }28992900 async getInvulnerables(): Promise<string[]> {2901 return (await this.helper.callRpc('api.query.collatorSelection.invulnerables')).map((x: any) => x.toHuman());2902 }29032904 /** and also total max invulnerables */2905 maxCollators(): number {2906 return (this.helper.getApi().consts.configuration.defaultCollatorSelectionMaxCollators.toJSON() as number);2907 }29082909 async getDesiredCollators(): Promise<number> {2910 return (await this.helper.callRpc('api.query.configuration.collatorSelectionDesiredCollatorsOverride')).toNumber();2911 }29122913 setLicenseBond(signer: TSigner, amount: bigint) {2914 return this.helper.executeExtrinsic(signer, 'api.tx.configuration.setCollatorSelectionLicenseBond', [amount]);2915 }29162917 async getLicenseBond(): Promise<bigint> {2918 return (await this.helper.callRpc('api.query.configuration.collatorSelectionLicenseBondOverride')).toBigInt();2919 }29202921 obtainLicense(signer: TSigner) {2922 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.getLicense', []);2923 }29242925 releaseLicense(signer: TSigner) {2926 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.releaseLicense', []);2927 }29282929 forceReleaseLicense(signer: TSigner, released: string) {2930 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.forceReleaseLicense', [released]);2931 }29322933 async hasLicense(address: string): Promise<bigint> {2934 return (await this.helper.callRpc('api.query.collatorSelection.licenseDepositOf', [address])).toBigInt();2935 }29362937 onboard(signer: TSigner) {2938 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.onboard', []);2939 }29402941 offboard(signer: TSigner) {2942 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.offboard', []);2943 }29442945 async getCandidates(): Promise<string[]> {2946 return (await this.helper.callRpc('api.query.collatorSelection.candidates')).map((x: any) => x.toHuman());2947 }2948}29492950class PreimageGroup extends HelperGroup<UniqueHelper> {2951 async getPreimageInfo(h256: string) {2952 return (await this.helper.callRpc('api.query.preimage.statusFor', [h256])).toJSON();2953 }29542955 /**2956 * Create a preimage with a hex or a byte array.2957 * @param signer keyring of the signer.2958 * @param bytes preimage encoded in hex or a byte array, e.g. an extrinsic call.2959 * @example await notePreimage(preimageMaker,2960 * helper.constructApiCall('api.tx.identity.forceInsertIdentities', [identitiesToAdd]).method.toHex()2961 * );2962 * @returns promise of extrinsic execution.2963 */2964 notePreimage(signer: TSigner, bytes: string | Uint8Array) {2965 return this.helper.executeExtrinsic(signer, 'api.tx.preimage.notePreimage', [bytes]);2966 }29672968 /**2969 * Delete an existing preimage and return the deposit.2970 * @param signer keyring of the signer - either the owner or the preimage manager (sudo).2971 * @param h256 hash of the preimage.2972 * @returns promise of extrinsic execution.2973 */2974 unnotePreimage(signer: TSigner, h256: string) {2975 return this.helper.executeExtrinsic(signer, 'api.tx.preimage.unnotePreimage', [h256]);2976 }29772978 /**2979 * Request a preimage be uploaded to the chain without paying any fees or deposits.2980 * @param signer keyring of the signer - either the owner or the preimage manager (sudo).2981 * @param h256 hash of the preimage.2982 * @returns promise of extrinsic execution.2983 */2984 requestPreimage(signer: TSigner, h256: string) {2985 return this.helper.executeExtrinsic(signer, 'api.tx.preimage.requestPreimage', [h256]);2986 }29872988 /**2989 * Clear a previously made request for a preimage.2990 * @param signer keyring of the signer - either the owner or the preimage manager (sudo).2991 * @param h256 hash of the preimage.2992 * @returns promise of extrinsic execution.2993 */2994 unrequestPreimage(signer: TSigner, h256: string) {2995 return this.helper.executeExtrinsic(signer, 'api.tx.preimage.unrequestPreimage', [h256]);2996 }2997}29982999class ForeignAssetsGroup extends HelperGroup<UniqueHelper> {3000 async register(signer: TSigner, ownerAddress: TSubstrateAccount, location: any, metadata: IForeignAssetMetadata) {3001 await this.helper.executeExtrinsic(3002 signer,3003 'api.tx.foreignAssets.registerForeignAsset',3004 [ownerAddress, location, metadata],3005 true,3006 );3007 }30083009 async update(signer: TSigner, foreignAssetId: number, location: any, metadata: IForeignAssetMetadata) {3010 await this.helper.executeExtrinsic(3011 signer,3012 'api.tx.foreignAssets.updateForeignAsset',3013 [foreignAssetId, location, metadata],3014 true,3015 );3016 }3017}30183019class XcmGroup<T extends ChainHelperBase> extends HelperGroup<T> {3020 palletName: string;30213022 constructor(helper: T, palletName: string) {3023 super(helper);30243025 this.palletName = palletName;3026 }30273028 async limitedReserveTransferAssets(signer: TSigner, destination: any, beneficiary: any, assets: any, feeAssetItem: number, weightLimit: any) {3029 await this.helper.executeExtrinsic(signer, `api.tx.${this.palletName}.limitedReserveTransferAssets`, [destination, beneficiary, assets, feeAssetItem, weightLimit], true);3030 }30313032 async setSafeXcmVersion(signer: TSigner, version: number) {3033 await this.helper.executeExtrinsic(signer, `api.tx.${this.palletName}.forceDefaultXcmVersion`, [version], true);3034 }30353036 async teleportAssets(signer: TSigner, destination: any, beneficiary: any, assets: any, feeAssetItem: number) {3037 await this.helper.executeExtrinsic(signer, `api.tx.${this.palletName}.teleportAssets`, [destination, beneficiary, assets, feeAssetItem], true);3038 }30393040 async teleportNativeAsset(signer: TSigner, destinationParaId: number, targetAccount: Uint8Array, amount: bigint, xcmVersion = 3) {3041 const destinationContent = {3042 parents: 0,3043 interior: {3044 X1: {3045 Parachain: destinationParaId,3046 },3047 },3048 };30493050 const beneficiaryContent = {3051 parents: 0,3052 interior: {3053 X1: {3054 AccountId32: {3055 network: 'Any',3056 id: targetAccount,3057 },3058 },3059 },3060 };30613062 const assetsContent = [3063 {3064 id: {3065 Concrete: {3066 parents: 0,3067 interior: 'Here',3068 },3069 },3070 fun: {3071 Fungible: amount,3072 },3073 },3074 ];30753076 let destination;3077 let beneficiary;3078 let assets;30793080 if (xcmVersion == 2) {3081 destination = {V1: destinationContent};3082 beneficiary = {V1: beneficiaryContent};3083 assets = {V1: assetsContent};30843085 } else if (xcmVersion == 3) {3086 destination = {V2: destinationContent};3087 beneficiary = {V2: beneficiaryContent};3088 assets = {V2: assetsContent};30893090 } else {3091 throw Error('Unknown XCM version: ' + xcmVersion);3092 }30933094 const feeAssetItem = 0;30953096 await this.teleportAssets(signer, destination, beneficiary, assets, feeAssetItem);3097 }30983099 async send(signer: IKeyringPair, destination: any, message: any) {3100 await this.helper.executeExtrinsic(3101 signer,3102 `api.tx.${this.palletName}.send`,3103 [3104 destination,3105 message,3106 ],3107 true,3108 );3109 }3110}31113112class XTokensGroup<T extends ChainHelperBase> extends HelperGroup<T> {3113 async transfer(signer: TSigner, currencyId: any, amount: bigint, destination: any, destWeight: any) {3114 await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transfer', [currencyId, amount, destination, destWeight], true);3115 }31163117 async transferMultiasset(signer: TSigner, asset: any, destination: any, destWeight: any) {3118 await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transferMultiasset', [asset, destination, destWeight], true);3119 }31203121 async transferMulticurrencies(signer: TSigner, currencies: any[], feeItem: number, destLocation: any, destWeight: any) {3122 await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transferMulticurrencies', [currencies, feeItem, destLocation, destWeight], true);3123 }3124}31253126class TokensGroup<T extends ChainHelperBase> extends HelperGroup<T> {3127 async accounts(address: string, currencyId: any) {3128 const {free} = (await this.helper.callRpc('api.query.tokens.accounts', [address, currencyId])).toJSON() as any;3129 return BigInt(free);3130 }3131}31323133class AssetsGroup<T extends ChainHelperBase> extends HelperGroup<T> {3134 async create(signer: TSigner, assetId: number, admin: string, minimalBalance: bigint) {3135 await this.helper.executeExtrinsic(signer, 'api.tx.assets.create', [assetId, admin, minimalBalance], true);3136 }31373138 async setMetadata(signer: TSigner, assetId: number, name: string, symbol: string, decimals: number) {3139 await this.helper.executeExtrinsic(signer, 'api.tx.assets.setMetadata', [assetId, name, symbol, decimals], true);3140 }31413142 async mint(signer: TSigner, assetId: number, beneficiary: string, amount: bigint) {3143 await this.helper.executeExtrinsic(signer, 'api.tx.assets.mint', [assetId, beneficiary, amount], true);3144 }31453146 async account(assetId: string | number, address: string) {3147 const accountAsset = (3148 await this.helper.callRpc('api.query.assets.account', [assetId, address])3149 ).toJSON()! as any;31503151 if (accountAsset !== null) {3152 return BigInt(accountAsset['balance']);3153 } else {3154 return null;3155 }3156 }3157}31583159class AcalaAssetRegistryGroup extends HelperGroup<AcalaHelper> {3160 async registerForeignAsset(signer: TSigner, destination: any, metadata: AcalaAssetMetadata) {3161 await this.helper.executeExtrinsic(signer, 'api.tx.assetRegistry.registerForeignAsset', [destination, metadata], true);3162 }3163}31643165class MoonbeamAssetManagerGroup extends HelperGroup<MoonbeamHelper> {3166 makeRegisterForeignAssetProposal(assetInfo: MoonbeamAssetInfo) {3167 const apiPrefix = 'api.tx.assetManager.';31683169 const registerTx = this.helper.constructApiCall(3170 apiPrefix + 'registerForeignAsset',3171 [assetInfo.location, assetInfo.metadata, assetInfo.existentialDeposit, assetInfo.isSufficient],3172 );31733174 const setUnitsTx = this.helper.constructApiCall(3175 apiPrefix + 'setAssetUnitsPerSecond',3176 [assetInfo.location, assetInfo.unitsPerSecond, assetInfo.numAssetsWeightHint],3177 );31783179 const batchCall = this.helper.getApi().tx.utility.batchAll([registerTx, setUnitsTx]);3180 const encodedProposal = batchCall?.method.toHex() || '';3181 return encodedProposal;3182 }31833184 async assetTypeId(location: any) {3185 return await this.helper.callRpc('api.query.assetManager.assetTypeId', [location]);3186 }3187}31883189class MoonbeamDemocracyGroup extends HelperGroup<MoonbeamHelper> {3190 notePreimagePallet: string;31913192 constructor(helper: MoonbeamHelper, options: { [key: string]: any } = {}) {3193 super(helper);3194 this.notePreimagePallet = options.notePreimagePallet;3195 }31963197 async notePreimage(signer: TSigner, encodedProposal: string) {3198 await this.helper.executeExtrinsic(signer, `api.tx.${this.notePreimagePallet}.notePreimage`, [encodedProposal], true);3199 }32003201 externalProposeMajority(proposal: any) {3202 return this.helper.constructApiCall('api.tx.democracy.externalProposeMajority', [proposal]);3203 }32043205 fastTrack(proposalHash: string, votingPeriod: number, delayPeriod: number) {3206 return this.helper.constructApiCall('api.tx.democracy.fastTrack', [proposalHash, votingPeriod, delayPeriod]);3207 }32083209 async referendumVote(signer: TSigner, referendumIndex: number, accountVote: DemocracyStandardAccountVote) {3210 await this.helper.executeExtrinsic(signer, 'api.tx.democracy.vote', [referendumIndex, {Standard: accountVote}], true);3211 }3212}32133214class MoonbeamCollectiveGroup extends HelperGroup<MoonbeamHelper> {3215 collective: string;32163217 constructor(helper: MoonbeamHelper, collective: string) {3218 super(helper);32193220 this.collective = collective;3221 }32223223 async propose(signer: TSigner, threshold: number, proposalHash: string, lengthBound: number) {3224 await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.propose`, [threshold, proposalHash, lengthBound], true);3225 }32263227 async vote(signer: TSigner, proposalHash: string, proposalIndex: number, approve: boolean) {3228 await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.vote`, [proposalHash, proposalIndex, approve], true);3229 }32303231 async close(signer: TSigner, proposalHash: string, proposalIndex: number, weightBound: any, lengthBound: number) {3232 await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.close`, [proposalHash, proposalIndex, weightBound, lengthBound], true);3233 }32343235 async proposalCount() {3236 return Number(await this.helper.callRpc(`api.query.${this.collective}.proposalCount`, []));3237 }3238}32393240export type ChainHelperBaseConstructor = new (...args: any[]) => ChainHelperBase;3241export type UniqueHelperConstructor = new (...args: any[]) => UniqueHelper;32423243export class UniqueHelper extends ChainHelperBase {3244 balance: BalanceGroup<UniqueHelper>;3245 collection: CollectionGroup;3246 nft: NFTGroup;3247 rft: RFTGroup;3248 ft: FTGroup;3249 staking: StakingGroup;3250 scheduler: SchedulerGroup;3251 collatorSelection: CollatorSelectionGroup;3252 preimage: PreimageGroup;3253 foreignAssets: ForeignAssetsGroup;3254 xcm: XcmGroup<UniqueHelper>;3255 xTokens: XTokensGroup<UniqueHelper>;3256 tokens: TokensGroup<UniqueHelper>;32573258 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3259 super(logger, options.helperBase ?? UniqueHelper);32603261 this.balance = new BalanceGroup(this);3262 this.collection = new CollectionGroup(this);3263 this.nft = new NFTGroup(this);3264 this.rft = new RFTGroup(this);3265 this.ft = new FTGroup(this);3266 this.staking = new StakingGroup(this);3267 this.scheduler = new SchedulerGroup(this);3268 this.collatorSelection = new CollatorSelectionGroup(this);3269 this.preimage = new PreimageGroup(this);3270 this.foreignAssets = new ForeignAssetsGroup(this);3271 this.xcm = new XcmGroup(this, 'polkadotXcm');3272 this.xTokens = new XTokensGroup(this);3273 this.tokens = new TokensGroup(this);3274 }32753276 getSudo<T extends UniqueHelper>() {3277 // eslint-disable-next-line @typescript-eslint/naming-convention3278 const SudoHelperType = SudoHelper(this.helperBase);3279 return this.clone(SudoHelperType) as T;3280 }3281}32823283export class XcmChainHelper extends ChainHelperBase {3284 async connect(wsEndpoint: string, _listeners?: any): Promise<void> {3285 const wsProvider = new WsProvider(wsEndpoint);3286 this.api = new ApiPromise({3287 provider: wsProvider,3288 });3289 await this.api.isReadyOrError;3290 this.network = await UniqueHelper.detectNetwork(this.api);3291 }3292}32933294export class RelayHelper extends XcmChainHelper {3295 balance: SubstrateBalanceGroup<RelayHelper>;3296 xcm: XcmGroup<RelayHelper>;32973298 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3299 super(logger, options.helperBase ?? RelayHelper);33003301 this.balance = new SubstrateBalanceGroup(this);3302 this.xcm = new XcmGroup(this, 'xcmPallet');3303 }3304}33053306export class WestmintHelper extends XcmChainHelper {3307 balance: SubstrateBalanceGroup<WestmintHelper>;3308 xcm: XcmGroup<WestmintHelper>;3309 assets: AssetsGroup<WestmintHelper>;3310 xTokens: XTokensGroup<WestmintHelper>;33113312 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3313 super(logger, options.helperBase ?? WestmintHelper);33143315 this.balance = new SubstrateBalanceGroup(this);3316 this.xcm = new XcmGroup(this, 'polkadotXcm');3317 this.assets = new AssetsGroup(this);3318 this.xTokens = new XTokensGroup(this);3319 }3320}33213322export class MoonbeamHelper extends XcmChainHelper {3323 balance: EthereumBalanceGroup<MoonbeamHelper>;3324 assetManager: MoonbeamAssetManagerGroup;3325 assets: AssetsGroup<MoonbeamHelper>;3326 xTokens: XTokensGroup<MoonbeamHelper>;3327 democracy: MoonbeamDemocracyGroup;3328 collective: {3329 council: MoonbeamCollectiveGroup,3330 techCommittee: MoonbeamCollectiveGroup,3331 };33323333 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3334 super(logger, options.helperBase ?? MoonbeamHelper);33353336 this.balance = new EthereumBalanceGroup(this);3337 this.assetManager = new MoonbeamAssetManagerGroup(this);3338 this.assets = new AssetsGroup(this);3339 this.xTokens = new XTokensGroup(this);3340 this.democracy = new MoonbeamDemocracyGroup(this, options);3341 this.collective = {3342 council: new MoonbeamCollectiveGroup(this, 'councilCollective'),3343 techCommittee: new MoonbeamCollectiveGroup(this, 'techCommitteeCollective'),3344 };3345 }3346}33473348export class AstarHelper extends XcmChainHelper {3349 balance: SubstrateBalanceGroup<AstarHelper>;3350 assets: AssetsGroup<AstarHelper>;3351 xcm: XcmGroup<AstarHelper>;33523353 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3354 super(logger, options.helperBase ?? AstarHelper);33553356 this.balance = new SubstrateBalanceGroup(this);3357 this.assets = new AssetsGroup(this);3358 this.xcm = new XcmGroup(this, 'polkadotXcm');3359 }33603361 getSudo<T extends UniqueHelper>() {3362 // eslint-disable-next-line @typescript-eslint/naming-convention3363 const SudoHelperType = SudoHelper(this.helperBase);3364 return this.clone(SudoHelperType) as T;3365 }3366}33673368export class AcalaHelper extends XcmChainHelper {3369 balance: SubstrateBalanceGroup<AcalaHelper>;3370 assetRegistry: AcalaAssetRegistryGroup;3371 xTokens: XTokensGroup<AcalaHelper>;3372 tokens: TokensGroup<AcalaHelper>;3373 xcm: XcmGroup<AcalaHelper>;33743375 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3376 super(logger, options.helperBase ?? AcalaHelper);33773378 this.balance = new SubstrateBalanceGroup(this);3379 this.assetRegistry = new AcalaAssetRegistryGroup(this);3380 this.xTokens = new XTokensGroup(this);3381 this.tokens = new TokensGroup(this);3382 this.xcm = new XcmGroup(this, 'polkadotXcm');3383 }33843385 getSudo<T extends AcalaHelper>() {3386 // eslint-disable-next-line @typescript-eslint/naming-convention3387 const SudoHelperType = SudoHelper(this.helperBase);3388 return this.clone(SudoHelperType) as T;3389 }3390}33913392// eslint-disable-next-line @typescript-eslint/naming-convention3393function ScheduledUniqueHelper<T extends UniqueHelperConstructor>(Base: T) {3394 return class extends Base {3395 scheduleFn: 'schedule' | 'scheduleAfter';3396 blocksNum: number;3397 options: ISchedulerOptions;33983399 constructor(...args: any[]) {3400 const logger = args[0] as ILogger;3401 const options = args[1] as {3402 scheduleFn: 'schedule' | 'scheduleAfter',3403 blocksNum: number,3404 options: ISchedulerOptions3405 };34063407 super(logger);34083409 this.scheduleFn = options.scheduleFn;3410 this.blocksNum = options.blocksNum;3411 this.options = options.options;3412 }34133414 executeExtrinsic(sender: IKeyringPair, scheduledExtrinsic: string, scheduledParams: any[], expectSuccess?: boolean): Promise<ITransactionResult> {3415 const scheduledTx = this.constructApiCall(scheduledExtrinsic, scheduledParams);34163417 const mandatorySchedArgs = [3418 this.blocksNum,3419 this.options.periodic ? [this.options.periodic.period, this.options.periodic.repetitions] : null,3420 this.options.priority ?? null,3421 scheduledTx,3422 ];34233424 let schedArgs;3425 let scheduleFn;34263427 if (this.options.scheduledId) {3428 schedArgs = [this.options.scheduledId!, ...mandatorySchedArgs];34293430 if (this.scheduleFn == 'schedule') {3431 scheduleFn = 'scheduleNamed';3432 } else if (this.scheduleFn == 'scheduleAfter') {3433 scheduleFn = 'scheduleNamedAfter';3434 }3435 } else {3436 schedArgs = mandatorySchedArgs;3437 scheduleFn = this.scheduleFn;3438 }34393440 const extrinsic = 'api.tx.scheduler.' + scheduleFn;34413442 return super.executeExtrinsic(3443 sender,3444 extrinsic as any,3445 schedArgs,3446 expectSuccess,3447 );3448 }3449 };3450}34513452// eslint-disable-next-line @typescript-eslint/naming-convention3453function SudoHelper<T extends ChainHelperBaseConstructor>(Base: T) {3454 return class extends Base {3455 constructor(...args: any[]) {3456 super(...args);3457 }34583459 async executeExtrinsic(3460 sender: IKeyringPair,3461 extrinsic: string,3462 params: any[],3463 expectSuccess?: boolean,3464 options: Partial<SignerOptions> | null = null,3465 ): Promise<ITransactionResult> {3466 const call = this.constructApiCall(extrinsic, params);3467 const result = await super.executeExtrinsic(3468 sender,3469 'api.tx.sudo.sudo',3470 [call],3471 expectSuccess,3472 options,3473 );34743475 if (result.status === 'Fail') return result;34763477 const data = (result.result.events.find(x => x.event.section == 'sudo' && x.event.method == 'Sudid')?.event.data as any).sudoResult;3478 if (data.isErr) {3479 if (data.asErr.isModule) {3480 const error = (result.result.events[1].event.data as any).sudoResult.asErr.asModule;3481 const metaError = super.getApi()?.registry.findMetaError(error);3482 throw new Error(`${metaError.section}.${metaError.name}`);3483 } else if (data.asErr.isToken) {3484 throw new Error(`Token: ${data.asErr.asToken}`);3485 }3486 // May be [object Object] in case of unhandled non-unit enum3487 throw new Error(`Misc: ${data.asErr.toHuman()}`);3488 }3489 return result;3490 }3491 };3492}34933494export class UniqueBaseCollection {3495 helper: UniqueHelper;3496 collectionId: number;34973498 constructor(collectionId: number, uniqueHelper: UniqueHelper) {3499 this.collectionId = collectionId;3500 this.helper = uniqueHelper;3501 }35023503 async getData() {3504 return await this.helper.collection.getData(this.collectionId);3505 }35063507 async getLastTokenId() {3508 return await this.helper.collection.getLastTokenId(this.collectionId);3509 }35103511 async doesTokenExist(tokenId: number) {3512 return await this.helper.collection.doesTokenExist(this.collectionId, tokenId);3513 }35143515 async getAdmins() {3516 return await this.helper.collection.getAdmins(this.collectionId);3517 }35183519 async getAllowList() {3520 return await this.helper.collection.getAllowList(this.collectionId);3521 }35223523 async getEffectiveLimits() {3524 return await this.helper.collection.getEffectiveLimits(this.collectionId);3525 }35263527 async getProperties(propertyKeys?: string[] | null) {3528 return await this.helper.collection.getProperties(this.collectionId, propertyKeys);3529 }35303531 async getPropertiesConsumedSpace() {3532 return await this.helper.collection.getPropertiesConsumedSpace(this.collectionId);3533 }35343535 async getTokenNextSponsored(tokenId: number, addressObj: ICrossAccountId) {3536 return await this.helper.collection.getTokenNextSponsored(this.collectionId, tokenId, addressObj);3537 }35383539 async getOptions() {3540 return await this.helper.collection.getCollectionOptions(this.collectionId);3541 }35423543 async setSponsor(signer: TSigner, sponsorAddress: TSubstrateAccount) {3544 return await this.helper.collection.setSponsor(signer, this.collectionId, sponsorAddress);3545 }35463547 async confirmSponsorship(signer: TSigner) {3548 return await this.helper.collection.confirmSponsorship(signer, this.collectionId);3549 }35503551 async removeSponsor(signer: TSigner) {3552 return await this.helper.collection.removeSponsor(signer, this.collectionId);3553 }35543555 async setLimits(signer: TSigner, limits: ICollectionLimits) {3556 return await this.helper.collection.setLimits(signer, this.collectionId, limits);3557 }35583559 async changeOwner(signer: TSigner, ownerAddress: TSubstrateAccount) {3560 return await this.helper.collection.changeOwner(signer, this.collectionId, ownerAddress);3561 }35623563 async addAdmin(signer: TSigner, adminAddressObj: ICrossAccountId) {3564 return await this.helper.collection.addAdmin(signer, this.collectionId, adminAddressObj);3565 }35663567 async addToAllowList(signer: TSigner, addressObj: ICrossAccountId) {3568 return await this.helper.collection.addToAllowList(signer, this.collectionId, addressObj);3569 }35703571 async removeFromAllowList(signer: TSigner, addressObj: ICrossAccountId) {3572 return await this.helper.collection.removeFromAllowList(signer, this.collectionId, addressObj);3573 }35743575 async removeAdmin(signer: TSigner, adminAddressObj: ICrossAccountId) {3576 return await this.helper.collection.removeAdmin(signer, this.collectionId, adminAddressObj);3577 }35783579 async setProperties(signer: TSigner, properties: IProperty[]) {3580 return await this.helper.collection.setProperties(signer, this.collectionId, properties);3581 }35823583 async deleteProperties(signer: TSigner, propertyKeys: string[]) {3584 return await this.helper.collection.deleteProperties(signer, this.collectionId, propertyKeys);3585 }35863587 async setPermissions(signer: TSigner, permissions: ICollectionPermissions) {3588 return await this.helper.collection.setPermissions(signer, this.collectionId, permissions);3589 }35903591 async enableNesting(signer: TSigner, permissions: INestingPermissions) {3592 return await this.helper.collection.enableNesting(signer, this.collectionId, permissions);3593 }35943595 async disableNesting(signer: TSigner) {3596 return await this.helper.collection.disableNesting(signer, this.collectionId);3597 }35983599 async burn(signer: TSigner) {3600 return await this.helper.collection.burn(signer, this.collectionId);3601 }36023603 scheduleAt<T extends UniqueHelper>(3604 executionBlockNumber: number,3605 options: ISchedulerOptions = {},3606 ) {3607 const scheduledHelper = this.helper.scheduler.scheduleAt<T>(executionBlockNumber, options);3608 return new UniqueBaseCollection(this.collectionId, scheduledHelper);3609 }36103611 scheduleAfter<T extends UniqueHelper>(3612 blocksBeforeExecution: number,3613 options: ISchedulerOptions = {},3614 ) {3615 const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(blocksBeforeExecution, options);3616 return new UniqueBaseCollection(this.collectionId, scheduledHelper);3617 }36183619 getSudo<T extends UniqueHelper>() {3620 return new UniqueBaseCollection(this.collectionId, this.helper.getSudo<T>());3621 }3622}362336243625export class UniqueNFTCollection extends UniqueBaseCollection {3626 getTokenObject(tokenId: number) {3627 return new UniqueNFToken(tokenId, this);3628 }36293630 async getTokensByAddress(addressObj: ICrossAccountId) {3631 return await this.helper.nft.getTokensByAddress(this.collectionId, addressObj);3632 }36333634 async getToken(tokenId: number, blockHashAt?: string) {3635 return await this.helper.nft.getToken(this.collectionId, tokenId, [], blockHashAt);3636 }36373638 async getTokenOwner(tokenId: number, blockHashAt?: string) {3639 return await this.helper.nft.getTokenOwner(this.collectionId, tokenId, blockHashAt);3640 }36413642 async getTokenTopmostOwner(tokenId: number, blockHashAt?: string) {3643 return await this.helper.nft.getTokenTopmostOwner(this.collectionId, tokenId, blockHashAt);3644 }36453646 async getTokenChildren(tokenId: number, blockHashAt?: string) {3647 return await this.helper.nft.getTokenChildren(this.collectionId, tokenId, blockHashAt);3648 }36493650 async getPropertyPermissions(propertyKeys: string[] | null = null) {3651 return await this.helper.nft.getPropertyPermissions(this.collectionId, propertyKeys);3652 }36533654 async getTokenProperties(tokenId: number, propertyKeys?: string[] | null) {3655 return await this.helper.nft.getTokenProperties(this.collectionId, tokenId, propertyKeys);3656 }36573658 async getTokenPropertiesConsumedSpace(tokenId: number): Promise<number> {3659 const api = this.helper.getApi();3660 const props = (await api.query.nonfungible.tokenProperties(this.collectionId, tokenId)).toJSON();36613662 return (props! as any).consumedSpace;3663 }36643665 async transferToken(signer: TSigner, tokenId: number, addressObj: ICrossAccountId) {3666 return await this.helper.nft.transferToken(signer, this.collectionId, tokenId, addressObj);3667 }36683669 async transferTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3670 return await this.helper.nft.transferTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, toAddressObj);3671 }36723673 async approveToken(signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId) {3674 return await this.helper.nft.approveToken(signer, this.collectionId, tokenId, toAddressObj);3675 }36763677 async isTokenApproved(tokenId: number, toAddressObj: ICrossAccountId) {3678 return await this.helper.nft.isTokenApproved(this.collectionId, tokenId, toAddressObj);3679 }36803681 async mintToken(signer: TSigner, owner: ICrossAccountId = {Substrate: signer.address}, properties?: IProperty[]) {3682 return await this.helper.nft.mintToken(signer, {collectionId: this.collectionId, owner, properties});3683 }36843685 async mintMultipleTokens(signer: TSigner, tokens: { owner: ICrossAccountId, properties?: IProperty[] }[]) {3686 return await this.helper.nft.mintMultipleTokens(signer, this.collectionId, tokens);3687 }36883689 async burnToken(signer: TSigner, tokenId: number) {3690 return await this.helper.nft.burnToken(signer, this.collectionId, tokenId);3691 }36923693 async burnTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId) {3694 return await this.helper.nft.burnTokenFrom(signer, this.collectionId, tokenId, fromAddressObj);3695 }36963697 async setTokenProperties(signer: TSigner, tokenId: number, properties: IProperty[]) {3698 return await this.helper.nft.setTokenProperties(signer, this.collectionId, tokenId, properties);3699 }37003701 async deleteTokenProperties(signer: TSigner, tokenId: number, propertyKeys: string[]) {3702 return await this.helper.nft.deleteTokenProperties(signer, this.collectionId, tokenId, propertyKeys);3703 }37043705 async setTokenPropertyPermissions(signer: TSigner, permissions: ITokenPropertyPermission[]) {3706 return await this.helper.nft.setTokenPropertyPermissions(signer, this.collectionId, permissions);3707 }37083709 async nestToken(signer: TSigner, tokenId: number, toTokenObj: IToken) {3710 return await this.helper.nft.nestToken(signer, {collectionId: this.collectionId, tokenId}, toTokenObj);3711 }37123713 async unnestToken(signer: TSigner, tokenId: number, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {3714 return await this.helper.nft.unnestToken(signer, {collectionId: this.collectionId, tokenId}, fromTokenObj, toAddressObj);3715 }37163717 scheduleAt<T extends UniqueHelper>(3718 executionBlockNumber: number,3719 options: ISchedulerOptions = {},3720 ) {3721 const scheduledHelper = this.helper.scheduler.scheduleAt<T>(executionBlockNumber, options);3722 return new UniqueNFTCollection(this.collectionId, scheduledHelper);3723 }37243725 scheduleAfter<T extends UniqueHelper>(3726 blocksBeforeExecution: number,3727 options: ISchedulerOptions = {},3728 ) {3729 const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(blocksBeforeExecution, options);3730 return new UniqueNFTCollection(this.collectionId, scheduledHelper);3731 }37323733 getSudo<T extends UniqueHelper>() {3734 return new UniqueNFTCollection(this.collectionId, this.helper.getSudo<T>());3735 }3736}373737383739export class UniqueRFTCollection extends UniqueBaseCollection {3740 getTokenObject(tokenId: number) {3741 return new UniqueRFToken(tokenId, this);3742 }37433744 async getToken(tokenId: number, blockHashAt?: string) {3745 return await this.helper.rft.getToken(this.collectionId, tokenId, [], blockHashAt);3746 }37473748 async getTokenOwner(tokenId: number, blockHashAt?: string) {3749 return await this.helper.rft.getTokenOwner(this.collectionId, tokenId, blockHashAt);3750 }37513752 async getTokensByAddress(addressObj: ICrossAccountId) {3753 return await this.helper.rft.getTokensByAddress(this.collectionId, addressObj);3754 }37553756 async getTop10TokenOwners(tokenId: number) {3757 return await this.helper.rft.getTokenTop10Owners(this.collectionId, tokenId);3758 }37593760 async getTokenTopmostOwner(tokenId: number, blockHashAt?: string) {3761 return await this.helper.rft.getTokenTopmostOwner(this.collectionId, tokenId, blockHashAt);3762 }37633764 async getTokenBalance(tokenId: number, addressObj: ICrossAccountId) {3765 return await this.helper.rft.getTokenBalance(this.collectionId, tokenId, addressObj);3766 }37673768 async getTokenTotalPieces(tokenId: number) {3769 return await this.helper.rft.getTokenTotalPieces(this.collectionId, tokenId);3770 }37713772 async getTokenApprovedPieces(tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3773 return await this.helper.rft.getTokenApprovedPieces(this.collectionId, tokenId, toAddressObj, fromAddressObj);3774 }37753776 async getPropertyPermissions(propertyKeys: string[] | null = null) {3777 return await this.helper.rft.getPropertyPermissions(this.collectionId, propertyKeys);3778 }37793780 async getTokenProperties(tokenId: number, propertyKeys?: string[] | null) {3781 return await this.helper.rft.getTokenProperties(this.collectionId, tokenId, propertyKeys);3782 }37833784 async getTokenPropertiesConsumedSpace(tokenId: number): Promise<number> {3785 const api = this.helper.getApi();3786 const props = (await api.query.refungible.tokenProperties(this.collectionId, tokenId)).toJSON();37873788 return (props! as any).consumedSpace;3789 }37903791 async transferToken(signer: TSigner, tokenId: number, addressObj: ICrossAccountId, amount = 1n) {3792 return await this.helper.rft.transferToken(signer, this.collectionId, tokenId, addressObj, amount);3793 }37943795 async transferTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {3796 return await this.helper.rft.transferTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, toAddressObj, amount);3797 }37983799 async approveToken(signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId, amount = 1n) {3800 return await this.helper.rft.approveToken(signer, this.collectionId, tokenId, toAddressObj, amount);3801 }38023803 async repartitionToken(signer: TSigner, tokenId: number, amount: bigint) {3804 return await this.helper.rft.repartitionToken(signer, this.collectionId, tokenId, amount);3805 }38063807 async mintToken(signer: TSigner, pieces = 1n, owner: ICrossAccountId = {Substrate: signer.address}, properties?: IProperty[]) {3808 return await this.helper.rft.mintToken(signer, {collectionId: this.collectionId, owner, pieces, properties});3809 }38103811 async mintMultipleTokens(signer: TSigner, tokens: { pieces: bigint, owner: ICrossAccountId, properties?: IProperty[] }[]) {3812 return await this.helper.rft.mintMultipleTokens(signer, this.collectionId, tokens);3813 }38143815 async burnToken(signer: TSigner, tokenId: number, amount = 1n) {3816 return await this.helper.rft.burnToken(signer, this.collectionId, tokenId, amount);3817 }38183819 async burnTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, amount = 1n) {3820 return await this.helper.rft.burnTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, amount);3821 }38223823 async setTokenProperties(signer: TSigner, tokenId: number, properties: IProperty[]) {3824 return await this.helper.rft.setTokenProperties(signer, this.collectionId, tokenId, properties);3825 }38263827 async deleteTokenProperties(signer: TSigner, tokenId: number, propertyKeys: string[]) {3828 return await this.helper.rft.deleteTokenProperties(signer, this.collectionId, tokenId, propertyKeys);3829 }38303831 async setTokenPropertyPermissions(signer: TSigner, permissions: ITokenPropertyPermission[]) {3832 return await this.helper.rft.setTokenPropertyPermissions(signer, this.collectionId, permissions);3833 }38343835 async nestToken(signer: TSigner, tokenId: number, toTokenObj: IToken) {3836 return await this.helper.rft.nestToken(signer, {collectionId: this.collectionId, tokenId}, toTokenObj);3837 }38383839 async unnestToken(signer: TSigner, tokenId: number, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {3840 return await this.helper.rft.unnestToken(signer, {collectionId: this.collectionId, tokenId}, fromTokenObj, toAddressObj);3841 }38423843 scheduleAt<T extends UniqueHelper>(3844 executionBlockNumber: number,3845 options: ISchedulerOptions = {},3846 ) {3847 const scheduledHelper = this.helper.scheduler.scheduleAt<T>(executionBlockNumber, options);3848 return new UniqueRFTCollection(this.collectionId, scheduledHelper);3849 }38503851 scheduleAfter<T extends UniqueHelper>(3852 blocksBeforeExecution: number,3853 options: ISchedulerOptions = {},3854 ) {3855 const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(blocksBeforeExecution, options);3856 return new UniqueRFTCollection(this.collectionId, scheduledHelper);3857 }38583859 getSudo<T extends UniqueHelper>() {3860 return new UniqueRFTCollection(this.collectionId, this.helper.getSudo<T>());3861 }3862}386338643865export class UniqueFTCollection extends UniqueBaseCollection {3866 async getBalance(addressObj: ICrossAccountId) {3867 return await this.helper.ft.getBalance(this.collectionId, addressObj);3868 }38693870 async getTotalPieces() {3871 return await this.helper.ft.getTotalPieces(this.collectionId);3872 }38733874 async getApprovedTokens(fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3875 return await this.helper.ft.getApprovedTokens(this.collectionId, fromAddressObj, toAddressObj);3876 }38773878 async getTop10Owners() {3879 return await this.helper.ft.getTop10Owners(this.collectionId);3880 }38813882 async mint(signer: TSigner, amount = 1n, owner: ICrossAccountId = {Substrate: signer.address}) {3883 return await this.helper.ft.mintTokens(signer, this.collectionId, amount, owner);3884 }38853886 async mintWithOneOwner(signer: TSigner, tokens: { value: bigint }[], owner: ICrossAccountId = {Substrate: signer.address}) {3887 return await this.helper.ft.mintMultipleTokensWithOneOwner(signer, this.collectionId, tokens, owner);3888 }38893890 async transfer(signer: TSigner, toAddressObj: ICrossAccountId, amount = 1n) {3891 return await this.helper.ft.transfer(signer, this.collectionId, toAddressObj, amount);3892 }38933894 async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {3895 return await this.helper.ft.transferFrom(signer, this.collectionId, fromAddressObj, toAddressObj, amount);3896 }38973898 async burnTokens(signer: TSigner, amount = 1n) {3899 return await this.helper.ft.burnTokens(signer, this.collectionId, amount);3900 }39013902 async burnTokensFrom(signer: TSigner, fromAddressObj: ICrossAccountId, amount = 1n) {3903 return await this.helper.ft.burnTokensFrom(signer, this.collectionId, fromAddressObj, amount);3904 }39053906 async approveTokens(signer: TSigner, toAddressObj: ICrossAccountId, amount = 1n) {3907 return await this.helper.ft.approveTokens(signer, this.collectionId, toAddressObj, amount);3908 }39093910 scheduleAt<T extends UniqueHelper>(3911 executionBlockNumber: number,3912 options: ISchedulerOptions = {},3913 ) {3914 const scheduledHelper = this.helper.scheduler.scheduleAt<T>(executionBlockNumber, options);3915 return new UniqueFTCollection(this.collectionId, scheduledHelper);3916 }39173918 scheduleAfter<T extends UniqueHelper>(3919 blocksBeforeExecution: number,3920 options: ISchedulerOptions = {},3921 ) {3922 const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(blocksBeforeExecution, options);3923 return new UniqueFTCollection(this.collectionId, scheduledHelper);3924 }39253926 getSudo<T extends UniqueHelper>() {3927 return new UniqueFTCollection(this.collectionId, this.helper.getSudo<T>());3928 }3929}393039313932export class UniqueBaseToken {3933 collection: UniqueNFTCollection | UniqueRFTCollection;3934 collectionId: number;3935 tokenId: number;39363937 constructor(tokenId: number, collection: UniqueNFTCollection | UniqueRFTCollection) {3938 this.collection = collection;3939 this.collectionId = collection.collectionId;3940 this.tokenId = tokenId;3941 }39423943 async getNextSponsored(addressObj: ICrossAccountId) {3944 return await this.collection.getTokenNextSponsored(this.tokenId, addressObj);3945 }39463947 async getProperties(propertyKeys?: string[] | null) {3948 return await this.collection.getTokenProperties(this.tokenId, propertyKeys);3949 }39503951 async getTokenPropertiesConsumedSpace() {3952 return await this.collection.getTokenPropertiesConsumedSpace(this.tokenId);3953 }39543955 async setProperties(signer: TSigner, properties: IProperty[]) {3956 return await this.collection.setTokenProperties(signer, this.tokenId, properties);3957 }39583959 async deleteProperties(signer: TSigner, propertyKeys: string[]) {3960 return await this.collection.deleteTokenProperties(signer, this.tokenId, propertyKeys);3961 }39623963 async doesExist() {3964 return await this.collection.doesTokenExist(this.tokenId);3965 }39663967 nestingAccount() {3968 return this.collection.helper.util.getTokenAccount(this);3969 }39703971 scheduleAt<T extends UniqueHelper>(3972 executionBlockNumber: number,3973 options: ISchedulerOptions = {},3974 ) {3975 const scheduledCollection = this.collection.scheduleAt<T>(executionBlockNumber, options);3976 return new UniqueBaseToken(this.tokenId, scheduledCollection);3977 }39783979 scheduleAfter<T extends UniqueHelper>(3980 blocksBeforeExecution: number,3981 options: ISchedulerOptions = {},3982 ) {3983 const scheduledCollection = this.collection.scheduleAfter<T>(blocksBeforeExecution, options);3984 return new UniqueBaseToken(this.tokenId, scheduledCollection);3985 }39863987 getSudo<T extends UniqueHelper>() {3988 return new UniqueBaseToken(this.tokenId, this.collection.getSudo<T>());3989 }3990}399139923993export class UniqueNFToken extends UniqueBaseToken {3994 collection: UniqueNFTCollection;39953996 constructor(tokenId: number, collection: UniqueNFTCollection) {3997 super(tokenId, collection);3998 this.collection = collection;3999 }40004001 async getData(blockHashAt?: string) {4002 return await this.collection.getToken(this.tokenId, blockHashAt);4003 }40044005 async getOwner(blockHashAt?: string) {4006 return await this.collection.getTokenOwner(this.tokenId, blockHashAt);4007 }40084009 async getTopmostOwner(blockHashAt?: string) {4010 return await this.collection.getTokenTopmostOwner(this.tokenId, blockHashAt);4011 }40124013 async getChildren(blockHashAt?: string) {4014 return await this.collection.getTokenChildren(this.tokenId, blockHashAt);4015 }40164017 async nest(signer: TSigner, toTokenObj: IToken) {4018 return await this.collection.nestToken(signer, this.tokenId, toTokenObj);4019 }40204021 async unnest(signer: TSigner, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {4022 return await this.collection.unnestToken(signer, this.tokenId, fromTokenObj, toAddressObj);4023 }40244025 async transfer(signer: TSigner, addressObj: ICrossAccountId) {4026 return await this.collection.transferToken(signer, this.tokenId, addressObj);4027 }40284029 async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {4030 return await this.collection.transferTokenFrom(signer, this.tokenId, fromAddressObj, toAddressObj);4031 }40324033 async approve(signer: TSigner, toAddressObj: ICrossAccountId) {4034 return await this.collection.approveToken(signer, this.tokenId, toAddressObj);4035 }40364037 async isApproved(toAddressObj: ICrossAccountId) {4038 return await this.collection.isTokenApproved(this.tokenId, toAddressObj);4039 }40404041 async burn(signer: TSigner) {4042 return await this.collection.burnToken(signer, this.tokenId);4043 }40444045 async burnFrom(signer: TSigner, fromAddressObj: ICrossAccountId) {4046 return await this.collection.burnTokenFrom(signer, this.tokenId, fromAddressObj);4047 }40484049 scheduleAt<T extends UniqueHelper>(4050 executionBlockNumber: number,4051 options: ISchedulerOptions = {},4052 ) {4053 const scheduledCollection = this.collection.scheduleAt<T>(executionBlockNumber, options);4054 return new UniqueNFToken(this.tokenId, scheduledCollection);4055 }40564057 scheduleAfter<T extends UniqueHelper>(4058 blocksBeforeExecution: number,4059 options: ISchedulerOptions = {},4060 ) {4061 const scheduledCollection = this.collection.scheduleAfter<T>(blocksBeforeExecution, options);4062 return new UniqueNFToken(this.tokenId, scheduledCollection);4063 }40644065 getSudo<T extends UniqueHelper>() {4066 return new UniqueNFToken(this.tokenId, this.collection.getSudo<T>());4067 }4068}40694070export class UniqueRFToken extends UniqueBaseToken {4071 collection: UniqueRFTCollection;40724073 constructor(tokenId: number, collection: UniqueRFTCollection) {4074 super(tokenId, collection);4075 this.collection = collection;4076 }40774078 async getData(blockHashAt?: string) {4079 return await this.collection.getToken(this.tokenId, blockHashAt);4080 }40814082 async getOwner(blockHashAt?: string) {4083 return await this.collection.getTokenOwner(this.tokenId, blockHashAt);4084 }40854086 async getTop10Owners() {4087 return await this.collection.getTop10TokenOwners(this.tokenId);4088 }40894090 async getTopmostOwner(blockHashAt?: string) {4091 return await this.collection.getTokenTopmostOwner(this.tokenId, blockHashAt);4092 }40934094 async nest(signer: TSigner, toTokenObj: IToken) {4095 return await this.collection.nestToken(signer, this.tokenId, toTokenObj);4096 }40974098 async unnest(signer: TSigner, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {4099 return await this.collection.unnestToken(signer, this.tokenId, fromTokenObj, toAddressObj);4100 }41014102 async getBalance(addressObj: ICrossAccountId) {4103 return await this.collection.getTokenBalance(this.tokenId, addressObj);4104 }41054106 async getTotalPieces() {4107 return await this.collection.getTokenTotalPieces(this.tokenId);4108 }41094110 async getApprovedPieces(fromAddressObj: ICrossAccountId, toAccountObj: ICrossAccountId) {4111 return await this.collection.getTokenApprovedPieces(this.tokenId, fromAddressObj, toAccountObj);4112 }41134114 async transfer(signer: TSigner, addressObj: ICrossAccountId, amount = 1n) {4115 return await this.collection.transferToken(signer, this.tokenId, addressObj, amount);4116 }41174118 async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {4119 return await this.collection.transferTokenFrom(signer, this.tokenId, fromAddressObj, toAddressObj, amount);4120 }41214122 async approve(signer: TSigner, toAddressObj: ICrossAccountId, amount = 1n) {4123 return await this.collection.approveToken(signer, this.tokenId, toAddressObj, amount);4124 }41254126 async repartition(signer: TSigner, amount: bigint) {4127 return await this.collection.repartitionToken(signer, this.tokenId, amount);4128 }41294130 async burn(signer: TSigner, amount = 1n) {4131 return await this.collection.burnToken(signer, this.tokenId, amount);4132 }41334134 async burnFrom(signer: TSigner, fromAddressObj: ICrossAccountId, amount = 1n) {4135 return await this.collection.burnTokenFrom(signer, this.tokenId, fromAddressObj, amount);4136 }41374138 scheduleAt<T extends UniqueHelper>(4139 executionBlockNumber: number,4140 options: ISchedulerOptions = {},4141 ) {4142 const scheduledCollection = this.collection.scheduleAt<T>(executionBlockNumber, options);4143 return new UniqueRFToken(this.tokenId, scheduledCollection);4144 }41454146 scheduleAfter<T extends UniqueHelper>(4147 blocksBeforeExecution: number,4148 options: ISchedulerOptions = {},4149 ) {4150 const scheduledCollection = this.collection.scheduleAfter<T>(blocksBeforeExecution, options);4151 return new UniqueRFToken(this.tokenId, scheduledCollection);4152 }41534154 getSudo<T extends UniqueHelper>() {4155 return new UniqueRFToken(this.tokenId, this.collection.getSudo<T>());4156 }4157}1// Copyright 2019-2022 Unique Network (Gibraltar) Ltd.2// SPDX-License-Identifier: Apache-2.034/* eslint-disable @typescript-eslint/no-var-requires */5/* eslint-disable function-call-argument-newline */6/* eslint-disable no-prototype-builtins */78import {ApiPromise, WsProvider, Keyring} from '@polkadot/api';9import {SignerOptions} from '@polkadot/api/types/submittable';10import '../../interfaces/augment-api';11import {AugmentedSubmittables} from '@polkadot/api-base/types/submittable';12import {ApiInterfaceEvents} from '@polkadot/api/types';13import {encodeAddress, decodeAddress, keccakAsHex, evmToAddress, addressToEvm, base58Encode, blake2AsU8a} from '@polkadot/util-crypto';14import {IKeyringPair} from '@polkadot/types/types';15import {hexToU8a} from '@polkadot/util/hex';16import {u8aConcat} from '@polkadot/util/u8a';17import {18 IApiListeners,19 IBlock,20 IEvent,21 IChainProperties,22 ICollectionCreationOptions,23 ICollectionLimits,24 ICollectionPermissions,25 ICrossAccountId,26 ICrossAccountIdLower,27 ILogger,28 INestingPermissions,29 IProperty,30 IStakingInfo,31 ISchedulerOptions,32 ISubstrateBalance,33 IToken,34 ITokenPropertyPermission,35 ITransactionResult,36 IUniqueHelperLog,37 TApiAllowedListeners,38 TEthereumAccount,39 TSigner,40 TSubstrateAccount,41 TNetworks,42 IForeignAssetMetadata,43 AcalaAssetMetadata,44 MoonbeamAssetInfo,45 DemocracyStandardAccountVote,46 IEthCrossAccountId,47} from './types';48import {RuntimeDispatchInfo} from '@polkadot/types/interfaces';49import type {Vec} from '@polkadot/types-codec';50import {FrameSystemEventRecord, PalletBalancesIdAmount} from '@polkadot/types/lookup';5152export class CrossAccountId {53 Substrate!: TSubstrateAccount;54 Ethereum!: TEthereumAccount;5556 constructor(account: ICrossAccountId) {57 if('Substrate' in account) this.Substrate = account.Substrate;58 else this.Ethereum = account.Ethereum;59 }6061 static fromKeyring(account: IKeyringPair, domain: 'Substrate' | 'Ethereum' = 'Substrate') {62 switch (domain) {63 case 'Substrate': return new CrossAccountId({Substrate: account.address});64 case 'Ethereum': return new CrossAccountId({Substrate: account.address}).toEthereum();65 }66 }6768 static fromLowerCaseKeys(address: ICrossAccountIdLower): CrossAccountId {69 if('substrate' in address) return new CrossAccountId({Substrate: address.substrate});70 else return new CrossAccountId({Ethereum: address.ethereum});71 }7273 static normalizeSubstrateAddress(address: TSubstrateAccount, ss58Format = 42): TSubstrateAccount {74 return encodeAddress(decodeAddress(address), ss58Format);75 }7677 static withNormalizedSubstrate(address: TSubstrateAccount, ss58Format = 42): CrossAccountId {78 return new CrossAccountId({Substrate: CrossAccountId.normalizeSubstrateAddress(address, ss58Format)});79 }8081 withNormalizedSubstrate(ss58Format = 42): CrossAccountId {82 if(this.Substrate) return CrossAccountId.withNormalizedSubstrate(this.Substrate, ss58Format);83 return this;84 }8586 static translateSubToEth(address: TSubstrateAccount): TEthereumAccount {87 return nesting.toChecksumAddress('0x' + Array.from(addressToEvm(address), i => i.toString(16).padStart(2, '0')).join(''));88 }8990 toEthereum(): CrossAccountId {91 if(this.Substrate) return new CrossAccountId({Ethereum: CrossAccountId.translateSubToEth(this.Substrate)});92 return this;93 }9495 static translateEthToSub(address: TEthereumAccount, ss58Format?: number): TSubstrateAccount {96 return evmToAddress(address, ss58Format);97 }9899 toSubstrate(ss58Format?: number): CrossAccountId {100 if(this.Ethereum) return new CrossAccountId({Substrate: CrossAccountId.translateEthToSub(this.Ethereum, ss58Format)});101 return this;102 }103104 toLowerCase(): CrossAccountId {105 if(this.Substrate) this.Substrate = this.Substrate.toLowerCase();106 if(this.Ethereum) this.Ethereum = this.Ethereum.toLowerCase();107 return this;108 }109}110111const nesting = {112 toChecksumAddress(address: string): string {113 if(typeof address === 'undefined') return '';114115 if(!/^(0x)?[0-9a-f]{40}$/i.test(address)) throw new Error(`Given address "${address}" is not a valid Ethereum address.`);116117 address = address.toLowerCase().replace(/^0x/i, '');118 const addressHash = keccakAsHex(address).replace(/^0x/i, '');119 const checksumAddress = ['0x'];120121 for(let i = 0; i < address.length; i++) {122 // If ith character is 8 to f then make it uppercase123 if(parseInt(addressHash[i], 16) > 7) {124 checksumAddress.push(address[i].toUpperCase());125 } else {126 checksumAddress.push(address[i]);127 }128 }129 return checksumAddress.join('');130 },131 tokenIdToAddress(collectionId: number, tokenId: number) {132 return this.toChecksumAddress(`0xf8238ccfff8ed887463fd5e0${collectionId.toString(16).padStart(8,'0')}${tokenId.toString(16).padStart(8,'0')}`);133 },134};135136class UniqueUtil {137 static transactionStatus = {138 NOT_READY: 'NotReady',139 FAIL: 'Fail',140 SUCCESS: 'Success',141 };142143 static chainLogType = {144 EXTRINSIC: 'extrinsic',145 RPC: 'rpc',146 };147148 static getTokenAccount(token: IToken): CrossAccountId {149 return new CrossAccountId({Ethereum: this.getTokenAddress(token)});150 }151152 static getTokenAddress(token: IToken): string {153 return nesting.tokenIdToAddress(token.collectionId, token.tokenId);154 }155156 static getDefaultLogger(): ILogger {157 return {158 log(msg: any, level = 'INFO') {159 console[level.toLocaleLowerCase() === 'error' ? 'error' : 'log'](...(Array.isArray(msg) ? msg : [msg]));160 },161 level: {162 ERROR: 'ERROR',163 WARNING: 'WARNING',164 INFO: 'INFO',165 },166 };167 }168169 static vec2str(arr: string[] | number[]) {170 return arr.map(x => String.fromCharCode(parseInt(x.toString()))).join('');171 }172173 static str2vec(string: string) {174 if(typeof string !== 'string') return string;175 return Array.from(string).map(x => x.charCodeAt(0));176 }177178 static fromSeed(seed: string, ss58Format = 42) {179 const keyring = new Keyring({type: 'sr25519', ss58Format});180 return keyring.addFromUri(seed);181 }182183 static extractCollectionIdFromCreationResult(creationResult: ITransactionResult): number {184 if(creationResult.status !== this.transactionStatus.SUCCESS) {185 throw Error('Unable to create collection!');186 }187188 let collectionId = null;189 creationResult.result.events.forEach(({event: {data, method, section}}) => {190 if((section === 'common') && (method === 'CollectionCreated')) {191 collectionId = parseInt(data[0].toString(), 10);192 }193 });194195 if(collectionId === null) {196 throw Error('No CollectionCreated event was found!');197 }198199 return collectionId;200 }201202 static extractTokensFromCreationResult(creationResult: ITransactionResult): {203 success: boolean,204 tokens: { collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint }[],205 } {206 if(creationResult.status !== this.transactionStatus.SUCCESS) {207 throw Error('Unable to create tokens!');208 }209 let success = false;210 const tokens = [] as { collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint }[];211 creationResult.result.events.forEach(({event: {data, method, section}}) => {212 if(method === 'ExtrinsicSuccess') {213 success = true;214 } else if((section === 'common') && (method === 'ItemCreated')) {215 tokens.push({216 collectionId: parseInt(data[0].toString(), 10),217 tokenId: parseInt(data[1].toString(), 10),218 owner: data[2].toHuman(),219 amount: data[3].toBigInt(),220 });221 }222 });223 return {success, tokens};224 }225226 static extractTokensFromBurnResult(burnResult: ITransactionResult): {227 success: boolean,228 tokens: { collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint }[],229 } {230 if(burnResult.status !== this.transactionStatus.SUCCESS) {231 throw Error('Unable to burn tokens!');232 }233 let success = false;234 const tokens = [] as { collectionId: number, tokenId: number, owner: CrossAccountId, amount: bigint }[];235 burnResult.result.events.forEach(({event: {data, method, section}}) => {236 if(method === 'ExtrinsicSuccess') {237 success = true;238 } else if((section === 'common') && (method === 'ItemDestroyed')) {239 tokens.push({240 collectionId: parseInt(data[0].toString(), 10),241 tokenId: parseInt(data[1].toString(), 10),242 owner: data[2].toHuman(),243 amount: data[3].toBigInt(),244 });245 }246 });247 return {success, tokens};248 }249250 static findCollectionInEvents(events: { event: IEvent }[], collectionId: number, expectedSection: string, expectedMethod: string): boolean {251 let eventId = null;252 events.forEach(({event: {data, method, section}}) => {253 if((section === expectedSection) && (method === expectedMethod)) {254 eventId = parseInt(data[0].toString(), 10);255 }256 });257258 if(eventId === null) {259 throw Error(`No ${expectedMethod} event was found!`);260 }261 return eventId === collectionId;262 }263264 static isTokenTransferSuccess(events: { event: IEvent }[], collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {265 const normalizeAddress = (address: string | ICrossAccountId) => {266 if(typeof address === 'string') return address;267 const obj = {} as any;268 Object.keys(address).forEach(k => {269 obj[k.toLocaleLowerCase()] = (address as any)[k];270 });271 if(obj.substrate) return CrossAccountId.withNormalizedSubstrate(obj.substrate);272 if(obj.ethereum) return CrossAccountId.fromLowerCaseKeys(obj).toLowerCase();273 return address;274 };275 let transfer = {collectionId: null, tokenId: null, from: null, to: null, amount: 1} as any;276 events.forEach(({event: {data, method, section}}) => {277 if((section === 'common') && (method === 'Transfer')) {278 const hData = (data as any).toJSON();279 transfer = {280 collectionId: hData[0],281 tokenId: hData[1],282 from: normalizeAddress(hData[2]),283 to: normalizeAddress(hData[3]),284 amount: BigInt(hData[4]),285 };286 }287 });288 let isSuccess = parseInt(collectionId.toString()) === transfer.collectionId && parseInt(tokenId.toString()) === transfer.tokenId;289 isSuccess = isSuccess && JSON.stringify(normalizeAddress(fromAddressObj)) === JSON.stringify(transfer.from);290 isSuccess = isSuccess && JSON.stringify(normalizeAddress(toAddressObj)) === JSON.stringify(transfer.to);291 isSuccess = isSuccess && amount === transfer.amount;292 return isSuccess;293 }294295 static bigIntToDecimals(number: bigint, decimals = 18) {296 const numberStr = number.toString();297 const dotPos = numberStr.length - decimals;298299 if(dotPos <= 0) {300 return '0.' + '0'.repeat(Math.abs(dotPos)) + numberStr;301 } else {302 const intPart = numberStr.substring(0, dotPos);303 const fractPart = numberStr.substring(dotPos);304 return intPart + '.' + fractPart;305 }306 }307}308309class UniqueEventHelper {310 private static extractIndex(index: any): [number, number] | string {311 if(index.toRawType() === '[u8;2]') return [index[0], index[1]];312 return index.toJSON();313 }314315 private static extractSub(data: any, subTypes: any): { [key: string]: any } {316 let obj: any = {};317 let index = 0;318319 if(data.entries) {320 for(const [key, value] of data.entries()) {321 obj[key] = this.extractData(value, subTypes[index]);322 index++;323 }324 } else obj = data.toJSON();325326 return obj;327 }328329 private static toHuman(data: any) {330 return data && data.toHuman ? data.toHuman() : `${data}`;331 }332333 private static extractData(data: any, type: any): any {334 if(!type) return this.toHuman(data);335 if(['u16', 'u32'].indexOf(type.type) > -1) return data.toNumber();336 if(['u64', 'u128', 'u256'].indexOf(type.type) > -1) return data.toBigInt();337 if(type.hasOwnProperty('sub')) return this.extractSub(data, type.sub);338 return this.toHuman(data);339 }340341 public static extractEvents(events: { event: any, phase: any }[]): IEvent[] {342 const parsedEvents: IEvent[] = [];343344 events.forEach((record) => {345 const {event, phase} = record;346 const types = event.typeDef;347348 const eventData: IEvent = {349 section: event.section.toString(),350 method: event.method.toString(),351 index: this.extractIndex(event.index),352 data: [],353 phase: phase.toJSON(),354 };355356 event.data.forEach((val: any, index: number) => {357 eventData.data.push(this.extractData(val, types[index]));358 });359360 parsedEvents.push(eventData);361 });362363 return parsedEvents;364 }365}366const InvalidTypeSymbol = Symbol('Invalid type');367// eslint-disable-next-line @typescript-eslint/no-unused-vars368export type Invalid<ErrorMessage> =369 | ((370 invalidType: typeof InvalidTypeSymbol,371 ..._: typeof InvalidTypeSymbol[]372 ) => typeof InvalidTypeSymbol)373 | null374 | undefined;375// Has slightly better error messages than Get376type Get2<T, P extends string, E> =377 P extends `${infer Key}.${infer Key2}` ? Key extends keyof T ? Key2 extends keyof T[Key] ? T[Key][Key2] : E : E : E;378type ForceFunction<T> = T extends (...args: any) => any ? T : (...args: any) => Invalid<'not a function'>;379380export class ChainHelperBase {381 helperBase: any;382383 transactionStatus = UniqueUtil.transactionStatus;384 chainLogType = UniqueUtil.chainLogType;385 util: typeof UniqueUtil;386 eventHelper: typeof UniqueEventHelper;387 logger: ILogger;388 api: ApiPromise | null;389 forcedNetwork: TNetworks | null;390 network: TNetworks | null;391 wsEndpoint: string | null;392 chainLog: IUniqueHelperLog[];393 children: ChainHelperBase[];394 address: AddressGroup;395 chain: ChainGroup;396397 constructor(logger?: ILogger, helperBase?: any) {398 this.helperBase = helperBase;399400 this.util = UniqueUtil;401 this.eventHelper = UniqueEventHelper;402 if(typeof logger == 'undefined') logger = this.util.getDefaultLogger();403 this.logger = logger;404 this.api = null;405 this.forcedNetwork = null;406 this.network = null;407 this.wsEndpoint = null;408 this.chainLog = [];409 this.children = [];410 this.address = new AddressGroup(this);411 this.chain = new ChainGroup(this);412 }413414 clone(helperCls: ChainHelperBaseConstructor, options: { [key: string]: any } = {}) {415 Object.setPrototypeOf(helperCls.prototype, this);416 const newHelper = new helperCls(this.logger, options);417418 newHelper.api = this.api;419 newHelper.network = this.network;420 newHelper.forceNetwork = this.forceNetwork;421422 this.children.push(newHelper);423424 return newHelper;425 }426427 getEndpoint(): string {428 if(this.wsEndpoint === null) throw Error('No connection was established');429 return this.wsEndpoint;430 }431432 getApi(): ApiPromise {433 if(this.api === null) throw Error('API not initialized');434 return this.api;435 }436437 async subscribeEvents(expectedEvents: { section: string, names: string[] }[]) {438 const collectedEvents: IEvent[] = [];439 const unsubscribe = await this.getApi().query.system.events((events: Vec<FrameSystemEventRecord>) => {440 const ievents = this.eventHelper.extractEvents(events);441 ievents.forEach((event) => {442 expectedEvents.forEach((e => {443 if(event.section === e.section && e.names.includes(event.method)) {444 collectedEvents.push(event);445 }446 }));447 });448 });449 return {unsubscribe: unsubscribe as any, collectedEvents};450 }451452 clearChainLog(): void {453 this.chainLog = [];454 }455456 forceNetwork(value: TNetworks): void {457 this.forcedNetwork = value;458 }459460 async connect(wsEndpoint: string, listeners?: IApiListeners) {461 if(this.api !== null) throw Error('Already connected');462 const {api, network} = await ChainHelperBase.createConnection(wsEndpoint, listeners, this.forcedNetwork);463 this.wsEndpoint = wsEndpoint;464 this.api = api;465 this.network = network;466 }467468 async disconnect() {469 for(const child of this.children) {470 child.clearApi();471 }472473 if(this.api === null) return;474 await this.api.disconnect();475 this.clearApi();476 }477478 clearApi() {479 this.api = null;480 this.network = null;481 }482483 static async detectNetwork(api: ApiPromise): Promise<TNetworks> {484 const spec = (await api.query.system.lastRuntimeUpgrade()).toJSON() as any;485 const xcmChains = ['rococo', 'westend', 'westmint', 'acala', 'karura', 'moonbeam', 'moonriver'];486487 if(xcmChains.indexOf(spec.specName) > -1) return spec.specName;488489 if(['quartz', 'unique', 'sapphire'].indexOf(spec.specName) > -1) return spec.specName;490 return 'opal';491 }492493 static async detectNetworkByWsEndpoint(wsEndpoint: string): Promise<TNetworks> {494 const api = new ApiPromise({provider: new WsProvider(wsEndpoint)});495 await api.isReady;496497 const network = await this.detectNetwork(api);498499 await api.disconnect();500501 return network;502 }503504 static async createConnection(wsEndpoint: string, listeners?: IApiListeners, network?: TNetworks | null): Promise<{505 api: ApiPromise;506 network: TNetworks;507 }> {508 if(typeof network === 'undefined' || network === null) network = 'opal';509 const supportedRPC = {510 opal: {511 unique: require('@unique-nft/opal-testnet-types/definitions').unique.rpc,512 },513 quartz: {514 unique: require('@unique-nft/quartz-mainnet-types/definitions').unique.rpc,515 },516 unique: {517 unique: require('@unique-nft/unique-mainnet-types/definitions').unique.rpc,518 },519 rococo: {},520 westend: {},521 moonbeam: {},522 moonriver: {},523 acala: {},524 karura: {},525 westmint: {},526 };527 if(!supportedRPC.hasOwnProperty(network)) network = await this.detectNetworkByWsEndpoint(wsEndpoint);528 const rpc = supportedRPC[network];529530 // TODO: investigate how to replace rpc in runtime531 // api._rpcCore.addUserInterfaces(rpc);532533 const api = new ApiPromise({provider: new WsProvider(wsEndpoint), rpc});534535 await api.isReadyOrError;536537 if(typeof listeners === 'undefined') listeners = {};538 for(const event of ['connected', 'disconnected', 'error', 'ready', 'decorated']) {539 if(!listeners.hasOwnProperty(event) || typeof listeners[event as TApiAllowedListeners] === 'undefined') continue;540 api.on(event as ApiInterfaceEvents, listeners[event as TApiAllowedListeners] as (...args: any[]) => any);541 }542543 return {api, network};544 }545546 getTransactionStatus(data: { events: { event: IEvent }[], status: any }) {547 const {events, status} = data;548 if(status.isReady) {549 return this.transactionStatus.NOT_READY;550 }551 if(status.isBroadcast) {552 return this.transactionStatus.NOT_READY;553 }554 if(status.isInBlock || status.isFinalized) {555 const errors = events.filter(e => e.event.method === 'ExtrinsicFailed');556 if(errors.length > 0) {557 return this.transactionStatus.FAIL;558 }559 if(events.filter(e => e.event.method === 'ExtrinsicSuccess').length > 0) {560 return this.transactionStatus.SUCCESS;561 }562 }563564 return this.transactionStatus.FAIL;565 }566567 signTransaction(sender: TSigner, transaction: any, options: Partial<SignerOptions> | null = null, label = 'transaction') {568 const sign = (callback: any) => {569 if(options !== null) return transaction.signAndSend(sender, options, callback);570 return transaction.signAndSend(sender, callback);571 };572 // eslint-disable-next-line no-async-promise-executor573 return new Promise(async (resolve, reject) => {574 try {575 const unsub = await sign((result: any) => {576 const status = this.getTransactionStatus(result);577578 if(status === this.transactionStatus.SUCCESS) {579 this.logger.log(`${label} successful`);580 unsub();581 resolve({result, status, blockHash: result.status.asInBlock.toHuman()});582 } else if(status === this.transactionStatus.FAIL) {583 let moduleError = null;584585 if(result.hasOwnProperty('dispatchError')) {586 const dispatchError = result['dispatchError'];587588 if(dispatchError) {589 if(dispatchError.isModule) {590 const modErr = dispatchError.asModule;591 const errorMeta = dispatchError.registry.findMetaError(modErr);592593 moduleError = `${errorMeta.section}.${errorMeta.name}`;594 } else if(dispatchError.isToken) {595 moduleError = `Token: ${dispatchError.asToken}`;596 } else {597 // May be [object Object] in case of unhandled non-unit enum598 moduleError = `Misc: ${dispatchError.toHuman()}`;599 }600 } else {601 this.logger.log(result, this.logger.level.ERROR);602 }603 }604605 this.logger.log(`Something went wrong with ${label}. Status: ${status}`, this.logger.level.ERROR);606 unsub();607 reject({status, moduleError, result});608 }609 });610 } catch (e) {611 this.logger.log(e, this.logger.level.ERROR);612 reject(e);613 }614 });615 }616617 async signTransactionWithoutSending(signer: TSigner, tx: any) {618 const api = this.getApi();619 const signingInfo = await api.derive.tx.signingInfo(signer.address);620621 tx.sign(signer, {622 blockHash: api.genesisHash,623 genesisHash: api.genesisHash,624 runtimeVersion: api.runtimeVersion,625 nonce: signingInfo.nonce,626 });627628 return tx.toHex();629 }630631 async getPaymentInfo(signer: TSigner, tx: any, len: number | null) {632 const api = this.getApi();633 const signingInfo = await api.derive.tx.signingInfo(signer.address);634635 // We need to sign the tx because636 // unsigned transactions does not have an inclusion fee637 tx.sign(signer, {638 blockHash: api.genesisHash,639 genesisHash: api.genesisHash,640 runtimeVersion: api.runtimeVersion,641 nonce: signingInfo.nonce,642 });643644 if(len === null) {645 return (await this.callRpc('api.rpc.payment.queryInfo', [tx.toHex()])) as RuntimeDispatchInfo;646 } else {647 return (await api.call.transactionPaymentApi.queryInfo(tx, len)) as RuntimeDispatchInfo;648 }649 }650651 constructApiCall(apiCall: string, params: any[]) {652 if(!apiCall.startsWith('api.')) throw Error(`Invalid api call: ${apiCall}`);653 let call = this.getApi() as any;654 for(const part of apiCall.slice(4).split('.')) {655 call = call[part];656 if(!call) {657 const advice = part.includes('_') ? ' Looks like it needs to be converted to camel case.' : '';658 throw Error(`Function ${part} of api call ${apiCall} not found.${advice}`);659 }660 }661 return call(...params);662 }663664 encodeApiCall(apiCall: string, params: any[]) {665 return this.constructApiCall(apiCall, params).method.toHex();666 }667668 async executeExtrinsic<669 E extends string,670 V extends (671 ...args: any) => any = ForceFunction<672 Get2<673 AugmentedSubmittables<'promise'>,674 E, (...args: any) => Invalid<'not found'>675 >676 >677 >(678 sender: TSigner,679 extrinsic: `api.tx.${E}`,680 params: Parameters<V>,681 expectSuccess = true,682 options: Partial<SignerOptions> | null = null,/*, failureMessage='expected success'*/683 ): Promise<ITransactionResult> {684 if(this.api === null) throw Error('API not initialized');685 if(!extrinsic.startsWith('api.tx.')) throw Error(`${extrinsic} is not transaction`);686687 const startTime = (new Date()).getTime();688 let result: ITransactionResult;689 let events: IEvent[] = [];690 try {691 result = await this.signTransaction(sender, this.constructApiCall(extrinsic, params), options, extrinsic) as ITransactionResult;692 events = this.eventHelper.extractEvents(result.result.events);693 const errorEvent = events.find((event) => event.method == 'ExecutedFailed' || event.method == 'CreatedFailed');694 if(errorEvent)695 throw Error(errorEvent.method + ': ' + extrinsic);696 }697 catch (e) {698 if(!(e as object).hasOwnProperty('status')) throw e;699 result = e as ITransactionResult;700 }701702 const endTime = (new Date()).getTime();703704 const log = {705 executedAt: endTime,706 executionTime: endTime - startTime,707 type: this.chainLogType.EXTRINSIC,708 status: result.status,709 call: extrinsic,710 signer: this.getSignerAddress(sender),711 params,712 } as IUniqueHelperLog;713714 let errorMessage = '';715716 if(result.status !== this.transactionStatus.SUCCESS) {717 if(result.moduleError) {718 errorMessage = typeof result.moduleError === 'string'719 ? result.moduleError720 : `${Object.keys(result.moduleError)[0]}: ${Object.values(result.moduleError)[0]}`;721 log.moduleError = errorMessage;722 }723 else if(result.result.dispatchError) log.dispatchError = result.result.dispatchError;724 }725 if(events.length > 0) log.events = events;726727 this.chainLog.push(log);728729 if(expectSuccess && result.status !== this.transactionStatus.SUCCESS) {730 if(result.moduleError) throw Error(`${errorMessage}`);731 else if(result.result.dispatchError) throw Error(JSON.stringify(result.result.dispatchError));732 }733 return result as any;734 }735736 async callRpc737 // <738 // K extends 'rpc' | 'query',739 // E extends string,740 // V extends (...args: any) => any = ForceFunction<741 // Get2<742 // K extends 'rpc' ? DecoratedRpc<'promise', RpcInterface> : QueryableStorage<'promise'>,743 // E, (...args: any) => Invalid<'not found'>744 // >745 // >,746 // P = Parameters<V>,747 // >748 (rpc: string, params?: any[]): Promise<any> {749750 if(typeof params === 'undefined') params = [] as any;751 if(this.api === null) throw Error('API not initialized');752 if(!rpc.startsWith('api.rpc.') && !rpc.startsWith('api.query.')) throw Error(`${rpc} is not RPC call`);753754 const startTime = (new Date()).getTime();755 let result;756 let error = null;757 const log = {758 type: this.chainLogType.RPC,759 call: rpc,760 params,761 } as any as IUniqueHelperLog;762763 try {764 result = await this.constructApiCall(rpc, params as any);765 }766 catch (e) {767 error = e;768 }769770 const endTime = (new Date()).getTime();771772 log.executedAt = endTime;773 log.status = (error === null ? this.transactionStatus.SUCCESS : this.transactionStatus.FAIL) as 'Fail' | 'Success';774 log.executionTime = endTime - startTime;775776 this.chainLog.push(log);777778 if(error !== null) throw error;779780 return result;781 }782783 getSignerAddress(signer: IKeyringPair | string): string {784 if(typeof signer === 'string') return signer;785 return signer.address;786 }787788 fetchAllPalletNames(): string[] {789 if(this.api === null) throw Error('API not initialized');790 return this.api.runtimeMetadata.asLatest.pallets.map(m => m.name.toString().toLowerCase()).sort();791 }792793 fetchMissingPalletNames(requiredPallets: readonly string[]): string[] {794 const palletNames = this.fetchAllPalletNames();795 return requiredPallets.filter(p => !palletNames.includes(p));796 }797}798799800class HelperGroup<T extends ChainHelperBase> {801 helper: T;802803 constructor(uniqueHelper: T) {804 this.helper = uniqueHelper;805 }806}807808809class CollectionGroup extends HelperGroup<UniqueHelper> {810 /**811 * Get number of blocks when sponsored transaction is available.812 *813 * @param collectionId ID of collection814 * @param tokenId ID of token815 * @param addressObj address for which the sponsorship is checked816 * @example await getTokenNextSponsored(1, 2, {Substrate: '5DfhbVfww7ThF8q6f3...'});817 * @returns number of blocks or null if sponsorship hasn't been set818 */819 async getTokenNextSponsored(collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<number | null> {820 return (await this.helper.callRpc('api.rpc.unique.nextSponsored', [collectionId, addressObj, tokenId])).toJSON();821 }822823 /**824 * Get the number of created collections.825 *826 * @returns number of created collections827 */828 async getTotalCount(): Promise<number> {829 return (await this.helper.callRpc('api.rpc.unique.collectionStats')).created.toNumber();830 }831832 /**833 * Get information about the collection with additional data,834 * including the number of tokens it contains, its administrators,835 * the normalized address of the collection's owner, and decoded name and description.836 *837 * @param collectionId ID of collection838 * @example await getData(2)839 * @returns collection information object840 */841 async getData(collectionId: number): Promise<{842 id: number;843 name: string;844 description: string;845 tokensCount: number;846 admins: CrossAccountId[];847 normalizedOwner: TSubstrateAccount;848 raw: any849 } | null> {850 const collection = await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId]);851 const humanCollection = collection.toHuman(), collectionData = {852 id: collectionId, name: null, description: null, tokensCount: 0, admins: [],853 raw: humanCollection,854 } as any, jsonCollection = collection.toJSON();855 if(humanCollection === null) return null;856 collectionData.raw.limits = jsonCollection.limits;857 collectionData.raw.permissions = jsonCollection.permissions;858 collectionData.normalizedOwner = this.helper.address.normalizeSubstrate(collectionData.raw.owner);859 for(const key of ['name', 'description']) {860 collectionData[key] = this.helper.util.vec2str(humanCollection[key]);861 }862863 collectionData.tokensCount = (['RFT', 'NFT'].includes(humanCollection.mode))864 ? await this.helper[humanCollection.mode.toLocaleLowerCase() as 'nft' | 'rft'].getLastTokenId(collectionId)865 : 0;866 collectionData.admins = await this.getAdmins(collectionId);867868 return collectionData;869 }870871 /**872 * Get the addresses of the collection's administrators, optionally normalized.873 *874 * @param collectionId ID of collection875 * @param normalize whether to normalize the addresses to the default ss58 format876 * @example await getAdmins(1)877 * @returns array of administrators878 */879 async getAdmins(collectionId: number, normalize = false): Promise<CrossAccountId[]> {880 const admins = (await this.helper.callRpc('api.rpc.unique.adminlist', [collectionId])).toHuman();881882 return normalize883 ? admins.map((address: CrossAccountId) => address.withNormalizedSubstrate())884 : admins;885 }886887 /**888 * Get the addresses added to the collection allow-list, optionally normalized.889 * @param collectionId ID of collection890 * @param normalize whether to normalize the addresses to the default ss58 format891 * @example await getAllowList(1)892 * @returns array of allow-listed addresses893 */894 async getAllowList(collectionId: number, normalize = false): Promise<CrossAccountId[]> {895 const allowListed = (await this.helper.callRpc('api.rpc.unique.allowlist', [collectionId])).toHuman();896 return normalize897 ? allowListed.map((address: CrossAccountId) => address.withNormalizedSubstrate())898 : allowListed;899 }900901 /**902 * Get the effective limits of the collection instead of null for default values903 *904 * @param collectionId ID of collection905 * @example await getEffectiveLimits(2)906 * @returns object of collection limits907 */908 async getEffectiveLimits(collectionId: number): Promise<ICollectionLimits> {909 return (await this.helper.callRpc('api.rpc.unique.effectiveCollectionLimits', [collectionId])).toJSON();910 }911912 /**913 * Burns the collection if the signer has sufficient permissions and collection is empty.914 *915 * @param signer keyring of signer916 * @param collectionId ID of collection917 * @example await helper.collection.burn(aliceKeyring, 3);918 * @returns ```true``` if extrinsic success, otherwise ```false```919 */920 async burn(signer: TSigner, collectionId: number): Promise<boolean> {921 const result = await this.helper.executeExtrinsic(922 signer,923 'api.tx.unique.destroyCollection', [collectionId],924 true,925 );926927 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionDestroyed');928 }929930 /**931 * Sets the sponsor for the collection (Requires the Substrate address). Needs confirmation by the sponsor.932 *933 * @param signer keyring of signer934 * @param collectionId ID of collection935 * @param sponsorAddress Sponsor substrate address936 * @example setSponsor(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...")937 * @returns ```true``` if extrinsic success, otherwise ```false```938 */939 async setSponsor(signer: TSigner, collectionId: number, sponsorAddress: TSubstrateAccount): Promise<boolean> {940 const result = await this.helper.executeExtrinsic(941 signer,942 'api.tx.unique.setCollectionSponsor', [collectionId, sponsorAddress],943 true,944 );945946 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionSponsorSet');947 }948949 /**950 * Confirms consent to sponsor the collection on behalf of the signer.951 *952 * @param signer keyring of signer953 * @param collectionId ID of collection954 * @example confirmSponsorship(aliceKeyring, 10)955 * @returns ```true``` if extrinsic success, otherwise ```false```956 */957 async confirmSponsorship(signer: TSigner, collectionId: number): Promise<boolean> {958 const result = await this.helper.executeExtrinsic(959 signer,960 'api.tx.unique.confirmSponsorship', [collectionId],961 true,962 );963964 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'SponsorshipConfirmed');965 }966967 /**968 * Removes the sponsor of a collection, regardless if it consented or not.969 *970 * @param signer keyring of signer971 * @param collectionId ID of collection972 * @example removeSponsor(aliceKeyring, 10)973 * @returns ```true``` if extrinsic success, otherwise ```false```974 */975 async removeSponsor(signer: TSigner, collectionId: number): Promise<boolean> {976 const result = await this.helper.executeExtrinsic(977 signer,978 'api.tx.unique.removeCollectionSponsor', [collectionId],979 true,980 );981982 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionSponsorRemoved');983 }984985 /**986 * Sets the limits of the collection. At least one limit must be specified for a correct call.987 *988 * @param signer keyring of signer989 * @param collectionId ID of collection990 * @param limits collection limits object991 * @example992 * await setLimits(993 * aliceKeyring,994 * 10,995 * {996 * sponsorTransferTimeout: 0,997 * ownerCanDestroy: false998 * }999 * )1000 * @returns ```true``` if extrinsic success, otherwise ```false```1001 */1002 async setLimits(signer: TSigner, collectionId: number, limits: ICollectionLimits): Promise<boolean> {1003 const result = await this.helper.executeExtrinsic(1004 signer,1005 'api.tx.unique.setCollectionLimits', [collectionId, limits],1006 true,1007 );10081009 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionLimitSet');1010 }10111012 /**1013 * Changes the owner of the collection to the new Substrate address.1014 *1015 * @param signer keyring of signer1016 * @param collectionId ID of collection1017 * @param ownerAddress substrate address of new owner1018 * @example changeOwner(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...")1019 * @returns ```true``` if extrinsic success, otherwise ```false```1020 */1021 async changeOwner(signer: TSigner, collectionId: number, ownerAddress: TSubstrateAccount): Promise<boolean> {1022 const result = await this.helper.executeExtrinsic(1023 signer,1024 'api.tx.unique.changeCollectionOwner', [collectionId, ownerAddress],1025 true,1026 );10271028 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionOwnerChanged');1029 }10301031 /**1032 * Adds a collection administrator.1033 *1034 * @param signer keyring of signer1035 * @param collectionId ID of collection1036 * @param adminAddressObj Administrator address (substrate or ethereum)1037 * @example addAdmin(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."})1038 * @returns ```true``` if extrinsic success, otherwise ```false```1039 */1040 async addAdmin(signer: TSigner, collectionId: number, adminAddressObj: ICrossAccountId): Promise<boolean> {1041 const result = await this.helper.executeExtrinsic(1042 signer,1043 'api.tx.unique.addCollectionAdmin', [collectionId, adminAddressObj],1044 true,1045 );10461047 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionAdminAdded');1048 }10491050 /**1051 * Removes a collection administrator.1052 *1053 * @param signer keyring of signer1054 * @param collectionId ID of collection1055 * @param adminAddressObj Administrator address (substrate or ethereum)1056 * @example removeAdmin(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."})1057 * @returns ```true``` if extrinsic success, otherwise ```false```1058 */1059 async removeAdmin(signer: TSigner, collectionId: number, adminAddressObj: ICrossAccountId): Promise<boolean> {1060 const result = await this.helper.executeExtrinsic(1061 signer,1062 'api.tx.unique.removeCollectionAdmin', [collectionId, adminAddressObj],1063 true,1064 );10651066 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionAdminRemoved');1067 }10681069 /**1070 * Check if user is in allow list.1071 *1072 * @param collectionId ID of collection1073 * @param user Account to check1074 * @example await getAdmins(1)1075 * @returns is user in allow list1076 */1077 async allowed(collectionId: number, user: ICrossAccountId): Promise<boolean> {1078 return (await this.helper.callRpc('api.rpc.unique.allowed', [collectionId, user])).toJSON();1079 }10801081 /**1082 * Adds an address to allow list1083 * @param signer keyring of signer1084 * @param collectionId ID of collection1085 * @param addressObj address to add to the allow list1086 * @returns ```true``` if extrinsic success, otherwise ```false```1087 */1088 async addToAllowList(signer: TSigner, collectionId: number, addressObj: ICrossAccountId): Promise<boolean> {1089 const result = await this.helper.executeExtrinsic(1090 signer,1091 'api.tx.unique.addToAllowList', [collectionId, addressObj],1092 true,1093 );10941095 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'AllowListAddressAdded');1096 }10971098 /**1099 * Removes an address from allow list1100 *1101 * @param signer keyring of signer1102 * @param collectionId ID of collection1103 * @param addressObj address to remove from the allow list1104 * @returns ```true``` if extrinsic success, otherwise ```false```1105 */1106 async removeFromAllowList(signer: TSigner, collectionId: number, addressObj: ICrossAccountId): Promise<boolean> {1107 const result = await this.helper.executeExtrinsic(1108 signer,1109 'api.tx.unique.removeFromAllowList', [collectionId, addressObj],1110 true,1111 );11121113 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'AllowListAddressRemoved');1114 }11151116 /**1117 * Sets onchain permissions for selected collection.1118 *1119 * @param signer keyring of signer1120 * @param collectionId ID of collection1121 * @param permissions collection permissions object1122 * @example setPermissions(aliceKeyring, 10, {access:'AllowList', mintMode: true, nesting: {collectionAdmin: true, tokenOwner: true}});1123 * @returns ```true``` if extrinsic success, otherwise ```false```1124 */1125 async setPermissions(signer: TSigner, collectionId: number, permissions: ICollectionPermissions): Promise<boolean> {1126 const result = await this.helper.executeExtrinsic(1127 signer,1128 'api.tx.unique.setCollectionPermissions', [collectionId, permissions],1129 true,1130 );11311132 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionPermissionSet');1133 }11341135 /**1136 * Enables nesting for selected collection. If `restricted` set, you can nest only tokens from specified collections.1137 *1138 * @param signer keyring of signer1139 * @param collectionId ID of collection1140 * @param permissions nesting permissions object1141 * @example enableNesting(aliceKeyring, 10, {collectionAdmin: true, tokenOwner: true});1142 * @returns ```true``` if extrinsic success, otherwise ```false```1143 */1144 async enableNesting(signer: TSigner, collectionId: number, permissions: INestingPermissions): Promise<boolean> {1145 return await this.setPermissions(signer, collectionId, {nesting: permissions});1146 }11471148 /**1149 * Disables nesting for selected collection.1150 *1151 * @param signer keyring of signer1152 * @param collectionId ID of collection1153 * @example disableNesting(aliceKeyring, 10);1154 * @returns ```true``` if extrinsic success, otherwise ```false```1155 */1156 async disableNesting(signer: TSigner, collectionId: number): Promise<boolean> {1157 return await this.setPermissions(signer, collectionId, {nesting: {tokenOwner: false, collectionAdmin: false}});1158 }11591160 /**1161 * Sets onchain properties to the collection.1162 *1163 * @param signer keyring of signer1164 * @param collectionId ID of collection1165 * @param properties array of property objects1166 * @example setProperties(aliceKeyring, 10, [{key: "gender", value: "male"}]);1167 * @returns ```true``` if extrinsic success, otherwise ```false```1168 */1169 async setProperties(signer: TSigner, collectionId: number, properties: IProperty[]): Promise<boolean> {1170 const result = await this.helper.executeExtrinsic(1171 signer,1172 'api.tx.unique.setCollectionProperties', [collectionId, properties],1173 true,1174 );11751176 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionPropertySet');1177 }11781179 /**1180 * Get collection properties.1181 *1182 * @param collectionId ID of collection1183 * @param propertyKeys optionally filter the returned properties to only these keys1184 * @example getProperties(1219, ['location', 'date', 'time', 'isParadise']);1185 * @returns array of key-value pairs1186 */1187 async getProperties(collectionId: number, propertyKeys?: string[] | null): Promise<IProperty[]> {1188 return (await this.helper.callRpc('api.rpc.unique.collectionProperties', [collectionId, propertyKeys])).toHuman();1189 }11901191 async getPropertiesConsumedSpace(collectionId: number): Promise<number> {1192 const api = this.helper.getApi();1193 const props = (await api.query.common.collectionProperties(collectionId)).toJSON();11941195 return (props! as any).consumedSpace;1196 }11971198 async getCollectionOptions(collectionId: number) {1199 return (await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId])).toHuman();1200 }12011202 /**1203 * Deletes onchain properties from the collection.1204 *1205 * @param signer keyring of signer1206 * @param collectionId ID of collection1207 * @param propertyKeys array of property keys to delete1208 * @example deleteProperties(aliceKeyring, 10, ["gender", "age"]);1209 * @returns ```true``` if extrinsic success, otherwise ```false```1210 */1211 async deleteProperties(signer: TSigner, collectionId: number, propertyKeys: string[]): Promise<boolean> {1212 const result = await this.helper.executeExtrinsic(1213 signer,1214 'api.tx.unique.deleteCollectionProperties', [collectionId, propertyKeys],1215 true,1216 );12171218 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'CollectionPropertyDeleted');1219 }12201221 /**1222 * Changes the owner of the token.1223 *1224 * @param signer keyring of signer1225 * @param collectionId ID of collection1226 * @param tokenId ID of token1227 * @param addressObj address of a new owner1228 * @param amount amount of tokens to be transfered. For NFT must be set to 1n1229 * @example transferToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1230 * @returns true if the token success, otherwise false1231 */1232 async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId, amount = 1n): Promise<boolean> {1233 const result = await this.helper.executeExtrinsic(1234 signer,1235 'api.tx.unique.transfer', [addressObj, collectionId, tokenId, amount],1236 true, // `Unable to transfer token #${tokenId} from collection #${collectionId}`,1237 );12381239 return this.helper.util.isTokenTransferSuccess(result.result.events, collectionId, tokenId, {Substrate: typeof signer === 'string' ? signer : signer.address}, addressObj, amount);1240 }12411242 /**1243 *1244 * Change ownership of a token(s) on behalf of the owner.1245 *1246 * @param signer keyring of signer1247 * @param collectionId ID of collection1248 * @param tokenId ID of token1249 * @param fromAddressObj address on behalf of which the token will be sent1250 * @param toAddressObj new token owner1251 * @param amount amount of tokens to be transfered. For NFT must be set to 1n1252 * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg"}, {Ethereum: "0x9F0583DbB85..."})1253 * @returns true if the token success, otherwise false1254 */1255 async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n): Promise<boolean> {1256 const result = await this.helper.executeExtrinsic(1257 signer,1258 'api.tx.unique.transferFrom', [fromAddressObj, toAddressObj, collectionId, tokenId, amount],1259 true, // `Unable to transfer token #${tokenId} from collection #${collectionId}`,1260 );1261 return this.helper.util.isTokenTransferSuccess(result.result.events, collectionId, tokenId, fromAddressObj, toAddressObj, amount);1262 }12631264 /**1265 *1266 * Destroys a concrete instance of NFT/RFT or burns a specified amount of fungible tokens.1267 *1268 * @param signer keyring of signer1269 * @param collectionId ID of collection1270 * @param tokenId ID of token1271 * @param amount amount of tokens to be burned. For NFT must be set to 1n1272 * @example burnToken(aliceKeyring, 10, 5);1273 * @returns ```true``` if the extrinsic is successful, otherwise ```false```1274 */1275 async burnToken(signer: TSigner, collectionId: number, tokenId: number, amount = 1n): Promise<boolean> {1276 const burnResult = await this.helper.executeExtrinsic(1277 signer,1278 'api.tx.unique.burnItem', [collectionId, tokenId, amount],1279 true, // `Unable to burn token for ${label}`,1280 );1281 const burnedTokens = this.helper.util.extractTokensFromBurnResult(burnResult);1282 if(burnedTokens.tokens.length > 1) throw Error('Burned multiple tokens');1283 return burnedTokens.success;1284 }12851286 /**1287 * Destroys a concrete instance of NFT on behalf of the owner1288 *1289 * @param signer keyring of signer1290 * @param collectionId ID of collection1291 * @param tokenId ID of token1292 * @param fromAddressObj address on behalf of which the token will be burnt1293 * @param amount amount of tokens to be burned. For NFT must be set to 1n1294 * @example burnTokenFrom(aliceKeyring, 10, {Substrate: "5DyN4Y92vZCjv38fg..."}, 5, {Ethereum: "0x9F0583DbB85..."})1295 * @returns ```true``` if extrinsic success, otherwise ```false```1296 */1297 async burnTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, amount = 1n): Promise<boolean> {1298 const burnResult = await this.helper.executeExtrinsic(1299 signer,1300 'api.tx.unique.burnFrom', [collectionId, fromAddressObj, tokenId, amount],1301 true, // `Unable to burn token from for ${label}`,1302 );1303 const burnedTokens = this.helper.util.extractTokensFromBurnResult(burnResult);1304 return burnedTokens.success && burnedTokens.tokens.length > 0;1305 }13061307 /**1308 * Set, change, or remove approved address to transfer the ownership of the NFT.1309 *1310 * @param signer keyring of signer1311 * @param collectionId ID of collection1312 * @param tokenId ID of token1313 * @param toAddressObj Substrate or Ethereum address which gets approved use of the signer's tokens1314 * @param amount amount of token to be approved. For NFT must be set to 1n1315 * @returns ```true``` if extrinsic success, otherwise ```false```1316 */1317 async approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount = 1n) {1318 const approveResult = await this.helper.executeExtrinsic(1319 signer,1320 'api.tx.unique.approve', [toAddressObj, collectionId, tokenId, amount],1321 true, // `Unable to approve token for ${label}`,1322 );13231324 return this.helper.util.findCollectionInEvents(approveResult.result.events, collectionId, 'common', 'Approved');1325 }13261327 /**1328 * Set, change, or remove approved address to transfer the ownership of the NFT from eth mirror.1329 *1330 * @param signer keyring of signer1331 * @param collectionId ID of collection1332 * @param tokenId ID of token1333 * @param fromAddressObj Signer's Ethereum address containing her tokens1334 * @param toAddressObj Substrate or Ethereum address which gets approved use of the signer's tokens1335 * @param amount amount of token to be approved. For NFT must be set to 1n1336 * @returns ```true``` if extrinsic success, otherwise ```false```1337 */1338 async approveTokenFrom(signer: IKeyringPair, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {1339 const approveResult = await this.helper.executeExtrinsic(1340 signer,1341 'api.tx.unique.approveFrom', [fromAddressObj, toAddressObj, collectionId, tokenId, amount],1342 true, // `Unable to approve token for ${label}`,1343 );13441345 return this.helper.util.findCollectionInEvents(approveResult.result.events, collectionId, 'common', 'Approved');1346 }13471348 /**1349 * Set, change, or remove approved address to transfer the ownership of the NFT from eth mirror.1350 *1351 * @param signer keyring of signer1352 * @param collectionId ID of collection1353 * @param tokenId ID of token1354 * @param toAddressObj Substrate or Ethereum address which gets approved use of the signer's tokens1355 * @param amount amount of token to be approved. For NFT must be set to 1n1356 * @returns ```true``` if extrinsic success, otherwise ```false```1357 */1358 async approveTokenFromEth(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount = 1n) {1359 const ethMirror = CrossAccountId.fromKeyring(signer).toEthereum();1360 return await this.approveTokenFrom(signer, collectionId, tokenId, ethMirror, toAddressObj, amount);1361 }13621363 /**1364 * Get the amount of token pieces approved to transfer or burn. Normally 0.1365 *1366 * @param collectionId ID of collection1367 * @param tokenId ID of token1368 * @param toAccountObj address which is approved to use token pieces1369 * @param fromAccountObj address which may have allowed the use of its owned tokens1370 * @example getTokenApprovedPieces(10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Substrate: "5ERZNF88Mm7UGfPP3mdG..."})1371 * @returns number of approved to transfer pieces1372 */1373 async getTokenApprovedPieces(collectionId: number, tokenId: number, toAccountObj: ICrossAccountId, fromAccountObj: ICrossAccountId): Promise<bigint> {1374 return (await this.helper.callRpc('api.rpc.unique.allowance', [collectionId, fromAccountObj, toAccountObj, tokenId])).toBigInt();1375 }13761377 /**1378 * Get the last created token ID in a collection1379 *1380 * @param collectionId ID of collection1381 * @example getLastTokenId(10);1382 * @returns id of the last created token1383 */1384 async getLastTokenId(collectionId: number): Promise<number> {1385 return (await this.helper.callRpc('api.rpc.unique.lastTokenId', [collectionId])).toNumber();1386 }13871388 /**1389 * Check if token exists1390 *1391 * @param collectionId ID of collection1392 * @param tokenId ID of token1393 * @example doesTokenExist(10, 20);1394 * @returns true if the token exists, otherwise false1395 */1396 async doesTokenExist(collectionId: number, tokenId: number): Promise<boolean> {1397 return (await this.helper.callRpc('api.rpc.unique.tokenExists', [collectionId, tokenId])).toJSON();1398 }1399}14001401class NFTnRFT extends CollectionGroup {1402 /**1403 * Get tokens owned by account1404 *1405 * @param collectionId ID of collection1406 * @param addressObj tokens owner1407 * @example getTokensByAddress(10, {Substrate: "5DyN4Y92vZCjv38fg..."})1408 * @returns array of token ids owned by account1409 */1410 async getTokensByAddress(collectionId: number, addressObj: ICrossAccountId): Promise<number[]> {1411 return (await this.helper.callRpc('api.rpc.unique.accountTokens', [collectionId, addressObj])).toJSON();1412 }14131414 /**1415 * Get token data1416 *1417 * @param collectionId ID of collection1418 * @param tokenId ID of token1419 * @param propertyKeys optionally filter the token properties to only these keys1420 * @param blockHashAt optionally query the data at some block with this hash1421 * @example getToken(10, 5);1422 * @returns human readable token data1423 */1424 async getToken(collectionId: number, tokenId: number, propertyKeys: string[] = [], blockHashAt?: string): Promise<{1425 properties: IProperty[];1426 owner: CrossAccountId;1427 normalizedOwner: CrossAccountId;1428 } | null> {1429 let tokenData;1430 if(typeof blockHashAt === 'undefined') {1431 tokenData = await this.helper.callRpc('api.rpc.unique.tokenData', [collectionId, tokenId]);1432 }1433 else {1434 if(propertyKeys.length == 0) {1435 const collection = (await this.helper.callRpc('api.rpc.unique.collectionById', [collectionId])).toHuman();1436 if(!collection) return null;1437 propertyKeys = collection.tokenPropertyPermissions.map((x: ITokenPropertyPermission) => x.key);1438 }1439 tokenData = await this.helper.callRpc('api.rpc.unique.tokenData', [collectionId, tokenId, propertyKeys, blockHashAt]);1440 }1441 tokenData = tokenData.toHuman();1442 if(tokenData === null || tokenData.owner === null) return null;1443 const owner = {} as any;1444 for(const key of Object.keys(tokenData.owner)) {1445 owner[key.toLocaleLowerCase()] = key.toLocaleLowerCase() == 'substrate'1446 ? CrossAccountId.normalizeSubstrateAddress(tokenData.owner[key])1447 : tokenData.owner[key];1448 }1449 tokenData.normalizedOwner = CrossAccountId.fromLowerCaseKeys(owner);1450 return tokenData;1451 }14521453 /**1454 * Get token's owner1455 * @param collectionId ID of collection1456 * @param tokenId ID of token1457 * @param blockHashAt optionally query the data at the block with this hash1458 * @example getTokenOwner(10, 5);1459 * @returns Address in CrossAccountId format, e.g. {Substrate: "5DnSF6RRjwteE3BrCj..."}1460 */1461 async getTokenOwner(collectionId: number, tokenId: number, blockHashAt?: string): Promise<CrossAccountId> {1462 let owner;1463 if(typeof blockHashAt === 'undefined') {1464 owner = await this.helper.callRpc('api.rpc.unique.tokenOwner', [collectionId, tokenId]);1465 } else {1466 owner = await this.helper.callRpc('api.rpc.unique.tokenOwner', [collectionId, tokenId, blockHashAt]);1467 }1468 return CrossAccountId.fromLowerCaseKeys(owner.toJSON());1469 }14701471 /**1472 * Recursively find the address that owns the token1473 * @param collectionId ID of collection1474 * @param tokenId ID of token1475 * @param blockHashAt1476 * @example getTokenTopmostOwner(10, 5);1477 * @returns address in CrossAccountId format, e.g. {Substrate: "5DyN4Y92vZCjv38fg..."}1478 */1479 async getTokenTopmostOwner(collectionId: number, tokenId: number, blockHashAt?: string): Promise<CrossAccountId | null> {1480 let owner;1481 if(typeof blockHashAt === 'undefined') {1482 owner = await this.helper.callRpc('api.rpc.unique.topmostTokenOwner', [collectionId, tokenId]);1483 } else {1484 owner = await this.helper.callRpc('api.rpc.unique.topmostTokenOwner', [collectionId, tokenId, blockHashAt]);1485 }14861487 if(owner === null) return null;14881489 return owner.toHuman();1490 }14911492 /**1493 * Nest one token into another1494 * @param signer keyring of signer1495 * @param tokenObj token to be nested1496 * @param rootTokenObj token to be parent1497 * @example nestToken(aliceKeyring, {collectionId: 10, tokenId: 5}, {collectionId: 10, tokenId: 4});1498 * @returns ```true``` if extrinsic success, otherwise ```false```1499 */1500 async nestToken(signer: TSigner, tokenObj: IToken, rootTokenObj: IToken): Promise<boolean> {1501 const rootTokenAddress = this.helper.util.getTokenAccount(rootTokenObj);1502 const result = await this.transferToken(signer, tokenObj.collectionId, tokenObj.tokenId, rootTokenAddress);1503 if(!result) {1504 throw Error('Unable to nest token!');1505 }1506 return result;1507 }15081509 /**1510 * Remove token from nested state1511 * @param signer keyring of signer1512 * @param tokenObj token to unnest1513 * @param rootTokenObj parent of a token1514 * @param toAddressObj address of a new token owner1515 * @example unnestToken(aliceKeyring, {collectionId: 10, tokenId: 5}, {collectionId: 10, tokenId: 4}, {Substrate: "5DyN4Y92vZCjv38fg..."});1516 * @returns ```true``` if extrinsic success, otherwise ```false```1517 */1518 async unnestToken(signer: TSigner, tokenObj: IToken, rootTokenObj: IToken, toAddressObj: ICrossAccountId): Promise<boolean> {1519 const rootTokenAddress = this.helper.util.getTokenAccount(rootTokenObj);1520 const result = await this.transferTokenFrom(signer, tokenObj.collectionId, tokenObj.tokenId, rootTokenAddress, toAddressObj);1521 if(!result) {1522 throw Error('Unable to unnest token!');1523 }1524 return result;1525 }15261527 /**1528 * Set permissions to change token properties1529 *1530 * @param signer keyring of signer1531 * @param collectionId ID of collection1532 * @param permissions permissions to change a property by the collection admin or token owner1533 * @example setTokenPropertyPermissions(1534 * aliceKeyring, 10, [{key: "gender", permission: {tokenOwner: true, mutable: true, collectionAdmin: true}}]1535 * )1536 * @returns true if extrinsic success otherwise false1537 */1538 async setTokenPropertyPermissions(signer: TSigner, collectionId: number, permissions: ITokenPropertyPermission[]): Promise<boolean> {1539 const result = await this.helper.executeExtrinsic(1540 signer,1541 'api.tx.unique.setTokenPropertyPermissions', [collectionId, permissions],1542 true,1543 );15441545 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'PropertyPermissionSet');1546 }15471548 /**1549 * Get token property permissions.1550 *1551 * @param collectionId ID of collection1552 * @param propertyKeys optionally filter the returned property permissions to only these keys1553 * @example getPropertyPermissions(1219, ['location', 'date', 'time', 'isParadise']);1554 * @returns array of key-permission pairs1555 */1556 async getPropertyPermissions(collectionId: number, propertyKeys: string[] | null = null): Promise<ITokenPropertyPermission[]> {1557 return (await this.helper.callRpc('api.rpc.unique.propertyPermissions', [collectionId, ...(propertyKeys === null ? [] : [propertyKeys])])).toHuman();1558 }15591560 /**1561 * Set token properties1562 *1563 * @param signer keyring of signer1564 * @param collectionId ID of collection1565 * @param tokenId ID of token1566 * @param properties key-value pairs of metadata which to add to a token. Keys must be permitted in the collection1567 * @example setTokenProperties(aliceKeyring, 10, 5, [{key: "gender", value: "female"}, {key: "age", value: "23"}])1568 * @returns ```true``` if extrinsic success, otherwise ```false```1569 */1570 async setTokenProperties(signer: TSigner, collectionId: number, tokenId: number, properties: IProperty[]): Promise<boolean> {1571 const result = await this.helper.executeExtrinsic(1572 signer,1573 'api.tx.unique.setTokenProperties', [collectionId, tokenId, properties],1574 true,1575 );15761577 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'TokenPropertySet');1578 }15791580 /**1581 * Get properties, metadata assigned to a token.1582 *1583 * @param collectionId ID of collection1584 * @param tokenId ID of token1585 * @param propertyKeys optionally filter the returned properties to only these keys1586 * @example getTokenProperties(1219, ['location', 'date', 'time', 'isParadise']);1587 * @returns array of key-value pairs1588 */1589 async getTokenProperties(collectionId: number, tokenId: number, propertyKeys?: string[] | null): Promise<IProperty[]> {1590 return (await this.helper.callRpc('api.rpc.unique.tokenProperties', [collectionId, tokenId, propertyKeys])).toHuman();1591 }15921593 /**1594 * Delete the provided properties of a token1595 * @param signer keyring of signer1596 * @param collectionId ID of collection1597 * @param tokenId ID of token1598 * @param propertyKeys property keys to be deleted1599 * @example deleteTokenProperties(aliceKeyring, 10, 5, ["gender", "age"])1600 * @returns ```true``` if extrinsic success, otherwise ```false```1601 */1602 async deleteTokenProperties(signer: TSigner, collectionId: number, tokenId: number, propertyKeys: string[]): Promise<boolean> {1603 const result = await this.helper.executeExtrinsic(1604 signer,1605 'api.tx.unique.deleteTokenProperties', [collectionId, tokenId, propertyKeys],1606 true,1607 );16081609 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'TokenPropertyDeleted');1610 }16111612 /**1613 * Mint new collection1614 *1615 * @param signer keyring of signer1616 * @param collectionOptions basic collection options and properties1617 * @param mode NFT or RFT type of a collection1618 * @example mintCollection(aliceKeyring, {name: 'New', description: "New collection", tokenPrefix: "NEW"}, "NFT")1619 * @returns object of the created collection1620 */1621 async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions, mode: 'NFT' | 'RFT'): Promise<UniqueBaseCollection> {1622 collectionOptions = JSON.parse(JSON.stringify(collectionOptions)) as ICollectionCreationOptions; // Clone object1623 collectionOptions.mode = (mode === 'NFT') ? {nft: null} : {refungible: null};1624 for(const key of ['name', 'description', 'tokenPrefix']) {1625 if(typeof collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] === 'string') collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] = this.helper.util.str2vec(collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] as string);1626 }1627 const creationResult = await this.helper.executeExtrinsic(1628 signer,1629 'api.tx.unique.createCollectionEx', [collectionOptions],1630 true, // errorLabel,1631 );1632 return this.getCollectionObject(this.helper.util.extractCollectionIdFromCreationResult(creationResult));1633 }16341635 getCollectionObject(_collectionId: number): any {1636 return null;1637 }16381639 getTokenObject(_collectionId: number, _tokenId: number): any {1640 return null;1641 }16421643 /**1644 * Tells whether the given `owner` approves the `operator`.1645 * @param collectionId ID of collection1646 * @param owner owner address1647 * @param operator operator addrees1648 * @returns true if operator is enabled1649 */1650 async allowanceForAll(collectionId: number, owner: ICrossAccountId, operator: ICrossAccountId): Promise<boolean> {1651 return (await this.helper.callRpc('api.rpc.unique.allowanceForAll', [collectionId, owner, operator])).toJSON();1652 }16531654 /** Sets or unsets the approval of a given operator.1655 * The `operator` is allowed to transfer all tokens of the `caller` on their behalf.1656 * @param operator Operator1657 * @param approved Should operator status be granted or revoked?1658 * @returns ```true``` if extrinsic success, otherwise ```false```1659 */1660 async setAllowanceForAll(signer: TSigner, collectionId: number, operator: ICrossAccountId, approved: boolean): Promise<boolean> {1661 const result = await this.helper.executeExtrinsic(1662 signer,1663 'api.tx.unique.setAllowanceForAll', [collectionId, operator, approved],1664 true,1665 );1666 return this.helper.util.findCollectionInEvents(result.result.events, collectionId, 'common', 'ApprovedForAll');1667 }1668}166916701671class NFTGroup extends NFTnRFT {1672 /**1673 * Get collection object1674 * @param collectionId ID of collection1675 * @example getCollectionObject(2);1676 * @returns instance of UniqueNFTCollection1677 */1678 getCollectionObject(collectionId: number): UniqueNFTCollection {1679 return new UniqueNFTCollection(collectionId, this.helper);1680 }16811682 /**1683 * Get token object1684 * @param collectionId ID of collection1685 * @param tokenId ID of token1686 * @example getTokenObject(10, 5);1687 * @returns instance of UniqueNFTToken1688 */1689 getTokenObject(collectionId: number, tokenId: number): UniqueNFToken {1690 return new UniqueNFToken(tokenId, this.getCollectionObject(collectionId));1691 }16921693 /**1694 * Is token approved to transfer1695 * @param collectionId ID of collection1696 * @param tokenId ID of token1697 * @param toAccountObj address to be approved1698 * @returns ```true``` if extrinsic success, otherwise ```false```1699 */1700 async isTokenApproved(collectionId: number, tokenId: number, toAccountObj: ICrossAccountId): Promise<boolean> {1701 return (await this.getTokenApprovedPieces(collectionId, tokenId, toAccountObj, await this.getTokenOwner(collectionId, tokenId))) === 1n;1702 }17031704 /**1705 * Changes the owner of the token.1706 *1707 * @param signer keyring of signer1708 * @param collectionId ID of collection1709 * @param tokenId ID of token1710 * @param addressObj address of a new owner1711 * @example transferToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1712 * @returns ```true``` if extrinsic success, otherwise ```false```1713 */1714 async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<boolean> {1715 return await super.transferToken(signer, collectionId, tokenId, addressObj, 1n);1716 }17171718 /**1719 *1720 * Change ownership of a NFT on behalf of the owner.1721 *1722 * @param signer keyring of signer1723 * @param collectionId ID of collection1724 * @param tokenId ID of token1725 * @param fromAddressObj address on behalf of which the token will be sent1726 * @param toAddressObj new token owner1727 * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Ethereum: "0x9F0583DbB85..."})1728 * @returns ```true``` if extrinsic success, otherwise ```false```1729 */1730 async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId): Promise<boolean> {1731 return await super.transferTokenFrom(signer, collectionId, tokenId, fromAddressObj, toAddressObj, 1n);1732 }17331734 /**1735 * Get tokens nested in the provided token1736 * @param collectionId ID of collection1737 * @param tokenId ID of token1738 * @param blockHashAt optionally query the data at the block with this hash1739 * @example getTokenChildren(10, 5);1740 * @returns tokens whose depth of nesting is <= 51741 */1742 async getTokenChildren(collectionId: number, tokenId: number, blockHashAt?: string): Promise<IToken[]> {1743 let children;1744 if(typeof blockHashAt === 'undefined') {1745 children = await this.helper.callRpc('api.rpc.unique.tokenChildren', [collectionId, tokenId]);1746 } else {1747 children = await this.helper.callRpc('api.rpc.unique.tokenChildren', [collectionId, tokenId, blockHashAt]);1748 }17491750 return children.toJSON().map((x: any) => ({collectionId: x.collection, tokenId: x.token}));1751 }17521753 /**1754 * Mint new collection1755 * @param signer keyring of signer1756 * @param collectionOptions Collection options1757 * @example1758 * mintCollection(aliceKeyring, {1759 * name: 'New',1760 * description: 'New collection',1761 * tokenPrefix: 'NEW',1762 * })1763 * @returns object of the created collection1764 */1765 async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}): Promise<UniqueNFTCollection> {1766 return await super.mintCollection(signer, collectionOptions, 'NFT') as UniqueNFTCollection;1767 }17681769 /**1770 * Mint new token1771 * @param signer keyring of signer1772 * @param data token data1773 * @returns created token object1774 */1775 async mintToken(signer: TSigner, data: { collectionId: number; owner: ICrossAccountId | string; properties?: IProperty[]; }): Promise<UniqueNFToken> {1776 const creationResult = await this.helper.executeExtrinsic(1777 signer,1778 'api.tx.unique.createItem', [data.collectionId, (typeof data.owner === 'string') ? {Substrate: data.owner} : data.owner, {1779 NFT: {1780 properties: data.properties,1781 },1782 }],1783 true,1784 );1785 const createdTokens = this.helper.util.extractTokensFromCreationResult(creationResult);1786 if(createdTokens.tokens.length > 1) throw Error('Minted multiple tokens');1787 if(createdTokens.tokens.length < 1) throw Error('No tokens minted');1788 return this.getTokenObject(data.collectionId, createdTokens.tokens[0].tokenId);1789 }17901791 /**1792 * Mint multiple NFT tokens1793 * @param signer keyring of signer1794 * @param collectionId ID of collection1795 * @param tokens array of tokens with owner and properties1796 * @example1797 * mintMultipleTokens(aliceKeyring, 10, [{1798 * owner: {Substrate: "5DyN4Y92vZCjv38fg..."},1799 * properties: [{key: "gender", value: "male"},{key: "age", value: "45"}],1800 * },{1801 * owner: {Ethereum: "0x9F0583DbB855d..."},1802 * properties: [{key: "gender", value: "female"},{key: "age", value: "22"}],1803 * }]);1804 * @returns ```true``` if extrinsic success, otherwise ```false```1805 */1806 async mintMultipleTokens(signer: TSigner, collectionId: number, tokens: { owner: ICrossAccountId, properties?: IProperty[] }[]): Promise<UniqueNFToken[]> {1807 const creationResult = await this.helper.executeExtrinsic(1808 signer,1809 'api.tx.unique.createMultipleItemsEx', [collectionId, {NFT: tokens}],1810 true,1811 );1812 const collection = this.getCollectionObject(collectionId);1813 return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1814 }18151816 /**1817 * Mint multiple NFT tokens with one owner1818 * @param signer keyring of signer1819 * @param collectionId ID of collection1820 * @param owner tokens owner1821 * @param tokens array of tokens with owner and properties1822 * @example1823 * mintMultipleTokensWithOneOwner(aliceKeyring, 10, "5DyN4Y92vZCjv38fg...", [{1824 * properties: [{1825 * key: "gender",1826 * value: "female",1827 * },{1828 * key: "age",1829 * value: "33",1830 * }],1831 * }]);1832 * @returns array of newly created tokens1833 */1834 async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, owner: ICrossAccountId, tokens: { properties?: IProperty[] }[]): Promise<UniqueNFToken[]> {1835 const rawTokens = [];1836 for(const token of tokens) {1837 const raw = {NFT: {properties: token.properties}};1838 rawTokens.push(raw);1839 }1840 const creationResult = await this.helper.executeExtrinsic(1841 signer,1842 'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],1843 true,1844 );1845 const collection = this.getCollectionObject(collectionId);1846 return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1847 }18481849 /**1850 * Set, change, or remove approved address to transfer the ownership of the NFT.1851 *1852 * @param signer keyring of signer1853 * @param collectionId ID of collection1854 * @param tokenId ID of token1855 * @param toAddressObj address to approve1856 * @example approveToken(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."})1857 * @returns ```true``` if extrinsic success, otherwise ```false```1858 */1859 approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount = 1n) {1860 return super.approveToken(signer, collectionId, tokenId, toAddressObj, amount);1861 }1862}186318641865class RFTGroup extends NFTnRFT {1866 /**1867 * Get collection object1868 * @param collectionId ID of collection1869 * @example getCollectionObject(2);1870 * @returns instance of UniqueRFTCollection1871 */1872 getCollectionObject(collectionId: number): UniqueRFTCollection {1873 return new UniqueRFTCollection(collectionId, this.helper);1874 }18751876 /**1877 * Get token object1878 * @param collectionId ID of collection1879 * @param tokenId ID of token1880 * @example getTokenObject(10, 5);1881 * @returns instance of UniqueNFTToken1882 */1883 getTokenObject(collectionId: number, tokenId: number): UniqueRFToken {1884 return new UniqueRFToken(tokenId, this.getCollectionObject(collectionId));1885 }18861887 /**1888 * Get top 10 token owners with the largest number of pieces1889 * @param collectionId ID of collection1890 * @param tokenId ID of token1891 * @example getTokenTop10Owners(10, 5);1892 * @returns array of top 10 owners1893 */1894 async getTokenTop10Owners(collectionId: number, tokenId: number): Promise<CrossAccountId[]> {1895 return (await this.helper.callRpc('api.rpc.unique.tokenOwners', [collectionId, tokenId])).toJSON().map(CrossAccountId.fromLowerCaseKeys);1896 }18971898 /**1899 * Get number of pieces owned by address1900 * @param collectionId ID of collection1901 * @param tokenId ID of token1902 * @param addressObj address token owner1903 * @example getTokenBalance(10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."});1904 * @returns number of pieces ownerd by address1905 */1906 async getTokenBalance(collectionId: number, tokenId: number, addressObj: ICrossAccountId): Promise<bigint> {1907 return (await this.helper.callRpc('api.rpc.unique.balance', [collectionId, addressObj, tokenId])).toBigInt();1908 }19091910 /**1911 * Transfer pieces of token to another address1912 * @param signer keyring of signer1913 * @param collectionId ID of collection1914 * @param tokenId ID of token1915 * @param addressObj address of a new owner1916 * @param amount number of pieces to be transfered1917 * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, 2000n)1918 * @returns ```true``` if extrinsic success, otherwise ```false```1919 */1920 async transferToken(signer: TSigner, collectionId: number, tokenId: number, addressObj: ICrossAccountId, amount = 1n): Promise<boolean> {1921 return await super.transferToken(signer, collectionId, tokenId, addressObj, amount);1922 }19231924 /**1925 * Change ownership of some pieces of RFT on behalf of the owner.1926 * @param signer keyring of signer1927 * @param collectionId ID of collection1928 * @param tokenId ID of token1929 * @param fromAddressObj address on behalf of which the token will be sent1930 * @param toAddressObj new token owner1931 * @param amount number of pieces to be transfered1932 * @example transferTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, {Substrate: "5DfhbVfww7ThF8q6f3i..."}, 2000n)1933 * @returns ```true``` if extrinsic success, otherwise ```false```1934 */1935 async transferTokenFrom(signer: TSigner, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n): Promise<boolean> {1936 return await super.transferTokenFrom(signer, collectionId, tokenId, fromAddressObj, toAddressObj, amount);1937 }19381939 /**1940 * Mint new collection1941 * @param signer keyring of signer1942 * @param collectionOptions Collection options1943 * @example1944 * mintCollection(aliceKeyring, {1945 * name: 'New',1946 * description: 'New collection',1947 * tokenPrefix: 'NEW',1948 * })1949 * @returns object of the created collection1950 */1951 async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}): Promise<UniqueRFTCollection> {1952 return await super.mintCollection(signer, collectionOptions, 'RFT') as UniqueRFTCollection;1953 }19541955 /**1956 * Mint new token1957 * @param signer keyring of signer1958 * @param data token data1959 * @example mintToken(aliceKeyring, {collectionId: 10, owner: {Substrate: '5GHoZe9c73RYbVzq...'}, pieces: 10000n});1960 * @returns created token object1961 */1962 async mintToken(signer: TSigner, data: { collectionId: number; owner: ICrossAccountId | string; pieces: bigint; properties?: IProperty[]; }): Promise<UniqueRFToken> {1963 const creationResult = await this.helper.executeExtrinsic(1964 signer,1965 'api.tx.unique.createItem', [data.collectionId, (typeof data.owner === 'string') ? {Substrate: data.owner} : data.owner, {1966 ReFungible: {1967 pieces: data.pieces,1968 properties: data.properties,1969 },1970 }],1971 true,1972 );1973 const createdTokens = this.helper.util.extractTokensFromCreationResult(creationResult);1974 if(createdTokens.tokens.length > 1) throw Error('Minted multiple tokens');1975 if(createdTokens.tokens.length < 1) throw Error('No tokens minted');1976 return this.getTokenObject(data.collectionId, createdTokens.tokens[0].tokenId);1977 }19781979 async mintMultipleTokens(signer: TSigner, collectionId: number, tokens: { owner: ICrossAccountId, pieces: bigint, properties?: IProperty[] }[]): Promise<UniqueRFToken[]> {1980 throw Error('Not implemented');1981 const creationResult = await this.helper.executeExtrinsic(1982 signer,1983 'api.tx.unique.createMultipleItemsEx', [collectionId, {RefungibleMultipleOwners: tokens}],1984 true, // `Unable to mint RFT tokens for ${label}`,1985 );1986 const collection = this.getCollectionObject(collectionId);1987 return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));1988 }19891990 /**1991 * Mint multiple RFT tokens with one owner1992 * @param signer keyring of signer1993 * @param collectionId ID of collection1994 * @param owner tokens owner1995 * @param tokens array of tokens with properties and pieces1996 * @example mintMultipleTokensWithOneOwner(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, [{pieces: 100000n, properties: [{key: "gender", value: "male"}]}]);1997 * @returns array of newly created RFT tokens1998 */1999 async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, owner: ICrossAccountId, tokens: { pieces: bigint, properties?: IProperty[] }[]): Promise<UniqueRFToken[]> {2000 const rawTokens = [];2001 for(const token of tokens) {2002 const raw = {ReFungible: {pieces: token.pieces, properties: token.properties}};2003 rawTokens.push(raw);2004 }2005 const creationResult = await this.helper.executeExtrinsic(2006 signer,2007 'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],2008 true,2009 );2010 const collection = this.getCollectionObject(collectionId);2011 return this.helper.util.extractTokensFromCreationResult(creationResult).tokens.map((x: IToken) => collection.getTokenObject(x.tokenId));2012 }20132014 /**2015 * Destroys a concrete instance of RFT.2016 * @param signer keyring of signer2017 * @param collectionId ID of collection2018 * @param tokenId ID of token2019 * @param amount number of pieces to be burnt2020 * @example burnToken(aliceKeyring, 10, 5);2021 * @returns ```true``` if the extrinsic is successful, otherwise ```false```2022 */2023 async burnToken(signer: IKeyringPair, collectionId: number, tokenId: number, amount = 1n): Promise<boolean> {2024 return await super.burnToken(signer, collectionId, tokenId, amount);2025 }20262027 /**2028 * Destroys a concrete instance of RFT on behalf of the owner.2029 * @param signer keyring of signer2030 * @param collectionId ID of collection2031 * @param tokenId ID of token2032 * @param fromAddressObj address on behalf of which the token will be burnt2033 * @param amount number of pieces to be burnt2034 * @example burnTokenFrom(aliceKeyring, 10, 5, {Substrate: "5DyN4Y92vZCjv38fg..."}, 2n)2035 * @returns ```true``` if extrinsic success, otherwise ```false```2036 */2037 async burnTokenFrom(signer: IKeyringPair, collectionId: number, tokenId: number, fromAddressObj: ICrossAccountId, amount = 1n): Promise<boolean> {2038 return await super.burnTokenFrom(signer, collectionId, tokenId, fromAddressObj, amount);2039 }20402041 /**2042 * Set, change, or remove approved address to transfer the ownership of the RFT.2043 *2044 * @param signer keyring of signer2045 * @param collectionId ID of collection2046 * @param tokenId ID of token2047 * @param toAddressObj address to approve2048 * @param amount number of pieces to be approved2049 * @example approveToken(aliceKeyring, 10, 5, {Substrate: "5GHoZe9c73RYbVzq..."}, "", 10000n);2050 * @returns true if the token success, otherwise false2051 */2052 approveToken(signer: IKeyringPair, collectionId: number, tokenId: number, toAddressObj: ICrossAccountId, amount = 1n) {2053 return super.approveToken(signer, collectionId, tokenId, toAddressObj, amount);2054 }20552056 /**2057 * Get total number of pieces2058 * @param collectionId ID of collection2059 * @param tokenId ID of token2060 * @example getTokenTotalPieces(10, 5);2061 * @returns number of pieces2062 */2063 async getTokenTotalPieces(collectionId: number, tokenId: number): Promise<bigint> {2064 return (await this.helper.callRpc('api.rpc.unique.totalPieces', [collectionId, tokenId])).unwrap().toBigInt();2065 }20662067 /**2068 * Change number of token pieces. Signer must be the owner of all token pieces.2069 * @param signer keyring of signer2070 * @param collectionId ID of collection2071 * @param tokenId ID of token2072 * @param amount new number of pieces2073 * @example repartitionToken(aliceKeyring, 10, 5, 12345n);2074 * @returns true if the repartion was success, otherwise false2075 */2076 async repartitionToken(signer: TSigner, collectionId: number, tokenId: number, amount: bigint): Promise<boolean> {2077 const currentAmount = await this.getTokenTotalPieces(collectionId, tokenId);2078 const repartitionResult = await this.helper.executeExtrinsic(2079 signer,2080 'api.tx.unique.repartition', [collectionId, tokenId, amount],2081 true,2082 );2083 if(currentAmount < amount) return this.helper.util.findCollectionInEvents(repartitionResult.result.events, collectionId, 'common', 'ItemCreated');2084 return this.helper.util.findCollectionInEvents(repartitionResult.result.events, collectionId, 'common', 'ItemDestroyed');2085 }2086}208720882089class FTGroup extends CollectionGroup {2090 /**2091 * Get collection object2092 * @param collectionId ID of collection2093 * @example getCollectionObject(2);2094 * @returns instance of UniqueFTCollection2095 */2096 getCollectionObject(collectionId: number): UniqueFTCollection {2097 return new UniqueFTCollection(collectionId, this.helper);2098 }20992100 /**2101 * Mint new fungible collection2102 * @param signer keyring of signer2103 * @param collectionOptions Collection options2104 * @param decimalPoints number of token decimals2105 * @example2106 * mintCollection(aliceKeyring, {2107 * name: 'New',2108 * description: 'New collection',2109 * tokenPrefix: 'NEW',2110 * }, 18)2111 * @returns newly created fungible collection2112 */2113 async mintCollection(signer: TSigner, collectionOptions: ICollectionCreationOptions = {}, decimalPoints = 0): Promise<UniqueFTCollection> {2114 collectionOptions = JSON.parse(JSON.stringify(collectionOptions)) as ICollectionCreationOptions; // Clone object2115 if(collectionOptions.tokenPropertyPermissions) throw Error('Fungible collections has no tokenPropertyPermissions');2116 collectionOptions.mode = {fungible: decimalPoints};2117 for(const key of ['name', 'description', 'tokenPrefix']) {2118 if(typeof collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] === 'string') collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] = this.helper.util.str2vec(collectionOptions[key as 'name' | 'description' | 'tokenPrefix'] as string);2119 }2120 const creationResult = await this.helper.executeExtrinsic(2121 signer,2122 'api.tx.unique.createCollectionEx', [collectionOptions],2123 true,2124 );2125 return this.getCollectionObject(this.helper.util.extractCollectionIdFromCreationResult(creationResult));2126 }21272128 /**2129 * Mint tokens2130 * @param signer keyring of signer2131 * @param collectionId ID of collection2132 * @param owner address owner of new tokens2133 * @param amount amount of tokens to be meanted2134 * @example mintTokens(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq"}, 1000n);2135 * @returns ```true``` if extrinsic success, otherwise ```false```2136 */2137 async mintTokens(signer: TSigner, collectionId: number, amount: bigint, owner: ICrossAccountId | string): Promise<boolean> {2138 const creationResult = await this.helper.executeExtrinsic(2139 signer,2140 'api.tx.unique.createItem', [collectionId, (typeof owner === 'string') ? {Substrate: owner} : owner, {2141 Fungible: {2142 value: amount,2143 },2144 }],2145 true, // `Unable to mint fungible tokens for ${label}`,2146 );2147 return this.helper.util.findCollectionInEvents(creationResult.result.events, collectionId, 'common', 'ItemCreated');2148 }21492150 /**2151 * Mint multiple Fungible tokens with one owner2152 * @param signer keyring of signer2153 * @param collectionId ID of collection2154 * @param owner tokens owner2155 * @param tokens array of tokens with properties and pieces2156 * @returns ```true``` if extrinsic success, otherwise ```false```2157 */2158 async mintMultipleTokensWithOneOwner(signer: TSigner, collectionId: number, tokens: { value: bigint }[], owner: ICrossAccountId): Promise<boolean> {2159 const rawTokens = [];2160 for(const token of tokens) {2161 const raw = {Fungible: {Value: token.value}};2162 rawTokens.push(raw);2163 }2164 const creationResult = await this.helper.executeExtrinsic(2165 signer,2166 'api.tx.unique.createMultipleItems', [collectionId, owner, rawTokens],2167 true,2168 );2169 return this.helper.util.findCollectionInEvents(creationResult.result.events, collectionId, 'common', 'ItemCreated');2170 }21712172 /**2173 * Get the top 10 owners with the largest balance for the Fungible collection2174 * @param collectionId ID of collection2175 * @example getTop10Owners(10);2176 * @returns array of ```ICrossAccountId```2177 */2178 async getTop10Owners(collectionId: number): Promise<CrossAccountId[]> {2179 return (await this.helper.callRpc('api.rpc.unique.tokenOwners', [collectionId, 0])).toJSON().map(CrossAccountId.fromLowerCaseKeys);2180 }21812182 /**2183 * Get account balance2184 * @param collectionId ID of collection2185 * @param addressObj address of owner2186 * @example getBalance(10, {Substrate: "5GHoZe9c73RYbVzq..."})2187 * @returns amount of fungible tokens owned by address2188 */2189 async getBalance(collectionId: number, addressObj: ICrossAccountId): Promise<bigint> {2190 return (await this.helper.callRpc('api.rpc.unique.balance', [collectionId, addressObj, 0])).toBigInt();2191 }21922193 /**2194 * Transfer tokens to address2195 * @param signer keyring of signer2196 * @param collectionId ID of collection2197 * @param toAddressObj address recipient2198 * @param amount amount of tokens to be sent2199 * @example transfer(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n);2200 * @returns ```true``` if extrinsic success, otherwise ```false```2201 */2202 async transfer(signer: TSigner, collectionId: number, toAddressObj: ICrossAccountId, amount = 1n) {2203 return await super.transferToken(signer, collectionId, 0, toAddressObj, amount);2204 }22052206 /**2207 * Transfer some tokens on behalf of the owner.2208 * @param signer keyring of signer2209 * @param collectionId ID of collection2210 * @param fromAddressObj address on behalf of which tokens will be sent2211 * @param toAddressObj address where token to be sent2212 * @param amount number of tokens to be sent2213 * @example transferFrom(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, {Substrate: "5DfhbVfww7ThF8q6f3ij..."}, 10000n);2214 * @returns ```true``` if extrinsic success, otherwise ```false```2215 */2216 async transferFrom(signer: TSigner, collectionId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {2217 return await super.transferTokenFrom(signer, collectionId, 0, fromAddressObj, toAddressObj, amount);2218 }22192220 /**2221 * Destroy some amount of tokens2222 * @param signer keyring of signer2223 * @param collectionId ID of collection2224 * @param amount amount of tokens to be destroyed2225 * @example burnTokens(aliceKeyring, 10, 1000n);2226 * @returns ```true``` if extrinsic success, otherwise ```false```2227 */2228 async burnTokens(signer: IKeyringPair, collectionId: number, amount = 1n): Promise<boolean> {2229 return await super.burnToken(signer, collectionId, 0, amount);2230 }22312232 /**2233 * Burn some tokens on behalf of the owner.2234 * @param signer keyring of signer2235 * @param collectionId ID of collection2236 * @param fromAddressObj address on behalf of which tokens will be burnt2237 * @param amount amount of tokens to be burnt2238 * @example burnTokensFrom(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n);2239 * @returns ```true``` if extrinsic success, otherwise ```false```2240 */2241 async burnTokensFrom(signer: IKeyringPair, collectionId: number, fromAddressObj: ICrossAccountId, amount = 1n): Promise<boolean> {2242 return await super.burnTokenFrom(signer, collectionId, 0, fromAddressObj, amount);2243 }22442245 /**2246 * Get total collection supply2247 * @param collectionId2248 * @returns2249 */2250 async getTotalPieces(collectionId: number): Promise<bigint> {2251 return (await this.helper.callRpc('api.rpc.unique.totalPieces', [collectionId, 0])).unwrap().toBigInt();2252 }22532254 /**2255 * Set, change, or remove approved address to transfer tokens.2256 *2257 * @param signer keyring of signer2258 * @param collectionId ID of collection2259 * @param toAddressObj address to be approved2260 * @param amount amount of tokens to be approved2261 * @example approveTokens(aliceKeyring, 10, {Substrate: "5GHoZe9c73RYbVzq..."}, 1000n)2262 * @returns ```true``` if extrinsic success, otherwise ```false```2263 */2264 approveTokens(signer: IKeyringPair, collectionId: number, toAddressObj: ICrossAccountId, amount = 1n) {2265 return super.approveToken(signer, collectionId, 0, toAddressObj, amount);2266 }22672268 /**2269 * Get amount of fungible tokens approved to transfer2270 * @param collectionId ID of collection2271 * @param fromAddressObj owner of tokens2272 * @param toAddressObj the address approved for the transfer of tokens on behalf of the owner2273 * @returns number of tokens approved for the transfer2274 */2275 getApprovedTokens(collectionId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {2276 return super.getTokenApprovedPieces(collectionId, 0, toAddressObj, fromAddressObj);2277 }2278}227922802281class ChainGroup extends HelperGroup<ChainHelperBase> {2282 /**2283 * Get system properties of a chain2284 * @example getChainProperties();2285 * @returns ss58Format, token decimals, and token symbol2286 */2287 getChainProperties(): IChainProperties {2288 const properties = (this.helper.getApi() as any).registry.getChainProperties().toJSON();2289 return {2290 ss58Format: properties.ss58Format.toJSON(),2291 tokenDecimals: properties.tokenDecimals.toJSON(),2292 tokenSymbol: properties.tokenSymbol.toJSON(),2293 };2294 }22952296 /**2297 * Get chain header2298 * @example getLatestBlockNumber();2299 * @returns the number of the last block2300 */2301 async getLatestBlockNumber(): Promise<number> {2302 return (await this.helper.callRpc('api.rpc.chain.getHeader')).number.toNumber();2303 }23042305 /**2306 * Get block hash by block number2307 * @param blockNumber number of block2308 * @example getBlockHashByNumber(12345);2309 * @returns hash of a block2310 */2311 async getBlockHashByNumber(blockNumber: number): Promise<string | null> {2312 const blockHash = (await this.helper.callRpc('api.rpc.chain.getBlockHash', [blockNumber])).toJSON();2313 if(blockHash === '0x0000000000000000000000000000000000000000000000000000000000000000') return null;2314 return blockHash;2315 }23162317 // TODO add docs2318 async getBlock(blockHashOrNumber: string | number): Promise<IBlock | null> {2319 const blockHash = typeof blockHashOrNumber === 'string' ? blockHashOrNumber : await this.getBlockHashByNumber(blockHashOrNumber);2320 if(!blockHash) return null;2321 return (await this.helper.callRpc('api.rpc.chain.getBlock', [blockHash])).toHuman().block;2322 }23232324 /**2325 * Get latest relay block2326 * @returns {number} relay block2327 */2328 async getRelayBlockNumber(): Promise<bigint> {2329 const blockNumber = (await this.helper.callRpc('api.query.parachainSystem.validationData')).toJSON().relayParentNumber;2330 return BigInt(blockNumber);2331 }23322333 /**2334 * Get account nonce2335 * @param address substrate address2336 * @example getNonce("5GrwvaEF5zXb26Fz...");2337 * @returns number, account's nonce2338 */2339 async getNonce(address: TSubstrateAccount): Promise<number> {2340 return (await this.helper.callRpc('api.query.system.account', [address])).nonce.toNumber();2341 }2342}23432344class SubstrateBalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2345 /**2346 * Get substrate address balance2347 * @param address substrate address2348 * @example getSubstrate("5GrwvaEF5zXb26Fz...")2349 * @returns amount of tokens on address2350 */2351 async getSubstrate(address: TSubstrateAccount): Promise<bigint> {2352 return (await this.helper.callRpc('api.query.system.account', [address])).data.free.toBigInt();2353 }23542355 /**2356 * Transfer tokens to substrate address2357 * @param signer keyring of signer2358 * @param address substrate address of a recipient2359 * @param amount amount of tokens to be transfered2360 * @example transferToSubstrate(aliceKeyring, "5GrwvaEF5zXb26Fz...", 100_000_000_000n);2361 * @returns ```true``` if extrinsic success, otherwise ```false```2362 */2363 async transferToSubstrate(signer: TSigner, address: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2364 const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.transfer', [address, amount], true/*, `Unable to transfer balance from ${this.helper.getSignerAddress(signer)} to ${address}`*/);23652366 let transfer = {from: null, to: null, amount: 0n} as any;2367 result.result.events.forEach(({event: {data, method, section}}) => {2368 if((section === 'balances') && (method === 'Transfer')) {2369 transfer = {2370 from: this.helper.address.normalizeSubstrate(data[0]),2371 to: this.helper.address.normalizeSubstrate(data[1]),2372 amount: BigInt(data[2]),2373 };2374 }2375 });2376 const isSuccess = this.helper.address.normalizeSubstrate(typeof signer === 'string' ? signer : signer.address) === transfer.from2377 && this.helper.address.normalizeSubstrate(address) === transfer.to2378 && BigInt(amount) === transfer.amount;2379 return isSuccess;2380 }23812382 /**2383 * Get full substrate balance including free, frozen, and reserved2384 * @param address substrate address2385 * @returns2386 */2387 async getSubstrateFull(address: TSubstrateAccount): Promise<ISubstrateBalance> {2388 const accountInfo = (await this.helper.callRpc('api.query.system.account', [address])).data;2389 return {free: accountInfo.free.toBigInt(), frozen: accountInfo.frozen.toBigInt(), reserved: accountInfo.reserved.toBigInt()};2390 }23912392 /**2393 * Get total issuance2394 * @returns2395 */2396 async getTotalIssuance(): Promise<bigint> {2397 const total = (await this.helper.callRpc('api.query.balances.totalIssuance', []));2398 return total.toBigInt();2399 }24002401 async getLocked(address: TSubstrateAccount): Promise<{ id: string, amount: bigint, reason: string }[]> {2402 const locks = (await this.helper.callRpc('api.query.balances.locks', [address])).toHuman();2403 return locks.map((lock: any) => ({id: lock.id, amount: BigInt(lock.amount.replace(/,/g, '')), reasons: lock.reasons}));2404 }2405 async getFrozen(address: TSubstrateAccount): Promise<{ id: string, amount: bigint }[]> {2406 const locks = await this.helper.api!.query.balances.freezes(address);2407 return locks.map(lock => ({id: lock.id.toUtf8(), amount: lock.amount.toBigInt()}));2408 }2409}24102411class EthereumBalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2412 /**2413 * Get ethereum address balance2414 * @param address ethereum address2415 * @example getEthereum("0x9F0583DbB855d...")2416 * @returns amount of tokens on address2417 */2418 async getEthereum(address: TEthereumAccount): Promise<bigint> {2419 return (await this.helper.callRpc('api.rpc.eth.getBalance', [address])).toBigInt();2420 }24212422 /**2423 * Transfer tokens to address2424 * @param signer keyring of signer2425 * @param address Ethereum address of a recipient2426 * @param amount amount of tokens to be transfered2427 * @example transferToEthereum(alithKeyring, "0x9F0583DbB855d...", 100_000_000_000n);2428 * @returns ```true``` if extrinsic success, otherwise ```false```2429 */2430 async transferToEthereum(signer: TSigner, address: TEthereumAccount, amount: bigint | string): Promise<boolean> {2431 const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.transfer', [address, amount], true);24322433 let transfer = {from: null, to: null, amount: 0n} as any;2434 result.result.events.forEach(({event: {data, method, section}}) => {2435 if((section === 'balances') && (method === 'Transfer')) {2436 transfer = {2437 from: data[0].toString(),2438 to: data[1].toString(),2439 amount: BigInt(data[2]),2440 };2441 }2442 });2443 const isSuccess = (typeof signer === 'string' ? signer : signer.address) === transfer.from2444 && address === transfer.to2445 && BigInt(amount) === transfer.amount;2446 return isSuccess;2447 }2448}24492450class BalanceGroup<T extends ChainHelperBase> extends HelperGroup<T> {2451 subBalanceGroup: SubstrateBalanceGroup<T>;2452 ethBalanceGroup: EthereumBalanceGroup<T>;24532454 constructor(helper: T) {2455 super(helper);2456 this.subBalanceGroup = new SubstrateBalanceGroup(helper);2457 this.ethBalanceGroup = new EthereumBalanceGroup(helper);2458 }24592460 getCollectionCreationPrice(): bigint {2461 return 2n * this.getOneTokenNominal();2462 }2463 /**2464 * Representation of the native token in the smallest unit - one OPAL (OPL), QUARTZ (QTZ), or UNIQUE (UNQ).2465 * @example getOneTokenNominal()2466 * @returns ```BigInt``` representation of the native token in the smallest unit, e.g. ```1_000_000_000_000_000_000n``` for QTZ.2467 */2468 getOneTokenNominal(): bigint {2469 const chainProperties = this.helper.chain.getChainProperties();2470 return 10n ** BigInt((chainProperties.tokenDecimals || [18])[0]);2471 }24722473 /**2474 * Get substrate address balance2475 * @param address substrate address2476 * @example getSubstrate("5GrwvaEF5zXb26Fz...")2477 * @returns amount of tokens on address2478 */2479 getSubstrate(address: TSubstrateAccount): Promise<bigint> {2480 return this.subBalanceGroup.getSubstrate(address);2481 }24822483 /**2484 * Get full substrate balance including free, miscFrozen, feeFrozen, and reserved2485 * @param address substrate address2486 * @returns2487 */2488 getSubstrateFull(address: TSubstrateAccount): Promise<ISubstrateBalance> {2489 return this.subBalanceGroup.getSubstrateFull(address);2490 }24912492 /**2493 * Get total issuance2494 * @returns2495 */2496 getTotalIssuance(): Promise<bigint> {2497 return this.subBalanceGroup.getTotalIssuance();2498 }24992500 /**2501 * Get locked balances2502 * @param address substrate address2503 * @returns locked balances with reason via api.query.balances.locks2504 * @deprecated all the methods should switch to getFrozen2505 */2506 getLocked(address: TSubstrateAccount) {2507 return this.subBalanceGroup.getLocked(address);2508 }25092510 /**2511 * Get frozen balances2512 * @param address substrate address2513 * @returns frozen balances with id via api.query.balances.freezes2514 */2515 getFrozen(address: TSubstrateAccount) {2516 return this.subBalanceGroup.getFrozen(address);2517 }25182519 /**2520 * Get ethereum address balance2521 * @param address ethereum address2522 * @example getEthereum("0x9F0583DbB855d...")2523 * @returns amount of tokens on address2524 */2525 getEthereum(address: TEthereumAccount): Promise<bigint> {2526 return this.ethBalanceGroup.getEthereum(address);2527 }25282529 async setBalanceSubstrate(signer: TSigner, address: TSubstrateAccount, amount: bigint) {2530 await this.helper.executeExtrinsic(signer, 'api.tx.balances.forceSetBalance', [address, amount], true);2531 }25322533 /**2534 * Transfer tokens to substrate address2535 * @param signer keyring of signer2536 * @param address substrate address of a recipient2537 * @param amount amount of tokens to be transfered2538 * @example transferToSubstrate(aliceKeyring, "5GrwvaEF5zXb26Fz...", 100_000_000_000n);2539 * @returns ```true``` if extrinsic success, otherwise ```false```2540 */2541 transferToSubstrate(signer: TSigner, address: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2542 return this.subBalanceGroup.transferToSubstrate(signer, address, amount);2543 }25442545 async forceTransferToSubstrate(signer: TSigner, from: TSubstrateAccount, to: TSubstrateAccount, amount: bigint | string): Promise<boolean> {2546 const result = await this.helper.executeExtrinsic(signer, 'api.tx.balances.forceTransfer', [from, to, amount], true);25472548 let transfer = {from: null, to: null, amount: 0n} as any;2549 result.result.events.forEach(({event: {data, method, section}}) => {2550 if((section === 'balances') && (method === 'Transfer')) {2551 transfer = {2552 from: this.helper.address.normalizeSubstrate(data[0]),2553 to: this.helper.address.normalizeSubstrate(data[1]),2554 amount: BigInt(data[2]),2555 };2556 }2557 });2558 let isSuccess = this.helper.address.normalizeSubstrate(from) === transfer.from;2559 isSuccess = isSuccess && this.helper.address.normalizeSubstrate(to) === transfer.to;2560 isSuccess = isSuccess && BigInt(amount) === transfer.amount;2561 return isSuccess;2562 }25632564 /**2565 * Transfer tokens with the unlock period2566 * @param signer signers Keyring2567 * @param address Substrate address of recipient2568 * @param schedule Schedule params2569 * @example vestedTransfer(signer, recepient.address, 20000, 100, 10, 50 * nominal); // total amount of vested tokens will be 100 * 50 = 50002570 */2571 async vestedTransfer(signer: TSigner, address: TSubstrateAccount, schedule: { start: bigint, period: bigint, periodCount: bigint, perPeriod: bigint }): Promise<void> {2572 const result = await this.helper.executeExtrinsic(signer, 'api.tx.vesting.vestedTransfer', [address, schedule]);2573 const event = result.result.events2574 .find(e => e.event.section === 'vesting' &&2575 e.event.method === 'VestingScheduleAdded' &&2576 e.event.data[0].toHuman() === signer.address);2577 if(!event) throw Error('Cannot find transfer in events');2578 }25792580 /**2581 * Get schedule for recepient of vested transfer2582 * @param address Substrate address of recipient2583 * @returns2584 */2585 async getVestingSchedules(address: TSubstrateAccount): Promise<{ start: bigint, period: bigint, periodCount: bigint, perPeriod: bigint }[]> {2586 const schedule = (await this.helper.callRpc('api.query.vesting.vestingSchedules', [address])).toJSON();2587 return schedule.map((schedule: any) => ({2588 start: BigInt(schedule.start),2589 period: BigInt(schedule.period),2590 periodCount: BigInt(schedule.periodCount),2591 perPeriod: BigInt(schedule.perPeriod),2592 }));2593 }25942595 /**2596 * Claim vested tokens2597 * @param signer signers Keyring2598 */2599 async claim(signer: TSigner) {2600 const result = await this.helper.executeExtrinsic(signer, 'api.tx.vesting.claim', []);2601 const event = result.result.events2602 .find(e => e.event.section === 'vesting' &&2603 e.event.method === 'Claimed' &&2604 e.event.data[0].toHuman() === signer.address);2605 if(!event) throw Error('Cannot find claim in events');2606 }2607}26082609class AddressGroup extends HelperGroup<ChainHelperBase> {2610 /**2611 * Normalizes the address to the specified ss58 format, by default ```42```.2612 * @param address substrate address2613 * @param ss58Format format for address conversion, by default ```42```2614 * @example normalizeSubstrate("unjKJQJrRd238pkUZZvzDQrfKuM39zBSnQ5zjAGAGcdRhaJTx") // returns 5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY2615 * @returns substrate address converted to normalized (i.e., starting with 5) or specified explicitly representation2616 */2617 normalizeSubstrate(address: TSubstrateAccount, ss58Format = 42): TSubstrateAccount {2618 return CrossAccountId.normalizeSubstrateAddress(address, ss58Format);2619 }26202621 /**2622 * Get address in the connected chain format2623 * @param address substrate address2624 * @example normalizeSubstrateToChainFormat("5GrwvaEF5zXb26Fz...") // returns unjKJQJrRd238pkUZZ... for Unique Network2625 * @returns address in chain format2626 */2627 normalizeSubstrateToChainFormat(address: TSubstrateAccount): TSubstrateAccount {2628 return this.normalizeSubstrate(address, this.helper.chain.getChainProperties().ss58Format);2629 }26302631 /**2632 * Get substrate mirror of an ethereum address2633 * @param ethAddress ethereum address2634 * @param toChainFormat false for normalized account2635 * @example ethToSubstrate('0x9F0583DbB855d...')2636 * @returns substrate mirror of a provided ethereum address2637 */2638 ethToSubstrate(ethAddress: TEthereumAccount, toChainFormat = false): TSubstrateAccount {2639 return CrossAccountId.translateEthToSub(ethAddress, toChainFormat ? this.helper.chain.getChainProperties().ss58Format : undefined);2640 }26412642 /**2643 * Get ethereum mirror of a substrate address2644 * @param subAddress substrate account2645 * @example substrateToEth("5DnSF6RRjwteE3BrC...")2646 * @returns ethereum mirror of a provided substrate address2647 */2648 substrateToEth(subAddress: TSubstrateAccount): TEthereumAccount {2649 return CrossAccountId.translateSubToEth(subAddress);2650 }26512652 /**2653 * Encode key to substrate address2654 * @param key key for encoding address2655 * @param ss58Format prefix for encoding to the address of the corresponding network2656 * @returns encoded substrate address2657 */2658 encodeSubstrateAddress(key: Uint8Array | string | bigint, ss58Format = 42): string {2659 const u8a: Uint8Array = typeof key === 'string'2660 ? hexToU8a(key)2661 : typeof key === 'bigint'2662 ? hexToU8a(key.toString(16))2663 : key;26642665 if(ss58Format < 0 || ss58Format > 16383 || [46, 47].includes(ss58Format)) {2666 throw new Error(`ss58Format is not valid, received ${typeofss58Format} "${ss58Format}"`);2667 }26682669 const allowedDecodedLengths = [1, 2, 4, 8, 32, 33];2670 if(!allowedDecodedLengths.includes(u8a.length)) {2671 throw new Error(`key length is not valid, received ${u8a.length}, valid values are ${allowedDecodedLengths.join(', ')}`);2672 }26732674 const u8aPrefix = ss58Format < 642675 ? new Uint8Array([ss58Format])2676 : new Uint8Array([2677 ((ss58Format & 0xfc) >> 2) | 0x40,2678 (ss58Format >> 8) | ((ss58Format & 0x03) << 6),2679 ]);26802681 const input = u8aConcat(u8aPrefix, u8a);26822683 return base58Encode(u8aConcat(2684 input,2685 blake2AsU8a(input).subarray(0, [32, 33].includes(u8a.length) ? 2 : 1),2686 ));2687 }26882689 /**2690 * Restore substrate address from bigint representation2691 * @param number decimal representation of substrate address2692 * @returns substrate address2693 */2694 restoreCrossAccountFromBigInt(number: bigint): TSubstrateAccount {2695 if(this.helper.api === null) {2696 throw 'Not connected';2697 }2698 const res = this.helper.api.registry.createType('AccountId', '0x' + number.toString(16).padStart(64, '0')).toJSON();2699 if(res === undefined || res === null) {2700 throw 'Restore address error';2701 }2702 return res.toString();2703 }27042705 /**2706 * Convert etherium cross account id to substrate cross account id2707 * @param ethCrossAccount etherium cross account2708 * @returns substrate cross account id2709 */2710 convertCrossAccountFromEthCrossAccount(ethCrossAccount: IEthCrossAccountId): ICrossAccountId {2711 if(ethCrossAccount.sub === '0') {2712 return {Ethereum: ethCrossAccount.eth.toLocaleLowerCase()};2713 }27142715 const ss58 = this.restoreCrossAccountFromBigInt(BigInt(ethCrossAccount.sub));2716 return {Substrate: ss58};2717 }27182719 paraSiblingSovereignAccount(paraid: number) {2720 // We are getting a *sibling* parachain sovereign account,2721 // so we need a sibling prefix: encoded(b"sibl") == 0x7369626c2722 const siblingPrefix = '0x7369626c';27232724 const encodedParaId = this.helper.getApi().createType('u32', paraid).toHex(true).substring(2);2725 const suffix = '000000000000000000000000000000000000000000000000';27262727 return siblingPrefix + encodedParaId + suffix;2728 }2729}27302731class StakingGroup extends HelperGroup<UniqueHelper> {2732 /**2733 * Stake tokens for App Promotion2734 * @param signer keyring of signer2735 * @param amountToStake amount of tokens to stake2736 * @param label extra label for log2737 * @returns2738 */2739 async stake(signer: TSigner, amountToStake: bigint, label?: string): Promise<boolean> {2740 if(typeof label === 'undefined') label = `${signer.address} amount: ${amountToStake}`;2741 const _stakeResult = await this.helper.executeExtrinsic(2742 signer, 'api.tx.appPromotion.stake',2743 [amountToStake], true,2744 );2745 // TODO extract info from stakeResult2746 return true;2747 }27482749 /**2750 * Unstake all staked tokens2751 * @param signer keyring of signer2752 * @param amountToUnstake amount of tokens to unstake2753 * @param label extra label for log2754 * @returns block hash where unstake happened2755 */2756 async unstakeAll(signer: TSigner, label?: string): Promise<string> {2757 if(typeof label === 'undefined') label = `${signer.address}`;2758 const unstakeResult = await this.helper.executeExtrinsic(2759 signer, 'api.tx.appPromotion.unstakeAll',2760 [], true,2761 );2762 return unstakeResult.blockHash;2763 }27642765 /**2766 * Unstake the part of a staked tokens2767 * @param signer keyring of signer2768 * @param amount amount of tokens to unstake2769 * @param label extra label for log2770 * @returns block hash where unstake happened2771 */2772 async unstakePartial(signer: TSigner, amount: bigint, label?: string): Promise<string> {2773 if(typeof label === 'undefined') label = `${signer.address}`;2774 const unstakeResult = await this.helper.executeExtrinsic(2775 signer, 'api.tx.appPromotion.unstakePartial',2776 [amount], true,2777 );2778 return unstakeResult.blockHash;2779 }27802781 /**2782 * Get total number of active stakes2783 * @param address substrate address2784 * @returns {number}2785 */2786 async getStakesNumber(address: ICrossAccountId): Promise<number> {2787 if('Ethereum' in address) throw Error('only substrate address');2788 return (await this.helper.callRpc('api.query.appPromotion.stakesPerAccount', [address.Substrate])).toNumber();2789 }27902791 /**2792 * Get total staked amount for address2793 * @param address substrate or ethereum address2794 * @returns total staked amount2795 */2796 async getTotalStaked(address?: ICrossAccountId): Promise<bigint> {2797 if(address) return (await this.helper.callRpc('api.rpc.appPromotion.totalStaked', [address])).toBigInt();2798 return (await this.helper.callRpc('api.rpc.appPromotion.totalStaked')).toBigInt();2799 }28002801 /**2802 * Get total staked per block2803 * @param address substrate or ethereum address2804 * @returns array of stakes. `block` – the number of the block in which the stake was made. `amount` - the number of tokens staked in the block2805 */2806 async getTotalStakedPerBlock(address: ICrossAccountId): Promise<IStakingInfo[]> {2807 const rawTotalStakerdPerBlock = await this.helper.callRpc('api.rpc.appPromotion.totalStakedPerBlock', [address]);2808 return rawTotalStakerdPerBlock.map(([block, amount]: any[]) => ({2809 block: block.toBigInt(),2810 amount: amount.toBigInt(),2811 }));2812 }28132814 /**2815 * Get total pending unstake amount for address2816 * @param address substrate or ethereum address2817 * @returns total pending unstake amount2818 */2819 async getPendingUnstake(address: ICrossAccountId): Promise<bigint> {2820 return (await this.helper.callRpc('api.rpc.appPromotion.pendingUnstake', [address])).toBigInt();2821 }28222823 /**2824 * Get pending unstake amount per block for address2825 * @param address substrate or ethereum address2826 * @returns array of pending stakes. `block` – the number of the block in which the unstake was made. `amount` - the number of tokens unstaked in the block2827 */2828 async getPendingUnstakePerBlock(address: ICrossAccountId): Promise<IStakingInfo[]> {2829 const rawUnstakedPerBlock = await this.helper.callRpc('api.rpc.appPromotion.pendingUnstakePerBlock', [address]);2830 const result = rawUnstakedPerBlock.map(([block, amount]: any[]) => ({2831 block: block.toBigInt(),2832 amount: amount.toBigInt(),2833 }));2834 return result;2835 }2836}28372838class SchedulerGroup extends HelperGroup<UniqueHelper> {2839 constructor(helper: UniqueHelper) {2840 super(helper);2841 }28422843 cancelScheduled(signer: TSigner, scheduledId: string) {2844 return this.helper.executeExtrinsic(2845 signer,2846 'api.tx.scheduler.cancelNamed',2847 [scheduledId],2848 true,2849 );2850 }28512852 changePriority(signer: TSigner, scheduledId: string, priority: number) {2853 return this.helper.executeExtrinsic(2854 signer,2855 'api.tx.scheduler.changeNamedPriority',2856 [scheduledId, priority],2857 true,2858 );2859 }28602861 scheduleAt<T extends UniqueHelper>(2862 executionBlockNumber: number,2863 options: ISchedulerOptions = {},2864 ) {2865 return this.schedule<T>('schedule', executionBlockNumber, options);2866 }28672868 scheduleAfter<T extends UniqueHelper>(2869 blocksBeforeExecution: number,2870 options: ISchedulerOptions = {},2871 ) {2872 return this.schedule<T>('scheduleAfter', blocksBeforeExecution, options);2873 }28742875 schedule<T extends UniqueHelper>(2876 scheduleFn: 'schedule' | 'scheduleAfter',2877 blocksNum: number,2878 options: ISchedulerOptions = {},2879 ) {2880 // eslint-disable-next-line @typescript-eslint/naming-convention2881 const ScheduledHelperType = ScheduledUniqueHelper(this.helper.helperBase);2882 return this.helper.clone(ScheduledHelperType, {2883 scheduleFn,2884 blocksNum,2885 options,2886 }) as T;2887 }2888}28892890class CollatorSelectionGroup extends HelperGroup<UniqueHelper> {2891 //todo:collator documentation2892 addInvulnerable(signer: TSigner, address: string) {2893 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.addInvulnerable', [address]);2894 }28952896 removeInvulnerable(signer: TSigner, address: string) {2897 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.removeInvulnerable', [address]);2898 }28992900 async getInvulnerables(): Promise<string[]> {2901 return (await this.helper.callRpc('api.query.collatorSelection.invulnerables')).map((x: any) => x.toHuman());2902 }29032904 /** and also total max invulnerables */2905 maxCollators(): number {2906 return (this.helper.getApi().consts.configuration.defaultCollatorSelectionMaxCollators.toJSON() as number);2907 }29082909 async getDesiredCollators(): Promise<number> {2910 return (await this.helper.callRpc('api.query.configuration.collatorSelectionDesiredCollatorsOverride')).toNumber();2911 }29122913 setLicenseBond(signer: TSigner, amount: bigint) {2914 return this.helper.executeExtrinsic(signer, 'api.tx.configuration.setCollatorSelectionLicenseBond', [amount]);2915 }29162917 async getLicenseBond(): Promise<bigint> {2918 return (await this.helper.callRpc('api.query.configuration.collatorSelectionLicenseBondOverride')).toBigInt();2919 }29202921 obtainLicense(signer: TSigner) {2922 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.getLicense', []);2923 }29242925 releaseLicense(signer: TSigner) {2926 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.releaseLicense', []);2927 }29282929 forceReleaseLicense(signer: TSigner, released: string) {2930 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.forceReleaseLicense', [released]);2931 }29322933 async hasLicense(address: string): Promise<bigint> {2934 return (await this.helper.callRpc('api.query.collatorSelection.licenseDepositOf', [address])).toBigInt();2935 }29362937 onboard(signer: TSigner) {2938 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.onboard', []);2939 }29402941 offboard(signer: TSigner) {2942 return this.helper.executeExtrinsic(signer, 'api.tx.collatorSelection.offboard', []);2943 }29442945 async getCandidates(): Promise<string[]> {2946 return (await this.helper.callRpc('api.query.collatorSelection.candidates')).map((x: any) => x.toHuman());2947 }2948}29492950class PreimageGroup extends HelperGroup<UniqueHelper> {2951 async getPreimageInfo(h256: string) {2952 return (await this.helper.callRpc('api.query.preimage.statusFor', [h256])).toJSON();2953 }29542955 /**2956 * Create a preimage with a hex or a byte array.2957 * @param signer keyring of the signer.2958 * @param bytes preimage encoded in hex or a byte array, e.g. an extrinsic call.2959 * @example await notePreimage(preimageMaker,2960 * helper.constructApiCall('api.tx.identity.forceInsertIdentities', [identitiesToAdd]).method.toHex()2961 * );2962 * @returns promise of extrinsic execution.2963 */2964 notePreimage(signer: TSigner, bytes: string | Uint8Array) {2965 return this.helper.executeExtrinsic(signer, 'api.tx.preimage.notePreimage', [bytes]);2966 }29672968 /**2969 * Delete an existing preimage and return the deposit.2970 * @param signer keyring of the signer - either the owner or the preimage manager (sudo).2971 * @param h256 hash of the preimage.2972 * @returns promise of extrinsic execution.2973 */2974 unnotePreimage(signer: TSigner, h256: string) {2975 return this.helper.executeExtrinsic(signer, 'api.tx.preimage.unnotePreimage', [h256]);2976 }29772978 /**2979 * Request a preimage be uploaded to the chain without paying any fees or deposits.2980 * @param signer keyring of the signer - either the owner or the preimage manager (sudo).2981 * @param h256 hash of the preimage.2982 * @returns promise of extrinsic execution.2983 */2984 requestPreimage(signer: TSigner, h256: string) {2985 return this.helper.executeExtrinsic(signer, 'api.tx.preimage.requestPreimage', [h256]);2986 }29872988 /**2989 * Clear a previously made request for a preimage.2990 * @param signer keyring of the signer - either the owner or the preimage manager (sudo).2991 * @param h256 hash of the preimage.2992 * @returns promise of extrinsic execution.2993 */2994 unrequestPreimage(signer: TSigner, h256: string) {2995 return this.helper.executeExtrinsic(signer, 'api.tx.preimage.unrequestPreimage', [h256]);2996 }2997}29982999class ForeignAssetsGroup extends HelperGroup<UniqueHelper> {3000 async register(signer: TSigner, ownerAddress: TSubstrateAccount, location: any, metadata: IForeignAssetMetadata) {3001 await this.helper.executeExtrinsic(3002 signer,3003 'api.tx.foreignAssets.registerForeignAsset',3004 [ownerAddress, location, metadata],3005 true,3006 );3007 }30083009 async update(signer: TSigner, foreignAssetId: number, location: any, metadata: IForeignAssetMetadata) {3010 await this.helper.executeExtrinsic(3011 signer,3012 'api.tx.foreignAssets.updateForeignAsset',3013 [foreignAssetId, location, metadata],3014 true,3015 );3016 }3017}30183019class XcmGroup<T extends ChainHelperBase> extends HelperGroup<T> {3020 palletName: string;30213022 constructor(helper: T, palletName: string) {3023 super(helper);30243025 this.palletName = palletName;3026 }30273028 async limitedReserveTransferAssets(signer: TSigner, destination: any, beneficiary: any, assets: any, feeAssetItem: number, weightLimit: any) {3029 await this.helper.executeExtrinsic(signer, `api.tx.${this.palletName}.limitedReserveTransferAssets`, [destination, beneficiary, assets, feeAssetItem, weightLimit], true);3030 }30313032 async setSafeXcmVersion(signer: TSigner, version: number) {3033 await this.helper.executeExtrinsic(signer, `api.tx.${this.palletName}.forceDefaultXcmVersion`, [version], true);3034 }30353036 async teleportAssets(signer: TSigner, destination: any, beneficiary: any, assets: any, feeAssetItem: number) {3037 await this.helper.executeExtrinsic(signer, `api.tx.${this.palletName}.teleportAssets`, [destination, beneficiary, assets, feeAssetItem], true);3038 }30393040 async teleportNativeAsset(signer: TSigner, destinationParaId: number, targetAccount: Uint8Array, amount: bigint, xcmVersion = 3) {3041 const destinationContent = {3042 parents: 0,3043 interior: {3044 X1: {3045 Parachain: destinationParaId,3046 },3047 },3048 };30493050 const beneficiaryContent = {3051 parents: 0,3052 interior: {3053 X1: {3054 AccountId32: {3055 network: 'Any',3056 id: targetAccount,3057 },3058 },3059 },3060 };30613062 const assetsContent = [3063 {3064 id: {3065 Concrete: {3066 parents: 0,3067 interior: 'Here',3068 },3069 },3070 fun: {3071 Fungible: amount,3072 },3073 },3074 ];30753076 let destination;3077 let beneficiary;3078 let assets;30793080 if(xcmVersion == 2) {3081 destination = {V1: destinationContent};3082 beneficiary = {V1: beneficiaryContent};3083 assets = {V1: assetsContent};30843085 } else if(xcmVersion == 3) {3086 destination = {V2: destinationContent};3087 beneficiary = {V2: beneficiaryContent};3088 assets = {V2: assetsContent};30893090 } else {3091 throw Error('Unknown XCM version: ' + xcmVersion);3092 }30933094 const feeAssetItem = 0;30953096 await this.teleportAssets(signer, destination, beneficiary, assets, feeAssetItem);3097 }30983099 async send(signer: IKeyringPair, destination: any, message: any) {3100 await this.helper.executeExtrinsic(3101 signer,3102 `api.tx.${this.palletName}.send`,3103 [3104 destination,3105 message,3106 ],3107 true,3108 );3109 }3110}31113112class XTokensGroup<T extends ChainHelperBase> extends HelperGroup<T> {3113 async transfer(signer: TSigner, currencyId: any, amount: bigint, destination: any, destWeight: any) {3114 await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transfer', [currencyId, amount, destination, destWeight], true);3115 }31163117 async transferMultiasset(signer: TSigner, asset: any, destination: any, destWeight: any) {3118 await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transferMultiasset', [asset, destination, destWeight], true);3119 }31203121 async transferMulticurrencies(signer: TSigner, currencies: any[], feeItem: number, destLocation: any, destWeight: any) {3122 await this.helper.executeExtrinsic(signer, 'api.tx.xTokens.transferMulticurrencies', [currencies, feeItem, destLocation, destWeight], true);3123 }3124}31253126class TokensGroup<T extends ChainHelperBase> extends HelperGroup<T> {3127 async accounts(address: string, currencyId: any) {3128 const {free} = (await this.helper.callRpc('api.query.tokens.accounts', [address, currencyId])).toJSON() as any;3129 return BigInt(free);3130 }3131}31323133class AssetsGroup<T extends ChainHelperBase> extends HelperGroup<T> {3134 async create(signer: TSigner, assetId: number, admin: string, minimalBalance: bigint) {3135 await this.helper.executeExtrinsic(signer, 'api.tx.assets.create', [assetId, admin, minimalBalance], true);3136 }31373138 async setMetadata(signer: TSigner, assetId: number, name: string, symbol: string, decimals: number) {3139 await this.helper.executeExtrinsic(signer, 'api.tx.assets.setMetadata', [assetId, name, symbol, decimals], true);3140 }31413142 async mint(signer: TSigner, assetId: number, beneficiary: string, amount: bigint) {3143 await this.helper.executeExtrinsic(signer, 'api.tx.assets.mint', [assetId, beneficiary, amount], true);3144 }31453146 async account(assetId: string | number, address: string) {3147 const accountAsset = (3148 await this.helper.callRpc('api.query.assets.account', [assetId, address])3149 ).toJSON()! as any;31503151 if(accountAsset !== null) {3152 return BigInt(accountAsset['balance']);3153 } else {3154 return null;3155 }3156 }3157}31583159class AcalaAssetRegistryGroup extends HelperGroup<AcalaHelper> {3160 async registerForeignAsset(signer: TSigner, destination: any, metadata: AcalaAssetMetadata) {3161 await this.helper.executeExtrinsic(signer, 'api.tx.assetRegistry.registerForeignAsset', [destination, metadata], true);3162 }3163}31643165class MoonbeamAssetManagerGroup extends HelperGroup<MoonbeamHelper> {3166 makeRegisterForeignAssetProposal(assetInfo: MoonbeamAssetInfo) {3167 const apiPrefix = 'api.tx.assetManager.';31683169 const registerTx = this.helper.constructApiCall(3170 apiPrefix + 'registerForeignAsset',3171 [assetInfo.location, assetInfo.metadata, assetInfo.existentialDeposit, assetInfo.isSufficient],3172 );31733174 const setUnitsTx = this.helper.constructApiCall(3175 apiPrefix + 'setAssetUnitsPerSecond',3176 [assetInfo.location, assetInfo.unitsPerSecond, assetInfo.numAssetsWeightHint],3177 );31783179 const batchCall = this.helper.getApi().tx.utility.batchAll([registerTx, setUnitsTx]);3180 const encodedProposal = batchCall?.method.toHex() || '';3181 return encodedProposal;3182 }31833184 async assetTypeId(location: any) {3185 return await this.helper.callRpc('api.query.assetManager.assetTypeId', [location]);3186 }3187}31883189class MoonbeamDemocracyGroup extends HelperGroup<MoonbeamHelper> {3190 notePreimagePallet: string;31913192 constructor(helper: MoonbeamHelper, options: { [key: string]: any } = {}) {3193 super(helper);3194 this.notePreimagePallet = options.notePreimagePallet;3195 }31963197 async notePreimage(signer: TSigner, encodedProposal: string) {3198 await this.helper.executeExtrinsic(signer, `api.tx.${this.notePreimagePallet}.notePreimage`, [encodedProposal], true);3199 }32003201 externalProposeMajority(proposal: any) {3202 return this.helper.constructApiCall('api.tx.democracy.externalProposeMajority', [proposal]);3203 }32043205 fastTrack(proposalHash: string, votingPeriod: number, delayPeriod: number) {3206 return this.helper.constructApiCall('api.tx.democracy.fastTrack', [proposalHash, votingPeriod, delayPeriod]);3207 }32083209 async referendumVote(signer: TSigner, referendumIndex: number, accountVote: DemocracyStandardAccountVote) {3210 await this.helper.executeExtrinsic(signer, 'api.tx.democracy.vote', [referendumIndex, {Standard: accountVote}], true);3211 }3212}32133214class MoonbeamCollectiveGroup extends HelperGroup<MoonbeamHelper> {3215 collective: string;32163217 constructor(helper: MoonbeamHelper, collective: string) {3218 super(helper);32193220 this.collective = collective;3221 }32223223 async propose(signer: TSigner, threshold: number, proposalHash: string, lengthBound: number) {3224 await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.propose`, [threshold, proposalHash, lengthBound], true);3225 }32263227 async vote(signer: TSigner, proposalHash: string, proposalIndex: number, approve: boolean) {3228 await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.vote`, [proposalHash, proposalIndex, approve], true);3229 }32303231 async close(signer: TSigner, proposalHash: string, proposalIndex: number, weightBound: any, lengthBound: number) {3232 await this.helper.executeExtrinsic(signer, `api.tx.${this.collective}.close`, [proposalHash, proposalIndex, weightBound, lengthBound], true);3233 }32343235 async proposalCount() {3236 return Number(await this.helper.callRpc(`api.query.${this.collective}.proposalCount`, []));3237 }3238}32393240export type ChainHelperBaseConstructor = new (...args: any[]) => ChainHelperBase;3241export type UniqueHelperConstructor = new (...args: any[]) => UniqueHelper;32423243export class UniqueHelper extends ChainHelperBase {3244 balance: BalanceGroup<UniqueHelper>;3245 collection: CollectionGroup;3246 nft: NFTGroup;3247 rft: RFTGroup;3248 ft: FTGroup;3249 staking: StakingGroup;3250 scheduler: SchedulerGroup;3251 collatorSelection: CollatorSelectionGroup;3252 preimage: PreimageGroup;3253 foreignAssets: ForeignAssetsGroup;3254 xcm: XcmGroup<UniqueHelper>;3255 xTokens: XTokensGroup<UniqueHelper>;3256 tokens: TokensGroup<UniqueHelper>;32573258 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3259 super(logger, options.helperBase ?? UniqueHelper);32603261 this.balance = new BalanceGroup(this);3262 this.collection = new CollectionGroup(this);3263 this.nft = new NFTGroup(this);3264 this.rft = new RFTGroup(this);3265 this.ft = new FTGroup(this);3266 this.staking = new StakingGroup(this);3267 this.scheduler = new SchedulerGroup(this);3268 this.collatorSelection = new CollatorSelectionGroup(this);3269 this.preimage = new PreimageGroup(this);3270 this.foreignAssets = new ForeignAssetsGroup(this);3271 this.xcm = new XcmGroup(this, 'polkadotXcm');3272 this.xTokens = new XTokensGroup(this);3273 this.tokens = new TokensGroup(this);3274 }32753276 getSudo<T extends UniqueHelper>() {3277 // eslint-disable-next-line @typescript-eslint/naming-convention3278 const SudoHelperType = SudoHelper(this.helperBase);3279 return this.clone(SudoHelperType) as T;3280 }3281}32823283export class XcmChainHelper extends ChainHelperBase {3284 async connect(wsEndpoint: string, _listeners?: any): Promise<void> {3285 const wsProvider = new WsProvider(wsEndpoint);3286 this.api = new ApiPromise({3287 provider: wsProvider,3288 });3289 await this.api.isReadyOrError;3290 this.network = await UniqueHelper.detectNetwork(this.api);3291 }3292}32933294export class RelayHelper extends XcmChainHelper {3295 balance: SubstrateBalanceGroup<RelayHelper>;3296 xcm: XcmGroup<RelayHelper>;32973298 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3299 super(logger, options.helperBase ?? RelayHelper);33003301 this.balance = new SubstrateBalanceGroup(this);3302 this.xcm = new XcmGroup(this, 'xcmPallet');3303 }3304}33053306export class WestmintHelper extends XcmChainHelper {3307 balance: SubstrateBalanceGroup<WestmintHelper>;3308 xcm: XcmGroup<WestmintHelper>;3309 assets: AssetsGroup<WestmintHelper>;3310 xTokens: XTokensGroup<WestmintHelper>;33113312 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3313 super(logger, options.helperBase ?? WestmintHelper);33143315 this.balance = new SubstrateBalanceGroup(this);3316 this.xcm = new XcmGroup(this, 'polkadotXcm');3317 this.assets = new AssetsGroup(this);3318 this.xTokens = new XTokensGroup(this);3319 }3320}33213322export class MoonbeamHelper extends XcmChainHelper {3323 balance: EthereumBalanceGroup<MoonbeamHelper>;3324 assetManager: MoonbeamAssetManagerGroup;3325 assets: AssetsGroup<MoonbeamHelper>;3326 xTokens: XTokensGroup<MoonbeamHelper>;3327 democracy: MoonbeamDemocracyGroup;3328 collective: {3329 council: MoonbeamCollectiveGroup,3330 techCommittee: MoonbeamCollectiveGroup,3331 };33323333 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3334 super(logger, options.helperBase ?? MoonbeamHelper);33353336 this.balance = new EthereumBalanceGroup(this);3337 this.assetManager = new MoonbeamAssetManagerGroup(this);3338 this.assets = new AssetsGroup(this);3339 this.xTokens = new XTokensGroup(this);3340 this.democracy = new MoonbeamDemocracyGroup(this, options);3341 this.collective = {3342 council: new MoonbeamCollectiveGroup(this, 'councilCollective'),3343 techCommittee: new MoonbeamCollectiveGroup(this, 'techCommitteeCollective'),3344 };3345 }3346}33473348export class AstarHelper extends XcmChainHelper {3349 balance: SubstrateBalanceGroup<AstarHelper>;3350 assets: AssetsGroup<AstarHelper>;3351 xcm: XcmGroup<AstarHelper>;33523353 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3354 super(logger, options.helperBase ?? AstarHelper);33553356 this.balance = new SubstrateBalanceGroup(this);3357 this.assets = new AssetsGroup(this);3358 this.xcm = new XcmGroup(this, 'polkadotXcm');3359 }33603361 getSudo<T extends UniqueHelper>() {3362 // eslint-disable-next-line @typescript-eslint/naming-convention3363 const SudoHelperType = SudoHelper(this.helperBase);3364 return this.clone(SudoHelperType) as T;3365 }3366}33673368export class AcalaHelper extends XcmChainHelper {3369 balance: SubstrateBalanceGroup<AcalaHelper>;3370 assetRegistry: AcalaAssetRegistryGroup;3371 xTokens: XTokensGroup<AcalaHelper>;3372 tokens: TokensGroup<AcalaHelper>;3373 xcm: XcmGroup<AcalaHelper>;33743375 constructor(logger?: ILogger, options: { [key: string]: any } = {}) {3376 super(logger, options.helperBase ?? AcalaHelper);33773378 this.balance = new SubstrateBalanceGroup(this);3379 this.assetRegistry = new AcalaAssetRegistryGroup(this);3380 this.xTokens = new XTokensGroup(this);3381 this.tokens = new TokensGroup(this);3382 this.xcm = new XcmGroup(this, 'polkadotXcm');3383 }33843385 getSudo<T extends AcalaHelper>() {3386 // eslint-disable-next-line @typescript-eslint/naming-convention3387 const SudoHelperType = SudoHelper(this.helperBase);3388 return this.clone(SudoHelperType) as T;3389 }3390}33913392// eslint-disable-next-line @typescript-eslint/naming-convention3393function ScheduledUniqueHelper<T extends UniqueHelperConstructor>(Base: T) {3394 return class extends Base {3395 scheduleFn: 'schedule' | 'scheduleAfter';3396 blocksNum: number;3397 options: ISchedulerOptions;33983399 constructor(...args: any[]) {3400 const logger = args[0] as ILogger;3401 const options = args[1] as {3402 scheduleFn: 'schedule' | 'scheduleAfter',3403 blocksNum: number,3404 options: ISchedulerOptions3405 };34063407 super(logger);34083409 this.scheduleFn = options.scheduleFn;3410 this.blocksNum = options.blocksNum;3411 this.options = options.options;3412 }34133414 executeExtrinsic(sender: IKeyringPair, scheduledExtrinsic: string, scheduledParams: any[], expectSuccess?: boolean): Promise<ITransactionResult> {3415 const scheduledTx = this.constructApiCall(scheduledExtrinsic, scheduledParams);34163417 const mandatorySchedArgs = [3418 this.blocksNum,3419 this.options.periodic ? [this.options.periodic.period, this.options.periodic.repetitions] : null,3420 this.options.priority ?? null,3421 scheduledTx,3422 ];34233424 let schedArgs;3425 let scheduleFn;34263427 if(this.options.scheduledId) {3428 schedArgs = [this.options.scheduledId!, ...mandatorySchedArgs];34293430 if(this.scheduleFn == 'schedule') {3431 scheduleFn = 'scheduleNamed';3432 } else if(this.scheduleFn == 'scheduleAfter') {3433 scheduleFn = 'scheduleNamedAfter';3434 }3435 } else {3436 schedArgs = mandatorySchedArgs;3437 scheduleFn = this.scheduleFn;3438 }34393440 const extrinsic = 'api.tx.scheduler.' + scheduleFn;34413442 return super.executeExtrinsic(3443 sender,3444 extrinsic as any,3445 schedArgs,3446 expectSuccess,3447 );3448 }3449 };3450}34513452// eslint-disable-next-line @typescript-eslint/naming-convention3453function SudoHelper<T extends ChainHelperBaseConstructor>(Base: T) {3454 return class extends Base {3455 constructor(...args: any[]) {3456 super(...args);3457 }34583459 async executeExtrinsic(3460 sender: IKeyringPair,3461 extrinsic: string,3462 params: any[],3463 expectSuccess?: boolean,3464 options: Partial<SignerOptions> | null = null,3465 ): Promise<ITransactionResult> {3466 const call = this.constructApiCall(extrinsic, params);3467 const result = await super.executeExtrinsic(3468 sender,3469 'api.tx.sudo.sudo',3470 [call],3471 expectSuccess,3472 options,3473 );34743475 if(result.status === 'Fail') return result;34763477 const data = (result.result.events.find(x => x.event.section == 'sudo' && x.event.method == 'Sudid')?.event.data as any).sudoResult;3478 if(data.isErr) {3479 if(data.asErr.isModule) {3480 const error = (result.result.events[1].event.data as any).sudoResult.asErr.asModule;3481 const metaError = super.getApi()?.registry.findMetaError(error);3482 throw new Error(`${metaError.section}.${metaError.name}`);3483 } else if(data.asErr.isToken) {3484 throw new Error(`Token: ${data.asErr.asToken}`);3485 }3486 // May be [object Object] in case of unhandled non-unit enum3487 throw new Error(`Misc: ${data.asErr.toHuman()}`);3488 }3489 return result;3490 }3491 };3492}34933494export class UniqueBaseCollection {3495 helper: UniqueHelper;3496 collectionId: number;34973498 constructor(collectionId: number, uniqueHelper: UniqueHelper) {3499 this.collectionId = collectionId;3500 this.helper = uniqueHelper;3501 }35023503 async getData() {3504 return await this.helper.collection.getData(this.collectionId);3505 }35063507 async getLastTokenId() {3508 return await this.helper.collection.getLastTokenId(this.collectionId);3509 }35103511 async doesTokenExist(tokenId: number) {3512 return await this.helper.collection.doesTokenExist(this.collectionId, tokenId);3513 }35143515 async getAdmins() {3516 return await this.helper.collection.getAdmins(this.collectionId);3517 }35183519 async getAllowList() {3520 return await this.helper.collection.getAllowList(this.collectionId);3521 }35223523 async getEffectiveLimits() {3524 return await this.helper.collection.getEffectiveLimits(this.collectionId);3525 }35263527 async getProperties(propertyKeys?: string[] | null) {3528 return await this.helper.collection.getProperties(this.collectionId, propertyKeys);3529 }35303531 async getPropertiesConsumedSpace() {3532 return await this.helper.collection.getPropertiesConsumedSpace(this.collectionId);3533 }35343535 async getTokenNextSponsored(tokenId: number, addressObj: ICrossAccountId) {3536 return await this.helper.collection.getTokenNextSponsored(this.collectionId, tokenId, addressObj);3537 }35383539 async getOptions() {3540 return await this.helper.collection.getCollectionOptions(this.collectionId);3541 }35423543 async setSponsor(signer: TSigner, sponsorAddress: TSubstrateAccount) {3544 return await this.helper.collection.setSponsor(signer, this.collectionId, sponsorAddress);3545 }35463547 async confirmSponsorship(signer: TSigner) {3548 return await this.helper.collection.confirmSponsorship(signer, this.collectionId);3549 }35503551 async removeSponsor(signer: TSigner) {3552 return await this.helper.collection.removeSponsor(signer, this.collectionId);3553 }35543555 async setLimits(signer: TSigner, limits: ICollectionLimits) {3556 return await this.helper.collection.setLimits(signer, this.collectionId, limits);3557 }35583559 async changeOwner(signer: TSigner, ownerAddress: TSubstrateAccount) {3560 return await this.helper.collection.changeOwner(signer, this.collectionId, ownerAddress);3561 }35623563 async addAdmin(signer: TSigner, adminAddressObj: ICrossAccountId) {3564 return await this.helper.collection.addAdmin(signer, this.collectionId, adminAddressObj);3565 }35663567 async addToAllowList(signer: TSigner, addressObj: ICrossAccountId) {3568 return await this.helper.collection.addToAllowList(signer, this.collectionId, addressObj);3569 }35703571 async removeFromAllowList(signer: TSigner, addressObj: ICrossAccountId) {3572 return await this.helper.collection.removeFromAllowList(signer, this.collectionId, addressObj);3573 }35743575 async removeAdmin(signer: TSigner, adminAddressObj: ICrossAccountId) {3576 return await this.helper.collection.removeAdmin(signer, this.collectionId, adminAddressObj);3577 }35783579 async setProperties(signer: TSigner, properties: IProperty[]) {3580 return await this.helper.collection.setProperties(signer, this.collectionId, properties);3581 }35823583 async deleteProperties(signer: TSigner, propertyKeys: string[]) {3584 return await this.helper.collection.deleteProperties(signer, this.collectionId, propertyKeys);3585 }35863587 async setPermissions(signer: TSigner, permissions: ICollectionPermissions) {3588 return await this.helper.collection.setPermissions(signer, this.collectionId, permissions);3589 }35903591 async enableNesting(signer: TSigner, permissions: INestingPermissions) {3592 return await this.helper.collection.enableNesting(signer, this.collectionId, permissions);3593 }35943595 async disableNesting(signer: TSigner) {3596 return await this.helper.collection.disableNesting(signer, this.collectionId);3597 }35983599 async burn(signer: TSigner) {3600 return await this.helper.collection.burn(signer, this.collectionId);3601 }36023603 scheduleAt<T extends UniqueHelper>(3604 executionBlockNumber: number,3605 options: ISchedulerOptions = {},3606 ) {3607 const scheduledHelper = this.helper.scheduler.scheduleAt<T>(executionBlockNumber, options);3608 return new UniqueBaseCollection(this.collectionId, scheduledHelper);3609 }36103611 scheduleAfter<T extends UniqueHelper>(3612 blocksBeforeExecution: number,3613 options: ISchedulerOptions = {},3614 ) {3615 const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(blocksBeforeExecution, options);3616 return new UniqueBaseCollection(this.collectionId, scheduledHelper);3617 }36183619 getSudo<T extends UniqueHelper>() {3620 return new UniqueBaseCollection(this.collectionId, this.helper.getSudo<T>());3621 }3622}362336243625export class UniqueNFTCollection extends UniqueBaseCollection {3626 getTokenObject(tokenId: number) {3627 return new UniqueNFToken(tokenId, this);3628 }36293630 async getTokensByAddress(addressObj: ICrossAccountId) {3631 return await this.helper.nft.getTokensByAddress(this.collectionId, addressObj);3632 }36333634 async getToken(tokenId: number, blockHashAt?: string) {3635 return await this.helper.nft.getToken(this.collectionId, tokenId, [], blockHashAt);3636 }36373638 async getTokenOwner(tokenId: number, blockHashAt?: string) {3639 return await this.helper.nft.getTokenOwner(this.collectionId, tokenId, blockHashAt);3640 }36413642 async getTokenTopmostOwner(tokenId: number, blockHashAt?: string) {3643 return await this.helper.nft.getTokenTopmostOwner(this.collectionId, tokenId, blockHashAt);3644 }36453646 async getTokenChildren(tokenId: number, blockHashAt?: string) {3647 return await this.helper.nft.getTokenChildren(this.collectionId, tokenId, blockHashAt);3648 }36493650 async getPropertyPermissions(propertyKeys: string[] | null = null) {3651 return await this.helper.nft.getPropertyPermissions(this.collectionId, propertyKeys);3652 }36533654 async getTokenProperties(tokenId: number, propertyKeys?: string[] | null) {3655 return await this.helper.nft.getTokenProperties(this.collectionId, tokenId, propertyKeys);3656 }36573658 async getTokenPropertiesConsumedSpace(tokenId: number): Promise<number> {3659 const api = this.helper.getApi();3660 const props = (await api.query.nonfungible.tokenProperties(this.collectionId, tokenId)).toJSON();36613662 return (props! as any).consumedSpace;3663 }36643665 async transferToken(signer: TSigner, tokenId: number, addressObj: ICrossAccountId) {3666 return await this.helper.nft.transferToken(signer, this.collectionId, tokenId, addressObj);3667 }36683669 async transferTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3670 return await this.helper.nft.transferTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, toAddressObj);3671 }36723673 async approveToken(signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId) {3674 return await this.helper.nft.approveToken(signer, this.collectionId, tokenId, toAddressObj);3675 }36763677 async isTokenApproved(tokenId: number, toAddressObj: ICrossAccountId) {3678 return await this.helper.nft.isTokenApproved(this.collectionId, tokenId, toAddressObj);3679 }36803681 async mintToken(signer: TSigner, owner: ICrossAccountId = {Substrate: signer.address}, properties?: IProperty[]) {3682 return await this.helper.nft.mintToken(signer, {collectionId: this.collectionId, owner, properties});3683 }36843685 async mintMultipleTokens(signer: TSigner, tokens: { owner: ICrossAccountId, properties?: IProperty[] }[]) {3686 return await this.helper.nft.mintMultipleTokens(signer, this.collectionId, tokens);3687 }36883689 async burnToken(signer: TSigner, tokenId: number) {3690 return await this.helper.nft.burnToken(signer, this.collectionId, tokenId);3691 }36923693 async burnTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId) {3694 return await this.helper.nft.burnTokenFrom(signer, this.collectionId, tokenId, fromAddressObj);3695 }36963697 async setTokenProperties(signer: TSigner, tokenId: number, properties: IProperty[]) {3698 return await this.helper.nft.setTokenProperties(signer, this.collectionId, tokenId, properties);3699 }37003701 async deleteTokenProperties(signer: TSigner, tokenId: number, propertyKeys: string[]) {3702 return await this.helper.nft.deleteTokenProperties(signer, this.collectionId, tokenId, propertyKeys);3703 }37043705 async setTokenPropertyPermissions(signer: TSigner, permissions: ITokenPropertyPermission[]) {3706 return await this.helper.nft.setTokenPropertyPermissions(signer, this.collectionId, permissions);3707 }37083709 async nestToken(signer: TSigner, tokenId: number, toTokenObj: IToken) {3710 return await this.helper.nft.nestToken(signer, {collectionId: this.collectionId, tokenId}, toTokenObj);3711 }37123713 async unnestToken(signer: TSigner, tokenId: number, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {3714 return await this.helper.nft.unnestToken(signer, {collectionId: this.collectionId, tokenId}, fromTokenObj, toAddressObj);3715 }37163717 scheduleAt<T extends UniqueHelper>(3718 executionBlockNumber: number,3719 options: ISchedulerOptions = {},3720 ) {3721 const scheduledHelper = this.helper.scheduler.scheduleAt<T>(executionBlockNumber, options);3722 return new UniqueNFTCollection(this.collectionId, scheduledHelper);3723 }37243725 scheduleAfter<T extends UniqueHelper>(3726 blocksBeforeExecution: number,3727 options: ISchedulerOptions = {},3728 ) {3729 const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(blocksBeforeExecution, options);3730 return new UniqueNFTCollection(this.collectionId, scheduledHelper);3731 }37323733 getSudo<T extends UniqueHelper>() {3734 return new UniqueNFTCollection(this.collectionId, this.helper.getSudo<T>());3735 }3736}373737383739export class UniqueRFTCollection extends UniqueBaseCollection {3740 getTokenObject(tokenId: number) {3741 return new UniqueRFToken(tokenId, this);3742 }37433744 async getToken(tokenId: number, blockHashAt?: string) {3745 return await this.helper.rft.getToken(this.collectionId, tokenId, [], blockHashAt);3746 }37473748 async getTokenOwner(tokenId: number, blockHashAt?: string) {3749 return await this.helper.rft.getTokenOwner(this.collectionId, tokenId, blockHashAt);3750 }37513752 async getTokensByAddress(addressObj: ICrossAccountId) {3753 return await this.helper.rft.getTokensByAddress(this.collectionId, addressObj);3754 }37553756 async getTop10TokenOwners(tokenId: number) {3757 return await this.helper.rft.getTokenTop10Owners(this.collectionId, tokenId);3758 }37593760 async getTokenTopmostOwner(tokenId: number, blockHashAt?: string) {3761 return await this.helper.rft.getTokenTopmostOwner(this.collectionId, tokenId, blockHashAt);3762 }37633764 async getTokenBalance(tokenId: number, addressObj: ICrossAccountId) {3765 return await this.helper.rft.getTokenBalance(this.collectionId, tokenId, addressObj);3766 }37673768 async getTokenTotalPieces(tokenId: number) {3769 return await this.helper.rft.getTokenTotalPieces(this.collectionId, tokenId);3770 }37713772 async getTokenApprovedPieces(tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3773 return await this.helper.rft.getTokenApprovedPieces(this.collectionId, tokenId, toAddressObj, fromAddressObj);3774 }37753776 async getPropertyPermissions(propertyKeys: string[] | null = null) {3777 return await this.helper.rft.getPropertyPermissions(this.collectionId, propertyKeys);3778 }37793780 async getTokenProperties(tokenId: number, propertyKeys?: string[] | null) {3781 return await this.helper.rft.getTokenProperties(this.collectionId, tokenId, propertyKeys);3782 }37833784 async getTokenPropertiesConsumedSpace(tokenId: number): Promise<number> {3785 const api = this.helper.getApi();3786 const props = (await api.query.refungible.tokenProperties(this.collectionId, tokenId)).toJSON();37873788 return (props! as any).consumedSpace;3789 }37903791 async transferToken(signer: TSigner, tokenId: number, addressObj: ICrossAccountId, amount = 1n) {3792 return await this.helper.rft.transferToken(signer, this.collectionId, tokenId, addressObj, amount);3793 }37943795 async transferTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {3796 return await this.helper.rft.transferTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, toAddressObj, amount);3797 }37983799 async approveToken(signer: TSigner, tokenId: number, toAddressObj: ICrossAccountId, amount = 1n) {3800 return await this.helper.rft.approveToken(signer, this.collectionId, tokenId, toAddressObj, amount);3801 }38023803 async repartitionToken(signer: TSigner, tokenId: number, amount: bigint) {3804 return await this.helper.rft.repartitionToken(signer, this.collectionId, tokenId, amount);3805 }38063807 async mintToken(signer: TSigner, pieces = 1n, owner: ICrossAccountId = {Substrate: signer.address}, properties?: IProperty[]) {3808 return await this.helper.rft.mintToken(signer, {collectionId: this.collectionId, owner, pieces, properties});3809 }38103811 async mintMultipleTokens(signer: TSigner, tokens: { pieces: bigint, owner: ICrossAccountId, properties?: IProperty[] }[]) {3812 return await this.helper.rft.mintMultipleTokens(signer, this.collectionId, tokens);3813 }38143815 async burnToken(signer: TSigner, tokenId: number, amount = 1n) {3816 return await this.helper.rft.burnToken(signer, this.collectionId, tokenId, amount);3817 }38183819 async burnTokenFrom(signer: TSigner, tokenId: number, fromAddressObj: ICrossAccountId, amount = 1n) {3820 return await this.helper.rft.burnTokenFrom(signer, this.collectionId, tokenId, fromAddressObj, amount);3821 }38223823 async setTokenProperties(signer: TSigner, tokenId: number, properties: IProperty[]) {3824 return await this.helper.rft.setTokenProperties(signer, this.collectionId, tokenId, properties);3825 }38263827 async deleteTokenProperties(signer: TSigner, tokenId: number, propertyKeys: string[]) {3828 return await this.helper.rft.deleteTokenProperties(signer, this.collectionId, tokenId, propertyKeys);3829 }38303831 async setTokenPropertyPermissions(signer: TSigner, permissions: ITokenPropertyPermission[]) {3832 return await this.helper.rft.setTokenPropertyPermissions(signer, this.collectionId, permissions);3833 }38343835 async nestToken(signer: TSigner, tokenId: number, toTokenObj: IToken) {3836 return await this.helper.rft.nestToken(signer, {collectionId: this.collectionId, tokenId}, toTokenObj);3837 }38383839 async unnestToken(signer: TSigner, tokenId: number, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {3840 return await this.helper.rft.unnestToken(signer, {collectionId: this.collectionId, tokenId}, fromTokenObj, toAddressObj);3841 }38423843 scheduleAt<T extends UniqueHelper>(3844 executionBlockNumber: number,3845 options: ISchedulerOptions = {},3846 ) {3847 const scheduledHelper = this.helper.scheduler.scheduleAt<T>(executionBlockNumber, options);3848 return new UniqueRFTCollection(this.collectionId, scheduledHelper);3849 }38503851 scheduleAfter<T extends UniqueHelper>(3852 blocksBeforeExecution: number,3853 options: ISchedulerOptions = {},3854 ) {3855 const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(blocksBeforeExecution, options);3856 return new UniqueRFTCollection(this.collectionId, scheduledHelper);3857 }38583859 getSudo<T extends UniqueHelper>() {3860 return new UniqueRFTCollection(this.collectionId, this.helper.getSudo<T>());3861 }3862}386338643865export class UniqueFTCollection extends UniqueBaseCollection {3866 async getBalance(addressObj: ICrossAccountId) {3867 return await this.helper.ft.getBalance(this.collectionId, addressObj);3868 }38693870 async getTotalPieces() {3871 return await this.helper.ft.getTotalPieces(this.collectionId);3872 }38733874 async getApprovedTokens(fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {3875 return await this.helper.ft.getApprovedTokens(this.collectionId, fromAddressObj, toAddressObj);3876 }38773878 async getTop10Owners() {3879 return await this.helper.ft.getTop10Owners(this.collectionId);3880 }38813882 async mint(signer: TSigner, amount = 1n, owner: ICrossAccountId = {Substrate: signer.address}) {3883 return await this.helper.ft.mintTokens(signer, this.collectionId, amount, owner);3884 }38853886 async mintWithOneOwner(signer: TSigner, tokens: { value: bigint }[], owner: ICrossAccountId = {Substrate: signer.address}) {3887 return await this.helper.ft.mintMultipleTokensWithOneOwner(signer, this.collectionId, tokens, owner);3888 }38893890 async transfer(signer: TSigner, toAddressObj: ICrossAccountId, amount = 1n) {3891 return await this.helper.ft.transfer(signer, this.collectionId, toAddressObj, amount);3892 }38933894 async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {3895 return await this.helper.ft.transferFrom(signer, this.collectionId, fromAddressObj, toAddressObj, amount);3896 }38973898 async burnTokens(signer: TSigner, amount = 1n) {3899 return await this.helper.ft.burnTokens(signer, this.collectionId, amount);3900 }39013902 async burnTokensFrom(signer: TSigner, fromAddressObj: ICrossAccountId, amount = 1n) {3903 return await this.helper.ft.burnTokensFrom(signer, this.collectionId, fromAddressObj, amount);3904 }39053906 async approveTokens(signer: TSigner, toAddressObj: ICrossAccountId, amount = 1n) {3907 return await this.helper.ft.approveTokens(signer, this.collectionId, toAddressObj, amount);3908 }39093910 scheduleAt<T extends UniqueHelper>(3911 executionBlockNumber: number,3912 options: ISchedulerOptions = {},3913 ) {3914 const scheduledHelper = this.helper.scheduler.scheduleAt<T>(executionBlockNumber, options);3915 return new UniqueFTCollection(this.collectionId, scheduledHelper);3916 }39173918 scheduleAfter<T extends UniqueHelper>(3919 blocksBeforeExecution: number,3920 options: ISchedulerOptions = {},3921 ) {3922 const scheduledHelper = this.helper.scheduler.scheduleAfter<T>(blocksBeforeExecution, options);3923 return new UniqueFTCollection(this.collectionId, scheduledHelper);3924 }39253926 getSudo<T extends UniqueHelper>() {3927 return new UniqueFTCollection(this.collectionId, this.helper.getSudo<T>());3928 }3929}393039313932export class UniqueBaseToken {3933 collection: UniqueNFTCollection | UniqueRFTCollection;3934 collectionId: number;3935 tokenId: number;39363937 constructor(tokenId: number, collection: UniqueNFTCollection | UniqueRFTCollection) {3938 this.collection = collection;3939 this.collectionId = collection.collectionId;3940 this.tokenId = tokenId;3941 }39423943 async getNextSponsored(addressObj: ICrossAccountId) {3944 return await this.collection.getTokenNextSponsored(this.tokenId, addressObj);3945 }39463947 async getProperties(propertyKeys?: string[] | null) {3948 return await this.collection.getTokenProperties(this.tokenId, propertyKeys);3949 }39503951 async getTokenPropertiesConsumedSpace() {3952 return await this.collection.getTokenPropertiesConsumedSpace(this.tokenId);3953 }39543955 async setProperties(signer: TSigner, properties: IProperty[]) {3956 return await this.collection.setTokenProperties(signer, this.tokenId, properties);3957 }39583959 async deleteProperties(signer: TSigner, propertyKeys: string[]) {3960 return await this.collection.deleteTokenProperties(signer, this.tokenId, propertyKeys);3961 }39623963 async doesExist() {3964 return await this.collection.doesTokenExist(this.tokenId);3965 }39663967 nestingAccount() {3968 return this.collection.helper.util.getTokenAccount(this);3969 }39703971 scheduleAt<T extends UniqueHelper>(3972 executionBlockNumber: number,3973 options: ISchedulerOptions = {},3974 ) {3975 const scheduledCollection = this.collection.scheduleAt<T>(executionBlockNumber, options);3976 return new UniqueBaseToken(this.tokenId, scheduledCollection);3977 }39783979 scheduleAfter<T extends UniqueHelper>(3980 blocksBeforeExecution: number,3981 options: ISchedulerOptions = {},3982 ) {3983 const scheduledCollection = this.collection.scheduleAfter<T>(blocksBeforeExecution, options);3984 return new UniqueBaseToken(this.tokenId, scheduledCollection);3985 }39863987 getSudo<T extends UniqueHelper>() {3988 return new UniqueBaseToken(this.tokenId, this.collection.getSudo<T>());3989 }3990}399139923993export class UniqueNFToken extends UniqueBaseToken {3994 collection: UniqueNFTCollection;39953996 constructor(tokenId: number, collection: UniqueNFTCollection) {3997 super(tokenId, collection);3998 this.collection = collection;3999 }40004001 async getData(blockHashAt?: string) {4002 return await this.collection.getToken(this.tokenId, blockHashAt);4003 }40044005 async getOwner(blockHashAt?: string) {4006 return await this.collection.getTokenOwner(this.tokenId, blockHashAt);4007 }40084009 async getTopmostOwner(blockHashAt?: string) {4010 return await this.collection.getTokenTopmostOwner(this.tokenId, blockHashAt);4011 }40124013 async getChildren(blockHashAt?: string) {4014 return await this.collection.getTokenChildren(this.tokenId, blockHashAt);4015 }40164017 async nest(signer: TSigner, toTokenObj: IToken) {4018 return await this.collection.nestToken(signer, this.tokenId, toTokenObj);4019 }40204021 async unnest(signer: TSigner, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {4022 return await this.collection.unnestToken(signer, this.tokenId, fromTokenObj, toAddressObj);4023 }40244025 async transfer(signer: TSigner, addressObj: ICrossAccountId) {4026 return await this.collection.transferToken(signer, this.tokenId, addressObj);4027 }40284029 async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId) {4030 return await this.collection.transferTokenFrom(signer, this.tokenId, fromAddressObj, toAddressObj);4031 }40324033 async approve(signer: TSigner, toAddressObj: ICrossAccountId) {4034 return await this.collection.approveToken(signer, this.tokenId, toAddressObj);4035 }40364037 async isApproved(toAddressObj: ICrossAccountId) {4038 return await this.collection.isTokenApproved(this.tokenId, toAddressObj);4039 }40404041 async burn(signer: TSigner) {4042 return await this.collection.burnToken(signer, this.tokenId);4043 }40444045 async burnFrom(signer: TSigner, fromAddressObj: ICrossAccountId) {4046 return await this.collection.burnTokenFrom(signer, this.tokenId, fromAddressObj);4047 }40484049 scheduleAt<T extends UniqueHelper>(4050 executionBlockNumber: number,4051 options: ISchedulerOptions = {},4052 ) {4053 const scheduledCollection = this.collection.scheduleAt<T>(executionBlockNumber, options);4054 return new UniqueNFToken(this.tokenId, scheduledCollection);4055 }40564057 scheduleAfter<T extends UniqueHelper>(4058 blocksBeforeExecution: number,4059 options: ISchedulerOptions = {},4060 ) {4061 const scheduledCollection = this.collection.scheduleAfter<T>(blocksBeforeExecution, options);4062 return new UniqueNFToken(this.tokenId, scheduledCollection);4063 }40644065 getSudo<T extends UniqueHelper>() {4066 return new UniqueNFToken(this.tokenId, this.collection.getSudo<T>());4067 }4068}40694070export class UniqueRFToken extends UniqueBaseToken {4071 collection: UniqueRFTCollection;40724073 constructor(tokenId: number, collection: UniqueRFTCollection) {4074 super(tokenId, collection);4075 this.collection = collection;4076 }40774078 async getData(blockHashAt?: string) {4079 return await this.collection.getToken(this.tokenId, blockHashAt);4080 }40814082 async getOwner(blockHashAt?: string) {4083 return await this.collection.getTokenOwner(this.tokenId, blockHashAt);4084 }40854086 async getTop10Owners() {4087 return await this.collection.getTop10TokenOwners(this.tokenId);4088 }40894090 async getTopmostOwner(blockHashAt?: string) {4091 return await this.collection.getTokenTopmostOwner(this.tokenId, blockHashAt);4092 }40934094 async nest(signer: TSigner, toTokenObj: IToken) {4095 return await this.collection.nestToken(signer, this.tokenId, toTokenObj);4096 }40974098 async unnest(signer: TSigner, fromTokenObj: IToken, toAddressObj: ICrossAccountId) {4099 return await this.collection.unnestToken(signer, this.tokenId, fromTokenObj, toAddressObj);4100 }41014102 async getBalance(addressObj: ICrossAccountId) {4103 return await this.collection.getTokenBalance(this.tokenId, addressObj);4104 }41054106 async getTotalPieces() {4107 return await this.collection.getTokenTotalPieces(this.tokenId);4108 }41094110 async getApprovedPieces(fromAddressObj: ICrossAccountId, toAccountObj: ICrossAccountId) {4111 return await this.collection.getTokenApprovedPieces(this.tokenId, fromAddressObj, toAccountObj);4112 }41134114 async transfer(signer: TSigner, addressObj: ICrossAccountId, amount = 1n) {4115 return await this.collection.transferToken(signer, this.tokenId, addressObj, amount);4116 }41174118 async transferFrom(signer: TSigner, fromAddressObj: ICrossAccountId, toAddressObj: ICrossAccountId, amount = 1n) {4119 return await this.collection.transferTokenFrom(signer, this.tokenId, fromAddressObj, toAddressObj, amount);4120 }41214122 async approve(signer: TSigner, toAddressObj: ICrossAccountId, amount = 1n) {4123 return await this.collection.approveToken(signer, this.tokenId, toAddressObj, amount);4124 }41254126 async repartition(signer: TSigner, amount: bigint) {4127 return await this.collection.repartitionToken(signer, this.tokenId, amount);4128 }41294130 async burn(signer: TSigner, amount = 1n) {4131 return await this.collection.burnToken(signer, this.tokenId, amount);4132 }41334134 async burnFrom(signer: TSigner, fromAddressObj: ICrossAccountId, amount = 1n) {4135 return await this.collection.burnTokenFrom(signer, this.tokenId, fromAddressObj, amount);4136 }41374138 scheduleAt<T extends UniqueHelper>(4139 executionBlockNumber: number,4140 options: ISchedulerOptions = {},4141 ) {4142 const scheduledCollection = this.collection.scheduleAt<T>(executionBlockNumber, options);4143 return new UniqueRFToken(this.tokenId, scheduledCollection);4144 }41454146 scheduleAfter<T extends UniqueHelper>(4147 blocksBeforeExecution: number,4148 options: ISchedulerOptions = {},4149 ) {4150 const scheduledCollection = this.collection.scheduleAfter<T>(blocksBeforeExecution, options);4151 return new UniqueRFToken(this.tokenId, scheduledCollection);4152 }41534154 getSudo<T extends UniqueHelper>() {4155 return new UniqueRFToken(this.tokenId, this.collection.getSudo<T>());4156 }4157}tests/src/util/relayIdentitiesChecker.tsdiffbeforeafterboth--- a/tests/src/util/relayIdentitiesChecker.ts
+++ b/tests/src/util/relayIdentitiesChecker.ts
@@ -22,7 +22,7 @@
// iterate over every identity
for(const [key, value] of await getIdentities(helper)) {
// if any of the judgements resulted in a good confirmed outcome, keep this identity
- if (value.toHuman().judgements.filter((x: any) => x[1] == 'Reasonable' || x[1] == 'KnownGood').length == 0) continue;
+ if(value.toHuman().judgements.filter((x: any) => x[1] == 'Reasonable' || x[1] == 'KnownGood').length == 0) continue;
identities.push([key, value]);
}
@@ -31,7 +31,7 @@
// iterate over every sub-identity
for(const [key, value] of await getSubs(helper)) {
// only get subs of the identities interesting to us
- if (identities.find((x: any) => x[0] == key) == -1) continue;
+ if(identities.find((x: any) => x[0] == key) == -1) continue;
subs.push(constructSubInfo(key, value, supersOfSubs));
}
} catch (error) {
@@ -56,15 +56,15 @@
const matchingAddresses: string[] = [];
const inequalIdentities: {[name: string]: [any, any]} = {};
- for (const [key1, value1] of identitiesOnRelay1) {
+ for(const [key1, value1] of identitiesOnRelay1) {
const address = encodeAddress(key1);
const identity2 = identitiesOnRelay2.find(([key2, _value2]) => address === encodeAddress(key2));
- if (!identity2) continue;
+ if(!identity2) continue;
matchingAddresses.push(address);
//const [[key2, value2]] = identitiesOnRelay2.splice(index2, 1);
const [_key2, value2] = identity2;
- if (JSON.stringify(value1.info) === JSON.stringify(value2.info)) continue;
+ if(JSON.stringify(value1.info) === JSON.stringify(value2.info)) continue;
inequalIdentities[address] = [value1, value2];
}
@@ -81,16 +81,16 @@
const inequalSubIdentities = [];
let matchesFound = 0;
- for (const address of matchingAddresses) {
+ for(const address of matchingAddresses) {
const sub1 = subIdentitiesOnRelay1.find(([key1, _value1]) => address === encodeAddress(key1));
- if (!sub1) continue;
+ if(!sub1) continue;
const sub2 = subIdentitiesOnRelay2.find(([key2, _value2]) => address === encodeAddress(key2));
- if (!sub2) continue;
+ if(!sub2) continue;
const [value1, value2] = [sub1[1], sub2[1]];
matchesFound++;
- if (JSON.stringify(value1[1]) === JSON.stringify(value2[1])) {
+ if(JSON.stringify(value1[1]) === JSON.stringify(value2[1])) {
continue;
}
inequalSubIdentities.push([value1, value2]);
@@ -110,5 +110,5 @@
}
};
-if (process.argv[1] === module.filename)
+if(process.argv[1] === module.filename)
checkRelayIdentities().catch(() => process.exit(1));