ethname 0.0.1 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 450342f14ab626b337ad859811381f4185a11cfd805a887fb628be35427c6549
-  data.tar.gz: 45b92de48f56083fad1e94975f1dfb58f7afeb4d64ee55a12650104ae87372af
+  metadata.gz: 72d207eabf6a744e375ae0846031daff0dc1ae5cf5511b0186f8b6a5f2c80966
+  data.tar.gz: b4b10c781ca9d6e0f018c2b09dbaec9342aa0bffab3a76a2dd99957a70b23658
 SHA512:
-  metadata.gz: 6e37ff7f85701c927c9f5fb8f78b8174b003f7a521f1e6d705c565f919f1d437d5b467ac044484379a45be52669de8cb427b45cf4f3c02b31c75fa313c1eddbc
-  data.tar.gz: 0bcee46cf8ebb0b33de5e85c9ce93e7fc9b1dd33a40a6a771b92d99943362ef4758db0d9a022d838bdcbfdc127c8ce9fc33ab4e81233aff0ed7c43f50e0755bc
+  metadata.gz: a6bd32ea40aee62288c3109352854643da5ef525eab4fdc730c2b28467a6bc6bbdcf809876e382c011ada03c1b781ea2f37e3a33030991a10da4512e439b3bb1
+  data.tar.gz: 812408119cef47a926de01f72aa1aef5707a07e6e9888f46635591a9ce5113d8a58ec4dbf742166c1abf6bbcf3d0f349145ea9d6e460314500fae505bafdac8d

data/Manifest.txt

@@ -6,5 +6,5 @@ config/contracts.2017.csv
 config/contracts.2021.csv
 config/contracts.2022.csv
 lib/ethname.rb
-lib/ethname/dictionary.rb
+lib/ethname/directory.rb
 lib/ethname/version.rb

data/README.md

@@ -70,7 +70,7 @@ Example - [config/contracts.2017.csv](config/contracts.2017.csv):
 address, names
 0x6Ba6f2207e343923BA692e5Cae646Fb0F566DB8D,  punks v1 | crypto punks v1
 0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb,  punks v2 | crypto punks v2 | crypto punks market
-0x60cd862c9c687a9de49aecdc3a99b74a4fc54ab6,  mooncats | mooncatrescue
+0x60cd862c9c687a9de49aecdc3a99b74a4fc54ab6,  mooncats | mooncat rescue
 ...
 ```
 
@@ -78,16 +78,23 @@ Example - [config/contracts.2022.csv](config/contracts.2022.csv):
 
 ``` csv
 address, names
-0x282bdd42f4eb70e7a9d9f40c8fea0825b7f68c5d, punks v1 wrapped ii
-0xD33c078C2486B7Be0F7B4DDa9B14F35163B949e0, punks v3
-0xd12882c8b5d1bccca57c994c6af7d96355590dbd, punks v4
+0x282bdd42f4eb70e7a9d9f40c8fea0825b7f68c5d,  punks v1 wrapped ii
+0xD33c078C2486B7Be0F7B4DDa9B14F35163B949e0,  punks v3
+0xd12882c8b5d1bccca57c994c6af7d96355590dbd,  punks v4
 0xA19f0378A6F3f3361d8e962F3589Ec28f4f8F159,  phunks v3
-0xaf9CE4B327A3b690ABEA6F78eCCBfeFFfbEa9FDf, synthetic punks | synth punks
-0x58E90596C2065BEfD3060767736C829C18F3474c, punk blocks
+0xaf9CE4B327A3b690ABEA6F78eCCBfeFFfbEa9FDf,  synth punks | synthetic punks
+0x58E90596C2065BEfD3060767736C829C18F3474c,  punk blocks
 0x23581767a106ae21c074b2276D25e5C3e136a68b,  moonbirds
+0xe9b91d537c3aa5a3fa87275fbd2e4feaaed69bd0,  marcs | crypto marcs
+0xad8474ba5a7f6abc52708f171f57fefc5cdc8c1c,  mad camels
+0xe5a5520b798c5f67ca1b0657b932656df02595ad,  punk apes yacht club
+0x9b66d03fc1eee61a512341058e95f1a68dc3a913,  phunk ape origins
+0x2204a94f96d39df3b6bc0298cf068c8c82dc8d61,  chi chis
 ...
 ```
 
+
+
 ###  Yes, You Can! - Add More Names / Contracts Via Git ;-)
 
 Your contributions welcome. You are welcome to join in and

data/config/contracts.2017.csv

@@ -1,6 +1,6 @@
-address, names
-0x6Ba6f2207e343923BA692e5Cae646Fb0F566DB8D,  punks v1 | crypto punks v1
-0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb,  punks v2 | crypto punks v2 | crypto punks market
-0x60cd862c9c687a9de49aecdc3a99b74a4fc54ab6,  mooncats | mooncatrescue
+address, names, interfaces, created
+0x6Ba6f2207e343923BA692e5Cae646Fb0F566DB8D,  punks v1 | crypto punks v1,  erc20,  2017-06-09 00:22:50
+0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb,  punks v2 | crypto punks v2 | crypto punks market,  erc20,  2017-06-22 19:40:00
+0x60cd862c9c687a9de49aecdc3a99b74a4fc54ab6,  mooncats | mooncatrescue,,  2017-08-09 04:36:06
 
 

data/config/contracts.2021.csv

@@ -1,11 +1,15 @@
-address, names
-0x16f5a35647d6f03d5d3da7b35409d65ba03af3b2, punks data | crypto punks data
-0xf4a4644e818c2843ba0aabea93af6c80b5984114, punks v1 wrapped i | classic punks
+address, names, interfaces, created
+0x16f5a35647d6f03d5d3da7b35409d65ba03af3b2, punks data | crypto punks data,, 2021-08-18 00:10:24
+0xf4a4644e818c2843ba0aabea93af6c80b5984114, punks v1 wrapped i | classic punks,  erc721, 2021-03-25 04:26:43
 
-0xa82f3a61f002f83eba7d184c50bb2a8b359ca1ce, phunks v1 | philips
-0xf07468ead8cf26c752c676e43c814fee9c8cf402, phunks v2 | phunks
+0xa82f3a61f002f83eba7d184c50bb2a8b359ca1ce, phunks v1 | philips,  erc721, 2021-06-14 04:18:53
+0xf07468ead8cf26c752c676e43c814fee9c8cf402, phunks v2 | phunks,  erc721,  2021-06-21 00:07:08
 
-0x031920cc2d9f5c10b444fd44009cd64f829e7be2, zunks
+0x031920cc2d9f5c10b444fd44009cd64f829e7be2, zunks,  erc721,  2021-08-07 04:01:17
 
-0x0d0167a823c6619d430b1a96ad85b888bcf97c37, xpunks | expansion punks
-0x71eb5c179ceb640160853144cbb8df5bd24ab5cc, xphunks | expansion phunks
+0x0d0167a823c6619d430b1a96ad85b888bcf97c37, xpunks | expansion punks,  erc721,  2021-08-15 00:13:20
+0x71eb5c179ceb640160853144cbb8df5bd24ab5cc, xphunks | expansion phunks,  erc721, 2021-12-30 10:14:39
+
+
+0x7c40c393dc0f283f318791d746d894ddd3693572, mooncats wrapped,  erc721, 2021-03-12 20:20:10
+0xc3f733ca98E0daD0386979Eb96fb1722A1A05E69, acclimated​ mooncats | mooncats acclimated​,  erc721, 2021-04-22 01:52:09

data/config/contracts.2022.csv

@@ -1,15 +1,24 @@
-address, names
-0x282bdd42f4eb70e7a9d9f40c8fea0825b7f68c5d, punks v1 wrapped ii
+address, names, interfaces, created
+0x282bdd42f4eb70e7a9d9f40c8fea0825b7f68c5d, punks v1 wrapped ii,  erc721, 2022-01-17 10:15:07
 
-0xD33c078C2486B7Be0F7B4DDa9B14F35163B949e0, punks v3
-0xd12882c8b5d1bccca57c994c6af7d96355590dbd, punks v4
+0xD33c078C2486B7Be0F7B4DDa9B14F35163B949e0, punks v3,  erc721, 2022-02-02 16:57:59
+0xd12882c8b5d1bccca57c994c6af7d96355590dbd, punks v4,  erc721, 2022-02-04 08:57:46
 
-0xA19f0378A6F3f3361d8e962F3589Ec28f4f8F159,  phunks v3
+0xA19f0378A6F3f3361d8e962F3589Ec28f4f8F159,  phunks v3,  erc721,  2022-02-03 08:49:52
 
 
-0xaf9CE4B327A3b690ABEA6F78eCCBfeFFfbEa9FDf, synthetic punks | synth punks
+0xaf9CE4B327A3b690ABEA6F78eCCBfeFFfbEa9FDf, synthetic punks | synth punks,  erc721,  2022-02-13 18:27:43
 
-0x58E90596C2065BEfD3060767736C829C18F3474c, punk blocks
+0x58E90596C2065BEfD3060767736C829C18F3474c, punk blocks,,  2022-12-09 23:42:59
 
 
-0x23581767a106ae21c074b2276D25e5C3e136a68b,  moonbirds
+0x23581767a106ae21c074b2276D25e5C3e136a68b,  moonbirds,  erc721,   2022-04-15 16:38:30
+
+
+0xe9b91d537c3aa5a3fa87275fbd2e4feaaed69bd0, marcs | crypto marcs,  erc721,  2022-07-17 15:49:16
+0xad8474ba5a7f6abc52708f171f57fefc5cdc8c1c, mad camels, erc721,  2022-09-04 07:16:38
+0xe5a5520b798c5f67ca1b0657b932656df02595ad, punk apes yacht club, erc721,  2022-09-14 04:18:54
+0x9b66d03fc1eee61a512341058e95f1a68dc3a913, phunk ape origins,  erc721,  2022-09-23 05:56:47
+0x34625ecaa75c0ea33733a05c584f4cf112c10b6b, punkin spicies, erc721,   2022-10-08 06:04:23
+0x2204a94f96d39df3b6bc0298cf068c8c82dc8d61, chi chis,  erc721,  2022-10-24 09:07:47
+

data/lib/ethname/directory.rb

@@ -0,0 +1,121 @@
+
+module Ethname
+
+class Record
+  def self.directory()  Ethname.directory; end
+
+  def self.find( addr )  directory.find_record( addr ); end
+  def self.find_by( name: ) directory.find_record_by( name: name ); end
+
+
+
+  def self.parse( row )
+    ## note: always downcase addresses for now
+    ##   (do NOT use addresss checksum with mixed-hexchars) - why? why not?
+     address = row['address'].downcase
+
+     names   = row['names'].split('|')
+     names   =  names.map {|name| name.strip }   ## remove leading & trailing withespaces
+
+     ## note: always downcase and normalize (remove space and - for now)
+     #  - why? why not?
+     ##   e.g. ERC20 => erc20
+     ##        ERC-20 | ERC-721 => erc20  | erc721
+     interfaces = (row['interfaces'] || '').split('|')
+     interfaces = interfaces.map {|inter| inter.downcase.gsub(/[ -]/, '' ) }
+
+     new( address:    address,
+          names:      names,
+          interfaces: interfaces )
+  end
+
+
+  attr_reader :address, :names, :interfaces
+
+  def initialize( address: nil,
+                  names: [],
+                  interfaces: [] )
+     @address    = address
+     @names      = names
+     @interfaces = interfaces
+  end
+
+  alias_method :addr, :address
+  def name() @names[0]; end
+
+  def erc20?()  @interfaces.include?('erc20' ); end
+  def erc721?() @interfaces.include?('erc721' ); end
+
+
+end  # class Record
+
+
+
+class Directory
+     ## let's you lookup up ethereum addresses by name
+
+     def self.read( *paths )    ## use load - why? why not?
+        dir = new
+        paths.each do |path|
+          rows= read_csv( path )
+          dir.add_rows( rows )
+        end
+        dir
+     end
+
+
+
+     def initialize
+       @recs          = {}   ## lookup (record) by (normalized) address
+       @reverse_table = {}   ## lookup (address) by (normalized) name
+     end
+
+
+     def records() @recs.values; end
+     def size() @recs.size; end
+
+     def find_record( addr )
+       @recs[ addr.downcase ]
+     end
+
+     def find_record_by( name: )
+       key = normalize( name )
+       @reverse_table[ key ]
+     end
+
+
+     def []( name )
+        rec = find_record_by( name: name )
+        rec ? rec.addr : nil
+     end
+
+
+     def add_rows( rows )
+      rows.each do |row|
+        rec = Record.parse( row )
+        rec.names.each do |name|
+
+          key = normalize( name )
+          rec2 = @reverse_table[ key ]
+
+          ## check for duplicates
+          raise ArgumentError, "duplicate (normalized) key >#{key} for addr >#{rec.addr}<"  if rec == rec2
+          raise ArgumentError, "duplicate (normalized) key >#{key}< for addr >#{rec.addr}; addr already in use >#{rec2.addr}<"  if rec2
+          @reverse_table[ key ] = rec
+        end
+
+        @recs[rec.addr] = rec
+      end
+    end
+
+     #################
+     #  convencience helpers
+     def self.normalize( str )
+         ## remove all non a-z (and 0-9) characters
+        str.downcase.gsub( /[^a-z0-9]/i, '' )
+     end
+
+     def normalize( str ) self.class.normalize( str ); end
+end  # class Directory
+end  # module Ethname
+

data/lib/ethname/version.rb

@@ -2,7 +2,7 @@
 
 module Ethname
   MAJOR = 0
-  MINOR = 0
+  MINOR = 1
   PATCH = 1
   VERSION = [MAJOR,MINOR,PATCH].join('.')
 

data/lib/ethname.rb

@@ -4,23 +4,23 @@ require 'cocos'
 
 ## our own code
 require_relative 'ethname/version'
-require_relative 'ethname/dictionary'
+require_relative 'ethname/directory'
 
 
 module Ethname
 
-def self.dict
-   @dict ||= Dictionary.read( "#{root}/config/contracts.2017.csv",
-                              "#{root}/config/contracts.2021.csv",
-                              "#{root}/config/contracts.2022.csv",
+def self.dir
+   @dir ||= Directory.read( "#{root}/config/contracts.2017.csv",
+                            "#{root}/config/contracts.2021.csv",
+                            "#{root}/config/contracts.2022.csv",
                             )
 end
-
-def self.lookup( q )
-  dict.lookup( q )
-end
 class << self
-  alias_method :[], :lookup
+   alias_method :directory, :dir
+end
+
+def self.[]( q )
+  dir[ q ]
 end
 
 end  # module Ethname

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ethname
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.1.1
 platform: ruby
 authors:
 - Gerald Bauer
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-12-16 00:00:00.000000000 Z
+date: 2022-12-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cocos
@@ -77,7 +77,7 @@ files:
 - config/contracts.2021.csv
 - config/contracts.2022.csv
 - lib/ethname.rb
-- lib/ethname/dictionary.rb
+- lib/ethname/directory.rb
 - lib/ethname/version.rb
 homepage: https://github.com/rubycocos/blockchain
 licenses:

data/lib/ethname/dictionary.rb

@@ -1,75 +0,0 @@
-
-module Ethname
-
-  class Dictionary
-     ## let's you lookup up ethereum addresses by name
-
-     def self.read( *paths )    ## use load - why? why not?
-        dict = new
-        paths.each do |path|
-          recs = read_csv( path )
-          dict.add_recs( recs )
-        end
-        dict
-     end
-
-
-
-     def initialize
-       @recs          = []
-       @reverse_table = {}   ## lookup (address) by (normalized) name
-     end
-
-     def recs() @recs; end
-     def size() @recs.size; end
-
-
-
-     def lookup( q )
-        key = normalize( q )
-        addr = @reverse_table[ key ]
-        addr
-     end
-     alias_method :[], :lookup
-
-
-     def add_recs( recs )
-      recs.each do |rec|
-        ## note: always downcase addresses for now
-        ##   (do NOT use addresss checksum with mixed-hexchars) - why? why not?
-        addr =  rec['address'].downcase
-        names = rec['names'].split('|')
-        names.each do |name|
-          _add( addr, name )
-        end
-      end
-
-      @recs += recs
-    end
-
-
-     #################
-     #  convencience helpers
-     def self.normalize( str )
-         ## remove all non a-z (and 0-9) characters
-        str.downcase.gsub( /[^a-z0-9]/i, '' )
-     end
-
-     def normalize( str ) self.class.normalize( str ); end
-
-     ####
-     # private (internal) helpers
-     def _add( addr, name )
-      key = normalize( name )
-      addr2 = @reverse_table[ key ]
-
-      ## check for duplicates
-      raise ArgumentError, "duplicate (normalized) key >#{key} for addr >#{addr}<"  if addr == addr2
-      raise ArgumentError, "duplicate (normalized) key >#{key}< for addr >#{addr}; addr already in use >#{addr2}<"  if addr2
-      @reverse_table[ key ] = addr
-      self
-   end
-
-  end
-end  # module Ethname
-