{"id":30064668,"url":"https://github.com/celo-org/faucet","last_synced_at":"2025-08-08T05:17:26.639Z","repository":{"id":40522831,"uuid":"485950221","full_name":"celo-org/faucet","owner":"celo-org","description":"Celo Testnets   Faucet ","archived":false,"fork":false,"pushed_at":"2025-08-07T02:05:16.000Z","size":101540,"stargazers_count":20,"open_issues_count":11,"forks_count":22,"subscribers_count":8,"default_branch":"master","last_synced_at":"2025-08-07T04:06:20.173Z","etag":null,"topics":["alfajores","celo","fake","faucet","test","testnet-blockchain","testnet-faucet","tokens"],"latest_commit_sha":null,"homepage":"https://faucet.celo.org","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/celo-org.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-04-26T21:16:59.000Z","updated_at":"2025-08-05T12:38:19.000Z","dependencies_parsed_at":"2023-02-18T10:32:03.161Z","dependency_job_id":"7fb3035c-884a-4cd2-94e7-bb090aad6fd1","html_url":"https://github.com/celo-org/faucet","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/celo-org/faucet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celo-org%2Ffaucet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celo-org%2Ffaucet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celo-org%2Ffaucet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celo-org%2Ffaucet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/celo-org","download_url":"https://codeload.github.com/celo-org/faucet/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/celo-org%2Ffaucet/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":269367089,"owners_count":24405314,"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-08T02:00:09.200Z","response_time":72,"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":["alfajores","celo","fake","faucet","test","testnet-blockchain","testnet-faucet","tokens"],"created_at":"2025-08-08T05:17:22.375Z","updated_at":"2025-08-08T05:17:26.612Z","avatar_url":"https://github.com/celo-org.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Welcome to Alfajores Faucet app\n\nThis Repo contains the code for the alfajores faucet. This is contained in 2 apps.\n\n- The firebase app contains functions which do the actual fauceting.\n\n- The web app contains a UI for making requests.\n\nThe web app deploys automatically to vercel.\n\n## Setup\n\n### Wep app\n\nTo set up the web app to run locally:\n\n1.  navigate to the `apps/web` folder\n\n    ```sh\n    $ cd apps/web\n    ```\n\n1.  link your local repository to the `faucet` project on Vercel\n\n    ```sh\n    $ yarn dlx vercel@latest link\n    ```\n\n    You'll be asked to authenticate with your Vercel account. Once you've done that, you'll be\n    guided through a series of prompts to link your local project to the `faucet` Vercel project.\n\n    ```\n    ? Set up “~/Documents/celo-org/faucet/apps/web”? [Y/n] y\n    ? Which scope should contain your project? Celo Ecosystem Project Hosting\n    ? Link to existing project? [y/N] y\n    ? What’s the name of your existing project? faucet\n    ✅  Linked to c-labs/faucet (created .vercel)\n    ```\n\n1.  fetch environment variables from Vercel\n\n    ```sh\n    $ yarn dlx vercel@latest env pull\n    ```\n\n    If you get an error like `Error! No project found`, you may need to run `vercel link` again.\n    If everything worked, you should see a message like this:\n\n    ```sh\n    \u003e Downloading `development` Environment Variables for Project faucet\n    ✅  Created .env.local file  [249ms]\n    ```\n\n1.  run the app locally\n\n    ```sh\n    $ yarn dev\n    ```\n\n    You should see a message like this:\n\n    ```sh\n    ready - started server on 0.0.0.0:3000, url: http://localhost:3000\n    info  - Loaded env from /Users/arthur/Documents/celo-org/faucet/apps/web/.env.local\n    ```\n\n    You can now view the app in your browser at http://localhost:3000.\n\n## Firebase app\n\nTo set up the firebase app to run locally:\n\n1.  navigate to the `apps/firebase` folder\n    ```sh\n    $ cd apps/firebase\n    ```\n1.  login to firebase\n    ```sh\n    $ yarn dlx firebase-tools@latest login\n    ```\n    You'll be asked to authenticate with your Firebase account.\n1.  build the firebase app\n    ```sh\n    $ yarn run preserve\n    ```\n1.  ensure that you are on required node version specified in `engines.node` in\n    `firebase/package.json`. Currently this is Node 20 at the time of writing.\n    ```sh\n    $ nvm use \u003cthe-required-node-version\u003e\n    ```\n1.  run the firebase app locally\n    ```sh\n    $ yarn run serve\n    ```\n\n## Adding chains\n\n### Web\n\n- Add the chain config and token info to `config/chains.ts`.\n\n- Add chain name to the networks array, and `ChainId` and `FaucetAddress` to enums in `types/index.ts`.\n\n### Firebase\n\nDispatch the deploy-chains workflow. ensure chain name is kebab case and matches a network in `config/chains.ts`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelo-org%2Ffaucet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcelo-org%2Ffaucet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcelo-org%2Ffaucet/lists"}