scallop-client-setuplisted
Install: claude install-skill scallop-io/scallop-skills
# Client Setup & Configuration
Install, initialize, and configure the Scallop Python SDK (`sui-scallop-sdk`).
## Installation
```bash
pip install --pre sui-scallop-sdk
```
Requires Python 3.10+. The current release is `0.3.0a1`, an alpha pre-release, so `--pre`
(or an explicit `sui-scallop-sdk==0.3.0a1`) is required — a plain
`pip install sui-scallop-sdk` resolves no release.
## Quick Start
```python
from sui_scallop_sdk import ScallopClient
# Minimal setup (read-only queries)
client = ScallopClient(network="mainnet")
# With wallet (for transactions)
client = ScallopClient(
secret_key="suiprivkey1...", # or hex, or base64
network="mainnet",
)
```
## ScallopClient Constructor
```python
ScallopClient(
network: str = "mainnet", # "mainnet", "testnet", or "devnet"
rpc_url: str | None = None, # Custom RPC endpoint (overrides default)
wallet_address: str | None = None, # Default wallet for queries
secret_key: str | bytes | None = None, # Private key (auto-derives address)
)
```
When `secret_key` is provided, the client automatically:
1. Creates a `SuiKeypair` from the key
2. Derives the wallet address
3. Enables transaction signing
### Key Formats Accepted
The `secret_key` parameter accepts multiple formats:
| Format | Example |
|--------|---------|
| Bech32 | `suiprivkey1qp...` |
| Hex | `0x1a2b3c...` (64 hex chars) |
| Base64 | `Gis7...` (32 or 33 bytes encoded) |
| Raw bytes | `b'\x1a\x2b...'` (32 bytes) |
## Alternative Con