bech32 1.4.2 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48d29f1fc27cc6566387a4810caa45c5abf8acfd98f53d5bc91467f4479f97c4
-  data.tar.gz: e681f66af497af6f5f5089a4cdfd7937fda0a53bba80ba11c7fd7f3ea650163d
+  metadata.gz: 22cba51d19b0989743f7f679f187311e735ce018dec53880ddfefebee89f688f
+  data.tar.gz: 1cd7be33ab83fd724054202a812f818ed02adb5eb7545baa27e27f6b3358da2e
 SHA512:
-  metadata.gz: 0e479ba31346cb4e8d3ab586d780ec7586a076f9a89040c3cb48177243f814440e491592b9473555bb8fb08a7c40a9c82f0bb45065e768d42f4b97404dc904c5
-  data.tar.gz: 053b883473ccf56a6c529898c7c707aaf3abd21e25f097ced6c61e9e52b5919e19b2d36230c0e56c7631748fad366ea468c614971781c54500be1408a06e54b0
+  metadata.gz: dc71997f097a817224b687dc53baf048ba2954cd030f7db50523d7e45121632b7f2edf758ed78298102214c3e3407cf7c7da6b3469a3cde089ade10e8346088d
+  data.tar.gz: 6c246c4107a40193d317738bfa4637ccf6452efb48f1d36532570cec1e09681cc17fd374f47361467017e6546f36c4513f2585ed2d4b767939dcef05047ede46

data/.github/workflows/main.yml

@@ -19,10 +19,10 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby-version: ['3.0', '3.1', '3.2']
+        ruby-version: ['3.2', '3.3', '3.4', '4.0']
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Set up Ruby
         # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
         # change this to (see https://github.com/ruby/setup-ruby#versioning):
@@ -32,3 +32,16 @@ jobs:
           bundler-cache: true # runs 'bundle install' and caches installed gems automatically
       - name: Run tests
         run: bundle exec rake
+
+  typecheck:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: '3.4'
+          bundler-cache: true
+      - name: Run type check
+        run: bundle exec steep check

data/.ruby-version

@@ -1 +1 @@
-ruby-3.0.0
+ruby-4.0.0

data/Gemfile

@@ -2,3 +2,8 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in bech32.gemspec
 gemspec
+
+group :development do
+  gem 'steep'
+  gem 'rbs'
+end

data/README.md

@@ -100,6 +100,34 @@ segwit_addr.addr
 => 'bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4'
 ```
 
+### Silent payment address
+
+Decode silent payment address.
+
+```ruby
+addr = Bech32::SilentPaymentAddr.parse('sp1qqgste7k9hx0qftg6qmwlkqtwuy6cycyavzmzj85c6qdfhjdpdjtdgqjuexzk6murw56suy3e0rd2cgqvycxttddwsvgxe2usfpxumr70xc9pkqwv')
+
+# sp version
+addr.version
+=> 0
+# scan public key
+addr.scan_key
+=> '0220bcfac5b99e04ad1a06ddfb016ee13582609d60b6291e98d01a9bc9a16c96d4'
+# spend public key
+addr.spend_key
+=> '025cc9856d6f8375350e123978daac200c260cb5b5ae83106cab90484dcd8fcf36'
+```
+
+Encode sp address.
+
+```ruby
+addr = Bech32::SilentPaymentAddr.new('sp', 0, '0220bcfac5b99e04ad1a06ddfb016ee13582609d60b6291e98d01a9bc9a16c96d4', '025cc9856d6f8375350e123978daac200c260cb5b5ae83106cab90484dcd8fcf36')
+
+# sp address
+addr.to_s
+=> 'sp1qqgste7k9hx0qftg6qmwlkqtwuy6cycyavzmzj85c6qdfhjdpdjtdgqjuexzk6murw56suy3e0rd2cgqvycxttddwsvgxe2usfpxumr70xc9pkqwv'
+```
+
 ### Nostr
 
 Supports encoding/decoding of Nostr's [NIP-19](https://github.com/nostr-protocol/nips/blob/master/19.md) entities.
@@ -147,22 +175,22 @@ The `encode` command takes `HRP`, `data`, and type (`bech32` or `bech32m`) as ar
     $ bech32 encode genesis 000409190707111719041a120308120a060c161408110d091b090009021b1e1d150e190215010d0a1603091e1f0b100609090d1a1c1a13030c120c0c0f1c020d1d1a0e170b1c17021018121e0a021c121a1c0d161b16131d1609130f1d13180f1e081d041d0a110f110d1313081c11100600180b000c08140c1e130e0f090c160e0018191e1d1c0016060c11101214121e19070d1a0c1c15020414001f10100c09090600181806001809080e180507021913031100030216141b100908160c1213120f1912011f07021c13190d1900170c1d1203040f071c1908050504130e080d0a100d130b03000a0a08191310090918120f11031104120c15180c15120a0f1919070c1c12060c1911091010120a0d191b040c1613020e1911081f000b1a0b0514150c1613010d0c1c030b17011805090119061e0b051e130c00030419000112030110181d011a000f020c0901080c1113060201041a0e1b060a15160506181c11140c1c1d0b1b14020c131e0b0f071519181e0b1f0e0a08170f1d0c05060e1c1b0e160c0f0a171d0b101a1a1f1417160e0d1414030e161b0a000709100d15020c000e010c00000000 bech32
     genesis1qyfe883hey6jrgj2xvk5g3dfmfqfzm7a4wez4pd2krf7ltsxffd6u6nrvjvv0uzda6whtuhzscj72zuj6udkmknakfn0anc07gaya2303dnngu3sxqctqvg5v7nw0fvkwqce7auqkxv3sj5j7e8d6vu4zy5qlssvffxqccxqcfgwc98zenr3qrzk5msfgkvjnj0ejpl8zunedeqhvajry08ueg99ynwgd2sdntrq22gensffcj03r3yjv4cv4j20ee8vujxve3fssj2demyvknzwe3glqt6t954vknpdvurthpc9fpex7t97nvqryeqpjrpscap6q0zvfpgv3nxzpy6wmx24k9xcu35vuatm5zvn7t084ec7tlw2gh0av9xwumwkv02hats66l5hkwd55rwkm2q8fsd4zvqwpvqqqqtdc6rp
 
+Note: `data` must be converted from 8-bit to 5-bit units.
+
 #### Decode
 
 The `decode` command takes bech32/bech32m string as arguments and outputs `HRP`, `data`, and type.
 
     $ bech32 decode genesis1qyfe883hey6jrgj2xvk5g3dfmfqfzm7a4wez4pd2krf7ltsxffd6u6nrvjvv0uzda6whtuhzscj72zuj6udkmknakfn0anc07gaya2303dnngu3sxqctqvg5v7nw0fvkwqce7auqkxv3sj5j7e8d6vu4zy5qlssvffxqccxqcfgwc98zenr3qrzk5msfgkvjnj0ejpl8zunedeqhvajry08ueg99ynwgd2sdntrq22gensffcj03r3yjv4cv4j20ee8vujxve3fssj2demyvknzwe3glqt6t954vknpdvurthpc9fpex7t97nvqryeqpjrpscap6q0zvfpgv3nxzpy6wmx24k9xcu35vuatm5zvn7t084ec7tlw2gh0av9xwumwkv02hats66l5hkwd55rwkm2q8fsd4zvqwpvqqqqtdc6rp
     HRP: genesis
-    DATA: [0, 4, 9, 25, 7, 7, 17, 23, 25, 4, 26, 18, 3, 8, 18, 10, 6, 12, 22, 20, 8, 17, 13, 9, 27, 9, 0, 9, 2, 27, 30, 29, 21, 14, 25, 2, 21, 1, 13, 10, 22, 3, 9, 30, 31, 11, 16, 6, 9, 9, 13, 26, 28, 26, 19, 3, 12, 18, 12, 12, 15, 28, 2, 13, 29, 26, 14, 23, 11, 28, 23, 2, 16, 24, 18, 30, 10, 2, 28, 18, 26, 28, 13, 22, 27, 22, 19, 29, 22, 9, 19, 15, 29, 19, 24, 15, 30, 8, 29, 4, 29, 10, 17, 15, 17, 13, 19, 19, 8, 28, 17, 16, 6, 0, 24, 11, 0, 12, 8, 20, 12, 30, 19, 14, 15, 9, 12, 22, 14, 0, 24, 25, 30, 29, 28, 0, 22, 6, 12, 17, 16, 18, 20, 18, 30, 25, 7, 13, 26, 12, 28, 21, 2, 4, 20, 0, 31, 16, 16, 12, 9, 9, 6, 0, 24, 24, 6, 0, 24, 9, 8, 14, 24, 5, 7, 2, 25, 19, 3, 17, 0, 3, 2, 22, 20, 27, 16, 9, 8, 22, 12, 18, 19, 18, 15, 25, 18, 1, 31, 7, 2, 28, 19, 25, 13, 25, 0, 23, 12, 29, 18, 3, 4, 15, 7, 28, 25, 8, 5, 5, 4, 19, 14, 8, 13, 10, 16, 13, 19, 11, 3, 0, 10, 10, 8, 25, 19, 16, 9, 9, 24, 18, 15, 17, 3, 17, 4, 18, 12, 21, 24, 12, 21, 18, 10, 15, 25, 25, 7, 12, 28, 18, 6, 12, 25, 17, 9, 16, 16, 18, 10, 13, 25, 27, 4, 12, 22, 19, 2, 14, 25, 17, 8, 31, 0, 11, 26, 11, 5, 20, 21, 12, 22, 19, 1, 13, 12, 28, 3, 11, 23, 1, 24, 5, 9, 1, 25, 6, 30, 11, 5, 30, 19, 12, 0, 3, 4, 25, 0, 1, 18, 3, 1, 16, 24, 29, 1, 26, 0, 15, 2, 12, 9, 1, 8, 12, 17, 19, 6, 2, 1, 4, 26, 14, 27, 6, 10, 21, 22, 5, 6, 24, 28, 17, 20, 12, 28, 29, 11, 27, 20, 2, 12, 19, 30, 11, 15, 7, 21, 25, 24, 30, 11, 31, 14, 10, 8, 23, 15, 29, 12, 5, 6, 14, 28, 27, 14, 22, 12, 15, 10, 23, 29, 11, 16, 26, 26, 31, 20, 23, 22, 14, 13, 20, 20, 3, 14, 22, 27, 10, 0, 7, 9, 16, 13, 21, 2, 12, 0, 14, 1, 12, 0, 0, 0, 0]
+    DATA: 000409190707111719041a120308120a060c161408110d091b090009021b1e1d150e190215010d0a1603091e1f0b100609090d1a1c1a13030c120c0c0f1c020d1d1a0e170b1c17021018121e0a021c121a1c0d161b16131d1609130f1d13180f1e081d041d0a110f110d1313081c11100600180b000c08140c1e130e0f090c160e0018191e1d1c0016060c11101214121e19070d1a0c1c15020414001f10100c09090600181806001809080e180507021913031100030216141b100908160c1213120f1912011f07021c13190d1900170c1d1203040f071c1908050504130e080d0a100d130b03000a0a08191310090918120f11031104120c15180c15120a0f1919070c1c12060c1911091010120a0d191b040c1613020e1911081f000b1a0b0514150c1613010d0c1c030b17011805090119061e0b051e130c00030419000112030110181d011a000f020c0901080c1113060201041a0e1b060a15160506181c11140c1c1d0b1b14020c131e0b0f071519181e0b1f0e0a08170f1d0c05060e1c1b0e160c0f0a171d0b101a1a1f1417160e0d1414030e161b0a000709100d15020c000e010c00000000
     TYPE: bech32
 
-Note: `DATA` is not bit-converted.
-
 If bech32 string has segwit hrp, it will also output witness version and witness program:
 
     $ bech32 decode bc1pw508d6qejxtdg4y5r3zarvary0c5xw7kw508d6qejxtdg4y5r3zarvary0c5xw7kt5nd6y
     HRP: bc
-    DATA: [1, 14, 20, 15, 7, 13, 26, 0, 25, 18, 6, 11, 13, 8, 21, 4, 20, 3, 17, 2, 29, 3, 12, 29, 3, 4, 15, 24, 20, 6, 14, 30, 22, 14, 20, 15, 7, 13, 26, 0, 25, 18, 6, 11, 13, 8, 21, 4, 20, 3, 17, 2, 29, 3, 12, 29, 3, 4, 15, 24, 20, 6, 14, 30, 22]
+    DATA: 010e140f070d1a001912060b0d081504140311021d030c1d03040f1814060e1e160e140f070d1a001912060b0d081504140311021d030c1d03040f1814060e1e16
     TYPE: bech32m
     WITNESS VERSION: 1
     WITNESS PROGRAM: 751e76e8199196d454941c45d1b3a323f1433bd6751e76e8199196d454941c45d1b3a323f1433bd6
@@ -171,13 +199,25 @@ If bech32 string has NIP-19 hrp, it will also output NIP-19 entry:
 
     $ bech32 decode nprofile1qqsrhuxx8l9ex335q7he0f09aej04zpazpl0ne2cgukyawd24mayt8gpp4mhxue69uhhytnc9e3k7mgpz4mhxue69uhkg6nzv9ejuumpv34kytnrdaksjlyr9p
     HRP: nprofile
-    DATA: [0, 0, 16, 3, 23, 28, 6, 6, 7, 31, 5, 25, 6, 17, 17, 20, 0, 30, 23, 25, 15, 9, 15, 5, 29, 25, 18, 15, 21, 2, 1, 29, 2, 1, 31, 15, 19, 25, 10, 24, 8, 28, 22, 4, 29, 14, 13, 10, 21, 27, 29, 4, 11, 7, 8, 1, 1, 21, 27, 23, 6, 28, 25, 26, 5, 28, 23, 23, 4, 11, 19, 24, 5, 25, 17, 22, 30, 27, 8, 1, 2, 21, 27, 23, 6, 28, 25, 26, 5, 28, 23, 22, 8, 26, 19, 2, 12, 5, 25, 18, 28, 28, 27, 1, 12, 17, 21, 22, 4, 11, 19, 3, 13, 29, 22, 16]
+    DATA: 00001003171c0606071f051906111114001e17190f090f051d19120f1502011d02011f0f13190a18081c16041d0e0d0a151b1d040b07080101151b17061c191a051c1717040b1318051911161e1b080102151b17061c191a051c1716081a13020c0519121c1c1b010c111516040b13030d1d1610
     TYPE: bech32
     NIP19 Entities:
       special: 3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d
       relay: wss://r.x.com
       relay: wss://djbas.sadkb.com
 
+If sp address, it will also output scan/spend public key:
+
+    $ bech32 decode sp1qqgste7k9hx0qftg6qmwlkqtwuy6cycyavzmzj85c6qdfhjdpdjtdgqjuexzk6murw56suy3e0rd2cgqvycxttddwsvgxe2usfpxumr70xc9pkqwv
+    HRP: sp
+    DATA: 000008100b191e160517060f00090b081a001b0e1f16000b0e1c041a180418041d0c021b02120714181a000d0917120d010d120b0d0800121c190602161a1b1c030e141a101c0411190f030d0a1808000c0418060b0b0d0d0e100c0806190a1c100901061c1b031e0f0618
+    TYPE: bech32m
+    version: 0
+    scan public key: 0220bcfac5b99e04ad1a06ddfb016ee13582609d60b6291e98d01a9bc9a16c96d4
+    spend public key: 025cc9856d6f8375350e123978daac200c260cb5b5ae83106cab90484dcd8fcf36
+
+Note: `DATA` is data without bit conversion. When used, the `DATA` must be converted from 5-bit to 8-bit and padded as necessary.
+
 ## License
 
 The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

data/Steepfile

@@ -0,0 +1,19 @@
+# Steepfile
+target :lib do
+  signature "sig"
+
+  check "lib"
+
+  library "stringio"
+
+  # Configure diagnostic severity
+  # These errors are from Ruby code patterns that are runtime-safe but hard to express in RBS
+  configure_code_diagnostics do |hash|
+    # Suppress errors for method calls on potentially nil values
+    # The actual code handles nil cases properly at runtime
+    hash[Steep::Diagnostic::Ruby::NoMethod] = :hint
+    hash[Steep::Diagnostic::Ruby::ArgumentTypeMismatch] = :hint
+    hash[Steep::Diagnostic::Ruby::MethodBodyTypeMismatch] = :hint
+    hash[Steep::Diagnostic::Ruby::UnannotatedEmptyCollection] = :hint
+  end
+end

data/bech32.gemspec

@@ -13,8 +13,10 @@ Gem::Specification.new do |spec|
   spec.description   = %q(The implementation of Bech32 encoder and decoder.)
   spec.homepage      = 'https://github.com/azuchi/bech32rb'
   spec.license       = 'MIT'
+  spec.metadata      = { 'rubygems_mfa_required' => 'true' }
 
   spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.files         += Dir['sig/**/*.rbs']
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']

data/exe/bech32

@@ -25,13 +25,14 @@ class CLI < Thor
         DATA: #{data.pack('C*').unpack1('H*')}
         TYPE: #{spec == Bech32::Encoding::BECH32 ? 'bech32' : 'bech32m'}
       EOS
-      if [Bech32::SegwitAddr::HRP_MAINNET, Bech32::SegwitAddr::HRP_TESTNET, Bech32::SegwitAddr::HRP_REGTEST].include?(hrp)
+      case hrp
+      when Bech32::SegwitAddr::HRP_MAINNET, Bech32::SegwitAddr::HRP_TESTNET, Bech32::SegwitAddr::HRP_REGTEST
         addr = Bech32::SegwitAddr.new(bech32_str)
         puts <<~EOS
           WITNESS VERSION: #{addr.ver}
           WITNESS PROGRAM: #{addr.prog.pack('C*').unpack1('H*')}
         EOS
-      elsif Bech32::Nostr::NIP19::ALL_PREFIXES.include?(hrp)
+      when *Bech32::Nostr::NIP19::ALL_PREFIXES
         entity = Bech32::Nostr::NIP19.decode(bech32_str)
         if entity.is_a?(Bech32::Nostr::BareEntity)
           puts <<~EOS
@@ -43,6 +44,13 @@ class CLI < Thor
             puts "  #{entry.to_s}"
           end
         end
+      when Bech32::SilentPaymentAddr::HRP_MAINNET, Bech32::SilentPaymentAddr::HRP_TESTNET
+        addr = Bech32::SilentPaymentAddr.parse(bech32_str)
+        puts <<~EOS
+          version: #{addr.version}
+          scan public key: #{addr.scan_key}
+          spend public key: #{addr.spend_key}
+        EOS
       end
     else
       puts 'Can not decode.'

data/lib/bech32/nostr/entity.rb

@@ -110,37 +110,42 @@ module Bech32
         buf = ::StringIO.new(data)
         entries = []
         until buf.eof?
-          type, len = buf.read(2).unpack('CC')
+          header = buf.read(2)
+          raise ArgumentError, "Invalid TLV: truncated header." if header.nil? || header.bytesize < 2
+          type, len = header.unpack('CC')
+          value = buf.read(len)
+          raise ArgumentError, "Invalid TLV: truncated value." if value.nil? ? len > 0 : value.bytesize < len
+          value ||= ''
           case type
           when TYPE_SPECIAL # special
             case hrp
             when NIP19::HRP_PROFILE
-              entries << TLVEntry.new(type, buf.read(len).unpack1('H*'), 'pubkey')
+              entries << TLVEntry.new(type, value.unpack1('H*'), 'pubkey')
             when NIP19::HRP_RELAY
-              entries << TLVEntry.new(type, buf.read(len), 'relay')
+              entries << TLVEntry.new(type, value, 'relay')
             when NIP19::HRP_EVENT
-              entries << TLVEntry.new(type, buf.read(len).unpack1('H*'), 'id')
+              entries << TLVEntry.new(type, value.unpack1('H*'), 'id')
             when NIP19::HRP_EVENT_COORDINATE
-              entries << TLVEntry.new(type, buf.read(len), 'identifier')
+              entries << TLVEntry.new(type, value, 'identifier')
             end
           when TYPE_RELAY # relay
             case hrp
             when NIP19::HRP_PROFILE, NIP19::HRP_EVENT, NIP19::HRP_EVENT_COORDINATE
-              entries << TLVEntry.new(type, buf.read(len), 'relay')
+              entries << TLVEntry.new(type, value, 'relay')
             else
               raise ArgumentError, "Type: #{type} does not supported for HRP: #{hrp}"
             end
           when TYPE_AUTHOR # author
             case hrp
             when NIP19::HRP_EVENT, NIP19::HRP_EVENT_COORDINATE
-              entries << TLVEntry.new(type, buf.read(len).unpack1('H*'), 'author')
+              entries << TLVEntry.new(type, value.unpack1('H*'), 'author')
             else
               raise ArgumentError, "Type: #{type} does not supported for HRP: #{hrp}"
             end
           when TYPE_KIND # kind
             case hrp
             when NIP19::HRP_EVENT, NIP19::HRP_EVENT_COORDINATE
-              entries << TLVEntry.new(type, buf.read(len).unpack1('H*').to_i(16), 'kind')
+              entries << TLVEntry.new(type, value.unpack1('H*').to_s.to_i(16), 'kind')
             else
               raise ArgumentError, "Type: #{type} does not supported for HRP: #{hrp}"
             end

data/lib/bech32/nostr/nip19.rb

@@ -28,7 +28,9 @@ module Bech32
         raise ArgumentError, 'Invalid nip19 string.' if hrp.nil?
         raise ArgumentError, 'Invalid bech32 spec.' unless spec == Bech32::Encoding::BECH32
 
-        entity = Bech32.convert_bits(data, 5, 8, false).pack('C*')
+        converted = Bech32.convert_bits(data, 5, 8, false)
+        raise ArgumentError, 'Invalid data.' if converted.nil?
+        entity = converted.pack('C*')
         raise ArgumentError, "Data whose HRP is #{hrp} must be 32 bytes." if BARE_PREFIXES.include?(hrp) && entity.bytesize != 32
         if BARE_PREFIXES.include?(hrp)
           BareEntity.new(hrp, entity.unpack1('H*'))

data/lib/bech32/silent_payment_addr.rb

@@ -0,0 +1,59 @@
+module Bech32
+  # BIP-352 silent payment address.
+  # https://github.com/bitcoin/bips/blob/master/bip-0352.mediawiki#user-content-Address_encoding
+  class SilentPaymentAddr
+    HRP_MAINNET = 'sp'
+    HRP_TESTNET = 'tsp'
+
+    attr_reader :hrp
+    attr_reader :version
+    attr_reader :scan_key
+    attr_reader :spend_key
+
+    # Constructor
+    # @param [String] hrp HRP for silent payment address.
+    # @param [Integer] version The version of sp address.
+    # @param [String] scan_key The scan public key with hex format.
+    # @param [String] spend_key The spend public key with hex format.
+    def initialize(hrp, version, scan_key, spend_key)
+      raise ArgumentError, "hrp must be sp or tsp." unless [HRP_MAINNET, HRP_TESTNET].include?(hrp)
+      raise ArgumentError, "version must be Integer." unless version.is_a?(Integer)
+      raise ArgumentError, "scan_key must be String." unless scan_key.is_a?(String)
+      raise ArgumentError, "spend_key must be String." unless spend_key.is_a?(String)
+      raise ArgumentError, 'scan_key must be 33 bytes.' unless [scan_key].pack('H*').bytesize == 33
+      raise ArgumentError, 'spend_key must be 33 bytes.' unless [spend_key].pack('H*').bytesize == 33
+      @hrp = hrp
+      @version = version
+      @scan_key = scan_key
+      @spend_key = spend_key
+    end
+
+    # Parse silent payment address.
+    # @param [String] addr Silent payment address.
+    # @return [Bech32::SilentPaymentAddr]
+    # @raise [ArgumentError]
+    def self.parse(addr)
+      raise ArgumentError, "addr must be String." unless addr.is_a?(String)
+      hrp, data, spec = Bech32.decode(addr, addr.length)
+      raise ArgumentError, "addr must be encoded with bech32m." unless spec == Bech32::Encoding::BECH32M
+      raise ArgumentError, 'Invalid hrp.' if hrp.nil? || data[0].nil? || ![HRP_MAINNET, HRP_TESTNET].include?(hrp)
+      version = data[0]
+      converted = Bech32.convert_bits(data[1..-1], 5, 8, false)
+      raise ArgumentError, "Invalid data." if converted.nil?
+      keys = converted.pack('C*').unpack1('H*')
+      raise ArgumentError, "Invalid key size." unless keys.length == 132
+      scan = keys[0...66]
+      spend = keys[66..-1]
+      Bech32::SilentPaymentAddr.new(hrp, version, scan, spend)
+    end
+
+    # Get silent payment address.
+    # @return [String]
+    def to_s
+      keys = scan_key + spend_key
+      data = [keys].pack('H*').unpack('C*')
+      Bech32.encode(hrp, [version] + Bech32.convert_bits(data, 8, 5), Bech32::Encoding::BECH32M)
+    end
+
+  end
+end

data/lib/bech32/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Bech32
-  VERSION = '1.4.2'
+  VERSION = '1.5.1'
 end

data/lib/bech32.rb

@@ -7,6 +7,7 @@ module Bech32
 
   autoload :SegwitAddr, 'bech32/segwit_addr'
   autoload :Nostr, 'bech32/nostr'
+  autoload :SilentPaymentAddr, 'bech32/silent_payment_addr'
 
   SEPARATOR = '1'
 
@@ -49,7 +50,7 @@ module Bech32
     bech = bech.downcase
     # check data length
     pos = bech.rindex(SEPARATOR)
-    return nil if pos.nil? || pos + 7 > bech.length || bech.length > max_length
+    return nil if pos.nil? || pos < 1 || pos + 7 > bech.length || bech.length > max_length
     # check valid charset
     bech[pos+1..-1].each_char{|c|return nil unless CHARSET.include?(c)}
     # split hrp and data

data/sig/bech32/bech32.rbs

@@ -0,0 +1,45 @@
+module Bech32
+  VERSION: String
+
+  module Encoding
+    BECH32: Integer
+    BECH32M: Integer
+  end
+
+  SEPARATOR: String
+  CHARSET: Array[String]
+  BECH32M_CONST: Integer
+
+  # Encode hrp and data to bech32/bech32m string.
+  def self.encode: (String hrp, Array[Integer] data, Integer spec) -> String
+
+  # Decode bech32/bech32m string. Returns nil if invalid.
+  def self.decode: (String bech, ?Integer max_length) -> [String, Array[Integer], Integer]?
+
+  # Convert bits from one base to another.
+  def self.convert_bits: (Array[Integer] data, Integer from, Integer to, ?bool padding) -> Array[Integer]?
+
+  # Create checksum for hrp and data.
+  def self.create_checksum: (String hrp, Array[Integer] data, Integer spec) -> Array[Integer]
+
+  # Verify checksum. Returns encoding spec if valid, nil otherwise.
+  def self.verify_checksum: (String hrp, Array[Integer] data) -> Integer?
+
+  # module_function methods are also available as instance methods
+  def encode: (String hrp, Array[Integer] data, Integer spec) -> String
+  def decode: (String bech, ?Integer max_length) -> [String, Array[Integer], Integer]?
+  def convert_bits: (Array[Integer] data, Integer from, Integer to, ?bool padding) -> Array[Integer]?
+  def create_checksum: (String hrp, Array[Integer] data, Integer spec) -> Array[Integer]
+  def verify_checksum: (String hrp, Array[Integer] data) -> Integer?
+
+  private
+
+  # Expand HRP for checksum computation.
+  def self.expand_hrp: (String hrp) -> Array[Integer]
+
+  # Compute polymod checksum.
+  def self.polymod: (Array[Integer] values) -> Integer
+
+  def expand_hrp: (String hrp) -> Array[Integer]
+  def polymod: (Array[Integer] values) -> Integer
+end

data/sig/bech32/nostr/entity.rbs

@@ -0,0 +1,54 @@
+module Bech32
+  module Nostr
+    class BareEntity
+      attr_reader hrp: String
+      attr_reader data: String
+
+      # Initialize bare entity.
+      def initialize: (String hrp, String data) -> void
+
+      # Encode to bech32 string.
+      def encode: () -> String
+    end
+
+    class TLVEntry
+      attr_reader type: Integer
+      attr_reader label: String?
+      attr_reader value: String | Integer
+
+      # Initialize TLV entry.
+      def initialize: (Integer type, String | Integer value, ?String? label) -> void
+
+      # Convert to binary payload.
+      def to_payload: () -> String
+
+      # String representation.
+      def to_s: () -> String
+
+      private
+
+      # Check if string is hex encoded.
+      def hex_string?: (String str) -> bool
+    end
+
+    class TLVEntity
+      TYPE_SPECIAL: Integer
+      TYPE_RELAY: Integer
+      TYPE_AUTHOR: Integer
+      TYPE_KIND: Integer
+      TYPES: Array[Integer]
+
+      attr_reader hrp: String
+      attr_reader entries: Array[TLVEntry]
+
+      # Initialize TLV entity.
+      def initialize: (String hrp, Array[TLVEntry] entries) -> void
+
+      # Parse TLV entity from binary data.
+      def self.parse: (String hrp, String data) -> TLVEntity
+
+      # Encode to bech32 string.
+      def encode: () -> String
+    end
+  end
+end

data/sig/bech32/nostr/nip19.rbs

@@ -0,0 +1,23 @@
+module Bech32
+  module Nostr
+    module NIP19
+      HRP_PUBKEY: String
+      HRP_PRIVATE_KEY: String
+      HRP_NOTE_ID: String
+      HRP_PROFILE: String
+      HRP_EVENT: String
+      HRP_RELAY: String
+      HRP_EVENT_COORDINATE: String
+
+      BARE_PREFIXES: Array[String]
+      TLV_PREFIXES: Array[String]
+      ALL_PREFIXES: Array[String]
+
+      # Decode NIP-19 bech32 string.
+      def self.decode: (String string) -> (BareEntity | TLVEntity)
+
+      # module_function methods are also available as instance methods
+      def decode: (String string) -> (BareEntity | TLVEntity)
+    end
+  end
+end

data/sig/bech32/segwit_addr.rbs

@@ -0,0 +1,28 @@
+module Bech32
+  class SegwitAddr
+    HRP_MAINNET: String
+    HRP_TESTNET: String
+    HRP_REGTEST: String
+
+    attr_accessor hrp: String
+    attr_accessor ver: Integer?
+    attr_accessor prog: Array[Integer]?
+
+    # Initialize SegwitAddr. Optionally parse from address string.
+    def initialize: (?String? addr) -> void
+
+    # Generate script pubkey from witness version and program.
+    def to_script_pubkey: () -> String
+
+    # Parse script pubkey into witness version and program.
+    def script_pubkey=: (String script_pubkey) -> void
+
+    # Generate bech32/bech32m address string.
+    def addr: () -> String
+
+    private
+
+    # Parse address string into hrp, version and program.
+    def parse_addr: (String addr) -> void
+  end
+end

data/sig/bech32/silent_payment_addr.rbs

@@ -0,0 +1,21 @@
+module Bech32
+  # BIP-352 silent payment address.
+  class SilentPaymentAddr
+    HRP_MAINNET: String
+    HRP_TESTNET: String
+
+    attr_reader hrp: String
+    attr_reader version: Integer
+    attr_reader scan_key: String
+    attr_reader spend_key: String
+
+    # Initialize SilentPaymentAddr.
+    def initialize: (String hrp, Integer version, String scan_key, String spend_key) -> void
+
+    # Parse silent payment address string.
+    def self.parse: (String addr) -> SilentPaymentAddr
+
+    # Generate silent payment address string.
+    def to_s: () -> String
+  end
+end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: bech32
 version: !ruby/object:Gem::Version
-  version: 1.4.2
+  version: 1.5.1
 platform: ruby
 authors:
 - Shigeyuki Azuchi
-autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-08-28 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -70,6 +69,7 @@ files:
 - LICENSE.txt
 - README.md
 - Rakefile
+- Steepfile
 - bech32.gemspec
 - bin/console
 - bin/setup
@@ -79,12 +79,18 @@ files:
 - lib/bech32/nostr/entity.rb
 - lib/bech32/nostr/nip19.rb
 - lib/bech32/segwit_addr.rb
+- lib/bech32/silent_payment_addr.rb
 - lib/bech32/version.rb
+- sig/bech32/bech32.rbs
+- sig/bech32/nostr/entity.rbs
+- sig/bech32/nostr/nip19.rbs
+- sig/bech32/segwit_addr.rbs
+- sig/bech32/silent_payment_addr.rbs
 homepage: https://github.com/azuchi/bech32rb
 licenses:
 - MIT
-metadata: {}
-post_install_message: 
+metadata:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -99,8 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
-signing_key: 
+rubygems_version: 4.0.3
 specification_version: 4
 summary: The implementation of Bech32 encoder and decoder.
 test_files: []