truffle-assertions

핵심 개념

eventEmitted

트랜잭션 실행 결과 특정 이벤트가 발생했는지, 그리고 이벤트 인자 값이 기대한 조건과 일치하는지를 확인하는 함수다.

eventNotEmitted

특정 이벤트가 발생하지 않았음을 검증할 때 사용하며, 조건 분기에서 이벤트가 발생하지 않아야 정상인 케이스를 테스트한다.

reverts / fails

트랜잭션이 revert되거나 실패하는지, 그리고 원하는 경우 revert 메시지까지 일치하는지를 검증하는 함수 그룹이다.

transaction receipt

트랜잭션 실행 후 반환되는 결과 객체로, truffle-assertions는 이 receipt의 로그를 파싱해 이벤트 검증에 활용한다.

filter callback

eventEmitted 등에서 두 번째 인자로 콜백 함수를 넘겨 이벤트 인자 값에 대한 세부 조건을 직접 검사할 수 있게 해주는 패턴이다.

이벤트 발생 및 revert 검증

transfer 호출로 발생한 Transfer 이벤트의 인자를 검증하고, 잘못된 값 호출 시 지정한 메시지로 revert되는지 확인한다.

const truffleAssert = require('truffle-assertions');

it('should emit Transfer event and revert on invalid amount', async () => {
  const instance = await MyToken.deployed();

  const result = await instance.transfer(recipient, 100);
  truffleAssert.eventEmitted(result, 'Transfer', (ev) => {
    return ev.to === recipient && ev.value.toNumber() === 100;
  });

  await truffleAssert.reverts(
    instance.transfer(recipient, 0),
    'amount must be greater than zero'
  );
});