ネットワークからの読み取り

Solanaにおける「ウォレット」は、Solanaの組み込みプログラムの一つであるSystem Programが所有するアカウントです。ウォレットアカウントは主にSOL（lamportsフィールドで追跡される）の保持とトランザクションの署名に使用されます。

ウォレットアカウントを取得すると、レスポンスには例の出力に示されているフィールドが含まれます。

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

dataフィールドには、バイトとして保存されたアカウントのデータが含まれています。

ウォレットアカウントの場合、このフィールドは空（0バイト）です。他のアカウントはこのフィールドを使用して、プログラムの状態または実行可能なプログラムコードのいずれかを保存します。

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

executableフィールドは、アカウントのdataフィールドに実行可能なプログラムコードが含まれているかどうかを示します。

ウォレットおよびプログラム状態を保存するアカウントの場合、このフィールドはfalseです。

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

lamportsフィールドには、lamportで表示されたアカウントのSOL残高が含まれています。

lamportはSOLの最小単位です。1 SOL = 1,000,000,000 lamportです。

{
  "data": {
    "type": "Buffer",
    "data": []
  },
  "executable": false,
  "lamports": 1000000000,
  "owner": "11111111111111111111111111111111",
  "rentEpoch": 0,
  "space": 0
}

ownerフィールドは、アカウントを所有するプログラムを示します。

ウォレットの場合、所有者は常にSystem Programであり、アドレスは 11111111111111111111111111111111です。

rentEpochフィールドは、アカウントがネットワーク上でデータを維持するために「rent」（lamport単位）を課金する廃止されたメカニズムからの古いフィールドです。

このフィールドは現在使用されていませんが、後方互換性のために含まれています。

spaceフィールドは、dataフィールド内のバイト数を示します。これはAccount型自体のフィールドではありませんが、レスポンスに含まれています。

この例では、dataフィールドに0バイトのデータが含まれているため、spaceフィールドは0です。

Token ProgramはSolana上の実行可能なprogram accountです。ウォレットアカウントと同様に、プログラムも同じ基本的なAccountデータ構造を持っていますが、そのフィールドには重要な違いがあります。

executableフィールドはtrueに設定されており、このアカウントのdataフィールドに実行可能なプログラムコードが含まれていることを示しています。

プログラムアカウントでは、dataフィールドにプログラムの実行可能コードが格納されます。対照的に、ウォレットアカウントのデータフィールドは空です。

Solanaプログラムをデプロイすると、プログラムの実行可能コードはアカウントのdataフィールドに格納されます。

実行可能なプログラムアカウントには、アカウントのownerとして指定されたプログラムもあります。

すべてのプログラムアカウントは、Loaderプログラムによって所有されています。Loaderプログラムは、Solana上で実行可能なプログラムアカウントを所有する組み込みプログラムのカテゴリです。

Token Programの場合、ownerはBPFLoader2プログラムです。

この例で注目すべき重要なポイントは、Mint accountが実行可能なコードではなく状態を保存するということです。

Mint accountはToken Programによって所有され、Token ProgramにはMint accountの作成と更新方法を定義するinstructionsが含まれています。

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

executableフィールドはfalseです。これはmint accountのdataフィールドが実行可能なコードではなく状態を保存するためです。

Token ProgramはMintデータ型を定義しており、これはmint accountのdataフィールドに保存されます。

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

dataフィールドには、ミント権限、総供給量、小数点以下の桁数などのシリアライズされたMintアカウント状態が含まれています。

Mint accountから読み取るには、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で定義されたinstructionsによってのみ変更できることを意味します。

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

*tsgetMint()*関数は、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
}

完全にデシリアライズされた Mint Account データはSolana Explorerで確認できます。

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)によって作成されたアカウントにのみ関連しています。