ERC-721: Identitas Token, Transfer, dan Antarmuka Opsional

ERC-721 menentukan antarmuka kepemilikan dan transfer untuk token beridentitas individual. Rujukan teknis ini berfokus pada rincian spesifikasi yang mudah terlewat dalam integrasi: ID yang harus diperlakukan sebagai nilai opak, cakupan operator, pemeriksaan penerima, enumerasi opsional, dan metadata yang dapat berubah. Entri glosarium di bawah menyediakan pengantar NFT yang lebih luas. [1]

Direktori Whitepaper & Riset Ethereum

Terakhir diperbarui: 2026-10-08

Dokumen dan cakupan

  • Judul: ERC-721: Non-Fungible Token Standard.
  • Penulis: William Entriken, Dieter Shirley, Jacob Evans, dan Nastassia Sachs.
  • Dibuat: 24 Januari 2018.
  • Status: Final, diperiksa 8 Oktober 2026.
  • Hak penggunaan: hak cipta dan hak terkait spesifikasi dilepaskan melalui CC0.

Sumber menstandarkan antarmuka kontrak, bukan ketentuan penjualan koleksi NFT, kebijakan pencetakan, atau lisensi media. Lisensi implementasi terpisah: contoh OpenZeppelin menggunakan MIT. [1] [3]

ID token harus diperlakukan sebagai nilai opak

ownerOf(tokenId) mengidentifikasi pemilik token saat ini; balanceOf(owner) menghitung NFT milik alamat tersebut. ID berupa uint256 yang unik dalam kontraknya. Standar melarang pemanggil menganggap ID dimulai dari nol atau bertambah berurutan. Alamat kontrak dan ID bersama-sama mengidentifikasi token pada suatu chain; jaringan juga penting saat membandingkan aset lintas chain. [1]

Dua kontrak bisa sama-sama memiliki token 42. Wallet tidak boleh menggabungkan catatan itu hanya karena nomornya sama. ID token dapat berupa hash atau mengikuti pola alokasi lain, sementara token tidak valid atau yang sudah dihancurkan tidak boleh dianggap sebagai inventaris aktif. Ini mengikuti aturan identitas standar, bukan kebiasaan penamaan koleksi.

Cakupan persetujuan berbeda

approve mengotorisasi alamat untuk satu token. setApprovalForAll mengotorisasi operator untuk NFT pemilik dalam kontrak tersebut, termasuk token yang diperoleh kemudian selama persetujuan aktif. Izin itu tidak berlaku untuk setiap koleksi di jaringan. getApproved dan isApprovedForAll menunjukkan cakupan izin yang berbeda. [1]

Transfer menghapus persetujuan individual token. Transfer tidak menghapus hubungan pemilik-ke-operator yang terpisah untuk token lain. Persetujuan marketplace adalah izin transfer, bukan bukti bahwa pemilik menandatangani pesanan penjualan tertentu. Aplikasi perlu membedakan otorisasi token dari logika pesanannya sendiri.

Hal yang diperiksa safe transfer

Panggilan transfer memerlukan pemanggil berizin, pemilik aktif yang benar, token valid, dan penerima bukan alamat nol. Ketika safe transfer mendeteksi kode penerima yang sudah diterapkan, fungsi memanggil onERC721Received dan mewajibkan nilai balik khusus yang ditentukan; penolakan membuat transaksi revert. transferFrom biasa tidak melakukan pemeriksaan penerimaan tersebut. [1]

Penerimaan adalah handshake protokol. Ini tidak mengesahkan kebijakan penarikan penerima, kepercayaannya, atau penanganan seluruh operasi berikutnya. Kode penerima dapat berjalan selama callback, sehingga label safe transfer tidak menggantikan tinjauan perilaku aplikasi. Sumber mengizinkan implementasi menolak transfer tambahan, misalnya ketika dijeda.

Penemuan antarmuka inti dan ekstensi opsional

Kontrak patuh menerapkan penemuan antarmuka ERC-165 bersama ERC-721. Identifier inti ERC-721 adalah 0x80ac58cd. Metadata dan enumerasi memiliki identifier terpisah, 0x5b5e139f dan 0x780e9d63. Jawaban dukungan antarmuka merupakan informasi penemuan, bukan audit independen. [1] [2]

name, symbol, dan tokenURI termasuk ekstensi metadata opsional. totalSupply, tokenByIndex, dan tokenOfOwnerByIndex termasuk enumerasi opsional. Karena itu aplikasi tidak dapat mewajibkan enumerasi on-chain dari setiap kontrak ERC-721 dasar. Hitungan saldo saja tidak mengungkap ID yang dimiliki alamat. [1]

Event, pencetakan, dan pengindeksan

Event Transfer, Approval, dan ApprovalForAll melaporkan perubahan kepemilikan dan izin. ERC-721 menjelaskan pengecualian saat constructor: token boleh dibuat dan dialokasikan selama pembuatan kontrak tanpa event Transfer individual. Metode pencetakan dan pembakaran sendiri berada di luar antarmuka dasar. Pengindeks perlu memperhitungkan implementasi kontrak dan antarmuka opsionalnya, bukan menganggap satu model berdasarkan event selalu memadai. [1]

Panduan OpenZeppelin menambahkan metode khusus awardItem dan penyimpanan URI per token. Metode itu mengilustrasikan desain aplikasi; ERC-721 tidak mewajibkan nama tersebut atau pencetakan tanpa pembatasan. [3]

Pembaruan metadata dan ketersediaan

Standar mengizinkan URI token berubah. URI dapat merujuk JSON off-chain yang kemudian merujuk gambar. Menyimpan URI on-chain tidak menempatkan semua sumber daya tersebut on-chain. Data IPFS beralamat konten tetap memerlukan salinan yang dipertahankan dan tersedia; CID saja tidak menjamin hosting selamanya. [1] [3] [4]

ERC-4906 secara terpisah menentukan MetadataUpdate dan BatchMetadataUpdate agar layanan dapat memperbarui JSON metadata yang berubah. Event tidak memuat metadata baru dan tidak menjamin pengindeks langsung memperbarui tampilannya. Ekstensi opsional ini tidak diwajibkan oleh ERC-721 dasar. [5]

Informasi royalti terpisah

ERC-2981 mengembalikan penerima dan jumlah royalti untuk harga penjualan yang diberikan. Sumber menjelaskan pembayaran sukarela dan memisahkan pencarian informasi dari pemindahan dana. Baik ERC-721 dasar maupun pencarian tersebut tidak memaksa setiap transfer membayar royalti; transfer belum tentu penjualan. [6]

Sentimen Media Sosial

Tidak berlaku untuk rujukan standar ini. Nilai pasar NFT terkini, popularitas koleksi, atau suasana komunitas tidak disimpulkan dari adopsi antarmuka.

Terakhir diperbarui: 2026-10

Istilah Terkait

Lihat Juga

Sumber

  1. Entriken, Shirley, Evans and Sachs — ERC-721: Non-Fungible Token Standard (2018). Spesifikasi Final menentukan identitas token, kepemilikan, pemeriksaan transfer, persetujuan, antarmuka opsional, event, dan hak CC0.
  2. ERC-165 — Standard Interface Detection. Standar ini menentukan identifier antarmuka dan prosedur penemuan supportsInterface.
  3. OpenZeppelin Contracts 5.x — ERC-721 guide. Contoh implementasi memisahkan pencetakan khusus dan penyimpanan URI dari antarmuka token inti.
  4. IPFS documentation — Persistence, permanence and pinning. Panduan menjelaskan mengapa pengalamatan konten tidak menjamin ketersediaan berkelanjutan.
  5. ERC-4906 — EIP-721 Metadata Update Extension. Ekstensi opsional ini menentukan event perubahan metadata dan batasannya.
  6. ERC-2981 — NFT Royalty Standard. Standar terpisah ini menyatakan penerima dan jumlah royalti; tidak memaksa pembayaran pada setiap transfer.