계정

솔라나 네트워크의 모든 데이터는 계정에 저장됩니다. 솔라나 네트워크를 단일 계정 테이블이 있는 공개 데이터베이스로 생각할 수 있습니다. 계정과 그 주소 간의 관계는 키-값 쌍과 유사하며, 키는 주소이고 값은 계정입니다.

각 계정은 동일한 기본 구조를 가지며 주소를 사용하여 찾을 수 있습니다.

3개의 계정과 그 주소를 보여주는 다이어그램. 계정 구조 정의 포함.

계정 주소

계정 주소는 솔라나 블록체인에서 계정을 찾는 데 사용되는 32바이트 고유 ID입니다. 계정 주소는 종종 base58로 인코딩된 문자열로 표시됩니다. 대부분의 계정은 Ed25519 공개 키를 주소로 사용하지만, 솔라나는 Program Derived Address도 지원하므로 이는 필수가 아닙니다.

base58로 인코딩된 공개 키 주소를 가진 계정

공개 키

아래 예제는 Solana SDK를 사용하여 keypair를 생성하는 방법을 보여줍니다.

import { generateKeyPairSigner } from "@solana/kit";

// Kit does not enable extractable private keys
const keypairSigner = await generateKeyPairSigner();
console.log(keypairSigner);

import { generateKeyPairSigner } from "@solana/kit";

// Kit does not enable extractable private keys
const keypairSigner = await generateKeyPairSigner();
console.log(keypairSigner);

Program Derived Address

Program Derived Address(PDA)는 프로그램 ID와 하나 이상의 선택적 입력(시드)을 사용하여 결정론적으로 도출되는 주소입니다. 아래 예제는 Solana SDK를 사용하여 Program Derived Address를 생성하는 방법을 보여줍니다.

import { Address, getProgramDerivedAddress } from "@solana/kit";

const programAddress = "11111111111111111111111111111111" as Address;

const seeds = ["helloWorld"];
const [pda, bump] = await getProgramDerivedAddress({
  programAddress,
  seeds
});

console.log(`PDA: ${pda}`);
console.log(`Bump: ${bump}`);

import { Address, getProgramDerivedAddress } from "@solana/kit";

const programAddress = "11111111111111111111111111111111" as Address;

const seeds = ["helloWorld"];
const [pda, bump] = await getProgramDerivedAddress({
  programAddress,
  seeds
});

console.log(`PDA: ${pda}`);
console.log(`Bump: ${bump}`);

계정 구조

모든 Account는 최대 크기가 10MiB이며 다음 정보를 포함합니다:

• lamports: 계정에 있는 lamports의 수
• data: 계정의 데이터
• owner: 계정을 소유한 프로그램의 ID
• executable: 계정이 실행 가능한 바이너리를 포함하는지 여부를 나타냄
• rent_epoch: 더 이상 사용되지 않는 rent epoch 필드

pub struct Account {
    /// lamports in the account
    pub lamports: u64,
    /// data held in this account
    #[cfg_attr(feature = "serde", serde(with = "serde_bytes"))]
    pub data: Vec<u8>,
    /// the program that owns this account. If executable, the program that loads this account.
    pub owner: Pubkey,
    /// this account's data contains a loaded program (and is now read-only)
    pub executable: bool,
    /// the epoch at which this account will next owe rent
    pub rent_epoch: Epoch,
}

// Example Token Mint Account
Account {
    lamports: 1461600,
    data.len: 82,
    owner: TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb,
    executable: false,
    rent_epoch: 0,
    data: 010000001e213c90625a7e643d9555bb01b6c3fe6416d7afd523ce8c7ddd9b923ceafb9d00000000000000000901010000001e213c90625a7e643d9555bb01b6,
}

// Example Token Program Account
Account {
    lamports: 4513200894,
    data.len: 134080,
    owner: BPFLoader2111111111111111111111111111111111,
    executable: true,
    rent_epoch: 18446744073709551615,
    data: 7f454c460201010000000000000000000300f70001000000d8f90000000000004000000000000000800902000000000000000000400038000400400009000800,
}

계정 유형

계정은 두 가지 기본 카테고리로 나뉩니다:

• Program accounts: 실행 가능한 코드를 포함하는 계정
• Data accounts: 실행 가능한 코드를 포함하지 않는 계정

이러한 분리는 프로그램의 실행 가능한 코드와 상태가 별도의 계정에 저장된다는 것을 의미합니다. (일반적으로 프로그램과 해당 데이터에 대해 별도의 파일을 가지는 운영 체제와 유사합니다.)

Program accounts

모든 프로그램은 로더 프로그램이 소유하며, 이는 계정을 배포하고 관리하는 데 사용됩니다. 새로운 프로그램이 배포될 때, 실행 가능한 코드를 저장하기 위한 계정이 생성됩니다. 이를 program account라고 합니다. (간단히 말해서, program account를 프로그램 자체로 간주할 수 있습니다.)

아래 다이어그램에서 로더 프로그램이 program account를 배포하는 데 사용되는 것을 볼 수 있습니다. program account의 data에는 실행 가능한 프로그램 코드가 포함되어 있습니다.

프로그램 계정, 그 4가지 구성 요소 및 로더 프로그램의 다이어그램.

Program data accounts

loader-v3를 사용하여 배포된 프로그램은 data 필드에 프로그램 코드를 포함하지 않습니다. 대신, 그들의 data는 프로그램 코드를 포함하는 별도의 program data account를 가리킵니다. (아래 다이어그램 참조.)

System 계정

SOL이 처음으로 새 주소로 전송될 때, System Program이 소유한 계정이 해당 주소에 자동으로 생성됩니다.

아래 예제에서는 새 keypair가 생성되고 SOL로 자금이 지원됩니다. 코드를 실행하여 출력을 확인하세요. 계정의 owner 필드가 주소 11111111111111111111111111111111인 System Program임을 주목하세요.

import {
  airdropFactory,
  createSolanaRpc,
  createSolanaRpcSubscriptions,
  generateKeyPairSigner,
  lamports
} from "@solana/kit";

// Create a connection to Solana cluster
const rpc = createSolanaRpc("http://localhost:8899");
const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");

// Generate a new keypair
const keypair = await generateKeyPairSigner();
console.log(`Public Key: ${keypair.address}`);

// Funding an address with SOL automatically creates an account
const signature = await airdropFactory({ rpc, rpcSubscriptions })({
  recipientAddress: keypair.address,
  lamports: lamports(1_000_000_000n),
  commitment: "confirmed"
});

const accountInfo = await rpc.getAccountInfo(keypair.address).send();
console.log(accountInfo);

import {
  airdropFactory,
  createSolanaRpc,
  createSolanaRpcSubscriptions,
  generateKeyPairSigner,
  lamports
} from "@solana/kit";

// Create a connection to Solana cluster
const rpc = createSolanaRpc("http://localhost:8899");
const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");

// Generate a new keypair
const keypair = await generateKeyPairSigner();
console.log(`Public Key: ${keypair.address}`);

// Funding an address with SOL automatically creates an account
const signature = await airdropFactory({ rpc, rpcSubscriptions })({
  recipientAddress: keypair.address,
  lamports: lamports(1_000_000_000n),
  commitment: "confirmed"
});

const accountInfo = await rpc.getAccountInfo(keypair.address).send();
console.log(accountInfo);

Sysvar 계정

Sysvar 계정은 클러스터 상태 데이터에 접근할 수 있게 해주는 미리 정의된 주소에 있는 특별한 계정입니다. 이 계정들은 네트워크 클러스터에 관한 데이터로 동적으로 업데이트됩니다. Sysvar 계정의 전체 목록은 여기에서 확인할 수 있습니다.

다음 예제는 Sysvar Clock 계정에서 데이터를 가져와 역직렬화하는 방법을 보여줍니다.

import { createSolanaRpc } from "@solana/kit";
import { fetchSysvarClock, SYSVAR_CLOCK_ADDRESS } from "@solana/sysvars";

const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");

const accountInfo = await rpc
  .getAccountInfo(SYSVAR_CLOCK_ADDRESS, { encoding: "base64" })
  .send();
console.log(accountInfo);

// Automatically fetch and deserialize the account data
const clock = await fetchSysvarClock(rpc);
console.log(clock);

import { createSolanaRpc } from "@solana/kit";
import { fetchSysvarClock, SYSVAR_CLOCK_ADDRESS } from "@solana/sysvars";

const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");

const accountInfo = await rpc
  .getAccountInfo(SYSVAR_CLOCK_ADDRESS, { encoding: "base64" })
  .send();
console.log(accountInfo);

// Automatically fetch and deserialize the account data
const clock = await fetchSysvarClock(rpc);
console.log(clock);

Program Account

Solana 프로그램을 배포하면 실행 가능한 program account가 생성됩니다. program account는 프로그램의 실행 가능한 코드를 저장합니다. program account는 로더 프로그램이 소유합니다.

Program Account

간단히 말해서, program account를 프로그램 자체로 취급할 수 있습니다. 프로그램의 명령을 호출할 때, program account의 주소(일반적으로 "Program ID"라고 불림)를 지정합니다.

다음 예제는 Token Program 계정을 가져와 program account가 동일한 기본 Account 유형을 가지고 있음을 보여주지만, executable 필드가 true로 설정되어 있습니다. program account는 데이터 필드에 실행 가능한 코드를 포함하고 있기 때문에, 데이터를 역직렬화하지 않습니다.

import { Address, createSolanaRpc } from "@solana/kit";

const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");

const programId = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address;

const accountInfo = await rpc
  .getAccountInfo(programId, { encoding: "base64" })
  .send();
console.log(accountInfo);

import { Address, createSolanaRpc } from "@solana/kit";

const rpc = createSolanaRpc("https://api.mainnet-beta.solana.com");

const programId = "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" as Address;

const accountInfo = await rpc
  .getAccountInfo(programId, { encoding: "base64" })
  .send();
console.log(accountInfo);

버퍼 계정

Loader-v3는 배포 또는 업그레이드 중에 프로그램 업로드를 임시로 준비하기 위한 특별한 계정 유형을 가지고 있습니다.

프로그램 데이터 계정

Loader-v3는 다른 모든 BPF 로더 프로그램과 다르게 작동합니다. program account는 실제 실행 가능한 코드를 저장하는 프로그램 데이터 계정의 주소만 포함합니다:

프로그램 데이터 계정

이러한 프로그램 데이터 계정을 프로그램의 데이터 계정(아래 참조)과 혼동하지 마세요.

데이터 계정

솔라나에서는 프로그램의 실행 코드가 프로그램의 상태와 다른 계정에 저장됩니다. 이는 운영 체제가 일반적으로 프로그램과 해당 데이터를 위한 별도의 파일을 가지는 방식과 유사합니다.

상태를 유지하기 위해 프로그램은 자신이 소유한 별도의 계정을 생성하는 명령을 정의합니다. 이러한 각 계정은 고유한 주소를 가지며 프로그램에 의해 정의된 임의의 데이터를 저장할 수 있습니다.

데이터 계정