Merge pull request #20 from openSVM/copilot/fix-19

Implement comprehensive C++ SDK for SVM-Pay

Author: 0xrinegade

README.md

@@ -14,6 +14,7 @@ SVM-Pay is a payment solution for SVM networks (Solana, Sonic SVM, Eclipse, s00n
 - **Cross-Network Compatibility**: Support for Solana, Sonic SVM, Eclipse, and s00n networks
 - **Simple Integration**: One-click integration for developers
 - **Comprehensive SDK**: JavaScript/TypeScript SDK with React, Vue, and Angular components
+- **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
 - **No Fees**: SVM-Pay itself charges no fees (only standard network transaction fees apply)
@@ -27,6 +28,7 @@ SVM-Pay is a payment solution for SVM networks (Solana, Sonic SVM, Eclipse, s00n
 - [Assembly-BPF SDK](docs/assembly-bpf/README.md)
 - [Architecture](docs/architecture.md)
 - [Security Recommendations](docs/security-recommendations.md)
+- [C++ SDK](cpp-sdk/README.md)
 - [Examples](examples/)
 - [CLI Integration](CLI-INTEGRATION.md)
 
@@ -194,6 +196,42 @@ export class AppComponent {
 }
 ```
 
+## C++ SDK
+
+SVM-Pay includes a comprehensive C++ SDK for high-performance applications and system integration:
+
+```cpp
+#include <svm-pay/svm_pay.hpp>
+
+// Initialize SDK
+svm_pay::initialize_sdk();
+
+// Create client
+svm_pay::Client client(svm_pay::SVMNetwork::SOLANA);
+
+// Create payment URL
+std::string url = client.create_transfer_url("recipient_address", "1.5", {
+    {"label", "Coffee Shop"},
+    {"message", "Payment for coffee"}
+});
+
+// Parse payment URL
+auto request = client.parse_url(url);
+
+// Generate reference ID
+std::string ref = client.generate_reference();
+```
+
+**Features:**
+- Cross-platform support (Windows, Linux, macOS)
+- Asynchronous network operations  
+- Secure reference generation with OpenSSL
+- Complete URL scheme support
+- CMake build system with package management
+- Comprehensive test suite and examples
+
+See [C++ SDK Documentation](cpp-sdk/README.md) for detailed installation and usage instructions.
+
 ## Demo Applications
 
 SVM-Pay includes several demo applications to showcase its functionality:

cpp-sdk/.gitignore

@@ -0,0 +1,74 @@
+# Build directories
+build/
+build-*/
+out/
+
+# CMake generated files
+CMakeCache.txt
+CMakeFiles/
+cmake_install.cmake
+Makefile
+*.cmake
+
+# Compiled Object files
+*.o
+*.obj
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+
+# Compiled Static libraries
+*.a
+*.lib
+
+# Executables
+*.exe
+*.out
+*.app
+
+# Debug files
+*.dSYM/
+*.pdb
+
+# IDE files
+.vscode/
+.idea/
+*.user
+*.pro.user*
+
+# Temporary files
+*~
+*.swp
+*.swo
+.DS_Store
+Thumbs.db
+
+# Testing
+CTestTestfile.cmake
+Testing/
+
+# Package files
+*.tar.gz
+*.zip
+*.deb
+*.rpm
+
+# Documentation build
+docs/_build/
+docs/html/
+docs/latex/
+
+# Coverage files
+*.gcno
+*.gcov
+*.gcda
+coverage.info
+coverage/
+
+# Static analysis
+cppcheck-build-dir/
+
+# Clang tools
+compile_commands.json

cpp-sdk/BUILD.md

@@ -0,0 +1,73 @@
+# SVM-Pay C++ SDK Build Instructions
+
+This directory contains a comprehensive C++ SDK for SVM-Pay, providing payment solutions for SVM networks.
+
+## Quick Build
+
+### Using System Dependencies (Linux/macOS)
+
+```bash
+# Install dependencies
+sudo apt-get install libcurl4-openssl-dev libssl-dev libgtest-dev  # Ubuntu/Debian
+brew install curl openssl googletest  # macOS
+
+# Build
+mkdir build && cd build
+cmake ..
+make -j4
+
+# Run examples
+./examples/basic_payment
+./examples/url_parsing
+```
+
+### Using vcpkg (Windows/Cross-platform)
+
+```bash
+# Install vcpkg if not already installed
+git clone https://github.com/Microsoft/vcpkg.git
+cd vcpkg && ./bootstrap-vcpkg.sh
+
+# Build with vcpkg
+mkdir build && cd build
+cmake .. -DCMAKE_TOOLCHAIN_FILE=/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake
+make -j4
+```
+
+## Features Included
+
+✅ **Complete URL Scheme Support** - Parse and create payment URLs for all SVM networks  
+✅ **Secure Reference Generation** - Cryptographically secure reference IDs using OpenSSL  
+✅ **Multi-Network Support** - Solana, Sonic, Eclipse, and s00n networks  
+✅ **Async Network Operations** - Future-based asynchronous network adapter interface  
+✅ **Type Safety** - Modern C++17 with strong typing  
+✅ **Cross-Platform** - CMake build system supporting Windows, Linux, and macOS  
+✅ **Well Tested** - Comprehensive unit tests included  
+✅ **Examples** - Multiple working examples demonstrating all features  
+✅ **Documentation** - Complete API reference and usage guide  
+
+## API Overview
+
+```cpp
+#include <svm-pay/svm_pay.hpp>
+
+// Initialize SDK
+svm_pay::initialize_sdk();
+
+// Create client  
+svm_pay::Client client(svm_pay::SVMNetwork::SOLANA);
+
+// Create payment URL
+std::string url = client.create_transfer_url("recipient_address", "1.5", {
+    {"label", "Coffee Shop"},
+    {"message", "Payment for coffee"}
+});
+
+// Parse payment URL
+auto request = client.parse_url(url);
+
+// Generate reference ID
+std::string ref = client.generate_reference();
+```
+
+See the full [README.md](README.md) for complete documentation and examples.

cpp-sdk/CMakeLists.txt

@@ -0,0 +1,122 @@
+cmake_minimum_required(VERSION 3.16)
+project(svm-pay-cpp VERSION 1.0.0 LANGUAGES CXX)
+
+# Set C++ standard
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+
+# Set build type if not specified
+if(NOT CMAKE_BUILD_TYPE)
+    set(CMAKE_BUILD_TYPE Release)
+endif()
+
+# Compiler-specific options
+if(MSVC)
+    add_compile_options(/W4)
+else()
+    add_compile_options(-Wall -Wextra -Wpedantic)
+endif()
+
+# Find required packages
+find_package(CURL REQUIRED)
+find_package(OpenSSL REQUIRED)
+
+# Option to build tests
+option(BUILD_TESTS "Build test suite" ON)
+
+# Option to build examples
+option(BUILD_EXAMPLES "Build examples" ON)
+
+# Include directories
+include_directories(include)
+
+# Source files
+set(SOURCES
+    src/core/types.cpp
+    src/core/url_scheme.cpp
+    src/core/reference.cpp
+    src/network/adapter.cpp
+    src/network/solana.cpp
+    src/network/curl_initializer.cpp
+    src/client.cpp
+    src/svm_pay.cpp
+)
+
+# Header files for installation
+set(HEADERS
+    include/svm-pay/svm_pay.hpp
+    include/svm-pay/client.hpp
+    include/svm-pay/core/types.hpp
+    include/svm-pay/core/url_scheme.hpp
+    include/svm-pay/core/reference.hpp
+    include/svm-pay/core/exceptions.hpp
+    include/svm-pay/network/adapter.hpp
+    include/svm-pay/network/solana.hpp
+    include/svm-pay/network/curl_initializer.hpp
+)
+
+# Create library
+add_library(svm-pay ${SOURCES})
+
+# Link libraries
+target_link_libraries(svm-pay 
+    CURL::libcurl 
+    OpenSSL::SSL 
+    OpenSSL::Crypto
+)
+
+# Set library properties
+set_target_properties(svm-pay PROPERTIES
+    VERSION ${PROJECT_VERSION}
+    SOVERSION 1
+)
+
+# Install targets
+install(TARGETS svm-pay
+    EXPORT svm-pay-targets
+    LIBRARY DESTINATION lib
+    ARCHIVE DESTINATION lib
+    RUNTIME DESTINATION bin
+)
+
+install(DIRECTORY include/svm-pay 
+    DESTINATION include
+)
+
+# Export targets
+install(EXPORT svm-pay-targets
+    FILE svm-pay-targets.cmake
+    DESTINATION lib/cmake/svm-pay
+)
+
+# Build tests if enabled
+if(BUILD_TESTS)
+    enable_testing()
+    add_subdirectory(tests)
+endif()
+
+# Build examples if enabled
+if(BUILD_EXAMPLES)
+    add_subdirectory(examples)
+endif()
+
+# Package configuration
+include(CMakePackageConfigHelpers)
+
+configure_package_config_file(
+    cmake/svm-pay-config.cmake.in
+    "${CMAKE_CURRENT_BINARY_DIR}/svm-pay-config.cmake"
+    INSTALL_DESTINATION lib/cmake/svm-pay
+)
+
+write_basic_package_version_file(
+    "${CMAKE_CURRENT_BINARY_DIR}/svm-pay-config-version.cmake"
+    VERSION ${PROJECT_VERSION}
+    COMPATIBILITY SameMajorVersion
+)
+
+install(FILES
+    "${CMAKE_CURRENT_BINARY_DIR}/svm-pay-config.cmake"
+    "${CMAKE_CURRENT_BINARY_DIR}/svm-pay-config-version.cmake"
+    DESTINATION lib/cmake/svm-pay
+)