solana-ruby-watchtower 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,34 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Solana
4
+ module Ruby
5
+ # Off-box monitoring for a Solana validator or an active/standby pair.
6
+ #
7
+ # The pieces, from the bottom up:
8
+ #
9
+ # Rpc / RpcPool JSON-RPC over net/http, tried endpoint by endpoint
10
+ # Observe reads the vote account and the gossip table
11
+ # CheckState alert state of one check: fire, remind, resolve
12
+ # Stores::* where CheckStates live between runs
13
+ # Notifiers::* where alerts go
14
+ # Monitor runs the checks and turns results into alerts
15
+ # Runner / CLI the long-running daemon around a Monitor
16
+ module Watchtower
17
+ class Error < StandardError; end
18
+ end
19
+ end
20
+ end
21
+
22
+ require_relative 'watchtower/version'
23
+ require_relative 'watchtower/config'
24
+ require_relative 'watchtower/rpc'
25
+ require_relative 'watchtower/observe'
26
+ require_relative 'watchtower/check_state'
27
+ require_relative 'watchtower/stores/memory_store'
28
+ require_relative 'watchtower/stores/file_store'
29
+ require_relative 'watchtower/stores/active_record_store'
30
+ require_relative 'watchtower/notifiers'
31
+ require_relative 'watchtower/heartbeat'
32
+ require_relative 'watchtower/monitor'
33
+ require_relative 'watchtower/runner'
34
+ require_relative 'watchtower/cli'
@@ -0,0 +1,43 @@
1
+ # frozen_string_literal: true
2
+
3
+ require_relative 'lib/solana/ruby/watchtower/version'
4
+
5
+ Gem::Specification.new do |spec|
6
+ spec.name = 'solana-ruby-watchtower'
7
+ spec.version = Solana::Ruby::Watchtower::VERSION
8
+ spec.authors = ['Paul Zupan, Idhra Inc.']
9
+ spec.summary = 'Off-box monitor for Solana validators, including active/standby HA pairs'
10
+ spec.description = <<~DESC
11
+ Watches a Solana validator from the cluster's side, the way agave-watchtower
12
+ does, and adds the checks an active/standby pair needs: each node present in
13
+ gossip, the staked identity on a known host, and the staked identity
14
+ advertised by two nodes at once. Alerts go to Telegram or a webhook (Slack or
15
+ Discord) once, again while a problem lasts, and when it clears.
16
+ DESC
17
+ spec.homepage = 'https://github.com/idhra/solana-ruby-watchtower'
18
+ spec.license = 'MIT'
19
+ spec.required_ruby_version = '>= 3.2.0'
20
+ spec.require_paths = ['lib']
21
+ spec.bindir = 'exe'
22
+ spec.executables = ['solana-watchtower']
23
+
24
+ spec.metadata = {
25
+ 'source_code_uri' => "#{spec.homepage}/tree/main",
26
+ 'bug_tracker_uri' => "#{spec.homepage}/issues",
27
+ 'changelog_uri' => "#{spec.homepage}/blob/main/CHANGELOG.md",
28
+ 'rubygems_mfa_required' => 'true'
29
+ }
30
+
31
+ spec.files = Dir['lib/**/*.rb', 'exe/*', 'examples/*'] +
32
+ ['LICENSE', 'README.md', 'CHANGELOG.md', 'solana-ruby-watchtower.gemspec']
33
+ spec.extra_rdoc_files = ['LICENSE', 'README.md']
34
+
35
+ # Runtime is the standard library only (net/http, json, yaml), so an operator
36
+ # can run it on a small box without libsodium or a Solana SDK. logger leaves
37
+ # the default gems in Ruby 3.5, hence the explicit dependency.
38
+ spec.add_dependency 'logger', '~> 1.6'
39
+
40
+ spec.add_development_dependency 'rake', '~> 13.0'
41
+ spec.add_development_dependency 'rspec', '~> 3.13'
42
+ spec.add_development_dependency 'webmock', '~> 3.26'
43
+ end
metadata ADDED
@@ -0,0 +1,127 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: solana-ruby-watchtower
3
+ version: !ruby/object:Gem::Version
4
+ version: 0.1.0
5
+ platform: ruby
6
+ authors:
7
+ - Paul Zupan, Idhra Inc.
8
+ bindir: exe
9
+ cert_chain: []
10
+ date: 1980-01-02 00:00:00.000000000 Z
11
+ dependencies:
12
+ - !ruby/object:Gem::Dependency
13
+ name: logger
14
+ requirement: !ruby/object:Gem::Requirement
15
+ requirements:
16
+ - - "~>"
17
+ - !ruby/object:Gem::Version
18
+ version: '1.6'
19
+ type: :runtime
20
+ prerelease: false
21
+ version_requirements: !ruby/object:Gem::Requirement
22
+ requirements:
23
+ - - "~>"
24
+ - !ruby/object:Gem::Version
25
+ version: '1.6'
26
+ - !ruby/object:Gem::Dependency
27
+ name: rake
28
+ requirement: !ruby/object:Gem::Requirement
29
+ requirements:
30
+ - - "~>"
31
+ - !ruby/object:Gem::Version
32
+ version: '13.0'
33
+ type: :development
34
+ prerelease: false
35
+ version_requirements: !ruby/object:Gem::Requirement
36
+ requirements:
37
+ - - "~>"
38
+ - !ruby/object:Gem::Version
39
+ version: '13.0'
40
+ - !ruby/object:Gem::Dependency
41
+ name: rspec
42
+ requirement: !ruby/object:Gem::Requirement
43
+ requirements:
44
+ - - "~>"
45
+ - !ruby/object:Gem::Version
46
+ version: '3.13'
47
+ type: :development
48
+ prerelease: false
49
+ version_requirements: !ruby/object:Gem::Requirement
50
+ requirements:
51
+ - - "~>"
52
+ - !ruby/object:Gem::Version
53
+ version: '3.13'
54
+ - !ruby/object:Gem::Dependency
55
+ name: webmock
56
+ requirement: !ruby/object:Gem::Requirement
57
+ requirements:
58
+ - - "~>"
59
+ - !ruby/object:Gem::Version
60
+ version: '3.26'
61
+ type: :development
62
+ prerelease: false
63
+ version_requirements: !ruby/object:Gem::Requirement
64
+ requirements:
65
+ - - "~>"
66
+ - !ruby/object:Gem::Version
67
+ version: '3.26'
68
+ description: |
69
+ Watches a Solana validator from the cluster's side, the way agave-watchtower
70
+ does, and adds the checks an active/standby pair needs: each node present in
71
+ gossip, the staked identity on a known host, and the staked identity
72
+ advertised by two nodes at once. Alerts go to Telegram or a webhook (Slack or
73
+ Discord) once, again while a problem lasts, and when it clears.
74
+ executables:
75
+ - solana-watchtower
76
+ extensions: []
77
+ extra_rdoc_files:
78
+ - LICENSE
79
+ - README.md
80
+ files:
81
+ - CHANGELOG.md
82
+ - LICENSE
83
+ - README.md
84
+ - examples/solana-watchtower.service
85
+ - examples/watchtower.yml
86
+ - exe/solana-watchtower
87
+ - lib/solana/ruby/watchtower.rb
88
+ - lib/solana/ruby/watchtower/check_state.rb
89
+ - lib/solana/ruby/watchtower/cli.rb
90
+ - lib/solana/ruby/watchtower/config.rb
91
+ - lib/solana/ruby/watchtower/heartbeat.rb
92
+ - lib/solana/ruby/watchtower/monitor.rb
93
+ - lib/solana/ruby/watchtower/notifiers.rb
94
+ - lib/solana/ruby/watchtower/observe.rb
95
+ - lib/solana/ruby/watchtower/rpc.rb
96
+ - lib/solana/ruby/watchtower/runner.rb
97
+ - lib/solana/ruby/watchtower/stores/active_record_store.rb
98
+ - lib/solana/ruby/watchtower/stores/file_store.rb
99
+ - lib/solana/ruby/watchtower/stores/memory_store.rb
100
+ - lib/solana/ruby/watchtower/version.rb
101
+ - solana-ruby-watchtower.gemspec
102
+ homepage: https://github.com/idhra/solana-ruby-watchtower
103
+ licenses:
104
+ - MIT
105
+ metadata:
106
+ source_code_uri: https://github.com/idhra/solana-ruby-watchtower/tree/main
107
+ bug_tracker_uri: https://github.com/idhra/solana-ruby-watchtower/issues
108
+ changelog_uri: https://github.com/idhra/solana-ruby-watchtower/blob/main/CHANGELOG.md
109
+ rubygems_mfa_required: 'true'
110
+ rdoc_options: []
111
+ require_paths:
112
+ - lib
113
+ required_ruby_version: !ruby/object:Gem::Requirement
114
+ requirements:
115
+ - - ">="
116
+ - !ruby/object:Gem::Version
117
+ version: 3.2.0
118
+ required_rubygems_version: !ruby/object:Gem::Requirement
119
+ requirements:
120
+ - - ">="
121
+ - !ruby/object:Gem::Version
122
+ version: '0'
123
+ requirements: []
124
+ rubygems_version: 3.6.9
125
+ specification_version: 4
126
+ summary: Off-box monitor for Solana validators, including active/standby HA pairs
127
+ test_files: []