Solanan tilimalli

Solanassa kaikki data tallennetaan "tileihin" (accounts). Voit ajatella Solanan dataa julkisena tietokantana, jossa on yksi "Tilit"-taulu, jossa jokainen taulun tietue on "tili". Jokaisella Solanan tilillä on sama perus Account-tyyppi.

Tilit

Avainasiat

• Tilit voivat tallentaa enintään 10MiB dataa, joka sisältää joko suoritettavaa ohjelmakoodia tai ohjelman tilaa.
• Tilit vaativat rent-talletuksen lamporteissa (SOL), joka on suhteessa tallennetun datan määrään, ja voit saada sen kokonaan takaisin, kun suljet tilin.
• Jokaisella tilillä on ohjelma omistaja. Vain tilin omistava ohjelma voi muuttaa sen dataa tai vähentää sen lamport-saldoa. Mutta kuka tahansa voi kasvattaa saldoa.
• Sysvar-tilit ovat erityisiä tilejä, jotka tallentavat verkon klusterin tilan.
• Ohjelma-tilit tallentavat älysopimuksien suoritettavan koodin.
• Data-tilit ovat ohjelmien luomia tilejä ohjelman tilan tallentamiseen ja hallintaan.

Tili

Jokaisella Solanan tilillä on yksilöllinen 32-tavuinen osoite, joka usein näytetään base58- koodattuna merkkijonona (esim. vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg).

Tilin ja sen osoitteen välinen suhde toimii kuin avain-arvo- pari, jossa osoite on avain, jolla paikannetaan vastaava ketjussa oleva data tilistä. Tilin osoite toimii "yksilöllisenä tunnisteena" jokaiselle tietueelle "Tilit"-taulussa.

Tilin osoite

Useimmat Solana-tilit käyttävät Ed25519 julkista avainta osoitteenaan.

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);

Vaikka julkisia avaimia käytetään yleisesti tilien osoitteina, Solana tukee myös ominaisuutta nimeltä Program Derived Addresses (PDA:t). PDA:t ovat erityisiä osoitteita, jotka voit deterministisesti johtaa ohjelmatunnuksesta ja valinnaisista syötteistä (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}`);

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}`);

Tilin tyyppi

Tilien enimmäiskoko on 10MiB ja jokaisella Solanan tilillä on sama perus Account tyyppi.

Tilin tyyppi

Jokaisella Solanan tilillä on seuraavat kentät:

• data: Tavutaulukko, joka tallentaa mielivaltaista dataa tilille. Ei-suoritettavien tilien kohdalla tämä tallentaa usein tilaa, jota on tarkoitus lukea. Ohjelmatileille (älysopimukset) tämä sisältää suoritettavan ohjelmakoodin. Data-kenttää kutsutaan yleisesti "tilin dataksi".
• executable: Tämä lippu näyttää, onko tili ohjelma.
• lamports: Tilin saldo lamporteissa, joka on SOL:n pienin yksikkö (1 SOL = 1 miljardi lamport).
• owner: Ohjelman tunnus (julkinen avain) ohjelmalle, joka omistaa tämän tilin. Vain omistava ohjelma voi muuttaa tilin dataa tai vähentää sen lamport-saldoa.
• rent_epoch: Vanha kenttä ajalta, jolloin Solanassa oli mekanismi, joka vähensi säännöllisesti lamporteja tileiltä. Vaikka tämä kenttä on edelleen olemassa Account-tyypissä, sitä ei enää käytetä, koska rent-keräys on poistettu käytöstä.

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,
}

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);

Rent

Tietojen tallentamiseksi lohkoketjuun tileillä on oltava myös lamport (SOL) -saldo, joka on suhteessa tilille tallennetun tiedon määrään (tavuina). Tätä saldoa kutsutaan nimellä "rent", mutta se toimii enemmän talletuksen tavoin, koska voit palauttaa koko summan, kun suljet tilin. Löydät laskentakaavan täältä käyttäen näitä vakioita.

Termi "rent" tulee vanhentuneesta mekanismista, joka vähensi säännöllisesti lamporteja tileiltä, jotka jäivät alle rent-kynnysarvon. Tämä mekanismi ei ole enää aktiivinen.

Ohjelman omistaja

Solanassa "älysopimuksia" kutsutaan ohjelmiksi. Ohjelman omistajuus on keskeinen osa Solanan tilirakennetta. Jokaisella tilillä on nimetty ohjelma omistajana. Vain omistajaohjelma voi:

• Muuttaa tilin data -kenttää
• Vähentää lamporteja tilin saldosta

Järjestelmäohjelma

Oletusarvoisesti kaikki uudet tilit omistaa järjestelmäohjelma. Järjestelmäohjelma tekee muutamia keskeisiä asioita:

• Uuden tilin luominen: Vain järjestelmäohjelma voi luoda uusia tilejä.
• Tilan varaaminen: Määrittää tavukapasiteetin kunkin tilin tietokentälle.
• Omistajuuden siirto / määrittäminen: Kun järjestelmäohjelma luo tilin, se voi uudelleenmäärittää nimetyn ohjelman omistajan toiseksi ohjelmatilille. Näin mukautetut ohjelmat ottavat omistukseensa järjestelmäohjelman luomia uusia tilejä.

Kaikki Solanan "lompakkotilit" ovat vain järjestelmäohjelman omistamia tilejä. Näiden tilien lamport-saldo osoittaa lompakon omistaman SOL-määrän. Vain järjestelmäohjelman omistamat tilit voivat maksaa transaktiomaksuja.

Järjestelmätili

Sysvar-tilit

Sysvar-tilit ovat erityisiä tilejä ennalta määritetyissä osoitteissa, jotka tarjoavat pääsyn klusterin tilatietoihin. Nämä tilit päivittyvät dynaamisesti verkkoklusterin tiedoilla. Täydellisen luettelon Sysvar-tileistä löydät täältä.

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

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

const SYSVAR_CLOCK_ADDRESS =
  "SysvarC1ock11111111111111111111111111111111" as Address;

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

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

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

const SYSVAR_CLOCK_ADDRESS =
  "SysvarC1ock11111111111111111111111111111111" as Address;

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

Ohjelmatili

Solana-ohjelman käyttöönotto luo suoritettavan ohjelmatiliin. Ohjelmatili tallentaa ohjelman suoritettavan koodin.

Ohjelmatilit ovat Loader-ohjelman omistamia.

Ohjelmatili

Yksinkertaisuuden vuoksi voit käsitellä ohjelmatiliä itse ohjelmana. Kun kutsut ohjelman ohjeita, määrität ohjelmatilin osoitteen (yleisesti kutsutaan "Program ID:ksi").

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);

Puskuritili

Loader-v3:ssa on erityinen tilityyppi ohjelman väliaikaista lataamista varten käyttöönoton tai uudelleenkäyttöönoton/päivitysten aikana. Loader-v4:ssä on edelleen puskureita, mutta ne ovat vain tavallisia ohjelmatilejä.

Ohjelmatietotili

Loader-v3 toimii eri tavalla kuin kaikki muut BPF Loader -ohjelmat. Ohjelmatili sisältää vain ohjelmatietotilin osoitteen, joka tallentaa varsinaisen suoritettavan koodin:

Ohjelman data-tili

Älä sekoita näitä ohjelman data-tilejä ohjelmien data-tileihin (katso alla).

Data-tili

Solanassa ohjelman suoritettava koodi tallennetaan eri tilille kuin ohjelman tila. Tämä on samankaltaista kuin miten käyttöjärjestelmät tyypillisesti erottavat ohjelmat ja niiden data eri tiedostoihin.

Ylläpitääkseen tilaa ohjelmat määrittelevät ohjeita luodakseen erillisiä tilejä, jotka ne omistavat. Jokaisella näistä tileistä on oma yksilöllinen osoitteensa ja ne voivat tallentaa mitä tahansa ohjelman määrittelemää mielivaltaista dataa.

Data-tili

Huomaa, että vain System Program voi luoda uusia tilejä. Kun System Program luo tilin, se voi sitten siirtää tai määrittää uuden tilin omistajuuden toiselle ohjelmalle.

Toisin sanoen, data-tilin luominen mukautetulle ohjelmalle vaatii kaksi vaihetta:

1. Kutsu System Program luomaan tili ja siirtämään omistajuus mukautetulle ohjelmalle
2. Kutsu mukautettua ohjelmaa, joka nyt omistaa tilin, alustamaan tilin data ohjelman ohjeiden mukaisesti

Tämä tilin luomisprosessi abstrahoidaan usein yhdeksi vaiheeksi, mutta on hyödyllistä ymmärtää taustalla oleva prosessi.

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
} from "@solana-program/token-2022";

// Create Connection, local validator in this example
const rpc = createSolanaRpc("http://127.0.0.1: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);

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
} from "@solana-program/token-2022";

// Create Connection, local validator in this example
const rpc = createSolanaRpc("http://127.0.0.1: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);