solrengine-realtime 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e24339e63d6e1bea90aa6dd8bac526f5ef32659451ea97866b4b2d90f927b171
+  data.tar.gz: c64312b31bd91b27311431729677109b22a9dee0de8e38a3b8784e3cbff2352d
+SHA512:
+  metadata.gz: 4bb5d4ecb5d4bdf28d9d90c7308506bbd17cda2ab4bed4f0f7534b9fe72f68aeaff195c87b329bb7c6af3d0b46ae7bb560c58d5405f1429da0db68699461b25b
+  data.tar.gz: 2b610121748e95b28ce407e363bdb7221708f8f8b1ba87ac4558f0a4133e2f2e283cc428f5d30585c4450397d5be6b262409d703056385e3dcd212fefb09fd93

data/README.md

@@ -0,0 +1,43 @@
+# SolRengine Realtime
+
+Real-time Solana account monitoring via WebSocket + Turbo Streams. Subscribes to account changes and triggers callbacks when balances update.
+
+Part of the [SolRengine](https://github.com/solrengine) framework.
+
+## Install
+
+```ruby
+gem "solrengine-realtime"
+```
+
+## Usage
+
+Configure what happens when an account changes:
+
+```ruby
+# config/initializers/solrengine_realtime.rb
+Solrengine::Realtime.on_account_change = ->(wallet_address) {
+  Rails.cache.delete("wallet/#{wallet_address}/tokens")
+
+  portfolio = Solrengine::Tokens::Portfolio.new(wallet_address)
+
+  Turbo::StreamsChannel.broadcast_replace_to(
+    "wallet_#{wallet_address}",
+    target: "token_list",
+    partial: "dashboard/token_list",
+    locals: { tokens: portfolio.tokens }
+  )
+}
+```
+
+Run the monitor as a separate process:
+
+```ruby
+# bin/solana_monitor
+monitor = Solrengine::Realtime::AccountMonitor.new("Abc...xyz")
+monitor.start
+```
+
+## License
+
+MIT

data/app/assets/javascripts/solrengine/realtime/auto_refresh_controller.js

@@ -0,0 +1,46 @@
+import { Controller } from "@hotwired/stimulus"
+import { morphChildren } from "@hotwired/turbo"
+
+// Periodically fetches fresh HTML and morphs only the changed DOM elements.
+// No Turbo visit, no loading bar, no scroll reset — completely invisible.
+export default class extends Controller {
+  static values = {
+    interval: { type: Number, default: 60 }
+  }
+
+  connect() {
+    this.timer = setInterval(() => {
+      if (document.visibilityState === "visible") {
+        this.morph()
+      }
+    }, this.intervalValue * 1000)
+  }
+
+  disconnect() {
+    clearInterval(this.timer)
+  }
+
+  async morph() {
+    if (this._morphing) return
+    this._morphing = true
+
+    try {
+      const response = await fetch(window.location.href, {
+        headers: { "Accept": "text/html" }
+      })
+      if (!response.ok) return
+
+      const html = await response.text()
+      const doc = new DOMParser().parseFromString(html, "text/html")
+      const newContent = doc.querySelector(`[data-controller~="auto-refresh"]`)
+
+      if (newContent) {
+        morphChildren(this.element, newContent)
+      }
+    } catch {
+      // Silently fail — next interval will retry
+    } finally {
+      this._morphing = false
+    }
+  }
+}

data/lib/solrengine/realtime/account_monitor.rb

@@ -0,0 +1,148 @@
+require "json"
+require "logger"
+require "websocket-client-simple"
+
+module Solrengine
+  module Realtime
+    # Subscribes to Solana WebSocket RPC for real-time account changes.
+    # When an account changes, calls Solrengine::Realtime.on_account_change.
+    class AccountMonitor
+      SOLANA_ADDRESS_REGEX = /\A[1-9A-HJ-NP-Za-km-z]{32,44}\z/
+      RECONNECT_DELAY = 5
+      BROADCAST_DELAY = 3
+
+      attr_reader :wallet_address
+
+      def initialize(wallet_address)
+        unless wallet_address.is_a?(String) && wallet_address.match?(SOLANA_ADDRESS_REGEX)
+          raise ArgumentError, "Invalid Solana wallet address"
+        end
+
+        @wallet_address = wallet_address.freeze
+        @ws_url = Solrengine::Rpc.configuration.ws_url
+
+        unless @ws_url&.start_with?("wss://")
+          logger.warn("[SolanaWS] WebSocket URL does not use wss:// (TLS) — connection is unencrypted")
+        end
+
+        @running = false
+        @subscription_id = nil
+        @account_changed = false
+        @mutex = Mutex.new
+        @cv = ConditionVariable.new
+      end
+
+      def start
+        return if @running
+        @running = true
+
+        @ws_thread = Thread.new { websocket_loop }
+        @broadcast_thread = Thread.new { broadcast_loop }
+      end
+
+      def stop
+        @running = false
+        @cv.signal
+        @ws&.close rescue nil
+        @ws_thread&.join(5)
+        @broadcast_thread&.join(5)
+        @ws_thread = nil
+        @broadcast_thread = nil
+      end
+
+      def running?
+        @running
+      end
+
+      def flag_changed!
+        @mutex.synchronize do
+          @account_changed = true
+          @cv.signal
+        end
+      end
+
+      def logger
+        @logger ||= defined?(Rails) ? Rails.logger : Logger.new($stdout, progname: "SolanaWS")
+      end
+
+      private
+
+      def websocket_loop
+        while @running
+          begin
+            connect_and_listen
+          rescue => e
+            logger.error("[SolanaWS] Connection error: #{e.message}")
+            sleep RECONNECT_DELAY if @running
+          end
+        end
+      end
+
+      def connect_and_listen
+        @ws = WebSocket::Client::Simple.connect(@ws_url)
+        ws = @ws
+        monitor = self
+
+        ws.on :open do
+          monitor.logger.info("[SolanaWS] Connected for #{monitor.wallet_address} on #{Solrengine::Rpc.configuration.network}")
+          ws.send({
+            jsonrpc: "2.0",
+            id: 1,
+            method: "accountSubscribe",
+            params: [
+              monitor.wallet_address,
+              { encoding: "jsonParsed", commitment: "confirmed" }
+            ]
+          }.to_json)
+        end
+
+        ws.on :message do |msg|
+          begin
+            parsed = JSON.parse(msg.data)
+            if parsed["id"] == 1 && parsed["result"]
+              monitor.instance_variable_set(:@subscription_id, parsed["result"])
+              monitor.logger.info("[SolanaWS] Subscribed with ID #{parsed['result']}")
+            elsif parsed["method"] == "accountNotification" &&
+                  parsed.dig("params", "subscription") == monitor.instance_variable_get(:@subscription_id)
+              monitor.logger.info("[SolanaWS] Account changed for #{monitor.wallet_address}")
+              monitor.flag_changed!
+            end
+          rescue => e
+            monitor.logger.error("[SolanaWS] Message parse error: #{e.message}")
+          end
+        end
+
+        ws.on :error do |e|
+          monitor.logger.error("[SolanaWS] Error: #{e.message}")
+        end
+
+        ws.on :close do
+          monitor.logger.info("[SolanaWS] Disconnected")
+        end
+
+        sleep 1 while @running && !ws.closed?
+      end
+
+      def broadcast_loop
+        while @running
+          changed = @mutex.synchronize do
+            @cv.wait(@mutex, 1) until @account_changed || !@running
+            val = @account_changed
+            @account_changed = false
+            val
+          end
+
+          if changed && @running
+            sleep BROADCAST_DELAY
+            @mutex.synchronize { @account_changed = false }
+            begin
+              Solrengine::Realtime.on_account_change.call(@wallet_address)
+            rescue => e
+              logger.error("[SolanaWS] Callback error: #{e.message}")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/solrengine/realtime/engine.rb

@@ -0,0 +1,11 @@
+module Solrengine
+  module Realtime
+    class Engine < ::Rails::Engine
+      isolate_namespace Solrengine::Realtime
+
+      initializer "solrengine-realtime.assets" do |app|
+        app.config.assets.paths << root.join("app/assets/javascripts")
+      end
+    end
+  end
+end

data/lib/solrengine/realtime/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Solrengine
+  module Realtime
+    VERSION = "0.1.0"
+  end
+end

data/lib/solrengine/realtime.rb

@@ -0,0 +1,15 @@
+require "active_support/core_ext/module/attribute_accessors"
+require "solrengine/rpc"
+require_relative "realtime/version"
+require_relative "realtime/account_monitor"
+require_relative "realtime/engine" if defined?(Rails::Engine)
+
+module Solrengine
+  module Realtime
+    mattr_accessor :on_account_change
+
+    self.on_account_change = ->(wallet_address) {
+      puts "[SolRengine] Account changed: #{wallet_address}"
+    }
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: solrengine-realtime
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jose Ferrer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-03-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.1'
+- !ruby/object:Gem::Dependency
+  name: solrengine-rpc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: websocket-client-simple
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: Subscribes to Solana WebSocket RPC for account changes and broadcasts
+  updates via ActionCable/Turbo Streams. Includes Idiomorph auto-refresh Stimulus
+  controller.
+email:
+- estoy@moviendo.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- app/assets/javascripts/solrengine/realtime/auto_refresh_controller.js
+- lib/solrengine/realtime.rb
+- lib/solrengine/realtime/account_monitor.rb
+- lib/solrengine/realtime/engine.rb
+- lib/solrengine/realtime/version.rb
+homepage: https://github.com/solrengine/realtime
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/solrengine/realtime
+  source_code_uri: https://github.com/solrengine/realtime
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Real-time Solana account monitoring via WebSocket + Turbo Streams
+test_files: []