Flutter / Dart Shield SDK

dependencies:
  akedly_shield:
    git:
      url: https://github.com/Akedly-Org/akedly-shield-dart.git
      ref: main

dependencies:
  akedly_shield:
    git:
      url: https://github.com/Akedly-Org/akedly-shield-dart.git
      ref: v1.0.0

flutter pub get

import 'package:flutter/material.dart';
import 'package:akedly_shield/akedly_shield.dart';
import 'dart:convert';
import 'package:http/http.dart' as http;

// Your backend base URL — keeps APIKey and pipelineID server-side.
const backendUrl = 'https://yourapp.com';

class OTPScreen extends StatefulWidget {
  final String phoneNumber;

  const OTPScreen({
    super.key,
    required this.phoneNumber,
  });

  @override
  State<OTPScreen> createState() => _OTPScreenState();
}

class _OTPScreenState extends State<OTPScreen> {
  String? _transactionReqID;
  String _otp = '';
  bool _loading = false;
  String? _error;
  String? _turnstileSiteKey;
  Map<String, dynamic>? _challengeData;

  Future<void> _sendOTP({String? turnstileToken}) async {
    setState(() { _loading = true; _error = null; });
    try {
      // 1. Get challenge from YOUR backend
      final challengeRes = await http.get(
        Uri.parse('$backendUrl/auth/akedly/challenge'),
      );
      final data = jsonDecode(challengeRes.body)['data'];

      // Check if Turnstile is needed and we don't have a token yet
      if (data['turnstile']?['required'] == true && turnstileToken == null) {
        setState(() {
          _challengeData = data;
          _turnstileSiteKey = data['turnstile']['siteKey'];
          _loading = false;
        });
        return; // Wait for Turnstile token via widget callback
      }

      // 2. Solve PoW in background isolate
      final nonce = await solvePowInIsolate(
        data['challenge'] as String,
        data['difficulty'] as int,
      );

      // 3. Send proof via YOUR backend
      final sendRes = await http.post(
        Uri.parse('$backendUrl/auth/akedly/send'),
        headers: {'Content-Type': 'application/json'},
        body: jsonEncode({
          'phoneNumber': widget.phoneNumber,
          'powSolution': {
            'challengeToken': data['challengeToken'],
            'nonce': nonce,
          },
          if (turnstileToken != null) 'turnstileToken': turnstileToken,
        }),
      );
      final result = jsonDecode(sendRes.body);
      setState(() { _transactionReqID = result['data']['transactionReqID']; });
    } catch (e) {
      setState(() { _error = e.toString(); });
    } finally {
      setState(() { _loading = false; });
    }
  }

  Future<void> _verifyOTP() async {
    setState(() { _loading = true; _error = null; });
    try {
      final res = await http.post(
        Uri.parse('$backendUrl/auth/akedly/verify'),
        headers: {'Content-Type': 'application/json'},
        body: jsonEncode({'transactionReqID': _transactionReqID, 'otp': _otp}),
      );
      final result = jsonDecode(res.body);
      if (result['status'] == 'success') {
        if (mounted) Navigator.of(context).pop(true);
      } else {
        setState(() { _error = 'Invalid OTP'; });
      }
    } catch (e) {
      setState(() { _error = e.toString(); });
    } finally {
      setState(() { _loading = false; });
    }
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Verify Phone')),
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: Column(
          crossAxisAlignment: CrossAxisAlignment.stretch,
          children: [
            if (_turnstileSiteKey != null && _transactionReqID == null)
              SizedBox(
                height: 1,
                child: AkedlyTurnstile(
                  siteKey: _turnstileSiteKey!,
                  onToken: (token) => _sendOTP(turnstileToken: token),
                  onError: (err) => setState(() { _error = err; }),
                ),
              ),
            if (_transactionReqID == null) ...[
              Text('Send OTP to ${widget.phoneNumber}'),
              const SizedBox(height: 16),
              ElevatedButton(
                onPressed: _loading ? null : () => _sendOTP(),
                child: Text(_loading ? 'Sending...' : 'Send OTP'),
              ),
            ] else ...[
              TextField(
                onChanged: (v) => setState(() { _otp = v; }),
                decoration: const InputDecoration(labelText: 'Enter OTP'),
                keyboardType: TextInputType.number,
                maxLength: 6,
              ),
              const SizedBox(height: 16),
              ElevatedButton(
                onPressed: _loading || _otp.length < 6 ? null : _verifyOTP,
                child: Text(_loading ? 'Verifying...' : 'Verify'),
              ),
            ],
            if (_error != null)
              Padding(
                padding: const EdgeInsets.only(top: 16),
                child: Text(_error!, style: const TextStyle(color: Colors.red)),
              ),
          ],
        ),
      ),
    );
  }
}