64 lines
2.2 KiB
Go
64 lines
2.2 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 (
|
||
|
|
"context"
|
||
|
|
|
||
|
|
ds "github.com/ipfs/go-datastore"
|
||
|
|
dssync "github.com/ipfs/go-datastore/sync"
|
||
|
|
|
||
|
|
blockstore "github.com/ipfs/go-ipfs-blockstore"
|
||
|
|
)
|
||
|
|
|
||
|
|
// NewTemporary returns a temporary blockstore.
|
||
|
|
func NewTemporary() blockstore.Blockstore {
|
||
|
|
return NewBlockstore(ds.NewMapDatastore())
|
||
|
|
}
|
||
|
|
|
||
|
|
// NewTemporary returns a thread-safe temporary blockstore.
|
||
|
|
func NewTemporarySync() blockstore.Blockstore {
|
||
|
|
return NewBlockstore(dssync.MutexWrap(ds.NewMapDatastore()))
|
||
|
|
}
|
||
|
|
|
||
|
|
// Wraps the underlying blockstore in an "identity" blockstore.
|
||
|
|
func WrapIDStore(bstore blockstore.Blockstore) blockstore.Blockstore {
|
||
|
|
return blockstore.NewIdStore(bstore)
|
||
|
|
}
|
||
|
|
|
||
|
|
// NewBlockstore creates a new blockstore wrapped by the given datastore.
|
||
|
|
func NewBlockstore(dstore ds.Batching) blockstore.Blockstore {
|
||
|
|
return WrapIDStore(blockstore.NewBlockstore(dstore))
|
||
|
|
}
|
||
|
|
|
||
|
|
// Alias so other packages don't have to import go-ipfs-blockstore
|
||
|
|
type Blockstore = blockstore.Blockstore
|
||
|
|
type GCBlockstore = blockstore.GCBlockstore
|
||
|
|
type CacheOpts = blockstore.CacheOpts
|
||
|
|
type GCLocker = blockstore.GCLocker
|
||
|
|
|
||
|
|
var NewGCLocker = blockstore.NewGCLocker
|
||
|
|
var NewGCBlockstore = blockstore.NewGCBlockstore
|
||
|
|
var DefaultCacheOpts = blockstore.DefaultCacheOpts
|
||
|
|
var ErrNotFound = blockstore.ErrNotFound
|
||
|
|
|
||
|
|
func CachedBlockstore(ctx context.Context, bs Blockstore, opts CacheOpts) (Blockstore, error) {
|
||
|
|
bs, err := blockstore.CachedBlockstore(ctx, bs, opts)
|
||
|
|
if err != nil {
|
||
|
|
return nil, err
|
||
|
|
}
|
||
|
|
return WrapIDStore(bs), nil
|
||
|
|
}
|