Getting Started with Carbium

You are now set up with your dedicated Carbium RPC access. Follow the steps below to integrate your new keys and start building immediately.

1. You got now your RPC key.

Your access is active and ready for high-performance requests.

2. Here are your endpoints

Use these URLs to configure your client. Append your unique apiKey to the end of each URL.

Protocol	URL Pattern
HTTP RPC	`https://rpc-service.carbium.io/?apiKey=<YOUR_KEY>`
WebSocket	`wss://wss-rpc.carbium.io/?apiKey=<YOUR_KEY>`
gRPC (Geyser)	`wss://grpc.carbium.io/?apiKey=<YOUR_KEY>`

3. Keys are temporary and named for you

Please note that these keys are provisioned specifically for this testing phase.

4. Small use examples

A. Standard RPC (HTTP/WSS) Works with standard libraries like @solana/web3.js.

import { Connection } from "@solana/web3.js";

// Replace <YOUR_KEY> with your actual key
const RPC_URL = "https://rpc-service.carbium.io/?apiKey=<YOUR_KEY>";
const WSS_URL = "wss://wss-rpc.carbium.io/?apiKey=<YOUR_KEY>";

const connection = new Connection(RPC_URL, {
  wsEndpoint: WSS_URL,
  commitment: "confirmed",
});

const blockHeight = await connection.getBlockHeight();
console.log(`Connected to Carbium! Current Block Height: ${blockHeight}`);

B. Geyser gRPC Streaming For ultra-low latency streaming, use the standard Yellowstone gRPC client.

Installation: npm install @rpcpool/yellowstone-grpc

Usage:

import { Client } from "@rpcpool/yellowstone-grpc";

// Note: Do not include 'https://' or 'wss://' for the endpoint host in some clients, 
// but if using the standard client, the full URL with auth is supported or split as below:
const ENDPOINT = "https://grpc.carbium.io"; 
const API_KEY = "<YOUR_KEY>";

const client = new Client(ENDPOINT, API_KEY, {});

// Subscribe to slot updates
const stream = await client.subscribe();
stream.on("data", (data) => {
  console.log("New update received:", data);
});

await client.subscribeUpdate({
  slots: { "slots": {} }, // Subscribe to all slots
});