Frontend User Guide
A frontend user guide for the VORJ beta release
Last updated
Was this helpful?
A frontend user guide for the VORJ beta release
Last updated
Was this helpful?
The purpose of this guide is to provide a first time VORJ user with the steps required to create and deploy an ERC-721 smart contract through the VORJ frontend.
This API is not meant for production use, currently beta.
You, the user, accept all responsibility for the use of the VORJ API.
Through the use of the API you are agreeing to the and of VORJ.
The VeChain Foundation San Marino nor any other entity associated with VeChain nor VORJ accept any responsibility associated with the use of VORJ.
All smart contracts created and deployed through VORJ are done so through the VORJ deployment wallet and thus these smart contracts are owned and controlled by VORJ, unless they are transferred by the user to another wallet.
The digital assets, either fungible or non-fungible, that are created as part of the smart contracts are minted into your own self-custody wallet, through the provided API endpoints, and thus the digital assets are owned and controlled by the private key holder of that wallet.
To get started on VORJ, you will first need to create and verify an account. Follow the four steps to create and verify your VORJ account.
From the landing page if you already have an account you can login. If you are a new user and are creating an account press the Register
link.
After having selected the register account you will be prompted to provide an email address and a name. After populating this information press Sign Up
.
The next step in creating your VORJ account is to set a password and agree to the Terms of Service. Once you have read and are satisfied with the Terms of Service proceed to check the associated checkbox. Signing up to the newsletter is optional and you can always change your preferences at a later stage. The Next
button will become active once a valid password is set and the Terms of Service checkbox is checked.
You will receive a verification code through the email address that you signed up with. Please provide this verification code to complete your VORJ account creation.
After a successful registration you will be presented with a success message as shown in the image below.
The next step is to create an organization. An organization is a space where you can collaborate with team members to create projects which group your smart contracts.
From the success page, as show above, select the Create Organization
button which will start the organization creation process.
As there is only one place select the Next
button to select the Free plan.
VORJ is currently a beta release, as such there is only a free plan on offer
You can invite team members to join your organization to collaborate with you as you create smart contracts. To procced press Next
to move onto the final step in the organization creation process.
A project is a workspace within an organization where you and your team can collaborate on creating smart contracts. Provide a project name, select the network that you want to deploy your smart contract on and set an image for your project.
After successfully creating an organization and project you will be directed to the dashboard page, which is shown in the image below.
The next step is to create a smart contract. After we have successfully created a project, we should be on a page similar to the image show above. From here we can select the project card by clicking on it. By clicking on the project card we are entering the project space, we should now be on a page similar to the image shown below.
The first step is to allocate resources to our project so that we can create, deploy and interact with our smart contracts. To allocate resources select the Allocate Resources
button.
We will be presented with a modal where we can assign a set amount of API Calls
, API Calls/Min
and Smart Contract Deployments
for the project to use. In this example we have set the following values:
API Calls: 100
API Calls/Min: 10
Smart Contract Deployments: 2
Once you have set the resources for your project press the Confirm
button to proceed to the next step.
The image below is an example of a project with no smart contracts but with resources allocated. The next step is to begin the smart contract creation process.
Having allocated resources and having met the minimum resource allocation requirements we should now be able to use the Create Smart Contract
button. We will be presented with the options of smart contracts standards that we choose from.
We will be selecting the ERC721 token standard to create a Non-Fungible Token (NFT).
Smart contracts are immutable, this means that once they are deployed they cannot be changed or altered in anyway. It is advised that you proceed with caution.
Always, check the contents of the form and double check it before deploying.
Having selected the NFT standard we are presented with the template to populate, as shown in the image below. This template has a number of required and optional fields.
At a minimum the fields under the heading Token Appearance
must be populated. The fields contained in the Features
section are optional. It is strongly advised that you read the supporting information icons to understand the purpose of the fields before activating them.
VORJ beta release and restricts the user to creating an NFT collection with a maximum of 20 images. Future releases will lift this limitation through the availability of plans with different levels of resources.
Either drag and drop or press upload icon within the Upload Media
section. Select the group of media files that you want to upload, these can be images, video, sound or animation files. You must upload all of the files in one group at the same time. A limited number of file types are supported and there is a maximum file size per media item. Currently, there is a limit of 20 media items per NFT contract.
Having uploaded the media files you will be presented with additional fields to populate within the Metadata
section. You can provide a description for your NFT collection and up to five attributes per media items via the dynamic table. To add an attribute field use the Set Metadata
button.
Once you have populated the NFT metadata you can use the Preview
section to check and confirm the metadata of each item in your collection.
As shown in the image above the final action is to either save the contract via the Save
button and deploy it at a later stage or to deploy the contract via the Deploy
button.
The first image below shows the screen that will immediately appear once you select Deploy
. The here
links to the above mentioned Usage
page and Transactions
tab.
The second image shows the state of the contract that is pending deployment. The contract is in a read only state as the contract deployment transaction is propagated through the blockchain network. Once the contract deployment is successful you should be able to interact with the smart contract, more on this in the next section.
Once your smart contract has been successfully deployed you can perform various activities on your smart contract via the Actions
tab.
To mint an NFT simply populate the Address
field with the receiver Vechain address along with a valid tokenID(s)
.
Congratulations you have now created, deployed and minted an NFT on the VechainThor blockchain.
Refer to for more information.
The NFT media that you provide as part of your NFT will be uploaded to the (IPFS).