viem-deal

Easily deal arbitrary amounts of any ERC20 tokens to any account on any setStorageAt-compatible network, including in hardhat, tevm, or anvil-based forks!

NB: deal is the name of a cheat code introduced by foundry, which "mints" without actually minting ERC20 tokens - it's overriding the storage of the balance of the given recipient

The storage slot of the mapping balanceOf is retrieved via eth_createAccessList and the given user's balance is manipulated via setStorageAt.

Warning

The package is known to have unexpected side effects when used to deal dust of stETH... Be careful!

Installation

npm install viem-deal

yarn add viem-deal

Usage

Testing

import { createTestClient, http } from 'viem';
import { foundry } from 'viem/chains';
import { dealActions } from 'viem-deal';

const client = createTestClient({
  mode: 'anvil',
  chain: foundry,
  transport: http(),
}).extend(dealActions);

// Deal 100 USDC to test address.
await client.deal({
  erc20: "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  recipient: "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  amount: parseUnits("100", 6),
});