Rails meets Solana

# Gemfile
gem "solrengine-auth"

# routes.rb — mounts at /auth
mount Solrengine::Auth::Engine => "/auth"

# User model — wallet address as identity
class User < ApplicationRecord
  include Solrengine::Auth::Authenticatable
end

# Any controller — protect routes
class DashboardController < ApplicationController
  before_action :authenticate!
end

# Gemfile
gem "solrengine-rpc"

# Get wallet balance
client = Solrengine::Rpc.client
balance = client.get_balance("wallet_address")
# => 4.2 (SOL)

# Token accounts
tokens = client.get_token_accounts("wallet_address")
# => [{mint: "...", ui_amount: 100, decimals: 6}]

# Latest blockhash
blockhash = client.get_latest_blockhash
# => {blockhash: "...", last_valid_block_height: 123}

# Gemfile
gem "solrengine-transactions"

# Transfer model with status tracking
class Transfer < ApplicationRecord
  include Solrengine::Transactions::Transferable
end

# Status flow:
# pending → submitted → confirmed → finalized

# Background confirmation with exponential backoff
Solrengine::Transactions::ConfirmationJob
  .perform_later(transfer.id)

# Generate from Anchor IDL
$ rails generate solrengine:program PiggyBank config/idl/piggy_bank.json

# Account model — reads on-chain state
class PiggyBank::Lock < Solrengine::Programs::Account
  program_id "ZaU8j7X..."
  account_name "lock"

  borsh_field :dst, :pubkey
  borsh_field :expiration, :u64
end

# Query accounts from chain
locks = PiggyBank::Lock.for_wallet(current_user.wallet_address)