solrengine-sdp 0.1.0

data/lib/solrengine/sdp.rb

@@ -0,0 +1,128 @@
+# frozen_string_literal: true
+
+require "bigdecimal"
+require "solana-sdp"
+require "solrengine/realtime"
+
+require_relative "sdp/version"
+require_relative "sdp/errors"
+require_relative "sdp/configuration"
+require_relative "sdp/wallet_owner"
+require_relative "sdp/broadcaster"
+require_relative "sdp/faucet"
+require_relative "sdp/engine" if defined?(Rails::Engine)
+
+module Solrengine
+  # Rails engine for custodial Solana wallets backed by the Solana Developer
+  # Platform (SDP). Composes the solana-sdp client with the solrengine family.
+  module Sdp
+    # Rake task prefixes for which the boot-time api_key check is skipped:
+    # CI and Docker image builds run these without production secrets.
+    EXEMPT_TASK_PREFIXES = %w[assets: db: app: tmp: log:].freeze
+
+    # Name this engine registers under on the solrengine-realtime subscriber
+    # registry (start_realtime!/stop_realtime!). Apps can register their own
+    # subscribers alongside it under their own names.
+    REALTIME_SUBSCRIBER_NAME = :solrengine_sdp
+
+    class << self
+      def configuration
+        @configuration ||= Configuration.new
+      end
+
+      def configure
+        yield(configuration)
+        @client = nil
+        configuration
+      end
+
+      # Memoized SDP API client built from the configuration. Reset whenever
+      # `configure` runs, so reconfiguring always yields a fresh client.
+      def client
+        @client ||= ::Sdp::Client.new(
+          api_key: configuration.validate!.api_key,
+          base_url: configuration.base_url
+        )
+      end
+
+      def reset_configuration!
+        @configuration = nil
+        @client = nil
+      end
+
+      # Pure function over rake task names so the exemption logic is
+      # unit-testable: exempt_context?(["assets:precompile"]) => true.
+      def exempt_context?(task_names)
+        Array(task_names).any? do |task|
+          EXEMPT_TASK_PREFIXES.any? { |prefix| task.to_s.start_with?(prefix) }
+        end
+      end
+
+      # True when the current process is an exempt rake task (boot check skip).
+      def exempt_rake_context?
+        return false unless defined?(Rake) && Rake.respond_to?(:application)
+
+        application = Rake.application
+        return false unless application.respond_to?(:top_level_tasks)
+
+        exempt_context?(application.top_level_tasks)
+      end
+
+      # solrengine-tokens is an optional price source — never a hard
+      # dependency. True when its JupiterClient is loadable.
+      def price_source_available?
+        return true if defined?(Solrengine::Tokens::JupiterClient)
+
+        begin
+          require "solrengine/tokens"
+        rescue LoadError
+          return false
+        end
+
+        defined?(Solrengine::Tokens::JupiterClient) ? true : false
+      end
+
+      # USD price for a mint via the optional tokens gem. Returns nil when the
+      # gem is absent or the price lookup fails — price must never gate money
+      # flows (the U9 broadcaster builds on this).
+      def price_for(mint)
+        return nil unless price_source_available?
+
+        Solrengine::Tokens::JupiterClient.fetch_prices([ mint ])[mint]
+      rescue StandardError
+        nil
+      end
+
+      # USD value for an Sdp::Balance (AE3): SDP's own usd_value when present
+      # (v0.29+ populates it), else derived from the optional tokens gem's
+      # Jupiter price, else nil. Price data is decorative — every failure
+      # path degrades to nil so a price hiccup can NEVER fail a broadcaster
+      # fetch or gate a money-movement broadcast.
+      def usd_value_for(balance)
+        usd = balance.usd_value
+        return usd unless usd.nil? || usd.to_s.empty?
+
+        price = price_for(balance.mint)
+        return nil unless price
+
+        BigDecimal(balance.ui_amount.to_s) * BigDecimal(price.to_s)
+      rescue StandardError
+        nil
+      end
+
+      # Registers the engine's Broadcaster on the solrengine-realtime
+      # subscriber registry: every account-change dispatch re-fetches and
+      # broadcasts for that wallet. Called by the watcher process
+      # (bin/sdp_watcher); idempotent — re-subscribing replaces the block.
+      def start_realtime!
+        Solrengine::Realtime.subscribe(REALTIME_SUBSCRIBER_NAME) do |wallet_address|
+          Broadcaster.call(wallet_address)
+        end
+      end
+
+      def stop_realtime!
+        Solrengine::Realtime.unsubscribe(REALTIME_SUBSCRIBER_NAME)
+      end
+    end
+  end
+end

data/lib/solrengine-sdp.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "solrengine/sdp"

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification
+name: solrengine-sdp
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jose Ferrer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-06-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  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: solana-sdp
+  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: solrengine-realtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+description: 'Rails engine for SDP-backed apps: Wallet-per-User provisioning, transfer
+  persistence and tracking, and real-time balance broadcasts built on the solrengine
+  family.'
+email:
+- estoy@moviendo.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- app/jobs/solrengine/sdp/provision_wallet_job.rb
+- app/jobs/solrengine/sdp/track_transfer_job.rb
+- app/models/solrengine/sdp/transfer.rb
+- lib/generators/solrengine/sdp/install_generator.rb
+- lib/generators/solrengine/sdp/templates/add_solrengine_sdp_to_users.rb
+- lib/generators/solrengine/sdp/templates/cable.yml
+- lib/generators/solrengine/sdp/templates/create_solrengine_sdp_transfers.rb
+- lib/generators/solrengine/sdp/templates/initializer.rb
+- lib/generators/solrengine/sdp/templates/sdp_watcher
+- lib/solrengine-sdp.rb
+- lib/solrengine/sdp.rb
+- lib/solrengine/sdp/broadcaster.rb
+- lib/solrengine/sdp/configuration.rb
+- lib/solrengine/sdp/engine.rb
+- lib/solrengine/sdp/errors.rb
+- lib/solrengine/sdp/faucet.rb
+- lib/solrengine/sdp/version.rb
+- lib/solrengine/sdp/wallet_owner.rb
+homepage: https://github.com/solrengine/sdp
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/solrengine/sdp
+  source_code_uri: https://github.com/solrengine/sdp
+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: Custodial Solana wallets for Rails via the Solana Developer Platform
+test_files: []