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ì
01 / KIỂM TRA
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.
Kết quả
Bản xem trước, gần giống như trên một sàn giao dịch
Kết quả
Địa chỉ và nơi lưu trữ
| Trường | Đánh giá | Địa chỉ |
|---|
Công cụ không truy cập gì cả. Ai muốn tự xem tệp thì mở địa chỉ gateway đã nêu trong trình duyệt.
Bản đã sửa
Xem JSON
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.
02 / QUY TRÌNH
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.
Các trường của metadata token
| Trường | Nguồn gốc | Nội dung bắt buộc |
|---|---|---|
| name | ERC-721, ERC-1155 | Tê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”. |
| description | ERC-721, ERC-1155 | Mô tả. OpenSea đọc Markdown, HTML thô không được hiển thị. |
| image | ERC-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_url | OpenSea, bản nháp ERC-8495 | Video, â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_url | OpenSea, bản nháp ERC-8495 | Link từ sàn đến trang web của anh chị, tốt nhất là https. |
| background_color | OpenSea, bản nháp ERC-8495 | Màu nền phía sau ảnh: sáu chữ số hex không có #, ví dụ E0F2FE. |
| attributes | OpenSea, bản nháp ERC-8495 | Cá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. |
| decimals | ERC-1155 | Số chữ số thập phân khi hiển thị số lượng, số nguyên từ 0. |
| properties | ERC-1155 | Thô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. |
| localization | ERC-1155 | Bản dịch: uri có {locale}, default và locales là bắt buộc. |
| image_data | Trườ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_url | Trườ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.
03 / THUỘC TÍNH
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.
| Mục trong attributes | Hiển thị | Dạng |
|---|---|---|
| {"trait_type":"Farbe","value":"Gold"} | Farbe: Gold | Văn bản |
| {"trait_type":"Stufe","value":3,"max_value":5} | Stufe: 3 trên 5 | Số |
| {"display_type":"number","trait_type":"Punkte","value":12} | Punkte: 12 | Số |
| {"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.2027 | Ngà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.
04 / NƠI LƯU TRỮ
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 viết | Đánh giá | Lý do |
|---|---|---|
data:application/json;base64,… | tốt | Nằ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ốt | Arweave, 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ọng | Tê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ọng | Má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ọng | Buộ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ọng | Tê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ọng | Truy 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://… | sai | Khô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> | sai | ipfs 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.png | sai | Khô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.
| CIDv0 | QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR |
|---|---|
| CIDv1 | bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi |
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.
05 / ONCHAIN
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.
06 / ERC-1155
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 token | Giá trị thay thế, 64 ký tự |
|---|---|
| 1 | 0000000000000000000000000000000000000000000000000000000000000001 |
| 42 | 000000000000000000000000000000000000000000000000000000000000002a |
| 255 | 00000000000000000000000000000000000000000000000000000000000000ff |
| 314592 | 000000000000000000000000000000000000000000000000000000000004cce0 |
07 / BỘ SƯU TẬP
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().
| Trường | Nội dung bắt buộc |
|---|---|
| name | Tên của bộ sưu tập. Trường bắt buộc duy nhất. |
| symbol | Ký hiệu viết tắt của bộ sưu tập. |
| description | Mô 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_link | Website của anh chị. Lưu ý: ở đây trường tên là external_link, còn ở token là external_url. |
| collaborators | Cá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.
08 / NGHIÊN CỨU
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ỏ.
09 / CÁCH LÀM
Cách đưa một bộ sưu tập ra mắt cho đúng
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
10 / DÀNH CHO TRỢ LÝ AI
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
| Tên | Bắt buộc | Ý nghĩa |
|---|---|---|
metadaten | có | 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. |
standard | không | Kiể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_id | không | Chỉ 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.
11 / CÂU HỎI THƯỜNG GẶP
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õ.
12 / NGHIÊN CỨU VÀ NGUỒN
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.
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.
doi.org/10.1145/3548606.3559342 · Báo cáo hội nghị
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.
doi.org/10.1145/3565383.3566106 · Báo cáo hội nghị
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.
doi.org/10.1007/978-3-031-47751-5_11 · Báo cáo hội nghị
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.
doi.org/10.1109/iscc65549.2025.11326542 · Báo cáo hội nghị
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.
doi.org/10.1145/3656015 · Tạp chí chuyên ngành
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.
doi.org/10.1145/3618257.3624797 · Báo cáo hội nghị
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ó.
doi.org/10.1145/3544216.3544232 · Báo cáo hội nghị
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ữ.
doi.org/10.1109/COMST.2022.3143147 · Bài tổng quan
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.
doi.org/10.6028/NIST.IR.8472 · Báo cáo nghiên cứu
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.
doi.org/10.1038/s41598-022-17922-5 · Tạp chí chuyên ngành
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ỏ.
doi.org/10.1038/s41598-021-00053-8 · Tạp chí chuyên ngành
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.
doi.org/10.1145/3487553.3524629 · Báo cáo hội nghị
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 ý.
doi.org/10.1371/journal.pone.0115253 · Tạp chí chuyên ngành
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.
doi.org/10.1145/2046707.2046735 · Báo cáo hội nghị
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.
doi.org/10.3390/fi15060189 · Bài tổng quan
Tiêu chuẩn, cơ quan nhà nước và thông tin của nhà sản xuất
- ERC-721: Non-Fungible Token Standard (Final) · Final, đã kiểm tra ngày 14.11.2026
- ERC-1155: Multi Token Standard, mục Metadata (Final) · Final, đã kiểm tra ngày 14.11.2026
- ERC-7572: Contract-level metadata via contractURI() (bản nháp) · Draft, đã kiểm tra ngày 14.11.2026
- ERC-4906: EIP-721 Metadata Update Extension (Final) · Final, đã kiểm tra ngày 14.11.2026
- ERC-8495: Token Metadata JSON Schema (bản nháp, Pull Request 2163) · Bản nháp, mở ngày 10.11.2026, phiên bản ngày 12.11.2026, chưa được thông qua; các quy tắc từ đó chỉ ở mức cảnh báo
- OpenSea Developer Docs: Media and traits, Metadata storage, Contract-level metadata · cập nhật ngày 12.11.2026
- RFC 2397: The "data" URL scheme · 1998
- RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format · 2017
- multiformats/cid: Content Identifier, kèm bảng Multibase và Multicodec · đã kiểm tra ngày 14.11.2026
- IPFS Docs: Best Practices for Storing NFT Data using IPFS · đã kiểm tra ngày 14.11.2026
- Arweave HTTP API: trường id (Base64URL, SHA-256 của chữ ký) · đã kiểm tra ngày 14.11.2026
- Cloudflare-Blog: Cloudflare's public IPFS gateways and supporting Interplanetary Shipyard · 14.05.2024
- EIP-55: Mixed-case checksum address encoding · Final
13 / CÔNG CỤ KHÁC
Anh chị còn thắc mắc điều gì?
- AT-W32 · Doanh nghiệp
Kiểm tra mức phù hợp với blockchain
Dự án của anh chị có thật sự cần blockchain không, hay một cơ sở dữ liệu là đủ? - AT-W33 · Doanh nghiệp
Kiểm tra MiCA
Token của anh chị có thuộc phạm vi MiCA không, và kéo theo những nghĩa vụ nào? - AT-W34 · Cá nhân và doanh nghiệp
Tính phí gas
Một giao dịch trên Ethereum, Arbitrum, Optimism, Base hoặc Polygon tốn bao nhiêu? - AT-W35 · Cá nhân và doanh nghiệp
Kiểm tra địa chỉ Ethereum
Địa chỉ Ethereum này có hợp lệ và viết đúng không? Kiểm tra checksum theo EIP-55 và so sánh hai địa chỉ. - AT-W36 · Doanh nghiệp
Tính selector và topic
Function selector hoặc event topic nào ứng với chữ ký Solidity này, và ngược lại? - AT-W37 · Doanh nghiệp
Giải mã calldata
Giao dịch này làm gì? Chuyển calldata thành dạng đọc được trước khi anh chị ký.
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