{"id":16782946,"url":"https://github.com/advra/boilerplate-contract-deployer","last_synced_at":"2026-05-15T12:07:14.803Z","repository":{"id":217099158,"uuid":"743085651","full_name":"advra/boilerplate-contract-deployer","owner":"advra","description":"ethereum boilerplate fullstack deployment","archived":false,"fork":false,"pushed_at":"2024-01-19T20:57:27.000Z","size":526,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-08-16T16:48:26.618Z","etag":null,"topics":["boilerplate-template","ethereum","fullstack-development"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/advra.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-01-14T09:31:43.000Z","updated_at":"2024-01-16T06:43:34.000Z","dependencies_parsed_at":"2024-01-19T22:09:57.188Z","dependency_job_id":null,"html_url":"https://github.com/advra/boilerplate-contract-deployer","commit_stats":null,"previous_names":["advra/boilerplate-contract-deployer"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/advra/boilerplate-contract-deployer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/advra%2Fboilerplate-contract-deployer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/advra%2Fboilerplate-contract-deployer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/advra%2Fboilerplate-contract-deployer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/advra%2Fboilerplate-contract-deployer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/advra","download_url":"https://codeload.github.com/advra/boilerplate-contract-deployer/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/advra%2Fboilerplate-contract-deployer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33066166,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T11:35:32.926Z","status":"ssl_error","status_checked_at":"2026-05-15T11:35:31.362Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["boilerplate-template","ethereum","fullstack-development"],"created_at":"2024-10-13T07:48:32.641Z","updated_at":"2026-05-15T12:07:14.775Z","avatar_url":"https://github.com/advra.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Boilerplate Contract Deloyer\n\nBy Abstract Core Systems\n\nThis is a boilerplate ethereum smart contract deployer. The project is structured with a front end and backend. It provides the base template to deploy to ethereum `localhost` or ethereum testnet on `sepolia` via [Infura](https://www.infura.io/). Special credits to [Space Riders NFT](https://opensea.io/collection/spaceridersnft) which the example contract `Abstract Space Riders NFT` is based off of.\n\n#### TODO \n- [x] contract deployement \n- [x] full test coverage \n- [x] deployment scripts \n- [x] logging \n- [ ] working react front end (almost complete) \n\nNote: The AbstractSpaceRider example contract is deployed to sepolia at `0xb8090eebe1fe886d8543dc933d6069ef717fa4b0`.\n\n## I. Technology Stack \u0026 Tools\n\n- Solidity (Writing Smart Contract)\n- [Hardhat](https://hardhat.org/) (using the [hardhat-toolbox](https://hardhat.org/hardhat-runner/plugins/nomicfoundation-hardhat-toolbox) plugin)\n- React\n- Ethers.js\n\n## II. Requirements For Initial Setup\n- Install current LTS for Node (preferrably using [NVM](https://github.com/nvm-sh/nvm))\n- Install [Hardhat](https://hardhat.org/) with [hardhat-toolbox](https://hardhat.org/hardhat-runner/plugins/nomicfoundation-hardhat-toolbox)\n- Optional: If using vscode install Solidity and Hardhat extensions\n\n## III. Setting Up\n### 1. Clone/Download the Repository\n```bash\ngit clone this repo\nmv .env.bak  .env \n# modify the .env file as needed\n```\n### 2. Install Dependencies:\n```bash\ncd boilerplate-contract-deployer\nnpm install\n```\n### 3. Deploying\n\n#### 3a. Localhost Network\nNote: Everytime local hardhat node is deployed you need to re-deploy the contract (make sure you delete the folder located in [src/frontend/contractsData](./src/frontend/contractsData)\n1. Startup local node blockchain\n    ```bash\n    cd boilerplate-contract-deployer\n    rm -rf /src/frontend/contractsData/*.json\n    # Make sure you run this at the root of the project otherwise the private key from .env may not load properly!\n    npx hardhat node\n    ```\n2. Update your private key \nChange the `PRIVATE_KEY` in `.env` to use one of the following private key wallets provided in the console above\n3. Migrate Smart Contracts\n    ```bash\n    npx hardhat run src/backend/scripts/deploy.js --network localhost\n    ```\n4. Connect development blockchain accounts to Metamask\n    - Copy private key of the addresses and import to Metamask\n    - Connect your metamask to hardhat blockchain, network 127.0.0.1:8545.\n    - If you have not added hardhat to the list of networks on your metamask, open up a browser, click the fox icon, then click the top center dropdown button that lists all the available networks then click add networks. A form should pop up. For the \"Network Name\" field enter \"Hardhat\". For the \"New RPC URL\" field enter \"http://127.0.0.1:8545\". For the chain ID enter \"31337\". Then click save.  \n5. Launching Front End\n    ```bash\n    npm run start\n    ```\n\n#### 3b. Sepolia Test Net\n1. Update your private key \n    - Copy private key of the addresses and import to Metamask\n    - Connect your metamask to hardhat blockchain, network 127.0.0.1:8545.\n    - If you have not added hardhat to the list of networks on your metamask, open up a browser, click the fox icon, then click the top center dropdown button that lists all the available networks then click add networks. A form should pop up. For the \"Network Name\" field enter \"Hardhat\". For the \"New RPC URL\" field enter \"http://127.0.0.1:8545\". For the chain ID enter \"31337\". Then click save.  \n2. Migrate Smart Contracts\n    ```bash\n    npx hardhat run src/backend/scripts/deploy.js --network sepolia\n    ```\n3. Launching Front End\n    ```bash\n    npm run start\n    # Browser should automatically open otherwise visit localhost:3000\n    ```\n\n## IV. Other Useful Commands\n\n### 1. Running Unit Tests\nRun unit tests against hardhat: \n```bash\nnpx hardhat test \n# optinally this can be done in parallel\nnpx hardhat test --parallel\n```\n\n### 2. Etherscan Verficiation:\nWhen deploying on chain you can optionally verify your contract using hardhat's etherscan verify plugin. Make sure you set your `ETHERSCAN_API_KEY` in the [.env](./.env) file (you can obtain an etherscan apikey by creating an account on etherscan). \n\nNote: Make sure you use constructor arguments that match your contracts constructor in both the .sol and  in deploy.js \n```bash\nnpx hardhat verify \u003cYOUR_DEPLOYED_CONTRACT_ADDRESS\u003e \u003cOPTIONAL_CONSTRUCTOR_ARGS\u003e --network sepolia\n## Example Without consturctor args\n## npx hardhat verify 0xb8090EeBe1fE886D8543dc933D6069ef717FA4B0 --network sepolia\n## Example with constructor args\n## npx hardhat verify --contract src/backend/contracts/AbstractSRNFT.sol:AbstractSRNFT 0xb8090EeBe1fE886D8543dc933D6069ef717FA4B0 0x07814fD88beA3167474A1761b8A923cb782B3715 --network sepolia\n```\n\n## V. Other Notes: \nIf you get error rpc-internal on metamask or node an error that shows nonce too high you need to go to metamask and \"Clear Recent Activities\" to reset the nonce for that account.\n\n\nLicense\n----\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadvra%2Fboilerplate-contract-deployer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadvra%2Fboilerplate-contract-deployer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadvra%2Fboilerplate-contract-deployer/lists"}