Full Redesign

[tabcat]

I'm using this repo to create a new libp2p protocol called zzzync.

The current repo sorta related but isn't used by anyone and I like the name.

The zzzync protocol will let a client push an IPNS document with a CAR stream to a zzzync server which pins the record and the content.
The CAR stream must have a single root in the CAR header, and every block in the stream must be in DFS order from the root.
Duplicate blocks will be included for the initial version.

Zzzync servers also need to support libp2p-fetch and expose their blockstore and ipns record store via fetch.

This issue is a tracker for full redesign.

• Test environment
• Unverified handler
• Blockstore Fetch handler just use bitswap (duh)
• IPNS Fetch handler
• Verified CAR streams
• CLI tools for server and client

[tabcat]

sequenceDiagram
  autonumber
  participant C as Client
  participant H as Handler

  Note over C,H: Protocol: /zzzync/push/1.0.0

  C->>H: Open stream

  C->>H: IPNS Key
  Note left of C: IPNS Key is a CID Libp2p Key

  alt Key allowed?
    H->>H: Optional authorization check
  else Not allowed
    H-->>C: Reject + close
  end

  C->>H: IPNS Record
  Note left of C: Marshalled IPNS record<br/>with an IPFS value.
  Note right of H: Client record version is >=<br/>to Handler record version.

  C->>H: CAR File
  Note left of C: CAR File has single root.<br/>Root matches IPNS Record value.
  Note right of H: CAR File blocks are DFS order.<br/>Handler verifies all blocks descend from root.
  
  C-->>H: Close stream
  H->>H: Pin CAR blocks
  H->>H: Republish IPNS record
  Note right of H: Handler closes stream after<br/>IPNS/IPFS content is persisted.
  H-->>C: Close stream

Loading