Skip to content Search Apps Documentation Source Content Run Reset Eval Playground File Folder Download Copy Actions State String Boolean Number Struct Map Slice Pointer Function Closure Reference Nil Package Type Interface Unknown

Community realm. Read the code first. Community realm, deployed by its author. Read the code before you interact or send coins.

record.gno

4.16 Kb · 151 lines
  1package assets
  2
  3import (
  4	"encoding/hex"
  5
  6	"gno.land/p/g1jz6j9hj6rdf5ltl2kcrpa4jwtdh3w30z0yul06/sinopia/media/v1"
  7)
  8
  9// Fixed artwork record, recBytes long, bucketSize records per avl value
 10// (design §4; one key per 64 artworks instead of one per artwork):
 11//
 12//	off  0  kind u8          (media.Kind*)
 13//	     1  mime u8          (media.Mime*)
 14//	     2  size u32         declared byte size
 15//	     6  have u32         bytes received (= size when complete; ipfs: = size at add)
 16//	    10  editions u32
 17//	    14  slotEnd u32      prefix sum of editions, exclusive
 18//	    18  logOff u32       chain: offset in the byte log (= declared on-chain bytes before it)
 19//	    22  tier u8          0 = none, else 1-based index into tiers
 20//	    23  traits [8]u8     per trait type: dictionary index + 1, 0 = none (MaxTraitTypes)
 21//	    31  sha256 [32]      of the file bytes
 22//	    63  digest [32]      dag-pb root digest (UnixFS), zero otherwise
 23//
 24// All fields are big-endian. A raw CID is derived from sha256.
 25const (
 26	recBytes   = 95
 27	bucketSize = 64
 28
 29	offKind     = 0
 30	offMime     = 1
 31	offSize     = 2
 32	offHave     = 6
 33	offEditions = 10
 34	offSlotEnd  = 14
 35	offLogOff   = 18
 36	offTier     = 22
 37	offTraits   = 23
 38	offSHA      = offTraits + MaxTraitTypes // 31
 39	offDigest   = offSHA + 32             // 63
 40)
 41
 42type record struct {
 43	kind, mime                            int
 44	size, have, editions, slotEnd, logOff int64
 45	tier                                  int
 46	traits                                [MaxTraitTypes]int
 47	sha, digest                           string // 32 raw bytes each
 48}
 49
 50func putU32(b []byte, off int, v int64) {
 51	if v < 0 || v > 0xFFFFFFFF {
 52		panic("assets: value out of uint32 range")
 53	}
 54	b[off], b[off+1], b[off+2], b[off+3] = byte(v>>24), byte(v>>16), byte(v>>8), byte(v)
 55}
 56
 57func getU32(s string, off int) int64 {
 58	return int64(s[off])<<24 | int64(s[off+1])<<16 | int64(s[off+2])<<8 | int64(s[off+3])
 59}
 60
 61func (r *record) encode() string {
 62	b := make([]byte, recBytes)
 63	b[offKind] = byte(r.kind)
 64	b[offMime] = byte(r.mime)
 65	putU32(b, offSize, r.size)
 66	putU32(b, offHave, r.have)
 67	putU32(b, offEditions, r.editions)
 68	putU32(b, offSlotEnd, r.slotEnd)
 69	putU32(b, offLogOff, r.logOff)
 70	b[offTier] = byte(r.tier)
 71	for i := 0; i < MaxTraitTypes; i++ {
 72		b[offTraits+i] = byte(r.traits[i])
 73	}
 74	copy(b[offSHA:offSHA+32], []byte(r.sha))
 75	copy(b[offDigest:offDigest+32], []byte(r.digest))
 76	return string(b)
 77}
 78
 79func decodeRecord(s string) record {
 80	r := record{
 81		kind:     int(s[offKind]),
 82		mime:     int(s[offMime]),
 83		size:     getU32(s, offSize),
 84		have:     getU32(s, offHave),
 85		editions: getU32(s, offEditions),
 86		slotEnd:  getU32(s, offSlotEnd),
 87		logOff:   getU32(s, offLogOff),
 88		tier:     int(s[offTier]),
 89		sha:      s[offSHA : offSHA+32],
 90		digest:   s[offDigest : offDigest+32],
 91	}
 92	for i := 0; i < MaxTraitTypes; i++ {
 93		r.traits[i] = int(s[offTraits+i])
 94	}
 95	return r
 96}
 97
 98func (r *record) complete() bool { return r.have == r.size }
 99
100func (r *record) shaHex() string { return hex.EncodeToString([]byte(r.sha)) }
101
102func (r *record) cid() string {
103	switch r.kind {
104	case media.KindIPFSRaw:
105		return media.CIDFromDigest(media.CodecRaw, r.shaHex())
106	case media.KindIPFSUnixFS:
107		return media.CIDFromDigest(media.CodecDagPB, hex.EncodeToString([]byte(r.digest)))
108	}
109	return ""
110}
111
112func (r *record) digestHex() string {
113	if r.kind != media.KindIPFSUnixFS {
114		return ""
115	}
116	return hex.EncodeToString([]byte(r.digest))
117}
118
119// bucket holds up to bucketSize packed records and their titles
120// (concatenated, each prefixed by its byte length as one byte).
121type bucket struct {
122	rec    string
123	titles string
124}
125
126func (b *bucket) count() int { return len(b.rec) / recBytes }
127
128func (b *bucket) raw(i int) string { return b.rec[i*recBytes : (i+1)*recBytes] }
129
130func (b *bucket) setRaw(i int, enc string) {
131	b.rec = b.rec[:i*recBytes] + enc + b.rec[(i+1)*recBytes:]
132}
133
134func (b *bucket) title(i int) string {
135	off := 0
136	for k := 0; k < i; k++ {
137		off += 1 + int(b.titles[off])
138	}
139	n := int(b.titles[off])
140	return b.titles[off+1 : off+1+n]
141}
142
143// keep trims the bucket to its first n records and titles.
144func (b *bucket) keep(n int) {
145	off := 0
146	for k := 0; k < n; k++ {
147		off += 1 + int(b.titles[off])
148	}
149	b.rec = b.rec[:n*recBytes]
150	b.titles = b.titles[:off]
151}