Chuyển đến nội dung
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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.json trong registry: mục có kind: "spl_wrapper" và symbol wUSDC. 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 createMyAta trong 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 đủ:

  • balanceOf và totalSupply đọc trạng thái Solana.

  • transfer và transferFrom di chuyển token trên Solana.

  • approve và allowance giữ 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ề true sau 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. isEnabled vẫn true trong 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ặc RomeBridgeWithdraw.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_ata và deposit_from_ata chuyể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:

  1. Đọc isEnabled cho địa chỉ của bạn trên wrapper wUSDC chuẩn từ registry.

  2. Đảm bảo tài khoản token USDC của bạn tồn tại. Lệnh gọi createMyAta trong 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ằng withdraw_to_ata, như trong Ứng dụng tương tự từ MetaMask.

  3. Nếu isEnabled là false, hãy gửi approve_spl quyề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.

  4. Đọc isEnabled lại. Bây giờ nó phải là true.

  5. 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 ApproveChecked instruction thuần.

1. Tại sao hai wrapper trên cùng một mint lại hiển thị cùng số dư ví?

Cả hai đều đọc tài khoản token của ví trên Solana. Một wrapper là một góc nhìn của SPL token, không phải một sổ cái riêng. Chỉ các số dư do hợp đồng nắm giữ mới được theo dõi riêng theo từng wrapper.

2. Một người dùng cung cấp vào vault của bạn, rồi dùng một router yêu cầu quyền riêng của nó approve_spl. Lệnh transferFrom tiếp theo của bạn trả về lỗi SPL 0x4. Tại sao?

Một tài khoản token chỉ có một delegate. Quyền của router đã thay thế quyền của wrapper. Người dùng phải ủy quyền lại cho wrapper, và ứng dụng của bạn nên kiểm tra isEnabled trước khi chuyển khoản.

3. Bạn dùng wrapper pool nào cho một pool thanh khoản mới?

Wrapper chuẩn mà registry chỉ định cho mint đó trên chain đó. Số dư do hợp đồng nắm giữ khác nhau giữa các wrapper.

Tiếp theo

7. Mở ứng dụng EVM của bạn cho ví Solana

Cập nhật lần cuối

Nội dung này có hữu ích không?