bsv-wallet-postgres 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 69980501d8a03bd6552190800aba40a65f3c34d2b6633a3a59d58030a11d54e3
-  data.tar.gz: 7ee7f4c26fc294d9f227cdae83e3c9d9dcc7cce64592dda289db8c223c6b34ec
+  metadata.gz: 8c61ec2b4c48854fcba55eeb47bb1d7b3e87129fbf01769e07fc6c30661d1a26
+  data.tar.gz: 58f953f0a5d5fb10fb20259d821dc604ba842f8210f53d6f55be12e760ed927c
 SHA512:
-  metadata.gz: 5fa70d4686c6f55d782578f9f7c2b6bb290c113ebdd2a8e05a11d8062e56ba21337a2ce3bf8d96af32a13ac60d05d8328f6608d560f6b2dce3b1514045f6b1ef
-  data.tar.gz: 371d0d3ccc53cf8c247aed4fa449a232b0a9f3ce46e8c7ebfbc311f5f23eae7043a186e0678c14fe5f3693ced12e3458965d3a93e471fcdbc2f46a1661961eac
+  metadata.gz: 5b51ceb9562b914012b2a86ee1c236501f9f714583a55d46a977e6418f0cf490497d7a42349210a0e0ee1436179617d45ded1afca815f0770d563aad8bf4051a
+  data.tar.gz: 6f219ead476cf621c654e9692f955962f96f55d02b900bb03f2adfe1549b331abd714036e4af7ef32f1c322e72c452a64ebebdcda46cedc9fc239e601cc0bf5f

data/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to the `bsv-wallet-postgres` gem are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 and this gem adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 0.6.0 — 2026-04-21
+
+### Added
+- `update_output_basket` implementation on `PostgresStore`, matching the new Store interface method
+
+### Changed
+- Updated for bsv-wallet 0.10.0 namespace changes (`Interface`, `Client`, `Store`)
+
+## 0.5.0 — 2026-04-16
+
+### Changed — **Breaking**
+
+- `SolidQueueAdapter` now sets the wallet action status to `'unproven'` instead of `'completed'` on successful broadcast. Aligns with the status taxonomy change in bsv-wallet 0.9.0 (HLR #455). The `wallet_broadcast_jobs` row status is unchanged (job queue lifecycle is a separate domain).
+
+### Added
+
+- `BroadcastQueue#broadcast_enabled?` interface method; `SolidQueueAdapter` returns `true` (broadcaster required at construction time). Enables `WalletClient#broadcast_enabled?` to detect a queue-embedded broadcaster.
+
+### Changed
+
+- Minimum `bsv-wallet` version raised from `>= 0.6.0` to `>= 0.9.0`. Required for the new status taxonomy and `broadcast_enabled?` interface.
+
 ## 0.4.0 — 2026-04-12
 
 ### Added

data/lib/bsv/wallet_postgres/migrations/001_create_wallet_tables.rb

@@ -2,7 +2,7 @@
 
 # Initial wallet schema for BSV::Wallet::PostgresStore.
 #
-# Five tables, all indexed for the query patterns the StorageAdapter
+# Five tables, all indexed for the query patterns the Store
 # interface exposes. JSONB blobs hold the full hash the SDK stored so
 # adding fields to bsv-wallet's output/action/certificate records does
 # not require a schema change — only the fields we actively filter on

data/lib/bsv/wallet_postgres/postgres_store.rb

@@ -8,7 +8,7 @@ module BSV
   module Wallet
     # PostgreSQL-backed storage adapter for +BSV::Wallet+.
     #
-    # Implements the full {StorageAdapter} interface against a Sequel
+    # Implements the full {Store} interface against a Sequel
     # +Database+ object. Survives process restarts, scales to multiple
     # instances, and is thread-safe via Sequel's connection pool.
     #
@@ -19,7 +19,7 @@ module BSV
     #   BSV::Wallet::PostgresStore.migrate!(db)
     #
     #   store  = BSV::Wallet::PostgresStore.new(db)
-    #   wallet = BSV::Wallet::WalletClient.new(key, storage: store)
+    #   wallet = BSV::Wallet::Client.new(key, storage: store)
     #
     # @example Bringing your own migration runner
     #   # Copy lib/bsv/wallet_postgres/migrations/001_create_wallet_tables.rb
@@ -44,7 +44,7 @@ module BSV
     # * This class is thread-safe because Sequel is — the adapter itself
     #   holds no mutable state beyond the injected database handle.
     class PostgresStore
-      include StorageAdapter
+      include Interface::Store
 
       MIGRATIONS_DIR = File.expand_path('migrations', __dir__)
 
@@ -236,6 +236,26 @@ module BSV
         symbolise_keys(row[:data])
       end
 
+      # Moves an output from one basket to another (metadata-only).
+      #
+      # Updates both the +basket+ column and the JSONB +data+ blob.
+      # Does not affect the output's state or pending metadata.
+      #
+      # @param outpoint [String] the outpoint identifier
+      # @param new_basket [String] the destination basket name
+      # @raise [BSV::Wallet::WalletError] if the outpoint is not found
+      # @return [Hash] the updated output hash
+      def update_output_basket(outpoint, new_basket)
+        ds = @db[:wallet_outputs].where(outpoint: outpoint)
+        rows_updated = ds.update(
+          basket: new_basket,
+          data: Sequel.lit("data || jsonb_build_object('basket', ?)", new_basket)
+        )
+        raise WalletError, "Output not found: #{outpoint}" if rows_updated.zero?
+
+        symbolise_keys(ds.first[:data])
+      end
+
       # Atomically marks a set of outpoints as +:pending+.
       #
       # Uses +UPDATE ... WHERE state = 'spendable' ... RETURNING outpoint+ so that

data/lib/bsv/wallet_postgres/solid_queue_adapter.rb

@@ -38,7 +38,7 @@ module BSV
     # +@running = false+ but before the worker thread exits will remain
     # +unsent+ until the next +start+.
     class SolidQueueAdapter
-      include BSV::Wallet::BroadcastQueue
+      include BSV::Wallet::Interface::BroadcastQueue
 
       # Default number of seconds between poll cycles.
       DEFAULT_POLL_INTERVAL = 8
@@ -52,14 +52,14 @@ module BSV
       MAX_ATTEMPTS = 5
 
       # @param db [Sequel::Database] a Sequel database handle (shared with PostgresStore)
-      # @param storage [StorageAdapter] wallet storage adapter (must not be MemoryStore)
+      # @param storage [Store] wallet storage adapter (must not be MemoryStore)
       # @param broadcaster [#broadcast] broadcaster object
       # @param poll_interval [Integer] seconds between worker poll cycles
       # @param stale_threshold [Integer] seconds before a +sending+ job is retried
-      # @raise [ArgumentError] if +storage+ is a +BSV::Wallet::MemoryStore+
+      # @raise [ArgumentError] if +storage+ is a +BSV::Wallet::Store::Memory+
       # @raise [ArgumentError] if +broadcaster+ is +nil+
       def initialize(db:, storage:, broadcaster:, poll_interval: DEFAULT_POLL_INTERVAL, stale_threshold: STALE_THRESHOLD)
-        if storage.is_a?(BSV::Wallet::MemoryStore)
+        if storage.is_a?(BSV::Wallet::Store::Memory)
           raise ArgumentError, 'SolidQueueAdapter requires a persistent storage adapter — MemoryStore is not supported'
         end
         raise ArgumentError, 'SolidQueueAdapter requires a broadcaster' if broadcaster.nil?
@@ -82,6 +82,15 @@ module BSV
         true
       end
 
+      # Returns +true+ — +SolidQueueAdapter+ requires a broadcaster at
+      # construction time (+ArgumentError+ is raised if +nil+ is passed), so
+      # broadcast is always available.
+      #
+      # @return [Boolean]
+      def broadcast_enabled?
+        !@broadcaster.nil?
+      end
+
       # Persists a transaction to the broadcast job queue and returns immediately.
       #
       # Inserts a row into +wallet_broadcast_jobs+ with status +unsent+. If a row
@@ -280,8 +289,10 @@ module BSV
       # Promotes UTXO state after a successful broadcast.
       #
       # Marks inputs as +:spent+, change as +:spendable+, and updates the action
-      # status to +completed+. When outpoints are +nil+ (finalize path), UTXO
-      # transitions are skipped.
+      # status to +unproven+. The transaction has been accepted by the network but
+      # is not yet proven on-chain — status advances to +completed+ once a merkle
+      # proof arrives. When outpoints are +nil+ (finalize path), UTXO transitions
+      # are skipped.
       #
       # @param input_outpoints [Array<String>, nil]
       # @param change_outpoints [Array<String>, nil]
@@ -289,7 +300,7 @@ module BSV
       def promote(input_outpoints, change_outpoints, txid)
         Array(input_outpoints).each { |op| @storage.update_output_state(op, :spent) }
         Array(change_outpoints).each { |op| @storage.update_output_state(op, :spendable) }
-        @storage.update_action_status(txid, 'completed') if txid
+        @storage.update_action_status(txid, 'unproven') if txid
       end
 
       # Rolls back wallet state after a failed broadcast.

data/lib/bsv/wallet_postgres/version.rb

@@ -2,6 +2,6 @@
 
 module BSV
   module WalletPostgres
-    VERSION = '0.4.0'
+    VERSION = '0.6.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bsv-wallet-postgres
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Simon Bettison
@@ -15,7 +15,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 0.9.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
@@ -25,7 +25,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 0.9.0
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'