Поделиться draft-ссылкой Simulator

​

Поделиться draft-ссылкой из dashboard

1. Соберите симуляцию в Simulator: выберите сеть, добавьте один или несколько вызовов, задайте переопределения, примените правки исходного кода.
2. Нажмите Share draft в заголовке страницы. Draft сохраняется, а ссылка копируется в буфер обмена.

​

Что происходит при открытии draft-ссылки

• Участник проекта, в котором создан draft. Dashboard перенаправляет в Simulator этого проекта с предзаполненной формой, без дополнительных запросов.
• Общий draft (создан через API с shared: true). Сначала открывается диалог Select Project; draft открывается в проекте, который выберет получатель.
• Недействительный id, истёкший draft или нет доступа. Все три случая дают одинаковый ответ, чтобы id draft’ов нельзя было перебирать. Получатель видит сообщение “This draft link is invalid, has expired, or you don’t have access to it.” и попадает на главную страницу dashboard.
• Пользователь не авторизован. Получатель сначала входит в систему, затем сценарий продолжается с той же ссылкой.
• В Simulator есть несохранённые правки. Открытие draft заменяет текущую форму, поэтому dashboard запрашивает подтверждение перед тем, как отбросить правки.

​

Частичное восстановление

​

Создание draft-ссылки из CI или инструментов

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 по id

• Draft, ограниченный проектом, возвращает { "payload": {…}, "account_id": "…", "project_id": "…" }, если вызывающий может просматривать исходный проект draft.
• Общий draft возвращает { "payload": {…} } без сведений об источнике.
• Всё остальное (неизвестный id, истёкший draft, нет доступа к исходному проекту) возвращает 404 со "slug": "resource_not_found".

​

Полезная нагрузка draft

​

Поля row

​

Контракт и функция

​

Параметры транзакции

​

Выбор блока

​

Параметры L2

​

Переопределения

​

Пополнение адресов и изменённый исходный код

​

Валидация и ошибки

​

Ограничения

• Полезная нагрузка ограничена 256 КБ на draft; лимит обеспечивает API.
• Draft’ы автоматически истекают. Истёкший draft возвращает 404 из API и сообщение “invalid, has expired, or you don’t have access” в dashboard.
• Для открытия draft-ссылки требуется аккаунт Tenderly. Общие draft’ы (shared: true) доступны любому авторизованному пользователю; draft’ы, ограниченные проектом, только участникам исходного проекта.
• ABI контракта загружается при открытии ссылки. Если его не удалось получить (неверифицированный контракт), вызовы в decoded-режиме открываются с заполненным адресом, но без выбранной функции. Raw-режим от этого не зависит.

​

Устаревшие ссылки ?draft=