Ask to reach a host

A forge hosted by another reaches the internet only through its host's gate, by name, on port 443, and only the names on the host's list. The list starts as the public git hosts (GitHub, GitLab, Codeberg, Bitbucket) and the forges beside it. A person who connects their own forge on their own domain is refused by the gate, and cannot change the host's list. So the hosted forge asks, and the host's admin answers.

On the hosted forge

The pasted token waits with the ask, sealed like a connected account's token: fifteen minutes if nobody asks, seven days once asked, and it is erased the moment the connect runs. The forge looks for the answer every ten seconds while an ask is under an hour old, with every heartbeat after that, and whenever the page is open.

On the host

A grant applies at once and restarts nothing. The gate asks for the list on every connection (childGate, src/spawn/child_reach.ts), so Allow opens, and Remove or the switch closes, a forge that is running.

What stays closed

Where it lives

Rows: child_reach_ask and child_reach_grant on the host, reach_ask on the hosted forge (src/core/child_reach.ts, src/core/reach_ask.ts). The ask travels as a signed call on the door a hosted forge already has to its host (POST /api/v1/reach on src/spawn/beat-door.ts, checked by src/spawn/signed_call.ts). Actions: src/actions/ask_host.ts (hosted forge), src/actions/child_reach.ts (host). Tests: test/ask-to-reach.test.ts, with the real gate.

The sentence and its one action are built by blockedBy (docs/features/blocked-by.md).

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs