Skip to content

Latest commit

 

History

History
86 lines (52 loc) · 3.19 KB

README.md

File metadata and controls

86 lines (52 loc) · 3.19 KB

NFT Collection Manager

An NFT Collection Manager for the EOS/AtomicAssets ecosystem built by FACINGS as per our ENF Grant Proposal.

This project is meant to both work as a stand-alone NFT publishing platform, as well as a launchpad for NFT developers on EOS.

The core feature set is very simple:

  1. Login and view resource usage
  2. View/explore collections (schemas, templates, and NFTs)
  3. Create and edit collections
  4. Mint and transfer NFTs

Important principles:

  1. Keep the core simple and secure with minimal dependencies
  2. Allow publishers, developers, and businesses to build faster
  3. Grow open-source community around core EOS/AtomicAssets needs

Documentation

  1. Getting Started (this README document) - Project overview and "Getting Started" guide for devs.
  2. User Guide - For users. Basic tutorial explaining how to create a collection and mint NFTs.
  3. Plugin System - For devs, describing how the plugin system works.
  4. Contributing - For devs, describing how to contribute to this project.
  5. Testing Guide - For reviewers/testers, full run-through of functionality.
  6. Data Import Plugin - For users, guide to using the CSV import plugin.
  7. Data Types - An overview of AtomicAssets data types.

Dependencies

  1. Public AtomicAsset API (AGPLv3; use any public endpoint)
  2. Public Node API endpoint (MIT; use any public EOS or WAX endpoint)
  3. Public IPFS endpoint (MIT; e.g. https://ipfs.ledgerwise.io/ipfs)

Getting Started - Development

Ensure all project dependencies are installed:

yarn

The following command will prep the environment, and, using the API endpoints specified in .env, start the application server in development mode with features like hot-code reloading and dev-friendly error reporting.

yarn dev

Now you may open http://localhost:3000 to access the app.

Running the application with docker

Install Docker and execute:

docker-compose up --build --force-recreate

After build, open http://localhost:3000 to access the app.

Environment Variables

Next.js allows you to set defaults in .env (all environments), .env.development (development environment), and .env.production (production environment).

Variables set in .env.local always override any defaults set.

Testnet

If you do not wish to publish on EOS mainnet, you may select the "Jungle4 (EOS Testnet)" chain in the upper left-hand corner.

Currently this app supports both EOS Jungle4 Testnet and WAX Testnet. (Click either link to create a free testnet account.)

License

GPLv3