Cách sử dụng getTokenAccountsByDelegate

​

Các trường hợp sử dụng phổ biến

• Liệt kê tài sản được ủy quyền: Hiển thị tất cả tài khoản token mà một ví hoặc chương trình cụ thể đã được cấp quyền ủy quyền.
• Quản lý token tự động: Các dịch vụ thực hiện hành động thay mặt người dùng (ví dụ: nhà tạo lập thị trường tự động, giao thức staking quản lý phần thưởng được token hóa) có thể dùng phương thức này để tìm các tài khoản mà chúng được phép tương tác.
• Kiểm tra việc ủy quyền: Xem xét những tài khoản nào đã ủy quyền cho một địa chỉ cụ thể.
• Thu hồi quyền ủy quyền: Xác định các tài khoản token cần thu hồi quyền ủy quyền (mặc dù bản thân việc thu hồi là một giao dịch riêng biệt).

​

Tham số yêu cầu

1. delegatePubkey (chuỗi, bắt buộc): Khóa công khai được mã hóa base-58 của tài khoản được ủy quyền có các tài khoản token liên kết mà bạn muốn tìm.
2. filter (đối tượng, bắt buộc): Một đối tượng JSON phải chỉ định mint hoặc programId để lọc các tài khoản:
   • mint (chuỗi): Khóa công khai được mã hóa base-58 của một token mint cụ thể. Nếu được cung cấp, truy vấn sẽ chỉ trả về các tài khoản thuộc loại token cụ thể này đã ủy quyền cho delegatePubkey.
   • programId (chuỗi): Khóa công khai được mã hóa base-58 của Token Program sở hữu các tài khoản. Đây thường là SPL Token Program tiêu chuẩn (TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA) hoặc Token-2022 Program (TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb).
3. options (đối tượng, không bắt buộc): Một đối tượng cấu hình không bắt buộc với các trường phổ biến sau:
   • commitment (chuỗi, không bắt buộc): Chỉ định mức độ cam kết.
   • encoding (chuỗi, không bắt buộc): Kiểu mã hóa cho dữ liệu tài khoản. Bạn nên dùng "jsonParsed" vì tùy chọn này trả về thông tin tài khoản mà con người có thể đọc được. Các tùy chọn khác gồm "base64", "base64+zstd". Giá trị mặc định là "base64" nếu không được chỉ định.
   • dataSlice (đối tượng, không bắt buộc): Cho phép bạn chỉ truy xuất một phần cụ thể của dữ liệu tài khoản. Chứa các trường offset (usize) và length (usize). Chỉ áp dụng cho các kiểu mã hóa base58, base64 hoặc base64+zstd.
   • minContextSlot (u64, không bắt buộc): Slot tối thiểu mà tại đó yêu cầu có thể được đánh giá.

​

Cấu trúc phản hồi

• pubkey (chuỗi): Khóa công khai được mã hóa base-58 của chính tài khoản token.
• account (đối tượng): Một đối tượng chứa thông tin chi tiết về tài khoản token:
  • lamports (u64): Số dư lamport của tài khoản token (để được miễn phí thuê).
  • owner (chuỗi): Khóa công khai của chương trình sở hữu tài khoản này (ví dụ: Token Program).
  • data: Dữ liệu tài khoản. Nếu dùng kiểu mã hóa "jsonParsed", đây sẽ là một đối tượng có trường program (ví dụ: "spl-token") và trường parsed chứa thông tin có cấu trúc:
    • parsed.info: Một đối tượng có các thông tin chi tiết như:
      • mint (chuỗi): Địa chỉ mint của token.
      • owner (chuỗi): Chủ sở hữu tài khoản token (không phải bên được ủy quyền).
      • tokenAmount (đối tượng): Tổng số dư token trong tài khoản này (amount, decimals, uiAmount, uiAmountString).
      • delegate (chuỗi): Khóa công khai của bên được ủy quyền (phải khớp với delegatePubkey trong yêu cầu).
      • delegatedAmount (đối tượng): Số lượng token mà bên được ủy quyền có quyền quản lý (amount, decimals, uiAmount, uiAmountString).
      • isNative (boolean): Cho biết tài khoản có giữ SOL được bọc hay không.
      • state (chuỗi): Trạng thái của tài khoản token (ví dụ: "initialized").
    • parsed.type (chuỗi): Loại tài khoản (ví dụ: "account").
  • executable (boolean): Tài khoản có thể thực thi hay không.
  • rentEpoch (u64): Epoch mà tại đó tài khoản này sẽ phải trả phí thuê tiếp theo.
  • space (u64, nếu không dùng jsonParsed): Độ dài của dữ liệu tài khoản thô tính bằng byte.

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 183458000
    },
    "value": [
      {
        "pubkey": "SomeTokenAccountPubkey1...",
        "account": {
          "data": {
            "program": "spl-token",
            "parsed": {
              "info": {
                "delegate": "DelegatePubkeyProvidedInRequest...",
                "delegatedAmount": {
                  "amount": "1000000000",
                  "decimals": 9,
                  "uiAmount": 1.0,
                  "uiAmountString": "1.0"
                },
                "isNative": false,
                "mint": "TokenMintPubkey...",
                "owner": "ActualOwnerOfTheTokenAccount...",
                "state": "initialized",
                "tokenAmount": {
                  "amount": "5000000000",
                  "decimals": 9,
                  "uiAmount": 5.0,
                  "uiAmountString": "5.0"
                }
              },
              "type": "account"
            },
            "space": 165
          },
          "executable": false,
          "lamports": 2039280,
          "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA", // SPL Token Program
          "rentEpoch": 382
        }
      }
      // ... potentially other token accounts delegated to the same delegate
    ]
  },
  "id": 1
}

​

Ví dụ mã

# Replace <DELEGATE_PUBKEY> and <TOKEN_MINT_PUBKEY> or <TOKEN_PROGRAM_ID>
# Example using programId (SPL Token Program)
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTokenAccountsByDelegate",
    "params": [
      "<DELEGATE_PUBKEY>",
      { "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
      { "encoding": "jsonParsed" }
    ]
  }' \
  <YOUR_RPC_URL>

# Example using a specific mint
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTokenAccountsByDelegate",
    "params": [
      "<DELEGATE_PUBKEY>",
      { "mint": "<TOKEN_MINT_PUBKEY>" },
      { "encoding": "jsonParsed", "commitment": "confirmed" }
    ]
  }' \
  <YOUR_RPC_URL>

const { Connection, PublicKey } = require('@solana/web3.js');

async function findDelegatedAccounts(delegateAddress, filter, encoding = 'jsonParsed') {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  const delegatePubKey = new PublicKey(delegateAddress);

  try {
    let actualFilter;
    if (filter.mint) {
      actualFilter = { mint: new PublicKey(filter.mint) };
    } else if (filter.programId) {
      actualFilter = { programId: new PublicKey(filter.programId) };
    } else {
      console.error("Filter must contain either 'mint' or 'programId'");
      return;
    }

    const accounts = await connection.getTokenAccountsByDelegate(
      delegatePubKey,
      actualFilter,
      { encoding }
    );

    console.log(`Found ${accounts.value.length} token accounts delegated to ${delegateAddress}:`);
    accounts.value.forEach(accInfo => {
      console.log(`  Token Account: ${accInfo.pubkey.toBase58()}`);
      if (encoding === 'jsonParsed' && accInfo.account.data.parsed) {
        console.log(`    Mint: ${accInfo.account.data.parsed.info.mint}`);
        console.log(`    Owner: ${accInfo.account.data.parsed.info.owner}`);
        console.log(`    Delegated Amount: ${accInfo.account.data.parsed.info.delegatedAmount.uiAmountString}`);
      }
      // console.log(JSON.stringify(accInfo.account.data, null, 2)); // For full data
    });

  } catch (error) {
    console.error(`Error fetching token accounts by delegate for ${delegateAddress}:`, error);
  }
}

// Replace with an actual delegate public key
const exampleDelegate = '4Nd1mBQtrMJVYVfKf2PJy9NZUZdTAsp7D4xWLs4gDB4T'; 

// Example 1: Find all SPL Token program accounts delegated to `exampleDelegate`
findDelegatedAccounts(exampleDelegate, { programId: 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA' });

// Example 2: Find accounts for a specific mint (e.g., USDC) delegated to `exampleDelegate`
// const usdcMint = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
// findDelegatedAccounts(exampleDelegate, { mint: usdcMint });

​

Mẹo dành cho nhà phát triển

• Yêu cầu về bộ lọc: Bạn phải cung cấp mint hoặc programId trong tham số bộ lọc. Bạn không thể truy vấn tất cả tài khoản được ủy quyền trên mọi loại token nếu không có một trong các bộ lọc này.
• Mã hóa: Bạn nên dùng "jsonParsed" cho tùy chọn encoding để xử lý dữ liệu dễ dàng hơn, vì tùy chọn này giải mã dữ liệu tài khoản nhị phân thành định dạng JSON có cấu trúc.
• Hiệu suất: Truy vấn bằng programId có thể tốn nhiều tài nguyên hơn so với truy vấn bằng mint, đặc biệt nếu bên được ủy quyền có quyền đối với nhiều loại token khác nhau. Một số nhà cung cấp RPC có thể áp dụng giới hạn tốc độ nghiêm ngặt hơn cho phương thức này.
• Số lượng được ủy quyền: delegatedAmount trong phản hồi cho biết số lượng token tối đa mà bên được ủy quyền hiện có quyền sử dụng. Số lượng này có thể nhỏ hơn tổng tokenAmount trong tài khoản.
• Thu hồi quyền ủy quyền: Phương thức này chỉ truy xuất thông tin. Để thu hồi quyền ủy quyền, chủ sở hữu tài khoản token phải gửi một lệnh Revoke đến SPL Token Program.