bech32 1.3.0 → 1.4.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b9dfad105c52c27a05e99b0576a46de13aac736914b8172b59766e393531857e
-  data.tar.gz: bdadf23d8b3ea58fbbc6c303ca657e6d151d4096cbb6dfc260d105c2d5b5869e
+  metadata.gz: c5c153cf694b5bcfc8e09c9aff4439771137dbb558ef082e05f6330763c3eda4
+  data.tar.gz: a7397025e69d847ab649a9f276bf0582d11c1f70ab447b60fd1073fdec6c8c63
 SHA512:
-  metadata.gz: 17c8acca310a4ebc24ba5e4b4f58132d79262ca73d6ebbe6b50952b2f0703c70b915b28500d866af86d3b9f715afdc614ddc2af9feb07d6de5fb16fff68dc16e
-  data.tar.gz: ae1ad3dd861bed9849878241ae9edac81d26980a4cf8a6e911ecb36b7bdc547756404347232aff5608d4b9f24d2b0f6ecfc0e6476c6f37855bfbc2ff0410a8e9
+  metadata.gz: 9619a2d66ee0f18b6ef974365cba1a2475506a25a369ff6a426b034ed1eae01b1a6566c572481019ec84e2fcf34f0dae143a8d6a8edbb9d27e0bf343f1d4180f
+  data.tar.gz: 22550c98747a96c87eb9007ad8e6f99730f7e205574afddd97b296c5338dfc91bd50618ab012853bde479ceea86bc93ff8bfb056555401d2bf5a7de86d433373

data/.github/workflows/main.yml

@@ -19,15 +19,14 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        ruby-version: ['2.6', '2.7', '3.0']
+        ruby-version: ['3.0', '3.1', '3.2']
 
     steps:
       - uses: actions/checkout@v2
       - 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):
-        # uses: ruby/setup-ruby@v1
-        uses: ruby/setup-ruby@473e4d8fe5dd94ee328fdfca9f8c9c7afc9dae5e
+        uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.ruby-version }}
           bundler-cache: true # runs 'bundle install' and caches installed gems automatically

data/README.md

@@ -1,4 +1,4 @@
-# Bech32 [![Build Status](https://travis-ci.org/azuchi/bech32rb.svg?branch=master)](https://travis-ci.org/azuchi/bech32rb) [![Gem Version](https://badge.fury.io/rb/bech32.svg)](https://badge.fury.io/rb/bech32) [![MIT License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE) <img src="http://segwit.co/static/public/images/logo.png" width="100">
+# Bech32 [![Build Status](https://github.com/azuchi/bech32rb/actions/workflows/main.yml/badge.svg?branch=master)](https://github.com/azuchi/bech32rb/actions/workflows/main.yml) [![Gem Version](https://badge.fury.io/rb/bech32.svg)](https://badge.fury.io/rb/bech32) [![MIT License](http://img.shields.io/badge/license-MIT-blue.svg?style=flat)](LICENSE) <img src="http://segwit.co/static/public/images/logo.png" width="100">
 
 The implementation of the Bech32/Bech32m encoder and decoder for Ruby.
 
@@ -50,17 +50,6 @@ hrp, data, spec = Bech32.decode('BC1QW508D6QEJXTDG4Y5R3ZARVARY0C5XW7KV8F3T4')
 # spec is whether Bech32::Encoding::BECH32 or Bech32::Encoding::BECH32M
 ```
 
-Decode Bech32-encoded Segwit address into `Bech32::SegwitAddr` instance.
-
-```ruby
-addr = 'BC1QW508D6QEJXTDG4Y5R3ZARVARY0C5XW7KV8F3T4'
-segwit_addr = Bech32::SegwitAddr.new(addr)
-
-# generate script pubkey
-segwit_addr.to_script_pubkey
-=> 0014751e76e8199196d454941c45d1b3a323f1433bd6
-```
-
 #### Advanced
 
 The maximum number of characters of Bech32 defined in [BIP-173](https://github.com/bitcoin/bips/blob/master/bip-0173.mediawiki) is limited to 90 characters.
@@ -84,7 +73,20 @@ hrp = 'bc'
 data = [0, 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]
 
 bech = Bech32.encode(hrp, data, Bech32::Encoding::BECH32)
-=> bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4
+=> 'bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4'
+```
+
+### Segwit
+
+Decode Bech32-encoded Segwit address into `Bech32::SegwitAddr` instance.
+
+```ruby
+addr = 'BC1QW508D6QEJXTDG4Y5R3ZARVARY0C5XW7KV8F3T4'
+segwit_addr = Bech32::SegwitAddr.new(addr)
+
+# generate script pubkey
+segwit_addr.to_script_pubkey
+=> '0014751e76e8199196d454941c45d1b3a323f1433bd6'
 ```
 
 Encode Segwit script into Bech32 Segwit address.
@@ -95,7 +97,43 @@ segwit_addr.script_pubkey = '0014751e76e8199196d454941c45d1b3a323f1433bd6'
 
 # generate addr
 segwit_addr.addr
-=> bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4
+=> 'bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4'
+```
+
+### Nostr
+
+Supports encoding/decoding of Nostr's [NIP-19](https://github.com/nostr-protocol/nips/blob/master/19.md) entities.
+
+```ruby
+# Decode bare entity
+bech32 = 'npub10elfcs4fr0l0r8af98jlmgdh9c8tcxjvz9qkw038js35mp4dma8qzvjptg'
+entity = Bech32::Nostr::NIP19.parse(bech32)
+entity.hrp
+=> 'npub'
+entity.data
+=> '7e7e9c42a91bfef19fa929e5fda1b72e0ebc1a4c1141673e2794234d86addf4e'
+
+# Decode tlv entity
+bech32 = 'nprofile1qqsrhuxx8l9ex335q7he0f09aej04zpazpl0ne2cgukyawd24mayt8gpp4mhxue69uhhytnc9e3k7mgpz4mhxue69uhkg6nzv9ejuumpv34kytnrdaksjlyr9p'
+entity = Bech32::Nostr::NIP19.parse(bech32)
+entity.hrp
+=> 'nprofile'
+entity.entries[0].value
+=> '3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d'
+entity.entries[1].value
+=> 'wss://r.x.com'
+
+# Encode bare entity
+entity = Bech32::Nostr::BareEntity.new('npub', '7e7e9c42a91bfef19fa929e5fda1b72e0ebc1a4c1141673e2794234d86addf4e')
+entity.encode
+=> 'npub10elfcs4fr0l0r8af98jlmgdh9c8tcxjvz9qkw038js35mp4dma8qzvjptg'
+
+# Encode tlv entity
+entry_relay = Bech32::Nostr::TLVEntry.new(Bech32::Nostr::TLVEntity::TYPE_RELAY, 'wss://relay.nostr.example')
+entry_author = Bech32::Nostr::TLVEntry.new(Bech32::Nostr::TLVEntity::TYPE_AUTHOR, '97c70a44366a6535c145b333f973ea86dfdc2d7a99da618c40c64705ad98e322')
+entity = Bech32::Nostr::TLVEntity.new(Bech32::Nostr::NIP19::HRP_EVENT, [entry_relay, entry_author])
+entity.encode
+=> 'nevent1qyvhwumn8ghj7un9d3shjtnwdaehgu3wv4uxzmtsd3jsygyhcu9ygdn2v56uz3dnx0uh865xmlwz675emfsccsxxguz6mx8rygstv78u'
 ```
 
 ### CLI
@@ -115,8 +153,30 @@ The `decode` command takes bech32/bech32m string as arguments and outputs `HRP`,
 
     $ bech32 decode genesis1qyfe883hey6jrgj2xvk5g3dfmfqfzm7a4wez4pd2krf7ltsxffd6u6nrvjvv0uzda6whtuhzscj72zuj6udkmknakfn0anc07gaya2303dnngu3sxqctqvg5v7nw0fvkwqce7auqkxv3sj5j7e8d6vu4zy5qlssvffxqccxqcfgwc98zenr3qrzk5msfgkvjnj0ejpl8zunedeqhvajry08ueg99ynwgd2sdntrq22gensffcj03r3yjv4cv4j20ee8vujxve3fssj2demyvknzwe3glqt6t954vknpdvurthpc9fpex7t97nvqryeqpjrpscap6q0zvfpgv3nxzpy6wmx24k9xcu35vuatm5zvn7t084ec7tlw2gh0av9xwumwkv02hats66l5hkwd55rwkm2q8fsd4zvqwpvqqqqtdc6rp
     HRP: genesis
-    DATA: 000409190707111719041a120308120a060c161408110d091b090009021b1e1d150e190215010d0a1603091e1f0b100609090d1a1c1a13030c120c0c0f1c020d1d1a0e170b1c17021018121e0a021c121a1c0d161b16131d1609130f1d13180f1e081d041d0a110f110d1313081c11100600180b000c08140c1e130e0f090c160e0018191e1d1c0016060c11101214121e19070d1a0c1c15020414001f10100c09090600181806001809080e180507021913031100030216141b100908160c1213120f1912011f07021c13190d1900170c1d1203040f071c1908050504130e080d0a100d130b03000a0a08191310090918120f11031104120c15180c15120a0f1919070c1c12060c1911091010120a0d191b040c1613020e1911081f000b1a0b0514150c1613010d0c1c030b17011805090119061e0b051e130c00030419000112030110181d011a000f020c0901080c1113060201041a0e1b060a15160506181c11140c1c1d0b1b14020c131e0b0f071519181e0b1f0e0a08170f1d0c05060e1c1b0e160c0f0a171d0b101a1a1f1417160e0d1414030e161b0a000709100d15020c000e010c00000000
+    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]
+    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]
+    TYPE: bech32m
+    WITNESS VERSION: 1
+    WITNESS PROGRAM: 751e76e8199196d454941c45d1b3a323f1433bd6751e76e8199196d454941c45d1b3a323f1433bd6
+
+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]
     TYPE: bech32
+    NIP19 Entities:
+      special: 3bf0c63fcb93463407af97a5e5ee64fa883d107ef9e558472c4eb9aaaefa459d
+      relay: wss://r.x.com
+      relay: wss://djbas.sadkb.com
 
 ## License
 

data/exe/bech32

@@ -18,13 +18,32 @@ class CLI < Thor
 
   desc 'decode "bech32string"', 'Decoding bech32/bech32m string.'
   def decode(bech32_str)
-    bech32 = Bech32.decode(bech32_str, bech32_str.length)
-    if bech32
+    hrp, data, spec = Bech32.decode(bech32_str, bech32_str.length)
+    if hrp
       puts <<~EOS
-        HRP: #{bech32[0]}
-        DATA: #{bech32[1].pack('C*').unpack1('H*')}
-        TYPE: #{bech32[2] == Bech32::Encoding::BECH32 ? 'bech32' : 'bech32m'}
+        HRP: #{hrp}
+        DATA: #{data}
+        TYPE: #{spec == Bech32::Encoding::BECH32 ? 'bech32' : 'bech32m'}
       EOS
+      if [Bech32::SegwitAddr::HRP_MAINNET, Bech32::SegwitAddr::HRP_TESTNET, Bech32::SegwitAddr::HRP_REGTEST].include?(hrp)
+        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)
+        entity = Bech32::Nostr::NIP19.decode(bech32_str)
+        if entity.is_a?(Bech32::Nostr::BareEntity)
+          puts <<~EOS
+            NIP19 Entity: #{entity.data}
+          EOS
+        else
+          puts 'NIP19 Entities:'
+          entity.entries.each do |entry|
+            puts "  #{entry.to_s}"
+          end
+        end
+      end
     else
       puts 'Can not decode.'
     end

data/lib/bech32/nostr/entity.rb

@@ -0,0 +1,163 @@
+module Bech32
+  module Nostr
+    class BareEntity
+      attr_reader :hrp
+      attr_reader :data
+
+      # Initialize bare entity.
+      # @param [String] hrp human-readable part.
+      # @param [String] data Entity data(hex string).
+      def initialize(hrp, data)
+        raise ArgumentError, "HRP #{hrp} is unsupported." unless NIP19::BARE_PREFIXES.include?(hrp)
+        raise ArgumentError, "Data whose HRP is #{hrp} must be 32 bytes." unless [data].pack('H*').bytesize == 32
+        @hrp = hrp
+        @data = data
+      end
+
+      # Encode bare entity to bech32 string.
+      # @return [String] bech32 string.
+      def encode
+        Bech32.encode(hrp, Bech32.convert_bits([data].pack('H*').unpack('C*'), 8, 5), Bech32::Encoding::BECH32)
+      end
+    end
+
+    class TLVEntry
+
+      attr_reader :type
+      attr_reader :label
+      attr_reader :value
+
+      def initialize(type, value, label = nil)
+        raise ArgumentError, "Type #{type} unsupported." unless TLVEntity::TYPES.include?(type)
+
+        @type = type
+        @value = value
+        @label = label
+      end
+
+      # Convert to binary data.
+      # @return [String] binary data.
+      def to_payload
+        data = if value.is_a?(Integer)
+                 [value].pack('N')
+               else
+                 hex_string?(value) ? [value].pack('H*') : value
+               end
+        len = data.bytesize
+        [type, len].pack('CC') + data
+      end
+
+      def to_s
+        type_label = case type
+                     when TLVEntity::TYPE_SPECIAL
+                       'special'
+                     when TLVEntity::TYPE_RELAY
+                       'relay'
+                     when TLVEntity::TYPE_AUTHOR
+                       'author'
+                     when TLVEntity::TYPE_KIND
+                       'kind'
+                     else
+                       'unknown'
+                     end
+        "#{type_label}: #{value}"
+      end
+
+      private
+
+      # Check whether +str+ is hex string or not.
+      # @param [String] str string.
+      # @return [Boolean]
+      def hex_string?(str)
+        return false if str.bytes.any? { |b| b > 127 }
+        return false if str.length % 2 != 0
+        hex_chars = str.chars.to_a
+        hex_chars.all? { |c| c =~ /[0-9a-fA-F]/ }
+      end
+    end
+
+    class TLVEntity
+
+      TYPE_SPECIAL = 0
+      TYPE_RELAY = 1
+      TYPE_AUTHOR = 2
+      TYPE_KIND = 3
+
+      TYPES = [TYPE_SPECIAL, TYPE_RELAY, TYPE_AUTHOR, TYPE_KIND]
+
+      attr_reader :hrp
+      attr_reader :entries
+
+      # Initialize TLV entity.
+      # @param [String] hrp human-readable part.
+      # @param [Array<TLVEntry>] entries TLV entries.
+      # @return [TLVEntity]
+      def initialize(hrp, entries)
+        raise ArgumentError, "HRP #{hrp} is unsupported." unless NIP19::TLV_PREFIXES.include?(hrp)
+        entries.each do |e|
+          raise ArgumentError, "Entries must be TLVEntry. #{e.class} given." unless e.is_a?(TLVEntry)
+        end
+
+        @hrp = hrp
+        @entries = entries
+      end
+
+      # Parse TLV entity from data.
+      # @param [String] hrp human-readable part.
+      # @param [String] data Entity data(binary format).
+      # @return [TLVEntity]
+      def self.parse(hrp, data)
+        buf = ::StringIO.new(data)
+        entries = []
+        until buf.eof?
+          type, len = buf.read(2).unpack('CC')
+          case type
+          when TYPE_SPECIAL # special
+            case hrp
+            when NIP19::HRP_PROFILE
+              entries << TLVEntry.new(type, buf.read(len).unpack1('H*'), 'pubkey')
+            when NIP19::HRP_RELAY
+              entries << TLVEntry.new(type, buf.read(len), 'relay')
+            when NIP19::HRP_EVENT
+              entries << TLVEntry.new(type, buf.read(len).unpack1('H*'), 'id')
+            when NIP19::HRP_EVENT_COORDINATE
+              entries << TLVEntry.new(type, buf.read(len), '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')
+            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')
+            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')
+            else
+              raise ArgumentError, "Type: #{type} does not supported for HRP: #{hrp}"
+            end
+          else
+            raise ArgumentError, "Unknown TLV type: #{type}"
+          end
+        end
+
+        TLVEntity.new(hrp, entries)
+      end
+
+      # Encode tlv entity to bech32 string.
+      # @return [String] bech32 string.
+      def encode
+        data = entries.map(&:to_payload).join
+        Bech32.encode(hrp, Bech32.convert_bits(data.unpack('C*'), 8, 5), Bech32::Encoding::BECH32)
+      end
+    end
+  end
+end

data/lib/bech32/nostr/nip19.rb

@@ -0,0 +1,44 @@
+require "stringio"
+
+module Bech32
+  module Nostr
+    module NIP19
+
+      HRP_PUBKEY = 'npub'
+      HRP_PRIVATE_KEY = 'nsec'
+      HRP_NOTE_ID = 'note'
+      HRP_PROFILE = 'nprofile'
+      HRP_EVENT = 'nevent'
+      HRP_RELAY = 'nrelay'
+      HRP_EVENT_COORDINATE = 'naddr'
+
+      BARE_PREFIXES = [HRP_PUBKEY, HRP_PRIVATE_KEY, HRP_NOTE_ID]
+      TLV_PREFIXES = [HRP_PROFILE, HRP_EVENT, HRP_RELAY, HRP_EVENT_COORDINATE]
+      ALL_PREFIXES = BARE_PREFIXES + TLV_PREFIXES
+
+      module_function
+
+      # Decode nip19 string.
+      # @param [String] string Bech32 string.
+      # @return [BareEntity]
+      # @return [TLVEntity]
+      def decode(string)
+        hrp, data, spec = Bech32.decode(string, string.length)
+
+        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*')
+        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*'))
+        elsif TLV_PREFIXES.include?(hrp)
+          TLVEntity.parse(hrp, entity)
+        else
+          raise ArgumentError, "HRP #{hrp} is unsupported."
+        end
+      end
+
+    end
+  end
+end

data/lib/bech32/nostr.rb

@@ -0,0 +1,8 @@
+module Bech32
+  module Nostr
+    autoload :NIP19, 'bech32/nostr/nip19'
+    autoload :BareEntity, 'bech32/nostr/entity'
+    autoload :TLVEntity, 'bech32/nostr/entity'
+  end
+
+end

data/lib/bech32/version.rb

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

data/lib/bech32.rb

@@ -6,6 +6,7 @@ module Bech32
   end
 
   autoload :SegwitAddr, 'bech32/segwit_addr'
+  autoload :Nostr, 'bech32/nostr'
 
   SEPARATOR = '1'
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bech32
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.4.1
 platform: ruby
 authors:
 - Shigeyuki Azuchi
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2022-10-28 00:00:00.000000000 Z
+date: 2023-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -75,6 +75,9 @@ files:
 - bin/setup
 - exe/bech32
 - lib/bech32.rb
+- lib/bech32/nostr.rb
+- lib/bech32/nostr/entity.rb
+- lib/bech32/nostr/nip19.rb
 - lib/bech32/segwit_addr.rb
 - lib/bech32/version.rb
 homepage: https://github.com/azuchi/bech32rb