Các bên tham gia

• Người dùng
• Fireblocks
• Gate (Module OES)

1. Quy trình Khởi tạo Workspace

(Được 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ý đến 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à 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 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ả cá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 Workspace Fireblocks

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, thanh toán, 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 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
• Chờ ~10 phút , sau đó delegate lại để thành công
• Mỗi loạ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í

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 đều 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 khoản ký quỹ lớn vào Gate.

• Người dùng cần duy trì lượng tài sản main-chain tương đương 100 USDT trong Workspace Fireblocks của mình. （delegate sang gate）

• Gate sẽ đóng băng khoản nhỏ này để thanh toán phí Gas.

• Tài sản vẫn được tự lưu ký hoàn toàn trong Fireblocks và không rời khỏi workspace.

• Người dùng cần duy trì lượng tài sản main-chain tương đương 50 USDT trong Workspace Fireblocks của mình. （không 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 về Tài sản Main-Chain

① Người dùng nạp tài sản main-chain vào Workspace Fireblocks

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 lượng coin main-chain tương đương 100 USDT sang Gate

Gate sẽ tự động đóng băng số tiền 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 để thanh toán.

④ Chuẩn bị thêm khoảng ~50 USDT coin main-chain

(Trong Workspace Fireblocks)
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 Main-Chain được hỗ trợ

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:
Nhưng 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 gồm:

1. Loại tiền thanh toán
2. Số tiền thanh toán
3. Mạng lưới thanh toán (ERC / BRC / Solana / Tron)
4. Tài sản main-chain yêu cầu
5. Số lượng main-chain yêu cầu

3.2 Khi Thanh toán Thất bại (ví dụ: không đủ 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 để 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ử thanh toán lại

Tóm tắt Quy trình End-to-End

Giai đoạn Khởi tạo

1. Người dùng liên hệ Fireblocks
2. Fireblocks tạo Workspace
3. Fireblocks cấu hình thành OES Workspace
4. Người dùng tạo API Key Gate
5. Người dùng liên kết API Key trong Fireblocks
6. 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

1. Người dùng nạp coin main-chain vào Workspace Fireblocks
2. Người dùng delegate coin main-chain tương đương 100 USDT sang Gate (bị đóng băng)
3. Duy trì số dư ví ánh xạ Gate ≥ 100 USDT
4. Duy trì khoảng ~50 USDT tài sản main-chain trong Workspace cho các giao dịch thanh toán lặp lại

Giai đoạn Thanh toán

1. Gate tính toán lượng gas main-chain cần thiết và khởi tạo thanh toán
2. Nếu không đủ gas → Gate trả về lỗi chuẩn hóa
3. Người dùng nạp thêm gas → thử thanh toán lại