Security News
Introducing the Socket Python SDK
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
hardhat-chai-matchers-viem
Advanced tools
Note: THIS IS NOT AN OFFICIAL HARDHAT PACKAGE. IT WAS FORKED FROM ONE.
This plugin adds Ethereum-specific capabilities to the Chai assertion library, making your smart contract tests easy to write and read.
It is based on @nomicfoundation/hardhat-chai-matchers which is for ethers. Check its documentation to learn more.
We recommend using npm 7 or later. If you do that, then you just need to install the plugin itself:
npm install --save-dev hardhat-chai-matchers-viem
If you are using an older version of npm, you'll also need to install all the packages used by the plugin.
npm install --save-dev hardhat-chai-matchers-viem chai@4 @nomicfoundation/hardhat-viem viem
That's also the case if you are using yarn:
yarn add --dev hardhat-chai-matchers-viem chai@4 @nomicfoundation/hardhat-viem viem
After installing it, add the plugin to your Hardhat config:
require("hardhat-chai-matchers-viem");
Then you'll be able to use the matchers in your tests:
expect(await token.read.totalSupply()).to.equal(1_000_000);
await expect(token.write.transfer([token, 1000n])).to.be.revertedWith(
"Cannot transfer to the contract itself"
);
await expect(token.write.transfer([recipient, 1000n]))
.to.emit(token, "Transfer")
.withArgs(owner, recipient, 1000);
Currently, the following matchers do not support chaining:
reverted
revertedWith
revertedWithCustomError
revertedWithoutReason
revertedWithPanic
changeEtherBalance
changeEtherBalances
changeTokenBalance
changeTokenBalances
emit
(with the only exception of chaining multiple emit
matchers)Which means you can't do:
await expect(contract.f(...))
.to.changeEtherBalance(...)
.and.to.changeTokenBalance(...)
To work around this limitation, write separate assertions for each matcher:
const tx = contract.f(...);
await expect(tx).to.changeEtherBalance(...)
await expect(tx).to.changeTokenBalance(...)
If you are interested in seeing an implementation of chaining for async matchers, please visit the GitHub issue #4235 and leave an upvote or comment.
FAQs
Hardhat utils for testing
The npm package hardhat-chai-matchers-viem receives a total of 148 weekly downloads. As such, hardhat-chai-matchers-viem popularity was classified as not popular.
We found that hardhat-chai-matchers-viem demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
The initial version of the Socket Python SDK is now on PyPI, enabling developers to more easily interact with the Socket REST API in Python projects.
Security News
Floating dependency ranges in npm can introduce instability and security risks into your project by allowing unverified or incompatible versions to be installed automatically, leading to unpredictable behavior and potential conflicts.
Security News
A new Rust RFC proposes "Trusted Publishing" for Crates.io, introducing short-lived access tokens via OIDC to improve security and reduce risks associated with long-lived API tokens.