mirror of https://github.com/luxfi/consensus.git synced 2026-09-24 00:26:58 +00:00

Files

T

zeekay b870c3a0b9 fix: remove incomplete code and add working examples

- Remove ai/integration.go.wip (incomplete, undefined types)
- Remove examples/ai-marketplace (incomplete, build failures)
- Remove examples/03-qzmq-networking (undefined types)
- Add working examples: simple-bridge, ai-payment, python-client
- Fix test/integration: remove unused import

All tests passing ✅

2025-11-06 10:40:59 -08:00

2.3 KiB

Raw Permalink Blame History

Example 05: Python Client for Lux Bridge

This example demonstrates using the Lux bridge from Python via gRPC.

What It Shows

Python client connecting to Go bridge service
Initiating cross-chain transfers from Python
Monitoring transfer status
Error handling and retries

Setup

cd examples/05-python-client

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Run the Bridge Service

First, start the Go bridge gRPC server:

# In terminal 1
cd examples/05-python-client
go run server/main.go

Run the Python Client

# In terminal 2  
python client.py

Run the Tests

pytest test_client.py -v

Expected Output

=== Python Bridge Client ===

Connecting to bridge service at localhost:50051...
✓ Connected successfully

Initiating transfer:
  Amount: 1.5 ETH
  From:   ethereum
  To:     lux

✓ Transfer initiated: tx_abc123...
✓ Monitoring status...

[Pending] 0/6 confirmations
[Validating] 3/6 confirmations
[Confirmed] 6/6 confirmations
✓ Transfer completed!

Transfer Details:
  ID:        tx_abc123...
  Amount:    1.5 ETH
  Status:    COMPLETED
  Duration:  3.2s

Files

client.py - Python client demonstrating bridge usage
test_client.py - Pytest tests
server/main.go - Go gRPC server wrapping the bridge
proto/bridge.proto - Protocol buffer definitions
requirements.txt - Python dependencies

Key Concepts

This demonstrates:

Language Interoperability: Go backend, Python frontend
gRPC Communication: Efficient cross-language RPC
Async Python: Using asyncio for concurrent operations
Error Handling: Retries and timeouts

Integration Pattern

# 1. Create client
client = BridgeClient("localhost:50051")

# 2. Connect
await client.connect()

# 3. Initiate transfer
transfer_id = await client.transfer(
    asset="ETH",
    amount="1500000000000000000",
    source_chain="ethereum",
    dest_chain="lux",
)

# 4. Monitor status
status = await client.get_status(transfer_id)

Play With It

Try modifying:

Transfer amounts and chains
Add more Python features
Implement wallet integration
Add transaction history

2.3 KiB Raw Permalink Blame History