Skema Metadata Token

Apa Itu Skema Metadata Token?

Skema Metadata Token adalah format terstruktur yang menentukan cara informasi tentang token kripto ditulis, disimpan, dan dibaca oleh wallet, dApp, explorer, marketplace, game, serta alat pengindeksan.

Dalam sebagian besar pembahasan kripto, Skema Metadata Token merujuk pada struktur JSON yang digunakan untuk mendeskripsikan NFT dan aset tokenisasi lainnya.

Skema ini memberi tahu aplikasi kolom apa yang perlu diharapkan, seperti

, , , , dan tautan media.

Kontrak token dapat menyimpan kepemilikan secara on-chain, sedangkan metadatanya disimpan melalui URI yang mengarah ke file JSON.

Standar ERC-721 resmi menyatakan bahwa URI token dapat mengarah ke file JSON yang sesuai dengan ERC-721 Metadata JSON Schema.

Standar ERC-1155 resmi mendefinisikan ERC-1155 Metadata URI JSON Schema untuk kontrak multi-token.

Skema metadata penting karena membantu berbagai aplikasi menampilkan token yang sama secara konsisten.

Tanpa skema, setiap proyek dapat memberi nama kolom secara berbeda, sehingga wallet akan kesulitan mengetahui nilai mana yang merupakan gambar, deskripsi, atau karakteristik token.

Bagi pemula, cara termudah memahami Skema Metadata Token adalah dengan menganggapnya sebagai format label untuk aset kripto.

Blockchain membuktikan bahwa token tersebut ada dan siapa pemiliknya, sedangkan skema metadata menjelaskan apa yang direpresentasikan token tersebut.

Mengapa Skema Metadata Token Penting dalam Kripto

Skema Metadata Token penting karena pengguna tidak hanya berinteraksi dengan ID token mentah.

Pengguna berinteraksi dengan gambar, nama, deskripsi, karakteristik, level, lencana, informasi kelangkaan, konten yang dapat dibuka, dan detail lain yang dapat dibaca manusia.

Wallet hanya dapat menampilkan token dengan tepat jika mengetahui cara membaca metadata.

Game hanya dapat menampilkan item dengan tepat jika memahami atribut dan kolom media item tersebut.

Marketplace hanya dapat memfilter koleksi dengan tepat jika karakteristik disusun secara dapat diprediksi.

Protokol pinjaman yang menerima NFT sebagai jaminan mungkin memerlukan informasi koleksi, karakteristik, dan media yang akurat untuk mendukung alur kerja valuasi.

Platform aset dunia nyata mungkin memerlukan kolom metadata yang merujuk pada dokumen, penerbit, penilaian, ketentuan hukum, atau status verifikasi.

Aplikasi dengan akses berbasis token mungkin memerlukan metadata untuk memverifikasi apakah token memberikan akses ke tingkat keanggotaan tertentu.

Saat metadata disusun dengan jelas, aplikasi dapat membacanya secara otomatis.

Saat metadata berantakan atau tidak konsisten, pengguna mungkin melihat gambar rusak, karakteristik yang hilang, nama yang salah, atau detail aset yang sudah tidak terbaru.

Karena itu, desain skema metadata merupakan bagian dari pengalaman pengguna kripto, bukan hanya detail untuk developer.

Skema Metadata Token dan Token URI

Token URI adalah tautan atau pengenal yang mengarah ke metadata token.

Skema Metadata Token adalah struktur data yang ditemukan pada tautan tersebut atau di dalam respons yang dikodekan itu.

Misalnya, kontrak ERC-721 dapat mengembalikan

dari .

File JSON pada URI tersebut seharusnya mengikuti skema metadata agar wallet dapat memahaminya.

Token URI adalah alamat metadata.

Skema Metadata Token adalah format metadata.

Perbedaan ini penting karena URI yang berfungsi tidak cukup jika JSON di dalam URI tidak valid atau membingungkan.

Token dapat memiliki file metadata yang dapat diakses, tetapi tetap ditampilkan secara keliru jika kolomnya tidak ada atau dinamai dengan cara nonstandar.

Token juga dapat memiliki skema yang benar, tetapi gagal dimuat jika URI mengarah ke penyimpanan yang tidak tersedia.

Desain NFT yang baik memerlukan Token URI yang andal dan Skema Metadata Token yang rapi.

Skema Metadata Token dalam ERC-721

ERC-721 adalah standar klasik untuk NFT unik pada jaringan bergaya Ethereum.

Ekstensi metadata ERC-721 mencakup

, , dan .

Standar ERC-721 mendeskripsikan metadata dengan skema JSON sederhana yang dapat mencakup kolom seperti

, , dan .

Struktur sederhana ini membantu NFT menjadi lebih mudah ditampilkan di berbagai wallet dan aplikasi.

Token ERC-721 dapat merepresentasikan karya seni digital, item game, pass keanggotaan, sertifikat, tanah virtual, lencana identitas, atau catatan aset dunia nyata.

Setiap ID token dapat memiliki file metadata sendiri.

Artinya, ID Token 1 dapat memiliki gambar, nama, dan atribut yang berbeda dari ID Token 2.

Skema membantu klien memahami kolom yang mendeskripsikan setiap token unik.

Developer sering memperluas pola metadata dasar ERC-721 dengan kolom tambahan untuk karakteristik, media, animasi, kelangkaan, lisensi, atau data khusus proyek.

Ekstensi tersebut dapat berguna, tetapi kolom inti harus tetap jelas dan kompatibel dengan alat Web3 umum.

Skema Metadata Token dalam ERC-1155

ERC-1155 adalah standar multi-token yang dapat mengelola token fungibel, semi-fungibel, dan nonfungibel dalam satu kontrak.

Skema metadata ERC-1155 sangat penting karena satu kontrak dapat memuat banyak ID token dengan makna berbeda.

Satu kontrak ERC-1155 dapat merepresentasikan koin game, senjata, zirah, tiket, lencana, edisi terbatas, dan koleksi unik.

Standar ERC-1155 memungkinkan URI menyertakan placeholder

.

Perangkat lunak klien mengganti

dengan ID token sebenarnya sebelum mengambil metadata.

Dokumentasi OpenZeppelin ERC-1155 Metadata URI resmi menjelaskan bahwa ekstensi URI metadata mengarahkan setiap token ke file JSON yang mengikuti ERC-1155 Metadata URI JSON Schema.

Metadata ERC-1155 dapat mencakup kolom seperti

, , , , dan data khusus token lainnya.

Skema ini memungkinkan wallet dan dApp menampilkan banyak jenis aset dari satu kontrak tanpa memerlukan logika khusus untuk setiap ID token.

Metadata ERC-1155 harus ditangani dengan cermat karena penggantian ID yang salah dapat menyebabkan tampilan rusak atau keliru.

Desain metadata ERC-1155 yang kuat membuat setiap ID token mudah diinterpretasikan dan diambil secara andal.

Kolom Umum dalam Skema Metadata Token

Kolom yang paling umum adalah

, yang memberi token judul yang dapat dibaca manusia.

Kolom umum berikutnya adalah

, yang menjelaskan apa yang direpresentasikan token.

Kolom

biasanya mengarah ke gambar utama yang ditampilkan di wallet dan marketplace.

Kolom

dapat mengarah ke media yang lebih kaya, seperti video, audio, objek 3D, atau konten interaktif jika didukung oleh klien.

Kolom

dapat mengarah ke halaman resmi dengan informasi lebih lanjut tentang token atau koleksi.

Kolom

biasanya berisi array objek karakteristik untuk kelangkaan, pemfilteran, statistik game, dan pengaturan koleksi.

Kolom

terkadang digunakan untuk menyarankan warna latar tampilan aset.

Kolom

sering digunakan untuk metadata bergaya ERC-1155 atau informasi terstruktur khusus proyek.

Sejumlah proyek menambahkan kolom seperti

, , , , atau .

Kolom khusus dapat berguna, tetapi harus didokumentasikan agar aplikasi dapat menafsirkannya dengan tepat.

Contoh Skema Metadata NFT Dasar

File metadata NFT sederhana biasanya berupa objek JSON dengan beberapa kolom yang jelas.

Contoh ini menunjukkan nama yang mudah dibaca, deskripsi, referensi gambar, dan dua atribut.

Skema ini cukup sederhana untuk diurai oleh wallet dan dApp.

Gambar menggunakan URI bergaya IPFS, yang berarti media dirujuk melalui penyimpanan berbasis alamat konten.

Atribut disusun sebagai array, sehingga alat pemfilteran dan kelangkaan lebih mudah dibuat.

Proyek dapat menambahkan lebih banyak kolom, tetapi sebaiknya menghindari kompleksitas yang tidak perlu dan merusak kompatibilitas.

Metadata terbaik dapat dibaca mesin sekaligus mudah dipahami manusia.

Kolom Name

Kolom

memberikan judul tampilan token.

Untuk koleksi NFT, pola umum adalah menggunakan nama koleksi dan nomor token.

Contohnya adalah

.

Item game dapat menggunakan nama seperti

atau .

Token keanggotaan dapat menggunakan nama seperti

.

Nama harus stabil, jelas, dan tidak menyesatkan.

Koleksi palsu dapat menyalin nama proyek asli, sehingga pengguna tidak boleh hanya mengandalkan kolom nama.

Alamat kontrak resmi lebih penting daripada nama yang ditampilkan.

Developer sebaiknya menghindari perubahan nama yang tidak terduga, kecuali token memang dirancang dinamis.

Kolom nama yang baik meningkatkan pengenalan tanpa berpura-pura membuktikan keaslian.

Kolom Description

Kolom

menjelaskan apa yang direpresentasikan token.

Deskripsi yang jelas membantu pengguna memahami tujuan, cerita, utilitas, atau peran keanggotaan aset.

Untuk NFT seni, deskripsi dapat menjelaskan konsep atau tema koleksi.

Untuk item game, deskripsi dapat menjelaskan cara penggunaan item tersebut.

Untuk token aset dunia nyata, deskripsi dapat merangkum kategori aset sambil mengarahkan pengguna ke dokumen hukum di tempat lain.

Deskripsi tidak boleh memuat klaim menyesatkan tentang nilai, imbal hasil yang dijamin, atau status resmi.

Wallet dan dApp dapat menampilkan deskripsi langsung kepada pengguna, sehingga tautan tidak aman atau pesan scam dapat menciptakan risiko phishing.

Developer harus menjaga agar deskripsi tetap berguna dan jujur.

Pengguna harus mengingat bahwa deskripsi disediakan oleh pembuat token atau pengendali metadata.

Deskripsi bukan verifikasi independen atas kualitas atau legitimasi token.

Kolom Image

Kolom

mengarah ke file media utama yang ditampilkan untuk token.

Kolom ini dapat mengarah ke PNG, JPG, GIF, SVG, atau format gambar lain yang didukung, tergantung aplikasinya.

Gambar dapat disimpan di IPFS, Arweave, server HTTPS, atau dikodekan langsung di dalam metadata.

Kolom gambar penting karena banyak pengguna mengidentifikasi NFT secara visual.

Tautan gambar yang rusak dapat membuat token tampak tidak lengkap meskipun kepemilikannya valid secara on-chain.

Gambar yang menyesatkan dapat membuat token palsu tampak sah.

URL gambar terpusat dapat hilang jika server atau domain gagal berfungsi.

URI gambar berbasis alamat konten dapat meningkatkan integritas, tetapi konten tetap perlu tersedia melalui penyimpanan atau pinning.

Developer sebaiknya menggunakan penyimpanan gambar yang tahan lama untuk aset jangka panjang.

Pengguna sebaiknya memeriksa kualitas penyimpanan gambar sebelum mempercayai NFT bernilai tinggi.

Kolom Attributes

Kolom

umumnya digunakan untuk mendeskripsikan karakteristik, kelangkaan, properti game, level, status, atau fitur terstruktur lainnya.

Setiap atribut biasanya berupa objek dengan

dan .

Misalnya,

dapat berupa dan dapat berupa .

Untuk item game,

dapat berupa dan dapat berupa .

Struktur atribut penting karena marketplace dan alat analitik menggunakannya untuk pemfilteran serta peringkat kelangkaan.

Atribut yang tidak konsisten dapat membuat alat kelangkaan menjadi tidak akurat.

Nama karakteristik yang salah eja dapat membagi satu kategori yang seharusnya menjadi beberapa kategori.

Atribut numerik harus diformat secara konsisten agar alat dapat membandingkannya dengan benar.

NFT dinamis harus menjelaskan apakah atribut dapat berubah seiring waktu.

Atribut yang baik membantu pengguna memahami identitas dan utilitas token.

Kolom Properties

Kolom

sering digunakan untuk menyimpan metadata terstruktur di luar data nama, deskripsi, dan gambar dasar.

Contoh metadata ERC-1155 umumnya menggunakan

untuk informasi token tambahan.

Item game dapat mencakup properti seperti kelangkaan, kelas, daya tahan, atau bahan crafting.

Token tiket dapat mencakup properti seperti tanggal acara, tingkat kursi, lokasi, dan jenis akses.

Token aset dunia nyata dapat mencakup properti seperti kategori aset, referensi penerbit, yurisdiksi, hash dokumen, atau status verifikasi.

Properties dapat sangat berguna karena memungkinkan model data yang lebih kaya.

Namun, data ini juga dapat menjadi berantakan jika setiap proyek menggunakan nama dan format berbeda tanpa dokumentasi.

Developer harus menjaga agar nama properti stabil dan dapat diprediksi.

Aplikasi harus memperlakukan properties sebagai data yang tidak tepercaya hingga diverifikasi oleh logika kontrak atau sumber tepercaya.

Kolom properti dapat mendeskripsikan aset, tetapi tidak otomatis membuktikan klaim tersebut benar.

Skema Metadata Token dan IPFS

IPFS umum digunakan untuk menyimpan metadata token dan file media.

Dokumentasi content addressing IPFS resmi menjelaskan bahwa IPFS menggunakan Content Identifier, atau CID, untuk merujuk data berdasarkan konten itu sendiri.

Hal ini bermanfaat bagi metadata karena CID dapat menunjukkan apakah konten yang dirujuk telah berubah.

Jika metadata JSON berubah, CID juga seharusnya berubah.

Hal ini memberi pengguna integritas yang lebih kuat daripada URL server biasa yang dapat mengubah konten pada alamat yang sama.

Namun, IPFS tidak otomatis menjamin ketersediaan selamanya.

File metadata dan gambar perlu di-pin atau disajikan oleh node agar klien dapat mengambilnya.

Skema metadata yang disimpan di IPFS tetap dapat rusak jika tidak ada pihak yang menjaga konten tetap tersedia.

Developer sebaiknya merencanakan pinning dan penyimpanan jangka panjang sebelum melakukan minting token.

Pengguna perlu memahami bahwa content addressing meningkatkan integritas, tetapi ketersediaan tetap memerlukan dukungan penyimpanan.

Skema Metadata Token dan Penyimpanan HTTP

Beberapa proyek menyimpan metadata pada server HTTPS standar.

Metode ini dapat membuat metadata mudah diperbarui, dibuat, dan disajikan dengan cepat.

Metode ini umum untuk NFT dinamis, aset game, mekanisme reveal, dan aset yang bergantung pada sistem backend aktif.

Kekurangannya adalah metadata HTTP bergantung pada waktu aktif server, kontrol domain, keamanan hosting, dan operasional proyek.

Jika server offline, metadata token dapat hilang dari antarmuka pengguna.

Jika domain kedaluwarsa, endpoint metadata dapat menjadi tidak aman atau tidak tersedia.

Jika operator server mengubah JSON, pengguna mungkin melihat konten berbeda tanpa perubahan on-chain.

Metadata HTTP tidak otomatis buruk, tetapi harus diungkapkan dengan jelas.

Developer harus menjelaskan apakah metadata dapat diubah dan berapa lama penyimpanan akan dipertahankan.

Pengguna sebaiknya lebih berhati-hati terhadap aset bernilai tinggi yang sepenuhnya bergantung pada server metadata terpusat.

Skema Metadata Token dan Metadata On-Chain

Metadata on-chain berarti metadata token disimpan atau dihasilkan langsung oleh smart contract.

Hal ini dapat mengurangi ketergantungan pada sistem penyimpanan eksternal.

Kontrak dapat mengembalikan URI

yang berisi metadata yang dikodekan.

Metadata dapat mencakup gambar SVG on-chain atau logika seni generatif.

Metadata on-chain dapat meningkatkan daya tahan karena data terikat pada status blockchain.

Metode ini juga dapat lebih mahal karena penyimpanan dan pembuatan data on-chain membutuhkan sumber daya.

Metadata on-chain dapat lebih sulit diubah, yang berguna untuk permanensi tetapi kurang berguna bagi game atau kredensial dinamis.

Developer sebaiknya memilih metadata on-chain saat permanensi dan minimisasi kepercayaan lebih penting daripada fleksibilitas.

Pengguna tetap harus memeriksa logika kontrak karena metadata on-chain juga dapat dinamis jika kontrak mengizinkannya.

Metadata on-chain adalah model penyimpanan, bukan jaminan otomatis atas kualitas.

Skema Metadata Token dan NFT Dinamis

NFT dinamis adalah token yang metadatanya dapat berubah berdasarkan peristiwa, waktu, gameplay, data oracle, keputusan tata kelola, atau tindakan pengguna.

Metadata dinamis dapat membuat NFT lebih berguna dan interaktif.

Karakter game dapat naik level.

Pass keanggotaan dapat berubah dari aktif menjadi kedaluwarsa.

Kredensial dapat diperbarui setelah pengguna menyelesaikan pencapaian baru.

Token aset dunia nyata dapat memperbarui status verifikasi atau referensi dokumen.

Skema metadata harus memperjelas kolom dinamis.

Pengguna harus mengetahui kolom mana yang dapat berubah dan siapa yang mengendalikan perubahan tersebut.

NFT dinamis tidak boleh menyembunyikan kontrol admin yang sewenang-wenang di balik bahasa metadata yang tidak jelas.

Metadata dinamis yang baik dapat diprediksi, didokumentasikan, dan terhubung dengan perilaku token yang bermakna.

Skema Metadata Token dan Pembaruan Metadata

Pembaruan metadata umum dilakukan saat reveal, progres game, verifikasi aset, dan koreksi kesalahan.

Ekstensi pembaruan metadata ERC-4906 resmi mendefinisikan event yang memberi tahu klien saat metadata NFT berubah.

Hal ini penting karena wallet dan indexer sering menyimpan metadata dalam cache demi kecepatan.

Jika metadata berubah tetapi tidak ada sinyal pembaruan yang dikirim, pengguna mungkin terus melihat informasi lama.

Skema metadata harus dipasangkan dengan perilaku pembaruan yang jelas.

Untuk reveal, proyek harus menjelaskan kapan metadata placeholder akan berubah menjadi metadata final.

Untuk aset dinamis, proyek harus menjelaskan peristiwa yang memicu perubahan metadata.

Untuk pembaruan yang dikendalikan admin, proyek harus mengungkapkan siapa yang dapat mengubah metadata dan dalam kondisi apa.

Pembaruan metadata yang transparan membangun kepercayaan.

Pembaruan metadata tersembunyi menciptakan ketidakpastian dan dapat merusak nilai token.

Skema Metadata Token dan Metadata Tingkat Kontrak

Metadata tingkat token mendeskripsikan ID token tertentu.

Metadata tingkat kontrak mendeskripsikan seluruh kontrak atau koleksi.

Standar metadata tingkat kontrak ERC-7572 resmi menstandarkan

untuk informasi tingkat kontrak yang kaya, seperti nama, deskripsi, dan gambar.

Hal ini berguna karena koleksi mungkin memerlukan logo, banner, deskripsi, informasi biaya, tautan sosial, atau gambar tingkat proyek.

Satu NFT dalam koleksi dapat memiliki Skema Metadata Token sendiri, sementara koleksi tersebut juga memiliki skema metadata tingkat kontrak.

Kedua lapisan penting bagi pengalaman pengguna.

Jika metadata token benar tetapi metadata koleksi salah, pengguna tetap dapat melihat informasi yang membingungkan.

Jika metadata koleksi benar tetapi metadata token rusak, token individual mungkin tidak ditampilkan dengan tepat.

Developer harus mendukung metadata tingkat token dan tingkat kontrak jika relevan.

Pengguna harus memahami bahwa keduanya adalah lapisan metadata yang terkait tetapi berbeda.

Skema Metadata Token dan ERC-1046

ERC-1046 memperluas gagasan token URI di luar kasus penggunaan NFT dasar.

Proposal interoperabilitas tokenURI ERC-1046 resmi menambahkan dukungan token URI untuk ERC-20 dan memperluas interoperabilitas metadata di berbagai jenis token.

Hal ini penting karena token fungibel juga dapat memerlukan metadata.

Token fungibel mungkin memerlukan logo, deskripsi, detail penerbit, tautan resmi, catatan kepatuhan, atau referensi dokumentasi.

Metadata yang terstandarisasi membantu wallet dan aplikasi menyajikan token fungibel dengan lebih jelas.

Namun, pengguna tidak boleh memperlakukan kolom metadata sebagai bukti legitimasi.

Token scam dapat menyediakan logo dan deskripsi yang menarik.

Alamat kontrak, penerbit, likuiditas, keamanan, tokenomics, dan sumber resmi tetap penting.

ERC-1046 menunjukkan bahwa skema metadata tidak hanya tentang gambar koleksi.

Skema metadata merupakan bagian dari upaya yang lebih luas untuk membuat informasi token dapat dioperasikan bersama.

Skema Metadata Token dan ERC-5625

ERC-5625 adalah ekstensi metadata yang diusulkan terkait informasi penyimpanan terdesentralisasi untuk NFT.

ERC-5625 NFT Metadata JSON Schema dStorage Extension resmi menambahkan properti penyimpanan terdesentralisasi pada metadata NFT agar informasi penyimpanan aset dapat dijelaskan lebih jelas.

Hal ini penting karena metadata sering mengarah ke file yang disimpan di luar blockchain.

Token dapat tampak tahan lama, tetapi medianya mungkin bergantung pada pengaturan penyimpanan yang tidak jelas.

Penambahan metadata terkait penyimpanan dapat membantu pengguna dan aplikasi memahami tempat data aset disimpan.

Metadata ini juga dapat membantu mengidentifikasi apakah konten disimpan di IPFS, Arweave, atau sistem penyimpanan terdesentralisasi lainnya.

Metadata penyimpanan tidak menjamin permanensi dengan sendirinya.

Metadata tersebut memberi aplikasi cara yang lebih jelas untuk mendeskripsikan dan memeriksa asumsi penyimpanan.

Untuk NFT bernilai tinggi, detail penyimpanan terdesentralisasi dapat menjadi bagian penting dari uji tuntas.

Skema metadata menjadi lebih kuat ketika menjelaskan aset dan cara datanya dipertahankan.

Validasi Skema

Validasi skema berarti memeriksa apakah metadata mengikuti struktur yang diharapkan.

Validator dapat memeriksa apakah JSON valid.

Validator dapat memeriksa apakah kolom wajib tersedia.

Validator dapat memeriksa apakah kolom gambar merupakan URI yang valid.

Validator dapat memeriksa apakah atribut diformat sebagai array.

Validator dapat memeriksa apakah nilai numerik disimpan secara konsisten.

Validator dapat memeriksa apakah kolom media mengarah ke jenis file yang didukung.

Validasi skema membantu mencegah tampilan wallet rusak dan kesalahan marketplace.

Validasi juga membantu developer menemukan kesalahan sebelum minting atau reveal.

Proyek sebaiknya memvalidasi metadata sebelum menerbitkannya secara permanen ke penyimpanan terdesentralisasi.

Skema Metadata dan Kelangkaan

Alat kelangkaan sering bergantung pada kolom

dalam metadata NFT.

Jika atribut tidak konsisten, perhitungan kelangkaan dapat menjadi tidak akurat.

Misalnya,

, , dan dapat diperlakukan sebagai nilai berbeda oleh beberapa alat.

Jika satu token menggunakan

dan token lain menggunakan , alat kelangkaan dapat memisahkan kategori karakteristik tersebut.

Jika karakteristik tidak ada pada beberapa token, perhitungan kelangkaan dapat berubah secara tidak terduga.

Proyek harus menggunakan nama dan nilai karakteristik yang konsisten di seluruh koleksi.

Proyek juga harus membekukan metadata final jika koleksi dimaksudkan tidak dapat diubah.

Pengguna perlu berhati-hati selama periode reveal karena data kelangkaan mungkin belum stabil.

Kualitas skema metadata dapat langsung memengaruhi cara kolektor menilai NFT.

Untuk koleksi dengan harga berbasis karakteristik, metadata yang rapi sangat penting.

Skema Metadata dan Aset Game

Aset game sering memerlukan skema metadata yang lebih kaya daripada NFT seni sederhana.

Item game mungkin memerlukan kolom untuk level, daya tahan, kekuatan serangan, pertahanan, kelangkaan, kelas, elemen, cooldown, status peningkatan, atau slot perlengkapan.

NFT karakter mungkin memerlukan kolom untuk pengalaman, keterampilan, inventaris, faksi, kesehatan, dan keadaan visual.

Sejumlah kolom tersebut dapat berubah selama gameplay.

Developer harus menentukan nilai mana yang berada secara on-chain dan nilai mana yang berada dalam metadata.

Logika gameplay penting tidak boleh hanya bergantung pada metadata off-chain yang belum diverifikasi.

Kontrak atau server game harus memverifikasi nilai utama sebelum mengizinkan tindakan bernilai tinggi.

Metadata dapat meningkatkan tampilan, tetapi aturan game harus dilindungi oleh logika tepercaya.

Pengguna harus memahami apakah nilai item bergantung pada game yang terus beroperasi.

Skema metadata dapat mendeskripsikan aset game, tetapi ekosistem game memberikan utilitasnya.

Skema Metadata dan Aset Dunia Nyata

Token aset dunia nyata dapat menggunakan skema metadata untuk mendeskripsikan aset off-chain.

Contohnya dapat mencakup catatan properti, komoditas, faktur, obligasi, unit dana, koleksi, kredit karbon, atau kredensial yang terhubung dengan identitas.

Skema metadata dapat mencakup kolom untuk penerbit, kategori aset, URI dokumen, tanggal valuasi, yurisdiksi, kustodian, status verifikasi, dan hash dokumen.

Kolom-kolom ini dapat membantu pengguna memahami token, tetapi tidak otomatis menciptakan kepemilikan legal.

Hak hukum bergantung pada dokumen penerbit, kontrak, pengaturan kustodian, yurisdiksi, dan aturan penebusan.

Skema metadata aset dunia nyata harus memisahkan informasi pemasaran dari referensi yang penting secara hukum.

Skema tersebut harus menghindari klaim samar yang tidak dapat diverifikasi.

Skema tersebut harus menjaga integritas dokumen melalui hash atau penyimpanan tahan lama jika memungkinkan.

Pengguna harus membaca dokumen hukum resmi sebelum mengandalkan metadata aset dunia nyata.

Metadata dapat mendukung pengungkapan, tetapi tidak dapat menggantikan uji tuntas hukum.

Skema Metadata dan Risiko Keamanan

Metadata token dapat menciptakan risiko keamanan karena wallet dan dApp mengambil serta menampilkan data dari sumber eksternal.

File metadata berbahaya dapat menyertakan tautan phishing, pesan reward palsu, gambar menyesatkan, atau URL eksternal berbahaya.

NFT spam dapat muncul di wallet dan menggunakan metadata untuk meminta pengguna mengunjungi halaman klaim palsu.

Koleksi palsu dapat menyalin nama, gambar, dan atribut dari koleksi asli.

Server metadata yang disusupi dapat kemudian mengubah metadata yang tampak aman menjadi konten berbahaya.

Wallet dan dApp harus memperlakukan metadata sebagai input yang tidak tepercaya.

Wallet dan dApp tidak boleh menjalankan skrip dari metadata.

Wallet dan dApp harus menyanitasi tautan eksternal dan konten media jika memungkinkan.

Pengguna tidak boleh memasukkan frasa pemulihan, kunci privat, atau backup wallet hanya karena metadata meminta pengguna melakukannya.

Skema metadata yang tampak rapi tidak membuktikan token aman.

Skema Metadata dan Mutabilitas

Mutabilitas berarti metadata dapat berubah setelah token dicetak.

Beberapa proyek memerlukan mutabilitas karena tokennya dinamis.

Proyek lain menjanjikan bahwa metadata akan permanen dan tidak berubah.

Skema metadata harus sesuai dengan janji proyek.

Jika koleksi dipasarkan sebagai karya seni yang tidak dapat diubah, metadata tidak boleh tetap berada di bawah kontrol admin tanpa batas.

Jika token adalah item game, metadata dinamis mungkin wajar diharapkan.

Jika token adalah kredensial, pembaruan mungkin diperlukan, tetapi harus dapat diaudit.

Pengguna harus memeriksa pihak yang mengendalikan pembaruan metadata.

Developer harus mendokumentasikan apakah metadata tidak dapat diubah, dinamis, dikendalikan admin, atau dikendalikan tata kelola.

Mutabilitas tersembunyi adalah salah satu risiko kepercayaan terbesar dalam metadata NFT.

Skema Metadata dan Caching

Caching berarti menyimpan metadata sementara agar aplikasi dapat memuat token lebih cepat.

Wallet, marketplace, explorer, dan indexer sering menyimpan metadata dalam cache.

Caching berguna karena mengambil setiap file metadata berulang kali akan lambat.

Masalahnya, metadata yang di-cache dapat menjadi usang.

Selama reveal, beberapa aplikasi mungkin masih menampilkan gambar placeholder setelah metadata final diterbitkan.

Selama pembaruan dinamis, beberapa aplikasi mungkin menampilkan atribut lama hingga cache diperbarui.

Standar pembaruan metadata dapat membantu klien mengetahui kapan harus memperbarui data cache.

Developer harus mendukung event pembaruan saat metadata diperkirakan akan berubah.

Pengguna harus memahami bahwa keterlambatan tampilan mungkin berasal dari cache, bukan kegagalan token.

Skema metadata yang kuat berfungsi paling baik bila dipasangkan dengan perilaku refresh cache yang baik.

Skema Metadata dan Indexer

Indexer mengumpulkan data blockchain dan mengaturnya untuk aplikasi.

Untuk metadata token, indexer dapat memanggil

, mengambil file JSON, mengurai atribut, menyimpan gambar dalam cache, dan menyediakan respons API.

Indexer memerlukan skema metadata yang dapat diprediksi agar bekerja secara efisien.

Jika setiap proyek menggunakan nama kolom yang tidak biasa, indexer harus membuat logika khusus.

Jika file metadata tidak valid atau lambat, indexer mungkin gagal menampilkan aset dengan tepat.

Jika metadata berubah tanpa event, indexer mungkin menampilkan data lama.

Inilah alasan konsistensi skema membantu seluruh ekosistem Web3.

Developer sebaiknya menguji metadata dengan perilaku indexer umum sebelum peluncuran.

Pengguna perlu mengetahui bahwa wallet berbeda dapat menampilkan metadata berbeda jika indexer mereka melakukan refresh pada waktu berbeda.

Indexer adalah bagian yang tersembunyi tetapi penting dalam kegunaan metadata token.

Praktik Terbaik untuk Developer

Gunakan kolom metadata yang didukung luas, seperti

, , , dan .

Kembalikan JSON yang valid dari setiap Token URI.

Gunakan nama dan nilai karakteristik yang stabil di seluruh koleksi.

Gunakan penyimpanan yang tahan lama untuk metadata dan file media.

Pin file IPFS atau gunakan rencana penyimpanan jangka panjang yang andal.

Dokumentasikan apakah metadata dapat diubah, tidak dapat diubah, atau dinamis.

Kirim event pembaruan metadata saat metadata berubah.

Validasi metadata sebelum menerbitkannya secara permanen.

Uji perilaku tampilan di berbagai wallet, explorer, dan dApp.

Hindari menempatkan janji hukum sensitif hanya di dalam metadata yang dapat diedit.

Praktik Terbaik untuk Pengguna

Periksa apakah metadata token disimpan di IPFS, server, Arweave, atau secara on-chain.

Verifikasi alamat kontrak resmi alih-alih mempercayai nama atau gambar token.

Berhati-hatilah terhadap metadata yang berisi tautan eksternal atau klaim reward.

Jangan menandatangani transaksi hanya untuk melihat metadata.

Jangan memasukkan frasa pemulihan pada halaman apa pun yang ditautkan dari metadata token.

Periksa apakah metadata dapat diubah oleh admin.

Tinjau atribut dengan saksama selama periode reveal NFT.

Pahami bahwa gambar yang ditampilkan tidak membuktikan keaslian.

Untuk token aset dunia nyata, baca dokumen hukum di luar file metadata.

Perlakukan metadata sebagai informasi yang berguna, bukan bukti independen atas nilai atau keamanan.

Kesalahan Umum Skema Metadata Token

Kesalahan pertama adalah menerbitkan JSON yang tidak valid.

Kesalahan kedua adalah menggunakan nama atribut yang tidak konsisten di seluruh token.

Kesalahan ketiga adalah mengarahkan kolom gambar ke file yang tidak tersedia.

Kesalahan keempat adalah mengandalkan server terpusat tanpa pengungkapan.

Kesalahan kelima adalah mengubah metadata setelah minting tanpa aturan yang jelas.

Kesalahan keenam adalah melupakan persyaratan penggantian

ERC-1155.

Kesalahan ketujuh adalah menggunakan format media yang tidak didukung tanpa gambar cadangan.

Kesalahan kedelapan adalah memperlakukan metadata sebagai mengikat secara hukum padahal hanya bersifat deskriptif.

Kesalahan kesembilan adalah gagal mengirim event pembaruan saat metadata berubah.

Kesalahan kesepuluh adalah menyertakan tautan tidak aman yang dapat mengekspos pengguna pada phishing.

FAQ

Apa arti Skema Metadata Token?

Skema Metadata Token berarti format terstruktur yang digunakan untuk mendeskripsikan metadata token kripto, biasanya dalam JSON.

Apakah Skema Metadata Token hanya untuk NFT?

Tidak. Skema ini paling umum digunakan untuk NFT, tetapi juga dapat mendukung token fungibel, token aset dunia nyata, dan token khusus aplikasi.

Kolom apa yang umum dalam metadata NFT?

Kolom umum mencakup

, , , , , dan .

Apa perbedaan antara Token URI dan Skema Metadata Token?

Token URI mengarah ke metadata, sedangkan Skema Metadata Token menentukan struktur metadata yang ditemukan di sana.

Apa itu ERC-721 Metadata JSON Schema?

Ini adalah skema metadata dasar yang dijelaskan oleh ERC-721 untuk metadata NFT yang dikembalikan melalui token URI.

Apa itu ERC-1155 Metadata URI JSON Schema?

Ini adalah skema metadata yang digunakan oleh token ERC-1155, termasuk dukungan penggantian ID token melalui

.

Apakah metadata token dapat disimpan di IPFS?

Ya, metadata token dapat disimpan di IPFS menggunakan content identifier yang membantu memverifikasi integritas konten.

Apakah IPFS menjamin metadata selalu tersedia?

Tidak. IPFS meningkatkan content addressing, tetapi file tetap harus di-pin atau disajikan agar pengguna dapat mengambilnya.

Apakah metadata token dapat berubah setelah minting?

Ya, metadata dapat berubah jika proyek menggunakan metadata dinamis, server yang dapat diubah, base URI yang dikendalikan admin, atau logika resolver yang dapat diperbarui.

Apa itu metadata token dinamis?

Metadata token dinamis adalah metadata yang berubah berdasarkan waktu, gameplay, aktivitas pengguna, data oracle, status kontrak, atau pembaruan proyek.

Untuk apa ERC-4906 digunakan?

ERC-4906 mendefinisikan event pembaruan metadata agar wallet dan aplikasi mengetahui kapan metadata NFT perlu diperbarui.

Untuk apa ERC-7572 digunakan?

ERC-7572 menstandarkan

untuk metadata tingkat kontrak seperti nama, deskripsi, dan gambar koleksi.

Apakah metadata dapat berbahaya?

Ya, metadata dapat mencakup tautan phishing, klaim reward palsu, gambar menyesatkan, atau referensi eksternal yang tidak aman.

Mengapa karakteristik NFT terkadang ditampilkan secara keliru?

Karakteristik NFT mungkin ditampilkan secara keliru karena atribut tidak konsisten, hilang, salah eja, di-cache, atau diformat dengan cara yang tidak dipahami klien.

Apa yang membuat Skema Metadata Token baik?

Skema Metadata Token yang baik adalah valid, konsisten, tahan lama, terdokumentasi, kompatibel dengan alat umum, dan menjelaskan dengan jelas apakah metadata dapat berubah.

Kesimpulan

Skema Metadata Token adalah format terstruktur yang memberi tahu wallet, dApp, explorer, game, marketplace, dan indexer cara membaca informasi tentang token kripto.

Skema ini paling penting untuk NFT karena kepemilikan NFT disimpan secara on-chain, sedangkan nama, gambar, karakteristik, deskripsi, dan media sering disimpan melalui file metadata.

ERC-721 dan ERC-1155 sama-sama mendefinisikan pola metadata yang membantu aplikasi menemukan dan menampilkan informasi token secara konsisten.

Skema metadata yang baik membuat token lebih mudah dipahami, difilter, diperdagangkan, diverifikasi, dan digunakan dalam aplikasi.

Skema metadata yang lemah dapat menyebabkan gambar rusak, karakteristik hilang, data usang, risiko phishing, dan kebingungan pengguna.

Kolom penting mencakup

, , , , , dan properties khusus proyek.

Pilihan penyimpanan seperti IPFS, HTTPS, Arweave, dan data on-chain memengaruhi permanensi, mutabilitas, biaya, dan kepercayaan.

Pembaruan metadata harus transparan, terutama untuk reveal, NFT dinamis, aset game, kredensial, dan token aset dunia nyata.

Developer harus memvalidasi metadata, menggunakan penyimpanan tahan lama, mendokumentasikan mutabilitas, mengirim event pembaruan, dan menguji pada alat Web3 umum.

Pengguna harus memverifikasi alamat kontrak, menghindari tautan metadata mencurigakan, memahami risiko penyimpanan, dan memperlakukan metadata sebagai deskriptif, bukan bukti mutlak.

Dalam glosarium kripto, Skema Metadata Token harus dipahami sebagai format data yang memberi token kripto makna yang dapat dibaca manusia dan memungkinkan ekosistem Web3 menampilkan informasi token secara konsisten serta aman.