Saham vault ERC-4626 dan aset: periksa arti saldo Anda

Saldo vault ERC-4626 adalah jumlah saham, bukan otomatis jumlah token dasar yang sama. Kenali aset vault, lalu bedakan konversi umum, pratinjau penebusan, dan batas penebusan pemilik. Angka-angka ini menjawab pertanyaan berbeda tentang satu posisi.

Jika dompet menampilkan 100 saham sedangkan layar protokol menampilkan 120 token dasar, jangan langsung menganggap salah satu saldo keliru. Periksa dahulu apa yang diukur setiap angka. Panduan ini merupakan cara baca-saja untuk mencocokkan kepemilikan yang sudah ada, bukan anjuran menyetor ke vault atau menebusnya.

Kenali token saham dan aset dasarnya

Standar ERC-4626 mendefinisikan saham vault sebagai token ERC-20. balanceOf(account) pada vault menghitung saham tersebut; metode asset() mengidentifikasi kontrak token dasar. Simpan kedua alamat kontrak bersama jaringan dan akun yang diperiksa.

Ticker yang familier tidak cukup. Pastikan deployment vault yang tepat melalui dokumentasi resmi protokol atau transaksi yang sudah dikenal, dengan mengaksesnya lewat jalur tepercaya. Kemudian cocokkan alamat aset dasar, bukan hanya namanya, dengan token yang dimaksud. Kontrak tiruan dapat menyediakan nama metode yang familier tanpa menjadi vault yang Anda maksud.

Periksa satuan kedua sisi. Jumlah saham mentah harus memakai desimal token saham, sedangkan keluaran aset mentah memakai desimal token dasar. Keduanya tidak harus sama: panduan vault OpenZeppelin menjelaskan implementasi dengan presisi saham tambahan. Panduan desimal token kami menjelaskan cara mengenali bilangan bulat yang masih perlu diformat. Jangan mengubah skala jumlah yang sudah diformat sekali lagi.

Pilih angka yang menjawab pertanyaan Anda

Gunakan pembacaan terdokumentasi untuk kontrak yang telah diverifikasi, alih-alih mengalikan dengan kurs yang disalin dari vault lain. Referensi API OpenZeppelin membedakan metode konversi, pratinjau, dan batas.

Pembacaan	Satuan hasil	Pertanyaan yang dijawab
balanceOf(account)	Saham	Berapa saham yang dimiliki akun ini?
convertToAssets(shares)	Aset dasar	Berapa ekuivalen aset secara umum?
previewRedeem(shares)	Aset dasar	Berapa perkiraan penebusan saham ini?
maxRedeem(owner)	Saham	Berapa saham yang dapat ditebus pemilik ini sekarang?

convertToAssets menggambarkan konversi ideal, tanpa biaya dan slippage pertukaran aktual. Ini bukan penawaran penarikan khusus untuk pemilik. previewRedeem memasukkan biaya penarikan dan mencerminkan kondisi saat ini, tetapi sengaja mengabaikan batas penebusan. Untuk batas itu, baca maxRedeem pemilik. Definisi metode dalam standar menyatakan perbedaan ini dengan jelas.

Karena itu, pratinjau positif tetap mungkin disertai batas yang lebih kecil, bahkan batas nol. Pembacaan juga tidak memesan dana: keadaan dapat berubah sebelum transaksi berikutnya. Ikuti syarat penarikan yang didokumentasikan untuk vault tersebut, termasuk prosedur permintaan yang diwajibkan. Vault dengan ekstensi asinkron atau antarmuka berbeda membutuhkan petunjuknya sendiri.

Pertahankan satu kepemilikan dalam perbandingan

Bayangkan snapshot hipotetis dengan seluruh angka sudah diformat dalam satuan yang mudah dibaca. Sebuah akun memiliki 100 saham. Untuk jumlah saham itu, vault melaporkan 120 token dasar melalui convertToAssets dan 119 token dasar melalui previewRedeem. Secara terpisah, maxRedeem akun tersebut adalah 40 saham.

Angka 120 token adalah ekuivalen umum. Angka 119 token adalah pratinjau untuk seluruh 100 saham, bukan bukti bahwa semua 100 dapat ditebus sekarang. Batas 40 saham diukur dalam saham dan tidak boleh dibandingkan seolah-olah itu 40 token dasar. Untuk memeriksa jumlah saham yang diizinkan, dapatkan pratinjau khusus jumlah tersebut, bukan menganggap pratinjau seluruh saldo berlaku tanpa perubahan.

Angka-angka ini contoh rekaan tentang label dan cakupan, bukan penawaran vault langsung, daftar biaya, atau perhitungan kurs protokol tertentu. Tidak ada dompet yang dikueri atau transaksi yang dijalankan untuk contoh ini.

Jangan menjumlahkan 100 saham dan ekuivalennya sebesar 120 token sebagai kepemilikan terpisah. Keduanya menggambarkan posisi yang sama. Jika dompet juga menyimpan token dasar di luar vault, catat saldo dompet aktual itu secara terpisah. Saat membandingkan total fiat, periksa representasi mana yang sudah dihitung pelacak sebelum menambahkan nilai protokol. Panduan rekonsiliasi portofolio yang lebih luas membantu membedakan jumlah yang hilang, harga yang hilang, atau posisi yang tidak didukung.

Catat snapshot yang konsisten tanpa memindahkan dana

Gunakan explorer atau pembaca kontrak yang sudah Anda percayai. Prosedur ini menjelaskan pemeriksaan berbasis dokumentasi; artikel ini tidak mengujinya pada vault langsung. Referensi primer diperiksa pada 25 Oktober 2026.

1. Pastikan identitas posisi. Catat jaringan, akun, dan alamat kontrak vault lengkap. Verifikasi bahwa deployment tersebut memakai antarmuka ERC-4626 yang ingin Anda periksa.
2. Kenali aset dan satuannya. Catat asset() serta skala desimal saham dan aset. Baca saldo saham akun, dengan membedakan bilangan bulat mentah dari jumlah terformat.
3. Pilih pembacaan yang relevan. Untuk perbandingan pencatatan, catat convertToAssets bagi jumlah saham yang tepat itu. Untuk perkiraan penebusan, catat previewRedeem dan beri label sebagai pratinjau.
4. Periksa batas khusus pemilik secara terpisah. Baca maxRedeem(owner) dan syarat penarikan protokol. Jangan mengganti batas yang tidak tersedia dengan saldo saham atau memperlakukan pratinjau positif sebagai izin menebus.
5. Selaraskan dan beri label pengamatan. Utamakan blok yang sama untuk saldo, konversi, pratinjau, dan batas. Jika pembaca hanya menyediakan panggilan keadaan terbaru secara terpisah, simpan waktunya dan catat bahwa snapshot bisa berbeda.
6. Cocokkan satu posisi. Simpan jumlah saham, ekuivalen aset, dan informasi penebusan bersama. Tandai pembacaan gagal sebagai tidak diketahui, simpan pesannya, lalu periksa akun, kontrak, jaringan, atau antarmuka sebelum menyimpulkan jumlahnya nol.

Pembacaan publik ini tidak membutuhkan tanda tangan, persetujuan, frasa pemulihan, atau transfer. Jika situs meminta salah satunya hanya untuk menampilkan saldo, hentikan alur itu. Respons kontrak dapat membantu menjelaskan tampilan; respons tersebut tidak menjamin keamanan kontrak.

Konversi bukan imbal hasil atau harga jual

Ekuivalen aset menjawab bagaimana vault menyatakan sejumlah saham dalam token dasarnya. Angka itu tidak menetapkan keuntungan dari setoran awal, harga jual pasar, atau jaminan penebusan di masa depan. Biaya, pembulatan, perubahan vault, dan harga aset dasar itu sendiri perlu dicatat secara terpisah.

Jangan terapkan prosedur ini pada semua token bukti kepemilikan. Misalnya, stETH dan wstETH memiliki metode pencatatan dan konversi terdokumentasi sendiri. Saldo yang terlihat mirip tidak membuktikan perilaku ERC-4626.

Pemeriksaan selesai ketika Anda dapat menyebut vault dan aset yang tepat, mengidentifikasi jumlah saham dan snapshot, serta menjelaskan layar mana yang menampilkan konversi, pratinjau, atau batas. Jika pembacaan penting tidak tersedia, biarkan bagian tersebut belum terverifikasi. Memindahkan posisi merupakan keputusan terpisah; itu tidak diperlukan untuk menjelaskan saldo yang ditampilkan.