Handelsbot for ERC-1155: Avstem hver mengde

Bygg ERC-1155-boten rundt tokentyper

Den offisielle ERC-1155-spesifikasjonen beskriver et kontraktgrensesnitt som kan håndtere flere tokentyper, med saldoer som er knyttet til en konto og en token-ID. Det omfatter enkeltvise og grupperte overføringer, grupperte saldooppslag og operatørgodkjenninger. Disse mulighetene avgjør verken hvordan en markedsplass priser en utgave, eller om en bestemt ordre støtter delvis utførelse.

Bruk blokkjeden, kontrakten og token-ID-en som typeidentitet, og lagre mengden separat. En token-ID er ikke mengden som eies. Å holde feltene atskilt hindrer at en visningsidentifikator tolkes som et beløp, og lar flere anskaffelsesregistreringer bidra til én gjeldende typesaldo.

Knytt en tydelig enhetsetikett til hver mengde. Et forslag om fem utgaveenheter bør ikke forveksles med fem forskjellige tokentyper eller fem ETH i kjøpekraft. Grensesnittet kan oppsummere posisjonen, men den underliggende registreringen bør beholde nok detaljer til å gjenskape den nøyaktige tiltenkte overføringen.

Sammenligningen med en handelsbot for ERC-721 er nyttig fordi den viser et viktig modelleringsvalg. Programvare som er utformet rundt eierskap til enkeltgjenstander, bør ikke i det stille gjenbruke denne antakelsen for registreringer med mengder. Identifiser standarden som støttes, før eiendeler importeres til handelsjournalen.

Skill mellom eide, reserverte og tilgjengelige mengder

Den observerte saldoen svarer på hvor mange enheter kontoen eier etter sine verifiseringsregler. Reservert mengde svarer på hvor mange enheter som er bundet i arbeidsflyten til aktive salgs- eller overføringsintensjoner. Tilgjengelig mengde er en regelstyrt beregning som tar hensyn til disse forpliktelsene og eventuelle uavklarte avvik.

Anta at en hypotetisk konto eier 12 enheter av Lantern Edition 7. Én aktiv instruksjon reserverer fire enheter, og en annen uavklart handling gjelder to. Etter en forsiktig regel som reserverer begge, er bare seks enheter tilgjengelige for en ny instruksjon. Hvis alle 12 rapporteres som fritt tilgjengelige, ignoreres arbeidsflytens egne eksisterende forpliktelser.

Dokumenter hva som oppretter og frigjør en reservasjon. Å opprette et utkast fortjener kanskje ikke samme behandling som å godkjenne en ordre som kan utføres, men skillet må være bevisst. En kanselleringsforespørsel bør ikke frigjøre beholdning før systemet har dokumentasjonen som den faktiske utførelsesutformingen krever.

Regler for mengdereservasjon i ERC-1155 bør vedvare gjennom omstarter. Hvis reservasjonene bare finnes i minnet, kan en omstart få tidligere bundet beholdning til å fremstå som tilgjengelig igjen. Gjenskap reservasjonene fra varige intensjons- og utfallsregistreringer før neste forslag får bruke saldoen.

Spor anskaffelsespartier uten å finne på fysiske serienumre

Et anskaffelsesparti registrerer når og til hvilken kostnad kontoen fikk en mengde. Det er en regnskapsregistrering og ikke nødvendigvis en påstand om at individuelle enheter har separate serieidentiteter. Journalen kan bevare den økonomiske historikken til flere kjøp selv når enhetene deler én tokentypeidentitet.

Som illustrasjon kan kontoen anskaffe tre enheter til 0,10 ETH hver og senere to enheter til 0,14 ETH hver, før utgifter. Samlet kjøpsverdi er 0,58 ETH for fem enheter, som gir et gjennomsnitt på 0,116 ETH per enhet etter en enkel gjennomsnittskostmetode. De opprinnelige partiene bør forbli tilgjengelige selv om rapportene viser gjennomsnittet.

Velg en konsekvent konvensjon for intern styringsrapportering når anskaffelseskostnader tilordnes avhendinger. Forskjellige konvensjoner kan gi forskjellige tall per salg samtidig som kontoens samlede regnestykke fortsatt kan avstemmes. Ikke presenter den valgte metoden som universell skattebehandling; veiledningen gjelder intern strategianalyse og bevaring av registreringer.

Bevar mengden og utgiftene for hvert parti, slik at beregningen kan endres eller gjennomgås senere uten at kildedokumentasjonen går tapt. Å slå hvert kjøp sammen til ett gjennomsnitt som stadig overskrives, gjør det vanskelig å forklare et avvik eller undersøke hvilken anskaffelsesperiode som skapte den gjeldende eksponeringen.

Skill enhetspris fra ordretotal

En salgsoppføring kan uttrykke vilkår på måter som krever grundig tolkning. Forslaget må identifisere om et beløp som vises, gjelder én enhet, en gruppe enheter eller en hel ordre. Utled aldri dette skillet bare fra et NFT-bilde eller en kort prisetikett.

I et hypotetisk eksempel innebærer et tilbud om å anskaffe seks enheter for totalt 0,48 ETH en pris på 0,08 ETH per enhet før utgifter. Et tilbud om seks enheter til 0,48 ETH hver innebærer 2,88 ETH før utgifter. De samme tallene gir svært forskjellig eksponering når prisenheten misforstås.

Vis både enhetsbeløpet og den samlede forpliktelsen i gjennomgangsregistreringen. Ta med betalingseiendelen, den forespurte mengden og utgifter som kan henføres til handlingen. En kontrollør bør kunne gjenskape totalen med enkel regning før handlingen godkjennes.

Test skillet med prøveoppføringer som bevisst er tvetydige. Hvis importverktøyet ikke kan fastslå prisgrunnlaget, bør det avvise forslaget eller sende det til videre vurdering fremfor å velge en bekvem tolkning. En tilsynelatende billig utgave kan bli et dyrt kjøp når et totalprisfelt forveksles med et enhetsprisfelt eller omvendt.

Håndter delvis utførelse etter den faktiske ordren

Tokenstandarden alene fastslår ikke at en ordre kan utføres delvis. Undersøk utførelsesruten og ordrevilkårene. Når delvis utførelse støttes, bør kontoregistreringen skille mellom forespurt mengde, utført mengde, gjenværende aktiv mengde og kansellert eller utløpt mengde.

Anta at en hypotetisk ordre ber om 10 enheter, og at det verifiserte resultatet fastslår at fire enheter er anskaffet. Beholdningsregistreringen øker med fire, mens de gjenværende seks avhenger av ordrens faktiske tilstand. Å telle 10 som eid finner på beholdning; å telle hele ordren som ferdig kan føre til at en gjenværende forpliktelse glemmes.

Regnskapsføring av delvis ERC-1155-utførelse bør knytte hver utførelse til den opprinnelige intensjonen uten å overskrive tidligere utførelser. Hvis tre enheter kommer og to kommer senere, bør registreringen vise begge hendelsene og den samlede mengden på fem. Historikken bidrar til å forklare forskjeller i utgifter og tidspunkt gjennom anskaffelsen.

Bruk samme disiplin for salg. En delvis avhending reduserer den eide mengden med det verifiserte antallet og avslutter den tilsvarende delen av regnskapsposisjonen. De gjenværende enhetene beholder sin egen eksponering og kostnadsregistrering. En salgsetikett bør aldri antyde at hele utgaveposisjonen forsvant, med mindre mengdedokumentasjonen støtter det.

Bevar parene i hver gjennomgang av en gruppert handling

Når en foreslått handling inneholder flere tokentyper, bevar koblingen mellom hver identifikator og mengden dens. En gjennomgangsskjerm som lister alle identifikatorene ett sted og alle mengdene et annet, kan gjøre det vanskelig å oppdage feil kobling. Vis hvert par som én meningsenhet selv om det underliggende grensesnittet bruker tabeller med verdier.

For en oppdiktet gruppert handling kan de tiltenkte parene være Edition 7 med tre enheter, Edition 12 med én enhet og Edition 19 med seks enheter. Å bytte om to mengder endrer handlingen selv om settet av identifikatorer og settet av tall forblir de samme. Valideringen må kontrollere forholdene fremfor bare at verdiene finnes.

Definer hvordan arbeidsflyten representerer et gruppert forsøk og det verifiserte utfallet. Ikke anta at markedsplassens gruppering av utførelser er identisk med grupperingen i tokenoverføringsgrensesnittet. Kontoen bør bruke dokumentasjonen fra den faktiske ruten til å avgjøre hvilke tiltenkte endringer som skjedde.

En gjennomgang av en gruppert ERC-1155-overføring bør også identifisere mottakeren og den samlede økonomiske eksponeringen. En gruppert handling kan forenkle en operasjon og samtidig øke konsekvensene av en feil mottakeradresse eller mengdekobling. Bekvemmelighet fjerner ikke behovet for å undersøke hver vesentlig forskjellig del av forslaget.

Fordel felles utgifter på en gjennomsiktig måte

En kombinert operasjon kan medføre en utgift som ikke kommer med en separat oppdeling per type. Journalen trenger en uttrykkelig fordelingskonvensjon for intern analyse, samtidig som den faktiske totalen bevares. Lik fordeling per enhet, fordeling etter kjøpsverdi og direkte henføring der den er tilgjengelig, besvarer forskjellige rapporteringsspørsmål.

Se for deg et hypotetisk kjøp av to typer med verdier på 0,20 og 0,80 ETH og en felles utgift på 0,05 ETH. Fordeling etter kjøpsverdi tilordner henholdsvis 0,01 og 0,04 ETH. Lik fordeling mellom typene tilordner 0,025 ETH til hver. Ingen av regnestykkene endrer det samlede utlegget på 1,05 ETH, men resultatrapportene per type blir forskjellige.

Velg konvensjonen før strategier sammenlignes, dokumenter den og anvend den konsekvent. Hvis metoden endres for å få en tapende posisjon til å se bedre ut, blir analysen misvisende selv om kontototalen fortsatt stemmer. Bevar nok rådata til å beregne rapportene på nytt etter en annen rimelig konvensjon.

Hold også utgifter til mislykkede forsøk synlige. Hvis et anskaffelsesforsøk ikke gir beholdning, men medfører kostnader, har prosjektet fortsatt brukt ressurser. En rapport som er begrenset til vellykkede partier, undervurderer driftsbyrden og kan få hyppige, mislykkede forsøk til å virke økonomisk harmløse.

Modeller avslutningskapasitet for den tiltenkte mengden

En pris for én enhet fastslår ikke at en større mengde kan selges på de samme gjennomsnittlige vilkårene. Arbeidsflyten bør vurdere den tiltenkte avhendingsstørrelsen og den tilgjengelige kjøperinteressen som er relevant for den. Et lite, attraktivt pristilbud beskriver kanskje bare en brøkdel av kontoens posisjon.

Anta at kontoen eier 20 hypotetiske enheter. Kjøpere tilbyr nå 0,10 ETH for de to første enhetene, 0,08 ETH for de neste tre og ingen verifiserte vilkår for resten. Å verdsette alle 20 til 0,10 ETH antar etterspørsel som dokumentasjonen ikke viser. Registreringen bør skille mellom innbetalingene som støttes av dokumentasjonen, og den uavklarte resten.

Bruk flere scenarioer for beløp som kan hentes tilbake, i beholdningsrapporteringen. En modell kan vise resultatet av å selge en liten mengde raskt, selge mer på mindre gunstige vilkår eller beholde usolgte enheter lenger. Dette er scenarioer fremfor løfter om fremtidig likviditet.

Mengdekonsentrasjon betyr noe selv når enhetsprisen virker beskjeden. Gjentatte kjøp av samme utgave kan binde betydelig kapital til én kjøpergruppe. En grense per ordre bør derfor suppleres med en samlet grense for beholdning og forpliktelser på typenivå.

Hold ERC-1155-botens tillatelsesregistrering separat

Operatørgodkjenning i standarden har et bredere omfang enn én lokalt beskrevet handel. Arbeidsflyten bør vise den relevante kontrakten og parten som har fullmakten, og forklare forholdet mellom fullmakten og den tiltenkte handlingen. En attraktiv pris er ingen grunn til å hoppe over tillatelsesgjennomgangen.

Lagre tillatelsesobservasjoner separat fra ordrestatus. En ordre kan utløpe mens fullmakten består, og deaktivering av strategien beskriver ikke i seg selv tillatelsestilstanden. Kontoens gjennomgangsprosess bør gjøre disse skillene synlige for personen som er ansvarlig for lommeboken.

Hvis utførelsesruten endres, vurder fullmakten den krever, på nytt. Ikke anta at en tidligere observert tillatelse passer bare fordi den nye ruten har et lignende formål. Verifiserte identifikatorer og gjeldende krav bør styre beslutningen.

Den bredere mandatdiskusjonen i en NFT-handelsagent forklarer hvorfor planlegging og fullmakt trenger separate kontroller. En mengdebevisst agent kan foreslå nyttige beholdningshandlinger, men tillatelsen til å utføre dem bør fortsatt begrenses av uttrykkelige regler for eiendeler, mengder og drift.

Avstem eksterne overføringer og uventede saldoendringer

Botens egen ordrehistorikk forklarer kanskje ikke hver kontobevegelse. En person kan bruke et annet grensesnitt, en annen godkjent arbeidsflyt kan handle, eller en eiendel kan komme utenfor den forventede anskaffelsesprosessen. Journalen bør oppdage den endrede saldoen og undersøke kilden fremfor å tvinge den inn i den nærmeste kjente handelen.

Klassifiser en bevegelse som anskaffelse, avhending, overføring av oppbevaring eller uavklart hendelse bare når dokumentasjonen støtter klassifiseringen. En innkommende mengde er ikke automatisk et kjøp til gjeldende markedspris. En utgående mengde er ikke automatisk et salg med innbetalinger som tilsvarer et vist pristilbud.

Bevar den opprinnelige observasjonen og den senere forklaringen. Hvis et saldoavvik avklares etter gjennomgang, legg til den underbyggende dokumentasjonen fremfor å erstatte registreringen i det stille. Dette gjør kontohistorikken nyttig for å diagnostisere tilbakevendende problemer i datainnsamling eller operatørkoordinering.

Sett nye handlinger som involverer den omstridte typen, på pause når avviket påvirker den tilgjengelige mengden. Hvis man fortsetter å reservere eller selge enheter fra en usikker saldo, kan det oppstå motstridende forpliktelser. Uavhengig overvåking kan fortsette mens den berørte beholdningen gjennomgås.

Test mengdeberegningene ved grensene

Bruk små eksempler som kan undersøkes, før antallet typer eller enheter økes. Ta med null tilgjengelig mengde, et antall over den verifiserte saldoen, en delvis utført ordre og to samtidige forslag som konkurrerer om de samme enhetene. Hvert tilfelle tester en forskjellig antakelse i reservasjonsmodellen.

Test hvordan mengder tolkes og lagres. En mengde bør ikke i det stille avrundes til en annen godkjent mengde. Hvis ruten eller eiendelen krever en heltallsenhet og forslaget inneholder en brøkdel som ikke støttes, avvis det uttrykkelig fremfor å gjette hva brukeren mente.

En nybegynner kan arbeide gjennom disse tilfellene sammen med en øvelse fra en NFT-bot for nybegynnere. Poenget er å synliggjøre tilstandsendringene med enkle tall, slik at operatøren kan forklare hvorfor den tilgjengelige beholdningen endret seg etter hver hendelse.

Bevar eksemplene som et regresjonssett for senere endringer. En ny visningskomponent eller et nytt importverktøy kan innføre mengdefeil selv når utførelseskoden er uendret. Testen bør verifisere de meningsfulle forholdene mellom eide, reserverte og utførte mengder fremfor bare å bekrefte at en knapp fortsatt vises.

Avslutt økten med mengde- og pengeavstemming

For hver type knyttes åpningsmengde, verifiserte innstrømninger, verifiserte utstrømninger og sluttmengde sammen. Avstem deretter de tilhørende betalingsbevegelsene og utgiftene. Disse to oversiktene besvarer forskjellige spørsmål og bør stemme med de registrerte handlingene uten å slås sammen til ett nettoverdianslag.

Undersøk forskjeller før en ny økt begynner. Et lite avvik kan tyde på en duplisert utførelse, en uregistrert overføring eller en tolkingsfeil. Å føre det videre gang på gang gjør senere avstemming vanskeligere fordi hver ny handling avhenger av en åpningssaldo som allerede er usikker.

Bevar usolgt beholdning separat fra realiserte resultater. En hypotetisk verdsettelse som tilordnes gjenværende enheter, er ikke penger som er hentet tilbake. Rapportene bør forklare hvor mye av strategiens tilsynelatende verdi som avhenger av et anslag for eiendeler som fortsatt trenger kjøpere.

Det avsluttende øktnotatet bør identifisere uavklarte ordrer, reserverte mengder og eventuelle tillatelsesendringer som fortsatt er relevante. En stille handelssløyfe er ikke en fullstendig kontotilstand. Operatøren trenger nok informasjon til å starte på nytt på en sammenhengende måte uten å måtte gjenoppdage hva den forrige økten hadde til hensikt.

Vanlige spørsmål om handel med utgaver

Betyr én token-ID alltid én enhet?

Nei. Kontomodellen må bevare den observerte mengden som er knyttet til tokentypen. Hvis identifikatoren behandles som en beholdning av én gjenstand, kan beholdning og ordrekapasitet bli feil fremstilt. Bruk den faktiske eiendelens og rutens betydning fremfor å utlede mengden fra måten en markedsplass viser bildet på.

Er en gruppert handling alltid økonomisk bedre?

Ikke nødvendigvis. En gruppert handling kan endre utførelsesutgifter og driftskompleksitet, men resultatet avhenger av den faktiske ruten og det foreslåtte innholdet. Sammenlign samlede kostnader og konsekvensene av en mislykket eller feilaktig handling. Bekvemmelighet alene fastslår ikke et bedre økonomisk utfall.

Kan jeg selge alt til den siste enhetsprisen?

En tidligere enhetspris fastslår ikke gjeldende etterspørsel etter hele beholdningen. Undersøk vilkår som faktisk kan utføres for den tiltenkte mengden, og hold innbetalinger som mangler dokumentasjon, synlig usikre. Store utgaveposisjoner kan kreve en annen avslutningsplan enn den en liten, nylig transaksjon antyder.

Hva er den viktigste første kontrollen?

Bekreft at arbeidsflyten skiller mellom tokentype, mengde og prisgrunnlag. Verifiser deretter at eide og reserverte mengder stemmer etter et delvis utfall. Dette grunnlaget gjør senere kostnads- og beholdningsanalyse meningsfull. Avansert verdsettelse kan ikke reparere en kontomodell som ikke vet hvor mange enheter den faktisk kontrollerer.