Công cụ AT-W40REV. 2026-A

Kiểm tra metadata NFT: sàn có hiển thị đúng NFT của anh chị không?

Các sàn giao dịch và ví đọc tên, ảnh và thuộc tính của một NFT từ một tệp JSON mà contract trỏ tới bằng tokenURI. Chỉ cần một dấu # trước mã màu, một số nằm trong dấu nháy hoặc địa chỉ gateway thay cho ipfs:// là có trường bị thiếu hoặc ảnh biến mất sau một thời gian. Công cụ kiểm tra đọc JSON hoặc data:-URI của anh chị, đối chiếu với ERC-721, ERC-1155, ERC-7572 và quy tắc của các sàn, rồi hiển thị bản xem trước.

  • miễn phí
  • không cần ví
  • kiểm tra ngay trong trình duyệt, không truy cập gì

Dán metadata, xem kết quả kiểm tra và bản xem trước

Công cụ kiểm tra · metadata NFT theo ERC-721, ERC-1155 và ERC-7572

Công cụ kiểm tra những gì anh chị dán vào, theo ERC-721, ERC-1155, ERC-7572 và các quy tắc đã được công bố của các sàn giao dịch. Công cụ không truy cập địa chỉ nào: ảnh và tệp sau các địa chỉ đó có thực sự truy cập được hay không thì công cụ không kiểm tra.

Bước 1Anh chị kiểm tra loại nào?
Bước 2Dán metadata

JSON trong tệp metadata của anh chị, giá trị tokenURI hoặc uri trả về dạng data:application/json;base64,…, hoặc một địa chỉ như ipfs://… (địa chỉ này chỉ được kiểm tra, không được truy cập).

Kết quả

chưa xác địnhHãy dán JSON metadata, một data:-URI hoặc một địa chỉ.

Quy tắc theo ERC-721, ERC-1155, ERC-7572, tài liệu của OpenSea và bản nháp ERC-8495, cập nhật ngày 14 tháng 11 năm 2026. Nguồn được nêu ở từng kết quả. Một bộ sưu tập hiển thị đúng ở mọi nơi là việc chúng tôi cùng làm với anh chị; xin viết cho chúng tôi qua biểu mẫu liên hệ.

Kiểm tra ngay trong trình duyệt của anh chị. Không có gì được gửi đi, lưu lại hay truy cập.

Sàn giao dịch lấy tên và ảnh như thế nào

Trong contract hầu như không bao giờ có chính cái ảnh. Contract ERC-721 trả về một địa chỉ cho mỗi token qua hàm tokenURI, contract ERC-1155 trả về qua uri. Sau địa chỉ đó là một tài liệu JSON nhỏ gồm tên, mô tả và địa chỉ của ảnh. Như vậy sàn phải lấy lần lượt hai tệp, và tệp nào cũng có thể bị thiếu, viết sai hoặc đã chuyển chỗ.

ERC-721 chỉ quy định ba trường: name, description và image. Mọi thứ khác mà các sàn hiển thị, từ video đến thuộc tính, theo một quy ước do OpenSea ghi lại năm 2018. Vì OpenSea là sàn có nhiều người dùng và doanh thu lớn nhất White và cộng sự 2022, nên các sàn khác làm theo. Từ tháng 11 năm 2026, quy ước này có dạng bản nháp ERC-8495; công cụ kiểm tra lấy cả hai làm chuẩn và nêu nguồn ở từng kết quả.

Metadata lỗi không phải chuyện thẩm mỹ. Nếu lưu sai liên kết giữa token và tệp, NFT bị tách khỏi thứ mà nó đại diện và trong trường hợp xấu nhất trở nên vô giá trị Mell và Yaga 2024.

TRUY XUẤTCONTRACTTOKENURIMETADATA JSONIMAGELINK ẢNHHIỂN THỊ TRÊNSÀN NFTNƠI LƯUDATA: TRONGCONTRACTIPFS:// KÈM CIDAR:// ARWEAVEHTTPS MÁY CHỦ WEBTRUY XUẤTCONTRACT TOKENURIMETADATA JSONIMAGE LINK ẢNHHIỂN THỊ TRÊN SÀN NFTNƠI LƯUDATA: TRONG CONTRACTIPFS:// KÈM CIDAR:// ARWEAVEHTTPS MÁY CHỦ WEB
HÌNH 1 · TỪ CONTRACT ĐẾN HIỂN THỊMÀU VÀNG = PHẦN CÔNG CỤ NÀY KIỂM TRA

Các trường của metadata token

Các trường trong tệp sau tokenURI hoặc uri
TrườngNguồn gốcNội dung bắt buộc
nameERC-721, ERC-1155Tên của token, văn bản thuần. Nếu thiếu, các sàn thường chỉ hiển thị “#123”.
descriptionERC-721, ERC-1155Mô tả. OpenSea đọc Markdown, HTML thô không được hiển thị.
imageERC-721, ERC-1155Ảnh cho danh sách và bản xem trước. ERC-721 khuyến nghị chiều rộng 320 đến 1080 px, OpenSea khuyến nghị tối thiểu 3000 × 3000 px.
animation_urlOpenSea, bản nháp ERC-8495Video, âm thanh, mô hình 3D hoặc trang HTML, hiển thị thay cho ảnh. Ảnh vẫn bắt buộc có để dự phòng.
external_urlOpenSea, bản nháp ERC-8495Link từ sàn đến trang web của anh chị, tốt nhất là https.
background_colorOpenSea, bản nháp ERC-8495Màu nền phía sau ảnh: sáu chữ số hex không có #, ví dụ E0F2FE.
attributesOpenSea, bản nháp ERC-8495Các thuộc tính dạng danh sách gồm trait_type, value, và tùy chọn display_type và max_value. Bộ lọc của bộ sưu tập được tạo từ đây.
decimalsERC-1155Số chữ số thập phân khi hiển thị số lượng, số nguyên từ 0.
propertiesERC-1155Thông tin bổ sung tùy ý dưới dạng object. Các sàn chỉ dùng thuộc tính trong attributes làm bộ lọc.
localizationERC-1155Bản dịch: uri có {locale}, default và locales là bắt buộc.
image_dataTrường cũ (OpenSea 2018)SVG thô thay cho image. Chỉ còn được đọc khi thiếu image; không nên dùng nữa.
youtube_urlTrường cũ (OpenSea 2018)Video YouTube thay cho animation_url. Không nên dùng nữa.

Không trường nào là bắt buộc, kể cả trong ERC-721. Nếu thiếu name hoặc image, sàn vẫn chỉ hiển thị một con số và một ảnh giữ chỗ. Quy tắc cập nhật ngày 14 tháng 11 năm 2026.

Ảnh cần được chăm chút đặc biệt. Các bộ sưu tập có hình thức đồng nhất, và bên cạnh lịch sử bán, đặc điểm của ảnh dự đoán giá tốt nhất Nadini và cộng sự 2021. ERC-721 khuyến nghị chiều rộng 320 đến 1080 pixel với tỷ lệ khung hình từ 4:5 đến 1,91:1, còn OpenSea khuyến nghị tối thiểu 3000 × 3000 pixel. Nếu ảnh nằm trong văn bản dạng data:-URI, công cụ kiểm tra đọc định dạng và kích thước trực tiếp từ các byte.

attributes: ghi thuộc tính sao cho bộ lọc đúng

Từ attributes tạo ra các bộ lọc của bộ sưu tập và, ở nhiều trang, độ hiếm của một NFT. Điều này có hệ quả: trong 410 bộ sưu tập với 3,7 triệu giao dịch, độ hiếm tính từ các thuộc tính liên quan rõ rệt đến giá và giao dịch Mekacher và cộng sự 2022. Thừa một dấu cách trong “Farbe ” biến một loại thuộc tính thành hai, và số liệu thống kê không còn đúng nữa.

Cách ghi, và cách sàn hiển thị gần đúng
Mục trong attributesHiển thịDạng
{"trait_type":"Farbe","value":"Gold"}Farbe: GoldVăn bản
{"trait_type":"Stufe","value":3,"max_value":5}Stufe: 3 trên 5Số
{"display_type":"number","trait_type":"Punkte","value":12}Punkte: 12Số
{"display_type":"boost_number","trait_type":"Ausdauer","value":40}Ausdauer: +40Điểm cộng
{"display_type":"boost_percentage","trait_type":"Rabatt","value":10}Rabatt: +10 %Điểm cộng theo %
{"display_type":"date","trait_type":"Gültig bis","value":1798761600}Gültig bis: 01.01.2027Ngày

display_type: number, boost_number, boost_percentage, date, string, text. Các giá trị khác được xử lý như thể thiếu trường này.

  • Số không để trong dấu nháy. "value": "5" là văn bản, "value": 5 là số. Với number, boost_number, boost_percentage và date phải là số; OpenSea đọc rõ ràng số trong dấu nháy là văn bản.
  • Ngày tính bằng giây. Unix time như block.timestamp, tức là 1798761600 cho ngày 1 tháng 1 năm 2027. Giá trị từ 1.000.000.000.000 trở lên hầu như luôn là mili giây: 1798761600000 nếu đọc là giây sẽ ra năm 58970.
  • max_value chỉ dùng cho số. Nếu không có max_value, OpenSea lấy giá trị cao nhất mà nó từng thấy trong bộ sưu tập. Nếu max_value nhỏ hơn value thì giá trị đó không hợp lệ.
  • Nhiều giá trị, một tên. Một cái mũ và một chiếc khăn: ghi hai lần trait_type “Zubehör”, mỗi lần một value. Giá trị dạng danh sách bị bỏ qua.
  • Cách viết phải giống hệt nhau. “Farbe” và “farbe” là hai bộ lọc khác nhau đối với sàn. Công cụ kiểm tra sẽ báo các cặp như vậy.

data:, ipfs://, ar:// hay https: nên để ảnh và JSON ở đâu

Một NFT bền lâu đến đâu thì phụ thuộc vào tệp mà nó trỏ tới. Trong một khảo sát tám sàn lớn, 80,69 phần trăm địa chỉ metadata không nằm trên IPFS; ở 2,89 phần trăm token, địa chỉ bị đổi trong vòng ba tháng, và nội dung bên ngoài IPFS biến mất thường xuyên hơn Das và cộng sự 2022. Với nghệ thuật giá cao thì cũng không khá hơn mấy: 19 trong 51 contract đã đổi địa chỉ metadata ít nhất một lần Balduf và cộng sự 2022.

Cách công cụ kiểm tra đánh giá địa chỉ
Cách viếtĐánh giáLý do
data:application/json;base64,…tốtNằm ngay trong contract, chỉ thay đổi cùng với contract. Khuyến nghị cho metadata nhỏ và ảnh SVG.
ipfs://<CID>/…tốtĐịa chỉ theo nội dung: CID là hàm băm (hash) của nội dung. Truy cập được chừng nào còn ít nhất một node giữ dữ liệu (pinning).
ar://<Transaktions-ID>tốtArweave, lưu trữ lâu dài đã trả phí trước. ID gồm 43 ký tự Base64URL.
ar://<Name>cần thận trọngTên ArNS: một con trỏ có thể chuyển hướng, tức là có thể thay đổi.
https://…cần thận trọngMáy chủ riêng hoặc cloud. Nội dung có thể thay đổi hoặc biến mất khi không còn ai trả phí.
https://<Gateway>/ipfs/<CID>cần thận trọngBuộc nội dung IPFS vào một đơn vị vận hành duy nhất. Nên ghi ipfs://<CID>.
ipns://…cần thận trọngTên có thể thay đổi trong IPFS. Chỉ dùng cho nội dung cần thay đổi.
web3://…, onchain:…cần thận trọngTruy xuất qua một lệnh gọi contract (ERC-4804, bản nháp ERC-8493). OpenSea đọc được, nhưng còn lâu mới phải ví nào cũng đọc được.
http://…saiKhông mã hóa; trình duyệt chặn những ảnh như vậy trên các trang https.
ipfs://ipfs/<CID>saiipfs bị lặp hai lần; một số client tự sửa, nhưng không nên trông cậy vào điều đó.
relativ, z. B. 1.pngsaiKhông có scheme thì không client nào biết tệp nằm ở đâu.

https: trường hợp phổ biến nhưng không bền

Địa chỉ web thì tiện, nhưng nó chỉ tồn tại chừng nào máy chủ và hợp đồng với nhà cung cấp hosting còn. Đây không phải vấn đề riêng của NFT: trong hơn một triệu liên kết web ở các bài báo chuyên ngành, cứ năm bài thì có một bài có ít nhất một liên kết dẫn vào chỗ trống hoặc đến nội dung đã bị đổi Klein và cộng sự 2014. Với những thứ cố ý thay đổi, chẳng hạn một token truy cập có thời hạn, https vẫn là lựa chọn đúng; các NFT động như vậy hiện đã thành một lĩnh vực nghiên cứu riêng Guidi và Michienzi 2023. Khi đó contract gửi sự kiện MetadataUpdate theo ERC-4906 mỗi lần thay đổi, nếu không sàn sẽ còn hiển thị bản cũ rất lâu.

ipfs://: địa chỉ theo nội dung, nhưng phải có pinning

Với IPFS, địa chỉ là hash của nội dung, tức CID Trautwein và cộng sự 2022. Đổi một điểm ảnh thì CID đổi; nên không ai có thể lặng lẽ thay nội dung sau một địa chỉ ipfs://. CIDv0 bắt đầu bằng Qm và dài 46 ký tự, CIDv1 thường bắt đầu bằng bafy. Công cụ kiểm tra giải mã cả hai và kiểm tra phiên bản, codec và độ dài hash, vì một CID bị cắt cụt thoạt nhìn vẫn trông bình thường.

Có điều: IPFS không tự lưu gì cả. Một tệp chỉ truy cập được chừng nào còn ít nhất một node giữ nó Daniel và Tschorsch 2022. Trong một phép đo trên hơn bốn triệu tệp IPFS, khoảng một nửa thuộc về NFT, nhiều tệp phải thử nhiều lần mới truy xuất được, và 50 nhà cung cấp cung cấp 95 phần trăm số tệp Shi và cộng sự 2024. Nhìn chung mạng này cũng tập trung và phụ thuộc cloud nhiều hơn tiếng đồn Balduf và cộng sự 2023. Và việc sàn hiển thị được ảnh chưa chứng minh được nhiều: thường sàn hiển thị bản sao riêng của mình Guidi và cộng sự 2025.

Cùng một tệp, hai cách viết
CIDv0QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR
CIDv1bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi

Từ đó có ba quy tắc. Hãy pin tại ít nhất hai nhà cung cấp độc lập hoặc trên node của riêng mình. Nếu tệp nằm trong một thư mục (ipfs://…/1.png), hãy pin cả thư mục, vì không có khối thư mục thì không ai tìm thấy tệp. Và hãy ghi ipfs://, đừng bao giờ ghi địa chỉ gateway.

Địa chỉ gateway: lỗi hay gặp nhất mà hoàn toàn tránh được

Nhiều contract ghi https://gateway.pinata.cloud/ipfs/… hoặc https://ipfs.io/ipfs/… thay vì ipfs://. Như vậy phần hiển thị phụ thuộc vào đúng một đơn vị vận hành, và khả năng truy cập cùng tính toàn vẹn giảm xuống mức của một máy chủ web thông thường Balduf và cộng sự 2022. Phản hồi của gateway thậm chí có thể bị tráo giữa đường mà không ai hay biết, miễn là không ai tính lại CID Stöger và cộng sự 2023. Bản nháp ERC-8495 nêu một mẫu khảo sát riêng: 113 trong số 204 địa chỉ token có dùng gateway không tải được. Và gateway thực sự biến mất; Cloudflare đã ngừng cloudflare-ipfs.com và cf-ipfs.com vào ngày 14.08.2024. Công cụ kiểm tra nhận diện gateway dạng đường dẫn và subdomain và đề xuất dạng ipfs://.

ar://: trả phí cho một thời gian dài

Arweave theo một hướng khác. Tải lên chỉ mất phí một lần, và mạng được kỳ vọng sẽ giữ dữ liệu lâu dài Daniel và Tschorsch 2022. Địa chỉ là ar:// kèm một ID giao dịch gồm 43 ký tự Base64URL, phân biệt chữ hoa chữ thường. Một tên ngắn hơn sau ar:// là tên ArNS: tiện, nhưng có thể chuyển hướng và vì vậy có thể thay đổi.

Metadata trong contract: data:-URI mà không vấp phải lỗi

Bền vững nhất là metadata do chính contract trả về. Các nhà nghiên cứu khảo sát những NFT nghệ thuật được giao dịch với giá đặc biệt cao khuyến nghị đúng cách này cho mọi thứ đủ nhỏ Balduf và cộng sự 2022. Khi đó tokenURI không trả về địa chỉ mà trả về một data:-URI chứa JSON, và ảnh dạng SVG thường nằm luôn trong đó. Chi phí gas cho việc này thì công cụ tính phí gas sẽ tính.

  • Base64 thay cho không mã hóa. data:application/json;base64,… là dạng được khuyến nghị. Nếu không mã hóa, trình duyệt dừng ở ký tự # đầu tiên, và một cái tên như “Pass #42” hoặc một màu như #fff trong SVG sẽ làm hỏng tài liệu.
  • ;utf8 không phải là tham số. data:application/json;utf8,… khá phổ biến và được đọc, nhưng RFC 2397 chỉ biết dạng attribute=value, tức là ;charset=utf-8. Với Base64 thì không phải đặt câu hỏi này.
  • SVG không có script. SVG có thể chứa mã thực thi Heiderich và cộng sự 2011. Vì vậy các sàn chỉ hiển thị nó như một ảnh: script không chạy, phông chữ và ảnh bên ngoài không được tải, và OpenSea lưu SVG vào cache dưới dạng PNG. Phần nào phụ thuộc vào những thứ đó sẽ không có trong phần hiển thị.
  • Loại media phải khớp. Trong image phải là image/svg+xml, image/png, v.v. Công cụ kiểm tra so sánh khai báo với các byte thực tế.

Với mọi JSON hợp lệ, công cụ kiểm tra tạo ra bản Base64 để sao chép, sau các sửa chữa an toàn như # trước mã màu, số nằm trong dấu nháy hoặc địa chỉ gateway.

ERC-1155: {id}, tên tệp và bản dịch

Một contract ERC-1155 thường trả về cùng một uri cho mọi token, ví dụ ipfs://bafy…/{id}.json. Client thay chỗ giữ chỗ {id} bằng ID của token, ở dạng thập lục phân, chữ thường, không có 0x và đệm cho đủ 64 ký tự. Điều này cũng áp dụng cho {id} trong các giá trị của JSON, ví dụ trong image.

Lỗi hay gặp nhất nằm ở tên tệp: các tệp tên là 1.json, 2.json, còn sàn thì tìm 000…001.json. Hãy nhập ID token vào công cụ kiểm tra để xem địa chỉ đầy đủ. Nhân tiện, với ERC-721 thì {id} không được thay.

ERC-1155 còn có thêm ba trường riêng: decimals cho token chia nhỏ được, properties cho thông tin bổ sung tùy ý và localization cho bản dịch. Với localization, uri, default và locales là bắt buộc, và uri chứa {locale}, client sẽ thay bằng mã ngôn ngữ.

{id} trở thành gì
ID tokenGiá trị thay thế, 64 ký tự
10000000000000000000000000000000000000000000000000000000000000001
42000000000000000000000000000000000000000000000000000000000000002a
25500000000000000000000000000000000000000000000000000000000000000ff
314592000000000000000000000000000000000000000000000000000000000004cce0

contractURI: metadata của cả bộ sưu tập

Tên, banner và mô tả của trang bộ sưu tập lấy từ một tệp riêng mà hàm contractURI trỏ tới. ERC-7572 mô tả tệp này; tiêu chuẩn vẫn là bản nháp, nhưng OpenSea vẫn đọc. Chỉ name là bắt buộc. Khi tệp thay đổi, contract gửi ContractURIUpdated().

Các trường trong tệp sau contractURI
TrườngNội dung bắt buộc
nameTên của bộ sưu tập. Trường bắt buộc duy nhất.
symbolKý hiệu viết tắt của bộ sưu tập.
descriptionMô tả bộ sưu tập.
imageẢnh đại diện của bộ sưu tập.
banner_imageẢnh banner ở đầu trang bộ sưu tập.
featured_imageẢnh cho các khu vực nổi bật.
external_linkWebsite của anh chị. Lưu ý: ở đây trường tên là external_link, còn ở token là external_url.
collaboratorsCác địa chỉ Ethereum được phép chỉnh sửa trang bộ sưu tập trên các sàn.

Công cụ kiểm tra xét các địa chỉ trong collaborators về định dạng và checksum theo EIP-55. Viết hoa viết thường sai gần như luôn là lỗi gõ. Từng địa chỉ riêng lẻ thì anh chị so từng ký tự bằng công cụ kiểm tra địa chỉ Ethereum.

Các nghiên cứu nói gì về metadata NFT

Các đánh giá trong công cụ kiểm tra dựa trên các phép đo trong hệ sinh thái NFT và mạng IPFS. Năm kết quả nền tảng cho những quyết định quan trọng nhất; danh sách đầy đủ kèm ghi chú kiểm tra nằm ở phía dưới.

  • Địa chỉ metadata thay đổi, và nội dung web biến mất. 2,89 phần trăm địa chỉ thay đổi trong ba tháng, nội dung bên ngoài IPFS bị mất thường xuyên hơn Das và cộng sự 2022. Vì vậy công cụ kiểm tra xếp https vào loại có thể thay đổi.
  • Địa chỉ gateway biến IPFS thành máy chủ web. Gateway ghi cứng làm khả năng truy cập giảm xuống mức của cloud Balduf và cộng sự 2022, và phản hồi của chúng có thể bị thay đổi giữa đường Stöger và cộng sự 2023. Công cụ kiểm tra báo mọi địa chỉ gateway kèm địa chỉ thay thế.
  • IPFS không tự giữ dữ liệu. Nhiều tệp NFT cần thử truy xuất nhiều lần Shi và cộng sự 2024, và các sàn thường hiển thị bản sao riêng Guidi và cộng sự 2025. Vì vậy ở mỗi địa chỉ ipfs:// đều có lưu ý về pinning.
  • Thuộc tính làm giá biến động. Độ hiếm từ attributes liên quan đến giá và lợi nhuận Mekacher và cộng sự 2022. Vì vậy công cụ kiểm tra báo cả một dấu cách ở mép.
  • Metadata lỗi làm token tách khỏi nội dung. Báo cáo của NIST về các điểm yếu của NFT mô tả như vậy Mell và Yaga 2024; vì thế image không hợp lệ là một lỗi, không phải chuyện nhỏ.

Cách đưa một bộ sưu tập ra mắt cho đúng

  1. Chọn nơi lưu trữ. Metadata nhỏ và SVG dạng data:-URI trong contract, ảnh và video lớn hơn trên IPFS hoặc Arweave. https chỉ dành cho nội dung cần thay đổi.
  2. Kiểm tra mỗi token một tệp. Dán tên, ảnh và thuộc tính vào đây cho đến khi không còn lỗi và cảnh báo nào. Với ERC-1155, nhập ID token và so tên tệp.
  3. Pin hai nơi. Tại hai nhà cung cấp độc lập hoặc trên node của riêng mình, pin cả thư mục.
  4. Viết tệp bộ sưu tập. contractURI với name, ảnh, banner và external_link, rồi đối chiếu lại ở đây.
  5. Xem thử trên mạng thử nghiệm. Mint một token và xem trên mạng thử nghiệm của một sàn và trong hai ví, trước khi lên mạng chính.
  6. Báo các thay đổi. Gửi MetadataUpdate (ERC-4906), URI (ERC-1155) hoặc ContractURIUpdated() khi có gì thay đổi.

Công cụ dừng lại ở đâu

  • Công cụ không truy cập gì. Ảnh ở ipfs:// còn được pin hay không, hay máy chủ có phản hồi hay không, công cụ không thấy. Để truy cập, công cụ nêu địa chỉ gateway dưới dạng văn bản.
  • Các sàn có khác nhau. Việc kiểm tra theo các tiêu chuẩn, tài liệu của OpenSea và bản nháp ERC-8495. Một số ví đọc ít hơn, một số sàn đọc các trường bổ sung riêng.
  • Không đánh giá giá trị hay tính xác thực. Tên và ảnh có thể sao chép tùy ý; hàng giả thậm chí thường dùng cùng địa chỉ ảnh với bản gốc Das và cộng sự 2022. Anh chị nhận ra một NFT qua địa chỉ contract và ID token.

Các công cụ khác cho dự án trên blockchain có trong phần tổng quan Công cụ Web3. Cách chúng tôi làm bộ sưu tập, token truy cập và các ứng dụng xung quanh được mô tả ở trang Phát triển Web3.

Dùng công cụ này từ một trợ lý AI

Các trợ lý như Claude hoặc ChatGPT có hỗ trợ Model Context Protocol (MCP) có thể gọi thẳng phép tính của trang này thay vì tự dựng lại. Máy chủ này công khai, không cần đăng nhập và không lưu lại gì. Câu trả lời luôn kèm đường link đến trang này, ngày cập nhật dữ liệu và giới hạn của kết quả.

Endpoint
https://aureum-tech.com/mcp
Công cụ
werkzeug_nft_metadaten_pruefer
Phương thức truyền
Streamable HTTP, chỉ đọc
Dữ liệu đầu vào
TênBắt buộcÝ nghĩa
metadatencóNội dung cần kiểm tra: JSON metadata dạng văn bản, giá trị tokenURI, uri hoặc contractURI trả về dạng data:-URI (loại media application/json, Base64 hoặc không mã hóa), hoặc chỉ một địa chỉ (ipfs://, ar://, https://) sẽ được kiểm tra nhưng không được truy cập.
standardkhôngKiểm tra theo tiêu chuẩn nào: erc721 = metadata token (tokenURI), erc1155 = metadata token có {id} (uri), erc7572 = metadata bộ sưu tập (contractURI), auto = nhận diện theo các trường (mặc định).
token_idkhôngChỉ ERC-1155: ID token dạng thập phân (314592) hoặc thập lục phân có 0x (0x4cce0), để thay {id} và hiển thị tên tệp dự kiến.

Những câu hỏi mà trợ lý nên gọi công cụ này

  • “Metadata NFT này có đúng không, và OpenSea có hiển thị đúng các thuộc tính không?”
  • “tokenURI của tôi trả về một data:-URI chứa JSON dạng Base64. Như vậy có hợp lệ không?”
  • “Tệp cho token ERC-1155 số 314592 phải đặt tên thế nào nếu URI chứa {id}.json?”
  • “Cho ảnh thì ipfs://Qm… hay địa chỉ gateway của Pinata là lựa chọn tốt hơn?”

Cách kết nối hoạt động ra sao và MCP làm được gì cho cơ sở của anh chị, anh chị xem ở trang Tích hợp MCP.

Câu hỏi thường gặp về metadata NFT

Tại sao OpenSea không hiển thị ảnh NFT của tôi?

Phần lớn là do địa chỉ trong image. Nguyên nhân thường gặp: thiếu trường này hoặc trường tên là image_url; địa chỉ là địa chỉ tương đối (chỉ “1.png”) hoặc không mã hóa (http); địa chỉ trỏ đến một gateway đã ngừng hoạt động như cloudflare-ipfs.com (từ 14.08.2024); hoặc data:-URI chưa mã hóa có ký tự #, trình duyệt cắt bỏ phần phía sau ký tự đó. Nếu chỉ ảnh bị đổi, thường là thiếu sự kiện MetadataUpdate theo ERC-4906; khi đó sàn vẫn hiển thị bản cũ trong bộ nhớ đệm (cache).

ipfs:// hay địa chỉ gateway: nên ghi gì vào metadata?

Nên ghi ipfs://<CID>, ví dụ ipfs://bafy…/1.png. Địa chỉ gateway như https://gateway.pinata.cloud/ipfs/… buộc tệp vào một đơn vị vận hành duy nhất; nếu đơn vị đó ngừng hoạt động thì ảnh không tải được nữa, dù dữ liệu vẫn còn trên mạng IPFS. Trong bản nháp ERC-8495, 113 trong số 204 địa chỉ token có dùng gateway đã được khảo sát không tải được. Link gateway do phần hiển thị tự tạo ra; công cụ kiểm tra đề xuất dạng ipfs:// cho mọi địa chỉ gateway.

Cách ghi đúng số và ngày tháng trong attributes?

Số không để trong dấu nháy: "value": 5, không phải "value": "5". Nếu để trong dấu nháy thì số bị coi là văn bản và bộ lọc sẽ không sắp xếp theo số đó. Với display_type là number, boost_number, boost_percentage và date, value phải là số. Ngày tháng ghi dạng Unix time tính bằng giây; giá trị từ 1.000.000.000.000 trở lên trông giống mili giây. max_value là tùy chọn và phải lớn hơn hoặc bằng value.

{id} dùng để làm gì trong ERC-1155?

Nếu {id} nằm trong uri hoặc trong một giá trị của metadata, client sẽ thay nó bằng ID của token: dạng thập lục phân, chữ thường, không có 0x và đệm số 0 cho đủ 64 ký tự. Token 314592 trở thành 000000000000000000000000000000000000000000000000000000000004cce0. Vì vậy tệp phải được đặt tên là 000000000000000000000000000000000000000000000000000000000004cce0.json; client tuân theo tiêu chuẩn sẽ không tìm thấy “314592.json”.

Nên ghi gì vào contractURI của một bộ sưu tập?

Theo ERC-7572 là một JSON với name là trường bắt buộc duy nhất, kèm symbol, description, image, banner_image, featured_image, external_link và collaborators. Lưu ý về website: ở bộ sưu tập trường này tên là external_link, ở từng token là external_url. collaborators là các địa chỉ Ethereum được phép chỉnh sửa trang bộ sưu tập trên các sàn. ERC-7572 vẫn còn là bản nháp, nhưng OpenSea có đọc.

Base64 hay ;utf8: dạng data:-URI nào đúng?

Cả hai đều được đọc, nhưng nên dùng Base64. Trong data:-URI chưa mã hóa, trình duyệt cắt bỏ mọi thứ từ ký tự # trở đi, và một cái tên như “Pass #42” sẽ làm hỏng JSON. Ngoài ra ;utf8 theo RFC 2397 không phải là tham số hợp lệ, đúng phải là ;charset=utf-8. Từ mọi JSON hợp lệ, công cụ kiểm tra tạo ra bản Base64 để anh chị sao chép.

background_color có phải viết kèm # không?

Không, viết không có #. Yêu cầu đúng sáu chữ số hex, ví dụ "E0F2FE". Nếu có #, một số client tự bỏ ký tự này, số khác bỏ qua luôn màu. Dạng viết tắt như "fff", tên màu hoặc rgb() không được đọc.

Công cụ kiểm tra metadata NFT dừng lại ở đâu?

Công cụ kiểm tra đoạn văn bản anh chị dán vào, theo ERC-721, ERC-1155, ERC-7572 và các quy tắc đã được công bố của các sàn giao dịch. Công cụ không truy cập địa chỉ nào, nên không biết ảnh ở ipfs:// còn được pin hay không, hoặc máy chủ có phản hồi hay không. Công cụ cũng không nói gì về giá trị, tính xác thực hay quyền đối với nội dung. Contract, metadata và nơi lưu trữ khớp với nhau thế nào, và ai pin lâu dài, chúng tôi sẵn lòng cùng anh chị làm rõ.

Công cụ này dựa trên những gì

Các giá trị tham khảo và lưu ý ở trên dựa vào 15 công trình khoa học sau đây. Mỗi công trình đều đã được kiểm tra qua mã DOI hoặc trang của nhà xuất bản (lần gần nhất: ngày 14 tháng 11 năm 2026): công trình có thật, không bị rút lại, và kết luận của nó đến nay vẫn còn giá trị cho câu hỏi này.

  1. Das, D.; Bose, P.; Ruaro, N. và cộng sự (2022): Understanding Security Issues in the NFT Ecosystem. Proceedings of the 2022 ACM SIGSAC Conference on Computer and Communications Security (CCS ’22), tr. 667–681

    Kết quả Khảo sát tám sàn NFT lớn và hàng triệu token đã giao dịch: 80,69 phần trăm địa chỉ metadata không nằm trên IPFS, ở 2,89 phần trăm địa chỉ bị đổi trong vòng ba tháng, và nội dung bên ngoài IPFS biến mất thường xuyên hơn. Hàng giả thường dùng cùng địa chỉ ảnh với bản gốc.

    Trong công cụ Công cụ xếp địa chỉ https vào loại có thể thay đổi và nhắc rằng một NFT được nhận ra qua contract và ID token, không phải qua tên và ảnh.

  2. Balduf, L.; Florian, M.; Scheuermann, B. (2022): Dude, where's my NFT: distributed infrastructures for digital art. Proceedings of the 3rd International Workshop on Distributed Infrastructure for the Common Good (DICG ’22), tr. 1–6

    Kết quả Trong 51 contract của NFT nghệ thuật giá cao, 19 contract đã đổi địa chỉ metadata ít nhất một lần. Nhiều contract ghi cứng địa chỉ gateway thay cho ipfs://, và một nửa nội dung IPFS chỉ có dưới mười nhà cung cấp trong vòng một tuần. Các tác giả khuyến nghị lưu trong contract (data:) hoặc theo nội dung kèm hash.

    Trong công cụ Công cụ báo địa chỉ gateway là cảnh báo kèm địa chỉ thay thế ipfs://; data:-URI được coi là lựa chọn tốt nhất; với CID thư mục, công cụ nhắc rằng thư mục và tệp đều phải truy cập được.

  3. Stöger, F.; Zhou, A.; Duan, H.; Perrig, A. (2023): Demystifying Web3 Centralization: The Case of Off-Chain NFT Hijacking. Financial Cryptography and Data Security (FC 2023), Lecture Notes in Computer Science, tr. 182–199

    Kết quả Hầu như mọi chỗ mà NFT chạy qua dịch vụ tập trung đều có thể bị vô hiệu hóa. Trong thử nghiệm, phản hồi của gateway IPFS và các điểm truy cập blockchain có thể bị tráo giữa đường.

    Trong công cụ Giải thích vì sao công cụ yêu cầu ipfs:// thay vì địa chỉ gateway: chỉ CID mới đối chiếu được với nội dung, bất kể nội dung đến bằng đường nào.

  4. Guidi, B.; Michienzi, A.; Pasquale, L. (2025): On the impact of marketplaces on the availability of NFT assets on the IPFS network. 2025 IEEE Symposium on Computers and Communications (ISCC), tr. 1–6

    Kết quả Theo dõi hai tuần các tệp NFT của mười bộ sưu tập trên mạng IPFS: IPFS không đảm bảo khả năng truy cập cao, và các sàn thường hiển thị bản sao riêng thay vì tệp trong contract.

    Trong công cụ Vì vậy có lưu ý trong kết quả: việc sàn hiển thị ảnh không chứng minh được rằng tệp còn truy cập được trên mạng.

  5. Shi, R.; Cheng, R.; Han, B. và cộng sự (2024): A Closer Look into IPFS: Accessibility, Content, and Performance. Proceedings of the ACM on Measurement and Analysis of Computing Systems 8 (2), tr. 1–31

    Kết quả Phép đo trên hơn bốn triệu tệp trong IPFS: khoảng một nửa thuộc về NFT, nhiều tệp phải thử nhiều lần mới truy xuất được. 50 nhà cung cấp lớn nhất, chủ yếu là node cloud, cung cấp 95 phần trăm số tệp.

    Trong công cụ Là cơ sở của lưu ý về pinning: ipfs:// chỉ sẵn sàng chừng nào còn các node giữ dữ liệu.

  6. Balduf, L.; Korczyński, M.; Ascigil, O. và cộng sự (2023): The Cloud Strikes Back: Investigating the Decentralization of IPFS. Proceedings of the 2023 ACM Internet Measurement Conference (IMC ’23), tr. 391–405

    Kết quả Phép đo lớn về cấu trúc mạng, lưu lượng và nhà cung cấp trong mạng IPFS: mức tập trung hóa rõ rệt và tỷ lệ node trên cloud cao.

    Trong công cụ Vì vậy công cụ khuyên pin dữ liệu NFT tại ít nhất hai nhà cung cấp độc lập thay vì chỉ một.

  7. Trautwein, D.; Raman, A.; Tyson, G. và cộng sự (2022): Design and evaluation of IPFS: a storage layer for the decentralized web. Proceedings of the ACM SIGCOMM 2022 Conference, tr. 739–752

    Kết quả Mô tả cấu trúc và phép đo IPFS: lưu trữ theo nội dung qua mạng ngang hàng (peer-to-peer) với các node ở hơn 2700 mạng và 152 quốc gia; việc xuất bản và truy xuất đủ nhanh cho nhiều ứng dụng.

    Trong công cụ Cơ sở của phần giải thích về CID: địa chỉ là hash của nội dung, nên công cụ kiểm tra kỹ cấu trúc của nó.

  8. Daniel, E.; Tschorsch, F. (2022): IPFS and Friends: A Qualitative Comparison of Next Generation Peer-to-Peer Data Networks. IEEE Communications Surveys & Tutorials 24 (1), tr. 31–52

    Kết quả So sánh IPFS, Swarm, Hypercore, SAFE, Storj và Arweave. IPFS chỉ giữ dữ liệu chừng nào các node còn giữ tự nguyện hoặc có trả phí (ví dụ qua Filecoin); Arweave muốn lưu dữ liệu lâu dài và thu phí khi tải lên.

    Trong công cụ Giải thích sự khác nhau giữa ipfs:// và ar:// trong phần lưu ý về nơi lưu trữ.

  9. Mell, P.; Yaga, D. (2024): Non-fungible token security. National Institute of Standards and Technology, NIST IR 8472

    Kết quả Giải thích công nghệ NFT và nêu 27 điểm yếu có thể có. Metadata lưu sai có thể tách NFT khỏi đối tượng của nó và làm nó vô giá trị; ai kiểm soát một bảng ánh xạ bên ngoài thì có thể gán lại token.

    Trong công cụ Giải thích vì sao công cụ báo địa chỉ ảnh và metadata bị thiếu hoặc không hợp lệ là lỗi, và chỉ ra các nơi lưu trữ có thể thay đổi.

  10. Mekacher, A.; Bracci, A.; Nadini, M. và cộng sự (2022): Heterogeneous rarity patterns drive price dynamics in NFT collections. Scientific Reports 12, Art. 13890

    Kết quả 3,7 triệu giao dịch trong 410 bộ sưu tập: độ hiếm tính từ các thuộc tính đọc được của một NFT liên quan rõ rệt đến giá, tần suất giao dịch và lợi nhuận.

    Trong công cụ Thuộc tính không phải chuyện phụ. Vì vậy công cụ báo số nằm trong dấu nháy, dấu cách ở mép và các cách viết khác nhau của cùng một loại thuộc tính, vì chúng làm sai bộ lọc và độ hiếm.

  11. Nadini, M.; Alessandretti, L.; Di Giacinto, F. và cộng sự (2021): Mapping the NFT revolution: market trends, trade networks, and visual features. Scientific Reports 11, Art. 20902

    Kết quả Phân tích 6,1 triệu lượt bán của 4,7 triệu NFT (2017 đến 2021): các bộ sưu tập có hình thức đồng nhất, và bên cạnh lịch sử bán, đặc điểm của ảnh dự đoán giá tốt nhất.

    Trong công cụ Ảnh là thứ người mua nhìn thấy. Vì vậy công cụ báo image bị thiếu hoặc không tải được là cảnh báo, không phải chuyện nhỏ.

  12. White, B.; Mahanti, A.; Passi, K. (2022): Characterizing the OpenSea NFT Marketplace. Companion Proceedings of the Web Conference 2022 (WWW ’22), tr. 488–496

    Kết quả 5,25 triệu lượt bán trên OpenSea từ 2019 đến 2021, sàn có nhiều người dùng và doanh thu lớn nhất; một số ít người dùng rất tích cực thúc đẩy tăng trưởng.

    Trong công cụ Vì vậy bên cạnh các tiêu chuẩn ERC, công cụ kiểm tra các trường do OpenSea ghi lại: đó là các quy tắc mà các sàn khác làm theo.

  13. Klein, M.; Van de Sompel, H.; Sanderson, R. và cộng sự (2014): Scholarly Context Not Found: One in Five Articles Suffers from Reference Rot. PLoS ONE 9 (12), e115253

    Kết quả Hơn một triệu liên kết web từ 3,5 triệu bài báo chuyên ngành: cứ năm bài thì có một bài bị ảnh hưởng bởi liên kết hỏng hoặc nội dung bị thay đổi, và trong các bài có liên kết web thì là bảy trên mười bài.

    Trong công cụ Là căn cứ cho lưu ý ở địa chỉ https: địa chỉ web biến mất hoặc đổi nội dung theo thời gian, ngay cả khi không có ác ý.

  14. Heiderich, M.; Frosch, T.; Jensen, M.; Holz, T. (2011): Crouching tiger - hidden payload: security risks of scalable vectors graphics. Proceedings of the 18th ACM Conference on Computer and Communications Security (CCS ’11), tr. 239–250

    Kết quả Tệp SVG không chỉ là ảnh mà có thể chứa HTML, JavaScript và các phần thực thi khác; trình duyệt thường xử lý sai các SVG được cài cắm.

    Trong công cụ Vì vậy các sàn chỉ hiển thị SVG như ảnh không có script, và công cụ cảnh báo khi SVG chứa script, thuộc tính sự kiện hoặc liên kết ngoài mà ở đó không có tác dụng.

  15. Guidi, B.; Michienzi, A. (2023): From NFT 1.0 to NFT 2.0: A Review of the Evolution of Non-Fungible Tokens. Future Internet 15 (6), Art. 189

    Kết quả Tổng quan về bước chuyển từ NFT tĩnh, có metadata cố định sau khi mint, sang NFT động có thể thay đổi; khó khăn kỹ thuật chủ yếu nằm ở metadata và việc thay đổi nó.

    Trong công cụ Với metadata có thể thay đổi, công cụ nêu sự kiện của ERC-4906 hoặc URI của ERC-1155 để các sàn cập nhật thay đổi.

Tiêu chuẩn, cơ quan nhà nước và thông tin của nhà sản xuất

Thứ Hai–thứ Sáu, 8–17 giờ

Anh chị sắp ra mắt một bộ sưu tập hoặc token truy cập? Hãy gửi cho chúng tôi kết quả đã sao chép. Chúng tôi sẽ ghép contract, metadata và nơi lưu trữ lại sao cho các sàn và ví hiển thị mọi thứ đúng, và thiết lập pinning, từ Rodewisch.

+49 3744 4399760[email protected]

Thứ Hai–thứ Sáu, 8–17 giờ · Straße der Jugend 5, 08228 Rodewisch

Trao đổi về dự án NFT
+49 3744 4399760Thứ Hai–thứ Sáu, 8–17 giờ
Gọi điệnGọi lại cho tôi

BẢNG KÊ THÀNH PHẦN · TRANG 1/1

Trang này gồm những gì

Số liệu được đo lúc dựng trang. Nếu có JavaScript, trình duyệt của anh chị sẽ đo lại trực tiếp.

STTTHÀNH PHẦNLOẠIDUNG LƯỢNG
01index.htmlTài liệu≈ 29 kB
02styles.cssStylesheet≈ 20 kB
03scripts.jsScript≈ 13 kB
04archivo-variable.woff2Phông chữ≈ 58 kB
05ibm-plex-mono.woff2Phông chữ≈ 30 kB
06favicon.svgĐồ họa< 1 kB

Cookie quảng cáo hoặc cookie phân tích: không có. Khi chưa được anh chị đồng ý, trang này không tải gì từ máy chủ bên ngoài, ngoại trừ Cloudflare, dịch vụ phân phối nội dung mà chúng tôi dùng. Phông chữ, script và hình ảnh đều nằm trên máy chủ của chúng tôi. Hệ thống IT của anh chị, chúng tôi cũng xây dựng theo cách đó.

NGOÀI GIỜ LÀM VIỆC

Anh chị vẫn cứ gọi, không sao cả

Theo lịch bình thường, chúng tôi có mặt ở văn phòng từ thứ Hai đến thứ Sáu, 8–17 giờ.

Buổi tối và cuối tuần, số này vẫn được chuyển tiếp đến chúng tôi và thường có người nghe máy. Nhưng điều đó chúng tôi không dám hứa chắc.

Nếu không ai nghe máy, anh chị để lại lời nhắn ngắn trong hộp thư thoại: tên, số điện thoại và việc cần hỗ trợ. Chúng tôi sẽ gọi lại sớm nhất có thể, chậm nhất là ngày làm việc tiếp theo.

Cuộc gọi không mất tiền. Nếu ngoài giờ làm việc mà cần có người xử lý ngay thì áp dụng phụ phí ghi trong bảng giá.

Gọi ngay+49 3744 4399760

Anh chị muốn viết hơn? Anh chị dùng biểu mẫu liên hệ hoặc gửi email đến [email protected]. Chúng tôi sẽ đọc vào ngày làm việc tiếp theo.

CHẨN ĐOÁN · AT-K2

Anh chị đang gặp chuyện gì?

↵ CHỌNESC ĐÓNGGỌI ĐIỆN: +49 3744 4399760

Cài đặt riêng

Những dịch vụ nào được phép tải?

Cần thiết về mặt kỹ thuật

Lựa chọn của anh chị tại đây, cùng với cài đặt về giao diện màu và chuyển động. Những thông tin này được lưu thành các mục nhỏ trên thiết bị của anh chị và không bao giờ được gửi đến máy chủ nào. Trang web cần chúng để hoạt động nên không thể bỏ chọn.