mirror of
https://github.com/nspcc-dev/neo-go.git
synced 2024-11-26 19:42:23 +00:00
479 lines
13 KiB
Go
479 lines
13 KiB
Go
package blockfetcher
|
|
|
|
import (
|
|
"context"
|
|
"crypto/sha256"
|
|
"errors"
|
|
"fmt"
|
|
"io"
|
|
"net/url"
|
|
"strings"
|
|
"sync"
|
|
"sync/atomic"
|
|
"time"
|
|
|
|
"github.com/nspcc-dev/neo-go/pkg/config"
|
|
"github.com/nspcc-dev/neo-go/pkg/core/block"
|
|
gio "github.com/nspcc-dev/neo-go/pkg/io"
|
|
"github.com/nspcc-dev/neo-go/pkg/services/oracle/neofs"
|
|
"github.com/nspcc-dev/neo-go/pkg/wallet"
|
|
"github.com/nspcc-dev/neofs-sdk-go/client"
|
|
"github.com/nspcc-dev/neofs-sdk-go/object"
|
|
oid "github.com/nspcc-dev/neofs-sdk-go/object/id"
|
|
"go.uber.org/zap"
|
|
)
|
|
|
|
const (
|
|
// oidSize is the size of the object ID in NeoFS.
|
|
oidSize = sha256.Size
|
|
// defaultTimeout is the default timeout for NeoFS requests.
|
|
defaultTimeout = 5 * time.Minute
|
|
// defaultOIDBatchSize is the default number of OIDs to search and fetch at once.
|
|
defaultOIDBatchSize = 8000
|
|
// defaultDownloaderWorkersCount is the default number of workers downloading blocks.
|
|
defaultDownloaderWorkersCount = 100
|
|
)
|
|
|
|
// Ledger is an interface to Blockchain sufficient for Service.
|
|
type Ledger interface {
|
|
GetConfig() config.Blockchain
|
|
BlockHeight() uint32
|
|
}
|
|
|
|
// Service is a service that fetches blocks from NeoFS.
|
|
type Service struct {
|
|
// isActive denotes whether the service is working or in the process of shutdown.
|
|
isActive atomic.Bool
|
|
log *zap.Logger
|
|
cfg config.NeoFSBlockFetcher
|
|
stateRootInHeader bool
|
|
|
|
chain Ledger
|
|
client *client.Client
|
|
enqueueBlock func(*block.Block) error
|
|
account *wallet.Account
|
|
|
|
oidsCh chan oid.ID
|
|
blocksCh chan *block.Block
|
|
// wg is a wait group for block downloaders.
|
|
wg sync.WaitGroup
|
|
|
|
// Global context for download operations cancellation.
|
|
ctx context.Context
|
|
ctxCancel context.CancelFunc
|
|
|
|
// A set of routines managing graceful Service shutdown.
|
|
quit chan bool
|
|
quitOnce sync.Once
|
|
exiterToOIDDownloader chan struct{}
|
|
exiterToShutdown chan struct{}
|
|
oidDownloaderToExiter chan struct{}
|
|
blockQueuerToExiter chan struct{}
|
|
|
|
shutdownCallback func()
|
|
}
|
|
|
|
// New creates a new BlockFetcher Service.
|
|
func New(chain Ledger, cfg config.NeoFSBlockFetcher, logger *zap.Logger, putBlock func(*block.Block) error, shutdownCallback func()) (*Service, error) {
|
|
var (
|
|
account *wallet.Account
|
|
err error
|
|
)
|
|
|
|
if cfg.UnlockWallet.Path != "" {
|
|
walletFromFile, err := wallet.NewWalletFromFile(cfg.UnlockWallet.Path)
|
|
if err != nil {
|
|
return &Service{}, err
|
|
}
|
|
for _, acc := range walletFromFile.Accounts {
|
|
if err := acc.Decrypt(cfg.UnlockWallet.Password, walletFromFile.Scrypt); err == nil {
|
|
account = acc
|
|
break
|
|
}
|
|
}
|
|
if account == nil {
|
|
return &Service{}, errors.New("failed to decrypt any account in the wallet")
|
|
}
|
|
} else {
|
|
account, err = wallet.NewAccount()
|
|
if err != nil {
|
|
return &Service{}, err
|
|
}
|
|
}
|
|
if cfg.Timeout <= 0 {
|
|
cfg.Timeout = defaultTimeout
|
|
}
|
|
if cfg.OIDBatchSize <= 0 {
|
|
cfg.OIDBatchSize = defaultOIDBatchSize
|
|
}
|
|
if cfg.DownloaderWorkersCount <= 0 {
|
|
cfg.DownloaderWorkersCount = defaultDownloaderWorkersCount
|
|
}
|
|
if len(cfg.Addresses) == 0 {
|
|
return &Service{}, errors.New("no addresses provided")
|
|
}
|
|
return &Service{
|
|
chain: chain,
|
|
log: logger,
|
|
cfg: cfg,
|
|
|
|
enqueueBlock: putBlock,
|
|
account: account,
|
|
stateRootInHeader: chain.GetConfig().StateRootInHeader,
|
|
shutdownCallback: shutdownCallback,
|
|
|
|
quit: make(chan bool),
|
|
exiterToOIDDownloader: make(chan struct{}),
|
|
exiterToShutdown: make(chan struct{}),
|
|
oidDownloaderToExiter: make(chan struct{}),
|
|
blockQueuerToExiter: make(chan struct{}),
|
|
|
|
// Use buffer of two batch sizes to load OIDs in advance:
|
|
// * first full block of OIDs is processing by Downloader
|
|
// * second full block of OIDs is available to be fetched by Downloader immediately
|
|
// * third half-filled block of OIDs is being collected by OIDsFetcher.
|
|
oidsCh: make(chan oid.ID, 2*cfg.OIDBatchSize),
|
|
|
|
// Use buffer of a single OIDs batch size to provide smooth downloading and
|
|
// avoid pauses during blockqueue insertion.
|
|
blocksCh: make(chan *block.Block, cfg.OIDBatchSize),
|
|
}, nil
|
|
}
|
|
|
|
// Start runs the NeoFS BlockFetcher service.
|
|
func (bfs *Service) Start() error {
|
|
if !bfs.isActive.CompareAndSwap(false, true) {
|
|
return nil
|
|
}
|
|
bfs.log.Info("starting NeoFS BlockFetcher service")
|
|
|
|
var err error
|
|
bfs.ctx, bfs.ctxCancel = context.WithCancel(context.Background())
|
|
bfs.client, err = neofs.GetSDKClient(bfs.ctx, bfs.cfg.Addresses[0], 10*time.Minute)
|
|
if err != nil {
|
|
bfs.isActive.CompareAndSwap(true, false)
|
|
return fmt.Errorf("create SDK client: %w", err)
|
|
}
|
|
|
|
// Start routine that manages Service shutdown process.
|
|
go bfs.exiter()
|
|
|
|
// Start OIDs downloader routine.
|
|
go bfs.oidDownloader()
|
|
|
|
// Start the set of blocks downloading routines.
|
|
for range bfs.cfg.DownloaderWorkersCount {
|
|
bfs.wg.Add(1)
|
|
go bfs.blockDownloader()
|
|
}
|
|
|
|
// Start routine that puts blocks into bQueue.
|
|
go bfs.blockQueuer()
|
|
|
|
return nil
|
|
}
|
|
|
|
// oidDownloader runs the appropriate blocks OID fetching method based on the configuration.
|
|
func (bfs *Service) oidDownloader() {
|
|
defer close(bfs.oidDownloaderToExiter)
|
|
|
|
var err error
|
|
if bfs.cfg.SkipIndexFilesSearch {
|
|
err = bfs.fetchOIDsBySearch()
|
|
} else {
|
|
err = bfs.fetchOIDsFromIndexFiles()
|
|
}
|
|
var force bool
|
|
if err != nil {
|
|
bfs.log.Error("NeoFS BlockFetcher service: OID downloading routine failed", zap.Error(err))
|
|
force = true
|
|
}
|
|
// Stop the service since there's nothing to do anymore.
|
|
bfs.stopService(force)
|
|
}
|
|
|
|
// blockDownloader downloads the block from NeoFS and sends it to the blocks channel.
|
|
func (bfs *Service) blockDownloader() {
|
|
defer bfs.wg.Done()
|
|
|
|
for blkOid := range bfs.oidsCh {
|
|
ctx, cancel := context.WithTimeout(bfs.ctx, bfs.cfg.Timeout)
|
|
defer cancel()
|
|
|
|
rc, err := bfs.objectGet(ctx, blkOid.String())
|
|
if err != nil {
|
|
if isContextCanceledErr(err) {
|
|
return
|
|
}
|
|
bfs.log.Error("failed to objectGet block", zap.Error(err))
|
|
bfs.stopService(true)
|
|
return
|
|
}
|
|
|
|
b, err := bfs.readBlock(rc)
|
|
if err != nil {
|
|
if isContextCanceledErr(err) {
|
|
return
|
|
}
|
|
bfs.log.Error("failed to read block", zap.Error(err))
|
|
bfs.stopService(true)
|
|
return
|
|
}
|
|
select {
|
|
case <-bfs.ctx.Done():
|
|
return
|
|
case bfs.blocksCh <- b:
|
|
}
|
|
}
|
|
}
|
|
|
|
// blockQueuer puts the block into the bqueue.
|
|
func (bfs *Service) blockQueuer() {
|
|
defer close(bfs.blockQueuerToExiter)
|
|
|
|
for b := range bfs.blocksCh {
|
|
select {
|
|
case <-bfs.ctx.Done():
|
|
return
|
|
default:
|
|
err := bfs.enqueueBlock(b)
|
|
if err != nil {
|
|
bfs.log.Error("failed to enqueue block", zap.Error(err))
|
|
bfs.stopService(true)
|
|
return
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// fetchOIDsFromIndexFiles fetches block OIDs from NeoFS by searching index files first.
|
|
func (bfs *Service) fetchOIDsFromIndexFiles() error {
|
|
h := bfs.chain.BlockHeight()
|
|
startIndex := h / bfs.cfg.IndexFileSize
|
|
skip := h % bfs.cfg.IndexFileSize
|
|
|
|
for {
|
|
select {
|
|
case <-bfs.exiterToOIDDownloader:
|
|
return nil
|
|
default:
|
|
prm := client.PrmObjectSearch{}
|
|
filters := object.NewSearchFilters()
|
|
filters.AddFilter(bfs.cfg.IndexFileAttribute, fmt.Sprintf("%d", startIndex), object.MatchStringEqual)
|
|
prm.SetFilters(filters)
|
|
|
|
ctx, cancel := context.WithTimeout(bfs.ctx, bfs.cfg.Timeout)
|
|
blockOidsObject, err := bfs.objectSearch(ctx, prm)
|
|
cancel()
|
|
if err != nil {
|
|
if isContextCanceledErr(err) {
|
|
return nil
|
|
}
|
|
return fmt.Errorf("failed to find '%s' object with index %d: %w", bfs.cfg.IndexFileAttribute, startIndex, err)
|
|
}
|
|
if len(blockOidsObject) == 0 {
|
|
bfs.log.Info(fmt.Sprintf("NeoFS BlockFetcher service: no '%s' object found with index %d, stopping", bfs.cfg.IndexFileAttribute, startIndex))
|
|
return nil
|
|
}
|
|
|
|
blockCtx, blockCancel := context.WithTimeout(bfs.ctx, bfs.cfg.Timeout)
|
|
defer blockCancel()
|
|
oidsRC, err := bfs.objectGet(blockCtx, blockOidsObject[0].String())
|
|
if err != nil {
|
|
if isContextCanceledErr(err) {
|
|
return nil
|
|
}
|
|
return fmt.Errorf("failed to fetch '%s' object with index %d: %w", bfs.cfg.IndexFileAttribute, startIndex, err)
|
|
}
|
|
|
|
err = bfs.streamBlockOIDs(oidsRC, int(skip))
|
|
if err != nil {
|
|
if isContextCanceledErr(err) {
|
|
return nil
|
|
}
|
|
return fmt.Errorf("failed to stream block OIDs with index %d: %w", startIndex, err)
|
|
}
|
|
|
|
startIndex++
|
|
skip = 0
|
|
}
|
|
}
|
|
}
|
|
|
|
// streamBlockOIDs reads block OIDs from the read closer and sends them to the OIDs channel.
|
|
func (bfs *Service) streamBlockOIDs(rc io.ReadCloser, skip int) error {
|
|
defer rc.Close()
|
|
oidBytes := make([]byte, oidSize)
|
|
oidsProcessed := 0
|
|
|
|
for {
|
|
_, err := io.ReadFull(rc, oidBytes)
|
|
if err == io.EOF {
|
|
break
|
|
}
|
|
if err != nil {
|
|
return fmt.Errorf("failed to read OID: %w", err)
|
|
}
|
|
|
|
if oidsProcessed < skip {
|
|
oidsProcessed++
|
|
continue
|
|
}
|
|
|
|
var oidBlock oid.ID
|
|
if err := oidBlock.Decode(oidBytes); err != nil {
|
|
return fmt.Errorf("failed to decode OID: %w", err)
|
|
}
|
|
|
|
select {
|
|
case <-bfs.exiterToOIDDownloader:
|
|
return nil
|
|
case bfs.oidsCh <- oidBlock:
|
|
}
|
|
|
|
oidsProcessed++
|
|
}
|
|
if oidsProcessed != int(bfs.cfg.IndexFileSize) {
|
|
return fmt.Errorf("block OIDs count mismatch: expected %d, processed %d", bfs.cfg.IndexFileSize, oidsProcessed)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// fetchOIDsBySearch fetches block OIDs from NeoFS by searching through the Block objects.
|
|
func (bfs *Service) fetchOIDsBySearch() error {
|
|
startIndex := bfs.chain.BlockHeight()
|
|
batchSize := uint32(bfs.cfg.OIDBatchSize)
|
|
|
|
for {
|
|
select {
|
|
case <-bfs.exiterToOIDDownloader:
|
|
return nil
|
|
default:
|
|
prm := client.PrmObjectSearch{}
|
|
filters := object.NewSearchFilters()
|
|
filters.AddFilter(bfs.cfg.BlockAttribute, fmt.Sprintf("%d", startIndex), object.MatchNumGE)
|
|
filters.AddFilter(bfs.cfg.BlockAttribute, fmt.Sprintf("%d", startIndex+batchSize-1), object.MatchNumLE)
|
|
prm.SetFilters(filters)
|
|
ctx, cancel := context.WithTimeout(bfs.ctx, bfs.cfg.Timeout)
|
|
blockOids, err := bfs.objectSearch(ctx, prm)
|
|
cancel()
|
|
if err != nil {
|
|
if isContextCanceledErr(err) {
|
|
return nil
|
|
}
|
|
return err
|
|
}
|
|
|
|
if len(blockOids) == 0 {
|
|
bfs.log.Info(fmt.Sprintf("NeoFS BlockFetcher service: no block found with index %d, stopping", startIndex))
|
|
return nil
|
|
}
|
|
for _, oid := range blockOids {
|
|
select {
|
|
case <-bfs.exiterToOIDDownloader:
|
|
return nil
|
|
case bfs.oidsCh <- oid:
|
|
}
|
|
}
|
|
startIndex += batchSize
|
|
}
|
|
}
|
|
}
|
|
|
|
// readBlock decodes the block from the read closer and prepares it for adding to the blockchain.
|
|
func (bfs *Service) readBlock(rc io.ReadCloser) (*block.Block, error) {
|
|
b := block.New(bfs.stateRootInHeader)
|
|
r := gio.NewBinReaderFromIO(rc)
|
|
b.DecodeBinary(r)
|
|
rc.Close()
|
|
return b, r.Err
|
|
}
|
|
|
|
// Shutdown stops the NeoFS BlockFetcher service. It prevents service from new
|
|
// block OIDs search, cancels all in-progress downloading operations and waits
|
|
// until all service routines finish their work.
|
|
func (bfs *Service) Shutdown() {
|
|
if !bfs.IsActive() {
|
|
return
|
|
}
|
|
bfs.stopService(true)
|
|
<-bfs.exiterToShutdown
|
|
}
|
|
|
|
// stopService close quitting goroutine once. It's the only entrypoint to shutdown
|
|
// procedure.
|
|
func (bfs *Service) stopService(force bool) {
|
|
bfs.quitOnce.Do(func() {
|
|
bfs.quit <- force
|
|
close(bfs.quit)
|
|
})
|
|
}
|
|
|
|
// exiter is a routine that is listening to a quitting signal and manages graceful
|
|
// Service shutdown process.
|
|
func (bfs *Service) exiter() {
|
|
// Closing signal may come from anyone, but only once.
|
|
force := <-bfs.quit
|
|
bfs.log.Info("shutting down NeoFS BlockFetcher service",
|
|
zap.Bool("force", force),
|
|
)
|
|
|
|
// Cansel all pending OIDs/blocks downloads in case if shutdown requested by user
|
|
// or caused by downloading error.
|
|
if force {
|
|
bfs.ctxCancel()
|
|
}
|
|
|
|
// Send signal to OID downloader to stop. Wait until OID downloader finishes his
|
|
// work.
|
|
close(bfs.exiterToOIDDownloader)
|
|
<-bfs.oidDownloaderToExiter
|
|
|
|
// Close OIDs channel to let block downloaders know that there are no more OIDs
|
|
// expected. Wait until all downloaders finish their work.
|
|
close(bfs.oidsCh)
|
|
bfs.wg.Wait()
|
|
|
|
// Send signal to block putter to finish his work. Wait until it's finished.
|
|
close(bfs.blocksCh)
|
|
<-bfs.blockQueuerToExiter
|
|
|
|
// Everything is done, release resources, turn off the activity marker and let
|
|
// the server know about it.
|
|
_ = bfs.client.Close()
|
|
_ = bfs.log.Sync()
|
|
bfs.isActive.CompareAndSwap(true, false)
|
|
bfs.shutdownCallback()
|
|
|
|
// Notify Shutdown routine in case if it's user-triggered shutdown.
|
|
close(bfs.exiterToShutdown)
|
|
}
|
|
|
|
// IsActive returns true if the NeoFS BlockFetcher service is running.
|
|
func (bfs *Service) IsActive() bool {
|
|
return bfs.isActive.Load()
|
|
}
|
|
|
|
func (bfs *Service) objectGet(ctx context.Context, oid string) (io.ReadCloser, error) {
|
|
u, err := url.Parse(fmt.Sprintf("neofs:%s/%s", bfs.cfg.ContainerID, oid))
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
rc, err := neofs.GetWithClient(ctx, bfs.client, bfs.account.PrivateKey(), u, false)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return rc, nil
|
|
}
|
|
|
|
func (bfs *Service) objectSearch(ctx context.Context, prm client.PrmObjectSearch) ([]oid.ID, error) {
|
|
return neofs.ObjectSearch(ctx, bfs.client, bfs.account.PrivateKey(), bfs.cfg.ContainerID, prm)
|
|
}
|
|
|
|
// isContextCanceledErr returns whether error is a wrapped [context.Canceled].
|
|
// Ref. https://github.com/nspcc-dev/neofs-sdk-go/issues/624.
|
|
func isContextCanceledErr(err error) bool {
|
|
return errors.Is(err, context.Canceled) ||
|
|
strings.Contains(err.Error(), "context canceled")
|
|
}
|