IPFS × OpenClaw Hackathon 2026

Agentic file storage
for autonomous agents

Trustless file pinning to Filecoin with conditional Alkahest escrow payments. AI agents upload, verify, and settle — zero middlemen.

Install CLI View on GitHub
ZeroLayer demo
# Initialize your Filecoin wallet
$ ZeroLayer init
✅ Wallet created: f1xkr3mq7...

# Pin a file to Filecoin
$ ZeroLayer upload report.pdf
CID: bafybeig4e5b90d6ff64f4a8...
Status: pinned
Cost: 0.00000001 FIL
✅ Pin complete.

# Upload with trustless escrow payment
$ ZeroLayer upload --trustless report.pdf
Contract: 0x7a23f8e1...
✅ Escrow released after pin verified.
Trustless Payment Flow

How the escrow works

01

Upload

File pinned to Filecoin

→
02

Lock

Alkahest escrow created

→
03

Verify

Agent checks CID status

→
04

Release

Funds released on success

Tech Stack

Architecture overview

CLI

Commander.js

Clean argument parsing with subcommands: upload, status, retrieve, init.

Agent

OpenClaw SDK

Skill registration and orchestration — what makes this agentic, not just a CLI.

Storage

Filecoin Pin

filecoin-pin-js wraps decentralised storage pinning. Returns CIDv1 on success.

Payment

Filecoin Pay SDK

Mainnet wallet generation and transaction management for FIL payments.

Escrow

Alkahest

Conditional payment contracts — funds held until pin verified, then released.

State

SQLite + dotenv

Local CID→status mapping and secure wallet credential management.

Commands

Everything you need

ZeroLayer init
Generate a new Filecoin-compatible mainnet wallet and save credentials to .env.wallet.
ZeroLayer upload <file>
Pin a local file to the Filecoin network. Returns CID, status, size, and estimated cost.
ZeroLayer upload --trustless <file>
Upload with Alkahest escrow — funds locked until pin is verified on-chain, then auto-released.
ZeroLayer status <CID>
Query pin status for a CID. Returns pinned status, provider count, and retrievability.
ZeroLayer retrieve <CID> <path>
Download a pinned file by CID to a local output path.
Get Started

Install in seconds

Run without installing (npx):
$ npx ZeroLayer --help
Install globally:
$ npm install -g ZeroLayer
Clone and run locally:
$ git clone https://github.com/aniruddha1295/ZeroLayer.git
$ cd ZeroLayer && npm install && npm start
View on GitHub NPM Package