⏱️Get Started

If you’re a developer ready to start building Truebit tasks, follow our Getting Started guide to install the Truebit CLI and connect to one of our pre-configured Hosted Nodes, available for community use

Prerequisites

• node.js: 22.13.1 or higher

• npm: 10.7.0 or higher

Public Beta considerations

During the Public Beta, Truebit will cover the cost of the blockchain transactions. To qualify, please ensure you’re registered on our platform.

1. Installing the Truebit CLI

Install the Truebit CLI globally using the command:

npm i -g @truebit/cli

2. Register into Truebit

Already have an account?

If you already registered into Truebit:

Update the secret.json file located in the ~/.truebit directory

{
  "address": "your-wallet-address",
  "privateKey": "your-private-key"
}

Create new account

Please run the following command to setup a new Truebit account:

truebit setup 

You will be asked to accept the Terms of Use. Once accepted, you will see the following result.

A new secret.json file containing your account information has been created at: /Users/<username>/.truebit/secret.json.

Welcome to Truebit Verify!

Your all-in-one solution to develop, build, test, and deploy tasks seamlessly.
Let's get started by setting up your account and configuring your wallet.
We'll guide you through each step to ensure a smooth experience.

**Important: Private Key Information

Truebit Verify employs a private key system to secure your account:

  - A unique private key will be automatically generated for you.
  - This key serves as your secure identifier within Truebit Verify.
  - It's used internally to authenticate your actions.
  - You won't need to manage this key directly.

We are committed to ensuring the security of your private key and safeguarding your account.
Ready to begin?
Press [Y] to proceed or [N] to exit: 

Step 1 - Create an Account

Step 1: Create an Account

It appears you're a new user without a wallet configured locally.

Would you like to create a new wallet now?
Press [Y] to proceed or [N] to skip:

Once you Type "Y"

Setting up your new wallet...

Your new wallet address is: <wallet>

Your wallet information has been securely stored in /Users/<username>/.truebit/secret.json
Please keep this file safe, as it contains your credentials for using Truebit Verify.

Step 2 - Create an Account

The system will ask the following information:

• Name: Your full name.

• Verification Email: An email address.

• Company Name: Your company’s name.

• Job Position: Your job position.

• EULA Acceptance: Accept the End User License Agreement (EULA). [ Y|N ]

Now that your wallet is set up, let's create your Truebit Verify account.

Please provide the following information:

1. Full Name: John Doe
2. Email Address: [e-mail]
3. Company Name: Acme
4. Job Position: Senior Developer
5.Accept EULA? [Yes|No] (link to EULA): Yes

... registering your account.

Thanks for registering to Truebit Verify!

Congratulations! Your Truebit Verify account has been successfully created. 

Account Summary: 
- Name: John Doe 
- Email: [e-mail] 
- Company: Acme 
- Position: Senior Developer 
- Wallet Address: 0xfc046e7cd36ffff3e59642387dca6dcd76c9b355
- Namespace: J349oiAO // API Key: 0x109435FR78

Run 'truebit --help' at any time to get started

If you'd like to view your personal information again, please run truebit setup.

3. Download the examples

Clone the examples repository to start working with Truebit

git clone https://github.com/TruebitProtocol/truebit-nextgen-examples.git

4. Working with your first Truebit Task

We have created example tasks so you can get familiar with the process of testing and deploying code. You can learn more about creating your own Function and API tasks.

For now we will use one of the examples (Fibonacci) to demonstrate how to use the CLI to test and deploy Function tasks, and the platform's REST API to execute and verify them.

Build

This command will build the Fibonacci task.

truebit build truebit-nextgen-examples/function-tasks/js/fibonacci/dist -l js

Testing

This command will run the Fibonacci task and provide the result and total steps executed.

truebit start <taskId> 15

• [taskId]: Add the taskId generated in the previous step.

Deploy and register your task

This command will deploy and register the Fibonacci task.

truebit deploy <namespace> <taskname> --taskId <taskId>

• [namespace]: Use your default namespace registered in Step 2 - User Creation

• [taskname]: Choose a representative name for your task. i.e: fibonacci

• [taskId]: Add the taskId generated in the previous step.

5. Executing your first Truebit task

Execute the Task

1. Access the Task execution Swagger UI here: Swagger UI for Truebit.

2. Open the /task/function/execute-by-name endpoint and click "Try it Out" to test it.

3. Update the following parameters in the request body:

   • namespace: Use the namespace from Step 4 – Deploy and register your task.

   • taskname: Use the task name from Step 4 – Deploy and register your task.

   • async: Set to false.

4. Add your API Key from Step 3 – Register into Truebit in the x-api-key parameter.

If you don’t remember your namespace or API key, please run truebit setup again to retrieve your personal information.

You should receive the following answer

{
  "executionId": "08c717bb-f92a-4f43-96a7-940e9ef37983",
  "clearTextSolution": {
    "signature": {
      "v": 27,
      "r": "997e437a3c2828d141ea7038e68391ffa3bbc4447c5e03e72e90b981d12cf30f",
      "s": "3b503da5ba6225137ec6f546de93bbbe8a7092091c557ea1a3bc9aad27b3ba75"
    },
    "output": "6765",
    "status": "succeed",
    "senderAddress": "0x344462d1a0a3a61945aa9dd4c072df8caed1af86"
  },
  "status": "Success"
}

Get the transcript

• Access the Transcript swagger UI here: Swagger UI for Truebit.

• Use the /task/{executionId}/transcript endpoint, passing the executionId value obtained from the previous execution as a parameter.

You should get the transcript associated with the given executionId

6. Explore Truebit in Action

By now, you’ve gone through the full journey: From installing and registering with Truebit to creating your first task locally, deploying it to the Truebit cloud, and obtaining a verifiable transcript. Now, it's time to see everything in action on a website.

To demonstrate this, we’ve built a demo page that executes a verifiable Fibonacci computation. How does it work? The page calls the Truebit execution endpoint and retrieves the corresponding verification transcript.

Next Steps

• Follow our step-by-step guide to start creating your own Truebit tasks.

• Visit the architecture page to learn more about Truebit's architecture.