Lọc tài khoản token (ATA) qua WebSocket

Bộ lọc tokenAccounts trên phương thức WebSocket transactionSubscribe cho phép gói đăng ký đối sánh hoạt động trên các tài khoản token liên kết (ATA) thuộc sở hữu của ví, thay vì chỉ các giao dịch có pubkey của ví xuất hiện trực tiếp. Bộ lọc tương tự cũng có trên gRPC — xem Lọc tài khoản token (ATA) để biết phiên bản gRPC.

Vấn đề: bộ lọc tài khoản thông thường bỏ sót giao dịch chuyển token đến

Khi theo dõi một ví bằng accountInclude: [wallet], bạn chỉ đối sánh các giao dịch mà pubkey của ví đó xuất hiện trong các khóa tài khoản của giao dịch. Một trường hợp phổ biến sẽ bị bỏ sót: khi ai đó gửi token SPL (ví dụ: USDC) đến ví, giao dịch chuyển sẽ tương tác với tài khoản token liên kết (ATA) của ví — một địa chỉ riêng biệt được chương trình dẫn xuất — chứ không phải chính pubkey của ví. Do đó, gói đăng ký accountInclude: [wallet] thông thường sẽ không bao giờ phát hiện các giao dịch chuyển token đến. Bạn sẽ phải liệt kê trước mọi ATA thuộc sở hữu của ví và thêm từng tài khoản vào bộ lọc — nhưng ATA được tạo theo nhu cầu (mỗi mint một tài khoản), nên không thể biết trước toàn bộ tập hợp.

Cách hoạt động của tính năng mở rộng `tokenAccounts`

Đặt tokenAccounts trên gói đăng ký để mở rộng phạm vi đối sánh, nhờ đó ví accountInclude cũng đối sánh với các giao dịch tương tác với tài khoản token thuộc sở hữu của ví. Việc đối sánh dựa trên chủ sở hữu: LaserStream phân giải các tài khoản token thuộc sở hữu của địa chỉ accountInclude tại thời điểm đối sánh, nên có thể phát hiện mọi tài khoản token thuộc sở hữu của ví — kể cả các tài khoản không chính tắc — chứ không chỉ địa chỉ ATA dẫn xuất. Bạn không bao giờ phải tự liệt kê các ATA. Các gói đăng ký không có tokenAccounts vẫn hoạt động chính xác như trước, vì vậy bạn có thể thêm trường này vào bộ lọc hiện có một cách an toàn.

Các chế độ mở rộng

tokenAccounts nhận một trong ba giá trị chuỗi sau:

Giá trị	Đối sánh	Lưu lượng	Dùng cho
`"balanceChanged"`	Các giao dịch mà số dư token thuộc sở hữu thực sự thay đổi (hoặc tài khoản token bị đóng)	Thấp hơn — giá trị mặc định được khuyến nghị	”Thông báo cho tôi khi tiền thực sự dịch chuyển” — tiền gửi, tiền rút và giao dịch hoán đổi được quyết toán vào ví
`"all"`	Mọi giao dịch tham chiếu đến tài khoản token thuộc sở hữu của ví, ngay cả khi số dư không thay đổi	Cao hơn	Khả năng quan sát đầy đủ mọi hoạt động dù chỉ tương tác với tài khoản token của ví
`"none"`	Không mở rộng — tương đương với việc bỏ qua trường này	—	Giá trị mặc định

Hãy bắt đầu với "balanceChanged". Chế độ này ghi nhận chuyển động thực tế của tiền với lưu lượng chỉ bằng một phần nhỏ so với "all".

Sử dụng trong `transactionSubscribe`

tokenAccounts là phần mở rộng của Helius cho API WebSocket Solana tiêu chuẩn. Giá trị không hợp lệ sẽ trả về lỗi JSON-RPC -32602: Invalid tokenAccounts value '<x>', expected one of: none, balanceChanged, all.

const ws = new WebSocket('wss://mainnet.helius-rpc.com/?api-key=<API_KEY>');

ws.on('open', () => {
  ws.send(JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'transactionSubscribe',
    params: [
      {
        accountInclude: ['<WALLET_PUBKEY>'],
        tokenAccounts: 'balanceChanged' // also match the wallet's ATAs
      },
      { commitment: 'confirmed', encoding: 'jsonParsed', maxSupportedTransactionVersion: 1 }
    ]
  }));
  setInterval(() => ws.ping(), 30_000);
});

ws.on('message', (data) => {
  const msg = JSON.parse(data.toString());
  const result = msg.params?.result;
  if (!result) return;
  // Token balances this wallet owns that changed in the tx
  const owned = (result.transaction.meta.postTokenBalances || [])
    .filter((b) => b.owner === '<WALLET_PUBKEY>');
  console.log(result.signature, owned);
});

Đọc nội dung đã đối sánh

Sau khi một giao dịch được đối sánh thông qua tính năng mở rộng ATA, chuyển động token của ví nằm trong meta.postTokenBalances và meta.preTokenBalances của giao dịch. Lọc các mục đó theo owner để tách riêng số dư thực sự thuộc sở hữu của ví, sau đó so sánh chênh lệch giữa preTokenBalances và postTokenBalances trên cùng một accountIndex để xem lượng token của từng mint đã dịch chuyển. Ví dụ trên minh họa bước lọc này.

Liên quan

transactionSubscribe

Mọi bộ lọc và tùy chọn transactionSubscribe, bao gồm tokenAccounts.

Token Account Filtering (gRPC)

Tính năng mở rộng tokenAccounts tương tự trên các bộ lọc giao dịch gRPC của LaserStream.

WebSocket Quickstart

Kết nối với WebSocket của LaserStream và truyền phát các sự kiện đầu tiên.

Bắt đầu

Truyền phát dữ liệu & lắng nghe sự kiện

API dữ liệu & RPC

Giao dịch

Gửi giao dịch

Ví dưới dạng dịch vụ

Quyền riêng tư

Tài nguyên

Lọc tài khoản token (ATA) qua WebSocket

Vấn đề: bộ lọc tài khoản thông thường bỏ sót giao dịch chuyển token đến

Cách hoạt động của tính năng mở rộng `tokenAccounts`

Các chế độ mở rộng

Sử dụng trong `transactionSubscribe`

Đọc nội dung đã đối sánh

Liên quan

transactionSubscribe

Token Account Filtering (gRPC)

WebSocket Quickstart

​Vấn đề: bộ lọc tài khoản thông thường bỏ sót giao dịch chuyển token đến

​Cách hoạt động của tính năng mở rộng tokenAccounts

​Các chế độ mở rộng

​Sử dụng trong transactionSubscribe

​Đọc nội dung đã đối sánh

​Liên quan

transactionSubscribe

Token Account Filtering (gRPC)

WebSocket Quickstart

Vấn đề: bộ lọc tài khoản thông thường bỏ sót giao dịch chuyển token đến

Cách hoạt động của tính năng mở rộng `tokenAccounts`

Các chế độ mở rộng

Sử dụng trong `transactionSubscribe`

Đọc nội dung đã đối sánh

Liên quan