shelby_skill

Overview

This skill is a Shelby Protocol expert for decentralized blob storage on the Aptos blockchain. It explains erasure coding with Clay Codes, the TypeScript SDK and clients, smart contract interactions, CLI workflows, storage provider topology, and dApp integration patterns. The focus is on building high-performance storage solutions for video streaming, AI training, and large datasets.

How this skill works

The skill inspects the Shelby architecture: RPC servers that handle blob operations, a private fiber network connecting provider servers, and Aptos smart contracts for state, audits, and settlements. It explains how data is split into chunksets, encoded using Clay Codes into 16 chunks (10 data + 6 parity), and distributed across storage providers so any 10 of 16 chunks can reconstruct the blob. The skill covers SDK usage patterns, multipart uploads, session reuse, and token funding for APT and ShelbyUSD.

When to use it

• Building dApps that require decentralized, durable large-object storage
• Integrating the Shelby TypeScript SDK in Node.js or browser apps
• Uploading or streaming large media and training datasets (10MB+)
• Implementing multipart uploads and efficient byte-range reads
• Running storage provider nodes or troubleshooting RPC interactions

Best practices

• Prefer multipart uploads for files larger than 10MB to match chunkset boundaries
• Reuse sessions for multiple reads to reduce micropayment overhead and latency
• Use byte-range requests for streaming and partial reads to save bandwidth
• Design blobs immutable; use overwrite semantics rather than in-place edits
• Monitor provider health and verify recovery by testing with minimum-chunk reconstruction

Example use cases

• Live video streaming service that reads large segments via byte-range requests
• Training pipeline that stores terabytes of model data and retrieves shards efficiently
• Content delivery network using Shelby for static assets with high-read throughput
• Archival system storing immutable datasets with long expiration timestamps
• dApp that charges users in ShelbyUSD for bandwidth and storage with micropayment sessions