Vaultline // docs hub

Everything public in one place.

Vaultline is live x402 storage for agents. The primary public payment surface now runs through Bankr x402 Cloud; the direct Vaultline API remains available as a lower-level fallback.

View Bankr endpoints Open skill page Raw skill file GitHub repo

Get Started

Bankr-first quickstart

Use the Bankr x402 endpoints first. They are the public paid surface for upload, download, and list. Use the direct API only when you need lower-level SDK behavior or private wallet-gated reads.

1 / upload

Store a file through Bankr

Bankr collects x402 payment, then proxies into the Vaultline backend.

POST https://x402.bankr.bot/0x2a16625fad3b0d840ac02c7c59edea3781e340ae/vaultline-upload

{
  "path": "workspace/report.md",
  "content": "agent artifact",
  "encoding": "text",
  "contentType": "text/plain"
}

2 / download

Retrieve by path

Return UTF-8 text for text artifacts or base64 for binary-safe handoff.

POST https://x402.bankr.bot/0x2a16625fad3b0d840ac02c7c59edea3781e340ae/vaultline-download

{
  "path": "workspace/report.md",
  "asText": true
}

3 / list

Inspect open objects

List open objects by prefix. Private wallet-auth routes remain on the direct API.

POST https://x402.bankr.bot/0x2a16625fad3b0d840ac02c7c59edea3781e340ae/vaultline-list

{
  "prefix": "workspace/"
}

Bankr x402 Flow

Primary paid endpoints

Each Bankr endpoint is fixed at `$0.002 USDC/request` today and caps upload/download payloads at 5 MB. Bankr handles payment; Vaultline handles storage and metering.

POST /vaultline-uploadUpload `{ path, content, encoding, contentType }` through Bankr x402.

POST /vaultline-downloadDownload `{ path, asText, maxBytes }` through Bankr x402.

POST /vaultline-listList open objects with `{ prefix }` through Bankr x402.

Fallback API Surface

Direct Vaultline routes

These backend routes remain live for SDK/private-wallet flows and lower-level integrations. Public paid usage should start with Bankr.

PUT /v1/files/{path}Upload a file. Billable write path with x402 pay-and-retry.

GET /v1/files/{path}Download a file. Small reads may be free; larger reads can require payment.

HEAD /v1/files/{path}Inspect metadata like size, content type, and estimated read/storage cost.

DELETE /v1/files/{path}Delete an object. Private objects require wallet auth.

GET /v1/list/{prefix}List files under a prefix. Private visibility depends on authenticated wallet access.

GET /v1/healthHealth endpoint for uptime checks and deploy verification.

GET /v1/usageUsage, calls, users, and revenue metering summary.

Resources

Pick the surface you need

Site-first when you want orientation. Repo-first when you want internals. npm-first when you just want to install and move.

SDK

npm package

Install the SDK directly and wire it into an agent or CLI.

Open npm

Skill

Agent instructions

Use the hosted skill page or copy the raw markdown file into your agent setup.

Skill page Raw markdown

Source

Repo docs + code

When you need deeper architecture, tests, examples, and operational files, the repo is still the full source of truth.

Open GitHub