crowetic/protocol
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Renaming verify -> assert in order matching

Browse Source
This commit is contained in:
Greg Hysen 2018-08-23 11:45:20 -07:00
parent 9fcb2dda73
commit 1e6b83719a
2 changed files with 52 additions and 53 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
packages/contracts/test/exchange/match_orders.ts
View File

@ -191,7 +191,7 @@ describe.only('matchOrders', () => {
feeRecipientAddress: feeRecipientAddressRight, feeRecipientAddress: feeRecipientAddressRight,
}); });
// Match signedOrderLeft with signedOrderRight // Match signedOrderLeft with signedOrderRight
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -239,7 +239,7 @@ describe.only('matchOrders', () => {
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(50), 16), // 50% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(50), 16), // 50%
}; };
// Match signedOrderLeft with signedOrderRight // Match signedOrderLeft with signedOrderRight
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -303,7 +303,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -339,7 +339,7 @@ describe.only('matchOrders', () => {
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
}; };
// Match signedOrderLeft with signedOrderRight // Match signedOrderLeft with signedOrderRight
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -375,7 +375,7 @@ describe.only('matchOrders', () => {
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(50), 16), // 50% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(50), 16), // 50%
}; };
// Match signedOrderLeft with signedOrderRight // Match signedOrderLeft with signedOrderRight
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -411,7 +411,7 @@ describe.only('matchOrders', () => {
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
}; };
// Match signedOrderLeft with signedOrderRight // Match signedOrderLeft with signedOrderRight
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -453,7 +453,7 @@ describe.only('matchOrders', () => {
newERC20BalancesByOwner, newERC20BalancesByOwner,
// tslint:disable-next-line:trailing-comma // tslint:disable-next-line:trailing-comma
newERC721TokenIdsByOwner newERC721TokenIdsByOwner
] = await matchOrderTester.matchOrdersAndVerifyBalancesAsync( ] = await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -486,7 +486,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(90), 16), // 90% (10% paid earlier) feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(90), 16), // 90% (10% paid earlier)
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(90), 16), // 90% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(90), 16), // 90%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight2, signedOrderRight2,
takerAddress, takerAddress,
@ -531,7 +531,7 @@ describe.only('matchOrders', () => {
newERC20BalancesByOwner, newERC20BalancesByOwner,
// tslint:disable-next-line:trailing-comma // tslint:disable-next-line:trailing-comma
newERC721TokenIdsByOwner newERC721TokenIdsByOwner
] = await matchOrderTester.matchOrdersAndVerifyBalancesAsync( ] = await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -568,7 +568,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(96), 16), // 96% feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(96), 16), // 96%
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(96), 16), // 96% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(96), 16), // 96%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft2, signedOrderLeft2,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -607,7 +607,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -643,7 +643,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -679,7 +679,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -715,7 +715,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -751,7 +751,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -786,7 +786,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -919,7 +919,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 50% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 50%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,
@ -957,7 +957,7 @@ describe.only('matchOrders', () => {
feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerLeft: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100% feePaidByTakerRight: Web3Wrapper.toBaseUnitAmount(new BigNumber(100), 16), // 100%
}; };
await matchOrderTester.matchOrdersAndVerifyBalancesAsync( await matchOrderTester.matchOrdersAndAssertEffectsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
takerAddress, takerAddress,

69
packages/contracts/test/utils/match_order_tester.ts
View File

@ -35,7 +35,7 @@ export class MatchOrderTester {
/// @param transactionReceipt Transaction receipt and logs produced by Exchange.matchOrders. /// @param transactionReceipt Transaction receipt and logs produced by Exchange.matchOrders.
/// @param takerAddress Address of taker (account that called Exchange.matchOrders) /// @param takerAddress Address of taker (account that called Exchange.matchOrders)
/// @param expectedTransferAmounts Expected amounts transferred as a result of order matching. /// @param expectedTransferAmounts Expected amounts transferred as a result of order matching.
private static async _verifyLogsAsync( private static async _assertLogsAsync(
signedOrderLeft: SignedOrder, signedOrderLeft: SignedOrder,
signedOrderRight: SignedOrder, signedOrderRight: SignedOrder,
transactionReceipt: TransactionReceiptWithDecodedLogs, transactionReceipt: TransactionReceiptWithDecodedLogs,
@ -66,7 +66,7 @@ export class MatchOrderTester {
const feePaidByTakerRight = new BigNumber(rightLog.takerFeePaid); const feePaidByTakerRight = new BigNumber(rightLog.takerFeePaid);
// Derive amount received by taker // Derive amount received by taker
const amountReceivedByTaker = amountSoldByLeftMaker.sub(amountBoughtByRightMaker); const amountReceivedByTaker = amountSoldByLeftMaker.sub(amountBoughtByRightMaker);
// Verify log values - left order // Assert log values - left order
expect( expect(
expectedTransferAmounts.amountBoughtByLeftMaker, expectedTransferAmounts.amountBoughtByLeftMaker,
'Checking logged amount bought by left maker', 'Checking logged amount bought by left maker',
@ -83,7 +83,7 @@ export class MatchOrderTester {
expectedTransferAmounts.feePaidByTakerLeft, expectedTransferAmounts.feePaidByTakerLeft,
'Checking logged fee paid on left order by taker', 'Checking logged fee paid on left order by taker',
).to.be.bignumber.equal(feePaidByTakerLeft); ).to.be.bignumber.equal(feePaidByTakerLeft);
// Verify log values - right order // Assert log values - right order
expect( expect(
expectedTransferAmounts.amountBoughtByRightMaker, expectedTransferAmounts.amountBoughtByRightMaker,
'Checking logged amount bought by right maker', 'Checking logged amount bought by right maker',
@ -100,18 +100,18 @@ export class MatchOrderTester {
expectedTransferAmounts.feePaidByTakerRight, expectedTransferAmounts.feePaidByTakerRight,
'Checking logged fee paid on right order by taker', 'Checking logged fee paid on right order by taker',
).to.be.bignumber.equal(feePaidByTakerRight); ).to.be.bignumber.equal(feePaidByTakerRight);
// Verify derived amount received by taker // Assert derived amount received by taker
expect( expect(
expectedTransferAmounts.amountReceivedByTaker, expectedTransferAmounts.amountReceivedByTaker,
'Checking logged amount received by taker', 'Checking logged amount received by taker',
).to.be.bignumber.equal(amountReceivedByTaker); ).to.be.bignumber.equal(amountReceivedByTaker);
} }
/// @dev Verifies all expected ERC20 and ERC721 account holdings match the real holdings. /// @dev Asserts all expected ERC20 and ERC721 account holdings match the real holdings.
/// @param expectedERC20BalancesByOwner Expected ERC20 balances. /// @param expectedERC20BalancesByOwner Expected ERC20 balances.
/// @param realERC20BalancesByOwner Real ERC20 balances. /// @param realERC20BalancesByOwner Real ERC20 balances.
/// @param expectedERC721TokenIdsByOwner Expected ERC721 token owners. /// @param expectedERC721TokenIdsByOwner Expected ERC721 token owners.
/// @param realERC721TokenIdsByOwner Real ERC20 token owners. /// @param realERC721TokenIdsByOwner Real ERC20 token owners.
private static async _verifyAllKnownBalancesAsync( private static async _assertAllKnownBalancesAsync(
expectedERC20BalancesByOwner: ERC20BalancesByOwner, expectedERC20BalancesByOwner: ERC20BalancesByOwner,
realERC20BalancesByOwner: ERC20BalancesByOwner, realERC20BalancesByOwner: ERC20BalancesByOwner,
expectedERC721TokenIdsByOwner: ERC721TokenIdsByOwner, expectedERC721TokenIdsByOwner: ERC721TokenIdsByOwner,
@ -153,8 +153,7 @@ export class MatchOrderTester {
this._erc721Wrapper = erc721Wrapper; this._erc721Wrapper = erc721Wrapper;
this._feeTokenAddress = feeTokenAddress; this._feeTokenAddress = feeTokenAddress;
} }
/// @dev Matches two complementary orders and verifies results. /// @dev Matches two complementary orders and asserts results.
/// Validation either succeeds or throws.
/// @param signedOrderLeft First matched order. /// @param signedOrderLeft First matched order.
/// @param signedOrderRight Second matched order. /// @param signedOrderRight Second matched order.
/// @param takerAddress Address of taker (the address who matched the two orders) /// @param takerAddress Address of taker (the address who matched the two orders)
@ -164,7 +163,7 @@ export class MatchOrderTester {
/// @param initialLeftOrderFilledAmount How much left order has been filled, prior to matching orders. /// @param initialLeftOrderFilledAmount How much left order has been filled, prior to matching orders.
/// @param initialRightOrderFilledAmount How much the right order has been filled, prior to matching orders. /// @param initialRightOrderFilledAmount How much the right order has been filled, prior to matching orders.
/// @return New ERC20 balances & ERC721 token owners. /// @return New ERC20 balances & ERC721 token owners.
public async matchOrdersAndVerifyBalancesAsync( public async matchOrdersAndAssertEffectsAsync(
signedOrderLeft: SignedOrder, signedOrderLeft: SignedOrder,
signedOrderRight: SignedOrder, signedOrderRight: SignedOrder,
takerAddress: string, takerAddress: string,
@ -181,8 +180,8 @@ export class MatchOrderTester {
if (initialRightOrderFilledAmount === undefined) { if (initialRightOrderFilledAmount === undefined) {
initialRightOrderFilledAmount = new BigNumber(0); initialRightOrderFilledAmount = new BigNumber(0);
} }
// Verify initial order states // Assert initial order states
await this._verifyInitialOrderStatesAsync( await this._assertInitialOrderStatesAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
initialLeftOrderFilledAmount, initialLeftOrderFilledAmount,
@ -196,24 +195,24 @@ export class MatchOrderTester {
); );
const newERC20BalancesByOwner = await this._erc20Wrapper.getBalancesAsync(); const newERC20BalancesByOwner = await this._erc20Wrapper.getBalancesAsync();
const newERC721TokenIdsByOwner = await this._erc721Wrapper.getBalancesAsync(); const newERC721TokenIdsByOwner = await this._erc721Wrapper.getBalancesAsync();
// Verify logs // Assert logs
await MatchOrderTester._verifyLogsAsync( await MatchOrderTester._assertLogsAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
transactionReceipt, transactionReceipt,
takerAddress, takerAddress,
expectedTransferAmounts, expectedTransferAmounts,
); );
// Verify exchange state // Assert exchange state
await this._verifyExchangeStateAsync( await this._assertExchangeStateAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
initialLeftOrderFilledAmount, initialLeftOrderFilledAmount,
initialRightOrderFilledAmount, initialRightOrderFilledAmount,
expectedTransferAmounts, expectedTransferAmounts,
); );
// Verify balances of makers, taker, and fee recipients // Assert balances of makers, taker, and fee recipients
await this._verifyBalancesAsync( await this._assertBalancesAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
erc20BalancesByOwner, erc20BalancesByOwner,
@ -225,25 +224,25 @@ export class MatchOrderTester {
); );
return [newERC20BalancesByOwner, newERC721TokenIdsByOwner]; return [newERC20BalancesByOwner, newERC721TokenIdsByOwner];
} }
/// @dev Verifies initial exchange state for the left and right orders. /// @dev Asserts initial exchange state for the left and right orders.
/// @param signedOrderLeft First matched order. /// @param signedOrderLeft First matched order.
/// @param signedOrderRight Second matched order. /// @param signedOrderRight Second matched order.
/// @param expectedOrderFilledAmountLeft How much left order has been filled, prior to matching orders. /// @param expectedOrderFilledAmountLeft How much left order has been filled, prior to matching orders.
/// @param expectedOrderFilledAmountRight How much the right order has been filled, prior to matching orders. /// @param expectedOrderFilledAmountRight How much the right order has been filled, prior to matching orders.
private async _verifyInitialOrderStatesAsync( private async _assertInitialOrderStatesAsync(
signedOrderLeft: SignedOrder, signedOrderLeft: SignedOrder,
signedOrderRight: SignedOrder, signedOrderRight: SignedOrder,
expectedOrderFilledAmountLeft: BigNumber, expectedOrderFilledAmountLeft: BigNumber,
expectedOrderFilledAmountRight: BigNumber, expectedOrderFilledAmountRight: BigNumber,
): Promise<void> { ): Promise<void> {
// Verify left order initial state // Assert left order initial state
const orderTakerAssetFilledAmountLeft = await this._exchangeWrapper.getTakerAssetFilledAmountAsync( const orderTakerAssetFilledAmountLeft = await this._exchangeWrapper.getTakerAssetFilledAmountAsync(
orderHashUtils.getOrderHashHex(signedOrderLeft), orderHashUtils.getOrderHashHex(signedOrderLeft),
); );
expect(expectedOrderFilledAmountLeft, 'Checking inital state of left order').to.be.bignumber.equal( expect(expectedOrderFilledAmountLeft, 'Checking inital state of left order').to.be.bignumber.equal(
orderTakerAssetFilledAmountLeft, orderTakerAssetFilledAmountLeft,
); );
// Verify right order initial state // Assert right order initial state
const orderTakerAssetFilledAmountRight = await this._exchangeWrapper.getTakerAssetFilledAmountAsync( const orderTakerAssetFilledAmountRight = await this._exchangeWrapper.getTakerAssetFilledAmountAsync(
orderHashUtils.getOrderHashHex(signedOrderRight), orderHashUtils.getOrderHashHex(signedOrderRight),
); );
@ -251,20 +250,20 @@ export class MatchOrderTester {
orderTakerAssetFilledAmountRight, orderTakerAssetFilledAmountRight,
); );
} }
/// @dev Verifies the exchange state against the expected amounts transferred by from matching orders. /// @dev Asserts the exchange state against the expected amounts transferred by from matching orders.
/// @param signedOrderLeft First matched order. /// @param signedOrderLeft First matched order.
/// @param signedOrderRight Second matched order. /// @param signedOrderRight Second matched order.
/// @param initialLeftOrderFilledAmount How much left order has been filled, prior to matching orders. /// @param initialLeftOrderFilledAmount How much left order has been filled, prior to matching orders.
/// @param initialRightOrderFilledAmount How much the right order has been filled, prior to matching orders. /// @param initialRightOrderFilledAmount How much the right order has been filled, prior to matching orders.
/// @return TransferAmounts A struct containing the expected transfer amounts. /// @return TransferAmounts A struct containing the expected transfer amounts.
private async _verifyExchangeStateAsync( private async _assertExchangeStateAsync(
signedOrderLeft: SignedOrder, signedOrderLeft: SignedOrder,
signedOrderRight: SignedOrder, signedOrderRight: SignedOrder,
initialLeftOrderFilledAmount: BigNumber, initialLeftOrderFilledAmount: BigNumber,
initialRightOrderFilledAmount: BigNumber, initialRightOrderFilledAmount: BigNumber,
expectedTransferAmounts: TransferAmounts, expectedTransferAmounts: TransferAmounts,
): Promise<void> { ): Promise<void> {
// Verify state for left order: amount bought by left maker // Assert state for left order: amount bought by left maker
let amountBoughtByLeftMaker = await this._exchangeWrapper.getTakerAssetFilledAmountAsync( let amountBoughtByLeftMaker = await this._exchangeWrapper.getTakerAssetFilledAmountAsync(
orderHashUtils.getOrderHashHex(signedOrderLeft), orderHashUtils.getOrderHashHex(signedOrderLeft),
); );
@ -273,7 +272,7 @@ export class MatchOrderTester {
expectedTransferAmounts.amountBoughtByLeftMaker, expectedTransferAmounts.amountBoughtByLeftMaker,
'Checking exchange state for left order', 'Checking exchange state for left order',
).to.be.bignumber.equal(amountBoughtByLeftMaker); ).to.be.bignumber.equal(amountBoughtByLeftMaker);
// Verify state for right order: amount bought by right maker // Assert state for right order: amount bought by right maker
let amountBoughtByRightMaker = await this._exchangeWrapper.getTakerAssetFilledAmountAsync( let amountBoughtByRightMaker = await this._exchangeWrapper.getTakerAssetFilledAmountAsync(
orderHashUtils.getOrderHashHex(signedOrderRight), orderHashUtils.getOrderHashHex(signedOrderRight),
); );
@ -282,7 +281,7 @@ export class MatchOrderTester {
expectedTransferAmounts.amountBoughtByRightMaker, expectedTransferAmounts.amountBoughtByRightMaker,
'Checking exchange state for right order', 'Checking exchange state for right order',
).to.be.bignumber.equal(amountBoughtByRightMaker); ).to.be.bignumber.equal(amountBoughtByRightMaker);
// Verify left order status // Assert left order status
const maxAmountBoughtByLeftMaker = signedOrderLeft.takerAssetAmount.minus(initialLeftOrderFilledAmount); const maxAmountBoughtByLeftMaker = signedOrderLeft.takerAssetAmount.minus(initialLeftOrderFilledAmount);
const leftOrderInfo: OrderInfo = await this._exchangeWrapper.getOrderInfoAsync(signedOrderLeft); const leftOrderInfo: OrderInfo = await this._exchangeWrapper.getOrderInfoAsync(signedOrderLeft);
const leftExpectedStatus = expectedTransferAmounts.amountBoughtByLeftMaker.equals(maxAmountBoughtByLeftMaker) const leftExpectedStatus = expectedTransferAmounts.amountBoughtByLeftMaker.equals(maxAmountBoughtByLeftMaker)
@ -291,7 +290,7 @@ export class MatchOrderTester {
expect(leftOrderInfo.orderStatus as OrderStatus, 'Checking exchange status for left order').to.be.equal( expect(leftOrderInfo.orderStatus as OrderStatus, 'Checking exchange status for left order').to.be.equal(
leftExpectedStatus, leftExpectedStatus,
); );
// Verify right order status // Assert right order status
const maxAmountBoughtByRightMaker = signedOrderRight.takerAssetAmount.minus(initialRightOrderFilledAmount); const maxAmountBoughtByRightMaker = signedOrderRight.takerAssetAmount.minus(initialRightOrderFilledAmount);
const rightOrderInfo: OrderInfo = await this._exchangeWrapper.getOrderInfoAsync(signedOrderRight); const rightOrderInfo: OrderInfo = await this._exchangeWrapper.getOrderInfoAsync(signedOrderRight);
const rightExpectedStatus = expectedTransferAmounts.amountBoughtByRightMaker.equals(maxAmountBoughtByRightMaker) const rightExpectedStatus = expectedTransferAmounts.amountBoughtByRightMaker.equals(maxAmountBoughtByRightMaker)
@ -301,7 +300,7 @@ export class MatchOrderTester {
rightExpectedStatus, rightExpectedStatus,
); );
} }
/// @dev Verifies account balances after matching orders. /// @dev Asserts account balances after matching orders.
/// @param signedOrderLeft First matched order. /// @param signedOrderLeft First matched order.
/// @param signedOrderRight Second matched order. /// @param signedOrderRight Second matched order.
/// @param initialERC20BalancesByOwner ERC20 balances prior to order matching. /// @param initialERC20BalancesByOwner ERC20 balances prior to order matching.
@ -310,7 +309,7 @@ export class MatchOrderTester {
/// @param finalERC721TokenIdsByOwner ERC721 token owners after order matching. /// @param finalERC721TokenIdsByOwner ERC721 token owners after order matching.
/// @param expectedTransferAmounts Expected amounts transferred as a result of order matching. /// @param expectedTransferAmounts Expected amounts transferred as a result of order matching.
/// @param takerAddress Address of taker (account that called Exchange.matchOrders). /// @param takerAddress Address of taker (account that called Exchange.matchOrders).
private async _verifyBalancesAsync( private async _assertBalancesAsync(
signedOrderLeft: SignedOrder, signedOrderLeft: SignedOrder,
signedOrderRight: SignedOrder, signedOrderRight: SignedOrder,
initialERC20BalancesByOwner: ERC20BalancesByOwner, initialERC20BalancesByOwner: ERC20BalancesByOwner,
@ -330,8 +329,8 @@ export class MatchOrderTester {
initialERC721TokenIdsByOwner, initialERC721TokenIdsByOwner,
expectedTransferAmounts, expectedTransferAmounts,
); );
// Verify balances of makers, taker, and fee recipients // Assert balances of makers, taker, and fee recipients
await this._verifyMakerTakerAndFeeRecipientBalancesAsync( await this._assertMakerTakerAndFeeRecipientBalancesAsync(
signedOrderLeft, signedOrderLeft,
signedOrderRight, signedOrderRight,
expectedERC20BalancesByOwner, expectedERC20BalancesByOwner,
@ -340,8 +339,8 @@ export class MatchOrderTester {
finalERC721TokenIdsByOwner, finalERC721TokenIdsByOwner,
takerAddress, takerAddress,
); );
// Verify balances for all known accounts // Assert balances for all known accounts
await MatchOrderTester._verifyAllKnownBalancesAsync( await MatchOrderTester._assertAllKnownBalancesAsync(
expectedERC20BalancesByOwner, expectedERC20BalancesByOwner,
finalERC20BalancesByOwner, finalERC20BalancesByOwner,
expectedERC721TokenIdsByOwner, expectedERC721TokenIdsByOwner,
@ -465,7 +464,7 @@ export class MatchOrderTester {
return [expectedNewERC20BalancesByOwner, expectedNewERC721TokenIdsByOwner]; return [expectedNewERC20BalancesByOwner, expectedNewERC721TokenIdsByOwner];
} }
/// @dev Verifies ERC20 account balances and ERC721 token holdings that result from order matching. /// @dev Asserts ERC20 account balances and ERC721 token holdings that result from order matching.
/// Specifically checks balances of makers, taker and fee recipients. /// Specifically checks balances of makers, taker and fee recipients.
/// @param signedOrderLeft First matched order. /// @param signedOrderLeft First matched order.
/// @param signedOrderRight Second matched order. /// @param signedOrderRight Second matched order.
@ -474,7 +473,7 @@ export class MatchOrderTester {
/// @param expectedERC721TokenIdsByOwner Expected ERC721 token owners. /// @param expectedERC721TokenIdsByOwner Expected ERC721 token owners.
/// @param realERC721TokenIdsByOwner Real ERC20 token owners. /// @param realERC721TokenIdsByOwner Real ERC20 token owners.
/// @param takerAddress Address of taker (account that called Exchange.matchOrders). /// @param takerAddress Address of taker (account that called Exchange.matchOrders).
private async _verifyMakerTakerAndFeeRecipientBalancesAsync( private async _assertMakerTakerAndFeeRecipientBalancesAsync(
signedOrderLeft: SignedOrder, signedOrderLeft: SignedOrder,
signedOrderRight: SignedOrder, signedOrderRight: SignedOrder,
expectedERC20BalancesByOwner: ERC20BalancesByOwner, expectedERC20BalancesByOwner: ERC20BalancesByOwner,