aboutsummaryrefslogtreecommitdiffstats
path: root/p2p/protocols/accounting_api.go
blob: 48e2af9feadd1919ccedda9656c7ece7746ce037 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
package protocols

import (
    "errors"
)

// Textual version number of accounting API
const AccountingVersion = "1.0"

var errNoAccountingMetrics = errors.New("accounting metrics not enabled")

// AccountingApi provides an API to access account related information
type AccountingApi struct {
    metrics *AccountingMetrics
}

// NewAccountingApi creates a new AccountingApi
// m will be used to check if accounting metrics are enabled
func NewAccountingApi(m *AccountingMetrics) *AccountingApi {
    return &AccountingApi{m}
}

// Balance returns local node balance (units credited - units debited)
func (self *AccountingApi) Balance() (int64, error) {
    if self.metrics == nil {
        return 0, errNoAccountingMetrics
    }
    balance := mBalanceCredit.Count() - mBalanceDebit.Count()
    return balance, nil
}

// BalanceCredit returns total amount of units credited by local node
func (self *AccountingApi) BalanceCredit() (int64, error) {
    if self.metrics == nil {
        return 0, errNoAccountingMetrics
    }
    return mBalanceCredit.Count(), nil
}

// BalanceCredit returns total amount of units debited by local node
func (self *AccountingApi) BalanceDebit() (int64, error) {
    if self.metrics == nil {
        return 0, errNoAccountingMetrics
    }
    return mBalanceDebit.Count(), nil
}

// BytesCredit returns total amount of bytes credited by local node
func (self *AccountingApi) BytesCredit() (int64, error) {
    if self.metrics == nil {
        return 0, errNoAccountingMetrics
    }
    return mBytesCredit.Count(), nil
}

// BalanceCredit returns total amount of bytes debited by local node
func (self *AccountingApi) BytesDebit() (int64, error) {
    if self.metrics == nil {
        return 0, errNoAccountingMetrics
    }
    return mBytesDebit.Count(), nil
}

// MsgCredit returns total amount of messages credited by local node
func (self *AccountingApi) MsgCredit() (int64, error) {
    if self.metrics == nil {
        return 0, errNoAccountingMetrics
    }
    return mMsgCredit.Count(), nil
}

// MsgDebit returns total amount of messages debited by local node
func (self *AccountingApi) MsgDebit() (int64, error) {
    if self.metrics == nil {
        return 0, errNoAccountingMetrics
    }
    return mMsgDebit.Count(), nil
}

// PeerDrops returns number of times when local node had to drop remote peers
func (self *AccountingApi) PeerDrops() (int64, error) {
    if self.metrics == nil {
        return 0, errNoAccountingMetrics
    }
    return mPeerDrops.Count(), nil
}

// SelfDrops returns number of times when local node was overdrafted and dropped
func (self *AccountingApi) SelfDrops() (int64, error) {
    if self.metrics == nil {
        return 0, errNoAccountingMetrics
    }
    return mSelfDrops.Count(), nil
}