Comment utiliser getSupply

​

Cas d’utilisation courants

• Comprendre la Tokenomics du SOL : Obtenez un instantané de la distribution actuelle du SOL.
• Analyse économique : Suivez les changements des métriques de l’offre au fil du temps.
• Affichage des statistiques du réseau : Fournissez aux utilisateurs des informations à jour sur l’offre de SOL dans des tableaux de bord ou des explorateurs.
• Surveillance de l’inflation : Bien que getInflationRate et getInflationGovernor fournissent des données d’inflation plus directes, getSupply peut offrir un contexte plus large.

​

Paramètres de la requête

1. commitment (string, optionnel) : Spécifie le niveau d’engagement pour la requête. Si omis, l’engagement par défaut du nœud RPC est utilisé.
2. excludeNonCirculatingAccountsList (booléen, optionnel) : Si défini sur true, le tableau nonCirculatingAccounts sera exclu de la réponse. Par défaut à false. Cela peut être utile pour réduire la taille de la réponse si la liste des comptes non circulants individuels n’est pas nécessaire.

{
  "commitment": "finalized",
  "excludeNonCirculatingAccountsList": true
}

​

Structure de la réponse

• value : Un objet contenant les informations sur l’offre :
  • total (u64) : L’offre totale de SOL en lamports.
  • circulating (u64) : L’offre circulante de SOL en lamports.
  • nonCirculating (u64) : L’offre non circulante de SOL en lamports.
  • nonCirculatingAccounts (tableau de chaînes, optionnel) : Un tableau de clés publiques (en tant que chaînes encodées en base58) de comptes détenant du SOL non circulant. Ce champ est omis si excludeNonCirculatingAccountsList était défini sur true dans la requête.
• context : Un objet contenant :
  • slot (u64) : Le slot auquel l’information a été récupérée.

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 169890374
    },
    "value": {
      "circulating": 423105827585008800,
      "nonCirculating": 123456789012345678, // Example value
      "nonCirculatingAccounts": [
        "Stake11111111111111111111111111111111111111",
        "Vote11111111111111111111111111111111111111",
        // ... other non-circulating accounts
      ],
      "total": 546562616597354478
    }
  },
  "id": 1
}

{
  "jsonrpc": "2.0",
  "result": {
    "context": {
      "slot": 169890380
    },
    "value": {
      "circulating": 423105830000000000,
      "nonCirculating": 123456780000000000, // Example value
      "total": 546562610000000000
      // nonCirculatingAccounts field is absent
    }
  },
  "id": 1
}

​

Exemples de code

# Basic Request:
curl -X POST -H "Content-Type: application/json" -d \
  '{"jsonrpc":"2.0","id":1,"method":"getSupply"}' \
  <YOUR_RPC_URL>

# Request with excludeNonCirculatingAccountsList:
curl -X POST -H "Content-Type: application/json" -d \
  '{"jsonrpc":"2.0","id":1,"method":"getSupply", "params": [{"excludeNonCirculatingAccountsList": true}]}' \
  <YOUR_RPC_URL>

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

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

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

  try {
    const supplyInfo = await connection.getSupply();
    console.log('Supply Information:', supplyInfo.value);
    console.log('Total SOL:', supplyInfo.value.total / 1_000_000_000); // Convert lamports to SOL
    console.log('Circulating SOL:', supplyInfo.value.circulating / 1_000_000_000);
    console.log('Non-Circulating SOL:', supplyInfo.value.nonCirculating / 1_000_000_000);

    if (supplyInfo.value.nonCirculatingAccounts) {
      console.log('Non-circulating accounts count:', supplyInfo.value.nonCirculatingAccounts.length);
    }

    // Example with options
    const supplyInfoWithoutAccountsList = await connection.getSupply({
      commitment: 'finalized',
      excludeNonCirculatingAccountsList: true,
    });
    console.log('\nSupply Information (excluding non-circulating accounts list):');
    console.log('Total SOL:', supplyInfoWithoutAccountsList.value.total / 1_000_000_000);
    console.log('Circulating SOL:', supplyInfoWithoutAccountsList.value.circulating / 1_000_000_000);

  } catch (error) {
    console.error('Error getting supply information:', error);
  }
}

getNetworkSupply();

​

Conseils pour les développeurs

• Lamports vs. SOL : Les montants sont retournés en lamports. N’oubliez pas de diviser par 1,000,000,000 (1 SOL = 10^9 lamports) pour convertir en SOL.
• Actualité des données : Les données reflètent l’état au slot indiqué dans l’objet context et en fonction du niveau d’engagement utilisé.
• excludeNonCirculatingAccountsList : Utilisez cette option si vous avez seulement besoin des chiffres totaux de l’offre pour optimiser la taille de la réponse et le temps de traitement, surtout si la liste des comptes non circulants est très longue.
• Valeurs dynamiques : Les chiffres de l’offre peuvent changer fréquemment en raison de l’émission de tokens (inflation) et des mécanismes de brûlage.

​

Méthodes connexes