on master help sign in
gall-guide: scry - rephrase scry explanation
commitcb0cc777853fcf8b2027886f2c83a144c4624680 authorTinnus Napbus <admin@tinnus-napbus.xyz> dateTue 7 Dec 2021, 01:58 (5 years ago) parent84be64e
1 file changed+4−6
content/docs/userspace/gall-guide/10-scry.md+4−6
content/docs/userspace/gall-guide/10-scry.md+4−6
@@ -11,12 +11,10 @@ rune documentation](/docs/hoon/reference/rune/dot#-dotket).
1111
1212## Scrying
1313
14−Scries are read-only requests to vanes and agents which can be initiated
15−from anywhere in any code, during its evaluation. If successful, the requested
16−data is returned immediately to that point in the code, otherwise it crashes.
17−This is in contrast to passing around `card`s, which aren't read-only and which
18−can only be produced when evaluation of the arm is complete, and for which any
19−response will come back separately.
14+A scry is a read-only request to Arvo's global namespace. Vanes and agents
15+define _scry endpoints_ which allow data to be requested from their states. The
16+endpoints can process the data in any way before returning it, but they cannot
17+alter the actual state - scries can only read, not modify.
2018
2119Most of the time, scry requests are handled by Arvo, which routes the request to
2220the appropriate vane. When you scry a Gall agent you actually scry Gall itself.