Reference

Client options

Every option of WalletBridgeClient, with defaults and per-call timeout overrides.

Pass these to new WalletBridgeClient(options). All options are optional unless marked required. The React provider and the Vue composables accept the same options; see React and Next.js and Vue and Nuxt.

OptionTypeDefaultDescription
appCenterOriginstring | string[]noneOrigin (or origins) of the host shell. When no transport is given, the client creates and owns a PostMessageTransport for it.
transportITransportnoneYour own transport. Takes precedence over appCenterOrigin and is never destroyed for you. Required inside an iframe unless appCenterOrigin is set.
handshakeTimeoutMsnumber3000Maximum wait for the CLIENT_READY handshake.
pingTimeoutMsnumber3000Maximum wait for ping().
queryTimeoutMsnumber15000Default timeout for wallet state queries.
signingTimeoutMsnumber120000Default timeout for signTx, submitTx and signData.
autoConnectbooleanfalseStart the handshake from the constructor. Failures are only logged in debug mode.
isIframeFn() => booleanbuilt-in detectionCustom iframe detection, mainly for tests.
debugbooleanfalseEmit warnings through the logger. See Logging and debugging.
loggerLoggerconsoleDestination for debug output.

Per-call timeouts

Queries take { timeoutMs } (QueryOptions) and signing calls take { timeoutMs } (SignOptions).

The default timeouts are also exported as TIERED_TIMEOUTS (HANDSHAKE, PING, QUERY, SIGNING).

Build-time constants

SDK_VERSION is exported from the root entry and always equals the version in package.json.

See also