Configuration

Configure PIN length and the requirePin gate via BmoniEmbeddedSdk.initialize.

BmoniEmbeddedSdk.initialize accepts two optional parameters. You can call it as many times as needed — each call replaces the active configuration.

BmoniEmbeddedSdk.initialize(
  pinLength: 6,     // default
  requirePin: true, // default
);

---

Parameters

Parameter	Type	Default	Description
pinLength	int	6	Number of characters required for a valid PIN. Enforced by setPin and changePin.
requirePin	bool	true	When true, signMessage, signTransactionHash, and deleteWallet verify the supplied PIN against the stored digest before forwarding to the native plugin.

---

Reading the active config

The current configuration is always accessible:

final BmoniEmbeddedSdkConfig config = BmoniEmbeddedSdk.config;

// Convenience getters:
final int length  = BmoniEmbeddedSdk.pinLength;   // 6
final bool gated  = BmoniEmbeddedSdk.requirePin;  // true

Use these in your UI to render a PIN input of the right length or hide PIN flows entirely.

---

requirePin: false — delegating auth elsewhere

When you manage authentication outside the SDK (biometrics, OS lockscreen, server-side challenge), set requirePin: false:

BmoniEmbeddedSdk.initialize(requirePin: false);

await BmoniEmbeddedSdk.initWallet();
final sig = await BmoniEmbeddedSdk.signMessage('hi'); // no pin argument needed

When requirePin is false, any supplied pin argument is silently ignored by signMessage, signTransactionHash, and deleteWallet. PIN management methods (setPin, changePin, etc.) still work — toggling requirePin only changes whether the stored PIN is used as a gate.

---

Changing the PIN length at runtime

You can change pinLength after a PIN is already set. However, the stored digest was created with the old length — you will need to prompt the user to remove and re-create their PIN for verification to succeed.

// Before:
BmoniEmbeddedSdk.initialize(pinLength: 6);
await BmoniEmbeddedSdk.setPin('123456');

// After changing length:
BmoniEmbeddedSdk.initialize(pinLength: 4);
// Old 6-digit PIN no longer matches the new length constraint.
// Prompt the user to removePin + setPin with a 4-digit value.