Bangun di Ostia
Deploy kontrak Solidity di Ostia DevNet dengan Foundry atau Hardhat, verifikasi dengan Foundry, dan sambungkan dengan viem atau ethers.
Ostia adalah rantai EVM, jadi alat yang sudah Anda gunakan juga bekerja di sana. Halaman ini menunjukkan cara men-deploy dan memverifikasi sebuah kontrak, cara membaca event, dan di mana melihat transaksi Anda menjadi final di Canton. Anda memerlukan alamat dengan sejumlah tROME. Kran faucet memberi 1 tROME, dan Ostia DevNet memiliki detail jaringan.
Deploy dengan Foundry
Perintah-perintah ini diuji dengan Foundry 1.8. Jalankan foundryup (atau brew upgrade foundry) terlebih dahulu. Bekerjalah dalam proyek Foundry (forge init ostia-counter membuat satu, dengan sebuah Counter kontrak) dan simpan kunci yang didanai di PRIVATE_KEY. forge init sudah menulis sebuah [profile.default] tabel di foundry.toml. Tambahkan satu baris di bawahnya, agar deployment dan verifikasi dikompilasi dengan pengaturan yang sama:
[profile.default]
# ...baris yang ditulis forge init tetap seperti semula
evm_version = "london"export RPC=https://ostia.devnet.romeprotocol.xyz/rpc
forge create src/Counter.sol:Counter \\
--rpc-url $RPC --private-key $PRIVATE_KEY --broadcastYang telah berjalan di Ostia sejauh ini:
Uniswap V2
solc 0.5.16 dan 0.6.6
istanbul
kontrak Merces milik TACEO
solc 0.8.37
osaka
Rantai Ostia telah menjalankan setiap fork hingga Osaka sejak 2026-10-28, jadi rantai ini menerima kode yang dibuat untuk target EVM apa pun hingga osaka. Target dalam tabel adalah yang telah berjalan; london adalah pilihan yang aman. Opcode yang ditambahkan setelah Osaka tidak akan berjalan.
Verifikasi dengan Foundry
Explorer berbicara dengan API Etherscan, jadi forge verify-contract bekerja dengan verifier Etherscan. Kunci API dapat berupa teks apa pun.
forge verify-contract <address> src/Counter.sol:Counter \\
--chain-id 770101 \\
--verifier etherscan \\
--verifier-url https://ostia.devnet.romeprotocol.xyz/api \\
--etherscan-api-key any \\
--watchExplorer menerima 30 verifikasi per jam dari satu klien. Jika Anda melebihi batas itu, tunggu lalu kirim permintaan lagi. Kontrak yang terverifikasi menampilkan sumbernya di halaman kontrak pada explorer.
Verifikasi kontrak besar
Kontrak dengan banyak file sumber dapat ditolak dengan HTTP 413. Proxy depan explorer memakan sekitar 300 KB per permintaan, dan forge mengirim input-nya dalam format url-encoded, yang lebih besar daripada file-file tersebut. POST /api/verify menerima input yang sama seperti JSON standar, yang lebih kecil. Batas proxy berlaku untuk setiap permintaan, jadi body JSON di atas 300 KB juga ditolak. Skrip kit, verify-large.mjs melakukan ini. Ia mengirim JSON standar 265 KB dari kontrak Merces, yang tidak dapat dikirim forge. Untuk menggunakannya, pertama ambil JSON standar dari proyek Foundry Anda dan salin ke folder kit (load/mixed di klon repositori):
Lalu, di folder kit, instal paketnya dengan npm ci dan jalankan skripnya. Skrip ini mengambil alamat explorer dari config.json. (Dengan Docker, ./run.sh node scripts/verify-large.mjs ... melakukan hal yang sama.)
Berikan compiler sebagai string versi lengkap. Untuk sebuah Counter kontrak yang dibangun dengan solc 0.8.28, optimizer aktif pada 200 runs, versi EVM london dan tanpa argumen konstruktor:
Explorer mengompilasi dengan pengaturan di dalam std.json, yang ditulis forge dari foundry.toml Anda, jadi kontrak diverifikasi dengan pengaturan optimizer apa pun yang dipakai saat dibangun. Skrip ini mengirim verifikasi, lalu meminta GET /api/verify/<guid> hingga jawabannya Lulus atau Gagal. Batas 30 per jam yang sama berlaku.
Deploy dengan Hardhat
Ini untuk Hardhat 2 (Hardhat 3 memerlukan konfigurasi ESM). Langkah-langkah ini dimulai dari folder kosong dan dijalankan terhadap Ostia DevNet dengan Hardhat 2.29 di Node 22. Simpan kunci yang telah didanai di PRIVATE_KEY, dengan 0x.
npx hardhat init mengajukan pertanyaannya di terminal dan menulis kontrak contoh miliknya sendiri, jadi buat ketiga file itu secara manual. Pertama kontraknya:
Konfigurasinya. Versi solidity cocok dengan pragma:
Skrip deploy:
Ia menampilkan Counter deployed to 0x.... batas waktu berlaku untuk setiap permintaan. Sebuah deployment juga menunggu receipt-nya, yang baru datang setelah finalitas Canton (lihat di bawah). Dalam pengujian pada 2026-10-25, perintah ini memakan waktu 20 hingga 23 detik, sebagian besar menunggu blok menjadi final.
viem dan ethers
Definisi chain viem:
Sebuah provider ethers:
Receipt dan event
RPC hanya menampilkan blok yang sudah final di Canton. Setelah Anda mengirim transaksi, eth_getTransactionReceipt tidak mengembalikan apa pun sampai bloknya final, yang memakan waktu sekitar 10 hingga 30 detik. Saat Anda menetapkan timeout receipt di sebuah alat, beri ruang untuk proses proving dan konfirmasi Canton.
Tidak ada WebSocket dan tidak ada eth_subscribefilter eth_newFilter. Untuk mengikuti peristiwa, lakukan polling eth_getLogs dengan rentang blok sejak polling terakhir Anda. Polling setiap beberapa detik sudah cukup. Dalam 24 jam hingga 2026-10-25 01:34 UTC, jeda median antarblok saat chain sibuk adalah 16,6 detik, dan chain yang sepi membuat blok kosong sekali per menit. Batasi hingga 300 panggilan per menit.
Lihat transaksi Anda di Canton
Buka transaksi Anda di explorer, di
/tx/<hash>.Ikuti tautan bloknya,
/block/<number>.Halaman blok menampilkan pembaruan Canton yang menyimpan catatan blok, waktu Canton mencatatnya, dan fakta pembuktian di samping nilai yang diharapkan oleh explorer.
Tekan Verifikasi. Browser Anda menjalankan pemeriksaan bukti itu sendiri, pada bukti, header, dan transaksi yang disajikan explorer. Tombol ini berwarna abu-abu selama blok masih sedang dibuktikan.
Data yang sama ada di API, misalnya GET /api/blocks/<number> dan GET /api/canton/updates/<update id>.
Contoh yang lebih besar
The load/mixed folder tersebut men-deploy serangkaian kontrak dan mengalirkan trafik campuran melaluinya: ERC-20, ERC-721, ERC-1155, token berizin ERC-3643, Uniswap V2, dan kontrak transfer privat Merces milik TACEO (bukti mereka diperiksa di chain; tidak ada yang diselesaikan). README-nya README memuat perintah-perintahnya. Kit ini juga memverifikasi setiap kontrak yang di-deploy-nya pada explorer. Dengan konfigurasi bawaan seperti dikirim, ia memerlukan sekitar 12.000 tROME, jauh lebih banyak daripada yang diberikan faucet, jadi jalankan terhadap Ostia Anda sendiri (lihat Jalankan Ostia Anda sendiri). Unduhan compiler-nya hanya berjalan di linux x64. Pada 2026-10-24, satu kali run mengirim 13.496 transaksi dalam satu jam, dan semuanya menjadi final. Itu hasil menjelaskan apa yang diukur dan apa yang tidak berhasil.
Terakhir diperbarui
Apakah ini membantu?