Implement comprehensive Flutter SDK for svm-pay

Co-authored-by: 0xrinegade <[email protected]>

Author: Copilot

README.md

@@ -17,6 +17,7 @@ SVM-Pay is a payment solution for SVM networks (Solana, Sonic SVM, Eclipse, s00n
 - **C++ SDK**: Native C++ SDK for high-performance applications and system integration
 - **Assembly-BPF SDK**: Low-level BPF program development with Assembly and LLVM IR abstractions
 - **Mobile Support**: iOS and Android SDK for mobile applications
+- **Flutter SDK**: Cross-platform mobile development with Flutter
 - **No Fees**: SVM-Pay itself charges no fees (only standard network transaction fees apply)
 - **Secure**: Built with security best practices for blockchain payments
 - **Flexible**: Support for different payment scenarios (e-commerce, point-of-sale, subscriptions)
@@ -29,6 +30,7 @@ SVM-Pay is a payment solution for SVM networks (Solana, Sonic SVM, Eclipse, s00n
 - [Architecture](docs/architecture.md)
 - [Security Recommendations](docs/security-recommendations.md)
 - [C++ SDK](cpp-sdk/README.md)
+- [Flutter SDK](flutter_sdk/README.md)
 - [Examples](examples/)
 - [CLI Integration](CLI-INTEGRATION.md)
 
@@ -232,6 +234,52 @@ std::string ref = client.generate_reference();
 
 See [C++ SDK Documentation](cpp-sdk/README.md) for detailed installation and usage instructions.
 
+## Flutter SDK
+
+SVM-Pay includes a comprehensive Flutter SDK for cross-platform mobile development:
+
+```dart
+import 'package:svm_pay/svm_pay.dart';
+
+// Initialize SDK
+final svmPay = SVMPay(
+  config: const SVMPayConfig(
+    defaultNetwork: SVMNetwork.solana,
+    debug: true,
+  ),
+);
+
+// Create payment URL
+final url = svmPay.createTransferUrl(
+  'recipient_address',
+  '1.5',
+  label: 'Coffee Shop',
+  message: 'Payment for coffee',
+);
+
+// Use payment widgets
+PaymentButton(
+  recipient: 'recipient_address',
+  amount: '1.0',
+  label: 'Pay 1.0 SOL',
+  onPayment: (result) async {
+    if (result.status == PaymentStatus.confirmed) {
+      print('Payment successful!');
+    }
+  },
+)
+```
+
+**Features:**
+- Cross-platform support (iOS & Android)
+- Pre-built payment widgets (buttons, forms, QR codes)
+- Type-safe Dart API with comprehensive error handling
+- Platform channels for native performance
+- Support for all SVM networks
+- Payment URL generation and parsing
+
+See [Flutter SDK Documentation](flutter_sdk/README.md) for detailed installation and usage instructions.
+
 ## Demo Applications
 
 SVM-Pay includes several demo applications to showcase its functionality:

flutter_sdk/.gitignore

@@ -0,0 +1,33 @@
+# Miscellaneous
+*.class
+*.log
+*.pyc
+*.swp
+.DS_Store
+.atom/
+.build/
+.buildlog/
+.history
+.svn/
+.swiftpm/
+migrate_working_dir/
+
+# IntelliJ related
+*.iml
+*.ipr
+*.iws
+.idea/
+
+# The .vscode folder contains launch configuration and tasks you configure in
+# VS Code which you may wish to be included in version control, so this line
+# is commented out by default.
+#.vscode/
+
+# Flutter/Dart/Pub related
+# Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock.
+/pubspec.lock
+**/doc/api/
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+build/

flutter_sdk/.metadata

@@ -0,0 +1,33 @@
+# This file tracks properties of this Flutter project.
+# Used by Flutter tool to assess capabilities and perform upgrades etc.
+#
+# This file should be version controlled and should not be manually edited.
+
+version:
+  revision: "edada7c56edf4a183c1735310e123c7f923584f1"
+  channel: "stable"
+
+project_type: plugin
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: edada7c56edf4a183c1735310e123c7f923584f1
+      base_revision: edada7c56edf4a183c1735310e123c7f923584f1
+    - platform: android
+      create_revision: edada7c56edf4a183c1735310e123c7f923584f1
+      base_revision: edada7c56edf4a183c1735310e123c7f923584f1
+    - platform: ios
+      create_revision: edada7c56edf4a183c1735310e123c7f923584f1
+      base_revision: edada7c56edf4a183c1735310e123c7f923584f1
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'

flutter_sdk/CHANGELOG.md

@@ -0,0 +1,3 @@
+## 0.0.1
+
+* TODO: Describe initial release.

flutter_sdk/LICENSE

@@ -0,0 +1 @@
+TODO: Add your license here.