Lukeminen verkosta

Lue tietoja Solana-verkosta hakemalla eri tilejä. Tässä oppaassa selitetään Solana-tilien rakenne. Jokaisella Solana- tilillä on yksilöllinen osoite, jonka avulla tilin ketjussa oleva data paikallistetaan. Solana-tilit sisältävät joko tiladataa tai suoritettavan ohjelman.

Hae lompakkotili

Lompakkotili on tili, jonka omistaa System Program. Lompakkotilejä käytetään ensisijaisesti SOL:n säilyttämiseen ja tapahtumien allekirjoittamiseen. Kun SOL lähetetään uuteen osoitteeseen ensimmäistä kertaa, järjestelmätili luodaan automaattisesti.

Alla oleva esimerkki luo Kit-asiakkaan, luo uuden allekirjoittajan, pyytää SOL:ia uuden osoitteen rahoittamiseksi ja hakee tilin tiedot asiakkaan RPC- rajapinnasta.

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.

Kun haet lompakkotilin getAccountInfo()-funktiolla, Kit palauttaa RPC- vastauksen, joka on esitetty oikealla olevassa esimerkkitulosteessa.

Vastauksessa on kaksi ylimmän tason kenttää: context kertoo, milloin luku tapahtui, ja value sisältää RPC-metodin palauttamat tilikentät.

context-kenttä näyttää tilin lukemiseen käytetyn slot-arvon sekä vastauksen tarjoilleen RPC-rajapintaversion. Myöhempi luku voi palauttaa eri slot-arvon tai rajapintaversion.

value-kenttä sisältää RPC-metodin palauttaman tilin tilan. Seuraavat vaiheet käyvät läpi value-kentän sisällä olevat kentät siinä järjestyksessä, jossa ne esiintyvät.

Example output

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

lamports-kenttä sisältää tilin SOL-saldon mitattuna lamport-yksiköissä, jotka ovat SOL:n pienin yksikkö.

Example output

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

data-kenttä sisältää tilille tallennetun datan tavuina. RPC palauttaa tilitiedot tuplena: koodattu dataketjuna, jota seuraa koodausmuoto. Lompakkotileillä koodattu dataketju on tyhjä, koska tili tallentaa 0 tavua dataa.

Example output

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

owner-kenttä näyttää ohjelman, joka omistaa tilin. Lompakoilla omistaja on aina System Program, jonka osoite on 11111111111111111111111111111111.

Example output

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

executable-kenttä kertoo, onko tilin osoite kutsuttavissa. true tarkoittaa, että osoite edustaa ohjelmaa, joka voi käsitellä ohjeita. false tarkoittaa, että tili tallentaa tilaa, kuten lompakkosaldon tai tilin datan, eikä sitä kutsuta ohjelmana. Lompakkotilit käyttävät false-arvoa.

Example output

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

rentEpoch-kenttä on vanhentuneesta rent-mekanismista peräisin oleva perintökenttä. Kenttä palautetaan edelleen taaksepäin yhteensopivuuden vuoksi.

Example output

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

space-kenttä näyttää data-kentässä olevien tavujen määrän. space-kenttä palautetaan tilihaun vastauksessa, mutta se ei ole osa tilin tietotyyppiä.

Lompakkotilin esimerkissä space-kentän arvo on 0, koska data-kenttä sisältää 0 tavua dataa.

Example output

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