turbo-sdk

Complete Arweave Turbo ecosystem skill covering client SDKs, core upload infrastructure, backend payment services, and CLI tooling for permanent decentralized storage.

Description

This skill provides end-to-end coverage of the Turbo Upload Service ecosystem for permanent decentralized storage on Arweave:

turbo-sdk (Client SDK)

The first SDK on Arweave to bring you programmable fiat top ups, Turbo-powered upload reliability, and fast data and indexing finality for TypeScript based Web and Node projects.

Repository: ardriveapp/turbo-sdk Language: TypeScript (97.8%) Stars: 51 License: Apache License 2.0 Status: Production-ready with 144 releases Purpose: Client-side upload and payment integration

turbo-upload-service (Core Infrastructure)

Production-grade data bundling service that packages ANS-104 "data items" and delivers them to Arweave. Two-component architecture (Upload Service + Fulfillment Service) designed for AWS at-scale deployment with Docker support.

Repository: ardriveapp/turbo-upload-service Language: TypeScript (97.9%) Stars: 11 License: AGPL-3.0 (strong copyleft) Status: Production infrastructure with PostgreSQL, S3, SQS Purpose: Core upload orchestration and Arweave delivery

turbo-payment-service (Backend Service)

Production-grade backend payment processing system managing Turbo balances, cryptocurrency transactions, and Stripe integration for the ArDrive platform.

Repository: ardriveapp/turbo-payment-service Language: TypeScript (99.8%) Stars: 8 License: AGPL-3.0 (strong copyleft) Status: Production backend with PostgreSQL, Docker, Koa framework Purpose: Payment infrastructure and balance management

x402-turbo-upload (CLI Tool)

A minimal TypeScript command-line tool demonstrating x402 protocol integration with Turbo Upload Service using EVM wallet authentication.

Repository: ardriveapp/x402-turbo-upload Language: TypeScript (100%) Stars: 0 (new - created Nov 2025) Status: Development/Educational tool Purpose: CLI automation and protocol learning

When to Use This Skill

For Frontend/Client Development (turbo-sdk)

• Implementing permanent file uploads to Arweave
• Building applications with programmable fiat top-ups
• Integrating Turbo Upload Service into TypeScript/JavaScript projects
• Requiring production-grade upload reliability and error handling
• Needing comprehensive API documentation and examples
• Checking known issues or recent changes
• Reviewing extensive release history (144 releases)

For Core Infrastructure Development (turbo-upload-service)

• Building or hosting your own Turbo upload infrastructure
• Understanding ANS-104 data item bundling for Arweave
• Operating upload services at AWS scale
• Implementing multi-signature upload support (Arweave, Ethereum, Solana)
• Managing asynchronous fulfillment workflows
• Docker and LocalStack development environments
• Database migration workflows with Knex
• S3 object storage and SQS queue integration
• Understanding AGPL-3.0 implications for infrastructure hosting

For Payment Infrastructure Development (turbo-payment-service)

• Building payment processing infrastructure
• Managing Turbo balances and cryptocurrency transactions
• Integrating Stripe for fiat payments
• Setting up multi-blockchain payment support (Ethereum, Solana, Arweave)
• Implementing balance management systems
• Creating payment service backends with PostgreSQL
• Docker deployment and database migration workflows
• Understanding AGPL-3.0 license implications for backend services

For Learning & Simple Automation (x402-turbo-upload)

• Learning x402 protocol basics and implementation
• Creating simple CLI automation scripts
• Testing custom Turbo Upload endpoints
• Understanding EVM wallet authentication with uploads
• Quick one-off upload testing
• Minimal reference implementation study

General Use Cases

• Understanding complete Turbo ecosystem (client + infrastructure + payment + CLI)
• Comparing frontend SDK vs backend service vs core infrastructure architectures
• Evaluating production vs development tooling
• Integrating permanent storage with payment processing
• Planning full-stack Arweave applications
• White-labeling Turbo infrastructure for custom platforms

Quick Reference

turbo-sdk (Client SDK)

• Homepage: https://ardrive.io/turbo/
• Topics: ardrive, arweave, commonjs, esm, nodejs, turbo
• Open Issues: 1
• Last Updated: 2025-12-26
• Latest Release: v1.39.2 (2025-12-15)
• Use For: Frontend uploads, client integration

turbo-upload-service (Core Infrastructure)

• Technology Stack: Koa, PostgreSQL, S3, SQS, Docker, LocalStack
• Architecture: Two-component (Upload Service + Fulfillment Service)
• Stars: 11
• Multi-Signature Support: Arweave, Ethereum, Solana
• Deployment: AWS-optimized with Docker support
• License Warning: AGPL-3.0 requires source disclosure for network use
• Use For: Core upload infrastructure, platform hosting

turbo-payment-service (Payment Backend)

• Technology Stack: Node.js, Koa, PostgreSQL, Stripe
• Contributors: 4 active developers
• Total Commits: 24
• Blockchain Support: Ethereum, Solana, Arweave
• License Warning: AGPL-3.0 requires source disclosure for network use
• Use For: Payment infrastructure, balance management

x402-turbo-upload (CLI Tool)

• Repository: GitHub - ardriveapp/x402-turbo-upload
• Purpose: Minimal demonstration/educational tool
• Created: November 17, 2025
• Total Commits: 4
• Use For: Learning, simple automation

Languages

• TypeScript: 97.8%
• JavaScript: 1.6%
• Shell: 0.4%
• HTML: 0.2%

Recent Releases

• v1.39.2 (2025-12-15): v1.39.2
• v1.39.1 (2025-12-11): v1.39.1
• v1.39.1-alpha.1 (2025-12-10): v1.39.1-alpha.1

Available References

turbo-sdk (Client SDK) References

• references/README.md - Complete README documentation (51 KB)
• references/CHANGELOG.md - Version history and changes (33 KB)
• references/issues.md - Recent GitHub issues (678 bytes)
• references/releases.md - Release notes (112 KB, 144 releases)
• references/file_structure.md - Repository structure (196 items)

turbo-upload-service (Core Infrastructure) Reference

• references/turbo-upload-service.md - Complete infrastructure documentation including two-component architecture (Upload + Fulfillment), AWS deployment, Docker setup, LocalStack configuration, database migrations, testing strategies, multi-signature support, API endpoints, and AGPL-3.0 license considerations

turbo-payment-service (Payment Backend) Reference

• references/turbo-payment-service.md - Complete backend documentation including architecture, API design, database schema, deployment, testing, Stripe integration, cryptocurrency payment flows, Docker setup, and AGPL-3.0 license considerations

x402-turbo-upload (CLI Tool) Reference

• references/x402-turbo-upload.md - CLI tool documentation with usage examples, security considerations, and comparison with turbo-sdk

Ecosystem Component Selection Guide

Usage

turbo-sdk (Client SDK)

See references/README.md for complete API documentation, installation instructions, and comprehensive usage examples for client-side upload integration.

turbo-upload-service (Core Infrastructure)

See references/turbo-upload-service.md for:

• Two-component architecture (Upload Service + Fulfillment Service)
• AWS production deployment at scale
• Docker and LocalStack local development
• Database migrations with Knex
• Multi-signature upload support (Arweave, Ethereum, Solana)
• S3 and SQS integration
• Testing strategies (unit + integration)
• API endpoint documentation
• IMPORTANT: AGPL-3.0 license compliance requirements for hosting

turbo-payment-service (Payment Backend)

See references/turbo-payment-service.md for:

• Backend architecture and technology stack
• Local development setup with Docker
• Database migration workflows
• Payment integration (Stripe + cryptocurrency)
• API design patterns
• Testing strategies
• Production deployment
• IMPORTANT: AGPL-3.0 license compliance requirements

x402-turbo-upload (CLI Tool)

See references/x402-turbo-upload.md for CLI usage, parameters, examples, and important production considerations.

Skill Version: 1.3.0 Last Enhanced: January 3, 2026 Coverage: Complete Turbo ecosystem (client SDK + upload infrastructure + payment backend + CLI tool) Components: 4 repositories, 8 reference files Generated by Skill Seeker | Enhanced with complete infrastructure coverage