{"id":22799946,"url":"https://github.com/tangle-network/webb-faucet","last_synced_at":"2025-09-11T08:41:49.459Z","repository":{"id":170189468,"uuid":"613746796","full_name":"tangle-network/webb-faucet","owner":"tangle-network","description":"A faucet for testnet bridges.","archived":false,"fork":false,"pushed_at":"2024-01-09T16:34:27.000Z","size":1275,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-02T22:39:27.583Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","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/tangle-network.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}},"created_at":"2023-03-14T07:31:49.000Z","updated_at":"2024-10-16T16:51:05.000Z","dependencies_parsed_at":"2024-01-09T17:48:44.109Z","dependency_job_id":"acfcf350-8f5f-4115-8918-7c451fba0329","html_url":"https://github.com/tangle-network/webb-faucet","commit_stats":null,"previous_names":["webb-tools/webb-faucet","tangle-network/webb-faucet"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/tangle-network/webb-faucet","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangle-network%2Fwebb-faucet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangle-network%2Fwebb-faucet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangle-network%2Fwebb-faucet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangle-network%2Fwebb-faucet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tangle-network","download_url":"https://codeload.github.com/tangle-network/webb-faucet/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tangle-network%2Fwebb-faucet/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274602728,"owners_count":25315205,"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-09-11T02:00:13.660Z","response_time":74,"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":"2024-12-12T07:10:32.076Z","updated_at":"2025-09-11T08:41:49.437Z","avatar_url":"https://github.com/tangle-network.png","language":"Rust","readme":"\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://www.webb.tools/\"\u003e\n\n![Webb Logo](./assets/webb_banner_light.png#gh-light-mode-only)\n\n![Webb Logo](./assets/webb_banner_dark.png#gh-dark-mode-only)\n\u003c/a\u003e\n\n  \u003c/div\u003e\n\n# Webb Faucet\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003ch2 id=\"table-of-contents\" style=border:0!important\u003e 📖 Table of Contents\u003c/h2\u003e\n\n\u003cdetails open=\"open\"\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"#start\"\u003e Getting Started\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e  \n\u003c/details\u003e\n\n\u003ch2 id=\"start\"\u003e Getting Started  🎉 \u003c/h2\u003e\n\nThis is a multi-chain faucet for Webb's test bridges. The faucet backend is written in Rust and the frontend is written in React. The backend is responsible for authenticating a twitter user and verifying they follow our\ntwitter account: [@webbprotocol](https://twitter.com/webbprotocol). Once authenticated, the backend will send a transaction to the user's provided address on the form.\n\nWebb's testnets are currently deployed to EVMs and Substrate chains. If you are an EVM or Substrate chain that wants to integrate with the Webb protocol, please reach out to us on [Discord](https://discord.gg/d88MzS8h)!\n\n### Prerequisites\n\nThis repo uses Rust so it is required to have a Rust developer environment set up. First install and configure rustup:\n\n```bash\n# Install\ncurl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh\n# Configure\nsource ~/.cargo/env\n```\n\nConfigure the Rust toolchain to default to the latest stable version:\n\n```bash\nrustup default stable\nrustup update\n```\n\nGreat! Now your Rust environment is ready! 🚀🚀\n\n### Nix (with flakes)\n\nIf you prefer [Nix](https://nixos.org), then follow these steps to get your environment setup:\n\n1. Install [Nix](https://nixos.org/download.html)\n2. Enable [flakes](https://nixos.wiki/wiki/Flakes) (if you haven't already)\n3. Run `nix develop` to enter a shell with all the dependencies installed\n\nAdditionally, if you have [direnv](https://direnv.net/) installed, you can run `direnv allow` to automatically enter the shell whenever you enter the directory.\n\n\n## Usage\n\nStarting the Rust serve requires you to create a `Rocket.toml` file specified with your Twitter Developer App's credentials. You can find the template in the `Rocket.example.toml` file. You will also need to create a new Twitter Application for development purposes. You can find the instructions [here](https://developer.twitter.com/en/docs/twitter-api/getting-started/getting-access-to-the-twitter-api).\n\n**Notes:**\n\n1. For 'App permissions' you will need to select 'Read' permissions.\n2. For 'Type of App' you will need to select 'Native App'.\n3. For 'App info' you will need to fill in the 'Website URL' and 'Callback URLs' fields. The 'Callback URLs' field should be set to `http://127.0.0.1:3000` and `http://localhost:3000`.\n\nOnce created, you can run the server with the following command:\n\n```rust\ncargo run\n```\n\nStarting the React application requires you to create a `.env` file specified with some of your Twitter Developer App's credentials. You can find the template in the `./faucet-frontend/.env.example` file. The `.env` should be placed in the `./faucet-frontend` directory.\n\nThe frontend can be started with the following commands:\n\n```bash\ncd faucet-frontend\nyarn start\n```\n\n## User Flow\n\n1. User clicks the \"Log in with Twitter\" button\n2. User is redirected and authorizes the app to access their Twitter account.\n3. Once the access token is generated and displayed, the user should supply the receiving addressand claim their tokens by clicking the \"Claim\" button.\n\nThere is no actually blockchain logic hooked in yet.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftangle-network%2Fwebb-faucet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftangle-network%2Fwebb-faucet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftangle-network%2Fwebb-faucet/lists"}