74 lines
2.4 KiB
Go
74 lines
2.4 KiB
Go
// blockstore contains all the basic blockstore constructors used by lotus. Any
|
|
// blockstores not ultimately constructed out of the building blocks in this
|
|
// package may not work properly.
|
|
//
|
|
// * This package correctly wraps blockstores with the IdBlockstore. This blockstore:
|
|
// * Filters out all puts for blocks with CIDs using the "identity" hash function.
|
|
// * Extracts inlined blocks from CIDs using the identity hash function and
|
|
// returns them on get/has, ignoring the contents of the blockstore.
|
|
// * In the future, this package may enforce additional restrictions on block
|
|
// sizes, CID validity, etc.
|
|
//
|
|
// To make auditing for misuse of blockstores tractable, this package re-exports
|
|
// parts of the go-ipfs-blockstore package such that no other package needs to
|
|
// import it directly.
|
|
package blockstore
|
|
|
|
import (
|
|
"github.com/ipfs/go-cid"
|
|
ds "github.com/ipfs/go-datastore"
|
|
logging "github.com/ipfs/go-log/v2"
|
|
|
|
blockstore "github.com/ipfs/go-ipfs-blockstore"
|
|
)
|
|
|
|
var log = logging.Logger("blockstore")
|
|
|
|
var ErrNotFound = blockstore.ErrNotFound
|
|
|
|
// Blockstore is the blockstore interface used by Lotus. It is the union
|
|
// of the basic go-ipfs blockstore, with other capabilities required by Lotus,
|
|
// e.g. View or Sync.
|
|
type Blockstore interface {
|
|
blockstore.Blockstore
|
|
blockstore.Viewer
|
|
}
|
|
|
|
// BasicBlockstore is an alias to the original IPFS Blockstore.
|
|
type BasicBlockstore = blockstore.Blockstore
|
|
|
|
type Viewer = blockstore.Viewer
|
|
|
|
// WrapIDStore wraps the underlying blockstore in an "identity" blockstore.
|
|
func WrapIDStore(bstore blockstore.Blockstore) Blockstore {
|
|
return blockstore.NewIdStore(bstore).(Blockstore)
|
|
}
|
|
|
|
// FromDatastore creates a new blockstore backed by the given datastore.
|
|
func FromDatastore(dstore ds.Batching) Blockstore {
|
|
return WrapIDStore(blockstore.NewBlockstore(dstore))
|
|
}
|
|
|
|
type adaptedBlockstore struct {
|
|
blockstore.Blockstore
|
|
}
|
|
|
|
var _ Blockstore = (*adaptedBlockstore)(nil)
|
|
|
|
func (a *adaptedBlockstore) View(cid cid.Cid, callback func([]byte) error) error {
|
|
blk, err := a.Get(cid)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
return callback(blk.RawData())
|
|
}
|
|
|
|
// Adapt adapts a standard blockstore to a Lotus blockstore by
|
|
// enriching it with the extra methods that Lotus requires (e.g. View, Sync).
|
|
//
|
|
// View proxies over to Get and calls the callback with the value supplied by Get.
|
|
// Sync noops.
|
|
func Adapt(bs blockstore.Blockstore) Blockstore {
|
|
return &adaptedBlockstore{bs}
|
|
}
|