10 Marlowe contract templates - the real life use cases

[GENERAL] Name and surname of main applicant

Jimmy Lee

[GENERAL] Are you delivering this project as an individual or as an entity (whether formally incorporated or not)

Entity (Incorporated)

[GENERAL] Co proposers and Additional applicants

Tony Nguyen - email: trint2@gmail.com

[GENERAL] Please specify how many months you expect your project to last (from 2-12 months)

9

[GENERAL] Please indicate if your proposal has been auto-translated into English from another language.

Yes

[GENERAL] Summarize your solution to the problem (200-character limit including spaces)

• Operating groups to train and workshops to create Marlowe contract templates that serve real-life needs
• The contract template/sample can contribute to Marlowe's code library.

[GENERAL] Does your project have any dependencies on other organizations, technical or otherwise?

No

[GENERAL] If YES, please describe what the dependency is and why you believe it is essential for your project’s delivery. If NO, please write “No dependencies.”

No dependencies.

[GENERAL] Will your project’s output/s be fully open source?

Yes

[GENERAL] Please provide here more information on the open source status of your project outputs

All implementation processes and results will be published on relevant Github open sources

https://github.com/vcoincheck

[SOLUTION] Please describe your proposed solution.

Context and challenge

1. Currently, the number of Dapps of Cardano is not much because the number of developers participating in the ecosystem is not much. The language barrier is a key factor.

Along with the development of Plutus, Aiken, and Opshin in recent times, Marlowe is a very long step in the development of Cardano's programming language.

However, Marlowe is relatively new and it's a language specifically geared towards the end user. Therefore, there will be a number of challenges to develop the Marlowe user ecosystem as follows:

• Shorten the distance between users and Marlowe.
• Need more model contracts, real-life application use cases.

2- In fact, the regulations and habits in financial and commercial transactions in each country and region are different. So the practical cases to apply Marlowe are very diverse.

As soon as Marlowe was launched, our team tried to build some smart contract templates according to the requirements of our customers. As a result, we found that the Marlowe language has not yet fully implemented the contract execution logic in reality.

3- Vietnam is one of the countries most interested in crypto and blockchain. There are a lot of programmers here, but most of them have not been deeply involved in the Cardano ecosystem.

In addition, in the process of building the community, we receive a lot of requests for training and sharing about Marlowe from the community.

Our solution

Solution 1

1.Create user-appropriate Marlowe training documents. These steps include:

• Collect material related to Marlowe from sources.
• Recalibrate to suit common user language.
• Completing a basic training curriculum
• This process will be done by a combination of programmers, community managers, ordinary users from the community.

2. Translate, create instructional clips about Marlowe-related documents into Vietnamese language and upload in one centralized sourc

3. Conduct training courses on Marlowe for the community. The training course will have developers participating as instructors, teachers, advisors, students

Model of 1 training course:

• Online training via zoom and offline in the locality.
• Each course include: 6 sessions, 2 workshops ( 2 month)
• Each lesson, students will have to prepare their own presentation on the topic of the lesson and share it with the whole class. This will motivate students to invest more time and seriousness in learning.
• Students who successfully present in each lesson will receive a reward.
• The instructors and supporters (teacher) are responsible for guiding, supporting, and answering students' questions during the lesson (instructors must be developers or persons who have good Cardano knowledge and experience in training as well as imparting knowledge)

Solution 2

As mentioned above, in fact, commercial and financial activities are very different in each region. Therefore creating many use cases, and the workflow to create it is a necessity.

In this solution number 2 we will do these steps:

• Organize working workshops among trainees from the training course. Discuss and experiment to come up with use cases, and samples of Marlowe in practice.
• Conduct surveys and collect comments from the community during the workshop.
• Groups of students will work together with professional developer groups to build Marlowe contract templates, use-case and contribute them to the community to use.
• The contract template must be at least 50% different from existing templates.

The impact

• This proposal makes a small contribution to proving to the community that anyone can become a developer in the Cardano ecosystem.
• Creating common user-language-oriented documentation will bridge the gap between the community and Marlowe. More people will know and care about Marlowe.
• The more actual use cases created, the more developers will be involved in solving it or other projects that can apply this use case to themselves.
• Use cases can also be great suggestions for the Marlowe language development team. It helps to improve the Marlowe platform, from which the benefit of the community is huge.

[IMPACT] Please define the positive impact your project will have on the wider Cardano community.

If this proposal is approved, it will have the following benefits:

• Create a set of documents about Marlowe according to common user orientation. Anyone can easily access, understand and use it.
• The project implementation process from document selection, training, workshop, development, and contract building will become a model for communities and teams to follow.
• The generated contract templates may be used by the community in the future.
• The template/sample can contribute to Marlowe's code library.
• The combination of working and collaborating between developers + ordinary users will shorten the gap in developing the developer ecosystem for Cardano
• The community will realize that becoming a Marlowe developer is not difficult at all.
• For regular users, this will be an opportunity for them to find a job related to smart contract programming.
• The two-way interactive training model and everyone working together with a commitment to responsibility will also be a lesson learned for many communities and groups to apply.

Keys metric to measure the impact:

1.Number of use cases, number of contracts template are created

This is an important parameter that shows the final performance of the project.

The template or draft must be at least 50% different from existing Marlowe contract templates

2.The number of interactions and comments from the community

Participating in the community's input into the workshop process, creating model contracts will measure the community's interest in Marlowe.

3. Number of developers

This parameter measures the interest, spread about Marlowe to the developers.

  

4. Number of trainees who completed the training course.

The training courses will be aimed at ordinary users but are technical, so to complete it, students need very high determination. Therefore, the parameters of the trainees who complete the training course show the quality of the training course.

5. Number of use cases that can be applied to projects funded by catalyst.

The project Output:

• The number of contract templates (at least 10)
• Number of developers involved in the project (developer profile sources)
• Marlowe basic documents, and training process documents will be posted on GitHub of our team and participating individuals.

https://github.com/Vcoincheck

Website: https://cardanolibrary.net

• The number of students and the learning process will be shown on the GitHub of students and teams. There will also be a public shared docs report
• Cooperation with other partners: We co-develop this proposal with 2 other projects also funded by Catalyst.

[CAPABILITY & FEASIBILITY] What is your capability to deliver your project with high levels of trust and accountability? How do you intend to validate if your approach is feasible?

Researching and educating team

• Vcoincheck.io is a platform or related product for sharing, training and educating about Cardano and blockchain knowledge. The project has 6 funded proposals in fund 7, 8, 9 and all have been completed. (Source lidonation)
• We are also the admin team of the largest Cardano Facebook community in Vietnam with more than 46k members and are reputable people as well as active in the catalyst in Vietnam.
• With experience in managing and completing 6 proposals, vcoincheck team is fully capable of implementing and managing the project to the ultimate success.
• Currently, we also apply the same 2-way interactive training model. And has successfully trained dozens of ordinary people to become blockchain experts who can replicate that model.

Here is our annual report: Vcoincheck annual report

Developer and support team

Vknight.io team ( please see attched file for specific information and experiment)

Vknight.io is a big and professional developer team. They are working in the field of software, especially banking and financial software or blockchain. Co-developed and co-owned software such as Optimal9 core banking software, Flex reporting system, software connecting peripheral channels with core banking system (HUB), etc

They also completed build a NFT marketplace product: https://vknight.io/

Vkinght.io profile: shared doc

The main goals of the project after 8 months of implementation

Goal 1: Build a user-oriented set of Marlowe documents

This goal is defined by the parameters of

• Number of document sets: 1
• Number of instructional clips: 10
• Training process documents: 1

Goal 2: Education about Marlowe for ordinary people to become Marlowe developers.

This goal is defined by the parameters of

• Number of training courses: 2
• Number of trainees participating in training: 20
• Number of training sessions: 16
• Number of workshop sessions: 7

Goal 3: Number of contract templates or drafts of actual application cases

This goal is determined by the number of sample contracts deployed on the Mainnet, the number of drafts of actual application cases.

• Number of Model Contracts Deployed Mainnet: 1
• Number of drafts of practical application cases: 10

Goal 4: Number of Catalyst funded projects introduced .

This goal is defined by the Catalyst funded projects introduced and partnered with.

Target: 2 projects.

Goal 5: Number of professional developers but not Marlowe developers involved

Target: 10 people

[Project Milestones] What are the key milestones you need to achieve in order to complete your project successfully?

Task

• Creating core-team (week 1)
• Making details plan (week 1)
• Research and collecting documents (week 1-4)
• Editing documents (week 5)
• Completing documents (week 6)
• Completing the training curriculum (week 6-7)
• Publishing documents (week 7)
• Recruiting 1st training course (week 7-8)

Acceptance criteria

• 1 document describing core-team list, selected document content, detailed implementation plan...
• The complete set of documents is posted on committed sources (English language)
• 1 completed training curriculum (documents)
• List of trainees of 1st training course

Output:

• Public shared document, github (https://github.com/Vcoincheck)
• Announcement on our website and social channels (https://Vcoincheck.io)

Intend outcome

• Researching documents: 1 set
• Training documents: 1 set
• Trainees list: 1 doc
• Amount of trainee: at least 6 people

Timeline: month 1-3

Est cost: 20840 ADA

Task

• Translating documents to Vietnamese (week 9)
• Processing training course No1 (week 9-12)
• Recruiting 2nd training course (week 11-12)
• 1st workshop (week 12)

Acceptance criteria

• Documents in Vietnamese
• 1st training course recorded clip
• 1st workshop recorded clip
• 2nd training course's trainees list

Output:

• Public shared document, github (https://github.com/Vcoincheck, https://Vcoincheck.io)
• Recorded clip (Vcoincheck.io youtube channel)

Intend outcome:

• Documents in Vietnamese: 1 set
• Training documents in Vietnamese: 1 set
• Clip recorded: 5
• Trainees list: 1 document
• Amount of trainee: at least 6 people

Timeline: month 4

Est cost: 15510 ADA

Task

• Completing training course No1 (week 13-16)
• Processing training course No2 (week 13-16)
• 2nd and 3rd workshop (week 16)
• Finding project partner (week 14-16)

Acceptance criteria

• 2nd training course recorded clip
• 4-7th workshop recorded clip
• Annoucement of collaboration with other project
• Draft of real-life use case smart contract
• Choosen of Marlowe contract template

Output:

• Public shared document, github (https://github.com/Vcoincheck, https://Vcoincheck.io)
• Recorded clip (Vcoincheck.io youtube channel)
• Annoucement: posted on https://Vcoincheck.io

Intend outcome:

• Posted: 1 articles
• Clip recorded: 6

Timeline: month 5

Est cost: 18480 ADA

Task

• Completing training course No2 (week 17-20)
• Finding project partner (week 18-19)
• 4-7th workshop between groups (week 21-24)
• Making real-life use cases of smart contract (week 21-24)
• Choosing sample contract (week 24)

Acceptance criteria

• 2nd training course recorded clip
• 4-7th workshop recorded clip
• Annoucement of collaboration with other project
• Draft of real-life use case smart contract
• Choosen of Marlowe contract template

Output:

• Public shared document, github (https://github.com/Vcoincheck, https://Vcoincheck.io)
• Recorded clip (Vcoincheck.io youtube channel)
• Annoucement: posted on https://Vcoincheck.io

Intend outcome:

• Posted: 1 articles
• Clip recorded: 6
• use case description document: 1
• Detail document of sample smart contract: 1 document

Timeline: month 6-7

Est cost: 22210 ADA

Task

• Building solution to deploy sample contract (week 25)
• Making test contract (week 26-27)
• Deploy and test contract on testnet (week 28-29)
• Review and revise the contract (week 30)
• Deploy and launch on mainnet (week 31-32)
• Making product report (week 32)
• Close out report (week 32)

Acceptance criteria

• Smart contract template source code
• Video walkthrough
• Testing result report
• Video description the contract making process

Output

• Video: Vcoincheck youtube channel
• Report document: shared public document
• Smart contract source code: vcoincheck github

Intend outcome:

• Video: 2
• Report: 1 document
• Smart contract source code: 1
• Close out report

Timeline: month 8-9

Est cost: 22000 ADA

[RESOURCES] Who is in the project team and what are their roles?

1.Jimmy Lee - Project admin

• Leader of Vcoincheck project
• Admin of 2 Vietnamese Cardano facebook Community (helping over 40k followers) https://www.facebook.com/groups/cardanoviet and https://www.facebook.com/groups/ada.holder
• Instructor of 2 “how to evaluate a crypto’s project) courses.
• An Entrepreneur with 3 year experience in the blockchain field.
• Has a deep knowledge in blockchain technology and blockchain projects.

2.Mr Mau Luu - Tech lead

• Software engineer - Education of Technology University HCM City, focus on: ✓ Analyze & Design Database. ✓ Structure of Data. ✓ Programming, Analyze & Database Design.
• Master of Business Administration Knowledge: banking operation, accounting, statistics,…
• Co-developed and co-owned software such as Optimal9 core banking software, Flex reporting system, software connecting peripheral channels with core banking system (HUB), etc. Had successfully implemented many projects for all local bank and oversea bank below: • Local bank: VietNam Asia Comercial Joint Stock Bank, VinaSiam Bank, Lao-Viet Bank, Saigon Bank, SACOMBANK,… • Oversea bank: Far East National Bank (VietNam), Huanan Bank (VietNam), HSBC (VietNam), Cambodian Public Bank (Cambodia), Vattanac Bank (Cambodia), Angkor Capital Bank Plc., Phongsavanh Bank (Laos), Ayeyarwady Bank (Myanmar), etc. In charge of foreign markets for JITS company such as Cambodia, Laos, Myanmar, etc.

2. Mr. Tri Nguyen - dev team leader

• Software engine: University of Finance and Marketing Cyber security: Jetking Digital Marketing & Sales system: many years of experience Blockchain Knowledge: consulting, building software solutions and infrastructure, operating CRM systems for marketing and sales automation systems, .... Blockchain knowledge
• Sales and consulting many solutions for banking and securities, ERP enterprises Participated in domestic banking projects such as Sacombank, Dong A Bank, Nam A Bank, SCB, SHB, De Nhat Bank, Viet A Bank, Lao Viet Bank, An Binh Bank, HDB, Techcombank, Maritime Bank,... Participated in domestic securities projects such as Dai Viet (DVSC), Sao Viet (VSSC), Rong Viet (VDSC), Sacombank (SBSC), Dong A (DAG), Cho Lon (Cholonsc), Da Nang ( DNSC), Saigon (SSI), Ho Chi Minh City (HSC), Golden Lotus (GLS), Thanh Cong (TCSC), Thien Viet (TVS), Vien Dong (VDSC), Kim Eng… ERP enterprises such as Tiki, Insee, TheCoffeeHouse, JUNO, ...

[BUDGET & COSTS] Please provide a cost breakdown of the proposed work and resources.

Total budget: 99040 ADA

 

Milestone 1: 20840 ADA

 

• Research, collecting, editing, finishing documents: 14900 ADA
• Admin fee: 5940 ADA

 

Milestone 2: 15510 ADA

• Completing the training curriculum and document: 5280 ADA
• 1st month of Training course No1 fee: 8250 ADA (4 sessions)
• Instructor: 6600 ADA per session
• Reward for representator: 1650 ADA per session
• Admin fee: 1980 ADA

 

Milestone 3: 18480 ADA

• 1st Training course fee: 8250 ADA (4 sessions)
• Instructor: 6600 ADA per session
• Reward for representator: 1650 ADA per session
• 2nd Training course fee: 8250 ADA ( 4 sessions)
• Admin fee: 1980 ADA

 

Milestone 4: 22210 ADA

•  Workshop fee: 10000 ADA (reward for 5 best real-life use-case)
•  Admin fee: 3960 ADA
• 2nd Training course fee: 8250 ADA

 

Milestone 5: 22000 ADA

•  Smartcontract processing fee: 18040 ADA
• Admin fee: 3960 ADA

[VALUE FOR MONEY] How does the cost of the project represent value for money for the Cardano ecosystem?

Answer:

• The vcoincheck.io team has a good collaboration with the developer team (Vknight.io). So many fees are sponsored by vkinght.io
• Vcoincheck.io also has a large community so there is no marketing fee.
• All sources like the website and equipment for the training course are sponsored by assets of vcoincheck.io too

Researching, checking, edit document fee: 180ADA/hour (~ 83 working hours)

Making Training curriculum: 120 ADA/hour ( ~ 44 working hours)

Instructor fee: 825 ADA/hour ( 2 courses, 16 sessions, 2 hours/session)

Smartcontract processing fee: 300 ADA/man-day ( ~82 days, 2 developer process within 42 days)

Admin fee: 30 ADA/hour ( 3 working hours/day, 22 days/month)

[IMPORTANT NOTE] The Applicant agrees to Fund Rules and also that data in the submission form and other data provided by the project team during the course of the project will be publicly available.

I Accept