Unified SDK collection for trading Real World Assets across multiple platforms

These details have not been verified by PyPI

Project links

Project description

Swarm Collection - Python SDK Suite

Unified Python SDK collection for trading Real World Assets (RWAs) across multiple platforms with smart routing, automatic fallback, and price optimization.

🌟 Overview

Swarm Collection is a comprehensive Python SDK suite that enables seamless trading of Real World Assets (RWAs) through multiple platforms. The collection provides three distinct SDKs, each optimized for different trading scenarios:

Trading SDK - Unified client with smart routing and automatic price optimization
Market Maker SDK - Decentralized peer-to-peer OTC trading (24/7 availability)
Cross-Chain Access SDK - Centralized stock market trading (market hours only)

All SDKs share common infrastructure including Web3 helpers, authentication, and data models, ensuring consistent behavior and ease of use.

Why Use Swarm Collection?

✅ Smart Routing - Automatically selects optimal trading platform
✅ Best Price Guarantee - Real-time price comparison across platforms
✅ Auto Fallback - Seamless switching if primary platform fails
✅ 24/7 Trading - Access to P2P markets outside traditional hours
✅ Unified API - Consistent interface across all SDKs
✅ Production Ready - Comprehensive error handling and retry logic
✅ Type Safe - Full type hints and mypy validation
✅ Async Native - Built with asyncio for high performance

🏗️ SDK Architecture

The Swarm Collection implements a multi-layer hierarchical architecture:

┌─────────────────────────────────────────────────────────────┐
│                      Trading SDK                            │
│  (Smart routing, price comparison, auto-fallback)           │
└───────────────┬───────────────────────────┬─────────────────┘
                │                           │
      ┌─────────▼──────────┐      ┌────────▼─────────────┐
      │  Market Maker SDK  │      │ Cross-Chain Access   │
      │  (P2P, 24/7)       │      │ SDK (Stock market)   │
      └─────────┬──────────┘      └────────┬─────────────┘
                │                           │
                └────────────┬──────────────┘
                             │
                    ┌────────▼─────────┐
                    │   Shared Module  │
                    │ (Web3, Auth, etc)│
                    └──────────────────┘

Layer Responsibilities

Layer	Purpose	Key Components
Trading SDK	Unified interface with smart routing	`TradingClient`, `Router`, routing strategies
Market Maker SDK	P2P on-chain trading	`RPQClient`, `MarketMakerWeb3Client`, offer management
Cross-Chain Access SDK	Stock market integration	`CrossChainAccessAPIClient`, market hours validation
Shared Module	Common infrastructure	`Web3Helper`, `SwarmAuth`, `BaseClient`, models

🎯 Key Features

Trading SDK (Highest Level)

5 Routing Strategies: BEST_PRICE, CROSS_CHAIN_ACCESS_FIRST, MARKET_MAKER_FIRST, CROSS_CHAIN_ACCESS_ONLY, MARKET_MAKER_ONLY
Automatic Price Comparison: Real-time quote aggregation from both platforms
Smart Fallback: Automatic retry on alternative platform if primary fails
Unified Interface: Single trade() method works across all platforms
Platform-Aware: Handles market hours, liquidity checks, and platform-specific requirements

Market Maker SDK

24/7 Availability: Trade anytime, no market hour restrictions
P2P On-Chain: Fully decentralized execution via smart contracts
Offer Discovery: RPQ API integration for finding available liquidity
Create Offers: Become a liquidity provider with custom pricing
Dynamic Pricing: Support for price feed-based offers
Quote Calculation: Best offer selection with amount optimization

Cross-Chain Access SDK

Stock Market Pricing: Real US stock exchange rates
Deep Liquidity: Traditional market maker liquidity
Market Hours Validation: 14:30-21:00 UTC, weekdays only
Account Management: Funds tracking and status checks
Email Notifications: Trade confirmation emails
KYC Compliant: Regulatory requirements handled

Shared Infrastructure

Web3 Operations: Token approvals, balance checks, transaction signing
Wallet Authentication: EIP-191 signature-based auth (no passwords)
Multi-Network: Polygon, Ethereum, Arbitrum, Base, Optimism support
HTTP Client: Automatic retries with exponential backoff
Error Handling: Comprehensive exception hierarchy
Remote Config: Dynamic configuration loading from remote URLs

🚀 Quick Start

# Install the package
pip install swarm-collection

# Import and use
from swarm.trading_sdk import TradingClient
from swarm.shared.models import Network

For detailed usage examples and code samples, see:

📦 Installation & Setup

Prerequisites

Python 3.8 or higher
pip (Python package manager)
Wallet with private key (for transaction signing)
Gas tokens (MATIC, ETH, etc. for transaction fees)
RPQ API Key (for Market Maker SDK access)
User Email (for Cross-Chain Access authentication)

Method 1: Install from PyPI (Production)

pip install swarm-collection

Method 2: Install from Source (Development)

# Clone the repository
git clone https://github.com/SwarmMarkets/python-swarm-sdks.git
cd python-swarm-sdks

# Install in editable mode
pip install -e .

# Or install with development dependencies
pip install -e ".[dev]"

Environment Configuration

⚠️ Important: The .env file is only required for running the examples, not for using the SDKs in your own projects. When integrating the SDKs into your application, pass credentials directly to the client constructors.

For Running Examples Only

If you want to run the provided examples, create a .env file in the project root:

# Copy the example file
cp .env.example .env

Then configure your environment variables in the .env file:

# Required: Your wallet private key (with 0x prefix)
PRIVATE_KEY=0x1234567890123456789012345678901234567890123456789012345678901234

# Required for Cross-Chain Access SDK and Trading SDK
USER_EMAIL=your@email.com

# Required for Market Maker SDK and Trading SDK
RPQ_API_KEY=your-rpq-api-key-here

# Optional: Environment mode (dev or prod, defaults to prod)
SWARM_COLLECTION_MODE=prod

# Optional: Custom RPC endpoint
# RPC_URL=https://polygon-rpc.com

# Optional: Remote configuration URLs (for dynamic config loading)
# SWARM_CONFIG_PROD_URL=https://your-storage.com/config.prod.json
# SWARM_CONFIG_DEV_URL=https://your-storage.com/config.dev.json

For SDK Integration in Your Projects

When using the SDKs in your own code, pass credentials directly to the client:

from swarm.trading_sdk import TradingClient
from swarm.shared.models import Network

# Pass credentials directly - no .env file needed
async with TradingClient(
    network=Network.POLYGON,
    private_key="0x...",           # Your private key
    rpq_api_key="your_rpq_key",    # Your RPQ API key
    user_email="you@example.com"   # Your email
) as client:
    # Use the client
    pass

⚠️ Security Note: Never commit your .env file or private keys to version control!

📚 SDK Descriptions

1. Trading SDK - Unified Smart Routing

Highest-level interface that intelligently combines both Market Maker and Cross-Chain Access platforms with automatic routing, price comparison, and fallback protection.

Best for: Production applications, traders seeking optimal prices and reliability

Key Features: 5 routing strategies, real-time price comparison, automatic fallback, unified API

📖 User Guide | API Reference

2. Market Maker SDK - Decentralized P2P Trading

Decentralized on-chain trading through smart contract-based offers with 24/7 availability and permissionless access.

Best for: Market makers, liquidity providers, 24/7 trading, DeFi applications

Key Features: P2P execution, create/manage offers, fixed & dynamic pricing, no KYC required

📖 User Guide | API Reference

3. Cross-Chain Access SDK - Stock Market Integration

Centralized stock market trading with real US stock exchange rates and traditional market liquidity.

Best for: Stock trading apps, regulated services, traditional finance integration

Key Features: Stock market pricing, deep liquidity, market hours (14:30-21:00 UTC), KYC compliant

⚠️ Requires: KYC verification at https://dotc.eth.limo/

📖 User Guide | API Reference

📂 Project Structure

python-swarm-sdks/
├── swarm/                          # Main package
│   ├── __init__.py                # Package initialization
│   │
│   ├── trading_sdk/               # Trading SDK (Layer 1)
│   │   ├── sdk/
│   │   │   └── client.py          # TradingClient - unified interface
│   │   ├── routing.py             # Smart routing logic & strategies
│   │   └── exceptions.py          # Trading-specific exceptions
│   │
│   ├── market_maker_sdk/          # Market Maker SDK (Layer 2a)
│   │   ├── sdk/
│   │   │   └── client.py          # MarketMakerClient - main interface
│   │   ├── rpq_service/           # RPQ API integration
│   │   │   ├── client.py          # Offer discovery & quotes
│   │   │   ├── models.py          # Offer data models
│   │   │   └── exceptions.py     # RPQ-specific exceptions
│   │   ├── market_maker_web3/     # On-chain execution
│   │   │   ├── client.py          # Smart contract interactions
│   │   │   ├── constants.py       # Contract addresses & ABIs
│   │   │   └── exceptions.py     # Web3-specific exceptions
│   │   └── __init__.py
│   │
│   ├── cross_chain_access_sdk/    # Cross-Chain Access SDK (Layer 2b)
│   │   ├── sdk/
│   │   │   └── client.py          # CrossChainAccessClient - main interface
│   │   ├── cross_chain_access/    # API integration
│   │   │   ├── client.py          # HTTP API client
│   │   │   ├── models.py          # Quote & order models
│   │   │   └── exceptions.py     # API-specific exceptions
│   │   ├── market_hours/          # Market hours validation
│   │   │   └── market_hours.py   # Trading hours logic
│   │   └── __init__.py
│   │
│   └── shared/                    # Shared infrastructure (Layer 3)
│       ├── base_client.py         # HTTP client with retries
│       ├── swarm_auth.py          # Wallet-based authentication
│       ├── models.py              # Common data models (Network, Quote, etc)
│       ├── constants.py           # Token addresses, RPC URLs
│       ├── config.py              # Environment configuration
│       ├── remote_config.py       # Remote config loader
│       └── web3/
│           ├── helpers.py         # Web3 operations (approvals, txs)
│           ├── constants.py       # Network configs, ABIs
│           └── exceptions.py     # Web3 exceptions
│
├── examples/                      # Usage examples
│   ├── example_trading.py         # Trading SDK demo
│   ├── example_market_maker.py    # Market Maker SDK demo
│   ├── example_cross_chain_access.py  # Cross-Chain Access SDK demo
│   ├── example_error_handling.py  # Error handling patterns
│   └── README.md                  # Examples documentation
│
├── docs/                          # Documentation
│   ├── README.md                  # Documentation index
│   ├── trading_sdk_doc.md         # Trading SDK user guide
│   ├── trading_sdk_api.md         # Trading SDK API reference
│   ├── market_maker_sdk_doc.md    # Market Maker SDK user guide
│   ├── market_maker_sdk_api.md    # Market Maker SDK API reference
│   ├── cross_chain_access_sdk_doc.md     # Cross-Chain Access SDK user guide
│   └── cross_chain_access_sdk_api.md     # Cross-Chain Access SDK API reference
│
├── .github/                       # GitHub configuration
│   ├── workflows/
│   │   └── publish.yaml          # CI/CD pipeline for PyPI publishing
│   └── copilot-instructions.md   # AI assistant instructions
│
├── config.dev.json                # Development environment config
├── config.prod.json               # Production environment config
├── pyproject.toml                 # Project metadata & dependencies
├── Makefile                       # Development commands
├── MANIFEST.in                    # Package manifest
├── LICENSE                        # Apache 2.0 license
├── .env.example                   # Environment variables template
├── .gitignore                     # Git ignore rules
└── README.md                      # This file

Key Directories

Directory	Purpose
`swarm/trading_sdk/`	Smart routing and unified trading interface
`swarm/market_maker_sdk/`	P2P on-chain trading implementation
`swarm/cross_chain_access_sdk/`	Stock market API integration
`swarm/shared/`	Common utilities used by all SDKs
`examples/`	Complete working examples for each SDK
`docs/`	User guides and API references
`.github/workflows/`	CI/CD pipelines and automation

🛠️ Development Setup

Setting Up Virtual Environment

The project uses Python virtual environments for dependency isolation. Follow these steps:

Method 1: Using Makefile (Recommended)

# Setup venv and install package with dev dependencies
make setup

# Activate the virtual environment
source venv/bin/activate  # On macOS/Linux
# or
.\venv\Scripts\activate   # On Windows

# Verify installation
python -c "import swarm; print(swarm.__version__)"

Method 2: Manual Setup

# Create virtual environment
python3 -m venv venv

# Activate virtual environment
source venv/bin/activate  # On macOS/Linux
# or
.\venv\Scripts\activate   # On Windows

# Upgrade pip
pip install --upgrade pip

# Install package in editable mode with dev dependencies
pip install -e ".[dev]"

Development Commands

The project includes a comprehensive Makefile with common development tasks:

# Show all available commands
make help

# Installation
make install         # Install package (production mode)
make install-dev     # Install with dev dependencies

# Code Quality
make format          # Format code with black & isort
make lint            # Run flake8 & mypy
make clean           # Remove build artifacts and cache

# Testing
make test            # Run pytest
make test-cov        # Run tests with coverage report (HTML)

# Building
make build           # Build distribution packages (sdist, wheel)

# Publishing
make upload          # Upload to PyPI (production)
make upload-test     # Upload to TestPyPI (testing)

# Running Examples
make example-trading              # Run Trading SDK example
make example-market-maker         # Run Market Maker SDK example
make example-cross-chain-access   # Run Cross-Chain Access SDK example
make example-errors               # Run error handling example

Code Style & Quality

The project enforces consistent code style:

Black: Code formatting (100 char line length)
isort: Import sorting
flake8: Linting
mypy: Type checking

# Format code before committing
make format

# Check for issues
make lint

Configuration Files

File	Purpose
`pyproject.toml`	Project metadata, dependencies, build config
`.env`	Environment variables (not in git)
`.env.example`	Template for environment variables
`config.dev.json`	Development environment addresses
`config.prod.json`	Production environment addresses

🚀 Deployment & CI/CD

GitHub Actions Workflow

The project uses GitHub Actions for automated publishing to PyPI. The workflow is defined in .github/workflows/publish.yaml.

Workflow Triggers

Branch	Action	Destination
`main`	Push	PyPI (production)
`test`	Push	TestPyPI (testing)

Workflow Steps

Checkout Code - Pull latest code from repository
Setup Python - Install Python 3.11
Install Build Tools - Install build package
Build Package - Create source distribution and wheel
Publish - Upload to PyPI or TestPyPI based on branch

# Simplified workflow structure
on:
  push:
    branches: [main, test]

jobs:
  build-and-publish:
    - Checkout code
    - Setup Python 3.11
    - Install build backend
    - Build package (python -m build)
    - Publish to TestPyPI (if branch = test)
    - Publish to PyPI (if branch = main)

Required GitHub Secrets

Configure these secrets in your GitHub repository settings:

Secret	Purpose
`PYPI_API_TOKEN_PROD`	PyPI API token for production releases
`PYPI_API_TOKEN_TEST`	TestPyPI API token for test releases

To get API tokens:

PyPI: Go to https://pypi.org/manage/account/token/
TestPyPI: Go to https://test.pypi.org/manage/account/token/

Manual Deployment

You can also deploy manually using the Makefile:

# Build distribution packages
make build

# Upload to TestPyPI (testing)
make upload-test

# Upload to PyPI (production)
make upload

# Or use twine directly
pip install twine
python -m build
twine upload dist/*

Version Management

Version is managed in pyproject.toml:

[project]
name = "swarm-collection"
version = "1.0.0b1"  # Update this for new releases

Version Numbering:

1.0.0b1 - Beta release 1
1.0.0 - Stable release
1.1.0 - Minor version (new features)
1.1.1 - Patch version (bug fixes)

Release Checklist

Before creating a new release:

Update version in pyproject.toml
Update CHANGELOG.md (if exists)
Run make test to ensure all tests pass
Run make lint to check code quality
Update documentation if needed
Commit changes: git commit -m "Release vX.Y.Z"
Create git tag: git tag vX.Y.Z
Push to test branch first: git push origin test
Verify TestPyPI deployment
Push to main: git push origin main
Push tags: git push --tags

📖 Documentation

Available Documentation

The project includes comprehensive documentation in the docs/ directory:

SDK User Guides (Beginner-Friendly)

Trading SDK User Guide - Complete guide to smart routing and unified trading
Market Maker SDK User Guide - P2P trading and offer creation
Cross-Chain Access SDK User Guide - Stock market integration

API References (Technical)

Trading SDK API Reference - Detailed method specifications
Market Maker SDK API Reference - RPQ and Web3 client APIs
Cross-Chain Access SDK API Reference - API client specifications

Examples

Examples README - Guide to all code examples

Documentation Structure

Each SDK has two documentation files:

Type	Purpose	Audience
User Guide	Setup, concepts, tutorials, troubleshooting	All users
API Reference	Class methods, parameters, return types, exceptions	Developers

Quick Links

Getting Started: Start with Trading SDK User Guide
Advanced Features: Check individual SDK user guides
Technical Details: Refer to API reference documents
Code Examples: See examples/ directory

💡 Examples

The project includes comprehensive working examples for all SDKs in the examples/ directory.

Running Examples

# Using Makefile (recommended)
make example-trading              # Trading SDK with smart routing
make example-market-maker         # Market Maker P2P trading
make example-cross-chain-access   # Cross-Chain Access stock trading
make example-errors               # Error handling patterns

# Or run directly
python examples/example_trading.py

⚠️ Note: Examples require a .env file with credentials. See Environment Configuration section.

📖 Full documentation: examples/README.md

🧪 Testing

Running Tests

The project uses pytest for testing:

# Run all tests
make test

# Run with coverage report (generates HTML report in htmlcov/)
make test-cov

# Run tests directly with pytest
pytest -v

# Run specific test file
pytest tests/test_routing.py -v

# Run specific test
pytest tests/test_routing.py::test_best_price_strategy -v

Test Configuration

Test configuration is defined in pyproject.toml:

[tool.pytest.ini_options]
minversion = "7.0"
addopts = "-ra -q --strict-markers"
testpaths = ["tests"]
pythonpath = ["."]
asyncio_mode = "auto"

Coverage Reports

After running make test-cov, coverage reports are available:

Terminal: Summary printed to console
HTML: Open htmlcov/index.html in browser for detailed view

# Generate and view coverage report
make test-cov
open htmlcov/index.html  # macOS
xdg-open htmlcov/index.html  # Linux
start htmlcov/index.html  # Windows

Test Structure

tests/
├── test_routing.py           # Trading SDK routing tests
├── test_market_maker.py      # Market Maker SDK tests
├── test_cross_chain_access.py       # Cross-Chain Access SDK tests
├── test_shared.py            # Shared utilities tests
└── conftest.py               # Pytest fixtures

Writing Tests

Tests use pytest-asyncio for async support:

import pytest
from decimal import Decimal

@pytest.mark.asyncio
async def test_trading_client():
    async with TradingClient(...) as client:
        result = await client.get_quote(...)
        assert result.rate > 0

🤝 Contributing

We welcome contributions! Here's how to get started:

Development Workflow

Fork the repository

Clone your fork

git clone https://github.com/YOUR_USERNAME/python-swarm-sdks.git
cd python-swarm-sdks

Set up development environment
```
make setup
source venv/bin/activate
```

Create a feature branch

git checkout -b feature/your-feature-name

Make your changes
- Write code following project style
- Add tests for new features
- Update documentation if needed

Run quality checks

make format  # Format code
make lint    # Check for issues
make test    # Run tests

Commit your changes

git add .
git commit -m "Add: your feature description"

Push and create PR
```
git push origin feature/your-feature-name
```
Then create a Pull Request on GitHub

Code Standards

Python Version: 3.8+
Code Style: Black (100 char line length)
Import Sorting: isort
Linting: flake8
Type Hints: mypy
Testing: pytest with >80% coverage

Commit Message Convention

Use descriptive commit messages:

Add: New feature description
Fix: Bug fix description
Update: Changes to existing features
Docs: Documentation updates
Test: Test additions or modifications
Refactor: Code refactoring
Style: Code style changes

Areas for Contribution

🐛 Bug Fixes - Fix issues reported in GitHub Issues
✨ New Features - Add new functionality to SDKs
📚 Documentation - Improve guides and API docs
🧪 Tests - Increase test coverage
🎨 Examples - Add more usage examples
🔧 Tooling - Improve development workflow

Before Submitting PR

Code follows project style (run make format)
All tests pass (run make test)
New tests added for new features
Documentation updated if needed
No linting errors (run make lint)
Commit messages are clear and descriptive

🌐 Supported Networks

All SDKs support the following networks:

Network	Chain ID
Ethereum	1
Polygon	137
Base	8453
BSC	56

Network Configuration

Networks are defined in swarm/shared/models.py:

from swarm.shared.models import Network

Network.ETHEREUM   # 1
Network.POLYGON    # 137
Network.BASE       # 8453
Network.BSC        # 56

RPC endpoints are configured in swarm/shared/web3/constants.py and can be overridden with the rpc_url parameter when initializing clients.

🔐 Security

Best Practices

✅ Never commit private keys - use environment variables
✅ Verify token addresses before trading
✅ Test with small amounts first
✅ Use context managers for proper cleanup

Reporting Security Issues

Email: developers@swarm.com (do NOT create public GitHub issues for vulnerabilities)

⚠️ Important Caveats

Decimal Usage (CRITICAL)

✅ Always use Decimal for token amounts - never floats
❌ Floats cause precision loss: Use Decimal("100") not 100.0
✅ SDKs handle wei conversion automatically

Async Context Managers Required

All SDK clients must be used with async context managers:

async with TradingClient(...) as client:
    # Use client here
    pass  # Automatic cleanup on exit

Platform-Specific Requirements

Market Maker: Requires RPQ API key for offer discovery
Cross-Chain Access: Requires KYC verification + operates only during market hours (14:30-21:00 UTC, weekdays)
Trading SDK: Benefits from both credentials but can work with just one platform

Security Warnings

🔐 Never commit private keys or .env files to version control
🔐 Always verify token addresses before trading
🔐 Test with small amounts first
🔐 Private keys are used locally only - never sent to servers

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

Copyright 2025 Swarm

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

🔗 Links & Resources

GitHub: https://github.com/SwarmMarkets/python-swarm-sdks
PyPI: https://pypi.org/project/swarm-collection/
Documentation: docs/README.md
Swarm Website: https://swarm.com

💬 Support

📚 Documentation: docs/README.md
💡 Examples: examples/
🐛 Issues: GitHub Issues
📧 Email: developers@swarm.com

🎉 Acknowledgments

Built by the Swarm Markets team using Web3.py, httpx, and pytest.

Made with ❤️ by Swarm Markets

Last Updated: November 20, 2025

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

1.0.0b4 pre-release

Nov 23, 2025

1.0.0b3 pre-release

Nov 21, 2025

This version

1.0.0b2 pre-release

Nov 21, 2025

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

swarm_collection-1.0.0b2.tar.gz (84.2 kB view details)

Uploaded Nov 21, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

swarm_collection-1.0.0b2-py3-none-any.whl (73.8 kB view details)

Uploaded Nov 21, 2025 Python 3

File details

Details for the file swarm_collection-1.0.0b2.tar.gz.

File metadata

Download URL: swarm_collection-1.0.0b2.tar.gz
Upload date: Nov 21, 2025
Size: 84.2 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for swarm_collection-1.0.0b2.tar.gz
Algorithm	Hash digest
SHA256	`d2a1f96c108389b245a5951276c59d6607898b3591b47eaaa4cd398a6ffc2cfd`
MD5	`315d71f713725bdaec50518244167a71`
BLAKE2b-256	`f8ce25b6eeea4e3a927285dac3aa7a2b1e9597f1348a9c3f2874c6e726274233`

See more details on using hashes here.

File details

Details for the file swarm_collection-1.0.0b2-py3-none-any.whl.

File metadata

Download URL: swarm_collection-1.0.0b2-py3-none-any.whl
Upload date: Nov 21, 2025
Size: 73.8 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for swarm_collection-1.0.0b2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`c4bfdc58669eda01b86c76b6314c7caf6a02516176ae86e739b7d311531e3302`
MD5	`c80838a8a54338d5d18d2163f70a5c64`
BLAKE2b-256	`11bbce957fa06423e9cd1be22d630b15798dfbcef78138551da185f9c35c1044`

See more details on using hashes here.

swarm-collection 1.0.0b2

Navigation

Verified details

Maintainers

Unverified details

Project links

Meta

Classifiers

Project description

Swarm Collection - Python SDK Suite

📋 Table of Contents

🌟 Overview

Why Use Swarm Collection?

🏗️ SDK Architecture

Layer Responsibilities

🎯 Key Features

Trading SDK (Highest Level)

Market Maker SDK

Cross-Chain Access SDK

Shared Infrastructure

🚀 Quick Start

📦 Installation & Setup

Prerequisites

Method 1: Install from PyPI (Production)

Method 2: Install from Source (Development)

Environment Configuration

For Running Examples Only

For SDK Integration in Your Projects

📚 SDK Descriptions

1. Trading SDK - Unified Smart Routing

2. Market Maker SDK - Decentralized P2P Trading

3. Cross-Chain Access SDK - Stock Market Integration

📂 Project Structure

Key Directories

🛠️ Development Setup

Setting Up Virtual Environment

Method 1: Using Makefile (Recommended)

Method 2: Manual Setup

Development Commands

Code Style & Quality

Configuration Files

🚀 Deployment & CI/CD

GitHub Actions Workflow

Workflow Triggers

Workflow Steps

Required GitHub Secrets

Manual Deployment

Version Management

Release Checklist

📖 Documentation

Available Documentation

SDK User Guides (Beginner-Friendly)

API References (Technical)

Examples

Documentation Structure

Quick Links

💡 Examples

Running Examples

🧪 Testing

Running Tests

Test Configuration

Coverage Reports

Test Structure

Writing Tests

🤝 Contributing

Development Workflow

Code Standards

Commit Message Convention

Areas for Contribution

Before Submitting PR

🌐 Supported Networks

Network Configuration

🔐 Security

Best Practices

Reporting Security Issues

⚠️ Important Caveats

Decimal Usage (CRITICAL)

Async Context Managers Required

Platform-Specific Requirements

Security Warnings