Skip to main content

Part 1: Instalasi Foundry

🎯 Tujuan​

Setelah menyelesaikan bagian ini, Anda akan:

  • ✅ Berhasil install Foundry di komputer Anda
  • ✅ Memahami Foundry Suite (forge, cast, anvil, chisel)
  • ✅ Setup VS Code untuk Solidity development
  • ✅ Membuat project Foundry pertama
  • ✅ Familiar dengan basic commands

💡 Apa Itu Foundry?​

Analogi: Foundry = Workshop Lengkap​

Bayangkan Anda seorang tukang kayu:

Tanpa Foundry (Pakai tools terpisah):

🪚 Gergaji (compiler) → beli sendiri
🔨 Palu (tester) → beli sendiri
📏 Meteran (gas checker) → beli sendiri
🎨 Cat (deployer) → beli sendiri

Problem: Banyak tools, ribet koordinasi!

Dengan Foundry (Workshop all-in-one):

🏭 Satu workshop lengkap dengan:
   ⚒️  forge  → Build, test, deploy (main tool)
   🔮 cast   → Interact dengan blockchain
   ⚙️  anvil  → Local blockchain untuk testing
   ✂️  chisel → Solidity REPL untuk eksperimen

Benefit: Semua terintegrasi, super cepat!

Foundry Suite​

ToolFungsiAnalogi
forgeCompile, test, deployMesin utama di workshop
castQuery blockchain, kirim transaksiSwiss army knife
anvilLocal Ethereum nodeKayu latihan (bisa dibuang)
chiselInteractive Solidity REPLSketsa cepat sebelum build

🪟 Instalasi di Windows​

Step 1: Install Git for Windows

  1. Download dari https://git-scm.com/download/win
  2. Install dengan settings default
  3. Pastikan "Git Bash" tercentang

Step 2: Buka Git Bash

Cari "Git Bash" di Start Menu dan buka.

Step 3: Install Foundryup

Copy-paste command ini di Git Bash:

curl -L https://foundry.paradigm.xyz | bash

Output yang diharapkan:

Downloading foundryup...
######################################################################## 100.0%
Installing foundryup...

Detected your preferred shell is bash and added foundryup to PATH.
Run 'source /c/Users/YourName/.bashrc' or start a new terminal session to use foundryup.

Then, simply run 'foundryup' to install Foundry.

Step 4: Reload Terminal

source ~/.bashrc

Atau tutup Git Bash dan buka lagi.

Step 5: Install Foundry

foundryup

Proses instalasi (~2-3 menit):

foundryup: installing foundry (version nightly-xxx)
foundryup: downloading latest forge, cast, anvil, and chisel
######################################################################### 100.0%
foundryup: downloading manpages
######################################################################### 100.0%
foundryup: installed - forge 0.2.0
foundryup: installed - cast 0.2.0
foundryup: installed - anvil 0.2.0
foundryup: installed - chisel 0.2.0
foundryup: done!

Step 6: Verifikasi Instalasi

forge --version

Output:

forge 0.2.0 (xxxxxxx 2024-xx-xx)

✅ Berhasil! Foundry terinstall di Windows!

Opsi 2: WSL (Windows Subsystem for Linux)​

Kapan pakai WSL?

  • Git Bash bermasalah
  • Ingin environment Linux yang lebih lengkap
  • Sudah familiar dengan Linux

Step 1: Enable WSL

Buka PowerShell sebagai Administrator, run:

wsl --install

Restart komputer setelah selesai.

Step 2: Install Ubuntu

  1. Buka Microsoft Store
  2. Search "Ubuntu 22.04 LTS"
  3. Install dan Launch
  4. Setup username & password

Step 3: Install Foundry di WSL

Di Ubuntu terminal:

# Install foundryup
curl -L https://foundry.paradigm.xyz | bash

# Reload terminal
source ~/.bashrc

# Install foundry
foundryup

Step 4: Verifikasi

forge --version

✅ Berhasil! Foundry terinstall di WSL!

Troubleshooting Windows​

Error: curl: command not found

# Pastikan menggunakan Git Bash, bukan CMD atau PowerShell
# Atau install WSL

Error: Permission denied

# Run Git Bash sebagai Administrator
# Right-click Git Bash → "Run as administrator"

Error: Antivirus blocking

# Temporary disable antivirus saat install
# Atau tambah exception untuk folder: C:\Users\YourName\.foundry

Error: forge: command not found setelah install

# Reload terminal
source ~/.bashrc

# Atau restart Git Bash/WSL

🍎 Instalasi di Mac​

Step 1: Check Homebrew​

Buka Terminal, cek apakah Homebrew sudah terinstall:

brew --version

Jika belum ada, install Homebrew dulu:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Step 2: Install Foundryup​

curl -L https://foundry.paradigm.xyz | bash

Step 3: Reload Terminal​

source ~/.zshrc
# Atau jika pakai bash:
source ~/.bashrc

Step 4: Install Foundry​

foundryup

Step 5: Verifikasi​

forge --version
cast --version
anvil --version
chisel --version

Output:

forge 0.2.0 (xxxxxxx)
cast 0.2.0 (xxxxxxx)
anvil 0.2.0 (xxxxxxx)
chisel 0.2.0 (xxxxxxx)

✅ Berhasil! Foundry terinstall di Mac!

Troubleshooting Mac​

Error di Apple Silicon (M1/M2/M3)

# Install Rosetta 2 jika belum
softwareupdate --install-rosetta

# Lalu install foundry
foundryup

Error: Permission denied

# Coba dengan sudo
sudo foundryup

🎨 Setup VS Code​

Install Extensions​

  1. Buka VS Code
  2. Klik icon Extensions (Ctrl+Shift+X atau Cmd+Shift+X)
  3. Install extensions berikut:

Wajib:

  • Solidity by Juan Blanco
    • Syntax highlighting
    • Compiler errors inline
    • Auto-completion

Recommended:

  • Solidity Visual Developer by tintinweb

    • Code navigation
    • Function signatures

  • Better TOML by bungcip

    • Untuk edit foundry.toml

Configure Solidity Extension​

  1. File → Preferences → Settings
  2. Search "Solidity"
  3. Set compiler version:
Solidity: Compile Using Remote Version: v0.8.30

✅ VS Code siap untuk Foundry development!

🏗️ Membuat Project Pertama​

Step 1: Buat Folder​

# Buat folder project
mkdir foundry-test
cd foundry-test

Step 2: Initialize Project​

forge init

Output:

Initializing /path/to/foundry-test...
Installing forge-std in /path/to/foundry-test/lib/forge-std
    Installed forge-std v1.8.1
    Initialized forge project.

Step 3: Lihat Struktur Project​

ls -la

Struktur folder:

foundry-test/
├── lib/                    # Dependencies (seperti node_modules)
│   └── forge-std/          # Foundry standard library
├── script/                 # Deployment scripts
│   └── Counter.s.sol
├── src/                    # Smart contracts
│   └── Counter.sol
├── test/                   # Test files
│   └── Counter.t.sol
├── .gitignore
├── foundry.toml            # Config file
└── README.md

Penjelasan:

Folder/FileFungsi
src/Smart contracts utama (*.sol)
test/Test files (*.t.sol)
script/Deployment scripts (*.s.sol)
lib/Dependencies
foundry.tomlKonfigurasi project

Step 4: Compile​

forge build

Output:

[⠊] Compiling...
[⠒] Compiling 27 files with Solc 0.8.30
[⠢] Solc 0.8.30 finished in 2.34s
Compiler run successful!

Step 5: Run Tests​

forge test

Output:

[⠊] Compiling...
No files changed, compilation skipped

Ran 2 tests for test/Counter.t.sol:CounterTest
[PASS] testFuzz_SetNumber(uint256) (runs: 256, μ: 31245, ~: 31288)
[PASS] test_Increment() (gas: 31303)
Suite result: ok. 2 passed; 0 failed; 0 skipped; finished in 18.45ms

✅ Project berhasil dibuat!

⚒️ Basic Commands​

Compile​

forge build           # Compile semua contracts
forge build --sizes   # Compile + tampilkan ukuran contract
forge clean           # Hapus build artifacts

Test​

forge test            # Run semua tests
forge test -vv        # Dengan logs
forge test -vvvv      # Dengan detailed traces
forge test --gas-report   # Dengan gas report

Local Blockchain​

anvil                 # Start local node di port 8545

Interactive Console​

chisel                # Solidity REPL

Contoh di Chisel:

➜ uint256 x = 42;
➜ x * 2
Type: uint256
└ Decimal: 84

➜ !quit              # Exit chisel

Convert Units (Cast)​

# Wei ke Ether
cast to-unit 1000000000000000000 ether
# Output: 1.000000000000000000

# Ether ke Wei
cast to-wei 1 ether
# Output: 1000000000000000000

🎯 Hands-on: Verifikasi Instalasi​

Pastikan semua sudah berfungsi dengan mengerjakan tasks berikut:

Task 1: Check Versions​

forge --version
cast --version
anvil --version
chisel --version

✅ Semua menampilkan version number

Task 2: Create & Build Project​

mkdir verify-foundry
cd verify-foundry
forge init
forge build

✅ "Compiler run successful!"

Task 3: Run Tests​

forge test

✅ "2 passed; 0 failed"

Task 4: Coba Chisel​

chisel

Di dalam chisel:

➜ string memory name = "EduLoan";
➜ name
Type: string
└ "EduLoan"

➜ uint256 amount = 1 ether;
➜ amount
Type: uint256
└ Decimal: 1000000000000000000

➜ !quit

✅ Bisa run Solidity interaktif

Task 5: Start Anvil​

anvil

✅ Local node running dengan 10 test accounts

Stop Anvil: Tekan Ctrl+C

✅ Checklist Sebelum Lanjut​

Sebelum ke Part 2, pastikan:

  • Foundry terinstall (forge --version berhasil)
  • VS Code dengan Solidity extension
  • Berhasil forge init project
  • Berhasil forge build (compile)
  • Berhasil forge test (all passed)
  • Bisa menggunakan chisel
  • Bisa menjalankan anvil

Semua checked? ✅ Lanjut ke Part 2!

📚 Command Cheat Sheet​

# === Project Setup ===
forge init                    # Create new project
forge init --template <repo>  # From template

# === Build ===
forge build                   # Compile
forge build --sizes           # With contract sizes
forge clean                   # Clean artifacts

# === Testing ===
forge test                    # Run all tests
forge test -vv                # With logs
forge test -vvvv              # With traces
forge test --gas-report       # Gas report
forge test --match-test <name>    # Specific test
forge test --match-contract <name> # Specific contract

# === Coverage ===
forge coverage                # Test coverage report

# === Local Node ===
anvil                         # Start local blockchain

# === Interactive ===
chisel                        # Solidity REPL

# === Utilities ===
cast to-wei 1 ether           # Convert to wei
cast to-unit <wei> ether      # Convert to ether
cast balance <address>        # Get ETH balance

# === Format ===
forge fmt                     # Format all .sol files

🚀 Next: Setup EduLoan Project​

Foundry sudah terinstall! Saatnya setup project untuk EduLoan.

Part 2 akan cover:

  • Membuat Foundry project untuk EduLoan
  • Copy EduLoan contract dari challenge
  • Compile dan inspect contract
  • Testing manual dengan Chisel

📖 Part 2: Setup EduLoan Project →

Happy Forging! ⚒️