Người tham gia

• Người dùng
• Fireblocks
• Gate (Mô-đun OES)

1. Quy trình khởi tạo không gian làm việc

(Được xử lý bởi Người dùng & Fireblocks)

Bước 1. Người dùng liên hệ Fireblocks – Yêu cầu tạo Không gian làm việc

Người dùng gửi đơn đăng ký đến Fireblocks và Fireblocks tạo một không gian làm việc mới cho người dùng.

Bước 2. Fireblocks định cấu hình Không gian làm việc như Không gian làm việc OES

Fireblocks định cấu hình không gian làm việc để tương thích với chế độ OES của Gate và cho phép các khả năng cần thiết như Ủy quyền, Hủy ủy quyền, Thanh toán phí gas, v.v.

Bước 3. Người dùng tạo Khóa API trên Gate

Người dùng đăng nhập vào nền tảng Gate và tạo khóa API dành riêng cho Fireblocks.
Yêu cầu:

• Phải được tạo bởi Tài khoản chính của 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 không

Bước 4. Người dùng liên kết Khóa API của Gate với Không gian làm việc Fireblocks

Người dùng quay trở lại Fireblocks và liên kết khóa API của Gate trong cài đặt Không gian làm việc.
Sau bước này, Fireblocks có thể tương tác với Gate thay mặt người dùng (ủy quyền, thanh toán, v.v.).

Bước 5. Người dùng bắt đầu ủy quyền cho từng loại tiền được hỗ trợ (kích hoạt tạo ví trong Gate)

Người dùng ủy quyền cho từng loại tiền thanh toán được hỗ trợ bởi Fireblocks.
Các thao tác ủy quyền:

• Kích hoạt Fireblocks → Yêu cầu của Gate
• Gate tự động tạo địa chỉ ví được ánh xạ cho tài sản đó

Lưu ý:

• Lần thử ủy quyền đầu tiên có thể thất bại (ví chưa được khởi tạo) → Lỗi này có thể bỏ qua
• Chờ ~10 phút, sau đó ủy quyền lại để thành công
• Mỗi tài sản thanh toán được hỗ trợ phải được ủy quyền ít nhất một lần để kích hoạt ví.

Tiền nạp của người dùng & Tài sản thế chấp phí gas (Bảo lãnh)

Trong mô hình OES truyền thống, cả hai bên phải nạp tài sản thế chấp trị giá hàng triệu đô la vào ví của bên kia.
Trong chế độ OES tự lưu ký của Fireblocks:

• Gate không yêu cầu người dùng nạp tài sản thế chấp lớn vào Gate.

• Người dùng cần duy trì tài sản chuỗi chính có giá trị tương đương 100 USDT trong Không gian làm việc Fireblocks của riêng mình. (ủy quyền cho Gate)

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

• Tài sản vẫn được tự lưu ký hoàn toàn bên trong Fireblocks và không bao giờ rời khỏi không gian làm việc.

• Người dùng cần duy trì tài sản chuỗi chính trị giá tương đương 50 USDT bên trong Không gian làm việc Fireblocks của riêng mình. (không ủy quyền cho Gate)

• Tổng cộng Cần 150 USDT tài sản thế chấp chuỗi chính

Lợi thế: Yêu cầu tài sản thế chấp giảm từ hàng triệu → ~hàng 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 Không gian làm việc Fireblocks

Mỗi chuỗi thanh toán phải có coin chuỗi chính tương ứng.
Ví dụ:

• ERC → ETH
• BRC → BTC
• Solana → SOL
• Tron → TRX

② Ủy quyền số lượng coin chuỗi chính tương đương 100 USDT cho Gate

Gate sẽ tự động đóng băng khoản tiền này làm tài sản thế chấp phí gas.

③ Duy trì số dư ví được ánh xạ trên Gate ≥ 100 USDT

Điều này đảm bảo Phí Gas khả dụng đủ.

④ Chuẩn bị thêm ~50 USDT coin chuỗi chính

(Trong Không gian làm việc Fireblocks)
Được sử dụng để bao gồm nhiều giao dịch thanh toán.

Loại tiền thanh toán được hỗ trợ & Yêu cầu chuỗi chính

3. Điều kiện tiên quyết thanh toán & Xử lý lỗi

3.1 Báo cáo lỗi thanh toán bởi Gate

Gate có thể cung cấp dữ liệu lỗi về thanh toán có cấu trúc:
Nhưng dữ liệu này được cung cấp cho fireblocks chứ không phải trực tiếp cho khách hàng.
Thông tin được cung cấp:

1. Loại tiền thanh toán
2. Số lượng thanh toán
3. Mạng thanh toán (ERC / BRC / Solana / Tron)
4. Tài sản chuỗi chính bắt buộc
5. Số lượng chuỗi chính bắt buộc

3.2 Khi thanh toán không thành công (ví dụ: Phí gas không đủ)

Gate trả về cấu trúc lỗi tiêu chuẩn cho Fireblocks.
Tuy nhiên, Fireblocks vẫ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ệ với đại diện hỗ trợ API của bạn để biết nguyên nhân chi tiết.

Ví dụ về 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 bổ sung tài sản chuỗi chính hoặc tăng số dư ví được ánh xạ trên Gate → thử thanh toán lại

Tóm tắt quy trình từ đầu đến cuối

Giai đoạn khởi tạo

1. Người dùng liên hệ Fireblocks
2. Fireblocks tạo Không gian làm việc
3. Fireblocks định cấu hình nó như Không gian làm việc OES
4. Người dùng tạo Khóa API của Gate
5. Người dùng liên kết Khóa API trong Fireblocks
6. Người dùng ủy quyền cho mỗi loại tiền tệ được hỗ trợ (lần thử đầu tiên không thành công → đợi 10 phút → thử lại)

Giai đoạn thế chấp phí gas

1. Người dùng nạp coin chuỗi chính vào Không gian làm việc Fireblocks
   2.Người dùng ủy quyền coin chuỗi chính trị giá tương đương 100 USDT cho Gate (đã đóng băng).
2. Duy trì số dư ví được ánh xạ Gate ≥ 100 USDT
3. Duy trì tài sản chuỗi chính ~50 USDT trong Không gian làm việc để thanh toán lặp lại

Giai đoạn thanh toán

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