Getting Started with Turbo

Upload data to Arweave using Turbo, a managed gateway service designed for reliability, scale, and ease of use. Turbo handles the infrastructure so you can focus on shipping.

What is Turbo?

Turbo is a managed ar.io gateway service that simplifies uploading data to Arweave. It abstracts away funding, performance tuning, and operational complexity, giving teams a fast, dependable path to permanent storage.

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 gateway 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} Winston Credits`);

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?