Getting Started with Turbo

Upload data using Turbo, an ar.io gateway run by the ArDrive team. Turbo handles the infrastructure so you can focus on shipping.

What is Turbo?

Turbo is an ar.io gateway run by the ArDrive team. It serves permanent data like any ar.io gateway, and it adds paid uploads: it bundles your files into ANS-104 data items, issues the credits you pay with, and posts the data permanently to Arweave.

How the pieces fit. ar.io is the network: gateways serve and index permanent data, ArNS names it, and anyone can run a gateway. Turbo is one of those gateways, at turbo-gateway.com, run by the ArDrive team with uploads and payments attached. ArDrive is the app built on it. Arweave is the storage layer underneath, where the data ends up.

So the part that makes Turbo different from a gateway you run yourself is not reading, which it does the same way: it is that Turbo accepts paid uploads, and carries the funding, performance tuning and operational complexity that come with them.

Turbo supports flexible payment options, including fiat and major cryptocurrencies, and is built to handle high-throughput workloads with consistent performance. Whether you’re prototyping or running production systems, Turbo provides a reliable upload layer backed by enterprise-grade infrastructure.

If you’re looking for a managed upload service tailored to your use case — including custom limits, performance, or integration support — book a call to learn how we can get one set up for you: Contact Us!

Get Started

npm install @ardrive/turbo-sdk

# Create a new wallet (easy way)
npx permaweb/wallet > key.json

import { TurboFactory, ArweaveSigner } from "@ardrive/turbo-sdk";
import fs from "fs";

// Load your wallet
const jwk = JSON.parse(fs.readFileSync("./key.json", "utf-8"));
const signer = new ArweaveSigner(jwk);

// Initialize Turbo
const turbo = TurboFactory.authenticated({ signer });

// Purchase credits programmatically
const fundResult = await turbo.topUpWithTokens({
  tokenAmount: TOKEN_AMOUNT,
  tokenType: "solana", // or 'ethereum', 'matic', 'arweave'
});

const balance = await turbo.getBalance();
console.log(`Balance: ${balance.winc} winc`);

const fileData = fs.readFileSync("./myfile.jpg");

const result = await turbo.upload({
  data: fileData,
  dataItemOpts: {
    tags: [
      { name: "Content-Type", value: "image/jpeg" },
      { name: "Title", value: "My Image" },
    ],
  },
});

console.log("Upload ID:", result.id);
console.log("Owner:", result.owner);

Advanced Features

Turbo Credits System

Learn about our flexible payment system that supports multiple currencies and payment methods.

→ Understanding Turbo Credits

Data Organization

• Tagging - Organize your data with metadata
• Manifests - Create folder structures and bundles
• Encryption - Secure your sensitive data
• ArFS - File system protocol for structured storage

Production Ready

Turbo implements the ANS-104 bundling specification, providing enterprise-grade infrastructure for permanent data storage.

Ready to Get Started?