5.7.1.2 loader.mjs

The loader.mjs module exports the following functions that might help you write code that is portable to multiple consensus networks.

—

canonicalizeConnectorMode(string) => string

Expands a connector mode prefix to its full, canonical name. The canonical connector modes are:

• ETH-live

• ETH-browser

• ETH-devnet, for 'ETH'.

• ALGO-live

• ALGO-browser

• ALGO-devnet, for 'ALGO'.

—

getConnectorMode() => string

Returns the canonicalized connector mode, based on the process.env.REACH_CONNECTOR_MODE environment variable. If the variable is missing or empty, it will return the canonicalized form of 'ETH'.

—

getConnector() => Connector

Returns the first piece of getConnectorMode().

—

loadStdlib(env) => Promise<stdlib>

Returns a Promise for a stlib based on the provided env string or map. In environments where the reach stdlib has implicit access to process.env, you may omit the env argument, in which case process.env will be used.

If the reach stdlib is being used with JavaScript bundlers like webpack – as it is with React, for example – then the reach stdlib does not have implicit access to process.env. In such scenarios, we recommend that you call this function like so:

const reach = await loadStdlib(process.env);

You may instead pass in the string 'ETH' or the string 'ALGO' to select the desired stdlib directly.

By default, this method allows a user to load a standard library for a single connector. That is, this method may not be called multiple times with varying connectors. To bypass this restriction, use unsafeAllowMultipleStdlibs.

—

unsafeAllowMultipleStdlibs() => null

Calling this function will lift the restriction that loadStdlib imposes on loading multiple standard libraries.