Immutable Integration Scripts

This repository is a collection of CLI scripts to execute common functions on the IMX platform.

Prerequisites

The scripts in this repository are written in Typescript, and require a Node JS runtime. To get started run the following commands in your terminal in Mac OS.

Install Homebrew - /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install Node - brew install node

Getting Started

With the pre-requisite software installed, execute the command npm install to install the required libraries to run the code in this repository. Also make sure to rename the .env.example file to .env and populate the different variables, the main ones being the provider URLs. Alchemy(https://www.alchemy.com/) is a popular choice for a Node provider. Simply create a new app for Goerli or Mainnet and click "View key", copy the HTTPS URL provided and paste that into the .env file for the provider URL variable for the respective network.

Scripts

The scripts can be found in the src/get or src/post folder, and are broken down below. The network is defined as either sandbox or mainnet for all scripts.

GET Requests

Retrieve a users ETH balance

npx ts-node ./src/get/get-balance.ts -a <WALLET_ADDRESS> --network <NETWORK>

Retrieve a users inventory

npx ts-node ./src/get/get-user-assets.ts -a <WALLET_ADDRESS> --network <NETWORK>

Check whether a wallet is registered on IMX

npx ts-node ./src/get/get-user.ts -a <WALLET_ADDRESS> --network <NETWORK>

Retrieve a burn

npx ts-node ./src/get/get-burn.ts --id <TRANSACTION_ID> --network <NETWORK>

Retrieve a deposit

npx ts-node ./src/get/get-deposit.ts --id <TRANSACTION_ID> --network <NETWORK>

Retrieve an order

npx ts-node ./src/get/get-order.ts --id <ORDER_ID> --network <NETWORK>

Retrieve a withdrawal

npx ts-node ./src/get/get-withdrawal.ts --id <TRANSACTION_ID> --network <NETWORK>

Retrieve an asset

npx ts-node ./src/get/get-asset.ts -t <TOKEN_ID> -s <SMART_CONTRACT_ADDRESS> --network <NETWORK>

Retrieve mintable token(includes blueprint)

npx ts-node ./src/get/get-mintabletoken.ts -t <TOKEN_ID> -s <SMART_CONTRACT_ADDRESS> --network <NETWORK>

POST Requests

Burn ERC20

npx ts-node ./src/post/burn-ERC20.ts \
  -k <PRVIATE_KEY> \
  -a <AMOUNT> \
  -d <DECIMALS> \
  -y <SMART_CONTRACT_ADDRESS> \
  -s <SMART_CONTRACT_ADDRESS> \
  --network <NETWORK>

Burn NFT

npx ts-node ./src/post/burn-NFT.ts \
  -k <PRIVATE_KEY> \
  -t <TOKEN_ID> \
  -s <SMART_CONTRACT_ADDRESS> \
  --network <NETWORK>

Create project

npx ts-node ./src/post/create-project.ts \
  -k <PRIVATE_KEY> \
  -n <PROJECT_NAME> \
  -c <COMPANY_NAME> \
  -e <CONTACT_EMAIL> \
  --network <NETWORK>

Create collection without optional parameters metadata_api_url, description, icon_url, collection_image_url

npx ts-node ./src/post/create-collection.ts \
  -k <PRIVATE_KEY> \
  -n <NAME> \
  -s <SMART_CONTRACT_ADDRESS> \
  -p <PROJECT_ID> \
  --network <NETWORK>

Update collection

npx ts-node ./src/post/update-collection.ts \
  -k <PRIVATE_KEY> \
  -s <SMART_CONTRACT_ADDRESS> \
  -n <NAME> \
  -d <DESCRIPTION> \
  -i <ICON_URL> \
  -m <METADATA_API_URL> \
  -o <COLLECTION_IMAGE_URL> \
  --network sandbox

Add metadata schema to collection

The schema itself is defined in the code and essentially defines the types for each piece of metadata.

npx ts-node ./src/post/add-metadata-schema.ts \
  -k <PRIVATE_KEY> \
  -s <SMART_CONTRACT_ADDRESS> \
  --network <NETWORK>

Update metadata schema by name

Update a metadata schema by name, the updated schema is defined in the code.

npx ts-node ./src/post/update-metadata-schema-by-name.ts \
  -k <PRIVATE_KEY> \
  -s <SMART_CONTRACT_ADDRESS> \
  -n <NAME_OF_SCHEMA> \
  --network <NETWORK>

Create NFT<>ETH Sell Order

npx ts-node ./src/post/create-NFT-ETH-sell-order.ts \
  -k <PRIVATE_KEY> \
  -t <TOKEN_ID> \
  -s <SMART_CONTRACT_ADDRESS> \
  -a <SALE_AMOUNT> \
  --network <NETWORK>

Create buy order

npx ts-node ./src/post/create-buy-order.ts \
  -k <PRIVATE_KEY> \
  -t <TOKEN_ID> \
  -s <SMART_CONTRACT_ADDRESS> \
  -a <SALE_AMOUNT> \
  -o <ORDER_ID> \
  --network <NETWORK>

Deposit ETH

To deposit ETH from L1 to L2 issue the following command:

npx ts-node ./src/post/deposit-ETH.ts -k <PRIVATE_KEY> -a <AMOUNT> --network <NETWORK>

Deposit NFT

To deposit an NFT from L1 to L2 issue the following command:

npx ts-node ./src/post/deposit-NFT.ts \
  -k <PRIVATE_KEY> \
  -t <TOKEN_ID> \
  -s <SMART_CONTRACT_ADDRESS> \
  --network <NETWORK>

Deposit ERC20

To deposit ERC20 from L1 to L2 issue the following command:

npx ts-node ./src/post/deposit-ETH.ts -k <PRIVATE_KEY> -a <AMOUNT> -d <DECIMALS> -y <SYMBOL> -t <SMART_CONTRACT_ADDRESS> --network <NETWORK>

Mint NFT without royalties

npx ts-node ./src/post/mintV2.ts \
  -k <PRIVATE_KEY> \
  -t <TOKEN_ID> \
  -s <SMART_CONTRACT_ADDRESS> \
  -b <BLUEPRINT> \
  -r <RECEIVER_ADDRESS> \
  --network <NETWORK>

Register user

A user has to be registered in order to do anything on IMX. Registering a user creates a vault in the state of the L2.

npx ts-node ./src/post/register-user.ts -k <PRIVATE_KEY> --network <NETWORK>

Transfer ETH

npx ts-node ./src/post/transfer-ETH.ts \
  -k <PRIVATE_KEY> \
  -t <RECEIVER_ADDRESS> \
  -a <AMOUNT> \
  --network <NETWORK>

Transfer NFT

npx ts-node ./src/post/transfer-NFT.ts \
  -k <PRIVATE_KEY> \
  -r <RECEIVER_ADDRESS> \
  -t <TOKEN_ID> \
  -s <SMART_CONTRACT_ADDRESS> \
  --network <NETWORK>

Transfer ERC20

npx ts-node ./src/post/transfer-ERC20.ts \
  -k <PRIVATE_KEY> \
  -a <AMOUNT> \
  -d <DECIMALS> \
  -y <SYMBOL> \
  -s <SMART_CONTRACT_ADDRESS> \
  --network <NETWORK>

Multi-transfer

Transfer multiple tokens with a single request. The token definitions sit within the main() itself.

npx ts-node ./src/post/multi-transfer.ts -k <PRIVATE_KEY> --network <NETWORK>

Withdrawals

Withdrawals on IMX are a two step process. The withdrawal needs to be prepared first. During preparation funds are deducted from the off-chain vault, and moved into the pending on-chain withdrawals area. This area is accessible to the StarkEx contract which completes the withdrawal when the completeWithdraw function is invoked. The completeWithdraw function invokes the relevant StarkEx contract function depending on the type of token. For example if we are withdrawing ETH/ERC-20, it invokes the prepareWithdraw function. If we are withdrawing a token minted on IMX, it invokes the withdrawAndMint else it just invokes the withdrawNFT function.

Prepare ETH withdrawal

To prepare a withdrawal issue the following command:

npx ts-node ./src/post/withdraw-ETH.ts \
  -k <PRIVATE_KEY> \
  -a <AMOUNT> \
  --step prepare \ 
  --network <NETWORK>

Complete ETH withdrawal

To complete the withdrawal issue the following command;

npx ts-node ./src/post/withdraw-ETH.ts \
  -k <PRIVATE_KEY> \
  -a <AMOUNT> \
  --step complete \ 
  --network <NETWORK>

Prepare NFT withdrawal

To prepare a withdrawal issue the following command;

npx ts-node ./src/post/withdraw-NFT-prepare.ts \
  -k <PRIVATE_KEY> \
  -t <TOKEN_ID> \
  -s <SMART_CONTRACT_ADDRESS> \
  --network <NETWORK>

Complete NFT withdrawal

To complete the withdrawal issue the following command;

npx ts-node ./src/post/withdraw-NFT-complete.ts \
  -k <PRIVATE_KEY> \
  -t <TOKEN_ID> \
  -s <SMART_CONTRACT_ADDRESS>
  -g [GAS_LIMIT]
  -p [GAS_PRICE]
  --network <NETWORK>

Prepare ERC20 withdrawal

To prepare a withdrawal issue the following command;

npx ts-node ./src/post/withdraw-ERC20.ts \
  -k <PRIVATE_KEY> \
  -a <AMOUNT> \
  -d <DECIMALS> \
  -y <SYMBOL> \
  -t <TOKEN_ADDRESS> \
  --step prepare \ 
  --network <NETWORK>

Complete ERC20 withdrawal

To complete the withdrawal issue the following command;

npx ts-node ./src/post/withdraw-ERC20.ts \
  -k <PRIVATE_KEY> \
  -d <DECIMALS> \
  -y <SYMBOL> \
  -t <TOKEN_ADDRESS> \
  --step complete \ 
  --network <NETWORK>

L1 tasks

Compile contract(s)

Compiles the contracts in src/L1/artifacts using Hardhat

npx ts-node compile-contract.ts

Deploy contract

Deploys a contract that has been compiled to src/L1/artifacts. <CONTRACT_TO_DEPLOY> is the name of the compiled contract such as 'Asset' for Asset.sol

npx ts-node deploy-contract.ts \
  -k <PRIVATE_KEY> \
  -c <CONTRACT_TO_DEPLOY> \
  -n <NAME> \ 
  -y <SYMBOL> \
  --network sandbox

Verify your contract on Etherscan using Hardhat

Verifies your contract on Etherscan so that people can read the code and do contract calls
npx hardhat verify --network goerli 0x755C62d0a0e347A1506f863093a66E85Af8AbDC2 <OWNER_ADDRESS> "IMX Chess" "IMXC" <IMX_CORE_ADDRESS>

TODO:

Add recursion to the end-to-end mint to wait for fetch mint rather than using delay
Make amount on complete ETH withdrawal optional as it's not a variable
Add a method to fetch the latest IMX contracts directly from the repo before compile
Fix get vaults
Add get trades method
Add get transfers method
Add metadata attribute types to add-metadata-schema and update-metadata-schema-by-name
Separate out prepare and complete withdrawals for ETH and ERC20

Name		Name	Last commit message	Last commit date
Latest commit History 97 Commits
.vscode		.vscode
cache		cache
src		src
.env.example		.env.example
.gitignore		.gitignore
README.md		README.md
hardhat.config.ts		hardhat.config.ts
hardhat.config.ts.example		hardhat.config.ts.example
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
tslint.json		tslint.json
yarn.lock		yarn.lock

danekshea/imxscripts

Folders and files

Latest commit

History

Repository files navigation

Immutable Integration Scripts

Prerequisites

Getting Started

Scripts

GET Requests

Retrieve a users ETH balance

Retrieve a users inventory

Check whether a wallet is registered on IMX

Retrieve a burn

Retrieve a deposit

Retrieve an order

Retrieve a withdrawal

Retrieve an asset

Retrieve mintable token(includes blueprint)

POST Requests

Burn ERC20

Burn NFT

Create project

Create collection without optional parameters metadata_api_url, description, icon_url, collection_image_url

Update collection

Add metadata schema to collection

Update metadata schema by name

Create NFT<>ETH Sell Order

Create buy order

Deposit ETH

Deposit NFT

Deposit ERC20

Mint NFT without royalties

Register user

Transfer ETH

Transfer NFT

Transfer ERC20

Multi-transfer

Withdrawals

Prepare ETH withdrawal

Complete ETH withdrawal

Prepare NFT withdrawal

Complete NFT withdrawal

Prepare ERC20 withdrawal

Complete ERC20 withdrawal

L1 tasks

Compile contract(s)

Deploy contract

Verify your contract on Etherscan using Hardhat

TODO:

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages