solrengine 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 30115b7e2f062eb4560210d27fdd25e547e593e98b86abad78c84b87cf2161ed
+  data.tar.gz: 7c64d97f057b5b25cbe9a1df2f126d181e9740d2a11c048cd57465ea1178d44c
+SHA512:
+  metadata.gz: a8f44d0ca1cfdbdbff72481513c239862e2c4b0c78a7e8e53bf4a7a92679d0709bd0ca91d8eb280b988922a5e5561fb3b4536fa5892d25ae1de40ea0a1c6eb5d
+  data.tar.gz: a0869720bb4296812e9113d5d01ea97160f64b1d96b96e7bb747a4e2b2f22ec951d4205e41290a3fa483ec1579ab0e470a27e9c5d0f452221eb474ed5f36769f

data/README.md

@@ -0,0 +1,159 @@
+# SolRengine
+
+The Rails framework for building Solana dapps.
+
+Wallet authentication, token portfolio, SOL transfers, real-time WebSocket updates, and custom program interaction — using the Rails 8 default stack.
+
+## Quick Start
+
+### 1. Create a Rails app
+
+```bash
+rails new my_solana_app --css=tailwind --javascript=esbuild
+cd my_solana_app
+```
+
+### 2. Add SolRengine to your Gemfile
+
+Once published to RubyGems, this will be just `gem "solrengine"`. During pre-release:
+
+```ruby
+gem "solrengine", github: "solrengine/solrengine", branch: "main"
+gem "solrengine-auth", github: "solrengine/auth", branch: "main"
+gem "solrengine-rpc", github: "solrengine/rpc", branch: "main"
+gem "solrengine-tokens", github: "solrengine/tokens", branch: "main"
+gem "solrengine-transactions", github: "solrengine/transactions", branch: "main"
+gem "solrengine-realtime", github: "solrengine/realtime", branch: "main"
+gem "solrengine-programs", github: "solrengine/programs", branch: "master"
+gem "dotenv-rails", group: [:development, :test]
+```
+
+### 3. Install
+
+```bash
+bundle install
+rails generate solrengine:install
+rails db:prepare
+yarn add @solana/kit @wallet-standard/app @solana/wallet-standard-features @rails/actioncable
+```
+
+### 4. Start
+
+```bash
+bin/dev
+```
+
+Visit `localhost:3000/auth/login` — connect your wallet and sign in.
+
+## What the Generator Does
+
+- Creates `User` model with wallet auth (SIWS)
+- Creates `Token` model with Jupiter metadata
+- Creates `Transfer` model with confirmation tracking
+- Sets up multi-database SQLite (primary, cache, queue, cable)
+- Configures Solid Queue, Solid Cache, and Solid Cable for development
+- Installs Stimulus wallet controller (Wallet Standard discovery)
+- Adds Tailwind sources for gem views
+- Creates `.env` template, `bin/solana_monitor`, and Procfile entries
+- Mounts auth engine at `/auth` (login, nonce, verify, logout)
+
+## What You Get
+
+| Gem | What |
+|-----|------|
+| [**solrengine-auth**](https://github.com/solrengine/auth) | SIWS wallet authentication (any Wallet Standard wallet) |
+| [**solrengine-rpc**](https://github.com/solrengine/rpc) | Solana JSON-RPC client with SSL fix and multi-network config |
+| [**solrengine-tokens**](https://github.com/solrengine/tokens) | Token metadata from Jupiter, USD prices, wallet portfolio |
+| [**solrengine-transactions**](https://github.com/solrengine/transactions) | SOL transfers with @solana/kit, confirmation tracking |
+| [**solrengine-realtime**](https://github.com/solrengine/realtime) | WebSocket account monitoring, Turbo Streams push updates |
+| [**solrengine-programs**](https://github.com/solrengine/programs) | Anchor IDL parsing, Borsh serialization, program account models, instruction builders |
+
+Each gem can be used independently or together via the `solrengine` meta-gem.
+
+## Custom Program Interaction
+
+Interact with any Anchor program by generating from its IDL:
+
+```bash
+rails generate solrengine:program PiggyBank path/to/piggy_bank.json
+```
+
+This scaffolds account models, instruction builders, and a Stimulus controller. See [solrengine-programs](https://github.com/solrengine/programs) for details.
+
+## Configuration
+
+The generator creates initializers automatically. Customize as needed:
+
+```ruby
+# config/initializers/solrengine_auth.rb
+Solrengine::Auth.configure do |config|
+  config.domain = ENV.fetch("APP_DOMAIN", "localhost")
+  config.nonce_ttl = 5.minutes
+  config.after_sign_in_path = "/dashboard"
+  config.after_sign_out_path = "/"
+end
+
+# config/initializers/solrengine_rpc.rb
+Solrengine::Rpc.configure do |config|
+  config.network = ENV.fetch("SOLANA_NETWORK", "mainnet")
+end
+```
+
+## Environment Variables
+
+The generator creates a `.env` file. Configure with your RPC URLs:
+
+```
+SOLANA_NETWORK=devnet
+SOLANA_RPC_URL=https://mainnet.helius-rpc.com/?api-key=xxx
+SOLANA_WS_URL=wss://mainnet.helius-rpc.com/?api-key=xxx
+SOLANA_RPC_DEVNET_URL=https://devnet.helius-rpc.com/?api-key=xxx
+SOLANA_WS_DEVNET_URL=wss://devnet.helius-rpc.com/?api-key=xxx
+APP_DOMAIN=myapp.com
+```
+
+Free RPC keys available at [helius.dev](https://helius.dev).
+
+## Building After Auth
+
+After sign-in, the app redirects to `/dashboard` (configurable). Create your own:
+
+```ruby
+# config/routes.rb
+root "dashboard#show"
+
+# app/controllers/dashboard_controller.rb
+class DashboardController < ApplicationController
+  before_action :authenticate!
+
+  def show
+    @wallet = current_user.wallet_address
+    @portfolio = Solrengine::Tokens::Portfolio.new(@wallet)
+    @tokens = @portfolio.tokens
+    @transactions = @portfolio.recent_transactions
+  end
+end
+```
+
+`current_user`, `logged_in?`, and `authenticate!` are added to your ApplicationController by the generator.
+
+## Processes
+
+`bin/dev` starts 5 processes via Procfile.dev:
+
+| Process | What |
+|---------|------|
+| web | Rails server (Puma) |
+| js | esbuild watch |
+| css | Tailwind watch |
+| jobs | Solid Queue worker |
+| ws | Solana WebSocket monitor |
+
+## Showcase
+
+- [**WalletTrain**](https://github.com/solrengine/wallet-train) — Solana wallet with token portfolio, SOL transfers, and real-time updates.
+- [**PiggyBank**](https://github.com/solrengine/piggybank) — Time-locked SOL savings using a custom Anchor program via `solrengine-programs`.
+
+## License
+
+MIT. A [Moviendome](https://moviendo.me) project.

data/lib/generators/solrengine/install_generator.rb

@@ -0,0 +1,146 @@
+class Solrengine::InstallGenerator < Rails::Generators::Base
+  source_root File.expand_path("templates", __dir__)
+
+  def run_sub_generators
+    generate "solrengine:auth:install"
+    generate "solrengine:tokens:install"
+    generate "solrengine:transactions:install"
+  end
+
+  def create_rpc_initializer
+    template "solrengine_rpc.rb", "config/initializers/solrengine_rpc.rb"
+  end
+
+  def create_realtime_initializer
+    template "solrengine_realtime.rb", "config/initializers/solrengine_realtime.rb"
+  end
+
+  def create_solana_monitor
+    template "solana_monitor", "bin/solana_monitor"
+    chmod "bin/solana_monitor", 0o755
+  end
+
+  def create_env_file
+    template "env", ".env" unless File.exist?(".env")
+  end
+
+  def setup_multi_database
+    template "database.yml", "config/database.yml", force: true
+  end
+
+  def setup_solid_queue_in_development
+    dev_rb = "config/environments/development.rb"
+    content = File.read(dev_rb)
+
+    unless content.include?("solid_queue")
+      inject_into_file dev_rb, after: "config.active_job.verbose_enqueue_logs = true\n" do
+        <<~RUBY
+
+          # SolRengine: Use Solid Queue for background jobs
+          config.active_job.queue_adapter = :solid_queue
+          config.solid_queue.connects_to = { database: { writing: :queue } }
+        RUBY
+      end
+    end
+
+    unless content.include?("solid_cache_store")
+      gsub_file dev_rb,
+        "config.cache_store = :memory_store",
+        "config.cache_store = :solid_cache_store"
+    end
+  end
+
+  def setup_solid_cable
+    template "cable.yml", "config/cable.yml", force: true
+  end
+
+  def setup_cache_yml
+    cache_yml = "config/cache.yml"
+    if File.exist?(cache_yml)
+      content = File.read(cache_yml)
+      unless content.include?("database: cache")
+        gsub_file cache_yml, "development:\n  <<: *default", "development:\n  database: cache\n  <<: *default"
+      end
+    end
+  end
+
+  def add_tailwind_gem_sources
+    css_file = "app/assets/stylesheets/application.tailwind.css"
+    return unless File.exist?(css_file)
+
+    content = File.read(css_file)
+    return if content.include?("solrengine")
+
+    # Find gem paths for Tailwind to scan
+    gem_paths = %w[solrengine-auth].filter_map do |gem_name|
+      spec = Gem.loaded_specs[gem_name] || Bundler.load.specs.find { |s| s.name == gem_name }
+      spec&.full_gem_path
+    end
+
+    return if gem_paths.empty?
+
+    source_lines = gem_paths.map { |p| "@source \"#{p}/app\";" }.join("\n")
+
+    append_to_file css_file, "\n/* SolRengine gem views */\n#{source_lines}\n"
+  end
+
+  def install_stimulus_controllers
+    # Copy wallet controller from gem into the app
+    auth_gem_path = %w[solrengine-auth].filter_map { |n|
+      spec = Gem.loaded_specs[n] || Bundler.load.specs.find { |s| s.name == n }
+      spec&.full_gem_path
+    }.first
+
+    if auth_gem_path
+      wallet_src = File.join(auth_gem_path, "app/assets/javascripts/solrengine/auth/wallet_controller.js")
+      if File.exist?(wallet_src)
+        copy_file wallet_src, "app/javascript/controllers/wallet_controller.js"
+      end
+    end
+
+    # Register in index.js
+    index_js = "app/javascript/controllers/index.js"
+    if File.exist?(index_js)
+      content = File.read(index_js)
+      unless content.include?("WalletController")
+        append_to_file index_js, <<~JS
+
+          import WalletController from "./wallet_controller"
+          application.register("wallet", WalletController)
+        JS
+      end
+    end
+  end
+
+  def fix_stylesheet_link
+    layout = "app/views/layouts/application.html.erb"
+    if File.exist?(layout)
+      content = File.read(layout)
+      if content.include?("stylesheet_link_tag :app")
+        gsub_file layout,
+          "stylesheet_link_tag :app",
+          'stylesheet_link_tag "application"'
+      end
+    end
+  end
+
+  def update_procfile
+    procfile = "Procfile.dev"
+    if File.exist?(procfile)
+      append_to_file procfile, "jobs: bin/jobs\n" unless File.read(procfile).include?("jobs:")
+      append_to_file procfile, "ws: bin/solana_monitor\n" unless File.read(procfile).include?("ws:")
+    end
+  end
+
+  def show_post_install
+    say "\n  SolRengine installed!", :green
+    say ""
+    say "  Next steps:"
+    say "    1. rails db:prepare"
+    say "    2. yarn add @solana/kit @wallet-standard/app @solana/wallet-standard-features @rails/actioncable"
+    say "    3. Configure .env with your RPC URLs"
+    say "    4. bin/dev"
+    say "    5. Visit /auth/login"
+    say ""
+  end
+end

data/lib/generators/solrengine/templates/cable.yml

@@ -0,0 +1,18 @@
+development:
+  adapter: solid_cable
+  connects_to:
+    database:
+      writing: cable
+  polling_interval: 0.1.seconds
+  message_retention: 1.hour
+
+test:
+  adapter: test
+
+production:
+  adapter: solid_cable
+  connects_to:
+    database:
+      writing: cable
+  polling_interval: 0.1.seconds
+  message_retention: 1.day

data/lib/generators/solrengine/templates/database.yml

@@ -0,0 +1,55 @@
+default: &default
+  adapter: sqlite3
+  pool: <%%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
+  timeout: 5000
+
+development:
+  primary:
+    <<: *default
+    database: storage/development.sqlite3
+  cache:
+    <<: *default
+    database: storage/development_cache.sqlite3
+    migrations_paths: db/cache_migrate
+  queue:
+    <<: *default
+    database: storage/development_queue.sqlite3
+    migrations_paths: db/queue_migrate
+  cable:
+    <<: *default
+    database: storage/development_cable.sqlite3
+    migrations_paths: db/cable_migrate
+
+test:
+  primary:
+    <<: *default
+    database: storage/test.sqlite3
+  cache:
+    <<: *default
+    database: storage/test_cache.sqlite3
+    migrations_paths: db/cache_migrate
+  queue:
+    <<: *default
+    database: storage/test_queue.sqlite3
+    migrations_paths: db/queue_migrate
+  cable:
+    <<: *default
+    database: storage/test_cable.sqlite3
+    migrations_paths: db/cable_migrate
+
+production:
+  primary:
+    <<: *default
+    database: storage/production.sqlite3
+  cache:
+    <<: *default
+    database: storage/production_cache.sqlite3
+    migrations_paths: db/cache_migrate
+  queue:
+    <<: *default
+    database: storage/production_queue.sqlite3
+    migrations_paths: db/queue_migrate
+  cable:
+    <<: *default
+    database: storage/production_cable.sqlite3
+    migrations_paths: db/cable_migrate

data/lib/generators/solrengine/templates/env

@@ -0,0 +1,11 @@
+# Solana Network (mainnet, devnet, testnet)
+SOLANA_NETWORK=devnet
+
+# RPC URLs (get free keys at helius.dev)
+# SOLANA_RPC_URL=https://mainnet.helius-rpc.com/?api-key=YOUR_KEY
+# SOLANA_WS_URL=wss://mainnet.helius-rpc.com/?api-key=YOUR_KEY
+# SOLANA_RPC_DEVNET_URL=https://devnet.helius-rpc.com/?api-key=YOUR_KEY
+# SOLANA_WS_DEVNET_URL=wss://devnet.helius-rpc.com/?api-key=YOUR_KEY
+
+# SIWS domain (your production domain)
+# APP_DOMAIN=myapp.com

data/lib/generators/solrengine/templates/solana_monitor

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+
+require_relative "../config/environment"
+
+config = Solrengine::Rpc.configuration
+puts "[SolanaMonitor] Starting on #{config.network}"
+puts "[SolanaMonitor] WS: #{config.ws_url.sub(/api-key=.*/, 'api-key=***')}"
+
+monitors = {}
+
+loop do
+  active_wallets = User.where("updated_at > ?", 1.hour.ago).pluck(:wallet_address)
+
+  active_wallets.each do |wallet|
+    next if monitors[wallet]
+
+    puts "[SolanaMonitor] Subscribing to #{wallet}"
+    monitor = Solrengine::Realtime::AccountMonitor.new(wallet)
+    Thread.new { monitor.start }
+    monitors[wallet] = monitor
+  end
+
+  monitors.each do |wallet, monitor|
+    unless active_wallets.include?(wallet)
+      puts "[SolanaMonitor] Unsubscribing from #{wallet}"
+      monitor.stop
+      monitors.delete(wallet)
+    end
+  end
+
+  sleep 30
+rescue => e
+  puts "[SolanaMonitor] Error: #{e.message}"
+  sleep 5
+end

data/lib/generators/solrengine/templates/solrengine_realtime.rb

@@ -0,0 +1,25 @@
+Solrengine::Realtime.on_account_change = ->(wallet_address) {
+  Rails.cache.delete("wallet/#{wallet_address}/tokens")
+  Rails.cache.delete("wallet/#{wallet_address}/recent_txs")
+
+  portfolio = Solrengine::Tokens::Portfolio.new(wallet_address)
+  stream = "wallet_#{wallet_address}"
+
+  Turbo::StreamsChannel.broadcast_replace_to(
+    stream, target: "portfolio_value",
+    partial: "dashboard/portfolio_value",
+    locals: { total_usd: portfolio.total_usd_value }
+  )
+
+  Turbo::StreamsChannel.broadcast_replace_to(
+    stream, target: "token_list",
+    partial: "dashboard/token_list",
+    locals: { tokens: portfolio.tokens }
+  )
+
+  Turbo::StreamsChannel.broadcast_replace_to(
+    stream, target: "recent_activity",
+    partial: "dashboard/recent_activity",
+    locals: { transactions: portfolio.recent_transactions, wallet_address: wallet_address }
+  )
+}

data/lib/generators/solrengine/templates/solrengine_rpc.rb

@@ -0,0 +1,3 @@
+Solrengine::Rpc.configure do |config|
+  config.network = ENV.fetch("SOLANA_NETWORK", "mainnet")
+end

data/lib/solrengine/version.rb

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

data/lib/solrengine.rb

@@ -0,0 +1,12 @@
+require_relative "solrengine/version"
+
+require "solrengine/rpc"
+require "solrengine/auth"
+require "solrengine/tokens"
+require "solrengine/transactions"
+require "solrengine/realtime"
+require "solrengine/programs"
+
+module Solrengine
+  class Error < StandardError; end
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: solrengine
+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: solrengine-auth
+  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-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: solrengine-tokens
+  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-transactions
+  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.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-programs
+  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'
+description: 'SolRengine gives Rails developers everything they need to build Solana
+  dapps: wallet authentication (SIWS), RPC client, token portfolio, SOL transfers,
+  and real-time WebSocket updates. One gem, full stack.'
+email:
+- estoy@moviendo.me
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/generators/solrengine/install_generator.rb
+- lib/generators/solrengine/templates/cable.yml
+- lib/generators/solrengine/templates/database.yml
+- lib/generators/solrengine/templates/env
+- lib/generators/solrengine/templates/solana_monitor
+- lib/generators/solrengine/templates/solrengine_realtime.rb
+- lib/generators/solrengine/templates/solrengine_rpc.rb
+- lib/solrengine.rb
+- lib/solrengine/version.rb
+homepage: https://github.com/solrengine/solrengine
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/solrengine/solrengine
+  source_code_uri: https://github.com/solrengine/solrengine
+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: The Rails framework for building Solana dapps
+test_files: []