2. Register a project

2. Register a project

A project is an administrative-level entity that is associated with an owner address, which is your wallet address.

A project can have many collections.

The best way to create a project is to use the imx-examples repository.

🤚PRE-REQUISITES

• Registering as a user

Steps:​

1. Signup to the XpansionChain Developer Hub

2. Register a project

3. Get details about your projects

1. Signup to the XpansionChain Developer Hub​

Register your email address on the XpansionChain Developer Hub to get access to customised documentation and the ability to create projects on XpansionChain.

Projects are required to create collections which subsequently allow minting assets on XpansionChain (L2).

When creating a project the contact_email parameter needs to be a email address that has been registered and verified on the Developer Hub. Attempting to create a project without registered and verified email address will return an error if the onboarding flow was not completed.

PROJECT OWNERSHIP CANNOT BE TRANSFERRED

Once a project is registered to a particular wallet address (public key), it cannot be changed. Make sure that the wallet you use to register a project is one that you have adequate security management for.

2. Register a project​

Follow the 2. Create project steps in the imx-examples repository.

3. Get details about your projects​

Including checking your project limits.

Get:

• List of projects that you are the owner of

• Details of a project by ID (you must be the project owner)

Limits​

Collection limits:​

• Projects are limited to five collections within a four-week period

• The four-week period starts from the moment a collection is created

• If a collection's request is sent that exceeds this limit, the request will fail, returning an error with a status code of 429 and a message of "Collection limit exceeded"

• If four weeks have elapsed since the previous collection was created, a new four-week window starts from the time the next request is made

• Project limit information will be included in response headers when a request fails due to the limit being exceeded, and also when a request is successful

Response information includes:

Attribute	Description
collection_remaining	How many collections remain for the four-week time period
collection_limit_reset	The expiry date of the current four-week window
collection_limit	The collection limit available to the project for each four-week window

INCREASE PROJECT LIMITS

Project limits, for both minting and collections, can be increased by contacting support about your project. Be sure to include your reason for an increase. Our team will respond to your request within 2 business days.

Minting limits​

• Projects are limited to 50,000 mints within a four-week period

• The four-week period starts when a project's first mint request is made

• If a mint request is sent that exceeds the limit, the request will fail returning an error with a status code of 429 and a message of "Mint limit exceeded"

• If four weeks have elapsed since the previous mint, a new four-week window starts from the time the next request is made

• Project limit information will be included in response headers when a request fails due to the limit being exceeded, and also when a request is successful

Response information includes:

Attribute	Description
mint_remaining	How many mints remain for the four-week time period
mint_limit_reset	The expiry date of the current four-week window
mint_limit	The mint limit available to the project for each four-week window