मुख्य सामग्री पर जाएं
Tenderly REST API Virtual Environments बनाने, list करने, और प्रबंधित करने के लिए endpoints उजागर करता है। script से इन्हें कैसे कॉल करें, इसके walkthrough के लिए, देखें API के माध्यम से Virtual Environments बनाएं। पूर्ण API surface के लिए, देखें API Reference सभी environment endpoints base URL का उपयोग करते हैं:
https://api.tenderly.co/api/public/v1/account/{accountSlug}/project/{projectSlug}

Authentication

सभी requests के लिए एक X-Access-Key header की आवश्यकता होती है। Tenderly Dashboard में Account Settings → Authorization से एक key उत्पन्न करें। देखें API tokens
X-Access-Key: <your-access-key>

एक environment बनाएं

POST /environments
एक या अधिक networks के साथ एक नया environment बनाता है। Single-network और multi-network दोनों environments इस endpoint का उपयोग करते हैं, single-network environment के लिए network_configs में एक entry पास करें, या multi-network के लिए कई entries।

Request body

Fieldप्रकारआवश्यकविवरण
display_namestringहाँdashboard में दिखाया जाने वाला Human-readable नाम।
slugstringनहींURL-safe identifier। यदि छोड़ा गया हो तो display_name से Auto-generated।
network_configsarrayहाँenvironment में प्रत्येक network के लिए एक entry।
network_configs[].network_idstringहाँfork करने के लिए network का Chain ID (जैसे Ethereum के लिए "1")।
network_configs[].block_numberstringनहींhex में Fork point। latest block पर डिफ़ॉल्ट होता है।
network_configs[].chain_config_overrides.chain_idstringनहींइस Virtual Environment को assigned chain ID को Override करें।
network_configs[].explorer_config.enabledbooleanनहींएक public explorer page उजागर करें।
network_configs[].explorer_config.verification_visibilitystringनहीं"bytecode", "abi", या "source"
network_configs[].accountsarrayनहींPre-funded accounts. प्रत्येक entry में address और balance (Wei, hex-encoded) होते हैं।
bridge_config.enabledbooleanनहींइस environment में networks के बीच cross-chain bridging सक्षम करें।
bridge_config.relay_modestringनहीं"autoRelay" (डिफ़ॉल्ट) या "delayedRelay"
bridge_config.delay_secondsintegerनहीं"delayedRelay" का उपयोग करते समय Relay delay सेकंड में।

Single-network example

request.json
{
  "display_name": "Staging Mainnet",
  "slug": "staging-mainnet",
  "network_configs": [
    {
      "network_id": "1",
      "block_number": "latest",
      "chain_config_overrides": { "chain_id": "73571" },
      "explorer_config": { "enabled": false, "verification_visibility": "bytecode" }
    }
  ]
}

Multi-network example

request.json
{
  "display_name": "Cross-chain Staging",
  "network_configs": [
    {
      "network_id": "1",
      "block_number": "latest",
      "chain_config_overrides": { "chain_id": "1" }
    },
    {
      "network_id": "42161",
      "block_number": "latest",
      "chain_config_overrides": { "chain_id": "42161" }
    },
    {
      "network_id": "8453",
      "block_number": "latest",
      "chain_config_overrides": { "chain_id": "8453" }
    }
  ],
  "bridge_config": { "enabled": true, "relay_mode": "autoRelay" }
}

Response

बनाए गए environment object को लौटाता है। active_instance.vnets array में प्रति network एक entry होती है, प्रत्येक अपने RPC endpoints के साथ।
response.json
{
  "id": "d998eea3-139d-4477-9de2-42f7739362f0",
  "display_name": "Staging Mainnet",
  "slug": "staging-mainnet",
  "created_at": "2026-06-08T10:00:00.000Z",
  "networks": [
    {
      "id": "a1b2c3d4-...",
      "network_id": "1",
      "network_name": "Ethereum Mainnet",
      "block_number": "0x168a5c6"
    }
  ],
  "active_instance": {
    "id": "e5f6a7b8-...",
    "vnets": [
      {
        "id": "f9e8d7c6-...",
        "display_name": "Staging Mainnet",
        "slug": "staging-mainnet",
        "status": "running",
        "rpcs": [
          { "name": "Admin RPC", "url": "https://virtual.mainnet.rpc.tenderly.co/..." },
          { "name": "Public RPC", "url": "https://virtual.mainnet.rpc.tenderly.co/..." }
        ],
        "fork_config": { "network_id": 1, "block_number": "0x168a5c6" }
      }
    ]
  }
}
प्रत्येक entry पर rpcs array में Admin RPC (पूर्ण चीटकोड पहुँच) और Public RPC (मानक JSON-RPC) होते हैं।

environments list करें

GET /environments
Project के लिए सभी environments लौटाता है।

एक environment प्राप्त करें

GET /environments/{environmentId}
ID द्वारा एक single environment लौटाता है, इसके active_instance और RPC endpoints सहित।

एक environment हटाएँ

DELETE /environments/{environmentId}
एक single environment को स्थायी रूप से हटाता है। 204 No Content लौटाता है।

environments को Batch delete करें

DELETE /environments
एक call में कई environments को स्थायी रूप से हटाता है। request body में IDs पास करें।

transactions list करें

GET /environments/{environmentId}/instance/{instanceId}/transactions
एक environment instance में सभी Virtual Environments में transactions लौटाता है। Pagination और status, category, kind, और from/to address द्वारा वैकल्पिक filters का समर्थन करता है।

एक transaction प्राप्त करें

GET /environments/{environmentId}/instance/{instanceId}/transactions/{txHash}
Transaction hash द्वारा एक environment instance से एक single transaction लौटाता है।

एक transaction भेजें

POST /environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions
एक environment instance के भीतर एक विशिष्ट Virtual Environment पर एक transaction execute करता है। State संरक्षित है।

एक transaction Simulate करें

POST /environments/{environmentId}/instance/{instanceId}/vnet/{vnetId}/transactions/simulate
state को संरक्षित किए बिना एक transaction को simulate करता है। block overrides, state overrides, और एक custom block number का समर्थन करता है। एक विस्तृत simulation परिणाम लौटाता है जिसमें call trace, state changes, और emitted events शामिल हैं।

यह भी देखें