{"id":19358613,"url":"https://github.com/paritytech/parity-bridges-ui","last_synced_at":"2025-04-23T11:32:14.883Z","repository":{"id":45987207,"uuid":"334177626","full_name":"paritytech/parity-bridges-ui","owner":"paritytech","description":"bridge-ui-substrate-draft","archived":false,"fork":false,"pushed_at":"2022-10-21T12:05:18.000Z","size":6578,"stargazers_count":18,"open_issues_count":35,"forks_count":10,"subscribers_count":9,"default_branch":"master","last_synced_at":"2023-04-09T19:14:12.019Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/paritytech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-01-29T15:01:37.000Z","updated_at":"2022-01-07T09:58:13.000Z","dependencies_parsed_at":"2023-01-20T09:01:44.893Z","dependency_job_id":null,"html_url":"https://github.com/paritytech/parity-bridges-ui","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paritytech%2Fparity-bridges-ui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paritytech%2Fparity-bridges-ui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paritytech%2Fparity-bridges-ui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/paritytech%2Fparity-bridges-ui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/paritytech","download_url":"https://codeload.github.com/paritytech/parity-bridges-ui/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223922077,"owners_count":17225636,"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","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-11-10T07:12:29.100Z","updated_at":"2024-11-10T07:12:29.860Z","avatar_url":"https://github.com/paritytech.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# UI for Substrate Bridges\n\nThe goal of the UI is to provide the users a convenient way of interacting with the Bridge - querying its state and sending transactions.\n\n| 🚀  | Live version at [//paritytech.github.io/parity-bridges-ui](https://paritytech.github.io/parity-bridges-ui) |\n| --- | :--------------------------------------------------------------------------------------------------------- |\n\n## Configuring custom Substrate providers / chains\n\nThe project includes a `.env` file at root project directory that contains all the variables for running the bridge UI:\n\n```\nREACT_APP_CHAIN_1_CUSTOM_TYPES_URL=https://raw.githubusercontent.com/paritytech/parity-bridges-common/master/deployments/types-rialto.json\nREACT_APP_CHAIN_1_SUBSTRATE_PROVIDER=wss://wss.rialto.brucke.link\nREACT_APP_CHAIN_2_CUSTOM_HASHER=blake2Keccak256Hasher\nREACT_APP_CHAIN_2_CUSTOM_TYPES_URL=https://raw.githubusercontent.com/paritytech/parity-bridges-common/master/deployments/types-millau.json\nREACT_APP_CHAIN_2_SUBSTRATE_PROVIDER=wss://wss.millau.brucke.link\n\nREACT_APP_LANE_ID=0x00000000\nREACT_APP_KEYRING_DEV_LOAD_ACCOUNTS=false\nREACT_APP_IS_DEVELOPMENT=false\n```\n\n| ℹ️  | In case you need to overwrite any of the variables defined, please do so creating a new `.env.local`. |\n| --- | :---------------------------------------------------------------------------------------------------- |\n\nIn case of questions about `.env` management please refer to this link: [create-react-app env files](https://create-react-app.dev/docs/adding-custom-environment-variables/#what-other-env-files-can-be-used)\n\n## Custom Hashers for building connections\n\nIf any of the chains (or both) need to use a custom hasher function this one can be built and exported from the file: `src/configs/chainsSetup/customHashers.ts`. Then it is just a matter of referring the function name using variable `REACT_APP_CUSTOM_HASHER_CHAIN_\u003cChain number\u003e` from `.env` file.\n\n## Running the bridge\n\nPlease refer to this section of the Bridges project to run the bridge locally: [running-the-bridge](https://github.com/paritytech/parity-bridges-common#running-the-bridge)\n\n## Development\n\n### `yarn`\n\nThis will install all the dependencies for the project.\n\n### `yarn start`\n\nRuns the app in the development mode. Open [http://localhost:3001](http://localhost:3001) to view it in the browser.\n\n### `yarn test`\n\nRuns the test suite.\n\n### `yarn lint`\n\nRuns the linter \u0026 formatter.\n\n## Execute E2E test\n\n[Puppeteer](https://developers.google.com/web/tools/puppeteer/) is used for running E2E test for bridges (Only chrome for now).\n\n##### Requirements:\n\na) Have chrome installed on your computer. (This test requires it and will not download it when running);\nb) ensure that in your `env.local` file the `REACT_APP_IS_DEVELOPMENT` and `REACT_APP_KEYRING_DEV_LOAD_ACCOUNTS` are true;\nc) Make sure all steps mentioned above have run in a seperate terminal (`yarn` - `yarn start`) and the application of bridges is running;\nd) In a different terminal window run the following command:\n\n#### `yarn run test:e2e-alone`\n\n## customTypes config files process.\n\nThere is an automated process that downloads all the required types\u003cCHAIN\u003e.json files available in the deployments section of [parity-bridges-common](https://github.com/paritytech/parity-bridges-common/tree/master/deployments) repository.\nThis hook is executed before the local development server starts and during the lint/test/build process during deployment.\nIn case there is an unexpected issue with this process you can test this process isolated by running:\n\n### `yarn prestart`\n\n## Learn More\n\nFor additional information about the Bridges Project please refer to [parity-bridges-common](https://github.com/paritytech/parity-bridges-common) repository.\n\n## Docker\n\nTo build the image run the:\n\n```\ndocker build -t parity-bridges-ui:dev .\n```\n\nNow that image is built, container can start with the following command, which will serve our app on port 8080.\n\n```\ndocker run --rm -it -p 8080:80 parity-bridges-ui:dev\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparitytech%2Fparity-bridges-ui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fparitytech%2Fparity-bridges-ui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fparitytech%2Fparity-bridges-ui/lists"}