Skip to main content

Webhook Solana là gì?

Webhook Solana là các thông báo HTTP theo thời gian thực được gửi đến ứng dụng của bạn khi có sự kiện trên chuỗi xảy ra. Thay vì liên tục thăm dò blockchain, Helius đẩy dữ liệu giao dịch đã phân tích trực tiếp đến điểm cuối của bạn mỗi khi một ví chuyển tiền, một NFT được bán hoặc bất kỳ loại giao dịch nào đang được giám sát được kích hoạt. Sử dụng webhook để vận hành bot giao dịch, bảng điều khiển phân tích, quy trình tuân thủ và hoạt động tự động hóa theo sự kiện. Chúng tôi cung cấp giao diện thân thiện với người dùng, API lập trình và quyền truy cập SDK để bạn dễ dàng tạo và quản lý webhook. Để xem các câu hỏi thường gặp, hãy tham khảo Câu hỏi thường gặp về Webhook. Đối với các dự án mới cần giao dịch đã phân tích theo thời gian thực, hãy cân nhắc Luồng đã phân tích. Tính năng này kế nhiệm Webhook giao dịch nâng cao, giải mã mọi lệnh thông qua danh mục IDL, lọc phía máy chủ theo chương trình, tài khoản và tên lệnh, đồng thời được tính phí ở mức 1 tín dụng cho mỗi sự kiện trên mọi gói.
Helius có thể thử gửi lại webhook nếu máy chủ của bạn không phản hồi thành công, vì vậy bạn có thể nhận được các sự kiện trùng lặp. Để biết chi tiết về việc thử lại và xử lý dữ liệu trùng lặp, hãy xem Câu hỏi thường gặp về Webhook.

Giá

Sự kiện webhook được tính phí 1 tín dụng khi Helius xử lý và gửi sự kiện đến điểm cuối của bạn. Bạn vẫn bị tính phí bất kể điểm cuối có xử lý webhook thành công hay không. Việc chỉnh sửa, thêm hoặc xóa webhook qua API sẽ tốn 100 tín dụng/yêu cầu.

Các loại webhook

Hiện tại, chúng tôi cung cấp một số loại webhook phù hợp với các nhu cầu khác nhau:

Webhook giao dịch nâng cao

Cung cấp dữ liệu đã phân tích, dễ đọc cho các loại giao dịch cụ thể (ví dụ: giao dịch bán NFT) liên quan đến những địa chỉ bạn giám sát. Đây là lựa chọn lý tưởng nếu bạn cần thông tin chuyên sâu đã được lọc và có thể sử dụng ngay.

Webhook giao dịch thô

Tùy chọn này cung cấp dữ liệu giao dịch thô cho tất cả giao dịch liên quan đến những địa chỉ bạn giám sát. Tùy chọn này không hỗ trợ lọc theo loại giao dịch.
Webhook giao dịch thô có độ trễ thấp hơn vì không cần phân tích các loại sự kiện.

Webhook Discord

Truyền trực tiếp thông tin cập nhật về các loại giao dịch cụ thể đến một kênh Discord được chỉ định dưới dạng tin nhắn đã định dạng. Để sử dụng tùy chọn này, bạn phải cung cấp URL Webhook Discord.

Ví dụ về tải trọng sự kiện

Bắt đầu

Webhooks Quickstart

Tạo webhook đầu tiên qua Bảng điều khiển, REST API hoặc SDK TypeScript / Rust chính thức.

Tự động vô hiệu hóa webhook bị lỗi

Helius giám sát tình trạng của điểm cuối webhook và tự động vô hiệu hóa những webhook liên tục không nhận được dữ liệu gửi đến. Điều này giúp tránh lãng phí các lần thử gửi đến những điểm cuối không thể truy cập hoặc bị lỗi.

Cách hoạt động

  • Gói trả phí (Dev trở lên): Webhook có tỷ lệ lỗi ≥ 95% trong 7 ngày sẽ tự động bị vô hiệu hóa.
  • Gói miễn phí: Webhook được đánh giá trong khoảng thời gian 24 giờ với cùng ngưỡng lỗi.
Hệ thống kiểm tra tình trạng webhook sau mỗi 4 giờ. Khi webhook bị vô hiệu hóa, việc gửi dữ liệu sẽ dừng trong vòng vài giây.

Thông báo qua email

Người dùng gói Dev trở lên sẽ nhận được thông báo qua email khi webhook tự động bị vô hiệu hóa.

Bật lại webhook đã bị vô hiệu hóa

1

Fix your endpoint

Khắc phục sự cố gây lỗi gửi dữ liệu (ví dụ: máy chủ ngừng hoạt động, URL không chính xác, lỗi điểm cuối).
2

Log in to the Helius Dashboard

3

Re-enable the webhook

Tìm webhook đã bị vô hiệu hóa và bật lại.
Bạn cũng có thể bật lại webhook bằng lập trình thông qua điểm cuối API bật/tắt webhook.
Sau khi được bật lại, webhook sẽ bước vào thời gian gia hạn 24 giờ và không bị tự động vô hiệu hóa lại trong khoảng thời gian này. Nhờ đó, bạn có thời gian xác minh rằng điểm cuối đang hoạt động bình thường.

Ví dụ sử dụng

Bot

  • Khi một NFT được niêm yết trên thị trường X, kích hoạt hành động “mua NFT”.
  • Khi một vị thế ký quỹ không an toàn, kích hoạt hành động “thanh lý”.

Giám sát và cảnh báo

  • Khi một chương trình phát ra nhật ký nhất định, thao tác đó sẽ kích hoạt tích hợp PagerDuty.
  • Khi số dư tài khoản token thay đổi hơn X%, sử dụng Dialect để gửi cảnh báo.

Lập chỉ mục theo sự kiện

  • Khi có bất kỳ giao dịch nào xảy ra với một chương trình nhất định, gửi giao dịch đó trực tiếp đến cơ sở dữ liệu hoặc phần backend của bạn.

Thông báo và theo dõi hoạt động

  • Khi chuyển tiền từ ví X sang ví Y — gửi thông báo Slack hoặc email.

Phân tích và nhật ký

  • Khi sự kiện X xảy ra, gửi sự kiện đó đến quy trình ETL hoặc lưu trực tiếp trên Helius để xem xu hướng theo thời gian.

Tự động hóa quy trình làm việc

  • Khi sự kiện X xảy ra, kích hoạt bất kỳ tập hợp hành động nào.