Base URI

Base URI trong crypto là gì?

Base URI là đường dẫn bắt đầu dùng chung mà hợp đồng thông minh sử dụng để tạo liên kết metadata đầy đủ cho các token trong một bộ sưu tập crypto.

Trong các hệ thống metadata của NFT và token, URI cho ví, trình khám phá blockchain và ứng dụng biết nơi tìm tệp JSON mô tả token.

Tiêu chuẩn ERC-721 chính thức định nghĩa tokenURI là một hàm trả về Mã định danh tài nguyên thống nhất (Uniform Resource Identifier) riêng cho một tài sản nhất định.

Base URI thường được kết hợp với token ID để tạo tokenURI đầy đủ.

Ví dụ: Base URI có thể là ipfs://exampleCID/ và token ID 25 có thể trỏ đến ipfs://exampleCID/25.

Trong một thiết kế khác, đường dẫn metadata đầy đủ có thể bao gồm phần mở rộng tệp, chẳng hạn như ipfs://exampleCID/25.json.

Kết quả chính xác phụ thuộc vào cách hợp đồng thông minh tạo tokenURI.

Tài liệu ERC-721 của OpenZeppelin giải thích rằng hàm _baseURI được dùng để tính ERC721.tokenURI và URI kết quả có thể là chuỗi ghép giữa baseURI và tokenId.

Base URI là công cụ thiết thực giúp tiết kiệm gas, sắp xếp metadata và quản lý các bộ sưu tập NFT lớn dễ dàng hơn.

Với người dùng crypto, Base URI rất quan trọng vì nó ảnh hưởng đến nơi tải hình ảnh, đặc điểm, mô tả và metadata khác của NFT.

Vì sao Base URI quan trọng?

Base URI quan trọng vì quyền sở hữu token và metadata của token không phải lúc nào cũng được lưu trữ cùng một nơi.

Blockchain có thể lưu chủ sở hữu token, token ID, lịch sử chuyển token, quyền phê duyệt và logic hợp đồng.

Hình ảnh, tên, mô tả, thuộc tính, hoạt ảnh và nội dung đa phương tiện bên ngoài thường được lưu trữ ngoài blockchain.

Base URI kết nối token on-chain với vị trí metadata off-chain hoặc phi tập trung.

Nếu Base URI chính xác, ví và ứng dụng có thể hiển thị token đúng cách.

Nếu Base URI sai, bị hỏng, tập trung hóa hoặc bị thay đổi với mục đích xấu, token có thể hiển thị hình ảnh bị thiếu, đặc điểm sai hoặc thông tin gây hiểu nhầm.

Điều này đặc biệt quan trọng với NFT vì phần lớn giá trị mà người dùng nhìn thấy có thể phụ thuộc vào metadata.

Một vật phẩm sưu tầm có đặc điểm hiếm chỉ có thể trông có giá trị nếu metadata vẫn truy cập được và đáng tin cậy.

Vật phẩm trong game có thể cần metadata để hiển thị cấp độ, lớp, thiết kế hình ảnh hoặc công dụng.

NFT thành viên có thể cần metadata để hiển thị cấp bậc hoặc quyền truy cập.

Do đó, Base URI ảnh hưởng đến trải nghiệm người dùng, tính toàn vẹn của metadata, mức độ tin cậy vào bộ sưu tập và khả năng đọc dữ liệu tài sản về lâu dài.

Base URI hoạt động như thế nào?

Base URI thường hoạt động bằng cách lưu trữ hoặc trả về một tiền tố dùng chung bên trong hợp đồng token.

Sau đó, hợp đồng nối thêm một giá trị riêng cho từng token, thường là token ID, để tạo URI metadata đầy đủ.

Ví dụ: nếu Base URI là ipfs://bafyExampleCollection/ và token ID là 100, tokenURI cuối cùng có thể là ipfs://bafyExampleCollection/100.

Nếu hợp đồng thêm hậu tố JSON, tokenURI cuối cùng có thể là ipfs://bafyExampleCollection/100.json.

Một số hợp đồng lưu Base URI dưới dạng biến trạng thái mà địa chỉ được ủy quyền có thể cập nhật.

Một số hợp đồng cố định Base URI vĩnh viễn ngay khi triển khai.

Một số hợp đồng trả về Base URI khác nhau tùy theo trạng thái reveal, loại token, chain ID hoặc logic tùy chỉnh.

Một số hợp đồng không dùng Base URI mà lưu URI đầy đủ riêng cho từng token.

Base URI không phải yêu cầu bắt buộc trong mọi hợp đồng NFT.

Đây là một mô hình triển khai phổ biến để tạo đường dẫn metadata token hiệu quả.

Base URI và tokenURI

tokenURI là URI đầy đủ được trả về cho một token cụ thể.

Base URI là tiền tố có thể tái sử dụng để tạo nhiều tokenURI.

Trong hợp đồng ERC-721, tokenURI thuộc phần mở rộng metadata tùy chọn.

Tiêu chuẩn ERC-721 nêu rằng tokenURI có thể trỏ đến tệp JSON tuân theo Lược đồ JSON Metadata ERC-721.

Tệp JSON này thường bao gồm các trường như name, description và image.

Base URI không phải là bản thân metadata JSON.

Đó là đường dẫn giúp ví hoặc ứng dụng tìm thấy metadata JSON.

Một hợp đồng đơn giản có thể trả về tokenURI bằng cách ghép Base URI với token ID.

Hợp đồng phức tạp hơn có thể trả về URI được tùy chỉnh hoàn toàn cho từng token.

Hợp đồng NFT động có thể tạo tokenURI từ trạng thái on-chain thay vì dùng Base URI cố định.

Người dùng nên tập trung vào giá trị tokenURI trả về vì đó là vị trí metadata mà ứng dụng thực sự sử dụng.

Base URI trong NFT ERC-721

ERC-721 là tiêu chuẩn token phổ biến nhất gắn với NFT độc nhất và token ID riêng biệt.

Mỗi token ERC-721 có một token ID duy nhất trong một hợp đồng cụ thể.

Cặp địa chỉ hợp đồng và token ID xác định duy nhất NFT trên blockchain đó.

Phần mở rộng metadata cho phép ứng dụng yêu cầu hợp đồng cung cấp tokenURI.

Base URI giúp hợp đồng tránh phải lưu URI đầy đủ cho từng token.

Điều này hữu ích vì lưu các chuỗi dài on-chain có thể tốn kém.

Thay vì lưu 10,000 liên kết metadata đầy đủ, một bộ sưu tập có thể lưu một Base URI và dùng token ID để tạo từng liên kết.

Thiết kế này phổ biến trong các bộ sưu tập ảnh đại diện, vật phẩm game, thẻ thành viên, loạt tác phẩm nghệ thuật và bộ sưu tập vật phẩm.

Ví dụ: token 1, token 2 và token 3 có thể dùng chung Base URI nhưng mỗi token trỏ đến một tệp metadata khác nhau.

Base URI dùng chung giúp cấu trúc đơn giản và dễ dự đoán.

Base URI trong token ERC-1155

ERC-1155 là tiêu chuẩn đa token có thể hỗ trợ token có thể thay thế, token bán thay thế và NFT trong cùng một hợp đồng.

ERC-1155 xử lý metadata khác với nhiều cách triển khai ERC-721.

Tiêu chuẩn ERC-1155 chính thức nêu rằng giá trị URI cho phép ứng dụng thay thế ID khi chuỗi {id} xuất hiện trong URI.

Ứng dụng phải thay {id} bằng token ID thực tế ở dạng hệ thập lục phân viết thường, được đệm đủ 64 ký tự khi cần.

Nhờ đó, nhiều token ID có thể dùng chung một mẫu URI.

Ví dụ: URI có thể có dạng https://example.com/metadata/{id}.json.

Ví hoặc ứng dụng thay {id} bằng token ID đã định dạng để tìm đúng tệp JSON.

Cách này có mục đích tương tự Base URI vì tạo nhiều liên kết metadata token từ một mẫu dùng chung.

Tuy nhiên, ERC-1155 dùng quy tắc thay thế cụ thể thay vì cách ghép đơn giản Base URI với token ID thường thấy trong nhiều hợp đồng ERC-721.

Nhà phát triển không nên cho rằng đường dẫn metadata của ERC-721 và ERC-1155 được tạo theo cùng một cách.

Base URI và metadata NFT

Metadata NFT là thông tin có cấu trúc cho người dùng biết token đại diện cho điều gì.

Metadata có thể bao gồm tên, mô tả, hình ảnh, URL hoạt ảnh, thuộc tính, hình nền, đặc điểm độ hiếm, cấp độ, tham chiếu nội dung có thể mở khóa, liên kết bên ngoài và các trường khác.

Lược đồ metadata ERC-721 bao gồm các trường cơ bản như name, description và image.

Lược đồ metadata ERC-1155 cũng bao gồm các trường mô tả phổ biến và hỗ trợ dữ liệu hiển thị riêng cho từng token.

Base URI thường trỏ đến thư mục hoặc endpoint chứa các tệp metadata.

Nếu metadata được lưu dưới dạng tệp JSON, mỗi token ID thường tương ứng với một tệp JSON.

Nếu metadata có tính động, Base URI có thể trỏ đến endpoint API trả về JSON khác nhau theo thời gian.

Nếu metadata được định địa chỉ theo nội dung, Base URI có thể trỏ đến mã định danh lưu trữ phi tập trung.

Chất lượng của Base URI quyết định liệu ứng dụng có thể tìm và hiển thị metadata nhất quán hay không.

Token thiếu metadata vẫn có thể tồn tại on-chain, nhưng người dùng sẽ khó hiểu hoặc định giá token hơn nhiều.

Base URI và IPFS

IPFS là hệ thống lưu trữ phi tập trung phổ biến được dùng cho metadata và nội dung đa phương tiện của NFT.

Hướng dẫn dữ liệu NFT của IPFS chính thức khuyến nghị dùng URI IPFS để liên kết từ hợp đồng thông minh đến dữ liệu NFT bên ngoài được lưu trên IPFS.

URI IPFS thường bắt đầu bằng ipfs:// và chứa mã định danh nội dung, còn gọi là CID.

Base URI dùng IPFS có thể có dạng ipfs://bafyExampleCID/.

Sau đó, từng tệp metadata token có thể được lưu trong thư mục IPFS đó.

Thiết kế này có thể giúp metadata NFT chống giả mạo tốt hơn các liên kết web thông thường vì CID xác định nội dung dựa trên dữ liệu, chứ không chỉ dựa trên vị trí máy chủ.

Nếu nội dung thay đổi, CID cũng thay đổi.

Điều này giúp người dùng phát hiện metadata có bị chỉnh sửa hay không.

Tuy nhiên, nội dung IPFS vẫn cần có ít nhất một node hoặc nhà cung cấp ghim dữ liệu (pinning) lưu trữ để người dùng dễ truy xuất.

Dùng Base URI trên IPFS giúp tăng tính toàn vẹn, nhưng không loại bỏ nhu cầu lập kế hoạch lưu trữ lâu dài.

Base URI và URL HTTP

Base URI cũng có thể dùng URL HTTPS thông thường.

Ví dụ: một bộ sưu tập có thể dùng https://example.com/metadata/ làm Base URI.

tokenURI của token 100 khi đó có thể là https://example.com/metadata/100.json.

Metadata HTTPS có thể đơn giản và linh hoạt vì dự án có thể cập nhật tệp trên máy chủ web.

Tính linh hoạt này có thể hữu ích cho game, NFT động, tư cách thành viên hoặc tác phẩm nghệ thuật phát triển theo thời gian.

Tuy nhiên, cách này cũng tạo ra rủi ro về niềm tin vì chủ máy chủ có thể thay đổi, xóa, chuyển hướng hoặc chặn metadata.

Nếu tên miền hết hạn hoặc nhà cung cấp dịch vụ lưu trữ ngừng hoạt động, NFT có thể không còn hiển thị đúng.

Nếu tài khoản quản trị dự án bị xâm phạm, Base URI hoặc endpoint metadata có thể phân phối nội dung độc hại hoặc gây hiểu nhầm.

Metadata HTTP tập trung dễ sử dụng nhưng có thể làm giảm tính bền vững lâu dài.

Người dùng nên kiểm tra dự án sử dụng lưu trữ định địa chỉ theo nội dung, máy chủ web tập trung hay mô hình kết hợp.

Base URI và lưu trữ kiểu Arweave

Một số dự án NFT sử dụng hệ thống lưu trữ lâu dài cho metadata và nội dung đa phương tiện.

Trong các hệ thống này, metadata có thể được tham chiếu bằng mã định danh giao dịch hoặc đường dẫn nội dung vĩnh viễn.

Base URI có thể trỏ đến cổng truy cập lưu trữ lâu dài hoặc đường dẫn manifest sắp xếp nhiều tệp metadata token.

Cách tiếp cận này có thể giảm nguy cơ máy chủ web thông thường ngừng hoạt động.

Nó cũng có thể giảm nhu cầu thanh toán phí ghim dữ liệu định kỳ nếu hệ thống lưu trữ được thiết kế để duy trì dữ liệu lâu dài.

Tuy nhiên, người dùng vẫn nên hiểu chính xác định dạng URI và cách hoạt động của cổng truy cập.

URL cổng truy cập không phải lúc nào cũng giống mã định danh nội dung vĩnh viễn bên dưới.

Nếu hợp đồng chỉ lưu URL kiểu cổng truy cập, việc hiển thị có thể phụ thuộc vào khả năng hoạt động của cổng đó.

Thiết kế tốt hơn sẽ hiển thị rõ mã định danh vĩnh viễn để có thể xác minh.

Thiết kế Base URI nên giúp dễ kiểm tra vị trí dữ liệu lâu dài.

Base URI và metadata on-chain

Một số token không dựa vào Base URI bên ngoài vì metadata được lưu hoặc tạo hoàn toàn on-chain.

Metadata on-chain có thể được trả về dưới dạng data URI chứa JSON đã mã hóa trực tiếp từ hợp đồng thông minh.

Trong thiết kế này, tokenURI có thể trả về chuỗi bắt đầu bằng data:application/json thay vì ipfs:// hoặc https://.

Cách này có thể giúp metadata tự chứa hơn vì hợp đồng token trực tiếp tạo metadata.

Metadata on-chain có thể hữu ích cho nghệ thuật tạo sinh, game hoàn toàn on-chain, hệ thống nhận dạng và vật phẩm sưu tầm bất biến.

Đổi lại, việc lưu trữ và tính toán on-chain có thể tốn kém.

Có thể khó lưu hình ảnh lớn, hoạt ảnh và metadata phức tạp trực tiếp on-chain.

Vì vậy, nhiều dự án dùng Base URI cho metadata bên ngoài và chỉ sử dụng metadata hoàn toàn on-chain trong các trường hợp đặc biệt.

Không có một mô hình tối ưu duy nhất cho mọi dự án.

Thiết kế metadata phù hợp nhất phụ thuộc vào chi phí, tính lâu dài, mức độ linh hoạt, kỳ vọng của người dùng và độ phức tạp kỹ thuật.

Base URI và quá trình reveal metadata

Nhiều bộ sưu tập NFT sử dụng Base URI trong quá trình reveal.

Trước khi reveal, mọi token có thể trả về cùng một metadata giữ chỗ.

Metadata giữ chỗ này có thể hiển thị hình ảnh bí ẩn hoặc mô tả chung của bộ sưu tập.

Sau khi reveal, dự án cập nhật Base URI để mỗi token trỏ đến tệp metadata cuối cùng.

Cách này có thể giúp quá trình mint công bằng hơn vì người dùng không biết trước đặc điểm cuối cùng của từng token trước khi reveal.

Tuy nhiên, thiết kế reveal đòi hỏi người dùng phải tin tưởng dự án.

Nếu dự án kiểm soát Base URI, dự án có thể thay đổi metadata sau khi mint.

Nếu quy trình reveal không minh bạch, người dùng có thể lo ngại rằng các đặc điểm hiếm được phân bổ không công bằng.

Dự án có thể giảm lo ngại bằng cách công bố hash nguồn gốc, sử dụng tính ngẫu nhiên có thể xác minh, khóa metadata sau khi reveal hoặc giúp việc tạo metadata có thể kiểm tra.

Người dùng nên tìm hiểu Base URI của bộ sưu tập là tạm thời, đã reveal, có thể thay đổi hay đã khóa vĩnh viễn.

Base URI có thể thay đổi

Base URI có thể thay đổi là Base URI có thể được cập nhật sau khi hợp đồng được triển khai.

Base URI có thể thay đổi sẽ hữu ích khi metadata chưa sẵn sàng lúc ra mắt, khi cần di chuyển nội dung đa phương tiện hoặc khi NFT động cần cập nhật.

Tuy nhiên, điều này cũng có thể nguy hiểm vì người kiểm soát chức năng cập nhật có thể thay đổi nội dung hiển thị của mọi token.

Dự án có thể thay tác phẩm nghệ thuật, đổi đặc điểm, chuyển hướng metadata sang máy chủ mới hoặc xóa nội dung.

Quản trị viên độc hại có thể thay metadata theo cách làm giảm giá trị token hoặc gây hiểu nhầm cho người dùng.

Khóa quản trị bị xâm phạm cũng có thể dẫn đến kết quả tương tự ngay cả khi đội ngũ ban đầu trung thực.

Người dùng nên kiểm tra Base URI còn có thể thay đổi hay không.

Họ cũng nên kiểm tra ai có quyền thay đổi.

Base URI có thể thay đổi do một ví do một cá nhân hoặc tổ chức bên ngoài kiểm soát sẽ rủi ro hơn quy trình cập nhật được quản trị chặt chẽ.

Khả năng thay đổi metadata cần được công bố rõ ràng vì nó làm thay đổi mô hình niềm tin của token.

Base URI bất biến

Base URI bất biến là Base URI không thể thay đổi sau khi triển khai hoặc sau khi thực hiện thao tác khóa cuối cùng.

Điều này có thể tăng mức độ tin cậy vì người dùng biết quản trị viên sẽ không thể thay đổi đường dẫn metadata về sau.

Base URI bất biến phổ biến ở các dự án muốn duy trì tính lâu dài của vật phẩm sưu tầm.

Thiết kế này đặc biệt đáng tin cậy khi kết hợp với lưu trữ định địa chỉ theo nội dung như CID IPFS.

Tuy nhiên, tính bất biến cũng có thể gây ra vấn đề nếu URI ban đầu có lỗi.

Nếu tệp metadata bị thiếu, sai định dạng hoặc được tải lên nhầm đường dẫn, dự án có thể không sửa được.

Nếu cổng lưu trữ thay đổi cách hoạt động, hợp đồng có thể không điều chỉnh được.

Nhà phát triển nên kiểm tra kỹ đường dẫn metadata trước khi khóa Base URI.

Người dùng nên hiểu rằng tính bất biến giúp ngăn thay đổi về sau nhưng không đảm bảo metadata ban đầu chính xác.

Một sai sót vĩnh viễn vẫn sẽ tồn tại vĩnh viễn.

Base URI và cập nhật metadata ERC-4906

ERC-4906 là phần mở rộng cập nhật metadata cho token ERC-721.

Tiêu chuẩn ERC-4906 chính thức bổ sung các sự kiện MetadataUpdate và BatchMetadataUpdate để thông báo về thay đổi metadata.

Điều này quan trọng vì ví, trình lập chỉ mục và ứng dụng thường lưu metadata vào bộ nhớ đệm.

Nếu Base URI thay đổi nhưng ứng dụng không làm mới bộ nhớ đệm, người dùng có thể tiếp tục thấy metadata cũ.

ERC-4906 cung cấp cho hợp đồng một cách tiêu chuẩn để thông báo với các hệ thống bên thứ ba rằng metadata token đã thay đổi.

Điều này hữu ích cho sự kiện reveal, NFT động, vật phẩm game phát triển theo thời gian và các chỉnh sửa metadata sau khi mint.

Tuy nhiên, bản thân tiêu chuẩn này không khiến việc thay đổi metadata trở nên an toàn.

Nó chỉ giúp thông báo rằng metadata đã thay đổi.

Quyền kiểm soát việc thay đổi metadata vẫn rất quan trọng.

Nếu dự án sử dụng Base URI có thể thay đổi hoặc metadata động, quyền cập nhật cần được bảo mật và mô tả rõ ràng.

Base URI và metadata đa dạng ERC-7160

ERC-7160 là phần mở rộng ERC-721 hỗ trợ nhiều URI metadata cho mỗi token.

Tiêu chuẩn ERC-7160 chính thức mô tả hệ thống trong đó một token có thể có nhiều URI metadata và một URI chính được ghim.

Điều này liên quan đến Base URI vì metadata không còn luôn chỉ nằm ở một vị trí tĩnh.

Một token có thể có nhiều phiên bản, định dạng, bản sửa đổi hoặc lựa chọn hiển thị.

Ví dụ: tác phẩm nghệ thuật động có thể có nhiều trạng thái metadata được phê duyệt.

Vật phẩm game có thể có metadata khác nhau sau các lần nâng cấp hoặc sự kiện.

NFT cộng tác có thể bao gồm metadata từ nhiều nhà sáng tạo.

Hỗ trợ nhiều metadata có thể tăng tính linh hoạt nhưng cũng khiến việc kiểm tra metadata phức tạp hơn.

Người dùng và ứng dụng cần biết URI nào là chính và các URI cũ có còn truy cập được hay không.

Base URI vẫn quan trọng vì đây thường là đường dẫn gốc của một hoặc nhiều vị trí metadata đó.

Base URI và hiệu quả sử dụng gas

Base URI thường được dùng để giảm chi phí gas.

Lưu URI metadata đầy đủ cho từng token có thể tốn kém vì lưu trữ on-chain tiêu tốn gas.

Base URI dùng chung giúp hợp đồng lưu ít thông tin hơn.

Thay vì lưu hàng nghìn chuỗi dài, hợp đồng có thể lưu một tiền tố và tính đường dẫn riêng cho từng token khi cần.

Điều này đặc biệt hữu ích cho các bộ sưu tập lớn có nhiều token ID.

Ví dụ: bộ sưu tập gồm 10,000 token có thể dùng một Base URI và 10,000 tệp JSON được đặt tên theo token ID.

Hợp đồng chỉ cần đủ logic để ghép Base URI với token ID.

Cách này tiết kiệm chi phí lưu trữ nhưng giảm tính linh hoạt so với việc lưu URI tùy chỉnh cho từng token.

Nhà phát triển cần lựa chọn giữa tiết kiệm gas và tính linh hoạt của metadata.

Thiết kế chi phí thấp vẫn có thể không an toàn nếu khiến metadata quá dễ thay đổi hoặc quá khó xác minh.

Base URI và cách đặt tên tệp

Cách đặt tên tệp rất quan trọng vì việc tạo tokenURI phải khớp với các tệp metadata thực tế.

Nếu hợp đồng trả về ipfs://CID/1, vị trí lưu trữ cần có tệp hoặc đối tượng tên là 1.

Nếu vị trí lưu trữ có 1.json nhưng hợp đồng chỉ trả về 1, một số ứng dụng có thể không tải được metadata.

Nếu hợp đồng trả về 0001.json nhưng tệp có tên 1.json, metadata cũng có thể bị lỗi.

ERC-1155 tạo thêm một bước phức tạp vì việc thay token ID sử dụng định dạng thập lục phân viết thường, có đệm.

Nhà phát triển nên quyết định cách đặt tên tệp trước khi triển khai.

Họ nên thử nghiệm đầu ra tokenURI với các tệp metadata thực trên mạng thử nghiệm.

Họ nên kiểm tra nhiều token ID, bao gồm ID thấp, ID cao và mọi ID không tuần tự.

Họ cũng nên kiểm tra cách ví và trình lập chỉ mục diễn giải metadata.

Lỗi nhỏ trong cách đặt tên có thể gây ra vấn đề hiển thị lớn trên toàn bộ bộ sưu tập.

Base URI và dấu gạch chéo ở cuối

Dấu gạch chéo ở cuối là ký tự / ở cuối Base URI.

Nó có thể quyết định tokenURI cuối cùng có hợp lệ hay không.

Ví dụ: ipfs://CID/ cộng với token ID 1 sẽ thành ipfs://CID/1.

Nếu không có dấu gạch chéo, ipfs://CID cộng với token ID 1 sẽ thành ipfs://CID1, có thể không đúng.

Vấn đề tương tự cũng có thể xảy ra với đường dẫn HTTPS.

https://example.com/metadata/ cộng với 1.json sẽ tạo thành đường dẫn tệp rõ ràng.

https://example.com/metadata cộng với 1.json sẽ thành https://example.com/metadata1.json, có thể không tồn tại.

Nhà phát triển nên xử lý dấu gạch chéo và hậu tố nhất quán trong hợp đồng.

Người dùng không phải lúc nào cũng nhận ra vấn đề này qua giao diện marketplace.

Khi metadata không tải được, điều đầu tiên thường cần kiểm tra là chuỗi tokenURI chính xác mà hợp đồng trả về.

Base URI và bộ nhớ đệm metadata

Nhiều ví, marketplace, trình khám phá blockchain và dịch vụ lập chỉ mục lưu metadata NFT vào bộ nhớ đệm.

Bộ nhớ đệm giúp tăng tốc vì ứng dụng không cần tải metadata từ đầu mỗi lần.

Tuy nhiên, bộ nhớ đệm có thể khiến việc thay đổi Base URI trở nên khó hiểu.

Dự án có thể cập nhật metadata nhưng một số ứng dụng vẫn hiển thị hình ảnh hoặc thuộc tính cũ.

Đây là một lý do khiến các sự kiện cập nhật metadata có thể hữu ích.

ERC-4906 được tạo ra để cung cấp cho hợp đồng một cách tiêu chuẩn thông báo về thay đổi metadata.

Dù vậy, không phải ứng dụng nào cũng làm mới ngay lập tức hoặc hỗ trợ mọi sự kiện metadata.

Người dùng nên hiểu rằng một token có thể hiển thị metadata khác nhau trên các ứng dụng khác nhau trong thời gian chờ làm mới.

Điều này không phải lúc nào cũng có nghĩa token đã đổi chủ hoặc bị lỗi.

Có thể đơn giản là bộ nhớ đệm metadata chưa được cập nhật.

Base URI và rủi ro tập trung hóa

Base URI có thể tạo ra rủi ro tập trung hóa khi trỏ đến máy chủ hoặc tên miền do một bên kiểm soát.

Nếu dự án lưu metadata trên một tên miền web thông thường, chủ sở hữu tên miền có thể thay đổi các tệp.

Tên miền cũng có thể hết hạn, bị tịch thu, bị tấn công hoặc ngừng hoạt động.

Nghiên cứu về rủi ro tập trung hóa metadata NFT nhấn mạnh rằng lưu trữ metadata tập trung có thể khiến dữ liệu NFT đối mặt với kiểm duyệt, xâm phạm bảo mật và thay đổi do quản trị viên thực hiện.

Điều này quan trọng vì nhiều người dùng cho rằng sở hữu NFT đồng nghĩa toàn bộ tài sản được lưu trữ vĩnh viễn on-chain.

Trên thực tế, token có thể chỉ trỏ đến metadata được lưu ở nơi khác.

Nếu con trỏ đó không ổn định, tài sản hiển thị cho người dùng cũng có thể trở nên không ổn định.

Lưu trữ định địa chỉ theo nội dung và cơ chế khóa metadata rõ ràng có thể giảm rủi ro này.

Tuy nhiên, mọi dự án đều cần kế hoạch lưu trữ dài hạn.

NFT đẹp mắt có thể trở thành liên kết hỏng nếu Base URI được quản lý kém.

Base URI và định địa chỉ theo nội dung

Định địa chỉ theo nội dung nghĩa là mã định danh được tạo dựa trên chính nội dung đó.

CID IPFS là một ví dụ phổ biến trong metadata crypto.

Khi metadata được định địa chỉ theo nội dung, việc thay đổi metadata sẽ tạo ra một mã định danh khác.

Điều này giúp phát hiện việc giả mạo dễ dàng hơn.

Do đó, Base URI có chứa CID có thể giúp người dùng tin tưởng hơn rằng các tệp được tham chiếu không bị thay đổi âm thầm.

Điều này khác với URL thông thường, nơi máy chủ có thể cung cấp nội dung mới tại cùng một địa chỉ.

Định địa chỉ theo nội dung không có nghĩa nội dung tự động được lưu trữ mãi mãi.

Vẫn cần có bên lưu trữ, ghim hoặc bảo toàn dữ liệu theo cách khác.

Cách này cũng không đảm bảo metadata ban đầu trung thực hoặc có chất lượng cao.

Nó chỉ giúp xác minh nội dung được liên kết với mã định danh đó có còn nguyên vẹn hay không.

Base URI và NFT động

NFT động là token có metadata thay đổi tùy theo sự kiện, thời gian, hành động của người dùng, trạng thái game, dữ liệu oracle hoặc logic hợp đồng.

NFT động có thể dùng Base URI trỏ đến API hoặc dịch vụ metadata động.

NFT cũng có thể tạo metadata on-chain dựa trên trạng thái thay đổi.

Base URI động có thể khiến NFT tương tác tốt hơn và hữu dụng hơn.

Ví dụ: NFT nhân vật trong game có thể lên cấp và hiển thị thuộc tính mới.

NFT thành viên có thể thay đổi diện mạo khi người dùng đạt một cấp bậc.

Token tài sản thế giới thực có thể cập nhật metadata khi tài liệu được làm mới.

Rủi ro nằm ở chỗ metadata động đòi hỏi người dùng tin tưởng vào quy tắc cập nhật.

Người dùng nên biết điều gì có thể thay đổi, ai có thể thay đổi và việc thay đổi được quản lý bằng mã, quản trị viên hay hệ thống off-chain.

Metadata động chỉ thực sự hữu ích khi các quy tắc minh bạch.

Base URI và bảo mật

Bảo mật Base URI phụ thuộc vào hình thức lưu trữ, quyền truy cập, logic hợp đồng và kỳ vọng của người dùng.

Nếu Base URI có thể cập nhật, chức năng cập nhật phải có cơ chế kiểm soát quyền chặt chẽ.

Nếu một khóa riêng tư kiểm soát Base URI, khóa đó sẽ trở thành mục tiêu có giá trị cao.

Nếu ví multisig kiểm soát Base URI, mức độ bảo mật phụ thuộc vào độ tin cậy của người ký và quy tắc ngưỡng ký.

Nếu quyền quản trị kiểm soát Base URI, mức độ bảo mật phụ thuộc vào cách phân bổ quyền biểu quyết và quy trình nâng cấp.

Nếu Base URI trỏ đến máy chủ, bảo mật máy chủ và tên miền đều quan trọng.

Nếu Base URI trỏ đến IPFS, việc ghim dữ liệu và khả năng truy cập nội dung đều quan trọng.

Nếu metadata được tạo on-chain, tính chính xác của hợp đồng là yếu tố then chốt.

Không có một mô hình bảo mật Base URI duy nhất.

Câu hỏi cần đặt ra luôn là: điều gì có thể thay đổi, ai có thể thay đổi và người dùng có thể xác minh điều đó bằng cách nào?

Base URI và nâng cấp hợp đồng thông minh

Hợp đồng thông minh có thể nâng cấp có khả năng thay đổi cách tính tokenURI.

Điều này có nghĩa logic Base URI có thể thay đổi ngay cả khi biến Base URI hiển thị có vẻ ổn định.

Hợp đồng NFT có thể nâng cấp cho phép nhà phát triển sửa lỗi hoặc bổ sung tính năng.

Hợp đồng cũng có thể cho phép thay đổi cách xử lý metadata sau khi người dùng mua token.

Người dùng nên kiểm tra hợp đồng có thể nâng cấp hay không.

Họ cũng nên kiểm tra ai kiểm soát việc nâng cấp và liệu có timelock hay quy trình quản trị hay không.

Base URI đã khóa sẽ ít ý nghĩa hơn nếu một lần nâng cấp có thể thay thế toàn bộ hàm tokenURI.

Để có bảo đảm mạnh hơn về metadata, cần xem xét cả Base URI lẫn lộ trình nâng cấp hợp đồng.

Nhà phát triển nên công bố rõ khả năng nâng cấp vì yếu tố này ảnh hưởng đến niềm tin.

Người dùng không nên chỉ dựa vào Base URI để đánh giá metadata có được duy trì lâu dài hay không.

Base URI và xác minh token

Base URI có thể giúp người dùng xác minh metadata token có đến từ nguồn bộ sưu tập dự kiến hay không.

Tuy nhiên, người dùng không nên chỉ dựa vào hình ảnh hoặc tên token.

Token giả có thể sao chép metadata, tên, ký hiệu và hình ảnh từ bộ sưu tập thật.

Định danh thực sự là địa chỉ hợp đồng và token ID trên đúng blockchain.

Base URI có thể cho biết metadata trỏ đến đâu, nhưng bản thân nó không chứng minh token là chính hãng.

Hợp đồng lừa đảo có thể trỏ đến metadata sao chép từ một bộ sưu tập hợp pháp.

Người dùng nên xác minh địa chỉ hợp đồng, tiêu chuẩn token, thông tin nhà sáng tạo, đường dẫn metadata, lịch sử sở hữu và nguồn chính thức của dự án.

Nhà phát triển nên làm cho đầu ra tokenURI dễ dự đoán và kiểm tra.

Thiết kế Base URI rõ ràng hỗ trợ xác minh nhưng không thay thế việc xác minh hợp đồng.

Tính xác thực phụ thuộc vào cả định danh token lẫn tính toàn vẹn của metadata.

Base URI và metadata cấp bộ sưu tập

Base URI thường chỉ các đường dẫn metadata cấp token.

Metadata cấp bộ sưu tập khác vì mô tả toàn bộ hợp đồng hoặc bộ sưu tập.

Metadata bộ sưu tập có thể bao gồm tên, mô tả, hình ảnh, banner, liên kết bên ngoài, phí hoặc thông tin mạng xã hội của bộ sưu tập.

Một số hợp đồng cung cấp metadata cấp bộ sưu tập thông qua các hàm riêng như contractURI.

Không nên nhầm Base URI của token với URI metadata của bộ sưu tập.

Base URI của token giúp tạo metadata cho từng token ID.

URI metadata bộ sưu tập mô tả toàn bộ bộ sưu tập.

Cả hai đều có thể ảnh hưởng đến cách ví và ứng dụng hiển thị dự án.

Cả hai cũng có thể tạo ra rủi ro tập trung hóa hoặc khả năng thay đổi.

Người dùng nên hiểu URI nào kiểm soát dữ liệu của từng token và URI nào kiểm soát dữ liệu hiển thị của cả bộ sưu tập.

Base URI và đóng băng metadata

Đóng băng metadata nghĩa là khiến metadata vĩnh viễn không thể thay đổi hoặc thông báo rằng metadata không nên thay đổi nữa.

Dự án có thể đóng băng metadata bằng cách xóa khả năng cập nhật Base URI.

Dự án cũng có thể đóng băng metadata bằng cách đặt Base URI thành đường dẫn lưu trữ định địa chỉ theo nội dung và từ bỏ quyền cập nhật.

Một số dự án thông báo metadata đã được đóng băng sau khi reveal.

Người dùng nên xác minh việc đóng băng được thực thi bằng mã hay chỉ là cam kết của đội ngũ.

Lời hứa kém chắc chắn hơn khóa ở cấp hợp đồng.

Khóa ở cấp hợp đồng cũng kém hiệu quả hơn nếu hợp đồng vẫn có thể nâng cấp.

Muốn đóng băng metadata thực sự, cần xem xét mọi cách có thể làm thay đổi kết quả tokenURI.

Đóng băng có thể tăng niềm tin của nhà sưu tầm khi tính lâu dài là yếu tố quan trọng.

Tuy nhiên, đóng băng quá sớm có thể khiến sai sót không thể khắc phục về sau.

Base URI và trải nghiệm người dùng

Base URI ảnh hưởng đến trải nghiệm người dùng vì ứng dụng sử dụng metadata để hiển thị tài sản người dùng sở hữu.

Nếu Base URI tải nhanh, NFT sẽ hiển thị mượt mà.

Nếu Base URI chậm, không khả dụng hoặc bị chặn, ví có thể hiển thị hình ảnh trống hoặc ảnh giữ chỗ chung.

Nếu JSON metadata sai định dạng, ứng dụng có thể không phân tích được.

Nếu liên kết hình ảnh trong metadata bị hỏng, token có thể hiển thị văn bản nhưng không có nội dung đa phương tiện.

Nếu các đặc điểm không nhất quán, công cụ đánh giá độ hiếm và game có thể đọc sai token.

Người dùng thường đánh giá bộ sưu tập qua những gì họ thấy trong ví.

Vì vậy, nhà phát triển nên xem thiết kế Base URI là một phần của chất lượng sản phẩm.

Metadata cần hợp lệ, ổn định, đủ nhanh để tải và nhất quán giữa các token ID.

Hợp đồng thông minh tốt vẫn có thể tạo cảm giác bị lỗi nếu Base URI và metadata được quản lý kém.

Ví dụ về Base URI

Base URI IPFS đơn giản có thể có dạng ipfs://bafyExampleCID/.

Nếu hợp đồng nối token ID 7 và hậu tố .json, tokenURI đầy đủ có thể là ipfs://bafyExampleCID/7.json.

Base URI HTTPS đơn giản có thể có dạng https://example.com/api/token/.

Nếu hợp đồng nối token ID 7, tokenURI đầy đủ có thể là https://example.com/api/token/7.

Mẫu URI ERC-1155 có thể có dạng https://example.com/metadata/{id}.json.

Trong trường hợp này, ứng dụng tương thích thay {id} bằng token ID đã định dạng.

Data URI on-chain có thể bắt đầu bằng data:application/json;base64, thay vì sử dụng Base URI.

Các ví dụ này cho thấy vì sao người dùng nên kiểm tra tokenURI thực tế được trả về thay vì phỏng đoán từ trang web của bộ sưu tập.

Hàm tokenURI của hợp đồng là nguồn mà ứng dụng thường truy vấn.

Base URI chỉ hữu ích khi tạo ra tokenURI hợp lệ và có thể truy cập.

Lợi ích khi sử dụng Base URI

Lợi ích đầu tiên của Base URI là hiệu quả sử dụng gas.

Một tiền tố dùng chung có thể giảm lượng dữ liệu lưu trữ on-chain.

Lợi ích thứ hai là sắp xếp bộ sưu tập dễ dàng hơn.

Nhà phát triển có thể lưu tệp metadata trong một thư mục hoặc endpoint và ánh xạ chúng với token ID.

Lợi ích thứ ba là đơn giản hóa việc mint bộ sưu tập lớn.

Token mới có thể tự động trỏ đến các đường dẫn metadata dễ dự đoán.

Lợi ích thứ tư là quản lý reveal dễ dàng hơn.

Nếu hợp đồng cho phép, dự án có thể chuyển từ metadata giữ chỗ sang metadata cuối cùng chỉ bằng một lần thay đổi Base URI.

Lợi ích thứ năm là khả năng tương thích.

Ví, trình khám phá và ứng dụng đã quen với việc đọc tokenURI và các đường dẫn metadata dạng URI.

Lợi ích thứ sáu là tính linh hoạt.

Base URI có thể hỗ trợ IPFS, HTTPS, liên kết lưu trữ lâu dài, endpoint API hoặc thiết kế kết hợp.

Rủi ro khi sử dụng Base URI

Rủi ro đầu tiên là metadata bị hỏng.

Base URI sai có thể làm hỏng mọi token trong bộ sưu tập.

Rủi ro thứ hai là tập trung hóa.

Base URI trỏ đến máy chủ thông thường phụ thuộc vào máy chủ, tên miền và đơn vị vận hành.

Rủi ro thứ ba là cập nhật độc hại.

Nếu quản trị viên có thể thay đổi Base URI, họ có thể thay đổi nội dung hiển thị của mọi token.

Rủi ro thứ tư là khả năng thay đổi bị che giấu.

Người dùng có thể nghĩ metadata là vĩnh viễn trong khi Base URI vẫn có thể chỉnh sửa.

Rủi ro thứ năm là nhầm lẫn do bộ nhớ đệm.

Ứng dụng có thể hiển thị metadata cũ sau khi Base URI được cập nhật.

Rủi ro thứ sáu là khả năng truy cập dữ liệu lưu trữ.

Ngay cả metadata định địa chỉ theo nội dung cũng có thể khó truy xuất nếu không ai lưu trữ hoặc ghim dữ liệu.

Rủi ro thứ bảy là logic có thể nâng cấp.

Nâng cấp hợp đồng có thể thay đổi cách hoạt động của tokenURI ngay cả khi Base URI có vẻ đã khóa.

Cách kiểm tra Base URI

Người dùng có thể kiểm tra cách hoạt động của Base URI bằng cách gọi hàm tokenURI cho token ID cụ thể.

Họ nên so sánh URI được trả về với thông tin metadata chính thức mà dự án công bố.

Họ nên kiểm tra URI bắt đầu bằng ipfs://, https://, data:, ar:// hay giao thức nào khác.

Họ nên kiểm tra xem tệp metadata có tải được và trả về JSON hợp lệ hay không.

Họ nên xem JSON có bao gồm image, description, attributes và các trường khác như mong đợi hay không.

Họ nên kiểm tra các liên kết hình ảnh trong JSON có ổn định và truy cập được hay không.

Họ nên xem hợp đồng để biết Base URI có thể thay đổi hay không.

Họ nên kiểm tra hợp đồng có thể nâng cấp hay không.

Họ nên theo dõi các sự kiện cập nhật metadata nếu bộ sưu tập thông báo metadata đã thay đổi.

Không nên cho rằng token an toàn chỉ vì token hiển thị đúng trong một ví.

Thực tiễn tốt nhất dành cho nhà phát triển

Nhà phát triển nên quyết định mô hình lưu trữ metadata trước khi triển khai hợp đồng token.

Họ nên chọn Base URI sẽ bất biến, có thể thay đổi, dựa trên reveal, động hay hoàn toàn on-chain.

Nên dùng liên kết định địa chỉ theo nội dung khi tính toàn vẹn lâu dài là quan trọng.

Trước khi ra mắt, nhà phát triển nên kiểm tra đầu ra tokenURI với nhiều token ID.

Họ nên đảm bảo cách đặt tên tệp, hậu tố và dấu gạch chéo ở cuối nhất quán.

Họ nên bảo vệ các hàm cập nhật Base URI bằng cơ chế kiểm soát quyền chặt chẽ.

Họ nên công bố liệu metadata có thể thay đổi sau khi mint hay không.

Khi metadata thay đổi và hợp đồng hỗ trợ mô hình đó, họ nên phát các sự kiện cập nhật metadata tiêu chuẩn.

Họ nên lưu bản sao dự phòng và lập kế hoạch lưu trữ lâu dài cho toàn bộ metadata và nội dung đa phương tiện.

Họ nên nhớ rằng metadata là một phần của niềm tin người dùng, không chỉ là tính năng hiển thị.

Thực tiễn tốt nhất dành cho người dùng

Người dùng nên xác minh địa chỉ hợp đồng trước khi tin tưởng metadata.

Người dùng nên kiểm tra tokenURI của token thực tế thay vì tin vào ảnh chụp màn hình.

Người dùng nên ưu tiên các dự án giải thích rõ metadata được lưu trữ ở đâu.

Người dùng nên tìm hiểu Base URI còn có thể thay đổi hay không.

Người dùng nên kiểm tra metadata được lưu trên hệ thống định địa chỉ theo nội dung hay máy chủ tập trung.

Người dùng nên thận trọng với các dự án cam kết lưu trữ lâu dài nhưng vẫn giữ quyền cập nhật cho quản trị viên.

Người dùng nên theo dõi các thay đổi metadata đột ngột sau khi reveal hoặc bán token.

Người dùng nên nhớ rằng sở hữu NFT không phải lúc nào cũng đồng nghĩa với sở hữu tệp đa phương tiện, bản quyền hoặc quyền off-chain.

Người dùng nên lưu metadata và nội dung đa phương tiện quan trọng trên thiết bị khi cần truy cập lâu dài.

Người dùng nên xem metadata bị hỏng hoặc đáng ngờ là một dấu hiệu rủi ro.

Những hiểu lầm phổ biến về Base URI

Một hiểu lầm phổ biến là Base URI lưu trữ chính NFT.

Base URI thường trỏ đến metadata, còn quyền sở hữu được theo dõi bởi hợp đồng thông minh.

Một hiểu lầm khác là hình ảnh NFT luôn được lưu trữ on-chain.

Nhiều hình ảnh NFT được lưu off-chain hoặc trên hệ thống lưu trữ phi tập trung rồi được tham chiếu qua metadata.

Hiểu lầm thứ ba là IPFS đảm bảo nội dung sẽ luôn trực tuyến.

IPFS giúp tăng tính toàn vẹn của nội dung, nhưng vẫn cần có bên cung cấp nội dung đó.

Hiểu lầm thứ tư là Base URI đã khóa đảm bảo quyền sở hữu hợp pháp đối với tài sản được hiển thị trong metadata.

Tính lâu dài của metadata và quyền pháp lý là hai vấn đề khác nhau.

Hiểu lầm thứ năm là mọi thay đổi Base URI đều xấu.

Một số thay đổi hợp lý trong các trường hợp reveal, NFT động hoặc sửa lỗi, nhưng cần minh bạch và được kiểm soát phù hợp.

Hiểu lầm thứ sáu là hiển thị đúng ở một nơi chứng minh Base URI an toàn.

Bộ nhớ đệm có thể che giấu vấn đề, vì vậy người dùng nên kiểm tra tokenURI thực tế nếu có thể.

Các thuật ngữ crypto liên quan

URI là viết tắt của Uniform Resource Identifier, một chuỗi dùng để xác định tài nguyên như tệp metadata.

tokenURI là hàm ERC-721 trả về URI metadata cho một token ID cụ thể.

ERC-721 là tiêu chuẩn token phổ biến trên Ethereum dành cho token không thể thay thế.

ERC-1155 là tiêu chuẩn đa token hỗ trợ tài sản có thể thay thế, bán thay thế và không thể thay thế.

Metadata NFT là dữ liệu JSON hoặc dữ liệu có cấu trúc mô tả tên, hình ảnh, đặc điểm và các thuộc tính khác của token.

IPFS là viết tắt của InterPlanetary File System, một mạng lưu trữ định địa chỉ theo nội dung thường dùng cho dữ liệu NFT.

CID là mã định danh nội dung, một tham chiếu định địa chỉ theo nội dung được IPFS sử dụng.

Data URI là URI nhúng dữ liệu trực tiếp bên trong chuỗi URI.

Reveal metadata là quá trình chuyển token từ metadata giữ chỗ sang metadata cuối cùng.

Đóng băng metadata là làm cho metadata token hoặc đường dẫn metadata không thể thay đổi sau một thời điểm nhất định.

Câu hỏi thường gặp

Base URI trong NFT có nghĩa là gì?

Base URI là đường dẫn bắt đầu dùng chung mà hợp đồng thông minh sử dụng để tạo URI metadata đầy đủ cho từng NFT.

Base URI có giống tokenURI không?

Không. Base URI thường là tiền tố dùng chung, còn tokenURI là URI metadata đầy đủ được trả về cho một token cụ thể.

Base URI hoạt động như thế nào trong ERC-721?

Trong nhiều hợp đồng ERC-721, Base URI được kết hợp với token ID để tạo tokenURI cuối cùng của NFT đó.

Base URI hoạt động như thế nào trong ERC-1155?

ERC-1155 thường dùng một mẫu URI có phần thay thế {id}, trong đó ứng dụng thay {id} bằng token ID đã định dạng.

Có thể thay đổi Base URI không?

Có thể, nếu hợp đồng có hàm cập nhật và tài khoản được ủy quyền vẫn kiểm soát hàm đó.

Base URI có thể thay đổi có rủi ro không?

Có. Base URI có thể thay đổi sẽ rủi ro vì người kiểm soát có thể thay metadata của nhiều hoặc toàn bộ token.

Base URI bất biến luôn tốt hơn phải không?

Base URI bất biến có thể tăng mức độ tin cậy, nhưng cũng có thể khóa vĩnh viễn các lỗi nếu đường dẫn metadata sai ngay từ đầu.

Vì sao các dự án NFT dùng IPFS cho Base URI?

Các dự án dùng IPFS vì CID IPFS được định địa chỉ theo nội dung và giúp người dùng xác minh metadata được tham chiếu không bị thay đổi âm thầm.

IPFS có đảm bảo metadata NFT luôn trực tuyến không?

Không. IPFS giúp duy trì tính toàn vẹn, nhưng nội dung vẫn cần được lưu trữ, ghim hoặc cung cấp theo cách khác.

Vì sao hình ảnh NFT của tôi không hiển thị dù tôi sở hữu token?

Hình ảnh có thể không hiển thị do Base URI sai, tệp metadata không khả dụng, liên kết hình ảnh bị hỏng hoặc bộ nhớ đệm của ứng dụng chưa được làm mới.

Reveal metadata là gì?

Reveal metadata là khi dự án chuyển token từ metadata giữ chỗ sang metadata cuối cùng, thường bằng cách cập nhật Base URI hoặc logic tokenURI.

Làm sao kiểm tra Base URI của NFT có an toàn không?

Bạn có thể kiểm tra đầu ra tokenURI, loại lưu trữ, quyền cập nhật, khả năng nâng cấp hợp đồng, định dạng metadata và khả năng truy cập tệp thông qua hệ thống lưu trữ đáng tin cậy.

Kết luận

Base URI là một khái niệm metadata quan trọng trong hợp đồng NFT và token crypto.

Đây là đường dẫn dùng chung giúp hợp đồng tạo URI metadata đầy đủ cho từng token.

Trong nhiều bộ sưu tập ERC-721, Base URI được kết hợp với token ID để tạo tokenURI.

Trong ERC-1155, mẫu URI sử dụng phần thay thế {id} thường đảm nhiệm chức năng tương tự.

Base URI giúp quản lý bộ sưu tập lớn dễ dàng và ít tốn kém hơn vì một tiền tố dùng chung có thể hỗ trợ nhiều tệp metadata token.

Nó cũng đặt ra những câu hỏi quan trọng về niềm tin vì metadata thường nằm ngoài blockchain.

Nếu Base URI trỏ đến máy chủ tập trung, người dùng phụ thuộc vào máy chủ và đơn vị vận hành.

Nếu Base URI trỏ đến hệ thống lưu trữ định địa chỉ theo nội dung, người dùng có thể được bảo đảm tốt hơn về tính toàn vẹn nhưng vẫn cần nội dung có thể truy cập.

Nếu Base URI có thể thay đổi, người dùng phải tin tưởng bên có quyền cập nhật và các biện pháp bảo mật của bên đó.

Nếu Base URI bất biến, người dùng có được tính lâu dài nhưng mất tính linh hoạt khi xảy ra sai sót.

Nhà phát triển nên thiết kế logic Base URI cẩn thận trước khi ra mắt, kiểm tra kỹ đường dẫn tệp, bảo vệ quyền cập nhật và công bố rõ khả năng thay đổi metadata.

Người dùng nên kiểm tra tokenURI, xác minh địa chỉ hợp đồng, hiểu loại lưu trữ và không mặc định rằng nội dung hiển thị sẽ tồn tại vĩnh viễn hoặc thuộc quyền sở hữu hợp pháp của mình.

Bài học quan trọng nhất là quyền sở hữu NFT và metadata NFT có liên quan nhưng không đồng nhất.

Hợp đồng thông minh chứng minh quyền sở hữu token, còn Base URI giúp ứng dụng tìm dữ liệu giải thích token đại diện cho điều gì.

Thiết kế Base URI tốt giúp mối liên kết đó ổn định, minh bạch và dễ xác minh.

Thiết kế Base URI yếu có thể biến token trông có giá trị thành liên kết hỏng, lời hứa có thể thay đổi hoặc rủi ro bảo mật metadata.