API ideas

api_ideas.txt

Proposing this structure for getters and senders.

export interface Pong {
  response: string;
}

export class Ping<TBigNumber> {
  public static PingParams = t.type({});
  public statuf PongParams = t.type({ respopnse: t.string });

  @Getter()
  public static async pingGetter<TBigNumber>(db: DB<TBigNumber>, params: t.TypeOf<typeof Ping.PingParams>): Promise<Pong> {
    return {
      response: "pong",
    };
  }
  
  @Sender()
  public static async pingSender<TBigNumber>(provider: AugurProvider, params: t.TypeOf<typeof Ping.PingParams>): Promise<Pong> {
    return Ping.PongParams.decode(provider.send(params.encode());
  }
}

The provider is responsible for the following operations:

{ subscribe, unsubscribe, send, connect, disconnect }
 
Event handlers can have a similar format
 
export PING_EVENT = "ping";

export class Ping<TBigNumber> {
  public static PongParams = t.type({ response: t.string });

  @HandleEvent()
  public static async ping<TBigNumber>(params: any): Promise<Pong> {
    return Ping.PongParams.decode(params);
  }
}

Would be nice to make sending not need to know the actual API call name...def possible but have to think about it.

This format looks fine to me. Personally, I like Connector or Connection better than Provider. I can't really think of any other better names at the moment.

What does the caller look like? What are the imports needed? Is each getter encapsulated with request, response and getter?

something like

const connector = new AugurConnector(...)

const ping = new Ping();
const param = new ping.pingParam()
const response: ping.PongParams = ping.Sender(connector, param);

I think the invocation will be more like

const response = API.send(Ping.PING_REQ, new Ping.PingParams({...});