Solana SPL-Token Metaplex Metadata

Oma Tokeni Solana Lohkoketjussa

Jari Vennes

Artist and/or Coder

12. helmikuuta 2025

Solana lohkoketjussa on kolmea tyyppiä Tokeneita

1. Vaihdettava - fungible tokens (FT)
2. Osittain vaihdettava - Semi-fungible tokens (SFT)
3. Ei vaihdettava - Non-fungible Tokens (NFT)

Vaikka NFT on etenkin taiteilijoille se kiinnostain Tokeni, nyt kuitenkin keskitytään vaihdettaviin tokeneihin eli rahakkeisiin. Kun puhutaan SPL- tokeneista, SPL on Solana Program Library, se on ohjelmistokirjasto jolla luodaan ja hallitaan tokeneita. Tokenit tarvitsevat myös metatiedoston (Metadata), tokenien metadataan liittyvät tiedot, kuten "primarySaleHappened", "freezeAuthority", "creators", "collection" ja "uses", ovat tyypillisesti osa Metaplex-standardia. Metaplex onkin yleisin ja suosituin tapa hallita tokenien metadataa Solanassa.

Kuvassa on tekemäni ohjelman frontend, ja se käyttää Metaplex:sia. Ohjelmaa ei ole vielä julkaistu.

Kirjoitin tämän Kysymys Vastaus muotoon ... ehkä helpompi ymmärtää näin? ... tai sitten ei.

tekstin muotoilussa auttoi Gemini AI.

Kysymys: Pitääkö arvo "primary Scale Happened"-arvo asettaa "true"-tilaan, kun ensimmäinen tokeni myydään?

Vastaus: Kyllä pitää, tämä on tärkeää, koska sen jälkeen arvoa ei voi enää muuttaa takaisin "false"-tilaan. Tämä on tarkoituksellista ja liittyy tokenin historiaan ja omistajuuteen. Kun ensi myynti on tapahtunut, se on peruuttamaton tosiasia.

On kuitenkin hyvä tietää, että "primarySaleHappened"-arvon muuttaminen ei vaikuta tokenin perustoimintoihin tai siirrettävyyteen. Se on enemmänkin kirjanpidollinen tieto, joka voi olla hyödyllinen esimerkiksi jälkimarkkinoiden transaktioissa.

Kysymys: Kun laitoin "primarySaleHappened" arvoon "true" Tokeniin ilmaantui uusi ominaisuus "Freeze Authority" ja se on sama kuin "Mint Authority" ??

Vastaus: Kyllä, se on täysin oikein ja odotettavissa oleva toimintatapa. Kun muutat “primaryScaleHappened” arvon true:ksi, se usein laukaisee tiettyjä toimintoja tokeneissa, jotka on suunniteltu ensi myynnin jälkeiseen tilaan. Yksi yleinen seuraus on jäädytys valtuuden (Freeze Authority) asettaminen.

Tarkemmin selitettynä:

• Mint Authority (Lyönti Valtuus): Tämä valtuus hallitsee uusien tokenien luomista (lyömistä). Kun luot uuden tokenin, sinulla on Mint Authority.
• Freeze Authority (Jäädytys Valtuus): Tämä valtuus mahdollistaa tokenien jäädyttämisen tietyiltä tileiltä. Jäädytetyt tokenit eivät ole siirrettävissä. Tämä on hyödyllinen ominaisuus esimerkiksi silloin, kun halutaan estää varastettujen tai luvattomien tokenien siirtäminen.

Kun “primary Scale Happened” muuttuu true:ksi, protokolla tai älysopimus usein siirtää tai asettaa Freeze Authority. Tavallisesti se asetetaan samaksi kuin Mint Authority. Tämä tarkoittaa, että sama taho, joka alun perin pystyi lyömään uusia tokeneita, voi nyt myös jäädyttää tokeneita.

Miksi näin tehdään?

Tämä mekanismi on yleinen käytäntö, koska se mahdollistaa tokenin luojan hallita tokenien jakelua ja turvallisuutta myös ensimyynnin jälkeen. Esimerkiksi, jos tokeneita myydään ennakkoon ja myöhemmin havaitaan väärinkäytöksiä, Freeze Authority avulla voidaan estää näiden tokenien siirtäminen.

Onko tämä aina näin?

Vaikka tämä on yleinen käytäntö, se ei ole täysin kiveen hakattu. Tokenin luoja voi määritellä älysopimuksessa aivan erilaisen logiikan sille, mitä tapahtuu, kun primarySaleHappened muuttuu true:ksi. Mutta juuri kuvailemasi toiminta, jossa Freeze Authority asetetaan samaksi kuin Mint Authority, on hyvin tyypillinen ja järkevä ratkaisu.

Yhteenveto:

Kyllä, Freeze Authorityn ilmestyminen ja sen asettaminen samaksi kuin Mint Authority on odotettavissa oleva ja usein toivottu seuraus siitä, että primarySaleHappened-arvo muuttuu true:ksi. Se on osa tokenin elinkaaren hallintaa ja turvallisuutta.

Kysymys: SPL vaihdettavissa tokeneissa voidaan myös asettaa "seller fee basis points" arvoksi jokin luku esim 250 joka on 2,5%

Vastaus: Kyllä, "seller_fee_basis_points" -arvon asettaminen on mahdollista myös SPL-vaihdettavissa tokeneissa, vaikka se onkin yleisemmin tunnettu NFT:iden yhteydessä. Se ei ole ominaisuus, joka on vain NFT:eille tarkoitettu, vaan se on osa SPL-token standardia ja siten käytettävissä myös vaihdettavissa tokeneissa.

Mitä "seller_fee_basis_points" tarkoittaa?

Tämä arvo ilmaisee myyntipalkkion suuruuden, joka peritään tokenin myynnistä. Se ilmaistaan basis pointeina, mikä tarkoittaa sadasosia prosentista. Esimerkiksi arvo 250 tarkoittaa 2,5 %:n myyntipalkkiota. Tämä palkkio maksetaan yleensä tokenin luojalle tai jollekin muulle määritellylle taholle.

Kysymys: sitten on vielä sellaisia arvoja kuten "creators" "collection" ja "uses" pitääkö tai voidaanko näitä käyttää myös vaihdettavissa tokeneissa?

Vastaus: Kyllä, "creators", "collection" ja "uses" -arvoja voidaan käyttää myös vaihdettavissa tokeneissa, vaikka ne ovatkin yleisempiä NFT:iden yhteydessä. Nämä arvot tarjoavat lisätietoa tokenista ja sen taustasta, mikä voi olla hyödyllistä sekä NFT:ille että vaihdettaville tokeneille.

Creators (Luojat):

• Käyttö: "creators"-arvo kertoo, ketkä ovat luoneet tokenin. Tämä voi olla yksi henkilö, ryhmä tai organisaatio.
• Hyöty: Läpinäkyvyys: Antaa tietoa tokenin alkuperästä ja luojista. Luottamus: Voi lisätä luottamusta, kun tiedetään, kuka tokenin on luonut. Tekijänoikeudet: Voi olla tärkeä tekijänoikeuksien ja immateriaalioikeuksien kannalta.
• Esimerkki: Vaihdettavan tokenin luojat voisivat olla yritys, joka lanseeraa uuden kryptovaluutan, tai kehittäjäryhmä, joka luo uuden protokollan tokenin.

Collection (Kokoelma):

• Käyttö: "collection"-arvo kertoo, mihin kokoelmaan tokeni kuuluu. Tämä on yleisempi NFT:iden yhteydessä, joissa tokenit usein muodostavat osan suurempaa kokoelmaa.
• Hyöty: Järjestäminen: Helpottaa tokenien järjestämistä ja ryhmittelyä. Konteksti: Antaa lisätietoa tokenin kontekstista ja suhteesta muihin tokeneihin. Harvinaisuus: Voi olla merkitystä harvinaisuuden ja arvon kannalta (erityisesti NFT:issä).
• Esimerkki: Vaihdettavat tokenit voisivat kuulua tiettyyn protokollaan tai ekosysteemiin, jolloin "collection"-arvo kertoisi tästä.

Uses (Käyttötarkoitukset):

• Käyttö: "uses"-arvo kertoo, mihin tokenia voidaan käyttää. Tämä voi olla hyödyllistä sekä NFT:ille että vaihdettaville tokeneille.
• Hyöty: Selkeys: Selventää tokenin käyttötarkoitusta ja arvoa. Houkuttelevuus: Voi tehdä tokenista houkuttelevamman, kun sen käyttötarkoitukset ovat selkeät. Markkinointi: Auttaa markkinoinnissa ja viestinnässä.
• Esimerkki: Vaihdettavan tokenin "uses"-arvo voisi kertoa, että sitä käytetään maksuvälineenä tietyssä ekosysteemissä, hallinnointitokenina tietyssä protokollassa tai palkkiona käyttäjille.

Voidaanko näitä käyttää vaihdettavissa tokeneissa?

Kyllä, ehdottomasti voidaan. Vaikka nämä arvot ovat yleisempiä NFT:iden yhteydessä, ne ovat osa SPL-token standardia ja siten käytettävissä myös vaihdettavissa tokeneissa.

Onko niiden käyttö suositeltavaa?

Se riippuu tokenisi käyttötarkoituksesta ja tavoitteistasi. Jos haluat tarjota lisätietoa tokenistasi ja sen taustasta, näiden arvojen käyttö voi olla hyödyllistä. Ne voivat parantaa läpinäkyvyyttä, lisätä luottamusta ja selventää tokenin käyttötarkoitusta.

Yhteenveto:

"creators", "collection" ja "uses" -arvoja voidaan käyttää sekä NFT:issä että vaihdettavissa tokeneissa. Ne tarjoavat lisätietoa tokenista ja sen taustasta, mikä voi olla hyödyllistä eri tavoin. Kannattaa harkita näiden arvojen käyttöä, jos ne voisivat tuoda lisäarvoa tokenillesi ja sen ekosysteemille.

Kysymys: Siis voiko vaihdettavassa tokenissakin olla älysopimus?

Vastaus: Kyllä, ehdottomasti voi ja usein onkin älysopimus. Itse asiassa, älysopimus on se, mikä määrittelee tokenin toiminnan.

Tässä on syy, miksi vaihdettavissa tokeneissa yleensä on älysopimus ja mitä se mahdollistaa:

• Tokenin logiikka: Älysopimus sisältää kaikki säännöt ja logiikan, jotka liittyvät tokeniin. Tähän sisältyy muun muassa:
• Standardit: Useimmat vaihdettavat tokenit noudattavat tiettyjä standardeja, kuten ERC-20 (Ethereum), SPL (Solana) tai muita vastaavia. Nämä standardit määrittelevät tietyt rajapinnat ja toiminnallisuudet, jotka tokenin älysopimuksen tulee toteuttaa. Standardit helpottavat eri sovellusten ja palveluiden yhteensopivuutta tokenien kanssa.
• Automaattisuus ja läpinäkyvyys: Älysopimus suorittaa kaikki toiminnot automaattisesti ja läpinäkyvästi. Kun esimerkiksi siirtää tokeneita lompakosta toiseen, älysopimus tarkistaa, että sinulla on riittävästi saldoa, suorittaa siirron ja päivittää saldot molemmissa lompakoissa. Kaikki tämä tapahtuu automaattisesti ja on kirjattu lohkoketjuun, joten se on julkisesti nähtävissä ja tarkistettavissa.
• Muuttumattomuus: Kun älysopimus on kerran julkaistu lohkoketjuun, sitä ei yleensä voi enää muuttaa. Tämä takaa, että tokenin säännöt ovat vakaat ja ennustettavat. Toki joissain tapauksissa voidaan käyttää päivitys mekanismeja, mutta nekin ovat yleensä tarkasti määriteltyjä ja säänneltyjä.

Yhteenveto:

Älysopimus on olennainen osa vaihdettavien tokenien toimintaa. Se määrittelee tokenin logiikan, mahdollistaa automaattiset ja läpinäkyvät transaktiot ja takaa tokenin sääntöjen vakauden. Ilman älysopimusta vaihdettavat tokenit eivät olisi mahdollisia nykyisessä muodossaan.

Kysymys: Eli voinko siis kirjoittaa Rust ohjelmointikielellä omalle Tokenille älysopimuksen?

Vastaus: Kyllä, voit ehdottomasti kirjoittaa Rust-ohjelmointikielellä älysopimuksen omalle tokenillesi, erityisesti jos olet tekemisissä Solana-lohkoketjun kanssa. Solana käyttää Rustia ensisijaisena kielenä älysopimusten kehittämiseen. Ethereumissa taas yleisempi kieli on Solidity.

Muita kieliä mitä voi käyttää on esim. C++ ja C, tulkattuja ohjelmointikieliä ei suositella, paitsi ehkä testausvaiheessa, koska ne voi nopeuttaa kehitystä.

Tässä on muutamia syitä, miksi Rust on hyvä valinta älysopimusten kirjoittamiseen Solanassa:

• Suorituskyky: Rust on erittäin suorituskykyinen kieli. Tämä on kriittistä lohkoketjuissa, joissa transaktioiden nopeus ja tehokkuus ovat tärkeitä. Solana on tunnettu nopeudestaan, ja Rustin käyttö auttaa varmistamaan, että älysopimukset toimivat mahdollisimman tehokkaasti.
• Turvallisuus: Rust on suunniteltu turvallisuutta silmällä pitäen. Sen tyyppijärjestelmä ja muistinhallinta auttavat välttämään yleisiä ohjelmointivirheitä, kuten muistivuotoja ja datakilpailuja, jotka voivat olla kriittisiä älysopimuksissa. Älysopimusten turvallisuus on ensiarvoisen tärkeää, koska niihin on lukittu suuria määriä kryptovaluuttaa.
• Yhteisö ja työkalut: Rustilla on aktiivinen ja kasvava yhteisö, ja sille on saatavilla hyvät työkalut älysopimusten kehittämiseen Solanassa. Solana-kehitystyökalut ovat erittäin hyödyllisiä.
• Solanan tuki: Solana-ekosysteemi on vahvasti sitoutunut Rustin käyttöön, ja monet Solanaan liittyvät projektit ja työkalut on kirjoitettu Rustilla. Tämä tekee kehitysprosessista sujuvamman ja helpomman.

Miten kirjoittaa älysopimus Rustilla Solanassa:

1. Asenna Solana-kehitystyökalut: Aloita asentamalla Solana-kehitysympäristö, joka sisältää tarvittavat työkalut, kuten Solana CLI:n ja Rust-kääntäjän.
2. Luo uusi projekti: Luo uusi Rust-projekti käyttämällä Solana-kehitystyökaluja.
3. Kirjoita älysopimus: Kirjoita älysopimus Rustilla. Voit käyttää Solana-dokumentaatiota ja esimerkkejä apuna. Älysopimuksesi tulee määritellä tokenin logiikka, kuten sen luominen, siirtäminen ja muut toiminnot.
4. Testaa älysopimus: Testaa älysopimuksesi perusteellisesti varmistaaksesi, että se toimii oikein ja on turvallinen. Solana tarjoaa tähän hyvät testaus mahdollisuudet.
5. Julkaise älysopimus: Kun olet tyytyväinen älysopimukseesi, voit julkaista sen Solana-verkkoon.

Kysymys: Eli yksinkertaistettuna, SPL vaihdettavalle tokenille kirjoitetaan koodi jota ajetaan lohkoketjussa ja tällä saadaan oma tokeni käyttäytymään halutulla tavalla?

Vastaus: Aivan oikein! Yksinkertaistettuna juuri näin se toimii.

SPL-tokenit (Solana Program Library) ovat kuin rakennuspalikoita, joiden avulla voit luoda oman kryptovaluuttasi Solana-lohkoketjussa, ja älysopimus on se joka määrittelee miten tokenisi toimii.

Etenkin Tokenin myynnissä älysopimus on välttämätön ... mutta tähän kohtaan palataan myöhemmin.