[
{
"path": ".gitignore",
"content": "node_modules\n.env\nsecret.json\n\n# Hardhat files\n/cache\n/artifacts\n\n# TypeChain files\n/typechain\n/typechain-types\n\n# solidity-coverage files\n/coverage\n/coverage.json\n\n# Hardhat Ignition default folder for deployments against a local node\nignition/deployments/chain-31337\n\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/.babelrc",
"content": "{\n \"presets\": [\n \"@babel/preset-env\",\n [\"@babel/preset-react\", { \"runtime\": \"automatic\" }],\n \"@babel/preset-typescript\"\n ]\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/.editorconfig",
"content": "root = true\n\n[*]\nindent_style = spaces\nindent_size = 2\nend_of_line = lf\ncharset = utf-8\ntrim_trailing_whitespace = true\ninsert_final_newline = true\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/.eslintrc",
"content": "{\n \"env\": {\n \"browser\": true,\n \"es2020\": true,\n \"jest\": true,\n \"node\": true\n },\n \"settings\": {\n \"react\": {\n \"version\": \"detect\"\n }\n },\n \"extends\": [\n \"eslint:recommended\",\n \"plugin:react/recommended\",\n \"plugin:@typescript-eslint/eslint-recommended\",\n \"plugin:@typescript-eslint/recommended\",\n \"plugin:prettier/recommended\",\n \"plugin:tailwindcss/recommended\"\n ],\n \"parser\": \"@typescript-eslint/parser\",\n \"parserOptions\": {\n \"ecmaFeatures\": {\n \"jsx\": true\n },\n \"ecmaVersion\": 11,\n \"sourceType\": \"module\"\n },\n \"plugins\": [\"react\", \"react-hooks\", \"@typescript-eslint\", \"tailwindcss\"],\n \"rules\": {\n \"react-hooks/rules-of-hooks\": \"error\",\n \"react-hooks/exhaustive-deps\": \"warn\",\n \"react/prop-types\": \"off\",\n \"react/react-in-jsx-scope\": \"off\",\n \"@typescript-eslint/explicit-module-boundary-types\": \"off\",\n \"@typescript-eslint/no-non-null-assertion\": \"off\",\n \"tailwindcss/classnames-order\": \"warn\",\n \"tailwindcss/no-custom-classname\": \"warn\",\n \"tailwindcss/no-contradicting-classname\": \"error\"\n }\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/.gitignore",
"content": "dist\ndist-ssr\n*.local\n\n# dependencies\n/node_modules\n/.pnp\n.pnp.js\n\n# testing\n/coverage\n\n# next.js\n/.next/\n/out/\n\n# production\n/build\n\n# misc\n.DS_Store\n*.pem\n\n# debug\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n\n# local env files\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\n\n# vercel\n.vercel\n.vscode\n\npackage-lock.json\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/.jest/setup.ts",
"content": "import '@testing-library/jest-dom'\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/.prettierrc",
"content": "{\n \"trailingComma\": \"none\",\n \"semi\": false,\n \"singleQuote\": true\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/README.md",
"content": "# Simple Storage dApp on Core\nDecentralized applications (dApps) use a blockchain or on-chain smart contracts to store and reference data, rather than relying on traditional centralized databases. A common, simple dApp structure generally consists of a React.js or Vue.js front-end using Web3.js or Ethers.js to interact with smart contracts deployed to an EVM-compatible blockchain.\n\n## What Are We Building\nIn this tutorial, we'll develop a simple dApp using React.js and Ethers.js that stores data in a smart contract on the Core blockchain and displays it to users. It also has the functionality to retrieve the stored number and display it to the user.\n\n## Learning Takeaways\nThis tutorial will help you gain knowledge on the following learning points:\n\n* MetaMask Wallet connectivity to Core Testnet;\n* Smart contract development and deployment on Core Testnet;\n* Front-end integration with the smart contract using Ethers.js library;\n* Read data from a smart contract;\n* Write data to a smart contract;\n\n## Software Prerequisites\n* [Git](https://git-scm.com/) v2.44.0\n* [Node.js](https://nodejs.org/en) v20.11.1\n* [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) v10.2.4\n* [Hardhat](https://hardhat.org/hardhat-runner/docs/getting-started#installation) v10.2.4\n* [MetaMask Web Wallet Extension](https://metamask.io/download/)\n\n## Setting up the development environment\n\n1. Create a new directory for the project and navigate into it\n\n```bash\nmkdir dapp-\ncd dapp-tutorial\n```\n2. Install [Hardhat](https://hardhat.org/) and [Waffle](https://getwaffle.io/)\n\n```bash\nnpm init --yes\nnpm install --save-dev hardhat\nnpm install --save-dev chai @nomiclabs/hardhat-waffle\n```\n3. Initialize Hardhat project by running the following command\n\n```bash\nnpx hardhat\n```\n\n\n:::note\nAs we will using Waffle for this project and make sure to select **No** for the option \"_Do you want to install this sample project's dependencies with npm (@nomicfoundation/hardhat-toolbox)? (Y/n)_\"\n:::\n\n4. Once this project is initialized, you'll find the following project structure:\n\n```bash\ndapp-tutorial.\n| .gitignore\n| hardhat-config.js (HardHat configuration file.)\n| package-lock.json\n| package.json\n| README.md\n| \n+---contracts (For Solidity Smart Contracts)\n| Lock.sol\n| \n+---ignition (Scripts in previous versions, contains config files that specify how smart contracts should be deployed)\n| \\---modules\n| Lock.js\n| \n+---node_modules\n| \n+---test (For writing and Running Tests)\n| Lock.js \n| \n```\n\n5. Install and configure MetaMask Chrome Extension to use with Core Testnet. Refer [here](https://docs.coredao.org/docs/Dev-Guide/core-testnet-wallet-config) for a detailed guide.\n\n6. Create a secret.json file in the root folder and store the private key of your MetaMask wallet in it. Refer [here](https://metamask.zendesk.com/hc/en-us/articles/360015290032-How-to-reveal-your-Secret-Recovery-Phrase) for details on how to get MetaMask account's private key.\n\n```json\n{\"PrivateKey\":\"you private key, do not leak this file, do keep it absolutely safe\"}\n```\n\n:::caution\nDo not forget to add this file to the `.gitignore` file in the root folder of your project so that you don't accidentally check your private keys/secret phrases into a public repository. Make sure you keep this file in an absolutely safe place!\n:::\n\n\n7. Copy the following into your `hardhat.config.js` file\n\n```js\n/**\n * @type import('hardhat/config').HardhatUserConfig\n */\n\n require('@nomiclabs/hardhat-ethers');\n require(\"@nomiclabs/hardhat-waffle\");\n\n const { PrivateKey } = require('./secret.json');\n\n module.exports = {\n defaultNetwork: 'testnet',\n \n networks: {\n hardhat: {\n },\n testnet: {\n url: 'https://rpc.test.btcs.network',\n accounts: [PrivateKey],\n chainId: 1115,\n }\n },\n solidity: {\n compilers: [\n {\n version: '0.8.9',\n settings: {\n evmVersion: 'paris',\n optimizer: {\n enabled: true,\n runs: 200,\n },\n },\n },\n ],\n },\n paths: {\n sources: './contracts',\n cache: './cache',\n artifacts: './artifacts',\n },\n mocha: {\n timeout: 20000,\n },\n };\n \n```\n\n## Writing Smart Contract\n\n1. Navigate to the `contracts` folder in the root directory of your project.\n2. Delete the `Lock.sol` file; create a new file `Storage.sol` and paste the following contents into it.\n\n```javascript\n// SPDX-License-Identifier: GPL-3.0\n\npragma solidity >=0.7.0 <0.9.0;\n\n/**\n * @title Storage\n * @dev Store & retrieve value in a variable\n */\ncontract Storage {\n\n uint256 number;\n\n /**\n * @dev Store value in variable\n * @param num value to store\n */\n function store(uint256 num) public {\n number = num;\n }\n\n /**\n * @dev Return value \n * @return value of 'number'\n */\n function retrieve() public view returns (uint256){\n return number;\n }\n}\n```\n### Explanation\nThe `Storage` contract is a simple example that demonstrates how to store and retrieve a value using a Solidity smart contract. It consists of a state variable to hold the value and two functions to update and read this value. The `store` function allows any user to set the value, while the `retrieve` function allows any user to read the current value. This contract can be useful for understanding the basics of state variables and function visibility in Solidity. This Solidity smart contract, named `Storage`, is a simple contract that allows storing and retrieving a single `uint256` value. Here’s a detailed breakdown of its components and functionality:\n\n#### Contract Components\n\n1. **State Variable**:\n - `number`: A `uint256` variable that is used to store the value.\n\n#### Contract Functions\n\n1. **Store Function**:\n - `store(uint256 num) public`: A function that allows users to store a new value in the `number` variable. This function takes a single parameter, `num`, which is the value to be stored. The function updates the `number` variable with the provided value.\n - **Visibility**: The function is marked as `public`, meaning it can be called by any user or contract.\n - **State Change**: This function modifies the state of the contract by updating the `number` variable.\n\n2. **Retrieve Function**:\n - `retrieve() public view returns (uint256)`: A function that returns the current value stored in the `number` variable. This function does not take any parameters and returns a `uint256` value.\n - **Visibility**: The function is marked as `public`, meaning it can be called by any user or contract.\n - **View**: The function is marked as `view`, indicating that it does not modify the state of the contract. It only reads the state.\n - **Return Value**: The function returns the value of the `number` variable.\n\n\n## Compiling Smart Contract\n\n1. To compile the `Storage` smart contract defined in the `Storage.sol`, from the root directory run the following command\n\n```bash\nnpx hardhat compile\n```\n\n## Deploy and Interact with Smart Contract\n\n1. Before deploying your smart contract on the Core Chain, it is best adviced to first run a series of tests making sure that the smart contract is working as desired. Refer to the detailed guide [here](https://docs.coredao.org/docs/Dev-Guide/hardhat#contract-testing) for more details.\n\n2. Create a `scripts` folder in the root directory of your project. Inside this folder, create a file `deploy-and-call.js`; paste the following script into it.\n\n```javascript\nconst hre = require(\"hardhat\");\n\nasync function main() {\n const Storage = await hre.ethers.getContractFactory(\"Storage\");\n const storage = await Storage.deploy();\n\n await storage.deployed();\n console.log(\"Storage contract deployed to:\", storage.address);\n\n console.log(\"call retrieve():\", await storage.retrieve())\n\n console.log(\"call store(), set value to 100\")\n const tx = await storage.store(100)\n await tx.wait()\n \n console.log(\"call retrieve() again:\", await storage.retrieve())\n}\n\n// We recommend this pattern to be able to use async/await everywhere\n// and properly handle errors.\nmain().catch((error) => {\n console.error(error);\n process.exitCode = 1;\n});\n```\n3. Make sure your MetaMask wallet has tCORE test tokens for the Core Testnet. Refer [here](https://docs.coredao.org/docs/Dev-Guide/core-faucet) for details on how to get tCORE tokens from Core Faucet. \n\n4. Run the following command from the root directory of your project, to deploy your smart contract on the Core Chain.\n\n```bash\nnpx hardhat run scripts/deploy-and-call.js\n```\n\nIf succesfully deployed, you will get the following output\n\n```bash\n>npx hardhat run scripts/deploy-and-call.js\nStorage contract deployed to: 0x9e1326fB351FbC4efaa88F0040708F0C0d315109\ncall retrieve(): BigNumber { value: \"0\" }\ncall store(), set value to 100\ncall retrieve() again: BigNumber { value: \"100\" }\n```\n5. Make sure to save the Address of Storage Contract at which is deployed, as obtained above, this will be used for interacting with smart contract from the dApp's frontend.\n\n🎉 Congratulations! You have successfully learned how to create, compile, and deploy a smart contract on the Core Chain Testnet using the Hardhat. \n\n## Interacting with Smart Contract through Frontend\n\n⚡️ Let's create a frontend interface for interacting with the smart contract.\n\n### Setting up Frontend\n\n1. Clone the `dApp-tutorial` repository from GitHub using the following command.\n\n```bash\ngit clone https://github.com/coredao-org/dapp-tutorial.git\n```\n\n2. Navigate into the folder `01-Basic Full Stack Dapp on Core` in the cloned `dapp-tutorial` repo.\n\n```bash\ncd dapp-tutorial\ncd \"01-Basic Full Stack Dapp on Core\"\n```\n\n3. Install all the dependencies, i.e., node modules.\n\n```bash\nnpm install\n```\n\n4. To test if things are working fine, run the application by using the following command. This will serve applciation with hot reload feature at [http://localhost:5173](http://localhost:5173/)\n\n```bash\nnpm run dev\n```\n\n### Key Implementations\nThe application's key blockchain logic is implemented in [App.tsx](https://github.com/coredao-org/dapp-tutorial/blob/master/01-Simple%20Storage%20Full%20Stack%20Dapp/src/components/App.tsx)\n\n\n1. [App.tsx (Wallet)](https://github.com/coredao-org/dapp-tutorial/blob/master/01-Simple%20Storage%20Full%20Stack%20Dapp/src/components/App.tsx#L20): logic for connecting the application to MetaMask wallet.\n2. [App.tsx (Store)](https://github.com/coredao-org/dapp-tutorial/blob/master/01-Simple%20Storage%20Full%20Stack%20Dapp/src/components/App.tsx#L58): logic to write data to the Storage smart contract.\n3. [App.tsx (Retrieve)](https://github.com/coredao-org/dapp-tutorial/blob/master/01-Simple%20Storage%20Full%20Stack%20Dapp/src/components/App.tsx#L87): logic to read data from the Storage smart contract.\n\n\n### Adding Smart Contract Details \n1. Copy the `Storage.sol` file from the `contracts` folder in the root of oyur project and paste it into the `frontend/src/contracts` folder. \n2. Copy the address of the Storage smart contract as obtained in the section [above](#deploy-and-interact-with-smart-contract).\n3. Paste this into [Line 10 of App.tsx](https://github.com/coredao-org/dapp-tutorial/blob/master/01-Simple%20Storage%20Full%20Stack%20Dapp/src/components/App.tsx#L10). \n\n```javascript\nconst contractAddress = '0x48F68BF4A1b1fE6589B9D0a5ad0dF0520582edA2'\n```\n\n4. Additionally, we'll need the ABI metadata to interact with the contract from our dApp. From the `artifacts/contracts` folder in the root of your project. Copy the `Storage.json` file and save it to the `/src/contracts` folder.\n\n## Test Locally Using MetaMask\n\n1. Run the command `npm run dev` from teh root of the project to start the application. This will serve applciation with at [http://localhost:5173](http://localhost:5173/)\n\n2. Make sure that your MetaMask wallet is correctly installed and switched to Core Testnet as described in our [Core Testnet user guide](https://docs.coredao.org/docs/Dev-Guide/core-testnet-wallet-config). You'll also need to connect your MetaMask wallet to the local site.\n\n\n\n3. Enter a number in the input field and click the **store** button to save it to the contract. A write action on the smart contract invokes the MetaMask wallet. Click the **Confirm** button to sign the transaction and wait for confirmation on the blockchain.\n\n\n\n4. After the transaction is confirmed on the blockchain, click the **retrieve** button to read the value from the smart contract. You will notice the value has been updated.\n\n\n\n🎉 Congratulations! You've just interacted with your newly-deployed contract using your dApp's front end! You can build on the codebase by deploying and interacting with different contracts, and by adding new UI components to the website for your users.\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/index.html",
"content": "\n\n \n \n \n \n Core DAO Dapp tutorial\n \n \n \n \n \n\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/jest.config.js",
"content": "module.exports = {\n testEnvironment: 'jsdom',\n testPathIgnorePatterns: ['/node_modules/'],\n collectCoverage: true,\n collectCoverageFrom: ['src/**/*.ts(x)'],\n setupFilesAfterEnv: ['/.jest/setup.ts'],\n modulePaths: ['/src/', '/.jest']\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/package.json",
"content": "{\n \"name\": \"Tutorial\",\n \"description\": \"This tutorial provides a step-by-step guide on how to store and retrieve data from the Core blockchain.\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"scripts\": {\n \"dev\": \"vite\",\n \"build\": \"tsc && vite build\",\n \"serve\": \"vite preview\",\n \"test\": \"jest\",\n \"lint\": \"eslint src --max-warnings=0\",\n \"typecheck\": \"tsc --project tsconfig.json --noEmit\"\n },\n \"dependencies\": {\n \"ethers\": \"5.6.9\",\n \"react\": \"18.2.0\",\n \"react-dom\": \"18.2.0\"\n },\n \"devDependencies\": {\n \"@babel/core\": \"7.18.6\",\n \"@babel/preset-env\": \"7.18.6\",\n \"@babel/preset-react\": \"7.18.6\",\n \"@babel/preset-typescript\": \"7.18.6\",\n \"@testing-library/jest-dom\": \"5.16.4\",\n \"@testing-library/react\": \"13.3.0\",\n \"@types/jest\": \"28.1.6\",\n \"@types/node\": \"18.0.5\",\n \"@typescript-eslint/eslint-plugin\": \"5.30.6\",\n \"@typescript-eslint/parser\": \"5.30.6\",\n \"@vitejs/plugin-react\": \"2.0.0\",\n \"autoprefixer\": \"10.4.7\",\n \"babel-jest\": \"28.1.3\",\n \"eslint\": \"8.20.0\",\n \"eslint-config-prettier\": \"8.5.0\",\n \"eslint-plugin-prettier\": \"4.2.1\",\n \"eslint-plugin-react\": \"7.30.1\",\n \"eslint-plugin-react-hooks\": \"4.6.0\",\n \"eslint-plugin-tailwindcss\": \"3.6.0\",\n \"jest\": \"28.1.3\",\n \"jest-environment-jsdom\": \"28.1.3\",\n \"postcss\": \"8.4.14\",\n \"prettier\": \"2.7.1\",\n \"tailwindcss\": \"3.1.6\",\n \"typescript\": \"4.7.4\",\n \"vite\": \"3.0.0\",\n \"vite-tsconfig-paths\": \"3.5.0\"\n }\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/postcss.config.js",
"content": "module.exports = {\n plugins: {\n tailwindcss: {},\n autoprefixer: {}\n }\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/src/components/App.tsx",
"content": "/* eslint-disable tailwindcss/no-custom-classname */\n/* eslint-disable tailwindcss/classnames-order */\n/* eslint-disable react/no-unescaped-entities */\n\nimport { useEffect, useState } from 'react'\nimport { ethers } from 'ethers'\nimport storage from '../contract/Storage.json'\n\n// Contract information\nconst contractAddress = '0x9e1326fB351FbC4efaa88F0040708F0C0d315109'\nconst abi = storage.abi\n\n// Constants\nconst CORESCAN_BASE_URL = 'https://scan.test2.btcs.network/address/'\n\nfunction App() {\n const [currentAccount, setCurrentAccount] = useState(null)\n const [storeNumber, setStoreNumber] = useState('')\n const [retrievedNumber, setRetrievedNumber] = useState('')\n const checkWalletIsConnected = async () => {\n const { ethereum } = window\n\n if (!ethereum) {\n console.log('Make sure you have Metamask installed!')\n return\n } else {\n console.log(\"Wallet exists! We're ready to go!\")\n }\n\n const accounts = await ethereum.request({ method: 'eth_accounts' })\n\n if (accounts.length !== 0) {\n const account = accounts[0]\n console.log('Found an authorized account: ', account)\n setCurrentAccount(account)\n } else {\n console.log('No authorized account found')\n }\n }\n\n const connectWalletHandler = async () => {\n const { ethereum } = window\n\n if (!ethereum) {\n alert('Please install Metamask!')\n }\n\n try {\n const accounts = await ethereum.request({ method: 'eth_requestAccounts' })\n console.log(accounts[0])\n console.log('Found an account! Address: ', accounts[0])\n setCurrentAccount(accounts[0])\n } catch (err) {\n console.log(err)\n }\n }\n\n const store = async () => {\n try {\n const { ethereum } = window\n\n if (ethereum) {\n const provider = new ethers.providers.Web3Provider(ethereum)\n const signer = provider.getSigner()\n const storageContract = new ethers.Contract(\n contractAddress,\n abi,\n signer\n )\n\n console.log('Write to contract')\n const tx = await storageContract.store(storeNumber)\n\n console.log('Wait for the transaction to be confirmed')\n await tx.wait()\n\n console.log(\n `Transaction confirmed: https://scan.test2.btcs.network/tx/${tx.hash}`\n )\n } else {\n console.log('Ethereum object does not exist')\n }\n } catch (err) {\n console.log(err)\n }\n }\n const retrieve = async () => {\n try {\n const { ethereum } = window\n\n if (!ethereum) {\n console.log('Ethereum object does not exist')\n alert('Please install MetaMask!')\n return\n }\n\n // Check if wallet is connected\n if (!currentAccount) {\n alert('Please connect your wallet first!')\n return\n }\n\n const provider = new ethers.providers.Web3Provider(ethereum)\n \n // Check if we're on the correct network\n const network = await provider.getNetwork()\n console.log('Connected to network:', network)\n \n // Verify we're on Core Testnet (Chain ID: 1115)\n if (network.chainId !== 1114) {\n alert('Please switch to Core Testnet in MetaMask!')\n return\n }\n\n // Check if contract exists at the address\n const code = await provider.getCode(contractAddress)\n if (code === '0x') {\n throw new Error(`No contract found at address ${contractAddress}`)\n }\n\n // For view functions, use provider instead of signer\n const storageContract = new ethers.Contract(\n contractAddress,\n abi,\n provider\n )\n\n console.log('Reading from contract...')\n setRetrievedNumber('Loading...')\n \n const res = await storageContract.retrieve()\n const retrievedValue = res.toString()\n \n console.log('Retrieved value:', retrievedValue)\n setRetrievedNumber(retrievedValue)\n \n } catch (err) {\n console.error('Error retrieving data:', err)\n setRetrievedNumber('Error')\n \n if ((err as Error).message.includes('No contract found')) {\n alert('Contract not found! Please check the contract address.')\n } else if ((err as Error).message.includes('network')) {\n alert('Network error! Please check your connection.')\n } else {\n alert(`Error: ${(err as Error).message}`)\n }\n }\n }\n\n const connectWalletButton = () => {\n return (\n \n Connect Wallet\n \n )\n }\n\n const storageButton = () => {\n return (\n
\n
\n Click \"write\" or \"read\" to call the smart contract\n
\n How to connect\n \n MetaMask to Core Testnet\n \n
\n
\n
\n )\n}\n\nexport default App\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/src/contract/Storage.json",
"content": "{\n\t\"abi\": [\n\t\t{\n\t\t\t\"inputs\": [],\n\t\t\t\"name\": \"retrieve\",\n\t\t\t\"outputs\": [\n\t\t\t\t{\n\t\t\t\t\t\"internalType\": \"uint256\",\n\t\t\t\t\t\"name\": \"\",\n\t\t\t\t\t\"type\": \"uint256\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"stateMutability\": \"view\",\n\t\t\t\"type\": \"function\"\n\t\t},\n\t\t{\n\t\t\t\"inputs\": [\n\t\t\t\t{\n\t\t\t\t\t\"internalType\": \"uint256\",\n\t\t\t\t\t\"name\": \"num\",\n\t\t\t\t\t\"type\": \"uint256\"\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"name\": \"store\",\n\t\t\t\"outputs\": [],\n\t\t\t\"stateMutability\": \"nonpayable\",\n\t\t\t\"type\": \"function\"\n\t\t}\n\t]\n}"
},
{
"path": "01-Simple Storage Full Stack Dapp/src/contract/Storage.sol",
"content": "// SPDX-License-Identifier: GPL-3.0\n\npragma solidity ^0.8.7;\n\n/**\n * @title Storage\n * @dev Store & retrieve value in a variable\n * @custom:dev-run-script ./scripts/deploy_with_ethers.ts\n */\ncontract Storage {\n\n uint256 number;\n\n /**\n * @dev Store value in variable\n * @param num value to store\n */\n function store(uint256 num) public {\n number = num;\n }\n\n /**\n * @dev Return value \n * @return value of 'number'\n */\n function retrieve() public view returns (uint256){\n return number;\n }\n}"
},
{
"path": "01-Simple Storage Full Stack Dapp/src/index.tsx",
"content": "import { createRoot } from 'react-dom/client'\nimport 'tailwindcss/tailwind.css'\nimport './style/index.css'\nimport App from 'components/App'\n\nconst container = document.getElementById('root') as HTMLDivElement\nconst root = createRoot(container)\n\nroot.render()\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/src/style/index.css",
"content": "@tailwind base;\n@tailwind components;\n@tailwind utilities;\n\n@layer components {\n\t:root{\n\n\t}\n .btn-primary {\n @apply py-2 px-4 bg-orange-500 text-white font-semibold rounded-lg shadow-md hover:bg-orange-700 focus:outline-none focus:ring-2 focus:ring-blue-400 focus:ring-opacity-75;\n }\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/src/utils/index.ts",
"content": "export function classNames(...classes: unknown[]): string {\n return classes.filter(Boolean).join(' ')\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/src/vite-env.d.ts",
"content": "/* eslint-disable @typescript-eslint/no-explicit-any */\n/// \n\n/// \ninterface Window {\n ethereum: any\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/tailwind.config.js",
"content": "/** @type {import('tailwindcss').Config} */\n\nmodule.exports = {\n content: ['./src/**/*.{js,ts,jsx,tsx}'],\n theme: {\n extend: {},\n\n },\n plugins: []\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/tsconfig.json",
"content": "{\n \"compilerOptions\": {\n \"baseUrl\": \"./src\",\n \"target\": \"esnext\",\n \"lib\": [\"dom\", \"dom.iterable\", \"esnext\"],\n \"allowJs\": true,\n \"skipLibCheck\": true,\n \"esModuleInterop\": true,\n \"allowSyntheticDefaultImports\": true,\n \"strict\": true,\n \"forceConsistentCasingInFileNames\": true,\n \"module\": \"esnext\",\n \"moduleResolution\": \"node\",\n \"resolveJsonModule\": true,\n \"isolatedModules\": true,\n \"noEmit\": true,\n \"jsx\": \"react-jsx\"\n },\n \"include\": [\"src\"],\n \"exclude\": [\"node_modules\"]\n}\n"
},
{
"path": "01-Simple Storage Full Stack Dapp/vite.config.ts",
"content": "import { defineConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\nimport tsconfigPaths from 'vite-tsconfig-paths'\n\n// https://vitejs.dev/config/\nexport default defineConfig({\n plugins: [react(), tsconfigPaths()]\n})\n"
},
{
"path": "02-Basic Staking Full Stack Dapp/.gitignore",
"content": "node_modules\n.env\nsecret.json\n\n# Hardhat files\n/cache\n/artifacts\n\n# TypeChain files\n/typechain\n/typechain-types\n\n# solidity-coverage files\n/coverage\n/coverage.json\n\n# Hardhat Ignition default folder for deployments against a local node\nignition/deployments/chain-31337\n\n\n"
},
{
"path": "02-Basic Staking Full Stack Dapp/README.md",
"content": "# Building a Staking Dapp on Core \n\n## What are we building\nWelcome to this tutorial on building a simple staking dApp on the Core blockchain. In this guide, we'll walk through the process of creating a basic staking dApp that allows users to stake, unstake, and claim rewards. By the end of this tutorial, you'll have a functional dApp that interacts with smart contracts on the Core Testnet. \nIn this staking dapp, 2 custom ERC20 tokens are used namely, `Staking Token - STK` and `Reward Token - RTK`. While, `STK` is used for staking, the `RTK` token is used for rewarding the users for staking their `STK` tokens.\n\n## Learning Takeaways\n* Smart Contract Development and deployment\n* Building a frontend for integration with smart contracts\n* Using Ethers.js library for communicating with smart contracts\n* Integrating Metamask for secure user transactions and interactions\n* Read and Write data to/from smart contracts\n\n## Software Prerequisites \n* [Git](https://git-scm.com/) v2.44.0\n* [Node.js](https://nodejs.org/en) v20.11.1\n* [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) v10.2.4\n* [Hardhat](https://hardhat.org/hardhat-runner/docs/getting-started#installation) v2.22.6\n* [MetaMask Web Wallet Extension](https://metamask.io/download/)Git v2.44.0\n* **Core Testnet Configuration:** Configure MetaMask to connect to the Core Testnet. Refer [here](https://docs.coredao.org/docs/Dev-Guide/core-testnet-wallet-config#adding-core-testnet-to-metamask) for more details.\n * **Network Name:** Core Testnet\n * **New RPC URL:** https://rpc.test.btcs.network\n * **Chain ID:** 1115\n * **Currency Symbol:** CORE\n* **Core Faucet:** To get test CORE tokens for transactions, visit the [Core Faucet](https://scan.test.btcs.network/faucet), refer [here]\n(https://docs.coredao.org/docs/Dev-Guide/core-faucet) for more details.\n\n## Setting up Dev Environment\n\n### 1. Initialize the Project\n\n```\nmkdir staking-dapp\ncd staking-dapp\nnpm init -y\nnpm install --save-dev hardhat\nnpx hardhat init \n```\n\n\n### 2. Install and Configure MetaMask \n* Install and configure MetaMask Chrome Extension to use with Core Testnet. \n* Refer [here](https://docs.coredao.org/docs/Dev-Guide/core-testnet-wallet-config) for a detailed guide.\n\n### 3. Create a Secret File\n* Create a `secret.json` file in the root folder and store the private key of your MetaMask wallet in it. \n* Refer [here](https://metamask.zendesk.com/hc/en-us/articles/360015290032-How-to-reveal-your-Secret-Recovery-Phrase) for details on how to get MetaMask account's private key.\n\n```json\n{\"PrivateKey\":\"you private key, do not leak this file, do keep it absolutely safe\"}\n```\n\n> _Do not forget to add this file to the `.gitignore` file in the root folder of your project so that you don't accidentally check your private keys/secret phrases into a public repository. Make sure you keep this file in an absolutely safe place!_\n\n\n### 4. Update .gitignore \n* Update your .gitignore file to ensure that your secret.json file and other sensitive files are not committed to version control.\n* Make sure to add `secret.json` to the `.gitignore` file. \n\n```\nnode_modules\n.env\nsecret.json\n\n# Hardhat files\n/cache\n/artifacts\n\n# TypeChain files\n/typechain\n/typechain-types\n\n# solidity-coverage files\n/coverage\n/coverage.json\n\n# Hardhat Ignition default folder for deployments against a local node\nignition/deployments/chain-31337\n```\n\n### 5. Update Hardhat.config \n\nReplace the contents of `hardhat.config.js` with the following configuration. Ensure that the network settings are configured correctly for Core Testnet.\n\n```\n/**\n * @type import('hardhat/config').HardhatUserConfig\n */\n\nrequire('@nomiclabs/hardhat-ethers');\nrequire(\"@nomiclabs/hardhat-waffle\");\n\nconst { PrivateKey } = require('./secret.json');\n\nmodule.exports = {\n defaultNetwork: 'core_testnet',\n\n networks: {\n hardhat: {\n },\n core_testnet: {\n url: 'https://rpc.test2.btcs.network',\n accounts: [PRIVATE_KEY],\n chainId: 1115,\n }\n },\n solidity: {\n compilers: [\n {\n version: '0.8.24',\n settings: {\n evmVersion: 'paris',\n optimizer: {\n enabled: true,\n runs: 200,\n },\n },\n },\n ],\n },\n paths: {\n sources: './contracts',\n cache: './cache',\n artifacts: './artifacts',\n },\n mocha: {\n timeout: 20000,\n },\n};\n```\n\n## Writing Smart Contracts\nIn the `contracts` folder, create the following smart contracts.\n\n### Staking Token Contract\n* For this dapp, we create a custom ERC20 token, named as `Staking Token - STK`. Users will stake their `STK` tokens to earn rewards.\n* Create a `StakingToken.sol` file and udpate its contents with the following.\n\n```js\n// SPDX-License-Identifier: MIT\n// Compatible with OpenZeppelin Contracts ^5.0.0\npragma solidity ^0.8.20;\n\nimport \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/extensions/ERC20Permit.sol\";\n\ncontract StakingToken is ERC20, Ownable, ERC20Permit {\n constructor(string memory name, string memory symbol)\n ERC20(name, symbol)\n Ownable(msg.sender)\n ERC20Permit(name)\n {}\n\n function mint(address to, uint256 amount) public {\n require(amount <= 100 * 10 ** 18, \"amount must be less than 100\");\n _mint(to, amount);\n }\n}\n```\n\n### Reward Token Contract\n* For this dapp, we create a custom ERC20 token, named as `Reward Token - RTK`. Users will earn rewards as `RTK` tokens for staking their `STK` tokens.\n* Create a `RewardToken.sol` file and udpate its contents with the following.\n\n```js\n// SPDX-License-Identifier: MIT\n// Compatible with OpenZeppelin Contracts ^5.0.0\npragma solidity ^0.8.20;\n\nimport \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/extensions/ERC20Permit.sol\";\n\ncontract RewardToken is ERC20, Ownable, ERC20Permit {\n constructor(string memory name, string memory symbol)\n ERC20(name, symbol)\n Ownable(msg.sender)\n ERC20Permit(name)\n {}\n\n function mint(address to, uint256 amount) public {\n _mint(to, amount);\n }\n}\n```\n\n### Staking Dapp Contract \n* Create a `StakingDapp.sol` file and udpate its contents with the following.\n\n```js \n// SPDX-License-Identifier: MIT\npragma solidity 0.8.24;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\ninterface IRewardToken is IERC20 {\n function mint(address to, uint256 amount) external;\n}\n\ncontract StakingDapp is Ownable {\n using SafeERC20 for IERC20;\n\n IERC20 public stakingToken;\n IRewardToken public rewardToken;\n\n struct Stake {\n uint256 amount;\n uint256 lastRewardTime; // Track the last time rewards were calculated\n }\n\n mapping(address => Stake) public stakes;\n mapping(address => uint256) public rewardBalance;\n\n uint256 public constant REWARD_AMOUNT = 5; // Reward tokens per interval\n uint256 public constant REWARD_INTERVAL = 10; // 10 seconds per reward interval\n\n event Staked(address indexed user, uint256 amount);\n event Unstaked(address indexed user, uint256 amount);\n event RewardClaimed(address indexed user, uint256 amount);\n\n constructor(address _stakingToken, address _rewardToken) Ownable(msg.sender) {\n require(_stakingToken != address(0) && _rewardToken != address(0), \"Invalid token addresses\");\n stakingToken = IERC20(_stakingToken);\n rewardToken = IRewardToken(_rewardToken);\n }\n\n function getStakedAmount(address user) external view returns (uint256) {\n return stakes[user].amount;\n }\n\n\n function stake(uint256 amount) external {\n require(amount > 0, \"Amount must be greater than 0\");\n \n if (stakes[msg.sender].amount > 0) {\n // Calculate and update reward balance before changing the stake\n uint256 pendingReward = calculateReward(msg.sender);\n rewardBalance[msg.sender] += pendingReward;\n }\n \n stakingToken.safeTransferFrom(msg.sender, address(this), amount);\n \n // Update the stake amount and last reward time\n stakes[msg.sender].amount += amount;\n stakes[msg.sender].lastRewardTime = block.timestamp;\n \n emit Staked(msg.sender, amount);\n }\n\n function unstake(uint256 amount) external {\n require(stakes[msg.sender].amount >= amount, \"Insufficient balance\");\n \n uint256 pendingReward = calculateReward(msg.sender);\n rewardBalance[msg.sender] += pendingReward;\n\n // Update the stake amount and last reward time\n stakes[msg.sender].amount -= amount;\n stakes[msg.sender].lastRewardTime = block.timestamp;\n \n stakingToken.safeTransfer(msg.sender, amount);\n \n emit Unstaked(msg.sender, amount);\n }\n\n function claimReward() external {\n uint256 reward = calculateReward(msg.sender) + rewardBalance[msg.sender];\n require(reward > 0, \"No reward available\");\n\n // Reset reward data\n rewardBalance[msg.sender] = 0;\n stakes[msg.sender].lastRewardTime = block.timestamp;\n \n // Mint reward tokens\n rewardToken.mint(msg.sender, reward);\n \n emit RewardClaimed(msg.sender, reward);\n }\n\n function calculateReward(address user) internal view returns (uint256) {\n Stake memory userStake = stakes[user];\n if (userStake.amount == 0) {\n return 0;\n }\n\n uint256 currentTime = block.timestamp;\n uint256 timeSinceLastReward = currentTime - userStake.lastRewardTime;\n uint256 intervalsPassed = timeSinceLastReward / REWARD_INTERVAL;\n // Calculate reward based on intervals passed and staked amount\n return intervalsPassed * REWARD_AMOUNT * userStake.amount; // 1e18; // Assumes REWARD_AMOUNT and staked amount are in the same decimal place\n }\n function getRewardAmount(address user) external view returns (uint256) {\n uint256 reward = calculateReward(user);\n return reward;\n }\n\n}\n```\n#### Explanation\nThe StakingDapp contract is a basic implementation of a staking mechanism in Solidity. It allows users to stake an ERC20 token (stakingToken), earn rewards in another ERC20 token (rewardToken), and claim those rewards.\n\n##### State Variables\n* **stakingToken:** The ERC-20 token that users will stake.\n* **rewardToken:** The ERC-20 token used to distribute rewards.\n* **stakes:** A mapping from user addresses to their staking details, including the amount staked and the last time rewards were calculated.\n* **rewardBalance:** A mapping to keep track of the reward balance for each user that they have accumulated but not yet claimed.\n* **REWARD_AMOUNT:** The amount of reward tokens distributed per reward interval.\n* **REWARD_INTERVAL:** The time interval (in seconds) between reward distributions.\n\n##### Functions\n1. **getStakedAmount(address user)**: Returns the amount of STK tokens staked by a user.\n\n2. **stake(uint256 amount)**: Allows users to stake a specified amount of staking tokens.\n * Updates the user's reward balance before modifying the stake.\n * Transfers the tokens from the user to the contract.\n * Updates the staking details and the last reward calculation time.\n * Emits the Staked event.\n\n3. **unstake(uint256 amount)**: Allows users to unstake a specified amount of stakingToken.\n * Ensures the user has sufficient staked tokens.\n * Updates the reward balance before modifying the stake.\n * Transfers the STK tokens back to the user.\n * Updates the staking details and the last reward calculation time.\n * Emits the Unstaked event.\n\n4. **claimReward()**: Allows users to claim their accumulated rewards.\n * Calculates the total reward available for the user.\n * Mints the reward tokens and transfers them to the user.\n * Resets the user's reward balance.\n * Updates the last reward calculation time.\n * Emits the RewardClaimed event.\n\n5. **calculateReward(address user)**: Calculates the reward amount for a user based on the time elapsed since the last reward calculation and the amount staked.\n * Uses the REWARD_AMOUNT and REWARD_INTERVAL to compute how many reward intervals have passed.\n * Calculates the total reward based on the number of intervals and the amount staked.\n * Visibility: Internal, used by other functions within the contract.\n\n6. **getRewardAmount(address user)**: Allows anyone to query the amount of reward available for a specific user.\n\n## Compile and Deploy Smart Contracts\n\n### Compiling Smart Contracts\nTo compile the smart contracts, run the command `npx hardhat compile`\n\n### Deploying Smart Contracts\n* Create a `scritps` folder in the root of your project.\n* Create a file `deploy.js` in the `scripts` folder.\n* Update the contents of the `deploy.js` file with the following:\n\n```js\nconst { ethers } = require(\"hardhat\");\n\nasync function main() {\n const [deployer] = await ethers.getSigners();\n\n console.log(\"Deploying contracts with the account:\", deployer.address);\n\n const StakingToken = await ethers.getContractFactory(\"StakingToken\");\n const stakingToken = await StakingToken.deploy(\"Staking Token\", \"STK\");\n\n const RewardToken = await ethers.getContractFactory(\"RewardToken\");\n const rewardToken = await RewardToken.deploy(\"Reward Token\", \"RTK\");\n\n const StakingDapp = await ethers.getContractFactory(\"StakingDapp\");\n const stakingDapp = await StakingDapp.deploy(stakingToken.address, rewardToken.address);\n\n console.log(\"Contracts deployed:\");\n console.log(\"Staking Token:\", stakingToken.address);\n console.log(\"Reward Token:\", rewardToken.address);\n console.log(\"Staking Dapp:\", stakingDapp.address);\n}\n\nmain()\n .then(() => process.exit(0))\n .catch((error) => {\n console.error(error);\n process.exit(1);\n });\n\n```\n* Make sure your MetaMask wallet has tCORE test tokens for the Core Testnet. Refer [here](https://docs.coredao.org/docs/Dev-Guide/core-faucet) for details on how to get tCORE tokens from Core Faucet. \n\n* Run the following command from the root directory of your project, to deploy smart contracts on the Core blockchain.\n\n```bash\nnpx hardhat run scripts/deploy.js\n```\n\n* If succesfully deployed, you will get the following output\n\n\n\n* Save the addresses for the deploed contracts for use with the frontend.\n\n## Interacting with Smart Contract through Frontend\n\n⚡️ Let's create a frontend interface for interacting with the smart contract.\n\n### Setting up frontend \n\n* Create a simple react application using the following command\n\n```bash\nnpx create-react-app frontend\ncd frontend\n```\n\n* Install Dependencies, the Ethers.js library for communicating with the deployed smart contracts.\n\n```bash\n npm install --save-dev ethers@5.6.9\n```\n\n* Create a `contracts` folder inside the `frontend/src` folder.\n\n```bash\nmkdir components \nmkdir contracts \n```\n\nCopy the ABIs in the form of `.json` files, of your deployed smart contracts, from `artifacts/contracts/RewardToken.sol` `artifacts/contracts/StakingToken.sol` and `artifacts/contracts/RewardToken.sol` directories into the `frontend/src/contracts` directory.\n\n\n* Create a `components` folder in the `frontend/src` directory. \n```bash \nmkdir components\ncd components\n```\n\n### Adding Frontend Fuctionality\n* Update the `App.js` with the contents of the [App.js](./frontend/src/App.js) in the boilerplate repo.\n* Update the `App.css` with the contents of the [App.css](./frontend/src/App.css) in the boilerplate repo.\n* Create a `Modal.js` file inside the `components` directory. Update the file with the contents of the [Modal.js](./frontend/src/components/Modal.js) in the boilerplate repo.\n* Create a `Modal.css` file in the `components` directory. Update the file with the contents of the [Modal.csss](./frontend/src/components/Modal.css) in the boilerplate repo.\n\n### Key Implementation\nThe application's key blockchain logic is implemented in [App.js](./frontend/src/App.js)\n\n1. **App.js (Wallet):** Line#31 onwards is the logic for connecting the application to MetaMask wallet.\n2. **App.js (Stake):** Line#180 is the logic to stake the STK tokens.\n3. **App.js (Unstake):** Line#211 is the logic to unstake the STK tokens.\n4. **App.js (Claim Reward):** Line#275 is the logic to claim the rewards as the RTK tokens.\n5. **App.js (STK Faucet):** Line#311 is the logic for the faucet to get STK tokens.\n\n### Adding Smart Contract Details \n* Paste this into Lines 12, 13, and 14 the addresses of the deployed contracts of StakingToken, RewardToken and StakingDapp.\n\n```js\nconst stakingDappAddress = '0xAddress_of_Staking_Dapp_Contract';\nconst stakingTokenAddress = '0xAddreess_of_Staking_Token_Contract';\nconst rewardTokenAddress = '0xAddreess_of_Reward_Token_Contract'; \n```\n\n### Testing Locally\n* From the `frontend` directory, run the command `npm run start`\n* Make sure that your MetaMask wallet is correctly installed and switched to Core Testnet as described in our [Core Testnet user guide](https://docs.coredao.org/docs/Dev-Guide/core-testnet-wallet-config). You'll also need to connect your MetaMask wallet to the local site.\n* Navigate to `http://localhost:3000/` in your browser.\n\n\n\n* Enter an amount less than 100 and click on the `STK Faucet` to get STK tokens.\n\n\n* Enter an amount greater than 0 and less than or equal to your STK balance and click `Stake` to stake tokens. \n\n\n* On clicking the `Stake` button, Metamask notification will pop up, allow the stakingdapp contract to spend your STK tokens, then click next and on the next notificxation click on `Edit` and give a higher gas limiti value, say 6000000, then click save and approve the transaction.\n\n* Enter an amount greater than 0 and less than or equal to your staked balance and click `Unstake` to unstake tokens. \n\n\n\n## 🎉 **Congratulations!** \nYou've just interacted with your deployed contract using your dApp's front end! You can build on the codebase by adding new UI components or more functionality to the staking dapp.\n"
},
{
"path": "02-Basic Staking Full Stack Dapp/contracts/RewardToken.sol",
"content": "// SPDX-License-Identifier: MIT\n// Compatible with OpenZeppelin Contracts ^5.0.0\npragma solidity ^0.8.20;\n\nimport \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/extensions/ERC20Permit.sol\";\n\ncontract RewardToken is ERC20, Ownable, ERC20Permit {\n constructor(string memory name, string memory symbol)\n ERC20(name, symbol)\n Ownable(msg.sender)\n ERC20Permit(name)\n {}\n\n function mint(address to, uint256 amount) public {\n _mint(to, amount);\n }\n}"
},
{
"path": "02-Basic Staking Full Stack Dapp/contracts/StakingDapp.sol",
"content": "// SPDX-License-Identifier: MIT\npragma solidity 0.8.24;\n\nimport \"@openzeppelin/contracts/token/ERC20/IERC20.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/utils/SafeERC20.sol\";\n\ninterface IRewardToken is IERC20 {\n function mint(address to, uint256 amount) external;\n}\n\ncontract StakingDapp is Ownable {\n using SafeERC20 for IERC20;\n\n IERC20 public stakingToken;\n IRewardToken public rewardToken;\n\n struct Stake {\n uint256 amount;\n uint256 lastRewardTime; // Track the last time rewards were calculated\n }\n\n mapping(address => Stake) public stakes;\n mapping(address => uint256) public rewardBalance;\n\n uint256 public constant REWARD_AMOUNT = 5; // Reward tokens per interval\n uint256 public constant REWARD_INTERVAL = 10; // 10 seconds per reward interval\n\n event Staked(address indexed user, uint256 amount);\n event Unstaked(address indexed user, uint256 amount);\n event RewardClaimed(address indexed user, uint256 amount);\n\n constructor(address _stakingToken, address _rewardToken) Ownable(msg.sender) {\n require(_stakingToken != address(0) && _rewardToken != address(0), \"Invalid token addresses\");\n stakingToken = IERC20(_stakingToken);\n rewardToken = IRewardToken(_rewardToken);\n }\n\n function getStakedAmount(address user) external view returns (uint256) {\n return stakes[user].amount;\n }\n\n\n function stake(uint256 amount) external {\n require(amount > 0, \"Amount must be greater than 0\");\n \n if (stakes[msg.sender].amount > 0) {\n // Calculate and update reward balance before changing the stake\n uint256 pendingReward = calculateReward(msg.sender);\n rewardBalance[msg.sender] += pendingReward;\n }\n \n stakingToken.safeTransferFrom(msg.sender, address(this), amount);\n \n // Update the stake amount and last reward time\n stakes[msg.sender].amount += amount;\n stakes[msg.sender].lastRewardTime = block.timestamp;\n \n emit Staked(msg.sender, amount);\n }\n\n function unstake(uint256 amount) external {\n require(stakes[msg.sender].amount >= amount, \"Insufficient balance\");\n \n uint256 pendingReward = calculateReward(msg.sender);\n rewardBalance[msg.sender] += pendingReward;\n\n // Update the stake amount and last reward time\n stakes[msg.sender].amount -= amount;\n stakes[msg.sender].lastRewardTime = block.timestamp;\n \n stakingToken.safeTransfer(msg.sender, amount);\n \n emit Unstaked(msg.sender, amount);\n }\n\n function claimReward() external {\n uint256 reward = calculateReward(msg.sender) + rewardBalance[msg.sender];\n require(reward > 0, \"No reward available\");\n\n // Reset reward data\n rewardBalance[msg.sender] = 0;\n stakes[msg.sender].lastRewardTime = block.timestamp;\n \n // Mint reward tokens\n rewardToken.mint(msg.sender, reward);\n \n emit RewardClaimed(msg.sender, reward);\n }\n\n function calculateReward(address user) internal view returns (uint256) {\n Stake memory userStake = stakes[user];\n if (userStake.amount == 0) {\n return 0;\n }\n\n uint256 currentTime = block.timestamp;\n uint256 timeSinceLastReward = currentTime - userStake.lastRewardTime;\n uint256 intervalsPassed = timeSinceLastReward / REWARD_INTERVAL;\n // Calculate reward based on intervals passed and staked amount\n return intervalsPassed * REWARD_AMOUNT * userStake.amount; // 1e18; // Assumes REWARD_AMOUNT and staked amount are in the same decimal place\n }\n function getRewardAmount(address user) external view returns (uint256) {\n uint256 reward = calculateReward(user);\n return reward;\n }\n\n}\n"
},
{
"path": "02-Basic Staking Full Stack Dapp/contracts/StakingToken.sol",
"content": "// SPDX-License-Identifier: MIT\n// Compatible with OpenZeppelin Contracts ^5.0.0\npragma solidity ^0.8.20;\n\nimport \"@openzeppelin/contracts/token/ERC20/ERC20.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\nimport \"@openzeppelin/contracts/token/ERC20/extensions/ERC20Permit.sol\";\n\ncontract StakingToken is ERC20, Ownable, ERC20Permit {\n constructor(string memory name, string memory symbol)\n ERC20(name, symbol)\n Ownable(msg.sender)\n ERC20Permit(name)\n {}\n\n function mint(address to, uint256 amount) public {\n require(amount <= 100 * 10 ** 18, \"amount must be less than 100\");\n _mint(to, amount);\n }\n}"
},
{
"path": "02-Basic Staking Full Stack Dapp/frontend/.gitignore",
"content": "# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.\n\n# dependencies\n/node_modules\n/.pnp\n.pnp.js\n\n# testing\n/coverage\n\n# production\n/build\n\n# misc\n.DS_Store\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\n\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n"
},
{
"path": "02-Basic Staking Full Stack Dapp/frontend/README.md",
"content": "# Getting Started with Create React App\n\nThis project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).\n\n## Available Scripts\n\nIn the project directory, you can run:\n\n### `npm start`\n\nRuns the app in the development mode.\\\nOpen [http://localhost:3000](http://localhost:3000) to view it in your browser.\n\nThe page will reload when you make changes.\\\nYou may also see any lint errors in the console.\n\n### `npm test`\n\nLaunches the test runner in the interactive watch mode.\\\nSee the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.\n\n### `npm run build`\n\nBuilds the app for production to the `build` folder.\\\nIt correctly bundles React in production mode and optimizes the build for the best performance.\n\nThe build is minified and the filenames include the hashes.\\\nYour app is ready to be deployed!\n\nSee the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.\n\n### `npm run eject`\n\n**Note: this is a one-way operation. Once you `eject`, you can't go back!**\n\nIf you aren't satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.\n\nInstead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you're on your own.\n\nYou don't have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn't feel obligated to use this feature. However we understand that this tool wouldn't be useful if you couldn't customize it when you are ready for it.\n\n## Learn More\n\nYou can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).\n\nTo learn React, check out the [React documentation](https://reactjs.org/).\n\n### Code Splitting\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/code-splitting](https://facebook.github.io/create-react-app/docs/code-splitting)\n\n### Analyzing the Bundle Size\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size](https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size)\n\n### Making a Progressive Web App\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app](https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app)\n\n### Advanced Configuration\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/advanced-configuration](https://facebook.github.io/create-react-app/docs/advanced-configuration)\n\n### Deployment\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/deployment](https://facebook.github.io/create-react-app/docs/deployment)\n\n### `npm run build` fails to minify\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify](https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify)\n"
},
{
"path": "02-Basic Staking Full Stack Dapp/frontend/package.json",
"content": "{\n \"name\": \"frontend_ui\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"dependencies\": {\n \"@testing-library/jest-dom\": \"5.17.0\",\n \"@testing-library/react\": \"13.4.0\",\n \"@testing-library/user-event\": \"13.5.0\",\n \"bootstrap\": \"5.2.3\",\n \"react\": \"18.3.1\",\n \"react-dom\": \"18.3.1\",\n \"react-scripts\": \"5.0.1\",\n \"react-toastify\": \"10.0.5\",\n \"web-vitals\": \"2.1.4\"\n },\n \"scripts\": {\n \"start\": \"react-scripts start\",\n \"build\": \"react-scripts build\",\n \"test\": \"react-scripts test\",\n \"eject\": \"react-scripts eject\"\n },\n \"eslintConfig\": {\n \"extends\": [\n \"react-app\",\n \"react-app/jest\"\n ]\n },\n \"browserslist\": {\n \"production\": [\n \">0.2%\",\n \"not dead\",\n \"not op_mini all\"\n ],\n \"development\": [\n \"last 1 chrome version\",\n \"last 1 firefox version\",\n \"last 1 safari version\"\n ]\n },\n \"devDependencies\": {\n \"ethers\": \"^5.6.9\"\n }\n}\n"
},
{
"path": "02-Basic Staking Full Stack Dapp/frontend/public/index.html",
"content": "\n\n \n \n \n \n \n \n \n \n \n \n React App\n \n \n \n \n \n \n\n"
},
{
"path": "02-Basic Staking Full Stack Dapp/frontend/public/manifest.json",
"content": "{\n \"short_name\": \"React App\",\n \"name\": \"Create React App Sample\",\n \"icons\": [\n {\n \"src\": \"favicon.ico\",\n \"sizes\": \"64x64 32x32 24x24 16x16\",\n \"type\": \"image/x-icon\"\n },\n {\n \"src\": \"logo192.png\",\n \"type\": \"image/png\",\n \"sizes\": \"192x192\"\n },\n {\n \"src\": \"logo512.png\",\n \"type\": \"image/png\",\n \"sizes\": \"512x512\"\n }\n ],\n \"start_url\": \".\",\n \"display\": \"standalone\",\n \"theme_color\": \"#000000\",\n \"background_color\": \"#ffffff\"\n}\n"
},
{
"path": "02-Basic Staking Full Stack Dapp/frontend/public/robots.txt",
"content": "# https://www.robotstxt.org/robotstxt.html\nUser-agent: *\nDisallow:\n"
},
{
"path": "02-Basic Staking Full Stack Dapp/frontend/src/App.css",
"content": "@import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');\n\n:root {\n /* Light Mode Colors */\n --light-bg: #f5f7fa;\n --light-card: #ffffff;\n --light-text: #2d3748;\n --light-text-secondary: #4a5568;\n --light-border: #e2e8f0;\n --light-primary: #ff9211;\n --light-primary-hover: #ed6a2e;\n \n /* Dark Mode Colors */\n --dark-bg: #1a202c;\n --dark-card: #2d3748;\n --dark-text: #f7fafc;\n --dark-text-secondary: #cbd5e0;\n --dark-border: #ff9501;\n --dark-primary: #ff9211;\n --dark-primary-hover: #ed6a2e;\n}\n\n* {\n margin: 0;\n padding: 0;\n box-sizing: border-box;\n transition: background-color 0.3s, color 0.3s;\n}\n\nbody {\n font-family: 'Inter', sans-serif;\n}\n\n.App {\n min-height: 100vh;\n padding: 0 2rem;\n}\n\n/* Theme Styles */\n.light-mode {\n background-color: var(--light-bg);\n color: var(--light-text);\n}\n\n.dark-mode {\n background-color: var(--dark-bg);\n color: var(--dark-text);\n}\n\n/* Header Styles */\n.App-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n padding: 1.5rem 0;\n border-bottom: 1px solid;\n}\n\n.light-mode .App-header {\n border-color: var(--light-border);\n}\n\n.dark-mode .App-header {\n border-color: var(--dark-border);\n}\n\n.logo-container img {\n height: 40px;\n}\n\n.header-right {\n display: flex;\n align-items: center;\n gap: 1rem;\n}\n\n.theme-toggle {\n background: transparent;\n border: none;\n font-size: 1.5rem;\n cursor: pointer;\n padding: 0.5rem;\n border-radius: 50%;\n}\n\n.light-mode .theme-toggle {\n background-color: rgba(0, 0, 0, 0.05);\n width: 45px;\n height: 45px;\n display: flex;\n justify-content: center;\n align-items: center;\n}\n\n.dark-mode .theme-toggle {\n background-color: rgba(255, 255, 255, 0.05);\n width: 45px;\n height: 45px;\n display: flex;\n justify-content: center;\n align-items: center;\n}\n\n/* Button Styles */\n.btn-wallet {\n padding: 0.75rem 1.5rem;\n border-radius: 0.5rem;\n font-weight: 600;\n cursor: pointer;\n border: none;\n display: flex;\n align-items: center;\n gap: 0.5rem;\n}\n\n.light-mode .btn-wallet {\n background-color: var(--light-primary);\n color: white;\n}\n\n.dark-mode .btn-wallet {\n background-color: var(--dark-primary);\n color: white;\n}\n\n.btn-wallet:hover {\n transform: translateY(-1px);\n}\n\n.light-mode .btn-wallet:hover {\n background-color: var(--light-primary-hover);\n}\n\n.dark-mode .btn-wallet:hover {\n background-color: var(--dark-primary-hover);\n}\n\n.btn-wallet.large {\n padding: 1rem 2rem;\n font-size: 1.1rem;\n}\n\n/* Main Content Styles */\nmain {\n padding: 2rem 0;\n}\n\n.main-title {\n font-size: 2rem;\n margin-bottom: 2rem;\n font-weight: 700;\n}\n\n/* Connect Prompt Styles */\n.connect-prompt {\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n text-align: center;\n padding: 3rem 0;\n}\n\n.connect-illustration {\n margin-bottom: 2rem;\n}\n\n.connect-illustration img {\n max-width: 100%;\n border-radius: 1rem;\n}\n\n.connect-prompt p {\n margin-bottom: 2rem;\n font-size: 1.2rem;\n max-width: 600px;\n line-height: 1.6;\n}\n\n.light-mode .connect-prompt p {\n color: var(--light-text-secondary);\n}\n\n.dark-mode .connect-prompt p {\n color: var(--dark-text-secondary);\n}\n\n/* Dashboard Styles */\n.dashboard {\n max-width: 1200px;\n margin: 0 auto;\n}\n\n.wallet-info {\n display: flex;\n justify-content: flex-end;\n margin-bottom: 1.5rem;\n}\n\n.wallet-address {\n padding: 0.5rem 1rem;\n border-radius: 0.5rem;\n font-family: monospace;\n font-size: 0.9rem;\n}\n\n.light-mode .wallet-address {\n background-color: rgba(0, 0, 0, 0.05);\n}\n\n.dark-mode .wallet-address {\n background-color: rgba(255, 255, 255, 0.05);\n}\n\n/* Stats Grid Styles */\n.stats-grid {\n display: grid;\n grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));\n gap: 1.5rem;\n margin-bottom: 2rem;\n}\n\n.stat-card {\n padding: 1.5rem;\n border-radius: 1rem;\n display: flex;\n flex-direction: column;\n align-items: center;\n text-align: center;\n}\n\n.light-mode .stat-card {\n background-color: var(--light-card);\n box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);\n}\n\n.dark-mode .stat-card {\n background-color: var(--dark-card);\n}\n\n.stat-card.highlight {\n border: 2px solid;\n}\n\n.light-mode .stat-card.highlight {\n border-color: var(--light-primary);\n}\n\n.dark-mode .stat-card.highlight {\n border-color: var(--dark-primary);\n}\n\n.stat-icon {\n font-size: 2rem;\n margin-bottom: 1rem;\n}\n\n.stat-card h3 {\n font-size: 1.1rem;\n margin-bottom: 0.5rem;\n font-weight: 600;\n}\n\n.stat-value {\n font-size: 1.5rem;\n font-weight: 700;\n margin-bottom: 1rem;\n}\n\n.light-mode .stat-value {\n color: var(--light-primary);\n}\n\n.dark-mode .stat-value {\n color: var(--dark-primary);\n}\n\n.claim-btn {\n padding: 0.5rem 1rem;\n border-radius: 0.5rem;\n font-weight: 600;\n cursor: pointer;\n border: none;\n width: 100%;\n}\n\n.light-mode .claim-btn {\n background-color: var(--light-primary);\n color: white;\n}\n\n.dark-mode .claim-btn {\n background-color: var(--dark-primary);\n color: white;\n}\n\n.claim-btn:hover {\n transform: translateY(-1px);\n}\n\n.light-mode .claim-btn:hover {\n background-color: var(--light-primary-hover);\n}\n\n.dark-mode .claim-btn:hover {\n background-color: var(--dark-primary-hover);\n}\n\n/* Action Cards css */\n.action-cards {\n display: grid;\n grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));\n gap: 1.5rem;\n}\n\n.action-card {\n padding: 1.5rem;\n border-radius: 1rem;\n}\n\n.light-mode .action-card {\n background-color: var(--light-card);\n box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -1px rgba(0, 0, 0, 0.06);\n}\n\n.dark-mode .action-card {\n background-color: var(--dark-card);\n}\n\n.action-card h3 {\n font-size: 1.1rem;\n margin-bottom: 1rem;\n font-weight: 600;\n}\n\n.input-group {\n display: flex;\n gap: 0.5rem;\n}\n\n.input-field {\n flex: 1;\n padding: 0.75rem 1rem;\n border-radius: 0.5rem;\n border: 1px solid;\n font-size: 1rem;\n}\n\n.light-mode .input-field {\n border-color: var(--light-border);\n background-color: white;\n color: var(--light-text);\n}\n\n.dark-mode .input-field {\n border-color: var(--dark-border);\n background-color: #1a202c;\n color: var(--dark-text);\n}\n\n.input-field:focus {\n outline: none;\n border-width: 2px;\n}\n\n.light-mode .input-field:focus {\n border-color: var(--light-primary);\n}\n\n.dark-mode .input-field:focus {\n border-color: var(--dark-primary);\n}\n\n.btn-action {\n padding: 0.75rem 1.5rem;\n border-radius: 0.5rem;\n font-weight: 600;\n cursor: pointer;\n border: none;\n white-space: nowrap;\n}\n\n.light-mode .btn-action {\n background-color: var(--light-primary);\n color: white;\n}\n\n.dark-mode .btn-action {\n background-color: var(--dark-primary);\n color: white;\n}\n\n.btn-action:hover {\n transform: translateY(-1px);\n}\n\n.light-mode .btn-action:hover {\n background-color: var(--light-primary-hover);\n}\n\n.dark-mode .btn-action:hover {\n background-color: var(--dark-primary-hover);\n}\n\n/* Responsive css */\n@media (max-width: 768px) {\n .App {\n padding: 0 1rem;\n }\n \n .stats-grid, .action-cards {\n grid-template-columns: 1fr;\n }\n \n .input-group {\n flex-direction: column;\n }\n \n .btn-action {\n width: 100%;\n }\n}"
},
{
"path": "02-Basic Staking Full Stack Dapp/frontend/src/App.js",
"content": "import { useEffect, useState, useCallback } from \"react\";\nimport { ethers } from \"ethers\";\nimport StakingToken from \"./contracts/StakingToken.json\";\nimport StakingDapp from \"./contracts/StakingDapp.json\";\nimport RewardToken from \"./contracts/RewardToken.json\";\nimport { ToastContainer, toast } from \"react-toastify\";\nimport \"react-toastify/dist/ReactToastify.css\";\nimport Modal from \"./components/Modal\";\nimport \"./App.css\";\nimport darkLogo from \"./assets/dark_logo.webp\";\nimport lightLogo from \"./assets/light_logo.webp\";\nimport \"../node_modules/bootstrap/dist/css/bootstrap.min.css\";\n\nconst stakingDappAddress = \"0x341B5aC2189e73d444883CB608FfF7d8e8AC4F93\";\nconst stakingTokenAddress = \"0x9Ba37DAA676B30599B67093FACDA8b3B7BD0Fb44\";\nconst rewardTokenAddress = \"0xDa0bBC600188Bf2C995de241Cb3B50f62Da925B5\";\n\nfunction App() {\n const [stakingAmount, setStakingAmount] = useState(\"\");\n const [unstakingAmount, setUnstakingAmount] = useState(\"\");\n const [currentAccount, setCurrentAccount] = useState(null);\n const [stakedAmount, setStakedAmount] = useState(\"0\");\n const [rewardAmount, setRewardAmount] = useState(\"0\");\n const [totalStkBalance, setTotalStkBalance] = useState(\"0\");\n const [network, setNetwork] = useState(\"\");\n const [faucetAmount, setFaucetAmount] = useState(\"\");\n const [isModalOpen, setIsModalOpen] = useState(false);\n const [stakingTokenDecimals, setStakingTokenDecimals] = useState(18);\n const [rewardTokenDecimals, setRewardTokenDecimals] = useState(18);\n const [darkMode, setDarkMode] = useState(true);\n // Check if wallet is connected\n const checkWalletIsConnected = async () => {\n const { ethereum } = window;\n\n if (!ethereum) {\n console.log(\"Make sure you have Metamask installed!\");\n return;\n }\n\n try {\n const accounts = await ethereum.request({ method: \"eth_accounts\" });\n\n if (accounts.length !== 0) {\n const account = accounts[0];\n setCurrentAccount(account);\n } else {\n console.log(\"No authorized account found ...\");\n }\n } catch (error) {\n console.error(\"Error fetching accounts:\", error);\n }\n };\n\n // Check network\n const checkNetwork = async () => {\n const { ethereum } = window;\n\n if (!ethereum) {\n console.log(\"Ethereum object does not exist\");\n return;\n }\n\n try {\n const provider = new ethers.providers.Web3Provider(ethereum);\n const { chainId } = await provider.getNetwork();\n\n if (chainId !== 1115) {\n console.log(\"Please connect to the Core Testnet\");\n } else {\n setNetwork(\"Core Testnet\");\n }\n } catch (error) {\n console.error(\"Error fetching network:\", error);\n }\n };\n\n // Connect wallet\n const connectWalletHandler = async () => {\n const { ethereum } = window;\n\n if (!ethereum) {\n alert(\"Please install Metamask!\");\n return;\n }\n\n try {\n const accounts = await ethereum.request({\n method: \"eth_requestAccounts\",\n });\n setCurrentAccount(accounts[0]);\n } catch (error) {\n console.error(\"Error connecting wallet:\", error);\n }\n };\n\n // Disconnect wallet\n const disconnectWalletHandler = () => {\n setCurrentAccount(null);\n setStakedAmount(\"0\");\n setRewardAmount(\"0\");\n setTotalStkBalance(\"0\");\n setNetwork(\"\");\n };\n\n // Fetch staked and reward amounts\n const fetchStakedAndRewardAmounts = useCallback(async () => {\n try {\n const { ethereum } = window;\n\n if (ethereum) {\n const provider = new ethers.providers.Web3Provider(ethereum);\n const signer = provider.getSigner();\n const stakingDappContract = new ethers.Contract(\n stakingDappAddress,\n StakingDapp.abi,\n signer\n );\n\n const stakedAmount = await stakingDappContract.getStakedAmount(\n currentAccount\n );\n const rewardAmount = await stakingDappContract.getRewardAmount(\n currentAccount\n );\n\n setStakedAmount(\n ethers.utils.formatUnits(stakedAmount, stakingTokenDecimals)\n );\n setRewardAmount(\n ethers.utils.formatUnits(rewardAmount, rewardTokenDecimals)\n );\n } else {\n console.log(\"Ethereum object does not exist\");\n }\n } catch (error) {\n console.error(\"Error fetching staked and reward amounts:\", error);\n }\n }, [currentAccount, stakingTokenDecimals, rewardTokenDecimals]);\n\n // Fetch staking token balance\n const fetchStkBalance = useCallback(async () => {\n try {\n const { ethereum } = window;\n\n if (ethereum) {\n const provider = new ethers.providers.Web3Provider(ethereum);\n const stakingTokenContract = new ethers.Contract(\n stakingTokenAddress,\n StakingToken.abi,\n provider\n );\n\n const balance = await stakingTokenContract.balanceOf(currentAccount);\n const decimals = await stakingTokenContract.decimals();\n setStakingTokenDecimals(decimals);\n setTotalStkBalance(ethers.utils.formatUnits(balance, decimals));\n console.log('balance',balance)\n } else {\n console.log(\"Ethereum object does not exist\");\n }\n } catch (error) {\n console.error(\"Error fetching token balance:\", error);\n }\n }, [currentAccount]);\n\n // Fetch reward token decimals\n const fetchRewardTokenDecimals = useCallback(async () => {\n try {\n const { ethereum } = window;\n\n if (ethereum) {\n const provider = new ethers.providers.Web3Provider(ethereum);\n const rewardTokenContract = new ethers.Contract(\n rewardTokenAddress,\n RewardToken.abi,\n provider\n );\n\n const decimals = await rewardTokenContract.decimals();\n setRewardTokenDecimals(decimals);\n } else {\n console.log(\"Ethereum object does not exist\");\n }\n } catch (error) {\n console.error(\"Error fetching reward token decimals:\", error);\n }\n }, []);\n\n useEffect(() => {\n checkWalletIsConnected();\n }, []);\n\n useEffect(() => {\n if (currentAccount) {\n checkNetwork();\n fetchStakedAndRewardAmounts();\n fetchStkBalance();\n fetchRewardTokenDecimals();\n }\n }, [\n currentAccount,\n fetchStakedAndRewardAmounts,\n fetchStkBalance,\n fetchRewardTokenDecimals,\n ]);\n\n // Stake tokens\n const stakeTokens = async () => {\n try {\n if (!isValidAmount(stakingAmount)) {\n toast.error(\"Invalid staking amount. Please enter a positive number.\");\n return;\n }\n\n const { ethereum } = window;\n\n if (ethereum) {\n const provider = new ethers.providers.Web3Provider(ethereum);\n const signer = provider.getSigner();\n const stakingDappContract = new ethers.Contract(\n stakingDappAddress,\n StakingDapp.abi,\n signer\n );\n const tokenContract = new ethers.Contract(\n stakingTokenAddress,\n StakingToken.abi,\n signer\n );\n\n await tokenContract.approve(\n stakingDappAddress,\n ethers.utils.parseUnits(stakingAmount, stakingTokenDecimals)\n );\n const tx = await stakingDappContract.stake(\n ethers.utils.parseUnits(stakingAmount, stakingTokenDecimals)\n );\n await tx.wait();\n toast.success(\"Staked successfully\");\n fetchStakedAndRewardAmounts();\n fetchStkBalance();\n } else {\n console.log(\"Ethereum object does not exist\");\n }\n } catch (error) {\n console.error(\"Error staking tokens:\", error);\n toast.error(\"Error staking tokens\");\n }\n };\n\n // Unstake tokens\n const unstakeTokens = async () => {\n try {\n if (!isValidAmount(unstakingAmount)) {\n toast.error(\n \"Invalid unstaking amount. Please enter a positive number.\"\n );\n return;\n }\n\n // Check if unstaking amount is greater than the staked amount\n if (parseFloat(unstakingAmount) > parseFloat(stakedAmount)) {\n toast.error(\"Enter value equal to or less than the Staked STK.\");\n return;\n }\n\n const { ethereum } = window;\n\n if (ethereum) {\n const provider = new ethers.providers.Web3Provider(ethereum);\n const signer = provider.getSigner();\n const stakingDappContract = new ethers.Contract(\n stakingDappAddress,\n StakingDapp.abi,\n signer\n );\n\n const amount = ethers.utils.parseUnits(\n unstakingAmount,\n stakingTokenDecimals\n );\n const tx = await stakingDappContract.unstake(amount);\n await tx.wait();\n toast.success(\"Unstaked successfully\");\n fetchStakedAndRewardAmounts();\n fetchStkBalance();\n } else {\n console.log(\"Ethereum object does not exist\");\n }\n } catch (error) {\n console.error(\"Error unstaking tokens:\", error);\n toast.error(\"Error unstaking tokens\");\n }\n };\n\n // Open reward modal\n const openRewardModal = async () => {\n try {\n const { ethereum } = window;\n\n if (ethereum) {\n const provider = new ethers.providers.Web3Provider(ethereum);\n const signer = provider.getSigner();\n const stakingDappContract = new ethers.Contract(\n stakingDappAddress,\n StakingDapp.abi,\n signer\n );\n\n const reward = await stakingDappContract.getRewardAmount(\n currentAccount\n );\n const formattedReward = ethers.utils.formatUnits(\n reward,\n rewardTokenDecimals\n );\n console.log(formattedReward);\n if (parseFloat(formattedReward) > 0) {\n setRewardAmount(formattedReward);\n setIsModalOpen(true);\n } else {\n toast.info(\"No rewards available to claim.\");\n }\n } else {\n console.log(\"Ethereum object does not exist\");\n }\n } catch (error) {\n console.error(\"Error fetching reward amount:\", error);\n toast.error(\"Error fetching reward amount\");\n }\n };\n\n // Claim reward\n const claimReward = async () => {\n try {\n if (parseFloat(rewardAmount) <= 0) {\n toast.error(\"Cannot claim reward. Amount must be greater than zero.\");\n return;\n }\n\n const { ethereum } = window;\n\n if (ethereum) {\n const provider = new ethers.providers.Web3Provider(ethereum);\n const signer = provider.getSigner();\n const stakingDappContract = new ethers.Contract(\n stakingDappAddress,\n StakingDapp.abi,\n signer\n );\n\n // Set a high manual gas limit\n const gasLimit = 5000000; // Higher limit to ensure success\n\n // Try sending the transaction with a higher gas limit\n const tx = await stakingDappContract.claimReward({\n gasLimit: gasLimit,\n });\n await tx.wait();\n toast.success(\"Reward claimed successfully\");\n setIsModalOpen(false);\n fetchStakedAndRewardAmounts();\n fetchStkBalance();\n } else {\n console.log(\"Ethereum object does not exist\");\n }\n } catch (error) {\n console.error(\"Error claiming reward:\", error);\n toast.error(\n \"Error claiming reward. Please check the console for details.\"\n );\n }\n };\n\n // Faucet tokens\n const faucetTokens = async (amount) => {\n try {\n if (!isValidAmount(amount)) {\n toast.error(\n \"Invalid faucet amount. Please enter a positive number less than 100.\"\n );\n return;\n }\n\n const parsedAmount = parseFloat(amount);\n if (parsedAmount >= 100) {\n toast.error(\"Request amount must be less than 100.\");\n return;\n }\n\n const { ethereum } = window;\n\n if (ethereum) {\n const provider = new ethers.providers.Web3Provider(ethereum);\n const signer = provider.getSigner();\n const stakingTokenContract = new ethers.Contract(\n stakingTokenAddress,\n StakingToken.abi,\n signer\n );\n\n const gasLimit = 600000;\n\n const tx = await stakingTokenContract.mint(\n currentAccount,\n ethers.utils.parseUnits(amount, stakingTokenDecimals),\n {\n gasLimit: gasLimit,\n }\n );\n await tx.wait();\n toast.success(\"Tokens minted successfully\");\n fetchStkBalance();\n } else {\n console.log(\"Ethereum object does not exist\");\n }\n } catch (error) {\n console.error(\"Error minting tokens:\", error);\n toast.error(\"Error minting tokens\");\n }\n };\n\n // Validate amount\n const isValidAmount = (amount) => {\n return !isNaN(Number(amount)) && parseFloat(amount) > 0;\n };\n // Toggle dark/light mode\n const toggleTheme = () => {\n setDarkMode(!darkMode);\n };\n\n return (\n
\n \n
\n \n
\n \n
\n \n {currentAccount ? (\n \n ) : ( \n \n )}\n
\n \n \n \n
Staking Dashboard
\n \n {!currentAccount ? (\n
\n
Please connect your wallet to access the staking dashboard
\n );\n}\n\nexport default App;\n```\n\n\nStart the React app:\n\n>Ensure you are in /frontend within your repository (`cd frontend`)\n\n```\nnpm start\n```\nYou will be redirected to the development server\n\n\n\n> In this example, we've already submitted our response, so we will navigate to the [Core Explorer](scan.coredao.org).\n\nHere you can see, the transaction has been submitted successfully.\n\n\n\nThe dapp webpage will update, and you will notice the feed on the UI has been updated with your your name and message.\n\n\n\n## Deploying the Frontend\nIf you want your DApp to be accessible even when your local server is not running, consider deploying your frontend to a hosting service. Here are some common options:\n\nGitHub Pages: Free hosting for static sites directly from your GitHub repository.\nNetlify: A popular choice for deploying static sites with easy CI/CD integration.\nVercel: Another popular choice, especially for React applications.\nAWS S3 + CloudFront: For more control over hosting and scaling.\n\nBy deploying your frontend to one of these services, users can access your DApp from anywhere without needing your local development server to be running.\n\n## Conclusion\nBy following these steps, you should have a basic decentralized guestbook application deployed on the Core Test network with a React frontend to interact with it. \n\nYou can clone this repository to use as a boilerplate, or an educational resource.\n\n\n"
},
{
"path": "03-Decentralized Guestbook/contracts/Guestbook.sol",
"content": "// SPDX-License-Identifier: GPL-3.0\npragma solidity >=0.7.0 <0.9.0;\n\n/// @title Guestbook\ncontract Guestbook {\n struct Entry {\n string name;\n string message;\n }\n\n Entry[] public entries;\n\n // Define an event to log new entries\n event EntrySigned(string name, string message);\n\n function signGuestbook(string memory _name, string memory _message) public {\n entries.push(Entry(_name, _message));\n // Emit the event when a new entry is added\n emit EntrySigned(_name, _message);\n }\n\n function getEntries() public view returns (Entry[] memory) {\n return entries;\n }\n}\n"
},
{
"path": "03-Decentralized Guestbook/frontend/.gitignore",
"content": "# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.\n\n# dependencies\n/node_modules\n/.pnp\n.pnp.js\n\n# testing\n/coverage\n\n# production\n/build\n\n# misc\n.DS_Store\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\n\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n"
},
{
"path": "03-Decentralized Guestbook/frontend/README.md",
"content": "# Getting Started with Create React App\n\nThis project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).\n\n## Available Scripts\n\nIn the project directory, you can run:\n\n### `npm start`\n\nRuns the app in the development mode.\\\nOpen [http://localhost:3000](http://localhost:3000) to view it in your browser.\n\nThe page will reload when you make changes.\\\nYou may also see any lint errors in the console.\n\n### `npm test`\n\nLaunches the test runner in the interactive watch mode.\\\nSee the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.\n\n### `npm run build`\n\nBuilds the app for production to the `build` folder.\\\nIt correctly bundles React in production mode and optimizes the build for the best performance.\n\nThe build is minified and the filenames include the hashes.\\\nYour app is ready to be deployed!\n\nSee the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.\n\n### `npm run eject`\n\n**Note: this is a one-way operation. Once you `eject`, you can't go back!**\n\nIf you aren't satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.\n\nInstead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you're on your own.\n\nYou don't have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn't feel obligated to use this feature. However we understand that this tool wouldn't be useful if you couldn't customize it when you are ready for it.\n\n## Learn More\n\nYou can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).\n\nTo learn React, check out the [React documentation](https://reactjs.org/).\n\n### Code Splitting\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/code-splitting](https://facebook.github.io/create-react-app/docs/code-splitting)\n\n### Analyzing the Bundle Size\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size](https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size)\n\n### Making a Progressive Web App\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app](https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app)\n\n### Advanced Configuration\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/advanced-configuration](https://facebook.github.io/create-react-app/docs/advanced-configuration)\n\n### Deployment\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/deployment](https://facebook.github.io/create-react-app/docs/deployment)\n\n### `npm run build` fails to minify\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify](https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify)\n"
},
{
"path": "03-Decentralized Guestbook/frontend/package.json",
"content": "{\n \"name\": \"frontend\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"dependencies\": {\n \"@testing-library/jest-dom\": \"5.17.0\",\n \"@testing-library/react\": \"13.4.0\",\n \"@testing-library/user-event\": \"13.5.0\",\n \"ethers\": \"5.6.9\",\n \"react\": \"18.3.1\",\n \"react-dom\": \"18.3.1\",\n \"react-scripts\": \"5.0.1\",\n \"web-vitals\": \"2.1.4\"\n },\n \"scripts\": {\n \"start\": \"react-scripts start\",\n \"build\": \"react-scripts build\",\n \"test\": \"react-scripts test\",\n \"eject\": \"react-scripts eject\"\n },\n \"eslintConfig\": {\n \"extends\": [\n \"react-app\",\n \"react-app/jest\"\n ]\n },\n \"browserslist\": {\n \"production\": [\n \">0.2%\",\n \"not dead\",\n \"not op_mini all\"\n ],\n \"development\": [\n \"last 1 chrome version\",\n \"last 1 firefox version\",\n \"last 1 safari version\"\n ]\n }\n}\n"
},
{
"path": "03-Decentralized Guestbook/frontend/public/index.html",
"content": "\n\n \n \n \n \n \n \n \n \n \n \n React App\n \n \n \n \n \n \n\n"
},
{
"path": "03-Decentralized Guestbook/frontend/public/manifest.json",
"content": "{\n \"short_name\": \"React App\",\n \"name\": \"Create React App Sample\",\n \"icons\": [\n {\n \"src\": \"favicon.ico\",\n \"sizes\": \"64x64 32x32 24x24 16x16\",\n \"type\": \"image/x-icon\"\n },\n {\n \"src\": \"logo192.png\",\n \"type\": \"image/png\",\n \"sizes\": \"192x192\"\n },\n {\n \"src\": \"logo512.png\",\n \"type\": \"image/png\",\n \"sizes\": \"512x512\"\n }\n ],\n \"start_url\": \".\",\n \"display\": \"standalone\",\n \"theme_color\": \"#000000\",\n \"background_color\": \"#ffffff\"\n}\n"
},
{
"path": "03-Decentralized Guestbook/frontend/public/robots.txt",
"content": "# https://www.robotstxt.org/robotstxt.html\nUser-agent: *\nDisallow:\n"
},
{
"path": "03-Decentralized Guestbook/frontend/src/App.css",
"content": ".App {\n text-align: center;\n}\n\n.App-logo {\n height: 40vmin;\n pointer-events: none;\n}\n\n@media (prefers-reduced-motion: no-preference) {\n .App-logo {\n animation: App-logo-spin infinite 20s linear;\n }\n}\n\n.App-header {\n background-color: #282c34;\n min-height: 100vh;\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n font-size: calc(10px + 2vmin);\n color: white;\n}\n\n.App-link {\n color: #61dafb;\n}\n\n@keyframes App-logo-spin {\n from {\n transform: rotate(0deg);\n }\n to {\n transform: rotate(360deg);\n }\n}\n"
},
{
"path": "03-Decentralized Guestbook/frontend/src/App.js",
"content": "import React, { useState, useEffect } from 'react';\nimport { ethers } from 'ethers'; // Updated import for Web3Provider\nimport { Contract } from 'ethers';\nimport GuestbookArtifact from './GuestbookAbi.json';\n\nconst contractAddress = '0x2e8EDe4E6A5Fd2d93072dBcF1BBe324Ff1677302';\nconst GuestbookAbi = GuestbookArtifact.abi;\n\nfunction App() {\n const [contract, setContract] = useState(null);\n const [entries, setEntries] = useState([]);\n const [name, setName] = useState(\"\");\n const [message, setMessage] = useState(\"\");\n const [loading, setLoading] = useState(true);\n const [error, setError] = useState(\"\");\n\n useEffect(() => {\n const init = async () => {\n if (window.ethereum) {\n try {\n console.log(\"Connecting to MetaMask...\");\n const provider = new ethers.providers.Web3Provider(window.ethereum); // Updated to Web3Provider\n \n await provider.send(\"eth_requestAccounts\", []);\n\n const network = await provider.getNetwork();\n if (network.chainId !== 1114) {\n throw new Error(\"Please switch to the Core Testnet in MetaMask.\");\n }\n\n const signer = provider.getSigner();\n console.log(\"Signer obtained:\", signer);\n const tempContract = new Contract(contractAddress, GuestbookAbi, signer);\n setContract(tempContract);\n console.log(\"Contract initialized:\", tempContract);\n\n const entries = await tempContract.getEntries();\n setEntries(entries);\n console.log(\"Entries loaded:\", entries);\n } catch (error) {\n console.error(\"Error connecting to contract:\", error);\n setError(error.message);\n } finally {\n setLoading(false);\n }\n } else {\n console.error(\"Please install MetaMask!\");\n setError(\"Please install MetaMask!\");\n setLoading(false);\n }\n };\n init();\n }, []);\n\n const signGuestbook = async () => {\n if (!contract) {\n console.error(\"Contract is not initialized!\");\n setError(\"Contract is not initialized!\");\n return;\n }\n\n try {\n console.log(\"Signing guestbook with:\", name, message);\n const tx = await contract.signGuestbook(name, message, {\n gasLimit: 300000, \n });\n console.log(\"Transaction sent:\", tx);\n await tx.wait(); \n\n const updatedEntries = await contract.getEntries();\n setEntries(updatedEntries);\n console.log(\"Updated entries:\", updatedEntries);\n } catch (error) {\n console.error(\"Error signing guestbook:\", error);\n setError(\"Error signing guestbook. Please try again.\");\n }\n };\n\n return (\n
\n );\n}\n\nexport default App;\n"
},
{
"path": "03-Decentralized Guestbook/frontend/src/GuestbookAbi.json",
"content": "{\n \"_format\": \"hh-sol-artifact-1\",\n \"contractName\": \"Guestbook\",\n \"sourceName\": \"contracts/Guestbook.sol\",\n \"abi\": [\n {\n \"anonymous\": false,\n \"inputs\": [\n {\n \"indexed\": false,\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"indexed\": false,\n \"internalType\": \"string\",\n \"name\": \"message\",\n \"type\": \"string\"\n }\n ],\n \"name\": \"EntrySigned\",\n \"type\": \"event\"\n },\n {\n \"inputs\": [\n {\n \"internalType\": \"uint256\",\n \"name\": \"\",\n \"type\": \"uint256\"\n }\n ],\n \"name\": \"entries\",\n \"outputs\": [\n {\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"internalType\": \"string\",\n \"name\": \"message\",\n \"type\": \"string\"\n }\n ],\n \"stateMutability\": \"view\",\n \"type\": \"function\"\n },\n {\n \"inputs\": [],\n \"name\": \"getEntries\",\n \"outputs\": [\n {\n \"components\": [\n {\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"internalType\": \"string\",\n \"name\": \"message\",\n \"type\": \"string\"\n }\n ],\n \"internalType\": \"struct Guestbook.Entry[]\",\n \"name\": \"\",\n \"type\": \"tuple[]\"\n }\n ],\n \"stateMutability\": \"view\",\n \"type\": \"function\"\n },\n {\n \"inputs\": [\n {\n \"internalType\": \"string\",\n \"name\": \"_name\",\n \"type\": \"string\"\n },\n {\n \"internalType\": \"string\",\n \"name\": \"_message\",\n \"type\": \"string\"\n }\n ],\n \"name\": \"signGuestbook\",\n \"outputs\": [],\n \"stateMutability\": \"nonpayable\",\n \"type\": \"function\"\n }\n ],\n \"bytecode\": \"0x608060405234801561001057600080fd5b50610741806100206000396000f3fe608060405234801561001057600080fd5b50600436106100415760003560e01c80630ffcb0701461004657806317be85c31461005b578063b30906d414610079575b600080fd5b610059610054366004610553565b61009a565b005b610063610150565b6040516100709190610604565b60405180910390f35b61008c610087366004610689565b6102d3565b6040516100709291906106a2565b604080518082019091528281526020808201839052600080546001810182559080528251805160029092027f290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e56301926100f792849290910190610417565b5060208281015180516101109260018501920190610417565b5050507f0e8857b20aec2f13bb24d8ba5def534d3e73aa79fec2bcfd038c4d55e482deaa82826040516101449291906106a2565b60405180910390a15050565b60606000805480602002602001604051908101604052809291908181526020016000905b828210156102ca57838290600052602060002090600202016040518060400160405290816000820180546101a7906106d0565b80601f01602080910402602001604051908101604052809291908181526020018280546101d3906106d0565b80156102205780601f106101f557610100808354040283529160200191610220565b820191906000526020600020905b81548152906001019060200180831161020357829003601f168201915b50505050508152602001600182018054610239906106d0565b80601f0160208091040260200160405190810160405280929190818152602001828054610265906106d0565b80156102b25780601f10610287576101008083540402835291602001916102b2565b820191906000526020600020905b81548152906001019060200180831161029557829003601f168201915b50505050508152505081526020019060010190610174565b50505050905090565b600081815481106102e357600080fd5b9060005260206000209060020201600091509050806000018054610306906106d0565b80601f0160208091040260200160405190810160405280929190818152602001828054610332906106d0565b801561037f5780601f106103545761010080835404028352916020019161037f565b820191906000526020600020905b81548152906001019060200180831161036257829003601f168201915b505050505090806001018054610394906106d0565b80601f01602080910402602001604051908101604052809291908181526020018280546103c0906106d0565b801561040d5780601f106103e25761010080835404028352916020019161040d565b820191906000526020600020905b8154815290600101906020018083116103f057829003601f168201915b5050505050905082565b828054610423906106d0565b90600052602060002090601f016020900481019282610445576000855561048b565b82601f1061045e57805160ff191683800117855561048b565b8280016001018555821561048b579182015b8281111561048b578251825591602001919060010190610470565b5061049792915061049b565b5090565b5b80821115610497576000815560010161049c565b634e487b7160e01b600052604160045260246000fd5b600082601f8301126104d757600080fd5b813567ffffffffffffffff808211156104f2576104f26104b0565b604051601f8301601f19908116603f0116810190828211818310171561051a5761051a6104b0565b8160405283815286602085880101111561053357600080fd5b836020870160208301376000602085830101528094505050505092915050565b6000806040838503121561056657600080fd5b823567ffffffffffffffff8082111561057e57600080fd5b61058a868387016104c6565b935060208501359150808211156105a057600080fd5b506105ad858286016104c6565b9150509250929050565b6000815180845260005b818110156105dd576020818501810151868301820152016105c1565b818111156105ef576000602083870101525b50601f01601f19169290920160200192915050565b60006020808301818452808551808352604092508286019150828160051b87010184880160005b8381101561067b57888303603f190185528151805187855261064f888601826105b7565b91890151858303868b015291905061066781836105b7565b96890196945050509086019060010161062b565b509098975050505050505050565b60006020828403121561069b57600080fd5b5035919050565b6040815260006106b560408301856105b7565b82810360208401526106c781856105b7565b95945050505050565b600181811c908216806106e457607f821691505b6020821081141561070557634e487b7160e01b600052602260045260246000fd5b5091905056fea2646970667358221220de103d949600ba48036fe9ffaeb124297b28761f8942a55ba1c54f20c27d399964736f6c63430008090033\",\n \"deployedBytecode\": \"0x608060405234801561001057600080fd5b50600436106100415760003560e01c80630ffcb0701461004657806317be85c31461005b578063b30906d414610079575b600080fd5b610059610054366004610553565b61009a565b005b610063610150565b6040516100709190610604565b60405180910390f35b61008c610087366004610689565b6102d3565b6040516100709291906106a2565b604080518082019091528281526020808201839052600080546001810182559080528251805160029092027f290decd9548b62a8d60345a988386fc84ba6bc95484008f6362f93160ef3e56301926100f792849290910190610417565b5060208281015180516101109260018501920190610417565b5050507f0e8857b20aec2f13bb24d8ba5def534d3e73aa79fec2bcfd038c4d55e482deaa82826040516101449291906106a2565b60405180910390a15050565b60606000805480602002602001604051908101604052809291908181526020016000905b828210156102ca57838290600052602060002090600202016040518060400160405290816000820180546101a7906106d0565b80601f01602080910402602001604051908101604052809291908181526020018280546101d3906106d0565b80156102205780601f106101f557610100808354040283529160200191610220565b820191906000526020600020905b81548152906001019060200180831161020357829003601f168201915b50505050508152602001600182018054610239906106d0565b80601f0160208091040260200160405190810160405280929190818152602001828054610265906106d0565b80156102b25780601f10610287576101008083540402835291602001916102b2565b820191906000526020600020905b81548152906001019060200180831161029557829003601f168201915b50505050508152505081526020019060010190610174565b50505050905090565b600081815481106102e357600080fd5b9060005260206000209060020201600091509050806000018054610306906106d0565b80601f0160208091040260200160405190810160405280929190818152602001828054610332906106d0565b801561037f5780601f106103545761010080835404028352916020019161037f565b820191906000526020600020905b81548152906001019060200180831161036257829003601f168201915b505050505090806001018054610394906106d0565b80601f01602080910402602001604051908101604052809291908181526020018280546103c0906106d0565b801561040d5780601f106103e25761010080835404028352916020019161040d565b820191906000526020600020905b8154815290600101906020018083116103f057829003601f168201915b5050505050905082565b828054610423906106d0565b90600052602060002090601f016020900481019282610445576000855561048b565b82601f1061045e57805160ff191683800117855561048b565b8280016001018555821561048b579182015b8281111561048b578251825591602001919060010190610470565b5061049792915061049b565b5090565b5b80821115610497576000815560010161049c565b634e487b7160e01b600052604160045260246000fd5b600082601f8301126104d757600080fd5b813567ffffffffffffffff808211156104f2576104f26104b0565b604051601f8301601f19908116603f0116810190828211818310171561051a5761051a6104b0565b8160405283815286602085880101111561053357600080fd5b836020870160208301376000602085830101528094505050505092915050565b6000806040838503121561056657600080fd5b823567ffffffffffffffff8082111561057e57600080fd5b61058a868387016104c6565b935060208501359150808211156105a057600080fd5b506105ad858286016104c6565b9150509250929050565b6000815180845260005b818110156105dd576020818501810151868301820152016105c1565b818111156105ef576000602083870101525b50601f01601f19169290920160200192915050565b60006020808301818452808551808352604092508286019150828160051b87010184880160005b8381101561067b57888303603f190185528151805187855261064f888601826105b7565b91890151858303868b015291905061066781836105b7565b96890196945050509086019060010161062b565b509098975050505050505050565b60006020828403121561069b57600080fd5b5035919050565b6040815260006106b560408301856105b7565b82810360208401526106c781856105b7565b95945050505050565b600181811c908216806106e457607f821691505b6020821081141561070557634e487b7160e01b600052602260045260246000fd5b5091905056fea2646970667358221220de103d949600ba48036fe9ffaeb124297b28761f8942a55ba1c54f20c27d399964736f6c63430008090033\",\n \"linkReferences\": {},\n \"deployedLinkReferences\": {}\n}\n"
},
{
"path": "03-Decentralized Guestbook/frontend/src/index.css",
"content": "body {\n margin: 0;\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',\n 'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',\n sans-serif;\n -webkit-font-smoothing: antialiased;\n -moz-osx-font-smoothing: grayscale;\n}\n\ncode {\n font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New',\n monospace;\n}\n"
},
{
"path": "03-Decentralized Guestbook/frontend/src/index.js",
"content": "import React from 'react';\nimport ReactDOM from 'react-dom/client';\nimport './index.css';\nimport App from './App';\nimport reportWebVitals from './reportWebVitals';\n\nconst root = ReactDOM.createRoot(document.getElementById('root'));\nroot.render(\n \n \n \n);\n\n// If you want to start measuring performance in your app, pass a function\n// to log results (for example: reportWebVitals(console.log))\n// or send to an analytics endpoint. Learn more: https://bit.ly/CRA-vitals\nreportWebVitals();\n"
},
{
"path": "03-Decentralized Guestbook/frontend/src/reportWebVitals.js",
"content": "const reportWebVitals = onPerfEntry => {\n if (onPerfEntry && onPerfEntry instanceof Function) {\n import('web-vitals').then(({ getCLS, getFID, getFCP, getLCP, getTTFB }) => {\n getCLS(onPerfEntry);\n getFID(onPerfEntry);\n getFCP(onPerfEntry);\n getLCP(onPerfEntry);\n getTTFB(onPerfEntry);\n });\n }\n};\n\nexport default reportWebVitals;\n"
},
{
"path": "03-Decentralized Guestbook/frontend/src/setupTests.js",
"content": "// jest-dom adds custom jest matchers for asserting on DOM nodes.\n// allows you to do things like:\n// expect(element).toHaveTextContent(/react/i)\n// learn more: https://github.com/testing-library/jest-dom\nimport '@testing-library/jest-dom';\n"
},
{
"path": "03-Decentralized Guestbook/hardhat.config.js",
"content": "require(\"@nomicfoundation/hardhat-toolbox\");\nrequire(\"dotenv\").config();\n\n/** @type import('hardhat/config').HardhatUserConfig */\nconst PRIVATE_KEY = process.env.PRIVATE_KEY;\n\nmodule.exports = {\n solidity: \"0.8.28\",\n\n networks: {\n localhost: {\n url: \"http://127.0.0.1:8545/\",\n // accounts: Thanks hardhat!\n chainId: 31337,\n allowUnlimitedContractSize: true,\n },\n core: {\n url: 'https://rpc.test2.btcs.network',\n accounts: [PRIVATE_KEY],\n chainId: 1114,\n },\n },\n};\n"
},
{
"path": "03-Decentralized Guestbook/package.json",
"content": "{\n \"name\": \"guestbook-dapp\",\n \"version\": \"1.0.0\",\n \"main\": \"index.js\",\n \"scripts\": {\n \"test\": \"echo \\\"Error: no test specified\\\" && exit 1\"\n },\n \"keywords\": [],\n \"author\": \"\",\n \"license\": \"ISC\",\n \"description\": \"\",\n \"devDependencies\": {\n \"@nomicfoundation/hardhat-chai-matchers\": \"^2.0.8\",\n \"@nomicfoundation/hardhat-ethers\": \"^3.0.8\",\n \"@nomicfoundation/hardhat-ignition\": \"^0.15.11\",\n \"@nomicfoundation/hardhat-ignition-ethers\": \"^0.15.11\",\n \"@nomicfoundation/hardhat-network-helpers\": \"^1.0.12\",\n \"@nomicfoundation/hardhat-toolbox\": \"^5.0.0\",\n \"@nomicfoundation/hardhat-verify\": \"^2.0.14\",\n \"@nomiclabs/hardhat-ethers\": \"^2.2.3\",\n \"@nomiclabs/hardhat-waffle\": \"^2.0.6\",\n \"@typechain/ethers-v6\": \"^0.5.1\",\n \"@typechain/hardhat\": \"^9.1.0\",\n \"chai\": \"^4.5.0\",\n \"ethers\": \"^6.14.3\",\n \"hardhat\": \"^2.22.8\",\n \"hardhat-gas-reporter\": \"^1.0.10\",\n \"solidity-coverage\": \"^0.8.16\",\n \"typechain\": \"^8.3.2\"\n },\n \"dependencies\": {\n \"dotenv\": \"^16.5.0\",\n \"react\": \"^18.3.1\",\n \"react-dom\": \"^18.3.1\"\n }\n}\n"
},
{
"path": "03-Decentralized Guestbook/scripts/deploy.js",
"content": "const hre = require(\"hardhat\");\n\nasync function main() {\n\n const Guestbook = await hre.ethers.getContractFactory(\"Guestbook\");\n const guestbook = await Guestbook.deploy();\n\n\n console.log(\"Guestbook contract deployed to:\", guestbook.target);\n}\n\nmain().catch((error) => {\n console.error(error);\n process.exitCode = 1;\n});"
},
{
"path": "04-Pyth Pull Oracles/.gitignore",
"content": "node_modules\n.env\n\n# Hardhat files\n/cache\n/artifacts\n\n# TypeChain files\n/typechain\n/typechain-types\n\n# solidity-coverage files\n/coverage\n/coverage.json\n\n# Hardhat Ignition default folder for deployments against a local node\nignition/deployments/chain-31337\n"
},
{
"path": "04-Pyth Pull Oracles/README.md",
"content": "# Core Pyth Feed Boilerplate\n\nPyth Feed Boilerplate is a React-based dApp for fetching and displaying real-time price feeds from the Pyth Network. This boilerplate provides a quickstart template for developers to quickly create similar applications on the Core blockchain.\n\nPurpose: The quickstart guide helps developers rapidly set up a functional dApp with essential setup instructions and code snippets. For detailed instructions and advanced configurations, refer to the full-length guide further down.\n\n## Quickstart\n\nProject Setup: Clone the repository and install dependencies.\nConfiguration: Set up the Pyth price feed smart contract and integrate it with the React app.\nRunning the Application: Start the app and view real-time price feeds.\n\n### Prerequisites\n\nBefore setting up the project, ensure you have the following installed:\n\n- [Node.js and npm](https://nodejs.org/en/download/)\n- [MetaMask](https://metamask.io/download.html) browser extension\n- [Git](https://git-scm.com/downloads)\n\n### Setup\n\n### 1. Clone the Repository\n\nClone the repository to your local machine using GitHub Desktop or Git:\n\n```zsh\ngh repo clone Camnaz/Core-Pyth-Feed-Boiler\ncd Core-Pyth-Feed-Boiler\n```\n\n### 2. Install Dependencies\nNavigate to the project directory and install the necessary dependencies:\n\n```\nnpm install\n```\nNavigate to the frontend directory and install the dependencies:\n\n```zsh\ncd frontend\nnpm install\ncd ..\n```\n\n### 3. Configure the Project\n\n- Add **Private Key**: Create a '**secret.json**' file in the project root and add your private key.\n\n```json\n{\n \"PrivateKey\": \"your-private-key-here\"\n}\n```\n### 3.1 Compile Hardhat\n\n```\nnpx hardhat compile\n```\n\n>Once deployed, update Smart Contract Address: Open src/App.js and replace `0xYourContractAddress` with your deployed contract address on the Core blockchain.\n\n### 4. Install Babel Plugin\nInstall the Babel plugin to avoid dependency issues:\n\n```zsh\nnpm install --save-dev @babel/plugin-proposal-private-property-in-object\n```\n### 4.1 Navigate to frontend of project\n\n```\ncd frontend\n```\n\n### 5. Run the Application\nStart the React application:\n\n```zsh\nnpm start\n```\n\n### 6. Access the Application\nOpen your browser and navigate to if it has not already:\n\n```arduino\nhttp://localhost:3000\n```\n### 7. Conclusion\n\nCongratulations, you now have a Pyth data feed for CORE/USD, and are able to view the Core price live which is updated every few seconds. \nYou are able to use this boilerplate to imbed Pyth price feeds for Core into different Dapps, or as a learning resource.\n\n### Troubleshooting\nError: One of your dependencies, babel-preset-react-app, is importing the \"@babel/plugin-proposal-private-property-in-object\" package without declaring it in its dependencies.\nSolution: Install the Babel plugin manually:\n\n```zsh\nnpm install --save-dev @babel/plugin-proposal-private-property-in-object\n```\n\n**Error**: MetaMask - RPC Error: Request of type 'wallet_requestPermissions' already pending.\n\n**Solution**: Open MetaMask and approve or reject the pending permission request.\n\n**Error**: no matching function (argument=\"name\", value=\"updatePrice\", code=INVALID_ARGUMENT, version=abi/5.7.0)\n\n**Solution**: Ensure the ABI file is up-to-date and contains the correct function names.\n"
},
{
"path": "04-Pyth Pull Oracles/contracts/PythFeedBoilerplate.sol",
"content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.9;\n\nimport \"@pythnetwork/pyth-sdk-solidity/IPyth.sol\";\nimport \"@pythnetwork/pyth-sdk-solidity/PythStructs.sol\";\n\ncontract PythFeedBoilerplate {\n IPyth public pyth;\n\n constructor(address pythContract) {\n pyth = IPyth(pythContract);\n }\n\n function updatePrice(bytes[] calldata priceUpdate) public payable {\n uint fee = pyth.getUpdateFee(priceUpdate);\n pyth.updatePriceFeeds{ value: fee }(priceUpdate);\n }\n\n function getPrice(bytes32 priceFeedId) public view returns (PythStructs.Price memory) {\n return pyth.getPrice(priceFeedId);\n }\n\n function getPriceWithoutUpdate(bytes32 priceFeedId) public view returns (int64, int32) {\n PythStructs.Price memory price = pyth.getPrice(priceFeedId);\n return (price.price, price.expo);\n }\n}\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/.gitignore",
"content": "# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.\n\n# dependencies\n/node_modules\n/.pnp\n.pnp.js\n\n# testing\n/coverage\n\n# production\n/build\n\n# misc\n.DS_Store\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\n\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/README.md",
"content": "# Getting Started with Create React App\n\nThis project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).\n\n## Available Scripts\n\nIn the project directory, you can run:\n\n### `npm start`\n\nRuns the app in the development mode.\\\nOpen [http://localhost:3000](http://localhost:3000) to view it in your browser.\n\nThe page will reload when you make changes.\\\nYou may also see any lint errors in the console.\n\n### `npm test`\n\nLaunches the test runner in the interactive watch mode.\\\nSee the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.\n\n### `npm run build`\n\nBuilds the app for production to the `build` folder.\\\nIt correctly bundles React in production mode and optimizes the build for the best performance.\n\nThe build is minified and the filenames include the hashes.\\\nYour app is ready to be deployed!\n\nSee the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.\n\n### `npm run eject`\n\n**Note: this is a one-way operation. Once you `eject`, you can't go back!**\n\nIf you aren't satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.\n\nInstead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you're on your own.\n\nYou don't have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn't feel obligated to use this feature. However we understand that this tool wouldn't be useful if you couldn't customize it when you are ready for it.\n\n## Learn More\n\nYou can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).\n\nTo learn React, check out the [React documentation](https://reactjs.org/).\n\n### Code Splitting\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/code-splitting](https://facebook.github.io/create-react-app/docs/code-splitting)\n\n### Analyzing the Bundle Size\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size](https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size)\n\n### Making a Progressive Web App\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app](https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app)\n\n### Advanced Configuration\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/advanced-configuration](https://facebook.github.io/create-react-app/docs/advanced-configuration)\n\n### Deployment\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/deployment](https://facebook.github.io/create-react-app/docs/deployment)\n\n### `npm run build` fails to minify\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify](https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify)\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/package.json",
"content": "{\n \"name\": \"frontend\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"dependencies\": {\n \"@pythnetwork/pyth-sdk-solidity\": \"^4.2.0\",\n \"@testing-library/jest-dom\": \"5.17.0\",\n \"@testing-library/react\": \"13.4.0\",\n \"@testing-library/user-event\": \"13.5.0\",\n \"ethers\": \"^6.15.0\",\n \"react\": \"18.3.1\",\n \"react-dom\": \"18.3.1\",\n \"react-scripts\": \"5.0.1\",\n \"web-vitals\": \"^2.1.4\"\n },\n \"scripts\": {\n \"start\": \"react-scripts start\",\n \"build\": \"react-scripts build\",\n \"test\": \"react-scripts test\",\n \"eject\": \"react-scripts eject\"\n },\n \"eslintConfig\": {\n \"extends\": [\n \"react-app\",\n \"react-app/jest\"\n ]\n },\n \"browserslist\": {\n \"production\": [\n \">0.2%\",\n \"not dead\",\n \"not op_mini all\"\n ],\n \"development\": [\n \"last 1 chrome version\",\n \"last 1 firefox version\",\n \"last 1 safari version\"\n ]\n }\n}\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/public/index.html",
"content": "\n\n \n \n \n \n \n \n \n \n \n \n React App\n \n \n \n \n \n \n\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/public/manifest.json",
"content": "{\n \"short_name\": \"React App\",\n \"name\": \"Create React App Sample\",\n \"icons\": [\n {\n \"src\": \"favicon.ico\",\n \"sizes\": \"64x64 32x32 24x24 16x16\",\n \"type\": \"image/x-icon\"\n },\n {\n \"src\": \"logo192.png\",\n \"type\": \"image/png\",\n \"sizes\": \"192x192\"\n },\n {\n \"src\": \"logo512.png\",\n \"type\": \"image/png\",\n \"sizes\": \"512x512\"\n }\n ],\n \"start_url\": \".\",\n \"display\": \"standalone\",\n \"theme_color\": \"#000000\",\n \"background_color\": \"#ffffff\"\n}\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/public/robots.txt",
"content": "# https://www.robotstxt.org/robotstxt.html\nUser-agent: *\nDisallow:\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/src/App.css",
"content": "@import url('https://fonts.googleapis.com/css2?family=Lexend:wght@400;600&display=swap');\n\nbody {\n background-color: #121212;\n color: #292D32;\n font-family: 'Lexend', sans-serif;\n margin: 0;\n padding: 0;\n display: flex;\n justify-content: center;\n align-items: center;\n height: 100vh;\n}\n\n.App {\n text-align: center;\n}\n\n.App-header {\n background-color: #292D32;\n padding: 20px;\n border-radius: 10px;\n margin-bottom: 20px;\n color: #FBFCFC;\n}\n\n.App-title {\n margin: 0;\n text-align: left;\n color: #FFFFFF;\n}\n\n.price-container {\n background-color: #292D32;\n padding: 20px;\n border-radius: 10px;\n color: #FBFCFC;\n display: inline-block;\n margin-top: 20px;\n}\n\n.price {\n font-size: 1.5em;\n margin-top: 10px;\n color: #FFFFFF;\n}\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/src/App.js",
"content": "import React, { useEffect, useState } from 'react';\nimport { ethers } from 'ethers';\nimport './App.css';\n\n// Import Pyth ABI - we'll use require for JSON files\nconst PythAbi = require('@pythnetwork/pyth-sdk-solidity/abis/IPyth.json');\n\n// Core Mainnet\nconst contractAddress = '0xA2aa501b19aff244D90cc15a4Cf739D2725B5729';\nconst provider = new ethers.JsonRpcProvider('https://rpc.coredao.org');\nconst contract = new ethers.Contract(contractAddress, PythAbi, provider);\n\nconst priceId = '0x9b4503710cc8c53f75c30e6e4fda1a7064680ef2e0ee97acd2e3a7c37b3c830c'; // CORE/USD\nconst age = '60';\n\n\n\nfunction App() {\n const [price, setPrice] = useState(null);\n\n useEffect(() => {\n let intervalId;\n\n const fetchPrice = async () => {\n try {\n console.log('Fetching price...');\n \n // Use your new code to fetch price data\n const [price, conf, expo, timestamp] = await contract.getPriceNoOlderThan(priceId, age);\n \n console.log('Raw price data:', { price, conf, expo, timestamp });\n \n // Convert BigInt to Number for calculation\n const expoNumber = Number(expo);\n console.log('Exponent:', expoNumber);\n \n // Adjust the price based on the exponent\n // The price comes with a specific decimal precision, we need to adjust it\n const adjustedPrice = parseFloat(ethers.formatUnits(price, -expoNumber));\n setPrice(adjustedPrice.toFixed(5)); // Format to 5 decimal places\n console.log('Price fetched:', adjustedPrice);\n } catch (error) {\n console.error('Error fetching price:', error);\n }\n };\n\n // Fetch the price immediately when the component mounts\n fetchPrice();\n\n // Set up an interval to fetch the price every 2 minutes (120000 milliseconds)\n intervalId = setInterval(fetchPrice, 120000);\n\n // Clear the interval when the component unmounts\n return () => clearInterval(intervalId);\n }, []);\n\n return (\n
\n );\n}\n\nexport default App;\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/src/App.test.js",
"content": "import { render, screen } from '@testing-library/react';\nimport App from './App';\n\ntest('renders learn react link', () => {\n render();\n const linkElement = screen.getByText(/learn react/i);\n expect(linkElement).toBeInTheDocument();\n});\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/src/PythFeedBoilerplateAbi.json",
"content": "{\n \"_format\": \"hh-sol-artifact-1\",\n \"contractName\": \"PythFeedBoilerplate\",\n \"sourceName\": \"contracts/PythFeedBoilerplate.sol\",\n \"abi\": [\n {\n \"inputs\": [\n {\n \"internalType\": \"address\",\n \"name\": \"pythContract\",\n \"type\": \"address\"\n }\n ],\n \"stateMutability\": \"nonpayable\",\n \"type\": \"constructor\"\n },\n {\n \"inputs\": [\n {\n \"internalType\": \"bytes32\",\n \"name\": \"priceFeedId\",\n \"type\": \"bytes32\"\n }\n ],\n \"name\": \"getPrice\",\n \"outputs\": [\n {\n \"components\": [\n {\n \"internalType\": \"int64\",\n \"name\": \"price\",\n \"type\": \"int64\"\n },\n {\n \"internalType\": \"uint64\",\n \"name\": \"conf\",\n \"type\": \"uint64\"\n },\n {\n \"internalType\": \"int32\",\n \"name\": \"expo\",\n \"type\": \"int32\"\n },\n {\n \"internalType\": \"uint256\",\n \"name\": \"publishTime\",\n \"type\": \"uint256\"\n }\n ],\n \"internalType\": \"struct PythStructs.Price\",\n \"name\": \"\",\n \"type\": \"tuple\"\n }\n ],\n \"stateMutability\": \"view\",\n \"type\": \"function\"\n },\n {\n \"inputs\": [\n {\n \"internalType\": \"bytes32\",\n \"name\": \"priceFeedId\",\n \"type\": \"bytes32\"\n }\n ],\n \"name\": \"getPriceWithoutUpdate\",\n \"outputs\": [\n {\n \"internalType\": \"int64\",\n \"name\": \"\",\n \"type\": \"int64\"\n },\n {\n \"internalType\": \"int32\",\n \"name\": \"\",\n \"type\": \"int32\"\n }\n ],\n \"stateMutability\": \"view\",\n \"type\": \"function\"\n },\n {\n \"inputs\": [],\n \"name\": \"pyth\",\n \"outputs\": [\n {\n \"internalType\": \"contract IPyth\",\n \"name\": \"\",\n \"type\": \"address\"\n }\n ],\n \"stateMutability\": \"view\",\n \"type\": \"function\"\n },\n {\n \"inputs\": [\n {\n \"internalType\": \"bytes[]\",\n \"name\": \"priceUpdate\",\n \"type\": \"bytes[]\"\n }\n ],\n \"name\": \"updatePrice\",\n \"outputs\": [],\n \"stateMutability\": \"payable\",\n \"type\": \"function\"\n }\n ],\n \"bytecode\": \"0x608060405234801561001057600080fd5b5060405161064e38038061064e83398101604081905261002f91610054565b600080546001600160a01b0319166001600160a01b0392909216919091179055610084565b60006020828403121561006657600080fd5b81516001600160a01b038116811461007d57600080fd5b9392505050565b6105bb806100936000396000f3fe60806040526004361061003f5760003560e01c8063083a816b146100445780632592c0bf1461008657806331d98b3f1461009b578063f98d06f0146100fe575b600080fd5b34801561005057600080fd5b5061006461005f36600461035b565b610136565b6040805160079390930b835260039190910b6020830152015b60405180910390f35b610099610094366004610374565b6101ca565b005b3480156100a757600080fd5b506100bb6100b636600461035b565b6102b9565b60405161007d9190815160070b815260208083015167ffffffffffffffff169082015260408083015160030b908201526060918201519181019190915260800190565b34801561010a57600080fd5b5060005461011e906001600160a01b031681565b6040516001600160a01b03909116815260200161007d565b600080546040516331d98b3f60e01b815260048101849052829182916001600160a01b03909116906331d98b3f9060240160806040518083038186803b15801561017f57600080fd5b505afa158015610193573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101b79190610418565b8051604090910151909590945092505050565b6000805460405163d47eed4560e01b81526001600160a01b039091169063d47eed45906101fd90869086906004016104d1565b60206040518083038186803b15801561021557600080fd5b505afa158015610229573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061024d919061056c565b600054604051631df3cbc560e31b81529192506001600160a01b03169063ef9e5e2890839061028290879087906004016104d1565b6000604051808303818588803b15801561029b57600080fd5b505af11580156102af573d6000803e3d6000fd5b5050505050505050565b60408051608081018252600080825260208201819052818301819052606082018190525491516331d98b3f60e01b81526004810184905290916001600160a01b0316906331d98b3f9060240160806040518083038186803b15801561031d57600080fd5b505afa158015610331573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103559190610418565b92915050565b60006020828403121561036d57600080fd5b5035919050565b6000806020838503121561038757600080fd5b823567ffffffffffffffff8082111561039f57600080fd5b818501915085601f8301126103b357600080fd5b8135818111156103c257600080fd5b8660208260051b85010111156103d757600080fd5b60209290920196919550909350505050565b805167ffffffffffffffff8116811461040157600080fd5b919050565b8051600381900b811461040157600080fd5b60006080828403121561042a57600080fd5b6040516080810181811067ffffffffffffffff8211171561045b57634e487b7160e01b600052604160045260246000fd5b6040528251600781900b811461047057600080fd5b815261047e602084016103e9565b602082015261048f60408401610406565b6040820152606083015160608201528091505092915050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60208082528181018390526000906040600585901b8401810190840186845b8781101561055f57868403603f190183528135368a9003601e1901811261051657600080fd5b8901803567ffffffffffffffff81111561052f57600080fd5b8036038b131561053e57600080fd5b61054b86828985016104a8565b9550505091840191908401906001016104f0565b5091979650505050505050565b60006020828403121561057e57600080fd5b505191905056fea26469706673582212205d7a5e1856ba7a5ac5f0471280bd41bd8f274c6e9ad3dfe64a8057b660635c4564736f6c63430008090033\",\n \"deployedBytecode\": \"0x60806040526004361061003f5760003560e01c8063083a816b146100445780632592c0bf1461008657806331d98b3f1461009b578063f98d06f0146100fe575b600080fd5b34801561005057600080fd5b5061006461005f36600461035b565b610136565b6040805160079390930b835260039190910b6020830152015b60405180910390f35b610099610094366004610374565b6101ca565b005b3480156100a757600080fd5b506100bb6100b636600461035b565b6102b9565b60405161007d9190815160070b815260208083015167ffffffffffffffff169082015260408083015160030b908201526060918201519181019190915260800190565b34801561010a57600080fd5b5060005461011e906001600160a01b031681565b6040516001600160a01b03909116815260200161007d565b600080546040516331d98b3f60e01b815260048101849052829182916001600160a01b03909116906331d98b3f9060240160806040518083038186803b15801561017f57600080fd5b505afa158015610193573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906101b79190610418565b8051604090910151909590945092505050565b6000805460405163d47eed4560e01b81526001600160a01b039091169063d47eed45906101fd90869086906004016104d1565b60206040518083038186803b15801561021557600080fd5b505afa158015610229573d6000803e3d6000fd5b505050506040513d601f19601f8201168201806040525081019061024d919061056c565b600054604051631df3cbc560e31b81529192506001600160a01b03169063ef9e5e2890839061028290879087906004016104d1565b6000604051808303818588803b15801561029b57600080fd5b505af11580156102af573d6000803e3d6000fd5b5050505050505050565b60408051608081018252600080825260208201819052818301819052606082018190525491516331d98b3f60e01b81526004810184905290916001600160a01b0316906331d98b3f9060240160806040518083038186803b15801561031d57600080fd5b505afa158015610331573d6000803e3d6000fd5b505050506040513d601f19601f820116820180604052508101906103559190610418565b92915050565b60006020828403121561036d57600080fd5b5035919050565b6000806020838503121561038757600080fd5b823567ffffffffffffffff8082111561039f57600080fd5b818501915085601f8301126103b357600080fd5b8135818111156103c257600080fd5b8660208260051b85010111156103d757600080fd5b60209290920196919550909350505050565b805167ffffffffffffffff8116811461040157600080fd5b919050565b8051600381900b811461040157600080fd5b60006080828403121561042a57600080fd5b6040516080810181811067ffffffffffffffff8211171561045b57634e487b7160e01b600052604160045260246000fd5b6040528251600781900b811461047057600080fd5b815261047e602084016103e9565b602082015261048f60408401610406565b6040820152606083015160608201528091505092915050565b81835281816020850137506000828201602090810191909152601f909101601f19169091010190565b60208082528181018390526000906040600585901b8401810190840186845b8781101561055f57868403603f190183528135368a9003601e1901811261051657600080fd5b8901803567ffffffffffffffff81111561052f57600080fd5b8036038b131561053e57600080fd5b61054b86828985016104a8565b9550505091840191908401906001016104f0565b5091979650505050505050565b60006020828403121561057e57600080fd5b505191905056fea26469706673582212205d7a5e1856ba7a5ac5f0471280bd41bd8f274c6e9ad3dfe64a8057b660635c4564736f6c63430008090033\",\n \"linkReferences\": {},\n \"deployedLinkReferences\": {}\n}\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/src/index.css",
"content": "body {\n margin: 0;\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',\n 'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',\n sans-serif;\n -webkit-font-smoothing: antialiased;\n -moz-osx-font-smoothing: grayscale;\n}\n\ncode {\n font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New',\n monospace;\n}\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/src/index.js",
"content": "import React from 'react';\nimport ReactDOM from 'react-dom/client';\nimport './index.css';\nimport App from './App';\nimport reportWebVitals from './reportWebVitals';\n\nconst root = ReactDOM.createRoot(document.getElementById('root'));\nroot.render(\n \n \n \n);\n\n// If you want to start measuring performance in your app, pass a function\n// to log results (for example: reportWebVitals(console.log))\n// or send to an analytics endpoint. Learn more: https://bit.ly/CRA-vitals\nreportWebVitals();\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/src/reportWebVitals.js",
"content": "const reportWebVitals = onPerfEntry => {\n if (onPerfEntry && onPerfEntry instanceof Function) {\n import('web-vitals').then(({ getCLS, getFID, getFCP, getLCP, getTTFB }) => {\n getCLS(onPerfEntry);\n getFID(onPerfEntry);\n getFCP(onPerfEntry);\n getLCP(onPerfEntry);\n getTTFB(onPerfEntry);\n });\n }\n};\n\nexport default reportWebVitals;\n"
},
{
"path": "04-Pyth Pull Oracles/frontend/src/setupTests.js",
"content": "// jest-dom adds custom jest matchers for asserting on DOM nodes.\n// allows you to do things like:\n// expect(element).toHaveTextContent(/react/i)\n// learn more: https://github.com/testing-library/jest-dom\nimport '@testing-library/jest-dom';\n"
},
{
"path": "04-Pyth Pull Oracles/hardhat.config.js",
"content": "require('@nomiclabs/hardhat-ethers');\nrequire(\"@nomiclabs/hardhat-waffle\");\nrequire(\"dotenv\").config();\n\n/** @type import('hardhat/config').HardhatUserConfig */\nconst PRIVATE_KEY = process.env.PRIVATE_KEY;\n\nmodule.exports = {\n defaultNetwork: 'hardhat',\n\n networks: {\n hardhat: {},\n core_testnet: {\n url: 'https://rpc.test2.btcs.network',\n accounts: [PRIVATE_KEY],\n chainId: 1114,\n },\n },\n solidity: {\n compilers: [\n {\n version: '0.8.9',\n settings: {\n evmVersion: 'london',\n optimizer: {\n enabled: true,\n runs: 200,\n },\n },\n },\n ],\n },\n paths: {\n sources: './contracts',\n cache: './cache',\n artifacts: './artifacts',\n },\n mocha: {\n timeout: 20000,\n },\n};\n"
},
{
"path": "04-Pyth Pull Oracles/package.json",
"content": "{\n \"name\": \"pyth-feed-boilerplate\",\n \"version\": \"1.0.0\",\n \"main\": \"index.js\",\n \"scripts\": {\n \"test\": \"echo \\\"Error: no test specified\\\" && exit 1\"\n },\n \"keywords\": [],\n \"author\": \"\",\n \"license\": \"ISC\",\n \"description\": \"\",\n \"devDependencies\": {\n \"@babel/plugin-proposal-private-property-in-object\": \"^7.21.11\",\n \"hardhat\": \"^2.22.6\"\n },\n \"dependencies\": {\n \"@nomiclabs/hardhat-ethers\": \"^2.2.3\",\n \"@nomiclabs/hardhat-waffle\": \"^2.0.6\",\n \"@pythnetwork/pyth-sdk-solidity\": \"^3.1.0\",\n \"dotenv\": \"^16.5.0\",\n \"ethers\": \"^5.7.2\"\n }\n}\n"
},
{
"path": "04-Pyth Pull Oracles/scripts/deploy.js",
"content": "async function main() {\n const [deployer] = await ethers.getSigners();\n console.log(\"Deploying contracts with the account:\", deployer.address);\n\n // Replace with the actual Pyth contract address for CoreDAO testnet\n const pythContractAddress = \"0xA2aa501b19aff244D90cc15a4Cf739D2725B5729\"; // Replace with actual address\n\n const PythFeedBoilerplate = await ethers.getContractFactory(\"PythFeedBoilerplate\");\n const pythFeedBoilerplate = await PythFeedBoilerplate.deploy(pythContractAddress);\n\n console.log(\"PythFeedBoilerplate deployed to:\", pythFeedBoilerplate.address);\n}\n\nmain()\n .then(() => process.exit(0))\n .catch(error => {\n console.error(error);\n process.exit(1);\n });\n"
},
{
"path": "05-Hello-World-Dapp/.gitignore",
"content": "node_modules\n.env\nsecret.json\n\n# Hardhat files\n/cache\n/artifacts\n\n# TypeChain files\n/typechain\n/typechain-types\n\n# solidity-coverage files\n/coverage\n/coverage.json\n\n# Hardhat Ignition default folder for deployments against a local node\nignition/deployments/chain-31337\n"
},
{
"path": "05-Hello-World-Dapp/README.md",
"content": "# Simple Hello World dApp on Core\nIn this tutorial, you'll learn how to build a simple decentralized application (dApp) using the Core blockchain TestNet. The focus will be on creating a \"Hello World\" dApp that interacts with a smart contract. This dApp will allow users to store, retrieve, and update a message on the blockchain. By following the steps in this guide, you will gain hands-on experience with MetaMask wallet integration, smart contract development, and front-end interaction using the Ethers.js library.\n\n## What Are We Building\nIn this tutorial, we'll develop a simple Hello World decentralized application (dApp) that stores a message in a smart contract deployed on the Core blockchain TestNet. The dApp also has the functionality to retrieve and display the stored message.\n\n## Learning Takeaways\nThis tutorial will help you gain knowledge on the following learning points:\n\n* MetaMask Wallet connectivity to Core Testnet;\n* Smart contract development and deployment on Core Testnet;\n* Front-end integration with the smart contract using Ethers.js library;\n* Read data from a smart contract;\n* Write data to a smart contract;\n\n## Software Prerequisites\n* [Git](https://git-scm.com/) v2.44.0\n* [Node.js](https://nodejs.org/en) v20.11.1\n* [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) v10.2.4\n* [Hardhat](https://hardhat.org/hardhat-runner/docs/getting-started#installation) v2.22.7\n* [MetaMask Web Wallet Extension](https://metamask.io/download/)\n\n## Setting up the development environment\n\n1. Create a new directory for the project and navigate into it\n\n```bash\nmkdir hello-world-dapp\ncd hello-world-dapp\n```\n2. Install Hardhat\n\n```bash\nnpm init --yes\nnpm install --save-dev hardhat\n```\n3. Initialize Hardhat project by running the following command\n\n```bash\nnpx hardhat init\n```\n\n\n\n4. Once this project is initialized, you'll find the following project structure:\n\n```bash\ndapp-tutorial.\n| .gitignore\n| hardhat-config.js \n| package-lock.json\n| package.json\n| README.md\n| \n+---contracts \n| Lock.sol\n| \n+---ignition \n| \\---modules\n| Lock.js\n| \n+---node_modules\n| \n+---test \n| Lock.js \n| \n```\n\n5. Install and configure MetaMask Chrome Extension to use with Core Testnet. Refer [here](https://docs.coredao.org/docs/Dev-Guide/core-testnet-wallet-config) for a detailed guide.\n\n6. Create a secret.json file in the root folder and store the private key of your MetaMask wallet in it. Refer [here](https://metamask.zendesk.com/hc/en-us/articles/360015290032-How-to-reveal-your-Secret-Recovery-Phrase) for details on how to get MetaMask account's private key.\n\n```json\n{\"PrivateKey\":\"you private key, do not leak this file, do keep it absolutely safe\"}\n```\n\n> Do not forget to add this file to the `.gitignore` file in the root folder of your project so that you don't accidentally check your private keys/secret phrases into a public repository. Make sure you keep this file in an absolutely safe place!\n\n7. Copy the following into your `hardhat.config.js` file\n\n```js\nrequire(\"@nomicfoundation/hardhat-toolbox\");\nrequire(\"dotenv\").config();\n\n/** @type import('hardhat/config').HardhatUserConfig */\n\nconst PRIVATE_KEY = process.env.PRIVATE_KEY;\n\nmodule.exports = {\n defaultNetwork: 'core_testnet',\n\n networks: {\n hardhat: {\n },\n core_testnet: {\n url: 'https://rpc.test2.btcs.network',\n accounts: [PRIVATE_KEY],\n chainId: 1115,\n }\n },\n solidity: {\n compilers: [\n {\n version: '0.8.26',\n settings: {\n evmVersion: 'paris',\n optimizer: {\n enabled: true,\n runs: 200,\n },\n },\n },\n ],\n },\n paths: {\n sources: './contracts',\n cache: './cache',\n artifacts: './artifacts',\n },\n mocha: {\n timeout: 60000,\n },\n};\n```\n\n## Writing HelloWorld Smart Contract\n\n1. Navigate to the `contracts` folder in the root directory of your project.\n2. Delete the `Lock.sol` file; create a new file `HelloWorld.sol` and paste the following contents into it.\n\n```javascript\n// SPDX-License-Identifier: MIT\npragma solidity ^0.8.26;\n\ncontract HelloWorld {\n string public message;\n\n constructor(string memory _message) {\n message = _message;\n }\n\n function setMessage(string memory _message) public {\n message = _message;\n }\n}\n\n```\n### Explanation\nThe `HelloWorld` Solidity contract stores a message in a public string variable. It initializes this message through the constructor when the contract is deployed. The `setMessage` function allows anyone to update the stored message. The `public` keyword makes the `message` variable readable by anyone.\n\n#### State Variable\n* `string public message`: Public string variable to store and read a message.\n#### Constructor\n* `constructor(string memory _message) { message = _message; }`: Initializes the message state variable with a value provided during deployment.\n#### Function\n* `function setMessage(string memory _message) public { message = _message; }`: Allows updating the message state variable.\n\n## Compiling Smart Contract\n\n1. To compile the `HelloWorld` smart contract defined in the `HelloWorld.sol`, from the root directory run the following command\n\n```bash\nnpx hardhat compile\n```\n\n## Testing HelloWorld Smart Contracts\n\n1. Before deploying your smart contract on the Core blockchain, it is best adviced to first run a series of tests making sure that the smart contract is working as desired. \n\n2. Inside the `test` folder, delete the `Lock.js` file, create a new file `HelloWorld.js` and update it with the following:\n\n```javascript\nconst { expect } = require(\"chai\");\n\ndescribe(\"HelloWorld contract\", function () {\n let HelloWorld;\n let helloWorld;\n let owner;\n\n beforeEach(async function () {\n HelloWorld = await ethers.getContractFactory(\"HelloWorld\");\n [owner] = await ethers.getSigners();\n helloWorld = await HelloWorld.deploy(\"Hello, world!\");\n await helloWorld.waitForDeployment(); \n });\n\n it(\"Should return the initial message\", async function () {\n expect(await helloWorld.message()).to.equal(\"Hello, world!\");\n });\n\n it(\"Should update the message\", async function () {\n const tx =await helloWorld.setMessage(\"Hello, Hardhat!\");\n await tx.wait(); // Wait for the transaction to be mined\n expect(await helloWorld.message()).to.equal(\"Hello, Hardhat!\");\n });\n});\n```\n\n### Explanation\nThis test script is designed to validate the behavior of the HelloWorld smart contract. In the setup phase (beforeEach), it deploys a new instance of the contract with the initial message \"Hello, world!\" and waits for the deployment to complete.\n\nThe first test, \"Should return the initial message,\" checks that the contract correctly returns the initial message stored during deployment. It ensures that the message is set to \"Hello, world!\" as expected.\n\nThe second test, \"Should update the message,\" updates the message to \"Hello, Hardhat!\" and then verifies that the message has been updated successfully by checking its new value. This ensures that the setMessage function works correctly and the contract's state is updated as intended.\n\nThis test script checks the functionality of the HelloWorld contract:\n\n* **Setup:** It deploys the HelloWorld contract with the initial message \"Hello, world!\" before each test.\n* **Test Initial Message:** It verifies that the contract's initial message is correctly set to \"Hello, world!\".\n* **Test Update Message:** It updates the message to \"Hello, Hardhat!\" and confirms that the change is successfully reflected.\n\nOverall, these tests confirm that the contract's functionality for setting and retrieving messages operates correctly.\n\n3. Run the test scripts using the command `npx hardhat test` \n\n\n\n## Deploying HelloWorld Smart Contract \n\n1. Create a `scripts` folder in the root directory of your project. Inside this folder, create a file `deploy.js`; paste the following script into it.\n\n```javascript\nconst { ethers } = require(\"hardhat\");\n\nasync function main() {\n const [deployer] = await ethers.getSigners();\n\n console.log(\"Deploying contract with the account:\", deployer.address);\n\n const HelloWorld = await ethers.getContractFactory(\"HelloWorld\");\n const helloWorld = await HelloWorld.deploy(\"Hello, World\");\n\n console.log(\"HelloWorld Contract Address:\", await helloWorld.getAddress());\n}\n\nmain()\n .then(() => process.exit(0))\n .catch((error) => {\n console.error(error);\n process.exit(1);\n });\n```\n3. Make sure your MetaMask wallet has tCORE test tokens for the Core Testnet. Refer [here](https://docs.coredao.org/docs/Dev-Guide/core-faucet) for details on how to get tCORE tokens from Core Faucet. \n\n4. Run the following command from the root directory of your project, to deploy your smart contract on the Core Chain.\n\n```bash\nnpx hardhat run scripts/deploy.js\n```\n\nIf succesfully deployed, you will get the following output\n\n\n\n5. Make sure to save the Address of HelloWorld Contract at which is deployed, as obtained above, this will be used for interacting with smart contract from the dApp's frontend.\n\n🎉 Congratulations! You have successfully learned how to create, compile, and deploy a smart contract on the Core Chain Testnet using the Hardhat. \n\n## Interacting with Smart Contract through Frontend\n\n⚡️ Let's create a frontend interface for interacting with the `HelloWorld` smart contract.\n\n### Set Up React Project\n1. Run the following commands to create a react project and install the required depencendy of `ethers.js` to communicate with the HelloWorld smart contract.\n\n```bash\nnpx create-react-app frontend\ncd frontend\nnpm install ethers\n``` \n### Getting HelloWorld Contract ABI\n* Copy the `HelloWorld.json` file from `artifacts/contracts/HelloWorld.sol/` to the `frontend/src/Contract-ABI` directory.\n\n### Create the React Components\n\n* Inside `src`, create a file named `HelloWorld.js`. Ensure you replace placeholders like `YOUR_CONTRACT_ADDRESS` with actual values from your deployment.\n```javascript\nimport React, { useState, useEffect } from 'react';\nimport { ethers } from 'ethers';\nimport { toast, ToastContainer } from 'react-toastify'; // Import ToastContainer and toast\nimport 'react-toastify/dist/ReactToastify.css'; // Import the CSS for toast notifications\nimport './HelloWorld.css'; // Import the CSS file\n\n// Import ABI from JSON file\nimport HelloWorldABI from './Contract-ABI/HelloWorld.json';\n\n// Import the logo image\nimport logo from './core-dao-logo.png'; // Adjust the path as needed\n\n// Replace with your contract's address\nconst contractAddress = \"0xBF46BAA6210Ae6c9050F5453B996070209f69830\";\n\nfunction HelloWorld() {\n const [message, setMessage] = useState('');\n const [newMessage, setNewMessage] = useState('');\n const [provider, setProvider] = useState(null);\n const [contract, setContract] = useState(null);\n const [showMessage, setShowMessage] = useState(false); // State to control message visibility\n\n useEffect(() => {\n async function init() {\n if (!window.ethereum) {\n toast.error(\"No crypto wallet found. Please install MetaMask.\");\n return;\n }\n\n try {\n // Prompt user to connect MetaMask\n await window.ethereum.request({ method: 'eth_requestAccounts' });\n\n const provider = new ethers.BrowserProvider(window.ethereum);\n const signer = await provider.getSigner();\n const contract = new ethers.Contract(contractAddress, HelloWorldABI.abi, signer);\n setProvider(provider);\n setContract(contract);\n } catch (error) {\n toast.error(\"Failed to connect to MetaMask. Please try again.\");\n console.error(\"Error initializing MetaMask:\", error);\n }\n }\n\n init();\n }, []);\n\n const updateMessage = async () => {\n if (!contract) return;\n try {\n const tx = await contract.setMessage(newMessage);\n await tx.wait();\n setNewMessage(''); // Clear the input field after updating\n toast.success(\"Message updated successfully!\");\n } catch (error) {\n toast.error(\"Failed to update message. Please try again.\");\n console.error(\"Error updating message:\", error);\n }\n };\n\n const retrieveMessage = async () => {\n if (!contract) return;\n try {\n const currentMessage = await contract.message();\n setMessage(currentMessage);\n setShowMessage(true); // Show the message after retrieval\n toast.success(\"Message retrieved successfully!\");\n } catch (error) {\n toast.error(\"Failed to retrieve message. Please try again.\");\n console.error(\"Error retrieving message:\", error);\n }\n };\n\n return (\n
\n );\n}\n\nexport default App;\n```\n\n## Running Your Application\n* Start the React Development Server using the command `npm run start`\n\n```bash\nnpm start\nYour application should now be accessible at http://localhost:3000.\n```\n\n## Interact with the dApp\n\nOpen your React app in the browser. You should be able to retrieve and set messages using your deployed contract.\n\n\n🎉 Congratulations! You've just interacted with your newly-deployed contract using your dApp's front end! You can build on the codebase by deploying and interacting with different contracts, and by adding new UI components to the website for your users.\n"
},
{
"path": "05-Hello-World-Dapp/contracts/HelloWorld.sol",
"content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.26;\n\ncontract HelloWorld {\n string public message;\n\n constructor(string memory _message) {\n message = _message;\n }\n\n function setMessage(string memory _message) public {\n message = _message;\n }\n}\n"
},
{
"path": "05-Hello-World-Dapp/contracts/Lock.sol",
"content": "// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.24;\n\n// Uncomment this line to use console.log\n// import \"hardhat/console.sol\";\n\ncontract Lock {\n uint public unlockTime;\n address payable public owner;\n\n event Withdrawal(uint amount, uint when);\n\n constructor(uint _unlockTime) payable {\n require(\n block.timestamp < _unlockTime,\n \"Unlock time should be in the future\"\n );\n\n unlockTime = _unlockTime;\n owner = payable(msg.sender);\n }\n\n function withdraw() public {\n // Uncomment this line, and the import of \"hardhat/console.sol\", to print a log in your terminal\n // console.log(\"Unlock time is %o and block timestamp is %o\", unlockTime, block.timestamp);\n\n require(block.timestamp >= unlockTime, \"You can't withdraw yet\");\n require(msg.sender == owner, \"You aren't the owner\");\n\n emit Withdrawal(address(this).balance, block.timestamp);\n\n owner.transfer(address(this).balance);\n }\n}\n"
},
{
"path": "05-Hello-World-Dapp/frontend/.gitignore",
"content": "# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.\n\n# dependencies\n/node_modules\n/.pnp\n.pnp.js\n\n# testing\n/coverage\n\n# production\n/build\n\n# misc\n.DS_Store\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\n\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n"
},
{
"path": "05-Hello-World-Dapp/frontend/README.md",
"content": "# Getting Started with Create React App\n\nThis project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).\n\n## Available Scripts\n\nIn the project directory, you can run:\n\n### `npm start`\n\nRuns the app in the development mode.\\\nOpen [http://localhost:3000](http://localhost:3000) to view it in your browser.\n\nThe page will reload when you make changes.\\\nYou may also see any lint errors in the console.\n\n### `npm test`\n\nLaunches the test runner in the interactive watch mode.\\\nSee the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.\n\n### `npm run build`\n\nBuilds the app for production to the `build` folder.\\\nIt correctly bundles React in production mode and optimizes the build for the best performance.\n\nThe build is minified and the filenames include the hashes.\\\nYour app is ready to be deployed!\n\nSee the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.\n\n### `npm run eject`\n\n**Note: this is a one-way operation. Once you `eject`, you can't go back!**\n\nIf you aren't satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.\n\nInstead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you're on your own.\n\nYou don't have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn't feel obligated to use this feature. However we understand that this tool wouldn't be useful if you couldn't customize it when you are ready for it.\n\n## Learn More\n\nYou can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).\n\nTo learn React, check out the [React documentation](https://reactjs.org/).\n\n### Code Splitting\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/code-splitting](https://facebook.github.io/create-react-app/docs/code-splitting)\n\n### Analyzing the Bundle Size\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size](https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size)\n\n### Making a Progressive Web App\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app](https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app)\n\n### Advanced Configuration\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/advanced-configuration](https://facebook.github.io/create-react-app/docs/advanced-configuration)\n\n### Deployment\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/deployment](https://facebook.github.io/create-react-app/docs/deployment)\n\n### `npm run build` fails to minify\n\nThis section has moved here: [https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify](https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify)\n"
},
{
"path": "05-Hello-World-Dapp/frontend/package.json",
"content": "{\n \"name\": \"frontend\",\n \"version\": \"0.1.0\",\n \"private\": true,\n \"dependencies\": {\n \"@testing-library/jest-dom\": \"5.17.0\",\n \"@testing-library/react\": \"13.4.0\",\n \"@testing-library/user-event\": \"13.5.0\",\n \"ethers\": \"6.13.2\",\n \"react\": \"18.3.1\",\n \"react-dom\": \"18.3.1\",\n \"react-scripts\": \"5.0.1\",\n \"web-vitals\": \"^2.1.4\"\n },\n \"scripts\": {\n \"start\": \"react-scripts start\",\n \"build\": \"react-scripts build\",\n \"test\": \"react-scripts test\",\n \"eject\": \"react-scripts eject\"\n },\n \"eslintConfig\": {\n \"extends\": [\n \"react-app\",\n \"react-app/jest\"\n ]\n },\n \"browserslist\": {\n \"production\": [\n \">0.2%\",\n \"not dead\",\n \"not op_mini all\"\n ],\n \"development\": [\n \"last 1 chrome version\",\n \"last 1 firefox version\",\n \"last 1 safari version\"\n ]\n },\n \"devDependencies\": {\n \"react-toastify\": \"^10.0.5\"\n }\n}\n"
},
{
"path": "05-Hello-World-Dapp/frontend/public/index.html",
"content": "\n\n \n \n \n \n \n \n \n \n \n \n React App\n \n \n \n \n \n \n\n"
},
{
"path": "05-Hello-World-Dapp/frontend/public/manifest.json",
"content": "{\n \"short_name\": \"React App\",\n \"name\": \"Create React App Sample\",\n \"icons\": [\n {\n \"src\": \"favicon.ico\",\n \"sizes\": \"64x64 32x32 24x24 16x16\",\n \"type\": \"image/x-icon\"\n },\n {\n \"src\": \"logo192.png\",\n \"type\": \"image/png\",\n \"sizes\": \"192x192\"\n },\n {\n \"src\": \"logo512.png\",\n \"type\": \"image/png\",\n \"sizes\": \"512x512\"\n }\n ],\n \"start_url\": \".\",\n \"display\": \"standalone\",\n \"theme_color\": \"#000000\",\n \"background_color\": \"#ffffff\"\n}\n"
},
{
"path": "05-Hello-World-Dapp/frontend/public/robots.txt",
"content": "# https://www.robotstxt.org/robotstxt.html\nUser-agent: *\nDisallow:\n"
},
{
"path": "05-Hello-World-Dapp/frontend/src/App.css",
"content": ".App {\n text-align: center;\n}\n\n.App-logo {\n height: 40vmin;\n pointer-events: none;\n}\n\n@media (prefers-reduced-motion: no-preference) {\n .App-logo {\n animation: App-logo-spin infinite 20s linear;\n }\n}\n\n.App-header {\n background-color: #282c34;\n min-height: 100vh;\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n font-size: calc(10px + 2vmin);\n color: white;\n}\n\n.App-link {\n color: #61dafb;\n}\n\n@keyframes App-logo-spin {\n from {\n transform: rotate(0deg);\n }\n to {\n transform: rotate(360deg);\n }\n}\n"
},
{
"path": "05-Hello-World-Dapp/frontend/src/App.js",
"content": "import React from 'react';\nimport './App.css';\nimport HelloWorld from './HelloWorld';\n\nfunction App() {\n return (\n
\n \n \n \n
\n );\n}\n\nexport default App;\n"
},
{
"path": "05-Hello-World-Dapp/frontend/src/App.test.js",
"content": "import { render, screen } from '@testing-library/react';\nimport App from './App';\n\ntest('renders learn react link', () => {\n render();\n const linkElement = screen.getByText(/learn react/i);\n expect(linkElement).toBeInTheDocument();\n});\n"
},
{
"path": "05-Hello-World-Dapp/frontend/src/Contract-ABI/HelloWorld.json",
"content": "{\n \"_format\": \"hh-sol-artifact-1\",\n \"contractName\": \"HelloWorld\",\n \"sourceName\": \"contracts/HelloWorld.sol\",\n \"abi\": [\n {\n \"inputs\": [\n {\n \"internalType\": \"string\",\n \"name\": \"_message\",\n \"type\": \"string\"\n }\n ],\n \"stateMutability\": \"nonpayable\",\n \"type\": \"constructor\"\n },\n {\n \"inputs\": [],\n \"name\": \"message\",\n \"outputs\": [\n {\n \"internalType\": \"string\",\n \"name\": \"\",\n \"type\": \"string\"\n }\n ],\n \"stateMutability\": \"view\",\n \"type\": \"function\"\n },\n {\n \"inputs\": [\n {\n \"internalType\": \"string\",\n \"name\": \"_message\",\n \"type\": \"string\"\n }\n ],\n \"name\": \"setMessage\",\n \"outputs\": [],\n \"stateMutability\": \"nonpayable\",\n \"type\": \"function\"\n }\n ],\n \"bytecode\": \"0x608060405234801561001057600080fd5b5060405161062138038061062183398101604081905261002f91610058565b600061003b82826101ad565b505061026b565b634e487b7160e01b600052604160045260246000fd5b60006020828403121561006a57600080fd5b81516001600160401b0381111561008057600080fd5b8201601f8101841361009157600080fd5b80516001600160401b038111156100aa576100aa610042565b604051601f8201601f19908116603f011681016001600160401b03811182821017156100d8576100d8610042565b6040528181528282016020018610156100f057600080fd5b60005b8281101561010f576020818501810151838301820152016100f3565b50600091810160200191909152949350505050565b600181811c9082168061013857607f821691505b60208210810361015857634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156101a857806000526020600020601f840160051c810160208510156101855750805b601f840160051c820191505b818110156101a55760008155600101610191565b50505b505050565b81516001600160401b038111156101c6576101c6610042565b6101da816101d48454610124565b8461015e565b6020601f82116001811461020e57600083156101f65750848201515b600019600385901b1c1916600184901b1784556101a5565b600084815260208120601f198516915b8281101561023e578785015182556020948501946001909201910161021e565b508482101561025c5786840151600019600387901b60f8161c191681555b50505050600190811b01905550565b6103a78061027a6000396000f3fe608060405234801561001057600080fd5b50600436106100365760003560e01c8063368b87721461003b578063e21f37ce14610050575b600080fd5b61004e610049366004610122565b61006e565b005b61005861007e565b60405161006591906101db565b60405180910390f35b600061007a82826102b2565b5050565b6000805461008b90610229565b80601f01602080910402602001604051908101604052809291908181526020018280546100b790610229565b80156101045780601f106100d957610100808354040283529160200191610104565b820191906000526020600020905b8154815290600101906020018083116100e757829003601f168201915b505050505081565b634e487b7160e01b600052604160045260246000fd5b60006020828403121561013457600080fd5b813567ffffffffffffffff81111561014b57600080fd5b8201601f8101841361015c57600080fd5b803567ffffffffffffffff8111156101765761017661010c565b604051601f8201601f19908116603f0116810167ffffffffffffffff811182821017156101a5576101a561010c565b6040528181528282016020018610156101bd57600080fd5b81602084016020830137600091810160200191909152949350505050565b602081526000825180602084015260005b8181101561020957602081860181015160408684010152016101ec565b506000604082850101526040601f19601f83011684010191505092915050565b600181811c9082168061023d57607f821691505b60208210810361025d57634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156102ad57806000526020600020601f840160051c8101602085101561028a5750805b601f840160051c820191505b818110156102aa5760008155600101610296565b50505b505050565b815167ffffffffffffffff8111156102cc576102cc61010c565b6102e0816102da8454610229565b84610263565b6020601f82116001811461031457600083156102fc5750848201515b600019600385901b1c1916600184901b1784556102aa565b600084815260208120601f198516915b828110156103445787850151825560209485019460019092019101610324565b50848210156103625786840151600019600387901b60f8161c191681555b50505050600190811b0190555056fea26469706673582212200901b2e271d38e15a461cb148f993399b3ccb61d788adadb0e62f7d9526a4ff764736f6c634300081a0033\",\n \"deployedBytecode\": \"0x608060405234801561001057600080fd5b50600436106100365760003560e01c8063368b87721461003b578063e21f37ce14610050575b600080fd5b61004e610049366004610122565b61006e565b005b61005861007e565b60405161006591906101db565b60405180910390f35b600061007a82826102b2565b5050565b6000805461008b90610229565b80601f01602080910402602001604051908101604052809291908181526020018280546100b790610229565b80156101045780601f106100d957610100808354040283529160200191610104565b820191906000526020600020905b8154815290600101906020018083116100e757829003601f168201915b505050505081565b634e487b7160e01b600052604160045260246000fd5b60006020828403121561013457600080fd5b813567ffffffffffffffff81111561014b57600080fd5b8201601f8101841361015c57600080fd5b803567ffffffffffffffff8111156101765761017661010c565b604051601f8201601f19908116603f0116810167ffffffffffffffff811182821017156101a5576101a561010c565b6040528181528282016020018610156101bd57600080fd5b81602084016020830137600091810160200191909152949350505050565b602081526000825180602084015260005b8181101561020957602081860181015160408684010152016101ec565b506000604082850101526040601f19601f83011684010191505092915050565b600181811c9082168061023d57607f821691505b60208210810361025d57634e487b7160e01b600052602260045260246000fd5b50919050565b601f8211156102ad57806000526020600020601f840160051c8101602085101561028a5750805b601f840160051c820191505b818110156102aa5760008155600101610296565b50505b505050565b815167ffffffffffffffff8111156102cc576102cc61010c565b6102e0816102da8454610229565b84610263565b6020601f82116001811461031457600083156102fc5750848201515b600019600385901b1c1916600184901b1784556102aa565b600084815260208120601f198516915b828110156103445787850151825560209485019460019092019101610324565b50848210156103625786840151600019600387901b60f8161c191681555b50505050600190811b0190555056fea26469706673582212200901b2e271d38e15a461cb148f993399b3ccb61d788adadb0e62f7d9526a4ff764736f6c634300081a0033\",\n \"linkReferences\": {},\n \"deployedLinkReferences\": {}\n}\n"
},
{
"path": "05-Hello-World-Dapp/frontend/src/HelloWorld.css",
"content": "/* Container for the entire component */\n.container {\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n height: 100vh; /* Full viewport height */\n width: 100vw; /* Full viewport width */\n background-color: #2e2e2e; /* Darker gray background */\n color: #e0e0e0; /* Light gray text for better readability */\n padding: 20px;\n box-sizing: border-box; /* Ensure padding is included in height and width */\n}\n\n/* Style for the logo */\n.logo {\n width: 200px; /* Larger size for visibility */\n margin-bottom: 40px;\n border-radius: 10px; /* Rounded corners for the logo */\n box-shadow: 0 4px 8px rgba(0, 0, 0, 0.5); /* Shadow for depth */\n}\n\n/* Style for the retrieve button and update button */\n.retrieve-button, .update-button {\n background-color: #ff920f; /* Updated orange color */\n color: white;\n border: none;\n padding: 14px 28px; /* Slightly larger padding */\n margin: 10px;\n cursor: pointer;\n border-radius: 8px;\n font-size: 18px;\n transition: background-color 0.3s ease, transform 0.2s ease;\n}\n\n.retrieve-button:hover, .update-button:hover {\n background-color: #e67e22; /* Darker orange for hover effect */\n transform: scale(1.05); /* Slightly enlarge button on hover */\n}\n\n/* Style for the message display */\n.message-display {\n font-size: 28px; /* Larger font size for better visibility */\n margin-bottom: 20px; /* Space below the message */\n font-weight: bold;\n color: #ffd54f; /* Bright yellow color for contrast */\n}\n\n/* Style for the input field */\n.input-field {\n padding: 14px;\n border: 1px solid #555; /* Darker border for visibility */\n border-radius: 8px;\n width: 80%;\n max-width: 500px; /* Increased max-width for larger screens */\n margin-bottom: 20px; /* Space below the input field */\n font-size: 18px;\n background-color: #424242; /* Slightly lighter gray for input background */\n color: #fff; /* White text color for the input field */\n transition: background-color 0.3s ease, border-color 0.3s ease;\n}\n\n/* Adding gap specifically between input field and retrieve button */\n.retrieve-button {\n margin-top: 20px; /* Adjust the gap as needed */\n}\n\n.input-field:focus {\n background-color: #616161; /* Lighter gray on focus */\n border-color: #ff920f; /* Orange border on focus */\n outline: none;\n}\n"
},
{
"path": "05-Hello-World-Dapp/frontend/src/HelloWorld.js",
"content": "import React, { useState, useEffect } from 'react';\nimport { ethers } from 'ethers';\nimport { toast, ToastContainer } from 'react-toastify'; // Import ToastContainer and toast\nimport 'react-toastify/dist/ReactToastify.css'; // Import the CSS for toast notifications\nimport './HelloWorld.css'; // Import the CSS file\n\n// Import ABI from JSON file\nimport HelloWorldABI from './Contract-ABI/HelloWorld.json';\n\n// Import the logo image\nimport logo from './core-dao-logo.png'; // Adjust the path as needed\n\n// Replace with your contract's address\nconst contractAddress = \"0xf5d9Dd0f6EAa91802979707b91407d8448136DD0\";\n\nfunction HelloWorld() {\n const [message, setMessage] = useState('');\n const [newMessage, setNewMessage] = useState('');\n //const [provider, setProvider] = useState(null);\n const [contract, setContract] = useState(null);\n const [showMessage, setShowMessage] = useState(false); // State to control message visibility\n\n useEffect(() => {\n async function init() {\n if (!window.ethereum) {\n toast.error(\"No crypto wallet found. Please install MetaMask.\");\n return;\n }\n\n try {\n // Prompt user to connect MetaMask\n await window.ethereum.request({ method: 'eth_requestAccounts' });\n\n const provider = new ethers.BrowserProvider(window.ethereum);\n const signer = await provider.getSigner();\n const contract = new ethers.Contract(contractAddress, HelloWorldABI.abi, signer);\n //setProvider(provider);\n setContract(contract);\n } catch (error) {\n toast.error(\"Failed to connect to MetaMask. Please try again.\");\n console.error(\"Error initializing MetaMask:\", error);\n }\n }\n\n init();\n }, []);\n\n const updateMessage = async () => {\n if (!contract) return;\n try {\n const tx = await contract.setMessage(newMessage);\n await tx.wait();\n setNewMessage(''); // Clear the input field after updating\n toast.success(\"Message updated successfully!\");\n } catch (error) {\n toast.error(\"Failed to update message. Please try again.\");\n console.error(\"Error updating message:\", error);\n }\n };\n\n const retrieveMessage = async () => {\n if (!contract) return;\n try {\n const currentMessage = await contract.message();\n setMessage(currentMessage);\n setShowMessage(true); // Show the message after retrieval\n toast.success(\"Message retrieved successfully!\");\n } catch (error) {\n toast.error(\"Failed to retrieve message. Please try again.\");\n console.error(\"Error retrieving message:\", error);\n }\n };\n\n return (\n
\n );\n}\n\nexport default HelloWorld;\n"
},
{
"path": "05-Hello-World-Dapp/frontend/src/index.css",
"content": "body {\n margin: 0;\n font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',\n 'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',\n sans-serif;\n -webkit-font-smoothing: antialiased;\n -moz-osx-font-smoothing: grayscale;\n}\n\ncode {\n font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New',\n monospace;\n}\n"
},
{
"path": "05-Hello-World-Dapp/frontend/src/index.js",
"content": "import React from 'react';\nimport ReactDOM from 'react-dom/client';\nimport './index.css';\nimport App from './App';\nimport reportWebVitals from './reportWebVitals';\n\nconst root = ReactDOM.createRoot(document.getElementById('root'));\nroot.render(\n \n \n \n);\n\n// If you want to start measuring performance in your app, pass a function\n// to log results (for example: reportWebVitals(console.log))\n// or send to an analytics endpoint. Learn more: https://bit.ly/CRA-vitals\nreportWebVitals();\n"
},
{
"path": "05-Hello-World-Dapp/frontend/src/reportWebVitals.js",
"content": "const reportWebVitals = onPerfEntry => {\n if (onPerfEntry && onPerfEntry instanceof Function) {\n import('web-vitals').then(({ getCLS, getFID, getFCP, getLCP, getTTFB }) => {\n getCLS(onPerfEntry);\n getFID(onPerfEntry);\n getFCP(onPerfEntry);\n getLCP(onPerfEntry);\n getTTFB(onPerfEntry);\n });\n }\n};\n\nexport default reportWebVitals;\n"
},
{
"path": "05-Hello-World-Dapp/frontend/src/setupTests.js",
"content": "// jest-dom adds custom jest matchers for asserting on DOM nodes.\n// allows you to do things like:\n// expect(element).toHaveTextContent(/react/i)\n// learn more: https://github.com/testing-library/jest-dom\nimport '@testing-library/jest-dom';\n"
},
{
"path": "05-Hello-World-Dapp/hardhat.config.js",
"content": "require(\"@nomicfoundation/hardhat-toolbox\");\nrequire(\"dotenv\").config();\n\n/** @type import('hardhat/config').HardhatUserConfig */\n\nconst PRIVATE_KEY = process.env.PRIVATE_KEY;\n\nmodule.exports = {\n defaultNetwork: 'hardhat',\n\n networks: {\n hardhat: {\n },\n core_testnet: {\n url: 'https://rpc.test2.btcs.network',\n accounts: [PRIVATE_KEY],\n chainId: 1114,\n }\n },\n solidity: {\n compilers: [\n {\n version: '0.8.26',\n settings: {\n evmVersion: 'shanghai',\n optimizer: {\n enabled: true,\n runs: 200,\n },\n },\n },\n ],\n },\n paths: {\n sources: './contracts',\n cache: './cache',\n artifacts: './artifacts',\n },\n mocha: {\n timeout: 60000,\n },\n};\n"
},
{
"path": "05-Hello-World-Dapp/ignition/modules/Lock.js",
"content": "const { buildModule } = require(\"@nomicfoundation/hardhat-ignition/modules\");\n\nconst JAN_1ST_2030 = 1893456000;\nconst ONE_GWEI = 1_000_000_000n;\n\nmodule.exports = buildModule(\"LockModule\", (m) => {\n const unlockTime = m.getParameter(\"unlockTime\", JAN_1ST_2030);\n const lockedAmount = m.getParameter(\"lockedAmount\", ONE_GWEI);\n\n const lock = m.contract(\"Lock\", [unlockTime], {\n value: lockedAmount,\n });\n\n return { lock };\n});\n"
},
{
"path": "05-Hello-World-Dapp/npx",
"content": ""
},
{
"path": "05-Hello-World-Dapp/package.json",
"content": "{\n \"name\": \"hardhat-project\",\n \"devDependencies\": {\n \"@nomicfoundation/hardhat-toolbox\": \"^5.0.0\",\n \"hardhat\": \"^2.22.7\"\n },\n \"description\": \"This project demonstrates a basic Hardhat use case. It comes with a sample contract, a test for that contract, and a Hardhat Ignition module that deploys that contract.\",\n \"version\": \"1.0.0\",\n \"main\": \"hardhat.config.js\",\n \"directories\": {\n \"test\": \"test\"\n },\n \"dependencies\": {\n \"dotenv\": \"^16.5.0\"\n },\n \"scripts\": {\n \"test\": \"mocha\"\n },\n \"keywords\": [],\n \"author\": \"\",\n \"license\": \"ISC\"\n}\n"
},
{
"path": "05-Hello-World-Dapp/scripts/deploy.js",
"content": "const { ethers } = require(\"hardhat\");\n\nasync function main() {\n const [deployer] = await ethers.getSigners();\n\n console.log(\"Deploying contract with the account:\", deployer.address);\n\n const HelloWorld = await ethers.getContractFactory(\"HelloWorld\");\n const helloWorld = await HelloWorld.deploy(\"Hello, World\");\n\n console.log(\"HelloWorld Contract Address:\", await helloWorld.getAddress());\n}\n\nmain()\n .then(() => process.exit(0))\n .catch((error) => {\n console.error(error);\n process.exit(1);\n });"
},
{
"path": "05-Hello-World-Dapp/test/HelloWorld.js",
"content": "const { expect } = require(\"chai\");\n\ndescribe(\"HelloWorld contract\", function () {\n let HelloWorld;\n let helloWorld;\n let owner;\n\n beforeEach(async function () {\n HelloWorld = await ethers.getContractFactory(\"HelloWorld\");\n [owner] = await ethers.getSigners();\n helloWorld = await HelloWorld.deploy(\"Hello, world!\");\n await helloWorld.waitForDeployment(); \n });\n\n it(\"Should return the initial message\", async function () {\n expect(await helloWorld.message()).to.equal(\"Hello, world!\");\n });\n\n it(\"Should update the message\", async function () {\n const tx =await helloWorld.setMessage(\"Hello, Hardhat!\");\n await tx.wait(); // Wait for the transaction to be mined\n expect(await helloWorld.message()).to.equal(\"Hello, Hardhat!\");\n });\n});\n"
},
{
"path": "06-Subgraphs-on-Core/README.md",
"content": "# Guestbook Subgraph\n\nThis repository contains the subgraph for the Guestbook application on the Core Network. The subgraph indexes events and data from the Guestbook smart contract, allowing for easy querying using GraphQL.\n\n## Table of Contents\n\n- [Prerequisites](#prerequisites)\n- [Clone the Repository](#clone-the-repository)\n- [Configuration](#configuration)\n- [Install Dependencies](#install-dependencies)\n- [Deploying with Docker](#deploying-with-docker)\n- [Deploying the Subgraph](#deploying-the-subgraph)\n- [Interacting with the Subgraph](#interacting-with-the-subgraph)\n- [Troubleshooting](#troubleshooting)\n\n## Prerequisites\n\nBefore you begin, ensure you have the following installed:\n\n- [Node.js](https://nodejs.org/en/) (v14 or later)\n- [npm](https://www.npmjs.com/)\n- [Docker](https://www.docker.com/)\n- [Git](https://git-scm.com/)\n\n## Clone the Repository\n\nTo clone the repository locally, run the following commands:\n\n```bash\ngit clone https://github.com/coredao-org/dapp-tutorial.git\ncd dapp-tutorial/06-Subgraphs-on-Core\n```\n\n## Configuration\n\n### Environment Variables\n\nYou need to set up the following environment variables to configure deployment:\n\nCreate a .env file in the root directory:\n\n```bash\ntouch.env\n```\n\n2. Add the necessary environment variables to the .env file:\n\n```env\nGRAPH_NODE=https://thegraph-node.test.btcs.network/\nIPFS_NODE=https://thegraph-ipfs.test.btcs.network/\nGRAPH_ACCESS_TOKEN=your_access_token_here\n```\n\n### Subgraph Configuration\n\nEnsure your subgraph.yaml file is correctly set up with the necessary contract addresses and start blocks.\n\n```zsh\nnpm install\n```\n\nThis will install all required packages including @graphprotocol/graph-cli and @graphprotocol/graph-ts.\n\n## Deploying with Docker\n\nYou can deploy your subgraph using Docker to simulate a local environment.\n\n1. Build and Start Docker Containers:\n\n```zsh\ndocker-compose up -d\n```\n\n2. Check Docker Containers:\n\n```zsh\ndocker ps\n```\n\nEnsure all necessary containers are running.\n\n## Deploying the Subgraph\n\n### Authenticate with Graph Node\n\nIf not already authenticated, authenticate your deployment key:\n\n```zsh\nexport GRAPH_ACCESS_TOKEN=08e38ec0513b40fd9b6a4428923d06ac\n```\n\n\n### Generate code and build the subgraph:\n\n```bash\ngraph codegen\ngraph build\n```\n\n### Create and Deploy Subgraph\n\n```\ngraph create \\\n --node $GRAPH_NODE \\\n --access-token $GRAPH_ACCESS_TOKEN \\\n your-subgraph-name\n```\n\n```\ngraph deploy \\\n --node $GRAPH_NODE \\\n --ipfs $IPFS_NODE \\\n --access-token $GRAPH_ACCESS_TOKEN \\\n your-subgraph-name\n```\n\nReplace your-subgraph-name with your deployment target.\n\n### Query the Subgraph\nAfter deployment, your subgraph will be available at the query endpoint (e.g., https://thegraph.test2.btcs.network/subgraphs/name/guestbook-subgraph).\n\nExample query:\n\n```\n{\n entrySigneds(first: 10, orderBy: blockTimestamp, orderDirection: desc) {\n id\n name\n message\n blockNumber\n blockTimestamp\n transactionHash\n }\n}\n```\n\nYou can use GraphQL, Apollo Client, or any GraphQL tool to query your data.\n\n\n\n\n\n\n\n\n\n"
},
{
"path": "06-Subgraphs-on-Core/abis/Guestbook.json",
"content": "[\n {\n \"anonymous\": false,\n \"inputs\": [\n {\n \"indexed\": false,\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"indexed\": false,\n \"internalType\": \"string\",\n \"name\": \"message\",\n \"type\": \"string\"\n }\n ],\n \"name\": \"EntrySigned\",\n \"type\": \"event\"\n },\n {\n \"inputs\": [{ \"internalType\": \"uint256\", \"name\": \"\", \"type\": \"uint256\" }],\n \"name\": \"entries\",\n \"outputs\": [\n { \"internalType\": \"string\", \"name\": \"name\", \"type\": \"string\" },\n { \"internalType\": \"string\", \"name\": \"message\", \"type\": \"string\" }\n ],\n \"stateMutability\": \"view\",\n \"type\": \"function\"\n },\n {\n \"inputs\": [],\n \"name\": \"getEntries\",\n \"outputs\": [\n {\n \"components\": [\n { \"internalType\": \"string\", \"name\": \"name\", \"type\": \"string\" },\n { \"internalType\": \"string\", \"name\": \"message\", \"type\": \"string\" }\n ],\n \"internalType\": \"struct Guestbook.Entry[]\",\n \"name\": \"\",\n \"type\": \"tuple[]\"\n }\n ],\n \"stateMutability\": \"view\",\n \"type\": \"function\"\n },\n {\n \"inputs\": [\n { \"internalType\": \"string\", \"name\": \"_name\", \"type\": \"string\" },\n { \"internalType\": \"string\", \"name\": \"_message\", \"type\": \"string\" }\n ],\n \"name\": \"signGuestbook\",\n \"outputs\": [],\n \"stateMutability\": \"nonpayable\",\n \"type\": \"function\"\n }\n]\n"
},
{
"path": "06-Subgraphs-on-Core/build/Guestbook/Guestbook.json",
"content": "[\n {\n \"anonymous\": false,\n \"inputs\": [\n {\n \"indexed\": false,\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"indexed\": false,\n \"internalType\": \"string\",\n \"name\": \"message\",\n \"type\": \"string\"\n }\n ],\n \"name\": \"EntrySigned\",\n \"type\": \"event\"\n },\n {\n \"inputs\": [\n {\n \"internalType\": \"uint256\",\n \"name\": \"\",\n \"type\": \"uint256\"\n }\n ],\n \"name\": \"entries\",\n \"outputs\": [\n {\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"internalType\": \"string\",\n \"name\": \"message\",\n \"type\": \"string\"\n }\n ],\n \"stateMutability\": \"view\",\n \"type\": \"function\"\n },\n {\n \"inputs\": [],\n \"name\": \"getEntries\",\n \"outputs\": [\n {\n \"components\": [\n {\n \"internalType\": \"string\",\n \"name\": \"name\",\n \"type\": \"string\"\n },\n {\n \"internalType\": \"string\",\n \"name\": \"message\",\n \"type\": \"string\"\n }\n ],\n \"internalType\": \"struct Guestbook.Entry[]\",\n \"name\": \"\",\n \"type\": \"tuple[]\"\n }\n ],\n \"stateMutability\": \"view\",\n \"type\": \"function\"\n },\n {\n \"inputs\": [\n {\n \"internalType\": \"string\",\n \"name\": \"_name\",\n \"type\": \"string\"\n },\n {\n \"internalType\": \"string\",\n \"name\": \"_message\",\n \"type\": \"string\"\n }\n ],\n \"name\": \"signGuestbook\",\n \"outputs\": [],\n \"stateMutability\": \"nonpayable\",\n \"type\": \"function\"\n }\n]"
},
{
"path": "06-Subgraphs-on-Core/build/schema.graphql",
"content": "type EntrySigned @entity(immutable: true) {\n id: Bytes!\n name: String! # string\n message: String! # string\n blockNumber: BigInt!\n blockTimestamp: BigInt!\n transactionHash: Bytes!\n}\n"
},
{
"path": "06-Subgraphs-on-Core/build/subgraph.yaml",
"content": "specVersion: 1.0.0\nindexerHints:\n prune: auto\nschema:\n file: schema.graphql\ndataSources:\n - kind: ethereum\n name: Guestbook\n network: core\n source:\n address: \"0x0D0b3bAc514d53AafC95c74294Bb1B613D1862c2\"\n abi: Guestbook\n startBlock: 22122890\n mapping:\n kind: ethereum/events\n apiVersion: 0.0.7\n language: wasm/assemblyscript\n entities:\n - EntrySigned\n abis:\n - name: Guestbook\n file: Guestbook/Guestbook.json\n eventHandlers:\n - event: EntrySigned(string,string)\n handler: handleEntrySigned\n file: Guestbook/Guestbook.wasm\n"
},
{
"path": "06-Subgraphs-on-Core/docker-compose.yml",
"content": "version: \"3\"\nservices:\n graph-node:\n image: graphprotocol/graph-node\n ports:\n - \"8000:8000\"\n - \"8001:8001\"\n - \"8020:8020\"\n - \"8030:8030\"\n - \"8040:8040\"\n depends_on:\n - ipfs\n - postgres\n extra_hosts:\n - host.docker.internal:host-gateway\n environment:\n postgres_host: postgres\n postgres_user: graph-node\n postgres_pass: let-me-in\n postgres_db: graph-node\n ipfs: \"ipfs:5001\"\n ethereum: \"core-testnet:https://rpc.test.btcs.network\"\n GRAPH_LOG: info\n ipfs:\n image: ipfs/kubo:v0.17.0\n ports:\n - \"5001:5001\"\n volumes:\n - ./data/ipfs:/data/ipfs\n postgres:\n image: postgres:14\n ports:\n - \"5432:5432\"\n command:\n [\n \"postgres\",\n \"-cshared_preload_libraries=pg_stat_statements\",\n \"-cmax_connections=200\",\n ]\n environment:\n POSTGRES_USER: graph-node\n POSTGRES_PASSWORD: let-me-in\n POSTGRES_DB: graph-node\n # FIXME: remove this env. var. which we shouldn't need. Introduced by\n # , maybe as a\n # workaround for https://github.com/docker/for-mac/issues/6270?\n PGDATA: \"/var/lib/postgresql/data\"\n POSTGRES_INITDB_ARGS: \"-E UTF8 --locale=C\"\n volumes:\n - ./data/postgres:/var/lib/postgresql/data\n"
},
{
"path": "06-Subgraphs-on-Core/generated/Guestbook/Guestbook.ts",
"content": "// THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.\n\nimport {\n ethereum,\n JSONValue,\n TypedMap,\n Entity,\n Bytes,\n Address,\n BigInt,\n} from \"@graphprotocol/graph-ts\";\n\nexport class EntrySigned extends ethereum.Event {\n get params(): EntrySigned__Params {\n return new EntrySigned__Params(this);\n }\n}\n\nexport class EntrySigned__Params {\n _event: EntrySigned;\n\n constructor(event: EntrySigned) {\n this._event = event;\n }\n\n get name(): string {\n return this._event.parameters[0].value.toString();\n }\n\n get message(): string {\n return this._event.parameters[1].value.toString();\n }\n}\n\nexport class Guestbook__entriesResult {\n value0: string;\n value1: string;\n\n constructor(value0: string, value1: string) {\n this.value0 = value0;\n this.value1 = value1;\n }\n\n toMap(): TypedMap {\n let map = new TypedMap();\n map.set(\"value0\", ethereum.Value.fromString(this.value0));\n map.set(\"value1\", ethereum.Value.fromString(this.value1));\n return map;\n }\n\n getName(): string {\n return this.value0;\n }\n\n getMessage(): string {\n return this.value1;\n }\n}\n\nexport class Guestbook__getEntriesResultValue0Struct extends ethereum.Tuple {\n get name(): string {\n return this[0].toString();\n }\n\n get message(): string {\n return this[1].toString();\n }\n}\n\nexport class Guestbook extends ethereum.SmartContract {\n static bind(address: Address): Guestbook {\n return new Guestbook(\"Guestbook\", address);\n }\n\n entries(param0: BigInt): Guestbook__entriesResult {\n let result = super.call(\"entries\", \"entries(uint256):(string,string)\", [\n ethereum.Value.fromUnsignedBigInt(param0),\n ]);\n\n return new Guestbook__entriesResult(\n result[0].toString(),\n result[1].toString(),\n );\n }\n\n try_entries(param0: BigInt): ethereum.CallResult {\n let result = super.tryCall(\"entries\", \"entries(uint256):(string,string)\", [\n ethereum.Value.fromUnsignedBigInt(param0),\n ]);\n if (result.reverted) {\n return new ethereum.CallResult();\n }\n let value = result.value;\n return ethereum.CallResult.fromValue(\n new Guestbook__entriesResult(value[0].toString(), value[1].toString()),\n );\n }\n\n getEntries(): Array {\n let result = super.call(\n \"getEntries\",\n \"getEntries():((string,string)[])\",\n [],\n );\n\n return result[0].toTupleArray();\n }\n\n try_getEntries(): ethereum.CallResult<\n Array\n > {\n let result = super.tryCall(\n \"getEntries\",\n \"getEntries():((string,string)[])\",\n [],\n );\n if (result.reverted) {\n return new ethereum.CallResult();\n }\n let value = result.value;\n return ethereum.CallResult.fromValue(\n value[0].toTupleArray(),\n );\n }\n}\n\nexport class SignGuestbookCall extends ethereum.Call {\n get inputs(): SignGuestbookCall__Inputs {\n return new SignGuestbookCall__Inputs(this);\n }\n\n get outputs(): SignGuestbookCall__Outputs {\n return new SignGuestbookCall__Outputs(this);\n }\n}\n\nexport class SignGuestbookCall__Inputs {\n _call: SignGuestbookCall;\n\n constructor(call: SignGuestbookCall) {\n this._call = call;\n }\n\n get _name(): string {\n return this._call.inputValues[0].value.toString();\n }\n\n get _message(): string {\n return this._call.inputValues[1].value.toString();\n }\n}\n\nexport class SignGuestbookCall__Outputs {\n _call: SignGuestbookCall;\n\n constructor(call: SignGuestbookCall) {\n this._call = call;\n }\n}\n"
},
{
"path": "06-Subgraphs-on-Core/generated/schema.ts",
"content": "// THIS IS AN AUTOGENERATED FILE. DO NOT EDIT THIS FILE DIRECTLY.\n\nimport {\n TypedMap,\n Entity,\n Value,\n ValueKind,\n store,\n Bytes,\n BigInt,\n BigDecimal,\n} from \"@graphprotocol/graph-ts\";\n\nexport class EntrySigned extends Entity {\n constructor(id: Bytes) {\n super();\n this.set(\"id\", Value.fromBytes(id));\n }\n\n save(): void {\n let id = this.get(\"id\");\n assert(id != null, \"Cannot save EntrySigned entity without an ID\");\n if (id) {\n assert(\n id.kind == ValueKind.BYTES,\n `Entities of type EntrySigned must have an ID of type Bytes but the id '${id.displayData()}' is of type ${id.displayKind()}`,\n );\n store.set(\"EntrySigned\", id.toBytes().toHexString(), this);\n }\n }\n\n static loadInBlock(id: Bytes): EntrySigned | null {\n return changetype(\n store.get_in_block(\"EntrySigned\", id.toHexString()),\n );\n }\n\n static load(id: Bytes): EntrySigned | null {\n return changetype(\n store.get(\"EntrySigned\", id.toHexString()),\n );\n }\n\n get id(): Bytes {\n let value = this.get(\"id\");\n if (!value || value.kind == ValueKind.NULL) {\n throw new Error(\"Cannot return null for a required field.\");\n } else {\n return value.toBytes();\n }\n }\n\n set id(value: Bytes) {\n this.set(\"id\", Value.fromBytes(value));\n }\n\n get name(): string {\n let value = this.get(\"name\");\n if (!value || value.kind == ValueKind.NULL) {\n throw new Error(\"Cannot return null for a required field.\");\n } else {\n return value.toString();\n }\n }\n\n set name(value: string) {\n this.set(\"name\", Value.fromString(value));\n }\n\n get message(): string {\n let value = this.get(\"message\");\n if (!value || value.kind == ValueKind.NULL) {\n throw new Error(\"Cannot return null for a required field.\");\n } else {\n return value.toString();\n }\n }\n\n set message(value: string) {\n this.set(\"message\", Value.fromString(value));\n }\n\n get blockNumber(): BigInt {\n let value = this.get(\"blockNumber\");\n if (!value || value.kind == ValueKind.NULL) {\n throw new Error(\"Cannot return null for a required field.\");\n } else {\n return value.toBigInt();\n }\n }\n\n set blockNumber(value: BigInt) {\n this.set(\"blockNumber\", Value.fromBigInt(value));\n }\n\n get blockTimestamp(): BigInt {\n let value = this.get(\"blockTimestamp\");\n if (!value || value.kind == ValueKind.NULL) {\n throw new Error(\"Cannot return null for a required field.\");\n } else {\n return value.toBigInt();\n }\n }\n\n set blockTimestamp(value: BigInt) {\n this.set(\"blockTimestamp\", Value.fromBigInt(value));\n }\n\n get transactionHash(): Bytes {\n let value = this.get(\"transactionHash\");\n if (!value || value.kind == ValueKind.NULL) {\n throw new Error(\"Cannot return null for a required field.\");\n } else {\n return value.toBytes();\n }\n }\n\n set transactionHash(value: Bytes) {\n this.set(\"transactionHash\", Value.fromBytes(value));\n }\n}\n"
},
{
"path": "06-Subgraphs-on-Core/networks.json",
"content": "{\n \"core\": {\n \"Guestbook\": {\n \"address\": \"0x0D0b3bAc514d53AafC95c74294Bb1B613D1862c2\",\n \"startBlock\": 22122890\n }\n }\n}"
},
{
"path": "06-Subgraphs-on-Core/package.json",
"content": "{\n \"name\": \"guestbook-subgraph\",\n \"license\": \"UNLICENSED\",\n \"scripts\": {\n \"codegen\": \"graph codegen\",\n \"build\": \"graph build\",\n \"deploy\": \"graph deploy --node https://api.studio.thegraph.com/deploy/ guestbook-subgraph\",\n \"create-local\": \"graph create --node http://localhost:8020/ guestbook-subgraph\",\n \"remove-local\": \"graph remove --node http://localhost:8020/ guestbook-subgraph\",\n \"deploy-local\": \"graph deploy --node http://localhost:8020/ --ipfs http://localhost:5001 guestbook-subgraph\",\n \"test\": \"graph test\"\n },\n \"dependencies\": {\n \"@graphprotocol/graph-cli\": \"0.80.0\",\n \"@graphprotocol/graph-ts\": \"0.32.0\"\n },\n \"devDependencies\": { \"matchstick-as\": \"0.5.0\" }\n}\n"
},
{
"path": "06-Subgraphs-on-Core/schema.graphql",
"content": "type EntrySigned @entity(immutable: true) {\n id: Bytes!\n name: String! # string\n message: String! # string\n blockNumber: BigInt!\n blockTimestamp: BigInt!\n transactionHash: Bytes!\n}\n"
},
{
"path": "06-Subgraphs-on-Core/src/guestbook.ts",
"content": "import { EntrySigned as EntrySignedEvent } from \"../generated/Guestbook/Guestbook\"\nimport { EntrySigned } from \"../generated/schema\"\n\nexport function handleEntrySigned(event: EntrySignedEvent): void {\n let entity = new EntrySigned(\n event.transaction.hash.concatI32(event.logIndex.toI32())\n )\n entity.name = event.params.name\n entity.message = event.params.message\n\n entity.blockNumber = event.block.number\n entity.blockTimestamp = event.block.timestamp\n entity.transactionHash = event.transaction.hash\n\n entity.save()\n}\n"
},
{
"path": "06-Subgraphs-on-Core/subgraph.yaml",
"content": "specVersion: 1.0.0\nindexerHints:\n prune: auto\nschema:\n file: ./schema.graphql\ndataSources:\n - kind: ethereum\n name: Guestbook\n network: core\n source:\n address: \"0x0D0b3bAc514d53AafC95c74294Bb1B613D1862c2\"\n abi: Guestbook\n startBlock: 22122890\n mapping:\n kind: ethereum/events\n apiVersion: 0.0.7\n language: wasm/assemblyscript\n entities:\n - EntrySigned\n abis:\n - name: Guestbook\n file: ./abis/Guestbook.json\n eventHandlers:\n - event: EntrySigned(string,string)\n handler: handleEntrySigned\n file: ./src/guestbook.ts\n"
},
{
"path": "06-Subgraphs-on-Core/tests/guestbook-utils.ts",
"content": "import { newMockEvent } from \"matchstick-as\"\nimport { ethereum } from \"@graphprotocol/graph-ts\"\nimport { EntrySigned } from \"../generated/Guestbook/Guestbook\"\n\nexport function createEntrySignedEvent(\n name: string,\n message: string\n): EntrySigned {\n let entrySignedEvent = changetype(newMockEvent())\n\n entrySignedEvent.parameters = new Array()\n\n entrySignedEvent.parameters.push(\n new ethereum.EventParam(\"name\", ethereum.Value.fromString(name))\n )\n entrySignedEvent.parameters.push(\n new ethereum.EventParam(\"message\", ethereum.Value.fromString(message))\n )\n\n return entrySignedEvent\n}\n"
},
{
"path": "06-Subgraphs-on-Core/tests/guestbook.test.ts",
"content": "import {\n assert,\n describe,\n test,\n clearStore,\n beforeAll,\n afterAll\n} from \"matchstick-as/assembly/index\"\nimport {} from \"@graphprotocol/graph-ts\"\nimport { EntrySigned } from \"../generated/schema\"\nimport { EntrySigned as EntrySignedEvent } from \"../generated/Guestbook/Guestbook\"\nimport { handleEntrySigned } from \"../src/guestbook\"\nimport { createEntrySignedEvent } from \"./guestbook-utils\"\n\n// Tests structure (matchstick-as >=0.5.0)\n// https://thegraph.com/docs/en/developer/matchstick/#tests-structure-0-5-0\n\ndescribe(\"Describe entity assertions\", () => {\n beforeAll(() => {\n let name = \"Example string value\"\n let message = \"Example string value\"\n let newEntrySignedEvent = createEntrySignedEvent(name, message)\n handleEntrySigned(newEntrySignedEvent)\n })\n\n afterAll(() => {\n clearStore()\n })\n\n // For more test scenarios, see:\n // https://thegraph.com/docs/en/developer/matchstick/#write-a-unit-test\n\n test(\"EntrySigned created and stored\", () => {\n assert.entityCount(\"EntrySigned\", 1)\n\n // 0xa16081f360e3847006db660bae1c6d1b2e17ec2a is the default address used in newMockEvent() function\n assert.fieldEquals(\n \"EntrySigned\",\n \"0xa16081f360e3847006db660bae1c6d1b2e17ec2a-1\",\n \"name\",\n \"Example string value\"\n )\n assert.fieldEquals(\n \"EntrySigned\",\n \"0xa16081f360e3847006db660bae1c6d1b2e17ec2a-1\",\n \"message\",\n \"Example string value\"\n )\n\n // More assert options:\n // https://thegraph.com/docs/en/developer/matchstick/#asserts\n })\n})\n"
},
{
"path": "06-Subgraphs-on-Core/tsconfig.json",
"content": "{\n \"extends\": \"@graphprotocol/graph-ts/types/tsconfig.base.json\",\n \"include\": [\"src\", \"tests\"]\n}\n"
},
{
"path": "07-NFT Minitng dApp on Core/.gitignore",
"content": "node_modules\n.env\n\n# Hardhat files\n/cache\n/artifacts\n\n# TypeChain files\n/typechain\n/typechain-types\n\n# solidity-coverage files\n/coverage\n/coverage.json\n\n# Hardhat Ignition default folder for deployments against a local node\nignition/deployments/chain-31337\n\nsecret.json"
},
{
"path": "07-NFT Minitng dApp on Core/README.md",
"content": "# Building NFT Minting DApp on Core\n\nWelcome to this tutorial where we will build a simple NFT Minting DApp on Core Blockchain from scratch. We will make a basic DApp where you will be able to mint NFTs from the frontend app. By the end of the tutorial, we will have a functional dapp that interacts with smart contracts on the Core Blockchain Testnet. Let’s start🙌\n\n## Learning Takeaways\n\n- Smart Contract Development in Solidity programming language\n- Building frontend using React.js\n- Using Ethers.js library for interaction of frontend with smart contracts\n- Integrating Metamask wallet for secure user transactions\n- Read and write data to/from smart contracts\n\n## Software Prerequisites\n\n- [Git](https://git-scm.com/)\n- [Node.js](https://nodejs.org/en) v20.13.1\n- [Yarn](https://yarnpkg.com/) v1.22.21\n- [Hardhat](https://hardhat.org/) v2.20.1\n- [Metamask Wallet](https://metamask.io/download/)\n- **Core Testnet Configuration**: Configure MetaMask to connect to the Core Testnet. Refer here for more details.\n - **Network Name**: Core Testnet\n - **New RPC URL**: [https://rpc.test2.btcs.network](https://rpc.test2.btcs.network)\n - **Chain ID**: 1114\n - **Currency Symbol**: TCORE2\n- **Core Faucet**: To get test CORE tokens for transactions, visit the Core Faucet, refer [here](https://docs.coredao.org/docs/Dev-Guide/core-faucet) for more details.\n\n## Setting up Dev Environment\n\n### 1. Initialize the project\n\nWe will create a new director `NFT_Minting` and initialize our project using `yarn`.\n\n```bash\nmkdir NFT_Minting\ncd NFT_Minting\nyarn init -y\nyarn add --dev hardhat\nyard hardhat init\n```\n\n\n\nSelect the `Create a Javascript project`\nSelect the default project root directory\nSelect yes adding a `.gitignore` and installing additional packages\n\n### 2. Install and Configure MetaMask\n\n- Install and configure MetaMask Chrome Extension to use with Core Testnet.\n- Refer [here](https://docs.coredao.org/docs/Dev-Guide/core-testnet-wallet-config) for a detailed guide.\n\n### 3. Create a Secret File\n\n- Create a `.env` file in the root folder and store the private key of your MetaMask wallet in it.\n\n```bash\n PRIVATE_KEY = \n```\n\n### 4. Update .gitignore\n\n- Update your .gitignore file to ensure that your secret.json file and other sensitive files are not committed to version control.\n- Make sure to add `secret.json` to the `.gitignore` file.\n\n### 5. Update the `hardhat.config.js` file\n\nReplace the contents of `hardhat.config.js` file with the following code. Make sure that the configuration for Core Testnet are set correctly.\n\n```javascript\nrequire(\"@nomicfoundation/hardhat-toolbox\");\nrequire(\"dotenv\").config();\n\n/** @type import('hardhat/config').HardhatUserConfig */\nconst PRIVATE_KEY = process.env.PRIVATE_KEY;\n\nmodule.exports = {\n solidity: \"0.8.24\",\n defaultNetwork: \"core_testnet\",\n\n networks: {\n hardhat: {},\n core_testnet: {\n url: \"https://rpc.test.btcs.network\",\n accounts: [PRIVATE_KEY],\n chainId: 1115,\n },\n },\n solidity: {\n compilers: [\n {\n version: \"0.8.24\",\n settings: {\n evmVersion: \"shanghai\",\n optimizer: {\n enabled: true,\n runs: 200,\n },\n },\n },\n ],\n },\n paths: {\n sources: \"./contracts\",\n cache: \"./cache\",\n artifacts: \"./artifacts\",\n },\n mocha: {\n timeout: 20000,\n },\n};\n```\n\nYour folder structure should look something like this.\n\n\n\n## Writing smart contracts\n\nAwsome! Now lets jump in the exciting stuff and start writing our smart contracts. Go to the `contracts` folder and create a new file with the name `MyNFT.sol`.\nBut before writing any code, we need to install the `@openzeppelin/contracts` library to implement our NFT smart contracts. Download it by running this command:\n\n```bash\nyarn add @openzeppelin/contracts\n```\n\nAfter the download completes we can write our smart contract:\n\n```js\n// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.24;\n\nimport \"@openzeppelin/contracts/token/ERC721/ERC721.sol\";\nimport \"@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract Nft is ERC721, ERC721URIStorage, Ownable {\n uint256 private _nextTokenId;\n\n constructor() ERC721(\"MyNFT\", \"MYN\") Ownable(msg.sender) {}\n\n function safeMint(address to, string memory uri) public {\n uint256 tokenId = _nextTokenId++;\n _safeMint(to, tokenId);\n _setTokenURI(tokenId, uri);\n }\n\n // The following functions are overrides required by Solidity.\n\n function tokenURI(\n uint256 tokenId\n ) public view override(ERC721, ERC721URIStorage) returns (string memory) {\n return super.tokenURI(tokenId);\n }\n\n function supportsInterface(\n bytes4 interfaceId\n ) public view override(ERC721, ERC721URIStorage) returns (bool) {\n return super.supportsInterface(interfaceId);\n }\n}\n```\n\nIn this code, we\n\n- Import the `ERC721`, `ERC721URIStorage`, and `Ownable` classes from the openzeppelin/contracts library for creating a new NFT smart contract.\n- Initialize a private state variable `_nextTokenId` to store the ID of the NFT.\n- The constructor initializes the ERC721 contract with a name and symbol, and sets up the `Ownable` contract with the owner's address to restrict NFT minting to the owner.\n- The `safeMint` function mints a new NFT, taking the recipient's address and the NFT's URI as arguments.\n- The `tokenURI` and `supportsInterface` functions override required methods from `ERC721` and `ERC721URIStorage`.\n\nIn the `safeMint` function, we\n\n- Increment the `_nextTokenId` variable to get the next token ID.\n- Mint the NFT to the user using the `_safeMint` function.\n- Set the URI of the NFT using the `_setTokenURI` function. The uri is the metadata of the NFT, which holds the image, name, and other details of the NFT.\n\n## Compiling and Deploying the Smart Contract\n\nGreat, Now run the following command to complie the contract\n\n```bash\nyarn hardhat compile\n```\n\nIf the compilation is successful, you should see something like this:\n\n\n\nNow let us deploy the smart contract to the Core Testnet. For this, create a new folder in your root directory and name it `scripts`. Inside the `scripts` folder, create a new file named `deploy.js` and write the following code:\n\n```js\nconst { ethers } = require(\"hardhat\");\n\nasync function main() {\n const [deployer] = await ethers.getSigners();\n\n console.log(\"Deploying contracts with the account:\", deployer.address);\n\n const MyNFT = await ethers.getContractFactory(\"MyNFT\");\n const myNft = await MyNFT.deploy();\n\n console.log(\"Token address:\", await myNft.getAddress());\n}\n\nmain()\n .then(() => process.exit(0))\n .catch((error) => {\n console.error(error);\n process.exit(1);\n });\n```\n\nMake sure your metamask wallet has tCORE testnet tokens to deploy the contract. If not, visit the [Core Faucet](https://scan.test2.btcs.network/faucet) to get some testnet CORE tokens.\n\nGreat! Now run the following command in the root directory of your project to deploy the smart contract:\n\n```bash\nyarn hardhat run scripts/deploy.js\n```\n\nIf the deployment is successful, you should see the address of the deployed contract in the console.\n\n\n\nMake sure to save this address as we will need it later to interact with the smart contract.\n\n## Building the Frontend\n\nAwsome! We have deployed our smart contract to the Core Testnet. Now let's build the frontend of our DApp. We will use **Vite** and **React** to build our frontend. Go to the root directory of your project and run the following command:\n\n```bash\nyarn create vite frontend\n```\n\n\n\nSelect **React** from the `Select a framework` option and **Javascript** from `Select a variant` option.\n\nNow we will use the **Ethers.js** library to interact with our smart contracts. Install it in the frontend directory.\n\n```bash\nyarn add ethers\n```\n\nTo interact with the smart contract, we also need the ABI (Application Binary Interface) along with address of the deployed contract. We can get the ABI from the `artifacts` folder in the root directory of the project. Create a new directory in the `src` folder, name it `abis` and create a new file `MyNFTAbi.json` . Now copy the ABI of the `MyNFT` contract and paste it in the `MyNFTAbi.json` file.\n\nExcellent, now let's write code to connect our metamask wallet in the `App.jsx` file.\n\n```javascript\nimport { useEffect, useState } from \"react\";\nimport { ethers } from \"ethers\";\nimport MyNFTAbi from \"./abis/MyNFTAbi.json\";\nimport \"./App.css\";\n\nfunction App() {\n const [walletAddress, setWalletAddress] = useState();\n const [provider, setProvider] = useState();\n const [signer, setSigner] = useState();\n\n const contractAddress = \"0x984eE96FE316006533c0BB78c97e3A02E41c7759\"; // Replace contract address\n const abi = MyNFTAbi.abi;\n\n async function connectWallet() {\n const { ethereum } = window;\n if (!ethereum) {\n alert(\"Please install MetaMask!\");\n return;\n }\n\n try {\n const provider = new ethers.BrowserProvider(ethereum);\n const [account] = await ethereum.request({\n method: \"eth_requestAccounts\",\n });\n const signer = provider.getSigner();\n\n setProvider(provider);\n setSigner(signer);\n setWalletAddress(account);\n } catch (error) {\n console.log(\"Error fetching network:\", error);\n }\n }\n useEffect(() => {\n connectWallet();\n }, []);\n\n return (\n <>\n
NFT Minting Dapp
\n {walletAddress ? (\n
\n Connected Address: {walletAddress}\n
\n ) : (\n \n )}\n \n );\n}\n\nexport default App;\n```\n\nNow run `yarn dev` command in the frontend directory, open the app in your browser on `http://localhost:5173`. You should see your metamaks wallet prompt you to connect to the website.\n\n\n\nMake sure to connect that account only which you have used to deploy the contract. Since we have used the `Ownable` class in our contract, we will face errors if we try to mint the NFT in other accounts. By clicking `Next` and `Confirm`, our wallet will be connected to the website and we will see our address on the screen.\n\n\n\nWonderful! Now we will write code to show the nft image and mint it in our wallet.\nWe will also add code to show our NFT image and button to mint in our wallet\n\n```javascript\nconst nftImage = \"https://raw.githubusercontent.com/GM-11/NFT_Minting_Tutorial_Core/main/assets/nft.png\"\n\nconst nftUri = \"https://raw.githubusercontent.com/GM-11/NFT_Minting_Tutorial_Core/main/assets/metadata.json\"\n\n```\n\nFor this tutorial, you can copy these links as it is.\n\n```javascript\n
NFT Minting Dapp
;\n{\n walletAddress ? (\n \n
\n Connected Address: {walletAddress}\n
\n\n \n \n \n \n ) : (\n \n );\n}\n```\n\nNow our app will look something like this\n\n\n\nNow let's make a function to mint our NFT in our MetaMask wallet.\n\n```javascript\nasync function mintNFT() {\n try {\n const contract = new ethers.Contract(contractAddress, abi, signer);\n const tx = await contract.safeMint(walletAddress, nftUri);\n await tx.wait();\n } catch (error) {\n console.log(\"Error minting NFT:\", error);\n }\n}\n```\n\nIn this function, we are\n\n- Creating a new instance of the contract using the contract address and ABI.\n- Calling the `safeMint` function of the contract to mint the NFT. The `safeMint` function takes two arguments, the address of the user to whom the NFT will be minted and the URI of the NFT.\n- Waiting for the transaction to be confirmed and then showing an alert that the NFT has been minted successfully.\n\nNow let's call this function when the user clicks the mint button.\n\n```javascript\n\n```\n\nWhen we click the `**Mint this NFT** button, our wallet should prompt us to sign the transaction\n\n\n\nClick on **Confirm** to confirm the transaction.\n\nAwsome! We have minted our first NFT on the Core Blockchain!🥳\n\nBut wait, why can't we see it?🤔\n\n\n\nWell since this NFT is on the testnet, metamask automatically does not detect them. We need to import our NFT into our wallet.\n\nCick on `Import NFT` at the bottom. Add your contract address in the **Address** input field and 0 in the **Token Id** input field and click on **Import**.\n\n\n\nWonderful, now we can see our nft in the wallet!\n\n## Conclusion\n\n🎉🙌Congratulations, you have created a basic NFT Minting DApp on the Core Testnet.\n"
},
{
"path": "07-NFT Minitng dApp on Core/assets/metadata.json",
"content": "{\n \"name\": \"Bored Ape\",\n \"image\" : \"https://raw.githubusercontent.com/GM-11/NFT_Minting_Tutorial_Core/master/assets/nft.png\",\n \"description\": \"A bored ape\"\n}"
},
{
"path": "07-NFT Minitng dApp on Core/contracts/Lock.sol",
"content": "// SPDX-License-Identifier: UNLICENSED\npragma solidity ^0.8.24;\n\n// Uncomment this line to use console.log\n// import \"hardhat/console.sol\";\n\ncontract Lock {\n uint public unlockTime;\n address payable public owner;\n\n event Withdrawal(uint amount, uint when);\n\n constructor(uint _unlockTime) payable {\n require(\n block.timestamp < _unlockTime,\n \"Unlock time should be in the future\"\n );\n\n unlockTime = _unlockTime;\n owner = payable(msg.sender);\n }\n\n function withdraw() public {\n // Uncomment this line, and the import of \"hardhat/console.sol\", to print a log in your terminal\n // console.log(\"Unlock time is %o and block timestamp is %o\", unlockTime, block.timestamp);\n\n require(block.timestamp >= unlockTime, \"You can't withdraw yet\");\n require(msg.sender == owner, \"You aren't the owner\");\n\n emit Withdrawal(address(this).balance, block.timestamp);\n\n owner.transfer(address(this).balance);\n }\n}\n"
},
{
"path": "07-NFT Minitng dApp on Core/contracts/MyNFT.sol",
"content": "// SPDX-License-Identifier: MIT\npragma solidity ^0.8.24;\n\nimport \"@openzeppelin/contracts/token/ERC721/ERC721.sol\";\nimport \"@openzeppelin/contracts/token/ERC721/extensions/ERC721URIStorage.sol\";\nimport \"@openzeppelin/contracts/access/Ownable.sol\";\n\ncontract MyNFT is ERC721, ERC721URIStorage, Ownable {\n uint256 private _nextTokenId;\n\n constructor() ERC721(\"MyNFT\", \"MYN\") Ownable(msg.sender) {}\n\n function safeMint(address to, string memory uri) public {\n uint256 tokenId = _nextTokenId++;\n _safeMint(to, tokenId);\n _setTokenURI(tokenId, uri);\n }\n\n // The following functions are overrides required by Solidity.\n function tokenURI(\n uint256 tokenId\n ) public view override(ERC721, ERC721URIStorage) returns (string memory) {\n return super.tokenURI(tokenId);\n }\n\n function supportsInterface(\n bytes4 interfaceId\n ) public view override(ERC721, ERC721URIStorage) returns (bool) {\n return super.supportsInterface(interfaceId);\n }\n}\n"
},
{
"path": "07-NFT Minitng dApp on Core/frontend/.gitignore",
"content": "# Logs\nlogs\n*.log\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\npnpm-debug.log*\nlerna-debug.log*\n\nnode_modules\ndist\ndist-ssr\n*.local\n\n# Editor directories and files\n.vscode/*\n!.vscode/extensions.json\n.idea\n.DS_Store\n*.suo\n*.ntvs*\n*.njsproj\n*.sln\n*.sw?\n"
},
{
"path": "07-NFT Minitng dApp on Core/frontend/README.md",
"content": "# React + Vite\n\nThis template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.\n\nCurrently, two official plugins are available:\n\n- [@vitejs/plugin-react](https://github.com/vitejs/vite-plugin-react/blob/main/packages/plugin-react/README.md) uses [Babel](https://babeljs.io/) for Fast Refresh\n- [@vitejs/plugin-react-swc](https://github.com/vitejs/vite-plugin-react-swc) uses [SWC](https://swc.rs/) for Fast Refresh\n"
},
{
"path": "07-NFT Minitng dApp on Core/frontend/index.html",
"content": "\n\n \n \n \n \n Vite + React\n \n \n \n \n \n\n"
},
{
"path": "07-NFT Minitng dApp on Core/frontend/package.json",
"content": "{\n \"name\": \"frontend\",\n \"private\": true,\n \"version\": \"0.0.0\",\n \"type\": \"module\",\n \"scripts\": {\n \"dev\": \"vite\",\n \"build\": \"vite build\",\n \"lint\": \"eslint . --ext js,jsx --report-unused-disable-directives --max-warnings 0\",\n \"preview\": \"vite preview\"\n },\n \"dependencies\": {\n \"ethers\": \"6.13.2\",\n \"react\": \"18.3.1\",\n \"react-dom\": \"18.3.1\"\n },\n \"devDependencies\": {\n \"@types/react\": \"18.3.3\",\n \"@types/react-dom\": \"18.3.0\",\n \"@vitejs/plugin-react\": \"4.3.1\",\n \"eslint\": \"8.57.0\",\n \"eslint-plugin-react\": \"7.34.3\",\n \"eslint-plugin-react-hooks\": \"4.6.2\",\n \"eslint-plugin-react-refresh\": \"0.4.7\",\n \"vite\": \"5.3.4\"\n }\n}\n"
},
{
"path": "07-NFT Minitng dApp on Core/frontend/src/App.css",
"content": ""
},
{
"path": "07-NFT Minitng dApp on Core/frontend/src/App.jsx",
"content": "import { useEffect, useState } from \"react\";\nimport { ethers } from \"ethers\";\nimport MyNFTAbi from \"./abis/MyNFTAbi.json\";\nimport core_logo from \"./assets/core-logo.png\";\nimport \"./App.css\";\n\nfunction App() {\n const [walletAddress, setWalletAddress] = useState();\n const [provider, setProvider] = useState();\n const [signer, setSigner] = useState();\n\n const contractAddress = \"0x8c546a571Ed23c32B7355E5C814589B6F627737D\";\n const abi = MyNFTAbi.abi;\n const nftImage =\n \"https://raw.githubusercontent.com/GM-11/NFT_Minting_Tutorial/master/assets/nft.png\";\n const nftUri =\n \"https://raw.githubusercontent.com/GM-11/NFT_Minting_Tutorial/master/assets/metadata.json\";\n\n async function connectWallet() {\n const { ethereum } = window;\n if (!ethereum) {\n alert(\"Please install MetaMask!\");\n return;\n }\n\n try {\n const provider = new ethers.BrowserProvider(ethereum);\n const [account] = await ethereum.request({\n method: \"eth_requestAccounts\",\n });\n const signer = await provider.getSigner();\n\n setProvider(provider);\n setSigner(signer);\n setWalletAddress(account);\n } catch (error) {\n console.log(\"Error fetching network:\", error);\n }\n }\n useEffect(() => {\n connectWallet();\n }, []);\n\n async function mintNFT() {\n try {\n const contract = new ethers.Contract(contractAddress, abi, signer);\n const tx = await contract.safeMint(walletAddress, nftUri);\n await tx.wait();\n alert(\"NFT has been minted successfully\")\n } catch (error) {\n console.log(\"Error minting NFT:\", error);\n }\n }\n\n return (\n \n \n
![](\"src/public/logo.png\"){kind=logo}
\n