💧 Strands Agents Spraay
Spraay batch payment tool for Strands Agents — send ETH or ERC-20 tokens to up to 200 recipients in a single transaction on Base with ~80% gas savings.
Installation
pip install strands-agents-spraay
Quick Start
from strands import Agent
from strands_spraay import spraay_batch_payment
agent = Agent(tools=[spraay_batch_payment])
# The agent can now handle batch payment requests
agent("Send 0.01 ETH to 0xAAA..., 0xBBB..., and 0xCCC... using batch payment")
Environment Variables
| Variable | Description | Required |
|---|---|---|
SPRAAY_PRIVATE_KEY or PRIVATE_KEY |
Wallet private key for signing transactions | Yes |
BASE_RPC_URL |
Base RPC endpoint | No (defaults to https://mainnet.base.org) |
Actions
| Action | Description |
|---|---|
batch_eth |
Send equal ETH to all recipients |
batch_eth_variable |
Send different ETH amounts per recipient |
batch_token |
Send equal ERC-20 tokens to all recipients |
batch_token_variable |
Send different token amounts per recipient |
Direct Tool Usage
from strands import Agent
from strands_spraay import spraay_batch_payment
agent = Agent(tools=[spraay_batch_payment])
# Equal ETH batch
agent.tool.spraay_batch_payment(
action="batch_eth",
recipients=["0xAAA...", "0xBBB..."],
amount="0.01"
)
# Variable ETH batch
agent.tool.spraay_batch_payment(
action="batch_eth_variable",
recipients=["0xAAA...", "0xBBB..."],
amounts=["0.01", "0.05"]
)
# Equal token batch (USDC on Base)
agent.tool.spraay_batch_payment(
action="batch_token",
recipients=["0xAAA...", "0xBBB..."],
amount="100",
token_address="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
)
# Variable token batch
agent.tool.spraay_batch_payment(
action="batch_token_variable",
recipients=["0xAAA...", "0xBBB..."],
amounts=["100", "250"],
token_address="0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
)
Features
- Up to 200 recipients per transaction
- ~80% gas savings vs individual transfers
- Automatic token approval handling for ERC-20 transfers
- 0.3% protocol fee
- Full input validation — address format, recipient limits, amount checks
- Chain ID verification — prevents sending to wrong network
- 10% gas buffer on estimates to prevent out-of-gas errors
- Environment-based config — RPC URL, private key via env vars
Protocol Details
- Contract:
0x1646452F98E36A3c9Cfc3eDD8868221E207B5eEC(Base Mainnet) - Chain: Base (Chain ID 8453)
- Website: spraay.app
Development
# Clone and install
git clone https://github.com/plagtech/strands-agents-spraay.git
cd strands-agents-spraay
pip install -e ".[dev]"
# Run tests
pytest tests/ -v
# Format & lint
hatch run prepare
License
Apache-2.0 — see LICENSE for details.
Metadata
Release files for strands-agents-spraay 0.2.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 |
|---|---|---|---|---|
| strands_agents_spraay-0.2.0.tar.gz | 14.1 kB | With provenance | Details for strands_agents_spraay-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| strands_agents_spraay-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for strands_agents_spraay-0.2.0-py3-none-any.whl |
Total release size: 25.0 kB
Release files / strands_agents_spraay-0.2.0.tar.gz
| Download URL | strands_agents_spraay-0.2.0.tar.gz |
|---|---|
| Size | 14.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
cadaa96feef508c2147ece0351410aa8d8a28138b1f0c0a8ff2ec7e5953ae929
|
|
BLAKE2b-256 checksum How to use checksums |
0c744fb1e8dbadebe4ff5edddcc836a1bdd100353efda0bd7b5bf1ee6330514b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.
Transparency logRelease files / strands_agents_spraay-0.2.0-py3-none-any.whl
| Download URL | strands_agents_spraay-0.2.0-py3-none-any.whl |
|---|---|
| Size | 10.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cc558a11b0c50260b48bbcf42a24f84b50063dfd2e42aafc7cbc093bdc3f9887
|
|
BLAKE2b-256 checksum How to use checksums |
ef9042b427f9970c6999e72a15c356a156d2928257a55485ec89204926c01dfc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.
Transparency logSecurity for strands-agents-spraay 0.2.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.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for strands_agents_spraay-0.2.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 7, 2026.
Transparency logA 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.