Skip to content

L1_design_implementation.md

Latest commit

 

History

History
36 lines (31 loc) · 1.59 KB

L1_design_implementation.md

File metadata and controls

36 lines (31 loc) · 1.59 KB
Raw

Layer 1 — File System & S3 Interfaces (Design / Implementation)

Draft — needs triage. Extracted from the Layer 0 implementation design doc. Promote into design/, fold into docs/filesystems/, or drop — pending the layered-architecture decision in #51 (what belongs on-chain vs. provider-only).

The provider node also serves the Layer 1 interfaces described in docs/filesystems/ and ./marketplace.md. These mount on top of the Layer 0 blob primitives and require Writer/Admin authorization for mutating routes.

S3-compatible object storage
────────────────────────────
PUT    /s3/:bucket_id/object?key=path/to/object
GET    /s3/:bucket_id/object?key=path/to/object
HEAD   /s3/:bucket_id/object?key=path/to/object
DELETE /s3/:bucket_id/object?key=path/to/object
GET    /s3/:bucket_id/objects                     # list
GET    /s3/:bucket_id/index_root                  # current S3 index CID

File system interface
─────────────────────
PUT    /fs/:bucket_id/file?path=/dir/file.txt
GET    /fs/:bucket_id/file?path=/dir/file.txt
DELETE /fs/:bucket_id/file?path=/dir/file.txt
POST   /fs/:bucket_id/mkdir                       # body: { path: ... }
GET    /fs/:bucket_id/ls?path=/dir
GET    /fs/:bucket_id/index_root                  # current drive root CID

See docs/filesystems/API_REFERENCE.md for the full Layer 1 contract (request/response shapes, error codes, manifest formats).