debug-diff

Debug a failed diffyscan verification run. Analyzes diffs, identifies root causes. Use when diffyscan exits with non-zero or shows unexpected diffs.

Ir para a instalação

Repositório: lidofinance/diffyscan
Última atividade na origem: 26 de junho de 2026 às 17:39
Idioma detectado do SKILL.md: inglês
Estrelas: 142
Forks: 19

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/lidofinance/diffyscan --skill debug-diff

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

name	debug-diff
description	Debug a failed diffyscan verification run. Analyzes diffs, identifies root causes. Use when diffyscan exits with non-zero or shows unexpected diffs.
argument-hint	["config-path-or-contract-address"]

Help debug a failed diffyscan verification. The user may provide a config path, contract address, or describe the failure.

Diagnostic steps

1. Check the digest output

Each run creates a timestamped directory under digest/. The timestamp is int(time.time()) captured at process start (see diffyscan/utils/constants.py):

digest/{timestamp}/logs.txt -- full run log (written by Logger in diffyscan/utils/logger.py)
digest/{timestamp}/diffs/{contract_address}/{filename}.html -- per-file HTML source diff reports

Find the most recent run:

ls -lt digest/ | grep "^d" | head -5

Then inspect its contents:

# View the log
cat digest/<timestamp>/logs.txt

# List HTML diff reports for a specific contract
ls digest/<timestamp>/diffs/<contract_address>/

2. Identify the type of failure

Source code diffs -- files differ between GitHub and the blockchain explorer:

Symptom

Likely fix

"missing GitHub sources for bytecode compilation"

Add the missing dependency to dependencies in the config with correct url, commit, and relative_root

Source diffs in OpenZeppelin or other dependency imports

Check the dependency commit hash matches what was used at deploy time

Bytecode mismatch after constructor

Add constructor_calldata (raw hex) or constructor_args (ABI-typed values) for the contract under bytecode_comparison

"Failed to infer source path for library '...' from explorer metadata"

Add library addresses to bytecode_comparison.libraries keyed by "path/to/File.sol": {"LibName": "0xAddr"}

All files show diffs

Wrong commit or relative_root in github_repo

Single contract fails

May need a per-contract constructor_calldata or constructor_args entry

"Failed in binary comparison: Bytecodes have differences not on the immutable reference position"

Real bytecode mismatch -- check compiler version, optimizer settings, EVM version, and library addresses

"Exiting with non-zero code due to unallowed diffs"

Either fix the diffs or add a granular allowed_diffs rule to the config for known-acceptable diffs (copy the suggestion diffyscan prints in the final summary; prefer immutables/byte_ranges/line_ranges/files/cbor_metadata over any: true)

"Contract name in config does not match with blockchain explorer ... !="

Contract not verified on explorer — comment it out or verify it on the explorer first

"Failed to get calldata: Explorer metadata has empty constructor calldata for 0x..."

Factory-created contract — Etherscan has no constructor args. Add constructor_calldata manually (extract via getsourcecode API ConstructorArguments, debug_traceTransaction trace, or cross-chain reuse)

"HTTP error: 404 ... contents/<path>.sol"

Missing or wrong dependencies entry — the explorer source uses a path prefix not covered by config dependencies. Add a mapping for that prefix

"err: intrinsic gas too low"

Chain gas model needs a higher deployment gas cap (known on Mantle) — set deployment_gas_limit in the config (e.g. 30000000000)

All proxy bytecode diffs say "immutable reference position"

Normal for TransparentUpgradeableProxy — ProxyAdmin address baked in as immutable. Add an allowed_diffs.bytecode rule with the exact immutables values (from the printed suggestion) to accept it

debug-diff

Opções de instalação

Revise os arquivos de origem

Diagnostic steps

1. Check the digest output

2. Identify the type of failure

Diagnostic steps

1. Check the digest output

2. Identify the type of failure

3. Common fixes

4. Suggest a re-run command

Known limitations

Flat-source (non-standard-JSON) contracts

debug-diff

Informações da origem

Opções de instalação

Revise os arquivos de origem

Mais deste repositório

Mais deste repositório

Diagnostic steps

1. Check the digest output

2. Identify the type of failure

Diagnostic steps

1. Check the digest output

2. Identify the type of failure

3. Common fixes

4. Suggest a re-run command

Known limitations

Flat-source (non-standard-JSON) contracts