TypeScript SDK

​

Package layout

​

Install

​

Environment

• ESM-only. The package declares "type": "module" and its exports map only offers import entrypoints — there is no CommonJS build. From CJS code, use dynamic import().
• Node ≥ 20. The HTTP transport uses the global fetch.
• Evergreen browsers. The SDK runs in the browser as well as Node; the root entrypoint is browser-safe.
• BigInt throughout. Amounts and block numbers are bigint, so compilation targets must be ES2020 or later.

​

Configure a client

import {GenClient} from "@gen/client-sdk";

const client = GenClient.newHttp("https://devnet.genlabs.co/rpc/", {
  headers: {Authorization: "Bearer <your-jwt>"},
});

​

First call

const version = await client.rpc().getVersion({});
console.log(`validator ${version.release_version}, rpc protocol ${version.rpc_protocol_version}`);

​

Send a transfer

import {GenClient, GenSigner} from "@gen/client-sdk";

const client = GenClient.newHttp("http://127.0.0.1:30001");

// A fresh account for this walkthrough.
const recipient = GenSigner.generate();
const account = recipient.account();

// Create the account on-chain, then transfer 1 token to it from the faucet.
await client.wait(await client.createAccount(account));
const outcome = await client.wait(
  await client.faucet(account, 1_000_000_000_000_000_000n),
);
console.log("status:", outcome.terminalInfo.status); // "success"

const balance = await client.rpc().getBalance({account});
console.log("balance:", balance); // "1000000000000000000"

• Amounts are bigint subunits, the token’s smallest unit. The genesis token uses 18 decimals, so the literal above is one token.
• createAccount(...) and faucet(...) return as soon as the activation is accepted. wait(...) polls the activation and all its continuations to a terminal state and resolves the result into a TraceOutcome.
• Calling your own contract is the same shape without the convenience wrapper: build an ActivationPayload targeting your component and pass it to client.signAndSubmitActivationAndWait(signer, payload) with your own signer — see GenClient in the API reference.

​

Loading keys

​

Errors

​

Next steps

• JSON-RPC reference: every wire-level method the SDK speaks.
• Rust SDK: the canonical client; the TypeScript SDK mirrors its structure.
• Send your first transfer (CLI): the same flow at the command line, useful for sanity-checking your setup.