virtualsms-sdk 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8ca4fddec9f37c3ce2a242a33f80c45737c12351af6e5a6d7d395f5b206e86be
+  data.tar.gz: 5697a72089b494b8208988f09f6c5b6878063b906ecab5f36825fbde6e4a215d
+SHA512:
+  metadata.gz: 83805c23e7d09896d3122a6157f53a0d656a634bfd0d4aed4e13441904bf7451a58e6012d024b19a5eb1312b54fa876f89d23cad86b25981560aae5f9ecd9a43
+  data.tar.gz: d6c331cc558204d238873e2c98f5ed5719845055f23ec7273bf3ea48c5c0de4b1d9c554ea9b3785eabc67ae4f9a8b81e3e7c0a4c256a00f74cc9ff85ebaef9f6

data/lib/virtualsms.rb

@@ -0,0 +1,96 @@
+require 'net/http'
+require 'uri'
+require 'json'
+
+# VirtualSMS Ruby SDK — SMS verification with real physical SIM cards.
+#
+# Unlike VoIP services, VirtualSMS uses real SIM cards in hardware modems
+# connected to European and US cellular networks. Near-100% delivery rates
+# on WhatsApp, Telegram, and platforms that block virtual numbers.
+#
+# Get your API key at https://virtualsms.io (Settings → API Keys)
+# API Docs: https://virtualsms.io/api
+# Pricing: https://virtualsms.io/pricing
+#
+# @example Quick start
+#   client = VirtualSMS.new('vsms_your_api_key')
+#   activation = client.get_number('wa', country: 22) # WhatsApp, UK
+#   code = client.wait_for_code(activation[:activation_id])
+#   puts "Code: #{code}"
+#   client.done(activation[:activation_id])
+class VirtualSMS
+  BASE_URL = 'https://virtualsms.io/stubs/handler_api.php'
+
+  class Error < StandardError; end
+  class NoNumbersError < Error; end
+
+  def initialize(api_key, base_url: BASE_URL)
+    @api_key = api_key
+    @base_url = base_url
+  end
+
+  # Get current account balance in USD.
+  def get_balance
+    result = request('getBalance')
+    raise Error, result unless result.start_with?('ACCESS_BALANCE:')
+    result.split(':')[1].to_f
+  end
+
+  # Request a phone number for SMS verification.
+  # @param service [String] Service code ('wa', 'tg', 'go', etc.)
+  # @param country [Integer] Country ID (187=US, 22=UK, 12=Germany)
+  def get_number(service, country: 187)
+    result = request('getNumber', service: service, country: country)
+    if result.start_with?('ACCESS_NUMBER:')
+      parts = result.split(':')
+      { activation_id: parts[1].to_i, phone: parts[2], service: service, country: country }
+    elsif result == 'NO_NUMBERS'
+      raise NoNumbersError, "No numbers for #{service} in country #{country}"
+    else
+      raise Error, result
+    end
+  end
+
+  # Check status of an activation.
+  def get_status(activation_id)
+    result = request('getStatus', id: activation_id)
+    case result
+    when 'STATUS_WAIT_CODE' then { status: 'waiting', code: nil }
+    when /^STATUS_OK:/ then { status: 'received', code: result.split(':')[1] }
+    when 'STATUS_CANCEL' then { status: 'cancelled', code: nil }
+    else { status: result, code: nil }
+    end
+  end
+
+  # Mark activation as done.
+  def done(activation_id)
+    request('setStatus', id: activation_id, status: 6)
+  end
+
+  # Cancel activation and get refund.
+  def cancel(activation_id)
+    request('setStatus', id: activation_id, status: 8)
+  end
+
+  # Wait for SMS code to arrive.
+  # @param timeout [Integer] Max wait in seconds (default: 300)
+  # @param poll_interval [Integer] Seconds between checks (default: 5)
+  def wait_for_code(activation_id, timeout: 300, poll_interval: 5)
+    start = Time.now
+    while Time.now - start < timeout
+      result = get_status(activation_id)
+      return result[:code] if result[:code]
+      return nil if result[:status] == 'cancelled'
+      sleep(poll_interval)
+    end
+    nil
+  end
+
+  private
+
+  def request(action, **params)
+    uri = URI(@base_url)
+    uri.query = URI.encode_www_form(params.merge(action: action, api_key: @api_key))
+    Net::HTTP.get(uri).strip
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: virtualsms-sdk
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- VirtualSMS
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-04-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: net-http
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.3'
+description: Ruby SDK for VirtualSMS — SMS verification using real physical SIM cards
+  in European and US mobile networks. Supports WhatsApp, Telegram, Google and 700+
+  services. Near-100% delivery rates. Crypto payments. API compatible with sms-activate
+  protocol.
+email: dev@virtualsms.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/virtualsms.rb
+homepage: https://virtualsms.io
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://virtualsms.io
+  source_code_uri: https://github.com/virtualsms-io/ruby-sdk
+  documentation_uri: https://virtualsms.io/api
+  changelog_uri: https://github.com/virtualsms-io/ruby-sdk/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/virtualsms-io/ruby-sdk/issues
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.5
+signing_key: 
+specification_version: 4
+summary: SMS verification with real physical SIM cards
+test_files: []