Vaultline // docs hub

Everything public in one place.

Vaultline is live x402 storage for agents. This page is the public entrypoint for the SDK, the agent skill, the live API, the quickstart flow, and the operational docs builders need before wiring it into real work.

Install SDK Open skill page Raw skill file GitHub repo

Get Started

Quickstart

Use a Base wallet that can sign x402 payments, point your client at the live API, then upload or retrieve artifacts through the same HTTP flow.

1 / install

SDK install

The SDK is the cleanest path for TypeScript agents and CLIs.

npm install @builtbyecho/vaultline-sdk viem

2 / connect

Create a client

Point at the live service and pass a wallet account that can sign x402 payment payloads.

const client = new VaultlineClient({
  baseUrl: 'https://storage.builtbyecho.xyz',
  account
});

3 / move files

Upload and read

Open is public-by-key. Private adds wallet-gated reads. Encrypted is not live yet.

await client.upload('workspace/report.md', body, {
  visibility: 'open'
});

x402 Flow

Pay, retry, continue

Vaultline uses the standard machine-payment loop. Send the request, parse `402`, sign the payment, retry the same request, and get the normal route response.

Request

First request

Uploads and larger reads may be billable. Private files also require wallet-auth headers.

PUT /v1/files/workspace/report.md
GET /v1/files/large.bin

402

Read the quote

When payment is required, the server returns a machine-readable `payment-required` header.

error: payment_required
network: eip155:8453
asset: Base USDC
payTo: treasury wallet

Retry

Same request, signed payment

Keep the original request intact. Add the x402 payment header and retry.

x-payment: <signed payload>
retry original method + path + body

API Surface

Core routes

These are the routes most builders need first. The repo still carries deeper operational notes, but this page covers the public shape.

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