confium 0.4.1 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a46dd7e9a6967adabafbf136b1d8397b30dd6b62cf391bc65a3cbfbdb40aa974
-  data.tar.gz: 4644e733341fedcdb25860ba0a11f158307f379067e1455415c6ca2f7fbb9cb5
+  metadata.gz: d09c11dbd19d2df0b80cac44a48013395a7d96a1430506be1b1dc42b0b3831a3
+  data.tar.gz: c15b846b399f57a4a36fe808a8e98e3e224ec3873690a81e43f7c281134b5918
 SHA512:
-  metadata.gz: a11f941a43c841a1af5e64cd0529faf177fdcb30908843b5458ac75fa92ea9c48ab2ecf351f674d90e809f1b21af2c8c039a4c6263b6a916ad166dd7b28be7ce
-  data.tar.gz: 2b6ef5346cf0edd3c956b99908f4d581589da7a4c0aad6dafbaf019482df392294acd7ae58ab54781dda6824b2f77858b93c7333f9a31432226c1725dd2fa4eb
+  metadata.gz: 568abf025728f288d453c8f315930665f3fabb77abc1484e743c7539fd36c45813c721c970202f40a90e4e34969313a28adca521b5a38cd62a01984743b92a74
+  data.tar.gz: 59877e7dc1b834e49e7f9c5b5a25e1a87bcd888f50a15bdc3917f6024685c168bc87feb4d30bc3f5f9cb37b232a3b141652d9e07b0501f9c2e110205486e7b3c

data/CHANGELOG.md

@@ -1,5 +1,42 @@
 # Changelog
 
+## [0.5.0] — 2026-08-24
+
+### Added
+
+- **Ruby 4.0 support** — Windows ships an exact `4.0` ABI window;
+  every platform install-checks on Ruby 4.0; the test matrix gains
+  4.0 legs. (There is no Ruby 3.5 — 4.0 is the successor line.)
+- **Multi-host threshold signing**: `Confium::TC::NetworkCoordinator`
+  (TCP service, NDJSON + hex wire protocol) + `Confium::TC::SignerClient`
+  — signers on separate machines submit commitments and shares;
+  aggregation runs the real CMP20/GG18 combine and returns an
+  OpenSSL-verifiable signature. Plain TCP for loopback/private
+  networks; the upstream noise transport replaces it later.
+- **OpenTelemetry export**: `Confium::Audit::OtlpSink` ships every
+  audit record to an OTLP collector over OTLP/HTTP JSON (logs
+  signal, stdlib-only, failures drop-and-report).
+- `Confium::Composite::Signature#to_json` — instances remember their
+  source (components or a canonical JSON document) and re-serialize
+  losslessly, completing the JSON transport symmetry.
+
+### Fixed
+
+- `Confium::TC::Coordinator` now aggregates REAL threshold-ECDSA
+  signatures: once the threshold is met, it runs the CMP20 or GG18
+  combine (selected per session via `scheme:`) and returns a 64-byte
+  signature verifiable under the quorum public key. Previously
+  `aggregate` concatenated the share bytes — a placeholder that
+  returned garbage. Unknown sessions below-threshold now raise
+  `Confium::ThresholdError`.
+- `Confium::TC::Coordinator` and `ShareFile` were unreachable after
+  `require "confium"`: the TC namespace file that registers them
+  never loaded because the native extension pre-defines
+  `Confium::TC` (the same orphaned-module trap PKI had). The
+  namespace file is now eager-required; `TC::Session` stays lazy —
+  it wraps the engine via FFI and needs the external libconfium
+  dylib.
+
 ## [0.4.1] — 2026-08-24
 
 ### Fixed

data/lib/confium/audit/otlp_sink.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require 'net/http'
+require 'json'
+require 'time'
+
+module Confium
+  module Audit
+    # Exports audit records to an OpenTelemetry Collector over
+    # OTLP/HTTP JSON (the logs signal — an audit event is a log
+    # record, not a span).
+    #
+    #   Confium::Audit.sink = Confium::Audit::OtlpSink.new(
+    #     endpoint: 'http://localhost:4318/v1/logs',
+    #     headers: { 'Authorization' => "Bearer #{token}" },
+    #     service_name: 'confium-issuer'
+    #   )
+    #
+    # Delivery is synchronous per record; failures are reported on
+    # $stderr and the record is dropped (the audit core's policy — a
+    # telemetry outage must never break signing). stdlib only.
+    class OtlpSink < Sink
+      DEFAULT_ENDPOINT = 'http://localhost:4318/v1/logs'
+      SEVERITY = { 'success' => 9, 'failure' => 17, 'error' => 17 }.freeze # INFO / ERROR
+
+      def initialize(endpoint: DEFAULT_ENDPOINT, headers: {}, service_name: 'confium', timeout: 5)
+        super()
+        @uri = URI.parse(endpoint)
+        @headers = headers
+        @service_name = service_name
+        @timeout = timeout
+        @dropped = 0
+      end
+
+      # Records dropped after failed delivery (diagnostic only).
+      attr_reader :dropped
+
+      def write(record)
+        payload = envelope(record)
+        response = Net::HTTP.post(@uri, JSON.generate(payload), headers.merge('Content-Type' => 'application/json'))
+        raise "collector responded #{response.code}" unless response.is_a?(Net::HTTPSuccess)
+      rescue StandardError => e
+        @dropped += 1
+        warn "confium: OTLP delivery failed, audit record dropped (##{@dropped}): #{e.class}: #{e.message}"
+      end
+
+      def close; end
+
+      private
+
+      def headers
+        { 'User-Agent' => "confium-otlp-sink #{Confium::VERSION}" }.merge(@headers)
+      end
+
+      # OTLP/JSON logs request: one resource, one scope, one record.
+      def envelope(record)
+        {
+          'resourceLogs' => [
+            {
+              'resource' => {
+                'attributes' => [
+                  { 'key' => 'service.name', 'value' => { 'stringValue' => @service_name } },
+                  { 'key' => 'telemetry.sdk.name', 'value' => { 'stringValue' => 'confium' } },
+                  { 'key' => 'telemetry.sdk.version', 'value' => { 'stringValue' => Confium::VERSION } }
+                ]
+              },
+              'scopeLogs' => [
+                {
+                  'scope' => { 'name' => 'confium.audit' },
+                  'logRecords' => [log_record(record)]
+                }
+              ]
+            }
+          ]
+        }
+      end
+
+      def log_record(record)
+        {
+          'timeUnixNano' => (parse_time(record['timestamp']) * 1_000_000_000).to_i.to_s,
+          'severityNumber' => SEVERITY.fetch(record['result'], 9),
+          'severityText' => record['result'] == 'success' ? 'INFO' : 'ERROR',
+          'body' => { 'stringValue' => "#{record['operation']} #{record['result']}".strip },
+          'attributes' => attributes_for(record)
+        }
+      end
+
+      def attributes_for(record)
+        record.except('timestamp').map do |key, value|
+          { 'key' => key, 'value' => { 'stringValue' => value.to_s } }
+        end
+      end
+
+      def parse_time(timestamp)
+        return Time.now.to_f unless timestamp.is_a?(String)
+
+        Time.parse(timestamp).to_f
+      rescue ArgumentError
+        Time.now.to_f
+      end
+    end
+  end
+end

data/lib/confium/audit.rb

@@ -124,3 +124,5 @@ module Confium
     end
   end
 end
+
+require_relative 'audit/otlp_sink'

data/lib/confium/composite.rb

@@ -16,6 +16,32 @@ module Confium
     class Signature
       BINARY_FIELDS = %w[public_key signature].freeze
 
+      # Serialize the components this instance was built from, in the
+      # canonical wire format. Instances remember their source: built
+      # from components, or from a JSON document (which is emitted
+      # verbatim when it was canonical).
+      def to_json(*_args)
+        cached = @confium_components_json
+        return cached if cached
+
+        components = @confium_components or
+          raise Confium::Error, 'Signature was not built with component data; use Signature.new or from_json'
+        Signature.components_to_json(components)
+      end
+
+      class << self
+        # magnus exposes the constructor as a class-level `new`;
+        # capture it before this reopen shadows it (plain `super`
+        # falls through to Class#new instead).
+        alias __native_new new
+
+        def new(*args)
+          sig = __native_new(*args)
+          sig.instance_variable_set(:@confium_components, args.first) if args.first.is_a?(Array)
+          sig
+        end
+      end
+
       def self.components_to_json(components)
         JSON.generate(components.map do |component|
           component.transform_values do |value|
@@ -35,7 +61,19 @@ module Confium
           raise ArgumentError, 'expected a non-empty "components" array'
         end
 
-        new(components.map { |c| decode_binary_fields(c) })
+        sig = new(components.map { |c| decode_binary_fields(c) })
+        sig.instance_variable_set(:@confium_components, components)
+        sig.instance_variable_set(:@confium_components_json, canonical_json(json, data))
+        sig
+      end
+
+      # The canonical wire form of whatever the caller handed us: a
+      # String passes through untouched; parsed structures are
+      # re-generated from their components array.
+      def self.canonical_json(json, data)
+        return json if json.is_a?(String)
+
+        JSON.generate(data.is_a?(Hash) ? data['components'] : data)
       end
 
       def self.decode_binary_fields(component)

data/lib/confium/tc/coordinator.rb

@@ -1,15 +1,17 @@
 # frozen_string_literal: true
 
-# Confium::TC::Coordinator wraps the async session coordinator service.
-#
-# The coordinator enables globally distributed threshold signers to
-# participate when convenient — no simultaneity required.
+# Confium::TC::Coordinator coordinates an in-process threshold
+# signing session: signers submit commitments and shares at their own
+# pace; once the threshold is met, aggregation runs the real
+# threshold-ECDSA combine (CMP20 or GG18 — the same in-process
+# drivers behind Confium::TC::Cmp20 / Confium::TC::Gg18) and returns
+# a 64-byte (r, s) signature verifiable under the quorum public key.
 #
 # Usage:
 #   coordinator = Confium::TC::Coordinator.new(quorum_id: "biml-root")
 #   session_id = coordinator.create_session(message: data,
-#                                           threshold: 5,
-#                                           unlock_window: 14400)
+#                                           threshold: 3,
+#                                           scheme: "CMP20-ECDSA-P256")
 #   coordinator.submit_commitment(session_id, signer_id, commitment_bytes)
 #   # ... wait for T commitments ...
 #   coordinator.submit_share(session_id, signer_id, share_bytes)
@@ -25,12 +27,20 @@ module Confium
         @sessions = {}
       end
 
-      def create_session(message:, threshold:, unlock_window: 14_400)
+      SCHEMES = {
+        'CMP20-ECDSA-P256' => ->(shares, threshold, message) { Cmp20.sign(shares, threshold, message) },
+        'GG18-ECDSA-P256' => ->(shares, threshold, message) { Gg18.sign(shares, threshold, message) }
+      }.freeze
+
+      def create_session(message:, threshold:, unlock_window: 14_400, scheme: 'CMP20-ECDSA-P256')
+        raise ArgumentError, "unknown scheme: #{scheme} (known: #{SCHEMES.keys.join(', ')})" unless SCHEMES.key?(scheme)
+
         session_id = "session-#{@sessions.length + 1}"
         @sessions[session_id] = {
           message: message,
           threshold: threshold,
           unlock_window: unlock_window,
+          scheme: scheme,
           state: :pending,
           commitments: [],
           shares: []
@@ -57,11 +67,14 @@ module Confium
 
       def aggregate(session_id)
         session = @sessions[session_id] or raise "Unknown session: #{session_id}"
-        raise 'Threshold not met' if session[:shares].length < session[:threshold]
+        raise ThresholdError, 'Threshold not met' if session[:shares].length < session[:threshold]
 
         session[:state] = :completed
-        # In real implementation, calls FFI to aggregate shares
-        session[:shares].map { |s| s[:bytes] }.join
+        SCHEMES.fetch(session[:scheme]).call(
+          session[:shares].map { |s| s[:bytes] },
+          session[:threshold],
+          session[:message]
+        )
       end
     end
   end

data/lib/confium/tc/network_coordinator.rb

@@ -0,0 +1,208 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'socket'
+require_relative 'coordinator'
+
+module Confium
+  module TC
+    # Networked threshold-signing coordinator service.
+    #
+    # Wraps Confium::TC::Coordinator (real CMP20/GG18 combine) behind
+    # a TCP socket so signers on separate machines submit commitments
+    # and shares from their own processes:
+    #
+    #   service = Confium::TC::NetworkCoordinator.new(quorum_id: 'root')
+    #   service.start                       # binds 127.0.0.1:<ephemeral>
+    #   client = Confium::TC::SignerClient.new(port: service.port)
+    #   sid = client.create_session(message: data, threshold: 3)
+    #   client.submit_share(sid, 'signer-1', share_blob)
+    #   client.aggregate(sid)               # => 64-byte signature
+    #
+    # Protocol: one JSON object per line (NDJSON); binary fields are
+    # hex-encoded. Unknown operations and Coordinator errors come
+    # back as {"error": ..., "message": ...} lines.
+    #
+    # Transport security: none yet — plain TCP intended for loopback
+    # or private networks. The upstream noise-transport session
+    # protocol replaces this wholesale (see
+    # TODO.full/01-multi-host-threshold-signing.md).
+    class NetworkCoordinator
+      HANDLERS = {
+        'create' => lambda do |coord, req|
+          session_id = coord.create_session(
+            message: [req.fetch('message_hex')].pack('H*'),
+            threshold: req.fetch('threshold'),
+            scheme: req['scheme'] || 'CMP20-ECDSA-P256'
+          )
+          { 'session_id' => session_id }
+        end,
+        'commitment' => lambda do |coord, req|
+          session_id = req.fetch('session_id')
+          coord.submit_commitment(
+            session_id, req.fetch('signer_id'),
+            [req.fetch('bytes_hex')].pack('H*')
+          )
+          { 'ok' => true, 'state' => coord.session_state(session_id).to_s }
+        end,
+        'share' => lambda do |coord, req|
+          coord.submit_share(
+            req.fetch('session_id'), req.fetch('signer_id'),
+            [req.fetch('bytes_hex')].pack('H*')
+          )
+          { 'ok' => true }
+        end,
+        'aggregate' => lambda do |coord, req|
+          signature = coord.aggregate(req.fetch('session_id'))
+          { 'signature_hex' => signature.unpack1('H*') }
+        end
+      }.freeze
+
+      class RequestError < StandardError; end
+
+      attr_reader :quorum_id, :port
+
+      def initialize(quorum_id:, host: '127.0.0.1', port: 0, coordinator: nil)
+        @quorum_id = quorum_id
+        @host = host
+        @port = port
+        @coordinator = coordinator || Coordinator.new(quorum_id: quorum_id)
+        @server = nil
+        @accept_thread = nil
+        @mutex = Mutex.new
+      end
+
+      def start
+        raise 'already started' if @server
+
+        # RBS socket lib lacks the (host, port) overload for new
+        @server = TCPServer.new(@host.to_s, @port) # steep:ignore
+        @port = @server.addr[1]
+        @accept_thread = Thread.new { accept_loop }
+        self
+      end
+
+      def stop
+        return unless @server
+
+        server = @server
+        @server = nil
+        server.close
+        @accept_thread&.join(5)
+        nil
+      end
+
+      def running?
+        !@server.nil?
+      end
+
+      private
+
+      def accept_loop
+        loop do
+          server = @server
+          break unless server
+
+          begin
+            socket = server.accept
+          rescue IOError, Errno::EBADF, Errno::EINVAL
+            break # listener closed by #stop
+          end
+          Thread.new(socket) { |conn| serve(conn) }
+        end
+      end
+
+      def serve(socket)
+        socket.each_line do |line|
+          request = JSON.parse(line)
+          response = @mutex.synchronize { dispatch(request) }
+          socket.write("#{JSON.generate(response)}\n")
+        end
+      rescue JSON::ParserError => e
+        write_error(socket, 'RequestError', "malformed JSON: #{e.message}")
+      rescue StandardError => e
+        write_error(socket, e.class.name, e.message)
+      ensure
+        socket.close
+      end
+
+      def dispatch(request)
+        op = request['op'] or raise RequestError, 'missing "op"'
+        handler = HANDLERS[op] or raise RequestError, "unknown op: #{op}"
+
+        handler.call(@coordinator, request)
+      end
+
+      def write_error(socket, klass, message)
+        socket.write("#{JSON.generate({ 'error' => klass, 'message' => message })}\n")
+      rescue IOError
+        nil
+      end
+    end
+
+    # Client side for NetworkCoordinator. One instance per signer
+    # process; each call opens its own connection, so signers never
+    # share state.
+    class SignerClient
+      class RemoteError < StandardError
+        attr_reader :remote_class
+
+        def initialize(remote_class, message)
+          @remote_class = remote_class
+          super("#{remote_class}: #{message}")
+        end
+      end
+
+      def initialize(port:, host: '127.0.0.1')
+        @host = host
+        @port = port
+      end
+
+      def create_session(message:, threshold:, scheme: 'CMP20-ECDSA-P256')
+        response = call(
+          'op' => 'create',
+          'message_hex' => message.to_s.unpack1('H*'),
+          'threshold' => threshold,
+          'scheme' => scheme
+        )
+        response.fetch('session_id')
+      end
+
+      def submit_commitment(session_id, signer_id, commitment_bytes)
+        call(
+          'op' => 'commitment',
+          'session_id' => session_id,
+          'signer_id' => signer_id,
+          'bytes_hex' => commitment_bytes.unpack1('H*')
+        ).fetch('ok')
+      end
+
+      def submit_share(session_id, signer_id, share_bytes)
+        call(
+          'op' => 'share',
+          'session_id' => session_id,
+          'signer_id' => signer_id,
+          'bytes_hex' => share_bytes.unpack1('H*')
+        ).fetch('ok')
+      end
+
+      def aggregate(session_id)
+        response = call('op' => 'aggregate', 'session_id' => session_id)
+        [response.fetch('signature_hex')].pack('H*')
+      end
+
+      private
+
+      def call(request)
+        TCPSocket.open(@host, @port) do |socket|
+          socket.write("#{JSON.generate(request)}\n")
+          line = socket.readline
+          response = JSON.parse(line)
+          raise RemoteError.new(response['error'], response['message']) if response['error']
+
+          response
+        end
+      end
+    end
+  end
+end

data/lib/confium/tc.rb

@@ -11,7 +11,14 @@
 # for the full interface specification.
 module Confium
   module TC
+    # The native extension defines Confium::TC; this namespace file is
+    # eager-required from confium.rb, so autoloads registered here do
+    # fire. Coordinator and ShareFile are pure Ruby and load with the
+    # namespace; Session wraps the engine via FFI and needs the
+    # external libconfium dylib, so it stays lazy.
     autoload :Session, 'confium/tc/session'
-    autoload :Coordinator, 'confium/tc/coordinator'
+    require_relative 'tc/coordinator'
+    require_relative 'tc/network_coordinator'
+    require_relative 'tc/share_file'
   end
 end

data/lib/confium/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Confium
-  VERSION = '0.4.1'
+  VERSION = '0.5.0'
 end

data/lib/confium.rb

@@ -20,7 +20,11 @@ begin
   # directory.
   minor = RUBY_VERSION[/\A\d+\.\d+/]
   dlext = RbConfig::CONFIG['DLEXT'] || 'so'
-  candidates = Gem::Version.new(RUBY_VERSION) >= Gem::Version.new('3.3') ? [minor, '3.3'].uniq : [minor]
+  major = RUBY_VERSION[/\A\d+/].to_i
+  # 3.3-window binaries load on 3.3/3.4 only; a cross-major load
+  # (4.x) fails TypedData class checks, so the fallback applies
+  # within the 3.x line alone.
+  candidates = major == 3 && Gem::Version.new(RUBY_VERSION) >= Gem::Version.new('3.3') ? [minor, '3.3'].uniq : [minor]
   # Windows gems carry an exact-minor window per Ruby (a PE import
   # names the version-specific ruby DLL); other platforms share the
   # 3.3 window for 3.3+. Prefer the exact minor when present.
@@ -92,7 +96,8 @@ require_relative 'confium/transparency'
 # of that module.
 require_relative 'confium/audit'
 
-# Eager-load the TC ShareFile Ruby companion. The native extension
-# defines `Confium::TC` as a Ruby module; this file adds the
-# `ShareFile` class for filesystem-backed share persistence.
-require_relative 'confium/tc/share_file'
+# Eager-load the TC namespace file: `Confium::TC` is native-defined,
+# so an autoload here would never fire (the PKI pattern). It
+# registers the pure-Ruby Session/Coordinator companions and the
+# ShareFile class for filesystem-backed share persistence.
+require_relative 'confium/tc'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: confium
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.0
 platform: ruby
 authors:
 - Ribose Open
@@ -128,6 +128,7 @@ files:
 - ext/confium_native/src/util.rs
 - lib/confium.rb
 - lib/confium/audit.rb
+- lib/confium/audit/otlp_sink.rb
 - lib/confium/cfm.rb
 - lib/confium/composite.rb
 - lib/confium/crypto.rb
@@ -155,6 +156,7 @@ files:
 - lib/confium/secure_bytes.rb
 - lib/confium/tc.rb
 - lib/confium/tc/coordinator.rb
+- lib/confium/tc/network_coordinator.rb
 - lib/confium/tc/session.rb
 - lib/confium/tc/session_stub.rb
 - lib/confium/tc/share_file.rb