FA2 (Tezos)

FA2 trên Tezos là gì?

FA2 là tiêu chuẩn token thống nhất dành cho các hợp đồng thông minh trên blockchain Tezos.Tiêu chuẩn này xác định giao diện chung để ví, ứng dụng phi tập trung, trình khám phá blockchain, marketplace, trò chơi và các công cụ crypto khác có thể tương tác với token trên Tezos.

FA2 được quy định chính thức trong Đề xuất cải tiến Tezos số 12, hay TZIP-12.

Tiêu chuẩn này hỗ trợ token có thể thay thế, token không thể thay thế, tài sản không thể chuyển nhượng và hợp đồng quản lý nhiều loại token cùng lúc.Tính linh hoạt này cho phép một hợp đồng FA2 quản lý một loại tiền mã hóa, một bộ sưu tập NFT, nhiều tài sản trong trò chơi hoặc kết hợp các mô hình token khác nhau.FA2 không xác định giá trị kinh tế, tình trạng pháp lý, nguồn cung hay mục đích của token.Thay vào đó, tiêu chuẩn hóa các thao tác kỹ thuật quan trọng như chuyển token, kiểm tra số dư và cấp quyền cho operator.Token FA2 không được lưu trực tiếp trong tài khoản Tezos của người dùng giống như tez, tài sản gốc của Tezos.Hợp đồng thông minh FA2 duy trì sổ cái ghi lại tài khoản nào sở hữu từng token hoặc số dư token.

Tài liệu FA2 chính thức của Tezos mô tả FA2 là một tiêu chuẩn linh hoạt, cho phép tùy chỉnh hành vi token trong khi vẫn duy trì khả năng tương thích với các ứng dụng hiện có.

FA trong FA2 có nghĩa là gì?

FA là viết tắt của Financial Application (Ứng dụng tài chính).Tên gọi này phản ánh vai trò của tiêu chuẩn trong việc xác định giao diện có thể tái sử dụng cho tài sản tài chính và ứng dụng token hóa trên Tezos.FA2 mới hơn và linh hoạt hơn giao diện token FA1.2 trước đó.Số 2 xác định nhóm tiêu chuẩn, không phải phiên bản token do từng nhà phát hành tự chọn.Dự án không thể trở nên tương thích với FA2 chỉ bằng cách thêm “FA2” vào tên hoặc metadata của token.Hợp đồng thông minh phải triển khai các giao diện và hành vi TZIP-12 bắt buộc.

Tại sao Tezos cần tiêu chuẩn token?

Blockchain cho phép nhà phát triển viết nhiều hợp đồng thông minh khác nhau, nhưng các giao diện token hoàn toàn khác biệt sẽ gây khó khăn cho việc tích hợp.Ví sẽ cần mã tùy chỉnh cho từng hợp đồng token nếu mỗi hợp đồng sử dụng các hàm chuyển và kiểm tra số dư khác nhau.Marketplace cũng phải tìm hiểu quy trình phê duyệt riêng cho từng bộ sưu tập NFT.FA2 cung cấp các entrypoint và cấu trúc dữ liệu dễ dự đoán, giúp giảm khó khăn trong tích hợp.Ví tương thích có thể nhận biết cách yêu cầu số dư hoặc chuẩn bị giao dịch chuyển mà không cần hiểu mọi chi tiết lưu trữ nội bộ.Marketplace tương thích có thể yêu cầu quyền operator theo quy trình tiêu chuẩn hóa.Trình khám phá blockchain hoặc indexer có thể nhận diện các lần chuyển token và sắp xếp số dư theo địa chỉ hợp đồng cùng token ID.Tiêu chuẩn hóa cải thiện khả năng tương tác, nhưng không đảm bảo mọi hợp đồng sử dụng giao diện này đều an toàn hoặc trung thực.

Tài liệu token của Tezos cảnh báo rằng bất kỳ ai cũng có thể tạo hợp đồng token và xác định hành vi có khả năng gây hại hoặc hạn chế.

Token FA2 hoạt động như thế nào?

Token FA2 do hợp đồng thông minh được triển khai trên Tezos kiểm soát.Hợp đồng lưu một sổ cái thể hiện quyền sở hữu hoặc số dư token.Đối với token có thể thay thế, sổ cái thường ánh xạ một tài khoản và token ID với một số lượng.Đối với NFT, sổ cái có thể ánh xạ token ID duy nhất với chủ sở hữu hoặc ghi nhận số dư bằng một của chủ sở hữu đó.Khi chuyển token, hợp đồng FA2 kiểm tra quyền của người gửi và số dư khả dụng.Sau đó, hợp đồng trừ token khỏi tài khoản nguồn và cộng vào tài khoản đích.Hợp đồng thông minh cũng có thể áp dụng các hạn chế tùy chỉnh trước khi chấp nhận giao dịch chuyển.Ví dụ, token có thể chỉ cho phép chủ sở hữu chuyển, hỗ trợ operator được phê duyệt, tạm dừng chuyển hoặc cấm hoàn toàn việc chuyển.Mọi thay đổi trạng thái hợp lệ đều được ghi nhận trên Tezos và có thể được kiểm tra bằng các công cụ blockchain tương thích.

Token FA2 được nhận diện như thế nào?

Token FA2 được nhận diện duy nhất bằng kết hợp địa chỉ hợp đồng thông minh và token ID.Token ID là số nguyên không âm do hợp đồng gán.Hai token có thể dùng cùng token ID nếu thuộc các hợp đồng FA2 khác nhau, vì địa chỉ hợp đồng giúp phân biệt chúng.Do đó, chỉ mô tả token là token ID 0 thì chưa đủ để nhận diện duy nhất.Người dùng cũng phải xác nhận địa chỉ hợp đồng.Nếu hợp đồng FA2 chỉ hỗ trợ một loại token, theo tiêu chuẩn token ID phải là 0.Nếu hợp đồng quản lý nhiều loại token, hợp đồng có thể gán các token ID riêng cho từng tài sản.

Tổng quan về FA2 của SmartPy xác nhận địa chỉ hợp đồng và token ID tạo thành mã định danh on-chain đầy đủ của token.

FA2 hỗ trợ những loại token nào?

Token có thể thay thế

Token có thể thay thế gồm các đơn vị có thể hoán đổi cho nhau, với cùng thuộc tính và giá trị trong hợp đồng.Thông thường, một đơn vị có thể được đổi lấy một đơn vị khác của cùng token mà không làm thay đổi vị thế kinh tế của người nắm giữ.Token FA2 có thể thay thế có thể đại diện cho tài sản thanh toán, đơn vị quản trị, điểm thưởng khách hàng thân thiết, tài sản có giá trị ổn định, tài sản wrapped hoặc các loại tiền mã hóa có thể chia nhỏ khác.Trường decimals trong metadata cho ví biết vị trí đặt dấu thập phân khi hiển thị, nhưng số dư được lưu dưới dạng đơn vị nguyên không âm.

Token không thể thay thế

NFT FA2 đại diện cho một token riêng biệt được nhận diện bằng token ID duy nhất.Token có thể gắn với tác phẩm nghệ thuật kỹ thuật số, vật phẩm trò chơi, tư cách thành viên, chứng chỉ, quyền truy cập sự kiện hoặc hồ sơ về thế giới thực.Metadata có thể mô tả nội dung đa phương tiện, người tạo, thuộc tính và thông tin khác liên quan đến NFT.Quyền sở hữu NFT không tự động chuyển giao bản quyền, quyền sở hữu trí tuệ hoặc quyền sở hữu pháp lý đối với vật thể off-chain.Các quyền đó phụ thuộc vào điều khoản của nhà phát hành và luật áp dụng.

Hợp đồng đa tài sản

Một hợp đồng FA2 có thể quản lý nhiều token ID khác nhau.Một trò chơi có thể dùng một hợp đồng cho tiền tệ, vũ khí, vật phẩm đất đai, tài sản nhân vật và phần thưởng sưu tầm.Dự án NFT có thể quản lý cả bộ sưu tập từ một hợp đồng.Ứng dụng tài chính có thể phát hành một số tài sản có liên quan thông qua cùng giao diện.Sử dụng một hợp đồng có thể đơn giản hóa thao tác hàng loạt và giảm số hợp đồng riêng biệt mà ứng dụng cần tích hợp.

Hợp đồng token kết hợp

Hợp đồng FA2 có thể kết hợp các hành vi token khác nhau trong cùng một triển khai.Ví dụ, một token ID có thể đại diện cho tài sản có thể thay thế, trong khi các ID khác đại diện cho NFT độc nhất.Dự án cũng có thể kết hợp tài sản chuyển nhượng được và không thể chuyển nhượng theo các chính sách được xác định cẩn thận.Ứng dụng không được mặc định mọi token ID trong cùng một hợp đồng FA2 có nguồn cung, decimals, quy tắc chuyển hoặc metadata giống nhau.

Token không thể chuyển nhượng

FA2 hỗ trợ tài sản không thể tự do chuyển nhượng sau khi phát hành.Các token này có thể đại diện cho thông tin xác thực, huy hiệu, danh tiếng, giấy phép hoặc hồ sơ gắn với một tài khoản.Giao dịch chuyển có thể thất bại với lỗi chuẩn FA2_TX_DENIED khi chính sách của hợp đồng chặn việc chuyển.Người dùng nên xác minh quy tắc chuyển trước khi nhận token, vì số dư hiển thị trong ví không chứng minh rằng tài sản có thể được bán hoặc di chuyển.

Các entrypoint FA2 bắt buộc là gì?

Hợp đồng tương thích với FA2 phải cung cấp ba entrypoint tiêu chuẩn có tên transfer, balance_of và update_operators.Các entrypoint này tạo nên giao diện chung mà ứng dụng bên ngoài sử dụng.Nhà phát triển có thể bổ sung entrypoint khác, nhưng tính năng bổ sung không thay thế các giao diện bắt buộc.

Tài liệu entrypoint FA2 của SmartPy giải thích tham số và hành vi dự kiến của các thao tác này.

Entrypoint transfer

Entrypoint transfer chuyển token từ một tài khoản sang một hoặc nhiều tài khoản đích.Mỗi mục chuyển chỉ định địa chỉ nguồn, địa chỉ đích, token ID và số lượng.Entrypoint chấp nhận các lô giao dịch thay vì giới hạn mỗi lần gọi ở một giao dịch chuyển.Một lô có thể gồm nhiều giao dịch chuyển liên quan đến các tài khoản và token ID khác nhau.Hợp đồng xác minh từng token được tham chiếu có tồn tại hay không.Hợp đồng cũng xác minh tài khoản nguồn có đủ token và bên gọi có quyền chuyển chúng hay không.Giao dịch sẽ thất bại nếu không đáp ứng điều kiện bắt buộc.

Entrypoint balance_of

Entrypoint balance_of yêu cầu số dư của một hoặc nhiều cặp tài khoản và token ID.Entrypoint sử dụng hợp đồng callback để nhận thông tin số dư được yêu cầu.Cơ chế callback này cho phép một hợp đồng thông minh khác yêu cầu số dư và nhận kết quả thông qua một thao tác nội bộ trên Tezos.Khi phù hợp, ứng dụng off-chain cũng có thể dùng indexer hoặc view tiêu chuẩn hóa.Truy vấn số dư phải xác định cả địa chỉ chủ sở hữu lẫn token ID.Chỉ biết địa chỉ tài khoản là chưa đủ khi một hợp đồng quản lý nhiều loại token.

Entrypoint update_operators

Entrypoint update_operators cho phép chủ sở hữu token thêm hoặc xóa operator được ủy quyền.Mỗi quyền ủy quyền xác định chủ sở hữu, operator và token ID.Thông thường, chỉ chủ sở hữu token mới có thể thay đổi quyền của operator đối với token của mình.Hợp đồng có thể từ chối việc cập nhật operator nếu chính sách chuyển của hợp đồng không hỗ trợ operator.Nên xóa quyền operator khi marketplace, trò chơi hoặc ứng dụng không còn cần quyền đó.

Chuyển token theo lô là gì?

Chuyển theo lô cho phép thực hiện nhiều lần chuyển token trong một lần gọi entrypoint transfer.Một lô duy nhất có thể gửi một loại token đến nhiều người nhận.Lô này cũng có thể chuyển nhiều token ID do cùng một hợp đồng quản lý.Cấu trúc này có thể giảm số lần ví yêu cầu xác nhận và số lần gọi hợp đồng lặp lại.Cách này đặc biệt hữu ích cho trò chơi, bộ sưu tập NFT, phân phối tài sản kho bạc và ứng dụng quản lý nhiều loại tài sản.Toàn bộ thao tác trên Tezos tuân theo quy tắc thực thi nguyên tử.Nếu một giao dịch chuyển bắt buộc trong lời gọi thất bại, quá trình thực thi hợp đồng liên quan sẽ không để lại trạng thái hoàn tất một phần.Tuy vậy, ứng dụng nên giới hạn kích thước lô vì thao tác lớn hơn cần nhiều tài nguyên tính toán và xử lý lưu trữ hơn.

Operator FA2 là gì?

Operator là tài khoản hoặc hợp đồng thông minh được ủy quyền chuyển một loại token cụ thể thay mặt chủ sở hữu.Người dùng có thể ủy quyền cho marketplace làm operator để marketplace hoàn tất giao dịch bán sau khi người mua chấp nhận đề nghị.Quyền operator gắn với chủ sở hữu, địa chỉ operator và token ID.Quyền ủy quyền không tự động áp dụng cho mọi token trong ví của chủ sở hữu.Tuy nhiên, đối với token ID được chỉ định, theo mô hình operator tiêu chuẩn, operator thường có thể chuyển bất kỳ số lượng nào mà chủ sở hữu nắm giữ.Đây không phải là hạn mức số lượng cố định bị giảm sau mỗi lần chuyển.Điều này giúp việc phê duyệt operator thuận tiện, nhưng cũng tạo ra rủi ro nếu ứng dụng được phê duyệt có hành vi độc hại hoặc bị xâm nhập.Chủ sở hữu có thể xóa operator thông qua entrypoint update_operators nếu chính sách của hợp đồng hỗ trợ thao tác đó.

Chính sách chuyển FA2 hoạt động như thế nào?

FA2 cho phép hợp đồng xác định các chính sách quyền khác nhau trong khi vẫn giữ giao diện chuyển dùng chung.Tiêu chuẩn có thể quy định việc chuyển có được hỗ trợ hay không và có cho phép operator hay không.

Tài liệu về chính sách chuyển của SmartPy trình bày các mô hình chính sách phổ biến cho triển khai FA2.

Chính sách không cho phép chuyển

Chính sách này ngăn chủ sở hữu token và operator chuyển các token bị áp dụng.Mô hình này có thể hỗ trợ thông tin xác thực, hồ sơ nhận dạng, huy hiệu và các tài sản khác gắn với tài khoản.

Chính sách chỉ chủ sở hữu được chuyển

Chính sách này cho phép chủ sở hữu chuyển token của mình nhưng không hỗ trợ operator.Marketplace phụ thuộc vào quyền ủy quyền của operator có thể không hoạt động được với các token này.

Chính sách chủ sở hữu hoặc operator

Chính sách này cho phép chủ sở hữu token hoặc operator được phê duyệt chuyển token.Đây là mô hình phổ biến đối với token và NFT có thể giao dịch.

Chuyển có thể tạm dừng

Triển khai FA2 tùy chỉnh có thể cho phép quản trị viên tạm dừng hoạt động chuyển và operator.Việc tạm dừng có thể giúp ứng phó với sự cố bảo mật.Đồng thời, quyền này trao cho quản trị viên khả năng kiểm soát đáng kể việc người nắm giữ có thể di chuyển tài sản hay không.Người dùng nên xác minh có cơ chế tạm dừng hay không, ai kiểm soát cơ chế đó và liệu quyền này có thể bị loại bỏ hay không.

FA2 có bắt buộc phải mint token không?

Không, FA2 không yêu cầu entrypoint mint.Hợp đồng có thể khởi tạo toàn bộ token khi được triển khai và không cung cấp phương thức tạo thêm token.Một triển khai khác có thể bao gồm hàm mint do quản trị viên kiểm soát.Trò chơi có thể mint vật phẩm mới khi người chơi hoàn thành các hành động cụ thể.Hợp đồng NFT có thể mint token ID mới cho từng vật phẩm sưu tầm mới.

Hướng dẫn mint và burn của Tezos giải thích cách bổ sung tính năng tùy chọn thông qua thư viện hợp đồng.

Nhà đầu tư nên xem xét quyền mint thực tế, thay vì mặc định FA2 thiết lập nguồn cung tối đa cố định.

FA2 có bắt buộc phải burn token không?

Không, entrypoint burn cũng là tùy chọn.Burn token sẽ loại bỏ vĩnh viễn các đơn vị token theo quy tắc kế toán của hợp đồng.Hợp đồng có thể cho phép người dùng burn token của chính họ.Hợp đồng khác có thể giới hạn quyền burn cho quản trị viên hoặc không cung cấp cơ chế burn.Quyền burn ảnh hưởng đến nguồn cung, quy đổi, cơ chế trò chơi và tokenomics.Có hàm burn không đảm bảo tài sản giảm phát vì lượng mint có thể vượt lượng burn.

Metadata token FA2 hoạt động như thế nào?

Metadata token mô tả thông tin gắn với một token ID cụ thể.Các trường thường gặp gồm tên token, ký hiệu, decimals, mô tả và liên kết đến nội dung đa phương tiện.

Tài liệu metadata token FA2 giải thích mỗi token ID được liên kết với một đối tượng metadata riêng.

Metadata có thể được lưu trực tiếp trong hợp đồng hoặc được tham chiếu qua URI bên ngoài.Metadata NFT thường được lưu trong tài liệu JSON mà hợp đồng tham chiếu đến.Hệ thống tệp liên hành tinh (IPFS) thường được dùng để cung cấp nơi lưu trữ dựa trên địa chỉ nội dung cho các tài liệu và tệp đa phương tiện này.Liên kết metadata bên ngoài không đảm bảo thông tin được liên kết sẽ luôn khả dụng.Nên pin và sao lưu tệp để giảm nguy cơ tệp biến mất.

Các trường metadata tiêu chuẩn là gì?

Trường name cung cấp tên hiển thị của token.Trường symbol cung cấp mã định danh ngắn được ví và ứng dụng sử dụng.Trường decimals cho giao diện biết cách hiển thị số dư token có thể thay thế.Khóa metadata trống có thể dẫn đến một tài liệu JSON bên ngoài chứa thông tin bổ sung.Các trường tùy chỉnh có thể mô tả tác phẩm, thuộc tính, người sáng tạo, điều khoản cấp phép hoặc dữ liệu dành riêng cho ứng dụng.Ví có thể bỏ qua các trường tùy chỉnh không xác định.Metadata cải thiện cách hiển thị nhưng không ghi đè sổ cái thực tế hoặc logic chuyển của hợp đồng.Token có thể hiển thị tên hoặc ký hiệu quen thuộc nhưng được phát hành bởi một hợp đồng không liên quan.Địa chỉ hợp đồng và token ID vẫn là các mã định danh kỹ thuật đáng tin cậy.

Metadata token và metadata hợp đồng

Metadata token mô tả một token ID riêng lẻ.Metadata hợp đồng mô tả chính hợp đồng thông minh FA2.Metadata hợp đồng có thể nêu tên, phiên bản, tác giả, giao diện, thông tin mã nguồn và các view khả dụng của hợp đồng.

Metadata hợp đồng TZIP-16 cung cấp cấu trúc tiêu chuẩn để công bố thông tin này on-chain hoặc qua URI bên ngoài.

Hợp đồng đa tài sản có thể có một tài liệu metadata hợp đồng và nhiều đối tượng metadata token riêng biệt.Ứng dụng không nên nhầm tên hiển thị của hợp đồng với tên của từng token do hợp đồng đó quản lý.

Trường decimals có nghĩa là gì?

Trường decimals kiểm soát cách ứng dụng hiển thị số dư nguyên của token.Giả sử hợp đồng ghi nhận số dư thô là 1,000,000 và token có sáu chữ số thập phân.Ví sẽ hiển thị số dư đó là 1.000000 token.Hợp đồng vẫn lưu số dư dưới dạng số nguyên không âm, chứ không phải giá trị dấu phẩy động.NFT thường có decimals bằng 0 vì mỗi đơn vị không thể chia nhỏ.Giá trị decimals không chính xác có thể khiến ví hiển thị số lượng gây hiểu nhầm.Decimals không xác định giá thị trường hoặc nguồn cung tối đa của token.

FA2 và tez

Tez là tiền mã hóa gốc của blockchain Tezos.Token FA2 là tài sản do hợp đồng thông minh quản lý.Số dư tez thuộc hệ thống kế toán tài khoản của giao thức, trong khi số dư FA2 là bản ghi trong bộ nhớ của hợp đồng token.Phí giao dịch mạng lưới được thanh toán bằng tez ngay cả khi người dùng chuyển token FA2.Nắm giữ token FA2 không tự động cung cấp đủ tez để thanh toán giao dịch on-chain.Vì vậy, ví có thể hiển thị số dư token có giá trị nhưng người dùng không thể di chuyển token cho đến khi tài khoản nhận đủ tez để trả phí và chi phí lưu trữ.

FA2 và FA1.2

FA1.2 là giao diện token Tezos trước đây, được thiết kế cho token có thể thay thế.FA2 hỗ trợ nhiều loại tài sản hơn, bao gồm token có thể thay thế, NFT, token không thể chuyển nhượng và hợp đồng đa tài sản.FA2 cũng sử dụng token ID và các thao tác theo lô.Mô hình operator khác mô hình hạn mức số lượng vì operator FA2 được phê duyệt thường có thể chuyển số dư khả dụng của chủ sở hữu đối với token ID được chỉ định.Token FA1.2 không tự động trở thành token FA2.Nếu nhà phát hành chọn chuyển đổi tiêu chuẩn, việc di chuyển đòi hỏi quy trình chuyển đổi hợp đồng và tài sản có chủ đích.Cả hai tiêu chuẩn đều có thể tiếp tục tồn tại trên Tezos.

FA2 và NFT

FA2 là giao diện token, còn NFT là loại tài sản không thể thay thế.NFT trên Tezos có thể được triển khai thông qua hợp đồng tương thích FA2.Tuy nhiên, không phải token FA2 nào cũng là NFT.Cùng một tiêu chuẩn có thể quản lý số dư có thể thay thế thông thường và nhiều mô hình token khác.Gọi một tài sản là FA2 cho biết giao diện kỹ thuật của tài sản đó, nhưng không mô tả đầy đủ đặc điểm kinh tế.

FA2 và hợp đồng đa tài sản

FA2 cho phép tạo hợp đồng đa tài sản, nhưng hợp đồng FA2 không nhất thiết phải chứa nhiều loại token.Hợp đồng token có thể thay thế đơn lẻ vẫn có thể tuân theo FA2.Hợp đồng NFT chỉ có một bộ sưu tập cũng có thể tuân theo FA2.Hỗ trợ nhiều tài sản là khả năng của tiêu chuẩn, chứ không phải yêu cầu mà mọi triển khai đều phải sử dụng.

Ví hiển thị token FA2 như thế nào?

Ví có thể sử dụng địa chỉ hợp đồng, token ID, thông tin sổ cái, metadata và dữ liệu indexer để hiển thị tài sản FA2.Ví có thể hiển thị tên, ký hiệu, số dư, hình ảnh và tùy chọn chuyển token.Một số token có thể không tự động xuất hiện nếu thiếu metadata hoặc ví chưa index hợp đồng.Không thấy token hiển thị không nhất thiết có nghĩa là số dư on-chain bằng 0.Người dùng nên xác nhận địa chỉ hợp đồng, token ID và dữ liệu blockchain qua trình khám phá hoặc indexer tương thích.Không nên coi giao diện ví là nguồn xác nhận cuối cùng nếu giao diện đó không khớp với dữ liệu lưu trữ thực tế của hợp đồng.

Marketplace sử dụng operator FA2 như thế nào?

Marketplace có thể yêu cầu chủ sở hữu token thêm hợp đồng marketplace làm operator.Quyền này cho phép marketplace chuyển token được chỉ định sau khi giao dịch bán hoàn tất.Chủ sở hữu không cần ký một giao dịch chuyển token riêng đúng vào thời điểm người mua chấp nhận niêm yết.Marketplace chỉ nên sử dụng quyền này theo quy tắc bán đã công bố.Marketplace độc hại có thể tìm cách chuyển token trái phép trong khi quyền phê duyệt còn hiệu lực.Người dùng nên xác minh địa chỉ operator trước khi phê duyệt.Họ cũng nên xóa quyền của những ứng dụng không còn tin cậy hoặc sử dụng.

Lỗi tiêu chuẩn FA2 là gì?

FA2 định nghĩa tên lỗi tiêu chuẩn để ví và ứng dụng phi tập trung có thể diễn giải nhất quán các lỗi phổ biến.

Tài liệu lỗi FA2 liệt kê các nhóm lỗi tiêu chuẩn được những triển khai tương thích sử dụng.

FA2_TOKEN_UNDEFINED nghĩa là token ID được yêu cầu không tồn tại trong hợp đồng.FA2_INSUFFICIENT_BALANCE nghĩa là nguồn không sở hữu đủ token cho giao dịch chuyển được yêu cầu.FA2_NOT_OPERATOR nghĩa là bên gọi không có quyền chuyển token của chủ sở hữu.FA2_NOT_OWNER nghĩa là một tài khoản khác đã yêu cầu thao tác chỉ dành cho chủ sở hữu.FA2_TX_DENIED nghĩa là chính sách của hợp đồng đã từ chối giao dịch chuyển.FA2_OPERATORS_UNSUPPORTED nghĩa là hợp đồng không cho phép hành vi operator được yêu cầu.Hợp đồng có thể định nghĩa thêm lỗi tùy chỉnh cho các tính năng ngoài tiêu chuẩn.

Rủi ro bảo mật của token FA2

Tương thích FA2 không đảm bảo hợp đồng thông minh an toàn.Hợp đồng có thể chứa lỗi khiến số dư thay đổi không chính xác hoặc cho phép mint trái phép.Quản trị viên có thể có quyền tạm dừng chuyển token, mint token không giới hạn, sửa metadata hoặc kiểm soát hành vi quan trọng khác.Hợp đồng độc hại có thể hiển thị tên token quen thuộc nhưng áp dụng quy tắc kinh tế không liên quan.Quyền operator có thể khiến tài sản gặp rủi ro nếu người dùng phê duyệt ứng dụng không an toàn.Metadata bên ngoài có thể biến mất hoặc thay đổi nếu không được lưu bằng phương thức bảo vệ tính toàn vẹn.Entrypoint tùy chỉnh chưa được xác minh có thể tạo ra hành vi mà giao diện ví tiêu chuẩn không thể hiện.Người dùng nên xem xét địa chỉ hợp đồng, mã nguồn, lịch sử kiểm toán, quyền mint, chính sách chuyển, nơi lưu metadata và quyền của quản trị viên.

Rủi ro từ quyền operator

Quyền operator FA2 có sức ảnh hưởng lớn vì quyền này gắn với token ID, chứ không giới hạn ở một lượng nhỏ dùng một lần.Trong khi quyền ủy quyền còn hiệu lực, operator có thể di chuyển số dư khả dụng của chủ sở hữu đối với loại token đó.Ứng dụng lừa đảo có thể ngụy trang yêu cầu cấp quyền operator thành thao tác đăng nhập hoặc kết nối tài khoản vô hại.Người dùng ví nên đọc chi tiết giao dịch và xác minh địa chỉ operator.Ngắt kết nối ví khỏi một trang web không nhất thiết xóa quyền operator trên-chain.Khi cần thu hồi quyền, người dùng phải gửi thao tác xóa operator phù hợp.

Rủi ro về mint và nguồn cung

Tiêu chuẩn FA2 không áp đặt nguồn cung tối đa chung.Nhà phát hành token có thể giữ quyền tạo thêm token.Mint mới có thể làm pha loãng người nắm giữ hiện tại hoặc giảm độ khan hiếm của bộ sưu tập NFT.Khóa quản trị viên bị xâm nhập có thể dẫn đến nguồn cung trái phép nếu quyền mint tập trung.Người dùng nên xác định ai có thể mint, có giới hạn nguồn cung hay không và quyền đó có thể thay đổi hay không.Các tuyên bố trong metadata về nguồn cung cố định cần được đối chiếu với hành vi thực tế của hợp đồng.

Rủi ro hạn chế chuyển token

Token FA2 có thể áp dụng chính sách giới hạn hoặc ngăn hoàn toàn việc chuyển.Vì vậy, token có thể xuất hiện trong ví nhưng không thể bán hoặc gửi đi.Quản trị viên cũng có thể có cơ chế tạm dừng nếu triển khai có tính năng này.Hạn chế chuyển có thể phục vụ các mục đích bảo mật, nhận dạng hoặc tuân thủ hợp pháp.Tuy nhiên, các hạn chế này cũng có thể tạo ra rủi ro lưu ký và thanh khoản ngoài dự kiến cho người nắm giữ.Người dùng nên kiểm tra hoặc xác minh quy tắc chuyển trước khi gán giá trị tài chính cho một token chưa quen thuộc.

Rủi ro metadata và nội dung đa phương tiện

Quyền sở hữu on-chain không đảm bảo quyền truy cập vĩnh viễn vào nội dung đa phương tiện off-chain.NFT có thể tham chiếu đến hình ảnh hoặc tài liệu được lưu trữ ngoài blockchain.Tệp có thể không còn khả dụng khi dịch vụ lưu trữ kết thúc hoặc đối tượng lưu trữ chưa được pin bị xóa.Địa chỉ web có thể thay đổi nội dung được cung cấp trong tương lai.Lưu trữ dựa trên địa chỉ nội dung cải thiện tính toàn vẹn vì thay đổi tệp sẽ làm thay đổi mã định danh nội dung.Tuy nhiên, tính khả dụng vẫn phụ thuộc vào việc có người lưu giữ và cung cấp dữ liệu.Nhà sưu tầm nên xem xét URI metadata, phương thức lưu trữ, mã hash nội dung và kế hoạch sao lưu.

Nhà phát triển có thể tạo hợp đồng FA2 như thế nào?

Nhà phát triển có thể triển khai trực tiếp TZIP-12, nhưng sử dụng thư viện được duy trì có thể giảm lỗi về giao diện và kiểm thử.

Thư viện FA2 của SmartPy cung cấp các lớp cơ sở cho token có thể thay thế, NFT và hợp đồng đơn tài sản.

Thư viện cũng có các mô-đun tùy chọn cho tính năng như quản trị, mint, burn và chính sách chuyển.Nhà phát triển chỉ nên chọn những tính năng dự án cần.Quyền quản trị không được sử dụng có thể làm tăng rủi ro mà không cải thiện chức năng.Mọi entrypoint tùy chỉnh đều phải duy trì hành vi bắt buộc và cách xử lý lỗi theo tiêu chuẩn.Hợp đồng nên được kiểm thử trên môi trường thử nghiệm Tezos trước khi triển khai lên mainnet.

Thực tiễn tốt nhất khi phát triển FA2

Sử dụng chính xác cấu trúc tham số TZIP-12 cho các entrypoint bắt buộc.Kiểm thử giao dịch chuyển đơn lẻ, chuyển theo lô, giao dịch chuyển giá trị bằng 0 và trường hợp số dư không đủ.Kiểm thử mọi thao tác operator được hỗ trợ và không được hỗ trợ.Xác minh token ID chưa được định nghĩa sẽ trả về lỗi phù hợp.Ghi rõ quyền mint, burn, tạm dừng và quyền quản trị.Công bố metadata hợp đồng và token tại các địa điểm ổn định, có bảo vệ tính toàn vẹn.Sử dụng tên lỗi tiêu chuẩn cho những lỗi thuộc phạm vi FA2.Kiểm thử tích hợp ví, indexer, marketplace và ứng dụng.Xem xét mức tăng dung lượng lưu trữ và chi phí giao dịch đối với lô lớn hoặc bộ sưu tập lớn.Thực hiện đánh giá bảo mật độc lập trước khi quản lý tài sản có giá trị.

FA2.1 là gì?

FA2.1 là đề xuất phát triển giao diện token FA2.Tiêu chuẩn này gắn với TZIP-26 và bổ sung các khái niệm như sự kiện, view on-chain, hạn mức chi tiêu hữu hạn và ticket Tezos.

Tài liệu SmartPy hiện tại mô tả FA2.1 là bản dự thảo.

Nhà phát triển không nên mặc định mọi ví hoặc ứng dụng FA2 đều tự động hỗ trợ các tính năng riêng của FA2.1.Hợp đồng FA2 hiện có vẫn là các triển khai riêng biệt và không tự động thay đổi khi có đề xuất mới.Dự án cân nhắc FA2.1 nên nghiên cứu kỹ các cơ chế bổ sung và mức độ hỗ trợ của công cụ hiện tại.

Những hiểu lầm thường gặp về FA2

FA2 không phải là một loại tiền mã hóa.Đây là tiêu chuẩn mà hợp đồng thông minh token có thể triển khai.FA2 không có nghĩa mọi token đều có thể thay thế.FA2 không có nghĩa mọi token đều là NFT.Một hợp đồng FA2 không phải lúc nào cũng quản lý nhiều tài sản.Chỉ token ID không thể nhận diện duy nhất một token FA2.Tương thích FA2 không đảm bảo nguồn cung cố định.Tiêu chuẩn không bắt buộc phải có mint hoặc burn.Operator FA2 không nhất thiết bị giới hạn ở một đơn vị token hoặc một lần chuyển.Metadata không xác định quyền sở hữu hoặc quyền chuyển thực tế.Số dư hiển thị trong ví không chứng minh token có thể được chuyển hoặc bán.Tuân thủ FA2 không chứng minh hợp đồng đã được kiểm toán hoặc không có hành vi độc hại.

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

FA2 trên Tezos có nghĩa là gì?

FA2 là viết tắt của Financial Application 2, một tiêu chuẩn token thống nhất của Tezos được quy định chính thức trong TZIP-12.

FA2 có phải là tiền mã hóa không?

Không. FA2 là giao diện hợp đồng thông minh có thể được dùng để tạo nhiều loại tiền mã hóa và tài sản kỹ thuật số khác nhau.

FA2 chỉ dành cho NFT phải không?

Không. FA2 hỗ trợ token có thể thay thế, NFT, hợp đồng đa tài sản, tài sản không thể chuyển nhượng và mô hình token tùy chỉnh.

Một hợp đồng FA2 có thể chứa nhiều token không?

Có. Một hợp đồng có thể quản lý nhiều token ID với nguồn cung, chủ sở hữu, metadata và hành vi khác nhau.

Token FA2 được nhận diện duy nhất như thế nào?

Token được nhận diện bằng kết hợp địa chỉ hợp đồng Tezos và token ID.

Hợp đồng FA2 chỉ hỗ trợ một token sử dụng token ID nào?

Hợp đồng chỉ hỗ trợ một loại token phải sử dụng token ID 0.

Số dư FA2 được lưu ở đâu?

Số dư được lưu trong sổ cái do hợp đồng thông minh FA2 duy trì.

Token FA2 có được lưu trực tiếp trong ví không?

Ví kiểm soát tài khoản, còn sổ cái của hợp đồng token ghi nhận số dư hoặc quyền sở hữu của tài khoản đó.

Các entrypoint FA2 bắt buộc là gì?

Các entrypoint bắt buộc là transfer, balance_of và update_operators.

Entrypoint transfer làm gì?

Entrypoint này chuyển một hoặc nhiều lượng token từ tài khoản nguồn sang tài khoản đích thông qua giao diện xử lý theo lô.

balance_of làm gì?

Entrypoint này yêu cầu số dư của các cặp tài khoản và token ID rồi gửi kết quả đến hợp đồng callback.

update_operators làm gì?

Entrypoint này cho phép chủ sở hữu token thêm hoặc xóa tài khoản được ủy quyền chuyển các token ID được chỉ định thay mặt họ.

Operator FA2 là gì?

Operator là tài khoản hoặc hợp đồng được ủy quyền di chuyển một loại token cụ thể thuộc về tài khoản khác.

Operator có thể chuyển tất cả token của chủ sở hữu không?

Đối với token ID được ủy quyền, operator thường có thể chuyển số dư khả dụng của chủ sở hữu trong thời gian quyền phê duyệt còn hiệu lực.

Có thể xóa quyền operator FA2 không?

Có. Chủ sở hữu có thể gửi thao tác xóa operator nếu chính sách chuyển của hợp đồng hỗ trợ operator.

Ngắt kết nối ví có xóa quyền operator không?

Không. Ngắt kết nối phiên trên trang web không tự động thu hồi quyền operator on-chain.

Token FA2 có thể không chuyển nhượng được không?

Có. Triển khai FA2 có thể áp dụng chính sách từ chối mọi giao dịch chuyển thông thường.

Hợp đồng FA2 có thể tạm dừng chuyển token không?

Có thể nếu triển khai bao gồm tính năng tạm dừng do quản trị viên kiểm soát.

FA2 có bắt buộc phải có hàm mint không?

Không. Mint là tùy chọn và phụ thuộc vào thiết kế hợp đồng.

FA2 có bắt buộc phải có hàm burn không?

Không. Burn cũng là tính năng tùy chọn.

FA2 có đảm bảo nguồn cung tối đa không?

Không. Giới hạn nguồn cung và quyền mint do từng hợp đồng token quy định.

Metadata token FA2 là gì?

Đây là thông tin gắn với token ID, chẳng hạn tên, ký hiệu, decimals, mô tả và liên kết nội dung đa phương tiện.

Metadata hợp đồng FA2 là gì?

Đây là thông tin về chính hợp đồng thông minh, bao gồm tên, phiên bản, giao diện, thông tin mã nguồn và view.

Trường decimals có tác dụng gì?

Trường này cho ví biết cách hiển thị số dư nguyên của token với dấu thập phân.

Decimals có làm token chia nhỏ được không?

Decimals đưa ra quy ước hiển thị cho các đơn vị nguyên, còn logic chuyển và nguồn cung của hợp đồng quyết định khả năng chia nhỏ thực tế của tài sản.

Phí giao dịch FA2 được thanh toán bằng token không?

Phí giao thức Tezos thường được thanh toán bằng tez ngay cả khi giao dịch chuyển token FA2.

Tez khác token FA2 như thế nào?

Tez là tiền mã hóa gốc của Tezos, còn token FA2 do sổ cái của hợp đồng thông minh quản lý.

FA1.2 và FA2 khác nhau như thế nào?

FA1.2 tập trung vào token có thể thay thế, còn FA2 hỗ trợ nhiều loại token hơn, token ID, chuyển theo lô và hợp đồng đa tài sản.

Ví có thể tự động phát hiện mọi token FA2 không?

Không phải lúc nào cũng vậy, vì việc phát hiện phụ thuộc vào indexer, metadata, hỗ trợ hợp đồng và khả năng tích hợp của ví.

Token FA2 có thể có metadata giả không?

Có. Bất kỳ ai cũng có thể tạo hợp đồng có tên, ký hiệu, hình ảnh hoặc mô tả gây hiểu nhầm.

Tuân thủ FA2 có nghĩa token an toàn không?

Không. Việc tuân thủ chỉ thể hiện khả năng tương thích giao diện, không chứng minh tính bảo mật, giá trị, tính hợp pháp hoặc tình trạng pháp lý.

NFT FA2 có thể mất hình ảnh không?

Có. Nội dung đa phương tiện lưu trữ bên ngoài có thể không còn khả dụng nếu không được lưu giữ hoặc lưu trữ đáng tin cậy.

FA2.1 là gì?

FA2.1 là bản phát triển dự thảo của FA2, đề xuất các tính năng như sự kiện, view on-chain, hạn mức chi tiêu hữu hạn và ticket.

FA2.1 có tự động thay thế FA2 không?

Không. Hợp đồng FA2 hiện có vẫn là các triển khai riêng biệt; việc hỗ trợ các tính năng riêng của FA2.1 phụ thuộc vào tiêu chuẩn và công cụ hiện hành.

Kết luận

FA2 là tiêu chuẩn token thống nhất của Tezos, được quy định trong TZIP-12.Tiêu chuẩn cung cấp giao diện chung cho token có thể thay thế, NFT, tài sản không thể chuyển nhượng, hệ thống token kết hợp và hợp đồng thông minh đa tài sản.Mỗi token FA2 được nhận diện bằng kết hợp địa chỉ hợp đồng và token ID.Tiêu chuẩn yêu cầu các entrypoint transfer, balance_of và update_operators.Thiết kế xử lý theo lô cho phép thực hiện nhiều lần chuyển hoặc yêu cầu thông qua một lần gọi hợp đồng.Quyền operator cho phép ứng dụng chuyển các loại token được chỉ định thay mặt chủ sở hữu, nhưng người dùng cần thu hồi những quyền không còn cần thiết.FA2 cho phép nhà phát triển tự do đáng kể trong việc xác định chính sách chuyển, quy tắc nguồn cung, mint, burn, quản trị và tính năng tùy chỉnh.Tính linh hoạt này hỗ trợ nhiều trường hợp sử dụng crypto, đồng thời khiến việc thẩm định ở cấp hợp đồng trở nên thiết yếu.Trước khi tương tác với một tài sản FA2 chưa quen thuộc, người dùng nên xác minh địa chỉ hợp đồng, token ID, metadata, cơ chế kiểm soát nguồn cung, quy tắc chuyển, quyền operator, mã nguồn và quyền quản trị viên.Tiêu chuẩn FA2 cải thiện khả năng tương thích trong hệ sinh thái Tezos, nhưng không đảm bảo token an toàn, có giá trị, có thể chuyển nhượng hoặc hợp pháp.