Initial Setup

Install CLI

Run this command to install Tivet on your system:

curl -fsSL https://releases.tivet.xyz/tivet/latest/install.sh | sh

Initialize project

Once you've installed the Tivet CLI, run this command in your project root to create a new project:

tivet init

Follow the instructions to initialize your project.

Deploy project

After initializing your project, will deploy your actor to Tivet's servers:

cd my-app  # Replace "my-app" with your project name
tivet deploy

If self-hosting, this will prompt you to input a custom API address.

Create a test actor

Now that you've uploaded a build to Tivet, we need to create an actor. To test the actor can be created & connected to, run:

npx tsx counter_test.ts

Setup client

Now that you have an actor deployed, integrate the Tivet client SDK with your actor.

Install the Actor client package:

npm add @tivet-xyz/actor-client

Once installed, we need to find the endpoint that your actors connect to. Run this command in your project:

tivet manager endpoint

Use this code to create & connect to the actor. Replace /* CONNECTION ADDRESS */ with the value from the previous step.

import { Client } from '@tivet-gg/actor-client';
const client = new Client(/* CONNECTION ADDRESS */);

const counter = await client.get({ name: 'counter' }); // Get or create a `counter` actor
const newCount = await counter.increment(5); // Call the method `increment` on the `counter` actor
console.log('New count', newCount);