63 lines
1.8 KiB
Swift
63 lines
1.8 KiB
Swift
//
|
|
// CompactBlockStoring.swift
|
|
// ZcashLightClientKit
|
|
//
|
|
// Created by Francisco Gindre on 12/09/2019.
|
|
// Copyright © 2019 Electric Coin Company. All rights reserved.
|
|
//
|
|
|
|
import Foundation
|
|
|
|
public struct ZcashCompactBlock {
|
|
var height: BlockHeight
|
|
var data: Data
|
|
}
|
|
|
|
extension ZcashCompactBlock: Encodable { }
|
|
|
|
protocol CompactBlockStoring {
|
|
|
|
/**
|
|
Gets the highest block that is currently stored.
|
|
*/
|
|
|
|
func latestHeight() throws -> BlockHeight
|
|
|
|
/**
|
|
Gets the highest block that is currently stored.
|
|
Non-Blocking
|
|
*/
|
|
|
|
func latestHeight(result: @escaping (Result<BlockHeight,Error>) -> Void)
|
|
|
|
/**
|
|
Write the given blocks to this store, which may be anything from an in-memory cache to a DB.
|
|
*/
|
|
func write(blocks: [ZcashCompactBlock]) throws
|
|
|
|
/**
|
|
Write the given blocks to this store, which may be anything from an in-memory cache to a DB.
|
|
Non-Blocking
|
|
*/
|
|
|
|
func write(blocks: [ZcashCompactBlock], completion: ((Error?) -> Void)?)
|
|
|
|
/**
|
|
Remove every block above and including the given height.
|
|
|
|
After this operation, the data store will look the same as one that has not yet stored the given block height.
|
|
Meaning, if max height is 100 block and rewindTo(50) is called, then the highest block remaining will be 49.
|
|
*/
|
|
|
|
func rewind(to height: BlockHeight) throws
|
|
|
|
/**
|
|
Remove every block above and including the given height.
|
|
|
|
After this operation, the data store will look the same as one that has not yet stored the given block height.
|
|
Meaning, if max height is 100 block and rewindTo(50) is called, then the highest block remaining will be 49.
|
|
|
|
*/
|
|
func rewind(to height: BlockHeight, completion: ((Error?) -> Void)?)
|
|
}
|