{"id":30126570,"url":"https://github.com/iotaledger/evm-faucet","last_synced_at":"2025-08-10T16:51:38.879Z","repository":{"id":157281648,"uuid":"611653213","full_name":"iotaledger/evm-faucet","owner":"iotaledger","description":"EVM Faucet App","archived":false,"fork":false,"pushed_at":"2023-11-28T07:35:07.000Z","size":2147,"stargazers_count":1,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-04-01T16:12:35.099Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/iotaledger.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}},"created_at":"2023-03-09T09:13:51.000Z","updated_at":"2024-02-14T22:40:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"528cfb23-3310-4912-bb75-04edd78f9238","html_url":"https://github.com/iotaledger/evm-faucet","commit_stats":null,"previous_names":["iotaledger/evm-faucet"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/iotaledger/evm-faucet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotaledger%2Fevm-faucet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotaledger%2Fevm-faucet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotaledger%2Fevm-faucet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotaledger%2Fevm-faucet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/iotaledger","download_url":"https://codeload.github.com/iotaledger/evm-faucet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/iotaledger%2Fevm-faucet/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269756297,"owners_count":24470559,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-10T02:00:08.965Z","response_time":71,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2025-08-10T16:51:16.672Z","updated_at":"2025-08-10T16:51:38.848Z","avatar_url":"https://github.com/iotaledger.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EVM Faucet App\n\n\u003e The tokens that are dropped by the faucet are not actual wrapped tokens but instead they are simulated wrapped tokens that just exist on our network. This means that these tokens do not have any real-world value and are only meant for testing or educational purposes, and they don't exist on the selected Testnet.\n\n### Uses:\n- NodeJs\n- Express\n- EJS\n- [Tailwindcss](https://tailwindcss.com/docs/installation)\n- Ethersjs\n\n![Demo](./statics/img/demo.png)\n\n### Setup\n\n1. `cp .env.example .env` and replace the variables with your custom ones.\n2. `npm install --save-dev`\n\n### Deploy Contracts\n1. Run `npx hardhat run --network ShimmerEVMTestnet ./scripts/deployEverything.js` to deploy all tokens in `contracts/tokens.json`, create faucets for them, and update both the `tokens.json` and `faucets.json` files with new addresses.\n\nNote: If you want to allow another address to request funds from the faucet besides the deployer, set the env var `FAUCET_ADMIN` with this address before running the script.\nSince the testnet can be slow to update, if you set `SEND_BLOCK_TXNS` to `true` then your wallet will send six zero value transfer transactions to help move the network along while we wait to verify the contracts.\n### Run\n`npm start` or `nodemon`\n\nOpen the webapp on your browser.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiotaledger%2Fevm-faucet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fiotaledger%2Fevm-faucet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fiotaledger%2Fevm-faucet/lists"}