import { type Chain } from "https://deno.land/x/smoldot2@light-js-deno-v0.7.10/client.d.ts";
Active connection to a blockchain.
Methods
Enqueues a JSON-RPC request that the client will process as soon as possible.
The response will be sent back using the callback passed when adding the chain.
See https://www.jsonrpc.org/specification for a specification of the JSON-RPC format. Only version 2 is supported. Be aware that some requests will cause notifications to be sent back using the same callback as the responses.
A MalformedJsonRpcError is thrown if the request isn't a valid JSON-RPC request or if the request is unreasonably large (64 MiB at the time of writing of this comment). If, however, the request is a valid JSON-RPC request but that concerns an unknown method, a error response is properly generated.
Two JSON-RPC APIs are supported by smoldot:
- The "legacy" one, documented here: https://polkadot.js.org/docs/substrate/rpc
- The more recent one: https://github.com/paritytech/json-rpc-interface-spec
Waits for a JSON-RPC response or notification to be generated.
If this function is called multiple times "simultaneously" (generating multiple different
Promise
s), each Promise
will return a different JSON-RPC response or notification.
Each chain contains a buffer of the responses waiting to be sent out. Calling this function pulls one element from the buffer. If this function is called at a slower rate than responses are generated, then buffer will eventually become full, at which point calling Chain.sendJsonRpc will throw an exception.
Disconnects from the blockchain.
The JSON-RPC callback will no longer be called.
Trying to use the chain again will lead to an exception being thrown.
If this chain is a relay chain, then all parachains that use it will continue to work. Smoldot automatically keeps alive all relay chains that have an active parachains. There is no need to track parachains and relaychains, or to destroy them in the correct order, as this is handled automatically.