> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tenderly.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Single Simulations
> execution, balance और asset परिवर्तन, logs, और call trace का पूर्वावलोकन करने के लिए JSON-RPC या Simulation API पर एक single transaction का simulation करें।
Tenderly [RPC](/simulations/single-simulations#simulate-via-rpc) और [API](/simulations/single-simulations#simulate-via-api) के माध्यम से single transaction simulations का समर्थन करता है। Simulations चुने गए नेटवर्क की नवीनतम स्थिति पर निष्पादित होते हैं।
Dapps और वॉलेट single simulations का उपयोग अपने उपयोगकर्ताओं को वास्तविक असेट्स प्रतिबद्ध करने से पहले transactions का dry-run करने का एक तरीका देने के लिए कर सकते हैं। यह उन्हें हुए विस्तृत balance और asset परिवर्तनों के साथ transaction execution का पूर्वावलोकन देता है। Transaction previews उपयोगकर्ताओं को dapps में विश्वास बनाने, केवल सफल transactions को approve करने, और महँगी विफलताओं को रोकने में मदद कर सकते हैं।
## RPC के माध्यम से Simulate करें
[Node RPC](/node-rpc/overview) आपको blockchain डेटा पढ़ने और transactions भेजने की अनुमति देता है। लेकिन आप Node पर transactions का simulation भी कर सकते हैं। RPC के माध्यम से simulate करने का लाभ यह है कि आप ये सभी operations एक ही RPC URL के माध्यम से कर सकते हैं।
RPC या API के माध्यम से Simulations केवल समर्थित नेटवर्क पर उपलब्ध हैं। [समर्थित नेटवर्क](/platform/supported-networks) की सूची देखें।
अपना RPC URL और एक्सेस कुंजी [Dashboard](https://dashboard.tenderly.co/register?redirectTo=gateways) से प्राप्त करें।
**Node** > इच्छित नेटवर्क का **Copy HTTPS URL** पर जाएँ।
```bash title="example" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
https://mainnet.gateway.tenderly.co/$TENDERLY_NODE_ACCESS_KEY
```
RPC के माध्यम से एक single transaction का simulation करने के लिए, `tenderly_simulateTransaction` विधि को कॉल करें। [RPC reference देखें](/node-rpc/rpc-reference?network=ethereum-mainnet\&method=tenderly_simulateTransaction)।
**उदाहरण**
```bash title="request" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl https://mainnet.gateway.tenderly.co/$TENDERLY_NODE_ACCESS_KEY \
-X POST \
-H "Content-Type: application/json" \
-d \
'{
"id": 0,
"jsonrpc": "2.0",
"method": "tenderly_simulateTransaction",
"params": [
{
"from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"gas": "0x7a1200",
"value": "0x0",
"data": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b"
},
"0xfc497b"
]
}'
```
```json title="response.json" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
"id": 0,
"jsonrpc": "2.0",
"result": {
"status": true,
"gasUsed": "0xb412",
"cumulativeGasUsed": "0xb412",
"blockNumber": "0xfc497b",
"type": "0x0",
"logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000028000000000000000002000000000000000000000010000000000000000004000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000010000000000000000000000000040000000000000000000000000000800000",
"logs": [
{
"name": "Approval",
"anonymous": false,
"inputs": [
{
"value": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"type": "address",
"name": "src",
"indexed": true
},
{
"value": "0xf1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1",
"type": "address",
"name": "guy",
"indexed": true
},
{
"value": "299",
"type": "uint256",
"name": "wad",
"indexed": false
}
],
"raw": {
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"topics": [
"0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
"0x000000000000000000000000e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"0x000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1"
],
"data": "0x000000000000000000000000000000000000000000000000000000000000012b"
}
}
],
"trace": [
{
"type": "CALL",
"from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"gas": "0x79bdb0",
"gasUsed": "0x5fc2",
"value": "0x0",
"input": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b",
"decodedInput": [
{
"value": "0xf1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1",
"type": "address",
"name": "usr",
"indexed": false
},
{
"value": "299",
"type": "uint256",
"name": "wad",
"indexed": false
}
],
"method": "approve",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001",
"decodedOutput": [
{
"value": true,
"type": "bool",
"indexed": false
}
],
"subtraces": 0,
"traceAddress": []
}
],
"exposureChanges": [
{
"assetInfo": {
"standard": "ERC20",
"type": "Fungible",
"contractAddress": "0x6b175474e89094c44da98b954eedeac495271d0f",
"symbol": "dai",
"name": "Dai",
"logo": "https://coin-images.coingecko.com/coins/images/9956/large/Badge_Dai.png?1696509996",
"decimals": 18,
"dollarValue": "1"
},
"type": "Approve",
"owner": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"spender": "0xf1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1",
"rawAmount": "0x12b",
"amount": "0.000000000000000299",
"dollarValue": "0.000000000000000299"
}
],
"stateChanges": [
{
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"storage": [
{
"slot": "0x6f18ad69436c83a0d8b2c05ee70fa64e30403b1755cc38ee9cb6245926b14b17",
"previousValue": "0x0000000000000000000000000000000000000000000000000000000000000000",
"newValue": "0x000000000000000000000000000000000000000000000000000000000000012b"
}
]
},
{
"address": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"nonce": {
"previousValue": "0x0",
"newValue": "0x1"
}
}
]
}
}
```
## API के माध्यम से Simulate करें
विभिन्न पैरामीटर्स के साथ single transaction का simulation करने के लिए [simulate API endpoint](/api-reference) का उपयोग करें।
Virtual Environments पर Simulations का उपयोग करने के लिए, हम [Simulate RPC](/node-rpc/rpc-reference?network=ethereum-mainnet\&method=tenderly_simulateTransaction) और [Bundle Simulate RPC](/node-rpc/rpc-reference?network=ethereum-mainnet\&method=tenderly_simulateBundle) की अनुशंसा करते हैं।
अन्यथा, आप [Virtual Environments Simulation API](/api-reference) का उपयोग कर सकते हैं।
URL में आपका **account slug** और **project slug** होना चाहिए। slugs खोजने के लिए इस [quick guide](/platform/account/projects/slug) का पालन करें।
```bash title="Simulation API endpoint on public network" showLineNumbers wrap theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
https://api.tenderly.co/api/v1/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/simulate
```
```bash title="Simulation API endpoint on a Virtual Environment" showLineNumbers wordWrap=true theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
https://api.tenderly.co/api/v1/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/vnets/{vnetId}/transactions/simulate
```
आपको API एक्सेस टोकन भी प्राप्त करना होगा, जो headers के साथ भेजा जाता है। जानें कि [API एक्सेस कुंजी यहाँ कैसे उत्पन्न करें](/platform/account/projects/api-tokens)।
### अनुरोध payload
API एंडपॉइंट पर `POST` अनुरोध भेजें। अनुरोध payload के पूर्ण विवरण के लिए, [API reference देखें](/api-reference)।
Simulated payload `eth_call` JSON RPC कॉल के समान है।
नीचे दिए गए फ़ील्ड आवश्यक हैं:
* `network_id` (string): नेटवर्क का ID जहाँ आप simulation चलाना चाहते हैं।
* `block_number` (number): "latest" या simulation के लिए उपयोग किया जाने वाला block नंबर।
* `to` (string): transaction का प्राप्तकर्ता पता।
* `from` (string): transaction शुरू करने वाला पता।
* `input` (string): Encoded contract विधि कॉल डेटा।
* `gas` (number): simulation के लिए प्रदान की गई gas की मात्रा।
आप `from` फ़ील्ड में कोई भी sender पता निर्दिष्ट कर सकते हैं। चूँकि Tenderly *unsigned* transactions का simulation करता है, आपको एक विशिष्ट sender से transactions का simulation करने के लिए किसी account की निजी कुंजी का स्वामी होने की आवश्यकता नहीं है।
आप `simulation_type` भी निर्दिष्ट कर सकते हैं, जो full, quick, या ABI हो सकता है। यह फ़ील्ड आवश्यक नहीं है क्योंकि डिफ़ॉल्ट `full` पर सेट है। [Simulation Modes](/simulations/simulation-modes) के बारे में अधिक जानें।
API अनुरोध करते समय, `X-Access-Key` header जोड़ें जिसका मान एक्सेस टोकन हो।
**उदाहरण**
सुनिश्चित करें कि एक्सेस कुंजी को सुरक्षित रूप से एक `.env` फ़ाइल में संग्रहीत करें।
```ts title="request.ts" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
dotenv.config();
const simulateTransaction = async () => {
const { TENDERLY_ACCOUNT_SLUG, TENDERLY_PROJECT_SLUG, TENDERLY_ACCESS_KEY } = process.env;
const simulation = await axios.post(
`https://api.tenderly.co/api/v1/account/${TENDERLY_ACCOUNT_SLUG}/project/${TENDERLY_PROJECT_SLUG}/simulate`,
{
network_id: '1',
block_number: 16533883,
from: '0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2',
to: '0x6b175474e89094c44da98b954eedeac495271d0f',
gas: 8000000,
gas_price: 0,
value: 0,
input: '0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b',
simulation_type: 'quick',
},
{
headers: {
'X-Access-Key': TENDERLY_ACCESS_KEY as string,
},
},
);
console.log(simulation.data);
};
simulateTransaction();
```
```json title="response.json" showLineNumbers theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
{
"transaction": {
"hash": "0x7c1a33fb449b8d4eb5ec042d94d1c7ce2a5acae05f02af58ce4fd8b5c6beaf0a",
"block_hash": "",
"block_number": 16533883,
"from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"gas": 8000000,
"gas_price": 0,
"gas_fee_cap": 0,
"gas_tip_cap": 0,
"cumulative_gas_used": 0,
"gas_used": 46098,
"effective_gas_price": 0,
"input": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b",
"nonce": 0,
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"index": 0,
"value": "0x",
"access_list": null,
"status": true,
"addresses": null,
"contract_ids": null,
"network_id": "1",
"timestamp": "2023-02-01T12:11:23Z",
"function_selector": "",
"l1_block_number": 0,
"l1_timestamp": 0,
"deposit_tx": false,
"system_tx": false,
"sig": {
"v": "0x0",
"r": "0x0",
"s": "0x0"
},
"transaction_info": {
"contract_id": "eth:1:0x6b175474e89094c44da98b954eedeac495271d0f",
"block_number": 16533883,
"transaction_id": "0x7c1a33fb449b8d4eb5ec042d94d1c7ce2a5acae05f02af58ce4fd8b5c6beaf0a",
"contract_address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"method": null,
"parameters": null,
"intrinsic_gas": 21584,
"refund_gas": 0,
"call_trace": {
"hash": "0x7c1a33fb449b8d4eb5ec042d94d1c7ce2a5acae05f02af58ce4fd8b5c6beaf0a",
"contract_name": "",
"function_pc": 0,
"function_op": "CALL",
"absolute_position": 0,
"caller_pc": 0,
"caller_op": "CALL",
"call_type": "CALL",
"address": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"from_balance": "0",
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"to_balance": "0",
"value": "0",
"block_timestamp": "0001-01-01T00:00:00Z",
"gas": 7978416,
"gas_used": 24514,
"intrinsic_gas": 21584,
"storage_address": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"input": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b",
"nonce_diff": [
{
"address": "0xe2E2E2e2e2e2E2E2E2E2e2E2e2E2E2e2e2e2E2e2",
"original": "0",
"dirty": "1"
}
],
"state_diff": [
{
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"soltype": null,
"original": null,
"dirty": null,
"raw": [
{
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"key": "0x6f18ad69436c83a0d8b2c05ee70fa64e30403b1755cc38ee9cb6245926b14b17",
"original": "0x0000000000000000000000000000000000000000000000000000000000000000",
"dirty": "0x000000000000000000000000000000000000000000000000000000000000012b"
}
]
}
],
"logs": [
{
"name": "",
"anonymous": false,
"inputs": null,
"raw": {
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"topics": [
"0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
"0x000000000000000000000000e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"0x000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1"
],
"data": "0x000000000000000000000000000000000000000000000000000000000000012b"
},
"trace_index": null
}
],
"output": "0x0000000000000000000000000000000000000000000000000000000000000001",
"decoded_output": null,
"network_id": "1",
"calls": null
},
"stack_trace": null,
"logs": [
{
"name": "",
"anonymous": false,
"inputs": null,
"raw": {
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"topics": [
"0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925",
"0x000000000000000000000000e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"0x000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1"
],
"data": "0x000000000000000000000000000000000000000000000000000000000000012b"
},
"trace_index": null
}
],
"balance_diff": null,
"nonce_diff": [
{
"address": "0xe2E2E2e2e2e2E2E2E2E2e2E2e2E2E2e2e2e2E2e2",
"original": "0",
"dirty": "1"
}
],
"state_diff": [
{
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"soltype": null,
"original": null,
"dirty": null,
"raw": [
{
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"key": "0x6f18ad69436c83a0d8b2c05ee70fa64e30403b1755cc38ee9cb6245926b14b17",
"original": "0x0000000000000000000000000000000000000000000000000000000000000000",
"dirty": "0x000000000000000000000000000000000000000000000000000000000000012b"
}
]
}
],
"raw_state_diff": null,
"console_logs": null,
"asset_changes": null,
"balance_changes": [],
"created_at": "2023-02-01T12:11:23Z"
},
"method": "",
"decoded_input": null,
"call_trace": [
{
"call_type": "CALL",
"from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"gas": 7978416,
"gas_used": 24514,
"address": "0x6b175474e89094c44da98b954eedeac495271d0f",
"input": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b",
"output": "0x0000000000000000000000000000000000000000000000000000000000000001"
}
]
},
"simulation": {
"id": "cc4d422b-149c-4043-83ec-d2670c9ffe2c",
"project_id": "dfdc391a-a15d-4590-9aef-8691259c7df4",
"owner_id": "7d5e8b1f-8bf8-4eae-a70f-fb7d354b1cc2",
"network_id": "1",
"block_number": 16533883,
"transaction_index": 0,
"from": "0xe2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2e2",
"to": "0x6b175474e89094c44da98b954eedeac495271d0f",
"input": "0x095ea7b3000000000000000000000000f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1f1000000000000000000000000000000000000000000000000000000000000012b",
"gas": 8000000,
"gas_price": "0",
"gas_used": 46098,
"value": "0",
"status": true,
"access_list": null,
"queue_origin": "",
"block_header": {
"number": "0xfc497b",
"hash": "0x0000000000000000000000000000000000000000000000000000000000000000",
"stateRoot": "0x3a3fd616aa768fc45b78d02fbd216e6a49a19153f92a091f5c4e9a2bbe494ef1",
"parentHash": "0x57067724ea963c92291770db13ff945f9b7e11689d2494ba318cea6cdab1c2e2",
"sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
"transactionsRoot": "0x912f0d5b52a308205d1c1a9b15409cbd455b414ac2d2bcb5b13ef01a5b4a41d8",
"receiptsRoot": "0xfdc2b958b59f3ded07e132764112429f8e2827ed0e1d67954e05ee1be5e7e203",
"logsBloom": "0xb0abe9644746d77234090df88b0c836b0d2966107c87597c568582618cc4c773104a2da2b011d90310a8db958c13cb208f196333ba08bb86625b405301beaf22028a2193076aaf7ffb0b64eb77ea6827ec293ac4fb754b719744ff2dd9813d751e5808704bc645bf31107e8472742879cd7acb090b643d4cc27986da095ced5c028143df0223190d1d515345a7e2b1a33333b52587c0c688e57e06e8a390493faff909012981eb860ea2ebc1153684e025c27e2460ae28db74e35eb260fbf8e9522c805356b1022928e8b408235e5e824d7483ecf4ba985a9b470c760c58e06716f0fc28003633d86c35ba840f3512c480039004724dd25a9e599898fab73cf3",
"timestamp": "0x63da56eb",
"difficulty": "0x0",
"gasLimit": "0x1c9c380",
"gasUsed": "0xcb7693",
"miner": "0xdafea492d9c6733ae3d56b7ed1adb60692c98bc5",
"extraData": "0x496c6c756d696e61746520446d6f63726174697a6520447374726962757465",
"mixHash": "0x43f7931adf192e8addc95bfae45f9db586434110ef7eac2d765e4a4b9ed6de4e",
"nonce": "0x0000000000000000",
"baseFeePerGas": "0x32c42d070",
"size": "0x0",
"totalDifficulty": "0x0",
"uncles": null,
"transactions": null
},
"deposit_tx": false,
"system_tx": false,
"nonce": 0,
"addresses": null,
"contract_ids": null,
"shared": false,
"created_at": "2024-01-08T17:30:06.992859393Z"
},
"contracts": [],
"generated_access_list": []
}
```
## उपयोग के मामले जानें
* [**Transaction परिणामों का पूर्वावलोकन**](/simulations/transaction-preview): उन समस्याओं की पहचान करें और उन्हें ठीक करें जो transactions को विफल कर सकती हैं।
* [**Asset और balance परिवर्तन**](/simulations/asset-balance-changes): होने वाले सभी balance और asset परिवर्तनों के लिए सटीक डॉलर मूल्य प्राप्त करें।
* [**Gas अनुमान**](/simulations/gas-estimation): transaction भेजने से पहले gas लागतों की सटीक भविष्यवाणी करें।
* [**State overrides**](/simulations/state-overrides): विभिन्न परिदृश्यों का परीक्षण करने के लिए timestamps और contract डेटा जैसी blockchain स्थितियों को संशोधित करें।
## आगे कहाँ जाएँ