cryptopunks 1.2.1 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 90c086c27ab6e20974bcb2c1777873eb0e6d61006ddcd72724f96e18687c9a13
-  data.tar.gz: f91b82d1ae82abf305d3e95ef1e86f33fb2da3dab9b41ef6e18551b30202b845
+  metadata.gz: dceba5897b87bade5e787074da796bc116dea1e3acd8341d40d6cfa5337b3fdc
+  data.tar.gz: 725cbf4474d25b2c032396dfef71a4cad605d2b4f5af0361145693aada489101
 SHA512:
-  metadata.gz: 5e4066e8746b234fa3ac7d25aad89f2bcd2ec15bce6f05c4c9b55d2cbcc56258778c412924c57024e24375ed326a784eba84fc1154676e8559a6d345b8990418
-  data.tar.gz: 1262074a74f23d241e7ee5430a5a8b29911490183b98d2f27b3c2c76c04ee4e9f5b7492aeec75a4aaff15f3f809fab6501142f7814f58ac1cca7671d6853cc24
+  metadata.gz: '09a830c716f4305c2ae82f9ddfe9298eecfa891d9754e5014734db290ae3541fd9ef427d1eedd5b88ebc1e0d9743932254e631a90b394a2032995dc2e6570278'
+  data.tar.gz: b9cde99de27ccba6b572d0416fbb01512da27cf9e8bfeda96093944b2a9a4f5e3f08ef8f694dd68edbe78bf6290b3d37f108c56db6338af64055db7339a75b89

data/Manifest.txt

@@ -4,31 +4,18 @@ README.md
 Rakefile
 bin/cryptopunk
 bin/punk
-config/more/alien-female.txt
-config/more/ape-female.txt
-config/more/demon-female.txt
-config/more/demon-male.txt
-config/more/mummy-female.txt
-config/more/mummy-male.txt
-config/more/orc-female.txt
-config/more/orc-male.txt
-config/more/robot-female.txt
-config/more/robot-male.txt
-config/more/skeleton-female.txt
-config/more/skeleton-male.txt
-config/more/vampire-female.txt
-config/more/vampire-male.txt
-config/more/zombie-female.txt
-config/original/alien-male.txt
-config/original/ape-male.txt
-config/original/human-female.txt
-config/original/human-male.txt
-config/original/zombie-male.txt
+config/spritesheet.csv
+config/spritesheet.png
 lib/cryptopunks.rb
 lib/cryptopunks/attributes.rb
 lib/cryptopunks/colors.rb
 lib/cryptopunks/composite.rb
+lib/cryptopunks/contract/punksdata-assets.rb
+lib/cryptopunks/contract/punksdata-contract.rb
+lib/cryptopunks/contract/punksdata-meta.rb
 lib/cryptopunks/dataset.rb
+lib/cryptopunks/generator.rb
 lib/cryptopunks/image.rb
 lib/cryptopunks/structs.rb
+lib/cryptopunks/tool.rb
 lib/cryptopunks/version.rb

data/README.md

@@ -12,6 +12,7 @@ New to Crypto Punks?
 See the [**Awesome CryptoPunks Bubble (Anno 2021) - Modern 24×24 Pixel Crypto Art on the Blockchain** »](https://github.com/cryptopunksnotdead/awesome-cryptopunks-bubble)
 
 
+
 ## Command Line
 
 Use the `punk` (or `cryptopunk`) command line tool. Try:
@@ -23,17 +24,289 @@ $ punk -h
 resulting in:
 
 ```
-Usage: cryptopunk [options] IDs
-  Mint punk characters from composite (./punks.png) - for IDs use 0 to 9999
+NAME
+    punk - punk (or cryptopunk) command line tool
+
+SYNOPSIS
+    punk [global options] command [command options] [arguments...]
+
+VERSION
+    2.0.0
+
+GLOBAL OPTIONS
+    -d, --dir,
+    -o, --out, --outdir=DIR - Output directory (default: .)
+    -f, --file=FILE         - True Official Genuine CryptoPunks™ all-in-one
+                              composite image (default: ./punks.png)
+    --offset=NUM            - Start counting at offset (default: 0)
+    -z, --zoom=ZOOM         - Zoom factor x2, x4, x8, etc. (default: 1)
+
+    --help                  - Show this message
+    --version               - Display the program version
+    --verbose               - (Debug) Show debug messages
+
+
+COMMANDS
+    g, gen, generate - Generate punk characters from text attributes (from
+                       scratch / zero) via builtin punk spritesheet
+    l, ls, list      - List all punk archetype and attribute names from builtin
+                       punk spritesheet
+    q, query         - Query (builtin off-chain) punk contract for punk text
+                       attributes by IDs - use 0 to 9999
+    t, tile          - Get punk characters via image tiles from all-in-one punk
+                       series composite (./punks.png) - for IDs use 0 to 9999
+
+    help             - Shows a list of commands or help for one command
+```
+
+### Generate Command
+
+_Generate punk characters from text attributes (from scratch / zero) via builtin punk spritesheet_
+
+
+Let's try punk #0:
+
+```
+$ punk generate female_2 earring blonde_bob green_eye_shadow
+```
+
+resulting in:
+
+![](i/punk-0000.png)
+
+Let's try  the `-z/--zoom` factor 2x, 4x, 8x, etc.:
+
+```
+$ punk --zoom 4 generate female_2 earring blonde_bob green_eye_shadow
+# -or-
+$ punk -z2 g female_2 earring blonde_bob green_eye_shadow
+```
+
+resulting in:
+
+2x ![](i/punk-0000x2.png)
+4x ![](i/punk-0000x4.png)
+8x ![](i/punk-0000x8.png)
+
+
+Let's try never-before-seen super-rare punks:
+
+```
+$ punk generate demon heart_shades
+$ punk generate vampire_female wild_hair
+```
+
+resulting in:
+
+![](i/demon.png)
+![](i/vampire-female.png)
+
+
+
+Q: What punk archetypes and attributes can I use?
+
+A:  See the list command.
+
+
+### List Command
+
+_List all punk archetype and attribute names from builtin punk spritesheet_
+
+
+Let's try:
 
-  Options:
-    -z, --zoom=ZOOM   Zoom factor x2, x4, x8, etc. (default: 1)
-    -d, --dir=DIR     Output directory (default: .)
-    -f, --file=FILE   True Official Genuine CryptoPunks™ composite image (default: ./punks.png)
-        --offset=NUM  Start counting at offset (default: 0)
-    -h, --help        Prints this help
+```
+$ punk list
+# -or-
+$ punk ls
 ```
 
+resulting in:
+
+```
+==> Archetypes
+  Male 1 / (m)                   - Archetype - Human
+  Male 2 / (m)                   - Archetype - Human
+  Male 3 / (m)                   - Archetype - Human
+  Male 4 / (m)                   - Archetype - Human
+  Female 1 / (f)                 - Archetype - Human
+  Female 2 / (f)                 - Archetype - Human
+  Female 3 / (f)                 - Archetype - Human
+  Female 4 / (f)                 - Archetype - Human
+  Zombie / (m)                   - Archetype - Zombie
+  Zombie Female / (f)            - Archetype - Zombie
+  Ape / (m)                      - Archetype - Ape
+  Ape Female / (f)               - Archetype - Ape
+  Alien / (m)                    - Archetype - Alien
+  Alien Female / (f)             - Archetype - Alien
+  Demon / (m)                    - Archetype - Demon
+  Demon Female / (f)             - Archetype - Demon
+  Mummy / (m)                    - Archetype - Mummy
+  Mummy Female / (f)             - Archetype - Mummy
+  Orc / (m)                      - Archetype - Orc
+  Orc Female / (f)               - Archetype - Orc
+  Robot / (m)                    - Archetype - Robot
+  Robot Female / (f)             - Archetype - Robot
+  Skeleton / (m)                 - Archetype - Skeleton
+  Skeleton Female / (f)          - Archetype - Skeleton
+  Vampire / (m)                  - Archetype - Vampire
+  Vampire Female / (f)           - Archetype - Vampire
+  Zombie (Ape) / (m)             - Archetype - Zombie
+  Alien (Ape) / (m)              - Archetype - Alien
+  Alien 0° / (m)                 - Archetype - Alien
+  Alien 30° / (m)                - Archetype - Alien
+  Alien 60° / (m)                - Archetype - Alien
+  Alien 90° / (m)                - Archetype - Alien
+  Alien 120° / (m)               - Archetype - Alien
+  Alien 150° / (m)               - Archetype - Alien
+  Alien 180° / (m)               - Archetype - Alien
+  Alien 210° / (m)               - Archetype - Alien
+  Alien 240° / (m)               - Archetype - Alien
+  Alien 270° / (m)               - Archetype - Alien
+  Alien 300° / (m)               - Archetype - Alien
+  Alien 330° / (m)               - Archetype - Alien
+  Alien (Ape) 0° / (m)           - Archetype - Alien
+  Alien (Ape) 30° / (m)          - Archetype - Alien
+  Alien (Ape) 60° / (m)          - Archetype - Alien
+  Alien (Ape) 90° / (m)          - Archetype - Alien
+  Alien (Ape) 120° / (m)         - Archetype - Alien
+  Alien (Ape) 150° / (m)         - Archetype - Alien
+  Alien (Ape) 180° / (m)         - Archetype - Alien
+  Alien (Ape) 210° / (m)         - Archetype - Alien
+  Alien (Ape) 240° / (m)         - Archetype - Alien
+  Alien (Ape) 270° / (m)         - Archetype - Alien
+  Alien (Ape) 300° / (m)         - Archetype - Alien
+  Alien (Ape) 330° / (m)         - Archetype - Alien
+  Alien Female 0° / (f)          - Archetype - Alien
+  Alien Female 30° / (f)         - Archetype - Alien
+  Alien Female 60° / (f)         - Archetype - Alien
+  Alien Female 90° / (f)         - Archetype - Alien
+  Alien Female 120° / (f)        - Archetype - Alien
+  Alien Female 150° / (f)        - Archetype - Alien
+  Alien Female 180° / (f)        - Archetype - Alien
+  Alien Female 210° / (f)        - Archetype - Alien
+  Alien Female 240° / (f)        - Archetype - Alien
+  Alien Female 270° / (f)        - Archetype - Alien
+  Alien Female 300° / (f)        - Archetype - Alien
+  Alien Female 330° / (f)        - Archetype - Alien
+
+==> Attributes
+  3D Glasses / (m)               - Attribute
+  3D Glasses / (f)               - Attribute
+  Bandana / (m)                  - Attribute
+  Bandana / (f)                  - Attribute
+  Beanie / (m)                   - Attribute
+  Beanie / (f)                   - Attribute
+  Big Beard / (m)                - Attribute
+  Big Shades / (m)               - Attribute
+  Big Shades / (f)               - Attribute
+  Black Lipstick / (f)           - Attribute
+  Blonde Bob / (f)               - Attribute
+  Blonde Short / (f)             - Attribute
+  Blue Eye Shadow / (f)          - Attribute
+  Buck Teeth / (m)               - Attribute
+  Cap / (m)                      - Attribute
+  Cap / (f)                      - Attribute
+  Cap Forward / (m)              - Attribute
+  Cap Forward / (f)              - Attribute
+  Chinstrap / (m)                - Attribute
+  Choker / (f)                   - Attribute
+  Cigarette / (m)                - Attribute
+  Cigarette / (f)                - Attribute
+  Classic Shades / (m)           - Attribute
+  Classic Shades / (f)           - Attribute
+  Clown Eyes Blue / (m)          - Attribute
+  Clown Eyes Blue / (f)          - Attribute
+  Clown Eyes Green / (m)         - Attribute
+  Clown Eyes Green / (f)         - Attribute
+  Clown Hair Green / (m)         - Attribute
+  Clown Hair Green / (f)         - Attribute
+  Clown Nose / (m)               - Attribute
+  Clown Nose / (f)               - Attribute
+  Cowboy Hat / (m)               - Attribute
+  Cowboy Hat / (f)               - Attribute
+  Crazy Hair / (m)               - Attribute
+  Crazy Hair / (f)               - Attribute
+  Dark Hair / (f)                - Attribute
+  Do-rag / (m)                   - Attribute
+  Do-rag / (f)                   - Attribute
+  Earring / (m)                  - Attribute
+  Earring / (f)                  - Attribute
+  Eye Mask / (m)                 - Attribute
+  Eye Mask / (f)                 - Attribute
+  Eye Patch / (m)                - Attribute
+  Eye Patch / (f)                - Attribute
+  Fedora / (m)                   - Attribute
+  Fedora / (f)                   - Attribute
+  Front Beard / (m)              - Attribute
+  Front Beard Dark / (m)         - Attribute
+  Frown / (m)                    - Attribute
+  Frumpy Hair / (m)              - Attribute
+  Frumpy Hair / (f)              - Attribute
+  Green Eye Shadow / (f)         - Attribute
+  Goat / (m)                     - Attribute
+  Gold Chain / (m)               - Attribute
+  Gold Chain / (f)               - Attribute
+  ...
+```
+
+See the [**punks.spritesheet**](https://github.com/cryptopunksnotdead/punks.spritesheet) for more.
+
+
+
+
+### Query Command
+
+_Query (builtin off-chain) punk contract for punk text attributes by IDs - use 0 to 9999_
+
+
+Let's try punk #0:
+
+```
+$ punk query 0
+# -or-
+$ punk q 0
+```
+
+resulting in:
+
+```
+==> (1/1) punk #0...
+  female_2  earring  blonde_bob  green_eye_shadow
+```
+
+Let's try some top sellers:
+
+```
+$ punk query 7804 3100 5217 8857
+# -or-
+$ punk q 7804 3100 5217 8857
+```
+
+resulting in:
+
+```
+==> (1/4) punk #7804...
+  alien  cap_forward  pipe  small_shades
+==> (2/4) punk #3100...
+  alien  headband
+==> (3/4) punk #5217...
+  ape  gold_chain  knitted_cap
+==> (4/4) punk #8857...
+  zombie  wild_hair  3d_glasses
+```
+
+Note: Yes, you can pass the text attributes to the generate command
+to get a free "cleanroom" copy built from scratch / zero
+that you own 100% forever.
+
+
+
+### Tile Command
+
+_Get punk characters via image tiles from all-in-one punk series composite (`./punks.png`) - for IDs use 0 to 9999_
+
+
 
 Step 0 -  Download the True Official Genuine CryptoPunks™ composite image
 
@@ -48,10 +321,10 @@ See [`punks.png` »](https://github.com/larvalabs/cryptopunks/blob/master/punks.
 
 
 
-Now let's give it a try.  Let's mint punk #0, #2890, and #8219:
+Now let's give it a try.  Let's save punk #0, #2890, and #8219:
 
 ```
-$ punk 0 2890 8219
+$ punk tile 0 2890 8219
 ```
 
 printing:
@@ -60,9 +333,9 @@ printing:
 ==> reading >./punks.png<...
      >ac39af4793119ee46bbff351d8cb6b5f23da60222126add4268e261199a2921b< SHA256 hash matching
          ✓ True Official Genuine CryptoPunks™ verified
-==> (1/3) minting punk #0; writing to >./punk-0000.png<...
-==> (2/3) minting punk #2890; writing to >./punk-2890.png<...
-==> (3/3) minting punk #8219; writing to >./punk-8219.png<...
+==> (1/3) saving punk #0 to >./punk-0000.png<...
+==> (2/3) saving punk #2890 to >./punk-2890.png<...
+==> (3/3) saving punk #8219 to >./punk-8219.png<...
 ```
 
 And voila!
@@ -73,14 +346,14 @@ And voila!
 
 
 
-**Bonus:  Try the `-z/--zoom` factor x2, x4, x8, etc.**
+**Bonus:  Try the `-z/--zoom` factor 2x, 4x, 8x, etc.**
 
-Let's give it a try.  Let's mint punk #0, #2890, and #8219 in 2x format:
+Let's give it a try.  Let's save punk #0, #2890, and #8219 in 2x format:
 
 ```
-$ punk --zoom 2 0 2890 8219
+$ punk --zoom 2 tile 0 2890 8219
 # -or-
-$ punk -z2 0 2890 8219
+$ punk -z2 t 0 2890 8219
 ```
 
 printing:
@@ -90,9 +363,9 @@ printing:
      >ac39af4793119ee46bbff351d8cb6b5f23da60222126add4268e261199a2921b< SHA256 hash matching
          ✓ True Official Genuine CryptoPunks™ verified
     setting zoom to 2x
-==> (1/3) minting punk #0; writing to >punk-0000x2.png<...
-==> (2/3) minting punk #2890; writing to >punk-2890x2.png<...
-==> (3/3) minting punk #8219; writing to >punk-8219x2.png<...
+==> (1/3) saving punk #0 to >punk-0000@2x.png<...
+==> (2/3) saving punk #2890 to >punk-2890@2x.png<...
+==> (3/3) saving punk #8219 to >punk-8219@2x.png<...
 ```
 
 And voila!
@@ -120,7 +393,7 @@ And so on.
 
 
 
-## 10 000 More Punks  - Unauthorized? No Way?!- Fuck the Establishment - Yes, You Can - Do-It-Yourself - Use Your Own Collections
+**10 000 More Punks  - Unauthorized? No Way?!- Fuck the Establishment - Yes, You Can - Do-It-Yourself - Use Your Own Collections**
 
 
 Use the `-f, --file=FILE` option
@@ -138,12 +411,12 @@ in the series.
 
 
 
-Let's mint punk #0, #19, #50, and #89
+Let's save punk #0, #19, #50, and #89
 and let's add an offset of 10000
 (to start counting at 10000 instead of 0):
 
 ```
-$ punk 0 18 40 88 --file ./more-punks-1.png --offset 10000
+$ punk --file ./more-punks-1.png --offset 10000 tile 0 18 40 88
 ```
 
 printing:
@@ -151,10 +424,10 @@ printing:
 ```
 ==> reading >./more-punks-1.png<...
      240x240 (height x width)
-==> (1/4) minting punk #10000; writing to >./punk-10000.png<...
-==> (2/4) minting punk #10018; writing to >./punk-10018.png<...
-==> (3/4) minting punk #10040; writing to >./punk-10040.png<...
-==> (4/4) minting punk #10040; writing to >./punk-10088.png<...
+==> (1/4) saving punk #10000 to >./punk-10000.png<...
+==> (2/4) saving punk #10018 to >./punk-10018.png<...
+==> (3/4) saving punk #10040 to >./punk-10040.png<...
+==> (4/4) saving punk #10040 to >./punk-10088.png<...
 ```
 
 And voila!
@@ -182,12 +455,12 @@ Let's try the second pack - that is, punks 100 to 199 in the series.
 
 
 
-Let's mint punk #0, #79, #80, and #90
+Let's save punk #0, #79, #80, and #90
 and let's add an offset of 10100
 (to start counting at 10000 plus 100 instead of 0):
 
 ```
-$ punk 0 79 80 90 --file ./more-punks-2.png --offset 10100
+$ punk --file ./more-punks-2.png --offset 10100 tile 0 79 80 90
 ```
 
 printing:
@@ -195,10 +468,10 @@ printing:
 ```
 ==> reading >./more-punks-2.png<...
      240x240 (height x width)
-==> (1/4) minting punk #10100; writing to >./punk-10100.png<...
-==> (2/4) minting punk #10179; writing to >./punk-10179.png<...
-==> (3/4) minting punk #10180; writing to >./punk-10180.png<...
-==> (4/4) minting punk #10190; writing to >./punk-10190.png<...
+==> (1/4) saving punk #10100 to >./punk-10100.png<...
+==> (2/4) saving punk #10179 to >./punk-10179.png<...
+==> (3/4) saving punk #10180 to >./punk-10180.png<...
+==> (4/4) saving punk #10190 to >./punk-10190.png<...
 ```
 
 And voila! Super rare - world's first female alien and much more.
@@ -223,10 +496,12 @@ And so on.
 
 
 
+
+
 ## Usage in Your Scripts
 
 
-Yes, you can mint punks in your own scripts
+Yes, you can generate punks in your own scripts
 and much more.
 See the
 [**Programming CryptoPunks & Copypastas Step-by-Step Booklet / Guide »**](https://github.com/cryptopunksnotdead/programming-cryptopunks)

data/Rakefile

@@ -20,6 +20,7 @@ Hoe.spec 'cryptopunks' do
   self.extra_deps = [
     ['pixelart'],
     ['csvreader'],
+    ['gli'],
   ]
 
   self.licenses = ['Public Domain']