Step 3 - Prepare collection artifacts

7 min

Once you have edited the 00000.nfts.csv file, it is time to generate all the necessary artifacts on your machine. The generated artifacts are optimized versions of your artworks (beside the original), a meta data and a "record" file per NFT.

To run the commit command you need to be inside your collection folder.

All files are prefixed with a 5-digit incremental number. Files starting with 00000 are auxiliary files, like collection information, progress and log files. By using this pattern, the files can be sorted correctly in File Explorers.

Requires no PIN

Costs: Nothing

Allows Trial Run

Alias: prepare

$> signumart-massup collection commit -h

Usage: signumart-massup collection commit|prepare [options]

Prepares the collection for upload

Options:
  -t, --try   Validates the CSV file without generating artifacts
  -h, --help  display help for command

This command reads the data from the previously edited 00000.nfts.csv file and creates a lot of files per NFTs, if not running in Trial Mode.

It is higly recommended to run the commit command in Trial Mode before running without, as this allows you to entirely validate the provided information in the CSV file. When running without Trial Mode, the process bails out on the first error.

Generated Artifacts

Filename	Description
00000.commit.log	The log file of the commit phase (Appends multiple runs)
00000.commit-progress.json	The progress information used to continue on last successful operation
nnnnn.m.png	The original image. The file respects the original image format, i.e. can be jpg, svg, gif etc. nnnnn ranges from 00001 to 99999 m ranges from 1 to 3
nnnnn.m-social.webp	The optimized image for social media (SEO Cards)
nnnnn.m-thumb.webp	The thumbanil version of the image
nnnnn-metadata.json	The NFTs meta data information
nnnnn-record.json	The related line of the CSV file in JSON format

Examples

This is a Trial Mode run to validate the 00000.nfts.csv

$> signumart-massup collection commit --try

=================== TRIAL RUN ====================
Nothing will be generated
================================================

Found Collection
┌────────────────────┬─────────────────────────────────────────────────────────────┐
│      (index)       │                           Values                            │
├────────────────────┼─────────────────────────────────────────────────────────────┤
│         Id         │                    '3267705388183728528'                    │
│        Name        │                     'massup_logo_test'                      │
│    Description     │                'A lot of cool,Signum Logos'                 │
│      Socials       │                             ''                              │
│     Home Page      │                             ''                              │
│     Background     │ 'QmRC1ihQaDTnKALzhkMhWE1hL8SNNS9a5oT36iQjspFwdH:image/webp' │
│ Social Media Image │ 'QmVs4dCX5WBNYFuRuVhUfB3ZAcH6vsiZcFVe9VYVCabeEV:image/webp' │
└────────────────────┴─────────────────────────────────────────────────────────────┘
? Do you want to continue preparing the NFTs data for upload? Yes
✔ Congratulations. All data is valid
┌─────────────────────────────┬──────────────┐
│           (index)           │    Values    │
├─────────────────────────────┼──────────────┤
│            Count            │      10      │
│        Auction Count        │      1       │
│       For Sale Count        │      8       │
│     Not For Sale Count      │      1       │
│    Minimum Total Amount     │ '9500 SIGNA' │
│    Attribute Keys Count     │      3       │
│  Distinct Attributes Count  │      3       │
│ Items With Attributes Count │      3       │
│      Validation Errors      │      0       │
└─────────────────────────────┴──────────────┘

*** TRIAL run finished. No artifacts were created.

This is a real run that generates the artifacts

$> signumart-massup collection commit

Found Collection
┌────────────────────┬─────────────────────────────────────────────────────────────┐
│      (index)       │                           Values                            │
├────────────────────┼─────────────────────────────────────────────────────────────┤
│         Id         │                    '3267705388183728528'                    │
│        Name        │                     'massup_logo_test'                      │
│    Description     │                'A lot of cool,Signum Logos'                 │
│      Socials       │                             ''                              │
│     Home Page      │                             ''                              │
│     Background     │ 'QmRC1ihQaDTnKALzhkMhWE1hL8SNNS9a5oT36iQjspFwdH:image/webp' │
│ Social Media Image │ 'QmVs4dCX5WBNYFuRuVhUfB3ZAcH6vsiZcFVe9VYVCabeEV:image/webp' │
└────────────────────┴─────────────────────────────────────────────────────────────┘
? Do you want to continue preparing the NFTs data for upload? Yes
✔ Congratulations. All data is valid
┌─────────────────────────────┬──────────────┐
│           (index)           │    Values    │
├─────────────────────────────┼──────────────┤
│            Count            │      10      │
│        Auction Count        │      1       │
│       For Sale Count        │      8       │
│     Not For Sale Count      │      1       │
│    Minimum Total Amount     │ '9500 SIGNA' │
│    Attribute Keys Count     │      3       │
│  Distinct Attributes Count  │      3       │
│ Items With Attributes Count │      3       │
│      Validation Errors      │      0       │
└─────────────────────────────┴──────────────┘
? Do you want to continue preparing the NFTs data for upload? Yes
 ████████████████████████████████████████ 100% | ETA: 0s | 10/10
┌───────────────────┬─────────────┐
│      (index)      │   Values    │
├───────────────────┼─────────────┤
│     Nft Count     │     10      │
│ Image File Count  │     30      │
│ Total Upload Size │ '10.66 MiB' │
│   Minting Costs   │  '4 SIGNA'  │
│     Duration      │ '2 seconds' │
└───────────────────┴─────────────┘
Successfully created all necessary artifacts. Now, you can run [collection push]

As a result you get something like this

✔ ~/code/signum/signum-art-massup/massup_logo_test
total 11216
-rw-rw-r-- 1 ohager ohager     388 mai 24 07:52 00000.collection.json
-rw-rw-r-- 1 ohager ohager   48028 jun  1 09:20 00000.commit.log
-rw-rw-r-- 1 ohager ohager     650 mai 24 13:09 00000.commit-progress.json
-rw-rw-r-- 1 ohager ohager    1765 mai 24 13:04 00000.nfts.csv
-rw-rw-r-- 1 ohager ohager  683883 mai 24 13:09 00001.1.png
-rw-r--r-- 1 ohager ohager   12138 mai 24 13:09 00001.1-social.webp
-rw-r--r-- 1 ohager ohager   12138 mai 24 13:09 00001.1-thumb.webp
-rw-rw-r-- 1 ohager ohager     621 mai 24 17:36 00001-metadata.json
-rw-rw-r-- 1 ohager ohager     509 mai 24 13:09 00001-record.json
-rw-rw-r-- 1 ohager ohager  922866 mai 24 13:09 00002.1.png
-rw-r--r-- 1 ohager ohager   18814 mai 24 13:09 00002.1-social.webp
-rw-r--r-- 1 ohager ohager   18814 mai 24 13:09 00002.1-thumb.webp
-rw-rw-r-- 1 ohager ohager     621 mai 24 17:36 00002-metadata.json
-rw-rw-r-- 1 ohager ohager     509 mai 24 13:09 00002-record.json
-rw-rw-r-- 1 ohager ohager 1161422 mai 24 13:09 00003.1.png
-rw-r--r-- 1 ohager ohager   15974 mai 24 13:09 00003.1-social.webp
-rw-r--r-- 1 ohager ohager   15974 mai 24 13:09 00003.1-thumb.webp
-rw-rw-r-- 1 ohager ohager     621 mai 24 17:36 00003-metadata.json
-rw-rw-r-- 1 ohager ohager     509 mai 24 13:09 00003-record.json
...