Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Grant Proposal for Antelope Developers Guidebook targeted at Javascri… #253

Closed
wants to merge 2 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added .DS_Store
Binary file not shown.
192 changes: 192 additions & 0 deletions applications/js_dev_guidebook.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,192 @@
# EOS Network Foundation Grant Proposal

- **Project Name:** Antelope Developers Guidebook

- **Team Name:** Douglas Butner

- **EOS Payment Address:** ice

- **[Level](https://github.com/eosnetworkfoundation/grant-framework#grant-levels):** 1

- **Pomelo Grant(s):** N/A

- **Project is Open-Source:** Yes

- **Project was part of Token sale:** No

- **Repository where Project resides:** https://antbook.douglas.life/


## Contact

- **Contact Name:** Douglas Butner

- **Contact Email:** [email protected]

- **Website:** https://douglas.life


## Project Overview

Douglas Butner wants to bring Javascript developers to the Antelope ecosystem with a hands-on, practical guide that will offer a guiding light to illuminate Antelope's potential over other layer-1 network solutions.

This guide will show developers who aren't C++ geniuses how they can interact with smart contracts without leaving Javascript, and provide useful code snippets. A newcomer will be able to execute testnet transactions from their local machine within minutes of opening the guide, cultivating excitement to complete the guidebook and further engage with the Antelope ecosystem.

Any skill-level of Javascript developer will feel comfortable building in the Antelope / EOSIO ecosystem after reading this guidebook.


Douglas's guide will compliment the highly-technical ["EOSIO Smart Contract Developer's Handbook"](dev_book.md) already funded by the ENF, which provides a deep technical understanding for serious blockchain developers, but may be over the heads of many less-experienced devs, all levels of javascript devs, and product owners considering the EOSIO / Antelope ecosystem.



### Overview

- **Name:** Antelope Developers Guidebook

- **Brief Description:** A guidebook for Javascript developers to get up and running quickly with Antelope-based blockchains

- **Relationship to EOSIO:** The guidebook serves to onboard the massive Javascript developer community to EOSIO- and Antelope-based blockchains.

- **Reason for Interest:** Douglas is a prolific javascript developer, passionate teacher and unwaveringly enthusiastic promoter of EOSIO and Antelope technology.


### Project Details

The guidebook, built on Gitbook, is targeting all-levels of Javascript developers who want to:
1) Get up and running quickly by:
a) reading from the blockchain via public APIs
b) sending transactions on EOSIO- and Antelope-based blockchains
2) Understand the ecosystem, including APIs, and popular projects like Atomic Assets.
3) Rapidly develop Antelope-native dapps from available open-source contracts.


Topics to be covered within this grant application:

- Introducing various APIs for reading and writing on-chain data, catering to the needs and background of Javascript developers

- Providing links to the lists of public endpoints for the different Antelope-based blockchains

- Reading the token balance from a specific user, top holders of a coin

- Reading information from any table

- Sending a transfer transaction using Javascript

- Updating mutable data of a NFT using Javascript

- Using Javascript to schedule transactions in the future or on a recurring basis

- Creating a permission structure and using a private key with limited permissions to be used in an environment variable in Javascript

- Briefly reviewing and comparing available open-source contracts

- Compiling and launching an open-source C++ smart contract



Additional topics for future grant applications:

- Examining the differences between popular Antelope chains

- Using oracles to fetch outside information

- Using RNGs (random number generators) and other useful game mechanics

- Explaining the steps to listing a novelty token on a DEX, and opening a swap pool

- Detailed example for a staking contract for NFTs

- Detailed example of a staking contract for eosio.token-compatible fungible tokens

- A detailed explanation of practical use cases involving open-source contracts





### Ecosystem Fit

We supplement the existing [EOSIO Smart Contract Developer's Handbook](dev_book.md) and improve the overall ecosystem by providing an easier, shorter on-ramp to a becoming an Antelope developer. We aim for little to no overlap between with the EOSIO Smart Contract Developer's Handbook, and will link to it where appropriate.

This guidebook honors Antelope's best-in-market core technology by highlighting the performance and ease of development from the perspective of an experienced developer, in the voice of a trusted teacher.

This guidebook will shift focus towards the core protocol, striking a balance with the recent attention garnered by the EVM.

By showing developers how easy it is to interact directly with the blockchain without leaving Javascript, we believe we can bring new developers, projects, and economic value to the ecosystem.



## Team

### Team members

- **Team Leader:**

- Douglas Butner is the owner of sofware company Current X Change LLC, and builder of [cXc.world](http://linktr.ee/cXc.world) and the related technology. He is responsible for writing and revising the Antelope Developers Guidebook, and will provide samples from his tested code as part of the guidebook. His experience is listed below.

### Legal Structure
- **Registered Legal Entity:** Douglas James Butner
- **Registered Address:** 489 Collier Rd, Accident, Maryland 21520, USA

### Team Experience

Douglas has built a 9-year reputation as an online teacher, with over [50,000 students and 1,600 reviews on Udemy](https://www.udemy.com/user/douglasbutner/).

Douglas has been part of the EOSIO / Antelope ecosystem since moving his project [cXc](https://linktr.ee/cXc.world) from Hive to WAX in 2021. Douglas has 15 years as a javascript developer, launching his first full-stack app at age 16.

Douglas has experience writing technical documents in Markdown format, writing the [Purple Explainer](https://github.com/currentxchange/purple-explainer) and [Web4 Manifesto](https://github.com/dougbutner/web-4) and is now proficient in Gitbook.

### Team Org Repos

N/A (see Team Member Repos)

### Team Member Repos

- Douglas Butner: https://github.com/dougbutner

### Team LinkedIn Profiles (if available)

- https://www.linkedin.com/in/douglasbutner/

## Development Status

To gain the needed expertise, Douglas has built a [top-100 NFT collectors rewards system](https://waxblock.io/account/nfts.cxc) and a [leveled-NFT staking solution with fungible token rewards](https://waxblock.io/account/everpay.cxc) both dispatched from Javascript.

Douglas has started to compile useful but hard-to-find information for developers like [headers](https://github.com/TetraGrids/ANT-headers) and [smart contracts organized by utility](https://github.com/dougbutner/ANTools).

Douglas has opened the Gitbook on https://antbook.douglas.life/ pending grant approval for further work.

## Development Roadmap

### Overview

- **Total Estimated Duration:** 1 month
- **Full-Time Equivalent (FTE):** 0.5
- **Total Costs:** USD 10,000

### Milestone 1 — Writing and Publishing the guidebook

- **Estimated duration:** 1 month
- **FTE:** 0.5
- **Costs:** 10,000 USD

| Number | Deliverable | Specification |
| -----: | ----------- | ------------- |
| 0a. | License | Creative Commons BY-SA 4.0 |
| 0b. | Documentation | N/A |
| 0c. | Testing Guide | N/A |
| 1. | Exciting Introduction | We will start with examples to read and write to the blockchain, including copy-pastable code snippets |
| 2. | Core Guidebook | This will cover all the topics listed above in a Gitbook-based guidebook, including practical advice, code samples, and links to resources. |
| 3. | Finalizing and Feedback | Proofreading, checking details and links, asking for feedback in the related developer Telegram channels; Antelope Developers, Telos Dapp Development and WAX Developers |
| 4. | Publishing book | Launching the Gitbook and making announcements on WAX Developers, Telos Dapp Development, and Antelope Developers' Telegrams. Publishing at least three sections of the book on Douglas's personal Medium and Hive, and extending invitations to the ENF and other interested parties for potential publication or reposting. |




## Future Plans

I will continue to expand the guidebook, adding more topics and examples as listed above. I will continue to promote the book, and encourage others to link to it to help as many developers as possible.

## Additional Information

**How did you hear about the Grants Program?** [Telegram](https://t.me/antelopedevs)