Solidity Cheatcodes

प्रत्येक Virtual Environment 0xc100000000000000000000000000000000000000 पर एक precompile contract उजागर करता है। एक transaction के अंदर से इस precompile पर functions को call करने से आपके contracts on-chain state को सीधे manipulate कर सकते हैं, storage slots, ETH balances, ERC-20 token balances, nonces, और event logs, बिना accounts को impersonate किए या helper proxies deploy किए। ये cheatcodes Admin RPC methods के पूरक हैं। Admin RPC methods transaction के बाहर से state को manipulate करते हैं (JSON-RPC के माध्यम से)। precompile transaction के अंदर से state को manipulate करता है (Solidity call के माध्यम से)। precompile का उपयोग तब करें जब आपके setup को atomic रहने, tx hash से replayable होने, या कई slots पर एक loop में चलने की आवश्यकता हो।

Interface

इस file को अपने project में IVnetPrecompile.sol के रूप में जोड़ें:

IVnetPrecompile.sol

// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

interface IVnetPrecompile {
    function setStorageAt(address target, bytes32 slot, bytes32 value) external returns (bool);
    function setBalance(address[] calldata addresses, uint256 balance) external returns (bool);
    function getStorageAt(address target, bytes32 slot) external view returns (bytes32);
    function addBalance(address[] calldata addresses, uint256 amount) external returns (bool);
    function setNonce(address target, uint256 value) external returns (bool);
    function setErc20Balance(address target, address[] calldata addresses, uint256 amount) external returns (bool);
    function addErc20Balance(address target, address[] calldata addresses, uint256 amount) external returns (bool);
    function setMaxErc20Balance(address target, address account) external returns (bool);

    function emitEvent(address target, bytes calldata data) external returns (bool);
    function emitEvent(address target, bytes32 topic1) external returns (bool);
    function emitEvent(address target, bytes32 topic1, bytes calldata data) external returns (bool);
    function emitEvent(address target, bytes32 topic1, bytes32 topic2) external returns (bool);
    function emitEvent(address target, bytes32 topic1, bytes32 topic2, bytes calldata data) external returns (bool);
    function emitEvent(address target, bytes32 topic1, bytes32 topic2, bytes32 topic3) external returns (bool);
    function emitEvent(address target, bytes32 topic1, bytes32 topic2, bytes32 topic3, bytes calldata data) external returns (bool);
    function emitEvent(address target, bytes32 topic1, bytes32 topic2, bytes32 topic3, bytes32 topic4) external returns (bool);
    function emitEvent(address target, bytes32 topic1, bytes32 topic2, bytes32 topic3, bytes32 topic4, bytes calldata data) external returns (bool);

    event SetStorageAtEvent(address target, bytes32 slot, bytes32 value);
    event SetBalanceEvent(address[] addresses, uint256 balance);
    event AddBalanceEvent(address[] addresses, uint256 amount);
    event SetNonceEvent(address target, uint256 value);
    event SetErc20BalanceEvent(address target, address[] addresses, uint256 amount);
    event AddErc20BalanceEvent(address target, address[] addresses, uint256 amount);
    event SetMaxErc20BalanceEvent(address target, address account);
}

अपने contract में fixed address पर इसे reference करें:

IVnetPrecompile constant VNET = IVnetPrecompile(0xc100000000000000000000000000000000000000);

Functions

Storage

Function	Parameters	Returns	विवरण
`setStorageAt`	`address target`, `bytes32 slot`, `bytes32 value`	`bool`	`target` पर `slot` में `value` लिखता है।
`getStorageAt`	`address target`, `bytes32 slot`	`bytes32`	`target` पर `slot` का वर्तमान मान पढ़ता है।

VNET.setStorageAt(tokenContract, balanceSlot, bytes32(uint256(1000e18)));
bytes32 val = VNET.getStorageAt(tokenContract, balanceSlot);

Balance

Function	Parameters	Returns	विवरण
`setBalance`	`address[] addresses`, `uint256 balance`	`bool`	`addresses` में हर address का ETH balance एक exact मान पर सेट करता है।
`addBalance`	`address[] addresses`, `uint256 amount`	`bool`	`addresses` में हर address के वर्तमान ETH balance में `amount` जोड़ता है।

address[] memory accounts = new address[](2);
accounts[0] = alice;
accounts[1] = bob;
VNET.setBalance(accounts, 10 ether);
VNET.addBalance(accounts, 2 ether);

ERC-20 balances

Function	Parameters	Returns	विवरण
`setErc20Balance`	`address target`, `address[] addresses`, `uint256 amount`	`bool`	`target` पर ERC-20 token पर `addresses` में हर address का balance `amount` पर सेट करता है।
`addErc20Balance`	`address target`, `address[] addresses`, `uint256 amount`	`bool`	`addresses` में हर address के वर्तमान token balance में `amount` जोड़ता है।
`setMaxErc20Balance`	`address target`, `address account`	`bool`	`account` का token balance अधिकतम मान (`2^256 - 1`) पर सेट करता है।

precompile token के balance storage slot को स्वचालित रूप से locate करता है, इसलिए किसी slot input की आवश्यकता नहीं है। मानक mapping layouts सीधे resolve होते हैं और पहले holder के बाद cache किए जाते हैं; गैर-मानक layouts token के balanceOf execution को probe करके खोजे जाते हैं।

address[] memory holders = new address[](2);
holders[0] = alice;
holders[1] = bob;
VNET.setErc20Balance(USDC, holders, 1_000_000e6);
VNET.addErc20Balance(USDC, holders, 500e6);
VNET.setMaxErc20Balance(USDC, alice);

जो tokens balance storage slot में अतिरिक्त flags pack करते हैं, वे balanceOf को उसी के अनुसार report करते हैं। उदाहरण के लिए, USDC slot के top bit को reserve करता है, इसलिए setMaxErc20Balance के बाद उसका balanceOf 2^255 - 1 लौटाता है।

Nonce

Function	Parameters	Returns	विवरण
`setNonce`	`address target`, `uint256 value`	`bool`	`target` की transaction count सेट करता है।

VNET.setNonce(account, 42);

Events

emitEvent एक log fire करता है जिसका address field target है, न कि calling contract। Downstream consumers (indexers, subgraphs, webhooks) log को target से real emission के रूप में मानते हैं। नौ overloads एक वैकल्पिक unindexed data payload के साथ शून्य से चार indexed topics कवर करते हैं:

Overload	Topics	Data
`emitEvent(target, data)`	0	✓
`emitEvent(target, t1)`	1	,
`emitEvent(target, t1, data)`	1	✓
`emitEvent(target, t1, t2)`	2	,
`emitEvent(target, t1, t2, data)`	2	✓
`emitEvent(target, t1, t2, t3)`	3	,
`emitEvent(target, t1, t2, t3, data)`	3	✓
`emitEvent(target, t1, t2, t3, t4)`	4	,
`emitEvent(target, t1, t2, t3, t4, data)`	4	✓

topic1 आमतौर पर keccak256("EventName(type,type,...)") होता है। उदाहरण, एक USDC Transfer spoof करें:

VNET.emitEvent(
    USDC,
    keccak256("Transfer(address,address,uint256)"),
    bytes32(uint256(uint160(from))),
    bytes32(uint256(uint160(to))),
    abi.encode(amount)
);

Cheatcode events

प्रत्येक state-changing cheatcode precompile address (0xc100000000000000000000000000000000000000) से एक संबंधित event उत्सर्जित करता है:

Cheatcode	Event
`setStorageAt`	`SetStorageAtEvent(address target, bytes32 slot, bytes32 value)`
`setBalance`	`SetBalanceEvent(address[] addresses, uint256 balance)`
`addBalance`	`AddBalanceEvent(address[] addresses, uint256 amount)`
`setNonce`	`SetNonceEvent(address target, uint256 value)`
`setErc20Balance`	`SetErc20BalanceEvent(address target, address[] addresses, uint256 amount)`
`addErc20Balance`	`AddErc20BalanceEvent(address target, address[] addresses, uint256 amount)`
`setMaxErc20Balance`	`SetMaxErc20BalanceEvent(address target, address account)`

emitEvent के माध्यम से spoof किए गए log के लिए receipt का निरीक्षण करते समय, precompile की अपनी entries को अनदेखा करने के लिए logs[] को target address द्वारा filter करें।

ज्ञात सीमाएँ

Base-आधारित Virtual Environments। Base पर Solidity cheatcodes उपलब्ध नहीं हैं।
Arbitrum-आधारित Virtual Environments। Arbitrum internals के कारण eth_call के माध्यम से किए गए Cheatcode calls काम नहीं करते। Transactions, gas estimates, और simulations अपेक्षित रूप से काम करते हैं।

यह भी देखें

Admin RPC, transaction के बाहर से state manipulation के लिए equivalent JSON-RPC methods।
Foundry cheatcode tutorial, एक reusable cheatcode playground deploy करने के लिए end-to-end walkthrough।

Getting Started

Simulator

Console

Monitor

Node RPC

Account & Settings

Solidity Cheatcodes

Interface

Functions

Storage

Balance

ERC-20 balances

Nonce

Events

Cheatcode events

ज्ञात सीमाएँ

यह भी देखें

​Interface

​Functions

​Storage

​Balance

​ERC-20 balances

​Nonce

​Events

​Cheatcode events

​ज्ञात सीमाएँ

​यह भी देखें

Interface

Functions

Storage

Balance

ERC-20 balances

Nonce

Events

Cheatcode events

ज्ञात सीमाएँ

यह भी देखें