Class HostProvider

constructor

• new HostProvider(options?: HostProviderOptions): HostProvider

  Parameters

  • Optionaloptions: HostProviderOptions

  Returns HostProvider

Readonlytype

connect

• connect(signal?: AbortSignal): Promise<Result<SignerAccount[], SignerError>>

  Attempt to connect and discover accounts.

  Parameters

  • Optionalsignal: AbortSignal

    Optional AbortSignal to cancel the connection attempt.

  Returns Promise<Result<SignerAccount[], SignerError>>

  Accounts on success, typed error on failure.

createRingVRFProof

• createRingVRFProof(
      dotNsIdentifier: string,
      derivationIndex: number,
      location: RingLocation,
      message: Uint8Array,
  ): Promise<Result<Uint8Array<ArrayBufferLike>, SignerError>>

  Create a Ring VRF proof for anonymous operations.

  Proves that the signer is a member of the ring at the given location without revealing which member. Used for privacy-preserving protocols.

  Requires a prior successful connect() call.

  Parameters

  • dotNsIdentifier: string
  • derivationIndex: number
  • location: RingLocation
  • message: Uint8Array

  Returns Promise<Result<Uint8Array<ArrayBufferLike>, SignerError>>

disconnect

• disconnect(): void

  Disconnect and clean up resources. Safe to call multiple times.

  Returns void

getProductAccount

• getProductAccount(
      dotNsIdentifier: string,
      derivationIndex?: number,
  ): Promise<Result<SignerAccount, SignerError>>

  Get an app-scoped product account from the host.

  Product accounts are derived by the host wallet for each app, identified by dotNsIdentifier (e.g., "mark3t.dot"). The user controls these accounts but they are scoped to the requesting app.

  Requires a prior successful connect() call.

  Parameters

  • dotNsIdentifier: string
  • derivationIndex: number = 0

  Returns Promise<Result<SignerAccount, SignerError>>

getProductAccountAlias

• getProductAccountAlias(
      dotNsIdentifier: string,
      derivationIndex?: number,
  ): Promise<Result<ContextualAlias, SignerError>>

  Get a contextual alias for a product account via Ring VRF.

  Aliases prove account membership in a ring without revealing which account produced the alias.

  Requires a prior successful connect() call.

  Parameters

  • dotNsIdentifier: string
  • derivationIndex: number = 0

  Returns Promise<Result<ContextualAlias, SignerError>>

getProductAccountSigner

• getProductAccountSigner(account: ProductAccount): PolkadotSigner

  Get a PolkadotSigner for a product account.

  Convenience method for when you already have the product account details. Requires a prior successful connect() call.

  Parameters

  • account: ProductAccount

  Returns PolkadotSigner

onAccountsChange

• onAccountsChange(callback: (accounts: SignerAccount[]) => void): Unsubscribe

  Subscribe to account list changes.

  Emitted when the set of available accounts changes (e.g., user connects/disconnects in the host wallet).

  Parameters

  • callback: (accounts: SignerAccount[]) => void

  Returns Unsubscribe

  Unsubscribe function.

onStatusChange

• onStatusChange(callback: (status: ConnectionStatus) => void): Unsubscribe

  Subscribe to connection status changes.

  Not all providers emit status changes — for example, dev accounts are always "connected" and never emit.

  Parameters

  • callback: (status: ConnectionStatus) => void

  Returns Unsubscribe

  Unsubscribe function.

StaticinjectSpektr

• injectSpektr(loadSdk?: () => Promise<ProductSdkModule>): Promise<boolean>

  Inject the host wallet as a Spektr extension into window.injectedWeb3.

  This is a compatibility fallback for container environments where the direct Host API connection fails. After injection, the host wallet appears as a standard browser extension and can be used via ExtensionProvider.

  The direct Host API path (via HostProvider.connect()) is preferred because it supports the full Host API surface (product accounts, Ring VRF, etc.). Spektr injection only provides non-product account access.

  Parameters

  • OptionalloadSdk: () => Promise<ProductSdkModule>

    Custom SDK loader for testing. Defaults to dynamic import.

  Returns Promise<boolean>

  true if injection succeeded, false otherwise.