Beam Web SDK

The Beam Web SDK is a Typescript library that allows you to easily integrate Beam into your website, application or web-based game. It provides a simple API to authenticate your users on Beam, manage sessions and sign transactions, and access the Beam Player API.

Table of Contents

• Getting Started
  • Installation
  • Examples
• Documentation

Getting Started

Before you start, make sure you obtain an API key by requesting it through build@onbeam. More information can be found on the Beam API Docs.

Installation

To get started with the SDK, install it in your project using your favorite package manager:

# with npm
npm install -S @onbeam/sdk

# or with yarn
yarn add @onbeam/sdk

# or with pnpm
pnpm add @onbeam/sdk

Creating a client

Start by creating a new instance of the Beam client, and configuring it with your API key:

import { BeamConfiguration } from '@onbeam/sdk';

const config = new BeamConfiguration({
  environment: 'mainnet',
  publishableKey: 'your-publishable-key',
  debug: true, // Logs debug information to the console
});

const client = new BeamClient(config);

Make sure your API key matches the environment you are working on. For example, if you are working on a development environment, use the development API key.

Authenticating a user

If you're using wagmi, you can authenticate a user by providing the wagmi config with our Beam Connector:

import { createConfig, http } from 'wagmi'
import { beam } from 'viem/chains';
import { beam as beamConnector } from '@onbeam/wagmi';
import { BeamConfiguration } from '@onbeam/sdk';

const beamConfig = new BeamConfiguration({ ... }) // your config from the previous step

const config = createConfig({
  chains: [beam]
  connectors: [
    beamConnector({ 
      config: beamConfig
    })
  ],
  transports: {
    [beam.id]: http(),
  },
});

Our connector supports wagmi 2.x and above, and is shipped as a separate package.

Examples

The repository includes two example apps that demonstrate how to use the Beam Web SDK:

SDK Example

The SDK example app demonstrates how to create and manage sessions for your players and is mainly suited for game developers that wish to integrate Beam into their games.

Wagmi Example

The Wagmi example app demonstrates how a 'Connect with Beam' wallet integration can be implemented in a web application. It is mainly suited for NFT marketplaces or web applications that require users to authenticate with a wallet and interact with the Beam chain.

Documentation

For more information and API references, check out our online documentation.