Cómo usar getTokenSupply

​

Casos de uso comunes

• Mostrar información del token: Muestra la oferta total de un token en un explorador o en la interfaz de una billetera.
• Análisis de la economía del token: Permite conocer la emisión total máxima o actual de un token.
• Verificación: Comprueba la oferta de un token según los datos de la propia cuenta de acuñación.
• Supervisión de cambios en la oferta: Si un token se puede acuñar, puedes usar este método para seguir los cambios en su oferta total a lo largo del tiempo. Sin embargo, en el caso de los tokens fungibles, la oferta suele ser fija o estar gestionada por una autoridad de acuñación.

​

Parámetros de la solicitud

1. mintAddress (string, obligatorio): La clave pública codificada en base 58 de la acuñación del token cuya oferta total quieres consultar.
2. options (object, opcional): Un objeto de configuración opcional que puede incluir:
   • commitment (string, opcional): Especifica el nivel de compromiso de la consulta (por ejemplo, "finalized", "confirmed", "processed").

​

Estructura de la respuesta

• amount (string): La oferta total del token en su unidad mínima (cantidad sin procesar), representada como una cadena. Este valor no está ajustado según los decimales.
• decimals (u8): La cantidad de posiciones decimales definidas para la acuñación de este token. Este valor es fundamental para convertir el valor sin procesar de amount a un formato legible.
• uiAmount (number | null): La oferta total del token como número de punto flotante, ajustada según el valor decimals del token. Este campo puede ser null o menos preciso; por lo general, se recomienda usar uiAmountString para mostrar el valor.
• uiAmountString (string): La oferta total del token como una cadena, ajustada según el valor decimals del token. Esta es la representación más fácil de interpretar de la oferta total.

{
  "jsonrpc": "2.0",
  "result": {
    "context": { "slot": 123456789 },
    "value": {
      "amount": "1000000000000000", // e.g., 1,000,000,000 tokens with 6 decimals
      "decimals": 6,
      "uiAmount": 1000000000.0,
      "uiAmountString": "1000000000.0"
    }
  },
  "id": 1
}

​

Ejemplos de código

# Replace <TOKEN_MINT_PUBKEY> with the actual mint address
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTokenSupply",
    "params": [
      "<TOKEN_MINT_PUBKEY>"
    ]
  }' \
  <YOUR_RPC_URL>

# Example with commitment level
curl -X POST -H "Content-Type: application/json" -d \
  '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "getTokenSupply",
    "params": [
      "<TOKEN_MINT_PUBKEY>",
      { "commitment": "confirmed" }
    ]
  }' \
  <YOUR_RPC_URL>

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

async function checkTokenSupply(mintAddress) {
  // Replace with your RPC endpoint
  const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=<api-key>');
  const mintPublicKey = new PublicKey(mintAddress);

  try {
    const tokenSupply = await connection.getTokenSupply(mintPublicKey);
    console.log(`Token Supply for Mint ${mintAddress}:`);
    console.log(`  UI Amount: ${tokenSupply.value.uiAmountString}`);
    console.log(`  Raw Amount: ${tokenSupply.value.amount}`);
    console.log(`  Decimals: ${tokenSupply.value.decimals}`);
    // For full details:
    // console.log(JSON.stringify(tokenSupply, null, 2));
  } catch (error) {
    console.error(`Error fetching token supply for mint ${mintAddress}:`, error);
  }
}

// Replace with the actual token mint public key you want to query
const exampleTokenMint = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'; // USDC mint
checkTokenSupply(exampleTokenMint);

// Example with a different mint (e.g., Raydium)
// const raydiumMint = '4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R';
// checkTokenSupply(raydiumMint);

​

Consejos para desarrolladores

• Oferta inmutable (por lo general): En la mayoría de los tokens SPL, una vez acuñados, la oferta total desde la perspectiva de la propia cuenta de acuñación permanece fija, a menos que la acuñación tenga una autoridad específica capaz de crear más tokens o quemarlos. Sin embargo, la quema suele realizarse desde cuentas de tokens, no directamente desde la oferta de la acuñación.
• decimals es fundamental: Usa siempre el campo decimals para interpretar correctamente amount o uiAmountString.
• Fuente de datos: Este método consulta directamente la cuenta de acuñación para obtener información sobre su oferta.