Thiết kế: EVM & Biconomy Integration

Tài liệu này mô tả thiết kế của lớp trừu tượng EVM và tích hợp Account Abstraction (AA) qua Biconomy.

1. Kiến trúc Account Abstraction

flowchart LR
    User["User (Signer)"] --> Nest["Blockchain Service"]
    Nest --> Biconomy["Biconomy SDK"]
    Biconomy --> Paymaster["Paymaster\n(Gas Sponsor)"]
    Biconomy --> Bundler["Bundler\n(UserOp Relay)"]
    Bundler --> Chain["EVM Chain"]

2. Các thành phần logic

• SmartAccountClient: Được tạo từ Private Key (giải mã từ Key Vault) kết hợp với bundlerUrl và paymasterApiKey.
• Erc1155Util / Erc721Util / Erc20Util: Các lớp tiện ích sử dụng Ethers.js để thực hiện các giao dịch chuẩn on-chain khi không dùng AA.
• Gasless Worker: BiconomyProcessor lắng nghe các job từ redis và thực hiện gọi Biconomy SDK để gửi UserOperation.

3. Quy trình thực hiện Gasless NFT Transfer

1. Backend gửi yêu cầu chuyển NFT.
2. Blockchain Service lấy private key phù hợp.
3. Khởi tạo Smart Account cho User.
4. Xây dựng Transaction (Transfer instruction).
5. Gửi Transaction qua Biconomy Paymaster để tài trợ phí gas.
6. Đồng bộ trạng thái về Backend.