Remote Procedure Call RPC

Introduction

Remote Procedure Call (RPC) is a mechanism which allows a program to invoke a function that is defined in another address space. If a user, A, writes a function and shares it with another user B, then B can invoke the shared function in A's program. The return value of the function is retrieved by B, which can then be used in B's program.

RPC is implemented using the Source Academy Module feature. The module is named 'rpc' and exposes three functions, namely connect, share and executeAfter.

The RPC also allows sharing of values in Source programs. These include numbers, strings, booleans, null and undefined. The sharing of arrays of arbitrary nesting is also allowed, along with lists and pairs which resolve into arrays themselves.

User Documentation

To start off, the functions mentioned above must be imported from the module 'rpc' using Source's import statement. The behaviour of the aforementioned functions is described as follows: -

• share - Returns a promise that resolves to a token that uniquely identifies the shared data or function. share accepts data or functions as input and runs asynchronously. The obtained token, when shared to another user, can be supplied as input to the connect function to retrieve the shared data or function.

  • Parameter: input - Any value that occurs in a Source program.
  • Returns: A promise that resolves to a token that uniquely identifies the shared content.

• connect - Returns a promise that resolves to the content that is uniquely identified by the input token. The function throws an error if the input is invalid. connect executes asynchronously like share.

Prerequisites and Resources

This system requires an understanding and familiarity with a broad range of topics. The following is a non-exhaustive but comprehensive list of topics and resources that should help a developer get started:

Since this project is written in Typescript, familiarity with Typescript/Javascript (JS) is required.

Topic	Reference Resource
Source Academy Modules system	[https://github.com/source-academy/modules/wiki](Modules wiki)
Remote Procedure Calls	[https://en.wikipedia.org/wiki/Remote_procedure_call](Wikipedia Article)
How Javascript is executed by the browser	How Javascript works in the browser
Asynchronous and Concurrent program execution	[https://www.youtube.com/watch?v=0vFgKr5bjWI](Video by Hussein Nasser)
Javascript Event Loop	[https://www.youtube.com/watch?v=cCOL7MC4Pl0](The JavaScript Event Loop explained)
Firestore Realtime Database	[https://firebase.google.com/docs/firestore/quickstart](Quickstart Guide)
JavaScript Promises and async-await	[https://javascript.info/async](Series of articles)

System Overview

Semantical Specifications

Functions explanation