sec_id 6.1.0 → 7.1.0

data/lib/sec_id/concerns/validatable.rb

@@ -8,7 +8,7 @@ module SecID
   module Validatable
     # Maps error-code symbols to their exception classes; unmapped codes default to InvalidFormatError.
     ERROR_MAP = {
-      invalid_check_digit: InvalidCheckDigitError,
+      invalid_checksum: InvalidChecksumError,
       invalid_prefix: InvalidStructureError,
       invalid_category: InvalidStructureError,
       invalid_group: InvalidStructureError,
@@ -43,7 +43,7 @@ module SecID
       #
       # @param id [String] the identifier to validate
       # @return [Base] the identifier instance
-      # @raise [InvalidFormatError, InvalidCheckDigitError, InvalidStructureError]
+      # @raise [InvalidFormatError, InvalidChecksumError, InvalidStructureError]
       def validate!(id)
         new(id).validate!
       end
@@ -82,7 +82,7 @@ module SecID
     # Validates and returns self if valid, raises an exception otherwise.
     #
     # @return [self]
-    # @raise [InvalidFormatError, InvalidCheckDigitError, InvalidStructureError]
+    # @raise [InvalidFormatError, InvalidChecksumError, InvalidStructureError]
     def validate!
       return self if valid?
 
@@ -119,7 +119,7 @@ module SecID
     end
 
     # Checks length against ID_LENGTH's three shapes: Range (bounds), Array
-    # (discrete valid lengths), or Integer (allows an optional check digit).
+    # (discrete valid lengths), or Integer (allows an optional checksum).
     #
     # @return [Boolean]
     def valid_length?
@@ -130,7 +130,7 @@ module SecID
       case id_length
       when Range then id_length.cover?(len)
       when Array then id_length.include?(len)
-      else            ((id_length - check_digit_width)..id_length).cover?(len)
+      else            ((id_length - checksum_width)..id_length).cover?(len)
       end
     end
 
@@ -139,8 +139,8 @@ module SecID
       full_id.match?(self.class::VALID_CHARS_REGEX)
     end
 
-    # @return [Integer] width of the check digit (0 for non-checkable, overridden in Checkable)
-    def check_digit_width
+    # @return [Integer] width of the checksum (0 for non-checkable, overridden in Checkable)
+    def checksum_width
       0
     end
 

data/lib/sec_id/cusip.rb

@@ -4,7 +4,7 @@ module SecID
   # Committee on Uniform Securities Identification Procedures (CUSIP) - a 9-character
   # alphanumeric code that identifies North American securities.
   #
-  # Format: 6-character issuer code (CUSIP-6) + 2-character issue number + 1-digit check digit
+  # Format: 6-character issuer code (CUSIP-6) + 2-character issue number + 1-digit checksum
   #
   # @see https://en.wikipedia.org/wiki/CUSIP
   #
@@ -16,6 +16,7 @@ module SecID
   #   cusip.to_isin('US')  #=> #<SecID::ISIN>
   class CUSIP < Base
     include Checkable
+    include Suggestable
 
     # Human-readable name of the standard.
     FULL_NAME = 'Committee on Uniform Securities Identification Procedures'
@@ -31,7 +32,7 @@ module SecID
       (?<identifier>
         (?<cusip6>[A-Z0-9]{5}[A-Z0-9*@#])
         (?<issue>[A-Z0-9*@#]{2}))
-      (?<check_digit>\d)?
+      (?<checksum>\d)?
     \z/x
 
     # @return [String, nil] the 6-character issuer code
@@ -46,19 +47,19 @@ module SecID
       @identifier = cusip_parts[:identifier]
       @cusip6 = cusip_parts[:cusip6]
       @issue = cusip_parts[:issue]
-      @check_digit = cusip_parts[:check_digit]&.to_i
+      @checksum = cusip_parts[:checksum]&.to_i
     end
 
     # @return [String, nil]
     def to_pretty_s
       return nil unless valid?
 
-      "#{cusip6} #{issue} #{check_digit}"
+      "#{cusip6} #{issue} #{checksum}"
     end
 
-    # @return [Integer] the calculated check digit (0-9)
+    # @return [Integer] the calculated checksum (0-9)
     # @raise [InvalidFormatError] if the CUSIP format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
       mod10(luhn_sum_double_add_double(reversed_digits_single(identifier)))
     end
@@ -66,7 +67,7 @@ module SecID
     # Generates a random CUSIP body: 8 alphanumeric characters.
     #
     # @param random [Random] source of randomness
-    # @return [String] an 8-character CUSIP body without check digit
+    # @return [String] an 8-character CUSIP body without checksum
     def self.generate_body(random)
       random_string(ALPHANUMERIC, 8, random: random)
     end
@@ -91,6 +92,6 @@ module SecID
     private
 
     # @return [Hash]
-    def components = { cusip6:, issue:, check_digit: }
+    def components = { cusip6:, issue:, checksum: }
   end
 end

data/lib/sec_id/deprecation.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module SecID
+  # Emits standardized, silenceable deprecation warnings for the v7 → v8 rename
+  # bridge. Stateless: warns on every call with no per-call-site dedup, so the
+  # migration signal is never suppressed by default.
+  #
+  # The warning is written via {Kernel#warn} at Ruby's default verbosity — it is
+  # visible unless the process runs with `-W0` / `$VERBOSE = nil`. No `category:`
+  # is passed, because `Warning[:deprecated]` defaults to `false` and would hide
+  # the bridge warning the rename relies on.
+  module Deprecation
+    # Emits a standardized deprecation warning for a renamed API name.
+    #
+    # @param old [String] the deprecated name
+    # @param new [String] the canonical replacement name
+    # @param removed_in [String] the version that removes the deprecated name
+    # @return [void]
+    def self.warn(old:, new:, removed_in: 'v8')
+      Kernel.warn(
+        "SecID: `#{old}` is deprecated and will be removed in #{removed_in}; use `#{new}` instead.",
+        uplevel: 2
+      )
+    end
+  end
+end

data/lib/sec_id/dti.rb

@@ -13,10 +13,11 @@ module SecID
   # @example Validate a DTI
   #   SecID::DTI.valid?('X9J9K872S')  #=> true
   #
-  # @example Restore check digit
+  # @example Restore checksum
   #   SecID::DTI.restore('X9J9K872')  #=> 'X9J9K872S'
   class DTI < Base
     include Checkable
+    include Suggestable
 
     # Human-readable name of the standard.
     FULL_NAME = 'Digital Token Identifier'
@@ -33,7 +34,7 @@ module SecID
       (?<identifier>
         [1-9B-DF-HJ-NP-TV-XZ]
         [0-9B-DF-HJ-NP-TV-XZ]{7})
-      (?<check_digit>[0-9B-DF-HJ-NP-TV-XZ])?
+      (?<checksum>[0-9B-DF-HJ-NP-TV-XZ])?
     \z/x
 
     # The 30-symbol DTI alphabet, ordered by check-character value (0-29).
@@ -55,14 +56,14 @@ module SecID
     def initialize(dti)
       dti_parts = parse dti
       @identifier = dti_parts[:identifier]
-      @check_digit = dti_parts[:check_digit]
+      @checksum = dti_parts[:checksum]
     end
 
     # @return [String] the calculated or grandfathered check character
     # @raise [InvalidFormatError] if the DTI format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
-      grandfathered_check_digit(identifier) || iso7064_mod31_30_check_char(identifier)
+      grandfathered_checksum(identifier) || iso7064_mod31_30_check_char(identifier)
     end
 
     # Generates a random DTI body: first character non-zero, 8 characters total,
@@ -79,11 +80,11 @@ module SecID
     private
 
     # @return [Hash]
-    def components = { check_digit: }
+    def components = { checksum: }
 
     # @param base [String] the 8-character DTI base
     # @return [String, nil] the registered check character, or nil if not grandfathered
-    def grandfathered_check_digit(base)
+    def grandfathered_checksum(base)
       GRANDFATHERED_CODES[base]&.delete_prefix(base)
     end
 
@@ -92,13 +93,7 @@ module SecID
     # @param base [String] the 8-character DTI base
     # @return [String] the single computed check character
     def iso7064_mod31_30_check_char(base)
-      perm = 30
-      base.each_char do |c|
-        s = (perm + ALPHABET_VALUE.fetch(c)) % 30
-        s = 30 if s.zero?
-        perm = (s * 2) % 31
-      end
-      ALPHABET.fetch((31 - perm) % 30)
+      mod31_30_check_char(base, ALPHABET, ALPHABET_VALUE)
     end
   end
 end

data/lib/sec_id/figi.rb

@@ -4,7 +4,7 @@ module SecID
   # Financial Instrument Global Identifier (FIGI) - a 12-character alphanumeric code
   # that uniquely identifies financial instruments.
   #
-  # Format: 2-character prefix + 'G' + 8-character random part + 1-digit check digit
+  # Format: 2-character prefix + 'G' + 8-character random part + 1-digit checksum
   # Note: FIGI excludes vowels (A, E, I, O, U) from valid characters.
   #
   # @see https://en.wikipedia.org/wiki/Financial_Instrument_Global_Identifier
@@ -12,10 +12,11 @@ module SecID
   # @example Validate a FIGI
   #   SecID::FIGI.valid?('BBG000BLNQ16')  #=> true
   #
-  # @example Restore check digit
+  # @example Restore checksum
   #   SecID::FIGI.restore!('BBG000BLNQ1')  #=> #<SecID::FIGI>
   class FIGI < Base
     include Checkable
+    include Suggestable
 
     # Human-readable name of the standard.
     FULL_NAME = 'Financial Instrument Global Identifier'
@@ -33,7 +34,7 @@ module SecID
         (?<prefix>[B-DF-HJ-NP-TV-Z0-9]{2})
         G
         (?<random_part>[B-DF-HJ-NP-TV-Z0-9]{8}))
-      (?<check_digit>\d)?
+      (?<checksum>\d)?
     \z/x
 
     # Country-code prefixes that are restricted from use in FIGI.
@@ -54,19 +55,19 @@ module SecID
       @identifier = figi_parts[:identifier]
       @prefix = figi_parts[:prefix]
       @random_part = figi_parts[:random_part]
-      @check_digit = figi_parts[:check_digit]&.to_i
+      @checksum = figi_parts[:checksum]&.to_i
     end
 
     # @return [String, nil]
     def to_pretty_s
       return nil unless valid?
 
-      "#{prefix}G #{random_part} #{check_digit}"
+      "#{prefix}G #{random_part} #{checksum}"
     end
 
-    # @return [Integer] the calculated check digit (0-9)
+    # @return [Integer] the calculated checksum (0-9)
     # @raise [InvalidFormatError] if the FIGI format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
       mod10(luhn_sum_indexed(reversed_digits_single(identifier)))
     end
@@ -74,7 +75,7 @@ module SecID
     # Generates a random FIGI body: non-reserved 2-char prefix + 'G' + 8-char random part.
     #
     # @param random [Random] source of randomness
-    # @return [String] an 11-character FIGI body without check digit
+    # @return [String] an 11-character FIGI body without checksum
     def self.generate_body(random)
       prefix = random_string(GENERATE_CHARSET, 2, random: random)
       prefix = random_string(GENERATE_CHARSET, 2, random: random) while RESTRICTED_PREFIXES.include?(prefix)
@@ -85,7 +86,7 @@ module SecID
     private
 
     # @return [Hash]
-    def components = { prefix:, random_part:, check_digit: }
+    def components = { prefix:, random_part:, checksum: }
 
     # @return [Boolean]
     def valid_format?

data/lib/sec_id/iban.rb

@@ -6,8 +6,8 @@ module SecID
   # International Bank Account Number (IBAN) - an international standard for identifying
   # bank accounts across national borders (ISO 13616).
   #
-  # Format: 2-letter country code + 2-digit check digits + BBAN (Basic Bank Account Number, 11-30 chars)
-  # Note: Unlike other SecID identifiers, the check digits are in positions 3-4, not at the end.
+  # Format: 2-letter country code + 2-digit checksum + BBAN (Basic Bank Account Number, 11-30 chars)
+  # Note: Unlike other SecID identifiers, the checksum are in positions 3-4, not at the end.
   #
   # @see https://en.wikipedia.org/wiki/International_Bank_Account_Number
   # @see https://www.iban.com/structure
@@ -15,10 +15,11 @@ module SecID
   # @example Validate an IBAN
   #   SecID::IBAN.valid?('DE89370400440532013000')  #=> true
   #
-  # @example Restore check digits
+  # @example Restore checksum
   #   SecID::IBAN.restore!('DE00370400440532013000')  #=> #<SecID::IBAN>
   class IBAN < Base
     include Checkable
+    include Suggestable
 
     # Human-readable name of the standard.
     FULL_NAME = 'International Bank Account Number'
@@ -30,7 +31,7 @@ module SecID
     VALID_CHARS_REGEX = /\A[A-Z0-9]+\z/
 
     # Regular expression for parsing IBAN components.
-    # Note: Check digit positioning is handled in initialize, not in the regex.
+    # Note: Checksum positioning is handled in initialize, not in the regex.
     ID_REGEX = /\A
       (?<country_code>[A-Z]{2})
       (?<rest>[A-Z0-9]{13,32})
@@ -62,7 +63,7 @@ module SecID
     # @return [String, nil] the account number (extracted from BBAN if country rules define it)
     attr_reader :account_number
 
-    # @return [String, nil] the national check digit (extracted from BBAN if country rules define it)
+    # @return [String, nil] the national checksum (extracted from BBAN if country rules define it)
     attr_reader :national_check
 
     # @param iban [String] the IBAN string to parse
@@ -72,7 +73,7 @@ module SecID
       rest = iban_parts[:rest]
 
       if @country_code && rest
-        extract_check_digit_and_bban(rest)
+        extract_checksum_and_bban(rest)
         @identifier = "#{@country_code}#{@bban}" if @bban
       end
 
@@ -82,19 +83,19 @@ module SecID
     # @return [String]
     # @raise [InvalidFormatError] if the IBAN format is invalid
     def restore
-      cd = calculate_check_digit
+      cd = calculate_checksum
       "#{country_code}#{cd.to_s.rjust(2, '0')}#{bban}"
     end
 
     # @return [Integer] the calculated 2-digit check value (1-98)
     # @raise [InvalidFormatError] if the IBAN format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
       mod97(numeric_string_for_check)
     end
 
-    # Generates a random IBAN body for a numeric-BBAN country with placeholder check digits.
-    # The default {Generatable::ClassMethods#generate} restores the real check digits via `restore!`.
+    # Generates a random IBAN body for a numeric-BBAN country with placeholder checksum.
+    # The default {Generatable::ClassMethods#generate} restores the real checksum via `restore!`.
     #
     # @param random [Random] source of randomness
     # @return [String] a country code + "00" + numeric BBAN
@@ -126,9 +127,9 @@ module SecID
 
     # @return [String]
     def to_s
-      return full_id unless check_digit
+      return full_id unless checksum
 
-      "#{country_code}#{check_digit.to_s.rjust(2, '0')}#{bban}"
+      "#{country_code}#{checksum.to_s.rjust(2, '0')}#{bban}"
     end
 
     # @return [String, nil]
@@ -140,7 +141,7 @@ module SecID
 
     # @return [Hash]
     def components
-      hash = { country_code:, bban:, check_digit: }
+      hash = { country_code:, bban:, checksum: }
       hash[:bank_code] = bank_code if bank_code
       hash[:branch_code] = branch_code if branch_code
       hash[:account_number] = account_number if account_number
@@ -149,7 +150,7 @@ module SecID
     end
 
     # @return [Integer]
-    def check_digit_width
+    def checksum_width
       2
     end
 
@@ -177,14 +178,14 @@ module SecID
 
     # @param rest [String] the IBAN string after country code
     # @return [void]
-    def extract_check_digit_and_bban(rest)
+    def extract_checksum_and_bban(rest)
       expected = expected_bban_length_for_country
 
-      if check_digits?(rest, expected)
-        @check_digit = rest[0, 2].to_i
+      if checksum?(rest, expected)
+        @checksum = rest[0, 2].to_i
         @bban = rest[2..]
       else
-        @check_digit = nil
+        @checksum = nil
         @bban = rest
       end
     end
@@ -197,11 +198,11 @@ module SecID
     # @param rest [String] the IBAN string after country code
     # @param expected_bban_length [Integer, nil] the expected BBAN length for the country
     # @return [Boolean]
-    def check_digits?(rest, expected_bban_length)
+    def checksum?(rest, expected_bban_length)
       return false unless rest[0, 2].match?(/\A\d{2}\z/)
       return true unless expected_bban_length
 
-      # If we know expected BBAN length, check if rest matches with or without check digits
+      # If we know expected BBAN length, check if rest matches with or without checksum
       rest.length == expected_bban_length + 2 || rest.length != expected_bban_length
     end
 

data/lib/sec_id/isin.rb

@@ -4,17 +4,18 @@ module SecID
   # International Securities Identification Number (ISIN) - a 12-character alphanumeric code
   # that uniquely identifies a security globally.
   #
-  # Format: 2-letter country code + 9-character NSIN + 1-digit check digit
+  # Format: 2-letter country code + 9-character NSIN + 1-digit checksum
   #
   # @see https://en.wikipedia.org/wiki/International_Securities_Identification_Number
   #
   # @example Validate an ISIN
   #   SecID::ISIN.valid?('US5949181045')  #=> true
   #
-  # @example Restore check digit
+  # @example Restore checksum
   #   SecID::ISIN.restore!('US594918104')  #=> #<SecID::ISIN>
   class ISIN < Base
     include Checkable
+    include Suggestable
 
     # Human-readable name of the standard.
     FULL_NAME = 'International Securities Identification Number'
@@ -30,7 +31,7 @@ module SecID
       (?<identifier>
         (?<country_code>[A-Z]{2})
         (?<nsin>[A-Z0-9]{9}))
-      (?<check_digit>\d)?
+      (?<checksum>\d)?
     \z/x
 
     # Country codes that use CUSIP Global Services (CGS) for NSIN assignment.
@@ -71,19 +72,19 @@ module SecID
       @identifier = isin_parts[:identifier]
       @country_code = isin_parts[:country_code]
       @nsin = isin_parts[:nsin]
-      @check_digit = isin_parts[:check_digit]&.to_i
+      @checksum = isin_parts[:checksum]&.to_i
     end
 
     # @return [String, nil]
     def to_pretty_s
       return nil unless valid?
 
-      "#{country_code} #{nsin} #{check_digit}"
+      "#{country_code} #{nsin} #{checksum}"
     end
 
-    # @return [Integer] the calculated check digit (0-9)
+    # @return [Integer] the calculated checksum (0-9)
     # @raise [InvalidFormatError] if the ISIN format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
       mod10(luhn_sum_standard(reversed_digits_multi(identifier)))
     end
@@ -91,7 +92,7 @@ module SecID
     # Generates a random ISIN body: 2-letter country code + 9-character NSIN.
     #
     # @param random [Random] source of randomness
-    # @return [String] an 11-character ISIN body without check digit
+    # @return [String] an 11-character ISIN body without checksum
     def self.generate_body(random)
       "#{random_string(ALPHA, 2, random: random)}#{random_string(ALPHANUMERIC, 9, random: random)}"
     end
@@ -177,6 +178,6 @@ module SecID
     private
 
     # @return [Hash]
-    def components = { country_code:, nsin:, check_digit: }
+    def components = { country_code:, nsin:, checksum: }
   end
 end

data/lib/sec_id/lei.rb

@@ -4,7 +4,7 @@ module SecID
   # Legal Entity Identifier (LEI) - a 20-character alphanumeric code that
   # uniquely identifies legal entities participating in financial transactions.
   #
-  # Format: 4-character LOU ID + 2-character reserved + 12-character entity ID + 2-digit check digit
+  # Format: 4-character LOU ID + 2-character reserved + 12-character entity ID + 2-digit checksum
   #
   # @see https://en.wikipedia.org/wiki/Legal_Entity_Identifier
   # @see https://www.gleif.org/en/about-lei/iso-17442-the-lei-code-structure
@@ -12,10 +12,11 @@ module SecID
   # @example Validate a LEI
   #   SecID::LEI.valid?('529900T8BM49AURSDO55')  #=> true
   #
-  # @example Calculate check digit
-  #   SecID::LEI.check_digit('529900T8BM49AURSDO')  #=> 55
+  # @example Calculate checksum
+  #   SecID::LEI.checksum('529900T8BM49AURSDO')  #=> 55
   class LEI < Base
     include Checkable
+    include Suggestable
 
     # Human-readable name of the standard.
     FULL_NAME = 'Legal Entity Identifier'
@@ -32,7 +33,7 @@ module SecID
         (?<lou_id>[0-9A-Z]{4})
         (?<reserved>[0-9A-Z]{2})
         (?<entity_id>[0-9A-Z]{12}))
-      (?<check_digit>\d{2})?
+      (?<checksum>\d{2})?
     \z/x
 
     # @return [String, nil] the 4-character Local Operating Unit (LOU) identifier
@@ -51,7 +52,7 @@ module SecID
       @lou_id = lei_parts[:lou_id]
       @reserved = lei_parts[:reserved]
       @entity_id = lei_parts[:entity_id]
-      @check_digit = lei_parts[:check_digit]&.to_i
+      @checksum = lei_parts[:checksum]&.to_i
     end
 
     # @return [String, nil]
@@ -61,9 +62,9 @@ module SecID
       to_s.scan(/.{1,4}/).join(' ')
     end
 
-    # @return [Integer] the calculated 2-digit check digit (1-98)
+    # @return [Integer] the calculated 2-digit checksum (1-98)
     # @raise [InvalidFormatError] if the LEI format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
       mod97("#{numeric_identifier}00")
     end
@@ -71,7 +72,7 @@ module SecID
     # Generates a random LEI body: 18 alphanumeric characters.
     #
     # @param random [Random] source of randomness
-    # @return [String] an 18-character LEI body without check digits
+    # @return [String] an 18-character LEI body without checksum
     def self.generate_body(random)
       random_string(ALPHANUMERIC, 18, random: random)
     end
@@ -80,10 +81,10 @@ module SecID
     private
 
     # @return [Hash]
-    def components = { lou_id:, reserved:, entity_id:, check_digit: }
+    def components = { lou_id:, reserved:, entity_id:, checksum: }
 
     # @return [Integer]
-    def check_digit_width
+    def checksum_width
       2
     end
 

data/lib/sec_id/occ.rb

@@ -6,7 +6,7 @@ module SecID
   # OCC Option Symbol - standardized option symbol format used by Option Clearing Corporation.
   # Format: 6-char underlying (padded) + 6-char date (YYMMDD) + type (C/P) + 8-digit strike (in mills).
   #
-  # @note OCC identifiers have no check digit and validation includes both format
+  # @note OCC identifiers have no checksum and validation includes both format
   #   and date parseability checks.
   #
   # @see https://en.wikipedia.org/wiki/Option_symbol#The_OCC_Option_Symbol

data/lib/sec_id/sedol.rb

@@ -4,7 +4,7 @@ module SecID
   # Stock Exchange Daily Official List (SEDOL) - a 7-character alphanumeric code
   # that identifies securities traded on the London Stock Exchange and other UK exchanges.
   #
-  # Format: 6-character identifier + 1-digit check digit
+  # Format: 6-character identifier + 1-digit checksum
   # Note: SEDOL excludes vowels (A, E, I, O, U) to avoid forming words.
   #
   # @see https://en.wikipedia.org/wiki/SEDOL
@@ -12,10 +12,11 @@ module SecID
   # @example Validate a SEDOL
   #   SecID::SEDOL.valid?('B19GKT4')  #=> true
   #
-  # @example Calculate check digit
-  #   SecID::SEDOL.check_digit('B19GKT')  #=> 4
+  # @example Calculate checksum
+  #   SecID::SEDOL.checksum('B19GKT')  #=> 4
   class SEDOL < Base
     include Checkable
+    include Suggestable
 
     # Human-readable name of the standard.
     FULL_NAME = 'Stock Exchange Daily Official List'
@@ -30,10 +31,10 @@ module SecID
     # Excludes vowels (A, E, I, O, U) from valid characters.
     ID_REGEX = /\A
       (?<identifier>[0-9BCDFGHJKLMNPQRSTVWXYZ]{6})
-      (?<check_digit>\d)?
+      (?<checksum>\d)?
     \z/x
 
-    # Weights applied to each character position in the check digit calculation.
+    # Weights applied to each character position in the checksum calculation.
     CHARACTER_WEIGHTS = [1, 3, 1, 7, 3, 9].freeze
 
     # Characters valid in a SEDOL body (alphanumeric excluding vowels).
@@ -43,14 +44,14 @@ module SecID
     def initialize(sedol)
       sedol_parts = parse sedol
       @identifier = sedol_parts[:identifier]
-      @check_digit = sedol_parts[:check_digit]&.to_i
+      @checksum = sedol_parts[:checksum]&.to_i
     end
 
     # Valid country codes for SEDOL to ISIN conversion.
     ISIN_COUNTRY_CODES = Set.new(%w[GB IE GG IM JE FK]).freeze
 
     # @param country_code [String] the ISO 3166-1 alpha-2 country code (default: 'GB')
-    # @return [ISIN] a new ISIN instance with calculated check digit
+    # @return [ISIN] a new ISIN instance with calculated checksum
     # @raise [InvalidFormatError] if the country code is not valid for SEDOL
     def to_isin(country_code = 'GB')
       unless ISIN_COUNTRY_CODES.include?(country_code)
@@ -60,9 +61,9 @@ module SecID
       ISIN.new("#{country_code}00#{restore}").restore!
     end
 
-    # @return [Integer] the calculated check digit (0-9)
+    # @return [Integer] the calculated checksum (0-9)
     # @raise [InvalidFormatError] if the SEDOL format is invalid
-    def calculate_check_digit
+    def calculate_checksum
       validate_format_for_calculation!
       mod10(weighted_sum)
     end
@@ -70,7 +71,7 @@ module SecID
     # Generates a random SEDOL body: 6 characters excluding vowels.
     #
     # @param random [Random] source of randomness
-    # @return [String] a 6-character SEDOL body without check digit
+    # @return [String] a 6-character SEDOL body without checksum
     def self.generate_body(random)
       random_string(GENERATE_CHARSET, 6, random: random)
     end
@@ -79,7 +80,7 @@ module SecID
     private
 
     # @return [Hash]
-    def components = { check_digit: }
+    def components = { checksum: }
 
     # NOTE: Not idiomatic Ruby, but optimized for performance.
     #