6. Token ở cả hai phía
Cách một token SPL xuất hiện như một lớp bao bọc ERC-20 cho ví EVM và như một tài khoản token cho ví Solana, cùng quyền cấp một lần cho phép các hợp đồng di chuyển nó.
Token là nền tảng của mọi trường hợp sử dụng trong 2. Bạn có thể xây dựng gì: một pool, một vault hay một thị trường cho vay đều đang di chuyển cùng một tài sản mà các ví Solana nắm giữ. Một SPL wrapper hiển thị một SPL mint thông qua giao diện ERC-20. Với token mà một ví nắm giữ, wrapper đọc số dư trong tài khoản token của ví được suy ra từ Rome, nên Solana và Solidity thấy cùng một số dư. Bài học này giải thích cách điều đó hoạt động và quyền ủy quyền một lần mà mọi người dùng phải cấp trước khi hợp đồng của bạn có thể di chuyển token của họ.
Bạn sẽ học được gì
Cách một SPL wrapper hiển thị số dư token Solana của ví thông qua các phương thức ERC-20.
Factory và wrapper làm gì, và nên dùng wrapper nào.
Token do hợp đồng nắm giữ khác với token do ví nắm giữ như thế nào.
Quyền
approve_splủy quyền một lần, cách kiểm tra nó và cách nó bị vô hiệu.
Trước khi bạn bắt đầu
Hoàn thành 5. Gọi Solana từ Solidity. Bạn cần ý tưởng về PDA có thẩm quyền bên ngoài và precompile Helper.
Hãy có một ví Hadrian đã nạp tiền và một hợp đồng đã triển khai. Các địa chỉ wrapper chuẩn nằm trong
tokens.jsontrong registry: mục cókind: "spl_wrapper"và symbolwUSDC. Hadrian liên kết tới thư mục registry của chain.Tài khoản token USDC bạn đã tạo với
createMyAtatrong bài học 5. Quyền ủy quyền cần nó tồn tại.
Một số dư, hai cách nhìn
Mỗi địa chỉ EVM đều có một PDA có thẩm quyền bên ngoài trên Solana, và PDA đó sở hữu các tài khoản token của địa chỉ ấy. Phương thức balanceOf của ERC-20 wrapper đọc trực tiếp tài khoản token của ví. totalSupply đọc mint.
Bên trong Rome, SPL token của một ví và ERC-20 wrapper của nó đọc cùng một tài khoản token. Một ví Solana nắm giữ USDC và một địa chỉ EVM nắm giữ USDC đều nắm giữ cùng một mint, và cả hai giao dịch trên cùng các tài khoản pool. Đó là cách thanh khoản được giữ ở một nơi trên Rome. Hình và chi tiết nằm trong Tương tác token.
Ví và hợp đồng nắm giữ token khác nhau
Số dư dùng chung áp dụng cho ví. Hợp đồng thì khác. Một hợp đồng không thể gửi quyền ủy quyền một lần mô tả bên dưới thay cho người dùng, nên các wrapper thông thường giữ token của một hợp đồng trong tài khoản token ký quỹ và giữ một sổ cái về tài sản của từng hợp đồng. Các wrapper Token-2022 có hook không giữ sổ cái nào và dùng tài khoản token riêng của hợp đồng.
Có hai điều kéo theo:
Hai wrapper trên cùng một mint hiển thị cùng số dư ví. Chúng có thể không đồng ý về số dư của một hợp đồng, vì mỗi bên giữ sổ cái riêng của mình.
Với pool, vault và thị trường cho vay, hãy dùng wrapper chuẩn mà registry chỉ định cho từng mint trên từng chain. Đừng chọn theo tên.
Một chuyển khoản đến hợp đồng qua wrapper sẽ ghi có vào sổ cái đó. Nó không cấp cho hợp đồng một tài khoản token mà nó có thể chi tiêu từ đó. Các luồng cần hợp đồng hành động trên Solana dùng đường dẫn trong Tích hợp một chương trình Solana.
Factory và wrapper
ERC20SPLFactory triển khai một wrapper cho một SPL mint. Mỗi factory chỉ cho phép một wrapper cho mỗi mint. Wrapper cung cấp một giao diện ERC-20 đầy đủ:
balanceOfvàtotalSupplyđọc trạng thái Solana.transfervàtransferFromdi chuyển token trên Solana.approvevàallowancegiữ các khoản allowance ERC-20 thông thường trong bộ nhớ EVM, vì một tài khoản token không có thứ như vậy.
Bạn hiếm khi triển khai một wrapper. Rome và registry đã có sẵn các wrapper chuẩn cho USDC, ETH và SOL. Bạn chỉ triển khai một cái khi đưa vào một mint mới. Cả hai lệnh gọi factory đều nằm trong Factory. Factory cũng xử lý các mint Token-2022, nhưng các extension của chúng làm thay đổi tích hợp: một wrapper có hook sẽ hoàn nguyên khi gọi transfer và transferFromthông thường, và một mint có phí chuyển khoản có thể nhận ít hơn số bạn gửi. Hãy đọc Các mint Token-2022 trước khi dùng nó trong vault của bạn.
Số lượng phải vừa trong uint64, vì số lượng SPL phải vậy, và wrapper sẽ từ chối bất cứ thứ gì lớn hơn. Token gas có số thập phân riêng, và số dư gas native dùng 18. Việc chuyển đổi giữa chúng phải chính xác. Token gas trên Hadrian và Rubicon là USDC.
Quyền ủy quyền một lần
Wrapper di chuyển token của người dùng với tư cách là SPL delegate của tài khoản token của người dùng. Một tài khoản token phải chỉ định delegate đó trước khi wrapper có thể di chuyển bất cứ thứ gì. Người dùng thực hiện việc này một lần cho mỗi wrapper bằng một lệnh gọi, với số lượng tối đa:
approve_spl(wrapper, type(uint64).max, mint) trên precompile Helper.
Bốn chi tiết quan trọng trong thực tế:
Người dùng gửi nó. Quyền ủy quyền được ký bằng chính tài khoản của người dùng, gửi trực tiếp tới precompile Helper. Hợp đồng của bạn không thể gửi nó thay cho họ. Hãy xây dựng một bước "Enable" vào front end của bạn.
Nó áp dụng cho mọi người. Các ví MetaMask và các địa chỉ tổng hợp của ví Solana đều cần nó, cho mọi wrapper mà họ muốn di chuyển token của chúng.
Hãy kiểm tra nó trước. Phương thức của wrapper
isEnabled(user)trả vềtruesau khi quyền ủy quyền đã được thiết lập. Hãy đọc nó trước một lần chuyển thay vì giả định.Hãy ủy quyền mức tối đa.
isEnabledvẫntruetrong khi bất kỳ phần nào của một quyền ủy quyền có giới hạn còn hiệu lực. Một quyền ủy quyền có giới hạn sẽ làm hỏng các giao dịch chuyển thông thường khi nó sắp cạn, và ứng dụng của bạn sẽ không biết để yêu cầu lại.
Mint cần truyền vào là mint_id() trên wrapper. Một phiên bản front-end mẫu cho cả hai loại ví nằm trong Một lần: cấp quyền cho wrapper.
Cách nó bị vô hiệu
Một tài khoản token chỉ có một delegate. Nếu người dùng ủy quyền cho một bridge hoặc một router, quyền đó sẽ thay thế quyền của wrapper, và wrapper ngừng hoạt động cho người dùng đó. Triệu chứng là một lỗi hoàn nguyên với SPL error 0x4, do chủ sở hữu không khớp. Cách khắc phục là ủy quyền lại cho wrapper. Vì vậy hãy kiểm tra isEnabled trước một luồng phụ thuộc vào wrapper, không phải chỉ một lần lúc đăng ký.
Một phiên bản factory mới mang theo một wrapper mới, và mỗi ví ủy quyền cho cái mới theo cùng cách.
Di chuyển token ra ngoài
Vì số dư wrapper đã chính là số dư SPL, việc chuyển một token ra Solana là một chuyển khoản SPL.
Tới một ví Solana khác từ một ví EVM:
transfer_splđược gửi trực tiếp từ ví tới precompile Helper, hoặcRomeBridgeWithdraw.bridgeOutToSolana, việc này cũng cần một quyền ủy quyền cho hợp đồng bridge. Cả hai đều cần tài khoản token của bên nhận phải tồn tại.Tới ví đã ký giao dịch:
transfer_spl_to_signer. Nó chỉ đến được ví của chính người dùng trên luồng Solana do ví ký. Từ MetaMask, bên ký là proxy payer của Rome, vì vậy hãy dùng hai cách còn lại.Đối với token gas,
withdraw_to_atavàdeposit_from_atachuyển đổi giữa gas native và token trong một tài khoản token.
Trên testnet, Solgate kết nối tài sản Solana với các chuỗi EVM của AggLayer theo cả hai chiều. Đăng ký token SPL là không cần cấp quyền. USDC dùng CCTP. Bài học 10 quay lại các luồng inbound và bridge. Danh sách phương thức nằm trong Nạp và rút.
Tự kiểm tra
Trên Hadrian, với ví bạn đã nạp tiền:
Đọc
isEnabledcho địa chỉ của bạn trên wrapper wUSDC chuẩn từ registry.Đảm bảo tài khoản token USDC của bạn tồn tại. Lệnh gọi
createMyAtatrong bài học 5 đã tạo nó. Nếu bạn đã bỏ qua phần đó, hãy bọc một ít gas thành wUSDC bằngwithdraw_to_ata, như trong Ứng dụng tương tự từ MetaMask.Nếu
isEnabledlàfalse, hãy gửiapprove_splquyền ủy quyền tới precompile Helper. Dùng mã trong hướng dẫn dual-lane được liên kết ở trên.Đọc
isEnabledlại. Bây giờ nó phải làtrue.Tìm giao dịch ủy quyền của bạn trên Qua trình khám phá. Tìm mục SPL Token
ApproveCheckedinstruction thuần.
Tiếp theo
Cập nhật lần cuối
Nội dung này có hữu ích không?