hyperledger / cacti

Hyperledger Cacti is a new approach to the blockchain interoperability problem
https://wiki.hyperledger.org/display/cactus
Apache License 2.0
339 stars 277 forks source link

docs(examples): simple asset transfer in the new architecture #334

Open petermetz opened 3 years ago

petermetz commented 3 years ago

Description

As a developer/contributor I want to have updated documentation about the simple asset transfer demo that I saw during the Hyperledger Global Forum 2020 talk so that I am not confused about the fact that (currently) there is no such documentation since we've moved over to the new architecture.

Context: A fully fledged example has been developed as part of v0.2.0, but it does not do asset transfer yet so it only partially resolved the original version of this issue (OG is here: #189 )

See also my comment: https://github.com/hyperledger/cactus/issues/189#issuecomment-716914627


Update 2023-09-15

More information about what a simple asset transfer was in the old architecture

See the code of it: https://github.com/hyperledger/cacti/tree/feadee73f350b5ffb84aa9aba0435eeb7697fecb/packages/core/examples/simple-asset-transfer

See a demo of it from way back when we moved up from the labs to be an incubation project: https://youtu.be/fgYrUIc_-sU?t=679

Simple asset transfer logic of the code that I linked above:

  1. Lock assets on both ledgers
  2. Generate proofs
  3. Validate proofs
  4. Mint new assets
  5. Transfer newly minted assets (locally)

It's not an atomic transfer.

Acceptance Criteria

1.The simple asset transfer use-case is re-written from scratch to match the new arch

  1. The new documentation closes the loop regarding asset export verification and error handling as well (thanks to Arnaud for pointing out the lack of these)

Depends upon #2655

ruzell22 commented 1 year ago

Hello @petermetz can you assign this to me? Thank you

aldousalvarez commented 1 year ago

Hello @jagpreetsinghsasan I am also helping on this one, Thanks!

jagpreetsinghsasan commented 1 year ago

Created spike #2655 so that @ruzell22 and @aldousalvarez can estimate the complexity of this task