meshname 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 63aa6e751f1fca620263c8d8b1042d30ec76ec27f32fd0277bcb511d198460b6
+  data.tar.gz: ec3648959620b1256de293e00301dc1c32be965e03d074c979e604f10acb7fd6
+SHA512:
+  metadata.gz: 38469da161ca43477ee054bf7aa0a029b18b75392817ae8f8a9431511589e7a146a3bdb15f9323abc01ca3ba0a5d4a8c3579f151cc68a3ebdc3070f9d2bda7b0
+  data.tar.gz: eaca21e8c6a02a868fa7d5fa2951272e557a6c4629159e510b33ae482fc3b453c7a1ad4f72d98151140e562c2351a430e65cf6e7a79e64f41d77d79f7aa07da5

data/lib/meshname.rb

@@ -0,0 +1,86 @@
+
+require "resolv"
+require "ipaddr"
+require "base32"
+
+module Meshname
+  
+  # Calculates a meshname from an IPv6 address (without .meshname)
+  #
+  # @param ipv6 [IPAddr]
+  # @return [String]
+  # @example
+  #   Meshname.getname IPAddr.new("215:15c:84e0:8dd5:7590:bfcd:61cf:cff7") => "aikqcxee4cg5k5mqx7gwdt6p64"
+  # @example Create a .nameip domain
+  #   "#{Meshname.getname IPAddr.new("215:15c:84e0:8dd5:7590:bfcd:61cf:cff7")}.meship" => "aikqcxee4cg5k5mqx7gwdt6p64.meship"
+  def self.getname ipv6
+    # convert IPv6 to 16 bytes
+    ipv6_binary = ipv6.hton
+    # encode the 16 bytes (base32)
+    meshname = Base32.encode ipv6_binary
+    # delete padding and convert up in down letters
+    meshname.delete! "="
+    meshname.downcase!
+    
+    return meshname
+  end
+  
+  # Calculates an IPv6 address from a Meshname (without .meshname)
+  # Links are not triggered. The mesh name is treated like a .meship domain.
+  #
+  # @param meshname [String]
+  # @return [IPAddr]
+  # @example
+  #   Meshname.getip "aikqcxee4cg5k5mqx7gwdt6p64" => #<IPAddr: IPv6:0215:015c:84e0:8dd5:7590:bfcd:61cf:cff7/ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff>
+  #   Meshname.getip("aikqcxee4cg5k5mqx7gwdt6p64").to_s => "215:15c:84e0:8dd5:7590:bfcd:61cf:cff7"
+  def self.getip meshname
+    # decode the meshname to 16 bytes
+    ipv6_binary = Base32.decode meshname.upcase
+    # convert the 16 bytes to a ipv6
+    ipv6 = IPAddr.new_ntoh ipv6_binary
+    return ipv6
+  end
+  
+  # Resolves a .meshname or .meship domain. Links are taken into account.
+  # 
+  # An array of IP addresses (type: IPAddr) is always returned.
+  # The reason for the array is that a name server can store several AAAA records
+  # for a domain name. In order to keep the result the same,
+  # an array is always returned with a .meship domain,
+  # but this then only contains one entry.
+  #
+  # @param domain [String]
+  # @return [Array] Array of IPAddr
+  # @example Resolv a .meship domain
+  #   Meshname.resolv("aikqcxee4cg5k5mqx7gwdt6p64.meship") => [#<IPAddr: IPv6:0215:015c:84e0:8dd5:7590:bfcd:61cf:cff7/ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff>]
+  #   Meshname.resolv("aikqcxee4cg5k5mqx7gwdt6p64.meship")[0].to_s => "215:15c:84e0:8dd5:7590:bfcd:61cf:cff7"
+  # @example Resolv a .meshname domain
+  #   Meshname.resolv("aikqcxee4cg5k5mqx7gwdt6p64.meshname") => [#<IPAddr: IPv6:0215:015c:84e0:8dd5:7590:bfcd:61cf:cff7/ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff>]
+  #   Meshname.resolv("aikqcxee4cg5k5mqx7gwdt6p64.meshname")[0].to_s => "215:15c:84e0:8dd5:7590:bfcd:61cf:cff7"
+  def self.resolv domain
+    parts = domain.split "."
+    case parts[-1]
+    when "meshname"  # case meshname
+      
+      # for decoding meshname remove .meshname tld
+      dns_server_meshname = domain.delete_suffix ".#{parts[-1]}"
+      
+      # meshname to ipv6 address
+      dns_server = self.getip dns_server_meshname
+      
+      # create DNSResolver for using custom nameserver
+      dns_resolver = Resolv::DNS.new :nameserver => [dns_server.to_s]
+      # request nameserver for domain (that's why also subdomains possible)
+      ip = dns_resolver.getaddresses domain
+      # transform Resolv::IPv6 to IPAddr
+      ip.map! { |record|
+        IPAddr.new_ntoh record.address
+      }
+      return ip
+      
+    when "meship"  # case meship
+      return [self.getip(parts[-2])]
+    end
+  end
+  
+end

metadata

@@ -0,0 +1,59 @@
+--- !ruby/object:Gem::Specification
+name: meshname
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Marek Kuethe
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2022-01-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: base32
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.4
+description: Gem, which provides conversion and DNS resolution functions for the Meshname
+  protocol (see https://github.com/zhoreeq/meshname)
+email: m.k@mk16.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/meshname.rb
+homepage: https://github.com/marek22k/meshname
+licenses:
+- GPL-3.0-or-later
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.4
+signing_key: 
+specification_version: 4
+summary: Gem, which provides conversion and DNS resolution functions for the Meshname
+  protocol.
+test_files: []