sardis-chain
Production-grade multi-chain stablecoin executor for Sardis.
Overview
sardis-chain provides the blockchain execution layer for stablecoin operations:
- Multi-Chain Support: Ethereum, Base, Polygon, Arbitrum, and more
- MPC Custody: Integration with Turnkey and Fireblocks
- Transaction Execution: Gas estimation, nonce management, confirmation tracking
- Cross-Chain Routing: CCIP and Wormhole integration
- MEV Protection: Flashbots and private mempool support
- Deposit Monitoring: Real-time deposit detection and processing
Installation
pip install sardis-chain
Development Installation
pip install sardis-chain[dev]
Quick Start
from sardis_chain import (
ChainExecutor,
WalletManager,
NonceManager,
ConfirmationTracker,
)
# Initialize the executor
executor = ChainExecutor(
chain="base",
rpc_url="https://mainnet.base.org",
mpc_provider="turnkey",
)
# Execute a stablecoin transfer
result = await executor.transfer(
from_wallet="0x...",
to_address="0x...",
token="USDC",
amount=100_000000, # $100 in 6 decimals
)
print(f"Transaction hash: {result.tx_hash}")
print(f"Confirmations: {result.confirmations}")
Features
Chain Execution
from sardis_chain import ChainExecutor
executor = ChainExecutor(chain="ethereum")
# Transfer with automatic gas estimation
tx = await executor.transfer(
from_wallet=wallet_id,
to_address=recipient,
token="USDC",
amount=amount,
priority="high", # Adjusts gas price
)
# Wait for confirmation
confirmed = await executor.wait_for_confirmation(
tx_hash=tx.tx_hash,
confirmations=12,
)
Nonce Management
from sardis_chain import NonceManager
nonce_mgr = NonceManager(chain="base")
# Get next nonce with automatic tracking
async with nonce_mgr.acquire(wallet_address) as nonce:
# Use nonce for transaction
tx = build_transaction(nonce=nonce)
await submit_transaction(tx)
# Nonce automatically released/committed on success
Deposit Monitoring
from sardis_chain import DepositMonitor
monitor = DepositMonitor(
chain="base",
tokens=["USDC", "USDT"],
callback=handle_deposit,
)
# Start monitoring
await monitor.start()
async def handle_deposit(deposit):
print(f"Received {deposit.amount} {deposit.token}")
print(f"From: {deposit.from_address}")
print(f"Block: {deposit.block_number}")
MEV Protection
from sardis_chain import ChainExecutor
executor = ChainExecutor(
chain="ethereum",
mev_protection=True,
flashbots_relay="https://relay.flashbots.net",
)
# Transaction submitted via private mempool
tx = await executor.transfer(...)
Supported Chains
| Chain | Chain ID | Token Support |
|---|---|---|
| Ethereum | 1 | USDC, USDT, DAI |
| Base | 8453 | USDC, USDbC |
| Polygon | 137 | USDC, USDT |
| Arbitrum | 42161 | USDC, USDT |
| Optimism | 10 | USDC |
Configuration
from sardis_chain import ChainConfig
config = ChainConfig(
chain="base",
rpc_url="https://mainnet.base.org",
fallback_rpcs=[
"https://base.llamarpc.com",
"https://base.blockpi.network/v1/rpc/public",
],
confirmation_blocks=12,
gas_price_multiplier=1.1,
max_gas_price_gwei=100,
)
Or via environment variables:
SARDIS_CHAIN_RPC_URL=https://mainnet.base.org
SARDIS_CHAIN_CONFIRMATIONS=12
SARDIS_TURNKEY_API_KEY=your-api-key
SARDIS_TURNKEY_ORGANIZATION_ID=your-org-id
Architecture
sardis-chain/
├── executor.py # Transaction execution
├── wallet_manager.py # MPC wallet operations
├── nonce_manager.py # Nonce tracking and recovery
├── deposit_monitor.py # Deposit detection
├── confirmation.py # Confirmation tracking
├── mev_protection.py # MEV protection utilities
├── simulation.py # Transaction simulation
└── rpc_client.py # RPC connection management
Requirements
- Python 3.11+
- web3 >= 6.0
- pydantic >= 2.6
- sardis-core >= 0.1.0
- httpx >= 0.25.0
- rlp >= 3.0.0
- cryptography >= 41.0.0
Documentation
Full documentation is available at docs.sardis.sh/chain.
License
MIT License - see LICENSE for details.
Contributing
Contributions are welcome! Please see our Contributing Guide for details.
Metadata
Release files for sardis-chain 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| sardis_chain-1.1.0.tar.gz | 182.9 kB | Without provenance | Details for sardis_chain-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sardis_chain-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for sardis_chain-1.1.0-py3-none-any.whl |
Total release size: 388.2 kB
Release files / sardis_chain-1.1.0.tar.gz
| Download URL | sardis_chain-1.1.0.tar.gz |
|---|---|
| Size | 182.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
38379feb4f835edeb8f191aaafcb1c4127e45d1fe39b56d0b709cef49b98c92d
|
|
BLAKE2b-256 checksum How to use checksums |
d344f5f288c44e4e2c63ae47620ed7c0afb2f8ffcd421ea72a9c037715e65ab4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / sardis_chain-1.1.0-py3-none-any.whl
| Download URL | sardis_chain-1.1.0-py3-none-any.whl |
|---|---|
| Size | 205.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d6d647182ab135b78ecbc5bab3abea5bf012f5c55e0423711b60e73a9111fec1
|
|
BLAKE2b-256 checksum How to use checksums |
21e1fd07bcaca22ceec660e37bbf1561a4e199dc2fb5d74d6d826a1d72ebc5cd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for sardis-chain 1.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.