Arweave File System

Introduction

Arweave File System, or “ArFS” is a data modeling, storage, and retrieval protocol designed to emulate common file system operations and to provide aspects of mutability to your data hierarchy on Arweave's otherwise permanent, immutable data storage blockweave.

Due to Arweave's permanent, immutable and public nature traditional file system operations such as permissions, file/folder renaming and moving, and file updates cannot be done by simply updating the on-chain data model.

ArFS works around this by implementing a privacy and encryption pattern and defining an append-only transaction data model using tags within Arweave Transaction headers.

Document Version History

Version

Date

Release Notes

Version

Date

Release Notes

0.11a

July, 2021

Introduces version 0.11, the first version of “ArFS” that has been in use in ArDrive since September 2020.

0.11b

October, 2021

Added more details around first ArFS version including actions that can be performed.

ArFS Version History

Version

Date

Release Notes

Version

Date

Release Notes

0.10

August 2020

The brief, beta version that was in use during initial testing of ArDrive across Web (Dart) and legacy CLI (Typescript).

0.11

(Current)

September 2020

Includes all of the major functionality supporting file systems on Arweave including new drives, folders, files, renames, moves and privacy.

Table of Contents