Start Building

Contents

shdwDrive SDK

• Installation

• Local Development

• Features

• Quick Start

• Usage Examples

• API Reference

shdwDrive CLI

• Features

• Installation

• Configuration

• Usage

• Development

shdwDrive SDK

shdwDrive SDK is a typeScript SDK for interacting with ShdwDrive, providing simple and efficient methods for file operations on the decentralized storage platform.

Installation

# Install from npm
npm install @shdwdrive/sdk

# Or install from repository
git clone https://github.com/GenesysGo/shdwdrive-v2-sdk.git
cd shdwdrive-v2-sdk
npm install
npm run build

Local Development

cd shdwdrive-v2-sdk
npm link
cd your-project
npm link @shdw-drive/sdk

Features

• 📤 File uploads (supports both small and large files)

• 📥 File deletion

• 📋 File listing

• 📊 Bucket usage statistics

• 🔐 Secure message signing

• ⚡ Progress tracking for uploads

• 🔄 Multipart upload support for large files

Quick Start

import ShdwDriveSDK from '@shdwdrive/sdk';
// Initialize with wallet
const drive = new ShdwDriveSDK({}, { wallet: yourWalletAdapter });
// Or initialize with keypair
const drive = new ShdwDriveSDK({}, { keypair: yourKeypair });

Usage Examples

Upload a File

const file = new File(['Hello World'], 'hello.txt', { type: 'text/plain' });
const uploadResponse = await drive.uploadFile('your-bucket', file, {
onProgress: (progress) => {
console.log(Upload progress: ${progress.progress}%);
}
});
console.log('File uploaded:', uploadResponse.finalized_location)

List Files

const files = await drive.listFiles('your-bucket');
console.log('Files in bucket:', files);

Delete a File

const deleteResponse = await drive.deleteFile('your-bucket', 'file-url');
console.log('Delete status:', deleteResponse.success);

Get Bucket Usage

const usage = await drive.getBucketUsage('your-bucket');
console.log('Storage used:', usage.storage_used)

API Reference

ShdwDriveSDK

Constructor Options

interface ShdwDriveConfig {
endpoint?: string; // Optional custom endpoint
}
// Initialize with either wallet or keypair
new ShdwDriveSDK(config, { wallet: WalletAdapter });
new ShdwDriveSDK(config, { keypair: Keypair });

Methods

• uploadFile(bucket: string, file: File, options?: FileUploadOptions)

• deleteFile(bucket: string, fileUrl: string)

• listFiles(bucket: string)

• getBucketUsage(bucket: string)

shdwDrive CLI

A command-line interface for interacting with shdwDrive storage.

Features

• 📤 File uploads (supports both small and large files)

• 📥 File deletion

• 📋 File listing

• 📊 Bucket usage statistics

• 🔐 Secure message signing

• 🔄 Multipart upload support for large files

Installation

You can install the CLI globally using npm:

npm install -g @shdwdrive/cli

Or use it directly from the repository:

git clone https://github.com/genesysgo/shdwdrive-v2-cli.git
cd shdwdrive-v2-cli
npm install
npm run build
npm link

Configuration

The CLI uses environment variables for configuration:

• SHDW_ENDPOINT: The shdwDrive API endpoint (defaults to https://v2.shdwdrive.com)

Usage

Upload a file

shdw-drive upload \
  --keypair ~/.config/solana/id.json \
  --bucket your-bucket-identifier \
  --file path/to/your/file.txt \
  --directory optional/directory/path

Delete a file

shdw-drive delete \
  --keypair ~/.config/solana/id.json \
  --bucket your-bucket-identifier \
  --file file-url-or-path

List files in a bucket

shdw-drive list \
  --keypair ~/.config/solana/id.json \
  --bucket your-bucket-identifier

Check bucket storage usage

shdw-drive usage \
  --keypair ~/.config/solana/id.json \
  --bucket your-bucket-identifier

Development

1. Clone the repository:

git clone https://github.com/genesysgo/shdwdrive-v2-cli.git

1. Install dependencies:

cd shdwdrive-v2-cli
npm install

1. Build the project:

npm run build

1. Link the CLI locally:

npm link