Cómo usar getSlot

​

Casos de uso comunes

• Obtener el progreso actual de la red: Determina el slot más reciente procesado o confirmado por el nodo.
• Comprobar la sincronización de nodos: Comparar el slot de distintos nodos puede indicar su estado de sincronización.
• Registrar marcas de tiempo en operaciones: Usa el slot actual como punto de referencia para operaciones o para conocer la antigüedad de ciertos datos.
• Entrada para otras llamadas RPC: Algunos métodos RPC pueden usar un número de slot como punto de referencia.

​

Parámetros de solicitud

1. options (object, opcional): Un objeto de configuración opcional con los siguientes campos:
   • commitment (string, opcional): Especifica el nivel de compromiso de la consulta. Los valores admitidos son finalized, confirmed o processed. Si se omite, se usa el compromiso predeterminado del nodo RPC (generalmente finalized).
     • processed: El nodo consultará su slot más reciente. Ten en cuenta que es posible que el clúster aún no haya confirmado este slot y que podría omitirse.
     • confirmed: En Alpenglow, equivale a finalized; se conserva por compatibilidad.
     • finalized: El nodo consultará el slot confirmado permanentemente más reciente. Prefiere este valor para código nuevo.
   • minContextSlot (number, opcional): El slot mínimo en el que se puede evaluar la solicitud. Esto establece el slot mínimo para el contexto del nodo. Si el estado del nodo es anterior a este slot, puede devolver un error o un número de slot que refleje su estado actual (más antiguo) en relación con este mínimo.

​

Estructura de la respuesta

{
  "jsonrpc": "2.0",
  "result": 123456789,
  "id": 1
}

​

Ejemplos

​

1. Obtener el slot actual (compromiso predeterminado)

# Replace <api-key> with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSlot"
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function getCurrentSlot() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const slot = await connection.getSlot();
    console.log('Current slot (default commitment):', slot);
  } catch (error) {
    console.error('Error fetching current slot:', error);
  }
}

getCurrentSlot();

​

2. Obtener el slot finalizado actual

# Replace <api-key> with your Helius API key
curl https://mainnet.helius-rpc.com/?api-key=<api-key> -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getSlot",
    "params": [
      {
        "commitment": "finalized"
      }
    ]
  }'

// Replace <api-key> with your Helius API key
const { Connection } = require('@solana/web3.js');

async function getFinalizedSlot() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const slot = await connection.getSlot('finalized');
    console.log('Current slot (finalized commitment):', slot);
    // Note: For @solana/web3.js v1.30.0 and later, you can pass commitment directly.
    // For older versions or more complex options, use an object:
    // const slot = await connection.getSlot({ commitment: 'finalized' });
  } catch (error) {
    console.error('Error fetching finalized slot:', error);
  }
}

getFinalizedSlot();

​

Consejos para desarrolladores

• El compromiso es importante: processed devuelve el slot más reciente que ejecutó el nodo y puede incluir trabajo que posteriormente se revierta. En Alpenglow, confirmed e finalized devuelven el mismo estado confirmado permanentemente; prefiere finalized para código nuevo.
• Variabilidad entre nodos: Los distintos nodos RPC pueden devolver números de slot ligeramente diferentes debido a retrasos en la propagación de la red o a su propio estado de procesamiento. Esto ocurre especialmente con el compromiso processed.
• minContextSlot: Este parámetro garantiza que el nodo que procesa tu solicitud haya alcanzado al menos el minContextSlot. Si el nodo aún no alcanzó este slot, el comportamiento puede variar (por ejemplo, puede producirse un error o el nodo puede devolver su slot actual más alto, que sería inferior a minContextSlot). Por lo general, se usa en situaciones avanzadas en las que necesitas garantizar que una consulta se realice sobre un estado suficientemente reciente.