You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

Status
NOT STARTED
Stakeholders
Makoto Takemiya Iurii Vinogradov Egor Ivkov 
Outcome
Due date
Owner
Nikita Puzankov 

Background

We should declare initial set of out-of-the-box Iroha Special Instructions for Iroha 2.0.0 release.

Action items

Problem

Iroha whitepaper, current implementation and users' expectations are differ in terms of out-of-the-box Iroha Special Instructions set.

To have some expected result in Iroha 2.0.0 we need to define the stable set of these instructions. Part of this work was made in Iroha Special Instructions DSL, here we will focus on instructions set, not how they work and how to use them.

Solution 

The good solution will be to define taxonomy and ontology on some full set of Iroha Special Instructions, had a strong agreement on categories and naming, with an ability to modify resulting set with small changes.

Use this agreement to update the White Paper, build current implementation and align users' expectations. 

Decisions

Split out-of-the-box instructions into following categories:

  • Domain related
    • Register/Unregister<Id, Identifiable>
    • Mint/Burn<Id, Value>
    • Transfer<Id, Value, Id>
  • Math
    • Add/Substract<Value, Value>
    • Multiply/Divide<Value, Value>
    • RaiseTo<Value, Value>
    • Mod<Value, Value>
  • Compositions
    • Sequence<Vec<Instruction>>
    • Pair<Instruction, Instruction>
    • If<Instruction, Instruction, Instruction>
    • Not<Instruction>
  • Queries
    • Execute<Query>

Provide set of possible domain related instructions:

  • Register/Unregister
    • Register or unregister Domain in Peer
    • Register or unregister Account in Domain
    • Register or unregister Asset Definition in Domain
    • Register or unregister Peer Id in Peer 
    • Register or unregister Signatory in Account
  • Mint
    • Mint or burn value to or from an Asset 

Alternatives 

  • Do not have categories and generic instructions using plain set of instructions like "AddDomain, RegisterAccount" - as cons we can point out naming and extensibility problems
  • Do not have granularity and differences between register, mint, add - as cons we can point out different business related meanings for similar actions and to wide set of options in one bucket

Concerns 

  • Too big or too small set of out-of-the-box instructions can be hard to maintain or not sufficient for users needs
  • Iroha 1 users can struggle from new naming

Assumptions - document any assumption that you made

  • We did not made final decision about "Iroha Modules" related instructions (DEX, Bridge, Permissions, etc.) and their inclusion into out-of-the-box set yet

Risks 

  • Set will be incomplete from users' perspective `[5;2]`
  • We missed some categories `[2;7]`

Additional Information 


  • No labels