Giao thức
Tham chiếu hợp đồng và trạng thái
Định nghĩa trạng thái chi tiết, quy tắc ký và khả năng API đã công bố.
Mua một cổ phiếu và nắm giữ chỉ số là hai sản phẩm khác nhau
Khác nhau ở tài sản bạn giữ, bên lưu ký và cách thoát vị thế. Giao diện không làm mờ sự khác biệt này.
| Khác biệt | Mua trực tiếptoken trong ví của bạn | Nắm giữ chỉ sốphần sở hữu vault |
|---|---|---|
| Bạn nắm giữ gì | Chính token bStock tại địa chỉ hợp đồng riêng. | Phần sở hữu ERC-20 của vault nắm giữ rổ tài sản. |
| Lưu ký | Ví của bạn. Sau khi hoán đổi, hệ thống của chúng tôi không tiếp xúc với token đó. | Hợp đồng phi lưu ký. Không ví nền tảng nào giữ tài sản người dùng. |
| Cách thoát vị thế | Bán lại qua cùng tuyến khi tuyến có sẵn. | Quy đổi hiện vật theo tỷ lệ: nhận token cơ sở, không phải tiền mặt. |
| Hạn chế của tổ chức phát hành | Áp dụng trực tiếp với bạn. Đóng băng sẽ chặn chuyển token. | Áp dụng cho từng thành phần. Một thành phần bị hạn chế sẽ hoàn tác toàn bộ lần quy đổi. |
| Giá dùng để thao tác | Báo giá có thể thực thi với thời hạn và đầu ra tối thiểu. | Bản xem trước tại khối cố định, không phải cam kết thực thi. |
| Tái cân bằng | Bạn tự thực hiện. Chúng tôi không giữ vị thế hay gửi chỉ dẫn. | Chỉ theo cấu hình đã được đánh giá, dưới quản trị và trong giới hạn cố định. |
| Nên chọn khi | Bạn muốn một mã cổ phiếu và muốn trực tiếp giữ token. | Bạn muốn một chủ đề trong một vị thế, với trọng số được hợp đồng kiểm tra. |
Điểm chung của cả hai
Tài sản được nhận diện bằng mã chuỗi và địa chỉ, không phải ký hiệu. Cùng một chuỗi bằng chứng dùng để tiếp nhận tài sản. Tổ chức phát hành có thể đóng băng hoặc hạn chế cả hai cách; không cách nào bảo đảm thoát vị thế.
Hiện đã mở gì
Thực thi phụ thuộc vào từng cách: phần sở hữu chỉ số cần khả năng hiện tại theo chuỗi của vault đã đăng ký; mua trực tiếp cần tuyến thực thi được và độ sâu đã đo. Địa chỉ cấu hình, bằng chứng thử nghiệm và quyền vận hành chính thức là riêng biệt.
Trạng thái xác minh
Nguồn gốc tài liệu và mã. Không cho biết tài sản có được phép sử dụng hay không.
| Trạng thái kỹ thuật testnet · DISCOVERED | Được nhập làm ứng viên từ nguồn đã lưu trữ. Chưa có thông tin nào được xác nhận. |
| Trạng thái kỹ thuật testnet · SOURCE_REVIEW | Tài liệu của tổ chức phát hành đang được đánh giá. |
| Trạng thái kỹ thuật testnet · ONCHAIN_VERIFIED | Đã ghi nhận bằng chứng về khả năng onchain tại một khối cố định. |
| Trạng thái kỹ thuật testnet · VERIFIED | Nguồn và bằng chứng onchain đều đã được đánh giá, phê duyệt độc lập. |
| Trạng thái kỹ thuật testnet · REVOKED | Phê duyệt trước đó đã bị rút lại. Hãy coi tài sản này là chưa xác minh. |
Quyền thao tác
Tài sản có được phép sử dụng hay không và theo chiều nào. Quyết định này độc lập với việc xác minh.
| Chỉ hiển thị | Chỉ được hiển thị. Không được tạo mức nắm giữ mới hay dùng trong quỹ. |
| Đang hoạt động | Được phép thao tác theo quy tắc hiện tại của sổ đăng ký. |
| Chỉ thoát vị thế | Không được tạo mức nắm giữ mới. Có thể thoát mức nắm giữ hiện có. |
| Tạm dừng | Các thao tác thoát liên quan cũng bị cấm. Thao tác có thể thất bại. |
| Đã thu hồi | Trạng thái cuối. Không được tạo mức nắm giữ mới; chỉ có thể thoát nếu chính token vẫn cho phép chuyển. |
Vì sao cần tách hai trạng thái
Một tài sản có thể đã được xác minh đầy đủ về nguồn nhưng vẫn chỉ được hiển thị; tài sản từng hoạt động cũng có thể bị tạm dừng mà bằng chứng không thay đổi. Gộp hai trạng thái vào một nhãn sẽ che khuất khác biệt giữa “đã kiểm tra tài liệu tổ chức phát hành” và “được phép dùng tài sản này để tạo quỹ”.
Trạng thái khả năng
API trả về 503 CAPABILITY_UNAVAILABLE cho khả năng chưa được triển khai. Giao diện hiển thị đúng là không khả dụng, không thay bằng danh sách rỗng, số dư bằng không hay giao dịch thành công.
| Khả năng | Trạng thái |
|---|---|
| Danh mục sổ đăng ký tài sản | Đã triển khai |
| Nguồn gốc xác minh tài sản | Đã triển khai |
| Nguồn chính thức đã lưu trữ | Đã triển khai |
| Khả năng token tại khối cố định | Đã triển khai |
| Công bố giá tham chiếu | Đã triển khaiCần nguồn giá được cấp phép; trả về 503 cho đến khi có |
| Kiểm tra địa chỉ công khai | Đã triển khai |
| Đăng nhập bằng ví | Đã triển khai |
| Phiên và vai trò | Đã triển khai |
| Thử thách ghi nghiệp vụ | Đã triển khai |
| Tìm chiến lược đã công bố | Đã triển khai |
| Bản nháp chiến lược | Đã triển khai |
| Công bố chiến lược | Đã triển khai |
| Liên kết chia sẻ chỉ đọc | Đã triển khai |
| Kiểm tra dữ kiện xác định | Đã triển khaiCần nguồn giá được cấp phép; trả về 503 cho đến khi có |
| Kiểm thử dữ liệu lịch sử | Đã triển khaiCần nguồn giá được cấp phép; trả về 503 cho đến khi có |
| Danh sách theo dõi cá nhân | Đã triển khai |
| Khả năng chuỗi và triển khai tại thời điểm chạy | Đã triển khai |
| Bản xem trước hiện vật testnet trên chuỗi chuẩn | Đã triển khaiCần địa chỉ hợp đồng đã triển khai |
| Danh mục quỹ đã đăng ký | Đã triển khai |
| Tài sản quỹ tại khối cố định | Đã triển khaiCần ảnh chụp trạng thái tại khối cố định thuộc chuỗi chuẩn; trả về 503 cho đến khi có |
| NAV tham chiếu | Đã triển khaiCần nguồn giá được cấp phép; trả về 503 cho đến khi có |
| Lịch sử NAV thưa | Đã triển khaiCần nguồn giá được cấp phép; trả về 503 cho đến khi có |
| Hoạt động quỹ | Đã triển khaiCần ảnh chụp trạng thái tại khối cố định thuộc chuỗi chuẩn; trả về 503 cho đến khi có |
| Tài sản trong ví | Đã triển khaiCần ảnh chụp trạng thái tại khối cố định thuộc chuỗi chuẩn; trả về 503 cho đến khi có |
| Hoạt động ví | Đã triển khaiCần ảnh chụp trạng thái tại khối cố định thuộc chuỗi chuẩn; trả về 503 cho đến khi có |
| Ý định giao dịch | Đã triển khai |
| Hàng đợi đánh giá tài sản | Đã triển khai |
| Đánh giá nguồn tài sản | Đã triển khai |
| Kích hoạt tài sản | Đã triển khai |
| Đơn đăng ký quỹ bị giới hạn | Đã triển khai |
| Bản ghi quản trị quỹ | Đã triển khai |
| Báo giá rổ tài sản cũ | Chưa có trong hợp đồng APIChưa được khai báo trong hợp đồng API; trả về 503 |
| Báo giá mua rổ tài sản | Đã triển khaiCần nhà cung cấp tuyến được phê duyệt; mặc định trả về 503 và nếu thành công cũng chỉ là mô phỏng |
| Báo giá bán rổ tài sản | Đã triển khaiCần nhà cung cấp tuyến được phê duyệt; mặc định trả về 503 và nếu thành công cũng chỉ là mô phỏng |
| Báo giá nạp vào vault | Đã triển khaiCần nhà cung cấp tuyến được phê duyệt; mặc định trả về 503 và nếu thành công cũng chỉ là mô phỏng |
| Báo giá rút khỏi vault | Đã triển khaiCần nhà cung cấp tuyến được phê duyệt; mặc định trả về 503 và nếu thành công cũng chỉ là mô phỏng |
Cách một yêu cầu ghi nghiệp vụ được cho phép
Phiên đăng nhập xác định danh tính của bạn, không cho phép thay đổi dữ liệu. Mỗi yêu cầu ghi tuần tự hóa phần thân đúng một lần, băm chính xác các byte đó bằng SHA-256, yêu cầu máy chủ cấp thử thách dùng một lần gắn với phương thức, đường dẫn và mã băm, dùng ví ký đúng thông điệp của máy chủ, rồi gửi lại chính các byte đó cùng nonce và chữ ký. Thay đổi dù chỉ một byte, đường dẫn hay phương thức sẽ làm chữ ký mất hiệu lực.
Nonce đã thành công không thể dùng lại và giao diện không âm thầm tạo lại cùng một bản ghi. Nếu mất phản hồi, kết quả được tra cứu theo nonce trước khi thử lại bất kỳ thao tác nào.
Ý nghĩa của đăng nhập bằng ví
Đăng nhập chứng minh bạn kiểm soát một địa chỉ bằng thông điệp do máy chủ tạo. Nó cho phép gọi API trong tám giờ, không cho phép chuyển token, cấp hạn mức hay thao tác quỹ, và không cấp vai trò người đánh giá hoặc người quản trị.
Cách xử lý số lượng
Số lượng token gốc là số nguyên, được truyền dưới dạng BigInt hoặc chuỗi thập phân chính xác. Giao diện không dùng phép tính dấu phẩy động cho số lượng và không áp dụng hệ số nhân cho đến khi hợp đồng công bố thang đo của hệ số đó.
Rủi ro và giới hạn
- Môi trường mainnet chính thức vẫn bị vô hiệu hóa. Triển khai testnet và tài sản thử nghiệm tổng hợp không đáp ứng điều kiện ra mắt chính thức.
- Chưa công bố nguồn giá, NAV tham chiếu hay báo giá có thể thực thi. Bản xem trước không phải cam kết báo giá.
- Bản ghi trong sổ đăng ký được nhập từ dữ liệu khởi tạo là ứng viên. Ứng viên chưa được xác minh và chưa thể giao dịch.
- Tổ chức phát hành cổ phiếu token hóa có thể hạn chế chuyển token. Giao diện này không thể bảo đảm khả năng thoát vị thế của một token bị hạn chế.