Sardis Python SDK
The official Python SDK for the Sardis stablecoin execution layer. Enables AI agents to execute programmable payments using stablecoins across multiple chains.
Installation
pip install sardis-sdk
Quick Start
import asyncio
from decimal import Decimal
from sardis_sdk import SardisClient
async def main():
async with SardisClient(
base_url="https://api.sardis.sh",
api_key="your-api-key",
) as client:
# Check API health
health = await client.health()
print(f"API Status: {health['status']}")
# Execute a payment mandate
result = await client.payments.execute_mandate({
"mandate_id": "mandate_123",
"subject": "wallet_abc",
"destination": "0x...",
"amount_minor": 10000000, # $10.00 USDC (6 decimals)
"token": "USDC",
"chain": "base",
})
print(f"Payment executed: {result.tx_hash}")
asyncio.run(main())
Features
Payments
Execute single mandates or full AP2 payment bundles:
# Execute AP2 bundle (Intent → Cart → Payment)
result = await client.payments.execute_ap2(
intent=intent_mandate,
cart=cart_mandate,
payment=payment_mandate,
)
Holds (Pre-Authorization)
Create, capture, and void pre-authorization holds:
# Create a hold
hold = await client.holds.create(
wallet_id="wallet_123",
amount=Decimal("100.00"),
token="USDC",
merchant_id="merchant_456",
duration_hours=24,
)
# Capture the hold (complete payment)
captured = await client.holds.capture(hold.hold_id, amount=Decimal("95.00"))
# Or void the hold (cancel)
voided = await client.holds.void(hold.hold_id)
Webhooks
Manage webhook subscriptions for real-time events:
# Create a webhook subscription
webhook = await client.webhooks.create(
url="https://your-server.com/webhooks",
events=["payment.completed", "hold.captured"],
)
# List deliveries
deliveries = await client.webhooks.list_deliveries(webhook.webhook_id)
Marketplace (A2A)
Discover and interact with agent-to-agent services:
# List available services
services = await client.marketplace.list_services(
category=ServiceCategory.AI,
)
# Create an offer
offer = await client.marketplace.create_offer(
service_id="service_123",
consumer_agent_id="agent_456",
total_amount=Decimal("50.00"),
)
# Accept an offer (as provider)
await client.marketplace.accept_offer(offer.offer_id)
Transactions
Get gas estimates and transaction status:
# Estimate gas
estimate = await client.transactions.estimate_gas(
chain="base",
to_address="0x...",
amount=Decimal("100.00"),
token="USDC",
)
print(f"Estimated cost: {estimate.estimated_cost_wei} wei")
# Check transaction status
status = await client.transactions.get_status(
tx_hash="0x...",
chain="base",
)
Ledger
Query the append-only ledger:
# List ledger entries
entries = await client.ledger.list_entries(wallet_id="wallet_123")
# Verify an entry
verification = await client.ledger.verify_entry(tx_id="tx_123")
Error Handling
The SDK provides typed exceptions for common error cases:
from sardis_sdk import (
SardisError,
APIError,
AuthenticationError,
RateLimitError,
InsufficientBalanceError,
)
try:
result = await client.payments.execute_mandate(mandate)
except AuthenticationError:
print("Invalid API key")
except RateLimitError as e:
print(f"Rate limited, retry after {e.retry_after} seconds")
except InsufficientBalanceError as e:
print(f"Need {e.required} {e.currency}, have {e.available}")
except APIError as e:
print(f"API error [{e.code}]: {e.message}")
Configuration
client = SardisClient(
base_url="https://api.sardis.sh", # API base URL
api_key="sk_live_...", # Your API key
timeout=30, # Request timeout (seconds)
max_retries=3, # Max retry attempts
)
Agents
Create and manage AI agents with spending policies:
# Create an agent
agent = await client.agents.create(
name="Invoice Processing Agent",
description="Processes invoices and pays vendors",
spending_limits={
"per_transaction": "500.00",
"daily": "5000.00",
"monthly": "50000.00",
},
policy={
"blocked_categories": ["gambling", "adult"],
"approval_threshold": "1000.00",
},
)
# Update spending limits
await client.agents.update(
agent.agent_id,
spending_limits={"daily": "10000.00"},
)
# List agents
agents = await client.agents.list(is_active=True, limit=50)
Wallets
Manage non-custodial MPC wallets:
# Create a wallet for an agent
wallet = await client.wallets.create(
agent_id=agent.agent_id,
mpc_provider="turnkey",
limit_per_tx="500.00",
limit_total="10000.00",
)
# Get wallet balance (read from chain)
balance = await client.wallets.get_balance(
wallet_id=wallet.wallet_id,
chain="base",
token="USDC",
)
print(f"Balance: {balance.balance} USDC")
# Set chain address
await client.wallets.set_address(
wallet_id=wallet.wallet_id,
chain="base",
address="0x...",
)
Supported Chains
| Chain | Mainnet | Testnet |
|---|---|---|
| Arc (Circle L1) | arc |
arc_testnet |
| Base | base |
base_sepolia |
| Polygon | polygon |
polygon_amoy |
| Ethereum | ethereum |
ethereum_sepolia |
| Arbitrum | arbitrum |
arbitrum_sepolia |
| Optimism | optimism |
optimism_sepolia |
Supported Tokens
- USDC - USD Coin (Circle)
- USDT - Tether USD
- PYUSD - PayPal USD
- EURC - Euro Coin (Circle)
Type Hints
The SDK is fully typed with Python type hints:
from sardis_sdk.models import (
Chain, # Literal type for supported chains
Token, # Literal type for supported tokens
MPCProvider, # Literal type for MPC providers
ChainEnum, # Enum for chain selection
Payment,
Wallet,
Agent,
)
# Use type hints for better IDE support
chain: Chain = "base"
token: Token = "USDC"
Framework Integrations
Deprecated: The built-in integration shims (
sardis_sdk.integrations.*) are deprecated. Use the standalone packages instead for better maintenance and framework-specific features.
| Framework | Standalone Package | Install |
|---|---|---|
| LangChain | sardis-langchain |
pip install sardis-langchain |
| OpenAI Agents | sardis-openai-agents |
pip install sardis-openai-agents |
| CrewAI | sardis-crewai |
pip install sardis-crewai |
| Google ADK | sardis-adk |
pip install sardis-adk |
| Anthropic Agent SDK | sardis-agent-sdk |
pip install sardis-agent-sdk |
License
MIT
Metadata
Release files for sardis-sdk 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_sdk-1.1.0.tar.gz | 64.1 kB | Without provenance | Details for sardis_sdk-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| sardis_sdk-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for sardis_sdk-1.1.0-py3-none-any.whl |
Total release size: 153.6 kB
Release files / sardis_sdk-1.1.0.tar.gz
| Download URL | sardis_sdk-1.1.0.tar.gz |
|---|---|
| Size | 64.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3799ef33df329d4933c95788f0ea10ac54c51425eb66ba98ec38cf3ab7bcf75a
|
|
BLAKE2b-256 checksum How to use checksums |
efddf3b8c9407b0b3db2dfaa45e5f2c3af75b8e443b84c75724c1ec27aab6122
|
| 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_sdk-1.1.0-py3-none-any.whl
| Download URL | sardis_sdk-1.1.0-py3-none-any.whl |
|---|---|
| Size | 89.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
697e5c193776c5c683940e4840586b22230521f0a7708c82fe21d4066b1abc63
|
|
BLAKE2b-256 checksum How to use checksums |
3494e8250a6b12dc22687ee9347b0c9eaad049e6827bace32683c80c193d5af3
|
| 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-sdk 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.