Skip to content
Vendia

Creating Your Uni

A Uni is comprised of multiple nodes that share a common data model. There is a separate page outlining how to model your data. On this page, we will address how to create the resources required of a Uni and how to define and associate partners with the model.

Creating a Uni

There are a couple of methods to create a Uni in Vendia Share:

Using a Registration File with Vendia Share CLI

The registration file is a JSON file used to define where to locate the schema and the nodes that are participating in a Uni.

When creating a registration file, the registration file must include the name of the Uni (with or without its namespace), the schema JSON file, as well as any nodes you want created at initial build.

Sample dynamic registration file 
{
  "name": "test-inventory",
  "schema": "schema.json",
  "nodes": [
    {
      "name": "DistributionCenter",
      "userId": "user1@domain1.com",
      "region": "us-east-2",
      "csp": "aws"
    }
  ]
}

Using the Vendia Share Web Application

To create a Uni, navigate to the Vendia Share web application and click the ‘Create application’ button:

Create an Application Button

Uni creators can only register nodes under their own email. To add additional nodes owned by different users, the Vendia Share manager of the specific node must invite additional parties. The invitation can be created from the Vendia Share CLI (share uni invite) or through the Vendia Share web application.

Once the initial Uni is created, it will be in a RUNNING state. Each participant can be added when the time is appropriate. There is no need for other parties to specify a schema or initial state. New nodes will have their data populated from the existing Uni.

Inviting Partners

Invitations can be sent to new partners by clicking the ‘Invite Partner’ button in the Uni’s ‘Share’ page. Invite Partner

The invitation will be sent to the partner’s email address. The partner will receive an email with a link to accept the invitation. Provide Partner Email Address

When the new participant accepts the invitation and joins the Uni, the Uni will pause write operations as initial data is populated in the new node. Once the new node is up and running and data is in sync, the Uni will automatically return to the RUNNING state. Pending writes will be applied. Read requests to a Uni node are unaffected and will continue to work as expected while the new node is added to the Uni.

Adding a Node

When a node is added to your Uni, the new node’s ledger and world state are seeded from a single node in the Uni. This node is called the Seed Node. The Seed Node is always the first node in the Uni.

NOTE: Vendia Share users inviting new nodes to a Uni must have sufficient privileges. Vendia Share users accepting an invitation must also have sufficient privileges to join a Uni. Please review Vendia’s Role-based Access Control documentation for more detail.

IMPORTANT: Though many invitations can be sent out to new Uni participants, only one node can be added at a time.