ordbase 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1153ed377c1c27ca1949b44cf8f572eee29f41a22f3cf2bbb212249c08892986
+  data.tar.gz: 13f2cbc4bfcfe29322dff646066ae7b3440791b0ca2d5dfed3548d69c4280b75
+SHA512:
+  metadata.gz: e17fd8a4f60c5f3c41ab648e9460a5829b1d63cad5c2cea04a45b3ee06a09dca8d58065a6f3dc016e440f2bca68a2a0d3be88a34cca0d79c6968467fadcd44f5
+  data.tar.gz: 82ec1b35e9929645401a920605a7b22bc2a5e81e313b56da65615eafed9854abdd307fb974e71a92d69f2ddcf6a778f0a3dd8edad7a2de43995086edfa502803

data/CHANGELOG.md

@@ -0,0 +1,3 @@
+### 0.0.1 / 2023-02-11
+
+* Everything is new. First release

data/Manifest.txt

@@ -0,0 +1,9 @@
+CHANGELOG.md
+Manifest.txt
+README.md
+Rakefile
+bin/ordbase
+lib/ordbase.rb
+lib/ordbase/collection.rb
+lib/ordbase/stats.rb
+lib/ordbase/tool.rb

data/README.md

@@ -0,0 +1,171 @@
+# ordbase
+
+ordbase gem - "right-clicker" (off-chain) ordinals (pixel art) command-line tool, machinery & helpers for Bitcoin, Litcoin, Dogecoin & co.
+
+
+* home  :: [github.com/pixelartexchange/artbase](https://github.com/pixelartexchange/artbase)
+* bugs  :: [github.com/pixelartexchange/artbase/issues](https://github.com/pixelartexchange/artbase/issues)
+* gem   :: [rubygems.org/gems/ordbase](https://rubygems.org/gems/ordbase)
+* rdoc  :: [rubydoc.info/gems/ordbase](http://rubydoc.info/gems/ordbase)
+
+
+
+## Command-Line Usage
+
+Let's use the 100 Ordinal Punks collection to try out the
+`ordbase` command-line tool shipping with the ordbase package.
+
+Tip: New to Ordinal Punks? For some background see [**Awesome 100 Ordinal Punks (Anno 2023) Notes - 24×24 Pixel Art on the (Bitcoin) Blockchain »**](https://github.com/cryptopunksnotdead/cryptopunks/tree/master/awesome-ordinalpunks)
+
+
+### Step 0:   Prepare A Tabular Dataset (List) Of All Ordinals w/ ID
+
+For now a manual step - prepare a list of all ordinals with id in the comma-separated values (.csv) tabular dataset format.
+Example - [ordinalpunks/ordinals.csv](https://github.com/pixelartexchange/ordinals.sandbox/blob/master/ordinalpunks/ordinals.csv):
+
+``` csv
+num, id
+1, 96d87d7e59d75ebc0e6144b09fdd96355fcdaa86fd098d64c46f19a424012bbei0
+2, acda637db995df796b35035fd978cc1a947f1e6fd5215968da88b7e38a7e4b37i0
+3, 0406654dffdd01a49794bd8531bf33721986cc7c6546f871962adee921a39a9di0
+4, 2fe9bb034f60db694701acb23a76c3d7d5aba4328dbd315764f6ee406ba41786i0
+5, dcfa240f2681d1e4a8948120a3a64567262e3c78d5497cb4e97351bfa836b638i0
+6, 16df62c86321895df2b93236d103c935015ed77e189485be649ce2c7e6ac8a4ei0
+7, 81e8d9159b8e9a27c692a5bb3ba18ca037757e94e975b53e175eaaeb2c52f15ai0
+8, c2e15fe87c4b1fd61de65f2804858e6d1152b6316bcb9c2b39b69c9c21638f5di0
+9, 3ed569f3a92ade9f1b47031eb2db2045e7dee3e00787954a88c67ed2ad9854bbi0
+...
+```
+
+
+### Step 1:  Download All Pixel Art Images Via Ordinals.com
+
+Use
+
+```
+$ ordbase ordinalpunks image   # or
+$ ordbase ordinalpunks img
+```
+
+to download all images via the ordinals.com (web) service.
+All images get stored in the (temporary) `token-i/` directory.
+Resulting in:
+
+```
+/ordinalpunks
+   ordinals.csv
+   /token-i
+     1.png
+     2.png
+     3.png
+     ...
+```
+
+![](https://github.com/pixelartexchange/artbase/raw/master/ordbase/i/1.png)
+![](https://github.com/pixelartexchange/artbase/raw/master/ordbase/i/2.png)
+![](https://github.com/pixelartexchange/artbase/raw/master/ordbase/i/3.png)
+![](https://github.com/pixelartexchange/artbase/raw/master/ordbase/i/4.png)
+![](https://github.com/pixelartexchange/artbase/raw/master/ordbase/i/5.png)
+![](https://github.com/pixelartexchange/artbase/raw/master/ordbase/i/6.png)
+...
+
+
+
+
+### Step 2:  Downsample ("Pixelate")  All Pixel Art Images
+
+Note: Most pixel art collections upload / inscribe images with a zoom.
+The ordinal punks, for example, use a 8x zoom factor for the 24×24px originals, thus,
+resulting in 192×192px.
+
+
+Add a ["artbase-compatible"](https://github.com/pixelartexchange/artbase) collection configuration file to lists the source format(s)
+and the minimal true pixel format.
+Example - [ordinalpunks/collection.yml](https://github.com/pixelartexchange/ordinals.sandbox/blob/master/ordinalpunks/collection.yml):
+
+``` yaml
+slug:       ordinalpunks
+count:      100
+format:     24x24
+source:     192x192
+offset:     1
+```
+
+Use
+
+```
+$ ordbase ordinalpunks pixelate   # or
+$ ordbase ordinalpunks px
+```
+
+to downsample ("pixelate") all images
+in the (temporary) `token-i/` directory.
+Resulting in a `24x24`/ directory with all images
+in the "minimal" `24x24` format:
+
+```
+/ordinalpunks
+   ordinals.csv
+   collections.yml
+   /24x24
+     1.png
+     2.png
+     3.png
+     ...
+```
+
+![](https://github.com/pixelartexchange/ordinals.sandbox/raw/master/ordinalpunks/24x24/1.png)
+![](https://github.com/pixelartexchange/ordinals.sandbox/raw/master/ordinalpunks/24x24/2.png)
+![](https://github.com/pixelartexchange/ordinals.sandbox/raw/master/ordinalpunks/24x24/3.png)
+![](https://github.com/pixelartexchange/ordinals.sandbox/raw/master/ordinalpunks/24x24/4.png)
+![](https://github.com/pixelartexchange/ordinals.sandbox/raw/master/ordinalpunks/24x24/5.png)
+![](https://github.com/pixelartexchange/ordinals.sandbox/raw/master/ordinalpunks/24x24/6.png)
+...
+
+
+
+### Bonus: Step 3:  Make An All-In-One Collect'Em All Composite Image
+
+
+Use
+
+```
+$ ordbase ordinalpunks composite   # or
+$ ordbase ordinalpunks comp
+```
+
+to make an all-in-one image composite for the complete collection.
+Resulting in `/tmp/ordinalpunks.png` (~11kb).
+
+
+![](https://github.com/pixelartexchange/ordinals.sandbox/raw/master/i/ordinalpunks.png)
+
+
+That's it for now.
+
+
+
+
+## Bonus:  More Ordinal Pixel Art Collections
+
+
+See the [**Ordinals (Pixel Art) Sandbox (& Cache)**](https://github.com/pixelartexchange/ordinals.sandbox)
+for more collections incl. Bitcoin Punks (24×24), Ordinal Mini Doges (24×24),
+Extra Ordinal Women (32×32), Ordinal Penguins (35×35),
+Ordinal Birds (42×42), Bitcoin Bears (48×48) and much more.
+
+Add your sandbox or "right-clicker" ordinal backup / archive / gallery here. Yes, you can.
+
+
+
+## License
+
+The scripts are dedicated to the public domain.
+Use it as you please with no restrictions whatsoever.
+
+
+## Questions? Comments?
+
+Post them over at the [Help & Support](https://github.com/geraldb/help) page. Thanks.
+
+

data/Rakefile

@@ -0,0 +1,39 @@
+require 'hoe'
+
+
+###
+# hack/ quick fix for broken intuit_values - overwrite with dummy
+class Hoe
+  def intuit_values( input ); end
+end
+
+
+Hoe.spec 'ordbase' do
+
+  self.version = '1.0.0'
+
+  self.summary = 'ordbase gem - "right-clicker" (off-chain) ordinals (pixel art) command-line tool, machinery & helpers for Bitcoin, Litecoin, Dogecoin & co.'
+  self.description = summary
+
+  self.urls    = { home: 'https://github.com/pixelartexchange/artbase' }
+
+  self.author  = 'Gerald Bauer'
+  self.email   = 'wwwmake@googlegroups.com'
+
+  # switch extension to .markdown for gihub formatting
+  self.readme_file  = 'README.md'
+  self.history_file = 'CHANGELOG.md'
+
+  self.extra_deps = [
+    ['ordinals'],
+    ['pixelart'],
+  ]
+
+  self.licenses = ['Public Domain']
+
+  self.spec_extras = {
+    required_ruby_version: '>= 2.3'
+  }
+
+end
+

data/bin/ordbase

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+###################
+# == DEV TIPS:
+#
+# For local testing run like:
+#
+#    ruby -Ilib bin/ordbase
+#
+# Set the executable bit in Linux. Example:
+#
+#    % chmod a+x bin/ordbase
+#
+
+require 'ordinals'
+
+Ordinals::Tool.main

data/lib/ordbase/collection.rb

@@ -0,0 +1,268 @@
+
+module Ordinals
+
+
+class Collection
+  attr_reader :slug,
+              :width, :height,
+              :sources
+
+
+  def initialize( slug )
+      @slug = slug
+
+      ## read config if present
+      config_path = "./#{@slug}/collection.yml"
+      if File.exist?( config_path )
+        config = read_yaml( config_path )
+        pp config
+
+        @width, @height = _parse_dimension( config['format'] )
+
+        ## note: allow multiple source formats / dimensions
+        ### e.g. convert   512x512 into  [ [512,512] ]
+        ##
+        source = config['source']
+        source = [source]  unless source.is_a?( Array )
+        @sources = source.map { |dimension| _parse_dimension( dimension ) }
+      end
+  end
+
+
+def ordinals
+   @ordinals ||= begin
+                     recs = read_csv( "./#{@slug}/ordinals.csv" )
+                     puts "  #{recs.size} record(s)"
+                     recs
+                 end
+   @ordinals
+end
+
+def count() ordinals.size; end
+alias_method :size, :count
+
+
+
+def each_ordinal( &block )
+  ordinals.each_with_index do |rec, i|   ## pass along hash rec for now - why? why not?
+    block.call( rec, i )
+  end
+end
+
+## add each_source_image or each_token_image or each_original_image or such - why? why not??
+
+
+
+def each_image( &block )
+  each_ordinal do |rec, i|
+    id   = rec['id']
+    num  = rec.has_key?('num') ? rec['num'].to_i(10) : i+1
+
+    path = "./#{@slug}/#{@width}x#{@height}/#{num}.png"
+    img = Image.read( path )
+
+    block.call( img, num )
+  end
+end
+
+
+
+def image_dir()  "./#{@slug}/token-i";  end
+
+
+
+## e.g. convert dimension (width x height) "24x24" or "24 x 24" to  [24,24]
+def _parse_dimension( str )
+    str.split( /x/i ).map { |str| str.strip.to_i }
+end
+
+
+def pixelate
+  each_ordinal do |rec, i|
+    id   = rec['id']
+    num  = rec.has_key?('num') ? rec['num'].to_i(10) : i+1
+
+    outpath = "./#{@slug}/#{@width}x#{@height}/#{num}.png"
+    next if File.exist?( outpath )
+
+    path = "#{image_dir}/#{num}.png"
+    puts "==> reading #{path}..."
+
+    img = Image.read( path )
+    puts "   #{img.width}x#{img.height}"
+
+    ## check for source images
+    if !@sources.include?( [img.width, img.height] )
+      puts "  !! ERROR - unexpected image size; sorry - expected:"
+      pp @sources
+      exit 1
+    end
+
+    ## check for special case   source == format!!
+    if [img.width,img.height] == [@width,@height]
+      puts "   note: saving image as is - no downsampling"
+      img.save( outpath )
+    else
+      steps_x = Image.calc_sample_steps( img.width, @width )
+      steps_y = Image.calc_sample_steps( img.height, @height )
+
+      img = img.sample( steps_x, steps_y )
+      img.save( outpath )
+    end
+  end
+end
+
+
+
+
+def make_composite( limit: nil )
+
+  composite_count =  limit ? limit : count
+
+  cols, rows = case composite_count
+               when    10 then   [5,   2]
+               when    12 then   [4,   3]
+               when    15 then   [5,   3]
+               when    20 then   [5,   4]
+               when    50 then   [10,  5]
+               when    69 then   [10,  7]
+               when    80 then   [10,  8]
+               when    88 then   [10,  9]
+               when 98,99 then   [10,  10]
+               when   100 then   [10,  10]
+               when   101 then   [11,  10]
+               when   111 then   [11,  11]
+               when   130 then   [10,  13]
+               when   512 then   [20,  26]
+               else
+                   raise ArgumentError, "sorry - unknown composite count #{composite_count} for now"
+               end
+
+  composite = ImageComposite.new( cols, rows,
+                                  width:  @width,
+                                  height: @height )
+
+
+  image_count = 0
+  each_image do |img, num|
+    puts "==> #{num}"
+    composite << img
+
+    image_count += 1
+    break   if image_count >= composite_count
+  end
+
+
+   composite.save( "./#{@slug}/tmp/#{@slug}.png" )
+end
+
+
+
+def convert_images
+  Image.convert( image_dir, from: 'jpg',
+                            to:   'png' )
+
+  Image.convert( image_dir, from: 'gif',
+                            to:   'png' )
+
+  Image.convert( image_dir, from: 'webp',
+                            to:   'png' )
+end
+
+
+
+def fix_images   ## todo - find a different names for resaving png images?
+  ##  "repair" png images
+  ##    starting w/
+  ##  - why?
+  ##
+  ## verify_signature! - ChunkyPNG::SignatureMismatch:
+  ##  PNG signature not found,
+  ##  found     "RIFF\\xFE\\b\\x00\\x00"
+  ##  instead of "\\x89PNG\\r\\n\\x1A\\n"
+
+  Image.convert( image_dir, from: 'png',
+                            to:   'png' )
+end
+
+
+def download_meta   ## inscription metadata
+  each_ordinal do |rec, i|
+    id   = rec['id']
+    num  = rec.has_key?('num') ? rec['num'].to_i(10) : i+1
+
+    chain = Ordinals.config.chain
+    path = "../ordinals.cache/#{chain}/#{id}.json"
+    next if File.exist?( path )
+
+    puts "==> downloading #{chain} inscription meta #{num} w/ id #{id}..."
+
+    data = Ordinals.client.inscription( id )
+
+    write_json( path, data )
+
+    sleep( 1.0 )  ## sleep (delay_in_s)
+  end
+end
+
+def dump_stats
+  stats = InscriptionStats.new
+
+  each_ordinal do |rec, i|
+    id   = rec['id']
+
+    chain = Ordinals.config.chain
+    path = "../ordinals.cache/#{chain}/#{id}.json"
+
+    data = read_json( path )
+    stats.update( data )
+  end
+
+  pp stats.data
+  puts
+  puts stats.format
+end
+
+
+def download_images
+  each_ordinal do |rec, i|
+    id   = rec['id']
+    num  = rec.has_key?('num') ? rec['num'].to_i(10) : i+1
+
+    ##  note: add gif too (for check) - add more formats - why? why not?
+    next if File.exist?( "#{image_dir}/#{num}.png" ) ||
+            File.exist?( "#{image_dir}/#{num}.gif" ) ||
+            File.exist?( "#{image_dir}/#{num}.jpg" )
+
+
+    puts "==> downloading image ##{num}..."
+
+
+    content = Ordinals.client.content( id )
+
+      puts "  content_type: #{content.type}, content_length: #{content.length}"
+
+      format = if content.type =~ %r{image/jpeg}i
+                 'jpg'
+               elsif content.type =~ %r{image/png}i
+                'png'
+               elsif content.type =~ %r{image/gif}i
+                 'gif'
+               elsif content.type =~ %r{image/webp}i
+                 'webp'
+               else
+                 puts "!! ERROR:"
+                 puts " unknown image format content type: >#{content.type}<"
+                 exit 1
+               end
+
+      ## save image - using b(inary) mode
+      write_blob( "#{image_dir}/#{num}.#{format}", content.blob )
+
+      sleep( 1.0 )  ## sleep (delay_in_s)
+  end
+end
+
+end   # class Collection
+end   # module Ordinals
+

data/lib/ordbase/stats.rb

@@ -0,0 +1,142 @@
+
+
+class InscriptionStats
+
+  TITLE_RX = /^Inscription[ ]+(?<ord>[0-9]+)$/
+  BYTES_RX = /^(?<bytes>[0-9]+)[ ]+bytes$/
+
+  def initialize
+    @stats = {
+      count: 0,
+      ord: { '<1000'  => 0,
+             '<10000' => 0,
+             '<100000' => 0,
+             '<1000000' => 0,
+             'min' => nil,
+             'max' => nil, },
+      type: Hash.new(0),
+      bytes:  {  '<100'  => 0,
+                 '<1000' => 0,
+                 '<10000' => 0,
+                 '<100000' => 0,
+                 '<1000000' => 0,
+                 'min' => nil,
+                 'max' => nil, },
+    }
+
+    @days = Hash.new(0)
+  end
+
+  def size()  @stats[:count]; end
+
+
+
+  def update( data )
+    data = JSON.parse( data)   if data.is_a?( String )
+
+    @stats[ :count ] += 1
+
+
+    ord = nil
+    if m=TITLE_RX.match( data['title'] )
+        ord = m[:ord].to_i(10)
+    else
+        puts "!! ERROR - cannot find ord in inscription title; sorry"
+        pp data
+        exit 1
+    end
+
+    if     ord < 1000    then  @stats[:ord]['<1000'] += 1
+    elsif  ord < 10000   then  @stats[:ord]['<10000'] += 1
+    elsif  ord < 100000  then  @stats[:ord]['<100000'] += 1
+    elsif  ord < 1000000 then  @stats[:ord]['<1000000'] += 1
+    else
+      puts "!! ERROR ord out-of-bounds"
+      exit 1
+    end
+
+    ## update min/max
+    @stats[:ord]['min'] = ord   if ord < (@stats[:ord]['min'] || 9999999)
+    @stats[:ord]['max'] = ord   if ord > (@stats[:ord]['max'] || -1)
+
+
+    bytes = nil
+    if m=BYTES_RX.match( data['content length'] )
+        bytes = m[:bytes].to_i(10)
+    else
+        puts "!! ERROR - cannot find bytes in inscription content length; sorry"
+        pp data
+        exit 1
+    end
+
+    if     bytes < 100     then  @stats[:bytes]['<100'] += 1
+    elsif  bytes < 1000    then  @stats[:bytes]['<1000'] += 1
+    elsif  bytes < 10000   then  @stats[:bytes]['<10000'] += 1
+    elsif  bytes < 100000  then  @stats[:bytes]['<100000'] += 1
+    elsif  bytes < 1000000 then  @stats[:bytes]['<1000000'] += 1
+    else
+      puts "!! ERROR bytes (content-length) out-of-bounds"
+      exit 1
+    end
+
+    ## update min/max
+    @stats[:bytes]['min'] = bytes   if bytes < (@stats[:bytes]['min'] || 9999999)
+    @stats[:bytes]['max'] = bytes   if bytes > (@stats[:bytes]['max'] || -1)
+
+
+    type = data['content type']
+
+    @stats[:type][ type ] += 1
+
+    ## "timestamp"=>"2023-02-05 01:45:22 UTC",
+    ts = Time.strptime( data['timestamp'], '%Y-%m-%d %H:%M:%S' )
+
+    @days[ ts.strftime('%Y-%m-%d') ] +=1
+  end  # method update
+
+
+  def data   ## rename to model or such - why? why not?
+     ## sort days
+     days = @days.sort {|l,r|  l[0] <=> r[0] }
+     ## add to stats
+     @stats[:days] = {}
+     days.each {|k,v| @stats[:days][k] = v }
+     @stats
+  end
+
+=begin
+{:count=>101,
+ :ord=>{"<1000"=>0, "<10000"=>0, "<100000"=>101, "<1000000"=>0, "min"=>14343, "max"=>42901},
+ :type=>{"image/png"=>101},
+ :bytes=>{"<100"=>0, "<1000"=>101, "<10000"=>0, "<100000"=>0, "<1000000"=>0, "min"=>274, "max"=>512},
+ :days=>{"2023-02-22"=>10, "2023-02-25"=>17, "2023-02-26"=>74}}
+=end
+
+  def format   ## rename to pretty_print or such - why? why not?
+     stat = data
+
+     buf = String.new('')
+     buf << "#{stat[:count]} inscription(s)\n"
+
+     buf << "- from ##{stat[:ord]['min']} to ##{stat[:ord]['max']} (min. to max.)\n"
+     buf << "     - <1000 => #{stat[:ord]['<1000']}\n"         if stat[:ord]["<1000"] > 0
+     buf << "     - <10000 => #{stat[:ord]['<10000']}\n"      if stat[:ord]["<10000"] > 0
+     buf << "     - <100000 => #{stat[:ord]['<100000']}\n"    if stat[:ord]["<100000"] > 0
+     buf << "     - <1000000 => #{stat[:ord]['<1000000']}\n"  if stat[:ord]["<1000000"] > 0
+
+     buf << "- format(s)\n"
+     stat[:type].each do |k,v|
+        buf << "     - #{k} => #{v}\n"
+     end
+
+     buf << "- day(s)\n"
+     stat[:days].each do |k,v|
+       buf << "     - #{k} => #{v}\n"
+     end
+
+     buf
+  end
+
+end  ## class InscriptionStats
+
+

data/lib/ordbase/tool.rb

@@ -0,0 +1,130 @@
+module Ordinals
+class Tool
+
+  def self.main( args=ARGV )
+    puts "==> welcome to the ordbase tool with args:"
+    pp args
+
+    options = {
+              }
+
+    parser = OptionParser.new do |opts|
+      opts.on( "--doge", "--dogecoin", "Use Dogecoin / DOGE") do
+        ## switch to doge
+        Ordinals.config.chain = :doge
+      end
+      opts.on( "--ltc", "--litecoin", "Use Litecoin / LTC") do
+          ## switch to ltc
+          Ordinals.config.chain = :ltc
+      end
+      opts.on( "--btc", "--bitcoin", "Use Bitcoin / BTC") do
+          ## switch to btc  (default)
+          Ordinals.config.chain = :btc
+      end
+
+      opts.on("--limit NUM", Integer,
+             "Limit collection (default: ∞)") do |num|
+         options[ :limit]  = num
+      end
+
+      opts.on("-h", "--help", "Prints this help") do
+        puts opts
+        exit
+      end
+    end
+
+    parser.parse!( args )
+    puts "options:"
+    pp options
+
+    puts "args:"
+    pp args
+
+    if args.size < 1
+      puts "!! ERROR - no collection found - use <collection> <command>..."
+      puts ""
+      exit
+    end
+
+    slug             = args[0]
+    command          = args[1] || 'image'
+
+    if ['m', 'meta'].include?( command )
+      do_download_meta( slug )
+    elsif ['stat', 'stats'].include?( command )
+      do_dump_stats( slug )
+    elsif ['i','img', 'image'].include?( command )
+      do_download_images( slug )
+    elsif ['conv','convert'].include?( command )
+      do_convert_images( slug )
+    elsif ['fix'].include?( command )
+      do_fix_images( slug )
+    elsif ['px','pix', 'pixelate' ].include?( command )
+      do_pixelate( slug )
+    elsif ['comp','composite' ].include?( command )
+      if options.has_key?( :limit )
+        do_make_composite( slug, limit: options[:limit] )
+      else
+        do_make_composite( slug )
+      end
+    else
+      puts "!! ERROR - unknown command >#{command}<, sorry"
+    end
+
+    puts "bye"
+  end
+
+
+  def self.do_dump_stats( slug )
+    puts "==> dump inscription stats for collection >#{slug}<..."
+
+    col = Collection.new( slug )
+    col.dump_stats
+  end
+
+  def self.do_download_meta( slug )
+    puts "==> download meta for collection >#{slug}<..."
+
+    col = Collection.new( slug )
+    col.download_meta
+  end
+
+  def self.do_download_images( slug )
+    puts "==> download images for collection >#{slug}<..."
+
+    col = Collection.new( slug )
+    col.download_images
+  end
+
+
+  def self.do_convert_images( slug )
+    puts "==> convert images for collection >#{slug}<..."
+
+    col = Collection.new( slug )
+    col.convert_images
+  end
+
+  def self.do_fix_images( slug )
+    puts "==> fix images for collection >#{slug}<..."
+
+    col = Collection.new( slug )
+    col.fix_images
+  end
+
+
+  def self.do_pixelate( slug )
+    puts "==> downsample / pixelate images for collection >#{slug}<..."
+
+    col = Collection.new( slug )
+    col.pixelate
+  end
+
+  def self.do_make_composite( slug, limit: nil )
+    puts "==> make composite for collection >#{slug}<..."
+
+    col = Collection.new( slug )
+    col.make_composite( limit: limit )
+  end
+
+end  # class Tool
+end   # module Ordinals

data/lib/ordbase.rb

@@ -0,0 +1,16 @@
+
+require 'ordinals'
+require 'pixelart'
+
+require 'optparse'
+
+
+
+## our own code
+require_relative 'ordbase/collection'
+require_relative 'ordbase/stats'
+
+require_relative 'ordbase/tool'
+
+
+

metadata

@@ -0,0 +1,121 @@
+--- !ruby/object:Gem::Specification
+name: ordbase
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Gerald Bauer
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2023-03-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ordinals
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pixelart
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '7'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.23'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.23'
+description: ordbase gem - "right-clicker" (off-chain) ordinals (pixel art) command-line
+  tool, machinery & helpers for Bitcoin, Litecoin, Dogecoin & co.
+email: wwwmake@googlegroups.com
+executables:
+- ordbase
+extensions: []
+extra_rdoc_files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+files:
+- CHANGELOG.md
+- Manifest.txt
+- README.md
+- Rakefile
+- bin/ordbase
+- lib/ordbase.rb
+- lib/ordbase/collection.rb
+- lib/ordbase/stats.rb
+- lib/ordbase/tool.rb
+homepage: https://github.com/pixelartexchange/artbase
+licenses:
+- Public Domain
+metadata: {}
+post_install_message:
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key:
+specification_version: 4
+summary: ordbase gem - "right-clicker" (off-chain) ordinals (pixel art) command-line
+  tool, machinery & helpers for Bitcoin, Litecoin, Dogecoin & co.
+test_files: []