shelby-solana-kit - SKILL.md Agent Skill

name: shelby-solana-kit description: Solana wallet integration for Shelby decentralized storage via Derived Account Abstraction (DAA). Use when working with @shelby-protocol/solana-kit.

Shelby Solana Kit

The Solana Kit enables Solana wallets to use Shelby decentralized storage through Derived Account Abstraction (DAA). A Solana public key combined with a dApp domain deterministically derives a Shelby storage account on Aptos, authenticated via Sign-In with Solana (SIWS).

Package Version

Use the correct version (as of 2026):

"@shelby-protocol/solana-kit": "^0.2.0"

Installation

# Core solana-kit package
pnpm install @shelby-protocol/solana-kit

# For Node.js usage
pnpm install @solana/web3.js

# For React usage (with wallet-adapter)
pnpm install @solana/wallet-adapter-react @solana/wallet-adapter-base

# You also need the core SDK and React hooks for full integration
pnpm install @shelby-protocol/sdk @shelby-protocol/react @tanstack/react-query

Quick Start - Node.js

import { Shelby, Network } from "@shelby-protocol/solana-kit/node";
import { Connection, Keypair } from "@solana/web3.js";

const shelby = new Shelby({
  network: Network.SHELBYNET,
  connection: new Connection("https://api.devnet.solana.com"),
  apiKey: "AG-***",
});
const keypair = Keypair.generate();
const storageAccount = shelby.createStorageAccount(keypair, "my-dapp.com");

await shelby.upload({
  blobData: new TextEncoder().encode("Hello from Solana!"),
  signer: storageAccount,
  blobName: "hello.txt",
  expirationMicros: Date.now() * 1000 + 86400_000_000,
});

Quick Start - React

import { useStorageAccount, Network } from "@shelby-protocol/solana-kit/react";
import { ShelbyClientProvider, useUploadBlobs } from "@shelby-protocol/react";
import { ShelbyClient } from "@shelby-protocol/sdk/browser";
import { useWallet } from "@solana/wallet-adapter-react";
import { useMemo } from "react";

function StorageComponent() {
  const { publicKey, signMessage, signIn } = useWallet();
  const shelbyClient = useMemo(() => new ShelbyClient({
    network: Network.SHELBYNET,
    apiKey: "AG-***",
  }), []);

  const adaptedWallet = publicKey ? {
    account: { address: publicKey },
    signMessage,
    signIn,
  } : null;

  const { storageAccountAddress, signAndSubmitTransaction } = useStorageAccount({
    client: shelbyClient,
    wallet: adaptedWallet,
  });

  // useUploadBlobs works with the WalletAdapterSigner from useStorageAccount
  const { mutateAsync: uploadBlobs } = useUploadBlobs({ client: shelbyClient });

  const handleUpload = async (file: File) => {
    const data = new Uint8Array(await file.arrayBuffer());
    await uploadBlobs({
      signer: { account: storageAccountAddress, signAndSubmitTransaction },
      blobs: [{ blobData: data, blobName: file.name }],
      expirationMicros: Date.now() * 1000 + 86400_000_000,
    });
  };
}

Core Concepts

The Solana Kit adds two main APIs:

createStorageAccount(keypair, domain) — Derives a Shelby storage account from a Solana keypair and dApp domain (Node.js)
useStorageAccount({ client, wallet }) — React hook that returns storageAccountAddress and signAndSubmitTransaction for use as a WalletAdapterSigner with the core React hooks

For core Shelby concepts (expiration, blob naming, networks, error handling, configuration), see the shelby-sdk skill.

Reference Files

references/solana-kit.md - Complete Solana integration guide with advanced usage