Apillon CLI

Apillon CLI is a command-line interface for using Apillon Web3 services.

Requirements

To be able to use Apillon CLI, you must register an account at Apillon.io, create a project and generate an API key with appropriate permissions. Also Node.js (version 16 or later) is required.

Installation

To install Apillon CLI run

npm install -g @apillon/cli

Afterwards you can use CLI with command

apillon <command> [options]

Alternately you don't need to install the Apillon CLI to use it. In that case run the desired command using npx:

npx @apillon/cli <command> [options]

Note that when running without installation, you have to use @apillon/cli instead of apillon execution command.

Global Options

--key <api key>: Apillon API key (can be set via the APILLON_API_KEY environment variable).
--secret <api secret>: Apillon API secret (can be set via the APILLON_API_SECRET environment variable).
--debug: Output execution logs when running commands.
-V, --version: Output the version number.

Environment Variables

You can use environment variables to set an API key, and an API secret:

APILLON_API_KEY: Apillon API key.
APILLON_API_SECRET: Apillon API secret.

If you have these variables set, you do not need to use the global options each time.

Help

To display the help information for the CLI or a specific command, use the -h or --help option:

apillon -h
apillon hosting -h
npx @apillon/cli hosting deploy-website --help

List pagination options

For commands that return a list of results, for example apillon storage list-files, or apillon hosting list-websites, there are global list pagination options that are available to use:

--limit <integer>: Page limit
--order-by <string> : Page order by (can be any property from the response data)
--page <integer>: Page number
--search <string> : Search by name or other object identifier

For example responses and for an overview of all properties, refer to the Apillon API wiki. Note: CLI responses may be dfferent from API responses.

Commands

The Apillon CLI currently supports the following commands:

Hosting Commands

`hosting list-websites`

Lists all websites associated with your project.

Example

apillon hosting list-websites --search "My-Website" --limit 1

Example response

{
  "items": [
    {
      "createTime": "2023-10-25T10:41:06.000Z",
      "updateTime": "2023-10-26T12:41:41.000Z",
      "uuid": "5b908779-3687-4592-a073-9bebbf86afe2",
      "name": "My Website",
      "description": "My own website",
      "domain": "https://my-website.com",
      "bucketUuid": "47251013-37c6-4b30-be2b-8583dea25c4c",
      "ipnsStaging": "k2k4r8ob2rf35wbmhhtzbq6nd4lhwv...",
      "ipnsProduction": "k2k4r8pple7phwm9azqgxshxdzy..."
    },
    ...
  ],
  "total": 3
}

`hosting get-website`

Retrieves information about a specific website.

Options

--uuid <string>: UUID of the website to get details for.

Example

apillon hosting get-website --uuid "123e4567-e89b-12d3-a456-426655440000"

`hosting deploy-website`

Deploys a website from a local folder directly to Apillon hosting production environment.

Options

<file-path>: Path to the folder containing your website files.
--uuid <string>: UUID of the website to upload files to.
-p, --preview: Deploy to staging environment instead.

Example

apillon hosting deploy-website ./public_html --uuid "123e4567-e89b-12d3-a456-426655440000" -p

`hosting upload`

Uploads a local folder's contents to a website deployment bucket.

Options

<path>: Path to the folder containing your website files.
--uuid <string>: UUID of the website to upload files to.

Example

apillon hosting upload ./public_html --uuid "123e4567-e89b-12d3-a456-426655440000"

`hosting start-deployment`

Deploys a website to the specified environment, from files already uploaded to the hosting bucket.

Options

--uuid <string>: UUID of the website to deploy.
--env <integer>: The environment to deploy to.

Available choices:

TO_STAGING = 1
STAGING_TO_PRODUCTION = 2
DIRECTLY_TO_PRODUCTION = 3

Example

apillon hosting start-deployment --uuid "123e4567-e89b-12d3-a456-426655440000" --env 1

`hosting list-deployments`

Lists all deployments for a specific website.

Options

--uuid <string>: UUID of the website to list deployments for.
--status <integer>: The status of the deployments (DeploymentStatus enum, optional).

Available choices:

INITIATED = 0
IN_PROCESS = 1
SUCCESSFUL = 10
FAILED = 100

--env <integer>: The environment of the deployments (DeploymentStatus enum, optional).

Available choices:

STAGING = 2
PRODUCTION = 3

Example

apillon hosting list-deployments --uuid "58a16026-1356-405b-97f9-efcc9dfac1dd" --order-by createTime --desc true

Example response

{
  "items": [
    {
      "createTime": "2023-11-14T12:09:20.000Z",
      "updateTime": "2023-11-14T12:09:42.000Z",
      "uuid": "9b677fe2-1bb1-44d9-8956-e7749452f02d",
      "websiteUuid": "58a16026-1356-405b-97f9-efcc9dfac1dd",
      "cid": "QmPPBMsFccJVaLwvdhSh3zMbfEvonxoNSBLVd1kWK34Nps",
      "cidv1": "bafybeizpqaa5xb5r46d2voj35qtokhb3c3bekof...",
      "environment": "DIRECTLY_TO_PRODUCTION",
      "deploymentStatus": "SUCCESSFUL",
      "size": 7162,
      "number": 1
    },
    ...
  ],
  "total": 7
}

`hosting get-deployment`

Retrieves information about a specific deployment.

Options

-w, --website-uuid <string>: UUID of the website.
-d, --deployment-uuid <string>: UUID of the deployment

Example

apillon hosting get-deployment --website-uuid "123e4567-e89b-12d3-a456-426655440000" --deployment-uuid "987e6543-e21c-32f1-b123-426655441111"

Storage Commands

`storage list-buckets`

Lists all storage buckets associated with your project.

Example

apillon storage list-buckets

Example response

{
  "items": [
    {
      "createTime": "2023-11-15T09:56:53.000Z",
      "updateTime": "2023-11-23T08:55:46.000Z",
      "uuid": "91c57d55-e8e4-40b7-ad6a-81a82831bfb3",
      "name": "My Storage Bucket",
      "description": "For storing my images and videos",
      "size": 23576
    },
    ...
  ],
  "total": 2
}

`storage list-objects`

Retrieves objects (files and folders) from a specific bucket or bucket directory.

Options

-b, --bucket-uuid <string>: UUID of the bucket to retrieve objects from.
-d, --directory-uuid <string>: UUID of the directory to retrieve objects from (optional, default root folder).
--deleted: Include objects deleted from the bucket.

Example

apillon storage list-objects --bucket-uuid "123e4567-e89b-12d3-a456-426655440000" --directory-uuid "987e6543-e21c-32f1-b123-426655441111"

Example response

{
  "items": [
    {
      "createTime": "2023-11-23T08:55:45.000Z",
      "updateTime": "2023-11-23T08:55:46.000Z",
      "uuid": "14a7a891-877c-41ac-900c-7382347e1e77",
      "name": "index.html",
      "CID": "bafybeidzrd7p5ddj67j2mud32cbnze2c7b2pvbhn...",
      "status": "AVAILABLE_ON_IPFS_AND_REPLICATED",
      "directoryUuid": null,
      "type": "FILE",
      "link": "https://ipfs.apillon.io/ipfs/bafybeidzrd7p5ddj67j...",
      "path": null,
      "bucketUuid": "91c57d55-e8e4-40b7-ad6a-81a82831bfb3"
    },
    ...
  ],
  "total": 16
}

`storage list-files`

Retrieves files from a specific bucket.

Options

-b, --bucket-uuid <string>: UUID of the bucket to retrieve files from.
-s, --file-status <integer>: Filter by file status (FileStatus enum, optional).

Available choices:

UPLOAD_REQUEST_GENERATED = 1
UPLOADED = 2
AVAILABLE_ON_IPFS = 3
AVAILABLE_ON_IPFS_AND_REPLICATED = 4

Example

apillon storage list-files --bucket-uuid "123e4567-e89b-12d3-a456-426655440000" -s 2

Example response

{
  "items": [
    {
      "createTime": "2023-11-15T09:58:04.000Z",
      "updateTime": "2023-11-15T09:58:10.000Z",
      "name": "style.css",
      "CID": "bafybeidzrd7p5ddj67j2mud32cbnze2c7b2pvbag...",
      "status": "AVAILABLE_ON_IPFS_AND_REPLICATED",
      "directoryUuid": null,
      "type": "FILE",
      "link": "https://ipfs.apillon.io/ipfs/bafybeidzrd7p...",
      "path": null,
      "bucketUuid": "91c57d55-e8e4-40b7-ad6a-81a82831bfb3"
    },
    ...
  ],
  "total": 10
}

`storage upload`

Upload contents of a local folder to specified bucket.

Options

<folder-path>: Path to the folder containing your files.
-b, --bucket-uuid <string>: UUID of the bucket to upload files to.
-w, --wrap: Wrap uploaded files to an IPFS directory
-p, --path <string>: Path to upload files to (e.g. main/subdir). Required when --wrap is supplied.
--await: await file CIDs to be resolved

Example

apillon storage upload ./my_folder --bucket-uuid "123e4567-e89b-12d3-a456-426655440000" --wrap --path "main/subdir"

`storage get-file`

Retrieves information about a specific file in a bucket.

Options

-b, --bucket-uuid <string>: UUID of the bucket.
-f, --file-uuid <string>: UUID or CID of the file to retrieve.

Example

apillon storage get-file --bucket-uuid "123e4567-e89b-12d3-a456-426655440000" --file-uuid "file_uuid_or_cid"

`storage delete-file`

Deletes a specific file from a bucket.

Options

-b, --bucket-uuid <string>: UUID of the bucket.
-f, --file-uuid <string>: UUID or CID of the file to delete.

Example

apillon storage delete-file --bucket-uuid "123e4567-e89b-12d3-a456-426655440000" --file-uuid "file_uuid_or_cid"

`storage delete-directory`

Delete a directory from a storage bucket.

Options

-b, --bucket-uuid <string>: UUID of the bucket.
-d, --directory-uuid <string>: UUID of the directoru to delete.

Example

apillon storage delete-directory --bucket-uuid "123e4567-e89b-12d3-a456-426655440000" --directory-uuid "2c84048c-49a1-4ed2-9e1e-8920806ae968"

IPNS Commands

`storage ipns list`

Lists all IPNS records for a specific bucket.

Options

-b, --bucket-uuid <uuid>: UUID of the bucket.

Example

apillon storage ipns list --bucket-uuid "123e4567-e89b-12d3-a456-426655440000"

Example response

{
  "items": [
    {
      "createTime": "2023-12-06T12:29:09.000Z",
      "updateTime": "2023-12-06T12:29:21.000Z",
      "uuid": "80383a54-1d86-4761-a5e4-26a2fab474c9",
      "name": "Images IPNS",
      "description": "IPNS for images folder",
      "ipnsName": "k2k4r8jp1jnlbe3qv...",
      "ipnsValue": "/ipfs/QmUz4...",
      "link": "https://ipfs.apillon.io/ipns/k2k4r8jp1jnlbe3qv...",
      "bucketUuid": "a26184d7-acf5-4d6c-9195-465e3a7a5240"
    },
    {
      "createTime": "2023-12-06T12:29:37.000Z",
      "updateTime": "2023-12-06T12:29:52.000Z",
      "uuid": "2045db5b-b347-4ea6-a4c0-4445e071180d",
      "name": "JSON IPNS",
      "description": "IPNS for metadata folder",
      "ipnsName": "k2k4r8opkl3i2zq7bin8lis4...",
      "ipnsValue": "/ipfs/QmUz5Z6RcMynfZWoC...",
      "link": "https://ipfs.apillon.io/ipns/k2k4r8opkl3i2z...",
      "bucketUuid": "a26184d7-acf5-4d6c-9195-465e3a7a5240"
    }
  ],
  "total": 2
}

`storage ipns create`

Creates a new IPNS record for a specific bucket.

Options

-b, --bucket-uuid <uuid>: UUID of the bucket.
-n, --name <name>: Name of the IPNS record.
-d, --description <description>: Description of the IPNS record (optional).
-c, --cid <cid>: CID to which this IPNS name will point.

Example

apillon storage ipns create --bucket-uuid "123e4567-e89b-12d3-a456-426655440000" --name "my-ipns-record" --cid "QmWX5CcNvnaVmgGBn4o82XW9uW1uLvsHQDdNrANrQeSdXm"

`storage ipns get`

Retrieves information about a specific IPNS record.

Options

-b, --bucket-uuid <uuid>: UUID of the bucket.
-i, --ipns-uuid <uuid>: UUID of the IPNS record.

Example

apillon storage ipns get --ipns-uuid "123e4567-e89b-12d3-a456-426655440000"

`storage ipns publish`

Publishes an IPNS record to IPFS and links it to a CID.

Options

-b, --bucket-uuid <uuid>: UUID of the bucket.
-i, --ipns-uuid <uuid>: UUID of the IPNS record.
-c, --cid <string>: CID to which this IPNS name will point.

Example

apillon storage ipns publish --ipns-uuid "123e4567-e89b-12d3-a456-426655440000" --cid "QmWX5CcNvnaVmgGBn4o82XW9uW1uLvsHQDdNrANrQeSdXm"

`storage ipns delete`

Deletes an IPNS record from a specific bucket.

Options

-b, --bucket-uuid <uuid>: UUID of the bucket.
-i, --ipns-uuid <uuid>: UUID of the IPNS record.

Example

apillon storage ipns delete --ipns-uuid "123e4567-e89b-12d3-a456-426655440000"

NFT Commands

`nfts list-collections`

Lists all NFT collections owned by the project related to the API key.

Options

--status <integer>: UUID of the collection to retrieve (CollectionStatus enum, optional).

Available choices:

CREATED = 0
DEPLOY_INITIATED = 1
DEPLOYING = 2
DEPLOYED = 3
TRANSFERRED = 4
FAILED = 5

Example

apillon nfts list-collections --status 3

Example response

{
  "items": [
    {
      "createTime": "2023-11-20T10:21:12.000Z",
      "updateTime": "2023-11-20T14:12:33.000Z",
      "uuid": "2cda3a9b-01b1-4b5e-9709-7087129d55d0",
      "symbol": "SE",
      "name": "SpaceExplorers",
      "description": "A collection of unique space exploration NFTs.",
      "collectionType": "GENERIC",
      "maxSupply": 1000,
      "baseUri": "https://moonbeamnfts.com/collections/spaceexplorers/",
      "baseExtension": ".json",
      "isSoulbound": false,
      "isRevokable": false,
      "drop": false,
      "dropPrice": 0.05,
      "dropStart": 1679875200,
      "dropReserve": 100,
      "royaltiesFees": 5,
      "royaltiesAddress": "0xaz5Bh6E56c5d3B58c944542de2bF18E7F65eED82",
      "collectionStatus": "TRANSFERRED",
      "contractAddress": "0x4e22162A6d0c91a088Cb57A72aB976ccA2A96B25",
      "transactionHash": null,
      "deployerAddress": "0xba015fgc6d80378a9a95f1687e9960857593983b",
      "chain": "MOONBASE"
    }
  ],
  "total": 1
}

`nfts get-collection`

Retrieves information about a specific NFT collection.

Options

--uuid <collection-uuid>: UUID of the collection to retrieve.

Example

apillon nfts get-collection --uuid "123e4567-e89b-12d3-a456-426655440000"

`nfts create-collection`

Creates a new NFT collection. The JSON file needs to have the property structure as type ICreateCollection for EVM and ICreateSubstrateCollection for Substrate collections. An example object can be also seen on the NFT SDK docs.

Options

<file-path>: Path to the JSON data file for the new collection.

Example

apillon nfts create-collection ./nft-data.json

`nfts mint-nft`

Mints NFTs for a collection with a specific UUID.

Options

--uuid <collection-uuid>: UUID of the collection to mint NFTs to.
-a, --address <string>: Address which will receive minted NFTs.
-q --quantity <integer>: Number of NFTs to mint. (default 1).

Example

apillon nfts mint-nft --uuid "123e4567-e89b-12d3-a456-426655440000" --address "0xdAC17F958D2ee523a2206206994597C13D831ec7" --quantity 2

`nfts nest-mint-nft`

Nest mints NFT child collection to a parent collection with a specific UUID and parent NFT with id.

Options

-c, --parent-collection-uuid <collection-uuid>: Parent collection UUID to which child NFTs will be minted to.
-p, --parent-nft-id <string>: Parent collection NFT id to which child NFTs will be minted to.
-q, --quantity <integer>: Number of child NFTs to mint (default 1).

Example

apillon nfts nest-mint-nft --parent-collection-uuid "123e4567-e89b-12d3-a456-426655440000" --parent-nft-id 5 --quantity 2

`nfts burn-nft`

Burns an NFT for a collection with a specific UUID.

Options

--uuid <collection-uuid>: Collection UUID.
-t, --token-id <integer>: NFT id which will be burned.

Example

apillon nfts burn-nft --uuid "123e4567-e89b-12d3-a456-426655440000" --token-id 123

`nfts transfer-collection`

Transfers NFT collection ownership to a new wallet address.

Options

--uuid <collection-uuid>: Collection UUID.
-a, --address <string>: Address which you want to transfer collection ownership to.

Example

apillon nfts transfer-collection --uuid "123e4567-e89b-12d3-a456-426655440000" --address "0xdAC17F958D2ee523a2206206994597C13D831ec7"

`nfts list-transactions`

Lists NFT transactions for a specific collection UUID.

Options

--uuid <collection-uuid>: Collection UUID.
--status <integer>: Transaction status (TransactionStatus enum, optional).

Available choices:

PENDING = 1
CONFIRMED = 2
FAILED = 3
ERROR = 4

--type <integer>: Transaction type (TransactionType enum, optional).

Available choices:

DEPLOY_CONTRACT = 1
TRANSFER_CONTRACT_OWNERSHIP = 2
MINT_NFT = 3
SET_COLLECTION_BASE_URI = 4
BURN_NFT = 5
NEST_MINT_NFT = 6

Example

apillon nfts list-transactions --uuid "123e4567-e89b-12d3-a456-426655440000"

Example response

{
  "items": [
    {
      "createTime": "2023-11-20T10:21:22.000Z",
      "updateTime": "2023-11-20T10:23:31.000Z",
      "chainId": "MOONBEAM",
      "transactionType": "DEPLOY_CONTRACT",
      "transactionStatus": "CONFIRMED",
      "transactionHash": "0xab99e630f9475df92768b1e5d73f4..."
    },
    {
      "createTime": "2023-11-20T11:55:13.000Z",
      "updateTime": "2023-11-20T11:57:31.000Z",
      "chainId": "MOONBEAM",
      "transactionType": "MINT_NFT",
      "transactionStatus": "CONFIRMED",
      "transactionHash": "0x1ecfeeaeddfa0a39fc2ae1ec755d27..."
    },
    ...
  ],
  "total": 4
}

Using in CI/CD tools

CLI is particularly useful for CI/CD builds and pipelines.

Deploying websites

Here's an example of how you can use the CLI tool in a CI/CD tool like GitHub Actions:

name: Deploy Website

on:
  push:
    branches:
      - master

jobs:
  deploy:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Set up Node.js
        uses: actions/setup-node@v3
        with:
          node-version: 16

      - name: Create dist folder
        run: mkdir -p dist

      - name: Copy files
        run: |
          cp *.html dist/
          cp -r images dist/
          cp -r style dist/
          cp -r js dist/

      ####
      ## if you are using a framework for building web app, you can replace previous two step with the
      ## appropriate command for generating static webpage, like an example bellow.
      ## Find the correct command in your framework documentation. You may need to to change the
      ## name of the source folder in the last step (CLI call)
      ####

      # - name: Build app
      #   run: npm run build

      - name: Deploy website
        env:
          APILLON_API_KEY: ${{ secrets.APILLON_API_KEY }}
          APILLON_API_SECRET: ${{ secrets.APILLON_API_SECRET }}
          WEBSITE_UUID: ${{ secrets.WEBSITE_UUID }}
        run: npx --yes @apillon/cli hosting deploy-website ./dist --uuid $WEBSITE_UUID --key $APILLON_API_KEY --secret $APILLON_API_SECRET
        # Or alternatively you can use the run configuration below
        # run: |
        #   npm i -g @apillon/cli
        #   apillon hosting deploy-website ./dist --uuid $WEBSITE_UUID --key $APILLON_API_KEY --secret $APILLON_API_SECRET

In this example, the GitHub Actions workflow is triggered when a push event occurs on the master branch. The workflow performs the following steps:

Checks out the repository.
Sets up Node.js with version 16.
Creates a dist folder to store the website files.
Copies the necessary files (HTML, images, styles, and JavaScript) to the dist folder.
Deploys the website using the CLI tool. The required environment variables (APILLON_API_KEY, APILLON_API_SECRET, and WEBSITE_UUID) are provided as secrets. The npx command ensures that the latest version of the CLI tool is used.

Make sure to setup secret variables with the values from Apillon platform.

That's it! You can now use this example as a starting point to deploy your website using the CLI tool in a CI/CD pipeline with GitHub Actions.

You can also check a working example on Github

@apillon/cli

Apillon CLI

Requirements

Installation

Global Options

Environment Variables

Help

List pagination options

Commands

Hosting Commands

hosting list-websites

hosting get-website

hosting deploy-website

hosting upload

hosting start-deployment

hosting list-deployments

hosting get-deployment

Storage Commands

storage list-buckets

storage list-objects

storage list-files

storage upload

storage get-file

storage delete-file

storage delete-directory

IPNS Commands

storage ipns list

storage ipns create

storage ipns get

storage ipns publish

storage ipns delete

NFT Commands

nfts list-collections

nfts get-collection

nfts create-collection

nfts mint-nft

nfts nest-mint-nft

nfts burn-nft

nfts transfer-collection

nfts list-transactions

Using in CI/CD tools

Deploying websites

Readme

Keywords

Package Sidebar

Install

Repository

Homepage

DownloadsWeekly Downloads

Version

License

Unpacked Size

Total Files

Last publish

Collaborators

`hosting list-websites`

`hosting get-website`

`hosting deploy-website`

`hosting upload`

`hosting start-deployment`

`hosting list-deployments`

`hosting get-deployment`

`storage list-buckets`

`storage list-objects`

`storage list-files`

`storage upload`

`storage get-file`

`storage delete-file`

`storage delete-directory`

`storage ipns list`

`storage ipns create`

`storage ipns get`

`storage ipns publish`

`storage ipns delete`

`nfts list-collections`

`nfts get-collection`

`nfts create-collection`

`nfts mint-nft`

`nfts nest-mint-nft`

`nfts burn-nft`

`nfts transfer-collection`

`nfts list-transactions`

Weekly Downloads