네트워크에서 읽기

Solana 네트워크에서 다양한 계정을 가져와 데이터를 읽어보세요. 이 가이드는 Solana 계정의 구조를 설명합니다. 각 Solana 계정에는 온체인 데이터를 찾는 데 사용되는 고유한 주소가 있습니다. Solana 계정은 상태 데이터 또는 실행 가능한 프로그램을 포함합니다.

지갑 계정 가져오기

지갑 계정은 System Program이 소유한 계정입니다. 지갑 계정은 주로 SOL을 보유하고 트랜잭션에 서명하는 데 사용됩니다. SOL이 처음으로 새 주소로 전송되면 시스템 계정이 자동으로 생성됩니다.

아래 예제는 Kit 클라이언트를 생성하고, 새 서명자를 생성하며, 새 주소에 자금을 지원하기 위해 SOL을 요청하고, 클라이언트의 RPC API에서 계정 데이터를 가져옵니다.

Fetch account

import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
import { solanaRpc, rpcAirdrop } from "@solana/kit-plugin-rpc";
import { generatedPayer } from "@solana/kit-plugin-signer";

const client = await createClient()
  .use(generatedPayer())
  .use(
    solanaRpc({
      rpcUrl: "http://localhost:8899",
      rpcSubscriptionsUrl: "ws://localhost:8900"
    })
  )
  .use(rpcAirdrop());

const signer = await generateKeyPairSigner();
console.log(`Address: ${signer.address}`);

// Funding an address with SOL automatically creates an account
await client.airdrop(signer.address, lamports(1_000_000_000n));

const accountInfo = await client.rpc.getAccountInfo(signer.address).send();

console.log(accountInfo);

Console

Click to execute the code.

Fetch account

import { createClient, generateKeyPairSigner, lamports } from "@solana/kit";
import { solanaRpc, rpcAirdrop } from "@solana/kit-plugin-rpc";
import { generatedPayer } from "@solana/kit-plugin-signer";

const client = await createClient()
  .use(generatedPayer())
  .use(
    solanaRpc({
      rpcUrl: "http://localhost:8899",
      rpcSubscriptionsUrl: "ws://localhost:8900"
    })
  )
  .use(rpcAirdrop());

const signer = await generateKeyPairSigner();
console.log(`Address: ${signer.address}`);

// Funding an address with SOL automatically creates an account
await client.airdrop(signer.address, lamports(1_000_000_000n));

const accountInfo = await client.rpc.getAccountInfo(signer.address).send();

console.log(accountInfo);

Console

Click to execute the code.

getAccountInfo()로 지갑 계정을 가져오면 Kit은 오른쪽 예제 출력에 표시된 RPC 응답을 반환합니다.

응답에는 두 개의 최상위 필드가 있습니다. context는 읽기가 발생한 시점을 나타내고, value는 RPC 메서드가 반환한 계정 필드를 포함합니다.

context 필드는 계정을 읽는 데 사용된 slot과 응답을 처리한 RPC API 버전을 보여줍니다. 이후 읽기에서는 다른 slot이나 API 버전이 반환될 수 있습니다.

value 필드에는 RPC 메서드가 반환한 계정 상태가 포함됩니다. 다음 단계에서는 value 내부의 필드를 나타나는 순서대로 설명합니다.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

lamports 필드에는 계정의 SOL 잔액이 포함되며, 가장 작은 SOL 단위인 lamports로 측정됩니다.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

data 필드에는 바이트로 저장된 계정 데이터가 포함됩니다. RPC는 계정 데이터를 튜플 형태로 반환합니다: 인코딩된 데이터 문자열과 인코딩 방식이 순서대로 제공됩니다. 지갑 계정의 경우, 계정에 저장된 데이터가 0바이트이므로 인코딩된 데이터 문자열은 비어 있습니다.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

owner 필드는 계정을 소유한 프로그램을 나타냅니다. 지갑의 경우, 소유자는 항상 System Program이며, 주소는 11111111111111111111111111111111입니다.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

executable 필드는 계정 주소가 호출 가능한지 여부를 나타냅니다. true는 해당 주소가 명령어를 처리할 수 있는 프로그램임을 의미합니다. false는 계정이 지갑 잔액이나 계정 데이터와 같은 상태를 저장하며, 프로그램으로 호출되지 않음을 의미합니다. 지갑 계정은 false를 사용합니다.

rentEpoch 필드는 더 이상 사용되지 않는 rent 메커니즘의 레거시 필드입니다. 이 필드는 하위 호환성을 위해 계속 반환됩니다.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}

space 필드는 data 필드에 포함된 바이트 수를 나타냅니다. space 필드는 계정 조회 응답과 함께 반환되지만, 계정의 데이터 타입에는 포함되지 않습니다.

지갑 계정 예시의 경우, data 필드에 데이터가 0바이트 포함되어 있으므로 space 필드는 0입니다.

Example output

{
  context: {
    slot: 420602714n,
    apiVersion: "3.1.6"
  },
  value: {
    lamports: 1000000000n,
    data: ["", "base64"],
    owner: "11111111111111111111111111111111",
    executable: false,
    rentEpoch: 0n,
    space: 0n
  }
}