w3stor.agent

Decentralized Storage for Autonomous Agents

Connect any AI framework. Pay from any L2 with x402. Store permanently on Filecoin. One unified API for every agent.

REST APIMCP ServerA2A ProtocolERC-8004x402 PaymentsVercel AI SDK

Framework Integrations

Connect Any AI Framework

Drop w3stor into your existing agent stack. Live today with Vercel AI SDK — more frameworks coming soon.

Vercel AI SDKLive

Use w3stor as a tool in generateText or streamText. Pass files to any GPT-4o or Claude model and get back a permanent Filecoin CID — no extra infrastructure.

View integration docs

agent.ts

import { generateText } from "ai";
import { storeFile } from "./w3stor-tools";

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools: { storeFile },
  prompt: "Upload research.pdf to Filecoin",
});

MastraComing Soon

Agent orchestration framework with built-in w3stor integration for multi-step workflows.

ElizaOSComing Soon

Autonomous agent OS plugin — storage actions as first-class agent capabilities.

Anthropic Claude SDKComing Soon

Native tool_use integration for Claude models with streaming artifact storage.

How It Works

Know the Cost Before You Start

Three steps from idea to permanent storage — with a transparent cost estimate at step two, before any agent runs.

Step 1

Describe Your Task

Tell any AI agent what you need stored — files, datasets, research artifacts. Use natural language through any protocol.

Step 2

Review Cost Estimate

Unified pricing for compute + storage. One number in USDFC before execution starts.

Step 3

Agents Execute & Store

Agents run your workflow and store artifacts permanently on Filecoin. Track progress in real-time. Pay per-request with x402.

Live Agent Demo

Watch 5 AI agents collaborate on robotics research, produce artifacts, and store everything on Filecoin — with live cost tracking.

Progress

Initialize

Literature Search

Data Analysis

Code Generation

Peer Review

Synthesis

Storage Request

Agents Talking to Agents

Every inter-agent message is a signed JSON-RPC 2.0 call over the A2A protocol. Click any message to inspect the raw envelope.

Research AgentA2A

Found 47 papers on humanoid locomotion and sim-to-real transfer. Compiled a structured literature review with citations, key findings, and research gaps. Ready to hand off to Analysis Agent.

Analysis AgentA2A

Processed 47 papers into dense vector embeddings (1536-dim). Clustered by methodology and identified 3 dominant research paradigms. Requesting storage for embeddings dataset — 8.1 MB.

w3stor AgentA2A

Stored 2 artifacts on Filecoin via 3 storage providers. Ephemeral Pinata pin created for instant access. Total cost: 0.0031 USDFC. CIDs: bafybei…a4k2 (survey), bafybei…9xm1 (embeddings).

Four Ways to Connect

Every protocol speaks the same operation. Pick the one that fits your stack — or use all four in the same swarm.

REST API

Store files from any HTTP client. Include the x402 payment header and get a CID back. Works with curl, fetch, axios — any language, any runtime.

View documentation→

curl -X POST https://api.w3stor.agent/upload \
  -H "Content-Type: multipart/form-data" \
  -H "X-402-Payment: eip155:8453:0xPayment…" \
  -F "file=@robot-telemetry.ndjson" \
  -F "providers=3" \
  -F "permanent=true"

# Response
{
  "cid": "bafybeig3p7xj2vkqzn5o4ywlmca7ibe2i3qp6dta5r8nfhz2ska4k2",
  "providers": ["f01234", "f05678", "f09012"],
  "pinataUrl": "https://gateway.pinata.cloud/ipfs/bafybei…",
  "costUSDFC": "0.0014",
  "status": "confirmed"
}

Unified Pricing

Compute + storage in one number. Know the cost before execution.

Estimated Cost

0USDFC

Agents3 agents

Runtime2 min

Storage10 MB

Compute cost

0.0840 USDFC

$0.014 / agent·min

Storage cost

0.0010 USDFC

$0.0001 / MB

Built on the Open Stack

No vendor lock-in. w3stor integrates with the protocols, frameworks, and chains you already use.

Filecoin

IPFS

Pinata

Lighthouse

Akave

Vercel AI SDK

ElizaOS

Mastra

Anthropic

OpenAI

Base

Optimism

Arbitrum

x402

USDFC

Filecoin

IPFS

Pinata

Lighthouse

Akave

Vercel AI SDK

ElizaOS

Mastra

Anthropic

OpenAI

Base

Optimism

Arbitrum

x402

USDFC

Filecoin

IPFS

Pinata

Lighthouse

Akave

Vercel AI SDK

ElizaOS

Mastra

Anthropic

OpenAI

Base

Optimism

Arbitrum

x402

USDFC

Filecoin

IPFS

Pinata

Lighthouse

Akave

Vercel AI SDK

ElizaOS

Mastra

Anthropic

OpenAI

Base

Optimism

Arbitrum

x402

USDFC

Enable Your Agents

Give your agents decentralized storage. Any framework, any protocol, any chain.