Scaled UI Amount -laajennuksen tukeminen Solanassa

Tausta

Skaalattu UI-määrä -laajennus (Scaled UI Amount) antaa tokenien liikkeeseenlaskijoille mahdollisuuden määrittää kertoimen, jota käytetään laskettaessa käyttäjän tokenisaldon UI-määrää. Tämä mahdollistaa liikkeeseenlaskijoille rebasoivien tokenien luomisen ja asioiden kuten osakkeiden splittauksen toteuttamisen. Tämä laajennus, kuten korkoa tuottava token-laajennus, tarjoaa puhtaasti kosmeettisen UI-määrän, mikä tarkoittaa, että tiimien on tehtävä lisätyötä hyvän käyttökokemuksen tarjoamiseksi. Taustalla olevat laskelmat ja siirrot tapahtuvat kaikki käyttäen ohjelman raakamääriä.

Resurssit:

• Kehittäjädokumentaatio
• Laajennuksen Rust-koodi
• Amount to UI Amount Rust-koodi

Tiivistelmä

• Loppukäyttäjien tulisi käyttää UIAmount-arvoa (raakamäärä * kerroin) tokenin hinnalle, tokenisaldolle ja tokenmäärille aina kun mahdollista
• dApp-sovellusten ja palveluntarjoajien tulisi käyttää raakamäärää ja skaalaamattomia hintoja kaikissa laskelmissa ja muuntaa ne käyttäjille vasta lopussa
• Historiallisia hintatietoja tulee tarjota sekä skaalattuina että skaalaamattomina määrinä helpompaa integrointia varten
• Historiallisten kertoimien arvojen tulee olla saatavilla tarkkoja historiatietoja varten

Termien määritelmät

• Kerroin: staattinen päivitettävä kerroin, jota käytetään UI-määrän laskelmissa
• UIAmount: kerroin * raakamäärä (eli: skaalattu määrä)
• Raakamäärä: määrä (eli: skaalaamaton määrä)

Nykyinen saldo

Nykyinen määrä näyttöä varten

• Aina kun näytät määriä loppukäyttäjille tokeneille, jotka käyttävät skaalattua UI-määrä -laajennusta, sinun tulisi käyttää joko:
  • UIAmount/UIAmountString (suositeltu)
  • Manuaalista laskelmaa raakamäärä * kerroin
  • Suosittelemme katkaisemaan tämän arvon tokenin desimaalien määrän perusteella.
    • Esim: jos yUSD:llä on 6 desimaalia ja käyttäjällä on UIAmount 1.123456789, sinun tulisi näyttää "1.123456"

Mistä tämä data saadaan:

• Käyttäjän reaaliaikaisen saldon päivitetyt tiedot yllä mainituista määristä saat kutsumalla joko getTokenAccountBalance tai getAccountInfo -toimintoa
• Jos tarvitset tietää käyttöliittymämäärän (UI Amount) mielivaltaiselle määrälle, voit saada tämän laskelman kutsumalla amountToUiAmountForMintWithoutSimulation (web3.js v1) -funktiota tai simuloimalla transaktiota käyttäen amountToUiAmount-toimintoa.
  • Huomaa: amountToUiAmount vaatii transaktiosimulaation, mikä tarkoittaa että se tarvitsee myös kelvollisen maksajan, jolla on saldo. Tämän vuoksi tämän ei pitäisi olla oletustapa saldon hakemiseen.

Nykyisen määrän päivittäminen

Koska liikkeeseenlaskijat voivat päivittää kerrointa milloin tahansa, voit harkita säännöllistä kyselyä tilin saldon pitämiseksi ajan tasalla. Liikkeeseenlaskijat tuskin päivittävät tätä kerrointa useammin kuin kerran päivässä. Jos kerroin on asetettu tulevalle päivämäärälle, voit automaattisesti tehdä kyselyn tänä päivitysajankohtana

Token-määrät transaktioissa (siirrot / vaihdot jne.)

• Käyttäjien tulisi syöttää määrät, jotka tulkitaan skaalatuksi "UIAmount"-arvoksi. Sovelluksen, joka käsittelee tätä, tulisi muuntaa se raakatokenmääräksi transaktiota varten.
  • Jos pyöristysongelmia ilmenee, pyöristä alaspäin ja jätä mieluummin pieni määrä "pölyä" kuin riskeeraa transaktion epäonnistuminen
  • Tämän muunnoksen tekemiseen voit käyttää uiAmountToAmountForMintWithoutSimulation (web3.js v1) -funktiota tai simuloida transaktiota käyttäen amountToUiAmount-toimintoa.
• Sovellusten tulisi käyttää kokonaisraakaarvoa, kun käyttäjä pyytää toimintoa "maksimi" tai "kaikki" saldostaan. Tämä varmistaa, ettei pölyä jää jäljelle.
  • Valinnainen: Voit harkita tilin automaattista sulkemista, kun "maksimi" on käytössä, jotta käyttäjä saa tallennustalletuksensa takaisin

Tokenin hinta

• Tokenin hinta tulisi aina näyttää skaalattuna hintana aina kun mahdollista.
• Jos olet hintatietopalvelun tarjoaja, kuten oraakkeli, sinun tulisi tarjota sekä skaalattu että skaalaamaton hinta.
  • Tarjoa mahdollisuuksien mukaan SDK/API, joka abstrahoi skaalatun käyttöliittymämäärän laajennuksen monimutkaisuudet pois.

Nykyinen kerroin

• Nykyinen kerroin voidaan lukea token-mintistä milloin tahansa kutsumalla getAccountInfo. Lisäksi, jos tulevaisuuden kerroin on asetettu, tämä tieto on myös saatavilla token-mintistä. Suosittelemme, että tätä kerrointa ei näytetä, sillä se voi sekoittaa käyttökokemusta.

Historialliset tiedot

Historialliset tiedot hintatiedoille

• Palveluiden, jotka tarjoavat historiallisia tietoja, tulisi tallentaa ja tuoda esiin sekä skaalatut että skaalaamattomat hinnat skaalattua käyttöliittymämäärän laajennusta varten.
• Odotamme, että skaalattuja määriä käytetään useimmiten, sillä tämä vastaa sitä, miten perinteinen rahoitusmaailma käsittelee kaavioita, jotka liittyvät tokeneihin, joilla on osakkeiden splittauksia.

Historialliset tiedot määrille

• Jos haluat näyttää aiemmin siirretyn saldon, tarvitset pääsyn kertoimeen kyseisessä slotissa. Voit myös tallentaa UiAmount-arvon siirroille käsitellessäsi transaktioita välttääksesi tämän laskutoimituksen tekemisen tulevaisuudessa.

Taaksepäin yhteensopivuus

• Oletusarvoisesti lompakot ja sovellukset, jotka eivät ymmärrä skaalattua käyttöliittymämäärän laajennusta, näyttävät toiminnan oikean kokonaishinnan kertomalla skaalaamattoman hinnan * raakamäärän.
• Ne kuitenkin näyttäisivät skaalaamattoman hinnan, mikä voi aiheuttaa käyttäjille hämmennystä.
• Toivomme tämän kannustavan tiimejä päivittämään dappinsa yhteensopiviksi tokenien kanssa, jotka käyttävät skaalattua käyttöliittymämäärän laajennusta, ja olemme mielellämme tukena tässä prosessissa.

Suositellut integraatioprioriteetit alustoittain

Yleiset vaatimukset

---

Lompakot

---

Selaimet

---

Markkinadatan kokoajat (esim. CoinGecko)

---

Hintasyötteiden tarjoajat

---

DEXit