Practical guide for using Countersigning

[mattyg]

This is not a stable feature in holochain core and should not be documented yet.

Must include:

• code examples
• practical, terse explanation of how to use
• gotchas

• Signals
  • Local signals to UI
  • Remote signals to peers on same DHT
    • needs cap grant on recv_remote_signal
    • (future) pub/sub to replace most use cases for remote signals
  • not supported between zomes or between cells :(

Possible topics include:

• Countersigning
  • Automated process; agreement to countersign a given piece of data should have already been made
    • online and interactive (in distributed systems terms)
  • Document the heck out of the lifecycle

    sequenceDiagram
        box Alice
            participant ACell as Alice's cell
            participant ACond as Alice's conductor
        end
        box Bob
            participant BCond as Bob's conductor
            participant BCell as Bob's cell
        end
        
        ACell->>ACell: prepare entry to be countersigned
        ACell->>BCell: send entry data (signal or zome function)
        BCell-->>ACell: acknowledge, store, and approve of entry data
        ACell->>ACell: create reflight request
        Note right of ACell: contains parties involved, hash of entry to be signed, time window, action stub, arbitrary preflight bytes
        ACell->>BCell: call arbitrary zome function called `receive_preflight` with prepared preflight request
        BCell->>
        
    

    Loading
  • Patterns for implementing the interactions that aren't handled at the system level