Skip to content

Navigation Menu

Sign in
Sign up

Repository files navigation

NeftyBlocks CLI

The NeftyBlocks CLI is a tool that will help you manage your collections by creating templates and minting assests.

oclif GitHub license

Nefty Cli

Requirements

The CLI asks for the following minimum requirements installed:

Installation

To install the CLI you can run the following command:

npm install -g @nefty/cli

This will download and install the CLI, after its installed you can quickly start by configuring your CLI settings

$ npm install -g @nefty/cli
$ nefty COMMAND
running command...
$ nefty (--version)
@nefty/cli/0.3.3 darwin-arm64 node-v18.20.4
$ nefty --help [COMMAND]
USAGE
 $ nefty COMMAND
...

Configuration

Neftyblocks-CLI works based on a configuration file that you will need to generate first. This file contains the urls and defined values to be able to communicate with the Chain. In order to generate this configuration you will need to run the following command:

nefty config init

Then you will be prompt/asked to enter the required information.

Configuration file

The neftyblocks-cli requires a configuration that will include all the properties with the information to connect to the proper endpoints.
You can locate the configuration directory in

Unix: ~/.config/nefty/config.json Windows: %LOCALAPPDATA%\nefty\config.json

The required properties are as follows:

Property Description Example value
rpcUrl Url that points to your preferred eos node api https://wax-testnet.neftyblocks.com
aaUrl Url that points to your preferred atomic assets api https://aa-testnet.neftyblocks.com
explorerUrl Url that points to your preferred blocks explorer https://wax-test.bloks.io
chainId The chain id of the blockchain to interact with 1064487b3cd1a897ce03ae5b6a865651747e2e152090f99c1d19d44e01aea5a4
sessionDir Directory where the session information is stored /User/user/.config/nefty/sessions

Quick Start

The CLI is able to create templates and mint assets based on xls templates that contains the required informations. The required parameters are the collection name and the path where the file will be downloaded. If no schema is passed to the command it will retrieve all available schemas for the collection and place them one per sheet inside the xls file You can also filter by schema in case you just want to work based on 1 schema You can generate and download these templates by running the following commands:

Create Templates

You can create your templates by running the following command:

nefty templates create ~/path/to/xls/file -c collectionName

Mint Assets

You can mint NFTs by running the following command:

nefty assets mint ~/path/to/xls/file -c collectionName

Generate PFPs

You can generate PFPs by running the following command:

nefty pfps generate ~/path/to/xls/file ~/path/to/output/dir -r ~/path/to/source/layers

Transfer tokens

You can transfer tokens by running the following command:

nefty tokens transfer ~/path/to/xls/file

Generate XLS File for Template Creation

nefty generate template-file ~/Downloads/template-file-path -c yourCollectionName -s yourSchemaName

Generate XLS File for Minting Assets

nefty generate mint-file ~/Downloads/mint-file-path -c yourCollectionName -s yourSchemaName

Generate XLS File for PFP Generation

nefty generate pfp-file ~/Downloads/pfp-file-path -l Body -l Head -l Hair

Generate XLS File to transfer tokens

nefty generate transfer-tokens-file ~/Downloads/transfer-file-path

XLS files

The CLI reads data from an XLS template, which provides the schema(s) for the desired template(s).

Template creation file

Each sheet within this file should represent a distinct schema name. The mandatory headers detailing the template information are as follows:

Header Description
template_max_supply Total assets available for minting under this template. (0 denotes unlimited supply)
template_is_burnable Specifies whether assets can be burned.
template_is_transferable Indicates if assets are transferable to other accounts.

Following these headers, custom attributes for the templates can be added:

template_max_supply template_is_burnable template_is_transferable name image custom attr1 custom attr2 ...
2000 TRUE/FALSE TRUE/FALSE nefty ipfs_hash custom value1 custom value2 ...
4000 TRUE/FALSE TRUE/FALSE nefty ipfs_hash custom value1 custom value2 ...

Mint File

Similarly, each sheet in this file should represent a unique schema name. The required headers detailing the asset information are:

Header Description
template ID of the template to which the asset belongs. Use -1 if no specific template is to be associated.
amount Quantity of NFTs set to be minted.
owner Account that will own the minted NFT.

After specifying these headers, you can include custom attributes for the assets:

template amount owner name image custom attr1 custom attr2 ...
-1 10 superaccount nefty ipfs_hash custom value1 custom value2 ...
631839 20 superaccount nefty ipfs_hash custom value1 custom value2 ...

PFP Layers File

The PFP layers file is used to define how layers are organized and interact in the given project. This file specifies the names of the layers in each sheet, wherein the order of the sheets determines the sequence in which the layers are placed on top of each other.

Mandatory Headers

Each sheet must contain these required headers:

Header Description
id A unique identifier for each option.
value Specifies the attribute's value for the given option.
odds Indicates the likelihood of the option being selected. All odds within the options sum up to determine the overall probability.

Optional Headers

In addition to the mandatory headers, the following headers can be included:

Header Description
path Path of the image (relative to the rootDir) associated with the option.
skip Skips certain options within a layer or an entire layer. Specify a layer name to skip. For specific options, mention the layer name followed by ":" and the option ids, separated by commas. List one layer per line if skipping multiple layers.
dependencies Sets dependencies based on a previous layer's value. Specify the layer name followed by ":" and the option ids that it depends on. For multiple layers, list one layer per line.
insertFromLayers Includes options from previous layers in the image when the current option is chosen. Define the layer name, followed by ":" and the option ids as dependencies. For multiple layers, list one layer per line.
sameIdRestrictions Puts a constraint on an option if another option has the same id. Define the layer name, followed by ":" and the option ids that it relies on.
removeLayers Specifies which preceding layers should be removed if the current option is chosen. Only the layer name is required. For multiple layers, list one layer per line.

Token transfer File

The token transfer file is used to define the tokens to be transferred, the recipient, amount and memo. The mandatory headers detailing the transfer information are as follows:

Header Description
contract The account name of the token (i.e. eosio.token).
symbol The symbol of the token (i.e. WAX).
amount The amount to transfer of the token (i.e. 10).
recipient The account to transfer the tokens to.
memo A memo that will be included in the transfer.

Commands

nefty assets

Manages a collection's assets.

USAGE
 $ nefty assets
DESCRIPTION
 Manages a collection's assets.

See code: src/commands/assets/index.ts

nefty assets mint INPUT

Mints assets in batches using a spreadsheet.

USAGE
 $ nefty assets mint INPUT -c <value> [-b <value>] [-i] [--confirm] [--skip <value>]
ARGUMENTS
 INPUT Excel file with the templates and amounts
FLAGS
 -b, --batchSize=<value> [default: 100] Transactions batch size
 -c, --collectionName=<value> (required) Collection name
 -i, --ignoreSupply Ignore supply errors
 --confirm Confirm transactions
 --skip=<value> Number of mints to skip
DESCRIPTION
 Mints assets in batches using a spreadsheet.
EXAMPLES
 $ nefty assets mint test.xls -c alpacaworlds

See code: src/commands/assets/mint.ts

nefty config

Manages the configuration.

USAGE
 $ nefty config
DESCRIPTION
 Manages the configuration.

See code: src/commands/config/index.ts

nefty config auth

Authenticates the CLI with a different account

USAGE
 $ nefty config auth
DESCRIPTION
 Authenticates the CLI with a different account
EXAMPLES
 Logs in to the CLI with a different account
 $ nefty config auth auth

See code: src/commands/config/auth.ts

nefty config get

Display all the configuration parameters.

USAGE
 $ nefty config get
DESCRIPTION
 Display all the configuration parameters.
EXAMPLES
 $ nefty config get

See code: src/commands/config/get.ts

nefty config init

Configure the parameters to interact with the blockchain.

USAGE
 $ nefty config init [-d]
FLAGS
 -d, --deleteConfig Deletes configuration file
DESCRIPTION
 Configure the parameters to interact with the blockchain.
EXAMPLES
 $ nefty config init

See code: src/commands/config/init.ts

nefty config set [PROPERTY] [VALUE]

Sets a configuration property

USAGE
 $ nefty config set [PROPERTY] [VALUE]
ARGUMENTS
 PROPERTY (explorerUrl|rpcUrl|aaUrl) Configuration property.
 VALUE Configuration value.
DESCRIPTION
 Sets a configuration property
EXAMPLES
 Sets the explorer url property
 $ nefty config set explorerUrl https://waxblock.io

See code: src/commands/config/set.ts

nefty generate

Generates excel files to use in other batch commands.

USAGE
 $ nefty generate
DESCRIPTION
 Generates excel files to use in other batch commands.

See code: src/commands/generate/index.ts

nefty generate create-liquidity-file OUTPUT

Generates the file to create liquidity pools.

USAGE
 $ nefty generate create-liquidity-file OUTPUT
ARGUMENTS
 OUTPUT Location where the file will be generated.
DESCRIPTION
 Generates the file to create liquidity pools.
EXAMPLES
 Generates the file to create liquidity pools into a file called pools.xlsx.
 $ nefty generate create-liquidity-file pools.xlsx

See code: src/commands/generate/create-liquidity-file.ts

nefty generate mint-file OUTPUT

Generates the file to batch mint assets in a collection. Each schema will be a different sheet.

USAGE
 $ nefty generate mint-file OUTPUT -c <value> [-s <value>]
ARGUMENTS
 OUTPUT Location where the file will be generated.
FLAGS
 -c, --collection=<value> (required) Collection name to generate the file.
 -s, --schema=<value> Schema to use to generate the file. If not provided, all schemas will be used.
DESCRIPTION
 Generates the file to batch mint assets in a collection. Each schema will be a different sheet.
EXAMPLES
 Generates the file for the collection alpacaworlds, schema thejourney and saves it in the current directory in a
 file called mints.xlsx.
 $ nefty generate mint-file mints.xlsx -c alpacaworlds -s thejourney
 Generates the file for the collection alpacaworlds, all schemas and saves it in the current directory in a file
 called mints.xlsx.
 $ nefty generate mint-file mints.xlsx -c alpacaworlds

See code: src/commands/generate/mint-file.ts

nefty generate pfp-file OUTPUT

Generates the file to generate a pfp collection with the specified layers.

USAGE
 $ nefty generate pfp-file OUTPUT [-l <value>] [-a]
ARGUMENTS
 OUTPUT Location where the file will be generated.
FLAGS
 -a, --advanced Include advanced headers.
 -l, --layers=<value>... The names of the layers to include in the file.
DESCRIPTION
 Generates the file to generate a pfp collection with the specified layers.
EXAMPLES
 Generates the file to create pfps with the layers Body, Face and Hair and saves it in the current directory in a
 file called pfp-layers.xlsx.
 $ nefty generate pfp-file pfp-layers.xlsx -l Body -l Face -l Hair
 Generates the file to create pfps with the layers Body, Face and Hair with advanced headers and saves it in the
 current directory in a file called pfp-layers.xlsx.
 $ nefty generate pfp-file pfp-layers.xlsx -l Body -l Face -l Hair -a

See code: src/commands/generate/pfp-file.ts

nefty generate template-file OUTPUT

Generates the file to batch create templates in a collection. Each schema will be a different sheet.

USAGE
 $ nefty generate template-file OUTPUT -c <value> [-s <value>]
ARGUMENTS
 OUTPUT Location where the file will be generated.
FLAGS
 -c, --collection=<value> (required) Collection name to generate the file.
 -s, --schema=<value> Schema to use to generate the file. If not provided, all schemas will be used.
DESCRIPTION
 Generates the file to batch create templates in a collection. Each schema will be a different sheet.
EXAMPLES
 Generates the file for the collection alpacaworlds, schema thejourney and saves it in the current directory in a
 file called templates.xlsx.
 $ nefty generate template-file templates.xlsx -c alpacaworlds -s thejourney
 Generates the file for the collection alpacaworlds, all schemas and saves it in the current directory in a file
 called templates.xlsx.
 $ nefty generate template-file templates.xlsx -c alpacaworlds

See code: src/commands/generate/template-file.ts

nefty generate token-transfer-file OUTPUT

Generates the file to transfer tokens.

USAGE
 $ nefty generate token-transfer-file OUTPUT
ARGUMENTS
 OUTPUT Location where the file will be generated.
DESCRIPTION
 Generates the file to transfer tokens.
EXAMPLES
 Generates the file to transfer tokens into a file called transfers.xlsx.
 $ nefty generate token-transfer-file transfers.xlsx

See code: src/commands/generate/token-transfer-file.ts

nefty generate upgrade-file OUTPUT

Generates the file to generate a upgrade collection with the specified layers.

USAGE
 $ nefty generate upgrade-file OUTPUT
ARGUMENTS
 OUTPUT Location where the file will be generated.
DESCRIPTION
 Generates the file to generate a upgrade collection with the specified layers.
EXAMPLES
 Generates the file to manage upgrades and saves it in the current directory in a file called upgrades.xlsx.
 $ nefty generate upgrade-file upgrade-layers.xlsx

See code: src/commands/generate/upgrade-file.ts

nefty help [COMMAND]

Display help for nefty.

USAGE
 $ nefty help [COMMAND...] [-n]
ARGUMENTS
 COMMAND... Command to show help for.
FLAGS
 -n, --nested-commands Include all nested commands in the output.
DESCRIPTION
 Display help for nefty.

See code: @oclif/plugin-help

nefty pfps

Commands to manage a PFP collection.

USAGE
 $ nefty pfps
DESCRIPTION
 Commands to manage a PFP collection.

See code: src/commands/pfps/index.ts

nefty pfps build INPUT

Uploads all the pfps generated by the generate command to ipfs and creates the mint file.

USAGE
 $ nefty pfps build INPUT -t <value> -c <value> -n <value> [-r] [-a <value>] [--nameDigits <value>]
ARGUMENTS
 INPUT Directory where the pfps are saved.
FLAGS
 -a, --account=<value> The account who will receive the pfps.
 -c, --collection=<value> (required) The collection to use for the mint file.
 -n, --name=<value> (required) The name to prepend in the NFT name.
 -r, --randomize Randomizes the pfps before creting the mint file.
 -t, --template=<value> (required) The template where the NFTs will be minted.
 --nameDigits=<value> [default: 4] The number of digits in the number in the NFT name.
DESCRIPTION
 Uploads all the pfps generated by the generate command to ipfs and creates the mint file.
EXAMPLES
 Uploads all the pfps in the ./pfpfs folder to ipfs, creates the mint file using template 11324 and collection
 alpacaworls.
 $ nefty pfps build ./pfps-folder -c alpacaworls -t 11324 -a alpacaworlds -n "My NFT" -r

See code: src/commands/pfps/build.ts

nefty pfps cover INPUT

Generates a cover image based on the generated pfps.

USAGE
 $ nefty pfps cover INPUT -q <value> [-i <value>] [--delay <value>]
ARGUMENTS
 INPUT Directory where the pfps are saved.
FLAGS
 -i, --include=<value>... Include specific dnas in the cover.
 -q, --quantity=<value> (required) [default: 20] Number of images to use in the cover.
 --delay=<value> [default: 200] Delay in ms between each image in the cover.
DESCRIPTION
 Generates a cover image based on the generated pfps.
EXAMPLES
 Generates the cover image with 50 pfps.
 $ nefty pfps cover pfps -q 50
 Generates the cover image with 50 pfps, forcing the use of dnas 0b1b...b5b and ff28...0c6b
 $ nefty pfps cover pfps -q 50 -i 0b1b2e8ad9672bed621e8259894ea8152857d3dfcc15d6dcccebc98b618d8b5b \
 ff28ca1c5749e6a6369dae7fe7d334b5b5ca40e43f1c345e7f0b4b22b36c0c6b

See code: src/commands/pfps/cover.ts

nefty pfps generate INPUT OUTPUT

Generates the images and attributes for a pfp collection.

USAGE
 $ nefty pfps generate INPUT OUTPUT -q <value> [-r <value>] [-w <value>] [--debug] [--predefined <value>]
ARGUMENTS
 INPUT Location or google sheets id of the excel file with the pfps definitions.
 OUTPUT Directory where the images will be saved.
FLAGS
 -q, --quantity=<value> (required) Number of pfps to generate.
 -r, --rootDir=<value> Directory where the assets are stored.
 -w, --resizeWidth=<value> Width to resize the images to.
 --debug Include more information in the pfs excel.
 --predefined=<value> Location or google sheets id of the excel file with the predefined pfps definitions.
DESCRIPTION
 Generates the images and attributes for a pfp collection.
EXAMPLES
 Generates all the pfps defined in the pfps-specs.xlsx file and saves them in the pfps directory.
 $ nefty pfps generate pfps-specs.xlsx pfps

See code: src/commands/pfps/generate.ts

nefty pfps mint INPUT

Mints the NFTS in the mint-pfps.xlsx file.

USAGE
 $ nefty pfps mint INPUT [--skip <value>] [--batchSize <value>]
ARGUMENTS
 INPUT Directory where the pfps are saved.
FLAGS
 --batchSize=<value> [default: 50] Batch size for minting
 --skip=<value> Number of mints to skip
DESCRIPTION
 Mints the NFTS in the mint-pfps.xlsx file.
EXAMPLES
 Mints the NFTS in the mint-pfps.xlsx file.
 $ nefty pfps mint ./pfps-folder

See code: src/commands/pfps/mint.ts

nefty pfps mosaic INPUT

Generates a mosaic based on the generated pfps.

USAGE
 $ nefty pfps mosaic INPUT -q <value> [-i <value>] [--delay <value>] [-w <value>]
ARGUMENTS
 INPUT Directory where the pfps are saved.
FLAGS
 -i, --include=<value>... Include specific dnas in the cover.
 -q, --quantity=<value> (required) [default: 25] Number of images to use in the cover.
 -w, --width=<value> [default: 1600] Expected final width of the mosaic.
 --delay=<value> [default: 200] Delay in ms between each image in the cover.
DESCRIPTION
 Generates a mosaic based on the generated pfps.
EXAMPLES
 Generates a mosaic with 25 pfps.
 $ nefty pfps mosaic pfps -q 25
 Generates a mosaic 25 pfps, forcing the use of dnas 0b1b...b5b and ff28...0c6b
 $ nefty pfps mosaic pfps -q 25 -i 0b1b2e8ad9672bed621e8259894ea8152857d3dfcc15d6dcccebc98b618d8b5b \
 ff28ca1c5749e6a6369dae7fe7d334b5b5ca40e43f1c345e7f0b4b22b36c0c6b

See code: src/commands/pfps/mosaic.ts

nefty swap

Manages liquidity pools.

USAGE
 $ nefty swap
DESCRIPTION
 Manages liquidity pools.

See code: src/commands/swap/index.ts

nefty swap create-pools INPUT

Create new liquidity pools in taco swap.

USAGE
 $ nefty swap create-pools INPUT [-b <value>]
ARGUMENTS
 INPUT Excel file with the liquidity pools to open.
FLAGS
 -b, --batchSize=<value> [default: 100] Transactions batch size
DESCRIPTION
 Create new liquidity pools in taco swap.
EXAMPLES
 $ nefty swap create-pools test.xls

See code: src/commands/swap/create-pools.ts

nefty templates

Manages a collection's templates.

USAGE
 $ nefty templates
DESCRIPTION
 Manages a collection's templates.

See code: src/commands/templates/index.ts

nefty templates create INPUT

Create templates in a collection by batches using a spreadsheet.

USAGE
 $ nefty templates create INPUT -c <value> [-b <value>]
ARGUMENTS
 INPUT Excel file with the assets to mint
FLAGS
 -b, --batchSize=<value> [default: 100] Transactions batch size
 -c, --collection=<value> (required) Collection name
DESCRIPTION
 Create templates in a collection by batches using a spreadsheet.
EXAMPLES
 $ nefty templates create template.xls -c alpacaworlds

See code: src/commands/templates/create.ts

nefty templates export OUTPUT

Exports the templates in a collection. Each schema will be a different sheet.

USAGE
 $ nefty templates export OUTPUT -c <value> [-s <value>]
ARGUMENTS
 OUTPUT Location where the file will be generated.
FLAGS
 -c, --collection=<value> (required) Collection name to generate the file.
 -s, --schema=<value> Schema to use to generate the file. If not provided, all schemas will be used.
DESCRIPTION
 Exports the templates in a collection. Each schema will be a different sheet.
EXAMPLES
 Exports the templates for the collection alpacaworlds, schema thejourney and saves it in the current directory in a
 file called templates.xlsx.
 $ nefty templates export templates.xlsx -c alpacaworlds -s thejourney
 Exports the templates for the collection alpacaworlds, all schemas and saves it in the current directory in a file
 called templates.xlsx.
 $ nefty templates export templates.xlsx -c alpacaworlds

See code: src/commands/templates/export.ts

nefty tokens

Manages an account's tokens

USAGE
 $ nefty tokens
DESCRIPTION
 Manages an account's tokens

See code: src/commands/tokens/index.ts

nefty tokens transfer INPUT

Transfers tokens in batches using a spreadsheet.

USAGE
 $ nefty tokens transfer INPUT [-b <value>]
ARGUMENTS
 INPUT Excel file with the transfers to make.
FLAGS
 -b, --batchSize=<value> [default: 100] Transactions batch size
DESCRIPTION
 Transfers tokens in batches using a spreadsheet.
EXAMPLES
 $ nefty tokens transfer test.xls

See code: src/commands/tokens/transfer.ts

nefty upgrade

Command to creates upgrades

USAGE
 $ nefty upgrade
DESCRIPTION
 Command to creates upgrades

See code: src/commands/upgrade/index.ts

nefty upgrade create INPUT

Creates defined upgrades.

USAGE
 $ nefty upgrade create INPUT
ARGUMENTS
 INPUT Location or google sheets id of the excel file with the upgrades definitions.
DESCRIPTION
 Creates defined upgrades.
EXAMPLES
 Creates all the upgrades defined in the upgrade-specs.xlsx file.
 $ nefty upgrade create upgrade-specs.xlsx upgrades

See code: src/commands/upgrade/create.ts

About

The NeftyBlocks CLI is a tool that will help you manage your collections.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Used by

Contributors

Languages

AltStyle によって変換されたページ (->オリジナル) /