Solana 계정 모델

Solana에서 모든 데이터는 "계정"이라고 불리는 곳에 저장됩니다. Solana의 데이터는 단일 "계정" 테이블이 있는 공개 데이터베이스로 생각할 수 있으며, 이 테이블의 각 항목이 "계정"입니다. 모든 Solana 계정은 동일한 기본 계정 유형을 공유합니다.

계정계정

주요 포인트

  • 계정은 최대 10MiB의 데이터를 저장할 수 있으며, 실행 가능한 프로그램 코드나 프로그램 상태를 포함합니다.
  • 계정은 저장된 데이터의 양에 비례하는 lamport(SOL) 단위의 rent 예치금이 필요하며, 계정을 닫을 때 이를 완전히 회수할 수 있습니다.
  • 모든 계정에는 프로그램 소유자가 있습니다. 계정을 소유한 프로그램만 해당 데이터를 변경하거나 lamport 잔액을 차감할 수 있습니다. 하지만 누구나 잔액을 증가시킬 수 있습니다.
  • Sysvar 계정은 네트워크 클러스터 상태를 저장하는 특별한 계정입니다.
  • program account은 스마트 컨트랙트의 실행 가능한 코드를 저장합니다.
  • 데이터 계정은 프로그램이 프로그램 상태를 저장하고 관리하기 위해 생성합니다.

계정

솔라나의 모든 계정은 고유한 32바이트 주소를 가지며, 일반적으로 base58로 인코딩된 문자열(예: 14grJpemFaf88c8tiVb77W7TYg2W3ir6pfkKz3YjhhZ5)로 표시됩니다.

계정과 주소 간의 관계는 키-값 쌍처럼 작동하며, 주소는 계정의 온체인 데이터를 찾기 위한 키 역할을 합니다. 계정 주소는 "계정" 테이블의 각 항목에 대한 "고유 ID"로 작동합니다.

계정 주소계정 주소

대부분의 Solana 계정은 Ed25519 공개 키를 주소로 사용합니다.

import { generateKeyPairSigner } from "@solana/kit";
// Kit does not enable extractable private keys
const keypairSigner = await generateKeyPairSigner();
console.log(keypairSigner);
Console
Click to execute the code.

공개 키가 일반적으로 계정 주소로 사용되지만, Solana는 프로그램 파생 주소(PDAs)라는 기능도 지원합니다. PDA는 프로그램 ID와 선택적 입력(seed)에서 결정적으로 파생할 수 있는 특별한 주소입니다.

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}`);
Console
Click to execute the code.

계정 유형

계정의 최대 크기는 10MiB이며, Solana의 모든 계정은 동일한 기본 Account 유형을 공유합니다.

계정 유형계정 유형

솔라나의 모든 계정은 다음과 같은 필드를 가집니다.

Base Account Type
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,
}

램포트 필드

계정의 잔액을 램포트(lamport)로 표시합니다. 램포트는 SOL의 최소 단위입니다(1 SOL = 10억 램포트). 계정의 SOL 잔액은 lamports 필드에 저장된 금액을 SOL로 변환한 값입니다.

솔라나 계정은 계정에 저장된 데이터 양(바이트 단위)에 비례하는 최소 램포트 잔액을 유지해야 합니다. 이 최소 잔액을 "rent"라고 합니다.

계정이 닫힐 때 계정에 저장된 램포트 잔액은 완전히 회수될 수 있습니다.

데이터 필드

계정의 임의 데이터를 저장하는 바이트 배열입니다. 데이터 필드는 일반적으로 "계정 데이터"라고 불립니다.

  • 프로그램 계정(스마트 컨트랙트)의 경우, 이 필드는 실행 가능한 프로그램 코드 자체를 포함하거나 실행 가능한 프로그램 코드를 저장하는 다른 계정의 주소를 포함합니다.
  • 실행 불가능한 계정의 경우, 일반적으로 읽기 위한 상태를 저장합니다.

솔라나 계정에서 데이터를 읽는 과정은 두 단계로 이루어집니다:

  1. 주소(공개 키)를 사용하여 계정을 가져옵니다
  2. 계정의 데이터 필드를 원시 바이트에서 적절한 데이터 구조로 역직렬화합니다. 이 데이터 구조는 계정을 소유한 프로그램에 의해 정의됩니다

소유자 필드

이 계정을 소유한 프로그램의 프로그램 ID(공개 키)입니다.

모든 솔라나 계정은 소유자로 지정된 프로그램을 가집니다. 계정을 소유한 프로그램만이 계정의 데이터를 변경하거나 램포트 잔액을 차감할 수 있습니다.

프로그램에 정의된 명령어는 계정의 데이터와 lamports 잔액을 어떻게 변경할 수 있는지 결정합니다.

실행 가능 필드

이 필드는 계정이 실행 가능한 프로그램인지 여부를 나타냅니다.

  • true인 경우, 계정은 실행 가능한 Solana 프로그램입니다.
  • false인 경우, 계정은 상태를 저장하는 데이터 계정입니다.

실행 가능한 계정의 경우, owner 필드에는 로더 프로그램의 프로그램 ID가 포함됩니다. 로더 프로그램은 실행 가능한 프로그램 계정을 로드하고 관리하는 역할을 하는 내장 프로그램입니다.

Rent Epoch 필드

rent_epoch 필드는 더 이상 사용되지 않는 레거시 필드입니다.

원래 이 필드는 계정이 네트워크에 데이터를 유지하기 위해 rent(lamports로)를 지불해야 하는 시기를 추적했습니다. 그러나 이 rent 수집 메커니즘은 이후 폐지되었습니다.

램포트 필드

계정의 잔액을 램포트(lamport)로 표시합니다. 램포트는 SOL의 최소 단위입니다(1 SOL = 10억 램포트). 계정의 SOL 잔액은 lamports 필드에 저장된 금액을 SOL로 변환한 값입니다.

솔라나 계정은 계정에 저장된 데이터 양(바이트 단위)에 비례하는 최소 램포트 잔액을 유지해야 합니다. 이 최소 잔액을 "rent"라고 합니다.

계정이 닫힐 때 계정에 저장된 램포트 잔액은 완전히 회수될 수 있습니다.

데이터 필드

계정의 임의 데이터를 저장하는 바이트 배열입니다. 데이터 필드는 일반적으로 "계정 데이터"라고 불립니다.

  • 프로그램 계정(스마트 컨트랙트)의 경우, 이 필드는 실행 가능한 프로그램 코드 자체를 포함하거나 실행 가능한 프로그램 코드를 저장하는 다른 계정의 주소를 포함합니다.
  • 실행 불가능한 계정의 경우, 일반적으로 읽기 위한 상태를 저장합니다.

솔라나 계정에서 데이터를 읽는 과정은 두 단계로 이루어집니다:

  1. 주소(공개 키)를 사용하여 계정을 가져옵니다
  2. 계정의 데이터 필드를 원시 바이트에서 적절한 데이터 구조로 역직렬화합니다. 이 데이터 구조는 계정을 소유한 프로그램에 의해 정의됩니다

소유자 필드

이 계정을 소유한 프로그램의 프로그램 ID(공개 키)입니다.

모든 솔라나 계정은 소유자로 지정된 프로그램을 가집니다. 계정을 소유한 프로그램만이 계정의 데이터를 변경하거나 램포트 잔액을 차감할 수 있습니다.

프로그램에 정의된 명령어는 계정의 데이터와 lamports 잔액을 어떻게 변경할 수 있는지 결정합니다.

실행 가능 필드

이 필드는 계정이 실행 가능한 프로그램인지 여부를 나타냅니다.

  • true인 경우, 계정은 실행 가능한 Solana 프로그램입니다.
  • false인 경우, 계정은 상태를 저장하는 데이터 계정입니다.

실행 가능한 계정의 경우, owner 필드에는 로더 프로그램의 프로그램 ID가 포함됩니다. 로더 프로그램은 실행 가능한 프로그램 계정을 로드하고 관리하는 역할을 하는 내장 프로그램입니다.

Rent Epoch 필드

rent_epoch 필드는 더 이상 사용되지 않는 레거시 필드입니다.

원래 이 필드는 계정이 네트워크에 데이터를 유지하기 위해 rent(lamports로)를 지불해야 하는 시기를 추적했습니다. 그러나 이 rent 수집 메커니즘은 이후 폐지되었습니다.

Base Account Type
pub struct Account {
/// lamports in the account
pub lamports: u64,
}
// Example Token Mint Account
Account {
lamports: 1461600,
}
// Example Token Program Account
Account {
lamports: 4513200894,
}

Rent

온체인에 데이터를 저장하기 위해, 계정은 저장된 데이터의 양(바이트 단위)에 비례하는 lamport(SOL) 잔액을 유지해야 합니다. 이 잔액을 "rent"라고 하지만, 계정을 닫을 때 전체 금액을 회수할 수 있기 때문에 보증금처럼 작동합니다. 계산 방법은 여기에서 이 상수들을 사용하여 찾을 수 있습니다.

"rent"라는 용어는 rent 임계값 미만으로 떨어진 계정에서 정기적으로 lamports를 공제하는 폐지된 메커니즘에서 유래되었습니다. 이 메커니즘은 더 이상 활성화되어 있지 않습니다.

프로그램 소유자

Solana에서 "스마트 컨트랙트"는 프로그램이라고 불립니다. 프로그램 소유권은 Solana 계정 모델의 핵심 부분입니다. 모든 계정에는 소유자로 지정된 프로그램이 있습니다. 소유자 프로그램만이:

  • 계정의 data 필드 변경
  • 계정 잔액에서 lamport 차감

각 프로그램은 계정의 data 필드에 저장된 데이터의 구조를 정의합니다. 프로그램의 명령어는 이 데이터와 계정의 lamports 잔액을 어떻게 변경할 수 있는지 결정합니다.

System Program

기본적으로 모든 새 계정은 System Program이 소유합니다. System Program은 다음과 같은 주요 기능을 수행합니다:

기능설명
새 계정 생성System Program만이 새 계정을 생성할 수 있습니다.
공간 할당각 계정의 데이터 필드에 대한 바이트 용량을 설정합니다.
프로그램 소유권 할당System Program이 계정을 생성한 후, 지정된 프로그램 소유자를 다른 프로그램 계정으로 재할당할 수 있습니다. 이것이 커스텀 프로그램이 System Program에 의해 생성된 새 계정의 소유권을 가져가는 방식입니다.
SOL 전송System 계정에서 다른 계정으로 lamport(SOL)를 전송합니다.

솔라나의 모든 "지갑" 계정은 System Program이 소유한 "System 계정"입니다. 이러한 계정의 lamport 잔액은 지갑이 소유한 SOL의 양을 나타냅니다. System 계정만이 거래 수수료를 지불할 수 있습니다.

System 계정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);
Console
Click to execute the code.

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);
Console
Click to execute the code.

Program Account

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

Program AccountProgram 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);
Console
Click to execute the code.

Solana 프로그램을 배포할 때, 이는 program account에 저장됩니다. program account는 로더 프로그램이 소유합니다. 로더의 여러 버전이 있지만, loader-v3를 제외한 모든 버전은 실행 가능한 코드를 program account에 직접 저장합니다. loader-v3는 실행 가능한 코드를 별도의 "program data account"에 저장하고 program account는 단지 이를 가리킵니다. 새 프로그램을 배포할 때, Solana CLI는 기본적으로 최신 로더 버전을 사용합니다.

버퍼 계정

Loader-v3는 배포 또는 업그레이드 중에 프로그램 업로드를 임시로 준비하기 위한 특별한 계정 유형을 가지고 있습니다. loader-v4에서도 버퍼가 여전히 존재하지만, 이들은 단지 일반적인 program account입니다.

프로그램 데이터 계정

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

프로그램 데이터 계정프로그램 데이터 계정

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

데이터 계정

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

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

데이터 계정데이터 계정

오직 System Program만이 새 계정을 생성할 수 있다는 점에 유의하세요. System Program이 계정을 생성하면, 새 계정의 소유권을 다른 프로그램에 할당할 수 있습니다.

다시 말해, 커스텀 프로그램을 위한 데이터 계정을 생성하는 것은 두 단계로 이루어집니다:

  1. System Program을 호출하여 계정을 생성한 다음, 소유권을 커스텀 프로그램으로 이전합니다
  2. 이제 계정을 소유한 커스텀 프로그램을 호출하여 프로그램의 명령에 정의된 대로 계정 데이터를 초기화합니다

이 계정 생성 프로세스는 종종 단일 단계로 추상화되지만, 기본 프로세스를 이해하는 것이 도움이 됩니다.

다음 예제는 Token 2022 프로그램이 소유한 토큰 민트 계정을 생성하고 가져오는 방법을 보여줍니다.

import {
airdropFactory,
appendTransactionMessageInstructions,
createSolanaRpc,
createSolanaRpcSubscriptions,
createTransactionMessage,
generateKeyPairSigner,
getSignatureFromTransaction,
lamports,
pipe,
sendAndConfirmTransactionFactory,
setTransactionMessageFeePayerSigner,
setTransactionMessageLifetimeUsingBlockhash,
signTransactionMessageWithSigners
} from "@solana/kit";
import { getCreateAccountInstruction } from "@solana-program/system";
import {
getInitializeMintInstruction,
getMintSize,
TOKEN_2022_PROGRAM_ADDRESS,
fetchMint
} from "@solana-program/token-2022";
// Create Connection, local validator in this example
const rpc = createSolanaRpc("http://localhost:8899");
const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");
// Generate keypairs for fee payer
const feePayer = await generateKeyPairSigner();
// Fund fee payer
await airdropFactory({ rpc, rpcSubscriptions })({
recipientAddress: feePayer.address,
lamports: lamports(1_000_000_000n),
commitment: "confirmed"
});
// Generate keypair to use as address of mint
const mint = await generateKeyPairSigner();
// Get default mint account size (in bytes), no extensions enabled
const space = BigInt(getMintSize());
// Get minimum balance for rent exemption
const rent = await rpc.getMinimumBalanceForRentExemption(space).send();
// Instruction to create new account for mint (token 2022 program)
// Invokes the system program
const createAccountInstruction = getCreateAccountInstruction({
payer: feePayer,
newAccount: mint,
lamports: rent,
space,
programAddress: TOKEN_2022_PROGRAM_ADDRESS
});
// Instruction to initialize mint account data
// Invokes the token 2022 program
const initializeMintInstruction = getInitializeMintInstruction({
mint: mint.address,
decimals: 9,
mintAuthority: feePayer.address
});
const instructions = [createAccountInstruction, initializeMintInstruction];
// Get latest blockhash to include in transaction
const { value: latestBlockhash } = await rpc.getLatestBlockhash().send();
// Create transaction message
const transactionMessage = pipe(
createTransactionMessage({ version: 0 }), // Create transaction message
(tx) => setTransactionMessageFeePayerSigner(feePayer, tx), // Set fee payer
(tx) => setTransactionMessageLifetimeUsingBlockhash(latestBlockhash, tx), // Set transaction blockhash
(tx) => appendTransactionMessageInstructions(instructions, tx) // Append instructions
);
// Sign transaction message with required signers (fee payer and mint keypair)
const signedTransaction =
await signTransactionMessageWithSigners(transactionMessage);
// Send and confirm transaction
await sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions })(
signedTransaction,
{ commitment: "confirmed" }
);
// Get transaction signature
const transactionSignature = getSignatureFromTransaction(signedTransaction);
console.log("Mint Address:", mint.address);
console.log("Transaction Signature:", transactionSignature);
const accountInfo = await rpc.getAccountInfo(mint.address).send();
console.log(accountInfo);
const mintAccount = await fetchMint(rpc, mint.address);
console.log(mintAccount);
Console
Click to execute the code.

Is this page helpful?

목차

페이지 편집