bsv-sdk 0.9.0 → 0.10.0

data/lib/bsv/script/interpreter/operations/splice.rb

@@ -80,6 +80,55 @@ module BSV
             data = @dstack.pop_bytes
             @dstack.push_bytes(ScriptNumber.minimally_encode(data))
           end
+
+          # OP_SUBSTR: extract a substring by offset and length
+          # Stack: [... data offset len] -> [... data[offset, len]]
+          def op_substr
+            len    = @dstack.pop_int.to_i32
+            offset = @dstack.pop_int.to_i32
+            data   = @dstack.pop_bytes
+
+            unless offset >= 0 && offset < data.bytesize && len >= 0 && len <= data.bytesize - offset
+              raise ScriptError.new(
+                ScriptErrorCode::INVALID_INPUT_LENGTH,
+                "invalid OP_SUBSTR range: offset=#{offset} len=#{len} for data of length #{data.bytesize}"
+              )
+            end
+
+            @dstack.push_bytes(data.byteslice(offset, len))
+          end
+
+          # OP_LEFT: extract the leftmost N bytes
+          # Stack: [... data len] -> [... data[0, len]]
+          def op_left
+            len  = @dstack.pop_int.to_i32
+            data = @dstack.pop_bytes
+
+            unless len.between?(0, data.bytesize)
+              raise ScriptError.new(
+                ScriptErrorCode::INVALID_INPUT_LENGTH,
+                "invalid OP_LEFT length: #{len} for data of length #{data.bytesize}"
+              )
+            end
+
+            @dstack.push_bytes(data.byteslice(0, len))
+          end
+
+          # OP_RIGHT: extract the rightmost N bytes
+          # Stack: [... data len] -> [... data[size-len, len]]
+          def op_right
+            len  = @dstack.pop_int.to_i32
+            data = @dstack.pop_bytes
+
+            unless len.between?(0, data.bytesize)
+              raise ScriptError.new(
+                ScriptErrorCode::INVALID_INPUT_LENGTH,
+                "invalid OP_RIGHT length: #{len} for data of length #{data.bytesize}"
+              )
+            end
+
+            @dstack.push_bytes(data.byteslice(data.bytesize - len, len))
+          end
         end
       end
     end

data/lib/bsv/script/opcodes.rb

@@ -130,9 +130,8 @@ module BSV
       OP_CHECKLOCKTIMEVERIFY = 0xb1
       OP_CHECKSEQUENCEVERIFY = 0xb2
 
-      # Chronicle slots (0xb3–0xb7): reserved for future string/shift opcodes.
-      # Full semantics are deferred to SDK v0.10. Scripts using these opcodes
-      # will raise ScriptErrorCode::UNIMPLEMENTED_OPCODE at execution time.
+      # Chronicle slots (0xb3–0xb7): string-splice and numeric-shift opcodes
+      # re-enabled in BSV Chronicle. Fully implemented in the interpreter.
       OP_SUBSTR         = 0xb3
       OP_LEFT           = 0xb4
       OP_RIGHT          = 0xb5

data/lib/bsv/transaction/chain_trackers/chaintracks.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'uri'
+
+module BSV
+  module Transaction
+    module ChainTrackers
+      # Chain tracker that verifies merkle roots using the Chaintracks API (Arcade/GorillaPool).
+      #
+      # Queries the Chaintracks v2 block header endpoint to retrieve the merkle root for a
+      # given block height and compares it with the provided root.
+      #
+      # @example
+      #   tracker = BSV::Transaction::ChainTrackers::Chaintracks.new
+      #   tracker.valid_root_for_height?('abcd...', 800_000)
+      #
+      # @example With API key
+      #   tracker = BSV::Transaction::ChainTrackers::Chaintracks.new(api_key: 'my-key')
+      #   tracker.current_height
+      class Chaintracks < ChainTracker
+        MAINNET_URL = 'https://arcade.gorillapool.io'
+        TESTNET_URL = 'https://testnet.arcade.gorillapool.io'
+
+        # @param url [String] base URL for the Chaintracks API
+        # @param api_key [String, nil] optional Bearer API key
+        # @param http_client [#request, nil] injectable HTTP client for testing
+        def initialize(url: MAINNET_URL, api_key: nil, http_client: nil)
+          super()
+          @url = url.chomp('/')
+          @api_key = api_key
+          @http_client = http_client
+        end
+
+        # Verify that a merkle root is valid for the given block height.
+        #
+        # @param root [String] merkle root as a hex string
+        # @param height [Integer] block height
+        # @return [Boolean]
+        def valid_root_for_height?(root, height)
+          response = get("/chaintracks/v2/header/height/#{height}")
+          return false if response.nil?
+
+          data = JSON.parse(response.body)
+          merkle_root = data['merkleRoot']
+          return false unless merkle_root
+
+          merkle_root.downcase == root.downcase
+        end
+
+        # Return the current blockchain height.
+        #
+        # @return [Integer]
+        def current_height
+          response = get('/chaintracks/v2/tip', not_found_returns_nil: false)
+          data = JSON.parse(response.body)
+          data['height']
+        end
+
+        private
+
+        # @param path [String] API path
+        # @param not_found_returns_nil [Boolean] if true, return nil on 404 instead of raising
+        # @return [Net::HTTPResponse, nil]
+        def get(path, not_found_returns_nil: true)
+          uri = URI("#{@url}#{path}")
+          request = Net::HTTP::Get.new(uri)
+          request['Authorization'] = "Bearer #{@api_key}" if @api_key
+
+          response = execute(uri, request)
+          code = response.code.to_i
+
+          return nil if not_found_returns_nil && code == 404
+          return response if (200..299).cover?(code)
+
+          raise BSV::Network::ChainProviderError.new(
+            response.body || "HTTP #{code}",
+            status_code: code
+          )
+        end
+
+        def execute(uri, request)
+          if @http_client
+            @http_client.request(uri, request)
+          else
+            Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
+              http.request(request)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bsv/transaction/chain_trackers.rb

@@ -5,6 +5,17 @@ module BSV
     # Namespace for chain tracker implementations.
     module ChainTrackers
       autoload :WhatsOnChain, 'bsv/transaction/chain_trackers/whats_on_chain'
+      autoload :Chaintracks,  'bsv/transaction/chain_trackers/chaintracks'
+
+      # Return a default chain tracker backed by the Arcade/GorillaPool Chaintracks API.
+      #
+      # @param testnet [Boolean] use the testnet endpoint when true
+      # @param api_key [String, nil] optional Bearer API key
+      # @return [Chaintracks]
+      def self.default(testnet: false, api_key: nil)
+        url = testnet ? Chaintracks::TESTNET_URL : Chaintracks::MAINNET_URL
+        Chaintracks.new(url: url, api_key: api_key)
+      end
     end
   end
 end

data/lib/bsv/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BSV
-  VERSION = '0.9.0'
+  VERSION = '0.10.0'
 end

data/lib/bsv-sdk.rb

@@ -12,4 +12,5 @@ module BSV
   autoload :Overlay,     'bsv/overlay'
   autoload :Identity,    'bsv/identity'
   autoload :Registry,    'bsv/registry'
+  autoload :MCP,         'bsv/mcp'
 end

metadata

@@ -1,23 +1,39 @@
 --- !ruby/object:Gem::Specification
 name: bsv-sdk
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Simon Bettison
 bindir: bin
 cert_chain: []
-date: 2026-04-10 00:00:00.000000000 Z
-dependencies: []
+date: 2026-04-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mcp
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.12'
 description: A Ruby library for interacting with the BSV Blockchain — keys, scripts,
   transactions, and more.
-executables: []
+executables:
+- bsv-mcp
 extensions: []
 extra_rdoc_files: []
 files:
-- CHANGELOG-sdk.md
+- CHANGELOG.md
 - LICENSE
 - README.md
+- bin/bsv-mcp
 - lib/bsv-sdk.rb
 - lib/bsv/auth.rb
 - lib/bsv/auth/auth_error.rb
@@ -31,6 +47,16 @@ files:
 - lib/bsv/identity/constants.rb
 - lib/bsv/identity/identity_parser.rb
 - lib/bsv/identity/types.rb
+- lib/bsv/mcp.rb
+- lib/bsv/mcp/config.rb
+- lib/bsv/mcp/server.rb
+- lib/bsv/mcp/tools/broadcast_p2pkh.rb
+- lib/bsv/mcp/tools/check_balance.rb
+- lib/bsv/mcp/tools/decode_tx.rb
+- lib/bsv/mcp/tools/fetch_tx.rb
+- lib/bsv/mcp/tools/fetch_utxos.rb
+- lib/bsv/mcp/tools/generate_key.rb
+- lib/bsv/mcp/tools/helpers.rb
 - lib/bsv/network.rb
 - lib/bsv/network/arc.rb
 - lib/bsv/network/broadcast_error.rb
@@ -97,6 +123,7 @@ files:
 - lib/bsv/transaction/beef.rb
 - lib/bsv/transaction/chain_tracker.rb
 - lib/bsv/transaction/chain_trackers.rb
+- lib/bsv/transaction/chain_trackers/chaintracks.rb
 - lib/bsv/transaction/chain_trackers/whats_on_chain.rb
 - lib/bsv/transaction/fee_model.rb
 - lib/bsv/transaction/fee_models.rb
@@ -121,7 +148,7 @@ licenses:
 metadata:
   homepage_uri: https://github.com/sgbett/bsv-ruby-sdk
   source_code_uri: https://github.com/sgbett/bsv-ruby-sdk
-  changelog_uri: https://github.com/sgbett/bsv-ruby-sdk/blob/master/CHANGELOG-sdk.md
+  changelog_uri: https://github.com/sgbett/bsv-ruby-sdk/blob/master/gem/bsv-sdk/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: