solrengine-sdp 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bb2f00e8f363ed1bacd78cf67bee25acbf50d1dd488b87fa00f8837512dd354b
-  data.tar.gz: 3ba656e022c2dfa6a866345d368e92767d085fa711b813cffa8035a3269c3c2b
+  metadata.gz: 6fac7a0ecbbf6a3c7f9c8f56f21079965c7b33dad55d2f0050223fab13952b39
+  data.tar.gz: cf05ff3fd6363eaab0739b031d7cd0d7de51775ca5b63b2462bc0b87edf6ed81
 SHA512:
-  metadata.gz: 2ea6942f560cf9bc6fe428fb8a86d60c2658ce01466ca48937454b48639de37477478d76662caae635f9b038176df739f850a9a78895f78513dce487228254b1
-  data.tar.gz: ee990fd2117b0acd96da2cd54953de35b215a7aa16459585e3b1e58b58f52ce3ecaae4417e075dc7195b18e36d607a05b982d67c05cf36ed726ca76b0195b6b8
+  metadata.gz: e9fee17c0180f8d2615e3b82179c3d18200b64a579ec041374633905d9d316dc30fa0faea741a55c98d996f336136f51d19aa545a45ec874a84a84267bb02b54
+  data.tar.gz: 9bcab7a570b2899a883dc4216802e480f5e2d8ee9c1008f31bbb0def8775de424e8aa8ad2251f634eb006faaed65e3c01c993d4ff208527e07ea4f3aa2d8e849

data/lib/generators/solrengine/sdp/templates/initializer.rb

@@ -19,6 +19,11 @@ Solrengine::Sdp.configure do |config|
   # the Rails application name.
   # config.label_namespace = "myapp"
 
+  # Default fiat ramp provider (e.g. "bvnk"). The ramps helper injects it so
+  # you don't repeat `provider:` on every call: Solrengine::Sdp.ramps.onramp_quote(...).
+  # Leave unset to pass `provider:` per call instead.
+  # config.ramp_provider = ENV["SDP_RAMP_PROVIDER"]
+
   # The wallet-owner model (the one including Solrengine::Sdp::WalletOwner).
   # Defaults to "User".
   # config.user_class = "Account"
@@ -42,3 +47,14 @@ Solrengine::Sdp.configure do |config|
   #     } }
   # ]
 end
+
+# Token issuance and fiat ramps (new in v0.2) need no extra config — reach them
+# through the client and the ramps helper:
+#
+#   Solrengine::Sdp.client.create_token(name: "...", symbol: "...", signing_wallet_id: "...")
+#   Solrengine::Sdp.client.mint_token(token_id, signing_wallet_id: "...", destination: "...", amount: "...")
+#   Solrengine::Sdp.ramps.onramp_quote(counterparty_id: "...", destination_wallet: "...",
+#                                      crypto_token: "SOL", fiat_currency: "USD", fiat_amount: "100")
+#
+# Ramps are SANDBOX-ONLY in v0.2 (preview). Mint/burn/deploy are money-path:
+# like transfers they need FEE_PAYMENT_PROVIDER=kora on a self-hosted SDP.

data/lib/solrengine/sdp/configuration.rb

@@ -15,7 +15,7 @@ module Solrengine
       DEFAULT_TRANSFER_POLL_INTERVAL = 3 # seconds — confirmation is usually seconds away
       DEFAULT_PROVISIONING_LEASE = 10 * 60 # seconds — see provisioning_lease below
 
-      attr_writer :api_key, :base_url, :custody_provider, :label_namespace, :logger
+      attr_writer :api_key, :base_url, :custody_provider, :ramp_provider, :label_namespace, :logger
       # provisioning_lease (seconds): how long a wallet-owner row may sit in
       # "provisioning" untouched before the claim is considered abandoned
       # (worker died between claim and settle) and another job may take it
@@ -50,6 +50,13 @@ module Solrengine
         @custody_provider || ENV["SDP_CUSTODY_PROVIDER"]
       end
 
+      # Default fiat ramp provider (e.g. "bvnk") for the ramps helper, so apps
+      # don't repeat `provider:` on every on/off-ramp call. nil is fine — the
+      # caller can pass `provider:` per call instead. Sandbox-only in v0.2.
+      def ramp_provider
+        @ramp_provider || ENV["SDP_RAMP_PROVIDER"]
+      end
+
       # Prefix for SDP wallet labels ("#{label_namespace}-user-#{id}").
       # Defaults to the Rails application name, else "app".
       def label_namespace

data/lib/solrengine/sdp/ramps.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Solrengine
+  module Sdp
+    # Thin engine wrapper over solana-sdp's ramps surface (SDP fiat on/off-ramps).
+    # Its only job is to default `provider:` from config.ramp_provider so apps
+    # don't repeat it on every call — the same convenience custody_provider gives
+    # wallet calls. Everything else passes straight through to the client; there
+    # is no model and no extra state.
+    #
+    # SANDBOX-ONLY in v0.2: wired against SDP's ramp surface and verified against
+    # the sandbox, not live fiat rails. Treat as preview.
+    class Ramps
+      # provider may be nil (no configured default) — then callers must pass
+      # `provider:` per call, and the client validates it.
+      def initialize(client:, provider: nil)
+        @client = client
+        @provider = provider
+      end
+
+      def onramp_currencies(**kwargs)
+        @client.onramp_currencies(**with_provider(kwargs))
+      end
+
+      def offramp_currencies(**kwargs)
+        @client.offramp_currencies(**with_provider(kwargs))
+      end
+
+      def onramp_quote(**kwargs)
+        @client.onramp_quote(**with_provider(kwargs))
+      end
+
+      def onramp_execute(**kwargs)
+        @client.onramp_execute(**with_provider(kwargs))
+      end
+
+      def offramp_execute(**kwargs)
+        @client.offramp_execute(**with_provider(kwargs))
+      end
+
+      # The sandbox event hook — no provider involved; pure passthrough.
+      def simulate_ramp(**payload)
+        @client.simulate_ramp(**payload)
+      end
+
+      private
+
+      # Inject the configured provider unless the caller named one explicitly
+      # (an explicit `provider: nil` is honored — it means "don't scope").
+      def with_provider(kwargs)
+        return kwargs if kwargs.key?(:provider) || @provider.nil?
+
+        kwargs.merge(provider: @provider)
+      end
+    end
+  end
+end

data/lib/solrengine/sdp/version.rb

@@ -2,10 +2,10 @@
 
 module Solrengine
   module Sdp
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
 
     # The SDP release this engine version is tested against. SDP breaks its
     # API between minors; bump this (and re-verify) on every SDP upgrade.
-    COMPATIBLE_SDP_VERSION = "0.28"
+    COMPATIBLE_SDP_VERSION = "0.31"
   end
 end

data/lib/solrengine/sdp.rb

@@ -10,6 +10,7 @@ require_relative "sdp/configuration"
 require_relative "sdp/wallet_owner"
 require_relative "sdp/broadcaster"
 require_relative "sdp/faucet"
+require_relative "sdp/ramps"
 require_relative "sdp/engine" if defined?(Rails::Engine)
 
 module Solrengine
@@ -33,6 +34,7 @@ module Solrengine
       def configure
         yield(configuration)
         @client = nil
+        @ramps = nil
         configuration
       end
 
@@ -41,13 +43,22 @@ module Solrengine
       def client
         @client ||= ::Sdp::Client.new(
           api_key: configuration.validate!.api_key,
-          base_url: configuration.base_url
+          base_url: configuration.base_url,
+          custody_provider: configuration.custody_provider
         )
       end
 
+      # Thin ramps helper bound to the configured client + default ramp
+      # provider. Reset alongside the client whenever configure runs.
+      # Sandbox-only in v0.2 (see Solrengine::Sdp::Ramps).
+      def ramps
+        @ramps ||= Ramps.new(client: client, provider: configuration.ramp_provider)
+      end
+
       def reset_configuration!
         @configuration = nil
         @client = nil
+        @ramps = nil
       end
 
       # Pure function over rake task names so the exemption logic is

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solrengine-sdp
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Jose Ferrer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-13 00:00:00.000000000 Z
+date: 2026-06-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -30,14 +30,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.1'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: solrengine-realtime
   requirement: !ruby/object:Gem::Requirement
@@ -79,6 +79,7 @@ files:
 - lib/solrengine/sdp/engine.rb
 - lib/solrengine/sdp/errors.rb
 - lib/solrengine/sdp/faucet.rb
+- lib/solrengine/sdp/ramps.rb
 - lib/solrengine/sdp/version.rb
 - lib/solrengine/sdp/wallet_owner.rb
 homepage: https://github.com/solrengine/sdp