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 compatibles son finalized, confirmed o processed. Si se omite, se usa el compromiso predeterminado del nodo RPC (por lo general, 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 este pueda omitirse.
     • confirmed: El nodo consultará el slot más reciente por el que haya votado una supermayoría del clúster.
     • finalized: El nodo consultará el slot más reciente que la supermayoría del clúster haya confirmado como que alcanzó el bloqueo máximo (no se puede revertir).
   • 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) con respecto a 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 actual con un compromiso específico

# 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": "confirmed"
      }
    ]
  }'

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

async function getConfirmedSlot() {
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  try {
    const slot = await connection.getSlot('confirmed');
    console.log('Current slot (confirmed 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: 'confirmed' });
  } catch (error) {
    console.error('Error fetching confirmed slot:', error);
  }
}

getConfirmedSlot();

​

Consejos para desarrolladores

• El compromiso importa: El número de slot devuelto depende en gran medida del nivel commitment especificado. Consulta Niveles de compromiso de Solana para obtener información detallada. processed será el slot más alto (el más reciente) que conoce el nodo, mientras que finalized será un slot anterior confirmado por toda la red. Elige el nivel de compromiso adecuado según las necesidades de finalidad de los datos de tu caso de uso.
• Variabilidad entre nodos: Distintos nodos RPC pueden devolver números de slot ligeramente diferentes para el mismo nivel de compromiso debido a retrasos en la propagación de la red o a su propio estado de procesamiento. Esto ocurre especialmente con los niveles processed e confirmed.
• minContextSlot: Este parámetro garantiza que el nodo que procesa tu solicitud haya alcanzado al menos el minContextSlot. Si el nodo está atrasado con respecto a este slot, el comportamiento puede variar (por ejemplo, puede producirse un error o devolverse el slot actual más alto del nodo, que es menor que minContextSlot). Por lo general, se usa en situaciones avanzadas en las que necesitas asegurarte de que una consulta se realice sobre un estado suficientemente reciente.