// Copyright (C) 2020 Storj Labs, Inc. // See LICENSE for copying information. package heldamount import ( "context" "time" "github.com/zeebo/errs" "storj.io/common/storj" ) // DB works with heldamount database // // architecture: Database type DB interface { // StorePayStub inserts or updates held amount into the DB StorePayStub(ctx context.Context, paystub PayStub) error // GetPayStub retrieves paystub stats for specific satellite GetPayStub(ctx context.Context, satelliteID storj.NodeID, period string) (*PayStub, error) // AllPayStubs retrieves paystub data from all satellites in specific period from DB. AllPayStubs(ctx context.Context, period string) ([]PayStub, error) // SatellitesHeldbackHistory retrieves heldback history for specific satellite from DB. SatellitesHeldbackHistory(ctx context.Context, satelliteID storj.NodeID) ([]AmountPeriod, error) // SatellitePeriods retrieves all periods for concrete satellite in which we have some heldamount data. SatellitePeriods(ctx context.Context, satelliteID storj.NodeID) ([]string, error) // AllPeriods retrieves all periods in which we have some heldamount data. AllPeriods(ctx context.Context) ([]string, error) } // ErrNoPayStubForPeriod represents errors from the heldamount database. var ErrNoPayStubForPeriod = errs.Class("no payStub for period error") // PayStub is node heldamount data for satellite by specific period. type PayStub struct { SatelliteID storj.NodeID `json:"satelliteId"` Period string `json:"period"` Created time.Time `json:"created"` Codes string `json:"codes"` UsageAtRest float64 `json:"usageAtRest"` UsageGet int64 `json:"usageGet"` UsagePut int64 `json:"usagePut"` UsageGetRepair int64 `json:"usageGetRepair"` UsagePutRepair int64 `json:"usagePutRepair"` UsageGetAudit int64 `json:"usageGetAudit"` CompAtRest int64 `json:"compAtRest"` CompGet int64 `json:"compGet"` CompPut int64 `json:"compPut"` CompGetRepair int64 `json:"compGetRepair"` CompPutRepair int64 `json:"compPutRepair"` CompGetAudit int64 `json:"compGetAudit"` SurgePercent int64 `json:"surgePercent"` Held int64 `json:"held"` Owed int64 `json:"owed"` Disposed int64 `json:"disposed"` Paid int64 `json:"paid"` } // AmountPeriod is node's held amount for period. type AmountPeriod struct { Period string `json:"period"` Held int64 `json:"held"` } // EstimatedPayout contains amount in cents of estimated payout for current and previous months. type EstimatedPayout struct { CurrentMonthEstimatedAmount int64 `json:"currentAmount"` CurrentMonthHeld int64 `json:"currentHeld"` PreviousMonthPayout PayoutMonthly `json:"previousPayout"` } // PayoutMonthly contains bandwidth and payout amount for month. type PayoutMonthly struct { EgressBandwidth int64 `json:"egressBandwidth"` EgressPayout int64 `json:"egressPayout"` EgressRepairAudit int64 `json:"egressRepairAudit"` RepairAuditPayout int64 `json:"repairAuditPayout"` DiskSpace float64 `json:"diskSpace"` DiskSpaceAmount int64 `json:"diskSpaceAmount"` HeldPercentRate int64 `json:"heldRate"` }