{"id":22106967,"url":"https://github.com/prompt/handles-server","last_synced_at":"2026-03-14T07:03:51.238Z","repository":{"id":265632470,"uuid":"889988854","full_name":"prompt/handles-server","owner":"prompt","description":"Bluesky handle verification requests server.","archived":false,"fork":false,"pushed_at":"2024-12-13T14:18:55.000Z","size":70,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-23T00:46:09.238Z","etag":null,"topics":["bluesky","bsky","handles"],"latest_commit_sha":null,"homepage":"https://handles.net","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/prompt.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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},"funding":{"github":"pr-mpt"}},"created_at":"2024-11-17T18:32:14.000Z","updated_at":"2025-01-08T18:16:02.000Z","dependencies_parsed_at":"2024-11-30T08:31:48.034Z","dependency_job_id":"6eea0198-28b4-4ee5-b0d9-3f42aec538aa","html_url":"https://github.com/prompt/handles-server","commit_stats":null,"previous_names":["prompt/handles-server"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prompt%2Fhandles-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prompt%2Fhandles-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prompt%2Fhandles-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prompt%2Fhandles-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prompt","download_url":"https://codeload.github.com/prompt/handles-server/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236157029,"owners_count":19104111,"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":["bluesky","bsky","handles"],"created_at":"2024-12-01T08:12:40.411Z","updated_at":"2026-03-14T07:03:51.208Z","avatar_url":"https://github.com/prompt.png","language":"TypeScript","readme":"# Handles Server\n\nA very simple server that verifies Bluesky (atproto) handles using the\n[HTTPS well-known Method][atproto/resolution/well-known]; an alternative to\nmanaging many DNS records.\n\n## Quickstart\n\n```bash\nsh -c \"$(curl -Ls https://handles.run)\"\n```\n\n...or [download the latest release][releases].\n\n### Railway\n\n[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/template/JGzTOH?referralCode=M8LQLq)\n\nOne-click deploy is available using Railway.com[^1].\n\n## Implementation\n\nA `handle` is a hostname (e.g: `alice.example.com`) which the server may or may\nnot be able to provide a Decentralized ID for. A handle is made up of a `domain`\n(e.g: `example.com`) and a `username` (e.g: `alice`). A provider\n(`ProvidesDecentralizedIDs`) is responsible for getting a Decentralized ID from\na handle.\n\n## Providers\n\n- [x] Postgres\n- [x] Memory\n- [ ] Google Sheets\n- [ ] Filesystem\n\n## Configuration\n\n| Environment Variable       | Description                                                | Example                                |\n| -------------------------- | ---------------------------------------------------------- | -------------------------------------- |\n| **`DID_PROVIDER`**         | **Required** Name of a supported provider                  | `postgres` `memory`                    |\n| `REDIRECT_DID_TEMPLATE`    | URL template for redirects when a DID is found             | `https://bsky.app/profile/{did}`       |\n| `REDIRECT_HANDLE_TEMPLATE` | URL template for redirects when a DID is not found         | `https://example.com/?handle={handle}` |\n| `CHECK_DOMAIN_PARAMETER`   | Query parameter used by check domain endpoint (`/domainz`) | `handle` `hostname` `domain`           |\n\n### `memory` provider\n\n| Environment Variable | Description                                           | Example                         |\n| -------------------- | ----------------------------------------------------- | ------------------------------- |\n| **`MEMORY_DIDS`**    | **Required** Comma separated list of handle@did pairs | `alice.example.com@did:plc:001` |\n| **`MEMORY_DOMAINS`** | **Required** Comma separate list of supported domains | `example.com,example.net`       |\n\n### `postgres` provider\n\n| Environment Variable     | Description                            | Example                                      |\n| ------------------------ | -------------------------------------- | -------------------------------------------- |\n| **`DATABASE_URL`**       | **Required** Postgres database URL     | `postgres://postgres@localhost:5432/handles` |\n| `DATABASE_TABLE_DIDS`    | Table containing `handle` + `did` rows | `dids` `active_handles`                      |\n| `DATABASE_TABLE_DOMAINS` | Table containing `domain` rows         | `domains` `active_domains`                   |\n\n### URL templates\n\nA string containing zero or more tokens which are replaced when rendering.\n\n| Token               | Value                                           | Example(s)                 |\n| ------------------- | ----------------------------------------------- | -------------------------- |\n| `{handle}`          | Formatted handle from the request               | `alice.example.com`        |\n| `{did}`             | Decentralized ID found for the request's handle | `did:plc:example001` ` `   |\n| `{handle.domain}`   | Top level domain from the handle                | `example.com`              |\n| `{handle.username}` | Username part of the handle                     | `alice` `bob`              |\n| `{request.scheme}`  | Request's scheme                                | `https` `http`             |\n| `{request.host}`    | Request's host                                  | `alice.example.com`        |\n| `{request.path}`    | Path included in the request                    | `/hello-world` ` `         |\n| `{request.query}`   | Query included in the request                   | `greeting=Hello+World` ` ` |\n\n[atproto/resolution/well-known]: https://atproto.com/specs/handle#handle-resolution\n[releases]: https://github.com/prompt/handles-server/releases\n\n[^1]: Railway provide [a 25% \"Template Kickback\"](https://railway.com/open-source-kickback) when you sign up using our link\n","funding_links":["https://github.com/sponsors/pr-mpt"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprompt%2Fhandles-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprompt%2Fhandles-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprompt%2Fhandles-server/lists"}