Introduction

To interact with Shelby's decentralized storage, you'll need API keys from Geomi. Geomi provides the infrastructure for managing projects and generating API credentials for Shelby networks.

Step 1: Sign In to Geomi

Navigate to geomi.dev and sign in using your Google account or email address.

Step 2: Create a Project

After signing in, you'll land on the dashboard. Click Create New Project to set up your first project. Give it a descriptive name, this helps organize your API keys and resources.

Once created, click on your project card to open it.

Step 3: Create an API Key

Inside your project, you'll see several resource options. Click on API Key to create a new key.

Fill in the form:

1. API Key Name: A descriptive name (e.g., my-app-production)
2. Network: Select Shelbynet for Shelby Protocol access
3. Description: Optional notes about the key's purpose

Click Create New API Key to generate your credentials.

Step 4: Copy Your API Key

You'll be taken to the API Keys screen showing your new key. Click on the Key Secret field to copy your API key.

Environment Setup

Store your API key in your environment variables:

SHELBY_API_KEY=your_api_key_here

Make sure to add .env to your .gitignore to avoid committing secrets.

Using the Key

Pass your API key when initializing the SDK:

import { Shelby } from "@shelby-protocol/sdk";

const shelby = new Shelby({
  apiKey: process.env.SHELBY_API_KEY,
});

Next Steps