Skip to content

Commit e657c46

Browse files
committed
docs: document out-of-scope alternatives
- browser detection requires separate IPIP (security concerns) - health checking left to implementers - stale file handling left to implementers
1 parent 9d0024f commit e657c46

File tree

1 file changed

+18
-1
lines changed

1 file changed

+18
-1
lines changed

src/ipips/ipip-0280.md

Lines changed: 18 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -97,7 +97,24 @@ See "Security" section of :cite[gateway-detection].
9797

9898
### Alternatives
9999

100-
N/A. This IPIP covers both environment variable and configuration file.
100+
#### Browser Environment Detection
101+
102+
Detection via browser APIs (e.g., `localStorage.getItem('IPFS_GATEWAY')`) was
103+
considered but is explicitly out of scope. Any JavaScript running on a page
104+
could overwrite such values and hijack gateway requests. Browser-based detection
105+
requires a separate IPIP with proper security review.
106+
107+
#### Gateway Health Checking
108+
109+
This specification does not mandate health checking of detected gateways.
110+
Implementations MAY verify that a gateway is responsive before using it,
111+
but the specific approach is left to implementers.
112+
113+
#### Stale Gateway File Handling
114+
115+
If a daemon crashes without removing the `gateway` file, it may contain a stale
116+
URL. This specification does not mandate specific handling. Implementations MAY
117+
implement timeout-based health checks or other recovery mechanisms.
101118

102119
### Copyright
103120

0 commit comments

Comments
 (0)