Developer docs

AppView API

Read-only XRPC queries over the co/core indexed read-model — receipts, jobs, providers, and social graph state.

Basehttp://services.railway.internal:8081/xrpc·read-only

Overview

The co/core AppView indexes provider-signed records under dev.cocore.* from the network firehose. It exposes a small read API at http://services.railway.internal:8081/xrpc for discovery, verification, and analytics. Authoritative state remains in each actor's PDS — the AppView is a cache, not a ledger.

Service discovery

Service DID is did:web:services:railway:internal. Production deployments advertise the AppView endpoint via #cocore_appview on the console DID document.

Inference API

To run inference against co/core providers, use the OpenAI-compatible chat completions surface documented on /docs/inference. Drop-in replacement: change the base URL and API key in your existing OpenAI SDK client.

Directory

no auth · 4 endpoints

dev.cocore.appview.listProvidersqueryauth: none

List indexed provider records (`dev.cocore.compute.provider`).

curl

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.listProviders'

response

Click Run example to fetch a live response.

dev.cocore.appview.listProfilesqueryauth: none

List indexed account profile records (`dev.cocore.account.profile`).

curl

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.listProfiles'

response

Click Run example to fetch a live response.

dev.cocore.appview.getProfilequeryauth: none

Full profile payload for one DID — machines, activity counts, and social context.

Param	Type
did*	did

curl

did

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.getProfile?did=did%3Aplc%3Aexample-provider'

response

Click Run example to fetch a live response.

dev.cocore.appview.listAccountsqueryauth: none

Discovery directory of signed-up DIDs with profile and provider counts.

Param	Type
limit	integer
offset	integer
sortBy	string
providersOnly	boolean
viewerDid	did
excludeViewerFriends	boolean
q	string

curl

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.listAccounts?limit=12&q=alice'

response

Click Run example to fetch a live response.

Social graph

no auth · 2 endpoints

dev.cocore.appview.listIncomingFriendsqueryauth: none

Friend records whose subject is the queried DID.

Param	Type
did*	did
limit	integer

curl

did

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.listIncomingFriends?did=did%3Aplc%3Aexample-requester&limit=10'

response

Click Run example to fetch a live response.

dev.cocore.appview.listFriendEdgesqueryauth: none

Every directed trust edge in the indexed network (friender → subject).

Param	Type
limit	integer

curl

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.listFriendEdges?limit=100'

response

Click Run example to fetch a live response.

Compute index

no auth · 3 endpoints

dev.cocore.appview.getReceiptsqueryauth: none

Indexed receipt records with optional provider, requester, or job filters.

Param	Type
provider	did
requester	did
job	at-uri

curl

provider

requester

job

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.getReceipts?provider=did%3Aplc%3Aexample-provider'

response

Click Run example to fetch a live response.

dev.cocore.appview.getJobsqueryauth: none

Indexed job records for a requester DID.

Param	Type
requester*	did

curl

requester

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.getJobs?requester=did%3Aplc%3Aexample-requester'

response

Click Run example to fetch a live response.

dev.cocore.appview.getSettlementsqueryauth: none

Indexed settlement records with optional receipt or requester filters.

Param	Type
receipt	at-uri
requester	did

curl

receipt

requester

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.getSettlements?receipt=at%3A%2F%2Fdid%3Aplc%3Aexample-provider%2Fdev.cocore.compute.receipt%2Fxyz'

response

Click Run example to fetch a live response.

Verification

no auth · 2 endpoints

dev.cocore.appview.verifyReceiptqueryauth: none

Structural + cryptographic verification of an indexed receipt against its job and attestation.

Param	Type
uri*	at-uri

curl

uri

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.verifyReceipt?uri=at%3A%2F%2Fdid%3Aplc%3Aexample-provider%2Fdev.cocore.compute.receipt%2Fxyz'

response

Click Run example to fetch a live response.

dev.cocore.appview.verifySettlementqueryauth: none

Verify a settlement chain against indexed receipt and authorization records.

Param	Type
uri*	at-uri

curl

uri

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.verifySettlement'

response

Click Run example to fetch a live response.

Analytics

no auth · 2 endpoints

dev.cocore.appview.modelActivityqueryauth: none

Aggregate receipt activity per model across rolling time windows.

curl

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.modelActivity'

response

Click Run example to fetch a live response.

dev.cocore.appview.latencyqueryauth: none

Network latency rollup derived from indexed receipt timestamps.

curl

curl -sS 'http://services.railway.internal:8081/xrpc/dev.cocore.appview.latency'

response

Click Run example to fetch a live response.