Solanan tilimalli
Solanassa kaikki data tallennetaan "tileihin". Voit ajatella Solanan dataa julkisena tietokantana, jossa on yksi "Tilit"-taulu, jossa jokainen taulun rivi on "tili". Jokaisella Solanan tilillä on sama Account-tyyppi.
Tilit
Keskeiset kohdat
- 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 tiliä 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.
- Program account -tilit tallentavat älysopimusten suoritettavan koodin.
- Datatilit 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 tilin vastaava lohkoketjudata. Tiliosoite toimii "yksilöllisenä tunnisteena" jokaiselle riville "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 keysconst 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 voidaan 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}`);
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ä usein tallentaa tilaa, jota on tarkoitus lukea. Ohjelmatilien (älysopimusten) kohdalla 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 lamportia).owner
: Ohjelman tunnus (julkinen avain) ohjelmalle, joka omistaa tämän tilin. Vain omistajaohjelma voi muuttaa tilin dataa tai vähentää sen lamport-saldoa.rent_epoch
: Vanha kenttä ajalta, jolloin Solanassa oli mekanismi, joka säännöllisesti vähensi 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 accountpub 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 rentpub rent_epoch: Epoch,}
import {airdropFactory,createSolanaRpc,createSolanaRpcSubscriptions,generateKeyPairSigner,lamports} from "@solana/kit";// Create a connection to Solana clusterconst rpc = createSolanaRpc("http://localhost:8899");const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");// Generate a new keypairconst keypair = await generateKeyPairSigner();console.log(`Public Key: ${keypair.address}`);// Funding an address with SOL automatically creates an accountconst 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 vuokrakynnyksen. 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
System Program
Oletusarvoisesti kaikki uudet tilit ovat System Program -ohjelman omistamia. System Program tekee muutamia keskeisiä asioita:
- Uusien tilien luominen: Vain System Program voi luoda uusia tilejä.
- Tilan varaaminen: Määrittää tavukapasiteetin kunkin tilin data-kentälle.
- Omistajuuden siirto / määrittäminen: Kun System Program on luonut tilin, se voi uudelleenmäärittää nimetyn ohjelman omistajan toiseksi program account -tiliksi. Näin mukautetut ohjelmat ottavat omistukseensa System Program -ohjelman luomia uusia tilejä.
Kaikki Solanan "lompakkotilit" ovat vain System Program -ohjelman omistamia tilejä. Näiden tilien lamport-saldo osoittaa lompakon omistaman SOL-määrän. Vain System Program -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 verkkoklusteria koskevilla 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);
Program account
Solana-ohjelman käyttöönotto luo suoritettavan program accountin. Program account tallentaa ohjelman suoritettavan koodin.
Program accountien omistaja on Loader-ohjelma.
Program account
Yksinkertaisuuden vuoksi voit käsitellä program accountia itse ohjelmana. Kun kutsut ohjelman ohjeita, määrität program accountin osoitteen (jota 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);
Kun otat Solana-ohjelman käyttöön, se tallennetaan program accountiin. Program accountien omistaja on Loader-ohjelma. Loaderista on useita versioita, mutta kaikki paitsi loader-v3 tallentavat suoritettavan koodin suoraan program accountiin. Loader-v3 tallentaa suoritettavan koodin erilliseen "program data accountiin", ja program account vain osoittaa siihen. Kun otat käyttöön uuden ohjelman, Solana CLI käyttää oletusarvoisesti uusinta loader-versiota.
Buffer-tili
Loader-v3:ssa on erityinen tilityyppi ohjelman väliaikaista latausta varten käyttöönoton tai uudelleenkäyttöönoton/päivitysten aikana. Loader-v4:ssä on edelleen puskureita, mutta ne ovat vain tavallisia program accounteja.
Program data account
Loader-v3 toimii eri tavalla kuin kaikki muut BPF Loader -ohjelmat. Program account sisältää vain program data accountin osoitteen, joka tallentaa varsinaisen suoritettavan koodin:
Ohjelmatietotili
Älä sekoita näitä ohjelmatietotilejä ohjelmien datatileihin (katso alla).
Datatili
Solanassa ohjelman suoritettava koodi tallennetaan eri tilille kuin ohjelman tila. Tämä on samankaltaista kuin käyttöjärjestelmissä, joissa ohjelmat ja niiden data ovat tyypillisesti erillisissä tiedostoissa.
Tilan ylläpitämiseksi ohjelmat määrittelevät ohjeita erillisten tilien luomiseen, jotka ne omistavat. Jokaisella näistä tileistä on oma yksilöllinen osoitteensa, ja ne voivat tallentaa mitä tahansa ohjelman määrittelemää mielivaltaista dataa.
Datatili
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, datatilin luominen mukautetulle ohjelmalle tapahtuu kahdessa vaiheessa:
- Kutsu System Program luomaan tili ja siirrä sitten omistajuus mukautetulle ohjelmalle
- Kutsu mukautettua ohjelmaa, joka nyt omistaa tilin, alustamaan tilin data ohjelman ohjeen määrittelemällä tavalla
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 exampleconst rpc = createSolanaRpc("http://127.0.0.1:8899");const rpcSubscriptions = createSolanaRpcSubscriptions("ws://localhost:8900");// Generate keypairs for fee payerconst feePayer = await generateKeyPairSigner();// Fund fee payerawait airdropFactory({ rpc, rpcSubscriptions })({recipientAddress: feePayer.address,lamports: lamports(1_000_000_000n),commitment: "confirmed"});// Generate keypair to use as address of mintconst mint = await generateKeyPairSigner();// Get default mint account size (in bytes), no extensions enabledconst space = BigInt(getMintSize());// Get minimum balance for rent exemptionconst rent = await rpc.getMinimumBalanceForRentExemption(space).send();// Instruction to create new account for mint (token 2022 program)// Invokes the system programconst createAccountInstruction = getCreateAccountInstruction({payer: feePayer,newAccount: mint,lamports: rent,space,programAddress: TOKEN_2022_PROGRAM_ADDRESS});// Instruction to initialize mint account data// Invokes the token 2022 programconst initializeMintInstruction = getInitializeMintInstruction({mint: mint.address,decimals: 9,mintAuthority: feePayer.address});const instructions = [createAccountInstruction, initializeMintInstruction];// Get latest blockhash to include in transactionconst { value: latestBlockhash } = await rpc.getLatestBlockhash().send();// Create transaction messageconst 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 transactionawait sendAndConfirmTransactionFactory({ rpc, rpcSubscriptions })(signedTransaction,{ commitment: "confirmed" });// Get transaction signatureconst 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);
Is this page helpful?