Fine-tune Known RPC Method Typings

[harrysolovay]

...

state_getChildKeys: TODO_NARROW_METHOD_TYPE;
state_getChildReadProof: TODO_NARROW_METHOD_TYPE;
state_getChildStorage: TODO_NARROW_METHOD_TYPE;
state_getChildStorageHash: TODO_NARROW_METHOD_TYPE;
state_getChildStorageSize: TODO_NARROW_METHOD_TYPE;
sudo_unstable_p2pDiscover(multiaddr: U.HexEncoded<MultiAddress>): void;
sudo_unstable_version(): string;
syncstate_genSyncSpec: TODO_NARROW_METHOD_TYPE;
transaction_unstable_unwatch(subscription: SubId): void;
chainHead_unstable_body(followSubscription: U.HexHash, networkConfig?: T.NetworkConfig): string;
chainHead_unstable_call(
  hash: U.HexHash | null,
  fn: string,
  callParameters: U.Hex,
  networkConfig?: T.NetworkConfig,
): string;
chainHead_unstable_genesisHash(): U.HexHash;
chainHead_unstable_header(followSubscription: string, hash: U.HexHash): U.Hex | null;
chainHead_unstable_stopBody(subscription: string): void;
chainHead_unstable_stopCall(subscription: string): void;
chainHead_unstable_stopStorage(subscription: string): void;
chainHead_unstable_storage(
  follow_subscription: SubId,
  hash: U.HexHash,
  key: U.Hex,
  childKey?: U.Hex,
  networkConfig?: T.NetworkConfig,
): string;
chainHead_unstable_unfollow(followSubscription: SubId): void;
chainHead_unstable_unpin(followSubscription: SubId, hash: U.HexHash): void;
chainSpec_unstable_chainName(): string;
chainSpec_unstable_genesisHash(): string;
chainSpec_unstable_properties(): unknown;
chainSpec_getBlockStats(at: U.HexHash): T.BlockStats | null;
chainSpec_createBlock: TODO_NARROW_METHOD_TYPE;
chainSpec_finalizeBlock: TODO_NARROW_METHOD_TYPE;
rpc_methods(): T.RpcMethods;
// subscriptions
chainHead_unstable_follow(runtimeUpdates: boolean): T.ChainHeadUnstableFollowEvent;
transaction_unstable_submitAndWatch(transaction: U.Hex): unknown;

{
  /** Invalid JSON was received by the server. */
  ParseError: [-32700];
  /** The JSON sent is not a valid Request object. */
  InvalidRequest: [-32600];
  /** The method does not exist / is not available. */
  MethodNotFound: [-32601];
  /** Invalid method parameter(s). */
  InvalidParams: [-32602];
  /** Internal JSON-RPC error. */
  InternalError: [-32603];
  /**
   * Other internal server error.
   * Contains a more precise error code and a custom message.
   * Error code must be in the range -32000 to -32099 included.
   */
  ServerError: [number];
  /**
   * Method-specific error.
   * Contains a more precise error code and a custom message.
   * Error code must be outside of the range -32000 to -32700.
   */
  MethodError: [number];
};

[tjjfvi]

I believe all of the unknown methods are smoldot-related

[harrysolovay]

• Unstable method types can go in a rpc/known/unstable
• Smoldot-specific methods can go in rpc/known/smoldot
• https://github.com/paritytech/json-rpc-interface-spec

[kratico]

@harrysolovay @tjjfvi Would you remind me the scope of this task?
So far, I took the list from the description and added the smoldot type signature from https://github.com/paritytech/smoldot/blob/ae334e77b477c6e6d0dc38d3a4429f0038bad20b/src/json_rpc/methods.rs#L334-L485

Open questions

• Is the list complete?
• Shall I add all smoldot methods from the rpc_methods call?
• Regarding the description errors, I guess that these are all from smoldot, right? https://github.com/paritytech/smoldot/blob/ae334e77b477c6e6d0dc38d3a4429f0038bad20b/src/json_rpc/parse.rs#L174-L198

I committed a some types to #405

[harrysolovay]

Is the list complete?

Not sure... I believe the complete list should be in this file (permalinked).

Shall I add all smoldot methods from the rpc_methods call?

In the case of Smoldot-related typings let's get a solid foundation and then kindly ping Pierre for a full review of the Smoldot integration.

Regarding the description errors, I guess that these are all from smoldot, right?

Yes :)