Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.toju.network/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

We implement a pay-as-you-go model for decentralized storage using blockchain payments. Unlike traditional cloud storage with monthly subscriptions, users pay only for what they store and for how long. We currently support SOL (Solana) and USDFC (Filecoin).

​
How It Works

1

Select Files

Choose one or more files to upload to decentralized storage
2

Choose Duration

Specify how long you want to store the files (minimum 7 days)
3

Get Cost Estimate

The system calculates the cost based on:
  • Total file size
  • Storage duration
  • Current network rates
4

Sign Transaction

Approve the payment with your wallet (Phantom for SOL, MetaMask for USDFC)
5

Onchain Deposit

For SOL: a deposit is created on the Solana blockchain via our smart contract. For USDFC: a token transfer is sent on Filecoin.
6

Storage Provisioned

We pin your files to IPFS. The CID is linked to your payment and stored in our database.

​
Cost Calculation

Storage costs are calculated using this formula: 
Cost (SOL) = (File Size in MB × Duration in Days × Base Rate) + Transaction Fee
The base rate is dynamically calculated to cover IPFS storage costs while keeping prices competitive.
You can estimate costs before uploading using the estimateStorageCost SDK method.

​
Payment Flow

​
Payment Model

When you pay for storage:
  1. Files are pinned to IPFS before the deposit is created
  2. Payment is processed — SOL via our smart contract, or USDFC via direct token transfer
  3. Files are accessible for the full duration you paid for
Your payment covers the cost of storing your data on IPFS through our infrastructure. The smart contract (SOL) provides on-chain accounting and deposit verification, while USDFC payments are direct token transfers. This model ensures:
  • No recurring subscriptions or credit cards needed
  • Transparent, verifiable payments on-chain
  • Storage guaranteed for the full paid duration
  • Simple one-time payment per upload

​
Transaction Records

Every payment is recorded both:

Onchain

Permanent record on Solana blockchain with transaction signature

Database

Indexed in our database for quick lookup and history tracking

​
Supported Payment Chains

We currently support two payment methods:
  • SOL (Solana): Payments via our Solana smart contract with on-chain deposit verification
  • USDFC (Filecoin): Direct stablecoin transfers on Filecoin (1:1 with USD)
Coming soon:
  • Base (ETH): Ethereum L2 payments for lower gas fees
  • Additional chains: Based on community demand
All payment methods store data on the same IPFS network. You choose whichever chain you prefer — the storage experience is identical.

​
Benefits

For Users:
  • No credit card required
  • Pay only for what you use
  • Transparent, verifiable costs
  • No recurring subscriptions
For Developers:
  • Easy integration with crypto wallets
  • No payment processing fees
  • Instant settlement
  • Global accessibility

​
Limitations

No refunds: Once files are uploaded, storage is provisioned and payments cannot be refunded. Make sure you’ve selected the correct duration before confirming.
  • Minimum storage duration: 7 days
  • Gas fees apply for each transaction
  • Requires sufficient wallet balance
  • Files expire after storage duration ends