Giới Thiệu

Ataulfo là một ứng dụng phi tập trung (dApp) cho phép tạo và quản lý thị trường tài sản thực (RWA) trên blockchain Midnight. Với cả giao diện dòng lệnh (CLI) và giao diện đồ họa (GUI), Ataulfo giúp người dùng tương tác dễ dàng với hợp đồng thông minh đã được triển khai.

Tính Năng Chính

Triển Khai hoặc Tham Gia Thị Trường

• Triển Khai Hợp Đồng Mới: Người dùng có thể triển khai một hợp đồng Ataulfo mới hoặc tham gia vào một hợp đồng đã có bằng cách sử dụng địa chỉ hợp đồng.
• Phí Hoạt Động: Người triển khai sẽ định nghĩa phí hoạt động cho các giao dịch, hợp đồng sẽ thu phí bằng tDUST cho mỗi lần gửi tiền, rút tiền hoặc khi thực hiện một giao dịch.

Mint Tài Sản

• Người triển khai hợp đồng có thể mint các tài sản NFT mới đại diện cho các vật phẩm trong thế giới thực.

Tạo Đề Nghị

• Danh sách tài sản để bán, bao gồm các metadata như vị trí, mô tả và URL hình ảnh.

Hỗ Trợ Các Đại Lý Bất Động Sản

• Các chủ sở hữu tài sản RWA và các bên được phê duyệt (như các đại lý bất động sản) có thể công bố các đề nghị.

Gửi và Rút Tiền

• Người dùng có thể gửi tDUST vào tài khoản thị trường của họ để mua các RWA được cung cấp.
• Họ cũng có thể rút toàn bộ hoặc một phần tDUST đã gửi bất cứ lúc nào về ví của mình.

Mua và Thực Hiện Đề Nghị

• Người dùng có thể mua tài sản được liệt kê bởi người khác. Khi một đề nghị được thực hiện, thanh toán sẽ được gửi trực tiếp từ quỹ thị trường của người mua đến ví của người công bố, và tài sản sẽ được tự động chuyển đến ví của người mua.

Hủy Đề Nghị

• Các đề nghị có thể bị hủy bởi người công bố hoặc chủ sở hữu nếu người công bố là một bên được phê duyệt.

Rút Phí Đã Thu

• Chủ sở hữu hợp đồng có thể rút phí hoạt động đã thu từ các giao dịch trên thị trường, đồng thời duy trì đủ số dư để đảm bảo các khoản gửi của người dùng.

Đồng Bộ Trạng Thái

• Cả CLI và GUI đều giữ cho người dùng đồng bộ với trạng thái hợp đồng trên blockchain Midnight.

Hướng Dẫn Sử Dụng / Hướng Dẫn

Dưới đây là hướng dẫn từng bước để chạy các ứng dụng CLI và GUI:

Yêu Cầu

• Node.js (khuyên dùng v18+)
• npm hoặc yarn
• Docker để chạy máy chủ chứng minh địa phương theo hướng dẫn của tài liệu Midnight Network.
• Tiện ích mở rộng ví Midnight Lace (dành cho sử dụng GUI).
• Công cụ phát triển Compact cần thiết để biên dịch hợp đồng thông minh.

Cấu Trúc Dự Án

api/        # API TypeScript để tương tác với hợp đồng Ataulfo
cli/        # Giao diện dòng lệnh cho người dùng nâng cao và kiểm tra
contract/   # Mã nguồn hợp đồng thông minh (Midnight/Compact)
gui/        # Giao diện web dựa trên React cho người dùng cuối

Bắt Đầu

1. Sao Chép Kho Lưu Trữ

git clone https://github.com/bochaco/ataulfo.git
cd ataulfo

2. Cài Đặt Các Thư Viện Phụ Thuộc

npm install
# hoặc, nếu sử dụng yarn:
# yarn install

3. Biên Soạn Hợp Đồng Ataulfo

cd contract
npm install
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/midnightntwrk/compact/releases/latest/download/compact-installer.sh | sh
npm run compact

4. Chạy Máy Chủ Chứng Minh Midnight

• Theo tài liệu của Midnight để khởi động máy chủ chứng minh địa phương.

5. Chạy CLI với Testnet

cd cli
npm install
npm run testnet-remote

6. Chạy GUI với Testnet

• Khởi động Máy Chủ Backend

cd gui
npm install
npm run build:start

• Mở http://localhost:8080 trong trình duyệt của bạn.
• Đảm bảo bạn đã cài đặt và kết nối tiện ích mở rộng ví Midnight Lace.

Lưu Ý

• Danh sách tài sản (NFT) mà người dùng sở hữu hiện không được hiển thị trong UI/CLI. Để công bố một tài sản trên thị trường, người dùng cần biết ID tài sản/NFT của họ.
• Các tài sản RWA/NFT hiện tại được cung cấp trong thị trường không được chuyển đến hợp đồng, vì điều này chưa được hỗ trợ bởi Midnight.

Bảo Vệ Dữ Liệu Là Tính Năng Cốt Lõi

Ataulfo được thiết kế để bảo vệ quyền riêng tư trong các hoạt động thị trường RWA. Tất cả các thao tác nhạy cảm như mint tài sản, tạo đề nghị, thực hiện đề nghị và quản lý số dư đều được thực hiện dưới dạng giao dịch không biết, đảm bảo rằng các chi tiết (chủ sở hữu đề nghị, chủ sở hữu tài khoản và số dư của họ, v.v.) vẫn được giữ bí mật và chỉ hiển thị cho các bên được ủy quyền.

Các Thực Hành Tốt Nhất

• Luôn kiểm tra kỹ lưỡng các đề nghị trước khi thực hiện giao dịch.
• Giữ cho ví của bạn luôn được bảo mật và không chia sẻ thông tin nhạy cảm.
• Cập nhật thường xuyên các công cụ và thư viện mà bạn đang sử dụng.

Những Cạm Bẫy Thường Gặp

• Không kiểm soát được giá trị của tài sản trước khi thực hiện giao dịch.
• Thiếu thông tin về tài sản khi không biết ID tài sản của mình.

Mẹo Hiệu Suất

• Tối ưu hóa việc gửi và rút tiền bằng cách sử dụng hàm tối ưu.
• Thực hiện kiểm tra trạng thái hợp đồng thường xuyên để đảm bảo không có lỗi xảy ra.

Câu Hỏi Thường Gặp

Ataulfo có tính phí không?

Có, phí hoạt động sẽ được tính cho mỗi giao dịch trong thị trường.

Ai có thể tạo đề nghị trong Ataulfo?

Chủ sở hữu tài sản và các bên được phê duyệt có thể tạo đề nghị.

Có cách nào để bảo vệ thông tin cá nhân không?

Có, tất cả các giao dịch nhạy cảm được thực hiện dưới dạng giao dịch không biết.

Kết Luận

Ataulfo là một giải pháp tuyệt vời cho những ai muốn tham gia vào thị trường tài sản thực mà không cần lo lắng về quyền riêng tư của dữ liệu. Với các tính năng mạnh mẽ và bảo mật, Ataulfo đảm bảo một trải nghiệm giao dịch an toàn và hiệu quả. Nếu bạn là một nhà phát triển hoặc người dùng muốn tìm hiểu thêm, hãy truy cập Github của chúng tôi để bắt đầu ngay hôm nay!