Getting started with Dapp (#34)

Co-authored-by: Alexander Theißen <[email protected]>

Author: pgherveou

docs/known_issues/index.md

@@ -62,6 +62,13 @@ REMIX `0.54-dev`
 
 - Transaction Fails or Resolve Stuck or Pending Transactions: Go to Settings -> Advanced in MetaMask and select [Clear activity tab data](https://support.metamask.io/managing-my-wallet/resetting-deleting-and-restoring/how-to-clear-your-account-activity-reset-account/#to-reset-the-account).
 
+## JSON-RPC
+
+### Missing features
+
+- The list of supported methods is [here](https://github.com/paritytech/polkadot-sdk/blob/master/substrate/frame/revive/rpc/src/rpc_methods_gen.rs); notably, `eth_trace` endpoints are not supported yet.
+- EVM transaction have a transaction hash that is different from the Substrate transaction hash, as a consequence, it does work out of the box with Substrate block explorers, this is a known issue and will be fixed in the near future.
+
 ### Not Tested
 
 - Plugins Functionality: We have not yet conducted tests on the GitHub, DGIT DIFF, SOURCIFY, SWARM and IPFS plugins. Users should proceed with caution when using these features until further validation is completed.

docs/tutorial/3-build-your-first-dapp.md

@@ -0,0 +1,13 @@
+---
+sidebar_position: 3
+slug: /build-your-first-dapp
+---
+
+# Build Your First Dapp
+
+To get started with building a Decentralized Application (Dapp), clone the following repository and follow the README instructions: [https://github.com/paritytech/contracts-boilerplate](https://github.com/paritytech/contracts-boilerplate).
+
+The repository contains two boilerplates:
+
+1. **React and Ether.js**: This boilerplate uses React and Ether.js, a well-established library for interacting with Solidity contracts.
+2. **Modern TypeScript with wagmi**: This boilerplate offers a more modern approach, fully typed, and includes powerful React hooks provided by wagmi.

docs/tutorial/3-getting-started-with-ethers.js.md

@@ -22,11 +22,12 @@ how to call this contract.
 
 ## Deploy the template
 
-You can use ether.js to deploy the Rust contract. We [covered that](/getting-started-with-ethers.js#deploy-a-contract)
-earlier in the tutorial. You skip the compilation step and pass the raw `contract.polkavm` as bytecode:
+You can use [ether.js](https://www.npmjs.com/package/ethers) to deploy the Rust contract.
+Pass the raw `contract.polkavm` as bytecode:
 
 ```ts
 import { ContractFactory } from 'ethers'
+import { readFileSync } from 'fs'
 
 /// We specify the abi manually since the Rust compiler won't generate one for us
 const abi = ["constructor()", "function fibonacci(uint) view returns(uint)"];