如何使用 getTokenAccountsByDelegate

​

常见用例

• 列出代理资产： 显示已授予特定钱包或程序代理权限的所有代币账户。
• 自动化代币管理： 代表用户执行操作的服务（例如，自动做市商、管理代币化奖励的质押协议）可以使用此方法查找他们有权与之交互的账户。
• 审计代理： 审查哪些账户已将代理权限授予特定地址。
• 撤销代理： 确定需要撤销代理权限的代币账户（尽管撤销本身是一个单独的交易）。

​

请求参数

1. delegatePubkey（字符串，必需）：要查找其关联代币账户的代理账户的 base-58 编码公钥。
2. filter（对象，必需）：一个 JSON 对象，必须指定 mint 或 programId 以过滤账户：
   • mint（字符串）：特定代币铸造的 base-58 编码公钥。如果提供，查询将仅返回此特定代币类型的代币账户，这些账户已授权给 delegatePubkey。
   • programId（字符串）：拥有账户的 Token Program 的 base-58 编码公钥。通常是标准的 SPL Token Program（TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA）或 Token-2022 Program（TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb）。
3. options（对象，可选）：一个可选的配置对象，包含以下常见字段：
   • commitment（字符串，可选）：指定承诺级别。
   • encoding（字符串，可选）：账户数据的编码。"jsonParsed" 强烈推荐，因为它返回人类可读的账户信息。其他选项包括 "base64", "base64+zstd"。如果未指定，默认为 "base64"。
   • dataSlice（对象，可选）：允许您仅检索账户数据的特定切片。包含 offset（usize）和 length（usize）字段。仅适用于 base58, base64 或 base64+zstd 编码。
   • minContextSlot（u64，可选）：请求可以评估的最小槽位。

​

响应结构

• pubkey（字符串）：代币账户本身的 base-58 编码公钥。
• account（对象）：包含代币账户详细信息的对象：
  • lamports（u64）：代币账户的 lamport 余额（用于租金豁免）。
  • owner（字符串）：拥有此账户的程序的公钥（例如，代币程序）。
  • data：账户数据。如果使用 "jsonParsed" 编码，这将是一个包含 program 字段（例如，"spl-token"）和 parsed 字段的对象，包含结构化信息：
    • parsed.info：一个包含详细信息的对象，例如：
      • mint（字符串）：代币的铸造地址。
      • owner（字符串）：代币账户的所有者（不是代理）。
      • tokenAmount（对象）：此账户中代币的总余额（amount, decimals, uiAmount, uiAmountString）。
      • delegate（字符串）：代理的公钥（应与请求中的 delegatePubkey 匹配）。
      • delegatedAmount（对象）：代理被授权管理的代币数量（amount, decimals, uiAmount, uiAmountString）。
      • isNative（布尔值）：指示账户是否持有包装的 SOL。
      • state（字符串）：代币账户的状态（例如，"initialized"）。
    • parsed.type（字符串）：账户的类型（例如，"account"）。
  • executable（布尔值）：账户是否可执行。
  • rentEpoch（u64）：此账户下次需要支付租金的纪元。
  • space（u64，如果未使用 jsonParsed）：原始账户数据的字节长度。

{
  "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
}

​

代码示例

# 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>

​

开发者提示

• 过滤器要求： 在过滤器参数中，您必须提供 mint 或 programId。如果没有这些过滤器之一，您无法查询所有代币类型的所有委托账户。
• 编码： 强烈建议对 encoding 选项使用 "jsonParsed"，以便更轻松地处理数据，因为它将二进制账户数据解码为结构化的 JSON 格式。
• 性能： 使用 programId 查询可能比使用 mint 查询更耗费资源，特别是如果委托对多种不同的代币类型有权限时。一些 RPC 提供商可能对这种方法有更严格的速率限制。
• 委托数量： 响应中的 delegatedAmount 表示委托当前被授权使用的最大代币数量。这可能小于账户中的总 tokenAmount。
• 撤销委托： 此方法仅检索信息。要撤销委托，代币账户的所有者必须向 SPL Token Program 发送 Revoke 指令。