solana_ruby_wallet_adapter 0.1.1

data/lib/solana_wallet_adapter/wallets/walletconnect.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+# typed: strict
+
+module SolanaWalletAdapter
+  module Wallets
+    # WalletConnect adapter – connects via QR-code/deep-link protocol.
+    class WalletConnectWalletAdapter < BaseMessageSignerWalletAdapter
+      extend T::Sig
+
+      WALLETCONNECT_ICON = T.let(
+        "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMzAwIiBoZWlnaHQ9IjE4NSIgdmlld0JveD0iMCAwIDMwMCAxODUiIHhtbG5z" \
+        "PSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHBhdGggZD0iTTYxLjQzODUgMzYuMjU2MkMxMDkuMzQ4IC0x" \
+        "Mi4wODU0IDE4Ny4xNjkgLTEyLjA4NTQgMjM1LjA3OCAzNi4yNTYyTDI0MC44ODEgNDIuMTEyN0MyNDMuNDM2IDQ0" \
+        "LjY5MDcgMjQzLjQzNiA0OC44NjkzIDI0MC44ODEgNTEuNDQ3M0wyMjAuOTg3IDcxLjQ4NTVDMjE5LjcwOSA3Mi43" \
+        "NzQ1IDIxNy42NDQgNzIuNzc0NSAyMTYuMzY2IDcxLjQ4NTVMMjA4LjA2MSA2My4xMjg1QzE3NS40MDkgMzAuMzMw" \
+        "MyAxMjEuMTA4IDMwLjMzMDMgODguNDU2IDYzLjEyODVMNzkuNTc3IDcyLjA2NzFDNzguMjk5IDczLjM1NjEgNzYu" \
+        "MjMzOSA3My4zNTYxIDc0Ljk1NTkgNzIuMDY3MUw1NS4wNjIyIDUyLjAyODhDNTIuNTA3MyA0OS40NTA4IDUyLjUw" \
+        "NzMgNDUuMjcyMiA1NS4wNjIyIDQyLjY5NDJMNjEuNDM4NSAzNi4yNTYyWk0yNzYuNDQ3IDc3Ljk3NzJMMjk0LjIg" \
+        "OTUuODQ5MkMyOTYuNzU1IDk4LjQyNzIgMjk2Ljc1NSAxMDIuNjA2IDI5NC4yIDEwNS4xODRMMjEyLjE0NiAxODcu" \
+        "Njg5QzIwOS41OTEgMTkwLjI2NyAyMDUuNDYgMTkwLjI2NyAyMDIuOTA1IDE4Ny42ODlMMTQzLjIxMiAxMjcuODI2" \
+        "QzE0Mi41NzMgMTI3LjE4MiAxNDEuNTQgMTI3LjE4MiAxNDAuOTAxIDEyNy44MjZMODEuMjA4NiAxODcuNjg5Qzc4" \
+        "LjY1MzcgMTkwLjI2NyA3NC41MjMzIDE5MC4yNjcgNzEuOTY4NCAxODcuNjg5TDkuODU2NjkgMTA1LjE4NEM3LjMw" \
+        "MTc2IDEwMi42MDYgNy4zMDE3NiA5OC40MjcyIDkuODU2NjkgOTUuODQ5MkwyNy42MDUxIDc3Ljk3NzJDMzAuMTYg" \
+        "NzUuMzk5MiAzNC4yOTA0IDc1LjM5OTIgMzYuODQ1MyA3Ny45NzcyTDk2LjUzODUgMTM3Ljg0Qzk3LjE3NzMgMTM4" \
+        "LjQ4NCA5OC4yMTA2IDEzOC40ODQgOTguODQ5NCAxMzcuODRMMTU4LjU0MiA3Ny45NzcyQzE2MS4wOTcgNzUuMzk5" \
+        "MiAxNjUuMjI3IDc1LjM5OTIgMTY3Ljc4MiA3Ny45NzcyTDIyNy40NzUgMTM3Ljg0QzIyOC4xMTQgMTM4LjQ4NCAy" \
+        "MjkuMTQ3IDEzOC40ODQgMjI5Ljc4NiAxMzcuODRMMjg5LjQ3OSA3Ny45NzcyQzI5Mi4wMzQgNzUuMzk5MiAyOTYu" \
+        "MTY0IDc1LjM5OTIgMjk4LjcxOSA3Ny45NzcyWiIgZmlsbD0iIzM0OTZGRiIvPjwvc3ZnPg==",
+        String
+      )
+
+      sig { override.returns(String) }
+      def name = "WalletConnect"
+
+      sig { override.returns(String) }
+      def url = "https://walletconnect.com"
+
+      sig { override.returns(String) }
+      def icon = WALLETCONNECT_ICON
+
+      sig { override.returns(WalletReadyState) }
+      def ready_state = WalletReadyState::Loadable
+
+      sig { override.returns(T.nilable(PublicKey)) }
+      def public_key = nil
+
+      sig { override.returns(T::Boolean) }
+      def connecting? = false
+
+      sig { override.returns(SupportedTransactionVersions) }
+      def supported_transaction_versions
+        Set[TransactionVersion::Legacy].freeze
+      end
+
+      sig { override.void }
+      def connect
+        raise WalletNotReadyError, "#{name} connection is initiated in the browser via QR code"
+      end
+
+      sig { override.void }
+      def disconnect; end
+
+      sig do
+        override
+          .params(transaction: Transaction, rpc_url: String, options: SendTransactionOptions)
+          .returns(String)
+      end
+      def send_transaction(transaction, rpc_url, options = SendTransactionOptions.new)
+        raise WalletNotConnectedError, "send_transaction must use a pre-signed transaction server-side"
+      end
+
+      sig { override.params(transaction: Transaction).returns(Transaction) }
+      def sign_transaction(transaction)
+        raise WalletNotConnectedError, "sign_transaction must be performed client-side"
+      end
+
+      sig { override.params(transactions: T::Array[Transaction]).returns(T::Array[Transaction]) }
+      def sign_all_transactions(transactions)
+        raise WalletNotConnectedError, "sign_all_transactions must be performed client-side"
+      end
+
+      sig { override.params(message: String).returns(String) }
+      def sign_message(message)
+        raise WalletNotConnectedError, "sign_message must be performed client-side"
+      end
+    end
+  end
+end

data/sig/solana_wallet_adapter/adapter.rbi

@@ -0,0 +1,47 @@
+# typed: true
+
+module SolanaWalletAdapter
+  class BaseWalletAdapter
+    include EventEmitter
+
+    sig { abstract.returns(String) }
+    def name; end
+
+    sig { abstract.returns(String) }
+    def url; end
+
+    sig { abstract.returns(String) }
+    def icon; end
+
+    sig { abstract.returns(WalletReadyState) }
+    def ready_state; end
+
+    sig { abstract.returns(T.nilable(PublicKey)) }
+    def public_key; end
+
+    sig { abstract.returns(T::Boolean) }
+    def connecting?; end
+
+    sig { returns(SupportedTransactionVersions) }
+    def supported_transaction_versions; end
+
+    sig { abstract.void }
+    def connect; end
+
+    sig { abstract.void }
+    def disconnect; end
+
+    sig do
+      abstract
+        .params(transaction: Transaction, rpc_url: String, options: SendTransactionOptions)
+        .returns(String)
+    end
+    def send_transaction(transaction, rpc_url, options); end
+
+    sig { returns(T::Boolean) }
+    def connected?; end
+
+    sig { returns(T::Hash[String, T.untyped]) }
+    def to_h; end
+  end
+end

data/sig/solana_wallet_adapter/errors.rbi

@@ -0,0 +1,29 @@
+# typed: true
+
+module SolanaWalletAdapter
+  class WalletError < StandardError
+    sig { returns(T.nilable(Exception)) }
+    def cause_error; end
+
+    sig { params(message: T.nilable(String), cause_error: T.nilable(Exception)).void }
+    def initialize(message = nil, cause_error = nil); end
+  end
+
+  class WalletNotReadyError < WalletError; end
+  class WalletLoadError < WalletError; end
+  class WalletConfigError < WalletError; end
+  class WalletConnectionError < WalletError; end
+  class WalletDisconnectedError < WalletError; end
+  class WalletDisconnectionError < WalletError; end
+  class WalletAccountError < WalletError; end
+  class WalletPublicKeyError < WalletError; end
+  class WalletKeypairError < WalletError; end
+  class WalletNotConnectedError < WalletError; end
+  class WalletSendTransactionError < WalletError; end
+  class WalletSignTransactionError < WalletError; end
+  class WalletSignMessageError < WalletError; end
+  class WalletSignInError < WalletError; end
+  class WalletTimeoutError < WalletError; end
+  class WalletWindowBlockedError < WalletError; end
+  class WalletWindowClosedError < WalletError; end
+end

data/sig/solana_wallet_adapter/public_key.rbi

@@ -0,0 +1,25 @@
+# typed: true
+
+module SolanaWalletAdapter
+  class PublicKey
+    BYTE_LENGTH = T.let(32, Integer)
+
+    sig { returns(String) }
+    def bytes; end
+
+    sig { params(value: T.any(String, T::Array[Integer])).void }
+    def initialize(value); end
+
+    sig { returns(String) }
+    def to_base58; end
+
+    sig { returns(String) }
+    def to_s; end
+
+    sig { returns(T::Array[Integer]) }
+    def to_bytes; end
+
+    sig { params(other: PublicKey).returns(T::Boolean) }
+    def ==(other); end
+  end
+end

data/sorbet/config

@@ -0,0 +1,6 @@
+--dir
+lib
+--dir
+sig
+--ignore
+lib/solana_wallet_adapter/railtie.rb

metadata

@@ -0,0 +1,183 @@
+--- !ruby/object:Gem::Specification
+name: solana_ruby_wallet_adapter
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- pzupan
+bindir: bin
+cert_chain: []
+date: 2026-04-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sorbet-runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: ed25519
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: base58
+  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'
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+- !ruby/object:Gem::Dependency
+  name: sorbet
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: tapioca
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: rspec-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+description: |
+  A Ruby port of @solana/wallet-adapter. Provides typed wallet adapter
+  abstractions, server-side signature verification, Sign-In-With-Solana
+  (SIWS) helpers, and a wallet registry for Rails applications.
+email: []
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/solana_ruby_wallet_adapter.rb
+- lib/solana_wallet_adapter/adapter.rb
+- lib/solana_wallet_adapter/controller_helpers.rb
+- lib/solana_wallet_adapter/errors.rb
+- lib/solana_wallet_adapter/event_emitter.rb
+- lib/solana_wallet_adapter/message_signer_adapter.rb
+- lib/solana_wallet_adapter/network.rb
+- lib/solana_wallet_adapter/public_key.rb
+- lib/solana_wallet_adapter/railtie.rb
+- lib/solana_wallet_adapter/signature_verifier.rb
+- lib/solana_wallet_adapter/signer_adapter.rb
+- lib/solana_wallet_adapter/transaction.rb
+- lib/solana_wallet_adapter/version.rb
+- lib/solana_wallet_adapter/view_helpers.rb
+- lib/solana_wallet_adapter/wallet_ready_state.rb
+- lib/solana_wallet_adapter/wallet_registry.rb
+- lib/solana_wallet_adapter/wallets/coinbase.rb
+- lib/solana_wallet_adapter/wallets/ledger.rb
+- lib/solana_wallet_adapter/wallets/phantom.rb
+- lib/solana_wallet_adapter/wallets/solflare.rb
+- lib/solana_wallet_adapter/wallets/walletconnect.rb
+- sig/solana_wallet_adapter/adapter.rbi
+- sig/solana_wallet_adapter/errors.rbi
+- sig/solana_wallet_adapter/public_key.rbi
+- sorbet/config
+homepage: https://github.com/pzupan/solana-ruby-wallet-adapter
+licenses:
+- Apache-2.0
+metadata:
+  homepage_uri: https://github.com/pzupan/solana-ruby-wallet-adapter
+  source_code_uri: https://github.com/pzupan/solana-ruby-wallet-adapter
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Modular Solana wallet adapters for Ruby on Rails
+test_files: []