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
| Need |
Component |
Reason |
| Client-side uploads |
turbo-sdk |
Production SDK, comprehensive, 144 releases |
| Host upload infrastructure |
turbo-upload-service |
Core bundling service, AWS-scale, Docker support |
| ANS-104 data bundling |
turbo-upload-service |
Arweave delivery orchestration |
| Multi-signature uploads |
turbo-upload-service |
Arweave, Ethereum, Solana support |
| Backend payment processing |
turbo-payment-service |
Multi-blockchain, Stripe, PostgreSQL |
| Balance management |
turbo-payment-service |
Transaction tracking, database-backed |
| Fiat payments |
turbo-payment-service |
Stripe integration built-in |
| Cryptocurrency payments |
turbo-payment-service |
Ethereum, Solana, Arweave support |
| Simple CLI automation |
x402-turbo-upload |
Minimal, straightforward |
| Learning x402 protocol |
x402-turbo-upload |
Clear, minimal example |
| Full-stack application |
All four |
Complete ecosystem coverage |
| White-label platform |
upload-service + payment-service |
Core infrastructure components |
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
1---2name: turbo-sdk3description: Complete Arweave Turbo ecosystem including client SDKs, core upload infrastructure, payment service backend, and CLI tools for permanent decentralized storage4---5
6# turbo-sdk
7
8Complete Arweave Turbo ecosystem skill covering client SDKs, core upload infrastructure, backend payment services, and CLI tooling for permanent decentralized storage.
9
10## Description
11
12This skill provides end-to-end coverage of the Turbo Upload Service ecosystem for permanent decentralized storage on Arweave:
13
14### turbo-sdk (Client SDK)
15The 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.
16
17**Repository:** [ardriveapp/turbo-sdk](https://github.com/ardriveapp/turbo-sdk)
18**Language:** TypeScript (97.8%)
19**Stars:** 51
20**License:** Apache License 2.0
21**Status:** Production-ready with 144 releases
22**Purpose:** Client-side upload and payment integration
23
24### turbo-upload-service (Core Infrastructure)
25Production-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.
26
27**Repository:** [ardriveapp/turbo-upload-service](https://github.com/ardriveapp/turbo-upload-service)
28**Language:** TypeScript (97.9%)
29**Stars:** 11
30**License:** AGPL-3.0 (strong copyleft)
31**Status:** Production infrastructure with PostgreSQL, S3, SQS
32**Purpose:** Core upload orchestration and Arweave delivery
33
34### turbo-payment-service (Backend Service)
35Production-grade backend payment processing system managing Turbo balances, cryptocurrency transactions, and Stripe integration for the ArDrive platform.
36
37**Repository:** [ardriveapp/turbo-payment-service](https://github.com/ardriveapp/turbo-payment-service)
38**Language:** TypeScript (99.8%)
39**Stars:** 8
40**License:** AGPL-3.0 (strong copyleft)
41**Status:** Production backend with PostgreSQL, Docker, Koa framework
42**Purpose:** Payment infrastructure and balance management
43
44### x402-turbo-upload (CLI Tool)
45A minimal TypeScript command-line tool demonstrating x402 protocol integration with Turbo Upload Service using EVM wallet authentication.
46
47**Repository:** [ardriveapp/x402-turbo-upload](https://github.com/ardriveapp/x402-turbo-upload)
48**Language:** TypeScript (100%)
49**Stars:** 0 (new - created Nov 2025)
50**Status:** Development/Educational tool
51**Purpose:** CLI automation and protocol learning
52
53## When to Use This Skill
54
55### For Frontend/Client Development (turbo-sdk)
56- Implementing permanent file uploads to Arweave
57- Building applications with programmable fiat top-ups
58- Integrating Turbo Upload Service into TypeScript/JavaScript projects
59- Requiring production-grade upload reliability and error handling
60- Needing comprehensive API documentation and examples
61- Checking known issues or recent changes
62- Reviewing extensive release history (144 releases)
63
64### For Core Infrastructure Development (turbo-upload-service)
65- Building or hosting your own Turbo upload infrastructure
66- Understanding ANS-104 data item bundling for Arweave
67- Operating upload services at AWS scale
68- Implementing multi-signature upload support (Arweave, Ethereum, Solana)
69- Managing asynchronous fulfillment workflows
70- Docker and LocalStack development environments
71- Database migration workflows with Knex
72- S3 object storage and SQS queue integration
73- Understanding AGPL-3.0 implications for infrastructure hosting
74
75### For Payment Infrastructure Development (turbo-payment-service)
76- Building payment processing infrastructure
77- Managing Turbo balances and cryptocurrency transactions
78- Integrating Stripe for fiat payments
79- Setting up multi-blockchain payment support (Ethereum, Solana, Arweave)
80- Implementing balance management systems
81- Creating payment service backends with PostgreSQL
82- Docker deployment and database migration workflows
83- Understanding AGPL-3.0 license implications for backend services
84
85### For Learning & Simple Automation (x402-turbo-upload)
86- Learning x402 protocol basics and implementation
87- Creating simple CLI automation scripts
88- Testing custom Turbo Upload endpoints
89- Understanding EVM wallet authentication with uploads
90- Quick one-off upload testing
91- Minimal reference implementation study
92
93### General Use Cases
94- Understanding complete Turbo ecosystem (client + infrastructure + payment + CLI)
95- Comparing frontend SDK vs backend service vs core infrastructure architectures
96- Evaluating production vs development tooling
97- Integrating permanent storage with payment processing
98- Planning full-stack Arweave applications
99- White-labeling Turbo infrastructure for custom platforms
100
101## Quick Reference
102
103### turbo-sdk (Client SDK)
104- **Homepage:** https://ardrive.io/turbo/
105- **Topics:** ardrive, arweave, commonjs, esm, nodejs, turbo
106- **Open Issues:** 1
107- **Last Updated:** 2025-12-26
108- **Latest Release:** v1.39.2 (2025-12-15)
109- **Use For:** Frontend uploads, client integration
110
111### turbo-upload-service (Core Infrastructure)
112- **Technology Stack:** Koa, PostgreSQL, S3, SQS, Docker, LocalStack
113- **Architecture:** Two-component (Upload Service + Fulfillment Service)
114- **Stars:** 11
115- **Multi-Signature Support:** Arweave, Ethereum, Solana
116- **Deployment:** AWS-optimized with Docker support
117- **License Warning:** AGPL-3.0 requires source disclosure for network use
118- **Use For:** Core upload infrastructure, platform hosting
119
120### turbo-payment-service (Payment Backend)
121- **Technology Stack:** Node.js, Koa, PostgreSQL, Stripe
122- **Contributors:** 4 active developers
123- **Total Commits:** 24
124- **Blockchain Support:** Ethereum, Solana, Arweave
125- **License Warning:** AGPL-3.0 requires source disclosure for network use
126- **Use For:** Payment infrastructure, balance management
127
128### x402-turbo-upload (CLI Tool)
129- **Repository:** GitHub - ardriveapp/x402-turbo-upload
130- **Purpose:** Minimal demonstration/educational tool
131- **Created:** November 17, 2025
132- **Total Commits:** 4
133- **Use For:** Learning, simple automation
134
135### Languages
136- **TypeScript:** 97.8%
137- **JavaScript:** 1.6%
138- **Shell:** 0.4%
139- **HTML:** 0.2%
140
141### Recent Releases
142- **v1.39.2** (2025-12-15): v1.39.2
143- **v1.39.1** (2025-12-11): v1.39.1
144- **v1.39.1-alpha.1** (2025-12-10): v1.39.1-alpha.1
145
146## Available References
147
148### turbo-sdk (Client SDK) References
149- `references/README.md` - Complete README documentation (51 KB)
150- `references/CHANGELOG.md` - Version history and changes (33 KB)
151- `references/issues.md` - Recent GitHub issues (678 bytes)
152- `references/releases.md` - Release notes (112 KB, 144 releases)
153- `references/file_structure.md` - Repository structure (196 items)
154
155### turbo-upload-service (Core Infrastructure) Reference
156- `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
157
158### turbo-payment-service (Payment Backend) Reference
159- `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
160
161### x402-turbo-upload (CLI Tool) Reference
162- `references/x402-turbo-upload.md` - CLI tool documentation with usage examples, security considerations, and comparison with turbo-sdk
163
164## Ecosystem Component Selection Guide
165
166| Need | Component | Reason |
167|------|-----------|--------|
168| **Client-side uploads** | **turbo-sdk** | Production SDK, comprehensive, 144 releases |
169| **Host upload infrastructure** | **turbo-upload-service** | Core bundling service, AWS-scale, Docker support |
170| **ANS-104 data bundling** | **turbo-upload-service** | Arweave delivery orchestration |
171| **Multi-signature uploads** | **turbo-upload-service** | Arweave, Ethereum, Solana support |
172| **Backend payment processing** | **turbo-payment-service** | Multi-blockchain, Stripe, PostgreSQL |
173| **Balance management** | **turbo-payment-service** | Transaction tracking, database-backed |
174| **Fiat payments** | **turbo-payment-service** | Stripe integration built-in |
175| **Cryptocurrency payments** | **turbo-payment-service** | Ethereum, Solana, Arweave support |
176| **Simple CLI automation** | **x402-turbo-upload** | Minimal, straightforward |
177| **Learning x402 protocol** | **x402-turbo-upload** | Clear, minimal example |
178| **Full-stack application** | **All four** | Complete ecosystem coverage |
179| **White-label platform** | **upload-service + payment-service** | Core infrastructure components |
180
181## Usage
182
183### turbo-sdk (Client SDK)
184See `references/README.md` for complete API documentation, installation instructions, and comprehensive usage examples for client-side upload integration.
185
186### turbo-upload-service (Core Infrastructure)
187See `references/turbo-upload-service.md` for:
188- Two-component architecture (Upload Service + Fulfillment Service)
189- AWS production deployment at scale
190- Docker and LocalStack local development
191- Database migrations with Knex
192- Multi-signature upload support (Arweave, Ethereum, Solana)
193- S3 and SQS integration
194- Testing strategies (unit + integration)
195- API endpoint documentation
196- **IMPORTANT:** AGPL-3.0 license compliance requirements for hosting
197
198### turbo-payment-service (Payment Backend)
199See `references/turbo-payment-service.md` for:
200- Backend architecture and technology stack
201- Local development setup with Docker
202- Database migration workflows
203- Payment integration (Stripe + cryptocurrency)
204- API design patterns
205- Testing strategies
206- Production deployment
207- **IMPORTANT:** AGPL-3.0 license compliance requirements
208
209### x402-turbo-upload (CLI Tool)
210See `references/x402-turbo-upload.md` for CLI usage, parameters, examples, and important production considerations.
211
212---
213
214**Skill Version:** 1.3.0
215**Last Enhanced:** January 3, 2026
216**Coverage:** Complete Turbo ecosystem (client SDK + upload infrastructure + payment backend + CLI tool)
217**Components:** 4 repositories, 8 reference files
218**Generated by Skill Seeker** | Enhanced with complete infrastructure coverage
majiayu000