kittyverse 0.5.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 785ca9bb2bcf4b431d97bbabffe81febb457680f
-  data.tar.gz: b7c9e5e37989a0924962c736536956a3cbe9a1b4
+SHA256:
+  metadata.gz: 2c9a1e3b4124c7cfc32ae01192d0ae57348ef143a79fabfe9517deb5494ea8f8
+  data.tar.gz: a32acc4988391b51d6d4bd9d84810fcbf642283431da8d8648a309e139c157f9
 SHA512:
-  metadata.gz: 674acb2fcab22c3e4a7a5b279635e2a528eb744b27ed4966f72ddb2dd8146590c9daf44210d5a1023858fa0b8dbfe41c2fdd2861147b80172cc060e25f57c56f
-  data.tar.gz: ccde26e572b7b72b4677b049e27453479defb021a96e1237771c3cb2f1aeceb0743d760e2f3888d4124c5acc850376d276379c23f0ed5301acf79b4575f1501c
+  metadata.gz: 520e64e77f3a60bc3da660a247cd2067bba1fa1de14ca4d7cf2f4d8f700d11edd545987a68ed6afcf318e01a89d08dd68b7f42f540cc0f65e7c2876971d9a745
+  data.tar.gz: 0b0f530b74d3643a767f163d5fa8fe16225e016f8b3fbcc3476bae0f800e20393e25ca460cd9d247b5758a5118500c7066a1652891c987dc5a6e2079e34effc7

data/Manifest.txt

@@ -1,15 +1,14 @@
 CHANGELOG.md
-LICENSE.md
 Manifest.txt
 README.md
 Rakefile
 lib/kittyverse.rb
-lib/kittyverse/api/client.rb
-lib/kittyverse/api/versions.rb
 lib/kittyverse/cattributes.rb
 lib/kittyverse/config/colors.rb
+lib/kittyverse/config/exclusives.rb
 lib/kittyverse/config/fancies.rb
 lib/kittyverse/config/purrstiges.rb
+lib/kittyverse/config/special_editions.rb
 lib/kittyverse/config/traits.rb
 lib/kittyverse/config/traits_timeline.rb
 lib/kittyverse/fancies.rb

data/README.md

@@ -1,7 +1,7 @@
 # Kittyverse
 
 
-kittyverse library - helper classes for cattributes, trait types, traits, genes, genomes and more for cryptokitties and copycats
+kittyverse - helper classes for cattributes, trait types, traits, genes, genomes and more for cryptokitties and copycats
 
 * home  :: [github.com/cryptocopycats/kittyverse](https://github.com/cryptocopycats/kittyverse)
 * bugs  :: [github.com/cryptocopycats/kittyverse/issues](https://github.com/cryptocopycats/kittyverse/issues)
@@ -205,7 +205,7 @@ Use the `Genome` helper class to
 decipher the genes and lookup traits, mewtation tiers / levels,
 recessive / hidden genes and more.
 
-Let's build a gene reader. Pass in the "magic" 256-bit integer number for kitty #1001 
+Let's build a gene reader. Pass in the "magic" 256-bit integer number for kitty #1001
 from the blockchain
 and get all 48 genes deciphered in 12x4 slices / blocks:
 
@@ -217,14 +217,14 @@ genome.kai
 #=> "aaaa 7885 22f2 agff 1661 7755 e979 2441 6667 7664 a9aa cfff"
 
 genome.codes
-#=> "09-09-09-09 06-07-07-04 01-01-14-01 09-15-14-14 00-05-05-00 06-06-04-04 
+#=> "09-09-09-09 06-07-07-04 01-01-14-01 09-15-14-14 00-05-05-00 06-06-04-04
 #    13-08-06-08 01-03-03-00 05-05-05-06 06-05-05-03 09-08-09-09 11-14-14-14"
 
 genome.binary
-#=> "01001-01001-01001-01001 00110-00111-00111-00100 00001-00001-01110-00001 
-#    01001-01111-01110-01110 00000-00101-00101-00000 00110-00110-00100-00100 
-#    01101-01000-00110-01000 00001-00011-00011-00000 00101-00101-00101-00110 
-#    00110-00101-00101-00011 01001-01000-01001-01001 01011-01110-01110-01110" 
+#=> "01001-01001-01001-01001 00110-00111-00111-00100 00001-00001-01110-00001
+#    01001-01111-01110-01110 00000-00101-00101-00000 00110-00110-00100-00100
+#    01101-01000-00110-01000 00001-00011-00011-00000 00101-00101-00101-00110
+#    00110-00101-00101-00011 01001-01000-01001-01001 01011-01110-01110-01110"
 
 genome.each_with_index do |slice,i|
      offset = i*4
@@ -316,7 +316,7 @@ Purrstige (PU) - Genes 44-47:
 
 
 Tip: See the chapter 2 in the
-"[Programming Crypto Collectibles Step-by-Step Book / Guide. Let's start with CryptoKitties & Copycats. Inside Unique Bits & Bytes on the Blockchain...](https://github.com/openblockchains/programming-cryptocollectibles/blob/master/02_genereader.md)"
+"[Programming Crypto Collectibles Step-by-Step Book / Guide. Let's start with CryptoKitties & Copycats. Inside Unique Bits & Bytes on the Blockchain...](https://github.com/cryptocopycats/programming-crypto-collectibles/blob/master/02_genereader.md)"
 for how to create your own gene reader from scratch.
 
 
@@ -339,23 +339,23 @@ genome.body.class        #=> Gene::Slice
 genome.body.type.name    #=> "Fur"
 genome.body.type.code    #=> "FU"
 # -or-
-genome[:body].class      #=> Gene::Slice 
-genome[:body].type.name  #=> "Fur" 
+genome[:body].class      #=> Gene::Slice
+genome[:body].type.name  #=> "Fur"
 genome[:body].type.code  #=> "FU"
 # -or-
-genome.fu.class          #=> Gene::Slice 
-genome.fu.type.name      #=> "Fur" 
+genome.fu.class          #=> Gene::Slice
+genome.fu.type.name      #=> "Fur"
 genome.fu.type.code      #=> "FU"
 # -or-
 genome[:FU].class        #=> Gene::Slice
-genome[:FU].type.name    #=> "Fur" 
+genome[:FU].type.name    #=> "Fur"
 genome[:FU].type.code    #=> "FU"
 
-genome.body.d.class      #=> Trait 
+genome.body.d.class      #=> Trait
 genome.body.d.name       #=> "Ragamuffin"
 genome.body.d.code       #=> "FU14"
 # -or-
-genome[:body].d.class    #=> Trait 
+genome[:body].d.class    #=> Trait
 genome[:body].d.name     #=> "Ragamuffin"
 genome[:body].d.code     #=> "FU14"
 # -or-
@@ -372,7 +372,7 @@ genome.fu.d.name         #=> "Ragamuffin"
 genome.fu.d.code         #=> "FU14"
 # -or-
 genome.fu[0].class       #=> Trait
-genome.fu[0].name        #=> "Ragamuffin" 
+genome.fu[0].name        #=> "Ragamuffin"
 genome.fu[0].code        #=> "FU14"
 
 genome.fu.r1.class       #=> Trait
@@ -387,21 +387,24 @@ genome.body[1].code      #=> "FU14"
 and so on and so forth.
 
 
+
 ## Real World Usage
 
-### Reference Pages / Cheat Sheets
+### Reference Pages / Cheat Sheets @ Kittypedia
 
-Auto-generated CryptoKitties reference pages / cheat sheets include:
+Auto-generated reference pages / cheat sheets
+in the [Kittypedia - The Free CryptoKitties Encyclopedia](https://github.com/cryptocopycats/kittypedia) include:
 
-- [**CryptoKitties Cattributes Rarity / Popularity Statistics**](CATTRIBUTES.md)
-- [**CryptoKitties Genome / Genes Cheat Sheet**](GENES.md) - Fur (FU) • Pattern (PA) • Eye Color (EC) • Eye Shape (ES) • Base Color (BC) • Highlight Color (HC) • Accent Color (AC) • Wild Element (WE) • Mouth (MO) • Environment (EN) • Secret Y Gene (SE) • Purrstige (PU)
-- [**CryptoKitties Traits Cheat Sheet (with Codes, Mewtation Levels / Tiers, Search Links and More)**](TRAITS.md)
-- [**CryptoKitties Updates - Fancy / Exclusive / Special Edition Cats - Timeline**](updates/FANCIES.md)
-- [**CryptoKitties Updates - Purrstige Trait Recipes / Formulas - Timeline**](updates/PURRSTIGES.md)
+- [Cattributes Rarity / Popularity Statistics](https://github.com/cryptocopycats/kittypedia/blob/master/CATTRIBUTES.md)
+- [Genome / Genes Cheat Sheet](https://github.com/cryptocopycats/kittypedia/blob/master/GENES.md) - Fur (FU) ·  Pattern (PA) ·  Eye Color (EC) ·  Eye Shape (ES) ·  Base Color (BC) ·  Highlight Color (HC) ·  Accent Color (AC) ·  Wild Element (WE) ·  Mouth (MO) ·  Environment (EN) ·  Secret Y Gene (SE) ·  Purrstige (PU)
+- [Traits Cheat Sheet (with Codes, Mewtation Levels / Tiers, Search Links and More)](https://github.com/cryptocopycats/kittypedia/blob/master/TRAITS.md)
+- [Fancy / Exclusive / Special Edition Cats - Timeline](https://github.com/cryptocopycats/kittypedia/blob/master/TIMELINE-FANCIES.md)
+- [Purrstige Trait Recipes / Formulas - Timeline](https://github.com/cryptocopycats/kittypedia/blob/master/TIMELINE-PURRSTIGES.md)
 - and others
 
 
 
+
 ### 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
@@ -409,12 +412,13 @@ See the [copycats command line tool (and core library)](https://github.com/crypt
 
 ## More Documentation / Articles / Samples
 
-- [Programming Crypto Collectibles Step-by-Step Book / Guide](https://github.com/openblockchains/programming-cryptocollectibles) -
+- [Programming Crypto Collectibles Step-by-Step Book / Guide](https://github.com/cryptocopycats/programming-crypto-collectibles) -
 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
 
 ![](https://publicdomainworks.github.io/buttons/zero88x31.png)

data/Rakefile

@@ -8,7 +8,7 @@ Hoe.spec 'kittyverse' do
   self.summary = "kittyverse - helper classes for cattributes, trait types, traits, genes, genomes and more for cryptokitties and copycats"
   self.description = summary
 
-  self.urls    = ['https://github.com/cryptocopycats/kittyverse']
+  self.urls    = { home: 'https://github.com/cryptocopycats/kittyverse' }
 
   self.author  = 'Gerald Bauer'
   self.email   = 'wwwmake@googlegroups.com'

data/lib/kittyverse.rb

@@ -1,12 +1,9 @@
-# encoding: utf-8
-
 ## std libs
+require 'pp'
 require 'date'
+require 'time'
 require 'json'
-require 'pp'
 require 'uri'
-require 'net/http'
-require 'net/https'
 require 'fileutils'
 
 
@@ -19,6 +16,8 @@ require 'kittyverse/version'    # note: let version always go first
 
 require 'kittyverse/config/traits'
 require 'kittyverse/config/traits_timeline'
+require 'kittyverse/config/exclusives'
+require 'kittyverse/config/special_editions'
 require 'kittyverse/config/fancies'
 require 'kittyverse/config/purrstiges'
 require 'kittyverse/config/colors'
@@ -34,9 +33,6 @@ require 'kittyverse/traits'
 require 'kittyverse/cattributes'
 require 'kittyverse/fancies'
 
-## api support
-require 'kittyverse/api/client'
-require 'kittyverse/api/versions'
 
 ## genes / genome
 require 'kittyverse/gene'
@@ -44,4 +40,4 @@ require 'kittyverse/genome'
 
 
 # say hello
-puts Kittyverse.banner    if defined?($RUBYCOCO_DEBUG) && $RUBYCOCO_DEBUG
+puts Kittyverse.banner

data/lib/kittyverse/cattributes.rb

@@ -112,7 +112,7 @@ class Cattribute
               traits:     h[:recipe][:traits],      ## todo/fix: turn strings into trait objs!!!!
               limit:      h[:recipe][:limit],
               time_start: h[:recipe][:time] && h[:recipe][:time][:start] ? Date.strptime( h[:recipe][:time][:start], '%Y-%m-%d' ) : nil,
-              time_end:   h[:recipe][:time] && h[:recipe][:time][:end]   ? Date.strptime( h[:recipe][:time][:end],   '%Y-%m-%d' ) : nil )
+              time_end:   h[:recipe][:time] && h[:recipe][:time][:end] && h[:recipe][:time][:end] != '?'  ? Date.strptime( h[:recipe][:time][:end],   '%Y-%m-%d' ) : nil )
 
     cattribute = Cattribute.new(
                      key:    key,

data/lib/kittyverse/config/exclusives.rb

@@ -0,0 +1,197 @@
+
+
+EXCLUSIVES = {
+
+ #  11.07.20  - New Exclusive - Pepito
+ # The Morse Meows Shelter is saving kitties from Strasburg, Virginia
+ #  by taking them off the streets and getting them ready
+ # to find their furrever homes! Community cool cat and ultra-high generation collector,
+ #   Club 1000, sounded the Kitty alarm to support this shelter in need.
+ #
+ # Our newest Exclusive, Pepito, the Mascot, is intended to be distributed
+ #  in support of social causes and we've given Morse Meows one for auction!
+   'pepitothemascot': { name: 'Pepito The Mascot', date: '2020-11-07',
+                          exclusive: {
+                            limit: 20, ids: (231..250).to_a },
+                      },
+
+ ##  21.05.20  - New Exclusive - MegaFlowtron
+    'megaflowtron': { name: 'Mega Flowtron', date: '2020-05-21',
+                         exclusive: {
+                             limit: 1, ids: [303] },
+                    },
+
+ ##  15.05.20  - New Exclusive - Koshkat   - 222
+    'koshkat': { name: 'Koshkat', date: '2020-05-15',
+                      exclusive: {
+                         limit: 1, ids: [222] },
+               },
+
+ ##  01.02.20  - New Exclusive - Gale
+ ##    celebrating the way to 2 000 000 million
+ ##    check if limit goes up (on jan/31 it is 33)
+ ##
+ ## A total of 36 Exclusive Gale Kitties will be discovered
+ ##  through random breeding in the Race to the 2,000,000th Kitty.
+ ##
+ ##  Each of these 36 Exclusive Kitties will be born, at random,
+ ##  until we reach 2,000,000. And these super-rare Exclusives
+ ##  can be born from any parents, from any generation.
+ ##  But beware this is a ID-limited window.
+    'gale':   { name: 'Gale', date: '2020-02-01',
+                   exclusive: {
+                     limit: 33, ids: [
+                       1995387, 1995323, 1990934, 1987022,
+                       1986452, 1984873, 1984313, 1980813,
+                       1979910, 1976399, 1973254, 1971383,
+                       1970499, 1968361, 1961950, 1960448,
+                       1957257, 1956528, 1952165, 1946384,
+                       1932696, 1923247, 1909523, 1906470,
+                       1895691, 1895007, 1893341, 1887536,
+                       1861789, 1859088, 1836698, 1825688,
+                       1825574 ] },
+              },
+
+  #####
+  # 2019
+
+   'dapp-e': { name: 'DAPP-E', date: '2019-05-10',
+                exclusive: {
+                  limit: 50, ids: (1829..1878).to_a },
+                desc: 'Dapper (Crypto Contract) Wallet Promotion Cat'
+              },
+    papacatuanuku: { name: 'Papacatuanuku', date: '2019-03-31',
+                     exclusive: {
+                       limit: 1, ids: [1500000] },
+                     desc: 'Kitty #1500000'
+                   },
+    # 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 }
+                  },
+
+    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 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]}
+            },
+    hypurrion: { name: 'Hypurrion', date: '2019-01-10',
+                 exclusive: {
+                   limit: 1, ids: [269]},
+                 desc: 'Hyperion - Mythic Titan of Light - Gods Unchained Promotion'
+               },
+    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 etc) Kitty'
+                          },
+    lilbubthemagicalspacecat: { name: 'Lil Bub Ub Bub (BUB) The Magical Space Cat', date: '2018-11-13',
+                                exclusive: {
+                                  limit: 3, ids: [266,267,268]}
+                              },
+    vulcat:   { name: 'Vulcat', date: '2018-09-12',
+                exclusive: {
+                  limit: 1, ids: [1000000] },
+                desc: '1 000 000th Kitty'
+              },
+    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] }
+                    },
+    rabbidkitty:    { name: 'Rabbid Kitty', date: '2018-08-23',
+                      exclusive: {
+                         limit: 6, ids: (260..265).to_a },
+                      desc: 'Ubisoft Blockchain Heroes Hackathon'
+                    },
+   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'
+                   },
+    furlin:        { name: 'Furlin', date: '2018-06-26',
+                     exclusive: {
+                       limit: 52, ids: (115..126).to_a + (128..166).to_a }
+                   },
+    celestialcyberdimension: { name: 'Celestial Cyber Dimension', date: '2018-05-12',
+                               exclusive: {
+                                 limit: 1, ids: [127] }
+                             },
+
+=begin
+   ## May 7, 2018
+   ## old retired (failed) exclusive with Warriors' Steph Curry (NBA Superstar) Basketball Celebrity Promotion
+
+  '#30furry': { name: '#30 Furry', date: '2018-05-07',  ## todo/fix: url-escape name '#30furry' for picture
+                exclusive: {
+                  limit: 1, ids: [330] },
+                desc: 'Steph Curry (NBA Superstar) Basketball Celebrity Promotion Cat'
+              },
+   cheffurry: {  name: 'Chef Furry', date: '2018-05-07',
+                 exclusive: {
+                   limit: 1, ids: [130] },
+                 desc: 'Steph Curry (NBA Superstar) Basketball Celebrity Promotion Cat'
+               },
+    stephfurthree: { name: 'Steph Fur Three',  date: '2018-05-07',
+                     exclusive: {
+                       limit: 1, ids: [230] },
+                     desc: 'Steph Curry (NBA Superstar) Basketball Celebrity Promotion Cat'
+                   },
+=end
+
+
+    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!!!
+
+    knightkitty:  { name: 'Knight Kitty',  date: '2018-03-01',
+                    exclusive: {
+                      limit: 11, ids: (104..114).to_a }
+                  },
+    cathena:         { name: 'Cathena',  date: '2018-02-06',
+                      exclusive: {
+                        limit: 1, ids: [500000] },
+                      desc: '500 000th Kitty'
+                    },
+    genesis:      { name: 'Genesis', date: '2017-11-24',
+                    exclusive: {
+                      limit: 1, ids: [1] },
+                    desc: '1st Kitty'
+                  },
+    bugcat:       { name: 'Bug Cat', date: '2017-11-23',
+                    exclusive: {
+                      limit: 3, ids: [101,102,103] },
+                    desc: 'Bug Bounty Kitty' }
+  }
+

data/lib/kittyverse/config/fancies.rb

@@ -1,6 +1,9 @@
-# encoding: utf-8
-
 ###
+#   Fancy Cats
+#     see https://www.cryptokitties.co/catalogue/fancy-cats
+#    These limited-edition Kitties boast special art.
+#    They can only be bred through a unique genetic recipe until the cap is reached
+#
 #
 #  for latest updates on new fancies/exclusives see:
 #      https://updates.cryptokitties.co   (official latest updates/timeline)
@@ -14,8 +17,6 @@
 #      https://kittyhelper.co/price-floor/fancy/
 
 
-
-
 ##
 ## note:
 ##  for time limits for fancies use:
@@ -24,189 +25,320 @@
 ##  for overflows for limited edition use:
 ##     e.g. overflow: 1      #   888+1  (=889)
 
-SPECIAL_EDITIONS = {
-  'kitt-e': { name: 'KITT-E', date: '2019-05-10',
-              specialedition: {
-                limit: 500 },
-              desc: 'Dapper (Crypto Contract) Wallet Promotion Cat'
-            },
-  # 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'
+
+RECIPES = {
+
+######################
+# 2021
+
+#  16.01.21 - New fancy - Ellie
+#    An Elephantastic Fancy!
+#   The first of our next Fancy Family has been released into the wild...
+#     Shiny-enabled Fancy, Ellie!
+ellie: { name: 'Ellie', date: '2021-01-16',   ## 1st in Elephant series
+                recipe: {
+                  limit: 2500, count: 2,
+                  traits: [ 'shadowgrey', 'flamingo', 'littlefoot', 'walrus'] },
+       },
+
+#################
+# 2020
+#  19.12.20 - New fancy - Dave    -- Winter Series
+dave: { name: 'Dave',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-12-19', end: '?' }, count: 239,
+             traits: ['norwegianforest', 'icy', 'frozen'] },
+      },
+#  19.12.20 - New fancy - Holly   -- Winter Series
+holly: { name: 'Holly',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-12-19', end: '?' }, count: 261,
+             traits: ['chartreux', 'wingtips', 'icy'] },
+      },
+#  06.12.20 - New fancy - CatFrost    -- Winter Series
+#  The breeding window for the shiny-enabled Cat Frost ends at 9:50am PT on 12/19
+catfrost: { name: 'Cat Frost',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-12-06', end: '2020-12-19' }, count: 288,
+             traits: ['splat', 'wiley', 'icicle', 'icy'] },
+      },
+
+#  21.11.20 - New fancy - Abby
+abby: { name: 'Abby',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-11-21', end: '?' }, count: 299,
+             traits: ['ragamuffin', 'swarley', 'dune'] },
+      },
+#  08.11.20 - New fancy - Dart
+dart: { name: 'Dart',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-11-08', end: '?' }, count: 370,
+             traits: ['camo', 'oldlace', 'coffee', 'dune'] },
+      },
+
+#  30.09.20 - New fancy - Boris
+boris: { name: 'Boris',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-09-30', end: '?' }, count: 667,
+             traits: ['savannah', 'safetyvest', 'jacked'] },
+      },
+
+#  29.08.20 - New fancy - Mibbles
+mibbles: { name: 'Mibbles',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-08-29', end: '?' }, count: 1301,
+             traits: ['kurilian', 'impish'] },
+      },
+#  08.08.20 - New fancy - Reeves   - Wild West Series?
+reeves: { name: 'Reeves',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-08-08', end: '?' }, count: 198,
+             traits: ['rascal', 'swarley', 'daemonwings', 'dune'] },
+      },
+#  25.07.20 - New fancy - Pickett   - Wild West Series?
+pickett: { name: 'Pickett',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-07-25', end: '?' }, count: 224,
+             traits: ['swarley', 'lavender', 'dune'] },
+      },
+
+
+#  16.07.20 - New fancy - Joan
+joan: { name: 'Joan',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-07-16', end: '?' }, count: 338,
+             traits: ['lykoi', 'drama', 'glacier', 'springcrocus', 'prism'] },
+      },
+#  11.07.20 - New fancy - Starchild
+starchild: { name: 'Starchild',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-07-11', end: '?' }, count: 367,
+             traits: ['razzledazzle', 'drama', 'glacier', 'wolfgrey', 'prism'] },
+      },
+
+#  04.07.20 - New fancy - Travis
+travis: { name: 'Travis',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-07-04', end: '?' }, count: 300,
+             traits: ['firedup', 'wolfgrey', 'glacier', 'prism'] },
+      },
+#  04.07.20 - New fancy - Steel
+steel: { name: 'Steel',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-07-04', end: '?' }, count: 436,
+             traits: ['lykoi', 'hintomint', 'springcrocus', 'prism'] },
+      },
+
+#  20.06.20 - New fancy - Pawvril
+pawvril: { name: 'Pawvril',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-06-20', end: '?' }, count: 700,
+             traits: ['glacier', 'springcrocus', 'drama'] },
+      },
+#  20.06.20 - New fancy - Janis
+janis: { name: 'Janis',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-06-20', end: '?' }, count: 929,
+             traits: ['glacier', 'springcrocus', 'prism'] },
+      },
+
+#  06.06.20 - New fancy - Kunst
+kunst: { name: 'Kunst',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-06-06', end: '?' }, count: 1001,
+             traits: ['mainecoon', 'candyshoppe', 'royalblue'] },
+      },
+#  23.05.20 - New fancy - Kitiovanni
+kitiovanni: { name: 'Kitiovanni',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-05-23', end: '?' }, count: 735,
+             traits: ['manx', 'candyshoppe', 'firstblush', 'springcrocus', 'wyrm'] },
+      },
+
+#  09.05.20 - New fancy - Hunter
+hunter: { name: 'Hunter',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-05-09', end: '?' }, count: 1140,
+             traits: ['avatar', 'chameleon', 'tongue', 'dragontail'] },
+      },
+
+#  25.04.20 - New fancy - Vince
+vince: { name: 'Vince',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-04-25', end: '?' }, count: 1424,
+             traits: ['pixiebob', 'bananacream', 'daffodil', 'ooze'] },
+      },
+#  18.04.20 - New fancy - Zelig
+zelig: { name: 'Zelig',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-04-18', end: '?' }, count: 505,
+             traits: ['avatar', 'glacier', 'chameleon', 'happygokitty'] },
+      },
+#  11.04.20 - New fancy - Billie
+billie: { name: 'Billie',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-04-11', end: '?' }, count: 1261,
+             traits: ['pixiebob', 'cornflower', 'cerulian', 'mintmacaron'] },
+        },
+
+#  28.03.20 - New fancy - Bodhi
+bodhi: { name: 'Bodhi',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-03-28', end: '?' }, count: 616,
+             traits: ['avatar', 'chameleon', 'mertail', 'majestic'] },
+        },
+#  21.03.20 - New fancy - Cindi
+cindi: { name: 'Cindi',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-03-21', end: '?' }, count: 897,
+             traits: ['pixiebob', 'dragonfruit', 'prairierose', 'missmuffett'] },
+        },
+#  17.03.20 - New fancy - Potricia
+potricia: { name: 'Potricia',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-03-17', end: '?' }, count: 665,
+             traits: ['onyx', 'gold', 'mertail', 'roadtogold'] },
+        },
+#  07.03.20 - New fancy - Cai
+cai: { name: 'Cai',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2020-03-07', end: '?' }, count: 526,
+             traits: ['pixiebob', 'shamrock', 'mertail', 'hanauma'] },
+        },
+#  20.02.20 - New fancy - MissMatheson
+missmatheson: { name: 'Miss Matheson',   ## todo/check: was time-limited?
+               recipe: {
+             time: { start: '2020-02-20', end: '?' }, count: 375,
+             traits: ['liger','icicle','hacker','kittencream'] },
+        },
+
+#  15.02.20 - New fancy - Felis
+felis: { name: 'Felis',   ## todo/check: was time-limited?
+               recipe: {
+             time: { start: '2020-02-15', end: '?' }, count: 1264,
+             traits: ['mekong','moonrise','buzzed','finalfrontier'] },
+        },
+#  08.02.20 - New fancy - Meuwn
+meuwn: { name: 'Meuwn',   ## todo/check: was time-limited?
+               recipe: {
+             time: { start: '2020-02-08', end: '?' }, count: 509,
+             traits: ['razzledazzle', 'cloudwhite', 'springcrocus', 'finalfrontier'] },
+        },
+
+#  01.02.20 - New fancy - LilPurrfect
+lilpurrfect: { name: 'Lil Purrfect',   ## todo/check: was time-limited?
+               recipe: {
+             time: { start: '2020-02-01', end: '?' }, count: 662,
+             traits: ['allyouneed', 'garnet', 'flapflap'] },
+        },
+
+#  18.01.20 - New fancy - Mars
+mars: { name: 'Mars',   ## todo/check: was time-limited?
+               recipe: {
+             time: { start: '2020-01-18', end: '?' }, count: 987,
+             traits: ['hacker', 'prairierose', 'delite', 'finalfrontier'] },
+        },
+
+#  11.01.20 - New fancy - Cosmocat
+cosmocat: { name: 'Cosmocat',   ## todo/check: was time-limited?
+               recipe: {
+             time: { start: '2020-01-11', end: '?' }, count: 688,
+             traits: ['leopard', 'universe', 'topoftheworld', 'finalfrontier'] },
+        },
+
+
+pepito: { name: 'Pepito',
+          recipe: {
+             time: { start: '2020-01-01', end: '2020-01-07' }, count: 443,
+             traits: ['ragdoll', 'simple', 'meowgarine', 'junglebook'] },
+        },
+
+
+chitten: { name: 'Chitten',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2019-12-21', end: '?' }, count: 829,
+             traits: ['burmilla', 'calicool', 'hotcocoa', 'tongue'] },
+        },
+
+puuurrot: { name: 'Puuurrot',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2019-12-07', end: '?' }, count: 650,
+             traits: ['chantilly', 'firstblush', 'skyblue', 'tinybox'] },
+        },
+
+shoopadoop: { name: 'Shoopadoop',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2019-11-23', end: '?' }, count: 1269,
+             traits: ['martian', 'wyrm', 'SE03'] },
+        },
+
+bartholomeow: { name: 'Bartholomeow', date: '2019-11-12',  # Page's Warriors series
+                recipe: {
+                  limit: 10_000, count: 1269,
+                  traits: ['burmilla', 'thunderstruck', 'salmon', 'flamingo', 'rosequartz', 'wasntme'] },
+              },   ## add shiny-enabled?  see https://www.cryptokitties.co/blog/post/ooooooh-shiny
+
+gwendolion: { name: 'Gwendolion', date: '2019-11-10',   # Page's Warriors series - starter fancy
+                recipe: {
+                  limit: 50_000, count: 297,
+                  traits: ['burmilla', 'salmon', 'icy'] },
             },
-  ##
-  ## 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'
-           },
-  ## 2018
-  ## December
-  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'
+
+catseye: { name: 'Catseye', date: '2019-11-09',
+                recipe: {
+                  limit: 30_000, count: 196,
+                  traits: ['burmilla', 'rascal', 'salmon', 'flamingo'] },
          },
-  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'
-                  },
-  lilbub:      { name: 'Lil Bub Ub Bub (BUB)', date: '2018-11-13',
-                 specialedition: {
-                   limit: 468 }
-               },
-}
 
+# Oct 26, 2019 - Skeletonne Fancy Cat is discovered
+skeletonne: { name: 'Skeletonne',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2019-10-26', end: '?' }, count: 752,
+             traits: ['sphynx', 'scorpius', 'dreamboat', 'satiated'] },
+        },
 
-EXCLUSIVES = {
-  'dapp-e': { name: 'DAPP-E', date: '2019-05-10',
-              exclusive: {
-                limit: 50, ids: (1829..1878).to_a },
-              desc: 'Dapper (Crypto Contract) Wallet Promotion Cat'
-            },
-  papacatuanuku: { name: 'Papacatuanuku', date: '2019-03-31',
-                   exclusive: {
-                     limit: 1, ids: [1500000] },
-                   desc: 'Kitty #1500000'
-                 },
-  # 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 }
-                },
+# Oct 12, 2019 - Furmione Fancy Cat is discovered
+furmione: { name: 'Furmione',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2019-10-12', end: '?' }, count: 832,
+             traits: ['spangled', 'firstblush', ['poisonberry', 'mallowflower']] },
+        },
 
-  cyberberry: { name: 'Cyber Berry', date: '2019-03-02',
-                exclusive: {
-                  limit: 1, ids: [282] },
-                desc: "Winner of the NFTme Sweetstakes"
-              },
+# Sep 20, 2019 - Purrzival Fancy Cat is discovered
+purrzival: { name: 'Purrzival the Paladin',  date: '2019-09-20',  ## todo/check: was time-limited too?
+          recipe: {
+             limit: 30_000, count: 316,
+             traits: ['thunderstruck', 'rosequartz', 'peach', 'wasntme'] },
+        },
 
-  # 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]}
-              },
+# Sep 28, 2019 - Jack Fancy Cat is discovered
+jack: { name: 'Jack',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2019-09-28', end: '?' }, count: 721,
+             traits: ['savannah', 'shadowgrey', 'granitegrey', 'jacked'] },
+        },
 
-  # 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]}
-          },
-  hypurrion: { name: 'Hypurrion', date: '2019-01-10',
-               exclusive: {
-                 limit: 1, ids: [269]},
-               desc: 'Hyperion - Mythic Titan of Light - Gods Unchained Promotion'
-             },
-  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'
-                        },
-  lilbubthemagicalspacecat: { name: 'Lil Bub Ub Bub (BUB) The Magical Space Cat', date: '2018-11-13',
-                              exclusive: {
-                                limit: 3, ids: [266,267,268]}
-                            },
-  vulcat:   { name: 'Vulcat', date: '2018-09-12',
-              exclusive: {
-                limit: 1, ids: [1000000] },
-              desc: '1 000 000th Kitty'
-            },
-  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] }
-                  },
-  rabbidkitty:    { name: 'Rabbid Kitty', date: '2018-08-23',
-                    exclusive: {
-                       limit: 6, ids: (260..265).to_a },
-                    desc: 'Ubisoft Blockchain Heroes Hackathon'
-                  },
- 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'
-                 },
-  furlin:        { name: 'Furlin', date: '2018-06-26',
-                   exclusive: {
-                     limit: 52, ids: (115..126).to_a + (128..166).to_a }
-                 },
-  celestialcyberdimension: { name: 'Celestial Cyber Dimension', date: '2018-05-12',
-                             exclusive: {
-                               limit: 1, ids: [127] }
-                           },
-
-=begin
- ## May 7, 2018
- ## old retired (failed) exclusive with Warriors' Steph Curry (NBA Superstar) Basketball Celebrity Promotion
-
-'#30furry': { name: '#30 Furry', date: '2018-05-07',  ## todo/fix: url-escape name '#30furry' for picture
-              exclusive: {
-                limit: 1, ids: [330] },
-              desc: 'Steph Curry (NBA Superstar) Basketball Celebrity Promotion Cat'
-            },
- cheffurry: {  name: 'Chef Furry', date: '2018-05-07',
-               exclusive: {
-                 limit: 1, ids: [130] },
-               desc: 'Steph Curry (NBA Superstar) Basketball Celebrity Promotion Cat'
-             },
-  stephfurthree: { name: 'Steph Fur Three',  date: '2018-05-07',
-                   exclusive: {
-                     limit: 1, ids: [230] },
-                   desc: 'Steph Curry (NBA Superstar) Basketball Celebrity Promotion Cat'
-                 },
-=end
-
-
-  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!!!
-
-  knightkitty:  { name: 'Knight Kitty',  date: '2018-03-01',
-                  exclusive: {
-                    limit: 11, ids: (104..114).to_a }
-                },
-  cathena:         { name: 'Cathena',  date: '2018-02-06',
-                    exclusive: {
-                      limit: 1, ids: [500000] },
-                    desc: '500 000th Kitty'
-                  },
-  genesis:      { name: 'Genesis', date: '2017-11-24',
-                  exclusive: {
-                    limit: 1, ids: [1] },
-                  desc: '1st Kitty'
-                },
-  bugcat:       { name: 'Bug Cat', date: '2017-11-23',
-                  exclusive: {
-                    limit: 3, ids: [101,102,103] },
-                  desc: 'Bug Bounty Kitty' }
-}
+# Sep 14, 2019 - Pawderick the Lancer Fancy Cat is discovered
+pawderick: { name: 'Pawderick the Lancer',  date: '2019-09-14',  ## todo/check: was time-limited too?
+          recipe: {
+             limit: 50_000, count: 665,
+             traits: ['ganado', 'rosequartz', 'wasntme'] },
+        },
 
+# Aug 31, 2019 - Robin Fancy Cat is discovered
+robin: { name: 'Robin',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2019-08-31', end: '?' }, count: 1837,
+             traits: ['stunned', 'meowgarine', 'kittencream', 'featherbrain'] },
+        },
+
+# Aug 17, 2019 - Kitty Formerly Known as Prince Fancy Cat is discovered
+kittyformerlyknownasprince: { name: 'Kitty Formerly Known As Prince',   ## todo/check: was time-limited?
+          recipe: {
+             time: { start: '2019-08-17', end: '?' }, count: 503,
+             traits: ['leopard', 'tendertears', 'royalblue', 'pouty'] },
+        },
 
-RECIPES = {
   # Aug 3, 2019 - DJ Meowlody Fancy Cat is discovered
   djmeowlody: { name: 'DJ Meowlody',
                 recipe: {