Storage

The prova.storage service handles every operation that involves bytes.

const prova = Prova.create({ account, chain: base })

Upload

const result = await prova.storage.upload(bytes, {
  redundancy: 4,
  termDays: 30,
  callbacks: {
    onProviderSelected: (p) => console.log('chose', p.address),
    onProgress: (loaded, total) => console.log(`${loaded}/${total}`),
    onStored: (cid) => console.log('stored', cid),
  },
})

// result: { cid, dealId, size, retrievalUrl, pieces }

Options:

Option	Type	Default	Description
redundancy	number	2	How many independent provers to pin to.
termDays	number	30	How long the deal stays Active.
regions	string[]	auto	Constrain to specific regions (`'EU'
providerIds	bigint[]	auto	Pin to specific providers by id.
pieceCid	string	computed	Skip CommP computation, trust this cid.
signal	AbortSignal	none	Cancel mid-upload.
callbacks	object	none	Lifecycle callbacks.

Download

const bytes = await prova.storage.download({ pieceCid: 'bafy…q4kr' })

Returns a Uint8Array. The SDK retries against multiple replicas if the first prover fails.

// Download via a specific provider
const bytes = await prova.storage.download({
  pieceCid: 'bafy…',
  providerId: 7n,
})

// Stream instead of buffering
const stream = await prova.storage.downloadStream({ pieceCid: 'bafy…' })
for await (const chunk of stream) {
  // ...
}

List

const files = await prova.storage.list({ owner: '0xYourAddress' })
// → [{ cid, size, dealIds, providerIds, term, ... }, ...]

Pin / unpin

Add or remove a replica from an existing piece:

// Add another replica
await prova.storage.pin({ pieceCid: 'bafy…', additionalReplicas: 2 })

// Drop a specific provider's replica
await prova.storage.unpin({ pieceCid: 'bafy…', providerId: 5n })

Compute a piece-cid without uploading

import { computePieceCid } from '@prova-network/sdk'
const cid = await computePieceCid(bytes)

Useful for pre-flighting deal proposals or de-duplication checks.

Costs

const quote = await prova.storage.getUploadCosts({
  bytes,
  redundancy: 4,
  termDays: 365,
})
// → { totalUSDC, perReplicaUSDC, gasUSDC, breakdown }

Always quote before uploading, especially for large files or long terms.

See also

• POST /api/upload — same operation via HTTP
• Architecture — what these operations map to on-chain