9. Xây dựng một ứng dụng hai làn
Xây dựng một hợp đồng kho tiền mà cả người dùng MetaMask và người dùng ví Solana đều có thể nạp vào và rút ra, và nhìn thấy cùng một số dư từ cả hai phía.
Đây là bài học xây dựng (2. Bạn có thể xây dựng gì liệt kê trường hợp sử dụng). Bạn viết một vault USDC nhỏ, triển khai nó một lần, và dùng nó từ hai ví: MetaMask và một ví Solana. Cuối cùng cả hai người dùng đều có số dư trong cùng một trạng thái hợp đồng.
Bạn sẽ học được gì
Hình dạng của một hợp đồng hai làn: một vault ERC-20 thuần túy.
Các bước theo thứ tự mà mỗi làn thực hiện để nạp và rút.
Vì sao làn Solana có bước nạp vốn và bước quét, còn làn EVM thì không.
Cách chọn giữa lõi Solidity và lõi chương trình Solana.
Cách đo chi phí của từng bước.
Trước khi bạn bắt đầu
Hoàn thành 8. Mở chương trình Solana của bạn cho người dùng EVM. Bài học 7 bao quát làn Solana mà bản dựng này dùng, vì vậy hãy đọc 7. Mở ứng dụng EVM của bạn cho ví Solana trước nếu bạn đã bỏ qua nó.
Có MetaMask trên Hadrian và một ví Solana trên devnet Solana có thể ký các giao dịch v1, cả hai đều được nạp tiền như trong bài học 3 và Vòi cấp tiền.
Đã cài đặt TypeScript SDK (Rome SDK) và Foundry hoặc Hardhat (Triển khai Hợp đồng Solidity).
Bài học
Bước 1. Chọn lõi của bạn
Một ứng dụng hai làn giữ logic lõi ở một phía. Hoặc lõi là Solidity và người dùng Solana truy cập nó thông qua địa chỉ synthetic của họ, hoặc lõi là một chương trình Solana gốc và người dùng EVM truy cập nó qua một router mỏng. Không có cách nào là bắt buộc. Hãy chọn dựa trên code bạn đã có, đội ngũ của bạn và ứng dụng làm gì. Chọn lõi của bạn liệt kê các đánh đổi.
Khóa học này xây dựng hình dạng đầu tiên. Đây là con đường ngắn hơn và dùng bộ công cụ EVM tiêu chuẩn. Nếu thay vào đó bạn đang giữ một chương trình Solana, bài học 8 và Tích hợp một chương trình Solana bao quát ai ký, token di chuyển như thế nào và quy tắc một lối đi. Điểm chính của nó cũng áp dụng cho bài học này: một hợp đồng không thể tự mình di chuyển token của người dùng, nên người dùng phải cấp quyền trước.
Bước 2. Viết vault
Vault lấy token bằng transferFrom và trả lại nó bằng transfer. Không có gì trong đó dành riêng cho Rome.
Hàm tạo nhận địa chỉ wrapper wUSDC. Triển khai nó lên Hadrian như bạn đã làm ở bài học 3, rồi xác minh mã nguồn (Xác minh hợp đồng). Hợp đồng hoàn chỉnh nằm trong Xây dựng một ứng dụng hai làn.
Bước 3. Chạy làn EVM
Người dùng MetaMask nắm giữ USDC dưới dạng gas gốc, còn vault nhận wUSDC. Vì vậy làn này có bốn bước, mỗi bước là một giao dịch bình thường:
Bọc một phần gas thành wUSDC bằng
withdraw_to_atatrên precompile Withdraw.Cấp quyền cho wrapper một lần, nếu
isEnabled(user)là false.approvevault trên wUSDC.nạpvào vault.
Không có bước nạp vốn hay bước quét. Các token đã được bọc vốn đã nằm tại địa chỉ EVM của người dùng. Mã nguồn nằm trong Ứng dụng tương tự từ MetaMask. Địa chỉ precompile nằm ở Precompiles.
Bước 4. Chạy làn Solana
Người dùng Solana nắm giữ SOL và SPL USDC. Mỗi bước là một giao dịch v1 được ví đó ký:
Cấp phát synthetic bằng
create_pda, một lần.Bước nạp vốn: chuyển USDC từ tài khoản token của ví vào tài khoản của synthetic.
Cấp quyền cho wrapper, nếu
isEnabledlà false.approvevault.nạp.
Rút tiền diễn ra theo chiều ngược lại. withdraw trả token về synthetic, và bước quét chuyển chúng về ví riêng của người dùng. Sau một lần rút và quét đầy đủ, số dư token đã nạp của synthetic trở về 0. Đây là các giao dịch tách biệt, nên nếu một lần nạp hoặc một lần quét thất bại, hãy đọc số dư token của synthetic và để người dùng thử lại hoặc quét phần còn lại về. Mã từng bước nằm trong Giá trị VÀO và Giá trị RA.
Giữ bước kiểm tra cấp quyền trong luồng nạp đầu tiên của ứng dụng cho cả hai làn. Một tài khoản token chỉ có một delegate, nên việc cấp quyền sau đó cho một chương trình khác, chẳng hạn một bridge hoặc một router, sẽ thay thế quyền của wrapper. Hãy kiểm tra isEnabled trước mỗi lần nạp thay vì giả định quyền cấp trước đó vẫn còn đó (cần mỗi người dùng đã thực hiện việc này. Xem).
Bước 5. Đo từng bước
Đọc computeUnitsConsumed từ biên lai Solana của từng bước trong làn Solana, như ở bài học 7. Hướng dẫn liệt kê các compute units, byte và tài khoản mà mỗi bước đã dùng trên Hadrian. Mọi bước trong bảng đó đều nằm khá xa dưới ngân sách atomic. Hãy dùng những con số đó làm mốc chuẩn, rồi so sánh với của bạn.
Nếu một bước chạm gần 1,4 triệu compute units hoặc 64 tài khoản, hãy chuyển nó qua relay hoặc đơn giản hóa nó. Xem Ràng buộc và Ngân sách tính toán.
Tự kiểm tra
Làm việc này trên Hadrian và lưu lại các liên kết.
Nạp từ MetaMask. Nạp từ ví Solana.
Đọc
balanceOftrên vault cho cả hai địa chỉ. Mỗi địa chỉ hiển thị khoản nạp của riêng nó. Với người dùng Solana, hãy đọc tại địa chỉ synthetic.Rút từ cả hai. USDC của người dùng Solana đã trở lại ví của chính họ.
Nếu một lần nạp ở làn Solana bị hoàn tác với lỗi SPL 0x4, thì quyền cấp cho wrapper bị thiếu.
Sau đó hãy trả lời:
Phía nào của ứng dụng cần bước nạp vốn, và vì sao?
Synthetic của người dùng Solana giữ gì sau một vòng đi-về đầy đủ?
Tiếp theo
Cập nhật lần cuối
Nội dung này có hữu ích không?