P08-L02 · P08 · P08-M01
Konversikan saldo mentah memakai desimal terverifikasi dan rekonsiliasi ukuran pasokan
Prasyarat: P08-L01
Tujuan pembelajaran
- Konversikan saldo integer mentah memakai desimal terverifikasi.
- Rekonsiliasi total, pengecualian, dan peristiwa pengubah pasokan.
- Jelaskan feed bertentangan tanpa mengarang alokasi.
Master sumber EN · P08-L02 · perkiraan 45 menit · needs_review
Mengapa ini penting
Kesalahan desimal dapat mengubah sembilan ribu token menjadi sembilan tanpa mengubah saldo dasarnya. Definisi pasokan salah label membuat dua hitungan benar tampak bertentangan. Tentukan unit, konteks, pengecualian sebelum valuasi atau distribusi.
Pelajaran ini mengajarkan konversi mentah-ke-tampilan tepat dan rekonsiliasi pasokan berdasarkan identitas terverifikasi, tanpa menganggap semua token memakai delapan belas desimal.
Penjelasan
Pisahkan integer dan penyajian
R jumlah integer mentah dan d jumlah desimal terverifikasi. Kuantitas tampilan biasa adalah R dibagi 10^d. Unit mentah tak terbagi dalam model ini; desimal menentukan presisi tampilan, bukan jumlah pemilik atau harga. Status mint Solana memuat pasokan/desimal [S08-TOKENS]. Metode decimals ERC-20 opsional [S08-ERC20]; metadata hilang tidak boleh diganti tebakan default.
Gunakan string integer atau aritmetika desimal tepat. Spreadsheet atau floating point JavaScript dapat membulatkan nilai besar sebelum dibagi. Simpan integer asli, desimal, konteks, dan nilai tampilan terpisah. Hitung dari input mentah jika alat menampilkan nilai bulat.
Nol berbeda dari hasil hilang. Nol merupakan pengukuran sah pada sumber/konteks; null atau timeout berarti bukti hilang. Tanpa jumlah desimal, konversi unit token tidak andal meski saldo mentah tersedia. Catat jumlah mentah tanpa mengklaim jumlah token.
Rekonsiliasi ukuran sebelum membandingkan
Total pasokan adalah ukuran akuntansi protokol pada konteks tertentu. Pasokan beredar memerlukan kebijakan inklusi. Inventaris treasury, vesting, dan custody bridge dapat diperlakukan berbeda oleh penerbit. Label tanpa kebijakan tidak menyelesaikan perbedaan.
Solana getTokenSupply memberi jumlah mentah/desimal dengan konteks respons [S08-SUPPLY], bukan definisi sirkulasi independen. Jangan kurangi pasokan penerbit yang sudah disesuaikan dari total mentah tanpa memeriksa pengecualiannya.
Dalam data akuntansi standar tertutup, saldo harus cocok total. Pemeriksaan nyata menilai kelengkapan ekspor, konteks selaras, decoding ekstensi. Mekanisme tertentu menyulitkan penjumlahan sederhana; nyatakan batas, jangan paksa setiap aset ke model ini.
Pengecualian tidak menghancurkan token. Mengeluarkan treasury dari penyebut menghasilkan statistik disesuaikan, bukan peristiwa pasokan. Transfer ke “alamat burn” tidak otomatis mengurangi totalSupply protokol; mekanisme burn dan perubahan akuntansi perlu bukti.
Ikuti perubahan tanpa mengganti unit
Mint meningkatkan pasokan di data latihan; burn protokol menurunkannya. Transfer biasa antarakun yang disertakan mengubah pemilik tanpa total. Jika urutan lengkap, pasokan baru sama dengan lama ditambah mint dikurangi burn.
Lampirkan konteks pada peristiwa dan jumlah. Jika snapshot berikutnya berbeda dari jumlah peristiwa, uji cakupan kurang, mint tidak konsisten, atau presisi sebelum menuduh manipulasi. Selisih adalah kegagalan rekonsiliasi untuk diselidiki, bukan kesimpulan niat.
Verifikasi desimal untuk objek/konteks tepat. Aset bersimbol sama dapat berbeda presisi. d berbeda tiga memberi selisih seribu kali. Jangan “memperbaiki” saldo mentah agar cocok situs.
Gunakan jembatan perbandingan
Susun jumlah mentah, desimal, konversi, konteks snapshot, kebijakan pengecualian dalam kolom. Satu laporan benar untuk total, lainnya benar untuk penyebut disesuaikan. Namai terpisah; jangan rata-ratakan.
Jika definisi dan konteks sama tetapi hasil berbeda, pertahankan kedua rekaman dan selisih belum terselesaikan. Jangan pilih lebih besar karena tampak aman atau lebih kecil demi persentase konsentrasi. Temuan terbatas menyebut selisih dan pemeriksaan berikutnya.
Faktor desimal sama dapat dibatalkan dalam persentase hanya dengan presisi dan cakupan token sama. Pembilang mentah dibanding penyebut tampilan menghasilkan angka tanpa makna meski terlihat rapi.
Komunikasikan kuantitas secara reproduktif
Tulis unit setiap baris. “2,500” saja bisa unit mentah, token, atau dolar. Pelajaran memakai token fiktif tanpa harga pasar/valuasi dolar. Rekonsiliasi tidak membuktikan likuiditas eksekusi, kenaikan harga, atau legitimasi penerbit.
Pertahankan presisi penuh di kunci jawaban; bulatkan hanya tampilan. Jelaskan kebijakan untuk pecahan berulang. Konversi latihan berakhir tepat, tanpa sisa pembulatan tersembunyi.
Istilah
- Jumlah mentah: unit akuntansi integer.
- Desimal: presisi tampilan berbasis sepuluh.
- Total pasokan: ukuran protokol pada konteks.
- Pasokan disesuaikan: ukuran pengecualian yang dinyatakan analis.
- Rekonsiliasi: membandingkan jumlah/perubahan kompatibel.
- Konteks snapshot: batas status observasi.
Contoh historis
ILLUSTRATIVE — FIX-P08-02. MINT-SUPPLY pada SIM-SOL-A, model standar dasar, d=6 pada S0 sintetis. Saldo lengkap tersedia; semua pengenal label tidak valid.
| Rekaman | Kategori akun | Jumlah mentah | Token tampilan |
|---|---|---|---|
| B1 | Pemilik A | 2,500,000,000 | 2,500 |
| B2 | Pemilik B | 1,500,000,000 | 1,500 |
| B3 | Treasury, kecualikan dalam E | 3,000,000,000 | 3,000 |
| B4 | Vesting, kecualikan dalam E | 2,000,000,000 | 2,000 |
Total mentah T0 adalah 9,000,000,000. Feed F1 salah memakai d=9, menampilkan 9. E hanya mengecualikan B3/B4. Urutan sintetis lengkap ke S1 membakar 500,000,000 dan mint 750,000,000 unit mentah; tidak ada perubahan lain. Alokasi akun S1 tidak tersedia.
Yang dibuktikan bukti
OBSERVED dalam data latihan: Presisi, total, saldo S0 tersedia. F1 salah presisi.
INFERRED: Total S0 adalah 9,000 token; kuantitas E disesuaikan 4,000. Peristiwa lengkap menyiratkan S1 total 9,250 token.
Yang tidak dibuktikan bukti
UNKNOWN: Ukuran sirkulasi nyata, alokasi S1, harga, likuiditas.
INSUFFICIENT EVIDENCE: 4,000 disesuaikan bukan burn protokol atau pasokan beredar universal. Selisih desimal bukan bukti niat jahat.
Kesalahan umum
Menganggap delapan belas desimal, mencampur mentah/tampilan, menyebut pengecualian burn, mengimpor integer bulat, membandingkan konteks berbeda, menganggap ukuran kebijakan sebagai satu-satunya pasokan beredar.
Latihan praktik
Konversikan T0 dan empat saldo, rekonsiliasi S0. Hitung penyebut E, bagian A dari total dan ukuran disesuaikan, total S1. Jelaskan faktor salah F1 serta apakah konsentrasi S1 dapat dihitung.
Tampilkan koreksi terperinci
Koreksi dengan pembahasan dan penalaran yang diharapkan
Bagi tiap jumlah mentah dengan 1,000,000. Jumlah saldo 2,500+1,500+3,000+2,000=9,000. E mengeluarkan 5,000, tersisa 4,000. A sebesar 2,500/9,000=27.7778% dari total, dibulatkan empat desimal, dan 2,500/4,000=62.5% dari penyebut disesuaikan.
F1 membagi dengan 1,000,000,000 sehingga seribu kali lebih kecil. Pertahankan mentah 9,000,000,000; koreksi interpretasi presisi, bukan jumlah dasar.
Total mentah S1 = 9,000,000,000−500,000,000+750,000,000=9,250,000,000, atau 9,250 token. Konsentrasi S1 tidak diketahui karena alokasi baru hilang. Jangan pakai saldo S0 sebagai snapshot berikutnya.
Skor sepuluh: konversi/rekonsiliasi (tiga), pengecualian/kedua bagian (tiga), jumlah peristiwa (dua), faktor/batas alokasi berikutnya (dua).
Daftar periksa
- Verifikasi aset tepat dan jumlah desimal.
- Pertahankan integer mentah.
- Labeli unit dan pembulatan.
- Rekonsiliasi konteks selaras.
- Nyatakan tiap pengecualian/kebijakan.
- Biarkan saldo berikutnya yang hilang tidak diketahui.
Ringkasan
Presisi dan definisi mendahului perbandingan pasokan. Pengecualian mengubah penyebut analitis; peristiwa buku besar mengubah pasokan akuntansi.
Ringkasan
Unit mentah bukan token tampilan. Kebijakan pasokan berbeda menjawab pertanyaan berbeda. Total benar tidak memberi distribusi atau likuiditas saat ini.
Spesifikasi visual
Tampilkan tangga mentah→tampilan d=6, rekonsiliasi S0, batang total 9,000 dan E4,000 terpisah. Tandai F1 d=9 salah presisi; tampilkan S1 total 9,250 tanpa grafik pemegang rekaan.
Unit dan kebijakan pasokan ilustratif; tanpa harga atau estimasi sirkulasi nyata.
Gunakan SVG/HTML deterministik atau grafik dengan alternatif teks, biru tua/hitam serta sian, biru elektrik, dan violet secukupnya. Beri label setiap kuantitas dan ketidakpastian. Pada 390px susun panel vertikal; verifikasi 768px/desktop dan RTL Arab tetap menjadi pekerjaan aset berikutnya. Pertahankan pengenal LTR serta sumbu dan arah hubungan faktual. Jika merek ditambahkan, gunakan hanya logo resmi BlockAssay yang disediakan. Kedua rekaman adalah spesifikasi, bukan aset yang telah diserahkan.
Alat
Gunakan RADAR hanya untuk tujuan edukasi terbatas pelajaran ini jika dukungan jaringan, identitas tepat, bidang, dan asal data telah diverifikasi. Konten ini tidak menyatakan endpoint runtime atau kemampuan penyedia apa pun. Gunakan data latihan offline tertanam tanpa akses berbayar. Data yang hilang tetap tidak diketahui; koneksi dompet, tanda tangan transaksi, peluncuran token, atau perdagangan langsung tidak diperlukan. Kemajuan Academy, pembayaran, dan rujukan tidak pernah mengubah bukti Radar. Paspor Diagnostik mempertahankan observasi dan batasannya, bukan prediksi harga atau sertifikat keamanan.
Sumber dan batas klaim
- Aset Solana — Identitas mint/akun/program dan desimal; bedakan bidang kepemilikan akun. Diperiksa 2026-09-30.
- Solana getTokenSupply — Pasokan mentah, desimal, dan konteks respons RPC; bukan definisi pasokan beredar. Diperiksa 2026-09-30.
- Standar Token ERC-20 — Antarmuka standar; nama, simbol, dan desimal opsional; bukan sertifikasi hak istimewa atau identitas. Diperiksa 2026-09-30.
Dokumentasi mendukung mekanisme, bukan nilai dataset fiktif. Semua contoh dan rekaman latihan merupakan materi ILLUSTRATIVE asli yang dibekukan dalam berkas ini. S0/S1 adalah label konteks sintetis; observedAt bernilai null karena tidak ada pengukuran buku besar langsung atau historis yang dikumpulkan. Tinjau ulang dokumentasi dan perilaku penerapan aktual sebelum publikasi atau integrasi.
Pelajaran berikutnya
P08-L03 setelah latihan dengan pembahasan dan peninjauan kuis.
Spesifikasi visual
P08-L02-V01
Bagaimana unit dan kebijakan pengecualian mengubah pasokan dilaporkan?
Unit dan kebijakan pasokan ilustratif; tanpa harga atau estimasi sirkulasi nyata.
Tampilkan tangga mentah→tampilan d=6, rekonsiliasi S0, batang total 9,000 dan E4,000 terpisah. Tandai F1 d=9 salah presisi; tampilkan S1 total 9,250 tanpa grafik pemegang rekaan.
Empat saldo berjumlah 9,000 token; pengecualian menyisakan4,000; jumlah peristiwa memberi 9,250 kemudian dengan alokasi tidak diketahui.
390px panel vertikal dengan padanan teks; verifikasi 768px dan desktop kemudian
Label dan navigasi RTL; pengenal diisolasi LTR; pertahankan sumbu numerik, urutan peristiwa, dan arah hubungan faktual.
FIX-P08-02
P08-L02-V02
Klaim mana yang didukung, bersyarat, tidak diketahui, atau tidak didukung?
Batas bukti ilustratif; tanpa kesimpulan keamanan atau investasi.
Empat baris berlabel OBSERVED/INFERRED/UNKNOWN/INSUFFICIENT EVIDENCE yang terkait dengan klaim dan ID rekaman pelajaran ini. Observasi adalah rekaman fiktif yang disediakan, bukan pengukuran langsung.
Empat baris status bukti dengan penunjuk rekaman dan langkah verifikasi berikutnya.
390px panel vertikal dengan padanan teks; verifikasi 768px dan desktop kemudian
Label dan navigasi RTL; pengenal diisolasi LTR; pertahankan sumbu numerik, urutan peristiwa, dan arah hubungan faktual.
FIX-P08-02
Sumber dan batas klaim
S08-TOKENS · official_documentation_or_standard
Aset Solana
- Klaim yang didukung
- Identitas mint/akun/program dan desimal; bedakan bidang kepemilikan akun.
- Batas verifikasi
- Halaman primer diperiksa untuk mendukung mekanisme secara editorial; tidak ada aset yang diterapkan atau data latihan buku besar yang diukur secara independen.
- Tanggal pemeriksaan
- 2026-09-30
https://solana.com/docs/tokens
S08-SUPPLY · official_documentation_or_standard
Solana getTokenSupply
- Klaim yang didukung
- Pasokan mentah, desimal, dan konteks respons RPC; bukan definisi pasokan beredar.
- Batas verifikasi
- Halaman primer diperiksa untuk mendukung mekanisme secara editorial; tidak ada aset yang diterapkan atau data latihan buku besar yang diukur secara independen.
- Tanggal pemeriksaan
- 2026-09-30
https://solana.com/docs/rpc/http/gettokensupply
S08-ERC20 · official_documentation_or_standard
Standar Token ERC-20
- Klaim yang didukung
- Antarmuka standar; nama, simbol, dan desimal opsional; bukan sertifikasi hak istimewa atau identitas.
- Batas verifikasi
- Halaman primer diperiksa untuk mendukung mekanisme secara editorial; tidak ada aset yang diterapkan atau data latihan buku besar yang diukur secara independen.
- Tanggal pemeriksaan
- 2026-09-30
https://eips.ethereum.org/EIPS/eip-20
Asal data
id: FIX-P08-02
dataStatus: ILLUSTRATIVE
observedAt: null
source: Original frozen educational fixture embedded in lesson
timeBasis: Synthetic S0/S1 snapshots, not UTC observations or real blocks
identifiers: Deliberately invalid fictional network, asset and account labels; never use as transaction targets
scope: Exhaustive fictional raw balances, explicit exclusion policy and complete mint/burn sequence.