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}