Nodes, resources, and peers

​

Nodes

• Hosts internal resources: the functions you register with node.register(), which run in your process.
• Remembers external resources and peers it has learned about from other nodes. These are stored in requestscript.db, a SQLite file created in the working directory on startup.
• Runs RequestScript requests submitted to POST /v1/run, calling resources locally or forwarding them to the peer that hosts them.

​

Resources

const weather: StellariumResource = {
  id: 1,
  baseUrl: process.env.BASE_URL!,
  metadata: {},
  path: "com.example",
  name: "Weather",
  functions: [
    {
      name: "temperature",
      parameters: [{ name: "city", type: "string" }],
      returnType: "int32",
      exec: async (args) => 12,
    },
  ],
};

​

Requests

request GetTemperature {
  const weather: com.example.Weather

  return weather.temperature(city: "Oslo")
}

• If com.example.Weather is registered on this process, its exec runs locally.
• If it was learned from a peer, the node forwards the call to that peer’s {baseUrl}/v1/run/resource and returns the result.

​

Joining a network