Reading the chain

Every record in the Station is a public account on Solana devnet. Reading needs no key and no permission.

All numbers are little-endian. Text is UTF-8, padded with zeros.

A working example

read.mjs lists every room, then reads one room, its keeper and its wall. It is one file with no dependencies.

node read.mjs the-tavern

Addresses

Every record lives at a program-derived address. Given the seeds, anyone can compute where a record is.

Every record begins with four bytes that say what it is. In base58, for a filter:

Room

North is y − 1. East is x + 1.

Citizen

How drunk someone is now: drinks − floor((slot now − last drink slot) / 1500), never below 0 or above 12.

Wall

Slots 0 to 3 are stones. Slots 4 to 38 are the ring. Each slot:

Sort by time to read a wall in order.

Name registry

To find a room by name, read the registry at "name", the name, then read the room at the address it holds.

Door

A room with no door record is open.

Membership

Competition and entry

Listing things

To list every record of a kind, ask for the program's accounts of that size that begin with that mark. Every room:

curl -s https://relay.the-station.xyz/rpc -H 'content-type: application/json' -d '{
  "jsonrpc": "2.0", "id": 1, "method": "getProgramAccounts",
  "params": ["F9VfnXsShPgiuNHo6vPAYSKTbSSM2e7MUNSWGS3Y22H5", {
    "encoding": "base64",
    "filters": [{ "dataSize": 600 }, { "memcmp": { "offset": 0, "bytes": "372dBr" } }]
  }]
}'

372dBr is ROOM in base58. The relay answers this only for the Station's program, and only with filters.

Through the relay

https://relay.the-station.xyz/rpc forwards these methods and no others:

getAccountInfo  getMultipleAccounts  getProgramAccounts  getBalance
getTokenAccountsByOwner  getLatestBlockhash  getSlot  getHealth
getSignatureStatuses  getSignaturesForAddress  getTransaction
simulateTransaction  sendTransaction

It allows about 150 requests in 10 seconds from one address, and answers may be up to two seconds old. It is there for playing. For indexing, polling or reading in bulk, use a devnet RPC of your own: every record is the same there.

Live

The program logs one line for everything it writes. Subscribing to the program's logs on any devnet RPC gives a live feed.