Để 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 mô-đun OES của Gate để tách biệt lưu ký và giao dịch. Kiến trúc này giúp tăng cường bảo mật quỹ đồng thời cho phép vận hành giao dịch linh hoạt, hiệu quả.
Việc tích hợp đòi hỏi sự phối hợp giữa ba bên — khách hàng, Fireblocks và Gate. Sau khi hoàn thành khởi tạo Workspace và kích hoạt các tính năng, vui lòng làm theo các bước dưới đây để cấu hình ủy quyền và kết nối nhằm đảm bảo tích hợp thành công.
Các bên tham gia
- Người dùng
- Fireblocks
- Gate (Mô-đun 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 yêu cầu tới 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 Workspace OES
Fireblocks cấu hình workspace để tương thích với chế độ OES của Gate và kích hoạt các tính 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 vào nền tảng Gate và tạo một 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ới 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ể tương tác với Gate thay mặt người dùng (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 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í được á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
- Chờ ~10 phút , sau đó delegate lại để thành công
- Mỗi tài sản thanh toán được hỗ trợ phải delegate ít nhất một lần để kích hoạt ví
2.Người dùng nạp tiền & Ký quỹ phí Gas (Đảm bảo)
Trong mô hình OES truyền thống, cả hai bên phải ký quỹ hàng triệu đô la vào ví của nhau.
Ở chế độ OES tự lưu ký của Fireblocks:
- Gate không yêu cầu người dùng nạp ký quỹ lớn vào Gate.
- Người dùng cần duy trì tài sản trên chuỗi chính tương đương 100 USDT trong Fireblocks Workspace của mình. (delegate cho Gate)
- Gate sẽ đóng băng khoản nhỏ này để chi trả phí Gas cho thanh toán.
- Tài sản vẫn hoàn toàn 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 trên chuỗi chính tương đương 50 USDT trong Fireblocks Workspace của mình. (không delegate cho Gate)
- Tổng cộng cần 150 USDT ký quỹ tài sản chuỗi chính
Ư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 chuỗi chính
① Người dùng nạp tài sản chuỗi chính vào Fireblocks Workspace
Mỗi chuỗi thanh toán phải có đồng coin chuỗi chính tương ứng.
Ví dụ:
- ERC → ETH
- BRC → BTC
- Solana → SOL
- Tron → TRX
② Delegate số lượng coin chuỗi chính tương đương 100 USDT cho Gate
Gate sẽ tự động đóng băng khoản này làm ký quỹ phí Gas .
③ Duy trì số dư ví ánh xạ Gate ≥ 100 USDT
Đảm bảo đủ phí Gas cho thanh toán.
④ Chuẩn bị thêm ~50 USDT coin chuỗi chính
(Trong Fireblocks Workspace)
Dùng để thực hiện nhiều giao dịch thanh toán.
Các loại tiền thanh toán & yêu cầu chuỗi chính đượ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 thanh toán & Xử lý lỗi
3.1 Gate báo cáo lỗi thanh toán
Gate có thể cung cấp dữ liệu lỗi thanh toán có cấu trúc:
Tuy nhiên, dữ liệu này chỉ cung cấp cho fireblocks chứ không gửi trực tiếp tới khách hàng.
Thông tin cung cấp:
- Loại tiền thanh toán
- Số tiền thanh toán
- Mạng lưới thanh toán (ERC / BRC / Solana / Tron)
- Tài sản chuỗi chính yêu cầu
- Số lượng chuỗi chính yêu cầu
3.2 Khi thanh toán 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 thanh toán:
→ Vui lòng liên hệ đại diện hỗ trợ API của bạn để 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ư chuỗi chính không đủ → trả về lỗi
- Người dùng nạp thêm tài sản chuỗi chính hoặc tăng số dư ví ánh xạ Gate → thử lại thanh toán
Tóm tắt quy trình tổng thể từ đầu đến cuối
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 trong Fireblocks
- Người dùng delegate từng loại tiền tệ được hỗ trợ (lần đầu thất bại → chờ 10 phút → thử lại)
Giai đoạn ký quỹ phí Gas
- Người dùng nạp coin chuỗi chính vào Fireblocks Workspace
- Người dùng delegate coin chuỗi chính tương đương 100 USDT cho Gate (bị đóng băng)
- Duy trì số dư ví ánh xạ Gate ≥ 100 USDT
- Duy trì ~50 USDT tài sản chuỗi chính trong Workspace để thực hiện nhiều lần thanh toán
Giai đoạn thanh toán
- Gate tính toán phí gas chuỗi chính cần thiết và khởi tạo thanh toán
- Nếu thiếu phí gas → Gate trả về lỗi chuẩn hóa
- Người dùng nạp thêm phí gas → thử lại thanh toán
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.
