Mastering Open Enterprise Agent (Atala PRISM): A Developer Handbook for Decentralized Identity Solutions

[GENERAL] Name and surname of main applicant

Jon Bauer

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

Individual

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

10

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

No

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

Our book, based on real-world experience, explains the concepts and techniques required to build complex applications with Open Enterprise Agent, and includes open source sample code for developers.

[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

The source code for the example projects will be open source and freely available under a permissive license.

We plan to make the text available via a "Pay what you want" pricing model, which would allow the information to always be freely available.

[METADATA] SDG rating

Education

[SOLUTION] Please describe your proposed solution.

Learning is hard, books are the best:

When a technology is new, learning it can be difficult. Often documentation is accurate but lacks practical context and software developers often need examples and expert advice to be productive.

This book will give a software developer what they need to build and deploy an Open Enterprise Agent project from scratch to production and beyond. Free example source code will be made available, showing real world implementations for Web, iOS, and Android, as well as architecture patterns which worked for the authors when solving real world projects.

This book aims to be a companion to the official documentation, adding much needed context and tutorial-based learning, turning any developer into an Open Enterprise Agent guru.

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

We believe Mastering Open Enterprise Agent will be an essential source of knowledge for any software developer who's intrigued by Self-Sovereign Identity but doesn't know where to start. Learning SSI concepts can be overwhelming. We will provide real world examples, and will aim to demystify and educate readers on practical details which allow them to build and learn at the same time.

Mastering Open Enterprise Agent will highlight tips, tricks, and lessons learned while building and scaling real world projects in production. Working code examples will allow developers to jump the usual hurdles and copy/paste their way past complex problems. The book will be published in English and Spanish, and which will help spread adoption of Open Enterprise Agent and become a definitive resource worldwide. We hope to make it simple for the community to contribute other translations once the text is published.

Each of the topics below will be in depth backed with solution patterns from real world experience:

Table of Contents *subject to change during writing/editing phases:

• SSI Basics
• Use Cases
• Roles
• Terminology
• Open Enterprise Agent Basics
• Setting Up Your Dev Environment
• Apollo
• Castor
• Mercury
• Pluto
• Write to your own data store
• Pollux
• Prism Agent
• Wallet
• Handling Seed Phrases
• Managing state across devices
• DIDComm2
• did:prism
• did:peer
• Cloud Agent
• Installation
• Edge Agents
• Why?
• Network Diagram
• Agent Wallets
• Seeds
• Storage
• Extensions
• Syncing
• Recovery
• Gotchas
• Mediators
• How they work
• Peers and Handshakes
• Setting up your own Mediator
• Authentication in the Real World
• Authentication vs Authorization
• Login via OAuth
• Login with DID
• KYC Patterns
• Invites
• How to think about Invites
• Invite Patterns for better UX
• Connections
• DID Peers
• DID Pairs
• Connection abstractions for a better UX
• Trust Registries
• DIDDocuments
• Use Cases
• Lyins, Tigers and Things, Oh My!
• Patterns for Controllers
• Resolvers
• Write your own Resolver
• Publishing your did:prism
• Why Publish your did:prism?
• Publishing to the Blockchain
• Paying for Transactions
• Other Publishing Patterns
• Monitoring the Published State
• Verifiable Credentials
• Schemas
• Claims
• Publishing
• Industry Specific Standards
• Issuing
• Requesting and Presenting Proof
• Presentation Requests
• Presentation Policies
• Selective Disclosure with AnonCreds
• Integrations
• Hyperledger
• Cardano
• KYC
• Csign
• Hashicorp
• Scaling
• Setting up Your Production Environment
• Multi-Tenancy
• Network Architecture Patterns
• Real World Performance
• Hardware Recommendations
• Chain latency
• Example Project:
• Install PRISM Cloud Agent
• Install Edge Agent SDKs
• iOS
• Android
• Web
• Errata

*The Table of Contents, like open source software, is subject to change. The Open Enterprise Agent is under active development and may add or deprecate features while the book is being written. We will do our best to represent all the important topics at the time of the book's release.

[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?

About the Authors:

Jon Bauer and Roberto Carvajal, are both experienced developers with almost 30 years of experience each. In 2006, they formed Covelop, a software development agency which specializes in groundbreaking platforms for Music Industry artists and labels. Early pioneers in digital E-commerce, Covelop has delivered profitable solutions across web and mobile technologies, and is now invested in creating innovative projects involving Self-Soverign Identity (SSI), Blockchain, and Open Enterprise Agent.

Jon and Roberto have completed the Atala PRISM v2 Beta program, Atala PRISM Pioneer Programs 101, 102, and 103, and have built a large Open Enterprise Agent project in 2023.

Roberto is a polyglot, full stack developer who can build an idea and scale it to millions. His background in security and encryption is only matched by his ability to explain complex topics to others. Roberto has crafted advanced SSI applications and will translate the book into Spanish.

Jon started programming the web in 1996, and spent over 10 years as a full stack engineer. He has led web and mobile projects at several large public companies, and has specialized in iOS and Apple platforms since 2011.

Jon has also been working in the Identity industry and with Plutus since 2021 and has completed the Emurgo Academy Cardano Developer Professional and Cardano Solutions Architect programs.

Roberto and Jon are members of the team building Csign, an agreement signing platform using Cardano, Self-Sovereign Identity and Blockchain. Csign has been built from the ground up using Open Enterprise Agent and the authors are ready to share their experience.

Roberto Carvajal: https://www.linkedin.com/in/robertocarvajal/

Jon Bauer: https://www.linkedin.com/in/jonbauer/

Learn more about Open Enterprise Agent, Hyperledger, and see a live demo of Csign here:

https://www.youtube.com/watch?v=3DA0FzL0uHA

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

Month 1: Research

• Consolidate notes from our real world experience building and launching Open Enterprise Agent projects
• Finalize Table of Contents
• Ideate theme for example application code
• Create landing page website so we can post about progress throughout the project

Months 2/3/4: Write Drafts

• Writing book chapters on the topics we feel are critical to a developer's success.
• Posting on project website about SSI news and related topcs
• Posting on project website about progress of book authorship

Months 5/6/7: Example Code Development

• Building out an example project in each of Open Enterprise Agent's SDKs
• Example code for Cloud Agent
• Example code for TypeScript Edge Agent
• Example code for Swift / iOS Edge Agent
• Example code for Kotlin / Android Edge Agent
• Example code for OpenAPI backend server code and API

Technical Editors and Feedback

• Technical editors and experts from the community to proofread our text

Hire Designer to layout the book, create illustrations and design the book cover

Month 8: Technical Editors and Feedback for Example code

• Technical editors and experts from the community test our example code, report bugs and provide feedback
• Fix bugs in example code
• Update code for latest possible breaking changes in Open Enterprise Agent

Month 9: Revise Drafts into Final Form

• Revise book text to match latest versions of Open Enterprise Agent
• Release sample chapters for community feedback
• Book Text / Code Freeze
• Prepare book materials for Publishing

Month 10: Publish

• Publish the book and source code

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

Author: Roberto Carvajal - https://www.linkedin.com/in/robertocarvajal/

Author: Jon Bauer - https://www.linkedin.com/in/jonbauer/

Technical Editors: We will reach out to experts from the Open Enterprise Agent core team as well as Self-Sovereign Identity experts from the community to edit the book and test our code

Designer: We have relationships with several awesome designers and we expect the book to have an original and beautiful look.

Spanish Translation: Roberto Carvajal

Example Code:

• TypeScript: Roberto Carvajal
• iOS / Mac / Swift: Jon Bauer
• Android / Kotlin: Jon Bauer / Roberto Carvajal
• API / Cloud Agent: Roberto Carvajal

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

Writing / Editing: 66,722 ADA / ~$30,000 - ($15,000 per author)

Spanish Translation: 11,000 ADA / ~$5,000

Technical Editor Fee: 13,344 ADA / ~$6,000 - ($1,500 x4 editors)

Example Project Development:

• Swift / iOS / Mac: 22,240 ADA / ~$10,000
• TypeScript: 22,240 ADA / ~$10,000
• Kotlin / Android: 22,240 ADA / ~$10,000
• API Server / Client: 22,240 ADA / ~$10,000

Book Cover Design / Layout / Illustrations: 13,344 ADA / ~$6,000

Website / Domain Name / Hosting: 2,224 ADA / ~$1,000

Marketing / Misc: 4,406 ADA / ~$2,000

Total: 200,000 ADA / ~$89,000 USD at current rates

*We are aware the price of ADA could rise or fall during the life of the project. Budgets in USD are approximate based on the value of ADA. Total ADA budget will not exceed 200k. We will pay vendors in USD unless ADA is preferred

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

This is a highly technical document, and includes example source code in multiple languages and platforms. We believe we are budgeting a reasonable amount for each project, considering the freelance value of each effort could be much higher. The code will be given away freely under a permissive license so at the very least, the community will be able to modify and use it in their projects if they wish.

We are currently building a large-scale, production quality project with Open Enterprise Agent which will launch in early 2024. The book will detail all the gotchas we encounter and our solutions. We believe this book will save other developers both time and money when building with Open Enterprise Agent.

Receiving Catalyst funding will allow us to make the text and example code available to the community for free.

[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