Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Check out our new component library - build.abs.xyz!
Learn how to test your smart contracts using Foundry.
Write test definitions
/test directory, for example, test/HelloWorld.t.sol.// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
import { Test } from "forge-std/Test.sol";
contract HelloWorldTest is Test {
function setUp() public {
owner = makeAddr("owner");
vm.prank(owner);
helloWorld = new HelloWorld();
}
function test_HelloWorld() public {
helloWorld.setMessage("Hello, World!");
assertEq(helloWorld.getMessage(), "Hello, World!");
}
}
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;
contract HelloWorld {
string public message = "Hello, World!";
function setMessage(string memory newMessage) public {
message = newMessage;
}
function getMessage() public view returns (string memory) {
return message;
}
}
Run tests
forge test --zksync
// This works ✅
function testCheatcodeAtRootLevel() public {
vm.roll(10); // Valid: called directly from test
vm.prank(someAddress); // Valid: called directly from test
MyContract testContract = new MyContract();
testContract.someFunction(); // Cheatcodes not available inside this call
}
// This won't work as expected ❌
contract MyContract {
function someFunction() public {
vm.warp(1000); // Invalid: called from within a contract
}
}
| Cheatcode | Description |
|---|---|
zkVm | Enables/disables ZKsync context for transactions. Switches between EVM and zkEVM execution environments. |
zkVmSkip | When running in zkEVM context, skips the next CREATE or CALL, executing it on the EVM instead. |
zkRegisterContract | Registers bytecodes for ZK-VM for transact/call and create instructions. Useful for testing with contracts already deployed on-chain. |
zkUsePaymaster | Configures a paymaster for the next transaction. Enables testing paymasters for gasless transactions. |
zkUseFactoryDep | Registers a factory dependency for the next transaction. Useful for testing complex contract deployments. |
forge test --zksync --fork-url https://api.testnet.abs.xyz
forge test --zksync --fork-url https://api.mainnet.abs.xyz
anvil-zksync
forge test --zksync --fork-url http://localhost:8011
Was this page helpful?