Here are all of Eyre's scry endpoints. There's not too many and they mostly deal with either CORS settings or aspects of the state of connections.

The first few have a care of x and are a scry like .^([type] %ex /=//=/[some-path]) (note the empty desk). The rest have no care and the tag replaces the desk like .^([type] %e /=[something]=).

All examples are run from the dojo.

/cors

An x scry with a path of /cors will return Eyre's CORS origin registry. The type returned is a cors-registry which contains the sets of approved, rejected and requested origins.

Example

> .^(cors-registry:eyre %ex /=//=/cors)
[ requests={~~http~3a.~2f.~2f.baz~.example}
  approved={~~http~3a.~2f.~2f.foo~.example}
  rejected={~~http~3a.~2f.~2f.bar~.example}
]

/cors/requests

An x scry with a path of /cors/requests will return the set of pending origin requests. These are origins that were in an Origin: ... HTTP header but weren't in the existing approved or rejected sets. The type returned is a (set origin:eyre).

Example

> .^(requests=(set origin:eyre) %ex /=//=/cors/requests)
requests={~~http~3a.~2f.~2f.baz~.example}

/cors/approved

An x scry with a path of /cors/approved will return the set of approved CORS origins. The type returned is a (set origin:eyre).

Example

> .^(approved=(set origin:eyre) %ex /=//=/cors/approved)
approved={~~http~3a.~2f.~2f.foo~.example}

/cors/approved/[origin]

An x scry whose path is /cors/approved/[origin] tests whether the given origin URL is in the approved set of the CORS registry. The type returned is a simple ?.

The origin URL is a @t, but since @t may not be valid in a path, it must be encoded in a @ta using +scot like (scot %t 'foo') rather than just 'foo'.

Examples

> .^(? %ex /=//=/cors/approved/(scot %t 'http://foo.example'))
%.y

> .^(? %ex /=//=/cors/approved/(scot %t 'http://bar.example'))
%.n

/cors/rejected

An x scry with a path of /cors/rejected will return the set of rejected CORS origins. The type returned is a (set origin:eyre).

Example

> .^(rejected=(set origin:eyre) %ex /=//=/cors/rejected)
rejected={~~http~3a.~2f.~2f.bar~.example}

/cors/rejected/[origin]

An x scry whose path is /cors/rejected/[origin] tests whether the given origin URL is in the rejected set of the CORS registry. The type returned is a simple ?.

The origin URL must be a cord-encoded @t rather than just the plain @t, so you'll have to do something like (scot %t 'foo') rather than just 'foo'.

Examples

> .^(? %ex /=//=/cors/rejected/(scot %t 'http://bar.example'))
%.y

> .^(? %ex /=//=/cors/rejected/(scot %t 'http://foo.example'))
%.n

/authenticated/cookie

An x scry whose path is /authenticated/cookie/[cookie] tests whether the given cookie is currently valid. The type returned is a ?.

The cookie must be the full cookie including the urbauth-{SHIP}= part. The cookie must be a knot-encoded @t rather than just a plain @t, so you'll have to do something like (scot %t 'foo') rather than just 'foo'.

Examples

> .^(? %ex /=//=/authenticated/cookie/(scot %t 'urbauth-~zod=0vvndn8.bfsjj.j3614.k40ha.8fomi'))
%.y

> .^(? %ex /=//=/authenticated/cookie/(scot %t 'foo'))
%.n

/cache/[aeon]/[url]

An %x /cache scry will return the cached value for the given [url] at the given [aeon] if it exists.

The [url] must be a knot-encoded @t rather than just a plain @t, so you'll have to do something like (scot %t 'foo') rather than just 'foo'.

%bindings

A scry with bindings in place of the desk in the beak will return Eyre's URL path bindings. The type returned is a (list [binding:eyre duct action:eyre]) (see the $binding & $action sections of the Data Types document for details).

Example

> .^((list [binding:eyre duct action:eyre]) %e /=bindings=)
~[
  [ [site=~ path=<|~landscape js bundle|>]
    ~[/gall/use/file-server/0w2.EijQB/~zod/~landscape/js/bundle /dill //term/1]
    [%app app=%file-server]
  ]
  [ [site=~ path=<|~landscape|>]
    ~[/gall/use/file-server/0w2.EijQB/~zod/~landscape /dill //term/1]
    [%app app=%file-server]
  ]
  ...(truncated for brevity)...
]

%connections

A scry with connections in place of the desk in the beak will return all open HTTP connections that aren't fully complete. The type returned is a (map duct outstanding-connection:eyre) (see the $outstanding-connection section of the Data Types document for details).

Example

> .^((map duct outstanding-connection:eyre) %e /=connections=)
{}

%authentication-state

A scry with authentication-state in place of the desk in the beak will return authentication details of all current sessions. The type returned is a $authentication-state. The p field is the cookie sans the urbauth-[ship]= part.

Example

> .^(authentication-state:eyre %e /=authentication-state=)
  sessions
{ [ p=0v3.kags1.hj7hm.6llrl.cga2j.eh1r7
    q=[expiry-time=~2021.5.20..08.44.27..39e0 channels={}]
  ]
}

%channel-state

A scry with channel-state in place of the desk in the beak will return details of the state of each channel. The type returned is a channel-state.

Example

> .^(channel-state:eyre %e /=channel-state=)
[   session
  { [ p='1601844290-ae45b'
        q
      [ state=[%.y p=[date=~2021.5.13..20.44.27..39e0 duct=~[//http-server/0v2.kmj6q/26/1]]]
        next-id=1
        last-ack=~2021.5.13..08.44.27..39e0
        events={[id=0 request-id=2 channel-event=[%poke-ack p=~]]}
        unacked={}
        subscriptions={}
        heartbeat=~
      ]
    ]
  }
  duct-to-key={}
]

%host

A scry with host in place of the desk in the beak will return host details of the ship. The type returned is a hart:eyre.

Example

> .^(hart:eyre %e /=host=)
[p=%.n q=[~ 8.080] r=[%.y p=<|localhost|>]]