Golem JS Quickstart

In this article, we'll show you how to run a simple task on the Golem Network.

As a Quickstart, we will perform a simple task: running a basic shell command on a rented provider.

It should take just a few minutes to complete, and you will see the command output printed in your terminal.

Yagna is a service that communicates and performs operations on the Golem Network. Let's get started by installing it.

curl -sSf https://join.golem.network/as-requestor | bash -

Open a terminal (command line window) and define the app-key that will allow our script to use the Yagna API:

export YAGNA_AUTOCONF_APPKEY=try_golem

Then start the yagna service:

yagna service run

Requesting tasks on the Golem Network requires GLM tokens. As this example will run on a test network, you can use test GLM.

Open another terminal and run the following command to complete the configuration:

yagna payment fund

It will top up your account with test GLM tokens. These tokens can only be used on the testnet.

Create a new Node.js project and install the Golem SDK by entering the following commands in your terminal:

mkdir try_golem
cd try_golem
npm init
npm install @golem-sdk/golem-js

Create a file named requestor.mjs and copy the following content into it. The code defines a task that runs the command node -v on the Golem Network and prints the result to your terminal.

import { TaskExecutor } from "@golem-sdk/golem-js";
(async () => {
  const executor = await TaskExecutor.create({
    package: "529f7fdaf1cf46ce3126eb6bbcd3b213c314fe8fe884914f5d1106d4",
    yagnaOptions: { apiKey: "try_golem" },
  });
  const result = await executor.run(async (ctx) => (await ctx.run("node -v")).stdout);
  await executor.end();

  console.log("Task result:", result);
})();

Run the command:

node requestor.mjs

The output of the script should look very similar to the one below:

You can find information regarding the node.js version used on the remote computer - v.16.14.0 - at the end of the script's logs. This version is incorporated into the current standard Golem image used to execute the task.

You've installed the Yagna service and executed a simple task on the Golem Network. However, you can accomplish much more. Here are some suggested next steps to explore the Golem Network world: