web3auth_flutter

Description:

web3auth flutter

Web3Auth Flutter SDK #
Web3Auth is where passwordless auth meets non-custodial key infrastructure for Web3 apps and wallets. By aggregating OAuth (Google, Twitter, Discord) logins, different wallets and innovative Multi Party Computation (MPC) - Web3Auth provides a seamless login experience to every user on your application.
📖 Documentation #
Checkout the official Web3Auth Documentation and SDK Reference to get started!
💡 Features #

Plug and Play, OAuth based Web3 Authentication Service
Fully decentralized, non-custodial key infrastructure
End to end Whitelabelable solution
Threshold Cryptography based Key Reconstruction
Multi Factor Authentication Setup & Recovery (Includes password, backup
phrase, device factor editing/deletion etc)
Support for WebAuthn & Passwordless Login
Support for connecting to multiple wallets
DApp Active Session Management

...and a lot more
⏪ Requirements #

For iOS, only iOS 14+ supported since we requires ASWebAuthenticationSession.

Xcode 11.4+ / 12.x
Swift 4.x / 5.x
For iOS build: platform :ios needs to be 14.0. Check ios/Podfile in
your Flutter project to change it.


For Android, API version 24 or newer is supported.

For Android build: compileSdkVersion needs to be 34.
Check android/app/build.gradle in your Flutter project to change it.



⚡ Installation #
Add web3auth_flutter as a dependency to your pubspec.yaml file.
dependencies:
web3auth_flutter: ^4.0.0
copied to clipboard
or
flutter pub add web3auth_flutter
copied to clipboard
🌟 Configuration #
Checkout SDK Reference to configure for Android and iOS
builds.
🩹 Example #
Checkout the examples for your preferred blockchain and platform in our examples
// Initialization
Future<void> initPlatformState() async {
final themeMap = HashMap<String, String>();
themeMap['primary'] = "#fff000";

Uri redirectUrl;
if (Platform.isAndroid) {
redirectUrl = Uri.parse(
'torusapp://org.torusresearch.flutter.web3authexample/auth',
);
} else if (Platform.isIOS) {
redirectUrl =
Uri.parse('torusapp://org.torusresearch.flutter.web3authexample');
} else {
throw UnKnownException('Unknown platform');
}

await Web3AuthFlutter.init(
Web3AuthOptions(
clientId:
'BHgArYmWwSeq21czpcarYh0EVq2WWOzflX-NTK-tY1-1pauPzHKRRLgpABkmYiIV_og9jAvoIxQ8L3Smrwe04Lw',
network: Network.sapphire_devnet,
redirectUrl: redirectUrl,
whiteLabel: WhiteLabelData(
mode: ThemeModes.dark,
appName: "Web3Auth Flutter App",
theme: themeMap,
),
),
);

// Call initialize() function to get privKey and user information without relogging in user if a user has an active session
await Web3AuthFlutter.initialize();

// Call getPrivKey() function to get user private key
final String privKey = await Web3AuthFlutter.getPrivKey();

// Call getEd25519PrivKey() function to get user ed25519 private key
final String ed255199PrivKey = await Web3AuthFlutter.getEd25519PrivKey();

// Call getUserInfo() function to get user information like name, email, verifier, verifierId etc.
final TorusUserInfo userInfo = await Web3AuthFlutter.getUserInfo();

}

// Login
await Web3AuthFlutter.login(LoginParams(loginProvider: Provider.google));

// Logout
await Web3AuthFlutter.logout();
copied to clipboard
🩹 Custom JWT - Example #
// Initialization
Future<void> initPlatformState() async {
final themeMap = HashMap<String, String>();
themeMap['primary'] = "#fff000";

Uri redirectUrl;
if (Platform.isAndroid) {
redirectUrl = Uri.parse(
'torusapp://org.torusresearch.flutter.web3authexample/auth',
);
} else if (Platform.isIOS) {
redirectUrl =
Uri.parse('torusapp://org.torusresearch.flutter.web3authexample');
} else {
throw UnKnownException('Unknown platform');
}

final loginConfig = new HashMap<String, LoginConfigItem>();
loginConfig['jwt'] = LoginConfigItem(
verifier: "verifier-name", // get it from web3auth dashboard
typeOfLogin: TypeOfLogin.jwt,
name: "Custom JWT Login",
clientId: "web3auth_client_id" // web3auth's plug and play client id
);

await Web3AuthFlutter.init(
Web3AuthOptions(
clientId:
'BHgArYmWwSeq21czpcarYh0EVq2WWOzflX-NTK-tY1-1pauPzHKRRLgpABkmYiIV_og9jAvoIxQ8L3Smrwe04Lw',
network: Network.sapphire_devnet,
redirectUrl: redirectUrl,
whiteLabel: WhiteLabelData(
mode: ThemeModes.dark,
appName: "Web3Auth Flutter App",
theme: themeMap,
),
loginConfig: loginConfig,
),
);

// Call initialize() function to get privKey and user information without relogging in user if a user has an active session
await Web3AuthFlutter.initialize();

// call getPrivKey() function to get user private key
final String privKey = await Web3AuthFlutter.getPrivKey();

// call getEd25519PrivKey() function to get user ed25519 private key
final String ed255199PrivKey = await Web3AuthFlutter.getEd25519PrivKey();

// call getUserInfo() function to get user information like name, email, verifier, verifierId etc
final TorusUserInfo userInfo = await Web3AuthFlutter.getUserInfo();
}

// Login
await Web3AuthFlutter.login(
LoginParams(
loginProvider: Provider.jwt,
extraLoginOptions: ExtraLoginOptions(
id_token: "{YOUR_JWT_TOKEN}",
domain: "{YOUR-DOMAIN}",
),
),
);

// Logout
await Web3AuthFlutter.logout();

copied to clipboard
Triggering UserCancellation on Android #
On Android, if you want to trigger exception for user closing the browser tab, you have to use
WidgetsBindingObserver mixin with your your login screen.
class LoginScreen extends State<MyApp> with WidgetsBindingObserver {

@override
void initState() {
super.initState();
WidgetsBinding.instance.addObserver(this);
}
@override
void dispose() {
super.dispose();
WidgetsBinding.instance.removeObserver(this);
}
@override
void didChangeAppLifecycleState(final AppLifecycleState state) {
// This is important to trigger the user cancellation on Android.
if (state == AppLifecycleState.resumed) {
Web3AuthFlutter.setCustomTabsClosed();
}
}

@override
Widget build(BuildContext context) {
// Your UI code
}
Future<void> _login() async {
try {
await Web3AuthFlutter.login(LoginParams(loginProvider: Provider.google));
} on UserCancelledException {
log("User cancelled.");
} on UnKnownException {
log("Unknown exception occurred");
} catch (e) {
log(e.toString());
}
}
}
copied to clipboard
🌐 Demo #
Checkout the Web3Auth Demo to see how Web3Auth can be used in an application.
Have a look at our Web3Auth PnP Flutter Quick Start to help you quickly integrate a basic instance of Web3Auth Plug and Play in your Flutter app.
Further checkout the example folder within this repository, which contains a sample app.
💬 Troubleshooting and Support #

Have a look at our Community Portal to see if anyone has any questions or issues you might be having. Feel free to create new topics and we'll help you out as soon as possible.
Checkout our Troubleshooting Documentation Page to know the common issues and solutions.
For Priority Support, please have a look at our Pricing Page for the plan that suits your needs.