API de anillos de privacidad de Solana

​

Saldos públicos y privados

​

Endpoint y autenticación

curl --request POST \
  --url "https://devnet.helius-rpc.com/v1/spr/getUserRecords?api-key=YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "jsonrpc": "2.0",
    "id": "1",
    "method": "getUserRecords",
    "params": {
      "owners": ["11111111111111111111111111111111"]
    }
  }'

​

Métodos

​

Paginación

{
  "jsonrpc": "2.0",
  "id": "1",
  "result": {
    "context": { "slot": 4242, "blockTime": 1730000000 },
    "data": [],
    "paginationToken": null
  }
}

• data agrupa los resultados por transacción de Solana, ordenados por slot y firma de forma ascendente. El método de UTXO cifradas usa un arreglo outputs en cada grupo; los métodos del historial de transacciones usan un arreglo events.
• limit cuenta las transacciones de Solana, de 1 a 1,000, y su valor predeterminado es 1,000. Las salidas o los eventos coincidentes de una transacción permanecen juntos en una página.
• Devuelve un paginationToken no nulo sin modificar, con las mismas etiquetas o anuladores, el mismo anillo y los mismos filtros de slot. Continúa hasta que el token de respuesta sea null.
• filters.slot acepta los límites gt, gte, lt y lte. Los límites proporcionados se combinan con AND. Cuando una lectura sin límite alcance un token nulo, guarda el context.slot de esa página y reanúdala después con filters.slot.gt establecido en ese valor. Una lectura limitada por lt o lte solo cubre los slots hasta ese límite; reanúdala desde el límite, no desde context.slot.
• Establece minContextSlot para exigir un slot mínimo persistido del indexador. El indexador también exige el slot de tu paginationToken y de cualquier filtro gt o gte. Si no ha alcanzado alguno de ellos, devuelve el error -32016 con error.data.contextSlot; vuelve a intentarlo cuando se haya actualizado.

​

Codificación de datos

​

Errores