package arbo import ( "bytes" "fmt" "math" "runtime" "sort" "sync" "github.com/iden3/go-merkletree/db" ) /* AddBatch design =============== CASE A: Empty Tree --> if tree is empty (root==0) ================================================= - Build the full tree from bottom to top (from all the leaf to the root) CASE B: ALMOST CASE A, Almost empty Tree --> if Tree has numLeafs < minLeafsThreshold ============================================================================== - Get the Leafs (key & value) (iterate the tree from the current root getting the leafs) - Create a new empty Tree - Do CASE A for the new Tree, giving the already existing key&values (leafs) from the original Tree + the new key&values to be added from the AddBatch call R R / \ / \ A * / \ / \ / \ B C * * / | / \ / | / \ / | / \ L: A B G D / \ / \ / \ C * / \ / \ / \ ... ... (nLeafs < minLeafsThreshold) CASE C: ALMOST CASE B --> if Tree has few Leafs (but numLeafs>=minLeafsThreshold) ============================================================================== - Use A, B, G, F as Roots of subtrees - Do CASE B for each subtree - Then go from L to the Root R / \ / \ / \ * * / | / \ / | / \ / | / \ L: A B G D / \ / \ / \ C * / \ / \ / \ ... ... (nLeafs >= minLeafsThreshold) CASE D: Already populated Tree ============================== - Use A, B, C, D as subtree - Sort the Keys in Buckets that share the initial part of the path - For each subtree add there the new leafs R / \ / \ / \ * * / | / \ / | / \ / | / \ L: A B C D /\ /\ / \ / \ ... ... ... ... ... ... CASE E: Already populated Tree Unbalanced ========================================= - Need to fill M1 and M2, and then will be able to use CASE D - Search for M1 & M2 in the inputed Keys - Add M1 & M2 to the Tree - From here can use CASE D R / \ / \ / \ * * | \ | \ | \ L: M1 * M2 * (where M1 and M2 are empty) / | / / | / / | / A * * / \ | \ / \ | \ / \ | \ B * * C / \ |\ ... ... | \ | \ D E Algorithm decision ================== - if nLeafs==0 (root==0): CASE A - if nLeafs=minLeafsThreshold && (nLeafs/nBuckets) < minLeafsThreshold: CASE C - else: CASE D & CASE E - Multiple tree.Add calls: O(n log n) - Used in: cases A, B, C - Tree from bottom to top: O(log n) - Used in: cases D, E */ const ( minLeafsThreshold = 100 // nolint:gomnd // TMP WIP this will be autocalculated ) // AddBatch adds a batch of key-values to the Tree. Returns an array containing // the indexes of the keys failed to add. func (t *Tree) AddBatch(keys, values [][]byte) ([]int, error) { t.updateAccessTime() t.Lock() defer t.Unlock() vt, err := t.loadVT() if err != nil { return nil, err } invalids, err := vt.addBatch(keys, values) if err != nil { return nil, err } pairs, err := vt.computeHashes() if err != nil { return nil, err } t.root = vt.root.h // store pairs in db t.tx, err = t.db.NewTx() if err != nil { return nil, err } for i := 0; i < len(pairs); i++ { if err := t.dbPut(pairs[i][0], pairs[i][1]); err != nil { return nil, err } } return t.finalizeAddBatch(len(keys), invalids) } // AddBatchOLD adds a batch of key-values to the Tree. Returns an array containing // the indexes of the keys failed to add. func (t *Tree) AddBatchOLD(keys, values [][]byte) ([]int, error) { // TODO: support vaules=nil t.updateAccessTime() t.Lock() defer t.Unlock() kvs, err := t.keysValuesToKvs(keys, values) if err != nil { return nil, err } t.tx, err = t.db.NewTx() if err != nil { return nil, err } // if nCPU is not a power of two, cut at the highest power of two under // nCPU nCPU := flp2(runtime.NumCPU()) l := int(math.Log2(float64(nCPU))) var invalids []int // CASE A: if nLeafs==0 (root==0) if bytes.Equal(t.root, t.emptyHash) { invalids, err = t.caseA(nCPU, kvs) if err != nil { return nil, err } return t.finalizeAddBatch(len(keys), invalids) } // CASE B: if nLeafs=minLeafsThreshold && (nLeafs/nBuckets) < minLeafsThreshold // available parallelization, will need to be a power of 2 (2**n) if nLeafs >= minLeafsThreshold && (nLeafs/nCPU) < minLeafsThreshold && len(keysAtL) == nCPU { invalids, err = t.caseC(nCPU, l, keysAtL, kvs) if err != nil { return nil, err } return t.finalizeAddBatch(len(keys), invalids) } // CASE E if len(keysAtL) != nCPU { // CASE E: add one key at each bucket, and then do CASE D buckets := splitInBuckets(kvs, nCPU) kvs = []kv{} for i := 0; i < len(buckets); i++ { // add one leaf of the bucket, if there is an error when // adding the k-v, try to add the next one of the bucket // (until one is added) var inserted int for j := 0; j < len(buckets[i]); j++ { if err := t.add(0, buckets[i][j].k, buckets[i][j].v); err == nil { inserted = j break } } // put the buckets elements except the inserted one kvs = append(kvs, buckets[i][:inserted]...) kvs = append(kvs, buckets[i][inserted+1:]...) } keysAtL, err = t.getKeysAtLevel(l + 1) if err != nil { return nil, err } } // CASE D if len(keysAtL) == nCPU { // enter in CASE D if len(keysAtL)=nCPU, if not, CASE E invalidsCaseD, err := t.caseD(nCPU, l, keysAtL, kvs) if err != nil { return nil, err } invalids = append(invalids, invalidsCaseD...) return t.finalizeAddBatch(len(keys), invalids) } return nil, fmt.Errorf("UNIMPLEMENTED") } func (t *Tree) finalizeAddBatch(nKeys int, invalids []int) ([]int, error) { // store root to db if err := t.dbPut(dbKeyRoot, t.root); err != nil { return nil, err } // update nLeafs if err := t.incNLeafs(nKeys - len(invalids)); err != nil { return nil, err } // commit db tx if err := t.tx.Commit(); err != nil { return nil, err } return invalids, nil } func (t *Tree) caseA(nCPU int, kvs []kv) ([]int, error) { invalids, err := t.buildTreeFromLeafs(nCPU, kvs) if err != nil { return nil, err } return invalids, nil } func (t *Tree) caseB(nCPU, l int, kvs []kv) ([]int, error) { // get already existing keys aKs, aVs, err := t.getLeafs(t.root) if err != nil { return nil, err } aKvs, err := t.keysValuesToKvs(aKs, aVs) if err != nil { return nil, err } // add already existing key-values to the inputted key-values // kvs = append(kvs, aKvs...) kvs, invalids := combineInKVSet(aKvs, kvs) // proceed with CASE A sortKvs(kvs) var invalids2 []int if nCPU > 1 { invalids2, err = t.buildTreeFromLeafs(nCPU, kvs) if err != nil { return nil, err } } else { invalids2, err = t.buildTreeFromLeafsSingleThread(l, kvs) if err != nil { return nil, err } } invalids = append(invalids, invalids2...) return invalids, nil } func (t *Tree) caseC(nCPU, l int, keysAtL [][]byte, kvs []kv) ([]int, error) { // 1. go down until level L (L=log2(nBuckets)): keysAtL var excedents []kv buckets := splitInBuckets(kvs, nCPU) // 2. use keys at level L as roots of the subtrees under each one subRoots := make([][]byte, nCPU) dbgStatsPerBucket := make([]*dbgStats, nCPU) txs := make([]db.Tx, nCPU) var wg sync.WaitGroup wg.Add(nCPU) for i := 0; i < nCPU; i++ { go func(cpu int) { var err error txs[cpu], err = t.db.NewTx() if err != nil { panic(err) // TODO WIP } if err := txs[cpu].Add(t.tx); err != nil { panic(err) // TODO } bucketTree := Tree{tx: txs[cpu], db: t.db, maxLevels: t.maxLevels, hashFunction: t.hashFunction, root: keysAtL[cpu], emptyHash: t.emptyHash, dbg: newDbgStats()} // 3. do CASE B (with 1 cpu) for each key at level L _, err = bucketTree.caseB(1, l, buckets[cpu]) // TODO handle invalids if err != nil { panic(err) // TODO WIP // return nil, err } subRoots[cpu] = bucketTree.root dbgStatsPerBucket[cpu] = bucketTree.dbg wg.Done() }(i) } wg.Wait() // merge buckets txs into Tree.tx for i := 0; i < len(txs); i++ { if err := t.tx.Add(txs[i]); err != nil { return nil, err } } // 4. go upFromKeys from the new roots of the subtrees newRoot, err := t.upFromKeys(subRoots) if err != nil { return nil, err } t.root = newRoot // add the key-values that have not been used yet var invalids []int for i := 0; i < len(excedents); i++ { if err = t.add(0, excedents[i].k, excedents[i].v); err != nil { invalids = append(invalids, excedents[i].pos) } } for i := 0; i < len(dbgStatsPerBucket); i++ { t.dbg.add(dbgStatsPerBucket[i]) } return invalids, nil } func (t *Tree) caseD(nCPU, l int, keysAtL [][]byte, kvs []kv) ([]int, error) { if nCPU == 1 { // CASE D, but with 1 cpu var invalids []int for i := 0; i < len(kvs); i++ { if err := t.add(0, kvs[i].k, kvs[i].v); err != nil { invalids = append(invalids, kvs[i].pos) } } return invalids, nil } buckets := splitInBuckets(kvs, nCPU) subRoots := make([][]byte, nCPU) invalidsInBucket := make([][]int, nCPU) dbgStatsPerBucket := make([]*dbgStats, nCPU) txs := make([]db.Tx, nCPU) var wg sync.WaitGroup wg.Add(nCPU) for i := 0; i < nCPU; i++ { go func(cpu int) { var err error txs[cpu], err = t.db.NewTx() if err != nil { panic(err) // TODO WIP } // put already existing tx into txs[cpu], as txs[cpu] // needs the pending key-values that are not in tree.db, // but are in tree.tx if err := txs[cpu].Add(t.tx); err != nil { panic(err) // TODO WIP } bucketTree := Tree{tx: txs[cpu], db: t.db, maxLevels: t.maxLevels - l, hashFunction: t.hashFunction, root: keysAtL[cpu], emptyHash: t.emptyHash, dbg: newDbgStats()} // TODO bucketTree.dbg should be optional for j := 0; j < len(buckets[cpu]); j++ { if err = bucketTree.add(l, buckets[cpu][j].k, buckets[cpu][j].v); err != nil { invalidsInBucket[cpu] = append(invalidsInBucket[cpu], buckets[cpu][j].pos) } } subRoots[cpu] = bucketTree.root dbgStatsPerBucket[cpu] = bucketTree.dbg wg.Done() }(i) } wg.Wait() // merge buckets txs into Tree.tx for i := 0; i < len(txs); i++ { if err := t.tx.Add(txs[i]); err != nil { return nil, err } } newRoot, err := t.upFromKeys(subRoots) if err != nil { return nil, err } t.root = newRoot var invalids []int for i := 0; i < len(invalidsInBucket); i++ { invalids = append(invalids, invalidsInBucket[i]...) } for i := 0; i < len(dbgStatsPerBucket); i++ { t.dbg.add(dbgStatsPerBucket[i]) } return invalids, nil } func splitInBuckets(kvs []kv, nBuckets int) [][]kv { buckets := make([][]kv, nBuckets) // 1. classify the keyvalues into buckets for i := 0; i < len(kvs); i++ { pair := kvs[i] // bucketnum := keyToBucket(pair.k, nBuckets) bucketnum := keyToBucket(pair.keyPath, nBuckets) buckets[bucketnum] = append(buckets[bucketnum], pair) } return buckets } // TODO rename in a more 'real' name (calculate bucket from/for key) func keyToBucket(k []byte, nBuckets int) int { nLevels := int(math.Log2(float64(nBuckets))) b := make([]int, nBuckets) for i := 0; i < nBuckets; i++ { b[i] = i } r := b mid := len(r) / 2 //nolint:gomnd for i := 0; i < nLevels; i++ { if int(k[i/8]&(1<<(i%8))) != 0 { r = r[mid:] mid = len(r) / 2 //nolint:gomnd } else { r = r[:mid] mid = len(r) / 2 //nolint:gomnd } } return r[0] } type kv struct { pos int // original position in the array keyPath []byte k []byte v []byte } // compareBytes compares byte slices where the bytes are compared from left to // right and each byte is compared by bit from right to left func compareBytes(a, b []byte) bool { // WIP for i := 0; i < len(a); i++ { for j := 0; j < 8; j++ { aBit := a[i] & (1 << j) bBit := b[i] & (1 << j) if aBit > bBit { return false } else if aBit < bBit { return true } } } return false } // sortKvs sorts the kv by path func sortKvs(kvs []kv) { sort.Slice(kvs, func(i, j int) bool { return compareBytes(kvs[i].keyPath, kvs[j].keyPath) }) } func (t *Tree) keysValuesToKvs(ks, vs [][]byte) ([]kv, error) { if len(ks) != len(vs) { return nil, fmt.Errorf("len(keys)!=len(values) (%d!=%d)", len(ks), len(vs)) } kvs := make([]kv, len(ks)) for i := 0; i < len(ks); i++ { keyPath := make([]byte, t.hashFunction.Len()) copy(keyPath[:], ks[i]) kvs[i].pos = i kvs[i].keyPath = keyPath kvs[i].k = ks[i] kvs[i].v = vs[i] } return kvs, nil } /* func (t *Tree) kvsToKeysValues(kvs []kv) ([][]byte, [][]byte) { ks := make([][]byte, len(kvs)) vs := make([][]byte, len(kvs)) for i := 0; i < len(kvs); i++ { ks[i] = kvs[i].k vs[i] = kvs[i].v } return ks, vs } */ // buildTreeFromLeafs splits the key-values into n Buckets (where n is the number // of CPUs), in parallel builds a subtree for each bucket, once all the subtrees // are built, uses the subtrees roots as keys for a new tree, which as result // will have the complete Tree build from bottom to up, where until the // log2(nCPU) level it has been computed in parallel. func (t *Tree) buildTreeFromLeafs(nCPU int, kvs []kv) ([]int, error) { l := int(math.Log2(float64(nCPU))) buckets := splitInBuckets(kvs, nCPU) subRoots := make([][]byte, nCPU) invalidsInBucket := make([][]int, nCPU) dbgStatsPerBucket := make([]*dbgStats, nCPU) txs := make([]db.Tx, nCPU) var wg sync.WaitGroup wg.Add(nCPU) for i := 0; i < nCPU; i++ { go func(cpu int) { sortKvs(buckets[cpu]) var err error txs[cpu], err = t.db.NewTx() if err != nil { panic(err) // TODO } if err := txs[cpu].Add(t.tx); err != nil { panic(err) // TODO } bucketTree := Tree{tx: txs[cpu], db: t.db, maxLevels: t.maxLevels, hashFunction: t.hashFunction, root: t.emptyHash, emptyHash: t.emptyHash, dbg: newDbgStats()} currInvalids, err := bucketTree.buildTreeFromLeafsSingleThread(l, buckets[cpu]) if err != nil { panic(err) // TODO } invalidsInBucket[cpu] = currInvalids subRoots[cpu] = bucketTree.root dbgStatsPerBucket[cpu] = bucketTree.dbg wg.Done() }(i) } wg.Wait() // merge buckets txs into Tree.tx for i := 0; i < len(txs); i++ { if err := t.tx.Add(txs[i]); err != nil { return nil, err } } newRoot, err := t.upFromKeys(subRoots) if err != nil { return nil, err } t.root = newRoot var invalids []int for i := 0; i < len(invalidsInBucket); i++ { invalids = append(invalids, invalidsInBucket[i]...) } for i := 0; i < len(dbgStatsPerBucket); i++ { t.dbg.add(dbgStatsPerBucket[i]) } return invalids, err } // buildTreeFromLeafsSingleThread builds the tree with the given []kv from bottom // to the root func (t *Tree) buildTreeFromLeafsSingleThread(l int, kvsRaw []kv) ([]int, error) { // TODO check that log2(len(leafs)) < t.maxLevels, if not, maxLevels // would be reached and should return error if len(kvsRaw) == 0 { return nil, nil } vt := newVT(t.maxLevels, t.hashFunction) if t.dbg != nil { vt.params.dbg = newDbgStats() } for i := 0; i < len(kvsRaw); i++ { if err := vt.add(l, kvsRaw[i].k, kvsRaw[i].v); err != nil { return nil, err } } pairs, err := vt.computeHashes() if err != nil { return nil, err } // store pairs in db for i := 0; i < len(pairs); i++ { if err := t.dbPut(pairs[i][0], pairs[i][1]); err != nil { return nil, err } } t.dbg.add(vt.params.dbg) // set tree.root from the virtual tree root t.root = vt.root.h return nil, nil // TODO invalids } // keys & values must be sorted by path, and the array ks must be length // multiple of 2 func (t *Tree) upFromKeys(ks [][]byte) ([]byte, error) { if len(ks) == 1 { return ks[0], nil } var rKs [][]byte for i := 0; i < len(ks); i += 2 { if bytes.Equal(ks[i], t.emptyHash) && bytes.Equal(ks[i+1], t.emptyHash) { // when both sub keys are empty, the key is also empty rKs = append(rKs, t.emptyHash) continue } k, v, err := newIntermediate(t.hashFunction, ks[i], ks[i+1]) if err != nil { return nil, err } // store k-v to db if err = t.dbPut(k, v); err != nil { return nil, err } rKs = append(rKs, k) } return t.upFromKeys(rKs) } func (t *Tree) getLeafs(root []byte) ([][]byte, [][]byte, error) { var ks, vs [][]byte err := t.iter(root, func(k, v []byte) { if v[0] != PrefixValueLeaf { return } leafK, leafV := ReadLeafValue(v) ks = append(ks, leafK) vs = append(vs, leafV) }) return ks, vs, err } func (t *Tree) getKeysAtLevel(l int) ([][]byte, error) { var keys [][]byte err := t.iterWithStop(t.root, 0, func(currLvl int, k, v []byte) bool { if currLvl == l && !bytes.Equal(k, t.emptyHash) { keys = append(keys, k) } if currLvl >= l { return true // to stop the iter from going down } return false }) return keys, err } // flp2 computes the floor power of 2, the highest power of 2 under the given // value. func flp2(n int) int { res := 0 for i := n; i >= 1; i-- { if (i & (i - 1)) == 0 { res = i break } } return res } // combineInKVSet combines two kv array in one single array without repeated // keys. func combineInKVSet(base, toAdd []kv) ([]kv, []int) { // TODO this is a naive version, this will be implemented in a more // efficient way or through maps, or through sorted binary search r := base var invalids []int for i := 0; i < len(toAdd); i++ { e := false // check if toAdd[i] exists in the base set for j := 0; j < len(base); j++ { if bytes.Equal(toAdd[i].k, base[j].k) { e = true } } if !e { r = append(r, toAdd[i]) } else { invalids = append(invalids, toAdd[i].pos) } } return r, invalids } // loadVT loads a new virtual tree (vt) from the current Tree, which contains // the same leafs. func (t *Tree) loadVT() (vt, error) { vt := newVT(t.maxLevels, t.hashFunction) vt.params.dbg = t.dbg err := t.Iterate(func(k, v []byte) { switch v[0] { case PrefixValueEmpty: case PrefixValueLeaf: leafK, leafV := ReadLeafValue(v) if err := vt.add(0, leafK, leafV); err != nil { panic(err) } case PrefixValueIntermediate: default: } }) return vt, err } // func computeSimpleAddCost(nLeafs int) int { // // nLvls 2^nLvls // nLvls := int(math.Log2(float64(nLeafs))) // return nLvls * int(math.Pow(2, float64(nLvls))) // } // // func computeFromLeafsAddCost(nLeafs int) int { // // 2^nLvls * 2 - 1 // nLvls := int(math.Log2(float64(nLeafs))) // return (int(math.Pow(2, float64(nLvls))) * 2) - 1 // }