Skip to main content
getTokenSupply RPC 메서드는 특정 SPL 토큰 민트의 총 공급량을 반환합니다. 이는 생성된 토큰의 전체 수량을 이해하는 데 필수적입니다.

일반적인 사용 사례

  • 토큰 정보 표시: 탐색기 또는 지갑 인터페이스에서 토큰의 총 공급량을 표시합니다.
  • 토크노믹스 분석: 토큰의 최대 또는 현재 총 발행량을 이해합니다.
  • 검증: 민트 계정 자체에서 보고한 토큰의 공급량을 확인합니다.
  • 공급 변화 모니터링: 토큰이 민트 가능하다면 전체 공급량의 변화를 추적하는 데 사용할 수 있습니다 (다만, 대체 가능한 토큰의 경우 공급량은 보통 고정되거나 민트 권한에 의해 관리됩니다).

요청 매개변수

  1. mintAddress (string, 필수): 총 공급량을 쿼리하려는 토큰 민트의 base-58로 인코딩된 공개 키입니다.
  2. options (object, 선택 사항): 다음을 포함할 수 있는 선택적 구성 객체:
    • commitment (string, 선택 사항): 쿼리에 대한 커밋 수준을 지정합니다 (예: "finalized", "confirmed", "processed").

응답 구조

JSON-RPC 응답의 result.value 필드는 토큰의 공급에 대한 세부 정보를 포함하는 객체입니다:
  • amount (string): 가장 작은 명목상 토큰의 총 공급량(원시 양)으로, 문자열로 표시됩니다. 이 값은 소수점에 맞춰 조정되지 않습니다.
  • decimals (u8): 이 토큰 민트를 위해 정의된 소수 자릿수입니다. 이것은 원시 amount를 사람이 읽을 수 있는 형식으로 변환하는 데 중요합니다.
  • uiAmount (number | null): 토큰의 decimals에 맞춰 조정된 부동 소수점으로 표시된 토큰의 총 공급량. 이 필드는 null이거나 덜 정확할 수 있습니다. uiAmountString는 일반적으로 표시를 위해 선호됩니다.
  • uiAmountString (string): 토큰의 decimals에 맞춰 조정된 문자열로 표시된 토큰의 총 공급량. 이는 토큰 공급량의 가장 사용자 친화적인 표현입니다.
응답 예시:

코드 예제

개발자 팁

  • 변경 불가능한 공급 (보통): 대부분의 SPL 토큰의 경우 민트 계정 관점에서 총 공급량은 민트가 더 많은 토큰을 생성할 수 있는 특정 민트 권한을 갖지 않는 한 고정되어 있습니다 (혹은 소각할 수도 있지만, 소각은 보통 토큰 계정에서 발생하며 민트의 공급을 직접적으로 감소시키지는 않습니다).
  • decimals가 중요: 항상 decimals 필드를 사용하여 amount 또는 uiAmountString를 올바르게 해석하십시오.
  • 데이터 소스: 이 메서드는 공급 정보에 대해 민트 계정을 직접 쿼리합니다.
이 가이드는 Solana에서 SPL 토큰 공급을 쿼리하기 위한 getTokenSupply RPC 메서드를 효과적으로 사용하는 데 필요한 정보를 제공합니다.