Để hỗ trợ khách hàng tổ chức thiết lập kết nối quản lý tài sản và giao dịch an toàn, hiệu quả giữa Fireblocks và Gate, tài liệu này cung cấp quy trình vận hành tiêu chuẩn (SOP) cho việc tích hợp theo mô hình OES (Off-Exchange Settlement) của Gate.
Quy trình này dành cho người dùng tổ chức đã xác minh và tích hợp Fireblocks Workspace với module OES của Gate nhằm tách biệt lưu ký tài sản và giao dịch. Kiến trúc này tăng cường bảo mật quỹ đồng thời cho phép hoạt động giao dịch linh hoạt, hiệu quả.
Việc tích hợp yêu cầu phối hợp giữa ba bên — khách hàng, Fireblocks và Gate. Sau khi hoàn tất khởi tạo Workspace và kích hoạt các chức năng cần thiết, vui lòng thực hiện các bước dưới đây để cấu hình ủy quyền và kết nối, đảm bảo tích hợp thành công.
Các bên tham gia
- Người dùng
- Fireblocks
- Gate (Module OES)
1. Quy trình khởi tạo Workspace
(Thực hiện bởi Người dùng & Fireblocks)
Bước 1. Người dùng liên hệ Fireblocks – Yêu cầu tạo Workspace
Người dùng gửi đơn đăng ký cho Fireblocks và Fireblocks sẽ tạo một workspace mới cho người dùng.
Bước 2. Fireblocks cấu hình Workspace thành OES Workspace
Fireblocks cấu hình workspace để tương thích với chế độ OES của Gate và bật các chức năng cần thiết như Delegate , Undelegate , Thanh toán phí Gas , v.v.
Bước 3. Người dùng tạo API Key trên Gate
Người dùng đăng nhập nền tảng Gate và tạo API key dành riêng cho Fireblocks.
Yêu cầu:
- Phải được tạo bởi tài khoản chính Gate .
- Tài khoản chính (bao gồm tất cả tài khoản phụ) phải đáp ứng cả hai điều kiện:
- Không có vị thế mở
- Số dư bằng 0
Bước 4. Người dùng liên kết API Key Gate vào Fireblocks Workspace
Người dùng quay lại Fireblocks và liên kết API key Gate trong phần cài đặt Workspace.
Sau bước này, Fireblocks có thể thay mặt người dùng tương tác với Gate (delegate, settlement, v.v.).
Bước 5. Người dùng bắt đầu Delegate từng loại tiền tệ được hỗ trợ (kích hoạt tạo ví trên Gate)
Người dùng thực hiện delegate từng loại tiền thanh toán được Fireblocks hỗ trợ.
Hành động delegate:
- Kích hoạt yêu cầu từ Fireblocks → Gate
- Gate tự động tạo địa chỉ ví ánh xạ cho tài sản đó
Lưu ý:
- Lần delegate đầu tiên có thể sẽ thất bại (ví chưa được khởi tạo) → Có thể bỏ qua lỗi này
- Đợi ~10 phút , sau đó delegate lại để thành công
- Mỗi tài sản thanh toán hỗ trợ phải được delegate ít nhất một lần để kích hoạt ví
2.Người dùng nạp tài sản & Ký quỹ phí Gas (Đảm bảo)
Trong mô hình OES truyền thống, cả hai bên đều phải nạp ký quỹ trị giá hàng triệu đô vào ví của nhau.
Ở chế độ OES tự lưu ký trên Fireblocks:
- Gate không yêu cầu người dùng nạp số ký quỹ lớn vào Gate.
- Người dùng cần duy trì tài sản main-chain trị giá tương đương 100 USDT trong Fireblocks Workspace của mình. （delegate sang gate）
- Gate sẽ đóng băng số tiền nhỏ này để thanh toán phí Gas cho settlement.
- Tài sản hoàn toàn được tự lưu ký trong Fireblocks và không rời khỏi workspace.
- Người dùng cần duy trì tài sản main-chain trị giá tương đương 50 USDT trong Fireblocks Workspace của mình. （không cần delegate sang gate）
- Tổng cộng cần 150 USDT tài sản main chain làm ký quỹ
Ưu điểm: Yêu cầu ký quỹ giảm từ hàng triệu → ~vài trăm USDT .
Chi tiết tài sản Main-Chain
① Người dùng nạp tài sản main-chain vào Fireblocks Workspace
Mỗi chuỗi thanh toán cần có đồng main-chain tương ứng.
Ví dụ:
- ERC → ETH
- BRC → BTC
- Solana → SOL
- Tron → TRX
② Delegate số lượng đồng main-chain tương đương 100 USDT sang Gate
Gate sẽ tự động đóng băng số lượng này làm ký quỹ phí Gas .
③ Duy trì số dư ví ánh xạ Gate ≥ 100 USDT
Đảm bảo luôn đủ phí Gas cho settlement.
④ Chuẩn bị thêm ~50 USDT đồng main-chain
(Trong Fireblocks Workspace)
Dùng để thực hiện nhiều giao dịch settlement.
Các loại tiền thanh toán & yêu cầu Main-Chain được hỗ trợ
| Tiền thanh toán | Chuỗi | Token phí gas |
|---|---|---|
| BTC | BRC | BTC |
| ETH | ERC | ETH |
| OXT | ERC | ETH |
| FET | ERC | ETH |
| BOBA | ERC | ETH |
| ACX | ERC | ETH |
| SAFE | ERC | ETH |
| USDT（ERC） | ERC | ETH |
| USDC (ERC) | ERC | ETH |
| SOL | Solana | SOL |
| TRX | Tron | TRX |
3.Điều kiện trước khi settlement & Xử lý lỗi
3.1 Gate báo cáo lỗi settlement
Gate có thể cung cấp dữ liệu lỗi settlement có cấu trúc:
Tuy nhiên, dữ liệu này chỉ gửi cho fireblocks, không gửi trực tiếp cho khách hàng.
Thông tin cung cấp:
- Loại tiền thanh toán
- Số lượng thanh toán
- Mạng lưới thanh toán (ERC / BRC / Solana / Tron)
- Tài sản main-chain yêu cầu
- Số lượng main-chain yêu cầu
3.2 Khi settlement thất bại (ví dụ: thiếu phí Gas)
Gate trả về cấu trúc lỗi chuẩn hóa cho Fireblocks.
Tuy nhiên, Fireblocks hiện chưa hiển thị đầy đủ các lỗi này.
Nếu người dùng gặp lỗi settlement:
→ Vui lòng liên hệ đại diện hỗ trợ API để biết nguyên nhân chi tiết.
Ví dụ phản hồi lỗi
{
"success": false,
"errors": [
{
"type": "gas_fee_insufficient",
"currency": "USDT",
"network": "ETH",
"message": "Missing gas fee",
"details": {
"available": "0",
"mainCoin": "ETH",
"required": "0.01"
},
"severity": "error"
}
],
"message": "Gas fee insufficient for settlement/withdrawal",
"data": {
"amount": "100.0",
"collateralId": "fb_test_2001",
"currency": "USDT",
"userId": 2001
}
}
Logic của Gate
- Phát hiện số dư main-chain không đủ → trả về lỗi
- Người dùng nạp thêm tài sản main-chain hoặc tăng số dư ví ánh xạ Gate → thử lại settlement
Tóm tắt quy trình tổng thể End-to-End
Giai đoạn khởi tạo
- Người dùng liên hệ Fireblocks
- Fireblocks tạo Workspace
- Fireblocks cấu hình Workspace thành OES Workspace
- Người dùng tạo API Key Gate
- Người dùng liên kết API Key vào Fireblocks
- Người dùng delegate từng loại tiền tệ hỗ trợ (lần đầu thất bại → đợi 10 phút → thử lại)
Giai đoạn Ký quỹ phí Gas
- Người dùng nạp đồng main-chain vào Fireblocks Workspace
- Người dùng delegate số lượng đồng main-chain tương đương 100 USDT sang Gate (bị đóng băng)
- Duy trì số dư ví ánh xạ Gate ≥ 100 USDT
- Duy trì ~50 USDT tài sản main-chain trong Workspace để thực hiện nhiều settlement
Giai đoạn Settlement
- Gate tính toán phí gas main-chain cần thiết và khởi tạo settlement
- Nếu phí gas không đủ → Gate trả về lỗi chuẩn hóa
- Người dùng bổ sung phí gas → thử lại settlement
Nội dung được cung cấp ở đây chỉ mang tính chất tham khảo và cung cấp kiến thức, không cấu thành bất kỳ lời khuyên tài chính, đầu tư, giao dịch hoặc pháp lý nào, cũng như không phải là lời đề nghị hoặc lời mời mua hoặc bán bất kỳ tài sản kỹ thuật số nào. Gate không đưa ra bất kỳ tuyên bố hoặc bảo đảm nào, dù rõ ràng hay ngụ ý, về tính chính xác, đầy đủ hoặc kịp thời của thông tin được cung cấp ở đây. Các tính năng sản phẩm, giao diện, quy tắc và cấu trúc phí có thể được cập nhật hoặc điều chỉnh bất cứ lúc nào. Vui lòng tham khảo các thông báo mới nhất và thông tin thực tế được hiển thị trên nền tảng Gate để biết chi tiết chính xác nhất.
Đầu tư vào tài sản kỹ thuật số tiềm ẩn rủi ro đáng kể và giá cả có thể biến động mạnh. Bạn có thể mất toàn bộ số tiền đầu tư. Vui lòng đưa ra quyết định thận trọng dựa trên tình hình tài chính và khả năng chấp nhận rủi ro của riêng bạn sau khi hiểu đầy đủ các rủi ro liên quan. Nếu cần, bạn nên tham khảo ý kiến của cố vấn tài chính hoặc pháp lý chuyên nghiệp độc lập.
Để biết thêm thông tin về các rủi ro tiềm ẩn, vui lòng tham khảo Tuyên bố về Rủi ro và Thỏa thuận Người dùng của Gate.
