DApp-resurssien tallentaminen

Kuten edellisessä oppitunnissa opitte, IPFS käyttää sijaintiin perustuvien osoitteiden sijaan Content Identifier (CID) -tunnisteita.

• CID on itse sisällöstä laskettu kryptografinen tiiviste. Jos sisällössä muuttuu yksikin tavu, myös sen CID muuttuu.
• Tämä sisältöosoitteistus varmistaa tietojen eheyden ja muuttumattomuuden. Voitte aina tarkistaa, että käytätte juuri odottamaanne tiedostoa eikä sitä ole peukaloitu.

Tiedostot siirretään IPFS-verkkoon yleensä IPFS-komentoriviliittymän (CLI) tai koodissa käytettävän asiakaskirjaston avulla.

ipfs add -komentoa käytetään yleisesti. Se ottaa vastaan tiedoston tai hakemiston ja palauttaa sen yksilöllisen CID:n.

Esimerkiksi DApp-sovelluksen käyttöliittymän sisältävän kansion lataaminen:

ipfs add my_dapp_folder/

Komento käsittelee kansion ja tulostaa CID:n, joka edustaa sen koko sisältöä.

Kun käytätte komentoa ipfs add, sisältö tallennetaan aluksi vain paikalliseen IPFS-solmuunne. Jotta muut voivat käyttää sitä luotettavasti, sisältö on "pinnattava".

• Pinnaus tarkoittaa, että IPFS-solmua pyydetään säilyttämään tietystä sisällöstä kopio pysyvästi, jotta roskienkeruu ei poista sitä.
• Voitte pinnata sisältöä omalle IPFS-solmullenne tai DApp-sovelluksissa yleisemmin käyttää kolmannen osapuolen "pinnauspalvelua".
• Pinnauspalvelut tarjoavat sisältöänne varten tarkoitettua infrastruktuuria, mikä varmistaa DApp-resurssien hyvän saatavuuden ja käyttöajan.

Non-Fungible Tokenit (NFT:t) edustavat usein yksilöllisiä digitaalisia resursseja, kuten kuvia, videoita tai ääntä. NFT:n älysopimus ei tallenna itse resurssia suoraan.

Sen sijaan älysopimus tallentaa yleensä URI:n (Uniform Resource Identifier), joka osoittaa resurssin metadataan. Metadatan ja usein myös itse resurssin tallentaminen IPFS:ään on tärkeää:

• Se estää metadataa muuttumasta tai katoamasta, jos sitä isännöivä keskitetty palvelin menee offline-tilaan.
• Se varmistaa, että NFT:n arvo perustuu pysyvään ja todennettavissa olevaan dataan.

NFT:n metadata on yleensä JSON (JavaScript Object Notation) -tiedosto, joka sisältää kuvailevia tietoja digitaalisesta resurssista.

Se sisältää tavallisesti esimerkiksi resurssin nimen ja kuvauksen sekä linkin varsinaiseen mediatiedostoon, joka myös tallennetaan usein IPFS:ään.

Tyypillinen rakenne-esimerkki:

{
  "name": "My Awesome NFT",
  "description": "A unique digital collectible.",
  "image": "ipfs://bafybeigdyrzt5sfp7udm7hu76uh7y26h7y3g7o...",
  "attributes": [
    { "trait_type": "Background", "value": "Blue" }
  ]
}

image-kentässä käytetään esimerkiksi ipfs://-URI-mallia, joka osoittaa suoraan resurssin CID:hen IPFS:ssä.

Useimmat loppukäyttäjät eivät käytä omia IPFS-solmujaan. Miten he siis käyttävät IPFS:ään tallennettua sisältöä?

• He käyttävät sitä IPFS-yhdyskäytävien kautta.
• IPFS-yhdyskäytävä on tavallinen verkkopalvelin, joka toimii siltana. Se hakee sisältöä IPFS-verkosta pyynnöstä ja tarjoaa sitä tavallisen HTTP:n kautta verkkoselaimille.
• Suosittuja julkisia yhdyskäytäviä ovat esimerkiksi https://cloudflare-ipfs.com/ipfs/<your-CID> ja https://ipfs.io/ipfs/<your-CID>.

DApp-sovelluksen käyttöliittymäkoodi, joka on yleensä kirjoitettu JavaScriptillä, voi hakea sisältöä IPFS:stä helposti CID-tunnisteiden ja yhdyskäytävien avulla.

• DApp muodostaa tavallisen verkko-URL-osoitteen IPFS-yhdyskäytävän osoitteesta ja sisällön CID:stä.
• Sen jälkeen se hakee sisällön tavallisilla verkkopyynnöillä, kuten JavaScriptin fetch-rajapinnalla, aivan kuten minkä tahansa muun verkkoresurssin.

Seuraava on käsitteellinen JavaScript-esimerkki:

const cid = "bafybeigdyrzt5sfp7udm7hu...";
const gatewayUrl = `https://ipfs.io/ipfs/${cid}`;

fetch(gatewayUrl)
  .then(response => response.json())
  .then(data => console.log("NFT Metadata:", data))
  .catch(error => console.error("Error fetching data:", error));

Olette oppineet, miten IPFS tarjoaa hajautetun ja vankan tavan tallentaa DApp-sovelluksen keskeisiä osia, kuten käyttöliittymäresursseja ja NFT-metadataa.

• Käsittelimme tiedostojen lataamista ipfs add -komennolla sekä pinnauspalveluiden ratkaisevaa roolia sisällön säilymisessä.
• Ymmärrätte nyt, miten CID:t varmistavat muuttumattomuuden ja miten IPFS-yhdyskäytävien avulla käyttäjät voivat käyttää hajautettua sisältöä tavallisilla verkkoselaimilla.
• Nämä tiedot ovat olennaisia rakennettaessa vikasietoisia, sensuurinkestäviä ja aidosti hajautettuja DApp-sovelluksia.

Seuraavaksi tutustumme Filecoiniin, joka rakentuu IPFS:n päälle ja tarjoaa kannustimiin perustuvan ja todennettavan kerroksen pitkäaikaista ja pysyvää tallennusta varten.