Web3 & DApp Development Fundamentals · Aula

Compilação de contratos

Artefatos de compilação

Compilação de contratos é uma aula grátis de Web3 & DApp Development Fundamentals no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Web3 & DApp Development Fundamentals, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Web3 & DApp Development Fundamentals inclui 4 aulas no total.

Partes desta aula ainda não foram traduzidas e aparecem em inglês.

Why Compile

Solidity source code cannot run on the EVM directly. The compiler turns .sol files into bytecode and an ABI that tools and clients use.

Bytecode — the low-level instructions deployed on-chain.
ABI — a JSON interface describing functions and events.

The Compile Task

Hardhat compiles every contract under contracts/ with a single command:

npx hardhat compile

Hardhat downloads the right solc version automatically, so you do not need to install the compiler manually.

npx hardhat compile

Choosing the Solidity Version

The compiler version is set in hardhat.config.js and must satisfy the pragma in your contracts:

module.exports = {
  solidity: "0.8.24",
};

If your contract says pragma solidity ^0.8.24;, the configured version must be compatible or compilation fails.

module.exports = {
  solidity: "0.8.24",
};

Build Artifacts

After compiling, Hardhat writes output to the artifacts/ folder. Each contract gets a JSON file containing:

abi — the application binary interface.
bytecode — deployment bytecode.
deployedBytecode — runtime bytecode.

These artifacts are what ethers.js loads to interact with your contract.

The Cache Folder

Hardhat keeps a cache/ folder to track what changed. On the next compile, only modified files are recompiled.

This incremental compilation makes large projects build quickly. If something seems stale, you can force a fresh build.

Cleaning the Build

To remove cached and generated files, run the clean task:

npx hardhat clean

This deletes artifacts/ and cache/. Use it when you suspect a stale artifact is causing odd behavior, then recompile.

npx hardhat clean

Compiler Optimizer

The optimizer reduces gas costs and bytecode size. Enable it in the config:

module.exports = {
  solidity: {
    version: "0.8.24",
    settings: {
      optimizer: { enabled: true, runs: 200 },
    },
  },
};

A higher runs value optimizes for frequent calls; a lower value optimizes for deployment size.

module.exports = {
  solidity: {
    version: "0.8.24",
    settings: {
      optimizer: { enabled: true, runs: 200 },
    },
  },
};

Multiple Compiler Versions

If different contracts need different Solidity versions, list several compilers:

module.exports = {
  solidity: {
    compilers: [
      { version: "0.8.24" },
      { version: "0.7.6" },
    ],
  },
};

Hardhat picks a matching compiler for each file based on its pragma.

module.exports = {
  solidity: {
    compilers: [
      { version: "0.8.24" },
      { version: "0.7.6" },
    ],
  },
};

Reading Compiler Warnings

The compiler reports errors (which stop the build) and warnings (which do not). Common warnings include:

Unused local variables.
Shadowed declarations.
Functions that could be marked view or pure.

Treat warnings seriously — they often hint at real bugs.

Using the ABI Later

Once compiled, you import the artifact in scripts or tests to attach to a contract:

const artifact = require("./artifacts/contracts/Greeter.sol/Greeter.json");
console.log(artifact.abi);

Tools like ethers.js use this ABI to encode and decode calls correctly.

const artifact = require("./artifacts/contracts/Greeter.sol/Greeter.json");
console.log(artifact.abi);

Forcing a Recompile

By default Hardhat skips files that have not changed. To rebuild everything without cleaning, pass the force flag:

npx hardhat compile --force

This is useful after changing compiler settings, which the incremental cache may not detect on its own.

npx hardhat compile --force

Quick Check

Test your understanding of compilation in Hardhat.

Recap

You learned how Hardhat compiles contracts.

npx hardhat compile builds all contracts and downloads the right solc.
Artifacts (ABI + bytecode) land in artifacts/; incremental builds use cache/.
npx hardhat clean removes stale output.
The optimizer and multiple compiler versions are configured in hardhat.config.js.
Always fix warnings — they often reveal bugs.

Perguntas Frequentes

A aula “Compilação de contratos” é grátis?

Sim — o texto completo de “Compilação de contratos” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Web3 & DApp Development Fundamentals, atualize para CoddyKit PRO. O curso de Web3 & DApp Development Fundamentals inclui 4 aulas no total.

O que vou aprender em “Compilação de contratos”?

Artefatos de compilação Você pratica Web3 & DApp Development Fundamentals com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Web3 & DApp Development Fundamentals?

Nenhuma experiência prévia é necessária. Web3 & DApp Development Fundamentals no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “Compilação de contratos”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Web3 & DApp Development Fundamentals?

Sim. Cada aula de Web3 & DApp Development Fundamentals inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Web3 & DApp Development Fundamentals