네트워크에서 데이터 읽기

Solana에서 "지갑"은 Solana의 내장 프로그램 중 하나인 시스템 프로그램이 소유한 계정입니다. 지갑 계정은 주로 SOL을 보관하고(lamports 필드에서 추적됨) 트랜잭션에 서명하는 데 사용됩니다.

지갑 계정을 조회하면, 응답에는 예제 출력에 표시된 필드들이 포함됩니다.

data 필드에는 바이트로 저장된 계정의 데이터가 포함되어 있습니다.

지갑 계정의 경우, 이 필드는 비어 있습니다(0바이트). 다른 계정들은 이 필드를 프로그램 상태 또는 실행 가능한 프로그램 코드를 저장하는 데 사용합니다.

executable 필드는 계정의 data 필드에 실행 가능한 프로그램 코드가 포함되어 있는지 여부를 나타냅니다.

지갑 및 프로그램 상태를 저장하는 계정의 경우, 이 필드는 false입니다.

lamports 필드에는 lamport 단위로 표시된 계정의 SOL 잔액이 포함되어 있습니다.

Lamport는 SOL의 최소 단위입니다. 1 SOL = 1,000,000,000 lamport입니다.

owner 필드는 계정을 소유한 프로그램을 보여줍니다.

지갑의 경우, 소유자는 항상 주소가 11111111111111111111111111111111인 System Program입니다.

rentEpoch 필드는 계정이 네트워크에 데이터를 유지하기 위해 "rent"(lamport 단위)를 지불하던 더 이상 사용되지 않는 메커니즘의 레거시 필드입니다.

이 필드는 현재 사용되지 않지만 이전 버전과의 호환성을 위해 포함되어 있습니다.

space 필드는 data 필드의 바이트 수를 보여줍니다. 이것은 Account 타입 자체의 필드가 아니지만 응답에 포함됩니다.

이 예제에서 space 필드는 data 필드가 0바이트의 데이터를 포함하고 있기 때문에 0입니다.

Token Program은 Solana의 실행 가능한 program account입니다. 지갑 계정과 마찬가지로 프로그램도 동일한 기본 Account 데이터 구조를 가지고 있지만 필드에 주요 차이점이 있습니다.

executable 필드는 true로 설정되어 있으며, 이는 이 계정의 data 필드에 실행 가능한 프로그램 코드가 포함되어 있음을 나타냅니다.

program account의 경우, data 필드에 프로그램의 실행 코드가 저장됩니다. 반면에 지갑 계정은 데이터 필드가 비어 있습니다.

Solana 프로그램을 배포할 때, 프로그램의 실행 코드는 계정의 data 필드에 저장됩니다.

실행 가능한 program account에는 해당 계정의 owner로 지정된 프로그램도 있습니다.

모든 program account는 Loader 프로그램이 소유하고 있으며, 이는 Solana에서 실행 가능한 program account를 소유하는 내장 프로그램의 카테고리입니다.

Token Program의 경우, owner는 BPFLoader2 프로그램입니다.

이 예시에서 주목해야 할 핵심 포인트는 Mint 계정이 실행 가능한 코드가 아닌 상태를 저장한다는 것입니다.

Mint 계정은 Token Program이 소유하며, Token Program은 Mint 계정을 생성하고 업데이트하는 방법을 정의하는 명령어를 포함합니다.

{
  "data": {
    "type": "Buffer",
    "data": [1, "...truncated, total bytes: 82...", 103]
  },
  "executable": false,
  "lamports": 407438077149,
  "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
  "rentEpoch": 18446744073709552000,
  "space": 82
}

executable 필드는 mint account의 data 필드가 실행 가능한 코드가 아닌 상태를 저장하기 때문에 false입니다.

Token Program은 mint account의 data 필드에 저장되는 Mint 데이터 타입을 정의합니다.

{
  "data": {
    "type": "Buffer",
    "data": [1, "...truncated, total bytes: 82...", 103]
  },
  "executable": false,
  "lamports": 407438077149,
  "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
  "rentEpoch": 18446744073709552000,
  "space": 82
}

data 필드는 발행 권한, 총 공급량, 소수점 자릿수와 같은 직렬화된 Mint 계정 상태를 포함합니다.

Mint 계정에서 읽으려면 data 필드를 Mint 데이터 타입으로 역직렬화해야 합니다. 이는 다음 단계에서 다룹니다.

{
  "data": {
    "type": "Buffer",
    "data": [1, "...truncated, total bytes: 82...", 103]
  },
  "executable": false,
  "lamports": 407438077149,
  "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
  "rentEpoch": 18446744073709552000,
  "space": 82
}

Token Program(TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA)이 mint account를 소유합니다.

이는 mint account의 data 필드가 Token Program에 정의된 명령어로만 수정될 수 있음을 의미합니다.

{
  "data": {
    "type": "Buffer",
    "data": [1, "...truncated, total bytes: 82...", 103]
  },
  "executable": false,
  "lamports": 407438077149,
  "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
  "rentEpoch": 18446744073709552000,
  "space": 82
}

getMint() 함수는 mint account의 data 필드를 Token Program에서 정의한 Mint 데이터 타입으로 역직렬화합니다.

{
  "data": {
    "type": "Buffer",
    "data": [1, "...truncated, total bytes: 82...", 103]
  },
  "executable": false,
  "lamports": 407438077149,
  "owner": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
  "rentEpoch": 18446744073709552000,
  "space": 82
}

Solana 익스플로러에서 완전히 역직렬화된 Mint Account 데이터를 볼 수 있습니다.

address 필드는 Mint account의 주소를 포함합니다.

mint account의 주소는 Solana 네트워크에서 토큰을 식별하는 데 사용됩니다.

mintAuthority 필드는 새 토큰을 발행할 수 있는 권한을 가진 계정을 보여줍니다.

이것은 토큰의 새로운 단위를 생성할 수 있는 유일한 계정입니다.

supply 필드는 발행된 토큰의 총 수량을 보여줍니다.

이 값은 토큰의 가장 작은 단위로 표시됩니다. 표준 단위로 총 공급량을 얻으려면, supply 필드의 값을 decimals에 맞게 조정하세요.

decimals 필드는 토큰의 소수점 자릿수를 나타냅니다.

isInitialized 필드는 mint account가 초기화되었는지 여부를 나타냅니다. 이 필드는 Token Program에서 사용되는 보안 검사입니다.

freezeAuthority 필드는 token account를 동결할 수 있는 권한을 가진 주체를 보여줍니다.

동결된 token account는 계정 내 토큰을 전송하거나 소각할 수 없습니다.

tlvData 필드는 Token Extensions에 대한 추가 데이터를 포함합니다(추가 역직렬화 필요).

이 필드는 Token Extension Program(Token2022)에 의해 생성된 계정에만 관련이 있습니다.