Add comprehensive C++ SDK docs and tutorials to website with examples

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

Author: Copilot

examples/README.md

@@ -0,0 +1,145 @@
+# SVM-Pay Examples
+
+This directory contains comprehensive examples demonstrating SVM-Pay integration across different languages, frameworks, and use cases.
+
+## Examples by Language/Platform
+
+### JavaScript/TypeScript Examples
+
+- **[web-payment-demo.jsx](./web-payment-demo.jsx)** - Basic web payment integration with React
+- **[point-of-sale-demo.tsx](./point-of-sale-demo.tsx)** - Point-of-sale terminal implementation
+- **[subscription-payment-demo.tsx](./subscription-payment-demo.tsx)** - Subscription payment processing
+- **[cross-chain-payment-demo.html](./cross-chain-payment-demo.html)** - Cross-chain payment flows
+- **[wallet-connect-demo.html](./wallet-connect-demo.html)** - WalletConnect integration
+- **[wallet-connect-test.tsx](./wallet-connect-test.tsx)** - WalletConnect testing utilities
+
+### C++ SDK Examples
+
+- **[cpp-examples/](./cpp-examples/)** - Complete C++ SDK examples
+  - **[basic-payment/](./cpp-examples/basic-payment/)** - Simple payment URL creation and processing
+  - **[url-parsing/](./cpp-examples/url-parsing/)** - URL parsing and validation examples
+  - **[network-adapters/](./cpp-examples/network-adapters/)** - Working with different network adapters
+
+### Assembly-BPF Examples
+
+- **[assembly-bpf/](./assembly-bpf/)** - Low-level BPF program examples
+  - Payment processor programs
+  - Cross-chain bridge implementations
+  - Custom middleware and validation programs
+
+### Integration Examples
+
+- **[n8n-integration/](./n8n-integration/)** - Workflow automation with n8n
+  - Payment workflow nodes
+  - Automated payment processing
+  - Integration templates
+
+## Getting Started
+
+### Prerequisites
+
+**For JavaScript/TypeScript examples:**
+```bash
+npm install svm-pay
+```
+
+**For C++ examples:**
+```bash
+# Install dependencies (Ubuntu/Debian)
+sudo apt-get install build-essential cmake libcurl4-openssl-dev libssl-dev
+
+# Build and install C++ SDK
+cd ../cpp-sdk
+mkdir build && cd build
+cmake ..
+make install
+```
+
+**For Assembly-BPF examples:**
+```bash
+npm install svm-pay
+# Assembly-BPF SDK is included with the main package
+```
+
+### Running Examples
+
+**Web examples:**
+Most HTML examples can be opened directly in a browser or served with a local HTTP server:
+```bash
+# Using Python
+python -m http.server 8000
+
+# Using Node.js
+npx serve .
+```
+
+**React/TypeScript examples:**
+```bash
+# Copy example code into your React project
+# Or use the examples as templates for new components
+```
+
+**C++ examples:**
+```bash
+cd cpp-examples
+mkdir build && cd build
+cmake ..
+make
+
+# Run individual examples
+./basic-payment/basic_payment
+./url-parsing/url_parsing
+./network-adapters/network_adapter
+```
+
+## Example Categories
+
+### Basic Payment Processing
+- Simple transfers
+- SPL token payments
+- Payment URL creation and parsing
+- Transaction validation
+
+### Advanced Features
+- Cross-chain payments
+- Network adapter usage
+- Asynchronous operations
+- Error handling patterns
+
+### Real-World Applications
+- E-commerce integration
+- Point-of-sale systems
+- Subscription billing
+- Multi-network support
+
+### Integration Patterns
+- React components
+- Vue.js integration
+- Angular services
+- Server-side processing
+- Mobile applications
+
+## Documentation
+
+For detailed documentation and tutorials:
+- [Main Documentation](../docs/)
+- [C++ SDK Documentation](../cpp-sdk/README.md)
+- [Assembly-BPF SDK](../docs/assembly-bpf/)
+- [Developer Guide](../docs/developer-guide.md)
+
+## Contributing
+
+To contribute new examples:
+1. Follow the existing example structure
+2. Include comprehensive README files
+3. Add appropriate comments and documentation
+4. Test across different environments
+5. Submit a pull request
+
+## Support
+
+For questions about examples or integration:
+- Check the [documentation](../docs/)
+- Review existing examples for patterns
+- Open an issue for specific problems
+- Join our community discussions

examples/cpp-examples/CMakeLists.txt

@@ -0,0 +1,21 @@
+cmake_minimum_required(VERSION 3.16)
+
+# Example sources
+set(EXAMPLE_SOURCES
+    basic_payment.cpp
+    url_parsing.cpp
+    network_adapter.cpp
+)
+
+# Create example executables
+foreach(EXAMPLE_SOURCE ${EXAMPLE_SOURCES})
+    get_filename_component(EXAMPLE_NAME ${EXAMPLE_SOURCE} NAME_WE)
+    add_executable(${EXAMPLE_NAME} ${EXAMPLE_SOURCE})
+    target_link_libraries(${EXAMPLE_NAME} svm-pay)
+    set(EXAMPLE_TARGETS ${EXAMPLE_TARGETS} ${EXAMPLE_NAME})
+endforeach()
+
+# Install examples
+install(TARGETS ${EXAMPLE_TARGETS}
+    DESTINATION bin/examples
+)

examples/cpp-examples/README.md

@@ -0,0 +1,40 @@
+# C++ SDK Examples
+
+This directory contains C++ examples demonstrating SVM-Pay integration.
+
+## Examples
+
+- **basic-payment/** - Simple payment URL creation and processing
+- **url-parsing/** - URL parsing and validation examples  
+- **network-adapters/** - Working with different network adapters
+- **async-operations/** - Asynchronous network operations
+- **cross-platform/** - Cross-platform development examples
+
+## Building Examples
+
+All examples can be built using CMake:
+
+```bash
+cd cpp-examples
+mkdir build && cd build
+cmake ..
+make
+
+# Run examples
+./basic-payment/basic_payment
+./url-parsing/url_parsing  
+./network-adapters/network_adapter
+```
+
+## Prerequisites
+
+- C++17 compatible compiler
+- CMake 3.16 or higher
+- SVM-Pay C++ SDK installed
+- cURL and OpenSSL libraries
+
+## Integration
+
+To use these examples in your own projects, copy the relevant code and ensure you have the SVM-Pay C++ SDK properly installed and linked.
+
+For more information, see the [C++ SDK documentation](/docs/cpp-sdk) and [tutorials](/tutorials/cpp-sdk).

examples/cpp-examples/basic-payment/README.md

@@ -0,0 +1,32 @@
+# Basic Payment Example
+
+This example demonstrates how to create simple payment URLs and process basic transactions using the SVM-Pay C++ SDK.
+
+## Features Demonstrated
+
+- SDK initialization
+- Creating transfer URLs with metadata (label, message, memo)
+- Generating secure reference IDs
+- Basic error handling
+
+## Building
+
+```bash
+cd basic-payment
+g++ -std=c++17 basic_payment.cpp -lsvm-pay -lcurl -lssl -lcrypto -o basic_payment
+./basic_payment
+```
+
+## Code Overview
+
+The example shows:
+1. Initializing the SVM-Pay SDK
+2. Creating a client for Solana network
+3. Creating a payment URL with recipient, amount, and metadata
+4. Generating a reference ID for transaction tracking
+5. Parsing and displaying the created URL
+
+## Next Steps
+
+- Try the [URL Parsing Example](../url-parsing/) to learn about parsing payment URLs
+- See the [Network Adapters Example](../network-adapters/) for working with different blockchains

examples/cpp-examples/basic-payment/basic_payment.cpp

@@ -0,0 +1,106 @@
+#include <iostream>
+#include <svm-pay/svm_pay.hpp>
+
+using namespace svm_pay;
+
+int main() {
+    std::cout << "SVM-Pay C++ SDK - Basic Payment Example\n";
+    std::cout << "========================================\n\n";
+    
+    try {
+        // Initialize the SDK
+        initialize_sdk();
+        
+        // Create a client
+        Client client(SVMNetwork::SOLANA);
+        
+        std::cout << "1. Creating a transfer URL...\n";
+        
+        // Create a simple transfer URL
+        std::string recipient = "7v91N7iZ9eyTktBwWC2ckrjdLhvmS4R1HqvYZzG5FGvn";
+        std::string amount = "1.5";
+        
+        std::unordered_map<std::string, std::string> options = {
+            {"label", "Coffee Shop"},
+            {"message", "Payment for coffee and pastry"},
+            {"memo", "Order #12345"}
+        };
+        
+        std::string payment_url = client.create_transfer_url(recipient, amount, options);
+        std::cout << "   Payment URL: " << payment_url << "\n\n";
+        
+        std::cout << "2. Parsing the payment URL...\n";
+        
+        // Parse the URL back
+        auto request = client.parse_url(payment_url);
+        
+        std::cout << "   Request type: " << request_type_to_string(request->type) << "\n";
+        std::cout << "   Network: " << network_to_string(request->network) << "\n";
+        std::cout << "   Recipient: " << request->recipient << "\n";
+        
+        if (request->label.has_value()) {
+            std::cout << "   Label: " << request->label.value() << "\n";
+        }
+        
+        if (request->message.has_value()) {
+            std::cout << "   Message: " << request->message.value() << "\n";
+        }
+        
+        if (request->memo.has_value()) {
+            std::cout << "   Memo: " << request->memo.value() << "\n";
+        }
+        
+        // Cast to TransferRequest to access amount
+        if (request->type == RequestType::TRANSFER) {
+            auto transfer_request = dynamic_cast<TransferRequest*>(request.get());
+            if (transfer_request) {
+                std::cout << "   Amount: " << transfer_request->amount << "\n";
+            }
+        }
+        
+        std::cout << "\n3. Generating reference IDs...\n";
+        
+        // Generate reference IDs
+        for (int i = 0; i < 3; ++i) {
+            std::string ref = client.generate_reference();
+            std::cout << "   Reference " << (i + 1) << ": " << ref << "\n";
+        }
+        
+        std::cout << "\n4. Creating a transaction URL...\n";
+        
+        // Create a transaction URL
+        std::string transaction_link = "https://api.example.com/transaction";
+        std::unordered_map<std::string, std::string> tx_options = {
+            {"label", "NFT Marketplace"},
+            {"message", "Purchase NFT #42"}
+        };
+        
+        std::string transaction_url = client.create_transaction_url(recipient, transaction_link, tx_options);
+        std::cout << "   Transaction URL: " << transaction_url << "\n\n";
+        
+        std::cout << "5. Working with different networks...\n";
+        
+        // Create URLs for different networks
+        std::vector<SVMNetwork> networks = {SVMNetwork::SOLANA, SVMNetwork::SONIC, SVMNetwork::ECLIPSE, SVMNetwork::SOON};
+        
+        for (auto network : networks) {
+            std::unordered_map<std::string, std::string> net_options = {
+                {"network", network_to_string(network)}
+            };
+            
+            std::string url = client.create_transfer_url(recipient, "2.0", net_options);
+            std::cout << "   " << network_to_string(network) << ": " << url << "\n";
+        }
+        
+        std::cout << "\nExample completed successfully!\n";
+        
+        // Cleanup
+        cleanup_sdk();
+        
+    } catch (const std::exception& e) {
+        std::cerr << "Error: " << e.what() << std::endl;
+        return 1;
+    }
+    
+    return 0;
+}