kittyverse 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 2a18d03701f80f74f3e0d07c1a2177ea37f3413f
-  data.tar.gz: e4e073120dd606eb075bb1f4a7d8563a86523420
+  metadata.gz: b83f8ccd15b5d6499f12627e7a8bb1261b33176b
+  data.tar.gz: 9086b03449228f510ac73ee7198fe9264744a93c
 SHA512:
-  metadata.gz: 47cc05e33c8ab43eb07bc975044d49f3990f8b02a5483788b9cf057f3dd904c4c094f1c0a2ca67c4f6a92b50af93b392b1ecd9a5611cc9aa49d51774805c5955
-  data.tar.gz: 886566ffaa738a43188dfad37de848c9d5ce9769ca09329e3f95015ab398a0858a9b4a347aa479c193c445a2944f31a73176e2afd14be0bb0af9195735070822
+  metadata.gz: 2bcfa16de3bb45b077bbfff8d503e87a7f28de68d55a2b1257b4540eb91ac5f28a88fceb94b814b7167b5b4a7aeb1812628fd33200ce81ae785fa90507c8f8c1
+  data.tar.gz: 22938b98bdd3bfb741033537516d28dff5f5b0e527571600c5016514e1969f7422fafa81885a9bcc0a5ae3823a918c681377ae5fc2daec0970784e08d8149fac

data/Manifest.txt

@@ -5,12 +5,15 @@ README.md
 Rakefile
 lib/kittyverse.rb
 lib/kittyverse/catalog.rb
+lib/kittyverse/cattributes.rb
 lib/kittyverse/fancies.rb
 lib/kittyverse/links.rb
 lib/kittyverse/mewtations.rb
 lib/kittyverse/pages/genes.rb
+lib/kittyverse/purrstige.rb
 lib/kittyverse/traits.rb
 lib/kittyverse/traits_timeline.rb
 lib/kittyverse/version.rb
 test/helper.rb
+test/test_cattributes.rb
 test/test_traits.rb

data/README.md

@@ -34,28 +34,107 @@ t = Trait.find_by( name: 'Savannah' )
 t = Traits[ :body ][ '1' ]
 t = Traits[ :body ][ '00' ]
 t = Traits[ :body ][ 0 ]
-t = Traits['FU']['00']
-t = Traits['FU'][0]
-t = Traits[:FU][0]
-t = Traits[:FU00]
-t = Traits['Fur'][0]
+t = Traits[ 'FU' ][ '00' ]
+t = Traits[ 'FU' ][0]
+t = Traits[ :FU ][0]
+t = Traits[ :FU00 ]
+t = Traits[ 'Fur' ][0]
 # ...
 ```
 
+#### What about `totesbasic`?
+
+Note, the `totesbasic` pattern cattribute has _three_ traits, that is, `totesbasic 1` with the code `PA14`
+and `totesbasic 2` with `PA15` and `totesbasic 3` with `PA23`.
+Use:
+
+``` ruby
+t = Traits[ 'PA14' ]
+p t.class      #=> Trait
+p t.name       #=> "totesbasic 1"
+p t.type.name  #=> "Pattern"
+p t.code       #=> "PA14"
+p t.kai        #=> "f"
+
+# -or-
+
+t = Trait.find_by_code( 'PA14' )
+t = Trait.find_by( code: 'PA14' )
+t = Traits[ 'totesbasic 1' ]
+t = Traits[ 'Totesbasic 1' ]
+t = Trait.find_by_name( 'Totesbasic 1' )
+t = Trait.find_by( name: 'Totesbasic 1' )
+t = Traits[ :body ][ 'f' ]
+t = Traits[ :body ][ '14' ]
+t = Traits[ :body ][ 14 ]
+# ...
+``` 
+
+
+
 For trait types (e.g. fur, pattern, eye color, eye shape, base color, etc.)
 use:
 
 ``` ruby
-t =  Traits[ :body ]
-p t.class    #=> TraitType
-p t.name     #=> "Fur"
-p t.code     #=> "FU"
-p t.genes    #=> "0-3"
+tt =  Traits[ :body ]
+p tt.class    #=> TraitType
+p tt.name     #=> "Fur"
+p tt.code     #=> "FU"
+p tt.genes    #=> "0-3"
 
 # -or-
 
-t =  TraitType.find_by_key( :body )
-t =  TraitType.find_by( key: 'body' )
+tt = TraitType.find_by_key( :body )
+tt = TraitType.find_by( key: 'body' )
+tt = Traits[ 'Fur' ]
+tt = TraitType.find_by_name( 'Fur' )
+tt = TraitType.find_by( name: 'Fur' )
+tt = Traits[ 'FU' ]
+tt = Traits[ :FU ]
+tt = TraitType.find_by_code( 'FU' )
+tt = TraitType.find_by( code: 'FU' )
+# ...
+```
+
+
+### Cattributes
+
+Use the `Cattribute` helper class to lookup cattributes incl. purrstige cattributes with timed trait recipes / forumlas:
+
+``` ruby
+c = Cattribute[ 'savannah' ]
+p c.class          #=> Cattribute
+p c.name           #=> "savannah"
+p c.type.name      #=> "Fur"
+p c.traits.size    #=> 1
+p c.traits         #=> ["savannah"]
+p c.traits[0].code #=> "FU00"
+# ...
+
+c = Cattribute[ 'totesbasic' ]
+p c.class          #=> Cattribute
+p c.name           #=> "totesbasic"
+p c.type.name      #=> "Pattern"
+p c.traits.size    #=> 3
+p c.traits         #=> ["totesbasic 1", "totesbasic 2", "totesbasic 3"]
+p c.traits[0].code #=> "PA14"
+p c.traits[1].code #=> "PA15"
+p c.traits[2].code #=> "PA23"
+# ...
+
+c = Cattribute[ 'bionic' ]
+p c.class          #=> Cattribute
+p c.name           #=> "bionic"
+p c.type.name      #=> "Purrstige"
+p c.traits.size    #=> 0
+p c.traits         #=> []
+p c.recipe         #=> {time: {start: "2019-05-01", end: "2019-08-31"},
+                   #    traits: ["ragdoll",
+                   #              "WE05",
+                   #              ["totesbasic 1", "totesbasic 2", "totesbasic 3"],
+                   #              "PU30"]}
+
+# ...
 ```
 
 
@@ -63,21 +142,28 @@ t =  TraitType.find_by( key: 'body' )
 
 ## Real World Usage
 
-See the [copycats command line tool (and core library)](https://github.com/cryptocopycats/copycats) - crypto cats / kitties collectibles unchained - buy! sell! hodl! sire! - play for free - runs off the blockchain - no ether / gas required
+### Reference Pages / Cheat Sheets
 
+Auto-generated CryptoKitties reference pages / cheat sheets include:
 
-## More Documentation / Articles / Samples
+- [**CryptoKitties Cattributes Rarity / Popularity Statistics**](CATTRIBUTES.md)
+- [**CryptoKitties Updates - Fancy / Exclusive / Special Edition Cats - Timeline**](updates/FANCIES.md)
+- [**CryptoKitties Updates - Purrstige Trait Recipes / Formulas - Timeline**](updates/PURRSTIGES.md)
+- and others
 
-- [Programming Crypto Collectibles Step-by-Step Book / Guide](https://github.com/cryptocopycats/programming-cryptocollectibles) -
-Let's start with CryptoKitties & Copycats. Inside Unique Bits & Bytes on the Blockchain...
-- [Ruby Quiz - Challenge #8 - Base32 Alphabet](https://github.com/planetruby/quiz/tree/master/008) - Convert the Super "Sekretoooo" 256-Bit CryptoKitties Genome to Kai Notation - Annipurrsary!
 
 
+### More
 
+See the [copycats command line tool (and core library)](https://github.com/cryptocopycats/copycats) - crypto cats / kitties collectibles unchained - buy! sell! hodl! sire! - play for free - runs off the blockchain - no ether / gas required
 
-## Questions? Comments?
 
-Post them on the [cryptokitties reddit](https://www.reddit.com/r/cryptokitties). Thanks.
+## More Documentation / Articles / Samples
+
+- [Programming Crypto Collectibles Step-by-Step Book / Guide](https://github.com/openblockchains/programming-cryptocollectibles) -
+Let's start with CryptoKitties & Copycats. Inside Unique Bits & Bytes on the Blockchain...
+- [Ruby Quiz - Challenge #8 - Base32 Alphabet](https://github.com/planetruby/quiz/tree/master/008) - Convert the Super "Sekretoooo" 256-Bit CryptoKitties Genome to Kai Notation - Annipurrsary!
+
 
 
 ## License
@@ -86,3 +172,8 @@ Post them on the [cryptokitties reddit](https://www.reddit.com/r/cryptokitties).
 
 The `kittyverse` scripts are dedicated to the public domain.
 Use it as you please with no restrictions whatsoever.
+
+
+## Questions? Comments?
+
+Post them on the [cryptokitties reddit](https://www.reddit.com/r/cryptokitties). Thanks.

data/lib/kittyverse.rb

@@ -1,5 +1,11 @@
 # encoding: utf-8
 
+## std libs
+require 'date'
+require 'json'
+
+
+## 3rd party libs
 require 'base32-alphabets'
 
 
@@ -9,8 +15,10 @@ require 'kittyverse/traits'
 require 'kittyverse/traits_timeline'
 require 'kittyverse/mewtations'
 require 'kittyverse/fancies'
+require 'kittyverse/purrstige'
 require 'kittyverse/catalog'
 
+
 require 'kittyverse/links'
 require 'kittyverse/pages/genes'
 
@@ -77,11 +85,16 @@ class TraitType
   #  note: all keys are the same except:
   ALT_TRAIT_TYPE_KEYS =
   {
-    :colorprimary   => :color1,
-    :colorsecondary => :color2,
-    :colortertiary  => :color3
+    # :colorprimary   => :color1,
+    # :colorsecondary => :color2,
+    # :colortertiary  => :color3
+
+    :color1   => :colorprimary,
+    :color2   => :colorsecondary,
+    :color3   => :colortertiary
   }
 
+
   def self.find_by_key( key )
     ## note: allow string AND symbols (thus, use .to_sym !!!)
     ## note: allow  known alternative mappings/key (e.g. "internal" cryptokitties keys if different)
@@ -111,7 +124,7 @@ class TraitType
     'tertiary color'   => 'accent color',
     'accent colour'    => 'accent color',     # british (canadian) spelling
     'wild'             => 'wild element',
-    'secrect'          => 'secret y gene'
+    'secret'           => 'secret y gene'
   }
 
   def self.find_by_name( name )
@@ -154,7 +167,8 @@ class TraitType
                 :name,
                 :code,
                 :genes,
-                :traits  ## array of 32 traits
+                :traits,      ## array of 32 traits
+                :cattributes  ## array of 29/31/x cattributes
 
   def initialize( **kwargs )
     update( kwargs )
@@ -271,6 +285,9 @@ class Traits
 end  # class Traits
 
 
+require 'kittyverse/cattributes'
+
+
 
 # say hello
 puts Kittyverse.banner    if defined?($RUBYLIBS_DEBUG) && $RUBYLIBS_DEBUG

data/lib/kittyverse/catalog.rb

@@ -3,29 +3,23 @@
 
 class Catalog    ## todo:  use a module - move to its own file -  why? why not?
 
-  @@specials   = {}  # special edition fancies
-  @@exclusives = {}  # exclusive fancies
-  @@fancies    = {}  # "normal" fancies
-
-  @@prestiges  = {}  # purrstige cattributes
+  @@special_editions   = {}  # special edition fancies
+  @@exclusives         = {}  # exclusive fancies
+  @@fancies            = {}  # "normal" fancies
 
 
   ## use special_cats, exclusive_cats, etc. - why? why not?
-  def self.specials()   @@specials; end
-  def self.exclusives() @@exclusives; end
-  def self.fancies()    @@fancies; end
-
-  ## use prestige(purrstige)_cattributes - why? why not?
-  def self.prestiges()  @@prestiges; end
+  def self.special_editions()   @@special_editions; end
+  def self.exclusives()         @@exclusives; end
+  def self.fancies()            @@fancies; end
 
 
+## auto-fill
 FANCIES.each do |key,h|
-  if h[:special]
-    specials[key] = h
+  if h[:specialedition]
+    special_editions[key] = h
   elsif h[:exclusive]
     exclusives[key] = h
-  elsif h[:prestige]
-    prestiges[key] = h
   else
     fancies[key] = h
   end

data/lib/kittyverse/cattributes.rb

@@ -0,0 +1,116 @@
+# encoding: utf-8
+
+
+class Cattribute
+
+  def self.cattributes_by_name()  @@cattributes_by_name ||= {}; end
+
+  def self.find_by_name( name )
+    ## note: allow string AND symbols (thus, use .to_s !!!)
+    ## note: downcase name e.g. allow Savannah too (not just savannah)
+    @@cattributes_by_name[ name.downcase.to_s ]
+  end
+
+  ## add "generic" convenience find helper
+  def self.find_by( **kwargs )
+    if kwargs[ :name ]
+       find_by_name( kwargs[ :name ] )
+    else
+      ## todo/fix: throw argument except!!!
+      nil
+    end
+  end
+
+  def self.[]( name ) find_by_name( name ); end
+
+
+
+  attr_accessor :type,
+                :name,
+                :traits,
+                :recipe
+
+  def initialize( **kwargs )
+    update( kwargs )
+  end
+
+  def update( **kwargs )
+    kwargs.each do |name,value|
+      send( "#{name}=", value ) ## use "regular" plain/classic attribute setter
+    end
+    self   ## return self for chaining
+  end
+
+
+
+  ## autofill cattributes
+  TRAITS.each do |key, h|
+      puts "key: #{key}"
+
+    tt = Traits[ key ]
+    tt.cattributes ||= []    ## if nil make sure it's an empty array when starting
+    ## pp tt
+
+    next if [:secret, :prestige].include?( key)
+
+    h[:kai].each do |kai, trait_name|
+      ## 1) skip "unnamed" traits
+      next if trait_name =~ /_[1-9a-z]$/
+
+
+
+
+      ## 2) special case for totebasic - one cattribute, three traits
+      ##      (that is, totesbasic 1, totesbasic 2, totesbasic 3)
+      if TOTESBASIC.include?( trait_name )
+        if trait_name == TOTESBASIC.first
+          t1 = Traits[ TOTESBASIC[0] ]
+          t2 = Traits[ TOTESBASIC[1] ]
+          t3 = Traits[ TOTESBASIC[2] ]
+
+          cattribute = Cattribute.new(
+                           name: 'totesbasic',
+                           type: tt,
+                           traits: [t1,t2,t3]
+                         )
+        else
+          next ## skip all other totesbasic traits
+        end
+      else
+        t = Traits[trait_name]
+        pp t.name
+
+        cattribute = Cattribute.new(
+                         name: trait_name,
+                         type: tt,
+                         traits: [t]
+                       )
+        ## pp cattribute
+      end
+
+      tt.cattributes << cattribute
+
+      cattributes_by_name[ cattribute.name ] = cattribute
+    end
+  end
+
+  ## add purrstiges traits
+  tt = Traits[:prestige]
+  tt.cattributes ||= []    ## if nil make sure it's an empty array when starting
+  PURRSTIGES.each do |key, h|
+    puts "key: #{key}"
+    pp h
+
+    cattribute = Cattribute.new(
+                     name: key.to_s,
+                     type: tt,
+                     traits: [],  ## empty traits
+                     recipe: h[:recipe]  ## todo/fix: add recipe as a struct (NOT as a hash)
+                   )
+    tt.cattributes << cattribute
+
+    cattributes_by_name[ cattribute.name ] = cattribute
+  end
+
+
+end # class Cattribute

data/lib/kittyverse/fancies.rb

@@ -9,6 +9,10 @@
 #      https://blog.kotobaza.co/timeline/
 
 
+##
+## todo/fix:
+##    use count:   for time-limited fancies  do NOT use limit!!!  change limit to count!!!
+
 ##
 ## note:
 ##  for time limits for fancies use:
@@ -18,195 +22,529 @@
 ##     e.g. overflow: 1      #   888+1  (=889)
 
 
-##  use open - to mark "breedable" fancies - why? why not?
-##  open: true   or use limit: nil ????
-##
+### todo/fix:
+##    split into EXCLUSIVES
+##       and into SPECIAL_EDITIONS   (SPECIALS?)  - why? why not?
+
+
 
 FANCIES =
 {
+  # Apr 27, 2019
+  # Krakitten Fancy Cat is discovered. Fancy Cat
+  krakitten: { name: 'Krakitten',
+               recipe: {
+                 time: { start: '2019-04-27', end: '2019-05-06' },
+                 traits: ['cobalt', 'ducky', 'salty', 'splat']}
+             },
+  # Apr 13, 2019
+  # Furbeard Fancy Cat is discovered. Fancy Cat
+  furbeard: { name: 'Furbeard', date: '2019-04-13',
+              recipe: {
+                limit: 3733,  ### todo -check if furbear was time windowed???
+                traits: ['inflatablepool', 'hanauma', 'neckbeard']}
+            },
+
+  # Apr 10, 2019
+  # Sparkles Special Edition Cat is released.Special Edition Cat
+  sparkles: { name: 'Sparkles', date: '2019-04-10',
+              specialedition: {
+                limit: 100 },
+              desc: 'Freebie for CryptoKitties Community Events'
+            },
+
+  papacatuanuku: { name: 'Papacatuanuku', date: '2019-03-31',
+                   exclusive: {
+                     limit: 1, ids: [1500000] },
+                   desc: 'Kitty #1500000'
+                 },
+
+  # Mar 30, 2019
+  # Glitter Fancy Cat is discovered. Fancy Cat
+  glitter: { name: 'Glitter',
+             recipe: {
+               time: { start: '2019-03-30', end: '2019-11-30'},
+               traits: ['rorschach', 'juju', 'unicorn', 'hyacinth'] }
+           },
+
+
+  # Mar 26, 2019
+  # Sir Meowsalot Exclusive Cat is released. Exclusive Cat
+  sirmeowsalot: { name: 'Sir Meowsalot', date: '2019-03-26',
+                  exclusive: {
+                    limit: 21, ids: (201..221).to_a }
+                },
+
+  # Mar 16, 2019
+  # Clover Fancy Cat is discovered. Fancy Cat
+  clover: { name: 'Clover', date: '2019-03-16',
+            recipe: {
+              limit: 2506,
+              traits: ['shamrock', 'emeraldgreen', 'roadtogold', 'PU27'] },
+            desc: "Celebrating St. Patrick's Day 2019 (March/19th)"
+          },
+
+  # Mar 2, 2019
+  # Glasswalker Fancy Cat is discovered. Fancy Cat
+  glasswalker: { name: 'Glasswalker', date: '2019-03-02',
+                 recipe: {
+                   limit: 1230,
+                   traits: ['cloudwhite', 'henna', 'pearl', 'firedup'] },
+                 desc: "Ninja Fancy Cat"
+                },
+
+  cyberberry: { name: 'Cyber Berry', date: '2019-03-02',
+                exclusive: {
+                  limit: 1, ids: [282] },
+                desc: "Winner of the NFTme Sweetstakes"
+              },
+
+  # Mar 1, 2019
+  # Hinecatone Exclusive Cat is discovered. Exclusive Cat
+  hinecatone: { name: 'Hinecatone', date: '2019-03-01',
+                exclusive: {
+                  limit: 15, ids: [1423547, 1433380, 1433486, 1440835, 1453366, 1456935, 1456973, 1459319, 1463197, 1466118, 1474082, 1484593, 1484982, 1492154, 1498885]}
+              },
+
+
+  # Feb 21, 2019
+  # Ande Fancy Cat is discovered. Fancy Cat
+  ande: { name: 'Ande', date: '2019-02-21',
+          recipe: {
+            limit: 440,
+            traits: ['munchkin', 'cashewmilk', 'moue', 'PU30', 'WE10'] }
+        },
+  # Feb 17, 2019
+  # Al Fancy Cat is discovered. Fancy Cat
+  al: { name: 'Al',
+        recipe: {
+          time: { start: '2019-02-17', end: '2019-12-01'},
+          traits: ['munchkin','moue','cashewmilk','brownies'] }
+      },
+  # Feb 16, 2019
+  # Pizzazz Fancy Cat is discovered.Fancy Cat
+  pizzazz: { name: 'Pizzazz',
+             recipe: {
+               time: { start: '2019-02-16', end: '2019-12-01'},
+               traits: ['mekong', 'scarlet', 'spangled', 'wonky'] }
+           },
+
+  # Feb 15, 2019
+  # Felono Exclusive Cat is discovered. Exclusive Cat
+  felono: { name: 'Felono', date: '2019-02-15',
+            exclusive: {
+              limit: 30, ids: [1394641, 1404595, 1406021, 1413065, 1414375, 1420553, 1421315, 1421864, 1424104 ,1425433, 1431823, 1435517, 1436333, 1449860, 1451482, 1455458, 1459320, 1462952, 1463069, 1476999, 1483225, 1487210, 1487551, 1489681, 1490345, 1491632, 1492206, 1492739, 1492817, 1498778]}
+          },
+
+  # Feb 9, 2019
+  # Miss Purrfect Fancy Cat is discovered.Fancy Cat
+  misspurrfect: { name: 'Miss Purrfect', date: '2019-02-09',
+                  recipe: {
+                    limit: 1298,
+                    traits: ['allyouneed', 'butterscotch', 'asif', 'satiated', 'flapflap']},
+                  desc: "Celebrating St. Valentine's Day 2019 (Feb/14th)"
+                },
+
   ## 2019
   ## January
 
+  # Jan 26, 2019
+  # Squib Fancy Cat is discovered. Fancy Cat
+  squib: { name: 'Squib', date: '2019-01-26',
+           recipe: {
+             limit: 1443,
+             traits: ['oldlace', 'razzledazzle', 'buzzed', 'rollercoaster']},
+           desc: 'Celebrating American Football Super Bowl LIII in 2019'
+         },
+
+  tallythepurrocious: { name: 'Tally The Purrocious',
+                        recipe: {
+                          time: { start: '2019-01-10', end: '2019-01-21' }, count: 3992,
+                          traits: ['selkirk', 'koala', 'arcreactor', 'sully'] },
+                        desc: 'Gods Unchained Promotion - Mystical Cat Talisman'
+                      },
+  ## date: '2019-01-10 ???  -- use for date "announced" or something - why? why not?
+  aeoncat: { name: 'Aeoncat',
+              specialedition: {
+                time: { start: '2019-01-17', end: '2019-01-28' },
+                limit: 380 },    ## Don't sleep - there's only 380 up for grabs!
+              desc: 'Goddess Aeona - Goddess of Nature - Gods Unchained Promotion'
+           },
+  hypurrion: { name: 'Hypurrion', date: '2019-01-10',
+               exclusive: {
+                 limit: 1, ids: [269]},
+               desc: 'Hyperion - Mythic Titan of Light - Gods Unchained Promotion'
+             },
 
   ## 2018
   ## December
-  catzy: { name: 'Catzy', date: '2018-12-31', limit: 10, ids: (1137653..1137662).to_a,
-           special: true,
-           desc: 'Changpeng "CZ" Zhao - CEO of Binance - Top 10 Blockchain Influencer of the Year 2018 by CoinDesk' },
-  purremyallaire: { name: 'Purremy Allaire', date: '2018-12-31', limit: 10, ids: (1137663..1137672).to_a,
-                    special: true,
-                    desc: 'Jeremy Allaire - Top 10 Blockchain Influencer of the Year 2018 by CoinDesk' },
-  genedough: { name: 'Gene Dough', date: '2018-12-23', time: { end: '2019-01-07' },
-                traits: ['hotcocoa', 'mittens', 'frosting'],
-                open: true },
-  pawrula:  { name: 'Pawrula the Bright', date: '2018-12-15', time: { start: '2018-12-15', end: '2019-11-30' },
-                traits: ['camo', 'butterscotch', 'fox'],
-                desc: 'Neha Narula - Director of the Digital Currency Initiative at the MIT Media Lab',
-                open: true },
- reindeer: { name: 'Reindeer', date: '2018-12-14',
-              time: { start: '2018-12-14', end: '2019-01-07' }, prestige: true,
-              traits: ['elk', ['PU24','PU25','PU26','PU27']],
-               open: true },
- holidaycheer: { name: 'Holidaycheer', date: '2018-12-14',
-                  time: { start: '2018-12-14', end: '2019-01-07' }, prestige: true,
-                  traits: ['elk', ['PU28','PU29']],
-                  open: true },
-  lit:      { name: 'Lit', date: '2018-12-14',
-              time: { start: '2018-12-14', end: '2019-01-07' }, prestige: true,
-               traits: ['elk', 'PU30'],
-                open: true },
+  catzy: { name: 'Catzy', date: '2018-12-31',
+           specialedition: {
+             limit: 10, ids: (1137653..1137662).to_a },
+           desc: 'Changpeng "CZ" Zhao - CEO of Binance - Top 10 Blockchain Influencer of the Year 2018 by CoinDesk'
+         },
+  purremyallaire: { name: 'Purremy Allaire', date: '2018-12-31',
+                    specialedition: {
+                      limit: 10, ids: (1137663..1137672).to_a },
+                    desc: 'Jeremy Allaire - Top 10 Blockchain Influencer of the Year 2018 by CoinDesk'
+                  },
+  genedough: { name: 'Gene Dough',
+               recipe: {
+                 time: { start: '2018-12-23', end: '2019-01-07' }, count: 1376,
+                 traits: ['hotcocoa', 'mittens', 'frosting'] }
+            },
+  pawrula:  { name: 'Pawrula the Bright',
+              recipe: {
+                 time: { start: '2018-12-15', end: '2019-11-30' },
+                 traits: ['camo', 'butterscotch', 'fox'] },
+              desc: 'Neha Narula - Director of the Digital Currency Initiative at the MIT Media Lab'
+            },
 
   ## November
-  draco:                { name: 'Draco',    date: '2018-11-30', limit: 1115, time: { end: '2018-12-07' },
-                          traits: ['toyger', 'martian', 'peppermint', 'dragonwings', 'SE03']},
-  dracothemagnificent:  { name: 'Draco The Magnificent', date: '2018-11-27', limit: 12, exclusive: true, ids:	(270..281).to_a },
-  bugcatv2:             { name: 'Bug Cat V2',            date: '2018-11-27', limit: 20, exclusive: true, ids: (167..186).to_a, desc: 'Bug Bounty II (Offers Contract) Kitty' },
-  dracojunior: { name: 'Draco Junior',  date: '2018-11-26', limit: 1398, time: { end: '2018-12-07' },
-                 traits: ['lynx', 'verdigris', 'dragontail', 'SE03']},
-  dreggo:      { name: 'Dreggo',        date: '2018-11-21', limit: 3624, time: { end: '2018-12-07' },
-                 traits: ['siberian', 'bananacream', 'SE03']},
-  pickles:     { name: 'Pickles',      date: '2018-11-14',  limit: 303,
-                 traits: ['lynx', 'martian', 'highsociety', 'emeraldgreen']},
-  lilbub:      { name: 'Lil Bub Ub Bub (BUB)',   date: '2018-11-13',  limit: 468, special: true },  ## for search use specialedition:
-
-  lilbubthemagicalspacecat: { name: 'Lil Bub Ub Bub (BUB) The Magical Space Cat', date: '2018-11-13', limit: 3, exclusive: true, ids: [266,267,268] },
+  draco:                { name: 'Draco',
+                          recipe: {
+                            time: { start: '2018-11-30', end: '2018-12-07' }, count: 1115,
+                            traits: ['toyger', 'martian', 'peppermint', 'dragonwings', 'SE03'] }
+                        },
+  dracothemagnificent:  { name: 'Draco The Magnificent', date: '2018-11-27',
+                          exclusive: {
+                            limit: 12, ids:	(270..281).to_a }
+                        },
+  bugcatv2:             { name: 'Bug Cat V2', date: '2018-11-27',
+                          exclusive: {
+                            limit: 20, ids: (167..186).to_a },
+                          desc: 'Bug Bounty II (Offers Contract) Kitty'
+                        },
+  dracojunior: { name: 'Draco Junior',
+                 recipe: {
+                   time: { start: '2018-11-26', end: '2018-12-07' }, count: 1398,
+                   traits: ['lynx', 'verdigris', 'dragontail', 'SE03']}
+               },
+  dreggo:      { name: 'Dreggo',
+                 recipe: {
+                   time: { start: '2018-11-21', end: '2018-12-07' }, count: 3624,
+                   traits: ['siberian', 'bananacream', 'SE03'] }
+               },
+  pickles:     { name: 'Pickles', date: '2018-11-14',
+                 recipe: {
+                   limit: 303,
+                   traits: ['lynx', 'martian', 'highsociety', 'emeraldgreen']}
+               },
+  lilbub:      { name: 'Lil Bub Ub Bub (BUB)', date: '2018-11-13',
+                 specialedition: {
+                   limit: 468 }
+               },
 
-  ## October
-  thatsawrap:  { name: 'Thatsawrap', date: '2018-10-21', limit:	615, time: { start: '2018-10-20', end: '2018-11-06' }, prestige: true,
-                  traits: ['bobtail','WE00','PU28']},
-  duckduckcat: { name: 'Duckduckcat', date: '2018-10-19', limit: 1249, time: { start: '2018-10-20', end: '2018-11-15' }, prestige: true,
-                   traits: ['neckbeard',['PU24','PU25','PU26']]},  ##  Purrstige: PU24 / PU25 / PU26
+  lilbubthemagicalspacecat: { name: 'Lil Bub Ub Bub (BUB) The Magical Space Cat', date: '2018-11-13',
+                              exclusive: {
+                                limit: 3, ids: [266,267,268]}
+                            },
 
-  dukecat:       { name: 'Dukecat',       date: '2018-10-18', limit: 1366,
-                   traits: ['cymric', 'periwinkle', 'simple', 'tongue']},
-  sheilapurren:  { name: 'Sheila Purren', date: '2018-10-04', limit: 1971, desc: 'Sheila Warren Kitty-fied - Head of Blockchain and Distributed Ledger Technology at the World Economic Forum (WEF)',
-                   traits: ['mauveover', 'icy', 'wingtips', 'fangtastic']},
+  ## October
+  dukecat:       { name: 'Dukecat', date: '2018-10-18',
+                   recipe: {
+                     limit: 1366,
+                     traits: ['cymric', 'periwinkle', 'simple', 'tongue']}
+                 },
+  sheilapurren:  { name: 'Sheila Purren', date: '2018-10-04',
+                   recipe: {
+                     limit: 1971,
+                     traits: ['mauveover', 'icy', 'wingtips', 'fangtastic']},
+                   desc: 'Sheila Warren Kitty-fied - Head of Blockchain and Distributed Ledger Technology at the World Economic Forum (WEF)'
+                 },
 
   ## September
-  pawzilla: { name: 'Pawzilla', date: '2018-09-22', limit: 1185,
-              traits: ['jaguar', 'universe', 'atlantis', 'littlefoot']},
-  prune:   { name: 'Prune', date: '2018-09-19', limit: 921, time: { start: '2018-09-18', end: '2018-09-30' }, prestige: true,
-            traits: ['norwegianforest', 'totesbasic', 'PU25']},     ## todo/fix: check totesbasic - three genes!!! - check which one PA15?
-  furball:  { name: 'Furball', date: '2018-09-19', limit: 998, time: { start: '2018-09-19', end: '2018-09-30' }, prestige: true,
-              traits: ['norwegianforest', 'totesbasic', 'PU26']},   ## todo/fix: check totesbasic - three genes!!! - check which one PA15?
-  vulcat:   { name: 'Vulcat',   date: '2018-09-12', limit: 1, exclusive: true, ids: [1000000], desc: '1 000 000th Kitty' },
-  meowstro: { name: 'Meowstro', date: '2018-09-09', limit: 1698,
-              traits: ['onyx', 'wowza', 'eclipse']},
-  atlas:    { name: 'Atlas',    date: '2018-09-07', limit: 998,
-              traits: ['highlander', 'kittencream', 'swarley', 'topoftheworld']},
+  pawzilla: { name: 'Pawzilla', date: '2018-09-22',
+              recipe: {
+                limit: 1185,
+                traits: ['jaguar', 'universe', 'atlantis', 'littlefoot']}
+            },
+  vulcat:   { name: 'Vulcat', date: '2018-09-12',
+              exclusive: {
+                limit: 1, ids: [1000000] },
+              desc: '1 000 000th Kitty'
+            },
+  meowstro: { name: 'Meowstro', date: '2018-09-09',
+              recipe: {
+                limit: 1698,
+                traits: ['onyx', 'wowza', 'eclipse']}
+            },
+  atlas:    { name: 'Atlas', date: '2018-09-07',
+              recipe: {
+                limit: 998,
+                traits: ['highlander', 'kittencream', 'swarley', 'topoftheworld']}
+            },
 
   ## August
-  vulcant:        { name: 'Vulcant',        date: '2018-08-31', limit: 20, exclusive: true, ids: [932914,937360,938299,946526,948925,949058,950617,952280,952981,956374,956908,958570,964205,967234,983046,984451,990713,992861,995745,997469] },
-  purrity:        { name: 'Purrity',        date: '2018-08-23', limit: 5984,
-                    traits: ['selkirk', 'chronic', 'cloudwhite', 'cheeky']},
-  rabbidkitty:    { name: 'Rabbid Kitty',   date: '2018-08-23', limit: 6, exclusive: true, ids: (260..265).to_a, desc: 'Ubisoft Blockchain Heroes Hackathon' },
-  squiddlesworth: { name: 'Squiddlesworth', date: '2018-08-16', limit: 1510, desc: 'Lava Squid Cat',
-                     traits: ['sphynx', 'redvelvet', 'patrickstarfish', 'dragontail']},
+  vulcant:        { name: 'Vulcant', date: '2018-08-31',
+                    exclusive: {
+                      limit: 20, ids: [932914,937360,938299,946526,948925,949058,950617,952280,952981,956374,956908,958570,964205,967234,983046,984451,990713,992861,995745,997469] }
+                  },
+  purrity:        { name: 'Purrity', date: '2018-08-23',
+                    recipe: {
+                      limit: 5984,
+                      traits: ['selkirk', 'chronic', 'cloudwhite', 'cheeky'] }
+                  },
+  rabbidkitty:    { name: 'Rabbid Kitty', date: '2018-08-23',
+                    exclusive: {
+                       limit: 6, ids: (260..265).to_a },
+                    desc: 'Ubisoft Blockchain Heroes Hackathon'
+                  },
+  squiddlesworth: { name: 'Squiddlesworth', date: '2018-08-16',
+                    recipe: {
+                      limit: 1510,
+                      traits: ['sphynx', 'redvelvet', 'patrickstarfish', 'dragontail'] },
+                    desc: 'Lava Squid Cat'
+                   },
 
   ## July
-  purrspero:      { name: 'Purrspero',   date: '2018-07-27', limit: 4448,
-                    traits: ['dippedcone', 'googly', 'royalpurple', 'beard']},
-  catbury:        { name: 'Catbury',     date: '2018-07-25', limit: 76,
-                     traits: ['ragdoll', 'crazy', 'chocolate', 'mintmacaron', 'yokel', 'WE02']},
-  honu:           { name: 'Honu',        date: '2018-07-20', limit: 1, exclusive: true, ids: [251], desc: 'Kitties for Good - Save Turtle Habitats' },
-  victoire:       { name: 'Victoire',    date: '2018-07-18', limit: 1, exclusive: true, ids: [402], desc: 'France Football World Cup Champion' },
-  lulu:           { name: 'Lulu',        date: '2018-07-13', limit: 999,
-                    traits: ['cyan', 'verdigris', 'turtleback', 'salty']},
-  boot:           { name: 'Boot',        date: '2018-07-05', limit: 1440,  desc: 'Football World Cup',
-                    traits: ['ganado', 'wiley', 'cerulian', 'rollercoaster'],
-                    variants: {
-                      belgium: { name: 'Belgium', limit: 97,   traits: [['orangesoda','onyx']]},                    ## Base Color: Orangesoda / Onyx
-                      brazil:  { name: 'Brazil',  limit: 195,  traits: [['hintomint','bananacream','verdigris']]},  ## Base Color: Hintomint / Bananacream / Verdigris
-                      croatia: { name: 'Croatia', limit: 253,  traits: [['cottoncandy','mauveover','oldlace']]},    ## Base Color: Cottoncandy / Mauveover / Oldlace
-                      england: { name: 'England', limit: 168,  traits: [['greymatter','martian']]},                 ## Base Color: Greymatter / Martian
-                      france:  { name: 'France',  limit: 317,  traits: [['harbourfog','cinderella','lavender']]},   ## Base Color: Harbourfog / Cinderella / Lavender
-                      russia:  { name: 'Russia',  limit: 94,   traits: [['shadowgrey','salmon','cloudwhite']]},     ## Base Color: Shadowgrey / Salmon/ Cloudwhite
-                      sweden:  { name: 'Sweden',  limit: 123,  traits: [['brownies','dragonfruit','redvelvet']]},   ## Base Color: Brownies / Dragonfruit / Redvelvet
-                      uruguay: { name: 'Uruguay', limit: 193,  traits: [['aquamarine','nachocheez','koala']]},      ## Base Color: Aquamarine / Nachocheez / Koala
-                    },
+  purrspero:      { name: 'Purrspero', date: '2018-07-27',
+                    recipe: {
+                      limit: 4448,
+                      traits: ['dippedcone', 'googly', 'royalpurple', 'beard']}
+                  },
+  catbury:        { name: 'Catbury', date: '2018-07-25',
+                    recipe: {
+                      limit: 76,
+                      traits: ['ragdoll', 'crazy', 'chocolate', 'mintmacaron', 'yokel', 'WE02']}
+                  },
+  honu:           { name: 'Honu', date: '2018-07-20',
+                    exclusive: {
+                      limit: 1, ids: [251] },
+                    desc: 'Kitties for Good - Save Turtle Habitats'
+                  },
+  victoire:       { name: 'Victoire', date: '2018-07-18',
+                    exclusive: {
+                      limit: 1, ids: [402] },
+                    desc: 'France Football World Cup Champion'
+                  },
+  lulu:           { name: 'Lulu', date: '2018-07-13',
+                    recipe: {
+                      limit: 999,
+                      traits: ['cyan', 'verdigris', 'turtleback', 'salty']}
+                  },
+  boot:           { name: 'Boot', date: '2018-07-05',
+                    recipe: {
+                      limit: 1440,
+                      traits: ['ganado', 'wiley', 'cerulian', 'rollercoaster'],
+                      variants: {
+                        belgium: { name: 'Belgium', count: 97,   traits: [['orangesoda','onyx']]},                    ## Base Color: Orangesoda / Onyx
+                        brazil:  { name: 'Brazil',  count: 195,  traits: [['hintomint','bananacream','verdigris']]},  ## Base Color: Hintomint / Bananacream / Verdigris
+                        croatia: { name: 'Croatia', count: 253,  traits: [['cottoncandy','mauveover','oldlace']]},    ## Base Color: Cottoncandy / Mauveover / Oldlace
+                        england: { name: 'England', count: 168,  traits: [['greymatter','martian']]},                 ## Base Color: Greymatter / Martian
+                        france:  { name: 'France',  count: 317,  traits: [['harbourfog','cinderella','lavender']]},   ## Base Color: Harbourfog / Cinderella / Lavender
+                        russia:  { name: 'Russia',  count: 94,   traits: [['shadowgrey','salmon','cloudwhite']]},     ## Base Color: Shadowgrey / Salmon/ Cloudwhite
+                        sweden:  { name: 'Sweden',  count: 123,  traits: [['brownies','dragonfruit','redvelvet']]},   ## Base Color: Brownies / Dragonfruit / Redvelvet
+                        uruguay: { name: 'Uruguay', count: 193,  traits: [['aquamarine','nachocheez','koala']]},      ## Base Color: Aquamarine / Nachocheez / Koala
+                      }},
+                    desc: 'Football World Cup',
                   },
   ## note: boot - different variants for world cup teams
   ##  Although there are 8 unique Fancies, they're actually each a variant on the same Fancy - Boot.
   ##  Their colours are different, and you can collect all 8 as a set
 
   ## June
-  raspoutine:    { name: 'Raspoutine',  date: '2018-06-28', limit: 1867,
-                    traits: ['buzzed', 'nachocheez', 'sandalwood', 'belch']},
-  furlin:        { name: 'Furlin',      date: '2018-06-26', limit: 52, exclusive: true, ids: (115..126).to_a + (128..166).to_a },
-  kittypride:    { name: 'Kitty Pride', date: '2018-06-21', limit: 1316,
-                    traits: ['fabulous','cinderella','garnet']},
-  furrmingo:     { name: 'Furrmingo',   date: '2018-06-14', limit: 333,
-                    traits: ['bobtail', 'egyptiankohl', 'flamingo', 'whixtensions']},
+  raspoutine:    { name: 'Raspoutine', date: '2018-06-28',
+                   recipe: {
+                     limit: 1867,
+                     traits: ['buzzed', 'nachocheez', 'sandalwood', 'belch']}
+                },
+  furlin:        { name: 'Furlin', date: '2018-06-26',
+                   exclusive: {
+                     limit: 52, ids: (115..126).to_a + (128..166).to_a }
+                 },
+  kittypride:    { name: 'Kitty Pride', date: '2018-06-21',
+                   recipe: {
+                     limit: 1316,
+                     traits: ['fabulous','cinderella','garnet']}
+                 },
+  furrmingo:     { name: 'Furrmingo', date: '2018-06-14',
+                   recipe: {
+                     limit: 333,
+                     traits: ['bobtail', 'egyptiankohl', 'flamingo', 'whixtensions']}
+                },
 
   ## May
-  page:              { name: 'Page',              date: '2018-05-31',  limit: 50_000,
-                       traits: ['rascal', 'peach', 'wasntme' ]},
-  "schrödingerscat": { name: "Schrödinger's Cat", date: '2018-05-20',  limit: 73,
-                        traits: ['forgetmenot','tinybox','PU20','SE25']},
-  chatplongeur:      { name: 'Chat Plongeur',     date: '2018-05-19',  limit: 1910,
-                        traits: ['aquamarine', 'skyblue', 'seafoam']},
-  docpurr:             { name: 'Doc Purr',         date: '2018-05-16',  limit: 250,
-                          traits: ['persian','spock','raisedbrow','violet','tongue']},
-  celestialcyberdimension: { name: 'Celestial Cyber Dimension', date: '2018-05-12', limit: 1, exclusive: true, ids: [127] },
-  swish:               { name: 'Swish', date: '2018-05-08', limit: 2880,
-                          traits: ['norwegianforest', 'luckystripe', 'thicccbrowz', 'orangesoda']},
+  page:              { name: 'Page', date: '2018-05-31',
+                       recipe: {
+                         limit: 50_000,
+                         traits: ['rascal', 'peach', 'wasntme' ]}
+                     },
+  "schrödingerscat": { name: "Schrödinger's Cat", date: '2018-05-20',
+                       recipe: {
+                         limit: 73,
+                         traits: ['forgetmenot','tinybox','PU20','SE25']}
+                     },
+  chatplongeur:      { name: 'Chat Plongeur', date: '2018-05-19',
+                       recipe: {
+                         limit: 1910,
+                         traits: ['aquamarine', 'skyblue', 'seafoam'] }
+                     },
+  docpurr:             { name: 'Doc Purr', date: '2018-05-16',
+                         recipe: {
+                           limit: 250,
+                           traits: ['persian','spock','raisedbrow','violet','tongue'] }
+                       },
+  celestialcyberdimension: { name: 'Celestial Cyber Dimension', date: '2018-05-12',
+                             exclusive: {
+                               limit: 1, ids: [127] }
+                           },
+  swish:               { name: 'Swish', date: '2018-05-08',
+                         recipe: {
+                           limit: 2880,
+                           traits: ['norwegianforest', 'luckystripe', 'thicccbrowz', 'orangesoda'] }
+                       },
 
   ## April
-  flutterbee:  { name: 'Flutterbee', date: '2018-04-28', limit: 275,
-                 traits: ['cloudwhite','jaguar','lemonade','azaleablush','WE14']},
-  vernon:      { name: 'Vernon',     date: '2018-04-16', limit: 320, desc: 'Spring Equinox Kitty',
-                  traits: ['amur','fabulous','cottoncandy','springcrocus','belleblue','soserious']},  ## first, see https://www.cryptokitties.co/kitty/696398
+  flutterbee:  { name: 'Flutterbee', date: '2018-04-28',
+                 recipe: {
+                   limit: 275,
+                   traits: ['cloudwhite','jaguar','lemonade','azaleablush','WE14'] }
+               },
+  vernon:      { name: 'Vernon', date: '2018-04-16',
+                 recipe: {
+                   limit: 320,
+                   traits: ['amur','fabulous','cottoncandy','springcrocus','belleblue','soserious']},
+                 desc: 'Spring Equinox Kitty'  ## first, see https://www.cryptokitties.co/kitty/696398
+                },
 
   ## March
-  berry:           { name: 'Berry',   date: '2018-03-16', limit: 200,
-                     traits: ['dragonfruit','thunderstruck','emeraldgreen','apricot','simple']},
-  pussforprogress: { name: 'Puss For Progress', date: '2018-03-08', limit: 1920, desc: "Women's Day",
-                     traits: ['himalayan','peach','safetyvest','gerbil']},
-  fortunecat:      { name: 'Fortune Cat', name_cn: '红包喵', date: '2018-03-08', limit: 888,
-                      traits: ['harbourfog','calicool','swampgreen','sapphire','beard']},  ## todo: check date for china launch specials!!!
-  goldendragoncat: { name: 'Golden Dragon Cat', name_cn: '帝龙喵', date: '2018-03-08', limit: 1, exclusive: true, ids: [888], desc: 'China Launch' }, ## todo: check date for china launch specials!!!
-  goldendogcat:    { name: 'Golden Dog Cat', name_cn: '旺财汪', date: '2018-03-08', limit: 11, exclusive: true, ids: [1802,1803,1805,1806,1808,1809,1812,1816]+(1825..1828).to_a, desc: 'China Launch' },  ## todo: check date for china launch specials!!!
-  liondance:    { name: 'Lion Dance', name_cn: '咚咚锵', date: '2018-03-07', limit: 888, overflow: 1,
-                    traits: ['manx','royalblue','googly','starstruck']},
-  dogcat:       { name: 'Dog Cat',    name_cn: '汪星爷', date: '2018-03-02', limit: 88, desc: 'Year of the Dog (Greater China)',
-                   traits: ['tigerpunk','periwinkle','barkbrown','sweetmeloncakes','yokel']},
-  knightkitty:  { name: 'Knight Kitty',  date: '2018-03-01',  limit: 11, exclusive: true, ids: (104..114).to_a },
+  berry:           { name: 'Berry', date: '2018-03-16',
+                     recipe: {
+                       limit: 200,
+                       traits: ['dragonfruit','thunderstruck','emeraldgreen','apricot','simple'] }
+                   },
+  pussforprogress: { name: 'Puss For Progress', date: '2018-03-08',
+                     recipe: {
+                       limit: 1920,
+                       traits: ['himalayan','peach','safetyvest','gerbil'] },
+                     desc: "Women's Day"
+                   },
+  fortunecat:      { name: 'Fortune Cat', name_cn: '红包喵', date: '2018-03-08',
+                     recipe: {
+                       limit: 888,
+                       traits: ['harbourfog','calicool','swampgreen','sapphire','beard']}
+                    },  ## todo: check date for china launch specials!!!
+  goldendragoncat: { name: 'Golden Dragon Cat', name_cn: '帝龙喵', date: '2018-03-08',
+                     exclusive: {
+                       limit: 1, ids: [888] },
+                     desc: 'China Launch'
+                   }, ## todo: check date for china launch specials!!!
+  goldendogcat:    { name: 'Golden Dog Cat', name_cn: '旺财汪', date: '2018-03-08',
+                     exclusive: {
+                       limit: 11, ids: [1802,1803,1805,1806,1808,1809,1812,1816]+(1825..1828).to_a },
+                     desc: 'China Launch'
+                   },  ## todo: check date for china launch specials!!!
+  liondance:    { name: 'Lion Dance', name_cn: '咚咚锵', date: '2018-03-07',
+                  recipe: {
+                    limit: 888, overflow: 1,  ## use count 889 ?? - why? why not?
+                    traits: ['manx','royalblue','googly','starstruck']}
+                },
+  dogcat:       { name: 'Dog Cat',    name_cn: '汪星爷', date: '2018-03-02',
+                  recipe: {
+                    limit: 88,
+                    traits: ['tigerpunk','periwinkle','barkbrown','sweetmeloncakes','yokel']},
+                  desc: 'Year of the Dog (Greater China)'
+                },
+  knightkitty:  { name: 'Knight Kitty',  date: '2018-03-01',
+                  exclusive: {
+                    limit: 11, ids: (104..114).to_a }
+                },
 
   ## February
-  tabby:           { name: 'Tabby',           date: '2018-02-26', limit: 250,
-                      traits: ['ragamuffin','morningglory','otaku','cheeky']},
-  yuricatsuki:     { name: 'Yuri Catsuki',    date: '2018-02-20', limit: 250,  desc: 'Figure Scating Kitty - Winter Olympics (Korea)',
-                       traits: ['cymric','tiger','neckbeard','elk']},
-  misterpurrfect:  { name: 'Mister Purrfect', date: '2018-02-14', limit: 1000, desc: "Valentine's Day",
-                        traits: ['chocolate','baddate','strawberry','wuvme']},
-  earnie:          { name: 'Earnie',          date: '2018-02-13', limit: 500,  desc: 'Earn.com - Golden Kitty Award (Product Hunt)',
-                        traits: ['birman','orangesoda','hotrod','grim']},
-  cathena:         { name: 'Cathena',         date: '2018-02-06', limit: 1,  exclusive: true, ids: [500000], desc: '500 000th Kitty' },
+  tabby:           { name: 'Tabby', date: '2018-02-26',
+                     recipe: {
+                       limit: 250,
+                       traits: ['ragamuffin','morningglory','otaku','cheeky'] }
+                   },
+  yuricatsuki:     { name: 'Yuri Catsuki',  date: '2018-02-20',
+                     recipe: {
+                       limit: 250,
+                       traits: ['cymric','tiger','neckbeard','elk'] },
+                     desc: 'Figure Scating Kitty - Winter Olympics (Korea)'
+                  },
+  misterpurrfect:  { name: 'Mister Purrfect', date: '2018-02-14',
+                     recipe: {
+                       limit: 1000,
+                       traits: ['chocolate','baddate','strawberry','wuvme'] },
+                     desc: "Valentine's Day"
+                   },
+  earnie:          { name: 'Earnie', date: '2018-02-13',
+                     recipe: {
+                       limit: 500,
+                       traits: ['birman','orangesoda','hotrod','grim'] },
+                     desc: 'Earn.com - Golden Kitty Award (Product Hunt)'
+                   },
+  cathena:         { name: 'Cathena',  date: '2018-02-06',
+                     exclusive: {
+                       limit: 1, ids: [500000] },
+                     desc: '500 000th Kitty'
+                   },
 
   ## January
-  'momo-chan':     { name: 'Momo-chan',       date: '2018-01-31',  limit: 500, desc: 'Ninja Kitty',
-                       traits: ['onyx','henna','bloodred','wolfgrey','sass']},
-  negato:          { name: 'Negato',          date: '2018-01-29',  limit: 500, desc: 'Ninja Kitty',
-                       traits: ['onyx','henna','wolfgrey','slyboots']},
-  stitches:        { name: 'Stitches',         date: '2018-01-10',  limit: 500, desc: 'Zombie Kitty',
-                       traits: ['hintomint','seafoam','swampgreen','saycheese']},
+  'momo-chan':     { name: 'Momo-chan', date: '2018-01-31',
+                     recipe: {
+                       limit: 500,
+                       traits: ['onyx','henna','bloodred','wolfgrey','sass'] },
+                      desc: 'Ninja Kitty'
+                   },
+  negato:          { name: 'Negato', date: '2018-01-29',
+                     recipe: {
+                       limit: 500,
+                       traits: ['onyx','henna','wolfgrey','slyboots'] },
+                     desc: 'Ninja Kitty'
+                   },
+  stitches:        { name: 'Stitches', date: '2018-01-10',
+                     recipe: {
+                       limit: 500,
+                       traits: ['hintomint','seafoam','swampgreen','saycheese'] },
+                     desc: 'Zombie Kitty'
+                   },
 
   ## 2017
   ## December
-  phuziqaat:    { name: 'Phu Ziqaat',    date: '2017-12-31',  limit: 1000,  desc: 'Alien Kitty',
-                   traits: ['chartreux','spock','alien','pouty']},
-  santaclaws:   { name: 'Santa Claws',   date: '2017-12-12',  limit: 1000, overflow: 2, desc: 'Ho Ho Ho - Santa Claus Kitty',
-                    traits: ['cloudwhite','scarlet','beard','wild_d']},
-  mistletoe:    { name: 'Mistletoe',     date: '2017-12-09',  limit: 2000,  desc: "XMas Kitty",
-                   traits: ['oldlace','crazy','gerbil']},
-  dracula:      { name: 'Dracula',       date: '2017-12-01',  limit: 2000,
-                   traits: ['laperm','spock','strawberry','WE01']},
+  phuziqaat:    { name: 'Phu Ziqaat', date: '2017-12-31',
+                  recipe: {
+                    limit: 1000,
+                    traits: ['chartreux','spock','alien','pouty'] },
+                  desc: 'Alien Kitty'
+                },
+  santaclaws:   { name: 'Santa Claws', date: '2017-12-12',
+                  recipe: {
+                    limit: 1000, overflow: 2,
+                    traits: ['cloudwhite','scarlet','beard','wild_d'] },
+                  desc: 'Ho Ho Ho - Santa Claus Kitty'
+                },
+  mistletoe:    { name: 'Mistletoe', date: '2017-12-09',
+                  recipe: {
+                    limit: 2000,
+                    traits: ['oldlace','crazy','gerbil'] },
+                  desc: "XMas Kitty"
+                },
+  dracula:      { name: 'Dracula', date: '2017-12-01',
+                  recipe: {
+                    limit: 2000,
+                    traits: ['laperm','spock','strawberry','WE01'] }
+                },
 
   ## November
-  ducat:        { name: 'Du Cat',        date: '2017-11-29',  limit: 10_000,
-                    traits: ['cymric','tongue']},
-  genesis:      { name: 'Genesis',       date: '2017-11-24',  limit: 1,     exclusive: true, ids: [1],  desc: '1st Kitty'},
-  shipcat:      { name: 'Ship Cat',      date: '2017-11-23',  limit: 2000,
-                    traits: ['sphynx','orangesoda','luckystripe','crazy']},
-  bugcat:       { name: 'Bug Cat',       date: '2017-11-23',  limit: 3,     exclusive: true, ids: [101,102,103], desc: 'Bug Bounty Kitty' },
+  ducat:        { name: 'Du Cat', date: '2017-11-29',
+                  recipe: {
+                    limit: 10_000,
+                    traits: ['cymric','tongue']}
+                },
+  genesis:      { name: 'Genesis', date: '2017-11-24',
+                  exclusive: {
+                    limit: 1, ids: [1] },
+                  desc: '1st Kitty'
+                },
+  shipcat:      { name: 'Ship Cat', date: '2017-11-23',
+                  recipe: {
+                    limit: 2000,
+                    traits: ['sphynx','orangesoda','luckystripe','crazy']}
+                },
+  bugcat:       { name: 'Bug Cat', date: '2017-11-23',
+                  exclusive: {
+                    limit: 3, ids: [101,102,103] },
+                  desc: 'Bug Bounty Kitty' }
 }