Build on Carbide.

A developer hub for the decentralized storage network. Every component, what it does, where it is in its lifecycle, and how to get going.

Pick your path.

Three common entry points. Each one drops you straight into the right repo and section.

Ecosystem status.

Snapshot of every Carbide component. Stage labels reflect what is actually deployed today.

v1.0.0Live

carbide-node

chaalpritam/carbide-node

Rust storage provider with HTTP API, SQLite metadata, proof-of-storage, Prometheus metrics, and a Tauri desktop GUI. Auto-registers on Solana when configured.

Open repo
Devnet

carbide-contracts

chaalpritam/carbide-contracts

Anchor 0.31.1 programs: carbide_registry (provider PDA + events) and carbide_escrow (USDC SPL deals with verifier co-sign and admin-resolved disputes).

Open repo
Live

carbide-discovery-service

chaalpritam/carbide-discovery-service

Fastify + TypeScript microservice. Provider registry, marketplace search, fan-out quotes, health checks, and a Solana-aware on-chain registry mirror.

Open repo
v1.1.0Live

carbide-ios-sdk

chaalpritam/carbide-ios-sdk

Swift SPM package for iOS 16+ / macOS 13+. Async/await, AES-256-GCM client-side encryption, Keychain key storage, exponential-backoff retry, zero deps beyond URLSession + CryptoKit.

Open repo
Beta

Carbide (iOS)

chaalpritam/Carbide

SwiftUI + SwiftData app for iOS 18.1+. Folder management, photo upload, smart categorisation, real-time storage dashboard. TestFlight today, App Store submission pending.

Open repo
Beta

CarbideDrive (macOS)

chaalpritam/CarbideDrive

Native macOS sync client (macOS 14+). FSEvents-driven file change detection, grid/list browser, settings panel for region/tier/price preferences. Notarized DMG distribution.

Open repo
Live

homebrew-carbide

chaalpritam/homebrew-carbide

Homebrew tap that builds carbide-node from source, writes a default provider.toml, and registers a launchd service. --HEAD install today; tagged release path documented.

Open repo
Live

carbide-dev-docs

chaalpritam/carbide-dev-docs

Markdown reference for architecture, provider setup, discovery API, SDK usage, and client apps. Hosts the static dev-portal site.

Open repo
Architecture

Three layers, one network.

Client layer

iOS app, CarbideDrive on macOS, and any third-party app built on the Swift SDK. End-to-end encryption happens here, before bytes leave the device.

Coordination layer

Discovery service indexes the on-chain registry and exposes /api/v1 — provider search, quotes, heartbeats. Stateless and horizontally scalable.

Settlement layer

Solana programs hold the source of truth for providers and deals. carbide_registry for identity, carbide_escrow for USDC payments and verifier-gated releases.

On-chain programs.

Anchor 0.31.1 on Solana. Devnet program IDs below; the mainnet-beta deploy path is documented in carbide-contracts.

carbide_registry

Devnet

One ProviderAccount PDA per provider, seeded by the signing pubkey. Permissionless self-registration; emits events for the discovery mirror.

Program ID
5rAsbS4ApXNyNqrSUXqC7ju24kpEudHxfU1Q5khmAZHD
Instructions
registerupdateset_activederegister

carbide_escrow

Devnet

USDC SPL token escrow per deal. Periodic releases require provider + authorised verifier co-sign; disputes freeze the deal until the admin splits the balance.

Program ID
FQLdMfgTtio51EiWmNC444BmVfAtG9DAdWp8dLeCycgZ
Instructions
initialize_configtransfer_adminadd_verifierremove_verifiercreate_escrowrelease_paymentcancel_escrowraise_disputeresolve_dispute

Wallet keypairs follow Solana's standard derivation path m/44'/501'/0'/0'. Deals settle in USDC; the devnet mock mint is 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU.

Discovery API.

Fastify service, base path /api/v1. CORS is on by default for browser clients.

Method
Path
POST
/providers
Provider self-registration
GET
/providers
List with region / tier / minReputation filters
GET
/providers/:id
Fetch a single provider record
POST
/providers/:id/heartbeat
Provider keepalive (every 30s)
DELETE
/providers/:id
Unregister
GET
/marketplace/search
Sort + filter the marketplace
POST
/marketplace/quotes
Fan-out quote request to N providers
GET
/marketplace/stats
Total providers, capacity, average price
GET
/health
Service liveness

Public default endpoint: https://discovery.carbidenetwork.xyz. Override the SDK's discoveryServiceURL to point at a self-hosted instance.

CLI binaries.

Three executables ship with the Homebrew install. All three also build from the Cargo workspace.

carbide-provider

Run a storage provider node — HTTP API, proof-of-storage, registry heartbeat.

$carbide-provider start --port 8080 --capacity-gb 25
carbide-discovery

Run a self-hosted discovery service for local development or private networks.

$carbide-discovery start --port 9090 --host 0.0.0.0
carbide-client

Direct upload/download against a known provider, plus quote/pay for full marketplace flow.

$carbide-client upload --provider http://127.0.0.1:8080 --file ~/file.pdf
Install on macOS
brew tap chaalpritam/carbide https://github.com/chaalpritam/homebrew-carbide
brew install --HEAD chaalpritam/carbide/carbide-node
brew services start carbide-node

Going deeper.

The reference docs live alongside each component. Pick the area you're working on.

Need a hand?

Telegram is the fastest way to reach a contributor. GitHub issues are great for tracked work.