Simulator draft link साझा करें

Draft link Tenderly Simulator को prefilled form के साथ खोलता है: एक single call या multi-call bundle, जिसमें state overrides, funded balances और edited contract source शामिल हैं। जब तक प्राप्तकर्ता Simulate पर क्लिक नहीं करता, कुछ भी नहीं चलता, इसलिए link को test reports, pull requests, governance proposals या alerts में साझा करना सुरक्षित है। Draft server-side स्टोर होता है और id से referenced होता है। Link में स्वयं कोई payload या project नहीं होता: https://dashboard.tenderly.co/simulator/new?draftId=<id>

Dashboard से draft साझा करें

Simulator में simulation बनाएँ: network चुनें, एक या अधिक calls जोड़ें, overrides सेट करें, source edits लागू करें।
पेज header में Share draft पर क्लिक करें। Draft सेव हो जाता है और link आपके clipboard में कॉपी हो जाता है।

Link bundles और edited sources के लिए काम करता है, और इसकी कोई length limit नहीं है। Dashboard से साझा किया गया draft उस project के members द्वारा पढ़ा जा सकता है जिसमें यह सेव हुआ था, और यह स्वतः expire हो जाता है।

Simulator header जिसमें Simulate के बगल में Share draft बटन है, और tooltip बताता है कि link bundles और edited sources के लिए काम करता है — Simulator header में Share draft वर्तमान setup को सेव करता है और उसे फिर से खोलने वाला link कॉपी करता है।

Draft link खोलने पर क्या होता है

Dashboard draft के लिए एक request करता है, और फिर response के अनुसार:

Draft के project का member। Dashboard उस project के Simulator में redirect करता है, form prefilled होता है और कोई prompt नहीं आता।
Shared draft (API से shared: true के साथ बनाया गया)। पहले Select Project dialog खुलता है; draft उस project में खुलता है जिसे प्राप्तकर्ता चुनता है।
Invalid id, expired draft, या access नहीं। तीनों cases एक ही response देते हैं, ताकि draft ids को probe न किया जा सके। प्राप्तकर्ता को “This draft link is invalid, has expired, or you don’t have access to it.” दिखता है और वह dashboard home पर पहुँचता है।
Logged out। प्राप्तकर्ता पहले sign in करता है, फिर flow उसी link के साथ जारी रहता है।
Simulator में unsaved edits। Draft खोलने से वर्तमान form बदल जाता है, इसलिए dashboard edits हटाने से पहले confirmation माँगता है।

Shared draft link खोलने पर दिखने वाला Select Project dialog, जिसमें project dropdown है — Shared draft किसी project से बंधा नहीं होता, इसलिए प्राप्तकर्ता चुनता है कि इसे कहाँ खोलना है।

आंशिक पुनर्स्थापना

Draft की हर call स्वतंत्र रूप से restore होती है, इसलिए एक समस्याग्रस्त call पूरे draft को reject नहीं करती। एक dismissible banner हर call के लिए बताता है कि क्या restore नहीं हो सका:

Case	परिणाम
Contract load नहीं हो सका	Address रखा जाता है। पुनः प्रयास के लिए contract फिर से चुनें।
सेव किया गया function अब contract ABI में नहीं है	Function select खाली कर दिया जाता है। Function फिर से चुनें।
Call में imported ABI था	ABI text रखा जाता है लेकिन फिर से लागू नहीं होता। Edit ABI खोलें और इसे फिर से import करें।
Edited source compile नहीं हो सका	Source call पर बना रहता है; ABI verified contract पर fallback करता है। पुनः प्रयास के लिए Edit source खोलें और फिर से apply करें।
Funded ERC-20 token का balance slot resolve नहीं हो सका	Token form में बना रहता है। पुनः प्रयास के लिए इसे Fund address में फिर से चुनें।

Banner न होने का मतलब है कि सब कुछ restore हो गया। Malformed payload, या project में enabled न होने वाला network, draft को पूरी तरह reject करता है: प्राप्तकर्ता को error और खाली form दिखता है।

Simulator जिसमें 3-call bundle prefilled है और एक warning banner उन calls को सूचीबद्ध करता है जिनका contract या function restore नहीं हो सका — Restore banner उन calls का नाम देता है जिन पर draft खुलने के बाद ध्यान देना है।

CI या tooling से draft link बनाएँ

Drafts API से draft बनाएँ, फिर लौटाई गई id को link में डालें। Requests access key से authenticate होती हैं; caller को URL में दिए गए project का member होना चाहिए। POST https://api.tenderly.co/api/v2/account/{account}/project/{project}/simulation-drafts (API reference)

Body field	Type	आवश्यक	विवरण
`payload`	object	हाँ	Draft payload। जैसा है वैसा स्टोर होता है; API इसकी structure validate नहीं करता। Malformed payload link खोलने पर reject होता है, draft बनाने पर नहीं।
`shared`	boolean	नहीं	`false` (default) draft को URL के project तक सीमित करता है: केवल उसके members इसे खोल सकते हैं, और उन्हें सीधे उसमें redirect किया जाता है। `true` draft को किसी भी signed-in Tenderly user के लिए, उनकी पसंद के project में, खोलने योग्य बनाता है। इसे अपने organization के बाहर के लिए बने links में उपयोग करें, उदाहरण के लिए एक governance UI जो proposal simulation prefill करता है।

Response है { "resource_id": "<uuid>" }।

curl -X POST "https://api.tenderly.co/api/v2/account/$ACCOUNT/project/$PROJECT/simulation-drafts" \
  -H "X-Access-Key: $TENDERLY_ACCESS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": {
      "v": 2,
      "network": { "id": "1" },
      "rows": [
        {
          "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
          "from": "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
          "inputDataType": "raw",
          "rawFunctionInput": "0xa9059cbb…"
        }
      ]
    }
  }'
# {"resource_id":"3f2a6c1e-…"}

import os, requests

payload = {
    "v": 2,
    "network": {"id": "1"},
    "rows": [
        {
            "contractAddress": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "from": "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
            "inputDataType": "raw",
            "rawFunctionInput": "0xa9059cbb…",
        }
    ],
}

response = requests.post(
    f"https://api.tenderly.co/api/v2/account/{os.environ['ACCOUNT']}/project/{os.environ['PROJECT']}/simulation-drafts",
    headers={"X-Access-Key": os.environ["TENDERLY_ACCESS_KEY"]},
    json={"payload": payload},
)
response.raise_for_status()

url = f"https://dashboard.tenderly.co/simulator/new?draftId={response.json()['resource_id']}"

// Node.js 18+
const payload = {
  v: 2,
  network: { id: "1" },
  rows: [
    {
      contractAddress: "0xdac17f958d2ee523a2206206994597c13d831ec7",
      from: "0xab5801a7d398351b8be11c439e05c5b3259aec9b",
      inputDataType: "raw",
      rawFunctionInput: "0xa9059cbb…",
    },
  ],
};

const response = await fetch(
  `https://api.tenderly.co/api/v2/account/${process.env.ACCOUNT}/project/${process.env.PROJECT}/simulation-drafts`,
  {
    method: "POST",
    headers: {
      "X-Access-Key": process.env.TENDERLY_ACCESS_KEY,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ payload }),
  },
);

const { resource_id } = await response.json();
const url = `https://dashboard.tenderly.co/simulator/new?draftId=${resource_id}`;

Draft को वापस पढ़ें

GET https://api.tenderly.co/api/v2/account/{account}/project/{project}/simulation-drafts/{id} (API reference) URL में project caller का अपना project है (कोई भी project जिसे वह देख सकता है)। Access draft की visibility से तय होता है:

Project-scoped draft { "payload": {…}, "account_id": "…", "project_id": "…" } लौटाता है जब caller draft के origin project को देख सकता है।
Shared draft बिना origin जानकारी के { "payload": {…} } लौटाता है।
बाकी सब (unknown id, expired draft, origin project का access नहीं) 404 लौटाता है, "slug": "resource_not_found" के साथ।

किसी advanced setup के लिए सही payload पाने का सबसे तेज़ तरीका: इसे Simulator में बनाएँ, Share draft पर क्लिक करें, और कॉपी किए गए link की id से draft को GET करें। Response वह payload है जिसे dashboard स्वीकार करता है, जिसमें stateOverrides, customSource और fundAddress की shapes शामिल हैं।

Draft payload

Field	Type	आवश्यक	विवरण
`v`	number	हाँ	Schema version। `2` होना चाहिए।
`network`	`{ "id": string }` या `null`	हाँ	Chain id string के रूप में (`"1"` Mainnet है, `"56"` BNB Chain है, इत्यादि)। यह उस project में enabled network होना चाहिए जहाँ draft खुलता है, अन्यथा प्राप्तकर्ता को “network not available” error और खाली form मिलता है। इसे हमेशा सेट करें। `null` स्वीकार्य है लेकिन contract lookup छोड़ देता है और form को लगभग अनुपयोगी बना देता है। Chain ids के लिए Supported Networks देखें।
`rows`	array	हाँ	प्रति call एक object, execution क्रम में। कम से कम एक row आवश्यक है। Row फ़ील्ड देखें। Session-level settings (block selection, `from`, L2 parameters) पहली row से ली जाती हैं।

Row फ़ील्ड

केवल contractAddress आवश्यक है। जो न चाहिए उसे छोड़ दें। छोड़े गए fields form के defaults रखते हैं, और अज्ञात अतिरिक्त fields ignore किए जाते हैं।

Contract और function

Field	Type	विवरण
`contractAddress`	string	आवश्यक। “to” address। Link खुलने पर contract और उसका ABI प्राप्तकर्ता की तरफ fetch होते हैं।
`inputDataType`	`"decoded"` या `"raw"`	Function-input mode चुनता है। `"raw"` को `rawFunctionInput` के साथ, या `"decoded"` को `contractFunction` और `functionInputs` के साथ उपयोग करें।
`rawFunctionInput`	string	Raw mode के लिए hex calldata (`0x…`)। ABI की ज़रूरत नहीं, जो इसे scripts के लिए सबसे भरोसेमंद विकल्प बनाता है।
`contractFunction`	object या `null`	Decoded-mode function reference: `{ "name": string, "selector"?: string, "signature"?: string }`। Object के अंदर `name` आवश्यक है। `selector` (4-byte hex, जैसे `"0xa9059cbb"`) optional लेकिन preferred है: यह exact match होता है, जो overloaded functions के लिए सुरक्षित है। इसके बिना matching `name` पर fallback करती है और गलत overload चुन सकती है। `signature` केवल जानकारी के लिए है।
`functionInputs`	array या object	Decoded-mode argument values। Preferred: ABI क्रम में एक positional array, जैसे `["0xabc…", "1000000", ["0xa…", "0xb…"]]`। Values strings, numbers या booleans हैं। Array और tuple arguments को nested arrays या objects के रूप में natively पास किया जा सकता है, pre-stringify करने की ज़रूरत नहीं। Keyed form `{ "input_0": … }` भी स्वीकार्य है (dashboard यही emit करता है)।
`contractAbiImport`	string	In-app Edit ABI field को prefill करता है। Draft खुलने पर फिर से लागू नहीं होता: function matching fetched ABI (या compiled edited source) का उपयोग करती है, इसलिए यह field unverified contracts के लिए decoded mode को काम नहीं कराता। उनके लिए raw calldata उपयोग करें।

Transaction parameters

Field	Type	विवरण
`from`	string	Sender address।
`gas`	string या number	Gas limit, जैसे `"8000000"`। `0x`-prefixed hex quantities decimal में convert होती हैं।
`gasPrice`	string या number	Gas price wei में।
`value`	string या number	Native-token value wei में।

Block चयन

Field	Type	विवरण
`block`	string या number	जिस block number पर simulate करना है। Chain head के लिए छोड़ दें।
`blockIndex`	string, number, या `null`	Block के अंदर transaction की position। `null` या छोड़ने का मतलब block की शुरुआत।
`endOfBlock`	boolean	`true` simulated transaction को block की हर transaction के बाद चलाता है (`blockIndex` को override करता है)।
`usePendingBlock`	boolean	`true` fixed number के बजाय pending block पर simulate करता है।

UI में block selection और transaction index कैसे व्यवहार करते हैं, इसके लिए Simulation Parameters देखें।

L2 parameters

ये fields केवल OP-stack और Boba networks पर लागू होते हैं।

Field	Type	विवरण
`depositTx`	boolean	L2 deposit transaction के रूप में mark करें।
`mint`	string	Deposit mint amount।

Overrides

Field	Type	विवरण
`blockHeaderOverrides`	object	`{ "number"?: …, "timestamp"?: … }`, हर एक string, number या `null`। Simulated block header को override करता है।
`stateOverrides`	array	प्रति-contract state overrides: `{ "id"?: string, "contractAddress": string, "balance": string, "storage"?: [{ "key": string, "value": string }], "code"?: string }`। `id` optional है और अनुपस्थित होने पर generate होता है। `balance` wei में है (`""` का मतलब कोई balance override नहीं)। `storage` keys और values 32-byte hex हैं।
`accessList`	array	EIP-2930 access list: `{ "address": string, "storageKeys": string[] }`।

Funded balances और edited source

Field	Type	विवरण
`fundAddress`	object या `null`	Fund address cheatcode: `{ "targetAddress": string, "tokens": [{ "tokenAddress": string, "amount": string }] }`। Native balance fund करने के लिए zero address `0x0000000000000000000000000000000000000000` को `tokenAddress` के रूप में उपयोग करें। ERC-20 tokens के लिए balance storage slot draft खुलने पर resolve होता है; यदि यह resolve न हो सके, तो token form में बना रहता है और restore banner प्राप्तकर्ता से इसे फिर से चुनने को कहता है।
`customSource`	object या `null`	एक applied source edit: `{ "compilerInfo": {…}, "customSourceData": [{ "name": string, "source": string, "path": string, "contractName"?: string, "address"?: string }] }`। `compilerInfo` compiler को जैसा है वैसा पास होता है (compiler version, optimization settings, import remappings); इसकी shape dashboard से साझा किए गए draft से लें। Source draft खुलने पर compile होता है और उसका ABI उस call की function matching संभालता है।
`contractSourceEdited`	boolean	Call के source को edited के रूप में mark करता है। `customSource` मौजूद होने पर default `true`।

Validation और errors

Draft बनाना:

Response	अर्थ
`400` `"Draft payload is required"`	`payload` अनुपस्थित या `null` है।
`400` `"Draft payload exceeds the 256KB limit"`	Serialized `payload` 256 KB से बड़ा है।
`401`	Access key अनुपस्थित या invalid।
`404`	Caller URL में दिए गए project का member नहीं है।

Draft खोलना payload स्तर पर all-or-nothing है: गलत v, rows entry की कमी, non-string contractAddress, या किसी भी गलत-typed row field से पूरा draft “This draft link is invalid or corrupted” के साथ reject होता है। Live data पर निर्भर प्रति-call समस्याएँ (contract fetch, function match, source compile, token slot) आंशिक पुनर्स्थापना में बताए अनुसार अलग-अलग degrade होती हैं।

सीमाएँ

Payloads प्रति draft 256 KB पर capped हैं, API द्वारा enforced।
Drafts स्वतः expire होते हैं। Expired draft API से 404 और dashboard में “invalid, has expired, or you don’t have access” message देता है।
Draft link खोलने के लिए Tenderly account चाहिए। Shared drafts (shared: true) किसी भी signed-in user द्वारा पढ़े जा सकते हैं; project-scoped drafts केवल origin project के members द्वारा।
Contract ABI link खुलने पर fetch होता है। यदि यह resolve न हो सके (unverified contract), तो decoded-mode calls address भरे हुए लेकिन बिना function चुने खुलती हैं। Raw mode इससे अप्रभावित है।

पुराने `?draft=` links

Server-side drafts से पहले, dashboard एक single call को सीधे URL में encode करता था: https://dashboard.tenderly.co/<org>/<project>/simulator/new?draft=<value> <value> एक version-1 payload है ({ "v": 1, "network": {…}, "row": {…} }, rows के बजाय एक row), UTF-8 JSON के रूप में, फिर base64url (+ को -, / को _, = padding हटाई गई)। मौजूदा links खुलते रहते हैं। row object ऊपर दिए गए row फ़ील्ड स्वीकार करता है, सिवाय fundAddress, customSource और contractSourceEdited के, और पूरा URL लगभग 2000 characters से कम रहना चाहिए। Dashboard अब यह format नहीं बनाता; नए integrations के लिए drafts API उपयोग करें। Draft जिन form fields को populate करता है, उनके लिए Simulation Parameters देखें। संशोधित state को one-shot simulation के बजाय persistent environment के रूप में रखने के लिए Virtual Environments उपयोग करें।

Getting Started

Simulator

Console

Monitor

Node RPC

AI Tools

Account & Settings

Simulator draft link साझा करें

Dashboard से draft साझा करें

Draft link खोलने पर क्या होता है

आंशिक पुनर्स्थापना

CI या tooling से draft link बनाएँ

Draft को वापस पढ़ें

Draft payload

Row फ़ील्ड

Contract और function

Transaction parameters

Block चयन

L2 parameters

Overrides

Funded balances और edited source

Validation और errors

सीमाएँ

पुराने `?draft=` links

​Dashboard से draft साझा करें

​Draft link खोलने पर क्या होता है

​आंशिक पुनर्स्थापना

​CI या tooling से draft link बनाएँ

​Draft को वापस पढ़ें

​Draft payload

​Row फ़ील्ड

​Contract और function

​Transaction parameters

​Block चयन

​L2 parameters

​Overrides

​Funded balances और edited source

​Validation और errors

​सीमाएँ

​पुराने ?draft= links

Dashboard से draft साझा करें

Draft link खोलने पर क्या होता है

आंशिक पुनर्स्थापना

CI या tooling से draft link बनाएँ

Draft को वापस पढ़ें

Draft payload

Row फ़ील्ड

Contract और function

Transaction parameters

Block चयन

L2 parameters

Overrides

Funded balances और edited source

Validation और errors

सीमाएँ

पुराने `?draft=` links