Building 70 Projects ranging from beginner to advanced so anyone can — learn from, build upon, use as a reference, or even copy directly. Owned by my cybersecurity company 👇
Go aicertificationcloud-engineeringcybercybersecuritycybersecurity-analystcybersecurity-certificationcybersecurity-certificationscybersecurity-educationcybersecurity-jobscybersecurity-portfoliocybersecurity-projectscybersecurity-toolsgrchackinglearningpentestingproject-repositoryprojetcspython
feat(monitor/collectors/coinbase): gap-aware ReadLoop (snapshot resets sequencer; gap → ErrSequenceGap)
CarterPerez-dev23a4e2ded4ed
diff --git a/PROJECTS/advanced/monitor-the-situation-dashboard/backend/internal/collectors/coinbase/readloop.go b/PROJECTS/advanced/monitor-the-situation-dashboard/backend/internal/collectors/coinbase/readloop.gonew file mode 100644index 00000000..a3b404cf--- /dev/null+++ b/PROJECTS/advanced/monitor-the-situation-dashboard/backend/internal/collectors/coinbase/readloop.go@@ -0,0 +1,46 @@+// ©AngelaMos | 2026+// readloop.go++package coinbase++import (+ "context"+ "errors"+)++var ErrSequenceGap = errors.New("coinbase: sequence gap detected")++type FrameHandler func(ctx context.Context, f Frame) error++func ReadLoop(ctx context.Context, conn *Conn, seq *Sequencer, handler FrameHandler) error {+ for {+ if err := ctx.Err(); err != nil {+ return err+ }+ frame, err := conn.ReadFrame(ctx)+ if err != nil {+ if ctx.Err() != nil {+ return ctx.Err()+ }+ return err+ }++ switch frame.Kind {+ case FrameTypeSnapshot:+ seq.Reset()+ for _, t := range frame.Tickers {+ _ = seq.Observe(t.ProductID, frame.SequenceNum)+ }+ case FrameTypeTicker:+ for _, t := range frame.Tickers {+ if seq.Observe(t.ProductID, frame.SequenceNum) {+ return ErrSequenceGap+ }+ }+ }++ if err := handler(ctx, frame); err != nil {+ return err+ }+ }+}diff --git a/PROJECTS/advanced/monitor-the-situation-dashboard/backend/internal/collectors/coinbase/readloop_test.go b/PROJECTS/advanced/monitor-the-situation-dashboard/backend/internal/collectors/coinbase/readloop_test.gonew file mode 100644index 00000000..b1af6e69--- /dev/null+++ b/PROJECTS/advanced/monitor-the-situation-dashboard/backend/internal/collectors/coinbase/readloop_test.go@@ -0,0 +1,106 @@+// ©AngelaMos | 2026+// readloop_test.go++package coinbase_test++import (+ "context"+ "errors"+ "sync"+ "testing"+ "time"++ "github.com/stretchr/testify/require"++ "github.com/carterperez-dev/monitor-the-situation/backend/internal/collectors/coinbase"+)++func TestReadLoop_DeliversTickerFrames(t *testing.T) {+ fs := newFakeServer(t,+ loadFixture(t, "subscriptions.json"),+ []byte(`{"channel":"ticker","sequence_num":1000,"timestamp":"2026-05-01T22:30:00Z","events":[{"type":"update","tickers":[{"product_id":"BTC-USD","price":"42000.00","volume_24_h":"1.0","time":"2026-05-01T22:30:00Z"}]}]}`),+ []byte(`{"channel":"ticker","sequence_num":1001,"timestamp":"2026-05-01T22:30:01Z","events":[{"type":"update","tickers":[{"product_id":"BTC-USD","price":"42001.00","volume_24_h":"1.0","time":"2026-05-01T22:30:01Z"}]}]}`),+ )++ d := coinbase.NewWSDialer(coinbase.DialerConfig{URL: fs.URL(), ProductIDs: []string{"BTC-USD"}})+ ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)+ defer cancel()+ conn, err := d.Dial(ctx)+ require.NoError(t, err)+ defer conn.Close()++ seq := coinbase.NewSequencer()+ mu := sync.Mutex{}+ tickerFrames := 0++ loopCtx, loopCancel := context.WithTimeout(ctx, 500*time.Millisecond)+ defer loopCancel()++ err = coinbase.ReadLoop(loopCtx, conn, seq, func(_ context.Context, f coinbase.Frame) error {+ mu.Lock()+ defer mu.Unlock()+ if f.Kind == coinbase.FrameTypeTicker {+ tickerFrames+++ }+ return nil+ })+ require.True(t, errors.Is(err, context.DeadlineExceeded) || errors.Is(err, context.Canceled) || err == nil)+ mu.Lock()+ defer mu.Unlock()+ require.GreaterOrEqual(t, tickerFrames, 2)+}++func TestReadLoop_GapTriggersErrSequenceGap(t *testing.T) {+ fs := newFakeServer(t,+ loadFixture(t, "subscriptions.json"),+ []byte(`{"channel":"ticker","sequence_num":100,"timestamp":"2026-05-01T22:30:00Z","events":[{"type":"update","tickers":[{"product_id":"BTC-USD","price":"42000.00","volume_24_h":"1.0","time":"2026-05-01T22:30:00Z"}]}]}`),+ []byte(`{"channel":"ticker","sequence_num":250,"timestamp":"2026-05-01T22:30:01Z","events":[{"type":"update","tickers":[{"product_id":"BTC-USD","price":"42001.00","volume_24_h":"1.0","time":"2026-05-01T22:30:01Z"}]}]}`),+ )++ d := coinbase.NewWSDialer(coinbase.DialerConfig{URL: fs.URL(), ProductIDs: []string{"BTC-USD"}})+ ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)+ defer cancel()+ conn, err := d.Dial(ctx)+ require.NoError(t, err)+ defer conn.Close()++ seq := coinbase.NewSequencer()+ loopErr := coinbase.ReadLoop(ctx, conn, seq, func(context.Context, coinbase.Frame) error {+ return nil+ })+ require.ErrorIs(t, loopErr, coinbase.ErrSequenceGap)+}++func TestReadLoop_SnapshotResetsSequencer(t *testing.T) {+ fs := newFakeServer(t,+ loadFixture(t, "subscriptions.json"),+ loadFixture(t, "snapshot.json"),+ []byte(`{"channel":"ticker","sequence_num":2,"timestamp":"2026-05-01T22:30:02Z","events":[{"type":"update","tickers":[{"product_id":"BTC-USD","price":"42164.00","volume_24_h":"1.0","time":"2026-05-01T22:30:02Z"}]}]}`),+ )++ d := coinbase.NewWSDialer(coinbase.DialerConfig{URL: fs.URL(), ProductIDs: []string{"BTC-USD"}})+ ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)+ defer cancel()+ conn, err := d.Dial(ctx)+ require.NoError(t, err)+ defer conn.Close()++ seq := coinbase.NewSequencer()+ mu := sync.Mutex{}+ kinds := []coinbase.FrameType{}++ loopCtx, loopCancel := context.WithTimeout(ctx, 800*time.Millisecond)+ defer loopCancel()+ err = coinbase.ReadLoop(loopCtx, conn, seq, func(_ context.Context, f coinbase.Frame) error {+ mu.Lock()+ defer mu.Unlock()+ kinds = append(kinds, f.Kind)+ return nil+ })+ require.True(t, errors.Is(err, context.DeadlineExceeded) || errors.Is(err, context.Canceled) || err == nil)++ mu.Lock()+ defer mu.Unlock()+ require.Contains(t, kinds, coinbase.FrameTypeSnapshot)+ require.Contains(t, kinds, coinbase.FrameTypeTicker)+}