mirror of openzeppelin-contracts
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
openzeppelin-contracts/test/utils/Checkpoints.test.js

255 lines
11 KiB

const { expectRevert, time } = require('@openzeppelin/test-helpers');
const { expect } = require('chai');
const { batchInBlock } = require('../helpers/txpool');
const $Checkpoints = artifacts.require('$Checkpoints');
// The library name may be 'Checkpoints' or 'CheckpointsUpgradeable'
const libraryName = $Checkpoints._json.contractName.replace(/^\$/, '');
const traceLengths = [160, 224];
const first = array => (array.length ? array[0] : undefined);
const last = array => (array.length ? array[array.length - 1] : undefined);
contract('Checkpoints', function () {
beforeEach(async function () {
this.mock = await $Checkpoints.new();
this.methods = { trace: {} };
this.methods.history = {
latest: (...args) => this.mock.methods[`$latest_${libraryName}_History(uint256)`](0, ...args),
latestCheckpoint: (...args) => this.mock.methods[`$latestCheckpoint_${libraryName}_History(uint256)`](0, ...args),
length: (...args) => this.mock.methods[`$length_${libraryName}_History(uint256)`](0, ...args),
push: (...args) => this.mock.methods['$push(uint256,uint256)'](0, ...args),
getAtBlock: (...args) => this.mock.$getAtBlock(0, ...args),
getAtRecentBlock: (...args) => this.mock.$getAtProbablyRecentBlock(0, ...args),
};
for (const length of traceLengths) {
this.methods.trace[length] = {
latest: (...args) => this.mock.methods[`$latest_${libraryName}_Trace${length}(uint256)`](0, ...args),
latestCheckpoint: (...args) =>
this.mock.methods[`$latestCheckpoint_${libraryName}_Trace${length}(uint256)`](0, ...args),
length: (...args) => this.mock.methods[`$length_${libraryName}_Trace${length}(uint256)`](0, ...args),
push: (...args) => this.mock.methods[`$push(uint256,uint${256 - length},uint${length})`](0, ...args),
lowerLookup: (...args) => this.mock.methods[`$lowerLookup(uint256,uint${256 - length})`](0, ...args),
upperLookup: (...args) => this.mock.methods[`$upperLookup(uint256,uint${256 - length})`](0, ...args),
upperLookupRecent: (...args) =>
this.mock.methods[`$upperLookupRecent(uint256,uint${256 - length})`](0, ...args),
};
}
});
describe('History checkpoints', function () {
describe('without checkpoints', function () {
it('returns zero as latest value', async function () {
expect(await this.methods.history.latest()).to.be.bignumber.equal('0');
const ckpt = await this.methods.history.latestCheckpoint();
expect(ckpt[0]).to.be.equal(false);
expect(ckpt[1]).to.be.bignumber.equal('0');
expect(ckpt[2]).to.be.bignumber.equal('0');
});
it('returns zero as past value', async function () {
await time.advanceBlock();
expect(await this.methods.history.getAtBlock((await web3.eth.getBlockNumber()) - 1)).to.be.bignumber.equal('0');
expect(
await this.methods.history.getAtRecentBlock((await web3.eth.getBlockNumber()) - 1),
).to.be.bignumber.equal('0');
});
});
describe('with checkpoints', function () {
beforeEach('pushing checkpoints', async function () {
this.tx1 = await this.methods.history.push(1);
this.tx2 = await this.methods.history.push(2);
await time.advanceBlock();
this.tx3 = await this.methods.history.push(3);
await time.advanceBlock();
await time.advanceBlock();
});
it('returns latest value', async function () {
expect(await this.methods.history.latest()).to.be.bignumber.equal('3');
const ckpt = await this.methods.history.latestCheckpoint();
expect(ckpt[0]).to.be.equal(true);
expect(ckpt[1]).to.be.bignumber.equal(web3.utils.toBN(this.tx3.receipt.blockNumber));
expect(ckpt[2]).to.be.bignumber.equal(web3.utils.toBN('3'));
});
for (const getAtBlockVariant of ['getAtBlock', 'getAtRecentBlock']) {
describe(`lookup: ${getAtBlockVariant}`, function () {
it('returns past values', async function () {
expect(
await this.methods.history[getAtBlockVariant](this.tx1.receipt.blockNumber - 1),
).to.be.bignumber.equal('0');
expect(await this.methods.history[getAtBlockVariant](this.tx1.receipt.blockNumber)).to.be.bignumber.equal(
'1',
);
expect(await this.methods.history[getAtBlockVariant](this.tx2.receipt.blockNumber)).to.be.bignumber.equal(
'2',
);
// Block with no new checkpoints
expect(
await this.methods.history[getAtBlockVariant](this.tx2.receipt.blockNumber + 1),
).to.be.bignumber.equal('2');
expect(await this.methods.history[getAtBlockVariant](this.tx3.receipt.blockNumber)).to.be.bignumber.equal(
'3',
);
expect(
await this.methods.history[getAtBlockVariant](this.tx3.receipt.blockNumber + 1),
).to.be.bignumber.equal('3');
});
it('reverts if block number >= current block', async function () {
await expectRevert(
this.methods.history[getAtBlockVariant](await web3.eth.getBlockNumber()),
'Checkpoints: block not yet mined',
);
await expectRevert(
this.methods.history[getAtBlockVariant]((await web3.eth.getBlockNumber()) + 1),
'Checkpoints: block not yet mined',
);
});
});
}
it('multiple checkpoints in the same block', async function () {
const lengthBefore = await this.methods.history.length();
await batchInBlock([
() => this.methods.history.push(8, { gas: 100000 }),
() => this.methods.history.push(9, { gas: 100000 }),
() => this.methods.history.push(10, { gas: 100000 }),
]);
expect(await this.methods.history.length()).to.be.bignumber.equal(lengthBefore.addn(1));
expect(await this.methods.history.latest()).to.be.bignumber.equal('10');
});
it('more than 5 checkpoints', async function () {
for (let i = 4; i <= 6; i++) {
await this.methods.history.push(i);
}
expect(await this.methods.history.length()).to.be.bignumber.equal('6');
const block = await web3.eth.getBlockNumber();
// recent
expect(await this.methods.history.getAtRecentBlock(block - 1)).to.be.bignumber.equal('5');
// non-recent
expect(await this.methods.history.getAtRecentBlock(block - 9)).to.be.bignumber.equal('0');
});
});
});
for (const length of traceLengths) {
describe(`Trace${length}`, function () {
describe('without checkpoints', function () {
it('returns zero as latest value', async function () {
expect(await this.methods.trace[length].latest()).to.be.bignumber.equal('0');
const ckpt = await this.methods.trace[length].latestCheckpoint();
expect(ckpt[0]).to.be.equal(false);
expect(ckpt[1]).to.be.bignumber.equal('0');
expect(ckpt[2]).to.be.bignumber.equal('0');
});
it('lookup returns 0', async function () {
expect(await this.methods.trace[length].lowerLookup(0)).to.be.bignumber.equal('0');
expect(await this.methods.trace[length].upperLookup(0)).to.be.bignumber.equal('0');
expect(await this.methods.trace[length].upperLookupRecent(0)).to.be.bignumber.equal('0');
});
});
describe('with checkpoints', function () {
beforeEach('pushing checkpoints', async function () {
this.checkpoints = [
{ key: '2', value: '17' },
{ key: '3', value: '42' },
{ key: '5', value: '101' },
{ key: '7', value: '23' },
{ key: '11', value: '99' },
];
for (const { key, value } of this.checkpoints) {
await this.methods.trace[length].push(key, value);
}
});
it('length', async function () {
expect(await this.methods.trace[length].length()).to.be.bignumber.equal(this.checkpoints.length.toString());
});
it('returns latest value', async function () {
expect(await this.methods.trace[length].latest()).to.be.bignumber.equal(last(this.checkpoints).value);
const ckpt = await this.methods.trace[length].latestCheckpoint();
expect(ckpt[0]).to.be.equal(true);
expect(ckpt[1]).to.be.bignumber.equal(last(this.checkpoints).key);
expect(ckpt[2]).to.be.bignumber.equal(last(this.checkpoints).value);
});
it('cannot push values in the past', async function () {
await expectRevert(
this.methods.trace[length].push(last(this.checkpoints).key - 1, '0'),
'Checkpoint: decreasing keys',
);
});
it('can update last value', async function () {
const newValue = '42';
// check length before the update
expect(await this.methods.trace[length].length()).to.be.bignumber.equal(this.checkpoints.length.toString());
// update last key
await this.methods.trace[length].push(last(this.checkpoints).key, newValue);
expect(await this.methods.trace[length].latest()).to.be.bignumber.equal(newValue);
// check that length did not change
expect(await this.methods.trace[length].length()).to.be.bignumber.equal(this.checkpoints.length.toString());
});
it('lower lookup', async function () {
for (let i = 0; i < 14; ++i) {
const value = first(this.checkpoints.filter(x => i <= x.key))?.value || '0';
expect(await this.methods.trace[length].lowerLookup(i)).to.be.bignumber.equal(value);
}
});
it('upper lookup & upperLookupRecent', async function () {
for (let i = 0; i < 14; ++i) {
const value = last(this.checkpoints.filter(x => i >= x.key))?.value || '0';
expect(await this.methods.trace[length].upperLookup(i)).to.be.bignumber.equal(value);
expect(await this.methods.trace[length].upperLookupRecent(i)).to.be.bignumber.equal(value);
}
});
it('upperLookupRecent with more than 5 checkpoints', async function () {
const moreCheckpoints = [
{ key: '12', value: '22' },
{ key: '13', value: '131' },
{ key: '17', value: '45' },
{ key: '19', value: '31452' },
{ key: '21', value: '0' },
];
const allCheckpoints = [].concat(this.checkpoints, moreCheckpoints);
for (const { key, value } of moreCheckpoints) {
await this.methods.trace[length].push(key, value);
}
for (let i = 0; i < 25; ++i) {
const value = last(allCheckpoints.filter(x => i >= x.key))?.value || '0';
expect(await this.methods.trace[length].upperLookup(i)).to.be.bignumber.equal(value);
expect(await this.methods.trace[length].upperLookupRecent(i)).to.be.bignumber.equal(value);
}
});
});
});
}
});