{"id":13639166,"url":"https://github.com/urbit/bridge","last_synced_at":"2025-04-06T06:14:21.403Z","repository":{"id":34019923,"uuid":"165740665","full_name":"urbit/bridge","owner":"urbit","description":"An application for interacting with Azimuth.","archived":false,"fork":false,"pushed_at":"2025-02-13T11:48:20.000Z","size":19317,"stargazers_count":98,"open_issues_count":182,"forks_count":26,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-03-30T05:09:17.772Z","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":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/urbit.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG","contributing":null,"funding":null,"license":"LICENSE","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":"2019-01-14T21:48:53.000Z","updated_at":"2025-02-16T23:20:55.000Z","dependencies_parsed_at":"2024-11-06T21:36:29.990Z","dependency_job_id":"77a4bb7d-3a3e-4545-97b8-d1122bba55c9","html_url":"https://github.com/urbit/bridge","commit_stats":null,"previous_names":[],"tags_count":61,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbit%2Fbridge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbit%2Fbridge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbit%2Fbridge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/urbit%2Fbridge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/urbit","download_url":"https://codeload.github.com/urbit/bridge/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247441063,"owners_count":20939239,"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-08-02T01:00:58.319Z","updated_at":"2025-04-06T06:14:21.378Z","avatar_url":"https://github.com/urbit.png","language":"TypeScript","funding_links":[],"categories":["Infrastructure"],"sub_categories":["Arvo"],"readme":"# Bridge\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)\n\nAn application for interacting with Azimuth.\n\n## Usage\n\n**The latest version of Bridge is accessible online at [bridge.urbit.org](https://bridge.urbit.org). No setup needed.**\n\nIf you would rather host Bridge on your own machine, read on.\n\n### Requirements\n\nPython 3.7.2\n\n### Instructions\n\n#### Download\n\n1. [Download a release](https://github.com/urbit/bridge/releases/latest)\n2. Unzip it (`bridge-$version.zip`)\n3. Open up your command line interface (Terminal on MacOS, Command Prompt on Windows)\n4. `cd` into the `bridge-$version` directory\n\n#### Verify checksums\n\nOptionally, to validate your downloaded file's integrity, compare the lines in checksum.txt to SHA-256 hashes of the `bridge-$version` directory's contents.\n\n- On MacOS: `shasum -a 256 -c checksums.txt .`\n- On Linux: `sha256sum -c checksums.txt .`\n- On Windows: Go into the `build` directory and verify files individually with `CertUtil -hashFile [file_name] SHA256`\n\n#### Run Bridge\n\n1. `cd` into the `bridge-$version` directory\n2. Run `python3 -m http.server 5000 --bind 127.0.0.1`\n3. Navigate to http://127.0.0.1:5000 using a web browser to access Bridge (we recommend using Firefox or Chrome)\n\n#### Ledger support\n\nIf you plan to authenticate with a [Ledger](https://www.ledger.com/), Bridge must be serving over HTTPS on localhost. This requires self-signed certificates. To do this:\n\n1. Install [mkcert](https://github.com/FiloSottile/mkcert)\n2. Install a local certificate authority via `mkcert -install`\n3. From the `bridge-$version` directory, run `mkcert localhost` to generate a certificate valid for localhost. This will produce two files: `localhost.pem`, the local certificate, and `localhost-key.pem`, its corresponding private key\n4. Run `python bridge-https.py`\n5. Navigate to https://localhost:4443 in a web browser to access Bridge\n\n## Bridge without internet access\n\nA proper \"offline mode\" for the latest iteration of Bridge is still being worked on. In the mean time, if you need to use Bridge on an airgapped machine, use [Bridge v1.4.1](https://github.com/urbit/bridge/releases/tag/v1.4.1).\n\n## Development\n\nSee [development.md](DEVELOPMENT.md).\n\n\n## Configurable Roller Endpoint\n\nBy default, Bridge uses Tlon's L2 Roller, but can also be configured to use your own.\n\nFor example:\n\n```sh\nVITE_ROLLER_HOST=my-personal-roller.net npm run pilot-mainnet\n```\n\nThe following are configurable, and will otherwise fallback to the defaults in `constants`:\n- `VITE_ROLLER_HOST` - host\n- `VITE_ROLLER_PORT` - port\n- `VITE_ROLLER_TRANSPORT_TYPE` - transport type (e.g., `http` or `https`)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furbit%2Fbridge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Furbit%2Fbridge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Furbit%2Fbridge/lists"}