Create Context

Initialize node

Terminal

merod --node-name node1 init --server-port 2428 --swarm-port 2528

Node configuration file contains protocol defined metadata.

Run node

Terminal

merod --node-name node1 run

Wait for a few moments and node logs should appear.

When you see something like this that means that node is now ready for use.

Create a New Context

Meroctl

Near

Terminal

meroctl --node-name node1 context create --watch <application_path> --protocol near

Starknet

Terminal

meroctl --node-name node1 context create --watch <application_path> --protocol starknet

ICP

Terminal

meroctl --node-name node1 context create --watch <application_path> --protocol icp

Stellar

Terminal

meroctl --node-name node1 context create --watch <application_path> --protocol stellar

tip

• --watch flag enables watching for changes of wasm files and updating context with the new version
• --protocol flag specifies the protocol to use for the context
• --as flag creates an alias for your identity in your context, you can use it instead of the PublicKey

Interactive cli

Install the Application

Run the following command to install the application:

Node Terminal

application install url {url} {metadata}

note

metadata example:

'{"contractAppId": "<application_id>"}'

Create a New Context

Near

Node Terminal

context create {applicationId} --protocol near

Starknet

Node Terminal

context create {applicationId} --protocol starknet

ICP

Node Terminal

context create {applicationId} --protocol icp

Stellar

Node Terminal

context create {applicationId} --protocol stellar

tip

--protocol flag specifies the protocol to use for the context.

Output

2024-10-07T11:55:36.658396Z  INFO calimero_context: Subscribed to context context_id=567C5Gg4mxHMPKy2wLJ4uvb3DHsbcpVDYUsuAWgTPgXn
Created context 567C5Gg4mxHMPKy2wLJ4uvb3DHsbcpVDYUsuAWgTPgXn with
identity DaSkad6DK7f6fUhjz1CvNW7L4TkWZmWqAcwysZHG3Xs5

Admin Dashboard

Create a context using the Admin Dashboard

1. Navigate to the "Contexts" tab and click the "Start New Context" button.
2. Use the "Browse" button to select an application from the list.
3. Choose application.
4. Press "Start" to initiate the context creation process with the selected application.

Visit Admin Dashboard Page to view detailed instructions with images.

After the context is created, you will be redirected to the context dashboard. Keep this page open as you will need the Context ID later.

You have now created a new context.

To create an alias for this context, use:

Terminal

context alias add my_context <context_id>

Next step is to invite users to join your context. Continue with invitations and joinings.