0.0.11 • Published 2 years ago

@permaweb/machine v0.0.11

Weekly downloads
-
License
MIT
Repository
-
Last release
2 years ago

The Machine

The Machine is an atomic asset creator tool for deploying collections to the permaweb. To deploy a collection, you need a directory containing the following files:

  • collection.json
  • 1..X.png or 1..X.mp3 etc.
  • banner.png
  • thumbnail.png

Usage

npm i @permaweb/machine
npx @permaweb/machine <collection> -w <arWalletFile>

Example

create folder with assets 'mutants' add a collection.json in folder along with the assets drop you wallet.json file in the project folder

npm i @permaweb/machine
npx @permaweb/machine mutants -w ./wallet.json

Docs

  • Your asset files
  • A collection.json file that describes your project
  • (OPTIONAL) A banner.png file to provide a banner for your collection

Here is an example directory structure:

- assets
  - 0.png
  - 1.png
  - 2.png
  - collection.json
  - banner.png

The banner.png file should have dimensions of 1600x900 pixels.

NOTE: If you want to add a description for each file, just include a .txt for each asset, so if you have asset-01.png, you would include asset-01.txt, etc.

Collection JSON Schema

The collection.json file follows a specific schema to describe your collection. Here are the available properties:

PropertyDescription
nameThe name of your collection.
titleThe title prefix, which will be appended to the filename. Usually, it is a number. If you want to use the filename as the title, then enter "FILENAME" as the value
descriptionThe description that you want to appear on the collection and every asset.
topicsDiscoverable topics for your collection.
licenseTagsTags to define your license.
ownersA set of wallet addresses with the numeric amount of units for each wallet.
typeThe type of asset.
codeAn identifier for your collection. If left blank, a GUID will be created. This enables linking between the collection and manifest file.
creatorwallet address of the creator

Example collection.json

{
  "name": "Cyber Raccoon collection",
  "title": "Cyber Raccoon #", 
  "description": "Cyber Raccoon collection",
  "topics": ["cyber", "animals", "permaweb"],
  "licenseTags": {
    "License": "yRj4a5KMctX_uOmKWCFJIjmY8DeJcusVk6-HzLiM_t8",
    "Access": "public",
    "Derivation": "allowed-with-license-fee",
    "Derivation-Fee": "One-Time-0.1",
    "Commercial": "allowed",
    "Commercial-Fee": "One-Time-0.5",
    "Payment-Mode": "Global-Distribution"
  },
  "owners": {
    "vh-NTHVvlKZqRxc8LyyTNok65yQ55a_PJ1zWLb9G2JI": 100
  },
  "type": "image",
  "code": "raccoon-collection",
  "creator": "vh-NTHVvlKZqRxc8LyyTNok65yQ55a_PJ1zWLb9G2JI"
}

Please make sure to provide the necessary information in the collection.json file to accurately represent your collection.

Enjoy using The Machine to deploy your collections to the permaweb!

0.0.11

2 years ago

0.0.10

2 years ago

0.0.9

2 years ago

0.0.8

2 years ago

0.0.7

2 years ago

0.0.6

2 years ago

0.0.5

2 years ago

0.0.3

2 years ago

0.0.2

2 years ago