confium 0.5.0 → 0.6.0

data/lib/confium/crypto.rb

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-# {Confium::Crypto} is the registry namespace for Confium's cryptographic
-# interfaces.
-#
-# Mirroring the Rust plugin-interface registry (TODO #02), each Ruby
-# interface module (Digest, and future Cipher, AEAD, KDF, RNG, Signature,
-# KEM, ...) registers itself here on load rather than being enumerated in
-# a central case statement. This keeps the registry open for extension
-# (OCP) and makes the set of available interfaces a single source of
-# truth.
-#
-# Example:
-#
-#   module Confium
-#     module Digest
-#       Confium::Crypto.register(:hash, self)
-#     end
-#   end
-#
-#   Confium::Crypto.lookup(:hash)  # => Confium::Digest
-module Confium
-  module Crypto
-    # @type ivar @interfaces: Hash[Symbol, untyped]
-    @interfaces = {}
-
-    class << self
-      # Register an interface +klass+ under the symbolic +name+. Adding a
-      # new interface is a one-line registration; no central switch needs
-      # editing.
-      def register(name, klass)
-        @interfaces[name] = klass
-        klass
-      end
-
-      # Resolve a registered interface by +name+. Raises ArgumentError if
-      # nothing has been registered under that name.
-      def lookup(name)
-        @interfaces.fetch(name) do
-          raise ArgumentError, "unknown interface #{name.inspect}"
-        end
-      end
-
-      # Enumerate the names of every registered interface. Primarily for
-      # introspection and tooling.
-      def interfaces
-        @interfaces.keys.dup
-      end
-    end
-  end
-end

data/lib/confium/digest.rb

@@ -1,62 +0,0 @@
-# frozen_string_literal: true
-
-require 'ffi'
-require 'digest'
-
-module Confium
-  class Digest < ::Digest::Class
-    attr_reader :name, :ptr
-
-    def initialize(cfm, name)
-      @name = name
-      pptr = ::FFI::MemoryPointer.new(:pointer)
-      Confium.call_ffi(:cfm_hash_create, cfm.ptr, pptr, name, nil, nil, nil)
-      ptr = pptr.read_pointer
-      raise if ptr.null?
-
-      @ptr = ::FFI::AutoPointer.new(ptr, self.class.method(:destroy))
-    end
-
-    def initialize_copy(source)
-      @name = source.name
-      pptr = ::FFI::MemoryPointer.new(:pointer)
-      Confium.call_ffi(:cfm_hash_clone, source.ptr, pptr)
-      ptr = pptr.read_pointer
-      @ptr = ::FFI::AutoPointer.new(ptr, self.class.method(:destroy))
-    end
-
-    def self.destroy(ptr)
-      Confium::Lib.cfm_hash_destroy(ptr)
-    end
-
-    def block_length
-      plength = ::FFI::MemoryPointer.new(:uint32)
-      Confium.call_ffi(:cfm_hash_block_size, @ptr, plength)
-      plength.read(:uint32)
-    end
-
-    def digest_length
-      plength = ::FFI::MemoryPointer.new(:uint32)
-      Confium.call_ffi(:cfm_hash_output_size, @ptr, plength)
-      plength.read(:uint32)
-    end
-
-    def update(data)
-      Confium.call_ffi(:cfm_hash_update, @ptr, data, data.bytesize)
-      self
-    end
-
-    def reset
-      Confium.call_ffi(:cfm_hash_reset, @ptr)
-      self
-    end
-
-    def finish
-      buf = ::FFI::MemoryPointer.new(:uint8, digest_length)
-      Confium.call_ffi(:cfm_hash_finalize, @ptr, buf, buf.size)
-      buf.read_bytes(buf.size)
-    end
-
-    alias << update
-  end
-end

data/lib/confium/ffi.rb

@@ -1,23 +0,0 @@
-# frozen_string_literal: true
-
-require 'ffi'
-
-# {Confium::FFI} is the namespace for everything that touches the native
-# Confium shared library through Ruby-FFI.
-#
-# This file registers autoload entries for the planned FFI helper modules
-# (Library, Error, Options). They are listed in the TODO #14 architecture
-# (see `TODO.finalize/14-ruby-bindings-architecture.md`) and will be added
-# as the bindings grow; until then the autoloads are inert — they only
-# trigger a load when the corresponding constant is first referenced.
-#
-# Note: the legacy FFI library wrapper still lives at `Confium::Lib`
-# (file `confium/lib.rb`) and is autoloaded from `confium.rb`. It will be
-# migrated into `Confium::FFI::Library` in a follow-up.
-module Confium
-  module FFI
-    autoload :Library, 'confium/ffi/library'
-    autoload :Error,   'confium/ffi/error'
-    autoload :Options, 'confium/ffi/options'
-  end
-end

data/lib/confium/lib.rb

@@ -1,33 +0,0 @@
-# frozen_string_literal: true
-
-require 'ffi'
-
-module Confium
-  module Lib
-    extend ::FFI::Library
-
-    FFI_LAYOUT = {
-      cfm_create: [%i[pointer], :uint32],
-      cfm_destroy: [%i[pointer], :uint32],
-      cfm_plugin_load: [%i[pointer string string pointer pointer], :uint32],
-      cfm_hash_create: [%i[pointer pointer pointer pointer pointer pointer], :uint32],
-      cfm_hash_output_size: [%i[pointer pointer], :uint32],
-      cfm_hash_block_size: [%i[pointer pointer], :uint32],
-      cfm_hash_update: [%i[pointer pointer uint32], :uint32],
-      cfm_hash_reset: [%i[pointer], :uint32],
-      cfm_hash_clone: [%i[pointer pointer], :uint32],
-      cfm_hash_finalize: [%i[pointer pointer uint32], :uint32],
-      cfm_hash_destroy: [%i[pointer], :void]
-    }.freeze
-
-    ffi_lib([ENV.fetch('CONFIUM_LIB', nil), 'confium', 'libconfium'].compact)
-
-    FFI_LAYOUT.each do |func, ary|
-      class_eval do
-        attach_function(func, ary.first, ary.last)
-      end
-    rescue ::FFI::NotFoundError
-      # that's okay
-    end
-  end
-end

data/lib/confium/tc/session.rb

@@ -1,51 +0,0 @@
-# frozen_string_literal: true
-
-require 'confium/lib'
-
-# Confium::TC::Session wraps a threshold cryptography session.
-#
-# A session represents one signing or decryption operation involving
-# T-of-N parties. The session goes through states: pending →
-# commitments_collected → shares_collected → completed.
-#
-# Usage:
-#   session = Confium::TC::Session.new(scheme: "FROST-ed25519",
-#                                      threshold: 3,
-#                                      num_parties: 5,
-#                                      party_index: 0)
-#   session.set_local_share(share_bytes)
-#   session.round(incoming_messages) # returns outgoing messages
-#   result = session.result if session.complete?
-module Confium
-  module TC
-    class Session
-      attr_reader :scheme, :threshold, :num_parties, :party_index, :state
-
-      def initialize(scheme:, threshold:, num_parties:, party_index:)
-        @scheme = scheme
-        @threshold = threshold
-        @num_parties = num_parties
-        @party_index = party_index
-        @state = :pending
-        @local_share = nil
-        @result = nil
-      end
-
-      def set_local_share(share_bytes)
-        raise ArgumentError, 'share must be a String' unless share_bytes.is_a?(String)
-
-        @local_share = share_bytes
-      end
-
-      def complete?
-        @state == :completed
-      end
-
-      def result
-        raise 'Session not complete' unless complete?
-
-        @result
-      end
-    end
-  end
-end

data/lib/confium/tc/session_stub.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-# Confium::TC::SessionStub — placeholder for the multi-party TC session
-# interface. The full Session implementation wraps
-# confium_tc::session::Session which drives 3-round FROST/CMP20/GG18
-# signing ceremonies.
-#
-# This stub provides the interface shape so consumers can write code
-# against it. The actual session orchestration will be wired through
-# magnus in a future PR (TODO.completion/009-multi-party-tc-sessions.md).
-
-module Confium
-  module TC
-    class SessionStub
-      attr_reader :scheme, :threshold, :party_count, :this_party_idx, :round
-
-      def initialize(scheme:, threshold:, party_count:, this_party_idx:)
-        @scheme = scheme
-        @threshold = threshold
-        @party_count = party_count
-        @this_party_idx = this_party_idx
-        @round = 0
-        @complete = false
-      end
-
-      def complete?
-        @complete
-      end
-
-      # Stub: returns an empty RoundResult. Real implementation will
-      # call confium_tc::session::Session::round_step.
-      def round_step(_incoming_messages)
-        @round += 1
-        @complete = @round >= 3 # FROST is 3 rounds
-        { outgoing: [], complete: @complete }
-      end
-
-      def result
-        nil # Real implementation returns the signature/secret bytes.
-      end
-    end
-  end
-end